superdoc 2.4.0-next.4 → 2.4.0-next.41

package/dist/superdoc/src/core/v2-integration/v2-integration.d.ts

@@ -55,7 +55,7 @@ export function hasRealV2Integration(integration: SuperDocV2Integration | null |
  * @property {unknown} EditorComponent Vue component that boots the V2 DOCX editor.
  * @property {unknown} [RulerComponent] Optional Vue component for the V2 ruler.
  * @property {(...args: unknown[]) => unknown} [createGeometryPublisher] Factory for the V2 geometry publisher.
- * @property {(...args: unknown[]) => unknown} [createReviewHydrationController] Factory for the V2 review-row hydration controller.
+ * @property {(...args: unknown[]) => unknown} [createReviewWindowController] Factory for the committed V2 review-window controller.
  * @property {(value: unknown) => boolean} [isSyntheticTrackedChangeCommentLaneItem] Predicate for synthetic tracked-change comment-lane items.
  * @property {(value: unknown) => boolean} [isV2SyntheticTrackedChangeRow] Predicate for synthesized V2 tracked-change rows.
  */
@@ -83,9 +83,9 @@ export type SuperDocV2Integration = {
      */
     createGeometryPublisher?: ((...args: unknown[]) => unknown) | undefined;
     /**
-     * Factory for the V2 review-row hydration controller.
+     * Factory for the committed V2 review-window controller.
      */
-    createReviewHydrationController?: ((...args: unknown[]) => unknown) | undefined;
+    createReviewWindowController?: ((...args: unknown[]) => unknown) | undefined;
     /**
      * Predicate for synthetic tracked-change comment-lane items.
      */

package/dist/superdoc/src/helpers/comment-small-screen.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Whether a context-menu event landed inside the tracked-change carrier that
+ * is already visually active. The review visual owner maintains this marker,
+ * so the right-click path can stay synchronous and avoid a catalog lookup or
+ * document-wide DOM query.
+ *
+ * @param {EventTarget | null} target
+ * @returns {boolean}
+ */
+export function isActiveTrackedChangeContextMenuTarget(target: EventTarget | null): boolean;
 /**
  * Normalize adaptive comments UI policy fields.
  *

package/dist/superdoc/src/helpers/v2-review-mutation-impact.d.ts

@@ -2,11 +2,9 @@
  * Classify the tracked-change identities carried by a v2 mutation event.
  *
  * Receipt entities are the durable invalidation contract between the document
- * kernel and derived review UI. Consumers can refresh `upsertIds` narrowly via
- * `trackChanges.get(...)`, drop `removedIds` immediately, and leave a bounded
- * full-list reconciliation as background verification. History results are
- * different: undo/redo can restore many identities at once, so consumers use
- * one authoritative catalog after render instead of issuing one read per id.
+ * kernel and derived review UI. Consumers apply removals/remaps locally; the
+ * next committed window supplies surviving or restored rows. History follows
+ * the same bounded path and never enumerates invisible review identities.
  */
 export function getV2TrackedChangeMutationImpact(event: any): {
     allResolved?: any;

package/dist/superdoc/src/internal/toolbar/built-in/ToolbarButton.vue.d.ts

@@ -1,20 +1,20 @@
 declare const _default: import('vue').DefineComponent<{}, {
     $emit: (event: "buttonClick" | "textSubmit" | "mainClick", ...args: any[]) => void;
     active: boolean;
-    iconColor: string;
     isNarrow: boolean;
     isWide: boolean;
-    toolbarItem: Record<string, any>;
     defaultLabel: string;
+    iconColor: string;
+    toolbarItem: Record<string, any>;
     isOverflowItem: boolean;
     allowEnterPropagation: boolean;
     $props: {
         readonly active?: boolean | undefined;
-        readonly iconColor?: string | undefined;
         readonly isNarrow?: boolean | undefined;
         readonly isWide?: boolean | undefined;
-        readonly toolbarItem?: Record<string, any> | undefined;
         readonly defaultLabel?: string | undefined;
+        readonly iconColor?: string | undefined;
+        readonly toolbarItem?: Record<string, any> | undefined;
         readonly isOverflowItem?: boolean | undefined;
         readonly allowEnterPropagation?: boolean | undefined;
     };

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

@@ -187,6 +187,17 @@ export class BuiltInToolbar extends EventEmitter<string | symbol, any> {
     _detachFormatPainterModeChange: any;
     /** Registered custom-button command unregister handles. */
     _customCommandRegs: Map<any, any>;
+    /**
+     * Custom entries already reported as unbuildable.
+     *
+     * `#makeToolbarItems` runs on every throttled resize and on font or
+     * active-editor changes, not only at construction, so a single static
+     * configuration error would otherwise fire `exception` once per rebuild --
+     * unbounded, into consumer telemetry, for a mistake that cannot change
+     * without a reconfigure. Keyed by name plus message so a different fault
+     * on the same entry still reports once.
+     */
+    _reportedInvalidCustomItems: Set<any>;
     /** Signature of the last-built font options, to skip redundant rebuilds. */
     _lastFontOptionsSignature: string;
     app: import('vue').App<Element> | undefined;

package/dist/superdoc/src/internal/toolbar/compatibility-catalog.d.ts

@@ -36,7 +36,7 @@ export interface BuiltInToolbarItemEntry {
  * docs present them; it is documentation-only.
  *
  * Every documented `Available buttons` entry from
- * `apps/docs/editor/built-in-ui/toolbar.mdx` appears here exactly once, plus the
+ * the built-in UI documentation appears here exactly once, plus the
  * `customButtons` shell concept.
  */
 export declare const BUILT_IN_TOOLBAR_CATALOG: readonly BuiltInToolbarItemEntry[];

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

@@ -9,10 +9,12 @@ import type { BorrowedSuperDocUI as __Cjs_BorrowedSuperDocUI } from './index.js'
 import type { CanPerformPermissionParams as __Cjs_CanPerformPermissionParams } from './index.js' with { "resolution-mode": "import" };
 import type { CollaborationConfig as __Cjs_CollaborationConfig } from './index.js' with { "resolution-mode": "import" };
 import type { CommentAddress as __Cjs_CommentAddress } from './index.js' with { "resolution-mode": "import" };
+import type { CommentsConfig as __Cjs_CommentsConfig } from './index.js' with { "resolution-mode": "import" };
 import type { CommentsType as __Cjs_CommentsType } from './index.js' with { "resolution-mode": "import" };
 import type { Config as __Cjs_Config } from './index.js' with { "resolution-mode": "import" };
 import type { ContentControlActiveChangePayload as __Cjs_ContentControlActiveChangePayload } from './index.js' with { "resolution-mode": "import" };
 import type { ContentControlClickPayload as __Cjs_ContentControlClickPayload } from './index.js' with { "resolution-mode": "import" };
+import type { ContentControlsConfig as __Cjs_ContentControlsConfig } from './index.js' with { "resolution-mode": "import" };
 import type { ContextMenuConfig as __Cjs_ContextMenuConfig } from './index.js' with { "resolution-mode": "import" };
 import type { ContextMenuContext as __Cjs_ContextMenuContext } from './index.js' with { "resolution-mode": "import" };
 import type { ContextMenuItem as __Cjs_ContextMenuItem } from './index.js' with { "resolution-mode": "import" };
@@ -49,6 +51,7 @@ import type { LayoutFragment as __Cjs_LayoutFragment } from './index.js' with {
 import type { LayoutMetrics as __Cjs_LayoutMetrics } from './index.js' with { "resolution-mode": "import" };
 import type { LayoutMode as __Cjs_LayoutMode } from './index.js' with { "resolution-mode": "import" };
 import type { LayoutPage as __Cjs_LayoutPage } from './index.js' with { "resolution-mode": "import" };
+import type { LinkPopoverConfig as __Cjs_LinkPopoverConfig } from './index.js' with { "resolution-mode": "import" };
 import type { LinkPopoverContext as __Cjs_LinkPopoverContext } from './index.js' with { "resolution-mode": "import" };
 import type { LinkPopoverResolution as __Cjs_LinkPopoverResolution } from './index.js' with { "resolution-mode": "import" };
 import type { LinkPopoverResolver as __Cjs_LinkPopoverResolver } from './index.js' with { "resolution-mode": "import" };
@@ -96,6 +99,7 @@ import type { SuperDocExceptionEditorPayload as __Cjs_SuperDocExceptionEditorPay
 import type { SuperDocExceptionPayload as __Cjs_SuperDocExceptionPayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExceptionRestorePayload as __Cjs_SuperDocExceptionRestorePayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExceptionStorePayload as __Cjs_SuperDocExceptionStorePayload } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocExceptionToolbarPayload as __Cjs_SuperDocExceptionToolbarPayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExtension as __Cjs_SuperDocExtension } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExtensionActivateReturn as __Cjs_SuperDocExtensionActivateReturn } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocExtensionCapabilities as __Cjs_SuperDocExtensionCapabilities } from './index.js' with { "resolution-mode": "import" };
@@ -118,6 +122,9 @@ import type { SuperDocFontsApi as __Cjs_SuperDocFontsApi } from './index.js' wit
 import type { SuperDocGuardedDoc as __Cjs_SuperDocGuardedDoc } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocGuardedDocQuery as __Cjs_SuperDocGuardedDocQuery } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocGuardedDocSelection as __Cjs_SuperDocGuardedDocSelection } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocInlineBoxAppearance as __Cjs_SuperDocInlineBoxAppearance } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocInlineBoxLayout as __Cjs_SuperDocInlineBoxLayout } from './index.js' with { "resolution-mode": "import" };
+import type { SuperDocInlineBoxOptions as __Cjs_SuperDocInlineBoxOptions } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocLayoutEngineOptions as __Cjs_SuperDocLayoutEngineOptions } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocLockedPayload as __Cjs_SuperDocLockedPayload } from './index.js' with { "resolution-mode": "import" };
 import type { SuperDocMeasurementUnit as __Cjs_SuperDocMeasurementUnit } from './index.js' with { "resolution-mode": "import" };
