@takazudo/zdtp 0.4.4 → 0.4.5

package/dist/{panel-config-CXTCcYQs.js → panel-config-CipeKMTz.js}

@@ -3,65 +3,65 @@ 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 W(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);
+    const o = $(f, s ?? n);
     if (!o) {
-      const d = $(f, c.default) ?? $(f, n) ?? f.items[0];
-      if (!d)
+      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 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 Y(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 D(e, t, n = [t]) {
+  const a = e.tab === void 0 || e.tab === t.id ? t : n.find((i) => i.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((i) => i.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((i) => i.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((i) => i.id).join(", ")}.`
     );
   return c.cssVar;
 }
-function W(e, t) {
+function I(e, t) {
   return e.paletteCssVarTemplate.replace("{n}", String(t));
 }
 const M = /* @__PURE__ */ new Set([
@@ -224,36 +224,36 @@ const M = /* @__PURE__ */ new Set([
 function H(e) {
   return e.startsWith("#") || e.includes("(") || M.has(e.toLowerCase());
 }
-function N(e, t, n, l) {
+function N(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 [i] = t;
+  g.push({ tab: i.tab, tier: i.tier, item: e });
+  for (const s of g)
     try {
-      return _(i, n, l), { ref: i };
+      return D(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 i = t.get(e.default);
+  return i !== void 0 ? i : e.default === "bg" || e.default === "fg" ? e.default : n && n.length > 0 && !H(e.default) ? N(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(
+  const a = e.tiers.find(
     (o) => !o.referencesTier && !o.semantic && o.items.length > 0 && o.items[0].type.kind === "color"
   ), g = e.tiers.find(
-    (o) => l && o.referencesTier === l.id || o.semantic === !0
+    (o) => a && o.referencesTier === a.id || o.semantic === !0
   );
-  if (!l && !g)
+  if (!a && !g)
     return {
       id: n.id,
       label: n.label,
@@ -267,16 +267,16 @@ 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();
+  const c = a?.items ?? [], i = c.length, s = c[0] ? c[0].cssVar.replace(/\d+$/, "{n}") : "--zudo-stub-p{n}", l = /* @__PURE__ */ new Map();
   for (let o = 0; o < c.length; o++)
-    a.set(c[o].id, o);
+    l.set(c[o].id, o);
   const f = {}, r = {};
   if (g) {
-    const o = !g.semantic;
+    const o = !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,
@@ -286,9 +286,9 @@ function R(e, t = [e]) {
   return {
     id: n.id,
     label: n.label,
-    paletteSize: s,
+    paletteSize: i,
     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 X(e) {
   const t = e.find((n) => n.id === "color");
   if (t)
-    return R(t, e);
+    return V(t, e);
 }
 function z(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 O = {
   storagePrefix: "zudo-design-token-panel",
   consoleNamespace: "zudo",
   modalClassPrefix: "zudo-design-token-panel-modal",
@@ -336,19 +336,20 @@ const V = {
   // No bundled apply endpoint / routing — hosts wire their own.
   applyEndpoint: void 0,
   applyRouting: void 0
-}, j = /* @__PURE__ */ Symbol.for("@takazudo/zdtp:singleton");
+}, R = /* @__PURE__ */ Symbol.for("@takazudo/zdtp:singleton");
 function y() {
   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() {
@@ -370,7 +371,7 @@ function D(e) {
     }
   };
 }
-function I(e) {
+function Q(e) {
   y().lifecycleHooks = {
     configured: e.configured,
     open: e.open,
@@ -379,40 +380,40 @@ function I(e) {
     destroy: e.destroy
   };
 }
-function X(e) {
-  const t = y(), n = e.storagePrefix, l = t.instances.get(n);
-  if (l) {
+function Z(e) {
+  const t = y(), 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 i = t.instances.size === 0, s = i ? [...t.pendingPostConfigureHooks] : [];
+  i && (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();
   return e.defaultPrefix === null ? null : e.instances.get(e.defaultPrefix) ?? null;
 }
-function Q(e) {
+function ee(e) {
   const t = x();
   if (t === null) {
     const n = y();
@@ -422,67 +423,83 @@ function Q(e) {
   }
   t.postConfigureHooks.includes(e) || (t.postConfigureHooks.push(e), e());
 }
-function O() {
-  return x()?.config ?? V;
+function _() {
+  return x()?.config ?? O;
 }
-function Z() {
+function te() {
   return [...y().instances.values()].map((e) => e.config);
 }
-function ee(e) {
+function ne(e) {
   return y().instances.get(e)?.config ?? null;
 }
-function te() {
+function re() {
+  const e = y();
+  e.instances.clear(), e.defaultPrefix = null, e.pendingColorPresets = null, e.pendingPostConfigureHooks.length = 0, v().clear();
+}
+function v() {
   const e = y();
-  e.instances.clear(), e.defaultPrefix = null, e.pendingColorPresets = null, e.pendingPostConfigureHooks.length = 0;
+  return e.colorSchemeOwners || (e.colorSchemeOwners = /* @__PURE__ */ new Set()), e.colorSchemeOwners;
 }
-function ne(e = O()) {
+function ie(e) {
+  v().add(e);
+}
+function oe(e) {
+  v().delete(e);
+}
+function se(e) {
+  return v().has(e);
+}
+function ae(e = _()) {
   return z(e.tabs);
 }
-function re(e) {
+function le(e) {
   return `${e.storagePrefix}-state-v2`;
 }
-function ie(e) {
+function fe(e) {
   return `${e.storagePrefix}-state-v3`;
 }
-function oe(e) {
+function ce(e) {
+  return `${e.storagePrefix}-state-v4`;
+}
+function ge(e) {
   return `${e.storagePrefix}-state`;
 }
-function se(e) {
+function ue(e) {
   return `${e.storagePrefix}-open`;
 }
-function ae(e) {
+function de(e) {
   return `${e.storagePrefix}-position`;
 }
-function le(e) {
+function pe(e) {
   return `${e.storagePrefix}-size`;
 }
-function fe(e) {
+function ye(e) {
   return `${e.storagePrefix}-density`;
 }
-function ce(e) {
+function me(e) {
   return `${e.storagePrefix}:visible`;
 }
-function ge(e) {
+function he(e) {
   return `${e.storagePrefix}:autoload`;
 }
-function de(e) {
+function be(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 q = O.storagePrefix, L = "toggle-design-token-panel";
+function we(e) {
+  return e.storagePrefix === q ? L : e.toggleEvent ?? `toggle-${e.storagePrefix}`;
 }
-const L = "__zdtp:open-state-changed";
-function pe(e) {
-  return `${L}:${e.storagePrefix}`;
+const J = "__zdtp:open-state-changed";
+function ke(e) {
+  return `${J}:${e.storagePrefix}`;
 }
-function ye(e, t) {
+function $e(e, t) {
   return `${e.modalClassPrefix}${t}`;
 }
-function me(e) {
+function Ce(e) {
   return `${e.exportFilenameBase}.json`;
 }
-function he(e) {
+function Pe(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 +514,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 +525,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 +534,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), U(a.id, a, e);
+  }
+}
+function G(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 B(e, t, n) {
+function U(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 i of t.tiers) {
+    if (i === null || typeof i != "object" || Array.isArray(i))
       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 = i;
+    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 u = o.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 i of t.tiers) {
+    const s = i, 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,61 +641,61 @@ 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 "--"`
         );
     }
   }
-  for (const s of t.tiers) {
-    const i = s, a = i.id;
-    if (i.referencesTier !== void 0) {
-      if (typeof i.referencesTier != "string")
+  for (const i of t.tiers) {
+    const s = i, 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);
+      const r = g.get(l), o = g.get(f);
       if (r !== void 0 && o !== void 0 && r !== "text" && r !== o)
         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 "${o}" (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 i of t.tiers) {
+    const s = i, 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;
+    const f = g.get(l), r = s.referencesRamps;
     for (let o = 0; o < r.length; o++) {
-      const d = r[o];
-      if (d === null || typeof d != "object" || Array.isArray(d))
+      const u = r[o];
+      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[${o}] 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[${o}].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[${o}].tab must be a non-empty string when set`
         );
-      const m = u.tab === void 0 ? e : u.tab;
+      const m = d.tab === void 0 ? e : d.tab;
       let k;
       if (m === e)
         k = t;
@@ -670,30 +706,30 @@ function B(e, t, n) {
         if (!b) {
           const p = 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[${o}]: tab "${m}" does not exist. Available tabs: ${p}.`
           );
         }
         k = b;
       }
-      const P = Array.isArray(k.tiers) ? k.tiers : [], S = [];
-      let C;
-      for (const b of P) {
+      const C = Array.isArray(k.tiers) ? k.tiers : [], j = [];
+      let P;
+      for (const b of C) {
         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));
+        typeof p.id == "string" && (j.push(p.id), p.id === d.tier && (P = p));
       }
-      if (!C)
+      if (!P)
         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[${o}]: tier "${d.tier}" does not exist in tab "${m}". Available tiers: ${j.join(", ")}.`
         );
       if (f !== void 0) {
-        const b = Array.isArray(C.items) ? C.items : [];
+        const b = Array.isArray(P.items) ? P.items : [];
         let p;
         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;
             break;
@@ -701,42 +737,42 @@ function B(e, t, n) {
         }
         if (p !== void 0 && f !== p)
           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[${o}]: referencing semantic tier has kind "${f}" but target tier "${d.tier}" in tab "${m}" has kind "${p}" (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 i = t.colorExtras;
+    if (i === null || typeof i != "object" || Array.isArray(i))
       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 i[r] != "string" || i[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 i[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 (i[r] === void 0 || i[r] === null || typeof i[r] != "object" || Array.isArray(i[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 (i.panelSettings === void 0 || i.panelSettings === null || typeof i.panelSettings != "object" || Array.isArray(i.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 = i.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;
+      const r = s.colorMode;
       for (const o of ["lightScheme", "darkScheme"])
         if (typeof r[o] != "string" || r[o].length === 0)
           throw new Error(
@@ -747,39 +783,51 @@ function B(e, t, n) {
           `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings.colorMode.defaultMode must be "light" or "dark" (got ${JSON.stringify(r.defaultMode)})`
         );
     }
+    if (i.semanticDefaults !== void 0) {
+      if (i.semanticDefaults === null || typeof i.semanticDefaults != "object" || Array.isArray(i.semanticDefaults))
+        throw new Error(
+          `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.semanticDefaults must be a plain object`
+        );
+      const r = i.semanticDefaults;
+      for (const [o, u] of Object.entries(r))
+        if (!G(u))
+          throw new Error(
+            `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.semanticDefaults["${o}"] 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 u = o[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}"))
+      const r = f.id, o = f.items, u = o[0]?.cssVar;
+      if (u !== void 0) {
+        const d = u.replace(/\d+$/, "{n}");
+        if (d.includes("{n}"))
           for (let m = 0; m < o.length; m++) {
-            const k = o[m], P = u.replace("{n}", String(m));
-            if (k.cssVar !== P)
+            const k = o[m], C = d.replace("{n}", String(m));
+            if (k.cssVar !== C)
               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[${m}].cssVar is ${JSON.stringify(k.cssVar)} but expected ${JSON.stringify(C)} — 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)
           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")`
           );
       }
     }
   }
 }
-function be(e = O()) {
+function Ee(e = _()) {
   return e.applyRouting ?? {};
 }
-function we(e) {
+function ve(e) {
   const t = x();
   if (t === null) {
     y().pendingColorPresets = e;
@@ -788,37 +836,41 @@ function we(e) {
   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,
+  te as A,
+  ne as B,
+  be as C,
+  L as D,
+  X as E,
+  oe as F,
+  pe as G,
+  ye as H,
+  ie as I,
+  se as J,
+  re as _,
+  me as a,
+  le as b,
+  Z as c,
+  fe as d,
+  ce as e,
+  Pe as f,
+  _ as g,
+  ue as h,
+  de 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,
+  he as k,
+  S as l,
+  D as m,
+  Ce as n,
+  $e as o,
+  W as p,
+  Y as q,
+  I as r,
+  ve as s,
+  ae as t,
+  Ee as u,
+  V as v,
+  ke as w,
   Q as x,
-  ue as y,
-  Z as z
+  ee as y,
+  we as z
 };