@takazudo/zdtp 0.4.4 → 0.4.5

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

@@ -19,11 +19,16 @@
  * opportunistically upgrades to v3 only when at least one semantic mapping is
  * one of the new `SemanticValue` object variants — v3 is a strict superset of
  * v2's shape, so this upgrade never loses information and never happens for a
- * doc that v2 could already represent losslessly. `deserialize()` accepts v1,
- * v2, and v3, and normalises to an internal `TweakState` regardless of which
- * schema was in the payload. Hosts that export v1 docs (custom `schemaId`) get
- * a `schema-mismatch` error on import unless they have opted into the
- * dual-accept path (see below).
+ * doc that v2 could already represent losslessly. `deserialize()` accepts
+ * exactly the three canonical `$schema` values above (`SCHEMA_V1`, `SCHEMA_V2`,
+ * `SCHEMA_V3`) and normalises to an internal `TweakState` regardless of which
+ * one was in the payload. `PanelConfig.schemaId` is a UI-label-only value
+ * (see `getDesignTokenSchema` below) that this package's own modals do NOT
+ * consult — `import-modal.tsx` / `export-modal.tsx` name the canonical
+ * constants directly in their copy. It is never consulted by
+ * `serialize()`/`deserialize()` either; a host that sets a custom `schemaId`
+ * still gets a `schema-mismatch` error importing any doc whose `$schema`
+ * isn't one of the three canonical constants (#498).
  *
  * ## v2 format
  *
