@arbidocs/blocks 0.4.101 → 0.4.102

package/node_modules/@docx-editor.dev/core/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 EigenPal Inc.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/node_modules/@docx-editor.dev/core/README.md

@@ -0,0 +1,125 @@
+<p align="center">
+  <a href="https://www.docx-editor.dev/">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/eigenpal/docx-editor/main/.github/assets/readme-logo-dark.svg" />
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/eigenpal/docx-editor/main/.github/assets/readme-logo-light.svg" />
+      <img src="https://raw.githubusercontent.com/eigenpal/docx-editor/main/.github/assets/readme-logo-light.svg" alt="DOCX Editor by EigenPal" width="320" height="90" />
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@docx-editor.dev/core"><img src="https://img.shields.io/npm/v/@docx-editor.dev/core.svg?style=flat-square&color=3B5BDB" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@docx-editor.dev/core"><img src="https://img.shields.io/npm/dm/@docx-editor.dev/core.svg?style=flat-square&color=3B5BDB" alt="npm downloads" /></a>
+  <a href="https://github.com/eigenpal/docx-editor/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache_2.0-blue.svg?style=flat-square&color=3B5BDB" alt="license" /></a>
+  <a href="https://www.docx-editor.dev/docs"><img src="https://img.shields.io/badge/Docs-3B5BDB?style=flat-square&logo=readthedocs&logoColor=white" alt="Documentation" /></a>
+</p>
+
+# @docx-editor.dev/core
+
+Use the [docx-editor.dev](https://docx-editor.dev) engine to read, edit, render, and save DOCX files. The engine stores document content in a canonical tree. It has no framework dependency.
+
+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.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).
+- [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).
+
+## Entry points
+
+Import editor creation, font helpers, and contract types from the package root:
+
+```ts
+import { createDocxEditor, loadFonts, DEFAULT_FONT } from '@docx-editor.dev/core';
+import type { Editor, EditorSnapshot } from '@docx-editor.dev/core';
+```
+
+`DEFAULT_FONT` provides the default font configuration: Calibri at 11 points. `WORD_DEFAULT_FONT` is its deprecated alias. Document formatting and document-default rules determine the text size used for layout. Missing defaults and explicitly empty defaults can produce different results.
+
+The root exports editor creation, contracts, font helpers, control definitions, and document types. Use subpaths to access storage, layout, and rendering.
+
+| Subpath | Exports |
+| --- | --- |
+| `.` | 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
+
+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.
+
+The document tree holds all editing state. The engine displays editable pages and converts browser input into tree operations.
+
+Typed nodes supply layout properties. Generic nodes preserve other element structures, including unsupported extensions.
+
+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 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';
+import { openFontBackedDocumentForExport } from '@docx-editor.dev/core/export';
+import { packagedFonts } from '@docx-editor.dev/fonts';
+
+const bytes = new Uint8Array(await readFile('contract.docx'));
+const opened = await openFontBackedDocumentForExport(bytes, {
+  fonts: packagedFonts(),
+  fontPolicy: 'strict',
+  onFontResolution: (report) => console.info(report),
+});
+
+if (!opened.ok) throw new Error(`DOCX rejected: ${opened.reason}`);
+try {
+  const layout = await opened.session.layout();
+  console.log(layout); // Replace this with your exporter.
+} finally {
+  opened.session.dispose(); // releases document-owned shaping bytes
+}
+```
+
+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.
+
+## Untrusted input
+
+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.
+
+## Documentation
+
+- [Core overview](https://www.docx-editor.dev/docs/2.x/core)
+- [Architecture](https://www.docx-editor.dev/docs/2.x/core/architecture)
+- [Feature support and fidelity](https://www.docx-editor.dev/docs/2.x/word-fidelity)
+
+## License
+
+Apache-2.0

package/node_modules/@docx-editor.dev/core/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,56 @@
+# Third-party notices
+
+`@docx-editor.dev/core` is distributed under Apache-2.0. Its published bundles also contain
+source from the open-source packages listed below, redistributed here under
+their own licenses, reproduced in full.
+
+Those copies are not verbatim. The build inlines, minifies and tree-shakes
+them, and includes only the parts each bundle reaches, so what ships is a
+modified form of the original source.
+
+This file covers code copied INTO the published bundles. Packages this one
+declares as `dependencies` or `peerDependencies` are installed separately by
+the consumer and are not repeated here.
+
+Generated by `bun run notices:generate` from the build's esbuild metafile.
+Do not edit by hand.
+
+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/HarfBuzz-COPYING.txt`
+
+## Bundled packages
+
+- harfbuzzjs 1.6.1 — MIT (https://harfbuzz.github.io/harfbuzzjs)
+
+---
+
+## harfbuzzjs 1.6.1
+
+License: MIT
+
+### LICENSE
+
+```
+Copyright (c) 2019-2026 The harfbuzzjs project authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/node_modules/@docx-editor.dev/core/dist/automation.cjs

@@ -0,0 +1 @@
+'use strict';var chunkVX43VBAX_cjs=require('./chunk-VX43VBAX.cjs');require('./chunk-6AWEKBLB.cjs'),require('./chunk-4GBTELJV.cjs'),require('./chunk-ZUHOMK52.cjs'),require('./chunk-O2AL2HSJ.cjs');var chunkJGNVNT2A_cjs=require('./chunk-JGNVNT2A.cjs'),chunk2GO5T2JU_cjs=require('./chunk-2GO5T2JU.cjs'),chunkFIJZIQXA_cjs=require('./chunk-FIJZIQXA.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=chunkFIJZIQXA_cjs.Ce(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 chunkJGNVNT2A_cjs.T(m.package,chunkJGNVNT2A_cjs.ua(m.package,chunkFIJZIQXA_cjs.Eb(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(chunkJGNVNT2A_cjs.Ca(u));u.packageRevision===a&&(i=d,l=a);},n.fieldPageContext=(f,a,d)=>{if(u.packageRevision!==l)return null;let s=chunkVX43VBAX_cjs.g(u.currentPackage()).story(f);return s?chunkVX43VBAX_cjs.d(i,s.part,a,d):null};}let r=chunkVX43VBAX_cjs.m({port:n,capabilities:j});return y&&(c=y.attach(chunk2GO5T2JU_cjs.b(u,{documentId:y.documentId}))),{ok:true,host:r}}function G(o,t,m){let p=o.partFor(m);return p?chunkFIJZIQXA_cjs.Na(o,()=>{let u=chunkFIJZIQXA_cjs.Hg(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"?chunkFIJZIQXA_cjs.g.mutationAgent:chunkFIJZIQXA_cjs.g.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=>chunkFIJZIQXA_cjs.Hb(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=>chunk2GO5T2JU_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=chunkFIJZIQXA_cjs.Hb(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=chunkFIJZIQXA_cjs.Hb(t?.identity.actorId,()=>chunkJGNVNT2A_cjs.ea(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=chunkFIJZIQXA_cjs.Hb(t?.identity.actorId,()=>chunkJGNVNT2A_cjs.ca(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=chunkFIJZIQXA_cjs.Hb(t?.identity.actorId,()=>chunkJGNVNT2A_cjs.da(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=chunkFIJZIQXA_cjs.Hb(t?.identity.actorId,()=>chunkJGNVNT2A_cjs.ma(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?chunkFIJZIQXA_cjs.Ee(o.currentPackage()):null,subscribe:n=>o.subscribe(()=>n()),dispose(){m(),p=false;}}}Object.defineProperty(exports,"AUTOMATION_COMMAND_OPERATIONS",{enumerable:true,get:function(){return chunkVX43VBAX_cjs.i}});Object.defineProperty(exports,"AUTOMATION_QUERY_OPERATIONS",{enumerable:true,get:function(){return chunkVX43VBAX_cjs.h}});Object.defineProperty(exports,"AUTOMATION_SOLITARY_OPERATIONS",{enumerable:true,get:function(){return chunkVX43VBAX_cjs.j}});Object.defineProperty(exports,"HEADER_FOOTER_VARIANTS",{enumerable:true,get:function(){return chunkVX43VBAX_cjs.f}});Object.defineProperty(exports,"createAutomationPaginationProvider",{enumerable:true,get:function(){return chunkVX43VBAX_cjs.e}});Object.defineProperty(exports,"isAutomationCommand",{enumerable:true,get:function(){return chunkVX43VBAX_cjs.l}});Object.defineProperty(exports,"isSolitaryAutomationCommand",{enumerable:true,get:function(){return chunkVX43VBAX_cjs.k}});Object.defineProperty(exports,"paginationSnapshotOf",{enumerable:true,get:function(){return chunkVX43VBAX_cjs.c}});exports.SERVER_AUTOMATION_CAPABILITIES=j;exports.createServerAutomationHost=Y;

package/node_modules/@docx-editor.dev/core/dist/automation.d.ts

@@ -0,0 +1,162 @@
+/**
+ * `@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-Bqk4Izjc.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-Bqk4Izjc.js';
+import { c as HeaderFooterVariant, N as NoteKind } from './tree-package-fragment-BeeKxDw8.js';
+import { T as TextMeasurer, S as SemanticLayout } from './semantic-records-4B3WwFAi.js';
+import { H as HeadlessDocumentView } from './headless-document-view-qH331moE.js';
+import { a1 as OoxmlPackageLimits, Y as OoxmlPackageRejection } from './types-barrel-D3xCgQX6.js';
+export { a2 as RevisionAuthorEntry, a3 as RevisionAuthorResult, a4 as RevisionAuthorSkipReason, a5 as RevisionBatchEntry, a6 as RevisionBatchResult, a7 as RevisionBatchSkipReason } from './types-barrel-D3xCgQX6.js';
+import { CollaborationModuleContribution } from './collaboration.js';
+import './image-resources-BN-hUgCn.js';
+import './revision-projection-DZ4kKVev.js';
+import './omml-equation-CuzBL5DD.js';
+import './editor-scope-OHPwVQ5l.js';
+import './collaboration/replication.js';
+import './failure-NS2lsya4.js';
+
+/** The variants a section can declare furniture for. */
+declare const HEADER_FOOTER_VARIANTS: readonly HeaderFooterVariant[];
+/**
+ * Which story an operation acts on: the main body, one header/footer variant of one section, or
+ * one note.
+ *
+ * A header is addressed by section INDEX plus variant rather than by relationship id, because
+ * that is how a caller thinks about it and because a section inheriting its predecessor's header
+ * has no relationship of its own to name.
+ */
+type AutomationStoryId = AutomationShapeOwnerStory | {
+    readonly kind: 'note';
+    readonly noteKind: NoteKind;
+    readonly noteId: number;
+}
+/**
+ * A text box: the `w:txbxContent` of the floating shape whose `wp:docPr/@id` is `shapeId`,
+ * anchored in `owner`. Its paragraphs live in the owner's part and commit through its scope.
+ */
+ | {
+    readonly kind: 'textbox';
+    readonly owner: AutomationShapeOwnerStory;
+    readonly shapeId: number;
+};
+/** A story that can anchor shapes: the main body, or one header/footer variant of a section. */
+type AutomationShapeOwnerStory = {
+    readonly kind: 'body';
+} | {
+    readonly kind: 'header' | 'footer';
+    /** Position of the section in the document, from zero. */
+    readonly sectionIndex: number;
+    readonly variant: HeaderFooterVariant;
+};
+
+/** 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", "setRevisionAuthorBatch", "acceptAllRevisions", "rejectAllRevisions", "setContentControlValue", "setContentControlProperties", "deleteContentControl", "insertContentControlText", "insertContentControl", "insertCustomNode"];
+/**
+ * Commands that commit as a PACKAGE transaction and therefore share a batch with nothing.
+ *
+ * A note's lifecycle rewrites several parts at once — the notes part, the references in every
+ * story that cited it, the relationship and the content-type override — and the store publishes
+ * that as its own undo unit rather than as ops inside a story transaction. Two of them, or one
+ * beside a story command, would be two commits: two revisions, and a moment where half the
+ * caller's batch is published. Refused while planning instead.
+ *
+ * Some operations are solitary only in some forms: an `insertBreak` with `Line` is a text write
+ * 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", "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. */
+declare function isAutomationCommand(operation: AutomationOperation): boolean;
+
+/** Measured page positions used by field updates; no guessed page counts. @public */
+interface AutomationPaginationSnapshot {
+    readonly pageCount: number;
+    readonly ranges: readonly {
+        readonly paragraphId: string;
+        readonly start: number;
+        readonly end: number;
+        readonly pageNumber: number;
+        readonly pageNumberText: string;
+    }[];
+}
+/** A host settles fonts/images and paginates the supplied canonical view. @public */
+type AutomationPaginationProvider = (view: HeadlessDocumentView) => Promise<AutomationPaginationSnapshot>;
+/** Convert actual semantic pages into field-update positions. @public */
+declare function paginationSnapshotOf(layout: SemanticLayout): AutomationPaginationSnapshot;
+/** Explicit measurement inputs for headless field calculation. @public */
+interface AutomationPaginationOptions {
+    readonly measurer: TextMeasurer;
+    readonly producer?: string;
+}
+/** Create a DOM-free pagination provider using the engine's measured export layout. @public */
+declare function createAutomationPaginationProvider(options: AutomationPaginationOptions): AutomationPaginationProvider;
+
+/** What a headless host can do. It paints nothing, so it claims nothing about painting. */
+declare const SERVER_AUTOMATION_CAPABILITIES: AutomationCapabilities;
+/**
+ * Why bytes could not be opened as a document: any bounded-reader rejection, plus the package
+ * that parsed but carried no main document part.
+ */
+type ServerAutomationHostRejection = OoxmlPackageRejection | 'no-main-document-part';
+/**
+ * A host over the opened bytes, or a refusal.
+ *
+ * A result rather than a throw: these bytes are untrusted input, and a malformed upload should
+ * be a value the caller inspects rather than an exception from inside a zip decoder.
+ */
+type ServerAutomationHostResult = {
+    readonly ok: true;
+    readonly host: AutomationHost;
+} | {
+    readonly ok: false;
+    readonly reason: ServerAutomationHostRejection;
+    readonly limit?: 'zip.maxTotalBytes' | 'zip.maxRatio';
+    readonly detail?: string;
+};
+/**
+ * How a headless host opens a document. Every field is optional.
+ *
+ * @public
+ */
+interface ServerAutomationHostOptions {
+    /** Optional real pagination for PAGE/NUMPAGES updates. */
+    readonly pagination?: AutomationPaginationProvider;
+    /**
+     * Budgets for the bounded reader — archive size, part count, and XML elements.
+     *
+     * Omitted means the engine defaults. Lower budgets for untrusted input, or raise
+     * `xml.maxElements` for larger documents when the host has sufficient memory.
+     * Engine ceilings still apply.
+     */
+    readonly limits?: OoxmlPackageLimits;
+    /**
+     * Collaboration replica from the module registry. Absent, this host does
+     * not attach a replica.
+     */
+    readonly collaborationModel?: CollaborationModuleContribution;
+}
+/**
+ * Open DOCX bytes into a headless automation host.
+ *
+ * A typed rejection rather than a throw: every failure here is a property of the FILE, and a
+ * caller needs to tell "not a package" from "this package is hostile" from "no body".
+ */
+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 };

