@docx-editor.dev/pro 2.10.0 → 2.11.0

package/dist/document-session-DVa53DAw.d.cts

@@ -0,0 +1,94 @@
+import * as Y from 'yjs';
+import { Awareness } from 'y-protocols/awareness';
+import { CollaborationIdentity } from '@docx-editor.dev/core/collaboration';
+import { a as CollaborationBootstrap, c as CollaborationHandle, e as TextCollaborationSession, b as CollaborationIdentityUpdate } from './session-BH7Qgyp6.cjs';
+
+/**
+ * Full-document collaboration over the canonical primitive journal.
+ *
+ * Local direction: the canonical store commits, emits ONE journal, and the journal is applied
+ * to shared state in one Yjs transaction. Remote direction: a shared-state change materializes
+ * one canonical package, which the port publishes as one revision. The two never chase each
+ * other, because a remote publication deliberately emits no journal.
+ */
+
+/**
+ * Full-document collaboration session.
+ *
+ * The seam matches {@link TextCollaborationSession}, plus a live display-identity update.
+ * @public
+ */
+interface DocumentCollaborationSession extends TextCollaborationSession {
+    /**
+     * Update the display identity for the rest of this session and republish presence.
+     *
+     * `name` revalidates with the construction rules (trimmed, 1 to 256 characters) and an
+     * invalid value throws. `color` longer than 64 characters throws; a color
+     * `safeParticipantColor` refuses is dropped, so peers fall back to the accent color.
+     * `actorId` and `role` are immutable — the update type cannot name them, and any extra
+     * runtime property is ignored.
+     */
+    setIdentity(update: CollaborationIdentityUpdate): void;
+}
+/** Owned full-document collaboration replica. @public */
+type DocumentCollaborationHandle = CollaborationHandle<DocumentCollaborationSession>;
+/**
+ * Options for one full-document collaboration replica.
+ *
+ * The caller owns `ydoc`.
+ * @public
+ */
+interface CreateDocumentCollaborationOptions {
+    readonly ydoc: Y.Doc;
+    readonly awareness: Awareness;
+    readonly documentId: string;
+    /** Unique attachment identity. Omit it to generate a new identity for this session. */
+    readonly sessionId?: string;
+    readonly identity: CollaborationIdentity;
+    readonly bootstrap: CollaborationBootstrap;
+    /**
+     * Admit local edits while the transport is `disconnected`.
+     *
+     * A journal applies to the local `Y.Doc` either way, so buffered offline edits merge on
+     * reconnect exactly as concurrent online edits do. Off by default: a host that shows no
+     * offline indicator would let users type into a document no peer receives yet. `error`
+     * stays terminal and `initializing` stays refused regardless of this option.
+     */
+    readonly offlineEditing?: boolean;
+}
+/**
+ * Read the document a synchronized `Y.Doc` holds, as `.docx` bytes.
+ *
+ * This is the server side of a room: export, autosave to your own storage, search indexing, a
+ * nightly PDF, a webhook. It JOINS NOTHING. There is no identity, no `Awareness` and no
+ * session, so the job that calls it never appears in anyone's avatar stack, and it creates no
+ * editing gate, so it cannot write back.
+ *
+ * `ydoc` must already hold the room's state: connect your provider and wait for its initial
+ * sync first, exactly as a `{ kind: \'join\' }` bootstrap does. A document that was never
+ * seeded refuses with `not-initialized` rather than returning a truncated file.
+ *
+ * ```ts
+ * // Hocuspocus hands `onStoreDocument` the synced Y.Doc already:
+ * async onStoreDocument({ documentName, document }) {
+ *   await writeFile(`${documentName}.docx`, readCollaborationDocument(document));
+ * }
+ * ```
+ *
+ * Synchronous, and it materializes the whole package per call — this is a job, not a render.
+ *
+ * @throws CollaborationSchemaError — `not-initialized`, `concurrent-seed`,
+ * `blob-digest-mismatch`, or a limit code: the same refusals a joining replica makes, for the
+ * same reasons.
+ * @public
+ */
+declare function readCollaborationDocument(ydoc: Y.Doc): Uint8Array;
+/**
+ * Create or join one full-document collaboration replica.
+ *
+ * The caller owns `ydoc`.
+ * @public
+ */
+declare function createDocumentCollaboration(options: CreateDocumentCollaborationOptions): Promise<DocumentCollaborationHandle>;
+
+export { type CreateDocumentCollaborationOptions as C, type DocumentCollaborationHandle as D, type DocumentCollaborationSession as a, createDocumentCollaboration as c, readCollaborationDocument as r };

package/dist/document-session-DiBuzWwA.d.ts

@@ -0,0 +1,94 @@
+import * as Y from 'yjs';
+import { Awareness } from 'y-protocols/awareness';
+import { CollaborationIdentity } from '@docx-editor.dev/core/collaboration';
+import { a as CollaborationBootstrap, c as CollaborationHandle, e as TextCollaborationSession, b as CollaborationIdentityUpdate } from './session-BH7Qgyp6.js';
+
+/**
+ * Full-document collaboration over the canonical primitive journal.
+ *
+ * Local direction: the canonical store commits, emits ONE journal, and the journal is applied
+ * to shared state in one Yjs transaction. Remote direction: a shared-state change materializes
+ * one canonical package, which the port publishes as one revision. The two never chase each
+ * other, because a remote publication deliberately emits no journal.
+ */
+
+/**
+ * Full-document collaboration session.
+ *
+ * The seam matches {@link TextCollaborationSession}, plus a live display-identity update.
+ * @public
+ */
+interface DocumentCollaborationSession extends TextCollaborationSession {
+    /**
+     * Update the display identity for the rest of this session and republish presence.
+     *
+     * `name` revalidates with the construction rules (trimmed, 1 to 256 characters) and an
+     * invalid value throws. `color` longer than 64 characters throws; a color
+     * `safeParticipantColor` refuses is dropped, so peers fall back to the accent color.
+     * `actorId` and `role` are immutable — the update type cannot name them, and any extra
+     * runtime property is ignored.
+     */
+    setIdentity(update: CollaborationIdentityUpdate): void;
+}
+/** Owned full-document collaboration replica. @public */
+type DocumentCollaborationHandle = CollaborationHandle<DocumentCollaborationSession>;
+/**
+ * Options for one full-document collaboration replica.
+ *
+ * The caller owns `ydoc`.
+ * @public
+ */
+interface CreateDocumentCollaborationOptions {
+    readonly ydoc: Y.Doc;
+    readonly awareness: Awareness;
+    readonly documentId: string;
+    /** Unique attachment identity. Omit it to generate a new identity for this session. */
+    readonly sessionId?: string;
+    readonly identity: CollaborationIdentity;
+    readonly bootstrap: CollaborationBootstrap;
+    /**
+     * Admit local edits while the transport is `disconnected`.
+     *
+     * A journal applies to the local `Y.Doc` either way, so buffered offline edits merge on
+     * reconnect exactly as concurrent online edits do. Off by default: a host that shows no
+     * offline indicator would let users type into a document no peer receives yet. `error`
+     * stays terminal and `initializing` stays refused regardless of this option.
+     */
+    readonly offlineEditing?: boolean;
+}
+/**
+ * Read the document a synchronized `Y.Doc` holds, as `.docx` bytes.
+ *
+ * This is the server side of a room: export, autosave to your own storage, search indexing, a
+ * nightly PDF, a webhook. It JOINS NOTHING. There is no identity, no `Awareness` and no
+ * session, so the job that calls it never appears in anyone's avatar stack, and it creates no
+ * editing gate, so it cannot write back.
+ *
+ * `ydoc` must already hold the room's state: connect your provider and wait for its initial
+ * sync first, exactly as a `{ kind: \'join\' }` bootstrap does. A document that was never
+ * seeded refuses with `not-initialized` rather than returning a truncated file.
+ *
+ * ```ts
+ * // Hocuspocus hands `onStoreDocument` the synced Y.Doc already:
+ * async onStoreDocument({ documentName, document }) {
+ *   await writeFile(`${documentName}.docx`, readCollaborationDocument(document));
+ * }
+ * ```
+ *
+ * Synchronous, and it materializes the whole package per call — this is a job, not a render.
+ *
+ * @throws CollaborationSchemaError — `not-initialized`, `concurrent-seed`,
+ * `blob-digest-mismatch`, or a limit code: the same refusals a joining replica makes, for the
+ * same reasons.
+ * @public
+ */
+declare function readCollaborationDocument(ydoc: Y.Doc): Uint8Array;
+/**
+ * Create or join one full-document collaboration replica.
+ *
+ * The caller owns `ydoc`.
+ * @public
+ */
+declare function createDocumentCollaboration(options: CreateDocumentCollaborationOptions): Promise<DocumentCollaborationHandle>;
+
+export { type CreateDocumentCollaborationOptions as C, type DocumentCollaborationHandle as D, type DocumentCollaborationSession as a, createDocumentCollaboration as c, readCollaborationDocument as r };

