@docx-editor.dev/core 2.20.0 → 2.21.1

package/README.md

@@ -13,71 +13,60 @@
 
 # @docx-editor.dev/core
 
-The engine behind [docx-editor.dev](https://docx-editor.dev). It reads a `.docx` into a
-canonical document tree, lays that tree out into pages, paints them, and writes the tree back
-to OOXML. No framework dependency and no UI.
+The engine behind [docx-editor.dev](https://docx-editor.dev). It reads a `.docx` into a canonical document tree, lays that tree out into pages, paints them, and writes the tree back to OOXML. No framework dependency and no UI.
 
-Most apps never install this directly — [`@docx-editor.dev/react`](https://www.npmjs.com/package/@docx-editor.dev/react)
-carries it. Reach for it when you are writing your own adapter, or when you need the contract
-types to write a function signature.
+Install this package alongside the React or Vue adapter. Both adapters require it as a peer dependency. You can also use its public contracts to build your own adapter.
 
 ```bash
 npm install @docx-editor.dev/core
 ```
 
-Node use requires `^20.16.0 || >=22.3.0`.
+Node.js requires `^20.16.0 || >=22.3.0`.
 
 ## Entry points
 
+Import editor creation, font helpers, and contract types from the package root:
+
 ```ts
 import { createDocxEditor, loadFonts, WORD_DEFAULT_FONT } from '@docx-editor.dev/core';
 import type { Editor, EditorSnapshot } from '@docx-editor.dev/core';
 ```
 
-The root covers most uses: creating an editor, the `Editor` contract it implements, fonts,
-the chrome registry, and the document model types. Subpaths expose the canonical tree, the
-layout pass, and the paint step directly.
-
-| Subpath                       | What's there                                                                                 |
-| ----------------------------- | -------------------------------------------------------------------------------------------- |
-| `.`                           | Create an editor, the contract, fonts, the chrome registry, the document model.              |
-| `./editor`                    | Everything the root re-exports, plus the paginated surface and ruler geometry.               |
-| `./contracts/editor`          | `Editor`, `EditorCommand`, `EditorQuery`, `EditorSnapshot`, `PageSetup`.                     |
-| `./contracts/document`        | The document-level edit and query vocabulary.                                                |
-| `./contracts/interaction`     | Semantic addressing (`SemanticTarget`) and the `InteractionOutcome` an attempt answers with. |
-| `./contracts/types`           | Document model types.                                                                        |
-| `./contracts/modules`         | `EditorModule` — the shape `@docx-editor.dev/pro` implements.                                |
-| `./store`                     | The canonical tree and its transactional store.                                              |
-| `./layout`                    | The DOM-free layout pass.                                                                    |
-| `./output`                    | Serialization.                                                                               |
-| `./export`                    | Document layout sessions for exporters. No DOM required.                                     |
-| `./automation`                | The object model behind `@docx-editor.dev/editor-api`.                                       |
-| `./collaboration`             | Provider-neutral collaboration session contracts.                                            |
-| `./collaboration/replication` | Replication helpers for collaboration providers.                                             |
-| `./styles/editor.css`         | The one editor stylesheet, shared by packaged and custom chrome.                             |
+The root covers most uses: creating an editor, the `Editor` contract it implements, fonts, the chrome registry, and the document model types. Subpaths expose the canonical tree, the layout pass, and the paint step directly.
+
+| Subpath | What's there |
+| --- | --- |
+| `.` | Create an editor, the contract, fonts, the chrome registry, the document model. |
+| `./editor` | Everything the root re-exports, plus the paginated surface and ruler geometry. |
+| `./contracts/editor` | `Editor`, `EditorCommand`, `EditorQuery`, `EditorSnapshot`, `PageSetup`. |
+| `./contracts/document` | The document-level edit and query vocabulary. |
+| `./contracts/interaction` | Semantic addressing (`SemanticTarget`) and the `InteractionOutcome` an attempt answers with. |
+| `./contracts/types` | Document model types. |
+| `./contracts/modules` | `EditorModule` — the shape `@docx-editor.dev/pro` implements. |
+| `./store` | The canonical tree and its transactional store. |
+| `./layout` | The DOM-free layout pass. |
+| `./output` | Paint layouts and selection overlays into the DOM. |
+| `./export` | Document layout sessions for exporters. No DOM required. |
+| `./automation` | The object model behind `@docx-editor.dev/editor-api`. |
+| `./collaboration` | Provider-neutral collaboration session contracts. |
+| `./collaboration/replication` | Replication helpers for collaboration providers. |
+| `./styles/editor.css` | The one editor stylesheet, shared by packaged and custom chrome. |
 
 ## Architecture
 
-```
-bytes → bounded OPC/XML read → canonical OOXML tree → layout → painted pages → serialize
-```
+The engine reads DOCX bytes into a canonical OOXML tree. Layout reads the tree and produces painted pages. Saving serializes the tree back into a DOCX package.
 
-There is one document model. The painted pages are the editable surface: they are
-`contenteditable`, but the DOM is a picture. Browser mutations are prevented and re-expressed
-as tree operations, so the browser never invents markup inside your document.
+There is one document model. The painted pages are the editable surface: they are `contenteditable`, but the DOM is a picture. Browser mutations are prevented and re-expressed as tree operations, so the browser never invents markup inside your document.
 
-Nodes are typed where layout needs them and generic everywhere else, preserving the element
-verbatim. Content the engine does not model is carried rather than dropped, so a document full
-of unknown extensions still opens, edits, and saves.
+Nodes are typed where layout needs them and generic everywhere else, preserving the element structure. Content the engine does not model is carried rather than dropped, so a document full of unknown extensions still opens, edits, and saves.
 
-Export sessions default to `all-markup`, which shows inserted and deleted text.
-Use `displayMode: 'proposed'` for the accepted view or `displayMode: 'original'` for the rejected view.
+Export sessions default to `all-markup`, which shows inserted and deleted text. Use `displayMode: 'proposed'` for the accepted view or `displayMode: 'original'` for the rejected view.
 
 ### Build a paginated exporter
 
-For exports that need accurate page breaks, use `openFontBackedDocumentForExport`. It resolves
-the fonts used throughout the document before layout. Without a measurer,
-`openDocumentForExport(bytes)` uses a fixed-width approximation.
+For exports that need font-based page breaks, use `openFontBackedDocumentForExport`. It resolves the fonts used throughout the document before layout. Without a measurer, `openDocumentForExport(bytes)` uses a fixed-width approximation.
+
+Install `@docx-editor.dev/fonts` to use packaged substitutes in this example:
 
 ```ts
 import { readFile } from 'node:fs/promises';
@@ -86,41 +75,31 @@ import { packagedFonts } from '@docx-editor.dev/fonts';
 
 const bytes = new Uint8Array(await readFile('contract.docx'));
 const opened = await openFontBackedDocumentForExport(bytes, {
-  // First wins: put caller-supplied licensed fonts first, bundled metric substitutes next,
-  // and an optional network resolver last.
-  fonts: [callerFonts, packagedFonts(), optionalNetworkFonts],
+  fonts: packagedFonts(),
   fontPolicy: 'strict',
-  onFontResolution: (report) => auditLogger.info(report),
+  onFontResolution: (report) => console.info(report),
 });
 
 if (!opened.ok) throw new Error(`DOCX rejected: ${opened.reason}`);
 try {
   const layout = await opened.session.layout();
-  await writeExporterOutput(layout);
+  console.log(layout); // Replace this with your exporter.
 } finally {
   opened.session.dispose(); // releases document-owned shaping bytes
 }
 ```
 
-Let Core manage fonts, resources, and layout. Build your output from the returned pages.
-For a live `HeadlessDocumentView`, pass the editor's revision-stable measurer.
+Let the engine manage fonts, resources, and layout. Build your output from the returned pages. For a live `HeadlessDocumentView`, pass the editor's revision-stable measurer.
 
 ## Fidelity
 
-Untouched content, unsupported OOXML, and package payloads survive editing and save. The
-canonical tree preserves document structure while embedded fonts, macros, media, and other
-payloads pass through untouched. Two oracles gate this in CI: a canonical fingerprint over the
-tree, and a save-and-reopen semantic digest.
+Untouched content, unsupported OOXML, and package payloads survive editing and save. The canonical tree preserves document structure while embedded fonts, macros, media, and other payloads pass through untouched. Two oracles gate this in CI: a canonical fingerprint over the tree, and a save-and-reopen semantic digest.
 
 ## Untrusted input
 
-A `.docx` is a zip of XML that whoever sent it controls end to end. The engine sanitizes at the
-parse boundary: URL allowlisting, entity and zip-bomb limits, recursion and element caps, no
-zero-click external fetches, escaping on the way back out.
+Treat DOCX files as untrusted input. The engine validates URLs and limits XML entities, archive expansion, nesting, and element counts. It does not automatically fetch external document relationships. Serialization escapes document text.
 
-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.
+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.
 
 ## Documentation
 

package/dist/automation.cjs

@@ -1 +1 @@
-'use strict';var chunkD2V4YBWJ_cjs=require('./chunk-D2V4YBWJ.cjs');require('./chunk-GSEUM6AI.cjs'),require('./chunk-I6LSEDUL.cjs'),require('./chunk-2HQXLL5L.cjs'),require('./chunk-FGBADUSK.cjs');var chunkK5HIOS6J_cjs=require('./chunk-K5HIOS6J.cjs'),chunkCEXC2VHI_cjs=require('./chunk-CEXC2VHI.cjs'),chunkDGSJZMAE_cjs=require('./chunk-DGSJZMAE.cjs');var D=Object.freeze({document:true,save:true,events:true,selection:false,scrolling:false,layout:false}),_=Object.freeze({kind:"body"});function V(o,t={}){let m=chunkDGSJZMAE_cjs.dc(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 chunkK5HIOS6J_cjs.O(m.package,chunkDGSJZMAE_cjs.Kb(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(chunkK5HIOS6J_cjs.$a(u));u.packageRevision===a&&(i=d,l=a);},n.fieldPageContext=(f,a,d)=>{if(u.packageRevision!==l)return null;let s=chunkD2V4YBWJ_cjs.e(u.currentPackage()).story(f);return s?chunkD2V4YBWJ_cjs.b(i,s.part,a,d):null};}let r=chunkD2V4YBWJ_cjs.k({port:n,capabilities:D});return y&&(c=y.attach(chunkCEXC2VHI_cjs.b(u,{documentId:y.documentId}))),{ok:true,host:r}}function Y(o,t,m){let p=o.partFor(m);return p?chunkDGSJZMAE_cjs.Ba(o,()=>{let u=chunkDGSJZMAE_cjs.sf(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"?chunkDGSJZMAE_cjs.b.mutationAgent:chunkDGSJZMAE_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,revision:()=>o.packageRevision,currentPackage:()=>p?o.currentPackage():null,apply(n,r=_,i=[]){if(!p)return {ok:false,reason:"disposed"};let l=n(d=>chunkDGSJZMAE_cjs.Mb(t?.identity.actorId,()=>Y(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=>chunkCEXC2VHI_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],_);if(r)return {ok:false,reason:r};let i=chunkDGSJZMAE_cjs.Mb(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=chunkDGSJZMAE_cjs.Mb(t?.identity.actorId,()=>chunkK5HIOS6J_cjs.$(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=chunkDGSJZMAE_cjs.Mb(t?.identity.actorId,()=>chunkK5HIOS6J_cjs.Z(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=chunkDGSJZMAE_cjs.Mb(t?.identity.actorId,()=>chunkK5HIOS6J_cjs._(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=chunkDGSJZMAE_cjs.Mb(t?.identity.actorId,()=>chunkK5HIOS6J_cjs.ha(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?chunkDGSJZMAE_cjs.ec(o.currentPackage()):null,subscribe:n=>o.subscribe(()=>n()),dispose(){m(),p=false;}}}Object.defineProperty(exports,"AUTOMATION_COMMAND_OPERATIONS",{enumerable:true,get:function(){return chunkD2V4YBWJ_cjs.g}});Object.defineProperty(exports,"AUTOMATION_QUERY_OPERATIONS",{enumerable:true,get:function(){return chunkD2V4YBWJ_cjs.f}});Object.defineProperty(exports,"AUTOMATION_SOLITARY_OPERATIONS",{enumerable:true,get:function(){return chunkD2V4YBWJ_cjs.h}});Object.defineProperty(exports,"HEADER_FOOTER_VARIANTS",{enumerable:true,get:function(){return chunkD2V4YBWJ_cjs.d}});Object.defineProperty(exports,"createAutomationPaginationProvider",{enumerable:true,get:function(){return chunkD2V4YBWJ_cjs.c}});Object.defineProperty(exports,"isAutomationCommand",{enumerable:true,get:function(){return chunkD2V4YBWJ_cjs.j}});Object.defineProperty(exports,"isSolitaryAutomationCommand",{enumerable:true,get:function(){return chunkD2V4YBWJ_cjs.i}});Object.defineProperty(exports,"paginationSnapshotOf",{enumerable:true,get:function(){return chunkD2V4YBWJ_cjs.a}});exports.SERVER_AUTOMATION_CAPABILITIES=D;exports.createServerAutomationHost=V;
+'use strict';var chunk7N77EN2Z_cjs=require('./chunk-7N77EN2Z.cjs');require('./chunk-AGWWNVIJ.cjs'),require('./chunk-QBKAOSVF.cjs'),require('./chunk-RA2TDTEQ.cjs'),require('./chunk-FGBADUSK.cjs');var chunkDFTVN25X_cjs=require('./chunk-DFTVN25X.cjs'),chunk4TYA4RLP_cjs=require('./chunk-4TYA4RLP.cjs'),chunkZZRCVDQU_cjs=require('./chunk-ZZRCVDQU.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=chunkZZRCVDQU_cjs.ec(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 chunkDFTVN25X_cjs.O(m.package,chunkDFTVN25X_cjs.Za(m.package,chunkZZRCVDQU_cjs.Lb(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(chunkDFTVN25X_cjs.ab(u));u.packageRevision===a&&(i=d,l=a);},n.fieldPageContext=(f,a,d)=>{if(u.packageRevision!==l)return null;let s=chunk7N77EN2Z_cjs.e(u.currentPackage()).story(f);return s?chunk7N77EN2Z_cjs.b(i,s.part,a,d):null};}let r=chunk7N77EN2Z_cjs.k({port:n,capabilities:j});return y&&(c=y.attach(chunk4TYA4RLP_cjs.b(u,{documentId:y.documentId}))),{ok:true,host:r}}function G(o,t,m){let p=o.partFor(m);return p?chunkZZRCVDQU_cjs.Ca(o,()=>{let u=chunkZZRCVDQU_cjs.zf(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"?chunkZZRCVDQU_cjs.b.mutationAgent:chunkZZRCVDQU_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,revision:()=>o.packageRevision,currentPackage:()=>p?o.currentPackage():null,apply(n,r=D,i=[]){if(!p)return {ok:false,reason:"disposed"};let l=n(d=>chunkZZRCVDQU_cjs.Nb(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=>chunk4TYA4RLP_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=chunkZZRCVDQU_cjs.Nb(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=chunkZZRCVDQU_cjs.Nb(t?.identity.actorId,()=>chunkDFTVN25X_cjs.$(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=chunkZZRCVDQU_cjs.Nb(t?.identity.actorId,()=>chunkDFTVN25X_cjs.Z(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=chunkZZRCVDQU_cjs.Nb(t?.identity.actorId,()=>chunkDFTVN25X_cjs._(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=chunkZZRCVDQU_cjs.Nb(t?.identity.actorId,()=>chunkDFTVN25X_cjs.ha(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?chunkZZRCVDQU_cjs.fc(o.currentPackage()):null,subscribe:n=>o.subscribe(()=>n()),dispose(){m(),p=false;}}}Object.defineProperty(exports,"AUTOMATION_COMMAND_OPERATIONS",{enumerable:true,get:function(){return chunk7N77EN2Z_cjs.g}});Object.defineProperty(exports,"AUTOMATION_QUERY_OPERATIONS",{enumerable:true,get:function(){return chunk7N77EN2Z_cjs.f}});Object.defineProperty(exports,"AUTOMATION_SOLITARY_OPERATIONS",{enumerable:true,get:function(){return chunk7N77EN2Z_cjs.h}});Object.defineProperty(exports,"HEADER_FOOTER_VARIANTS",{enumerable:true,get:function(){return chunk7N77EN2Z_cjs.d}});Object.defineProperty(exports,"createAutomationPaginationProvider",{enumerable:true,get:function(){return chunk7N77EN2Z_cjs.c}});Object.defineProperty(exports,"isAutomationCommand",{enumerable:true,get:function(){return chunk7N77EN2Z_cjs.j}});Object.defineProperty(exports,"isSolitaryAutomationCommand",{enumerable:true,get:function(){return chunk7N77EN2Z_cjs.i}});Object.defineProperty(exports,"paginationSnapshotOf",{enumerable:true,get:function(){return chunk7N77EN2Z_cjs.a}});exports.SERVER_AUTOMATION_CAPABILITIES=j;exports.createServerAutomationHost=Y;

package/dist/automation.d.ts

@@ -1,14 +1,15 @@
-import { A as AutomationCapabilities, a as AutomationHost } from './protocol-CsawNZkt.js';
-export { b as AUTOMATION_COMMAND_OPERATIONS, c as AUTOMATION_QUERY_OPERATIONS, d as AUTOMATION_SOLITARY_OPERATIONS, e as AutomationAlignment, f as AutomationBatchRequest, g as AutomationBatchResponse, h as AutomationChangeEvent, i as AutomationContentControlLock, j as AutomationContentControlRangeLocation, k as AutomationContentControlScope, l as AutomationContentControlSubtype, m as AutomationContentControlValue, n as AutomationError, o as AutomationErrorCode, p as AutomationFontRead, q as AutomationFontWrite, r as AutomationHandle, s as AutomationHandleRef, t as AutomationObjectKind, u as AutomationOperation, v as AutomationOperationKind, w as AutomationOperationResult, x as AutomationPageOrientation, y as AutomationPageSetupRead, z as AutomationPageSetupWrite, B as AutomationParagraphFormatRead, C as AutomationParagraphFormatWrite, D as AutomationParagraphRef, E as AutomationPoint, F as AutomationSaveResult, G as AutomationSearchOptions, H as AutomationSelectionMode, I as AutomationSpan, J as AutomationSpanRef, K as AutomationTextProjection, L as AutomationUnsubscribe, M as AutomationValue, N as isAutomationCommand, O as isSolitaryAutomationCommand } from './protocol-CsawNZkt.js';
-import { H as HeaderFooterVariant, N as NoteKind } from './note-lifecycle-D4AOFCAt.js';
-import { T as TextMeasurer, S as SemanticLayout } from './semantic-records-CbXwnS80.js';
-import { H as HeadlessDocumentView } from './headless-document-view-DHKMN_3Y.js';
-import { X as OoxmlPackageLimits, Y as OoxmlPackageRejection } from './types-barrel-CEOy-Jv0.js';
-export { Z as RevisionBatchEntry, _ as RevisionBatchResult, $ as RevisionBatchSkipReason } from './types-barrel-CEOy-Jv0.js';
+import { A as AutomationCapabilities, a as AutomationHost } from './protocol-CrbTIW2Z.js';
+export { b as AUTOMATION_COMMAND_OPERATIONS, c as AUTOMATION_QUERY_OPERATIONS, d as AUTOMATION_SOLITARY_OPERATIONS, e as AutomationAlignment, f as AutomationBatchRequest, g as AutomationBatchResponse, h as AutomationChangeEvent, i as AutomationContentControlLock, j as AutomationContentControlRangeLocation, k as AutomationContentControlScope, l as AutomationContentControlSubtype, m as AutomationContentControlValue, n as AutomationError, o as AutomationErrorCode, p as AutomationFontRead, q as AutomationFontWrite, r as AutomationHandle, s as AutomationHandleRef, t as AutomationObjectKind, u as AutomationOperation, v as AutomationOperationKind, w as AutomationOperationResult, x as AutomationPageOrientation, y as AutomationPageSetupRead, z as AutomationPageSetupWrite, B as AutomationParagraphFormatRead, C as AutomationParagraphFormatWrite, D as AutomationParagraphRef, E as AutomationPoint, F as AutomationSaveResult, G as AutomationSearchOptions, H as AutomationSelectionMode, I as AutomationSpan, J as AutomationSpanRef, K as AutomationTextProjection, L as AutomationUnsubscribe, M as AutomationValue, N as isAutomationCommand, O as isSolitaryAutomationCommand } from './protocol-CrbTIW2Z.js';
+import { H as HeaderFooterVariant, N as NoteKind } from './tree-package-fragment-CpEV1gl3.js';
+import { T as TextMeasurer, S as SemanticLayout } from './semantic-records-StH-AnHK.js';
+import { H as HeadlessDocumentView } from './headless-document-view-C3fc_jV0.js';
+import { X as OoxmlPackageLimits, Y as OoxmlPackageRejection } from './types-barrel-PwcfEkaX.js';
+export { Z as RevisionBatchEntry, _ as RevisionBatchResult, $ as RevisionBatchSkipReason } from './types-barrel-PwcfEkaX.js';
 import { CollaborationModuleContribution } from './collaboration.js';
-import './image-resources-C51LuAAu.js';
-import './revision-projection-BcRnC4Yj.js';
-import './omml-equation-C5P6Ym3v.js';
+import './image-resources-DxF-SN_8.js';
+import './revision-projection-kVd7p6Wd.js';
+import './omml-equation-Bk3OP1fv.js';
+import './editor-scope-OHPwVQ5l.js';
 import './collaboration/replication.js';
 import './failure-DNNmwsgD.js';
 

package/dist/automation.js

@@ -1 +1 @@
-import {k,e,b as b$1}from'./chunk-7VMVDRRU.js';export{g as AUTOMATION_COMMAND_OPERATIONS,f as AUTOMATION_QUERY_OPERATIONS,h as AUTOMATION_SOLITARY_OPERATIONS,d as HEADER_FOOTER_VARIANTS,c as createAutomationPaginationProvider,j as isAutomationCommand,i as isSolitaryAutomationCommand,a as paginationSnapshotOf}from'./chunk-7VMVDRRU.js';import'./chunk-6UCDHGXI.js';import'./chunk-H6WDEAOJ.js';import'./chunk-P4TGGDK3.js';import'./chunk-VP7SDFCM.js';import {O,$a,ha,$,Z,_ as _$1}from'./chunk-KLQXP27K.js';import {b,a}from'./chunk-IW35GWJN.js';import {dc,Kb,ec,Mb,Ba,sf,b as b$2}from'./chunk-CF3JR35B.js';var D=Object.freeze({document:true,save:true,events:true,selection:false,scrolling:false,layout:false}),_=Object.freeze({kind:"body"});function V(o,t={}){let m=dc(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 O(m.package,Kb(p)),y=t.collaborationModel?.session,c=()=>{},n=K(u,y,()=>c());if(t.pagination){let i,l=-1,e$1=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$1($a(u));u.packageRevision===a&&(i=d,l=a);},n.fieldPageContext=(f,a,d)=>{if(u.packageRevision!==l)return null;let s=e(u.currentPackage()).story(f);return s?b$1(i,s.part,a,d):null};}let r=k({port:n,capabilities:D});return y&&(c=y.attach(b(u,{documentId:y.documentId}))),{ok:true,host:r}}function Y(o,t,m){let p=o.partFor(m);return p?Ba(o,()=>{let u=sf(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$2.mutationAgent:b$2.mutationHuman,actorId:t.identity.actorId,operationId:`${t.identity.actorId}:${t.sessionId}:automation:${u}`,recordsHistory:false}):{},c=n=>(t?.flushPendingJournals(),n);return {localChangeTracking:true,revision:()=>o.packageRevision,currentPackage:()=>p?o.currentPackage():null,apply(n,r=_,i=[]){if(!p)return {ok:false,reason:"disposed"};let l=n(d=>Mb(t?.identity.actorId,()=>Y(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],_);if(r)return {ok:false,reason:r};let i=Mb(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=Mb(t?.identity.actorId,()=>$(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=Mb(t?.identity.actorId,()=>Z(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=Mb(t?.identity.actorId,()=>_$1(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=Mb(t?.identity.actorId,()=>ha(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?ec(o.currentPackage()):null,subscribe:n=>o.subscribe(()=>n()),dispose(){m(),p=false;}}}export{D as SERVER_AUTOMATION_CAPABILITIES,V as createServerAutomationHost};
+import {k,e,b as b$1}from'./chunk-25OQBAKA.js';export{g as AUTOMATION_COMMAND_OPERATIONS,f as AUTOMATION_QUERY_OPERATIONS,h as AUTOMATION_SOLITARY_OPERATIONS,d as HEADER_FOOTER_VARIANTS,c as createAutomationPaginationProvider,j as isAutomationCommand,i as isSolitaryAutomationCommand,a as paginationSnapshotOf}from'./chunk-25OQBAKA.js';import'./chunk-XRYSPKKC.js';import'./chunk-JL3SI5SZ.js';import'./chunk-DZYKU2HG.js';import'./chunk-VP7SDFCM.js';import {O,Za,ab,ha,$,Z,_}from'./chunk-3P3DNJYM.js';import {b,a}from'./chunk-BF2TOG2V.js';import {ec,Lb,fc,Nb,Ca,zf,b as b$2}from'./chunk-3B3DQMSL.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=ec(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 O(m.package,Za(m.package,Lb(p))),y=t.collaborationModel?.session,c=()=>{},n=K(u,y,()=>c());if(t.pagination){let i,l=-1,e$1=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$1(ab(u));u.packageRevision===a&&(i=d,l=a);},n.fieldPageContext=(f,a,d)=>{if(u.packageRevision!==l)return null;let s=e(u.currentPackage()).story(f);return s?b$1(i,s.part,a,d):null};}let r=k({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?Ca(o,()=>{let u=zf(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$2.mutationAgent:b$2.mutationHuman,actorId:t.identity.actorId,operationId:`${t.identity.actorId}:${t.sessionId}:automation:${u}`,recordsHistory:false}):{},c=n=>(t?.flushPendingJournals(),n);return {localChangeTracking:true,revision:()=>o.packageRevision,currentPackage:()=>p?o.currentPackage():null,apply(n,r=D,i=[]){if(!p)return {ok:false,reason:"disposed"};let l=n(d=>Nb(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=Nb(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=Nb(t?.identity.actorId,()=>$(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=Nb(t?.identity.actorId,()=>Z(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=Nb(t?.identity.actorId,()=>_(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=Nb(t?.identity.actorId,()=>ha(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?fc(o.currentPackage()):null,subscribe:n=>o.subscribe(()=>n()),dispose(){m(),p=false;}}}export{j as SERVER_AUTOMATION_CAPABILITIES,Y as createServerAutomationHost};

package/dist/binding.cjs

@@ -1 +1 @@
-'use strict';var chunk44SIVFJT_cjs=require('./chunk-44SIVFJT.cjs');require('./chunk-WTILOUPG.cjs'),require('./chunk-2HQXLL5L.cjs'),require('./chunk-FGBADUSK.cjs'),require('./chunk-K5HIOS6J.cjs'),require('./chunk-CEXC2VHI.cjs'),require('./chunk-DGSJZMAE.cjs');Object.defineProperty(exports,"PROJECTION_ORIGIN",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.k}});Object.defineProperty(exports,"bodyParagraphs",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.c}});Object.defineProperty(exports,"docToTreeOps",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.f}});Object.defineProperty(exports,"mountTreeSurface",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.l}});Object.defineProperty(exports,"openTreeSession",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.j}});Object.defineProperty(exports,"partHasNode",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.g}});Object.defineProperty(exports,"reconcileDoc",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.h}});Object.defineProperty(exports,"runPropsOf",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.b}});Object.defineProperty(exports,"treeSchema",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.a}});Object.defineProperty(exports,"treeToDoc",{enumerable:true,get:function(){return chunk44SIVFJT_cjs.e}});
+'use strict';var chunkE5OUYRNM_cjs=require('./chunk-E5OUYRNM.cjs');require('./chunk-T5B4NMKF.cjs'),require('./chunk-RA2TDTEQ.cjs'),require('./chunk-FGBADUSK.cjs'),require('./chunk-DFTVN25X.cjs'),require('./chunk-4TYA4RLP.cjs'),require('./chunk-ZZRCVDQU.cjs');Object.defineProperty(exports,"PROJECTION_ORIGIN",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.k}});Object.defineProperty(exports,"bodyParagraphs",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.c}});Object.defineProperty(exports,"docToTreeOps",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.f}});Object.defineProperty(exports,"mountTreeSurface",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.l}});Object.defineProperty(exports,"openTreeSession",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.j}});Object.defineProperty(exports,"partHasNode",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.g}});Object.defineProperty(exports,"reconcileDoc",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.h}});Object.defineProperty(exports,"runPropsOf",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.b}});Object.defineProperty(exports,"treeSchema",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.a}});Object.defineProperty(exports,"treeToDoc",{enumerable:true,get:function(){return chunkE5OUYRNM_cjs.e}});

