@takazudo/zudo-doc 3.2.0 → 4.0.0

package/dist/theme/design-token-serde.d.ts

@@ -1,183 +0,0 @@
-/**
- * Design-token SerDe — unified JSON export / import for the design-token panel.
- *
- * Supersedes the legacy TypeScript-object export in `export-code.ts`. The JSON
- * format is a single document covering all four token categories (color,
- * spacing, font, size) so an AI assistant can consume or emit a whole
- * design-token tweak in one round-trip.
- *
- * Format: `$schema = "zudo-doc-design-tokens/v3"`.
- *
- * v3 color slice — ramp-native, minimized (Color Ramp Restructure,
- * zudolab/zudo-doc#2584 / #2591; minimized to 5/3 in #2602)
- * -----------------------------------------------------------------------------------
- * The color block is the ramp-native `ColorScheme` from `color-scheme-utils.ts`:
- *   - `ramps` — the shared Tier-1 source of truth (`base[5]`, `accent[3]`,
- *     `state{danger,success,warning,info}`), emitted verbatim as OKLCH strings.
- *   - `map`   — the per-mode Tier-2 wiring (`bg`/`fg`/`selectionBg`/`selectionFg`
- *     + 23 `semantic` roles), each a `RampRef` (`{base:n}` / `{accent:n}` /
- *     `{state:role}` / a literal OKLCH string).
- *
- * The legacy v1 color slice (`palette: string[16]`, numeric `base`, `cursor`,
- * `semanticMappings`) is gone. Both `ramps` and `map` are plain JSON data, so
- * the color block is essentially a serialized `ColorScheme`.
- *
- * v1 → v3 migration (RESET, not remap)
- * ------------------------------------
- * A persisted v1 payload (detected by `$schema === "…/v1"`, a `palette` array,
- * or a numeric `base` block) has NO faithful mapping to the new model: the old
- * 16-slot ghostty palette + numeric semantic indices do not correspond to the
- * 5-base / 3-accent / 4-state ramps + `RampRef` wiring. Any remap would invent
- * colors and mislead the user, so `deserialize` RESETS the color slice to the
- * caller-supplied baseline (the current default scheme) and emits a
- * `console.warn` + a `warnings[]` entry — no throw, no blank screen. The
- * spacing/font/size slices are format-compatible across v1/v3 and are preserved.
- *
- * v2 → v3 migration (RESET, schema-label-only — zudolab/zudo-doc#2599)
- * ---------------------------------------------------------------------
- * `v2` was the ramp-native label BEFORE the base-12/accent-7 → base-5/accent-3
- * minimize (#2602); the shape (`ramps` + `map` of `RampRef`s) never changed, only
- * the ramp lengths did. That means a `v2`-labeled payload is ambiguous in a way
- * `v1` never was: `parseRamps` catches a wrong-length `ramps.base`/`ramps.accent`
- * array and falls back to baseline, but `parseMap`'s `RampRef` parser only
- * shape-checks a numeric index (`{base:11}`) — it does NOT range-check it against
- * the ramp length, because that tolerance is also relied on by legitimate
- * already-5/3 round-trip exports (see the `{accent:5}`-style fixtures in the test
- * file). So an out-of-range ref alone can't tell a genuinely-stale pre-5/3 export
- * apart from an intentionally-tolerated current-shape ref — both look identical
- * once parsed. Rather than guess from ref values, `v2` is retired as a whole:
- * ANY payload still carrying the `v2` label (regardless of whether its arrays
- * happen to already be 5/3-shaped) is treated as legacy and RESET to baseline,
- * exactly like v1. Only payloads relabeled `v3` are trusted to resolve cleanly
- * against the current ramp lengths.
- *
- * Diff-only by default
- * --------------------
- * `serialize()` only emits tokens the user has actually changed relative to
- * the provided `colorDefaults` (for the color block) and the manifest defaults
- * (for spacing / font / size). Pass `includeDefaults: true` to dump the full
- * state instead. The whole-category keys (`color`, `spacing`, `font`, `size`)
- * are omitted entirely when nothing in them differs. For the color block the
- * `ramps` and `map` sub-blocks are each emitted whole (not per-stop / per-role
- * diffed) when they differ from the baseline — the ramp-native shape has no
- * stable per-slot index to diff against, and a whole-block emit round-trips
- * cleanly against the same baseline.
- *
- * Spacing / font / size keys use CSS variable names (`"--spacing-hsp-md"`) —
- * the external schema — rather than the internal token id (`"hsp-md"`). This
- * keeps the file human-readable and agnostic of our internal manifest.
- * `deserialize()` maps them back; unknown CSS vars are reported via
- * `unknownTokens` so the UI can surface them.
- *
- * Read-only manifest tokens (e.g. `--spacing-0`, `--zd-sidebar-w` with
- * `clamp()`) are skipped in both directions.
- *
- * W3B (#1730 — Generator Pages Migration): moved from
- * `src/utils/design-token-serde.ts` into v2. The manifest tokens
- * (`SPACING_TOKENS` / `FONT_TOKENS` / `SIZE_TOKENS`) are no longer
- * imported from the host's `@/config/design-tokens-manifest` — the
- * caller now passes them through `SerializeOptions.manifest` /
- * `DeserializeOptions.manifest`, preserving consumer override hooks.
- */
-interface TokenDef {
-    /** Stable id used as the Record key in persisted state (e.g. `hsp-2xs`). */
-    id: string;
-    /** CSS custom property name written to `:root` (e.g. `--zd-spacing-hgap-2xs`). */
-    cssVar: string;
-    /** Default value as a CSS length string (e.g. `0.125rem`). */
-    default: string;
-    /** Read-only tokens are displayed but not editable. */
-    readonly?: true;
-}
-import { type TweakState } from "./design-token-types.js";
-import { type ColorScheme, type ModeMap, type Ramps } from "../color-scheme-utils.js";
-export declare const DESIGN_TOKEN_SCHEMA: "zudo-doc-design-tokens/v3";
-/** External JSON color block — a (possibly diff-only) serialized `ColorScheme`.
- *  Both sub-blocks are optional: in diff-only output an unchanged `ramps` or
- *  `map` is omitted and filled from the baseline on deserialize. */
-export interface DesignTokenJsonColor {
-    ramps?: Ramps;
-    map?: ModeMap;
-}
-/** External token map keyed by CSS var name. */
-export type DesignTokenJsonOverrides = Record<string, string>;
-export interface DesignTokenJson {
-    $schema: typeof DESIGN_TOKEN_SCHEMA;
-    exportedAt: string;
-    color?: DesignTokenJsonColor;
-    spacing?: DesignTokenJsonOverrides;
-    font?: DesignTokenJsonOverrides;
-    size?: DesignTokenJsonOverrides;
-}
-/**
- * Token manifest the caller hands in — the consumer's
- * `src/config/design-tokens-manifest.ts` (or generator override). v2
- * doesn't ship its own manifest; this is intentionally a caller concern
- * so each consumer keeps full control over the editable token set.
- */
-export interface DesignTokenManifest {
-    spacing: readonly TokenDef[];
-    font: readonly TokenDef[];
-    size: readonly TokenDef[];
-}
-export interface SerializeOptions {
-    /** Token manifest (spacing / font / size arrays) used to compute
-     *  diff-only output and resolve CSS-var names. Required. */
-    manifest: DesignTokenManifest;
-    /** When true, dump full state (whole `ramps` + `map`, all token manifest
-     *  defaults merged in). Default: diff-only. */
-    includeDefaults?: boolean;
-    /** Color baseline to diff against — typically the active scheme's initial
-     *  `ColorScheme`. Required for meaningful color-diff output; callers that
-     *  don't have it available (e.g. tests without DOM) can omit it and we'll
-     *  treat the whole color block as changed. */
-    colorDefaults?: ColorScheme;
-    /** Override the `exportedAt` stamp (test-only). */
-    now?: () => Date;
-}
-export interface DeserializeResult {
-    /** The reconstructed tweak state, with unknown-token values dropped. */
-    state: TweakState;
-    /** CSS var names present in the payload that don't match any known token. */
-    unknownTokens: string[];
-    /** Human-readable errors that did not prevent a state from being produced
-     *  (e.g. "v1 payload detected; color reset to default"). */
-    warnings: string[];
-}
-export interface DeserializeOptions {
-    /** Token manifest (spacing / font / size arrays) used to resolve CSS-var
-     *  names back to internal token ids. Required. */
-    manifest: DesignTokenManifest;
-    /** Color baseline used to fill in fields absent from the payload (diff-only
-     *  exports are missing most fields by design) and as the reset target for a
-     *  v1 migration. Typically the active scheme's initial `ColorScheme`. */
-    colorDefaults?: ColorScheme;
-}
-/** Thrown when the payload is not a recognized schema object. The error
- *  `.reason` helps the UI render a precise inline message. A v1 payload is NOT
- *  thrown for — it is migrated (see `deserialize`). */
-export declare class DesignTokenSchemaError extends Error {
-    readonly reason: "not-object" | "schema-missing" | "schema-mismatch";
-    readonly actualSchema?: unknown;
-    constructor(reason: "not-object" | "schema-missing" | "schema-mismatch", message: string, actualSchema?: unknown);
-}
-/**
- * Produce the external JSON document for a given tweak state.
- *
- * By default this is diff-only against `opts.colorDefaults` + manifest
- * defaults; set `opts.includeDefaults = true` to dump everything.
- */
-export declare function serialize(state: TweakState, opts: SerializeOptions): DesignTokenJson;
-/**
- * Parse a design-token JSON document and lift it back into a tweak state.
- *
- * Throws `DesignTokenSchemaError` on schema mismatch / non-object input. A v1
- * (palette-based) payload is NOT thrown for — its color slice is reset to the
- * baseline default (see the v1→v2 migration note at the top). Any CSS var name
- * that doesn't match a known manifest entry is collected into `unknownTokens`.
- *
- * Missing fields fall back to `opts.colorDefaults` (or, absent that, a
- * minimal neutral default) so the result is always a valid `TweakState`.
- */
-export declare function deserialize(input: unknown, opts: DeserializeOptions): DeserializeResult;
-export {};

