@pilotiq/pilotiq 0.1.0

package/dist/react/NotificationBell.js

@@ -0,0 +1,273 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
+import { DropdownMenu, DropdownMenuContent, DropdownMenuTrigger, } from './ui/dropdown-menu.js';
+import { useNavigate } from './navigate.js';
+import { useIconFor } from './icon-context.js';
+import { cn } from './utils.js';
+import { NotificationActionStrip } from './NotificationActionStrip.js';
+import { useToast } from './Toaster.js';
+const BADGE_COLOR = {
+    default: 'bg-muted text-muted-foreground',
+    primary: 'bg-primary text-primary-foreground',
+    success: 'bg-emerald-500 text-white',
+    warning: 'bg-amber-500   text-white',
+    destructive: 'bg-red-500     text-white',
+    info: 'bg-sky-500     text-white',
+};
+const TYPE_DOT = {
+    info: 'bg-sky-500',
+    success: 'bg-emerald-500',
+    warning: 'bg-amber-500',
+    error: 'bg-red-500',
+};
+/**
+ * Bell-icon dropdown for `Pilotiq.databaseNotifications()`. Renders
+ * nothing when `meta` is absent — `panelInfo()` only ships the meta
+ * when the panel opted in AND a user resolved.
+ *
+ * Lifecycle:
+ *   - First mount: fetch the current list via `meta.listUrl`.
+ *   - Polling: when `meta.polling > 0`, refetch every N seconds.
+ *     Pauses while `document.visibilityState !== 'visible'` so a
+ *     backgrounded tab doesn't keep tickling the server.
+ *   - Mark-read: optimistic — flips `readAt` immediately, refetches
+ *     after the POST so the unread count rebases against the server.
+ *   - Click-through: when a row carries a `url`, the click marks-read
+ *     + SPA-navigates in the same step.
+ */
+export function NotificationBell({ meta }) {
+    if (!meta)
+        return null;
+    const navigate = useNavigate();
+    const [open, setOpen] = React.useState(false);
+    const [data, setData] = React.useState(null);
+    const [loading, setLoading] = React.useState(false);
+    // ── Fetch helpers ─────────────────────────────────────
+    // Latest-wins seq tracking — same pattern as the global-search
+    // palette / live-form state. A slow first request can't clobber a
+    // fresh second one.
+    const seqRef = React.useRef(0);
+    const latestRef = React.useRef(0);
+    const refetch = React.useCallback(async () => {
+        const seq = ++seqRef.current;
+        setLoading(true);
+        try {
+            const r = await fetch(meta.listUrl, {
+                headers: { Accept: 'application/json' },
+                credentials: 'same-origin',
+            });
+            if (!r.ok)
+                return;
+            const json = await r.json();
+            if (seq < latestRef.current)
+                return;
+            latestRef.current = seq;
+            setData({
+                notifications: json.notifications ?? [],
+                unreadCount: json.unreadCount ?? 0,
+            });
+        }
+        catch { /* network-flake; the next poll retries */ }
+        finally {
+            if (seq >= latestRef.current)
+                setLoading(false);
+        }
+    }, [meta.listUrl]);
+    // ── First mount + polling ────────────────────────────
+    React.useEffect(() => {
+        void refetch();
+    }, [refetch]);
+    React.useEffect(() => {
+        if (meta.polling === null || meta.polling === 0)
+            return;
+        const ms = meta.polling * 1000;
+        const tick = () => {
+            if (typeof document !== 'undefined' && document.visibilityState !== 'visible')
+                return;
+            void refetch();
+        };
+        const id = window.setInterval(tick, ms);
+        return () => window.clearInterval(id);
+    }, [meta.polling, refetch]);
+    // ── Phase 2 broadcast subscription ───────────────────
+    // When `meta.broadcast` is present, connect to the panel's WebSocket
+    // and listen for `notification.created` on the user's private channel.
+    // Triggers the same `refetch()` already wired for polling — broadcast
+    // is "low-latency refetch hint", not a payload-pushing transport.
+    //
+    // RudderSocket loads via dynamic import so the bell doesn't bundle
+    // broadcast for apps that don't enable it. Failures (package missing,
+    // wsUrl unreachable, auth rejected) silently fall back to polling.
+    React.useEffect(() => {
+        if (!meta.broadcast)
+            return;
+        if (typeof window === 'undefined')
+            return;
+        let cancelled = false;
+        let socket = null;
+        const wsUrl = meta.broadcast.wsUrl || sameOriginWsUrl();
+        const channelName = meta.broadcast.channel;
+        const eventName = meta.broadcast.event;
+        void (async () => {
+            try {
+                const RudderSocket = await loadRudderSocket();
+                if (!RudderSocket || cancelled)
+                    return;
+                const s = new RudderSocket(wsUrl);
+                socket = s;
+                // Strip the `private-` prefix — `RudderSocket.private(name)`
+                // re-adds it. We pass an empty token because the auth callback
+                // we registered server-side reads the upgrade request's cookies,
+                // not a per-message bearer token.
+                const bareName = channelName.replace(/^private-/, '');
+                s.private(bareName, '').on(eventName, () => {
+                    if (cancelled)
+                        return;
+                    void refetch();
+                });
+            }
+            catch { /* package not vendored / connect failed — polling covers it */ }
+        })();
+        return () => {
+            cancelled = true;
+            socket?.disconnect();
+        };
+    }, [meta.broadcast?.wsUrl, meta.broadcast?.channel, meta.broadcast?.event, refetch]);
+    // ── Mutations ────────────────────────────────────────
+    const markRead = React.useCallback(async (id) => {
+        // Optimistic flip — the bell stays responsive even on slow networks.
+        setData(prev => prev && {
+            notifications: prev.notifications.map(n => n.id === id ? { ...n, readAt: n.readAt ?? new Date().toISOString() } : n),
+            unreadCount: Math.max(0, prev.unreadCount - 1),
+        });
+        try {
+            await fetch(meta.readUrl.replace(':id', encodeURIComponent(id)), {
+                method: 'POST',
+                headers: { Accept: 'application/json' },
+                credentials: 'same-origin',
+            });
+        }
+        catch { /* swallow — next poll resyncs */ }
+        void refetch();
+    }, [meta.readUrl, refetch]);
+    const markAllRead = React.useCallback(async () => {
+        setData(prev => prev && {
+            notifications: prev.notifications.map(n => n.readAt ? n : { ...n, readAt: new Date().toISOString() }),
+            unreadCount: 0,
+        });
+        try {
+            await fetch(meta.readAllUrl, {
+                method: 'POST',
+                headers: { Accept: 'application/json' },
+                credentials: 'same-origin',
+            });
+        }
+        catch { /* swallow */ }
+        void refetch();
+    }, [meta.readAllUrl, refetch]);
+    const unreadCount = data?.unreadCount ?? 0;
+    const items = data?.notifications ?? [];
+    const toast = useToast();
+    return (_jsxs(DropdownMenu, { open: open, onOpenChange: setOpen, children: [_jsxs(DropdownMenuTrigger, { className: "relative inline-flex items-center justify-center size-9 rounded-md hover:bg-accent hover:text-accent-foreground transition-colors focus:outline-none", "aria-label": meta.trigger?.label ?? 'Notifications', children: [_jsx(BellIcon, { icon: meta.trigger?.icon }), unreadCount > 0 && (_jsx("span", { className: cn('absolute -top-0.5 -end-0.5 inline-flex min-w-[1rem] h-4 items-center justify-center rounded-full px-1 text-[10px] font-semibold leading-none', BADGE_COLOR[meta.badgeColor]), "aria-label": `${unreadCount} unread`, children: unreadCount > 99 ? '99+' : unreadCount }))] }), _jsxs(DropdownMenuContent, { align: "end", className: "w-80 p-0", children: [_jsxs("header", { className: "flex items-center justify-between px-3 py-2 border-b", children: [_jsx("span", { className: "text-sm font-medium", children: "Notifications" }), unreadCount > 0 && (_jsx("button", { type: "button", className: "text-xs text-muted-foreground hover:text-foreground transition-colors", onClick: () => { void markAllRead(); }, children: "Mark all as read" }))] }), _jsx("div", { className: "max-h-96 overflow-y-auto", children: items.length === 0
+                            ? _jsx(EmptyState, { loading: loading })
+                            : items.map(n => (_jsx(NotificationRow, { notification: n, actionUrlTemplate: meta.actionUrl, onMarkRead: markRead, onNavigate: (href) => { setOpen(false); navigate(href); }, onNotify: (notifs) => notifs.forEach(t => toast.notify(t)), onAfterClick: () => setOpen(false) }, n.id))) })] })] }));
+}
+function NotificationRow({ notification: n, actionUrlTemplate, onMarkRead, onNavigate, onNotify, onAfterClick, }) {
+    const RowIcon = useIconFor(n.icon);
+    const unread = !n.readAt;
+    const onClick = (e) => {
+        // Modified clicks (cmd/ctrl/middle) preserve native semantics.
+        if (e.defaultPrevented || e.metaKey || e.ctrlKey || e.shiftKey)
+            return;
+        e.preventDefault();
+        if (unread)
+            onMarkRead(n.id);
+        if (n.url)
+            onNavigate(n.url);
+    };
+    // Body wrapper is `<a>` when the row has a click-through url, plain
+    // `<button>` otherwise. Form-mode + handler-mode action buttons in
+    // the strip can't validly nest inside an `<a>`/`<button>`, so the
+    // strip lives as a sibling under a shared chrome `<div>`.
+    const Tag = n.url ? 'a' : 'button';
+    const tagProps = {
+        onClick,
+        className: 'w-full text-start flex items-start gap-2 focus:outline-none',
+    };
+    if (Tag === 'a') {
+        tagProps.href = n.url;
+    }
+    else {
+        tagProps.type = 'button';
+    }
+    return (_jsxs("div", { className: cn('px-3 py-2 hover:bg-accent transition-colors border-b last:border-b-0', unread && 'bg-primary/5'), children: [_jsxs(Tag, { ...tagProps, children: [_jsx("span", { className: cn('mt-1.5 inline-block size-2 rounded-full shrink-0', n.type ? TYPE_DOT[n.type] : 'bg-muted-foreground/40'), "aria-hidden": "true" }), _jsxs("span", { className: "flex-1 min-w-0", children: [_jsxs("span", { className: "flex items-center gap-1.5", children: [RowIcon && _jsx(RowIcon, { className: "size-3.5 text-muted-foreground", "aria-hidden": "true" }), _jsx("span", { className: cn('text-sm leading-tight', unread ? 'font-medium' : ''), children: n.title || 'Notification' })] }), n.body && (_jsx("span", { className: "block text-xs text-muted-foreground mt-0.5 line-clamp-2", children: n.body })), _jsx("span", { className: "block text-[11px] text-muted-foreground/70 mt-1", children: formatRelative(n.createdAt) })] })] }), n.actions && n.actions.length > 0 && (_jsx("div", { className: "ms-4", children: _jsx(NotificationActionStrip, { actions: n.actions, ...(actionUrlTemplate !== undefined ? { actionUrlTemplate } : {}), notificationId: n.id, onMarkAsRead: onMarkRead, onNotify: onNotify, onAfterClick: onAfterClick }) }))] }));
+}
+function EmptyState({ loading }) {
+    return (_jsx("div", { className: "px-3 py-8 text-center text-sm text-muted-foreground", children: loading ? 'Loading…' : 'No notifications' }));
+}
+function BellIcon({ icon }) {
+    // Honor `meta.trigger.icon` when set (string registry name); fall
+    // through to the bundled bell glyph otherwise. The registry-resolved
+    // hook returns `null` when no entry is registered, so a misspelt name
+    // still shows the default bell — better than a silent blank.
+    const Icon = useIconFor(icon);
+    if (Icon)
+        return _jsx(Icon, { className: "size-5", "aria-hidden": "true" });
+    return (_jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", width: "20", height: "20", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M6 8a6 6 0 0 1 12 0c0 7 3 9 3 9H3s3-2 3-9" }), _jsx("path", { d: "M10.3 21a1.94 1.94 0 0 0 3.4 0" })] }));
+}
+async function loadRudderSocket() {
+    // Allow apps to register a custom-path RudderSocket without us
+    // having to guess at the import path.
+    const w = typeof window !== 'undefined'
+        ? window
+        : null;
+    if (w?.__pilotiqRudderSocket)
+        return w.__pilotiqRudderSocket;
+    // Apps that vendor:publish the broadcast client typically end up
+    // with `src/RudderSocket.ts` (or `.js`); try common shapes via the
+    // app's import-map / module resolution. The dynamic import is
+    // wrapped in a try/catch so missing modules don't surface.
+    const candidates = [
+        '@rudderjs/broadcast/client/RudderSocket.js',
+        '@rudderjs/broadcast/client/RudderSocket',
+    ];
+    for (const id of candidates) {
+        try {
+            const mod = await import(/* @vite-ignore */ id);
+            if (mod.RudderSocket)
+                return mod.RudderSocket;
+        }
+        catch { /* try next */ }
+    }
+    return null;
+}
+/** Same-origin `ws://…/ws` (or `wss://` on https). Used when
+ *  `meta.broadcast.wsUrl` is empty — the default for apps that boot
+ *  `BroadcastingProvider` with no custom path. */
+function sameOriginWsUrl() {
+    if (typeof window === 'undefined')
+        return '';
+    const proto = window.location.protocol === 'https:' ? 'wss:' : 'ws:';
+    return `${proto}//${window.location.host}/ws`;
+}
+function formatRelative(ts) {
+    const now = Date.now();
+    const diff = Math.max(0, now - ts);
+    const sec = Math.floor(diff / 1000);
+    if (sec < 45)
+        return 'Just now';
+    if (sec < 90)
+        return '1 minute ago';
+    const min = Math.floor(sec / 60);
+    if (min < 60)
+        return `${min} minutes ago`;
+    const hr = Math.floor(min / 60);
+    if (hr < 24)
+        return `${hr} hour${hr === 1 ? '' : 's'} ago`;
+    const day = Math.floor(hr / 24);
+    if (day < 7)
+        return `${day} day${day === 1 ? '' : 's'} ago`;
+    return new Date(ts).toLocaleDateString();
+}
+//# sourceMappingURL=NotificationBell.js.map

