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

package/dist/superdoc.umd.js

@@ -7752,11 +7752,7 @@
   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 global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
-  function getDefaultExportFromCjs$1$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;
@@ -9523,6 +9519,10 @@
     }
   })(buffer);
   const Buffer2 = buffer.Buffer;
+  var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? 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$2 = { exports: {} };
   var hasRequiredEvents;
@@ -9925,7 +9925,7 @@
     }
     return inherits_browser.exports;
   }
-  function getDefaultExportFromCjs$2(x) {
+  function getDefaultExportFromCjs$1(x) {
     return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
   }
   var browser$1 = { exports: {} };
@@ -10086,7 +10086,7 @@
     return 0;
   };
   var browserExports = browser$1.exports;
-  const process$1$1 = /* @__PURE__ */ getDefaultExportFromCjs$2(browserExports);
+  const process$1$1 = /* @__PURE__ */ getDefaultExportFromCjs$1(browserExports);
   var streamBrowser;
   var hasRequiredStreamBrowser;
   function requireStreamBrowser() {
@@ -19071,7 +19071,7 @@
     return lib;
   }
   var libExports = requireLib();
-  const xmljs = /* @__PURE__ */ getDefaultExportFromCjs$1$1(libExports);
+  const xmljs = /* @__PURE__ */ getDefaultExportFromCjs$2(libExports);
   var getRandomValues$1;
   var rnds8$1 = new Uint8Array(16);
   function rng$1() {
@@ -19106,6 +19106,306 @@
     rnds[8] = rnds[8] & 63 | 128;
     return stringify$1(rnds);
   }
+  function getDefaultExportFromCjs$3(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$3(bufferCrc32);
   function callOrGet(value, context = null, ...props) {
     if (typeof value === "function") {
       if (context) return value.bind(context)(...props);
@@ -22787,18 +23087,6 @@
       }
     ]
   };
-  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",
@@ -25135,15 +25423,15 @@
     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, i2 = depth - 2; d2 > base2; d2--, i2--) {
-      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[i2 + 1];
       if (overrideChild)
         rest = rest.replaceChild(0, overrideChild.type.create(overrideChild.attrs));
       let after = typesAfter && typesAfter[i2] || 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);
@@ -37882,7 +38170,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     return he$2.exports;
   }
   var heExports = requireHe();
-  const he = /* @__PURE__ */ getDefaultExportFromCjs$1$1(heExports);
+  const he = /* @__PURE__ */ getDefaultExportFromCjs$2(heExports);
   function translateFieldAnnotation(params2) {
     const { node, isFinalDoc, fieldsHighlightColor } = params2;
     const { attrs = {} } = node;
@@ -41020,7 +41308,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           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)),
@@ -41028,9 +41316,20 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           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");
@@ -41581,6 +41880,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       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) {
@@ -41628,50 +41930,177 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       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 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 docx;
+      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$1();
+      this.documentModified = true;
+      this.documentHash = null;
+      return this.documentGuid;
     }
     getDocumentDefaultStyles() {
       const styles = this.convertedXml["word/styles.xml"];
@@ -41760,20 +42189,14 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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$1().toUpperCase();
@@ -41862,7 +42285,13 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       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$1();
+        }
+        _SuperConverter2.setStoredCustomProperty(this.convertedXml, "DocumentGuid", this.documentGuid, true);
+      }
       __privateMethod$2(this, _SuperConverter_instances, exportNumberingFile_fn).call(this, params2);
       return xml;
     }
@@ -41897,8 +42326,38 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       });
       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];
@@ -42119,52 +42578,9 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   }));
   __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.');
   }
@@ -44480,7 +44896,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     return jszip_min.exports;
   }
   var jszip_minExports = requireJszip_min();
-  const JSZip = /* @__PURE__ */ getDefaultExportFromCjs$1$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) {
@@ -59240,19 +59656,34 @@ Please report this to https://github.com/markedjs/marked.`, e) {
      * @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.
@@ -59388,6 +59819,43 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       }
       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
@@ -59419,6 +59887,21 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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
@@ -59436,6 +59919,13 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       }
       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.
@@ -59518,7 +60008,8 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         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 = {};
@@ -59534,13 +60025,15 @@ Please report this to https://github.com/markedjs/marked.`, e) {
           ...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(
@@ -60160,6 +60653,13 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     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
@@ -73087,7 +73587,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     }
     return formatList.filter((format) => Object.hasOwn(format, "type") && Object.hasOwn(format, "attrs"));
   };
-  const index$2 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  const index = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
     __proto__: null,
     addMarkStep,
     documentHelpers,
@@ -89793,7 +90293,7 @@ ${style2}
     return eventemitter3$1.exports;
   }
   var eventemitter3Exports$1 = requireEventemitter3$1();
-  const EventEmitter$1 = /* @__PURE__ */ getDefaultExportFromCjs$1$1(eventemitter3Exports$1);
+  const EventEmitter$1 = /* @__PURE__ */ getDefaultExportFromCjs$2(eventemitter3Exports$1);
   const useToolbarItem = (options) => {
     const types2 = ["button", "options", "separator", "dropdown", "overflow"];
     if (!types2.includes(options.type)) {
@@ -94601,306 +95101,6 @@ ${style2}
       delete el.__clickOutsideHandler;
     }
   };