package/dist/theme/design-token-serde.js

@@ -1,346 +0,0 @@
-import {
-  emptyOverrides
-} from "./design-token-types.js";
-import {
-  SEMANTIC_KEYS,
-  SEMANTIC_RAMP_DEFAULTS,
-  STATE_ROLES
-} from "../color-scheme-utils.js";
-const DESIGN_TOKEN_SCHEMA = "zudo-doc-design-tokens/v3";
-const LEGACY_SCHEMA_V1 = "zudo-doc-design-tokens/v1";
-const LEGACY_SCHEMA_V2 = "zudo-doc-design-tokens/v2";
-const BASE_RAMP_LENGTH = 5;
-const ACCENT_RAMP_LENGTH = 3;
-class DesignTokenSchemaError extends Error {
-  reason;
-  actualSchema;
-  constructor(reason, message, actualSchema) {
-    super(message);
-    this.name = "DesignTokenSchemaError";
-    this.reason = reason;
-    this.actualSchema = actualSchema;
-  }
-}
-function serialize(state, opts) {
-  const now = opts.now ? opts.now() : /* @__PURE__ */ new Date();
-  const out = {
-    $schema: DESIGN_TOKEN_SCHEMA,
-    exportedAt: now.toISOString()
-  };
-  const color = serializeColor(state.color, opts);
-  if (color) out.color = color;
-  const spacing = serializeOverrides(opts.manifest.spacing, state.spacing, opts);
-  if (spacing) out.spacing = spacing;
-  const font = serializeOverrides(opts.manifest.font, state.font, opts);
-  if (font) out.font = font;
-  const size = serializeOverrides(opts.manifest.size, state.size, opts);
-  if (size) out.size = size;
-  return out;
-}
-function serializeColor(color, opts) {
-  const baseline = opts.colorDefaults;
-  const full = opts.includeDefaults === true;
-  const out = {};
-  let changed = false;
-  if (full || !baseline || !deepEqual(color.ramps, baseline.ramps)) {
-    out.ramps = cloneRamps(color.ramps);
-    changed = true;
-  }
-  if (full || !baseline || !deepEqual(color.map, baseline.map)) {
-    out.map = cloneMap(color.map);
-    changed = true;
-  }
-  return changed ? out : void 0;
-}
-function serializeOverrides(manifest, overrides, opts) {
-  const full = opts.includeDefaults === true;
-  const out = {};
-  let wrote = false;
-  if (full) {
-    for (const t of manifest) {
-      if (t.readonly) continue;
-      const v = overrides[t.id];
-      out[t.cssVar] = typeof v === "string" && v.length > 0 ? v : t.default;
-      wrote = true;
-    }
-  } else {
-    for (const t of manifest) {
-      if (t.readonly) continue;
-      const v = overrides[t.id];
-      if (typeof v === "string" && v.length > 0 && v !== t.default) {
-        out[t.cssVar] = v;
-        wrote = true;
-      }
-    }
-  }
-  return wrote ? out : void 0;
-}
-function deserialize(input, opts) {
-  if (input === null || typeof input !== "object") {
-    throw new DesignTokenSchemaError(
-      "not-object",
-      "Input is not a JSON object."
-    );
-  }
-  const obj = input;
-  const schema = obj.$schema;
-  if (schema === void 0) {
-    throw new DesignTokenSchemaError(
-      "schema-missing",
-      `Missing "$schema" key. Expected "${DESIGN_TOKEN_SCHEMA}".`
-    );
-  }
-  const legacyV1 = schema === LEGACY_SCHEMA_V1;
-  const legacyV2 = schema === LEGACY_SCHEMA_V2;
-  if (schema !== DESIGN_TOKEN_SCHEMA && !legacyV1 && !legacyV2) {
-    throw new DesignTokenSchemaError(
-      "schema-mismatch",
-      `Unsupported "$schema" value: ${JSON.stringify(schema)}. Expected "${DESIGN_TOKEN_SCHEMA}".`,
-      schema
-    );
-  }
-  const warnings = [];
-  const unknownTokens = [];
-  const baseline = opts.colorDefaults ?? neutralColorDefaults();
-  const color = deserializeColor(obj.color, baseline, warnings, legacyV1, legacyV2);
-  const spacing = deserializeOverrides(
-    obj.spacing,
-    opts.manifest.spacing,
-    "spacing",
-    unknownTokens,
-    warnings
-  );
-  const font = deserializeOverrides(
-    obj.font,
-    opts.manifest.font,
-    "font",
-    unknownTokens,
-    warnings
-  );
-  const size = deserializeOverrides(
-    obj.size,
-    opts.manifest.size,
-    "size",
-    unknownTokens,
-    warnings
-  );
-  return {
-    state: { color, spacing, font, size },
-    unknownTokens,
-    warnings
-  };
-}
-function isLegacyColorPayload(raw) {
-  if (!raw || typeof raw !== "object") return false;
-  const c = raw;
-  return Array.isArray(c.palette) || c.base !== void 0;
-}
-function deserializeColor(raw, baseline, warnings, legacyV1, legacyV2) {
-  if (legacyV1 || isLegacyColorPayload(raw)) {
-    const msg = "Legacy v1 design-token color state detected; color was reset to the default scheme (the old 16-slot palette has no faithful ramp mapping).";
-    warnings.push(msg);
-    console.warn(`[zudo-doc] ${msg}`);
-    return cloneScheme(baseline);
-  }
-  if (legacyV2) {
-    const msg = "Legacy v2 design-token color state detected (pre-5/3-minimize ramps); color was reset to the default scheme.";
-    warnings.push(msg);
-    console.warn(`[zudo-doc] ${msg}`);
-    return cloneScheme(baseline);
-  }
-  if (!raw || typeof raw !== "object") {
-    return cloneScheme(baseline);
-  }
-  const c = raw;
-  const ramps = parseRamps(c.ramps, baseline.ramps, warnings);
-  const map = parseMap(c.map, baseline.map, warnings);
-  return { ramps, map };
-}
-function parseRamps(raw, baseline, warnings) {
-  if (raw === void 0) return cloneRamps(baseline);
-  if (!raw || typeof raw !== "object") {
-    warnings.push("color.ramps is not an object; kept baseline ramps.");
-    return cloneRamps(baseline);
-  }
-  const r = raw;
-  const base = parseOklchArray(r.base, BASE_RAMP_LENGTH, "color.ramps.base", warnings) ?? [...baseline.base];
-  const accent = parseOklchArray(r.accent, ACCENT_RAMP_LENGTH, "color.ramps.accent", warnings) ?? [...baseline.accent];
-  const state = parseState(r.state, baseline.state, warnings);
-  return { base, accent, state };
-}
-function parseOklchArray(raw, expectedLength, label, warnings) {
-  if (!Array.isArray(raw)) {
-    warnings.push(`${label}: expected an array of ${expectedLength} strings; kept baseline.`);
-    return null;
-  }
-  const strings = raw.filter((v) => typeof v === "string" && v.length > 0);
-  if (strings.length !== expectedLength || strings.length !== raw.length) {
-    warnings.push(
-      `${label}: expected ${expectedLength} non-empty string entries; got ${raw.length} (${strings.length} valid). Kept baseline.`
-    );
-    return null;
-  }
-  return strings;
-}
-function parseState(raw, baseline, warnings) {
-  const src = raw && typeof raw === "object" ? raw : {};
-  const out = {};
-  for (const role of STATE_ROLES) {
-    const v = src[role];
-    if (typeof v === "string" && v.length > 0) {
-      out[role] = v;
-    } else {
-      if (v !== void 0) {
-        warnings.push(`color.ramps.state.${role} is not a non-empty string; kept baseline.`);
-      }
-      out[role] = baseline[role];
-    }
-  }
-  return out;
-}
-function parseMap(raw, baseline, warnings) {
-  if (raw === void 0) return cloneMap(baseline);
-  if (!raw || typeof raw !== "object") {
-    warnings.push("color.map is not an object; kept baseline map.");
-    return cloneMap(baseline);
-  }
-  const m = raw;
-  const semRaw = m.semantic && typeof m.semantic === "object" ? m.semantic : {};
-  const semantic = {};
-  for (const key of SEMANTIC_KEYS) {
-    semantic[key] = parseRef(semRaw[key], baseline.semantic[key], `color.map.semantic.${key}`, warnings);
-  }
-  return {
-    bg: parseRef(m.bg, baseline.bg, "color.map.bg", warnings),
-    fg: parseRef(m.fg, baseline.fg, "color.map.fg", warnings),
-    selectionBg: parseRef(m.selectionBg, baseline.selectionBg, "color.map.selectionBg", warnings),
-    selectionFg: parseRef(m.selectionFg, baseline.selectionFg, "color.map.selectionFg", warnings),
-    semantic
-  };
-}
-function parseRef(raw, fallback, label, warnings) {
-  if (raw === void 0) return cloneRef(fallback);
-  if (isValidRampRef(raw)) return cloneRef(raw);
-  warnings.push(`${label} is not a valid RampRef (${JSON.stringify(raw)}); kept baseline.`);
-  return cloneRef(fallback);
-}
-function isValidRampRef(v) {
-  if (typeof v === "string") return v.length > 0;
-  if (!v || typeof v !== "object") return false;
-  const o = v;
-  if ("base" in o) return isRampIndex(o.base);
-  if ("accent" in o) return isRampIndex(o.accent);
-  if ("state" in o) {
-    return typeof o.state === "string" && STATE_ROLES.includes(o.state);
-  }
-  return false;
-}
-function isRampIndex(v) {
-  return typeof v === "number" && Number.isInteger(v) && v >= 0;
-}
-function deserializeOverrides(raw, manifest, label, unknownTokens, warnings) {
-  if (!raw || typeof raw !== "object") return emptyOverrides();
-  const byVar = /* @__PURE__ */ new Map();
-  for (const t of manifest) {
-    if (t.readonly) continue;
-    byVar.set(t.cssVar, t);
-  }
-  const out = {};
-  for (const [cssVar, value] of Object.entries(raw)) {
-    const t = byVar.get(cssVar);
-    if (!t) {
-      unknownTokens.push(cssVar);
-      continue;
-    }
-    if (typeof value !== "string" || value.length === 0) {
-      warnings.push(
-        `${label}.${cssVar} is not a non-empty string; ignored.`
-      );
-      continue;
-    }
-    out[t.id] = value;
-  }
-  return out;
-}
-function cloneRef(ref) {
-  return typeof ref === "string" ? ref : { ...ref };
-}
-function cloneRamps(ramps) {
-  return {
-    base: [...ramps.base],
-    accent: [...ramps.accent],
-    state: { ...ramps.state }
-  };
-}
-function cloneMap(map) {
-  const semantic = {};
-  for (const key of SEMANTIC_KEYS) {
-    semantic[key] = cloneRef(map.semantic[key]);
-  }
-  return {
-    bg: cloneRef(map.bg),
-    fg: cloneRef(map.fg),
-    selectionBg: cloneRef(map.selectionBg),
-    selectionFg: cloneRef(map.selectionFg),
-    semantic
-  };
-}
-function cloneScheme(scheme) {
-  return { ramps: cloneRamps(scheme.ramps), map: cloneMap(scheme.map) };
-}
-function deepEqual(a, b) {
-  if (a === b) return true;
-  if (typeof a !== typeof b) return false;
-  if (Array.isArray(a) || Array.isArray(b)) {
-    if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
-    return a.every((v, i) => deepEqual(v, b[i]));
-  }
-  if (a && b && typeof a === "object" && typeof b === "object") {
-    const ao = a;
-    const bo = b;
-    const aKeys = Object.keys(ao);
-    const bKeys = Object.keys(bo);
-    if (aKeys.length !== bKeys.length) return false;
-    return aKeys.every((k) => Object.prototype.hasOwnProperty.call(bo, k) && deepEqual(ao[k], bo[k]));
-  }
-  return false;
-}
-function neutralColorDefaults() {
-  const base = [
-    "oklch(0.965 0 0)",
-    "oklch(0.705 0 0)",
-    "oklch(0.480 0 0)",
-    "oklch(0.300 0 0)",
-    "oklch(0.185 0 0)"
-  ];
-  const accent = [
-    "oklch(0.755 0 0)",
-    "oklch(0.700 0 0)",
-    "oklch(0.470 0 0)"
-  ];
-  return {
-    ramps: {
-      base,
-      accent,
-      state: {
-        danger: "oklch(0.640 0.170 25)",
-        success: "oklch(0.680 0.145 145)",
-        warning: "oklch(0.760 0.135 82)",
-        info: "oklch(0.680 0.130 245)"
-      }
-    },
-    map: {
-      bg: { base: 4 },
-      fg: { base: 0 },
-      selectionBg: { base: 2 },
-      selectionFg: { base: 0 },
-      semantic: { ...SEMANTIC_RAMP_DEFAULTS }
-    }
-  };
-}
-export {
-  DESIGN_TOKEN_SCHEMA,
-  DesignTokenSchemaError,
-  deserialize,
-  serialize
-};

