@docx4j/core-ts 0.1.0 → 0.1.1

package/dist/opc/exceptions.mjs

@@ -13,6 +13,44 @@ export class InvalidFormatException extends Docx4JException {
         this.name = 'InvalidFormatException';
     }
 }
+/**
+ * docx4j CyclicStylesException: a style's `w:basedOn` chain comes back to a style it already
+ * holds, or goes deeper than docx4j's limit of 32. Thrown only when
+ * `throwOnCyclicStyles(true)` is set (docx4j's
+ * `docx4j.openpackaging.exceptions.CyclicStylesException.throw` property, false by default);
+ * otherwise the walk stops where the cycle was found and resolution uses as much of the
+ * hierarchy as it has.
+ */
+export class CyclicStylesException extends Docx4JException {
+    constructor(message) {
+        super(message);
+        this.name = 'CyclicStylesException';
+    }
+}
+/**
+ * Thrown by a synchronous read that needs the property resolver of a package which has not
+ * built one yet. Building it unmarshals the styles part, which cannot be done synchronously.
+ */
+export class PropertyResolverNotCreatedException extends Docx4JException {
+    constructor(what = 'Effective formatting') {
+        super(`${what} needs the package's PropertyResolver; await getPropertyResolver() (or getBody()) first, or read direct formatting with { direct: true }`);
+        this.name = 'PropertyResolverNotCreatedException';
+    }
+}
+/** pptx4j Pptx4jException: a presentation's own structure (the slide list, a missing master). */
+export class Pptx4jException extends Docx4JException {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'Pptx4jException';
+    }
+}
+/** xlsx4j Xlsx4jException: a workbook's own structure (the sheet list). */
+export class Xlsx4jException extends Docx4JException {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'Xlsx4jException';
+    }
+}
 /** docx4j PartUnrecognisedException: no part class for a content type (the registry falls back before this is thrown). */
 export class PartUnrecognisedException extends Docx4JException {
     constructor(message) {

package/dist/opc/index.d.mts

@@ -8,5 +8,5 @@ export { loadPackage, type LoadOptions } from './Load.mjs';
 export { savePackage } from './Save.mjs';
 export { mcePreprocess, createMcePreprocessor, resolveAlternateContent, MCE_NS, type McePreprocessOptions } from './mce/preprocessor.mjs';
 export { UNDERSTOOD_NAMESPACES } from './mce/understood.mjs';
-export { Docx4JException, InvalidFormatException, PartUnrecognisedException } from './exceptions.mjs';
+export { Docx4JException, InvalidFormatException, PartUnrecognisedException, CyclicStylesException, PropertyResolverNotCreatedException } from './exceptions.mjs';
 export { parseXml, serializeXml, serializeXmlPart, createDocument, encodeText, decodeXmlText, stripXmlDeclaration, base64Encode, base64Decode, childElements, XML_DECLARATION } from '../xml/dom.mjs';

package/dist/opc/index.mjs

@@ -9,5 +9,5 @@ export { loadPackage } from './Load.mjs';
 export { savePackage } from './Save.mjs';
 export { mcePreprocess, createMcePreprocessor, resolveAlternateContent, MCE_NS } from './mce/preprocessor.mjs';
 export { UNDERSTOOD_NAMESPACES } from './mce/understood.mjs';
-export { Docx4JException, InvalidFormatException, PartUnrecognisedException } from './exceptions.mjs';
+export { Docx4JException, InvalidFormatException, PartUnrecognisedException, CyclicStylesException, PropertyResolverNotCreatedException } from './exceptions.mjs';
 export { parseXml, serializeXml, serializeXmlPart, createDocument, encodeText, decodeXmlText, stripXmlDeclaration, base64Encode, base64Decode, childElements, XML_DECLARATION } from '../xml/dom.mjs';

package/dist/packages/OpcPackage.d.mts

@@ -1,7 +1,7 @@
 import type { Relationship } from '@docx4j/generated-objects-ts/modules/org_docx4j_relationships';
 import { PartName } from '../opc/PartName.mjs';
 import { ContentTypeManager } from '../opc/ContentTypeManager.mjs';
-import type { PartStore, PartSink } from '../opc/PartStore.mjs';
+import { type PartStore, type PartSink } from '../opc/PartStore.mjs';
 import { type FlatOpcSinkOptions } from '../opc/FlatOpcPartStore.mjs';
 import { type LoadOptions } from '../opc/Load.mjs';
 import { Part, type RelationshipSource } from '../parts/Part.mjs';
@@ -49,6 +49,24 @@ export declare class OpcPackage implements RelationshipSource {
     /** Adds empty core properties if absent (docx4j addDocPropsCorePart). */
     addDocPropsCorePart(): DocPropsCorePart;
     addDocPropsExtendedPart(): DocPropsExtendedPart;
+    /**
+     * A deep copy of the package, of the same class (docx4j `OpcPackage.clone()`).
+     *
+     * Made the way docx4j makes it, **through save and reload** — into a `MemoryPartStore` rather
+     * than a zip, so nothing is deflated — because that is the copy whose cost matches what was
+     * touched: a part nobody unmarshalled is copied as the bytes it was loaded with, byte for byte,
+     * and never parsed; an unmarshalled part is marshalled once and comes back in the clone as its
+     * own tree, unmarshalled again on demand, sharing nothing with this package's. (The alternative,
+     * a part-by-part copy with `deepCopy` on every unmarshalled tree, would have to unmarshal
+     * lazily anyway and would not be simpler.)
+     *
+     * The clone's `sourcePartStore` is that memory store, so it no longer depends on this package's
+     * container; the load options are this package's. Settings that are not in the package
+     * (`author`, `fonts`, tracking) are carried across by the subclasses.
+     */
+    clone(): Promise<this>;
+    /** Carries the settings that are not in the package itself into a clone; subclasses add theirs. */
+    protected copyPackageSettingsTo(_target: OpcPackage): void;
     /** The package as a zip. */
     save(options?: {
         level?: number;

package/dist/packages/OpcPackage.mjs

@@ -1,5 +1,6 @@
 import { PartName } from '../opc/PartName.mjs';
 import { ContentTypeManager } from '../opc/ContentTypeManager.mjs';
+import { MemoryPartSink } from '../opc/PartStore.mjs';
 import { ZipPartStore, ZipPartSink } from '../opc/ZipPartStore.mjs';
 import { FlatOpcPartStore, FlatOpcPartSink } from '../opc/FlatOpcPartStore.mjs';
 import { loadPackage } from '../opc/Load.mjs';
@@ -101,6 +102,34 @@ export class OpcPackage {
         }
         return this.docPropsExtendedPart;
     }
+    /**
+     * A deep copy of the package, of the same class (docx4j `OpcPackage.clone()`).
+     *
+     * Made the way docx4j makes it, **through save and reload** — into a `MemoryPartStore` rather
+     * than a zip, so nothing is deflated — because that is the copy whose cost matches what was
+     * touched: a part nobody unmarshalled is copied as the bytes it was loaded with, byte for byte,
+     * and never parsed; an unmarshalled part is marshalled once and comes back in the clone as its
+     * own tree, unmarshalled again on demand, sharing nothing with this package's. (The alternative,
+     * a part-by-part copy with `deepCopy` on every unmarshalled tree, would have to unmarshal
+     * lazily anyway and would not be simpler.)
+     *
+     * The clone's `sourcePartStore` is that memory store, so it no longer depends on this package's
+     * container; the load options are this package's. Settings that are not in the package
+     * (`author`, `fonts`, tracking) are carried across by the subclasses.
+     */
+    async clone() {
+        const store = await this.saveTo(new MemoryPartSink());
+        const copy = await OpcPackage.load(store, this.loadOptions);
+        if (copy.constructor !== this.constructor) {
+            throw new Docx4JException(`Cloning ${this.constructor.name} produced ${copy.constructor.name}`);
+        }
+        this.copyPackageSettingsTo(copy);
+        return copy;
+    }
+    /** Carries the settings that are not in the package itself into a clone; subclasses add theirs. */
+    copyPackageSettingsTo(_target) {
+        // OpcPackage itself has none
+    }
     /** The package as a zip. */
     save(options) {
         return this.saveTo(new ZipPartSink(options));

package/dist/packages/PresentationMLPackage.d.mts

@@ -1,12 +1,82 @@
+import type * as pml from '@docx4j/generated-objects-ts/modules/org_pptx4j_pml';
 import { OpcPackage, type PackageSource } from './OpcPackage.mjs';
 import type { LoadOptions } from '../opc/Load.mjs';
 import type { Part } from '../parts/Part.mjs';
-import type { MainPresentationPart } from '../parts/pml/index.mjs';
+import { MainPresentationPart, SlidePart, SlideLayoutPart, SlideMasterPart, NotesMasterPart, PresentationPropertiesPart, ViewPropertiesPart, TableStylesPart, CommentAuthorsPart } from '../parts/pml/index.mjs';
+import { type SlideTextOptions } from '../parts/pml/placeholders.mjs';
+import { ThemePart } from '../parts/dml/index.mjs';
+import { type FontSettings, type DefaultThemeValue } from '../model/fonts/defaultTheme.mjs';
+/** docx4j / pptx4j `org.pptx4j.model.SlideSizesWellKnown`. */
+export type SlideSizesWellKnown = 'LETTER' | 'A3' | 'A4' | 'B4JIS' | 'SCREEN4x3' | 'SCREEN16x9' | 'SCREEN16x10' | 'LEDGER' | 'B4ISO' | 'B5ISO' | 'MM35' | 'OVERHEAD' | 'BANNER';
+/** docx4j `MainPresentationPart.createSlideSize(sz, landscape)`. */
+export declare function createSlideSize(size: SlideSizesWellKnown, landscape?: boolean): pml.Presentation.SldSz;
+export interface CreatePresentationOptions {
+    /** docx4j's `pptx4j.PageSize`; `'A4'` by default, as docx4j's property does. */
+    slideSize?: SlideSizesWellKnown;
+    /** docx4j's `pptx4j.PageOrientationLandscape`; true by default. */
+    landscape?: boolean;
+    /** Which Office theme the new presentation's theme part carries; see `pkg.fonts.defaultTheme`. */
+    defaultTheme?: DefaultThemeValue;
+    /** The first slide's title; the placeholder is left empty (PowerPoint's prompt) when absent. */
+    title?: string;
+    /** The first slide's body: a string, split on newlines, or one string per paragraph. */
+    body?: string | string[];
+}
 /** A pptx (docx4j PresentationMLPackage). */
 export declare class PresentationMLPackage extends OpcPackage {
     mainPresentationPart: MainPresentationPart | undefined;
+    /** The package's font settings, as `WordprocessingMLPackage.fonts`: which Office theme a new
+     *  presentation's theme part carries. */
+    readonly fonts: FontSettings;
     static load(source: PackageSource, options?: LoadOptions): Promise<PresentationMLPackage>;
+    /**
+     * A new presentation, as docx4j's `PresentationMLPackage.createPackage(sz, landscape)` builds
+     * one: the presentation part with the slide size, a slide master, a slide layout, a theme part
+     * in both the master's and the presentation's relationships, and — unlike docx4j, whose slide
+     * creation is commented out — one empty slide, so the file opens as a presentation rather than
+     * as an empty deck (CR-001 section 16).
+     *
+     * The master, layout and slide are docx4j's own template markup
+     * (`src/parts/pml/defaults.mts`); the theme is the Office theme `pkg.fonts.defaultTheme` names,
+     * the same one `WordprocessingMLPackage.createPackage` uses.
+     *
+     * The layout and the slide also take a title and a body placeholder, which docx4j's markup has
+     * not got: without them PowerPoint opens the slide blank, with no "Click to add title" to type
+     * into (CR-001 section 17). `title` and `body` fill the slide's; left out, it shows the prompts.
+     */
+    static createPackage(options?: CreatePresentationOptions): Promise<PresentationMLPackage>;
+    /**
+     * Adds a slide part to the presentation (docx4j `MainPresentationPart.addSlide`), on the
+     * layout given or on the presentation's first layout. The slide carries a shape for each
+     * placeholder that layout defines, so that PowerPoint offers "Click to add title" on it;
+     * `title` and `body` fill them in (`body` is one paragraph per line). Appends, or inserts at
+     * `index`.
+     */
+    addSlide(options?: {
+        index?: number;
+        layoutPart?: SlideLayoutPart;
+        partName?: string;
+    } & SlideTextOptions): Promise<SlidePart>;
+    /** `/ppt/slides/slideN.xml` for the lowest N the package has no part for. */
+    private nextSlideName;
     setPartShortcut(part: Part, relationshipType: string): boolean;
     getMainPresentationPart(): MainPresentationPart;
+    /** The slides, in `p:sldIdLst` order (docx4j `MainPresentationPart.getSlideParts()`). */
+    get slideParts(): SlidePart[];
+    /** The slides in `p:sldIdLst` order, unmarshalling the presentation part first. */
+    getSlideParts(): Promise<SlidePart[]>;
+    /** The slide masters, in `p:sldMasterIdLst` order. */
+    get slideMasterParts(): SlideMasterPart[];
+    /** Every slide layout of every master, masters in order and layouts in `p:sldLayoutIdLst` order. */
+    get slideLayoutParts(): SlideLayoutPart[];
+    get notesMasterPart(): NotesMasterPart | undefined;
+    get presentationPropertiesPart(): PresentationPropertiesPart | undefined;
+    get viewPropertiesPart(): ViewPropertiesPart | undefined;
+    get tableStylesPart(): TableStylesPart | undefined;
+    get commentAuthorsPart(): CommentAuthorsPart | undefined;
+    /** The theme related from the presentation part (docx4j `MainPresentationPart.getThemePart()`). */
+    get themePart(): ThemePart | undefined;
+    /** A clone carries the theme setting. */
+    protected copyPackageSettingsTo(target: OpcPackage): void;
     protected get progId(): string;
 }

package/dist/packages/PresentationMLPackage.mjs

@@ -1,8 +1,14 @@
+import { createPresentation, createPresentationSldSz } from '@docx4j/generated-objects-ts/factory/org_pptx4j_pml';
 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 { MainPresentationPart, SlidePart, SlideLayoutPart, SlideMasterPart, } from '../parts/pml/index.mjs';
+import { DEFAULT_SLIDE_MASTER_XML, DEFAULT_SLIDE_LAYOUT_XML, DEFAULT_SLIDE_XML } from '../parts/pml/defaults.mjs';
+import { addShapes, layoutPlaceholders, slidePlaceholdersFor } from '../parts/pml/placeholders.mjs';
+import { ThemePart } from '../parts/dml/index.mjs';
+import { newFontSettings, themeOfSettings } from '../model/fonts/defaultTheme.mjs';
 const MAIN_CONTENT_TYPES = [
     ContentTypes.PRESENTATIONML_MAIN,
     ContentTypes.PRESENTATIONML_TEMPLATE,
@@ -10,8 +16,41 @@ const MAIN_CONTENT_TYPES = [
     ContentTypes.PRESENTATIONML_TEMPLATE_MACROENABLED,
     ContentTypes.PRESENTATIONML_SLIDESHOW,
 ];
+/**
+ * The landscape `cx` and `cy` in EMU, and the `p:sldSz/@type`, as docx4j's
+ * `MainPresentationPart.createSlideSize` has them. Portrait swaps the two.
+ * `B4JIS` is in the enumeration but has no size in docx4j, which throws for it; so does this.
+ */
+const SLIDE_SIZES = {
+    LETTER: [9144000, 6858000, 'letter'],
+    A3: [12801600, 9601200, 'A3'],
+    A4: [9906000, 6858000, 'A4'],
+    SCREEN4x3: [9144000, 6858000, 'screen4x3'],
+    SCREEN16x9: [9144000, 5143500, 'screen16x9'],
+    SCREEN16x10: [9144000, 5715000, 'screen16x10'],
+    LEDGER: [12179300, 9134475, 'ledger'],
+    B4ISO: [10826750, 8120063, 'B4ISO'],
+    B5ISO: [7169150, 5376863, 'B5ISO'],
+    MM35: [10287000, 6858000, '35mm'],
+    OVERHEAD: [9144000, 6858000, 'overhead'],
+    BANNER: [7315200, 914400, 'banner'],
+};
+/** docx4j `MainPresentationPart.createSlideSize(sz, landscape)`. */
+export function createSlideSize(size, landscape = true) {
+    const dims = SLIDE_SIZES[size];
+    if (!dims)
+        throw new Docx4JException(`No support for slide size ${size}`);
+    const [cx, cy, type] = dims;
+    return createPresentationSldSz(landscape ? { cx, cy, type } : { cx: cy, cy: cx, type });
+}
 /** A pptx (docx4j PresentationMLPackage). */
 export class PresentationMLPackage extends OpcPackage {
+    constructor() {
+        super(...arguments);
+        /** The package's font settings, as `WordprocessingMLPackage.fonts`: which Office theme a new
+         *  presentation's theme part carries. */
+        this.fonts = newFontSettings();
+    }
     static async load(source, options) {
         var _a, _b;
         const pkg = await OpcPackage.load(source, options);
@@ -20,6 +59,93 @@ export class PresentationMLPackage extends OpcPackage {
         }
         return pkg;
     }
+    /**
+     * A new presentation, as docx4j's `PresentationMLPackage.createPackage(sz, landscape)` builds
+     * one: the presentation part with the slide size, a slide master, a slide layout, a theme part
+     * in both the master's and the presentation's relationships, and — unlike docx4j, whose slide
+     * creation is commented out — one empty slide, so the file opens as a presentation rather than
+     * as an empty deck (CR-001 section 16).
+     *
+     * The master, layout and slide are docx4j's own template markup
+     * (`src/parts/pml/defaults.mts`); the theme is the Office theme `pkg.fonts.defaultTheme` names,
+     * the same one `WordprocessingMLPackage.createPackage` uses.
+     *
+     * The layout and the slide also take a title and a body placeholder, which docx4j's markup has
+     * not got: without them PowerPoint opens the slide blank, with no "Click to add title" to type
+     * into (CR-001 section 17). `title` and `body` fill the slide's; left out, it shows the prompts.
+     */
+    static async createPackage(options = {}) {
+        var _a, _b;
+        const pkg = new PresentationMLPackage();
+        if (options.defaultTheme !== undefined)
+            pkg.fonts.defaultTheme = options.defaultTheme;
+        // The presentation part (docx4j MainPresentationPart.createJaxbPresentationElement)
+        const pp = new MainPresentationPart();
+        pp.setContents(createPresentation({
+            sldMasterIdLst: { sldMasterId: [] },
+            sldIdLst: { sldId: [] },
+            sldSz: createSlideSize((_a = options.slideSize) !== null && _a !== void 0 ? _a : 'A4', (_b = options.landscape) !== null && _b !== void 0 ? _b : true),
+            notesSz: { cx: 6858000, cy: 9144000 },
+        }));
+        pkg.addTargetPart(pp);
+        // The layout, and the master that lists it. The layout defines the two placeholders a slide
+        // inherits its geometry from, so it is a Title and Content layout, not docx4j's empty one.
+        const layoutPart = new SlideLayoutPart();
+        layoutPart.setXml(DEFAULT_SLIDE_LAYOUT_XML);
+        const layout = await layoutPart.getContents();
+        layout.type = 'obj';
+        layout.preserve = true;
+        layout.cSld.name = 'Title and Content';
+        addShapes(layout.cSld.spTree, layoutPlaceholders(pp.contents.sldSz));
+        const masterPart = new SlideMasterPart();
+        pp.addSlideMasterIdListEntry(masterPart);
+        masterPart.setXml(DEFAULT_SLIDE_MASTER_XML);
+        await masterPart.getContents();
+        masterPart.addSlideLayoutIdListEntry(layoutPart);
+        layoutPart.addTargetPart(masterPart);
+        // The theme, in both places docx4j puts it (PowerPoint's own files relate it from the
+        // presentation part as well as from the master)
+        const theme = new ThemePart('/ppt/theme/theme1.xml');
+        theme.setXml(themeOfSettings(pkg.fonts).xml);
+        masterPart.addTargetPart(theme);
+        pp.addTargetPart(theme);
+        // One slide on the layout, with the layout's placeholders on it
+        const slidePart = new SlidePart();
+        slidePart.setXml(DEFAULT_SLIDE_XML);
+        await addSlidePlaceholders(slidePart, layout.cSld, options);
+        pp.addSlideIdListEntry(slidePart);
+        slidePart.addTargetPart(layoutPart);
+        return pkg;
+    }
+    /**
+     * Adds a slide part to the presentation (docx4j `MainPresentationPart.addSlide`), on the
+     * layout given or on the presentation's first layout. The slide carries a shape for each
+     * placeholder that layout defines, so that PowerPoint offers "Click to add title" on it;
+     * `title` and `body` fill them in (`body` is one paragraph per line). Appends, or inserts at
+     * `index`.
+     */
+    async addSlide(options = {}) {
+        var _a, _b, _c;
+        const pp = this.getMainPresentationPart();
+        await pp.getContents();
+        const layoutPart = (_a = options.layoutPart) !== null && _a !== void 0 ? _a : (_b = this.slideMasterParts[0]) === null || _b === void 0 ? void 0 : _b.slideLayoutParts[0];
+        if (!layoutPart)
+            throw new Docx4JException('The presentation has no slide layout to put a slide on');
+        const slidePart = new SlidePart((_c = options.partName) !== null && _c !== void 0 ? _c : this.nextSlideName());
+        slidePart.setXml(DEFAULT_SLIDE_XML);
+        // readContents, not getContents: reading the layout must not cost it its byte-for-byte round trip
+        await addSlidePlaceholders(slidePart, (await layoutPart.readContents()).cSld, options);
+        pp.addSlide(slidePart, options.index, layoutPart);
+        return slidePart;
+    }
+    /** `/ppt/slides/slideN.xml` for the lowest N the package has no part for. */
+    nextSlideName() {
+        for (let n = 1;; n++) {
+            const name = `/ppt/slides/slide${n}.xml`;
+            if (!this.getPart(name))
+                return name;
+        }
+    }
     setPartShortcut(part, relationshipType) {
         if (relationshipType === Namespaces.DOCUMENT || relationshipType === Namespaces.DOCUMENT_STRICT) {
             this.mainPresentationPart = part;
@@ -32,8 +158,61 @@ export class PresentationMLPackage extends OpcPackage {
             throw new Docx4JException('No main presentation part');
         return this.mainPresentationPart;
     }
+    /** The slides, in `p:sldIdLst` order (docx4j `MainPresentationPart.getSlideParts()`). */
+    get slideParts() {
+        var _a, _b;
+        return (_b = (_a = this.mainPresentationPart) === null || _a === void 0 ? void 0 : _a.slideParts) !== null && _b !== void 0 ? _b : [];
+    }
+    /** The slides in `p:sldIdLst` order, unmarshalling the presentation part first. */
+    async getSlideParts() {
+        return this.getMainPresentationPart().getSlideParts();
+    }
+    /** The slide masters, in `p:sldMasterIdLst` order. */
+    get slideMasterParts() {
+        var _a, _b;
+        return (_b = (_a = this.mainPresentationPart) === null || _a === void 0 ? void 0 : _a.slideMasterParts) !== null && _b !== void 0 ? _b : [];
+    }
+    /** Every slide layout of every master, masters in order and layouts in `p:sldLayoutIdLst` order. */
+    get slideLayoutParts() {
+        return this.slideMasterParts.flatMap((m) => m.slideLayoutParts);
+    }
+    get notesMasterPart() {
+        var _a;
+        return (_a = this.mainPresentationPart) === null || _a === void 0 ? void 0 : _a.notesMasterPart;
+    }
+    get presentationPropertiesPart() {
+        var _a;
+        return (_a = this.mainPresentationPart) === null || _a === void 0 ? void 0 : _a.presentationPropertiesPart;
+    }
+    get viewPropertiesPart() {
+        var _a;
+        return (_a = this.mainPresentationPart) === null || _a === void 0 ? void 0 : _a.viewPropertiesPart;
+    }
+    get tableStylesPart() {
+        var _a;
+        return (_a = this.mainPresentationPart) === null || _a === void 0 ? void 0 : _a.tableStylesPart;
+    }
+    get commentAuthorsPart() {
+        var _a;
+        return (_a = this.mainPresentationPart) === null || _a === void 0 ? void 0 : _a.commentAuthorsPart;
+    }
+    /** The theme related from the presentation part (docx4j `MainPresentationPart.getThemePart()`). */
+    get themePart() {
+        var _a;
+        return (_a = this.mainPresentationPart) === null || _a === void 0 ? void 0 : _a.themePart;
+    }
+    /** A clone carries the theme setting. */
+    copyPackageSettingsTo(target) {
+        if (target instanceof PresentationMLPackage)
+            target.fonts.defaultTheme = this.fonts.defaultTheme;
+    }
     get progId() {
         return 'PowerPoint.Show';
     }
 }
+/** The placeholder shapes of a new slide, matching the layout it is on (CR-001 section 17). */
+async function addSlidePlaceholders(slidePart, layout, text) {
+    const sld = await slidePart.getContents();
+    addShapes(sld.cSld.spTree, slidePlaceholdersFor(layout, text));
+}
 registerPackageClass(MAIN_CONTENT_TYPES, PresentationMLPackage);

package/dist/packages/SpreadsheetMLPackage.d.mts

@@ -1,12 +1,41 @@
 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';
+import { WorkbookPart, WorksheetPart, SharedStringsPart, StylesPart, CalcChainPart } from '../parts/sml/index.mjs';
+import type { ThemePart } from '../parts/dml/index.mjs';
 /** An xlsx (docx4j SpreadsheetMLPackage). */
 export declare class SpreadsheetMLPackage extends OpcPackage {
     workbookPart: WorkbookPart | undefined;
     static load(source: PackageSource, options?: LoadOptions): Promise<SpreadsheetMLPackage>;
+    /**
+     * A new workbook with no sheets (docx4j `SpreadsheetMLPackage.createPackage()`): the workbook
+     * part, an empty `sheets`, and the one `bookViews/workbookView` docx4j adds because without it
+     * Excel 2010 could crash on print. Add sheets with `createWorksheetPart`.
+     */
+    static createPackage(): Promise<SpreadsheetMLPackage>;
+    /**
+     * Creates a worksheet part, relates it from the workbook and adds the `sheet` entry that names
+     * it (docx4j `createWorksheetPart(partName, sheetName, sheetId)`). The part holds an empty
+     * `sheetData`, which is the least Excel will open.
+     *
+     * `index` inserts the tab at that position in `sheets` instead of appending. The part name
+     * defaults to the first free `/xl/worksheets/sheetN.xml` and the `sheetId` to the next free one.
+     */
+    createWorksheetPart(name: string, index?: number, options?: {
+        partName?: string;
+        sheetId?: number;
+    }): WorksheetPart;
     setPartShortcut(part: Part, relationshipType: string): boolean;
     getWorkbookPart(): WorkbookPart;
+    /** The worksheets, in `sheets` order (the tab order Excel shows). */
+    get worksheetParts(): WorksheetPart[];
+    /** The worksheets in `sheets` order, unmarshalling the workbook part first. */
+    getWorksheetParts(): Promise<WorksheetPart[]>;
+    get sharedStringsPart(): SharedStringsPart | undefined;
+    get stylesPart(): StylesPart | undefined;
+    get calcChainPart(): CalcChainPart | undefined;
+    get themePart(): ThemePart | undefined;
+    /** `/xl/worksheets/sheetN.xml` for the lowest N the package has no part for. */
+    private nextWorksheetName;
     protected get progId(): string;
 }

package/dist/packages/SpreadsheetMLPackage.mjs

@@ -1,8 +1,10 @@
+import { createWorkbook, createSheet, createWorksheet } from '@docx4j/generated-objects-ts/factory/org_xlsx4j_sml';
 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 { WorkbookPart, WorksheetPart, } from '../parts/sml/index.mjs';
 const MAIN_CONTENT_TYPES = [
     ContentTypes.SPREADSHEETML_WORKBOOK,
     ContentTypes.SPREADSHEETML_WORKBOOK_MACROENABLED,
@@ -19,6 +21,49 @@ export class SpreadsheetMLPackage extends OpcPackage {
         }
         return pkg;
     }
+    /**
+     * A new workbook with no sheets (docx4j `SpreadsheetMLPackage.createPackage()`): the workbook
+     * part, an empty `sheets`, and the one `bookViews/workbookView` docx4j adds because without it
+     * Excel 2010 could crash on print. Add sheets with `createWorksheetPart`.
+     */
+    static async createPackage() {
+        const pkg = new SpreadsheetMLPackage();
+        const wb = new WorkbookPart();
+        wb.setContents(createWorkbook({
+            bookViews: { workbookView: [{}] },
+            sheets: { sheet: [] },
+        }));
+        pkg.addTargetPart(wb);
+        return pkg;
+    }
+    /**
+     * Creates a worksheet part, relates it from the workbook and adds the `sheet` entry that names
+     * it (docx4j `createWorksheetPart(partName, sheetName, sheetId)`). The part holds an empty
+     * `sheetData`, which is the least Excel will open.
+     *
+     * `index` inserts the tab at that position in `sheets` instead of appending. The part name
+     * defaults to the first free `/xl/worksheets/sheetN.xml` and the `sheetId` to the next free one.
+     */
+    createWorksheetPart(name, index, options = {}) {
+        var _a, _b, _c, _d;
+        const wb = this.getWorkbookPart();
+        const workbook = wb.contents;
+        const sheets = ((_a = workbook.sheets) !== null && _a !== void 0 ? _a : (workbook.sheets = { sheet: [] }));
+        const list = ((_b = sheets.sheet) !== null && _b !== void 0 ? _b : (sheets.sheet = []));
+        if (index !== undefined && (index < 0 || index > list.length)) {
+            throw new Docx4JException(`Can't add a sheet at index ${index}. (There are ${list.length} sheets) `);
+        }
+        const part = new WorksheetPart((_c = options.partName) !== null && _c !== void 0 ? _c : this.nextWorksheetName());
+        const rel = wb.addTargetPart(part);
+        const sheetId = (_d = options.sheetId) !== null && _d !== void 0 ? _d : list.reduce((max, s) => Math.max(max, s.sheetId), 0) + 1;
+        const entry = createSheet({ name, sheetId, id: rel.id });
+        if (index === undefined)
+            list.push(entry);
+        else
+            list.splice(index, 0, entry);
+        part.setContents(createWorksheet({ sheetData: {} }));
+        return part;
+    }
     setPartShortcut(part, relationshipType) {
         if (relationshipType === Namespaces.DOCUMENT || relationshipType === Namespaces.DOCUMENT_STRICT) {
             this.workbookPart = part;
@@ -31,6 +76,39 @@ export class SpreadsheetMLPackage extends OpcPackage {
             throw new Docx4JException('No workbook part');
         return this.workbookPart;
     }
+    /** The worksheets, in `sheets` order (the tab order Excel shows). */
+    get worksheetParts() {
+        var _a, _b;
+        return (_b = (_a = this.workbookPart) === null || _a === void 0 ? void 0 : _a.worksheetParts) !== null && _b !== void 0 ? _b : [];
+    }
+    /** The worksheets in `sheets` order, unmarshalling the workbook part first. */
+    async getWorksheetParts() {
+        return this.getWorkbookPart().getWorksheetParts();
+    }
+    get sharedStringsPart() {
+        var _a;
+        return (_a = this.workbookPart) === null || _a === void 0 ? void 0 : _a.sharedStringsPart;
+    }
+    get stylesPart() {
+        var _a;
+        return (_a = this.workbookPart) === null || _a === void 0 ? void 0 : _a.stylesPart;
+    }
+    get calcChainPart() {
+        var _a;
+        return (_a = this.workbookPart) === null || _a === void 0 ? void 0 : _a.calcChainPart;
+    }
+    get themePart() {
+        var _a;
+        return (_a = this.workbookPart) === null || _a === void 0 ? void 0 : _a.themePart;
+    }
+    /** `/xl/worksheets/sheetN.xml` for the lowest N the package has no part for. */
+    nextWorksheetName() {
+        for (let n = 1;; n++) {
+            const name = `/xl/worksheets/sheet${n}.xml`;
+            if (!this.getPart(name))
+                return name;
+        }
+    }
     get progId() {
         return 'Excel.Sheet';
     }