@zeroxsolutions/zaku 0.0.2 → 0.0.3

package/dist/zaku.mjs

@@ -17351,49 +17351,49 @@ var require_fast_uri = __commonJS({
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative, options, skipNormalization) {
+    function resolveComponent(base, relative2, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse4(serialize(base, options), options);
-        relative = parse4(serialize(relative, options), options);
+        relative2 = parse4(serialize(relative2, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative.scheme) {
-        target.scheme = relative.scheme;
-        target.userinfo = relative.userinfo;
-        target.host = relative.host;
-        target.port = relative.port;
-        target.path = removeDotSegments(relative.path || "");
-        target.query = relative.query;
+      if (!options.tolerant && relative2.scheme) {
+        target.scheme = relative2.scheme;
+        target.userinfo = relative2.userinfo;
+        target.host = relative2.host;
+        target.port = relative2.port;
+        target.path = removeDotSegments(relative2.path || "");
+        target.query = relative2.query;
       } else {
-        if (relative.userinfo !== void 0 || relative.host !== void 0 || relative.port !== void 0) {
-          target.userinfo = relative.userinfo;
-          target.host = relative.host;
-          target.port = relative.port;
-          target.path = removeDotSegments(relative.path || "");
-          target.query = relative.query;
+        if (relative2.userinfo !== void 0 || relative2.host !== void 0 || relative2.port !== void 0) {
+          target.userinfo = relative2.userinfo;
+          target.host = relative2.host;
+          target.port = relative2.port;
+          target.path = removeDotSegments(relative2.path || "");
+          target.query = relative2.query;
         } else {
-          if (!relative.path) {
+          if (!relative2.path) {
             target.path = base.path;
-            if (relative.query !== void 0) {
-              target.query = relative.query;
+            if (relative2.query !== void 0) {
+              target.query = relative2.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative.path[0] === "/") {
-              target.path = removeDotSegments(relative.path);
+            if (relative2.path[0] === "/") {
+              target.path = removeDotSegments(relative2.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative.path;
+                target.path = "/" + relative2.path;
               } else if (!base.path) {
-                target.path = relative.path;
+                target.path = relative2.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative2.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative.query;
+            target.query = relative2.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -17401,7 +17401,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative.fragment;
+      target.fragment = relative2.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -20678,10 +20678,10 @@ var require_dist2 = __commonJS({
 
 // apps/zaku-cli/src/cli.ts
 var import_reflect_metadata3 = __toESM(require_Reflect(), 1);
-import { readFile as readFile5 } from "node:fs/promises";
+import { readFile as readFile6 } from "node:fs/promises";
 import { createRequire } from "node:module";
 import { homedir as homedir2 } from "node:os";
-import { dirname as dirname4, join as join10, resolve as resolve2, sep } from "node:path";
+import { dirname as dirname4, join as join11, resolve as resolve2, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // node_modules/.pnpm/commander@15.0.0/node_modules/commander/lib/error.js
@@ -21859,7 +21859,7 @@ var Command = class _Command extends EventEmitter {
     this._outputConfiguration = {
       writeOut: (str) => process2.stdout.write(str),
       writeErr: (str) => process2.stderr.write(str),
-      outputError: (str, write) => write(str),
+      outputError: (str, write2) => write2(str),
       getOutHelpWidth: () => process2.stdout.isTTY ? process2.stdout.columns : void 0,
       getErrHelpWidth: () => process2.stderr.isTTY ? process2.stderr.columns : void 0,
       getOutHasColors: () => useColor() ?? (process2.stdout.isTTY && process2.stdout.hasColors?.()),
@@ -23844,11 +23844,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
       hasColors = this._outputConfiguration.getOutHasColors();
       helpWidth = this._outputConfiguration.getOutHelpWidth();
     }
-    const write = (str) => {
+    const write2 = (str) => {
       if (!hasColors) str = this._outputConfiguration.stripColor(str);
       return baseWrite(str);
     };
-    return { error: error62, write, hasColors, helpWidth };
+    return { error: error62, write: write2, hasColors, helpWidth };
   }
   /**
    * Output help information for this command.
@@ -24325,8 +24325,8 @@ function parseCssColour(value) {
     return null;
   return name === "oklch" ? oklchToRgba(l, x, y, round(alpha)) : oklabToRgba(l, x, y, round(alpha));
 }
-function rgbaToOklab(colour2) {
-  const [r, g, b] = [decode(colour2.r), decode(colour2.g), decode(colour2.b)];
+function rgbaToOklab(colour3) {
+  const [r, g, b] = [decode(colour3.r), decode(colour3.g), decode(colour3.b)];
   const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);
   const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);
   const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);
@@ -24341,12 +24341,12 @@ function deltaEOk(a, b) {
   const [l2, a2, b2] = rgbaToOklab(b);
   return Math.round(Math.hypot(l1 - l2, a1 - a2, b1 - b2, a.a - b.a) * 100 * 1e3) / 1e3;
 }
-function toHex(colour2) {
-  const channels = [colour2.r, colour2.g, colour2.b].map((value) => Math.round(clamp(value) * 255).toString(16).padStart(2, "0"));
+function toHex(colour3) {
+  const channels = [colour3.r, colour3.g, colour3.b].map((value) => Math.round(clamp(value) * 255).toString(16).padStart(2, "0"));
   return `#${channels.join("")}`;
 }
-function luminance(colour2) {
-  return 0.2126 * decode(colour2.r) + 0.7152 * decode(colour2.g) + 0.0722 * decode(colour2.b);
+function luminance(colour3) {
+  return 0.2126 * decode(colour3.r) + 0.7152 * decode(colour3.g) + 0.0722 * decode(colour3.b);
 }
 function contrastRatio(fg, bg) {
   const over = (front, back) => front * fg.a + back * (1 - fg.a);
@@ -44518,18 +44518,18 @@ function radiiOf(raw) {
   return fitRadii(corners, raw.width, raw.height);
 }
 function partOf(raw, at) {
-  const colour2 = (field, value) => {
+  const colour3 = (field, value) => {
     const parsed = parseCssColour(value);
     if (!parsed)
       throw new Error(`${at}, part ${raw.part}: ${field} is ${value}, which zaku does not read`);
     return parsed;
   };
-  const background = colour2("background", raw.background);
+  const background = colour3("background", raw.background);
   const gap = Number.parseFloat(raw.gap);
   return {
     background: background.a === 0 ? null : background,
-    color: colour2("color", raw.color),
-    borderColor: raw.borderWidths.some((width) => width > 0) ? colour2("borderColor", raw.borderColor) : null,
+    color: colour3("color", raw.color),
+    borderColor: raw.borderWidths.some((width) => width > 0) ? colour3("borderColor", raw.borderColor) : null,
     borderWidths: raw.borderWidths,
     width: raw.width,
     height: raw.height,
@@ -44611,7 +44611,6 @@ WriteRecipeHandler = __decorate2([
 
 // packages/zaku/dist/lib/handlers/save-library.js
 var import_tsyringe3 = __toESM(require_cjs(), 1);
-import { writeFile as writeFile2 } from "node:fs/promises";
 
 // packages/zaku/dist/lib/domain/copy-defaults.js
 var DEFAULT_COPY = { locales: ["en"], currencies: [] };
@@ -44790,12 +44789,18 @@ function designPaths(root) {
     maps: join2(root, "map"),
     outline: join2(root, "outline"),
     unmapped: join2(root, "outline", "unmapped.yaml"),
-    library: join2(root, "library.json"),
+    library: join2(root, "library"),
+    libraryIndex: join2(root, "library", "index.json"),
+    legacyLibrary: join2(root, "library.json"),
     tokens: join2(root, "tokens.json"),
     recipe: join2(root, "recipe.json")
   };
 }
 
+// packages/zaku/dist/lib/repositories/library-snapshot.js
+import { mkdir, readdir, readFile as readFile2, rename as rename2, rm, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join3, relative } from "node:path";
+
 // packages/zaku/dist/lib/domain/library.js
 var rgbaSchema = external_exports.object({ r: external_exports.number(), g: external_exports.number(), b: external_exports.number(), a: external_exports.number() }).strict();
 var libraryItemSchema = external_exports.object({
@@ -44873,6 +44878,253 @@ var variablePartSchema = external_exports.object({
 }).strict();
 var librarySnapshotSchema = libraryPartSchema.extend({ source: external_exports.string(), version: external_exports.string() }).strict();
 
+// packages/zaku/dist/lib/domain/library-files.js
+import { isDeepStrictEqual } from "node:util";
+var storedItemSchema = libraryItemSchema.partial().required({ nodeId: true, path: true, type: true, width: true, height: true }).extend({ bindings: libraryItemSchema.shape.bindings.optional(), glyph: rgbaSchema.optional() }).strict();
+var libraryFileSchema = external_exports.object({
+  name: external_exports.string(),
+  key: external_exports.string(),
+  variants: external_exports.array(external_exports.object({
+    key: external_exports.string(),
+    /** The items in the first mode of the index's tokens. */
+    items: external_exports.array(storedItemSchema),
+    /** Only the modes whose stored items differ from the first. */
+    modes: external_exports.array(external_exports.object({ combo: external_exports.record(external_exports.string(), external_exports.string()), items: external_exports.array(storedItemSchema) }).strict()).optional()
+  }).strict())
+}).strict();
+var libraryIndexSchema = librarySnapshotSchema.extend({
+  components: external_exports.array(libraryComponentSchema.omit({ variants: true }).extend({
+    file: external_exports.string(),
+    variants: external_exports.array(libraryVariantSchema.pick({ key: true, name: true, props: true }).strict())
+  }).strict())
+}).strict();
+var NULLABLE = [
+  "fill",
+  "stroke",
+  "textColor",
+  "padding",
+  "gap",
+  "radii",
+  "strokeWeights",
+  "fontSize",
+  "fontFamily",
+  "textStyleKey",
+  "componentKey"
+];
+var RESOLVED = ["fill", "stroke", "textColor", "glyph", "radii"];
+function colour(name, values) {
+  const value = name ? values[name] : void 0;
+  return value !== void 0 && typeof value === "object" ? value : null;
+}
+function expandItem(stored, values) {
+  const bindings = {
+    fill: null,
+    stroke: null,
+    textColor: null,
+    radius: null,
+    ...stored.bindings
+  };
+  const radius = bindings.radius ? values[bindings.radius] : void 0;
+  const glyph = stored.glyph ?? (bindings["glyph"] ? colour(bindings["glyph"], values) : null);
+  return {
+    nodeId: stored.nodeId,
+    path: stored.path,
+    type: stored.type,
+    fill: stored.fill !== void 0 ? stored.fill : colour(bindings.fill, values),
+    stroke: stored.stroke !== void 0 ? stored.stroke : colour(bindings.stroke, values),
+    textColor: stored.textColor !== void 0 ? stored.textColor : colour(bindings.textColor, values),
+    ...glyph ? { glyph } : {},
+    width: stored.width,
+    height: stored.height,
+    padding: stored.padding ?? null,
+    gap: stored.gap ?? null,
+    radii: stored.radii !== void 0 ? stored.radii : typeof radius === "number" ? [radius, radius, radius, radius] : null,
+    strokeWeights: stored.strokeWeights ?? null,
+    fontSize: stored.fontSize ?? null,
+    fontFamily: stored.fontFamily ?? null,
+    textStyleKey: stored.textStyleKey ?? null,
+    componentKey: stored.componentKey ?? null,
+    bindings
+  };
+}
+function compactItem(item, values) {
+  const stored = {
+    nodeId: item.nodeId,
+    path: item.path,
+    type: item.type,
+    width: item.width,
+    height: item.height
+  };
+  for (const field of NULLABLE)
+    if (item[field] !== null)
+      stored[field] = item[field];
+  if (item.glyph)
+    stored["glyph"] = item.glyph;
+  const bindings = Object.fromEntries(Object.entries(item.bindings).filter(([name, value]) => value !== null || name === "glyph"));
+  if (Object.keys(bindings).length > 0)
+    stored["bindings"] = bindings;
+  for (const field of RESOLVED) {
+    if (!(field in stored))
+      continue;
+    const without = { ...stored };
+    delete without[field];
+    if (isDeepStrictEqual(expandItem(without, values), item))
+      delete stored[field];
+  }
+  return isDeepStrictEqual(expandItem(stored, values), item) ? stored : item;
+}
+function comboKey(combo) {
+  return JSON.stringify(Object.entries(combo).sort(([a], [b]) => a.localeCompare(b)));
+}
+function fileName(name, key, taken) {
+  const slug2 = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "component";
+  const file2 = taken.has(slug2) ? `${slug2}-${key.slice(0, 8)}` : slug2;
+  taken.add(file2);
+  return `components/${file2}.json`;
+}
+function splitLibrary(snapshot) {
+  const valuesOf = new Map(snapshot.tokens.map((token) => [comboKey(token.combo), token.values]));
+  const taken = /* @__PURE__ */ new Set();
+  const files2 = /* @__PURE__ */ new Map();
+  const components = [];
+  for (const { variants, ...component2 } of snapshot.components) {
+    const file2 = fileName(component2.name, component2.key, taken);
+    files2.set(file2, {
+      name: component2.name,
+      key: component2.key,
+      variants: variants.map((variant) => {
+        const stored = variant.modes.map((mode) => ({
+          combo: mode.combo,
+          items: mode.items.map((item) => compactItem(item, valuesOf.get(comboKey(mode.combo)) ?? {}))
+        }));
+        const [first, ...rest] = stored;
+        const modes = rest.filter((mode) => !isDeepStrictEqual(mode.items, first?.items));
+        return { key: variant.key, items: first?.items ?? [], ...modes.length > 0 ? { modes } : {} };
+      })
+    });
+    components.push({
+      ...component2,
+      file: file2,
+      variants: variants.map(({ key, name, props }) => ({ key, name, props }))
+    });
+  }
+  return { index: { ...snapshot, components }, files: files2 };
+}
+function joinLibrary(index, files2) {
+  return {
+    ...index,
+    components: index.components.map(({ file: file2, variants, ...component2 }) => {
+      const stored = files2.get(file2);
+      if (!stored)
+        throw new Error(`library/${file2} is not loaded`);
+      return {
+        ...component2,
+        variants: variants.map((variant, at) => {
+          const items = stored.variants[at];
+          return {
+            ...variant,
+            modes: index.tokens.map((token) => ({
+              combo: token.combo,
+              items: (items?.modes?.find((mode) => comboKey(mode.combo) === comboKey(token.combo))?.items ?? items?.items ?? []).map((item) => expandItem(item, token.values))
+            }))
+          };
+        })
+      };
+    })
+  };
+}
+var ONE_LINE = 100;
+function write(value, pad, key) {
+  const line = JSON.stringify(value);
+  if (value === null || typeof value !== "object" || line.length <= ONE_LINE)
+    return line;
+  const inner = `${pad}  `;
+  if (Array.isArray(value)) {
+    if (value.length === 0)
+      return "[]";
+    const element = (child) => key === "items" ? JSON.stringify(child) : write(child, inner, null);
+    return `[
+${value.map((child) => `${inner}${element(child)}`).join(",\n")}
+${pad}]`;
+  }
+  const entries = Object.entries(value).filter(([, child]) => child !== void 0);
+  if (entries.length === 0)
+    return "{}";
+  return `{
+${entries.map(([name, child]) => `${inner}${JSON.stringify(name)}: ${write(child, inner, name)}`).join(",\n")}
+${pad}}`;
+}
+function formatLibraryFile(value) {
+  return `${write(value, "", null)}
+`;
+}
+
+// packages/zaku/dist/lib/repositories/library-snapshot.js
+async function readText(path2) {
+  try {
+    return await readFile2(path2, "utf8");
+  } catch (error62) {
+    if (error62.code === "ENOENT")
+      return null;
+    throw error62;
+  }
+}
+async function writeText(path2, text) {
+  const temporary = `${path2}.${process.pid}.tmp`;
+  await writeFile2(temporary, text);
+  await rename2(temporary, path2);
+}
+async function readLibrarySnapshot(paths) {
+  const index = await readOptionalDesignFile(paths.libraryIndex, libraryIndexSchema);
+  if (!index)
+    return readOptionalDesignFile(paths.legacyLibrary, librarySnapshotSchema);
+  const files2 = /* @__PURE__ */ new Map();
+  for (const component2 of index.components) {
+    const path2 = join3(paths.library, component2.file);
+    const text = await readText(path2);
+    if (text === null)
+      throw new DesignFileInvalid(path2, ["the index names it and it is missing; run zaku library save"]);
+    const file2 = parseDesignFile(path2, text, libraryFileSchema);
+    const keys = file2.variants.map((variant) => variant.key);
+    if (keys.join("\n") !== component2.variants.map((variant) => variant.key).join("\n")) {
+      throw new DesignFileInvalid(path2, ["its variants are not the index's; run zaku library save"]);
+    }
+    files2.set(component2.file, file2);
+  }
+  return joinLibrary(index, files2);
+}
+async function writeLibrarySnapshot(paths, snapshot) {
+  const { index, files: files2 } = splitLibrary(snapshot);
+  const directory = join3(paths.library, "components");
+  await mkdir(directory, { recursive: true });
+  const written = [];
+  let unchanged = 0;
+  for (const [file2, content] of files2) {
+    const path2 = join3(paths.library, file2);
+    const text = formatLibraryFile(content);
+    if (await readText(path2) === text) {
+      unchanged += 1;
+      continue;
+    }
+    await writeText(path2, text);
+    written.push(file2);
+  }
+  const removed = [];
+  for (const name of (await readdir(directory)).sort()) {
+    const file2 = `components/${name}`;
+    if (!name.endsWith(".json") || files2.has(file2))
+      continue;
+    await rm(join3(directory, name));
+    removed.push(file2);
+  }
+  await writeText(paths.libraryIndex, formatLibraryFile(index));
+  if (await readText(paths.legacyLibrary) !== null) {
+    await rm(paths.legacyLibrary);
+    removed.push(relative(paths.root, paths.legacyLibrary));
+  }
+  return { written, unchanged, removed };
+}
+
 // packages/zaku/dist/lib/adapters/figma-rest-library.js
 var DOCUMENTATION_PREFIXES = ["DS/"];
 var round3 = (value) => Math.round(value * 1e4) / 1e4;
@@ -45085,9 +45337,7 @@ async function saveLibrary(options) {
   if (fileKey2 === void 0)
     throw new FigmaFileKeyMissing("figma.library");
   const snapshot = librarySnapshotSchema.parse(await readLibrary({ rest: options.rest, fileKey: fileKey2, part: options.part }));
-  await writeFile2(paths.library, `${JSON.stringify(snapshot, null, 2)}
-`);
-  return snapshot;
+  return { snapshot, ...await writeLibrarySnapshot(paths, snapshot) };
 }
 var SaveLibraryHandler = class SaveLibraryHandler2 {
   rest;
@@ -45107,7 +45357,7 @@ SaveLibraryHandler = __decorate2([
 // packages/zaku/dist/lib/handlers/write-outline.js
 var import_tsyringe4 = __toESM(require_cjs(), 1);
 var import_yaml2 = __toESM(require_dist(), 1);
-import { mkdir, rm, writeFile as writeFile3 } from "node:fs/promises";
+import { mkdir as mkdir2, rm as rm2, writeFile as writeFile3 } from "node:fs/promises";
 import { dirname as dirname2 } from "node:path";
 
 // packages/zaku/dist/lib/domain/documentation-measures.js
@@ -45496,8 +45746,8 @@ var DOCUMENTATION_PARTS = [
 
 // packages/zaku/dist/lib/repositories/feature-maps.js
 import { createHash } from "node:crypto";
-import { readdir, readFile as readFile2 } from "node:fs/promises";
-import { basename, join as join3 } from "node:path";
+import { readdir as readdir2, readFile as readFile3 } from "node:fs/promises";
+import { basename, join as join4 } from "node:path";
 
 // packages/zaku/dist/lib/domain/feature-map.js
 var slug = external_exports.string().regex(/^[a-z][a-z0-9-]*$/, "lowercase letters, digits and dashes, starting with a letter");
@@ -45565,7 +45815,7 @@ function digestOf(text) {
 async function loadMaps(dir) {
   let names;
   try {
-    names = (await readdir(dir)).filter((name) => name.endsWith(".yaml")).sort();
+    names = (await readdir2(dir)).filter((name) => name.endsWith(".yaml")).sort();
   } catch (error62) {
     if (error62.code === "ENOENT")
       return { maps: [], errors: [] };
@@ -45574,8 +45824,8 @@ async function loadMaps(dir) {
   const maps = [];
   const errors = [];
   for (const name of names) {
-    const path2 = join3(dir, name);
-    const text = await readFile2(path2, "utf8");
+    const path2 = join4(dir, name);
+    const text = await readFile3(path2, "utf8");
     try {
       const map2 = parseDesignFile(path2, text, featureMapSchema);
       if (`${map2.feature}.yaml` !== basename(path2)) {
@@ -45684,7 +45934,7 @@ function outlineFrame(frame, where, ctx) {
   const images2 = [];
   const defaultNames = [];
   const links = [];
-  const relative = (node2) => {
+  const relative2 = (node2) => {
     const box = node2.absoluteBoundingBox;
     return box ? { x: box.x - origin.x, y: box.y - origin.y, width: box.width, height: box.height } : null;
   };
@@ -45713,7 +45963,7 @@ function outlineFrame(frame, where, ctx) {
           componentKey: ctx.components[child.componentId ?? ""]?.key ?? "",
           component: component2,
           interactive: ctx.interactive.has(component2),
-          bounds: relative(child)
+          bounds: relative2(child)
         });
       } else if (child.type === "TEXT") {
         instance.texts.push({
@@ -45754,7 +46004,7 @@ function outlineFrame(frame, where, ctx) {
       texts: [],
       interactive: ctx.interactive.has(component2),
       local: meta3?.remote === false,
-      bounds: relative(node2),
+      bounds: relative2(node2),
       sizing: {
         horizontal: node2.layoutSizingHorizontal ?? "FIXED",
         vertical: node2.layoutSizingVertical ?? "FIXED"
@@ -45821,8 +46071,8 @@ function outlineFrame(frame, where, ctx) {
 }
 
 // packages/zaku/dist/lib/repositories/outlines.js
-import { readdir as readdir2 } from "node:fs/promises";
-import { join as join4 } from "node:path";
+import { readdir as readdir3 } from "node:fs/promises";
+import { join as join5 } from "node:path";
 
 // packages/zaku/dist/lib/domain/outline.js
 var boundsSchema = external_exports.object({ x: external_exports.number(), y: external_exports.number(), width: external_exports.number(), height: external_exports.number() }).strict();
@@ -45901,24 +46151,24 @@ var unmappedSchema = external_exports.object({
 
 // packages/zaku/dist/lib/repositories/outlines.js
 function outlinePath(dir, feature, screen) {
-  return join4(dir, feature, `${screen}.yaml`);
+  return join5(dir, feature, `${screen}.yaml`);
 }
 async function loadOutlines(dir) {
   const outlines = [];
   const errors = [];
   let features;
   try {
-    features = (await readdir2(dir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+    features = (await readdir3(dir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
   } catch (error62) {
     if (error62.code === "ENOENT")
       return { outlines, unmapped: null, errors };
     throw error62;
   }
   for (const feature of features) {
-    const files2 = (await readdir2(join4(dir, feature))).filter((name) => name.endsWith(".yaml")).sort();
+    const files2 = (await readdir3(join5(dir, feature))).filter((name) => name.endsWith(".yaml")).sort();
     for (const file2 of files2) {
       try {
-        outlines.push(await readDesignFile(join4(dir, feature, file2), screenOutlineSchema));
+        outlines.push(await readDesignFile(join5(dir, feature, file2), screenOutlineSchema));
       } catch (error62) {
         if (error62 instanceof DesignFileInvalid)
           errors.push(error62);
@@ -45929,7 +46179,7 @@ async function loadOutlines(dir) {
   }
   let unmapped = null;
   try {
-    unmapped = await readOptionalDesignFile(join4(dir, "unmapped.yaml"), unmappedSchema);
+    unmapped = await readOptionalDesignFile(join5(dir, "unmapped.yaml"), unmappedSchema);
   } catch (error62) {
     if (error62 instanceof DesignFileInvalid)
       errors.push(error62);
@@ -45991,7 +46241,7 @@ async function runOutline(options) {
   if (errors[0])
     throw errors[0];
   const digests = new Map(maps.map((loaded) => [loaded.map.feature, loaded.digest]));
-  const library = await readOptionalDesignFile(paths.library, librarySnapshotSchema);
+  const library = await readLibrarySnapshot(paths);
   const existing = await loadOutlines(paths.outline);
   const file2 = await options.rest.file(fileKey2, INDEX_DEPTH);
   const listed = listFrames(file2.document);
@@ -46064,17 +46314,17 @@ async function runOutline(options) {
   if (options.frames === null) {
     for (const outline of existing.outlines) {
       if (!byScreen.has(`${outline.feature}/${outline.screen}`))
-        await rm(outlinePath(paths.outline, outline.feature, outline.screen), { force: true });
+        await rm2(outlinePath(paths.outline, outline.feature, outline.screen), { force: true });
     }
   }
   const written = [];
   for (const outline of byScreen.values()) {
     const path2 = outlinePath(paths.outline, outline.feature, outline.screen);
-    await mkdir(dirname2(path2), { recursive: true });
+    await mkdir2(dirname2(path2), { recursive: true });
     await writeFile3(path2, (0, import_yaml2.stringify)(outline));
     written.push(path2);
   }
-  await mkdir(paths.outline, { recursive: true });
+  await mkdir2(paths.outline, { recursive: true });
   await writeFile3(paths.unmapped, (0, import_yaml2.stringify)(unmapped));
   return {
     skipped: false,
@@ -46190,14 +46440,14 @@ RecipeRepository = __decorate2([
 
 // packages/zaku/dist/lib/repositories/json-schema-files.js
 var import_tsyringe10 = __toESM(require_cjs(), 1);
-import { mkdir as mkdir2 } from "node:fs/promises";
-import { join as join5 } from "node:path";
+import { mkdir as mkdir3 } from "node:fs/promises";
+import { join as join6 } from "node:path";
 var JsonSchemaFiles = class JsonSchemaFiles2 {
   async write(dir, schemas) {
-    await mkdir2(dir, { recursive: true });
+    await mkdir3(dir, { recursive: true });
     const written = [];
     for (const [name, schema] of Object.entries(schemas)) {
-      const path2 = join5(dir, name);
+      const path2 = join6(dir, name);
       await writeDesignFile(path2, schema);
       written.push(path2);
     }
@@ -46210,13 +46460,13 @@ JsonSchemaFiles = __decorate2([
 
 // packages/zaku/dist/lib/repositories/source-files.js
 var import_tsyringe11 = __toESM(require_cjs(), 1);
-import { readFile as readFile3 } from "node:fs/promises";
+import { readFile as readFile4 } from "node:fs/promises";
 var SourceFiles = class SourceFiles2 {
   readText(path2) {
-    return readFile3(path2, "utf8");
+    return readFile4(path2, "utf8");
   }
   async readJson(path2) {
-    return JSON.parse(await readFile3(path2, "utf8"));
+    return JSON.parse(await readFile4(path2, "utf8"));
   }
 };
 SourceFiles = __decorate2([
@@ -46224,11 +46474,11 @@ SourceFiles = __decorate2([
 ], SourceFiles);
 
 // packages/zaku/dist/lib/repositories/budget-ledger.js
-import { mkdir as mkdir3, readFile as readFile4, rename as rename2, writeFile as writeFile4 } from "node:fs/promises";
-import { dirname as dirname3, join as join6 } from "node:path";
+import { mkdir as mkdir4, readFile as readFile5, rename as rename3, writeFile as writeFile4 } from "node:fs/promises";
+import { dirname as dirname3, join as join7 } from "node:path";
 function ledgerPath(env, platform, home) {
-  const cache = env["XDG_CACHE_HOME"] ?? (platform === "darwin" ? join6(home, "Library", "Caches") : join6(home, ".cache"));
-  return join6(cache, "zaku", "ledger.json");
+  const cache = env["XDG_CACHE_HOME"] ?? (platform === "darwin" ? join7(home, "Library", "Caches") : join7(home, ".cache"));
+  return join7(cache, "zaku", "ledger.json");
 }
 function today(now) {
   return now.toISOString().slice(0, 10);
@@ -46238,7 +46488,7 @@ function seatAndRun(env) {
 }
 async function readLedger(path2, day) {
   try {
-    const parsed = JSON.parse(await readFile4(path2, "utf8"));
+    const parsed = JSON.parse(await readFile5(path2, "utf8"));
     const isCount = (seat) => {
       const count = seat;
       return typeof count === "object" && count !== null && typeof count.mcp === "number" && typeof count.rest === "number" && typeof count.runs === "object" && count.runs !== null && Object.values(count.runs).every((value) => typeof value === "number");
@@ -46257,11 +46507,11 @@ async function recordCalls(path2, entry) {
   if (entry.kind === "mcp")
     seat.runs[entry.run] = (seat.runs[entry.run] ?? 0) + entry.count;
   ledger.seats[entry.seat] = seat;
-  await mkdir3(dirname3(path2), { recursive: true });
+  await mkdir4(dirname3(path2), { recursive: true });
   const temporary = `${path2}.${process.pid}.tmp`;
   await writeFile4(temporary, `${JSON.stringify(ledger)}
 `);
-  await rename2(temporary, path2);
+  await rename3(temporary, path2);
   return ledger;
 }
 function mcpAllowance(ledger, seat, run, budget) {
@@ -47845,7 +48095,7 @@ var GENERIC = /* @__PURE__ */ new Set(["serif", "sans-serif", "monospace", "curs
 function families(stack) {
   return stack.split(",").map((family) => family.trim().replace(/^["']|["']$/g, "")).filter((family) => family !== "" && !GENERIC.has(family.toLowerCase()));
 }
-function colour(at, field, library, code) {
+function colour2(at, field, library, code) {
   const transparent = { r: 0, g: 0, b: 0, a: 0 };
   const drawn = library ?? transparent;
   const coded = code ?? transparent;
@@ -47874,12 +48124,12 @@ function size(at, field, library, code) {
 }
 function comparePart(at, part) {
   const { item } = at;
-  colour(at, "background", item.fill, part.background);
+  colour2(at, "background", item.fill, part.background);
   if (item.type.toUpperCase() === "TEXT")
-    colour(at, "color", item.textColor, part.color);
-  colour(at, "borderColor", item.stroke, part.borderColor);
+    colour2(at, "color", item.textColor, part.color);
+  colour2(at, "borderColor", item.stroke, part.borderColor);
   if (item.glyph)
-    colour(at, "glyph", item.glyph, part.color);
+    colour2(at, "glyph", item.glyph, part.color);
   if (item.path === "") {
     if (!at.fallback)
       size(at, "width", item.width, part.width);
@@ -48390,7 +48640,7 @@ async function loadDesign(root) {
   }
   const { outlines, unmapped, errors: outlineErrors } = await loadOutlines(paths.outline);
   findings.push(...outlineErrors.map(schemaFinding));
-  const library = await optional3(() => readOptionalDesignFile(paths.library, librarySnapshotSchema), findings);
+  const library = await optional3(() => readLibrarySnapshot(paths), findings);
   const tokens = await optional3(() => readOptionalDesignFile(paths.tokens, tokenDocumentSchema), findings);
   const recipe2 = await optional3(() => readOptionalDesignFile(paths.recipe, recipeDocumentSchema), findings);
   return {
@@ -58116,34 +58366,34 @@ var StdioServerTransport = class {
 };
 
 // apps/zaku-cli/src/mcp/server.ts
-import { mkdir as mkdir4 } from "node:fs/promises";
+import { mkdir as mkdir5 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 
 // apps/zaku-cli/src/mcp/screenshots.ts
-import { readdir as readdir3, rm as rm2, stat } from "node:fs/promises";
-import { join as join7 } from "node:path";
+import { readdir as readdir4, rm as rm3, stat } from "node:fs/promises";
+import { join as join8 } from "node:path";
 var KEPT_MS = 24 * 60 * 60 * 1e3;
 async function pruneScreenshots(dir, now) {
   let names;
   try {
-    names = await readdir3(dir);
+    names = await readdir4(dir);
   } catch {
     return;
   }
   for (const name of names.filter((entry) => entry.endsWith(".png"))) {
-    const path2 = join7(dir, name);
+    const path2 = join8(dir, name);
     const written = await stat(path2).then(
       (stats) => stats.mtimeMs,
       () => now
     );
-    if (now - written > KEPT_MS) await rm2(path2, { force: true });
+    if (now - written > KEPT_MS) await rm3(path2, { force: true });
   }
 }
 
 // apps/zaku-cli/src/mcp/tools.ts
 import { writeFile as writeFile5 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 var fileKey = external_exports.string().min(1).regex(/^[0-9a-zA-Z]{22,128}$/).describe(
   "The key of the Figma file to use. If the URL is provided, extract the file key from the URL: https://figma.com/design/:fileKey/:fileName."
 );
@@ -58187,7 +58437,7 @@ function registerFigmaTools(server, bridge, options) {
         options.timeoutMs
       );
       if (!answer.ok) return { isError: true, content: [{ type: "text", text: answer.error }] };
-      const path2 = join8(options.imageDir, `${id2.replace(":", "-")}-${Date.now()}.png`);
+      const path2 = join9(options.imageDir, `${id2.replace(":", "-")}-${Date.now()}.png`);
       await writeFile5(path2, Buffer.from(answer.png, "base64"));
       const text = JSON.stringify({
         path: path2,
@@ -58213,8 +58463,8 @@ async function serveMcp(log) {
   log(
     bridge.port === null ? "zaku mcp: no port from 7337 to 7346 was free; every call will say so" : `zaku mcp: listening for the zaku plugin on localhost:${bridge.port}`
   );
-  const imageDir = join9(tmpdir(), "zaku-screenshots");
-  await mkdir4(imageDir, { recursive: true });
+  const imageDir = join10(tmpdir(), "zaku-screenshots");
+  await mkdir5(imageDir, { recursive: true });
   await pruneScreenshots(imageDir, Date.now());
   const server = new McpServer({ name: "zaku", version: "1" });
   registerFigmaTools(server, bridge, { timeoutMs: CALL_TIMEOUT_MS, imageDir, log });
@@ -58260,7 +58510,7 @@ var checkCommand = (program2, io, finish) => {
     const loaded = await loadDesign(resolve2(io.cwd, options.root));
     const report = loaded.input ? runChecks(loaded.input, ALL_CHECKS) : { findings: [], notRun: [], passed: [] };
     report.findings.unshift(...loaded.findings);
-    const ran = options.input ? parseDesignFile(options.input, await readFile5(resolve2(io.cwd, options.input), "utf8"), rulesAnswerSchema) : null;
+    const ran = options.input ? parseDesignFile(options.input, await readFile6(resolve2(io.cwd, options.input), "utf8"), rulesAnswerSchema) : null;
     if (ran && "rulesError" in ran) {
       io.err(`zaku check: the rules did not run after the write: ${ran.rulesError}`);
       finish(1);
@@ -58274,7 +58524,7 @@ var checkCommand = (program2, io, finish) => {
   });
 };
 async function productPlaywright(cwd) {
-  const require2 = createRequire(join10(cwd, "package.json"));
+  const require2 = createRequire(join11(cwd, "package.json"));
   let resolved;
   try {
     resolved = require2.resolve("playwright");
@@ -58286,14 +58536,14 @@ async function productPlaywright(cwd) {
 }
 function fromProductTree(cwd, resolved) {
   for (let dir = resolve2(cwd); ; dir = dirname4(dir)) {
-    if (resolved.startsWith(join10(dir, "node_modules") + sep)) return true;
+    if (resolved.startsWith(join11(dir, "node_modules") + sep)) return true;
     if (dirname4(dir) === dir) return false;
   }
 }
 var runners = {
   run: execRun,
   loadPlaywright: productPlaywright,
-  rulesLibrary: () => readFile5(fileURLToPath(new URL("./rules.js", import.meta.url)), "utf8")
+  rulesLibrary: () => readFile6(fileURLToPath(new URL("./rules.js", import.meta.url)), "utf8")
 };
 var mcpCommand = (program2, io, finish) => {
   program2.command("mcp").description(
@@ -58411,7 +58661,7 @@ var libraryCommand = (program2, io, finish, cli) => {
       finish(0);
     }
   );
-  library.command("save").description("write library.json: the library components read over Figma REST, joined to the variables export").option("--root <dir>", "the design directory", "docs/design").option(
+  library.command("save").description("write library/: the library components read over Figma REST, joined to the variables export").option("--root <dir>", "the design directory", "docs/design").option(
     "--input <variables.json>",
     "what use_figma returned for zaku library script; once per page export for a library in the product file",
     (value, previous = []) => [...previous, value]
@@ -58430,20 +58680,24 @@ var libraryCommand = (program2, io, finish, cli) => {
     const part = mergeParts(
       await Promise.all(
         options.input.map(
-          async (input2) => parseDesignFile(input2, await readFile5(resolve2(io.cwd, input2), "utf8"), variablePartSchema)
+          async (input2) => parseDesignFile(input2, await readFile6(resolve2(io.cwd, input2), "utf8"), variablePartSchema)
         )
       )
     );
     try {
-      const snapshot = await cli.bus.send(new SaveLibrary({ root, part }));
+      const { snapshot, written, unchanged, removed } = await cli.bus.send(
+        new SaveLibrary({ root, part })
+      );
       if (snapshot.components.length === 0) {
         io.err(
-          "library.json holds no components: the file publishes none and the export listed none; for a library in the product file, run zaku library script --local"
+          "library/ holds no components: the file publishes none and the export listed none; for a library in the product file, run zaku library script --local"
         );
         finish(1);
         return;
       }
-      io.out(`wrote library.json: ${snapshot.components.length} components at version ${snapshot.version}`);
+      io.out(
+        `wrote library/: ${snapshot.components.length} components at version ${snapshot.version}; ${written.length} component files written, ${unchanged} unchanged, ${removed.length} removed`
+      );
       finish(0);
     } finally {
       await recordRestCalls(cli, io);
@@ -58468,11 +58722,11 @@ return ${check2};`);
       finish(0);
       return;
     }
-    const write = await readFile5(resolve2(io.cwd, options.after), "utf8");
+    const write2 = await readFile6(resolve2(io.cwd, options.after), "utf8");
     const body = [
       library,
       `const zakuWrite = async () => {
-${write}
+${write2}
 };`,
       "const zakuValue = await zakuWrite();",
       "const value = zakuValue === undefined ? null : zakuValue;",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeroxsolutions/zaku",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "private": false,
   "description": "zaku's checker: checks a product's design data against its code and prints the rules script every Figma write runs.",
   "license": "MIT",