color-map 2.3.0 → 2.3.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "color-map",
-	"version": "2.3.0",
+	"version": "2.3.1",
 	"description": "Generate WCAG-checked color palettes, scales and design tokens with the color-map CLI",
 	"author": {
 		"name": "Homa Wong (unional)"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "color-map",
-	"version": "2.3.0",
+	"version": "2.3.1",
 	"description": "Generate WCAG-checked color palettes, scales and design tokens with the color-map CLI",
 	"author": {
 		"name": "Homa Wong (unional)"

package/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
 	"name": "color-map",
-	"version": "2.3.0",
+	"version": "2.3.1",
 	"description": "Generate WCAG-checked color palettes, scales and design tokens with the color-map CLI",
 	"author": {
 		"name": "Homa Wong (unional)"

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # color-map
 
+## 2.3.1
+
+### Patch Changes
+
+- 764413e: `llms.txt` now maps the library as well as the commands: each entry point with its exports, the conventions that hold across them, and the `schema` command, which it had left out. The docs site serves the same file at `/color-map/llms.txt`.
+
 ## 2.3.0
 
 ### Minor Changes

package/bin/{cli-CNBftDBE.js → cli-CELmx3Y9.js}

@@ -6411,4 +6411,4 @@ function createApp(options) {
 	for (const c of commands) app = app.command(c);
 	return app.command(schemaCommand(commands));
 }
-export { createApp as n, schemaOf as r, commands as t };
+export { schemaOf as i, createApp as n, schemaCommand as r, commands as t };

package/bin/color-map.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as createApp } from "./cli-CNBftDBE.js";
+import { n as createApp } from "./cli-CELmx3Y9.js";
 import { readFileSync } from "node:fs";
 // src/cli/bin.ts
 const { version } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));

package/bin/index.js

@@ -1 +1 @@
-export { t as commands, n as createApp, r as schemaOf } from "./cli-CNBftDBE.js";
+export { t as commands, n as createApp, r as schemaCommand, i as schemaOf } from "./cli-CELmx3Y9.js";

package/llms.txt

@@ -1,8 +1,16 @@
 # color-map
 
-> The `color-map` command: convert, mix, contrast-check, scale and export CSS colors, and build a semantic palette whose text pairs all pass WCAG 2, from one brand color.
+> Parse, convert, mix and serialize every CSS color, check WCAG 2 contrast, and build scales, semantic palettes and design tokens from one brand color. One package holds a TypeScript library, the `color-map` command and an agent skill.
 
-This file is generated by `scripts/generate-llms-txt.mjs` from the command table. Do not edit it.
+This file is generated by `scripts/generate-llms-txt.mjs` from the package exports and the command table. Do not edit it.
+
+Conventions that hold for the library:
+
+- No runtime dependencies, and `"sideEffects": false`, so a bundler keeps only what you import.
+- `color-map` re-exports `color-map/color`, `color-map/palette`, `color-map/scale` and `color-map/tokens`. Without a bundler it loads every module, so import from a subpath to load less.
+- `Color` is `{ colorSpace, components, alpha? }`. A color as plain JSON. Component ranges follow CSS: `srgb` is 0 to 1, `hsl` and `hwb` take hue in degrees and the rest in 0 to 100, `lab` and `lch` take L in 0 to 100, `oklab` and `oklch` take L in 0 to 1. A missing `alpha` is 1. `Component` is `number | null`. A component value. `null` stands for the CSS keyword `none`.
+- `deltaEOk`, `equals`, `contrast`, `findContrast`, `meets`, `onColor`, `inGamut`, `toGamut`, `mix` and `toHex` each have a narrow form named `create` plus the name. It takes the spaces your colors are in and returns the helper over just those, so a bundle does not carry all 15 spaces. `createConverter` does the same for `convert`.
+- `contrast`, `findContrast`, `meets`, `onColor` and `mix` also take a CSS color string; the other helpers above take a `Color`, so run strings through `parse` first. Every narrow form takes `Color` objects only.
 
 Conventions that hold for every command:
 
@@ -13,6 +21,15 @@ Conventions that hold for every command:
 - A failure exits 1 or 2 with `error`, `code` and `help` fields on stdout. Nothing prompts; unknown options fail.
 - Run it with `npx color-map <command>`, or install the `color-map` agent skill from this package.
 
