@columenlabs/lumen-ui 0.1.189 → 0.1.190

package/dist/frame-script.d.ts

@@ -1,7 +1,10 @@
-export declare function FrameScriptDialog({ api, frame, name, open, onOpenChange, }: {
+import type { FrameRun } from '@columenlabs/lumen-ui-types/frames';
+export declare function FrameScriptDialog({ api, frame, name, runs, open, onOpenChange, }: {
     api: string;
     frame: string;
     name: string;
+    /** The last runs, newest first: when, how many rows, how long, who, and why one failed. */
+    runs?: FrameRun[];
     open: boolean;
     onOpenChange: (open: boolean) => void;
 }): import("react").JSX.Element;

package/dist/frame-script.js

@@ -47,7 +47,7 @@ function parseScript(was, text) {
         args: (o.args ?? {}),
     };
 }
-export function FrameScriptDialog({ api, frame, name, open, onOpenChange, }) {
+export function FrameScriptDialog({ api, frame, name, runs, open, onOpenChange, }) {
     const qc = useQueryClient();
     const assistant = useAssistantName();
     const read = useQuery({
@@ -96,8 +96,17 @@ export function FrameScriptDialog({ api, frame, name, open, onOpenChange, }) {
             setError(e.message);
         }
     };
-    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: "flex h-[min(44rem,calc(100dvh-2rem))] flex-col sm:max-w-4xl", children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { children: ["Script \u00B7 ", name] }), _jsxs(DialogDescription, { children: ["What ", assistant, " runs to make these rows. Saved only if it runs."] })] }), read.isPending ? (_jsx(Skeleton, { className: "min-h-0 flex-1" })) : read.error ? (_jsxs(Alert, { variant: "destructive", children: [_jsx(AlertTitle, { children: "Couldn't read the script" }), _jsx(AlertDescription, { children: read.error.message })] })) : !script ? (_jsxs(Alert, { children: [_jsx(AlertTitle, { children: "No script" }), _jsxs(AlertDescription, { children: [assistant, " wrote these rows once: nothing runs to make them."] })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex items-center justify-end gap-1", children: [lang && (_jsx(Badge, { variant: "secondary", className: "font-mono", children: lang })), _jsx(IconButton, { icon: WrapTextIcon, label: wrap ? 'Stop wrapping lines' : 'Wrap long lines', pressed: wrap, onClick: () => setWrap(!wrap) })] }), _jsx(LumenCodeEditor, { className: "flex-1", value: text, lang: lang, wrap: wrap, onChange: setText }), error && (_jsxs(Alert, { variant: "destructive", className: "max-h-32 overflow-y-auto", children: [_jsx(AlertTitle, { children: "Didn't save" }), _jsx(AlertDescription, { className: "break-words font-mono text-xs", children: error })] }))] })), _jsxs(DialogFooter, { children: [_jsx(IconButton, { icon: RotateCcwIcon, label: "Undo my changes", disabled: !changed || save.isPending, onClick: () => {
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: "flex h-[min(44rem,calc(100dvh-2rem))] flex-col sm:max-w-4xl", children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { children: ["Script \u00B7 ", name] }), _jsxs(DialogDescription, { children: ["What ", assistant, " runs to make these rows. Saved only if it runs."] })] }), read.isPending ? (_jsx(Skeleton, { className: "min-h-0 flex-1" })) : read.error ? (_jsxs(Alert, { variant: "destructive", children: [_jsx(AlertTitle, { children: "Couldn't read the script" }), _jsx(AlertDescription, { children: read.error.message })] })) : !script ? (_jsxs(Alert, { children: [_jsx(AlertTitle, { children: "No script" }), _jsxs(AlertDescription, { children: [assistant, " wrote these rows once: nothing runs to make them."] })] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex items-center justify-end gap-1", children: [lang && (_jsx(Badge, { variant: "secondary", className: "font-mono", children: lang })), _jsx(IconButton, { icon: WrapTextIcon, label: wrap ? 'Stop wrapping lines' : 'Wrap long lines', pressed: wrap, onClick: () => setWrap(!wrap) })] }), _jsx(LumenCodeEditor, { className: "flex-1", value: text, lang: lang, wrap: wrap, onChange: setText }), runs && runs.length > 0 && _jsx(RunList, { runs: runs, assistant: assistant }), error && (_jsxs(Alert, { variant: "destructive", className: "max-h-32 overflow-y-auto", children: [_jsx(AlertTitle, { children: "Didn't save" }), _jsx(AlertDescription, { className: "break-words font-mono text-xs", children: error })] }))] })), _jsxs(DialogFooter, { children: [_jsx(IconButton, { icon: RotateCcwIcon, label: "Undo my changes", disabled: !changed || save.isPending, onClick: () => {
                                 setText(original);
                                 setError(null);
                             } }), _jsxs(Button, { disabled: !script || save.isPending, onClick: run, children: [save.isPending ? _jsx(Spinner, {}) : _jsx(PlayIcon, {}), " Run and save"] })] })] }) }));
 }
