barsa-calendar 2.3.144 → 2.3.147

package/index.d.ts

@@ -1,8 +1,8 @@
 import * as i0 from '@angular/core';
-import { OnChanges, EventEmitter, SimpleChanges, OnInit, TemplateRef, ElementRef, WritableSignal, OnDestroy, PipeTransform, ComponentFactoryResolver } from '@angular/core';
+import { OnChanges, EventEmitter, SimpleChanges, OnInit, TemplateRef, ElementRef, WritableSignal, AfterViewInit, OnDestroy, PipeTransform, ComponentFactoryResolver } from '@angular/core';
 import { Observable, BehaviorSubject } from 'rxjs';
 import * as i24 from 'barsa-novin-ray-core';
-import { DateInfo, CalendarMetaobjectDataModel, BaseComponent, AbbrevationDeviceSize, CultureTypes, CalendarFields, MetaobjectDataModel, ReportViewBaseComponent, UiReportViewBaseSetting, DateService, BaseModule, DynamicComponentService } from 'barsa-novin-ray-core';
+import { DateInfo, CalendarMetaobjectDataModel, BaseComponent, AbbrevationDeviceSize, CultureTypes, CalendarFields, MetaobjectDataModel, ReportViewBaseComponent, UiReportViewBaseSetting, EffectiveReportLayoutPolicy, DateService, BaseModule, DynamicComponentService } from 'barsa-novin-ray-core';
 import * as i25 from '@fundamental-ngx/core';
 import { FdDate, TimeComponent, InputGroupComponent, PopoverComponent, ButtonType } from '@fundamental-ngx/core';
 import * as i22 from '@angular/common';
