@docx4j/core-ts 0.1.0

package/dist/parts/RelationshipsPart.mjs

@@ -0,0 +1,224 @@
+import { XmlPart } from './XmlPart.mjs';
+import { setRelationshipsPartFactory } from './Part.mjs';
+import { PartName } from '../opc/PartName.mjs';
+import { ContentTypes } from '../opc/ContentTypes.mjs';
+import { Namespaces } from './Namespaces.mjs';
+import { InvalidFormatException } from '../opc/exceptions.mjs';
+export const RELATIONSHIPS_ROOT = { namespaceURI: Namespaces.RELATIONSHIPS, localPart: 'Relationships' };
+const RELATIONSHIP_TYPE_NAME = 'org_docx4j_relationships.Relationship';
+/**
+ * A relationships part (docx4j org.docx4j.openpackaging.parts.relationships.RelationshipsPart):
+ * `/_rels/.rels` for the package, `/word/_rels/document.xml.rels` for a part. Always unmarshalled
+ * (load walks it), hence always re-marshalled on save.
+ */
+export class RelationshipsPart extends XmlPart {
+    constructor(source, partName) {
+        super(partName !== null && partName !== void 0 ? partName : (source ? PartName.relsFor(source.partName) : '/_rels/.rels'), ContentTypes.RELATIONSHIPS_PART, '', RELATIONSHIPS_ROOT);
+        this.nextId = 1;
+        this.sourceP = source;
+        if (source)
+            this.package = source.package;
+    }
+    /** The package relationships part, `/_rels/.rels`. */
+    static createPackageRels() {
+        const rp = new RelationshipsPart(undefined, '/_rels/.rels');
+        rp.setContents({ relationship: [] });
+        return rp;
+    }
+    /** A part's own, empty, relationships part. */
+    static createRelationshipsPartForPart(source) {
+        const rp = new RelationshipsPart(source);
+        rp.setContents({ relationship: [] });
+        return rp;
+    }
+    /** The name of the part these relationships belong to; '/' for the package. */
+    get sourceName() {
+        var _a, _b;
+        return (_b = (_a = this.sourceP) === null || _a === void 0 ? void 0 : _a.partName) !== null && _b !== void 0 ? _b : PartName.ROOT;
+    }
+    get isPackageRelationshipPart() {
+        return this.sourceName.name === '/';
+    }
+    /** The relationships (docx4j getRelationships()); unmarshalled parts only. */
+    get relationships() {
+        var _a;
+        const r = this.contents;
+        (_a = r.relationship) !== null && _a !== void 0 ? _a : (r.relationship = []);
+        return r;
+    }
+    /** The list of relationships, the live array. */
+    get list() {
+        return this.relationships.relationship;
+    }
+    get size() {
+        return this.list.length;
+    }
+    getRelationshipById(id) {
+        return this.list.find((r) => r.id === id);
+    }
+    getRelationshipByType(type) {
+        return this.list.find((r) => r.type === type);
+    }
+    getRelationshipsByType(type) {
+        return this.list.filter((r) => r.type === type);
+    }
+    /** The part a relationship targets; undefined for external targets and parts not in the package. */
+    getPart(rel) {
+        var _a;
+        const r = typeof rel === 'string' ? this.getRelationshipById(rel) : rel;
+        if (!r || isExternal(r))
+            return undefined;
+        return (_a = this.package) === null || _a === void 0 ? void 0 : _a.getPart(this.resolveTarget(r));
+    }
+    /** The part name a relationship's target resolves to (internal targets only). */
+    resolveTarget(rel) {
+        return PartName.resolve(this.sourceName, rel.target);
+    }
+    /** The (first) relationship targeting a part. */
+    getRel(partName) {
+        const pn = PartName.of(partName);
+        return this.list.find((r) => !isExternal(r) && this.resolveTarget(r).equals(pn));
+    }
+    isATarget(partName) {
+        return this.getRel(partName) !== undefined;
+    }
+    /** The next free `rIdN`. */
+    getNextId() {
+        const used = new Set(this.list.map((r) => r.id));
+        let id;
+        do {
+            id = `rId${this.nextId++}`;
+        } while (used.has(id));
+        return id;
+    }
+    /** Adds a relationship; allocates an id when it has none or its id is taken. Returns the id. */
+    addRelationship(rel) {
+        if (!rel.id || this.getRelationshipById(rel.id))
+            rel.id = this.getNextId();
+        if (!rel.TYPE_NAME)
+            rel.TYPE_NAME = RELATIONSHIP_TYPE_NAME;
+        this.list.push(rel);
+        return rel.id;
+    }
+    /** An external relationship (a hyperlink, a linked image). */
+    addExternalRelationship(type, target, relId) {
+        const rel = { TYPE_NAME: RELATIONSHIP_TYPE_NAME, id: relId !== null && relId !== void 0 ? relId : '', type, target, targetMode: 'External' };
+        this.addRelationship(rel);
+        return rel;
+    }
+    /**
+     * Adds a part as a target (docx4j addPart): registers it in the package and its content type,
+     * writes a relationship whose target is relative to the source part, and returns that
+     * relationship. `mode` says what to do when the name is taken (default OVERWRITE_IF_NAME_EXISTS).
+     */
+    addPart(part, mode = 'OVERWRITE_IF_NAME_EXISTS', relId) {
+        const pkg = this.package;
+        if (!pkg)
+            throw new InvalidFormatException('Relationships part has no package');
+        let newPartName = part.partName;
+        const existing = pkg.getPart(newPartName);
+        if (existing) {
+            if (mode === 'REUSE_EXISTING')
+                part = existing;
+            if (mode === 'RENAME_IF_NAME_EXISTS') {
+                newPartName = this.newPartName(part.partName);
+                part.partName = newPartName;
+            }
+        }
+        const target = PartName.relativize(this.sourceName, part.partName);
+        const existsAlready = this.list.find((r) => r.target === target);
+        if (existsAlready && mode === 'REUSE_EXISTING')
+            return existsAlready;
+        if (existsAlready && mode === 'RENAME_IF_NAME_EXISTS') {
+            throw new InvalidFormatException('Found existing rel, and yet constructed part name should be globally unique');
+        }
+        if (existsAlready && existing && mode === 'OVERWRITE_IF_NAME_EXISTS') {
+            existsAlready.type = part.relationshipType;
+            this.loadPart(part, existsAlready);
+            return existsAlready;
+        }
+        const rel = { TYPE_NAME: RELATIONSHIP_TYPE_NAME, id: relId !== null && relId !== void 0 ? relId : '', type: part.relationshipType, target };
+        this.addRelationship(rel);
+        pkg.contentTypeManager.addContentType(part.partName, part.contentType);
+        this.loadPart(part, rel);
+        return rel;
+    }
+    /** Links a part into the package as the target of a relationship of this part (docx4j loadPart). */
+    loadPart(part, sourceRelationship) {
+        const pkg = this.package;
+        if (!pkg)
+            throw new InvalidFormatException('Relationships part has no package');
+        part.owningRelationshipPart = this;
+        part.sourceRelationships.push(sourceRelationship);
+        part.package = pkg;
+        pkg.parts.put(part);
+    }
+    /** Removes the relationship to a part, the part, and (recursively) the parts only it related to. Returns what was removed. */
+    removePart(partName) {
+        const pn = PartName.of(partName);
+        const removed = [];
+        const pkg = this.package;
+        const part = pkg === null || pkg === void 0 ? void 0 : pkg.getPart(pn);
+        if (!part || !pkg)
+            return removed;
+        this.removeRelationship(pn);
+        if (part.relationshipsPart)
+            removed.push(...part.relationshipsPart.removeParts());
+        pkg.parts.remove(pn);
+        removed.push(pn);
+        return removed;
+    }
+    /** Removes every part these relationships target (docx4j removeParts), recursively. */
+    removeParts() {
+        var _a;
+        const removed = [];
+        for (const rel of [...this.list]) {
+            if (isExternal(rel))
+                continue;
+            const pn = this.resolveTarget(rel);
+            const part = (_a = this.package) === null || _a === void 0 ? void 0 : _a.getPart(pn);
+            // A part targeted by another relationship elsewhere stays; only its link from here goes.
+            if (part && part.sourceRelationships.length <= 1)
+                removed.push(...this.removePart(pn));
+            else
+                this.removeRelationship(rel);
+        }
+        return removed;
+    }
+    /** Removes a relationship, by object or by the part it targets. */
+    removeRelationship(rel) {
+        var _a;
+        const r = typeof rel === 'object' && !(rel instanceof PartName) ? rel : this.getRel(rel);
+        if (!r)
+            return;
+        const i = this.list.indexOf(r);
+        if (i >= 0)
+            this.list.splice(i, 1);
+        const target = isExternal(r) ? undefined : (_a = this.package) === null || _a === void 0 ? void 0 : _a.getPart(this.resolveTarget(r));
+        if (target) {
+            const j = target.sourceRelationships.indexOf(r);
+            if (j >= 0)
+                target.sourceRelationships.splice(j, 1);
+        }
+    }
+    removeRelationshipsByType(type) {
+        for (const r of this.getRelationshipsByType(type))
+            this.removeRelationship(r);
+    }
+    newPartName(proposed) {
+        const pkg = this.package;
+        const name = proposed.name;
+        const dot = name.lastIndexOf('.');
+        const prefix = dot > name.lastIndexOf('/') ? name.substring(0, dot) : name;
+        const suffix = dot > name.lastIndexOf('/') ? name.substring(dot) : '';
+        for (let i = 2;; i++) {
+            const candidate = PartName.of(`${prefix}${i}${suffix}`);
+            if (!pkg.getPart(candidate))
+                return candidate;
+        }
+    }
+}
+export function isExternal(rel) {
+    return rel.targetMode === 'External';
+}
+setRelationshipsPartFactory((source) => RelationshipsPart.createRelationshipsPartForPart(source));

