superdoc 2.4.0 → 2.5.0

package/dist/style.layered.css

@@ -1014,7 +1014,7 @@ img[data-v-c95b2073] {
   box-shadow: 0 0 0 2px rgba(79, 124, 255, 0.16);
 }
 
-.comments-dialog[data-v-0277e53b] {
+.comments-dialog[data-v-fd214e1f] {
   display: flex;
   flex-direction: column;
   padding: var(--sd-ui-comments-card-padding, 16px);
@@ -1033,73 +1033,73 @@ img[data-v-c95b2073] {
   overflow-wrap: break-word;
   word-break: break-word;
 }
-.comments-dialog[data-v-0277e53b]:not(.is-active) {
+.comments-dialog[data-v-fd214e1f]:not(.is-active) {
   cursor: pointer;
 }
-.comments-dialog[data-v-0277e53b]:not(.is-active):not(.is-resolved):hover {
+.comments-dialog[data-v-fd214e1f]:not(.is-active):not(.is-resolved):hover {
   background-color: var(--sd-ui-comments-card-hover-bg, #f3f6fd);
 }
-.comments-dialog[data-v-0277e53b]:not(.is-resolved):hover .overflow-menu {
+.comments-dialog[data-v-fd214e1f]:not(.is-resolved):hover .overflow-menu {
   opacity: 1;
   pointer-events: auto;
 }
-.comments-dialog.is-active[data-v-0277e53b] {
+.comments-dialog.is-active[data-v-fd214e1f] {
   background-color: var(--sd-ui-comments-card-active-bg, #ffffff);
   border-color: var(--sd-ui-comments-card-active-border, #e0e0e0);
   box-shadow: var(--sd-ui-comments-card-shadow, 0px 4px 12px 0px rgba(50, 50, 50, 0.15));
   z-index: 10;
 }
-.comments-dialog.is-resolved[data-v-0277e53b] {
+.comments-dialog.is-resolved[data-v-fd214e1f] {
   background-color: var(--sd-ui-comments-card-resolved-bg, #f0f0f0);
 }
-.comment-separator[data-v-0277e53b] {
+.comment-separator[data-v-fd214e1f] {
   background-color: var(--sd-ui-comments-separator, #e0e0e0);
   height: 1px;
   width: 100%;
   margin: 10px 0;
 }
-.comment[data-v-0277e53b] {
+.comment[data-v-fd214e1f] {
   font-size: var(--sd-ui-comments-body-size, 14px);
   line-height: 1.5;
   color: var(--sd-ui-comments-body-text, #212121);
   margin: 4px 0 0 0;
 }
-.comment[data-v-0277e53b] p {
+.comment[data-v-fd214e1f] p {
   margin: 0;
 }
-.tracked-change[data-v-0277e53b] {
+.tracked-change[data-v-fd214e1f] {
   font-size: var(--sd-ui-comments-body-size, 14px);
   line-height: 1.5;
   color: var(--sd-ui-comments-body-text, #212121);
   margin: 4px 0 0 0;
 }
-.change-type[data-v-0277e53b] {
+.change-type[data-v-fd214e1f] {
   color: var(--sd-ui-comments-body-text, #212121);
 }
-.tracked-change-text[data-v-0277e53b] {
+.tracked-change-text[data-v-fd214e1f] {
   color: var(--sd-ui-comments-body-text, #212121);
 }
-.tracked-change-text.is-deleted[data-v-0277e53b] {
+.tracked-change-text.is-deleted[data-v-fd214e1f] {
   color: var(--sd-ui-comments-delete-text, #cb0e47);
 }
-.tracked-change-text.is-inserted[data-v-0277e53b] {
+.tracked-change-text.is-inserted[data-v-fd214e1f] {
   color: var(--sd-ui-comments-insert-text, #1f6feb);
   font-weight: 500;
 }
-.tracked-change[data-track-change-semantic-color-key='move-from'] .tracked-change-text.is-deleted[data-v-0277e53b] {
+.tracked-change[data-track-change-semantic-color-key='move-from'] .tracked-change-text.is-deleted[data-v-fd214e1f] {
   color: var(--sd-ui-comments-move-from-text, #00853d);
 }
-.tracked-change[data-track-change-semantic-color-key='move-to'] .tracked-change-text.is-inserted[data-v-0277e53b] {
+.tracked-change[data-track-change-semantic-color-key='move-to'] .tracked-change-text.is-inserted[data-v-fd214e1f] {
   color: var(--sd-ui-comments-move-to-text, #00853d);
 }
-.tracked-change-detail-lines[data-v-0277e53b] {
+.tracked-change-detail-lines[data-v-fd214e1f] {
   margin-top: 4px;
 }
-.tracked-change-detail-line[data-v-0277e53b] {
+.tracked-change-detail-line[data-v-fd214e1f] {
   font-size: 12px;
   line-height: 1.4;
 }
-.tracked-change-image-preview[data-v-0277e53b] {
+.tracked-change-image-preview[data-v-fd214e1f] {
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -1110,7 +1110,7 @@ img[data-v-c95b2073] {
   max-width: 96px;
   max-height: 96px;
 }
-.tracked-change-image-preview__image[data-v-0277e53b] {
+.tracked-change-image-preview__image[data-v-fd214e1f] {
   display: block;
   width: auto;
   height: auto;
@@ -1120,7 +1120,7 @@ img[data-v-c95b2073] {
 }
 
 /* ── Failed tracked-change decision alert (SD-3772 §6) ── */
-.tracked-change-decision-alert[data-v-0277e53b] {
+.tracked-change-decision-alert[data-v-fd214e1f] {
   display: flex;
   align-items: center;
   justify-content: space-between;
@@ -1134,12 +1134,12 @@ img[data-v-c95b2073] {
   font-size: var(--sd-ui-comments-body-size, 14px);
   line-height: 1.4;
 }
-.tracked-change-decision-alert__retry[data-v-0277e53b] {
+.tracked-change-decision-alert__retry[data-v-fd214e1f] {
   flex-shrink: 0;
 }
 
 /* ── Resolved badge ── */
-.resolved-badge[data-v-0277e53b] {
+.resolved-badge[data-v-fd214e1f] {
   display: inline-flex;
   align-items: center;
   gap: 4px;
@@ -1148,33 +1148,33 @@ img[data-v-c95b2073] {
   color: var(--sd-ui-comments-resolved-text, #00853d);
   margin-bottom: 4px;
 }
-.resolved-badge__icon[data-v-0277e53b] {
+.resolved-badge__icon[data-v-fd214e1f] {
   display: inline-flex;
   width: 12px;
   height: 12px;
 }
-.resolved-badge__icon[data-v-0277e53b] svg {
+.resolved-badge__icon[data-v-fd214e1f] svg {
   width: 100%;
   height: 100%;
   fill: currentColor;
 }
 
 /* ── Text truncation ── */
-.comment.is-truncated[data-v-0277e53b],
-.tracked-change.is-truncated[data-v-0277e53b] {
+.comment.is-truncated[data-v-fd214e1f],
+.tracked-change.is-truncated[data-v-fd214e1f] {
   display: -webkit-box;
   -webkit-line-clamp: 3;
   -webkit-box-orient: vertical;
   max-height: 4.5em;
   overflow: hidden;
 }
-.comment.is-scrollable[data-v-0277e53b],
-.tracked-change.is-scrollable[data-v-0277e53b] {
+.comment.is-scrollable[data-v-fd214e1f],
+.tracked-change.is-scrollable[data-v-fd214e1f] {
   max-height: 220px;
   overflow-y: auto;
   padding-right: 4px;
 }
-.show-more-toggle[data-v-0277e53b] {
+.show-more-toggle[data-v-fd214e1f] {
   font-size: 12px;
   color: var(--sd-ui-action, #1355ff);
   cursor: pointer;
@@ -1182,12 +1182,12 @@ img[data-v-c95b2073] {
   margin-top: 4px;
   user-select: none;
 }
-.show-more-toggle[data-v-0277e53b]:hover {
+.show-more-toggle[data-v-fd214e1f]:hover {
   text-decoration: underline;
 }
 
 /* ── Thread collapse ── */
-.collapsed-replies[data-v-0277e53b] {
+.collapsed-replies[data-v-fd214e1f] {
   display: flex;
   align-items: center;
   gap: 6px;
@@ -1198,24 +1198,24 @@ img[data-v-c95b2073] {
   cursor: pointer;
   user-select: none;
 }
-.collapsed-replies[data-v-0277e53b]:hover {
+.collapsed-replies[data-v-fd214e1f]:hover {
   text-decoration: underline;
 }
-.collapsed-avatars[data-v-0277e53b] {
+.collapsed-avatars[data-v-fd214e1f] {
   display: flex;
 }
-.collapsed-avatars .mini-avatar[data-v-0277e53b] {
+.collapsed-avatars .mini-avatar[data-v-fd214e1f] {
   --sd-comment-avatar-size: 20px;
   --sd-comment-avatar-font-size: 8px;
   margin-left: -4px;
   border: 2px solid var(--sd-ui-comments-card-active-bg, #ffffff);
 }
-.collapsed-avatars .mini-avatar[data-v-0277e53b]:first-child {
+.collapsed-avatars .mini-avatar[data-v-fd214e1f]:first-child {
   margin-left: 0;
 }
 
 /* ── New comment input ── */
-.new-comment-input-wrapper[data-v-0277e53b] {
+.new-comment-input-wrapper[data-v-fd214e1f] {
   border: 1.5px solid var(--sd-ui-comments-input-border, #dbdbdb);
   border-radius: 12px;
   padding: 8.5px 10.5px;
@@ -1224,17 +1224,17 @@ img[data-v-c95b2073] {
   max-height: 150px;
   overflow-y: auto;
 }
-.new-comment-input-wrapper[data-v-0277e53b]:focus-within {
+.new-comment-input-wrapper[data-v-fd214e1f]:focus-within {
   border-color: var(--sd-ui-comments-input-focus-border, #4f7cff);
   box-shadow: 0 0 0 2px rgba(79, 124, 255, 0.16);
 }
-.new-comment-input-wrapper[data-v-0277e53b] .comment-entry {
+.new-comment-input-wrapper[data-v-fd214e1f] .comment-entry {
   border-radius: 0;
 }
-.new-comment-input-wrapper[data-v-0277e53b] .input-section {
+.new-comment-input-wrapper[data-v-fd214e1f] .input-section {
   margin: 0;
 }
-.new-comment-input-wrapper[data-v-0277e53b] .superdoc-field {
+.new-comment-input-wrapper[data-v-fd214e1f] .superdoc-field {
   font-size: 14px;
   line-height: 20px;
   border: none;
@@ -1245,18 +1245,18 @@ img[data-v-c95b2073] {
   max-height: 132px;
   resize: none;
 }
-.new-comment-input-wrapper[data-v-0277e53b] .superdoc-field:focus,
-.new-comment-input-wrapper[data-v-0277e53b] .superdoc-field:active {
+.new-comment-input-wrapper[data-v-fd214e1f] .superdoc-field:focus,
+.new-comment-input-wrapper[data-v-fd214e1f] .superdoc-field:active {
   border: none;
   box-shadow: none;
   outline: none;
 }
-.new-comment-input-wrapper[data-v-0277e53b] .sd-editor-placeholder::before {
+.new-comment-input-wrapper[data-v-fd214e1f] .sd-editor-placeholder::before {
   content: 'Comment or add others with @';
 }
 
 /* ── Reply pill & expanded input ── */
-.reply-pill[data-v-0277e53b] {
+.reply-pill[data-v-fd214e1f] {
   width: 100%;
   padding: 8.5px 10.5px;
   border: 1.5px solid transparent;
@@ -1270,16 +1270,16 @@ img[data-v-c95b2073] {
   cursor: text;
   transition: background 150ms ease;
 }
-.reply-pill[data-v-0277e53b]:hover {
+.reply-pill[data-v-fd214e1f]:hover {
   background: var(--sd-color-gray-200, #f2f2f2);
 }
-.reply-pill[data-v-0277e53b]:disabled {
+.reply-pill[data-v-fd214e1f]:disabled {
   cursor: not-allowed;
 }
-.reply-expanded[data-v-0277e53b] {
+.reply-expanded[data-v-fd214e1f] {
   margin-top: 10px;
 }
-.reply-input-wrapper[data-v-0277e53b] {
+.reply-input-wrapper[data-v-fd214e1f] {
   border: 1.5px solid var(--sd-ui-comments-input-border, #dbdbdb);
   border-radius: 12px;
   padding: 8.5px 10.5px;
@@ -1287,17 +1287,17 @@ img[data-v-c95b2073] {
   max-height: 150px;
   overflow-y: auto;
 }
-.reply-input-wrapper[data-v-0277e53b]:focus-within {
+.reply-input-wrapper[data-v-fd214e1f]:focus-within {
   border-color: var(--sd-ui-comments-input-focus-border, #4f7cff);
   box-shadow: 0 0 0 2px rgba(79, 124, 255, 0.16);
 }
-.reply-input-wrapper[data-v-0277e53b] .comment-entry {
+.reply-input-wrapper[data-v-fd214e1f] .comment-entry {
   border-radius: 0;
 }
-.reply-input-wrapper[data-v-0277e53b] .input-section {
+.reply-input-wrapper[data-v-fd214e1f] .input-section {
   margin: 0;
 }
-.reply-input-wrapper[data-v-0277e53b] .superdoc-field {
+.reply-input-wrapper[data-v-fd214e1f] .superdoc-field {
   font-size: 14px;
   line-height: 20px;
   border: none;
@@ -1308,23 +1308,23 @@ img[data-v-c95b2073] {
   max-height: 132px;
   resize: none;
 }
-.reply-input-wrapper[data-v-0277e53b] .superdoc-field:focus,
-.reply-input-wrapper[data-v-0277e53b] .superdoc-field:active {
+.reply-input-wrapper[data-v-fd214e1f] .superdoc-field:focus,
+.reply-input-wrapper[data-v-fd214e1f] .superdoc-field:active {
   border: none;
   box-shadow: none;
   outline: none;
 }
-.reply-input-wrapper[data-v-0277e53b] .sd-editor-placeholder::before {
+.reply-input-wrapper[data-v-fd214e1f] .sd-editor-placeholder::before {
   content: 'Reply or add others with @';
 }
-.reply-actions[data-v-0277e53b] {
+.reply-actions[data-v-fd214e1f] {
   display: flex;
   justify-content: flex-end;
   align-items: center;
   gap: 16px;
   margin-top: 8px;
 }
-.reply-btn-cancel[data-v-0277e53b] {
+.reply-btn-cancel[data-v-fd214e1f] {
   background: none;
   border: none;
   font-size: 13px;
@@ -1335,10 +1335,10 @@ img[data-v-c95b2073] {
   font-family: inherit;
   transition: color 150ms;
 }
-.reply-btn-cancel[data-v-0277e53b]:hover {
+.reply-btn-cancel[data-v-fd214e1f]:hover {
   color: var(--sd-ui-text, #212121);
 }
-.reply-btn-primary[data-v-0277e53b] {
+.reply-btn-primary[data-v-fd214e1f] {
   background: var(--sd-ui-action, #1355ff);
   border: none;
   font-size: 13px;
@@ -1350,19 +1350,19 @@ img[data-v-c95b2073] {
   font-family: inherit;
   transition: background 150ms;
 }
-.reply-btn-primary[data-v-0277e53b]:hover {
+.reply-btn-primary[data-v-fd214e1f]:hover {
   background: var(--sd-ui-action-hover, #0f44cc);
 }
-.reply-btn-primary.sd-is-disabled[data-v-0277e53b] {
+.reply-btn-primary.sd-is-disabled[data-v-fd214e1f] {
   background: var(--sd-color-gray-400, #dbdbdb);
   color: var(--sd-color-gray-600, #888888);
   cursor: default;
   pointer-events: none;
 }
-.existing-internal-input[data-v-0277e53b] {
+.existing-internal-input[data-v-fd214e1f] {
   margin-bottom: 10px;
 }
-.sd-internal-dropdown[data-v-0277e53b] {
+.sd-internal-dropdown[data-v-fd214e1f] {
   display: inline-block;
 }
 
@@ -1770,11 +1770,11 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-7770edae] {
+.superdoc[data-v-af3574db] {
   display: flex;
   position: relative;
 }
-.sd-visually-hidden[data-v-7770edae] {
+.sd-visually-hidden[data-v-af3574db] {
   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-af3574db] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-7770edae] {
+.floating-comments[data-v-af3574db] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-7770edae] {
+.superdoc__layers[data-v-af3574db] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-7770edae] {
+.superdoc__document[data-v-af3574db] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-7770edae] {
+.superdoc__sub-document[data-v-af3574db] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-7770edae] {
+.superdoc__selection-layer[data-v-af3574db] {
   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-af3574db] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-7770edae] {
+.superdoc__temp-selection[data-v-af3574db] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-7770edae] {
+.superdoc__right-sidebar[data-v-af3574db] {
   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-af3574db] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -1842,14 +1842,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-7770edae] {
+.tools[data-v-af3574db] {
   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-af3574db] {
   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-af3574db] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-7770edae] {
+.superdoc__tools-icon[data-v-af3574db] {
   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-af3574db] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-7770edae] {
+.superdoc__sub-document[data-v-af3574db] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-7770edae] {
+.superdoc__right-sidebar[data-v-af3574db] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-7770edae] {
+.ai-writer-container[data-v-af3574db] {
   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-af3574db] {
   fill: transparent;
 }
-.ai-tool[data-v-7770edae]::before {
+.ai-tool[data-v-af3574db]::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-af3574db]:hover::before {
   filter: brightness(1.3);
 }
 

package/dist/superdoc/src/core/config/normalize-ui-config.d.ts

@@ -7,6 +7,7 @@
  *   toolbar: { enabled: boolean, container: string | HTMLElement | null, options: Record<string, unknown> },
  *   comments: { enabled: boolean, options: Record<string, unknown> },
  *   contextMenu: { enabled: boolean, suppressed: boolean, options: Record<string, unknown> },
+ *   loading: { enabled: boolean },
  *   search: { enabled: boolean, options: Record<string, unknown> },
  *   linkPopover: { enabled: boolean, suppressed: boolean, options: Record<string, unknown> },
  *   ruler: { enabled: boolean, suppressed: boolean, container: string | HTMLElement | null },
@@ -29,6 +30,9 @@ export function normalizeUiConfig(config?: Record<string, any>): {
         suppressed: boolean;
         options: Record<string, unknown>;
     };
+    loading: {
+        enabled: boolean;
+    };
     search: {
         enabled: boolean;
         options: Record<string, unknown>;
@@ -55,6 +59,7 @@ export const HISTORICAL_DEFAULTS: Readonly<{
     toolbar: true;
     comments: true;
     contextMenu: true;
+    loading: true;
     search: false;
     linkPopover: false;
     ruler: false;

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

@@ -3116,6 +3116,19 @@ export interface UIConfig {
     comments?: boolean | CommentsConfig;
     /** Built-in right-click and slash context menu. Enabled by default. */
     contextMenu?: boolean | ContextMenuConfig;
+    /**
+     * Built-in loading overlay shown while a document opens. Enabled by default.
+     * Set to `false` to show your own loading UI instead.
+     *
+     * This only decides whether SuperDoc draws the overlay. It does not change
+     * how long a document takes to open, and it does not affect loading UI the
+     * host renders (such as `renderLoading` in `@superdoc/react`).
+     *
+     * The built-in overlay also masks the document while it opens. Turning it
+     * off hands that responsibility to your UI: keep yours up until `onReady`,
+     * and around a replacement await `superdoc.replaceFile(...)`.
+     */
+    loading?: boolean;
     /**
      * Built-in find/replace surface. Disabled by default. Enabling it lets
      * SuperDoc intercept Cmd+F / Ctrl+F; `editor.ui.search` stays available to
@@ -3580,6 +3593,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