@elytracms/studio 0.0.1

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

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

package/dist/components/routes/route-list.d.ts

@@ -0,0 +1,35 @@
+import type { RouteRecord } from '@elytracms/cms-core';
+import type { RouteConflict } from '@elytracms/studio/lib/routing';
+/** The slice of a graph page the route list needs for linking/labelling. */
+export interface PageSummary {
+    id: string;
+    name: string;
+}
+export interface RouteListProps {
+    projectId: string;
+    routes: readonly RouteRecord[];
+    /** Engine-sourced `route-conflict` issues, indexed by route id (both sides). */
+    conflicts: ReadonlyMap<string, RouteConflict[]>;
+    pages: readonly PageSummary[];
+}
+/**
+ * Every route of the project (EC-170), read-only (EC-207 "routes as code"):
+ * static paths, dynamic patterns with `:param` segments rendered distinctly, and
+ * per-locale variants — each row linking to its page/template/document. Routes
+ * are authored in `elytra.config.ts`; this list only views them. Conflicts from
+ * the engine's structured issues render inline with deep links to the
+ * counterpart row.
+ */
+export declare function RouteList({ projectId, routes, conflicts, pages }: RouteListProps): import("react").JSX.Element;
+/** A route pattern with `:param` segments rendered distinctly (EC-170). */
+export declare function PatternView({ pattern }: {
+    pattern: string;
+}): import("react").JSX.Element;
+/**
+ * Inline conflict block: the engine's `route-conflict` message plus a deep
+ * link to the counterpart row (same-page anchor; rows highlight on `:target`).
+ */
+export declare function ConflictNotice({ routeId, conflicts, }: {
+    routeId: string;
+    conflicts: readonly RouteConflict[];
+}): import("react").JSX.Element;

