@parhelia/core 0.3.12832 → 0.3.12833

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

@@ -0,0 +1 @@
+{"version":3,"file":"commentAgentAttachments.js","sourceRoot":"","sources":["../../../src/editor/reviews/commentAgentAttachments.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAGf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE9E;;0EAE0E;AAC1E,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAAe,EACf,OAAiC,EACjC,SAA6B,EAC7B,KAA0C;IAE1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAClE,KAAK,MAAM,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3D,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;gBAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAA6B,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,MAAM,EAAE,CAAC;YACX,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QAED,2EAA2E;QAC3E,yEAAyE;QACzE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG;YAChB,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,KAAK;YAClB,YAAY,EAAE,MAAM;SACrB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,uBAAuB,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,iBAAiB,OAAO,IAAI,SAAS,EAAE,EAAE;YACrE,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,wCAAwC,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;QACzE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC3B,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * Images pasted into comments (review comments and task-board comments).
+ *
+ * A pasted image is uploaded to `/parhelia/comments/uploadImage` and referenced
+ * from the plain-text comment body as a markdown image whose URL points at the
+ * comment image endpoint. Only that endpoint is rendered as an image; any other
+ * markdown-looking text stays plain text, so comments cannot embed arbitrary URLs.
+ */
+export type CommentImageScope = "review" | "task";
+export declare const COMMENT_IMAGE_URL_PREFIX = "/parhelia/comments/image?id=";
+export declare const COMMENT_IMAGE_MAX_BYTES: number;
+export declare const DEFAULT_COMMENT_IMAGE_ALT = "screenshot";
+export type CommentTextSegment = {
+    type: "text";
+    value: string;
+} | {
+    type: "image";
+    alt: string;
+    src: string;
+    imageId: string;
+};
+export declare function buildCommentImageUrl(imageId: string): string;
+export declare function buildCommentImageMarkdown(imageId: string, alt?: string): string;
+/**
+ * Splits a comment body into plain-text runs and comment-image tokens. A single
+ * newline directly before or after an image token is folded into the token so
+ * block-rendered images do not produce blank lines in `whitespace-pre-wrap` text.
+ */
+export declare function splitCommentImages(text: string): CommentTextSegment[];
+export declare function commentHasImages(text: string | null | undefined): boolean;
+/** Replaces image tokens with their alt text, for one-line previews and notifications. */
+export declare function stripCommentImages(text: string | null | undefined): string;
+/**
+ * Inserts `insert` at the selection of a textarea value on its own line,
+ * returning the new value and the caret position after the insertion.
+ */
+export declare function insertCommentImageMarkdown(value: string, selectionStart: number, selectionEnd: number, insert: string): {
+    value: string;
+    cursor: number;
+};
+export { getImageFilesFromDataTransfer } from "../utils/dataTransferImages";
+export type CommentImageUploadResult = {
+    imageId: string;
+    url: string;
+    contentType?: string;
+    fileSize?: number;
+};
+export declare function uploadCommentImage(file: File, scope: CommentImageScope, scopeId?: string | null, scopeLanguage?: string | null): Promise<CommentImageUploadResult>;

package/dist/editor/reviews/commentImages.js

@@ -0,0 +1,128 @@
+/**
+ * Images pasted into comments (review comments and task-board comments).
+ *
+ * A pasted image is uploaded to `/parhelia/comments/uploadImage` and referenced
+ * from the plain-text comment body as a markdown image whose URL points at the
+ * comment image endpoint. Only that endpoint is rendered as an image; any other
+ * markdown-looking text stays plain text, so comments cannot embed arbitrary URLs.
+ */
+export const COMMENT_IMAGE_URL_PREFIX = "/parhelia/comments/image?id=";
+export const COMMENT_IMAGE_MAX_BYTES = 5 * 1024 * 1024;
+export const DEFAULT_COMMENT_IMAGE_ALT = "screenshot";
+const GUID_PATTERN = "[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}";
+const COMMENT_IMAGE_PATTERN = new RegExp(`!\\[([^\\]\\n]*)\\]\\(${COMMENT_IMAGE_URL_PREFIX.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(${GUID_PATTERN})\\)`, "g");
+export function buildCommentImageUrl(imageId) {
+    return `${COMMENT_IMAGE_URL_PREFIX}${imageId.toLowerCase()}`;
+}
+export function buildCommentImageMarkdown(imageId, alt = DEFAULT_COMMENT_IMAGE_ALT) {
+    const safeAlt = alt.replace(/[\]\n\r]/g, " ").trim() || DEFAULT_COMMENT_IMAGE_ALT;
+    return `![${safeAlt}](${buildCommentImageUrl(imageId)})`;
+}
+/**
+ * Splits a comment body into plain-text runs and comment-image tokens. A single
+ * newline directly before or after an image token is folded into the token so
+ * block-rendered images do not produce blank lines in `whitespace-pre-wrap` text.
+ */
+export function splitCommentImages(text) {
+    const segments = [];
+    if (!text)
+        return segments;
+    let cursor = 0;
+    COMMENT_IMAGE_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = COMMENT_IMAGE_PATTERN.exec(text)) !== null) {
+        let before = text.slice(cursor, match.index);
+        if (before.endsWith("\n"))
+            before = before.slice(0, -1);
+        if (before)
+            segments.push({ type: "text", value: before });
+        const imageId = (match[2] ?? "").toLowerCase();
+        segments.push({
+            type: "image",
+            alt: match[1] || DEFAULT_COMMENT_IMAGE_ALT,
+            src: buildCommentImageUrl(imageId),
+            imageId,
+        });
+        cursor = match.index + match[0].length;
+        if (text[cursor] === "\n")
+            cursor += 1;
+    }
+    if (cursor < text.length) {
+        segments.push({ type: "text", value: text.slice(cursor) });
+    }
+    return segments;
+}
+export function commentHasImages(text) {
+    if (!text)
+        return false;
+    COMMENT_IMAGE_PATTERN.lastIndex = 0;
+    return COMMENT_IMAGE_PATTERN.test(text);
+}
+/** Replaces image tokens with their alt text, for one-line previews and notifications. */
+export function stripCommentImages(text) {
+    if (!text)
+        return "";
+    return splitCommentImages(text)
+        .map((segment) => segment.type === "image" ? `[${segment.alt}]` : segment.value)
+        .join(" ")
+        .replace(/[ \t]+/g, " ")
+        .trim();
+}
+/**
+ * Inserts `insert` at the selection of a textarea value on its own line,
+ * returning the new value and the caret position after the insertion.
+ */
+export function insertCommentImageMarkdown(value, selectionStart, selectionEnd, insert) {
+    const start = Math.max(0, Math.min(selectionStart, value.length));
+    const end = Math.max(start, Math.min(selectionEnd, value.length));
+    const before = value.slice(0, start);
+    const after = value.slice(end);
+    const leading = before.length === 0 || before.endsWith("\n") ? "" : "\n";
+    const trailing = after.length === 0 || after.startsWith("\n") ? "" : "\n";
+    const block = `${leading}${insert}${trailing}`;
+    const nextValue = `${before}${block}${after}`;
+    const cursor = before.length + block.length;
+    return { value: nextValue, cursor };
+}
+export { getImageFilesFromDataTransfer } from "../utils/dataTransferImages";
+export async function uploadCommentImage(file, scope, scopeId, scopeLanguage) {
+    if (file.size > COMMENT_IMAGE_MAX_BYTES) {
+        throw new Error(`Image is too large. Maximum allowed size is ${COMMENT_IMAGE_MAX_BYTES / (1024 * 1024)} MB.`);
+    }
+    if (!scopeId) {
+        throw new Error("Images can only be added to a comment on an open item.");
+    }
+    const params = new URLSearchParams({ scope, scopeId });
+    if (scopeLanguage)
+        params.set("scopeLanguage", scopeLanguage);
+    const formData = new FormData();
+    formData.append("file", file, file.name);
+    const response = await fetch(`/parhelia/comments/uploadImage?${params.toString()}`, { method: "POST", credentials: "include", body: formData });
+    const body = await response.text();
+    let raw = {};
+    if (body) {
+        try {
+            raw = JSON.parse(body);
+        }
+        catch {
+            raw = { summary: body };
+        }
+    }
+    if (!response.ok) {
+        const summary = (typeof raw.summary === "string" && raw.summary) ||
+            (typeof raw.Summary === "string" && raw.Summary) ||
+            response.statusText ||
+            "Image upload failed";
+        throw new Error(summary);
+    }
+    const imageId = String(raw.imageId ?? raw.ImageId ?? "");
+    if (!imageId)
+        throw new Error("Image upload returned no image id");
+    return {
+        imageId,
+        url: String(raw.url ?? raw.Url ?? buildCommentImageUrl(imageId)),
+        contentType: (raw.contentType ?? raw.ContentType),
+        fileSize: (raw.fileSize ?? raw.FileSize),
+    };
+}
+//# sourceMappingURL=commentImages.js.map

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

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

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

