@docx4j/core-ts 0.1.0

package/dist/parts/Namespaces.mjs

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

package/dist/parts/Part.d.mts

@@ -0,0 +1,50 @@
+import type { Relationship } from '@docx4j/generated-objects-ts/modules/org_docx4j_relationships';
+import { PartName } from '../opc/PartName.mjs';
+import type { RelationshipsPart, AddPartBehaviour } from './RelationshipsPart.mjs';
+import type { OpcPackage } from '../packages/OpcPackage.mjs';
+/** Something that owns a relationships part: a part or the package (docx4j Base). */
+export interface RelationshipSource {
+    readonly partName: PartName;
+    readonly package: OpcPackage | undefined;
+    relationshipsPart: RelationshipsPart | undefined;
+    setPartShortcut(part: Part, relationshipType: string): boolean;
+}
+export declare function setRelationshipsPartFactory(factory: (source: RelationshipSource) => RelationshipsPart): void;
+export declare function createRelationshipsPartFor(source: RelationshipSource): RelationshipsPart;
+/**
+ * A part (docx4j org.docx4j.openpackaging.parts.Part): a name, a content type, the relationship
+ * type it is the target of, and its own relationships part if it has one.
+ */
+export declare abstract class Part implements RelationshipSource {
+    partName: PartName;
+    contentType: string;
+    relationshipType: string;
+    /** The package this part belongs to; set when the part is added. */
+    package: OpcPackage | undefined;
+    /** This part's own relationships (`/word/_rels/document.xml.rels`), if any. */
+    relationshipsPart: RelationshipsPart | undefined;
+    /** The relationships part that first loaded this part. */
+    owningRelationshipPart: RelationshipsPart | undefined;
+    /** Every relationship that targets this part. */
+    readonly sourceRelationships: Relationship[];
+    constructor(partName: PartName | string, contentType: string, relationshipType: string);
+    /** Whether the zip entry should be deflated (false for already-compressed media). */
+    get compress(): boolean;
+    /** The first relationship that targets this part. */
+    get sourceRelationship(): Relationship | undefined;
+    /** This part's relationships part, created on demand when `createIfAbsent`. */
+    getRelationshipsPart(createIfAbsent?: boolean): RelationshipsPart | undefined;
+    /**
+     * Adds a part as a target of this one (docx4j Base.addTargetPart): registers it in the package,
+     * its content type in the content type manager, and a relationship in this part's relationships.
+     */
+    addTargetPart(target: Part, mode?: AddPartBehaviour, proposedRelId?: string): Relationship;
+    /** 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. */
+    protected loadSourceBytes(): Promise<Uint8Array | undefined>;
+    /** The bytes to write on save. Untouched parts come back from the source container unchanged. */
+    abstract getBytes(): Promise<Uint8Array>;
+    /** Whether the part carries content of its own (set or unmarshalled) rather than relying on the source container. */
+    abstract get isLoaded(): boolean;
+}

package/dist/parts/Part.mjs

