@parhelia/core 0.3.12831 → 0.3.12833

package/dist/editor/ai/terminal/useAgentProviderWait.js

@@ -0,0 +1,23 @@
+import { useCallback } from "react";
+/**
+ * Tracks whether the run is waiting on the model provider. The server emits a
+ * Heartbeat delta every few seconds while a provider request has produced no
+ * first chunk; the flag flips on at the first heartbeat and off again on the
+ * next real delta or status change. It never adds anything to the transcript:
+ * the live "Thinking" label reads it to switch its wording, and that is the
+ * whole surface.
+ */
+export function useAgentProviderWait(input) {
+    const { actions } = input;
+    const handleHeartbeatDelta = useCallback((_message) => {
+        actions.patchRunState({ isWaitingForProvider: true });
+    }, [actions]);
+    const clearProviderWait = useCallback(() => {
+        actions.patchRunState({ isWaitingForProvider: false });
+    }, [actions]);
+    return {
+        handleHeartbeatDelta,
+        clearProviderWait,
+    };
+}
+//# sourceMappingURL=useAgentProviderWait.js.map

package/dist/editor/ai/terminal/useAgentProviderWait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentProviderWait.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/useAgentProviderWait.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAMpC;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAuC;IAC1E,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAE1B,MAAM,oBAAoB,GAAG,WAAW,CACtC,CAAC,QAA4B,EAAE,EAAE;QAC/B,OAAO,CAAC,aAAa,CAAC,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE;QACzC,OAAO,CAAC,aAAa,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO;QACL,oBAAoB;QACpB,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/dist/editor/ai/terminal/useAgentReasoningEffortState.d.ts

@@ -0,0 +1,5 @@
+import type { AgentDetails } from "../../services/agentService";
+export declare function useAgentReasoningEffortState(agent: Pick<AgentDetails, "id" | "reasoningEffort"> | undefined): {
+    reasoningEffort: string;
+    setReasoningEffort: import("react").Dispatch<import("react").SetStateAction<string>>;
+};

package/dist/editor/ai/terminal/useAgentReasoningEffortState.js

@@ -0,0 +1,10 @@
+import { useEffect, useState } from "react";
+export function useAgentReasoningEffortState(agent) {
+    const [reasoningEffort, setReasoningEffort] = useState("");
+    useEffect(() => {
+        if (agent?.id)
+            setReasoningEffort(agent.reasoningEffort ?? "");
+    }, [agent?.id, agent?.reasoningEffort]);
+    return { reasoningEffort, setReasoningEffort };
+}
+//# sourceMappingURL=useAgentReasoningEffortState.js.map

package/dist/editor/ai/terminal/useAgentReasoningEffortState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentReasoningEffortState.js","sourceRoot":"","sources":["../../../../src/editor/ai/terminal/useAgentReasoningEffortState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG5C,MAAM,UAAU,4BAA4B,CAC1C,KAA+D;IAE/D,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IACnE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,EAAE,EAAE;YAAE,kBAAkB,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC;IACxC,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC;AACjD,CAAC"}

package/dist/editor/bridge/bridgeKeys.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Component ids cross the bridge in whatever spelling the host used - braces,
+ * dashes, upper or lower case. Compare them through this normalizer.
+ */
+export declare function normalizeBridgeKey(value: string | null | undefined): string;

package/dist/editor/bridge/bridgeKeys.js

@@ -0,0 +1,8 @@
+/**
+ * Component ids cross the bridge in whatever spelling the host used - braces,
+ * dashes, upper or lower case. Compare them through this normalizer.
+ */
+export function normalizeBridgeKey(value) {
+    return (value || "").replace(/[{}-]/g, "").toLowerCase();
+}
+//# sourceMappingURL=bridgeKeys.js.map

package/dist/editor/bridge/bridgeKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridgeKeys.js","sourceRoot":"","sources":["../../../src/editor/bridge/bridgeKeys.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgC;IACjE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAC3D,CAAC"}

package/dist/editor/bridge/linkDownload.d.ts

@@ -0,0 +1,3 @@
+/** File links must bypass the editor's internal-page navigation. */
+export declare function isDownloadHref(href: string, baseUrl: string): boolean;
+export declare function downloadLink(href: string, fileName?: string): Promise<void>;

