@parhelia/core 0.3.12831 → 0.3.12833

package/dist/editor/page-viewer/overviewRuler.js

@@ -0,0 +1,226 @@
+import { createContext, useContext, useEffect, useSyncExternalStore, } from "react";
+/**
+ * Paint order where marks overlap: later tones draw over earlier ones, so an
+ * open comment or a validation error stays visible on top of the text it is
+ * about, and the many small spelling marks never hide anything.
+ */
+export const OVERVIEW_RULER_TONE_PAINT_ORDER = [
+    "comment-resolved",
+    "spelling",
+    "added",
+    "removed",
+    "validation-suggestion",
+    "validation-warning",
+    "suggestion",
+    "validation-error",
+    "comment",
+];
+export const OVERVIEW_RULER_WIDTH = 10;
+/**
+ * Every mark is a line of this height in ruler pixels, at the top of what it
+ * marks, however long the marked text is: the ruler shows where, not how much.
+ */
+export const OVERVIEW_RULER_MARK_HEIGHT = 3;
+function paintIndex(tone) {
+    return OVERVIEW_RULER_TONE_PAINT_ORDER.indexOf(tone);
+}
+function mergeLists(a, b) {
+    if (!b?.length)
+        return a;
+    if (!a?.length)
+        return b;
+    return Array.from(new Set([...a, ...b]));
+}
+/**
+ * Collapses highlight rects into ruler dashes: one dash per run of marks, so a
+ * paragraph of highlights reads as a single mark instead of a stack of
+ * overlapping slivers. Each tone is merged on its own, in paint order; a
+ * merged dash keeps the ids and details of everything it covers.
+ */
+export function buildOverviewRulerMarks(highlights) {
+    const byTone = new Map();
+    for (const highlight of highlights) {
+        const marks = byTone.get(highlight.tone) ?? [];
+        for (const rect of highlight.rects) {
+            marks.push({
+                top: Math.round(rect.y),
+                height: Math.max(Math.round(rect.height), 1),
+                tone: highlight.tone,
+                ...(highlight.ids?.length ? { ids: highlight.ids } : {}),
+                ...(highlight.details?.length ? { details: highlight.details } : {}),
+            });
+        }
+        byTone.set(highlight.tone, marks);
+    }
+    const merged = [];
+    for (const tone of OVERVIEW_RULER_TONE_PAINT_ORDER) {
+        const sorted = (byTone.get(tone) ?? []).sort((a, b) => a.top - b.top);
+        let last;
+        for (const mark of sorted) {
+            if (last && mark.top <= last.top + last.height + 1) {
+                last.height = Math.max(last.height, mark.top + mark.height - last.top);
+                const ids = mergeLists(last.ids, mark.ids);
+                if (ids)
+                    last.ids = ids;
+                const details = mergeLists(last.details, mark.details);
+                if (details)
+                    last.details = details;
+                continue;
+            }
+            last = { ...mark };
+            merged.push(last);
+        }
+    }
+    return merged;
+}
+/**
+ * Every published mark in paint order, scaled from page pixels to fractions of
+ * the ruler. Null while no source is published or the page extent is unknown.
+ */
+export function layoutOverviewRuler({ sources, extent, }) {
+    const published = Object.entries(sources);
+    if (published.length === 0 || !(extent > 0))
+        return null;
+    return published
+        .flatMap(([source, marks]) => marks.map((mark) => ({ source, mark })))
+        .sort((a, b) => paintIndex(a.mark.tone) - paintIndex(b.mark.tone))
+        .map(({ source, mark }) => ({
+        top: Math.min(Math.max(mark.top / extent, 0), 1),
+        tone: mark.tone,
+        source,
+        mark,
+    }));
+}
+function marksEqual(a, b) {
+    return (a.length === b.length &&
+        a.every((mark, index) => mark.top === b[index].top &&
+            mark.height === b[index].height &&
+            mark.tone === b[index].tone &&
+            listsEqual(mark.ids, b[index].ids) &&
+            listsEqual(mark.details, b[index].details)));
+}
+/** For measurements producing marks: `null` means "no marks to publish". */
+export function overviewRulerMarksEqual(a, b) {
+    return a && b ? marksEqual(a, b) : a === b;
+}
+function listsEqual(a, b) {
+    const left = a ?? [];
+    const right = b ?? [];
+    return (left.length === right.length &&
+        left.every((value, index) => value === right[index]));
+}
+export function createOverviewRulerStore() {
+    let snapshot = { sources: {}, extent: 0 };
+    const listeners = new Set();
+    const handlers = new Map();
+    let scroller = null;
+    const update = (next) => {
+        snapshot = next;
+        listeners.forEach((listener) => listener());
+    };
+    return {
+        getSnapshot: () => snapshot,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        /**
+         * `null` withdraws the source; an empty array keeps the source published
+         * with nothing marked.
+         */
+        publish(source, marks) {
+            const current = snapshot.sources[source];
+            if (marks === null ? !current : current && marksEqual(current, marks)) {
+                return;
+            }
+            const sources = { ...snapshot.sources };
+            if (marks === null)
+                delete sources[source];
+            else
+                sources[source] = marks;
+            update({ ...snapshot, sources });
+        },
+        setExtent(extent) {
+            if (extent !== snapshot.extent)
+                update({ ...snapshot, extent });
+        },
+        /** Scrolls the canvas to a mark: what a click does by default. */
+        setScroller(next) {
+            scroller = next;
+        },
+        /** What a click on the source's marks does; not part of the snapshot. */
+        setActivateHandler(source, handler) {
+            if (handler)
+                handlers.set(source, handler);
+            else
+                handlers.delete(source);
+        },
+        activate(source, mark) {
+            const scrollToMark = () => scroller?.(mark);
+            const handler = handlers.get(source);
+            if (handler)
+                handler(mark, scrollToMark);
+            else
+                scrollToMark();
+        },
+    };
+}
+export const OverviewRulerContext = createContext(null);
+export function useOverviewRulerStore() {
+    return useContext(OverviewRulerContext);
+}
+const EMPTY_SNAPSHOT = { sources: {}, extent: 0 };
+const subscribeNothing = () => () => { };
+const getEmptySnapshot = () => EMPTY_SNAPSHOT;
+export function useOverviewRulerSnapshot() {
+    const store = useContext(OverviewRulerContext);
+    return useSyncExternalStore(store?.subscribe ?? subscribeNothing, store?.getSnapshot ?? getEmptySnapshot, store?.getSnapshot ?? getEmptySnapshot);
+}
+/**
+ * Publishes marks into the surrounding ruler (a no-op outside one, e.g. on
+ * the minimap, or without a `source`). Pass memoized marks; `null` keeps the
+ * source out of the ruler. `onActivate` replaces scrolling to a clicked mark.
+ */
+export function usePublishOverviewRulerMarks(source, marks, onActivate) {
+    const store = useContext(OverviewRulerContext);
+    useEffect(() => {
+        if (source)
+            store?.publish(source, marks);
+    }, [store, source, marks]);
+    useEffect(() => {
+        if (source)
+            store?.setActivateHandler(source, onActivate ?? null);
+    }, [store, source, onActivate]);
+    useEffect(() => {
+        if (!store || !source)
+            return;
+        return () => {
+            store.publish(source, null);
+            store.setActivateHandler(source, null);
+        };
+    }, [store, source]);
+}
+/**
+ * Connects the ruler to its canvas: the page height the marks are scaled
+ * against (0 = unknown) and how to scroll the canvas to a mark.
+ */
+export function usePublishOverviewRulerCanvas(extent, scrollToMark) {
+    const store = useContext(OverviewRulerContext);
+    useEffect(() => {
+        store?.setExtent(extent);
+    }, [store, extent]);
+    useEffect(() => {
+        store?.setScroller(scrollToMark);
+    }, [store, scrollToMark]);
+    useEffect(() => {
+        if (!store)
+            return;
+        return () => {
+            store.setExtent(0);
+            store.setScroller(null);
+        };
+    }, [store]);
+}
+//# sourceMappingURL=overviewRuler.js.map

