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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +98 -0
  3. package/dist/.tsbuildinfo +1 -0
  4. package/dist/__tests__/font-importer.test.d.ts +2 -0
  5. package/dist/__tests__/font-importer.test.d.ts.map +1 -0
  6. package/dist/__tests__/font-local-artifacts.test.d.ts +2 -0
  7. package/dist/__tests__/font-local-artifacts.test.d.ts.map +1 -0
  8. package/dist/__tests__/font.unit.test.d.ts +2 -0
  9. package/dist/__tests__/font.unit.test.d.ts.map +1 -0
  10. package/dist/cli-font.d.ts +96 -0
  11. package/dist/cli-font.d.ts.map +1 -0
  12. package/dist/cli-font.mjs +339 -0
  13. package/dist/cli-font.mjs.map +1 -0
  14. package/dist/font-importer.d.ts +18 -0
  15. package/dist/font-importer.d.ts.map +1 -0
  16. package/dist/font-importer.mjs +469 -0
  17. package/dist/font-importer.mjs.map +1 -0
  18. package/dist/index.d.ts +2 -0
  19. package/dist/index.d.ts.map +1 -0
  20. package/dist/index.mjs +54 -0
  21. package/dist/index.mjs.map +1 -0
  22. package/dist/node-msdf-worker.mjs +35 -0
  23. package/dist/node-msdf-worker.mjs.map +1 -0
  24. package/dist/node-worker-adapter.d.ts +17 -0
  25. package/dist/node-worker-adapter.d.ts.map +1 -0
  26. package/dist/runtime/font-decoder.d.ts +3 -0
  27. package/dist/runtime/font-decoder.d.ts.map +1 -0
  28. package/package.json +80 -0
  29. package/src/__tests__/font-importer.test.ts +24 -0
  30. package/src/__tests__/font-local-artifacts.test.ts +58 -0
  31. package/src/__tests__/font.unit.test.ts +394 -0
  32. package/src/cli-font.ts +472 -0
  33. package/src/font-importer.ts +205 -0
  34. package/src/index.ts +7 -0
  35. package/src/node-msdf-worker.mjs +38 -0
  36. package/src/node-worker-adapter.ts +41 -0
  37. package/src/runtime/font-decoder.ts +70 -0
