@idea-ionic/agenda 6.8.1 → 6.9.1

package/src/agenda.component.d.ts

@@ -1,12 +1,12 @@
-import { EventEmitter, OnInit } from '@angular/core';
-import { Platform } from '@ionic/angular';
+import { EventEmitter, OnInit, ChangeDetectorRef } from '@angular/core';
+import { IonContent, Platform } from '@ionic/angular';
 import { Subject } from 'rxjs';
-import { CalendarEvent, CalendarEventTimesChangedEvent, CalendarMonthViewDay, CalendarView } from 'angular-calendar';
-import { IDEATinCanService, IDEATranslationsService } from '@idea-ionic/common';
+import { CalendarEvent, CalendarEventTimesChangedEvent, CalendarMonthViewBeforeRenderEvent, CalendarView, CalendarWeekViewBeforeRenderEvent } from 'angular-calendar';
+import { IDEATranslationsService } from '@idea-ionic/common';
 import * as i0 from "@angular/core";
 export declare class IDEAAgendaComponent implements OnInit {
-    platform: Platform;
-    tc: IDEATinCanService;
+    private cdr;
+    private platform;
     t: IDEATranslationsService;
     /**
      * The events to display in the calendar.
@@ -36,10 +36,31 @@ export declare class IDEAAgendaComponent implements OnInit {
      * The view mode for the agenda.
      */
     view: CalendarView;
+    /**
+     * The allowed view mode for the agenda.
+     */
+    allowedViews: CalendarView[];
     /**
      * Whether to block any day/slot in the past.
      */
     onlyFuture: boolean;
+    /**
+     * Some notes to show underneath the calendar's header.
+     */
+    titleNotes: string;
+    /**
+     * The template for new events created by drag&drop.
+     */
+    newEventTemplate: AgendaEvent;
+    /**
+     * Whether (and how) to allow the creation of events by drag&drop.
+     * If enabled, on mobile it requires the `parentContent` to be set for a correct execution.
+     */
+    allowDragToCreate: DragToCreateOptions;
+    /**
+     * The parent ion-content, in case we want to control its scrollability for drag&drop features.
+     */
+    parentContent: IonContent;
     /**
      * Trigger when an event is selected.
      */
@@ -52,6 +73,10 @@ export declare class IDEAAgendaComponent implements OnInit {
      * Trigger when a time slot is selected.
      */
     selectSlot: EventEmitter<Date>;
+    /**
+     * Trigger when a new event is added by drag and drop.
+     */
+    newEventByDrag: EventEmitter<AgendaEvent>;
     /**
      * Trigger when an event changed date (drag&drop or resize).
      */
@@ -60,6 +85,14 @@ export declare class IDEAAgendaComponent implements OnInit {
      * Trigger when the view date of reference changed (because we moved inside the calendar).
      */
     changeDate: EventEmitter<Date>;
+    /**
+     * Trigger before the rendering of the week or day view.
+     */
+    beforeWeekOrDayViewRenderEmitter: EventEmitter<CalendarWeekViewBeforeRenderEvent>;
+    /**
+     * Trigger before the rendering of the month view.
+     */
+    beforeMonthViewRenderEmitter: EventEmitter<CalendarMonthViewBeforeRenderEvent>;
     /**
      * Helper to use the enum in the UX.
      */
@@ -71,7 +104,7 @@ export declare class IDEAAgendaComponent implements OnInit {
     /**
      * A controller to refresh the current view.
      */
-    refresh: Subject<any>;
+    refresh: Subject<void>;
     /**
      * The locale used to format dates.
      * @hide
@@ -81,30 +114,24 @@ export declare class IDEAAgendaComponent implements OnInit {
      * The starting day for the week, according to the locale (0 = sunday).
      * @hide
      */
-    weekStartsOn: number;
-    /**
-     * Helper to use the enum in the UI.
-     */
+    weekStartsOn: 0 | 1 | 2 | 3 | 4 | 5 | 6;
     Attendance: typeof EventAttendance;
     darkMode: boolean;
-    constructor(platform: Platform, tc: IDEATinCanService, t: IDEATranslationsService);
+    constructor(cdr: ChangeDetectorRef, platform: Platform, t: IDEATranslationsService);
     ngOnInit(): void;
+    isMobile(): boolean;
     /**
      * Run some checks before the month view is rendered (e.g. disable invalid days).
      */
-    beforeMonthViewRender({ body }: {
-        body: CalendarMonthViewDay[];
-    }): void;
+    beforeMonthViewRender(event: CalendarMonthViewBeforeRenderEvent): void;
     /**
      * Run some checks before the week/day view is rendered (e.g. disable invalid days).
      */
-    beforeWeekOrDayViewRender({ header }: {
-        header: any;
-    }): void;
+    beforeWeekOrDayViewRender(event: CalendarWeekViewBeforeRenderEvent): void;
     /**
      * Check whether a date is valid based on the configured parameters.
      */
-    dateIsValid(date: Date, sameDayIsValid?: boolean): boolean;
+    dateIsValid(date: any, sameDayIsValid?: boolean): boolean;
     /**
      * Change the current view for the agenda.
      */
@@ -127,7 +154,7 @@ export declare class IDEAAgendaComponent implements OnInit {
     /**
      * Given a color, it returns an opaque version of it.
      */
-    getAlternateColor(color: string, amount: number, opacity?: number): string;
+    getAlternateColor(color: string, amount: number, opacity?: number): string | undefined;
     /**
      * Get the content of the tooltip based on the event.
      */
@@ -136,8 +163,13 @@ export declare class IDEAAgendaComponent implements OnInit {
      * Get a shortened version of the description as preview.
      */
     getPreviewDescription(description: string): string;
+    /**
+     * Handle the drag&drop to create a new event.
+     */
+    startDragToCreate(event: Event, segmentDate: Date, segmentElement: HTMLElement): void;
+    private getFixedEndDateWithMinimumSegmentDuration;
     static ɵfac: i0.ɵɵFactoryDeclaration<IDEAAgendaComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<IDEAAgendaComponent, "idea-agenda", never, { "events": "events"; "excludeDays": "excludeDays"; "dayStartHour": "dayStartHour"; "dayEndHour": "dayEndHour"; "hourSegments": "hourSegments"; "activeDayIsOpen": "activeDayIsOpen"; "view": "view"; "onlyFuture": "onlyFuture"; }, { "selectEvent": "selectEvent"; "selectDay": "selectDay"; "selectSlot": "selectSlot"; "changeEvent": "changeEvent"; "changeDate": "changeDate"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IDEAAgendaComponent, "idea-agenda", never, { "events": "events"; "excludeDays": "excludeDays"; "dayStartHour": "dayStartHour"; "dayEndHour": "dayEndHour"; "hourSegments": "hourSegments"; "activeDayIsOpen": "activeDayIsOpen"; "view": "view"; "allowedViews": "allowedViews"; "onlyFuture": "onlyFuture"; "titleNotes": "titleNotes"; "newEventTemplate": "newEventTemplate"; "allowDragToCreate": "allowDragToCreate"; "parentContent": "parentContent"; }, { "selectEvent": "selectEvent"; "selectDay": "selectDay"; "selectSlot": "selectSlot"; "newEventByDrag": "newEventByDrag"; "changeEvent": "changeEvent"; "changeDate": "changeDate"; "beforeWeekOrDayViewRenderEmitter": "beforeWeekOrDayViewRenderEmitter"; "beforeMonthViewRenderEmitter": "beforeMonthViewRenderEmitter"; }, never, never, false, never>;
 }
 /**
  * A richer version of the classic CalendarEvent.
@@ -166,6 +198,13 @@ export interface AgendaEvent extends CalendarEvent {
         name: string;
         title: string;
     }[];
+    /**
+     * The colors of the event displayed.
+     */
+    color?: {
+        primary: string;
+        secondary?: string;
+    } | any;
     /**
      * Whether the event is external; external events are less important UI-wise.
      */
@@ -188,3 +227,11 @@ export declare enum EventAttendance {
     TENTATIVE = 1,
     ACCEPTED = 2
 }
+/**
+ * The options to allow (or not) drag&drop to create a new event.
+ */
+export declare enum DragToCreateOptions {
+    DISABLED = 0,
+    ONLY_SAME_DAY = 1,
+    FREE = 2
+}

package/src/dateFormatter.provider.d.ts

@@ -1,13 +1,13 @@
 import { CalendarDateFormatter, DateFormatterParams } from 'angular-calendar';
 import * as i0 from "@angular/core";
 export declare class CustomDateFormatter extends CalendarDateFormatter {
-    monthViewColumnHeader({ date, locale }: DateFormatterParams): string;
-    monthViewTitle({ date, locale }: DateFormatterParams): string;
-    weekViewHour({ date, locale }: DateFormatterParams): string;
-    weekViewColumnHeader({ date, locale }: DateFormatterParams): string;
-    weekViewTitle({ date, locale }: DateFormatterParams): string;
-    dayViewHour({ date, locale }: DateFormatterParams): string;
-    dayViewTitle({ date, locale }: DateFormatterParams): string;
+    monthViewColumnHeader: ({ date, locale }: DateFormatterParams) => string;
+    monthViewTitle: ({ date, locale }: DateFormatterParams) => string;
+    weekViewHour: ({ date, locale }: DateFormatterParams) => string;
+    weekViewColumnHeader: ({ date, locale }: DateFormatterParams) => string;
+    weekViewTitle: ({ date, locale }: DateFormatterParams) => string;
+    dayViewHour: ({ date, locale }: DateFormatterParams) => string;
+    dayViewTitle: ({ date, locale }: DateFormatterParams) => string;
     static ɵfac: i0.ɵɵFactoryDeclaration<CustomDateFormatter, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<CustomDateFormatter>;
 }