package/dist/components/routes/route-list.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router';
+import { CircleAlert, Globe } from 'lucide-react';
+import { Badge, Code, Row, Spacer, Stack, Text } from '@elytracms/studio/ui';
+import { patternSegments } from '@elytracms/studio/lib/routing';
+/**
+ * Every route of the project (EC-170), read-only (EC-207 "routes as code"):
+ * static paths, dynamic patterns with `:param` segments rendered distinctly, and
+ * per-locale variants — each row linking to its page/template/document. Routes
+ * are authored in `elytra.config.ts`; this list only views them. Conflicts from
+ * the engine's structured issues render inline with deep links to the
+ * counterpart row.
+ */
+export function RouteList({ projectId, routes, conflicts, pages }) {
+    const sorted = [...routes].sort((a, b) => a.pattern === b.pattern
+        ? (a.locale ?? '').localeCompare(b.locale ?? '')
+        : a.pattern.localeCompare(b.pattern));
+    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: "Routes" }), _jsx(Text, { size: "xs", tone: "subtle", mono: true, children: routes.length })] }), _jsxs(Stack, { gap: "3", className: "p-4", children: [sorted.length === 0 ? (_jsx(Text, { size: "sm", tone: "muted", children: "No routes defined. Add routes in elytra.config.ts to bind URL patterns to pages or templates." })) : null, _jsx("ul", { className: "flex flex-col gap-2", "data-testid": "route-list", children: sorted.map((route) => (_jsx(RouteRow, { projectId: projectId, route: route, conflicts: conflicts.get(route.id) ?? [], pages: pages }, route.id))) })] })] }));
+}
+function RouteRow({ projectId, route, conflicts, pages, }) {
+    const hasConflict = conflicts.length > 0;
+    return (_jsxs("li", { id: `route-${route.id}`, "data-testid": `route-row-${route.id}`, className: 'rounded-md border p-3 transition-colors target:ring-2 target:ring-ring/60 ' +
+            (hasConflict ? 'border-destructive/40 bg-destructive/5' : 'border-border bg-card/40'), children: [_jsxs(Row, { gap: "2", wrap: true, children: [_jsx(PatternView, { pattern: route.pattern }), _jsx(LocaleBadge, { locale: route.locale }), _jsx(Spacer, {}), hasConflict ? (_jsx(Badge, { variant: "error", "data-testid": `route-status-${route.id}`, children: "conflict" })) : (_jsx(Badge, { variant: "success", "data-testid": `route-status-${route.id}`, children: "ok" }))] }), _jsx(Row, { gap: "2", wrap: true, className: "mt-2", children: _jsx(RouteTarget, { projectId: projectId, route: route, pages: pages }) }), hasConflict ? _jsx(ConflictNotice, { routeId: route.id, conflicts: conflicts }) : null] }));
+}
+/** A route pattern with `:param` segments rendered distinctly (EC-170). */
+export function PatternView({ pattern }) {
+    const segments = patternSegments(pattern);
+    return (_jsxs("span", { className: "inline-flex flex-wrap items-center font-mono text-sm", "data-testid": "pattern", children: [_jsx("span", { className: "text-muted-foreground", children: "/" }), segments.map((segment, index) => (_jsxs("span", { className: "inline-flex items-center", children: [segment.param ? (_jsx("span", { "data-param": segment.text, className: "rounded-sm border border-primary/30 bg-primary/10 px-1 text-primary", children: segment.text })) : (_jsx("span", { className: "text-foreground", children: segment.text })), index < segments.length - 1 ? _jsx("span", { className: "text-muted-foreground", children: "/" }) : null] }, `${segment.text}-${index}`)))] }));
+}
+function LocaleBadge({ locale }) {
+    if (!locale) {
+        return (_jsxs(Badge, { variant: "outline", children: [_jsx(Globe, {}), " all locales"] }));
+    }
+    return (_jsxs(Badge, { variant: "info", children: [_jsx(Globe, {}), " ", locale] }));
+}
+/** The page/template/document a route renders, deep-linked where a surface exists. */
+function RouteTarget({ projectId, route, pages, }) {
+    // EC-187: every target is a single `document` ref. A page target is the
+    // `page` collection; a template target is a `:param` placeholder id;
+    // anything else is a concrete linked document.
+    if (!route.document) {
+        return (_jsx(Badge, { variant: "warning", "data-testid": `route-no-target-${route.id}`, children: "no target" }));
+    }
+    if (route.document.collection === 'page') {
+        const pageId = route.document.id;
+        const page = pages.find((candidate) => candidate.id === pageId);
+        return (_jsxs(Row, { gap: "1", children: [_jsx(Text, { size: "xs", tone: "muted", children: "page" }), _jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: studioPath.builder() }, className: "text-xs font-medium text-primary underline-offset-2 hover:underline", children: page?.name ?? pageId }), !page ? _jsx(Badge, { variant: "warning", children: "not in graph" }) : null] }));
+    }
+    if (route.document.id.startsWith(':')) {
+        return (_jsxs(Row, { gap: "1", children: [_jsx(Text, { size: "xs", tone: "muted", children: "template" }), _jsx(Code, { children: route.document.collection })] }));
+    }
+    return (_jsxs(Row, { gap: "1", children: [_jsx(Text, { size: "xs", tone: "muted", children: "document" }), _jsxs(Link, { to: STUDIO_PROJECT_ROUTE, params: {
+                    projectId,
+                    _splat: studioPath.cmsDocument(route.document.collection, route.document.id),
+                }, className: "text-xs font-medium text-primary underline-offset-2 hover:underline", children: [route.document.collection, "/", route.document.id] })] }));
+}
+/**
+ * Inline conflict block: the engine's `route-conflict` message plus a deep
+ * link to the counterpart row (same-page anchor; rows highlight on `:target`).
+ */
+export function ConflictNotice({ routeId, conflicts, }) {
+    return (_jsx(Stack, { gap: "1", className: "mt-2 rounded-md border border-destructive/30 bg-destructive/10 p-2", children: conflicts.map((conflict, index) => (_jsxs(Row, { gap: "2", align: "start", children: [_jsx(CircleAlert, { className: "mt-0.5 size-3.5 shrink-0 text-destructive" }), _jsxs(Stack, { gap: "1", className: "min-w-0", children: [_jsx(Text, { size: "xs", className: "text-destructive", "data-testid": `conflict-${routeId}`, 
+                            // The engine message names both routes by their raw ids
+                            // (`r-blog-slug-en`) — kept inspectable on hover, never shown as
+                            // visible copy. The editor sees the patterns on the rows + the link
+                            // below (EC-192).
+                            title: conflict.issue.message, children: "Matches the same URLs as another route." }), conflict.otherRouteId ? (_jsx("a", { href: `#route-${conflict.otherRouteId}`, className: "text-xs font-medium text-destructive underline underline-offset-2", "data-testid": `conflict-link-${routeId}`, children: "View conflicting route" })) : null] })] }, `${conflict.otherRouteId}-${index}`))) }));
+}
+//# sourceMappingURL=route-list.js.map

package/dist/components/routes/route-list.js.map

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

package/dist/components/routes/routes-shell.d.ts

