@takazudo/zdtp 0.4.4 → 0.4.6

package/dist/{panel-config-CXTCcYQs.js → panel-config-Bw7D-25C.js}

@@ -3,68 +3,68 @@ class w extends Error {
     super(t), this.name = "TierResolverError", Object.setPrototypeOf(this, w.prototype);
   }
 }
-function E(e, t) {
+function A(e, t) {
   return e.tiers.find((n) => n.id === t);
 }
 function $(e, t) {
   return e.items.find((n) => n.id === t);
 }
-function G(e, t, n, l) {
-  const g = E(e, t);
+function Y(e, t, n, a) {
+  const g = A(e, t);
   if (!g)
     throw new w(
-      `Tier "${t}" not found in tab "${e.id}". Available tiers: ${e.tiers.map((a) => a.id).join(", ")}.`
+      `Tier "${t}" not found in tab "${e.id}". Available tiers: ${e.tiers.map((l) => l.id).join(", ")}.`
     );
   const c = $(g, n);
   if (!c)
     throw new w(
       `Item "${n}" not found in tier "${t}" of tab "${e.id}".`
     );
-  const i = l[t]?.[n];
+  const s = a[t]?.[n];
   if (g.referencesTier !== void 0) {
-    const a = g.referencesTier, f = E(e, a);
+    const l = g.referencesTier, f = A(e, l);
     if (!f)
       throw new w(
-        `Tier "${t}" declares referencesTier "${a}" but that tier does not exist in tab "${e.id}".`
+        `Tier "${t}" declares referencesTier "${l}" but that tier does not exist in tab "${e.id}".`
       );
-    const o = $(f, i ?? n);
-    if (!o) {
-      const d = $(f, c.default) ?? $(f, n) ?? f.items[0];
-      if (!d)
+    const i = $(f, s ?? n);
+    if (!i) {
+      const u = $(f, c.default) ?? $(f, n) ?? f.items[0];
+      if (!u)
         throw new w(
-          `Referenced tier "${a}" has no items; cannot resolve fallback for item "${n}" in tier "${t}" of tab "${e.id}".`
+          `Referenced tier "${l}" has no items; cannot resolve fallback for item "${n}" in tier "${t}" of tab "${e.id}".`
         );
-      return { kind: "ref", targetCssVar: d.cssVar };
+      return { kind: "ref", targetCssVar: u.cssVar };
     }
-    return { kind: "ref", targetCssVar: o.cssVar };
+    return { kind: "ref", targetCssVar: i.cssVar };
   }
-  return i !== void 0 ? c.pill && i === c.pill.value ? { kind: "literal", value: c.pill.value } : { kind: "literal", value: i } : c.pill ? { kind: "literal", value: c.pill.customDefault } : { kind: "literal", value: c.default };
+  return s !== void 0 ? c.pill && s === c.pill.value ? { kind: "literal", value: c.pill.value } : { kind: "literal", value: s } : c.pill ? { kind: "literal", value: c.pill.customDefault } : { kind: "literal", value: c.default };
 }
-function U(e) {
+function Z(e) {
   return e.kind === "literal" ? e.value : `var(${e.targetCssVar})`;
 }
-function _(e, t, n = [t]) {
-  const l = e.tab === void 0 || e.tab === t.id ? t : n.find((s) => s.id === e.tab);
-  if (!l)
+function M(e, t, n = [t]) {
+  const a = e.tab === void 0 || e.tab === t.id ? t : n.find((o) => o.id === e.tab);
+  if (!a)
     throw new w(
-      `Cross-tab ref target tab "${e.tab}" not found. Available tabs: ${n.map((s) => s.id).join(", ")}.`
+      `Cross-tab ref target tab "${e.tab}" not found. Available tabs: ${n.map((o) => o.id).join(", ")}.`
     );
-  const g = E(l, e.tier);
+  const g = A(a, e.tier);
   if (!g)
     throw new w(
-      `Cross-tab ref target tier "${e.tier}" not found in tab "${l.id}". Available tiers: ${l.tiers.map((s) => s.id).join(", ")}.`
+      `Cross-tab ref target tier "${e.tier}" not found in tab "${a.id}". Available tiers: ${a.tiers.map((o) => o.id).join(", ")}.`
     );
   const c = $(g, e.item);
   if (!c)
     throw new w(
-      `Cross-tab ref target item "${e.item}" not found in tier "${e.tier}" of tab "${l.id}". Available items: ${g.items.map((s) => s.id).join(", ")}.`
+      `Cross-tab ref target item "${e.item}" not found in tier "${e.tier}" of tab "${a.id}". Available items: ${g.items.map((o) => o.id).join(", ")}.`
     );
   return c.cssVar;
 }
-function W(e, t) {
+function X(e, t) {
   return e.paletteCssVarTemplate.replace("{n}", String(t));
 }
-const M = /* @__PURE__ */ new Set([
+const N = /* @__PURE__ */ new Set([
   "aliceblue",
   "antiquewhite",
   "aqua",
@@ -221,39 +221,39 @@ const M = /* @__PURE__ */ new Set([
   "revert",
   "revert-layer"
 ]);
-function H(e) {
-  return e.startsWith("#") || e.includes("(") || M.has(e.toLowerCase());
+function z(e) {
+  return e.startsWith("#") || e.includes("(") || N.has(e.toLowerCase());
 }
-function N(e, t, n, l) {
+function H(e, t, n, a) {
   const g = [], c = e.indexOf(":");
   if (c !== -1) {
-    const i = e.slice(0, c), a = e.slice(c + 1), f = t.find((r) => r.tier === i);
-    f && g.push({ tab: f.tab, tier: f.tier, item: a });
+    const s = e.slice(0, c), l = e.slice(c + 1), f = t.find((r) => r.tier === s);
+    f && g.push({ tab: f.tab, tier: f.tier, item: l });
   }
-  const [s] = t;
-  g.push({ tab: s.tab, tier: s.tier, item: e });
-  for (const i of g)
+  const [o] = t;
+  g.push({ tab: o.tab, tier: o.tier, item: e });
+  for (const s of g)
     try {
-      return _(i, n, l), { ref: i };
+      return M(s, n, a), { ref: s };
     } catch {
     }
   return { ref: g[0] };
 }
-function K(e, t, n, l, g, c) {
-  const s = t.get(e.default);
-  return s !== void 0 ? s : e.default === "bg" || e.default === "fg" ? e.default : n && n.length > 0 && !H(e.default) ? N(e.default, n, l, g) : c ? (console.warn(
+function K(e, t, n, a, g, c) {
+  const o = t.get(e.default);
+  return o !== void 0 ? o : e.default === "bg" || e.default === "fg" ? e.default : n && n.length > 0 && !z(e.default) ? H(e.default, n, a, g) : c ? (console.warn(
     `[design-token-panel] semantic item "${e.id}" default "${e.default}" names no palette item; falling back to palette index 0`
   ), 0) : { literal: e.default };
 }
-function R(e, t = [e]) {
+function V(e, t = [e]) {
   const n = e.colorExtras;
   if (!n) return;
-  const l = e.tiers.find(
-    (o) => !o.referencesTier && !o.semantic && o.items.length > 0 && o.items[0].type.kind === "color"
+  const a = e.tiers.find(
+    (i) => !i.referencesTier && !i.semantic && i.items.length > 0 && i.items[0].type.kind === "color"
   ), g = e.tiers.find(
-    (o) => l && o.referencesTier === l.id || o.semantic === !0
+    (i) => a && i.referencesTier === a.id || i.semantic === !0
   );
-  if (!l && !g)
+  if (!a && !g)
     return {
       id: n.id,
       label: n.label,
@@ -267,28 +267,28 @@ function R(e, t = [e]) {
       colorSchemes: n.colorSchemes,
       panelSettings: n.panelSettings
     };
-  const c = l?.items ?? [], s = c.length, i = c[0] ? c[0].cssVar.replace(/\d+$/, "{n}") : "--zudo-stub-p{n}", a = /* @__PURE__ */ new Map();
-  for (let o = 0; o < c.length; o++)
-    a.set(c[o].id, o);
+  const c = a?.items ?? [], o = c.length, s = c[0] ? c[0].cssVar.replace(/\d+$/, "{n}") : "--zudo-stub-p{n}", l = /* @__PURE__ */ new Map();
+  for (let i = 0; i < c.length; i++)
+    l.set(c[i].id, i);
   const f = {}, r = {};
   if (g) {
-    const o = !g.semantic;
+    const i = !g.semantic, u = n.semanticDefaults;
     for (const d of g.items)
-      r[d.id] = d.cssVar, f[d.id] = K(
+      r[d.id] = d.cssVar, f[d.id] = u && d.id in u ? u[d.id] : K(
         d,
-        a,
+        l,
         g.referencesRamps,
         e,
         t,
-        o
+        i
       );
   }
   return {
     id: n.id,
     label: n.label,
-    paletteSize: s,
+    paletteSize: o,
     baseRoles: n.baseRoles,
-    paletteCssVarTemplate: i,
+    paletteCssVarTemplate: s,
     semanticDefaults: f,
     semanticCssNames: r,
     baseDefaults: n.baseDefaults,
@@ -297,34 +297,34 @@ function R(e, t = [e]) {
     panelSettings: n.panelSettings
   };
 }
-function Y(e) {
+function Q(e) {
   const t = e.find((n) => n.id === "color");
   if (t)
-    return R(t, e);
+    return V(t, e);
 }
-function z(e) {
+function L(e) {
   const t = e.find((n) => n.id === "color-secondary");
-  return t ? R(t, e) ?? null : null;
+  return t ? V(t, e) ?? null : null;
 }
-function A(e, t) {
+function S(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 c = 0; c < e.length; c++)
-      if (!A(e[c], t[c])) return !1;
+      if (!S(e[c], t[c])) return !1;
     return !0;
   }
   if (Array.isArray(t)) return !1;
-  const n = Object.keys(e), l = Object.keys(t);
-  if (n.length !== l.length) return !1;
-  const g = new Set(l);
+  const n = Object.keys(e), a = Object.keys(t);
+  if (n.length !== a.length) return !1;
+  const g = new Set(a);
   for (const c of n)
-    if (!g.has(c) || !A(e[c], t[c]))
+    if (!g.has(c) || !S(e[c], t[c]))
       return !1;
   return !0;
 }
-const V = {
+const _ = {
   storagePrefix: "zudo-design-token-panel",
   consoleNamespace: "zudo",
   modalClassPrefix: "zudo-design-token-panel-modal",
@@ -336,33 +336,34 @@ const V = {
   // No bundled apply endpoint / routing — hosts wire their own.
   applyEndpoint: void 0,
   applyRouting: void 0
-}, j = /* @__PURE__ */ Symbol.for("@takazudo/zdtp:singleton");
-function y() {
+}, R = /* @__PURE__ */ Symbol.for("@takazudo/zdtp:singleton");
+function m() {
   const e = globalThis;
-  let t = e[j];
+  let t = e[R];
   return t || (t = {
     instances: /* @__PURE__ */ new Map(),
     defaultPrefix: null,
     pendingColorPresets: null,
     pendingPostConfigureHooks: [],
-    lifecycleHooks: {}
-  }, e[j] = t), t;
+    lifecycleHooks: {},
+    colorSchemeOwners: /* @__PURE__ */ new Set()
+  }, e[R] = t), t;
 }
-function D(e) {
+function F(e) {
   return {
     instanceId: e,
     open() {
-      y().lifecycleHooks.open?.(e);
+      m().lifecycleHooks.open?.(e);
     },
     close() {
-      y().lifecycleHooks.close?.(e);
+      m().lifecycleHooks.close?.(e);
     },
     toggle() {
-      y().lifecycleHooks.toggle?.(e);
+      m().lifecycleHooks.toggle?.(e);
     },
     destroy() {
-      y().lifecycleHooks.destroy?.(e);
-      const t = y();
+      m().lifecycleHooks.destroy?.(e);
+      const t = m();
       if (t.instances.delete(e), t.defaultPrefix === e) {
         const n = [...t.instances.keys()];
         t.defaultPrefix = n.length > 0 ? n[n.length - 1] : null;
@@ -371,7 +372,7 @@ function D(e) {
   };
 }
 function I(e) {
-  y().lifecycleHooks = {
+  m().lifecycleHooks = {
     configured: e.configured,
     open: e.open,
     close: e.close,
@@ -379,110 +380,140 @@ function I(e) {
     destroy: e.destroy
   };
 }
-function X(e) {
-  const t = y(), n = e.storagePrefix, l = t.instances.get(n);
-  if (l) {
+function ee(e) {
+  const t = m(), n = e.storagePrefix, a = t.instances.get(n);
+  if (a) {
     const f = (r) => ({ ...r, applySink: void 0 });
-    if (A(f(l.suppliedConfig), f(e)))
-      return t.defaultPrefix = n, l.handle;
+    if (S(f(a.suppliedConfig), f(e)))
+      return t.defaultPrefix = n, a.handle;
     throw new Error(
       `[design-token-panel] configurePanel() was already called with different values for storagePrefix "${n}". 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 g = t.pendingColorPresets, c = g ? { ...e, colorPresets: g } : { ...e };
   t.pendingColorPresets = null;
-  const s = t.instances.size === 0, i = s ? [...t.pendingPostConfigureHooks] : [];
-  s && (t.pendingPostConfigureHooks.length = 0);
-  const a = {
+  const o = t.instances.size === 0, s = o ? [...t.pendingPostConfigureHooks] : [];
+  o && (t.pendingPostConfigureHooks.length = 0);
+  const l = {
     config: c,
     // 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: i,
-    handle: D(n)
+    postConfigureHooks: s,
+    handle: F(n)
   };
-  t.instances.set(n, a), t.defaultPrefix = n;
-  for (const f of a.postConfigureHooks)
+  t.instances.set(n, l), t.defaultPrefix = n;
+  for (const f of l.postConfigureHooks)
     f();
-  return t.lifecycleHooks.configured?.(n), a.handle;
+  return t.lifecycleHooks.configured?.(n), l.handle;
 }
 function x() {
-  const e = y();
+  const e = m();
   return e.defaultPrefix === null ? null : e.instances.get(e.defaultPrefix) ?? null;
 }
-function Q(e) {
+function te(e) {
   const t = x();
   if (t === null) {
-    const n = y();
+    const n = m();
     if (n.pendingPostConfigureHooks.includes(e)) return;
     n.pendingPostConfigureHooks.push(e);
     return;
   }
   t.postConfigureHooks.includes(e) || (t.postConfigureHooks.push(e), e());
 }
-function O() {
-  return x()?.config ?? V;
+function D() {
+  return x()?.config ?? _;
 }
-function Z() {
-  return [...y().instances.values()].map((e) => e.config);
+function ne() {
+  return [...m().instances.values()].map((e) => e.config);
 }
-function ee(e) {
-  return y().instances.get(e)?.config ?? null;
+function re(e) {
+  return m().instances.get(e)?.config ?? null;
 }
-function te() {
-  const e = y();
-  e.instances.clear(), e.defaultPrefix = null, e.pendingColorPresets = null, e.pendingPostConfigureHooks.length = 0;
+function ie() {
+  const e = m();
+  e.instances.clear(), e.defaultPrefix = null, e.pendingColorPresets = null, e.pendingPostConfigureHooks.length = 0, v().clear();
 }
-function ne(e = O()) {
-  return z(e.tabs);
+function v() {
+  const e = m();
+  return e.colorSchemeOwners || (e.colorSchemeOwners = /* @__PURE__ */ new Set()), e.colorSchemeOwners;
 }
-function re(e) {
+function oe(e) {
+  v().add(e);
+}
+function se(e) {
+  v().delete(e);
+}
+function ae(e) {
+  return v().has(e);
+}
+function le(e = D()) {
+  return L(e.tabs);
+}
+function fe(e) {
   return `${e.storagePrefix}-state-v2`;
 }
-function ie(e) {
+function ce(e) {
   return `${e.storagePrefix}-state-v3`;
 }
-function oe(e) {
+function ge(e) {
+  return `${e.storagePrefix}-state-v4`;
+}
+function ue(e) {
   return `${e.storagePrefix}-state`;
 }
-function se(e) {
+function de(e) {
   return `${e.storagePrefix}-open`;
 }
-function ae(e) {
+function pe(e) {
   return `${e.storagePrefix}-position`;
 }
-function le(e) {
+function ye(e) {
   return `${e.storagePrefix}-size`;
 }
-function fe(e) {
+function me(e) {
   return `${e.storagePrefix}-density`;
 }
-function ce(e) {
+function he(e) {
   return `${e.storagePrefix}:visible`;
 }
-function ge(e) {
+function be(e) {
   return `${e.storagePrefix}:autoload`;
 }
-function de(e) {
+function we(e) {
   return `${e.storagePrefix}-root`;
 }
-const F = V.storagePrefix, q = "toggle-design-token-panel";
-function ue(e) {
-  return e.storagePrefix === F ? q : e.toggleEvent ?? `toggle-${e.storagePrefix}`;
+const J = _.storagePrefix, q = "toggle-design-token-panel";
+function ke(e) {
+  return e.storagePrefix === J ? q : e.toggleEvent ?? `toggle-${e.storagePrefix}`;
 }
-const L = "__zdtp:open-state-changed";
-function pe(e) {
-  return `${L}:${e.storagePrefix}`;
+const G = "__zdtp:open-state-changed";
+function $e(e) {
+  return `${G}:${e.storagePrefix}`;
 }
-function ye(e, t) {
+function Pe(e, t) {
   return `${e.modalClassPrefix}${t}`;
 }
-function me(e) {
+function Ce(e) {
   return `${e.exportFilenameBase}.json`;
 }
-function he(e) {
+const O = /* @__PURE__ */ Symbol.for("@takazudo/zdtp:global-alias-marker");
+function Ee(e) {
+  if (typeof window > "u") return;
+  const t = window, n = t.zdtp;
+  if (n !== void 0) {
+    if ((typeof n == "object" || typeof n == "function") && n !== null && n[O] === !0) return;
+    console.warn(
+      "[design-token-panel] window.zdtp already exists and was not installed by this package. Skipping the zdtp.show() / zdtp.hide() / zdtp.toggle() global alias to avoid clobbering it. Use window[consoleNamespace].* or the configurePanel(cfg) handle instead."
+    );
+    return;
+  }
+  const a = { ...e };
+  a[O] = !0, t.zdtp = a;
+}
+function ve(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;
@@ -497,7 +528,7 @@ function he(e) {
       throw new Error(
         `[design-token-panel] PanelConfig.${n} must be a non-empty string (got ${typeof t[n]})`
       );
-  if (J(t.tabs), t.toggleEvent !== void 0 && (typeof t.toggleEvent != "string" || t.toggleEvent.length === 0))
+  if (B(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})`
     );
@@ -508,8 +539,8 @@ function he(e) {
   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 [n, l] of Object.entries(t.applyRouting))
-      if (typeof l != "string")
+    for (const [n, a] of Object.entries(t.applyRouting))
+      if (typeof a != "string")
         throw new Error(
           `[design-token-panel] PanelConfig.applyRouting[${JSON.stringify(n)}] must be a string`
         );
@@ -517,87 +548,106 @@ function he(e) {
   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 [n, l] of Object.entries(t.legacyIdRenameMap))
-      if (l !== null && typeof l != "string")
+    for (const [n, a] of Object.entries(t.legacyIdRenameMap))
+      if (a !== null && typeof a != "string")
         throw new Error(
-          `[design-token-panel] PanelConfig.legacyIdRenameMap[${JSON.stringify(n)}] must be a string or null (got ${typeof l})`
+          `[design-token-panel] PanelConfig.legacyIdRenameMap[${JSON.stringify(n)}] must be a string or null (got ${typeof a})`
         );
   }
 }
-function J(e) {
+function B(e) {
   if (!Array.isArray(e))
     throw new Error("[design-token-panel] PanelConfig.tabs must be an array");
   const t = /* @__PURE__ */ new Set();
   for (const n of e) {
     if (n === null || typeof n != "object" || Array.isArray(n))
       throw new Error("[design-token-panel] PanelConfig.tabs: each tab must be a non-null object");
-    const l = n;
-    if (typeof l.id != "string" || l.id.length === 0)
+    const a = n;
+    if (typeof a.id != "string" || a.id.length === 0)
       throw new Error("[design-token-panel] PanelConfig.tabs: each tab must have a non-empty string id");
-    if (t.has(l.id))
+    if (t.has(a.id))
       throw new Error(
-        `[design-token-panel] PanelConfig.tabs: duplicate tab id "${l.id}"`
+        `[design-token-panel] PanelConfig.tabs: duplicate tab id "${a.id}"`
       );
-    t.add(l.id), B(l.id, l, e);
+    t.add(a.id), W(a.id, a, e);
   }
 }
-function B(e, t, n) {
+function U(e) {
+  if (typeof e == "number" || e === "bg" || e === "fg") return !0;
+  if (e === null || typeof e != "object" || Array.isArray(e)) return !1;
+  const t = e;
+  if ("literal" in t) {
+    const n = t.literal;
+    if (typeof n == "string") return !0;
+    if (n === null || typeof n != "object" || Array.isArray(n)) return !1;
+    const a = n;
+    return typeof a.light == "string" && typeof a.dark == "string";
+  }
+  if ("ref" in t) {
+    const n = t.ref;
+    if (n === null || typeof n != "object" || Array.isArray(n)) return !1;
+    const a = n;
+    return !(typeof a.tier != "string" || typeof a.item != "string" || a.tab !== void 0 && typeof a.tab != "string");
+  }
+  return !1;
+}
+function W(e, t, n) {
   if (!Array.isArray(t.tiers))
     throw new Error(
       `[design-token-panel] PanelConfig.tabs["${e}"].tiers must be an array`
     );
-  const l = /* @__PURE__ */ new Set(), g = /* @__PURE__ */ new Map();
-  for (const s of t.tiers) {
-    if (s === null || typeof s != "object" || Array.isArray(s))
+  const a = /* @__PURE__ */ new Set(), g = /* @__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 i = s;
-    if (typeof i.id != "string" || i.id.length === 0)
+    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 (l.has(i.id))
+    if (a.has(s.id))
       throw new Error(
-        `[design-token-panel] PanelConfig.tabs["${e}"]: duplicate tier id "${i.id}"`
+        `[design-token-panel] PanelConfig.tabs["${e}"]: duplicate tier id "${s.id}"`
       );
-    if (l.add(i.id), i.semantic !== void 0 && i.semantic !== !0)
+    if (a.add(s.id), s.semantic !== void 0 && s.semantic !== !0)
       throw new Error(
-        `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${i.id}"].semantic must be exactly \`true\` when present (got ${JSON.stringify(i.semantic)})`
+        `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${s.id}"].semantic must be exactly \`true\` when present (got ${JSON.stringify(s.semantic)})`
       );
-    if (!Array.isArray(i.items))
+    if (!Array.isArray(s.items))
       throw new Error(
-        `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${i.id}"].items must be an array`
+        `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${s.id}"].items must be an array`
       );
-    let a;
-    for (const f of i.items) {
+    let l;
+    for (const f of s.items) {
       if (f === null || typeof f != "object" || Array.isArray(f)) continue;
-      const o = f.type;
-      if (o === null || typeof o != "object" || Array.isArray(o)) continue;
-      const d = o.kind;
-      if (typeof d == "string") {
-        if (a === void 0)
-          a = d;
-        else if (a !== d)
+      const i = f.type;
+      if (i === null || typeof i != "object" || Array.isArray(i)) continue;
+      const u = i.kind;
+      if (typeof u == "string") {
+        if (l === void 0)
+          l = u;
+        else if (l !== u)
           throw new Error(
-            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${i.id}"]: mixed item kinds — found "${a}" and "${d}" in the same tier (all items must share the same kind)`
+            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${s.id}"]: mixed item kinds — found "${l}" and "${u}" in the same tier (all items must share the same kind)`
           );
       }
     }
-    a !== void 0 && g.set(i.id, a);
+    l !== void 0 && g.set(s.id, l);
   }
   const c = /* @__PURE__ */ new Set();
-  for (const s of t.tiers) {
-    const i = s, a = i.id;
-    for (const f of i.items) {
+  for (const o of t.tiers) {
+    const s = o, l = 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["${a}"].items: each item must be a non-null object`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].items: each item must be a non-null object`
         );
       const r = f;
       if (typeof r.id != "string" || r.id.length === 0)
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].items: each item must have a non-empty string id`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].items: each item must have a non-empty string id`
         );
       if (c.has(r.id))
         throw new Error(
@@ -605,220 +655,280 @@ function B(e, t, n) {
         );
       if (c.add(r.id), typeof r.cssVar != "string" || !r.cssVar.startsWith("--"))
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].items["${r.id}"].cssVar must start with "--" (got ${JSON.stringify(r.cssVar)})`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].items["${r.id}"].cssVar must start with "--" (got ${JSON.stringify(r.cssVar)})`
         );
       if (r.cssVar.length <= 2)
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].items["${r.id}"].cssVar must be non-empty after "--"`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].items["${r.id}"].cssVar must be non-empty after "--"`
         );
+      const i = r.type;
+      if (i !== null && typeof i == "object" && !Array.isArray(i) && i.kind === "length" && i.units !== void 0) {
+        const u = i.units;
+        if (!Array.isArray(u))
+          throw new Error(
+            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].items["${r.id}"].type.units must be an array`
+          );
+        const d = /* @__PURE__ */ new Set();
+        for (const p of u) {
+          if (typeof p != "string" || p.length === 0)
+            throw new Error(
+              `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].items["${r.id}"].type.units entries must be non-empty strings (got ${JSON.stringify(p)})`
+            );
+          if (d.has(p))
+            throw new Error(
+              `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].items["${r.id}"].type.units: duplicate unit ${JSON.stringify(p)}`
+            );
+          d.add(p);
+        }
+      }
     }
   }
-  for (const s of t.tiers) {
-    const i = s, a = i.id;
-    if (i.referencesTier !== void 0) {
-      if (typeof i.referencesTier != "string")
+  for (const o of t.tiers) {
+    const s = o, l = s.id;
+    if (s.referencesTier !== void 0) {
+      if (typeof s.referencesTier != "string")
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesTier must be a string`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesTier must be a string`
         );
-      const f = i.referencesTier;
-      if (!l.has(f))
+      const f = s.referencesTier;
+      if (!a.has(f))
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesTier: tier "${f}" does not exist in this tab`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesTier: tier "${f}" does not exist in this tab`
         );
-      const r = g.get(a), o = g.get(f);
-      if (r !== void 0 && o !== void 0 && r !== "text" && r !== o)
+      const r = g.get(l), i = g.get(f);
+      if (r !== void 0 && i !== void 0 && r !== "text" && r !== i)
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesTier: referencing tier has kind "${r}" but referenced tier "${f}" has kind "${o}" (cross-kind reference is only allowed when the referencing tier has kind "text")`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesTier: referencing tier has kind "${r}" but referenced tier "${f}" has kind "${i}" (cross-kind reference is only allowed when the referencing tier has kind "text")`
         );
     }
   }
-  for (const s of t.tiers) {
-    const i = s, a = i.id;
-    if (i.referencesRamps === void 0) continue;
-    if (i.semantic !== !0)
+  for (const o of t.tiers) {
+    const s = o, l = s.id;
+    if (s.referencesRamps === void 0) continue;
+    if (s.semantic !== !0)
       throw new Error(
-        `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesRamps is only valid on a tier with semantic: true`
+        `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps is only valid on a tier with semantic: true`
       );
-    if (!Array.isArray(i.referencesRamps))
+    if (!Array.isArray(s.referencesRamps))
       throw new Error(
-        `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesRamps must be an array`
+        `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps must be an array`
       );
-    const f = g.get(a), r = i.referencesRamps;
-    for (let o = 0; o < r.length; o++) {
-      const d = r[o];
-      if (d === null || typeof d != "object" || Array.isArray(d))
+    const f = g.get(l), r = s.referencesRamps;
+    for (let i = 0; i < r.length; i++) {
+      const u = r[i];
+      if (u === null || typeof u != "object" || Array.isArray(u))
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesRamps[${o}] must be a non-null object`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps[${i}] must be a non-null object`
         );
-      const u = d;
-      if (typeof u.tier != "string" || u.tier.length === 0)
+      const d = u;
+      if (typeof d.tier != "string" || d.tier.length === 0)
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesRamps[${o}].tier must be a non-empty string`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps[${i}].tier must be a non-empty string`
         );
-      if (u.tab !== void 0 && (typeof u.tab != "string" || u.tab.length === 0))
+      if (d.tab !== void 0 && (typeof d.tab != "string" || d.tab.length === 0))
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesRamps[${o}].tab must be a non-empty string when set`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps[${i}].tab must be a non-empty string when set`
         );
-      const m = u.tab === void 0 ? e : u.tab;
+      const p = d.tab === void 0 ? e : d.tab;
       let k;
-      if (m === e)
+      if (p === e)
         k = t;
       else {
         const b = n.find(
-          (p) => p !== null && typeof p == "object" && !Array.isArray(p) && p.id === m
+          (y) => y !== null && typeof y == "object" && !Array.isArray(y) && y.id === p
         );
         if (!b) {
-          const p = n.filter((h) => h !== null && typeof h == "object" && !Array.isArray(h)).map((h) => h.id).join(", ");
+          const y = n.filter((h) => h !== null && typeof h == "object" && !Array.isArray(h)).map((h) => h.id).join(", ");
           throw new Error(
-            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesRamps[${o}]: tab "${m}" does not exist. Available tabs: ${p}.`
+            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps[${i}]: tab "${p}" does not exist. Available tabs: ${y}.`
           );
         }
         k = b;
       }
-      const P = Array.isArray(k.tiers) ? k.tiers : [], S = [];
+      const P = Array.isArray(k.tiers) ? k.tiers : [], j = [];
       let C;
       for (const b of P) {
         if (b === null || typeof b != "object" || Array.isArray(b)) continue;
-        const p = b;
-        typeof p.id == "string" && (S.push(p.id), p.id === u.tier && (C = p));
+        const y = b;
+        typeof y.id == "string" && (j.push(y.id), y.id === d.tier && (C = y));
       }
       if (!C)
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesRamps[${o}]: tier "${u.tier}" does not exist in tab "${m}". Available tiers: ${S.join(", ")}.`
+          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps[${i}]: tier "${d.tier}" does not exist in tab "${p}". Available tiers: ${j.join(", ")}.`
         );
       if (f !== void 0) {
         const b = Array.isArray(C.items) ? C.items : [];
-        let p;
+        let y;
         for (const h of b) {
           if (h === null || typeof h != "object" || Array.isArray(h)) continue;
-          const v = h.type;
-          if (v === null || typeof v != "object" || Array.isArray(v)) continue;
-          const T = v.kind;
+          const E = h.type;
+          if (E === null || typeof E != "object" || Array.isArray(E)) continue;
+          const T = E.kind;
           if (typeof T == "string") {
-            p = T;
+            y = T;
             break;
           }
         }
-        if (p !== void 0 && f !== p)
+        if (y !== void 0 && f !== y)
           throw new Error(
-            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${a}"].referencesRamps[${o}]: referencing semantic tier has kind "${f}" but target tier "${u.tier}" in tab "${m}" has kind "${p}" (cross-tab ramp sources must share the semantic tier's kind)`
+            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps[${i}]: referencing semantic tier has kind "${f}" but target tier "${d.tier}" in tab "${p}" has kind "${y}" (cross-tab ramp sources must share the semantic tier's kind)`
           );
       }
     }
   }
   if (t.colorExtras !== void 0) {
-    const s = t.colorExtras;
-    if (s === null || typeof s != "object" || Array.isArray(s))
+    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 r of ["id", "defaultShikiTheme"])
-      if (typeof s[r] != "string" || s[r].length === 0)
+      if (typeof o[r] != "string" || o[r].length === 0)
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.${r} must be a non-empty string (got ${typeof s[r]})`
+          `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.${r} must be a non-empty string (got ${typeof o[r]})`
         );
     for (const r of ["colorSchemes", "baseRoles", "baseDefaults"])
-      if (s[r] === void 0 || s[r] === null || typeof s[r] != "object" || Array.isArray(s[r]))
+      if (o[r] === void 0 || o[r] === null || typeof o[r] != "object" || Array.isArray(o[r]))
         throw new Error(
           `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.${r} must be a plain object`
         );
-    if (s.panelSettings === void 0 || s.panelSettings === null || typeof s.panelSettings != "object" || Array.isArray(s.panelSettings))
+    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 i = s.panelSettings;
-    if (typeof i.colorScheme != "string" || i.colorScheme.length === 0)
+    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 (i.colorMode !== !1) {
-      if (i.colorMode === null || typeof i.colorMode != "object" || Array.isArray(i.colorMode))
+    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 r = i.colorMode;
-      for (const o of ["lightScheme", "darkScheme"])
-        if (typeof r[o] != "string" || r[o].length === 0)
+      const r = s.colorMode;
+      for (const i of ["lightScheme", "darkScheme"])
+        if (typeof r[i] != "string" || r[i].length === 0)
           throw new Error(
-            `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings.colorMode.${o} must be a non-empty string`
+            `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings.colorMode.${i} must be a non-empty string`
           );
       if (r.defaultMode !== "light" && r.defaultMode !== "dark")
         throw new Error(
           `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings.colorMode.defaultMode must be "light" or "dark" (got ${JSON.stringify(r.defaultMode)})`
         );
     }
+    if (o.semanticDefaults !== void 0) {
+      if (o.semanticDefaults === null || typeof o.semanticDefaults != "object" || Array.isArray(o.semanticDefaults))
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.semanticDefaults must be a plain object`
+        );
+      const r = o.semanticDefaults;
+      for (const [i, u] of Object.entries(r))
+        if (!U(u))
+          throw new Error(
+            `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.semanticDefaults["${i}"] must be a valid SemanticValue (number | 'bg' | 'fg' | { literal: string } | { literal: { light, dark } } | { ref: { tier, item, tab? } }), got ${JSON.stringify(u)}`
+          );
+    }
     const f = t.tiers.find((r) => {
       if (r.referencesTier !== void 0 || r.semantic === !0) return !1;
-      const o = r.items;
-      if (!Array.isArray(o) || o.length === 0) return !1;
-      const d = o[0];
-      if (d === null || typeof d != "object" || Array.isArray(d)) return !1;
-      const u = d.type;
-      return u === null || typeof u != "object" || Array.isArray(u) ? !1 : u.kind === "color";
+      const i = r.items;
+      if (!Array.isArray(i) || i.length === 0) return !1;
+      const u = i[0];
+      if (u === null || typeof u != "object" || Array.isArray(u)) return !1;
+      const d = u.type;
+      return d === null || typeof d != "object" || Array.isArray(d) ? !1 : d.kind === "color";
     });
     if (f) {
-      const r = f.id, o = f.items, d = o[0]?.cssVar;
-      if (d !== void 0) {
-        const u = d.replace(/\d+$/, "{n}");
-        if (u.includes("{n}"))
-          for (let m = 0; m < o.length; m++) {
-            const k = o[m], P = u.replace("{n}", String(m));
+      const r = f.id, i = f.items, u = i[0]?.cssVar;
+      if (u !== void 0) {
+        const d = u.replace(/\d+$/, "{n}");
+        if (d.includes("{n}"))
+          for (let p = 0; p < i.length; p++) {
+            const k = i[p], P = d.replace("{n}", String(p));
             if (k.cssVar !== P)
               throw new Error(
-                `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${r}"].items[${m}].cssVar is ${JSON.stringify(k.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(u)})`
+                `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${r}"].items[${p}].cssVar is ${JSON.stringify(k.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 (o.length > 1)
+        else if (i.length > 1)
           throw new Error(
-            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${r}"].items[0].cssVar ${JSON.stringify(d)} 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")`
+            `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${r}"].items[0].cssVar ${JSON.stringify(u)} 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")`
           );
       }
     }
   }
+  if (e === "notes") {
+    if (t.tiers.length > 0)
+      throw new Error(
+        '[design-token-panel] PanelConfig.tabs["notes"].tiers must be empty — the notes tab does not hold token tiers'
+      );
+    if (t.colorExtras !== void 0)
+      throw new Error(
+        '[design-token-panel] PanelConfig.tabs["notes"].colorExtras must not be set — the notes tab does not carry token config'
+      );
+    if (t.notesExtras === void 0 || t.notesExtras === null || typeof t.notesExtras != "object" || Array.isArray(t.notesExtras))
+      throw new Error(
+        '[design-token-panel] PanelConfig.tabs["notes"].notesExtras must be a plain object with { title, html }'
+      );
+    const o = t.notesExtras;
+    for (const s of ["title", "html"])
+      if (typeof o[s] != "string" || o[s].length === 0)
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["notes"].notesExtras.${s} must be a non-empty string (got ${typeof o[s]})`
+        );
+  } else if (t.notesExtras !== void 0)
+    throw new Error(
+      `[design-token-panel] PanelConfig.tabs["${e}"].notesExtras must only be set on a tab with id "notes"`
+    );
 }
-function be(e = O()) {
+function Ae(e = D()) {
   return e.applyRouting ?? {};
 }
-function we(e) {
+function Se(e) {
   const t = x();
   if (t === null) {
-    y().pendingColorPresets = e;
+    m().pendingColorPresets = e;
     return;
   }
   t.config = { ...t.config, colorPresets: e };
 }
 export {
-  ee as A,
-  de as B,
-  Y as C,
-  q as D,
-  le as E,
-  fe as F,
-  te as _,
-  ce as a,
-  re as b,
-  X as c,
-  ie as d,
-  he as e,
-  se as f,
-  O as g,
-  ae as h,
-  oe as i,
-  ge as j,
-  A as k,
-  _ as l,
-  me as m,
-  ye as n,
-  G as o,
-  U as p,
-  ne as q,
-  W as r,
-  we as s,
-  be as t,
-  R as u,
-  pe as v,
-  I as w,
-  Q as x,
-  ue as y,
-  Z as z
+  Pe as A,
+  Ae as B,
+  V as C,
+  $e as D,
+  I as E,
+  te as F,
+  ke as G,
+  q as H,
+  ne as I,
+  re as J,
+  we as K,
+  ie as _,
+  he as a,
+  fe as b,
+  ee as c,
+  ce as d,
+  ge as e,
+  ve as f,
+  D as g,
+  de as h,
+  Ee as i,
+  pe as j,
+  ue as k,
+  be as l,
+  se as m,
+  le as n,
+  Y as o,
+  Z as p,
+  ye as q,
+  Q as r,
+  Se as s,
+  me as t,
+  X as u,
+  oe as v,
+  ae as w,
+  M as x,
+  S as y,
+  Ce as z
 };