package/dist/editor/page-viewer/overviewRuler.js.map

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

package/dist/editor/page-viewer/previewEditAttempt.d.ts

@@ -0,0 +1,31 @@
+import type { InteractionEventPayload } from "../bridge/protocol";
+import type { EditContextType } from "../client/editContext";
+/**
+ * Preview mode leaves every canvas field read-only (the bridge flips
+ * contenteditable off and blurs the field), so a user who forgot to leave
+ * preview clicks into a text and types into the void: no caret, no change, no
+ * explanation. These helpers recognise that keystroke and answer it with a
+ * toast that names the cause and offers the one-click way out.
+ */
+export declare const PREVIEW_EDIT_ATTEMPT_TOAST_ID = "preview-mode-edit-attempt";
+export declare const PREVIEW_EDIT_ATTEMPT_MODE_CHANGE_REASON = "preview-edit-attempt";
+export declare const PREVIEW_EDIT_ATTEMPT_TITLE = "Preview mode is read-only";
+export declare const PREVIEW_EDIT_ATTEMPT_DESCRIPTION = "Switch to edit mode to change the content of this page.";
+export declare const PREVIEW_EDIT_ATTEMPT_ACTION_LABEL = "Switch to edit mode";
+/**
+ * Whether a bridge keydown, delivered while the editor is in preview mode, was
+ * meant to change a field's content.
+ *
+ * Only keystrokes aimed at a field count (the bridge resolves the field from
+ * the caret the click left behind). Printable characters, Backspace and Delete
+ * qualify, as do paste and cut. Deliberately left out: Space, arrows and the
+ * other navigation keys scroll a preview and Enter follows a focused link, so a
+ * hint there would interrupt legitimate previewing. A sentence typed into a
+ * read-only field trips on its first letter anyway.
+ */
+export declare function isPreviewEditAttemptInteraction(interaction: InteractionEventPayload): boolean;
+/**
+ * Shows (or refreshes) the single preview-mode hint toast. The stable id keeps
+ * a burst of keystrokes from stacking toasts; the action leaves preview mode.
+ */
+export declare function showPreviewEditAttemptToast(editContext: Pick<EditContextType, "changeMode">): void;

