@stigmer/react 0.4.7 → 0.5.0

package/resource-workbench/hooks/useResourceCollection.js

@@ -0,0 +1,133 @@
+"use client";
+import { useMemo, useCallback, useState, useRef, useEffect } from "react";
+import { getCoreRowModel, getSortedRowModel, useReactTable, } from "@tanstack/react-table";
+import { useFetch } from "../../internal/useFetch";
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+const DEFAULT_PAGE_SIZE = 20;
+const INITIAL_DATA = {
+    entries: [],
+    totalCount: 0,
+    totalPages: 0,
+};
+/**
+ * Headless hook that manages resource collection state: data fetching,
+ * sorting, selection, and pagination.
+ *
+ * Wraps `useFetch` for data and `@tanstack/react-table` for table state
+ * (sorting, selection, column visibility). The hook itself produces no
+ * DOM — it returns data, state, and a TanStack Table instance that view
+ * components (`ResourceTable`, `ResourceCards`, `ResourceList`) consume.
+ *
+ * Platform builders who want full rendering control use this hook
+ * directly. The `ResourceWorkbench` shell composes it internally.
+ *
+ * @example
+ * ```tsx
+ * const collection = useResourceCollection({
+ *   listFn: (params) => stigmer.agent.list(params),
+ *   org: "acme",
+ *   query: debouncedQuery,
+ *   page: 1,
+ *   columns: agentColumns,
+ * });
+ * ```
+ */
+export function useResourceCollection(options) {
+    const { listFn, org, query = "", scope = "org", page = 1, pageSize = DEFAULT_PAGE_SIZE, sort = null, onSortChange, columns = [], enableSelection = false, } = options;
+    // --- Data fetching via useFetch -----------------------------------------
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(listFn && org
+        ? async () => {
+            const params = {
+                org,
+                query: query || undefined,
+                excludePublic: false,
+                crossOrgPublic: scope === "all",
+                page: { num: page, size: pageSize },
+            };
+            const result = await listFn(params);
+            return {
+                entries: [...result.entries],
+                totalCount: result.totalCount,
+                totalPages: result.totalPages,
+            };
+        }
+        : null, [listFn, org, query, scope, page, pageSize], INITIAL_DATA);
+    const items = data.entries;
+    // --- TanStack Table sorting bridge --------------------------------------
+    const sortingState = useMemo(() => {
+        if (!sort)
+            return [];
+        return [{ id: sort.id, desc: sort.direction === "desc" }];
+    }, [sort]);
+    const onSortChangeRef = useRef(onSortChange);
+    onSortChangeRef.current = onSortChange;
+    const handleSortingChange = useCallback((updater) => {
+        const next = typeof updater === "function" ? updater(sortingState) : updater;
+        if (next.length === 0) {
+            onSortChangeRef.current?.(null);
+        }
+        else {
+            const col = next[0];
+            onSortChangeRef.current?.({
+                id: col.id,
+                direction: (col.desc ? "desc" : "asc"),
+            });
+        }
+    }, [sortingState]);
+    // --- Row selection state ------------------------------------------------
+    const [rowSelection, setRowSelection] = useState({});
+    // Clear selection when page, query, or scope changes to prevent stale refs.
+    const clearKey = `${page}-${query}-${scope}`;
+    const prevClearKey = useRef(clearKey);
+    useEffect(() => {
+        if (prevClearKey.current !== clearKey) {
+            prevClearKey.current = clearKey;
+            setRowSelection({});
+        }
+    }, [clearKey]);
+    // --- TanStack Table column conversion -----------------------------------
+    const tanstackColumns = useMemo(() => {
+        return columns.map((col) => ({
+            id: col.id,
+            header: col.header,
+            cell: (info) => col.cell(info.row.original),
+            enableSorting: col.sortable ?? false,
+            size: col.minWidth,
+            minSize: col.minWidth,
+        }));
+    }, [columns]);
+    // --- TanStack Table instance -------------------------------------------
+    const table = useReactTable({
+        data: items,
+        columns: tanstackColumns,
+        state: {
+            sorting: sortingState,
+            rowSelection,
+        },
+        onSortingChange: handleSortingChange,
+        onRowSelectionChange: enableSelection ? setRowSelection : undefined,
+        getCoreRowModel: getCoreRowModel(),
+        getSortedRowModel: getSortedRowModel(),
+        getRowId: (row) => row.id ?? String(items.indexOf(row)),
+        manualPagination: true,
+        manualSorting: true,
+        enableRowSelection: enableSelection,
+    });
+    const tableOrNull = tanstackColumns.length > 0 ? table : null;
+    return {
+        items,
+        totalCount: data.totalCount,
+        totalPages: data.totalPages,
+        currentPage: page,
+        isLoading,
+        isRefetching,
+        error,
+        refetch,
+        table: tableOrNull,
+        rowSelection,
+        setRowSelection,
+    };
+}
+//# sourceMappingURL=useResourceCollection.js.map

