postext 1.8.5 → 1.9.0

package/dist/canvas-backend/verticalText.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Vertical text on the canvas (`VDTPage.flow`).
+ *
+ * `paintPage` paints a vertical page's flow through the page's frame — the
+ * context turned a quarter turn clockwise (`ctx.transform(0, 1, -1, 0, W,
+ * 0)`) — and switches the painter here on for as long as it does. Every
+ * text painter of the backend calls {@link fillFlowText} instead of
+ * `ctx.fillText`: on a horizontal page it IS `ctx.fillText`, with the same
+ * arguments; inside a vertical flow it cuts the text into sideways runs
+ * (Latin, numbers: painted as they are, which the frame turns sideways) and
+ * cells (Han, punctuation, dashes, upright symbols), each cell its length
+ * down the line (one em; half an em for the mainland interpunct), the
+ * character turned back to stand upright about the cell's centre on the
+ * font's central axis (`VDTFlowFrame.centralBaselines`). The runs are the
+ * ones the text was measured with (`verticalRuns`), so each segment paints
+ * within the width the layout gave it.
+ *
+ * Punctuation takes the font's vertical form (OpenType `vert`) through a
+ * twin face the host registers with {@link registerVerticalAlternates} —
+ * the same font file loaded under another family name with
+ * `featureSettings: '"vert" 1, "fwid" 1'`, which Chrome 140+ applies to
+ * canvas text. Without a twin, the fallbacks of `verticalOrientation`
+ * apply: brackets and quotes turned about the em box's centre, mainland
+ * pause and stop marks moved to the upper right of the cell (each by its
+ * glyph's `offset`). A dash, an ellipsis or a wave dash stands in the
+ * twin's vertical form when the font has one (Noto CJK's —— needs `fwid`
+ * with `vert`: a rule down the middle of the cell), else it is turned
+ * with its ink centred on the column's axis.
+ */
+import type { CjkRegion } from '../types';
+import { type ForcedOrientation } from '../writingMode';
+import { type MarkCutRule } from '../measure/markCuts';
+/** What the painter needs while a vertical flow paints. */
+export interface VerticalPaintState {
+    region: CjkRegion;
+    /** `VDTFlowFrame.centralBaselines` of the page. */
+    axes?: Record<string, number>;
+    /** `cjk.uprightDigits`: a number of at most this many digits stands in
+     *  one upright cell (as the measurer found it, `verticalRuns`). */
+    uprightDigits?: number;
+}
+/** Switch vertical painting on (a state) or off (`null`); returns the state
+ *  it replaces, for the caller to put back. */
+export declare function setVerticalPaint(state: VerticalPaintState | null): VerticalPaintState | null;
+/** Whether text painted now is set vertically. */
+export declare function verticalPaintActive(): boolean;
+/**
+ * Paint the vertical forms of `family`'s punctuation (brackets, quotes,
+ * mainland pause marks, ellipses) with `twinFamily`: the same font loaded
+ * under that name with `featureSettings: '"vert" 1'` (see
+ * {@link loadVerticalAlternates}). Hosts that load fonts themselves call
+ * this once the twin is ready; without one the painter's fallbacks apply.
+ */
+export declare function registerVerticalAlternates(family: string, twinFamily: string): void;
+/** Forget the twin of `family` (or of every family), removing the faces
+ *  {@link loadVerticalAlternates} added for it: the family's font changed
+ *  (a file uploaded again under the same name), so its twin must be loaded
+ *  again from the new sources. A load still under way for it is dropped. */
+export declare function unregisterVerticalAlternates(family?: string): void;
+/** The twin family registered for `family`, if any. */
+export declare function verticalAlternatesOf(family: string): string | undefined;
+/** The family name a twin of `family` is registered under by
+ *  {@link loadVerticalAlternates}. */
+export declare function verticalTwinName(family: string): string;
+/** One face of a family: its source (a URL or the font bytes) and
+ *  descriptors, as `new FontFace` takes them. */
+export interface VerticalAlternatesFace {
+    source: string | ArrayBuffer;
+    weight?: string;
+    style?: string;
+    unicodeRange?: string;
+}
+/** The characters a twin is loaded for (only these ever paint with it). */
+export declare const VERTICAL_ALTERNATE_SAMPLE = "\u300C\u300D\u300E\u300F\uFF08\uFF09\u300A\u300B\u3008\u3009\u3010\u3011\u3014\u3015\u3016\u3017\uFF3B\uFF3D\uFF5B\uFF5D\uFF0C\u3002\u3001\uFF1A\uFF1B\uFF01\uFF1F\u201C\u201D\u2018\u2019\u2026\uFF5E";
+/**
+ * Load a twin of `family` with its vertical forms on (`featureSettings:
+ * '"vert" 1'`) from the same sources, and register it when the browser
+ * applies the feature to canvas text — the probe draws 「（《 with both
+ * faces and compares their ink. Resolves to whether the twin is in use.
+ * Browser only; a no-op (false) elsewhere.
+ */
+export declare function loadVerticalAlternates(family: string, faces: readonly VerticalAlternatesFace[]): Promise<boolean>;
+/** How text is put on the canvas: filled, stroked (an outline), or both
+ *  (outline over the fill). */
+export type TextPaintMode = 'fill' | 'stroke' | 'fillStroke';
+/**
+ * Paint `text` from `x` on `baseline`, as `ctx.fillText` would (and
+ * `ctx.strokeText` for `mode` `'stroke'` / `'fillStroke'`). On a
+ * horizontal page it is exactly those calls, except that two CJK marks
+ * side by side that the layout measured apart are painted apart (see
+ * `putHorizontal`); `cuts` says how the layout measured the text
+ * (`MarkCutRule`: whole by default; word by word for a line of a Latin
+ * paragraph; character by character for a line of the CJK composer). In a
+ * vertical flow (see the module comment) it sets the text vertically:
+ * `tracking` (px after every character, default the context's
+ * `letterSpacing`) is added after each cell and inside each sideways run.
+ * Returns nothing; the caller advances by the width the layout measured.
+ */
+export declare function fillFlowText(ctx: CanvasRenderingContext2D, text: string, x: number, baseline: number, mode?: TextPaintMode, tracking?: number, cuts?: MarkCutRule, 
+/** The orientation the author gave the text (`VDTLineSegment.tcy` /
+ *  `orientation`); vertical text only. */
+orient?: ForcedOrientation): void;
+/**
+ * Draw an image (or anything `draw` paints in a `w` × `h` box) inside a
+ * box of the current frame: as is on a horizontal page; turned back to
+ * stand upright on a vertical one, where the box's `w` runs down the sheet
+ * and `h` across it. A box `sized` for that (`VDTDesignImageBlock.upright`:
+ * its width is the picture's height) is filled; any other box was sized
+ * for the picture's own proportions as if horizontal, which upright keep
+ * them: scaled to fit the turned box, centred in it.
+ */
+export declare function drawUprightInBox(ctx: CanvasRenderingContext2D, x: number, y: number, w: number, h: number, draw: (x: number, y: number, w: number, h: number) => void, sized?: boolean): void;
+//# sourceMappingURL=verticalText.d.ts.map

