@arbidocs/blocks 0.4.99 → 0.4.100

package/dist/{chunk-MABEOI4S.cjs → chunk-O24WPHLD.cjs}

@@ -2,7 +2,7 @@
 'use strict';
 
 var chunkMUMH3Z6K_cjs = require('./chunk-MUMH3Z6K.cjs');
-var chunk44TPPPRJ_cjs = require('./chunk-44TPPPRJ.cjs');
+var chunkB7P73VHX_cjs = require('./chunk-B7P73VHX.cjs');
 var react$1 = require('react');
 var reactQuery = require('@tanstack/react-query');
 var react = require('@arbidocs/react');
@@ -13,7 +13,7 @@ function ConnectedNativeDocxEditor({
   ...props
 }) {
   const adapter = useConnectedNativeDocxAdapter(fontBaseUrl);
-  return /* @__PURE__ */ jsxRuntime.jsx(chunk44TPPPRJ_cjs.NativeDocxEditor, { ...props, adapter });
+  return /* @__PURE__ */ jsxRuntime.jsx(chunkB7P73VHX_cjs.NativeDocxEditor, { ...props, adapter });
 }
 function useConnectedNativeDocxAdapter(fontBaseUrl = "/native-docx/fonts") {
   const arbi = react.useArbi();
@@ -42,7 +42,7 @@ function useConnectedNativeDocxAdapter(fontBaseUrl = "/native-docx/fonts") {
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({ state })
       })).json(),
