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

package/dist/super-editor/chunks/{docx-zipper-DraPR30Z.js → docx-zipper-DA00N7eN.js}

@@ -1,4 +1,4 @@
-import { p as process$1, aw as commonjsGlobal, B as Buffer, ax as getDefaultExportFromCjs, ay as getContentTypesFromXml, az as xmljs } from "./converter-DD7uNz2k.js";
+import { p as process$1, aw as commonjsGlobal, B as Buffer, ax as getDefaultExportFromCjs, ay as getContentTypesFromXml, az as xmljs } from "./converter-vEmAnrOg.js";
 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.');
 }

package/dist/super-editor/chunks/{editor-xzhKWRFZ.js → editor-CVzagv2Y.js}

@@ -12,9 +12,9 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
 var _Attribute_static, getGlobalAttributes_fn, getNodeAndMarksAttributes_fn, _Schema_static, createNodesSchema_fn, createMarksSchema_fn, _events, _ExtensionService_instances, setupExtensions_fn, attachEditorEvents_fn, _editor, _stateValidators, _xmlValidators, _requiredNodeTypes, _requiredMarkTypes, _SuperValidator_instances, initializeValidators_fn, collectValidatorRequirements_fn, analyzeDocument_fn, _commandService, _Editor_instances, initContainerElement_fn, init_fn, initRichText_fn, onFocus_fn, checkHeadless_fn, registerCopyHandler_fn, insertNewFileData_fn, registerPluginByNameIfNotExists_fn, createExtensionService_fn, createCommandService_fn, createConverter_fn, initMedia_fn, initFonts_fn, createSchema_fn, generatePmData_fn, createView_fn, onCollaborationReady_fn, initComments_fn, initPagination_fn, dispatchTransaction_fn, handleNodeSelection_fn, prepareDocumentForImport_fn, prepareDocumentForExport_fn, endCollaboration_fn, validateDocumentInit_fn, validateDocumentExport_fn, initDevTools_fn, _DocumentSectionView_instances, init_fn2, addToolTip_fn, _ListItemNodeView_instances, init_fn3, _FieldAnnotationView_instances, createAnnotation_fn, _AutoPageNumberNodeView_instances, renderDom_fn, scheduleUpdateNodeStyle_fn;
 import * as Y from "yjs";
 import { UndoManager, Item as Item$1, ContentType, Text as Text$1, XmlElement, encodeStateAsUpdate } from "yjs";
