ooxml-core 0.2.0

package/dist/docx/write-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-comments.d.ts","sourceRoot":"","sources":["../../src/docx/write-comments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAA6B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AA6DjG;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BlF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAI9E;AACD,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,EAAE,CAQ/E"}

package/dist/docx/write-drawing.d.ts

@@ -0,0 +1,12 @@
+import type { InlineImage } from './model.js';
+import type { RelationshipAllocator } from './relationship-allocator.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+export declare function findDrawingChild(run: XmlElement | undefined): XmlElement | undefined;
+/**
+ * Builds or reuses the run for an inline image. Reuses the original drawing XML verbatim
+ * (patching only extent/alt text) when the run is recognizably the same picture; synthesizes a
+ * minimal, valid `wp:inline` drawing for a newly inserted picture. Refuses to swap one picture's
+ * relationship for another in place rather than silently dropping the original XML.
+ */
+export declare function createImageRun(doc: XmlDocument, image: InlineImage, base: InlineImage | undefined, old: XmlElement | undefined, allocator?: RelationshipAllocator): XmlElement;
+//# sourceMappingURL=write-drawing.d.ts.map

package/dist/docx/write-drawing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-drawing.d.ts","sourceRoot":"","sources":["../../src/docx/write-drawing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAMN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAOlB,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAKpF;AA6ID;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,GAAG,EAAE,UAAU,GAAG,SAAS,EAC3B,SAAS,CAAC,EAAE,qBAAqB,GAC/B,UAAU,CAiDZ"}

package/dist/docx/write-header-footer.d.ts

@@ -0,0 +1,21 @@
+import type JSZip from 'jszip';
+import type { DocumentModel, PendingMediaPart, SectionProperties } from './model.js';
+import type { DocPrIdAllocator } from './docpr-ids.js';
+type Kind = 'headers' | 'footers';
+/** Header/footer parts the model references that the loaded package does not contain yet. */
+export declare function newHeaderFooterParts(model: DocumentModel, base: DocumentModel | undefined): Array<{
+    partName: string;
+    kind: Kind;
+}>;
+/**
+ * Creates every header/footer part the model added: an empty part, its content-type override and
+ * its document relationship. Returns the relationship id of each new part so `w:sectPr` can
+ * reference it. The part's blocks are written afterwards by `applyHeaderFooterEdits`.
+ */
+export declare function createHeaderFooterParts(zip: JSZip, model: DocumentModel, base: DocumentModel | undefined, docPrIds?: DocPrIdAllocator): Promise<Map<string, string>>;
+/** Sections with header/footer content reduced to part references, for comparing layout only. */
+export declare function sectionLayout(sections: SectionProperties[] | undefined): unknown;
+/** Rewrites every header/footer part whose blocks differ from the loaded baseline. */
+export declare function applyHeaderFooterEdits(zip: JSZip, model: DocumentModel, base: DocumentModel, pendingMedia?: ReadonlyMap<string, PendingMediaPart>, docPrIds?: DocPrIdAllocator): Promise<void>;
+export {};
+//# sourceMappingURL=write-header-footer.d.ts.map

package/dist/docx/write-header-footer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-header-footer.d.ts","sourceRoot":"","sources":["../../src/docx/write-header-footer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAEX,aAAa,EAEb,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAKvD,KAAK,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;AA4BlC,6FAA6F;AAC7F,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,aAAa,GAAG,SAAS,GAC7B,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAUzC;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC5C,GAAG,EAAE,KAAK,EACV,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA+C9B;AAED,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,SAAS,GAAG,OAAO,CAYhF;AAED,sFAAsF;AACtF,wBAAsB,sBAAsB,CAC3C,GAAG,EAAE,KAAK,EACV,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,aAAa,EACnB,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACpD,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/docx/write-inline.d.ts

@@ -0,0 +1,23 @@
+import type { TextRun } from './model.js';
+import type { RelationshipAllocator } from './relationship-allocator.js';
+import { type ParagraphRanges } from './write-ranges.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+/**
+ * One modeled run's source element, with the hyperlink or simple field that wrapped it (if any).
+ * A simple field without a cached result has a slot with no element.
+ */
+export interface InlineSlot {
+    element?: XmlElement;
+    container?: XmlElement;
+}
+/**
+ * Collects the paragraph's modeled runs in the same order the parser produced them. Returns
+ * `undefined` when the paragraph holds inline content this editor cannot safely regenerate.
+ * `w:pPr` and bookmarks are handled by the caller.
+ */
+export declare function collectInlineSlots(paragraph: XmlElement): InlineSlot[] | undefined;
+/** Top-level paragraph children that `buildInlineContent` output replaces. */
+export declare function replaceableInlineChildren(paragraph: XmlElement): XmlElement[];
+/** Builds the paragraph's ordered top-level inline nodes from the model's flat run list. */
+export declare function buildInlineContent(doc: XmlDocument, runs: TextRun[], base: TextRun[] | undefined, slots: InlineSlot[], allocator?: RelationshipAllocator, ranges?: ParagraphRanges): XmlElement[];
+//# sourceMappingURL=write-inline.d.ts.map

