@docx-editor.dev/core 2.31.0 → 2.33.0

package/README.md

@@ -30,7 +30,7 @@ Node.js requires `^20.16.0 || >=22.3.0`.
 ## Features
 
 - [Read and save DOCX files](https://www.docx-editor.dev/docs/2.x/guides/loading-and-saving).
-- [Lay out and render document pages](https://www.docx-editor.dev/docs/2.x/word-fidelity).
+- [Lay out and render document pages](https://www.docx-editor.dev/docs/2.x/word-fidelity). Charts, SmartArt saved without its drawing, shape effects, and WordArt need [`@docx-editor.dev/pro/drawing`](https://www.docx-editor.dev/docs/2.x/pro/drawing).
 - [Build an editor with shared commands and controls](https://www.docx-editor.dev/docs/2.x/guides/chrome-slots).
 - [Configure fonts for text measurement](https://www.docx-editor.dev/docs/2.x/guides/fonts).
 
@@ -114,6 +114,30 @@ Treat DOCX files as untrusted input. The engine validates URLs and limits XML en
 
 Anything you render from document data (a font name, a hyperlink target, a comment body) is still attacker-controlled at your boundary. Render it as text; do not build markup or URLs from it.
 
+## Which API for which job
+
+| Job | Use |
+| --- | --- |
+| Build a review UI in the browser | The React or Vue adapter hooks, plus the review hooks and `DocxEditorReview` from `@docx-editor.dev/pro/react` or `@docx-editor.dev/pro/vue`. |
+| Edit in a headless, server, or agent pipeline | The editing API in `@docx-editor.dev/editor-api`, which follows the Office.js object model. |
+
+| Task | Browser host (React or Vue) | Headless, server, or agent |
+| --- | --- | --- |
+| [Comment on found text](https://www.docx-editor.dev/docs/2.x/recipes/comment-on-found-text) | `editor.findMatches`, `editor.selectMatch`, then `useReview().comment` | `body.search`, then `Range.insertComment` |
+| Reply to a thread | `useReview().reply(item, text)` | `Comment.reply(text)` |
+| [Record a tracked replacement](https://www.docx-editor.dev/docs/2.x/recipes/tracked-replacement) | Suggesting mode, then `editor.exec({ type: 'replaceMatch', match, text })` | `document.changeTrackingMode = 'TrackMineOnly'`, then `Range.insertText(text, 'Replace')` |
+| [Propose an AI rewrite as tracked changes](https://www.docx-editor.dev/docs/2.x/recipes/propose-rewrite) | The same code through `DocxEditor.createBrowser` from `@docx-editor.dev/editor-api/browser` | `prepareRewrite` from `@docx-editor.dev/editor-api/agent` |
+| [Accept or reject a change](https://www.docx-editor.dev/docs/2.x/recipes/accept-reject-without-scrolling) | `useReview().accept(item)` or `useReview().reject(item)` | `Revision.accept()` or `Revision.reject()` |
+| [Open or reveal a change without scrolling](https://www.docx-editor.dev/docs/2.x/recipes/accept-reject-without-scrolling) | `useReview().setActive(key, { reveal: false })` | Not applicable: no viewport |
+| [Highlight ranges](https://www.docx-editor.dev/docs/2.x/recipes/highlight-ranges) | `useHighlights(name, source, options)` | Not applicable |
+| [Custom review rail cards](https://www.docx-editor.dev/docs/2.x/recipes/custom-review-cards) | `DocxEditorReview` with `preset` set to `false`, `useReview().items`, `useStackedReviewPositions`, and `useReviewRailMetrics` | Not applicable |
+| Comment-on-selection button | `DocxEditorReview.AddComment` as a direct child of `DocxEditorReview`, or `useEditorCommand('review.addComment')` | Not applicable |
+| Page setup and paragraph dialogs from a custom toolbar | `DocxEditor.PageSetupDialog` or `DocxEditor.ParagraphDialog` with `open` and a close handler (`onClose` in React, `@close` in Vue); enable the button from `usePageSetup().isEnabled` or `useParagraphFormat().isEnabled` | `Section.pageSetup`, and `Paragraph` properties such as `alignment` |
+
+The review hooks need `reviewModule()` from `@docx-editor.dev/pro` in the editor's modules, and an editor `author` for comments and tracked changes. The editing API takes its author from the `author` option of `DocxEditor.createServer`, imported from `@docx-editor.dev/editor-api`, or of `DocxEditor.createBrowser`, imported from `@docx-editor.dev/editor-api/browser`.
+
+This package ships the task recipes in [`docs/index.md`](./docs/index.md). They are also on the site: [Task recipes](https://www.docx-editor.dev/docs/2.x/recipes).
+
 ## Documentation
 
 - [Core overview](https://www.docx-editor.dev/docs/2.x/core)

package/THIRD_PARTY_NOTICES.md

@@ -19,6 +19,7 @@ This package also ships prebuilt third-party assets that are not esbuild inputs,
 so they cannot appear below. Their licenses travel with the package in
 `licenses/`:
 
+- `licenses/ECMA-376.md`
 - `licenses/HarfBuzz-COPYING.txt`
 
 ## Bundled packages

package/dist/automation.cjs

@@ -1 +1 @@
-'use strict';var chunkYQWMI6J5_cjs=require('./chunk-YQWMI6J5.cjs');require('./chunk-HC6YNKUI.cjs'),require('./chunk-DBOOTED4.cjs'),require('./chunk-5SO5QDMV.cjs'),require('./chunk-IBRBNT37.cjs'),require('./chunk-243W4WW2.cjs'),require('./chunk-6IDOVU6L.cjs'),require('./chunk-WO4V6PNS.cjs');Object.defineProperty(exports,"AUTOMATION_COMMAND_OPERATIONS",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.e}});Object.defineProperty(exports,"AUTOMATION_QUERY_OPERATIONS",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.d}});Object.defineProperty(exports,"AUTOMATION_SOLITARY_OPERATIONS",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.f}});Object.defineProperty(exports,"HEADER_FOOTER_VARIANTS",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.c}});Object.defineProperty(exports,"SERVER_AUTOMATION_CAPABILITIES",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.n}});Object.defineProperty(exports,"byteSizeBucket",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.v}});Object.defineProperty(exports,"countBucket",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.w}});Object.defineProperty(exports,"createAutomationPaginationProvider",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.l}});Object.defineProperty(exports,"createDiagnosticEmitter",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.x}});Object.defineProperty(exports,"createServerAutomationHost",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.o}});Object.defineProperty(exports,"diagnosticCause",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.z}});Object.defineProperty(exports,"diagnosticCauses",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.y}});Object.defineProperty(exports,"diagnosticCodes",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.r}});Object.defineProperty(exports,"diagnosticErrorName",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.B}});Object.defineProperty(exports,"documentPartKind",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.C}});Object.defineProperty(exports,"exceptionCause",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.A}});Object.defineProperty(exports,"explainDiagnostic",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.q}});Object.defineProperty(exports,"isAutomationCommand",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.h}});Object.defineProperty(exports,"isSolitaryAutomationCommand",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.g}});Object.defineProperty(exports,"openDiagnosticCode",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.s}});Object.defineProperty(exports,"paginationSnapshotOf",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.j}});Object.defineProperty(exports,"reviewDiagnosticCode",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.u}});Object.defineProperty(exports,"storeEditDiagnosticCode",{enumerable:true,get:function(){return chunkYQWMI6J5_cjs.t}});
+'use strict';var chunkZWO4JHNN_cjs=require('./chunk-ZWO4JHNN.cjs');require('./chunk-AXU63LYW.cjs'),require('./chunk-2DEY5NUC.cjs'),require('./chunk-PXMTQ73F.cjs'),require('./chunk-RFUNFTGV.cjs'),require('./chunk-DYUVJNDD.cjs'),require('./chunk-ZDFJW5XS.cjs'),require('./chunk-X34QRAUU.cjs'),require('./chunk-KE6ZWRIY.cjs');Object.defineProperty(exports,"AUTOMATION_COMMAND_OPERATIONS",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.g}});Object.defineProperty(exports,"AUTOMATION_QUERY_OPERATIONS",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.f}});Object.defineProperty(exports,"AUTOMATION_SOLITARY_OPERATIONS",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.h}});Object.defineProperty(exports,"HEADER_FOOTER_VARIANTS",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.e}});Object.defineProperty(exports,"SERVER_AUTOMATION_CAPABILITIES",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.p}});Object.defineProperty(exports,"byteSizeBucket",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.y}});Object.defineProperty(exports,"countBucket",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.z}});Object.defineProperty(exports,"createAutomationPaginationProvider",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.n}});Object.defineProperty(exports,"createDiagnosticEmitter",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.A}});Object.defineProperty(exports,"createServerAutomationHost",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.q}});Object.defineProperty(exports,"diagnosticCause",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.C}});Object.defineProperty(exports,"diagnosticCauses",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.B}});Object.defineProperty(exports,"diagnosticCodes",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.t}});Object.defineProperty(exports,"diagnosticErrorName",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.F}});Object.defineProperty(exports,"documentPartKind",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.G}});Object.defineProperty(exports,"exceptionCause",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.E}});Object.defineProperty(exports,"explainDiagnostic",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.s}});Object.defineProperty(exports,"isAutomationCommand",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.j}});Object.defineProperty(exports,"isSolitaryAutomationCommand",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.i}});Object.defineProperty(exports,"openDiagnosticCode",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.u}});Object.defineProperty(exports,"paginationSnapshotOf",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.l}});Object.defineProperty(exports,"reviewCodeOfSkip",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.w}});Object.defineProperty(exports,"reviewDiagnosticCode",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.x}});Object.defineProperty(exports,"reviewSkipOfReason",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.D}});Object.defineProperty(exports,"storeEditDiagnosticCode",{enumerable:true,get:function(){return chunkZWO4JHNN_cjs.v}});