+/** The frame's last runs, one line each; a failure's reason in its hover. */
+function RunList({ runs, assistant }) {
+    return (_jsx("ul", { className: "flex max-h-28 flex-col gap-0.5 overflow-y-auto text-xs text-muted-foreground", children: runs.map((r) => (_jsxs("li", { className: "flex min-w-0 items-center gap-2", title: r.error, children: [_jsx("span", { className: `size-1.5 shrink-0 rounded-full ${r.ok ? 'bg-[var(--meter-ok)]' : 'bg-destructive'}` }), _jsx("time", { className: "shrink-0", dateTime: r.at, children: new Date(r.at).toLocaleString('en-US', {
+                        month: 'short',
+                        day: 'numeric',
+                        hour: 'numeric',
+                        minute: '2-digit',
+                    }) }), _jsx("span", { className: "num shrink-0", children: r.ok ? `${r.rows.toLocaleString('en-US')} rows` : 'failed' }), _jsxs("span", { className: "num shrink-0", children: [(r.ms / 1000).toFixed(1), " s"] }), _jsx("span", { className: "min-w-0 truncate", children: r.ok ? `by ${r.by === 'you' ? 'you' : assistant}` : r.error })] }, r.at))) }));
+}

package/dist/index.d.ts

@@ -105,7 +105,7 @@ export { type AppViewState, useAppView } from './app-views.js';
 export { type ScreenMap, type ScreenOutcome, type ScreenStatus, type WorkspaceOnScreen, type AssistantMove, type AssistantMoveHandlers, type AssistantPage, type AssistantPageType, AssistantScreenProvider, useAssistantMoves, useAssistantPages, useAssistantScreen, useAssistantWorkspace, } from './assistant-screen.js';
 export { type AssistantActions, AssistantContext, type AssistantNote, type AssistantRef, type AssistantSlot, useAssistant, AssistantPendingContext, useAssistantName, useAssistantNote, useAssistantPending, } from './assistant-context.js';
 export { WORKSPACES_KEY, frameKey, workspacesListQuery } from './workspace-keys.js';
-export { type WorkspaceApp, type WorkspaceDraftProps, WorkspacePage, type WorkspacesConfig, WorkspacesProvider, WorkspacesSection, } from './workspaces.js';
+export { type WorkspaceApp, type WorkspaceDraftProps, WorkspacePage, type WorkspaceRecipe, type WorkspacesConfig, WorkspacesProvider, WorkspacesSection, } from './workspaces.js';
 export { CHART_INDICATORS, type ChartIndicator, type IndicatorValues, LINE_COLOR, computeIndicators, formulaIndicator, lineColor, resolveIndicator, runFormula, } from './market/indicators.js';
 export { IndicatorPicker } from './market/indicator-picker.js';
 export { type OptionChainField, type OptionChainRow, OptionChainTable, } from './market/option-chain.js';

