@takazudo/zdtp 0.4.1 → 0.4.3

package/dist/state/tweak-state.d.ts

@@ -128,7 +128,10 @@ export declare const DEFAULT_SIZE: PanelSize;
 /**
  * Compute the first-open panel size in px. Mirrors the historical CSS
  * `min(1200, 0.8 * vw)` × `min(800, 0.8 * vh)` rule so existing users
- * experience the same default size after this PR ships.
+ * experience the same default size, then clamps through `clampSize` so the
+ * result respects the MIN_PANEL_* floor and the viewport cap. The floor only
+ * bites on phone-width viewports (e.g. 375px → 0.8*375 = 300, raised to the
+ * 320 min); on normal viewports the clamp is a no-op.
  */
 export declare function defaultSize(): PanelSize;
 /**
@@ -192,9 +195,13 @@ export type TokenOverrides = Record<string, string>;
  * Unified persist envelope. Each tab owns its own sub-state so they can
  * evolve independently.
  *
- * `panelPosition` is persisted alongside the envelope so the user's drag
- * location survives reloads. `secondary` carries a second (optional) color
- * cluster — absent until a host opts in.
+ * Panel position and size are stored in SEPARATE localStorage keys
+ * (`-position` / `-size`) and are NOT part of this envelope. The panel reads
+ * them via `loadPosition` / `loadSize` on mount; drags / resizes write them
+ * directly via `savePosition` / `saveSize`.
+ *
+ * `secondary` carries a second (optional) color cluster — absent until a host
+ * opts in.
  *
  * `tabs` is the v3 extension: a tab-keyed map of `TabOverrides` for host-coined
  * generic tabs that use the tier model. The existing `color`/`spacing`/
@@ -206,7 +213,6 @@ export interface TweakState {
     spacing: TokenOverrides;
     typography: TokenOverrides;
     size: TokenOverrides;
-    panelPosition?: PanelPosition;
     secondary?: ColorTweakState;
     /** Generic tab overrides keyed by tab id. Added in v3 envelope. */
     tabs?: Record<string, TabOverrides>;
@@ -263,6 +269,20 @@ export declare function setCssVar(name: string, value: string): void;
  * Resolve a `ColorRef` to a palette index. If it's already a number, use it.
  * If it's a string, find an exact palette match or the nearest color by RGB
  * distance. `fallback` is returned only when `ref` is undefined.