package/dist/automation.d.ts

@@ -11,21 +11,20 @@
  * @packageDocumentation
  * @public
  */
-import { A as AutomationOperation, a as AutomationCapabilities, b as AutomationHost } from './protocol-COZJUKUY.js';
-export { c as AutomationAlignment, d as AutomationBatchRequest, e as AutomationBatchResponse, f as AutomationChangeEvent, g as AutomationContentControlLock, h as AutomationContentControlRangeLocation, i as AutomationContentControlScope, j as AutomationContentControlSubtype, k as AutomationContentControlValue, l as AutomationError, m as AutomationErrorCode, n as AutomationFontRead, o as AutomationFontWrite, p as AutomationHandle, q as AutomationHandleRef, r as AutomationObjectKind, s as AutomationOperationKind, t as AutomationOperationResult, u as AutomationPageOrientation, v as AutomationPageSetupRead, w as AutomationPageSetupWrite, x as AutomationParagraphFormatRead, y as AutomationParagraphFormatWrite, z as AutomationParagraphRef, B as AutomationPoint, C as AutomationReadingOrder, D as AutomationSaveResult, E as AutomationSearchOptions, F as AutomationSelectionMode, G as AutomationSpan, H as AutomationSpanRef, I as AutomationTextProjection, J as AutomationUnsubscribe, K as AutomationValue } from './protocol-COZJUKUY.js';
-import { c as HeaderFooterVariant, N as NoteKind, C as ContentLockPolicy } from './tree-package-store-B8l8DX3Z.js';
-import { T as TextMeasurer, S as SemanticLayout } from './semantic-records-B-akgRch.js';
-import { H as HeadlessDocumentView } from './headless-document-view-qOpaCF82.js';
-import { av as OoxmlPackageLimits, as as OoxmlPackageRejection } from './types-barrel-CkF2JbU4.js';
-export { aw as RevisionAuthorEntry, ab as RevisionAuthorResult, ax as RevisionAuthorSkipReason, ay as RevisionBatchEntry, ac as RevisionBatchResult, az as RevisionBatchSkipDetail, aA as RevisionBatchSkipReason, aB as RevisionSiteRefusal } from './types-barrel-CkF2JbU4.js';
+import { A as AutomationOperation, a as AutomationCapabilities, b as AutomationHost } from './protocol-Cp_QzVxS.js';
+export { c as AutomationAlignment, d as AutomationAuthoringOperation, e as AutomationBatchRequest, f as AutomationBatchResponse, g as AutomationChangeEvent, h as AutomationContentControlLock, i as AutomationContentControlRangeLocation, j as AutomationContentControlScope, k as AutomationContentControlSubtype, l as AutomationContentControlValue, m as AutomationCustomNodePayload, n as AutomationEndpoint, o as AutomationError, p as AutomationErrorCode, q as AutomationFontRead, r as AutomationFontWrite, s as AutomationHandle, t as AutomationHandleRef, u as AutomationInlinePictureRead, v as AutomationInlinePictureWrite, w as AutomationListBullet, x as AutomationListLevelFormat, y as AutomationListNumbering, z as AutomationObjectKind, B as AutomationOperationKind, C as AutomationOperationResult, D as AutomationPageOrientation, E as AutomationPageSetupRead, F as AutomationPageSetupWrite, G as AutomationParagraphFormatRead, H as AutomationParagraphFormatWrite, I as AutomationParagraphRef, J as AutomationPoint, K as AutomationReadingOrder, L as AutomationSaveResult, M as AutomationSearchOptions, N as AutomationSelectionMode, O as AutomationShapeRead, P as AutomationShapeType, Q as AutomationSpan, R as AutomationSpanRef, S as AutomationTextProjection, T as AutomationUnsubscribe, U as AutomationValue } from './protocol-Cp_QzVxS.js';
+import { H as HeaderFooterVariant, N as NoteKind, C as ContentLockPolicy } from './tree-package-store-DXhX1PE-.js';
+import { az as OoxmlPackageLimits, aA as OoxmlPackageRejection } from './tree-op-types-Df4oY2u4.js';
+export { aB as AutomationTableMutation, J as RevisionAuthorEntry, K as RevisionAuthorResult, L as RevisionAuthorSkipReason, M as RevisionBatchEntry, Q as RevisionBatchResult, T as RevisionBatchSkipDetail, U as RevisionBatchSkipReason, V as RevisionSiteRefusal } from './tree-op-types-Df4oY2u4.js';
+import { T as TextMeasurer, S as SemanticLayout } from './semantic-records-DoK0lNjS.js';
+import { H as HeadlessDocumentView } from './drawing-graphic-kind-CXYGYbB3.js';
 import { CollaborationModuleContribution } from './collaboration.js';
-import { B as ByteSizeBucket, b as CountBucket, f as DocumentOpenDiagnosticCode, j as ReviewDiagnosticCode, E as EditDiagnosticCode } from './diagnostic-hints-C9JlLz1L.js';
-export { C as CollaborationDiagnosticCode, c as CustomNodeDiagnosticCode, d as DiagnosticCode, D as DiagnosticErrorName, e as DiagnosticExplanation, a as DocumentPartKind, g as DocumentSaveDiagnosticCode, F as FailureStage, h as FontDiagnosticCode, i as FormattingChangeKind, H as HistoryDiagnosticCode, P as PerformanceDiagnosticCode, R as ReviewChangeKind, k as ReviewOperation, l as diagnosticCodes, m as explainDiagnostic } from './diagnostic-hints-C9JlLz1L.js';
-export { a as diagnosticCause, d as diagnosticCauses, b as diagnosticErrorName, c as documentPartKind, e as exceptionCause } from './diagnostic-context-DJ0P1uZE.js';
-export { b as HistoryGroup, d as HistoryGroupOutcome } from './editor-scope-C7ke1KJG.js';
-import './omml-equation-BsLAa2lX.js';
+export { D as DiagnosticEmitter, a as DiagnosticPayload, b as byteSizeBucket, c as countBucket, e as createDiagnosticEmitter, f as diagnosticCause, d as diagnosticCauses, g as diagnosticErrorName, h as documentPartKind, i as exceptionCause, o as openDiagnosticCode, r as reviewCodeOfSkip, j as reviewDiagnosticCode, k as reviewSkipOfReason, s as storeEditDiagnosticCode } from './diagnostic-context-CuzhOX0g.js';
+export { B as ByteSizeBucket, C as CollaborationDiagnosticCode, a as CountBucket, b as CustomNodeDiagnosticCode, D as DiagnosticCode, c as DiagnosticErrorName, d as DiagnosticExplanation, e as DocumentOpenDiagnosticCode, f as DocumentPartKind, g as DocumentSaveDiagnosticCode, E as EditDiagnosticCode, F as FailureStage, h as FontDiagnosticCode, i as FormattingChangeKind, H as HistoryDiagnosticCode, P as PerformanceDiagnosticCode, j as ReviewChangeKind, R as ReviewDiagnosticCode, k as ReviewOperation, l as diagnosticCodes, m as explainDiagnostic } from './diagnostic-hints-BtCaCqQC.js';
+export { c as HistoryGroup, H as HistoryGroupOutcome } from './editor-scope-CA6egMaK.js';
+import './revision-projection-OVusTS77.js';
 import './collaboration/replication.js';
-import './failure-NS2lsya4.js';
+import './failure-6KGFrDO9.js';
 
 /** The variants a section can declare furniture for. */
 declare const HEADER_FOOTER_VARIANTS: readonly HeaderFooterVariant[];
@@ -62,9 +61,9 @@ type AutomationShapeOwnerStory = {
 };
 
 /** Operations that read. They never open a transaction. */
