ud-components 0.5.18 → 0.5.20

package/lib/calendar/calendar.component.d.ts

@@ -1,12 +1,25 @@
-import { CalendarMode, CalendarSlot, CalendarView } from './calendar.interface';
+import { OnDestroy, TemplateRef } from '@angular/core';
+import { CalendarMode, CalendarSlot, CalendarUser, CalendarView } from './calendar.interface';
 import * as i0 from "@angular/core";
-export declare class CalendarComponent {
+export declare class CalendarComponent implements OnDestroy {
     slots: import("@angular/core").InputSignal<CalendarSlot[]>;
     mode: import("@angular/core").InputSignal<CalendarMode>;
     defaultView: import("@angular/core").InputSignal<CalendarView>;
     slotDuration: import("@angular/core").InputSignal<number>;
     minHour: import("@angular/core").InputSignal<number>;
     maxHour: import("@angular/core").InputSignal<number>;
+    /**
+     * Max height of the scrollable week/day grid as any CSS length (e.g. '720px',
+     * '80vh', 'none'). Defaults to '580px'. Use 'none' to let the grid grow with
+     * its content / the host's height.
+     */
+    maxHeight: import("@angular/core").InputSignal<string>;
+    /**
+     * Optional list of users an admin can book a slot on behalf of. When provided,
+     * the "Booked By" field becomes a searchable autocomplete; otherwise it stays a
+     * free-text input.
+     */
+    bookableUsers: import("@angular/core").InputSignal<CalendarUser[]>;
     slotAdded: import("@angular/core").OutputEmitterRef<CalendarSlot>;
     slotUpdated: import("@angular/core").OutputEmitterRef<CalendarSlot>;
     slotRemoved: import("@angular/core").OutputEmitterRef<string>;
@@ -19,8 +32,12 @@ export declare class CalendarComponent {
     }[];
     private readonly CELL_H;
     private readonly TIME_COL_W;
+    /** Drag snapping granularity, in minutes. */
+    private readonly SNAP_MIN;
     private dialog;
     private elRef;
+    private overlay;
+    private vcr;
     draggingSlot: CalendarSlot | null;
     dragMoved: boolean;
     dragTarget: {
@@ -30,7 +47,12 @@ export declare class CalendarComponent {
     } | null;
     private dragSlotDurationMin;
     private dragStartPos;
+    hoverCardTpl: import("@angular/core").Signal<TemplateRef<unknown> | undefined>;
+    hoverSlot: import("@angular/core").WritableSignal<CalendarSlot | null>;
+    private hoverRef;
+    private hoverCloseTimer;
     constructor();
+    ngOnDestroy(): void;
     timeSlots: import("@angular/core").Signal<{
         hour: number;
         minute: number;
@@ -44,6 +66,21 @@ export declare class CalendarComponent {
     switchView(view: CalendarView): void;
     clickDay(day: Date): void;
     slotsForDay(day: Date): CalendarSlot[];
+    private readonly COL_GAP_PCT;
+    slotLayout: import("@angular/core").Signal<Map<string, {
+        leftPct: number;
+        widthPct: number;
+    }>>;
+    private layoutCluster;
+    slotLeft(slot: CalendarSlot): number;
+    slotWidth(slot: CalendarSlot): number;
+    slotDensity(slot: CalendarSlot): 'comfortable' | 'cozy' | 'compact';
+    slotDurationLabel(slot: CalendarSlot): string;
+    slotInitials(name: string): string;
+    openHoverCard(slot: CalendarSlot, anchor: EventTarget | null): void;
+    closeHoverCard(): void;
+    cancelHoverClose(): void;
+    private disposeHoverCard;
     slotTop(slot: CalendarSlot): number;
     slotHeight(slot: CalendarSlot): number;
     slotBg(slot: CalendarSlot): string;
@@ -66,16 +103,18 @@ export declare class CalendarComponent {
     private getGridTarget;
     openAddModal(day?: Date, hour?: number, minute?: number): void;
     openEditModal(slot: CalendarSlot): void;
+    private get slotFormErrors();
+    private slotTimeValidator;
     private buildForm;
     private slotForms;
     private buildSlot;
-    private shiftTimeStr;
-    private applyTimeStr;
+    private combineDateTime;
+    private shiftTime;
     private getMonday;
     isSameDay(a: Date, b: Date): boolean;
     private formatHour;
     private formatTime;
     private hexToRgba;
     static ɵfac: i0.ɵɵFactoryDeclaration<CalendarComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CalendarComponent, "ud-calendar", never, { "slots": { "alias": "slots"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "defaultView": { "alias": "defaultView"; "required": false; "isSignal": true; }; "slotDuration": { "alias": "slotDuration"; "required": false; "isSignal": true; }; "minHour": { "alias": "minHour"; "required": false; "isSignal": true; }; "maxHour": { "alias": "maxHour"; "required": false; "isSignal": true; }; }, { "slotAdded": "slotAdded"; "slotUpdated": "slotUpdated"; "slotRemoved": "slotRemoved"; "slotBooked": "slotBooked"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CalendarComponent, "ud-calendar", never, { "slots": { "alias": "slots"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "defaultView": { "alias": "defaultView"; "required": false; "isSignal": true; }; "slotDuration": { "alias": "slotDuration"; "required": false; "isSignal": true; }; "minHour": { "alias": "minHour"; "required": false; "isSignal": true; }; "maxHour": { "alias": "maxHour"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "bookableUsers": { "alias": "bookableUsers"; "required": false; "isSignal": true; }; }, { "slotAdded": "slotAdded"; "slotUpdated": "slotUpdated"; "slotRemoved": "slotRemoved"; "slotBooked": "slotBooked"; }, never, never, true, never>;
 }

package/lib/calendar/calendar.interface.d.ts

@@ -4,8 +4,35 @@ export interface CalendarSlot {
     start: Date;
     end: Date;
     booked?: boolean;
+    /** Display name of who booked the slot. */
     bookedBy?: string;
+    /** Optional id of the booked user when chosen from `bookableUsers`. */
+    bookedById?: string;
     color?: string;
 }
+/** A selectable user for the admin "book on behalf of" autocomplete. */
+export interface CalendarUser {
+    /** Stable id stored on the slot as `bookedById`. */
+    value: string;
+    /** Human-readable name shown in the field and on the slot. */
+    label: string;
+}
 export type CalendarView = 'week' | 'month' | 'day';
 export type CalendarMode = 'admin' | 'student' | 'readonly';
+/**
+ * Curated slot colours. Assign one to `CalendarSlot.color` for a consistent,
+ * on-brand palette instead of hand-picking hex values — the calendar tints these
+ * automatically for the slot fill, border and text. `Navy` is the default brand
+ * tone used for booked appointments.
+ */
+export declare enum CalendarSlotColor {
+    Navy = "#1b2535",
+    Blue = "#2563eb",
+    Teal = "#0d9488",
+    Green = "#16a34a",
+    Amber = "#d97706",
+    Red = "#dc2626",
+    Purple = "#7c3aed",
+    Pink = "#db2777",
+    Slate = "#475569"
+}

package/lib/form-fields/time-picker/time-picker.component.d.ts

@@ -13,14 +13,22 @@ export declare class TimePickerComponent implements OnInit, OnChanges {
     }[] | null;
     disabled: boolean;
     hint: string;
+    /** Earliest selectable hour (0–23). Restricts both the dropdown and typed input. */
+    minHour?: number;
+    /** Latest selectable hour (0–24). Restricts both the dropdown and typed input. */
+    maxHour?: number;
     focused: boolean;
     matOptions: MatTimepickerOption<Date>[];
+    minTime: Date | null;
+    maxTime: Date | null;
     protected controlContainer: ControlContainer;
     get control(): FormControl;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    private updateBounds;
     private buildOptions;
+    private atHour;
     private formatTime;
     static ɵfac: i0.ɵɵFactoryDeclaration<TimePickerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TimePickerComponent, "ud-time-picker", never, { "controlName": { "alias": "controlName"; "required": true; }; "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "intervalMinutes": { "alias": "intervalMinutes"; "required": false; }; "options": { "alias": "options"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TimePickerComponent, "ud-time-picker", never, { "controlName": { "alias": "controlName"; "required": true; }; "label": { "alias": "label"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "intervalMinutes": { "alias": "intervalMinutes"; "required": false; }; "options": { "alias": "options"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "hint": { "alias": "hint"; "required": false; }; "minHour": { "alias": "minHour"; "required": false; }; "maxHour": { "alias": "maxHour"; "required": false; }; }, {}, never, never, true, never>;
 }

package/lib/modal/modal.component.d.ts

@@ -28,6 +28,10 @@ export declare class ModalComponent {
     cancel: EventEmitter<void>;
     protected form?: FormGroup;
     protected modalInputType: typeof ModalInputType;
+    protected objectKeys: {
+        (o: object): string[];
+        (o: {}): string[];
+    };
     protected pictureUrls?: string[];
     protected currentPictureIndex?: number;
     data: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ud-components",
-  "version": "0.5.18",
+  "version": "0.5.20",
   "peerDependencies": {
     "@angular/cdk": ">=19",
     "@angular/common": ">=19",
@@ -21,6 +21,30 @@
     ".": {
       "types": "./index.d.ts",
       "default": "./fesm2022/ud-components.mjs"
+    },
+    "./enums/role.enum": {
+      "types": "./enums/role.enum.d.ts",
+      "default": "./enums/role.enum.js"
+    },
+    "./lib/kpi/kpi.enum": {
+      "types": "./lib/kpi/kpi.enum.d.ts",
+      "default": "./lib/kpi/kpi.enum.js"
+    },
+    "./lib/edit-view/edit-view-section.directive": {
+      "types": "./lib/edit-view/edit-view-section.directive.d.ts",
+      "default": "./lib/edit-view/edit-view-section.directive.js"
+    },
+    "./interfaces/page-request.interface": {
+      "types": "./interfaces/page-request.interface.d.ts",
+      "default": "./interfaces/page-request.interface.js"
+    },
+    "./interfaces/table.interface": {
+      "types": "./interfaces/table.interface.d.ts",
+      "default": "./interfaces/table.interface.js"
+    },
+    "./interfaces/table-display-column.interface": {
+      "types": "./interfaces/table-display-column.interface.d.ts",
+      "default": "./interfaces/table-display-column.interface.js"
     }
   }
-}
+}