@flighthq/bitmapfont-formats 0.5.1-next.920.da8f530 → 0.6.0

package/dist/explainBitmapFontParse.d.ts

@@ -0,0 +1,4 @@
+import type { BitmapFontParseOptions } from '@flighthq/bitmapfont/contract';
+import type { BitmapFontParseExplanation } from './types.ts';
+export declare function explainBitmapFontParse(text: string, options?: Readonly<BitmapFontParseOptions>): BitmapFontParseExplanation;
+//# sourceMappingURL=explainBitmapFontParse.d.ts.map

package/dist/explainBitmapFontParse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainBitmapFontParse.d.ts","sourceRoot":"","sources":["../src/explainBitmapFontParse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAE5E,OAAO,KAAK,EACV,0BAA0B,EAG3B,MAAM,YAAY,CAAC;AAEpB,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACzC,0BAA0B,CAgB5B"}

package/dist/explainBitmapFontParse.js

@@ -0,0 +1,194 @@
+export function explainBitmapFontParse(text, options) {
+    const json = probeJson(text);
+    if (json !== null)
+        return buildExplanation('json', json, options);
+    const xml = probeXml(text);
+    if (xml !== null)
+        return buildExplanation('xml', xml, options);
+    const fnt = probeFnt(text);
+    if (fnt !== null)
+        return buildExplanation('fnt', fnt, options);
+    return {
+        charCount: 0,
+        detectedFormat: 'unknown',
+        kerningCount: 0,
+        pageCount: 0,
+        reason: 'invalid-data',
+        success: false,
+        unresolvedPages: [],
+    };
+}
+function buildExplanation(detectedFormat, probe, options) {
+    let reason;
+    const unresolvedPages = [];
+    if (!probe.hasCommon) {
+        reason = 'missing-common';
+    }
+    else if (probe.charCount === 0) {
+        reason = 'missing-chars';
+    }
+    else {
+        const resolvePage = options?.resolvePage;
+        for (const pageId of probe.referencedPages) {
+            if (resolvePage === undefined || resolvePage(pageId, '') === null) {
+                unresolvedPages.push(pageId);
+            }
+        }
+        reason = unresolvedPages.length > 0 ? 'unresolved-page' : 'ok';
+    }
+    return {
+        charCount: probe.charCount,
+        detectedFormat,
+        kerningCount: probe.kerningCount,
+        pageCount: probe.pageIds.length,
+        reason,
+        success: reason === 'ok',
+        unresolvedPages,
+    };
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function probeJson(text) {
+    let root;
+    try {
+        root = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (!isObject(root))
+        return null;
+    const common = root.common;
+    const hasCommon = isObject(common) &&
+        typeof common.lineHeight === 'number' &&
+        Number.isFinite(common.lineHeight) &&
+        typeof common.base === 'number' &&
+        Number.isFinite(common.base);
+    const rawChars = root.chars;
+    const charIterable = Array.isArray(rawChars) ? rawChars : isObject(rawChars) ? Object.values(rawChars) : [];
+    let charCount = 0;
+    const referencedPages = new Set();
+    for (const raw of charIterable) {
+        if (isObject(raw) && typeof raw.id === 'number' && Number.isFinite(raw.id)) {
+            charCount++;
+            const page = typeof raw.page === 'number' && Number.isFinite(raw.page) ? raw.page : 0;
+            referencedPages.add(page);
+        }
+    }
+    const pageIds = [];
+    if (Array.isArray(root.pages)) {
+        for (let id = 0; id < root.pages.length; id++)
+            pageIds.push(id);
+    }
+    let kerningCount = 0;
+    if (Array.isArray(root.kernings)) {
+        for (const raw of root.kernings) {
+            if (isObject(raw) &&
+                typeof raw.first === 'number' &&
+                typeof raw.second === 'number' &&
+                typeof raw.amount === 'number') {
+                kerningCount++;
+            }
+        }
+    }
+    return { charCount, hasCommon, kerningCount, pageIds, referencedPages };
+}
+function probeFnt(text) {
+    let hasCommon = false;
+    let charCount = 0;
+    let kerningCount = 0;
+    const pageIds = [];
+    const referencedPages = new Set();
+    let hasAnyTag = false;
+    for (const rawLine of text.split(/\r\n?|\n/)) {
+        const line = rawLine.trim();
+        if (line === '')
+            continue;
+        const spaceAt = line.search(/\s/);
+        const tag = spaceAt < 0 ? line : line.slice(0, spaceAt);
+        if (tag === 'common') {
+            hasAnyTag = true;
+            const fields = parseFntFields(line.slice(tag.length));
+            hasCommon = fields.lineHeight !== undefined && fields.base !== undefined;
+        }
+        else if (tag === 'page') {
+            hasAnyTag = true;
+            const fields = parseFntFields(line.slice(tag.length));
+            const id = readFntNumber(fields.id);
+            if (id !== null)
+                pageIds.push(id);
+        }
+        else if (tag === 'char') {
+            hasAnyTag = true;
+            const fields = parseFntFields(line.slice(tag.length));
+            if (fields.id !== undefined) {
+                charCount++;
+                const page = readFntNumber(fields.page) ?? 0;
+                referencedPages.add(page);
+            }
+        }
+        else if (tag === 'kerning') {
+            hasAnyTag = true;
+            kerningCount++;
+        }
+        else if (tag === 'info' || tag === 'chars' || tag === 'kernings') {
+            hasAnyTag = true;
+        }
+    }
+    if (!hasAnyTag)
+        return null;
+    return { charCount, hasCommon, kerningCount, pageIds, referencedPages };
+}
+function probeXml(text) {
+    const trimmed = text.trimStart();
+    if (!trimmed.startsWith('<'))
+        return null;
+    if (trimmed.indexOf('<font') < 0 && trimmed.indexOf('<Font') < 0)
+        return null;
+    let hasCommon = false;
+    let charCount = 0;
+    let kerningCount = 0;
+    const pageIds = [];
+    const referencedPages = new Set();
+    const commonMatch = /<common\s[^>]*?lineHeight\s*=\s*"(\d+)"[^>]*?base\s*=\s*"(\d+)"/i.exec(text);
+    if (commonMatch === null) {
+        const altMatch = /<common\s[^>]*?base\s*=\s*"(\d+)"[^>]*?lineHeight\s*=\s*"(\d+)"/i.exec(text);
+        hasCommon = altMatch !== null;
+    }
+    else {
+        hasCommon = true;
+    }
+    const pageRe = /<page\s[^>]*?id\s*=\s*"(\d+)"/gi;
+    let pageMatch;
+    while ((pageMatch = pageRe.exec(text)) !== null) {
+        pageIds.push(Number(pageMatch[1]));
+    }
+    const charRe = /<char\s[^>]*?id\s*=\s*"(\d+)"[^>]*/gi;
+    let charMatch;
+    while ((charMatch = charRe.exec(text)) !== null) {
+        charCount++;
+        const pageAttr = /\bpage\s*=\s*"(\d+)"/.exec(charMatch[0]);
+        referencedPages.add(pageAttr !== null ? Number(pageAttr[1]) : 0);
+    }
+    const kerningRe = /<kerning\s/gi;
+    while (kerningRe.exec(text) !== null)
+        kerningCount++;
+    return { charCount, hasCommon, kerningCount, pageIds, referencedPages };
+}
+function parseFntFields(rest) {
+    const fields = {};
+    const re = /([A-Za-z_]\w*)\s*=\s*(?:"([^"]*)"|(\S+))/g;
+    let match;
+    while ((match = re.exec(rest)) !== null) {
+        fields[match[1]] = match[2] !== undefined ? match[2] : (match[3] ?? '');
+    }
+    return fields;
+}
+function readFntNumber(value) {
+    if (value === undefined || value.trim() === '')
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+//# sourceMappingURL=explainBitmapFontParse.js.map

package/dist/explainBitmapFontParse.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,10 @@
-export { formatBitmapFontFnt, parseBitmapFontFnt, parseBitmapFontJson, parseBitmapFontXml } from './contract';
+export * from './bitmapfontFormatRequirements.ts';
+export * from './bitmapFontDetect.ts';
+export * from './bitmapFontBinary.ts';
+export * from './bitmapFontFnt.ts';
+export * from './bitmapFontFormatKind.ts';
+export * from './bitmapFontJson.ts';
+export * from './bitmapFontXml.ts';
+export * from './explainBitmapFontParse.ts';
+export * from './types.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,10 @@
-export { formatBitmapFontFnt, parseBitmapFontFnt, parseBitmapFontJson, parseBitmapFontXml } from './contract';
+export * from './bitmapfontFormatRequirements.js';
+export * from './bitmapFontDetect.js';
+export * from './bitmapFontBinary.js';
+export * from './bitmapFontFnt.js';
+export * from './bitmapFontFormatKind.js';
+export * from './bitmapFontJson.js';
+export * from './bitmapFontXml.js';
+export * from './explainBitmapFontParse.js';
+export * from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+import type { BitmapFont, BitmapFontEncoding, BitmapFontParseOptions } from '@flighthq/bitmapfont/contract';
+import type { ImportDiagnostic } from '@flighthq/importdiagnostics/contract';
+/** Identifies a bitmap font descriptor format for detection and dispatch. */
+export type BitmapFontFormatKind = string;
+export declare const BitmapFontFormatKindBmFontBinary = "BmFontBinary";
+export declare const BitmapFontFormatKindBmFontText = "BmFontText";
+export declare const BitmapFontFormatKindBmFontXml = "BmFontXml";
+export declare const BitmapFontFormatKindBmFontJson = "BmFontJson";
+export interface BitmapFontFormatEntry {
+    detect: (bytes: Readonly<Uint8Array>) => boolean;
+    parse: (bytes: Readonly<Uint8Array>, options?: Readonly<BitmapFontParseOptions>, diagnostics?: ImportDiagnostic[]) => BitmapFont | null;
+}
+export interface BitmapFontFormatDescriptor {
+    readonly entry: BitmapFontFormatEntry;
+    readonly kind: BitmapFontFormatKind;
+}
+export interface BitmapFontImportOptions {
+    readonly formats?: readonly Readonly<BitmapFontFormatDescriptor>[];
+}
+export type BitmapFontParseExplanationFormat = 'fnt' | 'json' | 'unknown' | 'xml';
+export type BitmapFontParseExplanationReason = 'invalid-data' | 'missing-chars' | 'missing-common' | 'ok' | 'unresolved-page';
+export interface BitmapFontParseExplanation {
+    charCount: number;
+    detectedFormat: BitmapFontParseExplanationFormat;
+    kerningCount: number;
+    pageCount: number;
+    reason: BitmapFontParseExplanationReason;
+    success: boolean;
+    unresolvedPages: readonly number[];
+}
+export interface BitmapFontCharRecord {
+    height: number;
+    id: number;
+    page: number;
+    width: number;
+    x: number;
+    xadvance: number;
+    xoffset: number;
+    y: number;
+    yoffset: number;
+}
+export interface BitmapFontKerningRecord {
+    amount: number;
+    first: number;
+    second: number;
+}
+export interface BitmapFontPageRecord {
+    file: string;
+    id: number;
+}
+export interface BitmapFontRecord {
+    base: number;
+    chars: BitmapFontCharRecord[];
+    encoding: BitmapFontEncoding;
+    kernings: BitmapFontKerningRecord[];
+    lineHeight: number;
+    pages: BitmapFontPageRecord[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAE7E,6EAA6E;AAC7E,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE1C,eAAO,MAAM,gCAAgC,iBAAiB,CAAC;AAC/D,eAAO,MAAM,8BAA8B,eAAe,CAAC;AAC3D,eAAO,MAAM,6BAA6B,cAAc,CAAC;AACzD,eAAO,MAAM,8BAA8B,eAAe,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC;IACjD,KAAK,EAAE,CACL,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,OAAO,CAAC,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAC1C,WAAW,CAAC,EAAE,gBAAgB,EAAE,KAC7B,UAAU,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;CACpE;AAED,MAAM,MAAM,gCAAgC,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;AAElF,MAAM,MAAM,gCAAgC,GACxC,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,IAAI,GACJ,iBAAiB,CAAC;AAEtB,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,gCAAgC,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gCAAgC,CAAC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,uBAAuB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B"}

package/dist/types.js

@@ -0,0 +1,5 @@
+export const BitmapFontFormatKindBmFontBinary = 'BmFontBinary';
+export const BitmapFontFormatKindBmFontText = 'BmFontText';
+export const BitmapFontFormatKindBmFontXml = 'BmFontXml';
+export const BitmapFontFormatKindBmFontJson = 'BmFontJson';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,gCAAgC,GAAG,cAAc,CAAC;AAC/D,MAAM,CAAC,MAAM,8BAA8B,GAAG,YAAY,CAAC;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAG,WAAW,CAAC;AACzD,MAAM,CAAC,MAAM,8BAA8B,GAAG,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/bitmapfont-formats",
-  "version": "0.5.1-next.920.da8f530",
+  "version": "0.6.0",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -32,20 +32,26 @@
   "scripts": {
     "build": "tsc -b",
     "clean": "tsc -b --clean",
+    "generate": "tsx ../../scripts/generate-rust-package.ts --crate flight-bitmapfont-formats --package bitmapfont-formats",
+    "generate:check": "tsx ../../scripts/generate-rust-package.ts --crate flight-bitmapfont-formats --package bitmapfont-formats --check",
     "test": "vitest run --config vitest.config.ts",
     "test:watch": "vitest --watch --config vitest.config.ts",
     "prepack": "npm run clean && npm run clean:dist && npm run build",
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/bitmapfont": "0.5.1-next.920.da8f530",
-    "@flighthq/importdiagnostics": "0.5.1-next.920.da8f530",
-    "@flighthq/types": "0.5.1-next.920.da8f530",
-    "@flighthq/xml": "0.5.1-next.920.da8f530"
+    "@flighthq/bitmapfont": "0.6.0",
+    "@flighthq/encoding": "0.6.0",
+    "@flighthq/glyphatlas": "0.6.0",
+    "@flighthq/importdiagnostics": "0.6.0",
+    "@flighthq/registry": "0.6.0",
+    "@flighthq/requirement": "0.6.0",
+    "@flighthq/textureatlas": "0.6.0",
+    "@flighthq/xml": "0.6.0"
   },
   "devDependencies": {
-    "@flighthq/textureatlas": "*",
-    "typescript": "^5.3.0"
+    "@flighthq/image": "*",
+    "typescript": "^7.0.2"
   },
   "description": "AngelCode/BMFont codec neighbor of @flighthq/bitmapfont — parse the text/XML/JSON .fnt variants into a BitmapFont and re-emit the text form",
   "sideEffects": false

package/src/bitmapFontBinary.test.ts

@@ -0,0 +1,196 @@
+import { createTextureAtlas } from '@flighthq/textureatlas/contract';
+import { describe, expect, it } from 'vitest';
+
+import { parseBitmapFontBinary } from './bitmapFontBinary.ts';
+import type { BitmapFontCharRecord, BitmapFontKerningRecord, BitmapFontPageRecord } from './types.ts';
+
+function buildBinaryFont(options: {
+  chars?: BitmapFontCharRecord[];
+  common?: { base: number; lineHeight: number };
+  kernings?: BitmapFontKerningRecord[];
+  pages?: BitmapFontPageRecord[];
+}): Uint8Array {
+  const blocks: Uint8Array[] = [];
+
+  if (options.common !== undefined) {
+    const common = new Uint8Array(15);
+    const view = new DataView(common.buffer);
+    view.setUint16(0, options.common.lineHeight, true);
+    view.setUint16(2, options.common.base, true);
+    blocks.push(makeBlock(2, common));
+  }
+
+  if (options.pages !== undefined && options.pages.length > 0) {
+    const parts: number[] = [];
+    for (const page of options.pages) {
+      for (let i = 0; i < page.file.length; i++) parts.push(page.file.charCodeAt(i));
+      parts.push(0);
+    }
+    blocks.push(makeBlock(3, new Uint8Array(parts)));
+  }
+
+  if (options.chars !== undefined) {
+    const data = new Uint8Array(options.chars.length * 20);
+    const view = new DataView(data.buffer);
+    for (let i = 0; i < options.chars.length; i++) {
+      const c = options.chars[i];
+      const off = i * 20;
+      view.setUint32(off, c.id, true);
+      view.setUint16(off + 4, c.x, true);
+      view.setUint16(off + 6, c.y, true);
+      view.setUint16(off + 8, c.width, true);
+      view.setUint16(off + 10, c.height, true);
+      view.setInt16(off + 12, c.xoffset, true);
+      view.setInt16(off + 14, c.yoffset, true);
+      view.setInt16(off + 16, c.xadvance, true);
+      view.setUint8(off + 18, c.page);
+    }
+    blocks.push(makeBlock(4, data));
+  }
+
+  if (options.kernings !== undefined && options.kernings.length > 0) {
+    const data = new Uint8Array(options.kernings.length * 10);
+    const view = new DataView(data.buffer);
+    for (let i = 0; i < options.kernings.length; i++) {
+      const k = options.kernings[i];
+      const off = i * 10;
+      view.setUint32(off, k.first, true);
+      view.setUint32(off + 4, k.second, true);
+      view.setInt16(off + 8, k.amount, true);
+    }
+    blocks.push(makeBlock(5, data));
+  }
+
+  let total = 4;
+  for (const block of blocks) total += block.length;
+  const result = new Uint8Array(total);
+  result[0] = 66;
+  result[1] = 77;
+  result[2] = 70;
+  result[3] = 3;
+  let offset = 4;
+  for (const block of blocks) {
+    result.set(block, offset);
+    offset += block.length;
+  }
+  return result;
+}
+
+function makeBlock(type: number, data: Uint8Array): Uint8Array {
+  const block = new Uint8Array(5 + data.length);
+  block[0] = type;
+  const view = new DataView(block.buffer);
+  view.setUint32(1, data.length, true);
+  block.set(data, 5);
+  return block;
+}
+
+describe('parseBitmapFontBinary', () => {
+  it('returns null for empty input', () => {
+    expect(parseBitmapFontBinary(new Uint8Array(0))).toBe(null);
+  });
+
+  it('returns null for wrong magic bytes', () => {
+    expect(parseBitmapFontBinary(new Uint8Array([0, 0, 0, 3]))).toBe(null);
+  });
+
+  it('returns null for wrong version', () => {
+    expect(parseBitmapFontBinary(new Uint8Array([66, 77, 70, 2]))).toBe(null);
+  });
+
+  it('returns null when common block is missing', () => {
+    const bytes = buildBinaryFont({
+      chars: [{ height: 10, id: 65, page: 0, width: 10, x: 0, xadvance: 10, xoffset: 0, y: 0, yoffset: 0 }],
+    });
+    expect(parseBitmapFontBinary(bytes)).toBe(null);
+  });
+
+  it('returns null when chars block is missing', () => {
+    const bytes = buildBinaryFont({ common: { base: 24, lineHeight: 32 } });
+    expect(parseBitmapFontBinary(bytes)).toBe(null);
+  });
+
+  it('parses a minimal binary font', () => {
+    const bytes = buildBinaryFont({
+      chars: [{ height: 10, id: 65, page: 0, width: 8, x: 0, xadvance: 10, xoffset: 1, y: 0, yoffset: 2 }],
+      common: { base: 24, lineHeight: 32 },
+      pages: [{ file: 'font.png', id: 0 }],
+    });
+    const font = parseBitmapFontBinary(bytes, {
+      resolvePage: () => createTextureAtlas(),
+    });
+    expect(font).not.toBe(null);
+    expect(font!.glyphs.has(65)).toBe(true);
+    const glyph = font!.glyphs.get(65)!;
+    expect(glyph.width).toBe(8);
+    expect(glyph.advance).toBe(10);
+    expect(glyph.bearingX).toBe(1);
+    expect(glyph.bearingY).toBe(24 - 2);
+  });
+
+  it('parses kerning pairs', () => {
+    const bytes = buildBinaryFont({
+      chars: [{ height: 10, id: 65, page: 0, width: 8, x: 0, xadvance: 10, xoffset: 0, y: 0, yoffset: 0 }],
+      common: { base: 24, lineHeight: 32 },
+      kernings: [{ amount: -2, first: 65, second: 86 }],
+      pages: [{ file: 'font.png', id: 0 }],
+    });
+    const font = parseBitmapFontBinary(bytes, {
+      resolvePage: () => createTextureAtlas(),
+    });
+    expect(font).not.toBe(null);
+    expect(font!.kerning.size).toBe(1);
+  });
+
+  it('parses multiple pages', () => {
+    const bytes = buildBinaryFont({
+      chars: [
+        { height: 10, id: 65, page: 0, width: 8, x: 0, xadvance: 10, xoffset: 0, y: 0, yoffset: 0 },
+        { height: 10, id: 66, page: 1, width: 8, x: 0, xadvance: 10, xoffset: 0, y: 0, yoffset: 0 },
+      ],
+      common: { base: 24, lineHeight: 32 },
+      pages: [
+        { file: 'font0.png', id: 0 },
+        { file: 'font1.png', id: 1 },
+      ],
+    });
+    const font = parseBitmapFontBinary(bytes, {
+      resolvePage: () => createTextureAtlas(),
+    });
+    expect(font).not.toBe(null);
+    expect(font!.pages).toHaveLength(2);
+  });
+
+  it('returns null when a referenced page cannot be resolved', () => {
+    const bytes = buildBinaryFont({
+      chars: [{ height: 10, id: 65, page: 0, width: 8, x: 0, xadvance: 10, xoffset: 0, y: 0, yoffset: 0 }],
+      common: { base: 24, lineHeight: 32 },
+      pages: [{ file: 'font.png', id: 0 }],
+    });
+    expect(parseBitmapFontBinary(bytes)).toBe(null);
+  });
+
+  it('handles negative xoffset and yoffset', () => {
+    const bytes = buildBinaryFont({
+      chars: [{ height: 10, id: 65, page: 0, width: 8, x: 0, xadvance: 10, xoffset: -3, y: 0, yoffset: -1 }],
+      common: { base: 24, lineHeight: 32 },
+      pages: [{ file: 'font.png', id: 0 }],
+    });
+    const font = parseBitmapFontBinary(bytes, {
+      resolvePage: () => createTextureAtlas(),
+    });
+    expect(font).not.toBe(null);
+    const glyph = font!.glyphs.get(65)!;
+    expect(glyph.bearingX).toBe(-3);
+    expect(glyph.bearingY).toBe(24 - -1);
+  });
+
+  it('tolerates truncated block gracefully', () => {
+    const bytes = buildBinaryFont({
+      chars: [{ height: 10, id: 65, page: 0, width: 8, x: 0, xadvance: 10, xoffset: 0, y: 0, yoffset: 0 }],
+      common: { base: 24, lineHeight: 32 },
+    });
+    const truncated = bytes.slice(0, bytes.length - 5);
+    expect(parseBitmapFontBinary(truncated)).toBe(null);
+  });
+});