package/dist/react/NotificationBell.js.map

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

package/dist/react/RenderHookSlot.d.ts

@@ -0,0 +1,20 @@
+import type { RenderHookMap, RenderHookName } from '../RenderHook.js';
+/**
+ * Mount point for a named render-hook slot. Reads pre-resolved
+ * `ElementMeta[]` from the wire payload and walks them through the
+ * existing `<SchemaRenderer>` so every Element type (Heading / Alert /
+ * Form / Table / …) renders the same way it does in the main schema
+ * tree.
+ *
+ * Renders `null` when no hooks were registered for the slot — every
+ * supported chrome / page-role position mounts a `<RenderHookSlot>`
+ * unconditionally, so the wire payload stays sparse on panels that
+ * don't use render hooks.
+ *
+ *   <RenderHookSlot name="panels::topbar.start" hooks={panel.renderHooks} />
+ */
+export declare function RenderHookSlot({ name, hooks, }: {
+    name: RenderHookName;
+    hooks: RenderHookMap | undefined;
+}): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=RenderHookSlot.d.ts.map

package/dist/react/RenderHookSlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderHookSlot.d.ts","sourceRoot":"","sources":["../../src/react/RenderHookSlot.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGrE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,KAAK,GACN,EAAE;IACD,IAAI,EAAG,cAAc,CAAA;IACrB,KAAK,EAAE,aAAa,GAAG,SAAS,CAAA;CACjC,kDAIA"}