@@ -0,0 +1,14 @@
+import type { Project } from '@elytracms/studio-core';
+/**
+ * The Routes surface (EC-170, made read-only by EC-207 "routes as code"):
+ * every route and redirect of the project, with the engine's structured issues
+ * (route conflicts, redirect loops) rendered inline. Routes and redirects are
+ * authored in `elytra.config.ts` and read from the resolved config project
+ * (`resolveDeploymentRoutes`/`resolveDeploymentRedirects`) — NEVER from the
+ * backend. This surface only views them; conflict/loop detection comes from the
+ * canonical `@elytracms/cms-core` router, never from parallel UI-side logic. The
+ * page list (CMS `page` collection) is read only to label route targets.
+ */
+export declare function RoutesShell({ project }: {
+    project: Project;
+}): import("react").JSX.Element;

package/dist/components/routes/routes-shell.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { createRouter } from '@elytracms/cms-core';
+import { Badge, Heading, Row, Spacer, Stack, Text } from '@elytracms/studio/ui';
+import { getStudioOperations } from '@elytracms/studio/lib/operations';
+import { conflictsByRoute } from '@elytracms/studio/lib/routing';
+import { resolveDeploymentRedirects, resolveDeploymentRoutes } from '@elytracms/studio/lib/workspace';
+import { OperationErrorBanner } from '../operation-error';
+import { RouteList } from './route-list';
+import { RedirectManager } from './redirect-manager';
+/** The body-is-a-canvas page collection (EC-187): routable page documents. */
+const PAGE_COLLECTION = 'page';
+/**
+ * Routable pages come from the `page` CMS collection (EC-192) — the documents an
+ * editor actually creates — not the builder's single synthetic working page.
+ * `documents.list` returns persisted records wrapping each document; map each to
+ * a `{ id, name }` summary for the route target labels.
+ */
+function pageSummaries(records) {
+    return records.map(({ document }) => {
+        const name = document.values?.['name'];
+        return { id: document.id, name: typeof name === 'string' && name.length > 0 ? name : document.id };
+    });
+}
+/**
+ * The Routes surface (EC-170, made read-only by EC-207 "routes as code"):
+ * every route and redirect of the project, with the engine's structured issues
+ * (route conflicts, redirect loops) rendered inline. Routes and redirects are
+ * authored in `elytra.config.ts` and read from the resolved config project
+ * (`resolveDeploymentRoutes`/`resolveDeploymentRedirects`) — NEVER from the
+ * backend. This surface only views them; conflict/loop detection comes from the
+ * canonical `@elytracms/cms-core` router, never from parallel UI-side logic. The
+ * page list (CMS `page` collection) is read only to label route targets.
+ */
+export function RoutesShell({ project }) {
+    const projectId = project.id;
+    // Routes & redirects are config-sourced (EC-207): resolved synchronously from
+    // the active `elytra.config.ts` project, never fetched from the backend.
+    const routes = useMemo(() => resolveDeploymentRoutes(), []);
+    const redirects = useMemo(() => resolveDeploymentRedirects(), []);
+    const [pages, setPages] = useState([]);
+    const [loadError, setLoadError] = useState(null);
+    // Page documents feed the route target labels (read-only display). A failure
+    // here is non-fatal: the routes still render; the page labels just fall back
+    // to ids. The error banner surfaces any connection problem.
+    const reloadPages = useCallback(async () => {
+        const { operations } = await getStudioOperations();
+        const pageDocs = await operations.documents.list({ projectId, collection: PAGE_COLLECTION });
+        if (pageDocs.ok) {
+            setPages(pageSummaries(pageDocs.value));
+            setLoadError(null);
+        }
+        else {
+            setLoadError(pageDocs.error);
+        }
+    }, [projectId]);
+    useEffect(() => {
+        void reloadPages();
+    }, [reloadPages]);
+    // The engine: one router over the config-resolved records. Its structured
+    // issues are the single source of conflict/loop truth for this surface.
+    const router = useMemo(() => createRouter(routes, redirects, {
+        defaultLocale: project.settings.defaultLocale,
+    }), [routes, redirects, project.settings.defaultLocale]);
+    const conflicts = useMemo(() => conflictsByRoute(router.issues), [router]);
+    return (_jsxs(Stack, { gap: "none", className: "min-h-full", "data-testid": "routes-shell", children: [_jsxs(Row, { gap: "3", className: "shrink-0 border-b border-border px-4 py-3 sm:px-6", children: [_jsxs(Stack, { gap: "1", children: [_jsx(Heading, { level: 2, size: "h3", children: "Routes & redirects" }), _jsxs(Text, { size: "xs", tone: "muted", children: ["Routes & redirects are defined in ", _jsx("code", { children: "elytra.config.ts" }), ". Conflicts and loops are detected by the canonical route engine \u2014 never silently."] })] }), _jsx(Spacer, {}), loadError ? (_jsx(OperationErrorBanner, { error: loadError, onDismiss: () => void reloadPages() })) : null, router.issues.length > 0 ? (_jsxs(Badge, { variant: "error", "data-testid": "routing-issue-count", children: [router.issues.length, " issue", router.issues.length === 1 ? '' : 's'] })) : (_jsx(Badge, { variant: "success", children: "no issues" }))] }), _jsxs("div", { className: "grid min-h-0 flex-1 grid-cols-1 xl:grid-cols-[minmax(0,5fr)_minmax(0,4fr)]", children: [_jsx("section", { "aria-label": "Routes", className: "min-w-0 border-b border-border xl:border-b-0 xl:border-r", children: _jsx(RouteList, { projectId: projectId, routes: routes, conflicts: conflicts, pages: pages }) }), _jsx("section", { "aria-label": "Redirects", className: "min-w-0", children: _jsx(RedirectManager, { redirects: redirects, followRedirects: router.followRedirects }) })] })] }));
+}
+//# sourceMappingURL=routes-shell.js.map