@@ -163,7 +170,14 @@ import type { SurfacesModuleConfig as __Cjs_SurfacesModuleConfig } from './index
 import type { TextAddress as __Cjs_TextAddress } from './index.js' with { "resolution-mode": "import" };
 import type { TextSegment as __Cjs_TextSegment } from './index.js' with { "resolution-mode": "import" };
 import type { TextTarget as __Cjs_TextTarget } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomButton as __Cjs_ToolbarCustomButton } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomButtonContext as __Cjs_ToolbarCustomButtonContext } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomButtonItem as __Cjs_ToolbarCustomButtonItem } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomDropdownItem as __Cjs_ToolbarCustomDropdownItem } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomDropdownOption as __Cjs_ToolbarCustomDropdownOption } from './index.js' with { "resolution-mode": "import" };
+import type { ToolbarCustomSeparatorItem as __Cjs_ToolbarCustomSeparatorItem } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangeAuthor as __Cjs_TrackChangeAuthor } from './index.js' with { "resolution-mode": "import" };
+import type { TrackChangeHighlightColors as __Cjs_TrackChangeHighlightColors } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangesAuthorColorsConfig as __Cjs_TrackChangesAuthorColorsConfig } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangesModuleConfig as __Cjs_TrackChangesModuleConfig } from './index.js' with { "resolution-mode": "import" };
 import type { TrackChangesSemanticColorsConfig as __Cjs_TrackChangesSemanticColorsConfig } from './index.js' with { "resolution-mode": "import" };
