@flighthq/bitmapfont-formats 0.1.0

package/dist/bitmapFontFnt.d.ts

@@ -0,0 +1,4 @@
+import type { BitmapFont, BitmapFontParseOptions } from '@flighthq/types';
+export declare function formatBitmapFontFnt(font: Readonly<BitmapFont>): string;
+export declare function parseBitmapFontFnt(text: string, options?: Readonly<BitmapFontParseOptions>): BitmapFont | null;
+//# sourceMappingURL=bitmapFontFnt.d.ts.map

package/dist/bitmapFontFnt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFontFnt.d.ts","sourceRoot":"","sources":["../src/bitmapFontFnt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAc,MAAM,iBAAiB,CAAC;AAkBtF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAwCtE;AAOD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,UAAU,GAAG,IAAI,CAI9G"}

package/dist/bitmapFontFnt.js

@@ -0,0 +1,141 @@
+import { getBitmapFontMetrics } from '@flighthq/bitmapfont';
+import { buildBitmapFontFromRecord } from './bitmapFontRecord';
+// Re-emits a `BitmapFont` as the classic AngelCode/BMFont text `.fnt` (`info`/`common`/`page`/`char`/
+// `kerning` lines of `key=value` pairs). Lossless for the fields the model carries — the glyph table
+// (including each glyph's `page`), kerning pairs, encoding, and line metrics all round-trip
+// (`parseBitmapFontFnt` of this output rebuilds an equivalent font). A `page` line is emitted per
+// font page; the page references cannot round-trip to filenames: a `BitmapFont` holds live
+// `TextureAtlas` pages, not the source page paths, so each `page` line carries an empty `file=""` and
+// the reader supplies the atlases again through its `resolvePage`. `info`/`common` beyond the line
+// metrics (face, style, spacing, packing) are not part of the model and are emitted as neutral defaults.
+export function formatBitmapFontFnt(font) {
+    const metrics = getBitmapFontMetrics(font);
+    const lineHeight = metrics.ascent + metrics.descent + metrics.lineGap;
+    const base = metrics.ascent;
+    const primaryImage = font.pages[0]?.image ?? null;
+    const scaleW = primaryImage !== null ? primaryImage.width : 0;
+    const scaleH = primaryImage !== null ? primaryImage.height : 0;
+    const pageCount = Math.max(font.pages.length, 1);
+    const lines = [];
+    lines.push(`info face="" size=${lineHeight} bold=0 italic=0 charset="" unicode=1 stretchH=100 smooth=1 aa=1 padding=0,0,0,0 spacing=0,0 outline=0`);
+    lines.push(`common lineHeight=${lineHeight} base=${base} scaleW=${scaleW} scaleH=${scaleH} pages=${pageCount} packed=0 alphaChnl=1 redChnl=0 greenChnl=0 blueChnl=0`);
+    for (let id = 0; id < pageCount; id++) {
+        lines.push(`page id=${id} file=""`);
+    }
+    const codepoints = [...font.glyphs.keys()];
+    lines.push(`chars count=${codepoints.length}`);
+    for (const codepoint of codepoints) {
+        const glyph = font.glyphs.get(codepoint);
+        lines.push(`char id=${codepoint} x=${glyph.x} y=${glyph.y} width=${glyph.width} height=${glyph.height} ` +
+            `xoffset=${glyph.bearingX} yoffset=${base - glyph.bearingY} xadvance=${glyph.advance} page=${glyph.page} chnl=15`);
+    }
+    const kernKeys = [...font.kerning.keys()];
+    lines.push(`kernings count=${kernKeys.length}`);
+    for (const key of kernKeys) {
+        const amount = font.kerning.get(key);
+        const first = key >>> 16;
+        const second = key & 0xffff;
+        lines.push(`kerning first=${first} second=${second} amount=${amount}`);
+    }
+    return lines.join('\n') + '\n';
+}
+// Parses the classic AngelCode/BMFont text `.fnt` into a `BitmapFont`. The format is one record per
+// line: a leading tag (`info`/`common`/`page`/`char`/`kerning`) followed by `key=value` pairs whose
+// values are bare tokens, quoted strings, or comma lists. The atlas page named on the `page` line is
+// rehydrated through `options.resolvePage`. Returns the `null` sentinel — never throwing — when the
+// text carries no `common` line metrics, no `char` records, or its atlas page cannot be resolved.
+export function parseBitmapFontFnt(text, options) {
+    const record = parseBitmapFontFntRecord(text);
+    if (record === null)
+        return null;
+    return buildBitmapFontFromRecord(record, options);
+}
+// Parses the text `.fnt` into the neutral record, or `null` when required blocks are absent or
+// malformed. Kept separate from `buildBitmapFontFromRecord` so the atlas-resolution step is shared
+// across the text/XML/JSON front-ends.
+function parseBitmapFontFntRecord(text) {
+    let lineHeight = null;
+    let base = null;
+    const pages = [];
+    const chars = [];
+    const kernings = [];
+    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);
+        const fields = parseFntFields(line.slice(tag.length));
+        if (tag === 'common') {
+            lineHeight = readFntNumber(fields.lineHeight);
+            base = readFntNumber(fields.base);
+        }
+        else if (tag === 'page') {
+            const id = readFntNumber(fields.id);
+            if (id !== null)
+                pages.push({ file: fields.file ?? '', id });
+        }
+        else if (tag === 'char') {
+            const char = readFntChar(fields);
+            if (char !== null)
+                chars.push(char);
+        }
+        else if (tag === 'kerning') {
+            const kerning = readFntKerning(fields);
+            if (kerning !== null)
+                kernings.push(kerning);
+        }
+    }
+    if (lineHeight === null || base === null || chars.length === 0)
+        return null;
+    return { base, chars, encoding: 'raster', kernings, lineHeight, pages };
+}
+// Tokenizes a record's `key=value` pairs. Values may be double-quoted (holding spaces), or a bare
+// non-space run (numbers, comma lists). Quotes are stripped; the raw string value is stored.
+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 readFntChar(fields) {
+    const id = readFntNumber(fields.id);
+    const x = readFntNumber(fields.x);
+    const y = readFntNumber(fields.y);
+    const width = readFntNumber(fields.width);
+    const height = readFntNumber(fields.height);
+    const xoffset = readFntNumber(fields.xoffset);
+    const yoffset = readFntNumber(fields.yoffset);
+    const xadvance = readFntNumber(fields.xadvance);
+    if (id === null ||
+        x === null ||
+        y === null ||
+        width === null ||
+        height === null ||
+        xoffset === null ||
+        yoffset === null ||
+        xadvance === null) {
+        return null;
+    }
+    return { height, id, page: readFntNumber(fields.page) ?? 0, width, x, xadvance, xoffset, y, yoffset };
+}
+function readFntKerning(fields) {
+    const first = readFntNumber(fields.first);
+    const second = readFntNumber(fields.second);
+    const amount = readFntNumber(fields.amount);
+    if (first === null || second === null || amount === null)
+        return null;
+    return { amount, first, second };
+}
+// Parses a `.fnt` field value as a finite number, returning `null` (the malformed sentinel) for an
+// absent field or a non-numeric value.
+function readFntNumber(value) {
+    if (value === undefined || value.trim() === '')
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+//# sourceMappingURL=bitmapFontFnt.js.map

package/dist/bitmapFontFnt.js.map

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

package/dist/bitmapFontJson.d.ts

@@ -0,0 +1,3 @@
+import type { BitmapFont, BitmapFontParseOptions } from '@flighthq/types';
+export declare function parseBitmapFontJson(text: string, options?: Readonly<BitmapFontParseOptions>): BitmapFont | null;
+//# sourceMappingURL=bitmapFontJson.d.ts.map

package/dist/bitmapFontJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFontJson.d.ts","sourceRoot":"","sources":["../src/bitmapFontJson.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAsB,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAiB9F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,UAAU,GAAG,IAAI,CAI/G"}

package/dist/bitmapFontJson.js

@@ -0,0 +1,111 @@
+import { buildBitmapFontFromRecord } from './bitmapFontRecord';
+// Parses the JSON AngelCode/BMFont export into a `BitmapFont`. The shape mirrors the text/XML blocks as
+// an object: `{ common: { lineHeight, base }, pages: [file, …], chars: [{ id, x, … }], kernings: [{
+// first, second, amount }] }`, where `pages` is a filename array whose index is the page id. A
+// distance-field export's `distanceField.fieldType` (`sdf`/`msdf`) selects the font encoding; classic
+// exports stay `raster`. Semantics otherwise match `parseBitmapFontFnt`, including `resolvePage` atlas
+// rehydration. Returns the `null` sentinel — never throwing — for malformed JSON, a missing
+// `common`/`chars`, or an atlas page that cannot be resolved.
+export function parseBitmapFontJson(text, options) {
+    const record = parseBitmapFontJsonRecord(text);
+    if (record === null)
+        return null;
+    return buildBitmapFontFromRecord(record, options);
+}
+// Parses the JSON export into the neutral record, or `null` when the JSON is malformed or the
+// `common`/`chars` blocks are absent or malformed.
+function parseBitmapFontJsonRecord(text) {
+    let root;
+    try {
+        root = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (!isObject(root))
+        return null;
+    const common = root.common;
+    if (!isObject(common))
+        return null;
+    const lineHeight = readJsonNumber(common.lineHeight);
+    const base = readJsonNumber(common.base);
+    if (lineHeight === null || base === null)
+        return null;
+    const rawChars = root.chars;
+    if (!Array.isArray(rawChars))
+        return null;
+    const chars = [];
+    for (const raw of rawChars) {
+        const char = readJsonChar(raw);
+        if (char !== null)
+            chars.push(char);
+    }
+    if (chars.length === 0)
+        return null;
+    const pages = [];
+    if (Array.isArray(root.pages)) {
+        for (let id = 0; id < root.pages.length; id++) {
+            const file = root.pages[id];
+            pages.push({ file: typeof file === 'string' ? file : '', id });
+        }
+    }
+    const kernings = [];
+    if (Array.isArray(root.kernings)) {
+        for (const raw of root.kernings) {
+            const kerning = readJsonKerning(raw);
+            if (kerning !== null)
+                kernings.push(kerning);
+        }
+    }
+    return { base, chars, encoding: readJsonEncoding(root.distanceField), kernings, lineHeight, pages };
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readJsonChar(raw) {
+    if (!isObject(raw))
+        return null;
+    const id = readJsonNumber(raw.id);
+    const x = readJsonNumber(raw.x);
+    const y = readJsonNumber(raw.y);
+    const width = readJsonNumber(raw.width);
+    const height = readJsonNumber(raw.height);
+    const xoffset = readJsonNumber(raw.xoffset);
+    const yoffset = readJsonNumber(raw.yoffset);
+    const xadvance = readJsonNumber(raw.xadvance);
+    if (id === null ||
+        x === null ||
+        y === null ||
+        width === null ||
+        height === null ||
+        xoffset === null ||
+        yoffset === null ||
+        xadvance === null) {
+        return null;
+    }
+    return { height, id, page: readJsonNumber(raw.page) ?? 0, width, x, xadvance, xoffset, y, yoffset };
+}
+// Reads the encoding from a `distanceField` block: `msdf`/`sdf` when its `fieldType` names one, else
+// `raster` (classic pre-rendered BMFont, and any unrecognized field type).
+function readJsonEncoding(distanceField) {
+    if (isObject(distanceField)) {
+        const fieldType = distanceField.fieldType;
+        if (fieldType === 'msdf' || fieldType === 'sdf')
+            return fieldType;
+    }
+    return 'raster';
+}
+function readJsonKerning(raw) {
+    if (!isObject(raw))
+        return null;
+    const first = readJsonNumber(raw.first);
+    const second = readJsonNumber(raw.second);
+    const amount = readJsonNumber(raw.amount);
+    if (first === null || second === null || amount === null)
+        return null;
+    return { amount, first, second };
+}
+function readJsonNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+//# sourceMappingURL=bitmapFontJson.js.map

package/dist/bitmapFontJson.js.map

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

package/dist/bitmapFontRecord.d.ts

@@ -0,0 +1,31 @@
+import type { BitmapFont, BitmapFontEncoding, BitmapFontParseOptions } from '@flighthq/types';
+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[];
+}
+export declare function buildBitmapFontFromRecord(record: Readonly<BitmapFontRecord>, options?: Readonly<BitmapFontParseOptions>): BitmapFont | null;
+//# sourceMappingURL=bitmapFontRecord.d.ts.map

package/dist/bitmapFontRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFontRecord.d.ts","sourceRoot":"","sources":["../src/bitmapFontRecord.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAEV,kBAAkB,EAGlB,sBAAsB,EAEvB,MAAM,iBAAiB,CAAC;AAMzB,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;AAID,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAOD,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;AAaD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAClC,OAAO,CAAC,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACzC,UAAU,GAAG,IAAI,CAyDnB"}

package/dist/bitmapFontRecord.js

@@ -0,0 +1,71 @@
+import { createBitmapFont } from '@flighthq/bitmapfont';
+// Maps a parsed `BitmapFontRecord` onto a `BitmapFont` via `createBitmapFont`, resolving every atlas
+// page the record declares through `options.resolvePage` (called once per page id). The resolved
+// atlases become the font's page-indexed `pages` (page id = index), and each `char`'s `page` carries
+// through to its glyph. Resolution rule: a page a glyph actually samples must resolve — if any
+// referenced page's atlas is `null` (including when `resolvePage` is omitted, so nothing resolves),
+// this returns the `null` sentinel and the parse fails as a whole; a declared-but-unreferenced page
+// that fails to resolve is tolerated and simply left absent. Each `char` becomes a glyph
+// (`xoffset`/`yoffset` → `bearingX`/`bearingY`, `xadvance` → `advance`, `page` → `page`); each
+// `kerning` becomes a pair; the line metrics derive from the BMFont `common` fields (`ascent` =
+// `base`, `descent` = `lineHeight - base`, `lineGap` = 0), which `formatBitmapFontFnt` inverts
+// losslessly.
+export function buildBitmapFontFromRecord(record, options) {
+    const resolvePage = options?.resolvePage;
+    const resolved = new Map();
+    let maxPageId = -1;
+    if (resolvePage !== undefined) {
+        for (const page of record.pages) {
+            const atlas = resolvePage(page.id, page.file);
+            if (atlas !== null) {
+                resolved.set(page.id, atlas);
+                if (page.id > maxPageId)
+                    maxPageId = page.id;
+            }
+        }
+    }
+    // Every page a glyph samples must have resolved; an unresolved referenced page collapses the parse.
+    for (const char of record.chars) {
+        if (!resolved.has(char.page))
+            return null;
+        if (char.page > maxPageId)
+            maxPageId = char.page;
+    }
+    const pages = [];
+    for (let id = 0; id <= maxPageId; id++) {
+        const atlas = resolved.get(id);
+        // A hole only occurs for a declared-but-unreferenced page that failed to resolve; no glyph
+        // indexes it, so it is left absent (`getBitmapFontPage` reports null for that index).
+        if (atlas !== undefined)
+            pages[id] = atlas;
+    }
+    const glyphs = record.chars.map((char) => ({
+        advance: char.xadvance,
+        bearingX: char.xoffset,
+        // BMFont `yoffset` is the distance down from the line top to the glyph's top; `GlyphEntry.bearingY`
+        // is the distance up from the baseline to that same top (the convention the renderer and
+        // @flighthq/glyphatlas share, `quadY = baselineY - bearingY`). Convert across the two references
+        // via `base` (line-top-to-baseline). `formatBitmapFontFnt` inverts this with `yoffset = base - bearingY`.
+        bearingY: record.base - char.yoffset,
+        codepoint: char.id,
+        height: char.height,
+        page: char.page,
+        width: char.width,
+        x: char.x,
+        y: char.y,
+    }));
+    const kerning = record.kernings.map((pair) => ({
+        amount: pair.amount,
+        left: pair.first,
+        right: pair.second,
+    }));
+    const data = {
+        encoding: record.encoding,
+        glyphs,
+        kerning,
+        metrics: { ascent: record.base, descent: record.lineHeight - record.base, lineGap: 0 },
+        pages,
+    };
+    return createBitmapFont(data);
+}
+//# sourceMappingURL=bitmapFontRecord.js.map

package/dist/bitmapFontRecord.js.map

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

package/dist/bitmapFontXml.d.ts

@@ -0,0 +1,3 @@
+import type { BitmapFont, BitmapFontParseOptions } from '@flighthq/types';
+export declare function parseBitmapFontXml(text: string, options?: Readonly<BitmapFontParseOptions>): BitmapFont | null;
+//# sourceMappingURL=bitmapFontXml.d.ts.map

package/dist/bitmapFontXml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFontXml.d.ts","sourceRoot":"","sources":["../src/bitmapFontXml.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAuB1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,UAAU,GAAG,IAAI,CAI9G"}

package/dist/bitmapFontXml.js

@@ -0,0 +1,97 @@
+import { getXmlElementAttribute, getXmlElementAttributeNumber, getXmlElementChildByName, getXmlElementChildrenByName, parseXmlDocument, } from '@flighthq/xml';
+import { buildBitmapFontFromRecord } from './bitmapFontRecord';
+// Parses the XML AngelCode/BMFont `.fnt` variant into a `BitmapFont`. The document is
+// `<font><info/><common/><pages><page/></pages><chars><char/></chars><kernings><kerning/></kernings></font>`
+// with every field an element attribute. Semantics match `parseBitmapFontFnt` — the same line metrics,
+// glyph mapping, and `resolvePage` atlas rehydration. Returns the `null` sentinel — never throwing —
+// for malformed XML, a missing `common`/`chars`, or an atlas page that cannot be resolved.
+export function parseBitmapFontXml(text, options) {
+    const record = parseBitmapFontXmlRecord(text);
+    if (record === null)
+        return null;
+    return buildBitmapFontFromRecord(record, options);
+}
+// Parses the XML `.fnt` into the neutral record, or `null` when the root/`common`/`chars` blocks are
+// absent or a required attribute is malformed.
+function parseBitmapFontXmlRecord(text) {
+    const root = parseXmlDocument(text);
+    if (root === null || root.name !== 'font')
+        return null;
+    const common = getXmlElementChildByName(root, 'common');
+    if (common === null)
+        return null;
+    const lineHeight = getXmlElementAttributeNumber(common, 'lineHeight');
+    const base = getXmlElementAttributeNumber(common, 'base');
+    if (lineHeight === null || base === null)
+        return null;
+    const pages = [];
+    const pagesElement = getXmlElementChildByName(root, 'pages');
+    if (pagesElement !== null) {
+        for (const pageElement of getXmlElementChildrenByName(pagesElement, 'page')) {
+            const id = getXmlElementAttributeNumber(pageElement, 'id');
+            if (id !== null)
+                pages.push({ file: getXmlElementAttribute(pageElement, 'file') ?? '', id });
+        }
+    }
+    const chars = [];
+    const charsElement = getXmlElementChildByName(root, 'chars');
+    if (charsElement !== null) {
+        for (const charElement of getXmlElementChildrenByName(charsElement, 'char')) {
+            const char = readXmlChar(charElement);
+            if (char !== null)
+                chars.push(char);
+        }
+    }
+    if (chars.length === 0)
+        return null;
+    const kernings = [];
+    const kerningsElement = getXmlElementChildByName(root, 'kernings');
+    if (kerningsElement !== null) {
+        for (const kerningElement of getXmlElementChildrenByName(kerningsElement, 'kerning')) {
+            const kerning = readXmlKerning(kerningElement);
+            if (kerning !== null)
+                kernings.push(kerning);
+        }
+    }
+    return { base, chars, encoding: 'raster', kernings, lineHeight, pages };
+}
+function readXmlChar(element) {
+    const id = getXmlElementAttributeNumber(element, 'id');
+    const x = getXmlElementAttributeNumber(element, 'x');
+    const y = getXmlElementAttributeNumber(element, 'y');
+    const width = getXmlElementAttributeNumber(element, 'width');
+    const height = getXmlElementAttributeNumber(element, 'height');
+    const xoffset = getXmlElementAttributeNumber(element, 'xoffset');
+    const yoffset = getXmlElementAttributeNumber(element, 'yoffset');
+    const xadvance = getXmlElementAttributeNumber(element, 'xadvance');
+    if (id === null ||
+        x === null ||
+        y === null ||
+        width === null ||
+        height === null ||
+        xoffset === null ||
+        yoffset === null ||
+        xadvance === null) {
+        return null;
+    }
+    return {
+        height,
+        id,
+        page: getXmlElementAttributeNumber(element, 'page') ?? 0,
+        width,
+        x,
+        xadvance,
+        xoffset,
+        y,
+        yoffset,
+    };
+}
+function readXmlKerning(element) {
+    const first = getXmlElementAttributeNumber(element, 'first');
+    const second = getXmlElementAttributeNumber(element, 'second');
+    const amount = getXmlElementAttributeNumber(element, 'amount');
+    if (first === null || second === null || amount === null)
+        return null;
+    return { amount, first, second };
+}
+//# sourceMappingURL=bitmapFontXml.js.map

package/dist/bitmapFontXml.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { formatBitmapFontFnt, parseBitmapFontFnt } from './bitmapFontFnt';
+export { parseBitmapFontJson } from './bitmapFontJson';
+export { parseBitmapFontXml } from './bitmapFontXml';
+//# 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":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { formatBitmapFontFnt, parseBitmapFontFnt } from './bitmapFontFnt';
+export { parseBitmapFontJson } from './bitmapFontJson';
+export { parseBitmapFontXml } from './bitmapFontXml';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@flighthq/bitmapfont-formats",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "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.1.0",
+    "@flighthq/types": "0.1.0",
+    "@flighthq/xml": "0.1.0"
+  },
+  "devDependencies": {
+    "@flighthq/textureatlas": "*",
+    "typescript": "^5.3.0"
+  },
+  "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/bitmapFontFnt.test.ts

@@ -0,0 +1,146 @@
+import {
+  createGlyphSourceFromBitmapFont,
+  getBitmapFontGlyph,
+  getBitmapFontKerning,
+  getBitmapFontMetrics,
+  getBitmapFontPage,
+} from '@flighthq/bitmapfont';
+import { createTextureAtlas } from '@flighthq/textureatlas';
+import type { BitmapFontParseOptions, ImageResource, TextureAtlas } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import { formatBitmapFontFnt, parseBitmapFontFnt } from './bitmapFontFnt';
+
+const FNT_MULTIPAGE = [
+  'info face="Test" size=32 unicode=1',
+  'common lineHeight=32 base=26 scaleW=64 scaleH=64 pages=2 packed=0',
+  'page id=0 file="test_0.png"',
+  'page id=1 file="test_1.png"',
+  'chars count=2',
+  'char id=65 x=0 y=0 width=7 height=8 xoffset=1 yoffset=0 xadvance=9 page=0 chnl=15',
+  'char id=66 x=3 y=0 width=6 height=8 xoffset=0 yoffset=0 xadvance=8 page=1 chnl=15',
+].join('\n');
+
+const FNT_TEXT = [
+  'info face="Test" size=32 bold=0 italic=0 unicode=1 padding=0,0,0,0 spacing=1,1',
+  'common lineHeight=32 base=26 scaleW=64 scaleH=64 pages=1 packed=0',
+  'page id=0 file="test_0.png"',
+  'chars count=2',
+  'char id=65 x=0 y=0 width=7 height=8 xoffset=1 yoffset=5 xadvance=9 page=0 chnl=15',
+  'char id=86 x=8 y=0 width=6 height=8 xoffset=0 yoffset=0 xadvance=8 page=0 chnl=15',
+  'kernings count=1',
+  'kerning first=65 second=86 amount=-2',
+].join('\n');
+
+describe('formatBitmapFontFnt', () => {
+  it('round-trips a parsed font through parse → format → parse', () => {
+    const options = pageOptions();
+    const font = parseBitmapFontFnt(FNT_TEXT, options);
+    expect(font).not.toBeNull();
+
+    const reparsed = parseBitmapFontFnt(formatBitmapFontFnt(font!), options);
+    expect(reparsed).not.toBeNull();
+
+    expect(getBitmapFontGlyph(reparsed!, 65)).toEqual(getBitmapFontGlyph(font!, 65));
+    expect(getBitmapFontGlyph(reparsed!, 86)).toEqual(getBitmapFontGlyph(font!, 86));
+    expect(getBitmapFontKerning(reparsed!, 65, 86)).toBe(-2);
+    expect(getBitmapFontMetrics(reparsed!)).toEqual(getBitmapFontMetrics(font!));
+  });
+
+  it('emits an empty page file reference (the atlas is a live resource, not a path)', () => {
+    const font = parseBitmapFontFnt(FNT_TEXT, pageOptions());
+    expect(formatBitmapFontFnt(font!)).toContain('page id=0 file=""');
+  });
+});
+
+describe('parseBitmapFontFnt', () => {
+  it('parses glyphs, kerning, and line metrics with the resolved atlas', () => {
+    const atlas = createTextureAtlas();
+    const font = parseBitmapFontFnt(FNT_TEXT, { resolvePage: () => atlas });
+    expect(font).not.toBeNull();
+
+    expect(getBitmapFontPage(font!, 0)).toBe(atlas);
+    // yoffset=5 with base=26 → bearingY = base - yoffset = 21 (baseline-relative, up-positive).
+    expect(getBitmapFontGlyph(font!, 65)).toEqual({
+      advance: 9,
+      bearingX: 1,
+      bearingY: 21,
+      height: 8,
+      page: 0,
+      width: 7,
+      x: 0,
+      y: 0,
+    });
+    // yoffset=0 → bearingY = base = 26 (glyph top at the line top, one full ascent above the baseline).
+    expect(getBitmapFontGlyph(font!, 86)).toEqual({
+      advance: 8,
+      bearingX: 0,
+      bearingY: 26,
+      height: 8,
+      page: 0,
+      width: 6,
+      x: 8,
+      y: 0,
+    });
+    expect(getBitmapFontKerning(font!, 65, 86)).toBe(-2);
+    expect(getBitmapFontKerning(font!, 86, 65)).toBe(0);
+    expect(getBitmapFontMetrics(font!)).toEqual({ ascent: 26, descent: 6, lineGap: 0 });
+  });
+
+  it('passes the parsed page id and file to the resolver', () => {
+    const seen: Array<[number, string]> = [];
+    parseBitmapFontFnt(FNT_TEXT, {
+      resolvePage: (id, file) => {
+        seen.push([id, file]);
+        return createTextureAtlas();
+      },
+    });
+    expect(seen).toEqual([[0, 'test_0.png']]);
+  });
+
+  it('resolves every page of a multi-page font and routes each glyph to the right page image', () => {
+    const image0 = {} as ImageResource;
+    const image1 = {} as ImageResource;
+    const page0 = createTextureAtlas({ image: image0 });
+    const page1 = createTextureAtlas({ image: image1 });
+    const seen: Array<[number, string]> = [];
+    const font = parseBitmapFontFnt(FNT_MULTIPAGE, {
+      resolvePage: (id, file) => {
+        seen.push([id, file]);
+        return id === 0 ? page0 : page1;
+      },
+    });
+    expect(font).not.toBeNull();
+
+    expect(seen).toEqual([
+      [0, 'test_0.png'],
+      [1, 'test_1.png'],
+    ]);
+    expect(font!.pages).toEqual([page0, page1]);
+    expect(getBitmapFontPage(font!, 0)).toBe(page0);
+    expect(getBitmapFontPage(font!, 1)).toBe(page1);
+    expect(getBitmapFontGlyph(font!, 65)!.page).toBe(0);
+    expect(getBitmapFontGlyph(font!, 66)!.page).toBe(1);
+
+    const source = createGlyphSourceFromBitmapFont(font!);
+    expect(source.getGlyphAtlasImage(source.getGlyphEntry(65)!.page)).toBe(image0);
+    expect(source.getGlyphAtlasImage(source.getGlyphEntry(66)!.page)).toBe(image1);
+  });
+
+  it('returns null for malformed text without throwing', () => {
+    expect(parseBitmapFontFnt('this is not a bitmap font', pageOptions())).toBeNull();
+  });
+
+  it('returns null when no resolvePage is supplied (the page is dropped)', () => {
+    expect(parseBitmapFontFnt(FNT_TEXT)).toBeNull();
+  });
+
+  it('returns null when the resolver cannot resolve the page', () => {
+    expect(parseBitmapFontFnt(FNT_TEXT, { resolvePage: () => null })).toBeNull();
+  });
+});
+
+function pageOptions(): BitmapFontParseOptions {
+  const atlas: TextureAtlas = createTextureAtlas();
+  return { resolvePage: () => atlas };
+}

package/src/bitmapFontJson.test.ts

@@ -0,0 +1,128 @@
+import {
+  getBitmapFontGlyph,
+  getBitmapFontKerning,
+  getBitmapFontMetrics,
+  getBitmapFontPage,
+} from '@flighthq/bitmapfont';
+import { createTextureAtlas } from '@flighthq/textureatlas';
+import type { BitmapFont } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import { parseBitmapFontFnt } from './bitmapFontFnt';
+import { parseBitmapFontJson } from './bitmapFontJson';
+import { parseBitmapFontXml } from './bitmapFontXml';
+
+const FNT_JSON = JSON.stringify({
+  chars: [
+    { chnl: 15, height: 8, id: 65, page: 0, width: 7, x: 0, xadvance: 9, xoffset: 1, y: 0, yoffset: 5 },
+    { chnl: 15, height: 8, id: 86, page: 0, width: 6, x: 8, xadvance: 8, xoffset: 0, y: 0, yoffset: 0 },
+  ],
+  common: { base: 26, lineHeight: 32, pages: 1, scaleH: 64, scaleW: 64 },
+  info: { face: 'Test', size: 32 },
+  kernings: [{ amount: -2, first: 65, second: 86 }],
+  pages: ['test_0.png'],
+});
+
+const FNT_TEXT = [
+  'common lineHeight=32 base=26 scaleW=64 scaleH=64 pages=1',
+  'page id=0 file="test_0.png"',
+  'chars count=2',
+  'char id=65 x=0 y=0 width=7 height=8 xoffset=1 yoffset=5 xadvance=9 page=0 chnl=15',
+  'char id=86 x=8 y=0 width=6 height=8 xoffset=0 yoffset=0 xadvance=8 page=0 chnl=15',
+  'kernings count=1',
+  'kerning first=65 second=86 amount=-2',
+].join('\n');
+
+const FNT_XML = [
+  '<font>',
+  '  <common lineHeight="32" base="26" scaleW="64" scaleH="64" pages="1"/>',
+  '  <pages><page id="0" file="test_0.png"/></pages>',
+  '  <chars count="2">',
+  '    <char id="65" x="0" y="0" width="7" height="8" xoffset="1" yoffset="5" xadvance="9"/>',
+  '    <char id="86" x="8" y="0" width="6" height="8" xoffset="0" yoffset="0" xadvance="8"/>',
+  '  </chars>',
+  '  <kernings count="1"><kerning first="65" second="86" amount="-2"/></kernings>',
+  '</font>',
+].join('\n');
+
+describe('parseBitmapFontJson', () => {
+  it('parses glyphs, kerning, and line metrics with the resolved atlas', () => {
+    const atlas = createTextureAtlas();
+    const font = parseBitmapFontJson(FNT_JSON, { resolvePage: () => atlas });
+    expect(font).not.toBeNull();
+
+    expect(getBitmapFontPage(font!, 0)).toBe(atlas);
+    // yoffset=5 with base=26 → bearingY = base - yoffset = 21 (baseline-relative, up-positive).
+    expect(getBitmapFontGlyph(font!, 65)).toEqual({
+      advance: 9,
+      bearingX: 1,
+      bearingY: 21,
+      height: 8,
+      page: 0,
+      width: 7,
+      x: 0,
+      y: 0,
+    });
+    expect(getBitmapFontGlyph(font!, 86)?.advance).toBe(8);
+    expect(getBitmapFontKerning(font!, 65, 86)).toBe(-2);
+    expect(getBitmapFontMetrics(font!)).toEqual({ ascent: 26, descent: 6, lineGap: 0 });
+  });
+
+  it('resolves both pages of a multi-page JSON export and routes each glyph to its page', () => {
+    const page0 = createTextureAtlas();
+    const page1 = createTextureAtlas();
+    const multiPage = JSON.stringify({
+      chars: [
+        { height: 8, id: 65, page: 0, width: 7, x: 0, xadvance: 9, xoffset: 1, y: 0, yoffset: 0 },
+        { height: 8, id: 66, page: 1, width: 6, x: 3, xadvance: 8, xoffset: 0, y: 0, yoffset: 0 },
+      ],
+      common: { base: 26, lineHeight: 32 },
+      kernings: [],
+      pages: ['test_0.png', 'test_1.png'],
+    });
+    const font = parseBitmapFontJson(multiPage, { resolvePage: (id) => (id === 0 ? page0 : page1) });
+    expect(font).not.toBeNull();
+
+    expect(font!.pages).toEqual([page0, page1]);
+    expect(getBitmapFontPage(font!, 1)).toBe(page1);
+    expect(getBitmapFontGlyph(font!, 65)!.page).toBe(0);
+    expect(getBitmapFontGlyph(font!, 66)!.page).toBe(1);
+  });
+
+  it('reads the sdf/msdf encoding from a distanceField block', () => {
+    const withField = JSON.parse(FNT_JSON) as Record<string, unknown>;
+    withField.distanceField = { distanceRange: 4, fieldType: 'msdf' };
+    const font = parseBitmapFontJson(JSON.stringify(withField), { resolvePage: () => createTextureAtlas() });
+    expect(font!.encoding).toBe('msdf');
+  });
+
+  it('parses equivalently to the text and XML variants', () => {
+    const atlas = createTextureAtlas();
+    const resolvePage = () => atlas;
+    const fromJson = parseBitmapFontJson(FNT_JSON, { resolvePage })!;
+    const fromText = parseBitmapFontFnt(FNT_TEXT, { resolvePage })!;
+    const fromXml = parseBitmapFontXml(FNT_XML, { resolvePage })!;
+
+    for (const codepoint of [65, 86]) {
+      const glyph = getBitmapFontGlyph(fromJson, codepoint);
+      expect(getBitmapFontGlyph(fromText, codepoint)).toEqual(glyph);
+      expect(getBitmapFontGlyph(fromXml, codepoint)).toEqual(glyph);
+    }
+    expectSameKerningAndMetrics(fromText, fromJson);
+    expectSameKerningAndMetrics(fromXml, fromJson);
+  });
+
+  it('returns null for malformed JSON without throwing', () => {
+    expect(parseBitmapFontJson('{ not json', { resolvePage: () => createTextureAtlas() })).toBeNull();
+    expect(parseBitmapFontJson('{}', { resolvePage: () => createTextureAtlas() })).toBeNull();
+  });
+
+  it('returns null when no resolvePage is supplied', () => {
+    expect(parseBitmapFontJson(FNT_JSON)).toBeNull();
+  });
+});
+
+function expectSameKerningAndMetrics(actual: BitmapFont, expected: BitmapFont): void {
+  expect(getBitmapFontKerning(actual, 65, 86)).toBe(getBitmapFontKerning(expected, 65, 86));
+  expect(getBitmapFontMetrics(actual)).toEqual(getBitmapFontMetrics(expected));
+}

package/src/bitmapFontRecord.test.ts

@@ -0,0 +1,121 @@
+import {
+  getBitmapFontGlyph,
+  getBitmapFontKerning,
+  getBitmapFontMetrics,
+  getBitmapFontPage,
+} from '@flighthq/bitmapfont';
+import { createTextureAtlas } from '@flighthq/textureatlas';
+import { describe, expect, it } from 'vitest';
+
+import { buildBitmapFontFromRecord } from './bitmapFontRecord';
+import type { BitmapFontRecord } from './bitmapFontRecord';
+
+describe('buildBitmapFontFromRecord', () => {
+  it('maps chars, kernings, and common metrics onto a BitmapFont', () => {
+    const atlas = createTextureAtlas();
+    const font = buildBitmapFontFromRecord(sampleRecord(), { resolvePage: () => atlas });
+    expect(font).not.toBeNull();
+
+    expect(getBitmapFontPage(font!, 0)).toBe(atlas);
+    // yoffset=5 with base=26 → bearingY = base - yoffset = 21 (baseline-relative, up-positive).
+    expect(getBitmapFontGlyph(font!, 65)).toEqual({
+      advance: 9,
+      bearingX: 1,
+      bearingY: 21,
+      height: 8,
+      page: 0,
+      width: 7,
+      x: 0,
+      y: 0,
+    });
+    expect(getBitmapFontKerning(font!, 65, 86)).toBe(-2);
+    // base=26, lineHeight=32 → ascent=26, descent=6, lineGap=0.
+    expect(getBitmapFontMetrics(font!)).toEqual({ ascent: 26, descent: 6, lineGap: 0 });
+  });
+
+  it('carries the record encoding onto the font', () => {
+    const font = buildBitmapFontFromRecord(
+      { ...sampleRecord(), encoding: 'sdf' },
+      { resolvePage: () => createTextureAtlas() },
+    );
+    expect(font!.encoding).toBe('sdf');
+  });
+
+  it('resolves every declared page and carries each char page onto its glyph', () => {
+    const page0 = createTextureAtlas();
+    const page1 = createTextureAtlas();
+    const font = buildBitmapFontFromRecord(multiPageRecord(), {
+      resolvePage: (id) => (id === 0 ? page0 : page1),
+    });
+    expect(font).not.toBeNull();
+
+    expect(font!.pages).toEqual([page0, page1]);
+    expect(getBitmapFontPage(font!, 0)).toBe(page0);
+    expect(getBitmapFontPage(font!, 1)).toBe(page1);
+    expect(getBitmapFontGlyph(font!, 65)!.page).toBe(0);
+    expect(getBitmapFontGlyph(font!, 86)!.page).toBe(1);
+  });
+
+  it('tolerates an unreferenced page that fails to resolve', () => {
+    // Two pages declared, but every glyph samples page 0; page 1 (unreferenced) fails to resolve.
+    const page0 = createTextureAtlas();
+    const font = buildBitmapFontFromRecord(
+      {
+        ...sampleRecord(),
+        pages: [
+          { file: 'a.png', id: 0 },
+          { file: 'b.png', id: 1 },
+        ],
+      },
+      { resolvePage: (id) => (id === 0 ? page0 : null) },
+    );
+    expect(font).not.toBeNull();
+    expect(getBitmapFontPage(font!, 0)).toBe(page0);
+  });
+
+  it('returns null when a referenced page fails to resolve', () => {
+    // Glyph 86 samples page 1, which resolves null → the parse collapses.
+    expect(
+      buildBitmapFontFromRecord(multiPageRecord(), { resolvePage: (id) => (id === 0 ? createTextureAtlas() : null) }),
+    ).toBeNull();
+  });
+
+  it('returns null when resolvePage is absent, missing, or returns null for the page', () => {
+    expect(buildBitmapFontFromRecord(sampleRecord())).toBeNull();
+    expect(buildBitmapFontFromRecord(sampleRecord(), { resolvePage: () => null })).toBeNull();
+    expect(
+      buildBitmapFontFromRecord({ ...sampleRecord(), pages: [] }, { resolvePage: () => createTextureAtlas() }),
+    ).toBeNull();
+  });
+});
+
+function multiPageRecord(): BitmapFontRecord {
+  return {
+    base: 26,
+    chars: [
+      { height: 8, id: 65, page: 0, width: 7, x: 0, xadvance: 9, xoffset: 1, y: 0, yoffset: 0 },
+      { height: 8, id: 86, page: 1, width: 6, x: 8, xadvance: 8, xoffset: 0, y: 0, yoffset: 0 },
+    ],
+    encoding: 'raster',
+    kernings: [],
+    lineHeight: 32,
+    pages: [
+      { file: 'test_0.png', id: 0 },
+      { file: 'test_1.png', id: 1 },
+    ],
+  };
+}
+
+function sampleRecord(): BitmapFontRecord {
+  return {
+    base: 26,
+    chars: [
+      { height: 8, id: 65, page: 0, width: 7, x: 0, xadvance: 9, xoffset: 1, y: 0, yoffset: 5 },
+      { height: 8, id: 86, page: 0, width: 6, x: 8, xadvance: 8, xoffset: 0, y: 0, yoffset: 0 },
+    ],
+    encoding: 'raster',
+    kernings: [{ amount: -2, first: 65, second: 86 }],
+    lineHeight: 32,
+    pages: [{ file: 'test_0.png', id: 0 }],
+  };
+}

package/src/bitmapFontXml.test.ts

@@ -0,0 +1,70 @@
+import {
+  getBitmapFontGlyph,
+  getBitmapFontKerning,
+  getBitmapFontMetrics,
+  getBitmapFontPage,
+} from '@flighthq/bitmapfont';
+import { createTextureAtlas } from '@flighthq/textureatlas';
+import { describe, expect, it } from 'vitest';
+
+import { parseBitmapFontXml } from './bitmapFontXml';
+
+const FNT_XML = [
+  '<?xml version="1.0"?>',
+  '<font>',
+  '  <info face="Test" size="32" unicode="1"/>',
+  '  <common lineHeight="32" base="26" scaleW="64" scaleH="64" pages="1" packed="0"/>',
+  '  <pages><page id="0" file="test_0.png"/></pages>',
+  '  <chars count="2">',
+  '    <char id="65" x="0" y="0" width="7" height="8" xoffset="1" yoffset="5" xadvance="9" page="0" chnl="15"/>',
+  '    <char id="86" x="8" y="0" width="6" height="8" xoffset="0" yoffset="0" xadvance="8" page="0" chnl="15"/>',
+  '  </chars>',
+  '  <kernings count="1">',
+  '    <kerning first="65" second="86" amount="-2"/>',
+  '  </kernings>',
+  '</font>',
+].join('\n');
+
+describe('parseBitmapFontXml', () => {
+  it('parses glyphs, kerning, and line metrics with the resolved atlas', () => {
+    const atlas = createTextureAtlas();
+    const font = parseBitmapFontXml(FNT_XML, { resolvePage: () => atlas });
+    expect(font).not.toBeNull();
+
+    expect(getBitmapFontPage(font!, 0)).toBe(atlas);
+    // yoffset=5 with base=26 → bearingY = base - yoffset = 21 (baseline-relative, up-positive).
+    expect(getBitmapFontGlyph(font!, 65)).toEqual({
+      advance: 9,
+      bearingX: 1,
+      bearingY: 21,
+      height: 8,
+      page: 0,
+      width: 7,
+      x: 0,
+      y: 0,
+    });
+    expect(getBitmapFontGlyph(font!, 86)?.advance).toBe(8);
+    expect(getBitmapFontKerning(font!, 65, 86)).toBe(-2);
+    expect(getBitmapFontMetrics(font!)).toEqual({ ascent: 26, descent: 6, lineGap: 0 });
+  });
+
+  it('passes the parsed page id and file to the resolver', () => {
+    const seen: Array<[number, string]> = [];
+    parseBitmapFontXml(FNT_XML, {
+      resolvePage: (id, file) => {
+        seen.push([id, file]);
+        return createTextureAtlas();
+      },
+    });
+    expect(seen).toEqual([[0, 'test_0.png']]);
+  });
+
+  it('returns null for malformed XML without throwing', () => {
+    expect(parseBitmapFontXml('<font><common/></font>', { resolvePage: () => createTextureAtlas() })).toBeNull();
+    expect(parseBitmapFontXml('not xml at all', { resolvePage: () => createTextureAtlas() })).toBeNull();
+  });
+
+  it('returns null when no resolvePage is supplied', () => {
+    expect(parseBitmapFontXml(FNT_XML)).toBeNull();
+  });
+});