@mono-lit/helper 0.0.9 → 0.1.0

package/dist/src/components/dropdown-table/dropdown-table-core.d.ts

@@ -1,10 +1,10 @@
 import { Constructor } from "../../composables/hybird-prop.js";
 import { CssSizeValue } from "../../composables/css-size.js";
 import { DropdownPlacement } from "../dropdown/dropdown-types.js";
+import { MonoDropdownController } from "./mono-data-dropdown.js";
+import { DropdownPanelOptions, DropdownTableChipProps, DropdownTableColor, DropdownTableCssClass, DropdownTableSize, DropdownTableValidationState, DropdownTableVariant } from "./dropdown-table-types.js";
 import { FieldTooltipController, FieldTooltipValue } from "../../composables/field-tooltip.js";
 import { PopupPortalController } from "../../composables/popup-portal.js";
-import { DropdownPanelOptions, DropdownTableChipProps, DropdownTableColor, DropdownTableCssClass, DropdownTableSize, DropdownTableValidationState, DropdownTableVariant } from "./dropdown-table-types.js";
-import { MonoDropdownController } from "./mono-data-dropdown.js";
 import { LitElement, TemplateResult } from "lit";
 //#region src/components/dropdown-table/dropdown-table-core.d.ts
 /** Public surface added by the dropdown-table core mixin. */

package/dist/src/components/dropdown-table/dropdown-table-types.d.ts

@@ -1,8 +1,8 @@
 import { CssSizeValue, PanelSizeProps } from "../../composables/css-size.js";
 import { DropdownPlacement } from "../dropdown/dropdown-types.js";
 import { VisibilityProps } from "../../composables/visibility.js";
-import { ChipBehaviour, ChipColor, ChipCssClass, ChipRounded, ChipSize, ChipVariant } from "../chip/chip-types.js";
 import { MonoTooltipOptions } from "../tooltip/tooltip-types.js";
+import { ChipBehaviour, ChipColor, ChipCssClass, ChipRounded, ChipSize, ChipVariant } from "../chip/chip-types.js";
 import { ChipLimitProps } from "../../composables/chip-limits.js";
 import { MonoDropdownController, MonoDropdownItem } from "./mono-data-dropdown.js";
 //#region src/components/dropdown-table/dropdown-table-types.d.ts

package/dist/src/components/dropdown-table/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="../../../vue.d.ts" />
 import { ChipBehaviour } from "../chip/chip-types.js";
-import { DropdownPanelOptions, DropdownTableChangeEvent, DropdownTableChangeEventDetail, DropdownTableChipProps, DropdownTableColor, DropdownTableEvents, DropdownTableProps, DropdownTableSize, DropdownTableValidationState, DropdownTableVariant } from "./dropdown-table-types.js";
 import { MonoDataDropdownOptions, MonoDropdownController, MonoDropdownItem, controlMonoDataDropdown as monoDataDropdown } from "./mono-data-dropdown.js";
+import { DropdownPanelOptions, DropdownTableChangeEvent, DropdownTableChangeEventDetail, DropdownTableChipProps, DropdownTableColor, DropdownTableEvents, DropdownTableProps, DropdownTableSize, DropdownTableValidationState, DropdownTableVariant } from "./dropdown-table-types.js";
 import { MonoDropdownTable } from "./mono-dropdown-table.js";
 export { type ChipBehaviour, type DropdownPanelOptions, type DropdownTableChangeEvent, type DropdownTableChangeEventDetail, type DropdownTableChipProps, type DropdownTableColor, type DropdownTableEvents, type DropdownTableProps, type DropdownTableSize, type DropdownTableValidationState, type DropdownTableVariant, type MonoDataDropdownOptions, type MonoDropdownController, type MonoDropdownItem, MonoDropdownTable, monoDataDropdown as controlMonoDataDropdown, monoDataDropdown };

package/dist/src/components/dropdown-table/index.shadow.d.ts

@@ -1,7 +1,7 @@
 /// <reference path="../../../vue.d.ts" />
 import { ChipBehaviour } from "../chip/chip-types.js";
-import { DropdownPanelOptions, DropdownTableChangeEvent, DropdownTableChangeEventDetail, DropdownTableChipProps, DropdownTableColor, DropdownTableEvents, DropdownTableProps, DropdownTableSize, DropdownTableValidationState, DropdownTableVariant } from "./dropdown-table-types.js";
 import { MonoDataDropdownOptions, MonoDropdownController, MonoDropdownItem, controlMonoDataDropdown as monoDataDropdown } from "./mono-data-dropdown.js";
+import { DropdownPanelOptions, DropdownTableChangeEvent, DropdownTableChangeEventDetail, DropdownTableChipProps, DropdownTableColor, DropdownTableEvents, DropdownTableProps, DropdownTableSize, DropdownTableValidationState, DropdownTableVariant } from "./dropdown-table-types.js";
 import { MonoDropdownTableCore } from "./dropdown-table-core.js";
 import { MonoDropdownTableShadow } from "./mono-dropdown-table.shadow.js";
 export { type ChipBehaviour, type DropdownPanelOptions, type DropdownTableChangeEvent, type DropdownTableChangeEventDetail, type DropdownTableChipProps, type DropdownTableColor, type DropdownTableEvents, type DropdownTableProps, type DropdownTableSize, type DropdownTableValidationState, type DropdownTableVariant, type MonoDataDropdownOptions, type MonoDropdownController, type MonoDropdownItem, MonoDropdownTableCore, MonoDropdownTableShadow, monoDataDropdown };

package/dist/src/components/dropdown-table/mono-data-dropdown.d.ts

@@ -1,6 +1,6 @@
 import { MonoEventProps } from "../../composables/element-props.js";
-import { MonoCheckLimits, MonoDataGridOptions, MonoGridSource, MonoTableController, MonoTableProps } from "../table/mono-data-grid.js";
 import { DropdownTableEvents } from "./dropdown-table-types.js";