@@ -0,0 +1,68 @@
+import { PartName } from '../opc/PartName.mjs';
+import { InvalidFormatException } from '../opc/exceptions.mjs';
+/** Set by the RelationshipsPart module: avoids a runtime import cycle (Part <- XmlPart <- RelationshipsPart). */
+let relationshipsPartFactory;
+export function setRelationshipsPartFactory(factory) {
+    relationshipsPartFactory = factory;
+}
+export function createRelationshipsPartFor(source) {
+    if (!relationshipsPartFactory)
+        throw new Error('RelationshipsPart not initialised');
+    return relationshipsPartFactory(source);
+}
+/**
+ * A part (docx4j org.docx4j.openpackaging.parts.Part): a name, a content type, the relationship
+ * type it is the target of, and its own relationships part if it has one.
+ */
+export class Part {
+    constructor(partName, contentType, relationshipType) {
+        /** Every relationship that targets this part. */
+        this.sourceRelationships = [];
+        this.partName = PartName.of(partName);
+        this.contentType = contentType;
+        this.relationshipType = relationshipType;
+    }
+    /** Whether the zip entry should be deflated (false for already-compressed media). */
+    get compress() {
+        return true;
+    }
+    /** The first relationship that targets this part. */
+    get sourceRelationship() {
+        return this.sourceRelationships[0];
+    }
+    /** This part's relationships part, created on demand when `createIfAbsent`. */
+    getRelationshipsPart(createIfAbsent = false) {
+        if (!this.relationshipsPart && createIfAbsent)
+            this.relationshipsPart = createRelationshipsPartFor(this);
+        return this.relationshipsPart;
+    }
+    /**
+     * Adds a part as a target of this one (docx4j Base.addTargetPart): registers it in the package,
+     * its content type in the content type manager, and a relationship in this part's relationships.
+     */
+    addTargetPart(target, mode, proposedRelId) {
+        if (!this.package)
+            throw new InvalidFormatException('Package not set; if you are adding part2 to part1, make sure part1 is added first.');
+        const rel = this.getRelationshipsPart(true).addPart(target, mode, proposedRelId);
+        this.setPartShortcut(target, target.relationshipType);
+        return rel;
+    }
+    /** Subclasses keep typed references to well-known targets (styles, numbering, ...); returns true when one was set. */
+    setPartShortcut(_part, _relationshipType) {
+        return false;
+    }
+    /** The bytes this part was loaded from, if it came from a container. Undefined for new parts. */
+    async loadSourceBytes() {
+        var _a;
+        const store = (_a = this.package) === null || _a === void 0 ? void 0 : _a.sourcePartStore;
+        if (!store)
+            return undefined;
+        const name = this.partName.storeName;
+        if (store.has(name))
+            return store.load(name);
+        const decoded = decodeURIComponent(name);
+        if (decoded !== name && store.has(decoded))
+            return store.load(decoded);
+        return undefined;
+    }
+}

package/dist/parts/PartRegistry.d.mts

@@ -0,0 +1,20 @@
+import type { Relationship } from '@docx4j/generated-objects-ts/modules/org_docx4j_relationships';
+import { Part } from './Part.mjs';
+import { PartName } from '../opc/PartName.mjs';
+/** Creates a part for a name and content type. */
+export type PartFactory = (partName: PartName, contentType: string) => Part;
+/**
+ * Content type to part class (docx4j ContentTypeManager.newPartForContentType), with a first
+ * look at the relationship type for the generic content types (altChunk, embedded package, OLE,
+ * custom XML). Unknown XML becomes `DefaultXmlPart`, anything else `BinaryPart`.
+ */
+export declare class PartRegistry {
+    private readonly byContentType;
+    private readonly byRelationshipType;
+    register(contentType: string, factory: PartFactory): this;
+    /** Consulted before the content type; for relationship types whose parts share a generic content type. */
+    registerForRelationship(relationshipType: string, factory: PartFactory): this;
+    createPart(partName: PartName, contentType: string | undefined, rel?: Relationship): Part;
+}
+/** docx4j's table. Extend with `register` for content types of your own. */
+export declare const defaultPartRegistry: PartRegistry;

package/dist/parts/PartRegistry.mjs

