postcss-selector-parser 7.1.1: id

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 postcss-selector-parser.id in pkg:npm/postcss-selector-parser@7.1.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/postcss-selector-parser@7.1.1
Demonstrate these symbols/APIs:
  - postcss-selector-parser.id

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:fa5c954e5e2984a1778b82db511b184a63c550f55a2d9a2294a7f8b9805d2aab","contract":["id creates an id selector node with the specified value and stringifies to hash-prefixed selector","id supports updating value property dynamically","id supports custom spacing via spaces before and after properties","id supports raw value formatting via raws","id node can be cloned with preserved type and value","id node attaches to parent selector container AST hierarchy","findIds extracts all id nodes from complex CSS selectors using walkIds","renameIds transforms id selector values across complex selectors"],"goal":"verify postcss-selector-parser.id in pkg:npm/postcss-selector-parser@7.1.1","kind":"HOW","packages":["pkg:npm/postcss-selector-parser@7.1.1"],"schemaVersion":1,"symbols":["postcss-selector-parser.id"]},"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/postcss-selector-parser@7.1.1"],"schemaVersion":1,"subject":"pkg:npm/postcss-selector-parser@7.1.1","symbols":["postcss-selector-parser.id"],"verifierAdapter":"node-typescript@1"}

import parser from 'postcss-selector-parser';

/**
 * Creates an ID selector node programmatically.
 *
 * @param {object} [props] - Properties for the ID node.
 * @returns {object} ID selector node.
 */
export function createId(props) {
  return parser.id(props);
}

/**
 * Parses a CSS selector string and returns all ID selector nodes found.
 *
 * @param {string} selector - CSS selector string.
 * @returns {Array<object>} Array of ID nodes.
 */
export function findIds(selector) {
  const ids = [];
  parser((selectors) => {
    selectors.walkIds((node) => {
      ids.push(node);
    });
  }).processSync(selector);
  return ids;
}

/**
 * Parses a CSS selector string and renames matching ID selectors.
 *
 * @param {string} selector - CSS selector string.
 * @param {function(string): string} transform - Function to rename ID values.
 * @returns {string} Transformed selector string.
 */
export function renameIds(selector, transform) {
  return parser((selectors) => {
    selectors.walkIds((node) => {
      node.value = transform(node.value);
    });
  }).processSync(selector);
}

export default parser;

{
  "name": "sample-postcss-selector-parser-id",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-postcss-selector-parser-id",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "postcss-selector-parser": "7.1.1"
      }
    },
    "node_modules/cssesc": {
      "version": "3.0.0",
      "resolved": "https://registry.npmjs.org/cssesc/-/cssesc-3.0.0.tgz",
      "integrity": "sha512-/Tb/JcjK111nNScGob5MNtsntNM1aCNUDipB/TkwZFhyDrrE47SOx/18wF2bbjgc3ZzCSKW1T5nt5EbFoAz/Vg==",
      "license": "MIT",
      "bin": {
        "cssesc": "bin/cssesc"
      },
      "engines": {
        "node": ">=4"
      }
    },
    "node_modules/postcss-selector-parser": {
      "version": "7.1.1",
      "resolved": "https://registry.npmjs.org/postcss-selector-parser/-/postcss-selector-parser-7.1.1.tgz",
      "integrity": "sha512-orRsuYpJVw8LdAwqqLykBj9ecS5/cRHlI5+nvTo8LcCKmzDmqVORXtOIYEEQuL9D4BxtA1lm5isAqzQZCoQ6Eg==",
      "license": "MIT",
      "dependencies": {
        "cssesc": "^3.0.0",
        "util-deprecate": "^1.0.2"
      },
      "engines": {
        "node": ">=4"
      }
    },
    "node_modules/util-deprecate": {
      "version": "1.0.2",
      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
      "license": "MIT"
    }
  }
}

{
  "name": "sample-postcss-selector-parser-id",
  "version": "1.0.0",
  "type": "module",
  "main": "index.mjs",
  "license": "MIT-0",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "dependencies": {
    "postcss-selector-parser": "7.1.1"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify postcss-selector-parser.id in pkg:npm/postcss-selector-parser@7.1.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/postcss-selector-parser@7.1.1"
  ],
  "symbols": [
    "postcss-selector-parser.id"
  ]
}

import assert from 'node:assert/strict';
import parser, { createId, findIds, renameIds } from '../index.mjs';

// 1. id creates an id selector node with the specified value and stringifies to hash-prefixed selector
const idNode = createId({ value: 'header' });
assert.equal(idNode.type, 'id');
assert.equal(idNode.value, 'header');
assert.equal(idNode.toString(), '#header');

// 2. id supports updating value property dynamically
idNode.value = 'main-nav';
assert.equal(idNode.value, 'main-nav');
assert.equal(idNode.toString(), '#main-nav');

// 3. id supports custom spacing via spaces before and after properties
const idSpaces = createId({
  value: 'sidebar',
  spaces: { before: '  ', after: ' ' }
});
assert.equal(idSpaces.spaces.before, '  ');
assert.equal(idSpaces.spaces.after, ' ');
assert.equal(idSpaces.toString(), '  #sidebar ');

// 4. id supports raw value formatting via raws
const idRaw = createId({
  value: 'escaped:id',
  raws: { value: 'escaped\\:id' }
});
assert.equal(idRaw.value, 'escaped:id');
assert.equal(idRaw.raws.value, 'escaped\\:id');
assert.equal(idRaw.toString(), '#escaped\\:id');

// 5. id node can be cloned with preserved type and value
const original = createId({ value: 'cloned-id' });
const cloned = original.clone();
assert.equal(cloned.type, 'id');
assert.equal(cloned.value, 'cloned-id');
assert.equal(cloned.toString(), '#cloned-id');
assert.notEqual(cloned, original);

// 6. id node attaches to parent selector container AST hierarchy
const selectorContainer = parser.selector();
const tag = parser.tag({ value: 'main' });
const idAttached = parser.id({ value: 'content' });
selectorContainer.append(tag);
selectorContainer.append(idAttached);
assert.equal(selectorContainer.toString(), 'main#content');
assert.equal(idAttached.parent, selectorContainer);

// 7. findIds extracts all id nodes from complex CSS selectors using walkIds
const found = findIds('div#app > section#main-content article#post-123 .comments #footer');
assert.equal(found.length, 4);
assert.equal(found[0].value, 'app');
assert.equal(found[1].value, 'main-content');
assert.equal(found[2].value, 'post-123');
assert.equal(found[3].value, 'footer');

// 8. renameIds transforms id selector values across complex selectors
const renamed = renameIds('#header > div#main-menu, form#login-form', (val) => `v2-${val}`);
assert.equal(renamed, '#v2-header > div#v2-main-menu, form#v2-login-form');

console.log('All postcss-selector-parser.id contract tests passed successfully.');