@nutrient-sdk/document-authoring 1.9.0-preview.202510241936.9f989d53d54c916f7857a572a63625d636359767 → 1.9.0-preview.202511030843.fde7b7ea0cd1beee611ebc75b37f110193857a94

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.staging.nutrient.io/releases/document-authoring-1.9.0-preview.202510241936.9f989d53d54c916f7857a572a63625d636359767-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.9.0-preview.202511030843.fde7b7ea0cd1beee611ebc75b37f110193857a94-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.staging.nutrient.io/releases/document-authoring-1.9.0-preview.202510241936.9f989d53d54c916f7857a572a63625d636359767-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.9.0-preview.202511030843.fde7b7ea0cd1beee611ebc75b37f110193857a94-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

@@ -1,4 +1,20 @@
-const t={type:"default-index"},e=async t=>(await(async t=>{const e=new URL(t??"https://document-authoring.cdn.staging.nutrient.io/2025/1/",window.location.href).href,a=new URL("docauth-impl-65d42ac8c14d0231.js",e).href;return import(
+var e=[
+// Document actions
+{id:"document.undo",label:"Undo",description:"Undo the last action",shortcuts:["Cmd+Z"]},{id:"document.redo",label:"Redo",description:"Redo the last undone action",shortcuts:["Cmd+Y","Cmd+Shift+Z"]},{id:"document.export-pdf",label:"Download PDF",description:"Export document as PDF"},{id:"document.export-docx",label:"Download DOCX",description:"Export document as DOCX"},
+// Formatting actions
+{id:"formatting.bold",label:"Bold",description:"Apply bold formatting",shortcuts:["Cmd+B"]},{id:"formatting.italic",label:"Italic",description:"Apply italic formatting",shortcuts:["Cmd+I"]},{id:"formatting.underline",label:"Underline",description:"Apply underline formatting",shortcuts:["Cmd+U"]},{id:"formatting.strikethrough",label:"Strikethrough",description:"Apply strikethrough formatting"},{id:"formatting.subscript",label:"Subscript",description:"Apply subscript formatting"},{id:"formatting.superscript",label:"Superscript",description:"Apply superscript formatting"},{id:"formatting.clear",label:"Clear Formatting",description:"Remove all formatting"},
+// Insert actions
+{id:"insert.page-break",label:"Page Break",description:"Insert a page break"},{id:"insert.section-break-next-page",label:"Section Break (Next Page)",description:"Insert a section break on next page"},{id:"insert.section-break-continuous",label:"Section Break (Continuous)",description:"Insert a continuous section break"},{id:"insert.column-break",label:"Column Break",description:"Insert a column break"},{id:"insert.image",label:"Image",description:"Insert an image"},{id:"insert.link",label:"Link",description:"Insert a hyperlink",shortcuts:["Cmd+K"]},
+// Table actions
+{id:"table.insert",label:"Insert Table",description:"Insert a new table"},{id:"table.delete",label:"Delete Table",description:"Delete the current table"},{id:"table.insert-row-above",label:"Insert Row Above",description:"Insert a row above current row"},{id:"table.insert-row-below",label:"Insert Row Below",description:"Insert a row below current row"},{id:"table.insert-column-left",label:"Insert Column Left",description:"Insert a column to the left"},{id:"table.insert-column-right",label:"Insert Column Right",description:"Insert a column to the right"},{id:"table.delete-row",label:"Delete Row",description:"Delete the current row"},{id:"table.delete-column",label:"Delete Column",description:"Delete the current column"},{id:"table.merge-cells",label:"Merge Cells",description:"Merge selected cells"},{id:"table.split-cells",label:"Split Cells",description:"Split merged cells"},
+// View actions
+{id:"view.zoom-in",label:"Zoom In",description:"Increase zoom level",shortcuts:["Cmd+="]},{id:"view.zoom-out",label:"Zoom Out",description:"Decrease zoom level",shortcuts:["Cmd+-"]},{id:"view.zoom-reset",label:"Reset Zoom",description:"Reset zoom to 100%",shortcuts:["Cmd+0"]},{id:"view.toggle-ruler",label:"Toggle Ruler",description:"Show or hide the ruler"},{id:"view.toggle-formatting-marks",label:"Toggle Formatting Marks",description:"Show or hide formatting marks"},
+// Layout actions
+{id:"layout.align-left",label:"Align Left",description:"Align text to the left",shortcuts:["Cmd+Shift+L"]},{id:"layout.align-center",label:"Align Center",description:"Center align text",shortcuts:["Cmd+Shift+E"]},{id:"layout.align-right",label:"Align Right",description:"Align text to the right",shortcuts:["Cmd+Shift+R"]},{id:"layout.align-justify",label:"Justify",description:"Justify text",shortcuts:["Cmd+Shift+J"]},{id:"layout.increase-indent",label:"Increase Indent",description:"Increase paragraph indent",shortcuts:["Cmd+]"]},{id:"layout.decrease-indent",label:"Decrease Indent",description:"Decrease paragraph indent",shortcuts:["Cmd+["]},{id:"layout.bulleted-list",label:"Bulleted List",description:"Create a bulleted list"},{id:"layout.numbered-list",label:"Numbered List",description:"Create a numbered list"},
+// 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"},{type:"built-in",id:"undo-btn",builtInType:"undo"},{type:"built-in",id:"redo-btn",builtInType:"redo"},{type:"separator",id:"sep-after-undo-redo"},{type:"built-in",id:"style-menu",builtInType:"style-menu"},{type:"separator",id:"sep-after-style"},{type:"built-in",id:"font-family-select",builtInType:"font-family"},{type:"built-in",id:"font-size-input",builtInType:"font-size"},{type:"separator",id:"sep-after-font"},{type:"built-in",id:"bold-btn",builtInType:"bold"},{type:"built-in",id:"italic-btn",builtInType:"italic"},{type:"built-in",id:"underline-btn",builtInType:"underline"},{type:"built-in",id:"strikethrough-btn",builtInType:"strikethrough"},{type:"built-in",id:"subscript-btn",builtInType:"subscript"},{type:"built-in",id:"superscript-btn",builtInType:"superscript"},{type:"separator",id:"sep-after-character-formatting"},{type:"built-in",id:"text-color-picker",builtInType:"text-color"},{type:"built-in",id:"highlight-color-picker",builtInType:"highlight-color"},{type:"separator",id:"sep-after-colors"},{type:"built-in",id:"align-left-btn",builtInType:"align-left"},{type:"built-in",id:"align-center-btn",builtInType:"align-center"},{type:"built-in",id:"align-right-btn",builtInType:"align-right"},{type:"built-in",id:"align-justify-btn",builtInType:"align-justify"},{type:"separator",id:"sep-after-alignment"},{type:"built-in",id:"line-spacing-menu",builtInType:"line-spacing-menu"},{type:"separator",id:"sep-after-line-spacing"},{type:"built-in",id:"bulleted-list",builtInType:"bulleted-list"},{type:"built-in",id:"numbered-list",builtInType:"numbered-list"},{type:"separator",id:"sep-after-lists"},{type:"built-in",id:"decrease-indent-btn",builtInType:"decrease-indent"},{type:"built-in",id:"increase-indent-btn",builtInType:"increase-indent"},{type:"separator",id:"sep-after-indentation"},{type:"built-in",id:"clear-formatting-btn",builtInType:"clear-formatting"},{type:"built-in",id:"formatting-marks-btn",builtInType:"formatting-marks"},{type:"separator",id:"sep-after-formatting-marks"},{type:"built-in",id:"page-setup-menu",builtInType:"page-setup-menu"},{type:"separator",id:"sep-after-page-setup"},{type:"built-in",id:"insert-menu",builtInType:"insert-menu"},{type:"separator",id:"sep-after-insert"},{type:"built-in",id:"table-menu",builtInType:"table-menu"},{type:"separator",id:"sep-after-table"},{type:"built-in",id:"download-menu",builtInType:"download-menu"},{type:"separator",id:"sep-before-ui-settings"},{type:"built-in",id:"ui-settings-menu",builtInType:"ui-settings-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-ui-settings"}]};
+// ../packages/ui/src/actions/default-actions-standalone.ts
+const i={type:"default-index"},n=async e=>(await(async e=>{const t=new URL(e??"https://document-authoring.cdn.staging.nutrient.io/2025/1/",window.location.href).href,i=new URL("docauth-impl-4fcda3e4741df97d.js",t).href;return import(
 /*webpackIgnore: true*/
 /* @vite-ignore */
-a)})(t?.assets?.base)).createDocAuthSystem(t);var a={createDocAuthSystem:e,defaultFontIndex:t};export{e as createDocAuthSystem,a as default,t as defaultFontIndex};
+i)})(e?.assets?.base)).createDocAuthSystem(e);var l={createDocAuthSystem:n,defaultFontIndex:i,defaultActions:e,defaultToolbarConfig:t};export{n as createDocAuthSystem,l as default,e as defaultActions,i as defaultFontIndex,t as defaultToolbarConfig};

package/lib/docauth.umd.js

@@ -1,4 +1,20 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).DocAuth={})}(this,(function(e){"use strict";const t={type:"default-index"},n=async e=>(await(async e=>{const t=new URL(e??"https://document-authoring.cdn.staging.nutrient.io/2025/1/",window.location.href).href,n=new URL("docauth-impl-65d42ac8c14d0231.js",t).href;return import(
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).DocAuth={})}(this,(function(e){"use strict";var t=[
+// Document actions
+{id:"document.undo",label:"Undo",description:"Undo the last action",shortcuts:["Cmd+Z"]},{id:"document.redo",label:"Redo",description:"Redo the last undone action",shortcuts:["Cmd+Y","Cmd+Shift+Z"]},{id:"document.export-pdf",label:"Download PDF",description:"Export document as PDF"},{id:"document.export-docx",label:"Download DOCX",description:"Export document as DOCX"},
+// Formatting actions
+{id:"formatting.bold",label:"Bold",description:"Apply bold formatting",shortcuts:["Cmd+B"]},{id:"formatting.italic",label:"Italic",description:"Apply italic formatting",shortcuts:["Cmd+I"]},{id:"formatting.underline",label:"Underline",description:"Apply underline formatting",shortcuts:["Cmd+U"]},{id:"formatting.strikethrough",label:"Strikethrough",description:"Apply strikethrough formatting"},{id:"formatting.subscript",label:"Subscript",description:"Apply subscript formatting"},{id:"formatting.superscript",label:"Superscript",description:"Apply superscript formatting"},{id:"formatting.clear",label:"Clear Formatting",description:"Remove all formatting"},
+// Insert actions
+{id:"insert.page-break",label:"Page Break",description:"Insert a page break"},{id:"insert.section-break-next-page",label:"Section Break (Next Page)",description:"Insert a section break on next page"},{id:"insert.section-break-continuous",label:"Section Break (Continuous)",description:"Insert a continuous section break"},{id:"insert.column-break",label:"Column Break",description:"Insert a column break"},{id:"insert.image",label:"Image",description:"Insert an image"},{id:"insert.link",label:"Link",description:"Insert a hyperlink",shortcuts:["Cmd+K"]},
+// Table actions
+{id:"table.insert",label:"Insert Table",description:"Insert a new table"},{id:"table.delete",label:"Delete Table",description:"Delete the current table"},{id:"table.insert-row-above",label:"Insert Row Above",description:"Insert a row above current row"},{id:"table.insert-row-below",label:"Insert Row Below",description:"Insert a row below current row"},{id:"table.insert-column-left",label:"Insert Column Left",description:"Insert a column to the left"},{id:"table.insert-column-right",label:"Insert Column Right",description:"Insert a column to the right"},{id:"table.delete-row",label:"Delete Row",description:"Delete the current row"},{id:"table.delete-column",label:"Delete Column",description:"Delete the current column"},{id:"table.merge-cells",label:"Merge Cells",description:"Merge selected cells"},{id:"table.split-cells",label:"Split Cells",description:"Split merged cells"},
+// View actions
+{id:"view.zoom-in",label:"Zoom In",description:"Increase zoom level",shortcuts:["Cmd+="]},{id:"view.zoom-out",label:"Zoom Out",description:"Decrease zoom level",shortcuts:["Cmd+-"]},{id:"view.zoom-reset",label:"Reset Zoom",description:"Reset zoom to 100%",shortcuts:["Cmd+0"]},{id:"view.toggle-ruler",label:"Toggle Ruler",description:"Show or hide the ruler"},{id:"view.toggle-formatting-marks",label:"Toggle Formatting Marks",description:"Show or hide formatting marks"},
+// Layout actions
+{id:"layout.align-left",label:"Align Left",description:"Align text to the left",shortcuts:["Cmd+Shift+L"]},{id:"layout.align-center",label:"Align Center",description:"Center align text",shortcuts:["Cmd+Shift+E"]},{id:"layout.align-right",label:"Align Right",description:"Align text to the right",shortcuts:["Cmd+Shift+R"]},{id:"layout.align-justify",label:"Justify",description:"Justify text",shortcuts:["Cmd+Shift+J"]},{id:"layout.increase-indent",label:"Increase Indent",description:"Increase paragraph indent",shortcuts:["Cmd+]"]},{id:"layout.decrease-indent",label:"Decrease Indent",description:"Decrease paragraph indent",shortcuts:["Cmd+["]},{id:"layout.bulleted-list",label:"Bulleted List",description:"Create a bulleted list"},{id:"layout.numbered-list",label:"Numbered List",description:"Create a numbered list"},
+// 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"},{type:"built-in",id:"undo-btn",builtInType:"undo"},{type:"built-in",id:"redo-btn",builtInType:"redo"},{type:"separator",id:"sep-after-undo-redo"},{type:"built-in",id:"style-menu",builtInType:"style-menu"},{type:"separator",id:"sep-after-style"},{type:"built-in",id:"font-family-select",builtInType:"font-family"},{type:"built-in",id:"font-size-input",builtInType:"font-size"},{type:"separator",id:"sep-after-font"},{type:"built-in",id:"bold-btn",builtInType:"bold"},{type:"built-in",id:"italic-btn",builtInType:"italic"},{type:"built-in",id:"underline-btn",builtInType:"underline"},{type:"built-in",id:"strikethrough-btn",builtInType:"strikethrough"},{type:"built-in",id:"subscript-btn",builtInType:"subscript"},{type:"built-in",id:"superscript-btn",builtInType:"superscript"},{type:"separator",id:"sep-after-character-formatting"},{type:"built-in",id:"text-color-picker",builtInType:"text-color"},{type:"built-in",id:"highlight-color-picker",builtInType:"highlight-color"},{type:"separator",id:"sep-after-colors"},{type:"built-in",id:"align-left-btn",builtInType:"align-left"},{type:"built-in",id:"align-center-btn",builtInType:"align-center"},{type:"built-in",id:"align-right-btn",builtInType:"align-right"},{type:"built-in",id:"align-justify-btn",builtInType:"align-justify"},{type:"separator",id:"sep-after-alignment"},{type:"built-in",id:"line-spacing-menu",builtInType:"line-spacing-menu"},{type:"separator",id:"sep-after-line-spacing"},{type:"built-in",id:"bulleted-list",builtInType:"bulleted-list"},{type:"built-in",id:"numbered-list",builtInType:"numbered-list"},{type:"separator",id:"sep-after-lists"},{type:"built-in",id:"decrease-indent-btn",builtInType:"decrease-indent"},{type:"built-in",id:"increase-indent-btn",builtInType:"increase-indent"},{type:"separator",id:"sep-after-indentation"},{type:"built-in",id:"clear-formatting-btn",builtInType:"clear-formatting"},{type:"built-in",id:"formatting-marks-btn",builtInType:"formatting-marks"},{type:"separator",id:"sep-after-formatting-marks"},{type:"built-in",id:"page-setup-menu",builtInType:"page-setup-menu"},{type:"separator",id:"sep-after-page-setup"},{type:"built-in",id:"insert-menu",builtInType:"insert-menu"},{type:"separator",id:"sep-after-insert"},{type:"built-in",id:"table-menu",builtInType:"table-menu"},{type:"separator",id:"sep-after-table"},{type:"built-in",id:"download-menu",builtInType:"download-menu"},{type:"separator",id:"sep-before-ui-settings"},{type:"built-in",id:"ui-settings-menu",builtInType:"ui-settings-menu",visible:e=>!e.mobile},{type:"separator",id:"sep-after-ui-settings"}]};
+// ../packages/ui/src/actions/default-actions-standalone.ts
+const n={type:"default-index"},l=async e=>(await(async e=>{const t=new URL(e??"https://document-authoring.cdn.staging.nutrient.io/2025/1/",window.location.href).href,i=new URL("docauth-impl-4fcda3e4741df97d.js",t).href;return import(
 /*webpackIgnore: true*/
 /* @vite-ignore */
-n)})(e?.assets?.base)).createDocAuthSystem(e);var o={createDocAuthSystem:n,defaultFontIndex:t};e.createDocAuthSystem=n,e.default=o,e.defaultFontIndex=t,Object.defineProperty(e,"__esModule",{value:!0})}));
+i)})(e?.assets?.base)).createDocAuthSystem(e);var r={createDocAuthSystem:l,defaultFontIndex:n,defaultActions:t,defaultToolbarConfig:i};e.createDocAuthSystem=l,e.default=r,e.defaultActions=t,e.defaultFontIndex=n,e.defaultToolbarConfig=i,Object.defineProperty(e,"__esModule",{value:!0})}));

