@takazudo/zdtp 0.1.0-next.0

package/dist/import-modal.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Import modal — accepts a pasted design-tokens JSON document (default schema:
+ * `zudo-design-tokens/v1`; configurable via `panelConfig.schemaId`) and lifts
+ * it into a `TweakState` via `deserialize()`. Validation and unknown-token
+ * reporting are delegated to serde; this component only renders status
+ * feedback and routes the parsed state up to the shell.
+ *
+ * Ported verbatim from zudo-doc's
+ * `src/components/design-token-tweak/import-modal.tsx`. Intentional deltas:
+ *  - `deserialize` / `DesignTokenSchemaError` / `getDesignTokenSchema` come
+ *    from this package's serde (`./utils/design-token-serde`); the schema
+ *    id is read at render time from `panelConfig.schemaId` instead of
+ *    being a module-level constant.
+ *  - State types import from this package's state envelope.
+ *  - Modal class names are derived from `panelConfig.modalClassPrefix` via
+ *    `modalClass(...)` so a single config swap re-themes every dialog.
+ *
+ * Modal lifecycle uses the native `<dialog>` element via `showModal()` /
+ * `close()`. Every dismissal path (× button, backdrop click, Escape key, the
+ * programmatic "Close" button) routes through `dialog.close()` so the native
+ * `close` event — and thus `onClose` — fires exactly once per dismissal.
+ */
+import type { ColorTweakState, TweakState } from './state/tweak-state';
+export interface ImportModalProps {
+    onClose: () => void;
+    /** Called with the parsed state when the user hits "Load". The caller is
+     *  responsible for applying it to the panel + persisting it. */
+    onLoad: (state: TweakState) => void;
+    /** Color baseline filled in for fields absent from the payload. */
+    colorDefaults: ColorTweakState;
+}
+export declare function ImportModal({ onClose, onLoad, colorDefaults }: ImportModalProps): import("preact").JSX.Element;
+//# sourceMappingURL=import-modal.d.ts.map

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

@@ -0,0 +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"}

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Design-token panel adapter.
+ *
+ * Thin bridge between the package's Astro host adapter
+ * (`./astro/host-adapter.ts`) and the Preact panel component
+ * (`./panel.tsx`). Responsibilities:
+ *
+ *  1. Expose the public API consumed by the host adapter —
+ *     `showDesignTokenPanel`, `hideDesignTokenPanel`, `toggleDesignPanel`.
+ *  2. Own the Preact mount lifecycle into the panel root element (id derived
+ *     from `panelConfig.storagePrefix`; default: `#zudo-design-token-panel-root`).
+ *  3. Cooperate with `panel.tsx`'s own toggle listeners: the adapter handles
+ *     the *initial* toggle (to mount the shell lazily) and then lets
+ *     `panel.tsx` own steady-state toggling via its internal window listener.
+ *  4. Handle Astro view-transition lifecycle — unmount before swap and
+ *     re-materialise the shell on `astro:page-load` when either the panel was
+ *     previously visible or token overrides are persisted.
+ *
+ * Storage keys (all derived from `panelConfig` — see `config/panel-config.ts`):
+ *
+ *  - `${storagePrefix}:visible` (default: `zudo-design-token-panel:visible`)
+ *    — adapter's visibility intent flag. Owned here (adapter-level concept);
+ *    no collision with the panel itself, so it keeps its historical colon-as-
+ *    separator form (every other derived key uses `-`).
+ *  - v2 storage key (imported via `getStorageKeyV2()` from `./state/tweak-state`)
+ *    — existence probe for persisted token overrides. The actual key value
+ *    is owned by `tweak-state.ts` (which also writes it). Routing the probe
+ *    through the same accessor guarantees probe-key ≡ write-key.
+ *  - `${storagePrefix}-open` (default: `zudo-design-token-panel-open`) —
+ *    primarily owned by `panel.tsx` (its `useEffect` mirrors `open` into the
+ *    key on every change). The adapter is read-only at steady state, but it
+ *    *seeds* the key once before a fresh mount so `panel.tsx`'s mount-effect
+ *    picks the desired open state on first paint instead of relying on a
+ *    racy post-render toggle event.
+ */
+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';
+/**
+ * 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
+ * `loadPanelModule()` runtime guard: the adapter
+ * compares the reference returned here against its own `getPanelConfig()`
+ * result. They MUST be the same object — Vite's multi-entry build code-
+ * splits the shared `config/panel-config` module into one chunk so both
+ * surfaces observe one and the same singleton. A reference mismatch indicates
+ * a future packaging refactor split the singleton across two chunks; the
+ * adapter `console.warn`s loudly so the regression is caught in dev.
+ *
+ * Prefixed `__` to make it clear this is internal/test surface, not a
+ * documented public API.
+ */
+export declare function __panelConfigForTest(): PanelConfig;
+export type { ColorClusterConfig } from './state/tweak-state';
+export { ZDTP_LEGACY_TYPOGRAPHY_RENAME_MAP } from './state/tweak-state';
+export type { ColorScheme, ColorRef } from './config/color-schemes';
+export type { TokenManifest, TokenDef } from './tokens/manifest';
+export type { TierValueKind, PillSpec, TierItem, TierConfig, TabConfig, ColorClusterExtras, } from './tokens/tier-model';
+export { isLengthKind, isNumberKind, isSelectKind, isTextKind, isColorKind, isCursorKind, isContentKind, isMaskImageKind, } from './tokens/tier-model';
+export type { TweakState } from './state/tweak-state';
+export { emptyOverrides } from './state/tweak-state';
+export declare function showDesignTokenPanel(): void;
+export declare function hideDesignTokenPanel(): void;
+export declare function toggleDesignPanel(): void;
+/**
+ * Apply persisted token overrides directly to `:root` BEFORE any Preact
+ * render. Called at adapter module init (and again on every `astro:page-load`)
+ * so the bundle's arrival is enough to kill the FOUT on hard navigation; the
+ * Preact shell still mounts separately when visibility intent requires it via
+ * `reapplyFromStorage()`.
+ *
+ * No-op when nothing is persisted. Swallows errors — missing storage or
+ * corrupt state should never block the UI thread (stylesheet defaults paint
+ * instead, same as before this helper existed).
+ */
+export declare function reapplyPersistedOverrides(): void;
+/**
+ * Framework-agnostic lifecycle hook adapter. A host that owns its own
+ * client-side navigation lifecycle (zfb, custom router, etc.) implements
+ * this and calls `setLifecycleAdapter(...)` so persisted overrides re-apply
+ * after every soft navigation without depending on Astro events.
+ *
+ * Each callback installer must return a cleanup function that unbinds the
+ * listener — `setLifecycleAdapter` calls these on re-registration and on
+ * `setLifecycleAdapter(null)`.
+ */
+export interface LifecycleAdapter {
+    /** Install a handler that fires before a client-side navigation swaps the document. */
+    onBeforeSwap?: (callback: () => void) => () => void;
+    /** Install a handler that fires after a client-side navigation has loaded the new page. */
+    onPageLoad?: (callback: () => void) => () => void;
+}
+/**
+ * Register a framework-agnostic lifecycle adapter (or pass `null` to
+ * restore the astro fallback). Safe to call before or after the module's
+ * import-time bootstrap — late registration drains the astro fallback's
+ * cleanup fns first, so the original document listeners are actively
+ * unbound and never double-fire alongside the adapter.
+ *
+ * No-op outside a browser context (SSR-safe).
+ */
+export declare function setLifecycleAdapter(adapter: LifecycleAdapter | null): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}