superdoc 2.20.1-next.7 → 2.20.1-next.8

package/dist/style.layered.css

@@ -1493,7 +1493,7 @@ img[data-v-c95b2073] {
   font-size: 11px;
 }
 
-.comments-dialog[data-v-bc46ac97] {
+.comments-dialog[data-v-eefd4750] {
   display: flex;
   flex-direction: column;
   padding: var(--sd-ui-comments-card-padding, 16px);
@@ -1512,74 +1512,74 @@ img[data-v-c95b2073] {
   overflow-wrap: break-word;
   word-break: break-word;
 }
-.comments-dialog[data-v-bc46ac97]:not(.is-active) {
+.comments-dialog[data-v-eefd4750]:not(.is-active) {
   cursor: pointer;
 }
-.comments-dialog[data-v-bc46ac97]:not(.is-active):not(.is-resolved):hover {
+.comments-dialog[data-v-eefd4750]:not(.is-active):not(.is-resolved):hover {
   background-color: var(--sd-ui-comments-card-hover-bg, #f3f6fd);
 }
-.comments-dialog[data-v-bc46ac97]:not(.is-resolved):hover .overflow-menu {
+.comments-dialog[data-v-eefd4750]:not(.is-resolved):hover .overflow-menu {
   opacity: 1;
   pointer-events: auto;
 }
-.comments-dialog.is-active[data-v-bc46ac97] {
+.comments-dialog.is-active[data-v-eefd4750] {
   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-bc46ac97] {
+.comments-dialog.is-resolved[data-v-eefd4750] {
   background-color: var(--sd-ui-comments-card-resolved-bg, #f0f0f0);
 }
-.comment-separator[data-v-bc46ac97] {
+.comment-separator[data-v-eefd4750] {
   background-color: var(--sd-ui-comments-separator, #e0e0e0);
   height: 1px;
   width: 100%;
   margin: 10px 0;
 }
-.comment[data-v-bc46ac97] {
+.comment[data-v-eefd4750] {
   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-bc46ac97] p {
+.comment[data-v-eefd4750] p {
   margin: 0;
 }
-.tracked-change[data-v-bc46ac97] {
+.tracked-change[data-v-eefd4750] {
   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-bc46ac97] {
+.change-type[data-v-eefd4750] {
   color: var(--sd-ui-comments-body-text, #212121);
 }
-.tracked-change-text[data-v-bc46ac97] {
+.tracked-change-text[data-v-eefd4750] {
   color: var(--sd-ui-comments-body-text, #212121);
   white-space: pre-wrap;
 }
-.tracked-change-text.is-deleted[data-v-bc46ac97] {
+.tracked-change-text.is-deleted[data-v-eefd4750] {
   color: var(--sd-ui-comments-delete-text, #cb0e47);
 }
-.tracked-change-text.is-inserted[data-v-bc46ac97] {
+.tracked-change-text.is-inserted[data-v-eefd4750] {
   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-bc46ac97] {
+.tracked-change[data-track-change-semantic-color-key='move-from'] .tracked-change-text.is-deleted[data-v-eefd4750] {
   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-bc46ac97] {
+.tracked-change[data-track-change-semantic-color-key='move-to'] .tracked-change-text.is-inserted[data-v-eefd4750] {
   color: var(--sd-ui-comments-move-to-text, #00853d);
 }
-.tracked-change-detail-lines[data-v-bc46ac97] {
+.tracked-change-detail-lines[data-v-eefd4750] {
   margin-top: 4px;
 }
-.tracked-change-detail-line[data-v-bc46ac97] {
+.tracked-change-detail-line[data-v-eefd4750] {
   font-size: 12px;
   line-height: 1.4;
 }
-.tracked-change-image-preview[data-v-bc46ac97] {
+.tracked-change-image-preview[data-v-eefd4750] {
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -1590,7 +1590,7 @@ img[data-v-c95b2073] {
   max-width: 96px;
   max-height: 96px;
 }
-.tracked-change-image-preview__image[data-v-bc46ac97] {
+.tracked-change-image-preview__image[data-v-eefd4750] {
   display: block;
   width: auto;
   height: auto;
@@ -1600,7 +1600,7 @@ img[data-v-c95b2073] {
 }
 
 /* ── Failed tracked-change decision alert (SD-3772 §6) ── */
-.tracked-change-decision-alert[data-v-bc46ac97] {
+.tracked-change-decision-alert[data-v-eefd4750] {
   display: flex;
   align-items: center;
   justify-content: space-between;
@@ -1614,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-bc46ac97] {
+.tracked-change-decision-alert__retry[data-v-eefd4750] {
   flex-shrink: 0;
 }
 
 /* ── Resolved badge ── */
-.resolved-badge[data-v-bc46ac97] {
+.resolved-badge[data-v-eefd4750] {
   display: inline-flex;
   align-items: center;
   gap: 4px;
@@ -1628,33 +1628,33 @@ img[data-v-c95b2073] {
   color: var(--sd-ui-comments-resolved-text, #00853d);
   margin-bottom: 4px;
 }
-.resolved-badge__icon[data-v-bc46ac97] {
+.resolved-badge__icon[data-v-eefd4750] {
   display: inline-flex;
   width: 12px;
   height: 12px;
 }
-.resolved-badge__icon[data-v-bc46ac97] svg {
+.resolved-badge__icon[data-v-eefd4750] svg {
   width: 100%;
   height: 100%;
   fill: currentColor;
 }
 
 /* ── Text truncation ── */
-.comment.is-truncated[data-v-bc46ac97],
-.tracked-change.is-truncated[data-v-bc46ac97] {
+.comment.is-truncated[data-v-eefd4750],
+.tracked-change.is-truncated[data-v-eefd4750] {
   display: -webkit-box;
   -webkit-line-clamp: 3;
   -webkit-box-orient: vertical;
   max-height: 4.5em;
   overflow: hidden;
 }
-.comment.is-scrollable[data-v-bc46ac97],
-.tracked-change.is-scrollable[data-v-bc46ac97] {
+.comment.is-scrollable[data-v-eefd4750],
+.tracked-change.is-scrollable[data-v-eefd4750] {
   max-height: 220px;
   overflow-y: auto;
   padding-right: 4px;
 }
-.show-more-toggle[data-v-bc46ac97] {
+.show-more-toggle[data-v-eefd4750] {
   font-size: 12px;
   color: var(--sd-ui-action, #1355ff);
   cursor: pointer;
@@ -1662,12 +1662,12 @@ img[data-v-c95b2073] {
   margin-top: 4px;
   user-select: none;
 }
-.show-more-toggle[data-v-bc46ac97]:hover {
+.show-more-toggle[data-v-eefd4750]:hover {
   text-decoration: underline;
 }
 
 /* ── Thread collapse ── */
-.collapsed-replies[data-v-bc46ac97] {
+.collapsed-replies[data-v-eefd4750] {
   display: flex;
   align-items: center;
   gap: 6px;
@@ -1678,24 +1678,24 @@ img[data-v-c95b2073] {
   cursor: pointer;
   user-select: none;
 }
-.collapsed-replies[data-v-bc46ac97]:hover {
+.collapsed-replies[data-v-eefd4750]:hover {
   text-decoration: underline;
 }
-.collapsed-avatars[data-v-bc46ac97] {
+.collapsed-avatars[data-v-eefd4750] {
   display: flex;
 }
-.collapsed-avatars .mini-avatar[data-v-bc46ac97] {
+.collapsed-avatars .mini-avatar[data-v-eefd4750] {
   --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-bc46ac97]:first-child {
+.collapsed-avatars .mini-avatar[data-v-eefd4750]:first-child {
   margin-left: 0;
 }
 
 /* ── New comment input ── */
-.new-comment-input-wrapper[data-v-bc46ac97] {
+.new-comment-input-wrapper[data-v-eefd4750] {
   border: 1.5px solid var(--sd-ui-comments-input-border, #dbdbdb);
   border-radius: 12px;
   padding: 8.5px 10.5px;
@@ -1704,17 +1704,17 @@ img[data-v-c95b2073] {
   max-height: 150px;
   overflow: visible;
 }
-.new-comment-input-wrapper[data-v-bc46ac97]:focus-within {
+.new-comment-input-wrapper[data-v-eefd4750]: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-bc46ac97] .comment-entry {
+.new-comment-input-wrapper[data-v-eefd4750] .comment-entry {
   border-radius: 0;
 }
-.new-comment-input-wrapper[data-v-bc46ac97] .input-section {
+.new-comment-input-wrapper[data-v-eefd4750] .input-section {
   margin: 0;
 }
-.new-comment-input-wrapper[data-v-bc46ac97] .superdoc-field {
+.new-comment-input-wrapper[data-v-eefd4750] .superdoc-field {
   font-size: 14px;
   line-height: 20px;
   border: none;
@@ -1725,18 +1725,18 @@ img[data-v-c95b2073] {
   max-height: 132px;
   resize: none;
 }
-.new-comment-input-wrapper[data-v-bc46ac97] .superdoc-field:focus,
-.new-comment-input-wrapper[data-v-bc46ac97] .superdoc-field:active {
+.new-comment-input-wrapper[data-v-eefd4750] .superdoc-field:focus,
+.new-comment-input-wrapper[data-v-eefd4750] .superdoc-field:active {
   border: none;
   box-shadow: none;
   outline: none;
 }
-.new-comment-input-wrapper[data-v-bc46ac97] .sd-editor-placeholder::before {
+.new-comment-input-wrapper[data-v-eefd4750] .sd-editor-placeholder::before {
   content: 'Comment or add others with @';
 }
 
 /* ── Reply pill & expanded input ── */
-.reply-pill[data-v-bc46ac97] {
+.reply-pill[data-v-eefd4750] {
   width: 100%;
   padding: 8.5px 10.5px;
   border: 1.5px solid transparent;
@@ -1750,16 +1750,16 @@ img[data-v-c95b2073] {
   cursor: text;
   transition: background 150ms ease;
 }
-.reply-pill[data-v-bc46ac97]:hover {
+.reply-pill[data-v-eefd4750]:hover {
   background: var(--sd-color-gray-200, #f2f2f2);
 }
-.reply-pill[data-v-bc46ac97]:disabled {
+.reply-pill[data-v-eefd4750]:disabled {
   cursor: not-allowed;
 }
-.reply-expanded[data-v-bc46ac97] {
+.reply-expanded[data-v-eefd4750] {
   margin-top: 10px;
 }
-.reply-input-wrapper[data-v-bc46ac97] {
+.reply-input-wrapper[data-v-eefd4750] {
   border: 1.5px solid var(--sd-ui-comments-input-border, #dbdbdb);
   border-radius: 12px;
   padding: 8.5px 10.5px;
@@ -1767,17 +1767,17 @@ img[data-v-c95b2073] {
   max-height: 150px;
   overflow: visible;
 }
-.reply-input-wrapper[data-v-bc46ac97]:focus-within {
+.reply-input-wrapper[data-v-eefd4750]: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-bc46ac97] .comment-entry {
+.reply-input-wrapper[data-v-eefd4750] .comment-entry {
   border-radius: 0;
 }
-.reply-input-wrapper[data-v-bc46ac97] .input-section {
+.reply-input-wrapper[data-v-eefd4750] .input-section {
   margin: 0;
 }
-.reply-input-wrapper[data-v-bc46ac97] .superdoc-field {
+.reply-input-wrapper[data-v-eefd4750] .superdoc-field {
   font-size: 14px;
   line-height: 20px;
   border: none;
@@ -1788,23 +1788,23 @@ img[data-v-c95b2073] {
   max-height: 132px;
   resize: none;
 }
-.reply-input-wrapper[data-v-bc46ac97] .superdoc-field:focus,
-.reply-input-wrapper[data-v-bc46ac97] .superdoc-field:active {
+.reply-input-wrapper[data-v-eefd4750] .superdoc-field:focus,
+.reply-input-wrapper[data-v-eefd4750] .superdoc-field:active {
   border: none;
   box-shadow: none;
   outline: none;
 }
-.reply-input-wrapper[data-v-bc46ac97] .sd-editor-placeholder::before {
+.reply-input-wrapper[data-v-eefd4750] .sd-editor-placeholder::before {
   content: 'Reply or add others with @';
 }
-.reply-actions[data-v-bc46ac97] {
+.reply-actions[data-v-eefd4750] {
   display: flex;
   justify-content: flex-end;
   align-items: center;
   gap: 16px;
   margin-top: 8px;
 }
-.reply-btn-cancel[data-v-bc46ac97] {
+.reply-btn-cancel[data-v-eefd4750] {
   background: none;
   border: none;
   font-size: 13px;
@@ -1815,10 +1815,10 @@ img[data-v-c95b2073] {
   font-family: inherit;
   transition: color 150ms;
 }
-.reply-btn-cancel[data-v-bc46ac97]:hover {
+.reply-btn-cancel[data-v-eefd4750]:hover {
   color: var(--sd-ui-text, #212121);
 }
-.reply-btn-primary[data-v-bc46ac97] {
+.reply-btn-primary[data-v-eefd4750] {
   background: var(--sd-ui-action, #1355ff);
   border: none;
   font-size: 13px;
@@ -1830,19 +1830,19 @@ img[data-v-c95b2073] {
   font-family: inherit;
   transition: background 150ms;
 }
-.reply-btn-primary[data-v-bc46ac97]:hover {
+.reply-btn-primary[data-v-eefd4750]:hover {
   background: var(--sd-ui-action-hover, #0f44cc);
 }
-.reply-btn-primary.sd-is-disabled[data-v-bc46ac97] {
+.reply-btn-primary.sd-is-disabled[data-v-eefd4750] {
   background: var(--sd-color-gray-400, #dbdbdb);
   color: var(--sd-color-gray-600, #888888);
   cursor: default;
   pointer-events: none;
 }
-.existing-internal-input[data-v-bc46ac97] {
+.existing-internal-input[data-v-eefd4750] {
   margin-bottom: 10px;
 }
-.sd-internal-dropdown[data-v-bc46ac97] {
+.sd-internal-dropdown[data-v-eefd4750] {
   display: inline-block;
 }
 
@@ -2854,7 +2854,7 @@ img[data-v-c95b2073] {
   flex-wrap: wrap;
 }
 
-.sd-font-combobox[data-v-53e0af20] {
+.sd-font-combobox[data-v-e288ef9f] {
   display: inline-flex;
   align-items: center;
   height: var(--sd-ui-toolbar-height, 32px);
@@ -2867,22 +2867,22 @@ img[data-v-c95b2073] {
   transition: background-color 0.2s ease-out;
   position: relative;
 }
-.sd-font-combobox[data-v-53e0af20]:focus-within {
+.sd-font-combobox[data-v-e288ef9f]:focus-within {
   background-color: var(--sd-ui-toolbar-button-active-bg, var(--sd-ui-active-bg, #c8d0d8));
 }
-.sd-font-combobox.high-contrast[data-v-53e0af20]:focus-within {
+.sd-font-combobox.high-contrast[data-v-e288ef9f]:focus-within {
   background-color: #000;
   color: #fff;
 }
-.sd-font-combobox.sd-disabled[data-v-53e0af20] {
+.sd-font-combobox.sd-disabled[data-v-e288ef9f] {
   cursor: default;
   opacity: 0.35;
 }
-.sd-font-combobox__field[data-v-53e0af20] {
+.sd-font-combobox__field[data-v-e288ef9f] {
   flex: 1 1 auto;
   min-width: 0;
 }
-.sd-font-combobox__input[data-v-53e0af20] {
+.sd-font-combobox__input[data-v-e288ef9f] {
   width: 100%;
   min-width: 0;
   height: 100%;
@@ -2896,7 +2896,7 @@ img[data-v-c95b2073] {
   text-overflow: ellipsis;
   box-sizing: border-box;
 }
-.sd-font-combobox__legacy-label[data-v-53e0af20] {
+.sd-font-combobox__legacy-label[data-v-e288ef9f] {
   position: absolute;
   width: 1px;
   height: 1px;
@@ -2904,7 +2904,7 @@ img[data-v-c95b2073] {
   clip: rect(0 0 0 0);
   white-space: nowrap;
 }
-.sd-font-combobox__caret[data-v-53e0af20] {
+.sd-font-combobox__caret[data-v-e288ef9f] {
   flex-shrink: 0;
   margin: 0;
   border: none;
@@ -2913,17 +2913,17 @@ img[data-v-c95b2073] {
   cursor: pointer;
   color: inherit;
 }
-.sd-font-combobox.sd-disabled .sd-font-combobox__caret[data-v-53e0af20] {
+.sd-font-combobox.sd-disabled .sd-font-combobox__caret[data-v-e288ef9f] {
   cursor: default;
 }
-.sd-dropdown-caret[data-v-53e0af20] {
+.sd-dropdown-caret[data-v-e288ef9f] {
   display: inline-flex;
   align-items: center;
   justify-content: center;
   width: 10px;
   height: 10px;
 }
-.sd-font-combobox__listbox[data-v-53e0af20] {
+.sd-font-combobox__listbox[data-v-e288ef9f] {
   min-width: 80px;
   padding: 4px;
   border-radius: var(--sd-ui-radius, 6px);
@@ -2934,7 +2934,7 @@ img[data-v-c95b2073] {
   overflow-y: auto;
   overscroll-behavior: contain;
 }
-.sd-font-combobox__option[data-v-53e0af20] {
+.sd-font-combobox__option[data-v-e288ef9f] {
   min-height: 34px;
   display: flex;
   align-items: center;
@@ -2946,18 +2946,18 @@ img[data-v-c95b2073] {
   transition: background-color 0.2s ease-out;
   box-sizing: border-box;
 }
-.sd-font-combobox__option.sd-active[data-v-53e0af20],
-.sd-font-combobox__option[data-v-53e0af20]:hover {
+.sd-font-combobox__option.sd-active[data-v-e288ef9f],
+.sd-font-combobox__option[data-v-e288ef9f]:hover {
   background: var(--sd-ui-dropdown-hover-bg, #d8dee5);
   color: var(--sd-ui-dropdown-hover-text, #47484a);
 }
-.sd-font-combobox__option.sd-selected[data-v-53e0af20] {
+.sd-font-combobox__option.sd-selected[data-v-e288ef9f] {
   background: var(--sd-ui-dropdown-active-bg, #d8dee5);
   color: var(--sd-ui-dropdown-selected-text, #47484a);
 }
-.sd-font-combobox__listbox.high-contrast .sd-font-combobox__option.sd-active[data-v-53e0af20],
-.sd-font-combobox__listbox.high-contrast .sd-font-combobox__option[data-v-53e0af20]:hover,
-.sd-font-combobox__listbox.high-contrast .sd-font-combobox__option.sd-selected[data-v-53e0af20] {
+.sd-font-combobox__listbox.high-contrast .sd-font-combobox__option.sd-active[data-v-e288ef9f],
+.sd-font-combobox__listbox.high-contrast .sd-font-combobox__option[data-v-e288ef9f]:hover,
+.sd-font-combobox__listbox.high-contrast .sd-font-combobox__option.sd-selected[data-v-e288ef9f] {
   background: #000;
   color: #fff;
 }

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

@@ -163,7 +163,7 @@ export interface FontSizeOption {
 }
 /** Observable enable/active state for a toolbar-style command. */
 export interface CommandState {
-    /** The command can run against the current selection / mode. */
+    /** Availability for a control in the current selection / mode snapshot. */
     enabled: boolean;
     /** Compatibility inverse of `enabled` for demo code that models commands as disabled. */
     disabled?: boolean;
@@ -278,9 +278,10 @@ export type SuperDocUIReceipt = Receipt | SuperDocUIFailureReceipt | PartialLink
  * preserves the public Document API facade result (or a controller-minted
  * failure), including read-only / unsupported failures and mutation effects.
  * `true` is returned for legacy command handlers that do not produce a
- * structured result, or when the host reports only that an async browser
- * operation was scheduled. Use `executeAsync(...)` to await the settled result
- * when the browser Document API / host runs asynchronously.
+ * structured result, including accepted no-ops, or when the host reports only
+ * that an async browser operation was scheduled. Use `executeAsync(...)` to await the settled result
+ * when the browser Document API / host runs asynchronously. A settled `true`
+ * does not guarantee a document mutation, such as Undo with an empty history.
  */
 export type CommandExecutionResult = boolean | SuperDocUIReceipt;
 /**
@@ -333,16 +334,18 @@ export interface CommandHandle<Id extends CommandId = CommandId> {
     observe(listener: (state: CommandState) => void): () => void;
     /**
      * Run the command. Returns the Document API receipt when the host facade
-     * provides one, or `false` for unsupported / disabled commands rather than
-     * throwing. When the browser operation settles asynchronously this returns
-     * the immediate routed result (`true` or a sync receipt); use
+     * provides one, or `false` when routing or current execution prerequisites
+     * are unavailable rather than throwing. When the browser operation settles
+     * asynchronously this returns the immediate routed result (`true` or a sync receipt); use
      * `executeAsync(...)` to await settlement.
      */
     execute(payload?: unknown): CommandExecutionResult;
     /**
      * Run the command and resolve once the routed operation has settled. On
      * browser-backed hosts this includes the post-mutation paint observation
-     * boundary when available.
+     * boundary when available. Selection-dependent commands may refresh stale
+     * selection state before execution. A settled `true` can be an accepted
+     * no-op and does not guarantee a document mutation.
      */
     executeAsync(payload?: unknown): Promise<CommandExecutionResult>;
 }