@takazudo/zdtp 0.2.3 → 0.3.0

package/dist/config/panel-config.d.ts

@@ -8,16 +8,32 @@
  *
  * Plumbing approach
  * -----------------
- * Module-level singleton (NOT Preact context). The panel is a single-instance
- * dev tool, config is set once before the adapter mounts, and every read site
- * is happy to pay a function call to read the current config.
+ * Module-level registry (NOT Preact context), keyed by `storagePrefix`. Each
+ * distinct prefix owns one panel *instance* — its config, its post-configure
+ * hooks, its returned handle. Every read site is happy to pay a function call
+ * to read the current config. Historically this was a single global singleton;
+ * issue #353 (Z1) lifts it to a per-instance registry so multiple panels with
+ * distinct `storagePrefix`es can coexist on one page.
  *
- * Idempotency
- * -----------
- * `configurePanel` is one-shot. Calling it twice with structurally-equal
- * values is a silent no-op (a freshly-parsed inline JSON config can be
- * byte-equal to the previous call but referentially distinct, e.g. on Astro
- * view-transition reruns). Calling with structurally-different values throws.
+ * Backward-compatible default instance
+ * ------------------------------------
+ * The single-panel path is unchanged. `getPanelConfig()` (no argument) returns
+ * the config of the most-recently-configured instance — the "default" / active
+ * instance — or `DEFAULT_PANEL_CONFIG` when no host has called `configurePanel`
+ * yet. A host that only ever calls `configurePanel` once observes the exact
+ * same behaviour as the old singleton.
+ *
+ * Idempotency & re-configure rule (same-prefix)
+ * ---------------------------------------------
+ * `configurePanel(config)` returns an instance handle. For a GIVEN prefix it is
+ * one-shot: calling it again with structurally-equal values is a no-op and
+ * returns the SAME handle (a freshly-parsed inline JSON config can be byte-equal
+ * to the previous call but referentially distinct, e.g. on Astro view-transition
+ * reruns). Calling again with the same prefix but structurally-DIFFERENT values
+ * REJECTS WITH AN ERROR (see `configurePanel` JSDoc) — config conflicts surface
+ * immediately instead of silently corrupting one of the callers' assumptions.
+ * Calling with a DISTINCT prefix registers a new, independent instance and does
+ * NOT throw. This is the chosen rule for Z4/Z5; see `RECONFIGURE_RULE` below.
  *
  * Default fallback
  * ----------------
@@ -44,6 +60,22 @@ import type { TabConfig } from '../tokens/tier-model';
  * (JSON-serializable constraint).
  */
 export type ApplyRoutingMap = Record<string, string>;
+/**
+ * Apply sink interface — allows routing CSS-var writes somewhere other than
+ * the host `:root` (e.g. a shadow root, an iframe document, or a spy in
+ * tests).
+ *
+ * - `apply(pairs)` — upsert the given var name→value pairs.
+ * - `clear(names)` — remove the given var names.
+ *
+ * Both methods receive only the vars that belong to THIS panel instance.
+ * Sink errors are non-fatal: the apply pipeline swallows them with
+ * `console.warn` and continues.
+ */
+export interface ApplySink {
+    apply(pairs: ReadonlyArray<readonly [string, string]>): void;
+    clear(names: readonly string[]): void;
+}
 /**
  * The portable PanelConfig shape.
  */
