@flighthq/font-formats 0.3.1-next.209.43ef1bc

package/dist/sfntTableDirectory.js

@@ -0,0 +1,39 @@
+// The sfnt container's table directory: a fixed 12-byte header followed by one 16-byte record per
+// table, each record naming a four-character tag and the table's byte range within the file. Every
+// OpenType flavor shares this layout — what differs is only which tables are present — so this is the
+// one reader every table parser starts from.
+//
+// Offsets and tags are facts about the format. Nothing here interprets a table's contents.
+const SFNT_HEADER_BYTES = 12;
+const SFNT_TABLE_RECORD_BYTES = 16;
+// Reads the directory and clamps every entry to the bytes actually present. A record pointing past the
+// end of the buffer is dropped rather than trusted or thrown on: a truncated download is an ordinary
+// thing to be handed, and the caller distinguishes "table absent" from "file damaged" by comparing
+// `declaredTableCount` against the size of `tables` — which is exactly what `explainOpenTypeFont`
+// reports. Returns the null sentinel only when the header itself cannot be read.
+export function readSfntTableDirectory(bytes) {
+    if (bytes.byteLength < SFNT_HEADER_BYTES)
+        return null;
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const declaredTableCount = view.getUint16(4);
+    const tables = new Map();
+    for (let index = 0; index < declaredTableCount; index += 1) {
+        const record = SFNT_HEADER_BYTES + index * SFNT_TABLE_RECORD_BYTES;
+        // The record itself must be inside the buffer before any field of it can be read.
+        if (record + SFNT_TABLE_RECORD_BYTES > bytes.byteLength)
+            break;
+        const offset = view.getUint32(record + 8);
+        const length = view.getUint32(record + 12);
+        if (offset + length > bytes.byteLength)
+            continue;
+        tables.set(readSfntTag(bytes, record), { length, offset });
+    }
+    return { declaredTableCount, sfntVersion: view.getUint32(0), tables };
+}
+// A table tag is four bytes read as characters rather than as a number, because that is how every
+// specification, every font tool, and every error message spells it — `glyf`, `cmap`, `CFF ` with its
+// significant trailing space. Keeping the string form means a tag never has to be decoded by a reader.
+export function readSfntTag(bytes, offset) {
+    return String.fromCharCode(bytes[offset], bytes[offset + 1], bytes[offset + 2], bytes[offset + 3]);
+}
+//# sourceMappingURL=sfntTableDirectory.js.map

package/dist/sfntTableDirectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfntTableDirectory.js","sourceRoot":"","sources":["../src/sfntTableDirectory.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,mGAAmG;AACnG,sGAAsG;AACtG,6CAA6C;AAC7C,EAAE;AACF,2FAA2F;AAE3F,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC,uGAAuG;AACvG,qGAAqG;AACrG,mGAAmG;AACnG,kGAAkG;AAClG,iFAAiF;AACjF,MAAM,UAAU,sBAAsB,CAAC,KAA2B;IAChE,IAAI,KAAK,CAAC,UAAU,GAAG,iBAAiB;QAAE,OAAO,IAAI,CAAC;IAEtD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8C,CAAC;IAErE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,kBAAkB,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,iBAAiB,GAAG,KAAK,GAAG,uBAAuB,CAAC;QACnE,kFAAkF;QAClF,IAAI,MAAM,GAAG,uBAAuB,GAAG,KAAK,CAAC,UAAU;YAAE,MAAM;QAE/D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,UAAU;YAAE,SAAS;QAEjD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;AACxE,CAAC;AAED,kGAAkG;AAClG,sGAAsG;AACtG,uGAAuG;AACvG,MAAM,UAAU,WAAW,CAAC,KAA2B,EAAE,MAAc;IACrE,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAE,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC;AACzG,CAAC"}

package/dist/woff2Font.d.ts