package/resource-workbench/hooks/useResourceCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceCollection.js","sourceRoot":"","sources":["../../../src/resource-workbench/hooks/useResourceCollection.ts"],"names":[],"mappings":"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"}

package/resource-workbench/hooks/useResourceFilters.d.ts

@@ -0,0 +1,73 @@
+import type { FilterValue, FilterDef, SortValue, SortDef } from "../types";
+/** Options for {@link useResourceFilters}. */
+export interface UseResourceFiltersOptions {
+    /** Available filter definitions. Determines which properties can be filtered. */
+    readonly filterDefs?: readonly FilterDef[];
+    /** Available sort definitions. Determines which properties can be sorted. */
+    readonly sortDefs?: readonly SortDef[];
+    /** Initial active filters (e.g. restored from URL params on mount). */
+    readonly initialFilters?: readonly FilterValue[];
+    /** Initial active sort (e.g. restored from URL params on mount). */
+    readonly initialSort?: SortValue | null;
+    /** Initial search query (e.g. restored from URL params on mount). */
+    readonly initialQuery?: string;
+    /**
+     * Called whenever filter, sort, or query state changes. The consumer
+     * uses this to sync state to URL search params or any other
+     * persistence layer. The hook itself has zero router dependency.
+     */
+    readonly onStateChange?: (state: FilterSortState) => void;
+    /** Debounce delay in milliseconds for the search query. @default 300 */
+    readonly queryDebounceMs?: number;
+}
+/** Serializable snapshot of filter + sort + query state. */
+export interface FilterSortState {
+    readonly filters: readonly FilterValue[];
+    readonly sort: SortValue | null;
+    readonly query: string;
+}
+/** Return value of {@link useResourceFilters}. */
+export interface UseResourceFiltersReturn {
+    /** Current active filters. */
+    readonly filters: readonly FilterValue[];
+    /** Add a filter. If a filter with the same `filterId` + `operator` exists, it is replaced. */
+    readonly addFilter: (filter: FilterValue) => void;
+    /** Remove a specific filter by its `filterId`. Removes all operators for that filter. */
+    readonly removeFilter: (filterId: string) => void;
+    /** Remove all active filters. */
+    readonly clearFilters: () => void;
+    /** Current active sort, or `null` if unsorted. */
+    readonly sort: SortValue | null;
+    /** Set the active sort. Pass `null` to clear sorting. */
+    readonly setSort: (sort: SortValue | null) => void;
+    /** The raw search query as typed by the user. */
+    readonly query: string;
+    /** The debounced search query (safe to pass to data-fetching hooks). */
+    readonly debouncedQuery: string;
+    /** Update the raw search query. Debouncing is handled internally. */
+    readonly setQuery: (query: string) => void;
+    /** `true` when any filters are active. */
+    readonly hasActiveFilters: boolean;
+}
+/**
+ * Headless hook that manages filter, sort, and search query state for
+ * a resource collection.
+ *
+ * State changes are communicated to the consumer via `onStateChange`
+ * so they can be synced to URL search params. The hook itself has
+ * **zero router dependency** (DD-004 compliance).
+ *
+ * Platform builders use this alongside {@link useResourceCollection}
+ * for full control. The `ResourceWorkbench` shell composes both.
+ *
+ * @example
+ * ```tsx
+ * const filters = useResourceFilters({
+ *   filterDefs: agentFilterDefs,
+ *   sortDefs: agentSortDefs,
+ *   onStateChange: (state) => syncToUrl(state),
+ * });
+ * ```
+ */
+export declare function useResourceFilters(options?: UseResourceFiltersOptions): UseResourceFiltersReturn;
+//# sourceMappingURL=useResourceFilters.d.ts.map

