@parhelia/core 0.3.12831 → 0.3.12833

package/dist/editor/agent-changes/agentChangeTargets.d.ts

@@ -0,0 +1,58 @@
+import type { SerializablePageStructure } from "../bridge/protocol";
+import type { FieldDescriptor, ItemDescriptor } from "../pageModel";
+import type { EditFieldOperation, EditOperation } from "../../types";
+import { type ComponentDiffTarget, type DiffTarget } from "../version-diff/versionDiffTargets";
+/**
+ * The agent whose edit operations are currently highlighted across the page
+ * iframe, the minimap and the edit form. Owned by the terminal's "Changes"
+ * tray checkbox; `null` when highlighting is off.
+ */
+export type AgentChangeHighlighting = {
+    agentId: string;
+    operations: EditOperation[];
+};
+export type AgentFieldChange = {
+    itemId: string;
+    language?: string;
+    /** Undefined or 0 means "any version" (the op did not pin one). */
+    version?: number;
+    fieldId: string;
+    fieldName?: string;
+    /**
+     * The value before the agent's FIRST edit of this field, so repeated edits
+     * diff cumulatively. Undefined when no op captured an old value.
+     */
+    baselineValue?: string;
+    /** The value written by the agent's LAST edit of this field. */
+    latestValue?: string;
+    operations: EditFieldOperation[];
+};
+export type AgentChangeTargetsResult = {
+    fieldTargets: DiffTarget[];
+    componentTargets: ComponentDiffTarget[];
+};
+/**
+ * Collapses the agent's edit-field operations into one entry per field.
+ * Undone operations are ignored; a field whose every edit was undone drops out.
+ */
+export declare function collectAgentFieldChanges(operations: EditOperation[]): AgentFieldChange[];
+export declare function agentFieldChangeMatches(change: AgentFieldChange, descriptor: FieldDescriptor): boolean;
+export declare function findAgentFieldChange(highlighting: AgentChangeHighlighting | null | undefined, descriptor: FieldDescriptor | undefined): AgentFieldChange | undefined;
+/**
+ * Components the agent added, duplicated, moved or linked. Removed components
+ * are no longer on the page and cannot be marked in the iframe.
+ */
+export declare function collectAgentComponentChanges(operations: EditOperation[]): ComponentDiffTarget[];
+/**
+ * Turns the agent's operations into the same target shapes the version-diff
+ * overlay renders: added-text ranges per rendered field (diffing the value
+ * before the agent's first edit against the text now on the page) plus one
+ * component box per component the agent introduced. Fields without a
+ * captured baseline, or whose change is deletion-only, get the whole-field
+ * marker.
+ */
+export declare function resolveAgentChangeTargets({ operations, bridgeStructure, pageItem, }: {
+    operations: EditOperation[];
+    bridgeStructure?: SerializablePageStructure;
+    pageItem: ItemDescriptor;
+}): AgentChangeTargetsResult;

package/dist/editor/agent-changes/agentChangeTargets.js

