@redsift/table 12.5.3-alpha.5 → 12.5.3-alpha.6

package/index.d.ts

@@ -338,10 +338,22 @@ declare const DENSITY_MODEL_KEY = "densityModel";
 declare const COLUMN_ORDER_MODEL_KEY = "columnOrderModel";
 declare const ROW_GROUPING_MODEL_KEY = "rowGroupingModel";
 declare const AGGREGATION_MODEL_KEY = "aggregationModel";
+/** Storage category key for the pivot column/row/value configuration. Consumer interop — use with `buildStorageKey`. */
 declare const PIVOT_MODEL_KEY = "pivotModel";
+/** Storage category key for whether pivoting is active. Consumer interop — use with `buildStorageKey`. */
 declare const PIVOT_ACTIVE_KEY = "pivotActive";
 declare const CATEGORIES: readonly ["paginationModel", "filterModel", "sortModel", "visibilityModel", "dimension", "searchModel", "pinnedColumns", "densityModel", "columnOrderModel", "rowGroupingModel", "aggregationModel", "pivotModel", "pivotActive"];
 type Category = (typeof CATEGORIES)[number];
+/**
+ * Build the localStorage key for a specific grid state category.
+ * Consumers can use this to read or clear individual state entries directly.
+ *
+ * @example
+ * ```ts
+ * const key = buildStorageKey({ id: pathname, version: 2, category: PIVOT_ACTIVE_KEY });
+ * localStorage.removeItem(key);
+ * ```
+ */
 declare const buildStorageKey: ({ id, version, category }: {
     id: string;
     version: number;
@@ -946,6 +958,104 @@ type DataGridModel = {
 declare const updateUrl: ({ filterModel, sortModel, paginationModel, columnsModel: columnsVisibilityModel, pinnedColumnsModel, density, columnOrderModel, defaultColumnOrder, rowGroupingModel, aggregationModel, pivotModel, pivotActive, }: DataGridModel, search: string, localStorageVersion: number, historyReplace: (newSearch: string) => void, columns: DataGridProps["columns"]) => void;
 declare const areFilterModelsEquivalent: (filterModel: GridFilterModel, filterModelToMatch: GridFilterModel) => boolean;
 
+/**
+ * A React Router v5 / connected-react-router adapter for `StatefulDataGrid.useRouter`.
+ *
+ * Defers `history.replace` via `queueMicrotask` to avoid the
+ * "Cannot update during an existing state transition" warning
+ * that connected-react-router triggers when the grid synchronises
+ * URL state during render.
+ *
+ * @example
+ * ```tsx
+ * import { createReactRouterV5Adapter } from '@redsift/table';
+ *
+ * const useRouter = createReactRouterV5Adapter(history);
+ *
+ * <StatefulDataGrid useRouter={useRouter} … />
+ * ```
+ */
+/** Minimal subset of React Router v5 `history` used by the adapter. */
+interface ReactRouterV5History {
+    location: {
+        pathname: string;
+        search: string;
+    };
+    replace: (path: {
+        pathname: string;
+        search: string;
+    }) => void;
+}
+/**
+ * Create a `useRouter` hook compatible with `StatefulDataGrid` from a
+ * React Router v5 `history` object.
+ */
+declare const createReactRouterV5Adapter: (history: ReactRouterV5History) => (() => {
+    pathname: string;
+    search: string;
+    historyReplace: (newSearch: string) => void;
+});
+
+interface UseLinkedFilterModelOptions {
+    /** Starting filter model. Defaults to `{ items: [] }`. */
+    initialFilterModel?: GridFilterModel;
+    /**
+     * Debounce window (ms) applied to changes coming from the DataGrid filter panel.
+     * Card-driven changes via `setMultiSelect` / `setBoolean` are never debounced.
+     * Defaults to `300`. Pass `0` to disable.
+     */
+    debounceMs?: number;
+    /** Optional callback fired on every settled filter model change. */
+    onChange?: (model: GridFilterModel) => void;
+}
+interface UseLinkedFilterModelReturn {
+    /** Current filter model. Pass to DataGrid `filterModel` and read for DataCard derivations. */
+    filterModel: GridFilterModel;
+    /** Bind to DataGrid `onFilterModelChange`. Debounced for panel changes. */
+    onFilterModelChange: (model: GridFilterModel) => void;
+    /** Read selected values for an `isAnyOf` / `hasAnyOf` field. Empty array when not set. */
+    getSelected: (field: string) => string[];
+    /** Read the raw filter value for a field (e.g. boolean toggles). */
+    getValue: (field: string) => unknown;
+    /** Set a multi-select filter from a DataCard. Empty array clears the field. */
+    setMultiSelect: (field: string, values: string[], operator?: string) => void;
+    /** Set a boolean filter. Pass `null` to clear. */
+    setBoolean: (field: string, value: boolean | null) => void;
+    /** Remove a single field from the filter model. */
+    clearField: (field: string) => void;
+    /** Reset the filter model to the initial value. */
+    reset: () => void;
+    /**
+     * Whether a field's filter was set externally (DataGrid filter panel) rather than
+     * via this hook's setters. Useful for disabling the corresponding DataCard so the
+     * panel and card don't fight over the same field.
+     */
+    isFieldExternallyControlled: (field: string) => boolean;
+}
+/**
+ * Bridge a DataGrid `filterModel` and the DataCards that drive (and reflect) it.
+ *
+ * Without this hook, every drilldowned datagrid page hand-rolls the same plumbing:
+ * derive selections from `filterModel`, write them back via raw `setFilterModel`
+ * mutations, debounce panel changes, and track which fields the panel "owns" so
+ * cards don't fight the panel for control. SOFA-6 shipped this logic ad hoc and
+ * got it wrong (no debounce, prop-drilled state, no panel/card reconciliation).
+ *
+ * @example
+ * const filter = useLinkedFilterModel();
+ *
+ * <DataCard.Listbox
+ *   values={filter.getSelected('Category')}
+ *   onChange={(values) => filter.setMultiSelect('Category', values)}
+ *   isDisabled={filter.isFieldExternallyControlled('Category')}
+ * >
+ *   {…}
+ * </DataCard.Listbox>
+ *
+ * <DataGrid filterModel={filter.filterModel} onFilterModelChange={filter.onFilterModelChange} />
+ */
+declare function useLinkedFilterModel(options?: UseLinkedFilterModelOptions): UseLinkedFilterModelReturn;
+
 declare const BaseButton: React$1.JSXElementConstructor<any>;
 
 declare const BaseCheckbox: React$1.JSXElementConstructor<any>;
@@ -1151,4 +1261,4 @@ type ToolbarWrapperProps = {
 };
 declare const ToolbarWrapper: React$1.FC<ToolbarWrapperProps>;
 
-export { AGGREGATION_MODEL_KEY, ARRAY_IS_EMPTY, ARRAY_IS_NOT_EMPTY, BaseButton, BaseCheckbox, BaseIcon, BaseIconButton, BaseTextField, CATEGORIES, COLUMN_ORDER_MODEL_KEY, CONTAINS_ANY_OF, Category, ColumnOptions, ColumnOrderModel, ColumnType, CompletionResponse, ControlledPagination, ControlledPaginationProps, DATE_IS_BETWEEN, DEFAULT_OPERATORS, DENSITY_MODEL_KEY, DETAIL_PANEL_TOGGLE_COL_DEF, DIMENSION_MODEL_KEY, DOES_NOT_CONTAIN, DOES_NOT_CONTAIN_ANY_OF, DOES_NOT_END_WITH, DOES_NOT_END_WITH_ANY_OF, DOES_NOT_EQUAL, DOES_NOT_HAVE, DOES_NOT_HAVE_ANY_OF, DOES_NOT_HAVE_ANY_OF_WITH_SELECT, DOES_NOT_HAVE_WITH_SELECT, DOES_NOT_START_WITH, DOES_NOT_START_WITH_ANY_OF, DataGrid, DataGridModel, DataGridProps, DateOperatorName, EMPTY_ROW_SELECTION_MODEL, ENDS_WITH_ANY_OF, FILTER_MODEL_KEY, FILTER_SEARCH_KEY, FilterConfig, FilterConfigColumn, GridDensityValue, GridToolbarFilterSemanticField, GridToolbarFilterSemanticFieldProps, HAS, HAS_ALL_OF, HAS_ALL_OF_WITH_SELECT, HAS_ANY_OF, HAS_ANY_OF_WITH_SELECT, HAS_ONLY, HAS_ONLY_WITH_SELECT, HAS_WITH_SELECT, IS, IS_ANY_OF, IS_ANY_OF_I, IS_ANY_OF_I_WITH_SELECT, IS_ANY_OF_WITH_SELECT, IS_BETWEEN, IS_NOT, IS_NOT_ANY_OF, IS_NOT_ANY_OF_WITH_SELECT, IS_NOT_WITH_SELECT, IS_WITH_SELECT, LegacyRowSelectionModel, MultiSelectOperatorName, NumberOperatorName, PAGINATION_MODEL_KEY, PINNED_COLUMNS, PIVOT_ACTIVE_KEY, PIVOT_MODEL_KEY, PinnedColumns, PivotModel, ROW_GROUPING_MODEL_KEY, RowSelectionModelInput, SORT_MODEL_KEY, STARTS_WITH_ANY_OF, SelectionStatus, ServerSideControlledPagination, ServerSideControlledPaginationProps, SingleSelectOperatorName, StatefulDataGrid, StatefulDataGridProps, StringOperatorName, StyledDataGridProps, TagsOperatorName, TextCell, Toolbar, ToolbarWrapper, ToolbarWrapperProps, VISIBILITY_MODEL_KEY, areFilterModelsEquivalent, areSearchStringsEqual, buildQueryParamsString, buildStorageKey, clearAllVersionStorage, clearPreviousVersionStorage, convertFromDisplayFormat, convertToDisplayFormat, createColumn, createRowSelectionModel, customColumnTypes, decodeValue, encodeValue, fixServerSideHeaderCheckboxSelection, fromGridPivotModel, getAggregationFromString, getColumnOrderFromString, getColumnVisibilityFromString, getCompletion, getDecodedSearchFromUrl, getDensityFromString, getDensityModel, getFilterModelFromString, getFinalSearch, getGridDateOperatorsExtended, getGridNumericOperators, getGridStringArrayOperators, getGridStringArrayOperatorsWithSelect, getGridStringArrayOperatorsWithSelectOnStringArrayColumns, getGridStringOperators, getModelsParsedOrUpdateLocalStorage, getPaginationFromString, getPinnedColumnsFromString, getPivotActiveFromString, getPivotFromString, getRowGroupingFromString, getRsMultipleSelectColumnType, getRsMultipleSelectWithShortOperatorListColumnType, getRsNumberColumnType, getRsSingleSelectColumnType, getRsSingleSelectWithShortOperatorListColumnType, getRsStringColumnType, getSearchParamsFromAggregation, getSearchParamsFromColumnOrder, getSearchParamsFromColumnVisibility, getSearchParamsFromDensity, getSearchParamsFromFilterModel, getSearchParamsFromPagination, getSearchParamsFromPinnedColumns, getSearchParamsFromPivot, getSearchParamsFromPivotActive, getSearchParamsFromRowGrouping, getSearchParamsFromSorting, getSearchParamsFromTab, getSelectableRowIdsInPage, getSelectedIds, getSelectionCount, getSortingFromString, isOperatorValueValid, isRowSelected, isValueValid, makeCaseInsensitive, muiIconToDSIcon, normalizeRowSelectionModel, numberOperatorDecoder, numberOperatorEncoder, onServerSideSelectionStatusChange, operatorList, resetStatefulDataGridState, updateUrl, urlSearchParamsToString, wrapCaseInsensitive };
+export { AGGREGATION_MODEL_KEY, ARRAY_IS_EMPTY, ARRAY_IS_NOT_EMPTY, BaseButton, BaseCheckbox, BaseIcon, BaseIconButton, BaseTextField, CATEGORIES, COLUMN_ORDER_MODEL_KEY, CONTAINS_ANY_OF, Category, ColumnOptions, ColumnOrderModel, ColumnType, CompletionResponse, ControlledPagination, ControlledPaginationProps, DATE_IS_BETWEEN, DEFAULT_OPERATORS, DENSITY_MODEL_KEY, DETAIL_PANEL_TOGGLE_COL_DEF, DIMENSION_MODEL_KEY, DOES_NOT_CONTAIN, DOES_NOT_CONTAIN_ANY_OF, DOES_NOT_END_WITH, DOES_NOT_END_WITH_ANY_OF, DOES_NOT_EQUAL, DOES_NOT_HAVE, DOES_NOT_HAVE_ANY_OF, DOES_NOT_HAVE_ANY_OF_WITH_SELECT, DOES_NOT_HAVE_WITH_SELECT, DOES_NOT_START_WITH, DOES_NOT_START_WITH_ANY_OF, DataGrid, DataGridModel, DataGridProps, DateOperatorName, EMPTY_ROW_SELECTION_MODEL, ENDS_WITH_ANY_OF, FILTER_MODEL_KEY, FILTER_SEARCH_KEY, FilterConfig, FilterConfigColumn, GridDensityValue, GridToolbarFilterSemanticField, GridToolbarFilterSemanticFieldProps, HAS, HAS_ALL_OF, HAS_ALL_OF_WITH_SELECT, HAS_ANY_OF, HAS_ANY_OF_WITH_SELECT, HAS_ONLY, HAS_ONLY_WITH_SELECT, HAS_WITH_SELECT, IS, IS_ANY_OF, IS_ANY_OF_I, IS_ANY_OF_I_WITH_SELECT, IS_ANY_OF_WITH_SELECT, IS_BETWEEN, IS_NOT, IS_NOT_ANY_OF, IS_NOT_ANY_OF_WITH_SELECT, IS_NOT_WITH_SELECT, IS_WITH_SELECT, LegacyRowSelectionModel, MultiSelectOperatorName, NumberOperatorName, PAGINATION_MODEL_KEY, PINNED_COLUMNS, PIVOT_ACTIVE_KEY, PIVOT_MODEL_KEY, PinnedColumns, PivotModel, ROW_GROUPING_MODEL_KEY, ReactRouterV5History, RowSelectionModelInput, SORT_MODEL_KEY, STARTS_WITH_ANY_OF, SelectionStatus, ServerSideControlledPagination, ServerSideControlledPaginationProps, SingleSelectOperatorName, StatefulDataGrid, StatefulDataGridProps, StringOperatorName, StyledDataGridProps, TagsOperatorName, TextCell, Toolbar, ToolbarWrapper, ToolbarWrapperProps, UseLinkedFilterModelOptions, UseLinkedFilterModelReturn, VISIBILITY_MODEL_KEY, areFilterModelsEquivalent, areSearchStringsEqual, buildQueryParamsString, buildStorageKey, clearAllVersionStorage, clearPreviousVersionStorage, convertFromDisplayFormat, convertToDisplayFormat, createColumn, createReactRouterV5Adapter, createRowSelectionModel, customColumnTypes, decodeValue, encodeValue, fixServerSideHeaderCheckboxSelection, fromGridPivotModel, getAggregationFromString, getColumnOrderFromString, getColumnVisibilityFromString, getCompletion, getDecodedSearchFromUrl, getDensityFromString, getDensityModel, getFilterModelFromString, getFinalSearch, getGridDateOperatorsExtended, getGridNumericOperators, getGridStringArrayOperators, getGridStringArrayOperatorsWithSelect, getGridStringArrayOperatorsWithSelectOnStringArrayColumns, getGridStringOperators, getModelsParsedOrUpdateLocalStorage, getPaginationFromString, getPinnedColumnsFromString, getPivotActiveFromString, getPivotFromString, getRowGroupingFromString, getRsMultipleSelectColumnType, getRsMultipleSelectWithShortOperatorListColumnType, getRsNumberColumnType, getRsSingleSelectColumnType, getRsSingleSelectWithShortOperatorListColumnType, getRsStringColumnType, getSearchParamsFromAggregation, getSearchParamsFromColumnOrder, getSearchParamsFromColumnVisibility, getSearchParamsFromDensity, getSearchParamsFromFilterModel, getSearchParamsFromPagination, getSearchParamsFromPinnedColumns, getSearchParamsFromPivot, getSearchParamsFromPivotActive, getSearchParamsFromRowGrouping, getSearchParamsFromSorting, getSearchParamsFromTab, getSelectableRowIdsInPage, getSelectedIds, getSelectionCount, getSortingFromString, isOperatorValueValid, isRowSelected, isValueValid, makeCaseInsensitive, muiIconToDSIcon, normalizeRowSelectionModel, numberOperatorDecoder, numberOperatorEncoder, onServerSideSelectionStatusChange, operatorList, resetStatefulDataGridState, updateUrl, urlSearchParamsToString, useLinkedFilterModel, wrapCaseInsensitive };

package/index.js

@@ -4,6 +4,7 @@ import { GRID_DETAIL_PANEL_TOGGLE_COL_DEF, GridFilterInputMultipleValue, GridFil
 export { getGridBooleanOperators, getGridDateOperators, getGridSingleSelectOperators } from '@mui/x-data-grid-premium';
 import { _ as _objectSpread2 } from './_internal/_rollupPluginBabelHelpers.js';
 import * as React from 'react';
+import { useState, useRef, useEffect, useCallback, useMemo } from 'react';
 import Box from '@mui/material/Box';
 import TextField from '@mui/material/TextField';
 import { Icon } from '@redsift/design-system';
@@ -415,5 +416,236 @@ function getOperatorsForType(type, compact) {
   }
 }
 
-export { DATE_IS_BETWEEN, DETAIL_PANEL_TOGGLE_COL_DEF, IS_ANY_OF_I, IS_ANY_OF_I_WITH_SELECT, createColumn, customColumnTypes, getGridDateOperatorsExtended, getRsMultipleSelectColumnType, getRsMultipleSelectWithShortOperatorListColumnType, getRsNumberColumnType, getRsSingleSelectColumnType, getRsSingleSelectWithShortOperatorListColumnType, getRsStringColumnType, makeCaseInsensitive, wrapCaseInsensitive };
+/**
+ * A React Router v5 / connected-react-router adapter for `StatefulDataGrid.useRouter`.
+ *
+ * Defers `history.replace` via `queueMicrotask` to avoid the
+ * "Cannot update during an existing state transition" warning
+ * that connected-react-router triggers when the grid synchronises
+ * URL state during render.
+ *
+ * @example
+ * ```tsx
+ * import { createReactRouterV5Adapter } from '@redsift/table';
+ *
+ * const useRouter = createReactRouterV5Adapter(history);
+ *
+ * <StatefulDataGrid useRouter={useRouter} … />
+ * ```
+ */
+
+/** Minimal subset of React Router v5 `history` used by the adapter. */
+
+/**
+ * Create a `useRouter` hook compatible with `StatefulDataGrid` from a
+ * React Router v5 `history` object.
+ */
+const createReactRouterV5Adapter = history => {
+  return () => ({
+    pathname: history.location.pathname,
+    search: history.location.search.replace(/^\?/, ''),
+    historyReplace: newSearch => {
+      queueMicrotask(() => {
+        history.replace({
+          pathname: history.location.pathname,
+          search: newSearch ? `?${newSearch}` : ''
+        });
+      });
+    }
+  });
+};
+
+const EMPTY_FILTER_MODEL = {
+  items: []
+};
+const sameItems = (a, b) => JSON.stringify(a.items) === JSON.stringify(b.items);
+const filterOutField = (model, field) => model.items.filter(item => item.field !== field);
+const nextItemId = (() => {
+  let id = 1;
+  return () => id++;
+})();
+
+/**
+ * Bridge a DataGrid `filterModel` and the DataCards that drive (and reflect) it.
+ *
+ * Without this hook, every drilldowned datagrid page hand-rolls the same plumbing:
+ * derive selections from `filterModel`, write them back via raw `setFilterModel`
+ * mutations, debounce panel changes, and track which fields the panel "owns" so
+ * cards don't fight the panel for control. SOFA-6 shipped this logic ad hoc and
+ * got it wrong (no debounce, prop-drilled state, no panel/card reconciliation).
+ *
+ * @example
+ * const filter = useLinkedFilterModel();
+ *
+ * <DataCard.Listbox
+ *   values={filter.getSelected('Category')}
+ *   onChange={(values) => filter.setMultiSelect('Category', values)}
+ *   isDisabled={filter.isFieldExternallyControlled('Category')}
+ * >
+ *   {…}
+ * </DataCard.Listbox>
+ *
+ * <DataGrid filterModel={filter.filterModel} onFilterModelChange={filter.onFilterModelChange} />
+ */
+function useLinkedFilterModel() {
+  let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  const {
+    initialFilterModel = EMPTY_FILTER_MODEL,
+    debounceMs = 300,
+    onChange
+  } = options;
+  const [filterModel, setFilterModel] = useState(initialFilterModel);
+
+  // Fields whose current filter was set by setMultiSelect / setBoolean (not the panel).
+  const cardOwnedFields = useRef(new Set());
+  // Marks the next onFilterModelChange as originating from a card setter so we skip debouncing.
+  const skipNextDebounce = useRef(false);
+  const debounceTimer = useRef(null);
+  const onChangeRef = useRef(onChange);
+  useEffect(() => {
+    onChangeRef.current = onChange;
+  }, [onChange]);
+  useEffect(() => {
+    return () => {
+      if (debounceTimer.current) clearTimeout(debounceTimer.current);
+    };
+  }, []);
+  const commit = useCallback(next => {
+    setFilterModel(prev => {
+      var _onChangeRef$current;
+      if (sameItems(prev, next)) return prev;
+      (_onChangeRef$current = onChangeRef.current) === null || _onChangeRef$current === void 0 ? void 0 : _onChangeRef$current.call(onChangeRef, next);
+      return next;
+    });
+  }, []);
+  const onFilterModelChange = useCallback(model => {
+    if (skipNextDebounce.current) {
+      skipNextDebounce.current = false;
+      // If the incoming model matches the current state, this is a DataGrid echo
+      // of a card setter — commit (no-op) and preserve card ownership.
+      if (sameItems(filterModel, model)) {
+        commit(model);
+        return;
+      }
+      // Otherwise a real panel change arrived — fall through to ownership logic.
+    }
+
+    // Panel change — drop card ownership for fields the panel now controls / has cleared,
+    // then debounce the commit.
+    const panelFields = new Set(model.items.map(item => item.field));
+    for (const field of Array.from(cardOwnedFields.current)) {
+      if (!panelFields.has(field)) cardOwnedFields.current.delete(field);
+    }
+    // If the panel touched a field the card previously owned, transfer ownership to the panel.
+    for (const field of panelFields) {
+      cardOwnedFields.current.delete(field);
+    }
+    if (debounceMs <= 0) {
+      commit(model);
+      return;
+    }
+    if (debounceTimer.current) clearTimeout(debounceTimer.current);
+    debounceTimer.current = setTimeout(() => {
+      debounceTimer.current = null;
+      commit(model);
+    }, debounceMs);
+  }, [commit, debounceMs, filterModel]);
+  const getSelected = useCallback(field => {
+    const item = filterModel.items.find(i => i.field === field);
+    if (!item || item.value === undefined || item.value === null) return [];
+    if (item.operator === 'isAnyOf' || item.operator === 'hasAnyOf') {
+      return Array.isArray(item.value) ? item.value : [String(item.value)];
+    }
+    return [];
+  }, [filterModel]);
+  const getValue = useCallback(field => {
+    var _filterModel$items$fi;
+    return (_filterModel$items$fi = filterModel.items.find(i => i.field === field)) === null || _filterModel$items$fi === void 0 ? void 0 : _filterModel$items$fi.value;
+  }, [filterModel]);
+  const setMultiSelect = useCallback(function (field, values) {
+    let operator = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'isAnyOf';
+    skipNextDebounce.current = true;
+    setFilterModel(prev => {
+      var _onChangeRef$current2;
+      const items = filterOutField(prev, field);
+      if (values.length > 0) {
+        items.push({
+          field,
+          id: nextItemId(),
+          operator,
+          value: values
+        });
+        cardOwnedFields.current.add(field);
+      } else {
+        cardOwnedFields.current.delete(field);
+      }
+      const next = _objectSpread2(_objectSpread2({}, prev), {}, {
+        items
+      });
+      if (sameItems(prev, next)) return prev;
+      (_onChangeRef$current2 = onChangeRef.current) === null || _onChangeRef$current2 === void 0 ? void 0 : _onChangeRef$current2.call(onChangeRef, next);
+      return next;
+    });
+  }, []);
+  const setBoolean = useCallback((field, value) => {
+    skipNextDebounce.current = true;
+    setFilterModel(prev => {
+      var _onChangeRef$current3;
+      const items = filterOutField(prev, field);
+      if (value !== null) {
+        items.push({
+          field,
+          id: nextItemId(),
+          operator: 'is',
+          value: String(value)
+        });
+        cardOwnedFields.current.add(field);
+      } else {
+        cardOwnedFields.current.delete(field);
+      }
+      const next = _objectSpread2(_objectSpread2({}, prev), {}, {
+        items
+      });
+      if (sameItems(prev, next)) return prev;
+      (_onChangeRef$current3 = onChangeRef.current) === null || _onChangeRef$current3 === void 0 ? void 0 : _onChangeRef$current3.call(onChangeRef, next);
+      return next;
+    });
+  }, []);
+  const clearField = useCallback(field => {
+    skipNextDebounce.current = true;
+    setFilterModel(prev => {
+      var _onChangeRef$current4;
+      const items = filterOutField(prev, field);
+      cardOwnedFields.current.delete(field);
+      const next = _objectSpread2(_objectSpread2({}, prev), {}, {
+        items
+      });
+      if (sameItems(prev, next)) return prev;
+      (_onChangeRef$current4 = onChangeRef.current) === null || _onChangeRef$current4 === void 0 ? void 0 : _onChangeRef$current4.call(onChangeRef, next);
+      return next;
+    });
+  }, []);
+  const reset = useCallback(() => {
+    skipNextDebounce.current = true;
+    cardOwnedFields.current.clear();
+    commit(initialFilterModel);
+  }, [commit, initialFilterModel]);
+  const isFieldExternallyControlled = useCallback(field => {
+    const hasFilter = filterModel.items.some(item => item.field === field);
+    return hasFilter && !cardOwnedFields.current.has(field);
+  }, [filterModel]);
+  return useMemo(() => ({
+    filterModel,
+    onFilterModelChange,
+    getSelected,
+    getValue,
+    setMultiSelect,
+    setBoolean,
+    clearField,
+    reset,
+    isFieldExternallyControlled
+  }), [filterModel, onFilterModelChange, getSelected, getValue, setMultiSelect, setBoolean, clearField, reset, isFieldExternallyControlled]);
+}
+
+export { DATE_IS_BETWEEN, DETAIL_PANEL_TOGGLE_COL_DEF, IS_ANY_OF_I, IS_ANY_OF_I_WITH_SELECT, createColumn, createReactRouterV5Adapter, customColumnTypes, getGridDateOperatorsExtended, getRsMultipleSelectColumnType, getRsMultipleSelectWithShortOperatorListColumnType, getRsNumberColumnType, getRsSingleSelectColumnType, getRsSingleSelectWithShortOperatorListColumnType, getRsStringColumnType, makeCaseInsensitive, useLinkedFilterModel, wrapCaseInsensitive };
 //# sourceMappingURL=index.js.map