@tanstack/table-core 9.0.0-alpha.43 → 9.0.0-alpha.47

package/dist/fns/filterFns.js.map

@@ -1 +1 @@
-{"version":3,"file":"filterFns.js","names":[],"sources":["../../src/fns/filterFns.ts"],"sourcesContent":["import type { RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type { Row } from '../types/Row'\nimport type { FilterFn } from '../features/column-filtering/columnFilteringFeature.types'\n\n// Basic filters\n\n/**\n * Filter function for checking if a value is exactly equal to a given value. (JS === comparison)\n */\nexport const filterFn_equals: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: unknown,\n) => {\n  return row.getValue(columnId) === filterValue\n}\n\nfilterFn_equals.autoRemove = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a value is weakly equal to a given value. (JS == comparison)\n */\nexport const filterFn_weakEquals: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: unknown,\n) => {\n  return row.getValue(columnId) == filterValue\n}\n\nfilterFn_weakEquals.autoRemove = (val: any) => testFalsy(val)\n\n// String filters\n\n/**\n * Filter function for checking if a string includes a given substring. (Case-sensitive)\n */\nexport const filterFn_includesStringSensitive: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: string,\n) => {\n  return Boolean(\n    row.getValue(columnId)?.toString().includes(filterValue.toString()),\n  )\n}\n\nfilterFn_includesStringSensitive.autoRemove = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a string includes a given substring. (Non-case-sensitive)\n */\nexport const filterFn_includesString: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: string,\n) => {\n  return Boolean(\n    row\n      .getValue(columnId)\n      ?.toString()\n      .toLowerCase()\n      .includes(filterValue.toString().toLowerCase()),\n  )\n}\n\nfilterFn_includesString.autoRemove = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a string is exactly equal to a given string. (Non-case-sensitive)\n */\nexport const filterFn_equalsString: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: string,\n) => {\n  return (\n    row.getValue(columnId)?.toString().toLowerCase() ===\n    filterValue.toLowerCase()\n  )\n}\n\nfilterFn_equalsString.autoRemove = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a string is exactly equal to a given string. (Case-sensitive)\n */\nexport const filterFn_equalsStringSensitive: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: string,\n) => {\n  return row.getValue(columnId)?.toString() === filterValue\n}\n\nfilterFn_equalsStringSensitive.autoRemove = (val: any) => testFalsy(val)\n\n// Number filters\n\n/**\n * Filter function for checking if a number is greater than a given number.\n */\nexport const filterFn_greaterThan: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Date | number | string,\n) => {\n  const rowValue = row.getValue(columnId)\n  const numericRowValue =\n    rowValue === null || rowValue === undefined ? 0 : +rowValue\n  const numericFilterValue = +filterValue\n\n  if (!isNaN(numericFilterValue) && !isNaN(numericRowValue)) {\n    return numericRowValue > numericFilterValue\n  }\n\n  const stringValue = (rowValue ?? '').toString().toLowerCase().trim()\n  const stringFilterValue = filterValue.toString().toLowerCase().trim()\n  return stringValue > stringFilterValue\n}\n\nfilterFn_greaterThan.resolveFilterValue = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a number is greater than or equal to a given number.\n */\nexport const filterFn_greaterThanOrEqualTo: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Date | number | string,\n) => {\n  return (\n    filterFn_greaterThan(row as any, columnId, filterValue) ||\n    filterFn_equals(row as any, columnId, filterValue)\n  )\n}\n\nfilterFn_greaterThanOrEqualTo.resolveFilterValue = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a number is less than a given number.\n */\nexport const filterFn_lessThan: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Date | number | string,\n) => {\n  return !filterFn_greaterThanOrEqualTo(row as any, columnId, filterValue)\n}\n\nfilterFn_lessThan.resolveFilterValue = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a number is less than or equal to a given number.\n */\nexport const filterFn_lessThanOrEqualTo: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Date | number | string,\n) => {\n  return !filterFn_greaterThan(row as any, columnId, filterValue)\n}\n\nfilterFn_lessThanOrEqualTo.resolveFilterValue = (val: any) => testFalsy(val)\n\n// Range filters\n\n/**\n * Filter function for checking if a number or a string is between two given values.\n */\nconst filterFn_between: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValues: [number | string, number | string],\n): boolean =>\n  ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n    filterFn_greaterThan(row as any, columnId, filterValues[0])) &&\n  ((!isNaN(+filterValues[0]) &&\n    !isNaN(+filterValues[1]) &&\n    +filterValues[0] > +filterValues[1]) ||\n    (['', undefined] as Array<any>).includes(filterValues[1]) ||\n    filterFn_lessThan(row as any, columnId, filterValues[1]))\n\nfilterFn_between.autoRemove = (val: any) => !val\n\n/**\n * Filter function for checking if a number or a string is between two given values or equal to them.\n */\nconst filterFn_betweenInclusive: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValues: [number | string, number | string],\n): boolean =>\n  ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n    filterFn_greaterThanOrEqualTo(row as any, columnId, filterValues[0])) &&\n  ((!isNaN(+filterValues[0]) &&\n    !isNaN(+filterValues[1]) &&\n    +filterValues[0] > +filterValues[1]) ||\n    (['', undefined] as Array<any>).includes(filterValues[1]) ||\n    filterFn_lessThanOrEqualTo(row as any, columnId, filterValues[1]))\n\nfilterFn_betweenInclusive.autoRemove = (val: any) => !val\n\n/**\n * Filter function for checking if a number is within a given range.\n */\nexport const filterFn_inNumberRange: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: [number, number],\n) => {\n  const [min, max] = filterValue\n\n  const rowValue: number = row.getValue(columnId)\n  return rowValue >= min && rowValue <= max\n}\n\nfilterFn_inNumberRange.resolveFilterValue = (val: [any, any]) => {\n  const [unsafeMin, unsafeMax] = val\n\n  const parsedMin =\n    typeof unsafeMin !== 'number' ? parseFloat(unsafeMin) : unsafeMin\n  const parsedMax =\n    typeof unsafeMax !== 'number' ? parseFloat(unsafeMax) : unsafeMax\n\n  let min =\n    unsafeMin === null || Number.isNaN(parsedMin) ? -Infinity : parsedMin\n  let max = unsafeMax === null || Number.isNaN(parsedMax) ? Infinity : parsedMax\n\n  if (min > max) {\n    const temp = min\n    min = max\n    max = temp\n  }\n\n  return [min, max] as const\n}\n\nfilterFn_inNumberRange.autoRemove = (val: any) =>\n  testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1]))\n\n// Array filters\n\n/**\n * Filter function for checking if an array has a given value.\n */\nexport const filterFn_arrHas: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Array<unknown>,\n) => {\n  return filterValue.some((val) => row.getValue<unknown>(columnId) === val)\n}\n\n/**\n * Filter function for checking if an array includes a given value.\n */\nexport const filterFn_arrIncludes: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Array<unknown>,\n) => {\n  return filterValue.some((val) =>\n    (row.getValue<unknown>(columnId) as Array<unknown> | string).includes(\n      val as any,\n    ),\n  )\n}\n\nfilterFn_arrIncludes.autoRemove = (val: any) => testFalsy(val) || !val?.length\n\n/**\n * Filter function for checking if an array includes all of the given values.\n */\nexport const filterFn_arrIncludesAll: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Array<unknown>,\n) => {\n  const value = row.getValue<Array<unknown>>(columnId)\n  if (!Array.isArray(value)) return false\n  return !filterValue.some((val) => !value.includes(val))\n}\n\nfilterFn_arrIncludesAll.autoRemove = (val: any) =>\n  testFalsy(val) || !val?.length\n\n/**\n * Filter function for checking if an array includes any of the given values.\n */\nexport const filterFn_arrIncludesSome: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Array<unknown>,\n) => {\n  const value = row.getValue<Array<unknown>>(columnId)\n  if (!Array.isArray(value)) return false\n  return filterValue.some((val) => value.includes(val))\n}\n\nfilterFn_arrIncludesSome.autoRemove = (val: any) =>\n  testFalsy(val) || !val?.length\n\n// Export\n\nexport const filterFns = {\n  arrIncludes: filterFn_arrIncludes,\n  arrIncludesAll: filterFn_arrIncludesAll,\n  arrHas: filterFn_arrHas,\n  arrIncludesSome: filterFn_arrIncludesSome,\n  between: filterFn_between,\n  betweenInclusive: filterFn_betweenInclusive,\n  equals: filterFn_equals,\n  equalsString: filterFn_equalsString,\n  inNumberRange: filterFn_inNumberRange,\n  includesString: filterFn_includesString,\n  includesStringSensitive: filterFn_includesStringSensitive,\n  weakEquals: filterFn_weakEquals,\n}\n\nexport type BuiltInFilterFn = keyof typeof filterFns\n\n// Utils\n\nfunction testFalsy(val: any) {\n  return val === undefined || val === null || val === ''\n}\n"],"mappings":"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"}
+{"version":3,"file":"filterFns.js","names":[],"sources":["../../src/fns/filterFns.ts"],"sourcesContent":["import type { RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type { Row } from '../types/Row'\nimport type { FilterFn } from '../features/column-filtering/columnFilteringFeature.types'\n\n// Basic filters\n\n/**\n * Filter function for checking if a value is exactly equal to a given value. (JS === comparison)\n */\nexport const filterFn_equals: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: unknown,\n) => {\n  return row.getValue(columnId) === filterValue\n}\n\nfilterFn_equals.autoRemove = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a value is weakly equal to a given value. (JS == comparison)\n */\nexport const filterFn_weakEquals: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: unknown,\n) => {\n  return row.getValue(columnId) == filterValue\n}\n\nfilterFn_weakEquals.autoRemove = (val: any) => testFalsy(val)\n\n// String filters\n\n/**\n * Filter function for checking if a string includes a given substring. (Case-sensitive)\n */\nexport const filterFn_includesStringSensitive: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: string,\n) => {\n  return Boolean(\n    row.getValue(columnId)?.toString().includes(filterValue.toString()),\n  )\n}\n\nfilterFn_includesStringSensitive.autoRemove = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a string includes a given substring. (Non-case-sensitive)\n */\nexport const filterFn_includesString: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: string,\n) => {\n  return Boolean(\n    row\n      .getValue(columnId)\n      ?.toString()\n      .toLowerCase()\n      .includes(filterValue.toString().toLowerCase()),\n  )\n}\n\nfilterFn_includesString.autoRemove = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a string is exactly equal to a given string. (Non-case-sensitive)\n */\nexport const filterFn_equalsString: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: string,\n) => {\n  return (\n    row.getValue(columnId)?.toString().toLowerCase() ===\n    filterValue.toLowerCase()\n  )\n}\n\nfilterFn_equalsString.autoRemove = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a string is exactly equal to a given string. (Case-sensitive)\n */\nexport const filterFn_equalsStringSensitive: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: string,\n) => {\n  return row.getValue(columnId)?.toString() === filterValue\n}\n\nfilterFn_equalsStringSensitive.autoRemove = (val: any) => testFalsy(val)\n\n// Number filters\n\n/**\n * Filter function for checking if a number is greater than a given number.\n */\nexport const filterFn_greaterThan: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Date | number | string,\n) => {\n  const rowValue = row.getValue(columnId)\n  const numericRowValue =\n    rowValue === null || rowValue === undefined ? 0 : +rowValue\n  const numericFilterValue = +filterValue\n\n  if (!isNaN(numericFilterValue) && !isNaN(numericRowValue)) {\n    return numericRowValue > numericFilterValue\n  }\n\n  const stringValue = (rowValue ?? '').toString().toLowerCase().trim()\n  const stringFilterValue = filterValue.toString().toLowerCase().trim()\n  return stringValue > stringFilterValue\n}\n\nfilterFn_greaterThan.resolveFilterValue = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a number is greater than or equal to a given number.\n */\nexport const filterFn_greaterThanOrEqualTo: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Date | number | string,\n) => {\n  return (\n    filterFn_greaterThan(row as any, columnId, filterValue) ||\n    filterFn_equals(row as any, columnId, filterValue)\n  )\n}\n\nfilterFn_greaterThanOrEqualTo.resolveFilterValue = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a number is less than a given number.\n */\nexport const filterFn_lessThan: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Date | number | string,\n) => {\n  return !filterFn_greaterThanOrEqualTo(row as any, columnId, filterValue)\n}\n\nfilterFn_lessThan.resolveFilterValue = (val: any) => testFalsy(val)\n\n/**\n * Filter function for checking if a number is less than or equal to a given number.\n */\nexport const filterFn_lessThanOrEqualTo: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Date | number | string,\n) => {\n  return !filterFn_greaterThan(row as any, columnId, filterValue)\n}\n\nfilterFn_lessThanOrEqualTo.resolveFilterValue = (val: any) => testFalsy(val)\n\n// Range filters\n\n/**\n * Filter function for checking if a number or a string is between two given values.\n */\nconst filterFn_between: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValues: [number | string, number | string],\n): boolean =>\n  ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n    filterFn_greaterThan(row as any, columnId, filterValues[0])) &&\n  ((!isNaN(+filterValues[0]) &&\n    !isNaN(+filterValues[1]) &&\n    +filterValues[0] > +filterValues[1]) ||\n    (['', undefined] as Array<any>).includes(filterValues[1]) ||\n    filterFn_lessThan(row as any, columnId, filterValues[1]))\n\nfilterFn_between.autoRemove = (val: any) => !val\n\n/**\n * Filter function for checking if a number or a string is between two given values or equal to them.\n */\nconst filterFn_betweenInclusive: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValues: [number | string, number | string],\n): boolean =>\n  ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n    filterFn_greaterThanOrEqualTo(row as any, columnId, filterValues[0])) &&\n  ((!isNaN(+filterValues[0]) &&\n    !isNaN(+filterValues[1]) &&\n    +filterValues[0] > +filterValues[1]) ||\n    (['', undefined] as Array<any>).includes(filterValues[1]) ||\n    filterFn_lessThanOrEqualTo(row as any, columnId, filterValues[1]))\n\nfilterFn_betweenInclusive.autoRemove = (val: any) => !val\n\n/**\n * Filter function for checking if a number is within a given range.\n */\nexport const filterFn_inNumberRange: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: [number, number],\n) => {\n  const [min, max] = filterValue\n\n  const rowValue: number = row.getValue(columnId)\n  return rowValue >= min && rowValue <= max\n}\n\nfilterFn_inNumberRange.resolveFilterValue = (val: [any, any]) => {\n  const [unsafeMin, unsafeMax] = val\n\n  const parsedMin =\n    typeof unsafeMin !== 'number' ? parseFloat(unsafeMin) : unsafeMin\n  const parsedMax =\n    typeof unsafeMax !== 'number' ? parseFloat(unsafeMax) : unsafeMax\n\n  let min =\n    unsafeMin === null || Number.isNaN(parsedMin) ? -Infinity : parsedMin\n  let max = unsafeMax === null || Number.isNaN(parsedMax) ? Infinity : parsedMax\n\n  if (min > max) {\n    const temp = min\n    min = max\n    max = temp\n  }\n\n  return [min, max] as const\n}\n\nfilterFn_inNumberRange.autoRemove = (val: any) =>\n  testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1]))\n\n// Array filters\n\n/**\n * Filter function for checking if an array has a given value.\n */\nexport const filterFn_arrHas: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Array<unknown>,\n) => {\n  return filterValue.some((val) => row.getValue<unknown>(columnId) === val)\n}\n\n/**\n * Filter function for checking if an array includes a given value.\n */\nexport const filterFn_arrIncludes: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Array<unknown>,\n) => {\n  return filterValue.some((val) =>\n    (row.getValue<unknown>(columnId) as Array<unknown> | string).includes(\n      val as any,\n    ),\n  )\n}\n\nfilterFn_arrIncludes.autoRemove = (val: any) => testFalsy(val) || !val?.length\n\n/**\n * Filter function for checking if an array includes all of the given values.\n */\nexport const filterFn_arrIncludesAll: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Array<unknown>,\n) => {\n  const value = row.getValue<Array<unknown>>(columnId)\n  if (!Array.isArray(value)) return false\n  return !filterValue.some((val) => !value.includes(val))\n}\n\nfilterFn_arrIncludesAll.autoRemove = (val: any) =>\n  testFalsy(val) || !val?.length\n\n/**\n * Filter function for checking if an array includes any of the given values.\n */\nexport const filterFn_arrIncludesSome: FilterFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  row: Row<TFeatures, TData>,\n  columnId: string,\n  filterValue: Array<unknown>,\n) => {\n  const value = row.getValue<Array<unknown>>(columnId)\n  if (!Array.isArray(value)) return false\n  return filterValue.some((val) => value.includes(val))\n}\n\nfilterFn_arrIncludesSome.autoRemove = (val: any) =>\n  testFalsy(val) || !val?.length\n\n// Export\n\n/**\n * The built-in filter function registry.\n *\n * Pass this object to filtered row model creation or extend it with custom filter functions.\n */\nexport const filterFns = {\n  arrIncludes: filterFn_arrIncludes,\n  arrIncludesAll: filterFn_arrIncludesAll,\n  arrHas: filterFn_arrHas,\n  arrIncludesSome: filterFn_arrIncludesSome,\n  between: filterFn_between,\n  betweenInclusive: filterFn_betweenInclusive,\n  equals: filterFn_equals,\n  equalsString: filterFn_equalsString,\n  inNumberRange: filterFn_inNumberRange,\n  includesString: filterFn_includesString,\n  includesStringSensitive: filterFn_includesStringSensitive,\n  weakEquals: filterFn_weakEquals,\n}\n\nexport type BuiltInFilterFn = keyof typeof filterFns\n\n// Utils\n\nfunction testFalsy(val: any) {\n  return val === undefined || val === null || val === ''\n}\n"],"mappings":"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"}

