@syncfusion/ej2-docx 0.0.0-stage → 35.1.39

package/src/features/document/augmentations.d.ts

@@ -0,0 +1,578 @@
+/**
+ * Shared ambient augmentations for optional feature members on core types.
+ *
+ * Single source of truth for declaration merging onto the modules that
+ * actually export the classes:
+ * - `./index` (package barrel; `src/index.ts` re-exports it as `@syncfusion/ej2-docx`)
+ * - `./document`, `./paragraph`, `./section`
+ *
+ * Do not augment the package id `@syncfusion/ej2-docx` from this file.
+ * `gulp ci-publish` / `es5-scripts` type-checks `src/**` as its own program.
+ * TypeScript 3.3.1 resolves an external augmentation name before it will
+ * merge it (`resolveExternalModule`). Inside that program the package name
+ * has no resolvable module — `package.json` `main` points at a file that
+ * does not exist yet — so `declare module '@syncfusion/ej2-docx'` is TS2664.
+ * An ambient script stub is not part of the external-module resolution
+ * path that this compile uses. Augmenting `./index` merges the same
+ * interfaces onto the symbols consumers import from the package.
+ *
+ * Lives under `src/features/document/` with the document model. Package entry
+ * points side-effect-import this module. Runtime prototype installs remain in
+ * each feature module; importing this file has no runtime effect beyond
+ * ensuring the ambient merges are in the program.
+ *
+ * Headers/footers continue to augment `PageSetup` from the
+ * headers-footers feature (not WordDocument/Paragraph).
+ *
+ * @packageDocumentation
+ * @private
+ */
+export {};
+declare module './index' {
+    interface WordDocument {
+        /**
+         * Gets the comments defined in this document.
+         * The collection contains the comment bodies associated with document comment ranges.
+         */
+        readonly comments: import('../comments/index').CommentCollection;
+        /**
+         * Paired bookmarks in document order (`BookmarkCollection`).
+         * Orphan markers remain in the DOM but are omitted from this collection.
+         */
+        readonly bookmarks: import('../bookmarks/index').BookmarkCollection;
+        /**
+         * Primary → alternate font name dictionary (`w:font/@w:name` →
+         * `w:altName/@w:val`, ECMA-376-1 §17.8.3.1).
+         *
+         * **Preferred public API** for font substitutions (TASK-8067). Map-style
+         * methods (`set` / `get` / `has` / `delete` / `clear`, iteration). Same
+         * object identity on every access for this document. Mutations dirty the
+         * font table part; save emits `word/fontTable.xml` when dirty.
+         *
+         * Requires the font-table feature (via `@syncfusion/ej2-docx/font-table`, styles, or
+         * {@link registerFontTableFeature}). Does not require calling
+         * {@link fontTableFor} — that helper remains for full `CT_Font` catalog
+         * metadata only.
+         */
+        readonly fontSubstitutionTable: import('../font-table/index').FontSubstitutionTable;
+        /**
+         * @private
+         */
+        readonly mailMerge: import('../mail-merge/index').MailMergeCatalog;
+        /**
+         * Document-level footnotes manager. Stable identity; enumerates interned
+         * {@link import('../notes/index').Footnote} bodies referenced from the main story.
+         */
+        readonly footnotes: import('../notes/index').Footnotes;
+        /**
+         * Document-level endnotes manager. Stable identity; enumerates interned
+         * {@link import('../notes/index').Endnote} bodies referenced from the main story.
+         */
+        readonly endnotes: import('../notes/index').Endnotes;
+        /**
+         * @private
+         * Document-owned live styles collection (`styleCollectionFor` / public StyleCollection). */
+        readonly styles: import('../styles/index').StyleCollection;
+        /**
+         * Create a custom table style and add it to this document's styles collection.
+         *
+         * @param name Display name used to derive a deterministic style id.
+         * @returns Live table style owned by this document.
+         */
+        addTableStyle(name: string): import('../styles/index').TableStyle;
+        /**
+         * Create a custom list (numbering) style and add it to this document.
+         *
+         * @param listType Bulleted or numbered list category.
+         * @param styleName Display name; must be unique among document styles.
+         * @returns Live list style owned by this document.
+         */
+        addListStyle(listType: import('../numbering/list-style').ListType, styleName: string): import('../numbering/list-style').ListStyle;
+        /**
+         * @private
+         * The theme catalog for this document. Equivalent to `themeFor(document)`.
+         * Plural name matches the product DOM surface (`document.themes`).
+         */
+        readonly themes: import('../styles/theme').ThemePart;
+        /**
+         * View preferences for this document (`w:settings` view / zoom).
+         * Same object identity on every access.
+         */
+        readonly viewSetup: import('../settings/document-settings-facades').ViewSetup;
+        /**
+         * Document settings facade (`compatibility`, protection-adjacent surface).
+         * Same object identity on every access.
+         */
+        readonly settings: import('../settings/document-settings-facades').DocumentSettings;
+        /**
+         * Whether track revisions is enabled (`w:trackRevisions`). Absent → false.
+         */
+        trackRevisions: boolean;
+        /**
+         * Default tab stop in points (`w:defaultTabStop`).
+         */
+        defaultTabStop: number;
+        /**
+         * Attached template metadata from settings, when present.
+         */
+        readonly attachedTemplate: import('../settings/index').AttachedTemplate | undefined;
+        /**
+         * Gets or sets the document watermark.
+         * Assign `undefined` to clear.
+         */
+        watermark: import('../watermark/index').Watermark | undefined;
+    }
+    interface Body {
+        /**
+         * Appends a block-level content control (`w:sdt`) to this body.
+         *
+         * @param type - Authorable content-control kind.
+         * @returns The appended {@link BlockContentControl}.
+         *
+         * @example
+         * ```ts
+         * import { WordDocument, ContentControlType } from '@syncfusion/ej2-docx';
+         * const doc = WordDocument.create();
+         * const block = doc.body.addBlockContentControl(ContentControlType.Text);
+         * block.tag = 'cust';
+         * ```
+         */
+        addBlockContentControl(type: import('../content-controls/index').ContentControlType): import('../content-controls/index').BlockContentControl;
+        /**
+         * Appends a 1×1 table to the document body. Resize with {@link Table.resetCells}.
+         *
+         * Discover existing tables by walking {@link Body.items} with
+         * {@link isTableBlock} (no document-order list accessor on the body).
+         *
+         * @returns The appended {@link Table}.
+         */
+        appendTable(): import('../tables/index').Table;
+    }
+    interface Paragraph {
+        /**
+         * Append a bookmark start marker (`w:bookmarkStart`) at the end of this paragraph.
+         *
+         * @param name - Bookmark name (`w:name`); must be non-empty / not whitespace-only.
+         * @returns The authored start marker (pending id until save).
+         */
+        appendBookmarkStart(name: string): import('../bookmarks/index').BookmarkStart;
+        /**
+         * Append a bookmark end marker (`w:bookmarkEnd`) pairing with `start`.
+         *
+         * @param start - Start marker previously appended (possibly in another paragraph).
+         * @returns The authored end marker.
+         */
+        appendBookmarkEnd(start: import('../bookmarks/index').BookmarkStart): import('../bookmarks/index').BookmarkEnd;
+        /**
+         * Append a same-paragraph bookmark: start, optional text run, then end.
+         * Omitting `options.text` creates an empty bookmark (adjacent markers).
+         */
+        appendBookmark(name: string, options?: {
+            text?: string;
+        }): import('../bookmarks/index').Bookmark;
+        /**
+         * Append a new comment (range markers + elevated {@link Comment}) on this paragraph.
+         *
+         * @param text - Initial comment body text.
+         * @param options - Optional author, initials, date, and content range indices.
+         * @returns Interned {@link Comment} shared with the document catalog.
+         */
+        appendComment(text: string, options?: import('../comments/index').AppendCommentMetadata): import('../comments/index').Comment;
+        /**
+         * Append a new comment using a single options object (`text` required).
+         *
+         * @param options - Full {@link AppendCommentOptions}.
+         * @returns Interned {@link Comment} shared with the document catalog.
+         */
+        appendComment(options: import('../comments/index').AppendCommentOptions): import('../comments/index').Comment;
+        /**
+         * Appends a run-level content control (`w:sdt`) to this paragraph.
+         *
+         * @param type - Authorable content-control kind.
+         * @returns The appended {@link InlineContentControl}.
+         *
+         * @example
+         * ```ts
+         * import { WordDocument, ContentControlType } from '@syncfusion/ej2-docx';
+         * const doc = WordDocument.create();
+         * const p = doc.appendParagraph();
+         * const cc = p.appendInlineContentControl(ContentControlType.CheckBox);
+         * cc.isChecked = true;
+         * ```
+         */
+        appendInlineContentControl(type: import('../content-controls/index').ContentControlType): import('../content-controls/index').InlineContentControl;
+        /**
+         * Append a DrawingML preset shape as dual MC AlternateContent
+         * (Choice `wps` + Fallback VML stub). Default placement is anchor.
+         */
+        appendShape(autoShapeType: import('../drawing/index').AutoShapeType, width: number, height: number): import('../drawing/index').Shape;
+        /**
+         * Append an empty wordprocessing group as dual MC AlternateContent
+         * (Choice `wpg` + Fallback VML stub). Nest children via
+         * {@link GroupShape.appendShape} on the returned group (TASK-8051).
+         * Default placement is anchor.
+         */
+        appendGroup(options: import('../drawing/index').GroupOptions): import('../drawing/index').GroupShape;
+        /**
+         * Append a new editable range that wraps a fresh text run at the end of
+         * this paragraph (bookmark-style authoring).
+         *
+         * Allocates a pending range id (materialized on save). Optional
+         * `editorGroup` / `editor` map `w:edGrp` / `w:ed`. The library does not
+         * evaluate document protection or editor identity.
+         *
+         * @param text - Text for the enclosed run
+         * @param options - Optional `editorGroup`, `editor`, column attributes
+         * @returns Live pair view (pending id until save)
+         * @example
+         * ```ts
+         * const range = paragraph.appendEditableRange('edit me', { editorGroup: 'everyone' });
+         * ```
+         */
+        appendEditableRange(text: string, options?: import('../editable-ranges/index').AppendEditableRangeOptions): import('../editable-ranges/index').EditableRange;
+        /**
+         * Wrap existing content in this paragraph between the given inline indices
+         * (see {@link insertEditableRangeAt}).
+         *
+         * @param options - Inclusive/exclusive indices and optional editor metadata
+         * @returns Live pair view (pending id until save)
+         */
+        insertEditableRangeAt(options: import('../editable-ranges/index').EditableRangeWrapOptions): import('../editable-ranges/index').EditableRange;
+        /**
+         * Append a supported Word field (PAGE, NUMPAGES, IF, MERGEFIELD, HYPERLINK).
+         *
+         * @param fieldName - Logical name (merge field name, or placeholder for PAGE/NUMPAGES/IF/HYPERLINK).
+         * @param fieldType - Supported FieldType.
+         */
+        appendField(fieldName: string, fieldType: import('../fields/index').FieldType): import('../fields/index').Field;
+        appendHyperlink(target: string, textToDisplay: string, type: import('../fields/index').HyperlinkType): import('../fields/index').Hyperlink;
+        appendHyperlink(target: string, picture: import('../images/index').Picture, type: import('../fields/index').HyperlinkType): import('../fields/index').Hyperlink;
+        appendImage(bytes: Uint8Array, options?: import('../images/index').ImageOptions): import('../images/index').Image;
+        /**
+         * Append a footnote reference and body to this paragraph.
+         *
+         * @param text - Initial body text for the note.
+         */
+        appendFootnote(text: string): import('../notes/index').Footnote;
+        /**
+         * Append an endnote reference and body to this paragraph.
+         *
+         * @param text - Initial body text for the note.
+         */
+        appendEndnote(text: string): import('../notes/index').Endnote;
+        /**
+         * Assign a list by numbering instance id (escape hatch). Prefer {@link Paragraph.listFormat}.
+         * @deprecated Prefer `listFormat` for customer-facing list authoring.
+         */
+        numbering: {
+            numId: number;
+            level?: number;
+        };
+        /**
+         * Resolved list label for this paragraph (empty when not in a list).
+         * Read-only; does not mutate numbering counters.
+         */
+        readonly listString: string;
+        /**
+         * Append an embedded or linked OLE object. Internal feature surface —
+         * not part of the public `@syncfusion/ej2-docx` / `@syncfusion/ej2-docx/all` API.
+         *
+         * @private
+         */
+        appendOleObject(options: import('../ole-object/index').AppendOleObjectOptions): import('../ole-object/index').OleObject;
+        style: string | undefined;
+    }
+    interface Section {
+        /**
+         * Section break kind written on this section's `w:sectPr` (`w:type`).
+         * Prefer this over retired public `sectionStart` naming.
+         *
+         * @public
+         */
+        breakCode: import('../sections/index').SectionBreakCode;
+        /**
+         * Explicit text columns for this section (`w:cols` / `w:col`).
+         * Same {@link import('../sections/index').ColumnCollection} identity
+         * as {@link import('../sections/index').PageSetup.columns}.
+         *
+         * @public
+         */
+        readonly columns: import('../sections/index').ColumnCollection;
+        /**
+         * Appends one explicit text column (`w:col`) to {@link Section.columns}.
+         *
+         * @param width - Column width in points.
+         * @param spacing - Spacing after the column in points (default from library).
+         * @returns The appended {@link import('../sections/index').Column}.
+         *
+         * @public
+         */
+        addColumn(width: number, spacing?: number): import('../sections/index').Column;
+    }
+}
+declare module './document' {
+    interface WordDocument {
+        /**
+         * Gets the comments defined in this document.
+         * The collection contains the comment bodies associated with document comment ranges.
+         */
+        readonly comments: import('../comments/index').CommentCollection;
+        /**
+         * Paired bookmarks in document order (`BookmarkCollection`).
+         * Orphan markers remain in the DOM but are omitted from this collection.
+         */
+        readonly bookmarks: import('../bookmarks/index').BookmarkCollection;
+        /**
+         * Primary → alternate font name dictionary (`w:font/@w:name` →
+         * `w:altName/@w:val`, ECMA-376-1 §17.8.3.1).
+         *
+         * **Preferred public API** for font substitutions (TASK-8067). Map-style
+         * methods (`set` / `get` / `has` / `delete` / `clear`, iteration). Same
+         * object identity on every access for this document. Mutations dirty the
+         * font table part; save emits `word/fontTable.xml` when dirty.
+         *
+         * Requires the font-table feature (via `@syncfusion/ej2-docx/font-table`, styles, or
+         * {@link registerFontTableFeature}). Does not require calling
+         * {@link fontTableFor} — that helper remains for full `CT_Font` catalog
+         * metadata only.
+         */
+        readonly fontSubstitutionTable: import('../font-table/index').FontSubstitutionTable;
+        /**
+         * @private
+         */
+        readonly mailMerge: import('../mail-merge/index').MailMergeCatalog;
+        /**
+         * Document-level footnotes manager. Stable identity; enumerates interned
+         * {@link import('../notes/index').Footnote} bodies referenced from the main story.
+         */
+        readonly footnotes: import('../notes/index').Footnotes;
+        /**
+         * Document-level endnotes manager. Stable identity; enumerates interned
+         * {@link import('../notes/index').Endnote} bodies referenced from the main story.
+         */
+        readonly endnotes: import('../notes/index').Endnotes;
+        /**
+         * @private
+         * Document-owned live styles collection (`styleCollectionFor` / public StyleCollection). */
+        readonly styles: import('../styles/index').StyleCollection;
+        /**
+         * Create a custom table style and add it to this document's styles collection.
+         *
+         * @param name Display name used to derive a deterministic style id.
+         * @returns Live table style owned by this document.
+         */
+        addTableStyle(name: string): import('../styles/index').TableStyle;
+        /**
+         * Create a custom list (numbering) style and add it to this document.
+         *
+         * @param listType Bulleted or numbered list category.
+         * @param styleName Display name; must be unique among document styles.
+         * @returns Live list style owned by this document.
+         */
+        addListStyle(listType: import('../numbering/list-style').ListType, styleName: string): import('../numbering/list-style').ListStyle;
+        /**
+         * @private
+         * The theme catalog for this document. Equivalent to `themeFor(document)`.
+         * Plural name matches the product DOM surface (`document.themes`).
+         */
+        readonly themes: import('../styles/theme').ThemePart;
+        /**
+         * View preferences for this document (`w:settings` view / zoom).
+         * Same object identity on every access.
+         */
+        readonly viewSetup: import('../settings/document-settings-facades').ViewSetup;
+        /**
+         * Document settings facade (`compatibility`, protection-adjacent surface).
+         * Same object identity on every access.
+         */
+        readonly settings: import('../settings/document-settings-facades').DocumentSettings;
+        /**
+         * Whether track revisions is enabled (`w:trackRevisions`). Absent → false.
+         */
+        trackRevisions: boolean;
+        /**
+         * Default tab stop in points (`w:defaultTabStop`).
+         */
+        defaultTabStop: number;
+        /**
+         * Attached template metadata from settings, when present.
+         */
+        readonly attachedTemplate: import('../settings/index').AttachedTemplate | undefined;
+        /**
+         * Gets or sets the document watermark.
+         * Assign `undefined` to clear.
+         */
+        watermark: import('../watermark/index').Watermark | undefined;
+    }
+    interface Body {
+        /**
+         * Appends a block-level content control (`w:sdt`) to this body.
+         *
+         * @param type - Authorable content-control kind.
+         * @returns The appended {@link BlockContentControl}.
+         */
+        addBlockContentControl(type: import('../content-controls/index').ContentControlType): import('../content-controls/index').BlockContentControl;
+        /**
+         * Appends a 1×1 table to the first section body. Resize with {@link Table.resetCells}.
+         *
+         * Discover existing tables by walking {@link Body.items} with
+         * {@link isTableBlock} (no document-order list accessor on the body).
+         *
+         * @returns The appended {@link Table}.
+         */
+        appendTable(): import('../tables/index').Table;
+    }
+}
+declare module './paragraph' {
+    interface Paragraph {
+        /**
+         * Append a bookmark start marker (`w:bookmarkStart`) at the end of this paragraph.
+         *
+         * @param name - Bookmark name (`w:name`); must be non-empty / not whitespace-only.
+         * @returns The authored start marker (pending id until save).
+         */
+        appendBookmarkStart(name: string): import('../bookmarks/index').BookmarkStart;
+        /**
+         * Append a bookmark end marker (`w:bookmarkEnd`) pairing with `start`.
+         *
+         * @param start - Start marker previously appended (possibly in another paragraph).
+         * @returns The authored end marker.
+         */
+        appendBookmarkEnd(start: import('../bookmarks/index').BookmarkStart): import('../bookmarks/index').BookmarkEnd;
+        /**
+         * Append a same-paragraph bookmark: start, optional text run, then end.
+         * Omitting `options.text` creates an empty bookmark (adjacent markers).
+         */
+        appendBookmark(name: string, options?: {
+            text?: string;
+        }): import('../bookmarks/index').Bookmark;
+        /**
+         * Append a new comment (range markers + elevated {@link Comment}) on this paragraph.
+         *
+         * @param text - Initial comment body text.
+         * @param options - Optional author, initials, date, and content range indices.
+         * @returns Interned {@link Comment} shared with the document catalog.
+         */
+        appendComment(text: string, options?: import('../comments/index').AppendCommentMetadata): import('../comments/index').Comment;
+        /**
+         * Append a new comment using a single options object (`text` required).
+         *
+         * @param options - Full {@link AppendCommentOptions}.
+         * @returns Interned {@link Comment} shared with the document catalog.
+         */
+        appendComment(options: import('../comments/index').AppendCommentOptions): import('../comments/index').Comment;
+        /**
+         * Appends a run-level content control (`w:sdt`) to this paragraph.
+         *
+         * @param type - Authorable content-control kind.
+         * @returns The appended {@link InlineContentControl}.
+         */
+        appendInlineContentControl(type: import('../content-controls/index').ContentControlType): import('../content-controls/index').InlineContentControl;
+        /**
+         * Append a DrawingML preset shape as dual MC AlternateContent
+         * (Choice `wps` + Fallback VML stub). Default placement is anchor.
+         */
+        appendShape(autoShapeType: import('../drawing/index').AutoShapeType, width: number, height: number): import('../drawing/index').Shape;
+        /**
+         * Append an empty wordprocessing group as dual MC AlternateContent
+         * (Choice `wpg` + Fallback VML stub). Nest children via
+         * {@link GroupShape.appendShape} on the returned group (TASK-8051).
+         * Default placement is anchor.
+         */
+        appendGroup(options: import('../drawing/index').GroupOptions): import('../drawing/index').GroupShape;
+        /**
+         * Append a new editable range that wraps a fresh text run at the end of
+         * this paragraph (bookmark-style authoring).
+         *
+         * Allocates a pending range id (materialized on save). Optional
+         * `editorGroup` / `editor` map `w:edGrp` / `w:ed`. The library does not
+         * evaluate document protection or editor identity.
+         *
+         * @param text - Text for the enclosed run
+         * @param options - Optional `editorGroup`, `editor`, column attributes
+         * @returns Live pair view (pending id until save)
+         * @example
+         * ```ts
+         * const range = paragraph.appendEditableRange('edit me', { editorGroup: 'everyone' });
+         * ```
+         */
+        appendEditableRange(text: string, options?: import('../editable-ranges/index').AppendEditableRangeOptions): import('../editable-ranges/index').EditableRange;
+        /**
+         * Wrap existing content in this paragraph between the given inline indices
+         * (see {@link insertEditableRangeAt}).
+         *
+         * @param options - Inclusive/exclusive indices and optional editor metadata
+         * @returns Live pair view (pending id until save)
+         */
+        insertEditableRangeAt(options: import('../editable-ranges/index').EditableRangeWrapOptions): import('../editable-ranges/index').EditableRange;
+        /**
+         * Append a supported Word field (PAGE, NUMPAGES, IF, MERGEFIELD, HYPERLINK).
+         *
+         * @param fieldName - Logical name (merge field name, or placeholder for PAGE/NUMPAGES/IF/HYPERLINK).
+         * @param fieldType - Supported FieldType.
+         */
+        appendField(fieldName: string, fieldType: import('../fields/index').FieldType): import('../fields/index').Field;
+        appendHyperlink(target: string, textToDisplay: string, type: import('../fields/index').HyperlinkType): import('../fields/index').Hyperlink;
+        appendHyperlink(target: string, picture: import('../images/index').Picture, type: import('../fields/index').HyperlinkType): import('../fields/index').Hyperlink;
+        appendImage(bytes: Uint8Array, options?: import('../images/index').ImageOptions): import('../images/index').Image;
+        /**
+         * Append a footnote reference and body to this paragraph.
+         *
+         * @param text - Initial body text for the note.
+         */
+        appendFootnote(text: string): import('../notes/index').Footnote;
+        /**
+         * Append an endnote reference and body to this paragraph.
+         *
+         * @param text - Initial body text for the note.
+         */
+        appendEndnote(text: string): import('../notes/index').Endnote;
+        /**
+         * Assign a list by numbering instance id (escape hatch). Prefer {@link Paragraph.listFormat}.
+         * @deprecated Prefer `listFormat` for customer-facing list authoring.
+         */
+        numbering: {
+            numId: number;
+            level?: number;
+        };
+        /**
+         * Resolved list label for this paragraph (empty when not in a list).
+         * Read-only; does not mutate numbering counters.
+         */
+        readonly listString: string;
+        /**
+         * Append an embedded or linked OLE object. Internal feature surface —
+         * not part of the public `@syncfusion/ej2-docx` / `@syncfusion/ej2-docx/all` API.
+         *
+         * @private
+         */
+        appendOleObject(options: import('../ole-object/index').AppendOleObjectOptions): import('../ole-object/index').OleObject;
+        style: string | undefined;
+    }
+}
+declare module './section' {
+    interface Section {
+        /**
+         * Section break kind (`w:type` on `w:sectPr`).
+         *
+         * @public
+         */
+        breakCode: import('../sections/index').SectionBreakCode;
+        /**
+         * Explicit text columns (`w:cols` / `w:col`).
+         *
+         * @public
+         */
+        readonly columns: import('../sections/index').ColumnCollection;
+        /**
+         * Appends one explicit text column to {@link Section.columns}.
+         *
+         * @param width - Column width in points.
+         * @param spacing - Spacing after the column in points.
+         * @returns The appended column.
+         *
+         * @public
+         */
+        addColumn(width: number, spacing?: number): import('../sections/index').Column;
+    }
+}