package/lib/index.d.cts

@@ -1,3 +1,9 @@
+/**
+ * Action definition that users can register
+ * @public
+ */
+export declare type Action = BuiltInAction | CustomAction;
+
 /**
  * @public
  */
@@ -15,6 +21,42 @@ export declare type Assets = {
  */
 export declare type BlobInput = Promise<Response | Blob | ArrayBuffer> | Response | Blob | ArrayBuffer;
 
+/**
+ * Built-in action - can omit handler, will use default implementation
+ * @public
+ */
+export declare type BuiltInAction = {
+    readonly id: BuiltInActionId;
+    readonly label: string;
+    readonly description?: string;
+    /**
+     * Keyboard shortcuts for the action.
+     * Use "Mod" as the primary modifier key - it will be automatically resolved to:
+     * - "Ctrl" on Windows/Linux
+     * - "⌘" (Command) on Mac
+     *
+     * Examples:
+     * - "Mod+B" becomes "Ctrl+B" on Windows, "⌘B" on Mac
+     * - "Mod+Shift+P" becomes "Ctrl+Shift+P" on Windows, "⌘⇧P" on Mac
+     */
+    readonly shortcuts?: string[];
+    /** Icon as data URI (e.g., data:image/svg+xml;base64,... or data:image/png;base64,...). Only data:image/ URIs are allowed for security. */
+    readonly icon?: string;
+    readonly isEnabled?: () => boolean;
+    readonly order?: number;
+    readonly handler?: (...args: unknown[]) => void | Promise<void>;
+};
+
+/**
+ * Actions API - Type definitions for registering and executing editor actions
+ * @public
+ */
+/**
+ * Built-in action IDs that have default implementations
+ * @public
+ */
+export declare type BuiltInActionId = 'document.undo' | 'document.redo' | 'document.export-pdf' | 'document.export-docx' | 'formatting.bold' | 'formatting.italic' | 'formatting.underline' | 'formatting.strikethrough' | 'formatting.subscript' | 'formatting.superscript' | 'formatting.clear' | 'insert.page-break' | 'insert.section-break-next-page' | 'insert.section-break-continuous' | 'insert.column-break' | 'insert.image' | 'insert.link' | 'table.insert' | 'table.delete' | 'table.insert-row-above' | 'table.insert-row-below' | 'table.insert-column-left' | 'table.insert-column-right' | 'table.delete-row' | 'table.delete-column' | 'table.merge-cells' | 'table.split-cells' | 'view.zoom-in' | 'view.zoom-out' | 'view.zoom-reset' | 'view.toggle-ruler' | 'view.toggle-formatting-marks' | 'layout.align-left' | 'layout.align-center' | 'layout.align-right' | 'layout.align-justify' | 'layout.increase-indent' | 'layout.decrease-indent' | 'layout.bulleted-list' | 'layout.numbered-list' | 'style.apply';
+
 /**
  * Creates an instance of the Document Authoring system which can be shared between different tasks
  * like creating editors, importing Word documents or creating PDFs.
@@ -90,15 +132,83 @@ export declare type CreateEditorOptions = {
     __hidePDFDownload?: boolean;
 };
 
+/**
+ * Custom action - must provide handler
+ * @public
+ */
+export declare type CustomAction = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    /**
+     * Keyboard shortcuts for the action.
+     * Use "Cmd" as the modifier key - it will be resolved to:
+     * - "Ctrl" on Windows/Linux (for keyboard handling)
+     * - "⌘" on Mac (for keyboard handling)
+     * - "Ctrl" or "⌘" for display based on platform
+     *
+     * Examples:
+     * - "Cmd+B" becomes "Ctrl+B" on Windows, "⌘B" on Mac
+     * - "Cmd+Shift+P" becomes "Ctrl+Shift+P" on Windows, "⌘⇧P" on Mac
+     */
+    readonly shortcuts?: string[];
+    /** Icon as data URI (e.g., data:image/svg+xml;base64,... or data:image/png;base64,...). Only data:image/ URIs are allowed for security. */
+    readonly icon?: string;
+    readonly isEnabled?: () => boolean;
+    readonly order?: number;
+    readonly handler: (...args: unknown[]) => void | Promise<void>;
+};
+
 /**
  * @hidden
  */
 declare const _default: {
     createDocAuthSystem: (options?: CreateDocAuthSystemOptions) => Promise<DocAuthSystem>;
     defaultFontIndex: DefaultFontIndex;
+    defaultActions: BuiltInAction[];
+    defaultToolbarConfig: ToolbarConfig;
 };
 export default _default;
 