@@ -0,0 +1,114 @@
+import type { FieldDescriptor } from "../pageModel";
+/**
+ * Comment target picking ("Add a comment" in the toolbar): like a design
+ * tool's comment mode, the pointer becomes a picker and the user chooses what
+ * the comment is about — a component or field on the canvas, or a field in a
+ * form — before the composer opens. The mode is editor-wide, so it lives in a
+ * tiny store the toolbar button and the surfaces (canvas overlay, forms) share.
+ */
+export type CommentTarget = {
+    kind: "field";
+    field: FieldDescriptor;
+    label?: string;
+} | {
+    kind: "component";
+    itemId: string;
+    label?: string;
+};
+/**
+ * Put this attribute on controls that start or stop picking themselves: a
+ * click inside them is neither a pick nor the "click elsewhere" that cancels.
+ */
+export declare const COMMENT_PICKER_IGNORE_ATTRIBUTE = "data-comment-picker-ignore";
+export declare function startCommentTargetPicking(): void;
+export declare function stopCommentTargetPicking(): void;
+export declare function isCommentTargetPicking(): boolean;
+type AddCommentContext = {
+    addComment: () => void;
+    selectedRange?: {
+        text?: string;
+        startOffset?: number;
+        endOffset?: number;
+    };
+    comments?: {
+        isNew?: boolean;
+    }[];
+    showComments?: boolean;
+    setShowComments?: (show: boolean) => void;
+};
+/**
+ * "Add a comment" without a target: asks what the comment is about by
+ * starting the picker (or leaves it when it is already on). Two cases already
+ * say what they are about and open the composer directly: a text selection
+ * (the comment is on that range) and an unsaved draft (it gets focused).
+ */
+export declare function beginAddComment(editContext: AddCommentContext | undefined): void;
+export declare function useCommentTargetPicking(): boolean;
+type CanvasPickInteraction = {
+    kind: string;
+    key?: string;
+    fieldId?: string;
+    componentId?: string;
+    item?: {
+        id: string;
+        language?: string;
+        version?: number;
+    };
+};
+type CanvasPickContext = {
+    addComment: (options?: {
+        field?: FieldDescriptor;
+        itemId?: string;
+    }) => void;
+};
+/**
+ * The canvas half of picking, driven by the host bridge's own events so the
+ * page stays interactive (text can be selected): a click picks the field or
+ * component under the pointer, Escape or a right-click leaves the mode.
+ * Returns true when the interaction belonged to the picker and must not
+ * reach the editor's normal handling (select, inline edit, context menu).
+ */
+export declare function handleCanvasPickInteraction(interaction: CanvasPickInteraction, editContext: CanvasPickContext | undefined, page: {
+    language: string;
+    version: number;
+} | undefined): boolean;
+/**
+ * A text selection made while picking: once the pointer is released, the
+ * selected passage is what the comment is about. Returns true when it was.
+ */
+export declare function isCanvasPickSelection(selection: {
+    collapsed: boolean;
+    text?: string;
+    gestureEnded?: boolean;
+    activeField?: {
+        fieldId: string;
+    };
+}): boolean;
+type SelectionIdentity = {
+    collapsed: boolean;
+    startOffset?: number;
+    endOffset?: number;
+    activeField?: {
+        elementKey?: string;
+        fieldId: string;
+    };
+};
+/** Call when a selection was taken as the comment target. */
+export declare function markPickedSelection(selection: SelectionIdentity): void;
+/** Call for every selection change: any other selection ends the hold. */
+export declare function releasePickedSelection(selection: SelectionIdentity): void;
+/**
+ * Whether the text formatting menu should stay away: while picking (a text
+ * selection there chooses what to comment on) and while the passage picked
+ * that way is still the selection.
+ */
+export declare function useFormattingMenuSuppressed(selection: SelectionIdentity | undefined): boolean;
+/** The picker cursor: a comment bubble with a plus, hot spot at its tail. */
+export declare const COMMENT_PICKER_CURSOR: string;
+export type PickableRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export {};

