@forgeax/engine-font 0.1.2

package/dist/cli-font.d.ts

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { type GlyphMetric } from '@forgeax/engine-types';
+/**
+ * Minimal subset of the @zappar/msdf-generator glyph record consumed by the
+ * bake. Mirrors the package's `GlyphInfo` (dist/index.d.ts) -- only the fields
+ * the BMFont -> FontAsset mapping needs (toolchain wiki section 4).
+ */
+export interface BakeGlyph {
+    readonly unicode: number;
+    readonly advance: number;
+    readonly xoffset: number;
+    readonly yoffset: number;
+    readonly atlasPosition: readonly [number, number];
+    readonly atlasSize: readonly [number, number];
+}
+/**
+ * Minimal subset of the @zappar/msdf-generator `MSDFAtlas` consumed by the
+ * bake. `texture` carries the RGBA pixel buffer + dimensions (the package's
+ * `ImageData`-shaped texture, but reduced to POD so the bake stays
+ * environment-agnostic for testing).
+ */
+export interface BakeAtlas {
+    readonly texture: {
+        readonly width: number;
+        readonly height: number;
+        readonly data: Uint8Array;
+    };
+    readonly glyphs: readonly BakeGlyph[];
+    readonly metrics: {
+        readonly lineHeight: number;
+        readonly ascender: number;
+    };
+    readonly textureSize: readonly [number, number];
+    readonly fieldRange: number;
+}
+/**
+ * The bake-time MSDF generator contract. Injected into {@link bakeFont} so
+ * unit tests can supply a mock (real path: `@zappar/msdf-generator`'s `MSDF`).
+ */
+export interface MsdfGenerator {
+    generateAtlas(ttf: Uint8Array): Promise<BakeAtlas>;
+    dispose(): Promise<void>;
+}
+/**
+ * Bake-time sidecar JSON shape (importer: 'font'). Carries the glyph metrics
+ * (BMFont -> FontAsset mapping, toolchain wiki section 4) + the common block
+ * (distanceRange / atlas dimensions). Parsed by the runtime font load path.
+ */
+export interface BakeSidecar {
+    readonly schemaVersion: string;
+    readonly kind: 'external-asset-package';
+    readonly importer: 'font';
+    readonly source: string;
+    readonly importSettings: {
+        readonly colorSpace: 'linear';
+        readonly mipmap: 'none';
+    };
+    readonly common: {
+        readonly lineHeight: number;
+        readonly base: number;
+        readonly distanceRange: number;
+        readonly pxRange: number;
+        readonly atlasWidth: number;
+        readonly atlasHeight: number;
+    };
+    readonly glyphs: Record<number, GlyphMetric>;
+}
+/**
+ * Encode an RGBA pixel buffer into a PNG (zlib deflate, no external deps).
+ * The atlas texture from @zappar is RGBA8; this writes a standard 8-bit
+ * RGBA PNG so any consumer (engine image importer / browser) can decode it.
+ */
+export declare function encodePng(width: number, height: number, rgba: Uint8Array): Uint8Array;
+/** Map a @zappar atlas into the FontAsset glyph-metrics sidecar shape. */
+export declare function atlasToSidecar(atlas: BakeAtlas, sourcePng: string): BakeSidecar;
+/** Result of a successful bake -- the written artefact paths. */
+export interface BakeResult {
+    readonly atlasPath: string;
+    readonly sidecarPath: string;
+}
+/**
+ * Bake an MSDF atlas + glyph-metrics sidecar from a TTF.
+ *
+ * @param ttfPath path to the TrueType source.
+ * @param outDir output directory (created if missing).
+ * @param generatorFactory yields the MSDF generator (real: @zappar; tests: mock).
+ * @returns `Result`-style: throws a {@link FontError} on every failure mode
+ *   (unsupported-font-format before the generator runs; bake-failed when the
+ *   generator throws). The CLI layer maps the thrown FontError to a structured
+ *   stderr line + exit code 1 -- never a silent exit 0 without artefacts
+ *   (charter P3).
+ */
+export declare function bakeFont(ttfPath: string, outDir: string, generatorFactory: () => Promise<MsdfGenerator>): Promise<BakeResult>;
+export declare function realGeneratorFactory(): Promise<MsdfGenerator>;
+export declare function runCliFont(argv: string[]): Promise<number>;
+//# sourceMappingURL=cli-font.d.ts.map

package/dist/cli-font.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-font.d.ts","sourceRoot":"","sources":["../src/cli-font.ts"],"names":[],"mappings":"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"}

package/dist/cli-font.mjs

