@takazudo/zdtp 0.4.8 → 0.4.10

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 0.4.10
+
+### Fixed
+
+- fix: guard deferred DOM access against torn-down documents — async adapter closures, public entry points, and Preact effect-flush paths now cancel quietly instead of throwing `document.getElementById is not a function` as an unhandled rejection when the host environment tears down or swaps the document mid-flight (reported downstream as zudolab/zudo-doc#3344) ([#568](https://github.com/Takazudo/zudo-design-token-panel/pull/568)) (4b5551a)
+- fix: close straggler-state leaks in the document-teardown guards — a cancelled show no longer arms autoload, the open-state persistence effect cannot clobber seeded visibility, and a nulled `document` global is treated as dead ([#568](https://github.com/Takazudo/zudo-design-token-panel/pull/568)) (28b02b1)
+- fix: null-tolerant liveness guards on the lifecycle bind paths ([#568](https://github.com/Takazudo/zudo-design-token-panel/pull/568)) (0774ea8)
+
+### Other Changes
+
+- docs: migrate the doc site to zudo-doc 4.x — S1–S6 series ([#556](https://github.com/Takazudo/zudo-design-token-panel/pull/556)–[#562](https://github.com/Takazudo/zudo-design-token-panel/pull/562)) (e2f36b5, 51c674c, ff38109, e36e718, e7838fb, c20cc83, f89a6bf)
+- docs(l-make-release): auto-proceed Step 3 gate for routine bumps (45a5aca)
+
+## 0.4.9
+
+### Features
+
+- feat: add color picker close button ([#542](https://github.com/Takazudo/zudo-design-token-panel/pull/542)) (8596353)
+- feat(zdtp): clean up semantic color rows ([#544](https://github.com/Takazudo/zudo-design-token-panel/pull/544)) (849e0ad)
+
+### Fixed
+
+- fix: enforce color picker close hit target ([#546](https://github.com/Takazudo/zudo-design-token-panel/pull/546)) (85c9acd)
+- fix(panel): add palette check view styles ([#543](https://github.com/Takazudo/zudo-design-token-panel/pull/543)) (a6a1fa2)
+
+### Other Changes
+
+- docs: fix apply pipeline heading anchor ([#554](https://github.com/Takazudo/zudo-design-token-panel/pull/554)) (13afef6)
+- docs: refresh palette check mode guide ([#545](https://github.com/Takazudo/zudo-design-token-panel/pull/545)) (4ab2ce3)
+- test: record color picker close control VRT (aa66eba)
+- chore: start panel UI tweaks 540 (57fb4c7)
+
 ## 0.4.8
 
 ### Features

package/dist/astro/host-adapter.js

@@ -1,115 +1,128 @@
-import { c as h, g as u, a as g, b as y, d as P, e as b, f as _, i as A } from "../panel-config-BNLlUc_r.js";
-import { g as d, Z as k } from "../tweak-state-Dti6XMoQ.js";
-import { s as I, l as E, a as T, b as c, c as C, d as S } from "../autoload-state-CFmRjtD-.js";
-const r = "tokenpanel-config";
-function v() {
+import { c as P, g as p, a as m, b as D, d as _, e as A, f as k, i as I } from "../panel-config-BNLlUc_r.js";
+import { g, Z as E } from "../tweak-state-Dti6XMoQ.js";
+import { s as T, l as S, a as C, i as c, b as f, c as V, d as v, e as d } from "../autoload-state-CEkOpbGS.js";
+const u = "tokenpanel-config";
+function K() {
   if (typeof document > "u")
     throw new Error(
       "[design-token-panel] host-adapter loaded without a document; expected to run in a browser context."
     );
-  const e = document.getElementById(r);
-  if (!e)
+  const n = document.getElementById(u);
+  if (!n)
     throw new Error(
-      `[design-token-panel] Inline config script #${r} not found. Ensure <DesignTokenPanelHost config={...} /> is rendered on this page before the host script runs.`
+      `[design-token-panel] Inline config script #${u} not found. Ensure <DesignTokenPanelHost config={...} /> is rendered on this page before the host script runs.`
     );
-  const o = e.textContent ?? "";
-  let n;
+  const t = n.textContent ?? "";
+  let e;
   try {
-    n = JSON.parse(o);
+    e = JSON.parse(t);
   } catch (a) {
     throw new Error(
-      `[design-token-panel] Failed to parse inline config from #${r}: ${a.message}`
+      `[design-token-panel] Failed to parse inline config from #${u}: ${a.message}`
     );
   }
-  return _(n), n;
+  return k(e), e;
 }
-function D(e) {
-  return e.__zudoDesignTokenPanelAdapter || (e.__zudoDesignTokenPanelAdapter = {}), e.__zudoDesignTokenPanelAdapter;
+function M(n) {
+  return n.__zudoDesignTokenPanelAdapter || (n.__zudoDesignTokenPanelAdapter = {}), n.__zudoDesignTokenPanelAdapter;
 }
-function V(e, o) {
-  const n = D(e);
-  let a = n[o];
-  return a || (a = { bound: !1, modulePromise: null }, n[o] = a), a;
+function O(n, t) {
+  const e = M(n);
+  let a = e[t];
+  return a || (a = { bound: !1, modulePromise: null }, e[t] = a), a;
 }
-function K(e) {
+function x(n) {
   try {
-    return window.localStorage.getItem(e) === "1";
+    return window.localStorage.getItem(n) === "1";
   } catch {
     return !1;
   }
 }
-function M(e, o, n) {
+function N(n, t, e) {
   try {
     const a = window.localStorage;
-    return a.getItem(n) !== null || a.getItem(o) !== null || a.getItem(e) !== null;
+    return a.getItem(e) !== null || a.getItem(t) !== null || a.getItem(n) !== null;
   } catch {
     return !1;
   }
 }
-async function i(e) {
-  return e.modulePromise === null && (e.modulePromise = import("@takazudo/zdtp").then((o) => {
+async function r(n) {
+  return n.modulePromise === null && (n.modulePromise = import("@takazudo/zdtp").then((t) => {
     try {
-      const n = u(), a = o.__panelConfigForTest();
-      n !== a && console.warn(
+      const e = p(), a = t.__panelConfigForTest();
+      e !== a && console.warn(
         "[design-token-panel] Singleton-sharing check failed: the host adapter and the panel module observed different PanelConfig singletons. This indicates the package's `config/panel-config` module is no longer code-split into a single shared chunk. The panel may behave correctly today, but storage keys / namespaces / branding could diverge between the two surfaces in future bundles."
       );
-    } catch (n) {
+    } catch (e) {
       console.warn(
-        "[design-token-panel] Singleton-sharing check could not run (likely an older dist without the __panelConfigForTest accessor): " + n.message
+        "[design-token-panel] Singleton-sharing check could not run (likely an older dist without the __panelConfigForTest accessor): " + e.message
       );
     }
-    return o;
-  })), e.modulePromise;
+    return t;
+  })), n.modulePromise;
 }
-function O(e, o, n, a, t) {
-  const l = e[o] ?? {};
-  l.showDesignPanel = async () => {
-    c(t, !0), await i(n), a.open();
-  }, l.hideDesignPanel = async () => {
-    await i(n), a.close();
-  }, l.toggleDesignPanel = async () => {
-    await i(n), a.toggle();
-    let s = !1;
+function R(n, t, e, a, o) {
+  const i = n[t] ?? {};
+  i.showDesignPanel = async () => {
+    const s = d();
+    await r(e), c(s) && (f(o, !0), a.open());
+  }, i.hideDesignPanel = async () => {
+    const s = d();
+    await r(e), c(s) && a.close();
+  }, i.toggleDesignPanel = async () => {
+    const s = d();
+    if (await r(e), !c(s)) return;
+    a.toggle();
+    let l = !1;
     try {
-      s = window.localStorage.getItem(d(t)) === "1";
+      l = window.localStorage.getItem(g(o)) === "1";
     } catch {
     }
-    s && c(t, !0);
-  }, l.enableAutoload = async () => {
-    (await i(n)).enableAutoload(t);
-  }, l.disableAutoload = async () => {
-    if (n.modulePromise !== null) {
-      (await i(n)).disableAutoload(t);
+    l && f(o, !0);
+  }, i.enableAutoload = async () => {
+    const s = d(), l = await r(e);
+    c(s) && l.enableAutoload(o);
+  }, i.disableAutoload = async () => {
+    const s = d();
+    if (e.modulePromise !== null) {
+      const l = await r(e);
+      if (!c(s)) return;
+      l.disableAutoload(o);
       return;
     }
-    C(t), S(!1, t);
+    V(o), v(!1, o);
     try {
-      window.localStorage.setItem(g(t), "0");
+      window.localStorage.setItem(m(o), "0");
     } catch {
     }
     try {
-      window.localStorage.removeItem(d(t));
+      window.localStorage.removeItem(g(o));
     } catch {
     }
-  }, e[o] = l;
+  }, n[t] = i;
 }
-function x(e, o) {
-  A({
+function F(n, t) {
+  I({
     show: async () => {
-      await i(e), o.open();
+      const e = d();
+      await r(n), c(e) && t.open();
     },
     hide: async () => {
-      await i(e), o.close();
+      const e = d();
+      await r(n), c(e) && t.close();
     },
     toggle: async () => {
-      await i(e), o.toggle();
+      const e = d();
+      await r(n), c(e) && t.toggle();
     }
   });
 }
 (function() {
-  const o = v(), n = o.legacyIdRenameMap ? o : { ...o, legacyIdRenameMap: { ...k } }, a = h(n), t = u(), l = window, s = V(l, t.storagePrefix);
-  if (O(l, t.consoleNamespace, s, a, t), x(s, a), s.bound) return;
+  const t = K(), e = t.legacyIdRenameMap ? t : { ...t, legacyIdRenameMap: { ...E } }, a = P(e), o = p(), i = window, s = O(i, o.storagePrefix);
+  if (R(i, o.consoleNamespace, s, a, o), F(s, a), s.bound) return;
   s.bound = !0;
-  const p = g(t), f = y(t), m = P(t), w = b(t);
-  (K(p) || M(f, m, w) || I(t) || E(t) || t.domTweaker !== void 0 && T(t)) && i(s);
+  const l = m(o), w = D(o), h = _(o), y = A(o);
+  (x(l) || N(w, h, y) || T(o) || S(o) || o.domTweaker !== void 0 && C(o)) && r(s).catch((b) => {
+    console.error("[design-token-panel] Eager panel-module load failed.", b);
+  });
 })();

package/dist/autoload-state-CEkOpbGS.js

@@ -0,0 +1,76 @@
+import { g as t, l as a } from "./panel-config-BNLlUc_r.js";
+function l() {
+  return typeof document < "u" && document !== null && typeof document.getElementById == "function";
+}
+function c() {
+  return typeof document > "u" || document === null ? null : document;
+}
+function d(e) {
+  return e !== null && l() && document === e;
+}
+function o(e = t()) {
+  return `${e.storagePrefix}-elpath-enabled`;
+}
+function f(e = t()) {
+  try {
+    return localStorage.getItem(o(e)) === "1";
+  } catch {
+    return !1;
+  }
+}
+function i(e, n = t()) {
+  try {
+    localStorage.setItem(o(n), e ? "1" : "0");
+  } catch {
+  }
+}
+function r(e = t()) {
+  return `${e.storagePrefix}-domtweaker-enabled`;
+}
+function s(e = t()) {
+  try {
+    return localStorage.getItem(r(e)) === "1";
+  } catch {
+    return !1;
+  }
+}
+function m(e, n = t()) {
+  try {
+    localStorage.setItem(r(n), e ? "1" : "0");
+  } catch {
+  }
+}
+function g(e) {
+  if (typeof window > "u") return !1;
+  try {
+    return window.localStorage.getItem(a(e)) === "1";
+  } catch {
+    return !1;
+  }
+}
+function y(e, n) {
+  if (!(typeof window > "u"))
+    try {
+      window.localStorage.setItem(a(e), n ? "1" : "0");
+    } catch {
+    }
+}
+function w(e) {
+  if (!(typeof window > "u"))
+    try {
+      window.localStorage.removeItem(a(e));
+    } catch {
+    }
+}
+export {
+  s as a,
+  y as b,
+  w as c,
+  i as d,
+  c as e,
+  l as f,
+  m as g,
+  d as i,
+  f as l,
+  g as s
+};

package/dist/controls/help-icon.d.ts

@@ -1,6 +1,6 @@
 /**
- * HelpIcon — small round "?" badge that explains a nearby control via the
- * shared `.tokenpanel-tooltip--help` variant (issue #520).
+ * HelpIcon — small round "?" badge that explains a panel concept via the
+ * shared `.tokenpanel-tooltip--help` variant (issues #520 and #544).
  *
  * Chrome-button policy (CLAUDE.md): implemented as
  * `<div role="button" tabIndex={0}>` with explicit Enter/Space handling —
@@ -13,10 +13,8 @@
  *    hover, so a tap must be able to reveal and hold the tip. A second
  *    activation, or pressing Escape anywhere on the page, unpins it.
  *
- * Callers place this as a SIBLING of the control it explains (e.g. after a
- * `<select>`, or after a `<label>` wrapping a checkbox) — never nested
- * inside a `<label>`, where a click would also toggle the label's own
- * control.
+ * Callers must never nest this inside a `<label>`, where activating the icon
+ * would also toggle the label's control.
  *
  * Known trade-off: `tooltip.tsx` renders a single shared tooltip DOM node,
  * so pinning icon A then hovering/pinning icon B silently replaces A's
@@ -31,8 +29,7 @@
  * visible until the next activation. Same accepted single-tooltip trade-off.
  */
 import type { JSX } from 'preact';
-export declare const LITERAL_HELP_TEXT = "Literal sets a fixed color just for this token \u2014 it won't update if you edit a palette/ramp swatch later. Pick a ramp option to keep it linked live.";
-export declare const PER_MODE_HELP_TEXT = "Per-mode gives this token two colors \u2014 one for light mode, one for dark. The browser picks the right one automatically via CSS light-dark().";
+export declare const SEMANTIC_TOKENS_HELP_TEXT = "Ramp options stay linked live to palette edits. Literal sets a fixed color that is not linked. Per-mode sets independent light and dark colors emitted with CSS light-dark().";
 export interface HelpIconProps {
     /** The help text shown in the tooltip (wrapped, multi-line). */
     text: string;