package/dist/components/routes/routes-shell.js.map

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

package/dist/components/section-nav.d.ts

@@ -0,0 +1,17 @@
+import type { ProjectId, SectionAvailabilityMap } from '@elytracms/studio-core';
+import type { StudioNavId } from './sections';
+export interface SectionNavProps {
+    projectId: ProjectId;
+    activeSection: StudioNavId | null;
+    availability: SectionAvailabilityMap;
+    /** User-toggled collapse (EC-214) — icons only when collapsed, persisted by the shell. */
+    collapsed: boolean;
+    onToggleCollapsed: () => void;
+}
+/**
+ * Vertical section rail (brief §8.1). Availability-aware: `available`/`planned`
+ * are navigable; `unavailable` is rendered disabled. User-collapsible to an
+ * icon rail (EC-214) — the preference persists, and the active section carries a
+ * strong highlight (accent fill + a leading marker bar).
+ */
+export declare function SectionNav({ projectId, activeSection, availability, collapsed, onToggleCollapsed, }: SectionNavProps): import("react").JSX.Element;

package/dist/components/section-nav.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Link, STUDIO_PROJECT_ROUTE, useLocation } from '@elytracms/studio/router';
+import { PanelLeftClose, PanelLeftOpen } from 'lucide-react';
+import { cn } from '@elytracms/studio/lib/utils';
+import { SECTION_NAV_ITEMS, activeSectionFromPath, navAvailabilityOf } from './sections';
+/**
+ * Vertical section rail (brief §8.1). Availability-aware: `available`/`planned`
+ * are navigable; `unavailable` is rendered disabled. User-collapsible to an
+ * icon rail (EC-214) — the preference persists, and the active section carries a
+ * strong highlight (accent fill + a leading marker bar).
+ */
+export function SectionNav({ projectId, activeSection, availability, collapsed, onToggleCollapsed, }) {
+    // Recover the active id from the path if the shell didn't supply one — the
+    // shared parser is the single source of truth for the section segment index.
+    const { pathname } = useLocation();
+    const active = activeSection ?? activeSectionFromPath(pathname);
+    return (_jsxs("nav", { "aria-label": "Sections", className: cn('flex shrink-0 flex-col gap-0.5 border-r border-border bg-card/40 p-2 transition-[width] duration-150', collapsed ? 'w-[3.5rem]' : 'w-56'), children: [SECTION_NAV_ITEMS.map((item) => {
+                const state = navAvailabilityOf(availability, item.id);
+                const isActive = item.id === active;
+                const Icon = item.icon;
+                const body = (_jsxs(_Fragment, { children: [isActive ? (_jsx("span", { className: "absolute inset-y-1.5 left-0 w-0.5 rounded-full bg-primary", "aria-hidden": true })) : null, _jsx(Icon, { className: "size-4 shrink-0" }), collapsed ? null : (_jsx("span", { className: "min-w-0 flex-1 truncate", children: item.label })), state === 'planned' && !collapsed ? (_jsx("span", { className: "size-1.5 shrink-0 rounded-full bg-warning", "aria-hidden": true, title: "Planned" })) : null] }));
+                const base = cn('group relative flex h-9 items-center gap-2.5 rounded-md text-sm transition-colors', collapsed ? 'justify-center px-0' : 'px-3');
+                // EC-221: an unavailable section is absent from the rail (not greyed) —
+                // e.g. Extensions, cut from the v1 nav (vision §5). It stays reachable by
+                // URL for Milestone E revival; the rail simply doesn't advertise it.
+                if (state === 'unavailable')
+                    return null;
+                return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: item.id }, title: item.label, "aria-current": isActive ? 'page' : undefined, className: cn(base, isActive
+                        ? 'bg-accent font-medium text-accent-foreground'
+                        : 'text-muted-foreground hover:bg-muted hover:text-foreground'), children: body }, item.id));
+            }), _jsx("button", { type: "button", onClick: onToggleCollapsed, "aria-label": collapsed ? 'Expand sidebar' : 'Collapse sidebar', "aria-pressed": collapsed, title: collapsed ? 'Expand sidebar' : 'Collapse sidebar', className: cn('mt-auto flex h-9 items-center gap-2.5 rounded-md text-sm text-muted-foreground transition-colors hover:bg-muted hover:text-foreground', collapsed ? 'justify-center px-0' : 'px-3'), children: collapsed ? (_jsx(PanelLeftOpen, { className: "size-4 shrink-0" })) : (_jsxs(_Fragment, { children: [_jsx(PanelLeftClose, { className: "size-4 shrink-0" }), _jsx("span", { className: "min-w-0 flex-1 truncate text-left", children: "Collapse" })] })) })] }));
+}
+//# sourceMappingURL=section-nav.js.map

