@docx4j/core-ts 0.6.0 → 0.7.0

package/dist/model/text/caseMapping.generated.mjs

@@ -0,0 +1,214 @@
+// The simple uppercase mapping of Unicode 15.0.0 (UnicodeData.txt field 12; Java's Character.toUpperCase(int)), for
+// CaseMapping (CR-012 section 24.1, D4).
+//
+// Generated by scripts/generate-case-mapping.mjs from https://www.unicode.org/Public/15.0.0/ucd/UnicodeData.txt
+// (SHA-256 806e9aed65037197f1ec85e12be6e8cd870fc5608b4de0fffd990f689f376a73): 1450 code points in 200 runs.
+// Do not edit; run the script instead.
+/** The Unicode version of the table: a later case pair is unmapped until the table is regenerated (WD 0.52's REQ-607). */
+export const CASE_MAPPING_UNICODE_VERSION = '15.0.0';
+/**
+ * Runs of code points mapped by one delta: `start, end, delta, stride` each, by `start`; `end` is the run's last code
+ * point, and every `stride`th code point from `start` to it maps to itself plus `delta`.
+ */
+export const UPPERCASE_RUNS = [
+    0x61, 0x7A, -32, 1,
+    0xB5, 0xB5, 743, 1,
+    0xE0, 0xF6, -32, 1,
+    0xF8, 0xFE, -32, 1,
+    0xFF, 0xFF, 121, 1,
+    0x101, 0x12F, -1, 2,
+    0x131, 0x131, -232, 1,
+    0x133, 0x137, -1, 2,
+    0x13A, 0x148, -1, 2,
+    0x14B, 0x177, -1, 2,
+    0x17A, 0x17E, -1, 2,
+    0x17F, 0x17F, -300, 1,
+    0x180, 0x180, 195, 1,
+    0x183, 0x185, -1, 2,
+    0x188, 0x188, -1, 1,
+    0x18C, 0x18C, -1, 1,
+    0x192, 0x192, -1, 1,
+    0x195, 0x195, 97, 1,
+    0x199, 0x199, -1, 1,
+    0x19A, 0x19A, 163, 1,
+    0x19E, 0x19E, 130, 1,
+    0x1A1, 0x1A5, -1, 2,
+    0x1A8, 0x1A8, -1, 1,
+    0x1AD, 0x1AD, -1, 1,
+    0x1B0, 0x1B0, -1, 1,
+    0x1B4, 0x1B6, -1, 2,
+    0x1B9, 0x1B9, -1, 1,
+    0x1BD, 0x1BD, -1, 1,
+    0x1BF, 0x1BF, 56, 1,
+    0x1C5, 0x1C5, -1, 1,
+    0x1C6, 0x1C6, -2, 1,
+    0x1C8, 0x1C8, -1, 1,
+    0x1C9, 0x1C9, -2, 1,
+    0x1CB, 0x1CB, -1, 1,
+    0x1CC, 0x1CC, -2, 1,
+    0x1CE, 0x1DC, -1, 2,
+    0x1DD, 0x1DD, -79, 1,
+    0x1DF, 0x1EF, -1, 2,
+    0x1F2, 0x1F2, -1, 1,
+    0x1F3, 0x1F3, -2, 1,
+    0x1F5, 0x1F5, -1, 1,
+    0x1F9, 0x21F, -1, 2,
+    0x223, 0x233, -1, 2,
+    0x23C, 0x23C, -1, 1,
+    0x23F, 0x240, 10815, 1,
+    0x242, 0x242, -1, 1,
+    0x247, 0x24F, -1, 2,
+    0x250, 0x250, 10783, 1,
+    0x251, 0x251, 10780, 1,
+    0x252, 0x252, 10782, 1,
+    0x253, 0x253, -210, 1,
+    0x254, 0x254, -206, 1,
+    0x256, 0x257, -205, 1,
+    0x259, 0x259, -202, 1,
+    0x25B, 0x25B, -203, 1,
+    0x25C, 0x25C, 42319, 1,
+    0x260, 0x260, -205, 1,
+    0x261, 0x261, 42315, 1,
+    0x263, 0x263, -207, 1,
+    0x265, 0x265, 42280, 1,
+    0x266, 0x266, 42308, 1,
+    0x268, 0x268, -209, 1,
+    0x269, 0x269, -211, 1,
+    0x26A, 0x26A, 42308, 1,
+    0x26B, 0x26B, 10743, 1,
+    0x26C, 0x26C, 42305, 1,
+    0x26F, 0x26F, -211, 1,
+    0x271, 0x271, 10749, 1,
+    0x272, 0x272, -213, 1,
+    0x275, 0x275, -214, 1,
+    0x27D, 0x27D, 10727, 1,
+    0x280, 0x280, -218, 1,
+    0x282, 0x282, 42307, 1,
+    0x283, 0x283, -218, 1,
+    0x287, 0x287, 42282, 1,
+    0x288, 0x288, -218, 1,
+    0x289, 0x289, -69, 1,
+    0x28A, 0x28B, -217, 1,
+    0x28C, 0x28C, -71, 1,
+    0x292, 0x292, -219, 1,
+    0x29D, 0x29D, 42261, 1,
+    0x29E, 0x29E, 42258, 1,
+    0x345, 0x345, 84, 1,
+    0x371, 0x373, -1, 2,
+    0x377, 0x377, -1, 1,
+    0x37B, 0x37D, 130, 1,
+    0x3AC, 0x3AC, -38, 1,
+    0x3AD, 0x3AF, -37, 1,
+    0x3B1, 0x3C1, -32, 1,
+    0x3C2, 0x3C2, -31, 1,
+    0x3C3, 0x3CB, -32, 1,
+    0x3CC, 0x3CC, -64, 1,
+    0x3CD, 0x3CE, -63, 1,
+    0x3D0, 0x3D0, -62, 1,
+    0x3D1, 0x3D1, -57, 1,
+    0x3D5, 0x3D5, -47, 1,
+    0x3D6, 0x3D6, -54, 1,
+    0x3D7, 0x3D7, -8, 1,
+    0x3D9, 0x3EF, -1, 2,
+    0x3F0, 0x3F0, -86, 1,
+    0x3F1, 0x3F1, -80, 1,
+    0x3F2, 0x3F2, 7, 1,
+    0x3F3, 0x3F3, -116, 1,
+    0x3F5, 0x3F5, -96, 1,
+    0x3F8, 0x3F8, -1, 1,
+    0x3FB, 0x3FB, -1, 1,
+    0x430, 0x44F, -32, 1,
+    0x450, 0x45F, -80, 1,
+    0x461, 0x481, -1, 2,
+    0x48B, 0x4BF, -1, 2,
+    0x4C2, 0x4CE, -1, 2,
+    0x4CF, 0x4CF, -15, 1,
+    0x4D1, 0x52F, -1, 2,
+    0x561, 0x586, -48, 1,
+    0x10D0, 0x10FA, 3008, 1,
+    0x10FD, 0x10FF, 3008, 1,
+    0x13F8, 0x13FD, -8, 1,
+    0x1C80, 0x1C80, -6254, 1,
+    0x1C81, 0x1C81, -6253, 1,
+    0x1C82, 0x1C82, -6244, 1,
+    0x1C83, 0x1C84, -6242, 1,
+    0x1C85, 0x1C85, -6243, 1,
+    0x1C86, 0x1C86, -6236, 1,
+    0x1C87, 0x1C87, -6181, 1,
+    0x1C88, 0x1C88, 35266, 1,
+    0x1D79, 0x1D79, 35332, 1,
+    0x1D7D, 0x1D7D, 3814, 1,
+    0x1D8E, 0x1D8E, 35384, 1,
+    0x1E01, 0x1E95, -1, 2,
+    0x1E9B, 0x1E9B, -59, 1,
+    0x1EA1, 0x1EFF, -1, 2,
+    0x1F00, 0x1F07, 8, 1,
+    0x1F10, 0x1F15, 8, 1,
+    0x1F20, 0x1F27, 8, 1,
+    0x1F30, 0x1F37, 8, 1,
+    0x1F40, 0x1F45, 8, 1,
+    0x1F51, 0x1F57, 8, 2,
+    0x1F60, 0x1F67, 8, 1,
+    0x1F70, 0x1F71, 74, 1,
+    0x1F72, 0x1F75, 86, 1,
+    0x1F76, 0x1F77, 100, 1,
+    0x1F78, 0x1F79, 128, 1,
+    0x1F7A, 0x1F7B, 112, 1,
+    0x1F7C, 0x1F7D, 126, 1,
+    0x1F80, 0x1F87, 8, 1,
+    0x1F90, 0x1F97, 8, 1,
+    0x1FA0, 0x1FA7, 8, 1,
+    0x1FB0, 0x1FB1, 8, 1,
+    0x1FB3, 0x1FB3, 9, 1,
+    0x1FBE, 0x1FBE, -7205, 1,
+    0x1FC3, 0x1FC3, 9, 1,
+    0x1FD0, 0x1FD1, 8, 1,
+    0x1FE0, 0x1FE1, 8, 1,
+    0x1FE5, 0x1FE5, 7, 1,
+    0x1FF3, 0x1FF3, 9, 1,
+    0x214E, 0x214E, -28, 1,
+    0x2170, 0x217F, -16, 1,
+    0x2184, 0x2184, -1, 1,
+    0x24D0, 0x24E9, -26, 1,
+    0x2C30, 0x2C5F, -48, 1,
+    0x2C61, 0x2C61, -1, 1,
+    0x2C65, 0x2C65, -10795, 1,
+    0x2C66, 0x2C66, -10792, 1,
+    0x2C68, 0x2C6C, -1, 2,
+    0x2C73, 0x2C73, -1, 1,
+    0x2C76, 0x2C76, -1, 1,
+    0x2C81, 0x2CE3, -1, 2,
+    0x2CEC, 0x2CEE, -1, 2,
+    0x2CF3, 0x2CF3, -1, 1,
+    0x2D00, 0x2D25, -7264, 1,
+    0x2D27, 0x2D27, -7264, 1,
+    0x2D2D, 0x2D2D, -7264, 1,
+    0xA641, 0xA66D, -1, 2,
+    0xA681, 0xA69B, -1, 2,
+    0xA723, 0xA72F, -1, 2,
+    0xA733, 0xA76F, -1, 2,
+    0xA77A, 0xA77C, -1, 2,
+    0xA77F, 0xA787, -1, 2,
+    0xA78C, 0xA78C, -1, 1,
+    0xA791, 0xA793, -1, 2,
+    0xA794, 0xA794, 48, 1,
+    0xA797, 0xA7A9, -1, 2,
+    0xA7B5, 0xA7C3, -1, 2,
+    0xA7C8, 0xA7CA, -1, 2,
+    0xA7D1, 0xA7D1, -1, 1,
+    0xA7D7, 0xA7D9, -1, 2,
+    0xA7F6, 0xA7F6, -1, 1,
+    0xAB53, 0xAB53, -928, 1,
+    0xAB70, 0xABBF, -38864, 1,
+    0xFF41, 0xFF5A, -32, 1,
+    0x10428, 0x1044F, -40, 1,
+    0x104D8, 0x104FB, -40, 1,
+    0x10597, 0x105A1, -39, 1,
+    0x105A3, 0x105B1, -39, 1,
+    0x105B3, 0x105B9, -39, 1,
+    0x105BB, 0x105BC, -39, 1,
+    0x10CC0, 0x10CF2, -64, 1,
+    0x118C0, 0x118DF, -32, 1,
+    0x16E60, 0x16E7F, -32, 1,
+    0x1E922, 0x1E943, -34, 1,
+];

