@takazudo/zudo-doc 3.3.0 → 4.0.0

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
-};