@parhelia/core 0.3.12831 → 0.3.12833

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

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

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

@@ -0,0 +1,23 @@
+export type ReviewScopeItem = {
+    itemId: string;
+    language: string;
+    includeSubitems: boolean;
+};
+export type ReviewScopeTarget = {
+    id: string;
+    language: string;
+    /** Sitecore long ID path ("/{guid}/.../{guid}"), ending with the item itself. */
+    idPath?: string;
+};
+/** Same rules as CollectionMembershipService.IsMember on the server. */
+export declare function reviewCoversItem(items: ReviewScopeItem[], target: ReviewScopeTarget): boolean;
+export declare function getReviewIdFromUrl(): string | null;
+/** Sets or removes reviewId in place, without adding a history entry. */
+export declare function setReviewIdInUrl(reviewId: string | undefined): void;
+/**
+ * Drops reviewId from the URL when the editor opens a page the review does not
+ * cover, or the review is gone or not accessible. Runs on page changes only, so
+ * opening a review while another page is shown keeps the id until the user
+ * moves on.
+ */
+export declare function useLeftoverReviewIdCleanup(target: ReviewScopeTarget | undefined, enabled: boolean): void;

package/dist/editor/reviews/reviewUrlScope.js

@@ -0,0 +1,86 @@
+import { useEffect, useRef } from "react";
+import { getReviewStatus } from "../services/reviewsService";
+// The editor keeps reviewId in its URL so review pages load review-scoped
+// comments and suggestions. The id belongs there only while the user is on a
+// page the review covers; once they browse elsewhere it is a leftover.
+const REVIEW_ID_PARAM = "reviewId";
+function normalizeId(id) {
+    return id.replace(/[{}]/g, "").trim().toLowerCase();
+}
+/** Same rules as CollectionMembershipService.IsMember on the server. */
+export function reviewCoversItem(items, target) {
+    const targetId = normalizeId(target.id);
+    const languageMatches = (item) => item.language === target.language || item.language === "*";
+    if (items.some((item) => normalizeId(item.itemId) === targetId && languageMatches(item))) {
+        return true;
+    }
+    const ancestorIds = new Set((target.idPath ?? "").split("/").filter(Boolean).map(normalizeId));
+    return items.some((item) => item.includeSubitems &&
+        languageMatches(item) &&
+        ancestorIds.has(normalizeId(item.itemId)));
+}
+export function getReviewIdFromUrl() {
+    if (typeof window === "undefined")
+        return null;
+    return new URLSearchParams(window.location.search).get(REVIEW_ID_PARAM);
+}
+/** Sets or removes reviewId in place, without adding a history entry. */
+export function setReviewIdInUrl(reviewId) {
+    if (typeof window === "undefined")
+        return;
+    const params = new URLSearchParams(window.location.search);
+    if ((params.get(REVIEW_ID_PARAM) ?? undefined) === reviewId)
+        return;
+    if (reviewId)
+        params.set(REVIEW_ID_PARAM, reviewId);
+    else
+        params.delete(REVIEW_ID_PARAM);
+    const query = params.toString();
+    const pathname = window.location.pathname;
+    window.history.replaceState(window.history.state, "", query ? `${pathname}?${query}` : pathname);
+}
+/**
+ * Drops reviewId from the URL when the editor opens a page the review does not
+ * cover, or the review is gone or not accessible. Runs on page changes only, so
+ * opening a review while another page is shown keeps the id until the user
+ * moves on.
+ */
+export function useLeftoverReviewIdCleanup(target, enabled) {
+    const reviewItemsRef = useRef(new Map());
+    const itemId = target?.id;
+    const language = target?.language;
+    const idPath = target?.idPath;
+    useEffect(() => {
+        if (!enabled || !itemId || !language)
+            return;
+        const reviewId = getReviewIdFromUrl();
+        if (!reviewId)
+            return;
+        const pageTarget = { id: itemId, language, idPath };
+        const knownItems = reviewItemsRef.current.get(reviewId);
+        if (knownItems && reviewCoversItem(knownItems, pageTarget))
+            return;
+        let cancelled = false;
+        void getReviewStatus(reviewId).then((result) => {
+            if (cancelled || getReviewIdFromUrl() !== reviewId)
+                return;
+            if (result.type === "success" && result.data) {
+                reviewItemsRef.current.set(reviewId, result.data.items);
+                if (!reviewCoversItem(result.data.items, pageTarget)) {
+                    setReviewIdInUrl(undefined);
+                }
+                return;
+            }
+            // Deleted or inaccessible reviews scope nothing. Other failures may be
+            // transient, so the id stays.
+            const status = result.response?.status;
+            if (result.type === "error" && (status === 403 || status === 404)) {
+                setReviewIdInUrl(undefined);
+            }
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [enabled, itemId, language, idPath]);
+}
+//# sourceMappingURL=reviewUrlScope.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * Scroll helpers for the feedback surfaces.
+ *
+ * `Element.scrollIntoView` walks every scrollable ancestor and scrolls each
+ * one, and its `block` option only chooses the alignment. Inside the comment
+ * margin the nearest such ancestor is the overlay root that must never
+ * scroll, and in the list it is the editor shell. So every programmatic
+ * reveal names its container and only that container's `scrollTop` changes.
+ */
+export declare const FEEDBACK_SCROLLABLE_ATTRIBUTE = "data-feedback-scrollable";
+export type ScrollWithinOptions = {
+    behavior?: "auto" | "smooth";
+    block?: "nearest" | "center";
+};
+/**
+ * Scrolls `container` so that `element` (a descendant) is visible. Only the
+ * container's own scroll offset changes.
+ */
+export declare function scrollElementIntoContainer(element: HTMLElement, container: HTMLElement, { behavior, block }?: ScrollWithinOptions): void;
+/**
+ * The nearest ancestor (inclusive) marked as a feedback scroll container,
+ * stopping at `root` when given.
+ */
+export declare function findFeedbackScrollContainer(element: Element | null, root?: Element | null): HTMLElement | null;
+/**
+ * Reveals `element` inside its nearest feedback scroll container. Does nothing
+ * when no container is found; it never falls back to `scrollIntoView`.
+ */
+export declare function revealInFeedbackScrollContainer(element: HTMLElement, options?: ScrollWithinOptions): boolean;

package/dist/editor/reviews/scrollWithin.js

@@ -0,0 +1,87 @@
+/**
+ * Scroll helpers for the feedback surfaces.
+ *
+ * `Element.scrollIntoView` walks every scrollable ancestor and scrolls each
+ * one, and its `block` option only chooses the alignment. Inside the comment
+ * margin the nearest such ancestor is the overlay root that must never
+ * scroll, and in the list it is the editor shell. So every programmatic
+ * reveal names its container and only that container's `scrollTop` changes.
+ */
+export const FEEDBACK_SCROLLABLE_ATTRIBUTE = "data-feedback-scrollable";
+function getPreferredBehavior(behavior) {
+    if (behavior !== "smooth")
+        return "auto";
+    if (typeof window !== "undefined" &&
+        typeof window.matchMedia === "function" &&
+        window.matchMedia("(prefers-reduced-motion: reduce)").matches) {
+        return "auto";
+    }
+    return "smooth";
+}
+/**
+ * Scrolls `container` so that `element` (a descendant) is visible. Only the
+ * container's own scroll offset changes.
+ */
+export function scrollElementIntoContainer(element, container, { behavior = "auto", block = "nearest" } = {}) {
+    const elementRect = element.getBoundingClientRect();
+    const containerRect = container.getBoundingClientRect();
+    const viewTop = container.scrollTop;
+    const viewHeight = container.clientHeight;
+    if (viewHeight <= 0)
+        return;
+    const offsetTop = elementRect.top - containerRect.top + viewTop;
+    const offsetBottom = offsetTop + elementRect.height;
+    const viewBottom = viewTop + viewHeight;
+    let target;
+    if (block === "center") {
+        target = offsetTop - (viewHeight - elementRect.height) / 2;
+    }
+    else if (offsetTop < viewTop) {
+        target = offsetTop;
+    }
+    else if (offsetBottom > viewBottom) {
+        target = offsetBottom - viewHeight;
+    }
+    else {
+        return;
+    }
+    const maxScrollTop = Math.max(0, container.scrollHeight - viewHeight);
+    target = Math.min(maxScrollTop, Math.max(0, target));
+    if (Math.abs(target - viewTop) < 0.5)
+        return;
+    const resolvedBehavior = getPreferredBehavior(behavior);
+    if (resolvedBehavior === "smooth" && typeof container.scrollTo === "function") {
+        container.scrollTo({ top: target, behavior: "smooth" });
+        return;
+    }
+    container.scrollTop = target;
+}
+/**
+ * The nearest ancestor (inclusive) marked as a feedback scroll container,
+ * stopping at `root` when given.
+ */
+export function findFeedbackScrollContainer(element, root) {
+    let current = element;
+    while (current) {
+        if (current instanceof HTMLElement &&
+            current.hasAttribute(FEEDBACK_SCROLLABLE_ATTRIBUTE)) {
+            return current;
+        }
+        if (root && current === root)
+            return null;
+        current = current.parentElement;
+    }
+    return null;
+}
+/**
+ * Reveals `element` inside its nearest feedback scroll container. Does nothing
+ * when no container is found; it never falls back to `scrollIntoView`.
+ */
+export function revealInFeedbackScrollContainer(element, options) {
+    const container = findFeedbackScrollContainer(element.parentElement);
+    if (!container)
+        return false;
+    scrollElementIntoContainer(element, container, options);
+    return true;
+}
+//# sourceMappingURL=scrollWithin.js.map

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

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

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

@@ -0,0 +1,57 @@
+import type { Comment, SuggestedEdit } from "../../types";
+import { type FeedbackThread } from "./feedbackThreads";
+/** The raw feedback under one root item, as the backend returns it. */
+export type SubtreeFeedback = {
+    comments: Comment[];
+    suggestedEdits: SuggestedEdit[];
+};
+/** One item under the root together with its (filtered) feedback threads. */
+export type SubtreeFeedbackItemGroup = {
+    /** `${itemId}|${language}`, item id normalized. */
+    key: string;
+    itemId: string;
+    language: string;
+    /** The latest version of the item; the backend only returns feedback on it. */
+    version: number;
+    name: string;
+    /** The threads that pass the current filters, most recent activity first. */
+    threads: FeedbackThread[];
+    /** Unresolved threads on the item, regardless of the filters. */
+    openCount: number;
+    /** Resolved comment threads and applied suggestions, regardless of the filters. */
+    resolvedCount: number;
+    /** Most recent thread creation time on the item, regardless of the filters. */
+    lastActivity: number;
+};
+export type SubtreeFeedbackSummary = {
+    items: number;
+    open: number;
+    resolved: number;
+};
+export declare function normalizeFeedbackItemId(id: string | undefined): string;
+export declare function getSubtreeFeedbackGroupKey(itemId: string, language: string): string;
+/**
+ * Loads the comments and suggested edits under a root item in one language.
+ * Feedback deleted in this session is dropped, like every other surface does.
+ */
+export declare function loadSubtreeFeedback(rootItemId: string, language: string): Promise<SubtreeFeedback>;
+/**
+ * Groups the feedback under a root by the item it was given on. Every group
+ * carries its counts over all threads (so the header stays informative while
+ * filters hide threads) and the threads that pass the filters. Items whose
+ * every thread is filtered out are omitted; groups are ordered by their most
+ * recent activity.
+ */
+export declare function groupSubtreeFeedback({ comments, suggestedEdits, showResolved, selectedPeople, }: SubtreeFeedback & {
+    showResolved: boolean;
+    /** Author account names; empty means everyone. */
+    selectedPeople: string[];
+}): SubtreeFeedbackItemGroup[];
+export declare function summarizeSubtreeFeedback(groups: SubtreeFeedbackItemGroup[]): SubtreeFeedbackSummary;
+/** The authors found in the loaded feedback, for the people filter. */
+export declare function collectSubtreeFeedbackAuthors(feedback: SubtreeFeedback, getAuthorName: (item: Comment | SuggestedEdit) => string): {
+    id: string;
+    name: string;
+}[];
+/** A one-line, image-free preview of a thread for the sidebar list. */
+export declare function getFeedbackThreadPreview(thread: FeedbackThread): string;

package/dist/editor/reviews/subtreeFeedback.js

@@ -0,0 +1,137 @@
+import { getSubtreeComments } from "../services/reviewsService";
+import { getSubtreeSuggestedEdits } from "../services/suggestedEditsService";
+import { filterRemovedComments } from "./commentState";
+import { isResolvedFeedbackItem } from "./feedbackOrdering";
+import { buildFeedbackThreads } from "./feedbackThreads";
+import { isSuggestedEditRemoved } from "./suggestedEditState";
+export function normalizeFeedbackItemId(id) {
+    return (id || "").replace(/[{}]/g, "").toLowerCase();
+}
+export function getSubtreeFeedbackGroupKey(itemId, language) {
+    return `${normalizeFeedbackItemId(itemId)}|${(language || "").toLowerCase()}`;
+}
+/**
+ * Loads the comments and suggested edits under a root item in one language.
+ * Feedback deleted in this session is dropped, like every other surface does.
+ */
+export async function loadSubtreeFeedback(rootItemId, language) {
+    const [commentsResult, suggestionsResult] = await Promise.all([
+        getSubtreeComments(rootItemId, language),
+        getSubtreeSuggestedEdits(rootItemId, language),
+    ]);
+    if (commentsResult.type !== "success") {
+        throw new Error(commentsResult.summary || "Failed to load comments");
+    }
+    if (suggestionsResult.type !== "success") {
+        throw new Error(suggestionsResult.summary || "Failed to load suggestions");
+    }
+    return {
+        comments: filterRemovedComments(commentsResult.data || []),
+        suggestedEdits: (suggestionsResult.data || []).filter((edit) => !isSuggestedEditRemoved(edit.id)),
+    };
+}
+function isResolvedThread(thread) {
+    return thread.kind === "comment"
+        ? isResolvedFeedbackItem(thread.root)
+        : isResolvedFeedbackItem(thread.suggestion);
+}
+/**
+ * Groups the feedback under a root by the item it was given on. Every group
+ * carries its counts over all threads (so the header stays informative while
+ * filters hide threads) and the threads that pass the filters. Items whose
+ * every thread is filtered out are omitted; groups are ordered by their most
+ * recent activity.
+ */
+export function groupSubtreeFeedback({ comments, suggestedEdits, showResolved, selectedPeople, }) {
+    const groups = new Map();
+    const groupFor = (itemId, language, version, name) => {
+        const key = getSubtreeFeedbackGroupKey(itemId, language);
+        let group = groups.get(key);
+        if (!group) {
+            group = {
+                itemId,
+                language,
+                version,
+                name: name || "",
+                comments: [],
+                suggestedEdits: [],
+            };
+            groups.set(key, group);
+        }
+        else if (!group.name && name) {
+            group.name = name;
+        }
+        return group;
+    };
+    comments.forEach((comment) => {
+        groupFor(comment.mainItemId, comment.language, comment.version, comment.mainItemName).comments.push(comment);
+    });
+    suggestedEdits.forEach((edit) => {
+        groupFor(edit.mainItemId, edit.mainItemLanguage, edit.mainItemVersion, edit.mainItemName).suggestedEdits.push(edit);
+    });
+    const result = [];
+    groups.forEach((group, key) => {
+        const allThreads = buildFeedbackThreads({
+            comments: group.comments,
+            suggestedEdits: group.suggestedEdits,
+            showResolved: true,
+            selectedPeople: [],
+        });
+        if (allThreads.length === 0)
+            return;
+        const threads = buildFeedbackThreads({
+            comments: group.comments,
+            suggestedEdits: group.suggestedEdits,
+            showResolved,
+            selectedPeople,
+        });
+        if (threads.length === 0)
+            return;
+        const resolvedCount = allThreads.filter(isResolvedThread).length;
+        result.push({
+            key,
+            itemId: group.itemId,
+            language: group.language,
+            version: group.version,
+            name: group.name,
+            threads,
+            openCount: allThreads.length - resolvedCount,
+            resolvedCount,
+            lastActivity: allThreads.reduce((latest, thread) => Math.max(latest, thread.created), 0),
+        });
+    });
+    return result.sort((a, b) => b.lastActivity - a.lastActivity);
+}
+export function summarizeSubtreeFeedback(groups) {
+    return groups.reduce((summary, group) => ({
+        items: summary.items + 1,
+        open: summary.open + group.openCount,
+        resolved: summary.resolved + group.resolvedCount,
+    }), { items: 0, open: 0, resolved: 0 });
+}
+/** The authors found in the loaded feedback, for the people filter. */
+export function collectSubtreeFeedbackAuthors(feedback, getAuthorName) {
+    const authors = new Map();
+    [...feedback.comments, ...feedback.suggestedEdits].forEach((item) => {
+        const author = item.author?.trim();
+        if (author && !authors.has(author)) {
+            authors.set(author, getAuthorName(item));
+        }
+    });
+    return Array.from(authors.entries())
+        .map(([id, name]) => ({ id, name }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+const commentImagePattern = /!\[[^\]]*\]\([^)]*\)/g;
+/** A one-line, image-free preview of a thread for the sidebar list. */
+export function getFeedbackThreadPreview(thread) {
+    const text = thread.kind === "comment"
+        ? thread.root.text || ""
+        : thread.suggestion.newValue || thread.comments[0]?.text || "";
+    return text
+        .replace(commentImagePattern, "")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=subtreeFeedback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subtreeFeedback.js","sourceRoot":"","sources":["../../../src/editor/reviews/subtreeFeedback.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAuB,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAiC9D,MAAM,UAAU,uBAAuB,CAAC,EAAsB;IAC5D,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAc,EAAE,QAAgB;IACzE,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,QAAgB;IAEhB,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5D,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC;QACxC,wBAAwB,CAAC,UAAU,EAAE,QAAQ,CAAC;KAC/C,CAAC,CAAC;IAEH,IAAI,cAAc,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,OAAO,IAAI,yBAAyB,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,iBAAiB,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,OAAO,IAAI,4BAA4B,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,qBAAqB,CAAC,cAAc,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1D,cAAc,EAAE,CAAC,iBAAiB,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CACnD,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAC3C;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAsB;IAC9C,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS;QAC9B,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC;QACrC,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAChD,CAAC;AAWD;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,cAAc,GAKf;IACC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEnD,MAAM,QAAQ,GAAG,CACf,MAAc,EACd,QAAgB,EAChB,OAAe,EACf,IAAwB,EACxB,EAAE;QACF,MAAM,GAAG,GAAG,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACzD,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG;gBACN,MAAM;gBACN,QAAQ;gBACR,OAAO;gBACP,IAAI,EAAE,IAAI,IAAI,EAAE;gBAChB,QAAQ,EAAE,EAAE;gBACZ,cAAc,EAAE,EAAE;aACnB,CAAC;YACF,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC3B,QAAQ,CACN,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,YAAY,CACrB,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,cAAc,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC9B,QAAQ,CACN,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,YAAY,CAClB,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAA+B,EAAE,CAAC;IAE9C,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,oBAAoB,CAAC;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,EAAE;SACnB,CAAC,CAAC;QACH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEpC,MAAM,OAAO,GAAG,oBAAoB,CAAC;YACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,YAAY;YACZ,cAAc;SACf,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEjC,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;QAEjE,MAAM,CAAC,IAAI,CAAC;YACV,GAAG;YACH,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO;YACP,SAAS,EAAE,UAAU,CAAC,MAAM,GAAG,aAAa;YAC5C,aAAa;YACb,YAAY,EAAE,UAAU,CAAC,MAAM,CAC7B,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EACpD,CAAC,CACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,MAAkC;IAElC,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC,KAAK,GAAG,CAAC;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,SAAS;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,aAAa;KACjD,CAAC,EACF,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CACnC,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,6BAA6B,CAC3C,QAAyB,EACzB,aAAwD;IAExD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACnC,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;SACnC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AAEpD,uEAAuE;AACvE,MAAM,UAAU,wBAAwB,CAAC,MAAsB;IAC7D,MAAM,IAAI,GACR,MAAM,CAAC,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE;QACxB,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACnE,OAAO,IAAI;SACR,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC"}

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

@@ -0,0 +1,80 @@
+import React from "react";
+import { type CommentImageScope } from "./commentImages";
+export type CommentImageAttachmentStatus = "uploading" | "done" | "error";
+export interface CommentImageAttachment {
+    /** Local key; stable across upload and removal. */
+    key: string;
+    /** Server image id once uploaded. */
+    imageId?: string;
+    /** Object URL of the pasted file, or the served image URL for existing images. */
+    previewUrl: string;
+    fileName: string;
+    status: CommentImageAttachmentStatus;
+    error?: string;
+}
+export interface UseCommentImagePasteOptions {
+    scope: CommentImageScope;
+    /** Main item id (review comments) or task id (task comments) the composer targets. */
+    scopeId?: string | null;
+    /** Item language for review comments; lets reviewers without Sitecore read access upload. */
+    scopeLanguage?: string | null;
+    /** Comment text being edited; image references in it become attachments. */
+    initialText?: string;
+    /**
+     * Attachments restored from a persisted draft. When given they replace the
+     * ones derived from `initialText`, uploads still in flight are resumed, and
+     * preview URLs are not revoked on unmount (the draft owner keeps them).
+     */
+    initialAttachments?: CommentImageAttachment[];
+    /** Mirrors every attachment change, for draft persistence. */
+    onAttachmentsChange?: (attachments: CommentImageAttachment[]) => void;
+    disabled?: boolean;
+}
+export interface CommentImagePasteState {
+    /** Attach to the composer textarea (`onPaste`). Handles Ctrl+V of image data. */
+    onPaste: (event: React.ClipboardEvent<HTMLTextAreaElement>) => void;
+    /**
+     * Attach to the composer textarea (`onDragOver`). A textarea only accepts a
+     * drop of files (as opposed to text) when drag-over is cancelled; without
+     * this the browser opens the dropped image instead of firing `onDrop`.
+     */
+    onDragOver: (event: React.DragEvent<HTMLTextAreaElement>) => void;
+    /** Attach to the composer textarea (`onDrop`). Handles dropped image files. */
+    onDrop: (event: React.DragEvent<HTMLTextAreaElement>) => void;
+    /** Thumbnails to show above the textarea, in paste order. */
+    attachments: CommentImageAttachment[];
+    removeAttachment: (key: string) => void;
+    /** Drops every attachment, e.g. after the comment was posted or cancelled. */
+    clearAttachments: () => void;
+    /** True while at least one attachment is still uploading. */
+    uploading: boolean;
+    /** Uploaded images that will be part of the comment. */
+    readyCount: number;
+    /**
+     * Resolves once no upload is pending for the current target, so a submit
+     * triggered mid-upload can wait for the image references.
+     */
+    waitForUploads: () => Promise<void>;
+    /** The text to save: the typed text plus one reference line per uploaded image. */
+    buildSubmitText: (text: string) => string;
+}
+/**
+ * Splits the text of a comment being edited into the plain text and the
+ * attachments for the images it references. Order of the images is kept;
+ * on save they are appended after the text again.
+ */
+export declare function splitInitialCommentText(initialText: string | undefined): {
+    text: string;
+    attachments: CommentImageAttachment[];
+};
+/**
+ * Lets a comment composer accept pasted (or dropped) screenshots. Each image
+ * shows up as a thumbnail above the textarea while it uploads; the composer
+ * keeps typing text only, and `buildSubmitText` appends one markdown
+ * reference line per uploaded image when the comment is saved.
+ *
+ * Uploads are bound to the composer target: when `scope`/`scopeId` change while
+ * an upload is in flight (e.g. the task panel switches tasks), the attachments
+ * are dropped instead of ending up on the new target's comment.
+ */
+export declare function useCommentImagePaste({ scope, scopeId, scopeLanguage, initialText, initialAttachments, onAttachmentsChange, disabled, }: UseCommentImagePasteOptions): CommentImagePasteState;