package/dist/model/text/index.d.mts

@@ -1,7 +1,8 @@
 export { Texts } from './Texts.mjs';
 export { TextContext, PackageTrees, type TextPackage } from './TextContext.mjs';
-export { TextOptions, TextOptionError, TEXT_OPTION_NAMES, type TextOptionsInit, type TextModelView, type TextInclude, type TextFields, type TextBindings, type TextSymbols, type TextMath, type TextTables, type TextMarkupDetail, type TextLayout, } from './TextOptions.mjs';
-export { TextResult, TextBlock, TextRun, TextRow, TextCell, TextField, TextNumbering, TextRevision, TextWarning, TextComment, TextImage, ImageDescription, AltTextDescriber, type ImageDescriber, type TextBlockKind, type TextStory, type TextRunKind, type NoteType, type TextRunSource, } from './TextResult.mjs';
+export { TextOptions, TextOptionError, TEXT_OPTION_NAMES, type TextOptionsInit, type TextModelView, type TextInclude, type TextFields, type TextBindings, type TextSymbols, type TextMath, type TextTables, type TextMarkupDetail, type TextLayout, type TextDropCaps, type TextSmallCaps, type TextRepair, type TextProfile, } from './TextOptions.mjs';
+export { TextResult, TextBlock, TextRun, TextRow, TextCell, TextField, TextNumbering, TextRevision, TextWarning, TextComment, TextImage, ImageDescription, AltTextDescriber, type ImageDescriber, type TextBlockKind, type TextStory, type TextRunKind, type NoteType, type TextRunSource, type TextVerticalAlignment, } from './TextResult.mjs';
 export { PlainText, INDENT_SPACES, LISTED_FORMAT_NOTE } from './PlainText.mjs';
