@elytracms/studio 0.0.1

package/dist/components/playground-badge.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { FlaskConical } from 'lucide-react';
+import { Badge } from '@elytracms/studio/ui';
+import { isPlaygroundMode } from '@elytracms/studio/lib/persistence';
+/** Tooltip/accessible description — playground data is local and ephemeral. */
+export const PLAYGROUND_BADGE_HINT = 'Playground mode: data lives in memory on this device and resets on reload. Nothing is saved to a backend.';
+/**
+ * EC-153: the explicit playground-mode marker. When the studio runs on the
+ * seeded in-memory adapter (`VITE_ELYTRA_MODE=playground`) this badge is
+ * always visible in the shell header; in Convex mode it renders nothing.
+ * Deterministic: mode is resolved from build-time env, identical on SSR and
+ * client.
+ */
+export function PlaygroundBadge() {
+    if (!isPlaygroundMode())
+        return null;
+    return (_jsxs(Badge, { variant: "warning", title: PLAYGROUND_BADGE_HINT, "data-testid": "playground-badge", children: [_jsx(FlaskConical, { "aria-hidden": true }), "Playground"] }));
+}
+//# sourceMappingURL=playground-badge.js.map

package/dist/components/playground-badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground-badge.js","sourceRoot":"","sources":["../../src/components/playground-badge.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AAEpE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAChC,2GAA2G,CAAA;AAE7G;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,gBAAgB,EAAE;QAAE,OAAO,IAAI,CAAA;IACpC,OAAO,CACL,MAAC,KAAK,IAAC,OAAO,EAAC,SAAS,EAAC,KAAK,EAAE,qBAAqB,iBAAc,kBAAkB,aACnF,KAAC,YAAY,0BAAe,kBAEtB,CACT,CAAA;AACH,CAAC"}

package/dist/components/project-list.d.ts

@@ -0,0 +1,15 @@
+import type { SectionState } from '@elytracms/studio-core';
+export interface ProjectLauncherProps {
+    /** Force a deterministic list state for browser verification (?state=…). */
+    forcedState?: SectionState | null;
+}
+/**
+ * Studio launcher / project list (brief §4.3, §8.1; reframed by EC-154). The
+ * Studio's front door: lists the workspace's projects and routes into a
+ * project's shell. With a workspace config the list is config-driven
+ * (configured projects ∩ grants, plus explicit "not provisioned" states);
+ * project *creation* is code-first — `elytra.config.ts` + `builder init
+ * --project <slug>` — so there is no in-UI create flow. Without a config the
+ * adapter-backed list (and the starter-kit gallery) behaves as before.
+ */
+export declare function ProjectLauncher({ forcedState }: ProjectLauncherProps): import("react").JSX.Element;