package/dist/fns/sortFns.cjs

@@ -1,23 +1,59 @@
 
 //#region src/fns/sortFns.ts
+/**
+* Regular expression used to split mixed text and numeric chunks.
+*
+* The alphanumeric sort functions use these chunks for natural sorting of
+* strings like `item2` before `item10`.
+*/
 const reSplitAlphaNumeric = /([0-9]+)/gm;
+/**
+* Sorts rows with the built-in alphanumeric strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_alphanumeric = (rowA, rowB, columnId) => {
 	return compareAlphanumeric(toString(rowA.getValue(columnId)).toLowerCase(), toString(rowB.getValue(columnId)).toLowerCase());
 };
+/**
+* Sorts rows with the built-in alphanumeric case sensitive strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_alphanumericCaseSensitive = (rowA, rowB, columnId) => {
 	return compareAlphanumeric(toString(rowA.getValue(columnId)), toString(rowB.getValue(columnId)));
 };
+/**
+* Sorts rows with the built-in text strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_text = (rowA, rowB, columnId) => {
 	return compareBasic(toString(rowA.getValue(columnId)).toLowerCase(), toString(rowB.getValue(columnId)).toLowerCase());
 };
+/**
+* Sorts rows with the built-in text case sensitive strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_textCaseSensitive = (rowA, rowB, columnId) => {
 	return compareBasic(toString(rowA.getValue(columnId)), toString(rowB.getValue(columnId)));
 };
+/**
+* Sorts rows with the built-in datetime strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_datetime = (rowA, rowB, columnId) => {
 	const a = rowA.getValue(columnId);
 	const b = rowB.getValue(columnId);
 	return a > b ? 1 : a < b ? -1 : 0;
 };
+/**
+* Sorts rows with the built-in basic strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_basic = (rowA, rowB, columnId) => {
 	return compareBasic(rowA.getValue(columnId), rowB.getValue(columnId));
 };
@@ -35,9 +71,13 @@ function toString(a) {
 function compareAlphanumeric(aStr, bStr) {
 	const a = aStr.split(reSplitAlphaNumeric).filter(Boolean);
 	const b = bStr.split(reSplitAlphaNumeric).filter(Boolean);
-	while (a.length && b.length) {
-		const aa = a.shift();
-		const bb = b.shift();
+	let ai = 0;
+	let bi = 0;
+	const aLen = a.length;
+	const bLen = b.length;
+	while (ai < aLen && bi < bLen) {
+		const aa = a[ai++];
+		const bb = b[bi++];
 		const an = parseInt(aa, 10);
 		const bn = parseInt(bb, 10);
 		const combo = [an, bn].sort();
@@ -50,8 +90,13 @@ function compareAlphanumeric(aStr, bStr) {
 		if (an > bn) return 1;
 		if (bn > an) return -1;
 	}
-	return a.length - b.length;
+	return aLen - ai - (bLen - bi);
 }
+/**
+* The built-in sorting function registry.
+*
+* Pass this object to sorted row model creation or extend it with custom sorting functions.
+*/
 const sortFns = {
 	alphanumeric: sortFn_alphanumeric,
 	alphanumericCaseSensitive: sortFn_alphanumericCaseSensitive,

package/dist/fns/sortFns.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sortFns.cjs","names":[],"sources":["../../src/fns/sortFns.ts"],"sourcesContent":["import type { RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type { Row } from '../types/Row'\nimport type { SortFn } from '../features/row-sorting/rowSortingFeature.types'\n\nexport const reSplitAlphaNumeric = /([0-9]+)/gm\n\nexport const sortFn_alphanumeric: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareAlphanumeric(\n    toString(rowA.getValue(columnId)).toLowerCase(),\n    toString(rowB.getValue(columnId)).toLowerCase(),\n  )\n}\n\nexport const sortFn_alphanumericCaseSensitive: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareAlphanumeric(\n    toString(rowA.getValue(columnId)),\n    toString(rowB.getValue(columnId)),\n  )\n}\n\n// The text filter is more basic (less numeric support)\n// but is much faster\nexport const sortFn_text: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(\n    toString(rowA.getValue(columnId)).toLowerCase(),\n    toString(rowB.getValue(columnId)).toLowerCase(),\n  )\n}\n\n// The text filter is more basic (less numeric support)\n// but is much faster\nexport const sortFn_textCaseSensitive: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(\n    toString(rowA.getValue(columnId)),\n    toString(rowB.getValue(columnId)),\n  )\n}\n\nexport const sortFn_datetime: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  const a: number | string = rowA.getValue(columnId)\n  const b: number | string = rowB.getValue(columnId)\n\n  // Can handle nullish values\n  // Use > and < because == (and ===) doesn't work with\n  // Date objects (would require calling getTime()).\n  return a > b ? 1 : a < b ? -1 : 0\n}\n\nexport const sortFn_basic: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(rowA.getValue(columnId), rowB.getValue(columnId))\n}\n\n// Utils\n\nfunction compareBasic(a: any, b: any) {\n  return a === b ? 0 : a > b ? 1 : -1\n}\n\nfunction toString(a: any) {\n  if (typeof a === 'number') {\n    if (isNaN(a) || a === Infinity || a === -Infinity) {\n      return ''\n    }\n    return String(a)\n  }\n  if (typeof a === 'string') {\n    return a\n  }\n  return ''\n}\n\n// Mixed sorting is slow, but very inclusive of many edge cases.\n// It handles numbers, mixed alphanumeric combinations, and even\n// null, undefined, and Infinity\nfunction compareAlphanumeric(aStr: string, bStr: string) {\n  // Split on number groups, but keep the delimiter\n  // Then remove falsey split values\n  const a = aStr.split(reSplitAlphaNumeric).filter(Boolean)\n  const b = bStr.split(reSplitAlphaNumeric).filter(Boolean)\n\n  // While\n  while (a.length && b.length) {\n    const aa = a.shift()!\n    const bb = b.shift()!\n\n    const an = parseInt(aa, 10)\n    const bn = parseInt(bb, 10)\n\n    const combo = [an, bn].sort()\n\n    // Both are string\n    if (isNaN(combo[0]!)) {\n      if (aa > bb) {\n        return 1\n      }\n      if (bb > aa) {\n        return -1\n      }\n      continue\n    }\n\n    // One is a string, one is a number\n    if (isNaN(combo[1]!)) {\n      return isNaN(an) ? -1 : 1\n    }\n\n    // Both are numbers\n    if (an > bn) {\n      return 1\n    }\n    if (bn > an) {\n      return -1\n    }\n  }\n\n  return a.length - b.length\n}\n\n// Exports\n\nexport const sortFns = {\n  alphanumeric: sortFn_alphanumeric,\n  alphanumericCaseSensitive: sortFn_alphanumericCaseSensitive,\n  basic: sortFn_basic,\n  datetime: sortFn_datetime,\n  text: sortFn_text,\n  textCaseSensitive: sortFn_textCaseSensitive,\n}\n\nexport type BuiltInSortFn = keyof typeof sortFns\n"],"mappings":";;AAKA,MAAa,sBAAsB;AAEnC,MAAa,uBAIX,MACA,MACA,aACG;AACH,QAAO,oBACL,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,EAC/C,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,CAChD;;AAGH,MAAa,oCAIX,MACA,MACA,aACG;AACH,QAAO,oBACL,SAAS,KAAK,SAAS,SAAS,CAAC,EACjC,SAAS,KAAK,SAAS,SAAS,CAAC,CAClC;;AAKH,MAAa,eAIX,MACA,MACA,aACG;AACH,QAAO,aACL,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,EAC/C,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,CAChD;;AAKH,MAAa,4BAIX,MACA,MACA,aACG;AACH,QAAO,aACL,SAAS,KAAK,SAAS,SAAS,CAAC,EACjC,SAAS,KAAK,SAAS,SAAS,CAAC,CAClC;;AAGH,MAAa,mBAIX,MACA,MACA,aACG;CACH,MAAM,IAAqB,KAAK,SAAS,SAAS;CAClD,MAAM,IAAqB,KAAK,SAAS,SAAS;AAKlD,QAAO,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK;;AAGlC,MAAa,gBAIX,MACA,MACA,aACG;AACH,QAAO,aAAa,KAAK,SAAS,SAAS,EAAE,KAAK,SAAS,SAAS,CAAC;;AAKvE,SAAS,aAAa,GAAQ,GAAQ;AACpC,QAAO,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI;;AAGnC,SAAS,SAAS,GAAQ;AACxB,KAAI,OAAO,MAAM,UAAU;AACzB,MAAI,MAAM,EAAE,IAAI,MAAM,YAAY,MAAM,UACtC,QAAO;AAET,SAAO,OAAO,EAAE;;AAElB,KAAI,OAAO,MAAM,SACf,QAAO;AAET,QAAO;;AAMT,SAAS,oBAAoB,MAAc,MAAc;CAGvD,MAAM,IAAI,KAAK,MAAM,oBAAoB,CAAC,OAAO,QAAQ;CACzD,MAAM,IAAI,KAAK,MAAM,oBAAoB,CAAC,OAAO,QAAQ;AAGzD,QAAO,EAAE,UAAU,EAAE,QAAQ;EAC3B,MAAM,KAAK,EAAE,OAAO;EACpB,MAAM,KAAK,EAAE,OAAO;EAEpB,MAAM,KAAK,SAAS,IAAI,GAAG;EAC3B,MAAM,KAAK,SAAS,IAAI,GAAG;EAE3B,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM;AAG7B,MAAI,MAAM,MAAM,GAAI,EAAE;AACpB,OAAI,KAAK,GACP,QAAO;AAET,OAAI,KAAK,GACP,QAAO;AAET;;AAIF,MAAI,MAAM,MAAM,GAAI,CAClB,QAAO,MAAM,GAAG,GAAG,KAAK;AAI1B,MAAI,KAAK,GACP,QAAO;AAET,MAAI,KAAK,GACP,QAAO;;AAIX,QAAO,EAAE,SAAS,EAAE;;AAKtB,MAAa,UAAU;CACrB,cAAc;CACd,2BAA2B;CAC3B,OAAO;CACP,UAAU;CACV,MAAM;CACN,mBAAmB;CACpB"}
+{"version":3,"file":"sortFns.cjs","names":[],"sources":["../../src/fns/sortFns.ts"],"sourcesContent":["import type { RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type { Row } from '../types/Row'\nimport type { SortFn } from '../features/row-sorting/rowSortingFeature.types'\n\n/**\n * Regular expression used to split mixed text and numeric chunks.\n *\n * The alphanumeric sort functions use these chunks for natural sorting of\n * strings like `item2` before `item10`.\n */\nexport const reSplitAlphaNumeric = /([0-9]+)/gm\n\n/**\n * Sorts rows with the built-in alphanumeric strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_alphanumeric: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareAlphanumeric(\n    toString(rowA.getValue(columnId)).toLowerCase(),\n    toString(rowB.getValue(columnId)).toLowerCase(),\n  )\n}\n\n/**\n * Sorts rows with the built-in alphanumeric case sensitive strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_alphanumericCaseSensitive: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareAlphanumeric(\n    toString(rowA.getValue(columnId)),\n    toString(rowB.getValue(columnId)),\n  )\n}\n\n// The text filter is more basic (less numeric support)\n// but is much faster\n/**\n * Sorts rows with the built-in text strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_text: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(\n    toString(rowA.getValue(columnId)).toLowerCase(),\n    toString(rowB.getValue(columnId)).toLowerCase(),\n  )\n}\n\n// The text filter is more basic (less numeric support)\n// but is much faster\n/**\n * Sorts rows with the built-in text case sensitive strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_textCaseSensitive: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(\n    toString(rowA.getValue(columnId)),\n    toString(rowB.getValue(columnId)),\n  )\n}\n\n/**\n * Sorts rows with the built-in datetime strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_datetime: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  const a: number | string = rowA.getValue(columnId)\n  const b: number | string = rowB.getValue(columnId)\n\n  // Can handle nullish values\n  // Use > and < because == (and ===) doesn't work with\n  // Date objects (would require calling getTime()).\n  return a > b ? 1 : a < b ? -1 : 0\n}\n\n/**\n * Sorts rows with the built-in basic strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_basic: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(rowA.getValue(columnId), rowB.getValue(columnId))\n}\n\n// Utils\n\nfunction compareBasic(a: any, b: any) {\n  return a === b ? 0 : a > b ? 1 : -1\n}\n\nfunction toString(a: any) {\n  if (typeof a === 'number') {\n    if (isNaN(a) || a === Infinity || a === -Infinity) {\n      return ''\n    }\n    return String(a)\n  }\n  if (typeof a === 'string') {\n    return a\n  }\n  return ''\n}\n\n// Mixed sorting is slow, but very inclusive of many edge cases.\n// It handles numbers, mixed alphanumeric combinations, and even\n// null, undefined, and Infinity\nfunction compareAlphanumeric(aStr: string, bStr: string) {\n  // Split on number groups, but keep the delimiter\n  // Then remove falsey split values\n  const a = aStr.split(reSplitAlphaNumeric).filter(Boolean)\n  const b = bStr.split(reSplitAlphaNumeric).filter(Boolean)\n\n  let ai = 0\n  let bi = 0\n  const aLen = a.length\n  const bLen = b.length\n\n  while (ai < aLen && bi < bLen) {\n    const aa = a[ai++]!\n    const bb = b[bi++]!\n\n    const an = parseInt(aa, 10)\n    const bn = parseInt(bb, 10)\n\n    const combo = [an, bn].sort()\n\n    // Both are string\n    if (isNaN(combo[0]!)) {\n      if (aa > bb) {\n        return 1\n      }\n      if (bb > aa) {\n        return -1\n      }\n      continue\n    }\n\n    // One is a string, one is a number\n    if (isNaN(combo[1]!)) {\n      return isNaN(an) ? -1 : 1\n    }\n\n    // Both are numbers\n    if (an > bn) {\n      return 1\n    }\n    if (bn > an) {\n      return -1\n    }\n  }\n\n  return aLen - ai - (bLen - bi)\n}\n\n// Exports\n\n/**\n * The built-in sorting function registry.\n *\n * Pass this object to sorted row model creation or extend it with custom sorting functions.\n */\nexport const sortFns = {\n  alphanumeric: sortFn_alphanumeric,\n  alphanumericCaseSensitive: sortFn_alphanumericCaseSensitive,\n  basic: sortFn_basic,\n  datetime: sortFn_datetime,\n  text: sortFn_text,\n  textCaseSensitive: sortFn_textCaseSensitive,\n}\n\nexport type BuiltInSortFn = keyof typeof sortFns\n"],"mappings":";;;;;;;;AAWA,MAAa,sBAAsB;;;;;;AAOnC,MAAa,uBAIX,MACA,MACA,aACG;CACH,OAAO,oBACL,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,EAC/C,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,CAChD;;;;;;;AAQH,MAAa,oCAIX,MACA,MACA,aACG;CACH,OAAO,oBACL,SAAS,KAAK,SAAS,SAAS,CAAC,EACjC,SAAS,KAAK,SAAS,SAAS,CAAC,CAClC;;;;;;;AAUH,MAAa,eAIX,MACA,MACA,aACG;CACH,OAAO,aACL,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,EAC/C,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,CAChD;;;;;;;AAUH,MAAa,4BAIX,MACA,MACA,aACG;CACH,OAAO,aACL,SAAS,KAAK,SAAS,SAAS,CAAC,EACjC,SAAS,KAAK,SAAS,SAAS,CAAC,CAClC;;;;;;;AAQH,MAAa,mBAIX,MACA,MACA,aACG;CACH,MAAM,IAAqB,KAAK,SAAS,SAAS;CAClD,MAAM,IAAqB,KAAK,SAAS,SAAS;CAKlD,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK;;;;;;;AAQlC,MAAa,gBAIX,MACA,MACA,aACG;CACH,OAAO,aAAa,KAAK,SAAS,SAAS,EAAE,KAAK,SAAS,SAAS,CAAC;;AAKvE,SAAS,aAAa,GAAQ,GAAQ;CACpC,OAAO,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI;;AAGnC,SAAS,SAAS,GAAQ;CACxB,IAAI,OAAO,MAAM,UAAU;EACzB,IAAI,MAAM,EAAE,IAAI,MAAM,YAAY,MAAM,WACtC,OAAO;EAET,OAAO,OAAO,EAAE;;CAElB,IAAI,OAAO,MAAM,UACf,OAAO;CAET,OAAO;;AAMT,SAAS,oBAAoB,MAAc,MAAc;CAGvD,MAAM,IAAI,KAAK,MAAM,oBAAoB,CAAC,OAAO,QAAQ;CACzD,MAAM,IAAI,KAAK,MAAM,oBAAoB,CAAC,OAAO,QAAQ;CAEzD,IAAI,KAAK;CACT,IAAI,KAAK;CACT,MAAM,OAAO,EAAE;CACf,MAAM,OAAO,EAAE;CAEf,OAAO,KAAK,QAAQ,KAAK,MAAM;EAC7B,MAAM,KAAK,EAAE;EACb,MAAM,KAAK,EAAE;EAEb,MAAM,KAAK,SAAS,IAAI,GAAG;EAC3B,MAAM,KAAK,SAAS,IAAI,GAAG;EAE3B,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM;EAG7B,IAAI,MAAM,MAAM,GAAI,EAAE;GACpB,IAAI,KAAK,IACP,OAAO;GAET,IAAI,KAAK,IACP,OAAO;GAET;;EAIF,IAAI,MAAM,MAAM,GAAI,EAClB,OAAO,MAAM,GAAG,GAAG,KAAK;EAI1B,IAAI,KAAK,IACP,OAAO;EAET,IAAI,KAAK,IACP,OAAO;;CAIX,OAAO,OAAO,MAAM,OAAO;;;;;;;AAU7B,MAAa,UAAU;CACrB,cAAc;CACd,2BAA2B;CAC3B,OAAO;CACP,UAAU;CACV,MAAM;CACN,mBAAmB;CACpB"}