+export { CaseMapping } from './CaseMapping.mjs';
 export { LinkTargets } from './LinkTargets.mjs';
 export { MarkdownExporter, MarkdownExportOptions, type MarkdownExportOptionsInit, type MarkdownImage, type MarkdownImageDestination, type MarkdownBlock, type MarkdownBlocks, } from './MarkdownExporter.mjs';

package/dist/model/text/index.mjs

@@ -4,5 +4,6 @@ export { TextContext, PackageTrees } from './TextContext.mjs';
 export { TextOptions, TextOptionError, TEXT_OPTION_NAMES, } from './TextOptions.mjs';
 export { TextResult, TextBlock, TextRun, TextRow, TextCell, TextField, TextNumbering, TextRevision, TextWarning, TextComment, TextImage, ImageDescription, AltTextDescriber, } from './TextResult.mjs';
 export { PlainText, INDENT_SPACES, LISTED_FORMAT_NOTE } from './PlainText.mjs';
+export { CaseMapping } from './CaseMapping.mjs';
 export { LinkTargets } from './LinkTargets.mjs';
 export { MarkdownExporter, MarkdownExportOptions, } from './MarkdownExporter.mjs';

package/dist/model/wordIntegers.d.mts

@@ -0,0 +1,29 @@
+import { type WordIntegerReading, type WordIntegerStorage } from '@docx4j/generated-objects-ts/helpers/wml';
+/** `[min, max]` in the attribute's own unit: every value in it Word reads as written, and none outside. */
+export type KeptRange = readonly [number, number];
+/** The certain range of an attribute the table has but no round measured: outside it every measured attribute of its type changes. */
+export declare const UNMEASURED_RANGE: KeptRange;
+/** Whether a reading is of an attribute no round measured (`storage` says so), as against one Word reads to no number. */
+export declare const isUnmeasured: (reading: WordIntegerReading) => boolean;
+/**
+ * The range Word 365 keeps as written in an attribute of the table (CR-017 E1's `range`; CR-002 section 65.3's bounds):
+ * - a signed field `-2^(bits-1)` to `2^(bits-1) - 1`, an unsigned one `0` to `2^bits - 1`;
+ * - `w:ind`'s `firstLine` and `hanging`, one signed field, `0` to `32767` and `0` to `32768`;
+ * - a line or a row height whose sign is the rule: under `exact` `1` to `32768`, under `atLeast` `0` to `32767`, a line
+ *   under `auto` the plain signed field; a row height under `hRule="auto"` is ignored, so null;
+ * - a frame's height `0` to `32767` (15 bits);
+ * - then the clamps (a tab stop, the page size), and a column's width or space, whose negative Word replaces (a
+ *   computed width; -1, which it also keeps as written, its own sentinel).
+ * The rule is the `lineRule` or `hRule` beside the attribute, where it has one. Undefined for an attribute not in the
+ * table. 65535 in an attribute Word's save writes as -1 (`w:spacing`'s `before` and `after`, the unsigned page margins)
+ * is in the range, and Word reads a -1 there as 65535 too, its own spelling.
+ */
+export declare function keptRange(typeName: string, property: string, rule?: string): KeptRange | null | undefined;
+/** `keptRange` from the table's entry; `property` for the shared field, `rule` for a line or a height. */
+export declare function rangeOf(entry: WordIntegerStorage, property: string, rule?: string): KeptRange | null;
+/**
+ * Word's reading, for a message: the value, in the shared field's other attribute where the sign moved it (`25536 in
+ * w:hanging`), with the rule where the sign carries one (`atLeast 1`, `exact 32768`); `not known` for an unmeasured
+ * attribute.
+ */
+export declare function describeReading(reading: WordIntegerReading, attribute: string): string;

