@harbour-enterprises/superdoc 0.23.0-next.14 → 0.23.0-next.15

package/dist/chunks/{super-editor.es-BYutUrPg.cjs → super-editor.es-C7TgrpFl.cjs}

@@ -27,11 +27,7 @@ var __publicField$2 = (obj, key2, value) => __defNormalProp$2(obj, typeof key2 !
 var __accessCheck$2 = (obj, member, msg2) => member.has(obj) || __typeError$2("Cannot " + msg2);
 var __privateAdd$2 = (obj, member, value) => member.has(obj) ? __typeError$2("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 var __privateMethod$2 = (obj, member, method) => (__accessCheck$2(obj, member, "access private method"), method);
-var _a, _DocxExporter_instances, generate_xml_as_list_fn, replaceSpecialCharacters_fn, generateXml_fn, _SuperConverter_instances, exportNumberingFile_fn, prepareCommentsXmlFilesForExport_fn, exportProcessHeadersFooters_fn, exportProcessNewRelationships_fn, exportProcessMediaFiles_fn;
-var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof vue.global !== "undefined" ? vue.global : typeof self !== "undefined" ? self : {};
-function getDefaultExportFromCjs$1(x) {
-  return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
-}
+var _a, _DocxExporter_instances, generate_xml_as_list_fn, replaceSpecialCharacters_fn, generateXml_fn, _SuperConverter_instances, generateDocumentHash_fn, exportNumberingFile_fn, prepareCommentsXmlFilesForExport_fn, exportProcessHeadersFooters_fn, exportProcessNewRelationships_fn, exportProcessMediaFiles_fn;
 var buffer = {};
 var base64Js = {};
 base64Js.byteLength = byteLength;
@@ -1798,6 +1794,10 @@ ieee754.write = function(buffer2, value, offset2, isLE, mLen, nBytes) {
   }
 })(buffer);
 const Buffer2 = buffer.Buffer;
+var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof vue.global !== "undefined" ? vue.global : typeof self !== "undefined" ? self : {};
+function getDefaultExportFromCjs$2(x) {
+  return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
+}
 var sax = {};
 var events$1 = { exports: {} };
 var hasRequiredEvents;
@@ -2200,7 +2200,7 @@ function requireInherits_browser() {
   }
   return inherits_browser.exports;
 }
