postext 1.35.1 → 1.37.0

package/dist/migrate/markdownRuns.js

@@ -0,0 +1,215 @@
+/**
+ * The pages of a chapter that a heading style's running head dressed
+ * (#874): where each run of Markdown under a migrated page design starts and
+ * ends, page by page, so the migration can wrap it in a `::::page{template}`
+ * fence. A line scanner, not the parser: it only has to know headings, the
+ * fences that open and close containers, code blocks and page breaks, and it
+ * keeps every other line byte for byte.
+ */
+const HEADING_RE = /^(#{1,6})[ \t]+([^ \t].*)?$/;
+const FENCE_RE = /^(:{3,})(?:[ \t]*([A-Za-z][\w-]*))?(?:[ \t]*(\{.*\}))?$/;
+const CODE_RE = /^[ \t]{0,3}(`{3,}|~{3,})/;
+/** Containers, and the blocks the parser reads whole up to a bare `:::`. */
+const OPENS = new Set(['callout', 'paragraphs', 'part', 'columns', 'paper', 'frame', 'references', 'verse', 'figure', 'page', 'strip']);
+/** Directives that close a run when they stand at the top level: a part
+ *  page, the contents, a composed page already there, the index. */
+const CLOSES = new Set(['part', 'toc', 'index', 'bibliography', 'numbering']);
+/** The `{…}` attributes of a heading line: `key="v"`, `key='v'`, `key=v`,
+ *  `#id`, `.class` (ignored) and bare words. */
+export function parseAttrBlock(raw) {
+    const attrs = {};
+    const tokens = {};
+    const re = /([A-Za-z_][\w.:-]*)\s*=\s*("([^"]*)"|'([^']*)'|([^\s"']+))|#([\w-]+)|\.([\w-]+)|([A-Za-z_][\w-]*)/g;
+    for (let m = re.exec(raw); m; m = re.exec(raw)) {
+        if (m[1] !== undefined) {
+            attrs[m[1]] = m[3] ?? m[4] ?? m[5] ?? '';
+            tokens[m[1]] = m[0];
+        }
+        else if (m[6] !== undefined) {
+            attrs.id = m[6];
+            tokens.id = m[0];
+        }
+        else if (m[8] !== undefined) {
+            attrs[m[8]] = '';
+            tokens[m[8]] = m[0];
+        }
+    }
+    return { attrs, tokens };
+}
+/** A heading's text and trailing attribute block. */
+export function readHeading(line, index) {
+    const m = line.match(HEADING_RE);
+    if (!m)
+        return null;
+    let title = (m[2] ?? '').trimEnd();
+    let attrsRaw;
+    if (title.endsWith('}')) {
+        const open = title.lastIndexOf('{');
+        if (open >= 0) {
+            attrsRaw = title.slice(open + 1, -1);
+            title = title.slice(0, open).trimEnd();
+        }
+    }
+    const { attrs, tokens } = attrsRaw !== undefined ? parseAttrBlock(attrsRaw) : { attrs: {}, tokens: {} };
+    return { line: index, level: m[1].length, title, ...(attrsRaw !== undefined ? { attrsRaw } : {}), attrs, attrTokens: tokens };
+}
+const blank = (s) => s === undefined || s.trim() === '';
+/** Find the runs of a chapter's Markdown under the page designs `designOf`
+ *  names. A run opens at a heading whose style is migrated and goes on
+ *  while the headings that follow belong to the same design (or are
+ *  unstyled and deeper than the one that opened it); a heading of another
+ *  style, a part, the contents, a composed page fence or the chapter's end
+ *  close it. Inside a run a page break, or a heading that breaks the page,
+ *  starts the run's next page. Only top-level lines count: what sits in a
+ *  container or a code block is carried along. */
+export function scanChapter(markdown, opts) {
+    const lines = markdown.split('\n');
+    const headings = [];
+    const runs = [];
+    const breaks = [];
+    /** Colons of each open fence (3 for containers, 4+ for composed pages). */
+    const stack = [];
+    let code = null;
+    let run = null;
+    let page = null;
+    /** A page break met in a run, waiting for what follows it. */
+    let pendingBreak = null;
+    const closeRun = (endLine) => {
+        if (!run)
+            return;
+        // Trailing blank lines stay outside.
+        let end = endLine;
+        while (end > run.startLine && blank(lines[end]))
+            end--;
+        if (page)
+            page.endLine = Math.max(page.startLine, Math.min(page.endLine, end));
+        run.endLine = end;
+        runs.push({ design: run.design, startLine: run.startLine, endLine: run.endLine, pages: run.pages });
+        run = null;
+        page = null;
+    };
+    const startPage = (line) => {
+        if (!run)
+            return;
+        // The page before ends at its last line of content (`endLine` follows
+        // the content lines, never a page break or a blank line).
+        page = { startLine: line, endLine: line, headings: [] };
+        run.pages.push(page);
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const raw = lines[i];
+        const line = raw.replace(/\r$/, '');
+        const trimmed = line.trim();
+        if (code !== null) {
+            if (trimmed.startsWith(code))
+                code = null;
+            if (page)
+                page.endLine = i;
+            continue;
+        }
+        const codeOpen = line.match(CODE_RE);
+        if (codeOpen) {
+            code = codeOpen[1].slice(0, 3);
+            if (pendingBreak !== null && run) {
+                startPage(i);
+                pendingBreak = null;
+            }
+            if (page)
+                page.endLine = i;
+            continue;
+        }
+        const fence = trimmed.match(FENCE_RE);
+        const top = stack.length === 0;
+        if (fence) {
+            const colons = fence[1].length;
+            const name = fence[2];
+            if (!name) {
+                // A bare fence closes the innermost one it matches.
+                if (stack.length > 0 && (stack[stack.length - 1] === colons || (colons === 3 && stack[stack.length - 1] === 3)))
+                    stack.pop();
+                if (page)
+                    page.endLine = i;
+                continue;
+            }
+            if (top && name === 'pagebreak') {
+                if (run) {
+                    pendingBreak = i;
+                }
+                else if (/^:{3}pagebreak[ \t]*$/.test(trimmed)) {
+                    breaks.push(i);
+                }
+                continue;
+            }
+            if (top && (colons >= 4 || CLOSES.has(name))) {
+                if (run)
+                    closeRun(pendingBreak !== null ? pendingBreak - 1 : i - 1);
+                if (pendingBreak !== null) {
+                    breaks.push(pendingBreak);
+                    pendingBreak = null;
+                }
+            }
+            else if (top && pendingBreak !== null && run) {
+                startPage(i);
+                pendingBreak = null;
+            }
+            if (colons >= 4 || OPENS.has(name))
+                stack.push(colons >= 4 ? colons : 3);
+            if (page)
+                page.endLine = i;
+            continue;
+        }
+        if (top) {
+            const h = readHeading(line, i);
+            if (h) {
+                headings.push(h);
+                const design = h.attrs.style !== undefined ? opts.designOf(h.attrs.style) : undefined;
+                if (run) {
+                    const same = design !== undefined && design === run.design;
+                    const deeper = h.attrs.style === undefined && h.level > run.level;
+                    if (same || deeper) {
+                        if (pendingBreak !== null || (same && opts.breaksPage(h) && page && page.headings.length > 0))
+                            startPage(i);
+                        pendingBreak = null;
+                        page.headings.push(h);
+                        page.endLine = i;
+                        continue;
+                    }
+                    closeRun(pendingBreak !== null ? pendingBreak - 1 : i - 1);
+                    if (pendingBreak !== null)
+                        breaks.push(pendingBreak);
+                    pendingBreak = null;
+                }
+                if (design !== undefined) {
+                    run = { design, startLine: i, endLine: i, pages: [], level: h.level };
+                    startPage(i);
+                    page.headings.push(h);
+                }
+                continue;
+            }
+            if (!blank(line) && pendingBreak !== null && run) {
+                startPage(i);
+                pendingBreak = null;
+            }
+        }
+        if (page && !blank(line))
+            page.endLine = i;
+    }
+    if (run)
+        closeRun(pendingBreak !== null ? pendingBreak - 1 : lines.length - 1);
+    if (pendingBreak !== null)
+        breaks.push(pendingBreak);
+    // Bare page breaks next to a run: only blank lines between.
+    const dropBreaks = breaks.filter((b) => {
+        const near = (from, step) => {
+            for (let j = from; j >= 0 && j < lines.length; j += step)
+                if (!blank(lines[j]))
+                    return j;
+            return null;
+        };
+        const before = near(b - 1, -1);
+        const after = near(b + 1, 1);
+        return runs.some((r) => r.endLine === before || r.startLine === after);
+    });
+    return { lines, headings, runs, dropBreaks };
+}
+//# sourceMappingURL=markdownRuns.js.map

package/dist/migrate/markdownRuns.js.map

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

package/dist/migrate/pageDesign.d.ts

@@ -0,0 +1,119 @@
+/**
+ * One page design of a book that keeps its text in heading styles (#874):
+ * the elements of a style's running head split into the text that moves to
+ * the Markdown (grouped into frames by geometry and look) and the
+ * decoration that stays in the configuration. Pure; lengths in mm.
+ */
+import type { ChipStyleConfig, ColorValue, DesignElement, DesignTextElement, Dimension } from '../types';
+import type { PageSide } from '../composed/types';
+/** The look of a design text a paragraph style has to reproduce. */
+export interface TextLook {
+    fontFamily?: string;
+    fontSize: Dimension;
+    fontWeight: number;
+    italic: boolean;
+    color?: ColorValue;
+    align: 'left' | 'center' | 'right' | 'justify' | 'start' | 'end';
+    /** Leading as a multiple of the size. */
+    lineHeight: number;
+    uppercase: boolean;
+    hyphenate: boolean;
+    direction?: 'ltr' | 'rtl';
+    writingMode?: 'vertical-rl';
+    /** Tracking in ems of the text's size (#907); absent when none. */
+    letterSpacing?: Dimension;
+}
+/** A text element that moves to the Markdown. */
+export interface TextPiece {
+    id: string;
+    side?: PageSide;
+    /** Top-left on the trim, mm; only for elements anchored to the page's
+     *  top-left (the others keep their placement and are never merged). */
+    x?: number;
+    y?: number;
+    width?: number;
+    /** Estimated height (lines × leading). */
+    height?: number;
+    /** The height is the text's own lines (no line was guessed to wrap). */
+    heightSure?: boolean;
+    lineMm: number;
+    look: TextLook;
+    lookKey: string;
+    element: DesignTextElement;
+    /** The text as Markdown lines (inline marks kept, chips for highlights). */
+    lines: string[];
+    chars: number;
+    notes: string[];
+}
+/** A frame the migration writes: one or more pieces of one look, under one
+ *  another at an even spacing. */
+export interface PlannedFrame {
+    side?: PageSide;
+    pieces: TextPiece[];
+    look: TextLook;
+    lookKey: string;
+    /** mm between pieces (paragraph spacing). */
+    gap: number;
+    width?: number;
+    /** Assigned when templates are built. */
+    name?: string;
+    /** Geometry key for template sharing. */
+    key: string;
+}
+export interface DesignInput {
+    key: string;
+    elements: DesignElement[];
+    /** The slot each element comes from (same order as `elements`). */
+    origins: ('header' | 'footer')[];
+    page: {
+        width: number;
+        height: number;
+    };
+    isContent: (content: string) => boolean;
+    /** Existing chip styles, matched by background colour for highlights. */
+    chipStyles: readonly ChipStyleConfig[];
+    highlightsToChips: boolean;
+    merge: boolean;
+}
+export interface PlannedDesign {
+    key: string;
+    frames: PlannedFrame[];
+    /** Elements that stay, in their order (anchors to moved text remapped
+     *  once frames have names: see {@link remapDecorationAnchors}). */
+    decoration: DesignElement[];
+    /** Element id → index of the frame its text went to. */
+    movedTo: Map<string, number>;
+    /** Elements that stay in the template's own running heads: anchored
+     *  to the slot's container (or the outer margin), or to such an element. */
+    header: DesignElement[];
+    footer: DesignElement[];
+    /** The full-page picture, replaced by `{attr.background}`. */
+    background?: string;
+    /** Text elements left in the decoration, and why. */
+    kept: {
+        id: string;
+        reason: 'placeholder' | 'anchor';
+    }[];
+    /** Highlight boxes turned into chips. */
+    chips: number;
+    /** Chip styles this design needs that the book lacks, by id. */
+    newChipStyles: Map<string, ChipStyleConfig>;
+    notes: string[];
+    movedChars: number;
+    movedElements: number;
+}
+/** A length in mm; `em` against `emMm`. */
+export declare function toMm(d: Dimension | undefined, emMm?: number): number | undefined;
+/** A design text's look. */
+export declare function lookOf(el: DesignTextElement): TextLook;
+/** Whether a design text holds a placeholder (`{pageNumber}`, `{attr.x}`). */
+export declare function hasPlaceholder(content: string): boolean;
+/** The Markdown of a frame's paragraph: the lines joined by forced breaks
+ *  (a backslash at the end of the line; ` \\ ` on the same line when the
+ *  next one would start a block). */
+export declare function joinLines(lines: readonly string[]): string;
+/** Split one page design. */
+export declare function planDesign(input: DesignInput): PlannedDesign;
+/** Decoration anchors that named a text now in a frame name the frame. */
+export declare function remapDecorationAnchors(decoration: DesignElement[], movedTo: Map<string, number>, frames: readonly PlannedFrame[]): DesignElement[];
+//# sourceMappingURL=pageDesign.d.ts.map

package/dist/migrate/pageDesign.d.ts.map

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