@salesforce/ui-bundle-template-app-angular-template-b2x 11.30.0

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/date-range-filter/date-range-filter.component.html

@@ -0,0 +1,11 @@
+<app-filter-field-wrapper [label]="config().label" [helpText]="config().helpText">
+	<app-date-range-picker
+		class="w-full"
+		startPlaceholder="Start"
+		endPlaceholder="End"
+		[readonly]="true"
+		[max]="maxDate()"
+		[value]="range()"
+		(valueChange)="onRangeChange($event)"
+	/>
+</app-filter-field-wrapper>

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/date-range-filter/date-range-filter.component.ts

@@ -0,0 +1,69 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component, computed, inject, input } from "@angular/core";
+// Base-app UI wrapper, inherited (not recreated) by this feature. Post-compose
+// it lands at uiBundles/<target>/src/app/components/ui/date-range-picker/..., three levels up.
+import {
+	DateRange,
+	DateRangePickerComponent,
+} from "../../../../../components/ui/date-range-picker/date-range-picker.component";
+import { ObjectSearchStateService } from "../../../object-search-state.service";
+import type { FilterFieldConfig, FilterFieldType } from "../../../utils/filter-utils";
+import { toDate, toDateString } from "../date-filter/date-filter.component";
+import { FilterFieldWrapperComponent } from "../filter-field-wrapper/filter-field-wrapper.component";
+
+/**
+ * Date range filter — a single two-ended range picker. Emits a `daterange`
+ * (or `datetimerange`) filter with `min` / `max` as `YYYY-MM-DD` strings; the
+ * filter builder wires each end into a `gte` / `lte` clause.
+ *
+ * Thin bridge over the base `app-date-range-picker` (Material's
+ * `mat-date-range-picker`): it maps the picker's `DateRange<Date>` value to and
+ * from the `min` / `max` string split the filter state stores.
+ */
+@Component({
+	selector: "app-date-range-filter",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [DateRangePickerComponent, FilterFieldWrapperComponent],
+	templateUrl: "./date-range-filter.component.html",
+})
+export class DateRangeFilterComponent {
+	private readonly state = inject(ObjectSearchStateService);
+
+	/** Field config: `field`, `label`, `helpText`, ... */
+	readonly config = input.required<FilterFieldConfig>();
+	/** Underlying filter type — `'daterange'` (default) or `'datetimerange'`. */
+	readonly filterType = input<FilterFieldType>("daterange");
+
+	private readonly active = computed(() => this.state.filterFor(this.config().field));
+
+	/** The active filter's `min` / `max` strings surfaced as a picker range. */
+	protected readonly range = computed<DateRange<Date>>(
+		() => new DateRange(toDate(this.active()?.min), toDate(this.active()?.max)),
+	);
+
+	/** Cap the picker at today when the field can't hold a future date. */
+	protected readonly maxDate = computed<Date | null>(() =>
+		this.config().disableFuture ? new Date() : null,
+	);
+
+	protected onRangeChange(range: DateRange<Date> | null): void {
+		const cfg = this.config();
+		const from = range?.start ?? null;
+		const to = range?.end ?? null;
+		if (!from && !to) {
+			this.state.removeFilter(cfg.field);
+			return;
+		}
+		this.state.setFilter(cfg.field, {
+			field: cfg.field,
+			label: cfg.label,
+			type: this.filterType(),
+			min: toDateString(from),
+			max: toDateString(to),
+		});
+	}
+}

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/filter-field-wrapper/filter-field-wrapper.component.html

