@docx-editor.dev/core 2.27.0 → 2.29.0

package/dist/automation.cjs

@@ -1 +1 @@
-'use strict';var chunkFQN4KSFL_cjs=require('./chunk-FQN4KSFL.cjs');require('./chunk-WRLKVNNR.cjs'),require('./chunk-55AT3MOU.cjs'),require('./chunk-2GK7YQB2.cjs'),require('./chunk-K246T47S.cjs');var chunkAVKVRU7Z_cjs=require('./chunk-AVKVRU7Z.cjs'),chunkGVUOWHTO_cjs=require('./chunk-GVUOWHTO.cjs'),chunk4KZ6L5YF_cjs=require('./chunk-4KZ6L5YF.cjs');var j=Object.freeze({document:true,save:true,events:true,selection:false,scrolling:false,layout:false}),D=Object.freeze({kind:"body"});function Y(o,t={}){let m=chunk4KZ6L5YF_cjs.ne(o,t.limits??{});if(!m.ok)return {ok:false,reason:m.reason,...m.limit===void 0?{}:{limit:m.limit},...m.detail?{detail:m.detail}:{}};let p=m.package.parts.get(m.package.mainDocumentPart);if(!p)return {ok:false,reason:"no-main-document-part",detail:m.package.mainDocumentPart};let u=new chunkAVKVRU7Z_cjs.X(m.package,chunkAVKVRU7Z_cjs.Xa(m.package,chunk4KZ6L5YF_cjs.qb(p))),y=t.collaborationModel?.session,c=()=>{},n=K(u,y,()=>c());if(t.pagination){let i,l=-1,e=t.pagination;n.prepare=async f=>{if(!f.operations.some(s=>s.op==="updateFieldResult"))return;i=void 0;let a=u.packageRevision,d=await e(chunkAVKVRU7Z_cjs.bb(u));u.packageRevision===a&&(i=d,l=a);},n.fieldPageContext=(f,a,d)=>{if(u.packageRevision!==l)return null;let s=chunkFQN4KSFL_cjs.g(u.currentPackage()).story(f);return s?chunkFQN4KSFL_cjs.d(i,s.part,a,d):null};}let r=chunkFQN4KSFL_cjs.m({port:n,capabilities:j});return y&&(c=y.attach(chunkGVUOWHTO_cjs.b(u,{documentId:y.documentId}))),{ok:true,host:r}}function G(o,t,m){let p=o.partFor(m);return p?chunk4KZ6L5YF_cjs.Fa(o,()=>{let u=chunk4KZ6L5YF_cjs.og(o.currentPackage(),t,p.name);return u?(o.replacePackageShell(u.pkg),u.relationshipId):null},u=>u!==null):null}function K(o,t,m=()=>{}){let p=true,u=0,y=()=>t?(u+=1,{origin:t.identity.role==="agent"?chunk4KZ6L5YF_cjs.b.mutationAgent:chunk4KZ6L5YF_cjs.b.mutationHuman,actorId:t.identity.actorId,operationId:`${t.identity.actorId}:${t.sessionId}:automation:${u}`,recordsHistory:false}):{},c=n=>(t?.flushPendingJournals(),n);return {localChangeTracking:true,collaborative:()=>!!t,revision:()=>o.packageRevision,currentPackage:()=>p?o.currentPackage():null,apply(n,r=D,i=[]){if(!p)return {ok:false,reason:"disposed"};let l=n(d=>chunk4KZ6L5YF_cjs.tb(t?.identity.actorId,()=>G(o,d,r)));if(l===null)return {ok:false,reason:"unsupported-target"};let e=t?.gateOperations(l,r);if(e)return {ok:false,reason:e};let f=t?o.partFor(r)?.name:void 0,a=o.transact(r,d=>{for(let s of i)d.applyPackage(s);for(let s of l)d.apply(s);f&&d.applyPackage(s=>chunkGVUOWHTO_cjs.a(s,f,l));},y());return a.ok?c({ok:true,changed:a.change!==null}):{ok:false,reason:a.detail?`${a.reason}: ${a.detail}`:a.reason}},applyLifecycle(n){if(!p)return {ok:false,reason:"disposed"};let r=t?.gateOperations([n],D);if(r)return {ok:false,reason:r};let i=chunk4KZ6L5YF_cjs.tb(t?.identity.actorId,()=>o.applyLifecycleOp(n));return i.ok?c({ok:true,changed:i.change!==null}):{ok:false,reason:i.detail?`${i.reason}: ${i.detail}`:i.reason}},applyCommentWrites(n,r){if(!p)return {ok:false,reason:"disposed"};if(n.length===0)return {ok:true,changed:false};let i=t?.gateOperations([],r);if(i)return {ok:false,reason:i};let l=o.resolveStory(r);if(!l.ok)return {ok:false,reason:l.reason};if(l.store.graftPackage(()=>o.currentPackage()),n.every(a=>a.kind==="delete")){let a=n.find(s=>s.kind==="delete"),d=chunk4KZ6L5YF_cjs.tb(t?.identity.actorId,()=>chunkAVKVRU7Z_cjs.ia(o,n.flatMap(s=>s.kind==="delete"?[{commentId:s.commentId,...s.parentCommentId===void 0?{}:{parentCommentId:s.parentCommentId}}]:[]),r,a?.kind==="delete"?a.noteId:void 0));return d?c({ok:true,changed:d}):{ok:false,reason:"comment-delete-refused"}}if(n.length!==1)return {ok:false,reason:"mixed-comment-writes"};let e=n[0];if(e.kind==="create"||e.kind==="reply"){let a=chunk4KZ6L5YF_cjs.tb(t?.identity.actorId,()=>chunkAVKVRU7Z_cjs.ga(o,{anchor:e.anchor,author:e.author,text:e.text,...e.date===void 0?{}:{date:e.date},...e.kind==="reply"?{replyToCommentId:e.parentCommentId}:{}},r));return a.ok?c({ok:true,changed:true,..."commentId"in a?{commentId:a.commentId}:{}}):{ok:false,reason:a.reason}}if(e.kind!=="resolve")return {ok:false,reason:"unsupported-comment-write"};let f=chunk4KZ6L5YF_cjs.tb(t?.identity.actorId,()=>chunkAVKVRU7Z_cjs.ha(o,e.commentId,e.resolved));return f.ok?c({ok:true,changed:true}):{ok:false,reason:f.reason}},applyCustomNodeWrite(n,r){if(!p)return {ok:false,reason:"disposed"};let i=t?.gateOperations([],r);if(i)return {ok:false,reason:i};let l=o.resolveStory(r);if(!l.ok)return {ok:false,reason:l.reason};let e=chunk4KZ6L5YF_cjs.tb(t?.identity.actorId,()=>chunkAVKVRU7Z_cjs.qa(o,n,r));return e.ok?c({ok:true,changed:e.change!==null}):{ok:false,reason:e.detail?`${e.reason}: ${e.detail}`:e.reason}},save:()=>p?chunk4KZ6L5YF_cjs.oe(o.currentPackage()):null,subscribe:n=>o.subscribe(()=>n()),dispose(){m(),p=false;}}}Object.defineProperty(exports,"AUTOMATION_COMMAND_OPERATIONS",{enumerable:true,get:function(){return chunkFQN4KSFL_cjs.i}});Object.defineProperty(exports,"AUTOMATION_QUERY_OPERATIONS",{enumerable:true,get:function(){return chunkFQN4KSFL_cjs.h}});Object.defineProperty(exports,"AUTOMATION_SOLITARY_OPERATIONS",{enumerable:true,get:function(){return chunkFQN4KSFL_cjs.j}});Object.defineProperty(exports,"HEADER_FOOTER_VARIANTS",{enumerable:true,get:function(){return chunkFQN4KSFL_cjs.f}});Object.defineProperty(exports,"createAutomationPaginationProvider",{enumerable:true,get:function(){return chunkFQN4KSFL_cjs.e}});Object.defineProperty(exports,"isAutomationCommand",{enumerable:true,get:function(){return chunkFQN4KSFL_cjs.l}});Object.defineProperty(exports,"isSolitaryAutomationCommand",{enumerable:true,get:function(){return chunkFQN4KSFL_cjs.k}});Object.defineProperty(exports,"paginationSnapshotOf",{enumerable:true,get:function(){return chunkFQN4KSFL_cjs.c}});exports.SERVER_AUTOMATION_CAPABILITIES=j;exports.createServerAutomationHost=Y;
+'use strict';var chunkEKLM7NWB_cjs=require('./chunk-EKLM7NWB.cjs');require('./chunk-W35WTWAO.cjs'),require('./chunk-DOHF6FA7.cjs'),require('./chunk-7WQ7AAHW.cjs'),require('./chunk-MM5QBMTE.cjs'),require('./chunk-T6K2QYNZ.cjs'),require('./chunk-UHHYFIDT.cjs'),require('./chunk-OSFOJTHU.cjs');Object.defineProperty(exports,"AUTOMATION_COMMAND_OPERATIONS",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.e}});Object.defineProperty(exports,"AUTOMATION_QUERY_OPERATIONS",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.d}});Object.defineProperty(exports,"AUTOMATION_SOLITARY_OPERATIONS",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.f}});Object.defineProperty(exports,"HEADER_FOOTER_VARIANTS",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.c}});Object.defineProperty(exports,"SERVER_AUTOMATION_CAPABILITIES",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.n}});Object.defineProperty(exports,"byteSizeBucket",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.u}});Object.defineProperty(exports,"countBucket",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.v}});Object.defineProperty(exports,"createAutomationPaginationProvider",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.l}});Object.defineProperty(exports,"createDiagnosticEmitter",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.w}});Object.defineProperty(exports,"createServerAutomationHost",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.o}});Object.defineProperty(exports,"diagnosticCause",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.y}});Object.defineProperty(exports,"diagnosticCauses",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.x}});Object.defineProperty(exports,"diagnosticCodes",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.q}});Object.defineProperty(exports,"diagnosticErrorName",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.A}});Object.defineProperty(exports,"documentPartKind",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.B}});Object.defineProperty(exports,"exceptionCause",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.z}});Object.defineProperty(exports,"explainDiagnostic",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.p}});Object.defineProperty(exports,"isAutomationCommand",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.h}});Object.defineProperty(exports,"isSolitaryAutomationCommand",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.g}});Object.defineProperty(exports,"openDiagnosticCode",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.r}});Object.defineProperty(exports,"paginationSnapshotOf",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.j}});Object.defineProperty(exports,"reviewDiagnosticCode",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.t}});Object.defineProperty(exports,"storeEditDiagnosticCode",{enumerable:true,get:function(){return chunkEKLM7NWB_cjs.s}});

