@elytracms/studio 0.0.1

package/dist/components/cms/new-page-dialog.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { STUDIO_PROJECT_ROUTE, studioPath, useNavigate } from '@elytracms/studio/router';
+import { useState } from 'react';
+import { Button, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, Field, Input, Stack, } from '@elytracms/studio/ui';
+import { useCms } from './cms-store';
+/**
+ * Create a page in ONE action (EC-192). Pages are documents in the `page`
+ * collection (EC-187): this dialog mints the page document (stable slug id,
+ * `cms.createPage`) and opens the new page's editor.
+ *
+ * EC-207 ("routes as code"): creating a page no longer persists an addressing
+ * route to the backend — routes are authored in `elytra.config.ts` and read
+ * from the resolved config, never written to or read from the DB. The page's
+ * URL is bound by a route in the consuming repo's `cms/routes.ts`, so this
+ * dialog only creates the page document.
+ */
+export function NewPageDialog({ projectId, open, onOpenChange, }) {
+    const cms = useCms();
+    const navigate = useNavigate();
+    const [name, setName] = useState('');
+    function reset() {
+        setName('');
+    }
+    function handleOpenChange(next) {
+        if (!next)
+            reset();
+        onOpenChange(next);
+    }
+    function submit(event) {
+        event.preventDefault();
+        if (name.trim() === '')
+            return;
+        const ref = cms.createPage({ name: name.trim() });
+        handleOpenChange(false);
+        void navigate({
+            to: STUDIO_PROJECT_ROUTE,
+            params: { projectId, _splat: studioPath.cmsDocument('page', ref.id) },
+        });
+    }
+    return (_jsx(Dialog, { open: open, onOpenChange: handleOpenChange, children: _jsxs(DialogContent, { children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: "New page" }), _jsx(DialogDescription, { children: "Give the page a name. You can design it next; its address is set in elytra.config.ts." })] }), _jsxs("form", { onSubmit: submit, children: [_jsx(Stack, { gap: "3", children: _jsx(Field, { label: "Name", htmlFor: "new-page-name", required: true, children: _jsx(Input, { id: "new-page-name", value: name, onChange: (event) => setName(event.target.value), placeholder: "About us", autoFocus: true, required: true }) }) }), _jsxs(DialogFooter, { className: "mt-4", children: [_jsx(Button, { type: "button", variant: "ghost", size: "sm", onClick: () => handleOpenChange(false), children: "Cancel" }), _jsx(Button, { type: "submit", size: "sm", disabled: name.trim() === '', "data-testid": "create-page", children: "Create page" })] })] })] }) }));
+}
+//# sourceMappingURL=new-page-dialog.js.map

package/dist/components/cms/new-page-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"new-page-dialog.js","sourceRoot":"","sources":["../../../src/components/cms/new-page-dialog.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACxF,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEhC,OAAO,EACL,MAAM,EACN,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,KAAK,EACL,KAAK,EACL,KAAK,GACN,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,SAAS,EACT,IAAI,EACJ,YAAY,GAWb;IACC,MAAM,GAAG,GAAG,MAAM,EAAE,CAAA;IACpB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAC9B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAA;IAEpC,SAAS,KAAK;QACZ,OAAO,CAAC,EAAE,CAAC,CAAA;IACb,CAAC;IAED,SAAS,gBAAgB,CAAC,IAAa;QACrC,IAAI,CAAC,IAAI;YAAE,KAAK,EAAE,CAAA;QAClB,YAAY,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IAED,SAAS,MAAM,CAAC,KAAgB;QAC9B,KAAK,CAAC,cAAc,EAAE,CAAA;QACtB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAM;QAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACjD,gBAAgB,CAAC,KAAK,CAAC,CAAA;QACvB,KAAK,QAAQ,CAAC;YACZ,EAAE,EAAE,oBAAoB;YACxB,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE;SACtE,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,CACL,KAAC,MAAM,IAAC,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,gBAAgB,YAChD,MAAC,aAAa,eACZ,MAAC,YAAY,eACX,KAAC,WAAW,2BAAuB,EACnC,KAAC,iBAAiB,wGAEE,IACP,EACf,gBAAM,QAAQ,EAAE,MAAM,aACpB,KAAC,KAAK,IAAC,GAAG,EAAC,GAAG,YACZ,KAAC,KAAK,IAAC,KAAK,EAAC,MAAM,EAAC,OAAO,EAAC,eAAe,EAAC,QAAQ,kBAClD,KAAC,KAAK,IACJ,EAAE,EAAC,eAAe,EAClB,KAAK,EAAE,IAAI,EACX,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAChD,WAAW,EAAC,UAAU,EACtB,SAAS,QACT,QAAQ,SACR,GACI,GACF,EACR,MAAC,YAAY,IAAC,SAAS,EAAC,MAAM,aAC5B,KAAC,MAAM,IAAC,IAAI,EAAC,QAAQ,EAAC,OAAO,EAAC,OAAO,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,uBAE7E,EACT,KAAC,MAAM,IACL,IAAI,EAAC,QAAQ,EACb,IAAI,EAAC,IAAI,EACT,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,iBAChB,aAAa,4BAGlB,IACI,IACV,IACO,GACT,CACV,CAAA;AACH,CAAC"}