+ *
+ * Match order (format-tolerant + alpha-aware):
+ *  (a) exact raw-string match — preserves byte-for-byte `oklch()`/hex refs
+ *      without any lossy normalization (palette refs are usually canonical);
+ *  (b) OKLCH-aware match — when the ref AND a palette entry both parse as CSS
+ *      Color 4 `oklch()`, compare canonical `cssToOklcha` forms with a
+ *      per-channel epsilon (alpha included). This keeps a wide-gamut oklch ref
+ *      from collapsing to '#000000' under the hex path (jsdom / engines whose
+ *      canvas can't parse oklch) and keeps a same-L/C/H-different-alpha ref
+ *      bound to the correct slot;
+ *  (c) hex fallback — normalize ref + palette to canonical hex for an exact
+ *      match, else nearest color by base-RGB distance. This is the path for
+ *      genuine hex/rgb refs; the nearest-distance step intentionally drops
+ *      alpha, so the exact matches above must run first when alpha matters.
  */
 export declare function colorRefToIndex(ref: ColorRef | undefined, palette: string[], fallback: number): number;
 /**
@@ -287,8 +307,29 @@ export declare function getActiveSchemeName(cluster?: ColorClusterDataConfig, cf
  * no schemes should not call this directly — they use
  * `initSecondaryDefaults(cluster)` instead because there is no scheme to
  * seed from.
+ *
+ * @param cfg - The panel instance config. When provided and the config has
+ *   `applySink`, the host's `data-theme` attribute is ignored and the scheme
+ *   seed comes from `cluster.panelSettings.colorScheme` instead (sink-instance
+ *   guard). Omitting it silently falls through to reading `data-theme`, which
+ *   is the correct behavior for non-sink instances but wrong for sinks.
+ */
+export declare function initColorFromScheme(cluster?: ColorClusterDataConfig, cfg?: PanelConfig): ColorTweakState;
+/**
+ * Palette entry sanitiser. Raw `oklch(...)` values are preserved verbatim so
+ * wide-gamut chroma survives (and they never touch the canvas → no '#000000'
+ * under jsdom / engines whose 2D canvas can't parse oklch). Every NON-oklch entry
+ * goes through cssColorToHex() — the exact pre-OKLCH behaviour — which
+ * canonicalises valid hex/rgb and, crucially, turns an unparseable string into a
+ * safe '#000000' rather than leaking it into a CSS custom property. Without this,
+ * a bundled scheme's stray non-color entry (e.g. `Default Dark`'s slot-9 `"18"`,
+ * referenced by `background: 9`) would reach the apply path verbatim.
+ *
+ * Exported so the serde import path (design-token-serde.ts) can apply the same
+ * sanitiser to imported palette values — commit 8d54e07 hardened seeding; this
+ * export closes the equivalent gap in the JSON-import path.
  */
-export declare function initColorFromScheme(cluster?: ColorClusterDataConfig): ColorTweakState;
+export declare function normalizeSchemePaletteEntry(value: string): string;
 export declare function initColorFromSchemeData(scheme: ColorScheme, cluster?: ColorClusterDataConfig): ColorTweakState;
 /** Resolve a semantic mapping to an actual color (bounds-checked). */
 export declare function resolveMapping(mapping: number | 'bg' | 'fg', palette: string[], bgIndex: number, fgIndex: number): string;
@@ -423,4 +464,3 @@ export declare function savePersistedState(state: TweakState, storage?: StorageL
  * preserving the single-panel path.
  */
 export declare function clearPersistedState(storage?: StorageLike, cfg?: PanelConfig): void;
-//# sourceMappingURL=tweak-state.d.ts.map

package/dist/styles/z-index-tokens.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Semantic z-index scale for the design-token panel.
+ *
+ * Single source of truth shared with panel-tokens.css:
+ *   - CSS reads `var(--tokentweak-z-*)` (declared in panel-tokens.css)
+ *   - TSX reads the numeric exports here for inline `zIndex` styles
+ *
+ * Values in the INT32 high band so the panel sits above common host chrome
+ * (sticky headers, drawers typically use z-index 100–10000). Ceiling bounded
+ * by INT32_MAX = 2147483647; inspector-box and toast claim the two highest
+ * practical values so element-path affordances are never obscured.
+ *
+ * Tier order: overlay < shell < settingsPopover < colorPicker < tooltip
+ *             < inspectorBox < toast
+ */
+export declare const Z: {
+    /** Highlight rings — rendered just below the panel shell. */
+    readonly overlay: 2147482990;
+    /** Panel shell (position:fixed root-level). */
+    readonly shell: 2147482991;
+    /** Highlight-settings popover — body-sibling of the shell, competes at root. */
+    readonly settingsPopover: 2147482992;
+    /**
+     * Color-picker card (position:fixed) — DOM child of .tokenpanel-shell,
+     * which is a stacking context. This value is shell-local; against host
+     * content the picker paints at the shell's root-level z-index.
+     */
+    readonly colorPicker: 2147482993;
+    /** DOM tooltip portaled to document.body. */
+    readonly tooltip: 2147482994;
+    /** Element-path inspector box (body-mounted). */
+    readonly inspectorBox: 2147483000;
+    /** Element-path toast (body-mounted). */
+    readonly toast: 2147483001;
+};

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

@@ -21,4 +21,3 @@ export interface GenericItemEditorProps {
 declare function GenericItemEditorInner({ item, value, onChange }: GenericItemEditorProps): import("preact").JSX.Element | null;
 declare const _default: typeof GenericItemEditorInner;
 export default _default;
-//# sourceMappingURL=_generic-item-editor.d.ts.map

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

@@ -11,10 +11,13 @@
  *
  * 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.
+ * palette index (p0–p15) or one of the `bg`/`fg` extras. The Palette
+ * swatches themselves are the only inputs that edit a color directly — a
+ * hex by default, or an `oklch(...)` string when the palette tier declares
+ * `type.format: 'oklch'` — via the color-picker popover. No raw-color
+ * inputs (rgb / hex text field / lab) are exposed for Base or Semantic rows;
+ * those rows reference palette slots, so they inherit OKLCH transitively the
+ * moment the palette holds `oklch()` values.
  *
  * Shiki integration is out of scope — the `shikiTheme` field stays on
  * state + persist + serde for envelope round-tripping with upstream
@@ -52,4 +55,3 @@ interface ColorTabProps {
 }
 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/font-tab.d.ts

@@ -19,4 +19,3 @@ interface FontTabProps {
  */
 export default function FontTab({ tab, state, persistFont }: FontTabProps): import("preact").JSX.Element;
 export {};
-//# sourceMappingURL=font-tab.d.ts.map

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

@@ -9,7 +9,7 @@
  *   length / number → number input with unit suffix (numeric range)
  *   select          → native <select>
  *   text            → free-form text input
- *   color           → native <input type="color"> by default; with format:'oklch' → OKLCH picker emitting oklch()
+ *   color           → native <input type="color"> by default (emits hex); with format:'oklch' → OKLCH picker emitting an oklch() string. Color values therefore persist as hex OR oklch(), not hex-only.
  *
  * For items in a tier with `referencesTier`, TierRefSelector is rendered
  * instead, so the user can either pick a tier-1 item id (emitted as
@@ -40,4 +40,3 @@ export interface GenericTabProps {
  * 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/palette/palette-check-view.d.ts

@@ -19,4 +19,3 @@ export interface PaletteCheckViewProps {
     onChange: (tierId: string, itemId: string, next: string) => void;
 }
 export default function PaletteCheckView({ tab, overrides }: PaletteCheckViewProps): import("preact").JSX.Element;
-//# sourceMappingURL=palette-check-view.d.ts.map

package/dist/tabs/palette/palette-edit-view.d.ts

@@ -53,4 +53,3 @@ export interface PaletteEditViewProps {
     onCommitBatch?: (tierId: string, patch: Record<string, string>) => void;
 }
 export default function PaletteEditView({ tab, overrides, onChange, onCommitBatch }: PaletteEditViewProps): import("preact").JSX.Element;
-//# sourceMappingURL=palette-edit-view.d.ts.map

package/dist/tabs/palette/palette-readout.d.ts

@@ -20,4 +20,3 @@ export interface PaletteReadoutProps {
     outOfGamut: boolean;
 }
 export default function PaletteReadout({ oklcha, cssVar, outOfGamut }: PaletteReadoutProps): import("preact").JSX.Element;
-//# sourceMappingURL=palette-readout.d.ts.map

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

@@ -34,4 +34,3 @@ export interface PaletteTabProps {
     onCommitBatch?: (tierId: string, patch: Record<string, string>) => void;
 }
 export default function PaletteTab({ tab, overrides, onChange, onCommitBatch }: PaletteTabProps): import("preact").JSX.Element;
-//# sourceMappingURL=palette-tab.d.ts.map

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

@@ -17,4 +17,3 @@ interface SizeTabProps {
  */
 export default function SizeTab({ tab, state, persistSize }: SizeTabProps): import("preact").JSX.Element;
 export {};
-//# sourceMappingURL=size-tab.d.ts.map

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

@@ -20,4 +20,3 @@ interface SpacingTabProps {
  */
 export default function SpacingTab({ tab, state, persistSpacing }: SpacingTabProps): import("preact").JSX.Element;
 export {};
-//# sourceMappingURL=spacing-tab.d.ts.map

package/dist/testing.d.ts

@@ -78,4 +78,3 @@ export interface PlaywrightLocatorLike {
  *   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.js

@@ -1,5 +1,5 @@
-import { _ as r, c as i, f as _, h as n, i as g, b as R, a as p } from "./panel-config-066BPYJD.js";
-import { g as l, a as y, l as O } from "./tweak-state-Do5gj6Nw.js";
+import { _ as r, c as i, f as _, h as n, i as g, b as R, a as p } from "./panel-config-3tBEHjvZ.js";
+import { a as l, b as y, l as O } from "./tweak-state-BEx1SHu7.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");

package/dist/tokens/manifest.d.ts

@@ -141,4 +141,3 @@ export declare const SIZE_GROUP_ORDER: readonly TokenGroup[];
 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/tier-model.d.ts

@@ -89,4 +89,3 @@ export interface TabConfig {
     tiers: readonly TierConfig[];
     colorExtras?: ColorClusterExtras;
 }
-//# sourceMappingURL=tier-model.d.ts.map