package/dist/theme/design-token-types.d.ts

@@ -1,13 +0,0 @@
-import type { ColorScheme } from "../color-scheme-utils.js";
-/** The per-scheme color state the design-token panel edits — a ramp-native
- *  `ColorScheme`. Retained as a named alias so call sites reading
- *  `ColorTweakState` keep compiling after the ramp restructure. */
-export type ColorTweakState = ColorScheme;
-export type TokenOverrides = Record<string, string>;
-export interface TweakState {
-    color: ColorScheme;
-    spacing: TokenOverrides;
-    font: TokenOverrides;
-    size: TokenOverrides;
-}
-export declare function emptyOverrides(): TokenOverrides;

package/dist/theme/design-token-types.js

@@ -1,6 +0,0 @@
-function emptyOverrides() {
-  return {};
-}
-export {
-  emptyOverrides
-};

package/dist/theme/iframe-bridge.d.ts

@@ -1,42 +0,0 @@
-export declare const BRIDGE_SOURCE: "zudo-doc-theme-bridge";
-export type CssVarPair = readonly [name: string, value: string];
-export interface ApplyCssVarsMessage {
-    source: typeof BRIDGE_SOURCE;
-    type: "apply-css-vars";
-    vars: ReadonlyArray<CssVarPair>;
-}
-export interface ClearCssVarsMessage {
-    source: typeof BRIDGE_SOURCE;
-    type: "clear-css-vars";
-    names: ReadonlyArray<string>;
-}
-export interface ReadyMessage {
-    source: typeof BRIDGE_SOURCE;
-    type: "ready";
-}
-export interface ErrorMessage {
-    source: typeof BRIDGE_SOURCE;
-    type: "error";
-    reason: string;
-}
-export type BridgeMessage = ApplyCssVarsMessage | ClearCssVarsMessage | ReadyMessage | ErrorMessage;
-/**
- * Type guard. Accepts any postMessage payload and confirms it is a bridge
- * envelope. Foreign messages are ignored silently.
- */
-export declare function isBridgeMessage(value: unknown): value is BridgeMessage;
-/** Send `apply-css-vars` to the iframe. No-op when the iframe has not loaded. */
-export declare function sendApplyCssVars(iframe: HTMLIFrameElement | null, vars: ReadonlyArray<CssVarPair>): void;
-/** Send `clear-css-vars` to the iframe so it removes inline overrides. */
-export declare function sendClearCssVars(iframe: HTMLIFrameElement | null, names: ReadonlyArray<string>): void;
-/**
- * Install a message listener inside the preview iframe document that applies
- * any incoming CSS-var batches onto `documentElement.style`. Returns a
- * teardown function. Intended to be called once at iframe boot.
- */
-export declare function installIframeReceiver(target?: Window): () => void;
-/**
- * Install a `ready` listener on the panel side so callers can defer the
- * initial CSS-var sync until the iframe document has booted.
- */
-export declare function onIframeReady(expectedSource: Window | null, callback: () => void): () => void;