package/dist/document-session-RGNZHMWF.js

@@ -0,0 +1 @@
+export{b as ATTACH_WATCHDOG_MS_FOR_TESTS,d as createDocumentCollaboration,c as readCollaborationDocument}from'./chunk-7QSJBMZV.js';

package/dist/document-session-TU7WVBRB.cjs

@@ -0,0 +1 @@
+'use strict';var chunkYJM6R76M_cjs=require('./chunk-YJM6R76M.cjs');Object.defineProperty(exports,"ATTACH_WATCHDOG_MS_FOR_TESTS",{enumerable:true,get:function(){return chunkYJM6R76M_cjs.b}});Object.defineProperty(exports,"createDocumentCollaboration",{enumerable:true,get:function(){return chunkYJM6R76M_cjs.d}});Object.defineProperty(exports,"readCollaborationDocument",{enumerable:true,get:function(){return chunkYJM6R76M_cjs.c}});

package/dist/hocuspocus-EUC4BGDD.js

@@ -0,0 +1 @@
+import {b}from'./chunk-6DEUT2RQ.js';export{a as createCollaborationRoomId,b as validateRoomId}from'./chunk-6DEUT2RQ.js';import {d,a}from'./chunk-7QSJBMZV.js';import*as P from'yjs';import {Awareness}from'y-protocols/awareness';import {HocuspocusProvider}from'@hocuspocus/provider';var g=3e4,S=Symbol("createHocuspocusCollaboration.provider"),O=o=>new HocuspocusProvider({url:o.url,name:o.name,document:o.document,awareness:o.awareness,...o.token!==void 0?{token:o.token}:{}});function F(o,d){return new Promise((c,e)=>{if(o.isSynced){c();return}let n=()=>{clearTimeout(s),o.off("synced",a$1),o.off("authenticationFailed",t);},a$1=()=>{n(),c();},t=r=>{n(),e(new a("initialization-aborted",`authentication failed: ${r.reason}`));},s=setTimeout(()=>{n(),e(new a("initialization-timeout"));},d);o.on("synced",a$1),o.on("authenticationFailed",t);})}async function E(o){let d$1=b(o.roomId),c=o[S]??O,e=new P.Doc,n=new Awareness(e),a=()=>c({url:o.url,name:d$1,document:e,awareness:n,...o.token!==void 0?{token:o.token}:{}}),t=null,s=null;try{o.bootstrap.kind!=="create"&&(t=a(),await F(t,o.syncedTimeoutMs??g)),s=await d({ydoc:e,awareness:n,documentId:d$1,identity:o.identity,bootstrap:o.bootstrap,offlineEditing:o.offlineEditing}),t||(t=a());}catch(i){throw s?.destroy(),t?.destroy(),n.destroy(),e.destroy(),i}let r=t,u=s,l=u.session,f=i=>{l.setTransportStatus(i.status==="connected"?"ready":"disconnected",i.status==="connected"?void 0:"transport-disconnected",i.status==="connected"?void 0:"websocket disconnected");};r.on("status",f);let p=()=>{l.setTransportStatus("error","authentication-failed");};r.on("authenticationFailed",p);let b$1=false;return Object.freeze({document:u.document,session:l,ydoc:e,provider:r,destroy(){b$1||(b$1=true,r.off("status",f),r.off("authenticationFailed",p),u.destroy(),r.destroy(),n.destroy(),e.destroy());}})}export{S as HOCUSPOCUS_PROVIDER_FOR_TESTS,E as createHocuspocusCollaboration};

package/dist/hocuspocus-YIKH6ENE.cjs

@@ -0,0 +1 @@
+'use strict';var chunkLUUFBXJ5_cjs=require('./chunk-LUUFBXJ5.cjs'),chunkYJM6R76M_cjs=require('./chunk-YJM6R76M.cjs'),P=require('yjs'),awareness=require('y-protocols/awareness'),provider=require('@hocuspocus/provider');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}var P__namespace=/*#__PURE__*/_interopNamespace(P);var g=3e4,S=Symbol("createHocuspocusCollaboration.provider"),O=o=>new provider.HocuspocusProvider({url:o.url,name:o.name,document:o.document,awareness:o.awareness,...o.token!==void 0?{token:o.token}:{}});function F(o,d){return new Promise((c,e)=>{if(o.isSynced){c();return}let n=()=>{clearTimeout(s),o.off("synced",a),o.off("authenticationFailed",t);},a=()=>{n(),c();},t=r=>{n(),e(new chunkYJM6R76M_cjs.a("initialization-aborted",`authentication failed: ${r.reason}`));},s=setTimeout(()=>{n(),e(new chunkYJM6R76M_cjs.a("initialization-timeout"));},d);o.on("synced",a),o.on("authenticationFailed",t);})}async function E(o){let d=chunkLUUFBXJ5_cjs.b(o.roomId),c=o[S]??O,e=new P__namespace.Doc,n=new awareness.Awareness(e),a=()=>c({url:o.url,name:d,document:e,awareness:n,...o.token!==void 0?{token:o.token}:{}}),t=null,s=null;try{o.bootstrap.kind!=="create"&&(t=a(),await F(t,o.syncedTimeoutMs??g)),s=await chunkYJM6R76M_cjs.d({ydoc:e,awareness:n,documentId:d,identity:o.identity,bootstrap:o.bootstrap,offlineEditing:o.offlineEditing}),t||(t=a());}catch(i){throw s?.destroy(),t?.destroy(),n.destroy(),e.destroy(),i}let r=t,u=s,l=u.session,f=i=>{l.setTransportStatus(i.status==="connected"?"ready":"disconnected",i.status==="connected"?void 0:"transport-disconnected",i.status==="connected"?void 0:"websocket disconnected");};r.on("status",f);let p=()=>{l.setTransportStatus("error","authentication-failed");};r.on("authenticationFailed",p);let b=false;return Object.freeze({document:u.document,session:l,ydoc:e,provider:r,destroy(){b||(b=true,r.off("status",f),r.off("authenticationFailed",p),u.destroy(),r.destroy(),n.destroy(),e.destroy());}})}Object.defineProperty(exports,"createCollaborationRoomId",{enumerable:true,get:function(){return chunkLUUFBXJ5_cjs.a}});Object.defineProperty(exports,"validateRoomId",{enumerable:true,get:function(){return chunkLUUFBXJ5_cjs.b}});exports.HOCUSPOCUS_PROVIDER_FOR_TESTS=S;exports.createHocuspocusCollaboration=E;

package/dist/index.cjs

