@siyahi/ui 0.0.0-stage → 0.1.0-next.3

package/dist/components/registry/niko-table/filters/table-column-sort.js

@@ -0,0 +1,184 @@
+"use client";
+import { Button } from "../../../ui/button.js";
+import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger } from "../../../ui/dropdown-menu.js";
+import { Tooltip, TooltipContent, TooltipTrigger } from "../../../ui/tooltip.js";
+import { cn } from "../../../../lib/utils.js";
+import { FILTER_VARIANTS } from "../lib/constants.js";
+import { useDataTable } from "../core/data-table-context.js";
+import { SORT_ICONS, SORT_LABELS } from "../config/data-table.js";
+import React from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { Check, CircleHelp } from "lucide-react";
+//#region src/components/registry/niko-table/filters/table-column-sort.tsx
+/**
+* niko-table — created by Semir N. (Semkoo, https://github.com/Semkoo) with AI assistance.
+*
+* Before reporting anything: please check the changelog first.
+*  - In-repo: ./CHANGELOG.md
+*  - Docs site: https://niko-table.com/changelog
+*
+* Found a bug or have a fix? Open an issue or PR on GitHub so other
+* users (and future LLMs reading this code) benefit:
+* https://github.com/Semkoo/niko-table-registry
+*/
+/**
+* Sort options menu items for composition inside TableColumnActions.
+*
+* @example
+* ```tsx
+* <TableColumnActions>
+*   <TableColumnSortOptions column={column} />
+* </TableColumnActions>
+* ```
+*/
+function TableColumnSortOptions({ column, table: propTable, variant: propVariant, withSeparator = true }) {
+	const context = useDataTable();
+	const table = propTable || context.table;
+	const sortState = column.getIsSorted();
+	const variant = propVariant || column.columnDef.meta?.variant || FILTER_VARIANTS.TEXT;
+	const icons = SORT_ICONS[variant] || SORT_ICONS[FILTER_VARIANTS.TEXT];
+	const labels = SORT_LABELS[variant] || SORT_LABELS[FILTER_VARIANTS.TEXT];
+	const sortIndex = column.getSortIndex();
+	const showSortBadge = table && table.state.sorting.length > 1 && sortIndex !== -1;
+	/**
+	* Use a ref for immediate synchronous access to shift key state.
+	* React state updates are batched and async, which can cause race conditions
+	* when the dropdown closes - the keyup event might reset state before
+	* handleSort reads it. A ref provides synchronous access.
+	*/
+	const isShiftPressedRef = React.useRef(false);
+	const [isShiftPressed, setIsShiftPressed] = React.useState(false);
+	React.useEffect(() => {
+		const handleKey = (e) => {
+			if (e.key === "Shift") {
+				const isDown = e.type === "keydown";
+				isShiftPressedRef.current = isDown;
+				setIsShiftPressed(isDown);
+			}
+		};
+		window.addEventListener("keydown", handleKey, { capture: true });
+		window.addEventListener("keyup", handleKey, { capture: true });
+		return () => {
+			window.removeEventListener("keydown", handleKey, { capture: true });
+			window.removeEventListener("keyup", handleKey, { capture: true });
+		};
+	}, []);
+	const handleSort = (direction, e) => {
+		const isMulti = isShiftPressedRef.current || isShiftPressed || e.shiftKey;
+		if (direction === false) column.clearSorting();
+		else {
+			const isDesc = direction === "desc";
+			const canMultiSort = column.getCanMultiSort();
+			/**
+			* @see https://tanstack.com/table/v8/docs/guide/sorting#multi-sorting
+			* When using toggleSorting explicitly, we must manually pass the multi-sort flag.
+			*/
+			column.toggleSorting(isDesc, canMultiSort ? isMulti : false);
+		}
+	};
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		withSeparator && /* @__PURE__ */ jsx(DropdownMenuSeparator, {}),
+		/* @__PURE__ */ jsxs(DropdownMenuLabel, {
+			className: "flex items-center justify-between text-xs font-normal text-muted-foreground",
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ jsx("span", { children: "Column Sort" }), showSortBadge && /* @__PURE__ */ jsxs(Tooltip, { children: [/* @__PURE__ */ jsx(TooltipTrigger, {
+					render: /* @__PURE__ */ jsx("span", { className: "flex size-4 cursor-help items-center justify-center rounded-full bg-primary text-[10px] font-medium text-primary-foreground" }),
+					children: sortIndex + 1
+				}), /* @__PURE__ */ jsx(TooltipContent, {
+					side: "right",
+					children: "Sort priority (order in which columns are sorted)"
+				})] })]
+			}), /* @__PURE__ */ jsxs(Tooltip, { children: [/* @__PURE__ */ jsx(TooltipTrigger, { render: /* @__PURE__ */ jsx(CircleHelp, { className: "size-3.5 cursor-help" }) }), /* @__PURE__ */ jsx(TooltipContent, {
+				side: "right",
+				children: "TIP: Hold 'shift' key to enable multi sort"
+			})] })]
+		}),
+		/* @__PURE__ */ jsxs(DropdownMenuItem, {
+			onClick: (e) => handleSort("asc", e),
+			className: cn("flex items-center", sortState === "asc" && "bg-accent text-accent-foreground"),
+			children: [
+				/* @__PURE__ */ jsx(icons.asc, { className: "mr-2 size-4 text-muted-foreground/70" }),
+				/* @__PURE__ */ jsx("span", {
+					className: "flex-1",
+					children: labels.asc
+				}),
+				sortState === "asc" && /* @__PURE__ */ jsx(Check, { className: "ml-2 size-4" })
+			]
+		}),
+		/* @__PURE__ */ jsxs(DropdownMenuItem, {
+			onClick: (e) => handleSort("desc", e),
+			className: cn("flex items-center", sortState === "desc" && "bg-accent text-accent-foreground"),
+			children: [
+				/* @__PURE__ */ jsx(icons.desc, { className: "mr-2 size-4 text-muted-foreground/70" }),
+				/* @__PURE__ */ jsx("span", {
+					className: "flex-1",
+					children: labels.desc
+				}),
+				sortState === "desc" && /* @__PURE__ */ jsx(Check, { className: "ml-2 size-4" })
+			]
+		}),
+		sortState && /* @__PURE__ */ jsxs(DropdownMenuItem, {
+			onClick: () => column.clearSorting(),
+			children: [/* @__PURE__ */ jsx(icons.unsorted, { className: "mr-2 size-4 text-muted-foreground/70" }), "Clear Sort"]
+		})
+	] });
+}
+/**
+* Standalone dropdown menu for sorting.
+*
+* For composition inside TableColumnActions, use TableColumnSortOptions instead.
+*
+* @example
+* ```tsx
+* // Standalone
+* <TableColumnSortMenu column={column} table={table} />
+*
+* // Composed
+* <TableColumnActions>
+*   <TableColumnSortOptions column={column} />
+* </TableColumnActions>
+* ```
+*/
+function TableColumnSortMenu({ column, table: propTable, variant: propVariant, className }) {
+	const context = useDataTable();
+	const table = propTable || context.table;
+	const canSort = column.getCanSort();
+	const sortState = column.getIsSorted();
+	const variant = propVariant || column.columnDef.meta?.variant || FILTER_VARIANTS.TEXT;
+	const icons = SORT_ICONS[variant] || SORT_ICONS[FILTER_VARIANTS.TEXT];
+	if (!canSort) return null;
+	const SortIcon = sortState === "asc" ? icons.asc : sortState === "desc" ? icons.desc : icons.unsorted;
+	const sortIndex = column.getSortIndex();
+	const showSortBadge = table && table.state.sorting.length > 1 && sortIndex !== -1;
+	return /* @__PURE__ */ jsxs(DropdownMenu, { children: [/* @__PURE__ */ jsxs(DropdownMenuTrigger, {
+		render: /* @__PURE__ */ jsx(Button, {
+			variant: "ghost",
+			size: "icon",
+			className: cn("size-7 transition-opacity dark:text-muted-foreground", sortState && "text-primary", className)
+		}),
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "relative flex items-center justify-center",
+			children: [/* @__PURE__ */ jsx(SortIcon, { className: "size-4" }), showSortBadge && /* @__PURE__ */ jsx("span", {
+				className: "absolute -top-1 -right-2 flex size-3 items-center justify-center rounded-full bg-primary text-[9px] text-primary-foreground",
+				children: sortIndex + 1
+			})]
+		}), /* @__PURE__ */ jsx("span", {
+			className: "sr-only",
+			children: "Sort column"
+		})]
+	}), /* @__PURE__ */ jsx(DropdownMenuContent, {
+		align: "end",
+		className: "w-48",
+		children: /* @__PURE__ */ jsx(TableColumnSortOptions, {
+			column,
+			table,
+			variant,
+			withSeparator: false
+		})
+	})] });
+}
+TableColumnSortOptions.displayName = "TableColumnSortOptions";
+TableColumnSortMenu.displayName = "TableColumnSortMenu";
+//#endregion
+export { TableColumnSortMenu, TableColumnSortOptions };

