@forgeax/engine-font 0.0.0-dev.8d955ade1c79

package/dist/font-importer.mjs

@@ -0,0 +1,469 @@
+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';
+
+// src/cli-font.ts
+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
+  };
+}
+async function bakeFont(ttfPath, outDir, generatorFactory) {
+  const ttf = await readFile(ttfPath);
+  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 }
+    });
+  }
+  let atlas;
+  let generator;
+  try {
+    generator = await generatorFactory();
+    atlas = await generator.generateAtlas(ttfBytes);
+  } catch (e) {
+    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: e instanceof Error ? e.message : String(e) }
+    });
+  } finally {
+    if (generator !== void 0) {
+      await generator.dispose().catch(() => void 0);
+    }
+  }
+  await mkdir(outDir, { recursive: true });
+  const base = basename(ttfPath, extname(ttfPath));
+  const atlasName = `${base}.atlas.png`;
+  const atlasPath = join(outDir, atlasName);
+  const sidecarPath = join(outDir, `${base}.meta.json`);
+  const png = encodePng(atlas.texture.width, atlas.texture.height, atlas.texture.data);
+  await writeFile(atlasPath, png);
+  const sidecar = atlasToSidecar(atlas, atlasName);
+  await writeFile(sidecarPath, `${JSON.stringify(sidecar, null, 2)}
+`);
+  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);
+}
+
+// src/font-importer.ts
+function sourceKeyForFontOutput(kind) {
+  const normalizedKind = kind.trim();
+  return normalizedKind.length === 0 ? void 0 : `font:${normalizedKind}`;
+}
+function fontOutputSourceKeys() {
+  return ["texture", "sampler", "font"].map((kind) => sourceKeyForFontOutput(kind));
+}
+function atlasGlyphsToMetrics(atlas) {
+  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 glyphs;
+}
+function makeAtlasTexture(atlas) {
+  return {
+    kind: "texture",
+    width: atlas.texture.width,
+    height: atlas.texture.height,
+    // MSDF atlas is linear-space RGBA8 (signed-distance channels, never gamma).
+    format: "rgba8unorm",
+    data: atlas.texture.data,
+    colorSpace: "linear",
+    mipmap: false
+  };
+}
+function makeFontCommon(atlas) {
+  return {
+    lineHeight: atlas.metrics.lineHeight,
+    base: atlas.metrics.ascender,
+    distanceRange: atlas.fieldRange,
+    pxRange: atlas.fieldRange,
+    atlasWidth: atlas.textureSize[0],
+    atlasHeight: atlas.textureSize[1]
+  };
+}
+function makeAtlasSampler() {
+  return {
+    kind: "sampler",
+    addressModeU: "clamp-to-edge",
+    addressModeV: "clamp-to-edge",
+    addressModeW: "clamp-to-edge",
+    magFilter: "linear",
+    minFilter: "linear",
+    mipmapFilter: "nearest"
+  };
+}
+async function importFont(ctx) {
+  const read = await ctx.readSource();
+  if (!read.ok) {
+    throw new Error(
+      `fontImporter: readSource failed: ${read.error instanceof Error ? read.error.message : String(read.error)}`
+    );
+  }
+  const factory = ctx.importSettings.generatorFactory ?? realGeneratorFactory;
+  const generator = await factory();
+  let atlas;
+  try {
+    atlas = await generator.generateAtlas(read.value);
+  } finally {
+    await generator.dispose().catch(() => void 0);
+  }
+  const atlasSub = ctx.subAssets.find((s) => s.kind === "texture");
+  const samplerSub = ctx.subAssets.find((s) => s.kind === "sampler");
+  const fontSub = ctx.subAssets.find((s) => s.kind === "font");
+  const out = [];
+  if (atlasSub !== void 0) {
+    out.push({
+      guid: atlasSub.guid,
+      kind: "texture",
+      payload: makeAtlasTexture(atlas),
+      refs: [],
+      artifacts: {
+        atlas: {
+          // Pack v2's runtime texture loader consumes non-Basis artifacts as
+          // raw pixels. Keep the baked RGBA8 MSDF atlas in that form here;
+          // the CLI still emits a PNG for standalone bake output.
+          mediaType: "application/octet-stream",
+          bytes: atlas.texture.data
+        }
+      }
+    });
+  }
+  if (samplerSub !== void 0) {
+    out.push({
+      guid: samplerSub.guid,
+      kind: "sampler",
+      payload: makeAtlasSampler(),
+      refs: [],
+      artifacts: {}
+    });
+  }
+  if (fontSub !== void 0) {
+    const fontPayload = {
+      kind: "font",
+      atlasGuid: atlasSub?.guid ?? "",
+      samplerGuid: samplerSub?.guid ?? "",
+      glyphs: atlasGlyphsToMetrics(atlas),
+      common: makeFontCommon(atlas)
+    };
+    out.push({
+      guid: fontSub.guid,
+      kind: "font",
+      payload: fontPayload,
+      refs: [
+        ...atlasSub !== void 0 ? [{ guid: atlasSub.guid }] : [],
+        ...samplerSub !== void 0 ? [{ guid: samplerSub.guid }] : []
+      ],
+      artifacts: {}
+    });
+  }
+  return { ok: true, value: { assets: out, sourceDependencies: [] } };
+}
+var fontImporter = {
+  key: "font",
+  import: importFont
+};
+
+export { fontImporter, fontOutputSourceKeys, sourceKeyForFontOutput };
+//# sourceMappingURL=font-importer.mjs.map
+//# sourceMappingURL=font-importer.mjs.map

