superdoc 2.29.0-next.3 → 2.29.0

package/dist/superdoc/src/stores/helpers/floating-comment-instances.d.ts

@@ -1,14 +1,49 @@
-export function buildFloatingCommentInstances({ comment, positionKey, positionEntry, fallbackId }: {
-    comment: any;
-    positionKey: any;
-    positionEntry: any;
-    fallbackId: any;
-}): {
-    id: any;
-    threadId: any;
-    comment: any;
-    positionKey: any;
-    pageIndex: any;
+type FloatingCommentRect = {
+    pageIndex?: number | null;
+    left?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+};
+type FloatingCommentBounds = {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+};
+type FloatingCommentPositionEntry = {
+    pageIndex?: number | null;
+    rects?: readonly (FloatingCommentRect | null | undefined)[] | null;
+    bounds?: Partial<FloatingCommentBounds> | null;
+};
+type FloatingCommentSource = {
+    commentId?: string | null;
+    trackedChange?: boolean | null;
+    trackedChangeStory?: string | {
+        storyType?: unknown;
+    } | null;
+    trackedChangeCanonicalId?: string | null;
+    trackedChangePositionAliases?: readonly unknown[] | null;
+    selection?: {
+        page?: unknown;
+    } | null;
+};
+type FloatingCommentInstance<TComment extends FloatingCommentSource = FloatingCommentSource> = {
+    id: string;
+    threadId: string | null;
+    comment: TComment;
+    positionKey: string | null;
+    positionEntry: FloatingCommentPositionEntry | null;
+    pageIndex: number | null;
     isPrimary: boolean;
-    positionEntry: any;
-}[];
+};
+type BuildFloatingCommentInstancesParams<TComment extends FloatingCommentSource> = {
+    comment: TComment;
+    positionKey: string | null;
+    positionEntry: FloatingCommentPositionEntry | null;
+    fallbackId: string | null;
+};
+export declare const buildFloatingCommentInstances: <TComment extends FloatingCommentSource>({ comment, positionKey, positionEntry, fallbackId, }: BuildFloatingCommentInstancesParams<TComment>) => FloatingCommentInstance<TComment>[];
+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>;

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

@@ -0,0 +1,19 @@
+import { BodyStoryLocator } from '../../../../document-api/src/index.js';
+type TrackedChangeAnchorParts = {
+    storyKey: string;
+    rawId: string;
+};
+export declare const BODY_TRACKED_CHANGE_STORY: BodyStoryLocator;
+export declare const normalizeCommentId: (id: unknown) => string | null;
+export declare const makeTrackedChangeAnchorKey: ({ storyKey, rawId }: TrackedChangeAnchorParts) => string;
+export declare const isBodyTrackedChangeComment: (comment: unknown) => boolean;
+export declare const buildBodyTrackedChangeAnchorKey: (rawId: unknown) => string | null;
+export declare const parseTrackedChangeAnchorKey: (anchorKey: unknown) => TrackedChangeAnchorParts | null;
+export declare const buildTrackedChangeAnchorKeyForStory: (storyKey: string | null, rawId: unknown) => string | null;
+export declare const normalizeTrackedChangePositionAliases: (aliases: unknown) => string[];
+export declare const getTrackedChangeStoryKey: (comment: unknown) => string | null;
+export declare const normalizeTrackedChangeStoryKey: (storyKey: string | null) => string | null;
+export declare const trackedChangeStoryKeysAreCompatible: (leftStoryKey: string | null, rightStoryKey: string | null) => boolean;
+export declare const positionEntryMatchesTrackedChangeStory: (entry: unknown, comment: unknown) => boolean;
+export declare const buildTrackedChangeImportedPositionId: (id: unknown) => string | null;
+export {};

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

@@ -11,10 +11,6 @@ type TrackedChangeRowImagePreview = {
     height?: number;
     alt: string;
 };
-export declare const makeTrackedChangeAnchorKey: ({ storyKey, rawId }: {
-    storyKey: string;
-    rawId: string;
-}) => string;
 export declare const shallowEqual: (a: unknown, b: unknown) => boolean;
 export declare const normalizeTrackedChangeDetailLines: (lines: unknown) => TrackedChangeDetailLine[] | null;
 export declare const trackedChangeDetailLinesEqual: (a: unknown, b: unknown) => boolean;

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

@@ -1,28 +1,25 @@
-export function buildTrackedChangeThreadOwnerIndex<Comment extends {
-    commentId: string | number;
+type CommentId = string | number;
+export type TrackedChangeSideGroup = 'source' | 'destination';
+type TrackedChangeLinkFields = {
+    parentCommentId?: CommentId | null;
+    threadingParentCommentId?: CommentId | null;
+    trackedChangeParentId?: CommentId | null;
+    trackedChangeThreadParentId?: CommentId | null;
+};
+type TrackedChangeThreadOwnerFields = TrackedChangeLinkFields & {
+    commentId: CommentId;
     trackedChange?: boolean;
-    trackedChangeCanonicalId?: string | number | null;
-    trackedChangeSide?: string | null;
-    semanticColorKey?: string | null;
-    parentCommentId?: string | number | null;
-    threadingParentCommentId?: string | number | null;
-    trackedChangeParentId?: string | number | null;
-    trackedChangeThreadParentId?: string | number | null;
-}>(allComments: ReadonlyArray<Comment>): Map<Comment, Comment>;
-export function buildTrackedChangeThreadIndex<Comment extends {
-    commentId: string | number;
-    trackedChange?: boolean;
-    trackedChangeCanonicalId?: string | number | null;
+    trackedChangeCanonicalId?: CommentId | null;
     trackedChangeSide?: string | null;
     semanticColorKey?: string | null;
+};
+type TrackedChangeThreadFields = TrackedChangeThreadOwnerFields & {
     createdTime?: number;
-    parentCommentId?: string | number | null;
-    threadingParentCommentId?: string | number | null;
-    trackedChangeParentId?: string | number | null;
-}>(allComments: ReadonlyArray<Comment>, previous?: ReadonlyMap<string | number, ReadonlyArray<Comment>>): Map<string | number, ReadonlyArray<Comment>>;
-export function buildTrackedChangeDecisionLinkIndex<Comment extends {
-    parentCommentId?: string | number | null;
-    threadingParentCommentId?: string | number | null;
-    trackedChangeParentId?: string | number | null;
-    trackedChangeThreadParentId?: string | number | null;
-}>(allComments: ReadonlyArray<Comment>, previous?: ReadonlyMap<string, ReadonlyArray<Comment>>): Map<string, ReadonlyArray<Comment>>;
+};
+export declare const trackedChangeRowSideGroup: (comment: {
+    semanticColorKey?: string | null;
+}) => TrackedChangeSideGroup | null;
+export declare const buildTrackedChangeThreadOwnerIndex: <Comment extends TrackedChangeThreadOwnerFields>(allComments: ReadonlyArray<Comment>) => Map<Comment, Comment>;
+export declare const buildTrackedChangeThreadIndex: <Comment extends TrackedChangeThreadFields>(allComments: ReadonlyArray<Comment>, previous?: ReadonlyMap<CommentId, ReadonlyArray<Comment>>) => Map<CommentId, ReadonlyArray<Comment>>;
+export declare const buildTrackedChangeDecisionLinkIndex: <Comment extends TrackedChangeLinkFields>(allComments: ReadonlyArray<Comment>, previous?: ReadonlyMap<string, ReadonlyArray<Comment>>) => Map<string, ReadonlyArray<Comment>>;
+export {};