@undevy-org/tablewright 0.2.1 → 0.3.0

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,15 @@
+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";
+/** 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/index.d.ts

@@ -96,7 +96,7 @@ export { createTableOrchestrationStore, defaultValueForFilter, } from "./hooks/t
 export type { TableOrchestrationState, TableOrchestrationActions, TableOrchestrationStore, TableOrchestrationStoreApi, } from "./hooks/table-orchestration-store.js";
 export { useRowDragOverride } from "./hooks/useRowDragOverride.js";
 export type { UseRowDragOverrideResult } from "./hooks/useRowDragOverride.js";
-export { computeColumnGaps } from "./lib/column-gaps.js";
+export { computeColumnGaps, gapColumnId } from "./lib/column-gaps.js";
 export { computeColumnStats } from "./lib/filter-stats.js";
 export { formatEnumLabel } from "./lib/format-enum.js";
 export { formatDateParts, parsePossibleTimestamp, formatLiveTimestamp, displayTimeZone, } from "./lib/format-timestamp.js";

package/dist/types/lib/column-gaps.d.ts

@@ -1,3 +1,9 @@
 import type { VisibilityState } from "@tanstack/react-table";
 import type { ColumnGap } from "../components/data-table/filter-types.js";
+/**
+ * Column id of the gap indicator column placed after `afterColumnId` (`null` =
+ * at the start). `useTableOrchestration` keys `extendedColumnMeta` /
+ * `extendedWidths` by it, so gap columns you define must use the same id.
+ */
+export declare function gapColumnId(afterColumnId: string | null): string;
 export declare function computeColumnGaps(orderedColumnIds: readonly string[], columnVisibility: VisibilityState): ColumnGap[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undevy-org/tablewright",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "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": {