@docx4j/core-ts 0.1.0

package/dist/packages/PresentationMLPackage.mjs

@@ -0,0 +1,39 @@
+import { OpcPackage } from './OpcPackage.mjs';
+import { registerPackageClass } from './registry.mjs';
+import { ContentTypes } from '../opc/ContentTypes.mjs';
+import { Docx4JException } from '../opc/exceptions.mjs';
+import { Namespaces } from '../parts/Namespaces.mjs';
+const MAIN_CONTENT_TYPES = [
+    ContentTypes.PRESENTATIONML_MAIN,
+    ContentTypes.PRESENTATIONML_TEMPLATE,
+    ContentTypes.PRESENTATIONML_MACROENABLED,
+    ContentTypes.PRESENTATIONML_TEMPLATE_MACROENABLED,
+    ContentTypes.PRESENTATIONML_SLIDESHOW,
+];
+/** A pptx (docx4j PresentationMLPackage). */
+export class PresentationMLPackage extends OpcPackage {
+    static async load(source, options) {
+        var _a, _b;
+        const pkg = await OpcPackage.load(source, options);
+        if (!(pkg instanceof PresentationMLPackage)) {
+            throw new Docx4JException(`Not a PresentationML package: main part is ${(_b = (_a = pkg.getMainPart()) === null || _a === void 0 ? void 0 : _a.contentType) !== null && _b !== void 0 ? _b : 'missing'}`);
+        }
+        return pkg;
+    }
+    setPartShortcut(part, relationshipType) {
+        if (relationshipType === Namespaces.DOCUMENT || relationshipType === Namespaces.DOCUMENT_STRICT) {
+            this.mainPresentationPart = part;
+            return true;
+        }
+        return super.setPartShortcut(part, relationshipType);
+    }
+    getMainPresentationPart() {
+        if (!this.mainPresentationPart)
+            throw new Docx4JException('No main presentation part');
+        return this.mainPresentationPart;
+    }
+    get progId() {
+        return 'PowerPoint.Show';
+    }
+}
+registerPackageClass(MAIN_CONTENT_TYPES, PresentationMLPackage);

package/dist/packages/SpreadsheetMLPackage.d.mts

@@ -0,0 +1,12 @@
+import { OpcPackage, type PackageSource } from './OpcPackage.mjs';
+import type { LoadOptions } from '../opc/Load.mjs';
+import type { Part } from '../parts/Part.mjs';
+import type { WorkbookPart } from '../parts/sml/index.mjs';
+/** An xlsx (docx4j SpreadsheetMLPackage). */
+export declare class SpreadsheetMLPackage extends OpcPackage {
+    workbookPart: WorkbookPart | undefined;
+    static load(source: PackageSource, options?: LoadOptions): Promise<SpreadsheetMLPackage>;
+    setPartShortcut(part: Part, relationshipType: string): boolean;
+    getWorkbookPart(): WorkbookPart;
+    protected get progId(): string;
+}

package/dist/packages/SpreadsheetMLPackage.mjs

@@ -0,0 +1,38 @@
+import { OpcPackage } from './OpcPackage.mjs';
+import { registerPackageClass } from './registry.mjs';
+import { ContentTypes } from '../opc/ContentTypes.mjs';
+import { Docx4JException } from '../opc/exceptions.mjs';
+import { Namespaces } from '../parts/Namespaces.mjs';
+const MAIN_CONTENT_TYPES = [
+    ContentTypes.SPREADSHEETML_WORKBOOK,
+    ContentTypes.SPREADSHEETML_WORKBOOK_MACROENABLED,
+    ContentTypes.SPREADSHEETML_TEMPLATE,
+    ContentTypes.SPREADSHEETML_TEMPLATE_MACROENABLED,
+];
+/** An xlsx (docx4j SpreadsheetMLPackage). */
+export class SpreadsheetMLPackage extends OpcPackage {
+    static async load(source, options) {
+        var _a, _b;
+        const pkg = await OpcPackage.load(source, options);
+        if (!(pkg instanceof SpreadsheetMLPackage)) {
+            throw new Docx4JException(`Not a SpreadsheetML package: main part is ${(_b = (_a = pkg.getMainPart()) === null || _a === void 0 ? void 0 : _a.contentType) !== null && _b !== void 0 ? _b : 'missing'}`);
+        }
+        return pkg;
+    }
+    setPartShortcut(part, relationshipType) {
+        if (relationshipType === Namespaces.DOCUMENT || relationshipType === Namespaces.DOCUMENT_STRICT) {
+            this.workbookPart = part;
+            return true;
+        }
+        return super.setPartShortcut(part, relationshipType);
+    }
+    getWorkbookPart() {
+        if (!this.workbookPart)
+            throw new Docx4JException('No workbook part');
+        return this.workbookPart;
+    }
+    get progId() {
+        return 'Excel.Sheet';
+    }
+}
+registerPackageClass(MAIN_CONTENT_TYPES, SpreadsheetMLPackage);