-import { P as PluginKey, a as Plugin, M as Mapping, N as NodeSelection, S as Selection, T as TextSelection, b as Slice, D as DOMSerializer, F as Fragment, c as DOMParser$1, d as Mark$1, e as dropPoint, A as AllSelection, p as process$1, B as Buffer2, f as callOrGet, g as getExtensionConfigField, h as getMarkType, i as getMarksFromSelection, j as getNodeType, k as getSchemaTypeNameByName, l as Schema$1, m as cleanSchemaItem, n as canSplit, o as defaultBlockAt$1, q as liftTarget, r as canJoin, s as joinPoint, t as replaceStep$1, R as ReplaceAroundStep$1, u as isTextSelection, v as getMarkRange, w as isMarkActive, x as isNodeActive, y as deleteProps, z as processContent, C as ReplaceStep, E as NodeRange, G as findWrapping, L as ListHelpers, H as findParentNode, I as isMacOS, J as isIOS, K as getSchemaTypeByName, O as inputRulesPlugin, Q as TrackDeleteMarkName, U as TrackInsertMarkName, V as v4, W as TrackFormatMarkName, X as comments_module_events, Y as findMark, Z as objectIncludes, _ as AddMarkStep, $ as RemoveMarkStep, a0 as twipsToLines, a1 as pixelsToTwips, a2 as helpers, a3 as posToDOMRect, a4 as CommandService, a5 as SuperConverter, a6 as createDocument, a7 as createDocFromMarkdown, a8 as createDocFromHTML, a9 as EditorState, aa as hasSomeParentWithClass, ab as isActive, ac as unflattenListsInHtml, ad as parseSizeUnit, ae as minMax, af as getLineHeightValueString, ag as updateDOMAttributes, ah as findChildren$5, ai as htmlHandler, aj as generateRandomSigned32BitIntStrId, ak as InputRule, al as kebabCase, am as findParentNodeClosestToPos, an as getListItemStyleDefinitions, ao as docxNumberigHelpers, ap as parseIndentElement, aq as combineIndents, ar as SelectionRange, as as Transform, at as isInTable$1, au as generateDocxRandomId, av as insertNewRelationship } from "./converter-DD7uNz2k.js";
+import { P as PluginKey, a as Plugin, M as Mapping, N as NodeSelection, S as Selection, T as TextSelection, b as Slice, D as DOMSerializer, F as Fragment, c as DOMParser$1, d as Mark$1, e as dropPoint, A as AllSelection, p as process$1, B as Buffer2, f as callOrGet, g as getExtensionConfigField, h as getMarkType, i as getMarksFromSelection, j as getNodeType, k as getSchemaTypeNameByName, l as Schema$1, m as cleanSchemaItem, n as canSplit, o as defaultBlockAt$1, q as liftTarget, r as canJoin, s as joinPoint, t as replaceStep$1, R as ReplaceAroundStep$1, u as isTextSelection, v as getMarkRange, w as isMarkActive, x as isNodeActive, y as deleteProps, z as processContent, C as ReplaceStep, E as NodeRange, G as findWrapping, L as ListHelpers, H as findParentNode, I as isMacOS, J as isIOS, K as getSchemaTypeByName, O as inputRulesPlugin, Q as TrackDeleteMarkName, U as TrackInsertMarkName, V as v4, W as TrackFormatMarkName, X as comments_module_events, Y as findMark, Z as objectIncludes, _ as AddMarkStep, $ as RemoveMarkStep, a0 as twipsToLines, a1 as pixelsToTwips, a2 as helpers, a3 as posToDOMRect, a4 as CommandService, a5 as SuperConverter, a6 as createDocument, a7 as createDocFromMarkdown, a8 as createDocFromHTML, a9 as EditorState, aa as hasSomeParentWithClass, ab as isActive, ac as unflattenListsInHtml, ad as parseSizeUnit, ae as minMax, af as getLineHeightValueString, ag as updateDOMAttributes, ah as findChildren$5, ai as htmlHandler, aj as generateRandomSigned32BitIntStrId, ak as InputRule, al as kebabCase, am as findParentNodeClosestToPos, an as getListItemStyleDefinitions, ao as docxNumberigHelpers, ap as parseIndentElement, aq as combineIndents, ar as SelectionRange, as as Transform, at as isInTable$1, au as generateDocxRandomId, av as insertNewRelationship } from "./converter-vEmAnrOg.js";
 import { ref, computed, createElementBlock, openBlock, withModifiers, Fragment as Fragment$1, renderList, normalizeClass, createCommentVNode, toDisplayString, createElementVNode, createApp } from "vue";
-import { D as DocxZipper } from "./docx-zipper-DraPR30Z.js";
+import { D as DocxZipper } from "./docx-zipper-DA00N7eN.js";
 var GOOD_LEAF_SIZE = 200;
 var RopeSequence = function RopeSequence2() {
 };
