@parhelia/core 0.3.12831 → 0.3.12833

package/dist/editor/reviews/feedbackBalloonDate.js

@@ -0,0 +1,22 @@
+import { formatDateOnly, formatTime } from "../utils";
+/**
+ * Timestamp for a margin balloon, where the author name needs the room: the
+ * time for today, day and month within the current year, the full date
+ * otherwise. The complete timestamp belongs in the element's title.
+ */
+export function formatFeedbackBalloonDate(date, now = new Date(), options) {
+    if (Number.isNaN(date.getTime()))
+        return "";
+    if (formatDateOnly(date, options) === formatDateOnly(now, options)) {
+        return formatTime(date, options);
+    }
+    const sameYear = formatDateOnly(date, { ...options, month: undefined, day: undefined }) ===
+        formatDateOnly(now, { ...options, month: undefined, day: undefined });
+    return formatDateOnly(date, {
+        ...options,
+        year: sameYear ? undefined : "numeric",
+        month: "short",
+        day: "numeric",
+    });
+}
+//# sourceMappingURL=feedbackBalloonDate.js.map

package/dist/editor/reviews/feedbackBalloonDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedbackBalloonDate.js","sourceRoot":"","sources":["../../../src/editor/reviews/feedbackBalloonDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAU,EACV,GAAG,GAAS,IAAI,IAAI,EAAE,EACtB,OAA+B;IAE/B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,IAAI,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;QACnE,OAAO,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,QAAQ,GACZ,cAAc,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;QACtE,cAAc,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IACxE,OAAO,cAAc,CAAC,IAAI,EAAE;QAC1B,GAAG,OAAO;QACV,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACtC,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/editor/reviews/feedbackDrafts.d.ts

@@ -0,0 +1,49 @@
+import { type ReactNode } from "react";
+import type { CommentImageAttachment } from "./useCommentImagePaste";
+/**
+ * Unsaved state of one feedback thread's composers. The comment margin moves
+ * cards between presentations (anchored layer, stacked list, footer), which
+ * remounts them; anything the user typed has to survive that, so it lives
+ * here, keyed by thread id, instead of in card-local state.
+ */
+export type FeedbackDraft = {
+    /** Which comment a reply is addressed to; undefined = no reply editor open. */
+    replyTargetCommentId?: string;
+    replyText?: string;
+    replyAttachments?: CommentImageAttachment[];
+    /** The comment currently being edited in place (or the new draft comment). */
+    editingCommentId?: string;
+    editText?: string;
+    editTags?: string[];
+    editAttachments?: CommentImageAttachment[];
+    /** Reply list collapsed by the user. */
+    collapsed?: boolean;
+};
+type Listener = () => void;
+export type FeedbackDraftStore = {
+    get: (threadId: string) => FeedbackDraft | undefined;
+    update: (threadId: string, patch: Partial<FeedbackDraft> | ((current: FeedbackDraft) => FeedbackDraft)) => void;
+    clear: (threadId: string) => void;
+    subscribe: (threadId: string, listener: Listener) => () => void;
+};
+export declare function createFeedbackDraftStore(): FeedbackDraftStore;
+/**
+ * Provides the draft store to a feedback surface. A provider nested inside
+ * another one reuses the outer store: the editor shell owns one store above
+ * the desktop/mobile layout switch, so an unsaved reply survives rotating a
+ * phone, and every surface (margin, form margin, mobile panel) sees it.
+ * Standalone usages (popovers, tests) still get a store of their own.
+ */
+export declare function FeedbackDraftsProvider({ children, store, }: {
+    children: ReactNode;
+    /** Optional externally owned store (tests); by default one per provider. */
+    store?: FeedbackDraftStore;
+}): import("react").JSX.Element;
+export declare function useFeedbackDraftStore(): FeedbackDraftStore;
+export type UseFeedbackDraftResult = [
+    draft: FeedbackDraft,
+    update: (patch: Partial<FeedbackDraft>) => void,
+    clear: () => void
+];
+export declare function useFeedbackDraft(threadId: string): UseFeedbackDraftResult;
+export {};