package/resource-workbench/hooks/useResourceFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceFilters.d.ts","sourceRoot":"","sources":["../../../src/resource-workbench/hooks/useResourceFilters.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,OAAO,EACR,MAAM,UAAU,CAAC;AAMlB,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3C,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACjD,oEAAoE;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACxC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1D,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAMD,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IAClD,yFAAyF;IACzF,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,iCAAiC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;IAClC,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IACnD,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,0CAA0C;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAQD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CAoH1B"}

package/resource-workbench/hooks/useResourceFilters.js

@@ -0,0 +1,105 @@
+"use client";
+import { useCallback, useRef, useState } from "react";
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+const DEFAULT_DEBOUNCE_MS = 300;
+/**
+ * Headless hook that manages filter, sort, and search query state for
+ * a resource collection.
+ *
+ * State changes are communicated to the consumer via `onStateChange`
+ * so they can be synced to URL search params. The hook itself has
+ * **zero router dependency** (DD-004 compliance).
+ *
+ * Platform builders use this alongside {@link useResourceCollection}
+ * for full control. The `ResourceWorkbench` shell composes both.
+ *
+ * @example
+ * ```tsx
+ * const filters = useResourceFilters({
+ *   filterDefs: agentFilterDefs,
+ *   sortDefs: agentSortDefs,
+ *   onStateChange: (state) => syncToUrl(state),
+ * });
+ * ```
+ */
+export function useResourceFilters(options = {}) {
+    const { initialFilters = [], initialSort = null, initialQuery = "", onStateChange, queryDebounceMs = DEFAULT_DEBOUNCE_MS, } = options;
+    const [filters, setFilters] = useState(initialFilters);
+    const [sort, setSortState] = useState(initialSort);
+    const [query, setQueryState] = useState(initialQuery);
+    const [debouncedQuery, setDebouncedQuery] = useState(initialQuery);
+    // Stable ref for the callback to avoid re-triggering effects.
+    const onStateChangeRef = useRef(onStateChange);
+    onStateChangeRef.current = onStateChange;
+    const notify = useCallback((nextFilters, nextSort, nextQuery) => {
+        onStateChangeRef.current?.({
+            filters: nextFilters,
+            sort: nextSort,
+            query: nextQuery,
+        });
+    }, []);
+    // --- Query debounce ----------------------------------------------------
+    const debounceTimerRef = useRef(undefined);
+    const setQuery = useCallback((value) => {
+        setQueryState(value);
+        clearTimeout(debounceTimerRef.current);
+        debounceTimerRef.current = setTimeout(() => {
+            setDebouncedQuery(value);
+            // Notify uses the latest filter/sort state via closure.
+            // Since we can't read state synchronously inside a timeout,
+            // we use refs for filters and sort below.
+        }, queryDebounceMs);
+    }, [queryDebounceMs]);
+    // Refs for latest state (used in debounce callback).
+    const filtersRef = useRef(filters);
+    filtersRef.current = filters;
+    const sortRef = useRef(sort);
+    sortRef.current = sort;
+    // Notify on debounced query change.
+    const prevDebouncedQuery = useRef(debouncedQuery);
+    if (prevDebouncedQuery.current !== debouncedQuery) {
+        prevDebouncedQuery.current = debouncedQuery;
+        notify(filtersRef.current, sortRef.current, debouncedQuery);
+    }
+    // --- Filter actions ----------------------------------------------------
+    const addFilter = useCallback((filter) => {
+        setFilters((prev) => {
+            const next = prev.filter((f) => !(f.filterId === filter.filterId && f.operator === filter.operator));
+            const updated = [...next, filter];
+            notify(updated, sortRef.current, prevDebouncedQuery.current);
+            return updated;
+        });
+    }, [notify]);
+    const removeFilter = useCallback((filterId) => {
+        setFilters((prev) => {
+            const updated = prev.filter((f) => f.filterId !== filterId);
+            notify(updated, sortRef.current, prevDebouncedQuery.current);
+            return updated;
+        });
+    }, [notify]);
+    const clearFilters = useCallback(() => {
+        setFilters([]);
+        notify([], sortRef.current, prevDebouncedQuery.current);
+    }, [notify]);
+    // --- Sort action -------------------------------------------------------
+    const setSort = useCallback((nextSort) => {
+        setSortState(nextSort);
+        sortRef.current = nextSort;
+        notify(filtersRef.current, nextSort, prevDebouncedQuery.current);
+    }, [notify]);
+    return {
+        filters,
+        addFilter,
+        removeFilter,
+        clearFilters,
+        sort,
+        setSort,
+        query,
+        debouncedQuery,
+        setQuery,
+        hasActiveFilters: filters.length > 0,
+    };
+}
+//# sourceMappingURL=useResourceFilters.js.map