package/dist/parts/XmlPart.d.mts

@@ -0,0 +1,46 @@
+import { type Jsonix } from '@docx4j/generated-objects-ts';
+import { Part } from './Part.mjs';
+import { PartName } from '../opc/PartName.mjs';
+/** A qualified name for a part's root element. */
+export interface RootName {
+    namespaceURI: string;
+    localPart: string;
+}
+/** A hook run over the DOM before unmarshalling (the MCE preprocessor); set by the package on load. */
+export type DomPreprocessor = (doc: Document, part?: XmlPart<unknown>) => void;
+/**
+ * A part whose content is a typed element of the object model (docx4j JaxbXmlPart<E>). `T` is the
+ * root element's value type (`Document`, `Styles`, ...). Contents are unmarshalled on first
+ * `getContents()`; once unmarshalled, `contents` is a plain property. A part that was never
+ * unmarshalled is written back from its source bytes on save.
+ */
+export declare class XmlPart<T = unknown> extends Part {
+    private element;
+    private bytes;
+    /** Root element name used when contents are set on a new part; subclasses set it. */
+    rootName: RootName | undefined;
+    /** Runs over the DOM before unmarshalling; the package sets its MCE preprocessor here. */
+    preprocessor: DomPreprocessor | undefined;
+    constructor(partName: PartName | string, contentType: string, relationshipType: string, rootName?: RootName);
+    /** True once contents were unmarshalled or set; the part is then re-marshalled on save. */
+    get isUnmarshalled(): boolean;
+    get isLoaded(): boolean;
+    /** The unmarshalled contents (docx4j getJaxbElement()); throws when not yet unmarshalled. */
+    get contents(): T;
+    /** The root element as [name, value]; undefined until unmarshalled. */
+    get typedElement(): Jsonix.TypedNamedValue<T> | undefined;
+    /** Unmarshals on first call (docx4j getContents()). */
+    getContents(): Promise<T>;
+    /** Replaces the contents (docx4j setJaxbElement / setContents). The root name defaults to the part's. */
+    setContents(value: T, rootName?: RootName): void;
+    /** Replaces the contents with raw XML bytes; they are unmarshalled on the next getContents(). */
+    setBytes(bytes: Uint8Array): void;
+    /** Replaces the contents with XML text (docx4j setContents from a string). */
+    setXml(xml: string): void;
+    /** The XML as it would be saved (docx4j XmlUtils.marshaltoString on the part). */
+    getXml(): Promise<string>;
+    /** Marshalled bytes when unmarshalled or set, else the source bytes untouched. */
+    getBytes(): Promise<Uint8Array>;
+    /** The root element as a DOM element (docx4j XmlUtils.marshaltoW3CDomDocument). */
+    marshalToNode(): Promise<Element>;
+}

