superdoc 2.4.0-next.27 → 2.4.0-next.29

package/README.md

@@ -5,15 +5,14 @@
 [![Documentation](https://img.shields.io/badge/docs-available-1355ff.svg)](https://docs.superdoc.dev/)
 [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-1355ff.svg)](https://www.gnu.org/licenses/agpl-3.0)
 [![npm version](https://img.shields.io/npm/v/superdoc.svg?color=1355ff)](https://www.npmjs.com/package/superdoc)
-[![codecov](https://codecov.io/gh/superdoc/docx-editor/branch/main/graph/badge.svg)](https://codecov.io/gh/superdoc/docx-editor)
 [![Discord](https://img.shields.io/badge/discord-join-1355ff)](https://discord.com/invite/b9UuaZRyaB)
 
-SuperDoc renders and edits DOCX files in the browser. Built on OOXML — not bolted onto HTML. As you type, you write directly to the XML. Import a document, edit it, export it. Nothing lost.
+SuperDoc renders and edits DOCX files in the browser. Built on OOXML, not bolted onto HTML. As you type, you write directly to the XML, so edits do not pass through an HTML conversion step.
 
 ## Features
 
-- **Real DOCX, not rich text** — Built on OOXML. Real pagination, section breaks, headers/footers, complex tables. Not a contenteditable wrapper with export bolted on.
-- **Self-hosted** — Runs entirely in the browser. Your documents never leave your servers.
+- **Real DOCX, not rich text** — Built on OOXML. Pagination, section breaks, headers/footers, and complex tables are modeled as themselves, not flattened into HTML. Not a contenteditable wrapper with export bolted on.
+- **Self-hosted** — The editor needs no server of its own. Documents go where your application sends them, and nowhere else by default.
 - **Any framework** — React, Vue, Angular, Svelte, vanilla JS. One component, zero lock-in.
 - **Real-time collaboration** — Yjs-based CRDT. Multiplayer editing with comments, tracked changes, and automatic conflict resolution.
 - **Built for agents** — [SDK](https://www.npmjs.com/package/@superdoc/sdk), [CLI](https://www.npmjs.com/package/@superdoc/cli), and [MCP server](https://www.npmjs.com/package/@superdoc/mcp) let LLMs read, edit, and save .docx files programmatically.
@@ -25,6 +24,13 @@ SuperDoc renders and edits DOCX files in the browser. Built on OOXML — not bol
 npm install superdoc
 ```
 
+SuperDoc mounts into an element you provide, so the page needs it before this
+runs:
+
+```html
+<div id="superdoc"></div>
+```
+
 ```javascript
 import 'superdoc/style.css';
 import { SuperDoc } from 'superdoc';
@@ -32,16 +38,13 @@ import { SuperDoc } from 'superdoc';
 const superdoc = new SuperDoc({
   selector: '#superdoc',
   documentMode: 'editing',
-  documents: [
-    {
-      id: 'my-doc-id',
-      type: 'docx',
-      data: fileObject,
-    },
-  ],
+  document: fileObject,
 });
 ```
 
+`document` accepts a URL, a `File`, or a `Blob`. Omit it to start from a blank
+DOCX. The constructor throws if `selector` matches no element.
+
 Supported document modes are `editing`, `viewing`, and `suggesting`. Do not use `edit`, `view`, or `suggest`.
 
 ### Browser Document API contract
@@ -64,13 +67,7 @@ export function embedSuperDoc({ file }) {
   return new SuperDoc({
     selector: '#editor',
     documentMode: 'editing',
-    documents: [
-      {
-        id: 'contract',
-        type: 'docx',
-        data: file,
-      },
-    ],
+    document: file,
   });
 }
 ```

package/dist/chunks/{eventemitter3-DEIiXiH2.es.js → eventemitter3-CMOjDs74.es.js}

@@ -1,4 +1,4 @@
-import { i as __toESM, t as __commonJSMin } from "./rolldown-runtime-0pSA04fp.es.js";
+import { i as __toESM, t as __commonJSMin } from "./rolldown-runtime-B5TtN50X.es.js";
 //#endregion
 //#region ../../node_modules/.pnpm/eventemitter3@5.0.4/node_modules/eventemitter3/index.mjs
 var import_eventemitter3 = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {

package/dist/chunks/{eventemitter3-C_TAnXOl.cjs → eventemitter3-D38u8ta_.cjs}

@@ -1,4 +1,4 @@
-const require_rolldown_runtime = require("./rolldown-runtime-74VwNCz7.cjs");
+const require_rolldown_runtime = require("./rolldown-runtime-DtsSbkrh.cjs");
 //#region ../../node_modules/.pnpm/eventemitter3@5.0.4/node_modules/eventemitter3/index.js
 var require_eventemitter3 = /* @__PURE__ */ require_rolldown_runtime.__commonJSMin(((exports, module) => {
 	var has = Object.prototype.hasOwnProperty;

package/dist/chunks/{jszip-D8mAFF-r.cjs → jszip-RC64TPzL.cjs}

@@ -1,4 +1,4 @@
-const require_rolldown_runtime = require("./rolldown-runtime-74VwNCz7.cjs");
+const require_rolldown_runtime = require("./rolldown-runtime-DtsSbkrh.cjs");
 //#region ../../node_modules/.pnpm/vite-plugin-node-polyfills@0.28.0_rollup@4.60.2_vite@7.3.1_@types+node@25.6.0_jiti@2.7._79de22fafa9a94a397e22a8c8322f563/node_modules/vite-plugin-node-polyfills/shims/buffer/dist/index.js
 function getLens(b64) {
 	var len = b64.length;

package/dist/chunks/{jszip-BzJ3CyxR.es.js → jszip-VxCFV9YS.es.js}

@@ -1,4 +1,4 @@
-import { n as __esmMin, r as __require, t as __commonJSMin } from "./rolldown-runtime-0pSA04fp.es.js";
+import { n as __esmMin, r as __require, t as __commonJSMin } from "./rolldown-runtime-B5TtN50X.es.js";
 //#region ../../node_modules/.pnpm/vite-plugin-node-polyfills@0.28.0_rollup@4.60.2_vite@7.3.1_@types+node@25.6.0_jiti@2.7._79de22fafa9a94a397e22a8c8322f563/node_modules/vite-plugin-node-polyfills/shims/buffer/dist/index.js
 function getLens(b64) {
 	var len = b64.length;

package/dist/chunks/{rolldown-runtime-0pSA04fp.es.js → rolldown-runtime-B5TtN50X.es.js}

@@ -24,7 +24,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));

package/dist/chunks/{rolldown-runtime-74VwNCz7.cjs → rolldown-runtime-DtsSbkrh.cjs}

@@ -24,7 +24,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.27",
+	superdocVersion: "2.4.0-next.29",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.4.0-next.27",
+	superdocVersion: "2.4.0-next.29",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/style.css

@@ -1770,11 +1770,11 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-7770edae] {
+.superdoc[data-v-d39f5239] {
   display: flex;
   position: relative;
 }
-.sd-visually-hidden[data-v-7770edae] {
+.sd-visually-hidden[data-v-d39f5239] {
   position: absolute;
   width: 1px;
   height: 1px;
@@ -1785,30 +1785,30 @@ img[data-v-c95b2073] {
   white-space: nowrap;
   border: 0;
 }
-.right-sidebar[data-v-7770edae] {
+.right-sidebar[data-v-d39f5239] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-7770edae] {
+.floating-comments[data-v-d39f5239] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-7770edae] {
+.superdoc__layers[data-v-d39f5239] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-7770edae] {
+.superdoc__document[data-v-d39f5239] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-7770edae] {
+.superdoc__sub-document[data-v-d39f5239] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-7770edae] {
+.superdoc__selection-layer[data-v-d39f5239] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1819,13 +1819,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-7770edae] {
+.superdoc__whiteboard-layer[data-v-d39f5239] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-7770edae] {
+.superdoc__temp-selection[data-v-d39f5239] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-7770edae] {
+.superdoc__right-sidebar[data-v-d39f5239] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1833,7 +1833,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-7770edae] {
+.superdoc__compact-comment-popover[data-v-d39f5239] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1842,14 +1842,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-7770edae] {
+.tools[data-v-d39f5239] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-7770edae] {
+.tools-item[data-v-d39f5239] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1860,10 +1860,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-7770edae] {
+.tools-item i[data-v-d39f5239] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-7770edae] {
+.superdoc__tools-icon[data-v-d39f5239] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1878,22 +1878,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-7770edae] {
+.superdoc .superdoc__layers[data-v-d39f5239] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-7770edae] {
+.superdoc__sub-document[data-v-d39f5239] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-7770edae] {
+.superdoc__right-sidebar[data-v-d39f5239] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-7770edae] {
+.ai-writer-container[data-v-d39f5239] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1909,10 +1909,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-7770edae] {
+.ai-tool > svg[data-v-d39f5239] {
   fill: transparent;
 }
-.ai-tool[data-v-7770edae]::before {
+.ai-tool[data-v-d39f5239]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -1933,7 +1933,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-7770edae]:hover::before {
+.ai-tool[data-v-d39f5239]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/style.layered.css

@@ -1770,11 +1770,11 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-7770edae] {
+.superdoc[data-v-d39f5239] {
   display: flex;
   position: relative;
 }
-.sd-visually-hidden[data-v-7770edae] {
+.sd-visually-hidden[data-v-d39f5239] {
   position: absolute;
   width: 1px;
   height: 1px;
@@ -1785,30 +1785,30 @@ img[data-v-c95b2073] {
   white-space: nowrap;
   border: 0;
 }
-.right-sidebar[data-v-7770edae] {
+.right-sidebar[data-v-d39f5239] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-7770edae] {
+.floating-comments[data-v-d39f5239] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-7770edae] {
+.superdoc__layers[data-v-d39f5239] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-7770edae] {
+.superdoc__document[data-v-d39f5239] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-7770edae] {
+.superdoc__sub-document[data-v-d39f5239] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-7770edae] {
+.superdoc__selection-layer[data-v-d39f5239] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -1819,13 +1819,13 @@ img[data-v-c95b2073] {
 /* SD-3497: PDF whiteboard overlay sits above the rendered PDF canvas but below
    the PDF comment anchors (z-index 6 in PdfCommentsLayer) so anchors stay
    clickable, and below the selection layer (z-index 10). */
-.superdoc__whiteboard-layer[data-v-7770edae] {
+.superdoc__whiteboard-layer[data-v-d39f5239] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-7770edae] {
+.superdoc__temp-selection[data-v-d39f5239] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-7770edae] {
+.superdoc__right-sidebar[data-v-d39f5239] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -1833,7 +1833,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-7770edae] {
+.superdoc__compact-comment-popover[data-v-d39f5239] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1842,14 +1842,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-7770edae] {
+.tools[data-v-d39f5239] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-7770edae] {
+.tools-item[data-v-d39f5239] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -1860,10 +1860,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-7770edae] {
+.tools-item i[data-v-d39f5239] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-7770edae] {
+.superdoc__tools-icon[data-v-d39f5239] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -1878,22 +1878,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-7770edae] {
+.superdoc .superdoc__layers[data-v-d39f5239] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-7770edae] {
+.superdoc__sub-document[data-v-d39f5239] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-7770edae] {
+.superdoc__right-sidebar[data-v-d39f5239] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-7770edae] {
+.ai-writer-container[data-v-d39f5239] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -1909,10 +1909,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-7770edae] {
+.ai-tool > svg[data-v-d39f5239] {
   fill: transparent;
 }
-.ai-tool[data-v-7770edae]::before {
+.ai-tool[data-v-d39f5239]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -1933,7 +1933,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-7770edae]:hover::before {
+.ai-tool[data-v-d39f5239]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/superdoc/src/core/types/index.d.ts

@@ -3580,6 +3580,17 @@ export interface Config {
      * Omitted entries keep SuperDoc's bundled worker URLs.
      */
     workerUrls?: V2WorkerUrlsConfig;
+    /**
+     * Budget for the document worker to start up, in milliseconds
+     * (default: 30000). Measured from worker spawn, so it covers script
+     * download, parsing, evaluation, and the worker's first response to
+     * SuperDoc. Raise it when a large worker chunk is served
+     * over a slow connection or a cold dev-server cache; lower it to fail faster.
+     * Worker load errors are reported immediately and do not wait for this
+     * budget. Must be a finite positive number no greater than 2147483647, the
+     * platform timer ceiling above which a delay would fire immediately.
+     */
+    workerStartupTimeoutMs?: number;
     /**
      * Opt-in toggle for the layout engine. Auto-disabled when web layout is
      * requested without `layoutEngineOptions.flowMode === 'semantic'`; the