package/dist/components/registry/niko-table/filters/table-column-title.d.ts

@@ -0,0 +1,17 @@
+import { DataTableColumn } from "../types/index.js";
+import React from "react";
+import { RowData } from "@tanstack/react-table";
+//#region src/components/registry/niko-table/filters/table-column-title.d.ts
+/**
+ * Renders the column title.
+ */
+export declare function TableColumnTitle<TData extends RowData, TValue>({ column, title, className, children }: {
+  column: DataTableColumn<TData, TValue>;
+  title?: string;
+  className?: string;
+  children?: React.ReactNode;
+}): React.JSX.Element;
+export declare namespace TableColumnTitle {
+  var displayName: string;
+}
+//#endregion

package/dist/components/registry/niko-table/filters/table-column-title.js

@@ -0,0 +1,20 @@
+"use client";
+import { cn } from "../../../../lib/utils.js";
+import { useDerivedColumnTitle } from "../hooks/use-derived-column-title.js";
+import "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/components/registry/niko-table/filters/table-column-title.tsx
+/**
+* Renders the column title.
+*/
+function TableColumnTitle({ column, title, className, children }) {
+	const derivedTitle = useDerivedColumnTitle(column, column.id, title);
+	return /* @__PURE__ */ jsx("div", {
+		"data-slot": "column-title",
+		className: cn("min-w-0 truncate py-0.5 text-sm font-semibold transition-colors", className),
+		children: children ?? derivedTitle
+	});
+}
+TableColumnTitle.displayName = "TableColumnTitle";
+//#endregion
+export { TableColumnTitle };

