@three-flatland/bake 0.1.0-alpha.1 → 0.1.0-alpha.2

package/README.md

@@ -123,7 +123,7 @@ Not a dev-iteration knob — the default path (probe → generate on miss + warn
 
 ## Documentation
 
-Full docs, interactive examples, and API reference at **[thejustinwalsh.com/three-flatland](https://thejustinwalsh.com/three-flatland/)**
+Full docs, interactive examples, and API reference at **[tjw.dev/three-flatland](https://tjw.dev/three-flatland/)**
 
 ## License
 

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';

package/dist/cli.js

@@ -1,8 +1,20 @@
 #!/usr/bin/env node
+import "node:path";
+import "node:url";
+import.meta.url;
+import { discoverBakers } from "./discovery.js";
 import { pathToFileURL } from "node:url";
 import { existsSync } from "node:fs";
-import { discoverBakers } from "./discovery.js";
-const USAGE = `flatland-bake \u2014 unified bake entry point
+//#region src/cli.ts
+/**
+* `flatland-bake` — the unified bake entry point. Discovers bakers
+* contributed by installed packages (via a `flatland.bake` field in
+* their package.json), then dispatches `flatland-bake <name> [args]` to
+* the matching baker's `run()`. `--list` enumerates available bakers and
+* `--help` prints usage. See {@link discoverBakers} and the {@link Baker}
+* contract for how a package registers a subcommand.
+*/
+const USAGE = `flatland-bake — unified bake entry point
 
 Usage:
   flatland-bake <name> [args...]    Run a registered baker
@@ -13,80 +25,58 @@ Bakers are contributed by packages via a \`flatland.bake\` field in
 package.json. Install a package that provides one (e.g. @three-flatland/slug)
 and its subcommand will appear in --list.`;
 async function main(argv) {
-  const [first, ...rest] = argv;
-  if (!first || first === "--help" || first === "-h") {
-    process.stdout.write(USAGE + "\n");
-    return 0;
-  }
-  const { bakers, conflicts } = discoverBakers();
-  for (const warning of conflicts) {
-    process.stderr.write(`[flatland-bake] warn: ${warning}
-`);
-  }
-  if (first === "--list") {
-    return printList(bakers);
-  }
-  const match = bakers.find((b) => b.name === first);
-  if (!match) {
-    process.stderr.write(
-      `[flatland-bake] unknown baker "${first}". Run \`flatland-bake --list\` to see what's available.
-`
-    );
-    return 1;
-  }
-  const baker = await loadBaker(match);
-  if (!baker) return 1;
-  try {
-    return await baker.run(rest);
-  } catch (err) {
-    process.stderr.write(
-      `[flatland-bake] baker "${match.name}" threw: ${err instanceof Error ? err.message : String(err)}
-`
-    );
-    return 1;
-  }
+	const [first, ...rest] = argv;
+	if (!first || first === "--help" || first === "-h") {
+		process.stdout.write(USAGE + "\n");
+		return 0;
+	}
+	const { bakers, conflicts } = discoverBakers();
+	for (const warning of conflicts) process.stderr.write(`[flatland-bake] warn: ${warning}\n`);
+	if (first === "--list") return printList(bakers);
+	const match = bakers.find((b) => b.name === first);
+	if (!match) {
+		process.stderr.write(`[flatland-bake] unknown baker "${first}". Run \`flatland-bake --list\` to see what's available.\n`);
+		return 1;
+	}
+	const baker = await loadBaker(match);
+	if (!baker) return 1;
+	try {
+		return await baker.run(rest);
+	} catch (err) {
+		process.stderr.write(`[flatland-bake] baker "${match.name}" threw: ${err instanceof Error ? err.message : String(err)}\n`);
+		return 1;
+	}
 }
 function printList(bakers) {
-  if (bakers.length === 0) {
-    process.stdout.write(
-      "No bakers registered. Install a package that contributes one (e.g. @three-flatland/slug).\n"
-    );
-    return 0;
-  }
-  const nameWidth = Math.max(...bakers.map((b) => b.name.length));
-  process.stdout.write("Registered bakers:\n");
-  for (const b of bakers) {
-    const pad = " ".repeat(nameWidth - b.name.length);
-    process.stdout.write(`  ${b.name}${pad}  ${b.description}  (${b.packageName})
-`);
-  }
-  return 0;
+	if (bakers.length === 0) {
+		process.stdout.write("No bakers registered. Install a package that contributes one (e.g. @three-flatland/slug).\n");
+		return 0;
+	}
+	const nameWidth = Math.max(...bakers.map((b) => b.name.length));
+	process.stdout.write("Registered bakers:\n");
+	for (const b of bakers) {
+		const pad = " ".repeat(nameWidth - b.name.length);
+		process.stdout.write(`  ${b.name}${pad}  ${b.description}  (${b.packageName})\n`);
+	}
+	return 0;
 }
 async function loadBaker(reg) {
-  if (!existsSync(reg.resolvedEntry)) {
-    process.stderr.write(
-      `[flatland-bake] baker "${reg.name}" from "${reg.packageName}" points to missing entry: ${reg.resolvedEntry}
-`
-    );
-    return null;
-  }
-  const mod = await import(pathToFileURL(reg.resolvedEntry).href);
-  const baker = mod.default;
-  if (!baker || typeof baker.run !== "function") {
-    process.stderr.write(
-      `[flatland-bake] baker "${reg.name}" from "${reg.packageName}" did not default-export a Baker.
-`
-    );
-    return null;
-  }
-  return baker;
+	if (!existsSync(reg.resolvedEntry)) {
+		process.stderr.write(`[flatland-bake] baker "${reg.name}" from "${reg.packageName}" points to missing entry: ${reg.resolvedEntry}\n`);
+		return null;
+	}
+	const baker = (await import(pathToFileURL(reg.resolvedEntry).href)).default;
+	if (!baker || typeof baker.run !== "function") {
+		process.stderr.write(`[flatland-bake] baker "${reg.name}" from "${reg.packageName}" did not default-export a Baker.\n`);
+		return null;
+	}
+	return baker;
 }
-main(process.argv.slice(2)).then(
-  (code) => process.exit(code),
-  (err) => {
-    process.stderr.write(`[flatland-bake] fatal: ${String(err)}
-`);
-    process.exit(1);
-  }
-);
+main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+	process.stderr.write(`[flatland-bake] fatal: ${String(err)}\n`);
+	process.exit(1);
+});
+//#endregion
+export {};
+
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `flatland-bake` — the unified bake entry point. Discovers bakers\n * contributed by installed packages (via a `flatland.bake` field in\n * their package.json), then dispatches `flatland-bake <name> [args]` to\n * the matching baker's `run()`. `--list` enumerates available bakers and\n * `--help` prints usage. See {@link discoverBakers} and the {@link Baker}\n * contract for how a package registers a subcommand.\n */\nimport { pathToFileURL } from 'node:url'\nimport { existsSync } from 'node:fs'\nimport { discoverBakers } from './discovery.js'\nimport type { Baker, BakerRegistration } from './types.js'\n\nconst USAGE = `flatland-bake — unified bake entry point\n\nUsage:\n  flatland-bake <name> [args...]    Run a registered baker\n  flatland-bake --list              List registered bakers\n  flatland-bake --help              Show this usage\n\nBakers are contributed by packages via a \\`flatland.bake\\` field in\npackage.json. Install a package that provides one (e.g. @three-flatland/slug)\nand its subcommand will appear in --list.`\n\nasync function main(argv: string[]): Promise<number> {\n  const [first, ...rest] = argv\n\n  if (!first || first === '--help' || first === '-h') {\n    process.stdout.write(USAGE + '\\n')\n    return 0\n  }\n\n  const { bakers, conflicts } = discoverBakers()\n  for (const warning of conflicts) {\n    process.stderr.write(`[flatland-bake] warn: ${warning}\\n`)\n  }\n\n  if (first === '--list') {\n    return printList(bakers)\n  }\n\n  const match = bakers.find((b) => b.name === first)\n  if (!match) {\n    process.stderr.write(\n      `[flatland-bake] unknown baker \"${first}\". Run \\`flatland-bake --list\\` to see what's available.\\n`\n    )\n    return 1\n  }\n\n  const baker = await loadBaker(match)\n  if (!baker) return 1\n\n  try {\n    return await baker.run(rest)\n  } catch (err) {\n    process.stderr.write(\n      `[flatland-bake] baker \"${match.name}\" threw: ${err instanceof Error ? err.message : String(err)}\\n`\n    )\n    return 1\n  }\n}\n\nfunction printList(bakers: BakerRegistration[]): number {\n  if (bakers.length === 0) {\n    process.stdout.write(\n      'No bakers registered. Install a package that contributes one (e.g. @three-flatland/slug).\\n'\n    )\n    return 0\n  }\n\n  const nameWidth = Math.max(...bakers.map((b) => b.name.length))\n  process.stdout.write('Registered bakers:\\n')\n  for (const b of bakers) {\n    const pad = ' '.repeat(nameWidth - b.name.length)\n    process.stdout.write(`  ${b.name}${pad}  ${b.description}  (${b.packageName})\\n`)\n  }\n  return 0\n}\n\nasync function loadBaker(reg: BakerRegistration): Promise<Baker | null> {\n  if (!existsSync(reg.resolvedEntry)) {\n    process.stderr.write(\n      `[flatland-bake] baker \"${reg.name}\" from \"${reg.packageName}\" points to missing entry: ${reg.resolvedEntry}\\n`\n    )\n    return null\n  }\n\n  const mod = (await import(pathToFileURL(reg.resolvedEntry).href)) as {\n    default?: Baker\n  }\n  const baker = mod.default\n  if (!baker || typeof baker.run !== 'function') {\n    process.stderr.write(\n      `[flatland-bake] baker \"${reg.name}\" from \"${reg.packageName}\" did not default-export a Baker.\\n`\n    )\n    return null\n  }\n  return baker\n}\n\nmain(process.argv.slice(2)).then(\n  (code) => process.exit(code),\n  (err) => {\n    process.stderr.write(`[flatland-bake] fatal: ${String(err)}\\n`)\n    process.exit(1)\n  }\n)\n"],"mappings":";AASA,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAC3B,SAAS,sBAAsB;AAG/B,MAAM,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAWd,eAAe,KAAK,MAAiC;AACnD,QAAM,CAAC,OAAO,GAAG,IAAI,IAAI;AAEzB,MAAI,CAAC,SAAS,UAAU,YAAY,UAAU,MAAM;AAClD,YAAQ,OAAO,MAAM,QAAQ,IAAI;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,QAAQ,UAAU,IAAI,eAAe;AAC7C,aAAW,WAAW,WAAW;AAC/B,YAAQ,OAAO,MAAM,yBAAyB,OAAO;AAAA,CAAI;AAAA,EAC3D;AAEA,MAAI,UAAU,UAAU;AACtB,WAAO,UAAU,MAAM;AAAA,EACzB;AAEA,QAAM,QAAQ,OAAO,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK;AACjD,MAAI,CAAC,OAAO;AACV,YAAQ,OAAO;AAAA,MACb,kCAAkC,KAAK;AAAA;AAAA,IACzC;AACA,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,MAAM,UAAU,KAAK;AACnC,MAAI,CAAC,MAAO,QAAO;AAEnB,MAAI;AACF,WAAO,MAAM,MAAM,IAAI,IAAI;AAAA,EAC7B,SAAS,KAAK;AACZ,YAAQ,OAAO;AAAA,MACb,0BAA0B,MAAM,IAAI,YAAY,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA;AAAA,IAClG;AACA,WAAO;AAAA,EACT;AACF;AAEA,SAAS,UAAU,QAAqC;AACtD,MAAI,OAAO,WAAW,GAAG;AACvB,YAAQ,OAAO;AAAA,MACb;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,KAAK,IAAI,GAAG,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,MAAM,CAAC;AAC9D,UAAQ,OAAO,MAAM,sBAAsB;AAC3C,aAAW,KAAK,QAAQ;AACtB,UAAM,MAAM,IAAI,OAAO,YAAY,EAAE,KAAK,MAAM;AAChD,YAAQ,OAAO,MAAM,KAAK,EAAE,IAAI,GAAG,GAAG,KAAK,EAAE,WAAW,MAAM,EAAE,WAAW;AAAA,CAAK;AAAA,EAClF;AACA,SAAO;AACT;AAEA,eAAe,UAAU,KAA+C;AACtE,MAAI,CAAC,WAAW,IAAI,aAAa,GAAG;AAClC,YAAQ,OAAO;AAAA,MACb,0BAA0B,IAAI,IAAI,WAAW,IAAI,WAAW,8BAA8B,IAAI,aAAa;AAAA;AAAA,IAC7G;AACA,WAAO;AAAA,EACT;AAEA,QAAM,MAAO,MAAM,OAAO,cAAc,IAAI,aAAa,EAAE;AAG3D,QAAM,QAAQ,IAAI;AAClB,MAAI,CAAC,SAAS,OAAO,MAAM,QAAQ,YAAY;AAC7C,YAAQ,OAAO;AAAA,MACb,0BAA0B,IAAI,IAAI,WAAW,IAAI,WAAW;AAAA;AAAA,IAC9D;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAC,EAAE;AAAA,EAC1B,CAAC,SAAS,QAAQ,KAAK,IAAI;AAAA,EAC3B,CAAC,QAAQ;AACP,YAAQ,OAAO,MAAM,0BAA0B,OAAO,GAAG,CAAC;AAAA,CAAI;AAC9D,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `flatland-bake` — the unified bake entry point. Discovers bakers\n * contributed by installed packages (via a `flatland.bake` field in\n * their package.json), then dispatches `flatland-bake <name> [args]` to\n * the matching baker's `run()`. `--list` enumerates available bakers and\n * `--help` prints usage. See {@link discoverBakers} and the {@link Baker}\n * contract for how a package registers a subcommand.\n */\nimport { pathToFileURL } from 'node:url'\nimport { existsSync } from 'node:fs'\nimport { discoverBakers } from './discovery.js'\nimport type { Baker, BakerRegistration } from './types.js'\n\nconst USAGE = `flatland-bake — unified bake entry point\n\nUsage:\n  flatland-bake <name> [args...]    Run a registered baker\n  flatland-bake --list              List registered bakers\n  flatland-bake --help              Show this usage\n\nBakers are contributed by packages via a \\`flatland.bake\\` field in\npackage.json. Install a package that provides one (e.g. @three-flatland/slug)\nand its subcommand will appear in --list.`\n\nasync function main(argv: string[]): Promise<number> {\n  const [first, ...rest] = argv\n\n  if (!first || first === '--help' || first === '-h') {\n    process.stdout.write(USAGE + '\\n')\n    return 0\n  }\n\n  const { bakers, conflicts } = discoverBakers()\n  for (const warning of conflicts) {\n    process.stderr.write(`[flatland-bake] warn: ${warning}\\n`)\n  }\n\n  if (first === '--list') {\n    return printList(bakers)\n  }\n\n  const match = bakers.find((b) => b.name === first)\n  if (!match) {\n    process.stderr.write(\n      `[flatland-bake] unknown baker \"${first}\". Run \\`flatland-bake --list\\` to see what's available.\\n`\n    )\n    return 1\n  }\n\n  const baker = await loadBaker(match)\n  if (!baker) return 1\n\n  try {\n    return await baker.run(rest)\n  } catch (err) {\n    process.stderr.write(\n      `[flatland-bake] baker \"${match.name}\" threw: ${err instanceof Error ? err.message : String(err)}\\n`\n    )\n    return 1\n  }\n}\n\nfunction printList(bakers: BakerRegistration[]): number {\n  if (bakers.length === 0) {\n    process.stdout.write('No bakers registered. Install a package that contributes one (e.g. @three-flatland/slug).\\n')\n    return 0\n  }\n\n  const nameWidth = Math.max(...bakers.map((b) => b.name.length))\n  process.stdout.write('Registered bakers:\\n')\n  for (const b of bakers) {\n    const pad = ' '.repeat(nameWidth - b.name.length)\n    process.stdout.write(`  ${b.name}${pad}  ${b.description}  (${b.packageName})\\n`)\n  }\n  return 0\n}\n\nasync function loadBaker(reg: BakerRegistration): Promise<Baker | null> {\n  if (!existsSync(reg.resolvedEntry)) {\n    process.stderr.write(\n      `[flatland-bake] baker \"${reg.name}\" from \"${reg.packageName}\" points to missing entry: ${reg.resolvedEntry}\\n`\n    )\n    return null\n  }\n\n  const mod = (await import(pathToFileURL(reg.resolvedEntry).href)) as {\n    default?: Baker\n  }\n  const baker = mod.default\n  if (!baker || typeof baker.run !== 'function') {\n    process.stderr.write(\n      `[flatland-bake] baker \"${reg.name}\" from \"${reg.packageName}\" did not default-export a Baker.\\n`\n    )\n    return null\n  }\n  return baker\n}\n\nmain(process.argv.slice(2)).then(\n  (code) => process.exit(code),\n  (err) => {\n    process.stderr.write(`[flatland-bake] fatal: ${String(err)}\\n`)\n    process.exit(1)\n  }\n)\n"],"mappings":";;;;;;;;;;;;;;;;AAcA,MAAM,QAAQ;;;;;;;;;;AAWd,eAAe,KAAK,MAAiC;CACnD,MAAM,CAAC,OAAO,GAAG,QAAQ;CAEzB,IAAI,CAAC,SAAS,UAAU,YAAY,UAAU,MAAM;EAClD,QAAQ,OAAO,MAAM,QAAQ,IAAI;EACjC,OAAO;CACT;CAEA,MAAM,EAAE,QAAQ,cAAc,eAAe;CAC7C,KAAK,MAAM,WAAW,WACpB,QAAQ,OAAO,MAAM,yBAAyB,QAAQ,GAAG;CAG3D,IAAI,UAAU,UACZ,OAAO,UAAU,MAAM;CAGzB,MAAM,QAAQ,OAAO,MAAM,MAAM,EAAE,SAAS,KAAK;CACjD,IAAI,CAAC,OAAO;EACV,QAAQ,OAAO,MACb,kCAAkC,MAAM,2DAC1C;EACA,OAAO;CACT;CAEA,MAAM,QAAQ,MAAM,UAAU,KAAK;CACnC,IAAI,CAAC,OAAO,OAAO;CAEnB,IAAI;EACF,OAAO,MAAM,MAAM,IAAI,IAAI;CAC7B,SAAS,KAAK;EACZ,QAAQ,OAAO,MACb,0BAA0B,MAAM,KAAK,WAAW,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,EAAE,GACnG;EACA,OAAO;CACT;AACF;AAEA,SAAS,UAAU,QAAqC;CACtD,IAAI,OAAO,WAAW,GAAG;EACvB,QAAQ,OAAO,MAAM,6FAA6F;EAClH,OAAO;CACT;CAEA,MAAM,YAAY,KAAK,IAAI,GAAG,OAAO,KAAK,MAAM,EAAE,KAAK,MAAM,CAAC;CAC9D,QAAQ,OAAO,MAAM,sBAAsB;CAC3C,KAAK,MAAM,KAAK,QAAQ;EACtB,MAAM,MAAM,IAAI,OAAO,YAAY,EAAE,KAAK,MAAM;EAChD,QAAQ,OAAO,MAAM,KAAK,EAAE,OAAO,IAAI,IAAI,EAAE,YAAY,KAAK,EAAE,YAAY,IAAI;CAClF;CACA,OAAO;AACT;AAEA,eAAe,UAAU,KAA+C;CACtE,IAAI,CAAC,WAAW,IAAI,aAAa,GAAG;EAClC,QAAQ,OAAO,MACb,0BAA0B,IAAI,KAAK,UAAU,IAAI,YAAY,6BAA6B,IAAI,cAAc,GAC9G;EACA,OAAO;CACT;CAKA,MAAM,SAAQ,MAHK,OAAO,cAAc,IAAI,aAAa,CAAC,CAAC,MAAA,CAGzC;CAClB,IAAI,CAAC,SAAS,OAAO,MAAM,QAAQ,YAAY;EAC7C,QAAQ,OAAO,MACb,0BAA0B,IAAI,KAAK,UAAU,IAAI,YAAY,oCAC/D;EACA,OAAO;CACT;CACA,OAAO;AACT;AAEA,KAAK,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,MACzB,SAAS,QAAQ,KAAK,IAAI,IAC1B,QAAQ;CACP,QAAQ,OAAO,MAAM,0BAA0B,OAAO,GAAG,EAAE,GAAG;CAC9D,QAAQ,KAAK,CAAC;AAChB,CACF"}

