globals 15.15.0: es2025

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify globals.es2025 in pkg:npm/globals@15.15.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/globals@15.15.0
Demonstrate these symbols/APIs:
  - globals.es2025

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:e07bb5ccf8829aae493bb1a5983ce3b40482896aed0a6dc1470e39a372b27ded","contract":["globals.es2025 is an object mapping ECMAScript 2025 global identifier names to boolean writeability values","globals.es2025 defines standard ECMAScript globals Object, Array, Function, and globalThis as false","globals.es2025 includes the ECMAScript 2025 Iterator global identifier as false","globals.es2025 includes Promise, Symbol, and modern memory management globals FinalizationRegistry and WeakRef as false","all properties in globals.es2025 have boolean values"],"goal":"verify globals.es2025 in pkg:npm/globals@15.15.0","kind":"HOW","packages":["pkg:npm/globals@15.15.0"],"schemaVersion":1,"symbols":["globals.es2025"]},"contractCommand":["node","test/contract.cjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/globals@15.15.0"],"schemaVersion":1,"subject":"pkg:npm/globals@15.15.0","symbols":["globals.es2025"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-globals-es2025",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-globals-es2025",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "globals": "15.15.0"
      }
    },
    "node_modules/globals": {
      "version": "15.15.0",
      "resolved": "https://registry.npmjs.org/globals/-/globals-15.15.0.tgz",
      "integrity": "sha512-7ACyT3wmyp3I61S4fG682L0VA2RGD9otkqGJIwNUMF1SWUombIIk+af1unuDYgMm082aHYwD+mzJvv9Iu8dsgg==",
      "license": "MIT",
      "engines": {
        "node": ">=18"
      },
      "funding": {
        "url": "https://github.com/sponsors/sindresorhus"
      }
    }
  }
}

{
  "name": "sample-globals-es2025",
  "version": "1.0.0",
  "private": true,
  "description": "verify globals.es2025 in pkg:npm/globals@15.15.0",
  "main": "src/index.js",
  "scripts": {
    "test": "node test/contract.cjs"
  },
  "dependencies": {
    "globals": "15.15.0"
  },
  "license": "MIT-0"
}

{
  "schemaVersion": 1,
  "goal": "verify globals.es2025 in pkg:npm/globals@15.15.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/globals@15.15.0"
  ],
  "symbols": [
    "globals.es2025"
  ]
}

'use strict';

const globals = require('globals');

/**
 * Returns the es2025 globals dictionary.
 * @returns {Record<string, boolean>}
 */
function getEs2025Globals() {
  return globals.es2025;
}

/**
 * Checks whether a given identifier name is defined in globals.es2025.
 * @param {string} identifier
 * @returns {boolean}
 */
function isEs2025Global(identifier) {
  return Boolean(globals.es2025 && Object.prototype.hasOwnProperty.call(globals.es2025, identifier));
}

/**
 * Returns whether the given ES2025 global is marked as writable.
 * @param {string} identifier
 * @returns {boolean|undefined}
 */
function isEs2025GlobalWritable(identifier) {
  if (globals.es2025 && Object.prototype.hasOwnProperty.call(globals.es2025, identifier)) {
    return globals.es2025[identifier];
  }
  return undefined;
}

module.exports = {
  getEs2025Globals,
  isEs2025Global,
  isEs2025GlobalWritable,
  globals
};

'use strict';

const assert = require('node:assert/strict');
const globals = require('globals');
const {
  getEs2025Globals,
  isEs2025Global,
  isEs2025GlobalWritable
} = require('../src/index.js');

async function testContract() {
  // 1. globals.es2025 is an object mapping ECMAScript 2025 global identifier names to boolean writeability values
  assert.equal(typeof globals.es2025, 'object', 'globals.es2025 must be an object');
  assert.notEqual(globals.es2025, null, 'globals.es2025 must not be null');
  assert.strictEqual(getEs2025Globals(), globals.es2025, 'getEs2025Globals helper must return globals.es2025');

  // 2. globals.es2025 defines standard ECMAScript globals Object, Array, Function, and globalThis as false
  assert.strictEqual(globals.es2025.Object, false, 'Object must be defined as false in es2025');
  assert.strictEqual(globals.es2025.Array, false, 'Array must be defined as false in es2025');
  assert.strictEqual(globals.es2025.Function, false, 'Function must be defined as false in es2025');
  assert.strictEqual(globals.es2025.globalThis, false, 'globalThis must be defined as false in es2025');
  assert.strictEqual(isEs2025Global('Object'), true, 'isEs2025Global("Object") must return true');
  assert.strictEqual(isEs2025GlobalWritable('Object'), false, 'isEs2025GlobalWritable("Object") must return false');

  // 3. globals.es2025 includes the ECMAScript 2025 Iterator global identifier as false
  assert.strictEqual(globals.es2025.Iterator, false, 'Iterator must be defined as false in es2025');
  assert.strictEqual(isEs2025Global('Iterator'), true, 'isEs2025Global("Iterator") must return true');
  assert.strictEqual(isEs2025GlobalWritable('Iterator'), false, 'isEs2025GlobalWritable("Iterator") must return false');

  // 4. globals.es2025 includes Promise, Symbol, and modern memory management globals FinalizationRegistry and WeakRef as false
  assert.strictEqual(globals.es2025.Promise, false, 'Promise must be defined as false in es2025');
  assert.strictEqual(globals.es2025.Symbol, false, 'Symbol must be defined as false in es2025');
  assert.strictEqual(globals.es2025.FinalizationRegistry, false, 'FinalizationRegistry must be defined as false in es2025');
  assert.strictEqual(globals.es2025.WeakRef, false, 'WeakRef must be defined as false in es2025');
  assert.strictEqual(globals.es2025.AggregateError, false, 'AggregateError must be defined as false in es2025');

  // 5. all properties in globals.es2025 have boolean values
  const keys = Object.keys(globals.es2025);
  assert.ok(keys.length > 50, 'globals.es2025 should have more than 50 identifier definitions');
  for (const key of keys) {
    assert.strictEqual(typeof globals.es2025[key], 'boolean', `globals.es2025[${key}] must be a boolean`);
  }

  // Non-existent global check
  assert.strictEqual(isEs2025Global('nonExistentGlobalXYZ'), false, 'unknown identifier must return false');
  assert.strictEqual(isEs2025GlobalWritable('nonExistentGlobalXYZ'), undefined, 'unknown identifier writable check must return undefined');

  console.log('Contract test passed: globals.es2025 verified.');
}

testContract().catch((err) => {
  console.error('Contract test failed:', err);
  process.exit(1);
});