package/dist/editor/page-viewer/previewEditAttempt.js

@@ -0,0 +1,68 @@
+import { toast } from "sonner";
+/**
+ * Preview mode leaves every canvas field read-only (the bridge flips
+ * contenteditable off and blurs the field), so a user who forgot to leave
+ * preview clicks into a text and types into the void: no caret, no change, no
+ * explanation. These helpers recognise that keystroke and answer it with a
+ * toast that names the cause and offers the one-click way out.
+ */
+export const PREVIEW_EDIT_ATTEMPT_TOAST_ID = "preview-mode-edit-attempt";
+export const PREVIEW_EDIT_ATTEMPT_MODE_CHANGE_REASON = "preview-edit-attempt";
+export const PREVIEW_EDIT_ATTEMPT_TITLE = "Preview mode is read-only";
+export const PREVIEW_EDIT_ATTEMPT_DESCRIPTION = "Switch to edit mode to change the content of this page.";
+export const PREVIEW_EDIT_ATTEMPT_ACTION_LABEL = "Switch to edit mode";
+const CONTENT_EDITING_KEYS = new Set(["Backspace", "Delete"]);
+// Paste and cut. Identified by physical key as well, so a non-Latin keyboard
+// layout (where the V key reports e.g. "м") is recognised too.
+const CONTENT_EDITING_SHORTCUT_KEYS = new Set(["v", "x"]);
+const CONTENT_EDITING_SHORTCUT_CODES = new Set(["KeyV", "KeyX"]);
+/**
+ * Whether a bridge keydown, delivered while the editor is in preview mode, was
+ * meant to change a field's content.
+ *
+ * Only keystrokes aimed at a field count (the bridge resolves the field from
+ * the caret the click left behind). Printable characters, Backspace and Delete
+ * qualify, as do paste and cut. Deliberately left out: Space, arrows and the
+ * other navigation keys scroll a preview and Enter follows a focused link, so a
+ * hint there would interrupt legitimate previewing. A sentence typed into a
+ * read-only field trips on its first letter anyway.
+ */
+export function isPreviewEditAttemptInteraction(interaction) {
+    if (interaction.kind !== "keydown")
+        return false;
+    if (!interaction.fieldId)
+        return false;
+    if (interaction.altKey)
+        return false;
+    const key = interaction.key ?? "";
+    if (interaction.ctrlKey || interaction.metaKey) {
+        return (CONTENT_EDITING_SHORTCUT_KEYS.has(key.toLowerCase()) ||
+            CONTENT_EDITING_SHORTCUT_CODES.has(interaction.code ?? ""));
+    }
+    if (CONTENT_EDITING_KEYS.has(key))
+        return true;
+    // Named keys ("ArrowLeft", "Shift", "Dead", "Process", "Unidentified") are
+    // longer than a single code point; Space is excluded on purpose.
+    return key !== " " && [...key].length === 1;
+}
+/**
+ * Shows (or refreshes) the single preview-mode hint toast. The stable id keeps
+ * a burst of keystrokes from stacking toasts; the action leaves preview mode.
+ */
+export function showPreviewEditAttemptToast(editContext) {
+    toast.info(PREVIEW_EDIT_ATTEMPT_TITLE, {
+        id: PREVIEW_EDIT_ATTEMPT_TOAST_ID,
+        description: PREVIEW_EDIT_ATTEMPT_DESCRIPTION,
+        duration: 8000,
+        action: {
+            label: PREVIEW_EDIT_ATTEMPT_ACTION_LABEL,
+            onClick: () => {
+                toast.dismiss(PREVIEW_EDIT_ATTEMPT_TOAST_ID);
+                void editContext.changeMode("edit", {
+                    reason: PREVIEW_EDIT_ATTEMPT_MODE_CHANGE_REASON,
+                });
+            },
+        },
+    });
+}
+//# sourceMappingURL=previewEditAttempt.js.map