package/dist/components/cms/reference-confirm.d.ts

@@ -0,0 +1,25 @@
+import type { DocumentRef } from '@elytracms/cms-core';
+import type { ReferenceAction, ReferenceEntryView } from '@elytracms/studio/lib/references';
+export declare function ReferenceConfirmDialog({ projectId, action, targets, open, busy, onOpenChange, onConfirm, }: {
+    projectId: string;
+    action: ReferenceAction;
+    /** The documents being acted on (a stable snapshot taken when opening). */
+    targets: readonly DocumentRef[];
+    open: boolean;
+    busy?: boolean;
+    onOpenChange: (open: boolean) => void;
+    onConfirm: () => void;
+}): import("react").JSX.Element;
+/**
+ * The shared EC-173 impact rows: one deep-linked row per broken inbound
+ * reference, strict-blocking ones flagged. Rendered by the document
+ * confirmation dialog (above) and the asset-delete dialog (EC-202) alike — both
+ * reduce to "these places reference the thing you're removing", so both lean on
+ * the same row + deep-link rendering (which already handles asset link kinds).
+ */
+export declare function ReferenceImpactRows({ projectId, broken, blocking, onNavigate, }: {
+    projectId: string;
+    broken: readonly ReferenceEntryView[];
+    blocking?: readonly ReferenceEntryView[];
+    onNavigate: () => void;
+}): import("react").JSX.Element;

package/dist/components/cms/reference-confirm.js