package/dist/docx/write-inline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-inline.d.ts","sourceRoot":"","sources":["../../src/docx/write-inline.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAiB,OAAO,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAIN,KAAK,eAAe,EAEpB,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EAON,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,SAAS,CAAC,EAAE,UAAU,CAAC;CACvB;AA4DD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,SAAS,CAyBlF;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU,EAAE,CAU7E;AAmDD,4FAA4F;AAC5F,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,EAC3B,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,CAAC,EAAE,qBAAqB,EACjC,MAAM,CAAC,EAAE,eAAe,GACtB,UAAU,EAAE,CA+Cd"}

package/dist/docx/write-notes.d.ts

@@ -0,0 +1,5 @@
+import type JSZip from 'jszip';
+import type { DocumentModel, PendingMediaPart } from './model.js';
+import type { DocPrIdAllocator } from './docpr-ids.js';
+export declare function applyNoteEdits(zip: JSZip, model: DocumentModel, base: DocumentModel, pendingMedia?: ReadonlyMap<string, PendingMediaPart>, docPrIds?: DocPrIdAllocator): Promise<void>;
+//# sourceMappingURL=write-notes.d.ts.map

package/dist/docx/write-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-notes.d.ts","sourceRoot":"","sources":["../../src/docx/write-notes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAQ,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAExE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA+BvD,wBAAsB,cAAc,CACnC,GAAG,EAAE,KAAK,EACV,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,aAAa,EACnB,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACpD,QAAQ,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/docx/write-paragraph-decoration.d.ts

@@ -0,0 +1,5 @@
+import type { Paragraph } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+/** Applies changed shading and borders to `w:pPr`; the caller re-sorts the properties. */
+export declare function writeParagraphDecoration(doc: XmlDocument, props: XmlElement, paragraph: Paragraph, base?: Paragraph): void;
+//# sourceMappingURL=write-paragraph-decoration.d.ts.map

package/dist/docx/write-paragraph-decoration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-paragraph-decoration.d.ts","sourceRoot":"","sources":["../../src/docx/write-paragraph-decoration.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAA4B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AA8DvF,0FAA0F;AAC1F,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,EACpB,IAAI,CAAC,EAAE,SAAS,GACd,IAAI,CAGN"}

package/dist/docx/write-paragraph-properties.d.ts

@@ -0,0 +1,4 @@
+import type { Paragraph } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+export declare function writeParagraphProperties(doc: XmlDocument, props: XmlElement, paragraph: Paragraph, base?: Paragraph): void;
+//# sourceMappingURL=write-paragraph-properties.d.ts.map

package/dist/docx/write-paragraph-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-paragraph-properties.d.ts","sourceRoot":"","sources":["../../src/docx/write-paragraph-properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AAuJ9F,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,SAAS,EACpB,IAAI,CAAC,EAAE,SAAS,GACd,IAAI,CAwBN"}

package/dist/docx/write-paragraph.d.ts

@@ -0,0 +1,8 @@
+import type { Paragraph } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+import type { CommentSpans } from './write-ranges.js';
+import type { RelationshipAllocator } from './relationship-allocator.js';
+export declare function setAttribute(element: XmlElement, local: string, value: string): void;
+export declare function writeParagraphImpl(doc: XmlDocument, paragraph: Paragraph, node: XmlElement, base: Paragraph | undefined, allocator: RelationshipAllocator | undefined, spans?: CommentSpans): XmlElement;
+export declare function createParagraph(doc: XmlDocument, paragraph: Paragraph, allocator: RelationshipAllocator | undefined, spans?: CommentSpans): XmlElement;
+//# sourceMappingURL=write-paragraph.d.ts.map

package/dist/docx/write-paragraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-paragraph.d.ts","sourceRoot":"","sources":["../../src/docx/write-paragraph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAmC,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAI9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEpF;AAsBD,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,SAAS,EAAE,qBAAqB,GAAG,SAAS,EAC5C,KAAK,CAAC,EAAE,YAAY,GAClB,UAAU,CAkFZ;AAED,wBAAgB,eAAe,CAC9B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,qBAAqB,GAAG,SAAS,EAC5C,KAAK,CAAC,EAAE,YAAY,GAClB,UAAU,CAGZ"}

package/dist/docx/write-ranges.d.ts

@@ -0,0 +1,42 @@
+import type { Block, TextRun } from './model.js';
+import { type CommentContinuation } from './comment-spans.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+/** How this paragraph's comment and move ranges continue across paragraphs, plus new range ids. */
+export interface ParagraphRanges extends CommentContinuation {
+    /** `w:id`s for move ranges that have none yet (new moves), by range key. */
+    rangeIds: ReadonlyMap<string, string>;
+}
+/** Comment range continuations in the blocks being written and in the part as loaded. */
+export interface CommentSpans {
+    next: Map<string, CommentContinuation>;
+    original: Map<string, CommentContinuation>;
+    /** Fresh `w:id`s for move ranges created in the editor (their runs carry no range id yet). */
+    rangeIds: Map<string, string>;
+    /** Allocates `w:id`s for new annotations such as bookmarks. */
+    nextId: () => string;
+}
+/**
+ * Hands out annotation `w:id`s (bookmarks, move ranges) after the largest id already in the part
+ * or among the model's revisions, so new markers never collide with existing ones.
+ */
+export declare function annotationIdAllocator(doc: XmlDocument, blocks: Block[]): () => string;
+/** `w:id`s for move ranges created in the editor, whose runs carry no range id yet. */
+export declare function newMoveRangeIds(blocks: Block[], nextId: () => string): Map<string, string>;
+/** A range marker to emit around a run: a comment anchor or a move range. */
+export type RangeEdge = {
+    kind: 'comment';
+    id: string;
+} | {
+    kind: 'moveFrom' | 'moveTo';
+    name: string;
+    rangeId: string;
+    revision: TextRun['revision'];
+};
+export declare function rangeStartNodes(doc: XmlDocument, edge: RangeEdge): XmlElement[];
+export declare function rangeEndNodes(doc: XmlDocument, edge: RangeEdge): XmlElement[];
+/** Range edges per run index: where each comment or move range opens and closes in this paragraph. */
+export declare function rangeEdges(runs: TextRun[], ranges: ParagraphRanges | undefined): {
+    opens: Map<number, RangeEdge[]>;
+    closes: Map<number, RangeEdge[]>;
+};
+//# sourceMappingURL=write-ranges.d.ts.map