@@ -58,6 +90,17 @@ export interface PanelConfig {
     schemaId: string;
     /** Default filename base — exports save as `${exportFilenameBase}.json`. */
     exportFilenameBase: string;
+    /**
+     * Optional window-event name that toggles THIS instance's panel.
+     *
+     * The default (single-panel) instance keeps the historical public event
+     * `toggle-design-token-panel` (plus its `toggle-color-tweak-panel` alias) and
+     * ignores this field — see `toggleEventName()`. A configured instance with a
+     * NON-default `storagePrefix` listens on this name; when omitted it defaults
+     * to `toggle-${storagePrefix}` so two panels on one page get independent
+     * toggle channels with no cross-talk.
+     */
+    toggleEvent?: string;
     /**
      * Optional host-supplied color-scheme presets.
      *
@@ -97,6 +140,21 @@ export interface PanelConfig {
      * under the reserved id 'color-secondary'.
      */
     tabs: readonly TabConfig[];
+    /**
+     * Optional apply sink. When present, CSS-var writes and clears for this
+     * panel instance are routed through the sink instead of
+     * `document.documentElement`. This allows embedding the panel in a shadow
+     * DOM, an iframe, or a test spy without touching `:root`.
+     *
+     * Sink errors are non-fatal — the panel swallows them with `console.warn`.
+     * When absent the default path writes to `document.documentElement`
+     * (unchanged behavior).
+     *
+     * NOTE: this field carries a function reference and is therefore NOT
+     * JSON-serializable. It cannot be passed through Astro's inline JSON
+     * config. Supply it via a post-configure call or a custom adapter.
+     */
+    applySink?: ApplySink;
     /**
      * Optional id rename map applied during `loadPersistedState` migration.
      * Keys are old ids found in persisted state; values are either:
@@ -122,48 +180,177 @@ export interface PanelConfig {
      */
     legacyIdRenameMap?: Record<string, string | null>;
 }