package/dist/fns/sortFns.d.cts

@@ -1,13 +1,54 @@
 import { SortFn } from "../features/row-sorting/rowSortingFeature.types.cjs";
 
 //#region src/fns/sortFns.d.ts
+/**
+ * Regular expression used to split mixed text and numeric chunks.
+ *
+ * The alphanumeric sort functions use these chunks for natural sorting of
+ * strings like `item2` before `item10`.
+ */
 declare const reSplitAlphaNumeric: RegExp;
+/**
+ * Sorts rows with the built-in alphanumeric strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_alphanumeric: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in alphanumeric case sensitive strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_alphanumericCaseSensitive: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in text strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_text: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in text case sensitive strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_textCaseSensitive: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in datetime strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_datetime: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in basic strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_basic: SortFn<any, any>;
+/**
+ * The built-in sorting function registry.
+ *
+ * Pass this object to sorted row model creation or extend it with custom sorting functions.
+ */
 declare const sortFns: {
   alphanumeric: SortFn<any, any>;
   alphanumericCaseSensitive: SortFn<any, any>;

package/dist/fns/sortFns.d.ts

@@ -1,13 +1,54 @@
 import { SortFn } from "../features/row-sorting/rowSortingFeature.types.js";
 
 //#region src/fns/sortFns.d.ts
+/**
+ * Regular expression used to split mixed text and numeric chunks.
+ *
+ * The alphanumeric sort functions use these chunks for natural sorting of
+ * strings like `item2` before `item10`.
+ */
 declare const reSplitAlphaNumeric: RegExp;
+/**
+ * Sorts rows with the built-in alphanumeric strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_alphanumeric: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in alphanumeric case sensitive strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_alphanumericCaseSensitive: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in text strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_text: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in text case sensitive strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_textCaseSensitive: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in datetime strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_datetime: SortFn<any, any>;
+/**
+ * Sorts rows with the built-in basic strategy.
+ *
+ * This comparator returns ascending-order results; descending order is applied by the sorting row model.
+ */
 declare const sortFn_basic: SortFn<any, any>;
+/**
+ * The built-in sorting function registry.
+ *
+ * Pass this object to sorted row model creation or extend it with custom sorting functions.
+ */
 declare const sortFns: {
   alphanumeric: SortFn<any, any>;
   alphanumericCaseSensitive: SortFn<any, any>;

package/dist/fns/sortFns.js

@@ -1,22 +1,58 @@
 //#region src/fns/sortFns.ts
+/**
+* Regular expression used to split mixed text and numeric chunks.
+*
+* The alphanumeric sort functions use these chunks for natural sorting of
+* strings like `item2` before `item10`.
+*/
 const reSplitAlphaNumeric = /([0-9]+)/gm;
+/**
+* Sorts rows with the built-in alphanumeric strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_alphanumeric = (rowA, rowB, columnId) => {
 	return compareAlphanumeric(toString(rowA.getValue(columnId)).toLowerCase(), toString(rowB.getValue(columnId)).toLowerCase());
 };
+/**
+* Sorts rows with the built-in alphanumeric case sensitive strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_alphanumericCaseSensitive = (rowA, rowB, columnId) => {
 	return compareAlphanumeric(toString(rowA.getValue(columnId)), toString(rowB.getValue(columnId)));
 };
+/**
+* Sorts rows with the built-in text strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_text = (rowA, rowB, columnId) => {
 	return compareBasic(toString(rowA.getValue(columnId)).toLowerCase(), toString(rowB.getValue(columnId)).toLowerCase());
 };
+/**
+* Sorts rows with the built-in text case sensitive strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_textCaseSensitive = (rowA, rowB, columnId) => {
 	return compareBasic(toString(rowA.getValue(columnId)), toString(rowB.getValue(columnId)));
 };
+/**
+* Sorts rows with the built-in datetime strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_datetime = (rowA, rowB, columnId) => {
 	const a = rowA.getValue(columnId);
 	const b = rowB.getValue(columnId);
 	return a > b ? 1 : a < b ? -1 : 0;
 };
+/**
+* Sorts rows with the built-in basic strategy.
+*
+* This comparator returns ascending-order results; descending order is applied by the sorting row model.
+*/
 const sortFn_basic = (rowA, rowB, columnId) => {
 	return compareBasic(rowA.getValue(columnId), rowB.getValue(columnId));
 };
@@ -34,9 +70,13 @@ function toString(a) {
 function compareAlphanumeric(aStr, bStr) {
 	const a = aStr.split(reSplitAlphaNumeric).filter(Boolean);
 	const b = bStr.split(reSplitAlphaNumeric).filter(Boolean);
-	while (a.length && b.length) {
-		const aa = a.shift();
-		const bb = b.shift();
+	let ai = 0;
+	let bi = 0;
+	const aLen = a.length;
+	const bLen = b.length;
+	while (ai < aLen && bi < bLen) {
+		const aa = a[ai++];
+		const bb = b[bi++];
 		const an = parseInt(aa, 10);
 		const bn = parseInt(bb, 10);
 		const combo = [an, bn].sort();
@@ -49,8 +89,13 @@ function compareAlphanumeric(aStr, bStr) {
 		if (an > bn) return 1;
 		if (bn > an) return -1;
 	}
-	return a.length - b.length;
+	return aLen - ai - (bLen - bi);
 }
+/**
+* The built-in sorting function registry.
+*
+* Pass this object to sorted row model creation or extend it with custom sorting functions.
+*/
 const sortFns = {
 	alphanumeric: sortFn_alphanumeric,
 	alphanumericCaseSensitive: sortFn_alphanumericCaseSensitive,

package/dist/fns/sortFns.js.map

@@ -1 +1 @@
-{"version":3,"file":"sortFns.js","names":[],"sources":["../../src/fns/sortFns.ts"],"sourcesContent":["import type { RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type { Row } from '../types/Row'\nimport type { SortFn } from '../features/row-sorting/rowSortingFeature.types'\n\nexport const reSplitAlphaNumeric = /([0-9]+)/gm\n\nexport const sortFn_alphanumeric: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareAlphanumeric(\n    toString(rowA.getValue(columnId)).toLowerCase(),\n    toString(rowB.getValue(columnId)).toLowerCase(),\n  )\n}\n\nexport const sortFn_alphanumericCaseSensitive: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareAlphanumeric(\n    toString(rowA.getValue(columnId)),\n    toString(rowB.getValue(columnId)),\n  )\n}\n\n// The text filter is more basic (less numeric support)\n// but is much faster\nexport const sortFn_text: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(\n    toString(rowA.getValue(columnId)).toLowerCase(),\n    toString(rowB.getValue(columnId)).toLowerCase(),\n  )\n}\n\n// The text filter is more basic (less numeric support)\n// but is much faster\nexport const sortFn_textCaseSensitive: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(\n    toString(rowA.getValue(columnId)),\n    toString(rowB.getValue(columnId)),\n  )\n}\n\nexport const sortFn_datetime: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  const a: number | string = rowA.getValue(columnId)\n  const b: number | string = rowB.getValue(columnId)\n\n  // Can handle nullish values\n  // Use > and < because == (and ===) doesn't work with\n  // Date objects (would require calling getTime()).\n  return a > b ? 1 : a < b ? -1 : 0\n}\n\nexport const sortFn_basic: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(rowA.getValue(columnId), rowB.getValue(columnId))\n}\n\n// Utils\n\nfunction compareBasic(a: any, b: any) {\n  return a === b ? 0 : a > b ? 1 : -1\n}\n\nfunction toString(a: any) {\n  if (typeof a === 'number') {\n    if (isNaN(a) || a === Infinity || a === -Infinity) {\n      return ''\n    }\n    return String(a)\n  }\n  if (typeof a === 'string') {\n    return a\n  }\n  return ''\n}\n\n// Mixed sorting is slow, but very inclusive of many edge cases.\n// It handles numbers, mixed alphanumeric combinations, and even\n// null, undefined, and Infinity\nfunction compareAlphanumeric(aStr: string, bStr: string) {\n  // Split on number groups, but keep the delimiter\n  // Then remove falsey split values\n  const a = aStr.split(reSplitAlphaNumeric).filter(Boolean)\n  const b = bStr.split(reSplitAlphaNumeric).filter(Boolean)\n\n  // While\n  while (a.length && b.length) {\n    const aa = a.shift()!\n    const bb = b.shift()!\n\n    const an = parseInt(aa, 10)\n    const bn = parseInt(bb, 10)\n\n    const combo = [an, bn].sort()\n\n    // Both are string\n    if (isNaN(combo[0]!)) {\n      if (aa > bb) {\n        return 1\n      }\n      if (bb > aa) {\n        return -1\n      }\n      continue\n    }\n\n    // One is a string, one is a number\n    if (isNaN(combo[1]!)) {\n      return isNaN(an) ? -1 : 1\n    }\n\n    // Both are numbers\n    if (an > bn) {\n      return 1\n    }\n    if (bn > an) {\n      return -1\n    }\n  }\n\n  return a.length - b.length\n}\n\n// Exports\n\nexport const sortFns = {\n  alphanumeric: sortFn_alphanumeric,\n  alphanumericCaseSensitive: sortFn_alphanumericCaseSensitive,\n  basic: sortFn_basic,\n  datetime: sortFn_datetime,\n  text: sortFn_text,\n  textCaseSensitive: sortFn_textCaseSensitive,\n}\n\nexport type BuiltInSortFn = keyof typeof sortFns\n"],"mappings":";AAKA,MAAa,sBAAsB;AAEnC,MAAa,uBAIX,MACA,MACA,aACG;AACH,QAAO,oBACL,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,EAC/C,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,CAChD;;AAGH,MAAa,oCAIX,MACA,MACA,aACG;AACH,QAAO,oBACL,SAAS,KAAK,SAAS,SAAS,CAAC,EACjC,SAAS,KAAK,SAAS,SAAS,CAAC,CAClC;;AAKH,MAAa,eAIX,MACA,MACA,aACG;AACH,QAAO,aACL,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,EAC/C,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,CAChD;;AAKH,MAAa,4BAIX,MACA,MACA,aACG;AACH,QAAO,aACL,SAAS,KAAK,SAAS,SAAS,CAAC,EACjC,SAAS,KAAK,SAAS,SAAS,CAAC,CAClC;;AAGH,MAAa,mBAIX,MACA,MACA,aACG;CACH,MAAM,IAAqB,KAAK,SAAS,SAAS;CAClD,MAAM,IAAqB,KAAK,SAAS,SAAS;AAKlD,QAAO,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK;;AAGlC,MAAa,gBAIX,MACA,MACA,aACG;AACH,QAAO,aAAa,KAAK,SAAS,SAAS,EAAE,KAAK,SAAS,SAAS,CAAC;;AAKvE,SAAS,aAAa,GAAQ,GAAQ;AACpC,QAAO,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI;;AAGnC,SAAS,SAAS,GAAQ;AACxB,KAAI,OAAO,MAAM,UAAU;AACzB,MAAI,MAAM,EAAE,IAAI,MAAM,YAAY,MAAM,UACtC,QAAO;AAET,SAAO,OAAO,EAAE;;AAElB,KAAI,OAAO,MAAM,SACf,QAAO;AAET,QAAO;;AAMT,SAAS,oBAAoB,MAAc,MAAc;CAGvD,MAAM,IAAI,KAAK,MAAM,oBAAoB,CAAC,OAAO,QAAQ;CACzD,MAAM,IAAI,KAAK,MAAM,oBAAoB,CAAC,OAAO,QAAQ;AAGzD,QAAO,EAAE,UAAU,EAAE,QAAQ;EAC3B,MAAM,KAAK,EAAE,OAAO;EACpB,MAAM,KAAK,EAAE,OAAO;EAEpB,MAAM,KAAK,SAAS,IAAI,GAAG;EAC3B,MAAM,KAAK,SAAS,IAAI,GAAG;EAE3B,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM;AAG7B,MAAI,MAAM,MAAM,GAAI,EAAE;AACpB,OAAI,KAAK,GACP,QAAO;AAET,OAAI,KAAK,GACP,QAAO;AAET;;AAIF,MAAI,MAAM,MAAM,GAAI,CAClB,QAAO,MAAM,GAAG,GAAG,KAAK;AAI1B,MAAI,KAAK,GACP,QAAO;AAET,MAAI,KAAK,GACP,QAAO;;AAIX,QAAO,EAAE,SAAS,EAAE;;AAKtB,MAAa,UAAU;CACrB,cAAc;CACd,2BAA2B;CAC3B,OAAO;CACP,UAAU;CACV,MAAM;CACN,mBAAmB;CACpB"}
+{"version":3,"file":"sortFns.js","names":[],"sources":["../../src/fns/sortFns.ts"],"sourcesContent":["import type { RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type { Row } from '../types/Row'\nimport type { SortFn } from '../features/row-sorting/rowSortingFeature.types'\n\n/**\n * Regular expression used to split mixed text and numeric chunks.\n *\n * The alphanumeric sort functions use these chunks for natural sorting of\n * strings like `item2` before `item10`.\n */\nexport const reSplitAlphaNumeric = /([0-9]+)/gm\n\n/**\n * Sorts rows with the built-in alphanumeric strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_alphanumeric: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareAlphanumeric(\n    toString(rowA.getValue(columnId)).toLowerCase(),\n    toString(rowB.getValue(columnId)).toLowerCase(),\n  )\n}\n\n/**\n * Sorts rows with the built-in alphanumeric case sensitive strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_alphanumericCaseSensitive: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareAlphanumeric(\n    toString(rowA.getValue(columnId)),\n    toString(rowB.getValue(columnId)),\n  )\n}\n\n// The text filter is more basic (less numeric support)\n// but is much faster\n/**\n * Sorts rows with the built-in text strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_text: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(\n    toString(rowA.getValue(columnId)).toLowerCase(),\n    toString(rowB.getValue(columnId)).toLowerCase(),\n  )\n}\n\n// The text filter is more basic (less numeric support)\n// but is much faster\n/**\n * Sorts rows with the built-in text case sensitive strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_textCaseSensitive: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(\n    toString(rowA.getValue(columnId)),\n    toString(rowB.getValue(columnId)),\n  )\n}\n\n/**\n * Sorts rows with the built-in datetime strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_datetime: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  const a: number | string = rowA.getValue(columnId)\n  const b: number | string = rowB.getValue(columnId)\n\n  // Can handle nullish values\n  // Use > and < because == (and ===) doesn't work with\n  // Date objects (would require calling getTime()).\n  return a > b ? 1 : a < b ? -1 : 0\n}\n\n/**\n * Sorts rows with the built-in basic strategy.\n *\n * This comparator returns ascending-order results; descending order is applied by the sorting row model.\n */\nexport const sortFn_basic: SortFn<any, any> = <\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(\n  rowA: Row<any, any>,\n  rowB: Row<any, any>,\n  columnId: string,\n) => {\n  return compareBasic(rowA.getValue(columnId), rowB.getValue(columnId))\n}\n\n// Utils\n\nfunction compareBasic(a: any, b: any) {\n  return a === b ? 0 : a > b ? 1 : -1\n}\n\nfunction toString(a: any) {\n  if (typeof a === 'number') {\n    if (isNaN(a) || a === Infinity || a === -Infinity) {\n      return ''\n    }\n    return String(a)\n  }\n  if (typeof a === 'string') {\n    return a\n  }\n  return ''\n}\n\n// Mixed sorting is slow, but very inclusive of many edge cases.\n// It handles numbers, mixed alphanumeric combinations, and even\n// null, undefined, and Infinity\nfunction compareAlphanumeric(aStr: string, bStr: string) {\n  // Split on number groups, but keep the delimiter\n  // Then remove falsey split values\n  const a = aStr.split(reSplitAlphaNumeric).filter(Boolean)\n  const b = bStr.split(reSplitAlphaNumeric).filter(Boolean)\n\n  let ai = 0\n  let bi = 0\n  const aLen = a.length\n  const bLen = b.length\n\n  while (ai < aLen && bi < bLen) {\n    const aa = a[ai++]!\n    const bb = b[bi++]!\n\n    const an = parseInt(aa, 10)\n    const bn = parseInt(bb, 10)\n\n    const combo = [an, bn].sort()\n\n    // Both are string\n    if (isNaN(combo[0]!)) {\n      if (aa > bb) {\n        return 1\n      }\n      if (bb > aa) {\n        return -1\n      }\n      continue\n    }\n\n    // One is a string, one is a number\n    if (isNaN(combo[1]!)) {\n      return isNaN(an) ? -1 : 1\n    }\n\n    // Both are numbers\n    if (an > bn) {\n      return 1\n    }\n    if (bn > an) {\n      return -1\n    }\n  }\n\n  return aLen - ai - (bLen - bi)\n}\n\n// Exports\n\n/**\n * The built-in sorting function registry.\n *\n * Pass this object to sorted row model creation or extend it with custom sorting functions.\n */\nexport const sortFns = {\n  alphanumeric: sortFn_alphanumeric,\n  alphanumericCaseSensitive: sortFn_alphanumericCaseSensitive,\n  basic: sortFn_basic,\n  datetime: sortFn_datetime,\n  text: sortFn_text,\n  textCaseSensitive: sortFn_textCaseSensitive,\n}\n\nexport type BuiltInSortFn = keyof typeof sortFns\n"],"mappings":";;;;;;;AAWA,MAAa,sBAAsB;;;;;;AAOnC,MAAa,uBAIX,MACA,MACA,aACG;CACH,OAAO,oBACL,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,EAC/C,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,CAChD;;;;;;;AAQH,MAAa,oCAIX,MACA,MACA,aACG;CACH,OAAO,oBACL,SAAS,KAAK,SAAS,SAAS,CAAC,EACjC,SAAS,KAAK,SAAS,SAAS,CAAC,CAClC;;;;;;;AAUH,MAAa,eAIX,MACA,MACA,aACG;CACH,OAAO,aACL,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,EAC/C,SAAS,KAAK,SAAS,SAAS,CAAC,CAAC,aAAa,CAChD;;;;;;;AAUH,MAAa,4BAIX,MACA,MACA,aACG;CACH,OAAO,aACL,SAAS,KAAK,SAAS,SAAS,CAAC,EACjC,SAAS,KAAK,SAAS,SAAS,CAAC,CAClC;;;;;;;AAQH,MAAa,mBAIX,MACA,MACA,aACG;CACH,MAAM,IAAqB,KAAK,SAAS,SAAS;CAClD,MAAM,IAAqB,KAAK,SAAS,SAAS;CAKlD,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK;;;;;;;AAQlC,MAAa,gBAIX,MACA,MACA,aACG;CACH,OAAO,aAAa,KAAK,SAAS,SAAS,EAAE,KAAK,SAAS,SAAS,CAAC;;AAKvE,SAAS,aAAa,GAAQ,GAAQ;CACpC,OAAO,MAAM,IAAI,IAAI,IAAI,IAAI,IAAI;;AAGnC,SAAS,SAAS,GAAQ;CACxB,IAAI,OAAO,MAAM,UAAU;EACzB,IAAI,MAAM,EAAE,IAAI,MAAM,YAAY,MAAM,WACtC,OAAO;EAET,OAAO,OAAO,EAAE;;CAElB,IAAI,OAAO,MAAM,UACf,OAAO;CAET,OAAO;;AAMT,SAAS,oBAAoB,MAAc,MAAc;CAGvD,MAAM,IAAI,KAAK,MAAM,oBAAoB,CAAC,OAAO,QAAQ;CACzD,MAAM,IAAI,KAAK,MAAM,oBAAoB,CAAC,OAAO,QAAQ;CAEzD,IAAI,KAAK;CACT,IAAI,KAAK;CACT,MAAM,OAAO,EAAE;CACf,MAAM,OAAO,EAAE;CAEf,OAAO,KAAK,QAAQ,KAAK,MAAM;EAC7B,MAAM,KAAK,EAAE;EACb,MAAM,KAAK,EAAE;EAEb,MAAM,KAAK,SAAS,IAAI,GAAG;EAC3B,MAAM,KAAK,SAAS,IAAI,GAAG;EAE3B,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,MAAM;EAG7B,IAAI,MAAM,MAAM,GAAI,EAAE;GACpB,IAAI,KAAK,IACP,OAAO;GAET,IAAI,KAAK,IACP,OAAO;GAET;;EAIF,IAAI,MAAM,MAAM,GAAI,EAClB,OAAO,MAAM,GAAG,GAAG,KAAK;EAI1B,IAAI,KAAK,IACP,OAAO;EAET,IAAI,KAAK,IACP,OAAO;;CAIX,OAAO,OAAO,MAAM,OAAO;;;;;;;AAU7B,MAAa,UAAU;CACrB,cAAc;CACd,2BAA2B;CAC3B,OAAO;CACP,UAAU;CACV,MAAM;CACN,mBAAmB;CACpB"}

package/dist/helpers/columnHelper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"columnHelper.cjs","names":[],"sources":["../../src/helpers/columnHelper.ts"],"sourcesContent":["import type { DeepKeys, DeepValue, RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type {\n  AccessorFn,\n  AccessorFnColumnDef,\n  AccessorKeyColumnDef,\n  ColumnDef,\n  DisplayColumnDef,\n  GroupColumnDef,\n  IdentifiedColumnDef,\n} from '../types/ColumnDef'\n\nexport type ColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = {\n  /**\n   * Creates a data column definition with an accessor key or function to extract the cell value.\n   * @example\n   * ```ts\n   * helper.accessor('firstName', { cell: (info) => info.getValue() })\n   * helper.accessor((row) => row.lastName, { id: 'lastName' })\n   * ```\n   */\n  accessor: <\n    TAccessor extends AccessorFn<TData> | DeepKeys<TData>,\n    TValue extends TAccessor extends AccessorFn<TData, infer TReturn>\n      ? TReturn\n      : TAccessor extends DeepKeys<TData>\n        ? DeepValue<TData, TAccessor>\n        : never,\n  >(\n    accessor: TAccessor,\n    column: TAccessor extends AccessorFn<TData>\n      ? DisplayColumnDef<TFeatures, TData, TValue>\n      : IdentifiedColumnDef<TFeatures, TData, TValue>,\n  ) => TAccessor extends AccessorFn<TData>\n    ? AccessorFnColumnDef<TFeatures, TData, TValue>\n    : AccessorKeyColumnDef<TFeatures, TData, TValue>\n  /**\n   * Wraps an array of column definitions to preserve each column's individual TValue type.\n   * Uses variadic tuple types to infer element types before checking constraints, preventing type widening.\n   * @example\n   * ```ts\n   * helper.columns([helper.accessor('firstName', {}), helper.accessor('age', {})])\n   * ```\n   */\n  columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n    columns: [...TColumns],\n  ) => Array<ColumnDef<TFeatures, TData, any>> & [...TColumns]\n  /**\n   * Creates a display column definition for non-data columns like actions or row selection.\n   * @example\n   * ```ts\n   * helper.display({ id: 'actions', header: 'Actions', cell: () => <button>Edit</button> })\n   * ```\n   */\n  display: (\n    column: DisplayColumnDef<TFeatures, TData>,\n  ) => DisplayColumnDef<TFeatures, TData, unknown>\n  /**\n   * Creates a group column definition that contains nested child columns.\n   * @example\n   * ```ts\n   * helper.group({\n   *   id: 'name',\n   *   header: 'Name',\n   *   columns: helper.columns([\n   *     helper.accessor('firstName', {}),\n   *     helper.accessor('lastName', { id: 'lastName' }),\n   *   ]),\n   * })\n   * ```\n   */\n  group: (\n    column: GroupColumnDef<TFeatures, TData, unknown>,\n  ) => GroupColumnDef<TFeatures, TData, unknown>\n}\n\n/**\n * A helper utility for creating column definitions with slightly better type inference for each individual column.\n * The `TValue` generic is inferred based on the accessor key or function provided.\n * **Note:** From a JavaScript perspective, the functions in these helpers do not do anything. They are only used to help TypeScript infer the correct types for the column definitions.\n * @example\n * ```tsx\n * const helper = createColumnHelper<typeof _features, Person>() // _features is the result of `tableFeatures({})` helper\n * const columns = [\n *  helper.display({ id: 'actions', header: 'Actions' }),\n *  helper.accessor('firstName', {}),\n *  helper.accessor((row) => row.lastName, {}\n * ]\n * ```\n */\nexport function createColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): ColumnHelper<TFeatures, TData> {\n  return {\n    accessor: (accessor, column) => {\n      return typeof accessor === 'function'\n        ? ({\n            ...column,\n            accessorFn: accessor,\n          } as any)\n        : {\n            ...column,\n            accessorKey: accessor,\n          }\n    },\n    columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n      columns: [...TColumns],\n    ): Array<ColumnDef<TFeatures, TData, any>> & [...TColumns] =>\n      columns as Array<ColumnDef<TFeatures, TData, any>> & [...TColumns],\n    display: (column) => column,\n    group: (column) => column,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA6FA,SAAgB,qBAGoB;AAClC,QAAO;EACL,WAAW,UAAU,WAAW;AAC9B,UAAO,OAAO,aAAa,aACtB;IACC,GAAG;IACH,YAAY;IACb,GACD;IACE,GAAG;IACH,aAAa;IACd;;EAEP,UACE,YAEA;EACF,UAAU,WAAW;EACrB,QAAQ,WAAW;EACpB"}
+{"version":3,"file":"columnHelper.cjs","names":[],"sources":["../../src/helpers/columnHelper.ts"],"sourcesContent":["import type { DeepKeys, DeepValue, RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type {\n  AccessorFn,\n  AccessorFnColumnDef,\n  AccessorKeyColumnDef,\n  ColumnDef,\n  DisplayColumnDef,\n  GroupColumnDef,\n  IdentifiedColumnDef,\n} from '../types/ColumnDef'\n\nexport type ColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = {\n  /**\n   * Creates a data column definition with an accessor key or function to extract the cell value.\n   * @example\n   * ```ts\n   * helper.accessor('firstName', { cell: (info) => info.getValue() })\n   * helper.accessor((row) => row.lastName, { id: 'lastName' })\n   * ```\n   */\n  accessor: <\n    TAccessor extends AccessorFn<TData> | DeepKeys<TData>,\n    TValue extends TAccessor extends AccessorFn<TData, infer TReturn>\n      ? TReturn\n      : TAccessor extends DeepKeys<TData>\n        ? DeepValue<TData, TAccessor>\n        : never,\n  >(\n    accessor: TAccessor,\n    column: TAccessor extends AccessorFn<TData>\n      ? DisplayColumnDef<TFeatures, TData, TValue>\n      : IdentifiedColumnDef<TFeatures, TData, TValue>,\n  ) => TAccessor extends AccessorFn<TData>\n    ? AccessorFnColumnDef<TFeatures, TData, TValue>\n    : AccessorKeyColumnDef<TFeatures, TData, TValue>\n  /**\n   * Wraps an array of column definitions to preserve each column's individual TValue type.\n   * Uses variadic tuple types to infer element types before checking constraints, preventing type widening.\n   * @example\n   * ```ts\n   * helper.columns([helper.accessor('firstName', {}), helper.accessor('age', {})])\n   * ```\n   */\n  columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n    columns: [...TColumns],\n  ) => Array<ColumnDef<TFeatures, TData, any>> & [...TColumns]\n  /**\n   * Creates a display column definition for non-data columns like actions or row selection.\n   * @example\n   * ```ts\n   * helper.display({ id: 'actions', header: 'Actions', cell: () => <button>Edit</button> })\n   * ```\n   */\n  display: (\n    column: DisplayColumnDef<TFeatures, TData>,\n  ) => DisplayColumnDef<TFeatures, TData, unknown>\n  /**\n   * Creates a group column definition that contains nested child columns.\n   * @example\n   * ```ts\n   * helper.group({\n   *   id: 'name',\n   *   header: 'Name',\n   *   columns: helper.columns([\n   *     helper.accessor('firstName', {}),\n   *     helper.accessor('lastName', { id: 'lastName' }),\n   *   ]),\n   * })\n   * ```\n   */\n  group: (\n    column: GroupColumnDef<TFeatures, TData, unknown>,\n  ) => GroupColumnDef<TFeatures, TData, unknown>\n}\n\n/**\n * A helper utility for creating column definitions with slightly better type inference for each individual column.\n * The `TValue` generic is inferred based on the accessor key or function provided.\n * **Note:** From a JavaScript perspective, the functions in these helpers do not do anything. They are only used to help TypeScript infer the correct types for the column definitions.\n * @example\n * ```tsx\n * const helper = createColumnHelper<typeof _features, Person>() // _features is the result of `tableFeatures({})` helper\n * const columns = [\n *  helper.display({ id: 'actions', header: 'Actions' }),\n *  helper.accessor('firstName', {}),\n *  helper.accessor((row) => row.lastName, {}\n * ]\n * ```\n */\nexport function createColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): ColumnHelper<TFeatures, TData> {\n  return {\n    accessor: (accessor, column) => {\n      return typeof accessor === 'function'\n        ? ({\n            ...column,\n            accessorFn: accessor,\n          } as any)\n        : {\n            ...column,\n            accessorKey: accessor,\n          }\n    },\n    columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n      columns: [...TColumns],\n    ): Array<ColumnDef<TFeatures, TData, any>> & [...TColumns] =>\n      columns as Array<ColumnDef<TFeatures, TData, any>> & [...TColumns],\n    display: (column) => column,\n    group: (column) => column,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA6FA,SAAgB,qBAGoB;CAClC,OAAO;EACL,WAAW,UAAU,WAAW;GAC9B,OAAO,OAAO,aAAa,aACtB;IACC,GAAG;IACH,YAAY;IACb,GACD;IACE,GAAG;IACH,aAAa;IACd;;EAEP,UACE,YAEA;EACF,UAAU,WAAW;EACrB,QAAQ,WAAW;EACpB"}

package/dist/helpers/columnHelper.js.map

@@ -1 +1 @@
-{"version":3,"file":"columnHelper.js","names":[],"sources":["../../src/helpers/columnHelper.ts"],"sourcesContent":["import type { DeepKeys, DeepValue, RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type {\n  AccessorFn,\n  AccessorFnColumnDef,\n  AccessorKeyColumnDef,\n  ColumnDef,\n  DisplayColumnDef,\n  GroupColumnDef,\n  IdentifiedColumnDef,\n} from '../types/ColumnDef'\n\nexport type ColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = {\n  /**\n   * Creates a data column definition with an accessor key or function to extract the cell value.\n   * @example\n   * ```ts\n   * helper.accessor('firstName', { cell: (info) => info.getValue() })\n   * helper.accessor((row) => row.lastName, { id: 'lastName' })\n   * ```\n   */\n  accessor: <\n    TAccessor extends AccessorFn<TData> | DeepKeys<TData>,\n    TValue extends TAccessor extends AccessorFn<TData, infer TReturn>\n      ? TReturn\n      : TAccessor extends DeepKeys<TData>\n        ? DeepValue<TData, TAccessor>\n        : never,\n  >(\n    accessor: TAccessor,\n    column: TAccessor extends AccessorFn<TData>\n      ? DisplayColumnDef<TFeatures, TData, TValue>\n      : IdentifiedColumnDef<TFeatures, TData, TValue>,\n  ) => TAccessor extends AccessorFn<TData>\n    ? AccessorFnColumnDef<TFeatures, TData, TValue>\n    : AccessorKeyColumnDef<TFeatures, TData, TValue>\n  /**\n   * Wraps an array of column definitions to preserve each column's individual TValue type.\n   * Uses variadic tuple types to infer element types before checking constraints, preventing type widening.\n   * @example\n   * ```ts\n   * helper.columns([helper.accessor('firstName', {}), helper.accessor('age', {})])\n   * ```\n   */\n  columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n    columns: [...TColumns],\n  ) => Array<ColumnDef<TFeatures, TData, any>> & [...TColumns]\n  /**\n   * Creates a display column definition for non-data columns like actions or row selection.\n   * @example\n   * ```ts\n   * helper.display({ id: 'actions', header: 'Actions', cell: () => <button>Edit</button> })\n   * ```\n   */\n  display: (\n    column: DisplayColumnDef<TFeatures, TData>,\n  ) => DisplayColumnDef<TFeatures, TData, unknown>\n  /**\n   * Creates a group column definition that contains nested child columns.\n   * @example\n   * ```ts\n   * helper.group({\n   *   id: 'name',\n   *   header: 'Name',\n   *   columns: helper.columns([\n   *     helper.accessor('firstName', {}),\n   *     helper.accessor('lastName', { id: 'lastName' }),\n   *   ]),\n   * })\n   * ```\n   */\n  group: (\n    column: GroupColumnDef<TFeatures, TData, unknown>,\n  ) => GroupColumnDef<TFeatures, TData, unknown>\n}\n\n/**\n * A helper utility for creating column definitions with slightly better type inference for each individual column.\n * The `TValue` generic is inferred based on the accessor key or function provided.\n * **Note:** From a JavaScript perspective, the functions in these helpers do not do anything. They are only used to help TypeScript infer the correct types for the column definitions.\n * @example\n * ```tsx\n * const helper = createColumnHelper<typeof _features, Person>() // _features is the result of `tableFeatures({})` helper\n * const columns = [\n *  helper.display({ id: 'actions', header: 'Actions' }),\n *  helper.accessor('firstName', {}),\n *  helper.accessor((row) => row.lastName, {}\n * ]\n * ```\n */\nexport function createColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): ColumnHelper<TFeatures, TData> {\n  return {\n    accessor: (accessor, column) => {\n      return typeof accessor === 'function'\n        ? ({\n            ...column,\n            accessorFn: accessor,\n          } as any)\n        : {\n            ...column,\n            accessorKey: accessor,\n          }\n    },\n    columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n      columns: [...TColumns],\n    ): Array<ColumnDef<TFeatures, TData, any>> & [...TColumns] =>\n      columns as Array<ColumnDef<TFeatures, TData, any>> & [...TColumns],\n    display: (column) => column,\n    group: (column) => column,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AA6FA,SAAgB,qBAGoB;AAClC,QAAO;EACL,WAAW,UAAU,WAAW;AAC9B,UAAO,OAAO,aAAa,aACtB;IACC,GAAG;IACH,YAAY;IACb,GACD;IACE,GAAG;IACH,aAAa;IACd;;EAEP,UACE,YAEA;EACF,UAAU,WAAW;EACrB,QAAQ,WAAW;EACpB"}
+{"version":3,"file":"columnHelper.js","names":[],"sources":["../../src/helpers/columnHelper.ts"],"sourcesContent":["import type { DeepKeys, DeepValue, RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type {\n  AccessorFn,\n  AccessorFnColumnDef,\n  AccessorKeyColumnDef,\n  ColumnDef,\n  DisplayColumnDef,\n  GroupColumnDef,\n  IdentifiedColumnDef,\n} from '../types/ColumnDef'\n\nexport type ColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n> = {\n  /**\n   * Creates a data column definition with an accessor key or function to extract the cell value.\n   * @example\n   * ```ts\n   * helper.accessor('firstName', { cell: (info) => info.getValue() })\n   * helper.accessor((row) => row.lastName, { id: 'lastName' })\n   * ```\n   */\n  accessor: <\n    TAccessor extends AccessorFn<TData> | DeepKeys<TData>,\n    TValue extends TAccessor extends AccessorFn<TData, infer TReturn>\n      ? TReturn\n      : TAccessor extends DeepKeys<TData>\n        ? DeepValue<TData, TAccessor>\n        : never,\n  >(\n    accessor: TAccessor,\n    column: TAccessor extends AccessorFn<TData>\n      ? DisplayColumnDef<TFeatures, TData, TValue>\n      : IdentifiedColumnDef<TFeatures, TData, TValue>,\n  ) => TAccessor extends AccessorFn<TData>\n    ? AccessorFnColumnDef<TFeatures, TData, TValue>\n    : AccessorKeyColumnDef<TFeatures, TData, TValue>\n  /**\n   * Wraps an array of column definitions to preserve each column's individual TValue type.\n   * Uses variadic tuple types to infer element types before checking constraints, preventing type widening.\n   * @example\n   * ```ts\n   * helper.columns([helper.accessor('firstName', {}), helper.accessor('age', {})])\n   * ```\n   */\n  columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n    columns: [...TColumns],\n  ) => Array<ColumnDef<TFeatures, TData, any>> & [...TColumns]\n  /**\n   * Creates a display column definition for non-data columns like actions or row selection.\n   * @example\n   * ```ts\n   * helper.display({ id: 'actions', header: 'Actions', cell: () => <button>Edit</button> })\n   * ```\n   */\n  display: (\n    column: DisplayColumnDef<TFeatures, TData>,\n  ) => DisplayColumnDef<TFeatures, TData, unknown>\n  /**\n   * Creates a group column definition that contains nested child columns.\n   * @example\n   * ```ts\n   * helper.group({\n   *   id: 'name',\n   *   header: 'Name',\n   *   columns: helper.columns([\n   *     helper.accessor('firstName', {}),\n   *     helper.accessor('lastName', { id: 'lastName' }),\n   *   ]),\n   * })\n   * ```\n   */\n  group: (\n    column: GroupColumnDef<TFeatures, TData, unknown>,\n  ) => GroupColumnDef<TFeatures, TData, unknown>\n}\n\n/**\n * A helper utility for creating column definitions with slightly better type inference for each individual column.\n * The `TValue` generic is inferred based on the accessor key or function provided.\n * **Note:** From a JavaScript perspective, the functions in these helpers do not do anything. They are only used to help TypeScript infer the correct types for the column definitions.\n * @example\n * ```tsx\n * const helper = createColumnHelper<typeof _features, Person>() // _features is the result of `tableFeatures({})` helper\n * const columns = [\n *  helper.display({ id: 'actions', header: 'Actions' }),\n *  helper.accessor('firstName', {}),\n *  helper.accessor((row) => row.lastName, {}\n * ]\n * ```\n */\nexport function createColumnHelper<\n  TFeatures extends TableFeatures,\n  TData extends RowData,\n>(): ColumnHelper<TFeatures, TData> {\n  return {\n    accessor: (accessor, column) => {\n      return typeof accessor === 'function'\n        ? ({\n            ...column,\n            accessorFn: accessor,\n          } as any)\n        : {\n            ...column,\n            accessorKey: accessor,\n          }\n    },\n    columns: <TColumns extends ReadonlyArray<ColumnDef<TFeatures, TData, any>>>(\n      columns: [...TColumns],\n    ): Array<ColumnDef<TFeatures, TData, any>> & [...TColumns] =>\n      columns as Array<ColumnDef<TFeatures, TData, any>> & [...TColumns],\n    display: (column) => column,\n    group: (column) => column,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AA6FA,SAAgB,qBAGoB;CAClC,OAAO;EACL,WAAW,UAAU,WAAW;GAC9B,OAAO,OAAO,aAAa,aACtB;IACC,GAAG;IACH,YAAY;IACb,GACD;IACE,GAAG;IACH,aAAa;IACd;;EAEP,UACE,YAEA;EACF,UAAU,WAAW;EACrB,QAAQ,WAAW;EACpB"}

package/dist/helpers/tableFeatures.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tableFeatures.cjs","names":[],"sources":["../../src/helpers/tableFeatures.ts"],"sourcesContent":["import type { TableFeatures } from '../types/TableFeatures'\n\n/**\n * A helper function to help define the features that are to be imported and applied to a table instance.\n * Use this utility to make it easier to have the correct type inference for the features that are being imported.\n * **Note:** It is recommended to use this utility statically outside of a component.\n * @example\n * ```\n * import { tableFeatures, columnVisibilityFeature, rowPinningFeature } from '@tanstack/react-table'\n * const _features = tableFeatures({ columnVisibilityFeature, rowPinningFeature });\n * const table = useTable({ _features, rowModels: {}, columns, data });\n * ```\n */\nexport function tableFeatures<TFeatures extends TableFeatures>(\n  features: TFeatures,\n): TFeatures {\n  return features\n}\n\n// test\n\n// const features = tableFeatures({\n//   rowPinningFeature: {},\n// });\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,cACd,UACW;AACX,QAAO"}
+{"version":3,"file":"tableFeatures.cjs","names":[],"sources":["../../src/helpers/tableFeatures.ts"],"sourcesContent":["import type { TableFeatures } from '../types/TableFeatures'\n\n/**\n * A helper function to help define the features that are to be imported and applied to a table instance.\n * Use this utility to make it easier to have the correct type inference for the features that are being imported.\n * **Note:** It is recommended to use this utility statically outside of a component.\n * @example\n * ```\n * import { tableFeatures, columnVisibilityFeature, rowPinningFeature } from '@tanstack/react-table'\n * const _features = tableFeatures({ columnVisibilityFeature, rowPinningFeature });\n * const table = useTable({ _features, rowModels: {}, columns, data });\n * ```\n */\nexport function tableFeatures<TFeatures extends TableFeatures>(\n  features: TFeatures,\n): TFeatures {\n  return features\n}\n\n// test\n\n// const features = tableFeatures({\n//   rowPinningFeature: {},\n// });\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,cACd,UACW;CACX,OAAO"}

package/dist/helpers/tableFeatures.js.map

@@ -1 +1 @@
-{"version":3,"file":"tableFeatures.js","names":[],"sources":["../../src/helpers/tableFeatures.ts"],"sourcesContent":["import type { TableFeatures } from '../types/TableFeatures'\n\n/**\n * A helper function to help define the features that are to be imported and applied to a table instance.\n * Use this utility to make it easier to have the correct type inference for the features that are being imported.\n * **Note:** It is recommended to use this utility statically outside of a component.\n * @example\n * ```\n * import { tableFeatures, columnVisibilityFeature, rowPinningFeature } from '@tanstack/react-table'\n * const _features = tableFeatures({ columnVisibilityFeature, rowPinningFeature });\n * const table = useTable({ _features, rowModels: {}, columns, data });\n * ```\n */\nexport function tableFeatures<TFeatures extends TableFeatures>(\n  features: TFeatures,\n): TFeatures {\n  return features\n}\n\n// test\n\n// const features = tableFeatures({\n//   rowPinningFeature: {},\n// });\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,cACd,UACW;AACX,QAAO"}
+{"version":3,"file":"tableFeatures.js","names":[],"sources":["../../src/helpers/tableFeatures.ts"],"sourcesContent":["import type { TableFeatures } from '../types/TableFeatures'\n\n/**\n * A helper function to help define the features that are to be imported and applied to a table instance.\n * Use this utility to make it easier to have the correct type inference for the features that are being imported.\n * **Note:** It is recommended to use this utility statically outside of a component.\n * @example\n * ```\n * import { tableFeatures, columnVisibilityFeature, rowPinningFeature } from '@tanstack/react-table'\n * const _features = tableFeatures({ columnVisibilityFeature, rowPinningFeature });\n * const table = useTable({ _features, rowModels: {}, columns, data });\n * ```\n */\nexport function tableFeatures<TFeatures extends TableFeatures>(\n  features: TFeatures,\n): TFeatures {\n  return features\n}\n\n// test\n\n// const features = tableFeatures({\n//   rowPinningFeature: {},\n// });\n"],"mappings":";;;;;;;;;;;;AAaA,SAAgB,cACd,UACW;CACX,OAAO"}

package/dist/helpers/tableOptions.cjs

@@ -1,5 +1,11 @@
 
 //#region src/helpers/tableOptions.ts
+/**
+* Runtime implementation for `tableOptions`.
+*
+* The helper returns the same object it receives; all value comes from the
+* overloads preserving table option inference at compile time.
+*/
 function tableOptions(options) {
 	return options;
 }

package/dist/helpers/tableOptions.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"tableOptions.cjs","names":[],"sources":["../../src/helpers/tableOptions.ts"],"sourcesContent":["import type { RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type { TableOptions } from '../types/TableOptions'\n\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'columns'> & {\n    _features: TFeatures\n  },\n): Omit<TableOptions<TFeatures, TData>, 'columns' | '_features'> & {\n  _features: TFeatures\n}\n\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'data'> & {\n    _features: TFeatures\n  },\n): Omit<TableOptions<TFeatures, TData>, 'data' | '_features'> & {\n  _features: TFeatures\n}\n\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'data' | 'columns'> & {\n    _features: TFeatures\n  },\n): Omit<TableOptions<TFeatures, TData>, 'data' | 'columns' | '_features'> & {\n  _features: TFeatures\n}\n\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(options: TableOptions<TFeatures, TData>): TableOptions<TFeatures, TData>\n\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, '_features'>,\n): Omit<TableOptions<TFeatures, TData>, '_features'>\n\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'data' | '_features'>,\n): Omit<TableOptions<TFeatures, TData>, 'data' | '_features'>\n\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'columns' | '_features'>,\n): Omit<TableOptions<TFeatures, TData>, 'columns' | '_features'>\n\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<\n    TableOptions<TFeatures, TData>,\n    'data' | 'columns' | '_features'\n  >,\n): Omit<TableOptions<TFeatures, TData>, 'data' | 'columns' | '_features'>\n\nexport function tableOptions(options: unknown) {\n  return options\n}\n\n// test\n\n// const options = tableOptions({\n//   _features: {},\n// })\n"],"mappings":";;AAyEA,SAAgB,aAAa,SAAkB;AAC7C,QAAO"}
+{"version":3,"file":"tableOptions.cjs","names":[],"sources":["../../src/helpers/tableOptions.ts"],"sourcesContent":["import type { RowData } from '../types/type-utils'\nimport type { TableFeatures } from '../types/TableFeatures'\nimport type { TableOptions } from '../types/TableOptions'\n\n/**\n * Returns table options while preserving generic inference.\n *\n * This helper is useful when composing reusable table options outside of a framework adapter call.\n */\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'columns'> & {\n    _features: TFeatures\n  },\n): Omit<TableOptions<TFeatures, TData>, 'columns' | '_features'> & {\n  _features: TFeatures\n}\n\n/**\n * Returns table options while preserving generic inference when `data` is supplied later.\n */\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'data'> & {\n    _features: TFeatures\n  },\n): Omit<TableOptions<TFeatures, TData>, 'data' | '_features'> & {\n  _features: TFeatures\n}\n\n/**\n * Returns table options while preserving generic inference when both `data` and `columns` are supplied later.\n */\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'data' | 'columns'> & {\n    _features: TFeatures\n  },\n): Omit<TableOptions<TFeatures, TData>, 'data' | 'columns' | '_features'> & {\n  _features: TFeatures\n}\n\n/**\n * Returns a fully specified table options object without changing its runtime value.\n */\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(options: TableOptions<TFeatures, TData>): TableOptions<TFeatures, TData>\n\n/**\n * Returns table options while preserving generic inference when `_features` is supplied by a wrapper.\n */\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, '_features'>,\n): Omit<TableOptions<TFeatures, TData>, '_features'>\n\n/**\n * Returns table options while preserving generic inference when `data` and `_features` are supplied by a wrapper.\n */\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'data' | '_features'>,\n): Omit<TableOptions<TFeatures, TData>, 'data' | '_features'>\n\n/**\n * Returns table options while preserving generic inference when `columns` and `_features` are supplied by a wrapper.\n */\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<TableOptions<TFeatures, TData>, 'columns' | '_features'>,\n): Omit<TableOptions<TFeatures, TData>, 'columns' | '_features'>\n\n/**\n * Returns table options while preserving generic inference when `data`, `columns`, and `_features` are supplied by a wrapper.\n */\nexport function tableOptions<\n  TFeatures extends TableFeatures,\n  TData extends RowData = any,\n>(\n  options: Omit<\n    TableOptions<TFeatures, TData>,\n    'data' | 'columns' | '_features'\n  >,\n): Omit<TableOptions<TFeatures, TData>, 'data' | 'columns' | '_features'>\n\n/**\n * Runtime implementation for `tableOptions`.\n *\n * The helper returns the same object it receives; all value comes from the\n * overloads preserving table option inference at compile time.\n */\nexport function tableOptions(options: unknown) {\n  return options\n}\n\n// test\n\n// const options = tableOptions({\n//   _features: {},\n// })\n"],"mappings":";;;;;;;;AAyGA,SAAgB,aAAa,SAAkB;CAC7C,OAAO"}

package/dist/helpers/tableOptions.d.cts

@@ -3,25 +3,51 @@ import { TableOptions } from "../types/TableOptions.cjs";
 import { TableFeatures } from "../types/TableFeatures.cjs";
 
 //#region src/helpers/tableOptions.d.ts
+/**
+ * Returns table options while preserving generic inference.
+ *
+ * This helper is useful when composing reusable table options outside of a framework adapter call.
+ */
 declare function tableOptions<TFeatures extends TableFeatures, TData extends RowData = any>(options: Omit<TableOptions<TFeatures, TData>, 'columns'> & {
   _features: TFeatures;
 }): Omit<TableOptions<TFeatures, TData>, 'columns' | '_features'> & {
   _features: TFeatures;
 };
+/**
+ * Returns table options while preserving generic inference when `data` is supplied later.
+ */
 declare function tableOptions<TFeatures extends TableFeatures, TData extends RowData = any>(options: Omit<TableOptions<TFeatures, TData>, 'data'> & {
   _features: TFeatures;
 }): Omit<TableOptions<TFeatures, TData>, 'data' | '_features'> & {
   _features: TFeatures;
 };
+/**
+ * Returns table options while preserving generic inference when both `data` and `columns` are supplied later.
+ */
 declare function tableOptions<TFeatures extends TableFeatures, TData extends RowData = any>(options: Omit<TableOptions<TFeatures, TData>, 'data' | 'columns'> & {
   _features: TFeatures;
 }): Omit<TableOptions<TFeatures, TData>, 'data' | 'columns' | '_features'> & {
   _features: TFeatures;
 };
+/**
+ * Returns a fully specified table options object without changing its runtime value.
+ */
 declare function tableOptions<TFeatures extends TableFeatures, TData extends RowData = any>(options: TableOptions<TFeatures, TData>): TableOptions<TFeatures, TData>;
+/**
+ * Returns table options while preserving generic inference when `_features` is supplied by a wrapper.
+ */
 declare function tableOptions<TFeatures extends TableFeatures, TData extends RowData = any>(options: Omit<TableOptions<TFeatures, TData>, '_features'>): Omit<TableOptions<TFeatures, TData>, '_features'>;
+/**
+ * Returns table options while preserving generic inference when `data` and `_features` are supplied by a wrapper.
+ */
 declare function tableOptions<TFeatures extends TableFeatures, TData extends RowData = any>(options: Omit<TableOptions<TFeatures, TData>, 'data' | '_features'>): Omit<TableOptions<TFeatures, TData>, 'data' | '_features'>;
+/**
+ * Returns table options while preserving generic inference when `columns` and `_features` are supplied by a wrapper.
+ */
 declare function tableOptions<TFeatures extends TableFeatures, TData extends RowData = any>(options: Omit<TableOptions<TFeatures, TData>, 'columns' | '_features'>): Omit<TableOptions<TFeatures, TData>, 'columns' | '_features'>;
+/**
+ * Returns table options while preserving generic inference when `data`, `columns`, and `_features` are supplied by a wrapper.
+ */
 declare function tableOptions<TFeatures extends TableFeatures, TData extends RowData = any>(options: Omit<TableOptions<TFeatures, TData>, 'data' | 'columns' | '_features'>): Omit<TableOptions<TFeatures, TData>, 'data' | 'columns' | '_features'>;
 //#endregion
 export { tableOptions };