postext 1.47.0 → 1.48.0

package/dist/composed/labelText.js.map

@@ -1 +1 @@
-{"version":3,"file":"labelText.js","sourceRoot":"","sources":["../../src/composed/labelText.ts"],"names":[],"mappings":"AASA;;wEAEwE;AACxE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACxE,CAAC;AAED;;;;8CAI8C;AAC9C,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,MAA2D;IACpG,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC"}
+{"version":3,"file":"labelText.js","sourceRoot":"","sources":["../../src/composed/labelText.ts"],"names":[],"mappings":"AASA;;wEAEwE;AACxE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAA+B;IAC1E,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7F,CAAC;AAED;;gBAEgB;AAChB,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAA8B;IACvE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM;YAAE,SAAS;QAC7C,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtD,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;8CAI8C;AAC9C,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,MAAqE;IAC9G,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC"}

package/dist/composed/labels.d.ts

@@ -20,8 +20,8 @@
  */
 import type { InlineSpan } from '../parse/types';
 import type { FigureLabel } from '../parse/types';
-import type { Resource, ResourceAnchor, ResourceType } from '../types';
-import type { BoundingBox, ContentWarning, ResolvedConfig, ResolvedResourceBlock, VDTBlock, VDTDocument, VDTFigureLabel, VDTFigureLabelLayout, VDTLine } from '../vdt';
+import type { LeaderStyle, Resource, ResourceAnchor, ResourceType } from '../types';
+import type { BoundingBox, ContentWarning, ResolvedConfig, ResolvedResourceBlock, VDTBlock, VDTDesignBoxStyle, VDTDesignPathBlock, VDTDocument, VDTFigureLabel, VDTFigureLabelLayout, VDTPage, VDTLine } from '../vdt';
 import type { MeasurementCache } from '../measure';
 import type { ResourceNumberingMap } from '../pipeline/resourceNumbering';
 /** `[a, b, c, d, e, f]`, canvas `transform` order (y down). */
@@ -48,6 +48,19 @@ export interface LabelLook {
     minScale: number;
     /** Set in vertical writing (the label style's; an anchor's wins). */
     vertical?: boolean;
+    /** How the lines line up inside the box (#1058); absent: as the anchor
+     *  places the box. */
+    align?: 'start' | 'center' | 'end';
+    /** The plate's outline and corners (#1058). */
+    border?: {
+        color: string;
+        widthPx: number;
+    };
+    radiusPx?: number;
+    /** A map's key (#1058): rows of symbol and text. */
+    legend?: boolean;
+    /** The style's leader look (#1057), as written. */
+    leader?: LeaderStyle;
 }
 /**
  * The look of a label set in style `styleId` (the label's own `style`,
@@ -81,6 +94,14 @@ export interface FigureLabelContext {
     resources?: Resource[];
     cache?: MeasurementCache;
 }
+/**
+ * The rows of a legend (#1058) with the symbol that opens each row hung in
+ * one column: every such symbol's segment widened to the widest of them,
+ * the symbol centred in it, so the words after them start at one edge. A
+ * row with no symbol first is left as it is. The segments are copies: the
+ * measured lines may be shared with a cache.
+ */
+export declare function hangLegendSymbols(lines: readonly VDTLine[]): VDTLine[];
 /**
  * Lay out one label: its lines in its look, wrapped within `widthPx` (none:
  * one line per forced break), set smaller (down to `minScale`) while a
@@ -104,10 +125,39 @@ export declare function layOutLabel(spans: readonly InlineSpan[], look: LabelLoo
  * anchor is unknown is left without a layout.
  */
 export declare function layOutFigureLabels(labels: readonly VDTFigureLabel[], parsed: readonly Pick<FigureLabel, 'spans'>[] | undefined, rb: ResolvedResourceBlock, ctx: FigureLabelContext): VDTFigureLabel[];
