@unisim/doc 0.6.0 → 0.8.0

package/dist/truetype.js

@@ -0,0 +1,289 @@
+// ---------------------------------------------------------------------------
+// Just enough of a TrueType font to embed one in a PDF.
+//
+// WHY THIS EXISTS
+// ---------------
+// The base-14 fonts every PDF reader already has can spell Latin-1 and the
+// Windows-1252 extras, and nothing else. `pdfcore` gives ASCII stand-ins to the
+// symbols that have a fair one — an arrow, a box-drawing rule, a warning sign —
+// but there is no stand-in for an ALPHABET. Cyrillic, Greek and Hebrew were
+// written as a row of '?' and reported as lost, and the only way to write them
+// is to put a font in the file.
+//
+// WHAT IT DELIBERATELY DOES NOT DO
+// --------------------------------
+//   * NO SUBSETTING. Rebuilding `glyf`/`loca`/`cmap`/`hmtx` for a subset is the
+//     hard, bug-prone half of a font toolkit, and its payoff is output size on
+//     the minority of documents that need a font at all. The whole face is
+//     embedded, once, and only into documents that use it.
+//   * NO SHAPING. There is no GSUB/GPOS here, so scripts that REQUIRE shaping to
+//     be legible — Arabic's joining forms, the Indic scripts — are not made
+//     readable by embedding a font and must not be claimed. Cyrillic, Greek and
+//     Hebrew need none: they are one code point, one glyph, left to right (and
+//     Hebrew's direction is the reader's business, not the encoding's).
+//   * NO `post` GLYPH NAMES, NO KERNING. Identity-H addresses glyphs by index,
+//     so names are never needed; kerning is a refinement the layout engine
+//     above this has never had for the base-14 either.
+//
+// ⚠️ THE UNITS TRAP. A font's own numbers are in `unitsPerEm`, which is 2048 for
+// most TrueType faces and 1000 for most PostScript ones. PDF text space is
+// ALWAYS 1/1000. Everything this module hands out is already converted, so a
+// caller never sees `unitsPerEm` — the one number that would silently scale
+// every advance by 2.048 if it leaked.
+// ---------------------------------------------------------------------------
+class Reader {
+    bytes;
+    view;
+    constructor(bytes) {
+        this.bytes = bytes;
+        this.view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    }
+    u8(at) { return this.view.getUint8(at); }
+    u16(at) { return this.view.getUint16(at); }
+    i16(at) { return this.view.getInt16(at); }
+    u32(at) { return this.view.getUint32(at); }
+    /** A 16.16 fixed-point number, which is how `post` stores the italic angle. */
+    fixed(at) { return this.view.getInt32(at) / 65536; }
+}
+export class FontFormatError extends Error {
+}
+/**
+ * Parse a `.ttf`.
+ *
+ * ⚠️ Rejects `.otf` (CFF outlines, `OTTO`) and both flavours of WOFF. All three
+ * are real fonts a person might reasonably hand over, and NONE can go into a
+ * `/FontFile2` — that key means "a TrueType font program", and a reader given
+ * CFF bytes under it will either draw nothing or refuse the file. Failing here
+ * with a sentence is much better than producing a PDF that opens blank.
+ */
+export function readTrueType(bytes) {
+    if (bytes.length < 12)
+        throw new FontFormatError('That font file is too short to be a font.');
+    const r = new Reader(bytes);
+    const tag = r.u32(0);
+    if (tag === 0x4f54544f) {
+        throw new FontFormatError('That is an OpenType/CFF font (.otf). A PDF needs TrueType outlines (.ttf).');
+    }
+    if (tag === 0x774f4646 || tag === 0x774f4632) {
+        throw new FontFormatError('That is a WOFF web font. Uncompress it to a .ttf first.');
+    }
+    // 0x00010000 is the ordinary TrueType version; 'true' is Apple's old variant.
+    if (tag !== 0x00010000 && tag !== 0x74727565) {
+        throw new FontFormatError('That file does not start like a TrueType font.');
+    }
+    const tables = new Map();
+    const count = r.u16(4);
+    for (let i = 0; i < count; i += 1) {
+        const at = 12 + i * 16;
+        const name = String.fromCharCode(r.u8(at), r.u8(at + 1), r.u8(at + 2), r.u8(at + 3));
+        tables.set(name, { off: r.u32(at + 8), len: r.u32(at + 12) });
+    }
+    const need = (name) => {
+        const t = tables.get(name);
+        if (!t)
+            throw new FontFormatError(`That font has no '${name}' table, so it cannot be embedded.`);
+        return t;
+    };
+    const head = need('head').off;
+    const unitsPerEm = r.u16(head + 18);
+    if (!unitsPerEm)
+        throw new FontFormatError('That font declares no units per em.');
+    // The conversion every number below goes through, and the reason no caller
+    // ever sees `unitsPerEm`.
+    const toThousandths = (value) => Math.round((value * 1000) / unitsPerEm);
+    const numGlyphs = r.u16(need('maxp').off + 4);
+    const hhea = need('hhea').off;
+    const numberOfHMetrics = r.u16(hhea + 34);
+    const hmtx = need('hmtx').off;
+    const advances = new Int32Array(numGlyphs);
+    let last = 0;
+    for (let g = 0; g < numGlyphs; g += 1) {
+        if (g < numberOfHMetrics)
+            last = r.u16(hmtx + g * 4);
+        advances[g] = toThousandths(last);
+    }
+    const cmap = readCmap(r, need('cmap').off);
+    // OS/2 is optional in the spec and present in practice. Where it is missing,
+    // hhea's ascender/descender are the same measurements by another name.
+    const os2 = tables.get('OS/2')?.off;
+    let capHeight = 0;
+    let ascent = toThousandths(r.i16(hhea + 4));
+    let descent = toThousandths(r.i16(hhea + 6));
+    let italic = false;
+    if (os2 !== undefined) {
+        const version = r.u16(os2);
+        ascent = toThousandths(r.i16(os2 + 68)) || ascent; // sTypoAscender
+        descent = toThousandths(r.i16(os2 + 70)) || descent; // sTypoDescender
+        italic = (r.u16(os2 + 62) & 1) !== 0; // fsSelection bit 0
+        if (version >= 2)
+            capHeight = toThousandths(r.i16(os2 + 88));
+    }
+    // A missing cap height is not worth refusing over — readers use it for
+    // small-caps substitution and hinting hints, and 70% of the ascent is the
+    // conventional stand-in.
+    if (!capHeight)
+        capHeight = Math.round(ascent * 0.7);
+    const post = tables.get('post')?.off;
+    const italicAngle = post !== undefined ? r.fixed(post + 4) : 0;
+    // /Flags, per PDF 32000-1 table 123. Bit 3 (value 4) is "symbolic", bit 6
+    // (32) "non-symbolic"; they are mutually exclusive and a text face is the
+    // second. Bit 1 (1) is fixed-pitch, bit 7 (64) italic.
+    let flags = 32;
+    if (italic || italicAngle !== 0)
+        flags |= 64;
+    if (numberOfHMetrics === 1)
+        flags |= 1;
+    return {
+        bytes,
+        postScriptName: readPostScriptName(r, tables.get('name')?.off) ?? 'EmbeddedFallback',
+        numGlyphs,
+        ascent,
+        descent,
+        capHeight,
+        italicAngle,
+        bbox: [
+            toThousandths(r.i16(head + 36)),
+            toThousandths(r.i16(head + 38)),
+            toThousandths(r.i16(head + 40)),
+            toThousandths(r.i16(head + 42)),
+        ],
+        flags,
+        glyphFor: (codePoint) => cmap.get(codePoint),
+        advanceOf: (glyph) => (glyph >= 0 && glyph < numGlyphs ? advances[glyph] : 0),
+    };
+}
+/**
+ * The character map, as one plain Map.
+ *
+ * Built eagerly rather than searched per lookup. A face this package would
+ * embed has a few thousand mapped code points; the Map costs a few hundred
+ * kilobytes of heap once, and the alternative is a binary search through the
+ * segment arrays on every character of every line, including the re-measure the
+ * line-breaker does when a word does not fit.
+ *
+ * ⚠️ Subtable preference is (3,10) then (3,1) then (0,·) — Microsoft's UCS-4
+ * table first, because a font that has both puts everything above U+FFFF in it
+ * and only that one can address them.
+ */
+function readCmap(r, at) {
+    const count = r.u16(at + 2);
+    let chosen = null;
+    let rank = -1;
+    for (let i = 0; i < count; i += 1) {
+        const entry = at + 4 + i * 8;
+        const platform = r.u16(entry);
+        const encoding = r.u16(entry + 2);
+        const offset = at + r.u32(entry + 4);
+        const score = platform === 3 && encoding === 10 ? 3 :
+            platform === 3 && encoding === 1 ? 2 :
+                platform === 0 ? 1 : 0;
+        if (score > rank) {
+            rank = score;
+            chosen = offset;
+        }
+    }
+    const map = new Map();
+    if (chosen === null)
+        return map;
+    const format = r.u16(chosen);
+    if (format === 4)
+        readCmap4(r, chosen, map);
+    else if (format === 12)
+        readCmap12(r, chosen, map);
+    else if (format === 6)
+        readCmap6(r, chosen, map);
+    return map;
+}
+/** Format 4: segmented, BMP only. What almost every font uses. */
+function readCmap4(r, at, map) {
+    const segments = r.u16(at + 6) / 2;
+    const endAt = at + 14;
+    const startAt = endAt + segments * 2 + 2;
+    const deltaAt = startAt + segments * 2;
+    const rangeAt = deltaAt + segments * 2;
+    for (let s = 0; s < segments; s += 1) {
+        const end = r.u16(endAt + s * 2);
+        const start = r.u16(startAt + s * 2);
+        const delta = r.i16(deltaAt + s * 2);
+        const rangeOffset = r.u16(rangeAt + s * 2);
+        // The last segment is the required 0xFFFF terminator, not a character.
+        for (let code = start; code <= end && code !== 0xffff; code += 1) {
+            let glyph;
+            if (rangeOffset === 0) {
+                glyph = (code + delta) & 0xffff;
+            }
+            else {
+                // The one genuinely strange piece of the format: `idRangeOffset` is a
+                // byte offset from ITS OWN slot, not from the start of the array.
+                const g = r.u16(rangeAt + s * 2 + rangeOffset + (code - start) * 2);
+                glyph = g === 0 ? 0 : (g + delta) & 0xffff;
+            }
+            if (glyph)
+                map.set(code, glyph);
+        }
+    }
+}
+/** Format 12: flat groups, the whole of Unicode. */
+function readCmap12(r, at, map) {
+    const groups = r.u32(at + 12);
+    for (let g = 0; g < groups; g += 1) {
+        const entry = at + 16 + g * 12;
+        const start = r.u32(entry);
+        const end = r.u32(entry + 4);
+        const firstGlyph = r.u32(entry + 8);
+        // A malformed group could otherwise spin for four billion iterations.
+        if (end < start || end - start > 0x10ffff)
+            continue;
+        for (let code = start; code <= end; code += 1)
+            map.set(code, firstGlyph + (code - start));
+    }
+}
+/** Format 6: one dense range. Rare, and three lines. */
+function readCmap6(r, at, map) {
+    const first = r.u16(at + 6);
+    const count = r.u16(at + 8);
+    for (let i = 0; i < count; i += 1) {
+        const glyph = r.u16(at + 10 + i * 2);
+        if (glyph)
+            map.set(first + i, glyph);
+    }
+}
+/**
+ * Name ID 6 — the PostScript name — for `/BaseFont`.
+ *
+ * Both encodings are read because fonts disagree: platform 3 stores UTF-16BE,
+ * platform 1 stores single bytes. A name that comes back with a NUL between
+ * every letter is the classic symptom of reading one as the other.
+ */
+function readPostScriptName(r, at) {
+    if (at === undefined)
+        return null;
+    const count = r.u16(at + 2);
+    const storage = at + r.u16(at + 4);
+    let fallback = null;
+    for (let i = 0; i < count; i += 1) {
+        const entry = at + 6 + i * 12;
+        if (r.u16(entry + 6) !== 6)
+            continue;
+        const platform = r.u16(entry);
+        const length = r.u16(entry + 8);
+        const offset = storage + r.u16(entry + 10);
+        let name = '';
+        if (platform === 3) {
+            for (let b = 0; b + 1 < length; b += 2)
+                name += String.fromCharCode(r.u16(offset + b));
+        }
+        else {
+            for (let b = 0; b < length; b += 1)
+                name += String.fromCharCode(r.u8(offset + b));
+        }
+        // A PostScript name may not contain a space or any PDF delimiter.
+        name = name.replace(/[\s()<>[\]{}/%]/g, '');
+        if (platform === 3 && name)
+            return name;
+        if (name && !fallback)
+            fallback = name;
+    }
+    return fallback;
+}
+//# sourceMappingURL=truetype.js.map