@@ -0,0 +1,6 @@
+import type { Woff2TableDirectory } from '@flighthq/types/contract';
+import { Compression } from '@flighthq/types/contract';
+export declare const WOFF2_COMPRESSION: Compression;
+export declare function readWoff2Font(bytes: Readonly<Uint8Array>, decompress: ((compressed: Readonly<Uint8Array>, uncompressedLength: number) => Uint8Array | null) | null, reverseTransform: ((tag: string, transformed: Readonly<Uint8Array>, tables: ReadonlyMap<string, Uint8Array>) => Uint8Array | null) | null): Uint8Array | null;
+export declare function readWoff2TableDirectory(bytes: Readonly<Uint8Array>): Woff2TableDirectory | null;
+//# sourceMappingURL=woff2Font.d.ts.map

package/dist/woff2Font.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"woff2Font.d.ts","sourceRoot":"","sources":["../src/woff2Font.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAmB,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA4FvD,eAAO,MAAM,iBAAiB,EAAE,WAAgC,CAAC;AAMjE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAC,GAAG,IAAI,EACxG,gBAAgB,EACZ,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,UAAU,GAAG,IAAI,CAAC,GAChH,IAAI,GACP,UAAU,GAAG,IAAI,CA6CnB;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,mBAAmB,GAAG,IAAI,CAqD/F"}

package/dist/woff2Font.js

