@takazudo/zdtp 0.4.5 → 0.4.7

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

@@ -9,7 +9,7 @@ function A(e, t) {
 function $(e, t) {
   return e.items.find((n) => n.id === t);
 }
-function W(e, t, n, a) {
+function Y(e, t, n, a) {
   const g = A(e, t);
   if (!g)
     throw new w(
@@ -27,8 +27,8 @@ function W(e, t, n, a) {
       throw new w(
         `Tier "${t}" declares referencesTier "${l}" but that tier does not exist in tab "${e.id}".`
       );
-    const o = $(f, s ?? n);
-    if (!o) {
+    const i = $(f, s ?? n);
+    if (!i) {
       const u = $(f, c.default) ?? $(f, n) ?? f.items[0];
       if (!u)
         throw new w(
@@ -36,35 +36,35 @@ function W(e, t, n, a) {
         );
       return { kind: "ref", targetCssVar: u.cssVar };
     }
-    return { kind: "ref", targetCssVar: o.cssVar };
+    return { kind: "ref", targetCssVar: i.cssVar };
   }
   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 Y(e) {
+function Z(e) {
   return e.kind === "literal" ? e.value : `var(${e.targetCssVar})`;
 }
-function D(e, t, n = [t]) {
-  const a = e.tab === void 0 || e.tab === t.id ? t : n.find((i) => i.id === e.tab);
+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((i) => i.id).join(", ")}.`
+      `Cross-tab ref target tab "${e.tab}" not found. Available tabs: ${n.map((o) => o.id).join(", ")}.`
     );
   const g = A(a, e.tier);
   if (!g)
     throw new w(
-      `Cross-tab ref target tier "${e.tier}" not found in tab "${a.id}". Available tiers: ${a.tiers.map((i) => i.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 "${a.id}". Available items: ${g.items.map((i) => i.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 I(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,27 +221,27 @@ 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, a) {
+function H(e, t, n, a) {
   const g = [], c = e.indexOf(":");
   if (c !== -1) {
     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 [i] = t;
-  g.push({ tab: i.tab, tier: i.tier, item: e });
+  const [o] = t;
+  g.push({ tab: o.tab, tier: o.tier, item: e });
   for (const s of g)
     try {
-      return D(s, n, a), { ref: s };
+      return M(s, n, a), { ref: s };
     } catch {
     }
   return { ref: g[0] };
 }
 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(
+  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 };
 }
@@ -249,9 +249,9 @@ function V(e, t = [e]) {
   const n = e.colorExtras;
   if (!n) return;
   const a = e.tiers.find(
-    (o) => !o.referencesTier && !o.semantic && o.items.length > 0 && o.items[0].type.kind === "color"
+    (i) => !i.referencesTier && !i.semantic && i.items.length > 0 && i.items[0].type.kind === "color"
   ), g = e.tiers.find(
-    (o) => a && o.referencesTier === a.id || o.semantic === !0
+    (i) => a && i.referencesTier === a.id || i.semantic === !0
   );
   if (!a && !g)
     return {
@@ -267,12 +267,12 @@ function V(e, t = [e]) {
       colorSchemes: n.colorSchemes,
       panelSettings: n.panelSettings
     };
-  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++)
-    l.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, u = n.semanticDefaults;
+    const i = !g.semantic, u = n.semanticDefaults;
     for (const d of g.items)
       r[d.id] = d.cssVar, f[d.id] = u && d.id in u ? u[d.id] : K(
         d,
@@ -280,13 +280,13 @@ function V(e, t = [e]) {
         g.referencesRamps,
         e,
         t,
-        o
+        i
       );
   }
   return {
     id: n.id,
     label: n.label,
-    paletteSize: i,
+    paletteSize: o,
     baseRoles: n.baseRoles,
     paletteCssVarTemplate: s,
     semanticDefaults: f,
@@ -297,12 +297,12 @@ function V(e, t = [e]) {
     panelSettings: n.panelSettings
   };
 }
-function X(e) {
+function Q(e) {
   const t = e.find((n) => n.id === "color");
   if (t)
     return V(t, e);
 }
-function z(e) {
+function L(e) {
   const t = e.find((n) => n.id === "color-secondary");
   return t ? V(t, e) ?? null : null;
 }
@@ -324,7 +324,7 @@ function S(e, t) {
       return !1;
   return !0;
 }
-const O = {
+const _ = {
   storagePrefix: "zudo-design-token-panel",
   consoleNamespace: "zudo",
   modalClassPrefix: "zudo-design-token-panel-modal",
@@ -337,7 +337,7 @@ const O = {
   applyEndpoint: void 0,
   applyRouting: void 0
 }, R = /* @__PURE__ */ Symbol.for("@takazudo/zdtp:singleton");
-function y() {
+function m() {
   const e = globalThis;
   let t = e[R];
   return t || (t = {
@@ -353,17 +353,17 @@ 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,8 +371,8 @@ function F(e) {
     }
   };
 }
-function Q(e) {
-  y().lifecycleHooks = {
+function I(e) {
+  m().lifecycleHooks = {
     configured: e.configured,
     open: e.open,
     close: e.close,
@@ -380,8 +380,8 @@ function Q(e) {
     destroy: e.destroy
   };
 }
-function Z(e) {
-  const t = y(), n = e.storagePrefix, a = t.instances.get(n);
+function ee(e) {
+  const t = m(), n = e.storagePrefix, a = t.instances.get(n);
   if (a) {
     const f = (r) => ({ ...r, applySink: void 0 });
     if (S(f(a.suppliedConfig), f(e)))
@@ -392,8 +392,8 @@ function Z(e) {
   }
   const g = t.pendingColorPresets, c = g ? { ...e, colorPresets: g } : { ...e };
   t.pendingColorPresets = null;
-  const i = t.instances.size === 0, s = i ? [...t.pendingPostConfigureHooks] : [];
-  i && (t.pendingPostConfigureHooks.length = 0);
+  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
@@ -410,96 +410,110 @@ function Z(e) {
   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 ee(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 _() {
-  return x()?.config ?? O;
+function D() {
+  return x()?.config ?? _;
 }
-function te() {
-  return [...y().instances.values()].map((e) => e.config);
+function ne() {
+  return [...m().instances.values()].map((e) => e.config);
 }
-function ne(e) {
-  return y().instances.get(e)?.config ?? null;
+function re(e) {
+  return m().instances.get(e)?.config ?? null;
 }
-function re() {
-  const e = y();
+function ie() {
+  const e = m();
   e.instances.clear(), e.defaultPrefix = null, e.pendingColorPresets = null, e.pendingPostConfigureHooks.length = 0, v().clear();
 }
 function v() {
-  const e = y();
+  const e = m();
   return e.colorSchemeOwners || (e.colorSchemeOwners = /* @__PURE__ */ new Set()), e.colorSchemeOwners;
 }
-function ie(e) {
+function oe(e) {
   v().add(e);
 }
-function oe(e) {
+function se(e) {
   v().delete(e);
 }
-function se(e) {
+function ae(e) {
   return v().has(e);
 }
-function ae(e = _()) {
-  return z(e.tabs);
-}
-function le(e) {
-  return `${e.storagePrefix}-state-v2`;
+function le(e = D()) {
+  return L(e.tabs);
 }
 function fe(e) {
-  return `${e.storagePrefix}-state-v3`;
+  return `${e.storagePrefix}-state-v2`;
 }
 function ce(e) {
-  return `${e.storagePrefix}-state-v4`;
+  return `${e.storagePrefix}-state-v3`;
 }
 function ge(e) {
-  return `${e.storagePrefix}-state`;
+  return `${e.storagePrefix}-state-v4`;
 }
 function ue(e) {
-  return `${e.storagePrefix}-open`;
+  return `${e.storagePrefix}-state`;
 }
 function de(e) {
-  return `${e.storagePrefix}-position`;
+  return `${e.storagePrefix}-open`;
 }
 function pe(e) {
-  return `${e.storagePrefix}-size`;
+  return `${e.storagePrefix}-position`;
 }
 function ye(e) {
-  return `${e.storagePrefix}-density`;
+  return `${e.storagePrefix}-size`;
 }
 function me(e) {
-  return `${e.storagePrefix}:visible`;
+  return `${e.storagePrefix}-density`;
 }
 function he(e) {
-  return `${e.storagePrefix}:autoload`;
+  return `${e.storagePrefix}:visible`;
 }
 function be(e) {
-  return `${e.storagePrefix}-root`;
+  return `${e.storagePrefix}:autoload`;
 }
-const q = O.storagePrefix, L = "toggle-design-token-panel";
 function we(e) {
-  return e.storagePrefix === q ? L : e.toggleEvent ?? `toggle-${e.storagePrefix}`;
+  return `${e.storagePrefix}-root`;
 }
-const J = "__zdtp:open-state-changed";
+const J = _.storagePrefix, q = "toggle-design-token-panel";
 function ke(e) {
-  return `${J}:${e.storagePrefix}`;
+  return e.storagePrefix === J ? q : e.toggleEvent ?? `toggle-${e.storagePrefix}`;
 }
-function $e(e, t) {
+const G = "__zdtp:open-state-changed";
+function $e(e) {
+  return `${G}:${e.storagePrefix}`;
+}
+function Pe(e, t) {
   return `${e.modalClassPrefix}${t}`;
 }
 function Ce(e) {
   return `${e.exportFilenameBase}.json`;
 }
-function Pe(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;
@@ -555,10 +569,10 @@ function B(e) {
       throw new Error(
         `[design-token-panel] PanelConfig.tabs: duplicate tab id "${a.id}"`
       );
-    t.add(a.id), U(a.id, a, e);
+    t.add(a.id), W(a.id, a, e);
   }
 }
-function G(e) {
+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;
@@ -577,18 +591,18 @@ function G(e) {
   }
   return !1;
 }
-function U(e, t, n) {
+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 a = /* @__PURE__ */ new Set(), g = /* @__PURE__ */ new Map();
-  for (const i of t.tiers) {
-    if (i === null || typeof i != "object" || Array.isArray(i))
+  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 = i;
+    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`
@@ -608,9 +622,9 @@ function U(e, t, n) {
     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 u = o.kind;
+      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;
@@ -623,8 +637,8 @@ function U(e, t, n) {
     l !== void 0 && g.set(s.id, l);
   }
   const c = /* @__PURE__ */ new Set();
-  for (const i of t.tiers) {
-    const s = i, l = s.id;
+  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(
@@ -647,10 +661,30 @@ function U(e, t, n) {
         throw new Error(
           `[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 i of t.tiers) {
-    const s = i, l = s.id;
+  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(
@@ -661,15 +695,15 @@ function U(e, t, n) {
         throw new Error(
           `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesTier: tier "${f}" does not exist in this tab`
         );
-      const r = g.get(l), 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["${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")`
+          `[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 i of t.tiers) {
-    const s = i, l = s.id;
+  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(
@@ -680,89 +714,89 @@ function U(e, t, n) {
         `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps must be an array`
       );
     const f = g.get(l), r = s.referencesRamps;
-    for (let o = 0; o < r.length; o++) {
-      const u = r[o];
+    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["${l}"].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 d = u;
       if (typeof d.tier != "string" || d.tier.length === 0)
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].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 (d.tab !== void 0 && (typeof d.tab != "string" || d.tab.length === 0))
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].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 = d.tab === void 0 ? e : d.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["${l}"].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 C = Array.isArray(k.tiers) ? k.tiers : [], j = [];
-      let P;
-      for (const b of C) {
+      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" && (j.push(p.id), p.id === d.tier && (P = p));
+        const y = b;
+        typeof y.id == "string" && (j.push(y.id), y.id === d.tier && (C = y));
       }
-      if (!P)
+      if (!C)
         throw new Error(
-          `[design-token-panel] PanelConfig.tabs["${e}"].tiers["${l}"].referencesRamps[${o}]: tier "${d.tier}" does not exist in tab "${m}". Available tiers: ${j.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(P.items) ? P.items : [];
-        let p;
+        const b = Array.isArray(C.items) ? C.items : [];
+        let y;
         for (const h of b) {
           if (h === null || typeof h != "object" || Array.isArray(h)) continue;
           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["${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)`
+            `[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 i = t.colorExtras;
-    if (i === null || typeof i != "object" || Array.isArray(i))
+    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 i[r] != "string" || i[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 i[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 (i[r] === void 0 || i[r] === null || typeof i[r] != "object" || Array.isArray(i[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 (i.panelSettings === void 0 || i.panelSettings === null || typeof i.panelSettings != "object" || Array.isArray(i.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 s = i.panelSettings;
+    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`
@@ -773,104 +807,128 @@ function U(e, t, n) {
           `[design-token-panel] PanelConfig.tabs["${e}"].colorExtras.panelSettings.colorMode must be false or a plain object`
         );
       const r = s.colorMode;
-      for (const o of ["lightScheme", "darkScheme"])
-        if (typeof r[o] != "string" || r[o].length === 0)
+      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 (i.semanticDefaults !== void 0) {
-      if (i.semanticDefaults === null || typeof i.semanticDefaults != "object" || Array.isArray(i.semanticDefaults))
+    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 = i.semanticDefaults;
-      for (const [o, u] of Object.entries(r))
-        if (!G(u))
+      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["${o}"] must be a valid SemanticValue (number | 'bg' | 'fg' | { literal: string } | { literal: { light, dark } } | { ref: { tier, item, tab? } }), got ${JSON.stringify(u)}`
+            `[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 u = o[0];
+      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, u = o[0]?.cssVar;
+      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 m = 0; m < o.length; m++) {
-            const k = o[m], C = d.replace("{n}", String(m));
-            if (k.cssVar !== C)
+          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(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)})`
+                `[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(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 Ee(e = _()) {
+function Ae(e = D()) {
   return e.applyRouting ?? {};
 }
-function ve(e) {
+function Se(e) {
   const t = x();
   if (t === null) {
-    y().pendingColorPresets = e;
+    m().pendingColorPresets = e;
     return;
   }
   t.config = { ...t.config, colorPresets: e };
 }
 export {
-  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,
-  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,
-  ee as y,
-  we 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
 };