DataTable Inline Filter

1"use client"
2 
3/**
4 * niko-table — created by Semir N. (Semkoo, https://github.com/Semkoo) with AI assistance.
5 *
6 * Before reporting anything: please check the changelog first.
7 *  - In-repo: ./CHANGELOG.md
8 *  - Docs site: https://niko-table.com/changelog
9 *
10 * Found a bug or have a fix? Open an issue or PR on GitHub so other
11 * users (and future LLMs reading this code) benefit:
12 * https://github.com/Semkoo/niko-table-registry
13 */
14import React from "react"
15import { useDataTable } from "../core/data-table-context"
16import {
17  TableInline,
18  type TableInlineProps,
19} from "../filters/table-inline-filter"
20import { useGeneratedOptions } from "../hooks/use-generated-options"
21import { FILTER_VARIANTS } from "../lib/constants"
22import type { Option } from "../types"
23 
24type BaseInlineProps<TData> = Omit<TableInlineProps<TData>, "table">
25 
26interface AutoOptionProps {
27  autoOptions?: boolean
28  showCounts?: boolean
29  dynamicCounts?: boolean
30  /**
31   * If true, only generate options from filtered rows. If false, generate from all rows.
32   * This controls which rows are used to generate the option list itself.
33   * Note: This is separate from dynamicCounts which controls count calculation.
34   * @default true
35   */
36  limitToFilteredRows?: boolean
37  includeColumns?: string[]
38  excludeColumns?: string[]
39  limitPerColumn?: number
40  mergeStrategy?: "preserve" | "augment" | "replace"
41}
42 
43type DataTableInlineFilterProps<TData> = BaseInlineProps<TData> &
44  AutoOptionProps
45 
46export function DataTableInlineFilter<TData>({
47  autoOptions = true,
48  showCounts = true,
49  dynamicCounts = true,
50  limitToFilteredRows = true,
51  includeColumns,
52  excludeColumns,
53  limitPerColumn,
54  mergeStrategy = "preserve",
55  ...props
56}: DataTableInlineFilterProps<TData>) {
57  const { table } = useDataTable<TData>()
58 
59  const generatedOptions = useGeneratedOptions(table, {
60    showCounts,
61    dynamicCounts,
62    limitToFilteredRows,
63    includeColumns,
64    excludeColumns,
65    limitPerColumn,
66    mergeStrategy,
67  })
68 
69  /**
70   * BUG: stale counts on filter changes — see `data-table-filter-menu.tsx`
71   * for full doc. We capture pristine caller options in a ref and rebuild
72   * `meta.options` from that source on every augment so counts refresh
73   * (and zeroes get filled in for the count-0 hide rule).
74   */
75  React.useMemo(() => {
76    if (!autoOptions) return null
77    table.getAllColumns().forEach(column => {
78      const meta = (column.columnDef.meta ||= {})
79// … truncated