package/dist/devtimeWarn.d.ts

@@ -0,0 +1,20 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region src/devtimeWarn.d.ts
+/**
+ * Emit a console warning gated on `NODE_ENV !== 'production'`. Deduped
+ * per `(category, url)` — the same warning never fires twice.
+ *
+ * Shared by every sidecar-using loader so warnings surface uniformly
+ * across the ecosystem (normals, fonts, atlases, …).
+ *
+ * @param category short tag identifying what system warned (e.g. 'normal')
+ * @param url      absolute URL or path of the asset
+ * @param message  the message shown to the user
+ */
+declare function devtimeWarn(category: string, url: string, message: string): void;
+/** Clear the devtime-warning dedupe cache. Intended for tests. */
+declare function _resetDevtimeWarnings(): void;
+//#endregion
+export { _resetDevtimeWarnings, devtimeWarn };
+//# sourceMappingURL=devtimeWarn.d.ts.map

package/dist/devtimeWarn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtimeWarn.d.ts","names":[],"sources":["../src/devtimeWarn.ts"],"mappings":";;;;;;;;;;;;;;iBAagB,YAAY,kBAAkB,aAAa;;iBAa3C"}

package/dist/devtimeWarn.js

@@ -1,24 +1,44 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+//#region src/devtimeWarn.ts
 const _warned = /* @__PURE__ */ new Map();