+## Library
+
+- [color-map](https://cyberuni.github.io/color-map/library/): re-exports `color-map/color`, `color-map/palette`, `color-map/scale` and `color-map/tokens`. It also exports `Alpha`, `ColorMap`, `createColors`, `createColorsFromMap`, `RGB`, `RGBA`, `rgbaString`, `rgbHex`, deprecated: import them from `color-map/legacy`.
+- [color-map/color](https://cyberuni.github.io/color-map/library/#color-mapcolor): `a98Rgb`, `contrast`, `convert`, `convertComponents`, `createContrast`, `createConverter`, `createDeltaEOk`, `createEquals`, `createFindContrast`, `createInGamut`, `createMeets`, `createMix`, `createOnColor`, `createToGamut`, `createToHex`, `deltaEOk`, `displayP3`, `displayP3Linear`, `equals`, `findContrast`, `fromArgb`, `hsl`, `hwb`, `inGamut`, `lab`, `lch`, `meets`, `mix`, `oklab`, `oklch`, `onColor`, `parse`, `parseExpr`, `prophotoRgb`, `rec2020`, `resolve`, `spaces`, `srgb`, `srgbLinear`, `toArgb`, `toCss`, `toGamut`, `toHex`, `wcag2`, `xyzD50`, `xyzD65`. Types: `Color`, `ColorExpr`, `ColorSpaceId`, `Component`, `ContrastAlgorithm`, `ContrastFn`, `ContrastOption`, `FindContrastOptions`, `FoundContrast`, `GamutId`, `HueMethod`, `MixOptions`, `OnColorOptions`, `ResolveContext`, `Space`, `ToCssOptions`, `ToGamutOptions`, `Vec3`.
+- [color-map/legacy](https://cyberuni.github.io/color-map/library/#color-maplegacy): `createColors`, `createColorsFromMap`, `rgbaString`, `rgbHex`. Types: `Alpha`, `ColorMap`, `RGB`, `RGBA`.
+- [color-map/palette](https://cyberuni.github.io/color-map/library/#color-mappalette): `darkVariant`, `harmonize`, `harmony`, `inverse`, `semanticPalette`, `validate`. Types: `DarkStrategy`, `DarkVariantOptions`, `HarmonizeOptions`, `HarmonyOptions`, `HarmonyScheme`, `HarmonySpace`, `PaletteIssue`, `PaletteLike`, `RolePair`, `SemanticPalette`, `SemanticPaletteOptions`, `SemanticRole`, `ValidateOptions`, `ValidateResult`.
+- [color-map/scale](https://cyberuni.github.io/color-map/library/#color-mapscale): `createContrastScale`, `createGradient`, `createScale`, `lstar`, `MATERIAL_TONES`, `scaleFromBrand`, `tonalPalette`, `toneColor`. Types: `BrandScaleOptions`, `ContrastScaleOptions`, `ContrastStep`, `GradientOptions`, `GradientStop`, `ScaleOptions`, `ScalePreset`, `TonalPaletteOptions`.
+- [color-map/tokens](https://cyberuni.github.io/color-map/library/#color-maptokens): `toCssVariables`, `toDtcg`, `toDtcgValue`, `toTailwindTheme`. Types: `CssVariablesOptions`, `DtcgColorValue`, `DtcgGroup`, `DtcgOptions`, `DtcgToken`, `TailwindThemeOptions`, `TokenTree`.
+
 ## Commands
 
 - [convert](https://unpkg.com/color-map/schemas/convert.schema.json): Convert a CSS color to another color space. Usage: `color-map convert <color>` with --to, --gamut, --full.
@@ -23,7 +40,9 @@ Conventions that hold for every command:
 - [palette](https://unpkg.com/color-map/schemas/palette.schema.json): A semantic palette from one brand color: primary, status colors, surface and outline, each with a text color and its WCAG 2 ratio. Usage: `color-map palette <brand>` with --mode, --target, --gamut, --full.
 - [harmony](https://unpkg.com/color-map/schemas/harmony.schema.json): The colors of a harmony scheme: the color rotated around the hue wheel. Usage: `color-map harmony <color>` with --scheme, --space, --gamut.
 - [export](https://unpkg.com/color-map/schemas/export.schema.json): Write a palette, a scale or your own tokens as DTCG JSON, CSS variables or a Tailwind v4 theme. Usage: `color-map export [color]` with --to, --source, --mode, --tokens, --space, --prefix, --selector, --namespace, --inline, --precision, --hex.
+- [schema](https://cyberuni.github.io/color-map/cli/#machine-readable-help): Print the JSON Schema of a command's arguments and options. Usage: `color-map schema [command]` with no options.
 
 ## Optional
 
 - [Source and README](https://github.com/cyberuni/color-map): the color-map library and CLI.
+- [Generator](https://github.com/cyberuni/color-map/blob/main/packages/color-map/scripts/generate-llms-txt.mjs): run it with `--gaps` to list the 0 exports that have no doc comment.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "color-map",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Color map generator and color toolkit: a library, a CLI and an agent skill",
   "homepage": "https://github.com/cyberuni/color-map",
   "bugs": {
@@ -89,6 +89,7 @@
     "npm-run-all2": "^9.0.3",
     "rimraf": "^6.1.3",
     "size-limit": "^14.3.0",
+    "ts-6.0": "npm:typescript@6.0.3",
     "tsdown": "^0.23.0",
     "typescript": "^7.0.2",
     "vitest": "^5.0.0"

package/plugin.json

@@ -1,7 +1,7 @@
 {
 	"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
 	"name": "color-map",
-	"version": "2.3.0",
+	"version": "2.3.1",
 	"description": "Generate WCAG-checked color palettes, scales and design tokens with the color-map CLI",
 	"author": {
 		"name": "Homa Wong (unional)"

package/src/cli/index.ts

@@ -1,2 +1,3 @@
 export { commands, createApp } from './cli.js'
+export { schemaCommand } from './schema-command.js'
 export { type SchemaSource, schemaOf } from './schemas.js'