@acorex/components 21.0.1-next.2 → 21.0.1-next.3

package/scheduler/index.d.ts

@@ -1,7 +1,7 @@
 import { AXRange, NXNativeEvent, NXComponent, NXEvent, AXValueChangedEvent } from '@acorex/cdk/common';
 import { AXDateTime, AXHolidayDate } from '@acorex/core/date-time';
 import * as _angular_core from '@angular/core';
-import { OnInit, TemplateRef, AfterViewInit, ElementRef } from '@angular/core';
+import { OnInit, AfterViewInit, TemplateRef, OnDestroy, ElementRef } from '@angular/core';
 import { AXDropZoneDropEvent } from '@acorex/cdk/drag-drop';
 
 type AXSchedulerView = 'day' | 'week' | 'month' | 'timeline-day' | 'timeline-multi-day' | 'timeline-month' | 'timeline-year' | 'agenda';
@@ -68,6 +68,21 @@ type AXSchedulerResource = {
     title: string;
     description?: string;
 };
+/**
+ * Result of calculating updated appointment data after a drag-and-drop operation.
+ */
+type AXSchedulerAppointmentDropResult = {
+    /** The new start date for the appointment */
+    startDate: Date;
+    /** The new end date for the appointment */
+    endDate: Date;
+    /** Whether the appointment should be marked as all-day */
+    allDay: boolean;
+    /** The new resource ID (if applicable) */
+    resourceId?: unknown;
+    /** Whether the drop was on the same slot (no change needed) */
+    isSameSlotDrop: boolean;
+};
 
 interface AXSchedulerAppointmentMouseEvent extends NXNativeEvent<AXSchedulerComponent, MouseEvent> {
     appointment: AXSchedulerAppointment;
@@ -90,7 +105,7 @@ interface AXSchedulerSlotDropEvent extends NXEvent<AXSchedulerComponent> {
     };
     isSameSlotDrop: boolean;
 }