+/**
+* Emit a console warning gated on `NODE_ENV !== 'production'`. Deduped
+* per `(category, url)` — the same warning never fires twice.
+*
+* Shared by every sidecar-using loader so warnings surface uniformly
+* across the ecosystem (normals, fonts, atlases, …).
+*
+* @param category short tag identifying what system warned (e.g. 'normal')
+* @param url      absolute URL or path of the asset
+* @param message  the message shown to the user
+*/
 function devtimeWarn(category, url, message) {
-  if (isProduction()) return;
-  let set = _warned.get(category);
-  if (!set) {
-    set = /* @__PURE__ */ new Set();
-    _warned.set(category, set);
-  }
-  if (set.has(url)) return;
-  set.add(url);
-  console.warn(`[${category}] ${message}`);
+	if (isProduction()) return;
+	let set = _warned.get(category);
+	if (!set) {
+		set = /* @__PURE__ */ new Set();
+		_warned.set(category, set);
+	}
+	if (set.has(url)) return;
+	set.add(url);
+	console.warn(`[${category}] ${message}`);
 }
+/** Clear the devtime-warning dedupe cache. Intended for tests. */
 function _resetDevtimeWarnings() {
-  _warned.clear();
+	_warned.clear();
 }
+/**
+* Type-agnostic NODE_ENV check. Reads `globalThis.process.env.NODE_ENV`
+* without forcing consumers to depend on `@types/node` — browser-only
+* packages (e.g. mini-breakout, example apps) inline-consume this
+* module through the source export and would otherwise hit TS2591.
+*/
 function isProduction() {
-  const proc = globalThis.process;
-  return proc?.env?.["NODE_ENV"] === "production";
+	return globalThis.process?.env?.["NODE_ENV"] === "production";
 }