@@ -0,0 +1,124 @@
+import { jsxs as _jsxs, Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router';
+import { AlertTriangle, ShieldAlert } from 'lucide-react';
+import { useEffect, useMemo, useState } from 'react';
+import { documentKey } from '@elytracms/cms-core';
+import { buildReferenceImpact, loadInboundReferenceViews } from '@elytracms/studio/lib/references';
+import { Badge, Button, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, Row, Stack, Text, } from '@elytracms/studio/ui';
+import { useCms } from './cms-store';
+const ACTION_LABELS = {
+    unpublish: 'Unpublish',
+    delete: 'Delete',
+};
+export function ReferenceConfirmDialog({ projectId, action, targets, open, busy = false, onOpenChange, onConfirm, }) {
+    const cms = useCms();
+    const [status, setStatus] = useState('loading');
+    const [impact, setImpact] = useState(null);
+    // A stable identity for the acted-on set, so the effect re-runs exactly
+    // when the selection (not the array instance) changes.
+    const targetsKey = targets.map((ref) => documentKey(ref)).join('\n');
+    useEffect(() => {
+        if (!open || targets.length === 0)
+            return;
+        let cancelled = false;
+        setStatus('loading');
+        setImpact(null);
+        void (async () => {
+            try {
+                // Queued session mutations (and the persisted baseline) must land
+                // before the pre-flight query — the index is maintained on write.
+                await cms.ensurePersistedBaseline();
+                await cms.flushPersistence();
+                const views = await loadInboundReferenceViews(projectId, targets);
+                if (cancelled)
+                    return;
+                setImpact(buildReferenceImpact(cms.collections, action, views));
+                setStatus('ready');
+            }
+            catch {
+                // The index being unreachable must not trap the editor: degrade to a
+                // plain confirm with an explicit "could not check" warning.
+                if (!cancelled)
+                    setStatus('unavailable');
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+        // `targetsKey` stands in for `targets` (stable identity for the acted-on set).
+    }, [open, action, targetsKey, projectId]);
+    const actionLabel = ACTION_LABELS[action];
+    const subject = useMemo(() => {
+        if (targets.length === 1) {
+            const ref = targets[0];
+            return `“${cms.titleOf(ref)}”`;
+        }
+        return `${targets.length} documents`;
+    }, [targets, cms]);
+    const blocked = status === 'ready' && (impact?.totalBlocking ?? 0) > 0;
+    const totalBroken = impact?.totalBroken ?? 0;
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { "data-testid": "reference-confirm", className: "max-h-[80vh] overflow-y-auto", children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { children: [actionLabel, " ", subject, "?"] }), _jsx(DialogDescription, { "data-testid": "reference-confirm-summary", children: status === 'loading' ? ('Checking inbound references…') : status === 'unavailable' ? ('Inbound references could not be checked — the reference index is unreachable.') : blocked ? (_jsxs(_Fragment, { children: ["Blocked: ", impact.totalBlocking, ' ', impact.totalBlocking === 1 ? 'strict reference prevents' : 'strict references prevent', ' ', "this. Remove the references below first."] })) : totalBroken === 0 ? (_jsxs(_Fragment, { children: ["Not referenced anywhere.", action === 'delete'
+                                        ? ` This permanently deletes ${targets.length === 1 ? 'the document' : `the ${targets.length} selected documents`}.`
+                                        : ''] })) : (_jsxs(_Fragment, { children: ["You can ", action, " \u2014 ", impactSummary(targets.length, totalBroken), " will show a fallback until fixed. Each one becomes a visible validation issue."] })) })] }), status === 'ready' && impact !== null && totalBroken > 0 ? (_jsx(ImpactList, { projectId: projectId, impact: impact, onNavigate: () => onOpenChange(false) })) : null, status === 'unavailable' ? (_jsxs(Row, { gap: "2", "data-testid": "reference-confirm-unavailable", children: [_jsx(AlertTriangle, { className: "size-4 shrink-0 text-warning" }), _jsx(Text, { size: "xs", tone: "muted", children: "Proceeding is allowed, but affected places cannot be listed right now." })] })) : null, _jsxs(DialogFooter, { children: [_jsx(Button, { variant: "outline", "data-testid": "reference-confirm-cancel", onClick: () => onOpenChange(false), children: "Cancel" }), _jsx(Button, { variant: action === 'delete' ? 'destructive' : 'default', disabled: status === 'loading' || blocked || busy, "data-testid": "reference-confirm-proceed", onClick: onConfirm, children: totalBroken > 0 && !blocked ? `${actionLabel} anyway` : actionLabel })] })] }) }));
+}
+function impactSummary(targetCount, totalBroken) {
+    const places = `${totalBroken} ${totalBroken === 1 ? 'place' : 'places'}`;
+    // The bulk aggregate: "N documents, M inbound references will break."
+    return targetCount > 1 ? `${targetCount} documents are affected; ${places}` : places;
+}
+/**
+ * The enumerated impact: flat for a single target, grouped per target for
+ * bulk selections (per-item detail, EC-169 honesty rules).
+ */
+function ImpactList({ projectId, impact, onNavigate, }) {
+    const affected = impact.documents.filter((doc) => doc.broken.length > 0);
+    return (_jsx(Stack, { gap: "3", "data-testid": "reference-confirm-impact", children: affected.map((doc) => (_jsx(ImpactGroup, { projectId: projectId, doc: doc, grouped: impact.documents.length > 1, onNavigate: onNavigate }, documentKey(doc.ref)))) }));
+}
+function ImpactGroup({ projectId, doc, grouped, onNavigate, }) {
+    const cms = useCms();
+    const blockingKeys = new Set(doc.blocking.map((entry) => entry.key));
+    return (_jsxs(Stack, { gap: "2", "data-testid": `reference-confirm-doc-${doc.ref.id}`, children: [grouped ? (_jsxs(Row, { gap: "2", children: [_jsx(Text, { size: "xs", weight: "semibold", tone: "muted", className: "uppercase tracking-wide", children: cms.titleOf(doc.ref) }), _jsx(Badge, { variant: "outline", children: doc.broken.length })] })) : null, doc.broken.map((entry) => (_jsx(ImpactEntryRow, { projectId: projectId, entry: entry, blocking: blockingKeys.has(entry.key), onNavigate: onNavigate }, entry.key)))] }));
+}
+/**
+ * The shared EC-173 impact rows: one deep-linked row per broken inbound
+ * reference, strict-blocking ones flagged. Rendered by the document
+ * confirmation dialog (above) and the asset-delete dialog (EC-202) alike — both
+ * reduce to "these places reference the thing you're removing", so both lean on
+ * the same row + deep-link rendering (which already handles asset link kinds).
+ */
+export function ReferenceImpactRows({ projectId, broken, blocking = [], onNavigate, }) {
+    const blockingKeys = new Set(blocking.map((entry) => entry.key));
+    return (_jsx(Stack, { gap: "2", "data-testid": "reference-impact-rows", children: broken.map((entry) => (_jsx(ImpactEntryRow, { projectId: projectId, entry: entry, blocking: blockingKeys.has(entry.key), onNavigate: onNavigate }, entry.key))) }));
+}
+/**
+ * One affected place: the EC-172 labels with a working deep link to the exact
+ * field/node, the entry kind, draft/published visibility — and a strict
+ * marker when this entry is what blocks the action.
+ */
+function ImpactEntryRow({ projectId, entry, blocking, onNavigate, }) {
+    return (_jsxs(Row, { gap: "2", className: blocking
+            ? 'rounded-md border border-destructive/50 bg-destructive/5 px-2.5 py-2'
+            : 'rounded-md border border-border/70 bg-background/40 px-2.5 py-2', "data-testid": "reference-confirm-entry", children: [_jsxs(Stack, { gap: "1", className: "min-w-0 flex-1", children: [_jsx(ImpactDeepLink, { projectId: projectId, link: entry.sourceLink, label: entry.sourceLabel, primary: true, onNavigate: onNavigate }), _jsxs(Row, { gap: "1", className: "min-w-0", children: [_jsx(Text, { size: "xs", tone: "muted", className: "shrink-0", children: "at" }), _jsx(ImpactDeepLink, { projectId: projectId, link: entry.sourceLink, label: entry.locationLabel, onNavigate: onNavigate })] })] }), blocking ? (_jsxs(Badge, { variant: "error", "data-testid": "reference-confirm-strict", children: [_jsx(ShieldAlert, { className: "size-3" }), " strict"] })) : null, _jsx(Badge, { variant: "outline", className: "shrink-0", children: entry.kindLabel }), _jsxs(Row, { gap: "1", className: "shrink-0", children: [entry.draft ? _jsx(Badge, { variant: "warning", children: "draft" }) : null, entry.published ? _jsx(Badge, { variant: "success", children: "published" }) : null] })] }));
+}
+/** A deep link to the exact source location; closes the dialog on navigate. */
+function ImpactDeepLink({ projectId, link, label, primary = false, onNavigate, }) {
+    const className = primary
+        ? 'min-w-0 truncate text-sm font-medium text-foreground hover:text-primary hover:underline'
+        : 'min-w-0 truncate text-xs text-muted-foreground hover:text-primary hover:underline';
+    if (link === null) {
+        return primary ? (_jsx(Text, { size: "sm", weight: "medium", className: "min-w-0 truncate", children: label })) : (_jsx(Text, { size: "xs", tone: "muted", className: "min-w-0 truncate", children: label }));
+    }
+    switch (link.kind) {
+        case 'cms-field':
+            return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: studioPath.cmsDocument(link.collectionId, link.documentId) }, search: link.fieldPath !== undefined ? { field: link.fieldPath } : {}, className: className, "data-testid": "reference-confirm-link", onClick: onNavigate, children: label }));
+        case 'builder-node':
+            // The builder redirect (EC-187) only reads `?page=`; the page-graph-only
+            // `node` has no home in the document editor and is dropped.
+            return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: studioPath.builder() }, search: link.pageId !== undefined ? { page: link.pageId } : {}, className: className, "data-testid": "reference-confirm-link", onClick: onNavigate, children: label }));
+        case 'component':
+            return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: studioPath.component(link.componentId) }, className: className, "data-testid": "reference-confirm-link", onClick: onNavigate, children: label }));
+        case 'asset':
+            return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: studioPath.assets() }, search: { asset: link.assetId }, className: className, "data-testid": "reference-confirm-link", onClick: onNavigate, children: label }));
+    }
+}
+//# sourceMappingURL=reference-confirm.js.map