-declare class AXSchedulerComponent extends NXComponent implements OnInit {
+declare class AXSchedulerComponent extends NXComponent implements OnInit, AfterViewInit {
     #private;
     private platformId;
     private unsubscriber;
@@ -115,6 +130,7 @@ declare class AXSchedulerComponent extends NXComponent implements OnInit {
         text: string;
     }[]>;
     private prevDate;
+    protected selectedAppointmentId: _angular_core.WritableSignal<string | number>;
     endDayHour: _angular_core.InputSignal<number>;
     startDayHour: _angular_core.InputSignal<number>;
     hasHeader: _angular_core.InputSignal<boolean>;
@@ -155,6 +171,7 @@ declare class AXSchedulerComponent extends NXComponent implements OnInit {
     protected handleAppointmentRightClickInternal(eventData: AXSchedulerAppointmentMouseEvent): void;
     protected handleAppointmentDropInternal(eventData: AXSchedulerSlotDropEvent): void;
     ngOnInit(): void;
+    ngAfterViewInit(): void;
     private fillDataSource;
     private getGridDateRange;
     currentDateText: _angular_core.Signal<string>;
@@ -197,12 +214,15 @@ declare class AXSchedulerComponent extends NXComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerComponent, "ax-scheduler", never, { "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "startingDate": { "alias": "startingDate"; "required": false; "isSignal": true; }; "endDayHour": { "alias": "endDayHour"; "required": false; "isSignal": true; }; "startDayHour": { "alias": "startDayHour"; "required": false; "isSignal": true; }; "hasHeader": { "alias": "hasHeader"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "weekend": { "alias": "weekend"; "required": false; "isSignal": true; }; "allowFullScreen": { "alias": "allowFullScreen"; "required": false; "isSignal": true; }; "multiDayViewDaysCount": { "alias": "multiDayViewDaysCount"; "required": false; "isSignal": true; }; "showResourceHeaders": { "alias": "showResourceHeaders"; "required": false; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "showUnassignedAppointments": { "alias": "showUnassignedAppointments"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "resourceTemplate": { "alias": "resourceTemplate"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "holidays": { "alias": "holidays"; "required": false; "isSignal": true; }; "views": { "alias": "views"; "required": false; "isSignal": true; }; "selectedView": { "alias": "selectedView"; "required": false; "isSignal": true; }; }, { "selectedView": "selectedViewChange"; "onDataLoaded": "onDataLoaded"; "onRangeChanged": "onRangeChanged"; "onSlotClicked": "onSlotClicked"; "onSlotDblClicked": "onSlotDblClicked"; "onSlotRightClick": "onSlotRightClick"; "onAppointmentDrop": "onAppointmentDrop"; "onActionClick": "onActionClick"; "onAppointmentClicked": "onAppointmentClicked"; "onAppointmentDblClicked": "onAppointmentDblClicked"; "onAppointmentRightClick": "onAppointmentRightClick"; }, never, never, true, never>;
 }
 
-declare class AXSchedulerDayViewComponent extends NXComponent implements AfterViewInit {
+declare class AXSchedulerDayViewComponent extends NXComponent implements AfterViewInit, OnDestroy {
     private document;
+    private destroyRef;
     private scheduler;
     private calendarService;
     private schedulerService;
     readonly GAP_PX = 1;
+    private resizeObserverCleanup;
+    rtl: _angular_core.InputSignal<boolean>;
     readonly: _angular_core.InputSignal<boolean>;
     draggable: _angular_core.InputSignal<boolean>;
     hasActions: _angular_core.InputSignal<boolean>;
@@ -214,10 +234,12 @@ declare class AXSchedulerDayViewComponent extends NXComponent implements AfterVi
     showCurrentTimeIndicator: _angular_core.InputSignal<boolean>;
     appointments: _angular_core.InputSignal<AXSchedulerAppointment[]>;
     tooltipTemplate: _angular_core.InputSignal<string | TemplateRef<unknown>>;
+    selectedAppointmentId: _angular_core.InputSignal<string | number>;
+    protected isActive(appointmentId: string | number): boolean;
     currentTimeLineElement: _angular_core.Signal<ElementRef<HTMLElement>>;
     private dragStartSlotId;
     private processedAppointmentsForLayout;
-    protected allDayAppointments: _angular_core.Signal<AXSchedulerAppointment[]>;
+    protected allDayAppointments: _angular_core.Signal<AXSchedulerAppointmentSegment[]>;
     protected singleDayAppointments: _angular_core.Signal<AXSchedulerAppointmentSegment[]>;
     slotClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
     slotDblClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
@@ -244,24 +266,34 @@ declare class AXSchedulerDayViewComponent extends NXComponent implements AfterVi
     protected getCurrentTimePosition(): number | null;
     protected getCurrentTimePositionWithOffset(): string | null;
     ngAfterViewInit(): void;
+    ngOnDestroy(): void;
     private setupCurrentTimeScroll;
     protected getSlotId(e: PointerEvent): void;
-    protected get isReadonly(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSchedulerDayViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerDayViewComponent, "ax-scheduler-day-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "endDayHour": { "alias": "endDayHour"; "required": true; "isSignal": true; }; "startDayHour": { "alias": "startDayHour"; "required": true; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerDayViewComponent, "ax-scheduler-day-view", never, { "rtl": { "alias": "rtl"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "endDayHour": { "alias": "endDayHour"; "required": true; "isSignal": true; }; "startDayHour": { "alias": "startDayHour"; "required": true; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "selectedAppointmentId": { "alias": "selectedAppointmentId"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
 }
 
 type AXSchedulerGridBadgeInfo = AXSchedulerOverflowBadge & {
     hiddenAppointments: AXSchedulerAppointmentSegment[];
 };
-declare class AXSchedulerWeekViewComponent extends NXComponent implements AfterViewInit {
+type AXSchedulerWeekSpanningAppointment = {
+    appointment: AXSchedulerAppointment;
+    startDayIndex: number;
+    spanCount: number;
+    rowIndex: number;
+    isStartClipped: boolean;
+    isEndClipped: boolean;
+};
+declare class AXSchedulerWeekViewComponent extends NXComponent implements AfterViewInit, OnDestroy {
     private readonly document;
+    private readonly destroyRef;
     private readonly scheduler;
     private readonly calendarService;
     private readonly schedulerService;
     private readonly dragStartSlotId;
     private readonly GAP_PX;
     private readonly BADGE_SPACE_REM;
+    private resizeObserverCleanup;
     readonly: _angular_core.InputSignal<boolean>;
     draggable: _angular_core.InputSignal<boolean>;
     hasActions: _angular_core.InputSignal<boolean>;
@@ -273,6 +305,8 @@ declare class AXSchedulerWeekViewComponent extends NXComponent implements AfterV
     showCurrentTimeIndicator: _angular_core.InputSignal<boolean>;
     appointments: _angular_core.InputSignal<AXSchedulerAppointment[]>;
     tooltipTemplate: _angular_core.InputSignal<string | TemplateRef<unknown>>;
+    selectedAppointmentId: _angular_core.InputSignal<string | number>;
+    protected isActive(appointmentId: string | number): boolean;
     currentTimeLineElement: _angular_core.Signal<ElementRef<HTMLElement>>;
     protected readonly slotClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
     protected readonly slotDblClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
@@ -305,9 +339,14 @@ declare class AXSchedulerWeekViewComponent extends NXComponent implements AfterV
      * Calculates the total number of 30-minute blocks within the visible hours of a single day.
      */
     protected totalBlocksPerViewDay: _angular_core.Signal<number>;
+    private isMultiDayAppointment;
+    protected spanningAppointments: _angular_core.Signal<AXSchedulerWeekSpanningAppointment[]>;
+    private multiDayAppointmentIds;
+    protected maxSpanningRowIndex: _angular_core.Signal<number>;
     /**
      * @protected
-     * Filters processed segments to get only those for the all-day header.
+     * Filters processed segments to get only single-day all-day appointments for the all-day header.
+     * Multi-day appointments are rendered separately as spanning bars.
      */
     protected allDayAppointmentsPerDay: _angular_core.Signal<AXSchedulerAllDaySlotData[]>;
     /**
@@ -401,13 +440,13 @@ declare class AXSchedulerWeekViewComponent extends NXComponent implements AfterV
     protected getCurrentDayColumnPosition(): string | null;
     protected getCurrentDayColumnWidth(): string;
     ngAfterViewInit(): void;
+    ngOnDestroy(): void;
     private setupCurrentTimeScroll;
     protected shouldShowCurrentTimeForToday(): boolean;
-    protected get isReadonly(): boolean;
     private processedAppointmentsForLayout;
     private timedGridSegments;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSchedulerWeekViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerWeekViewComponent, "ax-scheduler-week-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "endDayHour": { "alias": "endDayHour"; "required": true; "isSignal": true; }; "startDayHour": { "alias": "startDayHour"; "required": true; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerWeekViewComponent, "ax-scheduler-week-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "endDayHour": { "alias": "endDayHour"; "required": true; "isSignal": true; }; "startDayHour": { "alias": "startDayHour"; "required": true; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "selectedAppointmentId": { "alias": "selectedAppointmentId"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
 }
 
 type AXSchedulerMonthDayCell = {
@@ -421,6 +460,15 @@ type AXSchedulerMonthDayCell = {
     visibleAppointments: AXSchedulerAppointmentSegment[];
     hiddenAppointments: AXSchedulerAppointmentSegment[];
     overflowCount: number;
+    gridIndex: number;
+};
+type AXSchedulerSpanningAppointment = {
+    appointment: AXSchedulerAppointment;
+    gridStartIndex: number;
+    spanCount: number;
+    rowIndex: number;
+    isStartClipped: boolean;
+    isEndClipped: boolean;
 };
 declare class AXSchedulerMonthViewComponent extends NXComponent {
     private document;
@@ -435,6 +483,8 @@ declare class AXSchedulerMonthViewComponent extends NXComponent {
     date: _angular_core.InputSignal<AXDateTime>;
     appointments: _angular_core.InputSignal<AXSchedulerAppointment[]>;
     firstDayOfWeek: _angular_core.InputSignal<AXDayOfWeekName>;
+    selectedAppointmentId: _angular_core.InputSignal<string | number>;
+    protected isActive(appointmentId: string | number): boolean;
     tooltipTemplate: _angular_core.InputSignal<string | TemplateRef<unknown>>;
     readonly DAYS_IN_WEEK = 7;
     readonly MAX_VISIBLE_APPOINTMENTS_PER_DAY = 2;
@@ -455,13 +505,20 @@ declare class AXSchedulerMonthViewComponent extends NXComponent {
     private monthStartDate;
     protected daysArray: _angular_core.Signal<AXDateTime[]>;
     private calendarDaysInfo;
-    private appointmentsGroupedByDay;
+    private isMultiDayAppointment;
+    protected spanningAppointments: _angular_core.Signal<AXSchedulerSpanningAppointment[]>;
+    private multiDayAppointmentIds;
     protected dayCellLayouts: _angular_core.Signal<AXSchedulerMonthDayCell[]>;
     protected gridTemplateRowsStyle: _angular_core.Signal<string>;
     protected getSlotId(e: PointerEvent): void;
-    protected get isReadonly(): boolean;
+    protected getSpanningAppointmentStyle(spanning: AXSchedulerSpanningAppointment): Record<string, string>;
+    protected spanningAppointmentsByWeekRow: _angular_core.Signal<Map<number, AXSchedulerSpanningAppointment[]>>;
+    protected weekRowsArray: _angular_core.Signal<number[]>;
+    protected getSpanningAppointmentsForWeekRow(weekRowIndex: number): AXSchedulerSpanningAppointment[];
+    protected maxSpanningRowsPerWeek: _angular_core.Signal<Map<number, number>>;
+    protected getSpanningRowsCountForDayCell(gridIndex: number): number;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSchedulerMonthViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerMonthViewComponent, "ax-scheduler-month-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerMonthViewComponent, "ax-scheduler-month-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "selectedAppointmentId": { "alias": "selectedAppointmentId"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
 }
 
 interface AgendaDayData {
@@ -486,6 +543,8 @@ declare class AXSchedulerAgendaViewComponent extends NXComponent {
     date: _angular_core.InputSignal<AXDateTime>;
     appointments: _angular_core.InputSignal<AXSchedulerAppointment[]>;
     tooltipTemplate: _angular_core.InputSignal<string | TemplateRef<unknown>>;
+    selectedAppointmentId: _angular_core.InputSignal<string | number>;
+    protected isActive(appointmentId: string | number): boolean;
     private dragStartSlotId;
     protected agendaDaysLayout: _angular_core.Signal<AgendaDayData[]>;
     slotClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
@@ -507,16 +566,29 @@ declare class AXSchedulerAgendaViewComponent extends NXComponent {
         holiday?: AXHolidayDate;
     };
     protected getSlotId(e: PointerEvent): void;
-    protected get isReadonly(): boolean;
+    /**
+     * Checks if an appointment spans multiple days.
+     * Returns true if the appointment covers more than one calendar day.
+     */
+    protected isMultiDayAppointment(segment: AXSchedulerAppointmentSegment): boolean;
+    /**
+     * Gets the formatted date range for multi-day appointments.
+     * Returns the start and end dates formatted for display (e.g., "7 Dec", "21 Dec").
+     * Supports Persian calendar through the calendar input.
+     */
+    protected getMultiDayStartDate(segment: AXSchedulerAppointmentSegment): Date;
+    protected getMultiDayEndDate(segment: AXSchedulerAppointmentSegment): Date;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSchedulerAgendaViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerAgendaViewComponent, "ax-scheduler-agenda-view", never, { "daysCount": { "alias": "daysCount"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerAgendaViewComponent, "ax-scheduler-agenda-view", never, { "daysCount": { "alias": "daysCount"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "selectedAppointmentId": { "alias": "selectedAppointmentId"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
 }
 
-declare class AXSchedulerTimelineDayViewComponent extends NXComponent implements AfterViewInit {
+declare class AXSchedulerTimelineDayViewComponent extends NXComponent implements AfterViewInit, OnDestroy {
     private document;
+    private destroyRef;
     private scheduler;
     private calendarService;
     private schedulerService;
+    private resizeObserverCleanup?;
     readonly GAP_PX = 1;
     readonly: _angular_core.InputSignal<boolean>;
     draggable: _angular_core.InputSignal<boolean>;
@@ -526,6 +598,8 @@ declare class AXSchedulerTimelineDayViewComponent extends NXComponent implements
     showResourceHeaders: _angular_core.InputSignal<boolean>;
     date: _angular_core.InputSignal<AXDateTime>;
     endDayHour: _angular_core.InputSignal<number>;
+    selectedAppointmentId: _angular_core.InputSignal<string | number>;
+    protected isActive(appointmentId: string | number): boolean;
     startDayHour: _angular_core.InputSignal<number>;
     showUnassignedAppointments: _angular_core.InputSignal<boolean>;
     resources: _angular_core.InputSignal<AXSchedulerResource[]>;
@@ -576,6 +650,7 @@ declare class AXSchedulerTimelineDayViewComponent extends NXComponent implements
     protected getCurrentTimePosition(): number | null;
     protected getCurrentTimePositionWithOffset(): string | null;
     ngAfterViewInit(): void;
+    ngOnDestroy(): void;
     private setupCurrentTimeScroll;
     /**
      * Gets appointment layouts for a specific resource with proper positioning.
@@ -590,13 +665,13 @@ declare class AXSchedulerTimelineDayViewComponent extends NXComponent implements
      */
     private calculateMaxOverlappingRows;
     protected getSlotId(e: PointerEvent): void;
-    protected get isReadonly(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSchedulerTimelineDayViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerTimelineDayViewComponent, "ax-scheduler-timeline-day-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "showResourceHeaders": { "alias": "showResourceHeaders"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "endDayHour": { "alias": "endDayHour"; "required": true; "isSignal": true; }; "startDayHour": { "alias": "startDayHour"; "required": true; "isSignal": true; }; "showUnassignedAppointments": { "alias": "showUnassignedAppointments"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "resourceTemplate": { "alias": "resourceTemplate"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerTimelineDayViewComponent, "ax-scheduler-timeline-day-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "showResourceHeaders": { "alias": "showResourceHeaders"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "endDayHour": { "alias": "endDayHour"; "required": true; "isSignal": true; }; "selectedAppointmentId": { "alias": "selectedAppointmentId"; "required": false; "isSignal": true; }; "startDayHour": { "alias": "startDayHour"; "required": true; "isSignal": true; }; "showUnassignedAppointments": { "alias": "showUnassignedAppointments"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "resourceTemplate": { "alias": "resourceTemplate"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
 }
 
 interface TimelineMonthViewDayData {
     date: AXDateTime;
+    dayIndex: number;
     visibleAppointments: AXSchedulerAppointmentSegment[];
     hiddenAppointments: AXSchedulerAppointmentSegment[];
     moreCount: number;
@@ -610,12 +685,28 @@ interface TimelineMonthViewDayData {
         moreCount: number;
     }>;
 }
-declare class AXSchedulerTimelineMonthViewComponent extends NXComponent implements AfterViewInit {
+type AXSchedulerTimelineSpanningAppointment = {
+    appointment: AXSchedulerAppointment;
+    startDayIndex: number;
+    spanCount: number;
+    rowIndex: number;
+    isStartClipped: boolean;
+    isEndClipped: boolean;
+};
+declare class AXSchedulerTimelineMonthViewComponent extends NXComponent implements AfterViewInit, OnDestroy {
     private document;
+    private destroyRef;
     private scheduler;
     private calendarService;
     private schedulerService;
+    private resizeObserverCleanup?;
     private readonly MAX_VISIBLE_APPOINTMENTS_PER_DAY;
+    private isMultiDayAppointment;
+    protected spanningAppointments: _angular_core.Signal<AXSchedulerTimelineSpanningAppointment[]>;
+    private multiDayAppointmentIds;
+    protected getSpanningAppointmentsForResource(resourceId: any): AXSchedulerTimelineSpanningAppointment[];
+    protected maxSpanningRows: _angular_core.Signal<number>;
+    protected getMaxSpanningRowsForResource(resourceId: any): number;
     readonly: _angular_core.InputSignal<boolean>;
     draggable: _angular_core.InputSignal<boolean>;
     hasActions: _angular_core.InputSignal<boolean>;
@@ -624,6 +715,8 @@ declare class AXSchedulerTimelineMonthViewComponent extends NXComponent implemen
     showResourceHeaders: _angular_core.InputSignal<boolean>;
     date: _angular_core.InputSignal<AXDateTime>;
     showUnassignedAppointments: _angular_core.InputSignal<boolean>;
+    selectedAppointmentId: _angular_core.InputSignal<string | number>;
+    protected isActive(appointmentId: string | number): boolean;
     resources: _angular_core.InputSignal<AXSchedulerResource[]>;
     showCurrentTimeIndicator: _angular_core.InputSignal<boolean>;
     resourceTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
@@ -670,6 +763,7 @@ declare class AXSchedulerTimelineMonthViewComponent extends NXComponent implemen
     protected getResourceContext(resourceId: any): AXSchedulerResource;
     protected getCurrentTimePosition(): number | null;
     ngAfterViewInit(): void;
+    ngOnDestroy(): void;
     private setupCurrentTimeScroll;
     /**
      * Gets appointments for a specific resource and day.
@@ -690,11 +784,22 @@ declare class AXSchedulerTimelineMonthViewComponent extends NXComponent implemen
      */
     protected calculateMaxOverlappingRows(appointments: AXSchedulerAppointmentSegment[]): number;
     protected shouldShowCurrentTimeForDay(dayDate: AXDateTime): boolean;
-    protected get isReadonly(): boolean;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSchedulerTimelineMonthViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerTimelineMonthViewComponent, "ax-scheduler-timeline-month-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "showResourceHeaders": { "alias": "showResourceHeaders"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "showUnassignedAppointments": { "alias": "showUnassignedAppointments"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "resourceTemplate": { "alias": "resourceTemplate"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerTimelineMonthViewComponent, "ax-scheduler-timeline-month-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "showResourceHeaders": { "alias": "showResourceHeaders"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "showUnassignedAppointments": { "alias": "showUnassignedAppointments"; "required": false; "isSignal": true; }; "selectedAppointmentId": { "alias": "selectedAppointmentId"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "resourceTemplate": { "alias": "resourceTemplate"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
 }
 
+/**
+ * Represents a spanning appointment in the timeline-multi-day view.
+ */
+interface AXSchedulerTimelineMultiDaySpanningAppointment {
+    appointment: AXSchedulerAppointment;
+    startDayIndex: number;
+    spanCount: number;
+    rowIndex: number;
+    isStartClipped: boolean;
+    isEndClipped: boolean;
+    resourceId?: unknown;
+}
 interface TimelineMultiDayDaySlot {
     date: AXDateTime;
     originalAppointmentsForThisDay: AXSchedulerAppointment[];
@@ -703,9 +808,12 @@ interface TimelineMultiDayDaySlot {
         holiday?: AXHolidayDate;
     };
 }
-declare class AXSchedulerTimelineMultiDayViewComponent extends NXComponent implements AfterViewInit {
+declare class AXSchedulerTimelineMultiDayViewComponent extends NXComponent implements AfterViewInit, OnDestroy {
+    private destroyRef;
+    private scheduler;
     private calendarService;
     private schedulerService;
+    private resizeObserverCleanup?;
     daysCount: _angular_core.InputSignal<number>;
     readonly: _angular_core.InputSignal<boolean>;
     draggable: _angular_core.InputSignal<boolean>;
@@ -715,6 +823,8 @@ declare class AXSchedulerTimelineMultiDayViewComponent extends NXComponent imple
     showResourceHeaders: _angular_core.InputSignal<boolean>;
     date: _angular_core.InputSignal<AXDateTime>;
     endDayHour: _angular_core.InputSignal<number>;
+    selectedAppointmentId: _angular_core.InputSignal<string | number>;
+    protected isActive(appointmentId: string | number): boolean;
     showCurrentTimeIndicator: _angular_core.InputSignal<boolean>;
     startDayHour: _angular_core.InputSignal<number>;
     showUnassignedAppointments: _angular_core.InputSignal<boolean>;
@@ -724,6 +834,42 @@ declare class AXSchedulerTimelineMultiDayViewComponent extends NXComponent imple
     tooltipTemplate: _angular_core.InputSignal<string | TemplateRef<unknown>>;
     currentTimeLineElement: _angular_core.Signal<ElementRef<HTMLElement>>;
     protected daysDataForTimelineViews: _angular_core.Signal<TimelineMultiDayDaySlot[]>;
+    /**
+     * Checks if an appointment spans multiple days.
+     */
+    private isMultiDayAppointment;
+    /**
+     * Computes spanning appointments for multi-day events across the view.
+     */
+    protected spanningAppointments: _angular_core.Signal<AXSchedulerTimelineMultiDaySpanningAppointment[]>;
+    /**
+     * Gets the set of multi-day appointment IDs to exclude from individual day views.
+     */
+    protected multiDayAppointmentIds: _angular_core.Signal<Set<unknown>>;
+    /**
+     * Gets spanning appointments filtered for a specific resource.
+     */
+    protected getSpanningAppointmentsForResource(resourceId: unknown): AXSchedulerTimelineMultiDaySpanningAppointment[];
+    /**
+     * Gets the maximum number of spanning rows for a resource.
+     */
+    protected getMaxSpanningRowsForResource(resourceId: unknown): number;
+    /**
+     * Gets the maximum number of spanning rows across all appointments (for non-resource layouts).
+     */
+    protected maxSpanningRows: _angular_core.Signal<number>;
+    /**
+     * Filters appointments for a day, excluding multi-day appointments.
+     */
+    protected getFilteredAppointmentsForDay(originalAppointments: AXSchedulerAppointment[]): AXSchedulerAppointment[];
+    /**
+     * Handles clicking on a spanning appointment.
+     */
+    protected handleSpanningAppointmentEvent(event: MouseEvent, appointment: AXSchedulerAppointment): void;
+    /**
+     * Handles action click on spanning appointment.
+     */
+    protected handleSpanningActionClick(event: MouseEvent, appointment: AXSchedulerAppointment): void;
     slotClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
     slotDblClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
     slotRightClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
@@ -754,6 +900,7 @@ declare class AXSchedulerTimelineMultiDayViewComponent extends NXComponent imple
     protected getCurrentTimePosition(): number | null;
     protected shouldShowCurrentTimeForDay(dayDate: AXDateTime): boolean;
     ngAfterViewInit(): void;
+    ngOnDestroy(): void;
     private setupCurrentTimeScroll;
     /**
      * Gets appointments for a specific resource and day.
@@ -762,7 +909,7 @@ declare class AXSchedulerTimelineMultiDayViewComponent extends NXComponent imple
     /**
      * Gets the height for a specific resource across all days.
      */
-    protected getResourceRowHeight(resourceId: any): string;
+    protected getResourceRowHeight(resourceId: unknown): string;
     /**
      * Calculates the maximum number of overlapping rows for a set of appointments.
      * Uses the actual segmented times that will be displayed in the timeline view.
@@ -781,11 +928,12 @@ declare class AXSchedulerTimelineMultiDayViewComponent extends NXComponent imple
         holiday?: AXHolidayDate;
     };
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSchedulerTimelineMultiDayViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerTimelineMultiDayViewComponent, "ax-scheduler-timeline-multi-day-view", never, { "daysCount": { "alias": "daysCount"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "showResourceHeaders": { "alias": "showResourceHeaders"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "endDayHour": { "alias": "endDayHour"; "required": true; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "startDayHour": { "alias": "startDayHour"; "required": true; "isSignal": true; }; "showUnassignedAppointments": { "alias": "showUnassignedAppointments"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "resourceTemplate": { "alias": "resourceTemplate"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerTimelineMultiDayViewComponent, "ax-scheduler-timeline-multi-day-view", never, { "daysCount": { "alias": "daysCount"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "showResourceHeaders": { "alias": "showResourceHeaders"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "endDayHour": { "alias": "endDayHour"; "required": true; "isSignal": true; }; "selectedAppointmentId": { "alias": "selectedAppointmentId"; "required": false; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "startDayHour": { "alias": "startDayHour"; "required": true; "isSignal": true; }; "showUnassignedAppointments": { "alias": "showUnassignedAppointments"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "resourceTemplate": { "alias": "resourceTemplate"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
 }
 
 interface TimelineYearViewDayData {
     date: AXDateTime;
+    dayIndex: number;
     visibleAppointments: AXSchedulerAppointmentSegment[];
     hiddenAppointments: AXSchedulerAppointmentSegment[];
     moreCount: number;
@@ -799,12 +947,28 @@ interface TimelineYearViewDayData {
         moreCount: number;
     }>;
 }
-declare class AXSchedulerTimelineYearViewComponent extends NXComponent implements AfterViewInit {
+type AXSchedulerTimelineYearSpanningAppointment = {
+    appointment: AXSchedulerAppointment;
+    startDayIndex: number;
+    spanCount: number;
+    rowIndex: number;
+    isStartClipped: boolean;
+    isEndClipped: boolean;
+};
+declare class AXSchedulerTimelineYearViewComponent extends NXComponent implements AfterViewInit, OnDestroy {
     private document;
+    private destroyRef;
     private scheduler;
     private calendarService;
     private schedulerService;
+    private resizeObserverCleanup?;
     private readonly MAX_VISIBLE_APPOINTMENTS_PER_DAY;
+    private isMultiDayAppointment;
+    protected spanningAppointments: _angular_core.Signal<AXSchedulerTimelineYearSpanningAppointment[]>;
+    private multiDayAppointmentIds;
+    protected getSpanningAppointmentsForResource(resourceId: any): AXSchedulerTimelineYearSpanningAppointment[];
+    protected maxSpanningRows: _angular_core.Signal<number>;
+    protected getMaxSpanningRowsForResource(resourceId: any): number;
     readonly: _angular_core.InputSignal<boolean>;
     draggable: _angular_core.InputSignal<boolean>;
     hasActions: _angular_core.InputSignal<boolean>;
@@ -813,6 +977,8 @@ declare class AXSchedulerTimelineYearViewComponent extends NXComponent implement
     showResourceHeaders: _angular_core.InputSignal<boolean>;
     date: _angular_core.InputSignal<AXDateTime>;
     showUnassignedAppointments: _angular_core.InputSignal<boolean>;
+    selectedAppointmentId: _angular_core.InputSignal<string | number>;
+    protected isActive(appointmentId: string | number): boolean;
     resources: _angular_core.InputSignal<AXSchedulerResource[]>;
     showCurrentTimeIndicator: _angular_core.InputSignal<boolean>;
     resourceTemplate: _angular_core.InputSignal<TemplateRef<unknown>>;
@@ -835,6 +1001,7 @@ declare class AXSchedulerTimelineYearViewComponent extends NXComponent implement
     protected getResourceContext(resourceId: any): AXSchedulerResource;
     protected getCurrentTimePosition(): number | null;
     ngAfterViewInit(): void;
+    ngOnDestroy(): void;
     private setupCurrentTimeScroll;
     slotClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
     slotDblClickedInternal: _angular_core.OutputEmitterRef<AXSchedulerSlotMouseEvent>;
@@ -852,7 +1019,7 @@ declare class AXSchedulerTimelineYearViewComponent extends NXComponent implement
     protected shouldShowCurrentTimeForDay(dayDate: AXDateTime): boolean;
     protected getSlotId(e: PointerEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSchedulerTimelineYearViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerTimelineYearViewComponent, "ax-scheduler-timeline-year-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "showResourceHeaders": { "alias": "showResourceHeaders"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "showUnassignedAppointments": { "alias": "showUnassignedAppointments"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "resourceTemplate": { "alias": "resourceTemplate"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXSchedulerTimelineYearViewComponent, "ax-scheduler-timeline-year-view", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "hasActions": { "alias": "hasActions"; "required": false; "isSignal": true; }; "dragStartDelay": { "alias": "dragStartDelay"; "required": false; "isSignal": true; }; "calendar": { "alias": "calendar"; "required": false; "isSignal": true; }; "showResourceHeaders": { "alias": "showResourceHeaders"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "showUnassignedAppointments": { "alias": "showUnassignedAppointments"; "required": false; "isSignal": true; }; "selectedAppointmentId": { "alias": "selectedAppointmentId"; "required": false; "isSignal": true; }; "resources": { "alias": "resources"; "required": false; "isSignal": true; }; "showCurrentTimeIndicator": { "alias": "showCurrentTimeIndicator"; "required": false; "isSignal": true; }; "resourceTemplate": { "alias": "resourceTemplate"; "required": false; "isSignal": true; }; "appointments": { "alias": "appointments"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; }, { "slotClickedInternal": "slotClickedInternal"; "slotDblClickedInternal": "slotDblClickedInternal"; "slotRightClickedInternal": "slotRightClickedInternal"; "appointmentClickedInternal": "appointmentClickedInternal"; "appointmentDblClickedInternal": "appointmentDblClickedInternal"; "appointmentRightClickedInternal": "appointmentRightClickedInternal"; "onActionClickInternal": "onActionClickInternal"; "onAppointmentDropInternal": "onAppointmentDropInternal"; }, never, never, true, never>;
 }
 
 declare class AXSchedulerModule {
@@ -1032,9 +1199,96 @@ declare class AXSchedulerService {
      * @returns string[] - Array of resource IDs.
      */
     getAllResourceIds(resources: AXSchedulerResource[], showUnassignedAppointments?: boolean): any[];
+    /**
+     * Calculates the updated appointment data after a drag-and-drop operation.
+     *
+     * This utility method handles the complex logic of preserving appointment duration
+     * when dropping an appointment on a new slot. It correctly handles:
+     * - Single-day timed events (preserves exact duration in milliseconds)
+     * - All-day events (preserves the day span)
+     * - Multi-day events (preserves the number of days spanned)
+     * - Day-based views (agenda, month): preserves original time of day
+     * - Time-slot views (day, week, timeline): uses the slot's time
+     * - Resource ID changes
+     *
+     * @param event - The drop event from the scheduler's onAppointmentDrop output.
+     * @returns AXSchedulerAppointmentDropResult - The calculated new appointment data,
+     *          or null if the drop was on the same slot (no change needed).
+     *
+     * @example
+     * ```typescript
+     * // In your component:
+     * handleAppointmentDrop(event: AXSchedulerSlotDropEvent) {
+     *   const result = this.schedulerService.calculateAppointmentDropResult(event);
+     *
+     *   if (result.isSameSlotDrop) {
+     *     return; // No change needed
+     *   }
+     *
+     *   // Update your data
+     *   this.appointments.update(appointments =>
+     *     appointments.map(appt =>
+     *       appt.id === event.appointment.id
+     *         ? { ...appt, ...result }
+     *         : appt
+     *     )
+     *   );
+     * }
+     * ```
+     */
+    calculateAppointmentDropResult(event: {
+        appointment: AXSchedulerAppointment;
+        slot: {
+            startDate: {
+                date: Date;
+            };
+            endDate?: {
+                date: Date;
+            };
+            view?: AXSchedulerView;
+            resourceId?: unknown;
+        };
+        isSameSlotDrop: boolean;
+    }): AXSchedulerAppointmentDropResult;
+    /**
+     * Determines if a slot represents a day-based drop (entire day slot).
+     * Day-based views (agenda, month, timeline-month, timeline-year) have slots
+     * that start at 00:00:00 and span the entire day.
+     *
+     * @param slot - The slot to check.
+     * @returns boolean - True if this is a day-based slot.
+     */
+    private isDayBasedSlotDrop;
+    /**
+     * Applies the drop result to an appointment, returning a new updated appointment object.
+     *
+     * This is a convenience method that combines the drop result with the original appointment.
+     *
+     * @param appointment - The original appointment to update.
+     * @param dropResult - The result from calculateAppointmentDropResult.
+     * @returns AXSchedulerAppointment - A new appointment object with updated fields.
+     *
+     * @example
+     * ```typescript
+     * handleAppointmentDrop(event: AXSchedulerSlotDropEvent) {
+     *   const result = this.schedulerService.calculateAppointmentDropResult(event);
+     *
+     *   if (result.isSameSlotDrop) return;
+     *
+     *   this.appointments.update(appointments =>
+     *     appointments.map(appt =>
+     *       appt.id === event.appointment.id
+     *         ? this.schedulerService.applyDropResult(appt, result)
+     *         : appt
+     *     )
+     *   );
+     * }
+     * ```
+     */
+    applyDropResult(appointment: AXSchedulerAppointment, dropResult: AXSchedulerAppointmentDropResult): AXSchedulerAppointment;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSchedulerService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXSchedulerService>;
 }
 
 export { AXSchedulerAgendaViewComponent, AXSchedulerComponent, AXSchedulerDayViewComponent, AXSchedulerModule, AXSchedulerMonthViewComponent, AXSchedulerService, AXSchedulerTimelineDayViewComponent, AXSchedulerTimelineMonthViewComponent, AXSchedulerTimelineMultiDayViewComponent, AXSchedulerTimelineYearViewComponent, AXSchedulerWeekViewComponent };
-export type { AXDayOfWeekName, AXSchedulerActiveAppointmentsInBlock, AXSchedulerAllDaySlotData, AXSchedulerAppointment, AXSchedulerAppointmentDataSource, AXSchedulerAppointmentDataSourceFilter, AXSchedulerAppointmentLayout, AXSchedulerAppointmentLoader, AXSchedulerAppointmentLoaderAsync, AXSchedulerAppointmentMouseEvent, AXSchedulerAppointmentSegment, AXSchedulerBlockIdentifier, AXSchedulerBlockOccupancyMap, AXSchedulerDateRange, AXSchedulerDayAppointmentLayout, AXSchedulerMonthDayCell, AXSchedulerMultiDayViewAppointment, AXSchedulerOverflowBadge, AXSchedulerResource, AXSchedulerSlotDropEvent, AXSchedulerSlotMouseEvent, AXSchedulerView, AgendaDayData, TimelineMonthViewDayData, TimelineMultiDayDaySlot, TimelineYearViewDayData };
+export type { AXDayOfWeekName, AXSchedulerActiveAppointmentsInBlock, AXSchedulerAllDaySlotData, AXSchedulerAppointment, AXSchedulerAppointmentDataSource, AXSchedulerAppointmentDataSourceFilter, AXSchedulerAppointmentDropResult, AXSchedulerAppointmentLayout, AXSchedulerAppointmentLoader, AXSchedulerAppointmentLoaderAsync, AXSchedulerAppointmentMouseEvent, AXSchedulerAppointmentSegment, AXSchedulerBlockIdentifier, AXSchedulerBlockOccupancyMap, AXSchedulerDateRange, AXSchedulerDayAppointmentLayout, AXSchedulerMonthDayCell, AXSchedulerMultiDayViewAppointment, AXSchedulerOverflowBadge, AXSchedulerResource, AXSchedulerSlotDropEvent, AXSchedulerSlotMouseEvent, AXSchedulerSpanningAppointment, AXSchedulerTimelineSpanningAppointment, AXSchedulerTimelineYearSpanningAppointment, AXSchedulerView, AgendaDayData, TimelineMonthViewDayData, TimelineMultiDayDaySlot, TimelineYearViewDayData };