ooxml-core 1.0.0 → 1.2.0

package/dist/opc/properties/patch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Byte-preserving edits to a flat property part (`docProps/core.xml`, `docProps/app.xml`).
+ *
+ * The writers decide what changes on the parsed DOM, then splice only those changes into the
+ * source text: every byte the edit does not touch (the XML declaration and its line break,
+ * indentation, entity and empty-element forms, unknown elements) is kept exactly. Serialising
+ * the DOM instead would normalise all of them on every save.
+ */
+import type { XmlElement } from '../../xml/index.js';
+/** Element text: `&`, `<`, `>` escaped, and CR kept as a reference so it survives a reload. */
+export declare const escapeText: (text: string) => string;
+/** A set of edits against one source part, keyed by the parsed root's element children. */
+export declare class PartPatch {
+    private readonly xml;
+    private readonly root;
+    private readonly spans;
+    private readonly edits;
+    private readonly appended;
+    private readonly prefixes;
+    private defaultNs;
+    private seq;
+    constructor(xml: string, rootElement: XmlElement);
+    private add;
+    private span;
+    /** The prefix bound to `ns` on the root, declaring `preferred` for it when none is. */
+    prefix(ns: string, preferred: string): string;
+    /** `local` qualified for an element in `ns`: unprefixed in the default namespace. */
+    qualify(ns: string, local: string, preferred: string): string;
+    /** Replaces the element's content, keeping its start tag (and attributes) as written. */
+    setContent(element: XmlElement, content: string): void;
+    /** Adds ` name="value"` text to the element's start tag. */
+    addAttribute(element: XmlElement, attribute: string): void;
+    remove(element: XmlElement): void;
+    /** Inserts `markup` before `before`, or as the root's last child. */
+    insert(markup: string, before?: XmlElement): void;
+    toString(): string;
+}
+//# sourceMappingURL=patch.d.ts.map

package/dist/opc/properties/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../opc/properties/patch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAgGlD,+FAA+F;AAC/F,eAAO,MAAM,UAAU,SAAU,MAAM,KAAG,MACsD,CAAC;AAKjG,2FAA2F;AAC3F,qBAAa,SAAS;IAUpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IATrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,GAAG,CAAK;IAEhB,YACkB,GAAG,EAAE,MAAM,EAC5B,WAAW,EAAE,UAAU,EAYvB;IAED,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,IAAI;IAMZ,uFAAuF;IAChF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAUnD;IAED,qFAAqF;IAC9E,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAInE;IAED,yFAAyF;IAClF,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAK5D;IAED,4DAA4D;IACrD,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAIhE;IAEM,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAGvC;IAED,qEAAqE;IAC9D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAKvD;IAEM,QAAQ,IAAI,MAAM,CAwBxB;CACD"}

package/dist/opc/properties/title-groups.d.ts

@@ -0,0 +1,30 @@
+import type { HeadingPair } from './types.js';
+/** One `HeadingPairs` group of `docProps/app.xml` with the `TitlesOfParts` entries it owns. */
+export interface TitleGroup {
+    name: string;
+    titles: string[];
+}
+/**
+ * Splits `TitlesOfParts` into the `HeadingPairs` groups that own it, in order: each group takes
+ * the next `count` titles (a negative count takes none).
+ */
+export declare function titleGroups(headingPairs: readonly HeadingPair[], titlesOfParts: readonly string[]): TitleGroup[];
+/** `HeadingPairs` and `TitlesOfParts` for `groups`, each count following its titles. */
+export declare function fromTitleGroups(groups: readonly TitleGroup[]): {
+    headingPairs: HeadingPair[];
+    titlesOfParts: string[];
+};
+/**
+ * Replaces the titles of the first group `match` accepts (Excel's `Worksheets`, PowerPoint's
+ * `Slide Titles`...), keeping every other group and its titles; when none matches, a group
+ * named `name` is appended. Counts are recomputed so the two vectors stay consistent.
+ */
+export declare function replaceTitleGroup(headingPairs: readonly HeadingPair[], titlesOfParts: readonly string[], group: {
+    name: string;
+    titles: readonly string[];
+    match?: (name: string) => boolean;
+}): {
+    headingPairs: HeadingPair[];
+    titlesOfParts: string[];
+};
+//# sourceMappingURL=title-groups.d.ts.map

package/dist/opc/properties/title-groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title-groups.d.ts","sourceRoot":"","sources":["../../../opc/properties/title-groups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,+FAA+F;AAC/F,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAC1B,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,aAAa,EAAE,SAAS,MAAM,EAAE,GAC9B,UAAU,EAAE,CAQd;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG;IAC/D,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB,CAKA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,GACnF;IAAE,YAAY,EAAE,WAAW,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CAO1D"}

package/dist/opc/properties/types.d.ts

@@ -52,6 +52,21 @@ export interface AppProperties {
     docSecurity?: number;
     /** `TotalTime`: editing minutes. */
     totalTime?: number;
+    /** `PresentationFormat` (`Widescreen`, `On-screen Show (4:3)`). */
+    presentationFormat?: string;
+    /** Document statistics as the producing application last counted them. */
+    pages?: number;
+    words?: number;
+    characters?: number;
+    charactersWithSpaces?: number;
+    lines?: number;
+    paragraphs?: number;
+    slides?: number;
+    /** `Notes`: slides with a notes page. */
+    notes?: number;
+    hiddenSlides?: number;
+    /** `MMClips`: multimedia clips. */
+    mmClips?: number;
     scaleCrop?: boolean;
     linksUpToDate?: boolean;
     sharedDoc?: boolean;

package/dist/opc/properties/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../opc/properties/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../opc/properties/types.ts"],"names":[],"mappings":"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"}