@@ -0,0 +1,465 @@
+#!/usr/bin/env node
+import { Buffer } from 'buffer';
+import { realpath, readFile, mkdir, writeFile } from 'fs/promises';
+import { basename, extname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { parseArgs } from 'util';
+import { deflateSync } from 'zlib';
+import { FontError } from '@forgeax/engine-types';
+import { Worker } from 'worker_threads';
+
+var NodeWorkerAdapter = class {
+  worker;
+  listeners = /* @__PURE__ */ new Map();
+  constructor(url) {
+    this.worker = new Worker(url);
+  }
+  postMessage(message, transferList = []) {
+    this.worker.postMessage(message, [...transferList]);
+  }
+  addEventListener(type, listener) {
+    if (type !== "message") return;
+    const handler = (data) => listener({ data, origin: "*" });
+    this.listeners.set(listener, handler);
+    this.worker.on("message", handler);
+  }
+  removeEventListener(type, listener) {
+    if (type !== "message") return;
+    const handler = this.listeners.get(listener);
+    if (handler === void 0) return;
+    this.listeners.delete(listener);
+    this.worker.off("message", handler);
+  }
+  terminate() {
+    return this.worker.terminate();
+  }
+};
+
+// src/cli-font.ts
+var DEFAULT_CHARSET = (() => {
+  let s = "";
+  for (let c = 32; c <= 126; c++) s += String.fromCharCode(c);
+  return s;
+})();
+var DEFAULT_TEXTURE_SIZE = 1024;
+var DEFAULT_FIELD_RANGE = 4;
+var DEFAULT_FONT_SIZE = 48;
+function isSupportedFontMagic(bytes) {
+  if (bytes.length < 4) return false;
+  const b0 = bytes[0] ?? 0;
+  const b1 = bytes[1] ?? 0;
+  const b2 = bytes[2] ?? 0;
+  const b3 = bytes[3] ?? 0;
+  const isTrueType = b0 === 0 && b1 === 1 && b2 === 0 && b3 === 0;
+  const isTrue = b0 === 116 && b1 === 114 && b2 === 117 && b3 === 101;
+  const isOtto = b0 === 79 && b1 === 84 && b2 === 84 && b3 === 79;
+  return isTrueType || isTrue || isOtto;
+}
+function crc32(bytes) {
+  let crc = 4294967295;
+  for (let i = 0; i < bytes.length; i++) {
+    crc ^= bytes[i] ?? 0;
+    for (let k = 0; k < 8; k++) {
+      crc = crc & 1 ? crc >>> 1 ^ 3988292384 : crc >>> 1;
+    }
+  }
+  return (crc ^ 4294967295) >>> 0;
+}
+function pngChunk(type, data) {
+  const typeBytes = new Uint8Array([
+    type.charCodeAt(0),
+    type.charCodeAt(1),
+    type.charCodeAt(2),
+    type.charCodeAt(3)
+  ]);
+  const body = new Uint8Array(typeBytes.length + data.length);
+  body.set(typeBytes, 0);
+  body.set(data, typeBytes.length);
+  const out = new Uint8Array(4 + body.length + 4);
+  const dv = new DataView(out.buffer);
+  dv.setUint32(0, data.length);
+  out.set(body, 4);
+  dv.setUint32(4 + body.length, crc32(body));
+  return out;
+}
+function encodePng(width, height, rgba) {
+  const stride = width * 4;
+  const raw = new Uint8Array((stride + 1) * height);
+  for (let y = 0; y < height; y++) {
+    raw[y * (stride + 1)] = 0;
+    raw.set(rgba.subarray(y * stride, y * stride + stride), y * (stride + 1) + 1);
+  }
+  const idat = deflateSync(raw);
+  const ihdr = new Uint8Array(13);
+  const dv = new DataView(ihdr.buffer);
+  dv.setUint32(0, width);
+  dv.setUint32(4, height);
+  ihdr[8] = 8;
+  ihdr[9] = 6;
+  ihdr[10] = 0;
+  ihdr[11] = 0;
+  ihdr[12] = 0;
+  const signature = new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]);
+  const chunks = [
+    signature,
+    pngChunk("IHDR", ihdr),
+    pngChunk("IDAT", new Uint8Array(idat)),
+    pngChunk("IEND", new Uint8Array(0))
+  ];
+  const total = chunks.reduce((n, c) => n + c.length, 0);
+  const out = new Uint8Array(total);
+  let off = 0;
+  for (const c of chunks) {
+    out.set(c, off);
+    off += c.length;
+  }
+  return out;
+}
+function atlasToSidecar(atlas, sourcePng) {
+  const glyphs = {};
+  for (const g of atlas.glyphs) {
+    glyphs[g.unicode] = {
+      advance: g.advance,
+      bearingX: g.xoffset,
+      bearingY: g.yoffset,
+      size: { w: g.atlasSize[0], h: g.atlasSize[1] },
+      region: {
+        x: g.atlasPosition[0],
+        y: g.atlasPosition[1],
+        w: g.atlasSize[0],
+        h: g.atlasSize[1]
+      }
+    };
+  }
+  return {
+    schemaVersion: "1.0.0",
+    kind: "external-asset-package",
+    importer: "font",
+    source: sourcePng,
+    importSettings: { colorSpace: "linear", mipmap: "none" },
+    common: {
+      lineHeight: atlas.metrics.lineHeight,
+      base: atlas.metrics.ascender,
+      distanceRange: atlas.fieldRange,
+      pxRange: atlas.fieldRange,
+      atlasWidth: atlas.textureSize[0],
+      atlasHeight: atlas.textureSize[1]
+    },
+    glyphs
+  };
+}
+function malformedAtlasTextureCause(atlas) {
+  const texture = atlas.texture;
+  const textureSize = atlas.textureSize;
+  if (!Number.isSafeInteger(texture.width) || texture.width <= 0 || !Number.isSafeInteger(texture.height) || texture.height <= 0) {
+    return "malformed-atlas: texture dimensions must be positive finite integers";
+  }
+  if (!Number.isSafeInteger(textureSize[0]) || textureSize[0] <= 0 || !Number.isSafeInteger(textureSize[1]) || textureSize[1] <= 0) {
+    return "malformed-atlas: textureSize dimensions must be positive finite integers";
+  }
+  if (texture.width !== textureSize[0] || texture.height !== textureSize[1]) {
+    return "malformed-atlas: texture dimensions must match textureSize";
+  }
+  const expectedBytes = texture.width * texture.height * 4;
+  if (!(texture.data instanceof Uint8Array) || texture.data.length !== expectedBytes) {
+    return "malformed-atlas: RGBA data length must equal width * height * 4";
+  }
+  return void 0;
+}
+function malformedGlyphCause(atlas) {
+  if (!Number.isFinite(atlas.metrics.lineHeight) || !Number.isFinite(atlas.metrics.ascender) || !Number.isFinite(atlas.fieldRange)) {
+    return "malformed-glyph: common metrics must be finite";
+  }
+  const [atlasWidth, atlasHeight] = atlas.textureSize;
+  const seenUnicode = /* @__PURE__ */ new Set();
+  for (let index = 0; index < atlas.glyphs.length; index += 1) {
+    const glyph = atlas.glyphs[index];
+    if (glyph === void 0) {
+      return `malformed-glyph: missing glyph record at index ${index}`;
+    }
+    if (!Number.isSafeInteger(glyph.unicode) || glyph.unicode < 0 || glyph.unicode > 1114111) {
+      return `malformed-glyph: invalid unicode identity at index ${index}`;
+    }
+    if (seenUnicode.has(glyph.unicode)) {
+      return `malformed-glyph: duplicate unicode identity at index ${index}`;
+    }
+    seenUnicode.add(glyph.unicode);
+    if (!Number.isFinite(glyph.advance) || !Number.isFinite(glyph.xoffset) || !Number.isFinite(glyph.yoffset)) {
+      return `malformed-glyph: non-finite metrics at index ${index}`;
+    }
+    const [x, y] = glyph.atlasPosition;
+    const [width, height] = glyph.atlasSize;
+    if (!Number.isSafeInteger(x) || !Number.isSafeInteger(y) || !Number.isSafeInteger(width) || !Number.isSafeInteger(height) || x < 0 || y < 0 || width < 0 || height < 0 || x + width > atlasWidth || y + height > atlasHeight) {
+      return `malformed-glyph: atlas region out of bounds at index ${index}`;
+    }
+  }
+  return void 0;
+}
+async function bakeFont(ttfPath, outDir, generatorFactory) {
+  let ttf;
+  try {
+    ttf = await readFile(ttfPath);
+  } catch (e) {
+    throw new FontError({
+      code: "bake-failed",
+      expected: "a readable TrueType source file",
+      hint: "repair the source path or filesystem access, then retry the bake",
+      detail: { path: ttfPath, cause: e instanceof Error ? e.message : String(e) }
+    });
+  }
+  const ttfBytes = new Uint8Array(ttf.buffer, ttf.byteOffset, ttf.byteLength);
+  if (!isSupportedFontMagic(ttfBytes)) {
+    throw new FontError({
+      code: "unsupported-font-format",
+      expected: "ttf",
+      hint: 'bake accepts TrueType (.ttf / 0x00010000 / "true") or OpenType-TTF ("OTTO") sources; WOFF / WOFF2 / other formats are not supported -- convert to TTF first',
+      detail: { path: ttfPath }
+    });
+  }
+  try {
+    await mkdir(outDir, { recursive: true });
+  } catch (e) {
+    throw new FontError({
+      code: "bake-failed",
+      expected: "a writable output directory",
+      hint: "repair the output path or filesystem access, then retry the bake",
+      detail: { path: outDir, cause: e instanceof Error ? e.message : String(e) }
+    });
+  }
+  let atlas;
+  let generator;
+  let primaryFailure;
+  let primaryFailed = false;
+  let disposeFailure;
+  let disposeFailed = false;
+  try {
+    generator = await generatorFactory();
+    atlas = await generator.generateAtlas(ttfBytes);
+  } catch (e) {
+    primaryFailed = true;
+    primaryFailure = e;
+  } finally {
+    if (generator !== void 0) {
+      try {
+        await generator.dispose();
+      } catch (e) {
+        disposeFailed = true;
+        disposeFailure = e;
+      }
+    }
+  }
+  if (primaryFailed) {
+    throw new FontError({
+      code: "bake-failed",
+      expected: "@zappar/msdf-generator to produce an MSDF atlas",
+      hint: 'the MSDF generator threw -- a Web Worker + wasm host is required (a plain Node process reports "Worker is not defined"); run the bake in a Worker-capable environment',
+      detail: {
+        cause: primaryFailure instanceof Error ? primaryFailure.message : String(primaryFailure)
+      }
+    });
+  }
+  if (disposeFailed) {
+    throw new FontError({
+      code: "bake-failed",
+      expected: "the MSDF generator to dispose cleanly",
+      hint: "repair the MSDF generator lifecycle, then retry the bake",
+      detail: {
+        cause: disposeFailure instanceof Error ? disposeFailure.message : String(disposeFailure)
+      }
+    });
+  }
+  if (atlas === void 0) {
+    throw new FontError({
+      code: "bake-failed",
+      expected: "@zappar/msdf-generator to produce an MSDF atlas",
+      hint: "repair the MSDF generator lifecycle, then retry the bake",
+      detail: { cause: "the MSDF generator produced no atlas" }
+    });
+  }
+  const base = basename(ttfPath, extname(ttfPath));
+  const atlasName = `${base}.atlas.png`;
+  const atlasPath = join(outDir, atlasName);
+  const sidecarPath = join(outDir, `${base}.meta.json`);
+  const malformedCause = malformedAtlasTextureCause(atlas) ?? malformedGlyphCause(atlas);
+  if (malformedCause !== void 0) {
+    throw new FontError({
+      code: "bake-failed",
+      expected: "a valid MSDF atlas texture and glyph metrics",
+      hint: "repair the MSDF generator atlas and glyph output, then retry the bake",
+      detail: { cause: malformedCause }
+    });
+  }
+  const png = encodePng(atlas.texture.width, atlas.texture.height, atlas.texture.data);
+  try {
+    await writeFile(atlasPath, png);
+  } catch (e) {
+    throw new FontError({
+      code: "bake-failed",
+      expected: "a writable atlas output path",
+      hint: "repair the atlas output path or filesystem access, then retry the bake",
+      detail: { path: atlasPath, cause: e instanceof Error ? e.message : String(e) }
+    });
+  }
+  const sidecar = atlasToSidecar(atlas, atlasName);
+  try {
+    await writeFile(sidecarPath, `${JSON.stringify(sidecar, null, 2)}
+`);
+  } catch (e) {
+    throw new FontError({
+      code: "bake-failed",
+      expected: "a writable sidecar output path",
+      hint: "repair the sidecar output path or filesystem access, then retry the bake",
+      detail: { path: sidecarPath, cause: e instanceof Error ? e.message : String(e) }
+    });
+  }
+  return { atlasPath, sidecarPath };
+}
+async function realGeneratorFactory() {
+  const mod = await import('@zappar/msdf-generator');
+  const wasmModuleUrl = import.meta.resolve("@zappar/msdf-generator/msdfgen_wasm.wasm");
+  const wasmBytes = await readFile(new URL(wasmModuleUrl));
+  const wasmUrl = `data:application/octet-stream;base64,${Buffer.from(wasmBytes).toString("base64")}`;
+  const nodeGlobal = globalThis;
+  const previousWorker = nodeGlobal.Worker;
+  nodeGlobal.Worker = NodeWorkerAdapter;
+  let msdf;
+  try {
+    msdf = new mod.MSDF({
+      workerUrl: new URL("./node-msdf-worker.mjs", import.meta.url),
+      wasmUrl
+    });
+    await msdf.initialize();
+  } finally {
+    if (previousWorker === void 0) {
+      delete nodeGlobal.Worker;
+    } else {
+      nodeGlobal.Worker = previousWorker;
+    }
+  }
+  if (msdf === void 0) {
+    throw new Error("the MSDF generator did not initialize");
+  }
+  return {
+    async generateAtlas(ttf) {
+      const a = await msdf.generateAtlas({
+        font: ttf,
+        charset: DEFAULT_CHARSET,
+        textureSize: [DEFAULT_TEXTURE_SIZE, DEFAULT_TEXTURE_SIZE],
+        fieldRange: DEFAULT_FIELD_RANGE,
+        fontSize: DEFAULT_FONT_SIZE
+      });
+      return {
+        texture: {
+          width: a.texture.width,
+          height: a.texture.height,
+          data: new Uint8Array(a.texture.data)
+        },
+        glyphs: a.glyphs.map((g) => ({
+          unicode: g.unicode,
+          advance: g.advance,
+          xoffset: g.xoffset,
+          yoffset: g.yoffset,
+          atlasPosition: [g.atlasPosition[0], g.atlasPosition[1]],
+          atlasSize: [g.atlasSize[0], g.atlasSize[1]]
+        })),
+        metrics: { lineHeight: a.metrics.lineHeight, ascender: a.metrics.ascender },
+        textureSize: [a.textureSize[0], a.textureSize[1]],
+        fieldRange: a.fieldRange
+      };
+    },
+    async dispose() {
+      await msdf.dispose();
+    }
+  };
+}
+function bakeHelpBody() {
+  return [
+    "forgeax-engine-remote-font bake \u2014 bake MSDF font atlas from TTF",
+    "",
+    "Usage:",
+    "  forgeax-engine-remote-font bake <ttf> <out>",
+    "",
+    "Reads a TrueType font file and produces:",
+    `  <out>/<basename>.atlas.png   \u2014 ${DEFAULT_TEXTURE_SIZE}x${DEFAULT_TEXTURE_SIZE} MSDF atlas`,
+    "  <out>/<basename>.meta.json   \u2014 glyph metrics sidecar (importer: font)",
+    ""
+  ].join("\n");
+}
+function helpBody() {
+  return [
+    "forgeax-engine-remote-font \u2014 MSDF font atlas baking",
+    "",
+    "Usage:",
+    "  forgeax-engine-remote-font bake <ttf> <out>",
+    ""
+  ].join("\n");
+}
+async function runCliFont(argv) {
+  const [sub, ...rest] = argv;
+  if (sub === void 0 || sub === "--help" || sub === "-h") {
+    process.stdout.write(`${helpBody()}
+`);
+    return 0;
+  }
+  if (sub !== "bake") {
+    process.stderr.write(`unknown subcommand: ${sub}
+`);
+    return 1;
+  }
+  return runBake(rest);
+}
+async function runBake(rest) {
+  if (rest[0] === "--help" || rest[0] === "-h") {
+    process.stdout.write(`${bakeHelpBody()}
+`);
+    return 0;
+  }
+  let positionals;
+  try {
+    const parsed = parseArgs({ args: rest, allowPositionals: true, strict: true });
+    positionals = [...parsed.positionals];
+  } catch {
+    process.stderr.write("error parsing CLI args\n");
+    return 1;
+  }
+  const ttfPath = positionals[0];
+  const outDir = positionals[1];
+  if (ttfPath === void 0 || outDir === void 0) {
+    process.stderr.write("usage: forgeax-engine-remote-font bake <ttf> <out>\n");
+    return 1;
+  }
+  try {
+    const result = await bakeFont(ttfPath, outDir, realGeneratorFactory);
+    process.stdout.write(`baked ${result.atlasPath} + ${result.sidecarPath}
+`);
+    return 0;
+  } catch (e) {
+    if (e instanceof FontError) {
+      process.stderr.write(
+        `${JSON.stringify({ code: e.code, expected: e.expected, hint: e.hint, detail: e.detail })}
+`
+      );
+      return 1;
+    }
+    process.stderr.write(`bake failed: ${e instanceof Error ? e.message : String(e)}
+`);
+    return 1;
+  }
+}
+var isBinEntry = await (async () => {
+  const argv1 = process.argv[1];
+  if (typeof argv1 !== "string") return false;
+  const argv1Real = await realpath(argv1).catch(() => argv1);
+  const selfReal = await realpath(fileURLToPath(import.meta.url)).catch(
+    () => fileURLToPath(import.meta.url)
+  );
+  return argv1Real === selfReal;
+})();
+if (isBinEntry) {
+  const exitCode = await runCliFont(process.argv.slice(2));
+  process.exit(exitCode);
+}
+
+export { atlasToSidecar, bakeFont, encodePng, realGeneratorFactory, runCliFont };
+//# sourceMappingURL=cli-font.mjs.map
+//# sourceMappingURL=cli-font.mjs.map