@@ -0,0 +1,142 @@
+import { ContentTypes, IMAGE_CONTENT_TYPES_BY_EXTENSION, isXmlContentType } from '../opc/ContentTypes.mjs';
+import { Namespaces } from './Namespaces.mjs';
+import { BinaryPart, ImagePart, EmbeddedPackagePart, OleObjectBinaryPart, ObfuscatedFontPart, TrueTypeFontPart, AlternativeFormatInputPart } from './BinaryPart.mjs';
+import { DefaultXmlPart, CustomXmlDataStoragePart } from './DefaultXmlPart.mjs';
+import * as wml from './wml/index.mjs';
+import * as dml from './dml/index.mjs';
+import * as pml from './pml/index.mjs';
+import * as sml from './sml/index.mjs';
+import * as docProps from './docProps/index.mjs';
+import * as customXml from './customXml/index.mjs';
+/**
+ * Content type to part class (docx4j ContentTypeManager.newPartForContentType), with a first
+ * look at the relationship type for the generic content types (altChunk, embedded package, OLE,
+ * custom XML). Unknown XML becomes `DefaultXmlPart`, anything else `BinaryPart`.
+ */
+export class PartRegistry {
+    constructor() {
+        this.byContentType = new Map();
+        this.byRelationshipType = new Map();
+    }
+    register(contentType, factory) {
+        this.byContentType.set(contentType, factory);
+        return this;
+    }
+    /** Consulted before the content type; for relationship types whose parts share a generic content type. */
+    registerForRelationship(relationshipType, factory) {
+        this.byRelationshipType.set(relationshipType, factory);
+        return this;
+    }
+    createPart(partName, contentType, rel) {
+        var _a;
+        const relType = rel === null || rel === void 0 ? void 0 : rel.type;
+        if (relType) {
+            const byRel = this.byRelationshipType.get(relType);
+            if (byRel)
+                return byRel(partName, contentType !== null && contentType !== void 0 ? contentType : ContentTypes.APPLICATION_XML);
+        }
+        if (contentType !== undefined) {
+            const factory = this.byContentType.get(contentType);
+            if (factory)
+                return factory(partName, contentType);
+            if (contentType.startsWith('image/'))
+                return new ImagePart(partName, contentType);
+            if (isXmlContentType(contentType) || partName.extension.toLowerCase() === 'xml') {
+                return new DefaultXmlPart(partName, contentType, relType !== null && relType !== void 0 ? relType : '');
+            }
+            return new BinaryPart(partName, contentType, relType !== null && relType !== void 0 ? relType : '');
+        }
+        // No content type registered: Word would reject the package; keep the bytes anyway.
+        if (relType === Namespaces.IMAGE) {
+            return new ImagePart(partName, (_a = IMAGE_CONTENT_TYPES_BY_EXTENSION[partName.extension.toLowerCase()]) !== null && _a !== void 0 ? _a : ContentTypes.OCTET_STREAM);
+        }
+        if (partName.extension.toLowerCase() === 'xml')
+            return new DefaultXmlPart(partName, ContentTypes.APPLICATION_XML, relType !== null && relType !== void 0 ? relType : '');
+        return new BinaryPart(partName, ContentTypes.OCTET_STREAM, relType !== null && relType !== void 0 ? relType : '');
+    }
+}
+/** docx4j's table. Extend with `register` for content types of your own. */
+export const defaultPartRegistry = new PartRegistry()
+    .registerForRelationship(Namespaces.AF, (n, ct) => new AlternativeFormatInputPart(n, ct))
+    .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))
+    .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))
+    .register(ContentTypes.WORDPROCESSINGML_TEMPLATE_MACROENABLED, (n, ct) => new wml.MainDocumentPart(n, ct))
+    .register(ContentTypes.WORDPROCESSINGML_GLOSSARYDOCUMENT, (n) => new wml.GlossaryDocumentPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_STYLES, (n) => new wml.StyleDefinitionsPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_NUMBERING, (n) => new wml.NumberingDefinitionsPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_FONTTABLE, (n) => new wml.FontTablePart(n))
+    .register(ContentTypes.WORDPROCESSINGML_SETTINGS, (n) => new wml.DocumentSettingsPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_WEBSETTINGS, (n) => new wml.WebSettingsPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_HEADER, (n) => new wml.HeaderPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_FOOTER, (n) => new wml.FooterPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_FOOTNOTES, (n) => new wml.FootnotesPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_ENDNOTES, (n) => new wml.EndnotesPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_COMMENTS, (n) => new wml.CommentsPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_COMMENTS_EXTENDED, (n) => new wml.CommentsExtendedPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_COMMENTS_IDS, (n) => new wml.CommentsIdsPart(n))
+    .register(ContentTypes.WORDPROCESSINGML_PEOPLE, (n) => new wml.PeoplePart(n))
+    .register(ContentTypes.MS_WORD_KEYMAP, (n) => new wml.KeyMapCustomizationsPart(n))
+    .register(ContentTypes.OFFICEDOCUMENT_VBA_DATA, (n) => new wml.VbaDataPart(n))
+    .register(ContentTypes.VML_DRAWING, (n) => new wml.VMLPart(n))
+    .register(ContentTypes.OFFICEDOCUMENT_THEME, (n) => new dml.ThemePart(n))
+    .register(ContentTypes.OFFICEDOCUMENT_THEME_OVERRIDE, (n) => new dml.ThemeOverridePart(n))
+    .register(ContentTypes.DRAWINGML_CHART, (n) => new dml.ChartPart(n))
+    .register(ContentTypes.DRAWINGML_CHART_SHAPES, (n) => new dml.ChartShapePart(n))
+    .register(ContentTypes.DRAWINGML_DRAWING, (n) => new dml.DrawingPart(n))
+    .register(ContentTypes.DRAWINGML_DIAGRAM_DATA, (n) => new dml.DiagramDataPart(n))
+    .register(ContentTypes.DRAWINGML_DIAGRAM_LAYOUT, (n) => new dml.DiagramLayoutPart(n))
+    .register(ContentTypes.DRAWINGML_DIAGRAM_LAYOUT_HEADER, (n) => new dml.DiagramLayoutHeaderPart(n))
+    .register(ContentTypes.DRAWINGML_DIAGRAM_STYLE, (n) => new dml.DiagramStylePart(n))
+    .register(ContentTypes.DRAWINGML_DIAGRAM_COLORS, (n) => new dml.DiagramColorsPart(n))
+    .register(ContentTypes.DRAWINGML_DIAGRAM_DRAWING, (n) => new dml.DiagramDrawingPart(n))
+    .register(ContentTypes.CHART_STYLE, (n) => new dml.ChartStylePart(n))
+    .register(ContentTypes.CHART_COLOR_STYLE, (n) => new dml.ChartColorStylePart(n))
+    .register(ContentTypes.CHART_EX, (n) => new dml.ChartExSpacePart(n))
+    .register(ContentTypes.PACKAGE_COREPROPERTIES, (n) => new docProps.DocPropsCorePart(n))
+    .register(ContentTypes.OFFICEDOCUMENT_EXTENDEDPROPERTIES, (n) => new docProps.DocPropsExtendedPart(n))
+    .register(ContentTypes.OFFICEDOCUMENT_CUSTOMPROPERTIES, (n) => new docProps.DocPropsCustomPart(n))
+    .register(ContentTypes.OFFICEDOCUMENT_CUSTOMXML_DATASTORAGEPROPERTIES, (n) => new customXml.CustomXmlDataStoragePropertiesPart(n))
+    .register(ContentTypes.OFFICEDOCUMENT_FONT, (n) => new ObfuscatedFontPart(n))
+    .register(ContentTypes.TRUETYPE_FONT, (n) => new TrueTypeFontPart(n))
+    .register(ContentTypes.OFFICEDOCUMENT_OLE_OBJECT, (n, ct) => new OleObjectBinaryPart(n, ct))
+    .register(ContentTypes.OFFICEDOCUMENT_ACTIVEX_OBJECT, (n, ct) => new OleObjectBinaryPart(n, ct))
+    .register(ContentTypes.PRESENTATIONML_MAIN, (n, ct) => new pml.MainPresentationPart(n, ct))
+    .register(ContentTypes.PRESENTATIONML_TEMPLATE, (n, ct) => new pml.MainPresentationPart(n, ct))
+    .register(ContentTypes.PRESENTATIONML_MACROENABLED, (n, ct) => new pml.MainPresentationPart(n, ct))
+    .register(ContentTypes.PRESENTATIONML_TEMPLATE_MACROENABLED, (n, ct) => new pml.MainPresentationPart(n, ct))
+    .register(ContentTypes.PRESENTATIONML_SLIDESHOW, (n, ct) => new pml.MainPresentationPart(n, ct))
+    .register(ContentTypes.PRESENTATIONML_SLIDE, (n) => new pml.SlidePart(n))
+    .register(ContentTypes.PRESENTATIONML_SLIDE_LAYOUT, (n) => new pml.SlideLayoutPart(n))
+    .register(ContentTypes.PRESENTATIONML_SLIDE_MASTER, (n) => new pml.SlideMasterPart(n))
+    .register(ContentTypes.PRESENTATIONML_NOTES_SLIDE, (n) => new pml.NotesSlidePart(n))
+    .register(ContentTypes.PRESENTATIONML_NOTES_MASTER, (n) => new pml.NotesMasterPart(n))
+    .register(ContentTypes.PRESENTATIONML_HANDOUT_MASTER, (n) => new pml.HandoutMasterPart(n))
+    .register(ContentTypes.PRESENTATIONML_PRES_PROPS, (n) => new pml.PresentationPropertiesPart(n))
+    .register(ContentTypes.PRESENTATIONML_VIEW_PROPS, (n) => new pml.ViewPropertiesPart(n))
+    .register(ContentTypes.PRESENTATIONML_TABLE_STYLES, (n) => new pml.TableStylesPart(n))
+    .register(ContentTypes.PRESENTATIONML_COMMENTS, (n) => new pml.PresentationCommentsPart(n))
+    .register(ContentTypes.PRESENTATIONML_COMMENT_AUTHORS, (n) => new pml.CommentAuthorsPart(n))
+    .register(ContentTypes.PRESENTATIONML_TAGS, (n) => new pml.TagsPart(n))
+    .register(ContentTypes.PRESENTATIONML_FONT_DATA, (n) => new pml.FontDataPart(n))
+    .register(ContentTypes.SPREADSHEETML_WORKBOOK, (n, ct) => new sml.WorkbookPart(n, ct))
+    .register(ContentTypes.SPREADSHEETML_WORKBOOK_MACROENABLED, (n, ct) => new sml.WorkbookPart(n, ct))
+    .register(ContentTypes.SPREADSHEETML_TEMPLATE, (n, ct) => new sml.WorkbookPart(n, ct))
+    .register(ContentTypes.SPREADSHEETML_TEMPLATE_MACROENABLED, (n, ct) => new sml.WorkbookPart(n, ct))
+    .register(ContentTypes.SPREADSHEETML_WORKSHEET, (n) => new sml.WorksheetPart(n))
+    .register(ContentTypes.SPREADSHEETML_CHARTSHEET, (n) => new sml.ChartsheetPart(n))
+    .register(ContentTypes.SPREADSHEETML_SHARED_STRINGS, (n) => new sml.SharedStringsPart(n))
+    .register(ContentTypes.SPREADSHEETML_STYLES, (n) => new sml.StylesPart(n))
+    .register(ContentTypes.SPREADSHEETML_CALC_CHAIN, (n) => new sml.CalcChainPart(n))
+    .register(ContentTypes.SPREADSHEETML_COMMENTS, (n) => new sml.SpreadsheetCommentsPart(n))
+    .register(ContentTypes.SPREADSHEETML_TABLE, (n) => new sml.TablePart(n))
+    .register(ContentTypes.SPREADSHEETML_PIVOT_TABLE, (n) => new sml.PivotTablePart(n))
+    .register(ContentTypes.SPREADSHEETML_PIVOT_CACHE_DEFINITION, (n) => new sml.PivotCacheDefinitionPart(n))
+    .register(ContentTypes.SPREADSHEETML_PIVOT_CACHE_RECORDS, (n) => new sml.PivotCacheRecordsPart(n))
+    .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));

