@arbidocs/blocks 0.4.142 → 0.4.144

package/dist/connection/docx/ConnectedNativeDocxComparison.d.ts

@@ -0,0 +1,5 @@
+import { type NativeDocxComparisonProps } from '../../docx/NativeDocxComparison';
+/** The Word redline of two documents or versions, on the signed-in session. */
+export declare function ConnectedNativeDocxComparison({ fontBaseUrl, ...props }: Omit<NativeDocxComparisonProps, 'adapter' | 'onCompared'> & {
+    fontBaseUrl?: string;
+}): import("react").JSX.Element;

package/dist/connection/docx/ConnectedNativeDocxEditor.d.ts

@@ -0,0 +1,16 @@
+import { type NativeDocxAdapter, type NativeDocxEditorProps } from '../../docx/NativeDocxEditor';
+export type ConnectedNativeDocxEditorProps = Omit<NativeDocxEditorProps, 'adapter'> & {
+    fontBaseUrl?: string;
+};
+/**
+ * The native Word editor on the signed-in ARBI session, under any host (a `ConnectionProvider`, or
+ * the host's own `ArbiProvider` + session state). Until a live session has opened, a failure to
+ * open one falls back to the saved copy, read-only, so the document is still readable; later token
+ * refreshes are not guarded (switching modes would drop unsaved edits).
+ */
+export declare function ConnectedNativeDocxEditor({ fontBaseUrl, ...props }: ConnectedNativeDocxEditorProps): import("react").JSX.Element;
+/**
+ * The native Word adapter on the signed-in session: the editor transport, the people to mention,
+ * cross-references, the house template, and the host's extras (`NativeDocxSupportProvider`).
+ */
+export declare function useConnectedNativeDocxAdapter(fontBaseUrl?: string): NativeDocxAdapter;

package/dist/connection/{ConnectedStreamedWordArtifact.d.ts → docx/ConnectedStreamedWordArtifact.d.ts}

@@ -1,4 +1,4 @@
-import { type StreamedWordArtifactProps } from '../docx/StreamedWordArtifact';
+import { type StreamedWordArtifactProps } from '../../docx/StreamedWordArtifact';
 export declare function ConnectedStreamedWordArtifact({ fontBaseUrl, ...props }: Omit<StreamedWordArtifactProps, 'adapter'> & {
     fontBaseUrl?: string;
 }): import("react").JSX.Element;

package/dist/connection/docx/support.d.ts

