postext-pdf 1.28.0 → 1.28.2

package/dist/pdf-backend/primitives.d.ts

@@ -33,6 +33,11 @@ export interface PageCtx {
      *  vertical painter reads it, since it sets its own spacing inside its
      *  text objects. */
     trackingPx?: number;
+    /** How many spans opened with {@link beginActualTextSpan} are open:
+     *  what is painted inside one is read as the span's text, and no glyph
+     *  takes a span of its own there (#755; a reader that meets an
+     *  `/ActualText` inside another, Poppler, drops the outer one). */
+    readSpans?: number;
     /** Set while a right-to-left page's flow paints through its mirror
      *  (`VDTMirroredFlowFrame`, {@link mirrorMatrix}): every text object
      *  and picture is turned back about its own box, so it reads as written
@@ -167,8 +172,12 @@ export interface TextShow {
 }
 /** The show-text operators of `text` in `font`'s face: one
  *  ({@link showTextShaped}) for a face of one file, else one per run of
- *  characters set in the same file (see `faceFiles.ts`). */
-export declare function textShows(font: PDFFont, text: string): TextShow[];
+ *  characters set in the same file (see `faceFiles.ts`). A glyph the
+ *  font's `/ToUnicode` map reads as other text is shown in a span of its
+ *  own ({@link glyphReads}), unless `read` is false: the caller reads the
+ *  text some other way (an `/ActualText` over all of it, a figure's
+ *  alternate text). */
+export declare function textShows(font: PDFFont, text: string, read?: boolean): TextShow[];
 /** How far `text` moves the pen in `font`'s face at `sizePx`, px, with
  *  `trackingPx` after every glyph (as {@link showTextShaped} paints it,
  *  each run in the file of the face that has it); and how many glyphs it
@@ -196,12 +205,17 @@ export declare function measuredTextOperator(font: PDFFont, pieces: readonly {
  * {@link measuredTextOperator} for a face of any number of files: the
  * pieces cut into runs by file (see `faceFiles.ts`), one show-text
  * operator per stretch set in the same file. The pen carries across the
- * font switches, so every piece still starts where the layout put it.
+ * font switches, so every piece still starts where the layout put it. A
+ * glyph the font's `/ToUnicode` map reads as other text is shown in a span
+ * of its own between two of them ({@link glyphReads}).
  */
 export declare function measuredTextShows(font: PDFFont, pieces: readonly {
     text: string;
     width: number;
-}[], sizePx: number, trackingPx?: number): TextShow[] | undefined;
+}[], sizePx: number, trackingPx?: number, 
+/** False when the caller reads the text some other way: no glyph takes
+ *  a span of its own (see {@link textShows}). */
+read?: boolean): TextShow[] | undefined;
 export declare function fontKeyOn(page: PDFPage, font: PDFFont): PDFName;
 /** Outline of the glyphs a text is drawn with (a design text's `stroke`):
  *  stroked over the fill, or alone for hollow letters. */

package/dist/pdf-backend/primitives.d.ts.map

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

package/dist/pdf-backend/primitives.js