package/dist/docx/write-ranges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-ranges.d.ts","sourceRoot":"","sources":["../../src/docx/write-ranges.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAa,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAa,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,EAAwB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAMnF,mGAAmG;AACnG,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC3D,4EAA4E;IAC5E,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC3C,8FAA8F;IAC9F,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAmBrF;AAQD,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAU1F;AAED,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAClB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;CAAE,CAAC;AAEjG,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,GAAG,UAAU,EAAE,CAQ/E;AACD,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,GAAG,UAAU,EAAE,CAK7E;AAED,sGAAsG;AACtG,wBAAgB,UAAU,CACzB,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,EAAE,eAAe,GAAG,SAAS,GACjC;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;CAAE,CAqCvE"}

package/dist/docx/write-revisions.d.ts

@@ -0,0 +1,10 @@
+import type { Paragraph, Revision } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+export declare const isRevisionWrapperElement: (element: XmlElement) => boolean;
+export declare const isCommentAnchorElement: (element: XmlElement) => boolean;
+export declare function revisionWrapper(doc: XmlDocument, revision: Revision, content: XmlElement): XmlElement;
+/** Deleted/moved-from text is stored as `w:delText` rather than `w:t`. */
+export declare function convertToDeleteText(doc: XmlDocument, run: XmlElement): void;
+/** Writes/clears the paragraph mark's own tracked insertion/deletion (`w:pPr/w:rPr/w:ins|w:del`). */
+export declare function writeParagraphMarkRevision(doc: XmlDocument, pPr: XmlElement, paragraph: Paragraph, base?: Paragraph): void;
+//# sourceMappingURL=write-revisions.d.ts.map

package/dist/docx/write-revisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-revisions.d.ts","sourceRoot":"","sources":["../../src/docx/write-revisions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AAmB9F,eAAO,MAAM,wBAAwB,GAAI,SAAS,UAAU,KAAG,OAChB,CAAC;AAChD,eAAO,MAAM,sBAAsB,GAAI,SAAS,UAAU,KAAG,OAChB,CAAC;AAiB9C,wBAAgB,eAAe,CAC9B,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,UAAU,GACjB,UAAU,CAOZ;AACD,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAQ3E;AAED,qGAAqG;AACrG,wBAAgB,0BAA0B,CACzC,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,SAAS,EACpB,IAAI,CAAC,EAAE,SAAS,GACd,IAAI,CAqBN"}

package/dist/docx/write-run-extra.d.ts

@@ -0,0 +1,5 @@
+import type { TextRun } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+/** Writes the run properties added for character styles, theming and table fidelity. */
+export declare function setExtendedRunProperties(doc: XmlDocument, props: XmlElement, run: TextRun, base?: TextRun): void;
+//# sourceMappingURL=write-run-extra.d.ts.map

package/dist/docx/write-run-extra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-run-extra.d.ts","sourceRoot":"","sources":["../../src/docx/write-run-extra.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AAwBvF,wFAAwF;AACxF,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,OAAO,EACZ,IAAI,CAAC,EAAE,OAAO,GACZ,IAAI,CAmDN"}

package/dist/docx/write-run-validation.d.ts

@@ -0,0 +1,4 @@
+import { type XmlElement } from './xml.js';
+/** Whether a run's `rPr` contains any property/attribute/value this writer does not model. */
+export declare function runHasUnknownProperties(run: XmlElement): boolean;
+//# sourceMappingURL=write-run-validation.d.ts.map

package/dist/docx/write-run-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-run-validation.d.ts","sourceRoot":"","sources":["../../src/docx/write-run-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AA+D3E,8FAA8F;AAC9F,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAwEhE"}

package/dist/docx/write-run.d.ts

@@ -0,0 +1,7 @@
+import type { TextRun } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+import type { RelationshipAllocator } from './relationship-allocator.js';
+/** Writes a toggle property: on, explicitly off (`w:val="0"`, which cancels a style), or absent. */
+export declare function setToggle(doc: XmlDocument, props: XmlElement, local: string, value: boolean | undefined): void;
+export declare function createRun(doc: XmlDocument, run: TextRun, base?: TextRun, old?: XmlElement, allocator?: RelationshipAllocator): XmlElement;
+//# sourceMappingURL=write-run.d.ts.map

package/dist/docx/write-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-run.d.ts","sourceRoot":"","sources":["../../src/docx/write-run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AAI9F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAQzE,oGAAoG;AACpG,wBAAgB,SAAS,CACxB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,GAAG,SAAS,GACxB,IAAI,CAMN;AA2LD,wBAAgB,SAAS,CACxB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,OAAO,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,GAAG,CAAC,EAAE,UAAU,EAChB,SAAS,CAAC,EAAE,qBAAqB,GAC/B,UAAU,CAmDZ"}

