@blueprint-platform/components 0.0.0-stage → 0.2.1

package/dist/generators/ui/files/shared/ui/date-picker/src/lib/hlm-date-picker.token.ts

@@ -0,0 +1,69 @@
+import { inject, InjectionToken, type ValueProvider } from '@angular/core';
+
+export interface HlmDatePickerConfig<T> {
+  /**
+   * If true, the date picker will close when a date is selected.
+   */
+  autoCloseOnSelect: boolean;
+
+  /**
+   * Defines how the date should be displayed in the UI.
+   *
+   * @param date
+   * @returns formatted date
+   */
+  formatDate: (date: T) => string;
+
+  /**
+   * Defines how the date should be displayed while the input is focused,
+   * i.e. the format the user is expected to type in.
+   *
+   * @param date
+   * @returns formatted date in the input/edit format
+   */
+  formatInputDate: (date: T) => string;
+
+  /**
+   * Defines how the date should be transformed before saving to model/form.
+   *
+   * @param date
+   * @returns transformed date
+   */
+  transformDate: (date: T) => T;
+
+  /**
+   * Parse a user-entered string into a date.
+   *
+   * @param value the raw string from the input
+   * @returns the parsed date, or `null` when the value can't be parsed
+   */
+  parseDate: (value: string) => T | null;
+}
+
+function getDefaultConfig<T>(): HlmDatePickerConfig<T> {
+  return {
+    formatDate: (date) => (date instanceof Date ? date.toDateString() : `${date}`),
+    formatInputDate: (date) => (date instanceof Date ? date.toDateString() : `${date}`),
+    transformDate: (date) => date,
+    parseDate: (value) => {
+      const date = new Date(value);
+      return isNaN(date.getTime()) ? null : (date as T);
+    },
+    autoCloseOnSelect: false,
+  };
+}
+
+const HlmDatePickerConfigToken = new InjectionToken<HlmDatePickerConfig<unknown>>(
+  'HlmDatePickerConfig',
+);
+
+export function provideHlmDatePickerConfig<T>(
+  config: Partial<HlmDatePickerConfig<T>>,
+): ValueProvider {
+  return { provide: HlmDatePickerConfigToken, useValue: { ...getDefaultConfig(), ...config } };
+}
+
+export function injectHlmDatePickerConfig<T>(): HlmDatePickerConfig<T> {
+  const injectedConfig = inject(HlmDatePickerConfigToken, { optional: true });
+  return injectedConfig ? (injectedConfig as HlmDatePickerConfig<T>) : getDefaultConfig();
+}

package/dist/generators/ui/files/shared/ui/date-picker/src/lib/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 '@blueprint-platform/ui/calendar';
+import { HlmPopoverImports } from '@blueprint-platform/ui/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/generators/ui/files/shared/ui/date-picker/src/lib/hlm-date-range-input.ts

@@ -0,0 +1,107 @@
+import { 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 { HlmInputGroup, HlmInputGroupImports } from '@blueprint-platform/ui/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()"
+      [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()"
+      (keydown.arrowDown)="_open()"
+      (keydown.enter)="_handleEnter($event)"
+      (input)="_handleInputChange($event)"
+      (focus)="_handleFocus()"
+      (blur)="_handleBlur()"
+    />
+    <hlm-input-group-addon align="inline-end">
+      @if (_showClearButton()) {
+        <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 });
+
+  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/generators/ui/files/shared/ui/date-picker/src/lib/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();
+}