package/dist/components/section-nav.js.map

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

package/dist/components/section-state.d.ts

@@ -0,0 +1,24 @@
+import type { ReactNode } from 'react';
+import type { SectionAvailability, SectionState } from '@elytracms/studio-core';
+/**
+ * Resolve the runtime state of a section (brief §8.1, §11). A `forced` value
+ * (e.g. from a `?state=` param) wins, making every state reachable
+ * deterministically; otherwise availability decides.
+ */
+export declare function resolveSectionState(availability: SectionAvailability, forced?: SectionState | null): SectionState;
+export interface SectionStateViewProps {
+    state: Exclude<SectionState, 'working'>;
+    /** Section-specific heading, e.g. "CMS" — overrides the generic preset title. */
+    title?: string;
+    description?: ReactNode;
+    action?: ReactNode;
+    className?: string;
+}
+/** Loading uses a skeleton; the rest use a centered placeholder. Consistent across sections. */
+export declare function SectionStateView({ state, title, description, action, className, }: SectionStateViewProps): import("react").JSX.Element;
+/** Shimmer skeleton standing in for an in-flight section load. */
+export declare function SectionSkeleton({ className }: {
+    className?: string;
+}): import("react").JSX.Element;
+/** The full set of forceable states, for fixtures and the state switcher. */
+export declare const FORCEABLE_STATES: readonly SectionState[];

package/dist/components/section-state.js

