superdoc 0.33.0 → 0.34.0

package/dist/superdoc.umd.js

@@ -35776,7 +35776,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     static getStoredSuperdocVersion(docx) {
       return _SuperConverter2.getStoredCustomProperty(docx, "SuperdocVersion");
     }
-    static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "0.33.0") {
+    static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "0.34.0") {
       return _SuperConverter2.setStoredCustomProperty(docx, "SuperdocVersion", version2, false);
     }
     /**
@@ -54811,6 +54811,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         code: callOrGet(getExtensionConfigField(extension, "code", context)),
         defining: callOrGet(getExtensionConfigField(extension, "defining", context)),
         isolating: callOrGet(getExtensionConfigField(extension, "isolating", context)),
+        summary: getExtensionConfigField(extension, "summary", context),
         attrs,
         ...additionalNodeFields
       });
@@ -61055,6 +61056,56 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     const lvl = node2.getAttribute("data-level");
     return lvl ? parseInt(lvl, 10) : 0;
   };
+  const summaryVersion = typeof globalThis.__APP_VERSION__ === "string" && globalThis.__APP_VERSION__ || typeof globalThis.version === "string" && globalThis.version || "0.0.0";
+  const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
+  const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
+  function mapAttributes(attrs) {
+    if (!attrs) return {};
+    return Object.fromEntries(
+      Object.entries(attrs).map(([name, attrSpec]) => {
+        const defaultValue = attrSpec?.default;
+        return [
+          name,
+          {
+            default: defaultValue ?? null,
+            required: defaultValue === void 0
+          }
+        ];
+      })
+    );
+  }
+  function pickSpecFields(spec, keys2) {
+    return Object.fromEntries(keys2.map((key2) => [key2, spec[key2]]).filter(([, value]) => value !== void 0));
+  }
+  function buildSchemaSummary(schema, schemaVersion) {
+    if (!schema || typeof schema !== "object") {
+      throw new Error("Invalid schema: schema must be a valid ProseMirror Schema object.");
+    }
+    const resolvedSchemaVersion = schemaVersion || "current";
+    const nodes = [];
+    schema.spec.nodes.forEach((name, spec) => {
+      nodes.push({
+        name,
+        attrs: mapAttributes(spec.attrs),
+        ...pickSpecFields(spec, nodeKeys)
+      });
+    });
+    const marks = [];
+    schema.spec.marks.forEach((name, spec) => {
+      marks.push({
+        name,
+        attrs: mapAttributes(spec.attrs),
+        ...pickSpecFields(spec, markKeys)
+      });
+    });
+    return {
+      version: summaryVersion,
+      schemaVersion: resolvedSchemaVersion,
+      topNode: schema.topNodeType?.name,
+      nodes,
+      marks
+    };
+  }
   const _Editor = class _Editor2 extends EventEmitter$2 {
     /**
      * Create a new Editor instance
@@ -61467,6 +61518,56 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       console.warn("updateDocumentVersion is deprecated, use setDocumentVersion instead");
       return _Editor2.setDocumentVersion(doc2, version2);
     }
+    /**
+     * Generates a schema summary for the current runtime schema.
+     * @returns {Promise<Object>} Schema summary JSON
+     */
+    async getSchemaSummaryJSON() {
+      if (!this.schema) {
+        throw new Error("Schema is not initialized.");
+      }
+      const schemaVersion = this.converter?.getSuperdocVersion?.() || "current";
+      const suppressedNames = new Set(
+        (this.extensionService?.extensions || []).filter((ext) => {
+          const config2 = ext?.config;
+          const suppressFlag = config2?.excludeFromSummaryJSON;
+          return Boolean(suppressFlag);
+        }).map((ext) => ext.name)
+      );
+      const summary = buildSchemaSummary(this.schema, schemaVersion);
+      if (!suppressedNames.size) {
+        return summary;
+      }
+      return {
+        ...summary,
+        nodes: summary.nodes.filter((node2) => !suppressedNames.has(node2.name)),
+        marks: summary.marks.filter((mark2) => !suppressedNames.has(mark2.name))
+      };
+    }
+    /**
+     * Validates a ProseMirror JSON document against the current schema.
+     * @param {Object|Object[]} doc - ProseMirror JSON representation of the document
+     * @returns {Object} ProseMirror node
+     */
+    validateJSON(doc2) {
+      if (!this.schema) {
+        throw new Error("Schema is not initialized.");
+      }
+      const topNodeName = this.schema.topNodeType?.name || "doc";
+      const normalizedDoc = Array.isArray(doc2) ? { type: topNodeName, content: doc2 } : doc2 && typeof doc2 === "object" && doc2.type ? doc2.type === topNodeName || doc2.type === "doc" ? doc2 : { type: topNodeName, content: [doc2] } : (() => {
+        throw new Error("Invalid document shape: expected a node object or an array of node objects.");
+      })();
+      try {
+        return this.schema.nodeFromJSON(normalizedDoc);
+      } catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        const validationError = new Error(`Invalid document for current schema: ${detail}`);
+        if (error instanceof Error) {
+          validationError.cause = error;
+        }
+        throw validationError;
+      }
+    }
     /**
      * Creates all node views.
      * @returns {void}
@@ -61715,7 +61816,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         { default: remarkStringify2 },
         { default: remarkGfm2 }
       ] = await Promise.all([
-        Promise.resolve().then(() => indexCIbMY9Bm),
+        Promise.resolve().then(() => indexUvHeMhoE),
         Promise.resolve().then(() => indexDRCvimau),
         Promise.resolve().then(() => indexC_x_N6Uh),
         Promise.resolve().then(() => indexD_sWOSiG),
@@ -61933,7 +62034,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
      * @returns {Object | void} Migration results
      */
     processCollaborationMigrations() {
-      console.debug("[checkVersionMigrations] Current editor version", "0.33.0");
+      console.debug("[checkVersionMigrations] Current editor version", "0.34.0");
       if (!this.options.ydoc) return;
       const metaMap = this.options.ydoc.getMap("meta");
       let docVersion = metaMap.get("version");
@@ -63547,6 +63648,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     name: AiMarkName,
     group: "ai",
     inclusive: false,
+    excludeFromSummaryJSON: true,
     addOptions() {
       return {
         htmlAttributes: { class: "sd-ai-highlight" }
@@ -63573,6 +63675,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     inclusive: false,
     spanning: false,
     excludes: AiAnimationMarkName,
+    excludeFromSummaryJSON: true,
     addOptions() {
       return {
         htmlAttributes: {}
@@ -63604,6 +63707,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   const dotsLoader = "data:image/svg+xml,%3csvg%20fill='hsla(278,%2077.40%25,%2020.80%25,%200.65)'%20viewBox='0%200%2024%2024'%20xmlns='http://www.w3.org/2000/svg'%3e%3ccircle%20cx='4'%20cy='12'%20r='0'%3e%3canimate%20begin='0;spinner_z0Or.end'%20attributeName='r'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='0;3'%20fill='freeze'/%3e%3canimate%20begin='spinner_OLMs.end'%20attributeName='cx'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='4;12'%20fill='freeze'/%3e%3canimate%20begin='spinner_UHR2.end'%20attributeName='cx'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='12;20'%20fill='freeze'/%3e%3canimate%20id='spinner_lo66'%20begin='spinner_Aguh.end'%20attributeName='r'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='3;0'%20fill='freeze'/%3e%3canimate%20id='spinner_z0Or'%20begin='spinner_lo66.end'%20attributeName='cx'%20dur='0.001s'%20values='20;4'%20fill='freeze'/%3e%3c/circle%3e%3ccircle%20cx='4'%20cy='12'%20r='3'%3e%3canimate%20begin='0;spinner_z0Or.end'%20attributeName='cx'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='4;12'%20fill='freeze'/%3e%3canimate%20begin='spinner_OLMs.end'%20attributeName='cx'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='12;20'%20fill='freeze'/%3e%3canimate%20id='spinner_JsnR'%20begin='spinner_UHR2.end'%20attributeName='r'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='3;0'%20fill='freeze'/%3e%3canimate%20id='spinner_Aguh'%20begin='spinner_JsnR.end'%20attributeName='cx'%20dur='0.001s'%20values='20;4'%20fill='freeze'/%3e%3canimate%20begin='spinner_Aguh.end'%20attributeName='r'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='0;3'%20fill='freeze'/%3e%3c/circle%3e%3ccircle%20cx='12'%20cy='12'%20r='3'%3e%3canimate%20begin='0;spinner_z0Or.end'%20attributeName='cx'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='12;20'%20fill='freeze'/%3e%3canimate%20id='spinner_hSjk'%20begin='spinner_OLMs.end'%20attributeName='r'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='3;0'%20fill='freeze'/%3e%3canimate%20id='spinner_UHR2'%20begin='spinner_hSjk.end'%20attributeName='cx'%20dur='0.001s'%20values='20;4'%20fill='freeze'/%3e%3canimate%20begin='spinner_UHR2.end'%20attributeName='r'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='0;3'%20fill='freeze'/%3e%3canimate%20begin='spinner_Aguh.end'%20attributeName='cx'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='4;12'%20fill='freeze'/%3e%3c/circle%3e%3ccircle%20cx='20'%20cy='12'%20r='3'%3e%3canimate%20id='spinner_4v5M'%20begin='0;spinner_z0Or.end'%20attributeName='r'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='3;0'%20fill='freeze'/%3e%3canimate%20id='spinner_OLMs'%20begin='spinner_4v5M.end'%20attributeName='cx'%20dur='0.001s'%20values='20;4'%20fill='freeze'/%3e%3canimate%20begin='spinner_OLMs.end'%20attributeName='r'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='0;3'%20fill='freeze'/%3e%3canimate%20begin='spinner_UHR2.end'%20attributeName='cx'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='4;12'%20fill='freeze'/%3e%3canimate%20begin='spinner_Aguh.end'%20attributeName='cx'%20calcMode='spline'%20dur='0.5s'%20keySplines='.36,.6,.31,1'%20values='12;20'%20fill='freeze'/%3e%3c/circle%3e%3c/svg%3e";
   const AiLoaderNode = Node$1.create({
     name: AiLoaderNodeName,
+    excludeFromSummaryJSON: true,
     group: "inline",
     inline: true,
     atom: true,
@@ -65190,6 +65294,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     group: "block",
     content: "block*",
     isolating: true,
+    excludeFromSummaryJSON: true,
     addOptions() {
       return {
         htmlAttributes: {
@@ -67384,6 +67489,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     group: "block",
     content: "inline*",
     inline: false,
+    summary: "The paragraph node mirrors MS Word w:p paragraphs, and also represents lists in the schema.",
     addOptions() {
       return {
         headingLevels: [1, 2, 3, 4, 5, 6],
@@ -74975,6 +75081,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     group: "inline",
     inline: true,
     selectable: false,
+    excludeFromSummaryJSON: true,
     atom: true,
     addOptions() {
       return {
@@ -118373,7 +118480,7 @@ ${style2}
       this.config.colors = shuffleArray(this.config.colors);
       this.userColorMap = /* @__PURE__ */ new Map();
       this.colorIndex = 0;
-      this.version = "0.33.0";
+      this.version = "0.34.0";
       this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
       this.superdocId = config2.superdocId || v4();
       this.colors = this.config.colors;
@@ -120773,7 +120880,7 @@ ${style2}
       value && typeof value === "object" && "byteLength" in value && "byteOffset" in value
     );
   }
-  const indexCIbMY9Bm = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  const indexUvHeMhoE = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
     __proto__: null,
     unified
   }, Symbol.toStringTag, { value: "Module" }));