ud-components 0.5.19 → 0.5.21

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

@@ -1,5 +1,5 @@
 import { OnDestroy, TemplateRef } from '@angular/core';
-import { CalendarMode, CalendarSlot, CalendarView } from './calendar.interface';
+import { CalendarMode, CalendarSlot, CalendarUser, CalendarView } from './calendar.interface';
 import * as i0 from "@angular/core";
 export declare class CalendarComponent implements OnDestroy {
     slots: import("@angular/core").InputSignal<CalendarSlot[]>;
@@ -8,6 +8,18 @@ export declare class CalendarComponent implements OnDestroy {
     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>;
@@ -20,6 +32,8 @@ export declare class CalendarComponent implements OnDestroy {
     }[];
     private readonly CELL_H;
     private readonly TIME_COL_W;
+    /** Drag snapping granularity, in minutes. */
+    private readonly SNAP_MIN;
     private dialog;
     private elRef;
     private overlay;
@@ -89,16 +103,18 @@ export declare class CalendarComponent implements OnDestroy {
     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/lib/preview-container/preview-container.component.d.ts

@@ -3,6 +3,9 @@ export declare class UdPreviewContainerComponent {
     title: string;
     icon?: string;
     padding: string;
+    /** Whether the panel starts collapsed. */
+    collapsed: boolean;
+    toggle(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<UdPreviewContainerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<UdPreviewContainerComponent, "ud-preview-container", never, { "title": { "alias": "title"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; }, {}, never, ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<UdPreviewContainerComponent, "ud-preview-container", never, { "title": { "alias": "title"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; "collapsed": { "alias": "collapsed"; "required": false; }; }, {}, never, ["*"], true, never>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ud-components",
-  "version": "0.5.19",
+  "version": "0.5.21",
   "peerDependencies": {
     "@angular/cdk": ">=19",
     "@angular/common": ">=19",