@@ -0,0 +1,78 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CircleAlert, Clock, Inbox, Loader2, Lock } from 'lucide-react';
+import { Badge, Heading, Stack, Text } from '@elytracms/studio/ui';
+import { cn } from '@elytracms/studio/lib/utils';
+/**
+ * Resolve the runtime state of a section (brief §8.1, §11). A `forced` value
+ * (e.g. from a `?state=` param) wins, making every state reachable
+ * deterministically; otherwise availability decides.
+ */
+export function resolveSectionState(availability, forced) {
+    if (forced)
+        return forced;
+    if (availability === 'planned')
+        return 'planned';
+    if (availability === 'unavailable')
+        return 'unavailable';
+    return 'working';
+}
+const PRESETS = {
+    empty: {
+        icon: Inbox,
+        title: 'Nothing here yet',
+        description: 'This section has no content for the active project.',
+        badge: { label: 'empty', variant: 'outline' },
+    },
+    loading: {
+        icon: Loader2,
+        title: 'Loading…',
+        description: 'Fetching the latest state for this section.',
+        badge: { label: 'loading', variant: 'info' },
+        spin: true,
+    },
+    error: {
+        icon: CircleAlert,
+        title: 'Something went wrong',
+        description: 'This section could not be loaded. Try again in a moment.',
+        badge: { label: 'error', variant: 'error' },
+    },
+    unavailable: {
+        icon: Lock,
+        title: 'Not available',
+        description: 'This section is not available for the active project.',
+        badge: { label: 'unavailable', variant: 'outline' },
+    },
+    planned: {
+        icon: Clock,
+        title: 'Planned',
+        description: 'This surface is planned and not yet enabled for this project.',
+        badge: { label: 'planned', variant: 'warning' },
+    },
+};
+/** Loading uses a skeleton; the rest use a centered placeholder. Consistent across sections. */
+export function SectionStateView({ state, title, description, action, className, }) {
+    if (state === 'loading')
+        return _jsx(SectionSkeleton, { className: className });
+    const preset = PRESETS[state];
+    const Icon = preset.icon;
+    const tone = state === 'error'
+        ? 'border-destructive/30 bg-destructive/5'
+        : state === 'planned'
+            ? 'border-warning/30 bg-warning/5'
+            : 'border-border bg-card/40';
+    return (_jsx("div", { "data-section-state": state, className: cn('grid min-h-[18rem] place-items-center p-8', className), children: _jsxs(Stack, { gap: "3", align: "center", className: cn('max-w-sm rounded-xl border border-dashed px-8 py-10 text-center', tone), children: [_jsx("span", { className: "grid size-11 place-items-center rounded-lg border border-border bg-background text-muted-foreground", children: _jsx(Icon, { className: "size-5" }) }), _jsxs(Stack, { gap: "1", align: "center", children: [_jsx(Heading, { level: 2, size: "h3", children: title ?? preset.title }), _jsx(Text, { size: "sm", tone: "muted", children: description ?? preset.description })] }), _jsx(Badge, { variant: preset.badge.variant, children: preset.badge.label }), action ? _jsx("div", { className: "pt-1", children: action }) : null] }) }));
+}
+/** Shimmer skeleton standing in for an in-flight section load. */
+export function SectionSkeleton({ className }) {
+    return (_jsxs("div", { "data-section-state": "loading", className: cn('space-y-4 p-6', className), "aria-busy": true, children: [_jsx("div", { className: "h-7 w-48 animate-pulse rounded-md bg-muted" }), _jsx("div", { className: "grid gap-3 sm:grid-cols-2 lg:grid-cols-3", children: Array.from({ length: 6 }).map((_, i) => (_jsx("div", { className: "h-28 animate-pulse rounded-xl bg-muted/70" }, i))) })] }));
+}
+/** The full set of forceable states, for fixtures and the state switcher. */
+export const FORCEABLE_STATES = [
+    'working',
+    'empty',
+    'loading',
+    'error',
+    'unavailable',
+    'planned',
+];
+//# sourceMappingURL=section-state.js.map

package/dist/components/section-state.js.map

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

package/dist/components/section-surface.d.ts

@@ -0,0 +1,31 @@
+import type { ReactNode } from 'react';
+import type { Project, ProjectId, SectionId, SectionState } from '@elytracms/studio-core';
+/** Parse a `?state=` search param into a SectionState (undefined when absent/invalid). */
+export declare function parseSectionState(raw: unknown): SectionState | undefined;
+export interface SectionSurfaceProps {
+    project: Project;
+    section: SectionId;
+    /** Forced state from `?state=`; overrides availability. */
+    forcedState?: SectionState;
+    /** Working-state content. When omitted, a phase placeholder is shown. */
+    children?: ReactNode;
+}
+/**
+ * Resolves a section's deterministic state (brief §8.1, §11) and renders it: the
+ * working content (or a phase placeholder) when `working`, else a consistent
+ * state view. A small state switcher makes every state reachable for inspection.
+ */
+export declare function SectionSurface({ project, section, forcedState, children }: SectionSurfaceProps): import("react").JSX.Element;
+/** Placeholder for an available section whose live surface lands in a later phase. */
+export declare function PhasePlaceholder({ section }: {
+    section: SectionId;
+}): import("react").JSX.Element;
+/**
+ * Deterministic state switcher (brief §11). Links to the same section with each
+ * `?state=` value so agents/humans can reproduce every state by URL or click.
+ */
+export declare function StateSwitcher({ projectId, section, current, }: {
+    projectId: ProjectId;
+    section: SectionId;
+    current?: SectionState;
+}): import("react").JSX.Element;