+/**
+ * Get the default set of actions available in the editor.
+ * Can be combined with custom actions using spread operator.
+ *
+ * Note: Built-in actions (those with IDs from {@link BuiltInActionId}) can omit handlers -
+ * they will be automatically populated with default implementations when passed to
+ * `editor.setActions()`. This allows you to customize labels, shortcuts, and order
+ * without needing to implement the behavior yourself. Built-in handlers can also be
+ * overridden by providing your own handler function.
+ *
+ * Custom actions (those with any other string ID) must provide a handler function.
+ *
+ * @example
+ * ```typescript
+ * import { defaultActions } from '@nutrient-sdk/document-authoring';
+ *
+ * // Customize a built-in action's metadata (handlers auto-populate for built-in actions)
+ * editor.setActions([
+ *   ...defaultActions,
+ *   { id: 'formatting.bold', label: 'Make Bold', shortcuts: ['Ctrl+B'] }
+ * ]);
+ *
+ * // Override a built-in action's behavior
+ * editor.setActions([
+ *   ...defaultActions,
+ *   { id: 'formatting.bold', label: 'Bold', handler: () => console.log('custom bold!') }
+ * ]);
+ *
+ * // Add custom actions (must provide handler)
+ * editor.setActions([
+ *   ...defaultActions.filter(a => a.id !== 'document.export-pdf'),
+ *   { id: 'custom.my-action', label: 'My Action', handler: () => console.log('clicked') }
+ * ]);
+ * ```
+ *
+ * @public
+ */
+export declare const defaultActions: BuiltInAction[];
+
 /**
  * The default font index that is part of the Document Authoring SDK bundle.
  *
@@ -119,6 +229,25 @@ export declare type DefaultFontIndex = {
  */
 export declare const defaultFontIndex: DefaultFontIndex;
 