@@ -0,0 +1,11 @@
+<div class="space-y-1">
+	<app-label [for]="htmlFor()">{{ label() }}</app-label>
+	<ng-content />
+	<div class="min-h-4">
+		@if (error(); as err) {
+			<p class="text-xs text-red-600" role="alert">{{ err }}</p>
+		} @else if (helpText(); as help) {
+			<p class="text-xs text-gray-500">{{ help }}</p>
+		}
+	</div>
+</div>

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/filter-field-wrapper/filter-field-wrapper.component.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component, input } from "@angular/core";
+// Base-app UI wrapper, inherited (not recreated) by this feature. Post-compose
+// it lands at uiBundles/<target>/src/app/components/ui/label/..., three levels up from this
+// filter folder (app/object-search/components/filters/ -> app/components/ui/).
+import { LabelComponent } from "../../../../../components/ui/label/label.component";
+
+/**
+ * Standard label + control + help/error scaffold shared by every filter
+ * component (the Angular analogue of the React `FilterFieldWrapper`).
+ *
+ * The control itself is content-projected so each filter can supply the
+ * primitive that fits its data type (input, select, popover, date picker, ...)
+ * while the wrapper keeps the layout, label, and error/help affordances
+ * consistent across the search page.
+ */
+@Component({
+	selector: "app-filter-field-wrapper",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [LabelComponent],
+	templateUrl: "./filter-field-wrapper.component.html",
+})
+export class FilterFieldWrapperComponent {
+	/** Visible field label rendered above the control. */
+	readonly label = input.required<string>();
+	/** Optional `for` attribute forwarded to the underlying `<label>`. */
+	readonly htmlFor = input<string | null>(null);
+	/** Advisory copy rendered below the control when there is no error. */
+	readonly helpText = input<string | undefined>(undefined);
+	/** Validation message; when set, replaces the help text. */
+	readonly error = input<string | undefined>(undefined);
+}

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/multi-select-filter/multi-select-filter.component.html

@@ -0,0 +1,10 @@
+<app-filter-field-wrapper [label]="config().label" [helpText]="config().helpText">
+	<app-select
+		multiple
+		[size]="size()"
+		[options]="config().options ?? []"
+		[placeholder]="placeholder()"
+		[values]="selected()"
+		(valuesChange)="onSelectionChange($event)"
+	/>
+</app-filter-field-wrapper>

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/multi-select-filter/multi-select-filter.component.ts

