postext 1.24.0 → 1.25.1

package/dist/bundle/configVersion.d.ts

@@ -1,7 +1,7 @@
 import type { PostextConfig } from '../types';
 /**
- * The configuration rules this engine writes: 10 since the #620 follow-up
- * (9 from postext 1.23, 8 from 1.5). Thirteen rules changed in 1.5 and
+ * The configuration rules this engine writes: 11 since #632 (10 from
+ * postext 1.24, 9 from 1.23, 8 from 1.5). Thirteen rules changed in 1.5 and
  * more since, and a configuration
  * stored under an older
  * number (or none) is read through {@link migrateConfig}:
@@ -78,6 +78,32 @@ import type { PostextConfig } from '../types';
  *   - a text element of a heading design or a part page that sets no
  *     `overflow` wraps onto more lines (#628), where up to 1.23 it was cut
  *     with an ellipsis ({@link pinLegacyDesignOverflow}).
+ * - 11, seven rules:
+ *   - a horizontal page on a character grid (`cjk.grid.enabled`) is not
+ *     balanced unless `headings.balancing.enabled` says so (#632), where
+ *     up to 1.24 it was ({@link pinLegacyGridBalancing});
+ *   - a table placed `here` follows its style's `overflow`
+ *     (`tableStyle.splitInline`, #634): one that does not fit the room
+ *     left in its column is cut between rows, where up to 1.24 it moved
+ *     whole to the next column ({@link pinLegacyInlineTableSplit});
+ *   - a `:::columns` fence outside a box sets its blocks in sub-columns,
+ *     and a box that splits may cut inside a group (`layout.flowColumns`,
+ *     #634), where up to 1.24 such a fence was ignored and a box never cut
+ *     inside a group ({@link pinLegacyFlowColumns});
+ *   - a line breaks inside a book title only where two of its characters
+ *     stand on either side (`cjk.titleMinChars: 2`, #637), where up to
+ *     1.24 it could leave one ({@link pinLegacyTitleBreaks});
+ *   - the circled numbers ①–⑳ and their kin are Chinese characters in CJK
+ *     text (`cjk.circledNumbers: 'cjk'`, #637), where up to 1.24 they were
+ *     Western letters ({@link pinLegacyCircledNumbers});
+ *   - a design text in Chinese or Japanese takes the body's CJK rules
+ *     (`cjk.composeDesignText`, #637), where up to 1.24 it was wrapped at
+ *     spaces with every mark at its own advance ({@link
+ *     pinLegacyDesignText});
+ *   - under a page-span opener set over several text columns, the head of
+ *     the opener's own column is a slot for a top float
+ *     (`layout.floatsUnderOpener`, #639), where up to 1.24 such a float
+ *     landed from the second column on ({@link pinLegacyOpenerHeadFloats}).
  *
  * 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
@@ -88,9 +114,11 @@ import type { PostextConfig } from '../types';
  * version-8 pins, under 7 the version-8 pins. One stored under 8 was
  * written by postext 1.5 to 1.22 and gets the version-9 pins (which every
  * older one gets too); one stored under 9 was written by postext 1.23 and
- * gets the version-10 pins (which every older one gets too).
+ * gets the version-10 pins (which every older one gets too); one stored
+ * under 10 was written by postext 1.24 and gets the version-11 pins (which
+ * every older one gets too).
  */
-export declare const CONFIG_VERSION = 10;
+export declare const CONFIG_VERSION = 11;
 /**
  * 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
@@ -247,6 +275,45 @@ export declare function pinLegacyVerseTightening<T extends Partial<PostextConfig
  * same object).
  */
 export declare function pinLegacyDesignOverflow<T extends Partial<PostextConfig>>(config: T): T;
