@acorex/components 18.5.16 → 18.6.0

package/fesm2022/acorex-components-calendar.mjs

@@ -171,10 +171,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.2", ngImpor
 const CALENDAR_INPUTS = ['depth', 'activeView', 'min', 'max', 'disabledDates', 'type', 'holidayDates'];
 const CALENDAR_OUTPUTS = ['depthChange', 'typeChange', 'disabledDatesChange', 'holidayDatesChange', 'onNavigate'];
 
+/**
+ * A calendar component that provides a customizable calendar view with various options for selection, navigation, and styling.
+ *
+ * @category Components
+ */
 class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveComponent, MXCalendarBaseComponent) {
     get displayRange() {
         return new AXDateTimeRange(this.views[0].range.startTime, this.views[this.views.length - 1].range.endTime);
     }
+    /**
+     *  @ignore
+     */
     _setDisplayRange(current) {
         switch (this.activeView) {
             case 'year': {
@@ -197,24 +205,48 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
                 return new AXDateTimeRange(current.startOf('month'), current.endOf('month'));
         }
     }
+    /**
+     *  @ignore
+     */
     _initValues() {
         this._today = this.calendarService.create(new Date(), this.type);
         this._weekdays = this._today.calendar.weekdays;
     }
+    /**
+     *  @ignore
+     */
     _refresh() {
         this._initValues();
         this.navTo(this.value || this._today);
     }
+    /**
+     *  @ignore
+     */
     constructor(unsubscriber) {
         super();
+        /**
+         *  @ignore
+         */
         this._today = this.calendarService.create(new Date(), this.type);
+        /**
+         *  @ignore
+         */
         this._navUserInteraction = false;
+        /**
+         *  @ignore
+         */
         this._footPrint = {
             year: null,
             month: null,
             day: null,
         };
+        /**
+         *  @ignore
+         */
         this.views = [];
+        /**
+         *  @ignore
+         */
         this._weekdays = [];
         this.calendarService.onHolidaysChanged.pipe(unsubscriber.takeUntilDestroy).subscribe(() => {
             this.render();
@@ -223,15 +255,24 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
             this._refresh();
         });
     }
+    /**
+     *  @ignore
+     */
     ngOnInit() {
         super.ngOnInit();
         this._initValues();
     }
+    /**
+     *  @ignore
+     */
     ngAfterViewInit() {
         if (!this.value) {
             this.goToday();
         }
     }
+    /**
+     *  @ignore
+     */
     ngOnDestroy() { }
     render() {
         if (!this._viewStartDate)
@@ -383,16 +424,25 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
         }
         this.cdr.markForCheck();
     }
+    /**
+     *  @ignore
+     */
     _handlePrevClick() {
         this._navUserInteraction = true;
         this.prev();
         this._navUserInteraction = false;
     }
+    /**
+     *  @ignore
+     */
     _handleNextClick() {
         this._navUserInteraction = true;
         this.next();
         this._navUserInteraction = false;
     }
+    /**
+     *  @ignore
+     */
     _handleSlotClick(e, slot) {
         if (slot.disabled || this.disabled)
             return;
@@ -425,6 +475,9 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
             this._setDate(slot.date.date);
         }
     }
+    /**
+     *  @ignore
+     */
     _handleNavClick(e, view) {
         this._navUserInteraction = true;
         this.activeView = view;
@@ -436,6 +489,9 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
         else if (this.activeView == 'month')
             this.activeView = 'year';
     }
+    /**
+     *  @ignore
+     */
     internalOptionChanged(e) {
         if (e.name == 'depth' || e.name == 'activeView' || e.name == 'disabledDates' || e.name == 'holidayDates') {
             this.render();
@@ -444,6 +500,9 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
             this._refresh();
         }
     }
+    /**
+     *  @ignore
+     */
     internalSetValue(value) {
         if (!value)
             return null;
@@ -454,6 +513,9 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
         else
             return v.date;
     }
+    /**
+     *  @ignore
+     */
     internalValueChanged(value) {
         const val = this.calendarService.create(value, this.type);
         if (!this._viewStartDate ||
@@ -466,23 +528,41 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
         this._footPrint.day = val.dayOfMonth;
         this.render();
     }
+    /**
+     *  @ignore
+     */
     _handleGoToday() {
         this._navUserInteraction = true;
         this._setDate(this._today.date);
         this.goToday();
         this._navUserInteraction = false;
     }
+    /**
+     * Navigates to the next item.
+     * @ignore
+     */
     next() {
         this._navNextPrev(false);
     }
+    /**
+     * Navigates to the previous item.
+     * @ignore
+     */
     prev() {
         this._navNextPrev(true);
     }
+    /**
+     * Sets focus to the currently selected calendar slot or the first available slot.
+     * @ignore
+     */
     focus() {
         const func = (s) => this.getHostElement().querySelector(s);
         const div = func('.ax-calendar-slots>div.ax-state-selected') || func('.ax-calendar-slots>div');
         div?.focus();
     }
+    /**
+     *  @ignore
+     */
     _navNextPrev(prev) {
         const sign = prev ? -1 : 1;
         if (this.activeView == 'day')
@@ -492,9 +572,19 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
         else
             this.navTo(this._viewStartDate.add('year', sign * 10 * this.count));
     }
+    /**
+     * Navigates to the current date.
+     * @ignore
+     */
     goToday() {
         this.navTo(this._today);
     }
+    /**
+     * Navigates to a specified date and updates the view.
+     *
+     * @param date - The date to navigate to, which can be a `Date` object or an `AXDateTime` instance.
+     * @ignore
+     */
     navTo(date) {
         const val = this.calendarService.convert(date, this.type);
         this._viewStartDate = val.startOf();
@@ -511,6 +601,9 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
             });
         }
     }