package/dist/components/project-list.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router';
+import { Globe, LogIn, TerminalSquare } from 'lucide-react';
+import { Badge, Button, Card, Code, Heading, Row, Spacer, Stack, Text } from '@elytracms/studio/ui';
+import { hasProjectSession } from '@elytracms/studio/lib/auth';
+import { PlaygroundBadge } from './playground-badge';
+import { SectionStateView } from './section-state';
+import { useStudio } from './studio-context';
+import { useSwitcherEntries } from './workspace-projects';
+/**
+ * Studio launcher / project list (brief §4.3, §8.1; reframed by EC-154). The
+ * Studio's front door: lists the workspace's projects and routes into a
+ * project's shell. With a workspace config the list is config-driven
+ * (configured projects ∩ grants, plus explicit "not provisioned" states);
+ * project *creation* is code-first — `elytra.config.ts` + `builder init
+ * --project <slug>` — so there is no in-UI create flow. Without a config the
+ * adapter-backed list (and the starter-kit gallery) behaves as before.
+ */
+export function ProjectLauncher({ forcedState }) {
+    const studio = useStudio();
+    const { entries, workspace } = useSwitcherEntries();
+    const hasConfig = workspace.kind === 'config';
+    const visible = entries;
+    const recents = studio.context.recentProjectIds
+        .map((id) => studio.getProject(id))
+        .filter((p) => Boolean(p))
+        .filter((p) => entries.some((e) => e.kind === 'project' && e.project.id === p.id))
+        .slice(0, 4);
+    const forced = forcedState && forcedState !== 'working' ? forcedState : null;
+    return (_jsxs("div", { className: "mx-auto w-full max-w-6xl px-6 py-8", children: [_jsxs(Row, { gap: "3", className: "mb-6", children: [_jsxs(Stack, { gap: "1", children: [_jsxs(Row, { gap: "2", children: [_jsx(Heading, { size: "display", children: "Projects" }), _jsx(PlaygroundBadge, {}), hasConfig ? (
+                                    // EC-154: this workspace is defined in code.
+                                    _jsxs(Badge, { variant: "outline", children: [_jsx(TerminalSquare, { className: "size-3" }), " ", workspace.source] })) : null] }), _jsx(Text, { tone: "muted", children: hasConfig
+                                    ? 'Projects are defined in code. Add entries to elytra.config.ts and provision them with the CLI.'
+                                    : 'Open and manage your Elytra projects.' })] }), _jsx(Spacer, {})] }), recents.length > 0 && !forced ? (_jsxs(Stack, { gap: "2", className: "mb-6", children: [_jsx(Text, { size: "xs", tone: "muted", mono: true, children: "RECENT" }), _jsx(Row, { gap: "2", wrap: true, children: recents.map((p) => (_jsxs(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId: p.id, _splat: studioPath.index() }, onClick: () => studio.activate(p.id), className: "inline-flex items-center gap-2 rounded-md border border-border bg-card px-3 py-1.5 text-sm transition-colors hover:border-primary/40 hover:bg-muted", children: [_jsx("span", { className: "grid size-4 place-items-center rounded-[4px] bg-primary text-[0.6rem] font-bold text-primary-foreground", children: p.name.charAt(0).toUpperCase() }), p.name] }, p.id))) })] })) : null, forced ? (_jsx(SectionStateView, { state: forced, title: forced === 'empty' ? 'No projects' : undefined })) : visible.length === 0 ? (_jsx(SectionStateView, { state: "empty", title: "No projects", description: hasConfig
+                    ? 'The workspace config declares no visible projects. Add an entry to elytra.config.ts, or ask an admin to grant you access.'
+                    : 'No active projects. Create one from the CLI: run `builder init` in your repo to scaffold elytra.config.ts, then `builder init --project <slug>`.' })) : (_jsx("div", { className: "grid gap-4 sm:grid-cols-2 lg:grid-cols-3", children: visible.map((entry) => entry.kind === 'project' ? (_jsx(ProjectCard, { project: entry.project }, entry.project.id)) : (_jsx(UnprovisionedCard, { config: entry.config }, `config:${entry.config.slug}`))) }))] }));
+}
+function ProjectCard({ project }) {
+    const studio = useStudio();
+    // Per-backend sign-in state (EC-179): one project per backend, so a project on
+    // a deployment the user hasn't authenticated into shows "Sign in", not "Open".
+    const authed = hasProjectSession(project.slug);
+    return (_jsxs(Card, { className: "flex flex-col gap-3 p-4 transition-colors hover:border-primary/30", children: [_jsxs(Row, { gap: "2", children: [_jsx("span", { className: "grid size-8 shrink-0 place-items-center rounded-lg bg-primary text-sm font-bold text-primary-foreground", children: project.name.charAt(0).toUpperCase() }), _jsxs(Stack, { gap: "1", className: "min-w-0", children: [_jsx(Text, { weight: "semibold", className: "truncate", children: project.name }), _jsx(Code, { tone: "muted", className: "w-fit max-w-full truncate", children: project.slug })] }), _jsx(Spacer, {}), authed ? null : (_jsxs(Badge, { variant: "warning", children: [_jsx(LogIn, { className: "size-3" }), " Sign in"] }))] }), _jsxs(Row, { gap: "2", className: "text-muted-foreground", children: [_jsxs(Badge, { variant: "outline", children: [_jsx(Globe, { className: "size-3" }), " ", project.settings.locales.length] }), _jsx(Spacer, {})] }), _jsx(Button, { variant: authed ? 'secondary' : 'default', size: "sm", asChild: true, className: "mt-1", children: _jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId: project.id, _splat: studioPath.index() }, onClick: () => studio.activate(project.id), children: authed ? 'Open project' : (_jsxs(_Fragment, { children: [_jsx(LogIn, {}), " Sign in"] })) }) })] }));
+}
+/**
+ * A configured project that has no backend project yet (EC-154): an explicit,
+ * deterministic state pointing at the CLI provisioning flow — never an error.
+ */
+function UnprovisionedCard({ config }) {
+    return (_jsxs(Card, { className: "flex flex-col gap-3 border-dashed p-4", children: [_jsxs(Row, { gap: "2", children: [_jsx("span", { className: "grid size-8 shrink-0 place-items-center rounded-lg border border-border bg-muted text-sm font-bold text-muted-foreground", children: config.name.charAt(0).toUpperCase() }), _jsxs(Stack, { gap: "1", className: "min-w-0", children: [_jsx(Text, { weight: "semibold", className: "truncate", children: config.name }), _jsx(Code, { tone: "muted", className: "w-fit max-w-full truncate", children: config.slug })] }), _jsx(Spacer, {}), _jsx(Badge, { variant: "outline", children: "not provisioned" })] }), _jsx(Text, { size: "sm", tone: "muted", children: "Declared in the workspace config, but no backend project exists yet. Provision it from your repo:" }), _jsxs(Code, { className: "block w-fit max-w-full truncate text-xs", children: ["builder init --project ", config.slug] })] }));
+}
+//# sourceMappingURL=project-list.js.map

package/dist/components/project-list.js.map

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

package/dist/components/project-session.d.ts