package/src/features/document/body-always-on.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Always-on body/run/inline / package-part feature bootstrap (tables,
+ * content-controls, images, drawing, bookmarks, fields, numbering, sections,
+ * headers-footers, comments, revisions).
+ *
+ * Core never imports feature modules. Feature entry side-effects (and the main
+ * `@syncfusion/ej2-docx` entry) register idempotent `register*Feature` callbacks here so
+ * every `WordDocument.create` / `fromPackage` re-arms handlers after test resets.
+ * Numbering uses the same hook to re-arm its `registerFeaturePartHandler` for
+ * `/word/numbering.xml`. Headers/footers and comments re-arm
+ * `registerFeatureMultiPartHandler` for their relationship types (comments also
+ * registers inline/run-leaf handlers for range markers and `commentReference`).
+ * Sections re-arm WordDocument.create wrapping and feature registration for typed
+ * `w:sectPr` (not classic body-block handlers). Revisions re-arm inline/block
+ * track-change handlers and move-range markers (no package part).
+ *
+ * @private
+ */
+/**
+ * Register a callback invoked before main-document body parse/create.
+ * Idempotent registration of the feature itself is the callee's job.
+ *
+ * @private
+ */
+export declare function registerAlwaysOnBodyFeatureBootstrap(fn: () => void): void;
+/**
+ * Run all always-on body feature bootstraps. Safe when none are registered
+ * (pure core without main entry / feature imports).
+ *
+ * @private
+ */
+export declare function ensureAlwaysOnBodyFeaturesRegistered(): void;
+/**
+ * @private
+ * Test hook — clear bootstrap list (does not unregister handlers). */
+export declare function resetAlwaysOnBodyFeatureBootstrapsForTests(): void;