@flighthq/font-formats 0.3.1-next.1041.35b950c

package/dist/sfntAssembly.js

@@ -0,0 +1,237 @@
+// Writing a plain sfnt from tables somebody else unpacked.
+//
+// Both compressed wrappers end the same way: once WOFF has inflated its tables, or WOFF2 has
+// decompressed and un-transformed its own, what is left is the identical job of laying out an sfnt.
+// That job is the primitive, so it lives here rather than once per wrapper — an assembled font is a
+// composition of the same parts however it arrived, and a second copy is where the two would drift.
+const SFNT_HEADER_BYTES = 12;
+const SFNT_DIRECTORY_ENTRY_BYTES = 16;
+// Writes a header, a directory sorted by tag, then each table's data on a four-byte boundary.
+//
+// Sorting is required rather than cosmetic — the sfnt directory is defined as being in tag order, and a
+// reader entitled to binary-search it would otherwise find the wrong table. Alignment follows the
+// convention every real font is written with; it is not known to be enforced by consumers.
+//
+// `tag` is the four-character tag packed big-endian into a uint32, which is the form it is compared and
+// sorted in, so no reader has to round-trip it through a string to order a directory.
+export function assembleSfntFont(flavor, tables) {
+    const sorted = [...tables].sort((a, b) => a.tag - b.tag);
+    const headerBytes = SFNT_HEADER_BYTES + sorted.length * SFNT_DIRECTORY_ENTRY_BYTES;
+    let total = headerBytes;
+    for (const table of sorted)
+        total += (table.data.byteLength + 3) & ~3;
+    const out = new Uint8Array(total);
+    const view = new DataView(out.buffer);
+    view.setUint32(0, flavor);
+    view.setUint16(4, sorted.length);
+    // searchRange, entrySelector and rangeShift are derived values a reader can recompute; the reader in
+    // this package walks the directory linearly and never consults them, so they are left zero rather than
+    // written with values nothing checks.
+    let dataAt = headerBytes;
+    sorted.forEach((table, index) => {
+        const record = SFNT_HEADER_BYTES + index * SFNT_DIRECTORY_ENTRY_BYTES;
+        view.setUint32(record, table.tag);
+        // The real checksum, computed from the bytes being written. An assembled font that carried zeros
+        // here would be making a false statement about tables it holds, and any consumer that does check
+        // would read the zero as a mismatch.
+        view.setUint32(record + 4, computeSfntTableChecksum(table.data, table.tag === HEAD_TAG));
+        view.setUint32(record + 8, dataAt);
+        view.setUint32(record + 12, table.data.byteLength);
+        out.set(table.data, dataAt);
+        dataAt += (table.data.byteLength + 3) & ~3;
+    });
+    return out;
+}
+// The checksum an sfnt directory stores for a table: the sum of its bytes read as big-endian uint32
+// words, zero-padded to a four-byte boundary, taken modulo 2^32. An interface fact about the format.
+//
+// ★ `head` IS THE ONE EXCEPTION AND OMITTING IT MAKES EVERY REAL FONT REPORT A MISMATCH. The table
+// carries `checkSumAdjustment` at byte 8, a value derived from the whole font's checksum, and the
+// format defines the table's own checksum as being computed with that field treated as ZERO —
+// otherwise the value would have to contain a function of itself.
+export function computeSfntTableChecksum(data, isHeadTable = false) {
+    let sum = 0;
+    for (let at = 0; at < data.byteLength; at += 4) {
+        // Bytes past the end read as zero, which is the padding the format defines rather than a guard.
+        const zeroed = isHeadTable && at === HEAD_CHECKSUM_ADJUSTMENT_OFFSET;
+        const word = zeroed
+            ? 0
+            : (data[at] ?? 0) * 0x1000000 + (data[at + 1] ?? 0) * 0x10000 + (data[at + 2] ?? 0) * 0x100 + (data[at + 3] ?? 0);
+        sum = (sum + word) % 0x100000000;
+    }
+    return sum >>> 0;
+}
+// Packs a four-character tag into the uint32 an sfnt directory stores it as. Tags shorter than four
+// characters are padded with spaces, which is how the format spells `cvt ` and `CFF ` — a caller
+// Encodes one composite glyph: the header and bounds, then the component records verbatim, then the
+// hinting instructions if any component asked for them. `components` is the slice of the WOFF2
+// composite stream that `measureWoff2CompositeGlyph` sized, and it is copied unchanged — the transform
+// reorders whole glyphs, it does not re-encode a component record.
+//
+// ★ THE CONTOUR COUNT IS A MARKER HERE, NOT A COUNT. Any negative value means "composite", and the
+// reader switches on the sign alone before reading anything else; -1 is the conventional spelling. A
+// caller that passed the number of components instead would write a positive count and every reader
+// would parse the component records as an endPtsOfContours array.
+//
+// ★ A COMPOSITE CANNOT COMPUTE ITS OWN BOUNDS FROM WHAT IT HOLDS, which is why `bounds` is required
+// rather than optional: it names other glyphs and places them, so its box depends on glyphs it does
+// not carry. This is also why the WOFF2 transform always stores an explicit box for one.
+export function encodeSfntCompositeGlyph(components, instructions, bounds, hasInstructions) {
+    // The instruction length field exists only when a component set the flag. Writing a zero length
+    // unconditionally would add two bytes no reader expects and shift every following glyph.
+    const tail = hasInstructions ? 2 + instructions.byteLength : 0;
+    const out = new Uint8Array(10 + components.byteLength + tail);
+    const view = new DataView(out.buffer);
+    view.setInt16(0, -1);
+    view.setInt16(2, bounds.xMin);
+    view.setInt16(4, bounds.yMin);
+    view.setInt16(6, bounds.xMax);
+    view.setInt16(8, bounds.yMax);
+    out.set(components, 10);
+    if (hasInstructions) {
+        view.setUint16(10 + components.byteLength, instructions.byteLength);
+        out.set(instructions, 12 + components.byteLength);
+    }
+    return out;
+}
+// Builds the `loca` table from each glyph record's length, in glyph order. `loca` holds glyphCount + 1
+// offsets, because a glyph's length is the gap to the NEXT entry — which is also how a zero-length
+// (blank) glyph is expressed, as two equal consecutive offsets.
+//
+// ★ THE SHORT FORM STORES HALF THE OFFSET, WHICH MAKES EVEN PADDING A CORRECTNESS REQUIREMENT RATHER
+// THAN A TIDINESS ONE. With `indexFormat` 0 each entry is `offset / 2` in a uint16, so an odd offset is
+// not representable and would be silently truncated to the even one below it — pointing the reader at
+// the previous glyph's last byte. Callers must therefore pad every record to an even length before
+// measuring it here. Returns the null sentinel rather than truncating when an offset is odd, or when
+// the font is too large for the short form to reach.
+export function encodeSfntLoca(glyphLengths, indexFormat) {
+    const entries = glyphLengths.length + 1;
+    const out = new Uint8Array(indexFormat === 0 ? entries * 2 : entries * 4);
+    const view = new DataView(out.buffer);
+    let offset = 0;
+    for (let index = 0; index < entries; index += 1) {
+        if (indexFormat === 0) {
+            if (offset % 2 !== 0)
+                return null;
+            if (offset / 2 > 0xffff)
+                return null;
+            view.setUint16(index * 2, offset / 2);
+        }
+        else {
+            view.setUint32(index * 4, offset);
+        }
+        offset += glyphLengths[index] ?? 0;
+    }
+    return out;
+}
+// Encodes one simple glyph as the `glyf` table stores it: the contour ends, the hinting instructions,
+// then per-point flags and the x and y deltas the flags describe. `xs` and `ys` are ABSOLUTE coordinates
+// in font units; the deltas are computed here, because the encoding is defined over deltas and a caller
+// holding absolute points should not have to know that.
+//
+// Returns an empty array for a glyph with no contours. A `glyf` entry of length zero is how the format
+// spells "this glyph draws nothing" — a blank record with a zero contour count is NOT the same thing,
+// and writing one gives every space character a bounding box.
+//
+// ★ THE ENCODING IS A COMPRESSION, AND EVERY POINT HAS SEVERAL VALID SPELLINGS. A delta of zero can be
+// written as "same as previous" with no bytes at all; a delta within a byte can be written short with a
+// sign bit, or long as an int16. Choosing the smallest is what a font producer does, but a font that
+// chose differently is still correct — so a byte-for-byte comparison against a real font measures
+// agreement with THAT producer's choices, not correctness. Compare geometry to judge correctness.
+export function encodeSfntSimpleGlyph(endPtsOfContours, xs, ys, onCurve, instructions, bounds) {
+    if (endPtsOfContours.length === 0)
+        return new Uint8Array(0);
+    const pointCount = xs.length;
+    const flags = [];
+    const xBytes = [];
+    const yBytes = [];
+    let previousX = 0;
+    let previousY = 0;
+    for (let point = 0; point < pointCount; point += 1) {
+        const dx = xs[point] - previousX;
+        const dy = ys[point] - previousY;
+        previousX = xs[point];
+        previousY = ys[point];
+        let flag = onCurve[point] === true ? SFNT_GLYF_ON_CURVE : 0;
+        // A zero delta needs no bytes: the "same or positive" bit alone means unchanged when the matching
+        // short bit is clear, which is why these two bits cannot be read independently.
+        if (dx === 0)
+            flag |= SFNT_GLYF_X_SAME_OR_POSITIVE;
+        else if (dx >= -255 && dx <= 255) {
+            flag |= SFNT_GLYF_X_SHORT;
+            if (dx > 0)
+                flag |= SFNT_GLYF_X_SAME_OR_POSITIVE;
+            xBytes.push(Math.abs(dx));
+        }
+        else
+            xBytes.push((dx >> 8) & 0xff, dx & 0xff);
+        if (dy === 0)
+            flag |= SFNT_GLYF_Y_SAME_OR_POSITIVE;
+        else if (dy >= -255 && dy <= 255) {
+            flag |= SFNT_GLYF_Y_SHORT;
+            if (dy > 0)
+                flag |= SFNT_GLYF_Y_SAME_OR_POSITIVE;
+            yBytes.push(Math.abs(dy));
+        }
+        else
+            yBytes.push((dy >> 8) & 0xff, dy & 0xff);
+        flags.push(flag);
+    }
+    // Runs of identical flags collapse into one flag plus a repeat count. The count is a single byte, so
+    // a run longer than 256 becomes several repeat groups rather than one overflowing count.
+    const packedFlags = [];
+    for (let index = 0; index < flags.length;) {
+        const flag = flags[index];
+        let run = 1;
+        while (index + run < flags.length && flags[index + run] === flag && run < 256)
+            run += 1;
+        if (run > 1)
+            packedFlags.push(flag | SFNT_GLYF_REPEAT, run - 1);
+        else
+            packedFlags.push(flag);
+        index += run;
+    }
+    const size = 10 + endPtsOfContours.length * 2 + 2 + instructions.byteLength + packedFlags.length + xBytes.length + yBytes.length;
+    const out = new Uint8Array(size);
+    const view = new DataView(out.buffer);
+    view.setInt16(0, endPtsOfContours.length);
+    view.setInt16(2, bounds.xMin);
+    view.setInt16(4, bounds.yMin);
+    view.setInt16(6, bounds.xMax);
+    view.setInt16(8, bounds.yMax);
+    let at = 10;
+    for (const end of endPtsOfContours) {
+        view.setUint16(at, end);
+        at += 2;
+    }
+    view.setUint16(at, instructions.byteLength);
+    at += 2;
+    out.set(instructions, at);
+    at += instructions.byteLength;
+    out.set(packedFlags, at);
+    at += packedFlags.length;
+    out.set(xBytes, at);
+    at += xBytes.length;
+    out.set(yBytes, at);
+    return out;
+}
+// passing the unpadded name gets the same value the font carries rather than a silent mismatch.
+export function packSfntTag(tag) {
+    const padded = tag.padEnd(4, ' ');
+    return (((padded.charCodeAt(0) << 24) |
+        (padded.charCodeAt(1) << 16) |
+        (padded.charCodeAt(2) << 8) |
+        padded.charCodeAt(3)) >>>
+        0);
+}
+const HEAD_TAG = 0x68656164;
+const HEAD_CHECKSUM_ADJUSTMENT_OFFSET = 8;
+// Point flag bits, as the `glyf` format defines them. The two SAME_OR_POSITIVE bits do double duty:
+// with the matching SHORT bit set they carry the sign, and with it clear they mean the delta is zero.
+const SFNT_GLYF_ON_CURVE = 0x01;
+const SFNT_GLYF_REPEAT = 0x08;
+const SFNT_GLYF_X_SAME_OR_POSITIVE = 0x10;
+const SFNT_GLYF_X_SHORT = 0x02;
+const SFNT_GLYF_Y_SAME_OR_POSITIVE = 0x20;
+const SFNT_GLYF_Y_SHORT = 0x04;
+//# sourceMappingURL=sfntAssembly.js.map