package/dist/components/registry/niko-table/filters/table-faceted-filter.d.ts

@@ -0,0 +1,40 @@
+import { DataTableColumn, Option } from "../types/index.js";
+import * as React$1 from "react";
+import { RowData } from "@tanstack/react-table";
+//#region src/components/registry/niko-table/filters/table-faceted-filter.d.ts
+export interface TableFacetedFilterProps<TData extends RowData, TValue> {
+  column?: DataTableColumn<TData, TValue>;
+  title?: string;
+  options: Option[];
+  multiple?: boolean;
+  /**
+   * Callback fired when filter value changes
+   * Useful for server-side filtering or external state management
+   */
+  onValueChange?: (value: string[] | undefined) => void;
+  /**
+   * Optional custom trigger element
+   */
+  trigger?: React$1.ReactElement;
+}
+export declare function useTableFacetedFilter<TData extends RowData, TValue = unknown>({ column, onValueChange, multiple }: {
+  column?: DataTableColumn<TData, TValue>;
+  onValueChange?: (value: string[] | undefined) => void;
+  multiple?: boolean;
+}): {
+  selectedValues: Set<any>;
+  onItemSelect: (option: Option, isSelected: boolean) => void;
+  onReset: (event?: React$1.MouseEvent) => void;
+};
+export declare function TableFacetedFilter<TData extends RowData, TValue>({ column, title, options, multiple, onValueChange, trigger }: TableFacetedFilterProps<TData, TValue>): React$1.JSX.Element;
+export declare namespace TableFacetedFilter {
+  var displayName: string;
+}
+export declare function TableFacetedFilterContent({ title, options, selectedValues, onItemSelect, onReset }: {
+  title?: string;
+  options: Option[];
+  selectedValues: Set<string>;
+  onItemSelect: (option: Option, isSelected: boolean) => void;
+  onReset: (event?: React$1.MouseEvent) => void;
+}): React$1.JSX.Element;
+//#endregion

package/dist/components/registry/niko-table/filters/table-faceted-filter.js

