@three-flatland/bake 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Justin Walsh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/thejustinwalsh/three-flatland/main/assets/repo-banner.png" alt="three-flatland" width="100%" />
+</p>
+
+# @three-flatland/bake
+
+Shared bake pipeline infrastructure for [three-flatland](https://www.npmjs.com/package/three-flatland) and Three.js WebGPU. Provides the `flatland-bake` CLI dispatcher, browser-safe loader utilities for assets with offline-baked siblings, and the baker discovery mechanism.
+
+> **Alpha Release** — this package is in active development. The API will evolve and breaking changes are expected between releases. Pin your version and check the [changelog](https://github.com/thejustinwalsh/three-flatland/releases) before upgrading.
+
+[![npm](https://img.shields.io/npm/v/@three-flatland/bake)](https://www.npmjs.com/package/@three-flatland/bake)
+[![license](https://img.shields.io/npm/l/@three-flatland/bake)](https://github.com/thejustinwalsh/three-flatland/blob/main/LICENSE)
+
+## Install
+
+```bash
+npm install @three-flatland/bake
+```
+
+Install alongside any package that contributes a baker — e.g. [`@three-flatland/normals`](https://www.npmjs.com/package/@three-flatland/normals) for sprite normal maps.
+
+## Quick Start
+
+### Run a registered baker
+
+```bash
+npx flatland-bake normal public/sprites/knight.png
+npx flatland-bake --list
+```
+
+The CLI walks `node_modules` and picks up any package that declares a `flatland.bake` manifest in its `package.json`. Install a baker package and its subcommand appears in `--list` automatically — no registration step.
+
+### Use the browser-safe utilities
+
+Loaders that follow the "try baked sibling → fall back to in-memory" pattern share a small utility surface from the default entry. Importable from any environment (browser, node, workers):
+
+```typescript
+import {
+  bakedSiblingURL,
+  probeBakedSibling,
+  hashDescriptor,
+  devtimeWarn,
+  type BakedAssetLoaderOptions,
+} from '@three-flatland/bake'
+```
+
+Node-only code (CLI, discovery, sidecar file writers) lives under the `/node` subpath:
+
+```typescript
+import { discoverBakers, writeSidecarPng, writeSidecarJson } from '@three-flatland/bake/node'
+```
+
+## Authoring a Baker
+
+Packages contribute bakers via a `flatland.bake` manifest plus a default-exported `Baker`:
+
+```jsonc
+// package.json
+{
+  "flatland": {
+    "bake": [
+      {
+        "name": "normal",
+        "description": "Bake a tangent-space normal map from a sprite PNG",
+        "entry": "./dist/cli.js"
+      }
+    ]
+  }
+}
+```
+
+```typescript
+// src/cli.ts
+import type { Baker } from '@three-flatland/bake'
+
+const baker: Baker = {
+  name: 'normal',
+  description: 'Bake a tangent-space normal map from a sprite PNG',
+  run: async (args) => {
+    // your CLI logic here — return 0 for success
+    return 0
+  },
+}
+export default baker
+```
+
+[`@three-flatland/normals`](https://github.com/thejustinwalsh/three-flatland/tree/main/packages/normals) is a reference implementation.
+
+## Options
+
+### CLI
+
+```
+flatland-bake <name> [args...]    Run a registered baker
+flatland-bake --list              List registered bakers
+flatland-bake --help              Show usage
+```
+
+### Shared loader option
+
+Every loader that speaks the baked-sibling pattern extends `BakedAssetLoaderOptions`, which adds a single flag:
+
+```typescript
+interface BakedAssetLoaderOptions {
+  /** Generate this asset's derived data in the browser on every load
+   *  instead of loading a pre-baked sidecar. */
+  forceRuntime?: boolean
+}
+```
+
+`forceRuntime: true` declares **the browser is where this asset's derived data is produced** — not the CI bake step. You always get the data either way (if you ask for it, you get it); this flag just chooses where the generation runs. Use it for assets that are procedurally varied, throwaway prototypes, or asset bundles where shipping the sidecar isn't worth the bytes. Suppresses the "no baked sibling" warn because the missing sidecar is the architecture, not a mistake.
+
+Not a dev-iteration knob — the default path (probe → generate on miss + warn pointing at `flatland-bake`) already handles iteration. Mirrors `SlugFontLoader.forceRuntime`; one name across every baked-asset loader in the ecosystem.
+
+## Using with plain Three.js
+
+`@three-flatland/bake` is renderer-agnostic. Run the CLI from any project's `npm scripts` to bake assets, or import the browser-safe helpers to write your own sidecar-aware loaders — no three-flatland dependency required.
+
+## Related
+
+- **[three-flatland](https://www.npmjs.com/package/three-flatland)** — the 2D engine. High-level loaders consume this package's helpers internally.
+- **[@three-flatland/normals](https://www.npmjs.com/package/@three-flatland/normals)** — reference baker: sprite / tileset normal map generation.
+
+## Documentation
+
+Full docs, interactive examples, and API reference at **[thejustinwalsh.com/three-flatland](https://thejustinwalsh.com/three-flatland/)**
+
+## License
+
+[MIT](./LICENSE)
+
+---
+
+<sub>This README was created with AI assistance. AI can make mistakes — please verify claims and test code examples. Submit corrections [here](https://github.com/thejustinwalsh/three-flatland/issues).</sub>

package/dist/cli.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "node:url";
+import { existsSync } from "node:fs";
+import { discoverBakers } from "./discovery.js";
+const USAGE = `flatland-bake \u2014 unified bake entry point
+
+Usage:
+  flatland-bake <name> [args...]    Run a registered baker
+  flatland-bake --list              List registered bakers
+  flatland-bake --help              Show this usage
+
+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;
+  }
+}
+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;
+}
+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;
+}
+main(process.argv.slice(2)).then(
+  (code) => process.exit(code),
+  (err) => {
+    process.stderr.write(`[flatland-bake] fatal: ${String(err)}
+`);
+    process.exit(1);
+  }
+);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +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":[]}

package/dist/devtimeWarn.js

@@ -0,0 +1,24 @@
+const _warned = /* @__PURE__ */ new Map();
+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}`);
+}
+function _resetDevtimeWarnings() {
+  _warned.clear();
+}
+function isProduction() {
+  const proc = globalThis.process;
+  return proc?.env?.["NODE_ENV"] === "production";
+}
+export {
+  _resetDevtimeWarnings,
+  devtimeWarn
+};
+//# sourceMappingURL=devtimeWarn.js.map

package/dist/devtimeWarn.js.map

@@ -0,0 +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":[]}

package/dist/discovery.js

@@ -0,0 +1,111 @@
+import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import { resolve, join } from "node:path";
+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 };
+}
+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;
+  }
+}
+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;
+}
+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);
+    }
+  }
+}
+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);
+  }
+}
+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;
+}
+export {
+  discoverBakers
+};
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +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":[]}