-      loadFonts: () => chunk44TPPPRJ_cjs.loadDocxFonts(fontBaseUrl),
+      loadFonts: () => chunkB7P73VHX_cjs.loadDocxFonts(fontBaseUrl),
       baseUrl: apiUrl,
       author: user?.name || "You",
       onVersionSaved: async (id) => {
@@ -91,5 +91,5 @@ function useConnectedNativeDocxAdapter(fontBaseUrl = "/native-docx/fonts") {
 
 exports.ConnectedNativeDocxEditor = ConnectedNativeDocxEditor;
 exports.useConnectedNativeDocxAdapter = useConnectedNativeDocxAdapter;
-//# sourceMappingURL=chunk-MABEOI4S.cjs.map
-//# sourceMappingURL=chunk-MABEOI4S.cjs.map
+//# sourceMappingURL=chunk-O24WPHLD.cjs.map
+//# sourceMappingURL=chunk-O24WPHLD.cjs.map

package/dist/{chunk-MABEOI4S.cjs.map → chunk-O24WPHLD.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/connection/ConnectedNativeDocxEditor.tsx"],"names":["jsx","NativeDocxEditor","useArbi","useConnection","useQueryClient","useQuery","useMemo","loadDocxFonts","arbiQueryKeys","notify"],"mappings":";;;;;;;;;AAYO,SAAS,yBAAA,CAA0B;AAAA,EACxC,WAAA,GAAc,oBAAA;AAAA,EACd,GAAG;AACL,CAAA,EAAsE;AACpE,EAAA,MAAM,OAAA,GAAU,8BAA8B,WAAW,CAAA;AACzD,EAAA,uBAAOA,cAAA,CAACC,kCAAA,EAAA,EAAkB,GAAG,KAAA,EAAO,OAAA,EAAkB,CAAA;AACxD;AAEO,SAAS,6BAAA,CAA8B,cAAc,oBAAA,EAAsB;AAChF,EAAA,MAAM,OAAOC,aAAA,EAAQ;AACrB,EAAA,MAAM,EAAE,WAAA,EAAa,MAAA,EAAQ,IAAA,EAAM,mBAAA,KAAwBC,+BAAA,EAAc;AACzE,EAAA,MAAM,UAAUC,yBAAA,EAAe;AAC/B,EAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAQ,GAAIC,mBAAA,CAAS;AAAA,IACjC,UAAU,CAAC,qBAAA,EAAuB,MAAA,EAAQ,IAAA,EAAM,YAAY,WAAW,CAAA;AAAA,IACvE,OAAA,EAAS,IAAA,CAAK,UAAA,IAAc,CAAC,CAAC,WAAA;AAAA,IAC9B,SAAS,YAAY;AACnB,MAAA,MAAM,mBAAA,EAAoB;AAC1B,MAAA,OAAO,IAAA,CAAK,WAAW,SAAA,EAAU;AAAA,IACnC;AAAA,GACD,CAAA;AACD,EAAA,MAAM,OAAA,GAAUC,eAAA;AAAA,IACd,OAAO;AAAA,MACL,OAAA,EAAS,OAAO,IAAA,EAAM,OAAA,KAAY;AAChC,QAAA,MAAM,mBAAA,EAAoB;AAC1B,QAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AAAA,MAC1C,CAAA;AAAA,MACA,IAAA,EAAM,OAAO,EAAA,KAAO;AAClB,QAAA,MAAM,mBAAA,EAAoB;AAC1B,QAAA,OAAA,CACE,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,IAAI,kBAAA,CAAmB,EAAE,CAAC,CAAA,QAAA,CAAA,EAAY,EAAE,MAAA,EAAQ,MAAA,EAAQ,GAClF,IAAA,EAAK;AAAA,MACT,CAAA;AAAA,MACA,IAAA,EAAM,OAAO,EAAA,EAAI,KAAA,KAAA,CAEb,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,CAAA,CAAA,EAAI,kBAAA,CAAmB,EAAE,CAAC,CAAA,KAAA,CAAA,EAAS;AAAA,QAC3D,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,QAC9C,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,EAAE,OAAO;AAAA,OAC/B,GACD,IAAA,EAAK;AAAA,MACT,SAAA,EAAW,MAAMC,+BAAA,CAAc,WAAW,CAAA;AAAA,MAC1C,OAAA,EAAS,MAAA;AAAA,MACT,MAAA,EAAQ,MAAM,IAAA,IAAQ,KAAA;AAAA,MACtB,cAAA,EAAgB,OAAO,EAAA,KAAO;AAC5B,QAAA,IAAI,CAAC,WAAA,EAAa;AAClB,QAAA,MAAM,GAAA,GAAMC,mBAAA,CAAc,SAAA,CAAU,WAAW,CAAA;AAC/C,QAAA,IAAI;AACF,UAAA,MAAM,YAAY,MAAM,IAAA,CAAK,UAAU,GAAA,CAAI,CAAC,EAAE,CAAC,CAAA;AAC/C,UAAA,IAAI,CAAC,SAAA,CAAU,MAAA,EAAQ,MAAM,IAAI,MAAM,yCAAyC,CAAA;AAChF,UAAA,OAAA,CAAQ,YAAA,CAA8D,GAAA,EAAK,CAAC,QAAA,KAAa;AAAA,YACvF,GAAG,SAAA;AAAA,YACH,GAAA,CAAI,QAAA,IAAY,EAAC,EAAG,MAAA;AAAA,cAClB,CAAC,GAAA,KAAQ,CAAC,SAAA,CAAU,IAAA,CAAK,CAAC,KAAA,KAAU,KAAA,CAAM,WAAA,KAAgB,GAAA,CAAI,WAAW;AAAA;AAC3E,WACD,CAAA;AAAA,QACH,CAAA,CAAA,MAAQ;AACN,UAAA,MAAM,OAAA,CAAQ,iBAAA,CAAkB,EAAE,QAAA,EAAU,KAAK,CAAA;AAAA,QACnD;AAAA,MACF,CAAA;AAAA,MACA,QAAQ,CAAC,OAAA,EAAS,SAASC,YAAA,CAAO,IAAI,EAAE,OAAO,CAAA;AAAA,MAC/C,UAAU,OAAA,EAAS,GAAA,CAAI,CAAC,EAAE,IAAA,EAAM,QAAO,MAAO;AAAA,QAC5C,IAAI,MAAA,CAAO,WAAA;AAAA,QACX,IAAA,EAAM,CAAC,MAAA,CAAO,UAAA,EAAY,MAAA,CAAO,WAAW,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAAA,QACtE,MAAM,MAAA,CAAO,WAAA,CAAY,UAAA,CAAW,MAAM,IAAI,OAAA,GAAU;AAAA,OAC1D,CAAE,CAAA;AAAA,MACF,YAAA,EAAc,OAAO,EAAA,EAAI,OAAA,KAAY;AACnC,QAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,MAAA,CAAO,QAAQ,CAAA,CAAA,EAAI,kBAAA,CAAmB,EAAE,CAAC,CAAA,SAAA,CAAA,EAAa;AAAA,UAChF,MAAA,EAAQ,MAAA;AAAA,UACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,UAC9C,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,YACnB,YAAY,OAAA,CAAQ,SAAA;AAAA,YACpB,aAAa,OAAA,CAAQ,WAAA;AAAA,YACrB,YAAY,OAAA,CAAQ,SAAA;AAAA,YACpB,eAAe,OAAA,CAAQ;AAAA,WACxB;AAAA,SACF,CAAA;AACD,QAAA,MAAM,QAAA,GAAY,MAAM,QAAA,CAAS,IAAA,EAAK;AACtC,QAAAA,YAAA,CAAO,QAAQ,oBAAoB,CAAA;AACnC,QAAA,OAAO,EAAE,WAAA,EAAa,QAAA,CAAS,YAAA,IAAgB,EAAC,EAAE;AAAA,MACpD,CAAA;AAAA,MACA,cAAA,EAAgB,OAAO,UAAA,KAAA,CAAgB,MAAM,KAAK,SAAA,CAAU,WAAA,CAAY,UAAU,CAAA,EAAG;AAAA,KACvF,CAAA;AAAA,IACA,CAAC,MAAM,MAAA,EAAQ,IAAA,EAAM,MAAM,OAAA,EAAS,mBAAA,EAAqB,WAAA,EAAa,OAAA,EAAS,WAAW;AAAA,GAC5F;AACA,EAAA,OAAO,OAAA;AACT","file":"chunk-MABEOI4S.cjs","sourcesContent":["import { useMemo } from 'react'\nimport { useQuery, useQueryClient } from '@tanstack/react-query'\nimport { useArbi, notify, arbiQueryKeys } from '@arbidocs/react'\nimport { useConnection } from './ConnectionProvider'\nimport {\n  NativeDocxEditor,\n  type NativeDocxAdapter,\n  type NativeDocxEditorProps,\n} from '../docx/NativeDocxEditor'\nimport { loadDocxFonts } from '../docx/fonts'\n\n/** Native Word widget bound to the standard blocks connection and SDK session. */\nexport function ConnectedNativeDocxEditor({\n  fontBaseUrl = '/native-docx/fonts',\n  ...props\n}: Omit<NativeDocxEditorProps, 'adapter'> & { fontBaseUrl?: string }) {\n  const adapter = useConnectedNativeDocxAdapter(fontBaseUrl)\n  return <NativeDocxEditor {...props} adapter={adapter} />\n}\n\nexport function useConnectedNativeDocxAdapter(fontBaseUrl = '/native-docx/fonts') {\n  const arbi = useArbi()\n  const { workspaceId, apiUrl, user, ensureWorkspaceOpen } = useConnection()\n  const queries = useQueryClient()\n  const { data: members } = useQuery({\n    queryKey: ['native-docx-members', apiUrl, user?.externalId, workspaceId],\n    enabled: arbi.isLoggedIn && !!workspaceId,\n    queryFn: async () => {\n      await ensureWorkspaceOpen()\n      return arbi.workspaces.listUsers()\n    },\n  })\n  const adapter = useMemo<NativeDocxAdapter>(\n    () => ({\n      request: async (path, options) => {\n        await ensureWorkspaceOpen()\n        return arbi.editor.request(path, options)\n      },\n      open: async (id) => {\n        await ensureWorkspaceOpen()\n        return (\n          await arbi.editor.request(`/${encodeURIComponent(id)}/session`, { method: 'POST' })\n        ).json()\n      },\n      save: async (id, state) =>\n        (\n          await arbi.editor.request(`/${encodeURIComponent(id)}/save`, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json' },\n            body: JSON.stringify({ state }),\n          })\n        ).json(),\n      loadFonts: () => loadDocxFonts(fontBaseUrl),\n      baseUrl: apiUrl,\n      author: user?.name || 'You',\n      onVersionSaved: async (id) => {\n        if (!workspaceId) return\n        const key = arbiQueryKeys.documents(workspaceId)\n        try {\n          const documents = await arbi.documents.get([id])\n          if (!documents.length) throw new Error('The saved version is not available yet.')\n          queries.setQueryData<Awaited<ReturnType<typeof arbi.documents.list>>>(key, (previous) => [\n            ...documents,\n            ...(previous || []).filter(\n              (doc) => !documents.some((saved) => saved.external_id === doc.external_id)\n            ),\n          ])\n        } catch {\n          await queries.invalidateQueries({ queryKey: key })\n        }\n      },\n      notify: (message, kind) => notify[kind](message),\n      mentions: members?.map(({ user: member }) => ({\n        id: member.external_id,\n        name: [member.given_name, member.family_name].filter(Boolean).join(' '),\n        kind: member.external_id.startsWith('agt-') ? 'agent' : 'human',\n      })),\n      requestAgent: async (id, request) => {\n        const response = await arbi.editor.request(`/${encodeURIComponent(id)}/mentions`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({\n            comment_id: request.commentId,\n            instruction: request.instruction,\n            request_id: request.requestId,\n            recipient_ids: request.recipientIds,\n          }),\n        })\n        const delivery = (await response.json()) as { response_ids: string[] }\n        notify.success('Mention delivered.')\n        return { responseIds: delivery.response_ids || [] }\n      },\n      getAgentStatus: async (responseId) => (await arbi.assistant.getResponse(responseId)).status,\n    }),\n    [arbi, apiUrl, user?.name, members, ensureWorkspaceOpen, fontBaseUrl, queries, workspaceId]\n  )\n  return adapter\n}\n"]}
+{"version":3,"sources":["../src/connection/ConnectedNativeDocxEditor.tsx"],"names":["jsx","NativeDocxEditor","useArbi","useConnection","useQueryClient","useQuery","useMemo","loadDocxFonts","arbiQueryKeys","notify"],"mappings":"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","file":"chunk-O24WPHLD.cjs","sourcesContent":["import { useMemo } from 'react'\nimport { useQuery, useQueryClient } from '@tanstack/react-query'\nimport { useArbi, notify, arbiQueryKeys } from '@arbidocs/react'\nimport { useConnection } from './ConnectionProvider'\nimport {\n  NativeDocxEditor,\n  type NativeDocxAdapter,\n  type NativeDocxEditorProps,\n} from '../docx/NativeDocxEditor'\nimport { loadDocxFonts } from '../docx/fonts'\n\n/** Native Word widget bound to the standard blocks connection and SDK session. */\nexport function ConnectedNativeDocxEditor({\n  fontBaseUrl = '/native-docx/fonts',\n  ...props\n}: Omit<NativeDocxEditorProps, 'adapter'> & { fontBaseUrl?: string }) {\n  const adapter = useConnectedNativeDocxAdapter(fontBaseUrl)\n  return <NativeDocxEditor {...props} adapter={adapter} />\n}\n\nexport function useConnectedNativeDocxAdapter(fontBaseUrl = '/native-docx/fonts') {\n  const arbi = useArbi()\n  const { workspaceId, apiUrl, user, ensureWorkspaceOpen } = useConnection()\n  const queries = useQueryClient()\n  const { data: members } = useQuery({\n    queryKey: ['native-docx-members', apiUrl, user?.externalId, workspaceId],\n    enabled: arbi.isLoggedIn && !!workspaceId,\n    queryFn: async () => {\n      await ensureWorkspaceOpen()\n      return arbi.workspaces.listUsers()\n    },\n  })\n  const adapter = useMemo<NativeDocxAdapter>(\n    () => ({\n      request: async (path, options) => {\n        await ensureWorkspaceOpen()\n        return arbi.editor.request(path, options)\n      },\n      open: async (id) => {\n        await ensureWorkspaceOpen()\n        return (\n          await arbi.editor.request(`/${encodeURIComponent(id)}/session`, { method: 'POST' })\n        ).json()\n      },\n      save: async (id, state) =>\n        (\n          await arbi.editor.request(`/${encodeURIComponent(id)}/save`, {\n            method: 'POST',\n            headers: { 'Content-Type': 'application/json' },\n            body: JSON.stringify({ state }),\n          })\n        ).json(),\n      loadFonts: () => loadDocxFonts(fontBaseUrl),\n      baseUrl: apiUrl,\n      author: user?.name || 'You',\n      onVersionSaved: async (id) => {\n        if (!workspaceId) return\n        const key = arbiQueryKeys.documents(workspaceId)\n        try {\n          const documents = await arbi.documents.get([id])\n          if (!documents.length) throw new Error('The saved version is not available yet.')\n          queries.setQueryData<Awaited<ReturnType<typeof arbi.documents.list>>>(key, (previous) => [\n            ...documents,\n            ...(previous || []).filter(\n              (doc) => !documents.some((saved) => saved.external_id === doc.external_id)\n            ),\n          ])\n        } catch {\n          await queries.invalidateQueries({ queryKey: key })\n        }\n      },\n      notify: (message, kind) => notify[kind](message),\n      mentions: members?.map(({ user: member }) => ({\n        id: member.external_id,\n        name: [member.given_name, member.family_name].filter(Boolean).join(' '),\n        kind: member.external_id.startsWith('agt-') ? 'agent' : 'human',\n      })),\n      requestAgent: async (id, request) => {\n        const response = await arbi.editor.request(`/${encodeURIComponent(id)}/mentions`, {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({\n            comment_id: request.commentId,\n            instruction: request.instruction,\n            request_id: request.requestId,\n            recipient_ids: request.recipientIds,\n          }),\n        })\n        const delivery = (await response.json()) as { response_ids: string[] }\n        notify.success('Mention delivered.')\n        return { responseIds: delivery.response_ids || [] }\n      },\n      getAgentStatus: async (responseId) => (await arbi.assistant.getResponse(responseId)).status,\n    }),\n    [arbi, apiUrl, user?.name, members, ensureWorkspaceOpen, fontBaseUrl, queries, workspaceId]\n  )\n  return adapter\n}\n"]}

package/dist/connect/docx.cjs

@@ -1,10 +1,10 @@
 "use client";
 'use strict';
 
-var chunkMABEOI4S_cjs = require('../chunk-MABEOI4S.cjs');
+var chunkO24WPHLD_cjs = require('../chunk-O24WPHLD.cjs');
 require('../chunk-MUMH3Z6K.cjs');
-var chunkQBEUCOC7_cjs = require('../chunk-QBEUCOC7.cjs');
-require('../chunk-44TPPPRJ.cjs');
+var chunkIE55TWIG_cjs = require('../chunk-IE55TWIG.cjs');
+require('../chunk-B7P73VHX.cjs');
 require('../chunk-AOFATOT3.cjs');
 require('../chunk-RC25WMVB.cjs');
 require('../chunk-7UTB4PHM.cjs');
@@ -16,13 +16,13 @@ function ConnectedStreamedWordArtifact({
   fontBaseUrl,
   ...props
 }) {
-  const adapter = chunkMABEOI4S_cjs.useConnectedNativeDocxAdapter(fontBaseUrl);
-  return /* @__PURE__ */ jsxRuntime.jsx(chunkQBEUCOC7_cjs.StreamedWordArtifact, { ...props, adapter });
+  const adapter = chunkO24WPHLD_cjs.useConnectedNativeDocxAdapter(fontBaseUrl);
+  return /* @__PURE__ */ jsxRuntime.jsx(chunkIE55TWIG_cjs.StreamedWordArtifact, { ...props, adapter });
 }
 
 Object.defineProperty(exports, "ConnectedNativeDocxEditor", {
   enumerable: true,
-  get: function () { return chunkMABEOI4S_cjs.ConnectedNativeDocxEditor; }
+  get: function () { return chunkO24WPHLD_cjs.ConnectedNativeDocxEditor; }
 });
 exports.ConnectedStreamedWordArtifact = ConnectedStreamedWordArtifact;
 //# sourceMappingURL=docx.cjs.map

package/dist/connect/docx.js

@@ -1,9 +1,9 @@
 "use client";
-import { useConnectedNativeDocxAdapter } from '../chunk-C5RF47LD.js';
-export { ConnectedNativeDocxEditor } from '../chunk-C5RF47LD.js';
+import { useConnectedNativeDocxAdapter } from '../chunk-6HZNFOHW.js';
+export { ConnectedNativeDocxEditor } from '../chunk-6HZNFOHW.js';
 import '../chunk-OYMWV45N.js';
-import { StreamedWordArtifact } from '../chunk-3ICWR3BK.js';
-import '../chunk-4ZTIMQ7Z.js';
+import { StreamedWordArtifact } from '../chunk-E2QWWLK5.js';
+import '../chunk-72PQ42YI.js';
 import '../chunk-D3QPYKZG.js';
 import '../chunk-AF6RDAJF.js';
 import '../chunk-AA3PT6KR.js';

package/dist/connect/index.cjs

@@ -3,10 +3,10 @@
 
 var chunk5YXG342J_cjs = require('../chunk-5YXG342J.cjs');
 var chunkXMBYDLZQ_cjs = require('../chunk-XMBYDLZQ.cjs');
-var chunkMABEOI4S_cjs = require('../chunk-MABEOI4S.cjs');
+var chunkO24WPHLD_cjs = require('../chunk-O24WPHLD.cjs');
 var chunkMUMH3Z6K_cjs = require('../chunk-MUMH3Z6K.cjs');
 var chunkJH6JTI76_cjs = require('../chunk-JH6JTI76.cjs');
-require('../chunk-44TPPPRJ.cjs');
+require('../chunk-B7P73VHX.cjs');
 var chunkO4YPVYPO_cjs = require('../chunk-O4YPVYPO.cjs');
 var chunkLENXDIMY_cjs = require('../chunk-LENXDIMY.cjs');
 var chunkAOFATOT3_cjs = require('../chunk-AOFATOT3.cjs');
@@ -663,7 +663,7 @@ function WorkflowWordDialog({
       title: title ?? labels.wordTitle,
       size: "xl",
       testId: "workflow-word-dialog",
-      children: /* @__PURE__ */ jsxRuntime.jsx(chunkULWRNGGE_cjs.ModalScaffold.Body, { className: "h-[70dvh] p-0", children: /* @__PURE__ */ jsxRuntime.jsx(chunkMABEOI4S_cjs.ConnectedNativeDocxEditor, { documentId: id, title: title ?? labels.wordTitle }) })
+      children: /* @__PURE__ */ jsxRuntime.jsx(chunkULWRNGGE_cjs.ModalScaffold.Body, { className: "h-[70dvh] p-0", children: /* @__PURE__ */ jsxRuntime.jsx(chunkO24WPHLD_cjs.ConnectedNativeDocxEditor, { documentId: id, title: title ?? labels.wordTitle }) })
     }
   );
 }

package/dist/connect/index.js

@@ -2,11 +2,11 @@
 import { SettingsSection, ProfileCard, AvatarPicker, IdentityVerificationCard, IdentityVerificationDialog, RequireVerified, SettingsCard, SettingsActionRow, PasswordChangeDialog, EMAIL_NOTIFICATION_KEYS, EMAIL_NOTIFICATION_CATEGORIES, NotificationCategoryList, toNotificationCategories, toActiveSessionViews, SettingsRow, ActiveSessionsDialog, LogoutDialog, toLogoutSessionViews, SettingsDangerZone, DeleteAccountDialog, toDeleteBlockerViews } from '../chunk-W7NZRZ54.js';
 import { useWorkspaceDocs } from '../chunk-XQDM6T6C.js';
 export { ConnectedAssistantDock, redlineStats, textToArtifact, toRedlineMarkdown, useConnectedAiTask, useConnectedChat, useSemanticSearch, useWorkspaceDocs } from '../chunk-XQDM6T6C.js';
-import { ConnectedNativeDocxEditor } from '../chunk-C5RF47LD.js';
+import { ConnectedNativeDocxEditor } from '../chunk-6HZNFOHW.js';
 import { ConnectionProvider, useConnection } from '../chunk-OYMWV45N.js';
 export { ConnectionProvider, SESSION_EXPIRED_MESSAGE, isAuthenticated, useConnection } from '../chunk-OYMWV45N.js';
 import { SignDocumentDialog } from '../chunk-2YOVK524.js';
-import '../chunk-4ZTIMQ7Z.js';
+import '../chunk-72PQ42YI.js';
 import { FilesFilterBar, FolderFilterButton, FolderPickerRow } from '../chunk-7RJTEWYM.js';
 import { WorkspaceActivityList, WorkspaceNotificationMenu, ThreadFollowMenuItem, ThreadFollowButton, TagTable, tagTableDocx } from '../chunk-Z3G65XHZ.js';
 import { DOCX_MIME_TYPE } from '../chunk-D3QPYKZG.js';

package/dist/docx/NativeDocxEditor.d.ts

@@ -3,6 +3,7 @@ import React from 'react';
 import { type FontConfiguration } from '@docx-editor.dev/react';
 import type { DocxCollaborationSession } from '@arbidocs/coedit';
 import type { DefinitionSource } from '../tags/definitions';
+import { type DocxImageGeneration } from './layout/GenerateImage';
 import { type HouseTemplateHost } from './template/HouseTemplate';
 /**
  * The editor path of a document's DOCX bytes. A version reference (`doc-…@v2`, a read-only
@@ -45,6 +46,8 @@ export interface NativeDocxAdapter {
      * Defined term and Update definitions, and typing `@@` in the body opens the term type-ahead.
      */
     definitions?: () => Promise<DefinitionSource[]>;
+    /** The platform's image generation. Present: the Insert tab offers Generate image. */
+    imageGeneration?: DocxImageGeneration;
     /**
      * The workspace's house template. Present: a blank note starts from it (its styles, numbering,
      * page setup, headers and footers), Insert offers its Quick Parts, and the Design tab and the
@@ -74,8 +77,10 @@ export interface NativeDocxEditorProps {
 export declare function DocxParticipants({ session }: {
     session?: DocxCollaborationSession;
 }): React.JSX.Element;
-export declare function DocxRibbon({ onSave, badge, }: {
+export declare function DocxRibbon({ onSave, badge, imageGeneration, }: {
     onSave: () => void;
+    /** Insert › Generate image, when the host can generate images. */
+    imageGeneration?: DocxImageGeneration;
     /** A short state label at the end of the row, such as "Co-edit mode". */
     badge?: React.ReactNode;
 }): React.JSX.Element;

package/dist/docx/index.cjs

@@ -1,8 +1,8 @@
 "use client";
 'use strict';
 
-var chunkQBEUCOC7_cjs = require('../chunk-QBEUCOC7.cjs');
-var chunk44TPPPRJ_cjs = require('../chunk-44TPPPRJ.cjs');
+var chunkIE55TWIG_cjs = require('../chunk-IE55TWIG.cjs');
+var chunkB7P73VHX_cjs = require('../chunk-B7P73VHX.cjs');
 require('../chunk-AOFATOT3.cjs');
 require('../chunk-RC25WMVB.cjs');
 require('../chunk-7UTB4PHM.cjs');
@@ -60,7 +60,7 @@ function NativeDocxComparison({
   if (!documentId)
     return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "native-docx-error", role: "status", children: "Comparing Word documents\u2026" });
   return /* @__PURE__ */ jsxRuntime.jsx(
-    chunk44TPPPRJ_cjs.NativeDocxEditor,
+    chunkB7P73VHX_cjs.NativeDocxEditor,
     {
       adapter,
       documentId,
@@ -72,131 +72,135 @@ function NativeDocxComparison({
 
 Object.defineProperty(exports, "StreamedWordArtifact", {
   enumerable: true,
-  get: function () { return chunkQBEUCOC7_cjs.StreamedWordArtifact; }
+  get: function () { return chunkIE55TWIG_cjs.StreamedWordArtifact; }
 });
 Object.defineProperty(exports, "BUILTIN_TEMPLATE_NAME", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.BUILTIN_TEMPLATE_NAME; }
+  get: function () { return chunkB7P73VHX_cjs.BUILTIN_TEMPLATE_NAME; }
 });
 Object.defineProperty(exports, "DEFAULT_DEFINED_TERMS_LABELS", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.DEFAULT_DEFINED_TERMS_LABELS; }
+  get: function () { return chunkB7P73VHX_cjs.DEFAULT_DEFINED_TERMS_LABELS; }
 });
 Object.defineProperty(exports, "DEFINED_TERM_TRIGGER", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.DEFINED_TERM_TRIGGER; }
+  get: function () { return chunkB7P73VHX_cjs.DEFINED_TERM_TRIGGER; }
 });
 Object.defineProperty(exports, "DefinedTermsProvider", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.DefinedTermsProvider; }
+  get: function () { return chunkB7P73VHX_cjs.DefinedTermsProvider; }
 });
 Object.defineProperty(exports, "DocxAuthorContext", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.DocxAuthorContext; }
+  get: function () { return chunkB7P73VHX_cjs.DocxAuthorContext; }
 });
 Object.defineProperty(exports, "DocxCommentActivity", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.DocxCommentActivity; }