@@ -0,0 +1,58 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component, computed, inject, input } from "@angular/core";
+import type { AppFieldSize } from "../../../../../components/ui/field-size";
+import { SelectComponent } from "../../../../../components/ui/select/select.component";
+import { ObjectSearchStateService } from "../../../object-search-state.service";
+import type { FilterFieldConfig } from "../../../utils/filter-utils";
+import { FilterFieldWrapperComponent } from "../filter-field-wrapper/filter-field-wrapper.component";
+
+/**
+ * Multi-select picklist filter. All presentation (checkbox options, trigger
+ * summary, height) lives in `app-select multiple`; this component only bridges
+ * the UI's `string[]` selection to the object-search state, serializing it into
+ * the comma-joined string the `type: 'multipicklist'` contract expects
+ * (`buildSingleFilter` maps that to `{ eq }` for one value, `{ in: [...] }` for
+ * many).
+ */
+@Component({
+	selector: "app-multi-select-filter",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [SelectComponent, FilterFieldWrapperComponent],
+	templateUrl: "./multi-select-filter.component.html",
+})
+export class MultiSelectFilterComponent {
+	private readonly state = inject(ObjectSearchStateService);
+
+	/** Field config: `field`, `label`, `options`, `helpText`, ... */
+	readonly config = input.required<FilterFieldConfig>();
+
+	/** Field height: `sm` = 24px, `default` = 32px, `lg` = 40px. */
+	readonly size = input<AppFieldSize>("default");
+
+	/** Currently selected option values (parsed back from the comma-joined string). */
+	protected readonly selected = computed<string[]>(() => {
+		const raw = this.state.filterFor(this.config().field)?.value;
+		return raw ? raw.split(",") : [];
+	});
+
+	/** Placeholder shown on the trigger when nothing is selected. */
+	protected readonly placeholder = computed(() => `Select ${this.config().label.toLowerCase()}`);
+
+	protected onSelectionChange(next: readonly string[]): void {
+		const cfg = this.config();
+		if (next.length === 0) {
+			this.state.removeFilter(cfg.field);
+		} else {
+			this.state.setFilter(cfg.field, {
+				field: cfg.field,
+				label: cfg.label,
+				type: "multipicklist",
+				value: next.join(","),
+			});
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/numeric-range-filter/numeric-range-filter.component.html

@@ -0,0 +1,22 @@
+<app-filter-field-wrapper
+	[label]="config().label"
+	[helpText]="config().helpText"
+	[error]="errorMessage()"
+>
+	<div class="flex gap-2">
+		<app-input
+			class="flex-1"
+			type="number"
+			placeholder="Min"
+			[value]="localMin()"
+			(valueChange)="onMinChange($event)"
+		/>
+		<app-input
+			class="flex-1"
+			type="number"
+			placeholder="Max"
+			[value]="localMax()"
+			(valueChange)="onMaxChange($event)"
+		/>
+	</div>
+</app-filter-field-wrapper>

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/numeric-range-filter/numeric-range-filter.component.ts

@@ -0,0 +1,146 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import {
+	ChangeDetectionStrategy,
+	Component,
+	DestroyRef,
+	computed,
+	effect,
+	inject,
+	input,
+	signal,
+} from "@angular/core";
+import { takeUntilDestroyed } from "@angular/core/rxjs-interop";
+import { Subject } from "rxjs";
+import { debounceTime } from "rxjs/operators";
+import { MatInputModule } from "@angular/material/input";
+import { MatFormFieldModule } from "@angular/material/form-field";
+import { FormsModule } from "@angular/forms";
+// Base-app UI wrapper, inherited (not recreated) by this feature. Post-compose
+// it lands at uiBundles/<target>/src/app/components/ui/input/..., three levels up.
+import { InputComponent } from "../../../../../components/ui/input/input.component";
+import { ObjectSearchStateService } from "../../../object-search-state.service";
+import { FILTER_DEBOUNCE_MS } from "../../../utils/debounce";
+import type { FilterFieldConfig } from "../../../utils/filter-utils";
+import { FilterFieldWrapperComponent } from "../filter-field-wrapper/filter-field-wrapper.component";
+
+/**
+ * Numeric range filter — paired `min` / `max` inputs whose committed values are
+ * written as strings on a `type: 'numeric'` filter (numeric coercion happens
+ * in `buildSingleFilter`).
+ *
+ * Local signals drive the inputs immediately; a trailing debounce commits the
+ * pair, but only when the range is self-consistent (`min <= max`) and within
+ * `boundMin` / `boundMax` if provided — an inverted or out-of-bounds pair
+ * shows the same inline error the React reference renders and skips the write.
+ */
+@Component({
+	selector: "app-numeric-range-filter",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [
+		InputComponent,
+		FilterFieldWrapperComponent,
+		FormsModule,
+		MatFormFieldModule,
+		MatInputModule,
+	],
+	templateUrl: "./numeric-range-filter.component.html",
+})
+export class NumericRangeFilterComponent {
+	private readonly state = inject(ObjectSearchStateService);
+	private readonly destroyRef = inject(DestroyRef);
+
+	/** Field config: `field`, `label`, `helpText`, ... */
+	readonly config = input.required<FilterFieldConfig>();
+	/** Optional lower bound accepted by the field (used for validation only). */
+	readonly boundMin = input<number | undefined>(undefined);
+	/** Optional upper bound accepted by the field (used for validation only). */
+	readonly boundMax = input<number | undefined>(undefined);
+
+	protected readonly localMin = signal<string>("");
+	protected readonly localMax = signal<string>("");
+
+	private readonly commit$ = new Subject<{ min: string; max: string }>();
+
+	constructor() {
+		this.commit$
+			.pipe(debounceTime(FILTER_DEBOUNCE_MS), takeUntilDestroyed(this.destroyRef))
+			.subscribe(({ min, max }) => this.commit(min, max));
+
+		// Sync local inputs from shared state (URL restore / reset-all).
+		effect(() => {
+			const cfg = this.config();
+			const active = this.state.filterFor(cfg.field);
+			this.localMin.set(active?.min ?? "");
+			this.localMax.set(active?.max ?? "");
+		});
+	}
+
+	protected readonly minOutOfBounds = computed(() => this.isOutOfBounds(this.localMin()));
+	protected readonly maxOutOfBounds = computed(() => this.isOutOfBounds(this.localMax()));
+	protected readonly isRangeInverted = computed(() => {
+		const lo = this.localMin();
+		const hi = this.localMax();
+		return lo !== "" && hi !== "" && Number(lo) > Number(hi);
+	});
+	protected readonly hasError = computed(
+		() => this.minOutOfBounds() || this.maxOutOfBounds() || this.isRangeInverted(),
+	);
+
+	protected readonly errorMessage = computed<string | undefined>(() => {
+		if (this.isRangeInverted()) return "Min must not exceed max";
+		if (!this.minOutOfBounds() && !this.maxOutOfBounds()) return undefined;
+		const lo = this.boundMin();
+		const hi = this.boundMax();
+		if (lo != null && hi != null) return `Value must be between ${lo}–${hi}`;
+		if (lo != null) return `Value must be ${lo} or more`;
+		if (hi != null) return `Value must be ${hi} or less`;
+		return undefined;
+	});
+
+	protected onMinChange(v: string): void {
+		this.localMin.set(v);
+		this.commit$.next({ min: v, max: this.localMax() });
+	}
+
+	protected onMaxChange(v: string): void {
+		this.localMax.set(v);
+		this.commit$.next({ min: this.localMin(), max: v });
+	}
+
+	private isOutOfBounds(v: string): boolean {
+		if (v === "") return false;
+		const n = Number(v);
+		const lo = this.boundMin();
+		const hi = this.boundMax();
+		return (lo != null && n < lo) || (hi != null && n > hi);
+	}
+
+	private commit(min: string, max: string): void {
+		const cfg = this.config();
+		if (!min && !max) {
+			this.state.removeFilter(cfg.field);
+			return;
+		}
+		const minNum = min !== "" ? Number(min) : null;
+		const maxNum = max !== "" ? Number(max) : null;
+		// Skip writes that would produce an inverted or out-of-bounds clause;
+		// the UI keeps the input contents so the user can correct in place.
+		if (minNum != null && maxNum != null && minNum > maxNum) return;
+		const lo = this.boundMin();
+		const hi = this.boundMax();
+		if (minNum != null && ((lo != null && minNum < lo) || (hi != null && minNum > hi))) return;
+		if (maxNum != null && ((lo != null && maxNum < lo) || (hi != null && maxNum > hi))) return;
+
+		this.state.setFilter(cfg.field, {
+			field: cfg.field,
+			label: cfg.label,
+			type: "numeric",
+			min,
+			max,
+		});
+	}
+}

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/search-filter/search-filter.component.html

@@ -0,0 +1,8 @@
+<app-filter-field-wrapper [label]="config().label" [htmlFor]="inputId()">
+	<app-input
+		type="search"
+		[placeholder]="config().placeholder ?? 'Search...'"
+		[value]="localValue()"
+		(valueChange)="onValueChange($event)"
+	/>
+</app-filter-field-wrapper>

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/search-filter/search-filter.component.ts

@@ -0,0 +1,82 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import {
+	ChangeDetectionStrategy,
+	Component,
+	DestroyRef,
+	effect,
+	inject,
+	input,
+	signal,
+} from "@angular/core";
+import { takeUntilDestroyed } from "@angular/core/rxjs-interop";
+import { Subject } from "rxjs";
+import { debounceTime } from "rxjs/operators";
+// Base-app UI wrapper, inherited (not recreated) by this feature. Post-compose
+// it lands at uiBundles/<target>/src/app/components/ui/input/..., three levels up.
+import { InputComponent } from "../../../../../components/ui/input/input.component";
+import { ObjectSearchStateService } from "../../../object-search-state.service";
+import { FILTER_DEBOUNCE_MS } from "../../../utils/debounce";
+import type { FilterFieldConfig } from "../../../utils/filter-utils";
+import { FilterFieldWrapperComponent } from "../filter-field-wrapper/filter-field-wrapper.component";
+
+/**
+ * Multi-field search filter — a debounced input whose value is applied via
+ * `like %value%` across every field named in `config.searchFields` (combined
+ * with a top-level `or`, see {@link buildFilter}).
+ *
+ * Shape mirrors {@link TextFilterComponent} but emits a `type: 'search'`
+ * {@link ActiveFilterValue} so `filter-utils` picks the multi-field path.
+ */
+@Component({
+	selector: "app-search-filter",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [InputComponent, FilterFieldWrapperComponent],
+	templateUrl: "./search-filter.component.html",
+})
+export class SearchFilterComponent {
+	private readonly state = inject(ObjectSearchStateService);
+	private readonly destroyRef = inject(DestroyRef);
+
+	/** Field config: `field`, `label`, `placeholder`, `searchFields`, ... */
+	readonly config = input.required<FilterFieldConfig>();
+
+	protected readonly localValue = signal<string>("");
+	protected readonly inputId = signal<string>("");
+	private readonly commit$ = new Subject<string>();
+
+	constructor() {
+		this.commit$
+			.pipe(debounceTime(FILTER_DEBOUNCE_MS), takeUntilDestroyed(this.destroyRef))
+			.subscribe((v) => this.commit(v));
+
+		effect(() => {
+			const cfg = this.config();
+			this.inputId.set(`filter-${cfg.field}`);
+			const external = this.state.filterFor(cfg.field)?.value ?? "";
+			this.localValue.set(external);
+		});
+	}
+
+	protected onValueChange(v: string): void {
+		this.localValue.set(v);
+		this.commit$.next(v);
+	}
+
+	private commit(v: string): void {
+		const cfg = this.config();
+		if (v) {
+			this.state.setFilter(cfg.field, {
+				field: cfg.field,
+				label: cfg.label,
+				type: "search",
+				value: v,
+			});
+		} else {
+			this.state.removeFilter(cfg.field);
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/select-filter/select-filter.component.html

@@ -0,0 +1,12 @@
+<app-filter-field-wrapper
+	[label]="config().label"
+	[htmlFor]="inputId()"
+	[helpText]="config().helpText"
+>
+	<app-select
+		[placeholder]="'Select ' + config().label.toLowerCase()"
+		[options]="options()"
+		[value]="currentValue()"
+		(valueChange)="onValueChange($event)"
+	/>
+</app-filter-field-wrapper>

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/select-filter/select-filter.component.ts

@@ -0,0 +1,65 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ChangeDetectionStrategy, Component, computed, inject, input } from "@angular/core";
+// Base-app UI wrapper, inherited (not recreated) by this feature. Post-compose
+// it lands at uiBundles/<target>/src/app/components/ui/select/..., three levels up.
+import {
+	SelectComponent,
+	type AppSelectOption,
+} from "../../../../../components/ui/select/select.component";
+import { ObjectSearchStateService } from "../../../object-search-state.service";
+import type { FilterFieldConfig } from "../../../utils/filter-utils";
+import { FilterFieldWrapperComponent } from "../filter-field-wrapper/filter-field-wrapper.component";
+
+/**
+ * Single-value picklist filter — a select rendered from `config.options` with
+ * a leading "All" entry (empty value) that clears the filter.
+ *
+ * Emits a `type: 'picklist'` filter which `buildSingleFilter` maps to
+ * `{ [field]: { eq: value } }`.
+ */
+const ALL_VALUE = "";
+
+@Component({
+	selector: "app-select-filter",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [SelectComponent, FilterFieldWrapperComponent],
+	templateUrl: "./select-filter.component.html",
+})
+export class SelectFilterComponent {
+	private readonly state = inject(ObjectSearchStateService);
+
+	/** Field config: `field`, `label`, `options`, `helpText`, ... */
+	readonly config = input.required<FilterFieldConfig>();
+
+	/** DOM id shared by the wrapper label and the underlying control. */
+	protected readonly inputId = computed(() => `filter-${this.config().field}`);
+
+	/** Options rendered in the select, with an "All" (clear) sentinel prepended. */
+	protected readonly options = computed<readonly AppSelectOption[]>(() => [
+		{ value: ALL_VALUE, label: "All" },
+		...(this.config().options ?? []),
+	]);
+
+	/** Current selection, reading through to shared state so URL changes reflect. */
+	protected readonly currentValue = computed(
+		() => this.state.filterFor(this.config().field)?.value ?? ALL_VALUE,
+	);
+
+	protected onValueChange(v: string): void {
+		const cfg = this.config();
+		if (v === ALL_VALUE) {
+			this.state.removeFilter(cfg.field);
+		} else {
+			this.state.setFilter(cfg.field, {
+				field: cfg.field,
+				label: cfg.label,
+				type: "picklist",
+				value: v,
+			});
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/text-filter/text-filter.component.html

@@ -0,0 +1,12 @@
+<app-filter-field-wrapper
+	[label]="config().label"
+	[htmlFor]="inputId()"
+	[helpText]="config().helpText"
+>
+	<app-input
+		type="text"
+		[placeholder]="config().placeholder ?? 'Filter by ' + config().label.toLowerCase() + '...'"
+		[value]="localValue()"
+		(valueChange)="onValueChange($event)"
+	/>
+</app-filter-field-wrapper>

package/dist/force-app/main/default/uiBundles/angularexternalapp/src/app/features/object-search/components/filters/text-filter/text-filter.component.ts

@@ -0,0 +1,90 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import {
+	ChangeDetectionStrategy,
+	Component,
+	DestroyRef,
+	effect,
+	inject,
+	input,
+	signal,
+} from "@angular/core";
+import { takeUntilDestroyed } from "@angular/core/rxjs-interop";
+import { Subject } from "rxjs";
+import { debounceTime } from "rxjs/operators";
+// Base-app UI wrapper, inherited (not recreated) by this feature. Post-compose
+// it lands at uiBundles/<target>/src/app/components/ui/input/..., three levels up.
+import { InputComponent } from "../../../../../components/ui/input/input.component";
+import { ObjectSearchStateService } from "../../../object-search-state.service";
+import { FILTER_DEBOUNCE_MS } from "../../../utils/debounce";
+import type { FilterFieldConfig } from "../../../utils/filter-utils";
+import { FilterFieldWrapperComponent } from "../filter-field-wrapper/filter-field-wrapper.component";
+
+/**
+ * Text filter — free-text input that writes a `like %value%` clause via
+ * {@link ObjectSearchStateService.setFilter}. Keystrokes update the local
+ * signal immediately (for a responsive UI) and flush to shared state on a
+ * {@link FILTER_DEBOUNCE_MS}ms trailing debounce (to avoid a query per key).
+ *
+ * Reads the current value from `state.filterFor(config.field)` so URL /
+ * reset-all changes reflect back into the input.
+ */
+@Component({
+	selector: "app-text-filter",
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	imports: [InputComponent, FilterFieldWrapperComponent],
+	templateUrl: "./text-filter.component.html",
+})
+export class TextFilterComponent {
+	private readonly state = inject(ObjectSearchStateService);
+	private readonly destroyRef = inject(DestroyRef);
+
+	/** Field config: `field`, `label`, `placeholder`, `helpText`, ... */
+	readonly config = input.required<FilterFieldConfig>();
+
+	/** Local (uncommitted) value that drives the input while the user is typing. */
+	protected readonly localValue = signal<string>("");
+
+	/** DOM id shared by the wrapper label and the underlying input. */
+	protected readonly inputId = signal<string>("");
+
+	/** Coalesces rapid keystrokes into one shared-state write. */
+	private readonly commit$ = new Subject<string>();
+
+	constructor() {
+		this.commit$
+			.pipe(debounceTime(FILTER_DEBOUNCE_MS), takeUntilDestroyed(this.destroyRef))
+			.subscribe((v) => this.commit(v));
+
+		// Sync the input with the shared state (URL restore, reset-all, ...).
+		// Mirrors the React "reset local when external changes" pattern.
+		effect(() => {
+			const cfg = this.config();
+			this.inputId.set(`filter-${cfg.field}`);
+			const external = this.state.filterFor(cfg.field)?.value ?? "";
+			this.localValue.set(external);
+		});
+	}
+
+	protected onValueChange(v: string): void {
+		this.localValue.set(v);
+		this.commit$.next(v);
+	}
+
+	private commit(v: string): void {
+		const cfg = this.config();
+		if (v) {
+			this.state.setFilter(cfg.field, {
+				field: cfg.field,
+				label: cfg.label,
+				type: "text",
+				value: v,
+			});
+		} else {
+			this.state.removeFilter(cfg.field);
+		}
+	}
+}