@takazudo/zdtp 0.4.15 → 0.5.1

package/dist/constants.d.ts

@@ -0,0 +1,86 @@
+/** Default storage-key prefix used by the single-panel configuration. */
+export declare const DEFAULT_STORAGE_PREFIX = "zudo-design-token-panel";
+/** Historical public window-event name for the default panel instance. */
+export declare const DEFAULT_TOGGLE_EVENT = "toggle-design-token-panel";
+/**
+ * Resolve the window-event name that toggles a panel instance.
+ *
+ * The default prefix keeps the historical event name, even when a host
+ * supplies a `toggleEvent`. Other prefixes honor an explicit event name and
+ * otherwise derive one from the prefix.
+ */
+export declare function resolveToggleEventName(cfg: {
+    storagePrefix?: string;
+    toggleEvent?: string;
+}): string;
+/**
+ * The five fixed eager-load signals, keyed by suffix relative to storagePrefix.
+ * Only acceptedValues activate a flag; presence alone is insufficient.
+ * requiredConfig means that property must be !== undefined in the panel config.
+ * This excludes preference keys and is NOT the whole gate: also inspect
+ * EAGER_LOAD_GATE_STATE_FAMILY, whose keys require a content check.
+ */
+export declare const EAGER_LOAD_GATE_KEY_SUFFIXES: {
+    readonly ':visible': {
+        readonly acceptedValues: readonly ["1"];
+        readonly requiredConfig: null;
+    };
+    readonly '-open': {
+        readonly acceptedValues: readonly ["1"];
+        readonly requiredConfig: null;
+    };
+    readonly ':autoload': {
+        readonly acceptedValues: readonly ["1", "auto"];
+        readonly requiredConfig: null;
+    };
+    readonly '-elpath-enabled': {
+        readonly acceptedValues: readonly ["1"];
+        readonly requiredConfig: null;
+    };
+    readonly '-domtweaker-enabled': {
+        readonly acceptedValues: readonly ["1"];
+        readonly requiredConfig: "domTweaker";
+    };
+};
+/**
+ * The single registry of state-key suffixes the current loader can read.
+ *
+ * EVERY storage-format version bump must update this registry in the same
+ * change that teaches the loader to read that version. The synchronous eager
+ * gate intentionally probes only these bounded, readable versions; speculative
+ * future versions would promise recovery that the loader cannot perform.
+ */
+export declare const READABLE_STATE_KEY_SUFFIXES: {
+    readonly v1: "-state";
+    readonly v2: "-state-v2";
+    readonly v3: "-state-v3";
+    readonly v4: "-state-v4";
+};
+/**
+ * The sixth eager-load signal: exact readable state keys, with a content
+ * check. Missing keys and raw empty strings are blank;
+ * JSON null and empty objects/arrays do not activate. Non-empty collections and
+ * all other parsed primitives (even false, 0, or JSON "") activate. Malformed
+ * JSON fails open so the panel can migrate or reject the stored payload.
+ *
+ * matchesKey compares complete strings constructed from the literal prefix, so
+ * regex metacharacters are safe and sibling-instance keys are excluded.
+ * These are storage signal descriptions, not a storage reader or panel bootstrap.
+ */
+export declare const EAGER_LOAD_GATE_STATE_FAMILY: {
+    readonly keySuffixes: {
+        readonly v1: "-state";
+        readonly v2: "-state-v2";
+        readonly v3: "-state-v3";
+        readonly v4: "-state-v4";
+    };
+    readonly matchesKey: (storagePrefix: string, key: string) => boolean;
+    readonly valueRules: {
+        readonly blank: false;
+        readonly jsonNull: false;
+        readonly object: "non-empty";
+        readonly array: "non-empty";
+        readonly primitive: true;
+        readonly malformedJson: true;
+    };
+};

package/dist/constants.js

@@ -0,0 +1,39 @@
+const o = "zudo-design-token-panel", l = "toggle-design-token-panel";
+function r(e) {
+  return e.storagePrefix === void 0 || e.storagePrefix === o ? l : e.toggleEvent ?? `toggle-${e.storagePrefix}`;
+}
+const s = {
+  ":visible": { acceptedValues: ["1"], requiredConfig: null },
+  "-open": { acceptedValues: ["1"], requiredConfig: null },
+  ":autoload": { acceptedValues: ["1", "auto"], requiredConfig: null },
+  "-elpath-enabled": { acceptedValues: ["1"], requiredConfig: null },
+  "-domtweaker-enabled": { acceptedValues: ["1"], requiredConfig: "domTweaker" }
+}, t = {
+  v1: "-state",
+  v2: "-state-v2",
+  v3: "-state-v3",
+  v4: "-state-v4"
+}, u = {
+  keySuffixes: t,
+  matchesKey(e, a) {
+    return Object.values(t).some(
+      (n) => a === e + n
+    );
+  },
+  valueRules: {
+    blank: !1,
+    jsonNull: !1,
+    object: "non-empty",
+    array: "non-empty",
+    primitive: !0,
+    malformedJson: !0
+  }
+};
+export {
+  o as DEFAULT_STORAGE_PREFIX,
+  l as DEFAULT_TOGGLE_EVENT,
+  s as EAGER_LOAD_GATE_KEY_SUFFIXES,
+  u as EAGER_LOAD_GATE_STATE_FAMILY,
+  t as READABLE_STATE_KEY_SUFFIXES,
+  r as resolveToggleEventName
+};

package/dist/controls/actions-menu-popover.d.ts

@@ -1,7 +1,7 @@
 /**
  * ActionsMenuPopover — narrow-panel replacement for the header action links
  * (Export / Load from JSON… / Apply / Reset), collapsed behind the kebab
- * trigger below the panel's <480px container-query breakpoint (#518).
+ * trigger when the header yields through its CSS container query (#787).
  *
  * A PLAIN popover of ordinary action RoleButtons, NOT an ARIA menu:
  * role="menu"/menuitem demands arrow-key navigation and focus management,

package/dist/dom-tweaker/dom-tweaker-toggle-button.d.ts

@@ -6,4 +6,6 @@
  * import through DomTweakerOrchestrator.
  */
 import type { JSX } from 'preact';
-export declare function DomTweakerToggleButton(): JSX.Element | null;
+export declare function DomTweakerToggleButton({ compact }?: {
+    compact?: boolean;
+}): JSX.Element | null;

package/dist/element-inspect/element-inspect-toggle-button.d.ts

@@ -1,3 +1,5 @@
 import type { JSX } from 'preact';
 /** Header control for the element → tokens picker. */
-export declare function ElementInspectToggleButton(): JSX.Element | null;
+export declare function ElementInspectToggleButton({ compact }?: {
+    compact?: boolean;
+}): JSX.Element | null;

package/dist/element-path/element-path-toggle-button.d.ts

@@ -10,4 +10,6 @@
  * through its `ariaProps` bag.
  */
 import type { JSX } from 'preact';
-export declare function ElementPathToggleButton(): JSX.Element | null;
+export declare function ElementPathToggleButton({ compact }?: {
+    compact?: boolean;
+}): JSX.Element | null;