@arbidocs/coedit 0.4.157 → 0.4.159

package/dist/commands.cjs

@@ -508,11 +508,84 @@ function paragraphRunsXml(paragraph) {
   }
   return runs.length ? runs.join("") : null;
 }
+
+// src/commands/signatureFields.ts
+var SIGNATURE_FIELDS_NAMESPACE = "urn:arbi:signature-fields";
+var SIGNATURE_FIELD_TAG_PREFIX = "arbi-signature:";
+var SIGNATURE_FIELD_KINDS = ["signature", "initials", "date", "name"];
+var SIGNATURE_FIELD_LABELS = {
+  signature: "Signature",
+  initials: "Initials",
+  date: "Date signed",
+  name: "Name"
+};
+var TAG = /^arbi-signature:(signature|initials|date|name)(?::([0-9a-f]{8}))?$/;
+var EMAIL = /^[^@\s<>,;]{1,64}@[^@\s<>,;]{1,255}\.[^@\s<>,;]{1,63}$/;
+var isSignerEmail = (value) => EMAIL.test(value.trim());
+function newSignatureFieldKey() {
+  const bytes = new Uint8Array(4);
+  globalThis.crypto.getRandomValues(bytes);
+  return [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
+}
+var signatureFieldTag = (kind, key) => `${SIGNATURE_FIELD_TAG_PREFIX}${kind}${key ? `:${key}` : ""}`;
+var signatureFieldLabel = (kind, who) => who?.trim() ? `${SIGNATURE_FIELD_LABELS[kind]} \u2014 ${who.trim()}` : SIGNATURE_FIELD_LABELS[kind];
+function parseSignatureFieldTag(tag) {
+  const m = TAG.exec(tag ?? "");
+  return m ? { kind: m[1], key: m[2] ?? null } : null;
+}
+function signatureFieldWrite(spec, at, key = newSignatureFieldKey()) {
+  const email = spec.email?.trim().toLowerCase() || null;
+  if (email && !isSignerEmail(email)) throw new Error("Enter the signer\u2019s email address.");
+  const name = spec.name?.trim().slice(0, 200) || null;
+  const text = signatureFieldLabel(spec.kind, name || email);
+  const payload = email ? { key, kind: spec.kind, email, name, required: spec.required !== false } : null;
+  return {
+    key: payload ? key : null,
+    tag: signatureFieldTag(spec.kind, payload ? key : null),
+    write: {
+      paragraphId: at.paragraphId,
+      offset: at.offset,
+      tag: signatureFieldTag(spec.kind, payload ? key : null),
+      text,
+      alias: text,
+      lock: "contentLocked",
+      ...payload ? {
+        payload: {
+          namespaceUri: SIGNATURE_FIELDS_NAMESPACE,
+          rootLocalName: "fields",
+          nodeId: `sig-${key}`,
+          label: text,
+          data: JSON.stringify(payload)
+        }
+      } : {}
+    }
+  };
+}
+var attr2 = (node, name) => node?.attributes?.find((a) => a.localName === name)?.value;
+function signatureFieldControls(root) {
+  const out = [];
+  const visit = (node) => {
+    if (node.localName === "sdt") {
+      const props = node.children?.find((c) => c.localName === "sdtPr");
+      const tag = attr2(
+        props?.children?.find((c) => c.localName === "tag"),
+        "val"
+      );
+      const parsed = parseSignatureFieldTag(tag);
+      if (parsed && tag) out.push({ nodeId: node.id, tag, ...parsed });
+    }
+    if (node.kind !== "textValue") for (const child2 of node.children ?? []) visit(child2);
+  };
+  visit(root);
+  return out;
+}
+
+// src/commands/undo.ts
 var AGENT_UNDO_MAP = "agentUndo";
-var attr2 = (node, name) => node.attributes?.find((a) => a.localName === name)?.value;
+var attr3 = (node, name) => node.attributes?.find((a) => a.localName === name)?.value;
 var child = (node, name) => node?.children?.find((c) => c.localName === name);
 var twips = (node, name) => {
-  const value = node && attr2(node, name);
+  const value = node && attr3(node, name);
   return value === void 0 ? void 0 : Number(value);
 };
 var FLAT = new Set(
@@ -525,7 +598,7 @@ function paragraphIndex(root) {
     for (const c of node.children ?? []) {
       parentOf.set(c, node);
       if (c.kind === "paragraph") {
-        const id = attr2(c, "paraId");
+        const id = attr3(c, "paraId");
         if (id) byParaId.set(id, c);
       }
       if (c.kind !== "textValue") visit(c);
@@ -547,28 +620,28 @@ function paragraphState(paragraph) {
         attributes: Object.fromEntries((p.attributes ?? []).map((a) => [a.localName, a.value]))
       });
     } else if (p.localName === "numPr") {
-      const numId = attr2(child(p, "numId") ?? p, "val");
-      if (numId) numbering = { numId, level: Number(attr2(child(p, "ilvl") ?? p, "val") ?? 0) };
+      const numId = attr3(child(p, "numId") ?? p, "val");
+      if (numId) numbering = { numId, level: Number(attr3(child(p, "ilvl") ?? p, "val") ?? 0) };
     } else if (p.localName === "tabs") {
       for (const tab of p.children ?? []) {
-        const val = attr2(tab, "val");
+        const val = attr3(tab, "val");
         if (!val || val === "clear") continue;
         tabs.push({
-          positionTwips: Number(attr2(tab, "pos") ?? 0),
+          positionTwips: Number(attr3(tab, "pos") ?? 0),
           alignment: val === "start" ? "left" : val === "end" ? "right" : val,
-          ...attr2(tab, "leader") ? { leader: attr2(tab, "leader") } : {}
+          ...attr3(tab, "leader") ? { leader: attr3(tab, "leader") } : {}
         });
       }
     }
   }
-  return { paraId: attr2(paragraph, "paraId") ?? "", properties, numbering, tabs };
+  return { paraId: attr3(paragraph, "paraId") ?? "", properties, numbering, tabs };
 }
 function sectionStates(root) {
   const { body } = paragraphIndex(root);
   const state = (sectPr, paraId) => {
     const size = child(sectPr, "pgSz");
     const margin = child(sectPr, "pgMar");
-    const orient = size && attr2(size, "orient");
+    const orient = size && attr3(size, "orient");
     return {
       paraId,
       pageWidthTwips: twips(size, "w"),
@@ -583,7 +656,7 @@ function sectionStates(root) {
   const out = [];
   for (const block of body.children ?? []) {
     const sectPr = block.kind === "paragraph" ? child(child(block, "pPr"), "sectPr") : void 0;
-    if (sectPr) out.push(state(sectPr, attr2(block, "paraId") ?? null));
+    if (sectPr) out.push(state(sectPr, attr3(block, "paraId") ?? null));
     else if (block.localName === "sectPr") out.push(state(block, null));
   }
   return out;
@@ -602,10 +675,10 @@ function tableState(root, paraId) {
   for (const row of table.children ?? []) {
     if (row.localName !== "tr") continue;
     const header = child(child(row, "trPr"), "tblHeader");
-    if (!header || ["0", "false", "off"].includes(attr2(header, "val") ?? "")) break;
+    if (!header || ["0", "false", "off"].includes(attr3(header, "val") ?? "")) break;
     headerRowCount++;
   }
-  return { kind: "table", paraId, styleId: (style && attr2(style, "val")) ?? null, headerRowCount };
+  return { kind: "table", paraId, styleId: (style && attr3(style, "val")) ?? null, headerRowCount };
 }
 function fieldNodeIds(paragraph) {
   const out = [];
@@ -614,7 +687,7 @@ function fieldNodeIds(paragraph) {
     for (const c of node.children ?? []) {
       if (c.localName === "del") continue;
       if (c.localName === "fldChar") {
-        const type = attr2(c, "fldCharType");
+        const type = attr3(c, "fldCharType");
         if (type === "begin" && depth++ === 0) out.push(c.id);
         else if (type === "end") depth = Math.max(0, depth - 1);
       } else if (c.kind !== "textValue") walk(c);
@@ -658,6 +731,15 @@ function undoOps(root, record) {
       styleId: record.styleId ?? "",
       headerRowCount: record.headerRowCount
     });
+  } else if (record.kind === "signatureField") {
+    const controls = signatureFieldControls(root).filter((c) => c.tag === record.tag);
+    if (!controls.length) return null;
+    for (const control of controls) {
+      ops.push(
+        { op: "setContentControlProperties", controlId: control.nodeId, lock: "unlocked" },
+        { op: "removeContentControl", controlId: control.nodeId, keepContent: false }
+      );
+    }
   } else {
     const updates = [];
     for (const { paraId, index, text } of record.fields) {
@@ -1038,12 +1120,12 @@ function fragmentPackage(body, covered, {
   });
   return revision ? trackInsertion(untracked, revision, covered) : untracked;
 }
-var attr3 = (node, name) => node.attributes?.find((a) => a.localName === name)?.value;
+var attr4 = (node, name) => node.attributes?.find((a) => a.localName === name)?.value;
 function documentStyleIds(root) {
   const ids = /* @__PURE__ */ new Set();
   for (const style of root?.children ?? [])
     if (style.localName === "style") {
-      const id = attr3(style, "styleId");
+      const id = attr4(style, "styleId");
       if (id) ids.add(id);
     }
   return ids;
@@ -1365,6 +1447,10 @@ exports.DEFINITIONS_HEADING = DEFINITIONS_HEADING;
 exports.DEFINITION_BOOKMARK_PREFIX = DEFINITION_BOOKMARK_PREFIX;
 exports.FIELD_ATOM = FIELD_ATOM;
 exports.REF_BOOKMARK_PREFIX = REF_BOOKMARK_PREFIX;
+exports.SIGNATURE_FIELDS_NAMESPACE = SIGNATURE_FIELDS_NAMESPACE;
+exports.SIGNATURE_FIELD_KINDS = SIGNATURE_FIELD_KINDS;
+exports.SIGNATURE_FIELD_LABELS = SIGNATURE_FIELD_LABELS;
+exports.SIGNATURE_FIELD_TAG_PREFIX = SIGNATURE_FIELD_TAG_PREFIX;
 exports.TermEverywhereError = TermEverywhereError;
 exports.WATCHED_STYLES = WATCHED_STYLES;
 exports.W_NAMESPACES = W_NAMESPACES;
@@ -1404,14 +1490,17 @@ exports.insertDefinedTerm = insertDefinedTerm;
 exports.insertDocumentReference = insertDocumentReference;
 exports.insertionIndex = insertionIndex;
 exports.isDefinitionsTitle = isDefinitionsTitle;
+exports.isSignerEmail = isSignerEmail;
 exports.listTargets = listTargets;
 exports.markCrossReferenceTarget = markCrossReferenceTarget;
 exports.newRefBookmark = newRefBookmark;
+exports.newSignatureFieldKey = newSignatureFieldKey;
 exports.paragraphIndex = paragraphIndex;
 exports.paragraphNumber = paragraphNumber;
 exports.paragraphRunsXml = paragraphRunsXml;
 exports.paragraphState = paragraphState;
 exports.parseDefinition = parseDefinition;
+exports.parseSignatureFieldTag = parseSignatureFieldTag;
 exports.readDocument = readDocument;
 exports.readParagraphs = readParagraphs;
 exports.refFieldXml = refFieldXml;
@@ -1421,6 +1510,10 @@ exports.refTooltip = refTooltip;
 exports.refreshCrossReferences = refreshCrossReferences;
 exports.replaceSpan = replaceSpan;
 exports.sectionStates = sectionStates;
+exports.signatureFieldControls = signatureFieldControls;
+exports.signatureFieldLabel = signatureFieldLabel;
+exports.signatureFieldTag = signatureFieldTag;
+exports.signatureFieldWrite = signatureFieldWrite;
 exports.staleCrossReferences = staleCrossReferences;
 exports.styleNames = styleNames;
 exports.stylesUsed = stylesUsed;