@undevy-org/tablewright 0.2.0 → 0.2.2

package/dist/types/hooks/table-orchestration/use-column-filter-stats.d.ts

@@ -0,0 +1,6 @@
+import type { ColumnFilterConfig, FilterStatsSlice } from "../../components/data-table/filter-types.js";
+/**
+ * `all` stats come from every row; `filtered` from the filtered rows, or
+ * `null` while no column filter or search is applied.
+ */
+export declare function useColumnFilterStats<TRow extends object>(rows: TRow[], filteredRows: TRow[], filterConfigs: Record<string, ColumnFilterConfig>, isFiltered: boolean): Record<string, FilterStatsSlice>;

package/dist/types/hooks/table-orchestration/use-column-gaps.d.ts

@@ -0,0 +1,17 @@
+import type { VisibilityState } from "@tanstack/react-table";
+import type { ColumnGap, ColumnGroup } from "../../components/data-table/filter-types.js";
+import type { ColumnMetaDef } from "../../components/data-table/types.js";
+/** Column id of the gap indicator column placed after `afterColumnId` (`null` = at the start). */
+export declare function gapColumnId(afterColumnId: string | null): string;
+/** Gap indicators for hidden columns, plus column meta/widths extended with the gap columns. */
+export declare function useColumnGaps({ columnGroups, toggleableColumnIds, columnVisibility, columnMeta, widths, }: {
+    columnGroups: ColumnGroup[] | undefined;
+    toggleableColumnIds: readonly string[];
+    columnVisibility: VisibilityState;
+    columnMeta: Record<string, ColumnMetaDef>;
+    widths: Record<string, number>;
+}): {
+    columnGaps: ColumnGap[];
+    extendedColumnMeta: Record<string, ColumnMetaDef>;
+    extendedWidths: Record<string, number>;
+};

package/dist/types/hooks/table-orchestration/use-filtered-rows.d.ts

@@ -0,0 +1,15 @@
+import type { ActiveFilter, ViewPreset } from "../../components/data-table/filter-types.js";
+/** Rows after the preset's custom filter, the submitted search and column filters, then sorted. */
+export declare function useFilteredRows<TRow extends object, TViewKey extends string>({ rows, activePreset, searchQuery, columnFilters, currentSort, filterRow, getSearchText, getSortValue, }: {
+    rows: TRow[];
+    activePreset: ViewPreset<TRow, TViewKey>;
+    searchQuery: string;
+    columnFilters: ActiveFilter[];
+    currentSort: {
+        columnId: string;
+        direction: "asc" | "desc";
+    } | null;
+    filterRow: (row: TRow, filter: ActiveFilter) => boolean;
+    getSearchText: (row: TRow) => string;
+    getSortValue: (row: TRow, columnId: string) => string | number;
+}): TRow[];

package/dist/types/hooks/table-orchestration/use-orchestration-actions.d.ts

@@ -0,0 +1,49 @@
+import type { VisibilityState } from "@tanstack/react-table";
+import type { ActiveFilterValue, ColumnFilterConfig, ViewPreset } from "../../components/data-table/filter-types.js";
+import type { ColumnMetaDef } from "../../components/data-table/types.js";
+import { type TableOrchestrationStoreApi } from "../table-orchestration-store.js";
+/**
+ * Store actions bound into stable callbacks with the hook's public signatures
+ * (`handleX` / React-style setters). Each callback's deps are exactly what it
+ * reads, so identities only change when those inputs do.
+ */
+export declare function useOrchestrationActions<TRow extends object, TViewKey extends string>({ store, viewPresets, filterConfigs, columnMeta, setWidths, defaultViewKey, paginatedRows, allOnPageSelected, getRowId, }: {
+    store: TableOrchestrationStoreApi<TViewKey>;
+    viewPresets: ViewPreset<TRow, TViewKey>[];
+    filterConfigs: Record<string, ColumnFilterConfig>;
+    columnMeta: Record<string, ColumnMetaDef>;
+    setWidths: (updater: (prev: Record<string, number>) => Record<string, number>) => void;
+    defaultViewKey: TViewKey;
+    paginatedRows: TRow[];
+    allOnPageSelected: boolean;
+    getRowId: (row: TRow) => string;
+}): {
+    handleSearchSubmit: (e: React.FormEvent) => void;
+    handleHeaderSort: (columnId: string, direction: "asc" | "desc") => void;
+    handleViewChange: (key: TViewKey) => void;
+    handleAddColumnFilter: (columnId: string) => void;
+    handleOpenExistingFilter: (columnId: string) => void;
+    handleRequestOpenHandled: () => void;
+    handleRemoveColumnFilter: (columnId: string) => void;
+    handleChangeColumnFilter: (columnId: string, value: ActiveFilterValue) => void;
+    handleSetColumnFilter: (columnId: string, value: ActiveFilterValue) => void;
+    handleHeaderFilterClick: (columnId: string) => void;
+    handleHideColumn: (columnId: string) => void;
+    handleResetColumns: () => void;
+    handleRemoveSort: () => void;
+    handleRemoveCustomFilter: () => void;
+    handleClearAll: () => void;
+    handleRefresh: () => void;
+    handleToggleRowSelection: (id: string) => void;
+    handleToggleHeaderCheck: () => void;
+    handleExpandRow: (row: TRow, e: React.MouseEvent) => void;
+    handleExpandGap: (hiddenIds: string[]) => void;
+    handlePageChange: (p: number) => void;
+    handleRowsPerPageChange: (value: number) => void;
+    setSearchInput: (v: string) => void;
+    setColumnVisibility: import("react").Dispatch<import("react").SetStateAction<VisibilityState>>;
+    setDensity: (v: "normal" | "dense") => void;
+    setSelectedIds: import("react").Dispatch<import("react").SetStateAction<Set<string>>>;
+    setColumnsMenuOpen: (v: boolean) => void;
+    setSelectedRowId: (v: string | null) => void;
+};

