ud-components 0.5.21 → 0.5.23

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

@@ -1,5 +1,5 @@
 import { OnDestroy, TemplateRef } from '@angular/core';
-import { CalendarMode, CalendarSlot, CalendarUser, CalendarView } from './calendar.interface';
+import { CalendarMode, CalendarSlot, CalendarUser, CalendarView, RescheduleContext } from './calendar.interface';
 import * as i0 from "@angular/core";
 export declare class CalendarComponent implements OnDestroy {
     slots: import("@angular/core").InputSignal<CalendarSlot[]>;
@@ -20,10 +20,44 @@ export declare class CalendarComponent implements OnDestroy {
      * free-text input.
      */
     bookableUsers: import("@angular/core").InputSignal<CalendarUser[]>;
+    /**
+     * Optional cutoff: any cell whose start is strictly before this Date is
+     * visually disabled (grey, no hover, no cursor) and click-blocked. The
+     * "Add slot" toolbar button pre-fills the modal with this timestamp
+     * (rounded up to the next `slotDuration` increment) instead of `new Date()`.
+     * The modal's save handler also refuses to emit if a hand-edited time
+     * lands before the cutoff. Applies to both admin and student modes.
+     */
+    minSlotStart: import("@angular/core").InputSignal<Date | null>;
+    /**
+     * Optional initial calendar position. Overrides the internal `navDate`
+     * which otherwise defaults to "today / now". Useful for reschedule flows
+     * or deep links that should land on a specific day.
+     */
+    defaultDate: import("@angular/core").InputSignal<Date | null>;
+    /**
+     * When set, the "Add slot" modal flips into reschedule mode:
+     *   • title becomes "Move appointment"
+     *   • a lede shows the original time being moved away from
+     *   • the user picker auto-selects the lone bookable user (or `userId` if
+     *     provided) so the admin doesn't have to choose from a list of one
+     *   • Booked defaults to true (a reschedule keeps a booking, not a fresh slot)
+     *   • the confirm button reads "Reschedule" instead of "Save"
+     *
+     * The wire-level event is still `slotAdded` — consumers route it to their
+     * reschedule API based on their own context (no extra output needed).
+     */
+    rescheduleContext: import("@angular/core").InputSignal<RescheduleContext | null>;
     slotAdded: import("@angular/core").OutputEmitterRef<CalendarSlot>;
     slotUpdated: import("@angular/core").OutputEmitterRef<CalendarSlot>;
     slotRemoved: import("@angular/core").OutputEmitterRef<string>;
     slotBooked: import("@angular/core").OutputEmitterRef<CalendarSlot>;
+    /** Fired when a user attempts to interact with a cell before `minSlotStart`. */
+    slotBlocked: import("@angular/core").OutputEmitterRef<{
+        start: Date;
+        end: Date;
+        reason: "before-min";
+    }>;
     activeView: import("@angular/core").WritableSignal<CalendarView>;
     navDate: import("@angular/core").WritableSignal<Date>;
     readonly viewOptions: {
@@ -87,11 +121,26 @@ export declare class CalendarComponent implements OnDestroy {
     slotTextColor(slot: CalendarSlot): string;
     slotBorderColor(slot: CalendarSlot): string;
     formatSlotTime(slot: CalendarSlot): string;
+    /**
+     * Pretty range like "Mon Jun 8 · 2:00 – 2:30 PM". Used by reschedule-mode's
+     * "Moving from …" lede so the admin sees where the appointment is coming
+     * from while picking the new time.
+     */
+    private formatMomentRange;
     isToday(day: Date): boolean;
     isCurrentMonth(day: Date): boolean;
     dayLabel(day: Date): string;
     dayNum(day: Date): number;
     onCellClick(day: Date, hour: number, minute: number): void;
+    /**
+     * True when the cell at (day, hour, minute) starts before `minSlotStart`.
+     * Templates bind a CSS class on this to grey out past cells; the click
+     * handler also bails so consumers don't see invalid `slotAdded` events.
+     */
+    isCellDisabled(day: Date, hour: number, minute: number): boolean;
+    /** True when `day` is fully before `minSlotStart` (used by month view). */
+    isDayDisabled(day: Date): boolean;
+    private combineDayTime;
     onSlotMouseDown(e: MouseEvent, slot: CalendarSlot): void;
     onDocMouseMove(e: MouseEvent): void;
     onDocMouseUp(e: MouseEvent): void;
@@ -102,6 +151,8 @@ export declare class CalendarComponent implements OnDestroy {
     previewHeight(): number;
     private getGridTarget;
     openAddModal(day?: Date, hour?: number, minute?: number): void;
+    /** Round a Date up to the next `slotDuration` increment (minute-aligned). */
+    private roundUpToSlot;
     openEditModal(slot: CalendarSlot): void;
     private get slotFormErrors();
     private slotTimeValidator;
@@ -116,5 +167,5 @@ export declare class CalendarComponent implements OnDestroy {
     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; }; "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>;
+    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; }; "minSlotStart": { "alias": "minSlotStart"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "rescheduleContext": { "alias": "rescheduleContext"; "required": false; "isSignal": true; }; }, { "slotAdded": "slotAdded"; "slotUpdated": "slotUpdated"; "slotRemoved": "slotRemoved"; "slotBooked": "slotBooked"; "slotBlocked": "slotBlocked"; }, never, never, true, never>;
 }

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

@@ -19,6 +19,28 @@ export interface CalendarUser {
 }
 export type CalendarView = 'week' | 'month' | 'day';
 export type CalendarMode = 'admin' | 'student' | 'readonly';
+/**
+ * Context the host supplies when the calendar should be used to *move* an
+ * existing booking instead of creating a new one. When set on
+ * `<ud-calendar [rescheduleContext]>`, the add-slot modal flips into
+ * "move appointment" mode (title, lede, save label, defaults).
+ *
+ * The component does not call any reschedule API itself — it still emits
+ * `slotAdded` with the picked slot and the host decides whether to POST a
+ * new booking or PUT a reschedule.
+ */
+export interface RescheduleContext {
+    /** The current appointment's start, used in the modal's "Moving from …" lede. */
+    originalStart: Date;
+    /** The current appointment's end — paired with `originalStart` for the label. */
+    originalEnd: Date;
+    /**
+     * Optional id of the user the appointment belongs to. When provided, the
+     * add-slot modal pre-selects this user in the `bookableUsers` picker so the
+     * admin doesn't have to choose from a list of one.
+     */
+    userId?: string;
+}
 /**
  * Curated slot colours. Assign one to `CalendarSlot.color` for a consistent,
  * on-brand palette instead of hand-picking hex values — the calendar tints these

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ud-components",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "peerDependencies": {
     "@angular/cdk": ">=19",
     "@angular/common": ">=19",
@@ -21,30 +21,6 @@
     ".": {
       "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"
     }
   }
-}
+}