superdoc 2.20.0-next.9 → 2.20.1-next.1

package/dist/style.layered.css

@@ -1493,7 +1493,7 @@ img[data-v-c95b2073] {
   font-size: 11px;
 }
 
-.comments-dialog[data-v-03d9f711] {
+.comments-dialog[data-v-bc46ac97] {
   display: flex;
   flex-direction: column;
   padding: var(--sd-ui-comments-card-padding, 16px);
@@ -1512,73 +1512,74 @@ img[data-v-c95b2073] {
   overflow-wrap: break-word;
   word-break: break-word;
 }
-.comments-dialog[data-v-03d9f711]:not(.is-active) {
+.comments-dialog[data-v-bc46ac97]:not(.is-active) {
   cursor: pointer;
 }
-.comments-dialog[data-v-03d9f711]:not(.is-active):not(.is-resolved):hover {
+.comments-dialog[data-v-bc46ac97]:not(.is-active):not(.is-resolved):hover {
   background-color: var(--sd-ui-comments-card-hover-bg, #f3f6fd);
 }
-.comments-dialog[data-v-03d9f711]:not(.is-resolved):hover .overflow-menu {
+.comments-dialog[data-v-bc46ac97]:not(.is-resolved):hover .overflow-menu {
   opacity: 1;
   pointer-events: auto;
 }
-.comments-dialog.is-active[data-v-03d9f711] {
+.comments-dialog.is-active[data-v-bc46ac97] {
   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-03d9f711] {
+.comments-dialog.is-resolved[data-v-bc46ac97] {
   background-color: var(--sd-ui-comments-card-resolved-bg, #f0f0f0);
 }
-.comment-separator[data-v-03d9f711] {
+.comment-separator[data-v-bc46ac97] {
   background-color: var(--sd-ui-comments-separator, #e0e0e0);
   height: 1px;
   width: 100%;
   margin: 10px 0;
 }
-.comment[data-v-03d9f711] {
+.comment[data-v-bc46ac97] {
   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-03d9f711] p {
+.comment[data-v-bc46ac97] p {
   margin: 0;
 }
-.tracked-change[data-v-03d9f711] {
+.tracked-change[data-v-bc46ac97] {
   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-03d9f711] {
+.change-type[data-v-bc46ac97] {
   color: var(--sd-ui-comments-body-text, #212121);
 }
-.tracked-change-text[data-v-03d9f711] {
+.tracked-change-text[data-v-bc46ac97] {
   color: var(--sd-ui-comments-body-text, #212121);
+  white-space: pre-wrap;
 }
-.tracked-change-text.is-deleted[data-v-03d9f711] {
+.tracked-change-text.is-deleted[data-v-bc46ac97] {
   color: var(--sd-ui-comments-delete-text, #cb0e47);
 }
-.tracked-change-text.is-inserted[data-v-03d9f711] {
+.tracked-change-text.is-inserted[data-v-bc46ac97] {
   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-03d9f711] {
+.tracked-change[data-track-change-semantic-color-key='move-from'] .tracked-change-text.is-deleted[data-v-bc46ac97] {
   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-03d9f711] {
+.tracked-change[data-track-change-semantic-color-key='move-to'] .tracked-change-text.is-inserted[data-v-bc46ac97] {
   color: var(--sd-ui-comments-move-to-text, #00853d);
 }
-.tracked-change-detail-lines[data-v-03d9f711] {
+.tracked-change-detail-lines[data-v-bc46ac97] {
   margin-top: 4px;
 }
-.tracked-change-detail-line[data-v-03d9f711] {
+.tracked-change-detail-line[data-v-bc46ac97] {
   font-size: 12px;
   line-height: 1.4;
 }
-.tracked-change-image-preview[data-v-03d9f711] {
+.tracked-change-image-preview[data-v-bc46ac97] {
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -1589,7 +1590,7 @@ img[data-v-c95b2073] {
   max-width: 96px;
   max-height: 96px;
 }
-.tracked-change-image-preview__image[data-v-03d9f711] {
+.tracked-change-image-preview__image[data-v-bc46ac97] {
   display: block;
   width: auto;
   height: auto;
@@ -1599,7 +1600,7 @@ img[data-v-c95b2073] {
 }
 
 /* ── Failed tracked-change decision alert (SD-3772 §6) ── */
-.tracked-change-decision-alert[data-v-03d9f711] {
+.tracked-change-decision-alert[data-v-bc46ac97] {
   display: flex;
   align-items: center;
   justify-content: space-between;
@@ -1613,12 +1614,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-03d9f711] {
+.tracked-change-decision-alert__retry[data-v-bc46ac97] {
   flex-shrink: 0;
 }
 
 /* ── Resolved badge ── */
-.resolved-badge[data-v-03d9f711] {
+.resolved-badge[data-v-bc46ac97] {
   display: inline-flex;
   align-items: center;
   gap: 4px;
@@ -1627,33 +1628,33 @@ img[data-v-c95b2073] {
   color: var(--sd-ui-comments-resolved-text, #00853d);
   margin-bottom: 4px;
 }
-.resolved-badge__icon[data-v-03d9f711] {
+.resolved-badge__icon[data-v-bc46ac97] {
   display: inline-flex;
   width: 12px;
   height: 12px;
 }
-.resolved-badge__icon[data-v-03d9f711] svg {
+.resolved-badge__icon[data-v-bc46ac97] svg {
   width: 100%;
   height: 100%;
   fill: currentColor;
 }
 
 /* ── Text truncation ── */
-.comment.is-truncated[data-v-03d9f711],
-.tracked-change.is-truncated[data-v-03d9f711] {
+.comment.is-truncated[data-v-bc46ac97],
+.tracked-change.is-truncated[data-v-bc46ac97] {
   display: -webkit-box;
   -webkit-line-clamp: 3;
   -webkit-box-orient: vertical;
   max-height: 4.5em;
   overflow: hidden;
 }
-.comment.is-scrollable[data-v-03d9f711],
-.tracked-change.is-scrollable[data-v-03d9f711] {
+.comment.is-scrollable[data-v-bc46ac97],
+.tracked-change.is-scrollable[data-v-bc46ac97] {
   max-height: 220px;
   overflow-y: auto;
   padding-right: 4px;
 }
-.show-more-toggle[data-v-03d9f711] {
+.show-more-toggle[data-v-bc46ac97] {
   font-size: 12px;
   color: var(--sd-ui-action, #1355ff);
   cursor: pointer;
@@ -1661,12 +1662,12 @@ img[data-v-c95b2073] {
   margin-top: 4px;
   user-select: none;
 }
-.show-more-toggle[data-v-03d9f711]:hover {
+.show-more-toggle[data-v-bc46ac97]:hover {
   text-decoration: underline;
 }
 
 /* ── Thread collapse ── */
-.collapsed-replies[data-v-03d9f711] {
+.collapsed-replies[data-v-bc46ac97] {
   display: flex;
   align-items: center;
   gap: 6px;
@@ -1677,24 +1678,24 @@ img[data-v-c95b2073] {
   cursor: pointer;
   user-select: none;
 }
-.collapsed-replies[data-v-03d9f711]:hover {
+.collapsed-replies[data-v-bc46ac97]:hover {
   text-decoration: underline;
 }
-.collapsed-avatars[data-v-03d9f711] {
+.collapsed-avatars[data-v-bc46ac97] {
   display: flex;
 }
-.collapsed-avatars .mini-avatar[data-v-03d9f711] {
+.collapsed-avatars .mini-avatar[data-v-bc46ac97] {
   --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-03d9f711]:first-child {
+.collapsed-avatars .mini-avatar[data-v-bc46ac97]:first-child {
   margin-left: 0;
 }
 
 /* ── New comment input ── */
-.new-comment-input-wrapper[data-v-03d9f711] {
+.new-comment-input-wrapper[data-v-bc46ac97] {
   border: 1.5px solid var(--sd-ui-comments-input-border, #dbdbdb);
   border-radius: 12px;
   padding: 8.5px 10.5px;
@@ -1703,17 +1704,17 @@ img[data-v-c95b2073] {
   max-height: 150px;
   overflow: visible;
 }
-.new-comment-input-wrapper[data-v-03d9f711]:focus-within {
+.new-comment-input-wrapper[data-v-bc46ac97]: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-03d9f711] .comment-entry {
+.new-comment-input-wrapper[data-v-bc46ac97] .comment-entry {
   border-radius: 0;
 }
-.new-comment-input-wrapper[data-v-03d9f711] .input-section {
+.new-comment-input-wrapper[data-v-bc46ac97] .input-section {
   margin: 0;
 }
-.new-comment-input-wrapper[data-v-03d9f711] .superdoc-field {
+.new-comment-input-wrapper[data-v-bc46ac97] .superdoc-field {
   font-size: 14px;
   line-height: 20px;
   border: none;
@@ -1724,18 +1725,18 @@ img[data-v-c95b2073] {
   max-height: 132px;
   resize: none;
 }
-.new-comment-input-wrapper[data-v-03d9f711] .superdoc-field:focus,
-.new-comment-input-wrapper[data-v-03d9f711] .superdoc-field:active {
+.new-comment-input-wrapper[data-v-bc46ac97] .superdoc-field:focus,
+.new-comment-input-wrapper[data-v-bc46ac97] .superdoc-field:active {
   border: none;
   box-shadow: none;
   outline: none;
 }
-.new-comment-input-wrapper[data-v-03d9f711] .sd-editor-placeholder::before {
+.new-comment-input-wrapper[data-v-bc46ac97] .sd-editor-placeholder::before {
   content: 'Comment or add others with @';
 }
 
 /* ── Reply pill & expanded input ── */
-.reply-pill[data-v-03d9f711] {
+.reply-pill[data-v-bc46ac97] {
   width: 100%;
   padding: 8.5px 10.5px;
   border: 1.5px solid transparent;
@@ -1749,16 +1750,16 @@ img[data-v-c95b2073] {
   cursor: text;
   transition: background 150ms ease;
 }
-.reply-pill[data-v-03d9f711]:hover {
+.reply-pill[data-v-bc46ac97]:hover {
   background: var(--sd-color-gray-200, #f2f2f2);
 }
-.reply-pill[data-v-03d9f711]:disabled {
+.reply-pill[data-v-bc46ac97]:disabled {
   cursor: not-allowed;
 }
-.reply-expanded[data-v-03d9f711] {
+.reply-expanded[data-v-bc46ac97] {
   margin-top: 10px;
 }
-.reply-input-wrapper[data-v-03d9f711] {
+.reply-input-wrapper[data-v-bc46ac97] {
   border: 1.5px solid var(--sd-ui-comments-input-border, #dbdbdb);
   border-radius: 12px;
   padding: 8.5px 10.5px;
@@ -1766,17 +1767,17 @@ img[data-v-c95b2073] {
   max-height: 150px;
   overflow: visible;
 }
-.reply-input-wrapper[data-v-03d9f711]:focus-within {
+.reply-input-wrapper[data-v-bc46ac97]: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-03d9f711] .comment-entry {
+.reply-input-wrapper[data-v-bc46ac97] .comment-entry {
   border-radius: 0;
 }
-.reply-input-wrapper[data-v-03d9f711] .input-section {
+.reply-input-wrapper[data-v-bc46ac97] .input-section {
   margin: 0;
 }
-.reply-input-wrapper[data-v-03d9f711] .superdoc-field {
+.reply-input-wrapper[data-v-bc46ac97] .superdoc-field {
   font-size: 14px;
   line-height: 20px;
   border: none;
@@ -1787,23 +1788,23 @@ img[data-v-c95b2073] {
   max-height: 132px;
   resize: none;
 }
-.reply-input-wrapper[data-v-03d9f711] .superdoc-field:focus,
-.reply-input-wrapper[data-v-03d9f711] .superdoc-field:active {
+.reply-input-wrapper[data-v-bc46ac97] .superdoc-field:focus,
+.reply-input-wrapper[data-v-bc46ac97] .superdoc-field:active {
   border: none;
   box-shadow: none;
   outline: none;
 }
-.reply-input-wrapper[data-v-03d9f711] .sd-editor-placeholder::before {
+.reply-input-wrapper[data-v-bc46ac97] .sd-editor-placeholder::before {
   content: 'Reply or add others with @';
 }
-.reply-actions[data-v-03d9f711] {
+.reply-actions[data-v-bc46ac97] {
   display: flex;
   justify-content: flex-end;
   align-items: center;
   gap: 16px;
   margin-top: 8px;
 }
-.reply-btn-cancel[data-v-03d9f711] {
+.reply-btn-cancel[data-v-bc46ac97] {
   background: none;
   border: none;
   font-size: 13px;
@@ -1814,10 +1815,10 @@ img[data-v-c95b2073] {
   font-family: inherit;
   transition: color 150ms;
 }
-.reply-btn-cancel[data-v-03d9f711]:hover {
+.reply-btn-cancel[data-v-bc46ac97]:hover {
   color: var(--sd-ui-text, #212121);
 }
-.reply-btn-primary[data-v-03d9f711] {
+.reply-btn-primary[data-v-bc46ac97] {
   background: var(--sd-ui-action, #1355ff);
   border: none;
   font-size: 13px;
@@ -1829,19 +1830,19 @@ img[data-v-c95b2073] {
   font-family: inherit;
   transition: background 150ms;
 }
-.reply-btn-primary[data-v-03d9f711]:hover {
+.reply-btn-primary[data-v-bc46ac97]:hover {
   background: var(--sd-ui-action-hover, #0f44cc);
 }
-.reply-btn-primary.sd-is-disabled[data-v-03d9f711] {
+.reply-btn-primary.sd-is-disabled[data-v-bc46ac97] {
   background: var(--sd-color-gray-400, #dbdbdb);
   color: var(--sd-color-gray-600, #888888);
   cursor: default;
   pointer-events: none;
 }
-.existing-internal-input[data-v-03d9f711] {
+.existing-internal-input[data-v-bc46ac97] {
   margin-bottom: 10px;
 }
-.sd-internal-dropdown[data-v-03d9f711] {
+.sd-internal-dropdown[data-v-bc46ac97] {
   display: inline-block;
 }
 
@@ -2339,34 +2340,34 @@ img[data-v-c95b2073] {
   pointer-events: auto;
 }
 
-.superdoc[data-v-7bbf01da] {
+.superdoc[data-v-e476c448] {
   display: flex;
   position: relative;
 }
-.right-sidebar[data-v-7bbf01da] {
+.right-sidebar[data-v-e476c448] {
   min-width: 320px;
   height: 100%;
 }
-.floating-comments[data-v-7bbf01da] {
+.floating-comments[data-v-e476c448] {
   min-width: 300px;
   width: 300px;
   height: 100%;
   overflow: visible;
 }
-.superdoc__layers[data-v-7bbf01da] {
+.superdoc__layers[data-v-e476c448] {
   height: 100%;
   position: relative;
   box-sizing: border-box;
 }
-.superdoc__document[data-v-7bbf01da] {
+.superdoc__document[data-v-e476c448] {
   width: 100%;
   position: relative;
 }
-.superdoc__sub-document[data-v-7bbf01da] {
+.superdoc__sub-document[data-v-e476c448] {
   width: 100%;
   position: relative;
 }
-.superdoc__selection-layer[data-v-7bbf01da] {
+.superdoc__selection-layer[data-v-e476c448] {
   position: absolute;
   min-width: 100%;
   min-height: 100%;
@@ -2377,13 +2378,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-7bbf01da] {
+.superdoc__whiteboard-layer[data-v-e476c448] {
   z-index: 4;
 }
-.superdoc__temp-selection[data-v-7bbf01da] {
+.superdoc__temp-selection[data-v-e476c448] {
   position: absolute;
 }
-.superdoc__right-sidebar[data-v-7bbf01da] {
+.superdoc__right-sidebar[data-v-e476c448] {
   width: 320px;
   min-width: 320px;
   padding: 0 10px;
@@ -2391,7 +2392,7 @@ img[data-v-c95b2073] {
   position: relative;
   z-index: 2;
 }
-.superdoc__compact-comment-popover[data-v-7bbf01da] {
+.superdoc__compact-comment-popover[data-v-e476c448] {
   position: absolute;
   top: 12px;
   right: 12px;
@@ -2400,14 +2401,14 @@ img[data-v-c95b2073] {
 }
 
 /* Tools styles */
-.tools[data-v-7bbf01da] {
+.tools[data-v-e476c448] {
   position: absolute;
   z-index: 3;
   display: flex;
   flex-direction: column;
   gap: var(--sd-ui-tools-gap, 6px);
 }
-.tools-item[data-v-7bbf01da] {
+.tools-item[data-v-e476c448] {
   display: flex;
   align-items: center;
   justify-content: center;
@@ -2418,10 +2419,10 @@ img[data-v-c95b2073] {
   cursor: pointer;
   position: relative;
 }
-.tools-item i[data-v-7bbf01da] {
+.tools-item i[data-v-e476c448] {
   cursor: pointer;
 }
-.superdoc__tools-icon[data-v-7bbf01da] {
+.superdoc__tools-icon[data-v-e476c448] {
   width: var(--sd-ui-tools-icon-size, 20px);
   height: var(--sd-ui-tools-icon-size, 20px);
   flex-shrink: 0;
@@ -2436,22 +2437,22 @@ img[data-v-c95b2073] {
 
 /* 834px is iPad screen size in portrait orientation */
 @media (max-width: 834px) {
-.superdoc .superdoc__layers[data-v-7bbf01da] {
+.superdoc .superdoc__layers[data-v-e476c448] {
     margin: 0;
     border: 0 !important;
     box-shadow: none;
 }
-.superdoc__sub-document[data-v-7bbf01da] {
+.superdoc__sub-document[data-v-e476c448] {
     max-width: 100%;
 }
-.superdoc__right-sidebar[data-v-7bbf01da] {
+.superdoc__right-sidebar[data-v-e476c448] {
     padding: 10px;
     position: relative;
 }
 }
 
 /* AI Writer styles */
-.ai-writer-container[data-v-7bbf01da] {
+.ai-writer-container[data-v-e476c448] {
   position: fixed;
   z-index: 1000;
   background: white;
@@ -2467,10 +2468,10 @@ img[data-v-c95b2073] {
   transform: translateY(-50%);
   z-index: 50;
 } */
-.ai-tool > svg[data-v-7bbf01da] {
+.ai-tool > svg[data-v-e476c448] {
   fill: transparent;
 }
-.ai-tool[data-v-7bbf01da]::before {
+.ai-tool[data-v-e476c448]::before {
   content: '';
   position: absolute;
   width: 20px;
@@ -2491,7 +2492,7 @@ img[data-v-c95b2073] {
   filter: brightness(1.2);
   transition: filter 0.2s ease;
 }
-.ai-tool[data-v-7bbf01da]:hover::before {
+.ai-tool[data-v-e476c448]:hover::before {
   filter: brightness(1.3);
 }
 

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

@@ -3694,16 +3694,18 @@ export interface ToolbarConfig {
      * syntax resolves to nothing.
      */
     container?: string | HTMLElement;
-    /** Built-in controls to render by region. Controls keep their built-in order. Omit to use the default toolbar. */
+    /** Built-in controls to render by region. Each region's controls render in the array order given. Omit to use the default toolbar. */
     items?: Readonly<Partial<Record<ToolbarRegion, readonly ToolbarItemId[]>>>;
     /**
      * Which groups render, or which items they contain.
      *
      * An array selects groups. The built-in layout still places them in its
      * left, center, and right regions, and always renders the center region.
+     * Item order within each region stays the built-in order for this shape.
      *
      * An object maps each group to its toolbar item ids. Its keys choose the
-     * regions and its values form a grouped allowlist.
+     * regions; its values form both the group's composition and the render
+     * order of items within that region.
      * @deprecated replaceWith=`ui.toolbar.items` removeIn=v3.0
      */
     groups?: readonly string[] | Readonly<Record<string, readonly string[]>>;

package/dist/superdoc/src/internal/toolbar/built-in/default-items.d.ts

@@ -9,7 +9,7 @@
  * callers share this one rule so the two cannot drift apart.
  */
 export function withLinkHref(attributes: any, href: any): any;
-export function makeDefaultItems({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts, hideButtons, availableWidth, role, isDev, configuredItemNames, excludedItemNames, additionalItems, }?: {
+export function makeDefaultItems({ superToolbar, toolbarIcons, toolbarTexts, toolbarFonts, hideButtons, availableWidth, role, isDev, configuredItemNames, configuredItemOrder, excludedItemNames, additionalItems, }?: {
     isDev?: boolean | undefined;
     additionalItems?: never[] | undefined;
 }): {

package/dist/superdoc/src/public/ui/types.d.ts

@@ -1,4 +1,4 @@
-import { CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, EntityAddress, TextAddress, TextTarget, ScrollIntoViewInput, ScrollIntoViewOutput, SelectionInfo, SelectionTarget, Receipt, ReceiptFailureCode, ContentControlInfo, ContentControlTarget, StyleCatalogItem, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult } from '../../../../document-api/src/index.js';
+import { CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, EntityAddress, TextAddress, BookmarkAddress, TextTarget, ScrollIntoViewInput, ScrollIntoViewOutput, SelectionInfo, SelectionTarget, Receipt, ReceiptFailureCode, ContentControlInfo, ContentControlTarget, StyleCatalogItem, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult } from '../../../../document-api/src/index.js';
 import { PartialBrowserDocumentApi } from '../browser-document-api.js';
 import { ExportParams } from '../export-types.js';
 import { DocumentReplacementResult } from '../document-replacement.js';
@@ -30,7 +30,7 @@ import { BuiltInCommandId } from './commands.js';
  * (`scripts/ensure-types.cjs` `rewriteDocApiPaths`), so no bare private
  * specifier leaks into the emitted `.d.ts`.
  */
-export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, } from '../../../../document-api/src/index.js';
+export type { Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, BookmarkAddress, ScrollIntoViewInput, ScrollIntoViewOutput, DocumentApi, EntityAddress, CommentsListQuery as DocumentApiCommentsListQuery, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, } from '../../../../document-api/src/index.js';
 export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, } from '../../../../document-api/src/index.js';
 export type { ListPresetId } from '../../../../document-api/src/index.js';
 export type { BrowserDocumentApi, PartialBrowserDocumentApi } from '../browser-document-api.js';
@@ -1046,6 +1046,23 @@ export interface TrackChangesHandle extends SnapshotSubscribable<TrackChangesSli
         story?: unknown;
     }): Promise<WorkflowScrollResult>;
 }
+/** Browser bookmark navigation; document bookmark CRUD remains on `activeEditor.doc`. */
+export interface BookmarksHandle {
+    /**
+     * Reveal the start of a body bookmark and select its complete range in editing,
+     * suggesting or viewing mode. A collapsed range places a caret. Accepts an
+     * exact name or the canonical BookmarkAddress returned by the Document API.
+     * Name-only lookup requires a unique document-wide match; an explicit body
+     * address scopes lookup to the body. Navigation is local in shared rooms.
+     *
+     * Defaults to center alignment and instant scrolling. Non-body and table-column
+     * bookmarks, invalid/missing/ambiguous targets fail with `target-unresolved`.
+     * Failed resolution/reveal preserves selection. No document content is changed.
+     * Abandons work after document replacement, content changes or a newer request;
+     * unresolved work times out after 15 seconds. Does not take native input focus.
+     */
+    navigateTo(input: string | BookmarkAddress, options?: Pick<ScrollIntoViewInput, 'block' | 'behavior'>): Promise<WorkflowScrollResult>;
+}
 /** Content-controls handle. */
 export interface ContentControlsHandle extends SnapshotSubscribable<ContentControlsSlice> {
     /**
@@ -1556,6 +1573,8 @@ export interface SuperDocUI {
     readonly trackChanges: TrackChangesHandle;
     /** Content-controls surface. */
     readonly contentControls: ContentControlsHandle;
+    /** Programmatic body bookmark selection and painted-page reveal. */
+    readonly bookmarks: BookmarksHandle;
     /** Fonts surface. */
     readonly fonts: FontsHandle;
     /** Zoom surface. */

package/dist/superdoc/src/public/ui.d.cts

@@ -1,5 +1,7 @@
 // Generated by scripts/ensure-types.cjs. Do not edit by hand.
 import type { ActiveParagraphStyle as __Cjs_ActiveParagraphStyle } from './ui.js' with { "resolution-mode": "import" };
+import type { BookmarkAddress as __Cjs_BookmarkAddress } from './ui.js' with { "resolution-mode": "import" };
+import type { BookmarksHandle as __Cjs_BookmarksHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { BorrowedSuperDocUI as __Cjs_BorrowedSuperDocUI } from './ui.js' with { "resolution-mode": "import" };
 import type { BrowserDocumentApi as __Cjs_BrowserDocumentApi } from './ui.js' with { "resolution-mode": "import" };
 import type { BuiltInCommandId as __Cjs_BuiltInCommandId } from './ui.js' with { "resolution-mode": "import" };
@@ -120,6 +122,8 @@ import type { WorkflowScrollResult as __Cjs_WorkflowScrollResult } from './ui.js
 import type { ZoomHandle as __Cjs_ZoomHandle } from './ui.js' with { "resolution-mode": "import" };
 import type { ZoomSlice as __Cjs_ZoomSlice } from './ui.js' with { "resolution-mode": "import" };
 export type { __Cjs_ActiveParagraphStyle as ActiveParagraphStyle };
+export type { __Cjs_BookmarkAddress as BookmarkAddress };
+export type { __Cjs_BookmarksHandle as BookmarksHandle };
 export type { __Cjs_BorrowedSuperDocUI as BorrowedSuperDocUI };
 export type { __Cjs_BrowserDocumentApi as BrowserDocumentApi };
 export declare const BUILT_IN_COMMAND_IDS: typeof import('./ui.js', { with: { "resolution-mode": "import" } }).BUILT_IN_COMMAND_IDS;

package/dist/superdoc/src/public/ui.d.ts

@@ -26,4 +26,4 @@
 export { createSuperDocUI } from './ui/create-super-doc-ui.js';
 export { shallowEqual } from './ui/equality.js';
 export { BUILT_IN_COMMAND_IDS } from './ui/commands.js';
-export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandId, CommandsHandle, ContextMenuItem, ContextMenuHandle, WatermarkHandle, SearchController, SearchHandle, SearchQueryOptions, CustomCommandContext, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, BuiltInCommandId, ToolbarCommandId, CommentsHandle, TrackChangesHandle, ContentControlsHandle, ContentControlFocusResult, ContentControlHighlightResult, FontsHandle, ZoomHandle, DocumentHandle, DocumentReplacementResult, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, SearchSnapshot, SearchSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, } from './ui/types.js';
+export type { EqualityFn, SelectorFn, Subscribable, SuperDocUI, BorrowedSuperDocUI, SuperDocUIOptions, SuperDocUIState, SuperDocUIScope, SuperDocLike, SuperDocEditorLike, CommandHandle, CommandState, CommandExecutionResult, WorkflowReceipt, WorkflowActionResult, WorkflowScrollResult, SelectionRestoreResult, SuperDocUIReason, CommandId, CommandsHandle, ContextMenuItem, ContextMenuHandle, WatermarkHandle, SearchController, SearchHandle, SearchQueryOptions, CustomCommandContext, CustomCommandHandle, CustomCommandHandleState, CustomCommandRegistration, CustomCommandRegistrationResult, MetadataHandle, SelectionHandle, ToolbarHandle, BuiltInCommandId, ToolbarCommandId, CommentsHandle, TrackChangesHandle, ContentControlsHandle, BookmarksHandle, BookmarkAddress, ContentControlFocusResult, ContentControlHighlightResult, FontsHandle, ZoomHandle, DocumentHandle, DocumentReplacementResult, ViewportHandle, StylesHandle, ActiveParagraphStyle, SliceStatus, SelectionSlice, SelectionCapture, CommentAnchorCapture, ToolbarSnapshotSlice, CommentsSlice, TrackChangesSlice, ContentControlsSlice, FontsSlice, ZoomSlice, DocumentSlice, StylesSlice, SearchSnapshot, SearchSlice, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, CommentInfo, CommentsListQuery, TrackChangeInfo, TrackChangePointHit, TrackChangesItem, FontFamilyOption, FontSizeOption, CommentAddress, TrackedChangeAddress, ContentControlViewportAddress, ViewportEntityAddress, ViewportEntityHit, ViewportContext, ViewportRect, ViewportGetRectInput, ViewportRectResult, BrowserDocumentApi, PartialBrowserDocumentApi, DocumentApi, Receipt, SelectionInfo, SelectionTarget, SelectionPoint, TextTarget, TextAddress, ScrollIntoViewInput, ScrollIntoViewOutput, EntityAddress, CommentsListResult, TrackChangesListResult, ContentControlsListResult, ContentControlInfo, ContentControlTarget, RichContentInsertInput, OperationCapabilityResolveResult, SDHtmlMarkdownSupportCheckResult, PictureWatermarkInput, RetainedPictureWatermarkInput, TextWatermark, WatermarkInfo, WatermarkTarget, WatermarksApplyInput, WatermarksApplyResult, WatermarksApplySuccess, WatermarksApplyTarget, } from './ui/types.js';