@takazudo/zdtp 0.4.4 → 0.4.5

package/dist/bin/server.js

@@ -1,20 +1,20 @@
 #!/usr/bin/env node
-import { realpathSync as H } from "node:fs";
-import { createServer as C } from "node:http";
-import { resolve as d } from "node:path";
-import { l as x, c as N } from "../load-routing-DtNTKoLW.js";
-function g(t, e) {
-  return typeof t != "string" || t.length === 0 || e.length === 0 ? !1 : e.includes(t);
+import { realpathSync as E } from "node:fs";
+import { createServer as H } from "node:http";
+import { resolve as p } from "node:path";
+import { l as $, c as x } from "../load-routing-LJ72261l.js";
+function g(o, t) {
+  return typeof o != "string" || o.length === 0 || t.length === 0 ? !1 : t.includes(o);
 }
-function w(t) {
+function w(o) {
   return {
-    "Access-Control-Allow-Origin": t,
+    "Access-Control-Allow-Origin": o,
     "Access-Control-Allow-Methods": "POST, OPTIONS",
     "Access-Control-Allow-Headers": "content-type",
     "Access-Control-Max-Age": "600"
   };
 }
-const k = 24681, b = "127.0.0.1", $ = `Usage: zdtp-server [options]
+const k = 24681, b = "127.0.0.1", N = `Usage: zdtp-server [options]
 
 Run a small Node http server that wraps the design-token apply handler.
 
@@ -39,8 +39,8 @@ Examples:
     --routing ./my.routing.json \\
     --allow-origin http://localhost:34434
 `;
-function v(t) {
-  const e = {
+function v(o) {
+  const t = {
     root: null,
     writeRoot: null,
     routing: null,
@@ -50,144 +50,148 @@ function v(t) {
     quiet: !1,
     help: !1
   };
-  let o = 0;
-  for (; o < t.length; ) {
-    const n = t[o];
+  let e = 0;
+  for (; e < o.length; ) {
+    const n = o[e];
     switch (n) {
       case "--help":
       case "-h":
-        e.help = !0, o += 1;
+        t.help = !0, e += 1;
         break;
       case "--quiet":
-        e.quiet = !0, o += 1;
+        t.quiet = !0, e += 1;
         break;
       case "--root":
-        e.root = c(t, o, "--root"), o += 2;
+        t.root = c(o, e, "--root"), e += 2;
         break;
       case "--write-root":
-        e.writeRoot = c(t, o, "--write-root"), o += 2;
+        t.writeRoot = c(o, e, "--write-root"), e += 2;
         break;
       case "--routing":
-        e.routing = c(t, o, "--routing"), o += 2;
+        t.routing = c(o, e, "--routing"), e += 2;
         break;
       case "--host":
-        e.host = c(t, o, "--host"), o += 2;
+        t.host = c(o, e, "--host"), e += 2;
         break;
       case "--port": {
-        const s = c(t, o, "--port"), r = Number(s);
+        const s = c(o, e, "--port"), r = Number(s);
         if (!Number.isInteger(r) || r < 0 || r > 65535)
           throw new Error(`--port must be an integer in 0..65535 (got ${JSON.stringify(s)})`);
-        e.port = r, o += 2;
+        t.port = r, e += 2;
         break;
       }
       case "--allow-origin": {
-        const s = c(t, o, "--allow-origin");
-        e.allowOrigins.push(s), o += 2;
+        const s = c(o, e, "--allow-origin");
+        t.allowOrigins.push(s), e += 2;
         break;
       }
       default:
         throw new Error(`Unknown option: ${n}`);
     }
   }
-  if (e.help) return e;
-  if (!e.writeRoot)
+  if (t.help) return t;
+  if (!t.writeRoot)
     throw new Error("--write-root is required (the only directory the bin will write into)");
-  if (!e.routing)
+  if (!t.routing)
     throw new Error("--routing is required (path to the routing JSON file)");
-  return e;
+  return t;
 }
-function c(t, e, o) {
-  const n = t[e + 1];
+function c(o, t, e) {
+  const n = o[t + 1];
   if (typeof n != "string" || n.startsWith("--"))
-    throw new Error(`${o} requires a value`);
+    throw new Error(`${e} requires a value`);
   return n;
 }
 const y = "/apply", D = "/healthz";
-function L(t) {
-  const e = d(t.root ?? process.cwd()), o = d(e, t.writeRoot), n = d(e, t.routing);
+function L(o) {
+  const t = p(o.root ?? process.cwd()), e = p(t, o.writeRoot), n = p(t, o.routing);
   return {
-    rootDir: e,
-    writeRoot: o,
+    rootDir: t,
+    writeRoot: e,
     routingPath: n,
-    port: t.port,
-    host: t.host,
-    allowOrigins: t.allowOrigins,
-    quiet: t.quiet
+    port: o.port,
+    host: o.host,
+    allowOrigins: o.allowOrigins,
+    quiet: o.quiet
   };
 }
-function a(t, e, o) {
-  const n = JSON.stringify(o);
-  t.statusCode = e, t.setHeader("Content-Type", "application/json"), t.setHeader("Content-Length", Buffer.byteLength(n).toString()), t.end(n);
+function a(o, t, e) {
+  const n = JSON.stringify(e);
+  o.statusCode = t, o.setHeader("Content-Type", "application/json"), o.setHeader("Content-Length", Buffer.byteLength(n).toString()), o.end(n);
 }
 const O = 1048576;
-function U(t) {
-  return new Promise((e, o) => {
+function j(o) {
+  return new Promise((t, e) => {
     const n = [];
     let s = 0;
-    t.on("data", (r) => {
+    o.on("data", (r) => {
       if (s += r.byteLength, s > O) {
-        e(413), t.destroy();
+        t(413), o.destroy();
         return;
       }
       n.push(r);
-    }), t.on("end", () => e(Buffer.concat(n).toString("utf-8"))), t.on("error", o);
+    }), o.on("end", () => t(Buffer.concat(n).toString("utf-8"))), o.on("error", e);
   });
 }
-function I(t) {
-  const e = new Headers();
-  for (const [o, n] of Object.entries(t.headers))
+function U(o) {
+  const t = new Headers();
+  for (const [e, n] of Object.entries(o.headers))
     if (Array.isArray(n))
-      for (const s of n) e.append(o, s);
-    else typeof n == "string" && e.set(o, n);
-  return e;
+      for (const s of n) t.append(e, s);
+    else typeof n == "string" && t.set(e, n);
+  return t;
 }
-async function j(t, e, o) {
-  t.statusCode = e.status, e.headers.forEach((s, r) => {
-    t.setHeader(r, s);
+async function I(o, t, e) {
+  o.statusCode = t.status, t.headers.forEach((s, r) => {
+    o.setHeader(r, s);
   });
-  for (const [s, r] of Object.entries(o))
-    t.setHeader(s, r);
-  const n = await e.text();
-  t.end(n);
+  for (const [s, r] of Object.entries(e))
+    o.setHeader(s, r);
+  const n = await t.text();
+  o.end(n);
 }
-function q(t, e) {
-  if (!t)
+function V(o, t) {
+  if (!o)
     try {
-      const o = JSON.parse(e);
-      if (!o.ok || !Array.isArray(o.updated)) return;
-      const n = o.updated.reduce(
+      const e = JSON.parse(t);
+      if (!e.ok || !Array.isArray(e.updated)) return;
+      const n = e.updated.reduce(
         (i, l) => i + (Array.isArray(l.changed) ? l.changed.length : 0),
         0
-      ), s = o.updated.length, r = o.updated.filter((i) => Array.isArray(i.changed) && i.changed.length > 0).map((i) => i.file);
+      ), s = e.updated.length, r = e.updated.filter((i) => Array.isArray(i.changed) && i.changed.length > 0).map((i) => i.file);
       console.log(
         `[design-token-panel] applied ${n} tokens to ${s} files (changed: ${r.length > 0 ? r.join(", ") : "none"})`
+      ), Array.isArray(e.unknownCssVars) && e.unknownCssVars.length > 0 && console.log(
+        `[design-token-panel] unknown: ${e.unknownCssVars.length} cssVar(s) not found (${e.unknownCssVars.join(", ")})`
+      ), Array.isArray(e.unknownOutsideBlockCssVars) && e.unknownOutsideBlockCssVars.length > 0 && console.log(
+        `[design-token-panel] outside scanned block: ${e.unknownOutsideBlockCssVars.length} of those cssVar(s) are declared in the file but outside the scanned :root/@theme block(s), so they were not rewritable (${e.unknownOutsideBlockCssVars.join(", ")})`
       );
     } catch {
     }
 }
-function F(t) {
-  const { applyHandler: e, config: o } = t;
+function B(o) {
+  const { applyHandler: t, config: e } = o;
   return async function(s, r) {
     const i = s.url ?? "/", l = (s.method ?? "GET").toUpperCase(), u = typeof s.headers.origin == "string" ? s.headers.origin : null;
     try {
       if (i === D && l === "GET") {
         a(r, 200, {
           ok: !0,
-          writeRoot: o.writeRoot,
-          routing: o.routingPath,
-          port: o.port
+          writeRoot: e.writeRoot,
+          routing: e.routingPath,
+          port: e.port
         });
         return;
       }
       if (i === y) {
         if (l === "OPTIONS") {
-          if (!g(u, o.allowOrigins)) {
+          if (!g(u, e.allowOrigins)) {
             a(r, 403, { ok: !1, error: "Origin not allowed" });
             return;
           }
           const S = w(u);
-          for (const [P, E] of Object.entries(S))
-            r.setHeader(P, E);
+          for (const [C, P] of Object.entries(S))
+            r.setHeader(C, P);
           r.statusCode = 204, r.end();
           return;
         }
@@ -195,16 +199,16 @@ function F(t) {
           r.setHeader("Allow", "POST, OPTIONS"), a(r, 405, { ok: !1, error: "Method not allowed" });
           return;
         }
-        const p = s.headers["content-type"];
-        if (typeof p != "string" || !p.toLowerCase().includes("application/json")) {
+        const d = s.headers["content-type"];
+        if (typeof d != "string" || !d.toLowerCase().includes("application/json")) {
           a(r, 415, { ok: !1, error: "Content-Type must be application/json" });
           return;
         }
-        if (!g(u, o.allowOrigins)) {
+        if (!g(u, e.allowOrigins)) {
           a(r, 403, { ok: !1, error: "Origin not allowed" });
           return;
         }
-        const f = await U(s);
+        const f = await j(s);
         if (f === 413) {
           a(r, 413, {
             ok: !1,
@@ -213,71 +217,71 @@ function F(t) {
           });
           return;
         }
-        const m = f, A = new Request(`http://localhost${y}`, {
+        const A = f, m = new Request(`http://localhost${y}`, {
           method: "POST",
-          headers: I(s),
-          body: m
-        }), h = await e(A), R = await h.clone().text(), T = w(u);
-        await j(r, h, T), q(o.quiet, R);
+          headers: U(s),
+          body: A
+        }), h = await t(m), R = await h.clone().text(), T = w(u);
+        await I(r, h, T), V(e.quiet, R);
         return;
       }
       a(r, 404, { ok: !1, error: "Not found" });