-export {
-  _resetDevtimeWarnings,
-  devtimeWarn
-};
+//#endregion
+export { _resetDevtimeWarnings, devtimeWarn };
+
 //# sourceMappingURL=devtimeWarn.js.map

package/dist/devtimeWarn.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/devtimeWarn.ts"],"sourcesContent":["const _warned = new Map<string, Set<string>>()\n\n/**\n * Emit a console warning gated on `NODE_ENV !== 'production'`. Deduped\n * per `(category, url)` — the same warning never fires twice.\n *\n * Shared by every sidecar-using loader so warnings surface uniformly\n * across the ecosystem (normals, fonts, atlases, …).\n *\n * @param category short tag identifying what system warned (e.g. 'normal')\n * @param url      absolute URL or path of the asset\n * @param message  the message shown to the user\n */\nexport function devtimeWarn(category: string, url: string, message: string): void {\n  if (isProduction()) return\n  let set = _warned.get(category)\n  if (!set) {\n    set = new Set()\n    _warned.set(category, set)\n  }\n  if (set.has(url)) return\n  set.add(url)\n  console.warn(`[${category}] ${message}`)\n}\n\n/** Clear the devtime-warning dedupe cache. Intended for tests. */\nexport function _resetDevtimeWarnings(): void {\n  _warned.clear()\n}\n\n/**\n * Type-agnostic NODE_ENV check. Reads `globalThis.process.env.NODE_ENV`\n * without forcing consumers to depend on `@types/node` — browser-only\n * packages (e.g. mini-breakout, example apps) inline-consume this\n * module through the source export and would otherwise hit TS2591.\n */\nfunction isProduction(): boolean {\n  const proc = (globalThis as { process?: { env?: Record<string, string | undefined> } }).process\n  return proc?.env?.['NODE_ENV'] === 'production'\n}\n"],"mappings":"AAAA,MAAM,UAAU,oBAAI,IAAyB;AAatC,SAAS,YAAY,UAAkB,KAAa,SAAuB;AAChF,MAAI,aAAa,EAAG;AACpB,MAAI,MAAM,QAAQ,IAAI,QAAQ;AAC9B,MAAI,CAAC,KAAK;AACR,UAAM,oBAAI,IAAI;AACd,YAAQ,IAAI,UAAU,GAAG;AAAA,EAC3B;AACA,MAAI,IAAI,IAAI,GAAG,EAAG;AAClB,MAAI,IAAI,GAAG;AACX,UAAQ,KAAK,IAAI,QAAQ,KAAK,OAAO,EAAE;AACzC;AAGO,SAAS,wBAA8B;AAC5C,UAAQ,MAAM;AAChB;AAQA,SAAS,eAAwB;AAC/B,QAAM,OAAQ,WAA0E;AACxF,SAAO,MAAM,MAAM,UAAU,MAAM;AACrC;","names":[]}
+{"version":3,"file":"devtimeWarn.js","names":[],"sources":["../src/devtimeWarn.ts"],"sourcesContent":["const _warned = new Map<string, Set<string>>()\n\n/**\n * Emit a console warning gated on `NODE_ENV !== 'production'`. Deduped\n * per `(category, url)` — the same warning never fires twice.\n *\n * Shared by every sidecar-using loader so warnings surface uniformly\n * across the ecosystem (normals, fonts, atlases, …).\n *\n * @param category short tag identifying what system warned (e.g. 'normal')\n * @param url      absolute URL or path of the asset\n * @param message  the message shown to the user\n */\nexport function devtimeWarn(category: string, url: string, message: string): void {\n  if (isProduction()) return\n  let set = _warned.get(category)\n  if (!set) {\n    set = new Set()\n    _warned.set(category, set)\n  }\n  if (set.has(url)) return\n  set.add(url)\n  console.warn(`[${category}] ${message}`)\n}\n\n/** Clear the devtime-warning dedupe cache. Intended for tests. */\nexport function _resetDevtimeWarnings(): void {\n  _warned.clear()\n}\n\n/**\n * Type-agnostic NODE_ENV check. Reads `globalThis.process.env.NODE_ENV`\n * without forcing consumers to depend on `@types/node` — browser-only\n * packages (e.g. mini-breakout, example apps) inline-consume this\n * module through the source export and would otherwise hit TS2591.\n */\nfunction isProduction(): boolean {\n  const proc = (globalThis as { process?: { env?: Record<string, string | undefined> } }).process\n  return proc?.env?.['NODE_ENV'] === 'production'\n}\n"],"mappings":";;;;AAAA,MAAM,0BAAU,IAAI,IAAyB;;;;;;;;;;;;AAa7C,SAAgB,YAAY,UAAkB,KAAa,SAAuB;CAChF,IAAI,aAAa,GAAG;CACpB,IAAI,MAAM,QAAQ,IAAI,QAAQ;CAC9B,IAAI,CAAC,KAAK;EACR,sBAAM,IAAI,IAAI;EACd,QAAQ,IAAI,UAAU,GAAG;CAC3B;CACA,IAAI,IAAI,IAAI,GAAG,GAAG;CAClB,IAAI,IAAI,GAAG;CACX,QAAQ,KAAK,IAAI,SAAS,IAAI,SAAS;AACzC;;AAGA,SAAgB,wBAA8B;CAC5C,QAAQ,MAAM;AAChB;;;;;;;AAQA,SAAS,eAAwB;CAE/B,OADc,WAA0E,SAC3E,MAAM,gBAAgB;AACrC"}

