picomatch 4.0.5: Extract static base directory and glob pattern with picomatch.scan

# Picomatch Scan API Notes

`picomatch.scan(pattern, options)` parses a glob pattern and splits it into structural components:
- `base`: The non-glob base path prefix up to the first glob magic character.
- `glob`: The glob pattern segment following the static base path.
- `isGlob`: Boolean indicating whether glob characters were found in the pattern.
- `negated`: Boolean indicating whether the pattern begins with `!`.
- `prefix`: Leading prefix (such as `./` or `!`).

A common pitfall is expecting `./lib/*.js` to have `base: './lib'`, whereas `scan` extracts `./` into `prefix: './'` and leaves `base: 'lib'`.

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: Extract static base directory and glob pattern with picomatch.scan
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/picomatch@4.0.5
Demonstrate these symbols/APIs:
  - picomatch.scan

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:9001f087d7dfa825427f0dd07b8ddf7135c97c1c192ed7e55ddfb85c1b0cbf8a","contract":["assert picomatch.scan('src/components/button.tsx').isGlob is false","assert picomatch.scan('src/components/button.tsx').base is 'src/components/button.tsx'","assert picomatch.scan('src/components/**/*.tsx').isGlob is true","assert picomatch.scan('src/components/**/*.tsx').base is 'src/components'","assert picomatch.scan('src/components/**/*.tsx').glob is '**/*.tsx'","assert picomatch.scan('!dist/**/*.js').negated is true","assert picomatch.scan('!dist/**/*.js').prefix is '!'","assert picomatch.scan('!dist/**/*.js').base is 'dist'","assert picomatch.scan('./lib/*.js').prefix is './'","assert picomatch.scan('./lib/*.js').base is 'lib'"],"goal":"Extract static base directory and glob pattern with picomatch.scan","kind":"HOW","packages":["pkg:npm/picomatch@4.0.5"],"schemaVersion":1,"symbols":["picomatch.scan"]},"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/picomatch@4.0.5"],"schemaVersion":1,"subject":"pkg:npm/picomatch@4.0.5","symbols":["picomatch.scan"],"verifierAdapter":"node-typescript@1"}

{
  "name": "npm-picomatch-api",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "npm-picomatch-api",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "picomatch": "4.0.5"
      }
    },
    "node_modules/picomatch": {
      "version": "4.0.5",
      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.5.tgz",
      "integrity": "sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==",
      "license": "MIT",
      "engines": {
        "node": ">=12"
      },
      "funding": {
        "url": "https://github.com/sponsors/jonschlinkert"
      }
    }
  }
}

{
  "name": "npm-picomatch-api",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "license": "MIT-0",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "dependencies": {
    "picomatch": "4.0.5"
  }
}

{
  "schemaVersion": 1,
  "goal": "Extract static base directory and glob pattern with picomatch.scan",
  "kind": "HOW",
  "packages": [
    "pkg:npm/picomatch@4.0.5"
  ],
  "symbols": [
    "picomatch.scan"
  ]
}

import assert from 'node:assert/strict';
import picomatch from 'picomatch';

// Test 1: Static path without glob magic
const staticPath = picomatch.scan('src/components/button.tsx');
assert.equal(staticPath.isGlob, false);
assert.equal(staticPath.base, 'src/components/button.tsx');
assert.equal(staticPath.glob, '');
assert.equal(staticPath.negated, false);
assert.equal(staticPath.prefix, '');

// Test 2: Standard glob pattern with base directory
const globPattern = picomatch.scan('src/components/**/*.tsx');
assert.equal(globPattern.isGlob, true);
assert.equal(globPattern.base, 'src/components');
assert.equal(globPattern.glob, '**/*.tsx');
assert.equal(globPattern.negated, false);

// Test 3: Negated glob pattern
const negatedPattern = picomatch.scan('!dist/**/*.js');
assert.equal(negatedPattern.isGlob, true);
assert.equal(negatedPattern.negated, true);
assert.equal(negatedPattern.prefix, '!');
assert.equal(negatedPattern.base, 'dist');
assert.equal(negatedPattern.glob, '**/*.js');

// Test 4: Leading './' prefix
const prefixPattern = picomatch.scan('./lib/*.js');
assert.equal(prefixPattern.isGlob, true);
assert.equal(prefixPattern.prefix, './');
assert.equal(prefixPattern.base, 'lib');
assert.equal(prefixPattern.glob, '*.js');

console.log('picomatch.contract.pass');