package/resource-workbench/hooks/useResourceFilters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceFilters.js","sourceRoot":"","sources":["../../../src/resource-workbench/hooks/useResourceFilters.ts"],"names":[],"mappings":"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"}

package/resource-workbench/hooks/useResourceSelection.d.ts

@@ -0,0 +1,44 @@
+/** Return value of {@link useResourceSelection}. */
+export interface UseResourceSelectionReturn<TData> {
+    /** Set of currently selected item IDs. */
+    readonly selectedIds: ReadonlySet<string>;
+    /** The full selected items (resolved from the current items array). */
+    readonly selectedItems: readonly TData[];
+    /** Number of selected items. */
+    readonly selectedCount: number;
+    /** `true` when at least one item is selected. */
+    readonly hasSelection: boolean;
+    /** `true` when all visible items are selected. */
+    readonly allSelected: boolean;
+    /** `true` when some (but not all) visible items are selected. */
+    readonly someSelected: boolean;
+    /** Toggle a single item's selection state. */
+    readonly toggleItem: (id: string) => void;
+    /**
+     * Range-select from the last toggled item to the given ID (shift-click).
+     * Selects all items between them (inclusive).
+     */
+    readonly rangeSelectTo: (id: string) => void;
+    /** Select or deselect all visible items. */
+    readonly toggleAll: () => void;
+    /** Clear all selections. */
+    readonly clearSelection: () => void;
+}
+/**
+ * Headless hook that manages selection state for a resource collection.
+ *
+ * Supports single toggle, shift-click range selection, select-all, and
+ * automatic clearing when the items array identity changes (page or
+ * filter change).
+ *
+ * @param items      The current page of items. Used to resolve selected
+ *                   items and to implement range selection.
+ * @param getItemId  Extracts a stable unique ID from an item.
+ *
+ * @example
+ * ```tsx
+ * const selection = useResourceSelection(items, (item) => item.id);
+ * ```
+ */
+export declare function useResourceSelection<TData>(items: readonly TData[], getItemId: (item: TData) => string): UseResourceSelectionReturn<TData>;
+//# sourceMappingURL=useResourceSelection.d.ts.map

package/resource-workbench/hooks/useResourceSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceSelection.d.ts","sourceRoot":"","sources":["../../../src/resource-workbench/hooks/useResourceSelection.ts"],"names":[],"mappings":"AAIA,oDAAoD;AACpD,MAAM,WAAW,0BAA0B,CAAC,KAAK;IAC/C,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,SAAS,KAAK,EAAE,CAAC;IACzC,gCAAgC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EACxC,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,GACjC,0BAA0B,CAAC,KAAK,CAAC,CA+HnC"}

