@brickclay-org/ui 0.1.24 → 0.1.25

package/index.d.ts

@@ -26,10 +26,28 @@ declare class BrickclayLib {
     static ɵcmp: i0.ɵɵComponentDeclaration<BrickclayLib, "lib-brickclay-lib", never, {}, {}, never, never, true, never>;
 }
 
+interface CalendarRange {
+    start: Date;
+    end: Date;
+}
+interface CustomRangesConfig {
+    customRanges?: Record<string, CalendarRange>;
+    rangeOrder: string[];
+}
 declare class BkCalendarManagerService {
     private calendarInstances;
     private closeAllSubject;
     closeAll$: rxjs.Observable<void>;
+    customRanges: Record<string, CalendarRange>;
+    rangeOrder: string[];
+    constructor();
+    /**
+     * Returns service-defined custom ranges and their display order.
+     * Used when the calendar does not pass customRanges via @Input().
+     */
+    getCustomRanges(): CustomRangesConfig;
+    initializeDefaultRanges(): void;
+    addDays(date: Date, days: number): Date;
     /**
      * Register a calendar instance with its close function
      */
@@ -47,10 +65,6 @@ declare class BkCalendarManagerService {
     static ɵprov: i0.ɵɵInjectableDeclaration<BkCalendarManagerService>;
 }
 
-interface CalendarRange {
-    start: Date;
-    end: Date;
-}
 declare class CalendarSelection {
     startDate: string | null;
     endDate: string | null;
@@ -73,6 +87,8 @@ declare class BkCustomCalendar implements OnInit, OnDestroy, OnChanges, ControlV
     customRangeDirection: boolean;
     lockStartDate: boolean;
     position: 'center' | 'left' | 'right';
+    /** Vertical placement relative to the input. Takes precedence over {@link drop} for default bottom placement. */
+    popupPosition: 'top' | 'bottom';
     drop: 'up' | 'down';
     dualCalendar: boolean;
     showRanges: boolean;
@@ -80,6 +96,8 @@ declare class BkCustomCalendar implements OnInit, OnDestroy, OnChanges, ControlV
     clearableTime: boolean;
     enableSeconds: boolean;
     customRanges?: Record<string, CalendarRange>;
+    /** Column headers for weekdays; index 0 is the first column. Default Monday–Sunday. */
+    weekDayLabels: string[];
     multiDateSelection: boolean;
     maxDate?: Date;
     minDate?: Date;
@@ -92,12 +110,15 @@ declare class BkCustomCalendar implements OnInit, OnDestroy, OnChanges, ControlV
     errorMessage: string;
     selected: EventEmitter<CalendarSelection>;
     inputWrapper: ElementRef<HTMLDivElement>;
+    calendarPopupRef?: ElementRef<HTMLDivElement>;
     /** Used when appendToBody is true to position the popup in viewport coordinates */
     dropdownStyle: {
         top?: string;
         bottom?: string;
         left?: string;
     };
+    /** Resolved after layout; used for CSS `drop-up` and appendToBody positioning with viewport flip */
+    popupPlacementAbove: boolean;
     opened: EventEmitter<void>;
     closed: EventEmitter<void>;
     showCancelApply: boolean;
@@ -175,13 +196,23 @@ declare class BkCustomCalendar implements OnInit, OnDestroy, OnChanges, ControlV
     closePickerCounter: {
         [key: string]: number;
     };
-    defaultRanges: Record<string, CalendarRange>;
     activeRange: string | null;
     rangeOrder: string[];
+    /** Keyboard roving focus for date grid (local date, midnight) */
+    keyboardFocusDate: Date | null;
     private unregisterFn?;
     private closeAllSubscription?;
     private closeFn?;
     constructor(calendarManager: BkCalendarManagerService);
+    /** Weekday headers; falls back to Mon–Sun if the input is not length 7. */
+    get resolvedWeekDayLabels(): string[];
+    /** When dual range mode, Apply is blocked until both endpoints exist. */
+    get isDualRangeApplyBlocked(): boolean;
+    /** User preference before viewport adjustment (legacy `drop` still applies when `popupPosition` is `bottom`). */
+    private preferPopupAbove;
+    private resolveCustomRangesFromInputsOrService;
+    private labelToJsWeekday;
+    private getWeekStartDayIndex;
     writeValue(value: CalendarSelection | null): void;
     registerOnChange(fn: (value: CalendarSelection | null) => void): void;
     registerOnTouched(fn: () => void): void;
@@ -198,13 +229,37 @@ declare class BkCustomCalendar implements OnInit, OnDestroy, OnChanges, ControlV
     onWindowEvents(): void;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    private regenerateCalendarsForWeekStart;
     ngOnDestroy(): void;
     checkAndSetActiveRange(): void;
-    initializeDefaultRanges(): void;
     initializeTimeFromDate(date: Date, isStart: boolean): void;
     toggle(): void;
     /** Update popup position when appendToBody is true (fixed positioning relative to viewport). */
     updatePosition(): void;
+    /** Non–append-to-body: set `popupPlacementAbove` for CSS `drop-up` with viewport flip. */
+    refreshPopupPlacement(): void;
+    private computePlacementAbove;
+    /** Normalize to local midnight and clamp to min/max selectable day. */
+    private clampCalendarDayToSelectableRange;
+    private initKeyboardFocus;
+    /**
+     * After clearing values, drop stale keyboard highlight (was last start/end) and reset the
+     * visible month(s) to today (clamped). Move DOM focus to the popup when open, else the input.
+     */
+    private resetCalendarFocusAfterClear;
+    private scheduleDomFocusAfterClear;
+    private ensureKeyboardFocusVisible;
+    private moveKeyboardFocus;
+    /**
+     * When focus is inside a real control (button, link, field), do not intercept keys here.
+     * Otherwise this handler's preventDefault (Enter/Space) blocks native button activation and
+     * bubbled Enter still runs applyKeyboardSelection — breaking keyboard parity with click.
+     */
+    private isKeyboardEventFromInteractiveDescendant;
+    onCalendarPopupKeydown(event: KeyboardEvent): void;
+    private applyKeyboardSelection;
+    isKeyboardFocusedCell(year: number, month: number, day: number): boolean;
+    onRangeButtonKeydown(event: KeyboardEvent, rangeKey: string): void;
     close(): void;
     onDateHover(day: number | null, fromRight?: boolean): void;
     onDateLeave(): void;
@@ -275,7 +330,7 @@ declare class BkCustomCalendar implements OnInit, OnDestroy, OnChanges, ControlV
     private parseDateString;
     formatDateToString(date: Date): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<BkCustomCalendar, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<BkCustomCalendar, "bk-custom-calendar", never, { "enableTimepicker": { "alias": "enableTimepicker"; "required": false; }; "autoApply": { "alias": "autoApply"; "required": false; }; "closeOnAutoApply": { "alias": "closeOnAutoApply"; "required": false; }; "showCancel": { "alias": "showCancel"; "required": false; }; "linkedCalendars": { "alias": "linkedCalendars"; "required": false; }; "singleDatePicker": { "alias": "singleDatePicker"; "required": false; }; "showWeekNumbers": { "alias": "showWeekNumbers"; "required": false; }; "showISOWeekNumbers": { "alias": "showISOWeekNumbers"; "required": false; }; "customRangeDirection": { "alias": "customRangeDirection"; "required": false; }; "lockStartDate": { "alias": "lockStartDate"; "required": false; }; "position": { "alias": "position"; "required": false; }; "drop": { "alias": "drop"; "required": false; }; "dualCalendar": { "alias": "dualCalendar"; "required": false; }; "showRanges": { "alias": "showRanges"; "required": false; }; "timeFormat": { "alias": "timeFormat"; "required": false; }; "clearableTime": { "alias": "clearableTime"; "required": false; }; "enableSeconds": { "alias": "enableSeconds"; "required": false; }; "customRanges": { "alias": "customRanges"; "required": false; }; "multiDateSelection": { "alias": "multiDateSelection"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "opens": { "alias": "opens"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; "appendToBody": { "alias": "appendToBody"; "required": false; }; "isDisplayCrossIcon": { "alias": "isDisplayCrossIcon"; "required": false; }; "hasError": { "alias": "hasError"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "showCancelApply": { "alias": "showCancelApply"; "required": false; }; "selectedValue": { "alias": "selectedValue"; "required": false; }; "displayFormat": { "alias": "displayFormat"; "required": false; }; "required": { "alias": "required"; "required": false; }; }, { "selected": "selected"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BkCustomCalendar, "bk-custom-calendar", never, { "enableTimepicker": { "alias": "enableTimepicker"; "required": false; }; "autoApply": { "alias": "autoApply"; "required": false; }; "closeOnAutoApply": { "alias": "closeOnAutoApply"; "required": false; }; "showCancel": { "alias": "showCancel"; "required": false; }; "linkedCalendars": { "alias": "linkedCalendars"; "required": false; }; "singleDatePicker": { "alias": "singleDatePicker"; "required": false; }; "showWeekNumbers": { "alias": "showWeekNumbers"; "required": false; }; "showISOWeekNumbers": { "alias": "showISOWeekNumbers"; "required": false; }; "customRangeDirection": { "alias": "customRangeDirection"; "required": false; }; "lockStartDate": { "alias": "lockStartDate"; "required": false; }; "position": { "alias": "position"; "required": false; }; "popupPosition": { "alias": "popupPosition"; "required": false; }; "drop": { "alias": "drop"; "required": false; }; "dualCalendar": { "alias": "dualCalendar"; "required": false; }; "showRanges": { "alias": "showRanges"; "required": false; }; "timeFormat": { "alias": "timeFormat"; "required": false; }; "clearableTime": { "alias": "clearableTime"; "required": false; }; "enableSeconds": { "alias": "enableSeconds"; "required": false; }; "customRanges": { "alias": "customRanges"; "required": false; }; "weekDayLabels": { "alias": "weekDayLabels"; "required": false; }; "multiDateSelection": { "alias": "multiDateSelection"; "required": false; }; "maxDate": { "alias": "maxDate"; "required": false; }; "minDate": { "alias": "minDate"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "opens": { "alias": "opens"; "required": false; }; "inline": { "alias": "inline"; "required": false; }; "appendToBody": { "alias": "appendToBody"; "required": false; }; "isDisplayCrossIcon": { "alias": "isDisplayCrossIcon"; "required": false; }; "hasError": { "alias": "hasError"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "showCancelApply": { "alias": "showCancelApply"; "required": false; }; "selectedValue": { "alias": "selectedValue"; "required": false; }; "displayFormat": { "alias": "displayFormat"; "required": false; }; "required": { "alias": "required"; "required": false; }; "rangeOrder": { "alias": "rangeOrder"; "required": false; }; }, { "selected": "selected"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
 interface TimeConfiguration {
@@ -2167,4 +2222,4 @@ declare class BkLoader {
 }
 
 export { BKTooltipDirective, BK_DEFAULT_DIALOG_CONFIG, BK_DIALOG_DATA, BK_DIALOG_GLOBAL_CONFIG, BkAvatar, BkAvatarUploader, BkBadge, BkButton, BkButtonGroup, BkCalendarManagerService, BkCheckbox, BkColumnFilterService, BkColumnSelect, BkCustomCalendar, BkDialogActions, BkDialogClose, BkDialogContent, BkDialogModule, BkDialogRef, BkDialogService, BkDialogTitle, BkFileCard, BkFilePicker, BkGrid, BkHierarchicalSelect, BkIconButton, BkInput, BkInputChips, BkLoader, BkPagination, BkPill, BkRadioButton, BkScheduledDatePicker, BkSelect, BkSpinner, BkTabs, BkTextarea, BkTimePicker, BkToastr, BkToastrService, BkToggle, BkValidator, BrickclayIcons, BrickclayLib, CalendarModule, CalendarSelection, ColumnFilterOption, getDialogBackdropAnimation, getDialogPanelAnimation };
-export type { AvatarFallback, AvatarSize, AvatarVariant, BadgeColor, BadgeSize, BadgeVariant, BkAnimationKeyframes, BkAvatarFallback, BkAvatarSize, BkDialogAnimation, BkDialogConfig, BkDialogPosition, BkInputAutoCapitalize, BkInputAutoComplete, BkInputMode, BkInputType, BkLoaderVariant, BkPageSize, BkTextAreaAutoCapitalize, BkTextAreaAutoComplete, BkTextAreaInputMode, ButtonSize, ButtonVariant, CalendarRange, CountryOption, DotPosition, DotStatus, FileState, GroupItem, GroupMode, HierarchicalNode, IconButtonSize, IconButtonVariant, IconOrientation, PillColor, PillSize, PillVariant, ScheduledDateSelection, SortDirection, SpinnerSize, TabIconDirection, TabItem, TableAction, TableBadge, TableColumn, TableIcon, TimeConfiguration, ToastConfig, ToastMessage, ToastMethodOptions, ToastPosition, ToastSeverity };
+export type { AvatarFallback, AvatarSize, AvatarVariant, BadgeColor, BadgeSize, BadgeVariant, BkAnimationKeyframes, BkAvatarFallback, BkAvatarSize, BkDialogAnimation, BkDialogConfig, BkDialogPosition, BkInputAutoCapitalize, BkInputAutoComplete, BkInputMode, BkInputType, BkLoaderVariant, BkPageSize, BkTextAreaAutoCapitalize, BkTextAreaAutoComplete, BkTextAreaInputMode, ButtonSize, ButtonVariant, CalendarRange, CountryOption, CustomRangesConfig, DotPosition, DotStatus, FileState, GroupItem, GroupMode, HierarchicalNode, IconButtonSize, IconButtonVariant, IconOrientation, PillColor, PillSize, PillVariant, ScheduledDateSelection, SortDirection, SpinnerSize, TabIconDirection, TabItem, TableAction, TableBadge, TableColumn, TableIcon, TimeConfiguration, ToastConfig, ToastMessage, ToastMethodOptions, ToastPosition, ToastSeverity };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brickclay-org/ui",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "schematics": "./schematics/collection.json",
   "ng-add": {
     "save": "dependencies"