-function getDefaultExportFromCjs(x) {
+function getDefaultExportFromCjs$1(x) {
   return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
 }
 var browser$1 = { exports: {} };
@@ -2361,7 +2361,7 @@ process$1.umask = function() {
   return 0;
 };
 var browserExports = browser$1.exports;
-const process$1$1 = /* @__PURE__ */ getDefaultExportFromCjs(browserExports);
+const process$1$1 = /* @__PURE__ */ getDefaultExportFromCjs$1(browserExports);
 var streamBrowser;
 var hasRequiredStreamBrowser;
 function requireStreamBrowser() {
@@ -11346,7 +11346,7 @@ function requireLib() {
   return lib;
 }
 var libExports = requireLib();
-const xmljs = /* @__PURE__ */ getDefaultExportFromCjs$1(libExports);
+const xmljs = /* @__PURE__ */ getDefaultExportFromCjs$2(libExports);
 var getRandomValues;
 var rnds8 = new Uint8Array(16);
 function rng() {
@@ -11381,6 +11381,306 @@ function v4(options, buf, offset2) {
   rnds[8] = rnds[8] & 63 | 128;
   return stringify(rnds);
 }
+function getDefaultExportFromCjs(x) {
+  return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
+}
+const CRC_TABLE = new Int32Array([
+  0,
+  1996959894,
+  3993919788,
+  2567524794,
+  124634137,
+  1886057615,
+  3915621685,
+  2657392035,
+  249268274,
+  2044508324,
+  3772115230,
+  2547177864,
+  162941995,
+  2125561021,
+  3887607047,
+  2428444049,
+  498536548,
+  1789927666,
+  4089016648,
+  2227061214,
+  450548861,
+  1843258603,
+  4107580753,
+  2211677639,
+  325883990,
+  1684777152,
+  4251122042,
+  2321926636,
+  335633487,
+  1661365465,
+  4195302755,
+  2366115317,
+  997073096,
+  1281953886,
+  3579855332,
+  2724688242,
+  1006888145,
+  1258607687,
+  3524101629,
+  2768942443,
+  901097722,
+  1119000684,
+  3686517206,
+  2898065728,
+  853044451,
+  1172266101,
+  3705015759,
+  2882616665,
+  651767980,
+  1373503546,
+  3369554304,
+  3218104598,
+  565507253,
+  1454621731,
+  3485111705,
+  3099436303,
+  671266974,
+  1594198024,
+  3322730930,
+  2970347812,
+  795835527,
+  1483230225,
+  3244367275,
+  3060149565,
+  1994146192,
+  31158534,
+  2563907772,
+  4023717930,
+  1907459465,
+  112637215,
+  2680153253,
+  3904427059,
+  2013776290,
+  251722036,
+  2517215374,
+  3775830040,
+  2137656763,
+  141376813,
+  2439277719,
+  3865271297,
+  1802195444,
+  476864866,
+  2238001368,
+  4066508878,
+  1812370925,
+  453092731,
+  2181625025,
+  4111451223,
+  1706088902,
+  314042704,
+  2344532202,
+  4240017532,
+  1658658271,
+  366619977,
+  2362670323,
+  4224994405,
+  1303535960,
+  984961486,
+  2747007092,
+  3569037538,
+  1256170817,
+  1037604311,
+  2765210733,
+  3554079995,
+  1131014506,
+  879679996,
+  2909243462,
+  3663771856,
+  1141124467,
+  855842277,
+  2852801631,
+  3708648649,
+  1342533948,
+  654459306,
+  3188396048,
+  3373015174,
+  1466479909,
+  544179635,
+  3110523913,
+  3462522015,
+  1591671054,
+  702138776,
+  2966460450,
+  3352799412,
+  1504918807,
+  783551873,
+  3082640443,
+  3233442989,
+  3988292384,
+  2596254646,
+  62317068,
+  1957810842,
+  3939845945,
+  2647816111,
+  81470997,
+  1943803523,
+  3814918930,
+  2489596804,
+  225274430,
+  2053790376,
+  3826175755,
+  2466906013,
+  167816743,
+  2097651377,
+  4027552580,
+  2265490386,
+  503444072,
+  1762050814,
+  4150417245,
+  2154129355,
+  426522225,
+  1852507879,
+  4275313526,
+  2312317920,
+  282753626,
+  1742555852,
+  4189708143,
+  2394877945,
+  397917763,
+  1622183637,
+  3604390888,
+  2714866558,
+  953729732,
+  1340076626,
+  3518719985,
+  2797360999,
+  1068828381,
+  1219638859,
+  3624741850,
+  2936675148,
+  906185462,
+  1090812512,
+  3747672003,
+  2825379669,
+  829329135,
+  1181335161,
+  3412177804,
+  3160834842,
+  628085408,
+  1382605366,
+  3423369109,
+  3138078467,
+  570562233,
+  1426400815,
+  3317316542,
+  2998733608,
+  733239954,
+  1555261956,
+  3268935591,
+  3050360625,
+  752459403,
+  1541320221,
+  2607071920,
+  3965973030,
+  1969922972,
+  40735498,
+  2617837225,
+  3943577151,
+  1913087877,
+  83908371,
+  2512341634,
+  3803740692,
+  2075208622,
+  213261112,
+  2463272603,
+  3855990285,
+  2094854071,
+  198958881,
+  2262029012,
+  4057260610,
+  1759359992,
+  534414190,
+  2176718541,
+  4139329115,
+  1873836001,
+  414664567,
+  2282248934,
+  4279200368,
+  1711684554,
+  285281116,
+  2405801727,
+  4167216745,
+  1634467795,
+  376229701,
+  2685067896,
+  3608007406,
+  1308918612,
+  956543938,
+  2808555105,
+  3495958263,
+  1231636301,
+  1047427035,
+  2932959818,
+  3654703836,
+  1088359270,
+  936918e3,
+  2847714899,
+  3736837829,
+  1202900863,
+  817233897,
+  3183342108,
+  3401237130,
+  1404277552,
+  615818150,
+  3134207493,
+  3453421203,
+  1423857449,
+  601450431,
+  3009837614,
+  3294710456,
+  1567103746,
+  711928724,
+  3020668471,
+  3272380065,
+  1510334235,
+  755167117
+]);
+function ensureBuffer(input) {
+  if (Buffer2.isBuffer(input)) {
+    return input;
+  }
+  if (typeof input === "number") {
+    return Buffer2.alloc(input);
+  } else if (typeof input === "string") {
+    return Buffer2.from(input);
+  } else {
+    throw new Error("input must be buffer, number, or string, received " + typeof input);
+  }
+}
+function bufferizeInt(num) {
+  const tmp = ensureBuffer(4);
+  tmp.writeInt32BE(num, 0);
+  return tmp;
+}
+function _crc32(buf, previous) {
+  buf = ensureBuffer(buf);
+  if (Buffer2.isBuffer(previous)) {
+    previous = previous.readUInt32BE(0);
+  }
+  let crc = ~~previous ^ -1;
+  for (var n = 0; n < buf.length; n++) {
+    crc = CRC_TABLE[(crc ^ buf[n]) & 255] ^ crc >>> 8;
+  }
+  return crc ^ -1;
+}
+function crc32() {
+  return bufferizeInt(_crc32.apply(null, arguments));
+}
+crc32.signed = function() {
+  return _crc32.apply(null, arguments);
+};
+crc32.unsigned = function() {
+  return _crc32.apply(null, arguments) >>> 0;
+};
+var bufferCrc32 = crc32;
+const index$2 = /* @__PURE__ */ getDefaultExportFromCjs(bufferCrc32);
 function callOrGet(value, context = null, ...props) {
   if (typeof value === "function") {
     if (context) return value.bind(context)(...props);
@@ -15062,18 +15362,6 @@ const DEFAULT_CUSTOM_XML = {
     }
   ]
 };
-const SETTINGS_CUSTOM_XML = {
-  elements: [
-    {
-      type: "element",
-      name: "w:settings",
-      attributes: {
-        "xmlns:w": "http://schemas.openxmlformats.org/wordprocessingml/2006/main"
-      },
-      elements: []
-    }
-  ]
-};
 const COMMENT_REF = {
   type: "element",
   name: "w:r",
@@ -17410,15 +17698,15 @@ function canSplit(doc2, pos, depth = 1, typesAfter) {
   if (base2 < 0 || $pos.parent.type.spec.isolating || !$pos.parent.canReplace($pos.index(), $pos.parent.childCount) || !innerType.type.validContent($pos.parent.content.cutByIndex($pos.index(), $pos.parent.childCount)))
     return false;
   for (let d2 = $pos.depth - 1, i = depth - 2; d2 > base2; d2--, i--) {
-    let node = $pos.node(d2), index22 = $pos.index(d2);
+    let node = $pos.node(d2), index3 = $pos.index(d2);
     if (node.type.spec.isolating)
       return false;
-    let rest = node.content.cutByIndex(index22, node.childCount);
+    let rest = node.content.cutByIndex(index3, node.childCount);
     let overrideChild = typesAfter && typesAfter[i + 1];
     if (overrideChild)
       rest = rest.replaceChild(0, overrideChild.type.create(overrideChild.attrs));
     let after = typesAfter && typesAfter[i] || node;
-    if (!node.canReplace(index22 + 1, node.childCount) || !after.type.validContent(rest))
+    if (!node.canReplace(index3 + 1, node.childCount) || !after.type.validContent(rest))
       return false;
   }
   let index2 = $pos.indexAfter(base2);
@@ -30157,7 +30445,7 @@ function requireHe() {
   return he$2.exports;
 }
 var heExports = requireHe();
-const he = /* @__PURE__ */ getDefaultExportFromCjs$1(heExports);
+const he = /* @__PURE__ */ getDefaultExportFromCjs$2(heExports);
 function translateFieldAnnotation(params2) {
   const { node, isFinalDoc, fieldsHighlightColor } = params2;
   const { attrs = {} } = node;
@@ -33322,7 +33610,7 @@ const createDocumentJson = (docx, converter, editor) => {
         fileType: filePath.split(".").pop()
       };
     });
-    converter.telemetry.trackFileStructure(
+    const trackStructure = (documentIdentifier = null) => converter.telemetry.trackFileStructure(
       {
         totalFiles: files.length,
         maxDepth: Math.max(...files.map((f) => f.fileDepth)),
@@ -33330,9 +33618,20 @@ const createDocumentJson = (docx, converter, editor) => {
         files
       },
       converter.fileSource,
-      converter.documentId,
+      converter.documentGuid ?? converter.documentId ?? null,
+      documentIdentifier ?? converter.documentId ?? null,
       converter.documentInternalId
     );
+    try {
+      const identifierResult = converter.getDocumentIdentifier?.();
+      if (identifierResult && typeof identifierResult.then === "function") {
+        identifierResult.then(trackStructure).catch(() => trackStructure());
+      } else {
+        trackStructure(identifierResult);
+      }
+    } catch (error) {
+      trackStructure();
+    }
   }
   const nodeListHandler = defaultNodeListHandler();
   const bodyNode = json.elements[0].elements.find((el) => el.name === "w:body");
@@ -33883,6 +34182,9 @@ const _SuperConverter = class _SuperConverter2 {
     this.documentInternalId = null;
     this.fileSource = params2?.fileSource || null;
     this.documentId = params2?.documentId || null;
+    this.documentGuid = null;
+    this.documentHash = null;
+    this.documentModified = false;
     if (this.docx.length || this.xml) this.parseFromXml();
   }
   static getFontTableEntry(docx, fontName) {
@@ -33930,50 +34232,177 @@ const _SuperConverter = class _SuperConverter2 {
     this.initialJSON = this.convertedXml["word/document.xml"];
     if (!this.initialJSON) this.initialJSON = this.parseXmlToJson(this.xml);
     this.declaration = this.initialJSON?.declaration;
+    this.resolveDocumentGuid();
   }
   parseXmlToJson(xml) {
     const newXml = xml.replace(/(<w:t xml:space="preserve">)(\s+)(<\/w:t>)/g, "$1[[sdspace]]$2[[sdspace]]$3");
     return JSON.parse(xmljs.xml2json(newXml, null, 2));
   }
-  static getStoredSuperdocVersion(docx) {
+  /**
+   * Generic method to get a stored custom property from docx
+   * @static
+   * @param {Array} docx - Array of docx file objects
+   * @param {string} propertyName - Name of the property to retrieve
+   * @returns {string|null} The property value or null if not found
+   */
+  static getStoredCustomProperty(docx, propertyName) {
     try {
       const customXml = docx.find((doc2) => doc2.name === "docProps/custom.xml");
-      if (!customXml) return;
+      if (!customXml) return null;
       const converter = new _SuperConverter2();
       const content = customXml.content;
       const contentJson = converter.parseXmlToJson(content);
       const properties = contentJson.elements.find((el) => el.name === "Properties");
-      if (!properties.elements) return;
-      const superdocVersion = properties.elements.find(
-        (el) => el.name === "property" && el.attributes.name === "SuperdocVersion"
-      );
-      if (!superdocVersion) return;
-      const version2 = superdocVersion.elements[0].elements[0].text;
-      return version2;
+      if (!properties.elements) return null;
+      const property2 = properties.elements.find((el) => el.name === "property" && el.attributes.name === propertyName);
+      if (!property2) return null;
+      return property2.elements[0].elements[0].text;
     } catch (e) {
-      console.warn("Error getting Superdoc version", e);
-      return;
+      console.warn(`Error getting custom property ${propertyName}:`, e);
+      return null;
     }
   }
-  static updateDocumentVersion(docx = this.convertedXml, version2 = "0.22.0") {
+  /**
+   * Generic method to set a stored custom property in docx
+   * @static
+   * @param {Object} docx - The docx object to store the property in
+   * @param {string} propertyName - Name of the property
+   * @param {string|Function} value - Value or function that returns the value
+   * @param {boolean} preserveExisting - If true, won't overwrite existing values
+   * @returns {string} The stored value
+   */
+  static setStoredCustomProperty(docx, propertyName, value, preserveExisting = false) {
     const customLocation = "docProps/custom.xml";
-    if (!docx[customLocation]) {
-      docx[customLocation] = generateCustomXml();
-    }
-    const customXml = docx["docProps/custom.xml"];
-    if (!customXml) return;
-    const properties = customXml.elements.find((el) => el.name === "Properties");
+    if (!docx[customLocation]) docx[customLocation] = generateCustomXml();
+    const customXml = docx[customLocation];
+    const properties = customXml.elements?.find((el) => el.name === "Properties");
+    if (!properties) return null;
     if (!properties.elements) properties.elements = [];
-    const superdocVersion = properties.elements.find(
-      (el) => el.name === "property" && el.attributes.name === "SuperdocVersion"
-    );
-    if (!superdocVersion) {
-      const newCustomXml = generateSuperdocVersion();
-      properties.elements.push(newCustomXml);
+    let property2 = properties.elements.find((el) => el.name === "property" && el.attributes.name === propertyName);
+    if (property2 && preserveExisting) {
+      return property2.elements[0].elements[0].text;
+    }
+    const finalValue = typeof value === "function" ? value() : value;
+    if (!property2) {
+      const existingPids = properties.elements.filter((el) => el.attributes?.pid).map((el) => parseInt(el.attributes.pid, 10)).filter(Number.isInteger);
+      const pid = existingPids.length > 0 ? Math.max(...existingPids) + 1 : 2;
+      property2 = {
+        type: "element",
+        name: "property",
+        attributes: {
+          name: propertyName,
+          fmtid: "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}",
+          pid
+        },
+        elements: [
+          {
+            type: "element",
+            name: "vt:lpwstr",
+            elements: [
+              {
+                type: "text",
+                text: finalValue
+              }
+            ]
+          }
+        ]
+      };
+      properties.elements.push(property2);
     } else {
-      superdocVersion.elements[0].elements[0].elements[0].text = version2;
+      property2.elements[0].elements[0].text = finalValue;
     }
-    return docx;
+    return finalValue;
+  }
+  static getStoredSuperdocVersion(docx) {
+    return _SuperConverter2.getStoredCustomProperty(docx, "SuperdocVersion");
+  }
+  static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "0.22.0") {
+    return _SuperConverter2.setStoredCustomProperty(docx, "SuperdocVersion", version2, false);
+  }
+  /**
+   * Get document GUID from docx files (static method)
+   * @static
+   * @param {Array} docx - Array of docx file objects
+   * @returns {string|null} The document GUID
+   */
+  static extractDocumentGuid(docx) {
+    try {
+      const settingsXml = docx.find((doc2) => doc2.name === "word/settings.xml");
+      if (!settingsXml) return null;
+      const converter = new _SuperConverter2();
+      const settingsJson = converter.parseXmlToJson(settingsXml.content);
+      const settings = settingsJson.elements?.[0];
+      if (!settings) return null;
+      const docIdElement = settings.elements?.find((el) => el.name === "w15:docId");
+      if (docIdElement?.attributes?.["w15:val"]) {
+        return docIdElement.attributes["w15:val"].replace(/[{}]/g, "");
+      }
+    } catch {
+    }
+    return _SuperConverter2.getStoredCustomProperty(docx, "DocumentGuid");
+  }
+  /**
+   * Get the permanent document GUID
+   * @returns {string|null} The document GUID (only for modified documents)
+   */
+  getDocumentGuid() {
+    return this.documentGuid;
+  }
+  /**
+   * Get the SuperDoc version for this converter instance
+   * @returns {string|null} The SuperDoc version or null if not available
+   */
+  getSuperdocVersion() {
+    if (this.docx) {
+      return _SuperConverter2.getStoredSuperdocVersion(this.docx);
+    }
+    return null;
+  }
+  /**
+   * Resolve existing document GUID (synchronous)
+   */
+  resolveDocumentGuid() {
+    const microsoftGuid = this.getMicrosoftDocId();
+    if (microsoftGuid) {
+      this.documentGuid = microsoftGuid;
+      return;
+    }
+    const customGuid = _SuperConverter2.getStoredCustomProperty(this.docx, "DocumentGuid");
+    if (customGuid) {
+      this.documentGuid = customGuid;
+    }
+  }
+  /**
+   * Get Microsoft's docId from settings.xml (READ ONLY)
+   */
+  getMicrosoftDocId() {
+    this.getDocumentInternalId();
+    if (this.documentInternalId) {
+      return this.documentInternalId.replace(/[{}]/g, "");
+    }
+    return null;
+  }
+  /**
+   * Get document identifier (GUID or hash) - async for lazy hash generation
+   */
+  async getDocumentIdentifier() {
+    if (this.documentGuid) {
+      return this.documentGuid;
+    }
+    if (!this.documentHash && this.fileSource) {
+      this.documentHash = await __privateMethod$2(this, _SuperConverter_instances, generateDocumentHash_fn).call(this);
+    }
+    return this.documentHash;
+  }
+  /**
+   * Promote from hash to GUID on first edit
+   */
+  promoteToGuid() {
+    if (this.documentGuid) return this.documentGuid;
+    this.documentGuid = this.getMicrosoftDocId() || v4();
+    this.documentModified = true;
+    this.documentHash = null;
+    return this.documentGuid;
   }
   getDocumentDefaultStyles() {
     const styles = this.convertedXml["word/styles.xml"];
@@ -34062,20 +34491,14 @@ const _SuperConverter = class _SuperConverter2 {
   getDocumentInternalId() {
     const settingsLocation = "word/settings.xml";
     if (!this.convertedXml[settingsLocation]) {
-      this.convertedXml[settingsLocation] = SETTINGS_CUSTOM_XML;
+      return;
     }
-    const settings = Object.assign({}, this.convertedXml[settingsLocation]);
-    if (!settings.elements[0]?.elements?.length) {
-      const idElement = this.createDocumentIdElement(settings);
-      settings.elements[0].elements = [idElement];
-      if (!settings.elements[0].attributes["xmlns:w15"]) {
-        settings.elements[0].attributes["xmlns:w15"] = "http://schemas.microsoft.com/office/word/2012/wordml";
-      }
-      this.convertedXml[settingsLocation] = settings;
+    const settings = this.convertedXml[settingsLocation];
+    if (!settings.elements?.[0]?.elements?.length) {
       return;
     }
     const w15DocId = settings.elements[0].elements.find((el) => el.name === "w15:docId");
-    this.documentInternalId = w15DocId?.attributes["w15:val"];
+    this.documentInternalId = w15DocId?.attributes?.["w15:val"];
   }
   createDocumentIdElement() {
     const docId = v4().toUpperCase();
@@ -34164,7 +34587,13 @@ const _SuperConverter = class _SuperConverter2 {
     this.convertedXml = { ...this.convertedXml, ...updatedXml };
     const headFootRels = __privateMethod$2(this, _SuperConverter_instances, exportProcessHeadersFooters_fn).call(this, { isFinalDoc });
     __privateMethod$2(this, _SuperConverter_instances, exportProcessNewRelationships_fn).call(this, [...params2.relationships, ...commentsRels, ...headFootRels]);
-    storeSuperdocVersion(this.convertedXml);
+    _SuperConverter2.setStoredSuperdocVersion(this.convertedXml);
+    if (this.documentModified || this.documentGuid) {
+      if (!this.documentGuid) {
+        this.documentGuid = this.getMicrosoftDocId() || v4();
+      }
+      _SuperConverter2.setStoredCustomProperty(this.convertedXml, "DocumentGuid", this.documentGuid, true);
+    }
     __privateMethod$2(this, _SuperConverter_instances, exportNumberingFile_fn).call(this, params2);
     return xml;
   }
@@ -34199,8 +34628,38 @@ const _SuperConverter = class _SuperConverter2 {
     });
     return { result, params: params2 };
   }
+  // Deprecated methods for backward compatibility
+  static getStoredSuperdocId(docx) {
+    console.warn("getStoredSuperdocId is deprecated, use getDocumentGuid instead");
+    return _SuperConverter2.extractDocumentGuid(docx);
+  }
+  static updateDocumentVersion(docx, version2) {
+    console.warn("updateDocumentVersion is deprecated, use setStoredSuperdocVersion instead");
+    return _SuperConverter2.setStoredSuperdocVersion(docx, version2);
+  }
 };
 _SuperConverter_instances = /* @__PURE__ */ new WeakSet();
+generateDocumentHash_fn = async function() {
+  if (!this.fileSource) return `HASH-${Date.now()}`;
+  try {
+    let buffer2;
+    if (Buffer2.isBuffer(this.fileSource)) {
+      buffer2 = this.fileSource;
+    } else if (this.fileSource instanceof ArrayBuffer) {
+      buffer2 = Buffer2.from(this.fileSource);
+    } else if (this.fileSource instanceof Blob || this.fileSource instanceof File) {
+      const arrayBuffer = await this.fileSource.arrayBuffer();
+      buffer2 = Buffer2.from(arrayBuffer);
+    } else {
+      return `HASH-${Date.now()}`;
+    }
+    const hash2 = index$2(buffer2);
+    return `HASH-${hash2.toString("hex").toUpperCase()}`;
+  } catch (e) {
+    console.warn("Could not generate document hash:", e);
+    return `HASH-${Date.now()}`;
+  }
+};
 exportNumberingFile_fn = function() {
   const numberingPath = "word/numbering.xml";
   let numberingXml = this.convertedXml[numberingPath];
@@ -34421,52 +34880,9 @@ __publicField$2(_SuperConverter, "propertyTypes", Object.freeze({
 }));
 __publicField$2(_SuperConverter, "elements", /* @__PURE__ */ new Set(["w:document", "w:body", "w:p", "w:r", "w:t", "w:delText"]));
 let SuperConverter = _SuperConverter;
-function storeSuperdocVersion(docx) {
-  const customLocation = "docProps/custom.xml";
-  if (!docx[customLocation]) docx[customLocation] = generateCustomXml();
-  const customXml = docx[customLocation];
-  const properties = customXml.elements.find((el) => el.name === "Properties");
-  if (!properties.elements) properties.elements = [];
-  const elements = properties.elements;
-  const cleanProperties = elements.filter((prop) => typeof prop === "object" && prop !== null).filter((prop) => {
-    const { attributes } = prop;
-    return attributes.name !== "SuperdocVersion";
-  });
-  let pid = 2;
-  try {
-    pid = cleanProperties.length ? Math.max(...elements.map((el) => el.attributes.pid)) + 1 : 2;
-  } catch {
-  }
-  cleanProperties.push(generateSuperdocVersion(pid));
-  properties.elements = cleanProperties;
-  return docx;
-}
 function generateCustomXml() {
   return DEFAULT_CUSTOM_XML;
 }
-function generateSuperdocVersion(pid = 2, version2 = "0.22.0") {
-  return {
-    type: "element",
-    name: "property",
-    attributes: {
-      name: "SuperdocVersion",
-      fmtid: "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}",
-      pid
-    },
-    elements: [
-      {
-        type: "element",
-        name: "vt:lpwstr",
-        elements: [
-          {
-            type: "text",
-            text: version2
-          }
-        ]
-      }
-    ]
-  };
-}
 function commonjsRequire(path) {
   throw new Error('Could not dynamically require "' + path + '". Please configure the dynamicRequireTargets or/and ignoreDynamicRequires option of @rollup/plugin-commonjs appropriately for this require call to work.');
 }
@@ -36782,7 +37198,7 @@ function requireJszip_min() {
   return jszip_min.exports;
 }
 var jszip_minExports = requireJszip_min();
-const JSZip = /* @__PURE__ */ getDefaultExportFromCjs$1(jszip_minExports);
+const JSZip = /* @__PURE__ */ getDefaultExportFromCjs$2(jszip_minExports);
 const isXmlLike = (name) => /\.xml$|\.rels$/i.test(name);
 function sniffEncoding(u8) {
   if (u8.length >= 2) {
@@ -51542,19 +51958,34 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
    * @returns {string} Document version
    */
   static getDocumentVersion(doc2) {
-    const version2 = SuperConverter.getStoredSuperdocVersion(doc2);
-    return version2;
+    return SuperConverter.getStoredSuperdocVersion(doc2);
   }
   /**
-   * Update the document version
+   * Set the document version
    * @static
    * @param {Object} doc - Document object
    * @param {string} version - New version
-   * @returns {Object}
+   * @returns {string} The set version
+   */
+  static setDocumentVersion(doc2, version2) {
+    return SuperConverter.setStoredSuperdocVersion(doc2, version2);
+  }
+  /**
+   * Get the document GUID
+   * @static
+   * @param {Object} doc - Document object
+   * @returns {string|null} Document GUID
+   */
+  static getDocumentGuid(doc2) {
+    return SuperConverter.extractDocumentGuid(doc2);
+  }
+  // Deprecated
+  /**
+   * @deprecated use setDocumentVersion instead
    */
   static updateDocumentVersion(doc2, version2) {
-    const updatedContent = SuperConverter.updateDocumentVersion(doc2, version2);
-    return updatedContent;
+    console.warn("updateDocumentVersion is deprecated, use setDocumentVersion instead");
+    return _Editor2.setDocumentVersion(doc2, version2);
   }
   /**
    * Creates all node views.
@@ -51690,6 +52121,43 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
     }
     window.addEventListener("resize", () => handleResize);
   }
+  /**
+   * Get document identifier for telemetry (async - may generate hash)
+   * @returns {Promise<string>} GUID for modified docs, hash for unmodified
+   */
+  async getDocumentIdentifier() {
+    return await this.converter?.getDocumentIdentifier() || null;
+  }
+  /**
+   * Get permanent document GUID (sync - only for modified documents)
+   * @returns {string|null} GUID or null if document hasn't been modified
+   */
+  getDocumentGuid() {
+    return this.converter?.documentGuid || null;
+  }
+  /**
+   * Check if document has been modified
+   * @returns {boolean}
+   */
+  isDocumentModified() {
+    return this.converter?.documentModified || false;
+  }
+  /**
+   * Get telemetry data (async because of lazy hash generation)
+   */
+  async getTelemetryData() {
+    return {
+      documentId: await this.getDocumentIdentifier(),
+      isModified: this.isDocumentModified(),
+      isPermanentId: !!this.converter?.documentGuid,
+      version: this.converter?.getSuperdocVersion()
+    };
+  }
+  // Deprecated for backward compatibility
+  getDocumentId() {
+    console.warn("getDocumentId is deprecated, use getDocumentGuid instead");
+    return this.getDocumentGuid();
+  }
   /**
    * Get attrs of the currently selected node or mark.
    * @param {String} nameOrType
@@ -51721,6 +52189,21 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
   getJSON() {
     return this.state.doc.toJSON();
   }
+  /**
+   * Get document metadata including GUID, modification status, and version
+   * @returns {{
+   *   documentGuid: string | null,
+   *   isModified: boolean,
+   *   version: string | null
+   * }} Document metadata
+   */
+  getMetadata() {
+    return {
+      documentGuid: this.converter?.documentGuid || null,
+      isModified: this.isDocumentModified(),
+      version: this.converter?.getSuperdocVersion() || null
+    };
+  }
   /**
    * Get the editor content as HTML
    * @param {Object} options - Options for the HTML serializer
@@ -51738,6 +52221,13 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
     }
     return html;
   }
+  /**
+   * Get the document version from the converter
+   * @returns {string|null} The SuperDoc version stored in the document
+   */
+  getDocumentVersion() {
+    return this.converter?.getSuperdocVersion() || null;
+  }
   /**
    * Create a child editor linked to this editor.
    * This is useful for creating header/footer editors that are linked to the main editor.
@@ -51820,7 +52310,8 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
       if (exportXmlOnly || exportJsonOnly) return documentXml;
       const customXml = this.converter.schemaToXml(this.converter.convertedXml["docProps/custom.xml"].elements[0]);
       const styles = this.converter.schemaToXml(this.converter.convertedXml["word/styles.xml"].elements[0]);
-      const customSettings = this.converter.schemaToXml(this.converter.convertedXml["word/settings.xml"].elements[0]);
+      const hasCustomSettings = !!this.converter.convertedXml["word/settings.xml"]?.elements?.length;
+      const customSettings = hasCustomSettings ? this.converter.schemaToXml(this.converter.convertedXml["word/settings.xml"]?.elements?.[0]) : null;
       const rels = this.converter.schemaToXml(this.converter.convertedXml["word/_rels/document.xml.rels"].elements[0]);
       const media = this.converter.addedMedia;
       const updatedHeadersFooters = {};
@@ -51836,13 +52327,15 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
         ...this.options.customUpdatedFiles,
         "word/document.xml": String(documentXml),
         "docProps/custom.xml": String(customXml),
-        "word/settings.xml": String(customSettings),
         "word/_rels/document.xml.rels": String(rels),
         "word/numbering.xml": String(numbering),
         // Replace & with &amp; in styles.xml as DOCX viewers can't handle it
         "word/styles.xml": String(styles).replace(/&/gi, "&amp;"),
         ...updatedHeadersFooters
       };
+      if (hasCustomSettings) {
+        updatedDocs["word/settings.xml"] = String(customSettings);
+      }
       if (comments.length) {
         const commentsXml = this.converter.schemaToXml(this.converter.convertedXml["word/comments.xml"].elements[0]);
         const commentsExtendedXml = this.converter.schemaToXml(
@@ -52462,6 +52955,13 @@ dispatchTransaction_fn = function(transaction) {
   if (!transaction.docChanged) {
     return;
   }
+  if (transaction.docChanged && this.converter) {
+    if (!this.converter.documentGuid) {
+      this.converter.promoteToGuid();
+      console.debug("Document modified - assigned GUID:", this.converter.documentGuid);
+    }
+    this.converter.documentModified = true;
+  }
   this.emit("update", {
     editor: this,
     transaction
@@ -82095,7 +82595,7 @@ function requireEventemitter3() {
   return eventemitter3.exports;
 }
 var eventemitter3Exports = requireEventemitter3();
-const EventEmitter2 = /* @__PURE__ */ getDefaultExportFromCjs$1(eventemitter3Exports);
+const EventEmitter2 = /* @__PURE__ */ getDefaultExportFromCjs$2(eventemitter3Exports);
 const useToolbarItem = (options) => {
   const types2 = ["button", "options", "separator", "dropdown", "overflow"];
   if (!types2.includes(options.type)) {