package/dist/sfntAssembly.js.map

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

package/dist/sfntTableDirectory.d.ts

@@ -0,0 +1,4 @@
+import type { SfntTableDirectory } from '@flighthq/types/contract';
+export declare function readSfntTableDirectory(bytes: Readonly<Uint8Array>): SfntTableDirectory | null;
+export declare function readSfntTag(bytes: Readonly<Uint8Array>, offset: number): string;
+//# sourceMappingURL=sfntTableDirectory.d.ts.map

package/dist/sfntTableDirectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfntTableDirectory.d.ts","sourceRoot":"","sources":["../src/sfntTableDirectory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAiBnE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,kBAAkB,GAAG,IAAI,CAoB7F;AAKD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/E"}

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 { Decompressor, 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: Decompressor | 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,YAAY,EAAE,mBAAmB,EAAmB,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,WAAW,EAAsB,MAAM,0BAA0B,CAAC;AA4F3E,eAAO,MAAM,iBAAiB,EAAE,WAAgC,CAAC;AAMjE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,UAAU,EAAE,YAAY,GAAG,IAAI,EAC/B,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,CAiDnB;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, CompressionFraming } 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, CompressionFraming.Raw);
+    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":"AACA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE3E,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE/D,uGAAuG;AACvG,sCAAsC;AACtC,EAAE;AACF,uGAAuG;AACvG,mGAAmG;AACnG,sFAAsF;AACtF,wGAAwG;AACxG,mGAAmG;AACnG,EAAE;AACF,2FAA2F;AAC3F,EAAE;AACF,uGAAuG;AACvG,sGAAsG;AACtG,uGAAuG;AACvG,wFAAwF;AAExF,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,qGAAqG;AACrG,0EAA0E;AAC1E,MAAM,gBAAgB,GAAsB;IAC1C,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC;AAEF,wGAAwG;AACxG,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAgB,WAAW,CAAC,MAAM,CAAC;AAEjE,oGAAoG;AACpG,yGAAyG;AACzG,yGAAyG;AACzG,qCAAqC;AACrC,MAAM,UAAU,aAAa,CAC3B,KAA2B,EAC3B,UAA+B,EAC/B,gBAEQ;IAER,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAErC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC/C,uGAAuG;IACvG,sGAAsG;IACtG,0EAA0E;IAC1E,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,GAAG,mBAAmB,CAAC;IAC9D,IAAI,SAAS,GAAG,KAAK,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE9C,MAAM,MAAM,GAAG,UAAU,CACvB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,EAChD,SAAS,CAAC,uBAAuB,EACjC,kBAAkB,CAAC,GAAG,CACvB,CAAC;IACF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC,uBAAuB;QAAE,OAAO,IAAI,CAAC;IAE1F,uGAAuG;IACvG,4EAA4E;IAC5E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;QAChF,IAAI,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QACjD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;QACrD,EAAE,IAAI,MAAM,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAkD,EAAE,CAAC;IACjE,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC3D,SAAS;QACX,CAAC;QACD,8FAA8F;QAC9F,oGAAoG;QACpG,gEAAgE;QAChE,IAAI,gBAAgB,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1D,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,uGAAuG;AACvG,yGAAyG;AACzG,uGAAuG;AACvG,yDAAyD;AACzD,MAAM,UAAU,uBAAuB,CAAC,KAA2B;IACjE,IAAI,KAAK,CAAC,UAAU,GAAG,kBAAkB;QAAE,OAAO,IAAI,CAAC;IACvD,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;IAElC,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,IAAI,uBAAuB,GAAG,CAAC,CAAC;IAEhC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnD,IAAI,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAEf,MAAM,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC;QAC9B,MAAM,gBAAgB,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;QAE7C,IAAI,GAAW,CAAC;QAChB,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,UAAU;gBAAE,OAAO,IAAI,CAAC;YAClD,GAAG,GAAG,MAAM,CAAC,YAAY,CACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EACxB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,EAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,EAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAC7B,CAAC;YACF,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAE,CAAC;QACpC,CAAC;QAED,MAAM,cAAc,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QACxE,IAAI,cAAc,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,oGAAoG;QACpG,kGAAkG;QAClG,wFAAwF;QACxF,MAAM,WAAW,GAAG,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,CAAC;QACrD,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC;QAElF,IAAI,eAAe,GAAG,cAAc,CAAC;QACrC,IAAI,WAAW,EAAE,CAAC;YAChB,eAAe,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YACnE,IAAI,eAAe,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QACvC,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC;QACtF,uBAAuB,IAAI,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC;IAC5E,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,uBAAuB,EAAE,CAAC;AACtE,CAAC;AAED,qGAAqG;AACrG,uGAAuG;AACvG,sGAAsG;AACtG,iFAAiF;AACjF,SAAS,gBAAgB,CAAC,IAAwB,EAAE,MAAsB,EAAE,GAAW;IACrF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,EAAE,IAAI,GAAG;YAAE,OAAO,CAAC,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QACf,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,CAAC,CAAC,CAAC;QAC3C,KAAK,GAAG,KAAK,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/woff2GlyfTransform.d.ts