@@ -98,15 +103,18 @@ export declare const SCHEMA_V3 = "zudo-design-tokens/v3";
 /**
  * Read the design-token schema id at call time.
  *
- * Returns the host-configured schema id from `cfg.schemaId`. Used as the
- * `$schema` value in legacy v1 exports (for hosts that have not upgraded their
- * config to v2) and as the expected-schema label the Import modal surfaces. The
- * canonical v2 serialize path always emits `SCHEMA_V2`.
+ * Returns the host-configured schema id from `cfg.schemaId`. This is a
+ * UI-label-only value on `PanelConfig` — it is never read by `serialize()`
+ * (which always emits `SCHEMA_V2` or `SCHEMA_V3`) or by `deserialize()`
+ * (which always validates against `SCHEMA_V1`/`SCHEMA_V2`/`SCHEMA_V3`); see
+ * the header comment above and #498. Neither `import-modal.tsx` nor
+ * `export-modal.tsx` calls this function — their copy names the actual
+ * `SCHEMA_V1`/`V2`/`V3` constants directly instead. This helper remains for
+ * hosts that want to read their own configured `schemaId` label without
+ * reaching into `PanelConfig` directly.
  *
  * `cfg` defaults to the active (most-recently-configured) instance so the
- * single-default path stays byte-identical. The Import modal threads its OWN
- * mounted instance config (multi-instance, #361) so a non-default panel
- * validates against ITS schema id, not the default's.
+ * single-default path stays byte-identical.
  */
 export declare function getDesignTokenSchema(cfg?: PanelConfig): string;
 /** External JSON value for a base-color / semantic-color entry (v1). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zdtp",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Dynamic design-token tweak panel — host-config-driven, framework-agnostic Preact UI.",
   "private": false,
   "license": "MIT",

package/dist/load-routing-DtNTKoLW.js

@@ -1,353 +0,0 @@
-import { promises as g, readFileSync as C } from "node:fs";
-import { relative as R, isAbsolute as T, sep as V, resolve as J, dirname as j, join as x } from "node:path";
-import { randomBytes as A } from "node:crypto";
-import { r as W } from "./route-tokens-to-files-1DvmWBdj.js";
-const F = /* @__PURE__ */ new Map();
-async function E(e, r) {
-  const n = (F.get(e) ?? Promise.resolve()).then(r, r), o = n.then(
-    () => {
-    },
-    () => {
-    }
-  );
-  F.set(e, o);
-  try {
-    return await n;
-  } finally {
-    F.get(e) === o && F.delete(e);
-  }
-}
-function z(e) {
-  return e.replace(/[\r\n\\;{}]/g, "");
-}
-const M = /^--[a-zA-Z0-9_-]+$/;
-function I(e) {
-  return typeof e == "string" && M.test(e);
-}
-function q(e, r) {
-  if (!r.endsWith(".css")) return !1;
-  const t = R(e, r);
-  return !(t === "" || t === "." || T(t) || t === ".." || t.startsWith(`..${V}`) || t.startsWith("../"));
-}
-function B(e) {
-  const r = {};
-  for (const [t, n] of Object.entries(e)) {
-    if (!I(t))
-      return { error: `Invalid cssVar name: ${JSON.stringify(t)}` };
-    if (typeof n != "string")
-      return { error: `Value for ${t} must be a string` };
-    r[t] = z(n);
-  }
-  return { sanitized: r };
-}
-class $ extends Error {
-  constructor(r = 'No top-level ":root { ... }" block found in source.') {
-    super(r), this.name = "NoRootBlockError", Object.setPrototypeOf(this, $.prototype);
-  }
-}
-function N(e) {
-  const r = e.length;
-  let t = 0, n = 0;
-  for (; t < r; ) {
-    const o = e[t];
-    if (o === "/" && e[t + 1] === "*") {
-      const s = e.indexOf("*/", t + 2);
-      if (s === -1) return null;
-      t = s + 2;
-      continue;
-    }
-    if (o === '"' || o === "'") {
-      const s = o;
-      for (t++; t < r && e[t] !== s; )
-        e[t] === "\\" && t + 1 < r && t++, t++;
-      t++;
-      continue;
-    }
-    if (o === "{") {
-      n++, t++;
-      continue;
-    }
-    if (o === "}") {
-      n > 0 && n--, t++;
-      continue;
-    }
-    if (n === 0 && o === ":" && e.startsWith(":root", t)) {
-      const s = t + 5, a = e[s] ?? "";
-      if (!_(a)) {
-        const l = Z(e, s);
-        if (l !== -1) {
-          const k = l + 1, c = D(e, k);
-          return c !== -1 ? { contentStart: k, contentEnd: c } : null;
-        }
-      }
-    }
-    t++;
-  }
-  return null;
-}
-function _(e) {
-  return /[A-Za-z0-9_-]/.test(e);
-}
-function Z(e, r) {
-  const t = e.length;
-  let n = r;
-  for (; n < t; ) {
-    const o = e[n];
-    if (o === " " || o === "	" || o === `
-` || o === "\r" || o === "\f") {
-      n++;
-      continue;
-    }
-    if (o === "/" && e[n + 1] === "*") {
-      const s = e.indexOf("*/", n + 2);
-      if (s === -1) return -1;
-      n = s + 2;
-      continue;
-    }
-    return o === "{" ? n : -1;
-  }
-  return -1;
-}
-function D(e, r) {
-  const t = e.length;
-  let n = r, o = 1;
-  for (; n < t; ) {
-    const s = e[n];
-    if (s === "/" && e[n + 1] === "*") {
-      const a = e.indexOf("*/", n + 2);
-      if (a === -1) return -1;
-      n = a + 2;
-      continue;
-    }
-    if (s === '"' || s === "'") {
-      const a = s;
-      for (n++; n < t && e[n] !== a; )
-        e[n] === "\\" && n + 1 < t && n++, n++;
-      n++;
-      continue;
-    }
-    if (s === "{") {
-      o++, n++;
-      continue;
-    }
-    if (s === "}") {
-      if (o--, o === 0) return n;
-      n++;
-      continue;
-    }
-    n++;
-  }
-  return -1;
-}
-function H(e) {
-  return e.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
-}
-function L(e) {
-  return e.replace(/\/\*[\s\S]*?\*\//g, (r) => " ".repeat(r.length));
-}
-function U(e, r, t) {
-  const n = r.startsWith("--") ? r.slice(2) : r, o = H(n), s = new RegExp("(?<![\\w-])(--" + o + ":)(\\s*)([\\s\\S]+?);"), a = L(e), l = s.exec(a);
-  if (!l) return { content: e, status: "unknown" };
-  const [k, c, f] = l, y = l.index, w = y + k.length, v = y + c.length + f.length, p = w - 1, O = e.slice(v, p).trim(), S = t.trim();
-  return O === S ? { content: e, status: "unchanged" } : { content: e.slice(0, y) + c + f + t + ";" + e.slice(w), status: "changed" };
-}
-function G(e, r) {
-  const t = Object.keys(r), n = N(e);
-  if (!n)
-    return {
-      updated: e,
-      changed: [],
-      unchanged: [],
-      unknown: [...t]
-    };
-  let o = e.slice(n.contentStart, n.contentEnd);
-  const s = [], a = [], l = [];
-  for (const c of t) {
-    const f = U(o, c, r[c]);
-    o = f.content, f.status === "changed" ? s.push(c) : f.status === "unchanged" ? a.push(c) : l.push(c);
-  }
-  return { updated: e.slice(0, n.contentStart) + o + e.slice(n.contentEnd), changed: s, unchanged: a, unknown: l };
-}
-function K(e, r) {
-  if (!N(e))
-    throw new $();
-  return G(e, r);
-}
-function u(e, r = 200) {
-  return new Response(JSON.stringify(e), {
-    status: r,
-    headers: { "Content-Type": "application/json" }
-  });
-}
-async function Q(e, r, t) {
-  const n = await g.readFile(e, "utf-8"), o = K(n, t);
-  return {
-    absPath: e,
-    relPath: r,
-    original: n,
-    updated: o.updated,
-    changed: o.changed,
-    unchanged: o.unchanged,
-    unknown: o.unknown
-  };
-}
-async function X(e) {
-  if (e.changed.length !== 0)
-    return E(e.absPath, async () => {
-      const r = j(e.absPath), t = x(r, `.tmp-${A(8).toString("hex")}.css`);
-      try {
-        await g.writeFile(t, e.updated, "utf-8"), await g.rename(t, e.absPath);
-      } catch (n) {
-        try {
-          await g.unlink(t);
-        } catch {
-        }
-        throw n;
-      }
-    });
-}
-async function Y(e) {
-  return E(e.absPath, async () => {
-    const r = j(e.absPath), t = x(r, `.tmp-${A(8).toString("hex")}.css`);
-    try {
-      return await g.writeFile(t, e.original, "utf-8"), await g.rename(t, e.absPath), { ok: !0 };
-    } catch (n) {
-      console.error("[design-token-panel/server] Restore failed for", e.relPath, n);
-      try {
-        await g.unlink(t);
-      } catch {
-      }
-      return { ok: !1, error: n };
-    }
-  });
-}
-function se(e) {
-  const { rootDir: r, writeRoot: t, routing: n } = e;
-  return async function(s) {
-    let a;
-    try {
-      a = await s.json();
-    } catch {
-      return u({ ok: !1, error: "Invalid JSON in request body" }, 400);
-    }
-    if (typeof a != "object" || a === null || Array.isArray(a))
-      return u({ ok: !1, error: "Request body must be a JSON object" }, 400);
-    const { tokens: l } = a;
-    if (typeof l != "object" || l === null || Array.isArray(l))
-      return u({ ok: !1, error: "tokens must be a JSON object" }, 400);
-    if (Object.entries(l).length === 0)
-      return u({ ok: !1, error: "tokens must contain at least one entry" }, 400);
-    const { sanitized: c, error: f } = B(l);
-    if (f || !c)
-      return u({ ok: !1, error: f ?? "Invalid tokens" }, 400);
-    const { groups: y, rejected: w } = W(c, n);
-    if (w.length > 0)
-      return u({ ok: !1, error: "Unsupported cssVar prefix", rejected: w }, 400);
-    if (y.length === 0)
-      return u({ ok: !1, error: "No routable tokens supplied" }, 400);
-    const v = [];
-    for (const i of y) {
-      const d = J(r, i.relativePath);
-      if (!q(t, d))
-        return u({ ok: !1, error: `Path not allowed: ${i.relativePath}` }, 400);
-      v.push({ absPath: d, relPath: i.relativePath, groupTokens: i.tokens });
-    }
-    const p = [];
-    for (const { absPath: i, relPath: d, groupTokens: m } of v)
-      try {
-        p.push(await Q(i, d, m));
-      } catch (h) {
-        return h instanceof $ ? (console.error("[design-token-panel/server] No :root block in", d), u(
-          {
-            ok: !1,
-            error: `No top-level :root { ... } block in ${d}`
-          },
-          409
-        )) : (console.error(`[design-token-panel/server] Error computing ${d}:`, h), u({ ok: !1, error: "Failed to read or parse source file" }, 500));
-      }
-    const b = [];
-    for (const i of p)
-      try {
-        await X(i), b.push(i);
-      } catch (d) {
-        console.error(`[design-token-panel/server] Write failed for ${i.relPath}:`, d);
-        const m = [];
-        for (let h = b.length - 1; h >= 0; h--)
-          (await Y(b[h])).ok || m.push(b[h].relPath);
-        return m.length > 0 ? u(
-          {
-            ok: !1,
-            error: `Failed to write file ${i.relPath}; rollback also failed for ${m.length} file(s) — disk state is inconsistent. Inspect the listed files manually.`,
-            failedFile: i.relPath,
-            restoreFailures: m
-          },
-          500
-        ) : u(
-          {
-            ok: !1,
-            error: `Failed to write file ${i.relPath}; previously-written files were restored.`,
-            failedFile: i.relPath
-          },
-          500
-        );
-      }
-    const O = p.flatMap((i) => i.unknown), S = p.flatMap((i) => i.unchanged), P = p.map((i) => ({
-      file: i.relPath.startsWith("/") ? R(r, i.relPath) : i.relPath,
-      changed: i.changed,
-      unchanged: i.unchanged,
-      unknown: i.unknown
-    }));
-    return u({
-      ok: !0,
-      updated: P,
-      unknownCssVars: O,
-      unchangedCssVars: S
-    });
-  };
-}
-function ie(e) {
-  let r;
-  try {
-    r = C(e, "utf-8");
-  } catch (s) {
-    throw new Error(
-      `[design-token-panel] loadRoutingFromFile: cannot read file at ${e}
-  Cause: ${s.message}`
-    );
-  }
-  let t;
-  try {
-    t = JSON.parse(r);
-  } catch (s) {
-    throw new Error(
-      `[design-token-panel] loadRoutingFromFile: invalid JSON in ${e}
-  Cause: ${s.message}`
-    );
-  }
-  if (t === null || typeof t != "object" || Array.isArray(t))
-    throw new Error(
-      `[design-token-panel] loadRoutingFromFile: root value must be a plain object, got ${t === null ? "null" : Array.isArray(t) ? "array" : typeof t} (in ${e})`
-    );
-  const n = t, o = Object.keys(n);
-  if (o.length === 0)
-    throw new Error(
-      `[design-token-panel] loadRoutingFromFile: routing map must not be empty (in ${e})`
-    );
-  for (const s of o) {
-    const a = n[s];
-    if (typeof a != "string" || a.trim() === "")
-      throw new Error(
-        `[design-token-panel] loadRoutingFromFile: every value must be a non-empty string, but key "${s}" has value ${JSON.stringify(a)} (in ${e})`
-      );
-  }
-  return n;
-}
-export {
-  M as C,
-  I as a,
-  se as c,
-  q as i,
-  ie as l,
-  E as s,
-  B as v
-};