package/dist/components/cms/reference-confirm.js.map

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

package/dist/components/cms/relation-picker.d.ts

@@ -0,0 +1,16 @@
+import type { DocumentRef } from '@elytracms/cms-core';
+/** Pick related document(s) from a target collection (brief §8.4, EC-074). */
+export declare function RelationPicker({ targetCollection, cardinality, value, open, onOpenChange, onChange, excludeIds, }: {
+    targetCollection: string;
+    cardinality: 'one' | 'many';
+    value: DocumentRef[];
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onChange: (refs: DocumentRef[]) => void;
+    /**
+     * Document ids to omit from the candidate list (EC-218): a `parent` self-relation
+     * passes the editing document plus its descendants, so a page can never be set
+     * as its own ancestor (which would form a cycle).
+     */
+    excludeIds?: ReadonlySet<string>;
+}): import("react").JSX.Element;

package/dist/components/cms/relation-picker.js

@@ -0,0 +1,47 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Check, Search } from 'lucide-react';
+import { useEffect, useState } from 'react';
+import { Badge, Button, Code, Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, Input, Row, Spacer, Text, } from '@elytracms/studio/ui';
+import { cn } from '@elytracms/studio/lib/utils';
+import { useCms } from './cms-store';
+/** Pick related document(s) from a target collection (brief §8.4, EC-074). */
+export function RelationPicker({ targetCollection, cardinality, value, open, onOpenChange, onChange, excludeIds, }) {
+    const cms = useCms();
+    const [query, setQuery] = useState('');
+    const [selected, setSelected] = useState(value);
+    // Seed selection only on open transitions — `value` is a fresh array each
+    // parent render, so depending on it would reset in-progress multi-selection.
+    useEffect(() => {
+        if (open) {
+            setSelected(value);
+            setQuery('');
+        }
+    }, [open]);
+    const candidates = cms.documentsOf(targetCollection).filter((d) => {
+        if (excludeIds?.has(d.id))
+            return false;
+        if (!query.trim())
+            return true;
+        return cms.titleOf({ collection: targetCollection, id: d.id }).toLowerCase().includes(query.toLowerCase());
+    });
+    const isSelected = (id) => selected.some((r) => r.id === id);
+    function toggle(id) {
+        const ref = { collection: targetCollection, id };
+        if (cardinality === 'one') {
+            setSelected([ref]);
+            onChange([ref]);
+            onOpenChange(false);
+            return;
+        }
+        setSelected((prev) => (isSelected(id) ? prev.filter((r) => r.id !== id) : [...prev, ref]));
+    }
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: "max-w-md", children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { children: ["Pick ", cardinality === 'many' ? 'related' : 'a related', " document"] }), _jsxs(DialogDescription, { children: ["From ", _jsx(Code, { tone: "muted", children: targetCollection }), cardinality === 'many' ? ' · select multiple' : ''] })] }), _jsxs("div", { className: "relative", children: [_jsx(Search, { className: "pointer-events-none absolute left-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground" }), _jsx(Input, { autoFocus: true, value: query, onChange: (e) => setQuery(e.target.value), placeholder: "Search\u2026", className: "pl-8" })] }), _jsx("div", { className: "max-h-72 overflow-auto", children: candidates.length === 0 ? (_jsxs(Text, { size: "sm", tone: "muted", className: "p-3", children: ["No documents in ", targetCollection, "."] })) : (candidates.map((doc) => {
+                        const title = cms.titleOf({ collection: targetCollection, id: doc.id });
+                        const sel = isSelected(doc.id);
+                        return (_jsxs("button", { type: "button", onClick: () => toggle(doc.id), className: cn('flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-left text-sm transition-colors hover:bg-muted', sel && 'bg-accent text-accent-foreground'), children: [_jsx("span", { className: "min-w-0 flex-1 truncate font-medium", children: title }), _jsx(Code, { tone: "muted", children: doc.id }), sel ? _jsx(Check, { className: "size-4 text-primary" }) : null] }, doc.id));
+                    })) }), cardinality === 'many' ? (_jsx(DialogFooter, { children: _jsxs(Row, { gap: "2", className: "w-full", children: [_jsxs(Badge, { variant: "outline", children: [selected.length, " selected"] }), _jsx(Spacer, {}), _jsx(Button, { variant: "ghost", onClick: () => onOpenChange(false), children: "Cancel" }), _jsx(Button, { onClick: () => {
+                                    onChange(selected);
+                                    onOpenChange(false);
+                                }, children: "Apply" })] }) })) : null] }) }));
+}
+//# sourceMappingURL=relation-picker.js.map