+/**
+ * Get the default toolbar configuration.
+ * Can be used as-is or customized.
+ *
+ * @example
+ * ```typescript
+ * import { defaultToolbarConfig } from '@nutrient-sdk/document-authoring';
+ *
+ * editor.setToolbarConfig(defaultToolbarConfig);
+ * // or customize:
+ * editor.setToolbarConfig({
+ *   items: [...defaultToolbarConfig.items, myCustomItem]
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare const defaultToolbarConfig: ToolbarConfig;
+
 /**
  * @public
  */
@@ -189,6 +318,15 @@ export declare type DocAuthEditor = {
      * @param text - The text to insert at the cursor position
      */
     insertTextAtCursor(text: string): void;
+    /**
+     * Checks if the editor has an active cursor/insertion point.
+     * This is useful for custom actions to determine if they should be enabled.
+     *
+     * @returns true if cursor is active and insertion is possible, false otherwise
+     *
+     * @internal
+     */
+    hasActiveCursor(): boolean;
     /**
      * Adds an event listener that will be called every time the specified event is emitted.
      *
@@ -242,6 +380,62 @@ export declare type DocAuthEditor = {
      * @eventMap DocAuthEditorEvents
      */
     once: <EventName extends keyof DocAuthEditorEvents>(event: EventName, handler: DocAuthEditorEventHandler<EventName>) => DocAuthEditor;
+    /**
+     * Set all actions (replaces any existing actions).
+     * Allows setting and executing editor actions programmatically.
+     *
+     * @param actions - Array of actions to register
+     *
+     * @example
+     * ```typescript
+     * import { defaultActions } from '@nutrient-sdk/document-authoring';
+     *
+     * // Register custom actions alongside default actions
+     * editor.setActions([
+     *   ...defaultActions, // Keep default actions
+     *   {
+     *     id: 'custom.insert-signature',
+     *     label: 'Insert Signature',
+     *     handler: () => {
+     *       editor.insertTextAtCursor('\n\nBest regards,\nJohn Doe');
+     *     },
+     *     shortcuts: [{ mac: '⌘⇧S', windows: 'Ctrl+Shift+S' }]
+     *   }
+     * ]);
+     * ```
+     *
+     * @public
+     */
+    setActions(actions: Action[]): void;
+    /**
+     * Set the toolbar configuration.
+     * Use this to customize the editor's toolbar.
+     *
+     * @param config - Toolbar configuration object
+     *
+     * @example
+     * ```typescript
+     * import { defaultToolbarConfig } from '@nutrient-sdk/document-authoring';
+     *
+     * // Use default toolbar
+     * editor.setToolbarConfig(defaultToolbarConfig);
+     *
+     * // Or create a minimal toolbar
+     * editor.setToolbarConfig({
+     *   items: [
+     *     { type: 'built-in', id: 'undo', builtInType: 'undo' },
+     *     { type: 'built-in', id: 'redo', builtInType: 'redo' },
+     *     { type: 'separator', id: 'sep-1' },
+     *     { type: 'built-in', id: 'bold', builtInType: 'bold' },
+     *     { type: 'built-in', id: 'italic', builtInType: 'italic' },
+     *     { type: 'action', id: 'custom', actionId: 'custom.insert-signature' }
+     *   ]
+     * });
+     * ```
+     *
+     * @public
+     */
+    setToolbarConfig(config: ToolbarConfig): void;
 };
 
 /**
@@ -601,6 +795,57 @@ export declare namespace Programmatic {
         {};
 }
 
+/**
+ * Toolbar API - Type definitions for customizing the editor toolbar
+ * @public
+ */
+/**
+ * Action toolbar item - references an action by ID
+ * @public
+ */
+export declare type ToolbarActionItem = {
+    type: 'action';
+    id: string;
+    actionId: string;
+};
+
+/**
+ * Built-in toolbar item - uses original toolbar components directly
+ * Self-contained with no external configuration properties
+ * @public
+ */
+export declare type ToolbarBuiltInItem = {
+    type: 'built-in';
+    id: string;
+    builtInType: 'undo' | 'redo' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'subscript' | 'superscript' | 'text-color' | 'highlight-color' | 'align-left' | 'align-center' | 'align-right' | 'align-justify' | 'bulleted-list' | 'numbered-list' | 'decrease-indent' | 'increase-indent' | 'clear-formatting' | 'formatting-marks' | 'zoom' | 'mobile-lock' | 'font-family' | 'font-size' | 'style-menu' | 'line-spacing-menu' | 'page-setup-menu' | 'insert-menu' | 'table-menu' | 'download-menu' | 'ui-settings-menu';
+};
+
+/**
+ * Toolbar configuration
+ * @public
+ */
+export declare type ToolbarConfig = {
+    /**
+     * Array of toolbar items to display
+     */
+    items?: ToolbarItem[];
+};
+
+/**
+ * Union type for all toolbar items
+ * @public
+ */
+export declare type ToolbarItem = ToolbarActionItem | ToolbarBuiltInItem | ToolbarSeparatorItem;
+
+/**
+ * Visual separator
+ * @public
+ */
+export declare type ToolbarSeparatorItem = {
+    type: 'separator';
+    id: string;
+};
+
 /**
  * @alpha
  */