package/dist/workspaces.d.ts

@@ -1,3 +1,4 @@
+import { type FrameScript } from '@columenlabs/lumen-ui-types/frames';
 import { type CustomViewConfig } from '@columenlabs/lumen-ui-types/views';
 import { type ComponentType, type ReactNode } from 'react';
 import { type Crumb } from './page.js';
@@ -24,6 +25,20 @@ export interface WorkspacesConfig {
     defaultConfig?: (domain: string) => CustomViewConfig | null;
     /** The empty workspace's example ask, on an app: `put my holdings with their earnings dates in`. */
     example?: (app: string) => string;
+    /** Recipes a person picks to start a tab by hand (+ in the tab bar); none hides the +. */
+    recipes?: WorkspaceRecipe[];
+}
+/** A saved data pull a person can start a tab from: one call to one of the product's read tools. */
+export interface WorkspaceRecipe {
+    id: string;
+    /** The tab's name and the picker's row: `Jobs scoring 70+`. */
+    label: string;
+    /** When to pick it, under the label. */
+    description?: string;
+    /** The picker's section: the app the rows come from. */
+    group?: string;
+    icon?: Icon;
+    recipe: FrameScript;
 }
 /** The product's apps and domains for its workspaces. */
 export declare const WorkspacesProvider: import("react").Provider<WorkspacesConfig>;

package/dist/workspaces.js

@@ -4,7 +4,7 @@ import { customViewConfigSchema, frameSpace, } from '@columenlabs/lumen-ui-types
 import { workspacePath, } from '@columenlabs/lumen-ui-types/workspaces';
 import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
 import { useNavigate, useParams, useSearch } from '@tanstack/react-router';
-import { ArrowRightLeftIcon, CalendarIcon, ExternalLinkIcon, HashIcon, LayersIcon, PencilIcon, SparklesIcon, TableIcon, TextCursorInputIcon, Trash2Icon, TypeIcon, } from 'lucide-react';
+import { ArrowRightLeftIcon, CalendarIcon, ExternalLinkIcon, HashIcon, LayersIcon, PencilIcon, PlusIcon, RefreshCwIcon, SparklesIcon, TableIcon, TextCursorInputIcon, Trash2Icon, TypeIcon, } from 'lucide-react';
 import { createContext, useContext, useEffect, useMemo, useState, } from 'react';
 import { apiJson } from './api-fetch.js';
 import { useAssistant, useAssistantName, useAssistantPending } from './assistant-context.js';
@@ -206,9 +206,48 @@ function WorkspaceBody({ api, w, tab, draft, }) {
                 }).then(() => qc.invalidateQueries({ queryKey: WORKSPACES_KEY }));
         }, { id: `ws-save:${tab.id}`, duration: 4000 });
     };