+import { MonoCheckLimits, MonoDataGridOptions, MonoGridSource, MonoTableController, MonoTableProps } from "../table/mono-data-grid.js";
 //#region src/components/dropdown-table/mono-data-dropdown.d.ts
 /** One resolved selection (key + display text + the row it came from). */
 export interface MonoDropdownItem<T = any> {

package/dist/src/components/form/form-types.d.ts

@@ -1,13 +1,13 @@
 import { MonoEventProps } from "../../composables/element-props.js";
 import { CheckboxEvents, CheckboxProps } from "../checkbox/checkbox-types.js";
-import { DateEvents, DateProps } from "../date/date-types.js";
-import { DropdownTableEvents, DropdownTableProps } from "../dropdown-table/dropdown-table-types.js";
-import { FileUploadEvents, FileUploadProps } from "../file-upload/file-upload-types.js";
 import { InputEvents, InputProps } from "../input/input-types.js";
 import { SelectEvents, SelectProps } from "../select/select-types.js";
 import { TextareaEvents, TextareaProps } from "../textarea/textarea-types.js";
 import { RichTextEditorEvents, RichTextEditorProps } from "../rich-text-editor/rich-text-editor-types.js";
+import { DateEvents, DateProps } from "../date/date-types.js";
 import { TagInputEvents, TagInputProps } from "../tag-input/tag-input-types.js";
+import { FileUploadEvents, FileUploadProps } from "../file-upload/file-upload-types.js";
+import { DropdownTableEvents, DropdownTableProps } from "../dropdown-table/dropdown-table-types.js";
 import { RadioEvents, RadioProps } from "../radio/radio-types.js";
 import { SwitchEvents, SwitchProps } from "../switch/switch-types.js";
 import { SliderEvents, SliderProps } from "../slider/slider-types.js";
@@ -320,6 +320,12 @@ export interface MonoFormController {
   _reportList(key: string, entries: MonoFormListEntry[]): void;
   /** @internal The props an element should currently apply (`inputs[key].props` wins). */
   _propsFor(key: string): Record<string, unknown>;
+  /**
+   * @internal The elements currently registered under `key` — how a table's filter
+   * suggestion reads the bound control's option source (`dataSource` / `items` /
+   * `keyValue`) and whether it is `readonly` / `disabled`.
+   */
+  _elements(key: string): unknown[];
 }
 //#endregion
 export {};

package/dist/src/components/input/input-core.d.ts

@@ -1,8 +1,8 @@
 import { Constructor } from "../../composables/hybird-prop.js";
 import { CssSizeValue, buildSizeStyle } from "../../composables/css-size.js";
-import { FieldTooltipController, FieldTooltipValue } from "../../composables/field-tooltip.js";
 import { InputFormat, InputFormatOn } from "./input-format.js";
 import { InputColor, InputCssClass, InputModelValue, InputSize, InputType, InputValidationState, InputVariant } from "./input-types.js";
+import { FieldTooltipController, FieldTooltipValue } from "../../composables/field-tooltip.js";
 import { FieldValidationController } from "../../composables/field-validation.js";
 import { LitElement, TemplateResult, nothing } from "lit";
 //#region src/components/input/input-core.d.ts

package/dist/src/components/input/input-types.d.ts

@@ -1,6 +1,6 @@
 import { VisibilityProps } from "../../composables/visibility.js";
-import { MonoTooltipOptions } from "../tooltip/tooltip-types.js";
 import { InputFormat, InputFormatCtx, InputFormatOn } from "./input-format.js";
+import { MonoTooltipOptions } from "../tooltip/tooltip-types.js";
 //#region src/components/input/input-types.d.ts
 export type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'date' | 'time' | 'month' | 'week' | 'search' | 'file' | 'range';
 export type InputSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';

package/dist/src/components/otp/otp-core.d.ts

@@ -1,7 +1,7 @@
 import { Constructor } from "../../composables/hybird-prop.js";
 import { CssSizeValue } from "../../composables/css-size.js";
-import { FieldTooltipController, FieldTooltipValue } from "../../composables/field-tooltip.js";
 import { OtpColor, OtpCssClass, OtpGroups, OtpLabelPosition, OtpSize, OtpType, OtpValidationPosition, OtpValidationState, OtpVariant } from "./otp-types.js";
+import { FieldTooltipController, FieldTooltipValue } from "../../composables/field-tooltip.js";
 import { FieldValidationController } from "../../composables/field-validation.js";
 import { LitElement, TemplateResult, nothing } from "lit";
 //#region src/components/otp/otp-core.d.ts

package/dist/src/components/select/select-core.d.ts

@@ -1,8 +1,8 @@
 import { Constructor } from "../../composables/hybird-prop.js";
 import { CssSizeValue } from "../../composables/css-size.js";
 import { MonoSearchValue } from "../../search/data-search.js";
-import { FieldTooltipController, FieldTooltipValue } from "../../composables/field-tooltip.js";
 import { SelectColor, SelectCssClass, SelectDataSource, SelectDisplayGroup, SelectDisplayValue, SelectDropdownOptions, SelectItem, SelectLoadMore, SelectSize, SelectValidationState, SelectValue, SelectVariant } from "./select-types.js";
+import { FieldTooltipController, FieldTooltipValue } from "../../composables/field-tooltip.js";
 import { LateSlotWatcher } from "../../composables/light-slots.js";
 import { LitElement, TemplateResult } from "lit";
 //#region src/components/select/select-core.d.ts

package/dist/src/components/select/select-types.d.ts

@@ -2,8 +2,8 @@ import { PanelSizeProps } from "../../composables/css-size.js";
 import { DescribedError } from "../../utils/normalize-error.js";
 import { LoadMoreMode, MonoDataSource } from "../../composables/data-source-controller.js";
 import { VisibilityProps } from "../../composables/visibility.js";
-import { MonoSearchValue } from "../../search/data-search.js";
 import { MonoTooltipOptions } from "../tooltip/tooltip-types.js";
+import { MonoSearchValue } from "../../search/data-search.js";
 //#region src/components/select/select-types.d.ts
 /**
  * Sizes the popup PANEL only, independent of the field — the same object

package/dist/src/components/slider/slider-core.d.ts

@@ -1,8 +1,8 @@
 import { Constructor } from "../../composables/hybird-prop.js";
 import { CssSizeValue } from "../../composables/css-size.js";
-import { FieldTooltipController, FieldTooltipValue } from "../../composables/field-tooltip.js";
 import { InputFormat } from "../input/input-format.js";
 import { SliderColor, SliderCssClass, SliderFill, SliderSize, SliderType, SliderValidationState, SliderValue, SliderValueTooltip } from "./slider-types.js";
+import { FieldTooltipController, FieldTooltipValue } from "../../composables/field-tooltip.js";
 import { LitElement, TemplateResult, nothing } from "lit";
 //#region src/components/slider/slider-core.d.ts
 export type SliderSlotName = 'label' | 'helper';

package/dist/src/components/slider/slider-types.d.ts

@@ -1,6 +1,6 @@
 import { VisibilityProps } from "../../composables/visibility.js";
-import { MonoTooltipOptions } from "../tooltip/tooltip-types.js";
 import { InputFormat, InputFormatCtx } from "../input/input-format.js";
+import { MonoTooltipOptions } from "../tooltip/tooltip-types.js";
 //#region src/components/slider/slider-types.d.ts
 export type SliderSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
 export type SliderColor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'teal' | 'purple' | 'neutral' | 'dark';

package/dist/src/components/table/filter-suggestion.d.ts

@@ -0,0 +1,171 @@
+import { MonoSearchExprEntry } from "../../search/search-expr.js";
+import { MonoSearchValue } from "../../search/data-search.js";
+import { MonoFormController } from "../form/form-types.js";
+import { RowPredicate } from "../../search/filter-eval.js";
+import { ApplyGate } from "../../utils/data-source-apply.js";
+import { MonoTupleCount, MonoValueCount } from "../../utils/group-count.js";
+//#region src/components/table/filter-suggestion.d.ts
+/** Where a field's ALLOWED values come from — a DataSource, a store, an array, or with an explicit key. */
+export type MonoSuggestionValueSource = unknown | {
+  source: unknown;
+  /** The option row field holding the value (default: the form control's `keyValue`, then the row field). */
+  keyValue?: string;
+};
+/** `<mono-table-search :suggestion-filter.prop="…">`. */
+export interface MonoSuggestionFilter {
+  /** Row field → form key, e.g. `{ CodeDept: 'Dept' }`. Required. */
+  keys: Record<string, string>;
+  /**
+   * Allowed values per ROW field. Default: the option source of the form control
+   * bound under that key (`dataSource`, else `items`).
+   */
+  sources?: Record<string, MonoSuggestionValueSource>;
+  /**
+   * Where rows are COUNTED — a DataSource, a store or an array. Default: the
+   * grid's bound source. Its own `filter()` is NOT applied (it usually holds the
+   * very form clause being relaxed); put a fixed base in {@link filter}.
+   */
+  source?: unknown;
+  /** Search fields on {@link source}. Default: the grid's `searchValue()`. */
+  searchValue?: MonoSearchValue;
+  /**
+   * A fixed base for the probe, ANDed in — a devextreme filter array, or a
+   * getter returning one (a function taking NO arguments). For an array source a
+   * row predicate `(row) => boolean` works too.
+   */
+  filter?: unknown;
+  /** Search operation (default `contains`). */
+  searchOperation?: string;
+  /**
+   * How the rows are counted on a remote source.
+   * - `'apply'` (default): ONE `$apply=groupby((…),aggregate($count as count))` request
+   *   for every field — every value that has matches comes back with its count. Falls
+   *   back to a `$select` scan when the server rejects `$apply`.
+   * - `'count'`: one `$count` request PER allowed option of each field (`$top=0&$count=true`,
+   *   a bare number back). For servers without `$apply` and short option lists — no rows
+   *   are downloaded. Needs an OData store; capped by {@link maxCountRequests}.
+   */
+  requestType?: 'apply' | 'count';
+  /** `requestType: 'count'` only — most `$count` requests per field (default 30). */
+  maxCountRequests?: number;
+  /**
+   * Most offers kept, largest count first (default 10). The first is what
+   * `<mono-table-empty>`'s Adjust Filter button applies; all of them are listed in
+   * the dropdown beside it.
+   */
+  maxOffers?: number;
+  /**
+   * Log every probe step to the console — the search sent, the per-value counts,
+   * which candidates the field allows — and the reason when nothing is offered
+   * (a readonly field, an empty "all values" field, no candidates, none allowed).
+   */
+  debug?: boolean;
+}
+/** What a probe found — published on the grid, rendered by `<mono-table-empty>`. */
+export interface MonoFilterSuggestion {
+  /** Form key to change (`Dept`). */
+  key: string;
+  /** Row field it filters (`CodeDept`). */
+  field: string;
+  /** The suggested value (single), or the values being ADDED (array field). */
+  value: unknown;
+  /** Display text for {@link value}, from the control's `displayValue` when known. */
+  caption: string;
+  /**
+   * The field's label — `inputs[key].props.label` from `controlMonoForm`, else the
+   * bound control's `label`, else the form key. For wording: "… in another {label}".
+   */
+  label: string;
+  /** Rows that would match the search after adjusting. */
+  count: number;
+  /** The form value right now. */
+  current: unknown;
+  /** What Adjust writes: `form.setValues(values)`. */
+  values: Record<string, unknown>;
+}
+/** The slice of the grid a probe reads — public `MonoTableController` members only. */
+export interface ProbeGrid {
+  searchTerms: Array<{
+    value: string;
+    field?: string;
+  }>;
+  dataSource: unknown;
+  searchValue(): MonoSearchExprEntry[] | undefined;
+}
+export interface ProbeContext {
+  grid: ProbeGrid;
+  form: MonoFormController;
+  /** Remembers a backend that rejected `$apply` (see `createApplyGate`). */
+  gate: ApplyGate;
+}
+/** `field = v`, or an OR of them for several values. */
+export declare function equalsAny(field: string, values: readonly unknown[]): unknown;
+/**
+ * One case-insensitive search clause for a plain / path field.
+ *
+ * The probe's filter reaches the server as TEXT — inside an `$apply`, or a `$filter`
+ * written into the url — never through devextreme's compiler, so its usual
+ * `tolower` (`oDataFilterToLower`) never happens. It is written here instead:
+ * `contains(tolower(CompanyName),'shopee')`, as a raw one-element clause.
+ * A wildcard path comes back from `toODataClause` as an `any()` lambda that is
+ * already lowercased.
+ */
+export declare function lowerSearchClause(field: string, op: string, value: string): unknown;
+/** The search as a filter array (remote) — `null` when there is nothing to search. */
+export declare function searchFilterFor(terms: ProbeGrid['searchTerms'], entries: readonly MonoSearchExprEntry[], operation?: string): unknown;
+/** The search as a row predicate (array) — `null` when there is nothing to search. */
+export declare function searchPredicateFor(terms: ProbeGrid['searchTerms'], entries: readonly MonoSearchExprEntry[], operation?: string): RowPredicate | null;
+/**
+ * The probe filter for relaxing `field`: every OTHER mapped field pinned to its
+ * current form value (an empty value means "all" and pins nothing), ANDed with
+ * the search and the fixed base. `field` itself stays free.
+ */
+export declare function buildProbeFilter(field: string, keys: Record<string, string>, values: Record<string, unknown>, search: unknown, base: unknown): unknown;
+type ProbeLog = ((step: string, data?: unknown) => void) | undefined;
+/**
+ * Per-value counts for relaxing `field` alone: the combos where every OTHER relaxed
+ * field still equals its form value, summed by `field`'s value.
+ */
+export declare function sliceForField(combos: readonly MonoTupleCount[], field: string, others: ReadonlyArray<{
+  field: string;
+  current: unknown;
+}>): MonoValueCount[];
+/** The bound form control's surface the probe reads (select / tag-input / dropdown-table). */
+interface FormControlLike {
+  readonly?: boolean;
+  disabled?: boolean;
+  dataSource?: unknown;
+  items?: unknown[];
+  keyValue?: string;
+  displayValue?: string | ((item: any) => string);
+  label?: string;
+}
+/**
+ * Which `candidates` the field allows, each with its caption. `null` when there is
+ * NO source to check against (nothing bound, nothing configured) — the caller
+ * then trusts the counts.
+ */
+export declare function allowedValues(spec: MonoSuggestionValueSource | undefined, control: FormControlLike | null, field: string, candidates: readonly unknown[], log?: ProbeLog): Promise<Map<string, {
+  value: unknown;
+  caption: string;
+}> | null>;
+/**
+ * EVERY option the field offers (keyed by `String(value)`, with its caption) — the
+ * candidate list for `requestType: 'count'`. Same source resolution as
+ * {@link allowedValues}; a DataSource is read with its own `filter()`, so the
+ * per-user restriction applies. `null` when there is no option source at all.
+ */
+export declare function optionValues(spec: MonoSuggestionValueSource | undefined, control: FormControlLike | null, field: string, log?: ProbeLog): Promise<Map<string, {
+  value: unknown;
+  caption: string;
+}> | null>;
+/**
+ * Probe every mapped field and return EVERY single-field adjustment that would bring
+ * rows back and that the user may pick — largest count first, so `[0]` is the best.
+ * Empty when there is nothing to offer.
+ */
+export declare function probeFilterSuggestions(cfg: MonoSuggestionFilter, ctx: ProbeContext): Promise<MonoFilterSuggestion[]>;
+/** The single best offer — {@link probeFilterSuggestions}`[0]`, or `null`. */
+export declare function probeFilterSuggestion(cfg: MonoSuggestionFilter, ctx: ProbeContext): Promise<MonoFilterSuggestion | null>;
+//#endregion
+export {};

package/dist/src/components/table/index.d.ts

@@ -5,10 +5,11 @@ import { MonoExportColumn, MonoExportFormat, MonoExportFormatOptions, MonoExport
 import { MonoImportAmbiguity, MonoImportChange, MonoImportColumn, MonoImportMatch, MonoImportNumberFormat, MonoImportOptions, MonoImportRejection, MonoImportResult, MonoImportType, MonoImportValueType } from "../../import/types.js";
 import { TableDetailClickEvent, TableDetailClickEventDetail, TableDetailEvents } from "./mono-table-detail-core.js";
 import { TableCheckboxChangeEvent, TableCheckboxChangeEventDetail, TableCheckboxEvents, TableCheckboxType } from "./mono-table-checkbox-core.js";
-import { TableEmptyEvents, TableEmptyReloadEvent, TableEmptyReloadEventDetail } from "./mono-table-empty-core.js";
+import { MonoSearchCustomCtx, MonoSearchCustomResult, MonoSearchExpr, MonoSearchExprCustom, MonoSearchExprEntry, ResolveSearchOptions, expandWildcard, isWildcardPattern, normalizeSearchExpr, plainSearchColumns, resolveSearchEntries } from "../../search/search-expr.js";
+import { MonoFilterSuggestion, MonoSuggestionFilter, MonoSuggestionValueSource } from "./filter-suggestion.js";
+import { MonoEmptySuggestionOptions, TableEmptyAdjustEvent, TableEmptyAdjustEventDetail, TableEmptyEvents, TableEmptyReloadEvent, TableEmptyReloadEventDetail } from "./mono-table-empty-core.js";
 import { TableErrorCloseEvent, TableErrorCloseEventDetail, TableErrorEvents, TableErrorReloadEvent, TableErrorReloadEventDetail } from "./mono-table-error-core.js";
 import { MonoDataSourceOptions, MonoOdataOptions } from "../../utils/data-source-options.js";
-import { MonoSearchCustomCtx, MonoSearchCustomResult, MonoSearchExpr, MonoSearchExprCustom, MonoSearchExprEntry, ResolveSearchOptions, expandWildcard, isWildcardPattern, normalizeSearchExpr, plainSearchColumns, resolveSearchEntries } from "../../search/search-expr.js";
 import { GroupPageInfo, MonoCellChange, MonoCheckConfig, MonoCheckHandle, MonoCheckMode, MonoColumn, MonoColumnDef, MonoColumnHandle, MonoColumnSort, MonoColumnValue, MonoDataGridOptions, MonoDetailEl, MonoDetailHandle, MonoDisplayRow, MonoDistinctValuesContext, MonoEditableTrigger, MonoFormConfig, MonoFormHandle, MonoFormOp, MonoGridSource, MonoGridStore, MonoGroupMeta, MonoSearchTerm, MonoServerGroupCtx, MonoServerGroupSource, MonoSetColumnFilterOptions, MonoSetSortOptions, MonoStagedChange, MonoStorePush, MonoSummaryConfig, MonoSummaryFieldSpec, MonoSummaryHandle, MonoSummaryRecalculate, MonoSummaryResult, MonoSummarySpec, MonoSummaryType, MonoTableController, SortOrder, controlMonoTable as monoDataGrid } from "./mono-data-grid.js";
 import { MonoArraySourceOptions, monoArraySource } from "./array-source.js";
 import { FieldSegment, ODataClause, ParsedFieldPath, getFieldValue, isPath, mergePatch, parseFieldPath, setFieldValue, toODataClause, toODataSelector } from "../../search/field-path.js";
@@ -25,5 +26,5 @@ import { MonoTableLoading } from "./mono-table-loading.js";
 import { MonoTableSummary } from "./mono-table-summary.js";
 import { MonoTableDetail } from "./mono-table-detail.js";
 import { MonoTableCheckbox } from "./mono-table-checkbox.js";
-import { TableCheckboxProps, TableDetailProps, TableEmptyProps, TableErrorProps, TableInfoProps, TableLoadingProps, TablePageSizeProps, TablePagingProps, TableSearchProps, TableSortProps, TableSummaryProps, TableThProps, TableThSort } from "./table-types.js";
-export { DEFAULT_ERROR_MESSAGES, type DescribedError, type FieldSegment, type GroupPageInfo, type MonoArraySourceOptions, type MonoCellChange, type MonoCheckConfig, type MonoCheckHandle, type MonoCheckMode, type MonoColumn, type MonoColumnDef, type MonoColumnHandle, type MonoColumnSort, type MonoColumnValue, type MonoDataGridOptions, type MonoDataSourceOptions, type MonoDetailEl, type MonoDetailHandle, type MonoDisplayRow, type MonoDistinctValuesContext, type MonoEditableTrigger, type MonoErrorMessageKey, type MonoErrorMessages, type MonoExportColumn, type MonoExportFormat, type MonoExportFormatOptions, type MonoExportOptions, type MonoExportResult, type MonoExportStyle, type MonoExportStyles, type MonoFormConfig, type MonoFormHandle, type MonoFormOp, type MonoGridSource, type MonoGridStore, type MonoGroupMeta, type MonoGroupNode, type MonoImportAmbiguity, type MonoImportChange, type MonoImportColumn, type MonoImportMatch, type MonoImportNumberFormat, type MonoImportOptions, type MonoImportRejection, type MonoImportResult, type MonoImportType, type MonoImportValueType, type MonoOdataOptions, type MonoSearchCustomCtx, type MonoSearchCustomResult, type MonoSearchExpr, type MonoSearchExprCustom, type MonoSearchExprEntry, type MonoSearchTerm, type MonoServerGroupCtx, type MonoServerGroupSource, type MonoSetColumnFilterOptions, type MonoSetSortOptions, type MonoStagedChange, type MonoStorePush, type MonoSummaryConfig, type MonoSummaryFieldSpec, type MonoSummaryHandle, type MonoSummaryRecalculate, type MonoSummaryResult, type MonoSummarySpec, type MonoSummaryType, MonoTableCheckbox, type MonoTableController, MonoTableDetail, MonoTableEmpty, MonoTableError, MonoTableInfo, MonoTableLoading, MonoTablePageSize, MonoTablePaging, MonoTablePagingGroup, MonoTableSearch, MonoTableSort, MonoTableSummary, MonoTableTh, type ODataClause, type ParsedFieldPath, type ResolveSearchOptions, type SortOrder, type TableCheckboxChangeEvent, type TableCheckboxChangeEventDetail, type TableCheckboxEvents, type TableCheckboxProps, type TableCheckboxType, type TableDetailClickEvent, type TableDetailClickEventDetail, type TableDetailEvents, type TableDetailProps, type TableEmptyEvents, type TableEmptyProps, type TableEmptyReloadEvent, type TableEmptyReloadEventDetail, type TableErrorCloseEvent, type TableErrorCloseEventDetail, type TableErrorEvents, type TableErrorProps, type TableErrorReloadEvent, type TableErrorReloadEventDetail, type TableInfoProps, type TableLoadingProps, type TablePageSizeProps, type TablePagingProps, type TableSearchProps, type TableSortProps, type TableSummaryProps, type TableThProps, type TableThSort, buildGroups, collectGroupPaths, monoDataGrid as controlMonoTable, describeError, errorStatus, expandWildcard, flattenLeaves, getFieldValue, isGroupNode, isPath, isWildcardPattern, mergePatch, monoArraySource, monoDataGrid, normalizeError, normalizeSearchExpr, parseFieldPath, plainSearchColumns, resolveErrorMessages, resolveSearchEntries, setErrorMessages, setFieldValue, toODataClause, toODataSelector };
+import { TableCheckboxProps, TableDetailProps, TableEmptyProps, TableErrorProps, TableInfoProps, TableLoadingProps, TablePageSizeProps, TablePagingProps, TableSearchEvents, TableSearchProps, TableSortProps, TableSummaryProps, TableThProps, TableThSort } from "./table-types.js";
+export { DEFAULT_ERROR_MESSAGES, type DescribedError, type FieldSegment, type GroupPageInfo, type MonoArraySourceOptions, type MonoCellChange, type MonoCheckConfig, type MonoCheckHandle, type MonoCheckMode, type MonoColumn, type MonoColumnDef, type MonoColumnHandle, type MonoColumnSort, type MonoColumnValue, type MonoDataGridOptions, type MonoDataSourceOptions, type MonoDetailEl, type MonoDetailHandle, type MonoDisplayRow, type MonoDistinctValuesContext, type MonoEditableTrigger, type MonoEmptySuggestionOptions, type MonoErrorMessageKey, type MonoErrorMessages, type MonoExportColumn, type MonoExportFormat, type MonoExportFormatOptions, type MonoExportOptions, type MonoExportResult, type MonoExportStyle, type MonoExportStyles, type MonoFilterSuggestion, type MonoFormConfig, type MonoFormHandle, type MonoFormOp, type MonoGridSource, type MonoGridStore, type MonoGroupMeta, type MonoGroupNode, type MonoImportAmbiguity, type MonoImportChange, type MonoImportColumn, type MonoImportMatch, type MonoImportNumberFormat, type MonoImportOptions, type MonoImportRejection, type MonoImportResult, type MonoImportType, type MonoImportValueType, type MonoOdataOptions, type MonoSearchCustomCtx, type MonoSearchCustomResult, type MonoSearchExpr, type MonoSearchExprCustom, type MonoSearchExprEntry, type MonoSearchTerm, type MonoServerGroupCtx, type MonoServerGroupSource, type MonoSetColumnFilterOptions, type MonoSetSortOptions, type MonoStagedChange, type MonoStorePush, type MonoSuggestionFilter, type MonoSuggestionValueSource, type MonoSummaryConfig, type MonoSummaryFieldSpec, type MonoSummaryHandle, type MonoSummaryRecalculate, type MonoSummaryResult, type MonoSummarySpec, type MonoSummaryType, MonoTableCheckbox, type MonoTableController, MonoTableDetail, MonoTableEmpty, MonoTableError, MonoTableInfo, MonoTableLoading, MonoTablePageSize, MonoTablePaging, MonoTablePagingGroup, MonoTableSearch, MonoTableSort, MonoTableSummary, MonoTableTh, type ODataClause, type ParsedFieldPath, type ResolveSearchOptions, type SortOrder, type TableCheckboxChangeEvent, type TableCheckboxChangeEventDetail, type TableCheckboxEvents, type TableCheckboxProps, type TableCheckboxType, type TableDetailClickEvent, type TableDetailClickEventDetail, type TableDetailEvents, type TableDetailProps, type TableEmptyAdjustEvent, type TableEmptyAdjustEventDetail, type TableEmptyEvents, type TableEmptyProps, type TableEmptyReloadEvent, type TableEmptyReloadEventDetail, type TableErrorCloseEvent, type TableErrorCloseEventDetail, type TableErrorEvents, type TableErrorProps, type TableErrorReloadEvent, type TableErrorReloadEventDetail, type TableInfoProps, type TableLoadingProps, type TablePageSizeProps, type TablePagingProps, type TableSearchEvents, type TableSearchProps, type TableSortProps, type TableSummaryProps, type TableThProps, type TableThSort, buildGroups, collectGroupPaths, monoDataGrid as controlMonoTable, describeError, errorStatus, expandWildcard, flattenLeaves, getFieldValue, isGroupNode, isPath, isWildcardPattern, mergePatch, monoArraySource, monoDataGrid, normalizeError, normalizeSearchExpr, parseFieldPath, plainSearchColumns, resolveErrorMessages, resolveSearchEntries, setErrorMessages, setFieldValue, toODataClause, toODataSelector };

package/dist/src/components/table/index.shadow.d.ts

@@ -4,9 +4,10 @@ import { MonoGroupNode, buildGroups, collectGroupPaths, flattenLeaves, isGroupNo
 import { MonoTableControllerCore } from "./table-controller-core.js";
 import { MonoTableDetailCore, TableDetailClickEvent, TableDetailClickEventDetail, TableDetailEvents } from "./mono-table-detail-core.js";
 import { MonoTableCheckboxCore, TableCheckboxChangeEvent, TableCheckboxChangeEventDetail, TableCheckboxEvents, TableCheckboxType } from "./mono-table-checkbox-core.js";
-import { MonoTableEmptyCore, TableEmptyEvents, TableEmptyReloadEvent, TableEmptyReloadEventDetail } from "./mono-table-empty-core.js";
-import { MonoTableErrorCore, TableErrorCloseEvent, TableErrorCloseEventDetail, TableErrorEvents, TableErrorReloadEvent, TableErrorReloadEventDetail } from "./mono-table-error-core.js";
 import { MonoSearchCustomCtx, MonoSearchCustomResult, MonoSearchExpr, MonoSearchExprCustom, MonoSearchExprEntry, ResolveSearchOptions, expandWildcard, isWildcardPattern, normalizeSearchExpr, plainSearchColumns, resolveSearchEntries } from "../../search/search-expr.js";
+import { MonoFilterSuggestion, MonoSuggestionFilter, MonoSuggestionValueSource } from "./filter-suggestion.js";
+import { MonoEmptySuggestionOptions, MonoTableEmptyCore, TableEmptyAdjustEvent, TableEmptyAdjustEventDetail, TableEmptyEvents, TableEmptyReloadEvent, TableEmptyReloadEventDetail } from "./mono-table-empty-core.js";
+import { MonoTableErrorCore, TableErrorCloseEvent, TableErrorCloseEventDetail, TableErrorEvents, TableErrorReloadEvent, TableErrorReloadEventDetail } from "./mono-table-error-core.js";
 import { GroupPageInfo, MonoCellChange, MonoCheckConfig, MonoCheckHandle, MonoCheckMode, MonoColumn, MonoColumnDef, MonoColumnHandle, MonoColumnSort, MonoColumnValue, MonoDataGridOptions, MonoDetailEl, MonoDetailHandle, MonoDisplayRow, MonoEditableTrigger, MonoGridSource, MonoGridStore, MonoGroupMeta, MonoSearchTerm, MonoServerGroupCtx, MonoServerGroupSource, MonoStagedChange, MonoSummaryConfig, MonoSummaryFieldSpec, MonoSummaryHandle, MonoSummaryRecalculate, MonoSummaryResult, MonoSummarySpec, MonoSummaryType, MonoTableController, SortOrder, controlMonoTable as monoDataGrid } from "./mono-data-grid.js";
 import { MonoArraySourceOptions, monoArraySource } from "./array-source.js";
 import { MonoTableSearchCore, TableSearchIconName } from "./mono-table-search-core.js";
@@ -18,7 +19,7 @@ import { MonoTableSortCore, TableSortIconName, TableSortSlotName } from "./mono-
 import { MonoTableThCore, TableThAlign, TableThIconName, TableThSlotName } from "./mono-table-th-core.js";
 import { MonoTableLoadingCore } from "./mono-table-loading-core.js";
 import { MonoTableSummaryCore } from "./mono-table-summary-core.js";
-import { TableCheckboxProps, TableDetailProps, TableEmptyProps, TableErrorProps, TableInfoProps, TableLoadingProps, TablePageSizeProps, TablePagingProps, TableSearchProps, TableSortProps, TableSummaryProps, TableThProps, TableThSort } from "./table-types.js";
+import { TableCheckboxProps, TableDetailProps, TableEmptyProps, TableErrorProps, TableInfoProps, TableLoadingProps, TablePageSizeProps, TablePagingProps, TableSearchEvents, TableSearchProps, TableSortProps, TableSummaryProps, TableThProps, TableThSort } from "./table-types.js";
 import { MonoTableSearchShadow } from "./mono-table-search.shadow.js";
 import { MonoTableSortShadow } from "./mono-table-sort.shadow.js";
 import { MonoTablePagingShadow } from "./mono-table-paging.shadow.js";
@@ -32,4 +33,4 @@ import { MonoTableLoadingShadow } from "./mono-table-loading.shadow.js";
 import { MonoTableSummaryShadow } from "./mono-table-summary.shadow.js";
 import { MonoTableDetailShadow } from "./mono-table-detail.shadow.js";
 import { MonoTableCheckboxShadow } from "./mono-table-checkbox.shadow.js";
-export { DEFAULT_ERROR_MESSAGES, type DescribedError, type GroupPageInfo, type MonoArraySourceOptions, type MonoCellChange, type MonoCheckConfig, type MonoCheckHandle, type MonoCheckMode, type MonoColumn, type MonoColumnDef, type MonoColumnHandle, type MonoColumnSort, type MonoColumnValue, type MonoDataGridOptions, type MonoDetailEl, type MonoDetailHandle, type MonoDisplayRow, type MonoEditableTrigger, type MonoErrorMessageKey, type MonoErrorMessages, type MonoGridSource, type MonoGridStore, type MonoGroupMeta, type MonoGroupNode, type MonoSearchCustomCtx, type MonoSearchCustomResult, type MonoSearchExpr, type MonoSearchExprCustom, type MonoSearchExprEntry, type MonoSearchTerm, type MonoServerGroupCtx, type MonoServerGroupSource, type MonoStagedChange, type MonoSummaryConfig, type MonoSummaryFieldSpec, type MonoSummaryHandle, type MonoSummaryRecalculate, type MonoSummaryResult, type MonoSummarySpec, type MonoSummaryType, MonoTableCheckboxCore, MonoTableCheckboxShadow, type MonoTableController, MonoTableControllerCore, MonoTableDetailCore, MonoTableDetailShadow, MonoTableEmptyCore, MonoTableEmptyShadow, MonoTableErrorCore, MonoTableErrorShadow, MonoTableInfoCore, MonoTableInfoShadow, MonoTableLoadingCore, MonoTableLoadingShadow, MonoTablePageSizeCore, MonoTablePageSizeShadow, MonoTablePagingCore, MonoTablePagingGroupCore, MonoTablePagingGroupShadow, MonoTablePagingShadow, MonoTableSearchCore, MonoTableSearchShadow, MonoTableSortCore, MonoTableSortShadow, MonoTableSummaryCore, MonoTableSummaryShadow, MonoTableThCore, MonoTableThShadow, type ResolveSearchOptions, type SortOrder, type TableCheckboxChangeEvent, type TableCheckboxChangeEventDetail, type TableCheckboxEvents, type TableCheckboxProps, type TableCheckboxType, type TableDetailClickEvent, type TableDetailClickEventDetail, type TableDetailEvents, type TableDetailProps, type TableEmptyEvents, type TableEmptyProps, type TableEmptyReloadEvent, type TableEmptyReloadEventDetail, type TableErrorCloseEvent, type TableErrorCloseEventDetail, type TableErrorEvents, type TableErrorProps, type TableErrorReloadEvent, type TableErrorReloadEventDetail, type TableInfoProps, type TableLoadingProps, type TablePageSizeProps, type TablePagingProps, type TableSearchIconName, type TableSearchProps, type TableSortIconName, type TableSortProps, type TableSortSlotName, type TableSummaryProps, type TableThAlign, type TableThIconName, type TableThProps, type TableThSlotName, type TableThSort, buildGroups, collectGroupPaths, describeError, errorStatus, expandWildcard, flattenLeaves, isGroupNode, isWildcardPattern, monoArraySource, monoDataGrid, normalizeError, normalizeSearchExpr, plainSearchColumns, resolveErrorMessages, resolveSearchEntries, setErrorMessages };
+export { DEFAULT_ERROR_MESSAGES, type DescribedError, type GroupPageInfo, type MonoArraySourceOptions, type MonoCellChange, type MonoCheckConfig, type MonoCheckHandle, type MonoCheckMode, type MonoColumn, type MonoColumnDef, type MonoColumnHandle, type MonoColumnSort, type MonoColumnValue, type MonoDataGridOptions, type MonoDetailEl, type MonoDetailHandle, type MonoDisplayRow, type MonoEditableTrigger, type MonoEmptySuggestionOptions, type MonoErrorMessageKey, type MonoErrorMessages, type MonoFilterSuggestion, type MonoGridSource, type MonoGridStore, type MonoGroupMeta, type MonoGroupNode, type MonoSearchCustomCtx, type MonoSearchCustomResult, type MonoSearchExpr, type MonoSearchExprCustom, type MonoSearchExprEntry, type MonoSearchTerm, type MonoServerGroupCtx, type MonoServerGroupSource, type MonoStagedChange, type MonoSuggestionFilter, type MonoSuggestionValueSource, type MonoSummaryConfig, type MonoSummaryFieldSpec, type MonoSummaryHandle, type MonoSummaryRecalculate, type MonoSummaryResult, type MonoSummarySpec, type MonoSummaryType, MonoTableCheckboxCore, MonoTableCheckboxShadow, type MonoTableController, MonoTableControllerCore, MonoTableDetailCore, MonoTableDetailShadow, MonoTableEmptyCore, MonoTableEmptyShadow, MonoTableErrorCore, MonoTableErrorShadow, MonoTableInfoCore, MonoTableInfoShadow, MonoTableLoadingCore, MonoTableLoadingShadow, MonoTablePageSizeCore, MonoTablePageSizeShadow, MonoTablePagingCore, MonoTablePagingGroupCore, MonoTablePagingGroupShadow, MonoTablePagingShadow, MonoTableSearchCore, MonoTableSearchShadow, MonoTableSortCore, MonoTableSortShadow, MonoTableSummaryCore, MonoTableSummaryShadow, MonoTableThCore, MonoTableThShadow, type ResolveSearchOptions, type SortOrder, type TableCheckboxChangeEvent, type TableCheckboxChangeEventDetail, type TableCheckboxEvents, type TableCheckboxProps, type TableCheckboxType, type TableDetailClickEvent, type TableDetailClickEventDetail, type TableDetailEvents, type TableDetailProps, type TableEmptyAdjustEvent, type TableEmptyAdjustEventDetail, type TableEmptyEvents, type TableEmptyProps, type TableEmptyReloadEvent, type TableEmptyReloadEventDetail, type TableErrorCloseEvent, type TableErrorCloseEventDetail, type TableErrorEvents, type TableErrorProps, type TableErrorReloadEvent, type TableErrorReloadEventDetail, type TableInfoProps, type TableLoadingProps, type TablePageSizeProps, type TablePagingProps, type TableSearchEvents, type TableSearchIconName, type TableSearchProps, type TableSortIconName, type TableSortProps, type TableSortSlotName, type TableSummaryProps, type TableThAlign, type TableThIconName, type TableThProps, type TableThSlotName, type TableThSort, buildGroups, collectGroupPaths, describeError, errorStatus, expandWildcard, flattenLeaves, isGroupNode, isWildcardPattern, monoArraySource, monoDataGrid, normalizeError, normalizeSearchExpr, plainSearchColumns, resolveErrorMessages, resolveSearchEntries, setErrorMessages };

package/dist/src/components/table/mono-data-grid.d.ts

@@ -7,12 +7,13 @@ import { MonoExportOptions, MonoExportResult } from "../../export/types.js";
 import { MonoImportOptions, MonoImportResult } from "../../import/types.js";
 import { TableDetailEvents } from "./mono-table-detail-core.js";
 import { TableCheckboxEvents } from "./mono-table-checkbox-core.js";
-import { TableEmptyEvents } from "./mono-table-empty-core.js";
-import { TableErrorEvents } from "./mono-table-error-core.js";
 import { MaybeReactive } from "../../composables/reactive.js";
-import { MonoDataSourceOptions, MonoOdataOptions, MonoSourceSortEntry } from "../../utils/data-source-options.js";
 import { MonoSearchExprEntry } from "../../search/search-expr.js";
 import { MonoSearchFieldsAliases, MonoSearchValue } from "../../search/data-search.js";
+import { MonoFilterSuggestion } from "./filter-suggestion.js";
+import { TableEmptyEvents } from "./mono-table-empty-core.js";
+import { TableErrorEvents } from "./mono-table-error-core.js";
+import { MonoDataSourceOptions, MonoOdataOptions, MonoSourceSortEntry } from "../../utils/data-source-options.js";
 import { MonoFilterBuilderOptions, MonoFilterController } from "../filter/filter-types.js";
 //#region src/components/table/mono-data-grid.d.ts
 /**
@@ -1423,6 +1424,24 @@ export interface MonoTableController<T = any> {
   searchExpr(): MonoSearchExprEntry[] | undefined;
   /** The live search terms (empty when unsearched). */
   searchTerms: MonoSearchTerm[];
+  /**
+   * "N rows match this search under a different filter value" — published by
+   * `<mono-table-search :suggestion-filter>` after a search came back empty, and
+   * rendered by `<mono-table-empty>` as an **Adjust Filter** offer. `null` when
+   * there is nothing to suggest. Cleared by every new search.
+   */
+  filterSuggestion: MonoFilterSuggestion | null;
+  /**
+   * EVERY offer the probe found, largest count first — `filterSuggestion` is `[0]`.
+   * `<mono-table-empty>` lists them in the dropdown beside Adjust Filter. Empty when
+   * there is nothing to suggest.
+   */
+  filterSuggestions: MonoFilterSuggestion[];
+  /**
+   * Publish the offers (a list, largest first, or a single one) — or clear them with
+   * `null` / `[]`. Notifies on change only.
+   */
+  setFilterSuggestion(next: MonoFilterSuggestion | MonoFilterSuggestion[] | null): void;
   /**
    * An explicit filter of the grid's own — what the slotted filter builder
    * writes. One LAYER of the query, not the whole of it: it is AND-ed with the

package/dist/src/components/table/mono-table-empty-core.d.ts

@@ -1,5 +1,7 @@
 import { Constructor } from "../../composables/hybird-prop.js";
 import { MonoTableControllerCoreInterface } from "./table-controller-core.js";
+import { MonoFormController } from "../form/form-types.js";
+import { MonoFilterSuggestion } from "./filter-suggestion.js";
 import { MonoTableController } from "./mono-data-grid.js";
 import { LitElement, TemplateResult, nothing } from "lit";
 //#region src/components/table/mono-table-empty-core.d.ts
@@ -8,11 +10,39 @@ export interface TableEmptyReloadEventDetail {
   grid: MonoTableController;
 }
 export type TableEmptyReloadEvent = CustomEvent<TableEmptyReloadEventDetail>;
+/**
+ * `detail` of the `adjust` event — the **Adjust Filter** button was pressed and
+ * `values` have ALREADY been written into the form. The event is cancelable:
+ * its default action is `grid.refresh()`; call `preventDefault()` to run your own
+ * query instead (a page that builds its `$filter` by hand from the form).
+ */
+export interface TableEmptyAdjustEventDetail extends MonoFilterSuggestion {
+  form: MonoFormController;
+  grid: MonoTableController;
+}
+export type TableEmptyAdjustEvent = CustomEvent<TableEmptyAdjustEventDetail>;
 /** Events emitted by `<mono-table-empty>` (feeds the generated Vue types). */
 export interface TableEmptyEvents {
   reload: TableEmptyReloadEvent;
+  adjust: TableEmptyAdjustEvent;
   'mno-reload': TableEmptyReloadEvent;
   mnoReload: TableEmptyReloadEvent;
+  'mno-adjust': TableEmptyAdjustEvent;
+  mnoAdjust: TableEmptyAdjustEvent;
+}
+/** `<mono-table-empty :suggestion-filter.prop="…">` — how a filter suggestion is presented. */
+export interface MonoEmptySuggestionOptions {
+  /**
+   * The line that REPLACES the subtitle while a suggestion is shown. A function
+   * receives the row count and the whole suggestion; a string substitutes
+   * `{count}`, `{value}`, `{label}`, `{key}` and `{field}`.
+   */
+  message?: string | ((count: number, suggestion: MonoFilterSuggestion) => string);
+  /**
+   * Each row of the dropdown beside Adjust Filter (shown when there is more than one
+   * offer). Same forms as {@link message}. Default `'Adjust {label} to "{value}"'`.
+   */
+  option?: string | ((count: number, suggestion: MonoFilterSuggestion) => string);
 }
 /** Public surface added by the empty-state core mixin. */
 export declare class MonoTableEmptyCoreInterface extends MonoTableControllerCoreInterface {
@@ -21,6 +51,13 @@ export declare class MonoTableEmptyCoreInterface extends MonoTableControllerCore
   subtitle: string;
   reload: boolean;
   reloadLabel: string;
+  /** The filter form an **Adjust Filter** writes into. */
+  dataForm?: MonoFormController;
+  /** Alias of {@link dataForm}. */
+  controlForm?: MonoFormController;
+  /** Presentation of the filter suggestion — `{ message }`. */
+  suggestionFilter?: MonoEmptySuggestionOptions | null;
+  adjustLabel: string;
   height?: string;
   minHeight?: string;
   maxHeight?: string;

package/dist/src/components/table/mono-table-search-core.d.ts

@@ -1,8 +1,10 @@
 import { Constructor } from "../../composables/hybird-prop.js";
 import { CssSizeValue } from "../../composables/css-size.js";
 import { MonoTableControllerCoreInterface } from "./table-controller-core.js";
-import { MonoSearchValue } from "../../search/data-search.js";
 import { InputColor, InputCssClass, InputSize, InputValidationState, InputVariant } from "../input/input-types.js";
+import { MonoSearchValue } from "../../search/data-search.js";
+import { MonoFormController } from "../form/form-types.js";
+import { MonoSuggestionFilter } from "./filter-suggestion.js";
 import { LitElement, TemplateResult } from "lit";
 //#region src/components/table/mono-table-search-core.d.ts
 /** Per-build icon hooks the search core delegates to. */
@@ -13,6 +15,14 @@ export declare class MonoTableSearchCoreInterface extends MonoTableControllerCor
   searchValue: MonoSearchValue;
   /** Alias of {@link searchValue}, under the grid option's older name. */
   searchExpr: MonoSearchValue;
+  /** Passing it (even `''`) switches the box to MANUAL mode — see the class docs. */
+  modelValue?: string | null;
+  /** The filter form (`controlMonoForm`) a {@link suggestionFilter} reads and relaxes. */
+  dataForm?: MonoFormController;
+  /** Alias of {@link dataForm}. */
+  controlForm?: MonoFormController;
+  /** Map row fields onto form keys to offer "N rows under a different filter". */
+  suggestionFilter?: MonoSuggestionFilter | null;
   placeholder: string;
   disabled: boolean;
   debounce: number;
@@ -66,8 +76,17 @@ export declare class MonoTableSearchCoreInterface extends MonoTableControllerCor
  *
  * Deliberately NOT taken from `InputProps`: `type` (pinned to `search`),
  * `required` / `pattern` / `min` / `max` / `step` (form-submit constraints with no
- * meaning for a filter), and `value` / `modelValue` — the debounce below plus the
- * controller own the search term.
+ * meaning for a filter), and `value`.
+ *
+ * **Two modes, picked by `modelValue`:**
+ * - *grid* (no `model-value`) — the debounce below plus the controller own the
+ *   search term, exactly as before;
+ * - *manual* (`model-value` passed, even `''`) — a controlled field: it emits
+ *   `mono-input`'s `input` / `change` / `clear` (same detail shape) immediately and
+ *   NEVER touches the grid's search (`search-value`, `suggestion` and
+ *   `multi-context` go inert). The consumer runs the search itself.
+ *
+ * `input` / `change` / `clear` fire in grid mode too, so a listener works either way.
  *
  * The magnifier and clear glyphs are delegated to `renderIcon()` (light: UnoCSS
  * `.mono-icon i-mdi-*`; shadow: inline SVG) so the chrome is otherwise identical.