package/dist/discovery.d.ts

@@ -0,0 +1,21 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { BakerRegistration } from "./types.js";
+//#region src/discovery.d.ts
+/**
+ * Discover registered bakers by walking `node_modules` near the current
+ * working directory. Supports both flat and pnpm-symlinked layouts: every
+ * `package.json` that declares a `flatland.bake` (or legacy
+ * `flatland.bakers`) field is picked up.
+ *
+ * Conflicts (multiple packages registering the same baker name) are reported;
+ * the first match wins and the rest are returned as warnings so the caller
+ * can decide whether to fail or log.
+ */
+declare function discoverBakers(cwd?: string): {
+  bakers: BakerRegistration[];
+  conflicts: string[];
+};
+//#endregion
+export { discoverBakers };
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","names":[],"sources":["../src/discovery.ts"],"mappings":";;;;;;;;;;;;;;iBAmBgB,eAAe;EAC7B,QAAQ;EACR"}

package/dist/discovery.js

@@ -1,111 +1,119 @@
-import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
-import { resolve, join } from "node:path";
+import "node:path";
+import "node:url";
+import.meta.url;
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+//#region src/discovery.ts
+/**
+* Discover registered bakers by walking `node_modules` near the current
+* working directory. Supports both flat and pnpm-symlinked layouts: every
+* `package.json` that declares a `flatland.bake` (or legacy
+* `flatland.bakers`) field is picked up.
+*
+* Conflicts (multiple packages registering the same baker name) are reported;
+* the first match wins and the rest are returned as warnings so the caller
+* can decide whether to fail or log.
+*/
 function discoverBakers(cwd = process.cwd()) {
-  const seenPackages = /* @__PURE__ */ new Set();
-  const bakers = /* @__PURE__ */ new Map();
-  const conflicts = [];
-  const selfDir = findPackageRoot(cwd);
-  if (selfDir) {
-    readPackage(selfDir, bakers, conflicts, seenPackages);
-  }
-  for (const nodeModulesDir of findNodeModulesDirs(cwd)) {
-    scanNodeModules(nodeModulesDir, bakers, conflicts, seenPackages);
-  }
-  return { bakers: Array.from(bakers.values()), conflicts };
+	const seenPackages = /* @__PURE__ */ new Set();
+	const bakers = /* @__PURE__ */ new Map();
+	const conflicts = [];
+	const selfDir = findPackageRoot(cwd);
+	if (selfDir) readPackage(selfDir, bakers, conflicts, seenPackages);
+	for (const nodeModulesDir of findNodeModulesDirs(cwd)) scanNodeModules(nodeModulesDir, bakers, conflicts, seenPackages);
+	return {
+		bakers: Array.from(bakers.values()),
+		conflicts
+	};
 }