package/dist/model/wordIntegers.mjs

@@ -0,0 +1,78 @@
+// CR-017: what Word 365 keeps of an integer attribute, from the objects package's table (its CR-016, docx4j CR-066's
+// rounds 5 and 6, run by Jason 2026-10-26). Word stores each attribute in a field of its binary format's width, 16 bits
+// for most, and reads a value past it wrapped, sometimes then clamped, with no error or repair. The table gives the
+// width, the sign and the rules per attribute; this module turns an entry into the range of values Word keeps as
+// written, which the setters' guards (CR-002 section 65.3, `wordRange.mts`) and the out-of-range warnings (CR-017 P2
+// and P3, `XmlPart.valueOutOfRange`) both read, so there is one source for both. A report names its entry (`typeName`,
+// `property`, `storage` and the `rule` beside the value, objects 0.7.0), so `rangeOf` takes it straight.
+import { WORD_INTEGER_STORAGE } from '@docx4j/generated-objects-ts/helpers/wml';
+/** The certain range of an attribute the table has but no round measured: outside it every measured attribute of its type changes. */
+export const UNMEASURED_RANGE = [-32768, 65535];
+/** Whether a reading is of an attribute no round measured (`storage` says so), as against one Word reads to no number. */
+export const isUnmeasured = (reading) => reading.storage.startsWith('unmeasured');
+/**
+ * The range Word 365 keeps as written in an attribute of the table (CR-017 E1's `range`; CR-002 section 65.3's bounds):
+ * - a signed field `-2^(bits-1)` to `2^(bits-1) - 1`, an unsigned one `0` to `2^bits - 1`;
+ * - `w:ind`'s `firstLine` and `hanging`, one signed field, `0` to `32767` and `0` to `32768`;
+ * - a line or a row height whose sign is the rule: under `exact` `1` to `32768`, under `atLeast` `0` to `32767`, a line
+ *   under `auto` the plain signed field; a row height under `hRule="auto"` is ignored, so null;
+ * - a frame's height `0` to `32767` (15 bits);
+ * - then the clamps (a tab stop, the page size), and a column's width or space, whose negative Word replaces (a
+ *   computed width; -1, which it also keeps as written, its own sentinel).
+ * The rule is the `lineRule` or `hRule` beside the attribute, where it has one. Undefined for an attribute not in the
+ * table. 65535 in an attribute Word's save writes as -1 (`w:spacing`'s `before` and `after`, the unsigned page margins)
+ * is in the range, and Word reads a -1 there as 65535 too, its own spelling.
+ */
+export function keptRange(typeName, property, rule) {
+    var _a;
+    const entry = (_a = WORD_INTEGER_STORAGE[typeName]) === null || _a === void 0 ? void 0 : _a[property];
+    return entry === undefined ? undefined : rangeOf(entry, property, rule);
+}
+/** `keptRange` from the table's entry; `property` for the shared field, `rule` for a line or a height. */
+export function rangeOf(entry, property, rule) {
+    if (!entry.measured)
+        return UNMEASURED_RANGE;
+    const half = 2 ** (entry.bits - 1);
+    let min;
+    let max;
+    if (entry.heightFlag)
+        [min, max] = [0, half - 1];
+    else if (entry.pair)
+        [min, max] = property === entry.pair.negative ? [0, half] : [0, half - 1];
+    else if (entry.signRule) {
+        const read = rule !== null && rule !== void 0 ? rule : (entry.signRule === 'hRule' ? 'atLeast' : 'auto');
+        if (entry.signRule === 'hRule' && read === 'auto')
+            return null;
+        if (read === 'exact')
+            [min, max] = [1, half];
+        else if (read === 'atLeast')
+            [min, max] = [0, half - 1];
+        else
+            [min, max] = [-half, half - 1];
+    }
+    else if (entry.signed)
+        [min, max] = [-half, half - 1];
+    else
+        [min, max] = [0, 2 ** entry.bits - 1];
+    if (entry.negative !== undefined)
+        min = Math.max(min, 0);
+    if (entry.min !== undefined)
+        min = Math.max(min, entry.min);
+    if (entry.max !== undefined)
+        max = Math.min(max, entry.max);
+    return [min, max];
+}
+/** Whether a reading's storage string names a rule beside the value (a line's `lineRule`, a height's `hRule`). */
+const dependsOnRule = (storage) => /\brule\b|clearing exact/.test(storage);
+/**
+ * Word's reading, for a message: the value, in the shared field's other attribute where the sign moved it (`25536 in
+ * w:hanging`), with the rule where the sign carries one (`atLeast 1`, `exact 32768`); `not known` for an unmeasured
+ * attribute.
+ */
+export function describeReading(reading, attribute) {
+    if (reading.value === null)
+        return reading.storage.includes('computed') ? 'a width Word computes' : 'not known';
+    const where = reading.attribute !== undefined && reading.attribute !== attribute ? ` in w:${reading.attribute}` : '';
+    const rule = reading.rule !== undefined && dependsOnRule(reading.storage) ? `${reading.rule} ` : '';
+    return `${rule}${reading.value}${where}`;
+}