package/dist/automation.d.ts

@@ -1,17 +1,32 @@
-import { A as AutomationOperation, a as AutomationCapabilities, b as AutomationHost } from './protocol-aKYr8r3u.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 AutomationSaveResult, D as AutomationSearchOptions, E as AutomationSelectionMode, F as AutomationSpan, G as AutomationSpanRef, H as AutomationTextProjection, I as AutomationUnsubscribe, J as AutomationValue } from './protocol-aKYr8r3u.js';
-import { c as HeaderFooterVariant, N as NoteKind } from './tree-package-fragment-DYZIk1rY.js';
-import { T as TextMeasurer, S as SemanticLayout } from './semantic-records-B9OolWGN.js';
-import { H as HeadlessDocumentView } from './headless-document-view-ICYqNkQ1.js';
-import { a1 as OoxmlPackageLimits, Y as OoxmlPackageRejection } from './types-barrel-BFKR8Pzp.js';
-export { a2 as RevisionBatchEntry, a3 as RevisionBatchResult, a4 as RevisionBatchSkipReason } from './types-barrel-BFKR8Pzp.js';
+/**
+ * `@docx-editor.dev/core/automation` — the host protocol document automation runs against.
+ *
+ * One interface with two implementations: a headless host owning bytes it opened, and a browser
+ * host borrowing the live editor's session. Both answer the same operations identically, because
+ * the operations are implemented once above this protocol.
+ *
+ * Everything here is transport-shaped — a handle is a NAME, never a pointer — so the same host
+ * works behind a worker port, an HTTP boundary, or nothing at all.
+ *
+ * @packageDocumentation
+ * @public
+ */
+import { A as AutomationOperation, a as AutomationCapabilities, b as AutomationHost } from './protocol-DYzzz2ej.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-DYzzz2ej.js';
+import { c as HeaderFooterVariant, N as NoteKind } from './tree-package-store-CovjNARF.js';
+import { T as TextMeasurer, S as SemanticLayout } from './semantic-records-DQmumPgL.js';
+import { H as HeadlessDocumentView } from './headless-document-view-pp3q7wIh.js';
+import { ao as OoxmlPackageLimits, aj as OoxmlPackageRejection } from './types-barrel-DuC5QBNC.js';
+export { ap as RevisionAuthorEntry, a8 as RevisionAuthorResult, aq as RevisionAuthorSkipReason, ar as RevisionBatchEntry, a9 as RevisionBatchResult, as as RevisionBatchSkipDetail, at as RevisionBatchSkipReason, au as RevisionSiteRefusal } from './types-barrel-DuC5QBNC.js';
 import { CollaborationModuleContribution } from './collaboration.js';
