@takazudo/zdtp 0.1.0-next.0

package/dist/tabs/_generic-item-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_generic-item-editor.d.ts","sourceRoot":"","sources":["../../src/tabs/_generic-item-editor.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,sBAAsB,CAAC;AAGpE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,iBAAS,sBAAsB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,sBAAsB,uCA4LhF;;AAED,wBAA4C"}

package/dist/tabs/color-tab.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Color tab — verbatim port of zudo-doc's
+ * `src/components/design-token-tweak/tabs/color-tab.tsx`, rewired to the
+ * design-token-panel module paths:
+ *
+ *   @/config/color-schemes       → ../config/color-schemes
+ *   @/config/color-scheme-utils  → ../config/color-scheme-utils
+ *   @/utils/color-convert        → ../utils/color-convert
+ *   ../state/tweak-state         → ../state/tweak-state (unchanged)
+ *   ../state/persist             → ../state/persist    (unchanged)
+ *
+ * Acceptance criterion (rejection-fix): every Base / Semantic Tokens row is
+ * a `PaletteSelector` — the only way to edit those values is to pick a
+ * palette index (p0–p15) or one of the `bg`/`fg` extras. The 16 Palette
+ * swatches themselves are the only inputs that edit a hex via the HSL
+ * popover. No raw-color inputs (rgb / hex text field / lab) are
+ * exposed for Base or Semantic rows.
+ *
+ * Shiki integration is out of scope — the `shikiTheme` field stays on
+ * state + persist + serde for envelope round-tripping with upstream
+ * exports, and `applyShikiTheme` is a no-op stub. We hide the
+ * shikiTheme `<select>` JSX block here but leave every state/apply touch
+ * point intact. `SHIKI_THEMES` is therefore no longer imported in this file
+ * (would trip `noUnusedLocals`); re-add it if/when the JSX block lands.
+ *
+ * The optional secondary cluster ships alongside the primary cluster. The
+ * two clusters share the same `ColorSwatch` + `PaletteSelector` primitives —
+ * the secondary cluster renders its palette and semantic dropdowns below
+ * the primary sections. Whether it ships a Base subsection depends on the
+ * cluster's declared base roles. Section headings are prefixed
+ * `Primary — ` / `Secondary — ` so the two clusters are visually distinct
+ * in the panel.
+ */
+import { type ColorTweakState } from '../state/tweak-state';
+import type { TabConfig } from '../tokens/tier-model';
+import type { PersistColor, PersistSecondary } from '../state/persist';
+interface ColorTabProps {
+    /**
+     * The color tab's TabConfig. Provides palette + semantic tiers and
+     * colorExtras (schemes, base roles, panel settings).
+     */
+    tab: TabConfig;
+    state: ColorTweakState;
+    persistColor: PersistColor;
+    /**
+     * Secondary cluster tab, or `null` when the host has no secondary color tab.
+     * When non-null, its state + persist callbacks render the secondary sections.
+     */
+    secondaryTab: TabConfig | null;
+    secondaryState: ColorTweakState | null;
+    persistSecondary: PersistSecondary;
+}
+export default function ColorTab({ tab, state, persistColor, secondaryTab, secondaryState, persistSecondary, }: ColorTabProps): import("preact").JSX.Element;
+export {};
+//# sourceMappingURL=color-tab.d.ts.map

package/dist/tabs/color-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-tab.d.ts","sourceRoot":"","sources":["../../src/tabs/color-tab.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAqVvE,UAAU,aAAa;IACrB;;;OAGG;IACH,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B;;;OAGG;IACH,YAAY,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,eAAe,GAAG,IAAI,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,EAC/B,GAAG,EACH,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,gBAAgB,GACjB,EAAE,aAAa,gCAsVf"}

package/dist/tabs/font-tab.d.ts

