@jielga/tmdatagrid 2.0.0-beta.9 → 2.0.1

package/src/{tmdatagrid/core → core}/persistence.ts

@@ -188,12 +188,26 @@ const SLICE_GUARDS: Record<
     isRecordOf(value, (entry) => typeof entry === "boolean"),
   columnSizing: (value) => isRecordOf(value, isFiniteNumber),
   columnOrder: (value) => isArrayOf(value, isString),
+  // Both the current logical shape and the physical one 1.x wrote.
   columnPinning: (value) =>
-    isArrayOf(prop(value, "left"), isString) &&
-    isArrayOf(prop(value, "right"), isString),
+    (isArrayOf(prop(value, "start"), isString) &&
+      isArrayOf(prop(value, "end"), isString)) ||
+    (isArrayOf(prop(value, "left"), isString) &&
+      isArrayOf(prop(value, "right"), isString)),
   grouping: (value) => isArrayOf(value, isString),
 };
 
+/**
+ * Settings saved by 1.x used TanStack's old physical `columnPinning` keys.
+ * Rewrite them once on read, so nothing downstream sees `left` / `right`.
+ */
+function normalizeColumnPinning(value: unknown): unknown {
+  const left = prop(value, "left");
+  const right = prop(value, "right");
+  if (left === undefined || right === undefined) return value;
+  return { start: left, end: right };
+}
+
 function isValidSlice(slice: keyof GridState, value: unknown): boolean {
   const guard = SLICE_GUARDS[slice as keyof typeof SLICE_GUARDS];
   return guard === undefined || guard(value);
@@ -219,7 +233,10 @@ function readSlices(
     for (const slice of resolved.slices) {
       if (!(slice in record)) continue;
       if (!isValidSlice(slice, record[slice])) continue;
-      restored[slice] = record[slice];
+      restored[slice] =
+        slice === "columnPinning"
+          ? normalizeColumnPinning(record[slice])
+          : record[slice];
     }
     return restored as Partial<GridState>;
   } catch {
@@ -323,8 +340,8 @@ function realignToColumns(
   }
   if (restored.columnPinning) {
     realigned.columnPinning = {
-      left: keepIds(restored.columnPinning.left ?? []),
-      right: keepIds(restored.columnPinning.right ?? []),
+      start: keepIds(restored.columnPinning.start ?? []),
+      end: keepIds(restored.columnPinning.end ?? []),
     };
   }
   if (restored.sorting) realigned.sorting = keepEntries(restored.sorting);

package/src/{tmdatagrid/core → core}/summary.ts

@@ -1,6 +1,10 @@
-import { aggregationFns, type RowData } from "@tanstack/react-table";
+import {
+  type AggregationContext,
+  aggregationFns,
+  type RowData,
+} from "@tanstack/react-table";
 import type { TMDataGridRowData } from "../TMDataGridContext";
-import type { TMDataGridTable } from "../useTMDataGrid";
+import type { TMDataGridFeatures, TMDataGridTable } from "../useTMDataGrid";
 
 /** The registered aggregation names - the same set `aggregationFn` accepts. */
 export type TMDataGridAggregationName = keyof typeof aggregationFns;
@@ -33,11 +37,23 @@ export function aggregateColumn<TData extends RowData>({
   fn?: TMDataGridAggregationName;
 }): unknown {
   const erased = table as unknown as TMDataGridTable<TMDataGridRowData>;
+  const column = erased.getColumn(columnId);
+  // A summary for a column the table does not hold has no value.
+  if (!column) return undefined;
   // `flatRows`, not `rows`: the filtered model nests under `getSubRows`, and
   // the top-level array would total a tree's roots and drop every child.
   // Grouping does not nest it - the group rows are built from this model, not
   // held in it - so a grouped grid is unaffected either way.
   const rows = erased.getFilteredRowModel().flatRows;
-  // Leaf and child rows are the same set here: this is already every row.
-  return aggregationFns[fn](columnId, rows, rows);
+  // The rows are already every row, so there is nothing below them to select:
+  // `maxDepth: 0`, and no `subRows` or `groupingRow` - this is not a group.
+  const context: AggregationContext<TMDataGridFeatures, TMDataGridRowData> = {
+    column,
+    columnId,
+    maxDepth: 0,
+    getValue: (row) => row.getValue(columnId),
+    rows,
+    table: erased,
+  };
+  return aggregationFns[fn].aggregate(context);
 }

package/src/{tmdatagrid/index.ts → index.ts}

@@ -8,14 +8,12 @@ export { SELECT_COLUMN_ID } from "./components/TMDataGridSelectColumn";
 export { DETAILS_COLUMN_ID } from "./components/TMDataGridDetailsColumn";
 export { EDIT_COLUMN_ID } from "./components/TMDataGridEditColumn";
 export { ROW_NUMBER_COLUMN_ID } from "./components/TMDataGridRowNumberColumn";
-export {
-  formatGroupValue,
-  GROUP_COLUMN_ID,
-} from "./components/TMDataGridGroupColumn";
+export { GROUP_COLUMN_ID } from "./components/TMDataGridGroupColumn";
+export { formatGroupValue } from "./core/grouping";
 export {
   createTMDataGridColumnHelper,
+  type TMDataGridColumnHelper,
   openColumnFilter,
-  tmDataGridFeatures,
   type TMDataGridApi,
   type TMDataGridColumnMeta,
   type TMDataGridDetailsArgs,
@@ -32,6 +30,10 @@ export {
   useTMDataGrid,
   type UseTMDataGridOptions,
 } from "./useTMDataGrid";
+export {
+  useTMDataGridExport,
+  type TMDataGridExportApi,
+} from "./useTMDataGridExport";
 export {
   TMDataGridFilterPills,
   type TMDataGridFilterPillsProps,
@@ -40,14 +42,22 @@ export {
   TMDataGridSearch,
   type TMDataGridSearchProps,
 } from "./components/TMDataGridSearch";
+export type {
+  TMDataGridMenuColumnsProps,
+  TMDataGridMenuExportProps,
+  TMDataGridMenuProps,
+} from "./components/TMDataGridMenu";
 export {
+  type TMDataGridColumnFilter,
   type TMDataGridColumnType,
   type TMDataGridFilterOperator,
   type TMDataGridFilterValue,
+  type TMDataGridFilterValueShape,
+  activeColumnFilters,
   emptyValueForOperator,
   FILTER_OPERATOR_LABELS,
+  filterValueShape,
   formatFilterLabel,
-  getDefaultOperator,
   getOperatorsForType,
   isFilterActive,
   operatorNeedsValue,
@@ -76,17 +86,19 @@ export {
 export {
   clearedValueForType,
   getEditFieldName,
+  hasPendingEdits,
   normalizeFieldValidate,
   type TMDataGridColumnEditOptions,
   type TMDataGridEditApi,
   type TMDataGridEditChange,
   type TMDataGridEditCommitArgs,
   type TMDataGridSaveDraftsArgs,
-  type TMDataGridSaveDraftsResult,
+  type TMDataGridSaveDraftsResponse,
   type TMDataGridSaveOutcomes,
-  type TMDataGridEditCommitDraftsArgs,
   type TMDataGridAddRowsOptions,
   type TMDataGridAddRowsResult,
+  type TMDataGridCommitAllResult,
+  type TMDataGridSaveDraftsResult,
   type TMDataGridEditField,
   type TMDataGridEditMode,
   type TMDataGridEditorArgs,
@@ -108,7 +120,18 @@ export type {
   TMDataGridColumnFilterOptions,
   TMDataGridFilterControlArgs,
   TMDataGridFilterControlComponent,
+  TMDataGridFilterControlLayout,
+  TMDataGridFilterPanelLayout,
 } from "./core/filterControls";
+export type {
+  TMDataGridFiltersOptions,
+  TMDataGridFiltersSettings,
+  TMDataGridFilterSidebarSide,
+  TMDataGridFilterSurface,
+} from "./core/filterSurface";
+export type { TMDataGridFilterPanelProps } from "./components/TMDataGridFilterPanel";
+export type { TMDataGridColumnsPanelProps } from "./components/TMDataGridColumnsPanel";
+export type { TMDataGridToolbarProps } from "./components/TMDataGridToolbar";
 export { TMDataGridFilterValueInput } from "./components/filters/TMDataGridFilterValueInput";
 export { DgRangeSliderFilter } from "./components/filters/DgRangeSliderFilter";
 export { DgDateRangeFilter } from "./components/filters/DgDateRangeFilter";
@@ -129,50 +152,61 @@ export {
 export { TMDATAGRID_LABELS_SV } from "./core/labelsSv";
 export {
   getColumnDefaultOperator,
-  getColumnFilterControl,
+  getColumnOperators,
   getColumnLabel,
   getColumnType,
-  isColumnEditableForRow,
-  isColumnReorderable,
   isControlColumn,
   isGeneratedColumn,
+  type TMDataGridColumnSearchable,
 } from "./core/columnUtils";
 export { getGroupDataRows } from "./core/grouping";
 export {
   aggregateColumn,
   type TMDataGridAggregationName,
 } from "./core/summary";
-export { autosizeColumn, measureColumnContentWidth } from "./core/autosize";
+export { autosizeColumn } from "./core/autosize";
 export {
-  isSameCell,
-  resolveCellMove,
-  type ResolveCellMoveArgs,
-  type TMDataGridCellCoords,
   type TMDataGridCellPosition,
 } from "./core/cellNavigation";
 export {
-  boundsCellCount,
-  boundsEdges,
-  isWithinBounds,
   resolveRangeBounds,
   type ResolveRangeBoundsArgs,
   type TMDataGridCellRange,
   type TMDataGridRangeBounds,
 } from "./core/cellRange";
 export {
-  buildCellMatrix,
-  buildGridCellMatrix,
-  DEFAULT_CELL_EXPORT_OPTIONS,
-  downloadTextFile,
-  exportGridToCsv,
+  buildExportData,
+  countSelectedExportRows,
+  csvExcelFormat,
+  csvFormat,
+  DEFAULT_EXPORT_OPTIONS,
+  downloadFile,
+  exportGrid,
   formatExportValue,
+  getExportableColumns,
+  guardFormula,
+  jsonFormat,
+  resolveExportOptions,
   toClipboardText,
-  toExcelCsv,
+  tsvFormat,
   writeClipboardText,
-  type BuildCellMatrixArgs,
-  type TMDataGridCellExportOptions,
-  type TMDataGridCellMatrix,
-} from "./core/cellExport";
+  writeExportFile,
+  type BuildExportDataArgs,
+  type ExportGridArgs,
+  type TMDataGridClipboardTextOptions,
+  type TMDataGridCsvFormatOptions,
+  type TMDataGridExportColumns,
+  type TMDataGridExportData,
+  type TMDataGridExportFormat,
+  type TMDataGridExportOptions,
+  type TMDataGridExportPickerRequest,
+  type TMDataGridExportRows,
+  type TMDataGridExportSettings,
+  type TMDataGridExportValueGetter,
+  type TMDataGridExportWriteOptions,
+  type TMDataGridJsonFormatOptions,
+  type TMDataGridTsvFormatOptions,
+} from "./core/export";
 export {
   areAllRowsExpanded,
   resolveExpandAll,
@@ -227,8 +261,6 @@ export {
 } from "./core/persistence";
 export type {
   TMDataGridCellEventArgs,
-  TMDataGridCellNav,
-  TMDataGridColumnLayout,
   TMDataGridRowContextMenuArgs,
   TMDataGridRowContextMenuRenderer,
   TMDataGridRowStyle,
@@ -238,12 +270,14 @@ export type {
   TMDataGridColumnMenuItemsArgs,
   TMDataGridColumnMenuItemsRenderer,
 } from "./components/TMDataGridHeaderCell";
+export type {
+  TMDataGridFooterProps,
+  TMDataGridPaginationControls,
+  TMDataGridPaginationSlotArgs,
+} from "./components/TMDataGridFooter";
 export {
   getTMDataGridPaginationApi,
-  type TMDataGridFooterProps,
   type TMDataGridPaginationActions,
   type TMDataGridPaginationApi,
-  type TMDataGridPaginationControls,
-  type TMDataGridPaginationSlotArgs,
   type TMDataGridPaginationState,
-} from "./components/TMDataGridFooter";
+} from "./core/pagination";