postext 1.11.2 → 1.12.0

package/dist/pipeline/anchors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Anchors (#261): the points of a document a cross-reference may name —
+ * a heading with an identifier (`## Title {#id}`), an anchor set in the
+ * text (`:anchor{#id}`, `[text]{#id}`) and a container opened with one
+ * (`:::callout{#id}`). After layout each is located: the page it landed on
+ * and the top-left of its heading or line, which the renderers turn into
+ * link destinations and the sandbox scrolls to.
+ */
+import type { ContentBlock } from '../parse';
+import type { VDTAnchor, VDTDocument } from '../vdt';
+/** Whether the parsed content sets any anchor. */
+export declare function hasAnchors(blocks: readonly ContentBlock[]): boolean;
+/**
+ * Where each anchor of `blocks` (the parsed markdown body) landed in the
+ * laid-out `doc`. A heading's anchor is its first fragment; an inline
+ * anchor is the line holding the character it is attached to (as for an
+ * index mark, see `locateIndexMarks`), else the nearest line on the side
+ * it attaches to. Undefined when the document sets no anchor.
+ */
+export declare function locateAnchors(doc: VDTDocument, blocks: readonly ContentBlock[], bodyOffset: number): VDTAnchor[] | undefined;
+/** The identifiers set more than once in `blocks`, each with the source
+ *  ranges of its second and later settings (`duplicateAnchor`). */
+export declare function duplicateAnchors(blocks: readonly ContentBlock[]): {
+    id: string;
+    start: number;
+    end: number;
+}[];
+//# sourceMappingURL=anchors.d.ts.map

package/dist/pipeline/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../src/pipeline/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAY,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE/D,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAEnE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,UAAU,EAAE,MAAM,GACjB,SAAS,EAAE,GAAG,SAAS,CAgEzB;AAED;mEACmE;AACnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,CAe9G"}

package/dist/pipeline/anchors.js

@@ -0,0 +1,123 @@
+/**
+ * Anchors (#261): the points of a document a cross-reference may name —
+ * a heading with an identifier (`## Title {#id}`), an anchor set in the
+ * text (`:anchor{#id}`, `[text]{#id}`) and a container opened with one
+ * (`:::callout{#id}`). After layout each is located: the page it landed on
+ * and the top-left of its heading or line, which the renderers turn into
+ * link destinations and the sandbox scrolls to.
+ */
+/** Whether the parsed content sets any anchor. */
+export function hasAnchors(blocks) {
+    return blocks.some((b) => (b.anchorMarks?.length ?? 0) > 0 || (b.type === 'heading' && b.attrs?.id !== undefined));
+}
+/**
+ * Where each anchor of `blocks` (the parsed markdown body) landed in the
+ * laid-out `doc`. A heading's anchor is its first fragment; an inline
+ * anchor is the line holding the character it is attached to (as for an
+ * index mark, see `locateIndexMarks`), else the nearest line on the side
+ * it attaches to. Undefined when the document sets no anchor.
+ */
+export function locateAnchors(doc, blocks, bodyOffset) {
+    const marks = blocks.flatMap((b) => b.anchorMarks ?? []);
+    const out = [];
+    const seenHeading = new Set();
+    for (const b of doc.blocks) {
+        // A heading an opener design draws (its block hidden) is a target all
+        // the same: its block keeps its page and place.
+        if (b.type !== 'heading' || b.pageIndex < 0)
+            continue;
+        const id = b.attrs?.id;
+        if (id === undefined || id.length === 0)
+            continue;
+        // A split heading keeps its attributes on its first part only; the
+        // content index guards against a repeated one all the same.
+        if (b.contentIndex !== undefined) {
+            if (seenHeading.has(b.contentIndex))
+                continue;
+            seenHeading.add(b.contentIndex);
+        }
+        out.push({ id, kind: 'heading', pageIndex: b.pageIndex, x: b.bbox.x, y: b.bbox.y });
+    }
+    // Bibliography entries: the anchors `ref-<key>` citations link to (#269).
+    const seenEntry = new Set();
+    for (const b of doc.blocks) {
+        if (b.bibEntry === undefined || b.pageIndex < 0 || seenEntry.has(b.bibEntry))
+            continue;
+        seenEntry.add(b.bibEntry);
+        out.push({ id: `ref-${b.bibEntry}`, kind: 'anchor', pageIndex: b.pageIndex, x: b.bbox.x, y: b.bbox.y });
+    }
+    if (marks.length === 0)
+        return out.length > 0 ? out : undefined;
+    const lines = [];
+    const add = (b) => {
+        if (b.pageIndex < 0 || b.hidden)
+            return;
+        for (const l of b.lines) {
+            if (l.sourceStart !== undefined && l.sourceEnd !== undefined) {
+                lines.push({ start: l.sourceStart, end: l.sourceEnd, page: b.pageIndex, x: l.bbox.x, y: l.bbox.y });
+            }
+        }
+    };
+    for (const b of doc.blocks)
+        add(b);
+    for (const page of doc.pages)
+        for (const f of page.floats ?? [])
+            add(f);
+    lines.sort((a, b) => a.start - b.start || a.page - b.page);
+    /** Index of the last line starting at or before `at` (-1: none). */
+    const lastAtOrBefore = (at) => {
+        let lo = 0;
+        let hi = lines.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >> 1;
+            if (lines[mid].start <= at)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        return lo - 1;
+    };
+    for (const mark of marks) {
+        if (mark.anchor < 0 || lines.length === 0)
+            continue;
+        const at = mark.anchor + bodyOffset;
+        const i = lastAtOrBefore(at);
+        let line;
+        for (let j = i; j >= 0 && j > i - 64; j--) {
+            const l = lines[j];
+            if (at >= l.start && at < l.end && (line === undefined || l.page < line.page))
+                line = l;
+        }
+        line ??= mark.attach === 'before' ? lines[i] ?? lines[i + 1] : lines[i + 1] ?? lines[i];
+        if (!line)
+            continue;
+        out.push({ id: mark.anchorId, kind: 'anchor', pageIndex: line.page, x: line.x, y: line.y, sourceStart: mark.sourceStart });
+    }
+    return out.length > 0 ? out : undefined;
+}
+/** The identifiers set more than once in `blocks`, each with the source
+ *  ranges of its second and later settings (`duplicateAnchor`). */
+export function duplicateAnchors(blocks) {
+    const seen = new Set();
+    const out = [];
+    const note = (id, start, end) => {
+        if (seen.has(id))
+            out.push({ id, start, end });
+        else
+            seen.add(id);
+    };
+    for (const b of blocks) {
+        const marks = b.anchorMarks ?? [];
+        // A container's anchor (its fence opens before the block) comes first.
+        for (const m of marks)
+            if (m.sourceEnd <= b.sourceStart)
+                note(m.anchorId, m.sourceStart, m.sourceEnd);
+        if (b.type === 'heading' && b.attrs?.id)
+            note(b.attrs.id, b.sourceStart, b.attrSources?.id?.end ?? b.sourceEnd);
+        for (const m of marks)
+            if (m.sourceEnd > b.sourceStart)
+                note(m.anchorId, m.sourceStart, m.sourceEnd);
+    }
+    return out;
+}
+//# sourceMappingURL=anchors.js.map

package/dist/pipeline/anchors.js.map

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

package/dist/pipeline/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/pipeline/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAqI,MAAM,UAAU,CAAC;AAIjM,OAAO,EAIL,KAAK,WAAW,EAUjB,MAAM,QAAQ,CAAC;AAiBhB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqHnD,OAAO,EAAmH,KAAK,WAAW,EAAuG,MAAM,mBAAmB,CAAC;AAC3Q,OAAO,EASL,KAAK,OAAO,EACZ,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AAmBpB,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CACxC;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb;qCACiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C;AAED;yEACyE;AACzE,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C;4EACwE;IACxE,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtD,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC;;;sDAGkD;IAClD,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC;8EAC0E;IAC1E,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,GAAG,EAAE,WAAW,CAAC;IACjB;;+DAE2D;IAC3D,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7B;;;4EAGwE;IACxE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC;;qDAEiD;IACjD,qBAAqB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACpC;AAmGD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,oBAAoB,EAC9B,KAAK,GAAE,SAAc,GACpB,UAAU,CAkBZ;AAsjKD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,WAAW,CAEb;AAED;8EAC8E;AAC9E,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAchD;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAAG;IAAE,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAC5E,OAAO,CAAC,WAAW,CAAC,CAStB;AAED,wEAAwE;AACxE,wBAAiB,gBAAgB,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAmBpC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/pipeline/build.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/build.js

@@ -13,7 +13,11 @@ import { getMeasureRegion, getMeasureUprightDigits, getMeasureWritingMode, setMe
 import { stampCentralBaselines } from './verticalMetrics';
 import { resolveAllConfig, computeBaselineGrid, resolvedLocale } from './config';
 import { createHeadingLevelResolver, deriveSectionGeometryConfig, sectionWritingMode, deriveSectionMeasureContext, headingIsHidden, headingIsNumbered, headingMarksFor, headingStyleOf, planHeadingSections, } from './headingStyles';
-import { computeOutline, hasIndexDirective, hasTocDirective, headingNumberingOptions, headingTemplatesOf, outlineFromDoc, sameOutline } from './outline';
+import { locateAnchors } from './anchors';
+import { applyCitations, citationLocale, processCitations, withBibliographyStyle } from './citations';
+import { bookCitationContexts, needsCitationContext } from '../citations/context';
+import { anchorTargetsOf, hasAnchorRefs, printsAnchorPages } from './crossRefs';
+import { anchorOutline, computeOutline, hasIndexDirective, hasTocDirective, headingNumberingOptions, headingTemplatesOf, outlineFromDoc, sameOutline } from './outline';
 import { expandTocDirectives } from './toc';
 import { expandIndexDirectives, locateIndexMarks } from './indexDirective';
 import { resolveBodyStyle, resolveBlockquoteStyle, resolveParagraphStyle } from './styles';
@@ -271,7 +275,16 @@ function placeDocumentPass(content, config, cache, options, hints) {
     // Footnote definitions (`[^id]: …`) leave the flow; the markers are
     // numbered in citation order. With `placement: 'chapterEnd'` the notes
     // come back as paragraphs after each chapter's last block.
-    const footnoteSplit = splitFootnoteDefinitions(headingMarksFor(parseMarkdownMemo(markdownBody), resolved));
+    // Citations (#268): formatted against the book's references (or set as
+    // notes under a note style) before the notes leave the flow; the
+    // bibliography takes `:::bibliography`'s place or follows the text.
+    const parsedBody = headingMarksFor(parseMarkdownMemo(markdownBody), resolved);
+    const citationContext = content.citations
+        ?? (needsCitationContext(parsedBody, frontmatterMeta) ? bookCitationContexts([{ metadata: frontmatterMeta, blocks: parsedBody }])[0] : undefined);
+    const citationsApplied = citationContext
+        ? applyCitations(parsedBody, citationContext, processCitations(citationContext, resolved, citationLocale(resolved, resolvedLocale(resolved))), resolved, resolvedLocale(resolved))
+        : undefined;
+    const footnoteSplit = splitFootnoteDefinitions(citationsApplied?.blocks ?? parsedBody);
     const footnoteDefs = footnoteSplit.defs;
     // Numbered by page or column (`numbering: 'page'`), a note takes the
     // number the previous build gave it where it landed; the first build
@@ -293,8 +306,15 @@ function placeDocumentPass(content, config, cache, options, hints) {
     // first pass; `buildDocument` lays the document out again with them).
     // `:::index` expands into the entries of the book's index marks, from
     // the same outline.
+    // A reference naming an anchor (#262) reads its number, title and page
+    // from the same outline.
+    const resourceIds = new Set((content.resources ?? []).map((r) => r.id));
+    const anchorRefs = hasAnchorRefs(parsedBlocks, resourceIds);
     const outline = content.outline
-        ?? (hasTocDirective(parsedBlocks) || hasIndexDirective(parsedBlocks) ? computeOutline(parsedBlocks, resolved, headingStart) : undefined);
+        ?? (hasTocDirective(parsedBlocks) || hasIndexDirective(parsedBlocks) || anchorRefs ? computeOutline(parsedBlocks, resolved, headingStart) : undefined);
+    const anchorRefContext = anchorRefs
+        ? { targets: anchorTargetsOf(outline), strings: resolved.crossRefs }
+        : undefined;
     const indexExpanded = expandIndexDirectives(expandTocDirectives(parsedBlocks, outline, resolved), outline, resolved);
     const contentBlocks = indexExpanded.blocks;
     if (indexExpanded.warnings.length > 0)
@@ -332,7 +352,10 @@ function placeDocumentPass(content, config, cache, options, hints) {
     const orderedMetrics = computeOrderedListRunMetrics(contentBlocks, resolved, bodyStyle.fontSizePx);
     const orderedLevelIndentsPx = computeOrderedLevelIndentsPx(resolved, bodyStyle.fontSizePx, orderedMetrics.maxWidthByDepth);
     // `:::paragraphs{style="…"}` containers, resolved per content-block index.
-    const paragraphContainers = planParagraphContainers(contentBlocks, chapterEndNotes ? withFootnoteStyle(resolved) : resolved);
+    let containerStyles = chapterEndNotes ? withFootnoteStyle(resolved) : resolved;
+    if (citationsApplied?.bibliography)
+        containerStyles = withBibliographyStyle(containerStyles, citationsApplied.labelChars);
+    const paragraphContainers = planParagraphContainers(contentBlocks, containerStyles);
     // `:::callout` ranges keyed by their start marker index (same rationale).
     const calloutPlan = planCallouts(contentBlocks);
     // `:::part` ranges: start/end marker indices and the enclosed blocks.
@@ -1573,6 +1596,7 @@ function placeDocumentPass(content, config, cache, options, hints) {
         floatedIds,
         leftFlow: calloutsOutOfFlow,
         ...(footnoteNumbering.numbers.size > 0 ? { footnoteNumbers: footnoteNumbering.numbers } : {}),
+        ...(anchorRefContext ? { anchorRefs: anchorRefContext } : {}),
     };
     // --- Footnotes at the column foot (`footnotes.placement: 'column'`) ------
     // A text block placed in a column reserves, at the column's foot, the
@@ -1916,6 +1940,8 @@ function placeDocumentPass(content, config, cache, options, hints) {
         }
         if (raw.footnoteNote !== undefined)
             blk.footnoteNote = raw.footnoteNote;
+        if (raw.bibEntry !== undefined)
+            blk.bibEntry = raw.bibEntry;
         if (raw.toc?.kind === 'entry') {
             blk.tocEntry = raw.toc.pageIndex !== undefined ? { pageIndex: raw.toc.pageIndex } : {};
         }
@@ -5295,7 +5321,9 @@ export function* buildDocumentGen(content, config, cache, options) {
     // References and markup the source names wrongly: read from the source
     // once, located on the pages of the finished layout. Kept apart from
     // `doc.warnings`, whose entries keep their postext 1.4 shape.
-    const found = [...collectContentWarnings(content.markdown, config, content.resources ?? []), ...(indexWarnings.get(doc) ?? [])];
+    const bookAnchors = content.outline ? new Set(anchorOutline(content.outline).map((e) => e.anchorId)) : undefined;
+    const bookCitationKeys = content.citations ? new Set(content.citations.items.map((i) => i.id)) : undefined;
+    const found = [...collectContentWarnings(content.markdown, config, content.resources ?? [], bookAnchors, bookCitationKeys), ...(indexWarnings.get(doc) ?? [])];
     const located = found.length > 0 ? locateContentWarnings(doc, found) : [];
     // Justified CJK lines the composer could not fill within its tracking cap.
     const loose = cjkLooseLineWarnings(doc);
@@ -5317,12 +5345,17 @@ export function* buildDocumentGen(content, config, cache, options) {
 const indexWarnings = new WeakMap();
 /** `doc` with the page of each of its index marks (`doc.indexMarks`). */
 function withIndexMarks(doc, content) {
-    if (!content.markdown.includes(':index'))
-        return doc;
     const { content: body, contentOffset } = extractFrontmatter(content.markdown);
-    const marks = locateIndexMarks(doc, parseMarkdownMemo(body), contentOffset);
-    if (marks)
-        doc.indexMarks = marks;
+    const blocks = parseMarkdownMemo(body);
+    if (content.markdown.includes(':index')) {
+        const marks = locateIndexMarks(doc, blocks, contentOffset);
+        if (marks)
+            doc.indexMarks = marks;
+    }
+    // Where every anchor landed (#261), for links and page references.
+    const anchors = locateAnchors(doc, blocks, contentOffset);
+    if (anchors)
+        doc.anchors = anchors;
     return doc;
 }
 /** {@link buildDocumentGen} before the document-wide warnings: the
@@ -5335,7 +5368,14 @@ function* buildDocumentRounds(content, config, cache, options) {
     // it in one extra round.
     if (content.outline === undefined) {
         const parsed = parseMarkdownMemo(extractFrontmatter(content.markdown).content);
-        if (hasTocDirective(parsed) || hasIndexDirective(parsed)) {
+        // A reference printing an anchor's page (#263) settles the same way.
+        const pageRefs = () => {
+            if (!hasAnchorRefs(parsed, new Set((content.resources ?? []).map((r) => r.id))))
+                return false;
+            const resolved = resolveAllConfig(config);
+            return printsAnchorPages(parsed, anchorTargetsOf(computeOutline(parsed, resolved, content.continuation?.headings)), resolved.crossRefs.defaultStyle);
+        };
+        if (hasTocDirective(parsed) || hasIndexDirective(parsed) || pageRefs()) {
             let outline = computeOutline(parsed, resolveAllConfig(config), content.continuation?.headings);
             let doc = withIndexMarks(yield* buildDocumentNumbered({ ...content, outline }, config, cache, options, 0), content);
             for (let round = 0; round < MAX_TOC_ROUNDS; round++) {