superdoc 2.29.0-next.9 → 2.29.0

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

@@ -1,145 +1,78 @@
-import { default as rotateLeftIconSvg } from '../../../../../../shared/common/icons/rotate-left-solid.svg?raw';
-import { default as rotateRightIconSvg } from '../../../../../../shared/common/icons/rotate-right-solid.svg?raw';
-import { default as boldIconSvg } from '../../../../../../shared/common/icons/bold-solid.svg?raw';
-import { default as italicIconSvg } from '../../../../../../shared/common/icons/italic-solid.svg?raw';
-import { default as underlineIconSvg } from '../../../../../../shared/common/icons/underline-solid.svg?raw';
-import { default as fontIconSvg } from '../../../../../../shared/common/icons/font-solid.svg?raw';
-import { default as linkIconSvg } from '../../../../../../shared/common/icons/link-solid.svg?raw';
-import { default as imageIconSvg } from '../../../../../../shared/common/icons/image-solid.svg?raw';
-import { default as tocIconSvg } from '../../../../../../shared/common/icons/toc-solid.svg?raw';
-import { default as watermarkIconSvg } from '../../../../../../shared/common/icons/watermark.svg?raw';
-import { default as pageNumberIconSvg } from '../../../../../../shared/common/icons/page-number.svg?raw';
-import { default as alignLeftIconSvg } from '../../../../../../shared/common/icons/align-left-solid.svg?raw';
-import { default as alignRightIconSvg } from '../../../../../../shared/common/icons/align-right-solid.svg?raw';
-import { default as alignCenterIconSvg } from '../../../../../../shared/common/icons/align-center-solid.svg?raw';
-import { default as alignJustifyIconSvg } from '../../../../../../shared/common/icons/align-justify-solid.svg?raw';
-import { default as listIconSvg } from '../../../../../../shared/common/icons/list-solid.svg?raw';
-import { default as listCircleIconSvg } from '../../../../../../shared/common/icons/list-circle-solid.svg?raw';
-import { default as listSquareIconSvg } from '../../../../../../shared/common/icons/list-square-solid.svg?raw';
-import { default as listOlIconSvg } from '../../../../../../shared/common/icons/list-ol-solid.svg?raw';
-import { default as listDecimalIconSvg } from '../../../../../../shared/common/icons/list-decimal-solid.svg?raw';
-import { default as listDecimalParenIconSvg } from '../../../../../../shared/common/icons/list-decimal-paren-solid.svg?raw';
-import { default as listUpperRomanIconSvg } from '../../../../../../shared/common/icons/list-upper-roman-solid.svg?raw';
-import { default as listLowerRomanIconSvg } from '../../../../../../shared/common/icons/list-lower-roman-solid.svg?raw';
-import { default as listUpperAlphaIconSvg } from '../../../../../../shared/common/icons/list-upper-alpha-solid.svg?raw';
-import { default as listUpperAlphaParenIconSvg } from '../../../../../../shared/common/icons/list-upper-alpha-paren-solid.svg?raw';
-import { default as listLowerAlphaIconSvg } from '../../../../../../shared/common/icons/list-lower-alpha-solid.svg?raw';
-import { default as listLowerAlphaParenIconSvg } from '../../../../../../shared/common/icons/list-lower-alpha-paren-solid.svg?raw';
-import { default as outdentIconSvg } from '../../../../../../shared/common/icons/outdent-solid.svg?raw';
-import { default as indentIconSvg } from '../../../../../../shared/common/icons/indent-solid.svg?raw';
-import { default as paragraphLtrIconSvg } from '../../../../../../shared/common/icons/paragraph-ltr-solid.svg?raw';
-import { default as paragraphRtlIconSvg } from '../../../../../../shared/common/icons/paragraph-rtl-solid.svg?raw';
-import { default as fileHalfDashedIconSvg } from '../../../../../../shared/common/icons/file-half-dashed-solid.svg?raw';
-import { default as paintRollerIconSvg } from '../../../../../../shared/common/icons/paint-roller-solid.svg?raw';
-import { default as textSlashIconSvg } from '../../../../../../shared/common/icons/text-slash-solid.svg?raw';
-import { default as listCheckIconSvg } from '../../../../../../shared/common/icons/list-check-solid.svg?raw';
-import { default as fileIconSvg } from '../../../../../../shared/common/icons/file-solid.svg?raw';
-import { default as eyeIconSvg } from '../../../../../../shared/common/icons/eye-solid.svg?raw';
-import { default as calendarCheckIconSvg } from '../../../../../../shared/common/icons/calendar-check-solid.svg?raw';
-import { default as calendarXmarkIconSvg } from '../../../../../../shared/common/icons/calendar-xmark-solid.svg?raw';
-import { default as userEditIconSvg } from '../../../../../../shared/common/icons/user-edit-solid.svg?raw';
-import { default as commentIconSvg } from '../../../../../../shared/common/icons/comment-solid.svg?raw';
-import { default as circleIconSvg } from '../../../../../../shared/common/icons/circle-solid.svg?raw';
-import { default as checkIconSvg } from '../../../../../../shared/common/icons/check-solid.svg?raw';
-import { default as xmarkIconSvg } from '../../../../../../shared/common/icons/xmark-solid.svg?raw';
-import { default as upRightFromSquareIconSvg } from '../../../../../../shared/common/icons/up-right-from-square-solid.svg?raw';
-import { default as ellipsisVerticalIconSvg } from '../../../../../../shared/common/icons/ellipsis-vertical-solid.svg?raw';
-import { default as caretUpIconSvg } from '../../../../../../shared/common/icons/caret-up-solid.svg?raw';
-import { default as caretDownIconSvg } from '../../../../../../shared/common/icons/caret-down-solid.svg?raw';
-import { default as rulerSvg } from '../../../../../../shared/common/icons/ruler-solid.svg?raw';
-import { default as paintbrushSvg } from '../../../../../../shared/common/icons/paintbrush-solid.svg?raw';
-import { default as highlighterIcon } from '../../../../../../shared/common/icons/highlighter-icon.svg?raw';
-import { default as magicWandIcon } from '../../../../../../shared/common/icons/magic-wand-solid.svg?raw';
-import { default as tableIconSvg } from '../../../../../../shared/common/icons/table-solid.svg?raw';
-import { default as tableColumnsIconSvg } from '../../../../../../shared/common/icons/table-columns-solid.svg?raw';
-import { default as arrowsLeftRightIconSvg } from '../../../../../../shared/common/icons/arrows-left-right-solid.svg?raw';
-import { default as arrowsToDotIconSvg } from '../../../../../../shared/common/icons/arrows-to-dot-solid.svg?raw';
-import { default as plusIconSvg } from '../../../../../../shared/common/icons/plus-solid.svg?raw';
-import { default as trashIconSvg } from '../../../../../../shared/common/icons/trash-can-solid.svg?raw';
-import { default as borderNoneIconSvg } from '../../../../../../shared/common/icons/border-none-solid.svg?raw';
-import { default as wrenchIconSvg } from '../../../../../../shared/common/icons/wrench-solid.svg?raw';
-import { default as upDownIconSvg } from '../../../../../../shared/common/icons/up-down.svg?raw';
-import { default as magnifyingGlassSvg } from '../../../../../../shared/common/icons/magnifying-glass.svg?raw';
-import { default as scissorsIconSvg } from '../../../../../../shared/common/icons/scissors-solid.svg?raw';
-import { default as copyIconSvg } from '../../../../../../shared/common/icons/copy-solid.svg?raw';
-import { default as pasteIconSvg } from '../../../../../../shared/common/icons/paste-solid.svg?raw';
-import { default as strikethroughSvg } from '../../../../../../shared/common/icons/strikethrough.svg?raw';
-import { default as paragraphIconSvg } from '../../../../../../shared/common/icons/paragraph-solid.svg?raw';
-export namespace toolbarIcons {
-    export { rotateLeftIconSvg as undo };
-    export { rotateRightIconSvg as redo };
-    export { boldIconSvg as bold };
-    export { italicIconSvg as italic };
-    export { underlineIconSvg as underline };
-    export { fontIconSvg as color };
-    export { linkIconSvg as link };
-    export { imageIconSvg as image };
-    export { tocIconSvg as tableOfContents };
-    export { watermarkIconSvg as watermark };
-    export { pageNumberIconSvg as pageNumber };
-    export { alignLeftIconSvg as alignLeft };
-    export { alignRightIconSvg as alignRight };
-    export { alignCenterIconSvg as alignCenter };
-    export { alignJustifyIconSvg as alignJustify };
-    export { listIconSvg as bulletList };
-    export { listIconSvg as bulletListDisc };
-    export { listCircleIconSvg as bulletListCircle };
-    export { listSquareIconSvg as bulletListSquare };
-    export { listOlIconSvg as numberedList };
-    export { listDecimalIconSvg as numberedListDecimal };
-    export { listDecimalParenIconSvg as numberedListDecimalParen };
-    export { listUpperRomanIconSvg as numberedListUpperRoman };
-    export { listLowerRomanIconSvg as numberedListLowerRoman };
-    export { listUpperAlphaIconSvg as numberedListUpperAlpha };
-    export { listUpperAlphaParenIconSvg as numberedListUpperAlphaParen };
-    export { listLowerAlphaIconSvg as numberedListLowerAlpha };
-    export { listLowerAlphaParenIconSvg as numberedListLowerAlphaParen };
-    export { outdentIconSvg as indentLeft };
-    export { indentIconSvg as indentRight };
-    export { paragraphLtrIconSvg as directionLtr };
-    export { paragraphRtlIconSvg as directionRtl };
-    export { fileHalfDashedIconSvg as pageBreak };
-    export { paintRollerIconSvg as copyFormat };
-    export { textSlashIconSvg as clearFormatting };
-    export { listCheckIconSvg as trackChanges };
-    export { fileIconSvg as trackChangesFinal };
-    export { eyeIconSvg as trackChangesOriginal };
-    export { calendarCheckIconSvg as trackChangesAccept };
-    export { calendarXmarkIconSvg as trackChangesReject };
-    export { userEditIconSvg as documentMode };
-    export { userEditIconSvg as documentEditingMode };
-    export { commentIconSvg as documentSuggestingMode };
-    export { eyeIconSvg as documentViewingMode };
-    export { circleIconSvg as colorOption };
-    export { checkIconSvg as colorOptionCheck };
-    export { linkIconSvg as linkInput };
-    export { xmarkIconSvg as removeLink };
-    export { upRightFromSquareIconSvg as openLink };
-    export { ellipsisVerticalIconSvg as overflow };
-    export { caretUpIconSvg as dropdownCaretUp };
-    export { caretDownIconSvg as dropdownCaretDown };
-    export { rulerSvg as ruler };
-    export { paintbrushSvg as paintbrush };
-    export { highlighterIcon as highlight };
-    export { magicWandIcon as ai };
-    export { tableIconSvg as table };
-    export { tableColumnsIconSvg as tableActions };
-    export { arrowsLeftRightIconSvg as splitCell };
-    export { arrowsToDotIconSvg as mergeCells };
-    export { plusIconSvg as addRowBefore };
-    export { plusIconSvg as addRowAfter };
-    export { plusIconSvg as addColumnBefore };
-    export { plusIconSvg as addColumnAfter };
-    export { trashIconSvg as deleteRow };
-    export { trashIconSvg as deleteColumn };
-    export { trashIconSvg as deleteTable };
-    export { borderNoneIconSvg as deleteBorders };
-    export { wrenchIconSvg as fixTables };
-    export { upDownIconSvg as lineHeight };
-    export { magnifyingGlassSvg as search };
-    export { scissorsIconSvg as cut };
-    export { copyIconSvg as copy };
-    export { pasteIconSvg as paste };
-    export { strikethroughSvg as strikethrough };
-    export { paragraphIconSvg as formattingMarks };
-}
+export declare const toolbarIcons: {
+    undo: string;
+    redo: string;
+    bold: string;
+    italic: string;
+    underline: string;
+    color: string;
+    link: string;
+    image: string;
+    tableOfContents: string;
+    watermark: string;
+    pageNumber: string;
+    alignLeft: string;
+    alignRight: string;
+    alignCenter: string;
+    alignJustify: string;
+    bulletList: string;
+    bulletListDisc: string;
+    bulletListCircle: string;
+    bulletListSquare: string;
+    numberedList: string;
+    numberedListDecimal: string;
+    numberedListDecimalParen: string;
+    numberedListUpperRoman: string;
+    numberedListLowerRoman: string;
+    numberedListUpperAlpha: string;
+    numberedListUpperAlphaParen: string;
+    numberedListLowerAlpha: string;
+    numberedListLowerAlphaParen: string;
+    indentLeft: string;
+    indentRight: string;
+    directionLtr: string;
+    directionRtl: string;
+    pageBreak: string;
+    copyFormat: string;
+    clearFormatting: string;
+    trackChanges: string;
+    trackChangesFinal: string;
+    trackChangesOriginal: string;
+    trackChangesAccept: string;
+    trackChangesReject: string;
+    documentMode: string;
+    documentEditingMode: string;
+    documentSuggestingMode: string;
+    documentViewingMode: string;
+    colorOption: string;
+    colorOptionCheck: string;
+    linkInput: string;
+    removeLink: string;
+    openLink: string;
+    overflow: string;
+    dropdownCaretUp: string;
+    dropdownCaretDown: string;
+    ruler: string;
+    paintbrush: string;
+    highlight: string;
+    ai: string;
+    table: string;
+    tableActions: string;
+    splitCell: string;
+    mergeCells: string;
+    addRowBefore: string;
+    addRowAfter: string;
+    addColumnBefore: string;
+    addColumnAfter: string;
+    deleteRow: string;
+    deleteColumn: string;
+    deleteTable: string;
+    deleteBorders: string;
+    fixTables: string;
+    lineHeight: string;
+    search: string;
+    cut: string;
+    copy: string;
+    paste: string;
+    strikethrough: string;
+    formattingMarks: string;
+};

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