package/dist/editor/page-viewer/previewEditAttempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewEditAttempt.js","sourceRoot":"","sources":["../../../src/editor/page-viewer/previewEditAttempt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAK/B;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AACzE,MAAM,CAAC,MAAM,uCAAuC,GAAG,sBAAsB,CAAC;AAE9E,MAAM,CAAC,MAAM,0BAA0B,GAAG,2BAA2B,CAAC;AACtE,MAAM,CAAC,MAAM,gCAAgC,GAC3C,yDAAyD,CAAC;AAC5D,MAAM,CAAC,MAAM,iCAAiC,GAAG,qBAAqB,CAAC;AAEvE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9D,6EAA6E;AAC7E,+DAA+D;AAC/D,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,8BAA8B,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,+BAA+B,CAC7C,WAAoC;IAEpC,IAAI,WAAW,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,CAAC,WAAW,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,WAAW,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAErC,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,IAAI,EAAE,CAAC;IAElC,IAAI,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QAC/C,OAAO,CACL,6BAA6B,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACpD,8BAA8B,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,CAC3D,CAAC;IACJ,CAAC;IAED,IAAI,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/C,2EAA2E;IAC3E,iEAAiE;IACjE,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAgD;IAEhD,KAAK,CAAC,IAAI,CAAC,0BAA0B,EAAE;QACrC,EAAE,EAAE,6BAA6B;QACjC,WAAW,EAAE,gCAAgC;QAC7C,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE;YACN,KAAK,EAAE,iCAAiC;YACxC,OAAO,EAAE,GAAG,EAAE;gBACZ,KAAK,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;gBAC7C,KAAK,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE;oBAClC,MAAM,EAAE,uCAAuC;iBAChD,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/editor/page-viewer/renderingApproval.d.ts