package/dist/font-importer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node-worker-adapter.ts","../src/cli-font.ts","../src/font-importer.ts"],"names":[],"mappings":";;;;;;;;;;AAUO,IAAM,oBAAN,MAAwB;AAAA,EACZ,MAAA;AAAA,EACA,SAAA,uBAAgB,GAAA,EAA8C;AAAA,EAExE,YAAY,GAAA,EAAmB;AACpC,IAAA,IAAA,CAAK,MAAA,GAAS,IAAI,MAAA,CAAO,GAAG,CAAA;AAAA,EAC9B;AAAA,EAEO,WAAA,CAAY,OAAA,EAAkB,YAAA,GAAuC,EAAC,EAAS;AACpF,IAAA,IAAA,CAAK,OAAO,WAAA,CAAY,OAAA,EAAS,CAAC,GAAG,YAAY,CAAC,CAAA;AAAA,EACpD;AAAA,EAEO,gBAAA,CAAiB,MAAc,QAAA,EAAiC;AACrE,IAAA,IAAI,SAAS,SAAA,EAAW;AACxB,IAAA,MAAM,OAAA,GAAU,CAAC,IAAA,KAAkB,QAAA,CAAS,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAK,CAAA;AACjE,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAA,EAAU,OAAO,CAAA;AACpC,IAAA,IAAA,CAAK,MAAA,CAAO,EAAA,CAAG,SAAA,EAAW,OAAO,CAAA;AAAA,EACnC;AAAA,EAEO,mBAAA,CAAoB,MAAc,QAAA,EAAiC;AACxE,IAAA,IAAI,SAAS,SAAA,EAAW;AACxB,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAQ,CAAA;AAC3C,IAAA,IAAI,YAAY,MAAA,EAAW;AAC3B,IAAA,IAAA,CAAK,SAAA,CAAU,OAAO,QAAQ,CAAA;AAC9B,IAAA,IAAA,CAAK,MAAA,CAAO,GAAA,CAAI,SAAA,EAAW,OAAO,CAAA;AAAA,EACpC;AAAA,EAEO,SAAA,GAA6B;AAClC,IAAA,OAAO,IAAA,CAAK,OAAO,SAAA,EAAU;AAAA,EAC/B;AACF,CAAA;;;AC4BA,IAAM,mBAAmB,MAAM;AAC7B,EAAA,IAAI,CAAA,GAAI,EAAA;AACR,EAAA,KAAA,IAAS,CAAA,GAAI,IAAM,CAAA,IAAK,GAAA,EAAM,KAAK,CAAA,IAAK,MAAA,CAAO,aAAa,CAAC,CAAA;AAC7D,EAAA,OAAO,CAAA;AACT,CAAA,GAAG;AAEH,IAAM,oBAAA,GAAuB,IAAA;AAC7B,IAAM,mBAAA,GAAsB,CAAA;AAC5B,IAAM,iBAAA,GAAoB,EAAA;AAyB1B,SAAS,qBAAqB,KAAA,EAA4B;AACxD,EAAA,IAAI,KAAA,CAAM,MAAA,GAAS,CAAA,EAAG,OAAO,KAAA;AAC7B,EAAA,MAAM,EAAA,GAAK,KAAA,CAAM,CAAC,CAAA,IAAK,CAAA;AACvB,EAAA,MAAM,EAAA,GAAK,KAAA,CAAM,CAAC,CAAA,IAAK,CAAA;AACvB,EAAA,MAAM,EAAA,GAAK,KAAA,CAAM,CAAC,CAAA,IAAK,CAAA;AACvB,EAAA,MAAM,EAAA,GAAK,KAAA,CAAM,CAAC,CAAA,IAAK,CAAA;AAIvB,EAAA,MAAM,aAAa,EAAA,KAAO,CAAA,IAAQ,OAAO,CAAA,IAAQ,EAAA,KAAO,KAAQ,EAAA,KAAO,CAAA;AACvE,EAAA,MAAM,SAAS,EAAA,KAAO,GAAA,IAAQ,OAAO,GAAA,IAAQ,EAAA,KAAO,OAAQ,EAAA,KAAO,GAAA;AACnE,EAAA,MAAM,SAAS,EAAA,KAAO,EAAA,IAAQ,OAAO,EAAA,IAAQ,EAAA,KAAO,MAAQ,EAAA,KAAO,EAAA;AACnE,EAAA,OAAO,cAAc,MAAA,IAAU,MAAA;AACjC;AAGA,SAAS,MAAM,KAAA,EAA2B;AACxC,EAAA,IAAI,GAAA,GAAM,UAAA;AACV,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,CAAM,QAAQ,CAAA,EAAA,EAAK;AACrC,IAAA,GAAA,IAAO,KAAA,CAAM,CAAC,CAAA,IAAK,CAAA;AACnB,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,CAAA,EAAG,CAAA,EAAA,EAAK;AAC1B,MAAA,GAAA,GAAM,GAAA,GAAM,CAAA,GAAK,GAAA,KAAQ,CAAA,GAAK,aAAa,GAAA,KAAQ,CAAA;AAAA,IACrD;AAAA,EACF;AACA,EAAA,OAAA,CAAQ,MAAM,UAAA,MAAgB,CAAA;AAChC;AAEA,SAAS,QAAA,CAAS,MAAc,IAAA,EAA8B;AAC5D,EAAA,MAAM,SAAA,GAAY,IAAI,UAAA,CAAW;AAAA,IAC/B,IAAA,CAAK,WAAW,CAAC,CAAA;AAAA,IACjB,IAAA,CAAK,WAAW,CAAC,CAAA;AAAA,IACjB,IAAA,CAAK,WAAW,CAAC,CAAA;AAAA,IACjB,IAAA,CAAK,WAAW,CAAC;AAAA,GAClB,CAAA;AACD,EAAA,MAAM,OAAO,IAAI,UAAA,CAAW,SAAA,CAAU,MAAA,GAAS,KAAK,MAAM,CAAA;AAC1D,EAAA,IAAA,CAAK,GAAA,CAAI,WAAW,CAAC,CAAA;AACrB,EAAA,IAAA,CAAK,GAAA,CAAI,IAAA,EAAM,SAAA,CAAU,MAAM,CAAA;AAC/B,EAAA,MAAM,MAAM,IAAI,UAAA,CAAW,CAAA,GAAI,IAAA,CAAK,SAAS,CAAC,CAAA;AAC9C,EAAA,MAAM,EAAA,GAAK,IAAI,QAAA,CAAS,GAAA,CAAI,MAAM,CAAA;AAClC,EAAA,EAAA,CAAG,SAAA,CAAU,CAAA,EAAG,IAAA,CAAK,MAAM,CAAA;AAC3B,EAAA,GAAA,CAAI,GAAA,CAAI,MAAM,CAAC,CAAA;AACf,EAAA,EAAA,CAAG,UAAU,CAAA,GAAI,IAAA,CAAK,MAAA,EAAQ,KAAA,CAAM,IAAI,CAAC,CAAA;AACzC,EAAA,OAAO,GAAA;AACT;AAOO,SAAS,SAAA,CAAU,KAAA,EAAe,MAAA,EAAgB,IAAA,EAA8B;AAErF,EAAA,MAAM,SAAS,KAAA,GAAQ,CAAA;AACvB,EAAA,MAAM,GAAA,GAAM,IAAI,UAAA,CAAA,CAAY,MAAA,GAAS,KAAK,MAAM,CAAA;AAChD,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,MAAA,EAAQ,CAAA,EAAA,EAAK;AAC/B,IAAA,GAAA,CAAI,CAAA,IAAK,MAAA,GAAS,CAAA,CAAE,CAAA,GAAI,CAAA;AACxB,IAAA,GAAA,CAAI,GAAA,CAAI,IAAA,CAAK,QAAA,CAAS,CAAA,GAAI,MAAA,EAAQ,CAAA,GAAI,MAAA,GAAS,MAAM,CAAA,EAAG,CAAA,IAAK,MAAA,GAAS,CAAA,CAAA,GAAK,CAAC,CAAA;AAAA,EAC9E;AACA,EAAA,MAAM,IAAA,GAAO,YAAY,GAAG,CAAA;AAC5B,EAAA,MAAM,IAAA,GAAO,IAAI,UAAA,CAAW,EAAE,CAAA;AAC9B,EAAA,MAAM,EAAA,GAAK,IAAI,QAAA,CAAS,IAAA,CAAK,MAAM,CAAA;AACnC,EAAA,EAAA,CAAG,SAAA,CAAU,GAAG,KAAK,CAAA;AACrB,EAAA,EAAA,CAAG,SAAA,CAAU,GAAG,MAAM,CAAA;AACtB,EAAA,IAAA,CAAK,CAAC,CAAA,GAAI,CAAA;AACV,EAAA,IAAA,CAAK,CAAC,CAAA,GAAI,CAAA;AACV,EAAA,IAAA,CAAK,EAAE,CAAA,GAAI,CAAA;AACX,EAAA,IAAA,CAAK,EAAE,CAAA,GAAI,CAAA;AACX,EAAA,IAAA,CAAK,EAAE,CAAA,GAAI,CAAA;AACX,EAAA,MAAM,SAAA,GAAY,IAAI,UAAA,CAAW,CAAC,GAAA,EAAM,EAAA,EAAM,EAAA,EAAM,EAAA,EAAM,EAAA,EAAM,EAAA,EAAM,EAAA,EAAM,EAAI,CAAC,CAAA;AACjF,EAAA,MAAM,MAAA,GAAS;AAAA,IACb,SAAA;AAAA,IACA,QAAA,CAAS,QAAQ,IAAI,CAAA;AAAA,IACrB,QAAA,CAAS,MAAA,EAAQ,IAAI,UAAA,CAAW,IAAI,CAAC,CAAA;AAAA,IACrC,QAAA,CAAS,MAAA,EAAQ,IAAI,UAAA,CAAW,CAAC,CAAC;AAAA,GACpC;AACA,EAAA,MAAM,KAAA,GAAQ,OAAO,MAAA,CAAO,CAAC,GAAG,CAAA,KAAM,CAAA,GAAI,CAAA,CAAE,MAAA,EAAQ,CAAC,CAAA;AACrD,EAAA,MAAM,GAAA,GAAM,IAAI,UAAA,CAAW,KAAK,CAAA;AAChC,EAAA,IAAI,GAAA,GAAM,CAAA;AACV,EAAA,KAAA,MAAW,KAAK,MAAA,EAAQ;AACtB,IAAA,GAAA,CAAI,GAAA,CAAI,GAAG,GAAG,CAAA;AACd,IAAA,GAAA,IAAO,CAAA,CAAE,MAAA;AAAA,EACX;AACA,EAAA,OAAO,GAAA;AACT;AAGO,SAAS,cAAA,CAAe,OAAkB,SAAA,EAAgC;AAC/E,EAAA,MAAM,SAAsC,EAAC;AAC7C,EAAA,KAAA,MAAW,CAAA,IAAK,MAAM,MAAA,EAAQ;AAC5B,IAAA,MAAA,CAAO,CAAA,CAAE,OAAO,CAAA,GAAI;AAAA,MAClB,SAAS,CAAA,CAAE,OAAA;AAAA,MACX,UAAU,CAAA,CAAE,OAAA;AAAA,MACZ,UAAU,CAAA,CAAE,OAAA;AAAA,MACZ,IAAA,EAAM,EAAE,CAAA,EAAG,CAAA,CAAE,SAAA,CAAU,CAAC,CAAA,EAAG,CAAA,EAAG,CAAA,CAAE,SAAA,CAAU,CAAC,CAAA,EAAE;AAAA,MAC7C,MAAA,EAAQ;AAAA,QACN,CAAA,EAAG,CAAA,CAAE,aAAA,CAAc,CAAC,CAAA;AAAA,QACpB,CAAA,EAAG,CAAA,CAAE,aAAA,CAAc,CAAC,CAAA;AAAA,QACpB,CAAA,EAAG,CAAA,CAAE,SAAA,CAAU,CAAC,CAAA;AAAA,QAChB,CAAA,EAAG,CAAA,CAAE,SAAA,CAAU,CAAC;AAAA;AAClB,KACF;AAAA,EACF;AACA,EAAA,OAAO;AAAA,IACL,aAAA,EAAe,OAAA;AAAA,IACf,IAAA,EAAM,wBAAA;AAAA,IACN,QAAA,EAAU,MAAA;AAAA,IACV,MAAA,EAAQ,SAAA;AAAA,IACR,cAAA,EAAgB,EAAE,UAAA,EAAY,QAAA,EAAU,QAAQ,MAAA,EAAO;AAAA,IACvD,MAAA,EAAQ;AAAA,MACN,UAAA,EAAY,MAAM,OAAA,CAAQ,UAAA;AAAA,MAC1B,IAAA,EAAM,MAAM,OAAA,CAAQ,QAAA;AAAA,MACpB,eAAe,KAAA,CAAM,UAAA;AAAA,MACrB,SAAS,KAAA,CAAM,UAAA;AAAA,MACf,UAAA,EAAY,KAAA,CAAM,WAAA,CAAY,CAAC,CAAA;AAAA,MAC/B,WAAA,EAAa,KAAA,CAAM,WAAA,CAAY,CAAC;AAAA,KAClC;AAAA,IACA;AAAA,GACF;AACF;AAoBA,eAAsB,QAAA,CACpB,OAAA,EACA,MAAA,EACA,gBAAA,EACqB;AACrB,EAAA,MAAM,GAAA,GAAM,MAAM,QAAA,CAAS,OAAO,CAAA;AAClC,EAAA,MAAM,QAAA,GAAW,IAAI,UAAA,CAAW,GAAA,CAAI,QAAQ,GAAA,CAAI,UAAA,EAAY,IAAI,UAAU,CAAA;AAC1E,EAAA,IAAI,CAAC,oBAAA,CAAqB,QAAQ,CAAA,EAAG;AACnC,IAAA,MAAM,IAAI,SAAA,CAAU;AAAA,MAClB,IAAA,EAAM,yBAAA;AAAA,MACN,QAAA,EAAU,KAAA;AAAA,MACV,IAAA,EAAM,6JAAA;AAAA,MACN,MAAA,EAAQ,EAAE,IAAA,EAAM,OAAA;AAAQ,KACzB,CAAA;AAAA,EACH;AAEA,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI,SAAA;AACJ,EAAA,IAAI;AACF,IAAA,SAAA,GAAY,MAAM,gBAAA,EAAiB;AACnC,IAAA,KAAA,GAAQ,MAAM,SAAA,CAAU,aAAA,CAAc,QAAQ,CAAA;AAAA,EAChD,SAAS,CAAA,EAAG;AACV,IAAA,MAAM,IAAI,SAAA,CAAU;AAAA,MAClB,IAAA,EAAM,aAAA;AAAA,MACN,QAAA,EAAU,iDAAA;AAAA,MACV,IAAA,EAAM,uKAAA;AAAA,MACN,MAAA,EAAQ,EAAE,KAAA,EAAO,CAAA,YAAa,QAAQ,CAAA,CAAE,OAAA,GAAU,MAAA,CAAO,CAAC,CAAA;AAAE,KAC7D,CAAA;AAAA,EACH,CAAA,SAAE;AACA,IAAA,IAAI,cAAc,MAAA,EAAW;AAC3B,MAAA,MAAM,SAAA,CAAU,OAAA,EAAQ,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AAAA,IACjD;AAAA,EACF;AAEA,EAAA,MAAM,KAAA,CAAM,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AACvC,EAAA,MAAM,IAAA,GAAO,QAAA,CAAS,OAAA,EAAS,OAAA,CAAQ,OAAO,CAAC,CAAA;AAC/C,EAAA,MAAM,SAAA,GAAY,GAAG,IAAI,CAAA,UAAA,CAAA;AACzB,EAAA,MAAM,SAAA,GAAY,IAAA,CAAK,MAAA,EAAQ,SAAS,CAAA;AACxC,EAAA,MAAM,WAAA,GAAc,IAAA,CAAK,MAAA,EAAQ,CAAA,EAAG,IAAI,CAAA,UAAA,CAAY,CAAA;AACpD,EAAA,MAAM,GAAA,GAAM,SAAA,CAAU,KAAA,CAAM,OAAA,CAAQ,KAAA,EAAO,MAAM,OAAA,CAAQ,MAAA,EAAQ,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA;AACnF,EAAA,MAAM,SAAA,CAAU,WAAW,GAAG,CAAA;AAC9B,EAAA,MAAM,OAAA,GAAU,cAAA,CAAe,KAAA,EAAO,SAAS,CAAA;AAC/C,EAAA,MAAM,SAAA,CAAU,aAAa,CAAA,EAAG,IAAA,CAAK,UAAU,OAAA,EAAS,IAAA,EAAM,CAAC,CAAC;AAAA,CAAI,CAAA;AACpE,EAAA,OAAO,EAAE,WAAW,WAAA,EAAY;AAClC;AA4BA,eAAsB,oBAAA,GAA+C;AACnE,EAAA,MAAM,GAAA,GAAO,MAAM,OAAO,wBAAwB,CAAA;AAiBlD,EAAA,MAAM,aAAA,GAAgB,MAAA,CAAA,IAAA,CAAY,OAAA,CAAQ,0CAA0C,CAAA;AACpF,EAAA,MAAM,YAAY,MAAM,QAAA,CAAS,IAAI,GAAA,CAAI,aAAa,CAAC,CAAA;AACvD,EAAA,MAAM,OAAA,GAAU,wCAAwC,MAAA,CAAO,IAAA,CAAK,SAAS,CAAA,CAAE,QAAA,CAAS,QAAQ,CAAC,CAAA,CAAA;AACjG,EAAA,MAAM,UAAA,GAAa,UAAA;AACnB,EAAA,MAAM,iBAAiB,UAAA,CAAW,MAAA;AAClC,EAAA,UAAA,CAAW,MAAA,GAAS,iBAAA;AACpB,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI;AACF,IAAA,IAAA,GAAO,IAAI,IAAI,IAAA,CAAK;AAAA,MAClB,SAAA,EAAW,IAAI,GAAA,CAAI,wBAAA,EAA0B,YAAY,GAAG,CAAA;AAAA,MAC5D;AAAA,KACD,CAAA;AACD,IAAA,MAAM,KAAK,UAAA,EAAW;AAAA,EACxB,CAAA,SAAE;AACA,IAAA,IAAI,mBAAmB,MAAA,EAAW;AAChC,MAAA,OAAO,UAAA,CAAW,MAAA;AAAA,IACpB,CAAA,MAAO;AACL,MAAA,UAAA,CAAW,MAAA,GAAS,cAAA;AAAA,IACtB;AAAA,EACF;AACA,EAAA,IAAI,SAAS,MAAA,EAAW;AACtB,IAAA,MAAM,IAAI,MAAM,uCAAuC,CAAA;AAAA,EACzD;AACA,EAAA,OAAO;AAAA,IACL,MAAM,cAAc,GAAA,EAAqC;AACvD,MAAA,MAAM,CAAA,GAAI,MAAM,IAAA,CAAK,aAAA,CAAc;AAAA,QACjC,IAAA,EAAM,GAAA;AAAA,QACN,OAAA,EAAS,eAAA;AAAA,QACT,WAAA,EAAa,CAAC,oBAAA,EAAsB,oBAAoB,CAAA;AAAA,QACxD,UAAA,EAAY,mBAAA;AAAA,QACZ,QAAA,EAAU;AAAA,OACX,CAAA;AACD,MAAA,OAAO;AAAA,QACL,OAAA,EAAS;AAAA,UACP,KAAA,EAAO,EAAE,OAAA,CAAQ,KAAA;AAAA,UACjB,MAAA,EAAQ,EAAE,OAAA,CAAQ,MAAA;AAAA,UAClB,IAAA,EAAM,IAAI,UAAA,CAAW,CAAA,CAAE,QAAQ,IAAI;AAAA,SACrC;AAAA,QACA,MAAA,EAAQ,CAAA,CAAE,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,UAC3B,SAAS,CAAA,CAAE,OAAA;AAAA,UACX,SAAS,CAAA,CAAE,OAAA;AAAA,UACX,SAAS,CAAA,CAAE,OAAA;AAAA,UACX,SAAS,CAAA,CAAE,OAAA;AAAA,UACX,aAAA,EAAe,CAAC,CAAA,CAAE,aAAA,CAAc,CAAC,CAAA,EAAG,CAAA,CAAE,aAAA,CAAc,CAAC,CAAC,CAAA;AAAA,UACtD,SAAA,EAAW,CAAC,CAAA,CAAE,SAAA,CAAU,CAAC,CAAA,EAAG,CAAA,CAAE,SAAA,CAAU,CAAC,CAAC;AAAA,SAC5C,CAAE,CAAA;AAAA,QACF,OAAA,EAAS,EAAE,UAAA,EAAY,CAAA,CAAE,QAAQ,UAAA,EAAY,QAAA,EAAU,CAAA,CAAE,OAAA,CAAQ,QAAA,EAAS;AAAA,QAC1E,WAAA,EAAa,CAAC,CAAA,CAAE,WAAA,CAAY,CAAC,CAAA,EAAG,CAAA,CAAE,WAAA,CAAY,CAAC,CAAC,CAAA;AAAA,QAChD,YAAY,CAAA,CAAE;AAAA,OAChB;AAAA,IACF,CAAA;AAAA,IACA,MAAM,OAAA,GAAyB;AAC7B,MAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,IACrB;AAAA,GACF;AACF;AAEA,SAAS,YAAA,GAAuB;AAC9B,EAAA,OAAO;AAAA,IACL,sEAAA;AAAA,IACA,EAAA;AAAA,IACA,QAAA;AAAA,IACA,+CAAA;AAAA,IACA,EAAA;AAAA,IACA,0CAAA;AAAA,IACA,CAAA,sCAAA,EAAoC,oBAAoB,CAAA,CAAA,EAAI,oBAAoB,CAAA,WAAA,CAAA;AAAA,IAChF,8EAAA;AAAA,IACA;AAAA,GACF,CAAE,KAAK,IAAI,CAAA;AACb;AAEA,SAAS,QAAA,GAAmB;AAC1B,EAAA,OAAO;AAAA,IACL,0DAAA;AAAA,IACA,EAAA;AAAA,IACA,QAAA;AAAA,IACA,+CAAA;AAAA,IACA;AAAA,GACF,CAAE,KAAK,IAAI,CAAA;AACb;AAEA,eAAsB,WAAW,IAAA,EAAiC;AAChE,EAAA,MAAM,CAAC,GAAA,EAAK,GAAG,IAAI,CAAA,GAAI,IAAA;AACvB,EAAA,IAAI,GAAA,KAAQ,MAAA,IAAa,GAAA,KAAQ,QAAA,IAAY,QAAQ,IAAA,EAAM;AACzD,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,QAAA,EAAU;AAAA,CAAI,CAAA;AACtC,IAAA,OAAO,CAAA;AAAA,EACT;AACA,EAAA,IAAI,QAAQ,MAAA,EAAQ;AAClB,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,oBAAA,EAAuB,GAAG;AAAA,CAAI,CAAA;AACnD,IAAA,OAAO,CAAA;AAAA,EACT;AACA,EAAA,OAAO,QAAQ,IAAI,CAAA;AACrB;AAEA,eAAe,QAAQ,IAAA,EAAiC;AACtD,EAAA,IAAI,KAAK,CAAC,CAAA,KAAM,YAAY,IAAA,CAAK,CAAC,MAAM,IAAA,EAAM;AAC5C,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,YAAA,EAAc;AAAA,CAAI,CAAA;AAC1C,IAAA,OAAO,CAAA;AAAA,EACT;AACA,EAAA,IAAI,WAAA;AACJ,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,GAAS,UAAU,EAAE,IAAA,EAAM,MAAM,gBAAA,EAAkB,IAAA,EAAM,MAAA,EAAQ,IAAA,EAAM,CAAA;AAC7E,IAAA,WAAA,GAAc,CAAC,GAAG,MAAA,CAAO,WAAW,CAAA;AAAA,EACtC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAA,CAAQ,MAAA,CAAO,MAAM,0BAA0B,CAAA;AAC/C,IAAA,OAAO,CAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAA,GAAU,YAAY,CAAC,CAAA;AAC7B,EAAA,MAAM,MAAA,GAAS,YAAY,CAAC,CAAA;AAC5B,EAAA,IAAI,OAAA,KAAY,MAAA,IAAa,MAAA,KAAW,MAAA,EAAW;AACjD,IAAA,OAAA,CAAQ,MAAA,CAAO,MAAM,sDAAsD,CAAA;AAC3E,IAAA,OAAO,CAAA;AAAA,EACT;AACA,EAAA,IAAI;AACF,IAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,OAAA,EAAS,QAAQ,oBAAoB,CAAA;AACnE,IAAA,OAAA,CAAQ,OAAO,KAAA,CAAM,CAAA,MAAA,EAAS,OAAO,SAAS,CAAA,GAAA,EAAM,OAAO,WAAW;AAAA,CAAI,CAAA;AAC1E,IAAA,OAAO,CAAA;AAAA,EACT,SAAS,CAAA,EAAG;AACV,IAAA,IAAI,aAAa,SAAA,EAAW;AAC1B,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,QACb,GAAG,IAAA,CAAK,SAAA,CAAU,EAAE,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA,CAAE,QAAA,EAAU,MAAM,CAAA,CAAE,IAAA,EAAM,QAAQ,CAAA,CAAE,MAAA,EAAQ,CAAC;AAAA;AAAA,OAC3F;AACA,MAAA,OAAO,CAAA;AAAA,IACT;AACA,IAAA,OAAA,CAAQ,MAAA,CAAO,MAAM,CAAA,aAAA,EAAgB,CAAA,YAAa,QAAQ,CAAA,CAAE,OAAA,GAAU,MAAA,CAAO,CAAC,CAAC;AAAA,CAAI,CAAA;AACnF,IAAA,OAAO,CAAA;AAAA,EACT;AACF;AAEA,IAAM,UAAA,GAAa,OAAO,YAA8B;AACtD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA;AAC5B,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,KAAA;AACtC,EAAA,MAAM,YAAY,MAAM,QAAA,CAAS,KAAK,CAAA,CAAE,KAAA,CAAM,MAAM,KAAK,CAAA;AACzD,EAAA,MAAM,WAAW,MAAM,QAAA,CAAS,cAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA,CAAE,KAAA;AAAA,IAAM,MACpE,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG;AAAA,GAC/B;AACA,EAAA,OAAO,SAAA,KAAc,QAAA;AACvB,CAAA,GAAG;AAEH,IAAI,UAAA,EAAY;AACd,EAAA,MAAM,WAAW,MAAM,UAAA,CAAW,QAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA;AACvD,EAAA,OAAA,CAAQ,KAAK,QAAQ,CAAA;AACvB;;;ACxaO,SAAS,uBAAuB,IAAA,EAAkC;AACvE,EAAA,MAAM,cAAA,GAAiB,KAAK,IAAA,EAAK;AACjC,EAAA,OAAO,cAAA,CAAe,MAAA,KAAW,CAAA,GAAI,MAAA,GAAY,QAAQ,cAAc,CAAA,CAAA;AACzE;AAEO,SAAS,oBAAA,GAA0C;AACxD,EAAA,OAAO,CAAC,SAAA,EAAW,SAAA,EAAW,MAAM,CAAA,CAAE,IAAI,CAAC,IAAA,KAAS,sBAAA,CAAuB,IAAI,CAAW,CAAA;AAC5F;AAGA,SAAS,qBAAqB,KAAA,EAA+C;AAC3E,EAAA,MAAM,SAAsC,EAAC;AAC7C,EAAA,KAAA,MAAW,CAAA,IAAK,MAAM,MAAA,EAAQ;AAC5B,IAAA,MAAA,CAAO,CAAA,CAAE,OAAO,CAAA,GAAI;AAAA,MAClB,SAAS,CAAA,CAAE,OAAA;AAAA,MACX,UAAU,CAAA,CAAE,OAAA;AAAA,MACZ,UAAU,CAAA,CAAE,OAAA;AAAA,MACZ,IAAA,EAAM,EAAE,CAAA,EAAG,CAAA,CAAE,SAAA,CAAU,CAAC,CAAA,EAAG,CAAA,EAAG,CAAA,CAAE,SAAA,CAAU,CAAC,CAAA,EAAE;AAAA,MAC7C,MAAA,EAAQ;AAAA,QACN,CAAA,EAAG,CAAA,CAAE,aAAA,CAAc,CAAC,CAAA;AAAA,QACpB,CAAA,EAAG,CAAA,CAAE,aAAA,CAAc,CAAC,CAAA;AAAA,QACpB,CAAA,EAAG,CAAA,CAAE,SAAA,CAAU,CAAC,CAAA;AAAA,QAChB,CAAA,EAAG,CAAA,CAAE,SAAA,CAAU,CAAC;AAAA;AAClB,KACF;AAAA,EACF;AACA,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,iBAAiB,KAAA,EAAgC;AACxD,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IACN,KAAA,EAAO,MAAM,OAAA,CAAQ,KAAA;AAAA,IACrB,MAAA,EAAQ,MAAM,OAAA,CAAQ,MAAA;AAAA;AAAA,IAEtB,MAAA,EAAQ,YAAA;AAAA,IACR,IAAA,EAAM,MAAM,OAAA,CAAQ,IAAA;AAAA,IACpB,UAAA,EAAY,QAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,GACV;AACF;AAEA,SAAS,eAAe,KAAA,EAAuC;AAC7D,EAAA,OAAO;AAAA,IACL,UAAA,EAAY,MAAM,OAAA,CAAQ,UAAA;AAAA,IAC1B,IAAA,EAAM,MAAM,OAAA,CAAQ,QAAA;AAAA,IACpB,eAAe,KAAA,CAAM,UAAA;AAAA,IACrB,SAAS,KAAA,CAAM,UAAA;AAAA,IACf,UAAA,EAAY,KAAA,CAAM,WAAA,CAAY,CAAC,CAAA;AAAA,IAC/B,WAAA,EAAa,KAAA,CAAM,WAAA,CAAY,CAAC;AAAA,GAClC;AACF;AAEA,SAAS,gBAAA,GAAiC;AACxC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IACN,YAAA,EAAc,eAAA;AAAA,IACd,YAAA,EAAc,eAAA;AAAA,IACd,YAAA,EAAc,eAAA;AAAA,IACd,SAAA,EAAW,QAAA;AAAA,IACX,SAAA,EAAW,QAAA;AAAA,IACX,YAAA,EAAc;AAAA,GAChB;AACF;AAEA,eAAe,WAAW,GAAA,EAA2C;AACnE,EAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,UAAA,EAAW;AAClC,EAAA,IAAI,CAAC,KAAK,EAAA,EAAI;AACZ,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,iCAAA,EAAoC,IAAA,CAAK,KAAA,YAAiB,KAAA,GAAQ,IAAA,CAAK,MAAM,OAAA,GAAU,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAAA,KAC3G;AAAA,EACF;AAEA,EAAA,MAAM,OAAA,GACH,GAAA,CAAI,cAAA,CAAe,gBAAA,IACpB,oBAAA;AACF,EAAA,MAAM,SAAA,GAAY,MAAM,OAAA,EAAQ;AAChC,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI;AACF,IAAA,KAAA,GAAQ,MAAM,SAAA,CAAU,aAAA,CAAc,IAAA,CAAK,KAAK,CAAA;AAAA,EAClD,CAAA,SAAE;AACA,IAAA,MAAM,SAAA,CAAU,OAAA,EAAQ,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AAAA,EACjD;AAEA,EAAA,MAAM,QAAA,GAAW,IAAI,SAAA,CAAU,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,SAAS,CAAA;AAC/D,EAAA,MAAM,UAAA,GAAa,IAAI,SAAA,CAAU,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,SAAS,CAAA;AACjE,EAAA,MAAM,OAAA,GAAU,IAAI,SAAA,CAAU,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,SAAS,MAAM,CAAA;AAC3D,EAAA,MAAM,MAAuB,EAAC;AAC9B,EAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,IAAA,GAAA,CAAI,IAAA,CAAK;AAAA,MACP,MAAM,QAAA,CAAS,IAAA;AAAA,MACf,IAAA,EAAM,SAAA;AAAA,MACN,OAAA,EAAS,iBAAiB,KAAK,CAAA;AAAA,MAC/B,MAAM,EAAC;AAAA,MACP,SAAA,EAAW;AAAA,QACT,KAAA,EAAO;AAAA;AAAA;AAAA;AAAA,UAIL,SAAA,EAAW,0BAAA;AAAA,UACX,KAAA,EAAO,MAAM,OAAA,CAAQ;AAAA;AACvB;AACF,KACD,CAAA;AAAA,EACH;AACA,EAAA,IAAI,eAAe,MAAA,EAAW;AAC5B,IAAA,GAAA,CAAI,IAAA,CAAK;AAAA,MACP,MAAM,UAAA,CAAW,IAAA;AAAA,MACjB,IAAA,EAAM,SAAA;AAAA,MACN,SAAS,gBAAA,EAAiB;AAAA,MAC1B,MAAM,EAAC;AAAA,MACP,WAAW;AAAC,KACb,CAAA;AAAA,EACH;AACA,EAAA,IAAI,YAAY,MAAA,EAAW;AAOzB,IAAA,MAAM,WAAA,GAAc;AAAA,MAClB,IAAA,EAAM,MAAA;AAAA,MACN,SAAA,EAAW,UAAU,IAAA,IAAQ,EAAA;AAAA,MAC7B,WAAA,EAAa,YAAY,IAAA,IAAQ,EAAA;AAAA,MACjC,MAAA,EAAQ,qBAAqB,KAAK,CAAA;AAAA,MAClC,MAAA,EAAQ,eAAe,KAAK;AAAA,KAC9B;AACA,IAAA,GAAA,CAAI,IAAA,CAAK;AAAA,MACP,MAAM,OAAA,CAAQ,IAAA;AAAA,MACd,IAAA,EAAM,MAAA;AAAA,MACN,OAAA,EAAS,WAAA;AAAA,MACT,IAAA,EAAM;AAAA,QACJ,GAAI,QAAA,KAAa,MAAA,GAAY,CAAC,EAAE,MAAM,QAAA,CAAS,IAAA,EAAM,CAAA,GAAI,EAAC;AAAA,QAC1D,GAAI,UAAA,KAAe,MAAA,GAAY,CAAC,EAAE,MAAM,UAAA,CAAW,IAAA,EAAM,CAAA,GAAI;AAAC,OAChE;AAAA,MACA,WAAW;AAAC,KACb,CAAA;AAAA,EACH;AACA,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,KAAA,EAAO,EAAE,QAAQ,GAAA,EAAK,kBAAA,EAAoB,EAAC,EAAE,EAAE;AACpE;AAcO,IAAM,YAAA,GAAyB;AAAA,EACpC,GAAA,EAAK,MAAA;AAAA,EACL,MAAA,EAAQ;AACV","file":"font-importer.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\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  const ttf = await readFile(ttfPath);\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  let atlas: BakeAtlas;\n  let generator: MsdfGenerator | undefined;\n  try {\n    generator = await generatorFactory();\n    atlas = await generator.generateAtlas(ttfBytes);\n  } catch (e) {\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: { cause: e instanceof Error ? e.message : String(e) },\n    });\n  } finally {\n    if (generator !== undefined) {\n      await generator.dispose().catch(() => undefined);\n    }\n  }\n\n  await mkdir(outDir, { recursive: true });\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 png = encodePng(atlas.texture.width, atlas.texture.height, atlas.texture.data);\n  await writeFile(atlasPath, png);\n  const sidecar = atlasToSidecar(atlas, atlasName);\n  await writeFile(sidecarPath, `${JSON.stringify(sidecar, null, 2)}\\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","// font-importer.ts - the build-time fontImporter (feat-20260603-asset-import-loader-injection M3 / w24).\n//\n// The `{ key: 'font', import }` Importer the @forgeax/engine-import runner\n// dispatches a `*.meta.json` with `importer: 'font'` to. It absorbs the MSDF\n// bake that previously lived only behind the `forgeax-engine-remote-font\n// bake` CLI: read the `.ttf` source -> @zappar/msdf-generator atlas ->\n// (a) one atlas `TextureAsset` ImportedAsset (the RGBA MSDF atlas, kind\n// 'texture') under the declared `kind: 'texture'` sub-asset GUID, (b) one\n// sampler ImportedAsset under the declared `kind: 'sampler'` sub-asset GUID,\n// and (c) one font glyph-metrics ImportedAsset (kind 'font') under the\n// declared `kind: 'font'` sub-asset GUID. The font carries the BMFont ->\n// FontAsset glyph map + the common block + atlas/sampler GUID refs.\n//\n// Build-time-only boundary (AC-18 / requirements callout): @zappar/msdf-generator\n// is a generator dependency that MUST stay out of the runtime bundle. The\n// runtime today statically imports ZERO @forgeax/engine-font and ZERO @zappar\n// symbols (research Finding 7); this importer keeps that invariant. fontImporter\n// is a NODE-ONLY sub-export (`@forgeax/engine-font/font-importer`,\n// `default: null` under browser conditions); the generator is dynamically\n// imported (cli-font realGeneratorFactory) so even the build-time graph only\n// pays the wasm load cost when a font is actually baked. The runtime fontLoader\n// (M1 w6) reads an already-baked atlas DDC and has no bake dependency.\n//\n// GUID import-stable iron law: produced GUIDs come from `ctx.subAssets[]`. The\n// font sidecar declares `texture`, `sampler`, and `font` sub-assets; this\n// importer maps the bake output onto those declared GUIDs and stamps nothing\n// of its own.\n//\n// `ctx.importSettings` may inject a test `generatorFactory` (an\n// `() => Promise<MsdfGenerator>`) so unit tests drive the bake with a mock\n// instead of the real wasm generator; production import calls fall through to\n// the real @zappar factory.\n\nimport type {\n  FontAsset,\n  GlyphMetric,\n  ImportContext,\n  ImportedAsset,\n  Importer,\n  ImportResult,\n  SamplerAsset,\n  TextureAsset,\n} from '@forgeax/engine-types';\nimport type { BakeAtlas, MsdfGenerator } from './cli-font.js';\nimport { realGeneratorFactory } from './cli-font.js';\n\n/** Stable semantic identities for the three writable font outputs. */\nexport function sourceKeyForFontOutput(kind: string): string | undefined {\n  const normalizedKind = kind.trim();\n  return normalizedKind.length === 0 ? undefined : `font:${normalizedKind}`;\n}\n\nexport function fontOutputSourceKeys(): readonly string[] {\n  return ['texture', 'sampler', 'font'].map((kind) => sourceKeyForFontOutput(kind) as string);\n}\n\n/** Map the @zappar atlas glyphs into the FontAsset glyph-metrics record. */\nfunction atlasGlyphsToMetrics(atlas: BakeAtlas): Record<number, GlyphMetric> {\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 glyphs;\n}\n\nfunction makeAtlasTexture(atlas: BakeAtlas): TextureAsset {\n  return {\n    kind: 'texture',\n    width: atlas.texture.width,\n    height: atlas.texture.height,\n    // MSDF atlas is linear-space RGBA8 (signed-distance channels, never gamma).\n    format: 'rgba8unorm',\n    data: atlas.texture.data,\n    colorSpace: 'linear',\n    mipmap: false,\n  };\n}\n\nfunction makeFontCommon(atlas: BakeAtlas): FontAsset['common'] {\n  return {\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}\n\nfunction makeAtlasSampler(): SamplerAsset {\n  return {\n    kind: 'sampler',\n    addressModeU: 'clamp-to-edge',\n    addressModeV: 'clamp-to-edge',\n    addressModeW: 'clamp-to-edge',\n    magFilter: 'linear',\n    minFilter: 'linear',\n    mipmapFilter: 'nearest',\n  };\n}\n\nasync function importFont(ctx: ImportContext): Promise<ImportResult> {\n  const read = await ctx.readSource();\n  if (!read.ok) {\n    throw new Error(\n      `fontImporter: readSource failed: ${read.error instanceof Error ? read.error.message : String(read.error)}`,\n    );\n  }\n\n  const factory =\n    (ctx.importSettings.generatorFactory as (() => Promise<MsdfGenerator>) | undefined) ??\n    realGeneratorFactory;\n  const generator = await factory();\n  let atlas: BakeAtlas;\n  try {\n    atlas = await generator.generateAtlas(read.value);\n  } finally {\n    await generator.dispose().catch(() => undefined);\n  }\n\n  const atlasSub = ctx.subAssets.find((s) => s.kind === 'texture');\n  const samplerSub = ctx.subAssets.find((s) => s.kind === 'sampler');\n  const fontSub = ctx.subAssets.find((s) => s.kind === 'font');\n  const out: ImportedAsset[] = [];\n  if (atlasSub !== undefined) {\n    out.push({\n      guid: atlasSub.guid,\n      kind: 'texture',\n      payload: makeAtlasTexture(atlas),\n      refs: [],\n      artifacts: {\n        atlas: {\n          // Pack v2's runtime texture loader consumes non-Basis artifacts as\n          // raw pixels. Keep the baked RGBA8 MSDF atlas in that form here;\n          // the CLI still emits a PNG for standalone bake output.\n          mediaType: 'application/octet-stream',\n          bytes: atlas.texture.data,\n        },\n      },\n    });\n  }\n  if (samplerSub !== undefined) {\n    out.push({\n      guid: samplerSub.guid,\n      kind: 'sampler',\n      payload: makeAtlasSampler(),\n      refs: [],\n      artifacts: {},\n    });\n  }\n  if (fontSub !== undefined) {\n    // The runtime font loader reads atlasGuid / samplerGuid / glyphs / common\n    // off the DDC payload (asset-registry loadFontAsset); the produced payload\n    // mirrors that shape. atlas Handle / sampler Handle are runtime-resolved\n    // from the GUID refs, so the build-time payload carries the GUID strings\n    // (cast through FontAsset for the ImportedAsset.payload Asset slot, same\n    // build-time POD-vs-Handle bridge the gltfImporter scene arm uses).\n    const fontPayload = {\n      kind: 'font',\n      atlasGuid: atlasSub?.guid ?? '',\n      samplerGuid: samplerSub?.guid ?? '',\n      glyphs: atlasGlyphsToMetrics(atlas),\n      common: makeFontCommon(atlas),\n    } as unknown as FontAsset;\n    out.push({\n      guid: fontSub.guid,\n      kind: 'font',\n      payload: fontPayload,\n      refs: [\n        ...(atlasSub !== undefined ? [{ guid: atlasSub.guid }] : []),\n        ...(samplerSub !== undefined ? [{ guid: samplerSub.guid }] : []),\n      ],\n      artifacts: {},\n    });\n  }\n  return { ok: true, value: { assets: out, sourceDependencies: [] } };\n}\n\n/**\n * The font {@link Importer}. Register it into an `ImporterRegistry` so the\n * import runner dispatches `meta.importer === 'font'` sidecars here.\n *\n * @example\n * ```ts\n * import { ImporterRegistry } from '@forgeax/engine-import';\n * import { fontImporter } from '@forgeax/engine-font/font-importer';\n * const importers = new ImporterRegistry();\n * importers.register(fontImporter);\n * ```\n */\nexport const fontImporter: Importer = {\n  key: 'font',\n  import: importFont,\n};\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { fontContribution } from './runtime/font-decoder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,54 @@
+import { AssetGuid } from '@forgeax/engine-pack/guid';
+import { ok, err } from '@forgeax/engine-types';
+
+// src/runtime/font-decoder.ts
+function parseGuid(value) {
+  if (value instanceof Uint8Array && value.length === 16) return value;
+  if (Array.isArray(value) && value.length === 16 && value.every((item) => Number.isInteger(item) && item >= 0 && item <= 255)) {
+    return Uint8Array.from(value);
+  }
+  if (typeof value !== "string") return void 0;
+  const parsed = AssetGuid.parse(value);
+  return parsed.ok ? parsed.value : void 0;
+}
+function validCommon(value) {
+  if (value === null || typeof value !== "object") return false;
+  const common = value;
+  return ["lineHeight", "base", "distanceRange", "pxRange", "atlasWidth", "atlasHeight"].every(
+    (key) => typeof common[key] === "number" && Number.isFinite(common[key])
+  );
+}
+var fontContribution = {
+  kind: { kind: "font" },
+  consumer: "GlyphTextLayout",
+  decoder: {
+    async decode({ envelope }) {
+      const payload = envelope.payload;
+      if (payload !== null && typeof payload === "object") {
+        const source = payload;
+        const atlas = parseGuid(source.atlas ?? source.atlasGuid);
+        const sampler = parseGuid(source.sampler ?? source.samplerGuid);
+        if ((source.kind === void 0 || source.kind === "font") && atlas !== void 0 && sampler !== void 0 && source.glyphs !== null && typeof source.glyphs === "object" && validCommon(source.common)) {
+          return ok({
+            kind: "font",
+            atlas,
+            sampler,
+            glyphs: source.glyphs,
+            common: source.common,
+            ...source.notdef === void 0 ? {} : { notdef: source.notdef }
+          });
+        }
+      }
+      return err({
+        code: "asset-package-invalid",
+        expected: "a font payload with atlas and sampler references",
+        hint: "recook the font atlas and publish its local sub-assets",
+        detail: { guid: envelope.guid, reason: "font owner validation failed" }
+      });
+    }
+  }
+};
+
+export { fontContribution };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/font-decoder.ts"],"names":[],"mappings":";;;;AASA,SAAS,UAAU,KAAA,EAAgD;AACjE,EAAA,IAAI,KAAA,YAAiB,UAAA,IAAc,KAAA,CAAM,MAAA,KAAW,IAAI,OAAO,KAAA;AAC/D,EAAA,IACE,MAAM,OAAA,CAAQ,KAAK,KACnB,KAAA,CAAM,MAAA,KAAW,MACjB,KAAA,CAAM,KAAA,CAAM,CAAC,IAAA,KAAS,MAAA,CAAO,UAAU,IAAI,CAAA,IAAK,QAAQ,CAAA,IAAK,IAAA,IAAQ,GAAG,CAAA,EACxE;AACA,IAAA,OAAO,UAAA,CAAW,KAAK,KAAK,CAAA;AAAA,EAC9B;AACA,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,OAAO,MAAA;AACtC,EAAA,MAAM,MAAA,GAAS,SAAA,CAAU,KAAA,CAAM,KAAK,CAAA;AACpC,EAAA,OAAO,MAAA,CAAO,EAAA,GAAK,MAAA,CAAO,KAAA,GAAQ,MAAA;AACpC;AAEA,SAAS,YAAY,KAAA,EAA8C;AACjE,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AACxD,EAAA,MAAM,MAAA,GAAS,KAAA;AACf,EAAA,OAAO,CAAC,YAAA,EAAc,MAAA,EAAQ,iBAAiB,SAAA,EAAW,YAAA,EAAc,aAAa,CAAA,CAAE,KAAA;AAAA,IACrF,CAAC,GAAA,KAAQ,OAAO,MAAA,CAAO,GAAG,CAAA,KAAM,QAAA,IAAY,MAAA,CAAO,QAAA,CAAS,MAAA,CAAO,GAAG,CAAC;AAAA,GACzE;AACF;AAEO,IAAM,gBAAA,GAAgE;AAAA,EAC3E,IAAA,EAAM,EAAE,IAAA,EAAM,MAAA,EAAO;AAAA,EACrB,QAAA,EAAU,iBAAA;AAAA,EACV,OAAA,EAAS;AAAA,IACP,MAAM,MAAA,CAAO,EAAE,QAAA,EAAS,EAAG;AACzB,MAAA,MAAM,UAAU,QAAA,CAAS,OAAA;AACzB,MAAA,IAAI,OAAA,KAAY,IAAA,IAAQ,OAAO,OAAA,KAAY,QAAA,EAAU;AACnD,QAAA,MAAM,MAAA,GAAS,OAAA;AACf,QAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,MAAA,CAAO,KAAA,IAAS,OAAO,SAAS,CAAA;AACxD,QAAA,MAAM,OAAA,GAAU,SAAA,CAAU,MAAA,CAAO,OAAA,IAAW,OAAO,WAAW,CAAA;AAC9D,QAAA,IAAA,CACG,MAAA,CAAO,SAAS,MAAA,IAAa,MAAA,CAAO,SAAS,MAAA,KAC9C,KAAA,KAAU,UACV,OAAA,KAAY,MAAA,IACZ,OAAO,MAAA,KAAW,IAAA,IAClB,OAAO,MAAA,CAAO,MAAA,KAAW,YACzB,WAAA,CAAY,MAAA,CAAO,MAAM,CAAA,EACzB;AACA,UAAA,OAAO,EAAA,CAAG;AAAA,YACR,IAAA,EAAM,MAAA;AAAA,YACN,KAAA;AAAA,YACA,OAAA;AAAA,YACA,QAAQ,MAAA,CAAO,MAAA;AAAA,YACf,QAAQ,MAAA,CAAO,MAAA;AAAA,YACf,GAAI,OAAO,MAAA,KAAW,MAAA,GAClB,EAAC,GACD,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAA;AAA2C,WACjE,CAAA;AAAA,QACH;AAAA,MACF;AACA,MAAA,OAAO,GAAA,CAAI;AAAA,QACT,IAAA,EAAM,uBAAA;AAAA,QACN,QAAA,EAAU,kDAAA;AAAA,QACV,IAAA,EAAM,wDAAA;AAAA,QACN,QAAQ,EAAE,IAAA,EAAM,QAAA,CAAS,IAAA,EAAM,QAAQ,8BAAA;AAA+B,OACvE,CAAA;AAAA,IACH;AAAA;AAEJ","file":"index.mjs","sourcesContent":["import { AssetGuid } from '@forgeax/engine-pack/guid';\nimport {\n  type AssetDecoderContribution,\n  type AssetKind,\n  err,\n  type FontAsset,\n  ok,\n} from '@forgeax/engine-types';\n\nfunction parseGuid(value: unknown): FontAsset['atlas'] | undefined {\n  if (value instanceof Uint8Array && value.length === 16) return value as FontAsset['atlas'];\n  if (\n    Array.isArray(value) &&\n    value.length === 16 &&\n    value.every((item) => Number.isInteger(item) && item >= 0 && item <= 255)\n  ) {\n    return Uint8Array.from(value) as FontAsset['atlas'];\n  }\n  if (typeof value !== 'string') return undefined;\n  const parsed = AssetGuid.parse(value);\n  return parsed.ok ? parsed.value : undefined;\n}\n\nfunction validCommon(value: unknown): value is FontAsset['common'] {\n  if (value === null || typeof value !== 'object') return false;\n  const common = value as Record<string, unknown>;\n  return ['lineHeight', 'base', 'distanceRange', 'pxRange', 'atlasWidth', 'atlasHeight'].every(\n    (key) => typeof common[key] === 'number' && Number.isFinite(common[key]),\n  );\n}\n\nexport const fontContribution: AssetDecoderContribution<FontAsset, 'font'> = {\n  kind: { kind: 'font' } as AssetKind<FontAsset, 'font'>,\n  consumer: 'GlyphTextLayout',\n  decoder: {\n    async decode({ envelope }) {\n      const payload = envelope.payload as unknown;\n      if (payload !== null && typeof payload === 'object') {\n        const source = payload as Record<string, unknown>;\n        const atlas = parseGuid(source.atlas ?? source.atlasGuid);\n        const sampler = parseGuid(source.sampler ?? source.samplerGuid);\n        if (\n          (source.kind === undefined || source.kind === 'font') &&\n          atlas !== undefined &&\n          sampler !== undefined &&\n          source.glyphs !== null &&\n          typeof source.glyphs === 'object' &&\n          validCommon(source.common)\n        ) {\n          return ok({\n            kind: 'font',\n            atlas,\n            sampler,\n            glyphs: source.glyphs as FontAsset['glyphs'],\n            common: source.common,\n            ...(source.notdef === undefined\n              ? {}\n              : { notdef: source.notdef as NonNullable<FontAsset['notdef']> }),\n          });\n        }\n      }\n      return err({\n        code: 'asset-package-invalid',\n        expected: 'a font payload with atlas and sampler references',\n        hint: 'recook the font atlas and publish its local sub-assets',\n        detail: { guid: envelope.guid, reason: 'font owner validation failed' },\n      });\n    },\n  },\n};\n"]}

package/dist/node-msdf-worker.mjs

@@ -0,0 +1,35 @@
+import { parentPort } from 'worker_threads';
+
+// src/node-msdf-worker.mjs
+if (parentPort === null) {
+  throw new Error("the MSDF Node worker requires worker_threads.parentPort");
+}
+var listeners = /* @__PURE__ */ new Map();
+var endpoint = globalThis;
+var NodeImageData = class {
+  constructor(data, width, height) {
+    this.data = data;
+    this.width = width;
+    this.height = height;
+  }
+};
+endpoint.ImageData = NodeImageData;
+endpoint.addEventListener = (type, listener) => {
+  if (type !== "message") return;
+  const handler = (data) => listener({ data, origin: "*" });
+  listeners.set(listener, handler);
+  parentPort.on("message", handler);
+};
+endpoint.removeEventListener = (type, listener) => {
+  if (type !== "message") return;
+  const handler = listeners.get(listener);
+  if (handler === void 0) return;
+  listeners.delete(listener);
+  parentPort.off("message", handler);
+};
+endpoint.postMessage = (message, transferList = []) => {
+  parentPort.postMessage(message, [...transferList]);
+};
+await import('@zappar/msdf-generator/worker.js');
+//# sourceMappingURL=node-msdf-worker.mjs.map
+//# sourceMappingURL=node-msdf-worker.mjs.map