+/**
+ * Handle returned by `configurePanel`. Identifies one configured panel
+ * instance and exposes its imperative lifecycle controls.
+ *
+ * Identity & keying
+ * -----------------
+ * `instanceId` equals the instance's `storagePrefix` — the registry key. Two
+ * `configurePanel` calls with the same prefix+config return the SAME handle
+ * object (referential identity is stable across idempotent re-calls); distinct
+ * prefixes return distinct handles.
+ *
+ * Method bodies — seams for later sub-tasks
+ * -----------------------------------------
+ * This sub-task (Z1) owns the instance MODEL only. `open` / `close` / `toggle`
+ * carry the correct method shape but defer their actual mount/visibility wiring
+ * to Z2 (events/lifecycle/mount). Today they drive the SAME global show/hide
+ * surface the console API uses for the default (single-panel) instance, so the
+ * default path keeps working end-to-end; Z2 replaces the bodies with
+ * per-instance event dispatch keyed by `instanceId`. `destroy()` deregisters
+ * the instance from the registry (model-level cleanup); Z2 extends it to also
+ * unmount the instance's Preact tree and remove its DOM root.
+ *
+ * @see RECONFIGURE_RULE for the same-prefix-different-config behaviour.
+ */
+export interface PanelInstanceHandle {
+    /** Stable instance id — equal to the instance's `storagePrefix` (the registry key). */
+    readonly instanceId: string;
+    /** Show this instance's panel. Z2 wires per-instance mount/visibility; today drives the shared show surface. */
+    open(): void;
+    /** Hide this instance's panel. Z2 wires per-instance mount/visibility; today drives the shared hide surface. */
+    close(): void;
+    /** Toggle this instance's panel open/closed. Z2 wires per-instance mount/visibility. */
+    toggle(): void;
+    /**
+     * Deregister this instance. Removes it from the registry so its prefix can be
+     * re-configured with a fresh config (and so it stops being the default
+     * instance `getPanelConfig()` resolves to). Z2 extends this to also unmount
+     * the instance's Preact tree and remove its DOM root.
+     */
+    destroy(): void;
+}
 /**
  * Default config — minimal stub values. Hosts MUST call `configurePanel(...)`
  * with real values to see useful behaviour.
  */
 export declare const DEFAULT_PANEL_CONFIG: PanelConfig;
 /**
- * Configure the panel runtime. Call exactly once per page lifecycle, before
- * the adapter is imported / mounted. Idempotent: calling twice with
- * structurally-equal values is a silent no-op; calling twice with structurally
- * different values throws so config conflicts surface immediately instead of
- * silently corrupting one of the two callers' assumptions.
- *
- * The re-init guard MUST use structural deep-equality, NOT referential
- * identity. The Astro host-adapter parses the inline JSON config on every
- * script run, including post view-transition reruns; that produces a
- * freshly-parsed object that is byte-for-byte identical to the previous call
- * but referentially distinct.
+ * Same-prefix-different-config rule (CHOSEN: reject-with-error).
+ *
+ * When `configurePanel` is called a second time with a prefix that is ALREADY
+ * registered but a structurally-DIFFERENT config, we throw. The alternative
+ * (deterministic-update) was rejected because:
+ *
+ *  - PORTABLE-CONTRACT §1 pins `configurePanel` as one-shot per page lifecycle
+ *    ("MUST NOT silently overwrite a previously-configured cluster mid-session").
+ *  - The existing single-panel tests assert the throw, and the throw is what
+ *    surfaces a genuine config-conflict bug (two callers fighting over one
+ *    prefix) instead of letting the last writer silently win.
+ *
+ * Multi-instance does NOT need same-prefix mutation: a host that wants a second
+ * panel uses a DISTINCT `storagePrefix`, which registers an independent
+ * instance with no throw. Z4/Z5 must follow this rule — to re-configure a
+ * prefix, call `handle.destroy()` first, then `configurePanel` again.
+ *
+ * Exported (machine-discoverable) so Z4/Z5 can branch on the chosen rule
+ * without re-deriving it from the throw behaviour.
+ */
+export declare const RECONFIGURE_RULE: "reject-with-error";
+/**
+ * Z2 lifecycle seam. Z2 (events/lifecycle/mount) installs handlers here so the
+ * instance handle's open/close/toggle/destroy route to real per-instance
+ * mount + visibility behaviour. Z1 leaves it empty: the handle methods are
+ * no-ops until Z2 wires them, which is fine because the default single-panel
+ * path is driven by the existing console API / window events, not by handles.
+ *
+ * Exported (with the `__` internal prefix) so the lifecycle module (Z2) can
+ * register without reaching into private module scope.
+ */
+export interface PanelLifecycleHooks {
+    /**
+     * Fired ONCE per newly-registered instance, immediately after
+     * `configurePanel` installs it (and AFTER the instance's post-configure
+     * hooks run). Z2 uses this to bind the instance's per-instance toggle-event
+     * listener at configure time — unlike `registerPostConfigureHook` (which
+     * adopts parked hooks for the FIRST instance only), this fires for EVERY
+     * `configurePanel` call, including the 2nd+ instance, so a non-default
+     * panel's `toggle-${storagePrefix}` channel is live the moment it is
+     * configured.
+     */
+    configured?: (instanceId: string) => void;
+    open?: (instanceId: string) => void;
+    close?: (instanceId: string) => void;
+    toggle?: (instanceId: string) => void;
+    destroy?: (instanceId: string) => void;
+}
+/**
+ * Z2 seam: install per-instance lifecycle handlers used by every instance
+ * handle's open/close/toggle/destroy plus the per-configure `configured` hook.
+ * Last call wins (Z2 owns its own idempotency). No-op-friendly: unset handlers
+ * leave the corresponding hook a no-op.
+ *
+ * Stored on the SHARED globalThis registry (not module scope) so the install
+ * side (`index.tsx`) and the fire side (`configurePanel`) observe the same
+ * hooks even when a Vite/Astro multi-entry build code-splits `panel-config`
+ * into two module instances — mirrors `pendingPostConfigureHooks`.
  */
