@docx4j/core-ts 0.1.1 → 0.1.3

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

@@ -1,4 +1,4 @@
-export { type XPathEngine, type XPathValue, DefaultXPathEngine, parsePrefixMappings, formatPrefixMappings, canonicalXPathOf, xmlOf, type CanonicalXPath } from './xpath.mjs';
+export { type XPathEngine, type XPathValue, type BooleanConversionMode, booleanValue, DefaultXPathEngine, parsePrefixMappings, formatPrefixMappings, canonicalXPathOf, xmlOf, type CanonicalXPath } from './xpath.mjs';
 export { CustomXmlPart, CustomXmlNode, CustomXmlPrefixMappingCollection, type CustomXmlNodeType, type CustomXmlPrefixMapping, type CustomXmlPartOwner } from './CustomXmlPart.mjs';
 export { CustomXmlPartCollection, type CustomXmlHost } from './CustomXmlPartCollection.mjs';
 export { XmlMapping, type CustomXmlPartLookup } from './XmlMapping.mjs';

package/dist/model/customxml/index.mjs

@@ -1,6 +1,6 @@
 // CR-002 phase E: custom XML parts, XML mapping, the XPath engine and the typed content controls
 // (CR-002 sections 3.5 and 3.6). Exported from '.' and './model', as the content API is.
-export { DefaultXPathEngine, parsePrefixMappings, formatPrefixMappings, canonicalXPathOf, xmlOf } from './xpath.mjs';
+export { booleanValue, DefaultXPathEngine, parsePrefixMappings, formatPrefixMappings, canonicalXPathOf, xmlOf } from './xpath.mjs';
 export { CustomXmlPart, CustomXmlNode, CustomXmlPrefixMappingCollection } from './CustomXmlPart.mjs';
 export { CustomXmlPartCollection } from './CustomXmlPartCollection.mjs';
 export { XmlMapping } from './XmlMapping.mjs';

package/dist/model/customxml/xpath-fonto.d.mts

@@ -0,0 +1,42 @@
+import type { BooleanConversionMode, XPathEngine, XPathValue } from './xpath.mjs';
+/**
+ * XPath 3.1 through FontoXPath, for the `xpath2` boolean conversion mode and for expressions
+ * written in XPath 2.0 syntax. `select`, `selectValue` and the `java` and `xpath1` modes answer as
+ * `DefaultXPathEngine` does; `xpath2` is the mode this engine exists for.
+ */
+export declare class FontoXPathEngine implements XPathEngine {
+    private module;
+    private loading;
+    get isReady(): boolean;
+    ready(): Promise<void>;
+    select(expression: string, context: Node, namespaces?: Record<string, string>): Node[];
+    selectValue(expression: string, context: Node, namespaces?: Record<string, string>): XPathValue;
+    /**
+     * Table 7's three modes. `java` and `xpath1` are the rules the specification states, evaluated
+     * here rather than through the `booleanValue` function so that one engine answers all three.
+     * `xpath2` is the effective boolean value **with the specification's string rule**: see
+     * {@link xpath2BooleanValue}.
+     */
+    booleanValue(expression: string, context: Node, namespaces: Record<string, string>, mode: BooleanConversionMode): boolean;
+    /**
+     * The `xpath2` mode of table 7, **as docx4j does it**: the expression is wrapped in
+     * `xs:boolean(...)` and the engine performs the cast, which is `XmlPart.cachedXPathGetBoolean`
+     * with `opendope.conditions.Xpathref.XPathBoolean=cast2` (measured against Saxon-HE 9.9.0-2 by
+     * the docx4j session, 2026-09-25, and matched here case for case). Doing what docx4j does,
+     * rather than casting by hand, is what keeps the two from drifting: the lexical space, the
+     * whitespace collapse, the multi-item rule and the empty sequence all come from the engine.
+     *
+     * So: `true`, `1` are true; `false`, `0` are false; leading and trailing space is collapsed
+     * first, so `" false "` is false; an expression selecting **nothing** is false; and anything
+     * else raises - `"yes"`, `"True"` (`xs:boolean`'s lexical space is case-sensitive where the
+     * `java` mode ignores case), `""` from an empty element, and a sequence of more than one node.
+     *
+     * A raise is not a false. docx4j turns it into an `InputIntegrityException` and the whole bind
+     * fails; here it is a `Docx4JException` from this call, and what a processor does with it is
+     * the processor's business (CR-005 phase B). That is the one place the two behaviours are not
+     * yet the same thing, and the specification does not say which is right.
+     */
+    private xpath2BooleanValue;
+    private options;
+    private fonto;
+}

package/dist/model/customxml/xpath-fonto.mjs

