postext-pdf 1.14.1 → 1.15.0

package/dist/harfbuzz.js

@@ -0,0 +1,280 @@
+/**
+ * HarfBuzz from its WebAssembly binary, without the Emscripten glue
+ * (issue #380).
+ *
+ * harfbuzzjs ships `harfbuzz.wasm` with a JavaScript module that loads it,
+ * and that module works out where it runs from `process`: in Node it
+ * imports `module` to read the file. A CDN that compiles packages for the
+ * browser (esm.sh) defines a `process` of its own, so in a page that
+ * imports postext-pdf from it the glue took the Node path and threw, and
+ * every Arabic PDF fell back to fontkit, its marks unplaced.
+ *
+ * The binary needs very little from its host: five imports (a heap that
+ * grows, an abort, a timer and an exit Emscripten never calls for
+ * shaping), and the static constructors run once. This module provides
+ * them and binds the dozen `hb_*` functions postext-pdf shapes with, so
+ * HarfBuzz loads the same way in Node, a page, a Worker and a bundle.
+ *
+ * The binary is taken from, in order: the source the caller gave
+ * (`RenderToPdfOptions.harfbuzzWasm`); `harfbuzz.wasm` beside this module
+ * (the build copies it into `dist`; a bundler sees the literal
+ * `new URL(…, import.meta.url)` and emits it as an asset; Node reads the
+ * file); in the source tree, the harfbuzzjs package itself; and, for a
+ * page whose CDN rebuilt the module somewhere else (esm.sh puts it under
+ * `/es2022/`, where no `.wasm` sits beside it), the same harfbuzzjs
+ * release from jsDelivr, then from esm.sh.
+ */
+/** The harfbuzzjs release whose `harfbuzz.wasm` this binding is written
+ *  for, and fetched from a CDN when no copy sits beside the module. A test
+ *  keeps it equal to the installed package. */
+export const HARFBUZZ_VERSION = '1.6.2';
+// hb-common.h, hb-buffer.h, hb-blob.h.
+const HB_DIRECTION_LTR = 4;
+const HB_DIRECTION_RTL = 5;
+const HB_BUFFER_CLUSTER_LEVEL_MONOTONE_GRAPHEMES = 0;
+const HB_MEMORY_MODE_READONLY = 1;
+/** `hb_feature_t`: tag, value, start, end, four `uint32`. */
+const FEATURE_BYTES = 16;
+const FEATURE_GLOBAL_END = 0xffffffff;
+/** `hb_glyph_info_t` and `hb_glyph_position_t` are five 32-bit words each. */
+const GLYPH_WORDS = 5;
+/** The heap's ceiling, as Emscripten built it (`getHeapMax`). */
+const HEAP_MAX = 2 ** 31;
+const WASM_PAGE = 65536;
+function hbTag(tag) {
+    return ((tag.charCodeAt(0) & 0xff) << 24 | (tag.charCodeAt(1) & 0xff) << 16 | (tag.charCodeAt(2) & 0xff) << 8 | (tag.charCodeAt(3) & 0xff)) >>> 0;
+}
+/** A running HarfBuzz: one WebAssembly instance and one shaping buffer. */
+export class HarfBuzz {
+    hb;
+    buffer;
+    /** Frees a face's memory once the font file it was made from is
+     *  collected (the caller keys faces by the file's bytes). */
+    faces = new FinalizationRegistry((f) => {
+        this.hb.hb_font_destroy(f.font);
+        this.hb.hb_face_destroy(f.face);
+        this.hb.free(f.data);
+    });
+    constructor(hb) {
+        this.hb = hb;
+        this.buffer = hb.hb_buffer_create();
+    }
+    /** The heap as bytes. A fresh view each time: growing the memory
+     *  detaches the old one. */
+    get u8() {
+        return new Uint8Array(this.hb.memory.buffer);
+    }
+    /** Copy `str` (ASCII: a script or language tag) into the heap, NUL
+     *  terminated; the caller frees it. */
+    ascii(str) {
+        const ptr = this.hb.malloc(str.length + 1);
+        const u8 = this.u8;
+        for (let i = 0; i < str.length; i++)
+            u8[ptr + i] = str.charCodeAt(i) & 0x7f;
+        u8[ptr + str.length] = 0;
+        return ptr;
+    }
+    /**
+     * A face for the font file `bytes` (its first face). The bytes are
+     * copied into the heap and freed, with the face, when `owner` (the
+     * caller's handle for this face) is collected.
+     */
+    openFont(bytes, owner) {
+        const hb = this.hb;
+        const data = hb.malloc(bytes.byteLength);
+        this.u8.set(bytes, data);
+        // Read-only: HarfBuzz copies a table it must patch, and never frees
+        // the data (no destroy callback); the registry does.
+        const blob = hb.hb_blob_create(data, bytes.byteLength, HB_MEMORY_MODE_READONLY, 0, 0);
+        const face = hb.hb_face_create(blob, 0);
+        hb.hb_blob_destroy(blob);
+        const font = hb.hb_font_create(face);
+        const handle = { font, upem: hb.hb_face_get_upem(face) };
+        this.faces.register(owner, { data, face, font });
+        return handle;
+    }
+    /** Shape `text` (one bidi run) with `font`. Glyphs in visual order;
+     *  clusters are UTF-16 offsets, a letter and its marks one cluster. */
+    shape(font, text, request) {
+        const hb = this.hb;
+        const buf = this.buffer;
+        hb.hb_buffer_reset(buf);
+        hb.hb_buffer_set_cluster_level(buf, HB_BUFFER_CLUSTER_LEVEL_MONOTONE_GRAPHEMES);
+        const textPtr = hb.malloc(text.length * 2 || 2);
+        const u16 = new Uint16Array(hb.memory.buffer, textPtr, text.length);
+        for (let i = 0; i < text.length; i++)
+            u16[i] = text.charCodeAt(i);
+        hb.hb_buffer_add_utf16(buf, textPtr, text.length, 0, text.length);
+        hb.free(textPtr);
+        hb.hb_buffer_guess_segment_properties(buf);
+        hb.hb_buffer_set_direction(buf, request.direction === 'rtl' ? HB_DIRECTION_RTL : HB_DIRECTION_LTR);
+        if (request.script) {
+            const s = this.ascii(request.script);
+            hb.hb_buffer_set_script(buf, hb.hb_script_from_string(s, -1));
+            hb.free(s);
+        }
+        if (request.language) {
+            const s = this.ascii(request.language);
+            hb.hb_buffer_set_language(buf, hb.hb_language_from_string(s, -1));
+            hb.free(s);
+        }
+        const features = request.features ?? [];
+        let featuresPtr = 0;
+        if (features.length > 0) {
+            featuresPtr = hb.malloc(features.length * FEATURE_BYTES);
+            const words = new Uint32Array(hb.memory.buffer, featuresPtr, features.length * 4);
+            features.forEach(([tag, value], i) => {
+                words[i * 4] = hbTag(tag);
+                words[i * 4 + 1] = value >>> 0;
+                words[i * 4 + 2] = 0;
+                words[i * 4 + 3] = FEATURE_GLOBAL_END;
+            });
+        }
+        hb.hb_shape(font.font, buf, featuresPtr, features.length);
+        if (featuresPtr)
+            hb.free(featuresPtr);
+        const n = hb.hb_buffer_get_length(buf);
+        const infos = hb.hb_buffer_get_glyph_infos(buf, 0) >>> 2;
+        const positions = hb.hb_buffer_get_glyph_positions(buf, 0) >>> 2;
+        const u32 = new Uint32Array(hb.memory.buffer);
+        const i32 = new Int32Array(hb.memory.buffer);
+        const glyphs = new Array(n);
+        for (let i = 0; i < n; i++) {
+            const info = infos + i * GLYPH_WORDS;
+            const pos = positions + i * GLYPH_WORDS;
+            glyphs[i] = {
+                gid: u32[info],
+                cluster: u32[info + 2],
+                xAdvance: i32[pos],
+                yAdvance: i32[pos + 1],
+                xOffset: i32[pos + 2],
+                yOffset: i32[pos + 3],
+            };
+        }
+        return glyphs;
+    }
+}
+/** Instantiate HarfBuzz from its binary. */
+export async function instantiateHarfBuzz(wasm) {
+    // The heap is the module's own export, known once it is instantiated.
+    const heap = {};
+    const abort = (what) => {
+        throw new WebAssembly.RuntimeError(`HarfBuzz aborted (${what})`);
+    };
+    const imports = {
+        env: {
+            _abort_js: () => abort('abort'),
+            // Emscripten's event loop: nothing here keeps it alive or sets a
+            // timer (`alarm`, `setitimer`), and shaping never asks for one.
+            _emscripten_runtime_keepalive_clear: () => { },
+            _setitimer_js: () => 0,
+            // Grow the heap to hold `requested` bytes: double it, as Emscripten
+            // does, up to its ceiling. 1 on success, 0 when it cannot.
+            emscripten_resize_heap: (requested) => {
+                const mem = heap.memory;
+                const old = mem.buffer.byteLength;
+                requested >>>= 0;
+                if (requested > HEAP_MAX)
+                    return 0;
+                const target = Math.min(HEAP_MAX, Math.max(requested, old * 2));
+                try {
+                    mem.grow(Math.ceil((target - old) / WASM_PAGE));
+                    return 1;
+                }
+                catch {
+                    try {
+                        mem.grow(Math.ceil((requested - old) / WASM_PAGE));
+                        return 1;
+                    }
+                    catch {
+                        return 0;
+                    }
+                }
+            },
+        },
+        wasi_snapshot_preview1: {
+            proc_exit: (code) => abort(`exit ${code}`),
+        },
+    };
+    const { instance } = await WebAssembly.instantiate(wasm, imports);
+    const hb = instance.exports;
+    heap.memory = hb.memory;
+    hb.__wasm_call_ctors();
+    return new HarfBuzz(hb);
+}
+/** The literal, so a bundler emits the binary beside the chunk. */
+function besideThisModule() {
+    return new URL('./harfbuzz.wasm', import.meta.url);
+}
+/** Whether `bytes` start as a WebAssembly module (`\0asm`): a server that
+ *  answers a missing file with a page must not reach `instantiate`. */
+function isWasm(bytes) {
+    return bytes.length > 8 && bytes[0] === 0 && bytes[1] === 0x61 && bytes[2] === 0x73 && bytes[3] === 0x6d;
+}
+/** Read a `file:` URL. `node:fs` is named through a variable, so a
+ *  bundler or a CDN leaves it alone, and only a host that runs from files
+ *  (Node, Deno, Bun) ever imports it. */
+async function readFileUrl(url) {
+    const fsModule = 'node:fs/promises';
+    const fs = (await import(/* webpackIgnore: true */ /* turbopackIgnore: true */ /* @vite-ignore */ fsModule));
+    return new Uint8Array(await fs.readFile(url));
+}
+async function fetchBytes(url) {
+    if (url.protocol === 'file:')
+        return readFileUrl(url);
+    const response = await fetch(url);
+    if (!response.ok)
+        throw new Error(`HTTP ${response.status}`);
+    return new Uint8Array(await response.arrayBuffer());
+}
+/** What a relative `source` resolves against: the page's (or worker's)
+ *  location, as a `fetch` would; this module's URL where there is none. */
+export function sourceBase() {
+    return globalThis.location?.href ?? import.meta.url;
+}
+/** The places the binary is looked for when the caller gave none. */
+function defaultLocations() {
+    const beside = besideThisModule();
+    if (beside.protocol === 'file:') {
+        // From `src` (tests) or a `dist` built without the copy: the package
+        // this binding is written against. Resolved against `beside`, not
+        // `import.meta.url`, so no bundler takes it for an asset to emit.
+        return [beside, new URL('../node_modules/harfbuzzjs/dist/harfbuzz.wasm', beside)];
+    }
+    return [
+        beside,
+        new URL(`https://cdn.jsdelivr.net/npm/harfbuzzjs@${HARFBUZZ_VERSION}/dist/harfbuzz.wasm`),
+        new URL(`https://esm.sh/harfbuzzjs@${HARFBUZZ_VERSION}/dist/harfbuzz.wasm`),
+    ];
+}
+/**
+ * Load HarfBuzz from `source`, or from the default locations in turn.
+ * Rejects with every place tried and why it failed.
+ */
+export async function loadHarfBuzz(source) {
+    if (source !== undefined && typeof source !== 'string' && !(source instanceof URL)) {
+        const bytes = ArrayBuffer.isView(source)
+            ? new Uint8Array(source.buffer, source.byteOffset, source.byteLength)
+            : new Uint8Array(source);
+        return instantiateHarfBuzz(bytes);
+    }
+    const locations = source !== undefined ? [new URL(source, sourceBase())] : defaultLocations();
+    const failures = [];
+    for (const url of locations) {
+        let bytes;
+        try {
+            bytes = await fetchBytes(url);
+        }
+        catch (err) {
+            failures.push(`${url.href}: ${err instanceof Error ? err.message : String(err)}`);
+            continue;
+        }
+        if (!isWasm(bytes)) {
+            failures.push(`${url.href}: not a WebAssembly file`);
+            continue;
+        }
+        return instantiateHarfBuzz(bytes);
+    }
+    throw new Error(failures.join('; '));
+}
+//# sourceMappingURL=harfbuzz.js.map

