@takazudo/zdtp 0.4.9 → 0.4.10

package/dist/{index-CGev6ZiI.js → index-mxUJmEeO.js}

@@ -1,6 +1,6 @@
 import { jsx as y, jsxs as K, Fragment as kt } from "preact/jsx-runtime";
 import { useEffect as P, useState as Y, useRef as O, useMemo as J, useCallback as X } from "preact/hooks";
-import { b as ft, p as wt, u as ht, a as Ne, A as bt, Z as gt } from "./index-t74PT2zd.js";
+import { b as ft, p as wt, u as ht, a as Ne, A as bt, Z as gt } from "./index-C5_Z29Nr.js";
 import { g as vt, m as j } from "./panel-config-BNLlUc_r.js";
 const xt = (e, o) => {
   const t = new Array(e.length + o.length);

package/dist/index.js

@@ -1,9 +1,9 @@
 import "preact/jsx-runtime";
 import "preact";
-import { S as i, c as t, d as n, _ as l, e as d, f as _, g, h as p, i as P, j as m, k as A, l as C, m as u, n as c, o as f, q as K, r as M, s as T, t as v, v as S, w as E, x as h } from "./index-t74PT2zd.js";
+import { S as i, c as t, d as n, _ as l, e as d, f as _, g, h as p, i as P, j as m, k as A, l as C, m as u, n as c, o as f, q as K, r as M, s as T, t as v, v as S, w as E, x as h } from "./index-C5_Z29Nr.js";
 import { Z as D, U as k, v as y, u as F, X as H } from "./tweak-state-Dti6XMoQ.js";
 import { c as b, s as w } from "./panel-config-BNLlUc_r.js";
-import "./autoload-state-CFmRjtD-.js";
+import "./autoload-state-CEkOpbGS.js";
 export {
   i as SCHEMA_V1,
   t as SCHEMA_V2,

package/dist/utils/document-liveness.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Liveness probes for the global `document`.
+ *
+ * Why these exist (zudolab/zudo-doc#3344): the panel's deferred surfaces —
+ * dynamic-import continuations in the Astro host adapter, host code calling
+ * the public API right after `await import('@takazudo/zdtp')` resolves, and
+ * Preact's rAF/setTimeout effect flush — can resume AFTER the environment
+ * that scheduled them is gone. Under vitest, the jsdom environment is torn
+ * down (or swapped for the next test file) while such a continuation is
+ * still in flight; the global `document` then either disappears or is
+ * replaced by a non-Document stub, and a late `document.getElementById(...)`
+ * throws `TypeError: document.getElementById is not a function` — surfacing
+ * as an unhandled rejection in the downstream test run.
+ *
+ * In a real browser the page's document outlives every continuation
+ * scheduled from it, so both probes are inert there (always true): the
+ * guards only change behavior in torn-down / swapped-environment states
+ * where the alternative is a crash.
+ */
+/**
+ * True when the global `document` exists and behaves like a live Document.
+ * `getElementById` doubles as the canary: it is the first DOM call the
+ * panel's mount/lookup paths make, and the exact method the downstream
+ * teardown crash reported missing.
+ *
+ * The explicit `document !== null` operand is load-bearing: `typeof null` is
+ * `'object'`, so a teardown that nulls the global (`globalThis.document =
+ * null`) sails past the `typeof` check and the `getElementById` probe then
+ * dereferences null — throwing the exact TypeError this helper prevents.
+ */
+export declare function isDocumentUsable(): boolean;
+/**
+ * Null-safe snapshot of the global `document` for later identity comparison.
+ * A bare `const doc = document` would throw a ReferenceError when the global
+ * has already been deleted (teardown completed before the async surface was
+ * even entered) — and inside an async function that ReferenceError becomes
+ * the very unhandled rejection these helpers exist to prevent.
+ *
+ * A nulled global (`globalThis.document = null`) is captured as `null` too,
+ * not as a "captured document" — `isSameUsableDocument(null)` is false, so a
+ * continuation entered during that teardown shape cancels rather than
+ * matching a null global against a null capture.
+ */
+export declare function captureDocument(): Document | null;
+/**
+ * True when the global `document` is still the SAME live document captured
+ * when an async surface was entered. Checked after `await` boundaries: a
+ * mismatch means the environment was torn down or swapped mid-flight, and
+ * the continuation must cancel itself instead of driving a document it does
+ * not own — even a fully-functional replacement document belongs to someone
+ * else (the next test file's environment, a new page).
+ */
+export declare function isSameUsableDocument(owningDoc: Document | null): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zdtp",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "Dynamic design-token tweak panel — host-config-driven, framework-agnostic Preact UI.",
   "private": false,
   "license": "MIT",

package/dist/autoload-state-CFmRjtD-.js

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