package/dist/office-js/document.mjs

@@ -15,10 +15,24 @@ function literal(text) {
 function w3cdtf(date) {
     return { TYPE_NAME: 'org_docx4j_docProps_core_dc_terms.W3CDTF', content: [date.toISOString().replace(/\.\d{3}Z$/, 'Z')] };
 }
+/**
+ * A `dcterms:created` or `dcterms:modified` value as Word 365 reads it (docx4j CR-067 section 12.2, Jason's probe of
+ * 2026-10-28; CR-018 D6): a date alone (`2024-02-03`) and a time with no offset (`2025-06-07T08:09:10`) are UTC, as a `Z`
+ * value is (Word showed 11:00 and 18:09 at UTC+11 and UTC+10), so they are read here as UTC fields, where ECMAScript's
+ * `Date` would read the offset-free time as local. A `Z` or an offset is honoured as before. The seconds are kept: Word
+ * shows the value to the minute, but this reads the stored instant.
+ */
 function dateOf(value) {
-    const text = literalText(value);
+    const text = literalText(value).trim();
     if (text === '')
         return undefined;
+    const bare = /^(\d{4})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?)?$/.exec(text);
+    if (bare) {
+        const [year, month, day, hour, minute, second, fraction] = bare.slice(1);
+        const ms = fraction === undefined ? 0 : Math.round(Number(`0.${fraction}`) * 1000);
+        const date = new Date(Date.UTC(Number(year), Number(month) - 1, Number(day), Number(hour !== null && hour !== void 0 ? hour : 0), Number(minute !== null && minute !== void 0 ? minute : 0), Number(second !== null && second !== void 0 ? second : 0), ms));
+        return Number.isNaN(date.getTime()) ? undefined : date;
+    }
     const date = new Date(text);
     return Number.isNaN(date.getTime()) ? undefined : date;
 }