package/dist/cli-font.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node-worker-adapter.ts","../src/cli-font.ts"],"names":[],"mappings":"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","file":"cli-font.mjs","sourcesContent":["import { Worker } from 'node:worker_threads';\n\ninterface MessageEventLike {\n  readonly data: unknown;\n  readonly origin: string;\n}\n\ntype MessageListener = (event: MessageEventLike) => void;\n\n/** Comlink's browser Worker-shaped endpoint backed by a Node worker thread. */\nexport class NodeWorkerAdapter {\n  private readonly worker: Worker;\n  private readonly listeners = new Map<MessageListener, (data: unknown) => void>();\n\n  public constructor(url: string | URL) {\n    this.worker = new Worker(url);\n  }\n\n  public postMessage(message: unknown, transferList: readonly ArrayBuffer[] = []): void {\n    this.worker.postMessage(message, [...transferList]);\n  }\n\n  public addEventListener(type: string, listener: MessageListener): void {\n    if (type !== 'message') return;\n    const handler = (data: unknown) => listener({ data, origin: '*' });\n    this.listeners.set(listener, handler);\n    this.worker.on('message', handler);\n  }\n\n  public removeEventListener(type: string, listener: MessageListener): void {\n    if (type !== 'message') return;\n    const handler = this.listeners.get(listener);\n    if (handler === undefined) return;\n    this.listeners.delete(listener);\n    this.worker.off('message', handler);\n  }\n\n  public terminate(): Promise<number> {\n    return this.worker.terminate();\n  }\n}\n","#!/usr/bin/env node\n\n// @forgeax/engine-font/src/cli-font — `forgeax-engine-remote-font` plugin\n// bin. Discovered by the base bin via the kubectl 4th-path\n// `forgeax-engine-remote-` prefix scanner.\n//\n// `bake <ttf> <out>` reads a TrueType font and produces an MSDF atlas PNG +\n// a glyph-metrics sidecar JSON (importer: 'font'). The real bake calls\n// @zappar/msdf-generator (feat-20260531-world-space-msdf-text-rendering M5 /\n// w28 -- replaces the M1 placeholder).\n//\n// Error model (FontErrorCode, structured to stderr, exit code 1):\n//   - non-TTF magic (not 0x00010000 / 'true' / 'OTTO') -> 'unsupported-font-format'\n//     (AC-15 / plan-strategy D-11). The check runs BEFORE the generator so a\n//     bad format never reaches the wasm path.\n//   - @zappar/msdf-generator throws (wasm / Worker unavailable, internal error)\n//     -> 'bake-failed' (charter P3: explicit failure, never a silent exit-0\n//     no-atlas). In a plain Node CI without a Web Worker the generator throws\n//     'Worker is not defined' and the bake reports 'bake-failed' (exit 1) --\n//     the best-effort real run requires a Worker + wasm host.\n\nimport { Buffer } from 'node:buffer';\nimport { mkdir, readFile, realpath, writeFile } from 'node:fs/promises';\nimport { basename, extname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { parseArgs } from 'node:util';\nimport { deflateSync } from 'node:zlib';\nimport { FontError, type GlyphMetric } from '@forgeax/engine-types';\nimport { NodeWorkerAdapter } from './node-worker-adapter.js';\n\n/**\n * Minimal subset of the @zappar/msdf-generator glyph record consumed by the\n * bake. Mirrors the package's `GlyphInfo` (dist/index.d.ts) -- only the fields\n * the BMFont -> FontAsset mapping needs (toolchain wiki section 4).\n */\nexport interface BakeGlyph {\n  readonly unicode: number;\n  readonly advance: number;\n  readonly xoffset: number;\n  readonly yoffset: number;\n  readonly atlasPosition: readonly [number, number];\n  readonly atlasSize: readonly [number, number];\n}\n\n/**\n * Minimal subset of the @zappar/msdf-generator `MSDFAtlas` consumed by the\n * bake. `texture` carries the RGBA pixel buffer + dimensions (the package's\n * `ImageData`-shaped texture, but reduced to POD so the bake stays\n * environment-agnostic for testing).\n */\nexport interface BakeAtlas {\n  readonly texture: { readonly width: number; readonly height: number; readonly data: Uint8Array };\n  readonly glyphs: readonly BakeGlyph[];\n  readonly metrics: { readonly lineHeight: number; readonly ascender: number };\n  readonly textureSize: readonly [number, number];\n  readonly fieldRange: number;\n}\n\n/**\n * The bake-time MSDF generator contract. Injected into {@link bakeFont} so\n * unit tests can supply a mock (real path: `@zappar/msdf-generator`'s `MSDF`).\n */\nexport interface MsdfGenerator {\n  generateAtlas(ttf: Uint8Array): Promise<BakeAtlas>;\n  dispose(): Promise<void>;\n}\n\n/** Default charset baked into the atlas (printable ASCII). */\nconst DEFAULT_CHARSET = (() => {\n  let s = '';\n  for (let c = 0x20; c <= 0x7e; c++) s += String.fromCharCode(c);\n  return s;\n})();\n\nconst DEFAULT_TEXTURE_SIZE = 1024;\nconst DEFAULT_FIELD_RANGE = 4;\nconst DEFAULT_FONT_SIZE = 48;\n\n/**\n * Bake-time sidecar JSON shape (importer: 'font'). Carries the glyph metrics\n * (BMFont -> FontAsset mapping, toolchain wiki section 4) + the common block\n * (distanceRange / atlas dimensions). Parsed by the runtime font load path.\n */\nexport interface BakeSidecar {\n  readonly schemaVersion: string;\n  readonly kind: 'external-asset-package';\n  readonly importer: 'font';\n  readonly source: string;\n  readonly importSettings: { readonly colorSpace: 'linear'; readonly mipmap: 'none' };\n  readonly common: {\n    readonly lineHeight: number;\n    readonly base: number;\n    readonly distanceRange: number;\n    readonly pxRange: number;\n    readonly atlasWidth: number;\n    readonly atlasHeight: number;\n  };\n  readonly glyphs: Record<number, GlyphMetric>;\n}\n\n/** TTF / OTF magic numbers (first 4 bytes). Per the OpenType spec. */\nfunction isSupportedFontMagic(bytes: Uint8Array): boolean {\n  if (bytes.length < 4) return false;\n  const b0 = bytes[0] ?? 0;\n  const b1 = bytes[1] ?? 0;\n  const b2 = bytes[2] ?? 0;\n  const b3 = bytes[3] ?? 0;\n  // 0x00010000 = TrueType outlines; 'true' (0x74727565) = legacy Apple TTF;\n  // 'OTTO' (0x4f54544f) = OpenType with CFF outlines. WOFF/WOFF2 ('wOFF' /\n  // 'wOF2') are rejected as non-TTF per AC-15.\n  const isTrueType = b0 === 0x00 && b1 === 0x01 && b2 === 0x00 && b3 === 0x00;\n  const isTrue = b0 === 0x74 && b1 === 0x72 && b2 === 0x75 && b3 === 0x65;\n  const isOtto = b0 === 0x4f && b1 === 0x54 && b2 === 0x54 && b3 === 0x4f;\n  return isTrueType || isTrue || isOtto;\n}\n\n/** CRC-32 (PNG / zlib polynomial) over a byte slice. */\nfunction crc32(bytes: Uint8Array): number {\n  let crc = 0xffffffff;\n  for (let i = 0; i < bytes.length; i++) {\n    crc ^= bytes[i] ?? 0;\n    for (let k = 0; k < 8; k++) {\n      crc = crc & 1 ? (crc >>> 1) ^ 0xedb88320 : crc >>> 1;\n    }\n  }\n  return (crc ^ 0xffffffff) >>> 0;\n}\n\nfunction pngChunk(type: string, data: Uint8Array): Uint8Array {\n  const typeBytes = new Uint8Array([\n    type.charCodeAt(0),\n    type.charCodeAt(1),\n    type.charCodeAt(2),\n    type.charCodeAt(3),\n  ]);\n  const body = new Uint8Array(typeBytes.length + data.length);\n  body.set(typeBytes, 0);\n  body.set(data, typeBytes.length);\n  const out = new Uint8Array(4 + body.length + 4);\n  const dv = new DataView(out.buffer);\n  dv.setUint32(0, data.length);\n  out.set(body, 4);\n  dv.setUint32(4 + body.length, crc32(body));\n  return out;\n}\n\n/**\n * Encode an RGBA pixel buffer into a PNG (zlib deflate, no external deps).\n * The atlas texture from @zappar is RGBA8; this writes a standard 8-bit\n * RGBA PNG so any consumer (engine image importer / browser) can decode it.\n */\nexport function encodePng(width: number, height: number, rgba: Uint8Array): Uint8Array {\n  // Filter byte 0 (None) prefixes each scanline.\n  const stride = width * 4;\n  const raw = new Uint8Array((stride + 1) * height);\n  for (let y = 0; y < height; y++) {\n    raw[y * (stride + 1)] = 0;\n    raw.set(rgba.subarray(y * stride, y * stride + stride), y * (stride + 1) + 1);\n  }\n  const idat = deflateSync(raw);\n  const ihdr = new Uint8Array(13);\n  const dv = new DataView(ihdr.buffer);\n  dv.setUint32(0, width);\n  dv.setUint32(4, height);\n  ihdr[8] = 8; // bit depth\n  ihdr[9] = 6; // color type RGBA\n  ihdr[10] = 0; // compression\n  ihdr[11] = 0; // filter\n  ihdr[12] = 0; // interlace\n  const signature = new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);\n  const chunks = [\n    signature,\n    pngChunk('IHDR', ihdr),\n    pngChunk('IDAT', new Uint8Array(idat)),\n    pngChunk('IEND', new Uint8Array(0)),\n  ];\n  const total = chunks.reduce((n, c) => n + c.length, 0);\n  const out = new Uint8Array(total);\n  let off = 0;\n  for (const c of chunks) {\n    out.set(c, off);\n    off += c.length;\n  }\n  return out;\n}\n\n/** Map a @zappar atlas into the FontAsset glyph-metrics sidecar shape. */\nexport function atlasToSidecar(atlas: BakeAtlas, sourcePng: string): BakeSidecar {\n  const glyphs: Record<number, GlyphMetric> = {};\n  for (const g of atlas.glyphs) {\n    glyphs[g.unicode] = {\n      advance: g.advance,\n      bearingX: g.xoffset,\n      bearingY: g.yoffset,\n      size: { w: g.atlasSize[0], h: g.atlasSize[1] },\n      region: {\n        x: g.atlasPosition[0],\n        y: g.atlasPosition[1],\n        w: g.atlasSize[0],\n        h: g.atlasSize[1],\n      },\n    };\n  }\n  return {\n    schemaVersion: '1.0.0',\n    kind: 'external-asset-package',\n    importer: 'font',\n    source: sourcePng,\n    importSettings: { colorSpace: 'linear', mipmap: 'none' },\n    common: {\n      lineHeight: atlas.metrics.lineHeight,\n      base: atlas.metrics.ascender,\n      distanceRange: atlas.fieldRange,\n      pxRange: atlas.fieldRange,\n      atlasWidth: atlas.textureSize[0],\n      atlasHeight: atlas.textureSize[1],\n    },\n    glyphs,\n  };\n}\n\n/** Result of a successful bake -- the written artefact paths. */\nexport interface BakeResult {\n  readonly atlasPath: string;\n  readonly sidecarPath: string;\n}\n\nfunction malformedAtlasTextureCause(atlas: BakeAtlas): string | undefined {\n  const texture = atlas.texture;\n  const textureSize = atlas.textureSize;\n  if (\n    !Number.isSafeInteger(texture.width) ||\n    texture.width <= 0 ||\n    !Number.isSafeInteger(texture.height) ||\n    texture.height <= 0\n  ) {\n    return 'malformed-atlas: texture dimensions must be positive finite integers';\n  }\n  if (\n    !Number.isSafeInteger(textureSize[0]) ||\n    textureSize[0] <= 0 ||\n    !Number.isSafeInteger(textureSize[1]) ||\n    textureSize[1] <= 0\n  ) {\n    return 'malformed-atlas: textureSize dimensions must be positive finite integers';\n  }\n  if (texture.width !== textureSize[0] || texture.height !== textureSize[1]) {\n    return 'malformed-atlas: texture dimensions must match textureSize';\n  }\n  const expectedBytes = texture.width * texture.height * 4;\n  if (!(texture.data instanceof Uint8Array) || texture.data.length !== expectedBytes) {\n    return 'malformed-atlas: RGBA data length must equal width * height * 4';\n  }\n  return undefined;\n}\n\nfunction malformedGlyphCause(atlas: BakeAtlas): string | undefined {\n  if (\n    !Number.isFinite(atlas.metrics.lineHeight) ||\n    !Number.isFinite(atlas.metrics.ascender) ||\n    !Number.isFinite(atlas.fieldRange)\n  ) {\n    return 'malformed-glyph: common metrics must be finite';\n  }\n\n  const [atlasWidth, atlasHeight] = atlas.textureSize;\n  const seenUnicode = new Set<number>();\n  for (let index = 0; index < atlas.glyphs.length; index += 1) {\n    const glyph = atlas.glyphs[index];\n    if (glyph === undefined) {\n      return `malformed-glyph: missing glyph record at index ${index}`;\n    }\n    if (!Number.isSafeInteger(glyph.unicode) || glyph.unicode < 0 || glyph.unicode > 0x10ffff) {\n      return `malformed-glyph: invalid unicode identity at index ${index}`;\n    }\n    if (seenUnicode.has(glyph.unicode)) {\n      return `malformed-glyph: duplicate unicode identity at index ${index}`;\n    }\n    seenUnicode.add(glyph.unicode);\n\n    if (\n      !Number.isFinite(glyph.advance) ||\n      !Number.isFinite(glyph.xoffset) ||\n      !Number.isFinite(glyph.yoffset)\n    ) {\n      return `malformed-glyph: non-finite metrics at index ${index}`;\n    }\n\n    const [x, y] = glyph.atlasPosition;\n    const [width, height] = glyph.atlasSize;\n    if (\n      !Number.isSafeInteger(x) ||\n      !Number.isSafeInteger(y) ||\n      !Number.isSafeInteger(width) ||\n      !Number.isSafeInteger(height) ||\n      x < 0 ||\n      y < 0 ||\n      width < 0 ||\n      height < 0 ||\n      x + width > atlasWidth ||\n      y + height > atlasHeight\n    ) {\n      return `malformed-glyph: atlas region out of bounds at index ${index}`;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Bake an MSDF atlas + glyph-metrics sidecar from a TTF.\n *\n * @param ttfPath path to the TrueType source.\n * @param outDir output directory (created if missing).\n * @param generatorFactory yields the MSDF generator (real: @zappar; tests: mock).\n * @returns `Result`-style: throws a {@link FontError} on every failure mode\n *   (unsupported-font-format before the generator runs; bake-failed when the\n *   generator throws). The CLI layer maps the thrown FontError to a structured\n *   stderr line + exit code 1 -- never a silent exit 0 without artefacts\n *   (charter P3).\n */\nexport async function bakeFont(\n  ttfPath: string,\n  outDir: string,\n  generatorFactory: () => Promise<MsdfGenerator>,\n): Promise<BakeResult> {\n  let ttf: Buffer;\n  try {\n    ttf = await readFile(ttfPath);\n  } catch (e) {\n    throw new FontError({\n      code: 'bake-failed',\n      expected: 'a readable TrueType source file',\n      hint: 'repair the source path or filesystem access, then retry the bake',\n      detail: { path: ttfPath, cause: e instanceof Error ? e.message : String(e) },\n    });\n  }\n  const ttfBytes = new Uint8Array(ttf.buffer, ttf.byteOffset, ttf.byteLength);\n  if (!isSupportedFontMagic(ttfBytes)) {\n    throw new FontError({\n      code: 'unsupported-font-format',\n      expected: 'ttf',\n      hint: 'bake accepts TrueType (.ttf / 0x00010000 / \"true\") or OpenType-TTF (\"OTTO\") sources; WOFF / WOFF2 / other formats are not supported -- convert to TTF first',\n      detail: { path: ttfPath },\n    });\n  }\n\n  try {\n    await mkdir(outDir, { recursive: true });\n  } catch (e) {\n    throw new FontError({\n      code: 'bake-failed',\n      expected: 'a writable output directory',\n      hint: 'repair the output path or filesystem access, then retry the bake',\n      detail: { path: outDir, cause: e instanceof Error ? e.message : String(e) },\n    });\n  }\n\n  let atlas: BakeAtlas | undefined;\n  let generator: MsdfGenerator | undefined;\n  let primaryFailure: unknown;\n  let primaryFailed = false;\n  let disposeFailure: unknown;\n  let disposeFailed = false;\n  try {\n    generator = await generatorFactory();\n    atlas = await generator.generateAtlas(ttfBytes);\n  } catch (e) {\n    primaryFailed = true;\n    primaryFailure = e;\n  } finally {\n    if (generator !== undefined) {\n      try {\n        await generator.dispose();\n      } catch (e) {\n        disposeFailed = true;\n        disposeFailure = e;\n      }\n    }\n  }\n\n  if (primaryFailed) {\n    throw new FontError({\n      code: 'bake-failed',\n      expected: '@zappar/msdf-generator to produce an MSDF atlas',\n      hint: 'the MSDF generator threw -- a Web Worker + wasm host is required (a plain Node process reports \"Worker is not defined\"); run the bake in a Worker-capable environment',\n      detail: {\n        cause: primaryFailure instanceof Error ? primaryFailure.message : String(primaryFailure),\n      },\n    });\n  }\n  if (disposeFailed) {\n    throw new FontError({\n      code: 'bake-failed',\n      expected: 'the MSDF generator to dispose cleanly',\n      hint: 'repair the MSDF generator lifecycle, then retry the bake',\n      detail: {\n        cause: disposeFailure instanceof Error ? disposeFailure.message : String(disposeFailure),\n      },\n    });\n  }\n  if (atlas === undefined) {\n    throw new FontError({\n      code: 'bake-failed',\n      expected: '@zappar/msdf-generator to produce an MSDF atlas',\n      hint: 'repair the MSDF generator lifecycle, then retry the bake',\n      detail: { cause: 'the MSDF generator produced no atlas' },\n    });\n  }\n\n  const base = basename(ttfPath, extname(ttfPath));\n  const atlasName = `${base}.atlas.png`;\n  const atlasPath = join(outDir, atlasName);\n  const sidecarPath = join(outDir, `${base}.meta.json`);\n  const malformedCause = malformedAtlasTextureCause(atlas) ?? malformedGlyphCause(atlas);\n  if (malformedCause !== undefined) {\n    throw new FontError({\n      code: 'bake-failed',\n      expected: 'a valid MSDF atlas texture and glyph metrics',\n      hint: 'repair the MSDF generator atlas and glyph output, then retry the bake',\n      detail: { cause: malformedCause },\n    });\n  }\n  const png = encodePng(atlas.texture.width, atlas.texture.height, atlas.texture.data);\n  try {\n    await writeFile(atlasPath, png);\n  } catch (e) {\n    throw new FontError({\n      code: 'bake-failed',\n      expected: 'a writable atlas output path',\n      hint: 'repair the atlas output path or filesystem access, then retry the bake',\n      detail: { path: atlasPath, cause: e instanceof Error ? e.message : String(e) },\n    });\n  }\n  const sidecar = atlasToSidecar(atlas, atlasName);\n  try {\n    await writeFile(sidecarPath, `${JSON.stringify(sidecar, null, 2)}\\n`);\n  } catch (e) {\n    throw new FontError({\n      code: 'bake-failed',\n      expected: 'a writable sidecar output path',\n      hint: 'repair the sidecar output path or filesystem access, then retry the bake',\n      detail: { path: sidecarPath, cause: e instanceof Error ? e.message : String(e) },\n    });\n  }\n  return { atlasPath, sidecarPath };\n}\n\n/**\n * Real @zappar/msdf-generator factory. Dynamically imported so a non-bake\n * subcommand (or a test that injects a mock) never pays the wasm load cost,\n * and so the package builds without the browser globals the generator needs.\n */\n/**\n * Shape of @zappar/msdf-generator's `MSDFAtlas` (dist/index.d.ts) that the\n * real factory adapts into the POD {@link BakeAtlas}. The package's `texture`\n * is an ImageData-shaped `{ width, height, data }`; we read those fields\n * structurally so the font package never needs the DOM `ImageData` type.\n */\ninterface ZapparAtlas {\n  texture: { width: number; height: number; data: Uint8ClampedArray | Uint8Array };\n  glyphs: ReadonlyArray<{\n    unicode: number;\n    advance: number;\n    xoffset: number;\n    yoffset: number;\n    atlasPosition: [number, number];\n    atlasSize: [number, number];\n  }>;\n  metrics: { lineHeight: number; ascender: number };\n  textureSize: [number, number];\n  fieldRange: number;\n}\n\nexport async function realGeneratorFactory(): Promise<MsdfGenerator> {\n  const mod = (await import('@zappar/msdf-generator')) as unknown as {\n    MSDF: new (config?: {\n      workerUrl?: URL;\n      wasmUrl?: string;\n    }) => {\n      initialize(): Promise<void>;\n      generateAtlas(opts: {\n        font: Uint8Array;\n        charset: string;\n        textureSize: [number, number];\n        fieldRange: number;\n        fontSize: number;\n      }): Promise<ZapparAtlas>;\n      dispose(): Promise<void>;\n    };\n  };\n\n  const wasmModuleUrl = import.meta.resolve('@zappar/msdf-generator/msdfgen_wasm.wasm');\n  const wasmBytes = await readFile(new URL(wasmModuleUrl));\n  const wasmUrl = `data:application/octet-stream;base64,${Buffer.from(wasmBytes).toString('base64')}`;\n  const nodeGlobal = globalThis as unknown as { Worker?: typeof NodeWorkerAdapter };\n  const previousWorker = nodeGlobal.Worker;\n  nodeGlobal.Worker = NodeWorkerAdapter;\n  let msdf: InstanceType<typeof mod.MSDF> | undefined;\n  try {\n    msdf = new mod.MSDF({\n      workerUrl: new URL('./node-msdf-worker.mjs', import.meta.url),\n      wasmUrl,\n    });\n    await msdf.initialize();\n  } finally {\n    if (previousWorker === undefined) {\n      delete nodeGlobal.Worker;\n    } else {\n      nodeGlobal.Worker = previousWorker;\n    }\n  }\n  if (msdf === undefined) {\n    throw new Error('the MSDF generator did not initialize');\n  }\n  return {\n    async generateAtlas(ttf: Uint8Array): Promise<BakeAtlas> {\n      const a = await msdf.generateAtlas({\n        font: ttf,\n        charset: DEFAULT_CHARSET,\n        textureSize: [DEFAULT_TEXTURE_SIZE, DEFAULT_TEXTURE_SIZE],\n        fieldRange: DEFAULT_FIELD_RANGE,\n        fontSize: DEFAULT_FONT_SIZE,\n      });\n      return {\n        texture: {\n          width: a.texture.width,\n          height: a.texture.height,\n          data: new Uint8Array(a.texture.data),\n        },\n        glyphs: a.glyphs.map((g) => ({\n          unicode: g.unicode,\n          advance: g.advance,\n          xoffset: g.xoffset,\n          yoffset: g.yoffset,\n          atlasPosition: [g.atlasPosition[0], g.atlasPosition[1]],\n          atlasSize: [g.atlasSize[0], g.atlasSize[1]],\n        })),\n        metrics: { lineHeight: a.metrics.lineHeight, ascender: a.metrics.ascender },\n        textureSize: [a.textureSize[0], a.textureSize[1]],\n        fieldRange: a.fieldRange,\n      };\n    },\n    async dispose(): Promise<void> {\n      await msdf.dispose();\n    },\n  };\n}\n\nfunction bakeHelpBody(): string {\n  return [\n    'forgeax-engine-remote-font bake — bake MSDF font atlas from TTF',\n    '',\n    'Usage:',\n    '  forgeax-engine-remote-font bake <ttf> <out>',\n    '',\n    'Reads a TrueType font file and produces:',\n    `  <out>/<basename>.atlas.png   — ${DEFAULT_TEXTURE_SIZE}x${DEFAULT_TEXTURE_SIZE} MSDF atlas`,\n    '  <out>/<basename>.meta.json   — glyph metrics sidecar (importer: font)',\n    '',\n  ].join('\\n');\n}\n\nfunction helpBody(): string {\n  return [\n    'forgeax-engine-remote-font — MSDF font atlas baking',\n    '',\n    'Usage:',\n    '  forgeax-engine-remote-font bake <ttf> <out>',\n    '',\n  ].join('\\n');\n}\n\nexport async function runCliFont(argv: string[]): Promise<number> {\n  const [sub, ...rest] = argv;\n  if (sub === undefined || sub === '--help' || sub === '-h') {\n    process.stdout.write(`${helpBody()}\\n`);\n    return 0;\n  }\n  if (sub !== 'bake') {\n    process.stderr.write(`unknown subcommand: ${sub}\\n`);\n    return 1;\n  }\n  return runBake(rest);\n}\n\nasync function runBake(rest: string[]): Promise<number> {\n  if (rest[0] === '--help' || rest[0] === '-h') {\n    process.stdout.write(`${bakeHelpBody()}\\n`);\n    return 0;\n  }\n  let positionals: string[];\n  try {\n    const parsed = parseArgs({ args: rest, allowPositionals: true, strict: true });\n    positionals = [...parsed.positionals];\n  } catch {\n    process.stderr.write('error parsing CLI args\\n');\n    return 1;\n  }\n  const ttfPath = positionals[0];\n  const outDir = positionals[1];\n  if (ttfPath === undefined || outDir === undefined) {\n    process.stderr.write('usage: forgeax-engine-remote-font bake <ttf> <out>\\n');\n    return 1;\n  }\n  try {\n    const result = await bakeFont(ttfPath, outDir, realGeneratorFactory);\n    process.stdout.write(`baked ${result.atlasPath} + ${result.sidecarPath}\\n`);\n    return 0;\n  } catch (e) {\n    if (e instanceof FontError) {\n      process.stderr.write(\n        `${JSON.stringify({ code: e.code, expected: e.expected, hint: e.hint, detail: e.detail })}\\n`,\n      );\n      return 1;\n    }\n    process.stderr.write(`bake failed: ${e instanceof Error ? e.message : String(e)}\\n`);\n    return 1;\n  }\n}\n\nconst isBinEntry = await (async (): Promise<boolean> => {\n  const argv1 = process.argv[1];\n  if (typeof argv1 !== 'string') return false;\n  const argv1Real = await realpath(argv1).catch(() => argv1);\n  const selfReal = await realpath(fileURLToPath(import.meta.url)).catch(() =>\n    fileURLToPath(import.meta.url),\n  );\n  return argv1Real === selfReal;\n})();\n\nif (isBinEntry) {\n  const exitCode = await runCliFont(process.argv.slice(2));\n  process.exit(exitCode);\n}\n"]}