package/dist/docx/write-sections.d.ts

@@ -0,0 +1,10 @@
+import type { Block, SectionProperties } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+/**
+ * Applies `sections` to a body already rewritten for `blocks`. `base` is the loaded section list
+ * (empty for new documents); unchanged sections are left byte-identical.
+ */
+export declare function applySectionEdits(doc: XmlDocument, body: XmlElement, blocks: Block[], sections: SectionProperties[], base: SectionProperties[], 
+/** Relationship ids of header/footer parts created for this save, by part name. */
+references?: ReadonlyMap<string, string>): void;
+//# sourceMappingURL=write-sections.d.ts.map

package/dist/docx/write-sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-sections.d.ts","sourceRoot":"","sources":["../../src/docx/write-sections.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAqB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAI9E,OAAO,EAAmC,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAkO9F;;;GAGG;AACH,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,IAAI,EAAE,iBAAiB,EAAE;AACzB,mFAAmF;AACnF,UAAU,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GACjD,IAAI,CAsDN"}

package/dist/docx/write-table-properties.d.ts

@@ -0,0 +1,13 @@
+import type { Table } from './model.js';
+import type { TableBorders, TableRowProperties } from './table-model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+/** Changes only modeled row fields, preserving unmodeled trPr children and attributes. */
+export declare function patchRowProperties(doc: XmlDocument, tr: XmlElement, next: TableRowProperties | undefined, base: TableRowProperties | undefined): void;
+/** Updates table defaults without replacing borders, style, look or extension XML. */
+export declare function patchTableMargins(doc: XmlDocument, table: Table, node: XmlElement, base?: Table): void;
+/**
+ * Changes only the cell border sides that differ from `base`, keeping every other `tcPr` child
+ * (width, shading, margins, extensions) and untouched sides exactly as they were.
+ */
+export declare function patchCellBorders(doc: XmlDocument, tc: XmlElement, next: TableBorders | undefined, base: TableBorders | undefined): void;
+//# sourceMappingURL=write-table-properties.d.ts.map

package/dist/docx/write-table-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-table-properties.d.ts","sourceRoot":"","sources":["../../src/docx/write-table-properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAIzE,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAwCrF,0FAA0F;AAC1F,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,IAAI,EAAE,kBAAkB,GAAG,SAAS,GAClC,IAAI,CAmBN;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAChC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,KAAK,GACV,IAAI,CAqBN;AAyBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,WAAW,EAChB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,IAAI,EAAE,YAAY,GAAG,SAAS,GAC5B,IAAI,CA0BN"}

package/dist/docx/write-table.d.ts

@@ -0,0 +1,9 @@
+import type { Paragraph, Table } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+type ParagraphWriter = (doc: XmlDocument, paragraph: Paragraph, node: XmlElement, base?: Paragraph) => XmlElement;
+type SlotsWriter = (doc: XmlDocument, parent: XmlElement, old: XmlElement[], next: XmlElement[]) => void;
+/** Structural edits are restricted to plain rectangular tables with no hidden inline content. */
+export declare function canEditTableStructure(table: XmlElement): boolean;
+export declare function writeTable(doc: XmlDocument, table: Table, node: XmlElement, base: Table | undefined, writeParagraph: ParagraphWriter, replaceSlots: SlotsWriter): XmlElement;
+export {};
+//# sourceMappingURL=write-table.d.ts.map

package/dist/docx/write-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-table.d.ts","sourceRoot":"","sources":["../../src/docx/write-table.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAa,MAAM,YAAY,CAAC;AAM9D,OAAO,EAMN,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,MAAM,UAAU,CAAC;AAElB,KAAK,eAAe,GAAG,CACtB,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,SAAS,KACZ,UAAU,CAAC;AAChB,KAAK,WAAW,GAAG,CAClB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,UAAU,EAAE,EACjB,IAAI,EAAE,UAAU,EAAE,KACd,IAAI,CAAC;AAEV,iGAAiG;AACjG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAiChE;AAgED,wBAAgB,UAAU,CACzB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,KAAK,GAAG,SAAS,EACvB,cAAc,EAAE,eAAe,EAC/B,YAAY,EAAE,WAAW,GACvB,UAAU,CAqHZ"}

package/dist/docx/write-text-box.d.ts

@@ -0,0 +1,15 @@
+import type { InlineImage } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+export declare const SHAPE_GRAPHIC_URI = "http://schemas.microsoft.com/office/word/2010/wordprocessingShape";
+/** A new inline text box drawing with `image.textBoxText` as its paragraphs. */
+export declare function buildTextBoxDrawing(doc: XmlDocument, image: InlineImage, docPrId: string): XmlElement;
+/**
+ * Whether a text box is the simple form this module writes: not floating, with paragraphs that hold
+ * only plain runs of text. Such a box can have its text, size and outline edited without losing XML.
+ */
+export declare function isSimpleTextBox(graphicData: XmlElement | undefined, anchored: boolean): boolean;
+/** Whether the shape draws an outline (`a:ln` that is not `a:noFill`). */
+export declare function textBoxHasBorder(graphicData: XmlElement | undefined): boolean;
+/** Applies edited text, size and outline to an existing simple text box drawing in place. */
+export declare function patchTextBox(doc: XmlDocument, drawing: XmlElement, image: InlineImage, base: InlineImage): void;
+//# sourceMappingURL=write-text-box.d.ts.map