@@ -0,0 +1,59 @@
+import { type PageVersion, type RenderingPageState, type RenderingState, type RenderingsResult } from "../services/renderingsService";
+export type RenderingApprovalStatus = "approved" | "changed" | "unapproved" | "sandbox";
+export declare function getRenderingApprovalStatus(rendering: Pick<RenderingState, "approved" | "changedSinceApproval" | "sandbox">): RenderingApprovalStatus;
+export declare const RENDERING_APPROVAL_LABELS: Record<RenderingApprovalStatus, string>;
+export declare const RENDERING_APPROVAL_DESCRIPTIONS: Record<RenderingApprovalStatus, string>;
+/**
+ * What the strip says about client code that does not run, if any: client
+ * code runs only after an administrator approved its rendering. Sandbox
+ * renderings are never approved; their owner (who can review them) tries
+ * their client code in the review.
+ */
+export declare function getClientCodeNotice(renderings: readonly RenderingState[], canReview?: boolean): string | undefined;
+/** Badge colors per status (Badge has no green or orange variant). */
+export declare const RENDERING_APPROVAL_BADGE_CLASSES: Record<RenderingApprovalStatus, string>;
+/** An account name without its domain: "sitecore\\jane" becomes "jane". */
+export declare function stripAccountDomain(account: string): string;
+export declare function formatApprovalDate(value: string | null | undefined): string | undefined;
+/** The name a rendering is listed under. */
+export declare function getRenderingDisplayName(rendering: RenderingState): string;
+/**
+ * The renderings in the order the page shows them (as `renderingIds` lists
+ * them), then any the server added that the page does not list, the theme
+ * last.
+ */
+export declare function sortRenderingsForPage(renderings: readonly RenderingState[], renderingIds: readonly string[]): RenderingState[];
+/** The renderings a published page would leave out. */
+export declare function getUnapprovedRenderings(renderings: readonly RenderingState[]): RenderingState[];
+export type UseRenderingPageStateOptions = {
+    page: PageVersion | undefined;
+    renderingIds: readonly string[];
+    /** Off: nothing is requested and nothing is reported. */
+    enabled: boolean;
+    fetchPageState?: (page: PageVersion, renderingIds: readonly string[], signal?: AbortSignal) => Promise<RenderingsResult<RenderingPageState>>;
+};
+/**
+ * The approval state of a page's dynamic renderings (and its tenant's theme),
+ * requested again whenever the page or its renderings change, and on
+ * `refresh()`. A refresh keeps showing the previous answer until the new one
+ * is there.
+ */
+export declare function useRenderingPageState({ page, renderingIds, enabled, fetchPageState, }: UseRenderingPageStateOptions): {
+    state: RenderingPageState | undefined;
+    error: string | undefined;
+    loading: boolean;
+    refresh: () => void;
+};
+export declare function recordPageRenderingIds(page: {
+    id: string;
+    language: string;
+}, renderingIds: readonly string[]): void;
+export declare function getRecordedPageRenderingIds(page: {
+    id: string;
+    language: string;
+} | undefined): string[];
+/** The dynamic renderings last read from the page's canvas (see above). */
+export declare function useRecordedPageRenderingIds(page: {
+    id: string;
+    language: string;
+} | undefined): string[];

package/dist/editor/page-viewer/renderingApproval.js