+  get: function () { return chunkB7P73VHX_cjs.DocxCommentActivity; }
 });
 Object.defineProperty(exports, "DocxEditorReview", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.DocxEditorReview; }
+  get: function () { return chunkB7P73VHX_cjs.DocxEditorReview; }
 });
 Object.defineProperty(exports, "DocxMentions", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.DocxMentions; }
+  get: function () { return chunkB7P73VHX_cjs.DocxMentions; }
 });
 Object.defineProperty(exports, "DocxParticipants", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.DocxParticipants; }
+  get: function () { return chunkB7P73VHX_cjs.DocxParticipants; }
 });
 Object.defineProperty(exports, "DocxRibbon", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.DocxRibbon; }
+  get: function () { return chunkB7P73VHX_cjs.DocxRibbon; }
+});
+Object.defineProperty(exports, "GenerateImageButton", {
+  enumerable: true,
+  get: function () { return chunkB7P73VHX_cjs.GenerateImageButton; }
 });
 Object.defineProperty(exports, "HouseTemplateProvider", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.HouseTemplateProvider; }
+  get: function () { return chunkB7P73VHX_cjs.HouseTemplateProvider; }
 });
 Object.defineProperty(exports, "NativeDocxEditor", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.NativeDocxEditor; }
+  get: function () { return chunkB7P73VHX_cjs.NativeDocxEditor; }
 });
 Object.defineProperty(exports, "builtinHouseTemplate", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.builtinHouseTemplate; }