package/dist/parts/Parts.d.mts

@@ -0,0 +1,13 @@
+import type { Part } from './Part.mjs';
+import { PartName } from '../opc/PartName.mjs';
+/** The parts of a package by name (docx4j Parts), case-insensitive. */
+export declare class Parts implements Iterable<Part> {
+    private readonly map;
+    put(part: Part): void;
+    get(partName: PartName | string): Part | undefined;
+    has(partName: PartName | string): boolean;
+    remove(partName: PartName | string): boolean;
+    get size(): number;
+    values(): IterableIterator<Part>;
+    [Symbol.iterator](): IterableIterator<Part>;
+}

package/dist/parts/Parts.mjs

@@ -0,0 +1,28 @@
+import { PartName } from '../opc/PartName.mjs';
+/** The parts of a package by name (docx4j Parts), case-insensitive. */
+export class Parts {
+    constructor() {
+        this.map = new Map();
+    }
+    put(part) {
+        this.map.set(part.partName.key, part);
+    }
+    get(partName) {
+        return this.map.get(PartName.of(partName).key);
+    }
+    has(partName) {
+        return this.map.has(PartName.of(partName).key);
+    }
+    remove(partName) {
+        return this.map.delete(PartName.of(partName).key);
+    }
+    get size() {
+        return this.map.size;
+    }
+    values() {
+        return this.map.values();
+    }
+    [Symbol.iterator]() {
+        return this.map.values();
+    }
+}