@@ -0,0 +1,22 @@
+import type { TabConfig } from '../tokens/tier-model';
+import type { TokenOverrides } from '../state/tweak-state';
+import type { PersistFont } from '../state/persist';
+interface FontTabProps {
+    tab: TabConfig;
+    state: TokenOverrides;
+    persistFont: PersistFont;
+}
+/**
+ * Font tab — TabConfig.tiers driven.
+ *
+ * Renders all tiers flat in declaration order. Each tier has one heading
+ * (div role=heading aria-level=3). No progressive disclosure (details/summary).
+ * When a tier has `referencesTier`, its items render `TierRefSelector`.
+ *
+ * The persist path: `state.typography` is a flat `TokenOverrides` map keyed
+ * by item id. Reference values store the target item id; apply emits
+ * `var(--targetCssVar)`.
+ */
+export default function FontTab({ tab, state, persistFont }: FontTabProps): import("preact").JSX.Element;
+export {};
+//# sourceMappingURL=font-tab.d.ts.map

package/dist/tabs/font-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"font-tab.d.ts","sourceRoot":"","sources":["../../src/tabs/font-tab.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,UAAU,YAAY;IACpB,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,YAAY,gCAmDxE"}

package/dist/tabs/generic-tab.d.ts

@@ -0,0 +1,43 @@
+/**
+ * GenericTab — renders any TabConfig whose id is not one of the reserved ids
+ * (color / font / spacing / size). Reserved ids continue to dispatch to their
+ * dedicated tab components until Wave 5 migrates them.
+ *
+ * Renders the tab's tiers in declaration order. Each tier shows a heading and
+ * its items via kind-appropriate controls:
+ *
+ *   length / number → number input with unit suffix (numeric range)
+ *   select          → native <select>
+ *   text            → free-form text input
+ *   color           → <input type="color"> (native OS color picker)
+ *
+ * For items in a tier with `referencesTier`, TierRefSelector is rendered
+ * instead, so the user can either pick a tier-1 item id (emitted as
+ * `var(--target-cssvar)` at apply time) or flip the item back to literal mode.
+ */
+import type { TabConfig } from '../tokens/tier-model';
+import type { TabOverrides } from '../apply/tier-resolver';
+export interface GenericTabProps {
+    /** The tab configuration to render. Must NOT be a reserved id. */
+    tab: TabConfig;
+    /**
+     * Current per-tier, per-item overrides for this tab.
+     *
+     * Shape: { [tierId]: { [itemId]: overrideValue } }
+     *
+     * When an item has no override, its `TierItem.default` is used.
+     */
+    overrides: TabOverrides;
+    /** Called when the user commits a change to any item. */
+    onChange: (tierId: string, itemId: string, next: string) => void;
+}
+/**
+ * Renders a non-reserved tab (any TabConfig whose id is not color/font/
+ * spacing/size). Dispatches each tier to TierSection, which in turn renders
+ * item editors by value kind.
+ *
+ * Reserved-id tabs (color/font/spacing/size) are handled by their dedicated
+ * components until Wave 5 migrates them to consume TabConfig.tiers.
+ */
+export default function GenericTab({ tab, overrides, onChange }: GenericTabProps): import("preact").JSX.Element;
+//# sourceMappingURL=generic-tab.d.ts.map

package/dist/tabs/generic-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-tab.d.ts","sourceRoot":"","sources":["../../src/tabs/generic-tab.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAuC,MAAM,sBAAsB,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA+O3D,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,GAAG,EAAE,SAAS,CAAC;IACf;;;;;;OAMG;IACH,SAAS,EAAE,YAAY,CAAC;IACxB,yDAAyD;IACzD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAMD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,eAAe,gCAwB/E"}

package/dist/tabs/size-tab.d.ts