@@ -655,11 +900,41 @@ export declare type UIOptions = {
      *
      * Initial zoom level for the editor.
      *
-     * Valid range is 0.5 to 4.0.
+     * Valid range is 0.5 to 4.0, which any values provided will be clamped to.
      *
      * @defaultValue `1`
      */
     initialZoom?: number;
+    /**
+     * Initial toolbar configuration.
+     *
+     * The toolbar can also be customized at runtime using `editor.setToolbarConfig()`.
+     */
+    toolbar?: ToolbarConfig;
+    /**
+     * Initial actions configuration.
+     *
+     * Actions can also be customized at runtime using `editor.setActions()`.
+     *
+     * @example
+     * ```typescript
+     * import { defaultActions } from '@nutrient-sdk/document-authoring';
+     *
+     * const editor = await system.createEditor(target, {
+     *   ui: {
+     *     actions: [
+     *       ...defaultActions,
+     *       {
+     *         id: 'custom.hello',
+     *         label: 'Say Hello',
+     *         handler: () => alert('Hello!'),
+     *       }
+     *     ]
+     *   }
+     * });
+     * ```
+     */
+    actions?: Action[];
 };
 
 /**

package/lib/index.d.mts

@@ -1,3 +1,9 @@
+/**
+ * Action definition that users can register
+ * @public
+ */
+export declare type Action = BuiltInAction | CustomAction;
+
 /**
  * @public
  */
