@upbound/monarch-blocks 0.4.1 → 0.5.0

package/dist/data-table.d.ts

@@ -77,9 +77,8 @@ type DataTableValueCellProps = {
 /**
  * A generic cell renderer: a link (when `href` is set), a dashed-underline
  * value with a hover tooltip (when `title` is set), or plain content — with
- * an em-dash placeholder when `content` is empty. Legacy injected its router
- * `Link` via a DI hook (`useLink()`); Monarch has no such layer, so the link
- * branch renders a plain `<a>`.
+ * an em-dash placeholder when `content` is empty. Consumers who need router
+ * navigation wrap their own router link with `Link asChild` at the call site.
  */
 declare function DataTableValueCell({ content, title, className, href, onClick }: DataTableValueCellProps): React$1.JSX.Element;
 /** A timestamp cell — relative time in the cell, absolute time on hover (via Monarch's `RelativeTime`); an em-dash when absent. */
@@ -385,6 +384,16 @@ interface TableHookOptions<TData extends RowData> extends Omit<TableOptions<TDat
     enablePagination?: boolean;
     rowCountRelation?: RowCountRelation;
 }
+/**
+ * Configures the "Filter" toolbar toggle that shows/hides the filter row
+ */
+type DataTableFilterVisibilityConfig = {
+    /** Controlled visibility. Omit for an uncontrolled toggle (DataTable owns the state). */
+    visible?: boolean;
+    onVisibleChange?: (visible: boolean) => void;
+    /** Initial visibility when uncontrolled. @default false */
+    defaultVisible?: boolean;
+};
 /** Wires the CEL filter builder into the filter row in place of plain column filters. */
 type DataTableCelFilterConfig<TData extends RowData> = {
     schema: CelFilterSchema;
@@ -479,6 +488,22 @@ interface DataTableProps<TData extends RowData> {
     stickyHeader?: StickyHeaderConfig;
     /** When set, renders the CEL filter builder in the filter row instead of column filters. */
     celFilterConfig?: DataTableCelFilterConfig<TData>;
+    /**
+     * Controls the "Filter" toggle button in the toolbar, immediately to the left of
+     * `ActionsComponent`, that shows/hides the filter row (CEL filter bar or plain
+     * `ViewFilter`) without touching filter state — only the row's presence changes.
+     * The toggle renders by default (whether this prop is omitted or set to `true`),
+     * with the filter row starting hidden. Pass an object for a controlled toggle
+     * (e.g. to persist the preference in the consumer) or to change the uncontrolled
+     * initial state via `defaultVisible`. Pass `false` to disable the toggle entirely
+     * and always show the filter row whenever filtering is enabled — the pre-toggle
+     * behavior.
+     *
+     * The button never renders if there's nothing to filter — no column has a
+     * `meta.filter` and no `celFilterConfig` is set — or if `disableFilters` is
+     * `true`, regardless of this prop's value.
+     */
+    filterVisibility?: boolean | DataTableFilterVisibilityConfig;
 }
 
 /**
@@ -488,7 +513,7 @@ interface DataTableProps<TData extends RowData> {
  * difference is that columns, headers, rows, cells, and menus render through
  * Monarch's own primitives instead of legacy's hand-rolled ones.
  */
-declare function DataTable<TData extends RowData>({ id, config, title, description, emptyView, showError, className, fitContent, loading, renderSkeletonCell, serverSidePagination, ActionsComponent: Actions, onRowRender, renderExpandedRow, expanded: parentExpanded, onExpandedChange: parentOnExpandedChange, disableSearch, disableFilters, disableSorting, paginationConfig, disableColumnReordering, disableColumnVisibility, disableColumnResizing, disableColumnPinning, searchTerm: parentGlobalFilter, onSearchTermChange: parentSetGlobalFilter, filters: parentColumnFilters, onFiltersChange: parentSetColumnFilters, pagination: parentPagination, onPaginationChange: parentSetPagination, sorting: parentSorting, onSortingChange: parentSetSorting, columnOrdering: parentColumnOrdering, onColumnOrderingChange: parentSetColumnOrdering, columnVisibility: parentColumnVisibility, onColumnVisibilityChange: parentSetColumnVisibility, columnPinning: parentColumnPinning, onColumnPinningChange: parentSetColumnPinning, grouping: parentGrouping, onGroupingChange: parentSetGrouping, celFilterClassName, showContextualFilter, onContextCell, contextualMenuActions, layout, initialColumnSizing, onColumnSizingPersist, stickyHeader, celFilterConfig, }: DataTableProps<TData>): React$1.JSX.Element;
+declare function DataTable<TData extends RowData>({ id, config, title, description, emptyView, showError, className, fitContent, loading, renderSkeletonCell, serverSidePagination, ActionsComponent: Actions, onRowRender, renderExpandedRow, expanded: parentExpanded, onExpandedChange: parentOnExpandedChange, disableSearch, disableFilters, disableSorting, paginationConfig, disableColumnReordering, disableColumnVisibility, disableColumnResizing, disableColumnPinning, searchTerm: parentGlobalFilter, onSearchTermChange: parentSetGlobalFilter, filters: parentColumnFilters, onFiltersChange: parentSetColumnFilters, pagination: parentPagination, onPaginationChange: parentSetPagination, sorting: parentSorting, onSortingChange: parentSetSorting, columnOrdering: parentColumnOrdering, onColumnOrderingChange: parentSetColumnOrdering, columnVisibility: parentColumnVisibility, onColumnVisibilityChange: parentSetColumnVisibility, columnPinning: parentColumnPinning, onColumnPinningChange: parentSetColumnPinning, grouping: parentGrouping, onGroupingChange: parentSetGrouping, celFilterClassName, showContextualFilter, onContextCell, contextualMenuActions, layout, initialColumnSizing, onColumnSizingPersist, stickyHeader, celFilterConfig, filterVisibility, }: DataTableProps<TData>): React$1.JSX.Element;
 
 type ViewFilterProps<TData extends RowData> = {
     columns: Column<TData, unknown>[];
@@ -508,4 +533,4 @@ type ViewFilterProps<TData extends RowData> = {
  */
 declare function ViewFilter<TData extends RowData>({ columns, columnFilters, onColumnFiltersChange, className, }: ViewFilterProps<TData>): React$1.JSX.Element;
 
-export { CellContextualFilter, type CellContextualFilterProps, ColumnOptions, type ColumnOptionsProps, type ContextualMenuAction, DataTable, DataTableBody, type DataTableCelFilterConfig, DataTableCell, type DataTableEmptyConfig, DataTableEmptyView, DataTableExpandedRow, DataTableGroupRow, DataTableHeader, DataTablePagination, type DataTablePaginationConfig, type DataTablePaginationProps, type DataTableProps, DataTableRow, type DataTableRowProps, DataTableSkeletonBody, DataTableValueCell, type DataTableValueCellProps, ExpandButton, RowActionItem, RowActions, type RowCountRelation, type StickyHeaderConfig, type TableHookOptions, type TableLayout, TimestampCell, ViewFilter, type ViewFilterProps, defaultEmptyConfig, defaultErrorConfig, defaultNoFilterFoundConfig, getActionsColumnDefinition, getExpandColumnDefinition, normalizePageSizeOptions };
+export { CellContextualFilter, type CellContextualFilterProps, ColumnOptions, type ColumnOptionsProps, type ContextualMenuAction, DataTable, DataTableBody, type DataTableCelFilterConfig, DataTableCell, type DataTableEmptyConfig, DataTableEmptyView, DataTableExpandedRow, type DataTableFilterVisibilityConfig, DataTableGroupRow, DataTableHeader, DataTablePagination, type DataTablePaginationConfig, type DataTablePaginationProps, type DataTableProps, DataTableRow, type DataTableRowProps, DataTableSkeletonBody, DataTableValueCell, type DataTableValueCellProps, ExpandButton, RowActionItem, RowActions, type RowCountRelation, type StickyHeaderConfig, type TableHookOptions, type TableLayout, TimestampCell, ViewFilter, type ViewFilterProps, defaultEmptyConfig, defaultErrorConfig, defaultNoFilterFoundConfig, getActionsColumnDefinition, getExpandColumnDefinition, normalizePageSizeOptions };