+  get: function () { return chunkB7P73VHX_cjs.builtinHouseTemplate; }
 });
 Object.defineProperty(exports, "contentPath", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.contentPath; }
+  get: function () { return chunkB7P73VHX_cjs.contentPath; }
 });
 Object.defineProperty(exports, "editorPort", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.editorPort; }
+  get: function () { return chunkB7P73VHX_cjs.editorPort; }
 });
 Object.defineProperty(exports, "findDefinitionsSection", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.findDefinitionsSection; }
+  get: function () { return chunkB7P73VHX_cjs.findDefinitionsSection; }
 });
 Object.defineProperty(exports, "insertDefinedTerm", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.insertDefinedTerm; }
+  get: function () { return chunkB7P73VHX_cjs.insertDefinedTerm; }
 });
 Object.defineProperty(exports, "loadDocxFonts", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.loadDocxFonts; }
+  get: function () { return chunkB7P73VHX_cjs.loadDocxFonts; }
 });
 Object.defineProperty(exports, "normalizeDocxExport", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.normalizeDocxExport; }
+  get: function () { return chunkB7P73VHX_cjs.normalizeDocxExport; }
 });
 Object.defineProperty(exports, "resolveHouseTemplate", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.resolveHouseTemplate; }
+  get: function () { return chunkB7P73VHX_cjs.resolveHouseTemplate; }
 });
 Object.defineProperty(exports, "reviewModule", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.reviewModule; }