@@ -15,6 +21,42 @@ export declare type Assets = {
  */
 export declare type BlobInput = Promise<Response | Blob | ArrayBuffer> | Response | Blob | ArrayBuffer;
 
+/**
+ * Built-in action - can omit handler, will use default implementation
+ * @public
+ */
+export declare type BuiltInAction = {
+    readonly id: BuiltInActionId;
+    readonly label: string;
+    readonly description?: string;
+    /**
+     * Keyboard shortcuts for the action.
+     * Use "Mod" as the primary modifier key - it will be automatically resolved to:
+     * - "Ctrl" on Windows/Linux
+     * - "⌘" (Command) on Mac
+     *
+     * Examples:
+     * - "Mod+B" becomes "Ctrl+B" on Windows, "⌘B" on Mac
+     * - "Mod+Shift+P" becomes "Ctrl+Shift+P" on Windows, "⌘⇧P" on Mac
+     */
+    readonly shortcuts?: string[];
+    /** Icon as data URI (e.g., data:image/svg+xml;base64,... or data:image/png;base64,...). Only data:image/ URIs are allowed for security. */
+    readonly icon?: string;
+    readonly isEnabled?: () => boolean;
+    readonly order?: number;
+    readonly handler?: (...args: unknown[]) => void | Promise<void>;
+};
+
+/**
+ * Actions API - Type definitions for registering and executing editor actions
+ * @public
+ */
+/**
+ * Built-in action IDs that have default implementations
+ * @public
+ */
+export declare type BuiltInActionId = 'document.undo' | 'document.redo' | 'document.export-pdf' | 'document.export-docx' | 'formatting.bold' | 'formatting.italic' | 'formatting.underline' | 'formatting.strikethrough' | 'formatting.subscript' | 'formatting.superscript' | 'formatting.clear' | 'insert.page-break' | 'insert.section-break-next-page' | 'insert.section-break-continuous' | 'insert.column-break' | 'insert.image' | 'insert.link' | 'table.insert' | 'table.delete' | 'table.insert-row-above' | 'table.insert-row-below' | 'table.insert-column-left' | 'table.insert-column-right' | 'table.delete-row' | 'table.delete-column' | 'table.merge-cells' | 'table.split-cells' | 'view.zoom-in' | 'view.zoom-out' | 'view.zoom-reset' | 'view.toggle-ruler' | 'view.toggle-formatting-marks' | 'layout.align-left' | 'layout.align-center' | 'layout.align-right' | 'layout.align-justify' | 'layout.increase-indent' | 'layout.decrease-indent' | 'layout.bulleted-list' | 'layout.numbered-list' | 'style.apply';
+
 /**
  * Creates an instance of the Document Authoring system which can be shared between different tasks
  * like creating editors, importing Word documents or creating PDFs.
@@ -90,15 +132,83 @@ export declare type CreateEditorOptions = {
     __hidePDFDownload?: boolean;
 };
 
+/**
+ * Custom action - must provide handler
+ * @public
+ */
+export declare type CustomAction = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    /**
+     * Keyboard shortcuts for the action.
+     * Use "Cmd" as the modifier key - it will be resolved to:
+     * - "Ctrl" on Windows/Linux (for keyboard handling)
+     * - "⌘" on Mac (for keyboard handling)
+     * - "Ctrl" or "⌘" for display based on platform
+     *
+     * Examples:
+     * - "Cmd+B" becomes "Ctrl+B" on Windows, "⌘B" on Mac
+     * - "Cmd+Shift+P" becomes "Ctrl+Shift+P" on Windows, "⌘⇧P" on Mac
+     */
+    readonly shortcuts?: string[];
+    /** Icon as data URI (e.g., data:image/svg+xml;base64,... or data:image/png;base64,...). Only data:image/ URIs are allowed for security. */
+    readonly icon?: string;
+    readonly isEnabled?: () => boolean;
+    readonly order?: number;
+    readonly handler: (...args: unknown[]) => void | Promise<void>;
+};
+
 /**
  * @hidden
  */
 declare const _default: {
     createDocAuthSystem: (options?: CreateDocAuthSystemOptions) => Promise<DocAuthSystem>;
     defaultFontIndex: DefaultFontIndex;
+    defaultActions: BuiltInAction[];
+    defaultToolbarConfig: ToolbarConfig;
 };
 export default _default;
 