package/dist/editor/reviews/feedbackDrafts.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useMemo, useRef, useSyncExternalStore, } from "react";
+const EMPTY_DRAFT = Object.freeze({});
+export function createFeedbackDraftStore() {
+    const drafts = new Map();
+    const listeners = new Map();
+    const notify = (threadId) => {
+        listeners.get(threadId)?.forEach((listener) => listener());
+    };
+    return {
+        get: (threadId) => drafts.get(threadId),
+        update: (threadId, patch) => {
+            const current = drafts.get(threadId) ?? EMPTY_DRAFT;
+            const next = typeof patch === "function" ? patch(current) : { ...current, ...patch };
+            drafts.set(threadId, next);
+            notify(threadId);
+        },
+        clear: (threadId) => {
+            if (!drafts.has(threadId))
+                return;
+            drafts.delete(threadId);
+            notify(threadId);
+        },
+        subscribe: (threadId, listener) => {
+            let set = listeners.get(threadId);
+            if (!set) {
+                set = new Set();
+                listeners.set(threadId, set);
+            }
+            set.add(listener);
+            return () => {
+                set.delete(listener);
+                if (set.size === 0)
+                    listeners.delete(threadId);
+            };
+        },
+    };
+}
+const FeedbackDraftsContext = createContext(null);
+/**
+ * Provides the draft store to a feedback surface. A provider nested inside
+ * another one reuses the outer store: the editor shell owns one store above
+ * the desktop/mobile layout switch, so an unsaved reply survives rotating a
+ * phone, and every surface (margin, form margin, mobile panel) sees it.
+ * Standalone usages (popovers, tests) still get a store of their own.
+ */
+export function FeedbackDraftsProvider({ children, store, }) {
+    const inherited = useContext(FeedbackDraftsContext);
+    const ownStoreRef = useRef(null);
+    if (!store && !inherited && !ownStoreRef.current) {
+        ownStoreRef.current = createFeedbackDraftStore();
+    }
+    return (_jsx(FeedbackDraftsContext.Provider, { value: store ?? inherited ?? ownStoreRef.current, children: children }));
+}
+export function useFeedbackDraftStore() {
+    const contextStore = useContext(FeedbackDraftsContext);
+    // Outside a provider (popovers, tests) each consumer keeps a private store,
+    // which behaves exactly like component-local state.
+    const localStoreRef = useRef(null);
+    if (!contextStore && !localStoreRef.current) {
+        localStoreRef.current = createFeedbackDraftStore();
+    }
+    return contextStore ?? localStoreRef.current;
+}
+export function useFeedbackDraft(threadId) {
+    const store = useFeedbackDraftStore();
+    const subscribe = useCallback((listener) => store.subscribe(threadId, listener), [store, threadId]);
+    const getSnapshot = useCallback(() => store.get(threadId) ?? EMPTY_DRAFT, [store, threadId]);
+    const draft = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    const update = useCallback((patch) => store.update(threadId, patch), [store, threadId]);
+    const clear = useCallback(() => store.clear(threadId), [store, threadId]);
+    return useMemo(() => [draft, update, clear], [draft, update, clear]);
+}
+//# sourceMappingURL=feedbackDrafts.js.map

package/dist/editor/reviews/feedbackDrafts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedbackDrafts.js","sourceRoot":"","sources":["../../../src/editor/reviews/feedbackDrafts.tsx"],"names":[],"mappings":"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"}

package/dist/editor/reviews/feedbackHoverState.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The feedback thread currently hovered in the comment margin (or on the
+ * canvas). Kept outside the edit context because it changes on every mouse
+ * move across cards and only the highlight overlay and the margin care.
+ */
+export type HoveredFeedback = {
+    kind: "comment" | "suggestion";
+    /** Thread id: the root comment's id or the suggestion's id. */
+    id: string;
+};
+type Listener = () => void;
+export declare function setHoveredFeedback(next: HoveredFeedback | null): void;
+/** Clears the hover only if it still points at `id`. */
+export declare function clearHoveredFeedback(id: string): void;
+export declare function getHoveredFeedback(): HoveredFeedback | null;
+export declare function subscribeHoveredFeedback(listener: Listener): () => void;
+export declare function useHoveredFeedback(): HoveredFeedback | null;
+export {};

package/dist/editor/reviews/feedbackHoverState.js

