@parhelia/core 0.3.12832 → 0.3.12833

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

@@ -0,0 +1,218 @@
+/** Tool call IDs the transcript shows as awaiting a person's approval. */
+export function awaitingApprovalToolCallIds(messages) {
+    const ids = new Set();
+    for (const message of messages) {
+        for (const toolCall of message.toolCalls ?? []) {
+            if (toolCall.requiresApproval &&
+                !toolCall.isCompleted &&
+                !/\((approved|rejected)\)$/.test(toolCall.functionName ?? "") &&
+                toolCall.toolCallId) {
+                ids.add(toolCall.toolCallId);
+            }
+        }
+    }
+    return ids;
+}
+function sameMessage(a, b) {
+    // A review row without a message (none is stored today) matches on the call ID alone.
+    return !a || !b || a.toLowerCase() === b.toLowerCase();
+}
+function byTime(a, b) {
+    return a.createdAtUtc.localeCompare(b.createdAtUtc);
+}
+function isRejected(call) {
+    return /^REJECTED\b/.test(call.functionError ?? "");
+}
+function statusOf(call) {
+    if (call.isPruned)
+        return "pruned";
+    if (call.isCompleted)
+        return call.functionError ? "failed" : "completed";
+    if (call.executionStartedAt)
+        return "running";
+    return "waiting";
+}
+function approvalOf(call, reviews, awaitsApproval) {
+    const lastReview = reviews[reviews.length - 1];
+    if (isRejected(call)) {
+        return { kind: "rejected", label: "Rejected by a person" };
+    }
+    if (call.approvalSource === "auto" ||
+        call.executionSource === "auto-approved") {
+        return { kind: "approved-by-auto", label: "Approved by the Auto reviewer" };
+    }
+    if (call.approvalBy) {
+        return {
+            kind: "approved-by-person",
+            label: `Approved by ${call.approvalBy}`,
+        };
+    }
+    if (lastReview?.decision === "deny") {
+        return { kind: "denied-by-auto", label: "Denied by the Auto reviewer" };
+    }
+    // Outside Auto the stored row cannot tell a pending approval from a call that has not run yet;
+    // the transcript can, so the caller passes the calls it shows as awaiting approval.
+    const handedToPerson = awaitsApproval ||
+        lastReview?.decision === "require-human" ||
+        call.frozenApprovalRequirement === "Human" ||
+        call.frozenApprovalRequirement === "Review";
+    if (!call.isCompleted && !call.executionStartedAt && handedToPerson) {
+        return { kind: "pending", label: "Waiting for a person" };
+    }
+    return { kind: "not-required", label: "No approval needed" };
+}
+/**
+ * Joins each tool call with its Auto reviews and the reviewer's requests for them.
+ * `awaitingApprovalIds` are the tool call IDs the transcript shows as awaiting approval.
+ */
+export function buildToolCallDiagnosticsRows(diagnostics, awaitingApprovalIds = new Set()) {
+    const reviews = [...diagnostics.reviews].sort(byTime);
+    const requests = [...diagnostics.reviewRequests].sort((a, b) => byTime(a, b) || a.attempt - b.attempt);
+    return diagnostics.toolCalls.map((call, position) => {
+        const callReviews = reviews.filter((review) => (call.autoReviewId != null &&
+            review.reviewId.toLowerCase() === call.autoReviewId.toLowerCase()) ||
+            (!!call.toolCallId &&
+                review.toolCallId === call.toolCallId &&
+                sameMessage(review.messageId, call.messageId)));
+        const callRequests = requests.filter((request) => callReviews.some((review) => !!review.batchId &&
+            review.batchId === request.batchId &&
+            review.generation === request.generation &&
+            sameMessage(review.messageId, request.messageId)));
+        const approval = approvalOf(call, callReviews, !!call.toolCallId && awaitingApprovalIds.has(call.toolCallId));
+        return {
+            call,
+            index: position + 1,
+            status: statusOf(call),
+            approval: approval.kind,
+            approvalLabel: approval.label,
+            reviews: callReviews,
+            requests: callRequests,
+        };
+    });
+}
+/** Pretty-prints JSON text; anything else is returned as is. */
+export function prettyJson(value) {
+    if (!value)
+        return "";
+    const trimmed = value.trim();
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("["))
+        return value;
+    try {
+        return JSON.stringify(JSON.parse(trimmed), null, 2);
+    }
+    catch {
+        return value;
+    }
+}
+/** Notes a text the server cut to its diagnostics limit. */
+export function truncationNote(shown, fullLength) {
+    if (!shown || fullLength == null || fullLength <= shown.length)
+        return null;
+    return `(cut to ${shown.length.toLocaleString()} of ${fullLength.toLocaleString()} characters)`;
+}
+function formatTime(value) {
+    if (!value)
+        return "—";
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? value : parsed.toLocaleString();
+}
+export function describeReview(review) {
+    if (review.state === "failed") {
+        return `Review failed, a person decides${review.failure ? `: ${review.failure}` : ""}`;
+    }
+    const parts = [
+        `Decision: ${review.decision ?? "—"}`,
+        review.recommendedOutcome
+            ? `recommended ${review.recommendedOutcome}`
+            : null,
+        review.riskLevel ? `risk ${review.riskLevel}` : null,
+        review.userAuthorization
+            ? `user authorization ${review.userAuthorization}`
+            : null,
+        review.reasonCode ? `reason ${review.reasonCode}` : null,
+    ].filter(Boolean);
+    return parts.join(" · ");
+}
+export function describeReviewUsage(entry) {
+    return [
+        entry.modelName ? `model ${entry.modelName}` : null,
+        entry.inputTokens != null || entry.outputTokens != null
+            ? `${(entry.inputTokens ?? 0).toLocaleString()} in / ${(entry.outputTokens ?? 0).toLocaleString()} out tokens`
+            : null,
+        entry.cost != null ? `cost ${entry.cost.toFixed(4)}` : null,
+        entry.durationMs != null ? `${entry.durationMs.toLocaleString()} ms` : null,
+    ]
+        .filter(Boolean)
+        .join(" · ");
+}
+function indent(text, prefix = "    ") {
+    return text
+        .split("\n")
+        .map((line) => prefix + line)
+        .join("\n");
+}
+/** Plain-text version of the section, for copy, download and search. */
+export function formatToolCallDiagnosticsText(diagnostics, rows) {
+    if (rows.length === 0)
+        return "";
+    const blocks = [];
+    if (diagnostics.toolCalls.length >= diagnostics.toolCallLimit) {
+        blocks.push(`Showing the newest ${diagnostics.toolCallLimit.toLocaleString()} tool calls.`);
+    }
+    for (const row of rows) {
+        const { call } = row;
+        const lines = [
+            `#${row.index} ${call.functionName ?? "(unknown tool)"} · ${row.status} · ${row.approvalLabel}`,
+            `  Created ${formatTime(call.createdDate)} · message ${call.messageIndex}${call.callOrdinal != null ? `, call ${call.callOrdinal}` : ""} · ${call.toolCallId ?? "—"}`,
+        ];
+        if (call.responseTimeMs != null) {
+            lines.push(`  Response time: ${call.responseTimeMs.toLocaleString()} ms`);
+        }
+        if (call.executionSource) {
+            lines.push(`  Execution source: ${call.executionSource}`);
+        }
+        if (call.frozenApprovalRequirement) {
+            lines.push(`  Auto route: ${call.frozenApprovalRequirement}`);
+        }
+        if (call.approvalBy || call.approvalAt) {
+            lines.push(`  Approved by ${call.approvalBy ?? "—"} at ${formatTime(call.approvalAt)}`);
+        }
+        for (const review of row.reviews) {
+            lines.push(`  Auto review (${formatTime(review.createdAtUtc)}): ${describeReview(review)}`);
+            if (review.rationale)
+                lines.push(`    Rationale: ${review.rationale}`);
+            const usage = describeReviewUsage({
+                modelName: review.modelName,
+                durationMs: review.durationMs,
+                inputTokens: review.batchInputTokens,
+                outputTokens: review.batchOutputTokens,
+                cost: review.batchCost,
+            });
+            if (usage)
+                lines.push(`    Batch ${review.batchId ?? "—"}: ${usage}`);
+        }
+        for (const request of row.requests) {
+            lines.push(`  Reviewer request, attempt ${request.attempt} (${formatTime(request.createdAtUtc)}): ${describeReviewUsage(request) || "—"}`);
+            if (request.error)
+                lines.push(`    Error: ${request.error}`);
+            lines.push("    Prompt:", indent(prettyJson(request.userPrompt), "      "));
+            lines.push("    Response:", indent(request.response ? prettyJson(request.response) : "(none)", "      "));
+        }
+        if (call.functionArguments) {
+            lines.push(`  Arguments: ${truncationNote(call.functionArguments, call.argumentsLength) ?? ""}`.trimEnd(), indent(prettyJson(call.functionArguments)));
+        }
+        if (call.functionError) {
+            lines.push(`  Error: ${truncationNote(call.functionError, call.errorLength) ?? ""}`.trimEnd(), indent(call.functionError));
+        }
+        else if (call.functionResult) {
+            lines.push(`  Result: ${truncationNote(call.functionResult, call.resultLength) ?? ""}`.trimEnd(), indent(prettyJson(call.functionResult)));
+        }
+        blocks.push(lines.join("\n"));
+    }
+    const systemPrompt = diagnostics.reviewRequests.find((request) => request.systemPrompt);
+    if (systemPrompt?.systemPrompt) {
+        blocks.push(`Reviewer system prompt (${systemPrompt.promptVersion ?? "unknown version"}):\n${indent(systemPrompt.systemPrompt, "  ")}`);
+    }
+    return blocks.join("\n\n");
+}
+//# sourceMappingURL=toolCallDiagnostics.js.map

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

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

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/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/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[];