@@ -0,0 +1,210 @@
+import { Compression } from '@flighthq/types/contract';
+import { assembleSfntFont, packSfntTag } from './sfntAssembly';
+// WOFF2 is WOFF's wrapper idea taken two steps further, and both steps are why it needs its own reader
+// rather than a flag on the WOFF one.
+//
+//   1. ONE Brotli STREAM FOR THE WHOLE FONT, not one deflate stream per table. Tables are concatenated
+//      before compression, so nothing can be read until the entire stream is decompressed, and the
+//      directory carries lengths rather than offsets — there are no offsets to carry.
+//   2. TABLES MAY BE *TRANSFORMED*, not merely compressed. A transformed table is not the sfnt table in
+//      compressed form; it is a different byte layout that must be reversed to get the table back.
+//
+// The container layout is an interface fact about the format. The reading is Flight's own.
+//
+// ★ NO DECOMPRESSOR AND NO DICTIONARY SHIP WITH THIS. Brotli's decoder needs a large static dictionary
+// that is data rather than rules, so Flight registers nothing and the caller registers a decompressor
+// they already have — `zlib` on Node, an ordinary package in a browser. That is the same registry seam
+// WOFF already uses, and it keeps a `.ttf` reader from carrying a codec it never calls.
+const WOFF2_HEADER_BYTES = 48;
+// The 63 tags a directory entry can name by index instead of spelling out. The order is fixed by the
+// format — index 63 means an arbitrary tag follows as four bytes instead.
+const WOFF2_KNOWN_TAGS = [
+    'cmap',
+    'head',
+    'hhea',
+    'hmtx',
+    'maxp',
+    'name',
+    'OS/2',
+    'post',
+    'cvt ',
+    'fpgm',
+    'glyf',
+    'loca',
+    'prep',
+    'CFF ',
+    'VORG',
+    'EBDT',
+    'EBLC',
+    'gasp',
+    'hdmx',
+    'kern',
+    'LTSH',
+    'PCLT',
+    'VDMX',
+    'vhea',
+    'vmtx',
+    'BASE',
+    'GDEF',
+    'GPOS',
+    'GSUB',
+    'EBSC',
+    'JSTF',
+    'MATH',
+    'CBDT',
+    'CBLC',
+    'COLR',
+    'CPAL',
+    'SVG ',
+    'sbix',
+    'acnt',
+    'avar',
+    'bdat',
+    'bloc',
+    'bsln',
+    'cvar',
+    'fdsc',
+    'feat',
+    'fmtx',
+    'fvar',
+    'gvar',
+    'hsty',
+    'just',
+    'lcar',
+    'mort',
+    'morx',
+    'opbd',
+    'prop',
+    'trak',
+    'Zapf',
+    'Silf',
+    'Glat',
+    'Gloc',
+    'Feat',
+    'Sill',
+];
+// The compression this container uses. Named through the shared vocabulary rather than a local constant
+// so a caller registering a codec and this module asking for one cannot drift apart.
+export const WOFF2_COMPRESSION = Compression.Brotli;
+// Rebuilds the plain sfnt a WOFF2 wraps. Returns the null sentinel for a malformed container, for a
+// missing decompressor, and for a transform this package cannot reverse — the caller distinguishes those
+// through `explainOpenTypeFont`, because the remedies are a repaired file, one line of registration, and
+// a different producer respectively.
+export function readWoff2Font(bytes, decompress, reverseTransform) {
+    const directory = readWoff2TableDirectory(bytes);
+    if (directory === null)
+        return null;
+    if (decompress === null)
+        return null;
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const flavor = view.getUint32(4);
+    const totalCompressedSize = view.getUint32(20);
+    // The compressed stream begins immediately after the directory, whose length is only known once it has
+    // been walked. Deriving the start from the end of the file instead lands inside the format's trailing
+    // padding, which decodes as a valid but empty stream rather than failing.
+    const streamEnd = directory.streamStart + totalCompressedSize;
+    if (streamEnd > bytes.byteLength)
+        return null;
+    const stream = decompress(bytes.subarray(directory.streamStart, streamEnd), directory.totalUncompressedLength);
+    if (stream === null || stream.byteLength < directory.totalUncompressedLength)
+        return null;
+    // Tables sit end to end in the decompressed stream, in directory order, each occupying its transformed
+    // length where it was transformed and its original length where it was not.
+    const raw = new Map();
+    let at = 0;
+    for (const entry of directory.entries) {
+        const length = entry.transformed ? entry.transformLength : entry.originalLength;
+        if (at + length > stream.byteLength)
+            return null;
+        raw.set(entry.tag, stream.subarray(at, at + length));
+        at += length;
+    }
+    const tables = [];
+    for (const entry of directory.entries) {
+        const stored = raw.get(entry.tag);
+        if (!entry.transformed) {
+            tables.push({ data: stored, tag: packSfntTag(entry.tag) });
+            continue;
+        }
+        // A transform this package cannot reverse is refused rather than passed through. Emitting the
+        // transformed bytes under the table's own tag would produce a font whose directory says `glyf` over
+        // something that is not a `glyf` — readable, wrong, and silent.
+        if (reverseTransform === null)
+            return null;
+        const restored = reverseTransform(entry.tag, stored, raw);
+        if (restored === null)
+            return null;
+        tables.push({ data: restored, tag: packSfntTag(entry.tag) });
+    }
+    return assembleSfntFont(flavor, tables);
+}
+// The directory a WOFF2 carries in place of sfnt's offset table: one variable-length record per table,
+// naming a tag, whether it was transformed, and the lengths on both sides of that transform. Returns the
+// null sentinel rather than a partial directory, since a desynchronised walk yields entries whose tags
+// and lengths are real values read at the wrong offsets.
+export function readWoff2TableDirectory(bytes) {
+    if (bytes.byteLength < WOFF2_HEADER_BYTES)
+        return null;
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const tableCount = view.getUint16(12);
+    if (tableCount === 0)
+        return null;
+    const cursor = { at: WOFF2_HEADER_BYTES };
+    const entries = [];
+    let totalUncompressedLength = 0;
+    for (let index = 0; index < tableCount; index += 1) {
+        if (cursor.at >= bytes.byteLength)
+            return null;
+        const flags = view.getUint8(cursor.at);
+        cursor.at += 1;
+        const tagIndex = flags & 0x3f;
+        const transformVersion = (flags >> 6) & 0x03;
+        let tag;
+        if (tagIndex === 0x3f) {
+            if (cursor.at + 4 > bytes.byteLength)
+                return null;
+            tag = String.fromCharCode(view.getUint8(cursor.at), view.getUint8(cursor.at + 1), view.getUint8(cursor.at + 2), view.getUint8(cursor.at + 3));
+            cursor.at += 4;
+        }
+        else {
+            tag = WOFF2_KNOWN_TAGS[tagIndex];
+        }
+        const originalLength = readWoff2Base128(view, cursor, bytes.byteLength);
+        if (originalLength < 0)
+            return null;
+        // The sense of `transformVersion` is INVERTED for the glyph pair, and getting this backwards is the
+        // mistake that reads a length field that is not there: for `glyf` and `loca`, version 3 means the
+        // null transform, while for every other table it is version 0 that means untransformed.
+        const isGlyphPair = tag === 'glyf' || tag === 'loca';
+        const transformed = isGlyphPair ? transformVersion !== 3 : transformVersion !== 0;
+        let transformLength = originalLength;
+        if (transformed) {
+            transformLength = readWoff2Base128(view, cursor, bytes.byteLength);
+            if (transformLength < 0)
+                return null;
+        }
+        entries.push({ originalLength, tag, transformLength, transformVersion, transformed });
+        totalUncompressedLength += transformed ? transformLength : originalLength;
+    }
+    return { entries, streamStart: cursor.at, totalUncompressedLength };
+}
+// UIntBase128: seven bits per byte, most significant first, high bit set on every byte but the last.
+// Returns -1 for an unterminated or over-long value rather than a truncated number, so a caller cannot
+// mistake a malformed length for a small one. Five bytes is the most a 32-bit value can occupy, and a
+// leading zero byte is disallowed because it makes one value spellable two ways.
+function readWoff2Base128(view, cursor, end) {
+    let value = 0;
+    for (let byte = 0; byte < 5; byte += 1) {
+        if (cursor.at >= end)
+            return -1;
+        const next = view.getUint8(cursor.at);
+        cursor.at += 1;
+        if (byte === 0 && next === 0x80)
+            return -1;
+        value = value * 128 + (next & 0x7f);
+        if ((next & 0x80) === 0)
+            return value > 0xffffffff ? -1 : value;
+    }
+    return -1;
+}
+//# sourceMappingURL=woff2Font.js.map

