@apollion-dsi/tokens 4.9.1 → 4.10.0

package/README.md

@@ -2,13 +2,15 @@
 
 Framework-agnostic design tokens for Apollion Design System v4+.
 
-**Status:** ✅ **GA desde 4.2.0** — v4 epic shipped 2026-05-25 (ADR-006). Atual **4.7.0**, lockstep com `@apollion-dsi/core@4.7.0`.
+[![npm](https://img.shields.io/npm/v/@apollion-dsi/tokens.svg)](https://www.npmjs.com/package/@apollion-dsi/tokens)
+
+**Status:** ✅ GA since 4.2.0 (v4). Versioned in lockstep with `@apollion-dsi/core`.
 
 ## Versioned API
 
 Single public entry: `@apollion-dsi/tokens/runtime/v1`.
 
-Future major surface changes go to `runtime/v2`, `runtime/v3`, etc. — `v1` is preserved indefinitely (Strangler Fig per ADR-006 §3.3).
+Future major surface changes go to `runtime/v2`, `runtime/v3`, etc. — `v1` is preserved indefinitely (Strangler Fig).
 
 ```ts
 import { TOKENS_RUNTIME_API_VERSION } from '@apollion-dsi/tokens/runtime/v1';
@@ -30,26 +32,16 @@ Tokens em JSON estruturado — values are **structured objects**, not shorthand
 
 ## Coupling to `@apollion-dsi/core`
 
-Hard rule per ADR-006 §3.1:
+Hard rule:
 
 - `core` declares `@apollion-dsi/tokens` in `optionalDependencies` (NOT `dependencies`).
 - Consumer that does not opt into `apollion.config.mjs#output.runtime: true` never installs tokens.
-- Lockstep version enforced via `.changeset/config.json#fixed` array from `4.0.0` (PRD-002 §S7).
+- Lockstep version enforced via the `.changeset/config.json#fixed` array from `4.0.0`.
 
-## Slicing (ADR-006 §6)
+## Documentation
 
-| Slice                                | Status     | Deliverable                                       |
-| ------------------------------------ | ---------- | ------------------------------------------------- |
-| S1 — scaffold + versioned API        | ✅ shipped | `runtime/v1` namespace, esbuild ESM/CJS dual emit |
-| S2 — culori vendor + OKLch lerp      | ✅ shipped | `vendors/Culori` in core; OKLch palette           |
-| S3 — Dimension axis                  | ✅ shipped | `compact/normal/spacious` multipliers             |
-| S4 — Foundation/Surface builders     | ✅ shipped | Strangler Fig parity with core                    |
-| S5 — atomic+idempotent build CLI     | ✅ shipped | `apollion-tokens build` + `dist/manifest.json`    |
-| S6 — Config-First + sandboxed loader | ✅ shipped | `apollion.config.mjs` + zod schema                |
-| S7 — release `4.0.0`                 | ✅ shipped | lockstep changesets with core                     |
+Official docs: <https://www.apollion.com.br>
 
-## Refs
+## License
 
-- [ADR-006 — v4 epic](../core/docs/adr/ADR-006-v4-oklch-dimension-token-split.md)
-- [PRD-002 — v4 epic execution](../core/docs/prd/PRD-002-v4-epic-execution.md)
-- [`packages/core/docs/v4-baseline-review.md`](../core/docs/v4-baseline-review.md)
+MIT.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@apollion-dsi/tokens",
-  "version": "4.9.1",
+  "version": "4.10.0",
   "description": "Apollion Design System — Framework-agnostic design tokens",
-  "homepage": "https://github.com/apollion-ds/apollion",
+  "homepage": "https://www.apollion.com.br",
   "license": "MIT",
   "type": "module",
   "main": "lib/runtime/v1.cjs",
@@ -44,11 +44,6 @@
     "lib",
     "src"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/fedbalves/apollion-ds.git",
-    "directory": "packages/tokens"
-  },
   "scripts": {
     "build": "node ./esbuild.cjs && tsc --emitDeclarationOnly",
     "check-types": "tsc --noEmit",
@@ -70,7 +65,7 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@apollion-dsi/core": "4.9.1",
+    "@apollion-dsi/core": "workspace:*",
     "@apollion-dsi/eslint-config": "0.8.0",
     "@types/culori": "4.0.1",
     "@types/jest": "30.0.0",
@@ -82,4 +77,4 @@
     "ts-jest": "^29.4.11",
     "typescript": "6.0.3"
   }
-}
+}

package/CHANGELOG.md

@@ -1,162 +0,0 @@
-# @apollion-dsi/tokens
-
-## 4.9.1
-
-## 4.9.0
-
-## 4.8.0
-
-## 4.7.0
-
-## 4.6.3
-
-## 4.6.2
-
-## 4.6.1
-
-## 4.6.0
-
-## 4.5.1
-
-## 4.5.0
-
-### Minor Changes
-
-- 1ebb3e3: Typography joins the `dimension` density axis — fixed root + `rem` scale (ADR-011)
-  - **Fixed root:** `GlobalStyle` emits `html { font-size: 100% }` (16px) instead of
-    the fluid `clamp(16px, 1vw + 12px, 28px)`. Product UI keeps stable reading
-    density on ultrawide/4K — large screens gain columns/space, not inflated text.
-  - **`createFont(input, dimension)`** mirrors `createSpacing`: the same
-    `<ApollionProvider dimension>` knob (multipliers `0.20 / 0.25 / 0.32`) now
-    drives type size, so spacing and typography scale together. `normal` is 1:1
-    with the previous px scale (`small` 16px → `1rem`).
-  - **Breaking (type):** `theme.font.fontSize.*` changed `number` → `string` (CSS
-    `rem`). Additive `theme.font.fontSizePx.*` carries the effective px for layout
-    math (e.g. `height = fontSizePx.small * ratio`). Style code that concatenated a
-    manual `px` suffix (`` `${theme.font.fontSize.small}px` ``) must drop it.
-  - **Tokens:** font left the axis-invariant `base` set — it is now emitted per
-    dimension as `font.<dimension>` sets (symmetric with `spacing.<dimension>`),
-    with `font.size.*` carrying the resolved `rem` value for that density.
-
-## 4.4.0
-
-### Patch Changes
-
-- 9e32c3b: fix(build): emit `.d.ts` by inlining `tsc --emitDeclarationOnly` into `build`.
-
-  Yarn Berry does not run `pre`/`post` lifecycle hooks, so the former `postbuild`
-  step never executed and the package shipped without type declarations. Folded it
-  into `build` so the published `@apollion-dsi/tokens` includes its types.
-
-## 4.3.1
-
-## 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