package/dist/parts/XmlPart.mjs

@@ -0,0 +1,87 @@
+import { unmarshalNode, marshalNode } from '@docx4j/generated-objects-ts';
+import { Part } from './Part.mjs';
+import { Docx4JException } from '../opc/exceptions.mjs';
+import { parseXml, serializeXml, encodeText, decodeXmlText, XML_DECLARATION } from '../xml/dom.mjs';
+/**
+ * A part whose content is a typed element of the object model (docx4j JaxbXmlPart<E>). `T` is the
+ * root element's value type (`Document`, `Styles`, ...). Contents are unmarshalled on first
+ * `getContents()`; once unmarshalled, `contents` is a plain property. A part that was never
+ * unmarshalled is written back from its source bytes on save.
+ */
+export class XmlPart extends Part {
+    constructor(partName, contentType, relationshipType, rootName) {
+        super(partName, contentType, relationshipType);
+        this.rootName = rootName;
+    }
+    /** True once contents were unmarshalled or set; the part is then re-marshalled on save. */
+    get isUnmarshalled() {
+        return this.element !== undefined;
+    }
+    get isLoaded() {
+        return this.element !== undefined || this.bytes !== undefined;
+    }
+    /** The unmarshalled contents (docx4j getJaxbElement()); throws when not yet unmarshalled. */
+    get contents() {
+        if (this.element === undefined)
+            throw new Docx4JException(`Part ${this.partName} is not unmarshalled yet; await getContents() first`);
+        return this.element.value;
+    }
+    /** The root element as [name, value]; undefined until unmarshalled. */
+    get typedElement() {
+        return this.element;
+    }
+    /** Unmarshals on first call (docx4j getContents()). */
+    async getContents() {
+        var _a, _b, _c;
+        if (this.element === 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 contents or load it from a container`);
+            const doc = parseXml(decodeXmlText(bytes));
+            (_b = this.preprocessor) === null || _b === void 0 ? void 0 : _b.call(this, doc, this);
+            this.element = await unmarshalNode(doc);
+            (_c = this.rootName) !== null && _c !== void 0 ? _c : (this.rootName = { namespaceURI: this.element.name.namespaceURI, localPart: this.element.name.localPart });
+            this.bytes = undefined;
+        }
+        return this.element.value;
+    }
+    /** Replaces the contents (docx4j setJaxbElement / setContents). The root name defaults to the part's. */
+    setContents(value, rootName) {
+        var _a, _b;
+        const name = (_b = rootName !== null && rootName !== void 0 ? rootName : (_a = this.element) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : this.rootName;
+        if (!name)
+            throw new Docx4JException(`Part ${this.partName}: no root element name; pass one`);
+        this.element = { name: { namespaceURI: name.namespaceURI, localPart: name.localPart }, value };
+        this.bytes = undefined;
+    }
+    /** Replaces the contents with raw XML bytes; they are unmarshalled on the next getContents(). */
+    setBytes(bytes) {
+        this.bytes = bytes;
+        this.element = undefined;
+    }
+    /** Replaces the contents with XML text (docx4j setContents from a string). */
+    setXml(xml) {
+        this.setBytes(encodeText(xml));
+    }
+    /** The XML as it would be saved (docx4j XmlUtils.marshaltoString on the part). */
+    async getXml() {
+        return decodeXmlText(await this.getBytes());
+    }
+    /** Marshalled bytes when unmarshalled or set, else the source bytes untouched. */
+    async getBytes() {
+        if (this.element !== undefined)
+            return encodeText(XML_DECLARATION + serializeXml(await this.marshalToNode()));
+        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;
+    }
+    /** The root element as a DOM element (docx4j XmlUtils.marshaltoW3CDomDocument). */
+    async marshalToNode() {
+        if (this.element === undefined)
+            await this.getContents();
+        return marshalNode(this.element);
+    }
+}

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

@@ -0,0 +1,9 @@
+import type * as props from '@docx4j/generated-objects-ts/modules/org_docx4j_customXmlProperties';
+import { XmlPart } from '../XmlPart.mjs';
+import { PartName } from '../../opc/PartName.mjs';
+export declare const DS_NS = "http://schemas.openxmlformats.org/officeDocument/2006/customXml";
+/** `/customXml/itemProps1.xml`: the `ds:datastoreItem` with the itemID and schema references. */
+export declare class CustomXmlDataStoragePropertiesPart extends XmlPart<props.DatastoreItem> {
+    constructor(partName: PartName | string);
+}
+export { CustomXmlDataStoragePart } from '../DefaultXmlPart.mjs';

package/dist/parts/customXml/index.mjs

@@ -0,0 +1,11 @@
+import { XmlPart } from '../XmlPart.mjs';
+import { ContentTypes } from '../../opc/ContentTypes.mjs';
+import { Namespaces } from '../Namespaces.mjs';
+export const DS_NS = 'http://schemas.openxmlformats.org/officeDocument/2006/customXml';
+/** `/customXml/itemProps1.xml`: the `ds:datastoreItem` with the itemID and schema references. */
+export class CustomXmlDataStoragePropertiesPart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.OFFICEDOCUMENT_CUSTOMXML_DATASTORAGEPROPERTIES, Namespaces.CUSTOM_XML_DATA_STORAGE_PROPERTIES, { namespaceURI: DS_NS, localPart: 'datastoreItem' });
+    }
+}
+export { CustomXmlDataStoragePart } from '../DefaultXmlPart.mjs';

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

@@ -0,0 +1,54 @@
+import type * as dml from '@docx4j/generated-objects-ts/modules/org_docx4j_dml';
+import type * as chart from '@docx4j/generated-objects-ts/modules/org_docx4j_dml_chart';
+import type * as diagram from '@docx4j/generated-objects-ts/modules/org_docx4j_dml_diagram';
+import type * as chartDrawing from '@docx4j/generated-objects-ts/modules/org_docx4j_dml_chartDrawing';
+import type * as ssDrawing from '@docx4j/generated-objects-ts/modules/org_docx4j_dml_spreadsheetdrawing';
+import { XmlPart } from '../XmlPart.mjs';
+import { DefaultXmlPart } from '../DefaultXmlPart.mjs';
+import { PartName } from '../../opc/PartName.mjs';
+export declare class ThemePart extends XmlPart<dml.Theme> {
+    constructor(partName?: PartName | string);
+}
+export declare class ThemeOverridePart extends XmlPart<dml.CTBaseStylesOverride> {
+    constructor(partName: PartName | string);
+}
+/** A chart (docx4j org.docx4j.openpackaging.parts.DrawingML.Chart). */
+export declare class ChartPart extends XmlPart<chart.CTChartSpace> {
+    constructor(partName: PartName | string);
+}
+/** The user shapes of a chart (docx4j ChartShapePart). */
+export declare class ChartShapePart extends XmlPart<chartDrawing.CTDrawing> {
+    constructor(partName: PartName | string);
+}
+/** A spreadsheet drawing (docx4j org.docx4j.openpackaging.parts.DrawingML.Drawing). */
+export declare class DrawingPart extends XmlPart<ssDrawing.CTDrawing> {
+    constructor(partName: PartName | string);
+}
+export declare class DiagramDataPart extends XmlPart<diagram.CTDataModel> {
+    constructor(partName: PartName | string);
+}
+export declare class DiagramLayoutPart extends XmlPart<diagram.CTDiagramDefinition> {
+    constructor(partName: PartName | string);
+}
+export declare class DiagramLayoutHeaderPart extends XmlPart<diagram.CTDiagramDefinitionHeader> {
+    constructor(partName: PartName | string);
+}
+export declare class DiagramStylePart extends XmlPart<diagram.CTStyleDefinition> {
+    constructor(partName: PartName | string);
+}
+export declare class DiagramColorsPart extends XmlPart<diagram.CTColorTransform> {
+    constructor(partName: PartName | string);
+}
+/** Chart style, colour style, chartEx and diagram drawing parts: DOM until typed (later CR). */
+export declare class ChartStylePart extends DefaultXmlPart {
+    constructor(partName: PartName | string);
+}
+export declare class ChartColorStylePart extends DefaultXmlPart {
+    constructor(partName: PartName | string);
+}
+export declare class ChartExSpacePart extends DefaultXmlPart {
+    constructor(partName: PartName | string);
+}
+export declare class DiagramDrawingPart extends DefaultXmlPart {
+    constructor(partName: PartName | string);
+}

package/dist/parts/dml/index.mjs

@@ -0,0 +1,83 @@
+import { XmlPart } from '../XmlPart.mjs';
+import { DefaultXmlPart } from '../DefaultXmlPart.mjs';
+import { ContentTypes } from '../../opc/ContentTypes.mjs';
+import { Namespaces } from '../Namespaces.mjs';
+const A = 'http://schemas.openxmlformats.org/drawingml/2006/main';
+const C = 'http://schemas.openxmlformats.org/drawingml/2006/chart';
+const DGM = 'http://schemas.openxmlformats.org/drawingml/2006/diagram';
+const CDR = 'http://schemas.openxmlformats.org/drawingml/2006/chartDrawing';
+const XDR = 'http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing';
+export class ThemePart extends XmlPart {
+    constructor(partName = '/word/theme/theme1.xml') {
+        super(partName, ContentTypes.OFFICEDOCUMENT_THEME, Namespaces.THEME, { namespaceURI: A, localPart: 'theme' });
+    }
+}
+export class ThemeOverridePart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.OFFICEDOCUMENT_THEME_OVERRIDE, Namespaces.THEME_OVERRIDE, { namespaceURI: A, localPart: 'themeOverride' });
+    }
+}
+/** A chart (docx4j org.docx4j.openpackaging.parts.DrawingML.Chart). */
+export class ChartPart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.DRAWINGML_CHART, Namespaces.SPREADSHEETML_CHART, { namespaceURI: C, localPart: 'chartSpace' });
+    }
+}
+/** The user shapes of a chart (docx4j ChartShapePart). */
+export class ChartShapePart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.DRAWINGML_CHART_SHAPES, Namespaces.CHART_USER_SHAPES, { namespaceURI: CDR, localPart: 'userShapes' });
+    }
+}
+/** A spreadsheet drawing (docx4j org.docx4j.openpackaging.parts.DrawingML.Drawing). */
+export class DrawingPart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.DRAWINGML_DRAWING, Namespaces.SPREADSHEETML_DRAWING, { namespaceURI: XDR, localPart: 'wsDr' });
+    }
+}
+export class DiagramDataPart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.DRAWINGML_DIAGRAM_DATA, Namespaces.DRAWINGML_DIAGRAM_DATA, { namespaceURI: DGM, localPart: 'dataModel' });
+    }
+}
+export class DiagramLayoutPart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.DRAWINGML_DIAGRAM_LAYOUT, Namespaces.DRAWINGML_DIAGRAM_LAYOUT, { namespaceURI: DGM, localPart: 'layoutDef' });
+    }
+}
+export class DiagramLayoutHeaderPart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.DRAWINGML_DIAGRAM_LAYOUT_HEADER, Namespaces.DRAWINGML_DIAGRAM_LAYOUT_HEADER, { namespaceURI: DGM, localPart: 'layoutDefHdr' });
+    }
+}
+export class DiagramStylePart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.DRAWINGML_DIAGRAM_STYLE, Namespaces.DRAWINGML_DIAGRAM_STYLE, { namespaceURI: DGM, localPart: 'styleDef' });
+    }
+}
+export class DiagramColorsPart extends XmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.DRAWINGML_DIAGRAM_COLORS, Namespaces.DRAWINGML_DIAGRAM_COLORS, { namespaceURI: DGM, localPart: 'colorsDef' });
+    }
+}
+/** Chart style, colour style, chartEx and diagram drawing parts: DOM until typed (later CR). */
+export class ChartStylePart extends DefaultXmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.CHART_STYLE, Namespaces.CHART_STYLE);
+    }
+}
+export class ChartColorStylePart extends DefaultXmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.CHART_COLOR_STYLE, Namespaces.CHART_COLOR_STYLE);
+    }
+}
+export class ChartExSpacePart extends DefaultXmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.CHART_EX, Namespaces.CHART_EX);
+    }
+}
+export class DiagramDrawingPart extends DefaultXmlPart {
+    constructor(partName) {
+        super(partName, ContentTypes.DRAWINGML_DIAGRAM_DRAWING, Namespaces.DRAWINGML_DIAGRAM_DRAWING);
+    }
+}

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

@@ -0,0 +1,14 @@
+import type * as core from '@docx4j/generated-objects-ts/modules/org_docx4j_docProps_core';
+import type * as extended from '@docx4j/generated-objects-ts/modules/org_docx4j_docProps_extended';
+import type * as custom from '@docx4j/generated-objects-ts/modules/org_docx4j_docProps_custom';
+import { XmlPart } from '../XmlPart.mjs';
+import { PartName } from '../../opc/PartName.mjs';
+export declare class DocPropsCorePart extends XmlPart<core.CoreProperties> {
+    constructor(partName?: PartName | string);
+}
+export declare class DocPropsExtendedPart extends XmlPart<extended.Properties> {
+    constructor(partName?: PartName | string);
+}
+export declare class DocPropsCustomPart extends XmlPart<custom.Properties> {
+    constructor(partName?: PartName | string);
+}

package/dist/parts/docProps/index.mjs

@@ -0,0 +1,18 @@
+import { XmlPart } from '../XmlPart.mjs';
+import { ContentTypes } from '../../opc/ContentTypes.mjs';
+import { Namespaces } from '../Namespaces.mjs';
+export class DocPropsCorePart extends XmlPart {
+    constructor(partName = '/docProps/core.xml') {
+        super(partName, ContentTypes.PACKAGE_COREPROPERTIES, Namespaces.PROPERTIES_CORE, { namespaceURI: 'http://schemas.openxmlformats.org/package/2006/metadata/core-properties', localPart: 'coreProperties' });
+    }
+}
+export class DocPropsExtendedPart extends XmlPart {
+    constructor(partName = '/docProps/app.xml') {
+        super(partName, ContentTypes.OFFICEDOCUMENT_EXTENDEDPROPERTIES, Namespaces.PROPERTIES_EXTENDED, { namespaceURI: 'http://schemas.openxmlformats.org/officeDocument/2006/extended-properties', localPart: 'Properties' });
+    }
+}
+export class DocPropsCustomPart extends XmlPart {
+    constructor(partName = '/docProps/custom.xml') {
+        super(partName, ContentTypes.OFFICEDOCUMENT_CUSTOMPROPERTIES, Namespaces.PROPERTIES_CUSTOM, { namespaceURI: 'http://schemas.openxmlformats.org/officeDocument/2006/custom-properties', localPart: 'Properties' });
+    }
+}

package/dist/parts/index.d.mts

@@ -0,0 +1,14 @@
+export { Part, type RelationshipSource } from './Part.mjs';
+export { Parts } from './Parts.mjs';
+export { BinaryPart, ImagePart, EmbeddedPackagePart, OleObjectBinaryPart, ObfuscatedFontPart, TrueTypeFontPart, AlternativeFormatInputPart } from './BinaryPart.mjs';
+export { XmlPart, type RootName, type DomPreprocessor } from './XmlPart.mjs';
+export { DefaultXmlPart, CustomXmlDataStoragePart } from './DefaultXmlPart.mjs';
+export { RelationshipsPart, type AddPartBehaviour, RELATIONSHIPS_ROOT, isExternal } from './RelationshipsPart.mjs';
+export { Namespaces } from './Namespaces.mjs';
+export { PartRegistry, defaultPartRegistry, type PartFactory } from './PartRegistry.mjs';
+export * from './wml/index.mjs';
+export * from './dml/index.mjs';
+export * from './docProps/index.mjs';
+export { CustomXmlDataStoragePropertiesPart, DS_NS } from './customXml/index.mjs';
+export * from './pml/index.mjs';
+export * from './sml/index.mjs';

package/dist/parts/index.mjs

@@ -0,0 +1,15 @@
+// Parts: the base classes, relationships, the registry and every typed part.
+export { Part } from './Part.mjs';
+export { Parts } from './Parts.mjs';
+export { BinaryPart, ImagePart, EmbeddedPackagePart, OleObjectBinaryPart, ObfuscatedFontPart, TrueTypeFontPart, AlternativeFormatInputPart } from './BinaryPart.mjs';
+export { XmlPart } from './XmlPart.mjs';
+export { DefaultXmlPart, CustomXmlDataStoragePart } from './DefaultXmlPart.mjs';
+export { RelationshipsPart, RELATIONSHIPS_ROOT, isExternal } from './RelationshipsPart.mjs';
+export { Namespaces } from './Namespaces.mjs';
+export { PartRegistry, defaultPartRegistry } from './PartRegistry.mjs';
+export * from './wml/index.mjs';
+export * from './dml/index.mjs';
+export * from './docProps/index.mjs';
+export { CustomXmlDataStoragePropertiesPart, DS_NS } from './customXml/index.mjs';
+export * from './pml/index.mjs';
+export * from './sml/index.mjs';

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

@@ -0,0 +1,53 @@
+import type * as pml from '@docx4j/generated-objects-ts/modules/org_pptx4j_pml';
+import type * as dml from '@docx4j/generated-objects-ts/modules/org_docx4j_dml';
+import { XmlPart } from '../XmlPart.mjs';
+import { BinaryPart } from '../BinaryPart.mjs';
+import { Part } from '../Part.mjs';
+import { PartName } from '../../opc/PartName.mjs';
+import { ThemePart } from '../dml/index.mjs';
+export declare class MainPresentationPart extends XmlPart<pml.Presentation> {
+    themePart: ThemePart | undefined;
+    constructor(partName?: PartName | string, contentType?: string);
+    setPartShortcut(part: Part, relationshipType: string): boolean;
+    get slideParts(): SlidePart[];
+}
+export declare class SlidePart extends XmlPart<pml.Sld> {
+    constructor(partName: PartName | string);
+}
+export declare class SlideLayoutPart extends XmlPart<pml.SldLayout> {
+    constructor(partName: PartName | string);
+}
+export declare class SlideMasterPart extends XmlPart<pml.SldMaster> {
+    constructor(partName: PartName | string);
+}
+export declare class NotesSlidePart extends XmlPart<pml.Notes> {
+    constructor(partName: PartName | string);
+}
+export declare class NotesMasterPart extends XmlPart<pml.NotesMaster> {
+    constructor(partName: PartName | string);
+}
+export declare class HandoutMasterPart extends XmlPart<pml.HandoutMaster> {
+    constructor(partName: PartName | string);
+}
+export declare class PresentationPropertiesPart extends XmlPart<pml.PresentationPr> {
+    constructor(partName?: PartName | string);
+}
+export declare class ViewPropertiesPart extends XmlPart<pml.ViewPr> {
+    constructor(partName?: PartName | string);
+}
+export declare class TableStylesPart extends XmlPart<dml.CTTableStyleList> {
+    constructor(partName?: PartName | string);
+}
+/** docx4j PresentationML.CommentsPart, renamed here to avoid the clash with the WordprocessingML one. */
+export declare class PresentationCommentsPart extends XmlPart<pml.CTCommentList> {
+    constructor(partName: PartName | string);
+}
+export declare class CommentAuthorsPart extends XmlPart<pml.CTCommentAuthorList> {
+    constructor(partName?: PartName | string);
+}
+export declare class TagsPart extends XmlPart<pml.TagLst> {
+    constructor(partName: PartName | string);
+}
+export declare class FontDataPart extends BinaryPart {
+    constructor(partName: PartName | string);
+}