@@ -0,0 +1,23 @@
+import type { Woff2GlyfStreams } from '@flighthq/types/contract';
+export declare function createWoff2TransformReverser(): (tag: string, transformed: Readonly<Uint8Array>, tables: ReadonlyMap<string, Uint8Array>) => Uint8Array | null;
+export declare function decodeWoff2Triplet(code: number, glyphStream: Readonly<Uint8Array>, at: number): {
+    dx: number;
+    dy: number;
+    used: number;
+} | null;
+export declare function getWoff2BboxBitmapByteLength(glyphCount: number): number;
+export declare function hasWoff2GlyphBbox(bboxStream: Readonly<Uint8Array>, glyphIndex: number): boolean;
+export declare function isWoff2PointOnCurve(flag: number): boolean;
+export declare function measureWoff2CompositeGlyph(compositeStream: Readonly<Uint8Array>, at: number): {
+    byteLength: number;
+    hasInstructions: boolean;
+} | null;
+export declare function readWoff2GlyfStreams(transformed: Readonly<Uint8Array>): Woff2GlyfStreams | null;
+export declare function readWoff2Short(bytes: Readonly<Uint8Array>, cursor: {
+    at: number;
+}, end: number): number;
+export declare function reverseWoff2GlyfTransform(streams: Readonly<Woff2GlyfStreams>): {
+    glyf: Uint8Array;
+    loca: Uint8Array;
+} | null;
+//# 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;AA8BjE,wBAAgB,4BAA4B,IAAI,CAC9C,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,EACjC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,KACpC,UAAU,GAAG,IAAI,CA2BrB;AAgBD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,EACjC,EAAE,EAAE,MAAM,GACT;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsCjD;AAeD,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvE;AASD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAI/F;AAcD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAmBD,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,EACrC,EAAE,EAAE,MAAM,GACT;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAwBzD;AAUD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,gBAAgB,GAAG,IAAI,CA8C/F;AA2BD,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;AAuCD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CA0G/C"}