@pilotiq/pilotiq 0.1.0

package/dist/react/RightSidebarContext.js

@@ -0,0 +1,178 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 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 { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { clampPanelWidth } from './useResizableWidth.js';
+const Ctx = createContext(null);
+function storageKey(basePath, key) {
+    return `pilotiq.rightSidebar.${basePath}.${key}`;
+}
+function readBool(key, fallback) {
+    if (typeof window === 'undefined')
+        return fallback;
+    try {
+        const raw = window.localStorage?.getItem(key);
+        if (raw === 'true')
+            return true;
+        if (raw === 'false')
+            return false;
+        return fallback;
+    }
+    catch {
+        return fallback;
+    }
+}
+function readString(key) {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        const raw = window.localStorage?.getItem(key);
+        return raw ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeString(key, value) {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        if (value === null)
+            window.localStorage?.removeItem(key);
+        else
+            window.localStorage?.setItem(key, value);
+    }
+    catch { /* private mode / quota — best-effort */ }
+}
+export function RightSidebarProvider({ meta, basePath, children }) {
+    const openKey = storageKey(basePath, 'open');
+    const activeKey = storageKey(basePath, 'activeId');
+    const widthKey = storageKey(basePath, 'width');
+    const fallbackId = meta.panels[0]?.id ?? null;
+    const [open, setOpenState] = useState(() => readBool(openKey, false));
+    const [activeId, setActiveIdState] = useState(() => {
+        const stored = readString(activeKey);
+        if (stored && meta.panels.some(p => p.id === stored))
+            return stored;
+        return fallbackId;
+    });
+    const [width, setWidthState] = useState(() => {
+        const stored = readString(widthKey);
+        return clampPanelWidth(stored ?? meta.defaultWidth, {
+            min: meta.minWidth,
+            max: meta.maxWidth,
+            defaultWidth: meta.defaultWidth,
+        });
+    });
+    // Re-validate `activeId` when the contribution set changes (e.g.,
+    // canAccess gating flipped after a route nav). If the stored id has
+    // disappeared, fall back to the first visible tab. Skip when nothing
+    // changed so we don't churn renders on every server data refresh.
+    const visibleIds = useMemo(() => meta.panels.map(p => p.id), [meta.panels]);
+    const visibleIdsRef = useRef(visibleIds);
+    useEffect(() => {
+        const prev = visibleIdsRef.current;
+        visibleIdsRef.current = visibleIds;
+        const stillValid = activeId !== null && visibleIds.includes(activeId);
+        if (stillValid)
+            return;
+        if (prev.length === visibleIds.length && prev.every((id, i) => id === visibleIds[i]))
+            return;
+        setActiveIdState(visibleIds[0] ?? null);
+    }, [visibleIds, activeId]);
+    const setOpen = useCallback((v) => {
+        setOpenState(v);
+        writeString(openKey, v ? 'true' : 'false');
+    }, [openKey]);
+    const toggle = useCallback(() => {
+        setOpenState((prev) => {
+            const next = !prev;
+            writeString(openKey, next ? 'true' : 'false');
+            return next;
+        });
+    }, [openKey]);
+    const setActiveId = useCallback((id) => {
+        setActiveIdState(id);
+        writeString(activeKey, id);
+        // Selecting a tab implies opening — matches VS Code behaviour.
+        setOpenState(true);
+        writeString(openKey, 'true');
+    }, [activeKey, openKey]);
+    const setWidth = useCallback((px) => {
+        const clamped = clampPanelWidth(px, {
+            min: meta.minWidth,
+            max: meta.maxWidth,
+            defaultWidth: meta.defaultWidth,
+        });
+        setWidthState(clamped);
+        writeString(widthKey, String(clamped));
+    }, [meta.minWidth, meta.maxWidth, meta.defaultWidth, widthKey]);
+    // Mod-Shift-\ — VS Code's secondary side bar shortcut. Owned by core
+    // so plugins don't fight over the same key.
+    useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        const onKey = (e) => {
+            if (e.code !== 'Backslash')
+                return;
+            if (!e.shiftKey)
+                return;
+            if (!(e.metaKey || e.ctrlKey))
+                return;
+            e.preventDefault();
+            toggle();
+        };
+        window.addEventListener('keydown', onKey);
+        return () => window.removeEventListener('keydown', onKey);
+    }, [toggle]);
+    const value = useMemo(() => ({
+        open,
+        setOpen,
+        toggle,
+        activeId,
+        setActiveId,
+        width,
+        setWidth,
+        contributions: meta.panels,
+        bounds: { min: meta.minWidth, max: meta.maxWidth, default: meta.defaultWidth },
+    }), [open, setOpen, toggle, activeId, setActiveId, width, setWidth, meta.panels, meta.minWidth, meta.maxWidth, meta.defaultWidth]);
+    return _jsx(Ctx.Provider, { value: value, children: children });
+}
+/**
+ * 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 function useRightSidebar() {
+    const v = useContext(Ctx);
+    if (v === null) {
+        throw new Error('[Pilotiq] useRightSidebar() called outside <RightSidebarProvider>. ' +
+            'The provider mounts only when `panel.rightSidebar` is present in meta — ' +
+            'either no contributions were registered, or the auth gate dropped them all.');
+    }
+    return v;
+}
+/**
+ * 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 function useRightSidebarOptional() {
+    return useContext(Ctx);
+}
+//# sourceMappingURL=RightSidebarContext.js.map

package/dist/react/RightSidebarContext.js.map

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

package/dist/react/RightSidebarTrigger.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Right-sidebar toggle button.
+ *
+ * Mounts in the topbar's right cluster between `NotificationBell` and
+ * `UserMenu`. Renders nothing when no `<RightSidebarProvider>` is mounted
+ * (i.e., `panel.rightSidebar` was absent from `panelInfo()`), so layouts
+ * can include the trigger unconditionally and let it self-suppress.
+ *
+ * Icon swaps between open and closed states (matches the upstream
+ * `PanelRightOpen` / `PanelRightClose` Lucide pair). The keyboard
+ * shortcut (Mod-Shift-\) is owned by the provider — the button is just
+ * a click affordance.
+ */
+import React from 'react';
+export declare function RightSidebarTrigger(): React.ReactElement | null;
+//# sourceMappingURL=RightSidebarTrigger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RightSidebarTrigger.d.ts","sourceRoot":"","sources":["../../src/react/RightSidebarTrigger.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,wBAAgB,mBAAmB,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CAiC/D"}