package/dist/packages/WordprocessingMLPackage.d.mts

@@ -0,0 +1,49 @@
+import { OpcPackage, type PackageSource } from './OpcPackage.mjs';
+import type { LoadOptions } from '../opc/Load.mjs';
+import type { Part } from '../parts/Part.mjs';
+import { MainDocumentPart } from '../parts/wml/index.mjs';
+import type { Body, Address, Outline, OutlineParagraph, OutlineTable } from '../model/content/Body.mjs';
+import type { Paragraph } from '../model/content/Paragraph.mjs';
+/** The outline of a document: the body's paragraphs and tables, then each header's and footer's (loaded ones only). */
+export interface DocumentOutline extends Outline {
+    headers: {
+        relId: string;
+        partName: string;
+        paragraphs: OutlineParagraph[];
+        tables: OutlineTable[];
+    }[];
+    footers: {
+        relId: string;
+        partName: string;
+        paragraphs: OutlineParagraph[];
+        tables: OutlineTable[];
+    }[];
+}
+/** docx4j PageSizePaper. */
+export type PageSizePaper = 'LETTER' | 'LEGAL' | 'A3' | 'A4' | 'A5' | 'B4JIS';
+export interface CreatePackageOptions {
+    pageSize?: PageSizePaper;
+    landscape?: boolean;
+}
+/** A docx (docx4j WordprocessingMLPackage). */
+export declare class WordprocessingMLPackage extends OpcPackage {
+    mainDocumentPart: MainDocumentPart | undefined;
+    static load(source: PackageSource, options?: LoadOptions): Promise<WordprocessingMLPackage>;
+    /**
+     * A new document with a main document part (one section, the page size and 2.54 cm margins),
+     * docx4j's default styles, settings, and core and extended properties (docx4j createPackage).
+     */
+    static createPackage(options?: CreatePackageOptions): Promise<WordprocessingMLPackage>;
+    setPartShortcut(part: Part, relationshipType: string): boolean;
+    /** The main document part; throws if the package has none. */
+    getMainDocumentPart(): MainDocumentPart;
+    /** Office JS `document.body`: the main document part's body; the part must be unmarshalled (`getBody()` does that). */
+    get body(): Body;
+    getBody(): Promise<Body>;
+    /** The paragraph at an address anywhere in the document: 'body/3', 'header:rId5/0', a paraId, or a text match. */
+    paragraphAt(address: Address): Promise<Paragraph | undefined>;
+    /** Every paragraph and table with its address, style and text (CR-002 section 3.3). Unmarshals the main part, headers and footers. */
+    outline(): Promise<DocumentOutline>;
+    private bodies;
+    protected get progId(): string;
+}

package/dist/packages/WordprocessingMLPackage.mjs