@@ -1 +1 @@
-'use strict';var chunk4LFF2FXG_cjs=require('./chunk-4LFF2FXG.cjs'),store=require('@docx-editor.dev/core/store');function b(t,n={}){let r=U(t);if(!r)return [];let o=n.nodes??t.getCustomNodeDefinitions().filter(chunk4LFF2FXG_cjs.j);if(o.length===0)return [];let s=r.session.currentPackage(),d=r.session.part().name,m=n.onDiagnostic??(e=>{t.reportCustomNodeDiagnostic(e);});return r.session.storyParts().flatMap(e=>chunk4LFF2FXG_cjs.n(e,o,{payloads:store.customNodePayloadsByControl(s,e.name,d),onDiagnostic:m}))}function U(t){return t.surface??null}function E(t,n,r={}){if(r.destination==="internal")return {ok:true,bytes:t,unwrapped:0,removed:0};let o=store.readOoxmlPackage(t);if(!o.ok)return {ok:false,reason:`the document could not be read: ${o.reason}`};let s=new Map;for(let i of n)s.set(`${i.tagPrefix}:${i.name}`,i);let d=i=>{let p=chunk4LFF2FXG_cjs.c(i);if(!p)return "keep";let x=s.get(`${p.prefix}:${p.name}`);return x?x.preserveOnExport==="text"?"text":x.preserveOnExport===false?"remove":"keep":"keep"},m=[...new Set(n.filter(i=>i.preserveOnExport!==void 0).filter(i=>i.preserveOnExport!==true).map(chunk4LFF2FXG_cjs.h))],e=o.package,u=0,c=0,g=B(e);for(let i of g){let p=store.withExportedCustomNodes(e,{storyPartName:i,namespaces:[],decide:d});if(!p.ok)return {ok:false,reason:p.reason};e=p.pkg,u+=p.unwrapped,c+=p.removed;}let l=store.withExportedCustomNodes(e,{storyPartName:e.mainDocumentPart,namespaces:m,decide:()=>"keep"});return l.ok?(e=l.pkg,{ok:true,bytes:store.writeOoxmlPackage(e),unwrapped:u,removed:c}):{ok:false,reason:l.reason}}function B(t){let n=[];for(let[r,o]of t.parts)r!==t.mainDocumentPart&&store.isStoryPart(o)&&n.push(r);return [t.mainDocumentPart,...n]}async function V(t,n={}){let r=n.nodes??t.getCustomNodeDefinitions().filter(chunk4LFF2FXG_cjs.j),o=await t.save();return E(new Uint8Array(o),r,{...n.destination===void 0?{}:{destination:n.destination}})}function a(t){return t.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F]/g,"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}function J(t,n,r,o={}){if(!chunk4LFF2FXG_cjs.k.test(t.tagPrefix)||!chunk4LFF2FXG_cjs.k.test(t.name))return {ok:false,code:"invalidArgs",reason:"the definition identity must match defineCustomNode\u2019s charset ([A-Za-z0-9_.-])"};let s=chunk4LFF2FXG_cjs.b(t.tagPrefix,t.name,n);if(!s.ok)return {ok:false,code:"invalidArgs",reason:`the encoded tag is ${s.length} characters; Word caps w:tag at 64 \u2014 shorten the attrs`};let d=o.lock===void 0?"contentLocked":o.lock,m=o.id!==void 0&&Number.isInteger(o.id)&&o.id>0?o.id:store.fnv1a32(`${s.tag}\0${r}`)&2147483647||1,e=o.data===void 0?null:K(t,o,r);if(e&&"reason"in e)return {ok:false,code:"invalidArgs",reason:e.reason};let u=(o.alias!==void 0?`<w:alias w:val="${a(o.alias)}"/>`:"")+`<w:tag w:val="${a(s.tag)}"/><w:id w:val="${m}"/>`+(d===false?"":`<w:lock w:val="${d}"/>`)+(e?`<w:dataBinding w:prefixMappings="${a(e.binding.prefixMappings)}" w:xpath="${a(e.binding.xpath)}" w:storeItemID="${a(e.binding.storeItemId)}"/>`:""),c=`<w:r><w:t xml:space="preserve">${a(r)}</w:t></w:r>`;return {ok:true,xml:`<w:sdt><w:sdtPr>${u}</w:sdtPr><w:sdtContent>${c}</w:sdtContent></w:sdt>`,...e?{store:e.store}:{}}}function K(t,n,r){let o=chunk4LFF2FXG_cjs.i(t,n.data);if(!o.ok)return {reason:o.reason};let s=chunk4LFF2FXG_cjs.h(t),d=n.storeIndex!==void 0&&Number.isInteger(n.storeIndex)&&n.storeIndex>0?n.storeIndex:1,m=n.nodeId??"cx1",e=`/customXml/item${String(d)}.xml`,u=`/customXml/itemProps${String(d)}.xml`,c=store.datastoreItemIdFor(`${s} ${e} ${m}`),g=store.customNodeBinding({partName:e,propsPartName:u,itemId:c,namespaceUri:s},chunk4LFF2FXG_cjs.g,m);if(!g)return {reason:`the payload cannot be addressed by an XPath: check nodeId (${m}) and payloadNamespace`};let l=r===r.trim()?`<label>${a(r)}</label>`:`<label xml:space="preserve">${a(r)}</label>`;return {binding:g,store:{itemPartName:e,itemXml:`<${chunk4LFF2FXG_cjs.g} xmlns="${a(s)}"><node id="${a(m)}">${l}<data>${a(o.data)}</data></node></${chunk4LFF2FXG_cjs.g}>`,propsPartName:u,propsXml:`<ds:datastoreItem ds:itemID="${a(c)}" xmlns:ds="${store.DATASTORE_NAMESPACE_URI}"><ds:schemaRefs><ds:schemaRef ds:uri="${a(s)}"/></ds:schemaRefs></ds:datastoreItem>`,storeItemId:c,relationships:[{from:"/word/document.xml",type:store.CUSTOM_XML_REL,target:`../customXml/item${String(d)}.xml`},{from:e,type:store.CUSTOM_XML_PROPS_REL,target:`itemProps${String(d)}.xml`}],contentTypeOverride:{partName:u,contentType:store.CUSTOM_XML_PROPS_TYPE}}}}Object.defineProperty(exports,"CUSTOM_NODE_STORE_ROOT",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.g}});Object.defineProperty(exports,"MAX_CUSTOM_NODE_DATA_LENGTH",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.d}});Object.defineProperty(exports,"MAX_TAG_LENGTH",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.a}});Object.defineProperty(exports,"customNodeNamespace",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.h}});Object.defineProperty(exports,"customNodesModule",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.m}});Object.defineProperty(exports,"decodeCustomNodeTag",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.c}});Object.defineProperty(exports,"defineCustomNode",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.l}});Object.defineProperty(exports,"encodeCustomNodeTag",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.b}});Object.defineProperty(exports,"insertCustomNode",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.p}});Object.defineProperty(exports,"isCustomNodeDefinition",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.j}});Object.defineProperty(exports,"parseCustomNodeData",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.e}});Object.defineProperty(exports,"recognizeCustomNodes",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.n}});Object.defineProperty(exports,"removeCustomNode",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.q}});Object.defineProperty(exports,"reviewModule",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.o}});Object.defineProperty(exports,"serializeCustomNodeData",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.f}});Object.defineProperty(exports,"updateCustomNode",{enumerable:true,get:function(){return chunk4LFF2FXG_cjs.r}});exports.customNodeXml=J;exports.customNodesOf=b;exports.prepareForExport=E;exports.saveForExport=V;
+'use strict';var chunkEMO6YTKO_cjs=require('./chunk-EMO6YTKO.cjs'),chunkQLZH2Q2C_cjs=require('./chunk-QLZH2Q2C.cjs'),store=require('@docx-editor.dev/core/store');function U(t,n={}){let r=L(t);if(!r)return [];let o=n.nodes??t.getCustomNodeDefinitions().filter(chunkEMO6YTKO_cjs.j);if(o.length===0)return [];let s=r.session.currentPackage(),d=r.session.part().name,m=n.onDiagnostic??(e=>{t.reportCustomNodeDiagnostic(e);});return r.session.storyParts().flatMap(e=>chunkEMO6YTKO_cjs.n(e,o,{payloads:store.customNodePayloadsByControl(s,e.name,d),onDiagnostic:m}))}function L(t){return t.surface??null}function E(t,n,r={}){if(r.destination==="internal")return {ok:true,bytes:t,unwrapped:0,removed:0};let o=store.readOoxmlPackage(t);if(!o.ok)return {ok:false,reason:`the document could not be read: ${o.reason}`};let s=new Map;for(let i of n)s.set(`${i.tagPrefix}:${i.name}`,i);let d=i=>{let p=chunkEMO6YTKO_cjs.c(i);if(!p)return "keep";let x=s.get(`${p.prefix}:${p.name}`);return x?x.preserveOnExport==="text"?"text":x.preserveOnExport===false?"remove":"keep":"keep"},m=[...new Set(n.filter(i=>i.preserveOnExport!==void 0).filter(i=>i.preserveOnExport!==true).map(chunkEMO6YTKO_cjs.h))],e=o.package,u=0,c=0,g=V(e);for(let i of g){let p=store.withExportedCustomNodes(e,{storyPartName:i,namespaces:[],decide:d});if(!p.ok)return {ok:false,reason:p.reason};e=p.pkg,u+=p.unwrapped,c+=p.removed;}let l=store.withExportedCustomNodes(e,{storyPartName:e.mainDocumentPart,namespaces:m,decide:()=>"keep"});return l.ok?(e=l.pkg,{ok:true,bytes:store.writeOoxmlPackage(e),unwrapped:u,removed:c}):{ok:false,reason:l.reason}}function V(t){let n=[];for(let[r,o]of t.parts)r!==t.mainDocumentPart&&store.isStoryPart(o)&&n.push(r);return [t.mainDocumentPart,...n]}async function G(t,n={}){let r=n.nodes??t.getCustomNodeDefinitions().filter(chunkEMO6YTKO_cjs.j),o=await t.save();return E(new Uint8Array(o),r,{...n.destination===void 0?{}:{destination:n.destination}})}function a(t){return t.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F]/g,"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}function K(t,n,r,o={}){if(!chunkEMO6YTKO_cjs.k.test(t.tagPrefix)||!chunkEMO6YTKO_cjs.k.test(t.name))return {ok:false,code:"invalidArgs",reason:"the definition identity must match defineCustomNode\u2019s charset ([A-Za-z0-9_.-])"};let s=chunkEMO6YTKO_cjs.b(t.tagPrefix,t.name,n);if(!s.ok)return {ok:false,code:"invalidArgs",reason:`the encoded tag is ${s.length} characters; Word caps w:tag at 64 \u2014 shorten the attrs`};let d=o.lock===void 0?"contentLocked":o.lock,m=o.id!==void 0&&Number.isInteger(o.id)&&o.id>0?o.id:store.fnv1a32(`${s.tag}\0${r}`)&2147483647||1,e=o.data===void 0?null:Q(t,o,r);if(e&&"reason"in e)return {ok:false,code:"invalidArgs",reason:e.reason};let u=(o.alias!==void 0?`<w:alias w:val="${a(o.alias)}"/>`:"")+`<w:tag w:val="${a(s.tag)}"/><w:id w:val="${m}"/>`+(d===false?"":`<w:lock w:val="${d}"/>`)+(e?`<w:dataBinding w:prefixMappings="${a(e.binding.prefixMappings)}" w:xpath="${a(e.binding.xpath)}" w:storeItemID="${a(e.binding.storeItemId)}"/>`:""),c=`<w:r><w:t xml:space="preserve">${a(r)}</w:t></w:r>`;return {ok:true,xml:`<w:sdt><w:sdtPr>${u}</w:sdtPr><w:sdtContent>${c}</w:sdtContent></w:sdt>`,...e?{store:e.store}:{}}}function Q(t,n,r){let o=chunkEMO6YTKO_cjs.i(t,n.data);if(!o.ok)return {reason:o.reason};let s=chunkEMO6YTKO_cjs.h(t),d=n.storeIndex!==void 0&&Number.isInteger(n.storeIndex)&&n.storeIndex>0?n.storeIndex:1,m=n.nodeId??"cx1",e=`/customXml/item${String(d)}.xml`,u=`/customXml/itemProps${String(d)}.xml`,c=store.datastoreItemIdFor(`${s} ${e} ${m}`),g=store.customNodeBinding({partName:e,propsPartName:u,itemId:c,namespaceUri:s},chunkEMO6YTKO_cjs.g,m);if(!g)return {reason:`the payload cannot be addressed by an XPath: check nodeId (${m}) and payloadNamespace`};let l=r===r.trim()?`<label>${a(r)}</label>`:`<label xml:space="preserve">${a(r)}</label>`;return {binding:g,store:{itemPartName:e,itemXml:`<${chunkEMO6YTKO_cjs.g} xmlns="${a(s)}"><node id="${a(m)}">${l}<data>${a(o.data)}</data></node></${chunkEMO6YTKO_cjs.g}>`,propsPartName:u,propsXml:`<ds:datastoreItem ds:itemID="${a(c)}" xmlns:ds="${store.DATASTORE_NAMESPACE_URI}"><ds:schemaRefs><ds:schemaRef ds:uri="${a(s)}"/></ds:schemaRefs></ds:datastoreItem>`,storeItemId:c,relationships:[{from:"/word/document.xml",type:store.CUSTOM_XML_REL,target:`../customXml/item${String(d)}.xml`},{from:e,type:store.CUSTOM_XML_PROPS_REL,target:`itemProps${String(d)}.xml`}],contentTypeOverride:{partName:u,contentType:store.CUSTOM_XML_PROPS_TYPE}}}}Object.defineProperty(exports,"CUSTOM_NODE_STORE_ROOT",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.g}});Object.defineProperty(exports,"MAX_CUSTOM_NODE_DATA_LENGTH",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.d}});Object.defineProperty(exports,"MAX_TAG_LENGTH",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.a}});Object.defineProperty(exports,"customNodeNamespace",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.h}});Object.defineProperty(exports,"customNodesModule",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.m}});Object.defineProperty(exports,"decodeCustomNodeTag",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.c}});Object.defineProperty(exports,"defineCustomNode",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.l}});Object.defineProperty(exports,"encodeCustomNodeTag",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.b}});Object.defineProperty(exports,"insertCustomNode",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.p}});Object.defineProperty(exports,"isCustomNodeDefinition",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.j}});Object.defineProperty(exports,"parseCustomNodeData",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.e}});Object.defineProperty(exports,"recognizeCustomNodes",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.n}});Object.defineProperty(exports,"removeCustomNode",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.q}});Object.defineProperty(exports,"reviewModule",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.o}});Object.defineProperty(exports,"serializeCustomNodeData",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.f}});Object.defineProperty(exports,"updateCustomNode",{enumerable:true,get:function(){return chunkEMO6YTKO_cjs.r}});Object.defineProperty(exports,"collaborationModule",{enumerable:true,get:function(){return chunkQLZH2Q2C_cjs.b}});exports.customNodeXml=K;exports.customNodesOf=U;exports.prepareForExport=E;exports.saveForExport=G;