package/resource-workbench/hooks/useResourceSelection.js

@@ -0,0 +1,123 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+/**
+ * Headless hook that manages selection state for a resource collection.
+ *
+ * Supports single toggle, shift-click range selection, select-all, and
+ * automatic clearing when the items array identity changes (page or
+ * filter change).
+ *
+ * @param items      The current page of items. Used to resolve selected
+ *                   items and to implement range selection.
+ * @param getItemId  Extracts a stable unique ID from an item.
+ *
+ * @example
+ * ```tsx
+ * const selection = useResourceSelection(items, (item) => item.id);
+ * ```
+ */
+export function useResourceSelection(items, getItemId) {
+    const [selectedIds, setSelectedIds] = useState(new Set());
+    // Track the last toggled item for shift-click range selection.
+    const lastToggledRef = useRef(null);
+    // Clear selection when items change (page navigation, filter change).
+    // We use the length + first/last ID as a heuristic to detect a new page
+    // without requiring referential stability on the items array.
+    const itemsKey = useMemo(() => {
+        if (items.length === 0)
+            return "empty";
+        const first = getItemId(items[0]);
+        const last = getItemId(items[items.length - 1]);
+        return `${items.length}:${first}:${last}`;
+    }, [items, getItemId]);
+    const prevItemsKey = useRef(itemsKey);
+    useEffect(() => {
+        if (prevItemsKey.current !== itemsKey) {
+            prevItemsKey.current = itemsKey;
+            setSelectedIds(new Set());
+            lastToggledRef.current = null;
+        }
+    }, [itemsKey]);
+    const toggleItem = useCallback((id) => {
+        setSelectedIds((prev) => {
+            const next = new Set(prev);
+            if (next.has(id)) {
+                next.delete(id);
+            }
+            else {
+                next.add(id);
+            }
+            lastToggledRef.current = id;
+            return next;
+        });
+    }, []);
+    const rangeSelectTo = useCallback((id) => {
+        const lastId = lastToggledRef.current;
+        if (!lastId) {
+            // No previous anchor — fall back to single toggle.
+            setSelectedIds((prev) => {
+                const next = new Set(prev);
+                next.add(id);
+                return next;
+            });
+            lastToggledRef.current = id;
+            return;
+        }
+        const ids = items.map(getItemId);
+        const anchorIndex = ids.indexOf(lastId);
+        const targetIndex = ids.indexOf(id);
+        if (anchorIndex === -1 || targetIndex === -1) {
+            // One of the endpoints isn't in the current list — single toggle.
+            setSelectedIds((prev) => {
+                const next = new Set(prev);
+                next.add(id);
+                return next;
+            });
+            lastToggledRef.current = id;
+            return;
+        }
+        const start = Math.min(anchorIndex, targetIndex);
+        const end = Math.max(anchorIndex, targetIndex);
+        const rangeIds = ids.slice(start, end + 1);
+        setSelectedIds((prev) => {
+            const next = new Set(prev);
+            for (const rangeId of rangeIds) {
+                next.add(rangeId);
+            }
+            return next;
+        });
+        lastToggledRef.current = id;
+    }, [items, getItemId]);
+    const toggleAll = useCallback(() => {
+        const allIds = items.map(getItemId);
+        setSelectedIds((prev) => {
+            const allCurrentlySelected = allIds.every((id) => prev.has(id));
+            if (allCurrentlySelected) {
+                return new Set();
+            }
+            return new Set(allIds);
+        });
+    }, [items, getItemId]);
+    const clearSelection = useCallback(() => {
+        setSelectedIds(new Set());
+        lastToggledRef.current = null;
+    }, []);
+    const selectedItems = useMemo(() => items.filter((item) => selectedIds.has(getItemId(item))), [items, selectedIds, getItemId]);
+    const selectedCount = selectedIds.size;
+    const hasSelection = selectedCount > 0;
+    const allSelected = items.length > 0 && items.every((item) => selectedIds.has(getItemId(item)));
+    const someSelected = hasSelection && !allSelected;
+    return {
+        selectedIds,
+        selectedItems,
+        selectedCount,
+        hasSelection,
+        allSelected,
+        someSelected,
+        toggleItem,
+        rangeSelectTo,
+        toggleAll,
+        clearSelection,
+    };
+}
+//# sourceMappingURL=useResourceSelection.js.map