-import './image-resources-BDFxcu7W.js';
-import './revision-projection-CSNFudZY.js';
-import './omml-equation-DuczgG5o.js';
-import './editor-scope-OHPwVQ5l.js';
+import { B as ByteSizeBucket, b as CountBucket, f as DocumentOpenDiagnosticCode, i as ReviewDiagnosticCode, E as EditDiagnosticCode } from './diagnostic-hints-BeVjfNOv.js';
+export { C as CollaborationDiagnosticCode, c as CustomNodeDiagnosticCode, d as DiagnosticCode, D as DiagnosticErrorName, e as DiagnosticExplanation, a as DocumentPartKind, F as FailureStage, g as FontDiagnosticCode, h as FormattingChangeKind, H as HistoryDiagnosticCode, P as PerformanceDiagnosticCode, R as ReviewChangeKind, j as ReviewOperation, k as diagnosticCodes, l as explainDiagnostic } from './diagnostic-hints-BeVjfNOv.js';
+export { a as diagnosticCause, d as diagnosticCauses, b as diagnosticErrorName, c as documentPartKind, e as exceptionCause } from './diagnostic-context-B8M79cfK.js';
+import './image-resources-tXLQShoC.js';
+import './omml-equation-BUbU0utM.js';
+import './editor-scope-7o9xweiJ.js';
 import './collaboration/replication.js';