@@ -1,8 +1,16 @@
+/**
+ * Minimal href sanitizer for the built-in link popover.
+ *
+ * The v1 toolbar used the shared `@superdoc/url-validation` package, which is not
+ * a resolvable runtime dependency of the published `superdoc` ES build. This
+ * keeps the same fail-closed posture (only known-safe schemes pass) without
+ * pulling in that package: dangerous schemes (`javascript:`, `data:`,
+ * `vbscript:`) return `null`, mirroring the v1 contract that callers treat a
+ * `null` result as an invalid URL.
+ */
 /**
  * Validate and normalize an href. Returns `{ href }` for safe values, or `null`.
- * @param {string} value
- * @returns {{ href: string }|null}
  */
-export function sanitizeHref(value: string): {
+export declare function sanitizeHref(value: unknown): {
     href: string;
 } | null;

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

@@ -32,8 +32,9 @@ type BuiltInToolbarConfig = {
     showPageNumberButton: boolean;
     uiDisplayFallbackFont?: string;
 };
+type ToolbarSuperDoc = Partial<Pick<SuperDoc, 'activeEditor' | 'config' | 'ui' | 'uiConfig' | 'fonts' | 'on' | 'off' | 'emit' | 'focus' | 'toggleRuler' | 'toggleFormattingMarks' | 'setShowFormattingMarks'>>;
 type BuiltInToolbarOptions = {
-    superdoc?: SuperDoc | null;
+    superdoc?: ToolbarSuperDoc | null;
     editor?: Editor | null;
     selector?: string | HTMLElement | null;
     element?: string | HTMLElement | null;
@@ -58,7 +59,7 @@ export declare class BuiltInToolbar extends EventEmitter {
     pendingSelectionCapture: SelectionCapture | null | undefined;
     isDev: boolean;
     role: string;
-    superdoc: SuperDoc | null | undefined;
+    superdoc: ToolbarSuperDoc | null | undefined;
     toolbarContainer: HTMLElement | null;
     toolbar: ComponentPublicInstance | null;
     _detachFontsChanged: (() => void) | null;
@@ -66,7 +67,7 @@ export declare class BuiltInToolbar extends EventEmitter {
     app?: App | null;
     activeEditor: Editor | null;
     ui: BorrowedSuperDocUI | null;
-    snapshot: ToolbarSnapshotSlice | null;
+    snapshot: Partial<Pick<ToolbarSnapshotSlice, 'commands' | 'copyFormatActive'>> | null;
     _unsubscribeController: (() => void) | null;
     _detachFormatPainterModeChange: (() => void) | null;
     _customCommandRegs: Map<string, CustomCommandRegistrationResult<CustomButtonPayload>>;

package/dist/superdoc/src/internal/toolbar/image-upload.d.ts

@@ -1,10 +1,32 @@
+/**
+ * Interactive image acquisition for the built-in toolbar (SD-3567).
+ *
+ * The toolbar image button routes through the shared controller command
+ * `image` → `create.image`, which requires a base64 PNG/JPEG data-URI `src`.
+ * This module owns the browser file picker and the File → data-URI
+ * conversion; the toolbar dispatches the resulting payload through the
+ * normal controller command path.
+ */
+/** Accept filter for the picker: PNG and JPEG only (V1 parity; OOXML-native formats). */
+export declare const IMAGE_PICKER_ACCEPT = ".png,.jpg,.jpeg,image/png,image/jpeg";
+type NamedBlob = Blob & {
+    name?: string;
+};
+interface ImageFilePickerOptions {
+    ownerDocument?: Document;
+    onPick?: (file: File) => void | Promise<void>;
+    onError?: (error: unknown) => void;
+}
+interface ImageFilePicker {
+    input: HTMLInputElement;
+    open: () => void;
+    destroy: () => void;
+}
 /**
  * Whether a picked/dropped file is an insertable image (PNG/JPEG). Falls back
  * to the file extension when the browser reports no MIME type.
- * @param {File | null | undefined} file
- * @returns {boolean}
  */
-export function isSupportedImageFile(file: File | null | undefined): boolean;
+export declare function isSupportedImageFile(file: File | null | undefined): boolean;
 /**
  * Read a File/Blob into a base64 data URI.
  *
@@ -12,52 +34,20 @@ export function isSupportedImageFile(file: File | null | undefined): boolean;
  * accepts those by extension, but `readAsDataURL` would then produce an
  * `application/octet-stream` data URI that `create.image` rejects. Rewrite
  * the media type from the filename so extension-accepted files still insert.
- * @param {Blob & { name?: string }} file
- * @returns {Promise<string>}
  */
-export function fileToDataUri(file: Blob & {
-    name?: string;
-}): Promise<string>;
+export declare function fileToDataUri(file: NamedBlob): Promise<string>;
 /**
  * Resolve the `create.image` src for a picked file. Uses the consumer's
  * `handleImageUpload` callback when configured (V1 contract:
  * `(file: File) => Promise<string>`). A returned non-data URL is fetched and
  * embedded, because `create.image` requires an embedded base64 data URI.
- * @param {File} file
- * @param {((file: File) => Promise<string>) | null | undefined} handleImageUpload
- * @returns {Promise<string>}
  */
-export function resolveImageSrc(file: File, handleImageUpload: ((file: File) => Promise<string>) | null | undefined): Promise<string>;
+export declare function resolveImageSrc(file: File, handleImageUpload: ((file: File) => Promise<string>) | null | undefined): Promise<string>;
 /**
  * Hidden `<input type=file>` picker bound to one toolbar instance. The input
  * stays attached (hidden) so automation and tests can drive it; `destroy()`
  * removes it. Picking a file calls `onPick(file)`; an unsupported type or a
  * failed pick routes through `onError(error)`.
- *
- * @param {{
- *   ownerDocument?: Document,
- *   onPick?: (file: File) => unknown,
- *   onError?: (error: Error) => void,
- * }} options
- * @returns {{ input: HTMLInputElement, open: () => void, destroy: () => void }}
- */
-export function createImageFilePicker({ ownerDocument, onPick, onError }?: {
-    ownerDocument?: Document;
-    onPick?: (file: File) => unknown;
-    onError?: (error: Error) => void;
-}): {
-    input: HTMLInputElement;
-    open: () => void;
-    destroy: () => void;
-};
-/**
- * Interactive image acquisition for the built-in toolbar (SD-3567).
- *
- * The toolbar image button routes through the shared controller command
- * `image` → `create.image`, which requires a base64 PNG/JPEG data-URI `src`.
- * This module owns the browser file picker and the File → data-URI
- * conversion; the toolbar dispatches the resulting payload through the
- * normal controller command path.
  */
-/** Accept filter for the picker: PNG and JPEG only (V1 parity; OOXML-native formats). */
-export const IMAGE_PICKER_ACCEPT: ".png,.jpg,.jpeg,image/png,image/jpeg";
+export declare function createImageFilePicker({ ownerDocument, onPick, onError, }?: ImageFilePickerOptions): ImageFilePicker;
+export {};

package/dist/superdoc/src/public/ui/format-painter-helpers.d.ts

@@ -2,22 +2,16 @@
  * Maps SDRunProps field names to InlineRunPatch field names.
  * SDRunProps (read-side) and InlineRunPatch (write-side) use different keys
  * for the same properties; direct assignment between them is forbidden.
- *
- * @param {Record<string, unknown>} props - SDRunProps object from doc.getNodeById
- * @returns {Record<string, unknown>} InlineRunPatch ready for doc.format.apply
  */
-export function sdRunPropsToInlineRunPatch(props: Record<string, unknown>): Record<string, unknown>;
+export declare function sdRunPropsToInlineRunPatch(props: Record<string, unknown>): Record<string, unknown>;
 /**
  * Serializes a selection to a stable string key used to detect whether
  * the target selection is the same as the source (skip apply in that case).
  *
  * Falls back to the plain text target when the host has not populated an
  * explicit `selectionTarget` yet.
- *
- * @param {{ selectionTarget?: unknown; target?: unknown } | null | undefined} selection
- * @returns {string}
  */
-export function selectionKey(selection: {
+export declare function selectionKey(selection: {
     selectionTarget?: unknown;
     target?: unknown;
 } | null | undefined): string;

package/dist/superdoc/src/stores/comments-store.d.ts

@@ -91,8 +91,8 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         key: null;
         entry: null;
     };
-    getCommentDocumentId: (comment: any) => string | null;
-    belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+    getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+    belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
     viewingVisibility: {
         documentMode: string;
         commentsVisible: boolean;
@@ -412,8 +412,8 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         key: null;
         entry: null;
     };
-    getCommentDocumentId: (comment: any) => string | null;
-    belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+    getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+    belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
     viewingVisibility: {
         documentMode: string;
         commentsVisible: boolean;
@@ -733,8 +733,8 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         key: null;
         entry: null;
     };
-    getCommentDocumentId: (comment: any) => string | null;
-    belongsToDocument: (comment: any, activeDocumentId: any, options?: {}) => any;
+    getCommentDocumentId: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment) => string | null;
+    belongsToDocument: (comment: import('./helpers/comment-document-scope.js').DocumentScopedComment, activeDocumentId: string | null | undefined, options?: import('./helpers/comment-document-scope.js').BelongsToDocumentOptions) => boolean;
     viewingVisibility: {
         documentMode: string;
         commentsVisible: boolean;
@@ -961,4 +961,4 @@ export const useCommentsStore: import('pinia').StoreDefinition<"comments", Pick<
         appliedCount: number;
     } | undefined;
     remapTrackedChangeIdentities: (pairs?: any[], { documentId }?: {}) => void;
-}, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "belongsToDocument" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;
+}, "resolveCommentPositionEntry" | "getCommentAliasIds" | "getCommentPositionKey" | "belongsToDocument" | "getComment" | "getTrackedChangeThread" | "getCommentPosition" | "getCommentDocumentId" | "init" | "setViewingVisibility" | "setActiveComment" | "getPendingComment" | "showAddComment" | "addComment" | "addHydratedComment" | "cancelComment" | "deleteComment" | "removePendingComment" | "removeCommentsForDocument" | "setReviewDirectoryFromV2" | "clearReviewDirectory" | "handleEditorLocationsUpdate" | "clearEditorCommentPositions" | "handleTrackedChangeUpdate" | "syncResolvedCommentsWithDocument" | "setActiveFloatingCommentInstance" | "requestInstantSidebarAlignment" | "peekInstantSidebarAlignment" | "clearInstantSidebarAlignment" | "decideTrackedChangeFromSidebar" | "setV2CommentsAdapter" | "getV2CommentsAdapter" | "applyReviewWindowFromV2" | "reconcileCommentsFromV2" | "announceV2CommentCreated" | "dropCommentsFromMutationImpact" | "isV2EditorActive" | "replyCommentV2" | "editCommentV2" | "resolveCommentV2" | "reopenCommentV2" | "setV2TrackedChangesAdapter" | "getV2TrackedChangesAdapter" | "getV2TrackedChangeRowCount" | "reconcileTrackedChangeMutationFromV2" | "reconcileTrackedChangesFromV2" | "remapTrackedChangeIdentities">>;

package/dist/superdoc/src/stores/helpers/comment-document-scope.d.ts

@@ -0,0 +1,22 @@
+export type DocumentScopedComment = {
+    fileId?: unknown;
+    documentId?: unknown;
+    selection?: {
+        documentId?: unknown;
+    } | null;
+} | null | undefined;
+type OpenDocument = {
+    id?: unknown;
+} | null | undefined;
+export type OpenDocumentsSource = OpenDocument[] | {
+    value?: OpenDocument[] | null;
+} | null | undefined;
+export type BelongsToDocumentOptions = {
+    allowSingleDocumentMismatch?: boolean;
+};
+export declare const getCommentDocumentId: (comment: DocumentScopedComment) => string | null;
+export declare const createCommentDocumentScope: (readOpenDocuments: () => OpenDocumentsSource) => {
+    belongsToDocument: (comment: DocumentScopedComment, activeDocumentId: string | null | undefined, options?: BelongsToDocumentOptions) => boolean;
+    belongsToTrackedChangeSyncDocument: (comment: DocumentScopedComment, activeDocumentId: string | null | undefined) => boolean;
+};
+export {};

package/dist/superdoc/src/stores/helpers/pending-selection-snapshot.d.ts

@@ -0,0 +1,17 @@
+export type PendingSelectionHost = {
+    activeEditor?: {
+        options?: {
+            documentId?: unknown;
+        } | null;
+        doc?: {
+            selection?: {
+                current?: () => unknown;
+            } | null;
+        } | null;
+    } | null;
+} | null | undefined;
+export type PendingActiveSelection = {
+    source?: unknown;
+    documentId?: unknown;
+} | null | undefined;
+export declare const getPendingSelectionSnapshot: (superdoc: PendingSelectionHost, activeSelection: PendingActiveSelection) => unknown;

package/dist/superdoc/src/stores/helpers/tracked-change-compaction.d.ts

@@ -0,0 +1,16 @@
+export type CompactableTrackedChangeRow = {
+    commentId?: unknown;
+    importedId?: unknown;
+    trackedChangeCanonicalId?: unknown;
+    trackedChangeAnchorKey?: unknown;
+    trackedChangePositionAliases?: unknown;
+    resolvedTime?: unknown;
+    resolvedById?: unknown;
+    resolvedByEmail?: unknown;
+    resolvedByName?: unknown;
+    trackedChangeDecision?: unknown;
+};
+export declare const getBodyTrackedChangeIdentityIds: (comment: CompactableTrackedChangeRow) => string[];
+export declare const groupBodyTrackedChangeCommentsByIdentity: <Row extends CompactableTrackedChangeRow>(comments: readonly Row[]) => Map<number, Row[]>;
+export declare const mergeDuplicateBodyTrackedChangeComments: <Row extends CompactableTrackedChangeRow>(groups: ReadonlyMap<number, readonly Row[]>) => Map<Row, Row>;
+export declare const createDroppedCommentIdMap: <Row extends CompactableTrackedChangeRow>(duplicates: ReadonlyMap<Row, Row>) => Map<string, string>;

package/dist/superdoc/src/stores/helpers/tracked-change-decision.d.ts

@@ -0,0 +1,45 @@
+export type TrackedChangeDecisionRow = {
+    trackedChangeType?: unknown;
+    trackedChangeDisplayType?: unknown;
+    trackedChangeCanonicalId?: unknown;
+    trackedChangeAnchorKey?: unknown;
+};
+export type TrackedChangeReceiptRef = {
+    kind?: unknown;
+    entityType?: unknown;
+    entityId?: unknown;
+};
+export type TrackedChangeDecisionReceipt = {
+    success?: unknown;
+    txId?: unknown;
+    removed?: unknown;
+    invalidatedRefs?: unknown;
+};
+export type TrackedChangeDecisionOutcome = {
+    decidedId?: unknown;
+    decidedIds?: unknown;
+    receipt?: TrackedChangeDecisionReceipt | null;
+};
+export type ActiveTrackedChangeTargetAdapter = {
+    clearActiveTrackedChangeTargetIfMatches?: (decidedId: string) => unknown;
+};
+export type CanonicalPaintHost = {
+    activeEditor?: {
+        documentMutationReadiness?: {
+            whenPainted?: (receipt: TrackedChangeDecisionReceipt) => unknown;
+        } | null;
+    } | null;
+};
+export declare const normalizeTrackedChangeDecisionType: (value: unknown) => string | null;
+export declare const trackedChangeDecisionKeepsCommentAnchor: ({ comment, decision, }?: {
+    comment?: TrackedChangeDecisionRow | null;
+    decision?: unknown;
+}) => boolean;
+export declare const collectTrackedChangeDecisionIdsWithAliases: (comment: TrackedChangeDecisionRow | null | undefined, aliasIds: Iterable<string>) => Set<string>;
+export declare const collectTrackedChangeEntityIdsFromReceipt: (receipt: TrackedChangeDecisionReceipt | null | undefined) => Set<string>;
+export declare const collectReliableDecidedTrackedChangeIds: (outcome: TrackedChangeDecisionOutcome | null | undefined) => Set<string>;
+export declare const clearV2ActiveTrackedChangeTarget: (adapter: ActiveTrackedChangeTargetAdapter | null | undefined, decidedId: string | null | undefined) => void;
+export declare const waitForTrackedDecisionCanonicalPaint: ({ superdoc, receipt, }?: {
+    superdoc?: CanonicalPaintHost | null;
+    receipt?: TrackedChangeDecisionReceipt | null;
+}) => Promise<void>;