package/dist/react/RenderHookSlot.js

@@ -0,0 +1,24 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { SchemaRenderer } from './SchemaRenderer.js';
+/**
+ * Mount point for a named render-hook slot. Reads pre-resolved
+ * `ElementMeta[]` from the wire payload and walks them through the
+ * existing `<SchemaRenderer>` so every Element type (Heading / Alert /
+ * Form / Table / …) renders the same way it does in the main schema
+ * tree.
+ *
+ * Renders `null` when no hooks were registered for the slot — every
+ * supported chrome / page-role position mounts a `<RenderHookSlot>`
+ * unconditionally, so the wire payload stays sparse on panels that
+ * don't use render hooks.
+ *
+ *   <RenderHookSlot name="panels::topbar.start" hooks={panel.renderHooks} />
+ */
+export function RenderHookSlot({ name, hooks, }) {
+    const elements = hooks?.[name];
+    if (!elements || elements.length === 0)
+        return null;
+    return _jsx(SchemaRenderer, { elements: elements });
+}
+//# sourceMappingURL=RenderHookSlot.js.map

package/dist/react/RenderHookSlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderHookSlot.js","sourceRoot":"","sources":["../../src/react/RenderHookSlot.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAKZ,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,IAAI,EACJ,KAAK,GAIN;IACC,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnD,OAAO,KAAC,cAAc,IAAC,QAAQ,EAAE,QAAyB,GAAI,CAAA;AAChE,CAAC"}