@@ -0,0 +1,27 @@
+/**
+ * What a host adds to the connected Word editor that the platform API alone cannot give: the
+ * workspace's definitions (facts labelled "Definitions"), image generation (an assistant run), the
+ * host's leave-page guard, and a comment to open the editor at. Every field is optional; without a
+ * provider the editor simply offers less (no Defined term, no Generate image).
+ */
+import { type ReactNode } from 'react';
+import type { DefinitionSource } from '../../tags/definitions';
+import type { DocxImageGeneration } from '../../docx/layout/GenerateImage';
+export interface NativeDocxSupport {
+    /** The workspace's definitions. Present: Insert offers Defined term and `@@` the type-ahead. */
+    definitions?: () => Promise<DefinitionSource[]>;
+    /** The platform's image generation. Present: Insert offers Generate image. */
+    imageGeneration?: DocxImageGeneration;
+    /** The open editor has (or no longer has) unsaved changes. */
+    onDirtyChange?: (dirty: boolean) => void;
+    /** A comment thread to open when its document opens (a notification's link). */
+    commentTarget?: {
+        documentId: string;
+        commentId: string;
+    } | null;
+}
+export declare function NativeDocxSupportProvider({ value, children, }: {
+    value: NativeDocxSupport;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useNativeDocxSupport(): NativeDocxSupport;

package/dist/connection/docx/useConnectedDocxReferences.d.ts

@@ -0,0 +1,2 @@
+import type { DocxReferencesAdapter } from '../../docx/references/CrossReferences';
+export declare function useConnectedDocxReferences(): DocxReferencesAdapter;

package/dist/connection/docx/useConnectedHouseTemplate.d.ts

@@ -0,0 +1,2 @@
+import { type HouseTemplateHost } from '../../docx/template/HouseTemplate';
+export declare function useConnectedHouseTemplate(): HouseTemplateHost;

package/dist/docx/index.cjs

@@ -1,8 +1,8 @@
 "use client";
 'use strict';
 
-var chunk4TR5QCCX_cjs = require('../chunk-4TR5QCCX.cjs');
-var chunkS24XEVPS_cjs = require('../chunk-S24XEVPS.cjs');
+var chunkMHFF5N65_cjs = require('../chunk-MHFF5N65.cjs');
+var chunk464YPRAE_cjs = require('../chunk-464YPRAE.cjs');
 var chunkV5OAXIBN_cjs = require('../chunk-V5OAXIBN.cjs');
 require('../chunk-5FYU7ZIU.cjs');
 require('../chunk-I2QSDQQV.cjs');
@@ -12,73 +12,28 @@ require('../chunk-MHVNT4J3.cjs');
 require('../chunk-DES3K4SD.cjs');
 var react = require('@docx-editor.dev/react');
 var hocuspocus = require('@arbidocs/coedit/hocuspocus');
-var react$1 = require('react');
-var artifacts = require('@arbidocs/react/artifacts');
-var jsxRuntime = require('react/jsx-runtime');
 
-function redlineQuery(baseId, revisedId) {
-  const base = artifacts.parseVersionRef(baseId);
-  const revised = artifacts.parseVersionRef(revisedId);
-  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId });
-  if (base.version) query.set("base_version", String(base.version));
-  if (revised.version) query.set("revised_version", String(revised.version));
-  return query;
-}
-function NativeDocxComparison({
-  adapter,
-  baseId,
-  revisedId,
-  title,
-  onCompared
-}) {
-  const host = react$1.useRef({ adapter, onCompared });
-  host.current = { adapter, onCompared };
-  const [documentId, setDocumentId] = react$1.useState("");
-  const [error, setError] = react$1.useState("");
-  const [attempt, setAttempt] = react$1.useState(0);
-  react$1.useEffect(() => {
-    let cancelled = false;
-    setDocumentId("");
-    setError("");
-    void host.current.adapter.request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: "POST" }).then((response) => response.json()).then((result) => {
-      if (!result.document_ext_id) throw new Error("Comparison did not return a Word document.");
-      if (!cancelled) {
-        setDocumentId(result.document_ext_id);
-        void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {
-        });
-      }
-    }).catch((error2) => {
-      if (!cancelled) setError(error2 instanceof Error ? error2.message : String(error2));
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [baseId, revisedId, attempt]);
-  if (error)
-    return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-error", role: "alert", children: [
-      /* @__PURE__ */ jsxRuntime.jsx("p", { children: error }),
-      /* @__PURE__ */ jsxRuntime.jsx("button", { onClick: () => setAttempt((value) => value + 1), children: "Retry comparison" })
-    ] });
-  if (!documentId)
-    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "native-docx-error", role: "status", children: "Comparing Word documents\u2026" });
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    chunkV5OAXIBN_cjs.NativeDocxEditor,
-    {
-      adapter,
-      documentId,
-      title: `${title.replace(/\.[^.]+$/, "")} (redline).docx`
-    },
-    documentId
-  );
-}
 
