@apollion-dsi/tokens 4.3.0 → 4.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apollion-dsi/tokens",
-  "version": "4.3.0",
+  "version": "4.4.0",
   "description": "Apollion Design System — Framework-agnostic design tokens",
   "homepage": "https://github.com/apollion-ds/apollion",
   "license": "MIT",
@@ -50,8 +50,7 @@
     "directory": "packages/tokens"
   },
   "scripts": {
-    "build": "node ./esbuild.cjs",
-    "postbuild": "tsc --emitDeclarationOnly",
+    "build": "node ./esbuild.cjs && tsc --emitDeclarationOnly",
     "check-types": "tsc --noEmit",
     "lint": "eslint src --quiet",
     "lint:full": "eslint src",
@@ -71,7 +70,7 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@apollion-dsi/core": "4.3.0",
+    "@apollion-dsi/core": "workspace:*",
     "@apollion-dsi/eslint-config": "0.8.0",
     "@types/culori": "4.0.1",
     "@types/jest": "30.0.0",
@@ -83,4 +82,4 @@
     "ts-jest": "^29.4.11",
     "typescript": "6.0.3"
   }
-}
+}

package/CHANGELOG.md

@@ -1,112 +0,0 @@
-# @apollion-dsi/tokens
-
-## 4.3.0
-
-## 4.2.0
-
-### Minor Changes
-
-- 12ae4e0: feat(tokens): DTCG 2025.10 remainders — dimension references, per-token metadata, and Resolver (R5)
-  - **Spacing + composite sub-value references**: `spacing` and `border.width`
-    now reference primitive scales (`{space.*}`, `{border-width.*}`) instead of
-    inlining literals. The `space` primitives are built per density via
-    `createSpacing`, so references resolve correctly under compact/normal/spacious.
-  - **`$deprecated` + `$description` per token**: populated from a `TOKEN_META`
-    registry through the IR into the JSON output (a stale-key guard fails the
-    build if a meta entry points at a non-existent token).
-  - **DTCG Resolver (R5)**: the JSON surface now emits a single `resolver.json`
-    plus composable `sets/` (axis-invariant `base` + per-axis colour/spacing sets)
-    instead of one fully-resolved document per variant — a hard cutover, made
-    pre-GA. A composition-equivalence test proves `base + colour + spacing`
-    reproduces the old per-variant document exactly. The CSS and TS surfaces are
-    unchanged: still per-variant, fully resolved, byte-identical.
-
-## 4.1.0
-
-### Minor Changes
-
-- 063e0e9: Align `@apollion-dsi/tokens` DTCG output with the Design Tokens Format Module 2025.10.
-  - **Structured values:** `color` `$value` is now an OKLch object `{ colorSpace, components, hex, alpha? }` and `dimension` is `{ value, unit }` (was bare hex / length strings).
-  - **Typed IR:** a single intermediate representation (`src/ir.ts`) drives the JSON/CSS/TS renderers as pure projections.
-  - **Reference graph:** JSON emits a `color` primitives layer (structural SSOT) and foundation `bg`/`text` colours reference it via DTCG aliases (`{color.primary.base}`), with inline fallback when a resolved value diverges (e.g. surface inversion).
-  - **Composite tokens:** `border` (dimension / strokeStyle), `typography` (fontFamily / fontWeight / number + dimension) and `shadow` (DTCG shadow composite) now ship; values DTCG cannot model (em `letterSpacing`, `textTransform`, `fontStyle`, `100%` radius) travel in `$extensions` under `com.apollion.*`.
-
-  `@apollion-dsi/core` now exports the `themes/{border,depth,font}` subpaths so tokens consumes them as the single source of truth.
-
-  CSS/TS outputs for the existing `bg`/`text`/`spacing` layers are byte-identical; JSON is the spec-interop surface.
-
-## 4.0.0
-
-### Major Changes
-
-- bd7d6cb: # v4.0.0 — OKLch + Dimension + Token Split
-
-  The v4 epic per [ADR-006](../packages/core/docs/adr/ADR-006-v4-oklch-dimension-token-split.md) + [PRD-002](../packages/core/docs/prd/PRD-002-v4-epic-execution.md). DS-from-scratch (Q-G grilling 2026-05-24); no consumer migration. Greenfield adoption via [MIGRATION-v4.md](../packages/core/docs/migration/MIGRATION-v4.md).
-
-  ## Breaking — `@apollion-dsi/core@4.0.0`
-  - **Root barrel removed.** `import { Button } from '@apollion-dsi/core'` no longer works. Use granular subpaths (`@apollion-dsi/core/elements/button`). ESLint rule flips warn → error. ADR-001 Slice 6 finalized here. ADR-006 §3.7 E7.
-  - **OKLch palette derivation.** All `mount*Colors` helpers + `getOppositeColor` migrated from `color@5` RGB lerp to `culori@4` OKLch lerp. Validated by `spike/culori-oklch-lerp-parity` (0 unexpected regressions; greyscale 19× more uniform in OKLAB L). ADR-006 §2 B1 + §6 S2.
-  - **`defaultInputColors.opposite` token value changed.** OKLch hue rotation differs from HSL rotation (the OKLch is the perceptually correct opposite). Audit `theme.colors.opposite.*` consumers.
-  - **Dimension axis added.** `<ApollionProvider dimension="compact|normal|spacious">` is a new prop; default `normal` preserves v3.x spacing byte-exact. ADR-006 §6 S3.
-  - **`vendors/Color` eliminated.** Internal `color@5` vendor deleted (zero call-sites after S6 migration). `color` + `@types/color` removed from `package.json#dependencies`. WCAG functions migrated to `culori.wcagContrast` + `culori.wcagLuminance` (100% bit-exact parity per `spike/culori-wcag-parity`).
-  - **`invertForSurface(theme, surface, mode)` 3-arg signature.** `mode` is additive optional — existing 2-arg calls continue to work; `mode` is a placeholder for future PRD-003 mode-aware inversion. ADR-006 §6 S6.
-
-  ## Minor — `@apollion-dsi/eslint-config`
-  - `culori` + `zod` added to `VENDORED_V4_LIBS` — must import via `vendors/Culori|Zod`.
-  - `color` removed from `VENDORED_T2_LIBS` (eliminated).
-  - `no-restricted-imports` for `'@apollion-dsi/core'` root: `warn` → `error` (per v4 barrel removal above).
-
-  ## Major — `@apollion-dsi/tokens@4.0.0` (first release)
-
-  New package — framework-agnostic design tokens consumed via `runtime/v1` versioned API + `apollion-tokens build` CLI.
-  - **Strangler Fig builders** duplicated from core (`colors.ts`, `spacing.ts`); Foundation + Surface re-exported. Parity enforced by `__tests__/parity.test.ts`. ADR-006 §3.1 + §6 S4.
-  - **Atomic + idempotent build CLI.** `apollion-tokens build [--check] [--verbose] --config <path> [--out <dir>]`. Emits `dist/{css,json,ts}/*` + `dist/manifest.json` with sha256 audit trail. Rerun byte-identical. `--check` mode for CI gate. ADR-006 §3.5 + §6 S5.
-  - **DTCG-compliant JSON output** (tech-radar R1).
-  - **`as const` TypeScript output** (tech-radar R4).
-  - **CSS `@property` declarations** (tech-radar R3) + custom properties `--apollion-{layer}-{role}-{variant}`.
-  - **Sandboxed `apollion.config.mjs` loader** (`node:vm` + zod schema) — threat-model T2+E1 mitigation. ADR-006 §3.8 B3 + §6 S6.
-  - **Lockstep version** with `@apollion-dsi/core` via `.changeset/config.json#fixed`.
-
-  ## Minor — `@apollion-dsi/scripts`
-  - `codemods/v4-migrate.mjs` — one-way codemod (Q-G10: no `--revert`; DEX/Jovian/Fanaticofc don't consume v3.x, no legacy to revert). Transforms `invertForSurface` to 3-arg, flags `createTheme` for manual hoist to `apollion.config.mjs`. Transcript JSONL audit log.
-  - `verify-no-install-scripts.js` — supply-chain hardening; blocks `preinstall`/`install`/`postinstall` in `@apollion-dsi/*` workspaces (threat-model E2 mitigation).
-
-  ## Spike validation (preserved local, NOT merged to main)
-  - `spike/culori-wcag-parity` — 100.0000% bit-exact culori vs color@5 (262 measurements / 10 palettes). `vendors/Color` elimination LOCKED.
-  - `spike/culori-oklch-lerp-parity` — 0 unexpected regressions in 68 deltas; greyscale ramp 19× more uniform in OKLAB L. DECISION ✅ PROCEED.
-
-### Patch Changes
-
-- Updated dependencies [032f81c]
-- Updated dependencies [32f7a1d]
-- Updated dependencies [2dadba5]
-- Updated dependencies [820a612]
-- Updated dependencies [c056ee3]
-- Updated dependencies [d032437]
-- Updated dependencies [00e0525]
-- Updated dependencies [1c87be8]
-- Updated dependencies [d1192da]
-- Updated dependencies [3194fba]
-- Updated dependencies [f359982]
-- Updated dependencies [5d17ebc]
-- Updated dependencies [bd7d6cb]
-- Updated dependencies [6545751]
-- Updated dependencies [36eaf4a]
-- Updated dependencies [802828f]
-- Updated dependencies [e14469c]
-- Updated dependencies [81cd55b]
-- Updated dependencies [c57c548]
-- Updated dependencies [879eedd]
-- Updated dependencies [e2abc9c]
-- Updated dependencies [75961a1]
-- Updated dependencies [e55019a]
-- Updated dependencies [fba9a41]
-- Updated dependencies [3a90653]
-- Updated dependencies [5fca933]
-- Updated dependencies [ea3dc3a]
-- Updated dependencies [51f71f6]
-- Updated dependencies [0a1baeb]
-- Updated dependencies [6d1371e]
-- Updated dependencies [e55019a]
-- Updated dependencies [29081ae]
-  - @apollion-dsi/core@4.0.0