package/dist/woff2Font.js.map

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

package/dist/woff2GlyfTransform.d.ts

@@ -0,0 +1,6 @@
+import type { Woff2GlyfStreams } from '@flighthq/types/contract';
+export declare function readWoff2GlyfStreams(transformed: Readonly<Uint8Array>): Woff2GlyfStreams | null;
+export declare function readWoff2Short(bytes: Readonly<Uint8Array>, cursor: {
+    at: number;
+}, end: number): number;
+//# sourceMappingURL=woff2GlyfTransform.d.ts.map

package/dist/woff2GlyfTransform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"woff2GlyfTransform.d.ts","sourceRoot":"","sources":["../src/woff2GlyfTransform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAwBjE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,IAAI,CA8C/F;AAQD,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAwBvG"}

package/dist/woff2GlyfTransform.js

@@ -0,0 +1,104 @@
+// The transformed `glyf` table: seven parallel sub-streams instead of one array of glyphs.
+//
+// WHY THE TRANSFORM EXISTS, WHICH IS ALSO WHY IT MUST BE REVERSED RATHER THAN DECOMPRESSED: a `glyf`
+// table interleaves contour counts, flags, coordinates and hinting bytecode per glyph, so similar values
+// end up far apart and compress badly. The transform SEPARATES them — every glyph's contour count in one
+// stream, every flag in another, every coordinate in a third — so like sits beside like. It is a
+// reordering, not a compression, and Brotli is applied over the result.
+//
+// So the reversal is a re-interleave: walk the streams in step and rebuild each glyph.
+//
+// The stream layout and header fields are interface facts about the format. The reading is Flight's own.
+const WOFF2_GLYF_HEADER_BYTES = 36;
+// Carves the seven sub-streams out of a transformed `glyf` table. Returns the null sentinel when the
+// declared sizes do not fit the table, rather than clamped streams: a stream that is short by a few bytes
+// still decodes into real-looking contour counts and coordinates, so a partial carve is the silent-
+// wrongness case rather than a visible one.
+//
+// Kept separate from the re-interleave so the split is checkable on its own — the seven sizes plus the
+// header must account for the table exactly, which is a property a real font can be tested against
+// without reconstructing a single glyph.
+export function readWoff2GlyfStreams(transformed) {
+    if (transformed.byteLength < WOFF2_GLYF_HEADER_BYTES)
+        return null;
+    const view = new DataView(transformed.buffer, transformed.byteOffset, transformed.byteLength);
+    const glyphCount = view.getUint16(4);
+    const indexFormat = view.getUint16(6);
+    const sizes = [];
+    for (let index = 0; index < 7; index += 1)
+        sizes.push(view.getUint32(8 + index * 4));
+    let total = WOFF2_GLYF_HEADER_BYTES;
+    for (const size of sizes)
+        total += size;
+    // The sizes must account for the table exactly. A table longer than its streams claim carries bytes
+    // nothing will read; one shorter means at least one stream is truncated.
+    if (total !== transformed.byteLength)
+        return null;
+    let at = WOFF2_GLYF_HEADER_BYTES;
+    const slice = (size) => {
+        const part = transformed.subarray(at, at + size);
+        at += size;
+        return part;
+    };
+    // Carved into locals in STREAM order before the object is built. The returned fields are alphabetized
+    // to match the rest of the package, and object literal properties evaluate in source order — so
+    // slicing inside the literal would consume the streams alphabetically and hand every field the right
+    // LENGTH with the wrong BYTES. Lengths alone cannot see that, which is why the order lives here.
+    const nContourStream = slice(sizes[0]);
+    const nPointsStream = slice(sizes[1]);
+    const flagStream = slice(sizes[2]);
+    const glyphStream = slice(sizes[3]);
+    const compositeStream = slice(sizes[4]);
+    const bboxStream = slice(sizes[5]);
+    const instructionStream = slice(sizes[6]);
+    return {
+        bboxStream,
+        compositeStream,
+        flagStream,
+        glyphCount,
+        glyphStream,
+        indexFormat,
+        instructionStream,
+        nContourStream,
+        nPointsStream,
+    };
+}
+// 255UInt16: a variable-length count used for point-per-contour and instruction lengths. Three escape
+// codes extend a single byte's range, and reading one with the wrong escape yields a plausible small
+// number rather than an error — which is why the codes are named rather than inlined.
+//
+// Advances `cursor.at`. Returns -1 when the value runs past `end`, so a caller can refuse rather than
+// treat a truncated stream as a short glyph.
+export function readWoff2Short(bytes, cursor, end) {
+    if (cursor.at >= end)
+        return -1;
+    const code = bytes[cursor.at];
+    cursor.at += 1;
+    if (code === WOFF2_SHORT_WORD) {
+        if (cursor.at + 2 > end)
+            return -1;
+        const value = (bytes[cursor.at] << 8) | bytes[cursor.at + 1];
+        cursor.at += 2;
+        return value;
+    }
+    if (code === WOFF2_SHORT_ONE_MORE_BYTE_2) {
+        if (cursor.at >= end)
+            return -1;
+        const value = bytes[cursor.at] + WOFF2_SHORT_LOWEST * 2;
+        cursor.at += 1;
+        return value;
+    }
+    if (code === WOFF2_SHORT_ONE_MORE_BYTE_1) {
+        if (cursor.at >= end)
+            return -1;
+        const value = bytes[cursor.at] + WOFF2_SHORT_LOWEST;
+        cursor.at += 1;
+        return value;
+    }
+    return code;
+}
+const WOFF2_SHORT_WORD = 253;
+const WOFF2_SHORT_ONE_MORE_BYTE_2 = 254;
+const WOFF2_SHORT_ONE_MORE_BYTE_1 = 255;
+const WOFF2_SHORT_LOWEST = 253;
+//# sourceMappingURL=woff2GlyfTransform.js.map