@@ -0,0 +1,180 @@
+import { collectRenderedFieldsFromBridge, computeWordDiffRanges, normalizeId, stripHtml, } from "../version-diff/versionDiffTargets";
+function asString(value) {
+    if (value == null)
+        return undefined;
+    return typeof value === "string" ? value : String(value);
+}
+function sortChronologically(operations) {
+    return [...operations].sort((a, b) => {
+        const left = new Date(a.date).getTime() || 0;
+        const right = new Date(b.date).getTime() || 0;
+        return left - right;
+    });
+}
+function fieldChangeKey(itemId, language, fieldId) {
+    return `${normalizeId(itemId)}|${(language || "").toLowerCase()}|${normalizeId(fieldId)}`;
+}
+/**
+ * Collapses the agent's edit-field operations into one entry per field.
+ * Undone operations are ignored; a field whose every edit was undone drops out.
+ */
+export function collectAgentFieldChanges(operations) {
+    const changes = new Map();
+    for (const op of sortChronologically(operations)) {
+        if (op.type !== "edit-field" || op.undone)
+            continue;
+        const edit = op;
+        const itemId = edit.itemId || edit.mainItem?.id;
+        if (!itemId || !edit.fieldId)
+            continue;
+        const language = edit.mainItem?.language;
+        const isMainItem = !!edit.mainItem?.id &&
+            normalizeId(edit.mainItem.id) === normalizeId(itemId);
+        const version = isMainItem ? edit.mainItem?.version : undefined;
+        const key = fieldChangeKey(itemId, language, edit.fieldId);
+        const existing = changes.get(key);
+        if (existing) {
+            existing.latestValue = asString(edit.value) ?? existing.latestValue;
+            existing.fieldName = existing.fieldName || edit.fieldName;
+            existing.operations.push(edit);
+            continue;
+        }
+        changes.set(key, {
+            itemId,
+            language,
+            version,
+            fieldId: edit.fieldId,
+            fieldName: edit.fieldName,
+            baselineValue: asString(edit.oldValue),
+            latestValue: asString(edit.value),
+            operations: [edit],
+        });
+    }
+    return Array.from(changes.values());
+}
+export function agentFieldChangeMatches(change, descriptor) {
+    if (normalizeId(change.fieldId) !== normalizeId(descriptor.fieldId))
+        return false;
+    if (normalizeId(change.itemId) !== normalizeId(descriptor.item.id))
+        return false;
+    if (change.language &&
+        descriptor.item.language &&
+        change.language.toLowerCase() !== descriptor.item.language.toLowerCase()) {
+        return false;
+    }
+    if (change.version &&
+        descriptor.item.version &&
+        change.version !== descriptor.item.version) {
+        return false;
+    }
+    return true;
+}
+export function findAgentFieldChange(highlighting, descriptor) {
+    if (!highlighting || !descriptor?.item?.id)
+        return undefined;
+    return collectAgentFieldChanges(highlighting.operations).find((change) => agentFieldChangeMatches(change, descriptor));
+}
+/**
+ * Components the agent added, duplicated, moved or linked. Removed components
+ * are no longer on the page and cannot be marked in the iframe.
+ */
+export function collectAgentComponentChanges(operations) {
+    const targets = new Map();
+    const add = (id, dataItemId) => {
+        const key = normalizeId(id || dataItemId);
+        if (!key || targets.has(key))
+            return;
+        targets.set(key, {
+            id: id || dataItemId,
+            visualId: id || dataItemId,
+            kind: "added",
+            dataItemId,
+        });
+    };
+    for (const op of operations) {
+        if (op.undone)
+            continue;
+        switch (op.type) {
+            case "add-component":
+                add(op.componentId);
+                break;
+            case "duplicate-components":
+                op.componentIds?.forEach((id) => add(id));
+                break;
+            case "paste-components":
+                op.componentIds?.forEach((id) => add(id));
+                break;
+            case "convert-component":
+                op.createdItemIds?.forEach((id) => add(id));
+                break;
+            case "move-component":
+                op.componentIds?.forEach((id) => add(id));
+                break;
+            case "link-component": {
+                const linked = op.linkedComponentItem;
+                add(undefined, linked?.id);
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    return Array.from(targets.values());
+}
+/**
+ * Turns the agent's operations into the same target shapes the version-diff
+ * overlay renders: added-text ranges per rendered field (diffing the value
+ * before the agent's first edit against the text now on the page) plus one
+ * component box per component the agent introduced. Fields without a
+ * captured baseline, or whose change is deletion-only, get the whole-field
+ * marker.
+ */
+export function resolveAgentChangeTargets({ operations, bridgeStructure, pageItem, }) {
+    const fieldChanges = collectAgentFieldChanges(operations);
+    const componentTargets = collectAgentComponentChanges(operations);
+    if (!bridgeStructure || fieldChanges.length === 0) {
+        return { fieldTargets: [], componentTargets };
+    }
+    const renderedFields = collectRenderedFieldsFromBridge(bridgeStructure, pageItem);
+    const fieldTargets = renderedFields.flatMap((renderedField) => {
+        const change = fieldChanges.find((candidate) => agentFieldChangeMatches(candidate, renderedField.descriptor));
+        if (!change)
+            return [];
+        // The bridge structure's textContent is a load-time summary that does not
+        // follow field patches, so it can be empty or stale right after the agent
+        // wrote the field. The agent's last written value is what the host now
+        // renders (the bridge measures ranges against the live DOM text), so
+        // prefer it and fall back to the bridge text only when no value is known.
+        const currentText = change.latestValue !== undefined
+            ? stripHtml(change.latestValue)
+            : renderedField.currentText;
+        if (change.baselineValue === undefined) {
+            return [
+                {
+                    ...renderedField,
+                    currentText,
+                    baselineText: "",
+                    ranges: [],
+                    rangeKind: "added",
+                    hasDeletionOnlyChange: true,
+                },
+            ];
+        }
+        const baselineText = stripHtml(change.baselineValue);
+        if (baselineText === currentText)
+            return [];
+        const ranges = computeWordDiffRanges(baselineText, currentText).added;
+        return [
+            {
+                ...renderedField,
+                currentText,
+                baselineText,
+                ranges,
+                rangeKind: "added",
+                hasDeletionOnlyChange: ranges.length === 0,
+            },
+        ];
+    });
+    return { fieldTargets, componentTargets };
+}
+//# sourceMappingURL=agentChangeTargets.js.map

package/dist/editor/agent-changes/agentChangeTargets.js.map

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

package/dist/editor/agent-changes/agentChangeTextHighlight.d.ts

@@ -0,0 +1,101 @@
+import { type RefObject } from "react";
+import type { FieldDescriptor } from "../pageModel";
+import { type DiffRange } from "../version-diff/versionDiffTargets";
+import { type AgentFieldChange } from "./agentChangeTargets";
+/**
+ * Form-side twin of the canvas agent-change highlight: instead of tinting the
+ * field row, the text the agent added is marked inside the editor itself,
+ * the same way the page overlay marks the added words. A change whose baseline
+ * is unknown, or that only removed text, has nothing to mark and gets a dashed
+ * whole-field outline instead (again mirroring the canvas).
+ */
+export type AgentTextHighlight = {
+    /** [start, end) offsets into the editor's current plain text. */
+    ranges: DiffRange[];
+    /** True when there is no added text to mark (baseline unknown / deletion-only). */
+    wholeField: boolean;
+};
+/** Tailwind classes shared by every added-text mark in the form. */
+export declare const agentAddedTextClass = "bg-feedback-green/35 rounded-sm";
+/** Dashed outline for a changed field that has no added text to mark. */
+export declare const agentWholeFieldClass = "outline outline-1 outline-dashed outline-feedback-green outline-offset-0";
+/**
+ * The agent change for `descriptor` while the terminal's "Highlight changes"
+ * checkbox is on for the agent that made it; undefined otherwise.
+ */
+export declare function useAgentFieldChange(descriptor: FieldDescriptor | undefined): AgentFieldChange | undefined;
+/**
+ * Diffs the editor's live text against the text before the agent's first
+ * edit. Diffing the live text (not the agent's written value) keeps the marks
+ * in step while the user keeps typing, and clears them once the text is back
+ * to the baseline.
+ */
+export declare function computeAgentTextHighlight(change: AgentFieldChange | undefined, currentText: string, baselineFormat?: "plain" | "html"): AgentTextHighlight | null;
+export declare function computeTextHighlight(baselineText: string, currentText: string): AgentTextHighlight | null;
+type TextSegment = {
+    text: string;
+    added: boolean;
+};
+/** Splits `text` into unchanged / added runs following `ranges` (sorted, disjoint). */
+export declare function splitTextByRanges(text: string, ranges: DiffRange[]): TextSegment[];
+/** One kind of mark painted by {@link TextMarkBackdrop}. */
+export type TextMarkLayer = {
+    /** [start, end) offsets into the text; may overlap other layers' ranges. */
+    ranges: readonly {
+        start: number;
+        end: number;
+    }[];
+    className: string;
+    /** `data-testid` of every mark span of this layer. */
+    markTestId?: string;
+    /** Boolean data attribute (`data-misspelled`) set on every mark span of this layer. */
+    dataAttribute?: string;
+};
+export type TextMarkSegment = {
+    text: string;
+    start: number;
+    end: number;
+    /** Indexes into the layers array of every layer covering this segment. */
+    layers: number[];
+};
+/**
+ * Splits `text` at every layer boundary so each segment carries the set of
+ * layers covering it. Overlapping layers are supported (a word can be both
+ * agent-added and misspelled).
+ */
+export declare function splitTextByLayers(text: string, layers: readonly TextMarkLayer[]): TextMarkSegment[];
+/**
+ * Mark layer for `<input>` / `<textarea>` editors, whose values are not DOM
+ * text and cannot be marked directly. It sits behind the (then transparent)
+ * control, mirrors its text metrics, and paints the runs of every layer;
+ * scrolling and the textarea's scrollbar width are kept in sync so the marks
+ * stay under the glyphs they belong to.
+ *
+ * `className` must repeat the control's padding and font classes.
+ */
+export declare function TextMarkBackdrop({ text, layers, wholeField, inputRef, mirrorRef: externalMirrorRef, className, multiline, testId, }: {
+    text: string;
+    layers: readonly TextMarkLayer[];
+    /** Dashed whole-field outline (agent change without added text). */
+    wholeField?: boolean;
+    inputRef: RefObject<HTMLInputElement | HTMLTextAreaElement | null>;
+    /** Receives the mirror element, for hit testing marks under a pointer. */
+    mirrorRef?: RefObject<HTMLDivElement | null>;
+    className?: string;
+    multiline?: boolean;
+    testId?: string;
+}): import("react").JSX.Element;
+/**
+ * Agent-change mark layer over {@link TextMarkBackdrop}: the added runs in
+ * green plus, via `extraLayers`, any further marks the field shows (spelling).
+ */
+export declare function AgentChangeTextBackdrop({ text, highlight, extraLayers, inputRef, mirrorRef, className, multiline, }: {
+    text: string;
+    highlight: AgentTextHighlight;
+    extraLayers?: readonly TextMarkLayer[];
+    inputRef: RefObject<HTMLInputElement | HTMLTextAreaElement | null>;
+    mirrorRef?: RefObject<HTMLDivElement | null>;
+    className?: string;
+    multiline?: boolean;
+}): import("react").JSX.Element;
+export {};

package/dist/editor/agent-changes/agentChangeTextHighlight.js

@@ -0,0 +1,167 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useRef } from "react";
+import { cn } from "../../lib/utils";
+import { useEditContext } from "../client/editContext";
+import { computeWordDiffRanges, stripHtml, } from "../version-diff/versionDiffTargets";
+import { agentFieldChangeMatches, collectAgentFieldChanges, } from "./agentChangeTargets";
+/** Tailwind classes shared by every added-text mark in the form. */
+export const agentAddedTextClass = "bg-feedback-green/35 rounded-sm";
+/** Dashed outline for a changed field that has no added text to mark. */
+export const agentWholeFieldClass = "outline outline-1 outline-dashed outline-feedback-green outline-offset-0";
+/**
+ * The agent change for `descriptor` while the terminal's "Highlight changes"
+ * checkbox is on for the agent that made it; undefined otherwise.
+ */
+export function useAgentFieldChange(descriptor) {
+    const operations = useEditContext()?.agentChangeHighlighting?.operations;
+    return useMemo(() => {
+        if (!operations || !descriptor?.item?.id)
+            return undefined;
+        return collectAgentFieldChanges(operations).find((change) => agentFieldChangeMatches(change, descriptor));
+    }, [operations, descriptor]);
+}
+/**
+ * Diffs the editor's live text against the text before the agent's first
+ * edit. Diffing the live text (not the agent's written value) keeps the marks
+ * in step while the user keeps typing, and clears them once the text is back
+ * to the baseline.
+ */
+export function computeAgentTextHighlight(change, currentText, baselineFormat = "plain") {
+    if (!change)
+        return null;
+    if (change.baselineValue === undefined) {
+        return { ranges: [], wholeField: true };
+    }
+    const baselineText = baselineFormat === "html"
+        ? stripHtml(change.baselineValue)
+        : change.baselineValue;
+    return computeTextHighlight(baselineText, currentText);
+}
+export function computeTextHighlight(baselineText, currentText) {
+    if (baselineText === currentText)
+        return null;
+    const ranges = computeWordDiffRanges(baselineText, currentText).added;
+    return { ranges, wholeField: ranges.length === 0 };
+}
+/** Splits `text` into unchanged / added runs following `ranges` (sorted, disjoint). */
+export function splitTextByRanges(text, ranges) {
+    const segments = [];
+    let position = 0;
+    for (const range of [...ranges].sort((a, b) => a.start - b.start)) {
+        const start = Math.max(position, Math.min(range.start, text.length));
+        const end = Math.max(start, Math.min(range.end, text.length));
+        if (start > position) {
+            segments.push({ text: text.slice(position, start), added: false });
+        }
+        if (end > start) {
+            segments.push({ text: text.slice(start, end), added: true });
+        }
+        position = end;
+    }
+    if (position < text.length) {
+        segments.push({ text: text.slice(position), added: false });
+    }
+    return segments;
+}
+/**
+ * Splits `text` at every layer boundary so each segment carries the set of
+ * layers covering it. Overlapping layers are supported (a word can be both
+ * agent-added and misspelled).
+ */
+export function splitTextByLayers(text, layers) {
+    const boundaries = new Set([0, text.length]);
+    layers.forEach((layer) => layer.ranges.forEach((range) => {
+        boundaries.add(Math.max(0, Math.min(range.start, text.length)));
+        boundaries.add(Math.max(0, Math.min(range.end, text.length)));
+    }));
+    const points = Array.from(boundaries).sort((a, b) => a - b);
+    const segments = [];
+    let previous;
+    for (const end of points) {
+        const start = previous;
+        previous = end;
+        if (start === undefined || end <= start)
+            continue;
+        const covering = [];
+        layers.forEach((layer, layerIndex) => {
+            if (layer.ranges.some((range) => range.start <= start && end <= range.end)) {
+                covering.push(layerIndex);
+            }
+        });
+        segments.push({ text: text.slice(start, end), start, end, layers: covering });
+    }
+    return segments;
+}
+/**
+ * Mark layer for `<input>` / `<textarea>` editors, whose values are not DOM
+ * text and cannot be marked directly. It sits behind the (then transparent)
+ * control, mirrors its text metrics, and paints the runs of every layer;
+ * scrolling and the textarea's scrollbar width are kept in sync so the marks
+ * stay under the glyphs they belong to.
+ *
+ * `className` must repeat the control's padding and font classes.
+ */
+export function TextMarkBackdrop({ text, layers, wholeField = false, inputRef, mirrorRef: externalMirrorRef, className, multiline = false, testId = "text-mark-backdrop", }) {
+    const ownMirrorRef = useRef(null);
+    const mirrorRef = externalMirrorRef ?? ownMirrorRef;
+    useEffect(() => {
+        const input = inputRef.current;
+        const mirror = mirrorRef.current;
+        if (!input || !mirror)
+            return;
+        const sync = () => {
+            // A textarea scrollbar narrows its content box; shrink the mirror by the
+            // same amount so both wrap at the same column.
+            const scrollbarWidth = Math.max(0, input.offsetWidth - input.clientWidth - horizontalBorder(input));
+            mirror.style.right = `${scrollbarWidth}px`;
+            mirror.scrollTop = input.scrollTop;
+            mirror.scrollLeft = input.scrollLeft;
+        };
+        sync();
+        input.addEventListener("scroll", sync);
+        const observer = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(sync);
+        observer?.observe(input);
+        return () => {
+            input.removeEventListener("scroll", sync);
+            observer?.disconnect();
+        };
+    }, [inputRef, mirrorRef, text]);
+    const segments = useMemo(() => splitTextByLayers(text, layers), [text, layers]);
+    return (_jsx("div", { ref: mirrorRef, "aria-hidden": true, "data-testid": testId, "data-whole-field": wholeField ? "true" : undefined, className: cn("bg-neutral-grey-5 pointer-events-none absolute inset-0 overflow-hidden rounded-[4px] border border-transparent text-transparent select-none", multiline
+            ? "break-words whitespace-pre-wrap"
+            : "flex items-center whitespace-pre", wholeField && agentWholeFieldClass, className), children: _jsxs("span", { className: cn(!multiline && "min-w-0 shrink-0"), children: [segments.map((segment, index) => {
+                    if (segment.layers.length === 0) {
+                        return _jsx("span", { children: segment.text }, index);
+                    }
+                    const covering = segment.layers
+                        .map((layerIndex) => layers[layerIndex])
+                        .filter((layer) => layer !== undefined);
+                    const attributes = {};
+                    covering.forEach((layer) => {
+                        if (layer.dataAttribute)
+                            attributes[layer.dataAttribute] = "true";
+                    });
+                    return (_jsx("span", { className: cn(...covering.map((layer) => layer.className)), "data-testid": covering.map((layer) => layer.markTestId).filter(Boolean).join(" ") || undefined, "data-start": segment.start, "data-end": segment.end, ...attributes, children: segment.text }, index));
+                }), multiline && text.endsWith("\n") ? "​" : null] }) }));
+}
+/**
+ * Agent-change mark layer over {@link TextMarkBackdrop}: the added runs in
+ * green plus, via `extraLayers`, any further marks the field shows (spelling).
+ */
+export function AgentChangeTextBackdrop({ text, highlight, extraLayers, inputRef, mirrorRef, className, multiline = false, }) {
+    const layers = useMemo(() => [
+        {
+            ranges: highlight.ranges,
+            className: agentAddedTextClass,
+            markTestId: "agent-change-text-mark",
+        },
+        ...(extraLayers ?? []),
+    ], [highlight.ranges, extraLayers]);
+    return (_jsx(TextMarkBackdrop, { text: text, layers: layers, wholeField: highlight.wholeField, inputRef: inputRef, mirrorRef: mirrorRef, className: className, multiline: multiline, testId: "agent-change-text-backdrop" }));
+}
+function horizontalBorder(element) {
+    const style = getComputedStyle(element);
+    return ((parseFloat(style.borderLeftWidth) || 0) +
+        (parseFloat(style.borderRightWidth) || 0));
+}
+//# sourceMappingURL=agentChangeTextHighlight.js.map

package/dist/editor/agent-changes/agentChangeTextHighlight.js.map

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

package/dist/editor/ai/AgentImagePreview.d.ts

@@ -0,0 +1,13 @@
+import { type ReactElement } from "react";
+/** A shared viewer with a caller-supplied thumbnail button. */
+export declare function AgentImagePreview({ src, alt, fileName, contentClassName, overlayClassName, portalContainer, children, }: {
+    src: string;
+    alt: string;
+    fileName?: string;
+    /** Extra classes for the dialog content, e.g. a higher z-index when opened from a popover. */
+    contentClassName?: string;
+    overlayClassName?: string;
+    /** Where the dialog portals to; defaults to the app container. */
+    portalContainer?: HTMLElement | null;
+    children: ReactElement;
+}): import("react").JSX.Element;

package/dist/editor/ai/AgentImagePreview.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef, useState } from "react";
+import { Button } from "../../components/ui/button";
+import { Dialog, DialogContent, DialogTitle, DialogTrigger, } from "../../components/ui/dialog";
+import { cn } from "../../lib/utils";
+/** A shared viewer with a caller-supplied thumbnail button. */
+export function AgentImagePreview({ src, alt, fileName, contentClassName, overlayClassName, portalContainer, children, }) {
+    const [open, setOpen] = useState(false);
+    const [actualSize, setActualSize] = useState(false);
+    const [naturalSize, setNaturalSize] = useState(null);
+    // Whether the image is larger than the viewport it is shown in, so that
+    // "Actual size" would actually reveal more detail. Assumed true until the
+    // image has loaded.
+    const [isOversized, setIsOversized] = useState(true);
+    const viewportRef = useRef(null);
+    const measure = (image) => {
+        const { naturalWidth, naturalHeight } = image;
+        if (!naturalWidth || !naturalHeight)
+            return;
+        setNaturalSize({ width: naturalWidth, height: naturalHeight });
+        const viewport = viewportRef.current;
+        if (!viewport)
+            return;
+        setIsOversized(naturalWidth > viewport.clientWidth ||
+            naturalHeight > viewport.clientHeight);
+    };
+    const canToggle = isOversized;
+    const toggleSize = () => {
+        if (canToggle)
+            setActualSize((value) => !value);
+    };
+    return (_jsxs(Dialog, { open: open, onOpenChange: (value) => {
+            setOpen(value);
+            setActualSize(false);
+            setNaturalSize(null);
+            setIsOversized(true);
+        }, children: [_jsx(DialogTrigger, { asChild: true, children: children }), _jsxs(DialogContent, { style: { width: "90vw", height: "85vh" }, className: contentClassName, overlayClassName: overlayClassName, portalContainer: portalContainer, children: [_jsxs("div", { className: "border-border-default flex shrink-0 flex-wrap items-center gap-3 border-b p-4 pr-14", children: [_jsxs("div", { className: "flex min-w-0 flex-1 items-baseline gap-2", children: [_jsx(DialogTitle, { className: "min-w-0 truncate text-base", children: fileName || alt || "Image" }), naturalSize && (_jsxs("span", { className: "text-neutral-grey-50 shrink-0 text-xs", children: [naturalSize.width, "\u00D7", naturalSize.height] }))] }), _jsx(Button, { type: "button", variant: "outline", size: "sm", "aria-pressed": actualSize, disabled: !canToggle, onClick: toggleSize, children: actualSize ? "Fit to window" : "Actual size" }), _jsx(Button, { variant: "outline", size: "sm", asChild: true, children: _jsx("a", { href: src, download: fileName || "image", children: "Download" }) })] }), _jsx("div", { ref: viewportRef, className: cn("bg-neutral-grey-5 min-h-0 flex-1 overflow-auto p-4", !actualSize && "flex items-center justify-center"), children: _jsx("img", { src: src, alt: alt, onLoad: (event) => measure(event.currentTarget), onClick: toggleSize, className: cn(actualSize
+                                ? "block max-w-none cursor-zoom-out"
+                                : "max-h-full max-w-full object-contain", !actualSize && canToggle && "cursor-zoom-in") }) })] })] }));
+}
+//# sourceMappingURL=AgentImagePreview.js.map

package/dist/editor/ai/AgentImagePreview.js.map

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

package/dist/editor/ai/activityRowNavigation.d.ts

@@ -0,0 +1,28 @@
+import type { EditOperation } from "../../types";
+import type { FieldDescriptor, ItemDescriptor, Page } from "../pageModel";
+export type ActivityRowNavigation = 
+/** The change is rendered on the open page: scroll to it, stay put. */
+{
+    kind: "scroll";
+    componentId: string;
+    field?: FieldDescriptor;
+}
+/** Not on this page (or no page open): open the item in the editor. */
+ | {
+    kind: "load";
+};
+/**
+ * What a click on a "Changes" row should do. Leaving the page to load an item
+ * the user is already looking at loses their place, so a change that maps to a
+ * component on the open page scrolls to it — to the edited field where the
+ * geometry is known, with the component as the fallback target.
+ *
+ * Rows are grouped by main item, so an edit to a component's embedded item is
+ * filed under the page. The row item alone would therefore resolve to the page
+ * root (a scroll to the top, which looks like nothing happened) — the real
+ * component comes from the operations themselves.
+ */
+export declare function resolveActivityRowNavigation(summary: {
+    item?: ItemDescriptor;
+    operations?: EditOperation[];
+}, page: Page | undefined): ActivityRowNavigation;