@@ -0,0 +1,210 @@
+"use client";
+import { Badge } from "../../../ui/badge.js";
+import { Button } from "../../../ui/button.js";
+import { Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator } from "../../../ui/command.js";
+import { Popover, PopoverContent, PopoverTrigger } from "../../../ui/popover.js";
+import { Separator } from "../../../ui/separator.js";
+import { cn } from "../../../../lib/utils.js";
+import { FILTER_OPERATORS, FILTER_VARIANTS, JOIN_OPERATORS } from "../lib/constants.js";
+import * as React$1 from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { Check, PlusCircle, XCircle } from "lucide-react";
+//#region src/components/registry/niko-table/filters/table-faceted-filter.tsx
+/**
+* niko-table — created by Semir N. (Semkoo, https://github.com/Semkoo) with AI assistance.
+*
+* Before reporting anything: please check the changelog first.
+*  - In-repo: ./CHANGELOG.md
+*  - Docs site: https://niko-table.com/changelog
+*
+* Found a bug or have a fix? Open an issue or PR on GitHub so other
+* users (and future LLMs reading this code) benefit:
+* https://github.com/Semkoo/niko-table-registry
+*/
+/**
+* Table faceted filter component
+* @description A faceted filter component for DataTable that allows users to filter data based on multiple selectable options. It supports both single and multiple selection modes.
+*/
+function useTableFacetedFilter({ column, onValueChange, multiple }) {
+	const columnFilterValue = column?.getFilterValue();
+	const selectedValues = React$1.useMemo(() => {
+		if (columnFilterValue && typeof columnFilterValue === "object" && !Array.isArray(columnFilterValue) && "value" in columnFilterValue) {
+			const filterValue = columnFilterValue.value;
+			return new Set(Array.isArray(filterValue) ? filterValue : [String(filterValue)]);
+		}
+		return new Set(Array.isArray(columnFilterValue) ? columnFilterValue : []);
+	}, [columnFilterValue]);
+	return {
+		selectedValues,
+		onItemSelect: React$1.useCallback((option, isSelected) => {
+			if (!column) return;
+			if (multiple) {
+				const newSelectedValues = new Set(selectedValues);
+				if (isSelected) newSelectedValues.delete(option.value);
+				else newSelectedValues.add(option.value);
+				const filterValues = Array.from(newSelectedValues);
+				if (filterValues.length === 0) {
+					column.setFilterValue(void 0);
+					onValueChange?.(void 0);
+				} else {
+					const extendedFilter = {
+						id: column.id,
+						value: filterValues,
+						variant: FILTER_VARIANTS.MULTI_SELECT,
+						operator: FILTER_OPERATORS.IN,
+						filterId: `faceted-${column.id}`,
+						joinOperator: JOIN_OPERATORS.AND
+					};
+					column.setFilterValue(extendedFilter);
+					onValueChange?.(filterValues);
+				}
+			} else if (isSelected) {
+				column.setFilterValue(void 0);
+				onValueChange?.(void 0);
+			} else {
+				const extendedFilter = {
+					id: column.id,
+					value: option.value,
+					variant: FILTER_VARIANTS.SELECT,
+					operator: FILTER_OPERATORS.EQ,
+					filterId: `faceted-${column.id}`,
+					joinOperator: JOIN_OPERATORS.AND
+				};
+				column.setFilterValue(extendedFilter);
+				onValueChange?.([option.value]);
+			}
+		}, [
+			column,
+			multiple,
+			selectedValues,
+			onValueChange
+		]),
+		onReset: React$1.useCallback((event) => {
+			event?.stopPropagation();
+			column?.setFilterValue(void 0);
+			onValueChange?.(void 0);
+		}, [column, onValueChange])
+	};
+}
+function TableFacetedFilter({ column, title, options = [], multiple, onValueChange, trigger }) {
+	const [open, setOpen] = React$1.useState(false);
+	const { selectedValues, onItemSelect, onReset } = useTableFacetedFilter({
+		column,
+		onValueChange,
+		multiple
+	});
+	const handleItemSelect = React$1.useCallback((option, isSelected) => {
+		onItemSelect(option, isSelected);
+		if (!multiple) setOpen(false);
+	}, [
+		onItemSelect,
+		multiple,
+		setOpen
+	]);
+	return /* @__PURE__ */ jsxs(Popover, {
+		open,
+		onOpenChange: setOpen,
+		children: [/* @__PURE__ */ jsx(PopoverTrigger, { render: trigger || /* @__PURE__ */ jsxs(Button, {
+			variant: "outline",
+			size: "sm",
+			className: "h-8 border-dashed",
+			children: [
+				selectedValues?.size > 0 ? /* @__PURE__ */ jsx("div", {
+					role: "button",
+					"aria-label": `Clear ${title} filter`,
+					tabIndex: 0,
+					onClick: onReset,
+					onKeyDown: (e) => {
+						if (e.key === "Enter" || e.key === " ") {
+							e.preventDefault();
+							onReset(e);
+						}
+					},
+					className: "rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:ring-1 focus-visible:ring-ring focus-visible:outline-none",
+					children: /* @__PURE__ */ jsx(XCircle, { className: "size-4" })
+				}) : /* @__PURE__ */ jsx(PlusCircle, { className: "size-4" }),
+				title,
+				selectedValues?.size > 0 && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+					/* @__PURE__ */ jsx(Separator, {
+						orientation: "vertical",
+						className: "mx-2 h-4"
+					}),
+					/* @__PURE__ */ jsx(Badge, {
+						variant: "secondary",
+						className: "rounded-sm px-1 font-normal lg:hidden",
+						children: selectedValues.size
+					}),
+					/* @__PURE__ */ jsx("div", {
+						className: "hidden items-center gap-1 lg:flex",
+						children: selectedValues.size > 2 ? /* @__PURE__ */ jsxs(Badge, {
+							variant: "secondary",
+							className: "rounded-sm px-1 font-normal",
+							children: [selectedValues.size, " selected"]
+						}) : options.filter((option) => selectedValues.has(option.value)).map((option) => /* @__PURE__ */ jsx(Badge, {
+							variant: "secondary",
+							className: "rounded-sm px-1 font-normal",
+							children: option.label
+						}, option.value))
+					})
+				] })
+			]
+		}) }), /* @__PURE__ */ jsx(PopoverContent, {
+			className: "w-52 p-0",
+			align: "start",
+			children: /* @__PURE__ */ jsx(TableFacetedFilterContent, {
+				title,
+				options,
+				selectedValues,
+				onItemSelect: handleItemSelect,
+				onReset
+			})
+		})]
+	});
+}
+function TableFacetedFilterContent({ title, options, selectedValues, onItemSelect, onReset }) {
+	return /* @__PURE__ */ jsxs(Command, { children: [/* @__PURE__ */ jsx(CommandInput, {
+		placeholder: title,
+		className: "pl-2"
+	}), /* @__PURE__ */ jsxs(CommandList, {
+		className: "max-h-full",
+		children: [
+			/* @__PURE__ */ jsx(CommandEmpty, { children: "No results found." }),
+			/* @__PURE__ */ jsx(CommandGroup, {
+				className: "max-h-75 overflow-x-hidden overflow-y-auto",
+				children: options.map((option) => {
+					const isSelected = selectedValues.has(option.value);
+					return /* @__PURE__ */ jsxs(CommandItem, {
+						onSelect: () => onItemSelect(option, isSelected),
+						children: [
+							/* @__PURE__ */ jsx("div", {
+								className: cn("mr-2 flex size-4 items-center justify-center rounded-sm border border-primary", isSelected ? "bg-primary text-primary-foreground" : "opacity-50 [&_svg]:invisible"),
+								children: /* @__PURE__ */ jsx(Check, { className: "size-4" })
+							}),
+							option.icon && /* @__PURE__ */ jsx(option.icon, { className: "mr-2 size-4" }),
+							/* @__PURE__ */ jsx("span", {
+								className: "truncate",
+								children: option.label
+							}),
+							option.count !== void 0 && /* @__PURE__ */ jsx("span", {
+								className: "ml-auto font-mono text-xs",
+								children: option.count
+							})
+						]
+					}, option.value);
+				})
+			}),
+			selectedValues.size > 0 && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(CommandSeparator, {}), /* @__PURE__ */ jsx(CommandGroup, { children: /* @__PURE__ */ jsx(CommandItem, {
+				onSelect: () => onReset(),
+				className: "justify-center text-center",
+				children: "Clear filters"
+			}) })] })
+		]
+	})] });
+}
+/**
+* @required displayName is required for auto feature detection
+* @see "feature-detection.ts"
+*/
+TableFacetedFilter.displayName = "TableFacetedFilter";
+//#endregion
+export { TableFacetedFilter, TableFacetedFilterContent, useTableFacetedFilter };