package/dist/truetype.js.map

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

package/dist/write/pdf.d.ts

@@ -6,5 +6,21 @@ export interface PdfResult {
     /** Characters no base-14 font can spell, for an honest warning. */
     dropped: string[];
 }
-export declare function docToPdf(doc: RichDoc, settings: PdfSettings): Promise<PdfResult>;
+/**
+ * Where the fallback face comes from.
+ *
+ * A FUNCTION, and an optional one, because the font is the caller's to supply
+ * and the caller's to deliver. This package has no runtime dependencies and
+ * ships no font: a 350 KB face compiled into it would be paid for by every app
+ * that imports the package and by every document that never needed it. The app
+ * decides where the bytes live and whether they are worth fetching.
+ *
+ * ⚠️ It is called ONLY when the document actually contains something WinAnsi
+ * cannot write, so an English document never touches the network. Returning
+ * `null` — or throwing, or being offline — is a supported answer: the document
+ * comes out exactly as it did before any of this existed, with the unwritable
+ * characters as '?' and named in `dropped`.
+ */
+export type FallbackFontLoader = () => Promise<Uint8Array | null>;
+export declare function docToPdf(doc: RichDoc, settings: PdfSettings, loadFallbackFont?: FallbackFontLoader): Promise<PdfResult>;
 //# sourceMappingURL=pdf.d.ts.map

package/dist/write/pdf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../src/write/pdf.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAS,OAAO,EAAO,MAAM,aAAa,CAAA;AAMtD,OAAO,KAAK,EAAyB,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAqD1E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAID,wBAAsB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAgCtF"}
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../src/write/pdf.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAS,OAAO,EAAO,MAAM,aAAa,CAAA;AAOtD,OAAO,KAAK,EAAyB,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAqD1E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAID;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;AAyBjE,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,WAAW,EACrB,gBAAgB,CAAC,EAAE,kBAAkB,GACpC,OAAO,CAAC,SAAS,CAAC,CA6CpB"}