globals 15.15.0: vitest

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.vitest 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.vitest

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:28875fafccb5f4f71617f82ee1d289607f33325d2226e67738f7f696d3f0e032","contract":["globals.vitest is an object mapping Vitest global identifier names to boolean writeability values","globals.vitest defines test lifecycle globals describe, test, it, suite, beforeAll, beforeEach, afterAll, and afterEach as false","globals.vitest defines assertion globals expect, assert, expectTypeOf, and assertType as false","globals.vitest defines mock and test hooks vi, vitest, chai, onTestFinished, and onTestFailed as false","all properties in globals.vitest have boolean values"],"goal":"verify globals.vitest in pkg:npm/globals@15.15.0","kind":"HOW","packages":["pkg:npm/globals@15.15.0"],"schemaVersion":1,"symbols":["globals.vitest"]},"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.vitest"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-globals-vitest",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-globals-vitest",
      "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-vitest",
  "version": "1.0.0",
  "private": true,
  "description": "verify globals.vitest 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.vitest in pkg:npm/globals@15.15.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/globals@15.15.0"
  ],
  "symbols": [
    "globals.vitest"
  ]
}

'use strict';

const globals = require('globals');

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

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

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

module.exports = {
  getVitestGlobals,
  isVitestGlobal,
  isVitestGlobalWritable,
  globals
};

'use strict';

const assert = require('node:assert/strict');
const globals = require('globals');
const {
  getVitestGlobals,
  isVitestGlobal,
  isVitestGlobalWritable
} = require('../src/index.js');

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

  // 2. globals.vitest defines test lifecycle globals describe, test, it, suite, beforeAll, beforeEach, afterAll, and afterEach as false
  const lifecycleGlobals = ['describe', 'test', 'it', 'suite', 'beforeAll', 'beforeEach', 'afterAll', 'afterEach'];
  for (const name of lifecycleGlobals) {
    assert.strictEqual(globals.vitest[name], false, `${name} must be defined as false in globals.vitest`);
    assert.strictEqual(isVitestGlobal(name), true, `isVitestGlobal("${name}") must return true`);
    assert.strictEqual(isVitestGlobalWritable(name), false, `isVitestGlobalWritable("${name}") must return false`);
  }

  // 3. globals.vitest defines assertion globals expect, assert, expectTypeOf, and assertType as false
  const assertionGlobals = ['expect', 'assert', 'expectTypeOf', 'assertType'];
  for (const name of assertionGlobals) {
    assert.strictEqual(globals.vitest[name], false, `${name} must be defined as false in globals.vitest`);
    assert.strictEqual(isVitestGlobal(name), true, `isVitestGlobal("${name}") must return true`);
    assert.strictEqual(isVitestGlobalWritable(name), false, `isVitestGlobalWritable("${name}") must return false`);
  }

  // 4. globals.vitest defines mock and test hooks vi, vitest, chai, onTestFinished, and onTestFailed as false
  const hookGlobals = ['vi', 'vitest', 'chai', 'onTestFinished', 'onTestFailed'];
  for (const name of hookGlobals) {
    assert.strictEqual(globals.vitest[name], false, `${name} must be defined as false in globals.vitest`);
    assert.strictEqual(isVitestGlobal(name), true, `isVitestGlobal("${name}") must return true`);
    assert.strictEqual(isVitestGlobalWritable(name), false, `isVitestGlobalWritable("${name}") must return false`);
  }

  // 5. all properties in globals.vitest have boolean values
  const keys = Object.keys(globals.vitest);
  assert.strictEqual(keys.length, 17, 'globals.vitest should define exactly 17 global identifiers');
  for (const key of keys) {
    assert.strictEqual(typeof globals.vitest[key], 'boolean', `globals.vitest[${key}] must be a boolean`);
    assert.strictEqual(globals.vitest[key], false, `globals.vitest[${key}] must be false (read-only)`);
  }

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

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

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