package/dist/docx/write-text-box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-text-box.d.ts","sourceRoot":"","sources":["../../src/docx/write-text-box.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAA4B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAMvF,eAAO,MAAM,iBAAiB,sEAAS,CAAC;AAqCxC,gFAAgF;AAChF,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,MAAM,GACb,UAAU,CAiEZ;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,UAAU,GAAG,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAgB/F;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAI7E;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAC3B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,WAAW,GACf,IAAI,CA4BN"}

package/dist/docx/write.d.ts

@@ -0,0 +1,25 @@
+import type { Block, DocumentModel, SectionProperties } from './model.js';
+import { type XmlDocument, type XmlElement } from './xml.js';
+import type { DocPrIdAllocator } from './docpr-ids.js';
+import { RelationshipAllocator, type NewRelationship } from './relationship-allocator.js';
+/**
+ * Applies `blocks` to the paragraphs and tables directly inside `container` (the document body, or
+ * a header, footer or note root), rewriting only blocks that changed relative to `original`.
+ * Without an allocator, new pictures and external links are rejected (their relationships would
+ * belong to a different package part).
+ */
+export declare function applyBlocks(doc: XmlDocument, container: XmlElement, blocks: Block[], original: Block[], allocator: RelationshipAllocator | undefined, contentWidthTwips: number, anchor?: XmlElement | null): void;
+export interface ApplyModelResult {
+    /** New hyperlink/image relationships save.ts must add to word/_rels/document.xml.rels. */
+    newRelationships: readonly NewRelationship[];
+}
+export declare function applyModel(doc: XmlDocument, model: DocumentModel, original: Block[], 
+/** Relationship ids already declared in word/_rels/document.xml.rels (styles, numbering, ...). */
+reservedRelationshipIds?: Iterable<string>, 
+/** The loaded document's sections, so unchanged sections stay byte-identical. */
+baseSections?: SectionProperties[], 
+/** Package-wide `wp:docPr` id allocator shared with header, footer and note parts. */
+docPrIds?: DocPrIdAllocator, 
+/** Relationship ids of header/footer parts created for this save, by part name. */
+headerFooterReferences?: ReadonlyMap<string, string>): ApplyModelResult;
+//# sourceMappingURL=write.d.ts.map

package/dist/docx/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/docx/write.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAa,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,UAAU,EAAW,MAAM,UAAU,CAAC;AAS9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EACN,qBAAqB,EAErB,KAAK,eAAe,EACpB,MAAM,6BAA6B,CAAC;AAmErC;;;;;GAKG;AACH,wBAAgB,WAAW,CAC1B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,UAAU,EACrB,MAAM,EAAE,KAAK,EAAE,EACf,QAAQ,EAAE,KAAK,EAAE,EACjB,SAAS,EAAE,qBAAqB,GAAG,SAAS,EAC5C,iBAAiB,EAAE,MAAM,EACzB,MAAM,GAAE,UAAU,GAAG,IAAW,GAC9B,IAAI,CA6CN;AAED,MAAM,WAAW,gBAAgB;IAChC,0FAA0F;IAC1F,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAED,wBAAgB,UAAU,CACzB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,KAAK,EAAE;AACjB,kGAAkG;AAClG,uBAAuB,GAAE,QAAQ,CAAC,MAAM,CAAM;AAC9C,iFAAiF;AACjF,YAAY,GAAE,iBAAiB,EAAO;AACtC,sFAAsF;AACtF,QAAQ,CAAC,EAAE,gBAAgB;AAC3B,mFAAmF;AACnF,sBAAsB,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GAC7D,gBAAgB,CAyDlB"}

package/dist/docx/xml.d.ts

@@ -0,0 +1,14 @@
+import { buildXml, elements, isElement, makeNS, textContent, type XmlDocument, type XmlElement, type XmlNode } from '../xml/index.js';
+export declare const WORD_NS: "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+/** OOXML relationships namespace used for `r:id`/`r:embed` attributes on drawings and hyperlinks. */
+export declare const REL_NS: "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
+export type { XmlDocument, XmlElement, XmlNode };
+export declare const parseXml: (xml: string) => XmlDocument;
+export { buildXml, elements, isElement, makeNS, textContent };
+export declare const named: (element: XmlElement | null | undefined, local: string) => boolean;
+export declare const children: (parent: ParentNode, local: string) => XmlElement[];
+export declare const first: (parent: ParentNode | null | undefined, local: string) => XmlElement | undefined;
+export declare const getW: (element: XmlElement | null | undefined, local: string) => string | undefined;
+export declare const getR: (element: XmlElement | null | undefined, local: string) => string | undefined;
+export declare const makeW: (doc: XmlDocument, local: string) => XmlElement;
+//# sourceMappingURL=xml.d.ts.map