+/**
+ * A configuration written before #632 (postext 1.24 or earlier), pinned to
+ * the way 1.24 balanced a horizontal page on a character grid: a config
+ * with `cjk.grid.enabled` in horizontal text that does not set
+ * `headings.balancing.enabled` gets `true`, where today such a page is
+ * not balanced by default. (The levers it runs keep every character in
+ * its cell now, which 1.24's loose paragraphs did not.) A vertical one
+ * was not balanced then either, and any other configuration is returned
+ * as it is (the same object).
+ */
+export declare function pinLegacyGridBalancing<T extends Partial<PostextConfig>>(config: T): T;
+/**
+ * A configuration written before #634 (postext 1.24 or earlier), pinned to
+ * the way 1.24 placed a table set `here`: `tableStyle.splitInline: false`,
+ * so an inline table that does not fit the room left in its column moves
+ * whole to the next one, where today it is cut between rows. The named
+ * table styles inherit it. A configuration that sets `splitInline` is
+ * returned as it is (the same object).
+ */
+export declare function pinLegacyInlineTableSplit<T extends Partial<PostextConfig>>(config: T): T;
+/**
+ * A configuration written before #634 (postext 1.24 or earlier), pinned to
+ * the way 1.24 read `:::columns`: `layout.flowColumns: false`, so a fence
+ * outside a box is ignored (its blocks run at the full measure) and a box
+ * that splits never cuts inside a group, where today the one sets its
+ * blocks in sub-columns and the other cuts between them. A configuration
+ * that sets `flowColumns` is returned as it is (the same object).
+ */
+export declare function pinLegacyFlowColumns<T extends Partial<PostextConfig>>(config: T): T;
+/**
+ * A configuration written before #639 (postext 1.24 or earlier), pinned to
+ * the slots 1.24 offered under a page-span opener:
+ * `layout.floatsUnderOpener: false`, so a float fenced or embedded right
+ * after an opener set over several text columns lands from the second
+ * column on, where today it takes the head of the opener's own column,
+ * under its band. A configuration that sets `floatsUnderOpener` is
+ * returned as it is (the same object).
+ */
+export declare function pinLegacyOpenerHeadFloats<T extends Partial<PostextConfig>>(config: T): T;
 /**
  * A configuration written before #620 (postext 1.22 or earlier), pinned to
  * the indents of its paragraph styles: a style that sets both
@@ -297,6 +364,33 @@ export declare function pinLegacyHeadingMarks<T extends Partial<PostextConfig>>(
  * away). A configuration with none is returned as it is (the same object).
  */
 export declare function pinLegacyDropCapSize<T extends Partial<PostextConfig>>(config: T): T;