@@ -0,0 +1,96 @@
1
+ #!/usr/bin/env node
2
+ import { type GlyphMetric } from '@forgeax/engine-types';
3
+ /**
4
+ * Minimal subset of the @zappar/msdf-generator glyph record consumed by the
5
+ * bake. Mirrors the package's `GlyphInfo` (dist/index.d.ts) -- only the fields
6
+ * the BMFont -> FontAsset mapping needs (toolchain wiki section 4).
7
+ */
8
+ export interface BakeGlyph {
9
+ readonly unicode: number;
10
+ readonly advance: number;
11
+ readonly xoffset: number;
12
+ readonly yoffset: number;
13
+ readonly atlasPosition: readonly [number, number];
14
+ readonly atlasSize: readonly [number, number];
15
+ }
16
+ /**
17
+ * Minimal subset of the @zappar/msdf-generator `MSDFAtlas` consumed by the
18
+ * bake. `texture` carries the RGBA pixel buffer + dimensions (the package's
19
+ * `ImageData`-shaped texture, but reduced to POD so the bake stays
20
+ * environment-agnostic for testing).
21
+ */
22
+ export interface BakeAtlas {
23
+ readonly texture: {
24
+ readonly width: number;
25
+ readonly height: number;
26
+ readonly data: Uint8Array;
27
+ };
28
+ readonly glyphs: readonly BakeGlyph[];
29
+ readonly metrics: {
30
+ readonly lineHeight: number;
31
+ readonly ascender: number;
32
+ };
33
+ readonly textureSize: readonly [number, number];
34
+ readonly fieldRange: number;
35
+ }
36
+ /**
37
+ * The bake-time MSDF generator contract. Injected into {@link bakeFont} so
38
+ * unit tests can supply a mock (real path: `@zappar/msdf-generator`'s `MSDF`).
39
+ */
40
+ export interface MsdfGenerator {
41
+ generateAtlas(ttf: Uint8Array): Promise<BakeAtlas>;
42
+ dispose(): Promise<void>;
43
+ }
44
+ /**
45
+ * Bake-time sidecar JSON shape (importer: 'font'). Carries the glyph metrics
46
+ * (BMFont -> FontAsset mapping, toolchain wiki section 4) + the common block
47
+ * (distanceRange / atlas dimensions). Parsed by the runtime font load path.
48
+ */
49
+ export interface BakeSidecar {
50
+ readonly schemaVersion: string;
51
+ readonly kind: 'external-asset-package';
52
+ readonly importer: 'font';
53
+ readonly source: string;
54
+ readonly importSettings: {
55
+ readonly colorSpace: 'linear';
56
+ readonly mipmap: 'none';
57
+ };
58
+ readonly common: {
59
+ readonly lineHeight: number;
60
+ readonly base: number;
61
+ readonly distanceRange: number;
62
+ readonly pxRange: number;
63
+ readonly atlasWidth: number;
64
+ readonly atlasHeight: number;
65
+ };
66
+ readonly glyphs: Record<number, GlyphMetric>;
67
+ }
68
+ /**
69
+ * Encode an RGBA pixel buffer into a PNG (zlib deflate, no external deps).
70
+ * The atlas texture from @zappar is RGBA8; this writes a standard 8-bit
71
+ * RGBA PNG so any consumer (engine image importer / browser) can decode it.
72
+ */
73
+ export declare function encodePng(width: number, height: number, rgba: Uint8Array): Uint8Array;
74
+ /** Map a @zappar atlas into the FontAsset glyph-metrics sidecar shape. */
75
+ export declare function atlasToSidecar(atlas: BakeAtlas, sourcePng: string): BakeSidecar;
76
+ /** Result of a successful bake -- the written artefact paths. */
77
+ export interface BakeResult {
78
+ readonly atlasPath: string;
79
+ readonly sidecarPath: string;
80
+ }
81
+ /**
82
+ * Bake an MSDF atlas + glyph-metrics sidecar from a TTF.
83
+ *
84
+ * @param ttfPath path to the TrueType source.
85
+ * @param outDir output directory (created if missing).
86
+ * @param generatorFactory yields the MSDF generator (real: @zappar; tests: mock).
87
+ * @returns `Result`-style: throws a {@link FontError} on every failure mode
88
+ * (unsupported-font-format before the generator runs; bake-failed when the
89
+ * generator throws). The CLI layer maps the thrown FontError to a structured
90
+ * stderr line + exit code 1 -- never a silent exit 0 without artefacts
91
+ * (charter P3).
92
+ */
93
+ export declare function bakeFont(ttfPath: string, outDir: string, generatorFactory: () => Promise<MsdfGenerator>): Promise<BakeResult>;
94
+ export declare function realGeneratorFactory(): Promise<MsdfGenerator>;
95
+ export declare function runCliFont(argv: string[]): Promise<number>;
96
+ //# sourceMappingURL=cli-font.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-font.d.ts","sourceRoot":"","sources":["../src/cli-font.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,339 @@
1
+ #!/usr/bin/env node
2
+ import { Buffer } from 'buffer';
3
+ import { realpath, readFile, mkdir, writeFile } from 'fs/promises';
4
+ import { basename, extname, join } from 'path';
5
+ import { fileURLToPath } from 'url';
6
+ import { parseArgs } from 'util';
7
+ import { deflateSync } from 'zlib';
8
+ import { FontError } from '@forgeax/engine-types';
9
+ import { Worker } from 'worker_threads';
10
+
11
+ var NodeWorkerAdapter = class {
12
+ worker;
13
+ listeners = /* @__PURE__ */ new Map();
14
+ constructor(url) {
15
+ this.worker = new Worker(url);
16
+ }
17
+ postMessage(message, transferList = []) {
18
+ this.worker.postMessage(message, [...transferList]);
19
+ }
20
+ addEventListener(type, listener) {
21
+ if (type !== "message") return;
22
+ const handler = (data) => listener({ data, origin: "*" });
23
+ this.listeners.set(listener, handler);
24
+ this.worker.on("message", handler);
25
+ }
26
+ removeEventListener(type, listener) {
27
+ if (type !== "message") return;
28
+ const handler = this.listeners.get(listener);
29
+ if (handler === void 0) return;
30
+ this.listeners.delete(listener);
31
+ this.worker.off("message", handler);
32
+ }
33
+ terminate() {
34
+ return this.worker.terminate();
35
+ }
36
+ };
37
+
38
+ // src/cli-font.ts
39
+ var DEFAULT_CHARSET = (() => {
40
+ let s = "";
41
+ for (let c = 32; c <= 126; c++) s += String.fromCharCode(c);
42
+ return s;
43
+ })();
44
+ var DEFAULT_TEXTURE_SIZE = 1024;
45
+ var DEFAULT_FIELD_RANGE = 4;
46
+ var DEFAULT_FONT_SIZE = 48;
47
+ function isSupportedFontMagic(bytes) {
48
+ if (bytes.length < 4) return false;
49
+ const b0 = bytes[0] ?? 0;
50
+ const b1 = bytes[1] ?? 0;
51
+ const b2 = bytes[2] ?? 0;
52
+ const b3 = bytes[3] ?? 0;
53
+ const isTrueType = b0 === 0 && b1 === 1 && b2 === 0 && b3 === 0;
54
+ const isTrue = b0 === 116 && b1 === 114 && b2 === 117 && b3 === 101;
55
+ const isOtto = b0 === 79 && b1 === 84 && b2 === 84 && b3 === 79;
56
+ return isTrueType || isTrue || isOtto;
57
+ }
58
+ function crc32(bytes) {
59
+ let crc = 4294967295;
60
+ for (let i = 0; i < bytes.length; i++) {
61
+ crc ^= bytes[i] ?? 0;
62
+ for (let k = 0; k < 8; k++) {
63
+ crc = crc & 1 ? crc >>> 1 ^ 3988292384 : crc >>> 1;
64
+ }
65
+ }
66
+ return (crc ^ 4294967295) >>> 0;
67
+ }
68
+ function pngChunk(type, data) {
69
+ const typeBytes = new Uint8Array([
70
+ type.charCodeAt(0),
71
+ type.charCodeAt(1),
72
+ type.charCodeAt(2),
73
+ type.charCodeAt(3)
74
+ ]);
75
+ const body = new Uint8Array(typeBytes.length + data.length);
76
+ body.set(typeBytes, 0);
77
+ body.set(data, typeBytes.length);
78
+ const out = new Uint8Array(4 + body.length + 4);
79
+ const dv = new DataView(out.buffer);
80
+ dv.setUint32(0, data.length);
81
+ out.set(body, 4);
82
+ dv.setUint32(4 + body.length, crc32(body));
83
+ return out;
84
+ }
85
+ function encodePng(width, height, rgba) {
86
+ const stride = width * 4;
87
+ const raw = new Uint8Array((stride + 1) * height);
88
+ for (let y = 0; y < height; y++) {
89
+ raw[y * (stride + 1)] = 0;
90
+ raw.set(rgba.subarray(y * stride, y * stride + stride), y * (stride + 1) + 1);
91
+ }
92
+ const idat = deflateSync(raw);
93
+ const ihdr = new Uint8Array(13);
94
+ const dv = new DataView(ihdr.buffer);
95
+ dv.setUint32(0, width);
96
+ dv.setUint32(4, height);
97
+ ihdr[8] = 8;
98
+ ihdr[9] = 6;
99
+ ihdr[10] = 0;
100
+ ihdr[11] = 0;
101
+ ihdr[12] = 0;
102
+ const signature = new Uint8Array([137, 80, 78, 71, 13, 10, 26, 10]);
103
+ const chunks = [
104
+ signature,
105
+ pngChunk("IHDR", ihdr),
106
+ pngChunk("IDAT", new Uint8Array(idat)),
107
+ pngChunk("IEND", new Uint8Array(0))
108
+ ];
109
+ const total = chunks.reduce((n, c) => n + c.length, 0);
110
+ const out = new Uint8Array(total);
111
+ let off = 0;
112
+ for (const c of chunks) {
113
+ out.set(c, off);
114
+ off += c.length;
115
+ }
116
+ return out;
117
+ }
118
+ function atlasToSidecar(atlas, sourcePng) {
119
+ const glyphs = {};
120
+ for (const g of atlas.glyphs) {
121
+ glyphs[g.unicode] = {
122
+ advance: g.advance,
123
+ bearingX: g.xoffset,
124
+ bearingY: g.yoffset,
125
+ size: { w: g.atlasSize[0], h: g.atlasSize[1] },
126
+ region: {
127
+ x: g.atlasPosition[0],
128
+ y: g.atlasPosition[1],
129
+ w: g.atlasSize[0],
130
+ h: g.atlasSize[1]
131
+ }
132
+ };
133
+ }
134
+ return {
135
+ schemaVersion: "1.0.0",
136
+ kind: "external-asset-package",
137
+ importer: "font",
138
+ source: sourcePng,
139
+ importSettings: { colorSpace: "linear", mipmap: "none" },
140
+ common: {
141
+ lineHeight: atlas.metrics.lineHeight,
142
+ base: atlas.metrics.ascender,
143
+ distanceRange: atlas.fieldRange,
144
+ pxRange: atlas.fieldRange,
145
+ atlasWidth: atlas.textureSize[0],
146
+ atlasHeight: atlas.textureSize[1]
147
+ },
148
+ glyphs
149
+ };
150
+ }
151
+ async function bakeFont(ttfPath, outDir, generatorFactory) {
152
+ const ttf = await readFile(ttfPath);
153
+ const ttfBytes = new Uint8Array(ttf.buffer, ttf.byteOffset, ttf.byteLength);
154
+ if (!isSupportedFontMagic(ttfBytes)) {
155
+ throw new FontError({
156
+ code: "unsupported-font-format",
157
+ expected: "ttf",
158
+ hint: 'bake accepts TrueType (.ttf / 0x00010000 / "true") or OpenType-TTF ("OTTO") sources; WOFF / WOFF2 / other formats are not supported -- convert to TTF first',
159
+ detail: { path: ttfPath }
160
+ });
161
+ }
162
+ let atlas;
163
+ let generator;
164
+ try {
165
+ generator = await generatorFactory();
166
+ atlas = await generator.generateAtlas(ttfBytes);
167
+ } catch (e) {
168
+ throw new FontError({
169
+ code: "bake-failed",
170
+ expected: "@zappar/msdf-generator to produce an MSDF atlas",
171
+ 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',
172
+ detail: { cause: e instanceof Error ? e.message : String(e) }
173
+ });
174
+ } finally {
175
+ if (generator !== void 0) {
176
+ await generator.dispose().catch(() => void 0);
177
+ }
178
+ }
179
+ await mkdir(outDir, { recursive: true });
180
+ const base = basename(ttfPath, extname(ttfPath));
181
+ const atlasName = `${base}.atlas.png`;
182
+ const atlasPath = join(outDir, atlasName);
183
+ const sidecarPath = join(outDir, `${base}.meta.json`);
184
+ const png = encodePng(atlas.texture.width, atlas.texture.height, atlas.texture.data);
185
+ await writeFile(atlasPath, png);
186
+ const sidecar = atlasToSidecar(atlas, atlasName);
187
+ await writeFile(sidecarPath, `${JSON.stringify(sidecar, null, 2)}
188
+ `);
189
+ return { atlasPath, sidecarPath };
190
+ }
191
+ async function realGeneratorFactory() {
192
+ const mod = await import('@zappar/msdf-generator');
193
+ const wasmModuleUrl = import.meta.resolve("@zappar/msdf-generator/msdfgen_wasm.wasm");
194
+ const wasmBytes = await readFile(new URL(wasmModuleUrl));
195
+ const wasmUrl = `data:application/octet-stream;base64,${Buffer.from(wasmBytes).toString("base64")}`;
196
+ const nodeGlobal = globalThis;
197
+ const previousWorker = nodeGlobal.Worker;
198
+ nodeGlobal.Worker = NodeWorkerAdapter;
199
+ let msdf;
200
+ try {
201
+ msdf = new mod.MSDF({
202
+ workerUrl: new URL("./node-msdf-worker.mjs", import.meta.url),
203
+ wasmUrl
204
+ });
205
+ await msdf.initialize();
206
+ } finally {
207
+ if (previousWorker === void 0) {
208
+ delete nodeGlobal.Worker;
209
+ } else {
210
+ nodeGlobal.Worker = previousWorker;
211
+ }
212
+ }
213
+ if (msdf === void 0) {
214
+ throw new Error("the MSDF generator did not initialize");
215
+ }
216
+ return {
217
+ async generateAtlas(ttf) {
218
+ const a = await msdf.generateAtlas({
219
+ font: ttf,
220
+ charset: DEFAULT_CHARSET,
221
+ textureSize: [DEFAULT_TEXTURE_SIZE, DEFAULT_TEXTURE_SIZE],
222
+ fieldRange: DEFAULT_FIELD_RANGE,
223
+ fontSize: DEFAULT_FONT_SIZE
224
+ });
225
+ return {
226
+ texture: {
227
+ width: a.texture.width,
228
+ height: a.texture.height,
229
+ data: new Uint8Array(a.texture.data)
230
+ },
231
+ glyphs: a.glyphs.map((g) => ({
232
+ unicode: g.unicode,
233
+ advance: g.advance,
234
+ xoffset: g.xoffset,
235
+ yoffset: g.yoffset,
236
+ atlasPosition: [g.atlasPosition[0], g.atlasPosition[1]],
237
+ atlasSize: [g.atlasSize[0], g.atlasSize[1]]
238
+ })),
239
+ metrics: { lineHeight: a.metrics.lineHeight, ascender: a.metrics.ascender },
240
+ textureSize: [a.textureSize[0], a.textureSize[1]],
241
+ fieldRange: a.fieldRange
242
+ };
243
+ },
244
+ async dispose() {
245
+ await msdf.dispose();
246
+ }
247
+ };
248
+ }
249
+ function bakeHelpBody() {
250
+ return [
251
+ "forgeax-engine-remote-font bake \u2014 bake MSDF font atlas from TTF",
252
+ "",
253
+ "Usage:",
254
+ " forgeax-engine-remote-font bake <ttf> <out>",
255
+ "",
256
+ "Reads a TrueType font file and produces:",
257
+ ` <out>/<basename>.atlas.png \u2014 ${DEFAULT_TEXTURE_SIZE}x${DEFAULT_TEXTURE_SIZE} MSDF atlas`,
258
+ " <out>/<basename>.meta.json \u2014 glyph metrics sidecar (importer: font)",
259
+ ""
260
+ ].join("\n");
261
+ }
262
+ function helpBody() {
263
+ return [
264
+ "forgeax-engine-remote-font \u2014 MSDF font atlas baking",
265
+ "",
266
+ "Usage:",
267
+ " forgeax-engine-remote-font bake <ttf> <out>",
268
+ ""
269
+ ].join("\n");
270
+ }
271
+ async function runCliFont(argv) {
272
+ const [sub, ...rest] = argv;
273
+ if (sub === void 0 || sub === "--help" || sub === "-h") {
274
+ process.stdout.write(`${helpBody()}
275
+ `);
276
+ return 0;
277
+ }
278
+ if (sub !== "bake") {
279
+ process.stderr.write(`unknown subcommand: ${sub}
280
+ `);
281
+ return 1;
282
+ }
283
+ return runBake(rest);
284
+ }
285
+ async function runBake(rest) {
286
+ if (rest[0] === "--help" || rest[0] === "-h") {
287
+ process.stdout.write(`${bakeHelpBody()}
288
+ `);
289
+ return 0;
290
+ }
291
+ let positionals;
292
+ try {
293
+ const parsed = parseArgs({ args: rest, allowPositionals: true, strict: true });
294
+ positionals = [...parsed.positionals];
295
+ } catch {
296
+ process.stderr.write("error parsing CLI args\n");
297
+ return 1;
298
+ }
299
+ const ttfPath = positionals[0];
300
+ const outDir = positionals[1];
301
+ if (ttfPath === void 0 || outDir === void 0) {
302
+ process.stderr.write("usage: forgeax-engine-remote-font bake <ttf> <out>\n");
303
+ return 1;
304
+ }
305
+ try {
306
+ const result = await bakeFont(ttfPath, outDir, realGeneratorFactory);
307
+ process.stdout.write(`baked ${result.atlasPath} + ${result.sidecarPath}
308
+ `);
309
+ return 0;
310
+ } catch (e) {
311
+ if (e instanceof FontError) {
312
+ process.stderr.write(
313
+ `${JSON.stringify({ code: e.code, expected: e.expected, hint: e.hint, detail: e.detail })}
314
+ `
315
+ );
316
+ return 1;
317
+ }
318
+ process.stderr.write(`bake failed: ${e instanceof Error ? e.message : String(e)}
319
+ `);
320
+ return 1;
321
+ }
322
+ }
323
+ var isBinEntry = await (async () => {
324
+ const argv1 = process.argv[1];
325
+ if (typeof argv1 !== "string") return false;
326
+ const argv1Real = await realpath(argv1).catch(() => argv1);
327
+ const selfReal = await realpath(fileURLToPath(import.meta.url)).catch(
328
+ () => fileURLToPath(import.meta.url)
329
+ );
330
+ return argv1Real === selfReal;
331
+ })();
332
+ if (isBinEntry) {
333
+ const exitCode = await runCliFont(process.argv.slice(2));
334
+ process.exit(exitCode);
335
+ }
336
+
337
+ export { atlasToSidecar, bakeFont, encodePng, realGeneratorFactory, runCliFont };
338
+ //# sourceMappingURL=cli-font.mjs.map
339
+ //# sourceMappingURL=cli-font.mjs.map
@@ -0,0 +1 @@
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\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"]}
@@ -0,0 +1,18 @@
1
+ import type { Importer } from '@forgeax/engine-types';
2
+ /** Stable semantic identities for the three writable font outputs. */
3
+ export declare function sourceKeyForFontOutput(kind: string): string | undefined;
4
+ export declare function fontOutputSourceKeys(): readonly string[];
5
+ /**
6
+ * The font {@link Importer}. Register it into an `ImporterRegistry` so the
7
+ * import runner dispatches `meta.importer === 'font'` sidecars here.
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * import { ImporterRegistry } from '@forgeax/engine-import';
12
+ * import { fontImporter } from '@forgeax/engine-font/font-importer';
13
+ * const importers = new ImporterRegistry();
14
+ * importers.register(fontImporter);
15
+ * ```
16
+ */
17
+ export declare const fontImporter: Importer;
18
+ //# sourceMappingURL=font-importer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"font-importer.d.ts","sourceRoot":"","sources":["../src/font-importer.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAKV,QAAQ,EAIT,MAAM,uBAAuB,CAAC;AAI/B,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGvE;AAED,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD;AAuID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,EAAE,QAG1B,CAAC"}