+    /**
+     *  @ignore
+     */
     get __hostClass() {
         const _classes = {
             'ax-state-disabled': this.disabled,
@@ -521,11 +614,17 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
             .map((c) => c[0])
             .join(' ');
     }
+    /**
+     *  @ignore
+     */
     _setDate(value) {
         if (this.readonly || this.disabled)
             return;
         this.commitValue(this.calendarService.convert(value, this.type).startOf().date, true);
     }
+    /**
+     *  @ignore
+     */
     isDisabled(date) {
         if (Array.isArray(this.disabledDates) && this.disabledDates.length != 0) {
             return this.disabledDates.some((d) => date.equal(d, 'day'));
@@ -535,6 +634,9 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
         }
         return false;
     }
+    /**
+     *  @ignore
+     */
     isHoliday(date) {
         const gh = this.calendarService.holidays.some((d) => date.equal(d.date, 'day'));
         let dh = this.calendarService.holidays.some((d) => date.equal(d.date, 'day'));
@@ -546,10 +648,16 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
         }
         return gh || dh;
     }
+    /**
+     *  @ignore
+     */
     isWeekend(date) {
         const weekend = this.calendarService.resolveCalendar(this.type).weekend;
         return weekend.includes(date.dayOfWeek - 1);
     }
+    /**
+     *  @ignore
+     */
     _handleOnKeydownEvent(e) {
         //TODO: complete keyboad navigation
         const ignore = () => {
@@ -575,6 +683,9 @@ class AXCalendarComponent extends classes((MXValueComponent), MXInteractiveCompo
             ignore();
         }
     }
+    /**
+     *  @ignore
+     */
     getMonthName(date, style) {
         return `dateTime.months.${date.calendar.name()}.${style}.${date.monthOfYear - 1}`;
     }
@@ -650,10 +761,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "18.0.2", ngImpor
             }] } });
 
 class AXCalendarRangeComponent extends classes((MXValueComponent), MXInteractiveComponent, MXCalendarBaseComponent) {
+    /**
+     *  @ignore
+     */
     constructor() {
         super();
+        /**
+         *  @ignore
+         */
         this._calendarService = inject(AXCalendarService);
         this._navText = '';
+        /**
+         *  @ignore
+         */
         this.getCellClass = (date) => {
             //const d = this._calendarService.create(date, this.type);
             const from = this._calendarService.create(this.value.from, this.type);
@@ -669,13 +789,22 @@ class AXCalendarRangeComponent extends classes((MXValueComponent), MXInteractive
         };
         this.defaultValue = { from: null, end: null };
     }
+    /**
+     *  @ignore
+     */
     ngOnInit() {
         super.ngOnInit();
         this.rtl = AXHtmlUtil.isRtl(this.getHostElement());
     }
+    /**
+     *  @ignore
+     */
     ngAfterViewInit() {
         this._syncNav1();
     }
+    /**
+     *  @ignore
+     */
     handleSlotClick(e) {
         if (this._c1.activeView == this.depth) {
             if (!this.value.from || (this.value.from && this.value.end)) {
@@ -699,6 +828,9 @@ class AXCalendarRangeComponent extends classes((MXValueComponent), MXInteractive
         this._c1.render();
         this._c2.render();
     }
+    /**
+     *  @ignore
+     */
     handlePrevClick() {
         const view = this._c1.activeView;
         const d1 = this._c1.displayRange.startTime;
@@ -709,6 +841,9 @@ class AXCalendarRangeComponent extends classes((MXValueComponent), MXInteractive
             this._c1.navTo(d1.add('year', -20));
         }
     }
+    /**
+     *  @ignore
+     */
     handleNextClick() {
         const view = this._c1.activeView;
         const d1 = this._c1.displayRange.startTime;
@@ -719,9 +854,15 @@ class AXCalendarRangeComponent extends classes((MXValueComponent), MXInteractive
             this._c1.navTo(d1.add('year', 20));
         }
     }
+    /**
+     *  @ignore
+     */
     handleNavClick() {
         this._c1.toggleView();
     }
+    /**
+     *  @ignore
+     */
     _syncNavText() {
         const view = this._c1.activeView;
         const d1 = this._c1.displayRange.startTime;
@@ -738,18 +879,30 @@ class AXCalendarRangeComponent extends classes((MXValueComponent), MXInteractive
             this._navText = `${d1.format('yyyy')} - ${d2.format('yyyy')}`;
         }
     }
+    /**
+     *  @ignore
+     */
     handleNavigate() {
         this._syncNav1();
     }
+    /**
+     *  @ignore
+     */
     handleActiveViewChange1() {
         this._c2.activeView = this._c1.activeView;
         this._syncNav1();
     }
+    /**
+     *  @ignore
+     */
     handleActiveViewChange2() {
         if (this._c2.activeView != this._c1.activeView) {
             this._c1.activeView = this._c2.activeView;
         }
     }
+    /**
+     *  @ignore
+     */
     _syncNav1() {
         const view = (this._c2.activeView = this._c1.activeView);
         const range = this._c1.displayRange;
@@ -764,6 +917,9 @@ class AXCalendarRangeComponent extends classes((MXValueComponent), MXInteractive
         }
         this._syncNavText();
     }
+    /**
+     *  @ignore
+     */
     _syncNav2(e) {
         const view = this._c2.activeView;
         if (view == 'month') {