@salesforce/ui-bundle-template-feature-angular-object-search 12.5.4

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/date-picker/hlm-date-picker.ts

@@ -0,0 +1,203 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import {
+	booleanAttribute,
+	ChangeDetectionStrategy,
+	Component,
+	computed,
+	contentChild,
+	forwardRef,
+	input,
+	linkedSignal,
+	output,
+	signal,
+	viewChild,
+} from '@angular/core';
+import { type ControlValueAccessor, NG_VALUE_ACCESSOR } from '@angular/forms';
+import {
+	type BrnDatePickerBase,
+	BrnDatePickerTriggerToken,
+	provideBrnDatePicker,
+} from '@spartan-ng/brain/date-picker';
+import { BrnFieldControl, provideBrnLabelable } from '@spartan-ng/brain/field';
+import type { ChangeFn, TouchFn } from '@spartan-ng/brain/forms';
+import type { BrnOverlayState } from '@spartan-ng/brain/overlay';
+import { BrnPopover, type BrnPopoverAlign } from '@spartan-ng/brain/popover';
+import { HlmCalendar } from '@spartan-ng/styles/calendar';
+import { HlmPopoverImports } from '@spartan-ng/styles/popover';
+import { injectHlmDatePickerConfig } from './hlm-date-picker.token';
+
+export const HLM_DATE_PICKER_VALUE_ACCESSOR = {
+	provide: NG_VALUE_ACCESSOR,
+	useExisting: forwardRef(() => HlmDatePicker),
+	multi: true,
+};
+
+@Component({
+	selector: 'hlm-date-picker',
+	imports: [HlmPopoverImports, HlmCalendar],
+	providers: [
+		HLM_DATE_PICKER_VALUE_ACCESSOR,
+		provideBrnDatePicker(HlmDatePicker),
+		provideBrnLabelable(HlmDatePicker),
+	],
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	hostDirectives: [BrnFieldControl],
+	host: { class: 'block' },
+	template: `
+		<hlm-popover
+			[align]="align()"
+			sideOffset="5"
+			[state]="_popoverState()"
+			(stateChanged)="_onStateChange($event)"
+		>
+			<ng-content />
+
+			<hlm-popover-content class="w-fit p-0" *hlmPopoverPortal="let ctx">
+				<ng-content select="[hlmDatePickerHeader]" />
+				<hlm-calendar
+					class="rounded-none border-0"
+					[captionLayout]="captionLayout()"
+					[date]="_mutableDate()"
+					[defaultFocusedDate]="_mutableDate() ?? defaultFocusedDate()"
+					[min]="minDate()"
+					[max]="maxDate()"
+					[disabled]="_disabled()"
+					(dateChange)="_handleChange($event)"
+				/>
+				<ng-content select="[hlmDatePickerFooter]" />
+			</hlm-popover-content>
+		</hlm-popover>
+	`,
+})
+export class HlmDatePicker<T> implements BrnDatePickerBase<T>, ControlValueAccessor {
+	private readonly _config = injectHlmDatePickerConfig<T>();
+
+	public readonly popover = viewChild.required(BrnPopover);
+
+	private readonly _trigger = contentChild(BrnDatePickerTriggerToken);
+
+	public readonly align = input<BrnPopoverAlign>('center');
+
+	/** Show dropdowns to navigate between months or years. */
+	public readonly captionLayout = input<
+		'dropdown' | 'label' | 'dropdown-months' | 'dropdown-years'
+	>('label');
+
+	/** The minimum date that can be selected. */
+	public readonly minDate = input<T>();
+
+	/** The maximum date that can be selected. */
+	public readonly maxDate = input<T>();
+
+	/** Determine if the date picker is disabled. */
+	public readonly disabled = input<boolean, BooleanInput>(false, {
+		transform: booleanAttribute,
+	});
+
+	/** The selected value. */
+	public readonly date = input<T>();
+
+	/** The date the calendar focuses on first open when no date is selected. */
+	public readonly defaultFocusedDate = input<T>();
+
+	protected readonly _mutableDate = linkedSignal(this.date);
+
+	/** If true, the date picker will close when a date is selected. */
+	public readonly autoCloseOnSelect = input<boolean, BooleanInput>(this._config.autoCloseOnSelect, {
+		transform: booleanAttribute,
+	});
+
+	/** Defines how the date should be displayed in the UI.  */
+	public readonly formatDate = input<(date: T) => string>(this._config.formatDate);
+
+	/** Defines how the date should be transformed before saving to model/form. */
+	public readonly transformDate = input<(date: T) => T>(this._config.transformDate);
+
+	protected readonly _popoverState = signal<BrnOverlayState | null>(null);
+
+	protected readonly _disabled = linkedSignal(this.disabled);
+
+	/** @internal The disabled state as a readonly signal */
+	public readonly disabledState = this._disabled.asReadonly();
+
+	public readonly formattedDate = computed(() => {
+		const date = this._mutableDate();
+		return date ? this.formatDate()(date) : undefined;
+	});
+
+	public readonly dateChange = output<T | null>();
+
+	public readonly labelableId = computed(() => this._trigger()?.triggerId());
+
+	public readonly hasDate = computed(() => !!this._mutableDate());
+
+	/** @internal The current raw value, used by inputs to reformat on focus. */
+	public readonly value = computed(() => this._mutableDate() ?? null);
+
+	protected _onChange?: ChangeFn<T | null>;
+	protected _onTouched?: TouchFn;
+
+	protected _onStateChange(state: BrnOverlayState) {
+		this._popoverState.set(state);
+		if (state === 'closed') this._onTouched?.();
+	}
+
+	protected _handleChange(value: T | undefined) {
+		if (this._disabled()) return;
+		this.updateDate(value ?? null);
+
+		if (this.autoCloseOnSelect()) {
+			this._popoverState.set('closed');
+		}
+	}
+
+	/**
+	 * Commit a date to the picker. Updates the internal model, notifies form
+	 * controls, and emits `dateChange`. Unlike `_handleChange`, this does not
+	 * close the popover - it's intended to be called from a text input that
+	 * is parsing user-entered values while typing.
+	 */
+	public updateDate(value: T | null) {
+		if (this._disabled()) return;
+		const transformedDate = value != null ? this.transformDate()(value) : undefined;
+
+		this._mutableDate.set(transformedDate);
+		this._onChange?.(transformedDate ?? null);
+		this.dateChange.emit(transformedDate ?? null);
+	}
+
+	/** CONTROL VALUE ACCESSOR */
+	public writeValue(value: T | null): void {
+		this._mutableDate.set(value ? this.transformDate()(value) : undefined);
+	}
+
+	public registerOnChange(fn: ChangeFn<T | null>): void {
+		this._onChange = fn;
+	}
+
+	public registerOnTouched(fn: TouchFn): void {
+		this._onTouched = fn;
+	}
+
+	public touched(): void {
+		this._onTouched?.();
+	}
+
+	public setDisabledState(isDisabled: boolean): void {
+		this._disabled.set(isDisabled);
+	}
+
+	public open() {
+		this._popoverState.set('open');
+	}
+
+	public close() {
+		this._popoverState.set('closed');
+	}
+
+	public reset() {
+		this._mutableDate.set(undefined);
+		this._onChange?.(null);
+		this.dateChange.emit(null);
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/date-picker/hlm-date-range-input.ts

@@ -0,0 +1,120 @@
+import {
+	booleanAttribute,
+	ChangeDetectionStrategy,
+	Component,
+	computed,
+	inject,
+	input,
+} from '@angular/core';
+import { NgIcon, provideIcons } from '@ng-icons/core';
+import { lucideCalendar, lucideX } from '@ng-icons/lucide';
+import {
+	BrnDateInput,
+	type BrnDatePickerTriggerBase,
+	provideBrnDatePickerTrigger,
+} from '@spartan-ng/brain/date-picker';
+import { BrnFieldControl } from '@spartan-ng/brain/field';
+import type { BooleanInput } from '@angular/cdk/coercion';
+import { HlmInputGroup, HlmInputGroupImports } from '@spartan-ng/styles/input-group';
+import { injectHlmDateRangePickerConfig } from './hlm-date-range-picker.token';
+
+@Component({
+	selector: 'hlm-date-range-input',
+	imports: [HlmInputGroupImports, NgIcon],
+	providers: [
+		provideIcons({ lucideCalendar, lucideX }),
+		provideBrnDatePickerTrigger(HlmDateRangeInput),
+	],
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	hostDirectives: [HlmInputGroup],
+	template: `
+		<input
+			#input
+			hlmInputGroupInput
+			[value]="_inputValue()"
+			[id]="inputId()"
+			[placeholder]="placeholder()"
+			[disabled]="_disabled()"
+			[readonly]="readonly()"
+			[forceInvalid]="forceInvalid()"
+			[attr.aria-invalid]="_ariaInvalid()"
+			[attr.data-invalid]="_ariaInvalid()"
+			[attr.data-touched]="_touched?.() ? 'true' : null"
+			[attr.data-dirty]="_dirty?.() ? 'true' : null"
+			[attr.data-matches-spartan-invalid]="_spartanInvalid() ? 'true' : null"
+			(click)="_handleClick(); readonly() && _popover().open()"
+			(keydown.arrowDown)="_open()"
+			(keydown.enter)="_handleEnter($event); readonly() && _popover().open()"
+			(keydown.space)="readonly() && _popover().open()"
+			(input)="_handleInputChange($event)"
+			(focus)="_handleFocus()"
+			(blur)="_handleBlur()"
+		/>
+		<hlm-input-group-addon align="inline-end">
+			@if (_showClearButton() && !readonly()) {
+				<button
+					hlmInputGroupButton
+					size="icon-xs"
+					variant="ghost"
+					[attr.aria-label]="clearAriaLabel()"
+					(click)="_clear()"
+					[disabled]="_disabled()"
+				>
+					<ng-icon name="lucideX" />
+				</button>
+			}
+			<button
+				hlmInputGroupButton
+				size="icon-xs"
+				[attr.aria-label]="calendarAriaLabel()"
+				(click)="_popover().open()"
+				[disabled]="_disabled()"
+			>
+				<ng-icon name="lucideCalendar" />
+			</button>
+		</hlm-input-group-addon>
+	`,
+})
+export class HlmDateRangeInput<T> extends BrnDateInput<[T, T]> implements BrnDatePickerTriggerBase {
+	private readonly _config = injectHlmDateRangePickerConfig<T>();
+	private readonly _fieldControl = inject(BrnFieldControl, { optional: true });
+
+	/** When true, typing is blocked but the calendar toggle still works. */
+	public readonly readonly = input<boolean, BooleanInput>(false, { transform: booleanAttribute });
+
+	private readonly _invalid = this._fieldControl?.invalid;
+	protected readonly _spartanInvalid = computed(
+		() => this.forceInvalid() || this._fieldControl?.spartanInvalid(),
+	);
+	protected readonly _dirty = this._fieldControl?.dirty;
+	protected readonly _touched = this._fieldControl?.touched;
+
+	protected readonly _ariaInvalid = computed(() => (this._invalid?.() ? 'true' : null));
+
+	/**
+	 * Parses input text into a date range. Return `null` for invalid
+	 * input - the picker's range is cleared while the text is preserved so
+	 * the user can fix it.
+	 *
+	 * Defaults to `parseDate` from `HlmDateRangePickerConfig`.
+	 */
+	public readonly parseDate = input<(value: string) => [T, T] | null>(this._config.parseDate);
+
+	/**
+	 * Formats the current range into the input/edit format shown while the
+	 * input is focused. On blur the picker's display format is restored.
+	 *
+	 * Defaults to `formatInputDates` from `HlmDateRangePickerConfig`.
+	 */
+	public readonly formatInputDates = input<(dates: [T | null, T | null]) => string>(
+		this._config.formatInputDates,
+	);
+
+	protected override parseValue(value: string): [T, T] | null {
+		return this.parseDate()(value);
+	}
+
+	protected override formatInputValue(value: [T, T]): string {
+		return this.formatInputDates()(value);
+	}
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/date-picker/hlm-date-range-picker.token.ts

@@ -0,0 +1,86 @@
+import { inject, InjectionToken, type ValueProvider } from '@angular/core';
+
+export interface HlmDateRangePickerConfig<T> {
+	/**
+	 * If true, the date picker will close when the max selection of dates is reached.
+	 */
+	autoCloseOnEndSelection: boolean;
+
+	/**
+	 * Defines how the date should be displayed in the UI.
+	 *
+	 * @param dates
+	 * @returns formatted date
+	 */
+	formatDates: (dates: [T | null, T | null]) => string;
+
+	/**
+	 * Defines how the range should be displayed while the input is focused,
+	 * i.e. the format the user is expected to type in.
+	 *
+	 * @param dates
+	 * @returns formatted range in the input/edit format
+	 */
+	formatInputDates: (dates: [T | null, T | null]) => string;
+
+	/**
+	 * Defines how the date should be transformed before saving to model/form.
+	 *
+	 * @param dates
+	 * @returns transformed date
+	 */
+	transformDates: (dates: [T, T]) => [T, T];
+
+	/**
+	 * Parse a user-entered string into a date range.
+	 *
+	 * @param value the raw string from the input
+	 * @returns the parsed range, or `null` when the value can't be parsed
+	 */
+	parseDate: (value: string) => [T, T] | null;
+}
+
+function getDefaultConfig<T>(): HlmDateRangePickerConfig<T> {
+	return {
+		formatDates: (dates) =>
+			dates
+				.filter(Boolean)
+				.map((date) => (date instanceof Date ? date.toDateString() : `${date}`))
+				.join(' - '),
+		formatInputDates: (dates) =>
+			dates
+				.filter(Boolean)
+				.map((date) => (date instanceof Date ? date.toDateString() : `${date}`))
+				.join(' - '),
+		transformDates: (dates) => dates,
+		autoCloseOnEndSelection: false,
+		parseDate: (value) => {
+			if (typeof value !== 'string') return null;
+
+			const parts = value.split(' - ').map((part) => part.trim());
+			if (parts.length === 0 || parts.length > 2) return null;
+
+			const start = new Date(parts[0]);
+			if (isNaN(start.getTime())) return null;
+
+			const end = parts.length === 2 ? new Date(parts[1]) : start;
+
+			return [start, isNaN(end.getTime()) ? start : end] as [T, T];
+		},
+	};
+}
+
+const HlmDateRangePickerConfigToken = new InjectionToken<HlmDateRangePickerConfig<unknown>>(
+	'HlmDateRangePickerConfig',
+);
+
+export function provideHlmDateRangePickerConfig<T>(
+	config: Partial<HlmDateRangePickerConfig<T>>,
+): ValueProvider {
+	return { provide: HlmDateRangePickerConfigToken, useValue: { ...getDefaultConfig(), ...config } };
+}
+
+export function injectHlmDateRangePickerConfig<T>(): HlmDateRangePickerConfig<T> {
+	const injectedConfig = inject(HlmDateRangePickerConfigToken, { optional: true });
+	return injectedConfig ? (injectedConfig as HlmDateRangePickerConfig<T>) : getDefaultConfig();
+}

package/dist/force-app/main/default/uiBundles/feature-angular-object-search/src/app/shared/date-picker/hlm-date-range-picker.ts

@@ -0,0 +1,252 @@
+import type { BooleanInput } from '@angular/cdk/coercion';
+import {
+	booleanAttribute,
+	ChangeDetectionStrategy,
+	Component,
+	computed,
+	contentChild,
+	forwardRef,
+	input,
+	linkedSignal,
+	output,
+	signal,
+	untracked,
+	viewChild,
+} from '@angular/core';
+import { type ControlValueAccessor, NG_VALUE_ACCESSOR } from '@angular/forms';
+import {
+	type BrnDatePickerBase,
+	BrnDatePickerTriggerToken,
+	provideBrnDatePicker,
+} from '@spartan-ng/brain/date-picker';
+import { BrnFieldControl, provideBrnLabelable } from '@spartan-ng/brain/field';
+import type { ChangeFn, TouchFn } from '@spartan-ng/brain/forms';
+import type { BrnOverlayState } from '@spartan-ng/brain/overlay';
+import { BrnPopover, type BrnPopoverAlign } from '@spartan-ng/brain/popover';
+import { HlmCalendarRange } from '@spartan-ng/styles/calendar';
+import { HlmPopoverImports } from '@spartan-ng/styles/popover';
+import { injectHlmDateRangePickerConfig } from './hlm-date-range-picker.token';
+
+export const HLM_DATE_RANGE_PICKER_VALUE_ACCESSOR = {
+	provide: NG_VALUE_ACCESSOR,
+	useExisting: forwardRef(() => HlmDateRangePicker),
+	multi: true,
+};
+
+@Component({
+	selector: 'hlm-date-range-picker',
+	imports: [HlmPopoverImports, HlmCalendarRange],
+	providers: [
+		HLM_DATE_RANGE_PICKER_VALUE_ACCESSOR,
+		provideBrnDatePicker(HlmDateRangePicker),
+		provideBrnLabelable(HlmDateRangePicker),
+	],
+	changeDetection: ChangeDetectionStrategy.OnPush,
+	hostDirectives: [BrnFieldControl],
+	host: { class: 'block' },
+	template: `
+		<hlm-popover
+			[align]="align()"
+			sideOffset="5"
+			[state]="_popoverState()"
+			(stateChanged)="_onStateChange($event)"
+		>
+			<ng-content />
+
+			<hlm-popover-content class="w-fit p-0" *hlmPopoverPortal="let ctx">
+				<ng-content select="[hlmDatePickerHeader]" />
+				<hlm-calendar-range
+					class="rounded-none border-0"
+					[startDate]="_start()"
+					[captionLayout]="captionLayout()"
+					[endDate]="_end()"
+					[min]="minDate()"
+					[max]="maxDate()"
+					[disabled]="_disabled()"
+					(startDateChange)="_handleStartDayChange($event)"
+					(endDateChange)="_handleEndDateChange($event)"
+				/>
+				<ng-content select="[hlmDatePickerFooter]" />
+			</hlm-popover-content>
+		</hlm-popover>
+	`,
+})
+export class HlmDateRangePicker<T> implements BrnDatePickerBase<[T, T]>, ControlValueAccessor {
+	private readonly _config = injectHlmDateRangePickerConfig<T>();
+
+	public readonly popover = viewChild.required(BrnPopover);
+
+	private readonly _trigger = contentChild(BrnDatePickerTriggerToken);
+
+	public readonly align = input<BrnPopoverAlign>('center');
+
+	/** Show dropdowns to navigate between months or years. */
+	public readonly captionLayout = input<
+		'dropdown' | 'label' | 'dropdown-months' | 'dropdown-years'
+	>('label');
+
+	/** The minimum date that can be selected.*/
+	public readonly minDate = input<T>();
+
+	/** The maximum date that can be selected. */
+	public readonly maxDate = input<T>();
+
+	/** Determine if the date picker is disabled. */
+	public readonly disabled = input<boolean, BooleanInput>(false, {
+		transform: booleanAttribute,
+	});
+
+	/** The selected value. */
+	public readonly date = input<[T, T]>();
+
+	protected readonly _mutableDate = linkedSignal(this.date);
+
+	protected readonly _start = linkedSignal(() => this._mutableDate()?.[0]);
+	protected readonly _end = linkedSignal(() => this._mutableDate()?.[1]);
+
+	/** If true, the date picker will close when the end date is selected */
+	public readonly autoCloseOnEndSelection = input<boolean, BooleanInput>(
+		this._config.autoCloseOnEndSelection,
+		{
+			transform: booleanAttribute,
+		},
+	);
+
+	/** Defines how the date should be displayed in the UI.  */
+	public readonly formatDates = input<(dates: [T | null, T | null]) => string>(
+		this._config.formatDates,
+	);
+
+	/** Defines how the date should be transformed before saving to model/form. */
+	public readonly transformDates = input<(date: [T, T]) => [T, T]>(this._config.transformDates);
+
+	protected readonly _popoverState = signal<BrnOverlayState | null>(null);
+
+	protected readonly _disabled = linkedSignal(this.disabled);
+
+	/** @internal The disabled state as a readonly signal */
+	public readonly disabledState = this._disabled.asReadonly();
+
+	public readonly formattedDate = computed(() => {
+		const start = this._start();
+		const end = this._end();
+		return start || end ? this.formatDates()([start ?? null, end ?? null]) : undefined;
+	});
+
+	public readonly dateChange = output<[T, T] | null>();
+
+	public readonly labelableId = computed(() => this._trigger()?.triggerId());
+
+	public readonly hasDate = computed(() => !!this._start() || !!this._end());
+
+	/** @internal The current raw value, used by inputs to reformat on focus. */
+	public readonly value = computed(() => this._mutableDate() ?? null);
+
+	protected _onChange?: ChangeFn<[T, T] | null>;
+	protected _onTouched?: TouchFn;
+
+	protected _onStateChange(state: BrnOverlayState) {
+		this._popoverState.set(state);
+		if (state === 'closed') {
+			this._onClose();
+			this._onTouched?.();
+		}
+	}
+
+	protected _handleStartDayChange(value: T | undefined) {
+		this._start.set(value);
+	}
+
+	protected _handleEndDateChange(value: T | undefined): void {
+		this._end.set(value);
+		if (this._disabled()) return;
+
+		const start = this._start();
+		if (start && value) {
+			const transformedDates = this.transformDates()([start, value]);
+			this._mutableDate.set(transformedDates);
+			this.dateChange.emit(transformedDates);
+			this._onChange?.(transformedDates);
+
+			if (this.autoCloseOnEndSelection()) {
+				this._popoverState.set('closed');
+			}
+		}
+	}
+
+	/**
+	 * Commit a range to the picker. Updates the internal model, notifies form
+	 * controls, and emits `dateChange`. Intended to be called from a text input
+	 * that parses user-entered values. Pass `null` to clear the range.
+	 */
+	public updateDate(value: [T, T] | null) {
+		if (this._disabled()) return;
+
+		if (!value) {
+			this._mutableDate.set(undefined);
+			this._start.set(undefined);
+			this._end.set(undefined);
+			this._onChange?.(null);
+			this.dateChange.emit(null);
+			return;
+		}
+
+		const transformedDates = this.transformDates()(value);
+		this._mutableDate.set(transformedDates);
+		this._start.set(transformedDates[0]);
+		this._end.set(transformedDates[1]);
+		this._onChange?.(transformedDates);
+		this.dateChange.emit(transformedDates);
+	}
+
+	public touched(): void {
+		this._onTouched?.();
+	}
+
+	/** CONTROL VALUE ACCESSOR */
+	public writeValue(value: [T, T] | null): void {
+		untracked(() => {
+			if (!value) {
+				this._mutableDate.set(undefined);
+			} else {
+				this._mutableDate.set(this.transformDates()(value));
+			}
+		});
+	}
+
+	public registerOnChange(fn: ChangeFn<[T, T] | null>): void {
+		this._onChange = fn;
+	}
+
+	public registerOnTouched(fn: TouchFn): void {
+		this._onTouched = fn;
+	}
+
+	public setDisabledState(isDisabled: boolean): void {
+		this._disabled.set(isDisabled);
+	}
+
+	public open() {
+		this._popoverState.set('open');
+	}
+
+	public close() {
+		this._popoverState.set('closed');
+	}
+
+	public reset() {
+		this._mutableDate.set(undefined);
+		this._start.set(undefined);
+		this._end.set(undefined);
+		this._onChange?.(null);
+		this.dateChange.emit(null);
+	}
+
+	protected _onClose(): void {
+		const dates = this._mutableDate();
+		if (this._start() && !this._end() && dates) {
+			this._start.set(dates[0]);
+			this._end.set(dates[1]);
+		}
+	}
+}