@parhelia/core 0.4.12825 → 0.4.12871

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

@@ -0,0 +1,51 @@
+/**
+ * Word-style balloon layout for the comment margin.
+ *
+ * Every card wants to sit at the top of the text it is anchored to. Cards are
+ * placed top to bottom without overlapping; the selected ("pinned") card stays
+ * at its anchor and pushes its neighbours away in both directions; and the
+ * whole stack is kept inside `[minY, maxY]` (the column below the header and
+ * above the footer, in document coordinates), shifting cards above their
+ * anchor when the page end is near.
+ *
+ * Precedence: bounds > pinned card at its anchor > other cards at their
+ * anchors > no overlap. When the cards cannot fit at all the layout reports
+ * `overflow` and the caller switches to a scrolling presentation.
+ */
+export type BalloonInput = {
+    id: string;
+    /** Document-space y of the anchored text; items must be sorted by it. */
+    anchorY: number;
+    /** Measured card height; 0 while unknown. */
+    height: number;
+};
+export type BalloonLayoutOptions = {
+    /** Vertical gap between cards. */
+    gap: number;
+    /** Top of the usable column. */
+    minY: number;
+    /** Bottom of the usable column. */
+    maxY: number;
+    /** Card kept at its anchor (the selected thread). */
+    pinnedId?: string | null;
+};
+export type BalloonPosition = {
+    id: string;
+    top: number;
+};
+export type BalloonLayout = {
+    positions: BalloonPosition[];
+    /** The cards do not fit between minY and maxY; positions are clamped. */
+    overflow: boolean;
+};
+export declare function layoutBalloons(items: readonly BalloonInput[], { gap, minY, maxY, pinnedId }: BalloonLayoutOptions): BalloonLayout;
+/** Sort helper: by anchor, then creation time, then id for a stable order. */
+export declare function compareBalloonAnchors(a: {
+    anchorY: number;
+    created: number;
+    id: string;
+}, b: {
+    anchorY: number;
+    created: number;
+    id: string;
+}): number;

package/dist/editor/reviews/balloonLayout.js

@@ -0,0 +1,101 @@
+/**
+ * Word-style balloon layout for the comment margin.
+ *
+ * Every card wants to sit at the top of the text it is anchored to. Cards are
+ * placed top to bottom without overlapping; the selected ("pinned") card stays
+ * at its anchor and pushes its neighbours away in both directions; and the
+ * whole stack is kept inside `[minY, maxY]` (the column below the header and
+ * above the footer, in document coordinates), shifting cards above their
+ * anchor when the page end is near.
+ *
+ * Precedence: bounds > pinned card at its anchor > other cards at their
+ * anchors > no overlap. When the cards cannot fit at all the layout reports
+ * `overflow` and the caller switches to a scrolling presentation.
+ */
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+export function layoutBalloons(items, { gap, minY, maxY, pinnedId }) {
+    const n = items.length;
+    if (n === 0)
+        return { positions: [], overflow: false };
+    const heights = items.map((item) => Math.max(0, item.height));
+    const total = heights.reduce((sum, height) => sum + height, 0) + gap * (n - 1);
+    const available = maxY - minY;
+    const top = new Array(n);
+    if (total > available) {
+        // Nothing can make this fit; report it. A caller that renders anyway
+        // (while a switch to the scrolling presentation is deferred) gets the
+        // plain downward stack: no overlap, the tail simply runs past maxY.
+        for (let i = 0; i < n; i++) {
+            const previousBottom = i === 0 ? -Infinity : top[i - 1] + heights[i - 1] + gap;
+            top[i] = Math.max(minY, items[i].anchorY, previousBottom);
+        }
+        return {
+            overflow: true,
+            positions: items.map((item, index) => ({ id: item.id, top: top[index] })),
+        };
+    }
+    const pinnedIndex = pinnedId
+        ? items.findIndex((item) => item.id === pinnedId)
+        : -1;
+    // Room the cards above index i need at minimum (each height plus a gap).
+    const stackAbove = new Array(n + 1);
+    stackAbove[0] = 0;
+    for (let i = 0; i < n; i++) {
+        stackAbove[i + 1] = stackAbove[i] + heights[i] + gap;
+    }
+    // Room the cards below index i need at minimum.
+    const stackBelow = new Array(n + 1);
+    stackBelow[n] = 0;
+    for (let i = n - 1; i >= 0; i--) {
+        stackBelow[i] = stackBelow[i + 1] + heights[i] + gap;
+    }
+    // Plain downward stacking of cards [from, to): each at its anchor, or below
+    // the card before it.
+    const placeForward = (from, to) => {
+        for (let i = from; i < to; i++) {
+            const previousBottom = i === 0 ? -Infinity : top[i - 1] + heights[i - 1] + gap;
+            top[i] = Math.max(minY, items[i].anchorY, previousBottom);
+        }
+    };
+    if (pinnedIndex < 0) {
+        placeForward(0, n);
+    }
+    else {
+        const p = pinnedIndex;
+        // The pinned card can only sit where the cards above still fit over it
+        // and the cards below still fit under it.
+        const lo = minY + stackAbove[p];
+        const hi = maxY - heights[p] - stackBelow[p + 1];
+        top[p] = clamp(items[p].anchorY, lo, hi);
+        // Cards above the pin lay out exactly as without a pin, so selecting a
+        // card far away moves nothing; only the ones that would run into the
+        // pinned card are pushed up (never above what the cards over them need).
+        placeForward(0, p);
+        for (let i = p - 1; i >= 0; i--) {
+            const ceiling = top[i + 1] - gap - heights[i];
+            if (top[i] > ceiling) {
+                top[i] = Math.max(minY + stackAbove[i], ceiling);
+            }
+        }
+        // Cards below the pin: pushed down.
+        placeForward(p + 1, n);
+    }
+    // Back pass: keep everything above maxY by shifting cards up. The pinned
+    // card never needs to move because `hi` already reserved the room below it.
+    for (let i = n - 1; i >= 0; i--) {
+        const limit = (i === n - 1 ? maxY : top[i + 1] - gap) - heights[i];
+        if (top[i] > limit)
+            top[i] = Math.max(minY, limit);
+    }
+    return {
+        overflow: false,
+        positions: items.map((item, index) => ({ id: item.id, top: top[index] })),
+    };
+}
+/** Sort helper: by anchor, then creation time, then id for a stable order. */
+export function compareBalloonAnchors(a, b) {
+    return a.anchorY - b.anchorY || a.created - b.created || a.id.localeCompare(b.id);
+}
+//# sourceMappingURL=balloonLayout.js.map

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

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

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