@@ -0,0 +1,186 @@
+import { useEffect, useState, useSyncExternalStore } from "react";
+import { fetchRenderingPageState, } from "../services/renderingsService";
+import { normalizeRenderingId, sameRenderingIds } from "./interactivePreview";
+import { DYNAMIC_RENDERING_CHANGED_EVENT } from "./renderingChanges";
+export function getRenderingApprovalStatus(rendering) {
+    if (rendering.sandbox)
+        return "sandbox";
+    if (rendering.approved)
+        return "approved";
+    return rendering.changedSinceApproval ? "changed" : "unapproved";
+}
+export const RENDERING_APPROVAL_LABELS = {
+    approved: "Approved",
+    changed: "Changed since approval",
+    unapproved: "Not approved",
+    sandbox: "Preview only",
+};
+export const RENDERING_APPROVAL_DESCRIPTIONS = {
+    approved: "Published pages show this rendering.",
+    changed: "The code changed after it was approved. Published pages do not show it until it is approved again.",
+    unapproved: "Published pages do not show this rendering until an administrator approves it.",
+    sandbox: "Renderings in a sandbox cannot be approved, so their client code runs only when the sandbox's owner tries it under Review.",
+};
+/**
+ * What the strip says about client code that does not run, if any: client
+ * code runs only after an administrator approved its rendering. Sandbox
+ * renderings are never approved; their owner (who can review them) tries
+ * their client code in the review.
+ */
+export function getClientCodeNotice(renderings, canReview = false) {
+    const waiting = renderings.some((rendering) => rendering.hasClientCode && !rendering.sandbox && !rendering.approved);
+    const sandboxed = renderings.some((rendering) => rendering.hasClientCode && rendering.sandbox);
+    const notice = [
+        waiting &&
+            "Client code runs only after an administrator approves the rendering; until then the component stays static.",
+        sandboxed &&
+            (canReview
+                ? "Sandbox renderings cannot be approved, so their client code runs only when you try it: Review, then Run client code."
+                : "Client code never runs in a sandbox, because sandbox renderings cannot be approved."),
+    ]
+        .filter(Boolean)
+        .join(" ");
+    return notice || undefined;
+}
+/** Badge colors per status (Badge has no green or orange variant). */
+export const RENDERING_APPROVAL_BADGE_CLASSES = {
+    approved: "border-transparent bg-feedback-green-light text-feedback-green",
+    changed: "border-transparent bg-feedback-orange-light text-feedback-orange",
+    unapproved: "border-transparent bg-feedback-orange-light text-feedback-orange",
+    sandbox: "",
+};
+/** An account name without its domain: "sitecore\\jane" becomes "jane". */
+export function stripAccountDomain(account) {
+    const separator = account.lastIndexOf("\\");
+    return separator >= 0 ? account.slice(separator + 1) : account;
+}
+export function formatApprovalDate(value) {
+    if (!value)
+        return undefined;
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return undefined;
+    return date.toLocaleString(undefined, {
+        dateStyle: "medium",
+        timeStyle: "short",
+    });
+}
+/** The name a rendering is listed under. */
+export function getRenderingDisplayName(rendering) {
+    const name = rendering.name || rendering.path.split("/").pop() || "";
+    if (rendering.kind === "theme")
+        return name ? `Theme ${name}` : "Theme";
+    return name || rendering.id;
+}
+/**
+ * The renderings in the order the page shows them (as `renderingIds` lists
+ * them), then any the server added that the page does not list, the theme
+ * last.
+ */
+export function sortRenderingsForPage(renderings, renderingIds) {
+    const order = new Map(renderingIds.map((id, index) => [id, index]));
+    const rank = (rendering) => rendering.kind === "theme"
+        ? Number.MAX_SAFE_INTEGER
+        : (order.get(normalizeRenderingId(rendering.id) ?? "") ??
+            renderingIds.length);
+    return renderings
+        .map((rendering, index) => ({ rendering, index }))
+        .sort((a, b) => rank(a.rendering) - rank(b.rendering) || a.index - b.index)
+        .map(({ rendering }) => rendering);
+}
+/** The renderings a published page would leave out. */
+export function getUnapprovedRenderings(renderings) {
+    return renderings.filter((rendering) => !rendering.approved);
+}
+/**
+ * The approval state of a page's dynamic renderings (and its tenant's theme),
+ * requested again whenever the page or its renderings change, and on
+ * `refresh()`. A refresh keeps showing the previous answer until the new one
+ * is there.
+ */
+export function useRenderingPageState({ page, renderingIds, enabled, fetchPageState = fetchRenderingPageState, }) {
+    const [entry, setEntry] = useState();
+    const [revision, setRevision] = useState(0);
+    const pageId = page?.id;
+    const pageLanguage = page?.language;
+    const pageVersion = page?.version;
+    const idList = renderingIds.join(",");
+    const key = enabled && pageId && pageLanguage && typeof pageVersion === "number"
+        ? [pageId, pageLanguage, pageVersion, idList].join("|")
+        : undefined;
+    useEffect(() => {
+        if (!key || !pageId || !pageLanguage || typeof pageVersion !== "number") {
+            return;
+        }
+        const controller = new AbortController();
+        void fetchPageState({ id: pageId, language: pageLanguage, version: pageVersion }, idList ? idList.split(",") : [], controller.signal).then((result) => {
+            if (controller.signal.aborted)
+                return;
+            setEntry(result.ok
+                ? { key, state: result.data }
+                : { key, error: result.message });
+        });
+        return () => controller.abort();
+    }, [
+        fetchPageState,
+        idList,
+        key,
+        pageId,
+        pageLanguage,
+        pageVersion,
+        revision,
+    ]);
+    // A rendering on the canvas changed (its code or its approval): read again.
+    useEffect(() => {
+        if (!key)
+            return;
+        const onChanged = () => setRevision((value) => value + 1);
+        window.addEventListener(DYNAMIC_RENDERING_CHANGED_EVENT, onChanged);
+        return () => window.removeEventListener(DYNAMIC_RENDERING_CHANGED_EVENT, onChanged);
+    }, [key]);
+    const current = key && entry?.key === key ? entry : undefined;
+    return {
+        state: current?.state,
+        error: current?.error,
+        loading: !!key && !current,
+        refresh: () => setRevision((value) => value + 1),
+    };
+}
+// The dynamic renderings last read from each page's canvas, in edit and
+// preview mode alike, so the publish dialog can ask for their approval state.
+const recordedRenderingIds = new Map();
+const recordListeners = new Set();
+const NO_RECORDED_IDS = [];
+function getRecordKey(page) {
+    return `${page.id.replace(/[{}-]/g, "").toLowerCase()}|${page.language.toLowerCase()}`;
+}
+export function recordPageRenderingIds(page, renderingIds) {
+    const key = getRecordKey(page);
+    const previous = recordedRenderingIds.get(key) ?? NO_RECORDED_IDS;
+    if (sameRenderingIds(previous, renderingIds))
+        return;
+    if (renderingIds.length) {
+        recordedRenderingIds.set(key, [...renderingIds]);
+    }
+    else {
+        recordedRenderingIds.delete(key);
+    }
+    recordListeners.forEach((listener) => listener());
+}
+export function getRecordedPageRenderingIds(page) {
+    return page
+        ? (recordedRenderingIds.get(getRecordKey(page)) ?? NO_RECORDED_IDS)
+        : NO_RECORDED_IDS;
+}
+function subscribeRecordedRenderingIds(listener) {
+    recordListeners.add(listener);
+    return () => {
+        recordListeners.delete(listener);
+    };
+}
+/** The dynamic renderings last read from the page's canvas (see above). */
+export function useRecordedPageRenderingIds(page) {
+    const getSnapshot = () => getRecordedPageRenderingIds(page);
+    return useSyncExternalStore(subscribeRecordedRenderingIds, getSnapshot, getSnapshot);
+}
+//# sourceMappingURL=renderingApproval.js.map

