@llmnative/react 1.6.1 → 1.7.0

package/dist/types/src/components/widgets/grid-core/GridCore.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
 import { type RecordProps } from "../../../providers/data/DataProvider";
 import { type GridCoreProps } from "./types";
-declare function GridCore<TRecord extends RecordProps>({ records, recordId, sourcePath, columns, actions, form, editDeepLink, header, footer, view, views, sticky, wrapperClassName, cardClassName, bodyClassName, loading, title, before, after, sortable, pagination, selection, onRowClick, reorderable, onReorder, groupBy, searchable, onSave, onDelete, onComplete, audit, onLoad, }: GridCoreProps<TRecord>): React.JSX.Element;
+declare function GridCore<TRecord extends RecordProps>({ records, recordId, sourcePath, columns, actions, form, editDeepLink, header, footer, view, views, sticky, wrapperClassName, cardClassName, bodyClassName, loading, title, before, after, sortable, pagination, selection, onRowClick, reorderable, onReorder, groupBy, searchable, filters, onSave, onDelete, onComplete, audit, onLoad, }: GridCoreProps<TRecord>): React.JSX.Element;
 export default GridCore;

package/dist/types/src/components/widgets/grid-core/types.d.ts

@@ -274,6 +274,20 @@ export type GridSearchConfig<TRecord> = {
     /** Field keys to match against — omit to search every string-valued field on each record. */
     fields?: Array<keyof TRecord | string>;
 };
+/** A single toggle filter rendered as a checkbox in Grid's own default header, next to the
+ * search box (see `GridBehavior.filters`). */
+export type GridFilterConfig<TRecord> = {
+    /** Unique key identifying this filter — used as the React key and to track its checkbox
+     * state, so it must be stable and unique within the `filters` array. */
+    key: string;
+    /** Label rendered next to the checkbox. */
+    label: string;
+    /** Initial checkbox state. Defaults to `false`. */
+    defaultValue?: boolean;
+    /** Return `true` to keep `record` given the filter's current checkbox `value`. Called for
+     * every record on every render of the filtered set — keep it cheap and pure. */
+    predicate: (record: TRecord, value: boolean) => boolean;
+};
 /** Interaction / behaviour props for `<Grid>`. */
 export type GridBehavior<TRecord> = {
     /** Enable global sorting. Pass an `OrderConfig` to set a default sort. */
@@ -298,6 +312,11 @@ export type GridBehavior<TRecord> = {
      * header — same as `views.table.columnPicker`/`views.toggle`, a fully custom `header` prop
      * bypasses it entirely (render your own search input there instead). */
     searchable?: boolean | GridSearchConfig<TRecord>;
+    /** Toggle filters (checkboxes) rendered in Grid's OWN default header, next to the search
+     * box — applied BEFORE `searchable` (filters → search → sort → pagination/selection all see
+     * the FILTERED set). Same extension point as `searchable`: a fully custom `header` prop
+     * bypasses it entirely (render your own filter controls there instead). */
+    filters?: GridFilterConfig<TRecord>[];
 };
 /** Data-mutation hooks for `<Grid>`. */
 export type GridPersistence<TRecord> = {

package/dist/types/src/index.d.ts

@@ -21,7 +21,7 @@ export { PromptUtils } from './libs/promptUtils';
 export type { PromptAction, PromptStatusItem, PromptRunStats } from './components/widgets/Prompt';
 export type { TableHeaderProp, TableReorderHandler, TableReorderMeta, TableSelectionChangeHandler, TableSelectionState } from './components/ui/Table';
 export type { GalleryRecord, GallerySelectionChangeHandler, GallerySelectionState } from './components/ui/Gallery';
-export type { GridAction, GridActions, GridAfterActionArgs, GridAfterActionHandler, GridArrayProps, GridColumn, GridCoreProps, GridDBPath, GridDBQuery, GridDBProps, GridFooterContext, GridFormContext, GridGalleryField, GridGalleryViewProps, GridGalleryViewConfig, GridHeaderContext, GridLayout, GridMutationDeleteArgs, GridMutationDeleteHandler, GridMutationSaveArgs, GridMutationSaveHandler, GridReorderHandler, GridReorderMeta, GridRecordKey, GridProps, GridSearchConfig, GridSelectionChangeHandler, GridSelectionMode, GridSelectionState, GridSticky, GridTableViewProps, GridTableViewConfig, GridViewsConfig, GridCellContext, } from './components/widgets/Grid';
+export type { GridAction, GridActions, GridAfterActionArgs, GridAfterActionHandler, GridArrayProps, GridColumn, GridCoreProps, GridDBPath, GridDBQuery, GridDBProps, GridFooterContext, GridFormContext, GridGalleryField, GridGalleryViewProps, GridGalleryViewConfig, GridFilterConfig, GridHeaderContext, GridLayout, GridMutationDeleteArgs, GridMutationDeleteHandler, GridMutationSaveArgs, GridMutationSaveHandler, GridReorderHandler, GridReorderMeta, GridRecordKey, GridProps, GridSearchConfig, GridSelectionChangeHandler, GridSelectionMode, GridSelectionState, GridSticky, GridTableViewProps, GridTableViewConfig, GridViewsConfig, GridCellContext, } from './components/widgets/Grid';
 export type { ProviderConfigurable, ProviderConfigurationState } from './providers/ProviderConfiguration';
 export { getProviderConfigurationState } from './providers/ProviderConfiguration';
 export type { ProviderAdapterMap, ProviderService, SetProviderFn, ProviderRegistrySnapshot } from './providers/ProviderRegistryContext';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "1.6.1",
+  "version": "1.7.0",
   "description": "LLM-native React framework for deterministic UI generation. Data-driven by default, schema-driven optional. Ultra-low token consumption — built for AI agents, not just humans.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",