@@ -0,0 +1,123 @@
+// CR-005 phase A: an XPath 2.0 (in fact 3.1) `XPathEngine`, for the OpenDoPE specification's
+// `xpath2` boolean conversion mode (its section 7.2, table 7).
+//
+// `DefaultXPathEngine` is XPath 1.0, which is what `document.evaluate` and the `xpath` package
+// give. The specification's `xpath2` mode needs a 2.0 evaluator, and expressions written for it
+// may use 2.0 syntax; docx4j uses Saxon. [FontoXPath](https://github.com/FontoXML/fontoxpath) is
+// XPath 3.1 in JavaScript (MIT), over DOM nodes in browsers and in Node, and XPath 3.1 is a
+// superset of 2.0.
+//
+// It is an **optional peer dependency** and this module is its own entry point
+// (`@docx4j/core-ts/xpath-fonto`), so nothing that imports the package pays its ~665 KB: only a
+// consumer who needs the `xpath2` mode installs it and imports this.
+//
+//     import { FontoXPathEngine } from '@docx4j/core-ts/xpath-fonto';
+//     pkg.xpathEngine = new FontoXPathEngine();
+//     await pkg.customXmlParts.load();
+import { Docx4JException } from '../../opc/exceptions.mjs';
+/** `evaluateXPath`'s ANY_TYPE: the value in its natural type, which is what `selectValue` reports. */
+const ANY_TYPE = 0;
+/**
+ * XPath 3.1 through FontoXPath, for the `xpath2` boolean conversion mode and for expressions
+ * written in XPath 2.0 syntax. `select`, `selectValue` and the `java` and `xpath1` modes answer as
+ * `DefaultXPathEngine` does; `xpath2` is the mode this engine exists for.
+ */
+export class FontoXPathEngine {
+    get isReady() {
+        return this.module !== undefined;
+    }
+    async ready() {
+        var _a;
+        if (this.isReady)
+            return;
+        (_a = this.loading) !== null && _a !== void 0 ? _a : (this.loading = (async () => {
+            var _a;
+            const specifier = 'fontoxpath';
+            try {
+                // The published ESM build has no named exports under Node's interop, only a default.
+                const loaded = await import(/* @vite-ignore */ specifier);
+                this.module = (_a = loaded.default) !== null && _a !== void 0 ? _a : loaded;
+            }
+            catch (e) {
+                throw new Docx4JException("FontoXPathEngine needs the optional peer dependency 'fontoxpath' (npm install fontoxpath)", { cause: e });
+            }
+        })());
+        await this.loading;
+    }
+    select(expression, context, namespaces = {}) {
+        return this.fonto().evaluateXPathToNodes(expression, context, null, null, this.options(namespaces));
+    }
+    selectValue(expression, context, namespaces = {}) {
+        const value = this.fonto().evaluateXPath(expression, context, null, null, ANY_TYPE, this.options(namespaces));
+        return valueOf(value);
+    }
+    /**
+     * Table 7's three modes. `java` and `xpath1` are the rules the specification states, evaluated
+     * here rather than through the `booleanValue` function so that one engine answers all three.
+     * `xpath2` is the effective boolean value **with the specification's string rule**: see
+     * {@link xpath2BooleanValue}.
+     */
+    booleanValue(expression, context, namespaces, mode) {
+        switch (mode) {
+            case 'java': {
+                const value = this.selectValue(expression, context, namespaces);
+                return typeof value === 'boolean' ? value : String(value !== null && value !== void 0 ? value : '').toLowerCase() === 'true';
+            }
+            case 'xpath1':
+                // XPath 1.0's boolean() rules, asked for in that language so that 3.1's do not apply.
+                return this.fonto().evaluateXPathToBoolean(`boolean(${expression})`, context, null, null, { ...this.options(namespaces), language: 'XPath3.1' });
+            default:
+                return this.xpath2BooleanValue(expression, context, namespaces);
+        }
+    }
+    /**
+     * The `xpath2` mode of table 7, **as docx4j does it**: the expression is wrapped in
+     * `xs:boolean(...)` and the engine performs the cast, which is `XmlPart.cachedXPathGetBoolean`
+     * with `opendope.conditions.Xpathref.XPathBoolean=cast2` (measured against Saxon-HE 9.9.0-2 by
+     * the docx4j session, 2026-09-25, and matched here case for case). Doing what docx4j does,
+     * rather than casting by hand, is what keeps the two from drifting: the lexical space, the
+     * whitespace collapse, the multi-item rule and the empty sequence all come from the engine.
+     *
+     * So: `true`, `1` are true; `false`, `0` are false; leading and trailing space is collapsed
+     * first, so `" false "` is false; an expression selecting **nothing** is false; and anything
+     * else raises - `"yes"`, `"True"` (`xs:boolean`'s lexical space is case-sensitive where the
+     * `java` mode ignores case), `""` from an empty element, and a sequence of more than one node.
+     *
+     * A raise is not a false. docx4j turns it into an `InputIntegrityException` and the whole bind
+     * fails; here it is a `Docx4JException` from this call, and what a processor does with it is
+     * the processor's business (CR-005 phase B). That is the one place the two behaviours are not
+     * yet the same thing, and the specification does not say which is right.
+     */
+    xpath2BooleanValue(expression, context, namespaces) {
+        try {
+            return this.fonto().evaluateXPathToBoolean(`xs:boolean(${expression})`, context, null, null, this.options(namespaces));
+        }
+        catch (e) {
+            throw new Docx4JException(`The xpath2 boolean conversion mode casts to xs:boolean, which accepts only "true", "false", "1" and "0", `
+                + `and one value at a time: ${expression} gives none of them`, { cause: e });
+        }
+    }
+    options(namespaces) {
+        return { namespaceResolver: (prefix) => { var _a; return (_a = namespaces[prefix]) !== null && _a !== void 0 ? _a : null; } };
+    }
+    fonto() {
+        if (!this.module) {
+            throw new Docx4JException('The XPath engine is not ready yet: await pkg.customXmlParts.load() (or pkg.xpathEngine.ready()) once before selecting nodes');
+        }
+        return this.module;
+    }
+}
+/** A FontoXPath result in the four-type union `selectValue` reports. */
+function valueOf(value) {
+    var _a;
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')
+        return value;
+    if (Array.isArray(value))
+        return value.length === 0 ? undefined : valueOf(value[0]);
+    if (typeof value === 'object' && typeof value.nodeType === 'number') {
+        return (_a = value.textContent) !== null && _a !== void 0 ? _a : '';
+    }
+    return String(value);
+}

package/dist/model/customxml/xpath.d.mts

@@ -1,5 +1,19 @@
 /** The XPath result kinds `selectValue` can report. */
 export type XPathValue = string | number | boolean | undefined;
