@arbidocs/coedit 0.4.98 → 0.4.100

package/dist/template.d.cts

@@ -50,6 +50,22 @@ declare function buildingBlockFragment(template: Uint8Array, name: string): Uint
 /** A fragment's body as clipboard HTML the editor's paste recognises as its own. */
 declare function fragmentClipboardHtml(fragment: Uint8Array, covered?: boolean): string;
 
+/** Who made a tracked change and when (`w:author`, `w:date`). */
+interface Revision {
+    author: string;
+    /** ISO 8601, seconds precision, e.g. `2026-10-19T09:30:00Z`. */
+    date: string;
+}
+/**
+ * The fragment with every run wrapped in `w:ins` and every new paragraph mark marked inserted. A
+ * table row is marked inserted as a whole, its cells left as they are: the editor rejects an
+ * inserted row whose content is tracked as well only partly. A run is not descended into, so a
+ * text box goes in with its run. `covered`: the fragment's last paragraph mark is pasted too (a
+ * block before the caret's paragraph); otherwise the last paragraph runs into the text after the
+ * caret and its mark is not new.
+ */
+declare function trackInsertion(fragment: Uint8Array, revision: Revision, covered: boolean): Uint8Array;
+
 interface StyleDifference {
     styleId: string;
     name: string;
@@ -106,4 +122,4 @@ declare class TemplateError extends Error {
     constructor(message: string);
 }
 
-export { type ApplyTemplateOptions, type ApplyTemplateReport, type BuildingBlockInfo, LEGAL_BUILDING_BLOCKS, LEGAL_NUM, type LegalTemplateOptions, type LinkedLevel, type StyleDifference, type StyleDivergence, TemplateError, applyTemplate, attachedTemplateOf, buildingBlockFragment, composeWithTemplate, defaultLegalTemplate, fragmentClipboardHtml, linkedLevelStyles, listBuildingBlocks, newFromTemplate, styleDivergence };
+export { type ApplyTemplateOptions, type ApplyTemplateReport, type BuildingBlockInfo, LEGAL_BUILDING_BLOCKS, LEGAL_NUM, type LegalTemplateOptions, type LinkedLevel, type Revision, type StyleDifference, type StyleDivergence, TemplateError, applyTemplate, attachedTemplateOf, buildingBlockFragment, composeWithTemplate, defaultLegalTemplate, fragmentClipboardHtml, linkedLevelStyles, listBuildingBlocks, newFromTemplate, styleDivergence, trackInsertion };

package/dist/template.d.ts

@@ -50,6 +50,22 @@ declare function buildingBlockFragment(template: Uint8Array, name: string): Uint
 /** A fragment's body as clipboard HTML the editor's paste recognises as its own. */
 declare function fragmentClipboardHtml(fragment: Uint8Array, covered?: boolean): string;
 
+/** Who made a tracked change and when (`w:author`, `w:date`). */
+interface Revision {
+    author: string;
+    /** ISO 8601, seconds precision, e.g. `2026-10-19T09:30:00Z`. */
+    date: string;
+}
+/**
+ * The fragment with every run wrapped in `w:ins` and every new paragraph mark marked inserted. A
+ * table row is marked inserted as a whole, its cells left as they are: the editor rejects an
+ * inserted row whose content is tracked as well only partly. A run is not descended into, so a
+ * text box goes in with its run. `covered`: the fragment's last paragraph mark is pasted too (a
+ * block before the caret's paragraph); otherwise the last paragraph runs into the text after the
+ * caret and its mark is not new.
+ */
+declare function trackInsertion(fragment: Uint8Array, revision: Revision, covered: boolean): Uint8Array;
+
 interface StyleDifference {
     styleId: string;
     name: string;
@@ -106,4 +122,4 @@ declare class TemplateError extends Error {
     constructor(message: string);
 }
 
-export { type ApplyTemplateOptions, type ApplyTemplateReport, type BuildingBlockInfo, LEGAL_BUILDING_BLOCKS, LEGAL_NUM, type LegalTemplateOptions, type LinkedLevel, type StyleDifference, type StyleDivergence, TemplateError, applyTemplate, attachedTemplateOf, buildingBlockFragment, composeWithTemplate, defaultLegalTemplate, fragmentClipboardHtml, linkedLevelStyles, listBuildingBlocks, newFromTemplate, styleDivergence };
+export { type ApplyTemplateOptions, type ApplyTemplateReport, type BuildingBlockInfo, LEGAL_BUILDING_BLOCKS, LEGAL_NUM, type LegalTemplateOptions, type LinkedLevel, type Revision, type StyleDifference, type StyleDivergence, TemplateError, applyTemplate, attachedTemplateOf, buildingBlockFragment, composeWithTemplate, defaultLegalTemplate, fragmentClipboardHtml, linkedLevelStyles, listBuildingBlocks, newFromTemplate, styleDivergence, trackInsertion };

package/dist/template.js

@@ -811,6 +811,59 @@ function fragmentClipboardHtml(fragment, covered = true) {
   return `<div data-docx-fragment="${btoa(binary)}" data-docx-fragment-end="${covered ? "covered" : "open"}"></div>`;
 }
 
+// src/template/track.ts
+var TRACKED = /* @__PURE__ */ new Set(["w:ins", "w:del", "w:moveFrom", "w:moveTo"]);
+function trackInsertion(fragment, revision, covered) {
+  const pkg = Pkg.read(fragment);
+  const main = pkg.main;
+  const root = pkg.xml(main);
+  const body = kid(root, "w:body");
+  if (!root || !body) return fragment;
+  const attrs = { "w:id": "1", "w:author": revision.author, "w:date": revision.date };
+  const lastParagraph = body.children.filter(isEl).findLast((c) => c.name === "w:p");
+  const visit = (node) => {
+    node.children = node.children.map((child) => {
+      if (!isEl(child)) return child;
+      if (child.name === "w:r") return TRACKED.has(node.name) ? child : el("w:ins", attrs, [child]);
+      if (TRACKED.has(child.name)) return child;
+      if (child.name === "w:tr") {
+        markRow(child, attrs);
+        return child;
+      }
+      visit(child);
+      if (child.name === "w:p" && (covered || child !== lastParagraph)) markParagraph(child, attrs);
+      return child;
+    });
+  };
+  visit(body);
+  pkg.setXml(main, root);
+  return pkg.write();
+}
+function markParagraph(p, attrs) {
+  let pPr = kid(p, "w:pPr");
+  if (!pPr) p.children.unshift(pPr = el("w:pPr"));
+  let rPr = kid(pPr, "w:rPr");
+  if (!rPr) {
+    rPr = el("w:rPr");
+    const at = pPr.children.findIndex(
+      (c) => isEl(c) && (c.name === "w:sectPr" || c.name === "w:pPrChange")
+    );
+    pPr.children.splice(at < 0 ? pPr.children.length : at, 0, rPr);
+  }
+  if (!kid(rPr, "w:ins")) rPr.children.unshift(el("w:ins", attrs));
+}
+function markRow(tr, attrs) {
+  let trPr = kid(tr, "w:trPr");
+  if (!trPr) {
+    trPr = el("w:trPr");
+    const after = tr.children.findIndex((c) => isEl(c) && c.name === "w:tblPrEx");
+    tr.children.splice(after + 1, 0, trPr);
+  }
+  if (kid(trPr, "w:ins")) return;
+  const at = trPr.children.findIndex((c) => isEl(c) && c.name === "w:trPrChange");
+  trPr.children.splice(at < 0 ? trPr.children.length : at, 0, el("w:ins", attrs));
+}
+
 // src/template/divergence.ts
 var UI_ONLY = /* @__PURE__ */ new Set([
   "w:uiPriority",
@@ -1554,6 +1607,6 @@ function linkedLevelStyles(document) {
   return out;
 }
 
-export { LEGAL_BUILDING_BLOCKS, LEGAL_NUM, TemplateError, applyTemplate, attachedTemplateOf, buildingBlockFragment, composeWithTemplate, defaultLegalTemplate, fragmentClipboardHtml, linkedLevelStyles, listBuildingBlocks, newFromTemplate, styleDivergence };
+export { LEGAL_BUILDING_BLOCKS, LEGAL_NUM, TemplateError, applyTemplate, attachedTemplateOf, buildingBlockFragment, composeWithTemplate, defaultLegalTemplate, fragmentClipboardHtml, linkedLevelStyles, listBuildingBlocks, newFromTemplate, styleDivergence, trackInsertion };
 //# sourceMappingURL=template.js.map
 //# sourceMappingURL=template.js.map