package/resource-workbench/hooks/useResourceSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceSelection.js","sourceRoot":"","sources":["../../../src/resource-workbench/hooks/useResourceSelection.ts"],"names":[],"mappings":"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"}

package/resource-workbench/hooks/useViewPreference.d.ts

@@ -0,0 +1,32 @@
+import type { ViewMode } from "../types";
+/** Return value of {@link useViewPreference}. */
+export interface UseViewPreferenceReturn {
+    /** The currently active view mode. */
+    readonly viewMode: ViewMode;
+    /** Update the view mode. Persists to localStorage when a storage key is provided. */
+    readonly setViewMode: (mode: ViewMode) => void;
+}
+/**
+ * Persists the user's preferred view mode (table / cards / list) in
+ * localStorage, scoped by a caller-provided storage key.
+ *
+ * Falls back to `defaultMode` when no persisted value exists or when
+ * the stored value is invalid (forward-compatible with future modes).
+ *
+ * Pass `undefined` for `storageKey` to use an ephemeral (non-persisted)
+ * view mode that resets on unmount.
+ *
+ * @param storageKey  localStorage key (e.g. `"stigmer:workbench:agents:viewMode"`).
+ *                    Pass `undefined` to disable persistence.
+ * @param defaultMode The view mode to use when no persisted value exists.
+ *
+ * @example
+ * ```tsx
+ * const { viewMode, setViewMode } = useViewPreference(
+ *   "stigmer:workbench:agents:viewMode",
+ *   "table",
+ * );
+ * ```
+ */
+export declare function useViewPreference(storageKey: string | undefined, defaultMode: ViewMode): UseViewPreferenceReturn;
+//# sourceMappingURL=useViewPreference.d.ts.map

package/resource-workbench/hooks/useViewPreference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewPreference.d.ts","sourceRoot":"","sources":["../../../src/resource-workbench/hooks/useViewPreference.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;CAChD;AAYD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,QAAQ,GACpB,uBAAuB,CA0BzB"}

package/resource-workbench/hooks/useViewPreference.js

@@ -0,0 +1,60 @@
+"use client";
+import { useCallback, useState } from "react";
+const VALID_MODES = new Set([
+    "table",
+    "cards",
+    "list",
+]);
+function isValidMode(value) {
+    return VALID_MODES.has(value);
+}
+/**
+ * Persists the user's preferred view mode (table / cards / list) in
+ * localStorage, scoped by a caller-provided storage key.
+ *
+ * Falls back to `defaultMode` when no persisted value exists or when
+ * the stored value is invalid (forward-compatible with future modes).
+ *
+ * Pass `undefined` for `storageKey` to use an ephemeral (non-persisted)
+ * view mode that resets on unmount.
+ *
+ * @param storageKey  localStorage key (e.g. `"stigmer:workbench:agents:viewMode"`).
+ *                    Pass `undefined` to disable persistence.
+ * @param defaultMode The view mode to use when no persisted value exists.
+ *
+ * @example
+ * ```tsx
+ * const { viewMode, setViewMode } = useViewPreference(
+ *   "stigmer:workbench:agents:viewMode",
+ *   "table",
+ * );
+ * ```
+ */
+export function useViewPreference(storageKey, defaultMode) {
+    const [viewMode, setViewModeState] = useState(() => {
+        if (!storageKey || typeof window === "undefined")
+            return defaultMode;
+        try {
+            const stored = localStorage.getItem(storageKey);
+            if (stored && isValidMode(stored))
+                return stored;
+        }
+        catch {
+            // localStorage may be unavailable (e.g. sandboxed iframe).
+        }
+        return defaultMode;
+    });
+    const setViewMode = useCallback((mode) => {
+        setViewModeState(mode);
+        if (!storageKey)
+            return;
+        try {
+            localStorage.setItem(storageKey, mode);
+        }
+        catch {
+            // Silently ignore write failures.
+        }
+    }, [storageKey]);
+    return { viewMode, setViewMode };
+}
+//# sourceMappingURL=useViewPreference.js.map