-declare const AUTOMATION_QUERY_OPERATIONS: readonly ["getTables", "getTable", "getTableRows", "getTableCells", "getTableCell", "getTableCellProperties", "getTableCellBody", "getFields", "getField", "getInlinePictures", "getInlinePicture", "getShapes", "getShape", "getShapeBody", "getChangeTrackingMode", "getDocument", "getDocumentProperty", "getBody", "getParagraphs", "getRange", "getSpanParagraphs", "getText", "getSpanText", "getParagraphId", "search", "getFont", "getParagraphFormat", "getStyle", "getSections", "getPageSetup", "getFurniture", "getNotes", "getNoteBody", "getNoteText", "getNoteKind", "getLists", "getListId", "getListById", "getListParagraphs", "getParagraphList", "getListLevel", "getHyperlink", "getBookmarks", "getBookmarkName", "getBookmarkRange", "getBookmarkNames", "getBookmarkRangeByName", "getComments", "getCommentReplies", "getCommentId", "getCommentAuthor", "getCommentDate", "getCommentText", "getCommentRange", "getCommentResolved", "getRevisions", "getRevisionType", "getRevisionAuthor", "getRevisionDate", "getRevisionRange", "getReviewItemRange", "getContentControls", "getContentControlById", "getContentControlsByTag", "getContentControlsByTitle", "getContentControlTag", "getContentControlTitle", "getContentControlFileId", "getContentControlSubtype", "getContentControlLock", "getContentControlIsBound", "getContentControlPlaceholderShown", "getContentControlTemporary", "getContentControlText", "getContentControlParagraphs", "getContentControlRange"];
+declare const AUTOMATION_QUERY_OPERATIONS: readonly ["getTables", "getTable", "getTableRows", "getTableCells", "getTableCell", "getMergedTableCell", "getTableCellProperties", "getTableCellBody", "getFields", "getField", "getFieldResult", "getInlinePictures", "getInlinePicture", "getShapes", "getShape", "getShapeBody", "getChangeTrackingMode", "getDocument", "getDocumentProperty", "getBody", "getParagraphs", "getRange", "getSpanParagraphs", "getText", "getSpanText", "getTextRanges", "expandSpan", "getReviewedText", "getParagraphId", "search", "getFont", "getParagraphFormat", "getStyle", "getSections", "getPageSetup", "getFurniture", "getNotes", "getNoteBody", "getNoteText", "getNoteKind", "getLists", "getListId", "getListById", "getListParagraphs", "getParagraphList", "getListLevel", "getHyperlink", "getBookmarks", "getBookmarkName", "getBookmarkRange", "getBookmarkNames", "getBookmarkRangeByName", "getComments", "getCommentReplies", "getCommentId", "getCommentAuthor", "getCommentDate", "getCommentText", "getCommentRange", "getCommentResolved", "getRevisions", "getRevisionType", "getRevisionAuthor", "getRevisionDate", "getRevisionRange", "getReviewItemRange", "getContentControls", "getContentControlById", "getContentControlsByTag", "getContentControlsByTitle", "getContentControlTag", "getContentControlTitle", "getContentControlFileId", "getContentControlSubtype", "getContentControlLock", "getContentControlIsBound", "getContentControlPlaceholderShown", "getContentControlTemporary", "getContentControlText", "getContentControlParagraphs", "getContentControlRange"];
 /** Operations that write. Every one of these goes through the single transaction path. */
-declare const AUTOMATION_COMMAND_OPERATIONS: readonly ["removeDocumentInformation", "setDocumentProperties", "insertTableRows", "insertTable", "updateTable", "updateTableCell", "setInlinePicture", "deleteInlinePicture", "insertField", "setFieldCode", "deleteField", "updateFieldResult", "insertInlinePicture", "insertBreak", "setChangeTrackingMode", "proposeInsertion", "proposeDeletion", "proposeReplacement", "insertText", "replaceSpan", "replaceStoryBlocks", "insertParagraph", "splitParagraph", "deleteParagraph", "selectSpan", "selectBookmark", "insertBookmark", "deleteBookmark", "setFont", "setParagraphFormat", "setStyle", "setPageSetup", "deleteNote", "setListLevel", "startNewList", "attachToList", "detachFromList", "setListLevelFormat", "insertListParagraph", "setHyperlink", "insertComment", "setCommentResolved", "replyToComment", "deleteComment", "acceptRevision", "rejectRevision", "resolveRevisionBatch", "setRevisionAuthorBatch", "acceptAllRevisions", "rejectAllRevisions", "setContentControlValue", "setContentControlProperties", "deleteContentControl", "insertContentControlText", "insertContentControl", "insertCustomNode"];
+declare const AUTOMATION_COMMAND_OPERATIONS: readonly ["removeDocumentInformation", "setDocumentProperties", "insertTableRows", "insertTable", "updateTable", "updateTableCell", "splitTableCell", "setInlinePicture", "deleteInlinePicture", "insertField", "insertOoxml", "setFieldCode", "setFieldResult", "deleteField", "updateFieldResult", "insertInlinePicture", "insertBreak", "setChangeTrackingMode", "proposeInsertion", "proposeDeletion", "proposeReplacement", "insertText", "replaceSpan", "replaceStoryBlocks", "insertParagraph", "splitParagraph", "deleteParagraph", "selectSpan", "selectBookmark", "insertBookmark", "deleteBookmark", "setFont", "setParagraphFormat", "setStyle", "setPageSetup", "deleteNote", "setListLevel", "startNewList", "attachToList", "detachFromList", "setListLevelFormat", "insertListParagraph", "setHyperlink", "insertComment", "setCommentResolved", "replyToComment", "deleteComment", "acceptRevision", "rejectRevision", "resolveRevisionBatch", "setRevisionAuthorBatch", "acceptAllRevisions", "rejectAllRevisions", "setContentControlValue", "setContentControlProperties", "deleteContentControl", "insertContentControlText", "insertContentControl", "insertCustomNode"];
 /**
  * Commands that commit as a PACKAGE transaction and therefore share a batch with nothing.
  *
@@ -164,42 +163,5 @@ interface ServerAutomationHostOptions {
  */
 declare function createServerAutomationHost(bytes: Uint8Array, options?: ServerAutomationHostOptions): ServerAutomationHostResult;
 
-/**
- * The public code for a refused open. `too-large` is the one reason two layers share: the
- * archive reports it WITH the limit it crossed, a single XML part reports it without one.
- *
- * @public
- */
-declare function openDiagnosticCode(reason: string, limit?: string): DocumentOpenDiagnosticCode;
-/**
- * The public code for a store or host refusal reason, or `null` for a reason this table does
- * not know (a sentence, a binding reason). `unsupported-revision:<kind>` counts as
- * `unsupported-revision`, except `unsupported-revision:foreign-insertion`, which has its own
- * code.
- *
- * @public
- */
-declare function storeEditDiagnosticCode(reason: string): EditDiagnosticCode | null;
-/** The public code for a skipped tracked change, or null for a reason with no public code. */
-declare function reviewDiagnosticCode(reason: string): ReviewDiagnosticCode | null;
-/** The power-of-two bucket of a byte size. */
-declare function byteSizeBucket(bytes: number): ByteSizeBucket;
-/** The order-of-magnitude bucket of a count. */
-declare function countBucket(count: number): CountBucket;
-/** A diagnostic without the fields the emitter adds. Distributes over the union. */
-type DiagnosticPayload<T> = T extends unknown ? Omit<T, 'schemaVersion' | 'editorSessionId' | 'time'> : never;
-/** One delivery path for one editor or runtime instance. */
-interface DiagnosticEmitter<E> {
-    /** Random for this instance and never stored. */
-    readonly editorSessionId: string;
-    /** Stamp the payload and hand it to every listener. A listener that throws is ignored. */
-    deliver(payload: DiagnosticPayload<E>): void;
-}
-/**
- * A delivery path over `listeners`, read at each delivery so a later listener is heard. Generic
- * over the event union, which the editor contracts own: this lane never names them.
- */
-declare function createDiagnosticEmitter<E>(listeners: () => Iterable<(event: E) => unknown>, now?: () => number): DiagnosticEmitter<E>;
-
-export { AUTOMATION_COMMAND_OPERATIONS, AUTOMATION_QUERY_OPERATIONS, AUTOMATION_SOLITARY_OPERATIONS, AutomationCapabilities, AutomationHost, AutomationOperation, ByteSizeBucket, ContentLockPolicy, CountBucket, DocumentOpenDiagnosticCode, EditDiagnosticCode, HEADER_FOOTER_VARIANTS, ReviewDiagnosticCode, SERVER_AUTOMATION_CAPABILITIES, byteSizeBucket, countBucket, createAutomationPaginationProvider, createDiagnosticEmitter, createServerAutomationHost, isAutomationCommand, isSolitaryAutomationCommand, openDiagnosticCode, paginationSnapshotOf, reviewDiagnosticCode, storeEditDiagnosticCode };
-export type { AutomationPaginationOptions, AutomationPaginationProvider, AutomationPaginationSnapshot, AutomationStoryId, DiagnosticEmitter, DiagnosticPayload, ServerAutomationHostOptions, ServerAutomationHostRejection, ServerAutomationHostResult };
+export { AUTOMATION_COMMAND_OPERATIONS, AUTOMATION_QUERY_OPERATIONS, AUTOMATION_SOLITARY_OPERATIONS, AutomationCapabilities, AutomationHost, AutomationOperation, ContentLockPolicy, HEADER_FOOTER_VARIANTS, SERVER_AUTOMATION_CAPABILITIES, createAutomationPaginationProvider, createServerAutomationHost, isAutomationCommand, isSolitaryAutomationCommand, paginationSnapshotOf };
+export type { AutomationPaginationOptions, AutomationPaginationProvider, AutomationPaginationSnapshot, AutomationShapeOwnerStory, AutomationStoryId, ServerAutomationHostOptions, ServerAutomationHostRejection, ServerAutomationHostResult };