@@ -9674,15 +9674,39 @@ const toggleList = (listType) => ({ editor, state, tr, dispatch }) => {
   if (near) {
     const isSameAsTarget = nearKind === targetKind;
     if (isSameAsTarget) {
-      const { pos: pos2, node } = near;
-      const spanFromBefore2 = pos2;
-      const spanToBefore2 = pos2 + node.nodeSize;
-      const paras = [];
-      for (let i = 0; i < node.childCount; i++) {
-        const li = node.child(i);
-        paras.push(li.firstChild || editor.schema.nodes.paragraph.create());
-      }
-      tr.replaceWith(pos2, pos2 + node.nodeSize, paras);
+      const candidateLists = collectIntersectingTopLists({ doc: doc2, selection, OrderedType, BulletType });
+      let listsToUnwrap = candidateLists.filter(({ node }) => getEffectiveListKind(node) === targetKind);
+      if (listsToUnwrap.length === 0 && getEffectiveListKind(near.node) === targetKind) {
+        listsToUnwrap = [{ node: near.node, pos: near.pos, depth: near.depth ?? null }];
+      }
+      if (listsToUnwrap.length === 0) return false;
+      let spanFromBefore2 = listsToUnwrap[0].pos;
+      let spanToBefore2 = listsToUnwrap[0].pos + listsToUnwrap[0].node.nodeSize;
+      for (let i = 1; i < listsToUnwrap.length; i++) {
+        const { node, pos: pos2 } = listsToUnwrap[i];
+        spanFromBefore2 = Math.min(spanFromBefore2, pos2);
+        spanToBefore2 = Math.max(spanToBefore2, pos2 + node.nodeSize);
+      }
+      const ParagraphType = editor.schema.nodes.paragraph;
+      listsToUnwrap.sort((a, b) => b.pos - a.pos);
+      for (const { node, pos: pos2 } of listsToUnwrap) {
+        const mappedFrom = tr.mapping.map(pos2, -1);
+        const mappedTo = tr.mapping.map(pos2 + node.nodeSize, 1);
+        const currentListNode = tr.doc.nodeAt(mappedFrom);
+        const sourceListNode = currentListNode && (currentListNode.type === OrderedType || currentListNode.type === BulletType) ? currentListNode : node;
+        const paragraphs = [];
+        for (let i = 0; i < sourceListNode.childCount; i++) {
+          const li = sourceListNode.child(i);
+          if (li.type !== editor.schema.nodes.listItem) continue;
+          const firstChild = li.firstChild;
+          paragraphs.push(firstChild || ParagraphType.create());
+        }
+        if (paragraphs.length === 0) {
+          paragraphs.push(ParagraphType.create());
+        }
+        const replacement = paragraphs.length === 1 ? paragraphs[0] : Fragment.from(paragraphs);
+        tr.replaceWith(mappedFrom, mappedTo, replacement);
+      }
       setMappedSelectionSpan(tr, spanFromBefore2, spanToBefore2);
       if (dispatch) dispatch(tr);
       return true;
@@ -14531,19 +14555,34 @@ const _Editor = class _Editor extends EventEmitter {
    * @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 _Editor.setDocumentVersion(doc2, version2);
   }
   /**
    * Creates all node views.
@@ -14679,6 +14718,43 @@ const _Editor = class _Editor extends EventEmitter {
     }
     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
@@ -14710,6 +14786,21 @@ const _Editor = class _Editor extends EventEmitter {
   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
@@ -14727,6 +14818,13 @@ const _Editor = class _Editor extends EventEmitter {
     }
     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.
@@ -14809,7 +14907,8 @@ const _Editor = class _Editor extends EventEmitter {
       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 = {};
@@ -14825,13 +14924,15 @@ const _Editor = class _Editor extends EventEmitter {
         ...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(
@@ -15542,6 +15643,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

package/dist/super-editor/chunks/{toolbar-D6SJTVWT.js → toolbar-BCJtFyig.js}

@@ -1,6 +1,6 @@
 import { computed, createElementBlock, openBlock, createElementVNode, createCommentVNode, normalizeClass, normalizeStyle, ref, withKeys, unref, withModifiers, createBlock, toDisplayString, withDirectives, vModelText, nextTick, getCurrentInstance, createVNode, readonly, watch, onMounted, onBeforeUnmount, reactive, onBeforeMount, inject, onActivated, onDeactivated, createTextVNode, Fragment, Comment, defineComponent, provide, h, Teleport, toRef, renderSlot, isVNode, shallowRef, watchEffect, mergeProps, Transition, vShow, cloneVNode, Text, renderList, withCtx } from "vue";
-import { p as process$1 } from "./converter-DD7uNz2k.js";
-import { _ as _export_sfc, u as useHighContrastMode, g as global$1 } from "./editor-xzhKWRFZ.js";
+import { p as process$1 } from "./converter-vEmAnrOg.js";
+import { _ as _export_sfc, u as useHighContrastMode, g as global$1 } from "./editor-CVzagv2Y.js";
 const sanitizeNumber = (value, defaultNumber) => {
   let sanitized = value.replace(/[^0-9.]/g, "");
   sanitized = parseFloat(sanitized);

package/dist/super-editor/converter.es.js

@@ -1,4 +1,4 @@
-import { a5 } from "./chunks/converter-DD7uNz2k.js";
+import { a5 } from "./chunks/converter-vEmAnrOg.js";
 import "vue";
 export {
   a5 as SuperConverter

package/dist/super-editor/docx-zipper.es.js

@@ -1,5 +1,5 @@
-import "./chunks/converter-DD7uNz2k.js";
-import { D } from "./chunks/docx-zipper-DraPR30Z.js";
+import "./chunks/converter-vEmAnrOg.js";
+import { D } from "./chunks/docx-zipper-DA00N7eN.js";
 export {
   D as default
 };

package/dist/super-editor/editor.es.js

@@ -1,6 +1,6 @@
-import { E } from "./chunks/editor-xzhKWRFZ.js";
-import "./chunks/converter-DD7uNz2k.js";
-import "./chunks/docx-zipper-DraPR30Z.js";
+import { E } from "./chunks/editor-CVzagv2Y.js";
+import "./chunks/converter-vEmAnrOg.js";
+import "./chunks/docx-zipper-DA00N7eN.js";
 export {
   E as Editor
 };

package/dist/super-editor/file-zipper.es.js

@@ -1,4 +1,4 @@
-import { J as JSZip } from "./chunks/docx-zipper-DraPR30Z.js";
+import { J as JSZip } from "./chunks/docx-zipper-DA00N7eN.js";
 async function createZip(blobs, fileNames) {
   const zip = new JSZip();
   blobs.forEach((blob, index) => {

package/dist/super-editor/src/core/Editor.d.ts

@@ -118,13 +118,24 @@ export class Editor extends EventEmitter {
      */
     static getDocumentVersion(doc: any): string;
     /**
-     * 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 updateDocumentVersion(doc: any, version: string): any;
+    static setDocumentVersion(doc: any, version: string): string;
+    /**
+     * Get the document GUID
+     * @static
+     * @param {Object} doc - Document object
+     * @returns {string|null} Document GUID
+     */
+    static getDocumentGuid(doc: any): string | null;
+    /**
+     * @deprecated use setDocumentVersion instead
+     */
+    static updateDocumentVersion(doc: any, version: any): string;
     /**
      * Check if migrations are needed for the data
      * @static
@@ -381,6 +392,31 @@ export class Editor extends EventEmitter {
      * @returns {void}
      */
     initMobileStyles(element: HTMLElement | void): void;
+    /**
+     * Get document identifier for telemetry (async - may generate hash)
+     * @returns {Promise<string>} GUID for modified docs, hash for unmodified
+     */
+    getDocumentIdentifier(): Promise<string>;
+    /**
+     * Get permanent document GUID (sync - only for modified documents)
+     * @returns {string|null} GUID or null if document hasn't been modified
+     */
+    getDocumentGuid(): string | null;
+    /**
+     * Check if document has been modified
+     * @returns {boolean}
+     */
+    isDocumentModified(): boolean;
+    /**
+     * Get telemetry data (async because of lazy hash generation)
+     */
+    getTelemetryData(): Promise<{
+        documentId: string;
+        isModified: boolean;
+        isPermanentId: boolean;
+        version: any;
+    }>;
+    getDocumentId(): string;
     /**
      * Get attrs of the currently selected node or mark.
      * @param {String} nameOrType
@@ -404,6 +440,19 @@ export class Editor extends EventEmitter {
      * @returns {Object} Editor content as JSON
      */
     getJSON(): any;
+    /**
+     * Get document metadata including GUID, modification status, and version
+     * @returns {{
+     *   documentGuid: string | null,
+     *   isModified: boolean,
+     *   version: string | null
+     * }} Document metadata
+     */
+    getMetadata(): {
+        documentGuid: string | null;
+        isModified: boolean;
+        version: string | null;
+    };
     /**
      * Get the editor content as HTML
      * @param {Object} options - Options for the HTML serializer
@@ -413,6 +462,11 @@ export class Editor extends EventEmitter {
     getHTML({ unflattenLists }?: {
         unflattenLists?: boolean;
     }): string;
+    /**
+     * Get the document version from the converter
+     * @returns {string|null} The SuperDoc version stored in the document
+     */
+    getDocumentVersion(): string | null;
     /**
      * Create a child editor linked to this editor.
      * This is useful for creating header/footer editors that are linked to the main editor.

package/dist/super-editor/src/core/super-converter/SuperConverter.d.ts

@@ -50,8 +50,35 @@ export class SuperConverter {
     static getFontTableEntry(docx: any, fontName: any): any;
     static getFallbackFromFontTable(docx: any, fontName: any): any;
     static toCssFontFamily(fontName: any, docx: any): any;
-    static getStoredSuperdocVersion(docx: any): any;
-    static updateDocumentVersion(docx?: any, version?: any): any;
+    /**
+     * 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: any[], propertyName: string): string | null;
+    /**
+     * 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: any, propertyName: string, value: string | Function, preserveExisting?: boolean): string;
+    static getStoredSuperdocVersion(docx: any): string;
+    static setStoredSuperdocVersion(docx?: any, version?: any): string;
+    /**
+     * 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: any[]): string | null;
+    static getStoredSuperdocId(docx: any): string;
+    static updateDocumentVersion(docx: any, version: any): string;
     constructor(params?: any);
     debug: any;
     declaration: any;
@@ -91,6 +118,9 @@ export class SuperConverter {
     documentInternalId: any;
     fileSource: any;
     documentId: any;
+    documentGuid: any;
+    documentHash: string;
+    documentModified: boolean;
     /**
      * Get the DocxHelpers object that contains utility functions for working with docx files.
      * @returns {import('./docx-helpers/docx-helpers.js').DocxHelpers} The DocxHelpers object.
@@ -98,6 +128,32 @@ export class SuperConverter {
     get docxHelpers(): any;
     parseFromXml(): void;
     parseXmlToJson(xml: any): any;
+    /**
+     * Get the permanent document GUID
+     * @returns {string|null} The document GUID (only for modified documents)
+     */
+    getDocumentGuid(): string | null;
+    /**
+     * Get the SuperDoc version for this converter instance
+     * @returns {string|null} The SuperDoc version or null if not available
+     */
+    getSuperdocVersion(): string | null;
+    /**
+     * Resolve existing document GUID (synchronous)
+     */
+    resolveDocumentGuid(): void;
+    /**
+     * Get Microsoft's docId from settings.xml (READ ONLY)
+     */
+    getMicrosoftDocId(): any;
+    /**
+     * Get document identifier (GUID or hash) - async for lazy hash generation
+     */
+    getDocumentIdentifier(): Promise<any>;
+    /**
+     * Promote from hash to GUID on first edit
+     */
+    promoteToGuid(): any;
     getDocumentDefaultStyles(): {};
     getDocumentFonts(): string;
     getDocumentInternalId(): void;