package/dist/office-js/toApiScript.mjs

@@ -184,7 +184,7 @@ class Emitter {
      * the generated document (CR-001 Phase B step 2; the same holds for `runFormat` below).
      */
     paragraphProperties(p) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f;
         const pPr = p.pPr;
         if (!pPr)
             return [];
@@ -223,13 +223,14 @@ class Emitter {
             if (spacing.after !== undefined)
                 out.push(['spaceAfter', num(spacing.after / TWIPS_PER_POINT)]);
             if (spacing.line !== undefined) {
-                // Paragraph.lineSpacing writes w:lineRule="exact", so only an exact rule round-trips.
-                if (spacing.lineRule !== 'exact')
-                    throw new Unexpressible(`w:spacing w:lineRule="${(_c = spacing.lineRule) !== null && _c !== void 0 ? _c : 'auto'}"`);
+                // Paragraph.lineSpacing writes w:lineRule="auto", as Word's setter does (CR-002 section 65.9), so only an auto rule,
+                // stated or the default, round-trips.
+                if (spacing.lineRule !== undefined && spacing.lineRule !== 'auto')
+                    throw new Unexpressible(`w:spacing w:lineRule="${spacing.lineRule}"`);
                 out.push(['lineSpacing', num(spacing.line / TWIPS_PER_POINT)]);
             }
         }
-        const outlineLvl = (_d = pPr.outlineLvl) === null || _d === void 0 ? void 0 : _d.val;
+        const outlineLvl = (_c = pPr.outlineLvl) === null || _c === void 0 ? void 0 : _c.val;
         if (outlineLvl !== undefined)
             out.push(['outlineLevel', num(outlineLvl + 1)]);
         const numPr = pPr.numPr;
@@ -240,10 +241,10 @@ class Emitter {
             // to know whether the list is a bullet one (CR-002 section 17).
             if (!within(numPr, NUMPR_KEYS))
                 throw new Unexpressible(`w:numPr (${keysOf(numPr).filter((k) => !NUMPR_KEYS.has(k)).join(', ')})`);
-            const numId = (_e = numPr.numId) === null || _e === void 0 ? void 0 : _e.val;
+            const numId = (_d = numPr.numId) === null || _d === void 0 ? void 0 : _d.val;
             if (numId === undefined)
                 throw new Unexpressible('w:numPr with no w:numId');
-            out.push([CALL, numId === 0 ? 'detachFromList()' : `attachToList(${numId}, ${(_g = (_f = numPr.ilvl) === null || _f === void 0 ? void 0 : _f.val) !== null && _g !== void 0 ? _g : 0})`]);
+            out.push([CALL, numId === 0 ? 'detachFromList()' : `attachToList(${numId}, ${(_f = (_e = numPr.ilvl) === null || _e === void 0 ? void 0 : _e.val) !== null && _f !== void 0 ? _f : 0})`]);
         }
         return out;
     }

package/dist/opc/DirectoryPartStore.d.mts

