is-glob 4.0.3: isGlob

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 isGlob in pkg:npm/is-glob@4.0.3
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/is-glob@4.0.3
Demonstrate these symbols/APIs:
  - isGlob
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - packageManager: npm@10.9.8
  - runtime: node@22.23.2

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:46b950dcb84a071ebb79253f9bb752536b0a2d6b3d2ddc22fa394ce702488330","constraints":{"executionContext":"node"},"contract":["assert isGlob returns true for wildcard asterisk patterns and extglobs","assert isGlob returns true for valid bracket ranges and brace expansion patterns","assert isGlob returns false for plain file paths and empty or non-string inputs","assert isGlob returns false for escaped glob characters in strict mode","assert isGlob detects unclosed glob characters when strict option is false"],"goal":"verify isGlob in pkg:npm/is-glob@4.0.3","kind":"HOW","packages":["pkg:npm/is-glob@4.0.3"],"schemaVersion":1,"symbols":["isGlob"]},"contractCommand":["node","test/contract.mjs"],"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/is-glob@4.0.3"],"schemaVersion":1,"subject":"pkg:npm/is-glob@4.0.3","symbols":["isGlob"],"verifierAdapter":"node-typescript@1"}

const isGlob = require('is-glob');

/**
 * Checks whether a given string is a glob pattern.
 *
 * @param {string} str - String to test for glob patterns.
 * @param {Object} [options] - Options object.
 * @param {boolean} [options.strict=true] - When false, relaxed checks allow unclosed delimiters.
 * @returns {boolean} True if the string is a glob pattern, false otherwise.
 */
function checkIsGlob(str, options) {
  return isGlob(str, options);
}

module.exports = {
  checkIsGlob,
  isGlob,
};

{
  "name": "sample-is-glob",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-is-glob",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "is-glob": "4.0.3"
      }
    },
    "node_modules/is-extglob": {
      "version": "2.1.1",
      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
      "license": "MIT",
      "engines": {
        "node": ">=0.10.0"
      }
    },
    "node_modules/is-glob": {
      "version": "4.0.3",
      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
      "license": "MIT",
      "dependencies": {
        "is-extglob": "^2.1.1"
      },
      "engines": {
        "node": ">=0.10.0"
      }
    }
  }
}

{
  "name": "sample-is-glob",
  "version": "1.0.0",
  "description": "Clean-room sample verifying pkg:npm/is-glob@4.0.3 functionality",
  "main": "index.js",
  "license": "MIT-0",
  "dependencies": {
    "is-glob": "4.0.3"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify isGlob in pkg:npm/is-glob@4.0.3",
  "kind": "HOW",
  "packages": [
    "pkg:npm/is-glob@4.0.3"
  ],
  "symbols": [
    "isGlob"
  ],
  "constraints": {
    "executionContext": "node"
  },
  "runtimeConditions": {
    "ecosystem": "npm",
    "language": "javascript",
    "moduleSystem": "cjs",
    "packageManager": "npm@10.9.8",
    "runtime": "node@22.23.2"
  }
}

import assert from 'node:assert';
import isGlob from 'is-glob';
import { checkIsGlob } from '../index.js';

// 1. Wildcard asterisk patterns and extglobs
assert.strictEqual(
  isGlob('*.js'),
  true,
  'isGlob must return true for standard asterisk pattern'
);
assert.strictEqual(
  checkIsGlob('foo/**/bar.txt'),
  true,
  'checkIsGlob must return true for globstar pattern'
);
assert.strictEqual(
  isGlob('!foo.js'),
  true,
  'isGlob must return true for negation pattern'
);
assert.strictEqual(
  isGlob('@(a|b)'),
  true,
  'isGlob must return true for extglob patterns'
);

// 2. Bracket ranges and brace expansion patterns
assert.strictEqual(
  isGlob('foo/[a-z].js'),
  true,
  'isGlob must return true for character class bracket patterns'
);
assert.strictEqual(
  checkIsGlob('foo/{a,b}.js'),
  true,
  'checkIsGlob must return true for comma-separated brace sets'
);
assert.strictEqual(
  isGlob('foo/(a|b).js'),
  true,
  'isGlob must return true for paren alternation patterns'
);

// 3. Plain paths and empty/non-string inputs
assert.strictEqual(
  isGlob('foo.js'),
  false,
  'isGlob must return false for literal filenames'
);
assert.strictEqual(
  checkIsGlob('path/to/file.txt'),
  false,
  'checkIsGlob must return false for plain directory paths'
);
assert.strictEqual(
  isGlob(''),
  false,
  'isGlob must return false for empty string'
);
assert.strictEqual(
  isGlob(null),
  false,
  'isGlob must return false for null input'
);
assert.strictEqual(
  isGlob(undefined),
  false,
  'isGlob must return false for undefined input'
);
assert.strictEqual(
  isGlob(123),
  false,
  'isGlob must return false for numeric input'
);

// 4. Escaped glob characters in strict mode
assert.strictEqual(
  isGlob('foo/\\*.js'),
  false,
  'isGlob must return false for escaped asterisk'
);
assert.strictEqual(
  isGlob('foo/\\[a-z\\].js'),
  false,
  'isGlob must return false for escaped brackets'
);
assert.strictEqual(
  checkIsGlob('foo/\\{a,b\\}.js'),
  false,
  'checkIsGlob must return false for escaped braces'
);

// 5. Relaxed checking when strict option is false
assert.strictEqual(
  isGlob('foo/{bar', { strict: false }),
  true,
  'isGlob must return true for unclosed brace when strict is false'
);
assert.strictEqual(
  checkIsGlob('foo/[bar', { strict: false }),
  true,
  'checkIsGlob must return true for unclosed bracket when strict is false'
);
assert.strictEqual(
  isGlob('foo/(bar', { strict: false }),
  true,
  'isGlob must return true for unclosed paren when strict is false'
);
assert.strictEqual(
  isGlob('abc?', { strict: false }),
  true,
  'isGlob must return true for single character question mark when strict is false'
);
assert.strictEqual(
  isGlob('foo/{bar'),
  false,
  'isGlob must return false for unclosed brace in strict mode'
);

console.log('All contract assertions passed.');