package/dist/types/hooks/table-orchestration/use-responsive-columns.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Responsive column collapse (P1/P2/P3). Only P3 columns collapse below
+ * `wideBreakpoint`; `isCompact` flips below `compactBreakpoint` so consumers
+ * can switch to a card layout. Both start at their "wide" values so the first
+ * client render matches server HTML.
+ */
+export declare function useResponsiveColumns(columnPriorities: Record<string, 2 | 3> | undefined, wideBreakpoint: number, compactBreakpoint: number): {
+    responsiveHiddenColumnIds: ReadonlySet<string>;
+    isCompact: boolean;
+};

package/dist/types/hooks/table-orchestration-store.d.ts

@@ -14,6 +14,7 @@ export interface TableOrchestrationState<TViewKey extends string = string> {
     page: number;
     rowsPerPage: number;
     density: "normal" | "dense";
+    /** @deprecated Demo-only: it only spins for a fixed time (700 ms by default) and refetches nothing. Keep refresh state in your data layer (e.g. your query's `isFetching`). Will be removed in a future minor release. */
     isRefreshing: boolean;
     selectedIds: Set<string>;
     activeView: TViewKey;
@@ -43,6 +44,7 @@ export interface TableOrchestrationActions<TViewKey extends string = string> {
     setPage: (p: number) => void;
     setRowsPerPage: (n: number) => void;
     setDensity: (v: "normal" | "dense") => void;
+    /** @deprecated Demo-only: it only spins for a fixed time (700 ms by default) and refetches nothing. Keep refresh state in your data layer (e.g. your query's `isFetching`). Will be removed in a future minor release. */
     startRefresh: (durationMs?: number) => void;
     setSelectedIds: (next: Set<string> | ((prev: Set<string>) => Set<string>)) => void;
     toggleRowSelection: (id: string) => void;

package/dist/types/hooks/useTableOrchestration.d.ts

@@ -53,6 +53,7 @@ export interface TableOrchestrationReturn<TRow extends object, TViewKey extends
     rowsPerPage: number;
     density: "normal" | "dense";
     setDensity: (v: "normal" | "dense") => void;
+    /** @deprecated Demo-only: it only spins for a fixed time (700 ms by default) and refetches nothing. Keep refresh state in your data layer (e.g. your query's `isFetching`). Will be removed in a future minor release. */
     isRefreshing: boolean;
     selectedIds: Set<string>;
     setSelectedIds: React.Dispatch<React.SetStateAction<Set<string>>>;
@@ -101,6 +102,7 @@ export interface TableOrchestrationReturn<TRow extends object, TViewKey extends
     handleRemoveSort: () => void;
     handleRemoveCustomFilter: () => void;
     handleClearAll: () => void;
+    /** @deprecated Demo-only: it only spins for a fixed time (700 ms by default) and refetches nothing. Keep refresh state in your data layer (e.g. your query's `isFetching`). Will be removed in a future minor release. */
     handleRefresh: () => void;
     handleToggleRowSelection: (id: string) => void;
     handleToggleHeaderCheck: () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undevy-org/tablewright",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "React data-table and application-shell components: filters, drawers, row controls, sortable and resizable columns, built on Radix UI and TanStack Table.",
   "license": "MIT",
   "repository": {

package/dist/types/hooks/useDemoTheme.d.ts

@@ -1,8 +0,0 @@
-export type DemoTheme = "light" | "dark";
-/**
- * Theme state for story demos that render a live theme switch (e.g.
- * SidebarAccountMenu). Callers apply the returned theme to a `data-theme`
- * attribute on a wrapper element around their own content — this hook only
- * owns the state and its localStorage persistence, not the DOM write.
- */
-export declare function useDemoTheme(): [DemoTheme, (theme: DemoTheme) => void];