-    const intro = (_jsx(LumenTabs, { tabs: w.tabs.map((t) => ({ value: t.id, label: t.name, icon: tabIcon(t) })), value: tab?.id, onChange: (t) => void navigate({ href: workspacePath(w.id, t), replace: true }), actions: tab && _jsx(IconButton, { icon: PencilIcon, label: "Edit tab", onClick: () => setEditingTab(true) }) }));
+    // + in the tab bar: a tab from a recipe, run once now; ↻ in the header runs every tab again.
+    const addTab = useMutation({
+        mutationFn: (r) => json(`${api}/workspaces/${w.id}/tabs`, {
+            method: 'POST',
+            body: JSON.stringify({ name: r.label, recipe: r.recipe }),
+        }),
+        onSuccess: ({ workspace, tab: t }) => {
+            put(workspace);
+            void qc.invalidateQueries({ queryKey: [...WORKSPACES_KEY, api, 'list'] });
+            void navigate({ href: workspacePath(w.id, t), replace: true });
+        },
+        onError: (e) => lumenToast.error(`Couldn’t add the tab: ${e.message}`),
+    });
+    const runAll = useMutation({
+        mutationFn: () => json(`${api}/workspaces/${w.id}/refresh`, {
+            method: 'POST',
+        }),
+        onSuccess: (r) => {
+            void qc.invalidateQueries({ queryKey: WORKSPACES_KEY });
+            const ran = `Ran ${r.ran} ${r.ran === 1 ? 'tab' : 'tabs'}: ${r.rows.toLocaleString('en-US')} rows`;
+            if (r.failed.length)
+                lumenToast.warning(`${ran}. Failed: ${r.failed.join(', ')}`);
+            else
+                lumenToast.success(ran);
+        },
+        onError: (e) => lumenToast.error(`Couldn’t run the tabs: ${e.message}`),
+    });
+    const recipes = config.recipes ?? [];
+    const runnable = w.tabs.some((t) => 'frame' in t.source);
+    const intro = (_jsx(LumenTabs, { tabs: w.tabs.map((t) => ({ value: t.id, label: t.name, icon: tabIcon(t) })), value: tab?.id, onChange: (t) => void navigate({ href: workspacePath(w.id, t), replace: true }), actions: _jsxs(_Fragment, { children: [recipes.length > 0 && (_jsx(LumenSelector, { trigger: "icon", icon: PlusIcon, label: addTab.isPending ? 'Adding a tab…' : 'New tab from a recipe', align: "end", disabled: addTab.isPending, options: recipes.map((r) => ({
+                        value: r.id,
+                        label: r.label,
+                        description: r.description,
+                        group: r.group,
+                        icon: r.icon,
+                    })), value: null, onChange: (id) => {
+                        const r = recipes.find((x) => x.id === id);
+                        if (r)
+                            addTab.mutate(r);
+                    } })), tab && (_jsx(IconButton, { icon: PencilIcon, label: "Edit tab", onClick: () => setEditingTab(true) }))] }) }));
     const crumbs = [{ label: 'Workspaces' }, { label: w.name }];