package/dist/binding.d.ts

@@ -1,16 +1,16 @@
 import { Node, Schema } from 'prosemirror-model';
-import { a0 as OoxmlProperty, Y as OoxmlPackageRejection } from './types-barrel-CEOy-Jv0.js';
-import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-DTQxw2zL.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-DTQxw2zL.js';
+import { a0 as OoxmlProperty, Y as OoxmlPackageRejection } from './types-barrel-PwcfEkaX.js';
+import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-CTT9nM7Z.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-CTT9nM7Z.js';
 import { ReviewModuleContribution } from './contracts/modules.js';
-export { S as StoryScope, a as StoryTargetRejection } from './note-lifecycle-D4AOFCAt.js';
+export { S as StoryScope, a as StoryTargetRejection } from './tree-package-fragment-CpEV1gl3.js';
 import { EditorView } from 'prosemirror-view';
-import './image-resources-C51LuAAu.js';
-import './custom-node-writes-piokwVR5.js';
-import './headless-document-view-DHKMN_3Y.js';
+import './editor-scope-OHPwVQ5l.js';
+import './image-resources-DxF-SN_8.js';
+import './custom-node-writes-CncR6KfC.js';
+import './headless-document-view-C3fc_jV0.js';
 import './collaboration/replication.js';
-import './editor-scope-DZJT4ukT.js';
-import './revision-projection-BcRnC4Yj.js';
+import './revision-projection-kVd7p6Wd.js';
 import './collaboration.js';
 import './failure-DNNmwsgD.js';
 

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-JRBGCIR2.js';import'./chunk-CAIWEQLC.js';import'./chunk-P4TGGDK3.js';import'./chunk-VP7SDFCM.js';import'./chunk-KLQXP27K.js';import'./chunk-IW35GWJN.js';import'./chunk-CF3JR35B.js';
+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-3PA64KPK.js';import'./chunk-FPDIJ4RF.js';import'./chunk-DZYKU2HG.js';import'./chunk-VP7SDFCM.js';import'./chunk-3P3DNJYM.js';import'./chunk-BF2TOG2V.js';import'./chunk-3B3DQMSL.js';