package/dist/components/registry/niko-table/hooks/use-derived-column-title.d.ts

@@ -0,0 +1,29 @@
+import { DataTableColumn } from "../types/index.js";
+import { RowData } from "@tanstack/react-table";
+//#region src/components/registry/niko-table/hooks/use-derived-column-title.d.ts
+/**
+ * A hook that derives the title for a column filter component.
+ * It follows this priority order:
+ * 1. Provided title prop
+ * 2. Column metadata label (column.columnDef.meta?.label)
+ * 3. Formatted accessor key
+ *
+ * @param column - The table column
+ * @param accessorKey - The accessor key of the column
+ * @param title - Optional title override
+ * @returns The derived title string
+ *
+ * @example
+ * const derivedTitle = useDerivedColumnTitle(column, "firstName", "First Name")
+ * Returns "First Name"
+ *
+ * @example - With column.meta.label = "First Name"
+ * const derivedTitle = useDerivedColumnTitle(column, "firstName")
+ *   Returns "First Name" from metadata
+ *
+ * @example - Without title or metadata
+ * const derivedTitle = useDerivedColumnTitle(column, "first_name")
+ * Returns "First Name" (formatted from accessorKey)
+ */
+export declare function useDerivedColumnTitle<TData extends RowData, TValue = unknown>(column: DataTableColumn<TData, TValue> | undefined, accessorKey: string, title?: string): string;
+//#endregion

