glob-parent 6.0.2

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 pkg:npm/glob-parent@6.0.2
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/glob-parent@6.0.2
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - 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:283321c06b88cafb6c1ba167a167bdab1c0810af9cc3ec3eecb4d78ea0cc40c1","constraints":{"executionContext":"node"},"contract":["globParent extracts non-magic parent directory path from standard glob patterns","globParent extracts non-magic parent directory path from brace expansions, bracket sets, and extglob patterns","globParent returns parent directory path for plain file paths without glob patterns","globParent handles escaped glob characters when flipBackslashes is disabled"],"goal":"verify pkg:npm/glob-parent@6.0.2","kind":"HOW","packages":["pkg:npm/glob-parent@6.0.2"],"schemaVersion":1},"contractCommand":["node","test/contract.js"],"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/glob-parent@6.0.2"],"schemaVersion":1,"subject":"pkg:npm/glob-parent@6.0.2","verifierAdapter":"node-typescript@1"}

{
  "name": "sample-glob-parent",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-glob-parent",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "glob-parent": "6.0.2"
      }
    },
    "node_modules/glob-parent": {
      "version": "6.0.2",
      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",
      "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==",
      "license": "ISC",
      "dependencies": {
        "is-glob": "^4.0.3"
      },
      "engines": {
        "node": ">=10.13.0"
      }
    },
    "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-glob-parent",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification sample for glob-parent",
  "main": "src/index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "dependencies": {
    "glob-parent": "6.0.2"
  },
  "license": "MIT-0"
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/glob-parent@6.0.2",
  "kind": "HOW",
  "packages": [
    "pkg:npm/glob-parent@6.0.2"
  ],
  "constraints": {
    "executionContext": "node"
  },
  "runtimeConditions": {
    "ecosystem": "npm",
    "language": "javascript",
    "moduleSystem": "cjs",
    "runtime": "node@22.23.2"
  }
}

const globParent = require('glob-parent');

function getGlobParent(pattern, options) {
  return globParent(pattern, options);
}

module.exports = {
  getGlobParent
};

const assert = require('node:assert');
const globParent = require('glob-parent');
const { getGlobParent } = require('../src/index.js');

// 1. Standard glob patterns
assert.strictEqual(globParent('path/to/*.js'), 'path/to', 'asterisk pattern should extract parent path');
assert.strictEqual(globParent('path/to/**/test'), 'path/to', 'globstar pattern should extract parent path');
assert.strictEqual(globParent('*.js'), '.', 'top-level glob pattern should return dot');
assert.strictEqual(globParent('path/to/file?.js'), 'path/to', 'question mark pattern should extract parent path');
assert.strictEqual(getGlobParent('path/to/*.js'), 'path/to', 'wrapper should extract parent path for glob pattern');

// 2. Brace expansion, bracket sets, extglobs
assert.strictEqual(globParent('path/to/{foo,bar}'), 'path/to', 'brace expansion should extract parent path');
assert.strictEqual(globParent('path/to/[a-z]'), 'path/to', 'bracket character set should extract parent path');
assert.strictEqual(globParent('path/to/!(foo)/bar'), 'path/to', 'negation extglob should extract parent path');
assert.strictEqual(globParent('path/to/+(foo)/bar'), 'path/to', 'one or more extglob should extract parent path');
assert.strictEqual(globParent('path/to/*(foo)/bar'), 'path/to', 'zero or more extglob should extract parent path');
assert.strictEqual(globParent('path/to/?(foo)/bar'), 'path/to', 'zero or one extglob should extract parent path');
assert.strictEqual(globParent('path/to/@(foo)/bar'), 'path/to', 'exact match extglob should extract parent path');
assert.strictEqual(getGlobParent('path/to/{a,b}'), 'path/to', 'wrapper should extract parent path for brace expansion');

// 3. Plain paths without glob patterns
assert.strictEqual(globParent('path/to/foo/bar.js'), 'path/to/foo', 'plain file path should return directory parent');
assert.strictEqual(globParent('path/to/dir/'), 'path/to/dir', 'trailing slash directory path should preserve path');
assert.strictEqual(globParent('file.js'), '.', 'single filename should return dot');
assert.strictEqual(globParent('deeply/nested/path/file.txt'), 'deeply/nested/path', 'nested path should return parent path');
assert.strictEqual(getGlobParent('path/to/file.js'), 'path/to', 'wrapper should return directory parent for plain path');

// 4. Escaped glob characters with flipBackslashes disabled
assert.strictEqual(globParent('path/to/escaped\\*file/foo.js', { flipBackslashes: false }), 'path/to/escaped*file', 'escaped asterisk should not be treated as glob when flipBackslashes is false');
assert.strictEqual(getGlobParent('path/to/escaped\\*file/foo.js', { flipBackslashes: false }), 'path/to/escaped*file', 'wrapper should support options parameter');

console.log('Contract tests passed successfully.');