@adapttable/unstyled 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,319 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { BaseDataTableProps, TableSource, UseTableDataOptions, UrlStateAdapter, UseSavedViewsOptions, FilterDef, TableLabels, Direction } from '@adapttable/core';
+export { ActionConfirm, ActiveFilterChip, BulkAction, CellProps, ColorScheme, ColumnDef, ColumnFilter, ConfirmHandler, ConfirmRequest, Direction, ExtraFilters, FILTER_TYPES, FilterDef, FilterOption, FilterType, FilterValue, InfiniteQueryLike, PageSelector, PaginatedResponse, PaginationMode, RowAction, SavedView, SortByOption, SortDirection, SortableValue, TableLabels, TableQuery, TableSource, UrlStateAdapter, UseBackendDataOptions, UseDataTableResult, UseFrontendDataOptions, UseSavedViewsOptions, UseSavedViewsResult, UseServerDataOptions, UseTableDataOptions, UseTableDataResult, UseTableUrlStateOptions, UseTableUrlStateResult, createHistoryAdapter, createMemoryAdapter, defaultConfirm, defaultLabels, deriveSortByOptions, filterLabel, filterStateKeys, getHistoryAdapter, useBackendData, useDataTable, useFrontendData, useSavedViews, useServerData, useTableData, useTableUrlState } from '@adapttable/core';
+
+/**
+ * Per-part class-name hooks. Every node also carries a stable
+ * `data-adapttable-part` attribute and `data-*` state attributes so you
+ * can style with Tailwind, shadcn, or your own CSS.
+ */
+interface DataTableClassNames {
+    root?: string;
+    toolbar?: string;
+    search?: string;
+    /** The search field wrapper (holds the search input + leading icon). */
+    searchField?: string;
+    /** The leading magnifying-glass icon inside the search field. */
+    searchIcon?: string;
+    sortSelect?: string;
+    /** Rows-per-page `<select>` (toolbar in infinite mode, footer when paged). */
+    rowsPerPageSelect?: string;
+    filtersButton?: string;
+    /** The leading funnel icon inside the Filters button. */
+    filtersIcon?: string;
+    filtersCount?: string;
+    filtersAnchor?: string;
+    filtersBackdrop?: string;
+    filtersPopover?: string;
+    filtersPanel?: string;
+    filtersHeader?: string;
+    filtersTitle?: string;
+    filtersClose?: string;
+    filtersBody?: string;
+    filtersFooter?: string;
+    filtersClear?: string;
+    filtersDone?: string;
+    /** One auto-built filter field (the `<label>`/`<fieldset>` wrapper). */
+    filterField?: string;
+    /** The field's caption (the `<span>`/`<legend>` holding the label text). */
+    filterLabel?: string;
+    /** Text / date / number inputs inside an auto-built field. */
+    filterInput?: string;
+    /** The `<select>` of an auto-built `select` field. */
+    filterSelect?: string;
+    /** The operator `<select>` of an auto-built range field. */
+    filterOperator?: string;
+    /** The checkbox-list container of an auto-built `multiSelect` field. */
+    filterCheckboxGroup?: string;
+    /** One checkbox option (`<label>` + checkbox) in a `multiSelect` field. */
+    filterCheckbox?: string;
+    /** The placeholder shown while a field's async options load. */
+    filterOptionsLoading?: string;
+    chips?: string;
+    chip?: string;
+    chipRemove?: string;
+    columnMenu?: string;
+    columnMenuButton?: string;
+    columnMenuPanel?: string;
+    columnMenuHeader?: string;
+    columnMenuTitle?: string;
+    columnMenuItem?: string;
+    columnMenuGrip?: string;
+    columnMenuLabel?: string;
+    columnMenuVisibility?: string;
+    columnMenuPin?: string;
+    /** The separator above the trailing row-actions entry in the menu. */
+    columnMenuSeparator?: string;
+    columnMenuReset?: string;
+    /** The saved-views menu trigger button. */
+    viewsButton?: string;
+    /** The saved-views dropdown panel. */
+    viewsPanel?: string;
+    /** One saved view's apply button in the list. */
+    viewsItem?: string;
+    /** A saved view's delete button. */
+    viewsDelete?: string;
+    /** The view-name input in the save row. */
+    viewsInput?: string;
+    /** The save-view button in the save row. */
+    viewsSave?: string;
+    resizeHandle?: string;
+    bulkBar?: string;
+    bulkButton?: string;
+    /** The cross-page banner inside the bulk bar (full page selected). */
+    selectAllBanner?: string;
+    /** The banner's status text (page selected / all matching selected). */
+    selectAllText?: string;
+    /** The banner's action button (select all matching / clear all). */
+    selectAllButton?: string;
+    table?: string;
+    thead?: string;
+    headerRow?: string;
+    headerCell?: string;
+    /** The grouped-header `<tr>` rendered above the column headers. */
+    groupRow?: string;
+    /** One spanning `<th>` (or edge gap) inside the group row. */
+    groupCell?: string;
+    sortButton?: string;
+    /** The 1-based multi-sort position badge inside a sorted header. */
+    sortIndex?: string;
+    tbody?: string;
+    row?: string;
+    cell?: string;
+    /** The leading expand-chevron header cell (row expansion). */
+    expandHeader?: string;
+    /** The leading expand-chevron body cell on each row. */
+    expandCell?: string;
+    /** The expand/collapse chevron button (desktop rows and mobile cards). */
+    expandButton?: string;
+    /** The full-width detail `<tr>` rendered under an expanded row. */
+    detailRow?: string;
+    /** The single spanning `<td>` inside the detail row. */
+    detailCell?: string;
+    /** The detail section inside an expanded mobile card. */
+    cardDetail?: string;
+    actionsCell?: string;
+    actionButton?: string;
+    selectionCell?: string;
+    checkbox?: string;
+    loadMore?: string;
+    loadMoreButton?: string;
+    cards?: string;
+    card?: string;
+    cardRow?: string;
+    cardLabel?: string;
+    cardValue?: string;
+    /** The `<tfoot>` holding the summary row. */
+    summary?: string;
+    /** The summary `<tr>` inside the footer. */
+    summaryRow?: string;
+    /** One summary `<td>` (aligned under its column, or an edge pad). */
+    summaryCell?: string;
+    /** The trailing summary `<li>` in the mobile card list. */
+    summaryCard?: string;
+    footer?: string;
+    pageButton?: string;
+    empty?: string;
+    /** The clear-filters button inside the "no results" empty state. */
+    emptyClear?: string;
+    loading?: string;
+    /** The non-blocking background-refresh progress indicator. */
+    refreshIndicator?: string;
+    error?: string;
+    retryButton?: string;
+}
+/**
+ * Overridable sub-components — a cross-adapter alias for the top-level
+ * `emptyState` / `loadingState` props. When both are supplied the `slots`
+ * entry wins (`slots.empty ?? emptyState`, `slots.skeleton ?? loadingState`).
+ */
+interface DataTableSlots {
+    /** Replace the empty-state (alias for `emptyState`). */
+    empty?: ReactNode;
+    /** Replace the loading skeleton (alias for `loadingState`). */
+    skeleton?: ReactNode;
+}
+/** Props for the unstyled `<DataTable>`. */
+interface DataTableProps<TRow> extends Omit<BaseDataTableProps<TRow>, "source"> {
+    /**
+     * Full-control tier: a prebuilt source (`useFrontendData`,
+     * `useBackendData`, …), used as-is. Omit it and pass `data` instead for
+     * the managed tiers.
+     */
+    source?: TableSource<TRow>;
+    /**
+     * The rows. Alone: frontend tier — the table filters/sorts/pages them.
+     * With `onQueryChange`: server tier — the current page, as returned.
+     */
+    data?: readonly TRow[];
+    /** Server tier: total row count across all pages (drives the pager). */
+    total?: number;
+    /** Server tier: request in flight. */
+    loading?: boolean;
+    /**
+     * Server tier: fired with the consolidated query (page, search, sort,
+     * filters) whenever it changes — including once on mount with the
+     * URL-restored values. The caller fetches and hands back `data` + `total`.
+     */
+    onQueryChange?: UseTableDataOptions<TRow>["onQueryChange"];
+    /**
+     * URL-state adapter for the managed tiers (router integration, memory
+     * adapter for tests/SSR). Defaults to the browser History API.
+     */
+    urlAdapter?: UrlStateAdapter;
+    /**
+     * Sync table state (search, sort, page, filters) to the URL. `false`
+     * keeps everything in memory — the table works identically, the address
+     * bar never changes, and any `urlAdapter` is ignored.
+     *
+     * @default true
+     */
+    urlSync?: boolean;
+    /** Per-table URL namespace (e.g. `"left"` → `left.q`, `left.page`). */
+    urlKey?: string;
+    /**
+     * Mounts a saved-views menu in the toolbar (beside the Columns button).
+     * The table's own `urlAdapter` / `urlKey` fill in unless overridden here.
+     */
+    savedViews?: UseSavedViewsOptions;
+    /** Per-part class name overrides. */
+    classNames?: DataTableClassNames;
+    /** Empty-state node override. */
+    emptyState?: ReactNode;
+    /** Loading-state node override (replaces the skeleton on first load). */
+    loadingState?: ReactNode;
+    /**
+     * Cross-adapter alias for `emptyState` / `loadingState`. Takes precedence
+     * over the top-level props when both are provided.
+     */
+    slots?: DataTableSlots;
+}
+
+/** Props for {@link AutoFilterForm}. */
+interface AutoFilterFormProps<TRow> {
+    /** The resolved filter definitions, in render order. */
+    defs: readonly FilterDef<TRow>[];
+    /** The table source whose filter bag the controls read and write. */
+    source: TableSource<TRow>;
+    /** Per-part class name overrides (the `filter*` keys). */
+    classNames?: DataTableClassNames;
+    /**
+     * Label overrides for the range widgets (`operator`, `value`, `from`,
+     * `to`, and the `op*` operator names); English defaults merge in.
+     */
+    labels?: TableLabels;
+}
+/**
+ * The auto-built filter form for the declarative `filters` array: one
+ * semantic field per definition (`text` input, `select` with an "All"
+ * option, `multiSelect` checkbox list, operator-first `dateRange` /
+ * `numberRange` widgets), each carrying `data-adapttable-part` hooks and
+ * `classNames` overrides. Controls read `source.extra` and write through
+ * `source.setExtra` / `source.setExtras` — an empty value clears its key.
+ *
+ * @typeParam TRow - The row type.
+ */
+declare function AutoFilterForm<TRow>({ defs, source, classNames, labels, }: Readonly<AutoFilterFormProps<TRow>>): react.JSX.Element;
+
+/** Props for {@link FilterPanel}. */
+interface FilterPanelProps {
+    open: boolean;
+    onClose: () => void;
+    filters: ReactNode;
+    activeFilterCount: number;
+    onClearFilters?: () => void;
+    labels: Required<TableLabels>;
+    dir?: Direction;
+    classNames: DataTableClassNames;
+}
+/** Backdrop + side drawer for caller-provided filter widgets. */
+declare function FilterPanel({ open, onClose, filters, activeFilterCount, onClearFilters, labels, dir, classNames, }: Readonly<FilterPanelProps>): react.ReactPortal | null;
+
+/** Props for {@link FilterPopover}. */
+interface FilterPopoverProps {
+    open: boolean;
+    onClose: () => void;
+    filters: ReactNode;
+    activeFilterCount: number;
+    onClearFilters?: () => void;
+    labels: Required<TableLabels>;
+    dir?: Direction;
+    classNames: DataTableClassNames;
+    /** The Filters trigger button — the popover anchors beneath it. */
+    children: ReactNode;
+}
+/**
+ * Anchored filter card (the default filter container). Opens beneath the
+ * Filters button with NO backdrop — the background stays visible and
+ * interactive; clicking outside the popover/anchor or pressing Escape closes
+ * it. This is the plain-DOM mirror of the Mantine reference; pair with
+ * `filtersMode="drawer"` for the slide-in panel (`FilterPanel`) instead.
+ */
+declare function FilterPopover({ open, onClose, filters, activeFilterCount, onClearFilters, labels, dir, classNames, children, }: Readonly<FilterPopoverProps>): react.JSX.Element;
+
+interface IconProps {
+    size?: number;
+    className?: string;
+}
+/** Magnifying-glass search glyph (inline SVG, `currentColor`). */
+declare const SearchIcon: (p: Readonly<IconProps>) => react.JSX.Element;
+/** Funnel glyph for the Filters button (inline SVG, `currentColor`). */
+declare const FiltersIcon: (p: Readonly<IconProps>) => react.JSX.Element;
+
+/** The label strings the saved-views menu renders. */
+type SavedViewsLabels = Pick<Required<TableLabels>, "savedViews" | "saveView" | "viewName" | "deleteView">;
+interface SavedViewsMenuProps {
+    /** Wiring for core's `useSavedViews` — storage key, storage, adapter, urlKey. */
+    options: UseSavedViewsOptions;
+    labels: SavedViewsLabels;
+    classNames: DataTableClassNames;
+}
+/**
+ * Saved-views popover: a disclosure button + a panel listing the saved views
+ * (click applies one; each has a delete button) above a save row that
+ * captures the table's CURRENT state under a typed name. Built on core's
+ * `useSavedViews`; closes on outside-click or Escape. Ships no styles —
+ * target the `data-adapttable-part` hooks or the `views*` className slots.
+ */
+declare function SavedViewsMenu({ options, labels, classNames, }: Readonly<SavedViewsMenuProps>): react.JSX.Element;
+
+/**
+ * Join class-name parts, dropping falsy values. Tiny `clsx`-style helper
+ * so the unstyled adapter has no runtime dependencies.
+ *
+ * @param parts - Class names or falsy values.
+ * @returns The space-joined class string.
+ */
+declare function cx(...parts: (string | false | null | undefined)[]): string;
+
+/**
+ * Headless, unstyled AdaptTable for Tailwind / shadcn / custom CSS. Renders
+ * semantic HTML with `data-adapttable-part` hooks and `className` overrides;
+ * ships no styles of its own. Built on the `@adapttable/core` prop-getters.
+ *
+ * @typeParam TRow - The row type.
+ */
+declare function DataTable<TRow>(props: Readonly<DataTableProps<TRow>>): react.JSX.Element;
+
+export { AutoFilterForm, type AutoFilterFormProps, DataTable, type DataTableClassNames, type DataTableProps, type DataTableSlots, FilterPanel, type FilterPanelProps, FilterPopover, type FilterPopoverProps, FiltersIcon, type SavedViewsLabels, SavedViewsMenu, type SavedViewsMenuProps, SearchIcon, cx };