@@ -0,0 +1,35 @@
+import { useSyncExternalStore } from "react";
+let hovered = null;
+const listeners = new Set();
+function notify() {
+    for (const listener of listeners)
+        listener();
+}
+export function setHoveredFeedback(next) {
+    if ((hovered === null && next === null) ||
+        (hovered && next && hovered.kind === next.kind && hovered.id === next.id)) {
+        return;
+    }
+    hovered = next;
+    notify();
+}
+/** Clears the hover only if it still points at `id`. */
+export function clearHoveredFeedback(id) {
+    if (hovered?.id !== id)
+        return;
+    hovered = null;
+    notify();
+}
+export function getHoveredFeedback() {
+    return hovered;
+}
+export function subscribeHoveredFeedback(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+export function useHoveredFeedback() {
+    return useSyncExternalStore(subscribeHoveredFeedback, getHoveredFeedback, getHoveredFeedback);
+}
+//# sourceMappingURL=feedbackHoverState.js.map

package/dist/editor/reviews/feedbackHoverState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedbackHoverState.js","sourceRoot":"","sources":["../../../src/editor/reviews/feedbackHoverState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAe7C,IAAI,OAAO,GAA2B,IAAI,CAAC;AAC3C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;AAEtC,SAAS,MAAM;IACb,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAA4B;IAC7D,IACE,CAAC,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC;QACnC,CAAC,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,EACzE,CAAC;QACD,OAAO;IACT,CAAC;IACD,OAAO,GAAG,IAAI,CAAC;IACf,MAAM,EAAE,CAAC;AACX,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,IAAI,OAAO,EAAE,EAAE,KAAK,EAAE;QAAE,OAAO;IAC/B,OAAO,GAAG,IAAI,CAAC;IACf,MAAM,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAkB;IACzD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,oBAAoB,CACzB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,CACnB,CAAC;AACJ,CAAC"}

package/dist/editor/reviews/feedbackPersonFilter.d.ts

@@ -0,0 +1,3 @@
+export declare function getFeedbackPersonFilter(): string[];
+export declare function setFeedbackPersonFilter(people: string[]): void;
+export declare function useFeedbackPersonFilter(): string[];

package/dist/editor/reviews/feedbackPersonFilter.js

@@ -0,0 +1,32 @@
+import { useSyncExternalStore } from "react";
+import { localStorageService } from "../services/localStorageService";
+/**
+ * The "people" filter of the feedback surfaces. It is set from the toolbar
+ * (the comments split button) and read by the comment margin, so it lives in
+ * a small shared store instead of in either component; persisted per browser.
+ */
+const STORAGE_KEY = "comments.personFilter";
+let selectedPeople;
+const listeners = new Set();
+function read() {
+    selectedPeople ??= localStorageService.getItem(STORAGE_KEY) || [];
+    return selectedPeople;
+}
+export function getFeedbackPersonFilter() {
+    return read();
+}
+export function setFeedbackPersonFilter(people) {
+    selectedPeople = people;
+    localStorageService.setItem(STORAGE_KEY, people);
+    listeners.forEach((listener) => listener());
+}
+function subscribe(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+export function useFeedbackPersonFilter() {
+    return useSyncExternalStore(subscribe, read, read);
+}
+//# sourceMappingURL=feedbackPersonFilter.js.map

package/dist/editor/reviews/feedbackPersonFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedbackPersonFilter.js","sourceRoot":"","sources":["../../../src/editor/reviews/feedbackPersonFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAE5C,IAAI,cAAoC,CAAC;AACzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;AAExC,SAAS,IAAI;IACX,cAAc,KAAK,mBAAmB,CAAC,OAAO,CAAW,WAAW,CAAC,IAAI,EAAE,CAAC;IAC5E,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAgB;IACtD,cAAc,GAAG,MAAM,CAAC;IACxB,mBAAmB,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjD,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,QAAoB;IACrC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,oBAAoB,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/editor/reviews/feedbackThreadSelection.d.ts

@@ -0,0 +1,10 @@
+import type { Comment, SuggestedEdit } from "../../types";
+import type { FeedbackThread } from "./feedbackThreads";
+/**
+ * Maps the editor's selection (which may be a reply, or a comment attached to
+ * a suggestion) to the thread that owns it. Margin cards, pinning and leader
+ * lines are per thread, so every consumer resolves through this one function
+ * instead of comparing `selectedComment.id` against thread ids.
+ */
+export declare function resolveSelectedThreadId(threads: readonly FeedbackThread[], selectedComment: Comment | undefined, selectedSuggestedEdit: SuggestedEdit | undefined): string | undefined;
+export declare function getThreadForComment(threads: readonly FeedbackThread[], comment: Comment): FeedbackThread | undefined;

package/dist/editor/reviews/feedbackThreadSelection.js

@@ -0,0 +1,31 @@
+import { feedbackIdsEqual } from "./pendingFeedbackFocus";
+/**
+ * Maps the editor's selection (which may be a reply, or a comment attached to
+ * a suggestion) to the thread that owns it. Margin cards, pinning and leader
+ * lines are per thread, so every consumer resolves through this one function
+ * instead of comparing `selectedComment.id` against thread ids.
+ */
+export function resolveSelectedThreadId(threads, selectedComment, selectedSuggestedEdit) {
+    if (selectedSuggestedEdit) {
+        return threads.find((thread) => thread.kind === "suggestion" &&
+            feedbackIdsEqual(thread.id, selectedSuggestedEdit.id))?.id;
+    }
+    if (!selectedComment)
+        return undefined;
+    if (selectedComment.suggestedEditId) {
+        return threads.find((thread) => thread.kind === "suggestion" &&
+            feedbackIdsEqual(thread.id, selectedComment.suggestedEditId))?.id;
+    }
+    return threads.find((thread) => {
+        if (thread.kind !== "comment")
+            return false;
+        if (feedbackIdsEqual(thread.id, selectedComment.id))
+            return true;
+        return thread.replies.some((reply) => feedbackIdsEqual(reply.id, selectedComment.id));
+    })?.id;
+}
+export function getThreadForComment(threads, comment) {
+    const id = resolveSelectedThreadId(threads, comment, undefined);
+    return id ? threads.find((thread) => thread.id === id) : undefined;
+}
+//# sourceMappingURL=feedbackThreadSelection.js.map

package/dist/editor/reviews/feedbackThreadSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedbackThreadSelection.js","sourceRoot":"","sources":["../../../src/editor/reviews/feedbackThreadSelection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAkC,EAClC,eAAoC,EACpC,qBAAgD;IAEhD,IAAI,qBAAqB,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,IAAI,KAAK,YAAY;YAC5B,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,qBAAqB,CAAC,EAAE,CAAC,CACxD,EAAE,EAAE,CAAC;IACR,CAAC;IAED,IAAI,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAEvC,IAAI,eAAe,CAAC,eAAe,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,IAAI,KAAK,YAAY;YAC5B,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,eAAe,CAAC,eAAe,CAAC,CAC/D,EAAE,EAAE,CAAC;IACR,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,eAAe,CAAC,EAAE,CAAC;YAAE,OAAO,IAAI,CAAC;QACjE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CACnC,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,eAAe,CAAC,EAAE,CAAC,CAC/C,CAAC;IACJ,CAAC,CAAC,EAAE,EAAE,CAAC;AACT,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAkC,EAClC,OAAgB;IAEhB,MAAM,EAAE,GAAG,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAChE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrE,CAAC"}

package/dist/editor/reviews/feedbackThreads.d.ts

@@ -0,0 +1,50 @@
+import type { Comment, SuggestedEdit } from "../../types";
+export type CommentThread = {
+    kind: "comment";
+    /** The root comment's id. */
+    id: string;
+    root: Comment;
+    /** Every reply in the thread, oldest first. */
+    replies: Comment[];
+    created: number;
+};
+export type SuggestionThread = {
+    kind: "suggestion";
+    /** The suggested edit's id. */
+    id: string;
+    suggestion: SuggestedEdit;
+    /** Comments attached to the suggestion, oldest first. */
+    comments: Comment[];
+    created: number;
+};
+export type FeedbackThread = CommentThread | SuggestionThread;
+export type FeedbackSortField = "date" | "structure";
+export type FeedbackSortDirection = "asc" | "desc";
+export type FeedbackSort = {
+    field: FeedbackSortField;
+    direction: FeedbackSortDirection;
+};
+export type BuildFeedbackThreadsOptions = {
+    comments: Comment[];
+    suggestedEdits: SuggestedEdit[];
+    showResolved: boolean;
+    /** Author account names; empty means everyone. */
+    selectedPeople: string[];
+    /** Without a sort the threads are ordered by most recent activity first. */
+    sort?: FeedbackSort;
+};
+/** Groups the comments attached to suggestions by suggestion id. */
+export declare function groupSuggestionComments(comments: Comment[]): Map<string, Comment[]>;
+/**
+ * Groups plain (non-suggestion) comments into reply lists keyed by their root
+ * comment. A reply whose parent is not loaded keeps the parent id as its root.
+ */
+export declare function groupCommentReplies(comments: Comment[]): Map<string, Comment[]>;
+/**
+ * Turns the loaded comments and suggested edits into the threads a feedback
+ * surface shows: filtered (resolved, people, no-op suggestions), grouped
+ * (replies under their root, comments under their suggestion) and ordered.
+ */
+export declare function buildFeedbackThreads({ comments, suggestedEdits, showResolved, selectedPeople, sort, }: BuildFeedbackThreadsOptions): FeedbackThread[];
+/** Every comment that belongs to a thread, root/suggestion comments first. */
+export declare function getThreadComments(thread: FeedbackThread): Comment[];

package/dist/editor/reviews/feedbackThreads.js

@@ -0,0 +1,135 @@
+import { getFeedbackActivityTime, isResolvedFeedbackItem, isSuggestedEdit, } from "./feedbackOrdering";
+import { shouldRemoveNoOpSuggestion } from "./suggestionContentChange";
+function parseCreated(value) {
+    if (!value)
+        return 0;
+    const time = new Date(value).getTime();
+    return Number.isFinite(time) ? time : 0;
+}
+function sortByCreated(a, b) {
+    return parseCreated(a.created) - parseCreated(b.created);
+}
+/** Groups the comments attached to suggestions by suggestion id. */
+export function groupSuggestionComments(comments) {
+    const map = new Map();
+    comments.forEach((comment) => {
+        if (!comment.suggestedEditId)
+            return;
+        const list = map.get(comment.suggestedEditId) || [];
+        list.push(comment);
+        map.set(comment.suggestedEditId, list);
+    });
+    map.forEach((list) => list.sort(sortByCreated));
+    return map;
+}
+/**
+ * Groups plain (non-suggestion) comments into reply lists keyed by their root
+ * comment. A reply whose parent is not loaded keeps the parent id as its root.
+ */
+export function groupCommentReplies(comments) {
+    const idToComment = new Map();
+    comments.forEach((comment) => idToComment.set(comment.id, comment));
+    const getRootId = (comment) => {
+        let current = comment;
+        const seen = new Set();
+        while (current && current.parentCommentId) {
+            if (seen.has(current.id))
+                break;
+            seen.add(current.id);
+            const parent = idToComment.get(current.parentCommentId);
+            if (!parent)
+                return current.parentCommentId;
+            current = parent;
+        }
+        return current?.id;
+    };
+    const repliesByRootId = new Map();
+    comments.forEach((comment) => {
+        if (!comment.parentCommentId)
+            return;
+        const rootId = getRootId(comment);
+        if (!rootId)
+            return;
+        const replies = repliesByRootId.get(rootId) || [];
+        replies.push(comment);
+        repliesByRootId.set(rootId, replies);
+    });
+    repliesByRootId.forEach((replies) => replies.sort(sortByCreated));
+    return repliesByRootId;
+}
+/**
+ * Turns the loaded comments and suggested edits into the threads a feedback
+ * surface shows: filtered (resolved, people, no-op suggestions), grouped
+ * (replies under their root, comments under their suggestion) and ordered.
+ */
+export function buildFeedbackThreads({ comments, suggestedEdits, showResolved, selectedPeople, sort, }) {
+    const suggestionComments = groupSuggestionComments(comments);
+    const plainComments = comments.filter((comment) => !comment.suggestedEditId);
+    let items = [...plainComments, ...suggestedEdits];
+    items = items.filter((item) => {
+        if (!isSuggestedEdit(item))
+            return true;
+        const commentCount = (suggestionComments.get(item.id) || []).length;
+        return !shouldRemoveNoOpSuggestion(item.oldValue, item.newValue, commentCount);
+    });
+    if (!showResolved) {
+        items = items.filter((item) => !isResolvedFeedbackItem(item));
+    }
+    if (selectedPeople.length > 0) {
+        items = items.filter((item) => "author" in item && !!item.author && selectedPeople.includes(item.author));
+    }
+    const direction = sort?.direction ?? "desc";
+    const field = sort?.field ?? "date";
+    const multiplier = direction === "asc" ? 1 : -1;
+    items = items
+        .map((item, index) => ({ item, index }))
+        .sort((a, b) => {
+        switch (field) {
+            case "date": {
+                const timeDifference = getFeedbackActivityTime(a.item, suggestionComments) -
+                    getFeedbackActivityTime(b.item, suggestionComments);
+                return multiplier * timeDifference || a.index - b.index;
+            }
+            case "structure": {
+                const pathA = "itemName" in a.item ? a.item.itemName || "" : "";
+                const pathB = "itemName" in b.item ? b.item.itemName || "" : "";
+                return multiplier * pathA.localeCompare(pathB) || a.index - b.index;
+            }
+            default:
+                return a.index - b.index;
+        }
+    })
+        .map(({ item }) => item);
+    const filteredComments = items.filter((item) => !isSuggestedEdit(item));
+    const repliesByRootId = groupCommentReplies(filteredComments);
+    const threads = [];
+    for (const item of items) {
+        if (isSuggestedEdit(item)) {
+            threads.push({
+                kind: "suggestion",
+                id: item.id,
+                suggestion: item,
+                comments: suggestionComments.get(item.id) || [],
+                created: parseCreated(item.created),
+            });
+            continue;
+        }
+        if (item.parentCommentId)
+            continue;
+        threads.push({
+            kind: "comment",
+            id: item.id,
+            root: item,
+            replies: repliesByRootId.get(item.id) || [],
+            created: parseCreated(item.created),
+        });
+    }
+    return threads;
+}
+/** Every comment that belongs to a thread, root/suggestion comments first. */
+export function getThreadComments(thread) {
+    return thread.kind === "comment"
+        ? [thread.root, ...thread.replies]
+        : thread.comments;
+}
+//# sourceMappingURL=feedbackThreads.js.map

package/dist/editor/reviews/feedbackThreads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedbackThreads.js","sourceRoot":"","sources":["../../../src/editor/reviews/feedbackThreads.ts"],"names":[],"mappings":"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"}

package/dist/editor/reviews/feedbackWheelForwarding.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Finds the nearest feedback scroll container between `target` and `root`
+ * that can still scroll in the wheel direction. When there is none, the wheel
+ * gesture belongs to the canvas (the margin forwards it), otherwise the
+ * container scrolls natively.
+ */
+export declare function findScrollableAncestor(target: Element | null, root: Element, deltaY: number): HTMLElement | null;
+/** Wheel delta in pixels; line-mode deltas (Firefox) are approximated. */
+export declare function wheelDeltaToPixels(deltaY: number, deltaMode: number): number;
+/** Below this (pixels), a wheel delta is a trackpad step and is not eased. */
+export declare const SMOOTH_WHEEL_MIN_DELTA = 40;
+/** Time constant of the ease: about 95% of a notch lands within 3×. */
+export declare const SMOOTH_WHEEL_TIME_CONSTANT_MS = 45;
+type FrameScheduler = {
+    request: (callback: (time: number) => void) => number;
+    cancel: (handle: number) => void;
+    /** Same clock as the request callback's time. */
+    now: () => number;
+};
+/**
+ * Forwards wheel gestures to a scroller that only moves instantly (the canvas
+ * bridge), so that they look like the browser's own wheel scrolling: a mouse
+ * wheel notch glides over a few frames instead of jumping, and quick notches
+ * add up to one glide. Small trackpad deltas pass straight through, as the
+ * browser does not ease those either.
+ *
+ * `forward` returns whether the gesture is handled (`canScroll`), so callers
+ * can let an unhandled wheel propagate.
+ */
+export declare function createSmoothWheelForwarder(scrollBy: (y: number) => boolean, canScroll: () => boolean, frames?: FrameScheduler): {
+    forward(deltaY: number, deltaMode: number): boolean;
+    cancel: () => void;
+};
+export {};

package/dist/editor/reviews/feedbackWheelForwarding.js

@@ -0,0 +1,108 @@
+import { FEEDBACK_SCROLLABLE_ATTRIBUTE } from "./scrollWithin";
+/**
+ * Finds the nearest feedback scroll container between `target` and `root`
+ * that can still scroll in the wheel direction. When there is none, the wheel
+ * gesture belongs to the canvas (the margin forwards it), otherwise the
+ * container scrolls natively.
+ */
+export function findScrollableAncestor(target, root, deltaY) {
+    let current = target;
+    while (current && current !== root) {
+        if (current instanceof HTMLElement &&
+            current.hasAttribute(FEEDBACK_SCROLLABLE_ATTRIBUTE) &&
+            canScrollVertically(current, deltaY)) {
+            return current;
+        }
+        current = current.parentElement;
+    }
+    return null;
+}
+function canScrollVertically(element, deltaY) {
+    const range = element.scrollHeight - element.clientHeight;
+    if (range <= 1)
+        return false;
+    if (deltaY > 0)
+        return element.scrollTop < range - 0.5;
+    if (deltaY < 0)
+        return element.scrollTop > 0.5;
+    return true;
+}
+/** Wheel delta in pixels; line-mode deltas (Firefox) are approximated. */
+export function wheelDeltaToPixels(deltaY, deltaMode) {
+    if (deltaMode === 1)
+        return deltaY * 16;
+    if (deltaMode === 2)
+        return deltaY * 800;
+    return deltaY;
+}
+/** Below this (pixels), a wheel delta is a trackpad step and is not eased. */
+export const SMOOTH_WHEEL_MIN_DELTA = 40;
+/** Time constant of the ease: about 95% of a notch lands within 3×. */
+export const SMOOTH_WHEEL_TIME_CONSTANT_MS = 45;
+const animationFrames = {
+    request: (callback) => window.requestAnimationFrame(callback),
+    cancel: (handle) => window.cancelAnimationFrame(handle),
+    now: () => performance.now(),
+};
+/**
+ * Forwards wheel gestures to a scroller that only moves instantly (the canvas
+ * bridge), so that they look like the browser's own wheel scrolling: a mouse
+ * wheel notch glides over a few frames instead of jumping, and quick notches
+ * add up to one glide. Small trackpad deltas pass straight through, as the
+ * browser does not ease those either.
+ *
+ * `forward` returns whether the gesture is handled (`canScroll`), so callers
+ * can let an unhandled wheel propagate.
+ */
+export function createSmoothWheelForwarder(scrollBy, canScroll, frames = animationFrames) {
+    let remaining = 0;
+    let handle = null;
+    let lastTime = 0;
+    const stop = () => {
+        if (handle !== null)
+            frames.cancel(handle);
+        handle = null;
+        remaining = 0;
+    };
+    const tick = (time) => {
+        handle = null;
+        const elapsed = Math.max(time - lastTime, 1);
+        lastTime = time;
+        const share = 1 - Math.exp(-elapsed / SMOOTH_WHEEL_TIME_CONSTANT_MS);
+        // Whole pixels, at least one, so the glide ends exactly on target.
+        const step = Math.abs(remaining) <= 1
+            ? Math.round(remaining)
+            : Math.round(remaining * share) || Math.sign(remaining);
+        if (step !== 0 && !scrollBy(step)) {
+            stop();
+            return;
+        }
+        remaining -= step;
+        if (Math.abs(remaining) >= 0.5)
+            handle = frames.request(tick);
+        else
+            stop();
+    };
+    return {
+        forward(deltaY, deltaMode) {
+            const pixels = wheelDeltaToPixels(deltaY, deltaMode);
+            if (Math.abs(pixels) < SMOOTH_WHEEL_MIN_DELTA && handle === null) {
+                return scrollBy(pixels);
+            }
+            if (!canScroll())
+                return false;
+            // Reversing direction drops what is left of the previous glide.
+            if (Math.sign(pixels) !== Math.sign(remaining))
+                remaining = 0;
+            remaining += pixels;
+            if (handle === null) {
+                // The glide starts when the notch did, not a frame later.
+                lastTime = frames.now();
+                handle = frames.request(tick);
+            }
+            return true;
+        },
+        cancel: stop,
+    };
+}
+//# sourceMappingURL=feedbackWheelForwarding.js.map