@parhelia/core 0.3.12831 → 0.3.12833

package/dist/editor/reviews/useCommentImagePaste.js

@@ -0,0 +1,252 @@
+import React from "react";
+import { buildCommentImageMarkdown, getImageFilesFromDataTransfer, splitCommentImages, uploadCommentImage, } from "./commentImages";
+/**
+ * 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 function splitInitialCommentText(initialText) {
+    if (!initialText)
+        return { text: "", attachments: [] };
+    const attachments = [];
+    const textParts = [];
+    for (const segment of splitCommentImages(initialText)) {
+        if (segment.type === "image") {
+            attachments.push({
+                key: `existing-${segment.imageId}`,
+                imageId: segment.imageId,
+                previewUrl: segment.src,
+                fileName: `${segment.alt}.png`,
+                status: "done",
+            });
+        }
+        else {
+            textParts.push(segment.value);
+        }
+    }
+    return { text: textParts.join("\n").trim(), attachments };
+}
+let attachmentSequence = 0;
+// Uploads keyed by attachment key, kept briefly after they settle, so a
+// composer remounted with a persisted draft can pick up an upload that was
+// still running when the previous instance unmounted.
+const inflightUploads = new Map();
+const INFLIGHT_RETENTION_MS = 30_000;
+function rememberUpload(key, upload) {
+    inflightUploads.set(key, upload);
+    const forget = () => {
+        window.setTimeout(() => {
+            if (inflightUploads.get(key) === upload)
+                inflightUploads.delete(key);
+        }, INFLIGHT_RETENTION_MS);
+    };
+    upload.then(forget, forget);
+}
+/**
+ * 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 function useCommentImagePaste({ scope, scopeId, scopeLanguage, initialText, initialAttachments, onAttachmentsChange, disabled = false, }) {
+    const persistent = initialAttachments !== undefined;
+    const [attachments, setAttachments] = React.useState(() => initialAttachments ?? splitInitialCommentText(initialText).attachments);
+    const attachmentsRef = React.useRef(attachments);
+    attachmentsRef.current = attachments;
+    const onAttachmentsChangeRef = React.useRef(onAttachmentsChange);
+    onAttachmentsChangeRef.current = onAttachmentsChange;
+    const persistentRef = React.useRef(persistent);
+    persistentRef.current = persistent;
+    React.useEffect(() => {
+        onAttachmentsChangeRef.current?.(attachments);
+    }, [attachments]);
+    const waitersRef = React.useRef([]);
+    const mountedRef = React.useRef(true);
+    // Every target change starts a new generation; uploads remember the generation
+    // they started in and become no-ops once it moves on.
+    const targetKey = `${scope}:${scopeId ?? ""}`;
+    const targetKeyRef = React.useRef(targetKey);
+    const generationRef = React.useRef(0);
+    const pendingCount = React.useMemo(() => attachments.filter((a) => a.status === "uploading").length, [attachments]);
+    const readyCount = React.useMemo(() => attachments.filter((a) => a.status === "done" && a.imageId).length, [attachments]);
+    const resolveWaiters = React.useCallback(() => {
+        const waiters = waitersRef.current;
+        waitersRef.current = [];
+        waiters.forEach((resolve) => resolve());
+    }, []);
+    React.useEffect(() => {
+        if (pendingCount === 0)
+            resolveWaiters();
+    }, [pendingCount, resolveWaiters]);
+    const revokePreview = (attachment) => {
+        if (attachment.previewUrl.startsWith("blob:")) {
+            URL.revokeObjectURL(attachment.previewUrl);
+        }
+    };
+    React.useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+            generationRef.current += 1;
+            // A persisted draft keeps its thumbnails alive across remounts.
+            if (!persistentRef.current) {
+                attachmentsRef.current.forEach(revokePreview);
+            }
+            resolveWaiters();
+        };
+    }, [resolveWaiters]);
+    const clearAttachments = React.useCallback(() => {
+        generationRef.current += 1;
+        attachmentsRef.current.forEach(revokePreview);
+        setAttachments([]);
+        resolveWaiters();
+    }, [resolveWaiters]);
+    React.useEffect(() => {
+        if (targetKeyRef.current === targetKey)
+            return;
+        targetKeyRef.current = targetKey;
+        clearAttachments();
+    }, [clearAttachments, targetKey]);
+    const updateAttachment = React.useCallback((key, patch) => {
+        setAttachments((current) => current.map((a) => (a.key === key ? { ...a, ...patch } : a)));
+    }, []);
+    // Resume uploads that a previous composer instance started for this draft.
+    React.useEffect(() => {
+        const generation = generationRef.current;
+        const isStale = () => !mountedRef.current || generation !== generationRef.current;
+        attachmentsRef.current.forEach((attachment) => {
+            if (attachment.status !== "uploading")
+                return;
+            const pending = inflightUploads.get(attachment.key);
+            if (!pending) {
+                updateAttachment(attachment.key, {
+                    status: "error",
+                    error: "Image upload was interrupted",
+                });
+                return;
+            }
+            pending.then((uploaded) => {
+                if (isStale())
+                    return;
+                updateAttachment(attachment.key, {
+                    imageId: uploaded.imageId,
+                    status: "done",
+                });
+            }, (err) => {
+                if (isStale())
+                    return;
+                updateAttachment(attachment.key, {
+                    status: "error",
+                    error: err instanceof Error && err.message
+                        ? err.message
+                        : "Image upload failed",
+                });
+            });
+        });
+        // Runs once per mount: only attachments restored from a draft can be mid-upload.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    const uploadFiles = React.useCallback(async (files) => {
+        const generation = generationRef.current;
+        const isStale = () => !mountedRef.current || generation !== generationRef.current;
+        const created = files.map((file) => ({
+            key: `pasted-${Date.now()}-${attachmentSequence++}`,
+            previewUrl: URL.createObjectURL(file),
+            fileName: file.name,
+            status: "uploading",
+        }));
+        setAttachments((current) => [...current, ...created]);
+        for (let index = 0; index < files.length; index++) {
+            const file = files[index];
+            const key = created[index].key;
+            try {
+                const upload = uploadCommentImage(file, scope, scopeId, scopeLanguage);
+                rememberUpload(key, upload);
+                const uploaded = await upload;
+                if (isStale())
+                    return;
+                updateAttachment(key, { imageId: uploaded.imageId, status: "done" });
+            }
+            catch (err) {
+                if (isStale())
+                    return;
+                updateAttachment(key, {
+                    status: "error",
+                    error: err instanceof Error && err.message
+                        ? err.message
+                        : "Image upload failed",
+                });
+            }
+        }
+    }, [scope, scopeId, scopeLanguage, updateAttachment]);
+    const removeAttachment = React.useCallback((key) => {
+        setAttachments((current) => {
+            const target = current.find((a) => a.key === key);
+            if (target)
+                revokePreview(target);
+            return current.filter((a) => a.key !== key);
+        });
+    }, []);
+    const onPaste = React.useCallback((event) => {
+        if (disabled)
+            return;
+        const files = getImageFilesFromDataTransfer(event.clipboardData);
+        if (files.length === 0)
+            return;
+        event.preventDefault();
+        void uploadFiles(files);
+    }, [disabled, uploadFiles]);
+    const onDragOver = React.useCallback((event) => {
+        if (disabled)
+            return;
+        // File lists are not readable during drag-over; the types tell us enough.
+        const types = Array.from(event.dataTransfer?.types ?? []);
+        if (!types.includes("Files"))
+            return;
+        event.preventDefault();
+        event.dataTransfer.dropEffect = "copy";
+    }, [disabled]);
+    const onDrop = React.useCallback((event) => {
+        if (disabled)
+            return;
+        const files = getImageFilesFromDataTransfer(event.dataTransfer);
+        if (files.length === 0)
+            return;
+        event.preventDefault();
+        void uploadFiles(files);
+    }, [disabled, uploadFiles]);
+    const waitForUploads = React.useCallback(() => new Promise((resolve) => {
+        const pending = attachmentsRef.current.some((a) => a.status === "uploading");
+        if (!pending) {
+            resolve();
+            return;
+        }
+        waitersRef.current.push(resolve);
+    }), []);
+    const buildSubmitText = React.useCallback((text) => {
+        const references = attachmentsRef.current
+            .filter((a) => a.status === "done" && a.imageId)
+            .map((a) => buildCommentImageMarkdown(a.imageId));
+        const body = text.trim();
+        if (references.length === 0)
+            return body;
+        return body ? `${body}\n${references.join("\n")}` : references.join("\n");
+    }, []);
+    return {
+        onPaste,
+        onDragOver,
+        onDrop,
+        attachments,
+        removeAttachment,
+        clearAttachments,
+        uploading: pendingCount > 0,
+        readyCount,
+        waitForUploads,
+        buildSubmitText,
+    };
+}
+//# sourceMappingURL=useCommentImagePaste.js.map

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

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

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

@@ -0,0 +1,35 @@
+import type { FeedbackItem } from "./feedbackOrdering";
+import { type FeedbackSort, type FeedbackThread } from "./feedbackThreads";
+export declare function formatAccountName(userName?: string): string;
+export declare function getStoredAuthorName(item: FeedbackItem): string | undefined;
+export type FeedbackAuthorOption = {
+    id: string;
+    name: string;
+};
+export type UseFeedbackThreadsOptions = {
+    /** Explicit ordering (the list); the margin orders by anchor and omits it. */
+    sort?: FeedbackSort;
+};
+export type UseFeedbackThreadsResult = {
+    threads: FeedbackThread[];
+    availableAuthors: FeedbackAuthorOption[];
+    selectedPersonFilter: string[];
+    setSelectedPersonFilter: (people: string[]) => void;
+    resolvedAuthorNames: Record<string, string>;
+    getAuthorName: (item: FeedbackItem) => string;
+    availableTags: {
+        label: string;
+        color: string;
+    }[];
+    showResolved: boolean;
+    setShowResolved: (showResolved: boolean) => void;
+    suggestionsAvailable: boolean;
+    isSuggestionsMode: boolean;
+    commentsLoaded: boolean;
+};
+/**
+ * The data behind every feedback surface: the loaded comments and suggested
+ * edits as filtered, grouped threads, plus the shared filter state and author
+ * display-name resolution.
+ */
+export declare function useFeedbackThreads(options?: UseFeedbackThreadsOptions): UseFeedbackThreadsResult;