package/dist/editor/page-viewer/renderingApproval.js.map

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

package/dist/editor/page-viewer/renderingChanges.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A saved dynamic rendering (an agent's update-rendering, or anyone editing
+ * the rendering item) changes what the canvas shows, although no page item
+ * changed: the server reports it as an "item-changed" for the rendering item.
+ * This module decides whether such a change concerns the open canvas.
+ */
+import { type PageVersion, type RenderingPageState, type RenderingsResult } from "../services/renderingsService";
+/** The Code and Client Code fields of a rendering item. */
+export declare const RENDERING_CODE_FIELD_ID = "fa417e5d-357f-4855-9870-b7e43d3f97d6";
+export declare const RENDERING_CLIENT_CODE_FIELD_ID = "e25b9910-aafc-46b8-b6d1-29e499190ea6";
+/** Dispatched on window with `{ renderingId }` when a rendering on the canvas changed. */
+export declare const DYNAMIC_RENDERING_CHANGED_EVENT = "parhelia:dynamic-rendering-changed";
+export type DynamicRenderingChangedDetail = {
+    renderingId: string;
+};
+/**
+ * Whether the saved item is a dynamic rendering the canvas shows. A component
+ * is answered from the canvas, which wraps each one in its rendering id, so
+ * no other saved item costs a request. A theme leaves no id in the page:
+ * when an item's code changed and the canvas does not show it, the page's
+ * rendering state (which lists the tenant's theme) decides.
+ */
+export declare function isRenderingOnCanvas({ itemId, fieldIds, iframe, page, fetchPageState, }: {
+    itemId: string | null | undefined;
+    fieldIds?: readonly string[] | null;
+    iframe: HTMLIFrameElement | null | undefined;
+    page?: PageVersion;
+    fetchPageState?: (page: PageVersion, renderingIds: string[]) => Promise<RenderingsResult<RenderingPageState>>;
+}): Promise<boolean>;