@@ -0,0 +1,20 @@
+import type { TabConfig } from '../tokens/tier-model';
+import type { TokenOverrides } from '../state/tweak-state';
+import type { PersistSize } from '../state/persist';
+interface SizeTabProps {
+    tab: TabConfig;
+    state: TokenOverrides;
+    persistSize: PersistSize;
+}
+/**
+ * Size tab — TabConfig.tiers driven.
+ *
+ * Renders all tiers flat in declaration order. Each tier has one heading
+ * (div role=heading aria-level=3). No progressive disclosure (details/summary).
+ * When a tier has `referencesTier`, items render TierRefSelector.
+ * Pill toggle is preserved: `item.pill` drives a checkbox + disabled slider
+ * exactly as the legacy PillSliderRow did.
+ */
+export default function SizeTab({ tab, state, persistSize }: SizeTabProps): import("preact").JSX.Element;
+export {};
+//# sourceMappingURL=size-tab.d.ts.map

package/dist/tabs/size-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-tab.d.ts","sourceRoot":"","sources":["../../src/tabs/size-tab.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,UAAU,YAAY;IACpB,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,YAAY,gCAmDxE"}

package/dist/tabs/spacing-tab.d.ts

@@ -0,0 +1,23 @@
+import type { TabConfig } from '../tokens/tier-model';
+import type { TokenOverrides } from '../state/tweak-state';
+import type { PersistSpacing } from '../state/persist';
+interface SpacingTabProps {
+    tab: TabConfig;
+    state: TokenOverrides;
+    persistSpacing: PersistSpacing;
+}
+/**
+ * Spacing tab — TabConfig.tiers driven.
+ *
+ * Renders all tiers flat in declaration order. Each tier has one heading
+ * (div role=heading aria-level=3). No progressive disclosure (details/summary).
+ * When a tier has `referencesTier`, its items render `TierRefSelector`
+ * instead of the kind-specific control.
+ *
+ * The persist path remains the same: `state.spacing` is a flat `TokenOverrides`
+ * map keyed by item id. Reference values are stored as the target item id; the
+ * apply pipeline emits `var(--targetCssVar)`.
+ */
+export default function SpacingTab({ tab, state, persistSpacing }: SpacingTabProps): import("preact").JSX.Element;
+export {};
+//# sourceMappingURL=spacing-tab.d.ts.map

package/dist/tabs/spacing-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing-tab.d.ts","sourceRoot":"","sources":["../../src/tabs/spacing-tab.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMvD,UAAU,eAAe;IACvB,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,cAAc,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,eAAe,gCAqDjF"}

package/dist/testing.d.ts