package/dist/editor/reviews/useFeedbackThreads.js

@@ -0,0 +1,137 @@
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useEditContext } from "../client/editContext";
+import { searchUsers } from "../services/userService";
+import { setFeedbackPersonFilter, useFeedbackPersonFilter, } from "./feedbackPersonFilter";
+import { buildFeedbackThreads, } from "./feedbackThreads";
+import { isSuggestionsModeAvailable } from "./openCommentsFeedback";
+export function formatAccountName(userName) {
+    const trimmed = userName?.trim();
+    if (!trimmed)
+        return "Unknown";
+    const slashIndex = trimmed.lastIndexOf("\\");
+    if (slashIndex >= 0 && slashIndex < trimmed.length - 1) {
+        return trimmed.slice(slashIndex + 1);
+    }
+    return trimmed;
+}
+export function getStoredAuthorName(item) {
+    const storedDisplayName = item.authorDisplayName?.trim();
+    const author = item.author?.trim() || "";
+    if (storedDisplayName &&
+        storedDisplayName.localeCompare(author, undefined, {
+            sensitivity: "accent",
+        }) !== 0) {
+        return storedDisplayName;
+    }
+    return undefined;
+}
+/**
+ * The data behind every feedback surface: the loaded comments and suggested
+ * edits as filtered, grouped threads, plus the shared filter state and author
+ * display-name resolution.
+ */
+export function useFeedbackThreads(options = {}) {
+    const editContext = useEditContext();
+    const [resolvedAuthorNames, setResolvedAuthorNames] = useState({});
+    const selectedPersonFilter = useFeedbackPersonFilter();
+    const setSelectedPersonFilter = setFeedbackPersonFilter;
+    const comments = editContext?.comments;
+    const suggestedEdits = editContext?.suggestedEdits;
+    const showResolved = !!editContext?.showResolvedComments;
+    const threads = useMemo(() => buildFeedbackThreads({
+        comments: comments || [],
+        suggestedEdits: suggestedEdits || [],
+        showResolved,
+        selectedPeople: selectedPersonFilter,
+        sort: options.sort,
+    }), [
+        comments,
+        suggestedEdits,
+        showResolved,
+        selectedPersonFilter,
+        options.sort?.field,
+        options.sort?.direction,
+    ]);
+    const availableAuthors = useMemo(() => {
+        const authors = new Map();
+        (comments || []).forEach((c) => {
+            if (c.author) {
+                authors.set(c.author, getStoredAuthorName(c) ||
+                    resolvedAuthorNames[c.author] ||
+                    formatAccountName(c.author));
+            }
+        });
+        return Array.from(authors.entries()).map(([id, name]) => ({ id, name }));
+    }, [comments, resolvedAuthorNames]);
+    useEffect(() => {
+        const allFeedbackItems = [
+            ...(comments || []),
+            ...(suggestedEdits || []),
+        ];
+        const authors = Array.from(new Set(allFeedbackItems
+            .map((item) => item.author?.trim())
+            .filter((author) => !!author))).filter((author) => !resolvedAuthorNames[author]);
+        if (authors.length === 0)
+            return;
+        let cancelled = false;
+        const resolveAuthors = async () => {
+            const entries = await Promise.all(authors.map(async (author) => {
+                try {
+                    const users = await searchUsers(author, 5);
+                    const exact = users.find((user) => user.userName.localeCompare(author, undefined, {
+                        sensitivity: "accent",
+                    }) === 0) || users[0];
+                    const displayName = exact?.displayName?.trim();
+                    if (displayName &&
+                        displayName.localeCompare(author, undefined, {
+                            sensitivity: "accent",
+                        }) !== 0) {
+                        return [author, displayName];
+                    }
+                }
+                catch {
+                    // Best effort: older feedback may only have the account id stored.
+                }
+                return [author, formatAccountName(author)];
+            }));
+            if (cancelled)
+                return;
+            setResolvedAuthorNames((current) => {
+                const next = { ...current };
+                entries.forEach(([author, displayName]) => {
+                    next[author] = displayName;
+                });
+                return next;
+            });
+        };
+        resolveAuthors();
+        return () => {
+            cancelled = true;
+        };
+    }, [comments, suggestedEdits, resolvedAuthorNames]);
+    const getAuthorName = useCallback((item) => {
+        const storedName = getStoredAuthorName(item);
+        if (storedName)
+            return storedName;
+        if (item.author && resolvedAuthorNames[item.author]) {
+            return resolvedAuthorNames[item.author];
+        }
+        return formatAccountName(item.author);
+    }, [resolvedAuthorNames]);
+    const setShowResolved = useCallback((value) => editContext?.setShowResolvedComments(value), [editContext]);
+    return {
+        threads,
+        availableAuthors,
+        selectedPersonFilter,
+        setSelectedPersonFilter,
+        resolvedAuthorNames,
+        getAuthorName,
+        availableTags: editContext?.availableCommentTags || [],
+        showResolved,
+        setShowResolved,
+        suggestionsAvailable: isSuggestionsModeAvailable(editContext),
+        isSuggestionsMode: editContext?.mode === "suggestions",
+        commentsLoaded: !!editContext?.commentsLoaded,
+    };
+}
+//# sourceMappingURL=useFeedbackThreads.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Tracks the rendered height of many elements (the margin cards).
+ *
+ * Cards register their element through a stable callback ref. Heights are
+ * read with `getBoundingClientRect` in `syncMeasurements`, which the owner
+ * calls from a layout effect after each of its renders, and which a
+ * MutationObserver on the column (`observeMutations`) triggers after any DOM
+ * change inside a card (composer opened, text expanded, replies unfolded).
+ * A ResizeObserver covers size changes without DOM mutations (images).
+ *
+ * The ref callback returns a cleanup bound to its element, and an id may
+ * hold several elements at once: a thread can be mounted twice for a moment
+ * (the new card attaches before the stale one detaches, or a transient copy
+ * appears in the footer while the anchored card stays). Measurements always
+ * use the element that is still connected.
+ */
+export declare function useMeasuredHeights(): {
+    heights: Record<string, number>;
+    registerCard: (id: string) => (element: HTMLElement | null) => (() => void) | void;
+    prune: (liveIds: Iterable<string>) => void;
+    syncMeasurements: (options?: {
+        all?: boolean;
+    }) => void;
+    observeMutations: (root: Element | null) => () => void;
+};