package/dist/docx/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../src/docx/xml.ts"],"names":[],"mappings":"AAGA,OAAO,EAGN,QAAQ,EAER,QAAQ,EAER,SAAS,EACT,MAAM,EAIN,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,OAAO,gEAAO,CAAC;AAC5B,qGAAqG;AACrG,eAAO,MAAM,MAAM,uEAAO,CAAC;AAC3B,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AAEjD,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG,WAAiD,CAAC;AACzF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AAE9D,eAAO,MAAM,KAAK,GAAI,SAAS,UAAU,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,MAAM,KAAG,OAC7C,CAAC;AAClC,eAAO,MAAM,QAAQ,GAAI,QAAQ,UAAU,EAAE,OAAO,MAAM,KAAG,UAAU,EACpC,CAAC;AACpC,eAAO,MAAM,KAAK,GACjB,QAAQ,UAAU,GAAG,IAAI,GAAG,SAAS,EACrC,OAAO,MAAM,KACX,UAAU,GAAG,SAA4C,CAAC;AAC7D,eAAO,MAAM,IAAI,GAAI,SAAS,UAAU,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,MAAM,KAAG,MAAM,GAAG,SACnD,CAAC;AACpC,eAAO,MAAM,IAAI,GAAI,SAAS,UAAU,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,MAAM,KAAG,MAAM,GAAG,SAC9D,CAAC;AACzB,eAAO,MAAM,KAAK,GAAI,KAAK,WAAW,EAAE,OAAO,MAAM,KAAG,UACb,CAAC"}

package/dist/docx/zip-parts.d.ts

@@ -0,0 +1,5 @@
+import type JSZip from 'jszip';
+export { ensureContentTypeOverride } from '../opc/index.js';
+/** Returns the relationship id for `target`, creating the relationship (and rels part) if needed. */
+export declare const ensureDocumentRelationship: (zip: JSZip, type: string, target: string) => Promise<string>;
+//# sourceMappingURL=zip-parts.d.ts.map

package/dist/docx/zip-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-parts.d.ts","sourceRoot":"","sources":["../../src/docx/zip-parts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAI5D,qGAAqG;AACrG,eAAO,MAAM,0BAA0B,GAAI,KAAK,KAAK,EAAE,MAAM,MAAM,EAAE,QAAQ,MAAM,oBACzB,CAAC"}

package/dist/geometry/adjustment-aware-shapes.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Adjustment-aware geometry for shapes whose silhouette depends on the
+ * source PPTX's `shapeAdjustments` values.
+ *
+ * The static `PRESET_SHAPE_CLIP_PATHS` table renders every shape at its
+ * default adjustment values. This module supplements that table for the
+ * subset of shapes where ignoring the adjustments produces a visibly wrong
+ * outline (callouts, pies, donuts, block-arcs, etc.).
+ *
+ * Adjustment encodings (per ECMA-376 §20.1.9 / DrawingML preset shapes):
+ *   - **Distance** adjustments (`adjN` for callout pointer X/Y, donut hole,
+ *     band thickness, arrow head) are stored as 1/100,000ths of the body's
+ *     width or height. A pointer X of 25000 means 25% of width.
+ *   - **Angle** adjustments (`adjN` for sweep angles on pie/arc/blockArc/
+ *     circularArrow) are stored as 1/60,000ths of a degree. An angle value
+ *     of 16,200,000 corresponds to 270°.
+ *
+ * Default adjustment values are sourced from the `avLst` block of each
+ * shape's `presetShapeDefinitions` entry in ECMA-376 Annex E. The defaults
+ * applied here are documented inline.
+ *
+ * The exported {@link getAdjustmentAwareClipPath} returns a CSS
+ * `clip-path` string (always a `polygon(...)` for cross-browser safety —
+ * Firefox <105 lacks `path()` clip-path support). Returns `undefined`
+ * when the shape isn't in the supported set, allowing callers to fall
+ * back to the static preset polygon.
+ *
+ * @module adjustment-aware-shapes
+ */
+/**
+ * Convert an OOXML angle adjustment value (60,000ths of a degree) to radians.
+ * Falls back to {@link defaultUnits} when {@link value} is non-finite.
+ */
+declare function angleAdjToRadians(value: number | undefined, defaultUnits: number): number;
+/**
+ * Convert an OOXML distance adjustment value (100,000ths of a fraction)
+ * to a unit fraction in [-2, 2]. Negative or oversized values are clamped
+ * to a sane range that keeps the resulting polygon finite.
+ */
+declare function distanceAdjToFraction(value: number | undefined, defaultUnits: number): number;
+/** Build a polygon clip-path string from a list of [xFrac, yFrac] points. */
+declare function polygonFromFractions(points: ReadonlyArray<readonly [number, number]>): string;
+/**
+ * Build a CSS `clip-path` value for {@link shapeType} that incorporates
+ * the supplied `shapeAdjustments`. Returns `undefined` for shapes that
+ * are not in the adjustment-aware table — callers should fall back to
+ * the static preset polygon.
+ *
+ * @param shapeType  The OOXML preset geometry name (e.g. `"pie"`).
+ * @param width      The element width in pixels.
+ * @param height     The element height in pixels.
+ * @param adjustments Optional adjustment record from `PptxElement.shapeAdjustments`.
+ *                    Keys are `adj`, `adj1`, `adj2`, etc.
+ * @returns A CSS `clip-path` polygon expression, or `undefined`.
+ */
+export declare function getAdjustmentAwareClipPath(shapeType: string, width: number, height: number, adjustments?: Record<string, number>): string | undefined;
+export declare const _internalForTests: {
+    polygonFromFractions: typeof polygonFromFractions;
+    angleAdjToRadians: typeof angleAdjToRadians;
+    distanceAdjToFraction: typeof distanceAdjToFraction;
+};
+export {};
+//# sourceMappingURL=adjustment-aware-shapes.d.ts.map