+/**
+ * A configuration written before #637 (postext 1.24 or earlier), pinned to
+ * the way 1.24 broke lines inside a book title: `cjk.titleMinChars: 1`, a
+ * line breaking anywhere in a `《…》` or `〈…〉` title the level allows
+ * (`《說|文》`), where today two characters of it stand on either side of a
+ * break. A configuration that sets `titleMinChars` is returned as it is
+ * (the same object).
+ */
+export declare function pinLegacyTitleBreaks<T extends Partial<PostextConfig>>(config: T): T;
+/**
+ * A configuration written before #637 (postext 1.24 or earlier), pinned to
+ * the way 1.24 set the circled numbers ①–⑳ and their kin in CJK text:
+ * `cjk.circledNumbers: 'western'`, as Western letters with the Han–Latin
+ * space on both sides and a line free to end on one, where today they are
+ * Chinese characters kept off a line end. A configuration that sets
+ * `circledNumbers` is returned as it is (the same object).
+ */
+export declare function pinLegacyCircledNumbers<T extends Partial<PostextConfig>>(config: T): T;
+/**
+ * A configuration written before #637 (postext 1.24 or earlier), pinned to
+ * the way 1.24 set design text in Chinese or Japanese (openers, heading
+ * designs, running heads, page designs): `cjk.composeDesignText: false`,
+ * wrapped at spaces with every mark at the font's own advance, where
+ * today it takes the body's CJK rules. A configuration that sets
+ * `composeDesignText` is returned as it is (the same object).
+ */
+export declare function pinLegacyDesignText<T extends Partial<PostextConfig>>(config: T): T;
 export interface MigrateConfigOptions {
     /**
      * The markdown the configuration lays out (a bundle's chapters, a book's),
@@ -328,7 +422,14 @@ export interface MigrateConfigOptions {
      * and text with no ```` ``` ```` or `~~~` fence is not given the 1.22
      * reading of fences (see {@link pinLegacyCodeBlocks}); and text with no
      * poem set line by line is not given the 1.23 turnovers (see {@link
-     * pinLegacyVerseTightening}).
+     * pinLegacyVerseTightening}); and text with no book title is not given
+     * the 1.24 title breaks (see {@link pinLegacyTitleBreaks}), text with no
+     * circled number not the 1.24 Western circled numbers (see {@link
+     * pinLegacyCircledNumbers}), and text with no CJK (in a configuration
+     * whose own text holds none) not the 1.24 design text (see {@link
+     * pinLegacyDesignText}); and text with no heading (in a configuration
+     * that sets a page-span heading) is not given the 1.24 slots under an
+     * opener (see {@link pinLegacyOpenerHeadFloats}).
      * That keeps a stored configuration as
      * short as it was. Without it the size is pinned whenever maths is on,
      * and the gaps, the room, the heading marks, the box cut, the dash
@@ -375,9 +476,20 @@ export interface MigrateConfigOptions {
  * pinLegacyCodeBlocks}, unless `options.content` shows none; one older
  * than 10 has its verse turnovers pinned by {@link
  * pinLegacyVerseTightening}, unless `options.content` shows no poem set
- * line by line, and the text elements of its heading and part designs
- * that set no `overflow` by {@link pinLegacyDesignOverflow}. A current one
- * is returned as it is (the same object).
+ * line by line, the text elements of its heading and part designs
+ * that set no `overflow` by {@link pinLegacyDesignOverflow}; one older
+ * than 11 has the balancing of a horizontal page on a character grid
+ * pinned by {@link pinLegacyGridBalancing}, and its inline tables by {@link
+ * pinLegacyInlineTableSplit}, unless `options.content` shows it embeds no
+ * resource, its `:::columns` groups by {@link pinLegacyFlowColumns},
+ * unless `options.content` shows none, its book titles by {@link pinLegacyTitleBreaks}, unless
+ * `options.content` shows none, its circled numbers by {@link
+ * pinLegacyCircledNumbers}, unless `options.content` shows none, and its
+ * design text by {@link pinLegacyDesignText}, unless neither
+ * `options.content` nor the configuration holds CJK text, and the slots
+ * under its page-span openers by {@link pinLegacyOpenerHeadFloats}, when
+ * it sets a heading level or style with `span: 'page'`, unless
+ * `options.content` shows no heading. 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.
@@ -397,9 +509,14 @@ export declare function migrateConfig<T extends Partial<PostextConfig>>(config:
  * `:::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
+ * marks and the split under a heading on the `headings` in force, the
  * drop caps and the overflow of heading and part design texts wherever
- * they sit in the merged configuration.
+ * they sit in the merged configuration, the balancing of a horizontal
+ * character grid on the merged `cjk`, `layout` and `headings`, the
+ * inline tables on the `tableStyle` in force, the `:::columns` groups and
+ * the slots under a page-span opener on the `layout` in force (the slots
+ * when the merged configuration sets a page-span heading), and the book
+ * titles, the circled numbers and the design text on the `cjk` in force.
  * @internal `readBundle`'s; hosts call {@link migrateConfig}.
  */
 export declare function migrateBundleConfig(base: PostextConfig, layers: readonly PostextConfig[], configVersion: unknown, options?: MigrateConfigOptions): PostextConfig;

package/dist/bundle/configVersion.d.ts.map

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

package/dist/bundle/configVersion.js

@@ -9,9 +9,10 @@ import { DEFAULT_PAGE_CONFIG } from '../defaults/page';
 import { dimensionToPx } from '../units';
 import { KNOWN_CONTAINERS } from '../parse/blockParser';
 import { codeFenceOpen } from '../parse/codeFence';
+import { hasCJK } from '../measure/cjk';
 /**
- * The configuration rules this engine writes: 10 since the #620 follow-up
- * (9 from postext 1.23, 8 from 1.5). Thirteen rules changed in 1.5 and
+ * The configuration rules this engine writes: 11 since #632 (10 from
+ * postext 1.24, 9 from 1.23, 8 from 1.5). Thirteen rules changed in 1.5 and
  * more since, and a configuration
  * stored under an older
  * number (or none) is read through {@link migrateConfig}:
@@ -88,6 +89,32 @@ import { codeFenceOpen } from '../parse/codeFence';
  *   - a text element of a heading design or a part page that sets no
  *     `overflow` wraps onto more lines (#628), where up to 1.23 it was cut
  *     with an ellipsis ({@link pinLegacyDesignOverflow}).
+ * - 11, seven rules:
+ *   - a horizontal page on a character grid (`cjk.grid.enabled`) is not
+ *     balanced unless `headings.balancing.enabled` says so (#632), where
+ *     up to 1.24 it was ({@link pinLegacyGridBalancing});
+ *   - a table placed `here` follows its style's `overflow`
+ *     (`tableStyle.splitInline`, #634): one that does not fit the room
+ *     left in its column is cut between rows, where up to 1.24 it moved
+ *     whole to the next column ({@link pinLegacyInlineTableSplit});
+ *   - a `:::columns` fence outside a box sets its blocks in sub-columns,
+ *     and a box that splits may cut inside a group (`layout.flowColumns`,
+ *     #634), where up to 1.24 such a fence was ignored and a box never cut
+ *     inside a group ({@link pinLegacyFlowColumns});
+ *   - a line breaks inside a book title only where two of its characters
+ *     stand on either side (`cjk.titleMinChars: 2`, #637), where up to
+ *     1.24 it could leave one ({@link pinLegacyTitleBreaks});
+ *   - the circled numbers ①–⑳ and their kin are Chinese characters in CJK
+ *     text (`cjk.circledNumbers: 'cjk'`, #637), where up to 1.24 they were
+ *     Western letters ({@link pinLegacyCircledNumbers});
+ *   - a design text in Chinese or Japanese takes the body's CJK rules
+ *     (`cjk.composeDesignText`, #637), where up to 1.24 it was wrapped at
+ *     spaces with every mark at its own advance ({@link
+ *     pinLegacyDesignText});
+ *   - under a page-span opener set over several text columns, the head of
+ *     the opener's own column is a slot for a top float
+ *     (`layout.floatsUnderOpener`, #639), where up to 1.24 such a float
+ *     landed from the second column on ({@link pinLegacyOpenerHeadFloats}).
  *
  * 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
@@ -98,9 +125,11 @@ import { codeFenceOpen } from '../parse/codeFence';
  * version-8 pins, under 7 the version-8 pins. One stored under 8 was
  * written by postext 1.5 to 1.22 and gets the version-9 pins (which every
  * older one gets too); one stored under 9 was written by postext 1.23 and
- * gets the version-10 pins (which every older one gets too).
+ * gets the version-10 pins (which every older one gets too); one stored
+ * under 10 was written by postext 1.24 and gets the version-11 pins (which
+ * every older one gets too).
  */
-export const CONFIG_VERSION = 10;
+export const CONFIG_VERSION = 11;
 /** 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. */
@@ -147,6 +176,22 @@ const VERSE_TIGHTEN_RULES = 10;
 /** The rules that wrap a heading or part design text that sets no
  *  `overflow`. */
 const DESIGN_OVERFLOW_RULES = 10;
+/** The rules that leave a horizontal page on a character grid unbalanced
+ *  by default. */
+const GRID_BALANCING_RULES = 11;
+/** The rules that keep two characters of a book title on either side of a
+ *  line break, set circled numbers as Chinese characters and compose CJK
+ *  design text (#637). */
+const TITLE_BREAK_RULES = 11;
+const CIRCLED_NUMBER_RULES = 11;
+const DESIGN_TEXT_RULES = 11;
+/** The rules that cut an inline table between rows. */
+const INLINE_TABLE_SPLIT_RULES = 11;
+/** The rules that set `:::columns` in the running text and cut groups. */
+const FLOW_COLUMNS_RULES = 11;
+/** The rules that offer a float the head of a page-span opener's own
+ *  column. */
+const OPENER_HEAD_FLOAT_RULES = 11;
 /** 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;
@@ -573,6 +618,88 @@ export function pinLegacyDesignOverflow(config) {
     }
     return out;
 }
+/**
+ * A configuration written before #632 (postext 1.24 or earlier), pinned to
+ * the way 1.24 balanced a horizontal page on a character grid: a config
+ * with `cjk.grid.enabled` in horizontal text that does not set
+ * `headings.balancing.enabled` gets `true`, where today such a page is
+ * not balanced by default. (The levers it runs keep every character in
+ * its cell now, which 1.24's loose paragraphs did not.) A vertical one
+ * was not balanced then either, and any other configuration is returned
+ * as it is (the same object).
+ */
+export function pinLegacyGridBalancing(config) {
+    if (!isRecord(config.cjk) || !isRecord(config.cjk.grid) || config.cjk.grid.enabled !== true)
+        return config;
+    if (isRecord(config.layout) && config.layout.writingMode === 'vertical-rl')
+        return config;
+    const headings = isRecord(config.headings) ? config.headings : {};
+    const balancing = isRecord(headings.balancing) ? headings.balancing : {};
+    if (balancing.enabled !== undefined)
+        return config;
+    return { ...config, headings: { ...headings, balancing: { ...balancing, enabled: true } } };
+}
+/**
+ * A configuration written before #634 (postext 1.24 or earlier), pinned to
+ * the way 1.24 placed a table set `here`: `tableStyle.splitInline: false`,
+ * so an inline table that does not fit the room left in its column moves
+ * whole to the next one, where today it is cut between rows. The named
+ * table styles inherit it. A configuration that sets `splitInline` is
+ * returned as it is (the same object).
+ */
+export function pinLegacyInlineTableSplit(config) {
+    const tableStyle = isRecord(config.tableStyle) ? config.tableStyle : {};
+    if (tableStyle.splitInline !== undefined)
+        return config;
+    return { ...config, tableStyle: { ...tableStyle, splitInline: false } };
+}
+/**
+ * A configuration written before #634 (postext 1.24 or earlier), pinned to
+ * the way 1.24 read `:::columns`: `layout.flowColumns: false`, so a fence
+ * outside a box is ignored (its blocks run at the full measure) and a box
+ * that splits never cuts inside a group, where today the one sets its
+ * blocks in sub-columns and the other cuts between them. A configuration
+ * that sets `flowColumns` is returned as it is (the same object).
+ */
+export function pinLegacyFlowColumns(config) {
+    const layout = isRecord(config.layout) ? config.layout : {};
+    if (layout.flowColumns !== undefined)
+        return config;
+    return { ...config, layout: { ...layout, flowColumns: false } };
+}
+/**
+ * A configuration written before #639 (postext 1.24 or earlier), pinned to
+ * the slots 1.24 offered under a page-span opener:
+ * `layout.floatsUnderOpener: false`, so a float fenced or embedded right
+ * after an opener set over several text columns lands from the second
+ * column on, where today it takes the head of the opener's own column,
+ * under its band. A configuration that sets `floatsUnderOpener` is
+ * returned as it is (the same object).
+ */
+export function pinLegacyOpenerHeadFloats(config) {
+    const layout = isRecord(config.layout) ? config.layout : {};
+    if (layout.floatsUnderOpener !== undefined)
+        return config;
+    return { ...config, layout: { ...layout, floatsUnderOpener: false } };
+}
+/** Whether a configuration sets a page-span heading: a heading level or a
+ *  heading style with `span: 'page'` (no level spans the page by
+ *  default). */
+function setsPageSpanHeading(config) {
+    const spans = (entries) => Array.isArray(entries) && entries.some((e) => isRecord(e) && e.span === 'page');
+    return (isRecord(config.headings) && spans(config.headings.levels)) || spans(config.headingStyles);
+}
+/** A `:::columns` opening fence on a line of its own. */
+const COLUMNS_FENCE_LINE_RE = /^[^\S\n]*:::[^\S\n]*columns[^\S\n]*(?:\{[^}\n]*\})?[^\S\n]*$/m;
+/** Whether markdown may hold a `:::columns` group. Unknown content
+ *  (undefined) may. */
+function mayHaveColumnGroups(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return COLUMNS_FENCE_LINE_RE.test(content);
+    return content.some((text) => COLUMNS_FENCE_LINE_RE.test(text));
+}
 /** Whether markdown holds a poem set line by line: a `:::verse` fence
  *  naming `layout=lines`, or naming no layout over lines with no
  *  hemistich separator, unless the configuration sets such poems as
@@ -1028,6 +1155,86 @@ function mayHaveMaths(content) {
         return content.includes('$');
     return content.some((text) => text.includes('$'));
 }
+/** The `cjk` of a configuration, `{}` when it has none. */
+function cjkOf(config) {
+    return isRecord(config.cjk) ? config.cjk : {};
+}
+/**
+ * A configuration written before #637 (postext 1.24 or earlier), pinned to
+ * the way 1.24 broke lines inside a book title: `cjk.titleMinChars: 1`, a
+ * line breaking anywhere in a `《…》` or `〈…〉` title the level allows
+ * (`《說|文》`), where today two characters of it stand on either side of a
+ * break. A configuration that sets `titleMinChars` is returned as it is
+ * (the same object).
+ */
+export function pinLegacyTitleBreaks(config) {
+    const cjk = cjkOf(config);
+    if (cjk.titleMinChars !== undefined)
+        return config;
+    return { ...config, cjk: { ...cjk, titleMinChars: 1 } };
+}
+/**
+ * A configuration written before #637 (postext 1.24 or earlier), pinned to
+ * the way 1.24 set the circled numbers ①–⑳ and their kin in CJK text:
+ * `cjk.circledNumbers: 'western'`, as Western letters with the Han–Latin
+ * space on both sides and a line free to end on one, where today they are
+ * Chinese characters kept off a line end. A configuration that sets
+ * `circledNumbers` is returned as it is (the same object).
+ */
+export function pinLegacyCircledNumbers(config) {
+    const cjk = cjkOf(config);
+    if (cjk.circledNumbers !== undefined)
+        return config;
+    return { ...config, cjk: { ...cjk, circledNumbers: 'western' } };
+}
+/**
+ * A configuration written before #637 (postext 1.24 or earlier), pinned to
+ * the way 1.24 set design text in Chinese or Japanese (openers, heading
+ * designs, running heads, page designs): `cjk.composeDesignText: false`,
+ * wrapped at spaces with every mark at the font's own advance, where
+ * today it takes the body's CJK rules. A configuration that sets
+ * `composeDesignText` is returned as it is (the same object).
+ */
+export function pinLegacyDesignText(config) {
+    const cjk = cjkOf(config);
+    if (cjk.composeDesignText !== undefined)
+        return config;
+    return { ...config, cjk: { ...cjk, composeDesignText: false } };
+}
+/** A book title in brackets (《》 〈〉), or a `:book[…]` title. */
+const BOOK_TITLE_RE = /[《〈︽︿]|:book\[/;
+/** A circled, parenthesized or full-stop number or letter (①, ⑴, ⒈, ⓐ, ❶,
+ *  ➀). */
+const CIRCLED_RE = /[\u2460-\u24FF\u2776-\u2793]/;
+/** Whether markdown may set a book title. Unknown content (undefined)
+ *  may. */
+function mayHaveBookTitles(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return BOOK_TITLE_RE.test(content);
+    return content.some((text) => BOOK_TITLE_RE.test(text));
+}
+/** Whether markdown may set a circled number. Unknown content (undefined)
+ *  may. */
+function mayHaveCircledNumbers(content) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string')
+        return CIRCLED_RE.test(content);
+    return content.some((text) => CIRCLED_RE.test(text));
+}
+/** Whether a design text may hold CJK: the markdown it prints from (a
+ *  heading, an attribute, a running head) or the configuration's own text
+ *  (a literal in a design element, a label). Unknown content (undefined)
+ *  may. */
+function mayHaveCjkDesignText(content, config) {
+    if (content === undefined)
+        return true;
+    if (typeof content === 'string' ? hasCJK(content) : content.some(hasCJK))
+        return true;
+    return hasCJK(JSON.stringify(config));
+}
 /**
  * A configuration stored under `configVersion` (see {@link CONFIG_VERSION}),
  * in today's terms. One with no version (a number is expected; anything
@@ -1061,9 +1268,20 @@ function mayHaveMaths(content) {
  * pinLegacyCodeBlocks}, unless `options.content` shows none; one older
  * than 10 has its verse turnovers pinned by {@link
  * pinLegacyVerseTightening}, unless `options.content` shows no poem set
- * line by line, and the text elements of its heading and part designs
- * that set no `overflow` by {@link pinLegacyDesignOverflow}. A current one
- * is returned as it is (the same object).
+ * line by line, the text elements of its heading and part designs
+ * that set no `overflow` by {@link pinLegacyDesignOverflow}; one older
+ * than 11 has the balancing of a horizontal page on a character grid
+ * pinned by {@link pinLegacyGridBalancing}, and its inline tables by {@link
+ * pinLegacyInlineTableSplit}, unless `options.content` shows it embeds no
+ * resource, its `:::columns` groups by {@link pinLegacyFlowColumns},
+ * unless `options.content` shows none, its book titles by {@link pinLegacyTitleBreaks}, unless
+ * `options.content` shows none, its circled numbers by {@link
+ * pinLegacyCircledNumbers}, unless `options.content` shows none, and its
+ * design text by {@link pinLegacyDesignText}, unless neither
+ * `options.content` nor the configuration holds CJK text, and the slots
+ * under its page-span openers by {@link pinLegacyOpenerHeadFloats}, when
+ * it sets a heading level or style with `span: 'page'`, unless
+ * `options.content` shows no heading. 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.
@@ -1108,6 +1326,20 @@ export function migrateConfig(config, configVersion, options = {}) {
         out = pinLegacyVerseTightening(out);
     if (rules < DESIGN_OVERFLOW_RULES)
         out = pinLegacyDesignOverflow(out);
+    if (rules < GRID_BALANCING_RULES)
+        out = pinLegacyGridBalancing(out);
+    if (rules < TITLE_BREAK_RULES && mayHaveBookTitles(content))
+        out = pinLegacyTitleBreaks(out);
+    if (rules < CIRCLED_NUMBER_RULES && mayHaveCircledNumbers(content))
+        out = pinLegacyCircledNumbers(out);
+    if (rules < DESIGN_TEXT_RULES && mayHaveCjkDesignText(content, out))
+        out = pinLegacyDesignText(out);
+    if (rules < INLINE_TABLE_SPLIT_RULES && mayEmbedResources(content))
+        out = pinLegacyInlineTableSplit(out);
+    if (rules < FLOW_COLUMNS_RULES && mayHaveColumnGroups(content))
+        out = pinLegacyFlowColumns(out);
+    if (rules < OPENER_HEAD_FLOAT_RULES && setsPageSpanHeading(out) && mayHaveHeadings(content))
+        out = pinLegacyOpenerHeadFloats(out);
     return out;
 }
 /**
@@ -1124,9 +1356,14 @@ export function migrateConfig(config, configVersion, options = {}) {
  * `:::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
+ * marks and the split under a heading on the `headings` in force, the
  * drop caps and the overflow of heading and part design texts wherever
- * they sit in the merged configuration.
+ * they sit in the merged configuration, the balancing of a horizontal
+ * character grid on the merged `cjk`, `layout` and `headings`, the
+ * inline tables on the `tableStyle` in force, the `:::columns` groups and
+ * the slots under a page-span opener on the `layout` in force (the slots
+ * when the merged configuration sets a page-span heading), and the book
+ * titles, the circled numbers and the design text on the `cjk` in force.
  * @internal `readBundle`'s; hosts call {@link migrateConfig}.
  */
 export function migrateBundleConfig(base, layers, configVersion, options = {}) {
@@ -1172,6 +1409,20 @@ export function migrateBundleConfig(base, layers, configVersion, options = {}) {
         merged = pinLegacyVerseTightening(merged);
     if (rules < DESIGN_OVERFLOW_RULES)
         merged = pinLegacyDesignOverflow(merged);
+    if (rules < GRID_BALANCING_RULES)
+        merged = pinLegacyGridBalancing(merged);
+    if (rules < TITLE_BREAK_RULES && mayHaveBookTitles(content))
+        merged = pinLegacyTitleBreaks(merged);
+    if (rules < CIRCLED_NUMBER_RULES && mayHaveCircledNumbers(content))
+        merged = pinLegacyCircledNumbers(merged);
+    if (rules < DESIGN_TEXT_RULES && mayHaveCjkDesignText(content, merged))
+        merged = pinLegacyDesignText(merged);
+    if (rules < INLINE_TABLE_SPLIT_RULES && mayEmbedResources(content))
+        merged = pinLegacyInlineTableSplit(merged);
+    if (rules < FLOW_COLUMNS_RULES && mayHaveColumnGroups(content))
+        merged = pinLegacyFlowColumns(merged);
+    if (rules < OPENER_HEAD_FLOAT_RULES && setsPageSpanHeading(merged) && mayHaveHeadings(content))
+        merged = pinLegacyOpenerHeadFloats(merged);
     return merged;
 }
 //# sourceMappingURL=configVersion.js.map