@arbidocs/blocks 0.4.98 → 0.4.99

package/dist/{chunk-6B2AWE3I.js → chunk-3ICWR3BK.js}

@@ -1,5 +1,5 @@
 "use client";
-import { NativeDocxEditor } from './chunk-FIEAWH4K.js';
+import { NativeDocxEditor } from './chunk-4ZTIMQ7Z.js';
 import { jsx } from 'react/jsx-runtime';
 
 function StreamedWordArtifact({
@@ -37,5 +37,5 @@ function StreamedWordArtifact({
 }
 
 export { StreamedWordArtifact };
-//# sourceMappingURL=chunk-6B2AWE3I.js.map
-//# sourceMappingURL=chunk-6B2AWE3I.js.map
+//# sourceMappingURL=chunk-3ICWR3BK.js.map
+//# sourceMappingURL=chunk-3ICWR3BK.js.map

package/dist/{chunk-6B2AWE3I.js.map → chunk-3ICWR3BK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/docx/StreamedWordArtifact.tsx"],"names":[],"mappings":";;;AAmBO,SAAS,oBAAA,CAAqB;AAAA,EACnC,OAAA;AAAA,EACA,OAAA;AAAA,EACA,KAAA;AAAA,EACA,IAAA;AAAA,EACA,KAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF,CAAA,EAA8B;AAC5B,EAAA,IAAI,CAAC,QAAQ,UAAA,EAAY;AACvB,IAAA,uBACE,GAAA;AAAA,MAAC,gBAAA;AAAA,MAAA;AAAA,QAEC,OAAA;AAAA,QACA,UAAA;AAAA,QACA,KAAA;AAAA,QACA;AAAA,OAAA;AAAA,MAJK;AAAA,KAKP;AAAA,EAEJ;AACA,EAAA,uBACE,GAAA;AAAA,IAAC,gBAAA;AAAA,IAAA;AAAA,MAEC,OAAA;AAAA,MACA,UAAA,EAAW,gBAAA;AAAA,MACX,KAAA;AAAA,MACA,YAAA,EAAa,EAAA;AAAA,MACb,MAAA,EAAQ,EAAE,OAAA,EAAS,IAAA,EAAM,KAAA;AAAM,KAAA;AAAA,IAL3B;AAAA,GAMN;AAEJ","file":"chunk-6B2AWE3I.js","sourcesContent":["import { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface StreamedWordArtifactProps {\n  adapter: NativeDocxAdapter\n  /** Streamed Markdown, shown as a read-only preview while the draft is generated. */\n  content: string\n  title: string\n  busy: boolean\n  error?: string | null\n  /** The DOCX draft the server stored for this generation (`doc-…`), once known. */\n  documentId?: string\n  onSaved?: (documentId: string) => void\n}\n\n/**\n * One drafting surface for an AI document draft. The server stores every draft as DOCX, so\n * this component never creates a document: it previews the streamed Markdown until generation\n * ends and the stored DOCX is known, then opens that DOCX in the live collaborative editor.\n */\nexport function StreamedWordArtifact({\n  adapter,\n  content,\n  title,\n  busy,\n  error,\n  documentId,\n  onSaved,\n}: StreamedWordArtifactProps) {\n  if (!busy && documentId) {\n    return (\n      <NativeDocxEditor\n        key={documentId}\n        adapter={adapter}\n        documentId={documentId}\n        title={title}\n        onSaved={onSaved}\n      />\n    )\n  }\n  return (\n    <NativeDocxEditor\n      key=\"stream-preview\"\n      adapter={adapter}\n      documentId=\"stream-preview\"\n      title={title}\n      draftContent=\"\"\n      stream={{ content, busy, error }}\n    />\n  )\n}\n"]}
+{"version":3,"sources":["../src/docx/StreamedWordArtifact.tsx"],"names":[],"mappings":";;;AAmBO,SAAS,oBAAA,CAAqB;AAAA,EACnC,OAAA;AAAA,EACA,OAAA;AAAA,EACA,KAAA;AAAA,EACA,IAAA;AAAA,EACA,KAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF,CAAA,EAA8B;AAC5B,EAAA,IAAI,CAAC,QAAQ,UAAA,EAAY;AACvB,IAAA,uBACE,GAAA;AAAA,MAAC,gBAAA;AAAA,MAAA;AAAA,QAEC,OAAA;AAAA,QACA,UAAA;AAAA,QACA,KAAA;AAAA,QACA;AAAA,OAAA;AAAA,MAJK;AAAA,KAKP;AAAA,EAEJ;AACA,EAAA,uBACE,GAAA;AAAA,IAAC,gBAAA;AAAA,IAAA;AAAA,MAEC,OAAA;AAAA,MACA,UAAA,EAAW,gBAAA;AAAA,MACX,KAAA;AAAA,MACA,YAAA,EAAa,EAAA;AAAA,MACb,MAAA,EAAQ,EAAE,OAAA,EAAS,IAAA,EAAM,KAAA;AAAM,KAAA;AAAA,IAL3B;AAAA,GAMN;AAEJ","file":"chunk-3ICWR3BK.js","sourcesContent":["import { NativeDocxEditor, type NativeDocxAdapter } from './NativeDocxEditor'\n\nexport interface StreamedWordArtifactProps {\n  adapter: NativeDocxAdapter\n  /** Streamed Markdown, shown as a read-only preview while the draft is generated. */\n  content: string\n  title: string\n  busy: boolean\n  error?: string | null\n  /** The DOCX draft the server stored for this generation (`doc-…`), once known. */\n  documentId?: string\n  onSaved?: (documentId: string) => void\n}\n\n/**\n * One drafting surface for an AI document draft. The server stores every draft as DOCX, so\n * this component never creates a document: it previews the streamed Markdown until generation\n * ends and the stored DOCX is known, then opens that DOCX in the live collaborative editor.\n */\nexport function StreamedWordArtifact({\n  adapter,\n  content,\n  title,\n  busy,\n  error,\n  documentId,\n  onSaved,\n}: StreamedWordArtifactProps) {\n  if (!busy && documentId) {\n    return (\n      <NativeDocxEditor\n        key={documentId}\n        adapter={adapter}\n        documentId={documentId}\n        title={title}\n        onSaved={onSaved}\n      />\n    )\n  }\n  return (\n    <NativeDocxEditor\n      key=\"stream-preview\"\n      adapter={adapter}\n      documentId=\"stream-preview\"\n      title={title}\n      draftContent=\"\"\n      stream={{ content, busy, error }}\n    />\n  )\n}\n"]}

package/dist/{chunk-MIMVRMKC.cjs → chunk-44TPPPRJ.cjs}

@@ -1285,8 +1285,6 @@ function DocxMentions({
     }
   ) });
 }
-
-// src/docx/definitions/fragment.ts
 var DEFINED_TERM_STYLE = "DefinedTerm";
 var FRAGMENT_STYLES = chunkAOFATOT3_cjs.stylesXml(
   "",
@@ -1319,12 +1317,13 @@ function base64(bytes) {
     binary += String.fromCharCode(...bytes.subarray(i, i + 32768));
   return btoa(binary);
 }
-function fragmentHtml(body, covered2) {
-  const bytes = chunkAOFATOT3_cjs.docxPackage({
+function fragmentHtml(body, covered2, revision) {
+  const untracked = chunkAOFATOT3_cjs.docxPackage({
     document: chunkAOFATOT3_cjs.documentXml(body),
     styles: FRAGMENT_STYLES,
     title: "Defined terms"
   });
+  const bytes = revision ? template.trackInsertion(untracked, revision, covered2) : untracked;
   return `<div data-docx-fragment="${base64(bytes)}" data-docx-fragment-end="${covered2 ? "covered" : "open"}"></div>`;
 }
 
@@ -1581,7 +1580,7 @@ function readParagraph(node, topLevel, bookmarks) {
     links
   };
 }
-function editorPort(editor) {
+function editorPort(editor, revision) {
   const surface = () => {
     const s = editor.surface;
     if (!s) throw new Error("The document is not open.");
@@ -1600,7 +1599,7 @@ function editorPort(editor) {
       surface().setSelection({ anchor: from, head: to });
       surface().deleteSelection();
     },
-    paste: (body, text, covered2) => editor.exec({ type: "paste", text, html: fragmentHtml(body, covered2) }).ok,
+    paste: (body, text, covered2) => editor.exec({ type: "paste", text, html: fragmentHtml(body, covered2, revision) }).ok,
     splitParagraph: () => surface().splitParagraph()
   };
 }
@@ -1643,6 +1642,70 @@ function holdCaret(editor, timeoutMs = 5e3) {
   const offSelection = editor.on("selectionChange", restore);
   const timer = setTimeout(stop, timeoutMs);
 }
+
+// src/docx/structural/trackedOrNoted.ts
+var revisionDate = (at = /* @__PURE__ */ new Date()) => at.toISOString().replace(/\.\d{3}Z$/, "Z");
+function trackedOrNoted(port, { label, author, insert, inserted = Boolean }) {
+  const mode = port.mode();
+  if (mode === "viewing") throw new Error("This document is read only.");
+  if (mode !== "suggesting") return { result: insert(null), how: "direct" };
+  const revision = { author, date: revisionDate() };
+  const before = port.caret();
+  const tracked = port.trackedBy(revision);
+  port.setMode("editing");
+  let result;
+  try {
+    result = insert(revision);
+  } finally {
+    port.setMode("suggesting");
+  }
+  if (!inserted(result) || port.trackedBy(revision) > tracked)
+    return { result, how: inserted(result) ? "tracked" : "direct" };
+  const after = port.caret();
+  if (before && after && port.comment(before, after, label)) return { result, how: "noted" };
+  return { result, how: "direct" };
+}
+var attr2 = (node, name) => node.attributes?.find((a) => a.localName === name)?.value;
+function structuralPort(editor) {
+  return {
+    mode: () => editor.getEditingMode(),
+    setMode: (mode) => void editor.setEditingMode(mode),
+    caret: () => {
+      const head = editor.surface?.state().selection?.head;
+      return head ? { paragraphId: head.paragraphId, offset: head.offset } : null;
+    },
+    // Read from the story's tree: the review pane merges adjacent insertions by one author into
+    // one card, so a card's date need not be this insert's.
+    trackedBy: ({ author, date }) => {
+      const root = editor.surface?.session.part().root;
+      let count = 0;
+      const visit = (node) => {
+        if (node.localName === "ins" && attr2(node, "author") === author && attr2(node, "date") === date)
+          count++;
+        node.children?.forEach(visit);
+      };
+      if (root) visit(root);
+      return count;
+    },
+    comment: (from, to, text) => {
+      const surface = editor.surface;
+      if (!surface) return false;
+      surface.setSelection({ anchor: from, head: to });
+      const ok2 = editor.addComment(text).ok;
+      surface.setSelection({ anchor: to, head: to });
+      return ok2;
+    }
+  };
+}
+var DocxAuthorContext = React3.createContext("You");
+function useTrackedOrNoted() {
+  const editor = react.useDocxEditor();
+  const author = React3.useContext(DocxAuthorContext);
+  return React3.useCallback(
+    (spec) => editor ? trackedOrNoted(structuralPort(editor), { ...spec, author }) : void 0,
+    [editor, author]
+  );
+}
 var DEFINED_TERM_TRIGGER = "@@";
 var TRIGGER_QUERY = /(?:^|[\s([{"“‘'])@@([^@\n\t]{0,40})$/;
 var MAX_GROUPS = 8;
@@ -1686,6 +1749,7 @@ function DefinedTermsProvider({
   labels
 }) {
   const editor = react.useDocxEditor();
+  const track = useTrackedOrNoted();
   const l = React3.useMemo(() => ({ ...DEFAULT_DEFINED_TERMS_LABELS, ...labels }), [labels]);
   const [sources, setSources] = React3.useState(null);
   const loadedAt = React3.useRef(0);
@@ -1742,35 +1806,46 @@ function DefinedTermsProvider({
   refreshRef.current = refresh;
   const firstHover = React3.useCallback(() => void refreshRef.current(), []);
   const caretRect = () => container().querySelector(".docx-editor-one-surface__caret")?.getBoundingClientRect();
-  const run = React3.useCallback(
+  const attempt = React3.useCallback(
     (fn) => {
-      if (!editor) return void 0;
       try {
-        return withDirectEditing(editor, fn);
+        return fn();
       } catch (error) {
         notify?.(error instanceof Error ? error.message : "Could not change the document.", "error");
         return void 0;
       }
     },
-    [editor, notify]
+    [notify]
+  );
+  const run = React3.useCallback(
+    (fn) => editor ? attempt(() => withDirectEditing(editor, fn)) : void 0,
+    [editor, attempt]
   );
   const pick = React3.useCallback(
     (row) => {
       if (!editor || !picker || !row) return;
       const port = editorPort(editor);
-      const result = run(() => {
+      const placed = run(() => {
         if (picker.mode === "search" && picker.caret) port.setCaret(picker.caret);
-        return insertDefinedTerm(port, row.definition, {
-          replace: picker.mode === "typing" ? DEFINED_TERM_TRIGGER.length + picker.query.length : 0
-        });
+        const caret = port.caret();
+        if (!caret) throw new Error("Place the cursor where the term should go.");
+        const typed = picker.mode === "typing" ? DEFINED_TERM_TRIGGER.length + picker.query.length : 0;
+        if (typed) port.deleteRange({ ...caret, offset: Math.max(0, caret.offset - typed) }, caret);
+        return true;
       });
+      const result = placed ? attempt(
+        () => track({
+          label: `Inserted defined term: ${row.definition.term}`,
+          insert: (revision) => insertDefinedTerm(editorPort(editor, revision), row.definition)
+        })?.result
+      ) : void 0;
       setPicker(null);
       editor.surface?.focus();
       if (result) holdCaret(editor);
       if (result?.addedDefinition)
         notify?.(`\u201C${row.definition.term}\u201D added to the Definitions section.`, "success");
     },
-    [editor, picker, run, notify]
+    [editor, picker, run, attempt, track, notify]
   );
   const openPicker = React3.useCallback(
     (anchor) => {
@@ -2174,6 +2249,7 @@ function HouseTemplateProvider({
   children
 }) {
   const editor = react.useDocxEditor();
+  const track = useTrackedOrNoted();
   const [template$1, setTemplate] = React3.useState(builtinHouseTemplate);
   const [divergence, setDivergence] = React3.useState(null);
   const [basedOnTemplate, setBasedOnTemplate] = React3.useState(false);
@@ -2214,11 +2290,18 @@ function HouseTemplateProvider({
       const fragment = template.buildingBlockFragment(template$1.bytes, name);
       if (!fragment) return false;
       try {
-        const result = withDirectEditing(
-          editor,
-          () => editor.exec({ type: "paste", text: "", html: template.fragmentClipboardHtml(fragment) })
-        );
-        if (!result.ok) throw new Error(result.reason ?? "The block could not be inserted here.");
+        const result = track({
+          label: `Inserted Quick Part: ${name}`,
+          insert: (revision) => editor.exec({
+            type: "paste",
+            text: "",
+            html: template.fragmentClipboardHtml(
+              revision ? template.trackInsertion(fragment, revision, true) : fragment
+            )
+          }),
+          inserted: (r) => r.ok
+        })?.result;
+        if (!result?.ok) throw new Error(result?.reason ?? "The block could not be inserted here.");
         refresh();
         return true;
       } catch (failure) {
@@ -2229,7 +2312,7 @@ function HouseTemplateProvider({
         return false;
       }
     },
-    [editor, editable, template$1, notify, refresh]
+    [editor, editable, template$1, notify, refresh, track]
   );
   const setAsHouseTemplate = React3.useMemo(
     () => host?.setFromDocument && documentId ? async () => {
@@ -3264,7 +3347,7 @@ function NativeDocxEditor({
               if (change.source !== "load") changed();
             },
             onFontError: (e) => setError(e.message),
-            children: /* @__PURE__ */ jsxRuntime.jsx(
+            children: /* @__PURE__ */ jsxRuntime.jsx(DocxAuthorContext.Provider, { value: ready.author, children: /* @__PURE__ */ jsxRuntime.jsx(
               DefinedTermsProvider,
               {
                 load: adapter.definitions,
@@ -3337,7 +3420,7 @@ function NativeDocxEditor({
                   }
                 )
               }
-            )
+            ) })
           }
         ) }, retry) }),
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "native-docx-actions", children: [
@@ -3436,6 +3519,7 @@ exports.BUILTIN_TEMPLATE_NAME = BUILTIN_TEMPLATE_NAME;
 exports.DEFAULT_DEFINED_TERMS_LABELS = DEFAULT_DEFINED_TERMS_LABELS;
 exports.DEFINED_TERM_TRIGGER = DEFINED_TERM_TRIGGER;
 exports.DefinedTermsProvider = DefinedTermsProvider;
+exports.DocxAuthorContext = DocxAuthorContext;
 exports.DocxCommentActivity = DocxCommentActivity;
 exports.DocxEditorReview = DocxEditorReview;
 exports.DocxMentions = DocxMentions;
@@ -3452,12 +3536,15 @@ exports.loadDocxFonts = loadDocxFonts;
 exports.normalizeDocxExport = normalizeDocxExport;
 exports.resolveHouseTemplate = resolveHouseTemplate;
 exports.reviewModule = reviewModule;
+exports.structuralPort = structuralPort;
 exports.templateFileName = templateFileName;
+exports.trackedOrNoted = trackedOrNoted;
 exports.updateDefinitions = updateDefinitions;
 exports.useDefinedTerms = useDefinedTerms;
 exports.useHouseTemplate = useHouseTemplate;
 exports.useReview = useReview;
 exports.useReviewItem = useReviewItem;
+exports.useTrackedOrNoted = useTrackedOrNoted;
 exports.withDirectEditing = withDirectEditing;
-//# sourceMappingURL=chunk-MIMVRMKC.cjs.map
-//# sourceMappingURL=chunk-MIMVRMKC.cjs.map
+//# sourceMappingURL=chunk-44TPPPRJ.cjs.map
+//# sourceMappingURL=chunk-44TPPPRJ.cjs.map