package/dist/canvas-backend/verticalText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verticalText.d.ts","sourceRoot":"","sources":["../../src/canvas-backend/verticalText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAsD,KAAK,iBAAiB,EAAsB,MAAM,gBAAgB,CAAC;AAEhI,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAInE,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B;uEACmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;+CAC+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,GAAG,kBAAkB,GAAG,IAAI,CAI5F;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAaD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAEnF;AAaD;;;4EAG4E;AAC5E,wBAAgB,4BAA4B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAQlE;AAED,uDAAuD;AACvD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED;sCACsC;AACtC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;iDACiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,2MAAsC,CAAC;AAU7E;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,sBAAsB,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA+CvH;AAmBD;+BAC+B;AAC/B,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAC;AA2C7D;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,wBAAwB,EAC7B,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,aAAsB,EAC5B,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,GAAE,WAAoB;AAC1B;0CAC0C;AAC1C,MAAM,CAAC,EAAE,iBAAiB,GACzB,IAAI,CAUN;AAiKD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,wBAAwB,EAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,EAC1D,KAAK,UAAQ,GACZ,IAAI,CAiBN"}

package/dist/canvas-backend/verticalText.js

@@ -0,0 +1,437 @@
+/**
+ * Vertical text on the canvas (`VDTPage.flow`).
+ *
+ * `paintPage` paints a vertical page's flow through the page's frame — the
+ * context turned a quarter turn clockwise (`ctx.transform(0, 1, -1, 0, W,
+ * 0)`) — and switches the painter here on for as long as it does. Every
+ * text painter of the backend calls {@link fillFlowText} instead of
+ * `ctx.fillText`: on a horizontal page it IS `ctx.fillText`, with the same
+ * arguments; inside a vertical flow it cuts the text into sideways runs
+ * (Latin, numbers: painted as they are, which the frame turns sideways) and
+ * cells (Han, punctuation, dashes, upright symbols), each cell its length
+ * down the line (one em; half an em for the mainland interpunct), the
+ * character turned back to stand upright about the cell's centre on the
+ * font's central axis (`VDTFlowFrame.centralBaselines`). The runs are the
+ * ones the text was measured with (`verticalRuns`), so each segment paints
+ * within the width the layout gave it.
+ *
+ * Punctuation takes the font's vertical form (OpenType `vert`) through a
+ * twin face the host registers with {@link registerVerticalAlternates} —
+ * the same font file loaded under another family name with
+ * `featureSettings: '"vert" 1, "fwid" 1'`, which Chrome 140+ applies to
+ * canvas text. Without a twin, the fallbacks of `verticalOrientation`
+ * apply: brackets and quotes turned about the em box's centre, mainland
+ * pause and stop marks moved to the upper right of the cell (each by its
+ * glyph's `offset`). A dash, an ellipsis or a wave dash stands in the
+ * twin's vertical form when the font has one (Noto CJK's —— needs `fwid`
+ * with `vert`: a rule down the middle of the cell), else it is turned
+ * with its ink centred on the column's axis.
+ */
+import { DEFAULT_CENTRAL_BASELINE } from '../vdt';
+import { forcedVerticalRuns, verticalRuns, CORNER_OFFSET_EM } from '../writingMode';
+import { graphemeCount, graphemesOf } from '../measure/graphemes';
+import { markPieces } from '../measure/markCuts';
+import { measureRunWidth } from '../measure/canvas';
+import { hasCJK } from '../measure/cjk';
+let paintState = null;
+/** Switch vertical painting on (a state) or off (`null`); returns the state
+ *  it replaces, for the caller to put back. */
+export function setVerticalPaint(state) {
+    const previous = paintState;
+    paintState = state;
+    return previous;
+}
+/** Whether text painted now is set vertically. */
+export function verticalPaintActive() {
+    return paintState !== null;
+}
+// ---------------------------------------------------------------------------
+// Vertical alternates through a twin face
+// ---------------------------------------------------------------------------
+const twins = new Map();
+/** The faces {@link loadVerticalAlternates} added for a family's twin. */
+const twinFaces = new Map();
+/** Per family, how many times its twin was loaded or dropped: a load that
+ *  another one (or an unregister) overtook while it waited is stale. */
+const twinGeneration = new Map();
+/**
+ * Paint the vertical forms of `family`'s punctuation (brackets, quotes,
+ * mainland pause marks, ellipses) with `twinFamily`: the same font loaded
+ * under that name with `featureSettings: '"vert" 1'` (see
+ * {@link loadVerticalAlternates}). Hosts that load fonts themselves call
+ * this once the twin is ready; without one the painter's fallbacks apply.
+ */
+export function registerVerticalAlternates(family, twinFamily) {
+    twins.set(family, twinFamily);
+}
+function removeFaces(faces) {
+    if (!faces || typeof document === 'undefined' || !document.fonts)
+        return;
+    for (const ff of faces) {
+        try {
+            document.fonts.delete(ff);
+        }
+        catch {
+            // Already gone.
+        }
+    }
+}
+/** Forget the twin of `family` (or of every family), removing the faces
+ *  {@link loadVerticalAlternates} added for it: the family's font changed
+ *  (a file uploaded again under the same name), so its twin must be loaded
+ *  again from the new sources. A load still under way for it is dropped. */
+export function unregisterVerticalAlternates(family) {
+    const families = family === undefined ? [...new Set([...twins.keys(), ...twinFaces.keys(), ...twinGeneration.keys()])] : [family];
+    for (const f of families) {
+        twins.delete(f);
+        removeFaces(twinFaces.get(f));
+        twinFaces.delete(f);
+        twinGeneration.set(f, (twinGeneration.get(f) ?? 0) + 1);
+    }
+}
+/** The twin family registered for `family`, if any. */
+export function verticalAlternatesOf(family) {
+    return twins.get(family);
+}
+/** The family name a twin of `family` is registered under by
+ *  {@link loadVerticalAlternates}. */
+export function verticalTwinName(family) {
+    return `${family} postext-vert`;
+}
+/** Brackets the probe compares: their vertical forms differ from the
+ *  horizontal ones in every CJK face. */
+const PROBE = '「（《';
+/** The characters a twin is loaded for (only these ever paint with it). */
+export const VERTICAL_ALTERNATE_SAMPLE = '「」『』（）《》〈〉【】〔〕〖〗［］｛｝，。、：；！？“”‘’…～';
+function inkKey(ctx, font, text) {
+    ctx.font = font;
+    const m = ctx.measureText(text);
+    return [m.actualBoundingBoxLeft, m.actualBoundingBoxRight, m.actualBoundingBoxAscent, m.actualBoundingBoxDescent]
+        .map((v) => Math.round((v ?? 0) * 10))
+        .join(',');
+}
+/**
+ * Load a twin of `family` with its vertical forms on (`featureSettings:
+ * '"vert" 1'`) from the same sources, and register it when the browser
+ * applies the feature to canvas text — the probe draws 「（《 with both
+ * faces and compares their ink. Resolves to whether the twin is in use.
+ * Browser only; a no-op (false) elsewhere.
+ */
+export async function loadVerticalAlternates(family, faces) {
+    if (typeof document === 'undefined' || !document.fonts || typeof FontFace === 'undefined' || faces.length === 0)
+        return false;
+    if (twins.has(family))
+        return true;
+    const generation = (twinGeneration.get(family) ?? 0) + 1;
+    twinGeneration.set(family, generation);
+    // A family loaded again (after `unregisterVerticalAlternates`) takes a
+    // fresh name, so no face or glyph cache of the old file answers for it.
+    const twin = generation > 1 ? `${verticalTwinName(family)} ${generation}` : verticalTwinName(family);
+    const loaded = [];
+    for (const face of faces) {
+        try {
+            const src = typeof face.source === 'string' ? `url(${JSON.stringify(face.source)})` : face.source;
+            const ff = new FontFace(twin, src, {
+                ...(face.weight ? { weight: face.weight } : {}),
+                ...(face.style ? { style: face.style } : {}),
+                ...(face.unicodeRange ? { unicodeRange: face.unicodeRange } : {}),
+                // `fwid` with `vert`: the full-width forms of dashes, whose
+                // vertical form Noto CJK keys to both; the marks the twin paints
+                // are full-width already.
+                featureSettings: '"vert" 1, "fwid" 1',
+            });
+            document.fonts.add(ff);
+            loaded.push(ff);
+        }
+        catch {
+            // A face the browser refuses: the others may still cover the marks.
+        }
+    }
+    if (loaded.length === 0)
+        return false;
+    const q = (f) => JSON.stringify(f);
+    const current = () => twinGeneration.get(family) === generation;
+    try {
+        await Promise.all([
+            document.fonts.load(`16px ${q(twin)}`, VERTICAL_ALTERNATE_SAMPLE),
+            document.fonts.load(`16px ${q(family)}`, PROBE),
+        ]);
+    }
+    catch {
+        removeFaces(loaded);
+        return false;
+    }
+    const canvas = typeof OffscreenCanvas !== 'undefined' ? new OffscreenCanvas(8, 8) : document.createElement('canvas');
+    const ctx = canvas.getContext('2d');
+    const applied = !!ctx && current() && inkKey(ctx, `100px ${q(twin)}`, PROBE) !== inkKey(ctx, `100px ${q(family)}`, PROBE);
+    if (applied) {
+        twins.set(family, twin);
+        twinFaces.set(family, loaded);
+    }
+    else
+        removeFaces(loaded);
+    return applied;
+}
+// ---------------------------------------------------------------------------
+// The painter
+// ---------------------------------------------------------------------------
+const SIZE_RE = /(\d*\.?\d+)px(\s*\/\s*[^\s]+)?\s*/;
+/** The em (px) and the first family of a CSS font shorthand. */
+function parseFont(font) {
+    const m = SIZE_RE.exec(font);
+    if (!m)
+        return { em: 16, family: font.trim(), prefix: '' };
+    const prefix = font.slice(0, m.index + m[0].length);
+    const rest = font.slice(m.index + m[0].length);
+    let first = rest.split(',')[0].trim();
+    if (first.length >= 2 && /^["']/.test(first) && first.endsWith(first[0]))
+        first = first.slice(1, -1);
+    return { em: parseFloat(m[1]), family: first, prefix };
+}
+function put(ctx, text, x, y, mode) {
+    if (mode !== 'stroke')
+        ctx.fillText(text, x, y);
+    if (mode !== 'fill')
+        ctx.strokeText(text, x, y);
+}
+/**
+ * {@link put} for horizontal text that may hold two CJK marks side by side
+ * (`）》`, `”“`, see `cjkMarkCuts`): Chrome would set the first half width
+ * in one run, where the layout may have measured each at its own advance.
+ * Such text is cut where the layout's measurer cut it (`rule`, see
+ * `markCuts`) and painted piece by piece, each piece where the one before
+ * ends as the browser sets it (`measureRunWidth`, the context's tracking
+ * and word spacing on top) — for a line of the CJK composer, where its
+ * characters are. Any other text is one call, as before.
+ */
+function putHorizontal(ctx, text, x, y, mode, rule) {
+    const pieces = markPieces(text, rule);
+    if (pieces.length === 1) {
+        put(ctx, text, x, y, mode);
+        return;
+    }
+    const font = ctx.font;
+    const spacing = parseFloat(ctx.letterSpacing) || 0;
+    const wordSpacing = parseFloat(ctx.wordSpacing ?? '') || 0;
+    const widths = pieces.map((piece) => measureRunWidth(piece, font)
+        + (spacing === 0 ? 0 : spacing * graphemeCount(piece))
+        + (wordSpacing === 0 ? 0 : wordSpacing * (piece.split(' ').length - 1)));
+    const align = ctx.textAlign;
+    let px = x;
+    if (align === 'center' || align === 'right' || align === 'end') {
+        const total = widths.reduce((a, b) => a + b, 0);
+        px -= align === 'center' ? total / 2 : total;
+        ctx.textAlign = 'left';
+    }
+    for (let i = 0; i < pieces.length; i++) {
+        put(ctx, pieces[i], px, y, mode);
+        px += widths[i];
+    }
+    if (ctx.textAlign !== align)
+        ctx.textAlign = align;
+}
+/**
+ * Paint `text` from `x` on `baseline`, as `ctx.fillText` would (and
+ * `ctx.strokeText` for `mode` `'stroke'` / `'fillStroke'`). On a
+ * horizontal page it is exactly those calls, except that two CJK marks
+ * side by side that the layout measured apart are painted apart (see
+ * `putHorizontal`); `cuts` says how the layout measured the text
+ * (`MarkCutRule`: whole by default; word by word for a line of a Latin
+ * paragraph; character by character for a line of the CJK composer). In a
+ * vertical flow (see the module comment) it sets the text vertically:
+ * `tracking` (px after every character, default the context's
+ * `letterSpacing`) is added after each cell and inside each sideways run.
+ * Returns nothing; the caller advances by the width the layout measured.
+ */
+export function fillFlowText(ctx, text, x, baseline, mode = 'fill', tracking, cuts = 'text', 
+/** The orientation the author gave the text (`VDTLineSegment.tcy` /
+ *  `orientation`); vertical text only. */
+orient) {
+    const state = paintState;
+    if (!state) {
+        // Text with no CJK is cut only under the composer's rule (see
+        // `markCuts`): one call, with no cut to look for.
+        if (cuts !== 'composed' && !hasCJK(text))
+            put(ctx, text, x, baseline, mode);
+        else
+            putHorizontal(ctx, text, x, baseline, mode, cuts);
+        return;
+    }
+    paintVertical(ctx, state, text, x, baseline, mode, tracking, orient);
+}
+function paintVertical(ctx, state, text, x, y, mode, trackingArg, orient) {
+    const font = ctx.font;
+    const { em, family, prefix } = parseFont(font);
+    const central = (state.axes?.[family] ?? DEFAULT_CENTRAL_BASELINE) * em;
+    const spacing = ctx.letterSpacing;
+    const tracking = trackingArg ?? (parseFloat(spacing) || 0);
+    // A caller centring on `middle` (a list bullet) gives the axis itself.
+    const middle = ctx.textBaseline === 'middle';
+    const axis = middle ? y : y - central;
+    const baseline = axis + central;
+    const align = ctx.textAlign;
+    if (middle)
+        ctx.textBaseline = 'alphabetic';
+    if (align !== 'left' && align !== 'start')
+        ctx.textAlign = 'left';
+    const twin = twins.get(family);
+    const twinFont = twin ? `${prefix}${JSON.stringify(twin)}` : undefined;
+    let cx = x;
+    const graphemes = graphemesOf(text);
+    const runs = orient ? forcedVerticalRuns(graphemes, orient) : verticalRuns(graphemes, state.region, state.uprightDigits ?? 0);
+    for (const run of runs) {
+        if (run.cell === undefined) {
+            // The frame turns it sideways: painted as it is, the letters tracked.
+            put(ctx, run.text, cx, baseline, mode);
+            cx += ctx.measureText(run.text).width;
+            continue;
+        }
+        if (run.glyph.orient === 'tcy') {
+            cx += paintCombined(ctx, run.text, cx, axis, em, central, mode) + tracking;
+            continue;
+        }
+        cx += paintCell(ctx, run.text, run.glyph, cx, axis, em * run.cell, em, central, mode, twinFont, tracking !== 0) + tracking;
+    }
+    if (middle)
+        ctx.textBaseline = 'middle';
+    if (align !== 'left' && align !== 'start')
+        ctx.textAlign = align;
+}
+/** Whether the twin face (`twin`, a font string) gives `char` a glyph of
+ *  its own — a vertical form — where the face (`face`) has the horizontal
+ *  one: their ink at 100 px differs. Cached per family pair. */
+const formCache = new Map();
+function twinHasForm(ctx, face, twin, char) {
+    const at100 = (font) => font.replace(SIZE_RE, '100px ');
+    const key = `${at100(face)}|${at100(twin)}|${char}`;
+    const hit = formCache.get(key);
+    if (hit !== undefined)
+        return hit;
+    const saved = ctx.font;
+    const plain = inkKey(ctx, at100(face), char);
+    const vertical = inkKey(ctx, at100(twin), char);
+    ctx.font = saved;
+    const differs = plain !== vertical;
+    formCache.set(key, differs);
+    return differs;
+}
+/** Paint one cell (`cell` px along the line: an em, or half of one)
+ *  centred on `(x + cell / 2, axis)`; returns its advance. */
+function paintCell(ctx, g, glyph, x, axis, cell, 
+/** The font's em: the glyph's own box, whole across the column even
+ *  where the cell is shorter along it. */
+em, central, mode, twinFont, tracked) {
+    const cx = x + cell / 2;
+    const spacing = tracked ? ctx.letterSpacing : undefined;
+    if (spacing !== undefined)
+        ctx.letterSpacing = '0px';
+    let kind = 'upright';
+    let char = g;
+    let face;
+    if (glyph.orient === 'rotate') {
+        // A dash, an ellipsis, a wave dash: the font's vertical form when the
+        // twin has one, else turned.
+        if (twinFont && twinHasForm(ctx, ctx.font, twinFont, g))
+            face = twinFont;
+        else
+            kind = 'rotate';
+    }
+    else if (glyph.orient === 'alternate') {
+        if (twinFont)
+            face = twinFont;
+        else {
+            kind = glyph.fallback === 'corner' ? 'corner' : 'rotate';
+            if (glyph.substitute)
+                char = glyph.substitute;
+        }
+    }
+    const baseFont = face ? ctx.font : undefined;
+    if (face)
+        ctx.font = face;
+    const w = ctx.measureText(char).width;
+    ctx.save();
+    ctx.translate(cx, axis);
+    if (kind === 'rotate') {
+        // Turned with the frame; a dash stretched to fill its cell. A bracket
+        // or a quote turns about the em box's centre, so it hugs the character
+        // it belongs to; a dash, an ellipsis, an interpunct is centred on the
+        // axis by its ink (Noto's — sits 0.27 em above the baseline, not at the
+        // em box's 0.38).
+        if (glyph.stretch && w > 0 && w < cell)
+            ctx.scale(cell / w, 1);
+        let lift = central;
+        if (glyph.orient === 'rotate') {
+            const m = ctx.measureText(char);
+            const ascent = m.actualBoundingBoxAscent;
+            const descent = m.actualBoundingBoxDescent;
+            if (Number.isFinite(ascent) && Number.isFinite(descent) && ascent + descent > 0)
+                lift = (ascent - descent) / 2;
+        }
+        put(ctx, char, -w / 2, lift, mode);
+    }
+    else {
+        // Stood upright again about the cell's centre.
+        ctx.rotate(-Math.PI / 2);
+        const offset = kind === 'corner' ? glyph.offset ?? CORNER_OFFSET_EM : undefined;
+        const dx = offset ? offset.x * em : 0;
+        const dy = offset ? offset.y * em : 0;
+        put(ctx, char, -w / 2 + dx, central + dy, mode);
+    }
+    ctx.restore();
+    if (baseFont !== undefined)
+        ctx.font = baseFont;
+    if (spacing !== undefined)
+        ctx.letterSpacing = spacing;
+    return cell;
+}
+/** Tate-chu-yoko: `text` side by side in one upright cell of one em
+ *  (`em` px along the line) centred on `(x + em / 2, axis)`, squeezed
+ *  across to the em when wider; no tracking inside. Returns the cell's
+ *  advance. */
+function paintCombined(ctx, text, x, axis, em, central, mode) {
+    const spacing = ctx.letterSpacing;
+    const tracked = spacing !== '' && spacing !== '0px';
+    if (tracked)
+        ctx.letterSpacing = '0px';
+    const w = ctx.measureText(text).width;
+    const k = w > em ? em / w : 1;
+    ctx.save();
+    ctx.translate(x + em / 2, axis);
+    ctx.rotate(-Math.PI / 2);
+    if (k !== 1)
+        ctx.scale(k, 1);
+    put(ctx, text, -w / 2, central, mode);
+    ctx.restore();
+    if (tracked)
+        ctx.letterSpacing = spacing;
+    return em;
+}
+/**
+ * Draw an image (or anything `draw` paints in a `w` × `h` box) inside a
+ * box of the current frame: as is on a horizontal page; turned back to
+ * stand upright on a vertical one, where the box's `w` runs down the sheet
+ * and `h` across it. A box `sized` for that (`VDTDesignImageBlock.upright`:
+ * its width is the picture's height) is filled; any other box was sized
+ * for the picture's own proportions as if horizontal, which upright keep
+ * them: scaled to fit the turned box, centred in it.
+ */
+export function drawUprightInBox(ctx, x, y, w, h, draw, sized = false) {
+    if (!paintState) {
+        draw(x, y, w, h);
+        return;
+    }
+    ctx.save();
+    ctx.translate(x, y + h);
+    ctx.rotate(-Math.PI / 2);
+    // The box on the sheet is `h` wide and `w` tall.
+    if (sized)
+        draw(0, 0, h, w);
+    else {
+        const k = w > 0 && h > 0 ? Math.min(h / w, w / h) : 1;
+        const dw = w * k;
+        const dh = h * k;
+        draw((h - dw) / 2, (w - dh) / 2, dw, dh);
+    }
+    ctx.restore();
+}
+//# sourceMappingURL=verticalText.js.map

package/dist/canvas-backend/verticalText.js.map

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

package/dist/chineseNumerals.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Chinese numerals, written and read: the CSS Counter Styles 3 longhand
+ * (`simp-chinese-informal` 一百二十, `trad-chinese-formal` 壹佰貳拾), the
+ * digit-by-digit `cjk-decimal` (二〇二六), the heavenly stems and earthly
+ * branches, circled and fullwidth digits — and the reverse, for part numbers
+ * an author typed (`卷三`, `第十二`, `一二〇`).
+ */
+/**
+ * `n` (a positive integer) in Chinese numerals, as CSS Counter Styles 3
+ * writes the Chinese longhand, extended past 9 999 with the group units
+ * 万/萬, 亿/億: each digit followed by its marker (十 百 千, formal 拾 佰 仟),
+ * the marker dropped after a zero, a run of zeros written 零 once, zeros at
+ * the end dropped; in the informal style 10–19 open with 十, not 一十
+ * (十二, but 一百一十). 101 一百零一, 1010 一千零一十, 10010 一万零一十.
+ * Past 10¹⁶ − 1 the number prints in digits.
+ */
+export declare function chineseNumeral(n: number, kind: 'informal' | 'formal', traditional: boolean): string;
+/** Digit by digit in Chinese numerals, with 〇 for zero: 2026 → 二〇二六
+ *  (GB/T 15835—2011 §5.2.5, as years and serial numbers are written). */
+export declare function cjkDecimal(n: number): string;
+/** Fullwidth digits: 123 → １２３. */
+export declare function fullwidthDecimal(n: number): string;
+/** Circled digits ① … ㊿ (U+2460–2473, U+3251–325F, U+32B1–32BF), ⓪ for
+ *  zero; past 50 the number prints in digits. */
+export declare function circledDecimal(n: number): string;
+/** The ten heavenly stems, 甲 to 癸. */
+export declare const CJK_HEAVENLY_STEMS: readonly string[];
+/** The twelve earthly branches, 子 to 亥. */
+export declare const CJK_EARTHLY_BRANCHES: readonly string[];
+/** The `n`th symbol of a fixed series (1-based); past its end the number
+ *  prints in digits. */
+export declare function fixedSymbol(n: number, symbols: readonly string[]): string;
+/**
+ * The value of a number written in Chinese numerals: the longhand, informal
+ * or formal, in either script (三, 十二, 一百零一, 一万零一十, 壹佰贰拾), or
+ * digit by digit (一二〇, 二〇二六). `undefined` for anything else.
+ */
+export declare function parseChineseNumeral(text: string): number | undefined;
+//# sourceMappingURL=chineseNumerals.d.ts.map

package/dist/chineseNumerals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chineseNumerals.d.ts","sourceRoot":"","sources":["../src/chineseNumerals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoCH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,CAyBnG;AAID;yEACyE;AACzE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;iDACiD;AACjD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAuD,CAAC;AACxG,2CAA2C;AAC3C,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAiE,CAAC;AAEpH;wBACwB;AACxB,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEzE;AA4DD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAapE"}