package/dist/react/RightSidebarTrigger.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { PanelRightOpenIcon, PanelRightCloseIcon } from 'lucide-react';
+import { cn } from './utils.js';
+import { useRightSidebarOptional } from './RightSidebarContext.js';
+import { useIconFor } from './icon-context.js';
+export function RightSidebarTrigger() {
+    const sidebar = useRightSidebarOptional();
+    // When a single contribution is registered, prefer its icon on the
+    // trigger. With 2+, fall back to the generic panel icon — the per-tab
+    // icons live on the tab strip.
+    const single = sidebar && sidebar.contributions.length === 1
+        ? sidebar.contributions[0]
+        : undefined;
+    const SingleIcon = useIconFor(single?.icon);
+    if (!sidebar)
+        return null;
+    if (sidebar.contributions.length === 0)
+        return null;
+    const open = sidebar.open;
+    const Fallback = open ? PanelRightCloseIcon : PanelRightOpenIcon;
+    const Icon = SingleIcon ?? Fallback;
+    return (_jsx("button", { type: "button", onClick: sidebar.toggle, className: cn('inline-flex size-8 items-center justify-center rounded-md text-muted-foreground transition-colors', 'hover:bg-accent hover:text-foreground', open && 'bg-accent text-foreground'), "aria-label": open ? 'Close side panel' : 'Open side panel', "aria-pressed": open, title: open ? 'Close side panel (⌘⇧\\)' : 'Open side panel (⌘⇧\\)', children: _jsx(Icon, { className: "size-4", "aria-hidden": "true" }) }));
+}
+//# sourceMappingURL=RightSidebarTrigger.js.map

package/dist/react/RightSidebarTrigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RightSidebarTrigger.js","sourceRoot":"","sources":["../../src/react/RightSidebarTrigger.tsx"],"names":[],"mappings":";AAcA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAA;IACzC,mEAAmE;IACnE,sEAAsE;IACtE,+BAA+B;IAC/B,MAAM,MAAM,GAAG,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;QAC1D,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;QAC1B,CAAC,CAAC,SAAS,CAAA;IACb,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAE3C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IACzB,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEnD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,CAAA;IAChE,MAAM,IAAI,GAAG,UAAU,IAAI,QAAQ,CAAA;IAEnC,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,OAAO,CAAC,MAAM,EACvB,SAAS,EAAE,EAAE,CACX,mGAAmG,EACnG,uCAAuC,EACvC,IAAI,IAAI,2BAA2B,CACpC,gBACW,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,kBAC3C,IAAI,EAClB,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,wBAAwB,YAElE,KAAC,IAAI,IAAC,SAAS,EAAC,QAAQ,iBAAa,MAAM,GAAG,GACvC,CACV,CAAA;AACH,CAAC"}