+/**
+ * How an XPaths entry becomes a boolean (OpenDoPE specification v3 section 7.2, table 7, declared
+ * in the XPaths part's `booleanConversion` attribute; CR-005 phase A):
+ *
+ * - `java`: the string value is true only if it equals `true`, ignoring case. `"1"` and `"yes"`
+ *   are false. docx4j's `Boolean.parseBoolean`, and the default for a template that declares no
+ *   mode.
+ * - `xpath1`: XPath 1.0 `boolean()`. A node-set is true if non-empty, a string if non-empty - so
+ *   `"false"` is **true**.
+ * - `xpath2`: the effective boolean value, a string cast to `xs:boolean` accepting only `true`,
+ *   `false`, `1` and `0` - so `"false"` is false and `"yes"` is an **error**. Needs an XPath 2.0
+ *   engine: `FontoXPathEngine` from `@docx4j/core-ts/xpath-fonto`.
+ */
+export type BooleanConversionMode = 'java' | 'xpath1' | 'xpath2';
 /**
  * XPath 1.0 over a DOM (CR-002 section 3.6). `select` answers a node set; `selectValue` answers a
  * string, number or boolean result. `namespaces` maps prefixes used in the expression to URIs.
@@ -11,7 +25,25 @@ export interface XPathEngine {
     readonly isReady: boolean;
     select(expression: string, context: Node, namespaces?: Record<string, string>): Node[];
     selectValue(expression: string, context: Node, namespaces?: Record<string, string>): XPathValue;
+    /**
+     * The expression as a boolean in one conversion mode, for an engine that can do more than the
+     * function {@link booleanValue} can do over `selectValue` - in practice `xpath2`, which needs an
+     * XPath 2.0 evaluator. Optional: `XPathEngine` is public and a consumer may implement it, so a
+     * required member would break every implementation that predates this. Callers go through
+     * {@link booleanValue}, never here.
+     */
+    booleanValue?(expression: string, context: Node, namespaces: Record<string, string>, mode: BooleanConversionMode): boolean;
 }
+/**
+ * The expression as a boolean in a declared conversion mode (table 7 above).
+ *
+ * `java` and `xpath1` need nothing an `XPathEngine` does not already have, so they work over any
+ * engine: `java` is the string value compared with `true`, `xpath1` is XPath 1.0 `boolean()` of the
+ * expression. `xpath2` is delegated to the engine's own `booleanValue` when it has one, and
+ * otherwise throws naming the engine to install - which is the specification's REQ-032, a processor
+ * evaluating in the declared mode or refusing to process the template.
+ */
+export declare function booleanValue(engine: XPathEngine, expression: string, context: Node, namespaces?: Record<string, string>, mode?: BooleanConversionMode): boolean;
 /**
  * The default engine: `document.evaluate` where the runtime has it, else the `xpath` package,
  * imported on `ready()`. The import specifier is a variable so that a bundler does not follow it

package/dist/model/customxml/xpath.mjs

@@ -12,6 +12,34 @@
 // afterwards is synchronous. A call before the engine is ready throws, naming the fix.
 import { Docx4JException } from '../../opc/exceptions.mjs';
 import { serializeXml } from '../../xml/dom.mjs';
+/**
+ * The expression as a boolean in a declared conversion mode (table 7 above).
+ *
+ * `java` and `xpath1` need nothing an `XPathEngine` does not already have, so they work over any
+ * engine: `java` is the string value compared with `true`, `xpath1` is XPath 1.0 `boolean()` of the
+ * expression. `xpath2` is delegated to the engine's own `booleanValue` when it has one, and
+ * otherwise throws naming the engine to install - which is the specification's REQ-032, a processor
+ * evaluating in the declared mode or refusing to process the template.
+ */
+export function booleanValue(engine, expression, context, namespaces = {}, mode = 'java') {
+    if (engine.booleanValue)
+        return engine.booleanValue(expression, context, namespaces, mode);
+    switch (mode) {
+        case 'java': {
+            const value = engine.selectValue(expression, context, namespaces);
+            return typeof value === 'boolean' ? value : String(value !== null && value !== void 0 ? value : '').toLowerCase() === 'true';
+        }
+        case 'xpath1': {
+            // boolean() is XPath 1.0's own conversion, so the engine applies the rules rather than this.
+            const value = engine.selectValue(`boolean(${expression})`, context, namespaces);
+            return value === true;
+        }
+        default:
+            throw new Docx4JException(`The boolean conversion mode "${mode}" needs an XPath 2.0 engine: `
+                + "import { FontoXPathEngine } from '@docx4j/core-ts/xpath-fonto' (npm install fontoxpath) "
+                + 'and set pkg.xpathEngine to it');
+    }
+}
 // XPathResult constants, spelled out because `XPathResult` is not a global in Node.
 const ANY_TYPE = 0;
 const NUMBER_TYPE = 1;

package/dist/opc/ContentTypes.d.mts