package/dist/harfbuzz.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { renderToPdf } from './pdf-backend';
-export type { RenderToPdfOptions, RenderProgress, PdfFontProvider, PdfFontRequest, PdfWarning, PdfFontWarning, PdfFontFallbackWarning, PdfMissingGlyphWarning, PdfVariableFontWarning, PdfCffEmbeddedWholeWarning, ResourceBytesProvider, } from './pdf-backend';
+export type { RenderToPdfOptions, RenderProgress, PdfFontProvider, PdfFontRequest, PdfWarning, PdfFontWarning, PdfFontFallbackWarning, PdfMissingGlyphWarning, PdfVariableFontWarning, PdfCffEmbeddedWholeWarning, PdfComplexShapingWarning, ResourceBytesProvider, } from './pdf-backend';
 export { decompressWoff2 } from './woff2';
+export type { HarfBuzzWasmSource } from './harfbuzz';
 export { svgToVectorDrawing, type VectorDrawing } from './pdf-backend/svgVector';
 export { sniffBytes, rasterizeSvgWithDom, type SvgRasterizer } from './pdf-backend/renderResourceBlock';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAc5C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAsB,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAsB,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAe5C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAsB,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAsB,MAAM,mCAAmC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"blockRender.d.ts","sourceRoot":"","sources":["../../src/pdf-backend/blockRender.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAuC,MAAM,SAAS,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAkN,MAAM,cAAc,CAAC;AAI5P,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAA8B,MAAM,SAAS,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AA+eD,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,WAAW,CAAC,EAAE,qBAAqB,GAClC,IAAI,CAoEN"}