package/resource-workbench/hooks/useViewPreference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewPreference.js","sourceRoot":"","sources":["../../../src/resource-workbench/hooks/useViewPreference.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAW9C,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAW;IACzD,OAAO;IACP,OAAO;IACP,MAAM;CACP,CAAC,CAAC;AAEH,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAA8B,EAC9B,WAAqB;IAErB,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAW,GAAG,EAAE;QAC3D,IAAI,CAAC,UAAU,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,WAAW,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAChD,IAAI,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,IAAc,EAAE,EAAE;QACjB,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,UAAU;YAAE,OAAO;QACxB,IAAI,CAAC;YACH,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC"}

package/resource-workbench/index.d.ts

@@ -0,0 +1,34 @@
+export type { ViewMode, StatusPhase, WorkbenchColumnDef, FilterOperator, FilterValue, FilterDef, FilterOption, SortDirection, SortValue, SortDef, ResourceAction, BulkAction, WorkbenchState, } from "./types";
+export { useViewPreference } from "./hooks/useViewPreference";
+export type { UseViewPreferenceReturn } from "./hooks/useViewPreference";
+export { useResourceCollection } from "./hooks/useResourceCollection";
+export type { UseResourceCollectionOptions, UseResourceCollectionReturn, } from "./hooks/useResourceCollection";
+export { useResourceSelection } from "./hooks/useResourceSelection";
+export type { UseResourceSelectionReturn } from "./hooks/useResourceSelection";
+export { useResourceFilters } from "./hooks/useResourceFilters";
+export type { UseResourceFiltersOptions, UseResourceFiltersReturn, FilterSortState, } from "./hooks/useResourceFilters";
+export { StatusBadge } from "./components/StatusBadge";
+export type { StatusBadgeProps } from "./components/StatusBadge";
+export { ColumnHeader } from "./components/ColumnHeader";
+export type { ColumnHeaderProps } from "./components/ColumnHeader";
+export { SelectionCheckbox } from "./components/SelectionCheckbox";
+export type { SelectionCheckboxProps } from "./components/SelectionCheckbox";
+export { ResourceTable } from "./components/ResourceTable";
+export type { ResourceTableProps } from "./components/ResourceTable";
+export { ResourceCards } from "./components/ResourceCards";
+export type { ResourceCardsProps } from "./components/ResourceCards";
+export { ResourceList } from "./components/ResourceList";
+export type { ResourceListProps } from "./components/ResourceList";
+export { BulkActionBar } from "./components/BulkActionBar";
+export type { BulkActionBarProps } from "./components/BulkActionBar";
+export { FilterBar } from "./components/FilterBar";
+export type { FilterBarProps } from "./components/FilterBar";
+export { ViewSwitcher } from "./components/ViewSwitcher";
+export type { ViewSwitcherProps } from "./components/ViewSwitcher";
+export { ResourceInspector } from "./components/ResourceInspector";
+export type { ResourceInspectorProps } from "./components/ResourceInspector";
+export { ResourceWorkbench } from "./components/ResourceWorkbench";
+export type { ResourceWorkbenchProps } from "./components/ResourceWorkbench";
+export { ResourceAvatar } from "./components/ResourceAvatar";
+export type { ResourceAvatarProps } from "./components/ResourceAvatar";
+//# sourceMappingURL=index.d.ts.map