ansi-styles 5.2.0

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/ansi-styles@5.2.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/ansi-styles@5.2.0

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:8aa6f6344d45430d44a854d02f1b2c90f095380a66ffc62160c545441ca8cf58","contract":["ansiStyles.color provides standard and bright foreground color escape sequences with matching open and close codes","ansiStyles.bgColor provides standard and bright background color escape sequences with matching open and close codes","ansiStyles.modifier provides text formatting modifiers including bold, dim, italic, underline, overline, and strikethrough","ansiStyles.color.ansi256 and ansiStyles.bgColor.ansi256 generate 256-color palette escape sequences","ansiStyles.color.ansi16m and ansiStyles.bgColor.ansi16m generate 24-bit truecolor escape sequences","ansiStyles color conversion functions convert between RGB, HEX, and ANSI 256 color spaces","ansiStyles.codes maps opening ANSI codes to their corresponding closing codes"],"goal":"verify pkg:npm/ansi-styles@5.2.0","kind":"HOW","packages":["pkg:npm/ansi-styles@5.2.0"],"schemaVersion":1},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"esm","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/ansi-styles@5.2.0"],"schemaVersion":1,"subject":"pkg:npm/ansi-styles@5.2.0","verifierAdapter":"node-typescript@1"}

{
  "name": "sample-ansi-styles",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-ansi-styles",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "ansi-styles": "5.2.0"
      }
    },
    "node_modules/ansi-styles": {
      "version": "5.2.0",
      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz",
      "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==",
      "license": "MIT",
      "engines": {
        "node": ">=10"
      },
      "funding": {
        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
      }
    }
  }
}