+
+Object.defineProperty(exports, "NativeDocxComparison", {
+  enumerable: true,
+  get: function () { return chunkMHFF5N65_cjs.NativeDocxComparison; }
+});
 Object.defineProperty(exports, "StreamedWordArtifact", {
   enumerable: true,
-  get: function () { return chunk4TR5QCCX_cjs.StreamedWordArtifact; }
+  get: function () { return chunkMHFF5N65_cjs.StreamedWordArtifact; }
+});
+Object.defineProperty(exports, "groupCandidates", {
+  enumerable: true,
+  get: function () { return chunk464YPRAE_cjs.groupCandidates; }
+});
+Object.defineProperty(exports, "isCandidate", {
+  enumerable: true,
+  get: function () { return chunk464YPRAE_cjs.isCandidate; }
 });
 Object.defineProperty(exports, "loadDocxFonts", {
   enumerable: true,
-  get: function () { return chunkS24XEVPS_cjs.loadDocxFonts; }
+  get: function () { return chunk464YPRAE_cjs.loadDocxFonts; }
 });
 Object.defineProperty(exports, "BUILTIN_TEMPLATE_NAME", {
   enumerable: true,
@@ -264,6 +219,5 @@ Object.defineProperty(exports, "createHocuspocusCollaboration", {
   enumerable: true,
   get: function () { return hocuspocus.createHocuspocusCollaboration; }
 });
-exports.NativeDocxComparison = NativeDocxComparison;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/docx/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/docx/NativeDocxComparison.tsx"],"names":["parseVersionRef","useRef","useState","useEffect","error","jsxs","jsx","NativeDocxEditor"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useEffect, useRef, useState } from 'react'\nimport { parseVersionRef } from '@arbidocs/react/artifacts'\nimport { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface NativeDocxComparisonProps {\n  adapter: NativeDocxAdapter\n  baseId: string\n  revisedId: string\n  title: string\n  onCompared?: (documentId: string) => void | Promise<void>\n}\n\n/** A `doc-…@v{n}` side names an older version: the endpoint takes its document and version apart. */\nfunction redlineQuery(baseId: string, revisedId: string): URLSearchParams {\n  const base = parseVersionRef(baseId)\n  const revised = parseVersionRef(revisedId)\n  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId })\n  if (base.version) query.set('base_version', String(base.version))\n  if (revised.version) query.set('revised_version', String(revised.version))\n  return query\n}\n\n/** Word comparison through the host's authenticated transport and LibreOffice service. */\nexport function NativeDocxComparison({\n  adapter,\n  baseId,\n  revisedId,\n  title,\n  onCompared,\n}: NativeDocxComparisonProps) {\n  const host = useRef({ adapter, onCompared })\n  host.current = { adapter, onCompared }\n  const [documentId, setDocumentId] = useState('')\n  const [error, setError] = useState('')\n  const [attempt, setAttempt] = useState(0)\n  useEffect(() => {\n    let cancelled = false\n    setDocumentId('')\n    setError('')\n    void host.current.adapter\n      .request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: 'POST' })\n      .then((response) => response.json())\n      .then((result: { document_ext_id: string }) => {\n        if (!result.document_ext_id) throw new Error('Comparison did not return a Word document.')\n        if (!cancelled) {\n          setDocumentId(result.document_ext_id)\n          void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {})\n        }\n      })\n      .catch((error) => {\n        if (!cancelled) setError(error instanceof Error ? error.message : String(error))\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [baseId, revisedId, attempt])\n  if (error)\n    return (\n      <div className=\"native-docx-error\" role=\"alert\">\n        <p>{error}</p>\n        <button onClick={() => setAttempt((value) => value + 1)}>Retry comparison</button>\n      </div>\n    )\n  if (!documentId)\n    return (\n      <div className=\"native-docx-error\" role=\"status\">\n        Comparing Word documents…\n      </div>\n    )\n  return (\n    <NativeDocxEditor\n      key={documentId}\n      adapter={adapter}\n      documentId={documentId}\n      title={`${title.replace(/\\.[^.]+$/, '')} (redline).docx`}\n    />\n  )\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs","sourcesContent":[]}

package/dist/docx/index.d.ts

@@ -23,3 +23,4 @@ export { structuralPort, trackedOrNoted, type StructuralInsert, type StructuralO
 export { DocxAuthorContext, useTrackedOrNoted } from './structural/useTrackedOrNoted';
 export { contentPath } from './NativeDocxEditor';
 export { HouseTemplateProvider, useHouseTemplate, builtinHouseTemplate, resolveHouseTemplate, templateFileName, BUILTIN_TEMPLATE_NAME, type HouseTemplate, type HouseTemplateHost, type HouseTemplateSource, } from './template/HouseTemplate';
+export { groupCandidates, isCandidate, type CandidateGroup, type HouseTemplateCandidate, } from './template/candidates';

package/dist/docx/index.js

@@ -1,7 +1,6 @@
 "use client";
-export { StreamedWordArtifact } from '../chunk-MCKOZACC.js';
-export { loadDocxFonts } from '../chunk-GYAUJ4KT.js';
-import { NativeDocxEditor } from '../chunk-2FL7QJKJ.js';
+export { NativeDocxComparison, StreamedWordArtifact } from '../chunk-AOSUHWIL.js';
+export { groupCandidates, isCandidate, loadDocxFonts } from '../chunk-MTSKK3BN.js';
 export { BUILTIN_TEMPLATE_NAME, CrossReferenceDialog, CrossReferencesProvider, DEFAULT_CROSS_REFERENCES_LABELS, DEFAULT_DEFINED_TERMS_LABELS, DEFINED_TERM_TRIGGER, DefinedTermsProvider, DocxAuthorContext, DocxCommentActivity, DocxEditorReview, DocxMentions, DocxParticipants, DocxRibbon, GenerateImageButton, HouseTemplateProvider, LinkHoverCard, NativeDocxEditor, builtinHouseTemplate, contentPath, editorPort, findDefinitionsSection, insertCrossReference, insertDefinedTerm, insertDocumentReference, listTargets, normalizeDocxExport, paragraphNumber, referenceText, referencesPort, resolveHouseTemplate, reviewModule, shortTitle, structuralPort, templateFileName, trackedOrNoted, useCrossReferences, useDefinedTerms, useHouseTemplate, useReview, useReviewItem, useTrackedOrNoted, withDirectEditing } from '../chunk-2FL7QJKJ.js';
 import '../chunk-HFZ45FD3.js';
 import '../chunk-QXMR5YHC.js';
@@ -11,66 +10,5 @@ import '../chunk-7F6CBP3Z.js';
 import '../chunk-VUNV25KB.js';
 export { DocxEditor, useDocxEditor, useEditorState } from '@docx-editor.dev/react';
 export { createHocuspocusCollaboration } from '@arbidocs/coedit/hocuspocus';
-import { useRef, useState, useEffect } from 'react';
-import { parseVersionRef } from '@arbidocs/react/artifacts';
-import { jsxs, jsx } from 'react/jsx-runtime';
-
-function redlineQuery(baseId, revisedId) {
-  const base = parseVersionRef(baseId);
-  const revised = parseVersionRef(revisedId);
-  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId });
-  if (base.version) query.set("base_version", String(base.version));
-  if (revised.version) query.set("revised_version", String(revised.version));
-  return query;
-}
-function NativeDocxComparison({
-  adapter,
-  baseId,
-  revisedId,
-  title,
-  onCompared
-}) {
-  const host = useRef({ adapter, onCompared });
-  host.current = { adapter, onCompared };
-  const [documentId, setDocumentId] = useState("");
-  const [error, setError] = useState("");
-  const [attempt, setAttempt] = useState(0);
-  useEffect(() => {
-    let cancelled = false;
-    setDocumentId("");
-    setError("");
-    void host.current.adapter.request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: "POST" }).then((response) => response.json()).then((result) => {
-      if (!result.document_ext_id) throw new Error("Comparison did not return a Word document.");
-      if (!cancelled) {
-        setDocumentId(result.document_ext_id);
-        void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {
-        });
-      }
-    }).catch((error2) => {
-      if (!cancelled) setError(error2 instanceof Error ? error2.message : String(error2));
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [baseId, revisedId, attempt]);
-  if (error)
-    return /* @__PURE__ */ jsxs("div", { className: "native-docx-error", role: "alert", children: [
-      /* @__PURE__ */ jsx("p", { children: error }),
-      /* @__PURE__ */ jsx("button", { onClick: () => setAttempt((value) => value + 1), children: "Retry comparison" })
-    ] });
-  if (!documentId)
-    return /* @__PURE__ */ jsx("div", { className: "native-docx-error", role: "status", children: "Comparing Word documents\u2026" });
-  return /* @__PURE__ */ jsx(
-    NativeDocxEditor,
-    {
-      adapter,
-      documentId,
-      title: `${title.replace(/\.[^.]+$/, "")} (redline).docx`
-    },
-    documentId
-  );
-}
-
-export { NativeDocxComparison };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/docx/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/docx/NativeDocxComparison.tsx"],"names":["error"],"mappings":";;;;;;;;;;;;;;;;AAaA,SAAS,YAAA,CAAa,QAAgB,SAAA,EAAoC;AACxE,EAAA,MAAM,IAAA,GAAO,gBAAgB,MAAM,CAAA;AACnC,EAAA,MAAM,OAAA,GAAU,gBAAgB,SAAS,CAAA;AACzC,EAAA,MAAM,KAAA,GAAQ,IAAI,eAAA,CAAgB,EAAE,WAAA,EAAa,KAAK,KAAA,EAAO,cAAA,EAAgB,OAAA,CAAQ,KAAA,EAAO,CAAA;AAC5F,EAAA,IAAI,IAAA,CAAK,SAAS,KAAA,CAAM,GAAA,CAAI,gBAAgB,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAChE,EAAA,IAAI,OAAA,CAAQ,SAAS,KAAA,CAAM,GAAA,CAAI,mBAAmB,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAC,CAAA;AACzE,EAAA,OAAO,KAAA;AACT;AAGO,SAAS,oBAAA,CAAqB;AAAA,EACnC,OAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EACA,KAAA;AAAA,EACA;AACF,CAAA,EAA8B;AAC5B,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,EAAE,OAAA,EAAS,YAAY,CAAA;AAC3C,EAAA,IAAA,CAAK,OAAA,GAAU,EAAE,OAAA,EAAS,UAAA,EAAW;AACrC,EAAA,MAAM,CAAC,UAAA,EAAY,aAAa,CAAA,GAAI,SAAS,EAAE,CAAA;AAC/C,EAAA,MAAM,CAAC,KAAA,EAAO,QAAQ,CAAA,GAAI,SAAS,EAAE,CAAA;AACrC,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAAS,CAAC,CAAA;AACxC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,aAAA,CAAc,EAAE,CAAA;AAChB,IAAA,QAAA,CAAS,EAAE,CAAA;AACX,IAAA,KAAK,IAAA,CAAK,OAAA,CAAQ,OAAA,CACf,OAAA,CAAQ,CAAA,SAAA,EAAY,aAAa,MAAA,EAAQ,SAAS,CAAC,CAAA,CAAA,EAAI,EAAE,MAAA,EAAQ,QAAQ,CAAA,CACzE,IAAA,CAAK,CAAC,QAAA,KAAa,QAAA,CAAS,MAAM,CAAA,CAClC,IAAA,CAAK,CAAC,MAAA,KAAwC;AAC7C,MAAA,IAAI,CAAC,MAAA,CAAO,eAAA,EAAiB,MAAM,IAAI,MAAM,4CAA4C,CAAA;AACzF,MAAA,IAAI,CAAC,SAAA,EAAW;AACd,QAAA,aAAA,CAAc,OAAO,eAAe,CAAA;AACpC,QAAA,KAAK,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,OAAA,CAAQ,UAAA,GAAa,OAAO,eAAe,CAAC,CAAA,CAAE,KAAA,CAAM,MAAM;AAAA,QAAC,CAAC,CAAA;AAAA,MACxF;AAAA,IACF,CAAC,CAAA,CACA,KAAA,CAAM,CAACA,MAAAA,KAAU;AAChB,MAAA,IAAI,CAAC,WAAW,QAAA,CAASA,MAAAA,YAAiB,QAAQA,MAAAA,CAAM,OAAA,GAAU,MAAA,CAAOA,MAAK,CAAC,CAAA;AAAA,IACjF,CAAC,CAAA;AACH,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AAAA,IACd,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAC,CAAA;AAC/B,EAAA,IAAI,KAAA;AACF,IAAA,uBACE,IAAA,CAAC,KAAA,EAAA,EAAI,SAAA,EAAU,mBAAA,EAAoB,MAAK,OAAA,EACtC,QAAA,EAAA;AAAA,sBAAA,GAAA,CAAC,OAAG,QAAA,EAAA,KAAA,EAAM,CAAA;AAAA,sBACV,GAAA,CAAC,QAAA,EAAA,EAAO,OAAA,EAAS,MAAM,UAAA,CAAW,CAAC,KAAA,KAAU,KAAA,GAAQ,CAAC,CAAA,EAAG,QAAA,EAAA,kBAAA,EAAgB;AAAA,KAAA,EAC3E,CAAA;AAEJ,EAAA,IAAI,CAAC,UAAA;AACH,IAAA,2BACG,KAAA,EAAA,EAAI,SAAA,EAAU,mBAAA,EAAoB,IAAA,EAAK,UAAS,QAAA,EAAA,gCAAA,EAEjD,CAAA;AAEJ,EAAA,uBACE,GAAA;AAAA,IAAC,gBAAA;AAAA,IAAA;AAAA,MAEC,OAAA;AAAA,MACA,UAAA;AAAA,MACA,OAAO,CAAA,EAAG,KAAA,CAAM,OAAA,CAAQ,UAAA,EAAY,EAAE,CAAC,CAAA,eAAA;AAAA,KAAA;AAAA,IAHlC;AAAA,GAIP;AAEJ","file":"index.js","sourcesContent":["import { useEffect, useRef, useState } from 'react'\nimport { parseVersionRef } from '@arbidocs/react/artifacts'\nimport { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface NativeDocxComparisonProps {\n  adapter: NativeDocxAdapter\n  baseId: string\n  revisedId: string\n  title: string\n  onCompared?: (documentId: string) => void | Promise<void>\n}\n\n/** A `doc-…@v{n}` side names an older version: the endpoint takes its document and version apart. */\nfunction redlineQuery(baseId: string, revisedId: string): URLSearchParams {\n  const base = parseVersionRef(baseId)\n  const revised = parseVersionRef(revisedId)\n  const query = new URLSearchParams({ base_ext_id: base.docId, revised_ext_id: revised.docId })\n  if (base.version) query.set('base_version', String(base.version))\n  if (revised.version) query.set('revised_version', String(revised.version))\n  return query\n}\n\n/** Word comparison through the host's authenticated transport and LibreOffice service. */\nexport function NativeDocxComparison({\n  adapter,\n  baseId,\n  revisedId,\n  title,\n  onCompared,\n}: NativeDocxComparisonProps) {\n  const host = useRef({ adapter, onCompared })\n  host.current = { adapter, onCompared }\n  const [documentId, setDocumentId] = useState('')\n  const [error, setError] = useState('')\n  const [attempt, setAttempt] = useState(0)\n  useEffect(() => {\n    let cancelled = false\n    setDocumentId('')\n    setError('')\n    void host.current.adapter\n      .request(`/redline?${redlineQuery(baseId, revisedId)}`, { method: 'POST' })\n      .then((response) => response.json())\n      .then((result: { document_ext_id: string }) => {\n        if (!result.document_ext_id) throw new Error('Comparison did not return a Word document.')\n        if (!cancelled) {\n          setDocumentId(result.document_ext_id)\n          void Promise.resolve(host.current.onCompared?.(result.document_ext_id)).catch(() => {})\n        }\n      })\n      .catch((error) => {\n        if (!cancelled) setError(error instanceof Error ? error.message : String(error))\n      })\n    return () => {\n      cancelled = true\n    }\n  }, [baseId, revisedId, attempt])\n  if (error)\n    return (\n      <div className=\"native-docx-error\" role=\"alert\">\n        <p>{error}</p>\n        <button onClick={() => setAttempt((value) => value + 1)}>Retry comparison</button>\n      </div>\n    )\n  if (!documentId)\n    return (\n      <div className=\"native-docx-error\" role=\"status\">\n        Comparing Word documents…\n      </div>\n    )\n  return (\n    <NativeDocxEditor\n      key={documentId}\n      adapter={adapter}\n      documentId={documentId}\n      title={`${title.replace(/\\.[^.]+$/, '')} (redline).docx`}\n    />\n  )\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/dist/docx/template/candidates.d.ts

@@ -0,0 +1,16 @@
+import type { components } from '@arbidocs/client';
+/** A document a workspace may use as its house template (`GET /v1/workspace/house-template/candidates`). */
+export type HouseTemplateCandidate = components['schemas']['HouseTemplateCandidate'];
+export interface CandidateGroup {
+    /** "This workspace", or the public workspace's name. */
+    title: string;
+    workspaceId: string;
+    candidates: HouseTemplateCandidate[];
+}
+/**
+ * The picker's groups: this workspace's documents first, then each public workspace's, by name.
+ * `query` keeps the documents whose file name contains it (case-insensitive); empty groups go.
+ */
+export declare function groupCandidates(candidates: readonly HouseTemplateCandidate[], workspaceId: string | undefined, query?: string): CandidateGroup[];
+/** Whether a document may be made the house template: it is one of the candidates. */
+export declare function isCandidate(candidates: readonly HouseTemplateCandidate[] | undefined, documentId: string): boolean;