@@ -0,0 +1,130 @@
+import { OpcPackage } from './OpcPackage.mjs';
+import { registerPackageClass } from './registry.mjs';
+import { ContentTypes } from '../opc/ContentTypes.mjs';
+import { Docx4JException } from '../opc/exceptions.mjs';
+import { Namespaces } from '../parts/Namespaces.mjs';
+import { MainDocumentPart, StyleDefinitionsPart, DocumentSettingsPart } from '../parts/wml/index.mjs';
+import { DocPropsCorePart, DocPropsExtendedPart } from '../parts/docProps/index.mjs';
+import { DEFAULT_STYLES_XML } from '../parts/wml/defaultStyles.mjs';
+import { HeaderPart, FooterPart } from '../parts/wml/index.mjs';
+const MAIN_CONTENT_TYPES = [
+    ContentTypes.WORDPROCESSINGML_DOCUMENT,
+    ContentTypes.WORDPROCESSINGML_DOCUMENT_MACROENABLED,
+    ContentTypes.WORDPROCESSINGML_TEMPLATE,
+    ContentTypes.WORDPROCESSINGML_TEMPLATE_MACROENABLED,
+];
+/** Portrait width and height in twips, and the `w:code`, as docx4j PageDimensions. */
+const PAGE_SIZES = {
+    LETTER: [12240, 15840, 1],
+    LEGAL: [12240, 20160, 5],
+    A3: [16839, 23814, 8],
+    A4: [11907, 16839, 9],
+    A5: [8391, 11907, 11],
+    B4JIS: [14572, 20639, 12],
+};
+/** A docx (docx4j WordprocessingMLPackage). */
+export class WordprocessingMLPackage extends OpcPackage {
+    static async load(source, options) {
+        var _a, _b;
+        const pkg = await OpcPackage.load(source, options);
+        if (!(pkg instanceof WordprocessingMLPackage)) {
+            throw new Docx4JException(`Not a WordprocessingML package: main part is ${(_b = (_a = pkg.getMainPart()) === null || _a === void 0 ? void 0 : _a.contentType) !== null && _b !== void 0 ? _b : 'missing'}`);
+        }
+        return pkg;
+    }
+    /**
+     * A new document with a main document part (one section, the page size and 2.54 cm margins),
+     * docx4j's default styles, settings, and core and extended properties (docx4j createPackage).
+     */
+    static async createPackage(options = {}) {
+        var _a;
+        const pkg = new WordprocessingMLPackage();
+        const [pw, ph, code] = PAGE_SIZES[(_a = options.pageSize) !== null && _a !== void 0 ? _a : 'A4'];
+        const landscape = options.landscape === true;
+        const pgSz = { w: landscape ? ph : pw, h: landscape ? pw : ph, code };
+        if (landscape)
+            pgSz.orient = 'landscape';
+        const pgMar = { top: 1440, right: 1440, bottom: 1440, left: 1440, header: 708, footer: 708, gutter: 0 };
+        const document = { body: { content: [], sectPr: { pgSz, pgMar } } };
+        const main = new MainDocumentPart();
+        main.setContents(document);
+        pkg.addTargetPart(main);
+        const styles = new StyleDefinitionsPart();
+        styles.setXml(DEFAULT_STYLES_XML);
+        main.addTargetPart(styles);
+        const settings = new DocumentSettingsPart();
+        settings.setContents({});
+        main.addTargetPart(settings);
+        const core = new DocPropsCorePart();
+        core.setContents({});
+        pkg.addTargetPart(core);
+        const app = new DocPropsExtendedPart();
+        app.setContents({});
+        pkg.addTargetPart(app);
+        return pkg;
+    }
+    setPartShortcut(part, relationshipType) {
+        if (relationshipType === Namespaces.DOCUMENT || relationshipType === Namespaces.DOCUMENT_STRICT) {
+            this.mainDocumentPart = part;
+            return true;
+        }
+        return super.setPartShortcut(part, relationshipType);
+    }
+    /** The main document part; throws if the package has none. */
+    getMainDocumentPart() {
+        if (!this.mainDocumentPart)
+            throw new Docx4JException('No main document part');
+        return this.mainDocumentPart;
+    }
+    /** Office JS `document.body`: the main document part's body; the part must be unmarshalled (`getBody()` does that). */
+    get body() {
+        return this.getMainDocumentPart().body;
+    }
+    async getBody() {
+        return this.getMainDocumentPart().getBody();
+    }
+    /** The paragraph at an address anywhere in the document: 'body/3', 'header:rId5/0', a paraId, or a text match. */
+    async paragraphAt(address) {
+        for (const body of await this.bodies(address)) {
+            const p = body.paragraphAt(address);
+            if (p)
+                return p;
+        }
+        return undefined;
+    }
+    /** Every paragraph and table with its address, style and text (CR-002 section 3.3). Unmarshals the main part, headers and footers. */
+    async outline() {
+        var _a, _b, _c, _d;
+        const main = await this.getBody();
+        const out = { ...main.outline(), headers: [], footers: [] };
+        for (const part of this.getMainDocumentPart().headerParts) {
+            const body = await part.getBody();
+            out.headers.push({ relId: (_b = (_a = part.sourceRelationship) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : '', partName: part.partName.name, ...body.outline() });
+        }
+        for (const part of this.getMainDocumentPart().footerParts) {
+            const body = await part.getBody();
+            out.footers.push({ relId: (_d = (_c = part.sourceRelationship) === null || _c === void 0 ? void 0 : _c.id) !== null && _d !== void 0 ? _d : '', partName: part.partName.name, ...body.outline() });
+        }
+        return out;
+    }
+    async bodies(address) {
+        const main = this.getMainDocumentPart();
+        if (typeof address === 'string' && !address.startsWith('w14:')) {
+            const prefix = address.split('/')[0];
+            if (prefix === 'body')
+                return [await main.getBody()];
+            const [kind, relId] = prefix.split(':');
+            const parts = kind === 'header' ? main.headerParts : kind === 'footer' ? main.footerParts : [];
+            const part = parts.find((p) => { var _a; return ((_a = p.sourceRelationship) === null || _a === void 0 ? void 0 : _a.id) === relId || p.partName.fileName === relId; });
+            return part instanceof HeaderPart || part instanceof FooterPart ? [await part.getBody()] : [];
+        }
+        const all = [await main.getBody()];
+        for (const part of [...main.headerParts, ...main.footerParts])
+            all.push(await part.getBody());
+        return all;
+    }
+    get progId() {
+        return 'Word.Document';
+    }
+}
+registerPackageClass(MAIN_CONTENT_TYPES, WordprocessingMLPackage);

package/dist/packages/index.d.mts

@@ -0,0 +1,5 @@
+export { OpcPackage, type PackageSource } from './OpcPackage.mjs';
+export { WordprocessingMLPackage, type PageSizePaper, type CreatePackageOptions } from './WordprocessingMLPackage.mjs';
+export { PresentationMLPackage } from './PresentationMLPackage.mjs';
+export { SpreadsheetMLPackage } from './SpreadsheetMLPackage.mjs';
+export { registerPackageClass, createPackageForContentType, type PackageConstructor } from './registry.mjs';

package/dist/packages/index.mjs

@@ -0,0 +1,6 @@
+// Packages: OpcPackage and the three Office kinds. Importing this module registers all four.
+export { OpcPackage } from './OpcPackage.mjs';
+export { WordprocessingMLPackage } from './WordprocessingMLPackage.mjs';
+export { PresentationMLPackage } from './PresentationMLPackage.mjs';
+export { SpreadsheetMLPackage } from './SpreadsheetMLPackage.mjs';
+export { registerPackageClass, createPackageForContentType } from './registry.mjs';

package/dist/packages/registry.d.mts

@@ -0,0 +1,7 @@
+import type { OpcPackage } from './OpcPackage.mjs';
+export type PackageConstructor = new () => OpcPackage;
+/** Called by each package module on evaluation; keeps `OpcPackage.load` free of subclass imports. */
+export declare function registerPackageClass(mainContentTypes: readonly string[], ctor: PackageConstructor): void;
+export declare function registerGenericPackageClass(ctor: PackageConstructor): void;
+/** The package class for a main part's content type; `OpcPackage` for anything else. */
+export declare function createPackageForContentType(mainPartContentType: string | undefined): OpcPackage;

package/dist/packages/registry.mjs

@@ -0,0 +1,18 @@
+const byMainContentType = new Map();
+let generic;
+/** Called by each package module on evaluation; keeps `OpcPackage.load` free of subclass imports. */
+export function registerPackageClass(mainContentTypes, ctor) {
+    for (const ct of mainContentTypes)
+        byMainContentType.set(ct, ctor);
+}
+export function registerGenericPackageClass(ctor) {
+    generic = ctor;
+}
+/** The package class for a main part's content type; `OpcPackage` for anything else. */
+export function createPackageForContentType(mainPartContentType) {
+    var _a;
+    const ctor = (_a = (mainPartContentType !== undefined ? byMainContentType.get(mainPartContentType) : undefined)) !== null && _a !== void 0 ? _a : generic;
+    if (!ctor)
+        throw new Error('No package class registered');
+    return new ctor();
+}

package/dist/parts/BinaryPart.d.mts

@@ -0,0 +1,38 @@
+import { Part } from './Part.mjs';
+import { PartName } from '../opc/PartName.mjs';
+/** A part whose content is bytes (docx4j BinaryPart): images, fonts, embeddings, anything unknown. */
+export declare class BinaryPart extends Part {
+    private bytes;
+    constructor(partName: PartName | string, contentType?: string, relationshipType?: string);
+    get isLoaded(): boolean;
+    get compress(): boolean;
+    /** The bytes, loaded from the source container on first call. */
+    getBytes(): Promise<Uint8Array>;
+    setBytes(bytes: Uint8Array): void;
+}
+/** An image of any kind (docx4j BinaryPartAbstractImage and its Image*Part subclasses); the kind is the content type. */
+export declare class ImagePart extends BinaryPart {
+    constructor(partName: PartName | string, contentType: string);
+}
+/** An embedded Office package, e.g. an .xlsx behind a chart (docx4j EmbeddedPackagePart). Stored, not deflated. */
+export declare class EmbeddedPackagePart extends BinaryPart {
+    constructor(partName: PartName | string, contentType: string);
+    get compress(): boolean;
+}
+/** An OLE object's binary (docx4j OleObjectBinaryPart). */
+export declare class OleObjectBinaryPart extends BinaryPart {
+    constructor(partName: PartName | string, contentType?: string);
+}
+/** An obfuscated embedded font (docx4j ObfuscatedFontPart). */
+export declare class ObfuscatedFontPart extends BinaryPart {
+    constructor(partName: PartName | string);
+}
+/** A TrueType font part (docx4j TrueTypeFontPart). */
+export declare class TrueTypeFontPart extends BinaryPart {
+    constructor(partName: PartName | string);
+}
+/** An altChunk's content, HTML, RTF, plain text or another docx (docx4j AlternativeFormatInputPart). */
+export declare class AlternativeFormatInputPart extends BinaryPart {
+    constructor(partName: PartName | string, contentType: string);
+    get compress(): boolean;
+}

package/dist/parts/BinaryPart.mjs

@@ -0,0 +1,72 @@
+import { Part } from './Part.mjs';
+import { ContentTypes, isStoredUncompressed } from '../opc/ContentTypes.mjs';
+import { Namespaces } from './Namespaces.mjs';
+import { Docx4JException } from '../opc/exceptions.mjs';
+/** A part whose content is bytes (docx4j BinaryPart): images, fonts, embeddings, anything unknown. */
+export class BinaryPart extends Part {
+    constructor(partName, contentType = ContentTypes.OCTET_STREAM, relationshipType = '') {
+        super(partName, contentType, relationshipType);
+    }
+    get isLoaded() {
+        return this.bytes !== undefined;
+    }
+    get compress() {
+        return !isStoredUncompressed(this.contentType);
+    }
+    /** The bytes, loaded from the source container on first call. */
+    async getBytes() {
+        if (this.bytes === undefined) {
+            const loaded = await this.loadSourceBytes();
+            if (loaded === undefined)
+                throw new Docx4JException(`Part ${this.partName} has no content and no source container`);
+            this.bytes = loaded;
+        }
+        return this.bytes;
+    }
+    setBytes(bytes) {
+        this.bytes = bytes;
+    }
+}
+/** An image of any kind (docx4j BinaryPartAbstractImage and its Image*Part subclasses); the kind is the content type. */
+export class ImagePart extends BinaryPart {
+    constructor(partName, contentType) {
+        super(partName, contentType, Namespaces.IMAGE);
+    }
+}
+/** An embedded Office package, e.g. an .xlsx behind a chart (docx4j EmbeddedPackagePart). Stored, not deflated. */
+export class EmbeddedPackagePart extends BinaryPart {
+    constructor(partName, contentType) {
+        super(partName, contentType, Namespaces.EMBEDDED_PKG);
+    }
+    get compress() {
+        return false;
+    }
+}
+/** An OLE object's binary (docx4j OleObjectBinaryPart). */
+export class OleObjectBinaryPart extends BinaryPart {
+    constructor(partName, contentType = ContentTypes.OFFICEDOCUMENT_OLE_OBJECT) {
+        super(partName, contentType, Namespaces.OLE_OBJECT);
+    }
+}
+/** An obfuscated embedded font (docx4j ObfuscatedFontPart). */
+export class ObfuscatedFontPart extends BinaryPart {
+    constructor(partName) {
+        super(partName, ContentTypes.OFFICEDOCUMENT_FONT, Namespaces.FONT);
+    }
+}
+/** A TrueType font part (docx4j TrueTypeFontPart). */
+export class TrueTypeFontPart extends BinaryPart {
+    constructor(partName) {
+        super(partName, ContentTypes.TRUETYPE_FONT, Namespaces.FONT);
+    }
+}
+/** An altChunk's content, HTML, RTF, plain text or another docx (docx4j AlternativeFormatInputPart). */
+export class AlternativeFormatInputPart extends BinaryPart {
+    constructor(partName, contentType) {
+        super(partName, contentType, Namespaces.AF);
+    }
+    get compress() {
+        // docx4j: a WordprocessingML altChunk is a zip already
+        return !(this.contentType.includes('wordprocessingml') || this.contentType.includes('ms-word'));
+    }
+}

package/dist/parts/DefaultXmlPart.d.mts

@@ -0,0 +1,29 @@
+import { Part } from './Part.mjs';
+import { PartName } from '../opc/PartName.mjs';
+/**
+ * An XML part the object model does not type, held as a DOM (docx4j DefaultXmlPart / XmlPart).
+ * The document is parsed on first `getDocument()`; a part whose document was never requested is
+ * written back from its source bytes.
+ */
+export declare class DefaultXmlPart extends Part {
+    private document;
+    private bytes;
+    constructor(partName: PartName | string, contentType?: string, relationshipType?: string);
+    get isLoaded(): boolean;
+    get isParsed(): boolean;
+    getDocument(): Promise<Document>;
+    setDocument(document: Document): void;
+    setXml(xml: string): void;
+    getXml(): Promise<string>;
+    getBytes(): Promise<Uint8Array>;
+}
+/**
+ * A custom XML data storage part (docx4j CustomXmlDataStoragePart): the customer's own XML,
+ * held as a DOM. Its `itemId` comes from the sibling properties part and is the key in
+ * `OpcPackage.customXmlDataStorageParts`.
+ */
+export declare class CustomXmlDataStoragePart extends DefaultXmlPart {
+    /** The `ds:itemID` of the sibling properties part, lower-cased, once registered. */
+    itemId: string | undefined;
+    constructor(partName: PartName | string, contentType?: string);
+}

package/dist/parts/DefaultXmlPart.mjs

@@ -0,0 +1,63 @@
+import { Part } from './Part.mjs';
+import { ContentTypes } from '../opc/ContentTypes.mjs';
+import { Namespaces } from './Namespaces.mjs';
+import { Docx4JException } from '../opc/exceptions.mjs';
+import { parseXml, serializeXmlPart, encodeText, decodeXmlText } from '../xml/dom.mjs';
+/**
+ * An XML part the object model does not type, held as a DOM (docx4j DefaultXmlPart / XmlPart).
+ * The document is parsed on first `getDocument()`; a part whose document was never requested is
+ * written back from its source bytes.
+ */
+export class DefaultXmlPart extends Part {
+    constructor(partName, contentType = ContentTypes.APPLICATION_XML, relationshipType = '') {
+        super(partName, contentType, relationshipType);
+    }
+    get isLoaded() {
+        return this.document !== undefined || this.bytes !== undefined;
+    }
+    get isParsed() {
+        return this.document !== undefined;
+    }
+    async getDocument() {
+        var _a;
+        if (this.document === undefined) {
+            const bytes = (_a = this.bytes) !== null && _a !== void 0 ? _a : (await this.loadSourceBytes());
+            if (bytes === undefined)
+                throw new Docx4JException(`Part ${this.partName} has no content: set a document or load it from a container`);
+            this.document = parseXml(decodeXmlText(bytes));
+            this.bytes = undefined;
+        }
+        return this.document;
+    }
+    setDocument(document) {
+        this.document = document;
+        this.bytes = undefined;
+    }
+    setXml(xml) {
+        this.bytes = encodeText(xml);
+        this.document = undefined;
+    }
+    async getXml() {
+        return decodeXmlText(await this.getBytes());
+    }
+    async getBytes() {
+        if (this.document !== undefined)
+            return encodeText(serializeXmlPart(this.document));
+        if (this.bytes !== undefined)
+            return this.bytes;
+        const loaded = await this.loadSourceBytes();
+        if (loaded === undefined)
+            throw new Docx4JException(`Part ${this.partName} has no content and no source container`);
+        return loaded;
+    }
+}
+/**
+ * A custom XML data storage part (docx4j CustomXmlDataStoragePart): the customer's own XML,
+ * held as a DOM. Its `itemId` comes from the sibling properties part and is the key in
+ * `OpcPackage.customXmlDataStorageParts`.
+ */
+export class CustomXmlDataStoragePart extends DefaultXmlPart {
+    constructor(partName, contentType = ContentTypes.OFFICEDOCUMENT_CUSTOMXML_DATASTORAGE) {
+        super(partName, contentType, Namespaces.CUSTOM_XML_DATA_STORAGE);
+    }
+}

package/dist/parts/Namespaces.d.mts

@@ -0,0 +1,99 @@
+/** Relationship types and namespaces, as docx4j org.docx4j.openpackaging.parts.relationships.Namespaces. */
+export declare const Namespaces: {
+    readonly CONTENT_TYPES: "http://schemas.openxmlformats.org/package/2006/content-types";
+    readonly RELATIONSHIPS: "http://schemas.openxmlformats.org/package/2006/relationships";
+    readonly RELATIONSHIPS_OFFICEDOC: "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+    readonly NS_WORD12: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+    readonly PKG_XML: "http://schemas.microsoft.com/office/2006/xmlPackage";
+    readonly MARKUP_COMPATIBILITY: "http://schemas.openxmlformats.org/markup-compatibility/2006";
+    readonly DIGITAL_SIGNATURE: "http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/signature";
+    readonly DIGITAL_SIGNATURE_CERTIFICATE: "http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/certificate";
+    readonly DIGITAL_SIGNATURE_ORIGIN: "http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/origin";
+    readonly PROPERTIES_CORE: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties";
+    readonly PROPERTIES_EXTENDED: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties";
+    readonly PROPERTIES_CUSTOM: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/custom-properties";
+    readonly PROPERTIES_COVERPAGE: "http://schemas.microsoft.com/office/2006/coverPageProps";
+    readonly IMAGE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
+    readonly THUMBNAIL: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail";
+    readonly METADATA_THUMBNAIL: "http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail";
+    readonly DOCUMENT: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
+    readonly DOCUMENT_STRICT: "http://purl.oclc.org/ooxml/officeDocument/relationships/officeDocument";
+    readonly HYPERLINK: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
+    readonly CUSTOM_XML_DATA_STORAGE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXml";
+    readonly CUSTOM_XML_DATA_STORAGE_PROPERTIES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/customXmlProps";
+    readonly WEB_SETTINGS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings";
+    readonly SETTINGS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings";
+    readonly STYLES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles";
+    readonly THEME: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme";
+    readonly THEME_OVERRIDE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/themeOverride";
+    readonly FONT_TABLE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable";
+    readonly FONT: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font";
+    readonly HEADER: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header";
+    readonly FOOTER: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer";
+    readonly GLOSSARY_DOCUMENT: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/glossaryDocument";
+    readonly NUMBERING: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering";
+    readonly FOOTNOTES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes";
+    readonly ENDNOTES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes";
+    readonly COMMENTS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
+    readonly COMMENTS_EXTENDED: "http://schemas.microsoft.com/office/2011/relationships/commentsExtended";
+    readonly COMMENTS_IDS: "http://schemas.microsoft.com/office/2016/09/relationships/commentsIds";
+    readonly COMMENTS_EXTENSIBLE: "http://schemas.microsoft.com/office/2018/08/relationships/commentsExtensible";
+    readonly OFFICE_2011_PEOPLE: "http://schemas.microsoft.com/office/2011/relationships/people";
+    readonly AF: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/aFChunk";
+    readonly SUBDOCUMENT: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/subDocument";
+    readonly ATTACHED_TEMPLATE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/attachedTemplate";
+    readonly VBA_PROJECT: "http://schemas.microsoft.com/office/2006/relationships/vbaProject";
+    readonly VBA_DATA_WORD: "http://schemas.microsoft.com/office/2006/relationships/wordVbaData";
+    readonly KEYMAP: "http://schemas.microsoft.com/office/2006/relationships/keyMapCustomizations";
+    readonly VBA_PROJECT_SIGNATURE: "http://schemas.microsoft.com/office/2006/relationships/vbaProjectSignature";
+    readonly OLE_OBJECT: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/oleObject";
+    readonly EMBEDDED_PKG: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/package";
+    readonly ACTIVEX_XML_OBJECT: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/control";
+    readonly VML: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/vmlDrawing";
+    readonly CHART_EX: "http://schemas.microsoft.com/office/2014/relationships/chartEx";
+    readonly CHART_COLOR_STYLE: "http://schemas.microsoft.com/office/2011/relationships/chartColorStyle";
+    readonly CHART_STYLE: "http://schemas.microsoft.com/office/2011/relationships/chartStyle";
+    readonly DRAWINGML_DIAGRAM_DATA: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramData";
+    readonly DRAWINGML_DIAGRAM_LAYOUT: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramLayout";
+    readonly DRAWINGML_DIAGRAM_COLORS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramColors";
+    readonly DRAWINGML_DIAGRAM_STYLE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramQuickStyle";
+    readonly DRAWINGML_DIAGRAM_LAYOUT_HEADER: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/diagramLayoutHeader";
+    readonly DRAWINGML_DIAGRAM_DRAWING: "http://schemas.microsoft.com/office/2007/relationships/diagramDrawing";
+    readonly PRESENTATIONML_COMMENTS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
+    readonly PRESENTATIONML_COMMENT_AUTHORS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/commentAuthors";
+    readonly PRESENTATIONML_FONT_DATA: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/font";
+    readonly PRESENTATIONML_MAIN: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
+    readonly PRESENTATIONML_SLIDE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide";
+    readonly PRESENTATIONML_SLIDE_MASTER: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster";
+    readonly PRESENTATIONML_SLIDE_LAYOUT: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout";
+    readonly PRESENTATIONML_TABLE_STYLES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/tableStyles";
+    readonly PRESENTATIONML_PRES_PROPS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/presProps";
+    readonly PRESENTATIONML_VIEW_PROPS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/viewProps";
+    readonly PRESENTATIONML_TAGS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/tags";
+    readonly PRESENTATIONML_NOTES_SLIDE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide";
+    readonly PRESENTATIONML_NOTES_MASTER: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster";
+    readonly PRESENTATIONML_HANDOUT_MASTER: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/handoutMaster";
+    readonly SPREADSHEETML_WORKBOOK: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument";
+    readonly SPREADSHEETML_WORKSHEET: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet";
+    readonly SPREADSHEETML_CHARTSHEET: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartsheet";
+    readonly SPREADSHEETML_PRINTER_SETTINGS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/printerSettings";
+    readonly SPREADSHEETML_CALC_CHAIN: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/calcChain";
+    readonly SPREADSHEETML_SHARED_STRINGS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sharedStrings";
+    readonly SPREADSHEETML_STYLES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles";
+    readonly SPREADSHEETML_DRAWING: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing";
+    readonly SPREADSHEETML_CHART: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart";
+    readonly CHART_USER_SHAPES: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chartUserShapes";
+    readonly SPREADSHEETML_COMMENTS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments";
+    readonly SPREADSHEETML_PIVOT_TABLE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable";
+    readonly SPREADSHEETML_QUERY_TABLE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/queryTable";
+    readonly SPREADSHEETML_TABLE: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/table";
+    readonly SPREADSHEETML_CONNECTIONS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/connections";
+    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";
+    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";
+    readonly XFORMS: "http://www.w3.org/2002/xforms";
+    readonly XML_SCHEMA: "http://www.w3.org/2001/XMLSchema";
+};