package/dist/geometry/adjustment-aware-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjustment-aware-shapes.d.ts","sourceRoot":"","sources":["../../src/geometry/adjustment-aware-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAqBH;;;GAGG;AACH,iBAAS,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAIlF;AAED;;;;GAIG;AACH,iBAAS,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAUtF;AA2BD,6EAA6E;AAC7E,iBAAS,oBAAoB,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAGtF;AA4rBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACzC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,GAAG,SAAS,CAuCpB;AAID,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAC"}

package/dist/geometry/callout-geometry.d.ts

@@ -0,0 +1,65 @@
+/** A 2D point in pixel coordinates relative to the shape's top-left origin. */
+export interface CalloutPoint {
+    x: number;
+    y: number;
+}
+/** The result of computing callout leader line geometry. */
+export interface CalloutLeaderLineGeometry {
+    /**
+     * Ordered list of points forming the callout leader line.
+     * For callout1: 2 points (start, end).
+     * For callout2: 3 points (start, bend, end).
+     * For callout3: 4 points (start, bend1, bend2, end).
+     */
+    points: CalloutPoint[];
+    /** Whether the shape variant has a visible border (bordercallout, accentbordercallout). */
+    hasBorder: boolean;
+    /** Whether the shape variant has an accent bar (accentcallout, accentbordercallout). */
+    hasAccent: boolean;
+}
+/**
+ * Returns true if the given shape type name is a callout shape with a leader line.
+ *
+ * @param shapeType - The OOXML preset geometry name (case-insensitive).
+ */
+export declare function isCalloutShape(shapeType: string | undefined): boolean;
+/**
+ * Returns the tier (1, 2, or 3) for the callout shape, indicating the number
+ * of line segments. Returns 0 if the shape type is not a callout.
+ */
+export declare function getCalloutTier(shapeType: string): 0 | 1 | 2 | 3;
+/**
+ * Computes the callout leader line geometry for a given callout shape element.
+ *
+ * @param shapeType - The OOXML preset geometry name.
+ * @param width - Shape width in pixels.
+ * @param height - Shape height in pixels.
+ * @param adjustments - Shape adjustment values record (from `shapeAdjustments`).
+ * @returns The computed leader line geometry, or `null` if not a callout shape.
+ */
+export declare function getCalloutLeaderLineGeometry(shapeType: string, width: number, height: number, adjustments?: Record<string, number>): CalloutLeaderLineGeometry | null;
+/**
+ * Builds an SVG path `d` attribute string for the callout leader line.
+ *
+ * @param geometry - The computed callout leader line geometry.
+ * @returns An SVG path data string (e.g. "M 10 20 L 30 40 L 50 60").
+ */
+export declare function buildCalloutLeaderLineSvgPath(geometry: CalloutLeaderLineGeometry): string;
+/**
+ * Computes the SVG viewBox bounds for a callout shape including the leader line.
+ * The leader line can extend beyond the shape boundary (negative coordinates
+ * or coordinates > width/height), so the viewBox must be expanded.
+ *
+ * @param width - Shape width in pixels.
+ * @param height - Shape height in pixels.
+ * @param geometry - The callout leader line geometry.
+ * @param padding - Extra padding in pixels around the bounds (default 2).
+ * @returns The viewBox bounds as `{ minX, minY, viewWidth, viewHeight }`.
+ */
+export declare function getCalloutViewBoxBounds(width: number, height: number, geometry: CalloutLeaderLineGeometry, padding?: number): {
+    minX: number;
+    minY: number;
+    viewWidth: number;
+    viewHeight: number;
+};
+//# sourceMappingURL=callout-geometry.d.ts.map

package/dist/geometry/callout-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callout-geometry.d.ts","sourceRoot":"","sources":["../../src/geometry/callout-geometry.ts"],"names":[],"mappings":"AAgCA,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAED,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACzC;;;;;OAKG;IACH,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,2FAA2F;IAC3F,SAAS,EAAE,OAAO,CAAC;IACnB,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;CACnB;AAqED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAKrE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAY/D;AAwCD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC3C,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,yBAAyB,GAAG,IAAI,CA8ClC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,CAWzF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,yBAAyB,EACnC,OAAO,SAAI,GACT;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CA2BvE"}

package/dist/geometry/cloud-bezier-paths.d.ts