-export declare function configurePanel(config: PanelConfig): void;
+export declare function __setPanelLifecycleHooks(hooks: PanelLifecycleHooks): void;
+/**
+ * Configure a panel instance. Call once per `storagePrefix` per page lifecycle,
+ * before that instance's adapter is imported / mounted. Returns the instance
+ * handle (`{ instanceId, open, close, toggle, destroy }`).
+ *
+ * Keying & multi-instance: the instance is keyed by `config.storagePrefix`.
+ * Distinct prefixes register independent instances (no throw); each derives its
+ * own storage keys, root id, modal classes, etc.
+ *
+ * Same-prefix idempotency: calling again with the same prefix and structurally-
+ * equal values is a no-op and returns the SAME handle. The re-init guard MUST
+ * use structural deep-equality, NOT referential identity — the Astro
+ * host-adapter parses the inline JSON config on every script run (including
+ * post view-transition reruns), producing a freshly-parsed object that is
+ * byte-for-byte identical to the previous call but referentially distinct.
+ *
+ * Same-prefix-different-config: REJECTS WITH AN ERROR (chosen rule — see
+ * `RECONFIGURE_RULE`). To re-configure a prefix, `destroy()` the existing
+ * handle first, then call `configurePanel` again.
+ *
+ * The most-recently-configured instance becomes the "default" instance that the
+ * no-arg `getPanelConfig()` resolves to, preserving the single-panel path.
+ */
+export declare function configurePanel(config: PanelConfig): PanelInstanceHandle;
 /**
  * Register a callback to run once configurePanel has been called with the
  * host's config. Used by src/index.tsx to defer reapplyPersistedOverrides and
  * reapplyFromStorage until AFTER the host has supplied the correct storagePrefix.
  *
+ * Scope: this targets the DEFAULT (single-panel) instance — the historical
+ * single-panel contract. When no instance is configured yet, the hook is parked
+ * on a registry-level pending list and attached to the first instance to be
+ * configured. When the default instance already exists, the hook fires
+ * immediately so late registrants don't miss the trigger.
+ *
  * H2 fix for issue #111: module-init in index.tsx previously ran reapply
  * synchronously — before configurePanel — using DEFAULT_PANEL_CONFIG's prefix,
  * causing a default-prefix panel to mount and clobber host-prefix storage keys
  * on the first toggle when contaminated localStorage was present.
  *
  * Idempotent: if the same hook reference is registered twice, the second call
- * is a no-op. If configurePanel has already been called, the hook fires
- * immediately so late registrants don't miss the trigger.
+ * is a no-op.
  */
 export declare function registerPostConfigureHook(hook: () => void): void;
 /**
- * Read the active panel config. Returns the value passed to `configurePanel`
- * if one was supplied, else `DEFAULT_PANEL_CONFIG`.
+ * Read the active panel config. Returns the config of the default (most-
+ * recently-configured) instance, else `DEFAULT_PANEL_CONFIG` when no host has
+ * called `configurePanel`.
  */
 export declare function getPanelConfig(): PanelConfig;
 /**
- * Test-only: clear the singleton so unit tests can exercise different configs
- * in isolation.
+ * Resolve the registered config for a SPECIFIC instance by its `storagePrefix`
+ * (=== `instanceId`), or `null` when no such instance is registered.
+ *
+ * Z2 uses this so a non-default panel mounts/operates against ITS OWN config
+ * (tabs, schema, apply settings, custom `toggleEvent`) instead of the active
+ * default instance's config — distinct instances stay fully independent even
+ * while another prefix is the active default.
+ */
+export declare function getPanelConfigByPrefix(prefix: string): PanelConfig | null;
+/**
+ * Test-only: clear the entire instance registry so unit tests can exercise
+ * different configs in isolation. Resets the default pointer, every registered
+ * instance, parked presets, and parked pre-configure hooks.
  */
 export declare function __resetPanelConfigForTests(): void;
 export { resolvePrimaryColorCluster, resolveSecondaryColorClusterFromTabs, } from './cluster-config';
@@ -213,6 +400,35 @@ export declare function storageKey_density(cfg: PanelConfig): string;
 export declare function storageKey_visible(cfg: PanelConfig): string;
 /** DOM id of the root element the Preact panel tree mounts into. */
 export declare function panelRootId(cfg: PanelConfig): string;
