@parhelia/core 0.3.12831 → 0.3.12833

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/commentAgentAttachments.d.ts

@@ -0,0 +1,5 @@
+import { type AgentMessageAttachment, type AgentMetadata } from "../services/agentService";
+/** Copy authorized comment images into the agent document store, whose images
+ * are included as visual inputs by the backend message builder. Keep successful
+ * uploads in the caller's cache so a failed submission can be retried. */
+export declare function prepareCommentAgentAttachments(agentId: string, comment: AgentMetadata["comment"], profileId: string | undefined, cache: Map<string, AgentMessageAttachment>): Promise<AgentMessageAttachment[]>;

package/dist/editor/reviews/commentAgentAttachments.js

@@ -0,0 +1,51 @@
+import { uploadDocument, } from "../services/agentService";
+import { COMMENT_IMAGE_MAX_BYTES, splitCommentImages } from "./commentImages";
+/** Copy authorized comment images into the agent document store, whose images
+ * are included as visual inputs by the backend message builder. Keep successful
+ * uploads in the caller's cache so a failed submission can be retried. */
+export async function prepareCommentAgentAttachments(agentId, comment, profileId, cache) {
+    const images = new Map();
+    for (const entry of comment?.thread ?? (comment ? [comment] : [])) {
+        for (const segment of splitCommentImages(entry.text || "")) {
+            if (segment.type === "image")
+                images.set(segment.imageId, segment.src);
+        }
+    }
+    const attachments = [];
+    for (const [imageId, src] of images) {
+        const key = `${agentId}:${imageId}`;
+        const cached = cache.get(key);
+        if (cached) {
+            attachments.push(cached);
+            continue;
+        }
+        // Only the recognized local comment-image endpoint is fetched. It enforces
+        // the current user's access to the comment before returning image bytes.
+        const response = await fetch(src, { credentials: "include" });
+        if (!response.ok) {
+            throw new Error("Could not load a comment screenshot. Please try again.");
+        }
+        const blob = await response.blob();
+        const extension = {
+            "image/png": "png",
+            "image/jpeg": "jpg",
+            "image/gif": "gif",
+            "image/webp": "webp",
+        }[blob.type];
+        if (!extension || !blob.size || blob.size > COMMENT_IMAGE_MAX_BYTES) {
+            throw new Error("A comment screenshot is invalid or too large to attach.");
+        }
+        const file = new File([blob], `comment-image-${imageId}.${extension}`, {
+            type: blob.type,
+        });
+        const result = await uploadDocument(agentId, file, profileId);
+        if (!result.success || !result.document) {
+            throw new Error(result.error || "Could not attach a comment screenshot.");
+        }
+        const { extractedText: _extractedText, ...attachment } = result.document;
+        cache.set(key, attachment);
+        attachments.push(attachment);
+    }
+    return attachments;
+}
+//# sourceMappingURL=commentAgentAttachments.js.map

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":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,wBAAwB,GAAG,8BAA8B,CAAC;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAEtD,MAAM,YAAY,GAAG,sDAAsD,CAAC;AAC5E,MAAM,qBAAqB,GAAG,IAAI,MAAM,CACtC,yBAAyB,wBAAwB,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,IAAI,YAAY,MAAM,EAC9G,GAAG,CACJ,CAAC;AAMF,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,OAAO,GAAG,wBAAwB,GAAG,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAe,EACf,GAAG,GAAW,yBAAyB;IAEvC,MAAM,OAAO,GACX,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,yBAAyB,CAAC;IACpE,OAAO,KAAK,OAAO,KAAK,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAE3B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,qBAAqB,CAAC,SAAS,GAAG,CAAC,CAAC;IACpC,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3D,IAAI,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,yBAAyB;YAC1C,GAAG,EAAE,oBAAoB,CAAC,OAAO,CAAC;YAClC,OAAO;SACR,CAAC,CAAC;QAEH,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACvC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI;YAAE,MAAM,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAA+B;IAC9D,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,qBAAqB,CAAC,SAAS,GAAG,CAAC,CAAC;IACpC,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB,CAAC,IAA+B;IAChE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,kBAAkB,CAAC,IAAI,CAAC;SAC5B,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACf,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAC9D;SACA,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAa,EACb,cAAsB,EACtB,YAAoB,EACpB,MAAc;IAEd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,MAAM,KAAK,GAAG,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACtC,CAAC;AAED,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAS5E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAU,EACV,KAAwB,EACxB,OAAuB,EACvB,aAA6B;IAE7B,IAAI,IAAI,CAAC,IAAI,GAAG,uBAAuB,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,+CAA+C,uBAAuB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAC7F,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,IAAI,aAAa;QAAE,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,kCAAkC,MAAM,CAAC,QAAQ,EAAE,EAAE,EACrD,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAC3D,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,GAAG,GAA4B,EAAE,CAAC;IACtC,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,OAAO,GACX,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC;YAChD,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC;YAChD,QAAQ,CAAC,UAAU;YACnB,qBAAqB,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAEnE,OAAO;QACL,OAAO;QACP,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAChE,WAAW,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAuB;QACvE,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAuB;KAC/D,CAAC;AACJ,CAAC"}

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;