package/dist/woff2GlyfTransform.js.map

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

package/dist/woffFont.d.ts

@@ -0,0 +1,6 @@
+import type { WoffChecksumMismatch } from '@flighthq/types/contract';
+import { Compression } from '@flighthq/types/contract';
+export declare function readWoffChecksumMismatches(bytes: Readonly<Uint8Array>, decompress: ((compressed: Readonly<Uint8Array>, uncompressedLength: number) => Uint8Array | null) | null): readonly WoffChecksumMismatch[];
+export declare const WOFF_COMPRESSION: Compression;
+export declare function readWoffFont(bytes: Readonly<Uint8Array>, decompress: ((compressed: Readonly<Uint8Array>, uncompressedLength: number) => Uint8Array | null) | null): Uint8Array | null;
+//# sourceMappingURL=woffFont.d.ts.map

package/dist/woffFont.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"woffFont.d.ts","sourceRoot":"","sources":["../src/woffFont.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA8BvD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAC,GAAG,IAAI,GACvG,SAAS,oBAAoB,EAAE,CAgCjC;AAID,eAAO,MAAM,gBAAgB,EAAE,WAAiC,CAAC;AAKjE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,CAAC,GAAG,IAAI,GACvG,UAAU,GAAG,IAAI,CA4CnB"}