@@ -38,8 +38,7 @@ export declare function insertCommentImageMarkdown(value: string, selectionStart
     value: string;
     cursor: number;
 };
-/** Extracts pasted or dropped image files from a DataTransfer, ignoring plain text. */
-export declare function getImageFilesFromDataTransfer(data: DataTransfer | null | undefined): File[];
+export { getImageFilesFromDataTransfer } from "../utils/dataTransferImages";
 export type CommentImageUploadResult = {
     imageId: string;
     url: string;

package/dist/editor/reviews/commentImages.js

@@ -84,43 +84,7 @@ export function insertCommentImageMarkdown(value, selectionStart, selectionEnd,
     const cursor = before.length + block.length;
     return { value: nextValue, cursor };
 }
-function extensionForType(type) {
-    const subtype = type.split("/")[1]?.toLowerCase() ?? "png";
-    return subtype === "jpeg" ? "jpg" : subtype;
-}
-/** Extracts pasted or dropped image files from a DataTransfer, ignoring plain text. */
-export function getImageFilesFromDataTransfer(data) {
-    if (!data)
-        return [];
-    const files = [];
-    const items = data.items;
-    if (items && items.length > 0) {
-        for (let index = 0; index < items.length; index++) {
-            const item = items[index];
-            if (!item || item.kind !== "file" || !item.type.startsWith("image/")) {
-                continue;
-            }
-            const file = item.getAsFile();
-            if (file)
-                files.push(file);
-        }
-    }
-    else if (data.files && data.files.length > 0) {
-        for (let index = 0; index < data.files.length; index++) {
-            const file = data.files[index];
-            if (file && file.type.startsWith("image/"))
-                files.push(file);
-        }
-    }
-    return files.map((file) => {
-        // Clipboard images arrive as a generic "image.png"; give them a distinct name.
-        if (!file.name || /^image\.[a-z]+$/i.test(file.name)) {
-            const stamp = new Date().toISOString().replace(/[:.]/g, "-");
-            return new File([file], `pasted-image-${stamp}.${extensionForType(file.type)}`, { type: file.type });
-        }
-        return file;
-    });
-}
+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.`);

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

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

@@ -1,4 +1,5 @@
 import { useEditContext } from "../client/editContext";
+import { useActiveSessions } from "../client/liveSessionState";
 import { useResolvedUser } from "../services/userResolution";
 const avatarPalette = [
     "bg-highlight-100 text-white",
@@ -55,7 +56,7 @@ export function getFeedbackAvatarClassName(item) {
 }
 export function useFeedbackAuthor(item, resolvedAuthorName) {
     const editContext = useEditContext();
-    const authorSession = editContext?.activeSessions.find((session) => {
+    const authorSession = useActiveSessions().find((session) => {
         const author = item.author?.trim();
         const displayName = item.authorDisplayName?.trim() || resolvedAuthorName;
         return (namesEqual(session.user.name, author) ||

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

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