package/dist/react/RightSidebar.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Right-sidebar chrome — outer panel that hosts plugin contributions.
+ *
+ * Mounted by `AppShell` only when `panel.rightSidebar` is present in the
+ * server-built meta. Reads runtime state (open / activeId / width) from
+ * `useRightSidebar()` and resolves each contribution's body via
+ * `useRightPanelComponent(id)` (Phase B's `_components.ts` manifest).
+ *
+ * Desktop: right-docked `position: fixed` rail with a 4px left-edge resize
+ * handle. The companion `<RightSidebarSpacer>` reserves layout width on
+ * the host so content compresses instead of clipping under the rail.
+ *
+ * Mobile (< md breakpoint): collapses to an overlay `<Sheet>` — no resize
+ * handle, fixed width.
+ *
+ * Tab strip: hidden when only one contribution is registered (single-tab
+ * UX matches VS Code's "Outline / etc." behaviour). Tabs persist active
+ * selection through the provider's localStorage round-trip.
+ */
+import React from 'react';
+export interface RightSidebarProps {
+    basePath: string;
+    /** Live pathname — re-renders the panel body on SPA nav so consumers
+     *  can react to which page the user is on. */
+    currentPath?: string;
+}
+/**
+ * Outer chrome. Renders a fixed-position rail on desktop and a Sheet on
+ * mobile. Reads its open / width / active state from the surrounding
+ * `RightSidebarProvider`.
+ */
+export declare function RightSidebar({ basePath, currentPath }: RightSidebarProps): React.ReactElement | null;
+//# sourceMappingURL=RightSidebar.d.ts.map

package/dist/react/RightSidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RightSidebar.d.ts","sourceRoot":"","sources":["../../src/react/RightSidebar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAgBzB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB;kDAC8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAgHD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAmGpG"}

package/dist/react/RightSidebar.js

@@ -0,0 +1,82 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { XIcon } from 'lucide-react';
+import { cn } from './utils.js';
+import { useRightSidebar } from './RightSidebarContext.js';
+import { useRightPanelComponent } from './right-panel-registry.js';
+import { useIconFor } from './icon-context.js';
+import { useIsMobile } from './hooks/use-mobile.js';
+import { Sheet, SheetContent, SheetHeader, SheetTitle, } from './ui/sheet.js';
+function PanelIcon({ value }) {
+    const Icon = useIconFor(value);
+    if (!Icon)
+        return null;
+    return _jsx(Icon, { className: "size-4", "aria-hidden": "true" });
+}
+function PanelBody({ contribution, basePath, currentPath, }) {
+    const Component = useRightPanelComponent(contribution.id);
+    if (!Component) {
+        return (_jsxs("div", { className: "p-4 text-sm text-destructive", children: [_jsx("p", { className: "font-medium", children: "Right panel not registered" }), _jsxs("p", { className: "mt-1 text-muted-foreground", children: ["No client component is bound to ", _jsx("code", { className: "rounded bg-muted px-1", children: contribution.id }), ". The Vite plugin's ", _jsx("code", { className: "rounded bg-muted px-1", children: "_components.ts" }), " manifest is missing this entry \u2014 extract the ", _jsx("code", { className: "rounded bg-muted px-1", children: "render" }), " reference to a named export."] })] }));
+    }
+    // Component reads its own context as needed; we forward the well-known
+    // RightPanelProps (basePath / currentPath / activeId) defined in
+    // `RightPanel.ts` so plugin authors don't have to plumb it themselves.
+    // `currentPath` is conditionally spread so an absent value does not
+    // collide with the prop's `undefined`-disallowed (exactOptional) shape.
+    const props = {
+        basePath,
+        activeId: contribution.id,
+    };
+    if (currentPath !== undefined)
+        props.currentPath = currentPath;
+    return _jsx(Component, { ...props });
+}
+function TabStrip({ contributions, activeId, setActiveId, }) {
+    if (contributions.length < 2)
+        return null;
+    return (_jsx("div", { role: "tablist", className: "flex items-center gap-0 border-b bg-muted/30 px-1", children: contributions.map((c) => {
+            const active = c.id === activeId;
+            return (_jsxs("button", { type: "button", role: "tab", "aria-selected": active, onClick: () => setActiveId(c.id), className: cn('inline-flex items-center gap-1.5 rounded-t-md border-b-2 px-3 py-2 text-xs font-medium transition-colors', active
+                    ? 'border-primary text-foreground'
+                    : 'border-transparent text-muted-foreground hover:text-foreground'), children: [_jsx(PanelIcon, { value: c.icon }), _jsx("span", { children: c.label })] }, c.id));
+        }) }));
+}
+function PanelHeader({ active, onClose, hideTabs, }) {
+    return (_jsxs("div", { className: "flex h-11 shrink-0 items-center gap-2 border-b px-3", children: [hideTabs && active && (_jsxs(_Fragment, { children: [_jsx(PanelIcon, { value: active.icon }), _jsx("span", { className: "text-sm font-medium", children: active.label })] })), _jsx("button", { type: "button", onClick: onClose, className: cn('ms-auto inline-flex size-7 items-center justify-center rounded-md text-muted-foreground transition-colors', 'hover:bg-accent hover:text-foreground'), "aria-label": "Close right sidebar", children: _jsx(XIcon, { className: "size-4", "aria-hidden": "true" }) })] }));
+}
+/**
+ * Outer chrome. Renders a fixed-position rail on desktop and a Sheet on
+ * mobile. Reads its open / width / active state from the surrounding
+ * `RightSidebarProvider`.
+ */
+export function RightSidebar({ basePath, currentPath }) {
+    const sidebar = useRightSidebar();
+    const isMobile = useIsMobile();
+    // Drag-resize: the provider owns width state + per-basePath
+    // localStorage persistence, so the chrome just listens at the document
+    // level and forwards each delta into `sidebar.setWidth`.
+    const onPointerDown = (e) => {
+        e.preventDefault();
+        const startX = e.clientX;
+        const startWidth = sidebar.width;
+        const onMove = (ev) => {
+            const delta = startX - ev.clientX;
+            sidebar.setWidth(startWidth + delta);
+        };
+        const onUp = () => {
+            document.removeEventListener('pointermove', onMove);
+            document.removeEventListener('pointerup', onUp);
+        };
+        document.addEventListener('pointermove', onMove);
+        document.addEventListener('pointerup', onUp);
+    };
+    const active = sidebar.contributions.find((c) => c.id === sidebar.activeId)
+        ?? sidebar.contributions[0];
+    const hideTabs = sidebar.contributions.length < 2;
+    if (!sidebar.open)
+        return null;
+    if (isMobile) {
+        return (_jsx(Sheet, { open: sidebar.open, onOpenChange: sidebar.setOpen, children: _jsxs(SheetContent, { side: "right", className: "flex w-[min(20rem,calc(100vw-3rem))] flex-col p-0", showCloseButton: false, children: [_jsx(SheetHeader, { className: "border-b", children: _jsx(SheetTitle, { children: active?.label ?? 'Side panel' }) }), _jsx(TabStrip, { contributions: sidebar.contributions, activeId: sidebar.activeId, setActiveId: sidebar.setActiveId }), _jsx("div", { className: "flex-1 overflow-y-auto", children: active && (_jsx(PanelBody, { contribution: active, basePath: basePath, ...(currentPath !== undefined ? { currentPath } : {}) })) })] }) }));
+    }
+    return (_jsxs("aside", { "data-pilotiq-right-sidebar": "", style: { width: sidebar.width }, className: cn('fixed inset-y-0 end-0 z-30 flex flex-col border-s bg-background shadow-sm'), role: "complementary", "aria-label": active?.label ?? 'Side panel', children: [_jsx("div", { role: "separator", "aria-orientation": "vertical", "aria-label": "Resize side panel", onPointerDown: onPointerDown, className: cn('absolute inset-y-0 start-0 w-1 cursor-ew-resize', 'hover:bg-border/80') }), _jsx(PanelHeader, { active: active, onClose: () => sidebar.setOpen(false), hideTabs: hideTabs }), _jsx(TabStrip, { contributions: sidebar.contributions, activeId: sidebar.activeId, setActiveId: sidebar.setActiveId }), _jsx("div", { className: "flex-1 overflow-y-auto", children: active && (_jsx(PanelBody, { contribution: active, basePath: basePath, ...(currentPath !== undefined ? { currentPath } : {}) })) })] }));
+}
+//# sourceMappingURL=RightSidebar.js.map

package/dist/react/RightSidebar.js.map

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

package/dist/react/RightSidebarContext.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Right-sidebar runtime state — open/close, active tab, current width.
+ *
+ * Shape mirrors the contract documented in `docs/plans/right-sidebar.md` so
+ * plugin bodies and the chrome read from the same surface. Values persist
+ * to localStorage under per-basePath keys so a multi-panel app (`/admin`
+ * + `/simple`) doesn't share state across mount points.
+ *
+ * The provider mounts inside `AppShell` only when `panel.rightSidebar` is
+ * present — plugin contributions render inside the chrome's body, so
+ * they're guaranteed to call `useRightSidebar()` under the provider.
+ *
+ * Programmatic open: any descendant of the provider (most useful: a render
+ * hook on the topbar) can flip open/active via the hook. The default
+ * `RightSidebarTrigger` uses this exact wiring; consumers that want a
+ * floating-button affordance can call `useRightSidebar()` and roll their own.
+ */
+import React from 'react';
+import type { RightPanelMeta, RightSidebarMeta } from '../pageData.js';
+export interface RightSidebarApi {
+    /** Whether the panel is currently open. */
+    open: boolean;
+    setOpen: (v: boolean) => void;
+    toggle: () => void;
+    /** Active tab's contribution id. `null` when no tab has been picked
+     *  (initial render of an empty-localStorage panel). */
+    activeId: string | null;
+    setActiveId: (id: string) => void;
+    /** Current panel width in px. */
+    width: number;
+    setWidth: (px: number) => void;
+    /** All visible contributions for the current panel. Sorted by the
+     *  server-side `panelInfo()` builder; the order is stable across
+     *  navigations. */
+    contributions: RightPanelMeta[];
+    /** Server-supplied min/max/default — exposed so the chrome's resize
+     *  handle clamps to the same range. */
+    bounds: {
+        min: number;
+        max: number;
+        default: number;
+    };
+}
+export interface RightSidebarProviderProps {
+    meta: RightSidebarMeta;
+    basePath: string;
+    children: React.ReactNode;
+}
+export declare function RightSidebarProvider({ meta, basePath, children }: RightSidebarProviderProps): React.ReactElement;
+/**
+ * Read the right-sidebar API. Throws when called outside a
+ * `RightSidebarProvider` — call it from inside a contribution's `render`
+ * body or any descendant component.
+ */
+export declare function useRightSidebar(): RightSidebarApi;
+/**
+ * Optional variant — returns `null` when no provider is mounted instead
+ * of throwing. Useful for chrome that wants to render only when the
+ * surface is active (e.g., the topbar trigger button).
+ */
+export declare function useRightSidebarOptional(): RightSidebarApi | null;
+//# sourceMappingURL=RightSidebarContext.d.ts.map

package/dist/react/RightSidebarContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RightSidebarContext.d.ts","sourceRoot":"","sources":["../../src/react/RightSidebarContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAQN,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAGtE,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,IAAI,EAAW,OAAO,CAAA;IACtB,OAAO,EAAQ,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACnC,MAAM,EAAS,MAAM,IAAI,CAAA;IACzB;2DACuD;IACvD,QAAQ,EAAO,MAAM,GAAG,IAAI,CAAA;IAC5B,WAAW,EAAI,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,iCAAiC;IACjC,KAAK,EAAU,MAAM,CAAA;IACrB,QAAQ,EAAO,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC;;uBAEmB;IACnB,aAAa,EAAE,cAAc,EAAE,CAAA;IAC/B;2CACuC;IACvC,MAAM,EAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7D;AAID,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAM,gBAAgB,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAgCD,wBAAgB,oBAAoB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,yBAAyB,GAAG,KAAK,CAAC,YAAY,CAgGhH;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,eAAe,CAUjD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,GAAG,IAAI,CAEhE"}