@cosmoops/connect-sdk 0.7.0 → 0.15.0

package/dist/esm/client/components/ai-widgets.js

@@ -0,0 +1,223 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { Button } from "@heroui/react";
+import { ArrowDown, ArrowUp, ChevronsUpDown, Download, ExternalLink, FileText, Minus, TrendingDown, TrendingUp } from "lucide-react";
+import { AI_EMPTY_VALUE, AI_TONE_CHIP, AI_TONE_DOT, aiStatusTone, formatAiValue, isNumericAiFormat, } from "./ai-format.js";
+/**
+ * What Ask AI draws.
+ *
+ * Seven widgets, one per data shape, rendered from the model's own tool call -
+ * see `AiToolName`. Everything here is HeroUI semantic tokens and inline SVG:
+ * **no charting library, no table library, no new dependency**, because this
+ * package ships to partners and a chart library is not a reasonable thing to
+ * make every application platform install for one panel.
+ *
+ * The hand-rolled chart is the deliberate part of that. A 400px side panel does
+ * not need pan, zoom, brushes or animation; it needs axis labels a human can
+ * read and a line that goes where the numbers do. That is ~80 lines of SVG.
+ */
+/** The four small panels share one frame, so an answer with two of them reads as one object. */
+function Panel({ title, children }) {
+    return (_jsxs("figure", { className: "my-3 rounded-lg border border-border p-3", children: [title && _jsx("figcaption", { className: "mb-2 text-xs font-semibold", children: title }), children] }));
+}
+const TONE_TEXT = {
+    neutral: "text-muted",
+    positive: "text-success",
+    warning: "text-warning",
+    danger: "text-danger",
+};
+function StatusChip({ value }) {
+    return (_jsx("span", { className: `inline-block rounded-full px-1.5 py-0.5 text-[10px] font-medium ${AI_TONE_CHIP[aiStatusTone(value)]}`, children: String(value) }));
+}
+/* ------------------------------------------------------------------ table */
+/**
+ * `showTable`. Sorting and CSV are what a table is *for* - once an answer is
+ * tabular the next thing anyone wants is to reorder it or take it elsewhere,
+ * and a markdown table can do neither. Both work off the raw values, so
+ * "₹12,500" sorts as 12500 and the export carries numbers a spreadsheet can add.
+ */
+export function AiTable({ title, columns, rows, caption }) {
+    // By column *index*: rows are positional (see `AiTableInput`), so the index
+    // is the only identity a column has.
+    const [sort, setSort] = useState(null);
+    const sorted = useMemo(() => {
+        if (!sort)
+            return rows;
+        const direction = sort.direction === "asc" ? 1 : -1;
+        return [...rows].sort((a, b) => {
+            const left = a[sort.column];
+            const right = b[sort.column];
+            // Missing values sink in both directions. The alternative is empty rows
+            // migrating to the top when you reverse a column, which reads as data
+            // appearing out of nowhere.
+            if (left === null || left === undefined)
+                return 1;
+            if (right === null || right === undefined)
+                return -1;
+            if (typeof left === "number" && typeof right === "number")
+                return (left - right) * direction;
+            return String(left).localeCompare(String(right)) * direction;
+        });
+    }, [rows, sort]);
+    const downloadCsv = () => {
+        const escape = (value) => `"${String(value ?? "").replaceAll('"', '""')}"`;
+        const csv = [
+            columns.map((column) => escape(column.label)).join(","),
+            ...sorted.map((row) => columns.map((_column, index) => escape(row[index])).join(",")),
+        ].join("\n");
+        const url = URL.createObjectURL(new Blob([csv], { type: "text/csv;charset=utf-8" }));
+        const link = document.createElement("a");
+        link.href = url;
+        link.download = `${(title ?? "table").toLowerCase().replaceAll(/[^a-z0-9]+/g, "-")}.csv`;
+        link.click();
+        URL.revokeObjectURL(url);
+    };
+    const toggleSort = (column) => setSort((current) => current?.column === column
+        ? current.direction === "asc"
+            ? { column, direction: "desc" }
+            : null
+        : { column, direction: "asc" });
+    return (_jsxs("figure", { className: "my-3 overflow-hidden rounded-lg border border-border", children: [_jsxs("div", { className: "flex items-center gap-2 border-b border-border bg-surface-secondary px-3 py-2", children: [_jsx("figcaption", { className: "flex-1 truncate text-xs font-semibold", children: title ?? "Results" }), _jsxs("span", { className: "text-[11px] text-muted", children: [rows.length, " rows"] }), _jsx(Button, { isIconOnly: true, size: "sm", variant: "tertiary", "aria-label": "Download as CSV", onPress: downloadCsv, children: _jsx(Download, { className: "size-3.5" }) })] }), _jsx("div", { className: "overflow-x-auto", children: _jsxs("table", { className: "w-full text-xs", children: [_jsx("thead", { children: _jsx("tr", { className: "border-b border-border", children: columns.map((column, columnIndex) => {
+                                    const isSorted = sort?.column === columnIndex;
+                                    const Icon = !isSorted ? ChevronsUpDown : sort.direction === "asc" ? ArrowUp : ArrowDown;
+                                    return (_jsx("th", { scope: "col", className: "p-0", children: _jsxs("button", { type: "button", onClick: () => toggleSort(columnIndex), "aria-label": `Sort by ${column.label}`, className: `flex w-full items-center gap-1 px-2.5 py-1.5 font-medium whitespace-nowrap hover:bg-surface-secondary ${isNumericAiFormat(column.format) ? "justify-end" : "justify-start"}`, children: [column.label, _jsx(Icon, { className: `size-3 shrink-0 ${isSorted ? "text-foreground" : "text-muted/60"}` })] }) }, columnIndex));
+                                }) }) }), _jsxs("tbody", { children: [sorted.map((row, index) => (_jsx("tr", { className: "border-b border-border/60 last:border-b-0", children: columns.map((column, columnIndex) => {
+                                        const value = row[columnIndex] ?? null;
+                                        return (_jsx("td", { className: `px-2.5 py-1.5 align-top ${isNumericAiFormat(column.format) ? "text-end tabular-nums" : "text-start"}`, children: column.format === "status" && value !== null ? (_jsx(StatusChip, { value: value })) : (_jsx("span", { className: value === null ? "text-muted" : undefined, children: formatAiValue(value, column.format) })) }, columnIndex));
+                                    }) }, index))), sorted.length === 0 && (_jsx("tr", { children: _jsx("td", { colSpan: columns.length, className: "px-2.5 py-3 text-center text-muted", children: AI_EMPTY_VALUE }) }))] })] }) }), caption && _jsx("p", { className: "border-t border-border px-3 py-1.5 text-[11px] text-muted", children: caption })] }));
+}
+/* ------------------------------------------------------------------ chart */
+/**
+ * The theme's categorical ramp. Series identity is carried by the legend as
+ * well as the hue, never by hue alone.
+ */
+const SERIES_COLORS = [
+    "var(--chart-cat-1, var(--accent))",
+    "var(--chart-cat-2, var(--warning))",
+    "var(--chart-cat-3, var(--success))",
+    "var(--chart-cat-4, var(--danger))",
+    "var(--chart-cat-5, var(--muted))",
+];
+const VIEW_W = 320;
+const VIEW_H = 140;
+const PAD = { top: 8, right: 8, bottom: 20, left: 44 };
+/**
+ * `showChart`. Cartesian kinds are drawn as SVG against a fixed viewBox and
+ * scaled by the browser, which is why there is no resize observer here: the
+ * chart is resolution-independent, so "responsive" costs nothing at runtime.
+ *
+ * `pie` is deliberately *not* a pie. In a 400px column a pie plus its legend
+ * is smaller than the labels it needs, and reading angles is worse than
+ * reading lengths at any size - so proportions render as a labelled bar list,
+ * which answers the same question and stays legible.
+ */
+export function AiChart({ title, kind, xLabel, yLabel, valueFormat, series, caption }) {
+    const format = (value) => formatAiValue(value, valueFormat);
+    const axis = series[0]?.points.map((point) => point.x) ?? [];
+    // Which x the pointer is nearest. An SVG chart is an interactive chart:
+    // without this the exact values are unreadable, because a 140px-tall plot
+    // can only carry three axis labels.
+    const [hovered, setHovered] = useState(null);
+    if (kind === "pie") {
+        const slices = series[0]?.points ?? [];
+        // Guards a divide-by-zero on an all-zero set, which would otherwise make
+        // every bar `NaN%` wide.
+        const total = slices.reduce((sum, point) => sum + (point.y ?? 0), 0) || 1;
+        return (_jsxs(Panel, { title: title, children: [_jsx("ul", { className: "space-y-1.5", children: slices.map((slice, index) => (_jsxs("li", { className: "text-xs", children: [_jsxs("div", { className: "flex items-baseline justify-between gap-2", children: [_jsx("span", { className: "truncate", children: slice.x }), _jsxs("span", { className: "shrink-0 tabular-nums text-muted", children: [format(slice.y ?? 0), " \u00B7 ", Math.round(((slice.y ?? 0) / total) * 100), "%"] })] }), _jsx("div", { className: "mt-0.5 h-1.5 overflow-hidden rounded-full bg-surface-tertiary", children: _jsx("div", { className: "h-full rounded-full", style: {
+                                        width: `${((slice.y ?? 0) / total) * 100}%`,
+                                        backgroundColor: SERIES_COLORS[index % SERIES_COLORS.length],
+                                    } }) })] }, slice.x))) }), caption && _jsx("p", { className: "mt-2 text-[11px] text-muted", children: caption })] }));
+    }
+    const values = series.flatMap((entry) => entry.points.map((point) => point.y)).filter((y) => y !== null);
+    // A flat series would give a zero-height range and divide by zero; padding
+    // the top by 1 draws it as a line across the middle instead of NaN.
+    const max = values.length ? Math.max(...values, 0) : 1;
+    const min = values.length ? Math.min(...values, 0) : 0;
+    const range = max - min || 1;
+    const plotW = VIEW_W - PAD.left - PAD.right;
+    const plotH = VIEW_H - PAD.top - PAD.bottom;
+    const xAt = (index) => PAD.left + (axis.length <= 1 ? plotW / 2 : (index / (axis.length - 1)) * plotW);
+    const yAt = (value) => PAD.top + plotH - ((value - min) / range) * plotH;
+    /** Ticks at the extremes and the midpoint - three labels is all a 140px-tall plot can carry. */
+    const yTicks = [min, min + range / 2, max];
+    // First, middle and last x label only, for the same reason.
+    const xTicks = axis.length <= 3 ? axis.map((_, i) => i) : [0, Math.floor((axis.length - 1) / 2), axis.length - 1];
+    return (_jsxs(Panel, { title: title, children: [_jsxs("div", { className: "relative", children: [hovered !== null && (
+                    // Positioned as a percentage of the plot so it tracks the mark at any
+                    // rendered width - the SVG scales, and this has to scale with it.
+                    _jsxs("div", { className: "pointer-events-none absolute top-0 z-10 -translate-x-1/2 rounded-md border border-border bg-overlay px-2 py-1 text-[10px] shadow-lg", style: { left: `${(xAt(hovered) / VIEW_W) * 100}%` }, children: [_jsx("p", { className: "font-medium", children: axis[hovered] }), series.map((entry, index) => {
+                                const value = entry.points[hovered]?.y;
+                                return (_jsxs("p", { className: "flex items-center gap-1 text-muted", children: [_jsx("span", { className: "size-1.5 shrink-0 rounded-full", style: { backgroundColor: SERIES_COLORS[index % SERIES_COLORS.length] }, "aria-hidden": true }), _jsx("span", { className: "tabular-nums", children: value === null || value === undefined ? AI_EMPTY_VALUE : format(value) })] }, entry.name));
+                            })] })), _jsxs("svg", { viewBox: `0 0 ${VIEW_W} ${VIEW_H}`, className: "w-full", role: "img", "aria-label": title ?? "Chart", onMouseLeave: () => setHovered(null), children: [yTicks.map((tick) => (_jsxs("g", { children: [_jsx("line", { x1: PAD.left, x2: VIEW_W - PAD.right, y1: yAt(tick), y2: yAt(tick), stroke: "var(--separator)", strokeDasharray: "3 3" }), _jsx("text", { x: PAD.left - 4, y: yAt(tick) + 3, textAnchor: "end", fontSize: "7", fill: "var(--muted)", children: format(tick) })] }, tick))), xTicks.map((index) => (_jsx("text", { x: xAt(index), y: VIEW_H - 6, textAnchor: "middle", fontSize: "7", fill: "var(--muted)", children: axis[index] }, index))), series.map((entry, seriesIndex) => {
+                                const color = SERIES_COLORS[seriesIndex % SERIES_COLORS.length];
+                                if (kind === "bar") {
+                                    const slot = plotW / Math.max(axis.length, 1);
+                                    // A 2px surface gap between adjacent series, so two bars in one
+                                    // slot read as two marks rather than one two-toned block.
+                                    const width = Math.max(2, (slot * 0.7) / series.length - (series.length > 1 ? 2 : 0));
+                                    return entry.points.map((point, index) => point.y === null ? null : (_jsx("rect", { x: xAt(index) - (width * series.length) / 2 + seriesIndex * width, y: Math.min(yAt(point.y), yAt(0)), width: width, height: Math.max(1, Math.abs(yAt(point.y) - yAt(0))), fill: color, rx: "3" }, `${entry.name}-${point.x}`)));
+                                }
+                                // `null` breaks the path into separate segments rather than drawing
+                                // a straight line through a gap that has no data in it.
+                                const segments = [];
+                                let current = [];
+                                entry.points.forEach((point, index) => {
+                                    if (point.y === null) {
+                                        if (current.length)
+                                            segments.push(current.join(" "));
+                                        current = [];
+                                        return;
+                                    }
+                                    current.push(`${current.length ? "L" : "M"}${xAt(index)},${yAt(point.y)}`);
+                                });
+                                if (current.length)
+                                    segments.push(current.join(" "));
+                                return (_jsxs("g", { children: [kind === "area" && segments.length === 1 && (_jsx("path", { d: `${segments[0]} L${xAt(entry.points.length - 1)},${yAt(min)} L${xAt(0)},${yAt(min)} Z`, fill: color, fillOpacity: "0.15" })), segments.map((segment) => (_jsx("path", { d: segment, fill: "none", stroke: color, strokeWidth: "1.5", strokeLinejoin: "round" }, segment)))] }, entry.name));
+                            }), axis.map((label, index) => (_jsx("rect", { x: xAt(index) - plotW / Math.max(axis.length, 1) / 2, y: PAD.top, width: plotW / Math.max(axis.length, 1), height: plotH, fill: "transparent", onMouseEnter: () => setHovered(index) }, label))), hovered !== null && (_jsx("line", { x1: xAt(hovered), x2: xAt(hovered), y1: PAD.top, y2: PAD.top + plotH, stroke: "var(--border)", strokeWidth: "1" }))] })] }), (series.length > 1 || xLabel || yLabel) && (_jsxs("div", { className: "mt-1.5 flex flex-wrap items-center gap-x-3 gap-y-1 text-[10px] text-muted", children: [series.length > 1 &&
+                        series.map((entry, index) => (_jsxs("span", { className: "inline-flex items-center gap-1", children: [_jsx("span", { className: "size-2 rounded-full", style: { backgroundColor: SERIES_COLORS[index % SERIES_COLORS.length] }, "aria-hidden": true }), entry.name] }, entry.name))), yLabel && _jsxs("span", { children: ["y: ", yLabel] }), xLabel && _jsxs("span", { children: ["x: ", xLabel] })] })), caption && _jsx("p", { className: "mt-2 text-[11px] text-muted", children: caption })] }));
+}
+/* ----------------------------------------------------------------- panels */
+/**
+ * `showMetrics`. A delta is coloured by `deltaMeaning`, not by its sign -
+ * churn rising is bad and revenue rising is good, and painting both green
+ * because the arrow points up is exactly the confidently-wrong signal a
+ * dashboard must never send. The arrow still shows direction, so meaning and
+ * direction stay two separate channels.
+ */
+export function AiMetrics({ title, metrics }) {
+    return (_jsx(Panel, { title: title, children: _jsx("div", { className: "grid grid-cols-2 gap-2", children: metrics.map((metric) => {
+                const delta = metric.delta ?? null;
+                const rising = delta !== null && delta > 0;
+                const Arrow = delta === null || delta === 0 ? Minus : rising ? TrendingUp : TrendingDown;
+                const good = metric.deltaMeaning === "neutral" || delta === null || delta === 0
+                    ? null
+                    : metric.deltaMeaning === "up-is-good"
+                        ? rising
+                        : !rising;
+                return (_jsxs("div", { className: "rounded-md bg-surface-secondary p-2.5", children: [_jsx("p", { className: "truncate text-[11px] text-muted", children: metric.label }), _jsx("p", { className: "mt-0.5 text-base font-semibold tabular-nums", children: formatAiValue(metric.value, metric.format) }), delta !== null && (_jsxs("p", { className: `mt-0.5 flex items-center gap-0.5 text-[11px] tabular-nums ${good === null ? "text-muted" : good ? "text-success" : "text-danger"}`, children: [_jsx(Arrow, { className: "size-3", "aria-hidden": true }), formatAiValue(Math.abs(delta), "percent")] })), metric.hint && _jsx("p", { className: "mt-0.5 text-[10px] text-muted", children: metric.hint })] }, metric.label));
+            }) }) }));
+}
+/** `showTimeline`: dated events, oldest first, on a single rail. */
+export function AiTimeline({ title, events }) {
+    return (_jsx(Panel, { title: title, children: _jsxs("ol", { className: "relative space-y-3 ps-4", children: [_jsx("span", { className: "absolute inset-y-1 start-1 w-px bg-border", "aria-hidden": true }), events.map((event, index) => (_jsxs("li", { className: "relative", children: [_jsx("span", { className: `absolute -start-4 top-1 size-2 rounded-full ring-2 ring-surface ${AI_TONE_DOT[event.tone]}`, "aria-hidden": true }), _jsx("p", { className: "text-[11px] text-muted", children: formatAiValue(event.at, "datetime") }), _jsx("p", { className: "text-xs font-medium", children: event.title }), event.detail && _jsx("p", { className: "text-xs text-muted", children: event.detail })] }, `${event.at}-${index}`)))] }) }));
+}
+/** `showDetails`: one entity's fields, as a definition list rather than a one-row table. */
+export function AiDetails({ title, fields }) {
+    return (_jsx(Panel, { title: title, children: _jsx("dl", { className: "divide-y divide-border/60", children: fields.map((field) => (_jsxs("div", { className: "flex gap-3 py-1.5 first:pt-0 last:pb-0", children: [_jsx("dt", { className: "w-2/5 shrink-0 text-xs text-muted", children: field.label }), _jsx("dd", { className: `min-w-0 flex-1 text-xs break-words ${TONE_TEXT[field.tone]}`, children: field.format === "status" && field.value !== null ? (_jsx(StatusChip, { value: field.value })) : (formatAiValue(field.value, field.format)) })] }, field.label))) }) }));
+}
+/** `showSteps`: an ordered procedure. `renderDetail` is how the panel feeds each step back through its markdown renderer. */
+export function AiSteps({ title, steps, renderDetail, }) {
+    return (_jsx(Panel, { title: title, children: _jsx("ol", { className: "space-y-2.5", children: steps.map((step, index) => (_jsxs("li", { className: "flex gap-2.5", children: [_jsx("span", { className: "mt-0.5 flex size-5 shrink-0 items-center justify-center rounded-full bg-accent/12 text-[10px] font-semibold text-accent", children: index + 1 }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "text-xs font-medium", children: step.title }), step.detail && (_jsx("div", { className: "mt-0.5 text-xs text-muted", children: renderDetail ? renderDetail(step.detail) : _jsx("span", { className: "whitespace-pre-wrap", children: step.detail }) }))] })] }, step.title))) }) }));
+}
+/**
+ * `showSources`: what a grounded answer actually rested on. The point of a
+ * citation is that it can be opened, so a source with a `uri` is a link and one
+ * without is still a named row - never a marker with nothing behind it.
+ */
+export function AiSources({ sources }) {
+    return (_jsxs("figure", { className: "my-3 rounded-lg border border-border bg-surface-secondary p-2.5", children: [_jsx("figcaption", { className: "mb-1.5 text-[11px] font-semibold tracking-wide text-muted uppercase", children: "Sources" }), _jsx("ul", { className: "space-y-1.5", children: sources.map((source, index) => {
+                    const label = (_jsxs(_Fragment, { children: [_jsx(FileText, { className: "mt-0.5 size-3 shrink-0 text-muted", "aria-hidden": true }), _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-xs font-medium", children: source.title }), source.snippet && _jsxs("span", { className: "mt-0.5 block text-[11px] text-muted italic", children: ["\u201C", source.snippet, "\u201D"] })] })] }));
+                    return (_jsx("li", { children: source.uri ? (_jsxs("a", { href: source.uri, target: "_blank", rel: "noopener noreferrer", className: "flex gap-1.5 rounded-sm hover:underline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus", children: [label, _jsx(ExternalLink, { className: "mt-0.5 size-3 shrink-0 text-muted", "aria-hidden": true })] })) : (_jsx("span", { className: "flex gap-1.5", children: label })) }, `${source.uri ?? source.title}-${index}`));
+                }) })] }));
+}

package/dist/esm/client/components/app-shell.js

@@ -1,16 +1,21 @@
 "use client";
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useCallback, useState, useSyncExternalStore } from "react";
-import { Button, Drawer, Tooltip } from "@heroui/react";
-import { Menu, PanelLeftClose, PanelLeftOpen } from "lucide-react";
+import { useCallback, useMemo, useState, useSyncExternalStore } from "react";
+import { Button, Drawer } from "@heroui/react";
+import { Menu } from "lucide-react";
 import { useConnect } from "../provider.js";
 import { ConnectAccessGate } from "./access-gate.js";
 import { ConnectAppsGrid } from "./apps-grid.js";
+import { ConnectAskAi } from "./ask-ai.js";
 import { ConnectLoginButton, ConnectRegisterButton } from "./auth-buttons.js";
 import { ConnectLogo } from "./logo.js";
-import { ConnectSideNav, defaultRenderLink } from "./side-nav.js";
-import { ConnectUserMenu } from "./user-menu.js";
-import { gateExemptPaths, normalizePath, } from "./nav.js";
+import { MotionProvider } from "./motion.js";
+import { ConnectSidebar, ConnectSidebarBody, ConnectSidebarFooter, ConnectSidebarHeader, } from "./sidebar.js";
+import { ConnectSidebarNav } from "./side-nav.js";
+import { ConnectShellProvider, defaultRenderLink } from "./shell-context.js";
+import { ConnectWorkspaceSwitcher } from "./workspace-switcher.js";
+import { ConnectUserButton } from "./user-menu.js";
+import { filterNavForAudience, gateExemptPaths, normalizePath, } from "./nav.js";
 import { useActivePath } from "../use-active-path.js";
 const COLLAPSED_KEY = "connect_sidenav_collapsed";
 const COLLAPSED_EVENT = "connect:sidenav-collapsed";
@@ -33,7 +38,7 @@ function collapsedSnapshot() {
 /**
  * No preference on the server, which is the point: `useSyncExternalStore` uses
  * this for the hydrating render and only then swaps in the real reading, so a
- * returning user's collapsed rail can never make the server's HTML and the
+ * returning user's rail state can never make the server's HTML and the
  * client's first pass disagree. Reading storage during render instead is a
  * hydration mismatch waiting for its first user.
  */
@@ -51,65 +56,73 @@ function subscribeCollapsed(onStoreChange) {
     };
 }
 /**
- * The sidebar's brand row: the lockup when expanded, the badge alone when not.
- */
-function BrandLink({ name, icon, homeHref, collapsed, renderLink, }) {
-    return renderLink({
-        href: homeHref,
-        className: `flex items-center rounded-lg focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-focus ${collapsed ? "justify-center" : ""}`,
-        // `ConnectLogo` names itself, but it does it with `role="img"` on a
-        // `<span>`, which the `<a>` wrapping it does not inherit as its own name.
-        "aria-label": `${name} home`,
-        children: _jsx(ConnectLogo, { name: name, icon: icon, collapsed: collapsed }),
-    });
-}
-/**
- * The application frame every CosmoOps application platform runs inside: a
- * collapsible sidebar, a top bar carrying the app launcher and the account
- * menu, and your pages in the middle.
+ * The application frame every CosmoOps application platform runs inside: one
+ * rail down the side holding the brand, the workspace, the navigation and the
+ * account, and your pages in the rest.
  *
  * This is the piece each partner was otherwise writing by hand, and writing
- * slightly differently - which is how a family of applications stops looking like
- * one product. Everything that should be identical across platforms (the
- * lockup, the rail geometry, the active-route treatment, the launcher, the
- * account menu, the access gate) lives here; everything that genuinely
- * differs is a prop:
+ * slightly differently - which is how a family of applications stops looking
+ * like one product. Everything that should be identical across platforms
+ * lives here; everything that genuinely differs is a prop:
  *
  * ```tsx
  * "use client";
  * import Link from "next/link";
  * import { usePathname } from "next/navigation";
- * import { ConnectAppShell } from "@cosmoops/connect-sdk/client";
- * import { LayoutDashboard, Truck } from "lucide-react";
+ * import { AppShell } from "@cosmoops/connect-sdk/client";
+ * import { LayoutDashboard, Settings, Truck } from "lucide-react";
  *
  * export function Shell({ children }: { children: React.ReactNode }) {
  *   return (
- *     <ConnectAppShell
+ *     <AppShell
  *       name="Dispatch"
  *       icon={<Truck />}
  *       activePath={usePathname()}
  *       renderLink={(props) => <Link {...props} />}
  *       nav={[
  *         { label: "Overview", href: "/", icon: <LayoutDashboard className="size-5" /> },
- *         { label: "Plans", href: "/plans", icon: <Truck className="size-5" />, gateExempt: true },
+ *         { label: "Shipments", href: "/shipments", icon: <Truck className="size-5" /> },
+ *       ]}
+ *       secondaryNav={[
+ *         { label: "Settings", href: "/settings", icon: <Settings className="size-5" /> },
  *       ]}
  *     >
  *       {children}
- *     </ConnectAppShell>
+ *     </AppShell>
  *   );
  * }
  * ```
  *
+ * **There is no top bar.** There used to be one, carrying a page title, the
+ * launcher and the account menu - and it was a second, half-width strip of
+ * chrome saying things the rail was better placed to say. The launcher and
+ * the account row moved into the rail's footer, where they are one press from
+ * wherever the pointer already is; the page title moved into the page, where
+ * `ConnectPageShell` renders it next to that page's own actions and
+ * breadcrumbs. What is left is a single column of chrome and a full-height
+ * content pane, which is what every application this shell is modelled on
+ * settled at.
+ *
+ * The one exception is below `md`, where a slim bar carries the drawer
+ * trigger. A phone has no rail to put it in, and a navigation you cannot open
+ * is not a smaller navigation.
+ *
+ * **The rail starts collapsed.** `defaultCollapsed` is `true`: the icon rail
+ * is the resting state, and expanding is the deliberate act. That is the right
+ * default because the rail's job is to be *there*, not to be read - a person
+ * learns five glyphs in a day and then wants the 200px back for their data.
+ * A stored preference from the user's last visit always wins over it.
+ *
  * There is no `isSignedIn` branch anywhere in here, and there should be none
- * in yours: the auth buttons render nothing once a session exists, the user
- * menu renders nothing without one, and the launcher renders nothing when
+ * in yours: the auth buttons render nothing once a session exists, the account
+ * row renders nothing without one, and the launcher renders nothing when
  * signed out. The swap happens inside the components.
  *
  * It renders no provider of its own - mount `ConnectProvider` above it, once,
  * so a page with a shell, a plan table and a usage meter still makes one
  * session read.
  */
-export function ConnectAppShell({ name, icon, homeHref = "/", nav, activePath, renderLink = defaultRenderLink, title, headerActions, sidebarFooter, footer, defaultCollapsed = false, collapsed: controlledCollapsed, onCollapsedChange, collapsible = true, showAppsGrid = true, showAuthButtons = true, theme, onThemeChange, gate = true, gateExemptRoutes, className, contentClassName, children, }) {
+export function AppShell({ name, icon, homeHref = "/", nav, secondaryNav, activePath, renderLink = defaultRenderLink, sidebarFooter, workspaceSwitcher, footer, defaultCollapsed = true, collapsed: controlledCollapsed, onCollapsedChange, collapsible = true, showAppsGrid = true, showAuthButtons = true, theme, onThemeChange, gate = true, gateExemptRoutes, askAi = true, className, contentClassName, children, }) {
     const { session, isLoading } = useConnect();
     const pathname = useActivePath(activePath);
     const [mobileOpen, setMobileOpen] = useState(false);
@@ -119,8 +132,7 @@ export function ConnectAppShell({ name, icon, homeHref = "/", nav, activePath, r
     const stored = useSyncExternalStore(subscribeCollapsed, collapsedSnapshot, serverCollapsedSnapshot);
     const isControlled = controlledCollapsed !== undefined;
     const collapsed = collapsible ? (isControlled ? controlledCollapsed : (stored ?? defaultCollapsed)) : false;
-    const toggleCollapsed = useCallback(() => {
-        const next = !collapsed;
+    const setCollapsed = useCallback((next) => {
         onCollapsedChange?.(next);
         if (isControlled)
             return;
@@ -131,24 +143,47 @@ export function ConnectAppShell({ name, icon, homeHref = "/", nav, activePath, r
             // Not persisted - but the event below still moves the rail for this session.
         }
         window.dispatchEvent(new Event(COLLAPSED_EVENT));
-    }, [collapsed, isControlled, onCollapsedChange]);
+    }, [isControlled, onCollapsedChange]);
     const closeMobile = useCallback(() => setMobileOpen(false), []);
+    // Connect platform staff see a different set of routes - see
+    // `ConnectNavItem.audience`. Derived from the session rather than passed in,
+    // so a host app never has to thread "is this an operator" through its own
+    // layout to get the right rail.
+    const isStaff = session?.staff === true;
+    const visibleNav = useMemo(() => filterNavForAudience(nav, isStaff), [nav, isStaff]);
+    const visibleSecondaryNav = useMemo(() => (secondaryNav ? filterNavForAudience(secondaryNav, isStaff) : undefined), [secondaryNav, isStaff]);
     const currentPath = normalizePath(pathname);
-    const exempt = [...gateExemptPaths(nav), ...(gateExemptRoutes ?? []).map(normalizePath)];
+    // Computed from the *unfiltered* nav on purpose: `gateExempt` is a fact
+    // about a route, not about who can see it, and reading it from the filtered
+    // list would quietly re-gate a route the moment it became staff-only. Both
+    // navs contribute - a `gateExempt` "Plans" route is just as often in the
+    // secondary group as the primary one.
+    const exempt = [
+        ...gateExemptPaths(nav),
+        ...(secondaryNav ? gateExemptPaths(secondaryNav) : []),
+        ...(gateExemptRoutes ?? []).map(normalizePath),
+    ];
     const isExempt = exempt.some((path) => currentPath === path || currentPath.startsWith(`${path}/`));
     // A signed-out visitor has no readiness to check and nothing to be blocked
     // by; `ConnectAccessGate` passes them straight through, but mounting it at
     // all costs an entitlements read that cannot succeed.
     const signedOut = !isLoading && !session?.user;
     const gated = gate && !isExempt && !signedOut;
-    const sideNav = (mobile) => (_jsx(ConnectSideNav, { nav: nav, activePath: pathname, renderLink: renderLink, collapsed: mobile ? false : collapsed, onNavigate: mobile ? closeMobile : undefined }));
-    return (_jsxs("div", { className: `flex h-screen bg-background ${className ?? ""}`, children: [_jsxs("aside", { "aria-label": "Sidebar", className: `hidden shrink-0 flex-col border-r border-border bg-surface transition-[width] duration-200 ease-in-out will-change-[width] md:flex ${collapsed ? "w-16" : "w-64"}`, children: [_jsx("div", { className: `flex h-16 shrink-0 items-center border-b border-border ${collapsed ? "justify-center px-2" : "px-4"}`, children: _jsx(BrandLink, { name: name, icon: icon, homeHref: homeHref, collapsed: collapsed, renderLink: renderLink }) }), _jsx("div", { className: `flex-1 overflow-y-auto py-4 ${collapsed ? "px-2" : "px-3"}`, children: sideNav(false) }), _jsxs("div", { className: `shrink-0 border-t border-border ${collapsed ? "flex flex-col items-center gap-2 p-2" : "flex flex-col gap-2 p-3"}`, children: [!collapsed && sidebarFooter, collapsible && (
-                            // The button goes in as a *direct* child, the way `Modal` and
-                            // `Dropdown` take theirs. `Tooltip.Trigger` renders a wrapper
-                            // `<div>` and puts the props it is given on that div - so an
-                            // `aria-label` passed there names a div nobody can reach and
-                            // leaves this icon-only button with no accessible name at all.
-                            // The wrapper is for trigger elements React Aria cannot drive
-                            // directly; a HeroUI `Button` is not one.
-                            _jsxs(Tooltip, { delay: 200, children: [_jsx(Button, { isIconOnly: true, variant: "tertiary", size: "sm", "aria-label": collapsed ? "Expand sidebar" : "Collapse sidebar", className: collapsed ? "" : "self-start", onPress: toggleCollapsed, children: collapsed ? _jsx(PanelLeftOpen, { className: "size-4" }) : _jsx(PanelLeftClose, { className: "size-4" }) }), _jsx(Tooltip.Content, { placement: "right", children: collapsed ? "Expand sidebar" : "Collapse sidebar" })] }))] })] }), _jsx(Drawer.Backdrop, { isOpen: mobileOpen, onOpenChange: setMobileOpen, children: _jsx(Drawer.Content, { placement: "left", className: "w-72 max-w-[80vw]", children: _jsxs(Drawer.Dialog, { "aria-label": "Navigation menu", children: [_jsx(Drawer.CloseTrigger, {}), _jsx(Drawer.Header, { children: _jsx(Drawer.Heading, { "aria-label": name, children: _jsx(ConnectLogo, { name: name, icon: icon }) }) }), _jsx(Drawer.Body, { children: sideNav(true) }), sidebarFooter && _jsx(Drawer.Footer, { className: "flex flex-col items-stretch gap-3", children: sidebarFooter })] }) }) }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col", children: [_jsxs("header", { className: "flex h-16 shrink-0 items-center gap-3 border-b border-border bg-surface px-4 md:px-6", children: [_jsx(Button, { isIconOnly: true, variant: "tertiary", size: "sm", className: "md:hidden", "aria-label": "Open navigation menu", onPress: () => setMobileOpen(true), children: _jsx(Menu, { className: "size-5" }) }), typeof title === "string" ? (_jsx("h1", { className: "truncate text-lg font-semibold text-foreground", children: title })) : (title), _jsxs("div", { className: "ml-auto flex items-center gap-1", children: [headerActions, showAppsGrid && _jsx(ConnectAppsGrid, {}), _jsx(ConnectUserMenu, { compact: true, theme: theme, onThemeChange: onThemeChange }), showAuthButtons && (_jsxs(_Fragment, { children: [_jsx(ConnectLoginButton, { size: "sm" }), _jsx(ConnectRegisterButton, { size: "sm" })] }))] })] }), _jsx("main", { className: "flex-1 overflow-y-auto", children: _jsxs("div", { className: contentClassName ?? "mx-auto w-full max-w-6xl px-4 py-6 md:px-6 md:py-8", children: [gated ? _jsx(ConnectAccessGate, { children: children }) : children, footer] }) })] })] }));
+    // Two shell contexts, one set of children. The drawer's is always expanded
+    // and closes itself on navigation; the rail's carries the real collapse
+    // state. Building them here rather than inside the sidebar is what lets the
+    // same `railContent` render in both places with no `mobile` prop threaded
+    // through every part.
+    const railShell = useMemo(() => ({ collapsed, collapsible, setCollapsed, renderLink, activePath }), [collapsed, collapsible, setCollapsed, renderLink, activePath]);
+    const drawerShell = useMemo(() => ({
+        collapsed: false,
+        collapsible: false,
+        setCollapsed: () => { },
+        renderLink,
+        activePath,
+        onNavigate: closeMobile,
+    }), [renderLink, activePath, closeMobile]);
+    const accountRow = signedOut ? (showAuthButtons && (_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(ConnectLoginButton, { size: "sm", fullWidth: true }), _jsx(ConnectRegisterButton, { size: "sm", fullWidth: true })] }))) : (_jsx(ConnectUserButton, { variant: "row", theme: theme, onThemeChange: onThemeChange }));
+    const railContent = (_jsxs(_Fragment, { children: [_jsx(ConnectSidebarHeader, { name: name, icon: icon, homeHref: homeHref }), workspaceSwitcher !== false && (_jsx("div", { className: "shrink-0 px-3 pb-1", children: _jsx(ConnectWorkspaceSwitcher, {}) })), _jsx(ConnectSidebarBody, { children: _jsx(ConnectSidebarNav, { nav: visibleNav }) }), (visibleSecondaryNav || sidebarFooter || showAppsGrid) && (_jsxs(ConnectSidebarFooter, { separated: false, children: [visibleSecondaryNav && _jsx(ConnectSidebarNav, { nav: visibleSecondaryNav }), sidebarFooter, showAppsGrid && _jsx(ConnectAppsGrid, { variant: "row" })] })), accountRow && _jsx(ConnectSidebarFooter, { children: accountRow })] }));
+    return (_jsx(MotionProvider, { children: _jsxs("div", { className: `flex h-screen bg-background ${className ?? ""}`, children: [_jsx(ConnectShellProvider, { value: railShell, children: _jsx(ConnectSidebar, { children: railContent }) }), _jsx(Drawer.Backdrop, { isOpen: mobileOpen, onOpenChange: setMobileOpen, children: _jsx(Drawer.Content, { placement: "left", className: "w-[min(20rem,85vw)]", children: _jsx(Drawer.Dialog, { "aria-label": "Navigation menu", className: "p-0", children: _jsx(ConnectShellProvider, { value: drawerShell, children: _jsx("div", { className: "flex h-full flex-col", children: railContent }) }) }) }) }), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col", children: [_jsxs("header", { className: "flex h-14 shrink-0 items-center gap-2 border-b border-border bg-surface px-3 md:hidden", children: [_jsx(Button, { isIconOnly: true, variant: "tertiary", size: "sm", "aria-label": "Open navigation menu", onPress: () => setMobileOpen(true), children: _jsx(Menu, { className: "size-5" }) }), _jsx(ConnectLogo, { name: name, icon: icon })] }), _jsx("main", { className: "flex-1 overflow-y-auto", children: _jsxs("div", { className: contentClassName ?? "mx-auto w-full max-w-6xl px-4 py-6 md:px-8 md:py-8", children: [gated ? _jsx(ConnectAccessGate, { children: children }) : children, footer] }) })] }), askAi && _jsx(ConnectAskAi, { ...(askAi === true ? {} : askAi) })] }) }));
 }

package/dist/esm/client/components/apps-grid.js

@@ -4,6 +4,7 @@ import { Button, Modal, Skeleton } from "@heroui/react";
 import { AlertCircle, ExternalLink, LayoutGrid } from "lucide-react";
 import { useConnectApps, useConnect } from "../provider.js";
 import { ENTER, m, MotionProvider } from "./motion.js";
+import { SidebarLabel, sidebarRowClass } from "./shell-context.js";
 function AppTile({ app }) {
     const disabled = app.launchUrl === null;
     const body = (_jsxs(_Fragment, { children: [_jsxs("span", { className: "relative flex size-12 items-center justify-center overflow-hidden rounded-xl bg-surface-secondary", children: [app.iconUrl ? (
@@ -30,13 +31,13 @@ function AppTile({ app }) {
  * Renders nothing when signed out: a launcher with nothing to launch is just a
  * button that opens an empty box.
  */
-export function ConnectAppsGrid({ className, label = "Switch app" }) {
+export function ConnectAppsGrid({ className, label = "Switch app", variant = "row" }) {
     const { session, isLoading: sessionLoading } = useConnect();
     const { data, isLoading, error } = useConnectApps();
     if (sessionLoading || !session?.user)
         return null;
     const apps = data?.apps ?? [];
-    return (_jsx(MotionProvider, { children: _jsxs(Modal, { children: [_jsx(Button, { isIconOnly: true, variant: "primary", "aria-label": label, className: className, children: _jsx(LayoutGrid, { className: "size-5" }) }), _jsx(Modal.Backdrop, { children: _jsx(Modal.Container, { children: _jsxs(Modal.Dialog, { className: "sm:max-w-md", children: [_jsx(Modal.CloseTrigger, {}), _jsx(Modal.Header, { children: _jsx(Modal.Heading, { children: "Your apps" }) }), _jsxs(Modal.Body, { children: [isLoading && (_jsx("div", { className: "grid grid-cols-3 gap-2", children: Array.from({ length: 6 }, (_, index) => (_jsxs("div", { className: "flex flex-col items-center gap-2 p-3", children: [_jsx(Skeleton, { className: "size-12 rounded-xl" }), _jsx(Skeleton, { className: "h-3 w-14" })] }, index))) })), !isLoading && error && (_jsx("p", { className: "py-6 text-center text-sm text-danger", children: "Could not load your apps." })), !isLoading && !error && apps.length === 0 && (_jsx("p", { className: "py-6 text-center text-sm text-muted", children: "No other apps yet. Anything this workspace subscribes to shows up here." })), !isLoading && !error && apps.length > 0 && (_jsx(m.div, { className: "grid grid-cols-3 gap-2", variants: { show: { transition: { staggerChildren: 0.04 } } }, initial: "hidden", animate: "show", children: apps.map((app) => (_jsx(m.div, { variants: { hidden: { opacity: 0, y: 8 }, show: { opacity: 1, y: 0, transition: ENTER } }, children: _jsx(AppTile, { app: app }) }, app.applicationId))) }))] }), _jsx(Modal.Footer, { children: _jsx(ConnectBrowseAllLink, {}) })] }) }) })] }) }));
+    return (_jsx(MotionProvider, { children: _jsxs(Modal, { children: [variant === "row" ? (_jsxs(Button, { variant: "tertiary", "aria-label": label, className: sidebarRowClass({ className }), children: [_jsx("span", { className: "flex size-5 shrink-0 items-center justify-center", children: _jsx(LayoutGrid, { className: "size-5" }) }), _jsx(SidebarLabel, { children: label })] })) : (_jsx(Button, { isIconOnly: true, variant: "primary", "aria-label": label, className: className, children: _jsx(LayoutGrid, { className: "size-5" }) })), _jsx(Modal.Backdrop, { children: _jsx(Modal.Container, { children: _jsxs(Modal.Dialog, { className: "sm:max-w-md", children: [_jsx(Modal.CloseTrigger, {}), _jsx(Modal.Header, { children: _jsx(Modal.Heading, { children: "Your apps" }) }), _jsxs(Modal.Body, { children: [isLoading && (_jsx("div", { className: "grid grid-cols-3 gap-2", children: Array.from({ length: 6 }, (_, index) => (_jsxs("div", { className: "flex flex-col items-center gap-2 p-3", children: [_jsx(Skeleton, { className: "size-12 rounded-xl" }), _jsx(Skeleton, { className: "h-3 w-14" })] }, index))) })), !isLoading && error && (_jsx("p", { className: "py-6 text-center text-sm text-danger", children: "Could not load your apps." })), !isLoading && !error && apps.length === 0 && (_jsx("p", { className: "py-6 text-center text-sm text-muted", children: "No other apps yet. Anything this workspace subscribes to shows up here." })), !isLoading && !error && apps.length > 0 && (_jsx(m.div, { className: "grid grid-cols-3 gap-2", variants: { show: { transition: { staggerChildren: 0.04 } } }, initial: "hidden", animate: "show", children: apps.map((app) => (_jsx(m.div, { variants: { hidden: { opacity: 0, y: 8 }, show: { opacity: 1, y: 0, transition: ENTER } }, children: _jsx(AppTile, { app: app }) }, app.applicationId))) }))] }), _jsx(Modal.Footer, { children: _jsx(ConnectBrowseAllLink, {}) })] }) }) })] }) }));
 }
 function ConnectBrowseAllLink() {
     const { appUrl } = useConnect();