@tanstack/table-core 9.0.0-beta.21 → 9.0.0-beta.23

package/dist/fns/filterFns.cjs

@@ -133,9 +133,9 @@ const filterFn_inNumberRange = Object.assign((row, columnId, filterValue) => {
 /**
 * Keeps rows whose scalar column value equals at least one filter value.
 */
-const filterFn_arrHas = (row, columnId, filterValue) => {
+const filterFn_arrHas = Object.assign((row, columnId, filterValue) => {
 	return filterValue.some((val) => row.getValue(columnId) === val);
-};
+}, { autoRemove: (val) => testFalsy(val) || !(val === null || val === void 0 ? void 0 : val.length) });
 /**
 * Keeps rows whose array or string column value includes at least one filter value.
 */

package/dist/fns/filterFns.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"filterFns.cjs","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'\n\n// Basic filters\n\n/**\n * Keeps rows whose column value is strictly equal to the filter value.\n *\n * Uses JavaScript `===` comparison and auto-removes empty filter values.\n */\nexport const filterFn_equals = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId) === filterValue\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose column value is loosely equal to the filter value.\n *\n * Uses JavaScript `==` comparison and auto-removes empty filter values. This is\n * useful for matching string input against numeric row values.\n */\nexport const filterFn_weakEquals = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId) == filterValue\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n// String filters\n\n/**\n * Keeps rows whose stringified column value includes the filter text.\n *\n * Matching is case-sensitive and empty filter values are auto-removed.\n */\nexport const filterFn_includesStringSensitive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return Boolean(\n      row.getValue(columnId)?.toString().includes(String(filterValue)),\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value includes the filter text.\n *\n * Both values are lowercased before comparison, and empty filter values are\n * auto-removed.\n */\nexport const filterFn_includesString = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return Boolean(\n      row\n        .getValue(columnId)\n        ?.toString()\n        .toLowerCase()\n        .includes(String(filterValue).toLowerCase()),\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value equals the filter text.\n *\n * Both values are lowercased before comparison, and empty filter values are\n * auto-removed.\n */\nexport const filterFn_equalsString = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return (\n      row.getValue(columnId)?.toString().toLowerCase() ===\n      String(filterValue).toLowerCase()\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value exactly equals the filter text.\n *\n * Matching is case-sensitive and empty filter values are auto-removed.\n */\nexport const filterFn_equalsStringSensitive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId)?.toString() === String(filterValue)\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n// Number filters\n\n/**\n * Keeps rows whose value is greater than the filter value.\n *\n * Numeric values are compared numerically when both sides can be coerced to\n * numbers; otherwise normalized strings are compared.\n */\nexport const filterFn_greaterThan = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    const rowValue = row.getValue(columnId)\n    const numericRowValue =\n      rowValue === null || rowValue === undefined ? 0 : +rowValue\n    const numericFilterValue = Number(filterValue)\n\n    if (!isNaN(numericFilterValue) && !isNaN(numericRowValue)) {\n      return numericRowValue > numericFilterValue\n    }\n\n    const stringValue = (rowValue ?? '').toString().toLowerCase().trim()\n    const stringFilterValue = String(filterValue).toLowerCase().trim()\n    return stringValue > stringFilterValue\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is greater than or equal to the filter value.\n *\n * Delegates to the built-in greater-than and equality comparisons.\n */\nexport const filterFn_greaterThanOrEqualTo = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return (\n      filterFn_greaterThan(row, columnId, filterValue) ||\n      filterFn_equals(row, columnId, filterValue)\n    )\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is less than the filter value.\n *\n * This is implemented as the inverse of greater-than-or-equal comparison.\n */\nexport const filterFn_lessThan = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return !filterFn_greaterThanOrEqualTo(row, columnId, filterValue)\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is less than or equal to the filter value.\n *\n * This is implemented as the inverse of greater-than comparison.\n */\nexport const filterFn_lessThanOrEqualTo = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return !filterFn_greaterThan(row, columnId, filterValue)\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n// Range filters\n\n/**\n * Keeps rows whose value falls between an exclusive min/max pair.\n *\n * Blank range endpoints are treated as open-ended.\n */\nconst filterFn_between = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValues: [unknown, unknown],\n  ): boolean =>\n    ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n      filterFn_greaterThan(row, columnId, filterValues[0])) &&\n    ((!isNaN(Number(filterValues[0])) &&\n      !isNaN(Number(filterValues[1])) &&\n      Number(filterValues[0]) > Number(filterValues[1])) ||\n      (['', undefined] as Array<any>).includes(filterValues[1]) ||\n      filterFn_lessThan(row, columnId, filterValues[1])),\n  {\n    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n/**\n * Keeps rows whose value falls between an inclusive min/max pair.\n *\n * Blank range endpoints are treated as open-ended.\n */\nconst filterFn_betweenInclusive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValues: [unknown, unknown],\n  ): boolean =>\n    ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n      filterFn_greaterThanOrEqualTo(row, columnId, filterValues[0])) &&\n    ((!isNaN(Number(filterValues[0])) &&\n      !isNaN(Number(filterValues[1])) &&\n      Number(filterValues[0]) > Number(filterValues[1])) ||\n      (['', undefined] as Array<any>).includes(filterValues[1]) ||\n      filterFn_lessThanOrEqualTo(row, columnId, filterValues[1])),\n  {\n    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n/**\n * Keeps rows whose numeric value is inside an inclusive `[min, max]` range.\n *\n * Filter values are normalized so blank endpoints become open-ended and\n * reversed endpoints are swapped.\n */\nexport const filterFn_inNumberRange = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  {\n    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 =\n        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    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n// Array filters\n\n/**\n * Keeps rows whose scalar column value equals at least one filter value.\n */\nexport const filterFn_arrHas = <\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 * Keeps rows whose array or string column value includes at least one filter value.\n */\nexport const filterFn_arrIncludes = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array column value includes every filter value.\n */\nexport const filterFn_arrIncludesAll = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array column value includes at least one filter value.\n */\nexport const filterFn_arrIncludesSome = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\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":";;;;;;;AAWA,MAAa,kBAAkB,OAAO,QAElC,KACA,UACA,gBACG;CACH,OAAO,IAAI,SAAS,QAAQ,MAAM;AACpC,GACA,EAAE,aAAa,QAAa,UAAU,GAAG,EAAE,CAC7C;;;;;;;AAQA,MAAa,sBAAsB,OAAO,QAEtC,KACA,UACA,gBACG;CACH,OAAO,IAAI,SAAS,QAAQ,KAAK;AACnC,GACA,EAAE,aAAa,QAAa,UAAU,GAAG,EAAE,CAC7C;;;;;;AASA,MAAa,mCAAmC,OAAO,QAEnD,KACA,UACA,gBACG;;CACH,OAAO,yBACL,IAAI,SAAS,QAAQ,iEAAG,SAAS,CAAC,CAAC,SAAS,OAAO,WAAW,CAAC,CACjE;AACF,GACA,EAAE,aAAa,QAAa,UAAU,GAAG,EAAE,CAC7C;;;;;;;AAQA,MAAa,0BAA0B,OAAO,QAE1C,KACA,UACA,gBACG;;CACH,OAAO,0BACL,IACG,SAAS,QAAQ,mEAChB,SAAS,CAAC,CACX,YAAY,CAAC,CACb,SAAS,OAAO,WAAW,CAAC,CAAC,YAAY,CAAC,CAC/C;AACF,GACA,EAAE,aAAa,QAAa,UAAU,GAAG,EAAE,CAC7C;;;;;;;AAQA,MAAa,wBAAwB,OAAO,QAExC,KACA,UACA,gBACG;;CACH,0BACE,IAAI,SAAS,QAAQ,mEAAG,SAAS,CAAC,CAAC,YAAY,OAC/C,OAAO,WAAW,CAAC,CAAC,YAAY;AAEpC,GACA,EAAE,aAAa,QAAa,UAAU,GAAG,EAAE,CAC7C;;;;;;AAOA,MAAa,iCAAiC,OAAO,QAEjD,KACA,UACA,gBACG;;CACH,0BAAO,IAAI,SAAS,QAAQ,mEAAG,SAAS,OAAM,OAAO,WAAW;AAClE,GACA,EAAE,aAAa,QAAa,UAAU,GAAG,EAAE,CAC7C;;;;;;;AAUA,MAAa,uBAAuB,OAAO,QAEvC,KACA,UACA,gBACG;CACH,MAAM,WAAW,IAAI,SAAS,QAAQ;CACtC,MAAM,kBACJ,aAAa,QAAQ,aAAa,SAAY,IAAI,CAAC;CACrD,MAAM,qBAAqB,OAAO,WAAW;CAE7C,IAAI,CAAC,MAAM,kBAAkB,KAAK,CAAC,MAAM,eAAe,GACtD,OAAO,kBAAkB;CAK3B,QAFqB,YAAY,GAAE,CAAE,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,KAE7C,IADS,OAAO,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,KACvB;AACvC,GACA,EAAE,qBAAqB,QAAa,UAAU,GAAG,EAAE,CACrD;;;;;;AAOA,MAAa,gCAAgC,OAAO,QAEhD,KACA,UACA,gBACG;CACH,OACE,qBAAqB,KAAK,UAAU,WAAW,KAC/C,gBAAgB,KAAK,UAAU,WAAW;AAE9C,GACA,EAAE,qBAAqB,QAAa,UAAU,GAAG,EAAE,CACrD;;;;;;AAOA,MAAa,oBAAoB,OAAO,QAEpC,KACA,UACA,gBACG;CACH,OAAO,CAAC,8BAA8B,KAAK,UAAU,WAAW;AAClE,GACA,EAAE,qBAAqB,QAAa,UAAU,GAAG,EAAE,CACrD;;;;;;AAOA,MAAa,6BAA6B,OAAO,QAE7C,KACA,UACA,gBACG;CACH,OAAO,CAAC,qBAAqB,KAAK,UAAU,WAAW;AACzD,GACA,EAAE,qBAAqB,QAAa,UAAU,GAAG,EAAE,CACrD;;;;;;AASA,MAAM,mBAAmB,OAAO,QAE5B,KACA,UACA,kBAEE,CAAC,IAAI,MAAS,CAAC,CAAgB,SAAS,aAAa,EAAE,KACvD,qBAAqB,KAAK,UAAU,aAAa,EAAE,OACnD,CAAC,MAAM,OAAO,aAAa,EAAE,CAAC,KAC9B,CAAC,MAAM,OAAO,aAAa,EAAE,CAAC,KAC9B,OAAO,aAAa,EAAE,IAAI,OAAO,aAAa,EAAE,KAC/C,CAAC,IAAI,MAAS,CAAC,CAAgB,SAAS,aAAa,EAAE,KACxD,kBAAkB,KAAK,UAAU,aAAa,EAAE,IACpD,EACE,aAAa,QACX,UAAU,GAAG,KAAM,UAAU,IAAI,EAAE,KAAK,UAAU,IAAI,EAAE,EAC5D,CACF;;;;;;AAOA,MAAM,4BAA4B,OAAO,QAErC,KACA,UACA,kBAEE,CAAC,IAAI,MAAS,CAAC,CAAgB,SAAS,aAAa,EAAE,KACvD,8BAA8B,KAAK,UAAU,aAAa,EAAE,OAC5D,CAAC,MAAM,OAAO,aAAa,EAAE,CAAC,KAC9B,CAAC,MAAM,OAAO,aAAa,EAAE,CAAC,KAC9B,OAAO,aAAa,EAAE,IAAI,OAAO,aAAa,EAAE,KAC/C,CAAC,IAAI,MAAS,CAAC,CAAgB,SAAS,aAAa,EAAE,KACxD,2BAA2B,KAAK,UAAU,aAAa,EAAE,IAC7D,EACE,aAAa,QACX,UAAU,GAAG,KAAM,UAAU,IAAI,EAAE,KAAK,UAAU,IAAI,EAAE,EAC5D,CACF;;;;;;;AAQA,MAAa,yBAAyB,OAAO,QAEzC,KACA,UACA,gBACG;CACH,MAAM,CAAC,KAAK,OAAO;CAEnB,MAAM,WAAmB,IAAI,SAAS,QAAQ;CAC9C,OAAO,YAAY,OAAO,YAAY;AACxC,GACA;CACE,qBAAqB,QAAoB;EACvC,MAAM,CAAC,WAAW,aAAa;EAE/B,MAAM,YACJ,OAAO,cAAc,WAAW,WAAW,SAAS,IAAI;EAC1D,MAAM,YACJ,OAAO,cAAc,WAAW,WAAW,SAAS,IAAI;EAE1D,IAAI,MACF,cAAc,QAAQ,OAAO,MAAM,SAAS,IAAI,YAAY;EAC9D,IAAI,MACF,cAAc,QAAQ,OAAO,MAAM,SAAS,IAAI,WAAW;EAE7D,IAAI,MAAM,KAAK;GACb,MAAM,OAAO;GACb,MAAM;GACN,MAAM;EACR;EAEA,OAAO,CAAC,KAAK,GAAG;CAClB;CACA,aAAa,QACX,UAAU,GAAG,KAAM,UAAU,IAAI,EAAE,KAAK,UAAU,IAAI,EAAE;AAC5D,CACF;;;;AAOA,MAAa,mBAIX,KACA,UACA,gBACG;CACH,OAAO,YAAY,MAAM,QAAQ,IAAI,SAAkB,QAAQ,MAAM,GAAG;AAC1E;;;;AAKA,MAAa,uBAAuB,OAAO,QAEvC,KACA,UACA,gBACG;CACH,OAAO,YAAY,MAAM,QACtB,IAAI,SAAkB,QAAQ,CAAC,CAA6B,SAC3D,GACF,CACF;AACF,GACA,EAAE,aAAa,QAAa,UAAU,GAAG,KAAK,4CAAC,IAAK,QAAO,CAC7D;;;;AAKA,MAAa,0BAA0B,OAAO,QAE1C,KACA,UACA,gBACG;CACH,MAAM,QAAQ,IAAI,SAAyB,QAAQ;CACnD,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO;CAClC,OAAO,CAAC,YAAY,MAAM,QAAQ,CAAC,MAAM,SAAS,GAAG,CAAC;AACxD,GACA,EAAE,aAAa,QAAa,UAAU,GAAG,KAAK,4CAAC,IAAK,QAAO,CAC7D;;;;AAKA,MAAa,2BAA2B,OAAO,QAE3C,KACA,UACA,gBACG;CACH,MAAM,QAAQ,IAAI,SAAyB,QAAQ;CACnD,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO;CAClC,OAAO,YAAY,MAAM,QAAQ,MAAM,SAAS,GAAG,CAAC;AACtD,GACA,EAAE,aAAa,QAAa,UAAU,GAAG,KAAK,4CAAC,IAAK,QAAO,CAC7D;;;;;;AASA,MAAa,YAAY;CACvB,aAAa;CACb,gBAAgB;CAChB,QAAQ;CACR,iBAAiB;CACjB,SAAS;CACT,kBAAkB;CAClB,QAAQ;CACR,cAAc;CACd,eAAe;CACf,gBAAgB;CAChB,yBAAyB;CACzB,YAAY;AACd;AAMA,SAAS,UAAU,KAAU;CAC3B,OAAO,QAAQ,UAAa,QAAQ,QAAQ,QAAQ;AACtD"}
+{"version":3,"file":"filterFns.cjs","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'\n\n// Basic filters\n\n/**\n * Keeps rows whose column value is strictly equal to the filter value.\n *\n * Uses JavaScript `===` comparison and auto-removes empty filter values.\n */\nexport const filterFn_equals = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId) === filterValue\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose column value is loosely equal to the filter value.\n *\n * Uses JavaScript `==` comparison and auto-removes empty filter values. This is\n * useful for matching string input against numeric row values.\n */\nexport const filterFn_weakEquals = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId) == filterValue\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n// String filters\n\n/**\n * Keeps rows whose stringified column value includes the filter text.\n *\n * Matching is case-sensitive and empty filter values are auto-removed.\n */\nexport const filterFn_includesStringSensitive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return Boolean(\n      row.getValue(columnId)?.toString().includes(String(filterValue)),\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value includes the filter text.\n *\n * Both values are lowercased before comparison, and empty filter values are\n * auto-removed.\n */\nexport const filterFn_includesString = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return Boolean(\n      row\n        .getValue(columnId)\n        ?.toString()\n        .toLowerCase()\n        .includes(String(filterValue).toLowerCase()),\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value equals the filter text.\n *\n * Both values are lowercased before comparison, and empty filter values are\n * auto-removed.\n */\nexport const filterFn_equalsString = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return (\n      row.getValue(columnId)?.toString().toLowerCase() ===\n      String(filterValue).toLowerCase()\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value exactly equals the filter text.\n *\n * Matching is case-sensitive and empty filter values are auto-removed.\n */\nexport const filterFn_equalsStringSensitive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId)?.toString() === String(filterValue)\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n// Number filters\n\n/**\n * Keeps rows whose value is greater than the filter value.\n *\n * Numeric values are compared numerically when both sides can be coerced to\n * numbers; otherwise normalized strings are compared.\n */\nexport const filterFn_greaterThan = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    const rowValue = row.getValue(columnId)\n    const numericRowValue =\n      rowValue === null || rowValue === undefined ? 0 : +rowValue\n    const numericFilterValue = Number(filterValue)\n\n    if (!isNaN(numericFilterValue) && !isNaN(numericRowValue)) {\n      return numericRowValue > numericFilterValue\n    }\n\n    const stringValue = (rowValue ?? '').toString().toLowerCase().trim()\n    const stringFilterValue = String(filterValue).toLowerCase().trim()\n    return stringValue > stringFilterValue\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is greater than or equal to the filter value.\n *\n * Delegates to the built-in greater-than and equality comparisons.\n */\nexport const filterFn_greaterThanOrEqualTo = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return (\n      filterFn_greaterThan(row, columnId, filterValue) ||\n      filterFn_equals(row, columnId, filterValue)\n    )\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is less than the filter value.\n *\n * This is implemented as the inverse of greater-than-or-equal comparison.\n */\nexport const filterFn_lessThan = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return !filterFn_greaterThanOrEqualTo(row, columnId, filterValue)\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is less than or equal to the filter value.\n *\n * This is implemented as the inverse of greater-than comparison.\n */\nexport const filterFn_lessThanOrEqualTo = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return !filterFn_greaterThan(row, columnId, filterValue)\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n// Range filters\n\n/**\n * Keeps rows whose value falls between an exclusive min/max pair.\n *\n * Blank range endpoints are treated as open-ended.\n */\nconst filterFn_between = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValues: [unknown, unknown],\n  ): boolean =>\n    ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n      filterFn_greaterThan(row, columnId, filterValues[0])) &&\n    ((!isNaN(Number(filterValues[0])) &&\n      !isNaN(Number(filterValues[1])) &&\n      Number(filterValues[0]) > Number(filterValues[1])) ||\n      (['', undefined] as Array<any>).includes(filterValues[1]) ||\n      filterFn_lessThan(row, columnId, filterValues[1])),\n  {\n    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n/**\n * Keeps rows whose value falls between an inclusive min/max pair.\n *\n * Blank range endpoints are treated as open-ended.\n */\nconst filterFn_betweenInclusive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValues: [unknown, unknown],\n  ): boolean =>\n    ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n      filterFn_greaterThanOrEqualTo(row, columnId, filterValues[0])) &&\n    ((!isNaN(Number(filterValues[0])) &&\n      !isNaN(Number(filterValues[1])) &&\n      Number(filterValues[0]) > Number(filterValues[1])) ||\n      (['', undefined] as Array<any>).includes(filterValues[1]) ||\n      filterFn_lessThanOrEqualTo(row, columnId, filterValues[1])),\n  {\n    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n/**\n * Keeps rows whose numeric value is inside an inclusive `[min, max]` range.\n *\n * Filter values are normalized so blank endpoints become open-ended and\n * reversed endpoints are swapped.\n */\nexport const filterFn_inNumberRange = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  {\n    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 =\n        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    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n// Array filters\n\n/**\n * Keeps rows whose scalar column value equals at least one filter value.\n */\nexport const filterFn_arrHas = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array or string column value includes at least one filter value.\n */\nexport const filterFn_arrIncludes = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array column value includes every filter value.\n */\nexport const filterFn_arrIncludesAll = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array column value includes at least one filter value.\n */\nexport const filterFn_arrIncludesSome = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\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/filterFns.d.cts

@@ -100,7 +100,9 @@ declare const filterFn_inNumberRange: (<TFeatures extends TableFeatures, TData e
 /**
  * Keeps rows whose scalar column value equals at least one filter value.
  */
-declare const filterFn_arrHas: <TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean;
+declare const filterFn_arrHas: (<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+  autoRemove: (val: any) => boolean;
+};
 /**
  * Keeps rows whose array or string column value includes at least one filter value.
  */
@@ -131,7 +133,9 @@ declare const filterFns: {
   arrIncludesAll: (<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
     autoRemove: (val: any) => boolean;
   };
-  arrHas: <TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean;
+  arrHas: (<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+    autoRemove: (val: any) => boolean;
+  };
   arrIncludesSome: (<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
     autoRemove: (val: any) => boolean;
   };

package/dist/fns/filterFns.d.ts

@@ -100,7 +100,9 @@ declare const filterFn_inNumberRange: (<TFeatures extends TableFeatures, TData e
 /**
  * Keeps rows whose scalar column value equals at least one filter value.
  */
-declare const filterFn_arrHas: <TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean;
+declare const filterFn_arrHas: (<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+  autoRemove: (val: any) => boolean;
+};
 /**
  * Keeps rows whose array or string column value includes at least one filter value.
  */
@@ -131,7 +133,9 @@ declare const filterFns: {
   arrIncludesAll: (<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
     autoRemove: (val: any) => boolean;
   };
-  arrHas: <TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean;
+  arrHas: (<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
+    autoRemove: (val: any) => boolean;
+  };
   arrIncludesSome: (<TFeatures extends TableFeatures, TData extends RowData>(row: Row<TFeatures, TData>, columnId: string, filterValue: Array<unknown>) => boolean) & {
     autoRemove: (val: any) => boolean;
   };

package/dist/fns/filterFns.js

@@ -132,9 +132,9 @@ const filterFn_inNumberRange = Object.assign((row, columnId, filterValue) => {
 /**
 * Keeps rows whose scalar column value equals at least one filter value.
 */
-const filterFn_arrHas = (row, columnId, filterValue) => {
+const filterFn_arrHas = Object.assign((row, columnId, filterValue) => {
 	return filterValue.some((val) => row.getValue(columnId) === val);
-};
+}, { autoRemove: (val) => testFalsy(val) || !(val === null || val === void 0 ? void 0 : val.length) });
 /**
 * Keeps rows whose array or string column value includes at least one filter value.
 */

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'\n\n// Basic filters\n\n/**\n * Keeps rows whose column value is strictly equal to the filter value.\n *\n * Uses JavaScript `===` comparison and auto-removes empty filter values.\n */\nexport const filterFn_equals = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId) === filterValue\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose column value is loosely equal to the filter value.\n *\n * Uses JavaScript `==` comparison and auto-removes empty filter values. This is\n * useful for matching string input against numeric row values.\n */\nexport const filterFn_weakEquals = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId) == filterValue\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n// String filters\n\n/**\n * Keeps rows whose stringified column value includes the filter text.\n *\n * Matching is case-sensitive and empty filter values are auto-removed.\n */\nexport const filterFn_includesStringSensitive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return Boolean(\n      row.getValue(columnId)?.toString().includes(String(filterValue)),\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value includes the filter text.\n *\n * Both values are lowercased before comparison, and empty filter values are\n * auto-removed.\n */\nexport const filterFn_includesString = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return Boolean(\n      row\n        .getValue(columnId)\n        ?.toString()\n        .toLowerCase()\n        .includes(String(filterValue).toLowerCase()),\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value equals the filter text.\n *\n * Both values are lowercased before comparison, and empty filter values are\n * auto-removed.\n */\nexport const filterFn_equalsString = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return (\n      row.getValue(columnId)?.toString().toLowerCase() ===\n      String(filterValue).toLowerCase()\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value exactly equals the filter text.\n *\n * Matching is case-sensitive and empty filter values are auto-removed.\n */\nexport const filterFn_equalsStringSensitive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId)?.toString() === String(filterValue)\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n// Number filters\n\n/**\n * Keeps rows whose value is greater than the filter value.\n *\n * Numeric values are compared numerically when both sides can be coerced to\n * numbers; otherwise normalized strings are compared.\n */\nexport const filterFn_greaterThan = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    const rowValue = row.getValue(columnId)\n    const numericRowValue =\n      rowValue === null || rowValue === undefined ? 0 : +rowValue\n    const numericFilterValue = Number(filterValue)\n\n    if (!isNaN(numericFilterValue) && !isNaN(numericRowValue)) {\n      return numericRowValue > numericFilterValue\n    }\n\n    const stringValue = (rowValue ?? '').toString().toLowerCase().trim()\n    const stringFilterValue = String(filterValue).toLowerCase().trim()\n    return stringValue > stringFilterValue\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is greater than or equal to the filter value.\n *\n * Delegates to the built-in greater-than and equality comparisons.\n */\nexport const filterFn_greaterThanOrEqualTo = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return (\n      filterFn_greaterThan(row, columnId, filterValue) ||\n      filterFn_equals(row, columnId, filterValue)\n    )\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is less than the filter value.\n *\n * This is implemented as the inverse of greater-than-or-equal comparison.\n */\nexport const filterFn_lessThan = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return !filterFn_greaterThanOrEqualTo(row, columnId, filterValue)\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is less than or equal to the filter value.\n *\n * This is implemented as the inverse of greater-than comparison.\n */\nexport const filterFn_lessThanOrEqualTo = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return !filterFn_greaterThan(row, columnId, filterValue)\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n// Range filters\n\n/**\n * Keeps rows whose value falls between an exclusive min/max pair.\n *\n * Blank range endpoints are treated as open-ended.\n */\nconst filterFn_between = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValues: [unknown, unknown],\n  ): boolean =>\n    ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n      filterFn_greaterThan(row, columnId, filterValues[0])) &&\n    ((!isNaN(Number(filterValues[0])) &&\n      !isNaN(Number(filterValues[1])) &&\n      Number(filterValues[0]) > Number(filterValues[1])) ||\n      (['', undefined] as Array<any>).includes(filterValues[1]) ||\n      filterFn_lessThan(row, columnId, filterValues[1])),\n  {\n    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n/**\n * Keeps rows whose value falls between an inclusive min/max pair.\n *\n * Blank range endpoints are treated as open-ended.\n */\nconst filterFn_betweenInclusive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValues: [unknown, unknown],\n  ): boolean =>\n    ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n      filterFn_greaterThanOrEqualTo(row, columnId, filterValues[0])) &&\n    ((!isNaN(Number(filterValues[0])) &&\n      !isNaN(Number(filterValues[1])) &&\n      Number(filterValues[0]) > Number(filterValues[1])) ||\n      (['', undefined] as Array<any>).includes(filterValues[1]) ||\n      filterFn_lessThanOrEqualTo(row, columnId, filterValues[1])),\n  {\n    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n/**\n * Keeps rows whose numeric value is inside an inclusive `[min, max]` range.\n *\n * Filter values are normalized so blank endpoints become open-ended and\n * reversed endpoints are swapped.\n */\nexport const filterFn_inNumberRange = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  {\n    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 =\n        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    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n// Array filters\n\n/**\n * Keeps rows whose scalar column value equals at least one filter value.\n */\nexport const filterFn_arrHas = <\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 * Keeps rows whose array or string column value includes at least one filter value.\n */\nexport const filterFn_arrIncludes = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array column value includes every filter value.\n */\nexport const filterFn_arrIncludesAll = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array column value includes at least one filter value.\n */\nexport const filterFn_arrIncludesSome = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\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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"}
+{"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'\n\n// Basic filters\n\n/**\n * Keeps rows whose column value is strictly equal to the filter value.\n *\n * Uses JavaScript `===` comparison and auto-removes empty filter values.\n */\nexport const filterFn_equals = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId) === filterValue\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose column value is loosely equal to the filter value.\n *\n * Uses JavaScript `==` comparison and auto-removes empty filter values. This is\n * useful for matching string input against numeric row values.\n */\nexport const filterFn_weakEquals = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId) == filterValue\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n// String filters\n\n/**\n * Keeps rows whose stringified column value includes the filter text.\n *\n * Matching is case-sensitive and empty filter values are auto-removed.\n */\nexport const filterFn_includesStringSensitive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return Boolean(\n      row.getValue(columnId)?.toString().includes(String(filterValue)),\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value includes the filter text.\n *\n * Both values are lowercased before comparison, and empty filter values are\n * auto-removed.\n */\nexport const filterFn_includesString = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return Boolean(\n      row\n        .getValue(columnId)\n        ?.toString()\n        .toLowerCase()\n        .includes(String(filterValue).toLowerCase()),\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value equals the filter text.\n *\n * Both values are lowercased before comparison, and empty filter values are\n * auto-removed.\n */\nexport const filterFn_equalsString = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return (\n      row.getValue(columnId)?.toString().toLowerCase() ===\n      String(filterValue).toLowerCase()\n    )\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose stringified column value exactly equals the filter text.\n *\n * Matching is case-sensitive and empty filter values are auto-removed.\n */\nexport const filterFn_equalsStringSensitive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return row.getValue(columnId)?.toString() === String(filterValue)\n  },\n  { autoRemove: (val: any) => testFalsy(val) },\n)\n\n// Number filters\n\n/**\n * Keeps rows whose value is greater than the filter value.\n *\n * Numeric values are compared numerically when both sides can be coerced to\n * numbers; otherwise normalized strings are compared.\n */\nexport const filterFn_greaterThan = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    const rowValue = row.getValue(columnId)\n    const numericRowValue =\n      rowValue === null || rowValue === undefined ? 0 : +rowValue\n    const numericFilterValue = Number(filterValue)\n\n    if (!isNaN(numericFilterValue) && !isNaN(numericRowValue)) {\n      return numericRowValue > numericFilterValue\n    }\n\n    const stringValue = (rowValue ?? '').toString().toLowerCase().trim()\n    const stringFilterValue = String(filterValue).toLowerCase().trim()\n    return stringValue > stringFilterValue\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is greater than or equal to the filter value.\n *\n * Delegates to the built-in greater-than and equality comparisons.\n */\nexport const filterFn_greaterThanOrEqualTo = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return (\n      filterFn_greaterThan(row, columnId, filterValue) ||\n      filterFn_equals(row, columnId, filterValue)\n    )\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is less than the filter value.\n *\n * This is implemented as the inverse of greater-than-or-equal comparison.\n */\nexport const filterFn_lessThan = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return !filterFn_greaterThanOrEqualTo(row, columnId, filterValue)\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n/**\n * Keeps rows whose value is less than or equal to the filter value.\n *\n * This is implemented as the inverse of greater-than comparison.\n */\nexport const filterFn_lessThanOrEqualTo = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValue: unknown,\n  ) => {\n    return !filterFn_greaterThan(row, columnId, filterValue)\n  },\n  { resolveFilterValue: (val: any) => testFalsy(val) },\n)\n\n// Range filters\n\n/**\n * Keeps rows whose value falls between an exclusive min/max pair.\n *\n * Blank range endpoints are treated as open-ended.\n */\nconst filterFn_between = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValues: [unknown, unknown],\n  ): boolean =>\n    ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n      filterFn_greaterThan(row, columnId, filterValues[0])) &&\n    ((!isNaN(Number(filterValues[0])) &&\n      !isNaN(Number(filterValues[1])) &&\n      Number(filterValues[0]) > Number(filterValues[1])) ||\n      (['', undefined] as Array<any>).includes(filterValues[1]) ||\n      filterFn_lessThan(row, columnId, filterValues[1])),\n  {\n    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n/**\n * Keeps rows whose value falls between an inclusive min/max pair.\n *\n * Blank range endpoints are treated as open-ended.\n */\nconst filterFn_betweenInclusive = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\n    row: Row<TFeatures, TData>,\n    columnId: string,\n    filterValues: [unknown, unknown],\n  ): boolean =>\n    ((['', undefined] as Array<any>).includes(filterValues[0]) ||\n      filterFn_greaterThanOrEqualTo(row, columnId, filterValues[0])) &&\n    ((!isNaN(Number(filterValues[0])) &&\n      !isNaN(Number(filterValues[1])) &&\n      Number(filterValues[0]) > Number(filterValues[1])) ||\n      (['', undefined] as Array<any>).includes(filterValues[1]) ||\n      filterFn_lessThanOrEqualTo(row, columnId, filterValues[1])),\n  {\n    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n/**\n * Keeps rows whose numeric value is inside an inclusive `[min, max]` range.\n *\n * Filter values are normalized so blank endpoints become open-ended and\n * reversed endpoints are swapped.\n */\nexport const filterFn_inNumberRange = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  {\n    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 =\n        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    autoRemove: (val: any) =>\n      testFalsy(val) || (testFalsy(val[0]) && testFalsy(val[1])),\n  },\n)\n\n// Array filters\n\n/**\n * Keeps rows whose scalar column value equals at least one filter value.\n */\nexport const filterFn_arrHas = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array or string column value includes at least one filter value.\n */\nexport const filterFn_arrIncludes = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array column value includes every filter value.\n */\nexport const filterFn_arrIncludesAll = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\n\n/**\n * Keeps rows whose array column value includes at least one filter value.\n */\nexport const filterFn_arrIncludesSome = Object.assign(\n  <TFeatures extends TableFeatures, TData extends RowData>(\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  { autoRemove: (val: any) => testFalsy(val) || !val?.length },\n)\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/table-core",
-  "version": "9.0.0-beta.21",
+  "version": "9.0.0-beta.23",
   "description": "Headless UI for building powerful tables & datagrids for TS/JS.",
   "author": "Tanner Linsley",
   "license": "MIT",

package/src/fns/filterFns.ts

@@ -296,16 +296,16 @@ export const filterFn_inNumberRange = Object.assign(
 /**
  * Keeps rows whose scalar column value equals at least one filter value.
  */
-export const filterFn_arrHas = <
-  TFeatures extends TableFeatures,
-  TData extends RowData,
->(
-  row: Row<TFeatures, TData>,
-  columnId: string,
-  filterValue: Array<unknown>,
-) => {
-  return filterValue.some((val) => row.getValue<unknown>(columnId) === val)
-}
+export const filterFn_arrHas = Object.assign(
+  <TFeatures extends TableFeatures, TData extends RowData>(
+    row: Row<TFeatures, TData>,
+    columnId: string,
+    filterValue: Array<unknown>,
+  ) => {
+    return filterValue.some((val) => row.getValue<unknown>(columnId) === val)
+  },
+  { autoRemove: (val: any) => testFalsy(val) || !val?.length },
+)
 
 /**
  * Keeps rows whose array or string column value includes at least one filter value.