package/dist/parts/RelationshipsPart.d.mts

@@ -0,0 +1,66 @@
+import type { Relationships, Relationship } from '@docx4j/generated-objects-ts/modules/org_docx4j_relationships';
+import { XmlPart } from './XmlPart.mjs';
+import { Part, type RelationshipSource } from './Part.mjs';
+import { PartName } from '../opc/PartName.mjs';
+/** What `addPart` does when a part of the same name is already in the package (docx4j AddPartBehaviour). */
+export type AddPartBehaviour = 'OVERWRITE_IF_NAME_EXISTS' | 'REUSE_EXISTING' | 'RENAME_IF_NAME_EXISTS';
+export declare const RELATIONSHIPS_ROOT: {
+    namespaceURI: "http://schemas.openxmlformats.org/package/2006/relationships";
+    localPart: string;
+};
+/**
+ * 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 declare class RelationshipsPart extends XmlPart<Relationships> {
+    /** The part (or package) whose relationships these are. */
+    sourceP: RelationshipSource | undefined;
+    private nextId;
+    constructor(source?: RelationshipSource, partName?: PartName | string);
+    /** The package relationships part, `/_rels/.rels`. */
+    static createPackageRels(): RelationshipsPart;
+    /** A part's own, empty, relationships part. */
+    static createRelationshipsPartForPart(source: RelationshipSource): RelationshipsPart;
+    /** The name of the part these relationships belong to; '/' for the package. */
+    get sourceName(): PartName;
+    get isPackageRelationshipPart(): boolean;
+    /** The relationships (docx4j getRelationships()); unmarshalled parts only. */
+    get relationships(): Relationships;
+    /** The list of relationships, the live array. */
+    get list(): Relationship[];
+    get size(): number;
+    getRelationshipById(id: string): Relationship | undefined;
+    getRelationshipByType(type: string): Relationship | undefined;
+    getRelationshipsByType(type: string): Relationship[];
+    /** The part a relationship targets; undefined for external targets and parts not in the package. */
+    getPart(rel: Relationship | string): Part | undefined;
+    /** The part name a relationship's target resolves to (internal targets only). */
+    resolveTarget(rel: Relationship): PartName;
+    /** The (first) relationship targeting a part. */
+    getRel(partName: PartName | string): Relationship | undefined;
+    isATarget(partName: PartName | string): boolean;
+    /** The next free `rIdN`. */
+    getNextId(): string;
+    /** Adds a relationship; allocates an id when it has none or its id is taken. Returns the id. */
+    addRelationship(rel: Relationship): string;
+    /** An external relationship (a hyperlink, a linked image). */
+    addExternalRelationship(type: string, target: string, relId?: string): Relationship;
+    /**
+     * 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: Part, mode?: AddPartBehaviour, relId?: string): Relationship;
+    /** Links a part into the package as the target of a relationship of this part (docx4j loadPart). */
+    loadPart(part: Part, sourceRelationship: Relationship): void;
+    /** Removes the relationship to a part, the part, and (recursively) the parts only it related to. Returns what was removed. */
+    removePart(partName: PartName | string): PartName[];
+    /** Removes every part these relationships target (docx4j removeParts), recursively. */
+    removeParts(): PartName[];
+    /** Removes a relationship, by object or by the part it targets. */
+    removeRelationship(rel: Relationship | PartName | string): void;
+    removeRelationshipsByType(type: string): void;
+    private newPartName;
+}
+export declare function isExternal(rel: Relationship): boolean;