@@ -0,0 +1,81 @@
+/**
+ * /testing sub-export — test-utility symbols for storage-key continuity tests
+ * and Playwright panel-interaction helpers.
+ *
+ * Re-exports symbols that consumers need to write storage-key continuity and
+ * manifest-ordering tests without reaching into the package's internal source
+ * paths. Also exports `setPanelInputValue` for Playwright-based e2e tests that
+ * need to drive the panel's numeric text inputs reliably.
+ *
+ * Intended for use in test files only — not for production code.
+ *
+ * Consumer usage:
+ *   import { configurePanel, storageKey_open, ... } from '@takazudo/zdtp/testing';
+ *   import { setPanelInputValue } from '@takazudo/zdtp/testing';
+ */
+export { configurePanel, storageKey_open, storageKey_position, storageKey_stateV1, storageKey_stateV2, storageKey_visible, __resetPanelConfigForTests, } from './config/panel-config';
+export type { PanelConfig } from './config/panel-config';
+export { getStorageKeyV1, getStorageKeyV2, loadPersistedState } from './state/tweak-state';
+export type { ColorTweakState, StorageLike } from './state/tweak-state';
+export { GROUP_ORDER, FONT_GROUP_ORDER, SIZE_GROUP_ORDER, GROUP_TITLES } from './tokens/manifest';
+/**
+ * Minimal duck-type for a Playwright `Locator` — only the methods this helper calls.
+ * Using an interface avoids a hard import of `@playwright/test` so the `./testing`
+ * sub-export does not add Playwright as a required dependency for non-Playwright consumers.
+ */
+export interface PlaywrightLocatorLike {
+    fill(value: string): Promise<void>;
+    dispatchEvent(type: string): Promise<void>;
+}
+/**
+ * Set a value on a panel numeric text input (`type="text"`) and trigger the
+ * commit in Preact's event pipeline.
+ *
+ * ## Why this helper exists
+ *
+ * The panel's spacing/font/size tabs render their numeric editor via
+ * `_generic-item-editor.tsx`, which attaches a Preact `onChange` handler to the
+ * text input. Preact-compat re-maps `onChange` to the **native `input` event**
+ * (not `change`) for `<input type="text">`.
+ *
+ * `locator.fill(value)` dispatches a native `input` event, so it **does** fire
+ * Preact's `onChange` handler — including in headless Chromium. You do NOT need
+ * `dispatchEvent('change')` or the native-setter trick for text inputs.
+ *
+ * This helper calls `fill()` and then dispatches an additional `input` event as
+ * a defensive measure in case the Playwright version or the Chromium headless
+ * build does not synthesize an `input` event with the expected `isTrusted=false`
+ * flag that older Preact builds relied on. In practice both steps work; the
+ * double-dispatch is harmless.
+ *
+ * ## Range sliders (`type="range"`)
+ *
+ * Playwright's `fill()` does NOT reliably drive `type="range"` inputs in headless
+ * Chromium, because range inputs require mouse drag events to change value. To
+ * test the CSS cascade effect of a slider change without interacting with the
+ * slider widget, use `page.evaluate`:
+ *
+ * ```ts
+ * await page.evaluate((cssVar, value) => {
+ *   document.documentElement.style.setProperty(cssVar, value);
+ * }, '--my-token', '1.5rem');
+ * ```
+ *
+ * ## Correct usage (text input)
+ *
+ * ```ts
+ * import { setPanelInputValue } from '@takazudo/zdtp/testing';
+ *
+ * const input = page.getByLabel('--my-token value');
+ * await setPanelInputValue(input, '1.5');
+ * // → commits '1.5rem' (or '1.5px' etc. depending on token unit) to the parent onChange
+ * ```
+ *
+ * @param locator - A Playwright `Locator` pointing at the panel's `type="text"` number input.
+ *   Identify it by `page.getByLabel('--my-css-var value')` (the panel renders
+ *   `aria-label="{cssVar} value"` on each numeric text input).
+ * @param value - The numeric string to type (e.g. `'1.5'`, `'40'`). Do NOT
+ *   include the unit suffix — the panel appends the configured unit itself.
+ */
+export declare function setPanelInputValue(locator: PlaywrightLocatorLike, value: string): Promise<void>;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKxE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMlG;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/testing.js

@@ -0,0 +1,23 @@
+import { _ as r, c as i, f as _, h as n, i as g, b as R, a as p } from "./panel-config-DP2_P7dD.js";
+import { g as l, a as y, l as O } from "./tweak-state-DSJa5csL.js";
+import { F as K, G as E, a as S, S as u } from "./manifest-DCReQE0k.js";
+async function s(a, e) {
+  await a.fill(e), await a.dispatchEvent("input");
+}
+export {
+  K as FONT_GROUP_ORDER,
+  E as GROUP_ORDER,
+  S as GROUP_TITLES,
+  u as SIZE_GROUP_ORDER,
+  r as __resetPanelConfigForTests,
+  i as configurePanel,
+  l as getStorageKeyV1,
+  y as getStorageKeyV2,
+  O as loadPersistedState,
+  s as setPanelInputValue,
+  _ as storageKey_open,
+  n as storageKey_position,
+  g as storageKey_stateV1,
+  R as storageKey_stateV2,
+  p as storageKey_visible
+};