-    const actions = (_jsxs(_Fragment, { children: [_jsx(IconButton, { icon: TextCursorInputIcon, label: "Rename workspace", onClick: () => setNaming('workspace') }), moveTo.length > 0 && (_jsx(LumenSelector, { trigger: "icon", icon: ArrowRightLeftIcon, label: `Move to ${noun}`, align: "end", search: false, options: moveTo.map((a) => ({ value: a.id, label: a.label, icon: a.icon })), value: null, onChange: (a) => move.mutate(a) })), _jsx(IconButton, { icon: Trash2Icon, label: "Delete workspace", className: "text-muted-foreground hover:text-destructive", onClick: () => setRemoving('workspace') })] }));
+    const actions = (_jsxs(_Fragment, { children: [runnable && (_jsx(IconButton, { icon: RefreshCwIcon, label: runAll.isPending ? 'Running every tab…' : 'Run every tab again', disabled: runAll.isPending, className: runAll.isPending ? '[&_svg]:animate-spin' : undefined, onClick: () => runAll.mutate() })), _jsx(IconButton, { icon: TextCursorInputIcon, label: "Rename workspace", onClick: () => setNaming('workspace') }), moveTo.length > 0 && (_jsx(LumenSelector, { trigger: "icon", icon: ArrowRightLeftIcon, label: `Move to ${noun}`, align: "end", search: false, options: moveTo.map((a) => ({ value: a.id, label: a.label, icon: a.icon })), value: null, onChange: (a) => move.mutate(a) })), _jsx(IconButton, { icon: Trash2Icon, label: "Delete workspace", className: "text-muted-foreground hover:text-destructive", onClick: () => setRemoving('workspace') })] }));
     const dialogs = (_jsxs(_Fragment, { children: [_jsx(NameDialog, { open: naming !== null, title: "Rename workspace", value: w.name, onClose: () => setNaming(null), onSave: (name) => rename.mutate(name) }), tab && (_jsx(LumenTabDrawer, { open: editingTab, onClose: () => setEditingTab(false), name: tab.name, icon: tab.config?.icon, fallback: tabIcon({ ...tab, config: null }), description: "Its filters and columns save as you change them.", maxName: 60, busy: editTab.isPending, error: editTab.error?.message, onSave: ({ name, icon }) => editTab.mutate(icon === (tab.config?.icon ?? null)
                     ? { name }
                     : { name, config: { ...tabConfig(tab, w, config.defaultConfig), name, icon } }), remove: {
@@ -226,7 +265,9 @@ function WorkspaceBody({ api, w, tab, draft, }) {
                     title: 'No tabs yet',
                     icon: LayersIcon,
                     kind: 'widget',
-                    children: (_jsxs("p", { className: "text-sm text-muted-foreground", children: ["Ask ", assistant, " for data and to open it here: \u201C", config.example?.(here) ?? 'put this month’s numbers in', " ", w.name, "\u201D."] })),
+                    children: (_jsx("p", { className: "text-sm text-muted-foreground", children: recipes.length > 0
+                            ? 'Pick a recipe from + above: its rows open here as a tab, and run again whenever you tap ↻.'
+                            : `Ask ${assistant} for data and to open it here: “${config.example?.(here) ?? 'put this month’s numbers in'} ${w.name}”.` })),
                 },
             ] }));
     }
@@ -290,6 +331,7 @@ assistant = 'Assistant') {
                 value: (r) => r.v[i] ?? null,
                 format: c.format,
                 amount: c.amount,
+                ...(c.tags ? { tags: true } : {}),
                 filterable: true,
                 groupable: c.type !== 'number',
                 ...(c.type === 'number' ? { aggregate: c.format === 'percent' ? 'mean' : 'sum' } : {}),
@@ -438,7 +480,7 @@ function FrameTab({ api, tab, meta, crumbs, actions, intro, onChange, }) {
                                 day: 'numeric',
                                 hour: 'numeric',
                                 minute: '2-digit',
-                            }) }), failed ? (_jsx(StatusItem, { label: "Refresh failed", className: "min-w-0", value: _jsx("span", { className: "inline-block max-w-72 truncate align-bottom", title: failed, children: failed }), ok: false })) : null] }) }, `frame:${tab.id}`), assistantMade && (_jsx(FrameScriptDialog, { api: api, frame: current.id, name: current.name, open: scriptOpen, onOpenChange: setScriptOpen }))] }));
+                            }) }), failed ? (_jsx(StatusItem, { label: "Refresh failed", className: "min-w-0", value: _jsx("span", { className: "inline-block max-w-72 truncate align-bottom", title: failed, children: failed }), ok: false })) : null] }) }, `frame:${tab.id}`), assistantMade && (_jsx(FrameScriptDialog, { api: api, frame: current.id, name: current.name, runs: current.runs, open: scriptOpen, onOpenChange: setScriptOpen }))] }));
 }
 /** A tab's icon: the person's pick, else the assistant's mark on a frame, else a table. */
 function tabIcon(t) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@columenlabs/lumen-ui",
-  "version": "0.1.189",
+  "version": "0.1.190",
   "description": "Lumen: shared React components (frame, views, widgets, charts, drawers).",
   "license": "MIT",
   "type": "module",
@@ -49,7 +49,7 @@
     "@codemirror/lang-javascript": "6.2.5",
     "@codemirror/lang-json": "6.0.2",
     "@codemirror/lang-sql": "6.10.0",
-    "@columenlabs/lumen-ui-types": "0.1.189",
+    "@columenlabs/lumen-ui-types": "0.1.190",
     "@dnd-kit/core": "6.3.1",
     "@dnd-kit/sortable": "10.0.0",
     "@dnd-kit/utilities": "3.2.2",