@tanstack/table-core 9.0.0-alpha.6 → 9.0.0-beta.1

package/src/types/TableState.ts

@@ -0,0 +1,100 @@
+import type { UnionToIntersection } from './type-utils'
+import type { TableState_ColumnFiltering } from '../features/column-filtering/columnFilteringFeature.types'
+import type { TableState_ColumnGrouping } from '../features/column-grouping/columnGroupingFeature.types'
+import type { TableState_ColumnOrdering } from '../features/column-ordering/columnOrderingFeature.types'
+import type { TableState_ColumnPinning } from '../features/column-pinning/columnPinningFeature.types'
+import type { TableState_ColumnResizing } from '../features/column-resizing/columnResizingFeature.types'
+import type { TableState_ColumnSizing } from '../features/column-sizing/columnSizingFeature.types'
+import type { TableState_ColumnVisibility } from '../features/column-visibility/columnVisibilityFeature.types'
+import type { TableState_GlobalFiltering } from '../features/global-filtering/globalFilteringFeature.types'
+import type { TableState_RowExpanding } from '../features/row-expanding/rowExpandingFeature.types'
+import type { TableState_RowPagination } from '../features/row-pagination/rowPaginationFeature.types'
+import type { TableState_RowPinning } from '../features/row-pinning/rowPinningFeature.types'
+import type { TableState_RowSelection } from '../features/row-selection/rowSelectionFeature.types'
+import type { TableState_RowSorting } from '../features/row-sorting/rowSortingFeature.types'
+import type { ExtractFeatureTypes, TableFeatures } from './TableFeatures'
+
+/**
+ * Use this interface as a target for declaration merging to add your own state properties.
+ * Note: This will affect the types of all tables in your project.
+ */
+export interface TableState_Plugins<TFeatures extends TableFeatures> {}
+
+/**
+ * Complete table state for a specific feature set.
+ *
+ * State slices are included only when their feature is present in `TFeatures`,
+ * then custom feature/plugin state is mixed in.
+ */
+export type TableState<TFeatures extends TableFeatures> = UnionToIntersection<
+  | ('columnFilteringFeature' extends keyof TFeatures
+      ? TableState_ColumnFiltering
+      : never)
+  | ('columnGroupingFeature' extends keyof TFeatures
+      ? TableState_ColumnGrouping
+      : never)
+  | ('columnOrderingFeature' extends keyof TFeatures
+      ? TableState_ColumnOrdering
+      : never)
+  | ('columnPinningFeature' extends keyof TFeatures
+      ? TableState_ColumnPinning
+      : never)
+  | ('columnResizingFeature' extends keyof TFeatures
+      ? TableState_ColumnResizing
+      : never)
+  | ('columnSizingFeature' extends keyof TFeatures
+      ? TableState_ColumnSizing
+      : never)
+  | ('columnVisibilityFeature' extends keyof TFeatures
+      ? TableState_ColumnVisibility
+      : never)
+  | ('globalFilteringFeature' extends keyof TFeatures
+      ? TableState_GlobalFiltering
+      : never)
+  | ('rowExpandingFeature' extends keyof TFeatures
+      ? TableState_RowExpanding
+      : never)
+  | ('rowPaginationFeature' extends keyof TFeatures
+      ? TableState_RowPagination
+      : never)
+  | ('rowPinningFeature' extends keyof TFeatures
+      ? TableState_RowPinning
+      : never)
+  | ('rowSelectionFeature' extends keyof TFeatures
+      ? TableState_RowSelection
+      : never)
+  | ('rowSortingFeature' extends keyof TFeatures
+      ? TableState_RowSorting
+      : never)
+> &
+  ExtractFeatureTypes<'TableState', TFeatures> &
+  TableState_Plugins<TFeatures>
+
+// export type TableState<TFeatures extends TableFeatures> = ExtractFeatureTypes<
+// export type TableState<TFeatures extends TableFeatures> = ExtractFeatureTypes<
+//   'TableState',
+//   TFeatures
+// > &
+//   TableState_Plugins<TFeatures>
+
+/**
+ * Internal broad state shape containing every stock feature state slice.
+ *
+ * Feature internals use this when they may need to inspect optional slices owned
+ * by other features.
+ */
+export type TableState_All = Partial<
+  TableState_ColumnFiltering &
+    TableState_ColumnGrouping &
+    TableState_ColumnOrdering &
+    TableState_ColumnPinning &
+    TableState_ColumnResizing &
+    TableState_ColumnSizing &
+    TableState_ColumnVisibility &
+    TableState_GlobalFiltering &
+    TableState_RowExpanding &
+    TableState_RowPagination &
+    TableState_RowPinning &
+    TableState_RowSelection &
+    TableState_RowSorting
+>

package/src/types/type-utils.ts

@@ -0,0 +1,84 @@
+export type Updater<T> = T | ((old: T) => T)
+
+export type OnChangeFn<T> = (updaterOrValue: Updater<T>) => void
+
+export type RowData = Record<string, any> | Array<any>
+
+export type CellData = unknown
+
+export type PartialKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>
+
+export type RequiredKeys<T, K extends keyof T> = Omit<T, K> &
+  Required<Pick<T, K>>
+
+export type UnionToIntersection<T> = (
+  T extends any ? (x: T) => any : never
+) extends (x: infer R) => any
+  ? R
+  : never
+
+type ComputeRange<
+  N extends number,
+  Result extends Array<unknown> = [],
+> = Result['length'] extends N
+  ? Result
+  : ComputeRange<N, [...Result, Result['length']]>
+
+type Index40 = ComputeRange<40>[number]
+
+// Is this type a tuple?
+type IsTuple<T> = T extends ReadonlyArray<any> & { length: infer Length }
+  ? Length extends Index40
+    ? T
+    : never
+  : never
+
+// If this type is a tuple, what indices are allowed?
+type AllowedIndexes<
+  Tuple extends ReadonlyArray<any>,
+  Keys extends number = never,
+> = Tuple extends readonly []
+  ? Keys
+  : Tuple extends readonly [infer _, ...infer Tail]
+    ? AllowedIndexes<Tail, Keys | Tail['length']>
+    : Keys
+
+export type DeepKeys<
+  T,
+  TDepth extends Array<any> = [],
+> = TDepth['length'] extends 5
+  ? never
+  : unknown extends T
+    ? string
+    : T extends ReadonlyArray<any> & IsTuple<T>
+      ? AllowedIndexes<T> | DeepKeysPrefix<T, AllowedIndexes<T>, TDepth>
+      : T extends Array<any>
+        ? DeepKeys<T[number], [...TDepth, any]>
+        : T extends Date
+          ? never
+          : T extends object
+            ? (keyof T & string) | DeepKeysPrefix<T, keyof T, TDepth>
+            : never
+
+type DeepKeysPrefix<
+  T,
+  TPrefix,
+  TDepth extends Array<any>,
+> = TPrefix extends keyof T & (number | string)
+  ? `${TPrefix}.${DeepKeys<T[TPrefix], [...TDepth, any]> & string}`
+  : never
+
+export type DeepValue<T, TProp> =
+  T extends Record<string | number, any>
+    ? TProp extends `${infer TBranch}.${infer TDeepProp}`
+      ? DeepValue<T[TBranch], TDeepProp>
+      : T[TProp & string]
+    : never
+
+export type NoInfer<T> = [T][T extends any ? 0 : never]
+
+export type Getter<TValue> = <TTValue = TValue>() => NoInfer<TTValue>
+
+export type Prettify<T> = {
+  [K in keyof T]: T[K]
+} & unknown