+/** Walk upward from `start` until a directory with package.json is found. */
 function findPackageRoot(start) {
-  let dir = resolve(start);
-  while (true) {
-    if (existsSync(join(dir, "package.json"))) return dir;
-    const parent = resolve(dir, "..");
-    if (parent === dir) return null;
-    dir = parent;
-  }
+	let dir = resolve(start);
+	while (true) {
+		if (existsSync(join(dir, "package.json"))) return dir;
+		const parent = resolve(dir, "..");
+		if (parent === dir) return null;
+		dir = parent;
+	}
 }
+/** Walk upward from `cwd` collecting each `node_modules` directory we find. */
 function findNodeModulesDirs(cwd) {
-  const dirs = [];
-  let dir = resolve(cwd);
-  while (true) {
-    const nm = join(dir, "node_modules");
-    if (existsSync(nm) && statSync(nm).isDirectory()) {
-      dirs.push(nm);
-    }
-    const parent = resolve(dir, "..");
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return dirs;
+	const dirs = [];
+	let dir = resolve(cwd);
+	while (true) {
+		const nm = join(dir, "node_modules");
+		if (existsSync(nm) && statSync(nm).isDirectory()) dirs.push(nm);
+		const parent = resolve(dir, "..");
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return dirs;
 }
 function scanNodeModules(nodeModulesDir, bakers, conflicts, seenPackages) {
-  let entries;
-  try {
-    entries = readdirSync(nodeModulesDir);
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    if (entry.startsWith(".")) continue;
-    const entryPath = join(nodeModulesDir, entry);
-    if (entry.startsWith("@")) {
-      let scoped;
-      try {
-        scoped = readdirSync(entryPath);
-      } catch {
-        continue;
-      }
-      for (const scopedName of scoped) {
-        readPackage(join(entryPath, scopedName), bakers, conflicts, seenPackages);
-      }
-    } else {
-      readPackage(entryPath, bakers, conflicts, seenPackages);
-    }
-  }
+	let entries;
+	try {
+		entries = readdirSync(nodeModulesDir);
+	} catch {
+		return;
+	}
+	for (const entry of entries) {
+		if (entry.startsWith(".")) continue;
+		const entryPath = join(nodeModulesDir, entry);
+		if (entry.startsWith("@")) {
+			let scoped;
+			try {
+				scoped = readdirSync(entryPath);
+			} catch {
+				continue;
+			}
+			for (const scopedName of scoped) readPackage(join(entryPath, scopedName), bakers, conflicts, seenPackages);
+		} else readPackage(entryPath, bakers, conflicts, seenPackages);
+	}
 }
 function readPackage(packageDir, bakers, conflicts, seenPackages) {
-  const pkgPath = join(packageDir, "package.json");
-  if (!existsSync(pkgPath)) return;
-  let pkg;
-  try {
-    pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-  } catch {
-    return;
-  }
-  const name = pkg.name ?? packageDir;
-  if (seenPackages.has(name)) return;
-  seenPackages.add(name);
-  const manifest = resolveManifest(pkg.flatland, name, conflicts);
-  if (!manifest || manifest.length === 0) return;
-  for (const decl of manifest) {
-    const resolvedEntry = resolve(packageDir, decl.entry);
-    const registration = {
-      name: decl.name,
-      description: decl.description,
-      entry: decl.entry,
-      packageName: name,
-      resolvedEntry
-    };
-    const existing = bakers.get(decl.name);
-    if (existing) {
-      conflicts.push(
-        `baker "${decl.name}" is registered by both "${existing.packageName}" and "${name}" \u2014 using "${existing.packageName}"`
-      );
-      continue;
-    }
-    bakers.set(decl.name, registration);
-  }
+	const pkgPath = join(packageDir, "package.json");
+	if (!existsSync(pkgPath)) return;
+	let pkg;
+	try {
+		pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+	} catch {
+		return;
+	}
+	const name = pkg.name ?? packageDir;
+	if (seenPackages.has(name)) return;
+	seenPackages.add(name);
+	const manifest = resolveManifest(pkg.flatland, name, conflicts);
+	if (!manifest || manifest.length === 0) return;
+	for (const decl of manifest) {
+		const resolvedEntry = resolve(packageDir, decl.entry);
+		const registration = {
+			name: decl.name,
+			description: decl.description,
+			entry: decl.entry,
+			packageName: name,
+			resolvedEntry
+		};
+		const existing = bakers.get(decl.name);
+		if (existing) {
+			conflicts.push(`baker "${decl.name}" is registered by both "${existing.packageName}" and "${name}" — using "${existing.packageName}"`);
+			continue;
+		}
+		bakers.set(decl.name, registration);
+	}
 }
+/**
+* Prefer `flatland.bake` (current); fall back to `flatland.bakers`
+* (legacy) with a one-time deprecation warning per package.
+*/
 function resolveManifest(manifest, packageName, conflicts) {
-  if (!manifest) return void 0;
-  if (manifest.bake && manifest.bake.length > 0) return manifest.bake;
-  if (manifest.bakers && manifest.bakers.length > 0) {
-    conflicts.push(
-      `"${packageName}" uses deprecated \`flatland.bakers\` \u2014 rename to \`flatland.bake\` (the legacy key is accepted for one release)`
-    );
-    return manifest.bakers;
-  }
-  return void 0;
+	if (!manifest) return void 0;
+	if (manifest.bake && manifest.bake.length > 0) return manifest.bake;
+	if (manifest.bakers && manifest.bakers.length > 0) {
+		conflicts.push(`"${packageName}" uses deprecated \`flatland.bakers\` — rename to \`flatland.bake\` (the legacy key is accepted for one release)`);
+		return manifest.bakers;
+	}
 }
-export {
-  discoverBakers
-};
+//#endregion
+export { discoverBakers };
+
 //# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/discovery.ts"],"sourcesContent":["import { readFileSync, readdirSync, existsSync, statSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport type {\n  BakerRegistration,\n  FlatlandManifest,\n  FlatlandManifestEntry,\n} from './types.js'\n\ninterface PackageJson {\n  name?: string\n  flatland?: FlatlandManifest\n}\n\n/**\n * Discover registered bakers by walking `node_modules` near the current\n * working directory. Supports both flat and pnpm-symlinked layouts: every\n * `package.json` that declares a `flatland.bake` (or legacy\n * `flatland.bakers`) field is picked up.\n *\n * Conflicts (multiple packages registering the same baker name) are reported;\n * the first match wins and the rest are returned as warnings so the caller\n * can decide whether to fail or log.\n */\nexport function discoverBakers(cwd: string = process.cwd()): {\n  bakers: BakerRegistration[]\n  conflicts: string[]\n} {\n  const seenPackages = new Set<string>()\n  const bakers = new Map<string, BakerRegistration>()\n  const conflicts: string[] = []\n\n  // CWD-package self-discovery: if the user is iterating inside a package\n  // that declares a baker, let them invoke it without symlinking into\n  // node_modules first. Registers the baker before node_modules scans so a\n  // local version always wins against an older installed copy.\n  const selfDir = findPackageRoot(cwd)\n  if (selfDir) {\n    readPackage(selfDir, bakers, conflicts, seenPackages)\n  }\n\n  for (const nodeModulesDir of findNodeModulesDirs(cwd)) {\n    scanNodeModules(nodeModulesDir, bakers, conflicts, seenPackages)\n  }\n\n  return { bakers: Array.from(bakers.values()), conflicts }\n}\n\n/** Walk upward from `start` until a directory with package.json is found. */\nfunction findPackageRoot(start: string): string | null {\n  let dir = resolve(start)\n  while (true) {\n    if (existsSync(join(dir, 'package.json'))) return dir\n    const parent = resolve(dir, '..')\n    if (parent === dir) return null\n    dir = parent\n  }\n}\n\n/** Walk upward from `cwd` collecting each `node_modules` directory we find. */\nfunction findNodeModulesDirs(cwd: string): string[] {\n  const dirs: string[] = []\n  let dir = resolve(cwd)\n  while (true) {\n    const nm = join(dir, 'node_modules')\n    if (existsSync(nm) && statSync(nm).isDirectory()) {\n      dirs.push(nm)\n    }\n    const parent = resolve(dir, '..')\n    if (parent === dir) break\n    dir = parent\n  }\n  return dirs\n}\n\nfunction scanNodeModules(\n  nodeModulesDir: string,\n  bakers: Map<string, BakerRegistration>,\n  conflicts: string[],\n  seenPackages: Set<string>\n): void {\n  let entries: string[]\n  try {\n    entries = readdirSync(nodeModulesDir)\n  } catch {\n    return\n  }\n\n  for (const entry of entries) {\n    if (entry.startsWith('.')) continue\n    const entryPath = join(nodeModulesDir, entry)\n\n    if (entry.startsWith('@')) {\n      // Scoped packages: @scope/name\n      let scoped: string[]\n      try {\n        scoped = readdirSync(entryPath)\n      } catch {\n        continue\n      }\n      for (const scopedName of scoped) {\n        readPackage(join(entryPath, scopedName), bakers, conflicts, seenPackages)\n      }\n    } else {\n      readPackage(entryPath, bakers, conflicts, seenPackages)\n    }\n  }\n}\n\nfunction readPackage(\n  packageDir: string,\n  bakers: Map<string, BakerRegistration>,\n  conflicts: string[],\n  seenPackages: Set<string>\n): void {\n  const pkgPath = join(packageDir, 'package.json')\n  if (!existsSync(pkgPath)) return\n\n  let pkg: PackageJson\n  try {\n    pkg = JSON.parse(readFileSync(pkgPath, 'utf8')) as PackageJson\n  } catch {\n    return\n  }\n\n  const name = pkg.name ?? packageDir\n  if (seenPackages.has(name)) return\n  seenPackages.add(name)\n\n  const manifest = resolveManifest(pkg.flatland, name, conflicts)\n  if (!manifest || manifest.length === 0) return\n\n  for (const decl of manifest) {\n    const resolvedEntry = resolve(packageDir, decl.entry)\n    const registration: BakerRegistration = {\n      name: decl.name,\n      description: decl.description,\n      entry: decl.entry,\n      packageName: name,\n      resolvedEntry,\n    }\n\n    const existing = bakers.get(decl.name)\n    if (existing) {\n      conflicts.push(\n        `baker \"${decl.name}\" is registered by both \"${existing.packageName}\" and \"${name}\" — using \"${existing.packageName}\"`\n      )\n      continue\n    }\n    bakers.set(decl.name, registration)\n  }\n}\n\n/**\n * Prefer `flatland.bake` (current); fall back to `flatland.bakers`\n * (legacy) with a one-time deprecation warning per package.\n */\nfunction resolveManifest(\n  manifest: FlatlandManifest | undefined,\n  packageName: string,\n  conflicts: string[]\n): FlatlandManifestEntry[] | undefined {\n  if (!manifest) return undefined\n  if (manifest.bake && manifest.bake.length > 0) return manifest.bake\n  if (manifest.bakers && manifest.bakers.length > 0) {\n    conflicts.push(\n      `\"${packageName}\" uses deprecated \\`flatland.bakers\\` — rename to \\`flatland.bake\\` (the legacy key is accepted for one release)`\n    )\n    return manifest.bakers\n  }\n  return undefined\n}\n"],"mappings":"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","names":[]}
+{"version":3,"file":"discovery.js","names":[],"sources":["../src/discovery.ts"],"sourcesContent":["import { readFileSync, readdirSync, existsSync, statSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport type { BakerRegistration, FlatlandManifest, FlatlandManifestEntry } from './types.js'\n\ninterface PackageJson {\n  name?: string\n  flatland?: FlatlandManifest\n}\n\n/**\n * Discover registered bakers by walking `node_modules` near the current\n * working directory. Supports both flat and pnpm-symlinked layouts: every\n * `package.json` that declares a `flatland.bake` (or legacy\n * `flatland.bakers`) field is picked up.\n *\n * Conflicts (multiple packages registering the same baker name) are reported;\n * the first match wins and the rest are returned as warnings so the caller\n * can decide whether to fail or log.\n */\nexport function discoverBakers(cwd: string = process.cwd()): {\n  bakers: BakerRegistration[]\n  conflicts: string[]\n} {\n  const seenPackages = new Set<string>()\n  const bakers = new Map<string, BakerRegistration>()\n  const conflicts: string[] = []\n\n  // CWD-package self-discovery: if the user is iterating inside a package\n  // that declares a baker, let them invoke it without symlinking into\n  // node_modules first. Registers the baker before node_modules scans so a\n  // local version always wins against an older installed copy.\n  const selfDir = findPackageRoot(cwd)\n  if (selfDir) {\n    readPackage(selfDir, bakers, conflicts, seenPackages)\n  }\n\n  for (const nodeModulesDir of findNodeModulesDirs(cwd)) {\n    scanNodeModules(nodeModulesDir, bakers, conflicts, seenPackages)\n  }\n\n  return { bakers: Array.from(bakers.values()), conflicts }\n}\n\n/** Walk upward from `start` until a directory with package.json is found. */\nfunction findPackageRoot(start: string): string | null {\n  let dir = resolve(start)\n  while (true) {\n    if (existsSync(join(dir, 'package.json'))) return dir\n    const parent = resolve(dir, '..')\n    if (parent === dir) return null\n    dir = parent\n  }\n}\n\n/** Walk upward from `cwd` collecting each `node_modules` directory we find. */\nfunction findNodeModulesDirs(cwd: string): string[] {\n  const dirs: string[] = []\n  let dir = resolve(cwd)\n  while (true) {\n    const nm = join(dir, 'node_modules')\n    if (existsSync(nm) && statSync(nm).isDirectory()) {\n      dirs.push(nm)\n    }\n    const parent = resolve(dir, '..')\n    if (parent === dir) break\n    dir = parent\n  }\n  return dirs\n}\n\nfunction scanNodeModules(\n  nodeModulesDir: string,\n  bakers: Map<string, BakerRegistration>,\n  conflicts: string[],\n  seenPackages: Set<string>\n): void {\n  let entries: string[]\n  try {\n    entries = readdirSync(nodeModulesDir)\n  } catch {\n    return\n  }\n\n  for (const entry of entries) {\n    if (entry.startsWith('.')) continue\n    const entryPath = join(nodeModulesDir, entry)\n\n    if (entry.startsWith('@')) {\n      // Scoped packages: @scope/name\n      let scoped: string[]\n      try {\n        scoped = readdirSync(entryPath)\n      } catch {\n        continue\n      }\n      for (const scopedName of scoped) {\n        readPackage(join(entryPath, scopedName), bakers, conflicts, seenPackages)\n      }\n    } else {\n      readPackage(entryPath, bakers, conflicts, seenPackages)\n    }\n  }\n}\n\nfunction readPackage(\n  packageDir: string,\n  bakers: Map<string, BakerRegistration>,\n  conflicts: string[],\n  seenPackages: Set<string>\n): void {\n  const pkgPath = join(packageDir, 'package.json')\n  if (!existsSync(pkgPath)) return\n\n  let pkg: PackageJson\n  try {\n    pkg = JSON.parse(readFileSync(pkgPath, 'utf8')) as PackageJson\n  } catch {\n    return\n  }\n\n  const name = pkg.name ?? packageDir\n  if (seenPackages.has(name)) return\n  seenPackages.add(name)\n\n  const manifest = resolveManifest(pkg.flatland, name, conflicts)\n  if (!manifest || manifest.length === 0) return\n\n  for (const decl of manifest) {\n    const resolvedEntry = resolve(packageDir, decl.entry)\n    const registration: BakerRegistration = {\n      name: decl.name,\n      description: decl.description,\n      entry: decl.entry,\n      packageName: name,\n      resolvedEntry,\n    }\n\n    const existing = bakers.get(decl.name)\n    if (existing) {\n      conflicts.push(\n        `baker \"${decl.name}\" is registered by both \"${existing.packageName}\" and \"${name}\" — using \"${existing.packageName}\"`\n      )\n      continue\n    }\n    bakers.set(decl.name, registration)\n  }\n}\n\n/**\n * Prefer `flatland.bake` (current); fall back to `flatland.bakers`\n * (legacy) with a one-time deprecation warning per package.\n */\nfunction resolveManifest(\n  manifest: FlatlandManifest | undefined,\n  packageName: string,\n  conflicts: string[]\n): FlatlandManifestEntry[] | undefined {\n  if (!manifest) return undefined\n  if (manifest.bake && manifest.bake.length > 0) return manifest.bake\n  if (manifest.bakers && manifest.bakers.length > 0) {\n    conflicts.push(\n      `\"${packageName}\" uses deprecated \\`flatland.bakers\\` — rename to \\`flatland.bake\\` (the legacy key is accepted for one release)`\n    )\n    return manifest.bakers\n  }\n  return undefined\n}\n"],"mappings":"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"}