package/dist/index.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Contract every baker must satisfy.
+ *
+ * Bakers are registered by package.json via a `flatland.bake` field:
+ *
+ * ```json
+ * {
+ *   "flatland": {
+ *     "bake": [
+ *       { "name": "font", "description": "Bake SlugFont", "entry": "./dist/cli.js" }
+ *     ]
+ *   }
+ * }
+ * ```
+ *
+ * Entry modules must default-export a `Baker`. The legacy `flatland.bakers`
+ * shape is still accepted for one release with a deprecation warning.
+ */
+interface Baker {
+    /** Subcommand name used on the CLI: `flatland-bake <name> ...` */
+    name: string;
+    /** One-line description shown by `flatland-bake --list`. */
+    description: string;
+    /**
+     * Run the baker with the CLI args that follow the subcommand.
+     * Resolves to an exit code (0 = success).
+     */
+    run(args: string[]): Promise<number>;
+    /** Optional multiline usage string for `flatland-bake <name> --help`. */
+    usage?(): string;
+}
+interface BakerRegistration {
+    name: string;
+    description: string;
+    entry: string;
+    /** Package that declared the baker — used in diagnostics. */
+    packageName: string;
+    /** Absolute path on disk the `entry` resolves to. */
+    resolvedEntry: string;
+}
+interface FlatlandManifestEntry {
+    name: string;
+    description: string;
+    entry: string;
+}
+interface FlatlandManifest {
+    /** Current registration shape. */
+    bake?: FlatlandManifestEntry[];
+    /** @deprecated Legacy shape; use `bake` instead. Accepted for one release. */
+    bakers?: FlatlandManifestEntry[];
+}
+/**
+ * Shared option interface for every loader that speaks the
+ * "try baked sibling first → fall back to in-memory generation" pattern.
+ *
+ * Loaders extend this with their asset-specific options:
+ *
+ * ```ts
+ * interface MyLoaderOptions extends BakedAssetLoaderOptions {
+ *   // asset-specific fields
+ * }
+ * ```
+ */
+interface BakedAssetLoaderOptions {
+    /**
+     * Generate this asset's derived data in the browser on every load
+     * instead of loading a pre-baked sidecar. The runtime generator
+     * becomes the canonical source — no sidecar probe, no devtime "no
+     * baked sibling" warning, just a fresh generate on every load.
+     *
+     * If you ask for the data (e.g. `normals: true`), you always get it.
+     * `forceRuntime` chooses *where* the generation happens — browser vs
+     * CI — it does not choose whether you get the data. The default path
+     * still produces the data on every miss; this flag just commits to
+     * "the browser is always where it's produced for this asset."
+     *
+     * Use when runtime really is the right home for the generation:
+     * procedurally varied content, throwaway prototypes, asset bundles
+     * where shipping the sidecar isn't worth the bytes. Not a dev-
+     * iteration knob — the default path (probe → generate on miss + warn
+     * pointing at `flatland-bake`) already handles iteration.
+     *
+     * Default `false`. Mirrors `SlugFontLoader.forceRuntime` — one flag
+     * across every baked-asset loader in the codebase.
+     */
+    forceRuntime?: boolean;
+}
+/**
+ * Metadata stamped into a baked PNG's `tEXt` chunk under the key
+ * `flatland`. Read back by `probeBakedSibling` to validate the baked
+ * file still matches the descriptor a consumer is about to use.
+ */
+interface BakedSidecarMetadata {
+    /** Content hash of the descriptor that produced this file. */
+    hash: string;
+    /** Schema version of the metadata format itself. */
+    v: 1;
+}
+
+/**
+ * Derive the sibling URL for a baked asset.
+ *
+ * @example
+ *   bakedSiblingURL('/sprites/knight.png', '.normal.png')
+ *     // → '/sprites/knight.normal.png'
+ *
+ * Query strings and fragments are preserved:
+ *   bakedSiblingURL('/a.png?v=2', '.normal.png')
+ *     // → '/a.normal.png?v=2'
+ */
+declare function bakedSiblingURL(sourceURL: string, suffix: string): string;
+/**
+ * Stable content hash of any JSON-serializable value. FNV-1a 64-bit over
+ * a canonical stringification (sorted keys). Deterministic across
+ * browser and node, no deps, sync.
+ *
+ * Intended for cache invalidation of baked sidecars — not for any
+ * cryptographic purpose.
+ */
+declare function hashDescriptor(value: unknown): string;
+/**
+ * HEAD-probe a baked sibling URL and, when `expectedHash` is provided,
+ * range-fetch the PNG header to verify the tEXt stamp matches.
+ *
+ * Returns `{ ok: false }` when the sibling is missing or unreachable.
+ * Returns `{ ok: true, hashMatches }` otherwise; callers decide whether
+ * to use the baked file or re-generate in-memory.
+ */
+declare function probeBakedSibling(url: string, opts?: {
+    expectedHash?: string;
+}): Promise<{
+    ok: true;
+    hashMatches: boolean;
+    url: string;
+} | {
+    ok: false;
+}>;
+/**
+ * Minimal PNG `tEXt` chunk reader. Walks chunks after the 8-byte
+ * signature, stopping when it finds one whose keyword matches `key`.
+ *
+ * Returns the chunk's Latin-1 text value, or `null` when the keyword is
+ * absent / the buffer is not a valid PNG.
+ */
+declare function readPngTextChunk(buffer: ArrayBuffer, key: string): string | null;
+
+/**
+ * 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;
+
+export { type BakedAssetLoaderOptions, type BakedSidecarMetadata, type Baker, type BakerRegistration, type FlatlandManifest, type FlatlandManifestEntry, _resetDevtimeWarnings, bakedSiblingURL, devtimeWarn, hashDescriptor, probeBakedSibling, readPngTextChunk };

package/dist/index.js

@@ -0,0 +1,16 @@
+import {
+  bakedSiblingURL,
+  probeBakedSibling,
+  readPngTextChunk,
+  hashDescriptor
+} from "./sidecar.js";
+import { devtimeWarn, _resetDevtimeWarnings } from "./devtimeWarn.js";
+export {
+  _resetDevtimeWarnings,
+  bakedSiblingURL,
+  devtimeWarn,
+  hashDescriptor,
+  probeBakedSibling,
+  readPngTextChunk
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Browser-safe surface of @three-flatland/bake.\n//\n// Types + runtime helpers usable from any environment (browser, node,\n// workers, deno). No `node:*` imports, no filesystem access.\n//\n// Consumers running in node that need the CLI, discovery, or sidecar\n// emission should import from '@three-flatland/bake/node' instead.\nexport type {\n  Baker,\n  BakerRegistration,\n  FlatlandManifest,\n  FlatlandManifestEntry,\n  BakedAssetLoaderOptions,\n  BakedSidecarMetadata,\n} from './types.js'\n\nexport {\n  bakedSiblingURL,\n  probeBakedSibling,\n  readPngTextChunk,\n  hashDescriptor,\n} from './sidecar.js'\n\nexport { devtimeWarn, _resetDevtimeWarnings } from './devtimeWarn.js'\n"],"mappings":"AAgBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,aAAa,6BAA6B;","names":[]}

package/dist/node.d.ts

@@ -0,0 +1,35 @@
+import { BakerRegistration, BakedSidecarMetadata } from './index.js';
+export { BakedAssetLoaderOptions, Baker, FlatlandManifest, FlatlandManifestEntry, _resetDevtimeWarnings, bakedSiblingURL, devtimeWarn, hashDescriptor, probeBakedSibling, readPngTextChunk } from './index.js';
+
+/**
+ * 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[];
+};
+
+/**
+ * Write a PNG with a flatland metadata `tEXt` chunk stamped in.
+ *
+ * The stamp lives under keyword `flatland` and carries the descriptor
+ * hash so downstream `probeBakedSibling` calls can invalidate the
+ * baked file when the descriptor changes.
+ */
+declare function writeSidecarPng(outputPath: string, pixels: Uint8Array, width: number, height: number, metadata: BakedSidecarMetadata): void;
+/**
+ * Write a sidecar descriptor JSON file adjacent to the source asset.
+ *
+ * Same file format `flatland-bake <subcommand> --descriptor` consumes,
+ * so the runtime and CLI agree on one shape.
+ */
+declare function writeSidecarJson(outputPath: string, descriptor: unknown): void;
+
+export { BakedSidecarMetadata, BakerRegistration, discoverBakers, writeSidecarJson, writeSidecarPng };