package/dist/editor/bridge/linkDownload.js

@@ -0,0 +1,52 @@
+/** File links must bypass the editor's internal-page navigation. */
+export function isDownloadHref(href, baseUrl) {
+    if (!href.trim() || href.trimStart().startsWith("#"))
+        return false;
+    try {
+        const url = new URL(href, baseUrl);
+        return (/^https?:$/.test(url.protocol) &&
+            (/\.pdf$/i.test(url.pathname) || /\/(?:-|~)\/media\//i.test(url.pathname)));
+    }
+    catch {
+        return false;
+    }
+}
+export async function downloadLink(href, fileName = "") {
+    const url = new URL(href, window.location.href);
+    if (!/^(https?:|blob:)$/.test(url.protocol)) {
+        throw new Error("Unsupported download URL");
+    }
+    let objectUrl;
+    // The download attribute only works for same-origin and blob URLs. Fetch
+    // cross-origin files first so a PDF cannot replace the editor with a viewer.
+    if (url.protocol !== "blob:" && url.origin !== window.location.origin) {
+        const response = await fetch(url.href);
+        if (!response.ok)
+            throw new Error("Could not download the linked file");
+        if (!fileName) {
+            fileName = url.pathname.split("/").pop() || "download";
+            try {
+                fileName = decodeURIComponent(fileName);
+            }
+            catch {
+                // Keep filenames with malformed percent escapes as authored.
+            }
+        }
+        objectUrl = URL.createObjectURL(await response.blob());
+    }
+    const anchor = document.createElement("a");
+    anchor.href = objectUrl ?? url.href;
+    anchor.download = fileName;
+    document.body.appendChild(anchor);
+    try {
+        anchor.click();
+    }
+    finally {
+        anchor.remove();
+        if (objectUrl) {
+            const downloadedUrl = objectUrl;
+            window.setTimeout(() => URL.revokeObjectURL(downloadedUrl), 60_000);
+        }
+    }
+}
+//# sourceMappingURL=linkDownload.js.map

package/dist/editor/bridge/linkDownload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkDownload.js","sourceRoot":"","sources":["../../../src/editor/bridge/linkDownload.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC1D,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CACL,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC9B,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAC3E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAAQ,GAAG,EAAE;IAC5D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,SAA6B,CAAC;IAClC,yEAAyE;IACzE,6EAA6E;IAC7E,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,UAAU,CAAC;YACvD,IAAI,CAAC;gBACH,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,6DAA6D;YAC/D,CAAC;QACH,CAAC;QACD,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,IAAI,GAAG,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC;IACpC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,MAAM,EAAE,CAAC;QAChB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,aAAa,GAAG,SAAS,CAAC;YAChC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/editor/client/SessionsDialog.d.ts

@@ -0,0 +1,2 @@
+import { DialogProps } from "./editContext";
+export declare const SessionsDialog: import("react").ForwardRefExoticComponent<DialogProps<void> & import("react").RefAttributes<DialogProps<void>>>;

package/dist/editor/client/SessionsDialog.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Dialog, DialogContent } from "../../components/ui/dialog";
+import { StyledDialogTitle } from "../../components/ui/styled-dialog-title";
+import { useImperativeHandle, useState, forwardRef, useEffect } from "react";
+import { Users } from "lucide-react";
+import { Sessions } from "../sidebar/Sessions";
+export const SessionsDialog = forwardRef(function SessionsDialog(props, ref) {
+    const [visible, setVisible] = useState(false);
+    const close = () => {
+        setVisible(false);
+        props.onClose(null);
+    };
+    useImperativeHandle(ref, () => ({
+        onClose: (result) => {
+            setVisible(false);
+            props.onClose(result);
+        },
+    }));
+    useEffect(() => {
+        setVisible(true);
+    }, []);
+    return (_jsx(Dialog, { open: visible, onOpenChange: (open) => {
+            if (!open)
+                close();
+        }, children: _jsxs(DialogContent, { className: "flex max-h-[min(32rem,80vh)] max-w-2xl flex-col gap-0 overflow-hidden p-0", "data-testid": "sessions-dialog", children: [_jsx(StyledDialogTitle, { icon: _jsx(Users, { strokeWidth: 1 }), title: "User sessions" }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto p-6", children: _jsx(Sessions, { onNavigate: close }) })] }) }));
+});
+//# sourceMappingURL=SessionsDialog.js.map

package/dist/editor/client/SessionsDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionsDialog.js","sourceRoot":"","sources":["../../../src/editor/client/SessionsDialog.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7E,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CACtC,SAAS,cAAc,CAAC,KAAK,EAAE,GAAG;IAChC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9C,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC;IAEF,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC9B,OAAO,EAAE,CAAC,MAAmB,EAAE,EAAE;YAC/B,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;KACF,CAAC,CAAC,CAAC;IAEJ,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,CACL,KAAC,MAAM,IACL,IAAI,EAAE,OAAO,EACb,YAAY,EAAE,CAAC,IAAa,EAAE,EAAE;YAC9B,IAAI,CAAC,IAAI;gBAAE,KAAK,EAAE,CAAC;QACrB,CAAC,YAED,MAAC,aAAa,IACZ,SAAS,EAAC,2EAA2E,iBACzE,iBAAiB,aAE7B,KAAC,iBAAiB,IAAC,IAAI,EAAE,KAAC,KAAK,IAAC,WAAW,EAAE,CAAC,GAAI,EAAE,KAAK,EAAC,eAAe,GAAG,EAC5E,cAAK,SAAS,EAAC,oCAAoC,YACjD,KAAC,QAAQ,IAAC,UAAU,EAAE,KAAK,GAAI,GAC3B,IACQ,GACT,CACV,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/editor/client/agentLoadItemPolicy.d.ts

@@ -0,0 +1,22 @@
+import type { ItemDescriptor } from "../pageModel";
+import type { FieldModificationStore } from "./fieldModificationStore";
+export declare const AGENT_LOAD_ITEM_RECENT_EDIT_WINDOW_MS = 10000;
+export declare const AGENT_LOAD_ITEM_TOAST_ID = "agent-load-item-deferred";
+export declare const AGENT_LOAD_ITEM_TOAST_DURATION_MS = 60000;
+export type AgentLoadItemDecision = "load" | "defer" | "ignore";
+export interface AgentLoadItemPolicyInput {
+    lastAgentTerminalInteractionAt: number;
+    lastLocalUserEditAt: number;
+    dirtyUserFieldCount: number;
+    now: number;
+    isSameItem: boolean;
+    recentEditWindowMs?: number;
+}
+export declare function resolveAgentLoadItemPolicy(p: AgentLoadItemPolicyInput): AgentLoadItemDecision;
+export declare function countDirtyUserFields(stores: FieldModificationStore[]): number;
+export declare function isSameLoadTarget(target: ItemDescriptor, current?: ItemDescriptor): boolean;
+export declare function dismissDeferredAgentLoadItemToast(): void;
+export declare function showDeferredAgentLoadItemToast(item: ItemDescriptor, deps: {
+    getCurrentItemDescriptor: () => ItemDescriptor | undefined;
+    open: (item: ItemDescriptor) => void | Promise<unknown>;
+}): void;

package/dist/editor/client/agentLoadItemPolicy.js

@@ -0,0 +1,60 @@
+import { toast } from "sonner";
+export const AGENT_LOAD_ITEM_RECENT_EDIT_WINDOW_MS = 10_000;
+export const AGENT_LOAD_ITEM_TOAST_ID = "agent-load-item-deferred";
+export const AGENT_LOAD_ITEM_TOAST_DURATION_MS = 60_000;
+export function resolveAgentLoadItemPolicy(p) {
+    if (p.isSameItem)
+        return "ignore";
+    const userEditedSinceTerminal = p.lastLocalUserEditAt > p.lastAgentTerminalInteractionAt;
+    if (p.lastAgentTerminalInteractionAt > 0 && !userEditedSinceTerminal)
+        return "load";
+    if (p.dirtyUserFieldCount > 0)
+        return "defer";
+    if (p.lastLocalUserEditAt > 0 &&
+        p.now - p.lastLocalUserEditAt <
+            (p.recentEditWindowMs ?? AGENT_LOAD_ITEM_RECENT_EDIT_WINDOW_MS))
+        return "defer";
+    return "load";
+}
+export function countDirtyUserFields(stores) {
+    // Do not deduplicate: a clean snapshot in another slot must not hide a dirty one.
+    return stores.reduce((count, store) => count +
+        store
+            .getAllFields()
+            .filter((field) => field.isDirty && !field.modifiedBy?.ai).length, 0);
+}
+export function isSameLoadTarget(target, current) {
+    if (!current || !target.id)
+        return false;
+    const normalizeId = (id) => id.replace(/[{}]/g, "").toLowerCase();
+    if (normalizeId(target.id) !== normalizeId(current.id))
+        return false;
+    if (target.language &&
+        target.language.toLowerCase() !== current.language?.toLowerCase())
+        return false;
+    if (target.database &&
+        current.database &&
+        target.database.toLowerCase() !== current.database.toLowerCase())
+        return false;
+    return (target.version === current.version || !target.version || !current.version);
+}
+export function dismissDeferredAgentLoadItemToast() {
+    toast.dismiss(AGENT_LOAD_ITEM_TOAST_ID);
+}
+export function showDeferredAgentLoadItemToast(item, deps) {
+    toast.info(`Agent wants to open ${item.name || item.path || item.id}`, {
+        id: AGENT_LOAD_ITEM_TOAST_ID,
+        description: item.path,
+        duration: AGENT_LOAD_ITEM_TOAST_DURATION_MS,
+        action: {
+            label: "Open",
+            onClick: () => {
+                dismissDeferredAgentLoadItemToast();
+                if (isSameLoadTarget(item, deps.getCurrentItemDescriptor()))
+                    return;
+                void deps.open(item);
+            },
+        },
+    });
+}
+//# sourceMappingURL=agentLoadItemPolicy.js.map

package/dist/editor/client/agentLoadItemPolicy.js.map

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

package/dist/editor/client/clipboardStorage.d.ts

@@ -0,0 +1,10 @@
+import type { ClipboardState } from "./editContext";
+/**
+ * The editor clipboard survives page switches and reloads so a component copied on
+ * one page can be pasted on another, even in a second browser tab.
+ */
+export declare const CLIPBOARD_STORAGE_KEY = "editor.clipboard";
+export declare function loadPersistedClipboard(): ClipboardState;
+export declare function persistClipboard(clipboard: ClipboardState): void;
+/** Parses a cross-tab `storage` event for the clipboard key; undefined when unrelated. */
+export declare function readClipboardFromStorageEvent(event: StorageEvent): ClipboardState | undefined;

package/dist/editor/client/clipboardStorage.js

@@ -0,0 +1,57 @@
+import { localStorageService } from "../services/localStorageService";
+/**
+ * The editor clipboard survives page switches and reloads so a component copied on
+ * one page can be pasted on another, even in a second browser tab.
+ */
+export const CLIPBOARD_STORAGE_KEY = "editor.clipboard";
+function isValidClipboardState(value) {
+    if (value === null)
+        return true;
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    if (candidate.kind === "items") {
+        return Array.isArray(candidate.items) && candidate.items.length > 0;
+    }
+    if (candidate.kind === "components") {
+        return (Array.isArray(candidate.components) &&
+            candidate.components.length > 0 &&
+            !!candidate.sourcePageItem &&
+            typeof candidate.sourcePageItem === "object");
+    }
+    return false;
+}
+export function loadPersistedClipboard() {
+    const raw = localStorageService.getString(CLIPBOARD_STORAGE_KEY);
+    if (!raw)
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        return isValidClipboardState(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function persistClipboard(clipboard) {
+    if (!clipboard) {
+        localStorageService.removeItem(CLIPBOARD_STORAGE_KEY);
+        return;
+    }
+    localStorageService.setString(CLIPBOARD_STORAGE_KEY, JSON.stringify(clipboard));
+}
+/** Parses a cross-tab `storage` event for the clipboard key; undefined when unrelated. */
+export function readClipboardFromStorageEvent(event) {
+    if (event.key !== `parhelia.${CLIPBOARD_STORAGE_KEY}`)
+        return undefined;
+    if (!event.newValue)
+        return null;
+    try {
+        const parsed = JSON.parse(event.newValue);
+        return isValidClipboardState(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=clipboardStorage.js.map

package/dist/editor/client/clipboardStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboardStorage.js","sourceRoot":"","sources":["../../../src/editor/client/clipboardStorage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAExD,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QACpC,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC;YACnC,SAAS,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YAC/B,CAAC,CAAC,SAAS,CAAC,cAAc;YAC1B,OAAO,SAAS,CAAC,cAAc,KAAK,QAAQ,CAC7C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,mBAAmB,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;IACjE,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAyB;IACxD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,mBAAmB,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IACD,mBAAmB,CAAC,SAAS,CAAC,qBAAqB,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,6BAA6B,CAC3C,KAAmB;IAEnB,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY,qBAAqB,EAAE;QAAE,OAAO,SAAS,CAAC;IACxE,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAY,CAAC;QACrD,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/editor/client/hooks/useRepositoryItemRefresh.d.ts

@@ -0,0 +1,4 @@
+import { type RefObject } from "react";
+import type { FullItem, ItemDescriptor } from "../../pageModel";
+import type { ItemsRepository } from "../itemsRepository";
+export declare function useRepositoryItemRefresh(repository: Pick<ItemsRepository, "getItem" | "revision"> & Partial<Pick<ItemsRepository, "subscribeItemsChanged">>, descriptor: ItemDescriptor | undefined, currentDescriptor: RefObject<ItemDescriptor | undefined>, setItem: (item: FullItem | undefined) => void): void;

package/dist/editor/client/hooks/useRepositoryItemRefresh.js

@@ -0,0 +1,62 @@
+import { useCallback, useEffect, useRef } from "react";
+/** Same item and language; any version (the current item may be Latest). */
+function sameItemKey(a, b) {
+    const normalize = (value) => (value ?? "").replace(/[{}]/g, "").toLowerCase();
+    return (normalize(a.id) === normalize(b.id) &&
+        normalize(a.language) === normalize(b.language) &&
+        (a.database || "master") === (b.database || "master"));
+}
+export function useRepositoryItemRefresh(repository, descriptor, currentDescriptor, setItem) {
+    const { getItem, subscribeItemsChanged } = repository;
+    const descriptorRef = useRef(descriptor);
+    descriptorRef.current = descriptor;
+    // Only the latest read may apply its result.
+    const latestReadRef = useRef(0);
+    const load = useCallback(() => {
+        const target = descriptorRef.current;
+        if (!target)
+            return;
+        const read = ++latestReadRef.current;
+        void (async () => {
+            const item = await getItem(target);
+            const current = currentDescriptor.current;
+            // A revision read can finish after navigation or after a newer refresh.
+            // In particular, an empty result for a deleted version must not clear
+            // the surviving version loaded by the delete command.
+            if (read !== latestReadRef.current ||
+                current?.id !== target.id ||
+                current.language !== target.language ||
+                current.version !== target.version ||
+                (current.database ?? "master") !== (target.database ?? "master"))
+                return;
+            setItem(item);
+        })();
+    }, [getItem, currentDescriptor, setItem]);
+    useEffect(() => {
+        load();
+    }, [
+        repository.revision,
+        load,
+        descriptor?.id,
+        descriptor?.language,
+        descriptor?.version,
+        descriptor?.database,
+    ]);
+    // A refresh of this item publishes its data just before the revision bump
+    // renders. Reading it right away (from the cache) puts the new item into the
+    // same commit as the new repository: one editor render per save, not two.
+    useEffect(() => {
+        if (!subscribeItemsChanged)
+            return;
+        return subscribeItemsChanged((changes) => {
+            const target = descriptorRef.current;
+            if (target &&
+                changes.some((change) => change.action === "update" &&
+                    change.source !== "local-field-update" &&
+                    sameItemKey(change.item, target))) {
+                load();
+            }
+        });
+    }, [subscribeItemsChanged, load]);
+}
+//# sourceMappingURL=useRepositoryItemRefresh.js.map

package/dist/editor/client/hooks/useRepositoryItemRefresh.js.map

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

package/dist/editor/client/liveEditState.d.ts

@@ -0,0 +1,16 @@
+import type { EditOperation } from "../../types";
+import { type EditContextType, type SelectionRange } from "./editContext";
+/** The published text selection, re-rendering on each change. */
+export declare function useSelectedRange(options?: {
+    editContext?: EditContextType;
+}): SelectionRange | undefined;
+/**
+ * A value derived from the published text selection, re-rendering only when
+ * it changes (e.g. `undefined` unless the selection concerns this field).
+ */
+export declare function useSelectedRange<S>(options: {
+    editContext?: EditContextType;
+    select: (range: SelectionRange | undefined) => S;
+}): S;
+/** The edit history (newest first), re-rendering on each change. */
+export declare function useEditHistory(): EditOperation[];

package/dist/editor/client/liveEditState.js

@@ -0,0 +1,25 @@
+import { useEditContext, } from "./editContext";
+import { createValueStore, useValueStore } from "./valueStore";
+// The text selection and the edit history change while the user types or
+// selects, so they live in stores instead of the EditContext value (a change
+// there re-renders every consumer in the editor). Contexts without a store
+// (tests, sandbox fixtures) fall back to the plain EditContext value.
+const noSelectedRangeStore = createValueStore(undefined);
+const keepRange = (range) => range;
+export function useSelectedRange(options) {
+    const contextFromHook = useEditContext();
+    const editContext = options?.editContext ?? contextFromHook;
+    const store = editContext?.selectedRangeStore;
+    const select = options?.select ?? keepRange;
+    return useValueStore(store ?? noSelectedRangeStore, (published) => select(store ? published : editContext?.selectedRange));
+}
+const EMPTY_EDIT_HISTORY = [];
+const noEditHistoryStore = createValueStore(EMPTY_EDIT_HISTORY);
+/** The edit history (newest first), re-rendering on each change. */
+export function useEditHistory() {
+    const editContext = useEditContext();
+    const store = editContext?.editHistoryStore;
+    const history = useValueStore(store ?? noEditHistoryStore);
+    return store ? history : (editContext?.editHistory ?? EMPTY_EDIT_HISTORY);
+}
+//# sourceMappingURL=liveEditState.js.map

package/dist/editor/client/liveEditState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveEditState.js","sourceRoot":"","sources":["../../../src/editor/client/liveEditState.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,GAGf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE/D,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,sEAAsE;AAEtE,MAAM,oBAAoB,GAAG,gBAAgB,CAC3C,SAAS,CACV,CAAC;AACF,MAAM,SAAS,GAAG,CAAC,KAAiC,EAAE,EAAE,CAAC,KAAK,CAAC;AAc/D,MAAM,UAAU,gBAAgB,CAAI,OAGnC;IACC,MAAM,eAAe,GAAG,cAAc,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,eAAe,CAAC;IAC5D,MAAM,KAAK,GAAG,WAAW,EAAE,kBAAkB,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,SAAS,CAAC;IAC5C,OAAO,aAAa,CAAC,KAAK,IAAI,oBAAoB,EAAE,CAAC,SAAS,EAAE,EAAE,CAChE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,kBAAkB,GAAoB,EAAE,CAAC;AAC/C,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;AAEhE,oEAAoE;AACpE,MAAM,UAAU,cAAc;IAC5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,WAAW,EAAE,gBAAgB,CAAC;IAC5C,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,IAAI,kBAAkB,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,WAAW,IAAI,kBAAkB,CAAC,CAAC;AAC5E,CAAC"}

package/dist/editor/client/liveSessionState.d.ts

@@ -0,0 +1,6 @@
+import type { EditSession } from "../../types";
+import { type EditContextType, type RemoteCaretPosition } from "./editContext";
+/** The session list (presence, field locks), re-rendering on each change. */
+export declare function useActiveSessions(explicitEditContext?: EditContextType): EditSession[];
+/** Live carets per session, re-rendering on each caret move. */
+export declare function useRemoteCarets(): Record<string, RemoteCaretPosition>;

package/dist/editor/client/liveSessionState.js

@@ -0,0 +1,20 @@
+import { useEditContext, } from "./editContext";
+import { createValueStore, useValueStore } from "./valueStore";
+// Session presence and carets change with every focus, lock and keystroke of
+// every connected user, so they live in stores instead of the EditContext
+// value (a change there re-renders every consumer in the editor).
+const noActiveSessionsStore = createValueStore([]);
+/** The session list (presence, field locks), re-rendering on each change. */
+export function useActiveSessions(explicitEditContext) {
+    const contextFromHook = useEditContext();
+    const editContext = explicitEditContext ?? contextFromHook;
+    const store = editContext?.activeSessionsStore;
+    const sessions = useValueStore(store ?? noActiveSessionsStore);
+    return store ? sessions : (editContext?.activeSessions ?? sessions);
+}
+const noRemoteCaretsStore = createValueStore({});
+/** Live carets per session, re-rendering on each caret move. */
+export function useRemoteCarets() {
+    return useValueStore(useEditContext()?.remoteCaretsStore ?? noRemoteCaretsStore);
+}
+//# sourceMappingURL=liveSessionState.js.map

package/dist/editor/client/liveSessionState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveSessionState.js","sourceRoot":"","sources":["../../../src/editor/client/liveSessionState.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,GAGf,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE/D,6EAA6E;AAC7E,0EAA0E;AAC1E,kEAAkE;AAElE,MAAM,qBAAqB,GAAG,gBAAgB,CAAgB,EAAE,CAAC,CAAC;AAElE,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAC/B,mBAAqC;IAErC,MAAM,eAAe,GAAG,cAAc,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,mBAAmB,IAAI,eAAe,CAAC;IAC3D,MAAM,KAAK,GAAG,WAAW,EAAE,mBAAmB,CAAC;IAC/C,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,IAAI,qBAAqB,CAAC,CAAC;IAC/D,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,cAAc,IAAI,QAAQ,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,mBAAmB,GAAG,gBAAgB,CAE1C,EAAE,CAAC,CAAC;AAEN,gEAAgE;AAChE,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAClB,cAAc,EAAE,EAAE,iBAAiB,IAAI,mBAAmB,CAC3D,CAAC;AACJ,CAAC"}

package/dist/editor/client/localUserEditActivity.d.ts

@@ -0,0 +1,3 @@
+export declare function markLocalUserEdit(now?: number): void;
+export declare function getLastLocalUserEditAt(): number;
+export declare function resetLocalUserEditActivityForTests(): void;

package/dist/editor/client/localUserEditActivity.js

@@ -0,0 +1,12 @@
+// Independent of field snapshots: an AI update can replace the same field entry.
+let lastLocalUserEditAt = 0;
+export function markLocalUserEdit(now = Date.now()) {
+    lastLocalUserEditAt = Math.max(lastLocalUserEditAt, now);
+}
+export function getLastLocalUserEditAt() {
+    return lastLocalUserEditAt;
+}
+export function resetLocalUserEditActivityForTests() {
+    lastLocalUserEditAt = 0;
+}
+//# sourceMappingURL=localUserEditActivity.js.map

package/dist/editor/client/localUserEditActivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localUserEditActivity.js","sourceRoot":"","sources":["../../../src/editor/client/localUserEditActivity.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,IAAI,mBAAmB,GAAG,CAAC,CAAC;AAE5B,MAAM,UAAU,iBAAiB,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAChD,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kCAAkC;IAChD,mBAAmB,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/dist/editor/client/valueStore.d.ts

@@ -0,0 +1,22 @@
+import { type SetStateAction } from "react";
+/**
+ * A single value that changes often but is read by few components.
+ *
+ * Kept outside the EditContext value on purpose: every change of that value
+ * re-renders every EditContext consumer in the editor, while a change here
+ * re-renders only the components that subscribe with {@link useValueStore}.
+ * Imperative readers (event handlers, effects) call `get()`.
+ */
+export interface ValueStore<T> {
+    get: () => T;
+    /** Same contract as a React state setter; unchanged values notify nobody. */
+    set: (next: SetStateAction<T>) => void;
+    subscribe: (listener: () => void) => () => void;
+}
+export declare function createValueStore<T>(initialValue: T): ValueStore<T>;
+export declare function useValueStore<T>(store: ValueStore<T>): T;
+/**
+ * Re-renders only when `select`'s result changes. It must return a stable
+ * value (a primitive, or an object held by the store) for an unchanged store.
+ */
+export declare function useValueStore<T, S>(store: ValueStore<T>, select: (value: T) => S): S;

package/dist/editor/client/valueStore.js

@@ -0,0 +1,29 @@
+import { useSyncExternalStore } from "react";
+export function createValueStore(initialValue) {
+    let value = initialValue;
+    const listeners = new Set();
+    return {
+        get: () => value,
+        set: (next) => {
+            const resolved = typeof next === "function" ? next(value) : next;
+            if (Object.is(resolved, value))
+                return;
+            value = resolved;
+            for (const listener of [...listeners])
+                listener();
+        },
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+export function useValueStore(store, select) {
+    const getSnapshot = select
+        ? () => select(store.get())
+        : store.get;
+    return useSyncExternalStore(store.subscribe, getSnapshot, getSnapshot);
+}
+//# sourceMappingURL=valueStore.js.map

package/dist/editor/client/valueStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueStore.js","sourceRoot":"","sources":["../../../src/editor/client/valueStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAuB,MAAM,OAAO,CAAC;AAiBlE,MAAM,UAAU,gBAAgB,CAAI,YAAe;IACjD,IAAI,KAAK,GAAG,YAAY,CAAC;IACzB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IACxC,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK;QAChB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;YACZ,MAAM,QAAQ,GACZ,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAE,IAA2B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1E,IAAI,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;gBAAE,OAAO;YACvC,KAAK,GAAG,QAAQ,CAAC;YACjB,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC;gBAAE,QAAQ,EAAE,CAAC;QACpD,CAAC;QACD,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAWD,MAAM,UAAU,aAAa,CAC3B,KAAoB,EACpB,MAAwB;IAExB,MAAM,WAAW,GAAgB,MAAM;QACrC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAC3B,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;IACd,OAAO,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AACzE,CAAC"}

package/dist/editor/commands/componentClipboardCommands.d.ts

@@ -0,0 +1,35 @@
+import type { ComponentClipboardState, EditContextType } from "../client/editContext";
+import type { Component, Placeholder } from "../pageModel";
+import type { ComponentCommand, ComponentCommandProviderContext } from "./componentCommands";
+import type { PlaceholderCommand, PlaceholderCommandProviderContext } from "./placeholderCommands";
+/** The clipboard when it holds components, otherwise null. */
+export declare function getComponentClipboard(editContext: EditContextType): ComponentClipboardState | null;
+export declare function describeClipboardComponents(clipboard: ComponentClipboardState): string;
+/**
+ * Puts `components` on the editor clipboard. Returns false when nothing copyable was
+ * given (e.g. only the page root). The components stay where they are; pasting copies them.
+ */
+export declare function copyComponentsToClipboard(editContext: EditContextType, components: Component[]): boolean;
+/**
+ * Pastes the clipboard components into `placeholderKey` of the current page at `index`
+ * (-1 appends). Checks the placeholder's insert options first so the user gets a clear
+ * message instead of a failed operation. Resolves to true when the operation ran.
+ */
+export declare function pasteClipboardComponents(editContext: EditContextType, placeholderKey: string, index: number): Promise<boolean>;
+/** Ctrl+C with a component selection outside the content tree. */
+export declare function copySelectedComponents(editContext: EditContextType): boolean;
+/**
+ * Ctrl+V with a component selection: pastes after the selected component, or into it
+ * when it has exactly one editable placeholder and no parent (the page root).
+ */
+export declare function pasteRelativeToSelectedComponent(editContext: EditContextType): Promise<boolean>;
+/**
+ * "Copy" for the selected components and "Paste after / into" for a single target
+ * component. Registered through `configuration.componentCommands.providers`.
+ */
+export declare function componentClipboardCommandProvider(components: Component[], editContext: EditContextType, providerContext?: ComponentCommandProviderContext): ComponentCommand[];
+/**
+ * "Paste here" for a placeholder node (component navigator). Registered through
+ * `configuration.placeholderCommands.providers`.
+ */
+export declare function placeholderClipboardCommandProvider(placeholders: Placeholder[], editContext: EditContextType, providerContext?: PlaceholderCommandProviderContext): PlaceholderCommand[];