package/dist/tokens/manifest.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Token manifest — type definitions, helpers, and group ordering.
+ *
+ * This module ships ZERO baked-in manifest data. The four token arrays that
+ * used to live here (`SPACING_TOKENS`, `FONT_TOKENS`, `SIZE_TOKENS`,
+ * `COLOR_TOKENS`) live in the package-default manifest and are wired into
+ * `panelConfig.tokens` via the default-fallback config in
+ * `../config/panel-config.ts`.
+ *
+ * Consumers supply their own manifest by passing a `TokenManifest` to
+ * `configurePanel({...})` (see PORTABLE-CONTRACT.md §3). The package consumes
+ * whatever the host hands in; tab components, `applyTokenOverrides`, and
+ * `serialize`/`deserialize` all read from `getPanelConfig().tokens` at use
+ * time so a host that calls `configurePanel` before mount sees its own data
+ * everywhere.
+ *
+ * What stays here:
+ *  - Public types: `TokenDef`, `TokenGroup`, `TokenControl`, `TokenManifest`.
+ *  - Helpers: `parseNumericValue`, `formatValue`, `buildTokenIndex`.
+ *  - Group ordering / titles consumed by the spacing / font / size tabs.
+ */
+/**
+ * Manifest-group identifier.
+ *
+ * Open `string` (rather than a closed union of historical group ids) so
+ * consumers can coin their own group ids without forking the package
+ * types. Tab components key section headers off whatever string each
+ * `TokenDef.group` carries; the display order and human title for an
+ * unknown group come from `TokenManifest.spacingGroupOrder` /
+ * `fontGroupOrder` / `sizeGroupOrder` / `groupTitles` (the
+ * consumer-supplied overrides), falling back to the package-bundled
+ * `GROUP_ORDER` / `FONT_GROUP_ORDER` / `SIZE_GROUP_ORDER` / `GROUP_TITLES`
+ * defaults so existing default-shaped manifests keep working unchanged.
+ */
+export type TokenGroup = string;
+/**
+ * Control kind for a token row.
+ *
+ * - `"slider"` — default; numeric range input paired with a number field.
+ * - `"select"` — native `<select>` with `options` (e.g. font-weight 100..900).
+ * - `"text"`   — free-form text input (e.g. font-family CSS string).
+ *
+ * `min`/`max`/`step`/`unit` are only meaningful for the slider control. They
+ * stay on the interface with zero defaults for non-slider rows so the manifest
+ * shape stays uniform.
+ */
+export type TokenControl = 'slider' | 'select' | 'text';
+export interface TokenDef {
+    /** Stable id used as the Record key in persisted state (e.g. `hsp-2xs`). */
+    id: string;
+    /** CSS custom property name written to `:root` (e.g. `--zd-spacing-hgap-2xs`). */
+    cssVar: string;
+    /** Display label shown in the panel row. */
+    label: string;
+    /** Manifest group — tab components use this for section headers. */
+    group: TokenGroup;
+    /** Default value as a CSS length string (e.g. `0.125rem`). */
+    default: string;
+    /** Slider min (numeric, in `unit`). Unused when `readonly`. */
+    min: number;
+    /** Slider max (numeric, in `unit`). Unused when `readonly`. */
+    max: number;
+    /** Slider step (numeric, in `unit`). Unused when `readonly`. */
+    step: number;
+    /** Unit suffix (e.g. `rem`, `px`). Read-only rows may use an empty string. */
+    unit: string;
+    /** Read-only tokens are displayed but not editable (e.g. `clamp()` expressions). */
+    readonly?: true;
+    /** Which control renders this token. Defaults to `"slider"` when absent. */
+    control?: TokenControl;
+    /** Select options — only used when `control === "select"`. */
+    options?: readonly string[];
+    /**
+     * Opt-in "Pill" toggle. When present the control shows a checkbox that flips
+     * between `value` (checked — e.g. `9999px` for full-radius pills) and a
+     * slider-editable custom value (unchecked). Currently used for
+     * `--radius-full`, where a slider alone can't meaningfully drive a 9999px
+     * sentinel.
+     */
+    pill?: {
+        /** CSS string applied when the pill checkbox is ON. */
+        value: string;
+        /** CSS string the slider falls back to when the pill is toggled OFF and
+         *  there is no prior custom value yet. */
+        customDefault: string;
+    };
+}
+/**
+ * Consumer-supplied token manifest (PORTABLE-CONTRACT.md §3.1).
+ *
+ * Each field is the per-tab token list:
+ *  - `spacing` → spacing tab rows
+ *  - `typography` → font tab rows (NOTE: field name is `typography`, not
+ *    `font`. This follows the persist envelope's slice name. The host
+ *    project's source array MAY still use the historical `FONT_TOKENS` name
+ *    — only the field on `TokenManifest` is what the contract pins.)
+ *  - `size` → size tab rows
+ *  - `color` → color-tab per-token rows (this package's default manifest
+ *    ships an empty array because color is driven by the cluster;
+ *    cluster-less hosts populate this).
+ *
+ * Optional ordering / titles fields: consumers may supply their own per-tab
+ * group ordering and section-heading text. When absent, the spacing /
+ * font / size tabs fall back to the package-bundled `GROUP_ORDER` /
+ * `FONT_GROUP_ORDER` / `SIZE_GROUP_ORDER` / `GROUP_TITLES` defaults so
+ * existing default-shaped manifests keep rendering exactly as before.
+ * Consumers that coin their own group ids MUST populate at least the tab
+ * they care about and SHOULD populate `groupTitles` so the section
+ * headers carry human-readable labels.
+ */
+export interface TokenManifest {
+    spacing: readonly TokenDef[];
+    typography: readonly TokenDef[];
+    size: readonly TokenDef[];
+    color: readonly TokenDef[];
+    /** Optional spacing-tab group order. Defaults to `GROUP_ORDER`. */
+    spacingGroupOrder?: readonly string[];
+    /** Optional font-tab primary group order. Defaults to `FONT_GROUP_ORDER`. */
+    fontGroupOrder?: readonly string[];
+    /** Optional size-tab group order. Defaults to `SIZE_GROUP_ORDER`. */
+    sizeGroupOrder?: readonly string[];
+    /** Optional human-readable section titles keyed by group id. Defaults to `GROUP_TITLES`. */
+    groupTitles?: Readonly<Record<string, string>>;
+}
+/** Convenience: build a lookup map keyed by token id. */
+export declare function buildTokenIndex(...groups: readonly (readonly TokenDef[])[]): Record<string, TokenDef>;
+/** Human-readable section titles for grouped rendering. */
+export declare const GROUP_TITLES: Record<TokenGroup, string>;
+/** Stable display order of groups within the Spacing tab. */
+export declare const GROUP_ORDER: readonly TokenGroup[];
+/** Stable display order of primary groups within the Font tab.
+ *  The `font-scale` group is rendered separately under an Advanced disclosure. */
+export declare const FONT_GROUP_ORDER: readonly TokenGroup[];
+/** Stable display order of size-tab groups. */
+export declare const SIZE_GROUP_ORDER: readonly TokenGroup[];
+/**
+ * Parse a CSS length string like `"1.5rem"` into its numeric part.
+ * Returns `null` for anything non-numeric (e.g. `clamp(...)`, `"0"` counts as 0).
+ *
+ * Intentionally permissive: strips any non-numeric suffix after the leading
+ * number, which is exactly what our slider rows need (user-typed `"1.5rem"` →
+ * 1.5, `"12px"` → 12). Falls back to `null` for unparseable input so the caller
+ * can decide the error UX.
+ */
+export declare function parseNumericValue(value: string): number | null;
+/** Format a numeric slider value back into the stored string form. */
+export declare function formatValue(n: number, unit: string): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/tokens/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/tokens/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,QAAQ;IACvB,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,UAAU,CAAC;IAClB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;;;;;;OAMG;IACH,IAAI,CAAC,EAAE;QACL,uDAAuD;QACvD,KAAK,EAAE,MAAM,CAAC;QACd;kDAC0C;QAC1C,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC7B,UAAU,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC1B,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,6EAA6E;IAC7E,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,qEAAqE;IACrE,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,4FAA4F;IAC5F,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAC7B,GAAG,MAAM,EAAE,SAAS,CAAC,SAAS,QAAQ,EAAE,CAAC,EAAE,GAC1C,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAQ1B;AAED,2DAA2D;AAC3D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAYnD,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,EAAE,SAAS,UAAU,EAA8C,CAAC;AAE5F;kFACkF;AAClF,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAKxC,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAAsC,CAAC;AAIzF;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK9D;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3D"}