+/**
+ * Historical public toggle-event name. Hosts have shipped `window.dispatchEvent(
+ * new CustomEvent('toggle-design-token-panel'))` since the single-panel era, so
+ * the default instance MUST keep emitting/listening on this name regardless of
+ * its derived `toggle-${storagePrefix}` form.
+ */
+export declare const DEFAULT_TOGGLE_EVENT = "toggle-design-token-panel";
+/**
+ * Window-event name that toggles this instance's panel.
+ *
+ *  - Default instance (prefix === `DEFAULT_STORAGE_PREFIX`): the historical
+ *    `toggle-design-token-panel`. The `index.tsx` listener additionally binds
+ *    the deprecated `toggle-color-tweak-panel` alias for this instance only.
+ *  - Configured instance (any other prefix): `cfg.toggleEvent` when supplied,
+ *    else `toggle-${storagePrefix}` — a per-instance channel so two panels do
+ *    not cross-talk.
+ */
+export declare function toggleEventName(cfg: PanelConfig): string;
+/**
+ * Per-instance internal sync event name. `index.tsx` dispatches this on
+ * `window` after writing `localStorage[OPEN_KEY]`; the mounted `panel.tsx`
+ * listens for it and re-reads `OPEN_KEY`. Keyed by `storagePrefix` so a change
+ * to panel A's open state only pokes panel A's listener — two panels on one
+ * page stay fully independent (issue #354).
+ *
+ * Internal (double-underscore prefix) — NOT part of the public DOM contract;
+ * hosts must dispatch the public toggle event, never this one.
+ */
+export declare function openStateChangedEventName(cfg: PanelConfig): string;
 /**
  * BEM-style modal class. Pass an empty `suffix` for the base block, or
  * `'--export'` / `'__title'` etc. for elements / modifiers.
@@ -253,6 +469,10 @@ export declare function resolveApplyRouting(cfg?: PanelConfig): ApplyRoutingMap;
  * non-empty map overwrites the previous one (no throw, unlike
  * `configurePanel`) — the dropdown source-of-truth is whichever bundle
  * landed last.
+ *
+ * Scope: targets the DEFAULT (active) instance — the historical single-panel
+ * contract. When no instance is configured yet, the presets are parked at the
+ * registry level and merged into the first instance to be configured.
  */
 export declare function setPanelColorPresets(presets: Record<string, ColorScheme>): void;
 //# sourceMappingURL=panel-config.d.ts.map

package/dist/config/panel-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panel-config.d.ts","sourceRoot":"","sources":["../../src/config/panel-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"panel-config.d.ts","sourceRoot":"","sources":["../../src/config/panel-config.ts"],"names":[],"mappings":"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"}

package/dist/export-modal.d.ts

@@ -21,6 +21,7 @@
  * `close` event — and thus `onClose` — fires exactly once per dismissal.
  */
 import { type ColorTweakState, type TweakState } from './state/tweak-state';
