postext 1.4.2 → 1.5.0

package/dist/bundle/configVersion.js

@@ -0,0 +1,788 @@
+// Which rules a stored configuration was written for, and how one written
+// for older rules is read in today's terms. A `.postext` manifest carries
+// the number as `configVersion` (every writer since postext 1.5 sets it);
+// the Sandbox numbers its stored projects the same way.
+import { DEFAULT_MATH_CONFIG } from '../defaults/math';
+import { dimensionsEqual } from '../defaults/shared';
+import { DEFAULT_TEXT_ELEMENT, resolveDesignLineHeight } from '../defaults/headerFooter';
+import { DEFAULT_PAGE_CONFIG } from '../defaults/page';
+import { dimensionToPx } from '../units';
+import { KNOWN_CONTAINERS } from '../parse/blockParser';
+/**
+ * The configuration rules this engine writes: 8 since postext 1.5. Thirteen
+ * rules changed in that release, and a configuration stored under an older
+ * number (or none) is read through {@link migrateConfig}:
+ * - 3: a heading level's `breakBefore` (and a heading style's) merges field
+ *   by field onto the level's default — H1's being `always-odd`
+ *   ({@link pinLegacyHeadingBreaks});
+ * - 4: one em of a formula is the surrounding text's size ×
+ *   `math.fontSizeScale`, where up to 1.4 formulas came out
+ *   {@link LEGACY_MATH_SIZE}× larger ({@link pinLegacyMathSize});
+ * - 5: an inline resource keeps the float gap below it as well as above
+ *   (`layout.inlineResourceGap: 'around'`), where up to 1.4 the text after
+ *   it resumed at the next grid line ({@link pinLegacyInlineGap});
+ * - 6, five rules:
+ *   - a heading reads its inline marks (`headings.inlineMarks: true`),
+ *     where up to 1.4 it printed them as plain text ({@link
+ *     pinLegacyHeadingMarks});
+ *   - a design text's drop cap that names no size is set at the size that
+ *     brings its top level with the first line's capitals, where up to 1.4
+ *     it was as tall as all the line boxes it spans ({@link
+ *     pinLegacyDropCapSize});
+ *   - `bodyText.keepColonWithList` leaves room under the colon line for
+ *     the list's first item to start by its orphan and widow rules
+ *     (`bodyText.colonListRoom: 'item'`), where up to 1.4 one line was
+ *     enough ({@link pinLegacyColonListRoom});
+ *   - an inline resource inside a box keeps the float gap too
+ *     (`layout.inlineResourceGapInBoxes`), where up to 1.4 it sat right
+ *     against the text around it ({@link pinLegacyBoxResourceGap});
+ *   - a box that splits inside a paragraph or list item leaves at least two
+ *     lines of it on each side (`layout.boxChildSplitMinLines: 2`), where
+ *     up to 1.4 a cut could leave one ({@link pinLegacyBoxChildCut});
+ * - 7, two rules:
+ *   - a line may end after an em or en dash set closed between words
+ *     (`bodyText.breakAfterDashes`), where up to 1.4 Knuth–Plass never
+ *     broke there ({@link pinLegacyDashBreaks});
+ *   - ragged running text is broken with Knuth–Plass too
+ *     (`bodyText.optimalRagged`), where up to 1.4 it was set line by line
+ *     ({@link pinLegacyRaggedBreaking});
+ * - 8, three rules:
+ *   - a paragraph kept with the heading above it at a column's foot
+ *     splits by the orphan rule too (`headings.keepWithNextSplit:
+ *     'rules'`), where up to 1.4 it kept as many lines as fit under the
+ *     heading ({@link pinLegacyHeadingSplit});
+ *   - the space under a `:::paragraphs` container merges with the next
+ *     block's own and is at least the paragraph spacing of the text around
+ *     it (`bodyText.paragraphContainerSpacing: 'collapse'`), where up to
+ *     1.4 the style's space was baked into the grid snap and the next
+ *     block's space above added under it ({@link
+ *     pinLegacyParagraphContainerSpacing});
+ *   - Knuth–Plass may end a line after the hyphen of a compound in every
+ *     paragraph (`bodyText.breakAfterHyphens`), where up to 1.4 a justified
+ *     paragraph with no inline formatting never broke there ({@link
+ *     pinLegacyHyphenBreaks}).
+ *
+ * A configuration stored without a version was written for postext 1.4 or
+ * earlier. One stored under 3 to 7 was written by a 1.5 prerelease, and
+ * gets the pins of the rules after its number: under 3 the maths,
+ * inline-gap, version-6, version-7 and version-8 pins, under 4 the
+ * inline-gap, version-6, version-7 and version-8 pins, under 5 the
+ * version-6, version-7 and version-8 pins, under 6 the version-7 and
+ * version-8 pins, under 7 the version-8 pins.
+ */
+export const CONFIG_VERSION = 8;
+/** The rules that merge a partial heading break onto its level's. */
+const HEADING_BREAK_RULES = 3;
+/** The rules that set a formula's em at the documented size. */
+const MATH_SIZE_RULES = 4;
+/** The rules that keep the float gap under an inline resource. */
+const INLINE_GAP_RULES = 5;
+/** The rules that read a heading's inline marks, and size a drop cap to
+ *  the first line's capitals. */
+const HEADING_MARKS_RULES = 6;
+const DROP_CAP_SIZE_RULES = 6;
+/** The rules that leave room for a list's first item under its colon line. */
+const COLON_LIST_ROOM_RULES = 6;
+/** The rules that keep the gap around an inline resource inside a box. */
+const BOX_GAP_RULES = 6;
+/** The rules that keep two lines of a paragraph or list item on each side
+ *  of a box cut. */
+const BOX_CHILD_CUT_RULES = 6;
+/** The rules that let a line end after a closed dash. */
+const DASH_BREAK_RULES = 7;
+/** The rules that break ragged running text with Knuth–Plass. */
+const RAGGED_BREAKING_RULES = 7;
+/** The rules that keep the orphan minimum when a paragraph splits under a
+ *  heading. */
+const HEADING_SPLIT_RULES = 8;
+/** The rules that merge the space under a `:::paragraphs` container with
+ *  the next block's. */
+const PARAGRAPH_CONTAINER_RULES = 8;
+/** The rules that let Knuth–Plass break after a compound's hyphen in every
+ *  paragraph. */
+const HYPHEN_BREAK_RULES = 8;
+/** Up to 1.4 a drop cap with no `fontSize` was as tall as the line boxes it
+ *  spans divided by this, the share of a letter's size its capitals take. */
+const CAP_HEIGHT = 0.72;
+/**
+ * How much larger postext 1.4 set maths than the size it documents:
+ * MathJax gives a formula's box in `ex`, one `ex` of its TeX font is
+ * 0.442 em (the font's `x_height`), and 1.4 took it as half an em. So
+ * 0.5 ÷ 0.442 ≈ 1.1312; a configuration whose `math.fontSizeScale` is
+ * multiplied by it sets every formula at the size 1.4 did.
+ */
+export const LEGACY_MATH_SIZE = 0.5 / 0.442;
+function isRecord(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/** A stored `configVersion`: a finite number, anything else counting as
+ *  none (written by postext 1.4 or earlier). */
+function rulesOf(configVersion) {
+    return typeof configVersion === 'number' && Number.isFinite(configVersion) ? configVersion : 0;
+}
+/** A partial `breakBefore` as postext 1.4 resolved it where the default
+ *  it filled from was the no-break one, written out in full; undefined
+ *  when it already says all it lays out. */
+function pinnedBreak(raw) {
+    const enabled = raw?.enabled ?? false;
+    if (raw?.enabled !== undefined && (!enabled || raw.parity !== undefined))
+        return undefined;
+    return { ...raw, enabled, ...(enabled && raw?.parity === undefined ? { parity: 'any' } : {}) };
+}
+/**
+ * A configuration written for postext 1.4 or earlier, pinned to the heading
+ * breaks it laid out then. Up to 1.4 a `headings` object turned the H1 page
+ * break off unless it set `levels[0].breakBefore.enabled` (and stripping the
+ * defaults dropped an H1 `enabled: false`, so saved and exported
+ * configurations never carried one), a partial H1 break took its missing
+ * field from the no-break default, and a heading style's `breakBefore`
+ * replaced its level's with the same fill. The engine now merges each onto
+ * the level's break — H1's being `always-odd` — so those breaks are written
+ * out: `enabled: false` on H1, or `parity: 'any'` beside an `enabled: true`.
+ * A configuration with no `headings` object, or one that spells every break
+ * out in full, is returned as it is (the same object).
+ */
+export function pinLegacyHeadingBreaks(config) {
+    let out = config;
+    const headings = config.headings;
+    if (isRecord(headings)) {
+        const levels = Array.isArray(headings.levels) ? headings.levels : [];
+        const i = levels.findIndex((l) => isRecord(l) && l.level === 1);
+        const pin = pinnedBreak(i >= 0 && isRecord(levels[i].breakBefore) ? levels[i].breakBefore : undefined);
+        if (pin) {
+            const nextLevels = i >= 0
+                ? levels.map((l, k) => (k === i ? { ...l, breakBefore: pin } : l))
+                : [...levels, { level: 1, breakBefore: pin }];
+            out = { ...out, headings: { ...headings, levels: nextLevels } };
+        }
+    }
+    if (Array.isArray(config.headingStyles)) {
+        let changed = false;
+        const styles = config.headingStyles.map((style) => {
+            if (!isRecord(style) || !isRecord(style.breakBefore))
+                return style;
+            const pin = pinnedBreak(style.breakBefore);
+            if (!pin)
+                return style;
+            changed = true;
+            return { ...style, breakBefore: pin };
+        });
+        if (changed)
+            out = { ...out, headingStyles: styles };
+    }
+    return out;
+}
+function isDimension(v) {
+    return isRecord(v) && typeof v.value === 'number' && typeof v.unit === 'string';
+}
+/**
+ * A configuration written before postext 1.5, pinned to the maths size it
+ * laid out then: `math.fontSizeScale` (1 when unset) × {@link
+ * LEGACY_MATH_SIZE}. A display formula's margins in `em` or `rem` are
+ * lengths of the formula's own size, so they are divided by the same
+ * factor and keep the space 1.4 left around the formula. A value that
+ * lands on its default is left out (a scale of 0.884 becomes the default
+ * 1), and a configuration with maths switched off (`math.enabled: false`,
+ * whose formulas are set as their TeX source at the body size) is
+ * returned as it is (the same object).
+ */
+export function pinLegacyMathSize(config) {
+    const math = isRecord(config.math) ? config.math : {};
+    if (math.enabled === false)
+        return config;
+    const next = { ...math };
+    const scale = typeof math.fontSizeScale === 'number' && Number.isFinite(math.fontSizeScale)
+        ? math.fontSizeScale
+        : DEFAULT_MATH_CONFIG.fontSizeScale;
+    const pinnedScale = scale * LEGACY_MATH_SIZE;
+    if (pinnedScale === DEFAULT_MATH_CONFIG.fontSizeScale)
+        delete next.fontSizeScale;
+    else
+        next.fontSizeScale = pinnedScale;
+    for (const key of ['marginTop', 'marginBottom']) {
+        const margin = isDimension(math[key]) ? math[key] : DEFAULT_MATH_CONFIG[key];
+        if (margin.unit !== 'em' && margin.unit !== 'rem')
+            continue;
+        const pinned = { ...margin, value: margin.value / LEGACY_MATH_SIZE };
+        if (dimensionsEqual(pinned, DEFAULT_MATH_CONFIG[key]))
+            delete next[key];
+        else
+            next[key] = pinned;
+    }
+    return { ...config, math: next };
+}
+/**
+ * A configuration written before postext 1.5, pinned to the space it left
+ * under an inline resource: `layout.inlineResourceGap: 'above'`, where 1.4
+ * kept the float gap above the resource only and set the text after it at
+ * the next grid line. A configuration that names a gap already is returned
+ * as it is (the same object).
+ */
+export function pinLegacyInlineGap(config) {
+    const layout = isRecord(config.layout) ? config.layout : {};
+    if (layout.inlineResourceGap !== undefined)
+        return config;
+    return { ...config, layout: { ...layout, inlineResourceGap: 'above' } };
+}
+/**
+ * A configuration written before postext 1.5, pinned to the room it left
+ * for a list under the colon line that introduces it:
+ * `bodyText.colonListRoom: 'line'`, where 1.4 took one line of room as
+ * enough and a first item the orphan and widow rules keep whole went on
+ * to the next column without the colon line. A configuration that names a
+ * room already, or turns `keepColonWithList` off, is returned as it is
+ * (the same object).
+ */
+export function pinLegacyColonListRoom(config) {
+    const bodyText = isRecord(config.bodyText) ? config.bodyText : {};
+    if (bodyText.colonListRoom !== undefined || bodyText.keepColonWithList === false)
+        return config;
+    return { ...config, bodyText: { ...bodyText, colonListRoom: 'line' } };
+}
+/** A paragraph line ending in a colon (emphasis markers may close after
+ *  it) with a list item next, blank lines between them allowed: the lead-in
+ *  `keepColonWithList` keeps with its list. */
+const COLON_LIST_RE = /:[*_]*[^\S\n]*\n(?:[^\S\n]*\n)*[^\S\n]*(?:[-*+]|\d+[.)])[^\S\n]/;
+/**
+ * A configuration written before postext 1.5, pinned to the space it left
+ * around an inline resource inside a box: `layout.inlineResourceGapInBoxes:
+ * false`, where 1.4 set the resource right under the text before it and
+ * the text after it right under the resource. A configuration that already
+ * says whether boxes keep the gap is returned as it is (the same object).
+ */
+export function pinLegacyBoxResourceGap(config) {
+    const layout = isRecord(config.layout) ? config.layout : {};
+    if (layout.inlineResourceGapInBoxes !== undefined)
+        return config;
+    return { ...config, layout: { ...layout, inlineResourceGapInBoxes: false } };
+}
+/**
+ * A configuration written before postext 1.5, pinned to the cuts it made in
+ * a box that splits: `layout.boxChildSplitMinLines: 1`, where 1.4 cut
+ * inside a paragraph or list item wherever each side of the box held its
+ * `splitMinLines` lines in all, even when that left one line of the
+ * paragraph or item on a side. A configuration that names the setting
+ * already is returned as it is (the same object).
+ */
+export function pinLegacyBoxChildCut(config) {
+    const layout = isRecord(config.layout) ? config.layout : {};
+    if (layout.boxChildSplitMinLines !== undefined)
+        return config;
+    return { ...config, layout: { ...layout, boxChildSplitMinLines: 1 } };
+}
+/**
+ * A configuration written before postext 1.5, pinned to the line breaks it
+ * made at a dash: `bodyText.breakAfterDashes: false`, where 1.4's
+ * Knuth–Plass never ended a line after an em or en dash set closed between
+ * words ("say—that’s"), and its line-by-line breaker for formatted text
+ * only between two letters. A configuration that names the setting already
+ * is returned as it is (the same object).
+ */
+export function pinLegacyDashBreaks(config) {
+    const bodyText = isRecord(config.bodyText) ? config.bodyText : {};
+    if (bodyText.breakAfterDashes !== undefined)
+        return config;
+    return { ...config, bodyText: { ...bodyText, breakAfterDashes: false } };
+}
+/**
+ * A configuration written before postext 1.5, pinned to the way it broke
+ * ragged text: `bodyText.optimalRagged: false`, where 1.4 set every ragged
+ * paragraph line by line, filling each line before the next, whatever
+ * `optimalLineBreaking` said. A configuration that names the setting
+ * already, that sets no running text ragged (the body, a paragraph style,
+ * a box body, the body of a part or of a section style, in the
+ * configuration or in its HTML viewer's overrides), or that turns
+ * `optimalLineBreaking` off (the setting then changes nothing) is returned
+ * as it is (the same object).
+ */
+export function pinLegacyRaggedBreaking(config) {
+    const bodyText = isRecord(config.bodyText) ? config.bodyText : {};
+    if (bodyText.optimalRagged !== undefined || bodyText.optimalLineBreaking === false)
+        return config;
+    if (!setsRaggedText(config))
+        return config;
+    return { ...config, bodyText: { ...bodyText, optimalRagged: false } };
+}
+/**
+ * A configuration written before postext 1.5, pinned to the way it split a
+ * paragraph kept with the heading above it at a column's foot:
+ * `headings.keepWithNextSplit: 'fill'`, where 1.4 kept as many lines as fit
+ * under the heading (at least `bodyText.widowMinLines`) however few went on
+ * to the next column. A configuration that names the setting already, that
+ * turns `headings.keepWithNext` off, or that turns `bodyText.avoidOrphans`
+ * off (the setting then changes nothing) is returned as it is (the same
+ * object).
+ */
+export function pinLegacyHeadingSplit(config) {
+    const headings = isRecord(config.headings) ? config.headings : {};
+    if (headings.keepWithNextSplit !== undefined || headings.keepWithNext === false)
+        return config;
+    if (isRecord(config.bodyText) && config.bodyText.avoidOrphans === false)
+        return config;
+    return { ...config, headings: { ...headings, keepWithNextSplit: 'fill' } };
+}
+/**
+ * A configuration written before postext 1.5, pinned to the space it left
+ * under a `:::paragraphs` container: `bodyText.paragraphContainerSpacing:
+ * 'add'`, where 1.4 set the style's space (the larger of `spaceBetween` and
+ * `marginBottom`) under the last paragraph before the grid snap, added the
+ * next block's own space above (a heading's `marginTop`, the next
+ * container's) under it, and left the paragraph spacing of the text around
+ * the container out. A configuration that names the setting already, or
+ * declares no paragraph style (in the configuration or in its HTML
+ * viewer's overrides; a container naming no style is set as body text), is
+ * returned as it is (the same object).
+ */
+export function pinLegacyParagraphContainerSpacing(config) {
+    const bodyText = isRecord(config.bodyText) ? config.bodyText : {};
+    if (bodyText.paragraphContainerSpacing !== undefined)
+        return config;
+    if (!declaresParagraphStyles(config))
+        return config;
+    return { ...config, bodyText: { ...bodyText, paragraphContainerSpacing: 'add' } };
+}
+/** Whether `config` (or the screen overrides of its HTML viewer) declares
+ *  a paragraph style, which is all a `:::paragraphs` container is laid out
+ *  with. */
+function declaresParagraphStyles(config) {
+    const has = (c) => Array.isArray(c.paragraphStyles) && c.paragraphStyles.length > 0;
+    if (has(config))
+        return true;
+    const viewer = config.htmlViewer;
+    return isRecord(viewer) && isRecord(viewer.overrides) && has(viewer.overrides);
+}
+/** A `:::paragraphs` opening fence on a line of its own, as the block
+ *  parser reads one (the line trimmed). */
+const PARAGRAPHS_FENCE_LINE_RE = /^[^\S\n]*:::[^\S\n]*paragraphs[^\S\n]*(?:\{[^}\n]*\})?[^\S\n]*$/m;
+/** Whether markdown may hold a `:::paragraphs` container. Unknown content
+ *  (undefined) may. */
+function mayHaveParagraphContainers(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return PARAGRAPHS_FENCE_LINE_RE.test(content);
+    return content.some((text) => PARAGRAPHS_FENCE_LINE_RE.test(text));
+}
+/**
+ * A configuration written before postext 1.5, pinned to the line breaks it
+ * made at the hyphen of a compound: `bodyText.breakAfterHyphens: false`,
+ * where 1.4's Knuth–Plass ended a justified line after a hyphen between two
+ * letters ("well-" | "known") only in a paragraph with inline formatting.
+ * A configuration that names the setting already, or turns
+ * `optimalLineBreaking` off (the setting then changes nothing), is returned
+ * as it is (the same object).
+ */
+export function pinLegacyHyphenBreaks(config) {
+    const bodyText = isRecord(config.bodyText) ? config.bodyText : {};
+    if (bodyText.breakAfterHyphens !== undefined || bodyText.optimalLineBreaking === false)
+        return config;
+    return { ...config, bodyText: { ...bodyText, breakAfterHyphens: false } };
+}
+/** A compound a line may end in: a hyphen between two letters. The
+ *  Markdown is read raw; only a paragraph with no inline mark is broken
+ *  differently, and there the compound is written as it prints. */
+const COMPOUND_RE = /\p{L}-\p{L}/u;
+/** Whether markdown may set a compound. Unknown content (undefined) may. */
+function mayHaveCompounds(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return COMPOUND_RE.test(content);
+    return content.some((text) => COMPOUND_RE.test(text));
+}
+/** Whether a `textAlign` value sets text ragged (anything but `'justify'`;
+ *  an unset one follows the body). */
+function isRaggedAlign(value) {
+    return typeof value === 'string' && value !== 'justify';
+}
+/** Whether `config` (or the screen overrides of its HTML viewer) sets some
+ *  running text ragged: the body text (and so its blockquotes and lists), a
+ *  paragraph style, a box body, the body of a part or the body of a
+ *  section style (`headingStyles[].bodyStyle`). Headings do not count: they
+ *  are not broken with Knuth–Plass when ragged. */
+function setsRaggedText(config) {
+    const raggedBody = (st) => isRecord(st) && isRecord(st.bodyStyle) && isRaggedAlign(st.bodyStyle.textAlign);
+    const check = (c) => {
+        if (isRecord(c.bodyText) && isRaggedAlign(c.bodyText.textAlign))
+            return true;
+        if (Array.isArray(c.paragraphStyles) && c.paragraphStyles.some((st) => isRecord(st) && isRaggedAlign(st.textAlign)))
+            return true;
+        if (Array.isArray(c.calloutStyles) && c.calloutStyles.some((st) => isRecord(st) && isRecord(st.body) && isRaggedAlign(st.body.textAlign)))
+            return true;
+        if (Array.isArray(c.headingStyles) && c.headingStyles.some(raggedBody))
+            return true;
+        return raggedBody(c.parts);
+    };
+    if (check(config))
+        return true;
+    const viewer = config.htmlViewer;
+    return isRecord(viewer) && isRecord(viewer.overrides) && check(viewer.overrides);
+}
+/** A dash a line may end after (see `breaksAfterDash` in
+ *  `measure/breakRules.ts`): an em or en dash set closed, a letter, a digit
+ *  or closing punctuation before it, and a letter or a digit after it. A
+ *  quotation mark before the dash counts only when something that may close
+ *  a word stands before it (`"no"—and`, `„nein“—und`, `« non »—et`), not
+ *  after a space (`said "—Hola`), where no rule breaks. The Markdown is read
+ *  raw, so the inline marks that may touch the dash or the quote count on
+ *  either side (`**riddles.**—I`, `*riddles*—and`, `*no*"—and`, a code
+ *  span, a `:ref[…]`, an escape). An en dash between two digits, and a
+ *  bracket or quote after the dash, which never break, are let through: the
+ *  check only has to be safe. */
+const CLOSED_DASH_RE = /(?:[\p{L}\p{N}.,;:!?)\]}…*_`~^\\]|[\p{L}\p{N}.,;:!?)\]}…*_`~^\\\u00A0\u202F]["'»”’“«])[\u2013\u2014][\p{L}\p{N}([{¿¡«“‘„"'*_`~^:\\<]/u;
+/** Whether markdown may set a dash a line can now end after. Unknown
+ *  content (undefined) may. */
+function mayHaveClosedDashes(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return CLOSED_DASH_RE.test(content);
+    return content.some((text) => CLOSED_DASH_RE.test(text));
+}
+/**
+ * A configuration written before postext 1.5, pinned to the headings it
+ * laid out then: `headings.inlineMarks: false`, where 1.4 printed the text
+ * of a heading's `*italic*`, `**bold**` and other marks in the heading's
+ * plain style. A configuration that names the setting already is returned
+ * as it is (the same object).
+ */
+export function pinLegacyHeadingMarks(config) {
+    const headings = isRecord(config.headings) ? config.headings : {};
+    if (headings.inlineMarks !== undefined)
+        return config;
+    return { ...config, headings: { ...headings, inlineMarks: false } };
+}
+/** The double next to `v`, one step towards `+∞` (`dir` 1) or `−∞`. */
+function nextDouble(v, dir) {
+    if (v === 0)
+        return dir * Number.MIN_VALUE;
+    const view = new DataView(new ArrayBuffer(8));
+    view.setFloat64(0, v);
+    view.setBigInt64(0, view.getBigInt64(0) + ((v > 0) === (dir > 0) ? 1n : -1n));
+    return view.getFloat64(0);
+}
+/** A length in `unit` that `dimensionToPx` reads back as `px` at `dpi`
+ *  (em against `basePx`): the plain conversion, or one of the doubles next
+ *  to it when rounding leaves that a hair off. Most sizes read back
+ *  exactly; for some unit, dpi and leading combinations no double does, and
+ *  the plain conversion is kept, a rounding step or two (1e-14 px) away. */
+function lengthOf(px, unit, dpi, basePx) {
+    const toPx = (value) => dimensionToPx({ value, unit }, dpi, basePx);
+    const first = px / toPx(1);
+    let up = first;
+    let down = first;
+    for (let step = 0; step < 16; step++) {
+        if (toPx(up) === px)
+            return { value: up, unit };
+        if (toPx(down) === px)
+            return { value: down, unit };
+        up = nextDouble(up, 1);
+        down = nextDouble(down, -1);
+    }
+    return { value: first, unit };
+}
+/** The size postext 1.4 set the drop cap of the design text `el` at, when
+ *  the cap names none, `dpi` being the document's: the line boxes it spans
+ *  over {@link CAP_HEIGHT}, worked out as 1.4 did and written in the unit of
+ *  the element's leading (a length) or of its font size (a multiplier of
+ *  it). Undefined when that cannot be written out. */
+function legacyDropCapSize(el, dropCap, dpi) {
+    const lines = Math.max(1, Math.round(Number(dropCap.lines ?? 2)));
+    if (!Number.isFinite(lines))
+        return undefined;
+    const fontSize = isDimension(el.fontSize) ? el.fontSize : DEFAULT_TEXT_ELEMENT.fontSize;
+    // A design text's size is a length; one in em has nothing to read against.
+    if (fontSize.unit === 'em' || fontSize.unit === 'rem')
+        return undefined;
+    const fontSizePx = dimensionToPx(fontSize, dpi);
+    const leading = resolveDesignLineHeight(el.lineHeight, fontSize);
+    const lineHeightPx = leading.lineHeightLength ? dimensionToPx(leading.lineHeightLength, dpi) : fontSizePx * leading.lineHeight;
+    const capPx = (lines * lineHeightPx) / CAP_HEIGHT;
+    if (!Number.isFinite(capPx) || capPx <= 0)
+        return undefined;
+    return lengthOf(capPx, leading.lineHeightLength?.unit ?? fontSize.unit, dpi, fontSizePx);
+}
+/** `value` with every design text in it — a `kind: 'text'` object whose
+ *  `dropCap` names no `fontSize` — given its 1.4 size, wherever it sits;
+ *  the same object where nothing changed. */
+function pinDropCaps(value, dpi) {
+    if (Array.isArray(value)) {
+        let changed = false;
+        const next = value.map((v) => {
+            const out = pinDropCaps(v, dpi);
+            if (out !== v)
+                changed = true;
+            return out;
+        });
+        return changed ? next : value;
+    }
+    if (!isRecord(value))
+        return value;
+    let out = value;
+    for (const [key, v] of Object.entries(value)) {
+        const next = pinDropCaps(v, dpi);
+        if (next === v)
+            continue;
+        if (out === value)
+            out = { ...value };
+        out[key] = next;
+    }
+    const dropCap = out.dropCap;
+    if (out.kind === 'text' && isRecord(dropCap) && dropCap.fontSize === undefined) {
+        const size = legacyDropCapSize(out, dropCap, dpi);
+        if (size)
+            out = { ...out, dropCap: { ...dropCap, fontSize: size } };
+    }
+    return out;
+}
+/**
+ * A configuration written before postext 1.5, pinned to the drop caps it
+ * laid out then. Up to 1.4 a design text's `dropCap` that named no
+ * `fontSize` was as tall as the line boxes it spans over 0.72 (the share of
+ * the size its capitals take), so its top stood above the capitals of the
+ * first line; today's default brings the two level. Every such drop cap,
+ * in whatever design it sits (running heads, heading designs and styles,
+ * part pages, the contents' part rows), gets that size written out: in the
+ * unit of the element's leading when that is a length, else in the unit of
+ * its font size, at the size 1.4 set at the document's `page.dpi` (to the
+ * last digit in most cases, and never more than a rounding step or two
+ * away). A configuration with none is returned as it is (the same object).
+ */
+export function pinLegacyDropCapSize(config) {
+    const dpi = isRecord(config.page) && typeof config.page.dpi === 'number' && config.page.dpi > 0
+        ? config.page.dpi
+        : DEFAULT_PAGE_CONFIG.dpi;
+    return pinDropCaps(config, dpi);
+}
+/** A heading line of markdown, its title in group 1. The block parser
+ *  trims a line before it reads a heading, so any indent will do. */
+const HEADING_LINE_RE = /^[^\S\n]*#{1,6}[^\S\n]+(.*)$/gm;
+/** A mark a heading's title may carry: `*`, `_`, `^`, `~`, `:smallcaps[`
+ *  or the `](` of a link. */
+const HEADING_MARK_RE = /[*_^~]|:smallcaps\[|\]\(/;
+/** The trailing `{…}` attributes of a heading line. */
+const HEADING_ATTRS_TAIL_RE = /\s*\{[^{}]*\}\s*$/;
+/** Whether markdown may hold a heading whose title carries an inline mark
+ *  (its attributes left out). Unknown content (undefined) may. */
+function mayHaveHeadingMarks(content) {
+    if (content === undefined)
+        return true;
+    const test = (text) => {
+        for (const m of text.matchAll(HEADING_LINE_RE)) {
+            if (HEADING_MARK_RE.test(m[1].replace(HEADING_ATTRS_TAIL_RE, '')))
+                return true;
+        }
+        return false;
+    };
+    return typeof content === 'string' ? test(content) : content.some(test);
+}
+/** Whether markdown may hold a heading, which is all a paragraph keeps
+ *  with. Unknown content (undefined) may. */
+function mayHaveHeadings(content) {
+    if (content === undefined)
+        return true;
+    const test = (text) => new RegExp(HEADING_LINE_RE.source, 'm').test(text);
+    return typeof content === 'string' ? test(content) : content.some(test);
+}
+/** A `::resource{id="…"}` embed alone on its line, as the block parser
+ *  reads one (the line trimmed): a mention in running text or in a code
+ *  span embeds nothing. */
+const RESOURCE_EMBED_LINE_RE = /^[^\S\n]*::resource[^\S\n]*\{id="[^"\n]+"\}[^\S\n]*$/m;
+/** The same, for one line. */
+const RESOURCE_EMBED_RE = /^[^\S\n]*::resource[^\S\n]*\{id="[^"\n]+"\}[^\S\n]*$/;
+/** A container's opening fence (`:::callout{…}`) and its bare closing
+ *  fence, as the block parser reads them (the line trimmed). */
+const FENCE_OPEN_RE = /^:::\s*([a-z][a-z0-9-]*)\s*(?:\{[^}]*\})?\s*$/;
+const FENCE_CLOSE_RE = /^:::\s*$/;
+/** A `:::callout` opening fence on a line of its own, as the block parser
+ *  reads one (the line trimmed). */
+const CALLOUT_FENCE_LINE_RE = /^[^\S\n]*:::[^\S\n]*callout[^\S\n]*(?:\{[^}\n]*\})?[^\S\n]*$/m;
+/** Whether markdown may hold a box, which is all that splits by the box
+ *  cut rules. Unknown content (undefined) may. */
+function mayHaveBoxes(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return CALLOUT_FENCE_LINE_RE.test(content);
+    return content.some((text) => CALLOUT_FENCE_LINE_RE.test(text));
+}
+/** Whether markdown embeds a resource inside a box: a `::resource` line
+ *  while a `:::callout` fence is open. */
+function embedsResourceInBox(text) {
+    if (!RESOURCE_EMBED_LINE_RE.test(text))
+        return false;
+    const open = [];
+    let boxes = 0;
+    for (const raw of text.split('\n')) {
+        const line = raw.trim();
+        const fence = FENCE_OPEN_RE.exec(line);
+        if (fence && KNOWN_CONTAINERS.has(fence[1])) {
+            const box = fence[1] === 'callout';
+            open.push(box);
+            if (box)
+                boxes++;
+        }
+        else if (open.length > 0 && FENCE_CLOSE_RE.test(line)) {
+            if (open.pop())
+                boxes--;
+        }
+        else if (boxes > 0 && RESOURCE_EMBED_RE.test(line)) {
+            return true;
+        }
+    }
+    return false;
+}
+/** `MigrateConfigOptions.content` as a string or an array. Both checks
+ *  below read it, and an iterator (a generator, a Map's `values()`) can be
+ *  walked only once, so the migrations take its texts into an array first. */
+function readContent(content) {
+    return content === undefined || typeof content === 'string' ? content : [...content];
+}
+/** Whether markdown may embed a resource inline: only a `::resource`
+ *  directive on a line of its own does. Unknown content (undefined) may. */
+function mayEmbedResources(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return RESOURCE_EMBED_LINE_RE.test(content);
+    return content.some((text) => RESOURCE_EMBED_LINE_RE.test(text));
+}
+/** Whether markdown may embed a resource inside a box. Unknown content
+ *  (undefined) may. */
+function mayEmbedResourcesInBoxes(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return embedsResourceInBox(content);
+    return content.some(embedsResourceInBox);
+}
+/** Whether markdown may introduce a list with a colon. Unknown content
+ *  (undefined) may. */
+function mayLeadListWithColon(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return COLON_LIST_RE.test(content);
+    return content.some((text) => COLON_LIST_RE.test(text));
+}
+/** Whether markdown sets maths: a formula is written between `$` signs.
+ *  Unknown content (undefined) may. */
+function mayHaveMaths(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return content.includes('$');
+    return content.some((text) => text.includes('$'));
+}
+/**
+ * A configuration stored under `configVersion` (see {@link CONFIG_VERSION}),
+ * in today's terms. One with no version (a number is expected; anything
+ * else counts as none) or one older than 3 has its heading breaks pinned by
+ * {@link pinLegacyHeadingBreaks}; one older than 4 has its maths size
+ * pinned by {@link pinLegacyMathSize}, unless `options.content` shows it
+ * sets no maths; one older than 5 has its inline gap pinned by {@link
+ * pinLegacyInlineGap}, unless `options.content` shows it embeds no
+ * resource; one older than 6 has its heading marks pinned by {@link
+ * pinLegacyHeadingMarks}, unless `options.content` shows no heading
+ * carries one, its drop caps by {@link pinLegacyDropCapSize}, its
+ * colon-list room by {@link pinLegacyColonListRoom}, unless
+ * `options.content` shows no list introduced by a colon, and its box gap
+ * by {@link pinLegacyBoxResourceGap}, unless `options.content` shows it
+ * embeds no resource inside a box, and its box cut by {@link
+ * pinLegacyBoxChildCut}, unless `options.content` shows it holds no box;
+ * one older than 7 has its dash breaks pinned by {@link
+ * pinLegacyDashBreaks}, unless `options.content` shows no closed dash, and
+ * its ragged breaking by {@link pinLegacyRaggedBreaking}, when it sets some
+ * running text ragged; one older than 8 has its split under a heading
+ * pinned by {@link pinLegacyHeadingSplit}, unless `options.content` shows
+ * no heading, the space under its `:::paragraphs` containers by {@link
+ * pinLegacyParagraphContainerSpacing}, when it declares a paragraph style,
+ * unless `options.content` shows no such container, and its compound
+ * breaks by {@link pinLegacyHyphenBreaks}, unless `options.content` shows
+ * no compound. A current one is returned as it is (the same object).
+ * Migrate a stored configuration once and store it again under
+ * `CONFIG_VERSION`: the maths pin multiplies a scale, so a configuration
+ * read twice under its old number would grow twice.
+ */
+export function migrateConfig(config, configVersion, options = {}) {
+    const rules = rulesOf(configVersion);
+    let out = rules < HEADING_BREAK_RULES ? pinLegacyHeadingBreaks(config) : config;
+    const content = rules < CONFIG_VERSION ? readContent(options.content) : undefined;
+    if (rules < MATH_SIZE_RULES && mayHaveMaths(content))
+        out = pinLegacyMathSize(out);
+    if (rules < INLINE_GAP_RULES && mayEmbedResources(content))
+        out = pinLegacyInlineGap(out);
+    if (rules < HEADING_MARKS_RULES && mayHaveHeadingMarks(content))
+        out = pinLegacyHeadingMarks(out);
+    if (rules < DROP_CAP_SIZE_RULES)
+        out = pinLegacyDropCapSize(out);
+    if (rules < COLON_LIST_ROOM_RULES && mayLeadListWithColon(content))
+        out = pinLegacyColonListRoom(out);
+    if (rules < BOX_GAP_RULES && mayEmbedResourcesInBoxes(content))
+        out = pinLegacyBoxResourceGap(out);
+    if (rules < BOX_CHILD_CUT_RULES && mayHaveBoxes(content))
+        out = pinLegacyBoxChildCut(out);
+    if (rules < DASH_BREAK_RULES && mayHaveClosedDashes(content))
+        out = pinLegacyDashBreaks(out);
+    if (rules < RAGGED_BREAKING_RULES)
+        out = pinLegacyRaggedBreaking(out);
+    if (rules < HEADING_SPLIT_RULES && mayHaveHeadings(content))
+        out = pinLegacyHeadingSplit(out);
+    if (rules < PARAGRAPH_CONTAINER_RULES && mayHaveParagraphContainers(content))
+        out = pinLegacyParagraphContainerSpacing(out);
+    if (rules < HYPHEN_BREAK_RULES && mayHaveCompounds(content))
+        out = pinLegacyHyphenBreaks(out);
+    return out;
+}
+/**
+ * A bundle's configuration in today's terms: `base` (the reader's own)
+ * under the manifest's `config` and the locale's overrides, both stored
+ * under `configVersion`. Top-level keys replace one another wholesale, so
+ * the heading breaks are pinned layer by layer (the base's are taken as
+ * they are) and the maths size once, on the `math` the layers leave in
+ * force — the size 1.4 set this bundle's formulas at, whichever layer
+ * named it, the base included when neither the manifest nor the locale
+ * names one. The inline gap, the box gap and the box cut are pinned the
+ * same way, on the `layout` in force, the colon-list room, the dash
+ * breaks, the compound breaks, the ragged breaking and the space under
+ * `:::paragraphs` containers on the `bodyText` in force (the ragged
+ * breaking when the merged configuration sets some running text ragged,
+ * the container space when it declares a paragraph style), the heading
+ * marks and the split under a heading on the `headings` in force, and the
+ * drop caps wherever they sit in the merged configuration.
+ * @internal `readBundle`'s; hosts call {@link migrateConfig}.
+ */
+export function migrateBundleConfig(base, layers, configVersion, options = {}) {
+    const rules = rulesOf(configVersion);
+    let merged = { ...base };
+    for (const layer of layers) {
+        Object.assign(merged, rules < HEADING_BREAK_RULES ? pinLegacyHeadingBreaks(layer) : layer);
+    }
+    const content = rules < CONFIG_VERSION ? readContent(options.content) : undefined;
+    if (rules < MATH_SIZE_RULES && mayHaveMaths(content))
+        merged = pinLegacyMathSize(merged);
+    if (rules < INLINE_GAP_RULES && mayEmbedResources(content))
+        merged = pinLegacyInlineGap(merged);
+    if (rules < HEADING_MARKS_RULES && mayHaveHeadingMarks(content))
+        merged = pinLegacyHeadingMarks(merged);
+    if (rules < DROP_CAP_SIZE_RULES)
+        merged = pinLegacyDropCapSize(merged);
+    if (rules < COLON_LIST_ROOM_RULES && mayLeadListWithColon(content))
+        merged = pinLegacyColonListRoom(merged);
+    if (rules < BOX_GAP_RULES && mayEmbedResourcesInBoxes(content))
+        merged = pinLegacyBoxResourceGap(merged);
+    if (rules < BOX_CHILD_CUT_RULES && mayHaveBoxes(content))
+        merged = pinLegacyBoxChildCut(merged);
+    if (rules < DASH_BREAK_RULES && mayHaveClosedDashes(content))
+        merged = pinLegacyDashBreaks(merged);
+    if (rules < RAGGED_BREAKING_RULES)
+        merged = pinLegacyRaggedBreaking(merged);
+    if (rules < HEADING_SPLIT_RULES && mayHaveHeadings(content))
+        merged = pinLegacyHeadingSplit(merged);
+    if (rules < PARAGRAPH_CONTAINER_RULES && mayHaveParagraphContainers(content))
+        merged = pinLegacyParagraphContainerSpacing(merged);
+    if (rules < HYPHEN_BREAK_RULES && mayHaveCompounds(content))
+        merged = pinLegacyHyphenBreaks(merged);
+    return merged;
+}
+//# sourceMappingURL=configVersion.js.map