package/dist/components/cms/relation-picker.js.map

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

package/dist/components/cms/use-cell-edit.d.ts

@@ -0,0 +1,33 @@
+import type { RefObject } from 'react';
+import type { CmsDocument, CollectionDef } from '@elytracms/cms-core';
+import type { AdvanceDirection, CellCoord } from './cell-edit';
+/**
+ * Table-level cell-edit controller (EC-168). Owns the state machine the cells
+ * render from:
+ *
+ *   idle → editing (click/Enter) → committing (Enter/Tab/blur) → idle
+ *        ↘ cancelled (Esc, no operation)        ↘ rejected (rollback + cell error)
+ *
+ * Exactly one cell edits at a time; commits go through
+ * `cms.commitFieldEdit` (one operations command each); rejections park a
+ * per-cell error that the cell renders inline until the cell is edited again.
+ */
+export interface CellEditController {
+    /** Ref for the table container (focus restoration after commits/cancels). */
+    containerRef: RefObject<HTMLDivElement | null>;
+    /** Key of the cell currently editing, or null. */
+    activeKey: string | null;
+    /** Key of the cell with a commit in flight, or null. */
+    busyKey: string | null;
+    errorOf(key: string): string | null;
+    start(coord: CellCoord): void;
+    cancel(coord: CellCoord): void;
+    commit(coord: CellCoord, value: unknown, advance: AdvanceDirection | null): void;
+}
+export declare function useCellEdit({ collection, docs, editableFields, }: {
+    collection: CollectionDef;
+    /** Documents in rendered (sorted) row order. */
+    docs: readonly CmsDocument[];
+    /** Editable column field names in rendered order. */
+    editableFields: readonly string[];
+}): CellEditController;