package/dist/theme/iframe-bridge.js

@@ -1,72 +0,0 @@
-const BRIDGE_SOURCE = "zudo-doc-theme-bridge";
-function isBridgeMessage(value) {
-  if (!value || typeof value !== "object") return false;
-  const v = value;
-  return v.source === BRIDGE_SOURCE && typeof v.type === "string";
-}
-function sendApplyCssVars(iframe, vars) {
-  const win = iframe?.contentWindow;
-  if (!win) return;
-  const message = {
-    source: BRIDGE_SOURCE,
-    type: "apply-css-vars",
-    vars
-  };
-  win.postMessage(message, window.location.origin);
-}
-function sendClearCssVars(iframe, names) {
-  const win = iframe?.contentWindow;
-  if (!win) return;
-  const message = {
-    source: BRIDGE_SOURCE,
-    type: "clear-css-vars",
-    names
-  };
-  win.postMessage(message, window.location.origin);
-}
-function installIframeReceiver(target = window) {
-  function handler(event) {
-    if (event.origin !== target.location.origin) return;
-    const data = event.data;
-    if (!isBridgeMessage(data)) return;
-    if (data.type === "apply-css-vars") {
-      const root = target.document.documentElement;
-      for (const [name, value] of data.vars) {
-        root.style.setProperty(name, value);
-      }
-      return;
-    }
-    if (data.type === "clear-css-vars") {
-      const root = target.document.documentElement;
-      for (const name of data.names) {
-        root.style.removeProperty(name);
-      }
-      return;
-    }
-  }
-  target.addEventListener("message", handler);
-  const parent = target.parent;
-  if (parent && parent !== target) {
-    const ready = { source: BRIDGE_SOURCE, type: "ready" };
-    parent.postMessage(ready, target.location.origin);
-  }
-  return () => target.removeEventListener("message", handler);
-}
-function onIframeReady(expectedSource, callback) {
-  function handler(event) {
-    if (event.origin !== window.location.origin) return;
-    if (expectedSource && event.source !== expectedSource) return;
-    if (!isBridgeMessage(event.data)) return;
-    if (event.data.type === "ready") callback();
-  }
-  window.addEventListener("message", handler);
-  return () => window.removeEventListener("message", handler);
-}
-export {
-  BRIDGE_SOURCE,
-  installIframeReceiver,
-  isBridgeMessage,
-  onIframeReady,
-  sendApplyCssVars,
-  sendClearCssVars
-};