-    } catch (p) {
-      console.error("[design-token-panel] Unhandled error:", p), r.headersSent ? r.end() : a(r, 500, { ok: !1, error: "Internal server error" });
+    } catch (d) {
+      console.error("[design-token-panel] Unhandled error:", d), r.headersSent ? r.end() : a(r, 500, { ok: !1, error: "Internal server error" });
     }
   };
 }
-function _(t, e) {
-  t.on("error", (n) => {
-    n.code === "EADDRINUSE" && (console.error(`[design-token-panel] port ${e} already in use`), process.exit(1)), console.error("[design-token-panel] Server error:", n), process.exit(1);
+function q(o, t) {
+  o.on("error", (n) => {
+    n.code === "EADDRINUSE" && (console.error(`[design-token-panel] port ${t} already in use`), process.exit(1)), console.error("[design-token-panel] Server error:", n), process.exit(1);
   });
-  const o = (n) => {
-    t.close(() => {
+  const e = (n) => {
+    o.close(() => {
       process.exit(0);
     }), setTimeout(() => {
       console.error(`[design-token-panel] force-exiting after ${n}`), process.exit(0);
     }, 5e3).unref();
   };
-  process.on("SIGINT", o), process.on("SIGTERM", o);
+  process.on("SIGINT", e), process.on("SIGTERM", e);
 }
-function B() {
-  let t;
+function F() {
+  let o;
   try {
-    t = v(process.argv.slice(2));
+    o = v(process.argv.slice(2));
   } catch (r) {
     console.error(`[design-token-panel] ${r.message}`), console.error(""), console.error("Run --help for usage."), process.exit(1);
   }
-  t.help && (process.stdout.write($), process.exit(0));
-  const e = L(t);
-  let o;
+  o.help && (process.stdout.write(N), process.exit(0));
+  const t = L(o);
+  let e;
   try {
-    o = x(e.routingPath);
+    e = $(t.routingPath);
   } catch (r) {
     console.error(`[design-token-panel] Failed to load routing: ${r.message}`), process.exit(1);
   }
-  const n = N({
-    rootDir: e.rootDir,
-    writeRoot: e.writeRoot,
-    routing: o
-  }), s = C(F({ applyHandler: n, config: e }));
-  _(s, e.port), s.listen(e.port, e.host, () => {
-    if (!e.quiet) {
-      const r = s.address(), i = typeof r == "object" && r ? r.port : e.port;
+  const n = x({
+    rootDir: t.rootDir,
+    writeRoot: t.writeRoot,
+    routing: e
+  }), s = H(B({ applyHandler: n, config: t }));
+  q(s, t.port), s.listen(t.port, t.host, () => {
+    if (!t.quiet) {
+      const r = s.address(), i = typeof r == "object" && r ? r.port : t.port;
       console.log(
-        `[design-token-panel] listening on http://${e.host}:${i} (writeRoot: ${e.writeRoot})`
-      ), e.allowOrigins.length === 0 && console.log(
+        `[design-token-panel] listening on http://${t.host}:${i} (writeRoot: ${t.writeRoot})`
+      ), t.allowOrigins.length === 0 && console.log(
         "[design-token-panel] WARNING: no --allow-origin set; browser POST /apply will be rejected."
       );
     }
   });
 }
-const G = (() => {
+const _ = (() => {
   if (typeof process.argv[1] != "string") return !1;
   try {
-    const t = H(process.argv[1]), e = new URL(`file://${d(t)}`).href, o = import.meta.url;
-    return e === o;
+    const o = E(process.argv[1]), t = new URL(`file://${p(o)}`).href, e = import.meta.url;
+    return t === e;
   } catch {
     return !1;
   }
 })();
-G && B();
+_ && F();

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

@@ -86,7 +86,12 @@ export interface PanelConfig {
     consoleNamespace: string;
     /** BEM-style prefix used by every modal in the panel (export / import / apply). */
     modalClassPrefix: string;
-    /** `$schema` value emitted into export JSON and required on import. */
+    /**
+     * Schema label surfaced in the Import modal's hint/placeholder/error text
+     * and the Export modal's copy. NOT enforced: `serialize()`/`deserialize()`
+     * always use the fixed `SCHEMA_V1`/`SCHEMA_V2`/`SCHEMA_V3` constants
+     * regardless of this value (#498).
+     */
     schemaId: string;
     /** Default filename base — exports save as `${exportFilenameBase}.json`. */
     exportFilenameBase: string;
@@ -364,6 +369,24 @@ export declare function getPanelConfigByPrefix(prefix: string): PanelConfig | nu
  * instance, parked presets, and parked pre-configure hooks.
  */
 export declare function __resetPanelConfigForTests(): void;
+/**
+ * #501 — record that the panel instance keyed by `prefix` wrote `color-scheme`
+ * to its apply target. Called from the apply path (`applyColorState`) wherever
+ * a per-mode literal forces `color-scheme: light dark`.
+ */
+export declare function markColorSchemeWritten(prefix: string): void;
+/**
+ * #501 — drop the color-scheme ownership claim for `prefix`. Called from the
+ * clear paths after a panel-written `color-scheme` is removed (or found to have
+ * been overwritten by the host — the stale-ownership case).
+ */
+export declare function clearColorSchemeOwnership(prefix: string): void;
+/**
+ * #501 — true when the panel instance keyed by `prefix` is the recorded writer
+ * of the current inline `color-scheme`. Gates the clear paths so the panel
+ * never removes a `color-scheme` it did not write.
+ */
+export declare function ownsColorScheme(prefix: string): boolean;
 export { resolvePrimaryColorCluster, resolveSecondaryColorClusterFromTabs, } from './cluster-config';
 import type { ColorClusterDataConfig } from './cluster-config';
 /**
@@ -391,6 +414,18 @@ export declare function storageKey_stateV2(cfg: PanelConfig): string;
  * this key, then deletes the v2 key.
  */
 export declare function storageKey_stateV3(cfg: PanelConfig): string;
+/**
+ * Storage key for the v4 unified envelope. Upgrades the "global tweak model" to
+ * per-scheme color persistence (#500/#509): the `color` and `secondary` slices
+ * become identity-keyed sub-objects (one slot per resolved scheme/mode), so a
+ * per-scheme color tweak survives a scheme toggle round-trip instead of being
+ * clobbered by the next unrelated edit. Non-color slices stay global. Kept a
+ * SINGLE storage key (not one key per scheme) because the Astro bootstrap must
+ * existence-check persistence before cluster config loads — a per-scheme key
+ * would hit a chicken-and-egg there. v1/v2/v3 migrate into this key on first
+ * load; v4 takes precedence on every subsequent load.
+ */
+export declare function storageKey_stateV4(cfg: PanelConfig): string;
 /** Legacy v1 key (Color-only flat state). Migrated into v2 on first load, then deleted. */
 export declare function storageKey_stateV1(cfg: PanelConfig): string;
 /** Mirror of the panel's `open` boolean (synchronous mount-time read). */

package/dist/export-modal.d.ts

@@ -1,8 +1,10 @@
 /**
  * Export modal — renders the current `TweakState` as a design-tokens JSON
- * document (default schema: `zudo-design-tokens/v1`; configurable via
- * `panelConfig.schemaId`) with a diff-only toggle and a copy-to-clipboard
- * button.
+ * document (`serialize()` emits `SCHEMA_V2` or opportunistically `SCHEMA_V3`
+ * — see `./utils/design-token-serde`; `panelConfig.schemaId` is not read
+ * here or anywhere else in this package — it is a UI-label-only field on
+ * `PanelConfig` that hosts may read via `getDesignTokenSchema()`, #498) with
+ * a diff-only toggle and a copy-to-clipboard button.
  *
  * Ported verbatim from zudo-doc's
  * `src/components/design-token-tweak/export-modal.tsx`. Intentional deltas:

package/dist/import-modal.d.ts

@@ -1,16 +1,16 @@
 /**
- * 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.
+ * Import modal — accepts a pasted design-tokens JSON document and lifts it
+ * into a `TweakState` via `deserialize()`. `deserialize()` validates the
+ * `$schema` key against the fixed `SCHEMA_V1`/`SCHEMA_V2`/`SCHEMA_V3`
+ * constants exported by the serde — `panelConfig.schemaId` plays no part in
+ * that validation; it is a UI-label-only field (#498). This component does
+ * not read `schemaId` at all; the hint/placeholder/error copy below names
+ * the actual accepted constants directly.
  *
  * 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.
+ *  - `deserialize` / `DesignTokenSchemaError` come from this package's serde
+ *    (`./utils/design-token-serde`).
  *  - 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.

package/dist/index.d.ts

@@ -60,6 +60,7 @@ export type { TierValueKind, PillSpec, TierItem, TierConfig, TabConfig, ColorClu
 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 { SCHEMA_V1, SCHEMA_V2, SCHEMA_V3, } from './utils/design-token-serde';
 export { getClusterDefaultMode, resolvePerModeLiteral, resolveSemanticPreviewColor, } from './state/tweak-state';
 export declare function showDesignTokenPanel(): void;
 export declare function hideDesignTokenPanel(): void;