+/**
+ * The leader of a drawn label (#1057) as a path in the block's frame, the
+ * body's top-left corner at (`bodyX`, `bodyY`), or undefined when it has
+ * none or its point lies under the label's box. The line leaves the box
+ * (its plate, else its lines' box, `gapPx` out) from the middle of the
+ * side facing the point (the side with the wider clear gap to it), in the
+ * label's own frame, so it never runs over the label's words, a turned
+ * label's included; an elbow leaves that side square and turns once onto
+ * the point.
+ */
+export declare function figureLabelLeaderPath(layout: VDTFigureLabelLayout, bodyX: number, bodyY: number): VDTDesignPathBlock | undefined;
+/** The leaders of a figure's drawn labels (#1057) in the block's frame,
+ *  the body's corner at (`bodyX`, `bodyY`), in the labels' order. */
+export declare function figureLabelLeaderPaths(rb: Pick<ResolvedResourceBlock, 'labels'>, bodyX: number, bodyY: number): VDTDesignPathBlock[];
+/**
+ * Where anchor `anchorId` of the picture of `block` (a figure laid on
+ * `page`) stands on the page's sheet (#1057), through the picture's crop,
+ * safe area and scale as its labels are: undefined when the block is no
+ * picture or its resource lacks the anchor. A picture is painted the right
+ * way round on a mirrored page and upright on a vertical one, so the point
+ * is read on the body's box as the sheet shows it.
+ */
+export declare function figureAnchorPointOnPage(page: Pick<VDTPage, 'flow'>, block: Pick<VDTBlock, 'bbox' | 'resourceBlock'>, anchorId: string): {
+    x: number;
+    y: number;
+} | undefined;
 /** The matrix that puts a label's frame on the block's frame, the body's
  *  top-left corner at (`bodyX`, `bodyY`): `translate(body + point) ·
  *  rotate(rotate)`. */
 export declare function figureLabelMatrix(layout: Pick<VDTFigureLabelLayout, 'x' | 'y' | 'rotate'>, bodyX: number, bodyY: number): LabelMatrix;
+/** A label's plate (#1058) as a design box's style, for the painters of
+ *  boxes: its fill, its outline drawn inside the plate, its corners. */
+export declare function labelPlateBox(plate: NonNullable<VDTFigureLabelLayout['background']>): VDTDesignBoxStyle;
 /** What a label paints in its own frame: its background, else its lines'
  *  box. */
 export declare function figureLabelExtent(layout: VDTFigureLabelLayout): BoundingBox;
