@takazudo/zdtp 0.4.2 → 0.4.3

package/dist/{load-routing-XyKgftpe.js → load-routing-DtNTKoLW.js}

@@ -146,7 +146,7 @@ function L(e) {
   return e.replace(/\/\*[\s\S]*?\*\//g, (r) => " ".repeat(r.length));
 }
 function U(e, r, t) {
-  const n = r.startsWith("--") ? r.slice(2) : r, o = H(n), s = new RegExp("(--" + o + ":)(\\s*)([\\s\\S]+?);"), a = L(e), l = s.exec(a);
+  const n = r.startsWith("--") ? r.slice(2) : r, o = H(n), s = new RegExp("(?<![\\w-])(--" + o + ":)(\\s*)([\\s\\S]+?);"), a = L(e), l = s.exec(a);
   if (!l) return { content: e, status: "unknown" };
   const [k, c, f] = l, y = l.index, w = y + k.length, v = y + c.length + f.length, p = w - 1, O = e.slice(v, p).trim(), S = t.trim();
   return O === S ? { content: e, status: "unchanged" } : { content: e.slice(0, y) + c + f + t + ";" + e.slice(w), status: "changed" };

package/dist/panel-config-3tBEHjvZ.js

@@ -0,0 +1,493 @@
+function j(e, t) {
+  return e.paletteCssVarTemplate.replace("{n}", String(t));
+}
+function b(e) {
+  const t = e.colorExtras;
+  if (!t) return;
+  const r = e.tiers.find(
+    (a) => !a.referencesTier && a.items.length > 0 && a.items[0].type.kind === "color"
+  );
+  if (!r)
+    return {
+      id: t.id,
+      label: t.label,
+      paletteSize: 0,
+      baseRoles: t.baseRoles,
+      paletteCssVarTemplate: "--zudo-stub-p{n}",
+      semanticDefaults: {},
+      semanticCssNames: {},
+      baseDefaults: t.baseDefaults,
+      defaultShikiTheme: t.defaultShikiTheme,
+      colorSchemes: t.colorSchemes,
+      panelSettings: t.panelSettings
+    };
+  const i = r.items, u = i.length, s = (i[0]?.cssVar ?? "--palette-{n}").replace(/\d+$/, "{n}"), c = /* @__PURE__ */ new Map();
+  for (let a = 0; a < i.length; a++)
+    c.set(i[a].id, a);
+  const f = e.tiers.find(
+    (a) => a.referencesTier === r.id
+  ), n = {}, l = {};
+  if (f)
+    for (const a of f.items) {
+      l[a.id] = a.cssVar;
+      const d = c.get(a.default);
+      n[a.id] = d ?? 0;
+    }
+  return {
+    id: t.id,
+    label: t.label,
+    paletteSize: u,
+    baseRoles: t.baseRoles,
+    paletteCssVarTemplate: s,
+    semanticDefaults: n,
+    semanticCssNames: l,
+    baseDefaults: t.baseDefaults,
+    defaultShikiTheme: t.defaultShikiTheme,
+    colorSchemes: t.colorSchemes,
+    panelSettings: t.panelSettings
+  };
+}
+function V(e) {
+  const t = e.find((r) => r.id === "color");
+  if (t)
+    return b(t);
+}
+function $(e) {
+  const t = e.find((r) => r.id === "color-secondary");
+  return t ? b(t) ?? null : null;
+}
+function y(e, t) {
+  if (Object.is(e, t)) return !0;
+  if (e === null || t === null || typeof e != typeof t || typeof e != "object") return !1;
+  if (Array.isArray(e)) {
+    if (!Array.isArray(t) || e.length !== t.length) return !1;
+    for (let o = 0; o < e.length; o++)
+      if (!y(e[o], t[o])) return !1;
+    return !0;
+  }
+  if (Array.isArray(t)) return !1;
+  const r = Object.keys(e), i = Object.keys(t);
+  if (r.length !== i.length) return !1;
+  const u = new Set(i);
+  for (const o of r)
+    if (!u.has(o) || !y(e[o], t[o]))
+      return !1;
+  return !0;
+}
+const k = {
+  storagePrefix: "zudo-design-token-panel",
+  consoleNamespace: "zudo",
+  modalClassPrefix: "zudo-design-token-panel-modal",
+  schemaId: "zudo-design-tokens/v1",
+  exportFilenameBase: "zudo-design-tokens",
+  // Empty tab list — hosts MUST configure real tabs via configurePanel().
+  tabs: [],
+  colorPresets: {},
+  // No bundled apply endpoint / routing — hosts wire their own.
+  applyEndpoint: void 0,
+  applyRouting: void 0
+}, w = /* @__PURE__ */ Symbol.for("@takazudo/zdtp:singleton");
+function g() {
+  const e = globalThis;
+  let t = e[w];
+  return t || (t = {
+    instances: /* @__PURE__ */ new Map(),
+    defaultPrefix: null,
+    pendingColorPresets: null,
+    pendingPostConfigureHooks: [],
+    lifecycleHooks: {}
+  }, e[w] = t), t;
+}
+function E(e) {
+  return {
+    instanceId: e,
+    open() {
+      g().lifecycleHooks.open?.(e);
+    },
+    close() {
+      g().lifecycleHooks.close?.(e);
+    },
+    toggle() {
+      g().lifecycleHooks.toggle?.(e);
+    },
+    destroy() {
+      g().lifecycleHooks.destroy?.(e);
+      const t = g();
+      if (t.instances.delete(e), t.defaultPrefix === e) {
+        const r = [...t.instances.keys()];
+        t.defaultPrefix = r.length > 0 ? r[r.length - 1] : null;
+      }
+    }
+  };
+}
+function R(e) {
+  g().lifecycleHooks = {
+    configured: e.configured,
+    open: e.open,
+    close: e.close,
+    toggle: e.toggle,
+    destroy: e.destroy
+  };
+}
+function _(e) {
+  const t = g(), r = e.storagePrefix, i = t.instances.get(r);
+  if (i) {
+    const n = (l) => ({ ...l, applySink: void 0 });
+    if (y(n(i.suppliedConfig), n(e)))
+      return t.defaultPrefix = r, i.handle;
+    throw new Error(
+      `[design-token-panel] configurePanel() was already called with different values for storagePrefix "${r}". Configuration is one-shot per prefix per page lifecycle. To re-configure this prefix, call handle.destroy() first, then configurePanel() again. (Use a distinct storagePrefix for a second panel instance.)`
+    );
+  }
+  const u = t.pendingColorPresets, o = u ? { ...e, colorPresets: u } : { ...e };
+  t.pendingColorPresets = null;
+  const s = t.instances.size === 0, c = s ? [...t.pendingPostConfigureHooks] : [];
+  s && (t.pendingPostConfigureHooks.length = 0);
+  const f = {
+    config: o,
+    // Snapshot the as-supplied config before any runtime merges. Used by the
+    // idempotency guard so view-transition re-calls with the original inline
+    // config keep passing even after setPanelColorPresets mutates `config`.
+    suppliedConfig: { ...e },
+    pendingColorPresets: null,
+    postConfigureHooks: c,
+    handle: E(r)
+  };
+  t.instances.set(r, f), t.defaultPrefix = r;
+  for (const n of f.postConfigureHooks)
+    n();
+  return t.lifecycleHooks.configured?.(r), f.handle;
+}
+function m() {
+  const e = g();
+  return e.defaultPrefix === null ? null : e.instances.get(e.defaultPrefix) ?? null;
+}
+function M(e) {
+  const t = m();
+  if (t === null) {
+    const r = g();
+    if (r.pendingPostConfigureHooks.includes(e)) return;
+    r.pendingPostConfigureHooks.push(e);
+    return;
+  }
+  t.postConfigureHooks.includes(e) || (t.postConfigureHooks.push(e), e());
+}
+function C() {
+  return m()?.config ?? k;
+}
+function H() {
+  return [...g().instances.values()].map((e) => e.config);
+}
+function O(e) {
+  return g().instances.get(e)?.config ?? null;
+}
+function N() {
+  const e = g();
+  e.instances.clear(), e.defaultPrefix = null, e.pendingColorPresets = null, e.pendingPostConfigureHooks.length = 0;
+}
+function K(e = C()) {
+  return $(e.tabs);
+}
+function z(e) {
+  return `${e.storagePrefix}-state-v2`;
+}
+function D(e) {
+  return `${e.storagePrefix}-state-v3`;
+}
+function F(e) {
+  return `${e.storagePrefix}-state`;
+}
+function J(e) {
+  return `${e.storagePrefix}-open`;
+}
+function B(e) {
+  return `${e.storagePrefix}-position`;
+}
+function L(e) {
+  return `${e.storagePrefix}-size`;
+}
+function G(e) {
+  return `${e.storagePrefix}-density`;
+}
+function I(e) {
+  return `${e.storagePrefix}:visible`;
+}
+function U(e) {
+  return `${e.storagePrefix}:autoload`;
+}
+function q(e) {
+  return `${e.storagePrefix}-root`;
+}
+const x = k.storagePrefix, S = "toggle-design-token-panel";
+function Y(e) {
+  return e.storagePrefix === x ? S : e.toggleEvent ?? `toggle-${e.storagePrefix}`;
+}
+const A = "__zdtp:open-state-changed";
+function W(e) {
+  return `${A}:${e.storagePrefix}`;
+}
+function X(e, t) {
+  return `${e.modalClassPrefix}${t}`;
+}
+function Q(e) {
+  return `${e.exportFilenameBase}.json`;
+}
+function Z(e) {
+  if (e === null || typeof e != "object" || Array.isArray(e))
+    throw new Error("[design-token-panel] PanelConfig must be a non-null object");
+  const t = e;
+  for (const r of [
+    "storagePrefix",
+    "consoleNamespace",
+    "modalClassPrefix",
+    "schemaId",
+    "exportFilenameBase"
+  ])
+    if (typeof t[r] != "string" || t[r].length === 0)
+      throw new Error(
+        `[design-token-panel] PanelConfig.${r} must be a non-empty string (got ${typeof t[r]})`
+      );
+  if (v(t.tabs), t.toggleEvent !== void 0 && (typeof t.toggleEvent != "string" || t.toggleEvent.length === 0))
+    throw new Error(
+      `[design-token-panel] PanelConfig.toggleEvent must be a non-empty string when set (got ${typeof t.toggleEvent})`
+    );
+  if (t.applyEndpoint !== void 0 && typeof t.applyEndpoint != "string")
+    throw new Error(
+      `[design-token-panel] PanelConfig.applyEndpoint must be a string when set (got ${typeof t.applyEndpoint})`
+    );
+  if (t.applyRouting !== void 0) {
+    if (t.applyRouting === null || typeof t.applyRouting != "object" || Array.isArray(t.applyRouting))
+      throw new Error("[design-token-panel] PanelConfig.applyRouting must be a plain object");
+    for (const [r, i] of Object.entries(t.applyRouting))
+      if (typeof i != "string")
+        throw new Error(
+          `[design-token-panel] PanelConfig.applyRouting[${JSON.stringify(r)}] must be a string`
+        );
+  }
+  if (t.legacyIdRenameMap !== void 0) {
+    if (t.legacyIdRenameMap === null || typeof t.legacyIdRenameMap != "object" || Array.isArray(t.legacyIdRenameMap))
+      throw new Error("[design-token-panel] PanelConfig.legacyIdRenameMap must be a plain object");
+    for (const [r, i] of Object.entries(t.legacyIdRenameMap))
+      if (i !== null && typeof i != "string")
+        throw new Error(
+          `[design-token-panel] PanelConfig.legacyIdRenameMap[${JSON.stringify(r)}] must be a string or null (got ${typeof i})`
+        );
+  }
+}
+function v(e) {
+  if (!Array.isArray(e))
+    throw new Error("[design-token-panel] PanelConfig.tabs must be an array");
+  const t = /* @__PURE__ */ new Set();
+  for (const r of e) {
+    if (r === null || typeof r != "object" || Array.isArray(r))
+      throw new Error("[design-token-panel] PanelConfig.tabs: each tab must be a non-null object");
+    const i = r;
+    if (typeof i.id != "string" || i.id.length === 0)
+      throw new Error("[design-token-panel] PanelConfig.tabs: each tab must have a non-empty string id");
+    if (t.has(i.id))
+      throw new Error(
+        `[design-token-panel] PanelConfig.tabs: duplicate tab id "${i.id}"`
+      );
+    t.add(i.id), T(i.id, i);
+  }
+}
+function T(e, t) {
+  if (!Array.isArray(t.tiers))
+    throw new Error(
+      `[design-token-panel] PanelConfig.tabs["${e}"].tiers must be an array`
+    );
+  const r = /* @__PURE__ */ new Set(), i = /* @__PURE__ */ new Map();
+  for (const o of t.tiers) {
+    if (o === null || typeof o != "object" || Array.isArray(o))
+      throw new Error(
+        `[design-token-panel] PanelConfig.tabs["${e}"].tiers: each tier must be a non-null object`
+      );
+    const s = o;
+    if (typeof s.id != "string" || s.id.length === 0)
+      throw new Error(
+        `[design-token-panel] PanelConfig.tabs["${e}"].tiers: each tier must have a non-empty string id`
+      );
+    if (r.has(s.id))
+      throw new Error(
+        `[design-token-panel] PanelConfig.tabs["${e}"]: duplicate tier id "${s.id}"`
+      );
+    if (r.add(s.id), !Array.isArray(s.items))
+      throw new Error(
+        `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${s.id}"].items must be an array`
+      );
+    let c;
+    for (const f of s.items) {
+      if (f === null || typeof f != "object" || Array.isArray(f)) continue;
+      const l = f.type;
+      if (l === null || typeof l != "object" || Array.isArray(l)) continue;
+      const a = l.kind;
+      if (typeof a == "string") {
+        if (c === void 0)
+          c = a;
+        else if (c !== a)
+          throw new Error(
+            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${s.id}"]: mixed item kinds — found "${c}" and "${a}" in the same tier (all items must share the same kind)`
+          );
+      }
+    }
+    c !== void 0 && i.set(s.id, c);
+  }
+  const u = /* @__PURE__ */ new Set();
+  for (const o of t.tiers) {
+    const s = o, c = s.id;
+    for (const f of s.items) {
+      if (f === null || typeof f != "object" || Array.isArray(f))
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${c}"].items: each item must be a non-null object`
+        );
+      const n = f;
+      if (typeof n.id != "string" || n.id.length === 0)
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${c}"].items: each item must have a non-empty string id`
+        );
+      if (u.has(n.id))
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"]: duplicate item id "${n.id}" (item ids must be unique across all tiers within a tab)`
+        );
+      if (u.add(n.id), typeof n.cssVar != "string" || !n.cssVar.startsWith("--"))
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${c}"].items["${n.id}"].cssVar must start with "--" (got ${JSON.stringify(n.cssVar)})`
+        );
+      if (n.cssVar.length <= 2)
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${c}"].items["${n.id}"].cssVar must be non-empty after "--"`
+        );
+    }
+  }
+  for (const o of t.tiers) {
+    const s = o, c = s.id;
+    if (s.referencesTier !== void 0) {
+      if (typeof s.referencesTier != "string")
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${c}"].referencesTier must be a string`
+        );
+      const f = s.referencesTier;
+      if (!r.has(f))
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${c}"].referencesTier: tier "${f}" does not exist in this tab`
+        );
+      const n = i.get(c), l = i.get(f);
+      if (n !== void 0 && l !== void 0 && n !== "text" && n !== l)
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${c}"].referencesTier: referencing tier has kind "${n}" but referenced tier "${f}" has kind "${l}" (cross-kind reference is only allowed when the referencing tier has kind "text")`
+        );
+    }
+  }
+  if (t.colorExtras !== void 0) {
+    const o = t.colorExtras;
+    if (o === null || typeof o != "object" || Array.isArray(o))
+      throw new Error(
+        `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras must be a plain object`
+      );
+    for (const n of ["id", "defaultShikiTheme"])
+      if (typeof o[n] != "string" || o[n].length === 0)
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.${n} must be a non-empty string (got ${typeof o[n]})`
+        );
+    for (const n of ["colorSchemes", "baseRoles", "baseDefaults"])
+      if (o[n] === void 0 || o[n] === null || typeof o[n] != "object" || Array.isArray(o[n]))
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.${n} must be a plain object`
+        );
+    if (o.panelSettings === void 0 || o.panelSettings === null || typeof o.panelSettings != "object" || Array.isArray(o.panelSettings))
+      throw new Error(
+        `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings must be a plain object`
+      );
+    const s = o.panelSettings;
+    if (typeof s.colorScheme != "string" || s.colorScheme.length === 0)
+      throw new Error(
+        `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings.colorScheme must be a non-empty string`
+      );
+    if (s.colorMode !== !1) {
+      if (s.colorMode === null || typeof s.colorMode != "object" || Array.isArray(s.colorMode))
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings.colorMode must be false or a plain object`
+        );
+      const n = s.colorMode;
+      for (const l of ["lightScheme", "darkScheme"])
+        if (typeof n[l] != "string" || n[l].length === 0)
+          throw new Error(
+            `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings.colorMode.${l} must be a non-empty string`
+          );
+      if (n.defaultMode !== "light" && n.defaultMode !== "dark")
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings.colorMode.defaultMode must be "light" or "dark" (got ${JSON.stringify(n.defaultMode)})`
+        );
+    }
+    const f = t.tiers.find((n) => {
+      if (n.referencesTier !== void 0) return !1;
+      const l = n.items;
+      if (!Array.isArray(l) || l.length === 0) return !1;
+      const a = l[0];
+      if (a === null || typeof a != "object" || Array.isArray(a)) return !1;
+      const d = a.type;
+      return d === null || typeof d != "object" || Array.isArray(d) ? !1 : d.kind === "color";
+    });
+    if (f) {
+      const n = f.id, l = f.items, a = l[0]?.cssVar;
+      if (a !== void 0) {
+        const d = a.replace(/\d+$/, "{n}");
+        if (d.includes("{n}"))
+          for (let p = 0; p < l.length; p++) {
+            const h = l[p], P = d.replace("{n}", String(p));
+            if (h.cssVar !== P)
+              throw new Error(
+                `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${n}"].items[${p}].cssVar is ${JSON.stringify(h.cssVar)} but expected ${JSON.stringify(P)} — palette item cssVars must share one prefix and be numbered 0..n-1 in tier order (template derived from first item: ${JSON.stringify(d)})`
+              );
+          }
+        else if (l.length > 1)
+          throw new Error(
+            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${n}"].items[0].cssVar ${JSON.stringify(a)} has no trailing digit — palette item cssVars must share one prefix and be numbered 0..n-1 in tier order (e.g. "--pal-0" … "--pal-15")`
+          );
+      }
+    }
+  }
+}
+function ee(e = C()) {
+  return e.applyRouting ?? {};
+}
+function te(e) {
+  const t = m();
+  if (t === null) {
+    g().pendingColorPresets = e;
+    return;
+  }
+  t.config = { ...t.config, colorPresets: e };
+}
+export {
+  L as A,
+  G as B,
+  S as D,
+  N as _,
+  I as a,
+  z as b,
+  _ as c,
+  D as d,
+  Z as e,
+  J as f,
+  C as g,
+  B as h,
+  F as i,
+  U as j,
+  Q as k,
+  y as l,
+  X as m,
+  K as n,
+  ee as o,
+  b as p,
+  W as q,
+  j as r,
+  te as s,
+  R as t,
+  M as u,
+  Y as v,
+  H as w,
+  O as x,
+  q as y,
+  V as z
+};

