@columenlabs/lumen-ui 0.1.91 → 0.1.92

package/dist/index.d.ts

@@ -69,7 +69,7 @@ export { WhatsNew } from './whats-new.js';
 export { type LumenApp, LumenAppSwitcher, LumenSuiteSwitcher, type SuiteApp, type SuiteList, suiteApps, } from './app-switcher.js';
 export { type BriefActions, type BriefChange, type ScheduleChange, type ScheduleItem, type ScheduleRun, SchedulesSection, } from './schedules.js';
 export { NotificationsSettings } from './notifications.js';
-export { type TasksConfig, TasksButton, TasksProvider, useTasks } from './tasks.js';
+export { type TasksConfig, TasksButton, TasksProvider, useTaskFor, useTasks } from './tasks.js';
 export { type McpServer, McpSettings } from './mcp-settings.js';
 export { lumenToast } from './lumen-toast.js';
 export { LumenShell, type LumenShellProps, type ShellUser, StatusItem, firstName, initials, maskAmount, useAmountsHidden, useApp, useShell, } from './shell.js';

package/dist/index.js

@@ -76,7 +76,7 @@ export { WhatsNew } from './whats-new.js';
 export { LumenAppSwitcher, LumenSuiteSwitcher, suiteApps, } from './app-switcher.js';
 export { SchedulesSection, } from './schedules.js';
 export { NotificationsSettings } from './notifications.js';
-export { TasksButton, TasksProvider, useTasks } from './tasks.js';
+export { TasksButton, TasksProvider, useTaskFor, useTasks } from './tasks.js';
 export { McpSettings } from './mcp-settings.js';
 export { lumenToast } from './lumen-toast.js';
 export { LumenShell, StatusItem, firstName, initials, maskAmount, useAmountsHidden, useApp, useShell, } from './shell.js';

package/dist/tasks.d.ts

@@ -15,11 +15,18 @@ interface TasksState {
     /** Deletes one ended task, or every ended one; open tasks stay. */
     clear: (id?: string) => Promise<void>;
     open: (t: Task) => void;
+    /** Shows a task the app just started (its POST's answer) at once, before the next read, so its
+     *  end toasts even when it finishes within one poll. */
+    track: (t: Task) => void;
     /** `TasksConfig.apps`. */
     apps?: Record<string, string>;
 }
 /** The Tasks list, or null where the app has none; `refresh()` after starting one shows it at once. */
 export declare function useTasks(): TasksState | null;
+/** The newest task for one piece of work (`kind` + the engine's `ref`, such as a saved search's
+ *  id), so the button that starts it can show it running (`Running 1/3`) and come back when it
+ *  ends. Null when there is none or the app has no Tasks. */
+export declare function useTaskFor(kind: string, ref: string | null | undefined): Task | null;
 export declare function TasksProvider({ config, children }: {
     config?: TasksConfig;
     children: ReactNode;

package/dist/tasks.js

@@ -30,6 +30,15 @@ const TasksCtx = createContext(null);
 export function useTasks() {
     return useContext(TasksCtx);
 }
+/** The newest task for one piece of work (`kind` + the engine's `ref`, such as a saved search's
+ *  id), so the button that starts it can show it running (`Running 1/3`) and come back when it
+ *  ends. Null when there is none or the app has no Tasks. */
+export function useTaskFor(kind, ref) {
+    const tasks = useTasks();
+    if (!tasks?.list || !ref)
+        return null;
+    return tasks.list.tasks.find((t) => t.kind === kind && t.ref === ref) ?? null;
+}
 const POLL_MS = 3000;
 export function TasksProvider({ config, children }) {
     if (!config)
@@ -84,6 +93,18 @@ function TasksLive({ api, apps, children, }) {
         activeIds.current = new Set(next.tasks.filter(isActive).map((t) => t.id));
         setList(next);
     }, [api, open, qc]);
+    const track = useCallback((t) => {
+        activeIds.current = new Set([...(activeIds.current ?? []), t.id]);
+        setList((l) => {
+            const tasks = [t, ...(l?.tasks ?? []).filter((x) => x.id !== t.id)];
+            return {
+                tasks,
+                active: tasks.filter(isActive).length,
+                unseen: tasks.filter((x) => x.finished_at && !x.seen_at).length,
+            };
+        });
+        void refresh();
+    }, [refresh]);
     const post = useCallback(async (path) => {
         await fetch(`${api}${path}`, {
             method: 'POST',
@@ -137,7 +158,7 @@ function TasksLive({ api, apps, children, }) {
         }, POLL_MS);
         return () => window.clearInterval(id);
     }, [active, refresh]);
-    const value = useMemo(() => (gone ? null : { list, refresh, cancel, seen, clear, open, apps }), [gone, list, refresh, cancel, seen, clear, open, apps]);
+    const value = useMemo(() => (gone ? null : { list, refresh, cancel, seen, clear, open, track, apps }), [gone, list, refresh, cancel, seen, clear, open, track, apps]);
     return _jsx(TasksCtx.Provider, { value: value, children: children });
 }
 function endedToast(t, open) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@columenlabs/lumen-ui",
-  "version": "0.1.91",
+  "version": "0.1.92",
   "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.91",
+    "@columenlabs/lumen-ui-types": "0.1.92",
     "@dnd-kit/core": "6.3.1",
     "@dnd-kit/sortable": "10.0.0",
     "@dnd-kit/utilities": "3.2.2",