package/dist/index.d.cts

@@ -1,8 +1,10 @@
-import { A as AnyCustomNodeDefinition, C as CustomNodeDiagnostic, R as RecognizedCustomNode, S as StandardSchemaV1, I as InferSchemaInput, a as CustomNodeDefinition } from './define-custom-node-Bk8kFO27.cjs';
-export { b as ActivatedCustomNode, c as CustomNode, d as CustomNodeDataRejection, e as CustomNodeDataResult, f as CustomNodePayloadSource, g as CustomNodesModuleOptions, h as InferSchemaOutput, M as MAX_CUSTOM_NODE_DATA_LENGTH, P as ProLicenseOptions, i as RecognizeCustomNodesOptions, j as ReviewModuleOptions, k as StandardSchemaIssue, l as StandardSchemaResult, m as customNodesModule, n as defineCustomNode, o as isCustomNodeDefinition, p as parseCustomNodeData, r as recognizeCustomNodes, q as reviewModule, s as serializeCustomNodeData } from './define-custom-node-Bk8kFO27.cjs';
+import { A as AnyCustomNodeDefinition, C as CustomNodeDiagnostic, R as RecognizedCustomNode, S as StandardSchemaV1, I as InferSchemaInput, a as CustomNodeDefinition } from './define-custom-node-B_p2nr9T.cjs';
+export { b as ActivatedCustomNode, c as CustomNode, d as CustomNodeDataRejection, e as CustomNodeDataResult, f as CustomNodePayloadSource, g as CustomNodesModuleOptions, h as InferSchemaOutput, M as MAX_CUSTOM_NODE_DATA_LENGTH, i as RecognizeCustomNodesOptions, j as ReviewModuleOptions, k as StandardSchemaIssue, l as StandardSchemaResult, m as customNodesModule, n as defineCustomNode, o as isCustomNodeDefinition, p as parseCustomNodeData, r as recognizeCustomNodes, q as reviewModule, s as serializeCustomNodeData } from './define-custom-node-B_p2nr9T.cjs';
+export { C as CollaborationModuleOptions, P as ProLicenseOptions, c as collaborationModule } from './collaboration-module-BgRxhW5b.cjs';
 import { Editor, ExecResult } from '@docx-editor.dev/core/contracts/editor';
 import '@docx-editor.dev/core/editor';
 import '@docx-editor.dev/core/store';