package/dist/react/SchemaRenderer.d.ts

@@ -0,0 +1,63 @@
+import React from 'react';
+import type { ElementMeta } from '../schema/Element.js';
+/**
+ * Render a flat list of resolved field-meta as standalone form inputs,
+ * outside any pilotiq Form wrapper. Useful for embedding the schema
+ * input layer in custom surfaces (e.g. the rich-text custom-block side
+ * panel) where the consumer drives reads/writes directly on a host
+ * `<form>` via DOM event delegation.
+ *
+ * Behavior:
+ *   - Each field renders through the same `renderField` switch the
+ *     SchemaRenderer uses for in-form fields, so chrome (label, helper
+ *     text, prefix/suffix) and field-type coverage stay in lockstep.
+ *   - `values`, when supplied, overrides each field's `defaultValue`
+ *     so the consumer can prefill from external state.
+ *   - Inputs are uncontrolled (`defaultValue`-based) — outside a
+ *     `FormStateProvider`, `useFieldState` falls back automatically.
+ *     The host captures changes via container-level event delegation.
+ *
+ * Not for: container layouts (Card / Tabs / Section / Wizard), Action
+ * triggers, or anything beyond a flat field list. Use SchemaRenderer
+ * for full pages.
+ */
+export interface FormFieldsProps {
+    elements: ElementMeta[];
+    values?: Record<string, unknown>;
+}
+export declare function FormFields({ elements, values }: FormFieldsProps): React.ReactElement;
+import type { NotificationMeta } from '../notifications/Notification.js';
+type Notify = (n: NotificationMeta | Omit<NotificationMeta, 'id'>) => void;
+type Navigate = (url: string) => void;
+/**
+ * Fetch + JSON dispatch for handler-style actions (no schema, no modal,
+ * just a button). Sends `ids[]` plus arbitrary `values` fields. Server
+ * returns `{ ok, redirect, notifications }` (or `{ ok: false, error }` on
+ * failure). On success: drain notifications, SPA-navigate; on failure:
+ * surface the error as a toast. No full page reload in any case.
+ */
+export declare function dispatchHandlerAction(url: string, ids: string[], navigate: Navigate, notify: Notify, values?: Record<string, string>, formSnapshot?: FormData): Promise<void>;
+/**
+ * Render one child of a form's resolved schema with per-field values + errors.
+ *
+ * Exported so sibling renderers (e.g. `SelectFieldInput`'s inline-create
+ * modal) can render a sub-schema with the same FieldShell + error-stamping
+ * conventions as the parent form. Public surface beyond the file boundary
+ * stays narrow — callers should pass `child.type === 'field'` elements;
+ * non-field elements fall through to `renderElement`.
+ */
+export declare function renderFormChild(child: ElementMeta, index: number, values: Record<string, unknown>, errors: Record<string, string[]>): React.ReactNode;
+export interface SchemaRendererProps {
+    elements: ElementMeta[];
+    /**
+     * Plan #15 — per-widget initial payload map keyed by element id.
+     * Auto-gen page stubs pass `vp._widgetData` here so widget renderers
+     * can read their first-paint payload through `useInitialWidgetData`.
+     * Optional — pages with no widgets ship `undefined` and the provider
+     * is a no-op.
+     */
+    widgetData?: Record<string, unknown>;
+}
+export declare function SchemaRenderer({ elements, widgetData }: SchemaRendererProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=SchemaRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaRenderer.d.ts","sourceRoot":"","sources":["../../src/react/SchemaRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAyHvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAG,WAAW,EAAE,CAAA;IACxB,MAAM,CAAC,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAapF;AAqXD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAExE,KAAK,MAAM,GAAM,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;AAC7E,KAAK,QAAQ,GAAI,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;AAkDtC;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAO,MAAM,EAChB,GAAG,EAAO,MAAM,EAAE,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAI,MAAM,EAChB,MAAM,GAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACrC,YAAY,CAAC,EAAE,QAAQ,GACtB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAk+ED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC/B,KAAK,CAAC,SAAS,CAejB;AA41FD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,mBAAmB,kDAW3E"}