minimatch 10.1.1: match

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 minimatch.match in pkg:npm/minimatch@10.1.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/minimatch@10.1.1
Demonstrate these symbols/APIs:
  - minimatch.match

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:0f6d97e9cd2761b56f33bf5f96927c71df513de6b1aff76cfcffc8e8ca0dc48c","contract":["minimatch.match filters an array of path strings returning only elements that match a glob pattern","minimatch.match matches filenames across directory levels when pattern has no slashes and matchBase is enabled, while restricting to root level when matchBase is disabled","minimatch.match excludes dotfiles from wildcard pattern matches by default and includes them when dot is true","minimatch.match supports case-insensitive path filtering when nocase is enabled","minimatch.match filters out matching elements when given negation patterns with leading exclamation marks, while treating exclamation marks literally when nonegate is true","minimatch.match matches nested file paths across arbitrary directory depths using globstar patterns"],"goal":"verify minimatch.match in pkg:npm/minimatch@10.1.1","kind":"HOW","packages":["pkg:npm/minimatch@10.1.1"],"schemaVersion":1,"symbols":["minimatch.match"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/minimatch@10.1.1"],"schemaVersion":1,"symbols":["minimatch.match"],"verifierAdapter":"node-typescript@1"}

import { minimatch } from 'minimatch';

/**
 * Filter an array of file path strings against a glob pattern.
 *
 * @param {string[]} paths - Array of file paths to filter
 * @param {string} pattern - Glob pattern to test against
 * @param {import('minimatch').MinimatchOptions} [options] - Match options
 * @returns {string[]} Filtered array of matching paths
 */
export function filterPaths(paths, pattern, options = {}) {
  return minimatch.match(paths, pattern, options);
}

{
  "name": "sample-minimatch-match",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-minimatch-match",
      "version": "1.0.0",
      "dependencies": {
        "minimatch": "10.1.1"
      }
    },
    "node_modules/@isaacs/balanced-match": {
      "version": "4.0.1",
      "resolved": "https://registry.npmjs.org/@isaacs/balanced-match/-/balanced-match-4.0.1.tgz",
      "integrity": "sha512-yzMTt9lEb8Gv7zRioUilSglI0c0smZ9k5D65677DLWLtWJaXIS3CqcGyUFByYKlnUj6TkjLVs54fBl6+TiGQDQ==",
      "license": "MIT",
      "engines": {
        "node": "20 || >=22"
      }
    },
    "node_modules/@isaacs/brace-expansion": {
      "version": "5.0.1",
      "resolved": "https://registry.npmjs.org/@isaacs/brace-expansion/-/brace-expansion-5.0.1.tgz",
      "integrity": "sha512-WMz71T1JS624nWj2n2fnYAuPovhv7EUhk69R6i9dsVyzxt5eM3bjwvgk9L+APE1TRscGysAVMANkB0jh0LQZrQ==",
      "license": "MIT",
      "dependencies": {
        "@isaacs/balanced-match": "^4.0.1"
      },
      "engines": {
        "node": "20 || >=22"
      }
    },
    "node_modules/minimatch": {
      "version": "10.1.1",
      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.1.1.tgz",
      "integrity": "sha512-enIvLvRAFZYXJzkCYG5RKmPfrFArdLv+R+lbQ53BmIMLIry74bjKzX6iHAm8WYamJkhSSEabrWN5D97XnKObjQ==",
      "license": "BlueOak-1.0.0",
      "dependencies": {
        "@isaacs/brace-expansion": "^5.0.0"
      },
      "engines": {
        "node": "20 || >=22"
      },
      "funding": {
        "url": "https://github.com/sponsors/isaacs"
      }
    }
  }
}

{
  "name": "sample-minimatch-match",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "dependencies": {
    "minimatch": "10.1.1"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify minimatch.match in pkg:npm/minimatch@10.1.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/minimatch@10.1.1"
  ],
  "symbols": [
    "minimatch.match"
  ]
}

import assert from 'node:assert/strict';
import { minimatch } from 'minimatch';
import { filterPaths } from '../index.mjs';

// 1. Basic filtering
{
  const files = ['src/index.js', 'src/app.ts', 'src/style.css', 'README.md'];
  const matched = minimatch.match(files, '**/*.js');
  assert.deepEqual(matched, ['src/index.js']);
  assert.deepEqual(filterPaths(files, '**/*.js'), ['src/index.js']);
}

// 2. matchBase option
{
  const files = ['a/b/file.txt', 'c/file.txt', 'other.log', 'file.txt'];
  const withBase = minimatch.match(files, '*.txt', { matchBase: true });
  assert.deepEqual(withBase, ['a/b/file.txt', 'c/file.txt', 'file.txt']);

  const withoutBase = minimatch.match(files, '*.txt', { matchBase: false });
  assert.deepEqual(withoutBase, ['file.txt']);
}

// 3. Dotfiles handling
{
  const files = ['.env', '.gitignore', 'config.json', 'app.js'];
  const defaultDot = minimatch.match(files, '*');
  assert.deepEqual(defaultDot, ['config.json', 'app.js']);

  const withDot = minimatch.match(files, '*', { dot: true });
  assert.deepEqual(withDot, ['.env', '.gitignore', 'config.json', 'app.js']);
}

// 4. nocase option
{
  const files = ['file.TXT', 'FILE.txt', 'file.doc'];
  const caseInsensitive = minimatch.match(files, '*.txt', { nocase: true });
  assert.deepEqual(caseInsensitive, ['file.TXT', 'FILE.txt']);

  const caseSensitive = minimatch.match(files, '*.txt', { nocase: false });
  assert.deepEqual(caseSensitive, ['FILE.txt']);
}

// 5. Negation and nonegate
{
  const files = ['a.js', 'b.ts', 'c.js', '!special.js'];
  const negated = minimatch.match(files, '!*.js');
  assert.deepEqual(negated, ['b.ts']);

  const literalNegate = minimatch.match(files, '!*.js', { nonegate: true });
  assert.deepEqual(literalNegate, ['!special.js']);
}

// 6. Globstar recursive matching
{
  const files = ['app/models/user.js', 'app/controllers/user.js', 'app/views/user/index.html', 'config.js'];
  const nested = minimatch.match(files, 'app/**/*.js');
  assert.deepEqual(nested, ['app/models/user.js', 'app/controllers/user.js']);
}

console.log('Contract passed');