+import '@docx-editor.dev/core/collaboration';
 
 /** How {@link customNodesOf} narrows what it answers. */
 interface CustomNodesOfOptions {

package/dist/index.d.ts

@@ -1,8 +1,10 @@
-import { A as AnyCustomNodeDefinition, C as CustomNodeDiagnostic, R as RecognizedCustomNode, S as StandardSchemaV1, I as InferSchemaInput, a as CustomNodeDefinition } from './define-custom-node-Bk8kFO27.js';
-export { b as ActivatedCustomNode, c as CustomNode, d as CustomNodeDataRejection, e as CustomNodeDataResult, f as CustomNodePayloadSource, g as CustomNodesModuleOptions, h as InferSchemaOutput, M as MAX_CUSTOM_NODE_DATA_LENGTH, P as ProLicenseOptions, i as RecognizeCustomNodesOptions, j as ReviewModuleOptions, k as StandardSchemaIssue, l as StandardSchemaResult, m as customNodesModule, n as defineCustomNode, o as isCustomNodeDefinition, p as parseCustomNodeData, r as recognizeCustomNodes, q as reviewModule, s as serializeCustomNodeData } from './define-custom-node-Bk8kFO27.js';
+import { A as AnyCustomNodeDefinition, C as CustomNodeDiagnostic, R as RecognizedCustomNode, S as StandardSchemaV1, I as InferSchemaInput, a as CustomNodeDefinition } from './define-custom-node-BehI3jWX.js';
+export { b as ActivatedCustomNode, c as CustomNode, d as CustomNodeDataRejection, e as CustomNodeDataResult, f as CustomNodePayloadSource, g as CustomNodesModuleOptions, h as InferSchemaOutput, M as MAX_CUSTOM_NODE_DATA_LENGTH, i as RecognizeCustomNodesOptions, j as ReviewModuleOptions, k as StandardSchemaIssue, l as StandardSchemaResult, m as customNodesModule, n as defineCustomNode, o as isCustomNodeDefinition, p as parseCustomNodeData, r as recognizeCustomNodes, q as reviewModule, s as serializeCustomNodeData } from './define-custom-node-BehI3jWX.js';
+export { C as CollaborationModuleOptions, P as ProLicenseOptions, c as collaborationModule } from './collaboration-module-BgRxhW5b.js';
 import { Editor, ExecResult } from '@docx-editor.dev/core/contracts/editor';
 import '@docx-editor.dev/core/editor';
 import '@docx-editor.dev/core/store';
+import '@docx-editor.dev/core/collaboration';
 
 /** How {@link customNodesOf} narrows what it answers. */
 interface CustomNodesOfOptions {

package/dist/index.js

@@ -1 +1 @@
-import {j,n,h,k,b as b$1,i,g,c}from'./chunk-TH5PXU6L.js';export{g as CUSTOM_NODE_STORE_ROOT,d as MAX_CUSTOM_NODE_DATA_LENGTH,a as MAX_TAG_LENGTH,h as customNodeNamespace,m as customNodesModule,c as decodeCustomNodeTag,l as defineCustomNode,b as encodeCustomNodeTag,p as insertCustomNode,j as isCustomNodeDefinition,e as parseCustomNodeData,n as recognizeCustomNodes,q as removeCustomNode,o as reviewModule,f as serializeCustomNodeData,r as updateCustomNode}from'./chunk-TH5PXU6L.js';import {customNodePayloadsByControl,readOoxmlPackage,withExportedCustomNodes,writeOoxmlPackage,isStoryPart,fnv1a32,datastoreItemIdFor,customNodeBinding,CUSTOM_XML_PROPS_TYPE,CUSTOM_XML_REL,CUSTOM_XML_PROPS_REL,DATASTORE_NAMESPACE_URI}from'@docx-editor.dev/core/store';function b(t,n$1={}){let r=U(t);if(!r)return [];let o=n$1.nodes??t.getCustomNodeDefinitions().filter(j);if(o.length===0)return [];let s=r.session.currentPackage(),d=r.session.part().name,m=n$1.onDiagnostic??(e=>{t.reportCustomNodeDiagnostic(e);});return r.session.storyParts().flatMap(e=>n(e,o,{payloads:customNodePayloadsByControl(s,e.name,d),onDiagnostic:m}))}function U(t){return t.surface??null}function E(t,n,r={}){if(r.destination==="internal")return {ok:true,bytes:t,unwrapped:0,removed:0};let o=readOoxmlPackage(t);if(!o.ok)return {ok:false,reason:`the document could not be read: ${o.reason}`};let s=new Map;for(let i of n)s.set(`${i.tagPrefix}:${i.name}`,i);let d=i=>{let p=c(i);if(!p)return "keep";let x=s.get(`${p.prefix}:${p.name}`);return x?x.preserveOnExport==="text"?"text":x.preserveOnExport===false?"remove":"keep":"keep"},m=[...new Set(n.filter(i=>i.preserveOnExport!==void 0).filter(i=>i.preserveOnExport!==true).map(h))],e=o.package,u=0,c$1=0,g=B(e);for(let i of g){let p=withExportedCustomNodes(e,{storyPartName:i,namespaces:[],decide:d});if(!p.ok)return {ok:false,reason:p.reason};e=p.pkg,u+=p.unwrapped,c$1+=p.removed;}let l=withExportedCustomNodes(e,{storyPartName:e.mainDocumentPart,namespaces:m,decide:()=>"keep"});return l.ok?(e=l.pkg,{ok:true,bytes:writeOoxmlPackage(e),unwrapped:u,removed:c$1}):{ok:false,reason:l.reason}}function B(t){let n=[];for(let[r,o]of t.parts)r!==t.mainDocumentPart&&isStoryPart(o)&&n.push(r);return [t.mainDocumentPart,...n]}async function V(t,n={}){let r=n.nodes??t.getCustomNodeDefinitions().filter(j),o=await t.save();return E(new Uint8Array(o),r,{...n.destination===void 0?{}:{destination:n.destination}})}function a(t){return t.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F]/g,"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}function J(t,n,r,o={}){if(!k.test(t.tagPrefix)||!k.test(t.name))return {ok:false,code:"invalidArgs",reason:"the definition identity must match defineCustomNode\u2019s charset ([A-Za-z0-9_.-])"};let s=b$1(t.tagPrefix,t.name,n);if(!s.ok)return {ok:false,code:"invalidArgs",reason:`the encoded tag is ${s.length} characters; Word caps w:tag at 64 \u2014 shorten the attrs`};let d=o.lock===void 0?"contentLocked":o.lock,m=o.id!==void 0&&Number.isInteger(o.id)&&o.id>0?o.id:fnv1a32(`${s.tag}\0${r}`)&2147483647||1,e=o.data===void 0?null:K(t,o,r);if(e&&"reason"in e)return {ok:false,code:"invalidArgs",reason:e.reason};let u=(o.alias!==void 0?`<w:alias w:val="${a(o.alias)}"/>`:"")+`<w:tag w:val="${a(s.tag)}"/><w:id w:val="${m}"/>`+(d===false?"":`<w:lock w:val="${d}"/>`)+(e?`<w:dataBinding w:prefixMappings="${a(e.binding.prefixMappings)}" w:xpath="${a(e.binding.xpath)}" w:storeItemID="${a(e.binding.storeItemId)}"/>`:""),c=`<w:r><w:t xml:space="preserve">${a(r)}</w:t></w:r>`;return {ok:true,xml:`<w:sdt><w:sdtPr>${u}</w:sdtPr><w:sdtContent>${c}</w:sdtContent></w:sdt>`,...e?{store:e.store}:{}}}function K(t,n,r){let o=i(t,n.data);if(!o.ok)return {reason:o.reason};let s=h(t),d=n.storeIndex!==void 0&&Number.isInteger(n.storeIndex)&&n.storeIndex>0?n.storeIndex:1,m=n.nodeId??"cx1",e=`/customXml/item${String(d)}.xml`,u=`/customXml/itemProps${String(d)}.xml`,c=datastoreItemIdFor(`${s} ${e} ${m}`),g$1=customNodeBinding({partName:e,propsPartName:u,itemId:c,namespaceUri:s},g,m);if(!g$1)return {reason:`the payload cannot be addressed by an XPath: check nodeId (${m}) and payloadNamespace`};let l=r===r.trim()?`<label>${a(r)}</label>`:`<label xml:space="preserve">${a(r)}</label>`;return {binding:g$1,store:{itemPartName:e,itemXml:`<${g} xmlns="${a(s)}"><node id="${a(m)}">${l}<data>${a(o.data)}</data></node></${g}>`,propsPartName:u,propsXml:`<ds:datastoreItem ds:itemID="${a(c)}" xmlns:ds="${DATASTORE_NAMESPACE_URI}"><ds:schemaRefs><ds:schemaRef ds:uri="${a(s)}"/></ds:schemaRefs></ds:datastoreItem>`,storeItemId:c,relationships:[{from:"/word/document.xml",type:CUSTOM_XML_REL,target:`../customXml/item${String(d)}.xml`},{from:e,type:CUSTOM_XML_PROPS_REL,target:`itemProps${String(d)}.xml`}],contentTypeOverride:{partName:u,contentType:CUSTOM_XML_PROPS_TYPE}}}}export{J as customNodeXml,b as customNodesOf,E as prepareForExport,V as saveForExport};
+import {j,n,h,k,b,i,g,c}from'./chunk-NQW54J56.js';export{g as CUSTOM_NODE_STORE_ROOT,d as MAX_CUSTOM_NODE_DATA_LENGTH,a as MAX_TAG_LENGTH,h as customNodeNamespace,m as customNodesModule,c as decodeCustomNodeTag,l as defineCustomNode,b as encodeCustomNodeTag,p as insertCustomNode,j as isCustomNodeDefinition,e as parseCustomNodeData,n as recognizeCustomNodes,q as removeCustomNode,o as reviewModule,f as serializeCustomNodeData,r as updateCustomNode}from'./chunk-NQW54J56.js';export{b as collaborationModule}from'./chunk-Q2VBO66F.js';import {customNodePayloadsByControl,readOoxmlPackage,withExportedCustomNodes,writeOoxmlPackage,isStoryPart,fnv1a32,datastoreItemIdFor,customNodeBinding,CUSTOM_XML_PROPS_TYPE,CUSTOM_XML_REL,CUSTOM_XML_PROPS_REL,DATASTORE_NAMESPACE_URI}from'@docx-editor.dev/core/store';function U(t,n$1={}){let r=L(t);if(!r)return [];let o=n$1.nodes??t.getCustomNodeDefinitions().filter(j);if(o.length===0)return [];let s=r.session.currentPackage(),d=r.session.part().name,m=n$1.onDiagnostic??(e=>{t.reportCustomNodeDiagnostic(e);});return r.session.storyParts().flatMap(e=>n(e,o,{payloads:customNodePayloadsByControl(s,e.name,d),onDiagnostic:m}))}function L(t){return t.surface??null}function E(t,n,r={}){if(r.destination==="internal")return {ok:true,bytes:t,unwrapped:0,removed:0};let o=readOoxmlPackage(t);if(!o.ok)return {ok:false,reason:`the document could not be read: ${o.reason}`};let s=new Map;for(let i of n)s.set(`${i.tagPrefix}:${i.name}`,i);let d=i=>{let p=c(i);if(!p)return "keep";let x=s.get(`${p.prefix}:${p.name}`);return x?x.preserveOnExport==="text"?"text":x.preserveOnExport===false?"remove":"keep":"keep"},m=[...new Set(n.filter(i=>i.preserveOnExport!==void 0).filter(i=>i.preserveOnExport!==true).map(h))],e=o.package,u=0,c$1=0,g=V(e);for(let i of g){let p=withExportedCustomNodes(e,{storyPartName:i,namespaces:[],decide:d});if(!p.ok)return {ok:false,reason:p.reason};e=p.pkg,u+=p.unwrapped,c$1+=p.removed;}let l=withExportedCustomNodes(e,{storyPartName:e.mainDocumentPart,namespaces:m,decide:()=>"keep"});return l.ok?(e=l.pkg,{ok:true,bytes:writeOoxmlPackage(e),unwrapped:u,removed:c$1}):{ok:false,reason:l.reason}}function V(t){let n=[];for(let[r,o]of t.parts)r!==t.mainDocumentPart&&isStoryPart(o)&&n.push(r);return [t.mainDocumentPart,...n]}async function G(t,n={}){let r=n.nodes??t.getCustomNodeDefinitions().filter(j),o=await t.save();return E(new Uint8Array(o),r,{...n.destination===void 0?{}:{destination:n.destination}})}function a(t){return t.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F]/g,"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;")}function K(t,n,r,o={}){if(!k.test(t.tagPrefix)||!k.test(t.name))return {ok:false,code:"invalidArgs",reason:"the definition identity must match defineCustomNode\u2019s charset ([A-Za-z0-9_.-])"};let s=b(t.tagPrefix,t.name,n);if(!s.ok)return {ok:false,code:"invalidArgs",reason:`the encoded tag is ${s.length} characters; Word caps w:tag at 64 \u2014 shorten the attrs`};let d=o.lock===void 0?"contentLocked":o.lock,m=o.id!==void 0&&Number.isInteger(o.id)&&o.id>0?o.id:fnv1a32(`${s.tag}\0${r}`)&2147483647||1,e=o.data===void 0?null:Q(t,o,r);if(e&&"reason"in e)return {ok:false,code:"invalidArgs",reason:e.reason};let u=(o.alias!==void 0?`<w:alias w:val="${a(o.alias)}"/>`:"")+`<w:tag w:val="${a(s.tag)}"/><w:id w:val="${m}"/>`+(d===false?"":`<w:lock w:val="${d}"/>`)+(e?`<w:dataBinding w:prefixMappings="${a(e.binding.prefixMappings)}" w:xpath="${a(e.binding.xpath)}" w:storeItemID="${a(e.binding.storeItemId)}"/>`:""),c=`<w:r><w:t xml:space="preserve">${a(r)}</w:t></w:r>`;return {ok:true,xml:`<w:sdt><w:sdtPr>${u}</w:sdtPr><w:sdtContent>${c}</w:sdtContent></w:sdt>`,...e?{store:e.store}:{}}}function Q(t,n,r){let o=i(t,n.data);if(!o.ok)return {reason:o.reason};let s=h(t),d=n.storeIndex!==void 0&&Number.isInteger(n.storeIndex)&&n.storeIndex>0?n.storeIndex:1,m=n.nodeId??"cx1",e=`/customXml/item${String(d)}.xml`,u=`/customXml/itemProps${String(d)}.xml`,c=datastoreItemIdFor(`${s} ${e} ${m}`),g$1=customNodeBinding({partName:e,propsPartName:u,itemId:c,namespaceUri:s},g,m);if(!g$1)return {reason:`the payload cannot be addressed by an XPath: check nodeId (${m}) and payloadNamespace`};let l=r===r.trim()?`<label>${a(r)}</label>`:`<label xml:space="preserve">${a(r)}</label>`;return {binding:g$1,store:{itemPartName:e,itemXml:`<${g} xmlns="${a(s)}"><node id="${a(m)}">${l}<data>${a(o.data)}</data></node></${g}>`,propsPartName:u,propsXml:`<ds:datastoreItem ds:itemID="${a(c)}" xmlns:ds="${DATASTORE_NAMESPACE_URI}"><ds:schemaRefs><ds:schemaRef ds:uri="${a(s)}"/></ds:schemaRefs></ds:datastoreItem>`,storeItemId:c,relationships:[{from:"/word/document.xml",type:CUSTOM_XML_REL,target:`../customXml/item${String(d)}.xml`},{from:e,type:CUSTOM_XML_PROPS_REL,target:`itemProps${String(d)}.xml`}],contentTypeOverride:{partName:u,contentType:CUSTOM_XML_PROPS_TYPE}}}}export{K as customNodeXml,U as customNodesOf,E as prepareForExport,G as saveForExport};