+import { type PanelConfig } from './config/panel-config';
 export interface ExportModalProps {
     onClose: () => void;
     /** Full unified tweak state — the modal serializes all four categories. */
@@ -28,6 +29,13 @@ export interface ExportModalProps {
     /** Color baseline used for diff-only output. Optional: callers without DOM
      *  access (tests) can omit and we'll treat the entire color block as changed. */
     colorDefaults?: ColorTweakState;
+    /**
+     * The mounted panel instance's config (multi-instance, #357). When supplied,
+     * the modal derives its filename hint + modal classes + title id from THIS
+     * instance rather than the active default instance. Omitted (e.g. a direct
+     * test render) → `getPanelConfig()`, preserving the single-panel path.
+     */
+    instanceConfig?: PanelConfig;
 }
-export declare function ExportModal({ onClose, state, colorDefaults }: ExportModalProps): import("preact").JSX.Element;
+export declare function ExportModal({ onClose, state, colorDefaults, instanceConfig }: ExportModalProps): import("preact").JSX.Element;
 //# sourceMappingURL=export-modal.d.ts.map

package/dist/export-modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export-modal.d.ts","sourceRoot":"","sources":["../src/export-modal.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,2EAA2E;IAC3E,KAAK,EAAE,UAAU,CAAC;IAClB;qFACiF;IACjF,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;AAgBD,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,gBAAgB,gCAoL9E"}
+{"version":3,"file":"export-modal.d.ts","sourceRoot":"","sources":["../src/export-modal.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,2EAA2E;IAC3E,KAAK,EAAE,UAAU,CAAC;IAClB;qFACiF;IACjF,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC;CAC9B;AAgBD,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,gBAAgB,gCA6L9F"}

package/dist/import-modal.d.ts

@@ -21,6 +21,7 @@
  * `close` event — and thus `onClose` — fires exactly once per dismissal.
  */
 import type { ColorTweakState, TweakState } from './state/tweak-state';
+import { type PanelConfig } from './config/panel-config';
 export interface ImportModalProps {
     onClose: () => void;
     /** Called with the parsed state when the user hits "Load". The caller is
@@ -28,6 +29,13 @@ export interface ImportModalProps {
     onLoad: (state: TweakState) => void;
     /** Color baseline filled in for fields absent from the payload. */
     colorDefaults: ColorTweakState;
+    /**
+     * The mounted panel instance's config (multi-instance, #357). When supplied,
+     * the modal derives its modal classes + title id from THIS instance rather
+     * than the active default instance. Omitted (e.g. a direct test render) →
+     * `getPanelConfig()`, preserving the single-panel path.
+     */
+    instanceConfig?: PanelConfig;
 }
-export declare function ImportModal({ onClose, onLoad, colorDefaults }: ImportModalProps): import("preact").JSX.Element;
+export declare function ImportModal({ onClose, onLoad, colorDefaults, instanceConfig }: ImportModalProps): import("preact").JSX.Element;
 //# sourceMappingURL=import-modal.d.ts.map

package/dist/import-modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-modal.d.ts","sourceRoot":"","sources":["../src/import-modal.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAIvE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;oEACgE;IAChE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,mEAAmE;IACnE,aAAa,EAAE,eAAe,CAAC;CAChC;AAOD,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,gBAAgB,gCA+N/E"}
+{"version":3,"file":"import-modal.d.ts","sourceRoot":"","sources":["../src/import-modal.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAA8B,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGrF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;oEACgE;IAChE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,mEAAmE;IACnE,aAAa,EAAE,eAAe,CAAC;IAC/B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC;CAC9B;AAOD,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,EAAE,gBAAgB,gCA2O/F"}

package/dist/index.d.ts

@@ -35,9 +35,8 @@
  */
 import './styles/panel.css';
 import { type PanelConfig } from './config/panel-config';
-export declare const __OPEN_STATE_CHANGED_EVENT_FOR_TEST = "__zdtp:open-state-changed";
 export { configurePanel, setPanelColorPresets } from './config/panel-config';
-export type { PanelConfig } from './config/panel-config';
+export type { PanelConfig, PanelInstanceHandle, ApplySink } from './config/panel-config';
 /**
  * Internal-test-only accessor that returns this panel-module bundle's view of
  * the active panel config singleton. Paired with the Astro host adapter's
@@ -76,6 +75,16 @@ export declare function toggleDesignPanel(): void;
  * instead, same as before this helper existed).
  */
 export declare function reapplyPersistedOverrides(): void;
+/**
+ * Test-only: drain EVERY instance's window-event listeners and clear the
+ * bindings map. Unlike `delete window.__zudoDesignTokenPanelInstanceBindings`,
+ * this actively removes the real `addEventListener` registrations — dropping
+ * the map alone would orphan live listeners that then leak across tests (a
+ * stale listener from a previous test re-mounts a panel on the next dispatch).
+ *
+ * Exported with the `__` internal prefix; not part of the public API.
+ */
+export declare function __resetInstanceBindingsForTests(): void;
 /**
  * Framework-agnostic lifecycle hook adapter. A host that owns its own
  * client-side navigation lifecycle (zfb, custom router, etc.) implements

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AASH,OAAO,oBAAoB,CAAC;AAc5B,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAqD/B,eAAO,MAAM,mCAAmC,8BAA2B,CAAC;AAkK5E,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CAElD;AAQD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM9D,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAGxE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGpE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGjE,YAAY,EACV,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAO7B,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,wBAAgB,oBAAoB,IAAI,IAAI,CAoB3C;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAY3C;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAWxC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAQhD;AA8HD;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACpD,2FAA2F;IAC3F,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACnD;AA4GD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAU1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AASH,OAAO,oBAAoB,CAAC;AAc5B,OAAO,EAUL,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAiO/B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEzF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CAElD;AAQD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM9D,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAGxE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGpE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGjE,YAAY,EACV,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAO7B,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA2DrD,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAQhD;AA8LD;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAMtD;AAyED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IACpD,2FAA2F;IAC3F,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACnD;AA4GD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAU1E"}