@phcdevworks/spectre-tokens 4.0.0 → 4.1.0

package/README.md

@@ -17,7 +17,7 @@ contracts for specific frameworks and runtimes.
 | Project team           | `project-design`                 |
 | Repository role        | Spectre L1 design-token contract |
 | Package/artifact       | `@phcdevworks/spectre-tokens`    |
-| Current version/status | 4.0.0                            |
+| Current version/status | 4.1.0                            |
 
 ## Standard Workflow
 
@@ -30,17 +30,18 @@ contracts for specific frameworks and runtimes.
 
 ## Documentation Map
 
-| Guide       | Path                         |
-| ----------- | ---------------------------- |
-| Agent rules | [AGENTS.md](AGENTS.md)       |
-| Claude Code | [CLAUDE.md](CLAUDE.md)       |
-| Codex       | [CODEX.md](CODEX.md)         |
-| Copilot     | [COPILOT.md](COPILOT.md)     |
-| Jules       | [JULES.md](JULES.md)         |
-| Roadmap     | [ROADMAP.md](ROADMAP.md)     |
-| Todo        | [TODO.md](TODO.md)           |
-| Changelog   | [CHANGELOG.md](CHANGELOG.md) |
-| Security    | [SECURITY.md](SECURITY.md)   |
+| Guide           | Path                                     |
+| --------------- | ---------------------------------------- |
+| Agent rules     | [AGENTS.md](AGENTS.md)                   |
+| Claude Code     | [CLAUDE.md](CLAUDE.md)                   |
+| Codex           | [CODEX.md](CODEX.md)                     |
+| Copilot         | [COPILOT.md](COPILOT.md)                 |
+| Jules           | [JULES.md](JULES.md)                     |
+| Roadmap         | [ROADMAP.md](ROADMAP.md)                 |
+| Todo            | [TODO.md](TODO.md)                       |
+| Token reference | [TOKEN_REFERENCE.md](TOKEN_REFERENCE.md) |
+| Changelog       | [CHANGELOG.md](CHANGELOG.md)             |
+| Security        | [SECURITY.md](SECURITY.md)               |
 
 [![npm version](https://img.shields.io/npm/v/@phcdevworks/spectre-tokens)](https://www.npmjs.com/package/@phcdevworks/spectre-tokens)
 [![CI](https://github.com/phcdevworks/spectre-tokens/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/phcdevworks/spectre-tokens/actions/workflows/ci.yml)
@@ -305,6 +306,9 @@ The exported runtime token object is a flattened string-based tree generated
 from `tokens/`. Source-only wrapper fields such as `value` and `metadata` are
 internal generation details and are not part of the public package contract.
 
+See [TOKEN_REFERENCE.md](TOKEN_REFERENCE.md) for the exhaustive, generated
+list of every token path, resolved value, and usage note.
+
 The `layout` namespace includes section, stack, and container spacing tokens,
 plus fixed layout width tokens for common consumer shells:
 `layout.container.maxWidth`, `layout.container.maxWidthProse`, and
@@ -514,14 +518,13 @@ treated as downstream UI primitives.
 
 Claude Code (`claude-sonnet-4-6`) is the primary development agent for this
 repository. Codex handles releases and production stabilization, including
-cutting tagged releases and GitHub Releases. Jules handles small automated
-fixes and generated-output sync. GitHub Copilot provides development
-support.
-
-All AI agents with repository access (Claude Code, Codex, Copilot, Jules)
-have commit, push, and tag authority in this repository. Publishing to npm
-remains Bradley Potts's sole authority. See [AGENTS.md](AGENTS.md) for the
-full commit-policy and release-authority grant.
+cutting tagged releases and GitHub Releases. Jules handles small automated fixes
+and generated-output sync. GitHub Copilot provides development support.
+
+All AI agents with repository access (Claude Code, Codex, Copilot, Jules) have
+commit, push, and tag authority in this repository. Publishing to npm remains
+Bradley Potts's sole authority. See [AGENTS.md](AGENTS.md) for the full
+commit-policy and release-authority grant.
 
 **Protected from automated change:** locked color families (`success`,
 `warning`, `danger`, CTA/brand-action), `contract.manifest.json`, and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phcdevworks/spectre-tokens",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "@phcdevworks/spectre-tokens is the design-token package of the Spectre system. It provides a complete, UI-ready token surface for downstream Spectre packages and compatible applications.",
   "keywords": [
     "phcdevworks",
@@ -35,7 +35,7 @@
     "node": "^22.12.0 || >=24.0.0"
   },
   "type": "module",
-  "packageManager": "npm@12.0.1",
+  "packageManager": "npm@12.0.2",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -57,10 +57,11 @@
   "scripts": {
     "generate": "tsx scripts/generate-types.ts",
     "prebuild": "npm run generate",
-    "build": "npm run build:ts && npm run build:css && npm run build:design",
+    "build": "npm run build:ts && npm run build:css && npm run build:design && npm run build:docs",
     "build:ts": "tsup --config tsup.config.ts",
     "build:css": "tsx scripts/build-css.ts",
     "build:design": "tsx scripts/build-dtcg.ts",
+    "build:docs": "tsx scripts/build-token-reference.ts",
     "check:manifest": "tsx scripts/check-contract-manifest.ts",
     "check:docs": "tsx scripts/check-doc-contract.ts",
     "check:version-sync": "npm run check:docs",
@@ -98,9 +99,9 @@
   },
   "devDependencies": {
     "@phcdevworks/spectre-manifest": "^1.1.0",
-    "@types/node": "^26.1.1",
-    "@typescript-eslint/eslint-plugin": "^8.65.0",
-    "@typescript-eslint/parser": "^8.65.0",
+    "@types/node": "^26.1.2",
+    "@typescript-eslint/eslint-plugin": "^8.66.0",
+    "@typescript-eslint/parser": "^8.66.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "colord": "^2.9.3",
     "eslint": "^10.8.0",
@@ -109,9 +110,9 @@
     "style-dictionary": "^5.5.0",
     "ts-node": "^10.9.2",
     "tsup": "^8.5.1",
-    "tsx": "^4.23.1",
+    "tsx": "^4.23.5",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "typescript-eslint": "^8.65.0",
+    "typescript-eslint": "^8.66.0",
     "vitest": "^4.1.10"
   },
   "overrides": {