package/dist/react/hocuspocus.cjs

@@ -0,0 +1 @@
+'use strict';var chunkGDTCNTK7_cjs=require('../chunk-GDTCNTK7.cjs');require('../chunk-QLZH2Q2C.cjs');var react=require('react');var i=Symbol("useHocuspocusCollaboration.createRoom");function u(o){return o?`${o.url}:${o.roomId}:${o.bootstrap.kind}:${o.identity.actorId}`:""}async function c(o){let{createHocuspocusCollaboration:n}=await import('../collaboration/hocuspocus.cjs');return n(o)}function p(o){return o[i]??c}function d(o={}){let n=react.useId(),e=chunkGDTCNTK7_cjs.b({ownerKey:`react-hocuspocus:${n}`,hookName:"useHocuspocusCollaboration",createRoom:p(o),hostModules:o.modules??chunkGDTCNTK7_cjs.a,autoRoom:o.room??null,autoKey:u(o.room??null),rejoinOptionsOf:t=>({...t,bootstrap:{kind:"join"}}),identityOf:t=>t.identity});return react.useMemo(()=>({document:e.document,modules:e.modules,session:e.session,ydoc:e.room?.ydoc??null,provider:e.room?.provider??null,pending:e.pending,error:e.error,connect:e.connect,leave:e.leave,rejoin:e.rejoin}),[e])}exports.useHocuspocusCollaboration=d;