+/**
+ * Get the default set of actions available in the editor.
+ * Can be combined with custom actions using spread operator.
+ *
+ * Note: Built-in actions (those with IDs from {@link BuiltInActionId}) can omit handlers -
+ * they will be automatically populated with default implementations when passed to
+ * `editor.setActions()`. This allows you to customize labels, shortcuts, and order
+ * without needing to implement the behavior yourself. Built-in handlers can also be
+ * overridden by providing your own handler function.
+ *
+ * Custom actions (those with any other string ID) must provide a handler function.
+ *
+ * @example
+ * ```typescript
+ * import { defaultActions } from '@nutrient-sdk/document-authoring';
+ *
+ * // Customize a built-in action's metadata (handlers auto-populate for built-in actions)
+ * editor.setActions([
+ *   ...defaultActions,
+ *   { id: 'formatting.bold', label: 'Make Bold', shortcuts: ['Ctrl+B'] }
+ * ]);
+ *
+ * // Override a built-in action's behavior
+ * editor.setActions([
+ *   ...defaultActions,
+ *   { id: 'formatting.bold', label: 'Bold', handler: () => console.log('custom bold!') }
+ * ]);
+ *
+ * // Add custom actions (must provide handler)
+ * editor.setActions([
+ *   ...defaultActions.filter(a => a.id !== 'document.export-pdf'),
+ *   { id: 'custom.my-action', label: 'My Action', handler: () => console.log('clicked') }
+ * ]);
+ * ```
+ *
+ * @public
+ */
+export declare const defaultActions: BuiltInAction[];
+
 /**
  * The default font index that is part of the Document Authoring SDK bundle.
  *
@@ -119,6 +229,25 @@ export declare type DefaultFontIndex = {
  */
 export declare const defaultFontIndex: DefaultFontIndex;
 
+/**
+ * Get the default toolbar configuration.
+ * Can be used as-is or customized.
+ *
+ * @example
+ * ```typescript
+ * import { defaultToolbarConfig } from '@nutrient-sdk/document-authoring';
+ *
+ * editor.setToolbarConfig(defaultToolbarConfig);
+ * // or customize:
+ * editor.setToolbarConfig({
+ *   items: [...defaultToolbarConfig.items, myCustomItem]
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare const defaultToolbarConfig: ToolbarConfig;
+
 /**
  * @public
  */