@@ -1,4 +1,4 @@
-import type { PartStore, PartSink, PutOptions } from './PartStore.mjs';
+import { type PartStore, type PartSink, type PutOptions } from './PartStore.mjs';
 /**
  * A package spread over a directory: `word/document.xml` is the file `<dir>/word/document.xml`,
  * `[Content_Types].xml` is read from the directory like any other entry, and a part's size comes
@@ -14,7 +14,10 @@ import type { PartStore, PartSink, PutOptions } from './PartStore.mjs';
  */
 export declare class DirectoryPartStore implements PartStore {
     readonly dir: string;
-    /** Store name (no leading '/') to [absolute file path, size]. */
+    /**
+     * Store name (no leading '/') to [absolute file path, size], looked up without case; of two files whose names differ only
+     * in case (a case-sensitive file system), the first in the walk is read and the rest counted (CR-024).
+     */
     private readonly entries;
     private constructor();
     /** Scans a directory and returns a store over it. */
@@ -22,6 +25,7 @@ export declare class DirectoryPartStore implements PartStore {
     private scan;
     partNames(): Iterable<string>;
     has(partName: string): boolean;
+    duplicates(): ReadonlyMap<string, number>;
     load(partName: string): Promise<Uint8Array>;
     size(partName: string): number | undefined;
 }

package/dist/opc/DirectoryPartStore.mjs

@@ -3,6 +3,7 @@
 // only, never from `.` or `./opc`, so a browser or add-in bundle never sees them.
 import { readFile, readdir, stat, mkdir, writeFile } from 'node:fs/promises';
 import { join, dirname, sep } from 'node:path';
+import { EntryIndex } from './PartStore.mjs';
 import { CONTENT_TYPES_NAME } from './PartName.mjs';
 import { Docx4JException } from './exceptions.mjs';
 /**
@@ -21,8 +22,11 @@ import { Docx4JException } from './exceptions.mjs';
 export class DirectoryPartStore {
     constructor(dir) {
         this.dir = dir;
-        /** Store name (no leading '/') to [absolute file path, size]. */
-        this.entries = new Map();
+        /**
+         * Store name (no leading '/') to [absolute file path, size], looked up without case; of two files whose names differ only
+         * in case (a case-sensitive file system), the first in the walk is read and the rest counted (CR-024).
+         */
+        this.entries = new EntryIndex();
     }
     /** Scans a directory and returns a store over it. */
     static async open(dir) {
@@ -48,15 +52,18 @@ export class DirectoryPartStore {
             if (info.isDirectory())
                 await this.scan(childRelative);
             else if (info.isFile())
-                this.entries.set(childRelative, [childPath, info.size]);
+                this.entries.add(childRelative, [childPath, info.size]);
         }
     }
     partNames() {
-        return this.entries.keys();
+        return this.entries.names();
     }
     has(partName) {
         return this.entries.has(normalize(partName));
     }