package/dist/react/hocuspocus.d.cts

@@ -0,0 +1,104 @@
+import * as Y from 'yjs';
+import { HocuspocusProvider } from '@hocuspocus/provider';
+import { CollaborationIdentity, CollaborationFailure } from '@docx-editor.dev/core/collaboration';
+import { EditorModule } from '@docx-editor.dev/core/editor';
+import { a as CollaborationBootstrap, C as CollaborationSession } from '../session-BH7Qgyp6.cjs';
+export { b as CollaborationIdentityUpdate } from '../session-BH7Qgyp6.cjs';
+import 'y-protocols/awareness';
+
+/** Bootstrap for one Hocuspocus room. @public */
+type UseHocuspocusCollaborationBootstrap = CollaborationBootstrap;
+/** Arguments for {@link UseHocuspocusCollaborationReturn.connect}. @public */
+interface UseHocuspocusCollaborationConnectOptions {
+    /** Hocuspocus server WebSocket URL, for example `wss://collab.example.test`. */
+    readonly url: string;
+    readonly roomId: string;
+    /**
+     * Authentication token the provider sends in its auth handshake. Pass a callback and the
+     * provider re-evaluates it on every reconnect, which is how expiring JWTs renew.
+     */
+    readonly token?: string | (() => string | Promise<string>);
+    readonly identity: CollaborationIdentity;
+    readonly bootstrap: UseHocuspocusCollaborationBootstrap;
+    /** Bound on the wait for the server's initial sync. Default 30000 ms. */
+    readonly syncedTimeoutMs?: number;
+    /**
+     * Admit local edits while the transport is `disconnected`. Buffered updates merge on
+     * reconnect. See {@link CreateDocumentCollaborationOptions.offlineEditing}.
+     */
+    readonly offlineEditing?: boolean;
+}
+/** Input for {@link useHocuspocusCollaboration}. @public */
+interface UseHocuspocusCollaborationOptions {
+    /**
+     * Host modules. The hook adds `collaborationModule` when a room is ready.
+     * A host collaboration contribution is a configuration error and throws.
+     */
+    readonly modules?: readonly EditorModule[];
+    /**
+     * Connect this room on mount. Omit it and call
+     * {@link UseHocuspocusCollaborationReturn.connect} after the user chooses a room.
+     */
+    readonly room?: UseHocuspocusCollaborationConnectOptions | null;
+}
+/** Values {@link useHocuspocusCollaboration} returns. @public */
+interface UseHocuspocusCollaborationReturn {
+    readonly document: Uint8Array | null;
+    readonly modules: readonly EditorModule[];
+    readonly session: CollaborationSession | null;
+    /**
+     * The room's shared Yjs document, owned by the hook. Null while no room is connected.
+     *
+     * Read-only escape hatch: observe it or wire additional providers, but leave teardown to
+     * the hook.
+     */
+    readonly ydoc: Y.Doc | null;
+    /**
+     * The owned `@hocuspocus/provider` instance. Null while no room is connected.
+     *
+     * Read-only escape hatch for transport-level access (`disconnect()`/`connect()`,
+     * server events). The hook destroys it on leave and unmount.
+     */
+    readonly provider: HocuspocusProvider | null;
+    readonly pending: boolean;
+    readonly error: CollaborationFailure | null;
+    /**
+     * Connect a room. RESOLVES with the failure, or null on success — it does not reject.
+     *
+     * A rejection carried nothing the resolved value does not, and it made the ordinary call
+     * site wrong by default: `onClick={() => connect(options)}` produced an unhandled rejection
+     * on every failed connect. `error` reports the same failure for renderers.
+     */
+    readonly connect: (options: UseHocuspocusCollaborationConnectOptions) => Promise<CollaborationFailure | null>;
+    /**
+     * Destroy the room and carry on editing locally.
+     *
+     * The current bytes live in the editor, not in this hook, so the argument is required:
+     * pass `await editor.save()` to keep what the room typed. The hook remounts the editor
+     * from exactly these bytes.
+     */
+    readonly leave: (nextDocument: Uint8Array) => void;
+    /**
+     * Recover a session that reached status `error`: leave with `nextDocument`, then connect
+     * again to the same room with the same identity, url, and token.
+     *
+     * The reconnect always uses bootstrap `{ kind: 'join' }`, because the server still holds
+     * the room. When the server no longer holds it, the join rejects with
+     * `initialization-timeout` — nothing is lost, because `nextDocument` (your saved bytes)
+     * stays mounted locally. A connect that failed also counts as the prior attempt, so
+     * rejoin retries it as a joiner.
+     */
+    readonly rejoin: (nextDocument: Uint8Array) => Promise<CollaborationFailure | null>;
+}
+/**
+ * Own a Hocuspocus collaboration room for a React host.
+ *
+ * The default Pro React entry does not import this hook. Import it from
+ * `@docx-editor.dev/pro/react/hocuspocus` so a review-only bundle does not load
+ * a network provider.
+ *
+ * @public
+ */
+declare function useHocuspocusCollaboration(options?: UseHocuspocusCollaborationOptions): UseHocuspocusCollaborationReturn;
+
+export { CollaborationSession, type UseHocuspocusCollaborationBootstrap, type UseHocuspocusCollaborationConnectOptions, type UseHocuspocusCollaborationOptions, type UseHocuspocusCollaborationReturn, useHocuspocusCollaboration };