-import './failure-BIPVQbRm.js';
+import './failure-NS2lsya4.js';
 
 /** The variants a section can declare furniture for. */
 declare const HEADER_FOOTER_VARIANTS: readonly HeaderFooterVariant[];
@@ -50,7 +65,7 @@ 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", "getComments", "getCommentReplies", "getCommentId", "getCommentAuthor", "getCommentDate", "getCommentText", "getCommentRange", "getCommentResolved", "getRevisions", "getRevisionType", "getRevisionAuthor", "getRevisionDate", "getRevisionRange", "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", "setFont", "setParagraphFormat", "setStyle", "setPageSetup", "deleteNote", "setListLevel", "startNewList", "attachToList", "detachFromList", "setListLevelFormat", "insertListParagraph", "setHyperlink", "insertComment", "setCommentResolved", "replyToComment", "deleteComment", "acceptRevision", "rejectRevision", "resolveRevisionBatch", "acceptAllRevisions", "rejectAllRevisions", "setContentControlValue", "setContentControlProperties", "deleteContentControl", "insertContentControlText", "insertContentControl", "insertCustomNode"];
+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", "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.
  *
@@ -64,7 +79,7 @@ declare const AUTOMATION_COMMAND_OPERATIONS: readonly ["removeDocumentInformatio
  * and shares its batch, and some `updateTable` mutations travel alone. Classify one operation
  * with {@link isSolitaryAutomationCommand}, not by membership here.
  */
-declare const AUTOMATION_SOLITARY_OPERATIONS: readonly ["removeDocumentInformation", "insertTableRows", "resolveRevisionBatch", "insertTable", "insertInlinePicture", "insertBreak", "startNewList", "deleteNote", "insertComment", "setCommentResolved", "replyToComment", "insertCustomNode"];
+declare const AUTOMATION_SOLITARY_OPERATIONS: readonly ["removeDocumentInformation", "insertTableRows", "resolveRevisionBatch", "setRevisionAuthorBatch", "insertTable", "insertInlinePicture", "insertBreak", "startNewList", "deleteNote", "insertComment", "setCommentResolved", "replyToComment", "insertCustomNode"];
 /** Whether an operation must be the only one in its batch. */
 declare function isSolitaryAutomationCommand(operation: AutomationOperation): boolean;
 /** Whether an operation writes. Drives the query/command split inside one batch. */
@@ -145,5 +160,50 @@ interface ServerAutomationHostOptions {
  */
 declare function createServerAutomationHost(bytes: Uint8Array, options?: ServerAutomationHostOptions): ServerAutomationHostResult;
 
-export { AUTOMATION_COMMAND_OPERATIONS, AUTOMATION_QUERY_OPERATIONS, AUTOMATION_SOLITARY_OPERATIONS, AutomationCapabilities, AutomationHost, AutomationOperation, HEADER_FOOTER_VARIANTS, SERVER_AUTOMATION_CAPABILITIES, createAutomationPaginationProvider, createServerAutomationHost, isAutomationCommand, isSolitaryAutomationCommand, paginationSnapshotOf };
-export type { AutomationPaginationOptions, AutomationPaginationProvider, AutomationPaginationSnapshot, AutomationStoryId, ServerAutomationHostOptions, ServerAutomationHostRejection, ServerAutomationHostResult };
+/**
+ * Anonymous diagnostics, the neutral half: store reasons → public codes, size and count
+ * buckets, and one delivery path. The browser editor and the headless automation runtime both
+ * build their diagnostics here, so a refusal gets the same public code on either host.
+ *
+ * Only the RESULT of a lookup leaves the engine. A raw reason can be a sentence, and a package
+ * `detail` can name parts of the file, so neither is ever copied into a diagnostic.
+ */
+
+/**
+ * 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`.
+ *
+ * @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, 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 };

package/dist/automation.js

@@ -1 +1 @@
-import {m,g,d}from'./chunk-S74GRBNE.js';export{i as AUTOMATION_COMMAND_OPERATIONS,h as AUTOMATION_QUERY_OPERATIONS,j as AUTOMATION_SOLITARY_OPERATIONS,f as HEADER_FOOTER_VARIANTS,e as createAutomationPaginationProvider,l as isAutomationCommand,k as isSolitaryAutomationCommand,c as paginationSnapshotOf}from'./chunk-S74GRBNE.js';import'./chunk-KAXOGCGA.js';import'./chunk-VIPMGGUT.js';import'./chunk-ZU7IVN6G.js';import'./chunk-6ZQMII6V.js';import {X,Xa,bb,qa,ia,ga,ha}from'./chunk-GWQJ5774.js';import {b,a}from'./chunk-DNXVNQEO.js';import {ne,qb,oe,tb,Fa,og,b as b$1}from'./chunk-UMRSBLO7.js';var j=Object.freeze({document:true,save:true,events:true,selection:false,scrolling:false,layout:false}),D=Object.freeze({kind:"body"});function Y(o,t={}){let m$1=ne(o,t.limits??{});if(!m$1.ok)return {ok:false,reason:m$1.reason,...m$1.limit===void 0?{}:{limit:m$1.limit},...m$1.detail?{detail:m$1.detail}:{}};let p=m$1.package.parts.get(m$1.package.mainDocumentPart);if(!p)return {ok:false,reason:"no-main-document-part",detail:m$1.package.mainDocumentPart};let u=new X(m$1.package,Xa(m$1.package,qb(p))),y=t.collaborationModel?.session,c=()=>{},n=K(u,y,()=>c());if(t.pagination){let i,l=-1,e=t.pagination;n.prepare=async f=>{if(!f.operations.some(s=>s.op==="updateFieldResult"))return;i=void 0;let a=u.packageRevision,d=await e(bb(u));u.packageRevision===a&&(i=d,l=a);},n.fieldPageContext=(f,a,d$1)=>{if(u.packageRevision!==l)return null;let s=g(u.currentPackage()).story(f);return s?d(i,s.part,a,d$1):null};}let r=m({port:n,capabilities:j});return y&&(c=y.attach(b(u,{documentId:y.documentId}))),{ok:true,host:r}}function G(o,t,m){let p=o.partFor(m);return p?Fa(o,()=>{let u=og(o.currentPackage(),t,p.name);return u?(o.replacePackageShell(u.pkg),u.relationshipId):null},u=>u!==null):null}function K(o,t,m=()=>{}){let p=true,u=0,y=()=>t?(u+=1,{origin:t.identity.role==="agent"?b$1.mutationAgent:b$1.mutationHuman,actorId:t.identity.actorId,operationId:`${t.identity.actorId}:${t.sessionId}:automation:${u}`,recordsHistory:false}):{},c=n=>(t?.flushPendingJournals(),n);return {localChangeTracking:true,collaborative:()=>!!t,revision:()=>o.packageRevision,currentPackage:()=>p?o.currentPackage():null,apply(n,r=D,i=[]){if(!p)return {ok:false,reason:"disposed"};let l=n(d=>tb(t?.identity.actorId,()=>G(o,d,r)));if(l===null)return {ok:false,reason:"unsupported-target"};let e=t?.gateOperations(l,r);if(e)return {ok:false,reason:e};let f=t?o.partFor(r)?.name:void 0,a$1=o.transact(r,d=>{for(let s of i)d.applyPackage(s);for(let s of l)d.apply(s);f&&d.applyPackage(s=>a(s,f,l));},y());return a$1.ok?c({ok:true,changed:a$1.change!==null}):{ok:false,reason:a$1.detail?`${a$1.reason}: ${a$1.detail}`:a$1.reason}},applyLifecycle(n){if(!p)return {ok:false,reason:"disposed"};let r=t?.gateOperations([n],D);if(r)return {ok:false,reason:r};let i=tb(t?.identity.actorId,()=>o.applyLifecycleOp(n));return i.ok?c({ok:true,changed:i.change!==null}):{ok:false,reason:i.detail?`${i.reason}: ${i.detail}`:i.reason}},applyCommentWrites(n,r){if(!p)return {ok:false,reason:"disposed"};if(n.length===0)return {ok:true,changed:false};let i=t?.gateOperations([],r);if(i)return {ok:false,reason:i};let l=o.resolveStory(r);if(!l.ok)return {ok:false,reason:l.reason};if(l.store.graftPackage(()=>o.currentPackage()),n.every(a=>a.kind==="delete")){let a=n.find(s=>s.kind==="delete"),d=tb(t?.identity.actorId,()=>ia(o,n.flatMap(s=>s.kind==="delete"?[{commentId:s.commentId,...s.parentCommentId===void 0?{}:{parentCommentId:s.parentCommentId}}]:[]),r,a?.kind==="delete"?a.noteId:void 0));return d?c({ok:true,changed:d}):{ok:false,reason:"comment-delete-refused"}}if(n.length!==1)return {ok:false,reason:"mixed-comment-writes"};let e=n[0];if(e.kind==="create"||e.kind==="reply"){let a=tb(t?.identity.actorId,()=>ga(o,{anchor:e.anchor,author:e.author,text:e.text,...e.date===void 0?{}:{date:e.date},...e.kind==="reply"?{replyToCommentId:e.parentCommentId}:{}},r));return a.ok?c({ok:true,changed:true,..."commentId"in a?{commentId:a.commentId}:{}}):{ok:false,reason:a.reason}}if(e.kind!=="resolve")return {ok:false,reason:"unsupported-comment-write"};let f=tb(t?.identity.actorId,()=>ha(o,e.commentId,e.resolved));return f.ok?c({ok:true,changed:true}):{ok:false,reason:f.reason}},applyCustomNodeWrite(n,r){if(!p)return {ok:false,reason:"disposed"};let i=t?.gateOperations([],r);if(i)return {ok:false,reason:i};let l=o.resolveStory(r);if(!l.ok)return {ok:false,reason:l.reason};let e=tb(t?.identity.actorId,()=>qa(o,n,r));return e.ok?c({ok:true,changed:e.change!==null}):{ok:false,reason:e.detail?`${e.reason}: ${e.detail}`:e.reason}},save:()=>p?oe(o.currentPackage()):null,subscribe:n=>o.subscribe(()=>n()),dispose(){m(),p=false;}}}export{j as SERVER_AUTOMATION_CAPABILITIES,Y as createServerAutomationHost};
+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,u as byteSizeBucket,v as countBucket,l as createAutomationPaginationProvider,w as createDiagnosticEmitter,o as createServerAutomationHost,y as diagnosticCause,x as diagnosticCauses,q as diagnosticCodes,A as diagnosticErrorName,B as documentPartKind,z as exceptionCause,p as explainDiagnostic,h as isAutomationCommand,g as isSolitaryAutomationCommand,r as openDiagnosticCode,j as paginationSnapshotOf,t as reviewDiagnosticCode,s as storeEditDiagnosticCode}from'./chunk-LQX36Z5P.js';import'./chunk-E4LOMDNL.js';import'./chunk-CPWLFPWC.js';import'./chunk-RCLZXP3B.js';import'./chunk-LSZ6KPKK.js';import'./chunk-U4JZVSOE.js';import'./chunk-OMCG63ZF.js';import'./chunk-YQ5G6LC7.js';

package/dist/binding.cjs

@@ -1 +1 @@
-'use strict';var chunkCWRBFNK5_cjs=require('./chunk-CWRBFNK5.cjs');require('./chunk-LZLTN5A3.cjs'),require('./chunk-2GK7YQB2.cjs'),require('./chunk-K246T47S.cjs'),require('./chunk-AVKVRU7Z.cjs'),require('./chunk-GVUOWHTO.cjs'),require('./chunk-4KZ6L5YF.cjs');Object.defineProperty(exports,"PROJECTION_ORIGIN",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.k}});Object.defineProperty(exports,"bodyParagraphs",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.c}});Object.defineProperty(exports,"docToTreeOps",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.f}});Object.defineProperty(exports,"mountTreeSurface",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.l}});Object.defineProperty(exports,"openTreeSession",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.j}});Object.defineProperty(exports,"partHasNode",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.g}});Object.defineProperty(exports,"reconcileDoc",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.h}});Object.defineProperty(exports,"runPropsOf",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.b}});Object.defineProperty(exports,"treeSchema",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.a}});Object.defineProperty(exports,"treeToDoc",{enumerable:true,get:function(){return chunkCWRBFNK5_cjs.e}});
+'use strict';var chunk6JPL6ZAS_cjs=require('./chunk-6JPL6ZAS.cjs');require('./chunk-BY2ACZZ6.cjs'),require('./chunk-7WQ7AAHW.cjs'),require('./chunk-MM5QBMTE.cjs'),require('./chunk-T6K2QYNZ.cjs'),require('./chunk-UHHYFIDT.cjs'),require('./chunk-OSFOJTHU.cjs');Object.defineProperty(exports,"PROJECTION_ORIGIN",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.l}});Object.defineProperty(exports,"bodyParagraphs",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.c}});Object.defineProperty(exports,"docToTreeOps",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.f}});Object.defineProperty(exports,"mountTreeSurface",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.m}});Object.defineProperty(exports,"openTreeSession",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.j}});Object.defineProperty(exports,"partHasNode",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.g}});Object.defineProperty(exports,"reconcileDoc",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.h}});Object.defineProperty(exports,"runPropsOf",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.b}});Object.defineProperty(exports,"treeSchema",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.a}});Object.defineProperty(exports,"treeToDoc",{enumerable:true,get:function(){return chunk6JPL6ZAS_cjs.e}});

package/dist/binding.d.ts

@@ -1,18 +1,35 @@
+/**
+ * `@docx-editor.dev/core/binding` — the canonical tree ↔ ProseMirror binding.
+ *
+ * Forward: project one revision of the tree into a ProseMirror doc. Reverse: explain an edited
+ * doc as the smallest set of tree ops, or REFUSE. The reverse direction never reconstructs the
+ * tree from the projection, so anything the projection does not model stays carried by the tree.
+ *
+ * @packageDocumentation
+ * @public
+ */
 import { Node, Schema } from 'prosemirror-model';
-import { X as OoxmlProperty, Y as OoxmlPackageRejection } from './types-barrel-BFKR8Pzp.js';
-import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-DQVJOOkv.js';
-export { D as DocumentStyleEntry, M as MapResult, 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-DQVJOOkv.js';
+import { ah as OoxmlProperty, ai as OoxmlPackageResult, aj as OoxmlPackageRejection } from './types-barrel-DuC5QBNC.js';
+import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-CZVAGl51.js';
+export { D as DocumentStyleEntry, M as MapResult, 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-CZVAGl51.js';
 import { ReviewModuleContribution } from './contracts/modules.js';
-export { S as StoryScope, a as StoryTargetRejection } from './tree-package-fragment-DYZIk1rY.js';
+export { S as StoryScope, a as StoryTargetRejection } from './tree-package-store-CovjNARF.js';
 import { EditorView } from 'prosemirror-view';
-import './editor-scope-OHPwVQ5l.js';
-import './image-resources-BDFxcu7W.js';
-import './custom-node-writes-Vzpq9I8_.js';
-import './headless-document-view-ICYqNkQ1.js';
+import './editor-scope-7o9xweiJ.js';
+import './image-resources-tXLQShoC.js';
+import './custom-node-writes-Bn6uciLb.js';
+import './headless-document-view-pp3q7wIh.js';
 import './collaboration/replication.js';
-import './revision-projection-CSNFudZY.js';
+import './semantic-records-DQmumPgL.js';
+import './omml-equation-BUbU0utM.js';
+import './editor-CZQZmTIU.js';
+import './contracts/document.js';
+import './contracts/interaction.js';
+import './semantic-interaction-kR_QB845.js';
+import './document-protection-CUb55pl_.js';
+import './failure-NS2lsya4.js';
+import './diagnostic-hints-BeVjfNOv.js';
 import './collaboration.js';
-import './failure-BIPVQbRm.js';
 
 /** Attributes carried by a projected paragraph. */
 interface ParagraphAttrs {
@@ -75,9 +92,11 @@ type TreeSessionRejection = OoxmlPackageRejection | 'no-main-document-tree';
 type OpenTreeSessionResult = {
     readonly ok: true;
     readonly session: TreeDocxSession;
-} | {
+} | Extract<OoxmlPackageResult, {
+    readonly ok: false;
+}> | {
     readonly ok: false;
-    readonly reason: TreeSessionRejection;
+    readonly reason: 'no-main-document-tree';
     readonly detail?: string;
 };
 interface OpenTreeSessionOptions {

package/dist/binding.js

@@ -1 +1 @@
-export{k as PROJECTION_ORIGIN,c as bodyParagraphs,f as docToTreeOps,l as mountTreeSurface,j as openTreeSession,g as partHasNode,h as reconcileDoc,b as runPropsOf,a as treeSchema,e as treeToDoc}from'./chunk-7MYITTAH.js';import'./chunk-HAQ72KD7.js';import'./chunk-ZU7IVN6G.js';import'./chunk-6ZQMII6V.js';import'./chunk-GWQJ5774.js';import'./chunk-DNXVNQEO.js';import'./chunk-UMRSBLO7.js';
+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-BCXH4BXB.js';import'./chunk-G4HOFIKJ.js';import'./chunk-RCLZXP3B.js';import'./chunk-LSZ6KPKK.js';import'./chunk-U4JZVSOE.js';import'./chunk-OMCG63ZF.js';import'./chunk-YQ5G6LC7.js';