-  function getDefaultExportFromCjs$1(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 (Buffer.isBuffer(input)) {
-      return input;
-    }
-    if (typeof input === "number") {
-      return Buffer.alloc(input);
-    } else if (typeof input === "string") {
-      return Buffer.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 (Buffer.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 = /* @__PURE__ */ getDefaultExportFromCjs$1(bufferCrc32);
   function randomBytes(length2) {
     const array = new Uint8Array(length2);
     for (let i2 = 0; i2 < length2; i2++) {
@@ -94912,7 +95112,9 @@ ${style2}
     /** @type {boolean} */
     enabled;
     /** @type {string} */
-    superdocId;
+    documentGuid;
+    /** @type {string} */
+    documentIdentifier;
     /** @type {string} */
     superdocVersion;
     /** @type {string} */
@@ -94953,7 +95155,8 @@ ${style2}
       this.enabled = config2.enabled ?? true;
       this.licenseKey = config2.licenseKey ?? Telemetry.COMMUNITY_LICENSE_KEY;
       this.endpoint = config2.endpoint ?? Telemetry.DEFAULT_ENDPOINT;
-      this.superdocId = config2.superdocId;
+      this.documentGuid = config2.documentGuid;
+      this.documentIdentifier = config2.documentIdentifier;
       this.superdocVersion = config2.superdocVersion;
       this.sessionId = this.generateId();
     }
@@ -94985,7 +95188,10 @@ ${style2}
         type: "usage",
         timestamp: (/* @__PURE__ */ new Date()).toISOString(),
         sessionId: this.sessionId,
-        superdocId: this.superdocId,
+        documentGuid: this.documentGuid,
+        // Updated field name
+        documentIdentifier: this.documentIdentifier,
+        // Include both
         superdocVersion: this.superdocVersion,
         file: this.documentInfo,
         browser: this.getBrowserInfo(),
@@ -95052,13 +95258,17 @@ ${style2}
      * Track file structure
      * @param {Object} structure - File structure information
      * @param {File} fileSource - original file
-     * @param {String} documentId - document ID
-     * @param {string} internalId - document ID form settings.xml
+     * @param {String} documentId - document GUID
+     * @param {string} documentIdentifier - document identifier (GUID or hash)
+     * @param {string} internalId - document ID from settings.xml
      */
-    async trackFileStructure(structure, fileSource, documentId, internalId) {
+    async trackFileStructure(structure, fileSource, documentId, documentIdentifier, internalId) {
       this.fileStructure = structure;
       this.documentInfo = await this.processDocument(fileSource, {
-        id: documentId,
+        guid: documentId,
+        // Updated parameter name
+        identifier: documentIdentifier,
+        // New parameter
         internalId
       });
     }
@@ -95073,34 +95283,19 @@ ${style2}
         console.warn("Telemetry: missing file source");
         return {};
       }
-      let hash2 = "";
-      try {
-        hash2 = await this.generateCrc32Hash(file);
-      } catch (error) {
-        console.error("Failed to generate file hash:", error);
-      }
       return {
-        id: options.id,
+        guid: options.guid,
+        // Updated from 'id'
+        identifier: options.identifier,
+        // New field
         name: file.name,
         size: file.size,
-        crc32: hash2,
         lastModified: file.lastModified ? new Date(file.lastModified).toISOString() : null,
         type: file.type || "docx",
         internalId: options.internalId
+        // Microsoft's GUID if present
       };
     }
-    /**
-     * Generate CRC32 hash for a file
-     * @param {File} file - File to hash
-     * @returns {Promise<string>} CRC32 hash
-     * @private
-     */
-    async generateCrc32Hash(file) {
-      const arrayBuffer = await file.arrayBuffer();
-      const buffer2 = Buffer.from(arrayBuffer);
-      const hashBuffer = index(buffer2);
-      return hashBuffer.toString("hex");
-    }
     isTelemetryDataChanged() {
       const initialStatistics = {};
       const initialFileStructure = {};
@@ -98103,7 +98298,7 @@ ${reason}`);
       }, 0);
     };
     const createCommentForTrackChanges = (editor) => {
-      let trackedChanges = index$2.getTrackChanges(editor.state);
+      let trackedChanges = index.getTrackChanges(editor.state);
       const groupedChanges = groupChanges(trackedChanges);
       const { tr } = editor.view.state;
       const { dispatch } = editor.view;
@@ -112836,7 +113031,7 @@ ${style2}
   exports2.getRichTextExtensions = getRichTextExtensions;
   exports2.registeredHandlers = registeredHandlers;
   exports2.superEditorHelpers = helpers;
-  exports2.trackChangesHelpers = index$2;
+  exports2.trackChangesHelpers = index;
   Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
 }));
 //# sourceMappingURL=superdoc.umd.js.map