package/dist/components/section-surface.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Link, STUDIO_PROJECT_ROUTE } from '@elytracms/studio/router';
+import { ArrowUpRight } from 'lucide-react';
+import { availabilityOf, sectionStateSchema } from '@elytracms/studio-core';
+import { Badge, Button, Code, Row, Stack, Text } from '@elytracms/studio/ui';
+import { cn } from '@elytracms/studio/lib/utils';
+import { resolveSectionState, SectionStateView } from './section-state';
+import { sectionNavItem } from './sections';
+/** Parse a `?state=` search param into a SectionState (undefined when absent/invalid). */
+export function parseSectionState(raw) {
+    const parsed = sectionStateSchema.safeParse(raw);
+    return parsed.success ? parsed.data : undefined;
+}
+/**
+ * Resolves a section's deterministic state (brief §8.1, §11) and renders it: the
+ * working content (or a phase placeholder) when `working`, else a consistent
+ * state view. A small state switcher makes every state reachable for inspection.
+ */
+export function SectionSurface({ project, section, forcedState, children }) {
+    const availability = availabilityOf(project.settings.sectionAvailability, section);
+    const state = resolveSectionState(availability, forcedState);
+    return (_jsxs(Stack, { gap: "none", className: "min-h-full", children: [_jsx(StateSwitcher, { projectId: project.id, section: section, current: forcedState }), state === 'working' ? ((children ?? _jsx(PhasePlaceholder, { section: section }))) : (_jsx(SectionStateView, { state: state, title: sectionNavItem(section).label }))] }));
+}
+/** Placeholder for an available section whose live surface lands in a later phase. */
+export function PhasePlaceholder({ section }) {
+    const item = sectionNavItem(section);
+    const Icon = item.icon;
+    return (_jsx("div", { "data-section-state": "working", className: "grid flex-1 place-items-center p-8", children: _jsxs(Stack, { gap: "3", align: "center", className: "max-w-md text-center", children: [_jsx("span", { className: "grid size-12 place-items-center rounded-xl border border-border bg-card text-primary", children: _jsx(Icon, { className: "size-6" }) }), _jsxs(Stack, { gap: "1", align: "center", children: [_jsxs(Text, { weight: "semibold", children: [item.label, " is enabled"] }), _jsxs(Text, { size: "sm", tone: "muted", children: [item.description, " The full surface arrives in ", item.phase, "."] })] }), _jsx(Badge, { variant: "primary", children: item.phase })] }) }));
+}
+/**
+ * Deterministic state switcher (brief §11). Links to the same section with each
+ * `?state=` value so agents/humans can reproduce every state by URL or click.
+ */
+export function StateSwitcher({ projectId, section, current, }) {
+    const states = ['working', 'empty', 'loading', 'error', 'unavailable', 'planned'];
+    const activeKey = current ?? 'default';
+    return (_jsxs(Row, { gap: "1", wrap: true, className: "shrink-0 border-b border-dashed border-border/70 px-4 py-2 sm:px-6", "data-testid": "state-switcher", children: [_jsx(Text, { size: "xs", tone: "subtle", mono: true, className: "mr-1", children: "state" }), _jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: section }, search: {}, className: cn('rounded-md px-2 py-0.5 font-mono text-xs transition-colors', activeKey === 'default'
+                    ? 'bg-accent text-accent-foreground'
+                    : 'text-muted-foreground hover:bg-muted hover:text-foreground'), children: "default" }), states.map((s) => {
+                const active = s === activeKey;
+                return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: section }, search: { state: s }, className: cn('rounded-md px-2 py-0.5 font-mono text-xs transition-colors', active
+                        ? 'bg-accent text-accent-foreground'
+                        : 'text-muted-foreground hover:bg-muted hover:text-foreground'), children: s }, s));
+            }), _jsx(Code, { tone: "muted", className: "ml-2 hidden sm:inline-flex", children: activeKey === 'default' ? 'auto' : `?state=${activeKey}` }), _jsx("span", { className: "flex-1" }), _jsx(Button, { variant: "ghost", size: "sm", asChild: true, className: "hidden md:inline-flex", children: _jsxs(Link, { to: "/", className: "gap-1", children: ["Docs ", _jsx(ArrowUpRight, {})] }) })] }));
+}
+//# sourceMappingURL=section-surface.js.map

package/dist/components/section-surface.js.map

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

package/dist/components/sections.d.ts