package/dist/node.js

@@ -0,0 +1,9 @@
+export * from "./index.js";
+import { discoverBakers } from "./discovery.js";
+import { writeSidecarPng, writeSidecarJson } from "./writeSidecar.js";
+export {
+  discoverBakers,
+  writeSidecarJson,
+  writeSidecarPng
+};
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node.ts"],"sourcesContent":["// Node-only surface of @three-flatland/bake.\n//\n// Re-exports the browser-safe surface plus filesystem helpers and the\n// manifest discovery used by the `flatland-bake` CLI. Importing this\n// entry pulls in `node:fs`, `node:path`, and `pngjs` — avoid it from\n// bundles targeting the browser.\n\nexport * from './index.js'\nexport { discoverBakers } from './discovery.js'\nexport { writeSidecarPng, writeSidecarJson } from './writeSidecar.js'\n"],"mappings":"AAOA,cAAc;AACd,SAAS,sBAAsB;AAC/B,SAAS,iBAAiB,wBAAwB;","names":[]}

package/dist/sidecar.js

@@ -0,0 +1,109 @@
+function bakedSiblingURL(sourceURL, suffix) {
+  return sourceURL.replace(/\.(\w+)($|[?#])/i, `${suffix}$2`);
+}
+function hashDescriptor(value) {
+  const canonical = stableStringify(value);
+  return fnv1a64(canonical);
+}
+function stableStringify(value) {
+  if (value === null || typeof value !== "object") return JSON.stringify(value) ?? "null";
+  if (Array.isArray(value)) {
+    return "[" + value.map((v) => stableStringify(v)).join(",") + "]";
+  }
+  const obj = value;
+  const keys = Object.keys(obj).sort();
+  return "{" + keys.map((k) => JSON.stringify(k) + ":" + stableStringify(obj[k])).join(",") + "}";
+}
+function fnv1a64(str) {
+  let hash = 0xcbf29ce484222325n;
+  const prime = 0x100000001b3n;
+  const mask = 0xffffffffffffffffn;
+  for (let i = 0; i < str.length; i++) {
+    hash = hash ^ BigInt(str.charCodeAt(i));
+    hash = hash * prime & mask;
+  }
+  return hash.toString(16).padStart(16, "0");
+}
+async function probeBakedSibling(url, opts) {
+  let head;
+  try {
+    head = await fetch(url, { method: "HEAD" });
+  } catch {
+    return { ok: false };
+  }
+  if (!head.ok) return { ok: false };
+  if (opts?.expectedHash === void 0) {
+    return { ok: true, hashMatches: true, url };
+  }
+  let header;
+  try {
+    header = await fetch(url, { headers: { Range: "bytes=0-4095" } });
+  } catch {
+    return { ok: true, hashMatches: false, url };
+  }
+  if (!header.ok) {
+    return { ok: true, hashMatches: false, url };
+  }
+  const buf = await header.arrayBuffer();
+  const metaJSON = readPngTextChunk(buf, "flatland");
+  if (!metaJSON) return { ok: true, hashMatches: false, url };
+  try {
+    const meta = JSON.parse(metaJSON);
+    return { ok: true, hashMatches: meta.hash === opts.expectedHash, url };
+  } catch {
+    return { ok: true, hashMatches: false, url };
+  }
+}
+function readPngTextChunk(buffer, key) {
+  if (buffer.byteLength < 8) return null;
+  const view = new DataView(buffer);
+  const expectedSig = [137, 80, 78, 71, 13, 10, 26, 10];
+  for (let i = 0; i < 8; i++) {
+    if (view.getUint8(i) !== expectedSig[i]) return null;
+  }
+  let offset = 8;
+  while (offset + 8 <= buffer.byteLength) {
+    const length = view.getUint32(offset);
+    const type = String.fromCharCode(
+      view.getUint8(offset + 4),
+      view.getUint8(offset + 5),
+      view.getUint8(offset + 6),
+      view.getUint8(offset + 7)
+    );
+    const dataStart = offset + 8;
+    const dataEnd = dataStart + length;
+    if (dataEnd + 4 > buffer.byteLength) return null;
+    if (type === "tEXt") {
+      let sepIdx = -1;
+      for (let i = dataStart; i < dataEnd; i++) {
+        if (view.getUint8(i) === 0) {
+          sepIdx = i;
+          break;
+        }
+      }
+      if (sepIdx > dataStart) {
+        let keyword = "";
+        for (let i = dataStart; i < sepIdx; i++) {
+          keyword += String.fromCharCode(view.getUint8(i));
+        }
+        if (keyword === key) {
+          let value = "";
+          for (let i = sepIdx + 1; i < dataEnd; i++) {
+            value += String.fromCharCode(view.getUint8(i));
+          }
+          return value;
+        }
+      }
+    }
+    if (type === "IEND") return null;
+    offset = dataEnd + 4;
+  }
+  return null;
+}
+export {
+  bakedSiblingURL,
+  hashDescriptor,
+  probeBakedSibling,
+  readPngTextChunk
+};
+//# sourceMappingURL=sidecar.js.map

package/dist/sidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sidecar.ts"],"sourcesContent":["import type { BakedSidecarMetadata } from './types.js'\n\n/**\n * Derive the sibling URL for a baked asset.\n *\n * @example\n *   bakedSiblingURL('/sprites/knight.png', '.normal.png')\n *     // → '/sprites/knight.normal.png'\n *\n * Query strings and fragments are preserved:\n *   bakedSiblingURL('/a.png?v=2', '.normal.png')\n *     // → '/a.normal.png?v=2'\n */\nexport function bakedSiblingURL(sourceURL: string, suffix: string): string {\n  return sourceURL.replace(/\\.(\\w+)($|[?#])/i, `${suffix}$2`)\n}\n\n/**\n * Stable content hash of any JSON-serializable value. FNV-1a 64-bit over\n * a canonical stringification (sorted keys). Deterministic across\n * browser and node, no deps, sync.\n *\n * Intended for cache invalidation of baked sidecars — not for any\n * cryptographic purpose.\n */\nexport function hashDescriptor(value: unknown): string {\n  const canonical = stableStringify(value)\n  return fnv1a64(canonical)\n}\n\nfunction stableStringify(value: unknown): string {\n  if (value === null || typeof value !== 'object') return JSON.stringify(value) ?? 'null'\n  if (Array.isArray(value)) {\n    return '[' + value.map((v) => stableStringify(v)).join(',') + ']'\n  }\n  const obj = value as Record<string, unknown>\n  const keys = Object.keys(obj).sort()\n  return (\n    '{' +\n    keys.map((k) => JSON.stringify(k) + ':' + stableStringify(obj[k])).join(',') +\n    '}'\n  )\n}\n\nfunction fnv1a64(str: string): string {\n  let hash = 0xcbf29ce484222325n\n  const prime = 0x100000001b3n\n  const mask = 0xffffffffffffffffn\n  for (let i = 0; i < str.length; i++) {\n    hash = hash ^ BigInt(str.charCodeAt(i))\n    hash = (hash * prime) & mask\n  }\n  return hash.toString(16).padStart(16, '0')\n}\n\n/**\n * HEAD-probe a baked sibling URL and, when `expectedHash` is provided,\n * range-fetch the PNG header to verify the tEXt stamp matches.\n *\n * Returns `{ ok: false }` when the sibling is missing or unreachable.\n * Returns `{ ok: true, hashMatches }` otherwise; callers decide whether\n * to use the baked file or re-generate in-memory.\n */\nexport async function probeBakedSibling(\n  url: string,\n  opts?: { expectedHash?: string }\n): Promise<{ ok: true; hashMatches: boolean; url: string } | { ok: false }> {\n  let head: Response\n  try {\n    head = await fetch(url, { method: 'HEAD' })\n  } catch {\n    return { ok: false }\n  }\n  if (!head.ok) return { ok: false }\n\n  if (opts?.expectedHash === undefined) {\n    return { ok: true, hashMatches: true, url }\n  }\n\n  // Range-fetch the PNG header to read the tEXt stamp. We don't need the\n  // full image; the first ~4 KB comfortably covers signature + IHDR +\n  // metadata chunks for every baker we emit.\n  let header: Response\n  try {\n    header = await fetch(url, { headers: { Range: 'bytes=0-4095' } })\n  } catch {\n    return { ok: true, hashMatches: false, url }\n  }\n  if (!header.ok) {\n    return { ok: true, hashMatches: false, url }\n  }\n  const buf = await header.arrayBuffer()\n  const metaJSON = readPngTextChunk(buf, 'flatland')\n  if (!metaJSON) return { ok: true, hashMatches: false, url }\n  try {\n    const meta = JSON.parse(metaJSON) as BakedSidecarMetadata\n    return { ok: true, hashMatches: meta.hash === opts.expectedHash, url }\n  } catch {\n    return { ok: true, hashMatches: false, url }\n  }\n}\n\n/**\n * Minimal PNG `tEXt` chunk reader. Walks chunks after the 8-byte\n * signature, stopping when it finds one whose keyword matches `key`.\n *\n * Returns the chunk's Latin-1 text value, or `null` when the keyword is\n * absent / the buffer is not a valid PNG.\n */\nexport function readPngTextChunk(buffer: ArrayBuffer, key: string): string | null {\n  if (buffer.byteLength < 8) return null\n  const view = new DataView(buffer)\n  const expectedSig = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]\n  for (let i = 0; i < 8; i++) {\n    if (view.getUint8(i) !== expectedSig[i]) return null\n  }\n\n  let offset = 8\n  while (offset + 8 <= buffer.byteLength) {\n    const length = view.getUint32(offset)\n    const type = String.fromCharCode(\n      view.getUint8(offset + 4),\n      view.getUint8(offset + 5),\n      view.getUint8(offset + 6),\n      view.getUint8(offset + 7)\n    )\n    const dataStart = offset + 8\n    const dataEnd = dataStart + length\n    if (dataEnd + 4 > buffer.byteLength) return null\n\n    if (type === 'tEXt') {\n      let sepIdx = -1\n      for (let i = dataStart; i < dataEnd; i++) {\n        if (view.getUint8(i) === 0) {\n          sepIdx = i\n          break\n        }\n      }\n      if (sepIdx > dataStart) {\n        let keyword = ''\n        for (let i = dataStart; i < sepIdx; i++) {\n          keyword += String.fromCharCode(view.getUint8(i))\n        }\n        if (keyword === key) {\n          let value = ''\n          for (let i = sepIdx + 1; i < dataEnd; i++) {\n            value += String.fromCharCode(view.getUint8(i))\n          }\n          return value\n        }\n      }\n    }\n\n    if (type === 'IEND') return null\n    offset = dataEnd + 4\n  }\n  return null\n}\n"],"mappings":"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","names":[]}

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/writeSidecar.js

@@ -0,0 +1,60 @@
+import { writeFileSync } from "node:fs";
+import { Buffer } from "node:buffer";
+import { PNG } from "pngjs";
+function writeSidecarPng(outputPath, pixels, width, height, metadata) {
+  const png = new PNG({ width, height });
+  png.data = Buffer.from(pixels.buffer, pixels.byteOffset, pixels.byteLength);
+  const buffer = PNG.sync.write(png);
+  const stamped = injectTextChunk(buffer, "flatland", JSON.stringify(metadata));
+  writeFileSync(outputPath, stamped);
+}
+function writeSidecarJson(outputPath, descriptor) {
+  writeFileSync(outputPath, JSON.stringify(descriptor, null, 2) + "\n");
+}
+function injectTextChunk(pngBuffer, keyword, value) {
+  const sigLen = 8;
+  if (pngBuffer[sigLen + 4] !== 73 || pngBuffer[sigLen + 5] !== 72 || pngBuffer[sigLen + 6] !== 68 || pngBuffer[sigLen + 7] !== 82) {
+    return pngBuffer;
+  }
+  const ihdrLength = pngBuffer.readUInt32BE(sigLen);
+  const ihdrEnd = sigLen + 8 + ihdrLength + 4;
+  const textData = Buffer.concat([
+    Buffer.from(keyword, "latin1"),
+    Buffer.from([0]),
+    Buffer.from(value, "latin1")
+  ]);
+  const textType = Buffer.from("tEXt", "latin1");
+  const textLen = Buffer.alloc(4);
+  textLen.writeUInt32BE(textData.length, 0);
+  const textCrc = Buffer.alloc(4);
+  textCrc.writeUInt32BE(crc32(Buffer.concat([textType, textData])), 0);
+  const textChunk = Buffer.concat([textLen, textType, textData, textCrc]);
+  return Buffer.concat([pngBuffer.subarray(0, ihdrEnd), textChunk, pngBuffer.subarray(ihdrEnd)]);
+}
+let _crcTable = null;
+function crcTable() {
+  if (_crcTable) return _crcTable;
+  const table = new Uint32Array(256);
+  for (let n = 0; n < 256; n++) {
+    let c = n;
+    for (let k = 0; k < 8; k++) {
+      c = c & 1 ? 3988292384 ^ c >>> 1 : c >>> 1;
+    }
+    table[n] = c >>> 0;
+  }
+  _crcTable = table;
+  return table;
+}
+function crc32(buffer) {
+  const table = crcTable();
+  let crc = 4294967295;
+  for (let i = 0; i < buffer.length; i++) {
+    crc = (table[(crc ^ buffer[i]) & 255] ^ crc >>> 8) >>> 0;
+  }
+  return (crc ^ 4294967295) >>> 0;
+}
+export {
+  writeSidecarJson,
+  writeSidecarPng
+};
+//# sourceMappingURL=writeSidecar.js.map

package/dist/writeSidecar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/writeSidecar.ts"],"sourcesContent":["import { writeFileSync } from 'node:fs'\nimport { Buffer } from 'node:buffer'\nimport { PNG } from 'pngjs'\nimport type { BakedSidecarMetadata } from './types.js'\n\n/**\n * Write a PNG with a flatland metadata `tEXt` chunk stamped in.\n *\n * The stamp lives under keyword `flatland` and carries the descriptor\n * hash so downstream `probeBakedSibling` calls can invalidate the\n * baked file when the descriptor changes.\n */\nexport function writeSidecarPng(\n  outputPath: string,\n  pixels: Uint8Array,\n  width: number,\n  height: number,\n  metadata: BakedSidecarMetadata\n): void {\n  const png = new PNG({ width, height })\n  png.data = Buffer.from(pixels.buffer, pixels.byteOffset, pixels.byteLength)\n  const buffer = PNG.sync.write(png)\n  const stamped = injectTextChunk(buffer, 'flatland', JSON.stringify(metadata))\n  writeFileSync(outputPath, stamped)\n}\n\n/**\n * Write a sidecar descriptor JSON file adjacent to the source asset.\n *\n * Same file format `flatland-bake <subcommand> --descriptor` consumes,\n * so the runtime and CLI agree on one shape.\n */\nexport function writeSidecarJson(outputPath: string, descriptor: unknown): void {\n  writeFileSync(outputPath, JSON.stringify(descriptor, null, 2) + '\\n')\n}\n\n/**\n * Inject a `tEXt` chunk immediately after the IHDR so the metadata is\n * near the head of the file — `probeBakedSibling` range-fetches ~4 KB\n * to read the stamp, so placement matters.\n */\nfunction injectTextChunk(pngBuffer: Buffer, keyword: string, value: string): Buffer {\n  const sigLen = 8\n  // IHDR type starts 4 bytes after the length prefix: [len][I][H][D][R]...\n  if (\n    pngBuffer[sigLen + 4] !== 0x49 ||\n    pngBuffer[sigLen + 5] !== 0x48 ||\n    pngBuffer[sigLen + 6] !== 0x44 ||\n    pngBuffer[sigLen + 7] !== 0x52\n  ) {\n    return pngBuffer\n  }\n  const ihdrLength = pngBuffer.readUInt32BE(sigLen)\n  const ihdrEnd = sigLen + 8 + ihdrLength + 4 // length(4) + type(4) + data + CRC(4)\n\n  const textData = Buffer.concat([\n    Buffer.from(keyword, 'latin1'),\n    Buffer.from([0]),\n    Buffer.from(value, 'latin1'),\n  ])\n  const textType = Buffer.from('tEXt', 'latin1')\n  const textLen = Buffer.alloc(4)\n  textLen.writeUInt32BE(textData.length, 0)\n  const textCrc = Buffer.alloc(4)\n  textCrc.writeUInt32BE(crc32(Buffer.concat([textType, textData])), 0)\n  const textChunk = Buffer.concat([textLen, textType, textData, textCrc])\n\n  return Buffer.concat([pngBuffer.subarray(0, ihdrEnd), textChunk, pngBuffer.subarray(ihdrEnd)])\n}\n\nlet _crcTable: Uint32Array | null = null\nfunction crcTable(): Uint32Array {\n  if (_crcTable) return _crcTable\n  const table = new Uint32Array(256)\n  for (let n = 0; n < 256; n++) {\n    let c = n\n    for (let k = 0; k < 8; k++) {\n      c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1\n    }\n    table[n] = c >>> 0\n  }\n  _crcTable = table\n  return table\n}\n\nfunction crc32(buffer: Buffer): number {\n  const table = crcTable()\n  let crc = 0xffffffff\n  for (let i = 0; i < buffer.length; i++) {\n    crc = (table[(crc ^ buffer[i]!) & 0xff]! ^ (crc >>> 8)) >>> 0\n  }\n  return (crc ^ 0xffffffff) >>> 0\n}\n"],"mappings":"AAAA,SAAS,qBAAqB;AAC9B,SAAS,cAAc;AACvB,SAAS,WAAW;AAUb,SAAS,gBACd,YACA,QACA,OACA,QACA,UACM;AACN,QAAM,MAAM,IAAI,IAAI,EAAE,OAAO,OAAO,CAAC;AACrC,MAAI,OAAO,OAAO,KAAK,OAAO,QAAQ,OAAO,YAAY,OAAO,UAAU;AAC1E,QAAM,SAAS,IAAI,KAAK,MAAM,GAAG;AACjC,QAAM,UAAU,gBAAgB,QAAQ,YAAY,KAAK,UAAU,QAAQ,CAAC;AAC5E,gBAAc,YAAY,OAAO;AACnC;AAQO,SAAS,iBAAiB,YAAoB,YAA2B;AAC9E,gBAAc,YAAY,KAAK,UAAU,YAAY,MAAM,CAAC,IAAI,IAAI;AACtE;AAOA,SAAS,gBAAgB,WAAmB,SAAiB,OAAuB;AAClF,QAAM,SAAS;AAEf,MACE,UAAU,SAAS,CAAC,MAAM,MAC1B,UAAU,SAAS,CAAC,MAAM,MAC1B,UAAU,SAAS,CAAC,MAAM,MAC1B,UAAU,SAAS,CAAC,MAAM,IAC1B;AACA,WAAO;AAAA,EACT;AACA,QAAM,aAAa,UAAU,aAAa,MAAM;AAChD,QAAM,UAAU,SAAS,IAAI,aAAa;AAE1C,QAAM,WAAW,OAAO,OAAO;AAAA,IAC7B,OAAO,KAAK,SAAS,QAAQ;AAAA,IAC7B,OAAO,KAAK,CAAC,CAAC,CAAC;AAAA,IACf,OAAO,KAAK,OAAO,QAAQ;AAAA,EAC7B,CAAC;AACD,QAAM,WAAW,OAAO,KAAK,QAAQ,QAAQ;AAC7C,QAAM,UAAU,OAAO,MAAM,CAAC;AAC9B,UAAQ,cAAc,SAAS,QAAQ,CAAC;AACxC,QAAM,UAAU,OAAO,MAAM,CAAC;AAC9B,UAAQ,cAAc,MAAM,OAAO,OAAO,CAAC,UAAU,QAAQ,CAAC,CAAC,GAAG,CAAC;AACnE,QAAM,YAAY,OAAO,OAAO,CAAC,SAAS,UAAU,UAAU,OAAO,CAAC;AAEtE,SAAO,OAAO,OAAO,CAAC,UAAU,SAAS,GAAG,OAAO,GAAG,WAAW,UAAU,SAAS,OAAO,CAAC,CAAC;AAC/F;AAEA,IAAI,YAAgC;AACpC,SAAS,WAAwB;AAC/B,MAAI,UAAW,QAAO;AACtB,QAAM,QAAQ,IAAI,YAAY,GAAG;AACjC,WAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,QAAI,IAAI;AACR,aAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAI,IAAI,IAAI,aAAc,MAAM,IAAK,MAAM;AAAA,IAC7C;AACA,UAAM,CAAC,IAAI,MAAM;AAAA,EACnB;AACA,cAAY;AACZ,SAAO;AACT;AAEA,SAAS,MAAM,QAAwB;AACrC,QAAM,QAAQ,SAAS;AACvB,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,WAAO,OAAO,MAAM,OAAO,CAAC,KAAM,GAAI,IAAM,QAAQ,OAAQ;AAAA,EAC9D;AACA,UAAQ,MAAM,gBAAgB;AAChC;","names":[]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@three-flatland/bake",
+  "version": "0.1.0-alpha.1",
+  "description": "Shared bake pipeline infrastructure — CLI, discovery, and browser-safe loader utilities for assets with offline-baked siblings",
+  "type": "module",
+  "bin": {
+    "flatland-bake": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "node": {
+        "types": "./dist/node.d.ts",
+        "import": "./dist/node.js"
+      },
+      "browser": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      },
+      "default": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js"
+      }
+    },
+    "./node": {
+      "source": "./src/node.ts",
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
+    }
+  },
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "pngjs": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/pngjs": "^6.0.5"
+  },
+  "keywords": [
+    "three-flatland",
+    "bake",
+    "cli"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thejustinwalsh/three-flatland.git",
+    "directory": "packages/bake"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}