package/dist/woffFont.js

@@ -0,0 +1,112 @@
+import { Compression } from '@flighthq/types/contract';
+import { assembleSfntFont, computeSfntTableChecksum } from './sfntAssembly';
+// WOFF is a wrapper, not a font format: the same sfnt tables, each optionally deflated, behind a header
+// that says where they went. So the whole job is to REBUILD THE SFNT and hand it to the reader that
+// already exists — no new outline code, no new seam, and `glyf`, `CFF ` and CID all work through it
+// unchanged because they never learn the bytes arrived wrapped.
+//
+// The container layout is an interface fact about the format. The reconstruction is Flight's own.
+//
+// ★ THE DECOMPRESSOR IS NOT BUNDLED HERE, DELIBERATELY. It is fetched from `@flighthq/compression`'s
+// registry, which a caller opts into with `registerDeflateDecompressor()`. Importing the codec directly
+// would drag DEFLATE into every bundle that reads a `.ttf`, which is the bundle invariant this repository
+// enforces — an assembly never inflates the bundle cost of a primitive. The cost of that choice is that
+// an unregistered decompressor is a real outcome, so it gets its own reported reason rather than being
+// folded into "unsupported container".
+const WOFF_HEADER_BYTES = 44;
+const WOFF_DIRECTORY_ENTRY_BYTES = 20;
+// Which tables' stored checksums disagree with their own bytes. Returns an empty array when every
+// table agrees, and for a container this reader cannot open at all — a caller distinguishes those by
+// whether `readWoffFont` returned a font.
+//
+// ★ REPORTED, NEVER ENFORCED. A mismatch is bad data rather than API misuse, so it takes a sentinel
+// and not a throw, and the font still loads: deciding that a font is unacceptable belongs to the
+// caller, and a reader that refused one which would otherwise work would have taken that decision
+// away with no way to opt out. Kept as a separate query so a caller who never asks does not link the
+// arithmetic — the same shape as `explainOpenTypeFont`, for the same reason.
+export function readWoffChecksumMismatches(bytes, decompress) {
+    if (bytes.byteLength < WOFF_HEADER_BYTES)
+        return [];
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const tableCount = view.getUint16(12);
+    const directoryEnd = WOFF_HEADER_BYTES + tableCount * WOFF_DIRECTORY_ENTRY_BYTES;
+    if (tableCount === 0 || directoryEnd > bytes.byteLength)
+        return [];
+    const mismatches = [];
+    for (let index = 0; index < tableCount; index += 1) {
+        const record = WOFF_HEADER_BYTES + index * WOFF_DIRECTORY_ENTRY_BYTES;
+        const tag = view.getUint32(record);
+        const offset = view.getUint32(record + 4);
+        const compressedLength = view.getUint32(record + 8);
+        const originalLength = view.getUint32(record + 12);
+        const stored = view.getUint32(record + 16);
+        if (offset + compressedLength > bytes.byteLength)
+            continue;
+        const raw = bytes.subarray(offset, offset + compressedLength);
+        let data = raw;
+        if (compressedLength !== originalLength) {
+            if (decompress === null)
+                continue;
+            data = decompress(raw, originalLength);
+            if (data === null || data.byteLength !== originalLength)
+                continue;
+        }
+        const computed = computeSfntTableChecksum(data, tag === HEAD_TAG);
+        if (computed !== stored) {
+            mismatches.push({ computed, stored, tag: readWoffTagText(view, record) });
+        }
+    }
+    return mismatches;
+}
+// The compression this container uses. Named through the shared vocabulary rather than a local constant so
+// a caller registering a codec and this module asking for one cannot drift apart.
+export const WOFF_COMPRESSION = Compression.Deflate;
+// Rebuilds the plain sfnt a WOFF wraps. Returns the null sentinel for a malformed container, and for a
+// deflated table when no decompressor is registered — the caller distinguishes those through
+// `explainOpenTypeFont`, since one wants a repaired file and the other wants one line of registration.
+export function readWoffFont(bytes, decompress) {
+    if (bytes.byteLength < WOFF_HEADER_BYTES)
+        return null;
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const tableCount = view.getUint16(12);
+    if (tableCount === 0)
+        return null;
+    const directoryEnd = WOFF_HEADER_BYTES + tableCount * WOFF_DIRECTORY_ENTRY_BYTES;
+    if (directoryEnd > bytes.byteLength)
+        return null;
+    // The wrapper carries the sfnt version the tables belonged to, so the rebuilt font declares the flavor
+    // it actually is rather than one inferred from which tables happen to be present.
+    const flavor = view.getUint32(4);
+    const tables = [];
+    for (let index = 0; index < tableCount; index += 1) {
+        const record = WOFF_HEADER_BYTES + index * WOFF_DIRECTORY_ENTRY_BYTES;
+        const tag = view.getUint32(record);
+        const offset = view.getUint32(record + 4);
+        const compressedLength = view.getUint32(record + 8);
+        const originalLength = view.getUint32(record + 12);
+        if (offset + compressedLength > bytes.byteLength)
+            return null;
+        const stored = bytes.subarray(offset, offset + compressedLength);
+        // A table is stored uncompressed when the two lengths match — the format's own way of saying
+        // "compressing this one did not pay", so it is a normal case rather than an edge one.
+        if (compressedLength === originalLength) {
+            tables.push({ data: stored, tag });
+            continue;
+        }
+        if (decompress === null)
+            return null;
+        const inflated = decompress(stored, originalLength);
+        // A decompressor that returns the wrong length has produced something that is not this table, and
+        // reassembling it would yield a font whose directory lengths lie about its own contents.
+        if (inflated === null || inflated.byteLength !== originalLength)
+            return null;
+        tables.push({ data: inflated, tag });
+    }
+    return assembleSfntFont(flavor, tables);
+}
+// The four-character tag as text, for a caller that will show it or key on it.
+function readWoffTagText(view, record) {
+    return String.fromCharCode(view.getUint8(record), view.getUint8(record + 1), view.getUint8(record + 2), view.getUint8(record + 3));
+}
+const HEAD_TAG = 0x68656164;
+//# sourceMappingURL=woffFont.js.map

