ooxml-core 1.10.0 → 1.11.0

package/dist/visio/ui/index.cjs

@@ -3820,6 +3820,208 @@ function takeDeferredTextSizes(root2) {
   return shapes;
 }
 
+// visio/text-fields.ts
+var PROPERTY_FUNCTIONS = {
+  TITLE: "title",
+  SUBJECT: "subject",
+  CREATOR: "creator",
+  KEYWORDS: "keywords",
+  DESCRIPTION: "description",
+  CATEGORY: "category",
+  COMPANY: "company",
+  MANAGER: "manager"
+};
+var DATE_FUNCTIONS = {
+  NOW: void 0,
+  DOCCREATION: "created",
+  DOCLASTSAVE: "modified",
+  DOCLASTEDIT: "modified",
+  DOCLASTPRINT: "lastPrinted"
+};
+var VISIO_FIELD_FUNCTIONS = [
+  ...Object.keys(PROPERTY_FUNCTIONS),
+  ...Object.keys(DATE_FUNCTIONS),
+  "PAGENAME"
+];
+function visioWallClock(date2) {
+  return new Date(
+    Date.UTC(
+      date2.getFullYear(),
+      date2.getMonth(),
+      date2.getDate(),
+      date2.getHours(),
+      date2.getMinutes(),
+      date2.getSeconds()
+    )
+  );
+}
+var EPOCH = Date.UTC(1899, 11, 30);
+var visioSerialDate = (serial) => Number.isFinite(serial) && Math.abs(serial) < 3e6 ? new Date(EPOCH + Math.round(serial * 864e5)) : void 0;
+function evaluateVisioTextField(formula, context) {
+  let ast;
+  try {
+    ast = parseVisioFormula(formula, { maxLength: 4096 });
+  } catch {
+    return void 0;
+  }
+  if (ast.kind === "call") {
+    const name3 = ast.name;
+    if (Object.hasOwn(PROPERTY_FUNCTIONS, name3) && !ast.args.length) {
+      const value = context.properties?.[PROPERTY_FUNCTIONS[name3]];
+      return value === void 0 ? void 0 : { kind: "string", text: value };
+    }
+    if (Object.hasOwn(DATE_FUNCTIONS, name3) && !ast.args.length) {
+      if (name3 === "NOW") return context.now ? { kind: "date", date: context.now } : void 0;
+      const stamp = context.properties?.[DATE_FUNCTIONS[name3]];
+      const time = stamp ? Date.parse(stamp) : Number.NaN;
+      return Number.isFinite(time) ? { kind: "date", date: visioWallClock(new Date(time)) } : void 0;
+    }
+    if (name3 === "PAGENAME" && ast.args.length <= 1)
+      return context.pageName === void 0 ? void 0 : { kind: "string", text: context.pageName };
+  }
+  try {
+    const result = evaluateVisioFormula(
+      ast,
+      context.resolve ?? (() => {
+        throw new Error("No cell context");
+      }),
+      {
+        ...context.pageNumber === void 0 ? {} : { pageNumber: context.pageNumber },
+        ...context.pageCount === void 0 ? {} : { pageCount: context.pageCount }
+      }
+    );
+    return { kind: "number", value: result.value, unit: result.unit };
+  } catch {
+    return void 0;
+  }
+}
+var MONTHS = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December"
+];
+var DAYS = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+var pad = (value, length = 2) => String(value).padStart(length, "0");
+function dateToken(date2, token) {
+  const hours = date2.getUTCHours();
+  switch (token) {
+    case "yyyy":
+      return pad(date2.getUTCFullYear(), 4);
+    case "yy":
+      return pad(date2.getUTCFullYear() % 100);
+    case "MMMM":
+      return MONTHS[date2.getUTCMonth()];
+    case "MMM":
+      return MONTHS[date2.getUTCMonth()].slice(0, 3);
+    case "MM":
+      return pad(date2.getUTCMonth() + 1);
+    case "M":
+      return String(date2.getUTCMonth() + 1);
+    case "dddd":
+      return DAYS[date2.getUTCDay()];
+    case "ddd":
+      return DAYS[date2.getUTCDay()].slice(0, 3);
+    case "dd":
+      return pad(date2.getUTCDate());
+    case "d":
+      return String(date2.getUTCDate());
+    case "HH":
+      return pad(hours);
+    case "H":
+      return String(hours);
+    case "hh":
+      return pad(hours % 12 || 12);
+    case "h":
+      return String(hours % 12 || 12);
+    case "mm":
+      return pad(date2.getUTCMinutes());
+    case "ss":
+      return pad(date2.getUTCSeconds());
+    case "tt":
+      return hours < 12 ? "AM" : "PM";
+    default:
+      return void 0;
+  }
+}
+function formatDate(date2, picture) {
+  return picture.replace(
+    /yyyy|yy|MMMM|MMM|MM|M|dddd|ddd|dd|d|HH|H|hh|h|mm|ss|tt|"[^"]*"/g,
+    (token) => {
+      if (token.startsWith('"')) return token.slice(1, -1);
+      return dateToken(date2, token) ?? token;
+    }
+  );
+}
+function formatNumber(value, picture) {
+  const match = /^(#,##)?0(?:\.(0+|#+))?$/.exec(picture);
+  if (!match) return void 0;
+  const decimals = match[2]?.length ?? 0;
+  const optional = match[2]?.startsWith("#") ?? false;
+  const [coefficient, exponent = "0"] = Math.abs(value).toString().split("e");
+  const shifted = Number(coefficient + "e" + (Number(exponent) + decimals));
+  const rounded = Math.floor(shifted + 0.5) / 10 ** decimals;
+  let text7 = (Math.sign(value) * rounded).toFixed(decimals);
+  if (optional && text7.includes(".")) text7 = text7.replace(/\.?0+$/, "");
+  if (match[1]) {
+    const [whole, fraction] = text7.split(".");
+    text7 = whole.replace(/\B(?=(\d{3})+(?!\d))/g, ",") + (fraction ? `.${fraction}` : "");
+  }
+  return text7 === "-0" ? "0" : text7;
+}
+var VISIO_FIELD_FORMATS = {
+  shortDate: "{{M/d/yyyy}}",
+  isoDate: "{{yyyy-MM-dd}}",
+  longDate: "{{dddd, MMMM d, yyyy}}",
+  time: "{{h:mm tt}}",
+  dateTime: "{{M/d/yyyy h:mm tt}}",
+  text: "@",
+  integer: "0",
+  decimal: "0.00",
+  decimalUnits: "0.00 u",
+  integerUnits: "0 u"
+};
+function formatVisioFieldValue(value, format4 = "") {
+  const picture = format4.trim();
+  if (value.kind === "string") return picture === "" || picture === "@" ? value.text : void 0;
+  if (value.kind === "date") {
+    const date2 = /^\{\{(.+)\}\}$/.exec(picture)?.[1] ?? (picture ? void 0 : "M/d/yyyy");
+    return date2 === void 0 ? void 0 : formatDate(value.date, date2);
+  }
+  const units2 = / u$/.test(picture);
+  const body = picture.replace(/ u$/, "");
+  let number5 = value.value, suffix = "";
+  if (value.unit === "angle") {
+    number5 = number5 * 180 / Math.PI;
+    suffix = " deg.";
+  } else if (value.unit === "length") suffix = " in.";
+  else if (value.unit !== "scalar") return void 0;
+  const text7 = body === "" || body === "@" ? String(Number(number5.toFixed(4))) : formatNumber(Number(number5.toFixed(10)), body);
+  if (text7 === void 0) return void 0;
+  return units2 || body === "" ? `${text7}${suffix}` : text7;
+}
+
+// visio/text-field-independent.ts
+function independentTextFieldFormula(cell, formula) {
+  const row2 = cell.parentNode, section3 = row2?.parentNode;
+  if (cell.localName !== "Cell" || row2?.localName !== "Row" || section3?.localName !== "Section" || attribute2(section3, "N") !== "Field" || row2.hasAttribute("Del") || section3.hasAttribute("Del") || row2.hasAttribute("N") || row2.hasAttribute("T") || !/^(0|[1-9]\d*)$/.test(attribute2(row2, "IX") ?? "0") || (attribute2(section3, "IX") ?? "0") !== "0" || cell.hasAttribute("E"))
+    return false;
+  if (attribute2(cell, "N") === "Format")
+    return /^\s*FIELDPICTURE\(\s*(2|37|204)\s*\)\s*$/i.test(formula);
+  if (attribute2(cell, "N") !== "Value") return false;
+  if (/^\s*DATE\(\s*\d{1,4}\s*,\s*\d{1,2}\s*,\s*\d{1,2}\s*\)\s*$/i.test(formula)) return true;
+  const direct = /^\s*([A-Z]+)\(\s*\)\s*$/i.exec(formula)?.[1]?.toUpperCase();
+  return direct !== void 0 && VISIO_FIELD_FUNCTIONS.includes(direct);
+}
+
 // visio/edit-connector-glue.ts
 var VISIO_WALK_GLUE = "_WALKGLUE(BegTrigger,EndTrigger,WalkPreference)";
 var walkGlue = /^\s*_WALKGLUE\((?:BegTrigger,EndTrigger|EndTrigger,BegTrigger),WalkPreference\)\s*$/i;
@@ -3929,7 +4131,7 @@ function indexCells(roots2, options) {
           unit: cellUnit(cell, relative)
         };
         const source = attribute2(node2, "F");
-        if (executableCellFormula(source) && !inertDoubleClickFormula(cell, source) && !(glue2 && isNativeGlueCell(cell, source)) && // A trigger only counts events of the sheet it names; an unglued connector keeps one
+        if (executableCellFormula(source) && !independentTextFieldFormula(node2, source) && !inertDoubleClickFormula(cell, source) && !(glue2 && isNativeGlueCell(cell, source)) && // A trigger only counts events of the sheet it names; an unglued connector keeps one
         // (Visio's freshly dropped connector names its own sheet).
         !(/^(BegTrigger|EndTrigger)$/.test(cell) && isNativeGlueCell(cell, source))) {
           try {
@@ -9766,6 +9968,77 @@ async function prepareImages(shapes, pkg, sourcePart, report, options, converter
   }
 }
 
+// visio/text-field-source.ts
+var proofs = /* @__PURE__ */ new WeakMap();
+function textFieldSourceKey(cells4) {
+  if (proofs.has(cells4)) return proofs.get(cells4);
+  if (cells4.size > 64) {
+    proofs.set(cells4, void 0);
+    return void 0;
+  }
+  const key2 = JSON.stringify(
+    [...cells4].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0).map(([name3, cell]) => [
+      name3,
+      cell.value ?? null,
+      cell.formula ?? null,
+      cell.unit ?? null,
+      cell.error ?? null
+    ])
+  );
+  const bounded6 = key2.length <= 2048 ? key2 : void 0;
+  proofs.set(cells4, bounded6);
+  return bounded6;
+}
+
+// visio/text-field-editability.ts
+function assertEditableFieldRow(existing) {
+  for (const name3 of ["Calendar", "ObjectKind"]) {
+    const cell = children2(existing, "Cell").find((cell2) => attribute2(cell2, "N") === name3);
+    if (cell && (attribute2(cell, "V") !== "0" || cell.hasAttribute("F") || cell.hasAttribute("E")))
+      fail(
+        "UNSUPPORTED_TEXT_FIELD",
+        "Nonstandard field calendar or object profiles cannot be edited."
+      );
+  }
+  for (const cell of children2(existing, "Cell")) {
+    const name3 = attribute2(cell, "N") ?? "";
+    if (/^(value|format|type|calendar|objectkind)$/i.test(name3) && !["Value", "Format", "Type", "Calendar", "ObjectKind"].includes(name3))
+      fail("UNSUPPORTED_TEXT_FIELD", "Noncanonical field cell names cannot be edited.");
+    if (["Value", "Format", "Type"].includes(attribute2(cell, "N") ?? "") && (cell.hasAttribute("E") || /^\s*(Inh|GUARD\s*\()/i.test(attribute2(cell, "F") ?? "")))
+      fail("UNSUPPORTED_TEXT_FIELD", "Protected or inherited field cells cannot be edited.");
+  }
+}
+function assertEditableFieldShape(shape) {
+  if (shape.localName !== "Shape" || shape.parentNode?.parentNode?.localName !== "PageContents" || shape.hasAttribute("Master") || shape.hasAttribute("MasterShape") || attribute2(shape, "Type") === "Group" || ["Shapes", "ForeignData", "Rel"].some((name3) => children2(shape, name3).length))
+    fail("UNSUPPORTED_TEXT_FIELD", "Existing field edits require a top-level plain local shape.");
+}
+function editableTextFieldIndices(text7, allowed) {
+  const result = /* @__PURE__ */ new Set();
+  if (!allowed || !text7) return result;
+  const shape = text7.parentNode;
+  try {
+    assertEditableFieldShape(shape);
+    assertFormattingText(shape);
+    const rows = formattingRows(shape, "Field");
+    const markers = children2(text7, "fld");
+    const counts = /* @__PURE__ */ new Map();
+    for (const marker2 of markers) {
+      const index = attribute2(marker2, "IX");
+      counts.set(index, (counts.get(index) ?? 0) + 1);
+    }
+    for (const [index, row2] of rows) {
+      if (counts.get(index) !== 1 || textFieldSourceKey(readCells(row2)) === void 0) continue;
+      try {
+        assertEditableFieldRow(row2);
+        result.add(index);
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return result;
+}
+
 // geometry/svg-path-curves.ts
 function sampleCubic(p0, p1, p2, p3, segments, out) {
   for (let i = 1; i <= segments; i++) {
@@ -12181,195 +12454,6 @@ function visioFieldCase(text7, upper) {
   }).join("");
 }
 
-// visio/text-fields.ts
-var PROPERTY_FUNCTIONS = {
-  TITLE: "title",
-  SUBJECT: "subject",
-  CREATOR: "creator",
-  KEYWORDS: "keywords",
-  DESCRIPTION: "description",
-  CATEGORY: "category",
-  COMPANY: "company",
-  MANAGER: "manager"
-};
-var DATE_FUNCTIONS = {
-  NOW: void 0,
-  DOCCREATION: "created",
-  DOCLASTSAVE: "modified",
-  DOCLASTEDIT: "modified",
-  DOCLASTPRINT: "lastPrinted"
-};
-var VISIO_FIELD_FUNCTIONS = [
-  ...Object.keys(PROPERTY_FUNCTIONS),
-  ...Object.keys(DATE_FUNCTIONS),
-  "PAGENAME"
-];
-function visioWallClock(date2) {
-  return new Date(
-    Date.UTC(
-      date2.getFullYear(),
-      date2.getMonth(),
-      date2.getDate(),
-      date2.getHours(),
-      date2.getMinutes(),
-      date2.getSeconds()
-    )
-  );
-}
-var EPOCH = Date.UTC(1899, 11, 30);
-var visioSerialDate = (serial) => Number.isFinite(serial) && Math.abs(serial) < 3e6 ? new Date(EPOCH + Math.round(serial * 864e5)) : void 0;
-function evaluateVisioTextField(formula, context) {
-  let ast;
-  try {
-    ast = parseVisioFormula(formula, { maxLength: 4096 });
-  } catch {
-    return void 0;
-  }
-  if (ast.kind === "call") {
-    const name3 = ast.name;
-    if (Object.hasOwn(PROPERTY_FUNCTIONS, name3) && !ast.args.length) {
-      const value = context.properties?.[PROPERTY_FUNCTIONS[name3]];
-      return value === void 0 ? void 0 : { kind: "string", text: value };
-    }
-    if (Object.hasOwn(DATE_FUNCTIONS, name3) && !ast.args.length) {
-      if (name3 === "NOW") return context.now ? { kind: "date", date: context.now } : void 0;
-      const stamp = context.properties?.[DATE_FUNCTIONS[name3]];
-      const time = stamp ? Date.parse(stamp) : Number.NaN;
-      return Number.isFinite(time) ? { kind: "date", date: visioWallClock(new Date(time)) } : void 0;
-    }
-    if (name3 === "PAGENAME" && ast.args.length <= 1)
-      return context.pageName === void 0 ? void 0 : { kind: "string", text: context.pageName };
-  }
-  try {
-    const result = evaluateVisioFormula(
-      ast,
-      context.resolve ?? (() => {
-        throw new Error("No cell context");
-      }),
-      {
-        ...context.pageNumber === void 0 ? {} : { pageNumber: context.pageNumber },
-        ...context.pageCount === void 0 ? {} : { pageCount: context.pageCount }
-      }
-    );
-    return { kind: "number", value: result.value, unit: result.unit };
-  } catch {
-    return void 0;
-  }
-}
-var MONTHS = [
-  "January",
-  "February",
-  "March",
-  "April",
-  "May",
-  "June",
-  "July",
-  "August",
-  "September",
-  "October",
-  "November",
-  "December"
-];
-var DAYS = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
-var pad = (value, length = 2) => String(value).padStart(length, "0");
-function dateToken(date2, token) {
-  const hours = date2.getUTCHours();
-  switch (token) {
-    case "yyyy":
-      return pad(date2.getUTCFullYear(), 4);
-    case "yy":
-      return pad(date2.getUTCFullYear() % 100);
-    case "MMMM":
-      return MONTHS[date2.getUTCMonth()];
-    case "MMM":
-      return MONTHS[date2.getUTCMonth()].slice(0, 3);
-    case "MM":
-      return pad(date2.getUTCMonth() + 1);
-    case "M":
-      return String(date2.getUTCMonth() + 1);
-    case "dddd":
-      return DAYS[date2.getUTCDay()];
-    case "ddd":
-      return DAYS[date2.getUTCDay()].slice(0, 3);
-    case "dd":
-      return pad(date2.getUTCDate());
-    case "d":
-      return String(date2.getUTCDate());
-    case "HH":
-      return pad(hours);
-    case "H":
-      return String(hours);
-    case "hh":
-      return pad(hours % 12 || 12);
-    case "h":
-      return String(hours % 12 || 12);
-    case "mm":
-      return pad(date2.getUTCMinutes());
-    case "ss":
-      return pad(date2.getUTCSeconds());
-    case "tt":
-      return hours < 12 ? "AM" : "PM";
-    default:
-      return void 0;
-  }
-}
-function formatDate(date2, picture) {
-  return picture.replace(
-    /yyyy|yy|MMMM|MMM|MM|M|dddd|ddd|dd|d|HH|H|hh|h|mm|ss|tt|"[^"]*"/g,
-    (token) => {
-      if (token.startsWith('"')) return token.slice(1, -1);
-      return dateToken(date2, token) ?? token;
-    }
-  );
-}
-function formatNumber(value, picture) {
-  const match = /^(#,##)?0(?:\.(0+|#+))?$/.exec(picture);
-  if (!match) return void 0;
-  const decimals = match[2]?.length ?? 0;
-  const optional = match[2]?.startsWith("#") ?? false;
-  const [coefficient, exponent = "0"] = Math.abs(value).toString().split("e");
-  const shifted = Number(coefficient + "e" + (Number(exponent) + decimals));
-  const rounded = Math.floor(shifted + 0.5) / 10 ** decimals;
-  let text7 = (Math.sign(value) * rounded).toFixed(decimals);
-  if (optional && text7.includes(".")) text7 = text7.replace(/\.?0+$/, "");
-  if (match[1]) {
-    const [whole, fraction] = text7.split(".");
-    text7 = whole.replace(/\B(?=(\d{3})+(?!\d))/g, ",") + (fraction ? `.${fraction}` : "");
-  }
-  return text7 === "-0" ? "0" : text7;
-}
-var VISIO_FIELD_FORMATS = {
-  shortDate: "{{M/d/yyyy}}",
-  isoDate: "{{yyyy-MM-dd}}",
-  longDate: "{{dddd, MMMM d, yyyy}}",
-  time: "{{h:mm tt}}",
-  dateTime: "{{M/d/yyyy h:mm tt}}",
-  text: "@",
-  integer: "0",
-  decimal: "0.00",
-  decimalUnits: "0.00 u",
-  integerUnits: "0 u"
-};
-function formatVisioFieldValue(value, format4 = "") {
-  const picture = format4.trim();
-  if (value.kind === "string") return picture === "" || picture === "@" ? value.text : void 0;
-  if (value.kind === "date") {
-    const date2 = /^\{\{(.+)\}\}$/.exec(picture)?.[1] ?? (picture ? void 0 : "M/d/yyyy");
-    return date2 === void 0 ? void 0 : formatDate(value.date, date2);
-  }
-  const units2 = / u$/.test(picture);
-  const body = picture.replace(/ u$/, "");
-  let number5 = value.value, suffix = "";
-  if (value.unit === "angle") {
-    number5 = number5 * 180 / Math.PI;
-    suffix = " deg.";
-  } else if (value.unit === "length") suffix = " in.";
-  else if (value.unit !== "scalar") return void 0;
-  const text7 = body === "" || body === "@" ? String(Number(number5.toFixed(4))) : formatNumber(Number(number5.toFixed(10)), body);
-  if (text7 === void 0) return void 0;
-  return units2 || body === "" ? `${text7}${suffix}` : text7;
-}
-
 // visio/text-field-fraction.ts
 function fractionalFieldNumber(value, maxDenominator) {
   if (!Number.isFinite(value) || Math.abs(value) > 1e15) return void 0;
@@ -12526,7 +12610,12 @@ function textFieldDisplay(element2, sheet, context) {
   const row2 = sectionRows(sheet, "Field").find((candidate) => candidate.index === index);
   const value = row2?.cells.get("Value"), format4 = row2?.cells.get("Format");
   const formula = value?.formula && value.formula !== "Inh" ? value.formula : void 0;
-  const result = { cached: cached5, ...formula ? { formula } : {} };
+  const sourceKey = row2 ? textFieldSourceKey(row2.cells) : void 0;
+  const result = {
+    cached: cached5,
+    ...formula ? { formula } : {},
+    ...sourceKey !== void 0 ? { index, format: format4?.value ?? "", sourceKey } : {}
+  };
   if (!row2 || !context) return { text: cached5, ...result };
   const picture = format4?.value ?? "";
   const evaluated = formula ? evaluateVisioTextField(formula, context) : void 0;
@@ -13311,7 +13400,8 @@ function runStyle(cells4, resources, report, themeCells) {
     ...characterExtras(cells4, report)
   };
 }
-function shapeText(sheet, node2, width, height, resources, report, consume, consumeParagraph) {
+function shapeText(sheet, node2, width, height, resources, report, consume, consumeParagraph, allowFieldEditing = false) {
+  const editableFields = editableTextFieldIndices(node2, allowFieldEditing);
   const cells4 = sheet.cells;
   const characters = new Map(sectionRows(sheet, "Character").map((row2) => [row2.index, row2.cells]));
   const defaultCells = characters.get("0") ?? /* @__PURE__ */ new Map();
@@ -13346,7 +13436,9 @@ function shapeText(sheet, node2, width, height, resources, report, consume, cons
             start: textOffset,
             end: textOffset + field3.text.length,
             cached: field3.cached,
-            ...field3.formula ? { formula: field3.formula } : {}
+            ...field3.index !== void 0 && editableFields.has(field3.index) ? { editable: true } : {},
+            ...field3.formula ? { formula: field3.formula } : {},
+            ...field3.index === void 0 ? {} : { index: field3.index, format: field3.format, sourceKey: field3.sourceKey }
           });
           append(field3.text);
         } else if (element2.localName !== "pp" && element2.localName !== "tp") {
@@ -14387,7 +14479,8 @@ function normalizeShapes(raw, context, depth = 0, masterStack = []) {
         context.resources,
         report,
         context.consumeText,
-        context.consumeParagraph
+        context.consumeParagraph,
+        depth === 0 && masterId === void 0 && !sheet.cells.get("LockTextEdit")?.error && !sheet.cells.get("LockTextEdit")?.formula && number(sheet.cells, "LockTextEdit", 0, report) === 0
       ),
       hidden: membership.hidden || type === "Guide" || number(sheet.cells, "NoShow", 0, report) !== 0,
       visibility: {
@@ -16107,6 +16200,35 @@ function snapshotGuideEdit(edit) {
 }
 
 // visio/edit-text-field-commands.ts
+function snapshotTextFieldUpdate(edit) {
+  const insert = snapshotTextFieldInsert({
+    pageId: edit.pageId,
+    shapeId: edit.shapeId,
+    formula: edit.formula,
+    ...edit.format === void 0 ? {} : { format: edit.format }
+  });
+  if (analyzeVisioFormula(parseVisioFormula(insert.formula)).references.some(
+    (ref) => /^fields?\./i.test(ref.cell)
+  ))
+    fail("UNSUPPORTED_TEXT_FIELD", "Existing field formulas cannot reference Field rows.");
+  if (typeof edit.fieldIndex !== "string" || !/^(0|[1-9]\d{0,9})$/.test(edit.fieldIndex) || Number(edit.fieldIndex) > 4294967295)
+    fail("INVALID_EDIT", "An existing field needs a canonical row index.");
+  if ([edit.expectedText, edit.expectedCached, edit.expectedSourceKey].some(
+    (value) => typeof value !== "string" || value.length > 1e6
+  ) || !edit.expectedSourceKey)
+    fail("INVALID_EDIT", "An existing field needs its source text and row identity.");
+  return {
+    type: "update-text-field",
+    pageId: insert.pageId,
+    shapeId: insert.shapeId,
+    fieldIndex: edit.fieldIndex,
+    formula: insert.formula,
+    format: insert.format,
+    expectedText: edit.expectedText,
+    expectedCached: edit.expectedCached,
+    expectedSourceKey: edit.expectedSourceKey
+  };
+}
 function snapshotTextFieldInsert(edit) {
   const { pageId: pageId2, shapeId: shapeId2 } = edit;
   if ([pageId2, shapeId2].some((id3) => typeof id3 !== "string" || !id3 || id3.length > 256))
@@ -16841,6 +16963,14 @@ function snapshotVisioEdits(edits, maxEdits, maxText) {
       return { ...target2, type: edit.type, text: text7(edit.text) };
     if (edit.type === "replace-text-ranges") return snapshotTextRanges(edit, text7);
     if (edit.type === "insert-text-field") return snapshotTextFieldInsert(edit);
+    if (edit.type === "update-text-field") {
+      const update = snapshotTextFieldUpdate(edit);
+      update.formula = text7(update.formula);
+      update.expectedText = text7(update.expectedText);
+      update.expectedCached = text7(update.expectedCached);
+      update.expectedSourceKey = text7(update.expectedSourceKey);
+      return update;
+    }
     if (isVisioFormatEdit(edit)) return snapshotFormatting(edit);
     if (edit.type === "reorder-shape") {
       if (!["front", "back", "forward", "backward"].includes(edit.order))
@@ -17048,6 +17178,8 @@ function snapshotEdits(edits) {
         return snapshotTextRanges(command2, text7);
       case "insert-text-field":
         return snapshotTextFieldInsert(command2);
+      case "update-text-field":
+        return snapshotTextFieldUpdate(command2);
       case "delete-shape":
         return { type: command2.type, ...target2 };
       case "rotate-shape":
@@ -17693,6 +17825,7 @@ async function assertFormattingDependencies(pkg, pagePaths, roots2, pageId2, sha
         continue;
       const source = executableCellFormula(attribute2(node2, "F"));
       if (!source || inertDoubleClickFormula(attribute2(node2, "N") ?? "", source)) continue;
+      if (independentTextFieldFormula(node2, source)) continue;
       if (attribute2(node2, "V") === "Themed" && isThemeLookupFormula(source)) continue;
       if (isConnectedGlueCell(node2, source)) continue;
       const owner = node2.parentNode;
@@ -21502,9 +21635,23 @@ async function insertVisioTextField(pkg, pagePaths, roots2, document, edit, chec
       effectiveFormattingRows(shape, document, "Paragraph")
     );
   const rows = formattingRows(shape, "Field");
-  const point2 = insertionPoint(text7, edit.offset);
-  if (edit.offset !== void 0 && point2.logical !== edit.expectedText)
+  const updating = edit.type === "update-text-field";
+  if (updating) assertEditableFieldShape(shape);
+  const point2 = insertionPoint(text7, updating ? void 0 : edit.offset);
+  if ((updating || edit.offset !== void 0) && point2.logical !== edit.expectedText)
     fail("EDIT_STALE_TEXT", "The shape text changed since the field position was chosen.");
+  const existing = updating ? rows.get(edit.fieldIndex) : void 0;
+  const markers = updating ? children2(text7, "fld").filter((field4) => attribute2(field4, "IX") === edit.fieldIndex) : [];
+  if (updating) {
+    if (!existing || markers.length !== 1)
+      fail(
+        "UNSUPPORTED_TEXT_FIELD",
+        "Existing fields require one live local row and unique text marker."
+      );
+    if (markers[0].textContent !== edit.expectedCached || textFieldSourceKey(readCells(existing)) !== edit.expectedSourceKey)
+      fail("EDIT_STALE_TEXT", "The field source changed since it was selected.");
+    assertEditableFieldRow(existing);
+  }
   const context = { ...await pageContext(pkg, edit.pageId), resolve: shapeResolver(shape) };
   let value;
   try {
@@ -21517,9 +21664,19 @@ async function insertVisioTextField(pkg, pagePaths, roots2, document, edit, chec
       "UNSUPPORTED_TEXT_FIELD",
       `This editor cannot evaluate the field formula. Supported: ${VISIO_FIELD_FUNCTIONS.join(", ")}, PAGENUMBER, PAGECOUNT and numeric formulas on this shape.`
     );
-  const display = formatVisioFieldValue(value, edit.format ?? "");
+  const format4 = edit.format ?? "";
+  const display = formatVisioFieldValue(value, format4);
   if (display === void 0)
     fail("UNSUPPORTED_TEXT_FIELD", "The field format does not suit the field value.");
+  const prepared = valueCell(value);
+  if (existing && markers[0].textContent === display) {
+    const same5 = (name3, v, u, f) => {
+      const cell2 = children2(existing, "Cell").find((cell3) => attribute2(cell3, "N") === name3);
+      return attribute2(cell2, "V") === v && attribute2(cell2, "U") === u && attribute2(cell2, "F") === f;
+    };
+    if (same5("Value", prepared.v, prepared.u, edit.formula) && same5("Format", format4, "STR", `"${format4.replaceAll('"', '""')}"`) && same5("Type", String(prepared.type), void 0, void 0))
+      return false;
+  }
   if (texts[0])
     await assertFormattingDependencies(
       pkg,
@@ -21527,32 +21684,49 @@ async function insertVisioTextField(pkg, pagePaths, roots2, document, edit, chec
       roots2,
       edit.pageId,
       shape,
-      /* @__PURE__ */ new Map([["TheText", text7]]),
+      new Map([
+        ["TheText", text7],
+        ...existing ? ["Value", "Format", "Type"].flatMap((name3) => {
+          const cell2 = children2(existing, "Cell").find((cell3) => attribute2(cell3, "N") === name3);
+          return [
+            [`Field.${updating ? edit.fieldIndex : ""}.${name3}`, cell2],
+            [`Fields.${name3}`, cell2]
+          ];
+        }) : []
+      ]),
       check
     );
   check();
-  const index = String(rows.size ? Math.max(...[...rows.keys()].map(Number)) + 1 : 0);
+  const index = updating ? edit.fieldIndex : String(rows.size ? Math.max(...[...rows.keys()].map(Number)) + 1 : 0);
   let section3 = children2(shape, "Section").find((node2) => attribute2(node2, "N") === "Field");
   if (!section3) {
     section3 = owner.createElementNS(ns, "Section");
     section3.setAttribute("N", "Field");
     shape.insertBefore(section3, texts[0] ?? null);
   }
-  const row2 = owner.createElementNS(ns, "Row");
-  row2.setAttribute("IX", index);
+  const row2 = existing ?? owner.createElementNS(ns, "Row");
+  if (!existing) row2.setAttribute("IX", index);
   const cell = (name3, v, extra = {}) => {
-    const node2 = owner.createElementNS(ns, "Cell");
+    const node2 = children2(row2, "Cell").find((cell2) => attribute2(cell2, "N") === name3) ?? owner.createElementNS(ns, "Cell");
     node2.setAttribute("N", name3);
     node2.setAttribute("V", v);
+    if (updating) {
+      node2.removeAttribute("U");
+      node2.removeAttribute("F");
+    }
     for (const [key2, item] of Object.entries(extra)) node2.setAttribute(key2, item);
-    row2.appendChild(node2);
+    if (!node2.parentNode) row2.appendChild(node2);
   };
-  const stored = valueCell(value);
+  const stored = prepared;
   cell("Value", stored.v, { ...stored.u ? { U: stored.u } : {}, F: edit.formula });
-  if (edit.format)
-    cell("Format", edit.format, { U: "STR", F: `"${edit.format.replaceAll('"', '""')}"` });
+  if (format4 || updating)
+    cell("Format", format4, { U: "STR", F: `"${format4.replaceAll('"', '""')}"` });
   cell("Type", String(stored.type));
-  section3.appendChild(row2);
+  if (!row2.parentNode) section3.appendChild(row2);
+  if (updating) {
+    markers[0].textContent = display;
+    return true;
+  }
   const field3 = owner.createElementNS(ns, "fld");
   field3.setAttribute("IX", index);
   field3.appendChild(owner.createTextNode(display));
@@ -26904,7 +27078,7 @@ async function editVsdxTransaction(input, edits, options, clock = {
   const dirty = /* @__PURE__ */ new Map();
   const roots2 = /* @__PURE__ */ new Map();
   const geometryCommands = commands.filter(
-    (command2) => command2.type !== "replace-plain-text" && command2.type !== "replace-text-ranges" && command2.type !== "insert-text-field" && command2.type !== "reorder-shape" && command2.type !== "duplicate-shapes" && command2.type !== "paste-shapes" && command2.type !== "change-shape" && command2.type !== "insert-picture" && command2.type !== "set-page-theme" && !isVisioMetadataEdit(command2) && command2.type !== "set-shape-data" && !isVisioGroupEdit(command2) && !isVisioDiagramPartEdit(command2) && !isVisioGuideEdit(command2) && !isVisioFormatEdit(command2)
+    (command2) => command2.type !== "replace-plain-text" && command2.type !== "replace-text-ranges" && command2.type !== "insert-text-field" && command2.type !== "update-text-field" && command2.type !== "reorder-shape" && command2.type !== "duplicate-shapes" && command2.type !== "paste-shapes" && command2.type !== "change-shape" && command2.type !== "insert-picture" && command2.type !== "set-page-theme" && !isVisioMetadataEdit(command2) && command2.type !== "set-shape-data" && !isVisioGroupEdit(command2) && !isVisioDiagramPartEdit(command2) && !isVisioGuideEdit(command2) && !isVisioFormatEdit(command2)
   );
   let document;
   let masterMovePins = emptyMasterMoveProof();
@@ -26912,7 +27086,7 @@ async function editVsdxTransaction(input, edits, options, clock = {
   let instanceDeletes = /* @__PURE__ */ new Set();
   let groupMembers = /* @__PURE__ */ new Map();
   if (geometryCommands.length || commands.some(
-    (command2) => command2.type === "replace-plain-text" || command2.type === "replace-text-ranges" || command2.type === "insert-text-field" || isVisioFormatEdit(command2) || isVisioMetadataEdit(command2) || command2.type === "set-shape-data" || command2.type === "reorder-shape" || command2.type === "duplicate-shapes" || command2.type === "paste-shapes" || command2.type === "change-shape" || isVisioGroupEdit(command2) || isVisioDiagramPartEdit(command2) || isVisioGuideEdit(command2)
+    (command2) => command2.type === "replace-plain-text" || command2.type === "replace-text-ranges" || command2.type === "insert-text-field" || command2.type === "update-text-field" || isVisioFormatEdit(command2) || isVisioMetadataEdit(command2) || command2.type === "set-shape-data" || command2.type === "reorder-shape" || command2.type === "duplicate-shapes" || command2.type === "paste-shapes" || command2.type === "change-shape" || isVisioGroupEdit(command2) || isVisioDiagramPartEdit(command2) || isVisioGuideEdit(command2)
   )) {
     for (const [pageId2, path2] of pages) {
       const sourceRoot = await visioXml(pkg, path2, "PageContents");
@@ -27023,7 +27197,7 @@ async function editVsdxTransaction(input, edits, options, clock = {
         textChanged = true;
         await noteTextSize(command2, root2);
       }
-    } else if (command2.type === "insert-text-field") {
+    } else if (command2.type === "insert-text-field" || command2.type === "update-text-field") {
       if (await insertVisioTextField(pkg, new Set(pages.values()), roots2, document, command2, check)) {
         dirty.set(path, root2);
         textChanged = true;
@@ -28214,7 +28388,16 @@ function copySnapshotScene(model) {
         source.fields,
         "text fields",
         1e4,
-        (field3) => fields(field3, ["start", "end", "cached", "formula"])
+        (field3) => fields(field3, [
+          "start",
+          "end",
+          "cached",
+          "formula",
+          "index",
+          "format",
+          "sourceKey",
+          "editable"
+        ])
       )
     },
     runs: list2(source.runs, "text runs", 1e5, (run) => ({