package/node_modules/@docx-editor.dev/core/dist/automation.js

@@ -0,0 +1 @@
+import {m,g,d}from'./chunk-VHAVHCQY.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-VHAVHCQY.js';import'./chunk-6EYYL7FL.js';import'./chunk-FRXAOVTB.js';import'./chunk-E7BQA6UP.js';import'./chunk-TSLBZ26X.js';import {T,ua,Ca,ma,ea,ca,da}from'./chunk-J6BVWIDB.js';import {b,a}from'./chunk-ETTO6GK3.js';import {Ce,Eb,Ee,Hb,Na,Hg,g as g$1}from'./chunk-4R3TEXMN.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=Ce(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 T(m$1.package,ua(m$1.package,Eb(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(Ca(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?Na(o,()=>{let u=Hg(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"?g$1.mutationAgent:g$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=>Hb(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=Hb(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=Hb(t?.identity.actorId,()=>ea(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=Hb(t?.identity.actorId,()=>ca(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=Hb(t?.identity.actorId,()=>da(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=Hb(t?.identity.actorId,()=>ma(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?Ee(o.currentPackage()):null,subscribe:n=>o.subscribe(()=>n()),dispose(){m(),p=false;}}}export{j as SERVER_AUTOMATION_CAPABILITIES,Y as createServerAutomationHost};

package/node_modules/@docx-editor.dev/core/dist/binding.cjs

@@ -0,0 +1 @@
+'use strict';var chunkSRPILEWV_cjs=require('./chunk-SRPILEWV.cjs');require('./chunk-QMLCVPCD.cjs'),require('./chunk-ZUHOMK52.cjs'),require('./chunk-O2AL2HSJ.cjs'),require('./chunk-JGNVNT2A.cjs'),require('./chunk-2GO5T2JU.cjs'),require('./chunk-FIJZIQXA.cjs');Object.defineProperty(exports,"PROJECTION_ORIGIN",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.l}});Object.defineProperty(exports,"bodyParagraphs",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.c}});Object.defineProperty(exports,"docToTreeOps",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.f}});Object.defineProperty(exports,"mountTreeSurface",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.m}});Object.defineProperty(exports,"openTreeSession",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.j}});Object.defineProperty(exports,"partHasNode",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.g}});Object.defineProperty(exports,"reconcileDoc",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.h}});Object.defineProperty(exports,"runPropsOf",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.b}});Object.defineProperty(exports,"treeSchema",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.a}});Object.defineProperty(exports,"treeToDoc",{enumerable:true,get:function(){return chunkSRPILEWV_cjs.e}});