package/dist/woffFont.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"woffFont.js","sourceRoot":"","sources":["../src/woffFont.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,wGAAwG;AACxG,oGAAoG;AACpG,oGAAoG;AACpG,gEAAgE;AAChE,EAAE;AACF,kGAAkG;AAClG,EAAE;AACF,qGAAqG;AACrG,wGAAwG;AACxG,0GAA0G;AAC1G,wGAAwG;AACxG,uGAAuG;AACvG,uCAAuC;AAEvC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAEtC,kGAAkG;AAClG,qGAAqG;AACrG,0CAA0C;AAC1C,EAAE;AACF,oGAAoG;AACpG,iGAAiG;AACjG,kGAAkG;AAClG,qGAAqG;AACrG,6EAA6E;AAC7E,MAAM,UAAU,0BAA0B,CACxC,KAA2B,EAC3B,UAAwG;IAExG,IAAI,KAAK,CAAC,UAAU,GAAG,iBAAiB;QAAE,OAAO,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAE5E,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,iBAAiB,GAAG,UAAU,GAAG,0BAA0B,CAAC;IACjF,IAAI,UAAU,KAAK,CAAC,IAAI,YAAY,GAAG,KAAK,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAEnE,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,iBAAiB,GAAG,KAAK,GAAG,0BAA0B,CAAC;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QAC3C,IAAI,MAAM,GAAG,gBAAgB,GAAG,KAAK,CAAC,UAAU;YAAE,SAAS;QAE3D,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC;QAC9D,IAAI,IAAI,GAAsB,GAAiB,CAAC;QAChD,IAAI,gBAAgB,KAAK,cAAc,EAAE,CAAC;YACxC,IAAI,UAAU,KAAK,IAAI;gBAAE,SAAS;YAClC,IAAI,GAAG,UAAU,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YACvC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,cAAc;gBAAE,SAAS;QACpE,CAAC;QAED,MAAM,QAAQ,GAAG,wBAAwB,CAAC,IAAI,EAAE,GAAG,KAAK,QAAQ,CAAC,CAAC;QAClE,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,2GAA2G;AAC3G,kFAAkF;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAgB,WAAW,CAAC,OAAO,CAAC;AAEjE,uGAAuG;AACvG,6FAA6F;AAC7F,uGAAuG;AACvG,MAAM,UAAU,YAAY,CAC1B,KAA2B,EAC3B,UAAwG;IAExG,IAAI,KAAK,CAAC,UAAU,GAAG,iBAAiB;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAE5E,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACtC,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,YAAY,GAAG,iBAAiB,GAAG,UAAU,GAAG,0BAA0B,CAAC;IACjF,IAAI,YAAY,GAAG,KAAK,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAEjD,uGAAuG;IACvG,kFAAkF;IAClF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAMjC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,iBAAiB,GAAG,KAAK,GAAG,0BAA0B,CAAC;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1C,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QACnD,IAAI,MAAM,GAAG,gBAAgB,GAAG,KAAK,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE9D,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC;QACjE,6FAA6F;QAC7F,sFAAsF;QACtF,IAAI,gBAAgB,KAAK,cAAc,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAoB,EAAE,GAAG,EAAE,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QAED,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACpD,kGAAkG;QAClG,yFAAyF;QACzF,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,UAAU,KAAK,cAAc;YAAE,OAAO,IAAI,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,+EAA+E;AAC/E,SAAS,eAAe,CAAC,IAAwB,EAAE,MAAc;IAC/D,OAAO,MAAM,CAAC,YAAY,CACxB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EACrB,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAAG,UAAU,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@flighthq/font-formats",
+  "version": "0.3.1-next.209.43ef1bc",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/font-formats"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.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/compression": "0.3.1-next.209.43ef1bc",
+    "@flighthq/font": "0.3.1-next.209.43ef1bc",
+    "@flighthq/types": "0.3.1-next.209.43ef1bc"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "OpenType/TrueType codec neighbor of @flighthq/font — parse font bytes into a GlyphOutlineSource (outlines, advances, codepoint mapping)",
+  "sideEffects": false
+}