anymatch 3.1.3: verify anymatch pattern matching with string, glob, regex, function and array matchers

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 anymatch pattern matching with string, glob, regex, function and array matchers
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/anymatch@3.1.3
Demonstrate these symbols/APIs:
  - anymatch
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:48f05a7799df090a3187d5aa1f0a450f849eef868c566a53a5f2929175ad2ef4","constraints":{"executionContext":"node"},"contract":["anymatch matches exact string paths","anymatch matches glob patterns with wildcards and double wildcards","anymatch matches regular expressions against test paths","anymatch evaluates custom predicate functions against test paths","anymatch matches an array of mixed string, glob, regex, and function matchers","anymatch returns the matching pattern index when returnIndex is true","anymatch returns false or -1 when negated exclamation mark globs match","anymatch normalizes Windows backslash path separators to forward slashes before matching","anymatch passes additional argument elements to predicate functions when testString is an array","anymatch returns a curried matcher function when invoked without a test string","anymatch throws TypeError when matchers argument is null or undefined","anymatch throws TypeError when testString is not a string or array"],"goal":"verify anymatch pattern matching with string, glob, regex, function and array matchers","kind":"HOW","packages":["pkg:npm/anymatch@3.1.3"],"schemaVersion":1,"symbols":["anymatch"]},"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/anymatch@3.1.3"],"schemaVersion":1,"subject":"pkg:npm/anymatch@3.1.3","symbols":["anymatch"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-anymatch",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-anymatch",
      "version": "1.0.0",
      "dependencies": {
        "anymatch": "3.1.3"
      }
    },
    "node_modules/anymatch": {
      "version": "3.1.3",
      "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz",
      "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==",
      "license": "ISC",
      "dependencies": {
        "normalize-path": "^3.0.0",
        "picomatch": "^2.0.4"
      },
      "engines": {
        "node": ">= 8"
      }
    },
    "node_modules/normalize-path": {
      "version": "3.0.0",
      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
      "license": "MIT",
      "engines": {
        "node": ">=0.10.0"
      }
    },
    "node_modules/picomatch": {
      "version": "2.3.2",
      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",
      "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",
      "license": "MIT",
      "engines": {
        "node": ">=8.6"
      },
      "funding": {
        "url": "https://github.com/sponsors/jonschlinkert"
      }
    }
  }
}

{
  "name": "sample-anymatch",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "dependencies": {
    "anymatch": "3.1.3"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify anymatch pattern matching with string, glob, regex, function and array matchers",
  "kind": "HOW",
  "packages": [
    "pkg:npm/anymatch@3.1.3"
  ],
  "symbols": [
    "anymatch"
  ],
  "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/strict';
import anymatch from 'anymatch';

// 1. anymatch matches exact string paths
{
  assert.equal(anymatch('src/index.js', 'src/index.js'), true);
  assert.equal(anymatch('src/index.js', 'src/other.js'), false);
}

// 2. anymatch matches glob patterns with wildcards and double wildcards
{
  assert.equal(anymatch('**/*.js', 'src/components/button.js'), true);
  assert.equal(anymatch('*.js', 'src/components/button.js'), false);
  assert.equal(anymatch('foo/**', 'foo/bar/baz.txt'), true);
}

// 3. anymatch matches regular expressions against test paths
{
  const re = /\.test\.(js|ts)$/;
  assert.equal(anymatch(re, 'src/index.test.js'), true);
  assert.equal(anymatch(re, 'src/index.js'), false);
}

// 4. anymatch evaluates custom predicate functions against test paths
{
  const fn = (path) => path.startsWith('lib/') && path.endsWith('.json');
  assert.equal(anymatch(fn, 'lib/config.json'), true);
  assert.equal(anymatch(fn, 'src/config.json'), false);
}

// 5. anymatch matches an array of mixed string, glob, regex, and function matchers
{
  const matchers = [
    'index.html',
    '**/*.css',
    /\.svg$/,
    (str) => str.includes('vendor')
  ];
  assert.equal(anymatch(matchers, 'index.html'), true);
  assert.equal(anymatch(matchers, 'styles/main.css'), true);
  assert.equal(anymatch(matchers, 'assets/logo.svg'), true);
  assert.equal(anymatch(matchers, 'third_party/vendor/bundle.js'), true);
  assert.equal(anymatch(matchers, 'unmatched.png'), false);
}

// 6. anymatch returns the matching pattern index when returnIndex is true
{
  const matchers = ['index.html', '**/*.css', /\.svg$/];
  assert.equal(anymatch(matchers, 'index.html', true), 0);
  assert.equal(anymatch(matchers, 'styles/main.css', true), 1);
  assert.equal(anymatch(matchers, 'assets/icon.svg', { returnIndex: true }), 2);
  assert.equal(anymatch(matchers, 'unmatched.png', true), -1);
}

// 7. anymatch returns false or -1 when negated exclamation mark globs match
{
  const matchers = ['**/*.js', '!**/ignored.js'];
  assert.equal(anymatch(matchers, 'src/app.js'), true);
  assert.equal(anymatch(matchers, 'src/ignored.js'), false);
  assert.equal(anymatch(matchers, 'src/ignored.js', true), -1);
}

// 8. anymatch normalizes Windows backslash path separators to forward slashes before matching
{
  assert.equal(anymatch('src/**/*.js', 'src\\components\\button.js'), true);
  assert.equal(anymatch('foo/bar', 'foo\\bar'), true);
}

// 9. anymatch passes additional argument elements to predicate functions when testString is an array
{
  const matchFn = (path, extra) => path === 'file.txt' && extra === 'custom-flag';
  assert.equal(anymatch(matchFn, ['file.txt', 'custom-flag']), true);
  assert.equal(anymatch(matchFn, ['file.txt', 'other-flag']), false);
}

// 10. anymatch returns a curried matcher function when invoked without a test string
{
  const isDoc = anymatch(['**/*.md', '**/*.txt']);
  assert.equal(typeof isDoc, 'function');
  assert.equal(isDoc('README.md'), true);
  assert.equal(isDoc('notes.txt'), true);
  assert.equal(isDoc('image.png'), false);
  assert.equal(isDoc('notes.txt', true), 1);
}

// 11. anymatch throws TypeError when matchers argument is null or undefined
{
  assert.throws(() => anymatch(null, 'test.js'), {
    name: 'TypeError',
    message: 'anymatch: specify first argument'
  });
  assert.throws(() => anymatch(undefined, 'test.js'), {
    name: 'TypeError',
    message: 'anymatch: specify first argument'
  });
}

// 12. anymatch throws TypeError when testString is not a string or array
{
  assert.throws(() => anymatch('*.js', 12345), {
    name: 'TypeError',
    message: /anymatch: second argument must be a string/
  });
}