+  get: function () { return chunkB7P73VHX_cjs.reviewModule; }
 });
 Object.defineProperty(exports, "structuralPort", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.structuralPort; }
+  get: function () { return chunkB7P73VHX_cjs.structuralPort; }
 });
 Object.defineProperty(exports, "templateFileName", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.templateFileName; }
+  get: function () { return chunkB7P73VHX_cjs.templateFileName; }
 });
 Object.defineProperty(exports, "trackedOrNoted", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.trackedOrNoted; }
+  get: function () { return chunkB7P73VHX_cjs.trackedOrNoted; }
 });
 Object.defineProperty(exports, "updateDefinitions", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.updateDefinitions; }
+  get: function () { return chunkB7P73VHX_cjs.updateDefinitions; }
 });
 Object.defineProperty(exports, "useDefinedTerms", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.useDefinedTerms; }
+  get: function () { return chunkB7P73VHX_cjs.useDefinedTerms; }
 });
 Object.defineProperty(exports, "useHouseTemplate", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.useHouseTemplate; }
+  get: function () { return chunkB7P73VHX_cjs.useHouseTemplate; }
 });
 Object.defineProperty(exports, "useReview", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.useReview; }
+  get: function () { return chunkB7P73VHX_cjs.useReview; }
 });
 Object.defineProperty(exports, "useReviewItem", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.useReviewItem; }
