@nutrient-sdk/document-authoring 1.9.0 → 1.10.0-preview.202511190848.699bffb9b1b1b29b73a48a4e5a94269656184974

package/README.md

@@ -78,7 +78,7 @@ the SDK via `npm`).
 
 ### Example
 
-You can download an example project demoing both TypeScript and JavaScript integration from [here](https://document-authoring.cdn.nutrient.io/releases/document-authoring-1.9.0-example.zip), unzip it and run:
+You can download an example project demoing both TypeScript and JavaScript integration from [here](https://document-authoring.cdn.staging.nutrient.io/releases/document-authoring-1.10.0-preview.202511190848.699bffb9b1b1b29b73a48a4e5a94269656184974-example.zip), unzip it and run:
 
 ```bash
 npm install
@@ -92,7 +92,7 @@ By default, the Document Authoring SDK will fetch the required files (fonts, emo
 
 ### Self-hosting the assets
 
-To host the assets on your own infrastructure you can download them from [here](https://document-authoring.cdn.nutrient.io/releases/document-authoring-1.9.0-assets.zip) and deploy them to a suitable location.
+To host the assets on your own infrastructure you can download them from [here](https://document-authoring.cdn.staging.nutrient.io/releases/document-authoring-1.10.0-preview.202511190848.699bffb9b1b1b29b73a48a4e5a94269656184974-assets.zip) and deploy them to a suitable location.
 Provide an appropriate base path when initializing the Document Authoring SDK.
 
 #### Example:

package/lib/docauth.mjs

@@ -14,7 +14,7 @@ var e=[
 // Style actions
 {id:"style.apply",label:"Apply Style",description:"Apply a style to the selection"}],i={items:[{type:"built-in",id:"zoom-select",builtInType:"zoom"},{type:"separator",id:"sep-after-zoom"},{type:"built-in",id:"mobile-lock",builtInType:"mobile-lock",visible:e=>!!e.mobile},{type:"separator",id:"separator-after-mobile-lock",visible:e=>!!e.mobile},{type:"built-in",id:"undo-btn",builtInType:"undo",visible:e=>!e.mobile},{type:"built-in",id:"redo-btn",builtInType:"redo",visible:e=>!e.mobile},{type:"separator",id:"sep-after-undo-redo",visible:e=>!e.mobile},{type:"built-in",id:"style-menu",builtInType:"style-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-style",visible:e=>!e.mobile},{type:"built-in",id:"font-family-select",builtInType:"font-family",visible:e=>!e.mobile},{type:"built-in",id:"font-size-input",builtInType:"font-size",visible:e=>!e.mobile},{type:"separator",id:"sep-after-font",visible:e=>!e.mobile},{type:"built-in",id:"bold-btn",builtInType:"bold",visible:e=>!e.mobile},{type:"built-in",id:"italic-btn",builtInType:"italic",visible:e=>!e.mobile},{type:"built-in",id:"underline-btn",builtInType:"underline",visible:e=>!e.mobile},{type:"built-in",id:"strikethrough-btn",builtInType:"strikethrough",visible:e=>!e.mobile},{type:"built-in",id:"subscript-btn",builtInType:"subscript",visible:e=>!e.mobile},{type:"built-in",id:"superscript-btn",builtInType:"superscript",visible:e=>!e.mobile},{type:"separator",id:"sep-after-character-formatting",visible:e=>!e.mobile},{type:"built-in",id:"text-color-picker",builtInType:"text-color",visible:e=>!e.mobile},{type:"built-in",id:"highlight-color-picker",builtInType:"highlight-color",visible:e=>!e.mobile},{type:"separator",id:"sep-after-colors",visible:e=>!e.mobile},{type:"built-in",id:"align-left-btn",builtInType:"align-left",visible:e=>!e.mobile},{type:"built-in",id:"align-center-btn",builtInType:"align-center",visible:e=>!e.mobile},{type:"built-in",id:"align-right-btn",builtInType:"align-right",visible:e=>!e.mobile},{type:"built-in",id:"align-justify-btn",builtInType:"align-justify",visible:e=>!e.mobile},{type:"separator",id:"sep-after-alignment",visible:e=>!e.mobile},{type:"built-in",id:"line-spacing-menu",builtInType:"line-spacing-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-line-spacing",visible:e=>!e.mobile},{type:"built-in",id:"bulleted-list",builtInType:"bulleted-list",visible:e=>!e.mobile},{type:"built-in",id:"numbered-list",builtInType:"numbered-list",visible:e=>!e.mobile},{type:"separator",id:"sep-after-lists",visible:e=>!e.mobile},{type:"built-in",id:"decrease-indent-btn",builtInType:"decrease-indent",visible:e=>!e.mobile},{type:"built-in",id:"increase-indent-btn",builtInType:"increase-indent",visible:e=>!e.mobile},{type:"separator",id:"sep-after-indentation",visible:e=>!e.mobile},{type:"built-in",id:"clear-formatting-btn",builtInType:"clear-formatting",visible:e=>!e.mobile},{type:"built-in",id:"formatting-marks-btn",builtInType:"formatting-marks",visible:e=>!e.mobile},{type:"separator",id:"sep-after-formatting-marks",visible:e=>!e.mobile},{type:"built-in",id:"page-setup-menu",builtInType:"page-setup-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-page-setup",visible:e=>!e.mobile},{type:"built-in",id:"insert-menu",builtInType:"insert-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-insert",visible:e=>!e.mobile},{type:"built-in",id:"table-menu",builtInType:"table-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-table",visible:e=>!e.mobile},{type:"built-in",id:"download-menu",builtInType:"download-menu"},{type:"separator",id:"sep-before-ui-settings",visible:e=>!e.mobile},{type:"built-in",id:"ui-settings-menu",builtInType:"ui-settings-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-ui-settings",visible:e=>!e.mobile}]};
 // ../packages/ui/src/actions/default-actions-standalone.ts
-const t={type:"default-index"};async function l(e){return(await(async e=>{const i=new URL(e??"https://document-authoring.cdn.nutrient.io/2025/1/",window.location.href).href,t=new URL("docauth-impl-bb2295f65aaabbe8.js",i).href;return import(
+const t={type:"default-index"};async function l(e){return(await(async e=>{const i=new URL(e??"https://document-authoring.cdn.staging.nutrient.io/2025/1/",window.location.href).href,t=new URL("docauth-impl-f92e3c338b35ac07.js",i).href;return import(
 /*webpackIgnore: true*/
 /* @vite-ignore */
 t)})(e?.assets?.base)).createDocAuthSystem(e)}var n={createDocAuthSystem:l,defaultFontIndex:t,defaultActions:e,defaultToolbarConfig:i};export{l as createDocAuthSystem,n as default,e as defaultActions,t as defaultFontIndex,i as defaultToolbarConfig};

package/lib/docauth.umd.js

@@ -14,7 +14,7 @@
 // Style actions
 {id:"style.apply",label:"Apply Style",description:"Apply a style to the selection"}],t={items:[{type:"built-in",id:"zoom-select",builtInType:"zoom"},{type:"separator",id:"sep-after-zoom"},{type:"built-in",id:"mobile-lock",builtInType:"mobile-lock",visible:e=>!!e.mobile},{type:"separator",id:"separator-after-mobile-lock",visible:e=>!!e.mobile},{type:"built-in",id:"undo-btn",builtInType:"undo",visible:e=>!e.mobile},{type:"built-in",id:"redo-btn",builtInType:"redo",visible:e=>!e.mobile},{type:"separator",id:"sep-after-undo-redo",visible:e=>!e.mobile},{type:"built-in",id:"style-menu",builtInType:"style-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-style",visible:e=>!e.mobile},{type:"built-in",id:"font-family-select",builtInType:"font-family",visible:e=>!e.mobile},{type:"built-in",id:"font-size-input",builtInType:"font-size",visible:e=>!e.mobile},{type:"separator",id:"sep-after-font",visible:e=>!e.mobile},{type:"built-in",id:"bold-btn",builtInType:"bold",visible:e=>!e.mobile},{type:"built-in",id:"italic-btn",builtInType:"italic",visible:e=>!e.mobile},{type:"built-in",id:"underline-btn",builtInType:"underline",visible:e=>!e.mobile},{type:"built-in",id:"strikethrough-btn",builtInType:"strikethrough",visible:e=>!e.mobile},{type:"built-in",id:"subscript-btn",builtInType:"subscript",visible:e=>!e.mobile},{type:"built-in",id:"superscript-btn",builtInType:"superscript",visible:e=>!e.mobile},{type:"separator",id:"sep-after-character-formatting",visible:e=>!e.mobile},{type:"built-in",id:"text-color-picker",builtInType:"text-color",visible:e=>!e.mobile},{type:"built-in",id:"highlight-color-picker",builtInType:"highlight-color",visible:e=>!e.mobile},{type:"separator",id:"sep-after-colors",visible:e=>!e.mobile},{type:"built-in",id:"align-left-btn",builtInType:"align-left",visible:e=>!e.mobile},{type:"built-in",id:"align-center-btn",builtInType:"align-center",visible:e=>!e.mobile},{type:"built-in",id:"align-right-btn",builtInType:"align-right",visible:e=>!e.mobile},{type:"built-in",id:"align-justify-btn",builtInType:"align-justify",visible:e=>!e.mobile},{type:"separator",id:"sep-after-alignment",visible:e=>!e.mobile},{type:"built-in",id:"line-spacing-menu",builtInType:"line-spacing-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-line-spacing",visible:e=>!e.mobile},{type:"built-in",id:"bulleted-list",builtInType:"bulleted-list",visible:e=>!e.mobile},{type:"built-in",id:"numbered-list",builtInType:"numbered-list",visible:e=>!e.mobile},{type:"separator",id:"sep-after-lists",visible:e=>!e.mobile},{type:"built-in",id:"decrease-indent-btn",builtInType:"decrease-indent",visible:e=>!e.mobile},{type:"built-in",id:"increase-indent-btn",builtInType:"increase-indent",visible:e=>!e.mobile},{type:"separator",id:"sep-after-indentation",visible:e=>!e.mobile},{type:"built-in",id:"clear-formatting-btn",builtInType:"clear-formatting",visible:e=>!e.mobile},{type:"built-in",id:"formatting-marks-btn",builtInType:"formatting-marks",visible:e=>!e.mobile},{type:"separator",id:"sep-after-formatting-marks",visible:e=>!e.mobile},{type:"built-in",id:"page-setup-menu",builtInType:"page-setup-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-page-setup",visible:e=>!e.mobile},{type:"built-in",id:"insert-menu",builtInType:"insert-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-insert",visible:e=>!e.mobile},{type:"built-in",id:"table-menu",builtInType:"table-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-table",visible:e=>!e.mobile},{type:"built-in",id:"download-menu",builtInType:"download-menu"},{type:"separator",id:"sep-before-ui-settings",visible:e=>!e.mobile},{type:"built-in",id:"ui-settings-menu",builtInType:"ui-settings-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-ui-settings",visible:e=>!e.mobile}]};
 // ../packages/ui/src/actions/default-actions-standalone.ts
-const l={type:"default-index"};async function n(e){return(await(async e=>{const i=new URL(e??"https://document-authoring.cdn.nutrient.io/2025/1/",window.location.href).href,t=new URL("docauth-impl-bb2295f65aaabbe8.js",i).href;return import(
+const l={type:"default-index"};async function n(e){return(await(async e=>{const i=new URL(e??"https://document-authoring.cdn.staging.nutrient.io/2025/1/",window.location.href).href,t=new URL("docauth-impl-f92e3c338b35ac07.js",i).href;return import(
 /*webpackIgnore: true*/
 /* @vite-ignore */
 t)})(e?.assets?.base)).createDocAuthSystem(e)}var o={createDocAuthSystem:n,defaultFontIndex:l,defaultActions:i,defaultToolbarConfig:t};e.createDocAuthSystem=n,e.default=o,e.defaultActions=i,e.defaultFontIndex=l,e.defaultToolbarConfig=t,Object.defineProperty(e,"__esModule",{value:!0})}));

package/lib/index.d.cts

@@ -400,8 +400,14 @@ export declare type CreateEditorOptions = {
      * Allows toggling/changing various UI options.
      */
     ui?: UIOptions;
-
-
+    /**
+     * @internal
+     */
+    __hideDOCXDownload?: boolean;
+    /**
+     * @internal
+     */
+    __hidePDFDownload?: boolean;
 };
 
 /**
@@ -631,7 +637,10 @@ export declare type DocAuthDocument = {
      * @see <a href="https://www.nutrient.io/guides/document-authoring/working-with-documents/docx/" target="_blank">DOCX export guide</a>
      */
     exportDOCX(options?: ExportDOCXOptions): Promise<ArrayBuffer>;
-
+    /**
+     * @alpha
+     */
+    transaction<T = void>(callback: TransactionCallback<T>): Promise<T>;
     /**
      * The `DocAuthSystem` this document is bound to.
      */
@@ -1352,6 +1361,287 @@ export declare type ImportDOCXOptions = {
  */
 export declare type Locale = 'en' | 'fr' | 'de';
 
+/**
+ * @alpha
+ * @sidebarGroup programmatic api
+ */
+export declare namespace Programmatic {
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Range = {
+        begin: number;
+        end?: number;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Formatting = {
+        font: string | null;
+        fontSize: number | null;
+        bold: boolean | null;
+        italic: boolean | null;
+        color: string | null;
+        highlight: string | null;
+        strikeout: boolean | null;
+        underline: boolean | null;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type SearchFor = string | RegExp;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Replacement = {
+        text?: string;
+        formatting?: Partial<Formatting>;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type ReplaceFn = (value: string) => Replacement | string;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type ReplacementOrReplaceFn = Replacement | ReplaceFn | string;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type ReplaceTextSignature = (searchFor: SearchFor, replace: ReplacementOrReplaceFn) => number;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type SearchResult = {
+        range: Range;
+        text: string;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type TextView = {
+        getPlainText(range?: Range): string;
+        searchText(searchFor: SearchFor, after?: Range): SearchResult | undefined;
+        replaceText: ReplaceTextSignature;
+        setText(value: string, range?: Range): Range;
+        setFormatting(formatting: Partial<Formatting>, range?: Range): void;
+        inlines(): RangeInline[];
+        addLineBreak(insertionPoint?: {
+            placement: 'before' | 'after';
+            range: Range;
+        }): LineBreak;
+        addInlineText(text: string, insertionPoint?: {
+            placement: 'before' | 'after';
+            range: Range;
+        }): InlineText;
+        removeInline(index?: number): Inline | undefined;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Extent = {
+        width: number;
+        height: number;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Image = {
+        type: 'image';
+        extent(): Extent;
+        setExtent(extent: Partial<Extent>): void;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Field = {
+        type: 'field';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Footnote = {
+        type: 'footnote';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type FootnoteRef = {
+        type: 'footnote/ref';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Endnote = {
+        type: 'endnote';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type EndnoteRef = {
+        type: 'endnote/ref';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type LineBreak = {
+        type: 'line-break';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type PageBreak = {
+        type: 'page-break';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Tab = {
+        type: 'tab';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Separator = {
+        type: 'sep';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type InlineText = {
+        type: 'text';
+        plainText(): string;
+        formatting(): Formatting;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Inline = InlineText | Tab | Separator | LineBreak | PageBreak | Image | Field | Footnote | FootnoteRef | Endnote | EndnoteRef;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type RangeInline = {
+        range: Range;
+        inline: Inline;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Paragraph = {
+        type: 'paragraph';
+        asTextView(): TextView;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type TableCell = BlockLevelContainer;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type TableRow = {
+        cells(): TableCell[];
+        addCell(index?: number): TableCell;
+        removeCell(index: number): TableCell | undefined;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Table = {
+        type: 'table';
+        rows(): TableRow[];
+        addRow(index?: number): TableRow;
+        removeRow(index: number): TableRow | undefined;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type BlockLevel = Paragraph | Table;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type BlockLevelContainer = {
+        blocklevels(): BlockLevel[];
+        addParagraph(index?: number): Paragraph;
+        addTable(index?: number): Table;
+        removeElement(index: number): BlockLevel | undefined;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type PageSize = {
+        width: number;
+        height: number;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type PageMargins = {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type PageSetup = {
+        setPageSize(size: Partial<PageSize>): void;
+        setPageMargins(margins: Partial<PageMargins>): void;
+        pageSize(): PageSize;
+        pageMargins(): PageMargins;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type HeaderFooter = BlockLevelContainer;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type HeadersFooters = {
+        default(): HeaderFooter | null;
+        first(): HeaderFooter | null;
+        even(): HeaderFooter | null;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type HeadersAndFooters = {
+        headers(): HeadersFooters;
+        footers(): HeadersFooters;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Section = {
+        pageSetup(): PageSetup;
+        headersAndFooters(): HeadersAndFooters;
+        content(): BlockLevelContainer;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Body = {
+        sections(): Section[];
+        addSection(index?: number): Section;
+        removeSection(index: number): Section | undefined;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Document = {
+        body(): Body;
+        replaceText: ReplaceTextSignature;
+    };
+        {};
+}
+
 /**
  * Toolbar API - Type definitions for customizing the editor toolbar
  */
@@ -1553,6 +1843,28 @@ export declare type ToolbarSeparatorItem = {
     id: string;
 };
 
+/**
+ * @alpha
+ * @sidebarGroup programmatic api
+ * @see {@link DocAuthDocument.transaction} for running transactions with this callback type.
+ */
+export declare type TransactionCallback<T = void> = (context: {
+    draft: Programmatic.Document;
+}) => Promise<TransactionResult<T>>;
+
+/**
+ * @alpha
+ * @sidebarGroup programmatic api
+ * @see {@link TransactionCallback} for the callback signature that returns this result type.
+ */
+export declare type TransactionResult<T = void> = undefined | boolean | {
+    commit: boolean;
+    result: T;
+} | Promise<undefined | boolean | {
+    commit: boolean;
+    result: T;
+}>;
+
 /**
  * Configuration options for the user interface.
  *
@@ -1588,7 +1900,16 @@ export declare type UIOptions = {
          */
         enabled: boolean;
     };
-
+    /**
+     * @internal
+     *
+     * Initial zoom level for the editor.
+     *
+     * Valid range is 0.5 to 4.0, which any values provided will be clamped to.
+     *
+     * @defaultValue `1`
+     */
+    initialZoom?: number;
     /**
      * Initial toolbar configuration.
      *

package/lib/index.d.mts

@@ -400,8 +400,14 @@ export declare type CreateEditorOptions = {
      * Allows toggling/changing various UI options.
      */
     ui?: UIOptions;
-
-
+    /**
+     * @internal
+     */
+    __hideDOCXDownload?: boolean;
+    /**
+     * @internal
+     */
+    __hidePDFDownload?: boolean;
 };
 
 /**
@@ -631,7 +637,10 @@ export declare type DocAuthDocument = {
      * @see <a href="https://www.nutrient.io/guides/document-authoring/working-with-documents/docx/" target="_blank">DOCX export guide</a>
      */
     exportDOCX(options?: ExportDOCXOptions): Promise<ArrayBuffer>;
-
+    /**
+     * @alpha
+     */
+    transaction<T = void>(callback: TransactionCallback<T>): Promise<T>;
     /**
      * The `DocAuthSystem` this document is bound to.
      */
@@ -1352,6 +1361,287 @@ export declare type ImportDOCXOptions = {
  */
 export declare type Locale = 'en' | 'fr' | 'de';
 
+/**
+ * @alpha
+ * @sidebarGroup programmatic api
+ */
+export declare namespace Programmatic {
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Range = {
+        begin: number;
+        end?: number;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Formatting = {
+        font: string | null;
+        fontSize: number | null;
+        bold: boolean | null;
+        italic: boolean | null;
+        color: string | null;
+        highlight: string | null;
+        strikeout: boolean | null;
+        underline: boolean | null;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type SearchFor = string | RegExp;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Replacement = {
+        text?: string;
+        formatting?: Partial<Formatting>;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type ReplaceFn = (value: string) => Replacement | string;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type ReplacementOrReplaceFn = Replacement | ReplaceFn | string;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type ReplaceTextSignature = (searchFor: SearchFor, replace: ReplacementOrReplaceFn) => number;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type SearchResult = {
+        range: Range;
+        text: string;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type TextView = {
+        getPlainText(range?: Range): string;
+        searchText(searchFor: SearchFor, after?: Range): SearchResult | undefined;
+        replaceText: ReplaceTextSignature;
+        setText(value: string, range?: Range): Range;
+        setFormatting(formatting: Partial<Formatting>, range?: Range): void;
+        inlines(): RangeInline[];
+        addLineBreak(insertionPoint?: {
+            placement: 'before' | 'after';
+            range: Range;
+        }): LineBreak;
+        addInlineText(text: string, insertionPoint?: {
+            placement: 'before' | 'after';
+            range: Range;
+        }): InlineText;
+        removeInline(index?: number): Inline | undefined;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Extent = {
+        width: number;
+        height: number;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Image = {
+        type: 'image';
+        extent(): Extent;
+        setExtent(extent: Partial<Extent>): void;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Field = {
+        type: 'field';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Footnote = {
+        type: 'footnote';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type FootnoteRef = {
+        type: 'footnote/ref';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Endnote = {
+        type: 'endnote';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type EndnoteRef = {
+        type: 'endnote/ref';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type LineBreak = {
+        type: 'line-break';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type PageBreak = {
+        type: 'page-break';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Tab = {
+        type: 'tab';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Separator = {
+        type: 'sep';
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type InlineText = {
+        type: 'text';
+        plainText(): string;
+        formatting(): Formatting;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Inline = InlineText | Tab | Separator | LineBreak | PageBreak | Image | Field | Footnote | FootnoteRef | Endnote | EndnoteRef;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type RangeInline = {
+        range: Range;
+        inline: Inline;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Paragraph = {
+        type: 'paragraph';
+        asTextView(): TextView;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type TableCell = BlockLevelContainer;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type TableRow = {
+        cells(): TableCell[];
+        addCell(index?: number): TableCell;
+        removeCell(index: number): TableCell | undefined;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Table = {
+        type: 'table';
+        rows(): TableRow[];
+        addRow(index?: number): TableRow;
+        removeRow(index: number): TableRow | undefined;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type BlockLevel = Paragraph | Table;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type BlockLevelContainer = {
+        blocklevels(): BlockLevel[];
+        addParagraph(index?: number): Paragraph;
+        addTable(index?: number): Table;
+        removeElement(index: number): BlockLevel | undefined;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type PageSize = {
+        width: number;
+        height: number;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type PageMargins = {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type PageSetup = {
+        setPageSize(size: Partial<PageSize>): void;
+        setPageMargins(margins: Partial<PageMargins>): void;
+        pageSize(): PageSize;
+        pageMargins(): PageMargins;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type HeaderFooter = BlockLevelContainer;
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type HeadersFooters = {
+        default(): HeaderFooter | null;
+        first(): HeaderFooter | null;
+        even(): HeaderFooter | null;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type HeadersAndFooters = {
+        headers(): HeadersFooters;
+        footers(): HeadersFooters;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Section = {
+        pageSetup(): PageSetup;
+        headersAndFooters(): HeadersAndFooters;
+        content(): BlockLevelContainer;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Body = {
+        sections(): Section[];
+        addSection(index?: number): Section;
+        removeSection(index: number): Section | undefined;
+        replaceText: ReplaceTextSignature;
+    };
+    /**
+     * @sidebarGroup programmatic api
+     */
+    export type Document = {
+        body(): Body;
+        replaceText: ReplaceTextSignature;
+    };
+        {};
+}
+
 /**
  * Toolbar API - Type definitions for customizing the editor toolbar
  */
@@ -1553,6 +1843,28 @@ export declare type ToolbarSeparatorItem = {
     id: string;
 };
 
+/**
+ * @alpha
+ * @sidebarGroup programmatic api
+ * @see {@link DocAuthDocument.transaction} for running transactions with this callback type.
+ */
+export declare type TransactionCallback<T = void> = (context: {
+    draft: Programmatic.Document;
+}) => Promise<TransactionResult<T>>;
+
+/**
+ * @alpha
+ * @sidebarGroup programmatic api
+ * @see {@link TransactionCallback} for the callback signature that returns this result type.
+ */
+export declare type TransactionResult<T = void> = undefined | boolean | {
+    commit: boolean;
+    result: T;
+} | Promise<undefined | boolean | {
+    commit: boolean;
+    result: T;
+}>;
+
 /**
  * Configuration options for the user interface.
  *
@@ -1588,7 +1900,16 @@ export declare type UIOptions = {
          */
         enabled: boolean;
     };
-
+    /**
+     * @internal
+     *
+     * Initial zoom level for the editor.
+     *
+     * Valid range is 0.5 to 4.0, which any values provided will be clamped to.
+     *
+     * @defaultValue `1`
+     */
+    initialZoom?: number;
     /**
      * Initial toolbar configuration.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nutrient-sdk/document-authoring",
-	"version": "1.9.0",
+	"version": "1.10.0-preview.202511190848.699bffb9b1b1b29b73a48a4e5a94269656184974",
 	"description": "A web SDK for word processing and rich text capabilities.",
 	"type": "commonjs",
 	"main": "lib/docauth.umd.js",