@@ -2,8 +2,9 @@ import { rgb, cmyk, grayscale, pushGraphicsState, popGraphicsState, rectangle, c
 import { colorAlpha, hexToRgb, rgbToCmyk, rgbToGrayscale } from '../colors';
 import { isPrintMode, modeKey, overPaper } from '../print/colorMode';
 import { joinsLetters, scriptContextUntracked } from 'postext';
-import { fallbackPieces } from './fallbackSpaces';
+import { fallbackPieces, isDefaultIgnorable, isSpaceCharacter } from './fallbackSpaces';
 import { fileRuns, noteMissingGlyphs } from '../faceFiles';
+import { needsComplexShaping } from '../complexShaping';
 import { shapingKey, withShapingScript } from '../shapingLanguage';
 /** Set the character spacing (`Tc`) text is painted with, px, and record
  *  it on the context. */
@@ -350,8 +351,15 @@ export function showTextShaped(font, text) {
     const hit = cache.get(key);
     if (hit)
         return hit;
-    noteMissingGlyphs(font, text);
-    const op = fallbackOperator(font, text) ?? shapedTextOperator(font, text);
+    const run = shownRun(font, text);
+    let op;
+    if (run)
+        op = partsOperator(font, plainParts(run.parts));
+    else {
+        // A standard font: no shaper, pdf-lib's own encoding.
+        noteMissingGlyphs(font, text);
+        op = showText(font.encodeText(text));
+    }
     if (cache.size >= ENCODE_CACHE_SLOTS)
         cache.clear();
     cache.set(key, op);
@@ -359,9 +367,16 @@ export function showTextShaped(font, text) {
 }
 /** The show-text operators of `text` in `font`'s face: one
  *  ({@link showTextShaped}) for a face of one file, else one per run of
- *  characters set in the same file (see `faceFiles.ts`). */
-export function textShows(font, text) {
-    return fileRuns(font, text).map((run) => ({ font: run.font, op: showTextShaped(run.font, run.text) }));
+ *  characters set in the same file (see `faceFiles.ts`). A glyph the
+ *  font's `/ToUnicode` map reads as other text is shown in a span of its
+ *  own ({@link glyphReads}), unless `read` is false: the caller reads the
+ *  text some other way (an `/ActualText` over all of it, a figure's
+ *  alternate text). */
+export function textShows(font, text, read = true) {
+    return fileRuns(font, text).flatMap((run) => {
+        const shown = read ? shownRun(run.font, run.text) : undefined;
+        return shown?.reads ? partsShows(run.font, shown.parts) : [{ font: run.font, op: showTextShaped(run.font, run.text) }];
+    });
 }
 function shapingFace(font) {
     const embedder = font.embedder;
@@ -370,22 +385,96 @@ function shapingFace(font) {
         return undefined;
     return { face, features: embedder.fontFeatures };
 }
-/** `text` shaped as one run: a `TJ` with the shaper's positions, or a plain
- *  `Tj` when it has none. */
-function shapedTextOperator(font, text) {
-    // `encodeText` also registers the glyphs with the font's subset (the ids
-    // it returns are subset ids), so it runs even when positions are added.
-    const encoded = font.encodeText(text);
-    const parts = shapedParts(font, text, encoded);
-    return parts && parts.length > 1 ? adjustedOperator(font, parts) : showText(encoded);
-}
-/** The `TJ` array (hex glyph runs and adjustments) of a shaped run, or
- *  undefined when the shaper's positions cannot be matched to its glyphs. */
-function shapedParts(font, text, encoded) {
-    return shapedRun(font, text, encoded)?.parts;
-}
-/** {@link shapedParts} with the sum of the glyphs' own widths (their `W`
- *  entries), in thousandths of the font size. */
+/**
+ * What the glyphs fontkit laid `text` out with are read as, where the
+ * font's `/ToUnicode` map reads them as other text (#755); undefined when
+ * the map reads every one as written, which is nearly always.
+ *
+ * The map is one per font, and a glyph keeps the characters it was first
+ * given (fontkit makes a glyph once, with the characters of the text that
+ * first showed it; `shapedText.ts` does the same for the glyphs HarfBuzz
+ * shows). A glyph two characters share therefore reads as the first of
+ * them the document set: the bracket a right-to-left run mirrors is the
+ * glyph of the other bracket, so after `(١)` in an Arabic note the glyph
+ * of `)` stands for `(`, and a later `(Brill, 2017)` in the same font read
+ * back `(Brill, 2017(`. A form the shaper puts in a character's place
+ * takes the characters of that character's own glyph, the wrong ones
+ * with them. The same goes for any two characters the face's cmap draws
+ * with one glyph: the hyphen-minus and the hyphen, the space and the
+ * no-break space. Such a glyph is shown in a span whose `/ActualText` is
+ * its character here, as `shapedText.ts` does for a cluster HarfBuzz
+ * shaped: the first use of a glyph costs nothing, each use for another
+ * character one span.
+ *
+ * The glyphs are walked against the text. A glyph whose own characters
+ * are the next ones of the text reads right; one with no characters (the
+ * second glyph of a decomposed letter) reads as nothing; one that holds
+ * one character, and not the next of the text, is read as that next
+ * character. Three glyphs are left as they read: `.notdef`, which stands
+ * for every character the face lacks; the space glyph fontkit hides an
+ * invisible character behind; and the space glyph, read as a space, under
+ * a no-break space or any other space the face draws with it (a space the
+ * face lacks reads as a space too, see `fallbackSpaces.ts`). The reads
+ * hold only when the walk ends where the text does (every glyph accounted
+ * for, one way or another); when it does not — a glyph for several
+ * characters that holds others, a variation selector — the run is left as
+ * it reads.
+ */
+function glyphReads(face, glyphs, text) {
+    // fontkit hands a right-to-left run's glyphs over in visual order: such
+    // text is HarfBuzz's whenever it is loaded, and is not walked here.
+    if (needsComplexShaping(text))
+        return undefined;
+    let reads;
+    let space;
+    // UTF-16 offset in `text` of the next character to read.
+    let at = 0;
+    for (let i = 0; i < glyphs.length; i++) {
+        const glyph = glyphs[i];
+        const own = glyph.codePoints;
+        if (glyph.id !== 0 && (!own || own.length === 0))
+            continue;
+        let end = at;
+        for (const cp of own ?? []) {
+            if (text.codePointAt(end) !== cp) {
+                end = -1;
+                break;
+            }
+            end += cp > 0xffff ? 2 : 1;
+        }
+        if (end > at) {
+            at = end;
+            continue;
+        }
+        const cp = text.codePointAt(at);
+        if (cp === undefined)
+            return undefined;
+        at += cp > 0xffff ? 2 : 1;
+        if (glyph.id === 0)
+            continue;
+        if (isDefaultIgnorable(cp) && glyph.id === (space ??= cmapGlyphId(face, 0x20)))
+            continue;
+        if (own.length !== 1)
+            return undefined;
+        if (own[0] === 0x20 && isSpaceCharacter(cp))
+            continue;
+        reads ??= new Array(glyphs.length);
+        reads[i] = String.fromCodePoint(cp);
+    }
+    return at === text.length ? reads : undefined;
+}
+/** The id of the glyph the face's cmap gives `cp` (0: none), read from the
+ *  cmap itself: `glyphForCodePoint` would make the glyph, with `cp` as the
+ *  characters it then keeps in the font's map. */
+function cmapGlyphId(face, cp) {
+    const cmap = face._cmapProcessor;
+    return typeof cmap?.lookup === 'function' ? cmap.lookup(cp) || 0 : 0;
+}
+/** The `TJ` array (hex glyph runs and adjustments) of a shaped run, with
+ *  the sum of the glyphs' own widths (their `W` entries), in thousandths
+ *  of the font size; undefined when the shaper's positions cannot be
+ *  matched to its glyphs. A glyph the font's map reads as other text is a
+ *  part of its own ({@link glyphReads}). */
 function shapedRun(font, text, encoded) {
     const shaping = shapingFace(font);
     if (!shaping)
@@ -396,6 +485,7 @@ function shapedRun(font, text, encoded) {
     const count = run.glyphs.length;
     if (count === 0 || hex.length !== count * 4 || run.positions.length !== count)
         return undefined;
+    const reads = glyphReads(face, run.glyphs, text);
     // TJ numbers are thousandths of text space, subtracted from the pen: a
     // glyph drawn at `pen + xOffset` then advancing by `xAdvance` (not its
     // W width `advanceWidth`) is `-xOffset, glyph, -(xAdvance - w - xOffset)`.
@@ -418,7 +508,13 @@ function shapedRun(font, text, encoded) {
             parts.push(lead);
         }
         const cid = hex.slice(i * 4, i * 4 + 4);
-        pendingHex += cid;
+        const read = reads?.[i];
+        if (read !== undefined) {
+            flushHex();
+            parts.push({ hex: cid, text: read });
+        }
+        else
+            pendingHex += cid;
         pendingAdjust = -(pos.xAdvance - run.glyphs[i].advanceWidth - pos.xOffset) * toText;
         widths += cid === '0000' && subsetFont ? MISSING_WIDTH : run.glyphs[i].advanceWidth * toText;
     }
@@ -446,10 +542,13 @@ function partsOperator(font, parts) {
     return parts.length === 1 && typeof parts[0] === 'string' ? showText(PDFHexString.of(parts[0])) : adjustedOperator(font, parts);
 }
 /** Append a part to a `TJ` array, merging it into a neighbouring glyph run
- *  or number; a zero adjustment is dropped. */
+ *  or number; a zero adjustment is dropped. A glyph read through a span
+ *  stays a part of its own. */
 function pushPart(parts, part) {
     const last = parts[parts.length - 1];
-    if (typeof part === 'number') {
+    if (typeof part === 'object')
+        parts.push(part);
+    else if (typeof part === 'number') {
         if (part === 0)
             return;
         if (typeof last === 'number')
@@ -467,16 +566,63 @@ function pushPart(parts, part) {
 function shownRunOf(parts, widths) {
     let advance = widths;
     let glyphs = 0;
+    let reads = false;
     for (const part of parts) {
         if (typeof part === 'number')
             advance -= part;
-        else
+        else if (typeof part === 'string')
             glyphs += part.length / 4;
+        else {
+            glyphs += part.hex.length / 4;
+            reads = true;
+        }
     }
-    return { parts, advance, glyphs };
+    return { parts, advance, glyphs, reads };
+}
+/** `parts` with every glyph read through the font's map: one show-text
+ *  array, as before any glyph took a span. */
+function plainParts(parts) {
+    const out = [];
+    for (const part of parts)
+        pushPart(out, typeof part === 'object' ? part.hex : part);
+    return out;
 }
-/** The parts of a text holding spaces the face has no glyph for, or
- *  invisible characters (see {@link fallbackOperator}). */
+/**
+ * The show-text operators of `parts` in `font`: one, or, around each glyph
+ * read through a span ({@link ReadGlyph}), the span's `BDC`, the glyph and
+ * its `EMC`. The glyphs and the pen adjustments are the same ones in the
+ * same order, cut into several arrays: nothing moves on the page.
+ */
+function partsShows(font, parts) {
+    const shows = [];
+    let plain = [];
+    const flush = () => {
+        if (plain.length > 0)
+            shows.push({ font, op: partsOperator(font, plain) });
+        plain = [];
+    };
+    for (const part of parts) {
+        if (typeof part !== 'object') {
+            pushPart(plain, part);
+            continue;
+        }
+        flush();
+        const props = font.doc.context.obj({ ActualText: PDFHexString.fromText(part.text) });
+        shows.push({ font, op: PDFOperator.of(PDFOperatorNames.BeginMarkedContentSequence, [PDFName.of('Span'), props]) }, { font, op: showText(PDFHexString.of(part.hex)) }, { font, op: PDFOperator.of(PDFOperatorNames.EndMarkedContent) });
+    }
+    flush();
+    if (shows.length === 0)
+        shows.push({ font, op: partsOperator(font, []) });
+    return shows;
+}
+/**
+ * The parts of a text holding a space the face has no glyph for (a narrow
+ * no-break space, a figure space…) or an invisible character (a word
+ * joiner): painted as the canvas measured it, not as `.notdef` boxes (see
+ * `fallbackSpaces.ts`). A missing space is the face's space glyph — text
+ * extraction still finds a space there — moved to the browser's advance
+ * for it; an invisible character is not drawn.
+ */
 function fallbackRun(font, face, pieces) {
     const toText = 1000 / face.unitsPerEm;
     const spaceGlyph = face.hasGlyphForCodePoint(0x20) ? face.glyphForCodePoint(0x20) : undefined;
@@ -485,7 +631,11 @@ function fallbackRun(font, face, pieces) {
     for (const piece of pieces) {
         if ('space' in piece) {
             if (spaceGlyph) {
-                pushPart(parts, font.encodeText(' ').asString());
+                // The face's space glyph, read as a space whatever the font's map
+                // gives it (a no-break space set before any space, #755).
+                const space = font.encodeText(' ');
+                for (const part of shapedRun(font, ' ', space)?.parts ?? [space.asString()])
+                    pushPart(parts, part);
                 pushPart(parts, tjNumber((spaceGlyph.advanceWidth - piece.space) * toText));
                 widths += spaceGlyph.advanceWidth * toText;
             }
@@ -502,24 +652,6 @@ function fallbackRun(font, face, pieces) {
     }
     return shownRunOf(parts, widths);
 }
-/**
- * The show-text operator of a text holding a space the face has no glyph
- * for (a narrow no-break space, a figure space…) or an invisible character
- * (a word joiner): painted as the canvas measured it, not as `.notdef`
- * boxes (see `fallbackSpaces.ts`). A missing space is the face's space
- * glyph — text extraction still finds a space there — moved to the
- * browser's advance for it; an invisible character is not drawn. Undefined
- * for text that needs none of this.
- */
-function fallbackOperator(font, text) {
-    const shaping = shapingFace(font);
-    if (!shaping)
-        return undefined;
-    const pieces = fallbackPieces(shaping.face, text);
-    if (!pieces)
-        return undefined;
-    return partsOperator(font, fallbackRun(font, shaping.face, pieces).parts);
-}
 const runsByFont = new WeakMap();
 /** `text` as {@link showTextShaped} paints it, with the advance and glyph
  *  count it leaves (cached per font). Undefined when the font carries no
@@ -590,16 +722,21 @@ const MEASURED_TOLERANCE = 0.5;
  * added after every glyph. Undefined when the font carries no shaper.
  */
 export function measuredTextOperator(font, pieces, sizePx, trackingPx = 0) {
-    const shows = measuredTextShows(font, pieces, sizePx, trackingPx);
+    const shows = measuredTextShows(font, pieces, sizePx, trackingPx, false);
     return shows && shows.length === 1 ? shows[0].op : undefined;
 }
 /**
  * {@link measuredTextOperator} for a face of any number of files: the
  * pieces cut into runs by file (see `faceFiles.ts`), one show-text
  * operator per stretch set in the same file. The pen carries across the
- * font switches, so every piece still starts where the layout put it.
+ * font switches, so every piece still starts where the layout put it. A
+ * glyph the font's `/ToUnicode` map reads as other text is shown in a span
+ * of its own between two of them ({@link glyphReads}).
  */
-export function measuredTextShows(font, pieces, sizePx, trackingPx = 0) {
+export function measuredTextShows(font, pieces, sizePx, trackingPx = 0, 
+/** False when the caller reads the text some other way: no glyph takes
+ *  a span of its own (see {@link textShows}). */
+read = true) {
     if (!(sizePx > 0))
         return undefined;
     const groups = [];
@@ -619,7 +756,7 @@ export function measuredTextShows(font, pieces, sizePx, trackingPx = 0) {
                 groups.push(group);
             }
             for (const part of run.parts)
-                pushPart(group.parts, part);
+                pushPart(group.parts, read || typeof part !== 'object' ? part : part.hex);
             advance += run.advance + run.glyphs * tracking;
         }
         ahead += advance - (piece.width / sizePx) * 1000;
@@ -635,7 +772,7 @@ export function measuredTextShows(font, pieces, sizePx, trackingPx = 0) {
     }
     if (groups.length === 0)
         groups.push({ font, parts: [] });
-    return groups.map((g) => ({ font: g.font, op: partsOperator(g.font, g.parts) }));
+    return groups.flatMap((g) => partsShows(g.font, g.parts));
 }
 const fontKeysByPage = new WeakMap();
 export function fontKeyOn(page, font) {
@@ -677,7 +814,7 @@ direction) {
         // document loaded it (`shapedText.ts`).
         if (complexPainter?.(ctx, text, xPx, baselinePx, font, sizePx, color, outline, actualText, direction))
             return;
-        pushTextObject(ctx, textShows(font, text), xPx, baselinePx, font, sizePx, color, outline, actualText);
+        pushTextObject(ctx, textShows(font, text, actualText === undefined && !ctx.readSpans), xPx, baselinePx, font, sizePx, color, outline, actualText);
     }
     finally {
         ctx.runAdvancePx = outer;
@@ -722,7 +859,7 @@ export function drawMeasuredTextPx(ctx, pieces, xPx, baselinePx, font, sizePx, c
         endActualTextSpan(ctx, { font, text: pieces[0]?.text ?? '', sizePx, xPx, baselinePx });
         return true;
     }
-    const shows = measuredTextShows(font, pieces, sizePx, trackingPx);
+    const shows = measuredTextShows(font, pieces, sizePx, trackingPx, actualText === undefined && !ctx.readSpans);
     if (!shows)
         return false;
     // Every piece starts where the layout put it: the run is as wide as the
@@ -800,6 +937,7 @@ export function withActualText(ctx, text, shows) {
  */
 export function beginActualTextSpan(ctx, text, state) {
     ctx.tags?.close();
+    ctx.readSpans = (ctx.readSpans ?? 0) + 1;
     const props = ctx.page.doc.context.obj({ ActualText: PDFHexString.fromText(text) });
     ctx.page.pushOperators(...lineTextState(ctx, state), PDFOperator.of(PDFOperatorNames.BeginMarkedContentSequence, [PDFName.of('Span'), props]));
 }
@@ -870,6 +1008,7 @@ export function compressedMarkSpacingPx(font, seg, sizePx) {
  *  state in force (see `lineTextState`). */
 export function endActualTextSpan(ctx, state) {
     ctx.tags?.close();
+    ctx.readSpans = Math.max(0, (ctx.readSpans ?? 0) - 1);
     ctx.page.pushOperators(...lineTextState(ctx, state), PDFOperator.of(PDFOperatorNames.EndMarkedContent));
 }
 export function pushClipRect(ctx, xPx, yPx, wPx, hPx) {