package/dist/automation.js

@@ -1 +1 @@
-export{e as AUTOMATION_COMMAND_OPERATIONS,d as AUTOMATION_QUERY_OPERATIONS,f as AUTOMATION_SOLITARY_OPERATIONS,c as HEADER_FOOTER_VARIANTS,n as SERVER_AUTOMATION_CAPABILITIES,v as byteSizeBucket,w as countBucket,l as createAutomationPaginationProvider,x as createDiagnosticEmitter,o as createServerAutomationHost,z as diagnosticCause,y as diagnosticCauses,r as diagnosticCodes,B as diagnosticErrorName,C as documentPartKind,A as exceptionCause,q as explainDiagnostic,h as isAutomationCommand,g as isSolitaryAutomationCommand,s as openDiagnosticCode,j as paginationSnapshotOf,u as reviewDiagnosticCode,t as storeEditDiagnosticCode}from'./chunk-R2XINWVE.js';import'./chunk-SUEXVBPR.js';import'./chunk-4S24UOPG.js';import'./chunk-ZCJS7D7S.js';import'./chunk-VWIJKH4A.js';import'./chunk-Q5K2GGNG.js';import'./chunk-N6B3BXCL.js';import'./chunk-T2QQHG5C.js';
+export{g as AUTOMATION_COMMAND_OPERATIONS,f as AUTOMATION_QUERY_OPERATIONS,h as AUTOMATION_SOLITARY_OPERATIONS,e as HEADER_FOOTER_VARIANTS,p as SERVER_AUTOMATION_CAPABILITIES,y as byteSizeBucket,z as countBucket,n as createAutomationPaginationProvider,A as createDiagnosticEmitter,q as createServerAutomationHost,C as diagnosticCause,B as diagnosticCauses,t as diagnosticCodes,F as diagnosticErrorName,G as documentPartKind,E as exceptionCause,s as explainDiagnostic,j as isAutomationCommand,i as isSolitaryAutomationCommand,u as openDiagnosticCode,l as paginationSnapshotOf,w as reviewCodeOfSkip,x as reviewDiagnosticCode,D as reviewSkipOfReason,v as storeEditDiagnosticCode}from'./chunk-JG4A6W6I.js';import'./chunk-R4R3AAE4.js';import'./chunk-CM5VZRBV.js';import'./chunk-2F2UEAE2.js';import'./chunk-L3YXJDPX.js';import'./chunk-PLKDS4JT.js';import'./chunk-JNGLSBPH.js';import'./chunk-2DR4TH6B.js';import'./chunk-AU33YWEJ.js';

package/dist/binding.cjs

@@ -1 +1 @@
-'use strict';var chunkEOTAXOJY_cjs=require('./chunk-EOTAXOJY.cjs');require('./chunk-XSTGE3NI.cjs'),require('./chunk-5SO5QDMV.cjs'),require('./chunk-IBRBNT37.cjs'),require('./chunk-243W4WW2.cjs'),require('./chunk-6IDOVU6L.cjs'),require('./chunk-WO4V6PNS.cjs');Object.defineProperty(exports,"PROJECTION_ORIGIN",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.l}});Object.defineProperty(exports,"bodyParagraphs",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.c}});Object.defineProperty(exports,"docToTreeOps",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.f}});Object.defineProperty(exports,"mountTreeSurface",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.m}});Object.defineProperty(exports,"openTreeSession",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.j}});Object.defineProperty(exports,"partHasNode",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.g}});Object.defineProperty(exports,"reconcileDoc",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.h}});Object.defineProperty(exports,"runPropsOf",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.b}});Object.defineProperty(exports,"treeSchema",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.a}});Object.defineProperty(exports,"treeToDoc",{enumerable:true,get:function(){return chunkEOTAXOJY_cjs.e}});
+'use strict';var chunk2GPGAFOJ_cjs=require('./chunk-2GPGAFOJ.cjs');require('./chunk-UYCGCVZ2.cjs'),require('./chunk-PXMTQ73F.cjs'),require('./chunk-RFUNFTGV.cjs'),require('./chunk-DYUVJNDD.cjs'),require('./chunk-ZDFJW5XS.cjs'),require('./chunk-X34QRAUU.cjs'),require('./chunk-KE6ZWRIY.cjs');Object.defineProperty(exports,"PROJECTION_ORIGIN",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.n}});Object.defineProperty(exports,"bodyParagraphs",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.c}});Object.defineProperty(exports,"docToTreeOps",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.f}});Object.defineProperty(exports,"mountTreeSurface",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.o}});Object.defineProperty(exports,"openTreeSession",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.l}});Object.defineProperty(exports,"partHasNode",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.g}});Object.defineProperty(exports,"reconcileDoc",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.h}});Object.defineProperty(exports,"runPropsOf",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.b}});Object.defineProperty(exports,"treeSchema",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.a}});Object.defineProperty(exports,"treeToDoc",{enumerable:true,get:function(){return chunk2GPGAFOJ_cjs.e}});

package/dist/binding.d.ts

@@ -9,26 +9,28 @@
  * @public
  */
 import { Node, Schema } from 'prosemirror-model';
-import { at as OoxmlProperty, au as OoxmlPackageResult, as as OoxmlPackageRejection } from './types-barrel-CkF2JbU4.js';
-import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-DeLRqohz.js';
-export { D as DocumentStyleEntry, M as MapResult, P as PackageWriteOptions, b as TreeApplyOptions, c as TreeBindingRejection, d as bodyParagraphs, e as docToTreeOps, p as partHasNode, r as reconcileDoc, t as treeToDoc } from './tree-session-contract-DeLRqohz.js';
-import { C as ContentLockPolicy } from './tree-package-store-B8l8DX3Z.js';
-export { S as StoryScope, b as StoryTargetRejection } from './tree-package-store-B8l8DX3Z.js';
+import { aC as OoxmlProperty, aD as OoxmlPackageResult, aA as OoxmlPackageRejection } from './tree-op-types-Df4oY2u4.js';
+import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-CF2625mv.js';
+export { D as DocumentStyleEntry, M as MapResult, P as PackageWriteOptions, b as TreeApplyOptions, c as TreeBindingRejection, d as bodyParagraphs, e as docToTreeOps, p as partHasNode, r as reconcileDoc, t as treeToDoc } from './tree-session-contract-CF2625mv.js';
+import { C as ContentLockPolicy } from './tree-package-store-DXhX1PE-.js';
+export { S as StoryScope, a as StoryTargetRejection } from './tree-package-store-DXhX1PE-.js';
 import { ReviewModuleContribution } from './contracts/modules.js';
 import { EditorView } from 'prosemirror-view';
-import './editor-scope-C7ke1KJG.js';
-import './custom-node-writes-TeUvMP13.js';
-import './headless-document-view-qOpaCF82.js';
+import './editor-scope-CA6egMaK.js';
+import './custom-node-writes-AqY5KpVx.js';
+import './drawing-graphic-kind-CXYGYbB3.js';
 import './collaboration/replication.js';
-import './semantic-records-B-akgRch.js';
-import './omml-equation-BsLAa2lX.js';
-import './editor-B2ShlO23.js';
-import './diagnostic-hints-C9JlLz1L.js';
-import './failure-NS2lsya4.js';
+import './revision-projection-OVusTS77.js';
+import './contracts/types.js';
+import './failure-6KGFrDO9.js';
+import './document-protection-BvbpSXbQ.js';
+import './editor-B7OOAAie.js';
+import './editor-fonts-D_-vjuJi.js';
+import './diagnostic-hints-BtCaCqQC.js';
 import './contracts/document.js';
 import './contracts/interaction.js';
-import './semantic-interaction-dApRIYpt.js';
-import './document-protection-C8x3P2J6.js';
+import './semantic-interaction-BbA4dgEo.js';
+import './semantic-records-DoK0lNjS.js';
 import './collaboration.js';
 
 /** Attributes carried by a projected paragraph. */