package/dist/index.d.ts

@@ -0,0 +1,319 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { BaseDataTableProps, TableSource, UseTableDataOptions, UrlStateAdapter, UseSavedViewsOptions, FilterDef, TableLabels, Direction } from '@adapttable/core';
+export { ActionConfirm, ActiveFilterChip, BulkAction, CellProps, ColorScheme, ColumnDef, ColumnFilter, ConfirmHandler, ConfirmRequest, Direction, ExtraFilters, FILTER_TYPES, FilterDef, FilterOption, FilterType, FilterValue, InfiniteQueryLike, PageSelector, PaginatedResponse, PaginationMode, RowAction, SavedView, SortByOption, SortDirection, SortableValue, TableLabels, TableQuery, TableSource, UrlStateAdapter, UseBackendDataOptions, UseDataTableResult, UseFrontendDataOptions, UseSavedViewsOptions, UseSavedViewsResult, UseServerDataOptions, UseTableDataOptions, UseTableDataResult, UseTableUrlStateOptions, UseTableUrlStateResult, createHistoryAdapter, createMemoryAdapter, defaultConfirm, defaultLabels, deriveSortByOptions, filterLabel, filterStateKeys, getHistoryAdapter, useBackendData, useDataTable, useFrontendData, useSavedViews, useServerData, useTableData, useTableUrlState } from '@adapttable/core';
+
+/**
+ * Per-part class-name hooks. Every node also carries a stable
+ * `data-adapttable-part` attribute and `data-*` state attributes so you
+ * can style with Tailwind, shadcn, or your own CSS.
+ */
+interface DataTableClassNames {
+    root?: string;
+    toolbar?: string;
+    search?: string;
+    /** The search field wrapper (holds the search input + leading icon). */
+    searchField?: string;
+    /** The leading magnifying-glass icon inside the search field. */
+    searchIcon?: string;
+    sortSelect?: string;
+    /** Rows-per-page `<select>` (toolbar in infinite mode, footer when paged). */
+    rowsPerPageSelect?: string;
+    filtersButton?: string;
+    /** The leading funnel icon inside the Filters button. */
+    filtersIcon?: string;
+    filtersCount?: string;
+    filtersAnchor?: string;
+    filtersBackdrop?: string;
+    filtersPopover?: string;
+    filtersPanel?: string;
+    filtersHeader?: string;
+    filtersTitle?: string;
+    filtersClose?: string;
+    filtersBody?: string;
+    filtersFooter?: string;
+    filtersClear?: string;
+    filtersDone?: string;
+    /** One auto-built filter field (the `<label>`/`<fieldset>` wrapper). */
+    filterField?: string;
+    /** The field's caption (the `<span>`/`<legend>` holding the label text). */
+    filterLabel?: string;
+    /** Text / date / number inputs inside an auto-built field. */
+    filterInput?: string;
+    /** The `<select>` of an auto-built `select` field. */
+    filterSelect?: string;
+    /** The operator `<select>` of an auto-built range field. */
+    filterOperator?: string;
+    /** The checkbox-list container of an auto-built `multiSelect` field. */
+    filterCheckboxGroup?: string;
+    /** One checkbox option (`<label>` + checkbox) in a `multiSelect` field. */
+    filterCheckbox?: string;
+    /** The placeholder shown while a field's async options load. */
+    filterOptionsLoading?: string;
+    chips?: string;
+    chip?: string;
+    chipRemove?: string;
+    columnMenu?: string;
+    columnMenuButton?: string;
+    columnMenuPanel?: string;
+    columnMenuHeader?: string;
+    columnMenuTitle?: string;
+    columnMenuItem?: string;
+    columnMenuGrip?: string;
+    columnMenuLabel?: string;
+    columnMenuVisibility?: string;
+    columnMenuPin?: string;
+    /** The separator above the trailing row-actions entry in the menu. */
+    columnMenuSeparator?: string;
+    columnMenuReset?: string;
+    /** The saved-views menu trigger button. */
+    viewsButton?: string;
+    /** The saved-views dropdown panel. */
+    viewsPanel?: string;
+    /** One saved view's apply button in the list. */
+    viewsItem?: string;
+    /** A saved view's delete button. */
+    viewsDelete?: string;
+    /** The view-name input in the save row. */
+    viewsInput?: string;
+    /** The save-view button in the save row. */
+    viewsSave?: string;
+    resizeHandle?: string;
+    bulkBar?: string;
+    bulkButton?: string;
+    /** The cross-page banner inside the bulk bar (full page selected). */
+    selectAllBanner?: string;
+    /** The banner's status text (page selected / all matching selected). */
+    selectAllText?: string;
+    /** The banner's action button (select all matching / clear all). */
+    selectAllButton?: string;
+    table?: string;
+    thead?: string;
+    headerRow?: string;
+    headerCell?: string;
+    /** The grouped-header `<tr>` rendered above the column headers. */
+    groupRow?: string;
+    /** One spanning `<th>` (or edge gap) inside the group row. */
+    groupCell?: string;
+    sortButton?: string;
+    /** The 1-based multi-sort position badge inside a sorted header. */
+    sortIndex?: string;
+    tbody?: string;
+    row?: string;
+    cell?: string;
+    /** The leading expand-chevron header cell (row expansion). */
+    expandHeader?: string;
+    /** The leading expand-chevron body cell on each row. */
+    expandCell?: string;
+    /** The expand/collapse chevron button (desktop rows and mobile cards). */
+    expandButton?: string;
+    /** The full-width detail `<tr>` rendered under an expanded row. */
+    detailRow?: string;
+    /** The single spanning `<td>` inside the detail row. */
+    detailCell?: string;
+    /** The detail section inside an expanded mobile card. */
+    cardDetail?: string;
+    actionsCell?: string;
+    actionButton?: string;
+    selectionCell?: string;
+    checkbox?: string;
+    loadMore?: string;
+    loadMoreButton?: string;
+    cards?: string;
+    card?: string;
+    cardRow?: string;
+    cardLabel?: string;
+    cardValue?: string;
+    /** The `<tfoot>` holding the summary row. */
+    summary?: string;
+    /** The summary `<tr>` inside the footer. */
+    summaryRow?: string;
+    /** One summary `<td>` (aligned under its column, or an edge pad). */
+    summaryCell?: string;
+    /** The trailing summary `<li>` in the mobile card list. */
+    summaryCard?: string;
+    footer?: string;
+    pageButton?: string;
+    empty?: string;
+    /** The clear-filters button inside the "no results" empty state. */
+    emptyClear?: string;
+    loading?: string;
+    /** The non-blocking background-refresh progress indicator. */
+    refreshIndicator?: string;
+    error?: string;
+    retryButton?: string;
+}
+/**
+ * Overridable sub-components — a cross-adapter alias for the top-level
+ * `emptyState` / `loadingState` props. When both are supplied the `slots`
+ * entry wins (`slots.empty ?? emptyState`, `slots.skeleton ?? loadingState`).
+ */
+interface DataTableSlots {
+    /** Replace the empty-state (alias for `emptyState`). */
+    empty?: ReactNode;
+    /** Replace the loading skeleton (alias for `loadingState`). */
+    skeleton?: ReactNode;
+}
+/** Props for the unstyled `<DataTable>`. */
+interface DataTableProps<TRow> extends Omit<BaseDataTableProps<TRow>, "source"> {
+    /**
+     * Full-control tier: a prebuilt source (`useFrontendData`,
+     * `useBackendData`, …), used as-is. Omit it and pass `data` instead for
+     * the managed tiers.
+     */
+    source?: TableSource<TRow>;
+    /**
+     * The rows. Alone: frontend tier — the table filters/sorts/pages them.
+     * With `onQueryChange`: server tier — the current page, as returned.
+     */
+    data?: readonly TRow[];
+    /** Server tier: total row count across all pages (drives the pager). */
+    total?: number;
+    /** Server tier: request in flight. */
+    loading?: boolean;
+    /**
+     * Server tier: fired with the consolidated query (page, search, sort,
+     * filters) whenever it changes — including once on mount with the
+     * URL-restored values. The caller fetches and hands back `data` + `total`.
+     */
+    onQueryChange?: UseTableDataOptions<TRow>["onQueryChange"];
+    /**
+     * URL-state adapter for the managed tiers (router integration, memory
+     * adapter for tests/SSR). Defaults to the browser History API.
+     */
+    urlAdapter?: UrlStateAdapter;
+    /**
+     * Sync table state (search, sort, page, filters) to the URL. `false`
+     * keeps everything in memory — the table works identically, the address
+     * bar never changes, and any `urlAdapter` is ignored.
+     *
+     * @default true
+     */
+    urlSync?: boolean;
+    /** Per-table URL namespace (e.g. `"left"` → `left.q`, `left.page`). */
+    urlKey?: string;
+    /**
+     * Mounts a saved-views menu in the toolbar (beside the Columns button).
+     * The table's own `urlAdapter` / `urlKey` fill in unless overridden here.
+     */
+    savedViews?: UseSavedViewsOptions;
+    /** Per-part class name overrides. */
+    classNames?: DataTableClassNames;
+    /** Empty-state node override. */
+    emptyState?: ReactNode;
+    /** Loading-state node override (replaces the skeleton on first load). */
+    loadingState?: ReactNode;
+    /**
+     * Cross-adapter alias for `emptyState` / `loadingState`. Takes precedence
+     * over the top-level props when both are provided.
+     */
+    slots?: DataTableSlots;
+}
+
+/** Props for {@link AutoFilterForm}. */
+interface AutoFilterFormProps<TRow> {
+    /** The resolved filter definitions, in render order. */
+    defs: readonly FilterDef<TRow>[];
+    /** The table source whose filter bag the controls read and write. */
+    source: TableSource<TRow>;
+    /** Per-part class name overrides (the `filter*` keys). */
+    classNames?: DataTableClassNames;
+    /**
+     * Label overrides for the range widgets (`operator`, `value`, `from`,
+     * `to`, and the `op*` operator names); English defaults merge in.
+     */
+    labels?: TableLabels;
+}
+/**
+ * The auto-built filter form for the declarative `filters` array: one
+ * semantic field per definition (`text` input, `select` with an "All"
+ * option, `multiSelect` checkbox list, operator-first `dateRange` /
+ * `numberRange` widgets), each carrying `data-adapttable-part` hooks and
+ * `classNames` overrides. Controls read `source.extra` and write through
+ * `source.setExtra` / `source.setExtras` — an empty value clears its key.
+ *
+ * @typeParam TRow - The row type.
+ */
+declare function AutoFilterForm<TRow>({ defs, source, classNames, labels, }: Readonly<AutoFilterFormProps<TRow>>): react.JSX.Element;
+
+/** Props for {@link FilterPanel}. */
+interface FilterPanelProps {
+    open: boolean;
+    onClose: () => void;
+    filters: ReactNode;
+    activeFilterCount: number;
+    onClearFilters?: () => void;
+    labels: Required<TableLabels>;
+    dir?: Direction;
+    classNames: DataTableClassNames;
+}
+/** Backdrop + side drawer for caller-provided filter widgets. */
+declare function FilterPanel({ open, onClose, filters, activeFilterCount, onClearFilters, labels, dir, classNames, }: Readonly<FilterPanelProps>): react.ReactPortal | null;
+
+/** Props for {@link FilterPopover}. */
+interface FilterPopoverProps {
+    open: boolean;
+    onClose: () => void;
+    filters: ReactNode;
+    activeFilterCount: number;
+    onClearFilters?: () => void;
+    labels: Required<TableLabels>;
+    dir?: Direction;
+    classNames: DataTableClassNames;
+    /** The Filters trigger button — the popover anchors beneath it. */
+    children: ReactNode;
+}
+/**
+ * Anchored filter card (the default filter container). Opens beneath the
+ * Filters button with NO backdrop — the background stays visible and
+ * interactive; clicking outside the popover/anchor or pressing Escape closes
+ * it. This is the plain-DOM mirror of the Mantine reference; pair with
+ * `filtersMode="drawer"` for the slide-in panel (`FilterPanel`) instead.
+ */
+declare function FilterPopover({ open, onClose, filters, activeFilterCount, onClearFilters, labels, dir, classNames, children, }: Readonly<FilterPopoverProps>): react.JSX.Element;
+
+interface IconProps {
+    size?: number;
+    className?: string;
+}
+/** Magnifying-glass search glyph (inline SVG, `currentColor`). */
+declare const SearchIcon: (p: Readonly<IconProps>) => react.JSX.Element;
+/** Funnel glyph for the Filters button (inline SVG, `currentColor`). */
+declare const FiltersIcon: (p: Readonly<IconProps>) => react.JSX.Element;
+
+/** The label strings the saved-views menu renders. */
+type SavedViewsLabels = Pick<Required<TableLabels>, "savedViews" | "saveView" | "viewName" | "deleteView">;
+interface SavedViewsMenuProps {
+    /** Wiring for core's `useSavedViews` — storage key, storage, adapter, urlKey. */
+    options: UseSavedViewsOptions;
+    labels: SavedViewsLabels;
+    classNames: DataTableClassNames;
+}
+/**
+ * Saved-views popover: a disclosure button + a panel listing the saved views
+ * (click applies one; each has a delete button) above a save row that
+ * captures the table's CURRENT state under a typed name. Built on core's
+ * `useSavedViews`; closes on outside-click or Escape. Ships no styles —
+ * target the `data-adapttable-part` hooks or the `views*` className slots.
+ */
+declare function SavedViewsMenu({ options, labels, classNames, }: Readonly<SavedViewsMenuProps>): react.JSX.Element;
+
+/**
+ * Join class-name parts, dropping falsy values. Tiny `clsx`-style helper
+ * so the unstyled adapter has no runtime dependencies.
+ *
+ * @param parts - Class names or falsy values.
+ * @returns The space-joined class string.
+ */
+declare function cx(...parts: (string | false | null | undefined)[]): string;
+
+/**
+ * Headless, unstyled AdaptTable for Tailwind / shadcn / custom CSS. Renders
+ * semantic HTML with `data-adapttable-part` hooks and `className` overrides;
+ * ships no styles of its own. Built on the `@adapttable/core` prop-getters.
+ *
+ * @typeParam TRow - The row type.
+ */
+declare function DataTable<TRow>(props: Readonly<DataTableProps<TRow>>): react.JSX.Element;
+
+export { AutoFilterForm, type AutoFilterFormProps, DataTable, type DataTableClassNames, type DataTableProps, type DataTableSlots, FilterPanel, type FilterPanelProps, FilterPopover, type FilterPopoverProps, FiltersIcon, type SavedViewsLabels, SavedViewsMenu, type SavedViewsMenuProps, SearchIcon, cx };