smoodly 0.0.61 → 0.0.63

package/dist/admin/editor/SamplePreview.js

@@ -0,0 +1,86 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The picture in the insert picker (spec 2026-11-14 add section previews): ONE frame on the zone's samples address
+// (the site's own draft page with the zone's rows drawn from their samples), not interactive, scaled to the pane and
+// cropped to the current row's node. The frame is same-origin, so its document is read directly: no bridge, nothing
+// posted. Until it has loaded, and for a row the site drew no node for, the pane shows `fallback`.
+import { useEffect, useLayoutEffect, useRef, useState } from "react";
+import { SAMPLE_VIEWPORT, isSmoodlyDraft, isolationCss, sampleBox, sampleNode } from "./sample-frame.js";
+export function SamplePreview({ src, nodeId, fallback }) {
+    const pane = useRef(null);
+    const frame = useRef(null);
+    const [width, setWidth] = useState(0);
+    // Counts the frame's loads: a document Smoodly rendered as a draft, with its layout hidden. 0 = none yet.
+    const [loaded, setLoaded] = useState(0);
+    const [crop, setCrop] = useState(null);
+    // The pane's width decides the scale.
+    useLayoutEffect(() => {
+        const el = pane.current;
+        if (!el)
+            return;
+        // The content box: the pane's padding leaves the crop's shadow room (2026-11-14).
+        const measure = () => { const cs = getComputedStyle(el); setWidth(el.clientWidth - parseFloat(cs.paddingLeft) - parseFloat(cs.paddingRight)); };
+        measure();
+        const observer = new ResizeObserver(measure);
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, []);
+    const onLoad = () => {
+        const doc = frame.current?.contentDocument;
+        if (!doc || !isSmoodlyDraft(doc)) {
+            setLoaded(0);
+            return;
+        }
+        // The layout around the samples goes, and the scrollbar with it (the frame is still scrolled from here). As a
+        // constructed stylesheet of the frame's own realm: no element of the site's document is written to.
+        const Sheet = frame.current?.contentWindow?.CSSStyleSheet;
+        if (Sheet) {
+            const sheet = new Sheet();
+            // `nextjs-portal`: Next's dev indicator, which sits fixed in a corner of the picture in development.
+            sheet.replaceSync(`html{overflow:hidden!important}nextjs-portal{display:none!important}${isolationCss(doc)}`);
+            doc.adoptedStyleSheets = [...doc.adoptedStyleSheets, sheet];
+        }
+        setLoaded((n) => n + 1);
+    };
+    // A frame that finished loading before React attached the handler (a cached document).
+    useEffect(() => {
+        if (frame.current?.contentDocument?.readyState === "complete" && frame.current.contentWindow?.location.href !== "about:blank")
+            onLoad();
+    }, []);
+    // The current row's node: scroll the frame to it and crop to it, again whenever it or the page around it resizes
+    // (images and fonts arrive late).
+    useEffect(() => {
+        const win = frame.current?.contentWindow;
+        const doc = frame.current?.contentDocument;
+        if (!loaded || !nodeId || !win || !doc) {
+            setCrop(null);
+            return;
+        }
+        const node = sampleNode(doc, nodeId);
+        if (!node) {
+            setCrop(null);
+            return;
+        }
+        const measure = () => {
+            const box = sampleBox(node, win.scrollY);
+            win.scrollTo({ top: box.top, behavior: "instant" });
+            // A document too short to scroll that far leaves the node lower in the viewport.
+            const offset = Math.max(0, Math.round(node.getBoundingClientRect().top));
+            const height = Math.min(box.height, SAMPLE_VIEWPORT.height - offset);
+            setCrop((was) => (was && was.offset === offset && was.height === height ? was : height > 0 ? { offset, height } : null));
+        };
+        measure();
+        const Observer = win.ResizeObserver ?? ResizeObserver;
+        const observer = new Observer(measure);
+        observer.observe(node);
+        if (doc.body)
+            observer.observe(doc.body);
+        return () => observer.disconnect();
+    }, [loaded, nodeId]);
+    const scale = width > 0 ? width / SAMPLE_VIEWPORT.width : 0;
+    const shown = crop !== null && scale > 0;
+    return (_jsxs("div", { ref: pane, className: "sm-insert__preview", children: [_jsx("div", { className: shown ? "sm-insert__crop sm-insert__crop--shown" : "sm-insert__crop", style: { height: shown ? Math.round(crop.height * scale) : 0, visibility: shown ? "visible" : "hidden" }, children: _jsx("iframe", { ref: frame, src: src, title: "Section preview", "aria-hidden": "true", tabIndex: -1, width: SAMPLE_VIEWPORT.width, height: SAMPLE_VIEWPORT.height, onLoad: onLoad, style: {
+                        pointerEvents: "none", border: 0, display: "block", position: "absolute", left: 0, top: shown ? -Math.round(crop.offset * scale) : 0,
+                        width: SAMPLE_VIEWPORT.width, height: SAMPLE_VIEWPORT.height, transform: `scale(${scale})`, transformOrigin: "0 0",
+                    } }) }), !shown && _jsx("div", { className: "sm-insert__fallback", "data-testid": "sample-fallback", children: fallback })] }));
+}

package/dist/admin/editor/SectionIcon.d.ts

@@ -0,0 +1,4 @@
+export declare function SectionIcon({ icon, size }: {
+    icon?: string | undefined;
+    size?: number;
+}): import("react").JSX.Element;

package/dist/admin/editor/SectionIcon.js

@@ -0,0 +1,8 @@
+"use client";
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+// A section's icon (2026-11-14): the schema's own `icon` when it sets one, else Lucide's rectangle-horizontal — the
+// one default for every section (and the Custom section) in the picker and on the Structure cards.
+import { RectangleHorizontal } from "lucide-react";
+export function SectionIcon({ icon, size = 14 }) {
+    return icon ? _jsx(_Fragment, { children: icon }) : _jsx(RectangleHorizontal, { size: size, strokeWidth: 1.75, "aria-hidden": "true" });
+}

package/dist/admin/editor/StructureView.d.ts

@@ -3,9 +3,9 @@ import { type ActionMenuItem } from "../ui/ActionMenu.tsx";
 import type { CardPreview } from "./card-preview.ts";
 import { cardMenu, type Handlers, type ZoneRows } from "./Outline.tsx";
 export { cardMenu };
-/** A card: the outline's row plus the section's icon from the registry (`icon ?? "▤"`), its preview, and whether it is a placed global item. */
+/** A card: the outline's row plus the section's icon from the registry (none = SectionIcon's default), its preview, and whether it is a placed global item. */
 export type StructureNode = ZoneRows["nodes"][number] & {
-    icon: string;
+    icon?: string;
     preview: CardPreview;
     global: boolean;
 };

package/dist/admin/editor/StructureView.js

@@ -17,6 +17,7 @@ import { Button, Grip, SectionLabel, cx } from "../ui/primitives.js";
 import { useSortable } from "../ui/useSortable.js";
 import { AssetThumb } from "../forms/MediaGrid.js";
 import { useAssets } from "../forms/assets-context.js";
+import { SectionIcon } from "./SectionIcon.js";
 import { cardMenu } from "./Outline.js";
 export { cardMenu };
 export function StructureView({ zones, ...rest }) {
@@ -39,7 +40,7 @@ function StructureZoneView({ zone, locked, canTake, nodes, removed, note, select
     return (_jsxs("div", { className: "sm-structure__group", children: [_jsxs("div", { className: "sm-structure__zone", children: [_jsxs(SectionLabel, { caps: true, children: [zone, locked && " · locked"] }), actions.length > 0 && _jsx(ActionMenu, { small: true, label: "Zone actions", items: actions })] }), note && _jsx("p", { className: "sm-outline-note", children: note }), nodes.length === 0 && (_jsxs("div", { className: "sm-structure__empty", children: [_jsx("span", { children: "Empty" }), canTake && add(0)] })), nodes.length > 0 && (_jsx("div", { ref: sortable.containerRef, className: "sm-structure__rows", children: nodes.map(({ node, label, mark, icon, preview, global }, i) => (_jsx("div", { className: cx("sm-structure__row", sortable.rowClass(i)), style: sortable.rowStyle(i), children: _jsxs("div", { role: "button", tabIndex: 0, "data-testid": "structure-card", "data-node": node.id, className: cx("sm-structure__card", node.id === selectedId && "sm-structure__card--selected", locked && "sm-structure__card--locked", mark && `sm-structure__card--${mark}`), onClick: () => onSelect(node.id), onKeyDown: (e) => { if (e.key === "Enter" || e.key === " ") {
                             e.preventDefault();
                             onSelect(node.id);
-                        } }, children: [locked ? _jsx("span", { className: "sm-structure__gripslot", "aria-hidden": "true" }) : _jsx(Grip, { ...sortable.handleProps(i) }), _jsx("span", { className: "sm-structure__icon", "aria-hidden": "true", children: icon }), _jsxs("span", { className: "sm-structure__text", children: [_jsxs("span", { className: "sm-structure__title", children: [label, global && _jsx("span", { className: "sm-structure__badge", children: "global" })] }), global
+                        } }, children: [locked ? _jsx("span", { className: "sm-structure__gripslot", "aria-hidden": "true" }) : _jsx(Grip, { ...sortable.handleProps(i) }), _jsx("span", { className: "sm-structure__icon", "aria-hidden": "true", children: _jsx(SectionIcon, { icon: icon }) }), _jsxs("span", { className: "sm-structure__text", children: [_jsxs("span", { className: "sm-structure__title", children: [label, global && _jsx("span", { className: "sm-structure__badge", children: "global" })] }), global
                                         ? _jsx("span", { className: "sm-structure__preview", children: "Global \u00B7 edited in one place" })
                                         : preview.text !== null && _jsx("span", { className: "sm-structure__preview", children: preview.text })] }), !global && preview.image && _jsx(Thumb, { image: preview.image }), _jsx("span", { className: "sm-structure__menu", onClick: stop, onKeyDown: stopActivation, children: _jsx(ActionMenu, { small: true, label: "Section actions", items: cardMenu({ locked, onRemove: () => onRemove(node.id), actions: cardActions?.(node, zone, i) ?? [] }) }) })] }) }, node.id))) })), nodes.length > 0 && canTake && add(nodes.length)] }));
 }

package/dist/admin/editor/canvas-address.d.ts

@@ -5,6 +5,8 @@ export declare function setCanvasMarks(value: "path" | "query"): void;
 export declare const canvasAddress: (siteUrl: string) => string;
 /** History's frame (spec 2026-09-13 history §5): a stored version, no bridge. */
 export declare const versionAddress: (siteUrl: string, versionId: string) => string;
+/** The picker's samples frame (spec 2026-11-14 add section previews): the zone's rows drawn from their samples, no bridge. */
+export declare const samplesAddress: (siteUrl: string, zone: string) => string;
 /** The site's preview route, from the page data: where the grant goes. */
 export declare function setPreviewUrl(value: string): void;
 export declare function previewUrl(): string;

package/dist/admin/editor/canvas-address.js

@@ -3,7 +3,7 @@
 // they mark what they want: in the query, or in the path's last segment where the host strips the query
 // (Next on Vercel; canvas-marker.ts). Module state, set by the browser entry before the shell mounts: the
 // admin is one script on one page.
-import { markCanvasPath } from "../../canvas-marker.js";
+import { markCanvasPath, SAMPLES_PARAM } from "../../canvas-marker.js";
 let base = "";
 let marks = "query";
 export function setPreviewBase(value) {
@@ -18,6 +18,8 @@ const withQuery = (url, key, value) => `${url}${url.includes("?") ? "&" : "?"}${
 export const canvasAddress = (siteUrl) => marks === "path" ? markCanvasPath(draftAddress(siteUrl), { editor: true }) : withQuery(draftAddress(siteUrl), "smoodly-editor", "1");
 /** History's frame (spec 2026-09-13 history §5): a stored version, no bridge. */
 export const versionAddress = (siteUrl, versionId) => marks === "path" ? markCanvasPath(draftAddress(siteUrl), { version: versionId }) : withQuery(draftAddress(siteUrl), "smoodly-version", versionId);
+/** The picker's samples frame (spec 2026-11-14 add section previews): the zone's rows drawn from their samples, no bridge. */
+export const samplesAddress = (siteUrl, zone) => marks === "path" ? markCanvasPath(draftAddress(siteUrl), { samples: zone }) : withQuery(draftAddress(siteUrl), SAMPLES_PARAM, zone);
 let url = "";
 /** The site's preview route, from the page data: where the grant goes. */
 export function setPreviewUrl(value) { url = value; }

package/dist/admin/editor/picker-rows.d.ts

@@ -0,0 +1,33 @@
+import type { ZonePolicy } from "../../zones.ts";
+import type { AdminGlobal, AdminRegistry, AdminSection } from "../serialize.ts";
+import type { PasteCheck } from "./section-clipboard.ts";
+export type PickerPaste = {
+    title: string;
+    check: PasteCheck;
+    onPaste(): void;
+};
+export type PickerRow = {
+    key: string;
+    kind: "paste" | "section" | "custom" | "global";
+    title: string;
+    description?: string;
+    /** The schema's own icon; none = the default (SectionIcon). */
+    icon?: string;
+    /** The row's node in the samples frame; null for Paste, whose content is not a sample. */
+    nodeId: string | null;
+    /** A refused paste: shown, never picked. */
+    disabled?: boolean;
+    section?: AdminSection;
+    item?: AdminGlobal;
+};
+export declare function pickerRows({ policy, registry, globalIds, paste }: {
+    policy: ZonePolicy | undefined;
+    registry: AdminRegistry;
+    globalIds: Record<string, string>;
+    paste?: PickerPaste;
+}): PickerRow[];
+/** The row the modal opens on: the first that can be picked and is not Paste (its preview is a card, not a picture);
+ *  Paste when it is all there is; -1 when nothing can be picked. */
+export declare function firstRow(rows: PickerRow[]): number;
+/** The next row an arrow key lands on: the nearest one in `dir` that can be picked; the current one at an end. */
+export declare function stepRow(rows: PickerRow[], current: number, dir: -1 | 1): number;

package/dist/admin/editor/picker-rows.js

@@ -0,0 +1,38 @@
+import { sampleNodeId } from "../../sample-tree.js";
+import { allowedGlobals, allowedSections } from "../tree-ops.js";
+import { allowsCustom } from "../custom-section.js";
+export function pickerRows({ policy, registry, globalIds, paste }) {
+    const rows = [];
+    if (paste) {
+        rows.push({
+            key: "paste", kind: "paste", title: `Paste "${paste.title}"`, icon: "⎘", nodeId: null,
+            description: paste.check.ok ? "From the clipboard" : paste.check.reason, ...(paste.check.ok ? {} : { disabled: true }),
+        });
+    }
+    for (const section of allowedSections(policy, registry.sections)) {
+        rows.push({
+            key: `section-${section.name}`, kind: "section", title: section.title, ...(section.icon ? { icon: section.icon } : {}), section,
+            nodeId: sampleNodeId("section", section.name),
+        });
+    }
+    if (allowsCustom(policy)) {
+        rows.push({ key: "custom", kind: "custom", title: registry.custom.title, nodeId: sampleNodeId("custom") });
+    }
+    for (const item of allowedGlobals(policy, registry.globals, globalIds)) {
+        rows.push({ key: `global-${item.name}`, kind: "global", title: item.title, icon: "⛓", item, nodeId: sampleNodeId("global", item.name) });
+    }
+    return rows;
+}
+/** The row the modal opens on: the first that can be picked and is not Paste (its preview is a card, not a picture);
+ *  Paste when it is all there is; -1 when nothing can be picked. */
+export function firstRow(rows) {
+    const insertable = rows.findIndex((r) => !r.disabled && r.kind !== "paste");
+    return insertable !== -1 ? insertable : rows.findIndex((r) => !r.disabled);
+}
+/** The next row an arrow key lands on: the nearest one in `dir` that can be picked; the current one at an end. */
+export function stepRow(rows, current, dir) {
+    for (let i = current + dir; i >= 0 && i < rows.length; i += dir)
+        if (!rows[i].disabled)
+            return i;
+    return current;
+}

package/dist/admin/editor/sample-frame.d.ts

@@ -0,0 +1,36 @@
+/** The frame's fixed viewport: a desktop width, and a height a section sized in viewport units cannot outgrow. */
+export declare const SAMPLE_VIEWPORT: {
+    readonly width: 1280;
+    readonly height: 800;
+};
+export type FrameElement = {
+    tagName: string;
+    parentElement: FrameElement | null;
+    children: ArrayLike<FrameElement>;
+    getAttribute(name: string): string | null;
+    getBoundingClientRect(): {
+        top: number;
+        height: number;
+    };
+};
+export type FrameDocument = {
+    body: FrameElement | null;
+    querySelectorAll(selector: string): ArrayLike<FrameElement>;
+};
+/** Smoodly rendered this document as a draft: the marker its renderers write is there. */
+export declare function isSmoodlyDraft(doc: FrameDocument): boolean;
+/** The rules that hide the site's layout around the samples: at every level from the body down to the samples'
+ *  common parent, everything beside the path (never a style, link or script). What shares the common parent with the
+ *  samples stays, since that parent is the zone's own container; the body is never one, so there everything else
+ *  goes. By position, as a stylesheet, and no element is touched: an attribute or an inline style written before
+ *  the site's own script takes the page over is a hydration mismatch (Next's dev overlay reports it), and a rule
+ *  also hides what the site adds to the body later. Empty when the document holds no sample. */
+export declare function isolationCss(doc: FrameDocument): string;
+/** A row's node in the frame; null when the site drew none, or drew the crash placeholder in its place. */
+export declare function sampleNode(doc: FrameDocument, id: string): FrameElement | null;
+/** Where the crop sits: the node's top in the document (its viewport top plus the frame's scroll) and its height,
+ *  capped at the viewport's (a taller section shows its first screen). Whole pixels. */
+export declare function sampleBox(node: FrameElement, scrollY: number): {
+    top: number;
+    height: number;
+};

package/dist/admin/editor/sample-frame.js

@@ -0,0 +1,58 @@
+// The picker's samples frame, read from outside (spec 2026-11-14 add section previews): the frame is the site's own
+// draft page with a zone's samples in place of its content, same-origin, so the admin reads its document directly.
+// It hides the site's layout around the samples (a sticky header would sit over every picture) and crops the frame
+// to one row's node. Pure over the few members of a document it uses, so the unit suite runs it without a DOM.
+import { CRASHED_ATTR, NODE_ATTR } from "../../marks.js";
+import { DRAFT_META_NAME } from "./canvas-diagnosis.js";
+/** The frame's fixed viewport: a desktop width, and a height a section sized in viewport units cannot outgrow. */
+export const SAMPLE_VIEWPORT = { width: 1280, height: 800 };
+const SAMPLE_PREFIX = "sample-";
+const nodesOf = (doc) => Array.from(doc.querySelectorAll(`[${NODE_ATTR}]`));
+const chainOf = (el) => { const out = []; for (let cur = el; cur; cur = cur.parentElement)
+    out.push(cur); return out; };
+/** Smoodly rendered this document as a draft: the marker its renderers write is there. */
+export function isSmoodlyDraft(doc) {
+    return doc.querySelectorAll(`meta[name="${DRAFT_META_NAME}"]`).length > 0;
+}
+/** The rules that hide the site's layout around the samples: at every level from the body down to the samples'
+ *  common parent, everything beside the path (never a style, link or script). What shares the common parent with the
+ *  samples stays, since that parent is the zone's own container; the body is never one, so there everything else
+ *  goes. By position, as a stylesheet, and no element is touched: an attribute or an inline style written before
+ *  the site's own script takes the page over is a hydration mismatch (Next's dev overlay reports it), and a rule
+ *  also hides what the site adds to the body later. Empty when the document holds no sample. */
+export function isolationCss(doc) {
+    const body = doc.body;
+    const samples = nodesOf(doc).filter((n) => n.getAttribute(NODE_ATTR).startsWith(SAMPLE_PREFIX));
+    if (!body || samples.length === 0)
+        return "";
+    // The sample nodes and everything above them: never hidden.
+    const kept = new Set(samples.flatMap(chainOf));
+    // The common parent: the deepest element above the first sample that is above them all.
+    const above = samples.map((n) => new Set(chainOf(n).slice(1)));
+    const common = chainOf(samples[0]).slice(1).find((el) => above.every((set) => set.has(el)));
+    if (!common || !chainOf(common).includes(body))
+        return "";
+    const indexIn = (parent, child) => Array.from(parent.children).indexOf(child) + 1;
+    const selectorOf = (el) => (el === body || !el.parentElement ? "html > body" : `${selectorOf(el.parentElement)} > :nth-child(${indexIn(el.parentElement, el)})`);
+    const rule = (parent) => {
+        const keep = Array.from(parent.children).map((child, i) => (kept.has(child) ? `:not(:nth-child(${i + 1}))` : "")).join("");
+        return `${selectorOf(parent)} > :not(style):not(link):not(script)${keep}{display:none!important}`;
+    };
+    const rules = [];
+    if (common === body)
+        rules.push(rule(body));
+    for (let cur = common; cur !== body && cur.parentElement; cur = cur.parentElement)
+        rules.push(rule(cur.parentElement));
+    return rules.join("");
+}
+/** A row's node in the frame; null when the site drew none, or drew the crash placeholder in its place. */
+export function sampleNode(doc, id) {
+    const node = nodesOf(doc).find((n) => n.getAttribute(NODE_ATTR) === id);
+    return node && node.getAttribute(CRASHED_ATTR) === null ? node : null;
+}
+/** Where the crop sits: the node's top in the document (its viewport top plus the frame's scroll) and its height,
+ *  capped at the viewport's (a taller section shows its first screen). Whole pixels. */
+export function sampleBox(node, scrollY) {
+    const rect = node.getBoundingClientRect();
+    return { top: Math.max(0, Math.round(rect.top + scrollY)), height: Math.max(0, Math.min(Math.round(rect.height), SAMPLE_VIEWPORT.height)) };
+}

package/dist/admin/editor/sample-picks.d.ts

@@ -0,0 +1,34 @@
+import type { AdminOps } from "../ops.ts";
+import type { AdminSection } from "../serialize.ts";
+import { type SamplePicks } from "../../sample-fill.ts";
+/** `images: false`: store no image placeholder. `retry`: the call failed for a reason that may pass (the network, a
+ *  session), so the next insert asks again; absent, the answer stands for the editor's life. */
+export type PicksAnswer = {
+    picks: SamplePicks;
+    images: boolean;
+    retry?: true;
+};
+/** One operation call for every collection a top-level reference field of these sections targets. It is made even
+ *  when there are none: the answer is how the admin learns that the service knows the placeholder. */
+export declare function loadPicks(ops: Pick<AdminOps, "entries">, sections: Pick<AdminSection, "fields">[], locale: string): Promise<PicksAnswer>;
+/** One answer per locale for a page editor's life. An answer that may be retried is handed out once and forgotten. */
+export declare function picksCache(): {
+    get(locale: string, load: () => Promise<PicksAnswer>): Promise<PicksAnswer>;
+    /** The answer already in hand, for a caller that cannot wait. */
+    known: (locale: string) => PicksAnswer | undefined;
+};
+/** Where the editor stood when an insert asked for the picks: the page, the locale, which load of the draft, and the
+ *  picker that was clicked (null for a gesture with no modal). */
+export type InsertAsk = {
+    page: string;
+    locale: string;
+    load: number;
+    picker: {
+        zone: string;
+        index: number;
+    } | null;
+};
+/** Whether an insert that waited for the picks may still land (final review 2026-11-14): the same page, locale and
+ *  load, and the picker it was clicked in still open at the same place. An editor who closed the modal, opened
+ *  another, switched page or locale, or left, gets nothing inserted behind their back. */
+export declare const insertStands: (asked: InsertAsk, now: InsertAsk) => boolean;

package/dist/admin/editor/sample-picks.js

@@ -0,0 +1,49 @@
+import { sampleCollections } from "../../sample-fill.js";
+/** One operation call for every collection a top-level reference field of these sections targets. It is made even
+ *  when there are none: the answer is how the admin learns that the service knows the placeholder. */
+export async function loadPicks(ops, sections, locale) {
+    try {
+        const r = await ops.entries.samplePicks(sampleCollections(sections), locale);
+        if (!r.ok)
+            return r.code === "not_found" ? { picks: {}, images: false } : { picks: {}, images: false, retry: true };
+        const picks = {};
+        if (r.data && typeof r.data === "object") {
+            for (const [collection, ids] of Object.entries(r.data)) {
+                if (Array.isArray(ids))
+                    picks[collection] = ids.filter((id) => typeof id === "string");
+            }
+        }
+        return { picks, images: true };
+    }
+    catch {
+        return { picks: {}, images: false, retry: true };
+    }
+}
+/** One answer per locale for a page editor's life. An answer that may be retried is handed out once and forgotten. */
+export function picksCache() {
+    const asked = new Map();
+    const answers = new Map();
+    return {
+        get(locale, load) {
+            let pending = asked.get(locale);
+            if (!pending) {
+                pending = load().then((answer) => {
+                    if (answer.retry)
+                        asked.delete(locale);
+                    else
+                        answers.set(locale, answer);
+                    return answer;
+                });
+                asked.set(locale, pending);
+            }
+            return pending;
+        },
+        /** The answer already in hand, for a caller that cannot wait. */
+        known: (locale) => answers.get(locale),
+    };
+}
+/** Whether an insert that waited for the picks may still land (final review 2026-11-14): the same page, locale and
+ *  load, and the picker it was clicked in still open at the same place. An editor who closed the modal, opened
+ *  another, switched page or locale, or left, gets nothing inserted behind their back. */
+export const insertStands = (asked, now) => asked.page === now.page && asked.locale === now.locale && asked.load === now.load &&
+    (asked.picker === null || (now.picker !== null && now.picker.zone === asked.picker.zone && now.picker.index === asked.picker.index));

package/dist/admin/editor/view-memory.d.ts

@@ -6,4 +6,9 @@ type Storage = {
 };
 export declare function rememberedView(storage?: Storage): EditorViewMode;
 export declare function rememberView(view: EditorViewMode, storage?: Storage): void;
+/** The insert picker's "Insert filled" switch (spec 2026-11-14 filled samples): one setting for the whole browser,
+ *  not per page or zone. On unless the stored value is exactly "0"; a storage that throws leaves it on. */
+export declare const FILLED_KEY = "smoodly-insert-filled";
+export declare function rememberedFilled(storage?: Storage): boolean;
+export declare function rememberFilled(filled: boolean, storage?: Storage): void;
 export {};

package/dist/admin/editor/view-memory.js

@@ -15,3 +15,22 @@ export function rememberView(view, storage) {
         // not remembered — the view still switches
     }
 }
+/** The insert picker's "Insert filled" switch (spec 2026-11-14 filled samples): one setting for the whole browser,
+ *  not per page or zone. On unless the stored value is exactly "0"; a storage that throws leaves it on. */
+export const FILLED_KEY = "smoodly-insert-filled";
+export function rememberedFilled(storage) {
+    try {
+        return (storage ?? window.localStorage).getItem(FILLED_KEY) !== "0";
+    }
+    catch {
+        return true;
+    }
+}
+export function rememberFilled(filled, storage) {
+    try {
+        (storage ?? window.localStorage).setItem(FILLED_KEY, filled ? "1" : "0");
+    }
+    catch {
+        // not remembered — the switch still turns
+    }
+}