+{"version":3,"file":"blockRender.d.ts","sourceRoot":"","sources":["../../src/pdf-backend/blockRender.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAuC,MAAM,SAAS,CAAC;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAiO,MAAM,cAAc,CAAC;AAI3Q,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAA8B,MAAM,SAAS,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOrD,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAwjBD,wBAAgB,WAAW,CACzB,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,WAAW,CAAC,EAAE,qBAAqB,GAClC,IAAI,CAoEN"}

package/dist/pdf-backend/blockRender.js

@@ -1,7 +1,7 @@
 import { popGraphicsState, pushGraphicsState } from 'pdf-lib';
-import { segmentOrientation } from 'postext';
+import { lineTextAlign, segmentOrientation } from 'postext';
 import { parseFontString } from '../fontString';
-import { alphaOf, alphaStateOp, beginActualTextSpan, cjkLineText, compressedMarkSpacingPx, drawLinePx, drawMeasuredTextPx, drawSwatchPx, drawTextPx, colorFromHex, endActualTextSpan, setTrackingPx } from './primitives';
+import { alphaOf, alphaStateOp, beginActualTextSpan, counterFlipPx, cjkLineText, compressedMarkSpacingPx, drawLinePx, drawMeasuredTextPx, drawSwatchPx, drawTextPx, colorFromHex, endActualTextSpan, setTrackingPx } from './primitives';
 import { paintChip } from './chip';
 import { pickSegmentColor, pickSegmentFont } from './fontHelpers';
 import { renderHeaderFooterSlot } from './headerFooter';
@@ -10,6 +10,9 @@ import { RefRun, refTarget, UriRuns } from './links';
 import { tagArtifact, tagContent } from './tagging';
 import { paintLineMarks, paintRuby, paintWarichu } from './annotations';
 import { inkScaleOperators } from './inkScale';
+import { drawShapedTextPx, drawStyledWordPx } from './shapedText';
+import { segmentLanguages, segmentOffsets, wordParts } from './directedLine';
+import { needsComplexShaping } from '../complexShaping';
 /** The link destination of a footnote of the document being drawn
  *  (`LinkRegistry.documentIndex`: note ids repeat from chapter to chapter).
  *  A key no resource id takes: it opens with a NUL. */
@@ -24,6 +27,10 @@ function renderMathRender(ctx, render, topLeftXPx, topLeftYPx, fallbackColor) {
     const S = pxPerVb * pxToPt;
     const x = topLeftXPx * pxToPt - render.viewBox.minX * S;
     const y = pageHeightPt - topLeftYPx * pxToPt + render.viewBox.minY * S;
+    // A formula on a mirrored page reads unmirrored in its box.
+    counterFlipPx(ctx, topLeftXPx, render.widthPx, () => paintMathPaths(ctx, render, x, y, S, fallbackColor));
+}
+function paintMathPaths(ctx, render, x, y, S, fallbackColor) {
     for (const path of render.paths) {
         // MathJax fills are `currentColor` or a hex; an unpainted path (`none`,
         // as a stroke-only rule leaves after flattening) draws nothing, and any
@@ -99,6 +106,21 @@ function paintComposedText(ctx, seg, x, baseline, font, size, color, colorHex, a
  * `/ActualText`. Any other line was set word by word and carries none of
  * them: its segments are painted as every line was before the CJK
  * features, with no further look at each one.
+ *
+ * A line that carries directions ({@link isDirected}: a right-to-left run
+ * on it) is laid out in `line.order`, left to right on the sheet (flow
+ * order on a mirrored page), each right-to-left segment shaped as one run
+ * by HarfBuzz (`shapedText.ts`), its glyphs shown in visual order, as every
+ * right-to-left PDF shows them. The segments are then painted, and tagged,
+ * in logical order, each at the place `order` gave it: the content stream,
+ * the marked-content sequences and the structure tree read the line as it
+ * was written, and readers that order text by position (Poppler) place it
+ * by its glyphs. A run of such a line in another language than the
+ * document's ({@link segmentLanguages}) is a `Span` with its own `/Lang`.
+ *
+ * A word set in several styles (`VDTLineSegment.runs`, a bold letter in an
+ * Arabic word) is shaped whole and each glyph painted in its run's style
+ * (`drawStyledWordPx`).
  */
 function renderSegments(ctx, segments, startX, baseline, line, block, blockFont, blockSize, blockColor, fontCache, linkRegistry, elem, justifiedSpaceWidth, 
 /** The character spacing the line is painted with (block + line, px);
@@ -109,6 +131,24 @@ tracking = 0) {
     const uris = new UriRuns(ctx, line, linkRegistry, elem);
     const repeatedAt = repeatedHyphenSegment(line, segments);
     const composed = line.cjkComposed === true || ctx.vertical !== undefined;
+    const directed = isDirected(line);
+    // The order segments are laid out in, left to right (by default
+    // theirs), and the x it gives each: they are painted in logical order.
+    const order = directed && line.order && line.order.length === segments.length ? line.order : undefined;
+    const xs = order ? segmentOffsets(segments, order, startX, (seg) => (seg.kind === 'space' ? (composed && seg.autospace ? seg.width : justifiedSpaceWidth ?? seg.width) : seg.width)) : undefined;
+    // Runs in another language than the document's (tagged render only).
+    const langs = elem && directed ? segmentLanguages(segments, elem.tree.options.lang) : undefined;
+    let langSpan;
+    const textElemOf = (i) => {
+        const lang = langs?.[i];
+        if (!lang) {
+            langSpan = undefined;
+            return elem;
+        }
+        if (langSpan?.lang !== lang)
+            langSpan = { lang, elem: elem.child('Span', { lang }) };
+        return langSpan.elem;
+    };
     // A composed CJK line (spread characters, Han–Latin spaces) reads as
     // written, not with the gaps between its pieces.
     // A vertical line is painted in runs and cells down the column: it reads
@@ -129,11 +169,16 @@ tracking = 0) {
     }
     for (let i = 0; i < segments.length; i++) {
         const seg = segments[i];
+        if (xs)
+            x = xs[i];
+        const textElem = langs ? textElemOf(i) : elem;
         if (seg.kind === 'space') {
             const inLink = uris.space(seg.text);
             if (ctx.tags && seg.text) {
-                tagContent(ctx, inLink ?? elem);
-                drawTextPx(ctx, seg.text, x, baseline, blockFont, blockSize, blockColor);
+                tagContent(ctx, inLink ?? textElem);
+                // The gap of a poem's bayt holds the tab of its plain text (#378),
+                // which no face draws: it reads as a space.
+                drawTextPx(ctx, seg.text.replace(/\t/g, ' '), x, baseline, blockFont, blockSize, blockColor);
             }
             // A Han–Latin space keeps the width the composer set.
             x += composed && seg.autospace ? seg.width : justifiedSpaceWidth ?? seg.width;
@@ -189,16 +234,24 @@ tracking = 0) {
         // A footnote marker links to its note, like a `:ref` to its resource
         // and a cross-reference to its anchor (#264).
         const target = refTarget(seg) ?? (seg.footnoteId !== undefined ? footnoteDestination(linkRegistry, seg.footnoteId) : undefined);
-        const link = refRun.enter(seg, x, elem, target);
+        const link = refRun.enter(seg, x, textElem, target, seg.width);
         // A page number of the index links to its page.
         const pageElem = seg.pageLink !== undefined && elem && !link ? elem.child('Link') : undefined;
         // A ruby base is the `RB` of a `Ruby` whose `RT` holds its reading (#194).
-        const holder = link ?? pageElem ?? uriElem ?? elem;
+        const holder = link ?? pageElem ?? uriElem ?? textElem;
         const rubyElem = composed && seg.ruby && holder ? holder.child('Ruby') : undefined;
         tagContent(ctx, rubyElem ? rubyElem.child('RB') : holder);
         // The hyphen repeated from the line before is painted but not read.
         const actualText = i === repeatedAt ? seg.text.slice(1) : undefined;
-        if (!composed)
+        // On a line with directions each segment is one run: HarfBuzz shapes a
+        // right-to-left one (and any complex text), and a word set in several
+        // styles. The kashidas justification inserted are painted, not read.
+        const shaped = (seg.runs !== undefined || (directed && (seg.rtl || needsComplexShaping(seg.text))))
+            && paintShapedSegment(ctx, seg, x, baseline + (seg.baselineShift ?? 0), font, size, color, block, fontCache, actualText, kashidaOf(seg, line));
+        if (shaped) {
+            // Painted by HarfBuzz.
+        }
+        else if (!composed)
             drawTextPx(ctx, seg.text, x, baseline + (seg.baselineShift ?? 0), font, size, color, undefined, actualText);
         else
             paintComposedText(ctx, seg, x, baseline, font, size, color, colorHex, actualText, tracking, fontCache, blockFont, rubyElem);
@@ -209,8 +262,8 @@ tracking = 0) {
         const ref = refRun.leave(seg, segments[i + 1], target);
         if (ref && linkRegistry) {
             const { scale, pageHeightPt } = ctx;
-            const x1 = ref.startX * scale;
-            const x2 = (x + seg.width) * scale;
+            const x1 = ref.left * scale;
+            const x2 = Math.max(ref.right, x + seg.width) * scale;
             const y2 = pageHeightPt - line.bbox.y * scale;
             const y1 = pageHeightPt - (line.bbox.y + line.bbox.height) * scale;
             linkRegistry.addLink(ctx.page, sheetRect(ctx, [x1, y1, x2, y2]), ref.resourceId, link ? { elem: link, contents: ref.text } : undefined);
@@ -221,6 +274,18 @@ tracking = 0) {
     if (lineState)
         endActualTextSpan(ctx, lineState);
 }
+/**
+ * Paint a segment HarfBuzz shapes: a word set in several styles
+ * (`runs`), each glyph in its run's face and colour, else the segment as
+ * one run in its direction. False when HarfBuzz is not loaded: the caller
+ * paints it the fontkit way.
+ */
+function paintShapedSegment(ctx, seg, x, baseline, font, size, color, block, fontCache, actualText, hideTatweel) {
+    const direction = seg.rtl ? 'rtl' : 'ltr';
+    if (seg.runs && drawStyledWordPx(ctx, seg.text, x, baseline, font, size, color, wordParts(seg, font, color, ctx, (bold, italic) => ({ font: fontCache.get(pickSegmentFont(bold, italic, block)) ?? undefined, color: colorFromHex(pickSegmentColor(bold, italic, block), ctx.colorSpace) })), { direction, actualText, hideTatweel }))
+        return true;
+    return drawShapedTextPx(ctx, seg.text, x, baseline, font, size, color, { direction, actualText, hideTatweel });
+}
 /** Tracking: the block (column balancing; negative for a runt set short)
  *  and the line (justification tracking) were measured with extra advance
  *  after every glyph, so paint the line with the matching character
@@ -257,8 +322,15 @@ function renderLineText(ctx, line, block, columnWidth, columnX, fontCache, linkR
         return;
     const blockSize = parseFontString(block.fontString)?.sizePx ?? 0;
     const blockColor = colorFromHex(block.color, ctx.colorSpace);
-    const lineIndent = line.bbox.x - columnX;
-    const effectiveWidth = columnWidth - lineIndent;
+    // A line whose block runs against its frame (a right-to-left paragraph
+    // on a left-to-right page, an English quotation in an Arabic book)
+    // carries its span (`measure`): it is justified across it and set ragged
+    // from its start side, the right, as the canvas sets it.
+    const span = line.measure;
+    const lineX = span ? span.x : line.bbox.x;
+    const align = lineTextAlign(line, block.textAlign);
+    const lineIndent = lineX - columnX;
+    const effectiveWidth = span ? span.width : columnWidth - lineIndent;
     const segments = line.segments;
     // Only a line of the CJK composer (or down a vertical page) has hung
     // marks and Han–Latin spaces (see `renderSegments`).
@@ -284,18 +356,18 @@ function renderLineText(ctx, line, block, columnWidth, columnX, fontCache, linkR
         }
         if (spaceCount > 0 && ((!line.isLastLine && !line.ragged) || naturalWidth > effectiveWidth)) {
             const justifiedSpaceWidth = (effectiveWidth - wordWidth) / spaceCount;
-            renderSegments(ctx, segments, line.bbox.x, line.baseline, line, block, blockFont, blockSize, blockColor, fontCache, linkRegistry, elem, justifiedSpaceWidth, tracking);
+            renderSegments(ctx, segments, lineX, line.baseline, line, block, blockFont, blockSize, blockColor, fontCache, linkRegistry, elem, justifiedSpaceWidth, tracking);
             return;
         }
     }
-    if ((block.textAlign === 'center' || block.textAlign === 'right') && segments) {
+    if ((align === 'center' || align === 'right') && segments) {
         // Hung marks stay out of the alignment, as trailing tracking does.
         let contentWidth = 0;
         for (const seg of segments)
             if (!(composed && seg.hangs))
                 contentWidth += seg.width;
         const slack = Math.max(0, effectiveWidth - (contentWidth - trailing));
-        const startX = line.bbox.x + (block.textAlign === 'center' ? slack / 2 : slack);
+        const startX = lineX + (align === 'center' ? slack / 2 : slack);
         renderSegments(ctx, segments, startX, line.baseline, line, block, blockFont, blockSize, blockColor, fontCache, linkRegistry, elem, undefined, tracking);
         return;
     }
@@ -303,29 +375,35 @@ function renderLineText(ctx, line, block, columnWidth, columnX, fontCache, linkR
     // blocks. Segments are needed when any of them styles differently from the
     // block (bold/italic/math/ref/own font or colour); otherwise one text
     // object paints the line.
-    if (segments && segments.some(composed ? composedSegmentIsStyled : segmentIsStyled)) {
-        renderSegments(ctx, segments, line.bbox.x, line.baseline, line, block, blockFont, blockSize, blockColor, fontCache, linkRegistry, elem, undefined, tracking);
+    if (segments && (isDirected(line) || segments.some(composed ? composedSegmentIsStyled : segmentIsStyled))) {
+        renderSegments(ctx, segments, lineX, line.baseline, line, block, blockFont, blockSize, blockColor, fontCache, linkRegistry, elem, undefined, tracking);
         return;
     }
     tagContent(ctx, elem);
     const plainSlack = Math.max(0, effectiveWidth - (line.bbox.width - trailing));
-    const plainX = line.bbox.x + (block.textAlign === 'right' ? plainSlack : block.textAlign === 'center' ? plainSlack / 2 : 0);
+    const plainX = lineX + (align === 'right' ? plainSlack : align === 'center' ? plainSlack / 2 : 0);
     // Each word where the layout measured it (EF-137): the embedded face's
     // own widths could differ, most of all for a character it has no glyph
-    // for, and would carry the rest of the line along. A line with
-    // right-to-left letters stays one run, which the shaper turns around.
+    // for, and would carry the rest of the line along.
     // The hyphen repeated from the line before is painted but not read.
     const actualText = line.repeatedHyphen && line.text.startsWith('-') ? line.text.slice(1) : undefined;
-    if (segments && segments.length > 0 && !hasRightToLeft(line.text)
+    // A line with right-to-left or joining letters and no directions (a VDT
+    // from before the engine resolved bidi levels) is set as one text, cut
+    // into bidi runs and shaped by HarfBuzz; with fontkit when HarfBuzz is
+    // not loaded, which turns the whole line around.
+    const complex = needsComplexShaping(line.text);
+    if (segments && segments.length > 0 && !complex
         && drawMeasuredTextPx(ctx, withLineEndSpace(segments, line.text), plainX, line.baseline, blockFont, blockSize, blockColor, tracking, actualText))
         return;
+    if (complex && drawShapedTextPx(ctx, line.text, plainX, line.baseline, blockFont, blockSize, blockColor, { base: block.direction, actualText }))
+        return;
     drawTextPx(ctx, line.text, plainX, line.baseline, blockFont, blockSize, blockColor, undefined, actualText);
 }
 /** Whether a segment of a line set word by word paints differently from
  *  the block's plain text, or is linked; an orientation mark (`:tcy`,
  *  `:upright`, `:sideways`) keeps its segment apart. */
 function segmentIsStyled(s) {
-    return s.bold || s.italic || s.kind === 'math' || s.kind === 'swatch' || s.kind === 'chip' || s.refResourceId !== undefined || s.href !== undefined || s.pageLink !== undefined || s.fontString !== undefined || s.color !== undefined || s.baselineShift !== undefined
+    return s.bold || s.italic || s.runs !== undefined || s.kind === 'math' || s.kind === 'swatch' || s.kind === 'chip' || s.refResourceId !== undefined || s.href !== undefined || s.pageLink !== undefined || s.fontString !== undefined || s.color !== undefined || s.baselineShift !== undefined
         || s.tcy !== undefined || s.orientation !== undefined || s.labelTab !== undefined;
 }
 /** {@link segmentIsStyled} for a line of the CJK composer or one down a
@@ -359,25 +437,11 @@ function withLineEndSpace(segments, text) {
     const rest = text.slice(shown.length);
     return /^\s+$/.test(rest) ? [...segments, { text: rest, width: 0 }] : segments;
 }
-/** Whether `text` holds a right-to-left letter: Hebrew, Arabic, Syriac,
- *  Thaana, N'Ko and the scripts after them up to U+08FF, their
- *  presentation forms, and the right-to-left blocks of the supplementary
- *  planes. */
-function hasRightToLeft(text) {
-    for (let i = 0; i < text.length; i++) {
-        const c = text.charCodeAt(i);
-        if (c < 0x0590)
-            continue;
-        if (c <= 0x08ff || (c >= 0xfb1d && c <= 0xfdff) || (c >= 0xfe70 && c <= 0xfefe))
-            return true;
-        if (c >= 0xd800 && c <= 0xdbff) {
-            const cp = text.codePointAt(i);
-            if ((cp >= 0x10800 && cp <= 0x10fff) || (cp >= 0x1e800 && cp <= 0x1efff))
-                return true;
-            i++;
-        }
-    }
-    return false;
+/** Whether a line carries the engine's directions: an order to paint its
+ *  segments in, or a right-to-left segment. Absent on every left-to-right
+ *  line, which is painted as it always was. */
+function isDirected(line) {
+    return line.order !== undefined || (line.segments?.some((s) => s.rtl) ?? false);
 }
 function renderBullet(ctx, block, fontCache, elem) {
     if (!block.bulletText ||
@@ -503,4 +567,13 @@ export function renderBlock(ctx, block, columnWidth, columnX, fontCache, resourc
         renderStrikethrough(ctx, block);
     }
 }
+/** The tatweels of a segment its text read leaves out: the ones kashida
+ *  justification inserted (`VDTLineSegment.kashida`), so one the author
+ *  typed stays; every one on a line of a VDT that only counts them
+ *  (`VDTLine.kashida`, before the per-segment offsets). */
+function kashidaOf(seg, line) {
+    if (seg.kashida)
+        return seg.kashida.length;
+    return line.kashida !== undefined && !line.segments?.some((s) => s.kashida);
+}
 //# sourceMappingURL=blockRender.js.map