package/dist/components/registry/niko-table/hooks/use-derived-column-title.js

@@ -0,0 +1,40 @@
+import { formatLabel } from "../lib/format.js";
+import * as React$1 from "react";
+//#region src/components/registry/niko-table/hooks/use-derived-column-title.ts
+/**
+* A hook that derives the title for a column filter component.
+* It follows this priority order:
+* 1. Provided title prop
+* 2. Column metadata label (column.columnDef.meta?.label)
+* 3. Formatted accessor key
+*
+* @param column - The table column
+* @param accessorKey - The accessor key of the column
+* @param title - Optional title override
+* @returns The derived title string
+*
+* @example
+* const derivedTitle = useDerivedColumnTitle(column, "firstName", "First Name")
+* Returns "First Name"
+*
+* @example - With column.meta.label = "First Name"
+* const derivedTitle = useDerivedColumnTitle(column, "firstName")
+*   Returns "First Name" from metadata
+*
+* @example - Without title or metadata
+* const derivedTitle = useDerivedColumnTitle(column, "first_name")
+* Returns "First Name" (formatted from accessorKey)
+*/
+function useDerivedColumnTitle(column, accessorKey, title) {
+	return React$1.useMemo(() => {
+		if (title) return title;
+		if (!column) return formatLabel(accessorKey);
+		return column.columnDef.meta?.label ?? formatLabel(accessorKey);
+	}, [
+		title,
+		column,
+		accessorKey
+	]);
+}
+//#endregion
+export { useDerivedColumnTitle };

package/dist/components/registry/niko-table/hooks/use-generated-options.d.ts

@@ -0,0 +1,49 @@
+import { DataTableInstance, Option } from "../types/index.js";
+import { RowData } from "@tanstack/react-table";
+//#region src/components/registry/niko-table/hooks/use-generated-options.d.ts
+export interface GenerateOptionsConfig {
+  /**
+   * Whether to include counts for each option label
+   * @default true
+   */
+  showCounts?: boolean;
+  /**
+   * If true, recompute counts based on the filtered rows; otherwise use all core rows
+   * @default true
+   */
+  dynamicCounts?: boolean;
+  /**
+   * If true, only generate options from filtered rows. If false, generate from all rows.
+   * This controls which rows are used to generate the option list itself.
+   * Note: This is separate from dynamicCounts which controls count calculation.
+   * @default true
+   */
+  limitToFilteredRows?: boolean;
+  /**
+   * Only generate options for these column ids (if provided)
+   */
+  includeColumns?: string[];
+  /**
+   * Exclude these column ids from option generation
+   */
+  excludeColumns?: string[];
+  /**
+   * Optional cap on number of options per column (after sorting)
+   */
+  limitPerColumn?: number;
+  /**
+   * Default merge strategy when a column does not provide meta.mergeStrategy.
+   * Column-level mergeStrategy still takes precedence.
+   */
+  mergeStrategy?: "preserve" | "augment" | "replace";
+}
+/**
+ * Generate a map of options for select/multiSelect columns based on table data.
+ * Uses either filtered rows (dynamicCounts) or all core rows.
+ */
+export declare function useGeneratedOptions<TData extends RowData>(table: DataTableInstance<TData>, config?: GenerateOptionsConfig): Record<string, Option[]>;
+/**
+ * Convenience: generate options only for a specific column id
+ */
+export declare function useGeneratedOptionsForColumn<TData extends RowData>(table: DataTableInstance<TData>, columnId: string, config?: GenerateOptionsConfig): Option[];
+//#endregion