@@ -0,0 +1,46 @@
+import type { ReactNode } from 'react';
+import type { HydratedCms, HydratedProjectSession, OperationResult } from '@elytracms/studio/lib/operations';
+/**
+ * Project-session hydration gate (Milestone B sign-off fix, EC-177 gap 1).
+ *
+ * In Convex mode every project session must BOOT from persistence: the
+ * builder from the latest persisted graph revision, the CMS from the saved
+ * schema + documents, publishing from the persisted environment states.
+ * This provider runs the `@elytracms/operations` hydration queries
+ * (`lib/operations/session-hydration`) and — like `BackendGate` — gates its
+ * children on a deterministic loading state, so fixture content never
+ * flashes (and is never editable) before the persisted state arrives.
+ *
+ * Playground mode renders children synchronously with `session: null`
+ * (fixtures), byte-identical to the pre-hydration behavior — the EC-138
+ * determinism contract.
+ *
+ * Side effect on hydration: the content preview engine
+ * (`lib/data/collection-content`) is pointed at the hydrated documents
+ * BEFORE children render, so "Preview with" lists and section previews show
+ * live entries, not fixture titles.
+ */
+export interface ProjectSessionStore {
+    /** Hydrated persisted state (Convex mode); `null` in playground (fixtures). */
+    session: HydratedProjectSession | null;
+    /**
+     * Load the CURRENT persisted CMS state (fresh query — the CMS section
+     * remounts per visit and must show edits persisted since project open).
+     * Playground resolves `null` immediately (fixtures).
+     */
+    loadCms(): Promise<OperationResult<HydratedCms | null>>;
+}
+export declare function ProjectSessionProvider({ projectId, children, }: {
+    projectId: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useProjectSession(): ProjectSessionStore;
+/**
+ * Gate one CMS surface mount on a FRESH persisted CMS load (Convex mode).
+ * Render-prop: hands the hydrated content (or `null` → fixture fallback,
+ * first-run) to the caller once it resolved. Playground renders synchronously
+ * with `null`.
+ */
+export declare function CmsSessionGate({ children, }: {
+    children: (cms: HydratedCms | null) => ReactNode;
+}): import("react").JSX.Element;

package/dist/components/project-session.js

@@ -0,0 +1,107 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useState } from 'react';
+import { Button, Stack, Text } from '@elytracms/studio/ui';
+import { getStudioOperations, loadHydratedCms, loadProjectSession } from '@elytracms/studio/lib/operations';
+import { isPlaygroundMode } from '@elytracms/studio/lib/persistence';
+import { configureContentSession } from '@elytracms/studio/lib/data';
+import { OperationErrorBanner } from './operation-error';
+const ProjectSessionContext = createContext(null);
+export function ProjectSessionProvider({ projectId, children, }) {
+    const playground = isPlaygroundMode();
+    // Playground renders children on the FIRST render (no effect round-trip):
+    // fixture boots stay synchronous and deterministic.
+    const [phase, setPhase] = useState(() => playground ? { kind: 'ready', session: null } : { kind: 'loading' });
+    const [attempt, setAttempt] = useState(0);
+    useEffect(() => {
+        if (playground) {
+            configureContentSession(null);
+            return;
+        }
+        let cancelled = false;
+        setPhase({ kind: 'loading' });
+        void getStudioOperations()
+            .then(({ operations }) => loadProjectSession(operations, projectId))
+            .then((result) => {
+            if (cancelled)
+                return;
+            if (!result.ok) {
+                setPhase({ kind: 'error', error: result.error });
+                return;
+            }
+            // Point the preview content engine at the hydrated documents before
+            // any child renders (panels read it module-level, synchronously).
+            configureContentSession(result.value.cms);
+            setPhase({ kind: 'ready', session: result.value });
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [projectId, playground, attempt]);
+    // Leaving the project resets the preview engine to fixtures; the next
+    // project's gate reconfigures it before rendering its own children.
+    useEffect(() => () => configureContentSession(null), []);
+    const loadCms = useCallback(async () => {
+        if (playground)
+            return { ok: true, value: null };
+        const { operations } = await getStudioOperations();
+        const result = await loadHydratedCms(operations, projectId);
+        // Keep the preview engine in sync with the freshest persisted content.
+        if (result.ok && result.value !== null)
+            configureContentSession(result.value);
+        return result;
+    }, [playground, projectId]);
+    if (phase.kind === 'loading')
+        return _jsx(SessionHydrating, {});
+    if (phase.kind === 'error') {
+        return (_jsx(SessionHydrationError, { error: phase.error, onRetry: () => setAttempt((n) => n + 1) }));
+    }
+    return (_jsx(ProjectSessionContext.Provider, { value: { session: phase.session, loadCms }, children: children }));
+}
+export function useProjectSession() {
+    const store = useContext(ProjectSessionContext);
+    if (!store) {
+        throw new Error('useProjectSession must be used within a <ProjectSessionProvider>.');
+    }
+    return store;
+}
+/**
+ * Gate one CMS surface mount on a FRESH persisted CMS load (Convex mode).
+ * Render-prop: hands the hydrated content (or `null` → fixture fallback,
+ * first-run) to the caller once it resolved. Playground renders synchronously
+ * with `null`.
+ */
+export function CmsSessionGate({ children, }) {
+    const { loadCms } = useProjectSession();
+    const playground = isPlaygroundMode();
+    const [phase, setPhase] = useState(() => (playground ? { kind: 'ready', cms: null } : { kind: 'loading' }));
+    const [attempt, setAttempt] = useState(0);
+    useEffect(() => {
+        if (playground)
+            return;
+        let cancelled = false;
+        setPhase({ kind: 'loading' });
+        void loadCms().then((result) => {
+            if (cancelled)
+                return;
+            setPhase(result.ok ? { kind: 'ready', cms: result.value } : { kind: 'error', error: result.error });
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [playground, loadCms, attempt]);
+    if (phase.kind === 'loading')
+        return _jsx(SessionHydrating, {});
+    if (phase.kind === 'error') {
+        return (_jsx(SessionHydrationError, { error: phase.error, onRetry: () => setAttempt((n) => n + 1) }));
+    }
+    return _jsx(_Fragment, { children: children(phase.cms) });
+}
+/** Deterministic loading frame while persisted state is fetched (mirrors BackendGate). */
+function SessionHydrating() {
+    return (_jsx("div", { className: "grid h-full min-h-64 flex-1 place-items-center p-8", "data-testid": "session-hydrating", children: _jsx(Text, { size: "sm", tone: "muted", children: "Loading project\u2026" }) }));
+}
+/** A failed hydration is a visible, retryable state — never a fixture fallback. */
+function SessionHydrationError({ error, onRetry, }) {
+    return (_jsx("div", { className: "grid h-full min-h-64 flex-1 place-items-center p-8", children: _jsxs(Stack, { gap: "3", className: "w-full max-w-xl", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Couldn\u2019t load this project\u2019s saved state" }), _jsx(OperationErrorBanner, { error: error }), _jsx(Text, { size: "xs", tone: "muted", children: "The studio never falls back to sample content against a live backend \u2014 your data is safe; retry once the backend is reachable." }), _jsx(Button, { variant: "outline", size: "sm", onClick: onRetry, className: "self-start", children: "Retry" })] }) }));
+}
+//# sourceMappingURL=project-session.js.map

package/dist/components/project-session.js.map

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

package/dist/components/project-switcher.d.ts

@@ -0,0 +1,11 @@
+import type { Project } from '@elytracms/studio-core';
+/**
+ * The project switcher (EC-033, reframed by EC-154): with a workspace config
+ * the list is config-driven — configured projects ∩ the user's grants, plus
+ * explicit "not provisioned" states for config entries that have no backend
+ * project yet. Without a config it lists the adapter-backed projects exactly
+ * as before. Project *creation* lives in code + CLI (`builder init`), not here.
+ */
+export declare function ProjectSwitcher({ activeProject }: {
+    activeProject: Project;
+}): import("react").JSX.Element;

package/dist/components/project-switcher.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { STUDIO_PROJECT_ROUTE, studioPath, useNavigate } from '@elytracms/studio/router';
+import { Check, ChevronsUpDown, FolderOpen, LogIn } from 'lucide-react';
+import { hasProjectSession } from '@elytracms/studio/lib/auth';
+import { Badge, Button, Code, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, Row, Spacer, Stack, Text, } from '@elytracms/studio/ui';
+import { useStudio } from './studio-context';
+import { useSwitcherEntries } from './workspace-projects';
+/**
+ * The project switcher (EC-033, reframed by EC-154): with a workspace config
+ * the list is config-driven — configured projects ∩ the user's grants, plus
+ * explicit "not provisioned" states for config entries that have no backend
+ * project yet. Without a config it lists the adapter-backed projects exactly
+ * as before. Project *creation* lives in code + CLI (`builder init`), not here.
+ */
+export function ProjectSwitcher({ activeProject }) {
+    const studio = useStudio();
+    const navigate = useNavigate();
+    const { entries } = useSwitcherEntries();
+    const activeEntries = entries;
+    const recents = studio.context.recentProjectIds
+        .map((id) => studio.getProject(id))
+        .filter((p) => Boolean(p) && p.id !== activeProject.id)
+        .filter((p) => activeEntries.some((entry) => entry.kind === 'project' && entry.project.id === p.id))
+        .slice(0, 4);
+    function open(project) {
+        studio.activate(project.id);
+        navigate({ to: STUDIO_PROJECT_ROUTE, params: { projectId: project.id, _splat: studioPath.index() } });
+    }
+    return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs(Button, { variant: "outline", size: "sm", className: "h-8 gap-2 px-2.5", children: [_jsx("span", { className: "grid size-4 place-items-center rounded-[4px] bg-primary text-[0.6rem] font-bold text-primary-foreground", children: activeProject.name.charAt(0).toUpperCase() }), _jsx("span", { className: "max-w-[12rem] truncate font-medium", children: activeProject.name }), _jsx(ChevronsUpDown, { className: "size-3.5 text-muted-foreground" })] }) }), _jsxs(DropdownMenuContent, { className: "w-80", align: "start", children: [recents.length > 0 ? (_jsxs(_Fragment, { children: [_jsx(DropdownMenuLabel, { children: "Recent" }), recents.map((p) => (_jsx(ProjectMenuItem, { project: p, active: false, onSelect: () => open(p) }, p.id))), _jsx(DropdownMenuSeparator, {})] })) : null, _jsx(DropdownMenuLabel, { children: "Projects" }), activeEntries.map((entry) => entry.kind === 'project' ? (_jsx(ProjectMenuItem, { project: entry.project, active: entry.project.id === activeProject.id, onSelect: () => open(entry.project) }, entry.project.id)) : (_jsx(UnprovisionedMenuItem, { config: entry.config }, `config:${entry.config.slug}`))), _jsx(DropdownMenuSeparator, {}), _jsxs(DropdownMenuItem, { onSelect: () => navigate({ to: '/' }), children: [_jsx(FolderOpen, {}), " Browse all projects"] })] })] }));
+}
+function ProjectMenuItem({ project, active, onSelect, }) {
+    // Per-backend sign-in state (EC-179): the active project is signed-in by
+    // definition; others wear a "Sign in" badge when their backend has no session.
+    const needsSignIn = !active && !hasProjectSession(project.slug);
+    return (_jsx(DropdownMenuItem, { onSelect: onSelect, className: "gap-2", children: _jsxs(Row, { gap: "2", className: "min-w-0 flex-1", children: [_jsx(Text, { size: "sm", className: "truncate", children: project.name }), _jsx(Code, { tone: "muted", className: "shrink-0", children: project.slug }), _jsx(Spacer, {}), needsSignIn ? (_jsxs(Badge, { variant: "warning", children: [_jsx(LogIn, { className: "size-3" }), " Sign in"] })) : null, active ? _jsx(Check, { className: "size-4 text-primary" }) : null] }) }));
+}
+/**
+ * A configured project with no backend project yet (EC-154): a clear,
+ * non-navigating state pointing at the CLI provisioning flow — never an error.
+ */
+function UnprovisionedMenuItem({ config }) {
+    return (_jsx(DropdownMenuItem, { disabled: true, className: "gap-2 opacity-100", children: _jsxs(Stack, { gap: "1", className: "min-w-0 flex-1 py-0.5", children: [_jsxs(Row, { gap: "2", className: "min-w-0", children: [_jsx(Text, { size: "sm", tone: "muted", className: "truncate", children: config.name }), _jsx(Spacer, {}), _jsx(Badge, { variant: "outline", children: "not provisioned" })] }), _jsxs(Code, { tone: "muted", className: "w-fit max-w-full truncate text-[0.7rem]", children: ["builder init --project ", config.slug] })] }) }));
+}
+//# sourceMappingURL=project-switcher.js.map

package/dist/components/project-switcher.js.map

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

package/dist/components/references/builder-deep-link.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Param-driven builder selection (EC-172). Reference-panel entries deep-link
+ * to `/$projectId/builder?page=<pageId>&node=<nodeId>`; this headless
+ * component applies those params to the builder store — switching the active
+ * page, selecting the node (falling back to the page root when the node has
+ * drifted away), and scrolling the canvas wrapper (`data-ec-node-id`) into
+ * view. Pure selection state: nothing here mutates the graph.
+ */
+export declare function BuilderDeepLink({ pageId, nodeId }: {
+    pageId?: string;
+    nodeId?: string;
+}): null;

package/dist/components/references/builder-deep-link.js

@@ -0,0 +1,53 @@
+import { useEffect, useRef } from 'react';
+import { getNode } from '@elytracms/project-graph';
+import { useBuilder } from '../builder/builder-store';
+/**
+ * Param-driven builder selection (EC-172). Reference-panel entries deep-link
+ * to `/$projectId/builder?page=<pageId>&node=<nodeId>`; this headless
+ * component applies those params to the builder store — switching the active
+ * page, selecting the node (falling back to the page root when the node has
+ * drifted away), and scrolling the canvas wrapper (`data-ec-node-id`) into
+ * view. Pure selection state: nothing here mutates the graph.
+ */
+export function BuilderDeepLink({ pageId, nodeId }) {
+    const builder = useBuilder();
+    const { dispatch } = builder;
+    const graphRef = useRef(builder.present);
+    graphRef.current = builder.present;
+    useEffect(() => {
+        if (pageId === undefined && nodeId === undefined)
+            return;
+        const graph = graphRef.current;
+        const page = (pageId !== undefined ? graph.pages.find((p) => p.id === pageId) : undefined) ??
+            (nodeId !== undefined
+                ? graph.pages.find((p) => getNode(p.root, nodeId) !== undefined)
+                : undefined);
+        if (!page)
+            return;
+        const selectedId = nodeId !== undefined && getNode(page.root, nodeId) ? nodeId : page.root.id;
+        dispatch({ type: 'select', id: selectedId, pageId: page.id });
+        // The canvas marks every rendered node with `data-ec-node-id`; scroll the
+        // selection into view once the page has rendered (bounded retries — the
+        // canvas may need a frame or two after a page switch).
+        let cancelled = false;
+        let attempts = 0;
+        const tryScroll = () => {
+            if (cancelled)
+                return;
+            const element = document.querySelector(`[data-ec-node-id="${CSS.escape(selectedId)}"]`);
+            if (element) {
+                element.scrollIntoView({ block: 'center', behavior: 'smooth' });
+            }
+            else if (attempts < 10) {
+                attempts += 1;
+                window.setTimeout(tryScroll, 60);
+            }
+        };
+        window.setTimeout(tryScroll, 60);
+        return () => {
+            cancelled = true;
+        };
+    }, [pageId, nodeId, dispatch]);
+    return null;
+}
+//# sourceMappingURL=builder-deep-link.js.map

package/dist/components/references/builder-deep-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-deep-link.js","sourceRoot":"","sources":["../../../src/components/references/builder-deep-link.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,EAAE,MAAM,EAAE,MAAM,EAAwC;IACtF,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;IAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAA;IAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACxC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAElC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;YAAE,OAAM;QACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAA;QAC9B,MAAM,IAAI,GACR,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7E,CAAC,MAAM,KAAK,SAAS;gBACnB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC;gBAChE,CAAC,CAAC,SAAS,CAAC,CAAA;QAChB,IAAI,CAAC,IAAI;YAAE,OAAM;QACjB,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;QAC7F,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;QAE7D,0EAA0E;QAC1E,wEAAwE;QACxE,uDAAuD;QACvD,IAAI,SAAS,GAAG,KAAK,CAAA;QACrB,IAAI,QAAQ,GAAG,CAAC,CAAA;QAChB,MAAM,SAAS,GAAG,GAAG,EAAE;YACrB,IAAI,SAAS;gBAAE,OAAM;YACrB,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,qBAAqB,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;YACvF,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;YACjE,CAAC;iBAAM,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;gBACzB,QAAQ,IAAI,CAAC,CAAA;gBACb,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;YAClC,CAAC;QACH,CAAC,CAAA;QACD,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QAChC,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAA;QAClB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IAE9B,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/components/references/references-panel.d.ts

@@ -0,0 +1,17 @@
+import type { ReferenceSource, ReferenceTarget } from '@elytracms/persistence';
+/**
+ * The shared "References / Used by" panel (EC-172) — one generic component,
+ * three hosts (CMS document detail, asset library, component detail). Entries
+ * are served entirely by `@elytracms/operations` reference queries over the
+ * EC-155 index; every entry deep-links to the exact field control or graph
+ * node its index path identifies, and draft-only entries are visibly
+ * distinguished from published (live) ones.
+ */
+export declare function ReferencesPanel({ projectId, source, target, className, }: {
+    projectId: string;
+    /** The holding entity — enables the outbound "References" section. */
+    source?: ReferenceSource;
+    /** The referenced entity — enables the inbound "Used by" section. */
+    target?: ReferenceTarget;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/components/references/references-panel.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router';
+import { AlertTriangle, ArrowDownLeft, ArrowUpRight, Link2, RotateCcw } from 'lucide-react';
+import { useReferencePanel } from '@elytracms/studio/lib/references';
+import { Badge, Button, Panel, PanelHeader, Row, Spacer, Stack, Text } from '@elytracms/studio/ui';
+/**
+ * The shared "References / Used by" panel (EC-172) — one generic component,
+ * three hosts (CMS document detail, asset library, component detail). Entries
+ * are served entirely by `@elytracms/operations` reference queries over the
+ * EC-155 index; every entry deep-links to the exact field control or graph
+ * node its index path identifies, and draft-only entries are visibly
+ * distinguished from published (live) ones.
+ */
+export function ReferencesPanel({ projectId, source, target, className, }) {
+    const panel = useReferencePanel({ projectId, source, target });
+    const total = panel.data === null ? null : panel.data.outbound.length + panel.data.inbound.length;
+    return (_jsxs(Panel, { className: className, "data-testid": "references-panel", children: [_jsxs(PanelHeader, { children: [_jsx(Link2, { className: "size-4 text-primary" }), _jsx(Text, { size: "sm", weight: "semibold", children: "References" }), total !== null ? _jsx(Badge, { variant: "outline", children: total }) : null, _jsx(Spacer, {})] }), _jsx(Stack, { gap: "4", className: "p-4", children: panel.status === 'loading' ? (_jsx(ReferencesLoading, {})) : panel.status === 'error' ? (_jsx(ReferencesError, { message: panel.errorMessage, onRetry: panel.refresh })) : (_jsxs(_Fragment, { children: [source ? (_jsx(ReferenceSection, { title: "References", icon: _jsx(ArrowUpRight, { className: "size-3.5" }), hint: "What this entry points at \u2014 click to jump to the target, or to the exact field.", direction: "outbound", projectId: projectId, entries: panel.data?.outbound ?? [], error: panel.data?.outboundError ?? null, emptyLabel: "No outbound references." })) : null, target ? (_jsx(ReferenceSection, { title: "Used by", icon: _jsx(ArrowDownLeft, { className: "size-3.5" }), hint: "Everything referencing this entry \u2014 click to jump to the exact field or node.", direction: "inbound", projectId: projectId, entries: panel.data?.inbound ?? [], error: panel.data?.inboundError ?? null, emptyLabel: "Not referenced anywhere." })) : null] })) })] }));
+}
+/** Named loading state, consistent with existing studio panels. */
+function ReferencesLoading() {
+    return (_jsx(Text, { size: "sm", tone: "muted", "data-testid": "references-loading", children: "Loading references\u2026" }));
+}
+/** Named error state with retry — never a silent failure. */
+function ReferencesError({ message, onRetry, }) {
+    return (_jsxs(Stack, { gap: "2", "data-testid": "references-error", children: [_jsxs(Row, { gap: "2", children: [_jsx(AlertTriangle, { className: "size-4 text-destructive" }), _jsx(Text, { size: "sm", weight: "semibold", children: "References failed to load" })] }), _jsx(Text, { size: "xs", tone: "muted", children: message ?? 'The reference index is unreachable.' }), _jsx(Row, { children: _jsxs(Button, { variant: "outline", size: "sm", onClick: onRetry, children: [_jsx(RotateCcw, {}), " Retry"] }) })] }));
+}
+function ReferenceSection({ title, icon, hint, direction, projectId, entries, error, emptyLabel, }) {
+    return (_jsxs(Stack, { gap: "2", "data-testid": `references-${direction}`, children: [_jsxs(Row, { gap: "2", children: [_jsx("span", { className: "text-muted-foreground", children: icon }), _jsx(Text, { size: "xs", weight: "semibold", tone: "muted", className: "uppercase tracking-wide", children: title }), _jsx(Badge, { variant: "outline", children: entries.length })] }), error ? (_jsxs(Row, { gap: "2", "data-testid": `references-${direction}-error`, children: [_jsx(AlertTriangle, { className: "size-3.5 shrink-0 text-destructive" }), _jsxs(Text, { size: "xs", tone: "muted", children: ["Couldn\u2019t load this section: ", error] })] })) : entries.length === 0 ? (_jsx(Text, { size: "sm", tone: "muted", "data-testid": `references-${direction}-empty`, children: emptyLabel })) : (_jsx(Stack, { gap: "2", title: hint, children: entries.map((entry) => (_jsx(ReferenceEntryRow, { entry: entry, direction: direction, projectId: projectId }, entry.key))) }))] }));
+}
+/**
+ * One entry row. Inbound rows lead with the *source* (where it is used) and
+ * deep-link to the exact location; outbound rows lead with the *target* and
+ * keep the exact-field link on the location line.
+ */
+function ReferenceEntryRow({ entry, direction, projectId, }) {
+    const primary = direction === 'inbound'
+        ? { label: entry.sourceLabel, link: entry.sourceLink }
+        : { label: entry.targetLabel, link: entry.targetLink };
+    return (_jsxs(Row, { gap: "2", className: "rounded-md border border-border/70 bg-background/40 px-2.5 py-2", "data-testid": "reference-entry", children: [_jsxs(Stack, { gap: "1", className: "min-w-0 flex-1", children: [_jsx(Row, { gap: "2", className: "min-w-0", children: _jsx(DeepLinkText, { projectId: projectId, link: primary.link, label: primary.label, primary: true }) }), _jsxs(Row, { gap: "1", className: "min-w-0", children: [_jsx(Text, { size: "xs", tone: "muted", className: "shrink-0", children: "at" }), _jsx(DeepLinkText, { projectId: projectId, link: entry.sourceLink, label: entry.locationLabel })] })] }), _jsx(Badge, { variant: "outline", className: "shrink-0", children: entry.kindLabel }), _jsx(VariantBadges, { draft: entry.draft, published: entry.published })] }));
+}
+/** Draft/published visibility (the Sanity hidden-draft-reference case, AD-6). */
+function VariantBadges({ draft, published }) {
+    return (_jsxs(Row, { gap: "1", className: "shrink-0", "data-testid": "reference-variants", children: [draft ? _jsx(Badge, { variant: "warning", children: "draft" }) : null, published ? _jsx(Badge, { variant: "success", children: "published" }) : null] }));
+}
+/** Render a deep-link descriptor as a router link (plain text when unresolvable). */
+function DeepLinkText({ projectId, link, label, primary = false, }) {
+    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-link-cms", 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-link-builder", children: label }));
+        case 'component':
+            return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: studioPath.component(link.componentId) }, className: className, "data-testid": "reference-link-component", 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-link-asset", children: label }));
+    }
+}
+//# sourceMappingURL=references-panel.js.map

package/dist/components/references/references-panel.js.map

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

package/dist/components/routes/redirect-chain.d.ts

@@ -0,0 +1,9 @@
+import type { RedirectResolution } from '@elytracms/cms-core';
+/**
+ * Visualizes a redirect chain from the engine's {@link RedirectResolution}:
+ * every hop in order, with the loop entry point highlighted when the chain
+ * closes a loop (EC-170).
+ */
+export declare function RedirectChain({ resolution }: {
+    resolution: RedirectResolution;
+}): import("react").JSX.Element;

package/dist/components/routes/redirect-chain.js

@@ -0,0 +1,16 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment } from 'react';
+import { ArrowRight, RotateCw } from 'lucide-react';
+import { Badge, Code, Row } from '@elytracms/studio/ui';
+/**
+ * Visualizes a redirect chain from the engine's {@link RedirectResolution}:
+ * every hop in order, with the loop entry point highlighted when the chain
+ * closes a loop (EC-170).
+ */
+export function RedirectChain({ resolution }) {
+    return (_jsxs(Row, { gap: "1", wrap: true, "data-testid": "redirect-chain", "data-loop": resolution.loop, children: [resolution.chain.map((hop, index) => {
+                const isLoopEntry = resolution.loop && hop === resolution.target;
+                return (_jsxs(Fragment, { children: [index > 0 ? _jsx(ArrowRight, { className: "size-3 shrink-0 text-muted-foreground" }) : null, _jsx(Code, { className: isLoopEntry ? 'border-destructive/50 bg-destructive/10 text-destructive' : undefined, children: hop })] }, `${hop}-${index}`));
+            }), resolution.loop ? (_jsxs(Badge, { variant: "error", "data-testid": "loop-badge", children: [_jsx(RotateCw, {}), " loop"] })) : null] }));
+}
+//# sourceMappingURL=redirect-chain.js.map

package/dist/components/routes/redirect-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirect-chain.js","sourceRoot":"","sources":["../../../src/components/routes/redirect-chain.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEnD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAEvD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,UAAU,EAAsC;IAC9E,OAAO,CACL,MAAC,GAAG,IAAC,GAAG,EAAC,GAAG,EAAC,IAAI,uBAAa,gBAAgB,eAAY,UAAU,CAAC,IAAI,aACtE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;gBACnC,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,IAAI,GAAG,KAAK,UAAU,CAAC,MAAM,CAAA;gBAChE,OAAO,CACL,MAAC,QAAQ,eACN,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAC,UAAU,IAAC,SAAS,EAAC,uCAAuC,GAAG,CAAC,CAAC,CAAC,IAAI,EACpF,KAAC,IAAI,IACH,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,0DAA0D,CAAC,CAAC,CAAC,SAAS,YAE9F,GAAG,GACC,KANM,GAAG,GAAG,IAAI,KAAK,EAAE,CAOrB,CACZ,CAAA;YACH,CAAC,CAAC,EACD,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CACjB,MAAC,KAAK,IAAC,OAAO,EAAC,OAAO,iBAAa,YAAY,aAC7C,KAAC,QAAQ,KAAG,aACN,CACT,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAA;AACH,CAAC"}

package/dist/components/routes/redirect-manager.d.ts

@@ -0,0 +1,13 @@
+import type { RedirectRecord, RedirectResolution } from '@elytracms/cms-core';
+export interface RedirectManagerProps {
+    redirects: readonly RedirectRecord[];
+    /** The live router's chain resolver (engine API, EC-020). */
+    followRedirects: (from: string) => RedirectResolution;
+}
+/**
+ * The redirect list (EC-170), read-only (EC-207 "routes as code"): every
+ * 301/302 redirect of the project. Each row shows its resolved chain from the
+ * live engine; loops render as explicit errors. Redirects are authored in
+ * `elytra.config.ts`; this surface only views them.
+ */
+export declare function RedirectManager({ redirects, followRedirects }: RedirectManagerProps): import("react").JSX.Element;

package/dist/components/routes/redirect-manager.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ArrowRight } from 'lucide-react';
+import { Badge, Code, Row, Spacer, Stack, Text } from '@elytracms/studio/ui';
+import { statusCodeOf } from '@elytracms/studio/lib/routing';
+import { RedirectChain } from './redirect-chain';
+/**
+ * The redirect list (EC-170), read-only (EC-207 "routes as code"): every
+ * 301/302 redirect of the project. Each row shows its resolved chain from the
+ * live engine; loops render as explicit errors. Redirects are authored in
+ * `elytra.config.ts`; this surface only views them.
+ */
+export function RedirectManager({ redirects, followRedirects }) {
+    const sorted = [...redirects].sort((a, b) => a.from.localeCompare(b.from));
+    return (_jsxs(Stack, { gap: "none", className: "min-h-0", children: [_jsxs(Row, { gap: "2", className: "h-12 shrink-0 border-b border-border px-4", children: [_jsx(Text, { size: "sm", weight: "semibold", children: "Redirects" }), _jsx(Text, { size: "xs", tone: "subtle", mono: true, children: redirects.length })] }), _jsxs(Stack, { gap: "3", className: "p-4", children: [sorted.length === 0 ? (_jsx(Text, { size: "sm", tone: "muted", children: "No redirects defined. Add redirects in elytra.config.ts to forward old URLs to new ones." })) : null, _jsx("ul", { className: "flex flex-col gap-2", "data-testid": "redirect-list", children: sorted.map((redirect) => (_jsx(RedirectRow, { redirect: redirect, resolution: followRedirects(redirect.from) }, redirect.id))) })] })] }));
+}
+function RedirectRow({ redirect, resolution, }) {
+    // More hops than `from → to` means this redirect chains onward (or loops).
+    const chains = resolution.loop || resolution.chain.length > 2;
+    return (_jsxs("li", { "data-testid": `redirect-row-${redirect.id}`, className: 'rounded-md border p-3 ' +
+            (resolution.loop ? 'border-destructive/40 bg-destructive/5' : 'border-border bg-card/40'), children: [_jsxs(Row, { gap: "2", wrap: true, children: [_jsx(Code, { children: redirect.from }), _jsx(ArrowRight, { className: "size-3 shrink-0 text-muted-foreground" }), _jsx(Code, { children: redirect.to }), _jsx(Badge, { variant: redirect.permanent ? 'primary' : 'info', "data-testid": `redirect-status-${redirect.id}`, children: statusCodeOf(redirect) }), resolution.loop ? _jsx(Badge, { variant: "error", children: "loop" }) : null, _jsx(Spacer, {})] }), chains ? (_jsxs(Stack, { gap: "1", className: "mt-2", children: [_jsx(Text, { size: "xs", tone: "muted", children: resolution.loop
+                            ? 'This redirect is part of a loop:'
+                            : `Chains to ${resolution.target}:` }), _jsx(RedirectChain, { resolution: resolution })] })) : null] }));
+}
+//# sourceMappingURL=redirect-manager.js.map