postext 1.6.1 → 1.7.1

package/dist/parse/indexMarks.js

@@ -0,0 +1,231 @@
+/**
+ * Index marks (`:index[…]` and `:index{…}`, #165): the terms a back-of-book
+ * index lists. The marks are taken out of the markdown before the block
+ * parser runs — an invisible mark leaves nothing, a visible one leaves its
+ * text — so they never change the spans, the line breaks or the layout;
+ * the parse result's source offsets are mapped back to the original
+ * markdown. Each mark keeps the source offset of the character it is
+ * attached to (`anchor`): the build finds the page of the laid-out line
+ * holding that character.
+ */
+import { parseDirectiveAttrs } from './attrs';
+import { stripInlineFormatting } from './inlineFormatting';
+/** `:index[text]{attrs}`, `:index[text]` or `:index{attrs}`: not after a
+ *  colon (the `:::index` directive) or a backslash (an escaped mark). The
+ *  text is one line and takes `\]` for a literal bracket. */
+const INDEX_MARK_RE = /(?<![:\\]):index(?:\[((?:\\.|[^\]\\\n])*)\])?(?:\{([^}\n]*)\})?/g;
+/** Inline code on one line: its marks stay literal. */
+const CODE_SPAN_RE = /`[^`\n]+`/g;
+const isBlank = (c) => c === ' ' || c === '\t' || c === '\r';
+/** The levels of a term: `Heart!valves` → `['Heart', 'valves']`. */
+function termLevels(value) {
+    if (value === undefined)
+        return [];
+    return value.split('!').map((s) => s.replace(/\s+/g, ' ').trim()).filter((s) => s.length > 0);
+}
+/** The printed term of a visible mark: its text without inline marks. */
+function plainText(text) {
+    return stripInlineFormatting(text.replace(/\\([[\]])/g, '$1')).replace(/\s+/g, ' ').trim();
+}
+function markFrom(attrsRaw, visible, sourceStart, sourceEnd) {
+    const attrs = attrsRaw !== undefined ? parseDirectiveAttrs(attrsRaw) : {};
+    let path = termLevels(attrs.term);
+    if (path.length === 0 && visible !== undefined) {
+        const plain = plainText(visible);
+        if (plain.length > 0)
+            path = [plain];
+    }
+    path = [...path, ...termLevels(attrs.sub)];
+    const main = attrs.main !== undefined && attrs.main !== 'false';
+    const range = attrs.range === 'start' || attrs.range === 'end' ? attrs.range : undefined;
+    const sort = attrs.sort?.trim();
+    const see = attrs.see?.trim();
+    const seeAlso = attrs.seealso?.trim();
+    return {
+        index: attrs.index?.trim() ?? '',
+        path,
+        ...(sort ? { sort } : {}),
+        ...(see ? { see } : {}),
+        ...(seeAlso ? { seeAlso } : {}),
+        ...(main ? { main: true } : {}),
+        ...(range ? { range } : {}),
+        sourceStart,
+        sourceEnd,
+        anchor: -1,
+        attach: 'after',
+    };
+}
+/**
+ * The markdown with its index marks taken out, or null when it holds none.
+ * A line left blank by its marks alone is removed with its line end, so a
+ * mark on a line of its own never splits a paragraph.
+ */
+export function extractIndexMarks(markdown) {
+    if (!markdown.includes(':index'))
+        return null;
+    const pending = [];
+    const removals = [];
+    let out = '';
+    let lineStart = 0;
+    while (lineStart <= markdown.length) {
+        const nl = markdown.indexOf('\n', lineStart);
+        const lineEnd = nl === -1 ? markdown.length : nl;
+        const line = markdown.slice(lineStart, lineEnd);
+        if (!line.includes(':index')) {
+            out += line;
+            if (nl !== -1)
+                out += '\n';
+            lineStart = lineEnd + 1;
+            if (nl === -1)
+                break;
+            continue;
+        }
+        const code = [];
+        CODE_SPAN_RE.lastIndex = 0;
+        for (let m = CODE_SPAN_RE.exec(line); m; m = CODE_SPAN_RE.exec(line))
+            code.push([m.index, m.index + m[0].length]);
+        const lineOut = out.length;
+        const lineRemovals = [];
+        const linePending = [];
+        let kept = '';
+        let last = 0;
+        INDEX_MARK_RE.lastIndex = 0;
+        for (let m = INDEX_MARK_RE.exec(line); m; m = INDEX_MARK_RE.exec(line)) {
+            const [whole, visible, attrs] = m;
+            if (visible === undefined && attrs === undefined)
+                continue;
+            if (code.some(([s, e]) => m.index >= s && m.index < e))
+                continue;
+            kept += line.slice(last, m.index);
+            const start = lineStart + m.index;
+            const mark = markFrom(attrs, visible, start, start + whole.length);
+            if (visible !== undefined && visible.length > 0) {
+                // `:index[` goes, the text stays, `]{…}` goes.
+                const open = ':index['.length;
+                lineRemovals.push({ at: lineOut + kept.length, length: open });
+                const textStart = lineOut + kept.length;
+                kept += visible;
+                lineRemovals.push({ at: lineOut + kept.length, length: whole.length - open - visible.length });
+                linePending.push({ mark, at: textStart, textStart });
+            }
+            else {
+                lineRemovals.push({ at: lineOut + kept.length, length: whole.length });
+                linePending.push({ mark, at: lineOut + kept.length });
+            }
+            last = m.index + whole.length;
+        }
+        kept += line.slice(last);
+        if (linePending.length > 0 && kept.trim().length === 0 && line.trim().length > 0) {
+            // The line held marks alone: it goes, with its line end.
+            removals.push({ at: lineOut, length: line.length + (nl !== -1 ? 1 : 0) });
+            for (const p of linePending)
+                pending.push({ mark: p.mark, at: lineOut });
+        }
+        else {
+            out += kept;
+            if (nl !== -1)
+                out += '\n';
+            removals.push(...lineRemovals);
+            pending.push(...linePending);
+        }
+        if (nl === -1)
+            break;
+        lineStart = lineEnd + 1;
+    }
+    if (pending.length === 0)
+        return null;
+    // Cumulative removed length at each removal, for the offset map.
+    const at = [];
+    const cumulative = [];
+    let total = 0;
+    for (const r of removals) {
+        total += r.length;
+        at.push(r.at);
+        cumulative.push(total);
+    }
+    const toOriginal = (offset) => {
+        // Removals at or before `offset` (the removed text sat before it).
+        let lo = 0;
+        let hi = at.length;
+        while (lo < hi) {
+            const mid = (lo + hi) >> 1;
+            if (at[mid] <= offset)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        return offset + (lo > 0 ? cumulative[lo - 1] : 0);
+    };
+    /** Offset in the original of the stripped character at `i` (it sits
+     *  after the text removed right before it). */
+    const charOriginal = toOriginal;
+    const text = out;
+    for (const p of pending) {
+        const { mark } = p;
+        if (p.textStart !== undefined) {
+            mark.anchor = charOriginal(p.textStart);
+            mark.attach = 'after';
+            continue;
+        }
+        // An invisible mark belongs to the text before it on its line, else to
+        // the text after it.
+        let j = p.at - 1;
+        while (j >= 0 && isBlank(text[j]))
+            j--;
+        if (j >= 0 && text[j] !== '\n') {
+            mark.anchor = charOriginal(j);
+            mark.attach = 'before';
+            continue;
+        }
+        let k = p.at;
+        while (k < text.length && (isBlank(text[k]) || text[k] === '\n'))
+            k++;
+        if (k < text.length) {
+            mark.anchor = charOriginal(k);
+            mark.attach = 'after';
+        }
+    }
+    return { text, marks: pending.map((p) => ({ mark: p.mark, at: p.at })), toOriginal };
+}
+/** Blocks a mark can belong to: the ones that set text. */
+const TEXT_BLOCKS = new Set(['heading', 'paragraph', 'blockquote', 'listItem']);
+/**
+ * Attach the extracted marks to the blocks parsed from the stripped text
+ * (offsets still in stripped coordinates): the text block holding the
+ * mark's position, else the next one, else the last one.
+ */
+export function attachIndexMarks(blocks, marks) {
+    const text = blocks.filter((b) => TEXT_BLOCKS.has(b.type));
+    if (text.length === 0)
+        return;
+    for (const { mark, at } of marks) {
+        let owner = text.find((b) => at >= b.sourceStart && at <= b.sourceEnd);
+        owner ??= text.find((b) => b.sourceStart > at) ?? text[text.length - 1];
+        (owner.indexMarks ??= []).push(mark);
+    }
+}
+/** Map every source offset of a parse result from the stripped text back
+ *  to the original markdown. */
+export function remapParseOffsets(result, toOriginal) {
+    for (const b of result.blocks) {
+        b.sourceStart = toOriginal(b.sourceStart);
+        b.sourceEnd = toOriginal(b.sourceEnd);
+        for (let i = 0; i < b.sourceMap.length; i++)
+            b.sourceMap[i] = toOriginal(b.sourceMap[i]);
+        if (b.attrSources) {
+            for (const r of Object.values(b.attrSources)) {
+                r.start = toOriginal(r.start);
+                r.end = toOriginal(r.end);
+            }
+        }
+        for (const s of b.spans) {
+            if (s.math)
+                s.math = { ...s.math, sourceStart: toOriginal(s.math.sourceStart), sourceEnd: toOriginal(s.math.sourceEnd) };
+        }
+    }
+    for (const issue of result.issues) {
+        issue.sourceStart = toOriginal(issue.sourceStart);
+        issue.sourceEnd = toOriginal(issue.sourceEnd);
+    }
+}
+//# sourceMappingURL=indexMarks.js.map

package/dist/parse/indexMarks.js.map

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

package/dist/parse/types.d.ts

@@ -5,7 +5,7 @@ export type ContentBlockType = 'heading' | 'paragraph' | 'blockquote' | 'listIte
 export type DirectiveAttrs = Record<string, string>;
 /** Recognized directive names. Unknown names are not parsed as directives —
  *  they fall through to the paragraph branch and surface via warnings. */
-export type DirectiveName = 'pagebreak' | 'numbering' | 'columnbreak' | 'space' | 'toc';
+export type DirectiveName = 'pagebreak' | 'numbering' | 'columnbreak' | 'space' | 'toc' | 'index';
 /** Recognized fenced-container names. A container opens with a
  *  `:::name{attrs}` line and closes with a bare `:::` line; the blocks in
  *  between are parsed as usual and bracketed by a `containerStart` /
@@ -187,6 +187,54 @@ export interface TocBlockInfo {
     title?: string;
     palette?: Record<string, string>;
 }
+/** An index mark (`:index[text]{…}` / `:index{…}`, #165): one term the
+ *  back-of-book index lists, at the place it was marked. */
+export interface IndexMark {
+    /** Name of the index (`index="names"`); `''` for the main index. */
+    index: string;
+    /** The entry's levels, main term first (`term="Heart!valves"`). Empty
+     *  for a mark without a term (it indexes nothing). */
+    path: string[];
+    /** Sort key of the last level (`sort="…"`), when it differs from it. */
+    sort?: string;
+    /** Cross-references: the entry prints *See* / *See also* the target
+     *  instead of a page number for this mark. */
+    see?: string;
+    seeAlso?: string;
+    /** The principal reference (`main`): its page number is set bold. */
+    main?: boolean;
+    /** Opens or closes a page range (`range="start"` / `range="end"`). */
+    range?: 'start' | 'end';
+    /** Source range of the whole mark in the original markdown. */
+    sourceStart: number;
+    sourceEnd: number;
+    /** Source offset of the character the mark is attached to — the last
+     *  one before it on its line (`attach: 'before'`), else the first one
+     *  after it; `-1` when there is none. The mark lands on that character's
+     *  page. */
+    anchor: number;
+    attach: 'before' | 'after';
+}
+/** What one block of an expanded `:::index` prints: an entry (a term with
+ *  its page numbers), under the letter head of its group when it opens
+ *  one. */
+export interface IndexBlockInfo {
+    /** Entry depth (0 = main entry). */
+    level: number;
+    /** The entry opens a group of the index (a new first letter) other than
+     *  the first: the space above groups applies. */
+    groupStart?: boolean;
+    /** The letter head printed above the entry, in the same block so it
+     *  never ends a column alone. */
+    group?: string;
+    /** Entries with no page of their own that head this one (a main entry
+     *  and its sub-entry above a sub-sub-entry), printed above it in the
+     *  same block for the same reason, outermost first. */
+    leads?: {
+        level: number;
+        spans: InlineSpan[];
+    }[];
+}
 export interface ContentBlock {
     type: ContentBlockType;
     text: string;
@@ -237,6 +285,11 @@ export interface ContentBlock {
      *  `'paragraph'` and its text the entry title, so it flows and maps back
      *  to the directive line like ordinary content. */
     toc?: TocBlockInfo;
+    /** Present on the blocks a `:::index` directive expands into (see
+     *  `pipeline/indexDirective.ts`). */
+    index?: IndexBlockInfo;
+    /** The index marks set in this block's text, in source order. */
+    indexMarks?: IndexMark[];
     /** For `resourceBlock` blocks: the referenced `Resource.id`. */
     resourceId?: string;
     /** For `containerStart` / `containerEnd` marker blocks: the container

package/dist/parse/types.d.ts.map

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

package/dist/pipeline/build.js

@@ -9,8 +9,9 @@ import { collectConfigWarnings } from '../configWarnings';
 import { initHyphenator } from '../measure';
 import { resolveAllConfig, computeBaselineGrid, resolvedLocale } from './config';
 import { createHeadingLevelResolver, deriveSectionGeometryConfig, deriveSectionMeasureContext, headingIsHidden, headingIsNumbered, headingMarksFor, headingStyleOf, planHeadingSections, } from './headingStyles';
-import { computeOutline, hasTocDirective, headingNumberingOptions, headingTemplatesOf, outlineFromDoc, sameOutline } from './outline';
+import { computeOutline, hasIndexDirective, hasTocDirective, headingNumberingOptions, headingTemplatesOf, outlineFromDoc, sameOutline } from './outline';
 import { expandTocDirectives } from './toc';
+import { expandIndexDirectives, locateIndexMarks } from './indexDirective';
 import { resolveBodyStyle, resolveBlockquoteStyle, resolveParagraphStyle } from './styles';
 import { computeLevelIndentsPx, computeOrderedLevelIndentsPx, computeOrderedListRunMetrics, listBulletPosition, listItemGapPx, listItemSpacingPx, } from './lists';
 import { resetLinePositions, createPageWithColumns, currentColumn, advanceToNextColumn, advanceToNextPageBoundary, enforcePageParity, placeBlockInColumn, placeAtomicBlock, createPartPage, pageHasContent, sideColumnOf, sideColumns, sideUsedBottom, pageIsOccupied, bandColumns, currentBand, isBandLevel, bandUsedBottom, closeBandAndInsertSpan, pageLayoutOf, } from './placement';
@@ -229,9 +230,14 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
     // `:::toc` expands into the entries of the book's outline — the one the
     // host supplied, else this document's own (page labels unknown on the
     // 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.
     const outline = content.outline
-        ?? (hasTocDirective(parsedBlocks) ? computeOutline(parsedBlocks, resolved, headingStart) : undefined);
-    const contentBlocks = expandTocDirectives(parsedBlocks, outline, resolved);
+        ?? (hasTocDirective(parsedBlocks) || hasIndexDirective(parsedBlocks) ? computeOutline(parsedBlocks, resolved, headingStart) : undefined);
+    const indexExpanded = expandIndexDirectives(expandTocDirectives(parsedBlocks, outline, resolved), outline, resolved);
+    const contentBlocks = indexExpanded.blocks;
+    if (indexExpanded.warnings.length > 0)
+        indexWarnings.set(doc, indexExpanded.warnings);
     const isNumbered = (b) => headingIsNumbered(b, resolved);
     const { prefixes: headingPrefixes, values: headingNumbers } = computeHeadingNumbering(contentBlocks, headingTemplatesOf(resolved), headingStart ? [headingStart.h1, headingStart.h2, headingStart.h3, headingStart.h4, headingStart.h5, headingStart.h6] : undefined, isNumbered, headingNumberingOptions(resolved));
     // `{chapterNumber}` at each content block — the current chapter's, as the
@@ -4062,7 +4068,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         // The contents (`:::toc`) keep their own rhythm: an entry set as a list
         // item is not a list tail to realign the text after it. A heading snaps
         // per its level (or style), which inherits `headings.snapToGrid`.
-        const shouldSnapToGrid = rawBlock.toc === undefined && ((vdtType === 'heading' && !nextIsHeading
+        const shouldSnapToGrid = rawBlock.toc === undefined && rawBlock.index === undefined && ((vdtType === 'heading' && !nextIsHeading
             && (headingLevels.forBlock(rawBlock)?.snapToGrid ?? resolved.headings.snapToGrid)) ||
             (vdtType === 'listItem' && !nextIsListItem) ||
             (vdtType === 'paragraph' && isContainerTail && paragraphContainer?.snapToGrid !== false) ||
@@ -4102,7 +4108,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
          *  default opener paints across the page. */
         let brokenForWidth = measureWidth;
         let laterWidths = [];
-        const rebreaksForColumn = !tryLoose && rawBlock.toc === undefined
+        const rebreaksForColumn = !tryLoose && rawBlock.toc === undefined && rawBlock.index === undefined
             && (canSplit || (vdtType === 'heading' && !opensDefaultOpener(rawBlock)));
         /** Measure the block again for the columns it is set in (see
          *  `laterWidths`), with `extra` options. */
@@ -4219,7 +4225,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                         }
                     }
                 }
-                else if (rawBlock.toc) {
+                else if (rawBlock.toc || rawBlock.index) {
                     // A part row or an unnumbered entry of the contents: its top
                     // margin (`toc.parts.marginTop`, the level's `marginTop`) applies
                     // like a heading's.
@@ -5156,7 +5162,7 @@ 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 ?? []);
+    const found = [...collectContentWarnings(content.markdown, config, content.resources ?? []), ...(indexWarnings.get(doc) ?? [])];
     if (found.length > 0)
         doc.contentWarnings = locateContentWarnings(doc, found);
     // Config values the build replaced (an unknown number format, a font
@@ -5167,6 +5173,19 @@ export function* buildDocumentGen(content, config, cache, options) {
         doc.configWarnings = configWarnings;
     return doc;
 }
+/** Warnings the last pass's `:::index` raised, per document (read with
+ *  the content warnings once the build is done). */
+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;
+    return doc;
+}
 /** {@link buildDocumentGen} before the document-wide warnings: the
  *  contents rounds around the balanced build. */
 function* buildDocumentRounds(content, config, cache, options) {
@@ -5177,20 +5196,20 @@ 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)) {
+        if (hasTocDirective(parsed) || hasIndexDirective(parsed)) {
             let outline = computeOutline(parsed, resolveAllConfig(config), content.continuation?.headings);
-            let doc = yield* buildDocumentBalanced({ ...content, outline }, config, cache, options, 0);
+            let doc = withIndexMarks(yield* buildDocumentBalanced({ ...content, outline }, config, cache, options, 0), content);
             for (let round = 0; round < MAX_TOC_ROUNDS; round++) {
                 const after = outlineFromDoc(doc, outline);
                 if (sameOutline(after, outline))
                     break;
                 outline = after;
-                doc = yield* buildDocumentBalanced({ ...content, outline }, config, cache, options, round + 1);
+                doc = withIndexMarks(yield* buildDocumentBalanced({ ...content, outline }, config, cache, options, round + 1), content);
             }
             return doc;
         }
     }
-    return yield* buildDocumentBalanced(content, config, cache, options);
+    return withIndexMarks(yield* buildDocumentBalanced(content, config, cache, options), content);
 }
 const now = () => (typeof performance !== 'undefined' ? performance.now() : Date.now());
 function* buildDocumentBalanced(content, config, cache, options, tocRound = 0) {