@zeroxsolutions/zaku 0.1.0 → 0.2.0

package/dist/zaku.mjs

@@ -1187,11 +1187,11 @@ function __metadata(metadataKey, metadataValue) {
 }
 function __awaiter(thisArg, _arguments, P, generator) {
   function adopt(value) {
-    return value instanceof P ? value : new P(function(resolve3) {
-      resolve3(value);
+    return value instanceof P ? value : new P(function(resolve4) {
+      resolve4(value);
     });
   }
-  return new (P || (P = Promise))(function(resolve3, reject) {
+  return new (P || (P = Promise))(function(resolve4, reject) {
     function fulfilled(value) {
       try {
         step(generator.next(value));
@@ -1207,7 +1207,7 @@ function __awaiter(thisArg, _arguments, P, generator) {
       }
     }
     function step(result) {
-      result.done ? resolve3(result.value) : adopt(result.value).then(fulfilled, rejected);
+      result.done ? resolve4(result.value) : adopt(result.value).then(fulfilled, rejected);
     }
     step((generator = generator.apply(thisArg, _arguments || [])).next());
   });
@@ -1385,14 +1385,14 @@ function __asyncValues(o) {
   }, i);
   function verb(n) {
     i[n] = o[n] && function(v) {
-      return new Promise(function(resolve3, reject) {
-        v = o[n](v), settle2(resolve3, reject, v.done, v.value);
+      return new Promise(function(resolve4, reject) {
+        v = o[n](v), settle2(resolve4, reject, v.done, v.value);
       });
     };
   }
-  function settle2(resolve3, reject, d, v) {
+  function settle2(resolve4, reject, d, v) {
     Promise.resolve(v).then(function(v2) {
-      resolve3({ value: v2, done: d });
+      resolve4({ value: v2, done: d });
     }, reject);
   }
 }
@@ -2217,7 +2217,7 @@ var require_injectable = __commonJS({
     var reflection_helpers_1 = require_reflection_helpers();
     var dependency_container_1 = require_dependency_container();
     var dependency_container_2 = require_dependency_container();
-    function injectable12(options) {
+    function injectable11(options) {
       return function(target) {
         dependency_container_1.typeInfo.set(target, reflection_helpers_1.getParamInfo(target));
         if (options && options.token) {
@@ -2231,7 +2231,7 @@ var require_injectable = __commonJS({
         }
       };
     }
-    exports.default = injectable12;
+    exports.default = injectable11;
   }
 });
 
@@ -16461,7 +16461,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve3.call(this, root, ref);
+      let _sch = resolve4.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -16488,7 +16488,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve3(root, ref) {
+    function resolve4(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -17318,7 +17318,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve3(baseURI, relativeURI, options) {
+    function resolve4(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const {
         parsed: baseParsed,
@@ -17351,49 +17351,49 @@ var require_fast_uri = __commonJS({
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative3, options, skipNormalization) {
+    function resolveComponent(base, relative4, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse4(serialize(base, options), options);
-        relative3 = parse4(serialize(relative3, options), options);
+        relative4 = parse4(serialize(relative4, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative3.scheme) {
-        target.scheme = relative3.scheme;
-        target.userinfo = relative3.userinfo;
-        target.host = relative3.host;
-        target.port = relative3.port;
-        target.path = removeDotSegments(relative3.path || "");
-        target.query = relative3.query;
+      if (!options.tolerant && relative4.scheme) {
+        target.scheme = relative4.scheme;
+        target.userinfo = relative4.userinfo;
+        target.host = relative4.host;
+        target.port = relative4.port;
+        target.path = removeDotSegments(relative4.path || "");
+        target.query = relative4.query;
       } else {
-        if (relative3.userinfo !== void 0 || relative3.host !== void 0 || relative3.port !== void 0) {
-          target.userinfo = relative3.userinfo;
-          target.host = relative3.host;
-          target.port = relative3.port;
-          target.path = removeDotSegments(relative3.path || "");
-          target.query = relative3.query;
+        if (relative4.userinfo !== void 0 || relative4.host !== void 0 || relative4.port !== void 0) {
+          target.userinfo = relative4.userinfo;
+          target.host = relative4.host;
+          target.port = relative4.port;
+          target.path = removeDotSegments(relative4.path || "");
+          target.query = relative4.query;
         } else {
-          if (!relative3.path) {
+          if (!relative4.path) {
             target.path = base.path;
-            if (relative3.query !== void 0) {
-              target.query = relative3.query;
+            if (relative4.query !== void 0) {
+              target.query = relative4.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative3.path[0] === "/") {
-              target.path = removeDotSegments(relative3.path);
+            if (relative4.path[0] === "/") {
+              target.path = removeDotSegments(relative4.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative3.path;
+                target.path = "/" + relative4.path;
               } else if (!base.path) {
-                target.path = relative3.path;
+                target.path = relative4.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative3.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative4.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative3.query;
+            target.query = relative4.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -17401,7 +17401,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative3.fragment;
+      target.fragment = relative4.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -17687,7 +17687,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve: resolve3,
+      resolve: resolve4,
       resolveComponent,
       equal,
       serialize,
@@ -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 readFile6 } from "node:fs/promises";
+import { readFile as readFile7 } from "node:fs/promises";
 import { createRequire } from "node:module";
 import { homedir as homedir2 } from "node:os";
-import { dirname as dirname4, join as join12, resolve as resolve2, sep } from "node:path";
+import { dirname as dirname5, join as join13, relative as relative3, resolve as resolve3, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // node_modules/.pnpm/commander@15.0.0/node_modules/commander/lib/error.js
@@ -24111,7 +24111,7 @@ function bootstrap(scope, tokens) {
 }
 
 // apps/zaku-cli/src/dependencies.ts
-var import_tsyringe12 = __toESM(require_cjs(), 1);
+var import_tsyringe11 = __toESM(require_cjs(), 1);
 import { homedir } from "node:os";
 
 // packages/zaku/dist/index.js
@@ -24154,11 +24154,13 @@ async function decodePreset(code, run) {
 // packages/zaku/dist/lib/commands/write-tokens.js
 var WriteTokens = class extends DomainCommand {
   root;
+  config;
   cwd;
   css;
   constructor(input2) {
     super();
     this.root = input2.root;
+    this.config = input2.config;
     this.cwd = input2.cwd;
     this.css = input2.css;
   }
@@ -24167,10 +24169,12 @@ var WriteTokens = class extends DomainCommand {
 // packages/zaku/dist/lib/commands/write-recipe.js
 var WriteRecipe = class extends DomainCommand {
   root;
+  config;
   url;
   constructor(input2) {
     super();
     this.root = input2.root;
+    this.config = input2.config;
     this.url = input2.url;
   }
 };
@@ -24178,11 +24182,13 @@ var WriteRecipe = class extends DomainCommand {
 // packages/zaku/dist/lib/commands/save-library.js
 var SaveLibrary = class extends DomainCommand {
   root;
+  config;
   key;
   part;
   constructor(input2) {
     super();
     this.root = input2.root;
+    this.config = input2.config;
     if (input2.key !== void 0)
       this.key = input2.key;
     if (input2.part !== void 0)
@@ -24193,10 +24199,12 @@ var SaveLibrary = class extends DomainCommand {
 // packages/zaku/dist/lib/commands/write-outline.js
 var WriteOutline = class extends DomainCommand {
   root;
+  config;
   frames;
   constructor(input2) {
     super();
     this.root = input2.root;
+    this.config = input2.config;
     this.frames = input2.frames;
   }
 };
@@ -24236,7 +24244,6 @@ var TOKENS = {
   RUN_COMMAND: "zaku.runCommand",
   RECIPE_PAGE_READER: "zaku.recipePageReader",
   BUDGET_LEDGER: "zaku.budgetLedger",
-  DESIGN_CONFIG_REPOSITORY: "zaku.designConfigRepository",
   TOKEN_DOCUMENT_REPOSITORY: "zaku.tokenDocumentRepository",
   RECIPE_REPOSITORY: "zaku.recipeRepository",
   JSON_SCHEMA_FILES: "zaku.jsonSchemaFiles",
@@ -29385,7 +29392,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve3) {
+function isRecursive(inst, stack, resolve4) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -29395,7 +29402,7 @@ function isRecursive(inst, stack, resolve3) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve3);
+      const answer = isRecursive(child, stack, resolve4);
       if (answer > result)
         result = answer;
     }
@@ -29406,7 +29413,7 @@ function isRecursive(inst, stack, resolve3) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve3) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve4) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -29470,7 +29477,7 @@ function isRecursive(inst, stack, resolve3) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve3 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve4 ? inst._zod.innerType : void 0);
       merge3(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -44362,7 +44369,7 @@ function dtcgTokenDocument(system, schemes, name) {
 // packages/zaku/dist/lib/domain/errors/css-required.js
 var CssRequired = class extends Error {
   constructor() {
-    super("zaku tokens needs --css, the stylesheet that declares :root and .dark");
+    super("zaku tokens needs designSystem.shadcn.css, the stylesheet that declares :root and .dark, or --css when it runs on one product");
     this.name = "CssRequired";
   }
 };
@@ -44417,6 +44424,34 @@ var PlaywrightMissing = class extends Error {
   }
 };
 
+// packages/zaku/dist/lib/domain/errors/product-config-missing.js
+var ProductConfigMissing = class extends Error {
+  path;
+  product;
+  constructor(path2, product) {
+    super(`no ${path2}, the zaku.yaml of the product ${product} the workspace config lists`);
+    this.path = path2;
+    this.product = product;
+    this.name = "ProductConfigMissing";
+  }
+};
+
+// packages/zaku/dist/lib/domain/errors/product-required.js
+var ProductRequired = class extends Error {
+  constructor(command, listed) {
+    super(`${command} acts on one product; name one with --product: ${listed.join(", ")}`);
+    this.name = "ProductRequired";
+  }
+};
+
+// packages/zaku/dist/lib/domain/errors/product-unknown.js
+var ProductUnknown = class extends Error {
+  constructor(name, listed) {
+    super(`no product ${name}; the config lists ${listed.join(", ")}`);
+    this.name = "ProductUnknown";
+  }
+};
+
 // packages/zaku/dist/lib/domain/errors/recipe-page-failed.js
 var RecipePageFailed = class extends Error {
   constructor(cause) {
@@ -44433,6 +44468,18 @@ var RecipeUrlRequired = class extends Error {
   }
 };
 
+// packages/zaku/dist/lib/domain/errors/workspace-config-missing.js
+var WorkspaceConfigMissing = class extends Error {
+  path;
+  legacy;
+  constructor(path2, legacy) {
+    super(legacy === null ? `no ${path2}` : `no ${path2}, and no ${legacy} to fall back on; run zaku where zaku.config.yaml is, or name it with --config`);
+    this.path = path2;
+    this.legacy = legacy;
+    this.name = "WorkspaceConfigMissing";
+  }
+};
+
 // packages/zaku/dist/lib/domain/theme-css.js
 function declarations(css, selector) {
   const escaped = selector.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -44452,19 +44499,17 @@ function parseThemeCss(css) {
 
 // packages/zaku/dist/lib/handlers/write-tokens.js
 var WriteTokensHandler = class WriteTokensHandler2 {
-  configs;
   documents;
   files;
   run;
   command = WriteTokens;
-  constructor(configs, documents, files2, run) {
-    this.configs = configs;
+  constructor(documents, files2, run) {
     this.documents = documents;
     this.files = files2;
     this.run = run;
   }
   async handle(command) {
-    const config2 = await this.configs.read(command.root);
+    const { config: config2 } = command;
     const system = config2.designSystem;
     let doc;
     let from;
@@ -44489,10 +44534,9 @@ var WriteTokensHandler = class WriteTokensHandler2 {
 };
 WriteTokensHandler = __decorate2([
   (0, import_tsyringe.injectable)({ token: TOKENS.COMMAND_HANDLER }),
-  __param2(0, (0, import_tsyringe.inject)(TOKENS.DESIGN_CONFIG_REPOSITORY)),
-  __param2(1, (0, import_tsyringe.inject)(TOKENS.TOKEN_DOCUMENT_REPOSITORY)),
-  __param2(2, (0, import_tsyringe.inject)(TOKENS.SOURCE_FILES)),
-  __param2(3, (0, import_tsyringe.inject)(TOKENS.RUN_COMMAND))
+  __param2(0, (0, import_tsyringe.inject)(TOKENS.TOKEN_DOCUMENT_REPOSITORY)),
+  __param2(1, (0, import_tsyringe.inject)(TOKENS.SOURCE_FILES)),
+  __param2(2, (0, import_tsyringe.inject)(TOKENS.RUN_COMMAND))
 ], WriteTokensHandler);
 
 // packages/zaku/dist/lib/handlers/write-recipe.js
@@ -44587,17 +44631,15 @@ ${JSON.stringify(Object.entries(props).sort(([a], [b]) => a.localeCompare(b)))}`
 
 // packages/zaku/dist/lib/handlers/write-recipe.js
 var WriteRecipeHandler = class WriteRecipeHandler2 {
-  configs;
   recipes;
   readPage;
   command = WriteRecipe;
-  constructor(configs, recipes, readPage) {
-    this.configs = configs;
+  constructor(recipes, readPage) {
     this.recipes = recipes;
     this.readPage = readPage;
   }
   async handle(command) {
-    const config2 = await this.configs.read(command.root);
+    const { config: config2 } = command;
     const url2 = command.url ?? config2.recipe?.url;
     if (!url2)
       throw new RecipeUrlRequired();
@@ -44620,17 +44662,41 @@ var WriteRecipeHandler = class WriteRecipeHandler2 {
 };
 WriteRecipeHandler = __decorate2([
   (0, import_tsyringe2.injectable)({ token: TOKENS.COMMAND_HANDLER }),
-  __param2(0, (0, import_tsyringe2.inject)(TOKENS.DESIGN_CONFIG_REPOSITORY)),
-  __param2(1, (0, import_tsyringe2.inject)(TOKENS.RECIPE_REPOSITORY)),
-  __param2(2, (0, import_tsyringe2.inject)(TOKENS.RECIPE_PAGE_READER))
+  __param2(0, (0, import_tsyringe2.inject)(TOKENS.RECIPE_REPOSITORY)),
+  __param2(1, (0, import_tsyringe2.inject)(TOKENS.RECIPE_PAGE_READER))
 ], WriteRecipeHandler);
 
 // packages/zaku/dist/lib/handlers/save-library.js
 var import_tsyringe3 = __toESM(require_cjs(), 1);
 import { relative as relative2 } from "node:path";
 
-// packages/zaku/dist/lib/domain/copy-defaults.js
-var DEFAULT_COPY = { locales: ["en"], currencies: [] };
+// packages/zaku/dist/lib/repositories/design-paths.js
+import { join as join2 } from "node:path";
+function librarySnapshotDir(paths, key) {
+  if (key === null)
+    return paths;
+  const library = join2(paths.library, key);
+  return { root: paths.root, library, libraryIndex: join2(library, "index.json"), legacyLibrary: null };
+}
+function designPaths(root) {
+  return {
+    root,
+    config: join2(root, "zaku.yaml"),
+    maps: join2(root, "map"),
+    outline: join2(root, "outline"),
+    unmapped: join2(root, "outline", "unmapped.yaml"),
+    files: join2(root, "outline", "files.yaml"),
+    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/design-graph.js
 var DESKTOP_FAMILIES = /* @__PURE__ */ new Set(["macos", "windows", "gnome", "kde"]);
@@ -44716,334 +44782,6 @@ function snapshotsFor(input2, target) {
   return { libraries, kits, missing };
 }
 
-// packages/zaku/dist/lib/schema/zaku-config.js
-var PLATFORM_FAMILIES = ["web", "ios", "android", "macos", "windows", "gnome", "kde"];
-var LAYERS = ["foundations", "components"];
-var BRANCHES = ["ui", "native"];
-var DEFAULT_INTERACTIVE = [
-  "Button",
-  "Button Group",
-  "Checkbox",
-  "Combobox",
-  "Dropdown Menu",
-  "Input",
-  "Input Group",
-  "Input OTP",
-  "Native Select",
-  "Pagination",
-  "Radio Group",
-  "Select",
-  "Slider",
-  "Switch",
-  "Tabs",
-  "Textarea",
-  "Toggle",
-  "Toggle Group"
-];
-var id = external_exports.string().regex(/^[a-z][a-z0-9-]*$/, "lowercase letters, digits and dashes, starting with a letter");
-var targetSchema = external_exports.object({
-  id,
-  family: external_exports.enum(PLATFORM_FAMILIES),
-  name: external_exports.string().regex(/^\S(.*\S)?$/, "a name has no leading or trailing space").refine((name) => !name.includes("/"), "a name has no slash, which separates the parts of a frame name"),
-  /** The frame size every frame of this target is drawn at; the frame check compares it. */
-  size: external_exports.object({ width: external_exports.number().positive(), height: external_exports.number().positive() }).strict().optional(),
-  /** The renderer whose libraries its frames draw from; `defaultBranch` in the design graph gives it when left out. */
-  branch: external_exports.enum(BRANCHES).optional()
-}).strict();
-var DEFAULT_SYSTEM_BARS = {
-  web: [],
-  ios: [["Status Bar"], ["Home Indicator"]],
-  android: [["Status Bar"], ["Navigation Bar", "Gesture Handle"]],
-  macos: [["Window Controls"]],
-  windows: [["Title Bar"]],
-  gnome: [["Header Bar"]],
-  kde: [["Title Bar"]]
-};
-function systemBarNames(config2) {
-  const bars = { ...DEFAULT_SYSTEM_BARS, ...config2.systemBars };
-  return new Set(Object.values(bars).flat(2));
-}
-var budgetSchema = external_exports.object({
-  mcpPerDay: external_exports.number().int().positive().default(200),
-  mcpPerRun: external_exports.number().int().positive().default(30),
-  reserve: external_exports.number().min(0).max(1).default(0.2)
-}).strict();
-var fileKey = external_exports.string().min(1);
-var kitSchema = external_exports.object({ key: fileKey, family: external_exports.enum(PLATFORM_FAMILIES) }).strict();
-var librarySchema = external_exports.object({
-  key: fileKey,
-  layer: external_exports.enum(LAYERS),
-  branches: external_exports.array(external_exports.enum(BRANCHES)).min(1),
-  /** The libraries and kits this one is built on, by key. */
-  extends: external_exports.array(fileKey).default([])
-}).strict();
-var productSchema = external_exports.object({ key: fileKey, family: external_exports.enum(PLATFORM_FAMILIES) }).strict();
-var prototypeSchema = external_exports.object({ key: fileKey, family: external_exports.enum(PLATFORM_FAMILIES) }).strict();
-var files = external_exports.object({
-  library: fileKey.optional(),
-  product: fileKey.optional(),
-  kits: external_exports.array(kitSchema).optional(),
-  libraries: external_exports.array(librarySchema).optional(),
-  products: external_exports.array(productSchema).optional(),
-  prototypes: external_exports.array(prototypeSchema).optional()
-}).strict();
-function byRole(figma) {
-  return [figma.kits, figma.libraries, figma.products, figma.prototypes].some((list) => list !== void 0);
-}
-var shadcnSystem = external_exports.object({ preset: external_exports.string().min(1) }).strict();
-var tokenFiles = external_exports.array(external_exports.string().min(1)).min(1);
-var resolverInputs = external_exports.record(external_exports.string(), external_exports.string());
-var dtcgSystem = external_exports.object({
-  resolver: external_exports.string().min(1).optional(),
-  light: external_exports.union([tokenFiles, resolverInputs]),
-  dark: external_exports.union([tokenFiles, resolverInputs]),
-  /** The group whose tokens are the colour roles, and the one whose tokens are the radius steps. */
-  colors: external_exports.string().min(1).default("color"),
-  radii: external_exports.string().min(1).default("radius"),
-  /** Foreground and background token pairs a text is read in, each needing 4.5:1. */
-  contrast: external_exports.array(external_exports.tuple([external_exports.string().min(1), external_exports.string().min(1)])).default([])
-}).strict().superRefine((dtcg, ctx) => {
-  for (const scheme of ["light", "dark"]) {
-    const files2 = Array.isArray(dtcg[scheme]);
-    if (dtcg.resolver !== void 0 && files2) {
-      ctx.addIssue({
-        code: "custom",
-        path: [scheme],
-        message: "with a resolver, name the modifier contexts, not files"
-      });
-    }
-    if (dtcg.resolver === void 0 && !files2) {
-      ctx.addIssue({
-        code: "custom",
-        path: [scheme],
-        message: "without a resolver, list the token files"
-      });
-    }
-  }
-});
-var designSystemSchema = external_exports.union([
-  external_exports.object({ shadcn: shadcnSystem }).strict(),
-  external_exports.object({ dtcg: dtcgSystem }).strict()
-]);
-var recipeSchema = external_exports.object({
-  url: external_exports.url().optional(),
-  dark: external_exports.enum(["class", "media"]).default("class"),
-  darkClass: external_exports.string().min(1).default("dark")
-}).strict();
-function writtenInAScript(tag) {
-  try {
-    return new Intl.Locale(tag).maximize().script !== void 0;
-  } catch {
-    return false;
-  }
-}
-var copySchema = external_exports.object({
-  locales: external_exports.array(external_exports.string().refine(writtenInAScript, "a BCP 47 language tag, such as en or vi")).min(1).default(["en"]),
-  currencies: external_exports.array(external_exports.string().refine((code) => Intl.supportedValuesOf("currency").includes(code), "an ISO 4217 code, such as VND or USD")).default([])
-}).strict();
-var configShape = external_exports.object({
-  product: external_exports.string().min(1),
-  designSystem: designSystemSchema,
-  figma: files.default({}),
-  targets: external_exports.array(targetSchema).min(1),
-  modes: external_exports.record(external_exports.string(), external_exports.string()).default({}),
-  interactive: external_exports.array(external_exports.string().min(1)).default([...DEFAULT_INTERACTIVE]),
-  /** The bars of the families whose kit names them its own way; every family left out keeps its default. */
-  systemBars: external_exports.partialRecord(external_exports.enum(PLATFORM_FAMILIES), external_exports.array(external_exports.array(external_exports.string().min(1)).min(1))).optional(),
-  budget: budgetSchema.default({ mcpPerDay: 200, mcpPerRun: 30, reserve: 0.2 }),
-  recipe: recipeSchema.optional(),
-  copy: copySchema.default(DEFAULT_COPY)
-}).strict();
-var zakuConfigSchema = configShape.superRefine((config2, ctx) => {
-  for (const key of ["id", "name"]) {
-    const seen = /* @__PURE__ */ new Set();
-    config2.targets.forEach((target, index) => {
-      if (seen.has(target[key])) {
-        ctx.addIssue({
-          code: "custom",
-          path: ["targets", index, key],
-          message: `a second target with ${key} ${target[key]}`
-        });
-      }
-      seen.add(target[key]);
-    });
-  }
-  if (byRole(config2.figma))
-    refineFilesByRole(config2, ctx);
-});
-function refineFilesByRole(config2, ctx) {
-  const { figma } = config2;
-  if (figma.library !== void 0 || figma.product !== void 0) {
-    ctx.addIssue({
-      code: "custom",
-      path: ["figma"],
-      message: "figma.library and figma.product describe one library and one product; list files by role instead"
-    });
-  }
-  const kits = figma.kits ?? [];
-  const libraries = figma.libraries ?? [];
-  const products = figma.products ?? [];
-  const seen = /* @__PURE__ */ new Set();
-  const lists = [
-    ["kits", kits],
-    ["libraries", libraries],
-    ["products", products],
-    ["prototypes", figma.prototypes ?? []]
-  ];
-  for (const [list, entries] of lists) {
-    entries.forEach((entry, index) => {
-      if (seen.has(entry.key))
-        ctx.addIssue({
-          code: "custom",
-          path: ["figma", list, index, "key"],
-          message: `a second file with key ${entry.key}`
-        });
-      seen.add(entry.key);
-    });
-  }
-  const byKey = new Map(libraries.map((library) => [library.key, library]));
-  const kitKeys = new Set(kits.map((kit) => kit.key));
-  libraries.forEach((library, index) => {
-    const path2 = ["figma", "libraries", index, "extends"];
-    for (const key of library.extends) {
-      const base = byKey.get(key);
-      if (!base && !kitKeys.has(key)) {
-        ctx.addIssue({
-          code: "custom",
-          path: path2,
-          message: `${library.key} extends ${key}, which is no library or kit listed`
-        });
-      } else if (base?.layer === "components" && library.layer === "foundations") {
-        ctx.addIssue({ code: "custom", path: path2, message: `foundations ${library.key} extends components ${key}` });
-      } else if (base && !base.branches.some((branch) => library.branches.includes(branch))) {
-        ctx.addIssue({
-          code: "custom",
-          path: path2,
-          message: `${library.key} extends ${key}, which holds none of its branches`
-        });
-      }
-    }
-  });
-  const cycle = findCycle(libraries);
-  if (cycle)
-    ctx.addIssue({ code: "custom", path: ["figma", "libraries"], message: `extends comes back: ${cycle}` });
-  for (const [list, entries] of [
-    ["products", products],
-    ["prototypes", figma.prototypes ?? []]
-  ]) {
-    const families2 = /* @__PURE__ */ new Set();
-    entries.forEach((entry, index) => {
-      if (families2.has(entry.family))
-        ctx.addIssue({
-          code: "custom",
-          path: ["figma", list, index, "family"],
-          message: `a second ${list === "products" ? "product" : "prototype"} file for ${entry.family}`
-        });
-      families2.add(entry.family);
-    });
-  }
-  (figma.prototypes ?? []).forEach((prototype2, index) => {
-    if (!products.some((product) => product.family === prototype2.family))
-      ctx.addIssue({
-        code: "custom",
-        path: ["figma", "prototypes", index, "family"],
-        message: `no product file for ${prototype2.family} to copy its frames from`
-      });
-  });
-  config2.targets.forEach((target, index) => {
-    const branch = target.branch ?? defaultBranch(target.family);
-    const path2 = ["targets", index, "branch"];
-    if (branch === void 0) {
-      ctx.addIssue({ code: "custom", path: path2, message: `a ${target.family} target names its branch, ui or native` });
-    } else if (libraries.length > 0 && !libraries.some((library) => library.branches.includes(branch))) {
-      ctx.addIssue({ code: "custom", path: path2, message: `no library holds the ${branch} branch` });
-    }
-  });
-}
-function findCycle(libraries) {
-  const byKey = new Map(libraries.map((library) => [library.key, library]));
-  const visit2 = (key, path2) => {
-    if (path2.includes(key))
-      return [...path2.slice(path2.indexOf(key)), key].join(" -> ");
-    for (const next of byKey.get(key)?.extends ?? []) {
-      const found = visit2(next, [...path2, key]);
-      if (found)
-        return found;
-    }
-    return void 0;
-  };
-  for (const library of libraries) {
-    const found = visit2(library.key, []);
-    if (found)
-      return found;
-  }
-  return void 0;
-}
-
-// packages/zaku/dist/lib/repositories/design-file.js
-var import_yaml = __toESM(require_dist(), 1);
-import { readFile, rename, writeFile } from "node:fs/promises";
-function parseDesignFile(path2, text, schema) {
-  let data;
-  try {
-    data = path2.endsWith(".json") ? JSON.parse(text) : (0, import_yaml.parse)(text);
-  } catch (error62) {
-    throw new DesignFileInvalid(path2, [error62.message]);
-  }
-  const result = schema.safeParse(data);
-  if (!result.success) {
-    throw new DesignFileInvalid(path2, result.error.issues.map((issue2) => `${issue2.path.map(String).join(".") || "(root)"}: ${issue2.message}`));
-  }
-  return result.data;
-}
-async function readDesignFile(path2, schema) {
-  return parseDesignFile(path2, await readFile(path2, "utf8"), schema);
-}
-async function readOptionalDesignFile(path2, schema) {
-  let text;
-  try {
-    text = await readFile(path2, "utf8");
-  } catch (error62) {
-    if (error62.code === "ENOENT")
-      return null;
-    throw error62;
-  }
-  return parseDesignFile(path2, text, schema);
-}
-async function writeDesignFile(path2, value) {
-  const temporary = `${path2}.${process.pid}.tmp`;
-  await writeFile(temporary, `${JSON.stringify(value, null, 2)}
-`);
-  await rename(temporary, path2);
-}
-
-// packages/zaku/dist/lib/repositories/design-paths.js
-import { join as join2 } from "node:path";
-function librarySnapshotDir(paths, key) {
-  if (key === null)
-    return paths;
-  const library = join2(paths.library, key);
-  return { root: paths.root, library, libraryIndex: join2(library, "index.json"), legacyLibrary: null };
-}
-function designPaths(root) {
-  return {
-    root,
-    config: join2(root, "zaku.yaml"),
-    maps: join2(root, "map"),
-    outline: join2(root, "outline"),
-    unmapped: join2(root, "outline", "unmapped.yaml"),
-    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({
@@ -45332,6 +45070,43 @@ function formatLibraryFile(value) {
 `;
 }
 
+// packages/zaku/dist/lib/repositories/design-file.js
+var import_yaml = __toESM(require_dist(), 1);
+import { readFile, rename, writeFile } from "node:fs/promises";
+function parseDesignFile(path2, text, schema) {
+  let data;
+  try {
+    data = path2.endsWith(".json") ? JSON.parse(text) : (0, import_yaml.parse)(text);
+  } catch (error62) {
+    throw new DesignFileInvalid(path2, [error62.message]);
+  }
+  const result = schema.safeParse(data);
+  if (!result.success) {
+    throw new DesignFileInvalid(path2, result.error.issues.map((issue2) => `${issue2.path.map(String).join(".") || "(root)"}: ${issue2.message}`));
+  }
+  return result.data;
+}
+async function readDesignFile(path2, schema) {
+  return parseDesignFile(path2, await readFile(path2, "utf8"), schema);
+}
+async function readOptionalDesignFile(path2, schema) {
+  let text;
+  try {
+    text = await readFile(path2, "utf8");
+  } catch (error62) {
+    if (error62.code === "ENOENT")
+      return null;
+    throw error62;
+  }
+  return parseDesignFile(path2, text, schema);
+}
+async function writeDesignFile(path2, value) {
+  const temporary = `${path2}.${process.pid}.tmp`;
+  await writeFile(temporary, `${JSON.stringify(value, null, 2)}
+`);
+  await rename(temporary, path2);
+}
+
 // packages/zaku/dist/lib/repositories/library-snapshot.js
 async function readText(path2) {
   try {
@@ -45724,8 +45499,7 @@ function librarySaveTarget(config2, key) {
 }
 async function saveLibrary(options) {
   const paths = designPaths(options.root);
-  const config2 = await readDesignFile(paths.config, zakuConfigSchema);
-  const target = librarySaveTarget(config2, options.key);
+  const target = librarySaveTarget(options.config, options.key);
   if (target.kind === "kit") {
     const at2 = librarySnapshotDir(paths, target.kit.key);
     const kit = await readKit({ rest: options.rest, key: target.kit.key, family: target.kit.family });
@@ -45753,6 +45527,7 @@ var SaveLibraryHandler = class SaveLibraryHandler2 {
   handle(command) {
     return saveLibrary({
       root: command.root,
+      config: command.config,
       rest: this.rest,
       ...command.key !== void 0 ? { key: command.key } : {},
       ...command.part !== void 0 ? { part: command.part } : {}
@@ -45771,6 +45546,85 @@ var import_yaml2 = __toESM(require_dist(), 1);
 import { mkdir as mkdir2, rm as rm2, writeFile as writeFile3 } from "node:fs/promises";
 import { dirname as dirname2, join as join6 } from "node:path";
 
+// packages/zaku/dist/lib/adapters/figma-rest.js
+var FigmaRateLimited = class extends Error {
+  url;
+  constructor(url2) {
+    super(`Figma answered 429 twice for ${url2}; wait and run again`);
+    this.url = url2;
+    this.name = "FigmaRateLimited";
+  }
+};
+var FigmaRequestFailed = class extends Error {
+  url;
+  status;
+  constructor(url2, status, body) {
+    super(`Figma answered ${status} for ${url2}: ${body.slice(0, 200)}`);
+    this.url = url2;
+    this.status = status;
+    this.name = "FigmaRequestFailed";
+  }
+};
+var BASE = "https://api.figma.com/v1";
+var BATCH = 50;
+var MAX_WAIT_MS = 12e4;
+function createFigmaRest(options) {
+  const send = options.fetch ?? globalThis.fetch;
+  const sleep = options.sleep ?? ((ms) => new Promise((done) => setTimeout(done, ms)));
+  const onCall = options.onCall ?? (() => void 0);
+  async function call(url2) {
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+      const res = await send(url2, { headers: { "X-Figma-Token": options.token } });
+      onCall();
+      if (res.status === 429) {
+        if (attempt === 1)
+          break;
+        const seconds = Number(res.headers.get("Retry-After") ?? "60");
+        await sleep(Math.min(Number.isFinite(seconds) ? seconds * 1e3 : 6e4, MAX_WAIT_MS));
+        continue;
+      }
+      if (!res.ok)
+        throw new FigmaRequestFailed(url2, res.status, await res.text());
+      return await res.json();
+    }
+    throw new FigmaRateLimited(url2);
+  }
+  const chunks = (ids) => Array.from({ length: Math.ceil(ids.length / BATCH) }, (_, index) => ids.slice(index * BATCH, (index + 1) * BATCH));
+  async function components(fileKey3) {
+    const listed = await call(`${BASE}/files/${fileKey3}/components`);
+    return listed.meta.components;
+  }
+  return {
+    file: (fileKey3, depth) => call(`${BASE}/files/${fileKey3}?depth=${depth}`),
+    async fileName(fileKey3) {
+      const meta3 = await call(`${BASE}/files/${fileKey3}/meta`);
+      return meta3.file.name;
+    },
+    async nodes(fileKey3, ids) {
+      const merged = { version: "", nodes: {} };
+      for (const chunk of chunks(ids)) {
+        const part = await call(`${BASE}/files/${fileKey3}/nodes?ids=${encodeURIComponent(chunk.join(","))}`);
+        merged.version = part.version;
+        Object.assign(merged.nodes, part.nodes);
+      }
+      return merged;
+    },
+    async published(fileKey3) {
+      const sets = await call(`${BASE}/files/${fileKey3}/component_sets`);
+      return { sets: sets.meta.component_sets, components: await components(fileKey3) };
+    },
+    components,
+    async images(fileKey3, ids) {
+      const merged = {};
+      for (const chunk of chunks(ids)) {
+        const part = await call(`${BASE}/images/${fileKey3}?ids=${encodeURIComponent(chunk.join(","))}&format=png&scale=1`);
+        Object.assign(merged, part.images);
+      }
+      return merged;
+    }
+  };
+}
+
 // packages/zaku/dist/lib/domain/documentation-measures.js
 var COVER = {
   page: "Thumbnail",
@@ -46348,7 +46202,7 @@ function outlineFrame(frame, where, ctx) {
   const images2 = [];
   const defaultNames = [];
   const links = [];
-  const relative3 = (node2) => {
+  const relative4 = (node2) => {
     const box = node2.absoluteBoundingBox;
     return box ? { x: box.x - origin.x, y: box.y - origin.y, width: box.width, height: box.height } : null;
   };
@@ -46377,7 +46231,7 @@ function outlineFrame(frame, where, ctx) {
           componentKey: ctx.components[child.componentId ?? ""]?.key ?? "",
           component: component2,
           interactive: ctx.interactive.has(component2),
-          bounds: relative3(child)
+          bounds: relative4(child)
         });
       } else if (child.type === "TEXT") {
         instance.texts.push({
@@ -46418,7 +46272,7 @@ function outlineFrame(frame, where, ctx) {
       texts: [],
       interactive: ctx.interactive.has(component2),
       local: meta3?.remote === false,
-      bounds: relative3(node2),
+      bounds: relative4(node2),
       sizing: {
         horizontal: node2.layoutSizingHorizontal ?? "FIXED",
         vertical: node2.layoutSizingVertical ?? "FIXED"
@@ -46610,6 +46464,7 @@ var unmappedSchema = external_exports.object({
   /** A component drawn on a product page, which belongs in a Components library. */
   components: external_exports.array(external_exports.object({ nodeId: external_exports.string(), name: external_exports.string(), page: external_exports.string(), source: external_exports.string() }).strict()).optional()
 }).strict();
+var outlineFilesSchema = external_exports.object({ files: external_exports.array(external_exports.object({ key: external_exports.string(), name: external_exports.string() }).strict()) }).strict();
 
 // packages/zaku/dist/lib/repositories/outlines.js
 var FLOWS_DIR = "flows";
@@ -46629,12 +46484,12 @@ async function loadOutlines(dir) {
     features = (await readdir3(dir, { withFileTypes: true })).filter((entry) => entry.isDirectory() && entry.name !== FLOWS_DIR).map((entry) => entry.name).sort();
   } catch (error62) {
     if (error62.code === "ENOENT")
-      return { outlines, flows, unmapped: null, errors };
+      return { outlines, flows, unmapped: null, files: null, errors };
     throw error62;
   }
   for (const feature of features) {
-    const files2 = (await readdir3(join5(dir, feature))).filter((name) => name.endsWith(".yaml")).sort();
-    for (const file2 of files2) {
+    const files3 = (await readdir3(join5(dir, feature))).filter((name) => name.endsWith(".yaml")).sort();
+    for (const file2 of files3) {
       try {
         outlines.push(await readDesignFile(join5(dir, feature, file2), screenOutlineSchema));
       } catch (error62) {
@@ -46651,8 +46506,8 @@ async function loadOutlines(dir) {
     throw error62;
   });
   for (const source of sources.sort()) {
-    const files2 = (await readdir3(join5(dir, FLOWS_DIR, source))).filter((name) => name.endsWith(".yaml")).sort();
-    for (const file2 of files2) {
+    const files3 = (await readdir3(join5(dir, FLOWS_DIR, source))).filter((name) => name.endsWith(".yaml")).sort();
+    for (const file2 of files3) {
       try {
         flows.push(await readDesignFile(join5(dir, FLOWS_DIR, source, file2), flowOutlineSchema));
       } catch (error62) {
@@ -46672,7 +46527,16 @@ async function loadOutlines(dir) {
     else
       throw error62;
   }
-  return { outlines, flows, unmapped, errors };
+  let files2 = null;
+  try {
+    files2 = await readOptionalDesignFile(join5(dir, "files.yaml"), outlineFilesSchema);
+  } catch (error62) {
+    if (error62 instanceof DesignFileInvalid)
+      errors.push(error62);
+    else
+      throw error62;
+  }
+  return { outlines, flows, unmapped, files: files2, errors };
 }
 
 // packages/zaku/dist/lib/handlers/write-outline.js
@@ -46749,9 +46613,28 @@ function productFiles(config2) {
     targets: graph.targetsOf(product.family)
   }));
 }
+async function readFileNames(rest, config2, read) {
+  const graph = designGraph(config2);
+  const files2 = [];
+  for (const file2 of [...graph.products, ...graph.prototypes]) {
+    const name = read.get(file2.key);
+    if (name !== void 0)
+      files2.push({ key: file2.key, name });
+  }
+  for (const library of graph.libraries.filter((each) => each.layer === "components")) {
+    try {
+      files2.push({ key: library.key, name: await rest.fileName(library.key) });
+    } catch (error62) {
+      if (error62 instanceof FigmaRequestFailed && (error62.status === 403 || error62.status === 404))
+        continue;
+      throw error62;
+    }
+  }
+  return { files: files2 };
+}
 async function runOutline(options) {
   const paths = designPaths(options.root);
-  const config2 = await readDesignFile(paths.config, zakuConfigSchema);
+  const { config: config2 } = options;
   const { libraries: listed, kits, products: byFamily, prototypes: flows } = config2.figma;
   const legacy = [listed, kits, byFamily, flows].every((files2) => files2 === void 0);
   const products = productFiles(config2);
@@ -46766,6 +46649,7 @@ async function runOutline(options) {
   const existing = await loadOutlines(paths.outline);
   const prototypes = new Set(legacy ? config2.targets.map((target) => `${target.name} prototype`) : []);
   const versions = {};
+  const names = /* @__PURE__ */ new Map();
   const flowPages = /* @__PURE__ */ new Map();
   const flowFrame = (source, frame, targets) => {
     const parsed = parseFrameName(frame.name, targets);
@@ -46783,6 +46667,7 @@ ${frame.page}`;
   for (const product of products) {
     const file2 = await options.rest.file(product.key, INDEX_DEPTH);
     versions[product.key] = file2.version;
+    names.set(product.key, file2.name);
     const listed2 = listFrames(file2.document);
     for (const frame of listed2.filter((candidate) => prototypes.has(candidate.page)))
       flowFrame(product.key, frame, product.targets);
@@ -46806,6 +46691,7 @@ ${frame.page}`;
   for (const file2 of legacy ? [] : graph.prototypes) {
     const read = await options.rest.file(file2.key, INDEX_DEPTH);
     versions[file2.key] = read.version;
+    names.set(file2.key, read.name);
     const targets = graph.targetsOf(file2.family);
     for (const frame of listFrames(read.document).filter((candidate) => holdsScreens(candidate.page)))
       flowFrame(file2.key, frame, targets);
@@ -46813,6 +46699,10 @@ ${frame.page}`;
   unmapped.fileVersion = Object.values(versions).join(",");
   if (!legacy)
     unmapped.components = components;
+  if (!legacy) {
+    await mkdir2(paths.outline, { recursive: true });
+    await writeFile3(paths.files, (0, import_yaml2.stringify)(await readFileNames(options.rest, config2, names)));
+  }
   const outlined = new Set(existing.outlines.flatMap((outline) => outline.frames.map((frame) => frame.nodeId)));
   const drawnScreens = new Set([...resolved.values()].map(({ ref }) => `${ref.feature}/${ref.id}`));
   const current = existing.outlines.every((outline) => (legacy ? outline.fileVersion === versions[outline.source] : isDeepStrictEqual2(outline.fileVersions, versions)) && outline.mapDigest === digests.get(outline.feature) && isDeepStrictEqual2(outline.libraryVersions, libraryVersions)) && [...resolved.keys()].every((id2) => outlined.has(id2)) && existing.flows.length === flowPages.size && existing.flows.every((flow) => flow.fileVersion === versions[flow.source]) && existing.outlines.every((outline) => drawnScreens.has(`${outline.feature}/${outline.screen}`));
@@ -46933,7 +46823,7 @@ var WriteOutlineHandler = class WriteOutlineHandler2 {
     this.rest = rest;
   }
   handle(command) {
-    return runOutline({ root: command.root, rest: this.rest, frames: command.frames });
+    return runOutline({ root: command.root, config: command.config, rest: this.rest, frames: command.frames });
   }
 };
 WriteOutlineHandler = __decorate2([
@@ -46944,10 +46834,389 @@ WriteOutlineHandler = __decorate2([
 // packages/zaku/dist/lib/handlers/write-schemas.js
 var import_tsyringe5 = __toESM(require_cjs(), 1);
 
+// packages/zaku/dist/lib/schema/zaku-config.js
+import { posix } from "node:path";
+
+// packages/zaku/dist/lib/domain/copy-defaults.js
+var DEFAULT_COPY = { locales: ["en"], currencies: [] };
+
+// packages/zaku/dist/lib/schema/zaku-config.js
+var PLATFORM_FAMILIES = ["web", "ios", "android", "macos", "windows", "gnome", "kde"];
+var LAYERS = ["foundations", "components"];
+var BRANCHES = ["ui", "native"];
+var DEFAULT_INTERACTIVE = [
+  "Button",
+  "Button Group",
+  "Checkbox",
+  "Combobox",
+  "Dropdown Menu",
+  "Input",
+  "Input Group",
+  "Input OTP",
+  "Native Select",
+  "Pagination",
+  "Radio Group",
+  "Select",
+  "Slider",
+  "Switch",
+  "Tabs",
+  "Textarea",
+  "Toggle",
+  "Toggle Group"
+];
+var id = external_exports.string().regex(/^[a-z][a-z0-9-]*$/, "lowercase letters, digits and dashes, starting with a letter");
+var targetSchema = external_exports.object({
+  id,
+  family: external_exports.enum(PLATFORM_FAMILIES),
+  name: external_exports.string().regex(/^\S(.*\S)?$/, "a name has no leading or trailing space").refine((name) => !name.includes("/"), "a name has no slash, which separates the parts of a frame name"),
+  /** The frame size every frame of this target is drawn at; the frame check compares it. */
+  size: external_exports.object({ width: external_exports.number().positive(), height: external_exports.number().positive() }).strict().optional(),
+  /** The renderer whose libraries its frames draw from; `defaultBranch` in the design graph gives it when left out. */
+  branch: external_exports.enum(BRANCHES).optional()
+}).strict();
+var DEFAULT_SYSTEM_BARS = {
+  web: [],
+  ios: [["Status Bar"], ["Home Indicator"]],
+  android: [["Status Bar"], ["Navigation Bar", "Gesture Handle"]],
+  macos: [["Window Controls"]],
+  windows: [["Title Bar"]],
+  gnome: [["Header Bar"]],
+  kde: [["Title Bar"]]
+};
+function systemBarNames(config2) {
+  const bars = { ...DEFAULT_SYSTEM_BARS, ...config2.systemBars };
+  return new Set(Object.values(bars).flat(2));
+}
+var budgetSchema = external_exports.object({
+  mcpPerDay: external_exports.number().int().positive().default(200),
+  mcpPerRun: external_exports.number().int().positive().default(30),
+  reserve: external_exports.number().min(0).max(1).default(0.2)
+}).strict();
+var fileKey = external_exports.string().min(1);
+var kitSchema = external_exports.object({ key: fileKey, family: external_exports.enum(PLATFORM_FAMILIES) }).strict();
+var librarySchema = external_exports.object({
+  key: fileKey,
+  layer: external_exports.enum(LAYERS),
+  branches: external_exports.array(external_exports.enum(BRANCHES)).min(1),
+  /** The libraries and kits this one is built on, by key. */
+  extends: external_exports.array(fileKey).default([])
+}).strict();
+var productSchema = external_exports.object({ key: fileKey, family: external_exports.enum(PLATFORM_FAMILIES) }).strict();
+var prototypeSchema = external_exports.object({ key: fileKey, family: external_exports.enum(PLATFORM_FAMILIES) }).strict();
+var files = external_exports.object({
+  library: fileKey.optional(),
+  product: fileKey.optional(),
+  kits: external_exports.array(kitSchema).optional(),
+  libraries: external_exports.array(librarySchema).optional(),
+  products: external_exports.array(productSchema).optional(),
+  prototypes: external_exports.array(prototypeSchema).optional()
+}).strict();
+function byRole(figma) {
+  return [figma.kits, figma.libraries, figma.products, figma.prototypes].some((list) => list !== void 0);
+}
+var shadcnSystem = external_exports.object({
+  preset: external_exports.string().min(1),
+  /** The stylesheet `zaku tokens` reads, relative to the directory of the workspace config. */
+  css: external_exports.string().min(1).optional()
+}).strict();
+var tokenFiles = external_exports.array(external_exports.string().min(1)).min(1);
+var resolverInputs = external_exports.record(external_exports.string(), external_exports.string());
+var dtcgSystem = external_exports.object({
+  resolver: external_exports.string().min(1).optional(),
+  light: external_exports.union([tokenFiles, resolverInputs]),
+  dark: external_exports.union([tokenFiles, resolverInputs]),
+  /** The group whose tokens are the colour roles, and the one whose tokens are the radius steps. */
+  colors: external_exports.string().min(1).default("color"),
+  radii: external_exports.string().min(1).default("radius"),
+  /** Foreground and background token pairs a text is read in, each needing 4.5:1. */
+  contrast: external_exports.array(external_exports.tuple([external_exports.string().min(1), external_exports.string().min(1)])).default([])
+}).strict().superRefine((dtcg, ctx) => {
+  for (const scheme of ["light", "dark"]) {
+    const files2 = Array.isArray(dtcg[scheme]);
+    if (dtcg.resolver !== void 0 && files2) {
+      ctx.addIssue({
+        code: "custom",
+        path: [scheme],
+        message: "with a resolver, name the modifier contexts, not files"
+      });
+    }
+    if (dtcg.resolver === void 0 && !files2) {
+      ctx.addIssue({
+        code: "custom",
+        path: [scheme],
+        message: "without a resolver, list the token files"
+      });
+    }
+  }
+});
+var designSystemSchema = external_exports.union([
+  external_exports.object({ shadcn: shadcnSystem }).strict(),
+  external_exports.object({ dtcg: dtcgSystem }).strict()
+]);
+var recipeSchema = external_exports.object({
+  url: external_exports.url().optional(),
+  dark: external_exports.enum(["class", "media"]).default("class"),
+  darkClass: external_exports.string().min(1).default("dark")
+}).strict();
+function writtenInAScript(tag) {
+  try {
+    return new Intl.Locale(tag).maximize().script !== void 0;
+  } catch {
+    return false;
+  }
+}
+var copySchema = external_exports.object({
+  locales: external_exports.array(external_exports.string().refine(writtenInAScript, "a BCP 47 language tag, such as en or vi")).min(1).default(["en"]),
+  currencies: external_exports.array(external_exports.string().refine((code) => Intl.supportedValuesOf("currency").includes(code), "an ISO 4217 code, such as VND or USD")).default([])
+}).strict();
+var configShape = external_exports.object({
+  product: external_exports.string().min(1),
+  designSystem: designSystemSchema,
+  figma: files.default({}),
+  targets: external_exports.array(targetSchema).min(1),
+  modes: external_exports.record(external_exports.string(), external_exports.string()).default({}),
+  interactive: external_exports.array(external_exports.string().min(1)).default([...DEFAULT_INTERACTIVE]),
+  /** The bars of the families whose kit names them its own way; every family left out keeps its default. */
+  systemBars: external_exports.partialRecord(external_exports.enum(PLATFORM_FAMILIES), external_exports.array(external_exports.array(external_exports.string().min(1)).min(1))).optional(),
+  budget: budgetSchema.default({ mcpPerDay: 200, mcpPerRun: 30, reserve: 0.2 }),
+  recipe: recipeSchema.optional(),
+  copy: copySchema.default(DEFAULT_COPY)
+}).strict();
+var zakuConfigSchema = configShape.superRefine((config2, ctx) => {
+  for (const key of ["id", "name"]) {
+    const seen = /* @__PURE__ */ new Set();
+    config2.targets.forEach((target, index) => {
+      if (seen.has(target[key])) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["targets", index, key],
+          message: `a second target with ${key} ${target[key]}`
+        });
+      }
+      seen.add(target[key]);
+    });
+  }
+  if (byRole(config2.figma))
+    refineFilesByRole(config2, ctx);
+});
+function refineFilesByRole(config2, ctx) {
+  const { figma } = config2;
+  if (figma.library !== void 0 || figma.product !== void 0) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["figma"],
+      message: "figma.library and figma.product describe one library and one product; list files by role instead"
+    });
+  }
+  const kits = figma.kits ?? [];
+  const libraries = figma.libraries ?? [];
+  const products = figma.products ?? [];
+  const seen = /* @__PURE__ */ new Set();
+  const lists = [
+    ["kits", kits],
+    ["libraries", libraries],
+    ["products", products],
+    ["prototypes", figma.prototypes ?? []]
+  ];
+  for (const [list, entries] of lists) {
+    entries.forEach((entry, index) => {
+      if (seen.has(entry.key))
+        ctx.addIssue({
+          code: "custom",
+          path: ["figma", list, index, "key"],
+          message: `a second file with key ${entry.key}`
+        });
+      seen.add(entry.key);
+    });
+  }
+  const byKey = new Map(libraries.map((library) => [library.key, library]));
+  const kitKeys = new Set(kits.map((kit) => kit.key));
+  libraries.forEach((library, index) => {
+    const path2 = ["figma", "libraries", index, "extends"];
+    for (const key of library.extends) {
+      const base = byKey.get(key);
+      if (!base && !kitKeys.has(key)) {
+        ctx.addIssue({
+          code: "custom",
+          path: path2,
+          message: `${library.key} extends ${key}, which is no library or kit listed`
+        });
+      } else if (base?.layer === "components" && library.layer === "foundations") {
+        ctx.addIssue({ code: "custom", path: path2, message: `foundations ${library.key} extends components ${key}` });
+      } else if (base && !base.branches.some((branch) => library.branches.includes(branch))) {
+        ctx.addIssue({
+          code: "custom",
+          path: path2,
+          message: `${library.key} extends ${key}, which holds none of its branches`
+        });
+      }
+    }
+  });
+  const cycle = findCycle(libraries);
+  if (cycle)
+    ctx.addIssue({ code: "custom", path: ["figma", "libraries"], message: `extends comes back: ${cycle}` });
+  for (const [list, entries] of [
+    ["products", products],
+    ["prototypes", figma.prototypes ?? []]
+  ]) {
+    const families2 = /* @__PURE__ */ new Set();
+    entries.forEach((entry, index) => {
+      if (families2.has(entry.family))
+        ctx.addIssue({
+          code: "custom",
+          path: ["figma", list, index, "family"],
+          message: `a second ${list === "products" ? "product" : "prototype"} file for ${entry.family}`
+        });
+      families2.add(entry.family);
+    });
+  }
+  (figma.prototypes ?? []).forEach((prototype2, index) => {
+    if (!products.some((product) => product.family === prototype2.family))
+      ctx.addIssue({
+        code: "custom",
+        path: ["figma", "prototypes", index, "family"],
+        message: `no product file for ${prototype2.family} to copy its frames from`
+      });
+  });
+  config2.targets.forEach((target, index) => {
+    const branch = target.branch ?? defaultBranch(target.family);
+    const path2 = ["targets", index, "branch"];
+    if (branch === void 0) {
+      ctx.addIssue({ code: "custom", path: path2, message: `a ${target.family} target names its branch, ui or native` });
+    } else if (libraries.length > 0 && !libraries.some((library) => library.branches.includes(branch))) {
+      ctx.addIssue({ code: "custom", path: path2, message: `no library holds the ${branch} branch` });
+    }
+  });
+}
+function findCycle(libraries) {
+  const byKey = new Map(libraries.map((library) => [library.key, library]));
+  const visit2 = (key, path2) => {
+    if (path2.includes(key))
+      return [...path2.slice(path2.indexOf(key)), key].join(" -> ");
+    for (const next of byKey.get(key)?.extends ?? []) {
+      const found = visit2(next, [...path2, key]);
+      if (found)
+        return found;
+    }
+    return void 0;
+  };
+  for (const library of libraries) {
+    const found = visit2(library.key, []);
+    if (found)
+      return found;
+  }
+  return void 0;
+}
+var SHARED_KEYS = ["designSystem", "modes", "copy", "interactive", "systemBars", "budget"];
+var sharedShape = {
+  designSystem: designSystemSchema.optional(),
+  modes: configShape.shape.modes.unwrap().optional(),
+  copy: copySchema.optional(),
+  interactive: configShape.shape.interactive.unwrap().optional(),
+  systemBars: configShape.shape.systemBars,
+  budget: budgetSchema.optional()
+};
+var PRODUCT_NAME = /^[A-Z0-9][A-Za-z0-9]*( [A-Z0-9][A-Za-z0-9]*)*$/;
+var workspaceProduct = external_exports.object({
+  /** Title-case ASCII words: what people call the product and what its Figma files are named for. */
+  name: external_exports.string().regex(PRODUCT_NAME, "title-case words of ASCII letters and digits, such as Back Office"),
+  /** The directory of the product's design, relative to the config and inside its directory. */
+  root: external_exports.string().min(1)
+}).strict();
+function cleanRoot(root) {
+  if (root.includes("\\"))
+    return { problem: "use forward slashes" };
+  if (root.startsWith("/"))
+    return { problem: "a root is relative to the config, not absolute" };
+  const path2 = posix.normalize(root).replace(/\/$/, "");
+  if (path2 === ".." || path2.startsWith("../"))
+    return { problem: "a root stays inside the config's directory" };
+  return { path: path2 };
+}
+function overlaps(a, b) {
+  return a === "." || b === "." || a === b || a.startsWith(`${b}/`) || b.startsWith(`${a}/`);
+}
+var workspaceConfigSchema = external_exports.object({
+  ...sharedShape,
+  products: external_exports.array(workspaceProduct).min(1).optional(),
+  product: external_exports.string().min(1).optional(),
+  figma: files.optional(),
+  targets: external_exports.array(targetSchema).optional(),
+  recipe: recipeSchema.optional()
+}).strict().superRefine((config2, ctx) => {
+  const { products, ...single } = config2;
+  if (products === void 0) {
+    const result = zakuConfigSchema.safeParse(single);
+    if (!result.success) {
+      for (const issue2 of result.error.issues) {
+        ctx.addIssue({ code: "custom", path: issue2.path, message: issue2.message });
+      }
+    }
+    return;
+  }
+  for (const key of ["product", "figma", "targets", "recipe"]) {
+    if (config2[key] !== void 0) {
+      ctx.addIssue({
+        code: "custom",
+        path: [key],
+        message: `a workspace that lists products keeps ${key} in each product`
+      });
+    }
+  }
+  const names = /* @__PURE__ */ new Set();
+  const roots = [];
+  products.forEach((product, index) => {
+    if (names.has(product.name)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["products", index, "name"],
+        message: `a second product named ${product.name}`
+      });
+    }
+    names.add(product.name);
+    const root = cleanRoot(product.root);
+    if ("problem" in root) {
+      ctx.addIssue({ code: "custom", path: ["products", index, "root"], message: root.problem });
+      return;
+    }
+    const clash = roots.find((other) => overlaps(other, root.path));
+    if (clash !== void 0) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["products", index, "root"],
+        message: `${product.root} overlaps ${clash}, which another product holds`
+      });
+    }
+    roots.push(root.path);
+  });
+});
+var productConfigSchema = external_exports.object({
+  ...sharedShape,
+  figma: files.default({}),
+  targets: external_exports.array(targetSchema).min(1),
+  recipe: recipeSchema.optional()
+}).strict();
+function mergeProductConfig(shared, name, product) {
+  const own2 = productConfigSchema.safeParse(product);
+  if (!own2.success)
+    throw new DesignFileInvalid(`zaku.yaml of ${name}`, issueLines(own2.error));
+  const merged = { ...own2.data, product: name };
+  for (const key of SHARED_KEYS)
+    merged[key] = own2.data[key] ?? shared[key];
+  const result = zakuConfigSchema.safeParse(merged);
+  if (!result.success)
+    throw new DesignFileInvalid(`zaku.yaml of ${name}`, issueLines(result.error));
+  return result.data;
+}
+function issueLines(error62) {
+  return error62.issues.map((issue2) => `${issue2.path.map(String).join(".") || "(root)"}: ${issue2.message}`);
+}
+
 // packages/zaku/dist/lib/schema/json-schemas.js
 function designJsonSchemas() {
   return {
     "zaku.schema.json": external_exports.toJSONSchema(zakuConfigSchema, { io: "input" }),
+    "zaku-config.schema.json": external_exports.toJSONSchema(workspaceConfigSchema, { io: "input" }),
     "map.schema.json": external_exports.toJSONSchema(featureMapSchema, { io: "input" })
   };
 }
@@ -46991,22 +47260,8 @@ RecordBudgetCallsHandler = __decorate2([
   __param2(0, (0, import_tsyringe6.inject)(TOKENS.BUDGET_LEDGER))
 ], RecordBudgetCallsHandler);
 
-// packages/zaku/dist/lib/repositories/design-config-repository.js
-var import_tsyringe7 = __toESM(require_cjs(), 1);
-var DesignConfigRepository = class DesignConfigRepository2 {
-  read(root) {
-    return readDesignFile(designPaths(root).config, zakuConfigSchema);
-  }
-  readOptional(root) {
-    return readOptionalDesignFile(designPaths(root).config, zakuConfigSchema);
-  }
-};
-DesignConfigRepository = __decorate2([
-  (0, import_tsyringe7.injectable)({ token: TOKENS.DESIGN_CONFIG_REPOSITORY })
-], DesignConfigRepository);
-
 // packages/zaku/dist/lib/repositories/token-document-repository.js
-var import_tsyringe8 = __toESM(require_cjs(), 1);
+var import_tsyringe7 = __toESM(require_cjs(), 1);
 var TokenDocumentRepository = class TokenDocumentRepository2 {
   async save(root, doc) {
     const path2 = designPaths(root).tokens;
@@ -47015,11 +47270,11 @@ var TokenDocumentRepository = class TokenDocumentRepository2 {
   }
 };
 TokenDocumentRepository = __decorate2([
-  (0, import_tsyringe8.injectable)({ token: TOKENS.TOKEN_DOCUMENT_REPOSITORY })
+  (0, import_tsyringe7.injectable)({ token: TOKENS.TOKEN_DOCUMENT_REPOSITORY })
 ], TokenDocumentRepository);
 
 // packages/zaku/dist/lib/repositories/recipe-repository.js
-var import_tsyringe9 = __toESM(require_cjs(), 1);
+var import_tsyringe8 = __toESM(require_cjs(), 1);
 var RecipeRepository = class RecipeRepository2 {
   async save(root, doc) {
     const path2 = designPaths(root).recipe;
@@ -47028,11 +47283,11 @@ var RecipeRepository = class RecipeRepository2 {
   }
 };
 RecipeRepository = __decorate2([
-  (0, import_tsyringe9.injectable)({ token: TOKENS.RECIPE_REPOSITORY })
+  (0, import_tsyringe8.injectable)({ token: TOKENS.RECIPE_REPOSITORY })
 ], RecipeRepository);
 
 // packages/zaku/dist/lib/repositories/json-schema-files.js
-var import_tsyringe10 = __toESM(require_cjs(), 1);
+var import_tsyringe9 = __toESM(require_cjs(), 1);
 import { mkdir as mkdir3 } from "node:fs/promises";
 import { join as join7 } from "node:path";
 var JsonSchemaFiles = class JsonSchemaFiles2 {
@@ -47048,11 +47303,11 @@ var JsonSchemaFiles = class JsonSchemaFiles2 {
   }
 };
 JsonSchemaFiles = __decorate2([
-  (0, import_tsyringe10.injectable)({ token: TOKENS.JSON_SCHEMA_FILES })
+  (0, import_tsyringe9.injectable)({ token: TOKENS.JSON_SCHEMA_FILES })
 ], JsonSchemaFiles);
 
 // packages/zaku/dist/lib/repositories/source-files.js
-var import_tsyringe11 = __toESM(require_cjs(), 1);
+var import_tsyringe10 = __toESM(require_cjs(), 1);
 import { readFile as readFile4 } from "node:fs/promises";
 var SourceFiles = class SourceFiles2 {
   readText(path2) {
@@ -47063,7 +47318,7 @@ var SourceFiles = class SourceFiles2 {
   }
 };
 SourceFiles = __decorate2([
-  (0, import_tsyringe11.injectable)({ token: TOKENS.SOURCE_FILES })
+  (0, import_tsyringe10.injectable)({ token: TOKENS.SOURCE_FILES })
 ], SourceFiles);
 
 // packages/zaku/dist/lib/repositories/budget-ledger.js
@@ -47165,81 +47420,6 @@ function printGraph(config2, snapshots) {
   return lines;
 }
 
-// packages/zaku/dist/lib/adapters/figma-rest.js
-var FigmaRateLimited = class extends Error {
-  url;
-  constructor(url2) {
-    super(`Figma answered 429 twice for ${url2}; wait and run again`);
-    this.url = url2;
-    this.name = "FigmaRateLimited";
-  }
-};
-var FigmaRequestFailed = class extends Error {
-  url;
-  status;
-  constructor(url2, status, body) {
-    super(`Figma answered ${status} for ${url2}: ${body.slice(0, 200)}`);
-    this.url = url2;
-    this.status = status;
-    this.name = "FigmaRequestFailed";
-  }
-};
-var BASE = "https://api.figma.com/v1";
-var BATCH = 50;
-var MAX_WAIT_MS = 12e4;
-function createFigmaRest(options) {
-  const send = options.fetch ?? globalThis.fetch;
-  const sleep = options.sleep ?? ((ms) => new Promise((done) => setTimeout(done, ms)));
-  const onCall = options.onCall ?? (() => void 0);
-  async function call(url2) {
-    for (let attempt = 0; attempt < 2; attempt += 1) {
-      const res = await send(url2, { headers: { "X-Figma-Token": options.token } });
-      onCall();
-      if (res.status === 429) {
-        if (attempt === 1)
-          break;
-        const seconds = Number(res.headers.get("Retry-After") ?? "60");
-        await sleep(Math.min(Number.isFinite(seconds) ? seconds * 1e3 : 6e4, MAX_WAIT_MS));
-        continue;
-      }
-      if (!res.ok)
-        throw new FigmaRequestFailed(url2, res.status, await res.text());
-      return await res.json();
-    }
-    throw new FigmaRateLimited(url2);
-  }
-  const chunks = (ids) => Array.from({ length: Math.ceil(ids.length / BATCH) }, (_, index) => ids.slice(index * BATCH, (index + 1) * BATCH));
-  async function components(fileKey3) {
-    const listed = await call(`${BASE}/files/${fileKey3}/components`);
-    return listed.meta.components;
-  }
-  return {
-    file: (fileKey3, depth) => call(`${BASE}/files/${fileKey3}?depth=${depth}`),
-    async nodes(fileKey3, ids) {
-      const merged = { version: "", nodes: {} };
-      for (const chunk of chunks(ids)) {
-        const part = await call(`${BASE}/files/${fileKey3}/nodes?ids=${encodeURIComponent(chunk.join(","))}`);
-        merged.version = part.version;
-        Object.assign(merged.nodes, part.nodes);
-      }
-      return merged;
-    },
-    async published(fileKey3) {
-      const sets = await call(`${BASE}/files/${fileKey3}/component_sets`);
-      return { sets: sets.meta.component_sets, components: await components(fileKey3) };
-    },
-    components,
-    async images(fileKey3, ids) {
-      const merged = {};
-      for (const chunk of chunks(ids)) {
-        const part = await call(`${BASE}/images/${fileKey3}?ids=${encodeURIComponent(chunk.join(","))}&format=png&scale=1`);
-        Object.assign(merged, part.images);
-      }
-      return merged;
-    }
-  };
-}
-
 // packages/zaku/dist/lib/adapters/figma-variables-script.js
 async function exportVariables(figma, options) {
   const collections = [...await figma.variables.getLocalVariableCollectionsAsync()];
@@ -47944,9 +48124,9 @@ async function startPluginBridge(options = {}) {
     if (!socket)
       return Promise.resolve({ ok: false, error: `file ${fileKey3} is not open in Figma with the zaku plugin` });
     const id2 = `c${++next}`;
-    return new Promise((resolve3) => {
+    return new Promise((resolve4) => {
       const timer = setTimeout(() => settle2(id2, { ok: false, error: `no answer from the zaku panel in ${timeoutMs / 1e3} s; ${PARTIAL}` }), timeoutMs);
-      pending.set(id2, { socket, resolve: resolve3, timer });
+      pending.set(id2, { socket, resolve: resolve4, timer });
       send(socket, { ...message, id: id2 });
     });
   }
@@ -48265,6 +48445,71 @@ var copy = ({ config: config2, maps, outlines }) => {
   return { findings };
 };
 
+// packages/zaku/dist/lib/domain/file-labels.js
+var FAMILY_LABELS = {
+  web: "Web",
+  ios: "iOS",
+  android: "Android",
+  macos: "macOS",
+  windows: "Windows",
+  gnome: "Linux",
+  kde: "Linux KDE"
+};
+var BRANCH_LABELS = { ui: "UI", native: "Native" };
+function branchLabel(branches) {
+  const [only2] = branches;
+  return branches.length === 1 && only2 ? BRANCH_LABELS[only2] : null;
+}
+function expectedFileName(product, role) {
+  if (role.kind !== "library") {
+    const family = `${product} - ${FAMILY_LABELS[role.family]}`;
+    return role.kind === "prototype" ? `${family} Prototype` : family;
+  }
+  if (role.layer === "foundations")
+    return null;
+  const branch = branchLabel(role.branches);
+  return branch ? `${product} - ${branch} Components` : `${product} - Components`;
+}
+function fileRoleLabel(role) {
+  if (role.kind !== "library")
+    return `${FAMILY_LABELS[role.family]} ${role.kind} file`;
+  const branch = branchLabel(role.branches);
+  return branch ? `${branch} ${role.layer} library` : `${role.layer} library`;
+}
+
+// packages/zaku/dist/lib/domain/checks/file-names.js
+var fileNames = (input2) => {
+  if (input2.fileNames === null)
+    return { findings: [] };
+  const graph = designGraph(input2.config);
+  if (graph.legacy)
+    return { findings: [] };
+  const roles = [
+    ...graph.products.map((file2) => [file2.key, { kind: "product", family: file2.family }]),
+    ...graph.prototypes.map((file2) => [file2.key, { kind: "prototype", family: file2.family }]),
+    ...graph.libraries.map((file2) => [
+      file2.key,
+      { kind: "library", layer: file2.layer, branches: file2.branches }
+    ])
+  ];
+  const names = new Map(input2.fileNames.map((file2) => [file2.key, file2.name]));
+  const { product } = input2.config;
+  const findings = [];
+  for (const [key, role] of roles) {
+    const actual = names.get(key);
+    const expected = expectedFileName(product, role);
+    if (actual === void 0 || expected === null || actual === expected)
+      continue;
+    const label2 = fileRoleLabel(role);
+    const article = /^(iOS|Android) /.test(label2) ? "an" : "a";
+    findings.push({
+      check: "file-names",
+      message: `${key} is named ${actual}; ${article} ${label2} of ${product} is named ${expected}; rename it in Figma, then run zaku outline`
+    });
+  }
+  return { findings };
+};
+
 // packages/zaku/dist/lib/domain/checks/coverage.js
 function frameKey(feature, name) {
   return `${feature}
@@ -49462,6 +49707,7 @@ var ALL_CHECKS = {
   "system-bars": systemBars,
   placement,
   naming,
+  "file-names": fileNames,
   component,
   prototype
 };
@@ -49502,6 +49748,7 @@ var CHECK_IDS = [
   "empty",
   "documentation",
   "naming",
+  "file-names",
   "component",
   "prototype"
 ];
@@ -49619,17 +49866,10 @@ async function optional3(read, findings) {
     throw error62;
   }
 }
-async function loadDesign(root) {
-  const paths = designPaths(root);
+async function loadDesign(product) {
+  const paths = designPaths(product.root);
   const findings = [];
-  let config2;
-  try {
-    config2 = await readDesignFile(paths.config, zakuConfigSchema);
-  } catch (error62) {
-    if (error62 instanceof DesignFileInvalid)
-      return { input: null, findings: [schemaFinding(error62)] };
-    throw error62;
-  }
+  const { config: config2 } = product;
   const { maps, errors: mapErrors } = await loadMaps(paths.maps);
   findings.push(...mapErrors.map(schemaFinding));
   for (const key of indexTitles(maps).duplicates) {
@@ -49640,7 +49880,7 @@ async function loadDesign(root) {
       message: `two screens share the title ${title}; a frame name could not tell them apart`
     });
   }
-  const { outlines, flows, unmapped, errors: outlineErrors } = await loadOutlines(paths.outline);
+  const { outlines, flows, unmapped, files: files2, errors: outlineErrors } = await loadOutlines(paths.outline);
   findings.push(...outlineErrors.map(schemaFinding));
   const { libraries, kits, errors: snapshotErrors } = await readDesignSnapshots(paths, config2);
   findings.push(...snapshotErrors.map(schemaFinding));
@@ -49657,15 +49897,80 @@ async function loadDesign(root) {
       libraries,
       kits,
       tokens,
-      recipe: recipe2
+      recipe: recipe2,
+      fileNames: files2?.files ?? null
     },
     findings
   };
 }
 
+// packages/zaku/dist/lib/repositories/workspace.js
+import { readFile as readFile6 } from "node:fs/promises";
+import { dirname as dirname4, join as join9, resolve as resolve2 } from "node:path";
+var WORKSPACE_CONFIG = "zaku.config.yaml";
+async function readOptionalText(path2) {
+  try {
+    return await readFile6(path2, "utf8");
+  } catch (error62) {
+    if (error62.code === "ENOENT")
+      return null;
+    throw error62;
+  }
+}
+function only(products, name) {
+  if (name === void 0)
+    return products;
+  const named = products.filter((product) => product.name === name);
+  if (named.length === 0)
+    throw new ProductUnknown(name, products.map((product) => product.name));
+  return named;
+}
+async function readWorkspace(cwd, options) {
+  const configPath = resolve2(cwd, options.config ?? WORKSPACE_CONFIG);
+  const text = await readOptionalText(configPath);
+  if (text === null) {
+    if (options.config !== void 0)
+      throw new WorkspaceConfigMissing(configPath, null);
+    const root = resolve2(cwd, "docs", "design");
+    const legacyPath = designPaths(root).config;
+    const config2 = await readOptionalDesignFile(legacyPath, zakuConfigSchema);
+    if (config2 === null)
+      throw new WorkspaceConfigMissing(configPath, legacyPath);
+    const products2 = only([{ name: config2.product, root, config: config2 }], options.product);
+    return { configPath: null, dir: resolve2(cwd), products: products2, legacy: true, budget: config2.budget };
+  }
+  const dir = dirname4(configPath);
+  const workspace = parseDesignFile(configPath, text, workspaceConfigSchema);
+  if (workspace.products === void 0) {
+    const config2 = parseDesignFile(configPath, text, zakuConfigSchema);
+    const products2 = only([{ name: config2.product, root: join9(dir, "design"), config: config2 }], options.product);
+    return { configPath, dir, products: products2, legacy: false, budget: config2.budget };
+  }
+  const listed = workspace.products.map((product) => ({ name: product.name, root: resolve2(dir, product.root) }));
+  const products = [];
+  for (const { name, root } of only(listed, options.product)) {
+    const path2 = designPaths(root).config;
+    try {
+      const own2 = await readOptionalDesignFile(path2, external_exports.unknown());
+      if (own2 === null)
+        throw new ProductConfigMissing(path2, name);
+      products.push({ name, root, config: mergeProductConfig(workspace, name, own2) });
+    } catch (error62) {
+      if (error62 instanceof ProductConfigMissing)
+        products.push({ name, root, refusal: error62 });
+      else if (error62 instanceof DesignFileInvalid) {
+        const refusal = error62.path === path2 ? error62 : new DesignFileInvalid(path2, error62.issues);
+        products.push({ name, root, refusal });
+      } else
+        throw error62;
+    }
+  }
+  return { configPath, dir, products, legacy: false, budget: workspace.budget ?? budgetSchema.parse({}) };
+}
+
 // apps/zaku-cli/src/dependencies.ts
 function compose(seams) {
-  const scope = import_tsyringe12.container.createChildContainer();
+  const scope = import_tsyringe11.container.createChildContainer();
   scope.register(TOKENS.CLOCK, { useValue: { now: seams.now } });
   scope.register(TOKENS.RUN_COMMAND, { useValue: seams.run });
   scope.register(TOKENS.BUDGET_LEDGER, {
@@ -49694,6 +49999,9 @@ function refusalOf(error62) {
   if (error62 instanceof FigmaFileKeyMissing) return { code: 3, line: error62.message };
   if (error62 instanceof FigmaTokenMissing) return { code: 3, line: error62.message };
   if (error62 instanceof LibraryKeyMissing) return { code: 3, line: error62.message };
+  if (error62 instanceof WorkspaceConfigMissing) return { code: 3, line: error62.message };
+  if (error62 instanceof ProductConfigMissing) return { code: 3, line: error62.message };
+  if (error62 instanceof ProductUnknown || error62 instanceof ProductRequired) return { code: 3, line: error62.message };
   if (error62 instanceof RecipePageFailed) return { code: 2, line: `zaku recipe: ${error62.message}` };
   return null;
 }
@@ -57203,7 +57511,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
+        await new Promise((resolve4) => setTimeout(resolve4, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error62) {
@@ -57220,7 +57528,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       const earlyReject = (error62) => {
         reject(error62);
       };
@@ -57298,7 +57606,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve3(parseResult.data);
+            resolve4(parseResult.data);
           }
         } catch (error62) {
           reject(error62);
@@ -57560,12 +57868,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve3, reject) => {
+    return new Promise((resolve4, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve3, interval);
+      const timeoutId = setTimeout(resolve4, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -58705,7 +59013,7 @@ var McpServer = class {
     let task = createTaskResult.task;
     const pollInterval = task.pollInterval ?? 5e3;
     while (task.status !== "completed" && task.status !== "failed" && task.status !== "cancelled") {
-      await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
+      await new Promise((resolve4) => setTimeout(resolve4, pollInterval));
       const updatedTask = await extra.taskStore.getTask(taskId);
       if (!updatedTask) {
         throw new McpError(ErrorCode.InternalError, `Task ${taskId} not found during polling`);
@@ -59369,12 +59677,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve3) => {
+    return new Promise((resolve4) => {
       const json2 = serializeMessage(message);
       if (this._stdout.write(json2)) {
-        resolve3();
+        resolve4();
       } else {
-        this._stdout.once("drain", resolve3);
+        this._stdout.once("drain", resolve4);
       }
     });
   }
@@ -59383,11 +59691,11 @@ var StdioServerTransport = class {
 // apps/zaku-cli/src/mcp/server.ts
 import { mkdir as mkdir5 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 
 // apps/zaku-cli/src/mcp/screenshots.ts
 import { readdir as readdir4, rm as rm3, stat } from "node:fs/promises";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 var KEPT_MS = 24 * 60 * 60 * 1e3;
 async function pruneScreenshots(dir, now) {
   let names;
@@ -59397,7 +59705,7 @@ async function pruneScreenshots(dir, now) {
     return;
   }
   for (const name of names.filter((entry) => entry.endsWith(".png"))) {
-    const path2 = join9(dir, name);
+    const path2 = join10(dir, name);
     const written = await stat(path2).then(
       (stats) => stats.mtimeMs,
       () => now
@@ -59408,7 +59716,7 @@ async function pruneScreenshots(dir, now) {
 
 // apps/zaku-cli/src/mcp/tools.ts
 import { writeFile as writeFile5 } from "node:fs/promises";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 var fileKey2 = 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."
 );
@@ -59452,7 +59760,7 @@ function registerFigmaTools(server, bridge, options) {
         options.timeoutMs
       );
       if (!answer.ok) return { isError: true, content: [{ type: "text", text: answer.error }] };
-      const path2 = join10(options.imageDir, `${id2.replace(":", "-")}-${Date.now()}.png`);
+      const path2 = join11(options.imageDir, `${id2.replace(":", "-")}-${Date.now()}.png`);
       await writeFile5(path2, Buffer.from(answer.png, "base64"));
       const text = JSON.stringify({
         path: path2,
@@ -59478,7 +59786,7 @@ 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 = join11(tmpdir(), "zaku-screenshots");
+  const imageDir = join12(tmpdir(), "zaku-screenshots");
   await mkdir5(imageDir, { recursive: true });
   await pruneScreenshots(imageDir, Date.now());
   const server = new McpServer({ name: "zaku", version: "1" });
@@ -59495,59 +59803,175 @@ async function serveMcp(log) {
 
 // apps/zaku-cli/src/cli.ts
 var USE_FIGMA_CODE_LIMIT = 5e4;
-var USAGE = "usage: zaku <check|outline|tokens|recipe|library|libraries|rules|budget|schema|mcp> [--root docs/design]";
-async function sendOrRefuse(cli, io, finish, command) {
-  try {
-    return await cli.bus.send(command);
-  } catch (error62) {
-    const refusal = refusalOf(error62);
-    if (!refusal) throw error62;
-    io.err(refusal.line);
-    finish(refusal.code);
-    return null;
-  }
-}
+var USAGE = "usage: zaku <check|outline|tokens|recipe|library|libraries|products|rules|budget|schema|mcp> [--config zaku.config.yaml] [--product <name>]";
+var LEGACY_WARNING = "zaku: read docs/design/zaku.yaml; move it to zaku.config.yaml at the repository root and the design to design/";
 async function recordRestCalls(cli, io) {
   const count = cli.restCalls();
   if (count === 0) return;
   const { seat, run } = seatAndRun(io.env);
   await cli.bus.send(new RecordBudgetCalls({ day: today(clock.now()), seat, run, kind: "rest", count }));
 }
+var CONFIG_OPTION = ["--config <path>", "the workspace config, when it is not zaku.config.yaml here"];
+var PRODUCT_OPTION = ["--product <name>", "only this product, by the name the workspace config gives it"];
+function warnLegacy(io, workspace) {
+  if (workspace.legacy) io.err(LEGACY_WARNING);
+}
+async function workspaceOf(io, options) {
+  const workspace = await readWorkspace(io.cwd, options);
+  warnLegacy(io, workspace);
+  return workspace;
+}
+function oneProduct(workspace, command) {
+  const [product, ...rest] = workspace.products;
+  if (product === void 0 || rest.length > 0) {
+    throw new ProductRequired(
+      command,
+      workspace.products.map((each) => each.name)
+    );
+  }
+  if ("refusal" in product) throw product.refusal;
+  return product;
+}
+function onlyWithOne(workspace, command, option, given) {
+  if (given !== void 0 && workspace.products.length > 1) {
+    throw new ProductRequired(
+      `${command} ${option}`,
+      workspace.products.map((product) => product.name)
+    );
+  }
+}
+function productFailure(error62) {
+  const refusal = refusalOf(error62);
+  if (refusal) return refusal;
+  if (error62 instanceof DesignFileInvalid || error62 instanceof FigmaRequestFailed) {
+    return { code: 1, line: `zaku: ${error62.message}` };
+  }
+  throw error62;
+}
+function reportRefusal(io, error62) {
+  const failure2 = productFailure(error62);
+  io.err(failure2.line);
+  return failure2.code;
+}
+async function forEachProduct(io, workspace, run) {
+  let code = 0;
+  for (const product of workspace.products) {
+    if (workspace.products.length > 1) io.out(`== ${product.name}`);
+    let exit;
+    try {
+      if ("refusal" in product) throw product.refusal;
+      exit = await run(product);
+    } catch (error62) {
+      exit = reportRefusal(io, error62);
+    }
+    code = Math.max(code, exit);
+  }
+  return code;
+}
 var librariesCommand = (program2, io, finish) => {
-  program2.command("libraries").description("print the design graph: what each target draws from, and what each file extends and is extended by").option("--root <dir>", "the design directory", "docs/design").action(async (options) => {
-    const paths = designPaths(resolve2(io.cwd, options.root));
-    const config2 = await readDesignFile(paths.config, zakuConfigSchema);
-    for (const line of printGraph(config2, await readDesignSnapshots(paths, config2))) io.out(line);
+  program2.command("libraries").description("print the design graph: what each target draws from, and what each file extends and is extended by").option(...CONFIG_OPTION).option(...PRODUCT_OPTION).action(async (options) => {
+    const workspace = await workspaceOf(io, options);
+    finish(
+      await forEachProduct(io, workspace, async ({ root, config: config2 }) => {
+        for (const line of printGraph(config2, await readDesignSnapshots(designPaths(root), config2))) io.out(line);
+        return 0;
+      })
+    );
+  });
+};
+var productsCommand = (program2, io, finish) => {
+  program2.command("products").description("print each product the workspace config lists, with its design directory").option(...CONFIG_OPTION).option("--json", "print them as JSON").action(async (options) => {
+    const workspace = await workspaceOf(io, options.config === void 0 ? {} : { config: options.config });
+    const rows = workspace.products.map((product) => ({
+      name: product.name,
+      root: relative3(io.cwd, product.root) || "."
+    }));
+    if (options.json) io.out(JSON.stringify(rows, null, 2));
+    else for (const row of rows) io.out(`${row.name}	${row.root}`);
     finish(0);
   });
 };
 var schemaCommand = (program2, io, finish, cli) => {
-  program2.command("schema").description("write the JSON Schemas an editor reads for the design files").option("--out <dir>", "where to write them", "docs/design").action(async (options) => {
-    const written = await cli.bus.send(new WriteSchemas({ out: resolve2(io.cwd, options.out) }));
+  program2.command("schema").description("write the JSON Schemas an editor reads for the design files").option("--out <dir>", "where to write them; the workspace config's directory when left out").option(...CONFIG_OPTION).action(async (options) => {
+    const out = options.out !== void 0 ? resolve3(io.cwd, options.out) : options.config !== void 0 ? dirname5(resolve3(io.cwd, options.config)) : resolve3(io.cwd);
+    const written = await cli.bus.send(new WriteSchemas({ out }));
     for (const path2 of written) io.out(`wrote ${path2}`);
     finish(0);
   });
 };
+function checkExit(codes) {
+  const rank = (code) => code === 1 ? 2 : code === 2 ? 1 : code;
+  return codes.reduce((worst, code) => rank(code) > rank(worst) ? code : worst, 0);
+}
+async function checkProduct(product, ran) {
+  let loaded;
+  if ("refusal" in product) {
+    if (!(product.refusal instanceof DesignFileInvalid)) return { refusal: product.refusal };
+    loaded = { input: null, findings: [{ check: "schema", message: product.refusal.message }] };
+  } else {
+    try {
+      loaded = await loadDesign(product);
+    } catch (error62) {
+      if (!(error62 instanceof DesignFileInvalid)) throw error62;
+      loaded = { input: null, findings: [{ check: "schema", message: error62.message }] };
+    }
+  }
+  const report = loaded.input ? runChecks(loaded.input, ALL_CHECKS) : { findings: [], notRun: [], passed: [] };
+  report.findings.unshift(...loaded.findings);
+  if (ran) report.findings.push(...ran.findings);
+  const left = ran ? leftOut(ran) : [];
+  return {
+    report: { ...report, ...left.length > 0 ? { leftOut: left } : {} },
+    code: loaded.input ? exitCode(report) : 1
+  };
+}
 var checkCommand = (program2, io, finish) => {
-  program2.command("check").description("run every check over the committed design files").option("--root <dir>", "the design directory", "docs/design").option("--json", "print the report as JSON").option("--input <rules.json>", "what use_figma returned for zaku rules script, with or without --after").action(async (options) => {
-    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 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}`);
+  program2.command("check").description("run every check over each product's committed design files").option(...CONFIG_OPTION).option(...PRODUCT_OPTION).option("--json", "print the report as JSON, keyed by product when there are several").option("--input <rules.json>", "what use_figma returned for zaku rules script, with or without --after").action(async (options) => {
+    let workspace;
+    try {
+      workspace = await workspaceOf(io, options);
+    } catch (error62) {
+      if (!(error62 instanceof DesignFileInvalid)) throw error62;
+      const report = { findings: [{ check: "schema", message: error62.message }], notRun: [], passed: [] };
+      if (options.json) io.out(JSON.stringify(report, null, 2));
+      else for (const line of formatReport(report)) io.out(line);
       finish(1);
       return;
     }
-    if (ran) report.findings.push(...ran.findings);
-    const left = ran ? leftOut(ran) : [];
-    if (options.json) io.out(JSON.stringify({ ...report, ...left.length > 0 ? { leftOut: left } : {} }, null, 2));
-    else for (const line of [...left, ...formatReport(report)]) io.out(line);
-    finish(loaded.input ? exitCode(report) : 1);
+    onlyWithOne(workspace, "zaku check", "--input", options.input);
+    const answer = options.input ? parseDesignFile(options.input, await readFile7(resolve3(io.cwd, options.input), "utf8"), rulesAnswerSchema) : null;
+    if (answer && "rulesError" in answer) {
+      io.err(`zaku check: the rules did not run after the write: ${answer.rulesError}`);
+      finish(1);
+      return;
+    }
+    const several = workspace.products.length > 1;
+    const reports = {};
+    const codes = [];
+    for (const product of workspace.products) {
+      if (several && !options.json) io.out(`== ${product.name}`);
+      const checked = await checkProduct(product, answer);
+      if ("refusal" in checked) {
+        const failure2 = productFailure(checked.refusal);
+        io.err(failure2.line);
+        codes.push(failure2.code);
+        if (options.json) reports[product.name] = { refusal: failure2.line };
+        continue;
+      }
+      codes.push(checked.code);
+      if (options.json) reports[product.name] = checked.report;
+      else for (const line of [...checked.report.leftOut ?? [], ...formatReport(checked.report)]) io.out(line);
+    }
+    if (options.json) {
+      const [only2] = Object.values(reports);
+      if (several) io.out(JSON.stringify(reports, null, 2));
+      else if (only2) io.out(JSON.stringify(only2, null, 2));
+    }
+    finish(checkExit(codes));
   });
 };
 async function productPlaywright(cwd) {
-  const require2 = createRequire(join12(cwd, "package.json"));
+  const require2 = createRequire(join13(cwd, "package.json"));
   let resolved;
   try {
     resolved = require2.resolve("playwright");
@@ -59558,15 +59982,15 @@ async function productPlaywright(cwd) {
   return require2("playwright");
 }
 function fromProductTree(cwd, resolved) {
-  for (let dir = resolve2(cwd); ; dir = dirname4(dir)) {
-    if (resolved.startsWith(join12(dir, "node_modules") + sep)) return true;
-    if (dirname4(dir) === dir) return false;
+  for (let dir = resolve3(cwd); ; dir = dirname5(dir)) {
+    if (resolved.startsWith(join13(dir, "node_modules") + sep)) return true;
+    if (dirname5(dir) === dir) return false;
   }
 }
 var runners = {
   run: execRun,
   loadPlaywright: productPlaywright,
-  rulesLibrary: () => readFile6(fileURLToPath(new URL("./rules.js", import.meta.url)), "utf8")
+  rulesLibrary: () => readFile7(fileURLToPath(new URL("./rules.js", import.meta.url)), "utf8")
 };
 var mcpCommand = (program2, io, finish) => {
   program2.command("mcp").description(
@@ -59577,30 +60001,35 @@ var mcpCommand = (program2, io, finish) => {
   });
 };
 var tokensCommand = (program2, io, finish, cli) => {
-  program2.command("tokens").description("write the code's tokens to tokens.json, from the design system zaku.yaml names").option("--css <path>", "the stylesheet that declares :root and .dark (shadcn)").option("--root <dir>", "the design directory", "docs/design").action(async (options) => {
-    const command = new WriteTokens({
-      root: resolve2(io.cwd, options.root),
-      cwd: io.cwd,
-      css: options.css ? resolve2(io.cwd, options.css) : null
-    });
-    const written = await sendOrRefuse(cli, io, finish, command);
-    if (!written) return;
-    io.out(`wrote ${written.path}: ${written.colours} colours, ${written.from}`);
-    finish(0);
+  program2.command("tokens").description("write the code's tokens to tokens.json, from the design system zaku.yaml names").option("--css <path>", "the stylesheet that declares :root and .dark (shadcn), over designSystem.shadcn.css").option(...CONFIG_OPTION).option(...PRODUCT_OPTION).action(async (options) => {
+    const workspace = await workspaceOf(io, options);
+    onlyWithOne(workspace, "zaku tokens", "--css", options.css);
+    finish(
+      await forEachProduct(io, workspace, async ({ root, config: config2 }) => {
+        const named = "shadcn" in config2.designSystem ? config2.designSystem.shadcn.css : void 0;
+        const css = options.css ? resolve3(io.cwd, options.css) : named !== void 0 ? resolve3(workspace.dir, named) : null;
+        const command = new WriteTokens({ root, config: config2, cwd: workspace.dir, css });
+        const written = await cli.bus.send(command);
+        io.out(`wrote ${written.path}: ${written.colours} colours, ${written.from}`);
+        return 0;
+      })
+    );
   });
 };
 var recipeCommand = (program2, io, finish, cli) => {
-  program2.command("recipe").description("write what the code computes for every variant to recipe.json, from the product's recipe page").option("--url <url>", "the recipe page, when it is not zaku.yaml's recipe.url").option("--root <dir>", "the design directory", "docs/design").action(async (options) => {
-    const command = new WriteRecipe({
-      root: resolve2(io.cwd, options.root),
-      url: options.url ?? null
-    });
-    const written = await sendOrRefuse(cli, io, finish, command);
-    if (!written) return;
-    io.out(
-      `wrote ${written.path}: ${written.components} components, ${written.variants} variants, in light and dark`
+  program2.command("recipe").description("write what the code computes for every variant to recipe.json, from the product's recipe page").option("--url <url>", "the recipe page, when it is not zaku.yaml's recipe.url").option(...CONFIG_OPTION).option(...PRODUCT_OPTION).action(async (options) => {
+    const workspace = await workspaceOf(io, options);
+    onlyWithOne(workspace, "zaku recipe", "--url", options.url);
+    finish(
+      await forEachProduct(io, workspace, async ({ root, config: config2 }) => {
+        const command = new WriteRecipe({ root, config: config2, url: options.url ?? null });
+        const written = await cli.bus.send(command);
+        io.out(
+          `wrote ${written.path}: ${written.components} components, ${written.variants} variants, in light and dark`
+        );
+        return 0;
+      })
     );
-    finish(0);
   });
 };
 var clock = { now: () => /* @__PURE__ */ new Date() };
@@ -59621,10 +60050,21 @@ var budgetCommand = (program2, io, finish, cli) => {
     await cli.bus.send(new RecordBudgetCalls({ day, seat, run, kind: options.kind, count: options.count }));
     finish(0);
   });
-  budget.command("status").description("exit 4 when the budget refuses another MCP call").option("--root <dir>", "the design directory", "docs/design").action(async (options) => {
+  budget.command("status").description("exit 4 when the budget refuses another MCP call").option(...CONFIG_OPTION).action(async (options) => {
     const { path: path2, seat, run, day } = ledger();
-    const config2 = await readOptionalDesignFile(designPaths(resolve2(io.cwd, options.root)).config, zakuConfigSchema);
-    const allowance = mcpAllowance(await readLedger(path2, day), seat, run, config2?.budget ?? budgetSchema.parse({}));
+    let budgets;
+    try {
+      const workspace = await workspaceOf(io, options.config === void 0 ? {} : { config: options.config });
+      budgets = workspace.products.map(
+        (product) => "refusal" in product ? workspace.budget : product.config.budget
+      );
+    } catch (error62) {
+      if (!(error62 instanceof WorkspaceConfigMissing) || options.config !== void 0) throw error62;
+      budgets = [budgetSchema.parse({})];
+    }
+    const read = await readLedger(path2, day);
+    const allowances = budgets.map((budget2) => mcpAllowance(read, seat, run, budget2));
+    const allowance = allowances.reduce((chosen, each) => chosen.ok && !each.ok ? each : chosen);
     io.out(
       `mcp ${allowance.usedToday} today, ${allowance.usedThisRun} this run${allowance.reason ? `: ${allowance.reason}` : ""}`
     );
@@ -59632,8 +60072,7 @@ var budgetCommand = (program2, io, finish, cli) => {
   });
 };
 var outlineCommand = (program2, io, finish, cli) => {
-  program2.command("outline").description("read the product file's frames into docs/design/outline").option("--root <dir>", "the design directory", "docs/design").option("--frames <ids>", "only these frame ids, comma separated").action(async (options) => {
-    const root = resolve2(io.cwd, options.root);
+  program2.command("outline").description("read each product file's frames into its design's outline/").option(...CONFIG_OPTION).option(...PRODUCT_OPTION).option("--frames <ids>", "only these frame ids, comma separated").action(async (options) => {
     const report = (summary) => io.out(
       summary.skipped ? "outline is current; nothing read" : `read ${summary.read} frames, wrote ${summary.written.length} outlines, ${summary.unmapped} unmapped`
     );
@@ -59643,9 +60082,15 @@ var outlineCommand = (program2, io, finish, cli) => {
       return;
     }
     try {
+      const workspace = await workspaceOf(io, options);
+      onlyWithOne(workspace, "zaku outline", "--frames", options.frames);
       const frames = options.frames ? options.frames.split(",") : null;
-      report(await cli.bus.send(new WriteOutline({ root, frames })));
-      finish(0);
+      finish(
+        await forEachProduct(io, workspace, async ({ root, config: config2 }) => {
+          report(await cli.bus.send(new WriteOutline({ root, config: config2, frames })));
+          return 0;
+        })
+      );
     } finally {
       await recordRestCalls(cli, io);
     }
@@ -59653,8 +60098,8 @@ var outlineCommand = (program2, io, finish, cli) => {
 };
 var libraryCommand = (program2, io, finish, cli) => {
   const library = program2.command("library").description("snapshot the library's components and tokens");
-  library.command("script").description("print the Plugin API code that exports the library variables, for use_figma").option("--root <dir>", "the design directory", "docs/design").option("--local", "also list the file's own components, for a library in the product file").option("--page <name>", "with --local, list only this page; one use_figma call per page").action(async (options) => {
-    const config2 = await readDesignFile(designPaths(resolve2(io.cwd, options.root)).config, zakuConfigSchema);
+  library.command("script").description("print the Plugin API code that exports the library variables, for use_figma").option(...CONFIG_OPTION).option(...PRODUCT_OPTION).option("--local", "also list the file's own components, for a library in the product file").option("--page <name>", "with --local, list only this page; one use_figma call per page").action(async (options) => {
+    const { config: config2 } = oneProduct(await workspaceOf(io, options), "zaku library script");
     io.out(
       libraryExportScript({
         combos: [config2.modes],
@@ -59686,23 +60131,13 @@ var libraryCommand = (program2, io, finish, cli) => {
   );
   library.command("save").description(
     "write a library's snapshot from its components over Figma REST, joined to the variables export, or a kit's published components"
-  ).option("--root <dir>", "the design directory", "docs/design").option("--key <key>", "the library or kit to save, as zaku.yaml lists it; needed when it lists several").option(
+  ).option(...CONFIG_OPTION).option(...PRODUCT_OPTION).option("--key <key>", "the library or kit to save, as zaku.yaml lists it; needed when it lists several").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]
   ).action(async (options) => {
-    const root = resolve2(io.cwd, options.root);
-    const config2 = await readDesignFile(designPaths(root).config, zakuConfigSchema);
-    let target;
-    try {
-      target = librarySaveTarget(config2, options.key);
-    } catch (error62) {
-      const refusal = refusalOf(error62);
-      if (!refusal) throw error62;
-      io.err(refusal.line);
-      finish(refusal.code);
-      return;
-    }
+    const { root, config: config2 } = oneProduct(await workspaceOf(io, options), "zaku library save");
+    const target = librarySaveTarget(config2, options.key);
     if (target.kind === "library" && (!options.input || options.input.length === 0)) {
       io.err("zaku library save needs --input, the variables use_figma returned for zaku library script");
       finish(3);
@@ -59716,7 +60151,7 @@ var libraryCommand = (program2, io, finish, cli) => {
     const part = target.kind === "library" ? mergeParts(
       await Promise.all(
         (options.input ?? []).map(
-          async (input2) => parseDesignFile(input2, await readFile6(resolve2(io.cwd, input2), "utf8"), variablePartSchema)
+          async (input2) => parseDesignFile(input2, await readFile7(resolve3(io.cwd, input2), "utf8"), variablePartSchema)
         )
       )
     ) : void 0;
@@ -59724,6 +60159,7 @@ var libraryCommand = (program2, io, finish, cli) => {
       const saved = await cli.bus.send(
         new SaveLibrary({
           root,
+          config: config2,
           ...options.key !== void 0 ? { key: options.key } : {},
           ...part ? { part } : {}
         })
@@ -59752,13 +60188,13 @@ var libraryCommand = (program2, io, finish, cli) => {
 };
 var rulesCommand = (program2, io, finish) => {
   const rules = program2.command("rules").description("zaku's rule checks, for a run that reaches Figma through use_figma");
-  rules.command("script").description("print the Plugin API code that runs the rules over a page or a node, for use_figma").option("--root <dir>", "the design directory", "docs/design").option("--page <page>", "the page to check, by id or name").option("--node <id>", "the node to check, with everything inside it").option("--after <write.js>", "run this use_figma write first, then the rules, and answer both").option("--key <key>", "the library file the page is in, so its views are held to the branches it holds").action(async (options) => {
+  rules.command("script").description("print the Plugin API code that runs the rules over a page or a node, for use_figma").option(...CONFIG_OPTION).option(...PRODUCT_OPTION).option("--page <page>", "the page to check, by id or name").option("--node <id>", "the node to check, with everything inside it").option("--after <write.js>", "run this use_figma write first, then the rules, and answer both").option("--key <key>", "the library file the page is in, so its views are held to the branches it holds").action(async (options) => {
     if (options.page === void 0 === (options.node === void 0)) {
       io.err("zaku rules script needs --page or --node, one of them");
       finish(3);
       return;
     }
-    const config2 = await readDesignFile(designPaths(resolve2(io.cwd, options.root)).config, zakuConfigSchema);
+    const { config: config2 } = oneProduct(await workspaceOf(io, options), "zaku rules script");
     const scope = options.node !== void 0 ? { nodeId: options.node } : { page: options.page };
     const graph = designGraph(config2);
     const file2 = options.key === void 0 ? graph.libraries.length === 1 ? graph.libraries[0] : void 0 : graph.libraries.find((library2) => library2.key === options.key);
@@ -59778,7 +60214,7 @@ return ${check2};`);
       finish(0);
       return;
     }
-    const write2 = await readFile6(resolve2(io.cwd, options.after), "utf8");
+    const write2 = await readFile7(resolve3(io.cwd, options.after), "utf8");
     const body = [
       library,
       `const zakuWrite = async () => {
@@ -59810,6 +60246,7 @@ var COMMANDS = [
   budgetCommand,
   schemaCommand,
   librariesCommand,
+  productsCommand,
   mcpCommand
 ];
 async function main(argv, io) {
@@ -59846,6 +60283,11 @@ async function main(argv, io) {
       io.err(USAGE);
       return 3;
     }
+    const refusal = refusalOf(error62);
+    if (refusal) {
+      io.err(refusal.line);
+      return refusal.code;
+    }
     io.err(`zaku: ${error62 instanceof Error ? error62.message : String(error62)}`);
     return 1;
   }