package/dist/components/cms/use-cell-edit.js

@@ -0,0 +1,125 @@
+import { useCallback, useRef, useState } from 'react';
+import { resolveField } from '@elytracms/cms-core';
+import { cellErrorMessage, cellKey, nextEditableCell } from './cell-edit';
+import { useCms } from './cms-store';
+export function useCellEdit({ collection, docs, editableFields, }) {
+    const cms = useCms();
+    const [activeKey, setActiveKey] = useState(null);
+    const [busyKey, setBusyKey] = useState(null);
+    const [errors, setErrors] = useState({});
+    const containerRef = useRef(null);
+    // Snapshots for async commit completion (row order may re-sort mid-flight).
+    const activeRef = useRef(activeKey);
+    activeRef.current = activeKey;
+    const docsRef = useRef(docs);
+    docsRef.current = docs;
+    const fieldsRef = useRef(editableFields);
+    fieldsRef.current = editableFields;
+    const clearError = useCallback((key) => {
+        setErrors((prev) => {
+            if (!(key in prev))
+                return prev;
+            const next = { ...prev };
+            delete next[key];
+            return next;
+        });
+    }, []);
+    const focusCell = useCallback((key) => {
+        // After state settles: return focus to the cell so Enter re-edits and the
+        // keyboard flow continues where the user left off.
+        requestAnimationFrame(() => {
+            containerRef.current
+                ?.querySelector(`[data-cell-key="${CSS.escape(key)}"]`)
+                ?.focus();
+        });
+    }, []);
+    const start = useCallback((coord) => {
+        const key = cellKey(coord);
+        clearError(key);
+        setActiveKey(key);
+    }, [clearError]);
+    const cancel = useCallback((coord) => {
+        const key = cellKey(coord);
+        if (activeRef.current !== key)
+            return;
+        setActiveKey(null);
+        focusCell(key);
+    }, [focusCell]);
+    /** Close the editor and move on (commit settled or value unchanged). */
+    const settle = useCallback((coord, next) => {
+        const key = cellKey(coord);
+        // The user may have clicked into another cell while the commit ran —
+        // never clobber their new edit session.
+        if (activeRef.current !== key)
+            return;
+        if (next) {
+            clearError(cellKey(next));
+            setActiveKey(cellKey(next));
+        }
+        else {
+            setActiveKey(null);
+            focusCell(key);
+        }
+    }, [clearError, focusCell]);
+    const commit = useCallback((coord, value, advance) => {
+        const key = cellKey(coord);
+        const doc = docsRef.current.find((d) => d.id === coord.docId);
+        const field = collection.fields.find((f) => f.name === coord.field);
+        if (!doc || !field) {
+            settle(coord, null);
+            return;
+        }
+        // The advance target is computed against the row order at commit time —
+        // a re-sort caused by the edit must not teleport the cursor.
+        const next = advance
+            ? nextEditableCell(docsRef.current.map((d) => d.id), fieldsRef.current, coord, advance)
+            : null;
+        // Same value as displayed → close (and advance) without any operation.
+        // Notably: re-committing an unchanged fallback-shown value dispatches
+        // nothing — a localized variant is only created by an actual edit.
+        const locale = cms.activeLocale;
+        const original = resolveField(collection, doc, field.name, locale, cms.localeConfig).value;
+        if (sameCellValue(value, original)) {
+            settle(coord, next);
+            return;
+        }
+        setBusyKey(key);
+        void cms
+            .commitFieldEdit({ collection, doc, field, locale, value })
+            .then((outcome) => {
+            if (outcome.ok) {
+                clearError(key);
+                settle(coord, next);
+                return;
+            }
+            // Rejected: the session already rolled back — park the error on the
+            // cell (never a toast) and return focus there.
+            setErrors((prev) => ({ ...prev, [key]: cellErrorMessage(outcome.error) }));
+            settle(coord, null);
+        })
+            .finally(() => {
+            setBusyKey((prev) => (prev === key ? null : prev));
+        });
+    }, [cms, collection, clearError, settle]);
+    return {
+        containerRef,
+        activeKey,
+        busyKey,
+        errorOf: (key) => errors[key] ?? null,
+        start,
+        cancel,
+        commit,
+    };
+}
+/** Structural equality good enough for cell values (scalars, refs, id arrays). */
+function sameCellValue(a, b) {
+    if (a === undefined && b === undefined)
+        return true;
+    try {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=use-cell-edit.js.map

package/dist/components/cms/use-cell-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cell-edit.js","sourceRoot":"","sources":["../../../src/components/cms/use-cell-edit.ts"],"names":[],"mappings":"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"}

package/dist/components/cms/versions-model.d.ts

@@ -0,0 +1,15 @@
+import type { CmsDocument } from '@elytracms/cms-core';
+/**
+ * Does a recorded snapshot equal the working draft, by VALUE (EC-224)? Decides
+ * whether the Versions pane shows "unpublished changes".
+ *
+ * The compare MUST be canonical (key-order-insensitive): a recorded snapshot is
+ * round-tripped through `documentSchema` on save (which reorders object keys to
+ * the schema's declaration order), while the live draft is assembled by the
+ * editor's spread-mutations (keys in mutation order). A plain `JSON.stringify`
+ * equality is order-sensitive, so it would report a just-published, byte-equal
+ * document as still having changes — pinning the Publish affordance on forever.
+ */
+export declare function snapshotMatchesDraft(snapshot: CmsDocument, draft: CmsDocument): boolean;
+/** Format a version's stored timestamp; fall back to the raw value if unparseable. */
+export declare function formatVersionTimestamp(value: string): string;

package/dist/components/cms/versions-model.js

@@ -0,0 +1,23 @@
+import { stableStringify } from '@elytracms/content';
+/**
+ * Does a recorded snapshot equal the working draft, by VALUE (EC-224)? Decides
+ * whether the Versions pane shows "unpublished changes".
+ *
+ * The compare MUST be canonical (key-order-insensitive): a recorded snapshot is
+ * round-tripped through `documentSchema` on save (which reorders object keys to
+ * the schema's declaration order), while the live draft is assembled by the
+ * editor's spread-mutations (keys in mutation order). A plain `JSON.stringify`
+ * equality is order-sensitive, so it would report a just-published, byte-equal
+ * document as still having changes — pinning the Publish affordance on forever.
+ */
+export function snapshotMatchesDraft(snapshot, draft) {
+    return stableStringify(snapshot) === stableStringify(draft);
+}
+/** Format a version's stored timestamp; fall back to the raw value if unparseable. */
+export function formatVersionTimestamp(value) {
+    const ms = Date.parse(value);
+    if (Number.isNaN(ms))
+        return value;
+    return new Date(ms).toLocaleString();
+}
+//# sourceMappingURL=versions-model.js.map

package/dist/components/cms/versions-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions-model.js","sourceRoot":"","sources":["../../../src/components/cms/versions-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGpD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAqB,EAAE,KAAkB;IAC5E,OAAO,eAAe,CAAC,QAAQ,CAAC,KAAK,eAAe,CAAC,KAAK,CAAC,CAAA;AAC7D,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC5B,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAA;IAClC,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,cAAc,EAAE,CAAA;AACtC,CAAC"}

package/dist/components/cms/versions-pane.d.ts

@@ -0,0 +1,14 @@
+/**
+ * EC-224 — the document-level **Versions** inspector pane. Re-homes the EC-180
+ * VersionsPanel at the document level (the Sanity model): the continuous draft
+ * on top with **Publish**, then the recorded version history (the live pin
+ * badged), each older version **restorable** into the draft.
+ *
+ * Publish routes through the same pointer op as the header control
+ * (`cms.publishDocument`); restore loads a recorded snapshot as the new working
+ * draft (the operation snapshots the current draft first, so a rollback is
+ * itself undoable) and the open editor adopts it via `replaceDraft`. Unpublish
+ * deliberately stays in the header — it routes through the EC-173
+ * reference-aware confirmation, which this pane does not duplicate.
+ */
+export declare function VersionsPane(): import("react").JSX.Element;

package/dist/components/cms/versions-pane.js

@@ -0,0 +1,86 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useState } from 'react';
+import { Eye, RotateCcw } from 'lucide-react';
+import { Badge, Button, Code, Row, Spacer, Stack, Text } from '@elytracms/studio/ui';
+import { useCms } from './cms-store';
+import { useDocumentEditor } from './document-editor-context';
+import { formatVersionTimestamp, snapshotMatchesDraft } from './versions-model';
+/**
+ * EC-224 — the document-level **Versions** inspector pane. Re-homes the EC-180
+ * VersionsPanel at the document level (the Sanity model): the continuous draft
+ * on top with **Publish**, then the recorded version history (the live pin
+ * badged), each older version **restorable** into the draft.
+ *
+ * Publish routes through the same pointer op as the header control
+ * (`cms.publishDocument`); restore loads a recorded snapshot as the new working
+ * draft (the operation snapshots the current draft first, so a rollback is
+ * itself undoable) and the open editor adopts it via `replaceDraft`. Unpublish
+ * deliberately stays in the header — it routes through the EC-173
+ * reference-aware confirmation, which this pane does not duplicate.
+ */
+export function VersionsPane() {
+    const cms = useCms();
+    const { docRef, draft, dirty, hasErrors, viewReadOnly, save, replaceDraft } = useDocumentEditor();
+    const [view, setView] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const published = cms.isPublished(docRef);
+    const reload = useCallback(async () => {
+        // Flush any queued publish/save so the listed history is authoritative
+        // regardless of which surface (header or pane) triggered the change.
+        await cms.flushPersistence();
+        setView(await cms.loadDocumentVersions(docRef));
+    }, [cms, docRef]);
+    useEffect(() => {
+        void reload();
+        // Re-load when publish-ness flips from anywhere (e.g. the header control).
+    }, [reload, published]);
+    const liveSnapshot = view?.publishedVersion !== undefined
+        ? view.versions.find((v) => v.version === view.publishedVersion)?.snapshot
+        : undefined;
+    // Value-equality (key-order-insensitive) so a just-published, unchanged doc
+    // doesn't read as "unpublished changes" — see snapshotMatchesDraft.
+    const liveMatchesDraft = liveSnapshot !== undefined && snapshotMatchesDraft(liveSnapshot, draft);
+    const canPublish = !liveMatchesDraft;
+    const handlePublish = useCallback(async () => {
+        setBusy(true);
+        try {
+            // Publish snapshots the SAVED draft — capture any unsaved edits first so
+            // the published version is exactly what the editor shows. Await the
+            // publish (it flushes + reconciles the pin, EC-225) before re-reading the
+            // version list so the new version shows.
+            if (dirty)
+                save();
+            await cms.publishDocument(docRef);
+            await reload();
+        }
+        finally {
+            setBusy(false);
+        }
+    }, [cms, docRef, dirty, save, reload]);
+    const handleRestore = useCallback(async (version) => {
+        setBusy(true);
+        try {
+            // Capture any unsaved buffer edits FIRST so the operation's pre-restore
+            // snapshot records them — otherwise they'd be lost and the rollback
+            // wouldn't be undoable (restore snapshots the persisted draft).
+            if (dirty)
+                save();
+            const restored = await cms.restoreDocumentVersion(docRef, version);
+            if (restored)
+                replaceDraft(restored);
+            await reload();
+        }
+        finally {
+            setBusy(false);
+        }
+    }, [cms, docRef, dirty, save, replaceDraft, reload]);
+    return (_jsxs(Stack, { gap: "3", className: "p-3", children: [canPublish ? (_jsxs(Row, { gap: "2", align: "center", className: "rounded-md border border-primary/40 bg-primary/5 px-2.5 py-2", children: [_jsxs(Stack, { gap: "none", className: "min-w-0", children: [_jsx(Text, { size: "sm", weight: "medium", children: "Draft" }), _jsx(Text, { size: "xs", tone: "muted", children: published ? 'Unpublished changes' : 'Not published yet' })] }), _jsx(Spacer, {}), _jsxs(Button, { size: "sm", onClick: handlePublish, disabled: busy || hasErrors || viewReadOnly, title: viewReadOnly
+                            ? 'Switch to Draft to publish'
+                            : hasErrors
+                                ? 'Fix the document’s validation issues to publish'
+                                : undefined, children: [_jsx(Eye, {}), " Publish"] })] })) : (_jsx(Text, { size: "xs", tone: "muted", className: "px-0.5", children: "The live version is up to date \u2014 nothing to publish." })), _jsx(Stack, { gap: "1", children: view === null ? (_jsx(Text, { size: "xs", tone: "muted", className: "px-0.5", children: "Loading\u2026" })) : view.versions.length === 0 ? (_jsx(Text, { size: "xs", tone: "muted", className: "px-0.5", children: "No published versions yet." })) : (view.versions.map((entry) => {
+                    const isLive = entry.version === view.publishedVersion;
+                    return (_jsxs(Row, { gap: "2", align: "center", className: "rounded-md border border-border/60 px-2.5 py-1.5", children: [_jsxs(Code, { tone: isLive ? 'primary' : 'muted', children: ["v", entry.version] }), isLive ? _jsx(Badge, { variant: "success", children: "Published" }) : null, _jsx(Text, { size: "xs", tone: "subtle", mono: true, className: "truncate", children: formatVersionTimestamp(entry.createdAt) }), _jsx(Spacer, {}), isLive ? null : (_jsxs(Button, { size: "sm", variant: "outline", onClick: () => void handleRestore(entry.version), disabled: busy || viewReadOnly, title: viewReadOnly ? 'Switch to Draft to restore' : undefined, children: [_jsx(RotateCcw, {}), " Restore"] }))] }, entry.version));
+                })) })] }));
+}
+//# sourceMappingURL=versions-pane.js.map