@@ -0,0 +1,38 @@
+import type { LucideIcon } from 'lucide-react';
+import type { Project, SectionAvailability, SectionAvailabilityMap, SectionId } from '@elytracms/studio-core';
+/**
+ * App-level navigation ids: the studio-core sections plus surfaces registered
+ * by the app itself. `routes` (EC-170) is the first app-registered surface —
+ * it lives next to the CMS in the rail and rides on the CMS availability,
+ * since routes/redirects are CMS routing concerns (`@elytracms/cms-core`).
+ */
+export type StudioNavId = SectionId | 'routes';
+export interface SectionNavItem {
+    id: StudioNavId;
+    label: string;
+    description: string;
+    icon: LucideIcon;
+    phase: string;
+}
+/** Navigation items in canonical order (brief §8.1 + EC-170). */
+export declare const SECTION_NAV_ITEMS: readonly SectionNavItem[];
+export declare function sectionNavItem(id: StudioNavId): SectionNavItem;
+/**
+ * Availability for a nav id. App-registered surfaces map onto the section
+ * whose data they manage: Routes follows the CMS availability.
+ */
+export declare function navAvailabilityOf(map: SectionAvailabilityMap, id: StudioNavId): SectionAvailability;
+/**
+ * The section a project should open to: the first non-`unavailable` section in
+ * canonical order. Settings is always available, so this never returns null.
+ */
+export declare function firstAvailableSection(project: Project): SectionId;
+/**
+ * Parse the active nav id out of a studio pathname `/$projectId/<section>[/...]`
+ * (incl. the app-registered Routes surface, EC-170). Returns null for the bare
+ * project URL or an unknown segment. The section is the SECOND path segment —
+ * directly after the projectId; there is no `/p` prefix (EC-220). The single
+ * source of truth for active-section detection: the shell breadcrumb and the
+ * nav rail both read it, so the segment index lives in exactly one place.
+ */
+export declare function activeSectionFromPath(pathname: string): StudioNavId | null;

package/dist/components/sections.js

@@ -0,0 +1,72 @@
+import { Blocks, Database, Image, Puzzle, Settings, Signpost } from 'lucide-react';
+import { SECTIONS, SECTION_IDS, availabilityOf, sectionIdSchema } from '@elytracms/studio-core';
+/** Which Studio phase delivers each section's live surface (for placeholders). */
+const SECTION_PHASE = {
+    components: 'Phase 4',
+    cms: 'Phase 6',
+    routes: 'Milestone B',
+    assets: 'Phase 6',
+    extensions: 'Phase 11',
+    settings: 'Phase 2',
+};
+const ICONS = {
+    components: Blocks,
+    cms: Database,
+    routes: Signpost,
+    assets: Image,
+    extensions: Puzzle,
+    settings: Settings,
+};
+/** Descriptor for the app-registered Routes surface (EC-170). */
+const ROUTES_DESCRIPTOR = {
+    id: 'routes',
+    label: 'Routes',
+    description: 'View the resolved URL routes & redirects (defined in elytra.config.ts).',
+};
+/** Canonical nav order: studio-core order with Routes slotted after CMS. */
+const NAV_IDS = SECTION_IDS.flatMap((id) => id === 'cms' ? [id, 'routes'] : [id]);
+function descriptorOf(id) {
+    return id === 'routes' ? ROUTES_DESCRIPTOR : SECTIONS[id];
+}
+/** Navigation items in canonical order (brief §8.1 + EC-170). */
+export const SECTION_NAV_ITEMS = NAV_IDS.map((id) => ({
+    id,
+    label: descriptorOf(id).label,
+    description: descriptorOf(id).description,
+    icon: ICONS[id],
+    phase: SECTION_PHASE[id],
+}));
+export function sectionNavItem(id) {
+    return SECTION_NAV_ITEMS.find((item) => item.id === id);
+}
+/**
+ * Availability for a nav id. App-registered surfaces map onto the section
+ * whose data they manage: Routes follows the CMS availability.
+ */
+export function navAvailabilityOf(map, id) {
+    return availabilityOf(map, id === 'routes' ? 'cms' : id);
+}
+/**
+ * The section a project should open to: the first non-`unavailable` section in
+ * canonical order. Settings is always available, so this never returns null.
+ */
+export function firstAvailableSection(project) {
+    const found = SECTION_IDS.find((id) => availabilityOf(project.settings.sectionAvailability, id) !== 'unavailable');
+    return found ?? 'settings';
+}
+/**
+ * Parse the active nav id out of a studio pathname `/$projectId/<section>[/...]`
+ * (incl. the app-registered Routes surface, EC-170). Returns null for the bare
+ * project URL or an unknown segment. The section is the SECOND path segment —
+ * directly after the projectId; there is no `/p` prefix (EC-220). The single
+ * source of truth for active-section detection: the shell breadcrumb and the
+ * nav rail both read it, so the segment index lives in exactly one place.
+ */
+export function activeSectionFromPath(pathname) {
+    const segment = pathname.split('/')[2] ?? '';
+    if (segment === 'routes')
+        return 'routes';
+    const parsed = sectionIdSchema.safeParse(segment);
+    return parsed.success ? parsed.data : null;
+}
+//# sourceMappingURL=sections.js.map

package/dist/components/sections.js.map

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