package/dist/editor/reviews/useMeasuredHeights.js

@@ -0,0 +1,176 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+/**
+ * Tracks the rendered height of many elements (the margin cards).
+ *
+ * Cards register their element through a stable callback ref. Heights are
+ * read with `getBoundingClientRect` in `syncMeasurements`, which the owner
+ * calls from a layout effect after each of its renders, and which a
+ * MutationObserver on the column (`observeMutations`) triggers after any DOM
+ * change inside a card (composer opened, text expanded, replies unfolded).
+ * A ResizeObserver covers size changes without DOM mutations (images).
+ *
+ * The ref callback returns a cleanup bound to its element, and an id may
+ * hold several elements at once: a thread can be mounted twice for a moment
+ * (the new card attaches before the stale one detaches, or a transient copy
+ * appears in the footer while the anchored card stays). Measurements always
+ * use the element that is still connected.
+ */
+export function useMeasuredHeights() {
+    const [heights, setHeights] = useState({});
+    const heightsRef = useRef(heights);
+    heightsRef.current = heights;
+    const observerRef = useRef(null);
+    const elementsRef = useRef(new Map());
+    const observedRef = useRef(new WeakSet());
+    const idsRef = useRef(new WeakMap());
+    const callbacksRef = useRef(new Map());
+    const frameRef = useRef(null);
+    const applyHeights = useCallback((patch) => {
+        setHeights((current) => {
+            let next = null;
+            for (const [id, height] of Object.entries(patch)) {
+                if ((next ?? current)[id] === height)
+                    continue;
+                next ??= { ...current };
+                next[id] = height;
+            }
+            return next ?? current;
+        });
+    }, []);
+    const getObserver = useCallback(() => {
+        if (observerRef.current)
+            return observerRef.current;
+        if (typeof ResizeObserver === "undefined")
+            return null;
+        observerRef.current = new ResizeObserver((entries) => {
+            const patch = {};
+            for (const entry of entries) {
+                const id = idsRef.current.get(entry.target);
+                if (!id)
+                    continue;
+                patch[id] =
+                    entry.borderBoxSize?.[0]?.blockSize ?? entry.contentRect.height;
+            }
+            if (Object.keys(patch).length > 0)
+                applyHeights(patch);
+        });
+        return observerRef.current;
+    }, [applyHeights]);
+    const unregister = useCallback((id, element) => {
+        observerRef.current?.unobserve(element);
+        observedRef.current.delete(element);
+        idsRef.current.delete(element);
+        const elements = elementsRef.current.get(id);
+        if (!elements)
+            return;
+        elements.delete(element);
+        if (elements.size === 0)
+            elementsRef.current.delete(id);
+    }, []);
+    /** A stable callback ref for the element that renders thread `id`. */
+    const registerCard = useCallback((id) => {
+        const cached = callbacksRef.current.get(id);
+        if (cached)
+            return cached;
+        const callback = (element) => {
+            if (!element)
+                return undefined;
+            let elements = elementsRef.current.get(id);
+            if (!elements) {
+                elements = new Set();
+                elementsRef.current.set(id, elements);
+            }
+            elements.add(element);
+            idsRef.current.set(element, id);
+            return () => unregister(id, element);
+        };
+        callbacksRef.current.set(id, callback);
+        return callback;
+    }, [unregister]);
+    /**
+     * Observe every registered element and refresh heights from a direct
+     * measurement: unknown heights always, known ones when `all` is set.
+     */
+    const syncMeasurements = useCallback((options = {}) => {
+        const observer = getObserver();
+        let patch = null;
+        elementsRef.current.forEach((elements, id) => {
+            let live = null;
+            elements.forEach((element) => {
+                if (observer && !observedRef.current.has(element)) {
+                    observer.observe(element, { box: "border-box" });
+                    observedRef.current.add(element);
+                }
+                if (!live && element.isConnected)
+                    live = element;
+            });
+            if (!live)
+                return;
+            const known = heightsRef.current[id];
+            if (options.all || !(known > 0)) {
+                const height = live.getBoundingClientRect().height;
+                if (height > 0 && height !== known)
+                    (patch ??= {})[id] = height;
+            }
+        });
+        if (patch)
+            applyHeights(patch);
+    }, [getObserver, applyHeights]);
+    /**
+     * Re-measure after any DOM change under `root` (the column): cards grow and
+     * shrink through their own renders, which the owner cannot observe.
+     */
+    const observeMutations = useCallback((root) => {
+        if (!root || typeof MutationObserver === "undefined")
+            return () => { };
+        const schedule = () => {
+            if (frameRef.current != null)
+                return;
+            frameRef.current = window.requestAnimationFrame(() => {
+                frameRef.current = null;
+                syncMeasurements({ all: true });
+            });
+        };
+        const observer = new MutationObserver(schedule);
+        observer.observe(root, {
+            subtree: true,
+            childList: true,
+            attributes: true,
+            characterData: true,
+        });
+        return () => {
+            observer.disconnect();
+            if (frameRef.current != null) {
+                window.cancelAnimationFrame(frameRef.current);
+                frameRef.current = null;
+            }
+        };
+    }, [syncMeasurements]);
+    // Forget heights of cards that are no longer rendered anywhere.
+    const prune = useCallback((liveIds) => {
+        const keep = new Set(liveIds);
+        callbacksRef.current.forEach((_, id) => {
+            if (!keep.has(id) && !elementsRef.current.has(id)) {
+                callbacksRef.current.delete(id);
+            }
+        });
+        setHeights((current) => {
+            const stale = Object.keys(current).filter((id) => !keep.has(id));
+            if (stale.length === 0)
+                return current;
+            const next = { ...current };
+            stale.forEach((id) => delete next[id]);
+            return next;
+        });
+    }, []);
+    useEffect(() => () => {
+        // Drop the observer together with its bookkeeping. StrictMode runs
+        // this cleanup and then the layout effects again: with the observed
+        // set kept, nothing would be re-observed by the replacement observer.
+        observerRef.current?.disconnect();
+        observerRef.current = null;
+        observedRef.current = new WeakSet();
+    }, []);
+    return { heights, registerCard, prune, syncMeasurements, observeMutations };
+}
+//# sourceMappingURL=useMeasuredHeights.js.map

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

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