package/dist/binding.js

@@ -1 +1 @@
-export{l as PROJECTION_ORIGIN,c as bodyParagraphs,f as docToTreeOps,m as mountTreeSurface,j as openTreeSession,g as partHasNode,h as reconcileDoc,b as runPropsOf,a as treeSchema,e as treeToDoc}from'./chunk-FT33HRZP.js';import'./chunk-2E2RPEKX.js';import'./chunk-ZCJS7D7S.js';import'./chunk-VWIJKH4A.js';import'./chunk-Q5K2GGNG.js';import'./chunk-N6B3BXCL.js';import'./chunk-T2QQHG5C.js';
+export{n as PROJECTION_ORIGIN,c as bodyParagraphs,f as docToTreeOps,o as mountTreeSurface,l as openTreeSession,g as partHasNode,h as reconcileDoc,b as runPropsOf,a as treeSchema,e as treeToDoc}from'./chunk-F7TGQMVR.js';import'./chunk-D7FAFFTN.js';import'./chunk-2F2UEAE2.js';import'./chunk-L3YXJDPX.js';import'./chunk-PLKDS4JT.js';import'./chunk-JNGLSBPH.js';import'./chunk-2DR4TH6B.js';import'./chunk-AU33YWEJ.js';

package/dist/{chrome-print-BWvaVEhD.d.ts → chrome-print-CrPI9ZQc.d.ts}

@@ -1,29 +1,77 @@
-import { c as FontConfigurationFragment, g as FontResolver, M as MarkedFontResolver, f as FontResolutionRequest } from './font-resolver-CWh40DYp.js';
-import { e as BookmarkStory, u as DocumentSource, Z as FontConfiguration, aV as ZoomMode, J as EditorFontError, x as Editor, R as ReviewPaneOptions, b as EditorCommand, C as CanResult, aC as SelectedImageState, a4 as FormatPainterSurfaceState, f as BookmarkSummary, aA as ScrollPlacement, aT as TrackedChangePredicate, aS as TrackedChangeFilterMode, _ as FontFaceRequest, a0 as FontSource, af as ImageContext, aG as TableBorderEdgeTarget, aH as TableBorderSpec, aI as TableBorderStyle, aN as TableContext } from './editor-B2ShlO23.js';
-import { V as ViewScope, a as EditorExecOptions } from './editor-scope-C7ke1KJG.js';
-import { ao as TreeDocOp, b0 as TextFormFieldRange, b1 as TextFormFieldOptions, aE as ImageDecodePort, ai as Unsubscribe, E as ExecResult, _ as DrawingPositionInput, b2 as DrawingTransform, A as ParagraphTabStop, y as IndentFormatting, z as ParagraphFlags, a5 as ParagraphDisagreements, aJ as DrawingTreeDocOp, af as SupportedImageMime, ae as SelectionPin, Q as OoxmlPackage, g as ReviewRevisionKind, aH as PackageWatermarkWrite, a2 as ImageWrapTarget } from './types-barrel-CkF2JbU4.js';
-import { T as TextMeasurer, a as ReviewDisplayMode, q as ResolvedRevisionMarkup, t as RevisionMarkupOptions, z as RevisionMarkupChromeHandlers, S as SemanticLayout, C as ContentControlBoundaryRecord, O as SectionProperties } from './semantic-records-B-akgRch.js';
-import { F as FieldResultsMode, C as ContentLockPolicy, I as InsertImageInput, S as StoryScope, A as ApplyImagePropertiesInput, i as ImageIntentResult } from './tree-package-store-B8l8DX3Z.js';
+import { d as FontOrigin, M as MarkedFontResolver, c as FontConfigurationFragment, g as FontResolver, f as FontResolutionRequest } from './font-resolver-Bm9XqTNO.js';
+import { F as FontConfiguration, a as FontFaceRequest, b as FontSource } from './editor-fonts-D_-vjuJi.js';
+import { V as ViewScope, a as EditorExecOptions } from './editor-scope-CA6egMaK.js';
+import { au as TreeDocOp, aU as TextFormFieldRange, aV as TextFormFieldOptions, ad as ImageDecodePort, ao as Unsubscribe, E as ExecResult, aa as DrawingPositionInput, aW as DrawingTransform, G as ParagraphTabStop, y as IndentFormatting, F as ParagraphFlags, A as ParagraphDisagreements, aJ as DrawingTreeDocOp, an as SupportedImageMime, am as SelectionPin, a5 as OoxmlPackage, g as ReviewRevisionKind, aH as PackageWatermarkWrite, ag as ImageWrapTarget } from './tree-op-types-Df4oY2u4.js';
+import { e as BookmarkStory, u as DocumentSource, aQ as ZoomMode, J as EditorFontError, x as Editor, b as EditorCommand, C as CanResult, ax as SelectedImageState, _ as FormatPainterSurfaceState, f as BookmarkSummary, av as ScrollPlacement, aO as TrackedChangePredicate, aN as TrackedChangeFilterMode, a9 as ImageContext, aB as TableBorderEdgeTarget, aC as TableBorderSpec, aD as TableBorderStyle, aI as TableContext } from './editor-B7OOAAie.js';
+import { T as TextMeasurer, f as UnsupportedElementRule, S as SemanticLayout, C as ContentControlBoundaryRecord, t as SectionProperties } from './semantic-records-DoK0lNjS.js';
+import { a as ReviewDisplayMode, d as ResolvedRevisionMarkup, k as RevisionMarkupOptions, g as RevisionMarkupChromeHandlers } from './revision-projection-OVusTS77.js';
+import { F as FieldResultsMode, C as ContentLockPolicy, I as InsertImageInput, S as StoryScope, A as ApplyImagePropertiesInput, i as ImageIntentResult } from './tree-package-store-DXhX1PE-.js';
+import { ReviewPaneOptions } from './contracts/types.js';
 import { F as FontShapingOptions } from './font-shaping-policy-BvpkrfxM.js';
-import { F as FieldShadingMode, d as RevisionStyles, f as DrawingPaintStrings, R as ReviewAuthorInfo, c as RevisionAuthorStyle } from './semantic-paint-DLzA8sjP.js';
-import { ReviewModuleContribution, EditorModule } from './contracts/modules.js';
-import { S as SemanticPosition, a as SemanticSelection, N as NavigationCommand } from './semantic-interaction-dApRIYpt.js';
 import { CollaborationModuleContribution, EditorCollaborationSession, CollaborationRemoteSelection } from './collaboration.js';
-import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties, A as AuthoredNoteProperties } from './note-properties-QsKh24sM.js';
-import { B as BookmarkIndex } from './custom-node-writes-TeUvMP13.js';
-import { C as CellSelection } from './semantic-cell-selection-Cub9FDa8.js';
-import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-DeLRqohz.js';
-import { C as CollaborationStatus } from './failure-NS2lsya4.js';
+import { F as FieldShadingMode, c as RevisionStyles, f as DrawingPaintStrings, R as ReviewAuthorInfo, b as RevisionAuthorStyle } from './semantic-paint-B5JcIv9c.js';
+import { ReviewModuleContribution, EditorModule } from './contracts/modules.js';
+import { S as SemanticPosition, a as SemanticSelection, N as NavigationCommand } from './semantic-interaction-BbA4dgEo.js';
+import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties, A as AuthoredNoteProperties } from './note-properties-DCIJUKIy.js';
+import { B as BookmarkIndex } from './custom-node-writes-AqY5KpVx.js';
+import { C as CellSelection } from './semantic-cell-selection-CoI5hHBm.js';
+import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-CF2625mv.js';
+import { a as CollaborationStatus } from './failure-6KGFrDO9.js';
+
+/**
+ * Load an origin's faces after the document first paints, instead of before.
+ *
+ * The editor opens the document with the faces the other origins supply, then lays it out
+ * again when these arrive. Use it for faces that are large or slow to fetch. Leave an origin
+ * unwrapped to install its faces with the document's other waiting fonts: a large document
+ * (over about 512 KB of uncompressed content) waits up to 2 seconds for them before its
+ * first paint.
+ *
+ * ```ts
+ * const fonts = [packagedFonts(), deferFonts(myBrandFonts())];
+ * ```
+ *
+ * A document export that receives this origin waits for its faces, so exported pages use them.
+ * The faces never change the configuration settings, such as `defaultFont` or `maxFontBytes`:
+ * those come from the origins that answer at once, so the document does not change its
+ * default font after it paints.
+ *
+ * @public
+ */
+declare function deferFonts(origin: FontOrigin): MarkedFontResolver;
 