package/dist/tokens/tier-model.d.ts

@@ -0,0 +1,89 @@
+import type { BaseRoleKey, ClusterPanelSettings } from '../config/cluster-config';
+import type { ColorScheme } from '../config/color-schemes';
+export type TierValueKind = {
+    kind: 'length';
+    min: number;
+    max: number;
+    step: number;
+    unit: string;
+} | {
+    kind: 'number';
+    min: number;
+    max: number;
+    step: number;
+} | {
+    kind: 'select';
+    options: readonly string[];
+} | {
+    kind: 'text';
+} | {
+    kind: 'cursor';
+} | {
+    kind: 'content';
+} | {
+    kind: 'mask-image';
+} | {
+    kind: 'color';
+};
+export declare function isLengthKind(v: TierValueKind): v is Extract<TierValueKind, {
+    kind: 'length';
+}>;
+export declare function isNumberKind(v: TierValueKind): v is Extract<TierValueKind, {
+    kind: 'number';
+}>;
+export declare function isSelectKind(v: TierValueKind): v is Extract<TierValueKind, {
+    kind: 'select';
+}>;
+export declare function isTextKind(v: TierValueKind): v is Extract<TierValueKind, {
+    kind: 'text';
+}>;
+export declare function isCursorKind(v: TierValueKind): v is Extract<TierValueKind, {
+    kind: 'cursor';
+}>;
+export declare function isContentKind(v: TierValueKind): v is Extract<TierValueKind, {
+    kind: 'content';
+}>;
+export declare function isMaskImageKind(v: TierValueKind): v is Extract<TierValueKind, {
+    kind: 'mask-image';
+}>;
+export declare function isColorKind(v: TierValueKind): v is Extract<TierValueKind, {
+    kind: 'color';
+}>;
+export interface PillSpec {
+    value: string;
+    customDefault: string;
+}
+export interface TierItem {
+    id: string;
+    cssVar: string;
+    label: string;
+    default: string;
+    type: TierValueKind;
+    pill?: PillSpec;
+    readonly?: true;
+}
+export interface TierConfig {
+    id: string;
+    label: string;
+    items: readonly TierItem[];
+    /** When set, this tier's items hold references — each value is the id of
+     *  an item in the tier whose id matches referencesTier. The apply pipeline
+     *  emits var(--tier1-cssvar). */
+    referencesTier?: string;
+}
+export interface ColorClusterExtras {
+    id: string;
+    label?: string;
+    baseRoles: Partial<Record<BaseRoleKey, string>>;
+    baseDefaults: Partial<Record<BaseRoleKey, number>>;
+    defaultShikiTheme: string;
+    colorSchemes: Record<string, ColorScheme>;
+    panelSettings: ClusterPanelSettings;
+}
+export interface TabConfig {
+    id: string;
+    label: string;
+    tiers: readonly TierConfig[];
+    colorExtras?: ColorClusterExtras;
+}
+//# sourceMappingURL=tier-model.d.ts.map

package/dist/tokens/tier-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tier-model.d.ts","sourceRoot":"","sources":["../../src/tokens/tier-model.ts"],"names":[],"mappings":"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"}