@@ -188,11 +202,13 @@ export declare const buildTheme: typeof import('./index.js', { with: { "resoluti
 export type { __Cjs_CanPerformPermissionParams as CanPerformPermissionParams };
 export type { __Cjs_CollaborationConfig as CollaborationConfig };
 export type { __Cjs_CommentAddress as CommentAddress };
+export type { __Cjs_CommentsConfig as CommentsConfig };
 export type { __Cjs_CommentsType as CommentsType };
 export declare const compareVersions: typeof import('./index.js', { with: { "resolution-mode": "import" } }).compareVersions;
 export type { __Cjs_Config as Config };
 export type { __Cjs_ContentControlActiveChangePayload as ContentControlActiveChangePayload };
 export type { __Cjs_ContentControlClickPayload as ContentControlClickPayload };
+export type { __Cjs_ContentControlsConfig as ContentControlsConfig };
 export type { __Cjs_ContextMenuConfig as ContextMenuConfig };
 export type { __Cjs_ContextMenuContext as ContextMenuContext };
 export type { __Cjs_ContextMenuItem as ContextMenuItem };
@@ -234,6 +250,7 @@ export type { __Cjs_LayoutFragment as LayoutFragment };
 export type { __Cjs_LayoutMetrics as LayoutMetrics };
 export type { __Cjs_LayoutMode as LayoutMode };
 export type { __Cjs_LayoutPage as LayoutPage };
+export type { __Cjs_LinkPopoverConfig as LinkPopoverConfig };
 export type { __Cjs_LinkPopoverContext as LinkPopoverContext };
 export type { __Cjs_LinkPopoverResolution as LinkPopoverResolution };
 export type { __Cjs_LinkPopoverResolver as LinkPopoverResolver };
@@ -283,6 +300,7 @@ export type { __Cjs_SuperDocExceptionEditorPayload as SuperDocExceptionEditorPay
 export type { __Cjs_SuperDocExceptionPayload as SuperDocExceptionPayload };
 export type { __Cjs_SuperDocExceptionRestorePayload as SuperDocExceptionRestorePayload };
 export type { __Cjs_SuperDocExceptionStorePayload as SuperDocExceptionStorePayload };
+export type { __Cjs_SuperDocExceptionToolbarPayload as SuperDocExceptionToolbarPayload };
 export type { __Cjs_SuperDocExtension as SuperDocExtension };
 export type { __Cjs_SuperDocExtensionActivateReturn as SuperDocExtensionActivateReturn };
 export type { __Cjs_SuperDocExtensionCapabilities as SuperDocExtensionCapabilities };
@@ -305,6 +323,9 @@ export type { __Cjs_SuperDocFontsApi as SuperDocFontsApi };
 export type { __Cjs_SuperDocGuardedDoc as SuperDocGuardedDoc };
 export type { __Cjs_SuperDocGuardedDocQuery as SuperDocGuardedDocQuery };
 export type { __Cjs_SuperDocGuardedDocSelection as SuperDocGuardedDocSelection };
+export type { __Cjs_SuperDocInlineBoxAppearance as SuperDocInlineBoxAppearance };
+export type { __Cjs_SuperDocInlineBoxLayout as SuperDocInlineBoxLayout };
+export type { __Cjs_SuperDocInlineBoxOptions as SuperDocInlineBoxOptions };
 export type { __Cjs_SuperDocLayoutEngineOptions as SuperDocLayoutEngineOptions };
 export type { __Cjs_SuperDocLockedPayload as SuperDocLockedPayload };
 export type { __Cjs_SuperDocMeasurementUnit as SuperDocMeasurementUnit };
@@ -350,7 +371,14 @@ export type { __Cjs_SurfacesModuleConfig as SurfacesModuleConfig };
 export type { __Cjs_TextAddress as TextAddress };
 export type { __Cjs_TextSegment as TextSegment };
 export type { __Cjs_TextTarget as TextTarget };
+export type { __Cjs_ToolbarCustomButton as ToolbarCustomButton };
+export type { __Cjs_ToolbarCustomButtonContext as ToolbarCustomButtonContext };
+export type { __Cjs_ToolbarCustomButtonItem as ToolbarCustomButtonItem };
+export type { __Cjs_ToolbarCustomDropdownItem as ToolbarCustomDropdownItem };
+export type { __Cjs_ToolbarCustomDropdownOption as ToolbarCustomDropdownOption };
+export type { __Cjs_ToolbarCustomSeparatorItem as ToolbarCustomSeparatorItem };
 export type { __Cjs_TrackChangeAuthor as TrackChangeAuthor };
+export type { __Cjs_TrackChangeHighlightColors as TrackChangeHighlightColors };
 export type { __Cjs_TrackChangesAuthorColorsConfig as TrackChangesAuthorColorsConfig };
 export type { __Cjs_TrackChangesModuleConfig as TrackChangesModuleConfig };
 export type { __Cjs_TrackChangesSemanticColorsConfig as TrackChangesSemanticColorsConfig };

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

@@ -62,6 +62,7 @@ export type { SuperDocAwarenessUpdatePayload } from '../core/types/index.js';
 export type { SuperDocCommentsUpdatePayload } from '../core/types/index.js';
 export type { SuperDocEditorPayload } from '../core/types/index.js';
 export type { SuperDocExceptionEditorPayload } from '../core/types/index.js';
+export type { SuperDocExceptionToolbarPayload } from '../core/types/index.js';
 export type { SuperDocExceptionPayload } from '../core/types/index.js';
 export type { SuperDocExceptionRestorePayload } from '../core/types/index.js';
 export type { SuperDocExceptionStorePayload } from '../core/types/index.js';
@@ -72,6 +73,16 @@ export type { SuperDocLayoutEngineOptions as LayoutEngineOptions } from '../core
 export type { FlowBlock, FlowMode, Layout, Fragment as LayoutFragment, Page as LayoutPage } from '../../../layout-engine/contracts/src/index.js';
 export type { LayoutMetrics } from '../../../layout-engine/layout-bridge/src/index.js';
 export type { LayoutMode } from '../../../layout-engine/painters/dom/src/index.js';
+export type { CommentsConfig } from '../core/types/index.js';
+export type { TrackChangeHighlightColors } from '../core/types/index.js';
+export type { ContentControlsConfig } from '../core/types/index.js';
+export type { ToolbarCustomButton } from '../core/types/index.js';
+export type { ToolbarCustomButtonItem } from '../core/types/index.js';
+export type { ToolbarCustomDropdownItem } from '../core/types/index.js';
+export type { ToolbarCustomDropdownOption } from '../core/types/index.js';
+export type { ToolbarCustomSeparatorItem } from '../core/types/index.js';
+export type { ToolbarCustomButtonContext } from '../core/types/index.js';
+export type { LinkPopoverConfig } from '../core/types/index.js';
 export type { LinkPopoverContext } from '../core/types/index.js';
 export type { LinkPopoverResolution } from '../core/types/index.js';
 export type { LinkPopoverResolver } from '../core/types/index.js';
@@ -154,6 +165,9 @@ export type { SuperDocExtensionStorage } from '../core/extensions/index.js';
 export type { SuperDocGuardedDoc } from '../core/extensions/index.js';
 export type { SuperDocGuardedDocQuery } from '../core/extensions/index.js';
 export type { SuperDocGuardedDocSelection } from '../core/extensions/index.js';
+export type { SuperDocInlineBoxAppearance } from '../core/extensions/index.js';
+export type { SuperDocInlineBoxLayout } from '../core/extensions/index.js';
+export type { SuperDocInlineBoxOptions } from '../core/extensions/index.js';
 export type { SuperDocMutationAffect } from '../core/extensions/index.js';
 export type { SuperDocMutationEvent } from '../core/extensions/index.js';
 export type { SuperDocMutationFilter } from '../core/extensions/index.js';

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

@@ -356,14 +356,14 @@ export interface ContextMenuItem {
     invoke(): CommandExecutionResult;
 }
 export interface ViewportEntityHit {
-    type: string;
+    type: 'trackedChange' | 'comment' | 'contentControl' | 'citation' | (string & {});
     id: string;
     tag?: string;
     scope?: 'block' | 'inline';
     /**
      * Painted story locator for a tracked-change hit. Meaningful only for
-     * `type: 'trackedChange'`; absent for body-only content and for comment /
-     * content-control hits. Lets point hit-testing disambiguate a tracked-change
+     * `type: 'trackedChange'`; absent for body-only content and for comment,
+     * content-control, and citation hits. Lets point hit-testing disambiguate a tracked-change
      * id that repeats across stories (body, footnote, header/footer, textbox) by
      * resolving to the occurrence actually under the point.
      */
@@ -831,13 +831,25 @@ export type CommentAnchorCapture = {
 };
 /** Comments handle. */
 export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
-    /** Read the current comments snapshot. */
+    /** Read the passive page-window snapshot without starting a document-wide read. Observers receive the complete directory separately. */
     getSnapshot(): CommentsSlice;
     /** List comments through the best-known controller/Document API state. */
     list(query?: CommentsListQuery): readonly CommentInfo[];
     /** Resolve a single comment by id from the best-known loaded state. */
     getById(commentId: string): CommentInfo | null;
-    /** Create a comment from a frozen selection capture. */
+    /**
+     * Create a comment from a frozen selection capture.
+     *
+     * A capture carrying neither `target` nor `selectionTarget` fails closed with
+     * the same `NO_SELECTION` receipt {@link createFromSelection} mints for an
+     * empty selection, because both describe the same user-visible mistake:
+     * commenting with nothing selected. A capture that *has* a target which no
+     * longer resolves is a different failure, and keeps the Document API's own
+     * receipt so the reason stays specific.
+     *
+     * `capturedAt` is provenance for the consumer, not an expiry. A capture stays
+     * usable while its target resolves; elapsed time alone never invalidates it.
+     */
     createFromCapture(capture: CommentAnchorCapture, input: {
         text: string;
     }): WorkflowReceipt;
@@ -853,6 +865,18 @@ export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
     reply(commentId: string, input: {
         text: string;
     }): WorkflowReceipt;
+    /**
+     * Replace a comment's body text through the Document API
+     * (`comments.patch({ commentId, text })`).
+     *
+     * Gated by the comments `readOnly` policy like every other comment write.
+     * `allowResolve` is deliberately NOT consulted: that policy forbids only the
+     * resolve/reopen transition, and an application that may not resolve threads
+     * can still let an author correct their own wording.
+     */
+    edit(commentId: string, input: {
+        text: string;
+    }): WorkflowReceipt;
     /** Mark a comment resolved. */
     resolve(commentId: string): WorkflowReceipt;
     /** Reopen a resolved comment. */
@@ -881,7 +905,7 @@ export interface CommentsHandle extends SnapshotSubscribable<CommentsSlice> {
 }
 /** Track-changes handle. */
 export interface TrackChangesHandle extends SnapshotSubscribable<TrackChangesSlice> {
-    /** Read the current track-changes snapshot. */
+    /** Read the passive page-window snapshot without starting a document-wide read. Observers receive the complete directory separately. */
     getSnapshot(): TrackChangesSlice;
     /** List tracked changes through the best-known controller state. */
     list(): readonly TrackChangesItem[];