+/**
+ * How a blank document starts.
+ *
+ * @public
+ */
+interface BlankDocumentOptions {
+    /**
+     * `'rtl'` starts the document right to left: its paragraphs (`w:bidi` in the paragraph
+     * defaults) and its section (`w:sectPr/w:bidi`) read right to left, as a new document does
+     * when a right-to-left editing language is the default. `'ltr'` is the default.
+     */
+    readonly direction?: 'ltr' | 'rtl';
+    /**
+     * The language of right-to-left and complex-script text, as a BCP 47 tag such as `ar-SA`
+     * or `he-IL`, written as the run defaults' `w:lang/@w:bidi`. Layout follows it: European
+     * digits in an Arabic-script language draw in the Latin face. A value that is not a
+     * language tag is ignored.
+     */
+    readonly bidiLanguage?: string;
+}
 /**
  * A blank document, freshly zipped per call (the caller may hand the
  * bytes to a loader that takes ownership). Calibri 11pt and Word's Normal paragraph
  * spacing are authored in `w:docDefaults`, Word's built-in style gallery in `styles.xml`,
  * and US Letter geometry in the section. Word opens the saved file.
  *
+ * A right-to-left interface usually wants `{ direction: 'rtl', bidiLanguage: 'ar-SA' }` (or
+ * the reader's own language), so the first paragraph is ready for right-to-left typing.
+ *
  * @public
  */