@@ -388,6 +388,7 @@ declare class EventPreviewComponent extends BaseComponent implements OnInit {
 }
 
 declare class MonthDaysComponent extends BaseComponent implements OnInit, OnChanges {
+    private static readonly DEFAULT_DAY_ROW_HEIGHT_PX;
     monthWeeksCount: {
         firstWeekIndex: number;
         weeksCount: number;
@@ -395,7 +396,12 @@ declare class MonthDaysComponent extends BaseComponent implements OnInit, OnChan
     weekDays: string[];
     weekDaysMin: string[];
     today: Date;
+    /**
+     * @deprecated No longer used for layout. Use `dayRowHeightPx` and parent scroll instead.
+     */
     containerHeight: number;
+    /** Optional week row height in px (full calendar mode). */
+    dayRowHeightPx: number | undefined;
     days: Day[];
     calendarFields: CalendarFields;
     rtl: boolean;
@@ -444,10 +450,10 @@ declare class MonthDaysComponent extends BaseComponent implements OnInit, OnChan
     private _fireDaySelect;
     private _openPopover;
     private prepareWeekDays;
-    private fitToContainer;
+    private applyDayRowLayout;
     private _prepareDaysTasks;
     static ɵfac: i0.ɵɵFactoryDeclaration<MonthDaysComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<MonthDaysComponent, "bc-month-days", never, { "monthWeeksCount": { "alias": "monthWeeksCount"; "required": false; }; "weekDays": { "alias": "weekDays"; "required": false; }; "weekDaysMin": { "alias": "weekDaysMin"; "required": false; }; "today": { "alias": "today"; "required": false; }; "containerHeight": { "alias": "containerHeight"; "required": false; }; "days": { "alias": "days"; "required": false; }; "calendarFields": { "alias": "calendarFields"; "required": false; }; "rtl": { "alias": "rtl"; "required": false; }; "deviceSize": { "alias": "deviceSize"; "required": false; }; "moDataList": { "alias": "moDataList"; "required": false; }; "datePicker": { "alias": "datePicker"; "required": false; }; "rangePicker": { "alias": "rangePicker"; "required": false; }; "startSelectedDayIndex": { "alias": "startSelectedDayIndex"; "required": false; }; "endSelectedDayIndex": { "alias": "endSelectedDayIndex"; "required": false; }; }, { "editEvent": "editEvent"; "deleteEvent": "deleteEvent"; "daySelect": "daySelect"; "dayClick": "dayClick"; "dayMouseMove": "dayMouseMove"; "dayMouseUp": "dayMouseUp"; "dayMouseDown": "dayMouseDown"; "showEvent": "showEvent"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MonthDaysComponent, "bc-month-days", never, { "monthWeeksCount": { "alias": "monthWeeksCount"; "required": false; }; "weekDays": { "alias": "weekDays"; "required": false; }; "weekDaysMin": { "alias": "weekDaysMin"; "required": false; }; "today": { "alias": "today"; "required": false; }; "containerHeight": { "alias": "containerHeight"; "required": false; }; "dayRowHeightPx": { "alias": "dayRowHeightPx"; "required": false; }; "days": { "alias": "days"; "required": false; }; "calendarFields": { "alias": "calendarFields"; "required": false; }; "rtl": { "alias": "rtl"; "required": false; }; "deviceSize": { "alias": "deviceSize"; "required": false; }; "moDataList": { "alias": "moDataList"; "required": false; }; "datePicker": { "alias": "datePicker"; "required": false; }; "rangePicker": { "alias": "rangePicker"; "required": false; }; "startSelectedDayIndex": { "alias": "startSelectedDayIndex"; "required": false; }; "endSelectedDayIndex": { "alias": "endSelectedDayIndex"; "required": false; }; }, { "editEvent": "editEvent"; "deleteEvent": "deleteEvent"; "daySelect": "daySelect"; "dayClick": "dayClick"; "dayMouseMove": "dayMouseMove"; "dayMouseUp": "dayMouseUp"; "dayMouseDown": "dayMouseDown"; "showEvent": "showEvent"; }, never, never, false, never>;
 }
 
 declare class CalendarHeaderComponent extends BaseComponent {
@@ -490,11 +496,18 @@ declare class CalendarHeaderComponent extends BaseComponent {
 }
 
 declare class CalendarMonthComponent extends BaseComponent implements OnChanges, OnInit {
+    /** Default row height (px) for each week band in full calendar mode; parent scrolls if the month is taller than the viewport. */
+    private static readonly DEFAULT_DAY_ROW_HEIGHT_PX;
     monthWeeksCount: number;
     weekDays: string[];
     weekDaysMin: string[];
     today: Date;
+    /**
+     * @deprecated No longer used for layout. Row height is fixed (see `dayRowHeightPx`); use scroll on the parent shell.
+     */
     containerHeight: number;
+    /** Optional override for week row height in px (full calendar mode). When unset, a library default is used. */
+    dayRowHeightPx: number | undefined;
     days: Day[];
     calendarFields: CalendarFields;
     rtl: boolean;
@@ -536,7 +549,6 @@ declare class CalendarMonthComponent extends BaseComponent implements OnChanges,
     private _calendarService;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnInit(): void;
-    onVisibilityChange(e: any): void;
     onDayBoxSelect(day: Day): void;
     onDaySelect(weekIndex: number, dayIndex: number): void;
     onOpenPopoverChange(isOpen: boolean): void;
@@ -550,10 +562,12 @@ declare class CalendarMonthComponent extends BaseComponent implements OnChanges,
     private _fireDaySelect;
     private _openPopover;
     private _prepareWeekDays;
-    private fitToContainer;
+    private _weeksCount;
+    /** Sets `numberOfWeek`, fixed `dayHeight`, and `maxTaskCount` from design defaults (not container height). */
+    private applyDayRowLayout;
     private _prepareDaysTasks;
     static ɵfac: i0.ɵɵFactoryDeclaration<CalendarMonthComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CalendarMonthComponent, "bc-calendar-month", never, { "monthWeeksCount": { "alias": "monthWeeksCount"; "required": false; }; "weekDays": { "alias": "weekDays"; "required": false; }; "weekDaysMin": { "alias": "weekDaysMin"; "required": false; }; "today": { "alias": "today"; "required": false; }; "containerHeight": { "alias": "containerHeight"; "required": false; }; "days": { "alias": "days"; "required": false; }; "calendarFields": { "alias": "calendarFields"; "required": false; }; "rtl": { "alias": "rtl"; "required": false; }; "deviceSize": { "alias": "deviceSize"; "required": false; }; "moDataList": { "alias": "moDataList"; "required": false; }; "datePicker": { "alias": "datePicker"; "required": false; }; "rangePicker": { "alias": "rangePicker"; "required": false; }; "canDelete": { "alias": "canDelete"; "required": false; }; "canAdd": { "alias": "canAdd"; "required": false; }; "canEdit": { "alias": "canEdit"; "required": false; }; "canView": { "alias": "canView"; "required": false; }; "selectedDate": { "alias": "selectedDate"; "required": false; }; "startSelectedDayIndex": { "alias": "startSelectedDayIndex"; "required": false; }; "endSelectedDayIndex": { "alias": "endSelectedDayIndex"; "required": false; }; "viewMode": { "alias": "viewMode"; "required": false; }; }, { "editEvent": "editEvent"; "deleteEvent": "deleteEvent"; "daySelect": "daySelect"; "dayClick": "dayClick"; "dayMouseMove": "dayMouseMove"; "dayMouseUp": "dayMouseUp"; "dayMouseDown": "dayMouseDown"; "showEvent": "showEvent"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CalendarMonthComponent, "bc-calendar-month", never, { "monthWeeksCount": { "alias": "monthWeeksCount"; "required": false; }; "weekDays": { "alias": "weekDays"; "required": false; }; "weekDaysMin": { "alias": "weekDaysMin"; "required": false; }; "today": { "alias": "today"; "required": false; }; "containerHeight": { "alias": "containerHeight"; "required": false; }; "dayRowHeightPx": { "alias": "dayRowHeightPx"; "required": false; }; "days": { "alias": "days"; "required": false; }; "calendarFields": { "alias": "calendarFields"; "required": false; }; "rtl": { "alias": "rtl"; "required": false; }; "deviceSize": { "alias": "deviceSize"; "required": false; }; "moDataList": { "alias": "moDataList"; "required": false; }; "datePicker": { "alias": "datePicker"; "required": false; }; "rangePicker": { "alias": "rangePicker"; "required": false; }; "canDelete": { "alias": "canDelete"; "required": false; }; "canAdd": { "alias": "canAdd"; "required": false; }; "canEdit": { "alias": "canEdit"; "required": false; }; "canView": { "alias": "canView"; "required": false; }; "selectedDate": { "alias": "selectedDate"; "required": false; }; "startSelectedDayIndex": { "alias": "startSelectedDayIndex"; "required": false; }; "endSelectedDayIndex": { "alias": "endSelectedDayIndex"; "required": false; }; "viewMode": { "alias": "viewMode"; "required": false; }; }, { "editEvent": "editEvent"; "deleteEvent": "deleteEvent"; "daySelect": "daySelect"; "dayClick": "dayClick"; "dayMouseMove": "dayMouseMove"; "dayMouseUp": "dayMouseUp"; "dayMouseDown": "dayMouseDown"; "showEvent": "showEvent"; }, never, never, false, never>;
 }
 
 declare class CalendarWeekComponent extends BaseComponent implements OnChanges, OnInit {
@@ -659,7 +673,7 @@ declare class CalendarListComponent extends BaseComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<CalendarListComponent, "bc-calendar-list", never, { "moDataList": { "alias": "moDataList"; "required": false; }; }, {}, never, never, false, never>;
 }
 
-declare class CalendarContainerComponent extends ReportViewBaseComponent<UiReportViewBaseSetting> implements OnInit, OnChanges {
+declare class CalendarContainerComponent extends ReportViewBaseComponent<UiReportViewBaseSetting> implements OnInit, OnChanges, AfterViewInit {
     _divRef: ElementRef;
     calendarFields: any;
     userCalendars: any;
@@ -698,9 +712,14 @@ declare class CalendarContainerComponent extends ReportViewBaseComponent<UiRepor
     title$: Observable<string>;
     viewMode: WritableSignal<CalendarViewType>;
     eventMoDataList$: BehaviorSubject<MetaobjectDataModel[]>;
+    /** Mode-driven viewport (page scroll vs internal time-grid); see `mergeCalendarViewportPolicy`. */
+    readonly resolvedViewportPolicy: WritableSignal<EffectiveReportLayoutPolicy>;
+    private readonly _parentViewportPolicy$;
     private _calendarService;
     private _dateService;
     ngOnInit(): void;
+    ngAfterViewInit(): void;
+    onVisibilityChange(e: any): void;
     ngOnChanges(changes: SimpleChanges): void;
     onViewModeChange(viewMode: CalendarViewType): void;
     onCalendarCheckChange(_calendar: MetaobjectDataModel): void;
@@ -726,9 +745,15 @@ declare class CalendarContainerComponent extends ReportViewBaseComponent<UiRepor
     }): void;
     prepareMoDataList(moDataList: MetaobjectDataModel[]): void;
     addTd(table: any[], tr: any[], event: CalendarMetaobjectDataModel, colSpan: number): void;
+    /** Host was hidden (e.g. inactive tab); first real layout — remeasure week grid height/width. */
+    protected onVisible(): void;
+    /** Host size changed (tab switch, split pane, window) — week view depends on measured `height`/`width`. */
+    protected onResize(): void;
     private _handleUserCalendarsChecked;
     private prepare;
     private _setWidthAndHeight;
+    /** Measure after layout; week view needs `height` / `width` for `bc-calendar-week` and `fillEmptySpace`. */
+    private _scheduleMeasureLayout;
     static ɵfac: i0.ɵɵFactoryDeclaration<CalendarContainerComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<CalendarContainerComponent, "bc-calendar-container", never, { "calendarFields": { "alias": "calendarFields"; "required": false; }; "userCalendars": { "alias": "userCalendars"; "required": false; }; "viewSetting": { "alias": "viewSetting"; "required": false; }; }, { "deleteTask": "deleteTask"; "editTask": "editTask"; "rangeSelect": "rangeSelect"; "daySelect": "daySelect"; "loadData": "loadData"; "modeChanged": "modeChanged"; "viewModeChanged": "viewModeChanged"; }, never, never, false, never>;
 }
@@ -745,6 +770,18 @@ interface UiCalendarSettings extends UiReportViewBaseSetting {
     DefaultMode$Caption: CalendarMode;
 }
 
+/**
+ * Maps calendar navigation mode to the same axes as {@link EffectiveReportLayoutPolicy}
+ * (Google Calendar-style: month uses page scroll; week/day use internal time-grid scroll).
+ */
+declare function resolveCalendarViewportPolicy(mode: CalendarMode): EffectiveReportLayoutPolicy;
+/**
+ * Combines mode-derived viewport with an optional parent `effectiveReportLayout`.
+ * Today: **mode wins** for `layout` and `scroll` so embedded calendar behavior stays predictable;
+ * parent input is reserved for future low-code overrides (merge rules can evolve here).
+ */
+declare function mergeCalendarViewportPolicy(mode: CalendarMode, _parent: EffectiveReportLayoutPolicy | null | undefined): EffectiveReportLayoutPolicy;
+
 declare class CalendarService implements OnDestroy {
     selected$: Observable<CalendarMonthInfo>;
     days$: Observable<Day[]>;
@@ -879,5 +916,5 @@ declare class BarsaCalendarModule extends BaseModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<BarsaCalendarModule>;
 }
 
-export { BarsaCalendarModule, CalendarContainerComponent, CalendarHeaderComponent, CalendarListComponent, CalendarListContainerComponent, CalendarListItemComponent, CalendarMonthComponent, CalendarMonthInfo, CalendarSelectionDaysComponent, CalendarService, CalendarWeekComponent, DateTimePickerComponent, DayEventListComponent, DayNumberBoxComponent, DayStatus, EventButtonComponent, EventButtonEndArrowComponent, EventButtonStartArrowComponent, EventPreviewComponent, MonthDaysComponent, TimeConfigI18n };
+export { BarsaCalendarModule, CalendarContainerComponent, CalendarHeaderComponent, CalendarListComponent, CalendarListContainerComponent, CalendarListItemComponent, CalendarMonthComponent, CalendarMonthInfo, CalendarSelectionDaysComponent, CalendarService, CalendarWeekComponent, DateTimePickerComponent, DayEventListComponent, DayNumberBoxComponent, DayStatus, EventButtonComponent, EventButtonEndArrowComponent, EventButtonStartArrowComponent, EventPreviewComponent, MonthDaysComponent, TimeConfigI18n, mergeCalendarViewportPolicy, resolveCalendarViewportPolicy };
 export type { Attendee, Calendar, CalendarEvent, CalendarMode, CalendarType, CalendarViewType, Day, RecurrenceFrequency, Reminder };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "barsa-calendar",
-  "version": "2.3.144",
+  "version": "2.3.147",
   "peerDependencies": {
     "@angular/core": "^20.0.6",
     "@angular/common": "^20.0.6"