package/dist/editor/reviews/commentTargetPicker.js

@@ -0,0 +1,153 @@
+import { useSyncExternalStore } from "react";
+/**
+ * Put this attribute on controls that start or stop picking themselves: a
+ * click inside them is neither a pick nor the "click elsewhere" that cancels.
+ */
+export const COMMENT_PICKER_IGNORE_ATTRIBUTE = "data-comment-picker-ignore";
+let picking = false;
+const listeners = new Set();
+function setPicking(next) {
+    if (picking === next)
+        return;
+    picking = next;
+    listeners.forEach((listener) => listener());
+}
+export function startCommentTargetPicking() {
+    setPicking(true);
+}
+export function stopCommentTargetPicking() {
+    setPicking(false);
+}
+export function isCommentTargetPicking() {
+    return picking;
+}
+function subscribe(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/**
+ * "Add a comment" without a target: asks what the comment is about by
+ * starting the picker (or leaves it when it is already on). Two cases already
+ * say what they are about and open the composer directly: a text selection
+ * (the comment is on that range) and an unsaved draft (it gets focused).
+ */
+export function beginAddComment(editContext) {
+    if (!editContext)
+        return;
+    if (picking) {
+        stopCommentTargetPicking();
+        return;
+    }
+    const range = editContext.selectedRange;
+    const hasTextSelection = !!range?.text?.trim() && range.startOffset !== range.endOffset;
+    const hasDraft = !!editContext.comments?.some((comment) => comment.isNew);
+    if (hasTextSelection || hasDraft) {
+        editContext.addComment();
+        return;
+    }
+    // The picker belongs to the comments surface: its toolbar button (pressed
+    // state, Escape, form fields) and the margin the composer opens in.
+    if (editContext.showComments === false)
+        editContext.setShowComments?.(true);
+    startCommentTargetPicking();
+}
+export function useCommentTargetPicking() {
+    return useSyncExternalStore(subscribe, isCommentTargetPicking, isCommentTargetPicking);
+}
+/**
+ * The canvas half of picking, driven by the host bridge's own events so the
+ * page stays interactive (text can be selected): a click picks the field or
+ * component under the pointer, Escape or a right-click leaves the mode.
+ * Returns true when the interaction belonged to the picker and must not
+ * reach the editor's normal handling (select, inline edit, context menu).
+ */
+export function handleCanvasPickInteraction(interaction, editContext, page) {
+    if (!picking)
+        return false;
+    if (interaction.kind === "contextMenu") {
+        stopCommentTargetPicking();
+        return true;
+    }
+    if (interaction.kind === "keydown") {
+        if (interaction.key !== "Escape")
+            return false;
+        stopCommentTargetPicking();
+        return true;
+    }
+    if (interaction.kind !== "click" && interaction.kind !== "doubleClick") {
+        return false; // hover keeps flowing: it drives the outline
+    }
+    stopCommentTargetPicking();
+    if (interaction.fieldId && interaction.item?.id) {
+        editContext?.addComment({
+            field: {
+                fieldId: interaction.fieldId,
+                item: {
+                    id: interaction.item.id,
+                    language: interaction.item.language ?? page?.language ?? "",
+                    version: interaction.item.version ?? page?.version ?? 0,
+                },
+            },
+        });
+    }
+    else if (interaction.componentId) {
+        editContext?.addComment({ itemId: interaction.componentId });
+    }
+    return true;
+}
+/**
+ * A text selection made while picking: once the pointer is released, the
+ * selected passage is what the comment is about. Returns true when it was.
+ */
+export function isCanvasPickSelection(selection) {
+    return (picking &&
+        selection.gestureEnded === true &&
+        !selection.collapsed &&
+        !!selection.text?.trim() &&
+        !!selection.activeField?.fieldId);
+}
+function getSelectionKey(selection) {
+    if (!selection || selection.collapsed || !selection.activeField)
+        return "";
+    const field = selection.activeField;
+    return `${field.elementKey ?? field.fieldId}:${selection.startOffset}:${selection.endOffset}`;
+}
+// The passage that was just picked by selecting it. It stays selected while
+// its composer is open, and the formatting menu must not pop up over it as
+// if the user had selected text to format.
+let pickedSelectionKey = "";
+/** Call when a selection was taken as the comment target. */
+export function markPickedSelection(selection) {
+    const next = getSelectionKey(selection);
+    if (next === pickedSelectionKey)
+        return;
+    pickedSelectionKey = next;
+    listeners.forEach((listener) => listener());
+}
+/** Call for every selection change: any other selection ends the hold. */
+export function releasePickedSelection(selection) {
+    if (!pickedSelectionKey ||
+        getSelectionKey(selection) === pickedSelectionKey) {
+        return;
+    }
+    pickedSelectionKey = "";
+    listeners.forEach((listener) => listener());
+}
+/**
+ * Whether the text formatting menu should stay away: while picking (a text
+ * selection there chooses what to comment on) and while the passage picked
+ * that way is still the selection.
+ */
+export function useFormattingMenuSuppressed(selection) {
+    const held = useSyncExternalStore(subscribe, () => pickedSelectionKey, () => pickedSelectionKey);
+    const isPicking = useCommentTargetPicking();
+    return isPicking || (!!held && getSelectionKey(selection) === held);
+}
+/** The picker cursor: a comment bubble with a plus, hot spot at its tail. */
+export const COMMENT_PICKER_CURSOR = `url("data:image/svg+xml;utf8,${encodeURIComponent('<svg xmlns="http://www.w3.org/2000/svg" width="28" height="28" viewBox="0 0 28 28">' +
+    '<path d="M4 25 L6.2 18.6 A10.5 10.5 0 1 1 10.4 22.4 Z" fill="#7c3aed" stroke="white" stroke-width="1.5" stroke-linejoin="round"/>' +
+    '<path d="M15 9.5v9M10.5 14h9" stroke="white" stroke-width="1.8" stroke-linecap="round"/>' +
+    "</svg>")}") 4 25, crosshair`;
+//# sourceMappingURL=commentTargetPicker.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * 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 declare function formatFeedbackBalloonDate(date: Date, now?: Date, options?: {
+    timeZone?: string;
+}): string;

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 {};