@@ -183,8 +233,12 @@ export declare function labelLayoutOnSheet(layout: VDTFigureLabelLayout, bodyWid
 /** The labels of a figure that are not drawn as text: what its picture's
  *  alternative text still names (`altWithLabels`). */
 export declare function undrawnLabels(labels: readonly VDTFigureLabel[] | undefined): VDTFigureLabel[] | undefined;
-/** A drawn label's words as read, its lines joined by a space. */
+/** A drawn label's words as read, its lines joined by a space (a legend's
+ *  rows by a semicolon), each inline symbol read as its alternative text
+ *  in brackets, or not at all when it has none (#1058). */
 export declare function figureLabelReading(label: VDTFigureLabel): string;
+/** One line of a drawn label as read (see {@link figureLabelReading}). */
+export declare function figureLabelLineReading(line: VDTLine): string;
 type Pt = [number, number];
 /** How far two convex polygons run into each other: the shortest push that
  *  frees them (separating axis test), 0 when they do not meet. */

package/dist/composed/labels.d.ts.map

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

package/dist/composed/labels.js

@@ -25,7 +25,11 @@ import { resolveColorValue } from '../defaults/shared';
 import { layoutLabelLines } from '../pipeline/resourceLayout';
 import { uppercasePreservingLength } from '../pipeline/buildBlockKind';
 import { firstStrongDirection } from '../design/bidiText';
-import { BREAK_PLACEHOLDER } from '../parse/inlineFormatting';
+import { withIconAlts } from './labelText';
+import { BREAK_PLACEHOLDER, SWATCH_PLACEHOLDER } from '../parse/inlineFormatting';
+import { flowRectToPage, flowToPage } from '../vdt';
+import { capEnd, DEFAULT_CAP_SIZE_PER_WIDTH, DEFAULT_CONNECTOR_WIDTH, polylineCommands } from '../design/connector';
+import { pathInkBox } from '../design/pathBlock';
 /** The line pitch of a label, in ems, when no paragraph style lends one. */
 const LABEL_LINE_HEIGHT = 1.15;
 /** Measure of a label with no `width`: as good as unbounded. */
@@ -61,6 +65,9 @@ export function resolveLabelLook(styleId, resolved) {
         ? Math.max(0.8, (px(para.lineHeight, dpi, paraPx) ?? paraPx * LABEL_LINE_HEIGHT) / paraPx)
         : LABEL_LINE_HEIGHT;
     const haloWidth = style?.halo ? px(style.halo.width, dpi, fontPx) : undefined;
+    const borderWidth = style?.border ? px(style.border.width, dpi, fontPx) : undefined;
+    const radius = px(style?.radius, dpi, fontPx);
+    const align = style?.align === 'start' || style?.align === 'center' || style?.align === 'end' ? style.align : undefined;
     return {
         ...(style ? { styleId: style.id } : {}),
         fontFamily: style?.fontFamily ?? para?.fontFamily ?? body.fontFamily,
@@ -82,6 +89,13 @@ export function resolveLabelLook(styleId, resolved) {
         paddingPx: Math.max(0, px(style?.padding, dpi, fontPx) ?? 0),
         minScale: style ? Math.min(1, Math.max(0.1, style.minScale)) : 0.85,
         ...(style?.writingMode === 'vertical-rl' ? { vertical: true } : {}),
+        ...(align ? { align } : {}),
+        ...(style?.border && borderWidth !== undefined && borderWidth > 0
+            ? { border: { color: hexOf(style.border.color, resolved, { hex: '#000000', model: 'hex' }), widthPx: borderWidth } }
+            : {}),
+        ...(radius !== undefined && radius > 0 ? { radiusPx: radius } : {}),
+        ...(style?.kind === 'legend' ? { legend: true } : {}),
+        ...(style?.leader && typeof style.leader === 'object' ? { leader: style.leader } : {}),
     };
 }
 /** The place of `label` on `resource`; undefined when it names an anchor
@@ -116,6 +130,43 @@ const moveLine = (line, dx, dy) => ({
     baseline: line.baseline + dy,
     ...(line.measure ? { measure: { ...line.measure, x: line.measure.x + dx } } : {}),
 });
+/** The segment index of the inline symbol that opens `line` (its first
+ *  segment that is not a space), or -1. */
+function openingSymbol(line) {
+    const segs = line.segments;
+    if (!segs)
+        return -1;
+    const i = segs.findIndex((s) => s.kind !== 'space');
+    return i >= 0 && segs[i].kind === 'swatch' && segs[i].swatch?.icon ? i : -1;
+}
+/**
+ * The rows of a legend (#1058) with the symbol that opens each row hung in
+ * one column: every such symbol's segment widened to the widest of them,
+ * the symbol centred in it, so the words after them start at one edge. A
+ * row with no symbol first is left as it is. The segments are copies: the
+ * measured lines may be shared with a cache.
+ */
+export function hangLegendSymbols(lines) {
+    const at = lines.map(openingSymbol);
+    let column = 0;
+    lines.forEach((line, k) => {
+        if (at[k] >= 0)
+            column = Math.max(column, line.segments[at[k]].width);
+    });
+    return lines.map((line, k) => {
+        const i = at[k];
+        if (i < 0)
+            return line;
+        const seg = line.segments[i];
+        const extra = column - seg.width;
+        if (extra <= 1e-9)
+            return line;
+        const icon = seg.swatch.icon;
+        const segments = line.segments.slice();
+        segments[i] = { ...seg, width: column, swatch: { ...seg.swatch, icon: { ...icon, insetPx: (icon.insetPx ?? 0) + extra / 2 } } };
+        return { ...line, segments, bbox: { ...line.bbox, width: line.bbox.width + extra } };
+    });
+}
 /** A label's spans with each `\\` that ends a word made a forced line
  *  break, as in a caption: two characters for two (the break and a space
  *  the next line drops), so the source map holds. */
@@ -150,7 +201,9 @@ export function layOutLabel(spans, look, place, ctx) {
     const vertical = place.vertical ?? look.vertical ?? false;
     const region = ctx.resolved.cjk.region;
     const inMode = (fn) => (vertical ? withMeasureWritingMode('vertical-rl', fn, region) : fn());
-    const rtl = !vertical && firstStrongDirection(plain) === 'rtl';
+    // The placeholder of a swatch or an inline symbol (#1058) that opens a
+    // row is no letter: the words after it say the direction.
+    const rtl = !vertical && firstStrongDirection(plain.replaceAll(SWATCH_PLACEHOLDER, '')) === 'rtl';
     const widthPx = place.widthPx !== undefined && place.widthPx > 0 ? place.widthPx : undefined;
     const fontsAt = (sizePx) => {
         const w = look.weight === 400 ? 'normal' : String(look.weight);
@@ -205,23 +258,31 @@ export function layOutLabel(spans, look, place, ctx) {
     }
     if (set.lines.length === 0)
         return undefined;
-    const boxW = set.widest;
+    // A legend (#1058): the symbol that opens each row hangs in a column as
+    // wide as the widest.
+    const setLines = look.legend && !vertical ? hangLegendSymbols(set.lines) : set.lines;
+    const boxW = setLines === set.lines ? set.widest : setLines.reduce((m, l) => Math.max(m, l.bbox.width), 0);
     const pitch = set.sizePx * look.lineHeight;
-    const boxH = Math.max(pitch * set.lines.length, set.lines.reduce((m, l) => Math.max(m, l.bbox.y + l.bbox.height), 0));
+    const boxH = Math.max(pitch * setLines.length, setLines.reduce((m, l) => Math.max(m, l.bbox.y + l.bbox.height), 0));
     const align = place.align ?? 'center';
     // `start` is the label's own start: its left edge, its right edge right
     // to left.
-    const side = align === 'center' ? 'center' : (align === 'start') !== rtl ? 'left' : 'right';
+    const sideOf = (a) => (a === 'center' ? 'center' : (a === 'start') !== rtl ? 'left' : 'right');
+    const side = sideOf(align);
+    // The lines inside the box: the style's `align` (#1058), a legend's rows
+    // at their start, else as the box stands at its point.
+    const lineSide = look.align ? sideOf(look.align) : look.legend ? sideOf('start') : side;
     const left = side === 'center' ? -boxW / 2 : side === 'left' ? 0 : -boxW;
     const vAlign = place.verticalAlign ?? 'middle';
     const top = vAlign === 'top' ? 0 : vAlign === 'bottom' ? -boxH : -boxH / 2;
-    const lines = set.lines.map((line) => {
+    const lines = setLines.map((line) => {
         const slack = Math.max(0, boxW - line.bbox.width);
-        const dx = side === 'center' ? slack / 2 : side === 'left' ? 0 : slack;
+        const dx = lineSide === 'center' ? slack / 2 : lineSide === 'left' ? 0 : slack;
         return moveLine(line, left + dx - line.bbox.x, top);
     });
     const box = { x: left, y: top, width: boxW, height: boxH };
     const pad = look.paddingPx;
+    const plateRect = { x: left - pad, y: top - pad, width: boxW + 2 * pad, height: boxH + 2 * pad };
     // A vertical label's frame is the flow frame of a vertical page: turned
     // a quarter turn clockwise on the picture, and further by `rotate`.
     const turn = (place.rotate !== undefined && Number.isFinite(place.rotate) ? place.rotate : 0) + (vertical ? 90 : 0);
@@ -239,7 +300,17 @@ export function layOutLabel(spans, look, place, ctx) {
         boldItalicFontString: set.fonts[3],
         color: look.color,
         ...(look.halo ? { halo: { color: look.halo.color, widthPx: look.halo.widthPx * scale } } : {}),
-        ...(look.background ? { background: { color: look.background, rect: { x: left - pad, y: top - pad, width: boxW + 2 * pad, height: boxH + 2 * pad } } } : {}),
+        ...(look.background || look.border
+            ? {
+                background: {
+                    ...(look.background ? { color: look.background } : {}),
+                    rect: plateRect,
+                    ...(look.border ? { border: look.border } : {}),
+                    ...(look.radiusPx !== undefined ? { radiusPx: look.radiusPx } : {}),
+                },
+            }
+            : {}),
+        ...(look.legend && !vertical ? { legend: true } : {}),
         ...(scale < 1 - 1e-6 ? { scale } : {}),
         ...(set.cut ? { overflow: true } : {}),
         ...(look.styleId !== undefined ? { styleId: look.styleId } : {}),
@@ -288,7 +359,10 @@ export function layOutFigureLabels(labels, parsed, rb, ctx) {
         if (!place)
             return label;
         const anchor = place.anchor;
-        const at = pictureToBody(rb, place.x, place.y);
+        // Set away from its point (#1057): the box stands at `labelAt`, the
+        // point stays where a leader ends.
+        const away = anchor ? validLabelAt(anchor.labelAt) : undefined;
+        const at = pictureToBody(rb, away?.x ?? place.x, away?.y ?? place.y);
         const look = resolveLabelLook(label.style ?? anchor?.style, ctx.resolved);
         const spans = parsed?.[i]?.spans ?? [{ text: label.text, bold: false, italic: false }];
         // The anchor's writing mode wins over the style's; a vertical label's
@@ -303,9 +377,159 @@ export function layOutFigureLabels(labels, parsed, rb, ctx) {
             ...(anchor?.verticalAlign ? { verticalAlign: anchor.verticalAlign } : {}),
             ...(anchor?.rotate !== undefined ? { rotate: anchor.rotate } : {}),
         }, ctx);
-        return layout ? { ...label, layout } : label;
+        if (!layout)
+            return label;
+        const leader = anchor ? labelLeader(label, anchor, away !== undefined, look, layout, pictureToBody(rb, place.x, place.y), ctx.resolved) : undefined;
+        return { ...label, layout: leader ? { ...layout, leader } : layout };
     });
 }
+/** `labelAt` when it is a point of the picture (two finite numbers). */
+function validLabelAt(v) {
+    if (!v || typeof v !== 'object')
+        return undefined;
+    const { x, y } = v;
+    return typeof x === 'number' && typeof y === 'number' && Number.isFinite(x) && Number.isFinite(y) ? { x, y } : undefined;
+}
+const capOrNone = (v, fallback) => {
+    const c = v === 'dot' || v === 'arrow' || v === 'none' ? v : fallback;
+    return c === 'none' ? undefined : c;
+};
+/** The share of the label's type size left between its words and its
+ *  leader, when it has no plate. */
+const LEADER_GAP_EM = 0.25;
+/**
+ * The leader of a label set at `anchor` (#1057), or undefined when it has
+ * none: the label's own `leader` attribute, else the anchor's `leader`,
+ * else a label set away from its point whose style has a leader look. The
+ * look is the style's `leader` under the anchor's (an object), field by
+ * field; the colour defaults to the label's text colour, the end at the
+ * point to a dot.
+ */
+function labelLeader(label, anchor, away, look, layout, point, resolved) {
+    const own = anchor.leader;
+    const on = label.leader ?? (own === false ? false : own !== undefined && own !== null ? true : away && look.leader !== undefined);
+    if (!on)
+        return undefined;
+    const style = { ...(look.leader ?? {}), ...(own && typeof own === 'object' ? own : {}) };
+    const dpi = resolved.page.dpi;
+    const widthPx = Math.max(0, px(style.width, dpi, look.fontPx) ?? dimensionToPx(DEFAULT_CONNECTOR_WIDTH, dpi));
+    const capSizePx = Math.max(0, px(style.capSize, dpi, look.fontPx) ?? widthPx * DEFAULT_CAP_SIZE_PER_WIDTH);
+    const dash = Array.isArray(style.dash) ? style.dash.map((d) => px(d, dpi, look.fontPx)).filter((v) => v !== undefined && v >= 0) : [];
+    const color = style.color ? hexOf(style.color, resolved, { hex: look.color, model: 'hex' }) : look.color;
+    const startCap = capOrNone(style.startCap, 'none');
+    const endCap = capOrNone(style.endCap, 'dot');
+    return {
+        x: point.x,
+        y: point.y,
+        routing: style.routing === 'elbow' ? 'elbow' : 'straight',
+        stroke: { color, widthPx, ...(dash.length > 0 && dash.some((v) => v > 0) ? { dash } : {}) },
+        ...(startCap ? { startCap } : {}),
+        ...(endCap ? { endCap } : {}),
+        capSizePx,
+        gapPx: layout.background ? 0 : look.fontPx * (layout.scale ?? 1) * LEADER_GAP_EM,
+    };
+}
+/**
+ * The leader of a drawn label (#1057) as a path in the block's frame, the
+ * body's top-left corner at (`bodyX`, `bodyY`), or undefined when it has
+ * none or its point lies under the label's box. The line leaves the box
+ * (its plate, else its lines' box, `gapPx` out) from the middle of the
+ * side facing the point (the side with the wider clear gap to it), in the
+ * label's own frame, so it never runs over the label's words, a turned
+ * label's included; an elbow leaves that side square and turns once onto
+ * the point.
+ */
+export function figureLabelLeaderPath(layout, bodyX, bodyY) {
+    const leader = layout.leader;
+    if (!leader)
+        return undefined;
+    const m = figureLabelMatrix(layout, bodyX, bodyY);
+    const q = pointInLabel(layout, bodyX, bodyY, bodyX + leader.x, bodyY + leader.y);
+    const e = figureLabelExtent(layout);
+    const g = leader.gapPx;
+    const r = { x: e.x - g, y: e.y - g, width: e.width + 2 * g, height: e.height + 2 * g };
+    const down = q.y - (r.y + r.height);
+    const up = r.y - q.y;
+    const right = q.x - (r.x + r.width);
+    const left = r.x - q.x;
+    const v = Math.max(down, up);
+    const h = Math.max(right, left);
+    if (v <= 0 && h <= 0)
+        return undefined;
+    let start;
+    let bend;
+    if (v >= h) {
+        start = { x: r.x + r.width / 2, y: down >= up ? r.y + r.height : r.y };
+        bend = { x: start.x, y: q.y };
+    }
+    else {
+        start = { x: right >= left ? r.x + r.width : r.x, y: r.y + r.height / 2 };
+        bend = { x: q.x, y: start.y };
+    }
+    const own = leader.routing === 'elbow' ? [start, bend, { x: q.x, y: q.y }] : [start, { x: q.x, y: q.y }];
+    const pts = own.map((p) => ({ x: m[0] * p.x + m[2] * p.y + m[4], y: m[1] * p.x + m[3] * p.y + m[5] }));
+    const length = pts.slice(1).reduce((sum, p, i) => sum + Math.hypot(p.x - pts[i].x, p.y - pts[i].y), 0);
+    if (length < Math.max(1, leader.capSizePx))
+        return undefined;
+    const marks = [];
+    if (leader.startCap)
+        capEnd(pts, 0, leader.startCap, leader.capSizePx, leader.stroke.color, marks);
+    if (leader.endCap)
+        capEnd(pts, 1, leader.endCap, leader.capSizePx, leader.stroke.color, marks);
+    const subpaths = [polylineCommands(pts, 0)].filter((sp) => sp.length > 0);
+    const stroke = leader.stroke;
+    return {
+        kind: 'path',
+        bbox: pathInkBox({ subpaths, stroke, markers: marks }),
+        subpaths,
+        stroke,
+        ...(marks.length > 0 ? { markers: marks } : {}),
+    };
+}
+/** The leaders of a figure's drawn labels (#1057) in the block's frame,
+ *  the body's corner at (`bodyX`, `bodyY`), in the labels' order. */
+export function figureLabelLeaderPaths(rb, bodyX, bodyY) {
+    const out = [];
+    for (const label of rb.labels ?? []) {
+        const path = label.layout ? figureLabelLeaderPath(label.layout, bodyX, bodyY) : undefined;
+        if (path)
+            out.push(path);
+    }
+    return out;
+}
+/** A leader's point reflected about the body's vertical axis, as the rest
+ *  of a label's geometry is on a mirrored page. */
+const flipLeader = (leader, bodyWidth) => leader ? { leader: { ...leader, x: bodyWidth - leader.x } } : {};
+/**
+ * Where anchor `anchorId` of the picture of `block` (a figure laid on
+ * `page`) stands on the page's sheet (#1057), through the picture's crop,
+ * safe area and scale as its labels are: undefined when the block is no
+ * picture or its resource lacks the anchor. A picture is painted the right
+ * way round on a mirrored page and upright on a vertical one, so the point
+ * is read on the body's box as the sheet shows it.
+ */
+export function figureAnchorPointOnPage(page, block, anchorId) {
+    const rb = block.resourceBlock;
+    if (!rb || (rb.kind !== 'bitmap' && rb.kind !== 'svg'))
+        return undefined;
+    const anchor = rb.resource.anchors?.find((a) => a.id === anchorId);
+    if (!anchor || !Number.isFinite(anchor.x) || !Number.isFinite(anchor.y))
+        return undefined;
+    if (!(rb.bodyRect.width > 0) || !(rb.bodyRect.height > 0))
+        return undefined;
+    const p = pictureToBody(rb, anchor.x, anchor.y);
+    if (rb.rotation) {
+        // A quarter-turned block: its body's frame turned onto the block's,
+        // which stands in the flow.
+        const { bx, by, turn } = bodyFrame(block);
+        const [x, y] = turn ? apply(turn, bx + p.x, by + p.y) : [bx + p.x, by + p.y];
+        return flowToPage(page, x, y);
+    }
+    // A picture is painted the right way round on a mirrored page, upright
+    // on a vertical one: the point is read on the body's box on the sheet.
+    const body = flowRectToPage(page, { x: block.bbox.x + rb.bodyRect.x, y: block.bbox.y + rb.bodyRect.y, width: rb.bodyRect.width, height: rb.bodyRect.height });
+    return { x: body.x + (p.x / rb.bodyRect.width) * body.width, y: body.y + (p.y / rb.bodyRect.height) * body.height };
+}
 // ---------------------------------------------------------------------------
 // Painting and hit-testing
 // ---------------------------------------------------------------------------
@@ -321,6 +545,16 @@ export function figureLabelMatrix(layout, bodyX, bodyY) {
     const s = Math.abs(sin) < 1e-12 ? 0 : sin;
     return [c, s, -s, c, bodyX + layout.x, bodyY + layout.y];
 }
+/** A label's plate (#1058) as a design box's style, for the painters of
+ *  boxes: its fill, its outline drawn inside the plate, its corners. */
+export function labelPlateBox(plate) {
+    return {
+        ...(plate.color ? { backgroundColor: plate.color } : {}),
+        ...(plate.border ? { borderColor: plate.border.color } : {}),
+        borderWidthPx: plate.border?.widthPx ?? 0,
+        borderRadiusPx: plate.radiusPx ?? 0,
+    };
+}
 /** What a label paints in its own frame: its background, else its lines'
  *  box. */
 export function figureLabelExtent(layout) {
@@ -531,6 +765,7 @@ export function mirrorLabelLayout(layout, bodyWidth, orient) {
         box: flipBox(layout.box),
         ...(layout.background ? { background: { ...layout.background, rect: flipBox(layout.background.rect) } } : {}),
         ...(layout.vertical ? { mirrored: true } : {}),
+        ...flipLeader(layout.leader, bodyWidth),
     };
     mirrored.add(out);
     return out;
@@ -560,6 +795,7 @@ export function unmirrorLabelLayout(layout, bodyWidth) {
         })),
         box: flipBox(layout.box),
         ...(layout.background ? { background: { ...layout.background, rect: flipBox(layout.background.rect) } } : {}),
+        ...flipLeader(layout.leader, bodyWidth),
     };
 }
 /** The run order of a line of `n` segments turned the other way: the
@@ -607,6 +843,7 @@ export function labelLayoutOnSheet(layout, bodyWidth) {
         }),
         box: flipBox(layout.box),
         ...(layout.background ? { background: { ...layout.background, rect: flipBox(layout.background.rect) } } : {}),
+        ...flipLeader(layout.leader, bodyWidth),
     };
 }
 // ---------------------------------------------------------------------------
@@ -620,10 +857,22 @@ export function undrawnLabels(labels) {
     const out = labels.filter((l) => !l.layout);
     return out.length > 0 ? out : undefined;
 }
-/** A drawn label's words as read, its lines joined by a space. */
+/** A drawn label's words as read, its lines joined by a space (a legend's
+ *  rows by a semicolon), each inline symbol read as its alternative text
+ *  in brackets, or not at all when it has none (#1058). */
 export function figureLabelReading(label) {
     const lines = label.layout?.lines;
-    const text = lines && lines.length > 0 ? lines.map((l) => l.text).join(' ') : label.text;
+    if (!lines || lines.length === 0)
+        return withIconAlts(label.text, label.icons).replace(/[]/g, '').replace(/\s+/g, ' ').trim();
+    const rows = lines.map((l) => figureLabelLineReading(l)).filter(Boolean);
+    return rows.join(label.layout?.legend ? '; ' : ' ');
+}
+/** One line of a drawn label as read (see {@link figureLabelReading}). */
+export function figureLabelLineReading(line) {
+    const segs = line.segments;
+    const text = segs?.some((s) => s.swatch?.icon)
+        ? segs.map((s) => (s.swatch?.icon ? (s.swatch.icon.alt ? `[${s.swatch.icon.alt}]` : '') : s.text)).join('')
+        : line.text;
     return text.replace(/[]/g, '').replace(/\s+/g, ' ').trim();
 }
 /** The share of a line box, at its top and at its foot, that holds no ink. */