package/dist/react/hocuspocus.d.ts

@@ -0,0 +1,104 @@
+import * as Y from 'yjs';
+import { HocuspocusProvider } from '@hocuspocus/provider';
+import { CollaborationIdentity, CollaborationFailure } from '@docx-editor.dev/core/collaboration';
+import { EditorModule } from '@docx-editor.dev/core/editor';
+import { a as CollaborationBootstrap, C as CollaborationSession } from '../session-BH7Qgyp6.js';
+export { b as CollaborationIdentityUpdate } from '../session-BH7Qgyp6.js';
+import 'y-protocols/awareness';
+
+/** Bootstrap for one Hocuspocus room. @public */
+type UseHocuspocusCollaborationBootstrap = CollaborationBootstrap;
+/** Arguments for {@link UseHocuspocusCollaborationReturn.connect}. @public */
+interface UseHocuspocusCollaborationConnectOptions {
+    /** Hocuspocus server WebSocket URL, for example `wss://collab.example.test`. */
+    readonly url: string;
+    readonly roomId: string;
+    /**
+     * Authentication token the provider sends in its auth handshake. Pass a callback and the
+     * provider re-evaluates it on every reconnect, which is how expiring JWTs renew.
+     */
+    readonly token?: string | (() => string | Promise<string>);
+    readonly identity: CollaborationIdentity;
+    readonly bootstrap: UseHocuspocusCollaborationBootstrap;
+    /** Bound on the wait for the server's initial sync. Default 30000 ms. */
+    readonly syncedTimeoutMs?: number;
+    /**
+     * Admit local edits while the transport is `disconnected`. Buffered updates merge on
+     * reconnect. See {@link CreateDocumentCollaborationOptions.offlineEditing}.
+     */
+    readonly offlineEditing?: boolean;
+}
+/** Input for {@link useHocuspocusCollaboration}. @public */
+interface UseHocuspocusCollaborationOptions {
+    /**
+     * Host modules. The hook adds `collaborationModule` when a room is ready.
+     * A host collaboration contribution is a configuration error and throws.
+     */
+    readonly modules?: readonly EditorModule[];
+    /**
+     * Connect this room on mount. Omit it and call
+     * {@link UseHocuspocusCollaborationReturn.connect} after the user chooses a room.
+     */
+    readonly room?: UseHocuspocusCollaborationConnectOptions | null;
+}
+/** Values {@link useHocuspocusCollaboration} returns. @public */
+interface UseHocuspocusCollaborationReturn {
+    readonly document: Uint8Array | null;
+    readonly modules: readonly EditorModule[];
+    readonly session: CollaborationSession | null;
+    /**
+     * The room's shared Yjs document, owned by the hook. Null while no room is connected.
+     *
+     * Read-only escape hatch: observe it or wire additional providers, but leave teardown to
+     * the hook.
+     */
+    readonly ydoc: Y.Doc | null;
+    /**
+     * The owned `@hocuspocus/provider` instance. Null while no room is connected.
+     *
+     * Read-only escape hatch for transport-level access (`disconnect()`/`connect()`,
+     * server events). The hook destroys it on leave and unmount.
+     */
+    readonly provider: HocuspocusProvider | null;
+    readonly pending: boolean;
+    readonly error: CollaborationFailure | null;
+    /**
+     * Connect a room. RESOLVES with the failure, or null on success — it does not reject.
+     *
+     * A rejection carried nothing the resolved value does not, and it made the ordinary call
+     * site wrong by default: `onClick={() => connect(options)}` produced an unhandled rejection
+     * on every failed connect. `error` reports the same failure for renderers.
+     */
+    readonly connect: (options: UseHocuspocusCollaborationConnectOptions) => Promise<CollaborationFailure | null>;
+    /**
+     * Destroy the room and carry on editing locally.
+     *
+     * The current bytes live in the editor, not in this hook, so the argument is required:
+     * pass `await editor.save()` to keep what the room typed. The hook remounts the editor
+     * from exactly these bytes.
+     */
+    readonly leave: (nextDocument: Uint8Array) => void;
+    /**
+     * Recover a session that reached status `error`: leave with `nextDocument`, then connect
+     * again to the same room with the same identity, url, and token.
+     *
+     * The reconnect always uses bootstrap `{ kind: 'join' }`, because the server still holds
+     * the room. When the server no longer holds it, the join rejects with
+     * `initialization-timeout` — nothing is lost, because `nextDocument` (your saved bytes)
+     * stays mounted locally. A connect that failed also counts as the prior attempt, so
+     * rejoin retries it as a joiner.
+     */
+    readonly rejoin: (nextDocument: Uint8Array) => Promise<CollaborationFailure | null>;
+}
+/**
+ * Own a Hocuspocus collaboration room for a React host.
+ *
+ * The default Pro React entry does not import this hook. Import it from
+ * `@docx-editor.dev/pro/react/hocuspocus` so a review-only bundle does not load
+ * a network provider.
+ *
+ * @public
+ */
+declare function useHocuspocusCollaboration(options?: UseHocuspocusCollaborationOptions): UseHocuspocusCollaborationReturn;
+
+export { CollaborationSession, type UseHocuspocusCollaborationBootstrap, type UseHocuspocusCollaborationConnectOptions, type UseHocuspocusCollaborationOptions, type UseHocuspocusCollaborationReturn, useHocuspocusCollaboration };

package/dist/react/hocuspocus.js

@@ -0,0 +1 @@
+import {b,a}from'../chunk-HJB77VBO.js';import'../chunk-Q2VBO66F.js';import {useId,useMemo}from'react';var i=Symbol("useHocuspocusCollaboration.createRoom");function u(o){return o?`${o.url}:${o.roomId}:${o.bootstrap.kind}:${o.identity.actorId}`:""}async function c(o){let{createHocuspocusCollaboration:n}=await import('../collaboration/hocuspocus.js');return n(o)}function p(o){return o[i]??c}function d(o={}){let n=useId(),e=b({ownerKey:`react-hocuspocus:${n}`,hookName:"useHocuspocusCollaboration",createRoom:p(o),hostModules:o.modules??a,autoRoom:o.room??null,autoKey:u(o.room??null),rejoinOptionsOf:t=>({...t,bootstrap:{kind:"join"}}),identityOf:t=>t.identity});return useMemo(()=>({document:e.document,modules:e.modules,session:e.session,ydoc:e.room?.ydoc??null,provider:e.room?.provider??null,pending:e.pending,error:e.error,connect:e.connect,leave:e.leave,rejoin:e.rejoin}),[e])}export{d as useHocuspocusCollaboration};