-declare function blankDocumentBytes(): Uint8Array;
+declare function blankDocumentBytes(options?: BlankDocumentOptions): Uint8Array;
 
 type TableCommandSelectionPolicy = {
     readonly kind: 'preserveSelection';
@@ -400,6 +448,7 @@ interface PaginatedSurfaceOptions {
      * revision markup paints, whatever the {@link revisionDisplayMode} leaves visible.
      */
     readonly revisionStyles?: RevisionStyles;
+    readonly unsupportedElementRules?: readonly UnsupportedElementRule[];
     readonly revisionMarkup?: ResolvedRevisionMarkup;
     /**
      * The review module's derivation hooks for this surface's session. Absent,
@@ -506,8 +555,8 @@ interface PaginatedSurfaceOptions {
 }
 
 /**
- * Receives the element that shows the loading indicator on the first page, while a large
- * document lays out its remaining pages.
+ * Receives the element that shows the loading indicator below the laid-out pages, while a
+ * large document lays out its remaining pages.
  *
  * @example
  * ```ts
@@ -524,8 +573,8 @@ interface OpeningIndicatorHost {
     /**
      * Called with the indicator element when the first pages show, and with `null` when the
      * remaining pages are laid out or the open is abandoned. The element is empty while a host
-     * is set: render the host's content into it. It is centered on the first page, at most 30%
-     * of the window height below the page top, and scrolls with the document.
+     * is set: render the host's content into it. It is centered in a band below the last
+     * laid-out page, as wide as the page, and scrolls with the document.
      */
     publish(element: HTMLElement | null): void;
 }
@@ -629,6 +678,8 @@ interface DocxEditorConfig {
      * the proposed view still marks surviving insertions.
      */
     revisionStyles?: RevisionStyles;
+    /** Ordered unsupported-content registrations; the first matching rule reserves a layout box. */
+    unsupportedElementRules?: readonly UnsupportedElementRule[];
     /** Initial local revision presentation and tracking preferences. */
     revisionMarkup?: RevisionMarkupOptions;
     /** Initial review projection. Markup modes require a review module. */
@@ -812,6 +863,17 @@ interface AttachOptions {
  * need. Production adapters program against `Editor` for everything else.
  */
 interface DocxEditorInstance extends Editor {
+    /**
+     * Replace host font resources without replacing the document or its edit history.
+     * Old resolution is cancelled. Existing host faces are removed before the new
+     * resolver runs; no answer keeps the bounded fallback. Document-embedded faces
+     * remain independent of host fonts. Failures report through `onFontError`.
+     *
+     * The session, selection, undo, protection, and collaboration state stay intact.
+     * Throws after `destroy()`. This does not grant permission to load native fonts.
+     * @public
+     */
+    setFonts(fonts: DocxEditorConfig['fonts']): Promise<void>;
     /** Bumps on mount, detach, destroy, and document reload — guards async image intents. */
     readonly mountGeneration: number;
     /**
@@ -1033,6 +1095,8 @@ interface DocxEditorInstance extends Editor {
      * of calling it. Call it directly from headless and non-React hosts.
      */
     setRevisionStyles(styles: RevisionStyles): void;
+    /** Replace registrations while preserving document edits and undo history. */
+    setUnsupportedElementRules(rules: readonly UnsupportedElementRule[]): void;
     /** Merge local preferences and emit revisionMarkupChange after a change.
      * Invalid settings throw TypeError without changing the previous settings.
      */
@@ -1224,6 +1288,11 @@ interface ImageOverlayScrollPort {
 interface SelectedDrawingOverlayTarget {
     /** Keep the text area available for pointer editing through the frame. */
     readonly textbox?: boolean;
+    /**
+     * False for a text box whose text takes no caret: rotated or vertical text, or a story
+     * holding a table. Absent for a drawing that is not a text box.
+     */
+    readonly textEditable?: boolean;
     readonly id: string;
     readonly pageIndex: number;
     readonly x: number;
@@ -1968,11 +2037,11 @@ interface PaginatedSurface {
      */
     adjustIndent(direction: 'increase' | 'decrease'): boolean;
     /**
-     * Tab (`increase`) or Shift+Tab (`decrease`) over a selection outside a list: change the
-     * indent and keep the text.
+     * Tab (`increase`) or Shift+Tab (`decrease`) over a selection outside a list and outside a
+     * table cell (the key moves between cells there): change the indent and keep the text.
      *
-     * A selection over two or more paragraphs, or a cell rectangle, steps the left indent of
-     * each paragraph. A selection in one paragraph that starts at the paragraph start, whole or
+     * A selection over two or more paragraphs, or a cell rectangle (only from a host calling
+     * this directly), steps the left indent of each paragraph. A selection in one paragraph that starts at the paragraph start, whole or
      * partial, works on the first line: Tab sets a first-line indent of one default tab stop
      * (`w:defaultTabStop`), or steps the left indent when the first line already has that
      * indent or more, or a hanging indent. Shift+Tab clears a first-line indent that the
@@ -2088,16 +2157,17 @@ interface PaginatedSurface {
      * caret-preserving edits (Backspace, Delete, Enter) and IME composition, and is
      * discarded when the caret moves elsewhere or the document is undone. A property the
      * store cannot author is refused at arm time rather than left to poison the keystroke.
+     * Returns the document's refusal reason, or null when the write landed, armed, or did nothing.
      */
-    toggleRunProperty(localName: string, attributes?: Record<string, string>): void;
+    toggleRunProperty(localName: string, attributes?: Record<string, string>): string | null;
     /**
      * SET a run property over the selection, rather than toggling it.
      *
      * Font family, size and colour are values, not switches: picking Arial twice must leave
      * the text in Arial, which a toggle would not. Arms at a collapsed caret on the same
-     * terms as `toggleRunProperty`.
+     * terms as `toggleRunProperty`, and returns a refusal the same way.
      */
-    setRunProperty(localName: string, attributes?: Record<string, string>): void;
+    setRunProperty(localName: string, attributes?: Record<string, string>): string | null;
     /**
      * Set a property on every paragraph the selection touches — alignment, style, spacing.
      *
@@ -2348,6 +2418,7 @@ interface PaginatedSurface {
      */
     setRevisionMarkup(settings: ResolvedRevisionMarkup): void;
     setRevisionStyles(colors: RevisionStyles | undefined): void;
+    setUnsupportedElementRules(rules: readonly UnsupportedElementRule[]): void;
     /** Toggle paragraph-end furniture without layout or document changes. */
     setShowParagraphMarks(show: boolean): void;
     /**
@@ -2533,14 +2604,14 @@ interface PaginatedSurface {
     selectedText(): string;
     /**
      * Every clipboard flavour for the current selection: plain text, and the interop HTML
-     * carrying the embedded fragment when the selection is a body-story range. A cell
-     * rectangle answers grid text plus a flattened table; `html` is null where only plain
-     * text should be written. Unsupported object selections return a refusal reason.
+     * carrying the embedded fragment when the selection is a body-story range. A cell rectangle
+     * answers grid text plus a flattened table; `html` is null where only plain text should be
+     * written. A chart refuses as `'chart-content'`, another object as `'unsupported-content'`.
      */
     copyFlavours(): {
         readonly text: string;
         readonly html: string | null;
-        readonly reason?: 'unsupported-content';
+        readonly reason?: 'unsupported-content' | 'chart-content';
     };
     /**
      * Route one paste payload by fidelity: embedded fragment, then external HTML, then
@@ -3561,6 +3632,20 @@ declare const CHROME_GROUPS: readonly [{
         readonly state: {
             readonly kind: 'value';
         };
+    }, {
+        readonly id: 'mergeCells';
+        readonly labelKey: 'table.mergeCells';
+        readonly paths: readonly string[];
+        readonly state: {
+            readonly kind: 'command';
+        };
+    }, {
+        readonly id: 'splitCell';
+        readonly labelKey: 'table.splitCell';
+        readonly paths: readonly string[];
+        readonly state: {
+            readonly kind: 'command';
+        };
     }];
 }, {
     readonly id: 'paragraph';
@@ -3739,7 +3824,7 @@ type ChromeGroupId = 'history' | 'zoom' | 'styles' | 'font' | 'text' | 'script'
  *
  * @public
  */
-type ChromeSlotId = 'history.undo' | 'history.redo' | 'zoom.level' | 'styles.style' | 'font.family' | 'font.size' | 'text.bold' | 'text.italic' | 'text.underline' | 'text.strike' | 'text.color' | 'text.highlight' | 'text.link' | 'script.super' | 'script.sub' | 'alignment.left' | 'alignment.center' | 'alignment.right' | 'alignment.justify' | 'direction.ltr' | 'direction.rtl' | 'list.bullet' | 'list.numbered' | 'list.outdent' | 'list.indent' | 'list.lineSpacing' | 'format.painter' | 'format.clear' | 'review.revisionMarkup' | 'review.comments' | 'review.addComment' | 'review.paragraphMarks' | 'review.bookmarks' | 'review.protectDocument' | 'review.simpleMarkup' | 'review.allMarkup' | 'review.noMarkup' | 'review.original' | 'review.previousChange' | 'review.nextChange' | 'review.acceptAllChanges' | 'review.rejectAllChanges' | 'review.authors' | 'review.editingMode' | 'contentControl.showAll' | 'contentControl.formFill' | 'contentControl.inspector' | 'contentControl.remove' | 'image.insert' | 'image.properties' | 'image.wrap' | 'image.altText' | 'table.insert' | 'table.borderTarget' | 'table.borderColor' | 'table.borderStyle' | 'table.borderWidth' | 'table.cellFill' | 'file.open' | 'file.save' | 'file.exportMarkdown' | 'file.exportPdf' | 'file.print' | 'paragraph.dialog' | 'file.pageSetup' | 'insert.textBox' | 'insert.footnote' | 'insert.endnote' | 'insert.pageNumber' | 'insert.totalPages' | 'insert.sectionPages' | 'insert.pageXofY' | 'insert.pageBreak' | 'insert.sectionBreakNextPage' | 'insert.sectionBreakContinuous' | 'insert.toc' | 'insert.bookmark' | 'insert.goToBookmark' | 'insert.watermark';
+type ChromeSlotId = 'history.undo' | 'history.redo' | 'zoom.level' | 'styles.style' | 'font.family' | 'font.size' | 'text.bold' | 'text.italic' | 'text.underline' | 'text.strike' | 'text.color' | 'text.highlight' | 'text.link' | 'script.super' | 'script.sub' | 'alignment.left' | 'alignment.center' | 'alignment.right' | 'alignment.justify' | 'direction.ltr' | 'direction.rtl' | 'list.bullet' | 'list.numbered' | 'list.outdent' | 'list.indent' | 'list.lineSpacing' | 'format.painter' | 'format.clear' | 'review.revisionMarkup' | 'review.comments' | 'review.addComment' | 'review.paragraphMarks' | 'review.bookmarks' | 'review.protectDocument' | 'review.simpleMarkup' | 'review.allMarkup' | 'review.noMarkup' | 'review.original' | 'review.previousChange' | 'review.nextChange' | 'review.acceptAllChanges' | 'review.rejectAllChanges' | 'review.authors' | 'review.editingMode' | 'contentControl.showAll' | 'contentControl.formFill' | 'contentControl.inspector' | 'contentControl.remove' | 'image.insert' | 'image.properties' | 'image.wrap' | 'image.altText' | 'table.insert' | 'table.borderTarget' | 'table.borderColor' | 'table.borderStyle' | 'table.borderWidth' | 'table.cellFill' | 'table.mergeCells' | 'table.splitCell' | 'file.open' | 'file.save' | 'file.exportMarkdown' | 'file.exportPdf' | 'file.print' | 'paragraph.dialog' | 'file.pageSetup' | 'insert.textBox' | 'insert.footnote' | 'insert.endnote' | 'insert.pageNumber' | 'insert.totalPages' | 'insert.sectionPages' | 'insert.pageXofY' | 'insert.pageBreak' | 'insert.sectionBreakNextPage' | 'insert.sectionBreakContinuous' | 'insert.toc' | 'insert.bookmark' | 'insert.goToBookmark' | 'insert.watermark';
 /**
  * Every control id in the chrome, as a literal union. Unique WITHIN a group, not
  * globally (`image.insert` / `table.insert`) — key consumers on {@link ChromeSlotId}.
@@ -3769,15 +3854,20 @@ declare function chromeSlotId(group: {
  * @public
  */
 declare function defaultChromeGroups(): readonly ChromeGroup[];
+/** Options for {@link formattingBarChromeGroups}. @public */
+interface FormattingBarOptions {
+    /** Show `direction.ltr` and `direction.rtl` after alignment, as for a right-to-left UI. */
+    readonly direction?: boolean;
+}
 /**
- * The formatting-bar groups for one editor snapshot: the default bar, plus the
- * contextual `image` group when a drawing is selected. Insertion without a selection
- * lives in the packaged Insert menu (`CHROME_MENUS`), not in the bar — a host that wants
- * a bar button places `DocxEditor.Toolbar.ImageInsert` itself.
+ * The formatting-bar groups for one editor snapshot: the default bar, the contextual `image`
+ * group when a drawing is selected, and the direction group when `options.direction` asks.
+ * Insertion without a selection lives in the packaged Insert menu (`CHROME_MENUS`), not in
+ * the bar — a host that wants a bar button places `DocxEditor.Toolbar.ImageInsert` itself.
  *
  * @public
  */
-declare function formattingBarChromeGroups(image: ImageContext | null): readonly ChromeGroup[];
+declare function formattingBarChromeGroups(image: ImageContext | null, options?: FormattingBarOptions): readonly ChromeGroup[];
 
 /**
  * The menu bar the chrome shows above the toolbar, in bar order: File, Format, Insert, Review,
@@ -4209,5 +4299,5 @@ interface ChromePrintJob {
  */
 declare function runChromePrint(editor: Pick<Editor, 'save'> & Partial<Pick<Editor, 'snapshot'>>, handlers?: ChromeExportHandlers, container?: Document | Element): Promise<ChromePrintJob>;
 
-export { CHROME_GROUPS as C, bindHistoryGroup as J, blankDocumentBytes as K, chromeMenuSlots as M, commandForSlot as N, commandForSlotValue as O, createDocxEditor as P, createFontSource as Q, customFonts as R, isChromePrintShortcut as U, loadFonts as V, runChromeExport as W, runChromePrint as X, runToolbarCommand as Y, toolbarCommandState as Z, CHROME_UNAVAILABLE_KEY as a7, TABLE_BORDER_STYLE_OPTIONS as aO, TABLE_BORDER_TARGET_OPTIONS as aP, TABLE_BORDER_WIDTH_OPTIONS as aQ, TABLE_CHROME_SLOT_IDS as aR, DEFAULT_TABLE_CHROME_DRAFT as ag, EMU_PER_POINT as ai, IMAGE_OVERLAY_NUDGE_PT as ap, IMAGE_OVERLAY_NUDGE_SHIFT_PT as aq, CHROME_MENUS as b, applyTableChromePick as b3, canExecuteImageCommand as b4, captureImageMutationPreconditions as b5, chromeControlCount as b6, chromeProbeForSlot as b7, chromeSlotId as b8, chromeSlotIsToggle as b9, selectedImageStateOf as bA, surfacePaintScale as bB, tableChromeIconPaths as bC, tableChromeLabelKeyForTarget as bD, tableChromeToolbarState as bE, tableChromeVisible as bF, tableCommandToolbarState as bG, toolbarCommandStates as bH, commandExecOptions as ba, commandForTableChromeSlotValue as bb, computeImageResizeResult as bc, computeMovedImagePosition as bd, computeResizedImageExtentEmu as be, createImageOverlayScrollPort as bf, cssPixelsToLayoutPoints as bg, defaultChromeGroups as bh, defaultTableLabel as bi, emuToOverlayPoints as bj, equationAtPosition as bk, executeImageCommand as bl, finalizeImageOverlayInteraction as bm, formattingBarChromeGroups as bn, isStaleImageInteractionCommit as bo, isTableChromeSlot as bp, layoutPointsToCssPixels as bq, overlayFrameToSheetCssPixels as br, overlayHostOrigin as bs, pointsToEmu as bt, probeTableChromeCommand as bu, resizePreservesAspect as bv, runSave as bw, runTableChromeCommand as bx, runTableCommand as by, selectedDrawingOverlayTargetOf as bz, ChromeExportError as c, ChromePrintError as m };
-export type { OpenPaginatedResult as $, HyperlinkChromeHandlers as A, BookmarkMarkInfo as B, DocxEditorConfig as D, LoadFontsResult as E, FontLoadFailure as F, GoToChromeHandlers as G, HistoryGroupBinding as H, LockedControlNavigation as I, LoadFontsRequest as L, SurfaceHyperlink as S, ToolbarCommandState as T, PaginatedSurfaceOptions as _, BookmarkMarkOptions as a, TextFormFieldDialogSession as a$, PaginatedSurface as a0, TableCommandPlan as a1, SurfaceFormatting as a2, AnchorFrameOrigin as a3, AttachOptions as a4, BookmarkChromeHandlers as a5, BookmarkMarkOptionsSource as a6, ChromeControl as a8, ChromeControlId as a9, ParagraphPropertyEdit as aA, PopupChromeRegistrationOptions as aB, RemoteCaretLabelAnchor as aC, RemoteCaretLabelHost as aD, ReviewWriteIntent as aE, RunTableChromeCommandResult as aF, SectionAnchor as aG, SectionBreakInsertType as aH, SelectedDrawingOverlayTarget as aI, SurfaceEquation as aJ, SurfaceInsertImageInput as aK, SurfaceNavigation as aL, SurfaceOverlayCoordinates as aM, SurfaceParagraphFormat as aN, TableBorderStyleOption as aS, TableBorderTargetOption as aT, TableBorderTargetValue as aU, TableBorderWidthOption as aV, TableChromeDraft as aW, TableChromePick as aX, TableChromeSlotId as aY, TableInteractionLabelKey as aZ, TextFormFieldChromeHandlers as a_, ChromeControlState as aa, ChromeExportView as ab, ChromeGroup as ac, ChromeGroupId as ad, ContentControlWidgetChromeHandlers as ae, ContentControlWidgetSession as af, DrawingSelectionIntent as ah, EditorCommandExecute as aj, EquationActivation as ak, EquationChromeHandlers as al, EquationOps as am, FinalizedImageOverlayInteraction as an, HyperlinkOps as ao, ImageInteractionSession as ar, ImageOverlayScrollPort as as, ImageResizeHandle as at, ImageResizeResult as au, InvalidTextFormFieldChromeHandlers as av, InvalidTextFormFieldSession as aw, OpeningIndicatorHost as ax, OverlayFrameRect as ay, PaginatedSurfaceState as az, ToolbarSlotValue as b0, ToolbarValueMap as b1, ToolbarValueSlot as b2, ChromeExportFormat as d, ChromeExportHandlers as e, ChromeExportResult as f, ChromeMenu as g, ChromeMenuEntry as h, ChromeMenuId as i, ChromeMenuItemEntry as j, ChromeMenuSeparatorEntry as k, ChromeMenuSubmenuEntry as l, ChromePrintErrorCode as n, ChromePrintJob as o, ChromePrintOptions as p, ChromeSlotId as q, CommentDraftChromeHandlers as r, CustomFontsOptions as s, CustomFontsResolver as t, DocxEditorInstance as u, FontLoadFailureReason as v, FontMeasurementState as w, FontUrlSource as x, HistoryGroupBindingOptions as y, HyperlinkActivation as z };
+export { bindHistoryGroup as $, CHROME_GROUPS as C, blankDocumentBytes as a0, chromeMenuSlots as a1, commandForSlot as a2, commandForSlotValue as a3, createDocxEditor as a4, createFontSource as a5, customFonts as a6, deferFonts as a7, isChromePrintShortcut as a8, loadFonts as a9, IMAGE_OVERLAY_NUDGE_SHIFT_PT as aA, TABLE_BORDER_STYLE_OPTIONS as aU, TABLE_BORDER_TARGET_OPTIONS as aV, TABLE_BORDER_WIDTH_OPTIONS as aW, TABLE_CHROME_SLOT_IDS as aX, runChromeExport as aa, runChromePrint as ab, runToolbarCommand as ac, toolbarCommandState as ad, CHROME_UNAVAILABLE_KEY as al, DEFAULT_TABLE_CHROME_DRAFT as ar, EMU_PER_POINT as at, IMAGE_OVERLAY_NUDGE_PT as az, applyTableChromePick as b6, canExecuteImageCommand as b7, captureImageMutationPreconditions as b8, chromeControlCount as b9, runTableChromeCommand as bA, runTableCommand as bB, selectedDrawingOverlayTargetOf as bC, selectedImageStateOf as bD, surfacePaintScale as bE, tableChromeIconPaths as bF, tableChromeLabelKeyForTarget as bG, tableChromeToolbarState as bH, tableChromeVisible as bI, tableCommandToolbarState as bJ, toolbarCommandStates as bK, chromeProbeForSlot as ba, chromeSlotId as bb, chromeSlotIsToggle as bc, commandExecOptions as bd, commandForTableChromeSlotValue as be, computeImageResizeResult as bf, computeMovedImagePosition as bg, computeResizedImageExtentEmu as bh, createImageOverlayScrollPort as bi, cssPixelsToLayoutPoints as bj, defaultChromeGroups as bk, defaultTableLabel as bl, emuToOverlayPoints as bm, equationAtPosition as bn, executeImageCommand as bo, finalizeImageOverlayInteraction as bp, formattingBarChromeGroups as bq, isStaleImageInteractionCommit as br, isTableChromeSlot as bs, layoutPointsToCssPixels as bt, overlayFrameToSheetCssPixels as bu, overlayHostOrigin as bv, pointsToEmu as bw, probeTableChromeCommand as bx, resizePreservesAspect as by, runSave as bz, CHROME_MENUS as d, ChromeExportError as e, ChromePrintError as p };
+export type { AttachOptions as A, BlankDocumentOptions as B, DocxEditorConfig as D, EquationActivation as E, EquationChromeHandlers as F, FontLoadFailure as G, FontLoadFailureReason as H, FontMeasurementState as I, FontUrlSource as J, GoToChromeHandlers as K, HistoryGroupBinding as L, HistoryGroupBindingOptions as M, HyperlinkActivation as N, HyperlinkChromeHandlers as O, InvalidTextFormFieldChromeHandlers as P, InvalidTextFormFieldSession as Q, LoadFontsRequest as R, LoadFontsResult as S, LockedControlNavigation as T, PopupChromeRegistrationOptions as U, SurfaceEquation as V, SurfaceHyperlink as W, TableChromeSlotId as X, ToolbarCommandState as Y, ToolbarValueMap as Z, ToolbarValueSlot as _, BookmarkChromeHandlers as a, TableBorderWidthOption as a$, ImageInteractionSession as aB, ImageOverlayScrollPort as aC, ImageResizeHandle as aD, ImageResizeResult as aE, OpeningIndicatorHost as aF, OverlayFrameRect as aG, PaginatedSurfaceState as aH, ParagraphPropertyEdit as aI, RemoteCaretLabelAnchor as aJ, RemoteCaretLabelHost as aK, ReviewWriteIntent as aL, RunTableChromeCommandResult as aM, SectionAnchor as aN, SectionBreakInsertType as aO, SelectedDrawingOverlayTarget as aP, SurfaceInsertImageInput as aQ, SurfaceNavigation as aR, SurfaceOverlayCoordinates as aS, SurfaceParagraphFormat as aT, TableBorderStyleOption as aY, TableBorderTargetOption as aZ, TableBorderTargetValue as a_, PaginatedSurfaceOptions as ae, OpenPaginatedResult as af, PaginatedSurface as ag, TableCommandPlan as ah, SurfaceFormatting as ai, AnchorFrameOrigin as aj, BookmarkMarkOptionsSource as ak, ChromeControl as am, ChromeControlId as an, ChromeControlState as ao, ChromeGroup as ap, ChromeGroupId as aq, DrawingSelectionIntent as as, EditorCommandExecute as au, EquationOps as av, FinalizedImageOverlayInteraction as aw, FormattingBarOptions as ax, HyperlinkOps as ay, BookmarkMarkInfo as b, TableChromeDraft as b0, TableChromePick as b1, TableInteractionLabelKey as b2, TextFormFieldChromeHandlers as b3, TextFormFieldDialogSession as b4, ToolbarSlotValue as b5, BookmarkMarkOptions as c, ChromeExportFormat as f, ChromeExportHandlers as g, ChromeExportResult as h, ChromeExportView as i, ChromeMenu as j, ChromeMenuEntry as k, ChromeMenuId as l, ChromeMenuItemEntry as m, ChromeMenuSeparatorEntry as n, ChromeMenuSubmenuEntry as o, ChromePrintErrorCode as q, ChromePrintJob as r, ChromePrintOptions as s, ChromeSlotId as t, CommentDraftChromeHandlers as u, ContentControlWidgetChromeHandlers as v, ContentControlWidgetSession as w, CustomFontsOptions as x, CustomFontsResolver as y, DocxEditorInstance as z };