@@ -189,6 +318,15 @@ export declare type DocAuthEditor = {
      * @param text - The text to insert at the cursor position
      */
     insertTextAtCursor(text: string): void;
+    /**
+     * Checks if the editor has an active cursor/insertion point.
+     * This is useful for custom actions to determine if they should be enabled.
+     *
+     * @returns true if cursor is active and insertion is possible, false otherwise
+     *
+     * @internal
+     */
+    hasActiveCursor(): boolean;
     /**
      * Adds an event listener that will be called every time the specified event is emitted.
      *
@@ -242,6 +380,62 @@ export declare type DocAuthEditor = {
      * @eventMap DocAuthEditorEvents
      */
     once: <EventName extends keyof DocAuthEditorEvents>(event: EventName, handler: DocAuthEditorEventHandler<EventName>) => DocAuthEditor;
+    /**
+     * Set all actions (replaces any existing actions).
+     * Allows setting and executing editor actions programmatically.
+     *
+     * @param actions - Array of actions to register
+     *
+     * @example
+     * ```typescript
+     * import { defaultActions } from '@nutrient-sdk/document-authoring';
+     *
+     * // Register custom actions alongside default actions
+     * editor.setActions([
+     *   ...defaultActions, // Keep default actions
+     *   {
+     *     id: 'custom.insert-signature',
+     *     label: 'Insert Signature',
+     *     handler: () => {
+     *       editor.insertTextAtCursor('\n\nBest regards,\nJohn Doe');
+     *     },
+     *     shortcuts: [{ mac: '⌘⇧S', windows: 'Ctrl+Shift+S' }]
+     *   }
+     * ]);
+     * ```
+     *
+     * @public
+     */
+    setActions(actions: Action[]): void;
+    /**
+     * Set the toolbar configuration.
+     * Use this to customize the editor's toolbar.
+     *
+     * @param config - Toolbar configuration object
+     *
+     * @example
+     * ```typescript
+     * import { defaultToolbarConfig } from '@nutrient-sdk/document-authoring';
+     *
+     * // Use default toolbar
+     * editor.setToolbarConfig(defaultToolbarConfig);
+     *
+     * // Or create a minimal toolbar
+     * editor.setToolbarConfig({
+     *   items: [
+     *     { type: 'built-in', id: 'undo', builtInType: 'undo' },
+     *     { type: 'built-in', id: 'redo', builtInType: 'redo' },
+     *     { type: 'separator', id: 'sep-1' },
+     *     { type: 'built-in', id: 'bold', builtInType: 'bold' },
+     *     { type: 'built-in', id: 'italic', builtInType: 'italic' },
+     *     { type: 'action', id: 'custom', actionId: 'custom.insert-signature' }
+     *   ]
+     * });
+     * ```
+     *
+     * @public
+     */
+    setToolbarConfig(config: ToolbarConfig): void;
 };
 
 /**
@@ -601,6 +795,57 @@ export declare namespace Programmatic {
         {};
 }
 
+/**
+ * Toolbar API - Type definitions for customizing the editor toolbar
+ * @public
+ */
+/**
+ * Action toolbar item - references an action by ID
+ * @public
+ */
+export declare type ToolbarActionItem = {
+    type: 'action';
+    id: string;
+    actionId: string;
+};
+
+/**
+ * Built-in toolbar item - uses original toolbar components directly
+ * Self-contained with no external configuration properties
+ * @public
+ */
+export declare type ToolbarBuiltInItem = {
+    type: 'built-in';
+    id: string;
+    builtInType: 'undo' | 'redo' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'subscript' | 'superscript' | 'text-color' | 'highlight-color' | 'align-left' | 'align-center' | 'align-right' | 'align-justify' | 'bulleted-list' | 'numbered-list' | 'decrease-indent' | 'increase-indent' | 'clear-formatting' | 'formatting-marks' | 'zoom' | 'mobile-lock' | 'font-family' | 'font-size' | 'style-menu' | 'line-spacing-menu' | 'page-setup-menu' | 'insert-menu' | 'table-menu' | 'download-menu' | 'ui-settings-menu';
+};
+
+/**
+ * Toolbar configuration
+ * @public
+ */
+export declare type ToolbarConfig = {
+    /**
+     * Array of toolbar items to display
+     */
+    items?: ToolbarItem[];
+};
+
+/**
+ * Union type for all toolbar items
+ * @public
+ */
+export declare type ToolbarItem = ToolbarActionItem | ToolbarBuiltInItem | ToolbarSeparatorItem;
+
+/**
+ * Visual separator
+ * @public
+ */
+export declare type ToolbarSeparatorItem = {
+    type: 'separator';
+    id: string;
+};
+
 /**
  * @alpha
  */
@@ -655,11 +900,41 @@ export declare type UIOptions = {
      *
      * Initial zoom level for the editor.
      *
-     * Valid range is 0.5 to 4.0.
+     * Valid range is 0.5 to 4.0, which any values provided will be clamped to.
      *
      * @defaultValue `1`
      */
     initialZoom?: number;
+    /**
+     * Initial toolbar configuration.
+     *
+     * The toolbar can also be customized at runtime using `editor.setToolbarConfig()`.
+     */
+    toolbar?: ToolbarConfig;
+    /**
+     * Initial actions configuration.
+     *
+     * Actions can also be customized at runtime using `editor.setActions()`.
+     *
+     * @example
+     * ```typescript
+     * import { defaultActions } from '@nutrient-sdk/document-authoring';
+     *
+     * const editor = await system.createEditor(target, {
+     *   ui: {
+     *     actions: [
+     *       ...defaultActions,
+     *       {
+     *         id: 'custom.hello',
+     *         label: 'Say Hello',
+     *         handler: () => alert('Hello!'),
+     *       }
+     *     ]
+     *   }
+     * });
+     * ```
+     */
+    actions?: Action[];
 };
 
 /**

package/package.json

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