@@ -0,0 +1,55 @@
+/**
+ * High-DPI Bezier-curve clip-paths for `cloud` and `cloudCallout` presets.
+ *
+ * The static polygon entries in {@link CLIP_PATHS_EXTENDED} approximate the
+ * cumulus silhouette with 32 vertices, which becomes visibly faceted on
+ * Retina/4K displays. These helpers return CSS `path('M…Z')` expressions
+ * built from cubic-Bezier lobes, so the outline stays smooth at any DPI.
+ *
+ * `path()` in CSS does not accept percentage units, so callers must supply
+ * pixel dimensions and re-compute on resize. Use {@link getCloudPathForRendering}
+ * (in `shape-geometry.ts`) for the shape-aware wrapper.
+ *
+ * Browser support: Chrome 109+, Safari 15.4+, Firefox 105+.
+ *
+ * @module cloud-bezier-paths
+ */
+/**
+ * Produce a CSS `clip-path: path('…')` expression for the `cloud` preset.
+ *
+ * The body centre is the bounding-box centre. 8 cubic-Bezier lobes are
+ * walked clockwise; each lobe is rendered as a near-circular bump using
+ * two cubic-Bezier segments connected by a transition arc back toward the
+ * next lobe's start. The path is closed with `Z`.
+ *
+ * @param width - Element width in pixels.
+ * @param height - Element height in pixels.
+ * @returns A CSS `path('M…Z')` expression suitable for `clip-path`.
+ */
+export declare function getCloudClipPath(width: number, height: number): string;
+/**
+ * Produce a CSS `clip-path: path('…')` expression for the `cloudCallout`
+ * preset. Combines the 8-lobe cumulus body with the spec-default 3-bump
+ * tail trailing toward the lower-left.
+ *
+ * The body is shrunk to ~75% of the bounding box (centred slightly toward
+ * the upper-right) so the tail bumps fit within the 100% box. Adjustment-
+ * driven repositioning of the pointer tip is handled by Agent B in
+ * `adjustment-aware-shapes.ts`; this helper uses the spec defaults.
+ *
+ * @param width - Element width in pixels.
+ * @param height - Element height in pixels.
+ * @returns A CSS `path('M…Z')` expression suitable for `clip-path`.
+ */
+export declare function getCloudCalloutClipPath(width: number, height: number): string;
+/**
+ * Lobe count exposed for tests and downstream consumers that want to
+ * verify the spec-correct number of cumulus piles.
+ */
+export declare const CLOUD_LOBE_COUNT: number;
+/**
+ * Tail bump count exposed for tests; matches the spec default for the
+ * `cloudCallout` pointer trail.
+ */
+export declare const CLOUD_CALLOUT_TAIL_COUNT: number;
+//# sourceMappingURL=cloud-bezier-paths.d.ts.map

package/dist/geometry/cloud-bezier-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-bezier-paths.d.ts","sourceRoot":"","sources":["../../src/geometry/cloud-bezier-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAsIH;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA6CtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAwD7E;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAqB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAA4B,CAAC"}

package/dist/geometry/com-avlst-ground-truth.d.ts

@@ -0,0 +1,48 @@
+/**
+ * PowerPoint COM ground truth for `avLst` adjustment-guide names/defaults,
+ * gathered 2026-09-05 for the W3-F geometry audit.
+ *
+ * Method: `Presentation.Slides(1).Shapes.AddShape(<MsoAutoShapeType>, 0, 0,
+ * 200, 100)` for each id below, then `Shape.Adjustments.Count` and
+ * `Shape.Adjustments.Item(i)` read back BEFORE saving (PowerPoint omits
+ * `<a:avLst>` entirely from the saved file when every guide is still at its
+ * built-in default, so the file itself is NOT a usable source for this - the
+ * live COM object's `Adjustments` collection is). `Adjustments.Item(i)`
+ * returns the guide's value as a plain 0..1 fraction; multiplying by 100000
+ * recovers the OOXML `<a:gd fmla="val …"/>` integer (cross-checked against
+ * `roundRect`, whose known-correct default of 16667 read back as exactly
+ * `0.16667`). Adjustment guide NAMES are positional by ECMA-376 convention
+ * (`"adj"` alone for a single guide, else `"adj1"..."adjN"` in order), which
+ * this repo's own spec-accurate `gear9` CONNECTION-SITES table
+ * (`preset-connection-sites-gear9.ts`, transcribed independently from
+ * `presetShapeDefinitions.xml` for hit-testing, not for this render path)
+ * independently confirms for gear9's `adj1`/`adj2` names and defaults.
+ *
+ * `preset-shape-definitions-tabs-decorations-test.ts` and
+ * `preset-shape-definitions-action-buttons.test.ts` assert the corresponding
+ * `PRESET_SHAPE_GEOMETRY_TABLE` entries directly; this file's own test
+ * (`com-avlst-ground-truth.test.ts`) diffs the FULL table against every
+ * preset recorded here, so a future edit that silently reintroduces a wrong
+ * guide count/name/default fails immediately instead of waiting for another
+ * COM audit to notice.
+ *
+ * This is NOT a full 187-preset sweep (that would require either a reliable
+ * ECMA-name -> MsoAutoShapeType mapping for all 187 presets, which this repo
+ * does not have catalogued anywhere, or per-preset raw-XML probing; both are
+ * out of scope for this pass) - it covers the three preset families the W3-F
+ * brief flagged as known-wrong (`actionButton*`, `gear6`, `gear9`) plus a
+ * couple of already-correct presets kept in as regression anchors so the
+ * diff test itself is proven to catch a real mismatch, not just an absent
+ * one.
+ */
+/** `msoAutoShapeType` id -> the COM-verified `avLst` ground truth. */
+export interface ComAvLstGroundTruthEntry {
+    /** ECMA-376 `ST_ShapeType` / `a:prstGeom/@prst` name. */
+    prst: string;
+    /** `Shape.Adjustments.Count`. */
+    count: number;
+    /** Guide name -> default value in the OOXML `1/100000` integer scale. */
+    guides: Record<string, number>;
+}
+export declare const COM_AVLST_GROUND_TRUTH: ComAvLstGroundTruthEntry[];
+//# sourceMappingURL=com-avlst-ground-truth.d.ts.map