@apollion-dsi/tokens 5.1.0 → 5.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apollion-dsi/tokens",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "Apollion Design System — Framework-agnostic design tokens",
   "homepage": "https://www.apollion.com.br",
   "license": "MIT",
@@ -65,7 +65,7 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@apollion-dsi/core": "5.1.0",
+    "@apollion-dsi/core": "workspace:*",
     "@apollion-dsi/eslint-config": "0.9.0",
     "@types/culori": "4.0.1",
     "@types/jest": "30.0.0",
@@ -77,4 +77,4 @@
     "ts-jest": "^29.4.11",
     "typescript": "6.0.3"
   }
-}
+}

package/CHANGELOG.md

@@ -1,248 +0,0 @@
-# @apollion-dsi/tokens
-
-## 5.1.0
-
-## 5.0.0
-
-## 4.12.1
-
-## 4.12.0
-
-### Minor Changes
-
-- a15d280: feat(themes): estados de interação mode-aware com piso perceptual nativo (`action`/`active`) — ADR-012
-
-  `mountSingleColor` agora garante que hover (`action`) e pressed (`active`)
-  sejam shifts **perceptíveis** contra o `base`, em qualquer tema: predicado
-  duplo (razão de luminância WCAG ≥ 1.3x **ou** ΔL OKLch ≥ 0.05 — o JND onde a
-  razão satura perto do preto). Temas já compliant saem **byte-idênticos** à
-  derivação anterior (zero churn de baseline visual no light default e no dark
-  invertido das docs); só temas que violam o piso ganham correção — o estado é
-  re-derivado movendo apenas o L OKLch do `base` (hue/croma preservados), na
-  direção do mode da superfície (inferido da luminância de `baseLight`:
-  superfície escura clareia, clara escurece), com snap preto/branco como
-  fallback do engine.
-
-  Origem: feedback brasil_2030 — o `squadDarkTheme` ancora `deepDark`/`deepLight`
-  em cinzas (legibilidade de card) e o hover do único CTA colapsava a 1.02x
-  (`#2062CE` → `#2b64b9`, morto). Com o piso: `action #397be9` a **1.401x** +
-  texto AA (5.18) via `getContrastColor`. `deep*` volta a ter função única
-  (âncora das rampas neutral/greyscale — intocadas).
-
-  Escape hatch por slot: `ColorsInput` aceita, além do seed string, uma paleta
-  parcial explícita (`{ base, action?, active?, dark?, light? }` —
-  `ColorPalleteOverrideInterface`); steps fornecidos passam verbatim, ausentes
-  seguem o engine. Tokens espelha a lógica byte-a-byte (contrato Strangler Fig;
-  suíte de parity estendida com o dark cinza-ancorado e o escape hatch).
-
-## 4.11.0
-
-### Minor Changes
-
-- bd17e17: feat(themes,tokens): camada nativa de texto legível por tema (plano contraste G2)
-
-  **Core:** novo `createReadableTextLayer(colors, { surface?, minRatio? })` em
-  `@apollion-dsi/core/themes/colors` — deriva, via `readableColor`, um ink AA
-  por paleta nomeada (`main`…`information`, a partir do `base`) e por índice de
-  texto da rampa neutra (`NEUTRAL_TEXT_INDICES`, ≥ 120), contra a superfície do
-  tema (default `colors.neutral['10']`). Chame 1× por tema (light/dark) e emita
-  onde precisar — substitui a reimplementação local do consumidor brasil_2030
-  (`themeCssVars.ts` + helpers `txt()`/`ink()`, gap A1).
-
-  **Tokens:** cada variante agora emite o grupo `tx.*`
-  (`--apollion-tx-primary`, `--apollion-tx-neutral-140`, …) no CSS/TS/JSON,
-  derivado pela mesma função do core. Quando o eixo `mode` ficar real (ADR-006
-  E6/S6), os arquivos `.dark.*` passam a carregar inks escuros sem mudança de
-  topologia. Matriz de aceite WCAG ≥ 4.5 coberta por testes nos dois pacotes.
-
-## 4.10.0
-
-### Patch Changes
-
-- 36c582b: feat(link,text): prose-link underline engine; quiet-link hover; honor `contrast`
-  - `Text` now underlines any descendant `<a>` inside running text, so an inline
-    link stays distinguishable by more than color (WCAG 1.4.1) regardless of the
-    Link's own `textDecoration`. The container owns the rule — only it knows the
-    content is prose. `Link.Button` opts out via `data-ds-link-button`.
-  - `Link.Button` resets `text-decoration` (its native `<a>` base inherited the UA
-    `underline`, unlike `Button`'s `<button>`). The `linked` variant still
-    underlines on `:hover`/`:focus`.
-  - `:hover` / `:focus-visible` restore `text-decoration: underline` when the
-    consumer sets `textDecoration="none"` (chrome/nav quiet links) — a11y without
-    looking like a button. Scoped to the quiet mode so the default emits no
-    redundant rule.
-  - Skip `readableColor(…, baseLight)` remapping when `contrast` is set: the ink
-    is already the on-color of the declared surface. Remapping broke links on
-    `main` bands (header/footer) that correctly used `contrast="main"`.
-
-- 93e718c: docs(readme): fix npm-facing links on published packages
-  - Official-docs link now points to https://www.apollion.com.br (was a broken
-    relative/Nextra link, and a GitHub `homepage` on a private repo).
-  - Removed links to internal ADR/PRD/design docs that only exist in the private
-    GitHub repo, plus broken relative source links (`docs/CONCEPTS.md`,
-    `src/...`, migration guide).
-  - `core`/`tokens` `homepage` → the docs site; dropped the private `repository`
-    field so npm no longer shows a 404 link.
-  - Fixed the stale hardcoded version in the `tokens` README (added the npm badge
-    instead) and pruned internal slice/tracking sections not meant for consumers.
-
-## 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