+    duplicates() {
+        return this.entries.duplicates();
+    }
     async load(partName) {
         const entry = this.entries.get(normalize(partName));
         if (!entry)

package/dist/opc/FlatOpcPartStore.d.mts

@@ -1,5 +1,5 @@
 import { type PackageElement } from '@docx4j/generated-objects-ts';
-import type { PartStore, PartSink, PutOptions } from './PartStore.mjs';
+import { type PartStore, type PartSink, type PutOptions } from './PartStore.mjs';
 export declare const PKG_NS = "http://schemas.microsoft.com/office/2006/xmlPackage";
 /**
  * A flat OPC package (`pkg:package`, what Office JS `getOoxml()` returns) as a container
@@ -7,10 +7,11 @@ export declare const PKG_NS = "http://schemas.microsoft.com/office/2006/xmlPacka
  * same job is done by `FlatOpcXmlImporter`). The content types are carried per part, so
  * `[Content_Types].xml` is synthesised. XML parts are serialised back to bytes on `load`; the
  * document loaded from them is therefore not byte-identical to what Office would have zipped.
+ * Parts are looked up as OPC part names, without case, and of two `pkg:part`s of one name the first
+ * is the one read, the rest counted in `duplicates()` (CR-024).
  */
 export declare class FlatOpcPartStore implements PartStore {
     private readonly parts;
-    private readonly order;
     private readonly cache;
     private contentTypesXml?;
     /** From the `pkg:package` string. */
@@ -22,6 +23,7 @@ export declare class FlatOpcPartStore implements PartStore {
     contentTypeOf(partName: string): string | undefined;
     partNames(): Iterable<string>;
     has(partName: string): boolean;
+    duplicates(): ReadonlyMap<string, number>;
     load(partName: string): Promise<Uint8Array>;
     private buildContentTypes;
 }

package/dist/opc/FlatOpcPartStore.mjs

@@ -1,4 +1,5 @@
 import { marshalNode } from '@docx4j/generated-objects-ts';
+import { EntryIndex, entryKey } from './PartStore.mjs';
 import { ContentTypeManager } from './ContentTypeManager.mjs';
 import { ContentTypes, isXmlContentType } from './ContentTypes.mjs';
 import { CONTENT_TYPES_NAME } from './PartName.mjs';
@@ -11,18 +12,18 @@ export const PKG_NS = 'http://schemas.microsoft.com/office/2006/xmlPackage';
  * same job is done by `FlatOpcXmlImporter`). The content types are carried per part, so
  * `[Content_Types].xml` is synthesised. XML parts are serialised back to bytes on `load`; the
  * document loaded from them is therefore not byte-identical to what Office would have zipped.
+ * Parts are looked up as OPC part names, without case, and of two `pkg:part`s of one name the first
+ * is the one read, the rest counted in `duplicates()` (CR-024).
  */
 export class FlatOpcPartStore {
     /** From the `pkg:package` string. */
     constructor(source) {
-        this.parts = new Map();
-        this.order = [];
+        this.parts = new EntryIndex();
         this.cache = new Map();
         if (typeof source === 'string')
             this.readString(source);
         else
             this.readPackageElement(source);
-        this.order.unshift(CONTENT_TYPES_NAME);
     }
     readString(text) {
         var _a;
@@ -65,8 +66,7 @@ export class FlatOpcPartStore {
         }
     }
     add(entry) {
-        this.parts.set(entry.name, entry);
-        this.order.push(entry.name);
+        this.parts.add(entry.name, entry);
     }
     /** The content type of a part as carried by the flat package. */
     contentTypeOf(partName) {
@@ -74,16 +74,19 @@ export class FlatOpcPartStore {
         return (_a = this.parts.get(partName)) === null || _a === void 0 ? void 0 : _a.contentType;
     }
     partNames() {
-        return this.order;
+        return [CONTENT_TYPES_NAME, ...this.parts.names()];
     }
     has(partName) {
         return partName === CONTENT_TYPES_NAME || this.parts.has(partName);
     }
+    duplicates() {
+        return this.parts.duplicates();
+    }
     async load(partName) {
         var _a;
         if (partName === CONTENT_TYPES_NAME)
             return ((_a = this.contentTypesXml) !== null && _a !== void 0 ? _a : (this.contentTypesXml = encodeText(this.buildContentTypes().toXml())));
-        const cached = this.cache.get(partName);
+        const cached = this.cache.get(entryKey(partName));
         if (cached)
             return cached;
         const part = this.parts.get(partName);
@@ -100,7 +103,7 @@ export class FlatOpcPartStore {
         else {
             bytes = new Uint8Array(0);
         }
-        this.cache.set(partName, bytes);
+        this.cache.set(entryKey(partName), bytes);
         return bytes;
     }
     buildContentTypes() {

package/dist/opc/Load.d.mts

@@ -2,6 +2,14 @@ import type { PartStore } from './PartStore.mjs';
 import { type DomPreprocessor } from '../parts/XmlPart.mjs';
 import { PartRegistry } from '../parts/PartRegistry.mjs';
 import type { OpcPackage } from '../packages/OpcPackage.mjs';
+/**
+ * WD REQ-207's option (CR-031): how a load treats a package Word reads only through a repair, or won't open. `'refuse'`, the
+ * default, keeps every refusal; `'word'` follows Word's repair where the WD states one, with that repair's warning; `'all'`
+ * does that and makes this package's own repairs, each documented and warned (README.md, "Repairs").
+ */
+export type RepairMode = 'refuse' | 'word' | 'all';
+/** The values of `LoadOptions.repair`, in the WD's order. */
+export declare const REPAIR_MODES: readonly RepairMode[];
 export interface LoadOptions {
     /** Part classes by content type; defaults to docx4j's table. */
     registry?: PartRegistry;
@@ -16,6 +24,30 @@ export interface LoadOptions {
     mcePreprocess?: boolean;
     /** Runs over every XML part's DOM before it is unmarshalled; set by the package from `mcePreprocess` (`mceKeep` or `mcePreprocess`). */
     preprocessor?: DomPreprocessor;
+    /**
+     * How a package Word reads only through a repair, or won't open, is loaded (WD REQ-207 and REQ-208; CR-031). It acts at the
+     * load, so it holds for every operation on the package. Any other value is refused.
+     *
+     * - `'refuse'`, the default: every refusal stands. A container holding two entries of one name, OPC part names compared
+     *   without case, throws `DuplicateEntryException` (REQ-206, CR-024); more than one officeDocument relationship,
+     *   `MultipleMainPartsException` (CR-024 section 9); a relationships part in another namespace or none,
+     *   `RelationshipsNamespaceException` (CR-025 section 8); an `External` officeDocument relationship beside an internal
+     *   one, `ExternalMainPartException` (REQ-206's NOTE).
+     * - `'word'`: Word's repair, each with its warning. The first entry of each duplicated name is read, in the container's
+     *   order (a zip's central directory), the rest ignored, a `DuplicateEntryWarning` each; of several officeDocument
+     *   relationships the **last** one's target, as a fresh Word reads it, the others dropped, one `MultipleMainPartsWarning`;
+     *   a relationships part in a wrong namespace read by local name, a `RelationshipsNamespaceWarning`. A save writes the
+     *   repaired package: one copy of each entry, one main part, the right namespace. `External` beside an internal
+     *   relationship is still refused, since Word refuses it even through its repair.
+     * - `'all'`: `'word'`, and this package's own repairs. One today: `External` beside an internal relationship, the internal
+     *   target read and every `External` officeDocument relationship dropped, its URL never fetched, an
+     *   `ExternalMainPartWarning`.
+     *
+     * At every value an `External` officeDocument relationship with no internal one is refused, as a package with no main
+     * document part (REQ-321), and the save's own gate is left alone: `pkg.checkLossOnSave` decides whether a save may lose
+     * what a read skipped (CR-031 D6).
+     */
+    repair?: RepairMode;
 }
 /**
  * Loads a package from a container (docx4j io3.Load3): content types, then the package