package/dist/panel.d.ts

@@ -16,4 +16,3 @@ interface DesignTokenTweakPanelProps {
 }
 export default function DesignTokenTweakPanel({ instanceConfig: instanceConfigProp, }?: DesignTokenTweakPanelProps): import("preact").JSX.Element;
 export type { TweakState } from './state/tweak-state';
-//# sourceMappingURL=panel.d.ts.map

package/dist/server/create-apply-handler.d.ts

@@ -45,4 +45,3 @@ export interface PerFileResult {
  * ```
  */
 export declare function createApplyHandler(options: ApplyHandlerOptions): (req: Request) => Promise<Response>;
-//# sourceMappingURL=create-apply-handler.d.ts.map

package/dist/server/index.d.ts

@@ -21,4 +21,3 @@ export type { ApplyHandlerOptions, PerFileResult } from './create-apply-handler'
 export { serializeFileWrite } from './serialize-write';
 export { CSS_VAR_NAME_RE, isPathSafe, isValidCssVarName, validateAndSanitizeTokens, } from './path-safety';
 export { loadRoutingFromFile, type ApplyRoutingMap } from './load-routing';
-//# sourceMappingURL=index.d.ts.map

package/dist/server/index.js

@@ -1,4 +1,4 @@
-import { C as s, c as i, i as l, a as r, l as t, s as o, v as d } from "../load-routing-XyKgftpe.js";
+import { C as s, c as i, i as l, a as r, l as t, s as o, v as d } from "../load-routing-DtNTKoLW.js";
 export {
   s as CSS_VAR_NAME_RE,
   i as createApplyHandler,

package/dist/server/load-routing.d.ts

@@ -36,4 +36,3 @@ export type ApplyRoutingMap = Record<string, string>;
  * ```
  */
 export declare function loadRoutingFromFile(absPath: string): ApplyRoutingMap;
-//# sourceMappingURL=load-routing.d.ts.map

package/dist/server/path-safety.d.ts

@@ -33,4 +33,3 @@ export declare function validateAndSanitizeTokens(tokens: Record<string, unknown
     sanitized?: Record<string, string>;
     error?: string;
 };
-//# sourceMappingURL=path-safety.d.ts.map

package/dist/server/serialize-write.d.ts

@@ -4,4 +4,3 @@
  * one settles (success or error). Calls for different paths run in parallel.
  */
 export declare function serializeFileWrite<T>(absPath: string, fn: () => Promise<T>): Promise<T>;
-//# sourceMappingURL=serialize-write.d.ts.map

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

@@ -89,4 +89,3 @@ export declare function setAutoload(cfg: PanelConfig, on: boolean): void;
  * SSR-safe and quota-tolerant.
  */
 export declare function clearAutoload(cfg: PanelConfig): void;
-//# sourceMappingURL=autoload-state.d.ts.map

package/dist/state/persist.d.ts

@@ -33,7 +33,6 @@ export declare function usePersist(setState: SetState<TweakState>, cfg?: PanelCo
     persistTypography: (updater: (prev: TokenOverrides) => TokenOverrides) => void;
     persistFont: (updater: (prev: TokenOverrides) => TokenOverrides) => void;
     persistSize: (updater: (prev: TokenOverrides) => TokenOverrides) => void;
-    persistPanelPosition: (updater: (prev: TweakState["panelPosition"]) => TweakState["panelPosition"]) => void;
     persistSecondary: (updater: (prev: ColorTweakState | undefined) => ColorTweakState | undefined) => void;
 };
 export type Persist = ReturnType<typeof usePersist>['persist'];
@@ -44,7 +43,5 @@ export type PersistTypography = ReturnType<typeof usePersist>['persistTypography
 /** Upstream alias for `PersistTypography`. See `persistFont` above. */
 export type PersistFont = PersistTypography;
 export type PersistSize = ReturnType<typeof usePersist>['persistSize'];
-export type PersistPanelPosition = ReturnType<typeof usePersist>['persistPanelPosition'];
 export type PersistSecondary = ReturnType<typeof usePersist>['persistSecondary'];
 export {};
-//# sourceMappingURL=persist.d.ts.map

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

@@ -195,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`/
@@ -209,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>;
@@ -304,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;
@@ -440,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

@@ -55,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