+  get: function () { return chunkB7P73VHX_cjs.useReviewItem; }
 });
 Object.defineProperty(exports, "useTrackedOrNoted", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.useTrackedOrNoted; }
+  get: function () { return chunkB7P73VHX_cjs.useTrackedOrNoted; }
 });
 Object.defineProperty(exports, "withDirectEditing", {
   enumerable: true,
-  get: function () { return chunk44TPPPRJ_cjs.withDirectEditing; }
+  get: function () { return chunkB7P73VHX_cjs.withDirectEditing; }
 });
 Object.defineProperty(exports, "DocxEditor", {
   enumerable: true,

package/dist/docx/index.d.ts

@@ -12,6 +12,7 @@ export { NativeDocxComparison, type NativeDocxComparisonProps } from './NativeDo
 export { DefinedTermsProvider, useDefinedTerms, DEFINED_TERM_TRIGGER, DEFAULT_DEFINED_TERMS_LABELS, type DefinedTermsProviderProps, type DefinedTermsLabels, } from './definitions/DefinedTerms';
 export { insertDefinedTerm, updateDefinitions, findDefinitionsSection, type UpdateDefinitionsResult, } from './definitions/commands';
 export { editorPort, withDirectEditing, type DefinitionsPort } from './definitions/port';
+export { GenerateImageButton, type DocxImageGeneration } from './layout/GenerateImage';
 export { structuralPort, trackedOrNoted, type StructuralInsert, type StructuralOutcome, type StructuralPort, } from './structural/trackedOrNoted';
 export { DocxAuthorContext, useTrackedOrNoted } from './structural/useTrackedOrNoted';
 export { contentPath } from './NativeDocxEditor';

package/dist/docx/index.js

@@ -1,7 +1,7 @@
 "use client";
-export { StreamedWordArtifact } from '../chunk-3ICWR3BK.js';
-import { NativeDocxEditor } from '../chunk-4ZTIMQ7Z.js';
-export { BUILTIN_TEMPLATE_NAME, DEFAULT_DEFINED_TERMS_LABELS, DEFINED_TERM_TRIGGER, DefinedTermsProvider, DocxAuthorContext, DocxCommentActivity, DocxEditorReview, DocxMentions, DocxParticipants, DocxRibbon, HouseTemplateProvider, NativeDocxEditor, builtinHouseTemplate, contentPath, editorPort, findDefinitionsSection, insertDefinedTerm, loadDocxFonts, normalizeDocxExport, resolveHouseTemplate, reviewModule, structuralPort, templateFileName, trackedOrNoted, updateDefinitions, useDefinedTerms, useHouseTemplate, useReview, useReviewItem, useTrackedOrNoted, withDirectEditing } from '../chunk-4ZTIMQ7Z.js';
+export { StreamedWordArtifact } from '../chunk-E2QWWLK5.js';
+import { NativeDocxEditor } from '../chunk-72PQ42YI.js';
+export { BUILTIN_TEMPLATE_NAME, DEFAULT_DEFINED_TERMS_LABELS, DEFINED_TERM_TRIGGER, DefinedTermsProvider, DocxAuthorContext, DocxCommentActivity, DocxEditorReview, DocxMentions, DocxParticipants, DocxRibbon, GenerateImageButton, HouseTemplateProvider, NativeDocxEditor, builtinHouseTemplate, contentPath, editorPort, findDefinitionsSection, insertDefinedTerm, loadDocxFonts, normalizeDocxExport, resolveHouseTemplate, reviewModule, structuralPort, templateFileName, trackedOrNoted, updateDefinitions, useDefinedTerms, useHouseTemplate, useReview, useReviewItem, useTrackedOrNoted, withDirectEditing } from '../chunk-72PQ42YI.js';
 import '../chunk-D3QPYKZG.js';
 import '../chunk-AF6RDAJF.js';
 import '../chunk-AA3PT6KR.js';

package/dist/docx/layout/GenerateImage.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Insert › Generate image: a prompt goes to the host's image generation (the platform's `/image`
+ * command), and the picture that comes back is inserted where the caret was when Generate was
+ * pressed, as an ordinary inline picture whose alt text is the prompt. The engine stores the bytes
+ * as the document's own media part, so the picture saves with the DOCX like any inserted one.
+ *
+ * Generation takes a while. The caret is remembered by the paragraph's `w14:paraId`, which survives
+ * a collaboration room re-installing the document meanwhile, and the person may keep writing. The
+ * ribbon may even be remounted meanwhile (a new editor instance over the same room): the picture
+ * then goes into whichever mounted editor holds that paragraph.
+ */
+import React from 'react';
+import { useDocxEditor } from '@docx-editor.dev/react';
+/** The host's image generation, as the editor uses it. */
+export interface DocxImageGeneration {
+    /** Generate one image from `prompt` and return its bytes (PNG, JPEG, GIF or WebP). */
+    generate: (prompt: string, options: {
+        aspectRatio?: string;
+        signal?: AbortSignal;
+    }) => Promise<Uint8Array>;
+    /** The aspect ratios the image model accepts; none offers only the model's default. */
+    aspectRatios?: readonly {
+        value: string;
+        label: string;
+    }[];
+    notify?: (message: string, kind: 'success' | 'error') => void;
+}
+type Editor = NonNullable<ReturnType<typeof useDocxEditor>>;
+interface Caret {
+    paraId: string | null;
+    paragraphId: string;
+    offset: number;
+}
+/**
+ * The editor to insert into: the one the request came from while it is still mounted, else the
+ * newest mounted editor whose document holds the remembered paragraph. Null when the document was
+ * closed meanwhile.
+ */
+export declare function insertionTarget(origin: Editor, caret: Caret | null, editors?: readonly Editor[]): Editor | null;
+/** Insert `bytes` at `caret` as an inline picture. Throws with a readable reason on refusal. */
+export declare function insertGeneratedImage(editor: Editor, bytes: Uint8Array, prompt: string, caret: Caret | null): Promise<void>;
+/**
+ * Make this ribbon's editor a place a running generation can land. The ribbon calls it whatever its
+ * tab: a remounted editor opens on Home, without the Generate image button.
+ */
+export declare function useGenerateImageTarget(): void;
+export declare function GenerateImageButton({ generation }: {
+    generation: DocxImageGeneration;
+}): React.JSX.Element | null;
+export {};

package/dist/docx/layout/LayoutRibbon.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The native editor's Layout tab, laid out like Word's Page Setup group: Margins, Orientation,
+ * Size, Columns, Breaks, and the Page Setup dialog for anything the galleries do not offer.
+ *
+ * Everything goes through the engine's own commands: `setPageSetup` (scoped to the caret's section,
+ * as Word's galleries are) for the galleries, the engine's break slots for Breaks, and its packaged
+ * Page Setup dialog. Columns are offered but disabled: the engine lays out a document's existing
+ * `w:cols`, but has no command that writes them (see the README).
+ */
+import React from 'react';
+/** Why Columns is disabled, in the words the tooltip shows. */
+export declare const COLUMNS_UNSUPPORTED = "Text columns are not available in this editor yet. Documents that already use columns display and save them unchanged.";
+interface Choice {
+    id: string;
+    label: string;
+    detail?: string;
+    icon?: React.ReactNode;
+    disabled?: boolean;
+    title?: string;
+}
+/** A ribbon gallery: one column of choices, the current one marked, closing once one is picked. */
+export declare function RibbonGallery({ label, choices, current, onPick, close, testId, }: {
+    label: string;
+    choices: readonly Choice[];
+    current?: string | null;
+    onPick: (id: string) => void;
+    close: () => void;
+    testId?: string;
+}): React.JSX.Element;
+/** Layout tab: Margins, Orientation, Size, Columns, Breaks, Page Setup. */
+export declare function LayoutButtons(): React.JSX.Element;
+export {};

package/dist/docx/layout/LayoutTabs.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The ribbon tabs this folder adds: Layout always, and Word's contextual Table and Picture tabs
+ * while the caret is in a table or a picture is selected.
+ */
+import React from 'react';
+export declare const LAYOUT_TAB = "Layout";
+export declare const TABLE_TAB = "Table";
+export declare const PICTURE_TAB = "Picture";
+/**
+ * The contextual tabs available now, and the tab to show: a contextual tab that no longer applies
+ * (the caret left the table, the picture was deselected) falls back to Home, as Word's does.
+ */
+export declare function useContextualTabs(tab: string): {
+    tabs: string[];
+    shown: string;
+};
+/** The body of the Layout, Table or Picture tab; nothing for the other tabs. */
+export declare function LayoutTabContent({ tab }: {
+    tab: string;
+}): React.JSX.Element | null;

package/dist/docx/layout/PictureRibbon.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The native editor's contextual Picture tab — Word's Picture Format tab — offered while a picture
+ * is selected: Wrap Text, Size & Position, Alt Text (the engine's packaged picture chrome), rotate
+ * and flip, and Insert Caption.
+ */
+import React from 'react';
+import { useDocxEditor } from '@docx-editor.dev/react';
+import { useTrackedOrNoted } from '../structural/useTrackedOrNoted';
+import { type CaptionLabel } from './caption';
+type Editor = NonNullable<ReturnType<typeof useDocxEditor>>;
+/**
+ * Insert a caption paragraph directly after the caret's paragraph (the picture's), numbered after
+ * the captions with the same label that come before it. Returns the inserted number, or null when
+ * the editor refused.
+ */
+export declare function insertCaption(editor: Editor, label: CaptionLabel, text: string, track: ReturnType<typeof useTrackedOrNoted>): number | null;
+/** Word's Insert Caption: a label, the caption text, and Insert. */
+export declare function CaptionButton({ defaultLabel }: {
+    defaultLabel?: CaptionLabel;
+}): React.JSX.Element;
+/** Picture tab: Wrap Text, Size & Position, Alt Text, rotate and flip, Insert Caption. */
+export declare function PictureButtons(): React.JSX.Element;
+export {};

package/dist/docx/layout/TableKeys.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Word's Tab and Shift+Tab in a table: move to the next or previous cell, and Tab in the last cell
+ * adds a row. The engine types a tab character into the cell instead, so the keys are bound here,
+ * ahead of the editor's own handling, the way `WordShortcuts` binds note and style keys.
+ */
+import { type RefObject } from 'react';
+type Node = {
+    id?: string;
+    kind?: string;
+    localName?: string;
+    children?: readonly Node[];
+};
+/**
+ * The cells of the innermost table holding `paragraphId`, in reading order (each as its first
+ * paragraph), and which of them holds it. Null outside a table.
+ */
+export declare function tableCells(root: Node, paragraphId: string): {
+    cells: string[];
+    index: number;
+} | null;
+/** Binds Tab and Shift+Tab in tables inside `scope`. Renders nothing; mount inside `DocxEditor.Root`. */
+export declare function TableTabKeys({ scope }: {
+    scope: RefObject<HTMLElement | null>;
+}): null;
+export {};

package/dist/docx/layout/TableRibbon.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The native editor's contextual Table tab — Word's Table Design and Table Layout tabs in one row,
+ * offered while the caret is in a table.
+ *
+ * Rows, columns, deletion and cell alignment are the engine's table commands; borders and shading
+ * are its packaged table chrome. Merge, Split and Header Row are bound to the engine's commands
+ * too, so they show the engine's own reason while it refuses them and work as soon as it does not.
+ */
+import React from 'react';
+/** Table tab: insert and delete rows and columns, merge, split, header row, borders and shading. */
+export declare function TableButtons(): React.JSX.Element;

package/dist/docx/layout/caption.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Word's Insert Caption: a paragraph in the `Caption` style reading `Figure 1: text`, whose
+ * number is a `SEQ Figure` field so Word renumbers every caption when fields update.
+ *
+ * The engine has no caption command, but its paste lands an embedded `.docx` fragment intact —
+ * the `w:fldSimple` and the paragraph style, whose definition is merged into the document when
+ * the document has none. The number written as the field's result is the next one in reading
+ * order at insertion; the engine paints a SEQ field's stored result rather than recomputing it.
+ */
+import { type Revision } from '@arbidocs/coedit/template';
+export declare const CAPTION_LABELS: readonly ["Figure", "Table", "Equation"];
+export type CaptionLabel = (typeof CAPTION_LABELS)[number];
+type Node = {
+    id?: string;
+    localName?: string;
+    kind?: string;
+    value?: string;
+    attributes?: readonly {
+        localName: string;
+        value: string;
+    }[];
+    children?: readonly Node[];
+};
+/** The `SEQ` identifier of a field instruction (`SEQ Figure \* ARABIC` -> `Figure`). */
+export declare function seqIdentifier(instruction: string): string | null;
+/**
+ * How many `SEQ <label>` fields the tree holds — simple fields and complex `w:instrText` ones — in
+ * reading order up to and including the paragraph `throughId` (all of them when absent).
+ */
+export declare function countSeqFields(root: Node, label: string, throughId?: string): number;
+/** The caption paragraph: `Label N` with N a SEQ field, then `: text` when there is text. */
+export declare function captionParagraphXml(label: string, number: number, text: string): string;
+/**
+ * Clipboard HTML that pastes the caption as a whole paragraph (the editor's own fragment form),
+ * marked as a tracked insertion by `revision` when one is given.
+ */
+export declare function captionFragmentHtml(label: string, number: number, text: string, revision?: Revision | null): string;
+export {};