@takazudo/zdtp 0.4.1 → 0.4.3

package/dist/components/color-picker/index.d.ts

@@ -1,3 +1,2 @@
 export { ColorPicker, type ColorPickerMode, type ColorPickerProps, LOCAL_STORAGE_KEY, getFixedPopoverStyle, usePopoverClose, } from './color-picker';
 export { default } from './color-picker';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/palette-chart/index.d.ts

@@ -1,3 +1,2 @@
 export { PaletteChart, type PaletteChartProps, type Oklcha, type Channel, } from './palette-chart';
 export { default } from './palette-chart';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/palette-chart/palette-chart.d.ts

@@ -72,4 +72,3 @@ declare function PaletteChartImpl({ colors, selectedIndex, visibleChannels, onCh
  */
 export declare const PaletteChart: typeof PaletteChartImpl;
 export default PaletteChart;
-//# sourceMappingURL=palette-chart.d.ts.map

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

@@ -132,4 +132,3 @@ export declare function resolvePrimaryColorCluster(tabs: readonly TabConfig[]):
  * `ColorClusterDataConfig`. Returns `null` when no secondary color tab exists.
  */
 export declare function resolveSecondaryColorClusterFromTabs(tabs: readonly TabConfig[]): ColorClusterDataConfig | null;
-//# sourceMappingURL=cluster-config.d.ts.map

package/dist/config/color-scheme-utils.d.ts

@@ -102,4 +102,3 @@ export declare function resolveSemanticColors(scheme: ColorScheme): Record<strin
 export declare function schemeToCssPairs(scheme: ColorScheme): [string, string][];
 export declare function generateCssCustomProperties(): string;
 export declare function generateLightDarkCssProperties(): string;
-//# sourceMappingURL=color-scheme-utils.d.ts.map

package/dist/config/color-schemes.d.ts

@@ -85,4 +85,3 @@ export interface ColorScheme {
  * same indices.
  */
 export declare const colorSchemes: Record<string, ColorScheme>;
-//# sourceMappingURL=color-schemes.d.ts.map

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

@@ -337,6 +337,17 @@ export declare function registerPostConfigureHook(hook: () => void): void;
  * called `configurePanel`.
  */
 export declare function getPanelConfig(): PanelConfig;
+/**
+ * Return the configs of ALL registered panel instances, in registration order.
+ * Returns an empty array when no instance has been configured yet.
+ *
+ * Used by the Astro lifecycle handlers (unmountForSwap / reapplyFromStorage)
+ * to loop every mounted instance rather than only the default one. Without
+ * this, non-default panels have their DOM roots removed by Astro's body swap
+ * WITHOUT `render(null, root)` being called, so their useEffect cleanups never
+ * fire and window/document listeners accumulate per soft navigation.
+ */
+export declare function getAllPanelConfigs(): PanelConfig[];
 /**
  * Resolve the registered config for a SPECIFIC instance by its `storagePrefix`
  * (=== `instanceId`), or `null` when no such instance is registered.
@@ -398,6 +409,14 @@ export declare function storageKey_density(cfg: PanelConfig): string;
  * continuity.
  */
 export declare function storageKey_visible(cfg: PanelConfig): string;
+/**
+ * Adapter-level owner-autoload intent flag, paired with `:visible`.
+ *
+ * Marks this browser as the site-owner device so the host-adapter eagerly
+ * loads the bundle on every subsequent visit. Uses the same `:` separator as
+ * `:visible` (distinct from the `-` separator on all other derived keys).
+ */
+export declare function storageKey_autoload(cfg: PanelConfig): string;
 /** DOM id of the root element the Preact panel tree mounts into. */
 export declare function panelRootId(cfg: PanelConfig): string;
 /**
@@ -475,4 +494,3 @@ export declare function resolveApplyRouting(cfg?: PanelConfig): ApplyRoutingMap;
  * 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/controls/dismiss-layer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Dismiss-layer stack — shared Escape arbitration for the panel's layered
+ * popovers (#446).
+ *
+ * Problem it solves
+ * -----------------
+ * The panel stacks several dismissable surfaces on top of each other:
+ * a ColorPicker popover, the HighlightSettingsPopover (which can itself host a
+ * nested ColorPicker), and the PaletteSelector listbox — plus the panel shell
+ * underneath. Each surface used to register its OWN `document` keydown listener
+ * that closed it on Escape. Because they were all bound to `document`, a single
+ * Escape fired EVERY listener at once: the popover closed AND the panel torn
+ * down, and with a nested picker all three layers collapsed on one keypress.
+ *
+ * The fix is a single, shared arbiter. Every dismissable JS-managed popover
+ * registers a layer here instead of adding its own key listener. One
+ * capture-phase `keydown` listener on `document` routes Escape to exactly ONE
+ * layer — the topmost — and marks the event handled via `preventDefault()`.
+ * Base surfaces that keep their own listener (the panel shell) bail when they
+ * see `event.defaultPrevented`, so one Escape never closes two layers.
+ *
+ * Native `<dialog>` modals (Export / Import / Apply) are intentionally NOT
+ * layers here: the browser already gives them their own top-layer Escape
+ * handling. The panel guards against those separately via its modal-open flags.
+ *
+ * Topmost selection
+ * -----------------
+ * "Topmost" is resolved by DOM depth, not registration order: the layer whose
+ * element is the deepest descendant wins (a nested popover's container is a DOM
+ * descendant of its host popover's container). This is robust regardless of the
+ * order in which effects register the layers (child effects run before parent
+ * effects in Preact), which matters for the ColorPicker-inside-
+ * HighlightSettingsPopover case. When elements are unrelated or unavailable it
+ * falls back to the most-recently-registered layer.
+ */
+export interface DismissLayerOptions {
+    /**
+     * Invoked when this layer is the topmost and Escape is pressed. Should close
+     * the layer (and may restore focus to its trigger).
+     */
+    onEscape: () => void;
+    /**
+     * Returns the layer's root element, used to resolve DOM depth when several
+     * layers are open at once. May return null before the element mounts.
+     */
+    getElement: () => HTMLElement | null;
+}
+/**
+ * Register a dismiss layer. Returns an unregister function to call on unmount.
+ */
+export declare function pushDismissLayer(options: DismissLayerOptions): () => void;
+/** Number of currently-registered layers (test/introspection helper). */
+export declare function dismissLayerCount(): number;
+/** Clear all registered layers. Test-only reset between cases. */
+export declare function __resetDismissLayersForTests(): void;

package/dist/controls/pill-slider-row.d.ts

@@ -34,4 +34,3 @@ export interface PillSliderRowProps {
 declare function PillSliderRow({ token, value, onChange }: PillSliderRowProps): import("preact").JSX.Element;
 declare const _default: typeof PillSliderRow;
 export default _default;
-//# sourceMappingURL=pill-slider-row.d.ts.map

package/dist/controls/role-button.d.ts

@@ -15,4 +15,3 @@ export interface RoleButtonProps {
     'aria-label'?: string;
 }
 export declare function RoleButton({ children, onClick, className, 'aria-disabled': ariaDisabled, ariaProps, tabIndex, id, title, 'aria-label': ariaLabel, }: RoleButtonProps): JSX.Element;
-//# sourceMappingURL=role-button.d.ts.map

package/dist/controls/sanitize-css-value.d.ts

@@ -19,4 +19,3 @@
  * guards the **exported** CSS snippet and keeps stored state tidy.
  */
 export declare function sanitizeCssValue(input: string): string;
-//# sourceMappingURL=sanitize-css-value.d.ts.map

package/dist/controls/select-row.d.ts

@@ -23,4 +23,3 @@ export interface SelectRowProps {
 declare function SelectRow({ token, value, onChange }: SelectRowProps): import("preact").JSX.Element;
 declare const _default: typeof SelectRow;
 export default _default;
-//# sourceMappingURL=select-row.d.ts.map

package/dist/controls/slider-row.d.ts

@@ -27,4 +27,3 @@ export interface SliderRowProps {
 declare function SliderRow({ token, value, onChange }: SliderRowProps): import("preact").JSX.Element;
 declare const _default: typeof SliderRow;
 export default _default;
-//# sourceMappingURL=slider-row.d.ts.map

package/dist/controls/text-row.d.ts

@@ -25,4 +25,3 @@ export interface TextRowProps {
 declare function TextRow({ token, value, onChange }: TextRowProps): import("preact").JSX.Element;
 declare const _default: typeof TextRow;
 export default _default;
-//# sourceMappingURL=text-row.d.ts.map

package/dist/controls/tier-ref-selector.d.ts

@@ -36,4 +36,3 @@ export interface TierRefSelectorProps {
 declare function TierRefSelector({ tab, tierId, itemId, value, onChange, previewValueFor }: TierRefSelectorProps): import("preact").JSX.Element;
 declare const _default: typeof TierRefSelector;
 export default _default;
-//# sourceMappingURL=tier-ref-selector.d.ts.map

package/dist/controls/token-label.d.ts

@@ -14,4 +14,3 @@ export interface TokenLabelProps {
 declare function TokenLabelInner({ cssVar, label, className }: TokenLabelProps): import("preact").JSX.Element;
 export declare const TokenLabel: typeof TokenLabelInner;
 export default TokenLabel;
-//# sourceMappingURL=token-label.d.ts.map

package/dist/controls/tooltip.d.ts

@@ -41,4 +41,3 @@ export declare function useTooltip(text: string): {
     onFocusOut: JSX.FocusEventHandler<HTMLElement>;
 };
 export {};
-//# sourceMappingURL=tooltip.d.ts.map

package/dist/controls/use-dialog-backdrop-close.d.ts

@@ -0,0 +1,32 @@
+/**
+ * useDialogBackdropClose — gesture-aware backdrop dismissal for native
+ * `<dialog>` modals (#446, finding F14).
+ *
+ * The naive backdrop check tests only the *click* coordinates against the
+ * dialog rect: `if (clientX < rect.left || ...) dialog.close()`. That misfires
+ * on a text-selection drag — when the user presses inside a selectable region
+ * (the export JSON block, the import textarea, the apply preview) and releases
+ * on the backdrop, Chrome synthesizes the `click` on the common ancestor (the
+ * `<dialog>` itself) using the mouseup coordinates, which land outside the rect.
+ * The modal then closes and the user's unsaved input (e.g. pasted JSON) is lost.
+ *
+ * The fix tracks where the gesture STARTED. A backdrop dismissal fires only when
+ * BOTH the mousedown and the click landed outside the dialog's content rect, so
+ * a drag that began inside the dialog never dismisses it.
+ *
+ * This is a hook so the mousedown-origin ref is per-modal-instance; the returned
+ * handlers are spread onto the `<dialog>` element.
+ */
+import type { JSX } from 'preact';
+export interface DialogBackdropHandlers {
+    onMouseDown: (e: JSX.TargetedMouseEvent<HTMLDialogElement>) => void;
+    onClick: (e: JSX.TargetedMouseEvent<HTMLDialogElement>) => void;
+}
+/**
+ * @param dialogRef  ref to the `<dialog>` element.
+ * @param onBackdrop invoked for a genuine backdrop dismissal (a press+release
+ *                   that both land outside the dialog's content rect).
+ */
+export declare function useDialogBackdropClose(dialogRef: {
+    current: HTMLDialogElement | null;
+}, onBackdrop: () => void): DialogBackdropHandlers;

package/dist/element-path/build-element-path.d.ts

@@ -83,4 +83,3 @@ export declare function buildElementPath(el: Element): ElementPathResult;
 export declare function formatElementPath(result: ElementPathResult): string;
 /** Convenience: build + format in one call. */
 export declare function buildElementPathString(el: Element): string;
-//# sourceMappingURL=build-element-path.d.ts.map

package/dist/element-path/element-path-context.d.ts

@@ -15,4 +15,3 @@ export interface ElementPathContextValue {
     toggle: () => void;
 }
 export declare const ElementPathContext: import("preact").Context<ElementPathContextValue | null>;
-//# sourceMappingURL=element-path-context.d.ts.map

package/dist/element-path/element-path-orchestrator.d.ts

@@ -15,4 +15,3 @@ import type { ComponentChildren } from 'preact';
 export declare function ElementPathOrchestrator({ children }: {
     children: ComponentChildren;
 }): import("preact").JSX.Element;
-//# sourceMappingURL=element-path-orchestrator.d.ts.map

package/dist/element-path/element-path-state.d.ts

@@ -10,11 +10,11 @@
  * `panelConfig.storagePrefix` at call-time (never at module init) so a host's
  * `configurePanel({ storagePrefix })` is respected.
  */
+import type { PanelConfig } from '../config/panel-config';
 /**
  * Load the persisted enabled flag from localStorage. Defaults to `false`
  * (inspect mode off) on any parse/access failure or when absent.
  */
-export declare function loadElementPathEnabled(): boolean;
+export declare function loadElementPathEnabled(cfg?: PanelConfig): boolean;
 /** Persist the enabled flag to localStorage. Degrades silently when storage is unavailable. */
-export declare function saveElementPathEnabled(enabled: boolean): void;
-//# sourceMappingURL=element-path-state.d.ts.map
+export declare function saveElementPathEnabled(enabled: boolean, cfg?: PanelConfig): void;

package/dist/element-path/element-path-toast.d.ts

@@ -26,4 +26,3 @@ export interface ElementPathToastProps {
     ok: boolean;
 }
 export declare function ElementPathToast({ message, ok }: ElementPathToastProps): JSX.Element | null;
-//# sourceMappingURL=element-path-toast.d.ts.map

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

@@ -11,4 +11,3 @@
  */
 import type { JSX } from 'preact';
 export declare function ElementPathToggleButton(): JSX.Element | null;
-//# sourceMappingURL=element-path-toggle-button.d.ts.map

package/dist/element-path/index.d.ts

@@ -12,4 +12,3 @@ export type { ElementPathContextValue } from './element-path-context';
 export { buildElementPath, buildElementPathString, formatElementPath, buildUniqueSelector, buildBreadcrumb, } from './build-element-path';
 export type { ElementPathResult } from './build-element-path';
 export { loadElementPathEnabled, saveElementPathEnabled } from './element-path-state';
-//# sourceMappingURL=index.d.ts.map

package/dist/element-path/inspector-overlay.d.ts

@@ -24,4 +24,3 @@ export interface InspectorOverlayProps {
     enabled: boolean;
 }
 export declare function InspectorOverlay({ enabled }: InspectorOverlayProps): JSX.Element | null;
-//# sourceMappingURL=inspector-overlay.d.ts.map

package/dist/export-modal.d.ts

@@ -38,4 +38,3 @@ export interface ExportModalProps {
     instanceConfig?: PanelConfig;
 }
 export declare function ExportModal({ onClose, state, colorDefaults, instanceConfig }: ExportModalProps): import("preact").JSX.Element;
-//# sourceMappingURL=export-modal.d.ts.map

package/dist/highlight/find-elements.d.ts

@@ -126,4 +126,3 @@ export declare const PANEL_EXCLUSION_SELECTOR = ".tokenpanel-shell, [data-design
  *   causing equality mode to miss `font-size` consumers.
  */
 export declare function findElementsUsingToken(cssVar: string, options?: FindElementsOptions): FindElementsResult;
-//# sourceMappingURL=find-elements.d.ts.map

package/dist/highlight/highlight-orchestrator.d.ts

@@ -21,4 +21,3 @@ export declare function HighlightOrchestrator({ children }: {
     children: ComponentChildren;
 }): import("preact").JSX.Element;
 export {};
-//# sourceMappingURL=highlight-orchestrator.d.ts.map

package/dist/highlight/highlight-overlay.d.ts

@@ -40,4 +40,3 @@ export interface HighlightOverlayProps {
     items: ReadonlyArray<HighlightOverlayItem>;
 }
 export declare function HighlightOverlay({ items }: HighlightOverlayProps): JSX.Element | null;
-//# sourceMappingURL=highlight-overlay.d.ts.map

package/dist/highlight/highlight-settings-popover.d.ts

@@ -22,4 +22,3 @@ interface HighlightSettingsPopoverProps {
 }
 export declare function HighlightSettingsPopover({ anchorRef, onClose, }: HighlightSettingsPopoverProps): JSX.Element | null;
 export {};
-//# sourceMappingURL=highlight-settings-popover.d.ts.map

package/dist/highlight/highlight-state.d.ts

@@ -84,4 +84,3 @@ export declare function loadHighlightState(): HighlightState;
  * Gracefully handles environments where storage is unavailable.
  */
 export declare function saveHighlightState(state: HighlightState): void;
-//# sourceMappingURL=highlight-state.d.ts.map

package/dist/highlight/highlight-toggle-button.d.ts

@@ -31,4 +31,3 @@ export interface HighlightToggleButtonProps {
     cssVar: string;
 }
 export declare function HighlightToggleButton({ cssVar }: HighlightToggleButtonProps): JSX.Element | null;
-//# sourceMappingURL=highlight-toggle-button.d.ts.map

package/dist/import-modal.d.ts

@@ -38,4 +38,3 @@ export interface ImportModalProps {
     instanceConfig?: PanelConfig;
 }
 export declare function ImportModal({ onClose, onLoad, colorDefaults, instanceConfig }: ImportModalProps): import("preact").JSX.Element;
-//# sourceMappingURL=import-modal.d.ts.map

package/dist/index.d.ts

@@ -63,6 +63,45 @@ export { emptyOverrides } from './state/tweak-state';
 export declare function showDesignTokenPanel(): void;
 export declare function hideDesignTokenPanel(): void;
 export declare function toggleDesignPanel(): void;
+/**
+ * Arm the owner-autoload flag for a panel instance (defaults to the active
+ * default instance).
+ *
+ * For non-Astro hosts (e.g. the doc site bootstrapped via `@takazudo/zudo-doc`)
+ * that cannot use the Astro console adapter (S2); the adapter also delegates its
+ * per-namespace `enableAutoload` here with the captured `cfg` so it targets the
+ * right instance on multi-instance pages. Mirrors the S2 contract from
+ * `autoload-state.ts §enableAutoload()`:
+ *   1. Sets `:autoload = '1'`.
+ *   2. Sets `-elpath-enabled = '1'` to arm the alt+click inspector.
+ *   3. Mounts the Preact shell CLOSED (element-path inspector activates without
+ *      opening the panel UI).
+ */
+export declare function enableAutoload(cfg?: PanelConfig): void;
+/**
+ * Disarm the owner-autoload flag for a panel instance (defaults to the active
+ * default instance) and fully tear down the owner-mode state.
+ *
+ * The Astro host adapter delegates its per-namespace `disableAutoload` here with
+ * the captured `cfg`, so the live Alt+click inspector is unmounted immediately
+ * (not merely closed) and the right instance is targeted on multi-instance
+ * pages. Mirrors the S2 contract from `autoload-state.ts §disableAutoload()`:
+ *   1. Clears `:autoload`.
+ *   2. Clears `:visible` (sets to `'0'`).
+ *   3. Clears `-elpath-enabled` (sets to `'0'`).
+ *   4. Removes the open-state key so the next mount starts closed.
+ *   5. Unmounts the Preact shell (drives effect cleanups, removes root).
+ */
+export declare function disableAutoload(cfg?: PanelConfig): void;
+/**
+ * Return `true` iff the default panel instance has the owner-autoload flag set.
+ * Thin wrapper over `shouldAutoload(cfg)` from `./state/autoload-state` that
+ * reads the default instance's config so non-Astro hosts do not need to import
+ * from the internal sub-path.
+ */
+export declare function shouldAutoload(): boolean;
+/** Test-only: invoke `reapplyFromStorage` with the current active config. */
+export declare function __reapplyFromStorageForTests(): void;
 /**
  * Apply persisted token overrides directly to `:root` BEFORE any Preact
  * render. Called at adapter module init (and again on every `astro:page-load`)
@@ -111,4 +150,3 @@ export interface LifecycleAdapter {
  * No-op outside a browser context (SSR-safe).
  */
 export declare function setLifecycleAdapter(adapter: LifecycleAdapter | null): void;
-//# sourceMappingURL=index.d.ts.map