{
  "name": "sample-ansi-styles",
  "version": "1.0.0",
  "type": "module",
  "private": true,
  "license": "MIT-0",
  "scripts": {
    "test": "node test/contract.mjs"
  },
  "dependencies": {
    "ansi-styles": "5.2.0"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/ansi-styles@5.2.0",
  "kind": "HOW",
  "packages": [
    "pkg:npm/ansi-styles@5.2.0"
  ]
}

import ansiStyles from 'ansi-styles';

export function formatColor(text, colorName) {
  const color = ansiStyles.color[colorName];
  if (!color) {
    throw new Error(`Unknown color: ${colorName}`);
  }
  return `${color.open}${text}${color.close}`;
}

export function formatBgColor(text, bgColorName) {
  const bgColor = ansiStyles.bgColor[bgColorName];
  if (!bgColor) {
    throw new Error(`Unknown background color: ${bgColorName}`);
  }
  return `${bgColor.open}${text}${bgColor.close}`;
}

export function formatModifier(text, modifierName) {
  const modifier = ansiStyles.modifier[modifierName];
  if (!modifier) {
    throw new Error(`Unknown modifier: ${modifierName}`);
  }
  return `${modifier.open}${text}${modifier.close}`;
}

export function formatAnsi256(text, code, isBg = false) {
  const open = isBg ? ansiStyles.bgColor.ansi256(code) : ansiStyles.color.ansi256(code);
  const close = isBg ? ansiStyles.bgColor.close : ansiStyles.color.close;
  return `${open}${text}${close}`;
}

export function formatAnsi16m(text, r, g, b, isBg = false) {
  const open = isBg ? ansiStyles.bgColor.ansi16m(r, g, b) : ansiStyles.color.ansi16m(r, g, b);
  const close = isBg ? ansiStyles.bgColor.close : ansiStyles.color.close;
  return `${open}${text}${close}`;
}

export function convertHexToRgb(hex) {
  return ansiStyles.hexToRgb(hex);
}

export function convertRgbToAnsi256(r, g, b) {
  return ansiStyles.rgbToAnsi256(r, g, b);
}

export function convertHexToAnsi256(hex) {
  return ansiStyles.hexToAnsi256(hex);
}

export { ansiStyles };
export default ansiStyles;

import assert from 'node:assert';
import ansiStyles, {
  formatColor,
  formatBgColor,
  formatModifier,
  formatAnsi256,
  formatAnsi16m,
  convertHexToRgb,
  convertRgbToAnsi256,
  convertHexToAnsi256,
} from '../src/index.mjs';

// 1. ansiStyles.color provides standard and bright foreground color escape sequences with matching open and close codes
assert.strictEqual(ansiStyles.color.red.open, '\u001B[31m');
assert.strictEqual(ansiStyles.color.red.close, '\u001B[39m');
assert.strictEqual(ansiStyles.color.green.open, '\u001B[32m');
assert.strictEqual(ansiStyles.color.green.close, '\u001B[39m');
assert.strictEqual(ansiStyles.color.blue.open, '\u001B[34m');
assert.strictEqual(ansiStyles.color.blue.close, '\u001B[39m');
assert.strictEqual(ansiStyles.color.black.open, '\u001B[30m');
assert.strictEqual(ansiStyles.color.yellow.open, '\u001B[33m');
assert.strictEqual(ansiStyles.color.magenta.open, '\u001B[35m');
assert.strictEqual(ansiStyles.color.cyan.open, '\u001B[36m');
assert.strictEqual(ansiStyles.color.white.open, '\u001B[37m');

assert.strictEqual(ansiStyles.color.blackBright.open, '\u001B[90m');
assert.strictEqual(ansiStyles.color.blackBright.close, '\u001B[39m');
assert.strictEqual(ansiStyles.color.redBright.open, '\u001B[91m');
assert.strictEqual(ansiStyles.color.greenBright.open, '\u001B[92m');
assert.strictEqual(ansiStyles.color.yellowBright.open, '\u001B[93m');
assert.strictEqual(ansiStyles.color.blueBright.open, '\u001B[94m');
assert.strictEqual(ansiStyles.color.magentaBright.open, '\u001B[95m');
assert.strictEqual(ansiStyles.color.cyanBright.open, '\u001B[96m');
assert.strictEqual(ansiStyles.color.whiteBright.open, '\u001B[97m');

assert.deepStrictEqual(ansiStyles.color.gray, ansiStyles.color.blackBright);
assert.deepStrictEqual(ansiStyles.color.grey, ansiStyles.color.blackBright);
assert.strictEqual(ansiStyles.color.close, '\u001B[39m');
assert.strictEqual(formatColor('test', 'red'), '\u001B[31mtest\u001B[39m');

// 2. ansiStyles.bgColor provides standard and bright background color escape sequences with matching open and close codes
assert.strictEqual(ansiStyles.bgColor.bgRed.open, '\u001B[41m');
assert.strictEqual(ansiStyles.bgColor.bgRed.close, '\u001B[49m');
assert.strictEqual(ansiStyles.bgColor.bgGreen.open, '\u001B[42m');
assert.strictEqual(ansiStyles.bgColor.bgGreen.close, '\u001B[49m');
assert.strictEqual(ansiStyles.bgColor.bgBlue.open, '\u001B[44m');
assert.strictEqual(ansiStyles.bgColor.bgBlue.close, '\u001B[49m');
assert.strictEqual(ansiStyles.bgColor.bgBlack.open, '\u001B[40m');
assert.strictEqual(ansiStyles.bgColor.bgYellow.open, '\u001B[43m');
assert.strictEqual(ansiStyles.bgColor.bgMagenta.open, '\u001B[45m');
assert.strictEqual(ansiStyles.bgColor.bgCyan.open, '\u001B[46m');
assert.strictEqual(ansiStyles.bgColor.bgWhite.open, '\u001B[47m');

assert.strictEqual(ansiStyles.bgColor.bgBlackBright.open, '\u001B[100m');
assert.strictEqual(ansiStyles.bgColor.bgBlackBright.close, '\u001B[49m');
assert.strictEqual(ansiStyles.bgColor.bgRedBright.open, '\u001B[101m');
assert.strictEqual(ansiStyles.bgColor.bgGreenBright.open, '\u001B[102m');
assert.strictEqual(ansiStyles.bgColor.bgYellowBright.open, '\u001B[103m');
assert.strictEqual(ansiStyles.bgColor.bgBlueBright.open, '\u001B[104m');
assert.strictEqual(ansiStyles.bgColor.bgMagentaBright.open, '\u001B[105m');
assert.strictEqual(ansiStyles.bgColor.bgCyanBright.open, '\u001B[106m');
assert.strictEqual(ansiStyles.bgColor.bgWhiteBright.open, '\u001B[107m');

assert.deepStrictEqual(ansiStyles.bgColor.bgGray, ansiStyles.bgColor.bgBlackBright);
assert.deepStrictEqual(ansiStyles.bgColor.bgGrey, ansiStyles.bgColor.bgBlackBright);
assert.strictEqual(ansiStyles.bgColor.close, '\u001B[49m');
assert.strictEqual(formatBgColor('test', 'bgBlue'), '\u001B[44mtest\u001B[49m');

// 3. ansiStyles.modifier provides text formatting modifiers including bold, dim, italic, underline, overline, and strikethrough
assert.strictEqual(ansiStyles.modifier.reset.open, '\u001B[0m');
assert.strictEqual(ansiStyles.modifier.reset.close, '\u001B[0m');
assert.strictEqual(ansiStyles.modifier.bold.open, '\u001B[1m');
assert.strictEqual(ansiStyles.modifier.bold.close, '\u001B[22m');
assert.strictEqual(ansiStyles.modifier.dim.open, '\u001B[2m');
assert.strictEqual(ansiStyles.modifier.dim.close, '\u001B[22m');
assert.strictEqual(ansiStyles.modifier.italic.open, '\u001B[3m');
assert.strictEqual(ansiStyles.modifier.italic.close, '\u001B[23m');
assert.strictEqual(ansiStyles.modifier.underline.open, '\u001B[4m');
assert.strictEqual(ansiStyles.modifier.underline.close, '\u001B[24m');
assert.strictEqual(ansiStyles.modifier.overline.open, '\u001B[53m');
assert.strictEqual(ansiStyles.modifier.overline.close, '\u001B[55m');
assert.strictEqual(ansiStyles.modifier.inverse.open, '\u001B[7m');
assert.strictEqual(ansiStyles.modifier.inverse.close, '\u001B[27m');
assert.strictEqual(ansiStyles.modifier.hidden.open, '\u001B[8m');
assert.strictEqual(ansiStyles.modifier.hidden.close, '\u001B[28m');
assert.strictEqual(ansiStyles.modifier.strikethrough.open, '\u001B[9m');
assert.strictEqual(ansiStyles.modifier.strikethrough.close, '\u001B[29m');
assert.strictEqual(formatModifier('test', 'bold'), '\u001B[1mtest\u001B[22m');
assert.strictEqual(formatModifier('test', 'overline'), '\u001B[53mtest\u001B[55m');

// 4. ansiStyles.color.ansi256 and ansiStyles.bgColor.ansi256 generate 256-color palette escape sequences
assert.strictEqual(ansiStyles.color.ansi256(199), '\u001B[38;5;199m');
assert.strictEqual(ansiStyles.bgColor.ansi256(199), '\u001B[48;5;199m');
assert.strictEqual(formatAnsi256('test', 199, false), '\u001B[38;5;199mtest\u001B[39m');
assert.strictEqual(formatAnsi256('test', 199, true), '\u001B[48;5;199mtest\u001B[49m');

// 5. ansiStyles.color.ansi16m and ansiStyles.bgColor.ansi16m generate 24-bit truecolor escape sequences
assert.strictEqual(ansiStyles.color.ansi16m(255, 128, 64), '\u001B[38;2;255;128;64m');
assert.strictEqual(ansiStyles.bgColor.ansi16m(255, 128, 64), '\u001B[48;2;255;128;64m');
assert.strictEqual(formatAnsi16m('test', 255, 128, 64, false), '\u001B[38;2;255;128;64mtest\u001B[39m');
assert.strictEqual(formatAnsi16m('test', 255, 128, 64, true), '\u001B[48;2;255;128;64mtest\u001B[49m');

// 6. ansiStyles color conversion functions convert between RGB, HEX, and ANSI 256 color spaces
assert.deepStrictEqual(convertHexToRgb('#ff00aa'), [255, 0, 170]);
assert.deepStrictEqual(convertHexToRgb('#f0a'), [255, 0, 170]);
assert.strictEqual(convertRgbToAnsi256(255, 255, 255), 231);
assert.strictEqual(convertRgbToAnsi256(0, 0, 0), 16);
assert.strictEqual(convertRgbToAnsi256(128, 128, 128), 244);
assert.strictEqual(convertHexToAnsi256('#ff00aa'), 199);

// 7. ansiStyles.codes maps opening ANSI codes to their corresponding closing codes
assert(ansiStyles.codes instanceof Map);
assert.strictEqual(ansiStyles.codes.get(1), 22);
assert.strictEqual(ansiStyles.codes.get(31), 39);
assert.strictEqual(ansiStyles.codes.get(41), 49);
assert.strictEqual(ansiStyles.codes.get(53), 55);

console.log('All contract assertions passed.');