@@ -92,6 +92,16 @@ export declare const ContentTypes: {
     readonly SPREADSHEETML_COMMENTS: "application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml";
     readonly SPREADSHEETML_CONNECTIONS: "application/vnd.openxmlformats-officedocument.spreadsheetml.connections+xml";
     readonly SPREADSHEETML_EXTERNAL_LINK: "application/vnd.openxmlformats-officedocument.spreadsheetml.externalLink+xml";
+    readonly SPREADSHEETML_SLICER_CACHE: "application/vnd.ms-excel.slicerCache+xml";
+    readonly SPREADSHEETML_SLICERS: "application/vnd.ms-excel.slicer+xml";
+    readonly SPREADSHEETML_TIMELINE_CACHE: "application/vnd.ms-excel.timelineCache+xml";
+    readonly SPREADSHEETML_TIMELINES: "application/vnd.ms-excel.timeline+xml";
+    readonly SPREADSHEETML_CONTROL_PROPERTIES: "application/vnd.ms-excel.controlproperties+xml";
+    readonly SPREADSHEETML_CUSTOM_DATA_PROPERTIES: "application/vnd.openxmlformats-officedocument.customDataProperties+xml";
+    /** Generic, so `CustomDataPart` is registered by relationship type instead. */
+    readonly SPREADSHEETML_CUSTOM_DATA: "application/binary";
+    readonly SPREADSHEETML_SURVEY: "application/vnd.ms-excel.Survey+xml";
+    readonly SPREADSHEETML_DATA_MODEL: "application/vnd.openxmlformats-officedocument.model+data";
     readonly DIGITAL_SIGNATURE_ORIGIN_PART: "application/vnd.openxmlformats-package.digital-signature-origin";
     readonly DIGITAL_SIGNATURE_XML_SIGNATURE_PART: "application/vnd.openxmlformats-package.digital-signature-xmlsignature+xml";
     readonly INK_ML: "application/inkml+xml";

package/dist/opc/ContentTypes.mjs

@@ -92,6 +92,19 @@ export const ContentTypes = {
     SPREADSHEETML_COMMENTS: 'application/vnd.openxmlformats-officedocument.spreadsheetml.comments+xml',
     SPREADSHEETML_CONNECTIONS: 'application/vnd.openxmlformats-officedocument.spreadsheetml.connections+xml',
     SPREADSHEETML_EXTERNAL_LINK: 'application/vnd.openxmlformats-officedocument.spreadsheetml.externalLink+xml',
+    // The Excel 2010 and 2013 extension parts ([MS-XLSX] 2.1; docx4j 17.2.0 CR-022, CR-004 here).
+    // The strings are Excel 365's as docx4j measured them: the timeline pair is lowercase, and
+    // the survey's capital S is Excel's too.
+    SPREADSHEETML_SLICER_CACHE: 'application/vnd.ms-excel.slicerCache+xml',
+    SPREADSHEETML_SLICERS: 'application/vnd.ms-excel.slicer+xml',
+    SPREADSHEETML_TIMELINE_CACHE: 'application/vnd.ms-excel.timelineCache+xml',
+    SPREADSHEETML_TIMELINES: 'application/vnd.ms-excel.timeline+xml',
+    SPREADSHEETML_CONTROL_PROPERTIES: 'application/vnd.ms-excel.controlproperties+xml',
+    SPREADSHEETML_CUSTOM_DATA_PROPERTIES: 'application/vnd.openxmlformats-officedocument.customDataProperties+xml',
+    /** Generic, so `CustomDataPart` is registered by relationship type instead. */
+    SPREADSHEETML_CUSTOM_DATA: 'application/binary',
+    SPREADSHEETML_SURVEY: 'application/vnd.ms-excel.Survey+xml',
+    SPREADSHEETML_DATA_MODEL: 'application/vnd.openxmlformats-officedocument.model+data',
     DIGITAL_SIGNATURE_ORIGIN_PART: 'application/vnd.openxmlformats-package.digital-signature-origin',
     DIGITAL_SIGNATURE_XML_SIGNATURE_PART: 'application/vnd.openxmlformats-package.digital-signature-xmlsignature+xml',
     INK_ML: 'application/inkml+xml',

package/dist/parts/Namespaces.d.mts

@@ -91,6 +91,24 @@ export declare const Namespaces: {
     readonly SPREADSHEETML_PIVOT_CACHE_DEFINITION: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition";
     readonly SPREADSHEETML_PIVOT_CACHE_RECORDS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheRecords";
     readonly SPREADSHEETML_EXTERNAL_LINK: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLink";
+    /** `/xl/slicerCaches/slicerCache1.xml`, from the workbook. */
+    readonly SPREADSHEETML_SLICER_CACHE: "http://schemas.microsoft.com/office/2007/relationships/slicerCache";
+    /** `/xl/slicers/slicer1.xml`, from a worksheet. */
+    readonly SPREADSHEETML_SLICERS: "http://schemas.microsoft.com/office/2007/relationships/slicer";
+    /** `/xl/timelineCaches/timelineCache1.xml`, from the workbook. */
+    readonly SPREADSHEETML_TIMELINE_CACHE: "http://schemas.microsoft.com/office/2011/relationships/timelineCache";
+    /** `/xl/timelines/timeline1.xml`, from a worksheet. */
+    readonly SPREADSHEETML_TIMELINES: "http://schemas.microsoft.com/office/2011/relationships/timeline";
+    /** `/xl/ctrlProps/ctrlProp1.xml`, from a worksheet, for one of its form controls. */
+    readonly SPREADSHEETML_CONTROL_PROPERTIES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp";
+    /** `/xl/customDataProps/customDataProps1.xml`, from the workbook. */
+    readonly SPREADSHEETML_CUSTOM_DATA_PROPERTIES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customDataProps";
+    /** `/xl/customData/customData1.dat`, from its properties part. */
+    readonly SPREADSHEETML_CUSTOM_DATA: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customData";
+    /** `/xl/surveys/survey1.xml`, from the workbook. */
+    readonly SPREADSHEETML_SURVEY: "http://schemas.microsoft.com/office/2010/relationships/Survey";
+    /** `/xl/model/item.data` ([MS-XLDM]), from the workbook. */
+    readonly SPREADSHEETML_DATA_MODEL: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/powerPivotData";
     readonly WEB_EXTENSION_TASKPANES: "http://schemas.microsoft.com/office/webextensions/taskpanes/2010/11";
     readonly WEB_EXTENSION_WEBEXTENSION: "http://schemas.microsoft.com/office/webextensions/webextension/2010/11";
     readonly XML_EVENTS: "http://www.w3.org/2001/xml-events";

package/dist/parts/Namespaces.mjs

@@ -91,6 +91,26 @@ export const Namespaces = {
     SPREADSHEETML_PIVOT_CACHE_DEFINITION: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition',
     SPREADSHEETML_PIVOT_CACHE_RECORDS: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheRecords',
     SPREADSHEETML_EXTERNAL_LINK: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/externalLink',
+    // The Excel 2010 and 2013 extension parts (CR-004): slicers and their caches are 2007,
+    // timelines 2011, the survey 2010; the rest are the officeDocument ones.
+    /** `/xl/slicerCaches/slicerCache1.xml`, from the workbook. */
+    SPREADSHEETML_SLICER_CACHE: 'http://schemas.microsoft.com/office/2007/relationships/slicerCache',
+    /** `/xl/slicers/slicer1.xml`, from a worksheet. */
+    SPREADSHEETML_SLICERS: 'http://schemas.microsoft.com/office/2007/relationships/slicer',
+    /** `/xl/timelineCaches/timelineCache1.xml`, from the workbook. */
+    SPREADSHEETML_TIMELINE_CACHE: 'http://schemas.microsoft.com/office/2011/relationships/timelineCache',
+    /** `/xl/timelines/timeline1.xml`, from a worksheet. */
+    SPREADSHEETML_TIMELINES: 'http://schemas.microsoft.com/office/2011/relationships/timeline',
+    /** `/xl/ctrlProps/ctrlProp1.xml`, from a worksheet, for one of its form controls. */
+    SPREADSHEETML_CONTROL_PROPERTIES: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/ctrlProp',
+    /** `/xl/customDataProps/customDataProps1.xml`, from the workbook. */
+    SPREADSHEETML_CUSTOM_DATA_PROPERTIES: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/customDataProps',
+    /** `/xl/customData/customData1.dat`, from its properties part. */
+    SPREADSHEETML_CUSTOM_DATA: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/customData',
+    /** `/xl/surveys/survey1.xml`, from the workbook. */
+    SPREADSHEETML_SURVEY: 'http://schemas.microsoft.com/office/2010/relationships/Survey',
+    /** `/xl/model/item.data` ([MS-XLDM]), from the workbook. */
+    SPREADSHEETML_DATA_MODEL: 'http://schemas.openxmlformats.org/officeDocument/2006/relationships/powerPivotData',
     WEB_EXTENSION_TASKPANES: 'http://schemas.microsoft.com/office/webextensions/taskpanes/2010/11',
     WEB_EXTENSION_WEBEXTENSION: 'http://schemas.microsoft.com/office/webextensions/webextension/2010/11',
     XML_EVENTS: 'http://www.w3.org/2001/xml-events',

package/dist/parts/Part.d.mts

@@ -39,6 +39,12 @@ export declare abstract class Part implements RelationshipSource {
      * its content type in the content type manager, and a relationship in this part's relationships.
      */
     addTargetPart(target: Part, mode?: AddPartBehaviour, proposedRelId?: string): Relationship;
+    /**
+     * This part's targets of one relationship type that are instances of a class, in relationship
+     * order: what a shortcut for a collection of parts (a sheet's slicers, a workbook's slicer
+     * caches) is made of.
+     */
+    protected partsByRelationshipType<T extends Part>(relationshipType: string, cls: abstract new (...args: never[]) => T): T[];
     /** Subclasses keep typed references to well-known targets (styles, numbering, ...); returns true when one was set. */
     setPartShortcut(_part: Part, _relationshipType: string): boolean;
     /** The bytes this part was loaded from, if it came from a container. Undefined for new parts. */

package/dist/parts/Part.mjs

@@ -47,6 +47,19 @@ export class Part {
         this.setPartShortcut(target, target.relationshipType);
         return rel;
     }
+    /**
+     * This part's targets of one relationship type that are instances of a class, in relationship
+     * order: what a shortcut for a collection of parts (a sheet's slicers, a workbook's slicer
+     * caches) is made of.
+     */
+    partsByRelationshipType(relationshipType, cls) {
+        const rp = this.relationshipsPart;
+        if (!rp)
+            return [];
+        return rp.getRelationshipsByType(relationshipType)
+            .map((r) => rp.getPart(r))
+            .filter((p) => p instanceof cls);
+    }
     /** Subclasses keep typed references to well-known targets (styles, numbering, ...); returns true when one was set. */
     setPartShortcut(_part, _relationshipType) {
         return false;

package/dist/parts/PartRegistry.mjs

@@ -61,6 +61,7 @@ export const defaultPartRegistry = new PartRegistry()
     .registerForRelationship(Namespaces.EMBEDDED_PKG, (n, ct) => new EmbeddedPackagePart(n, ct))
     .registerForRelationship(Namespaces.OLE_OBJECT, (n, ct) => new OleObjectBinaryPart(n, ct))
     .registerForRelationship(Namespaces.CUSTOM_XML_DATA_STORAGE, (n, ct) => new CustomXmlDataStoragePart(n, ct))
+    .registerForRelationship(Namespaces.SPREADSHEETML_CUSTOM_DATA, (n, ct) => new sml.CustomDataPart(n, ct))
     .register(ContentTypes.WORDPROCESSINGML_DOCUMENT, (n, ct) => new wml.MainDocumentPart(n, ct))
     .register(ContentTypes.WORDPROCESSINGML_DOCUMENT_MACROENABLED, (n, ct) => new wml.MainDocumentPart(n, ct))
     .register(ContentTypes.WORDPROCESSINGML_TEMPLATE, (n, ct) => new wml.MainDocumentPart(n, ct))
@@ -140,4 +141,14 @@ export const defaultPartRegistry = new PartRegistry()
     .register(ContentTypes.SPREADSHEETML_QUERY_TABLE, (n) => new sml.QueryTablePart(n))
     .register(ContentTypes.SPREADSHEETML_CONNECTIONS, (n) => new sml.ConnectionsPart(n))
     .register(ContentTypes.SPREADSHEETML_EXTERNAL_LINK, (n) => new sml.ExternalLinkPart(n))
-    .register(ContentTypes.SPREADSHEETML_PRINTER_SETTINGS, (n) => new sml.PrinterSettingsPart(n));
+    .register(ContentTypes.SPREADSHEETML_PRINTER_SETTINGS, (n) => new sml.PrinterSettingsPart(n))
+    // The Excel 2010 and 2013 extension parts (CR-004).  `CustomDataPart`'s content type is the
+    // generic `application/binary`, so it is registered by relationship type above instead.
+    .register(ContentTypes.SPREADSHEETML_SLICER_CACHE, (n) => new sml.SlicerCachePart(n))
+    .register(ContentTypes.SPREADSHEETML_SLICERS, (n) => new sml.SlicersPart(n))
+    .register(ContentTypes.SPREADSHEETML_TIMELINE_CACHE, (n) => new sml.TimelineCachePart(n))
+    .register(ContentTypes.SPREADSHEETML_TIMELINES, (n) => new sml.TimelinesPart(n))
+    .register(ContentTypes.SPREADSHEETML_CONTROL_PROPERTIES, (n) => new sml.ControlPropertiesPart(n))
+    .register(ContentTypes.SPREADSHEETML_CUSTOM_DATA_PROPERTIES, (n) => new sml.CustomDataPropertiesPart(n))
+    .register(ContentTypes.SPREADSHEETML_SURVEY, (n) => new sml.SurveyPart(n))
+    .register(ContentTypes.SPREADSHEETML_DATA_MODEL, (n) => new sml.DataModelPart(n));

package/dist/parts/sml/index.d.mts

@@ -1,5 +1,6 @@
 import type * as sml from '@docx4j/generated-objects-ts/modules/org_xlsx4j_sml';
 import { XmlPart } from '../XmlPart.mjs';
+import { DefaultXmlPart } from '../DefaultXmlPart.mjs';
 import { BinaryPart } from '../BinaryPart.mjs';
 import { Part } from '../Part.mjs';
 import { PartName } from '../../opc/PartName.mjs';
@@ -9,6 +10,10 @@ export declare class WorkbookPart extends XmlPart<sml.Workbook> {
     stylesPart: StylesPart | undefined;
     themePart: ThemePart | undefined;
     calcChainPart: CalcChainPart | undefined;
+    /** The workbook's survey part, if it has one (CR-004). */
+    surveyPart: SurveyPart | undefined;
+    /** The Power Pivot data model (`/xl/model/item.data`), if the workbook has one (CR-004). */
+    dataModelPart: DataModelPart | undefined;
     constructor(partName?: PartName | string, contentType?: string);
     setPartShortcut(part: Part, relationshipType: string): boolean;
     /**
@@ -20,6 +25,12 @@ export declare class WorkbookPart extends XmlPart<sml.Workbook> {
     getWorksheetParts(): Promise<WorksheetPart[]>;
     /** The worksheet at an index of `sheets` (docx4j `WorkbookPart.getWorksheet(int)`). */
     getWorksheet(index: number): WorksheetPart;
+    /** The workbook's slicer caches (`/xl/slicerCaches/slicerCacheN.xml`), in relationship order. */
+    get slicerCacheParts(): SlicerCachePart[];
+    /** The workbook's timeline caches (`/xl/timelineCaches/timelineCacheN.xml`), in relationship order. */
+    get timelineCacheParts(): TimelineCachePart[];
+    /** The workbook's custom data properties parts, in relationship order; each names a `CustomDataPart`. */
+    get customDataPropertiesParts(): CustomDataPropertiesPart[];
     /** docx4j `WorkbookPart.isDate1904()`. */
     get isDate1904(): boolean;
 }
@@ -32,6 +43,16 @@ export declare class WorksheetPart extends XmlPart<sml.Worksheet> {
     setPartShortcut(part: Part, relationshipType: string): boolean;
     /** The sheet's table parts (`xl/tables/tableN.xml`), in relationship order. */
     get tableParts(): TablePart[];
+    /** The sheet's slicers parts (`/xl/slicers/slicerN.xml`), in relationship order (CR-004). */
+    get slicersParts(): SlicersPart[];
+    /** The sheet's timelines parts (`/xl/timelines/timelineN.xml`), in relationship order (CR-004). */
+    get timelinesParts(): TimelinesPart[];
+    /**
+     * The sheet's form-control properties parts (`/xl/ctrlProps/ctrlPropN.xml`), in relationship
+     * order: one per `x:control`, whose `r:id` names it from inside the sheet's
+     * `mc:AlternateContent` (CR-004).
+     */
+    get controlPropertiesParts(): ControlPropertiesPart[];
     /** The workbook this sheet belongs to, through its source relationship. */
     get workbookPart(): WorkbookPart | undefined;
 }
@@ -77,3 +98,43 @@ export declare class ExternalLinkPart extends XmlPart<sml.CTExternalLink> {
 export declare class PrinterSettingsPart extends BinaryPart {
     constructor(partName: PartName | string);
 }
+/** A slicer cache (`x14:slicerCacheDefinition`), from the workbook. docx4j `SlicerCachePart`. */
+export declare class SlicerCachePart extends DefaultXmlPart {
+    constructor(partName?: PartName | string);
+}
+/** A sheet's slicers (`x14:slicers`). docx4j `SlicersPart`. */
+export declare class SlicersPart extends DefaultXmlPart {
+    constructor(partName?: PartName | string);
+}
+/** A timeline cache (`x15:timelineCacheDefinition`), from the workbook. docx4j `TimelineCachePart`. */
+export declare class TimelineCachePart extends DefaultXmlPart {
+    constructor(partName?: PartName | string);
+}
+/** A sheet's timelines (`x15:timelines`). docx4j `TimelinesPart`. */
+export declare class TimelinesPart extends DefaultXmlPart {
+    constructor(partName?: PartName | string);
+}
+/** A form control's properties (`x14:formControlPr`), from a worksheet. docx4j `ControlPropertiesPart`. */
+export declare class ControlPropertiesPart extends DefaultXmlPart {
+    constructor(partName?: PartName | string);
+}
+/** The properties of a custom data part (`x14:datastoreItem`). docx4j `CustomDataPropertiesPart`. */
+export declare class CustomDataPropertiesPart extends DefaultXmlPart {
+    constructor(partName?: PartName | string);
+}
+/** A survey (`x15:survey`), from the workbook. docx4j `SurveyPart`. */
+export declare class SurveyPart extends DefaultXmlPart {
+    constructor(partName?: PartName | string);
+}
+/**
+ * Custom data, whatever an add-in put there (docx4j `CustomDataPart`).  Its content type is the
+ * generic `application/binary`, so the registry chooses it by relationship type, as it does for
+ * altChunk, embedded packages, OLE objects and custom XML (CR-001 section 5.4).
+ */
+export declare class CustomDataPart extends BinaryPart {
+    constructor(partName?: PartName | string, contentType?: string);
+}
+/** The Power Pivot data model (`/xl/model/item.data`, [MS-XLDM]). docx4j `DataModelPart`. */
+export declare class DataModelPart extends BinaryPart {
+    constructor(partName?: PartName | string);
+}

package/dist/parts/sml/index.mjs

@@ -1,4 +1,5 @@
 import { XmlPart } from '../XmlPart.mjs';
+import { DefaultXmlPart } from '../DefaultXmlPart.mjs';
 import { BinaryPart } from '../BinaryPart.mjs';
 import { ContentTypes } from '../../opc/ContentTypes.mjs';
 import { Namespaces } from '../Namespaces.mjs';
@@ -22,6 +23,12 @@ export class WorkbookPart extends XmlPart {
             case Namespaces.SPREADSHEETML_CALC_CHAIN:
                 this.calcChainPart = part;
                 return true;
+            case Namespaces.SPREADSHEETML_SURVEY:
+                this.surveyPart = part;
+                return true;
+            case Namespaces.SPREADSHEETML_DATA_MODEL:
+                this.dataModelPart = part;
+                return true;
             default: return false;
         }
     }
@@ -61,6 +68,18 @@ export class WorkbookPart extends XmlPart {
             throw new Xlsx4jException(`No sheet at index ${index}. (There are ${sheets.length} sheets) `);
         return sheet;
     }
+    /** The workbook's slicer caches (`/xl/slicerCaches/slicerCacheN.xml`), in relationship order. */
+    get slicerCacheParts() {
+        return this.partsByRelationshipType(Namespaces.SPREADSHEETML_SLICER_CACHE, SlicerCachePart);
+    }
+    /** The workbook's timeline caches (`/xl/timelineCaches/timelineCacheN.xml`), in relationship order. */
+    get timelineCacheParts() {
+        return this.partsByRelationshipType(Namespaces.SPREADSHEETML_TIMELINE_CACHE, TimelineCachePart);
+    }
+    /** The workbook's custom data properties parts, in relationship order; each names a `CustomDataPart`. */
+    get customDataPropertiesParts() {
+        return this.partsByRelationshipType(Namespaces.SPREADSHEETML_CUSTOM_DATA_PROPERTIES, CustomDataPropertiesPart);
+    }
     /** docx4j `WorkbookPart.isDate1904()`. */
     get isDate1904() {
         var _a;
@@ -84,10 +103,23 @@ export class WorksheetPart extends XmlPart {
     }
     /** The sheet's table parts (`xl/tables/tableN.xml`), in relationship order. */
     get tableParts() {
-        const rp = this.relationshipsPart;
-        if (!rp)
-            return [];
-        return rp.getRelationshipsByType(Namespaces.SPREADSHEETML_TABLE).map((r) => rp.getPart(r)).filter((p) => p instanceof TablePart);
+        return this.partsByRelationshipType(Namespaces.SPREADSHEETML_TABLE, TablePart);
+    }
+    /** The sheet's slicers parts (`/xl/slicers/slicerN.xml`), in relationship order (CR-004). */
+    get slicersParts() {
+        return this.partsByRelationshipType(Namespaces.SPREADSHEETML_SLICERS, SlicersPart);
+    }
+    /** The sheet's timelines parts (`/xl/timelines/timelineN.xml`), in relationship order (CR-004). */
+    get timelinesParts() {
+        return this.partsByRelationshipType(Namespaces.SPREADSHEETML_TIMELINES, TimelinesPart);
+    }
+    /**
+     * The sheet's form-control properties parts (`/xl/ctrlProps/ctrlPropN.xml`), in relationship
+     * order: one per `x:control`, whose `r:id` names it from inside the sheet's
+     * `mc:AlternateContent` (CR-004).
+     */
+    get controlPropertiesParts() {
+        return this.partsByRelationshipType(Namespaces.SPREADSHEETML_CONTROL_PROPERTIES, ControlPropertiesPart);
     }
     /** The workbook this sheet belongs to, through its source relationship. */
     get workbookPart() {
@@ -164,3 +196,65 @@ export class PrinterSettingsPart extends BinaryPart {
         super(partName, ContentTypes.SPREADSHEETML_PRINTER_SETTINGS, Namespaces.SPREADSHEETML_PRINTER_SETTINGS);
     }
 }
+// The Excel 2010 and 2013 extension parts (CR-004 phase A; docx4j
+// org.docx4j.openpackaging.parts.SpreadsheetML).  The seven XML ones are `DefaultXmlPart`s for
+// now: their DOM round-trips byte for byte, and nothing re-marshals them, so an `mc:Ignorable`
+// they carry is untouched.  Phase B makes them `XmlPart`s over the `x14` and `x15` roots.
+/** A slicer cache (`x14:slicerCacheDefinition`), from the workbook. docx4j `SlicerCachePart`. */
+export class SlicerCachePart extends DefaultXmlPart {
+    constructor(partName = '/xl/slicerCaches/slicerCache1.xml') {
+        super(partName, ContentTypes.SPREADSHEETML_SLICER_CACHE, Namespaces.SPREADSHEETML_SLICER_CACHE);
+    }
+}
+/** A sheet's slicers (`x14:slicers`). docx4j `SlicersPart`. */
+export class SlicersPart extends DefaultXmlPart {
+    constructor(partName = '/xl/slicers/slicer1.xml') {
+        super(partName, ContentTypes.SPREADSHEETML_SLICERS, Namespaces.SPREADSHEETML_SLICERS);
+    }
+}
+/** A timeline cache (`x15:timelineCacheDefinition`), from the workbook. docx4j `TimelineCachePart`. */
+export class TimelineCachePart extends DefaultXmlPart {
+    constructor(partName = '/xl/timelineCaches/timelineCache1.xml') {
+        super(partName, ContentTypes.SPREADSHEETML_TIMELINE_CACHE, Namespaces.SPREADSHEETML_TIMELINE_CACHE);
+    }
+}
+/** A sheet's timelines (`x15:timelines`). docx4j `TimelinesPart`. */
+export class TimelinesPart extends DefaultXmlPart {
+    constructor(partName = '/xl/timelines/timeline1.xml') {
+        super(partName, ContentTypes.SPREADSHEETML_TIMELINES, Namespaces.SPREADSHEETML_TIMELINES);
+    }
+}
+/** A form control's properties (`x14:formControlPr`), from a worksheet. docx4j `ControlPropertiesPart`. */
+export class ControlPropertiesPart extends DefaultXmlPart {
+    constructor(partName = '/xl/ctrlProps/ctrlProp1.xml') {
+        super(partName, ContentTypes.SPREADSHEETML_CONTROL_PROPERTIES, Namespaces.SPREADSHEETML_CONTROL_PROPERTIES);
+    }
+}
+/** The properties of a custom data part (`x14:datastoreItem`). docx4j `CustomDataPropertiesPart`. */
+export class CustomDataPropertiesPart extends DefaultXmlPart {
+    constructor(partName = '/xl/customDataProps/customDataProps1.xml') {
+        super(partName, ContentTypes.SPREADSHEETML_CUSTOM_DATA_PROPERTIES, Namespaces.SPREADSHEETML_CUSTOM_DATA_PROPERTIES);
+    }
+}
+/** A survey (`x15:survey`), from the workbook. docx4j `SurveyPart`. */
+export class SurveyPart extends DefaultXmlPart {
+    constructor(partName = '/xl/surveys/survey1.xml') {
+        super(partName, ContentTypes.SPREADSHEETML_SURVEY, Namespaces.SPREADSHEETML_SURVEY);
+    }
+}
+/**
+ * Custom data, whatever an add-in put there (docx4j `CustomDataPart`).  Its content type is the
+ * generic `application/binary`, so the registry chooses it by relationship type, as it does for
+ * altChunk, embedded packages, OLE objects and custom XML (CR-001 section 5.4).
+ */
+export class CustomDataPart extends BinaryPart {
+    constructor(partName = '/xl/customData/customData1.dat', contentType = ContentTypes.SPREADSHEETML_CUSTOM_DATA) {
+        super(partName, contentType, Namespaces.SPREADSHEETML_CUSTOM_DATA);
+    }
+}
+/** The Power Pivot data model (`/xl/model/item.data`, [MS-XLDM]). docx4j `DataModelPart`. */
+export class DataModelPart extends BinaryPart {
+    constructor(partName = '/xl/model/item.data') {
+        super(partName, ContentTypes.SPREADSHEETML_DATA_MODEL, Namespaces.SPREADSHEETML_DATA_MODEL);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docx4j/core-ts",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "docx4j-core for TypeScript: Open Packaging (docx/pptx/xlsx zip and flat OPC), typed parts and relationships, style, numbering and font resolution over @docx4j/generated-objects-ts. Node, browsers, Word add-ins.",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -33,6 +33,10 @@
     "./office-js": {
       "types": "./dist/office-js/index.d.mts",
       "import": "./dist/office-js/index.mjs"
+    },
+    "./xpath-fonto": {
+      "types": "./dist/model/customxml/xpath-fonto.d.mts",
+      "import": "./dist/model/customxml/xpath-fonto.mjs"
     }
   },
   "files": [
@@ -75,17 +79,22 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@docx4j/generated-objects-ts": "^0.1.6",
+    "@docx4j/generated-objects-ts": "^0.2.0",
     "fflate": "^0.8.2"
   },
   "devDependencies": {
+    "fontoxpath": "^3.34.0",
     "typescript": "~5.6.3",
     "xpath": "^0.0.34"
   },
   "peerDependencies": {
+    "fontoxpath": "^3.30.0",
     "xpath": "^0.0.34"
   },
   "peerDependenciesMeta": {
+    "fontoxpath": {
+      "optional": true
+    },
     "xpath": {
       "optional": true
     }