@arbidocs/coedit 0.4.158 → 0.4.159

package/dist/commands.d.cts

@@ -204,6 +204,11 @@ type UndoRecord = {
         index: number;
         text: string;
     }[];
+}
+/** A signature field ARBI inserted (by its tag, which its key makes unique): undo removes it. */
+ | {
+    kind: 'signatureField';
+    tag: string;
 };
 /** Every paragraph of a part, by `w14:paraId`, and the body's own paragraphs in order. */
 declare function paragraphIndex(root: OoxmlNodeLike): {
@@ -470,6 +475,84 @@ declare function applyTermEverywhere(port: DefinitionsPort, spec: TermSpec & {
     accept?: (paragraph: DocParagraph) => boolean;
 }): TermEverywhereResult;
 
+/**
+ * Signature fields in a Word document (ARBI `docs/signature-anchor-fields.md`).
+ *
+ * A field is a content control tagged `arbi-signature:<kind>[:<key>]` whose text is a chip
+ * ("Signature — Priya Shah"), locked against typing. A keyed field carries a hidden payload in a
+ * customXml part (`SIGNATURE_FIELDS_NAMESPACE`) naming its signer: their email and name, and
+ * whether the field is required. When a version is rendered to PDF, ARBI's parser turns each
+ * field into an invisible anchor, and a signature request places the field exactly there, for
+ * that signer. A field with no key has no signer yet: it is assigned when the request is made.
+ *
+ * The collaboration service (ARBI's `insert_signature_field`) writes the same control.
+ */
+
+declare const SIGNATURE_FIELDS_NAMESPACE = "urn:arbi:signature-fields";
+declare const SIGNATURE_FIELD_TAG_PREFIX = "arbi-signature:";
+declare const SIGNATURE_FIELD_KINDS: readonly ["signature", "initials", "date", "name"];
+type SignatureFieldKind = (typeof SIGNATURE_FIELD_KINDS)[number];
+/** The labels a signature request uses for the same kinds (`FIELD_TYPE_LABELS`). */
+declare const SIGNATURE_FIELD_LABELS: Record<SignatureFieldKind, string>;
+interface SignatureFieldSpec {
+    kind: SignatureFieldKind;
+    /** The signer's email; omitted for a field whose signer is chosen when the request is made. */
+    email?: string | null;
+    name?: string | null;
+    required?: boolean;
+}
+/** What the payload of a keyed field holds. */
+interface SignatureFieldPayload {
+    key: string;
+    kind: SignatureFieldKind;
+    email: string;
+    name: string | null;
+    required: boolean;
+}
+declare const isSignerEmail: (value: string) => boolean;
+/** 8 random hex digits: the key the field and its PDF anchor share. */
+declare function newSignatureFieldKey(): string;
+declare const signatureFieldTag: (kind: SignatureFieldKind, key?: string | null) => string;
+/** The chip's text: what the field is, and for whom ("Signature — Priya Shah"). */
+declare const signatureFieldLabel: (kind: SignatureFieldKind, who?: string | null) => string;
+declare function parseSignatureFieldTag(tag: string | null | undefined): {
+    kind: SignatureFieldKind;
+    key: string | null;
+} | null;
+/**
+ * The engine's custom-node write for a field at `at` (the store's `insertCustomNode`): the
+ * control, and for a field with a signer its payload, in one transaction.
+ */
+declare function signatureFieldWrite(spec: SignatureFieldSpec, at: {
+    paragraphId: string;
+    offset: number;
+}, key?: string): {
+    key: string | null;
+    tag: string;
+    write: {
+        payload?: {
+            namespaceUri: string;
+            rootLocalName: string;
+            nodeId: string;
+            label: string;
+            data: string;
+        } | undefined;
+        paragraphId: string;
+        offset: number;
+        tag: string;
+        text: string;
+        alias: string;
+        lock: "contentLocked";
+    };
+};
+/** Every signature field control in a part's tree, in document order. */
+declare function signatureFieldControls(root: OoxmlNodeLike): {
+    nodeId: string;
+    tag: string;
+    kind: SignatureFieldKind;
+    key: string | null;
+}[];
+
 /** A document's parts as trees: a live editor's session or a headless view (`openHeadlessDocument`). */
 interface DocumentTrees {
     part(): {
@@ -497,4 +580,4 @@ declare function documentReader(view: DocumentTrees): DocumentReader;
 /** Read a document from its bytes (a collaboration room's `readRoom`). Throws on a bad package. */
 declare function readDocument(bytes: Uint8Array): DocumentReader;
 
-export { AGENT_UNDO_MAP, type BrokenReference, CHARACTER_STYLES, type CrossReference, type CrossReferenceMode, CrossReferenceTarget, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, type DefinitionText, DefinitionsPort, type DefinitionsSection, DocParagraph, DocPoint, DocumentNumbering, type DocumentReader, type DocumentTrees, type InsertTermResult, LevelOf, ListItemInfo, OoxmlNodeLike, type ParagraphState, type ParsedDefinition, REF_BOOKMARK_PREFIX, ReferencesPort, type ReferencesReader, type RefreshResult, type ReplacedSpan, type SectionState, type StaleReference, type TermChange, TermEverywhereError, type TermEverywhereResult, type TermSkip, type TermSkipReason, type TermSpec, type TermUse, type UndoRecord, W_NAMESPACES, addDefinition, applyTermEverywhere, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, ensureTargetBookmark, esc, fieldNodeIds, findDefinitionsSection, findTermUses, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, markCrossReferenceTarget, newRefBookmark, paragraphIndex, paragraphRunsXml, paragraphState, parseDefinition, readDocument, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, replaceSpan, sectionStates, staleCrossReferences, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps, withoutArticle };
+export { AGENT_UNDO_MAP, type BrokenReference, CHARACTER_STYLES, type CrossReference, type CrossReferenceMode, CrossReferenceTarget, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, type DefinitionText, DefinitionsPort, type DefinitionsSection, DocParagraph, DocPoint, DocumentNumbering, type DocumentReader, type DocumentTrees, type InsertTermResult, LevelOf, ListItemInfo, OoxmlNodeLike, type ParagraphState, type ParsedDefinition, REF_BOOKMARK_PREFIX, ReferencesPort, type ReferencesReader, type RefreshResult, type ReplacedSpan, SIGNATURE_FIELDS_NAMESPACE, SIGNATURE_FIELD_KINDS, SIGNATURE_FIELD_LABELS, SIGNATURE_FIELD_TAG_PREFIX, type SectionState, type SignatureFieldKind, type SignatureFieldPayload, type SignatureFieldSpec, type StaleReference, type TermChange, TermEverywhereError, type TermEverywhereResult, type TermSkip, type TermSkipReason, type TermSpec, type TermUse, type UndoRecord, W_NAMESPACES, addDefinition, applyTermEverywhere, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, ensureTargetBookmark, esc, fieldNodeIds, findDefinitionsSection, findTermUses, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, isSignerEmail, markCrossReferenceTarget, newRefBookmark, newSignatureFieldKey, paragraphIndex, paragraphRunsXml, paragraphState, parseDefinition, parseSignatureFieldTag, readDocument, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, replaceSpan, sectionStates, signatureFieldControls, signatureFieldLabel, signatureFieldTag, signatureFieldWrite, staleCrossReferences, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps, withoutArticle };

package/dist/commands.d.ts

@@ -204,6 +204,11 @@ type UndoRecord = {
         index: number;
         text: string;
     }[];
+}
+/** A signature field ARBI inserted (by its tag, which its key makes unique): undo removes it. */
+ | {
+    kind: 'signatureField';
+    tag: string;
 };
 /** Every paragraph of a part, by `w14:paraId`, and the body's own paragraphs in order. */
 declare function paragraphIndex(root: OoxmlNodeLike): {
@@ -470,6 +475,84 @@ declare function applyTermEverywhere(port: DefinitionsPort, spec: TermSpec & {
     accept?: (paragraph: DocParagraph) => boolean;
 }): TermEverywhereResult;
 
+/**
+ * Signature fields in a Word document (ARBI `docs/signature-anchor-fields.md`).
+ *
+ * A field is a content control tagged `arbi-signature:<kind>[:<key>]` whose text is a chip
+ * ("Signature — Priya Shah"), locked against typing. A keyed field carries a hidden payload in a
+ * customXml part (`SIGNATURE_FIELDS_NAMESPACE`) naming its signer: their email and name, and
+ * whether the field is required. When a version is rendered to PDF, ARBI's parser turns each
+ * field into an invisible anchor, and a signature request places the field exactly there, for
+ * that signer. A field with no key has no signer yet: it is assigned when the request is made.
+ *
+ * The collaboration service (ARBI's `insert_signature_field`) writes the same control.
+ */
+
+declare const SIGNATURE_FIELDS_NAMESPACE = "urn:arbi:signature-fields";
+declare const SIGNATURE_FIELD_TAG_PREFIX = "arbi-signature:";
+declare const SIGNATURE_FIELD_KINDS: readonly ["signature", "initials", "date", "name"];
+type SignatureFieldKind = (typeof SIGNATURE_FIELD_KINDS)[number];
+/** The labels a signature request uses for the same kinds (`FIELD_TYPE_LABELS`). */
+declare const SIGNATURE_FIELD_LABELS: Record<SignatureFieldKind, string>;
+interface SignatureFieldSpec {
+    kind: SignatureFieldKind;
+    /** The signer's email; omitted for a field whose signer is chosen when the request is made. */
+    email?: string | null;
+    name?: string | null;
+    required?: boolean;
+}
+/** What the payload of a keyed field holds. */
+interface SignatureFieldPayload {
+    key: string;
+    kind: SignatureFieldKind;
+    email: string;
+    name: string | null;
+    required: boolean;
+}
+declare const isSignerEmail: (value: string) => boolean;
+/** 8 random hex digits: the key the field and its PDF anchor share. */
+declare function newSignatureFieldKey(): string;
+declare const signatureFieldTag: (kind: SignatureFieldKind, key?: string | null) => string;
+/** The chip's text: what the field is, and for whom ("Signature — Priya Shah"). */
+declare const signatureFieldLabel: (kind: SignatureFieldKind, who?: string | null) => string;
+declare function parseSignatureFieldTag(tag: string | null | undefined): {
+    kind: SignatureFieldKind;
+    key: string | null;
+} | null;
+/**
+ * The engine's custom-node write for a field at `at` (the store's `insertCustomNode`): the
+ * control, and for a field with a signer its payload, in one transaction.
+ */
+declare function signatureFieldWrite(spec: SignatureFieldSpec, at: {
+    paragraphId: string;
+    offset: number;
+}, key?: string): {
+    key: string | null;
+    tag: string;
+    write: {
+        payload?: {
+            namespaceUri: string;
+            rootLocalName: string;
+            nodeId: string;
+            label: string;
+            data: string;
+        } | undefined;
+        paragraphId: string;
+        offset: number;
+        tag: string;
+        text: string;
+        alias: string;
+        lock: "contentLocked";
+    };
+};
+/** Every signature field control in a part's tree, in document order. */
+declare function signatureFieldControls(root: OoxmlNodeLike): {
+    nodeId: string;
+    tag: string;
+    kind: SignatureFieldKind;
+    key: string | null;
+}[];
+
 /** A document's parts as trees: a live editor's session or a headless view (`openHeadlessDocument`). */
 interface DocumentTrees {
     part(): {
@@ -497,4 +580,4 @@ declare function documentReader(view: DocumentTrees): DocumentReader;
 /** Read a document from its bytes (a collaboration room's `readRoom`). Throws on a bad package. */
 declare function readDocument(bytes: Uint8Array): DocumentReader;
 
-export { AGENT_UNDO_MAP, type BrokenReference, CHARACTER_STYLES, type CrossReference, type CrossReferenceMode, CrossReferenceTarget, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, type DefinitionText, DefinitionsPort, type DefinitionsSection, DocParagraph, DocPoint, DocumentNumbering, type DocumentReader, type DocumentTrees, type InsertTermResult, LevelOf, ListItemInfo, OoxmlNodeLike, type ParagraphState, type ParsedDefinition, REF_BOOKMARK_PREFIX, ReferencesPort, type ReferencesReader, type RefreshResult, type ReplacedSpan, type SectionState, type StaleReference, type TermChange, TermEverywhereError, type TermEverywhereResult, type TermSkip, type TermSkipReason, type TermSpec, type TermUse, type UndoRecord, W_NAMESPACES, addDefinition, applyTermEverywhere, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, ensureTargetBookmark, esc, fieldNodeIds, findDefinitionsSection, findTermUses, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, markCrossReferenceTarget, newRefBookmark, paragraphIndex, paragraphRunsXml, paragraphState, parseDefinition, readDocument, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, replaceSpan, sectionStates, staleCrossReferences, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps, withoutArticle };
+export { AGENT_UNDO_MAP, type BrokenReference, CHARACTER_STYLES, type CrossReference, type CrossReferenceMode, CrossReferenceTarget, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, type DefinitionText, DefinitionsPort, type DefinitionsSection, DocParagraph, DocPoint, DocumentNumbering, type DocumentReader, type DocumentTrees, type InsertTermResult, LevelOf, ListItemInfo, OoxmlNodeLike, type ParagraphState, type ParsedDefinition, REF_BOOKMARK_PREFIX, ReferencesPort, type ReferencesReader, type RefreshResult, type ReplacedSpan, SIGNATURE_FIELDS_NAMESPACE, SIGNATURE_FIELD_KINDS, SIGNATURE_FIELD_LABELS, SIGNATURE_FIELD_TAG_PREFIX, type SectionState, type SignatureFieldKind, type SignatureFieldPayload, type SignatureFieldSpec, type StaleReference, type TermChange, TermEverywhereError, type TermEverywhereResult, type TermSkip, type TermSkipReason, type TermSpec, type TermUse, type UndoRecord, W_NAMESPACES, addDefinition, applyTermEverywhere, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, ensureTargetBookmark, esc, fieldNodeIds, findDefinitionsSection, findTermUses, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, isSignerEmail, markCrossReferenceTarget, newRefBookmark, newSignatureFieldKey, paragraphIndex, paragraphRunsXml, paragraphState, parseDefinition, parseSignatureFieldTag, readDocument, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, replaceSpan, sectionStates, signatureFieldControls, signatureFieldLabel, signatureFieldTag, signatureFieldWrite, staleCrossReferences, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps, withoutArticle };

package/dist/commands.js

@@ -506,11 +506,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(
@@ -523,7 +596,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);
@@ -545,28 +618,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"),
@@ -581,7 +654,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;
@@ -600,10 +673,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 = [];
@@ -612,7 +685,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);
@@ -656,6 +729,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) {
@@ -1036,12 +1118,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;
@@ -1354,6 +1436,6 @@ function readDocument(bytes) {
   return documentReader(opened.view);
 }
 
-export { AGENT_UNDO_MAP, BROKEN_CROSS_REFERENCE_STYLE, CHARACTER_STYLES, CROSS_REFERENCE_STYLE, DEFINED_TERM_STYLE, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, FIELD_ATOM, REF_BOOKMARK_PREFIX, TermEverywhereError, WATCHED_STYLES, W_NAMESPACES, addDefinition, applyTermEverywhere, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentNumbering, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, engineLength, engineOffset, ensureTargetBookmark, esc, fieldNodeIds, filterTargets, findDefinitionsSection, findTermUses, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, listTargets, markCrossReferenceTarget, newRefBookmark, paragraphIndex, paragraphNumber, paragraphRunsXml, paragraphState, parseDefinition, readDocument, readParagraphs, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, replaceSpan, sectionStates, staleCrossReferences, styleNames, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps, withoutArticle };
+export { AGENT_UNDO_MAP, BROKEN_CROSS_REFERENCE_STYLE, CHARACTER_STYLES, CROSS_REFERENCE_STYLE, DEFINED_TERM_STYLE, DEFINITIONS_HEADING, DEFINITION_BOOKMARK_PREFIX, FIELD_ATOM, REF_BOOKMARK_PREFIX, SIGNATURE_FIELDS_NAMESPACE, SIGNATURE_FIELD_KINDS, SIGNATURE_FIELD_LABELS, SIGNATURE_FIELD_TAG_PREFIX, TermEverywhereError, WATCHED_STYLES, W_NAMESPACES, addDefinition, applyTermEverywhere, brokenCrossReferences, compareTerms, crossReferenceXml, crossReferences, definitionBookmark, definitionIdOfBookmark, definitionOfAnchor, definitionParagraphText, definitionParagraphXml, definitionTooltip, definitionsById, documentNumbering, documentReader, documentReferenceTooltip, documentStyleIds, documentXml, docxPackage, engineLength, engineOffset, ensureTargetBookmark, esc, fieldNodeIds, filterTargets, findDefinitionsSection, findTermUses, fragmentPackage, headingParagraphXml, hyperlinkRelationship, insertCrossReference, insertCrossReferenceField, insertDefinedTerm, insertDocumentReference, insertionIndex, isDefinitionsTitle, isSignerEmail, listTargets, markCrossReferenceTarget, newRefBookmark, newSignatureFieldKey, paragraphIndex, paragraphNumber, paragraphRunsXml, paragraphState, parseDefinition, parseSignatureFieldTag, readDocument, readParagraphs, refFieldXml, refInstruction, refResult, refTooltip, refreshCrossReferences, replaceSpan, sectionStates, signatureFieldControls, signatureFieldLabel, signatureFieldTag, signatureFieldWrite, staleCrossReferences, styleNames, stylesUsed, stylesXml, tableOf, tableState, termKey, termLinkXml, undoOps, withoutArticle };
 //# sourceMappingURL=commands.js.map
 //# sourceMappingURL=commands.js.map