@idea-ionic/agenda 8.5.13 → 8.6.0

package/index.d.ts

@@ -1,5 +1,419 @@
+import * as i0 from '@angular/core';
+import { OnInit, EventEmitter } from '@angular/core';
+import { IonContent } from '@ionic/angular/standalone';
+import { Subject } from 'rxjs';
+import * as i10 from 'angular-calendar';
+import { CalendarEvent, CalendarView, CalendarWeekViewBeforeRenderEvent, CalendarMonthViewBeforeRenderEvent, CalendarEventTimesChangedEvent, CalendarDateFormatter, DateFormatterParams } from 'angular-calendar';
+import * as i8 from '@idea-ionic/common';
+import { IDEATranslationsService } from '@idea-ionic/common';
+import { ExternalCalendarSources, Calendar, Check, Membership, Team } from 'idea-toolbox';
+import * as i5 from '@angular/common';
+import * as i6 from '@angular/forms';
+import * as i7 from '@ionic/angular';
+import * as i9 from '@idea-ionic/uncommon';
+
+declare class IDEAAgendaComponent implements OnInit {
+    private _cdr;
+    private _platform;
+    _translate: IDEATranslationsService;
+    /**
+     * The events to display in the calendar.
+     */
+    events: AgendaEvent[];
+    /**
+     * An array of day indexes (0 = sunday, 1 = monday, etc.) that will be hidden on the view.
+     */
+    excludeDays: number[];
+    /**
+     * The day start hours in 24 hour time. Must be 0-23
+     */
+    dayStartHour: number;
+    /**
+     * The day start hours in 24 hour time. Must be 0-23
+     */
+    dayEndHour: number;
+    /**
+     * The number of segments in an hour. Must divide equally into 60.
+     */
+    hourSegments: number;
+    /**
+     * Whether to open the current day's details right away in month view.
+     */
+    activeDayIsOpen: boolean;
+    /**
+     * 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.
+     */
+    selectEvent: EventEmitter<AgendaEvent>;
+    /**
+     * Trigger when a day is selected.
+     */
+    selectDay: EventEmitter<Date>;
+    /**
+     * 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).
+     */
+    changeEvent: EventEmitter<AgendaEvent>;
+    /**
+     * 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>;
+    CalendarView: typeof CalendarView;
+    Attendance: typeof EventAttendance;
+    viewDate: Date;
+    refresh: Subject<void>;
+    /**
+     * @hide
+     */
+    locale: string;
+    /**
+     * @hide
+     */
+    weekStartsOn: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    darkMode: boolean;
+    ngOnInit(): void;
+    isMobile(): boolean;
+    /**
+     * Run some checks before the month view is rendered (e.g. disable invalid days).
+     */
+    beforeMonthViewRender(event: CalendarMonthViewBeforeRenderEvent): void;
+    /**
+     * Run some checks before the week/day view is rendered (e.g. disable invalid days).
+     */
+    beforeWeekOrDayViewRender(event: CalendarWeekViewBeforeRenderEvent): void;
+    dateIsValid(date: any, sameDayIsValid?: boolean): boolean;
+    setView(view: CalendarView): void;
+    viewDateChanged(newDate: Date): void;
+    changeDay({ date, events }: {
+        date: Date;
+        events: AgendaEvent[];
+    }): void;
+    eventTimesChanged({ event, newStart, newEnd }: CalendarEventTimesChangedEvent): void;
+    getAlternateColor(color: string, amount: number, opacity?: number): string | undefined;
+    getTooltipContent(event: AgendaEvent): string;
+    getPreviewDescription(description: string): string;
+    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": { "alias": "events"; "required": false; }; "excludeDays": { "alias": "excludeDays"; "required": false; }; "dayStartHour": { "alias": "dayStartHour"; "required": false; }; "dayEndHour": { "alias": "dayEndHour"; "required": false; }; "hourSegments": { "alias": "hourSegments"; "required": false; }; "activeDayIsOpen": { "alias": "activeDayIsOpen"; "required": false; }; "view": { "alias": "view"; "required": false; }; "allowedViews": { "alias": "allowedViews"; "required": false; }; "onlyFuture": { "alias": "onlyFuture"; "required": false; }; "titleNotes": { "alias": "titleNotes"; "required": false; }; "newEventTemplate": { "alias": "newEventTemplate"; "required": false; }; "allowDragToCreate": { "alias": "allowDragToCreate"; "required": false; }; "parentContent": { "alias": "parentContent"; "required": false; }; }, { "selectEvent": "selectEvent"; "selectDay": "selectDay"; "selectSlot": "selectSlot"; "newEventByDrag": "newEventByDrag"; "changeEvent": "changeEvent"; "changeDate": "changeDate"; "beforeWeekOrDayViewRenderEmitter": "beforeWeekOrDayViewRenderEmitter"; "beforeMonthViewRenderEmitter": "beforeMonthViewRenderEmitter"; }, never, never, false, never>;
+}
 /**
- * Generated bundle index. Do not edit.
+ * A richer version of the classic CalendarEvent.
  */
-/// <amd-module name="@idea-ionic/agenda" />
-export * from './public-api';
+interface AgendaEvent extends CalendarEvent {
+    /**
+     * A brief description for the event.
+     */
+    description?: string;
+    /**
+     * The customer/stakeholder/target of the event.
+     */
+    target?: string;
+    /**
+     * The location of the event.
+     */
+    location?: string;
+    /**
+     * A list of URLs of images to show as small avatars.
+     */
+    avatars?: {
+        id: string;
+        url: string;
+        title: string;
+    }[];
+    /**
+     * A list of ion-icons to show.
+     */
+    icons?: {
+        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.
+     */
+    external?: boolean;
+    /**
+     * The attendance status to this event, if any.
+     */
+    attendance?: EventAttendance;
+    /**
+     * A standard and unique id for the event, valid across multiple sources.
+     */
+    iCalUID?: string;
+}
+/**
+ * Possible attendance statuses for the event.
+ */
+declare enum EventAttendance {
+    DECLINED = -1,
+    NEEDS_ACTION = 0,
+    TENTATIVE = 1,
+    ACCEPTED = 2
+}
+/**
+ * The options to allow (or not) drag&drop to create a new event.
+ */
+declare enum DragToCreateOptions {
+    DISABLED = 0,
+    ONLY_SAME_DAY = 1,
+    FREE = 2
+}
+
+/**
+ * Note: to test locally, you need to temporarily change the redirect URI:
+ *  - in the lambda `idea_calendars`, e.g. `SCARLETT_URL`;
+ *  - in the client config file: `APP_URL`.
+ * In both cases, the value should be set to `http://localhost:8100` (or according to the local URL).
+ */
+declare class IDEACalendarsService {
+    protected _env: any;
+    private _modal;
+    private _alert;
+    private _loading;
+    private _API;
+    private _translate;
+    /**
+     * Get the ion-icon of an external service from its name.
+     */
+    getServiceIcon(service: ExternalCalendarSources | string): string;
+    /**
+     * Get the base URL for API request (shared/private calendar).
+     */
+    getRequestURL(calendar: Calendar): string;
+    /**
+     * Create a new calendar.
+     */
+    postCalendar(cal: Calendar): Promise<Calendar>;
+    /**
+     * Update an existing calendar.
+     */
+    putCalendar(cal: Calendar): Promise<Calendar>;
+    /**
+     * Delete a calendar.
+     */
+    deleteCalendar(cal: Calendar): Promise<void>;
+    /**
+     * Associate an external calendar with the given calendar.
+     */
+    setExternalCalendar(cal: Calendar, externalId: string): Promise<Calendar>;
+    /**
+     * Link the calendar with the chosen external service (auth flow).
+     */
+    linkExtService(cal: Calendar, baseURL: string): Promise<void>;
+    private showAlertLinkingCalendar;
+    /**
+     * Get the external calendars list of the external service.
+     */
+    getExternalCalendars(cal: Calendar): Promise<ExtCalendar[]>;
+    /**
+     * If the external service is linked, choose an external calendar and set it for the chosen calendar.
+     * @return the updated calendar.
+     */
+    chooseAndSetExternalCalendar(cal: Calendar): Promise<Calendar>;
+    /**
+     * Open the modal to pick a calendar from the external service.
+     * @return the id of the external calendar.
+     */
+    private openModalAndPickExternalCalendar;
+    /**
+     * First sync of the extenal calendar.
+     */
+    syncCalendar(cal: Calendar): Promise<void>;
+    /**
+     * Helper to recursively sync an the extenal calendar.
+     */
+    private syncCalendarHelper;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IDEACalendarsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<IDEACalendarsService>;
+}
+/**
+ * Helper structure to define external services' calendars (basic info).
+ */
+interface ExtCalendar {
+    id: string;
+    name: string;
+}
+
+declare class IDEACalendarComponent implements OnInit {
+    private _modal;
+    private _alert;
+    private _tc;
+    private _loading;
+    private _message;
+    private _API;
+    private _translate;
+    _calendars: IDEACalendarsService;
+    /**
+     * The calendar to manage.
+     */
+    calendar: Calendar;
+    /**
+     * Whether we want to enable advanced permissions (based on the memberships) on the calendar.
+     */
+    advancedPermissions: boolean;
+    /**
+     * Whether the calendar color is an important detail or it shouldn't be shown.
+     */
+    hideColor: boolean;
+    calendarWC: Calendar;
+    membershipsChecks: Check[];
+    membership: Membership;
+    errors: Set<string>;
+    DEFAULT_COLOR: string;
+    ngOnInit(): Promise<void>;
+    hasFieldAnError(field: string): boolean;
+    save(): Promise<void>;
+    delete(): Promise<void>;
+    close(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IDEACalendarComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IDEACalendarComponent, "idea-calendar", never, { "calendar": { "alias": "calendar"; "required": false; }; "advancedPermissions": { "alias": "advancedPermissions"; "required": false; }; "hideColor": { "alias": "hideColor"; "required": false; }; }, {}, never, never, false, never>;
+}
+
+declare class IDEACalendarItemComponent {
+    private _alert;
+    private _modal;
+    private _message;
+    private _loading;
+    private _translate;
+    _calendars: IDEACalendarsService;
+    /**
+     * The calendar to show.
+     */
+    calendar: Calendar;
+    /**
+     * Whether the component is disabled.
+     */
+    disabled: boolean;
+    /**
+     * Whether we want to enable advanced permissions (based on the memberships) on the calendar.
+     */
+    advancedPermissions: boolean;
+    /**
+     * Whether the calendar color is an important detail or it shouldn't be shown.
+     */
+    hideColor: boolean;
+    /**
+     * The URL to be used on the redirect calls.
+     */
+    baseURL: string;
+    /**
+     * Report to parent components a change.
+     */
+    somethingChanged: EventEmitter<Calendar>;
+    manageCalendar(): Promise<void>;
+    linkExtCalendarOrDelete(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IDEACalendarItemComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IDEACalendarItemComponent, "idea-calendar-item", never, { "calendar": { "alias": "calendar"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "advancedPermissions": { "alias": "advancedPermissions"; "required": false; }; "hideColor": { "alias": "hideColor"; "required": false; }; "baseURL": { "alias": "baseURL"; "required": false; }; }, { "somethingChanged": "somethingChanged"; }, never, never, false, never>;
+}
+
+declare class IDEACalendarCreationComponent implements OnInit {
+    private _modal;
+    private _loading;
+    private _message;
+    private _translate;
+    private _tc;
+    _calendars: IDEACalendarsService;
+    /**
+     * Whether we want to allow the creation of only a particular type of calendar, based on the scope.
+     */
+    fixScope: CalendarScopes;
+    /**
+     * Whether we want to allow the creation of local calendars.
+     */
+    onlyExternalCalendars: boolean;
+    /**
+     * The URL to be used on the redirect calls.
+     */
+    baseURL: string;
+    team: Team;
+    membership: Membership;
+    calendar: Calendar;
+    DEFAULT_COLOR: string;
+    SOURCES: string[];
+    ngOnInit(): void;
+    resetScope(): void;
+    canChangeScope(): boolean;
+    scopeIsSet(): boolean;
+    saveNewCalendar(service?: ExternalCalendarSources | string): Promise<void>;
+    close(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<IDEACalendarCreationComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<IDEACalendarCreationComponent, "idea-calendar-creation", never, { "fixScope": { "alias": "fixScope"; "required": false; }; "onlyExternalCalendars": { "alias": "onlyExternalCalendars"; "required": false; }; "baseURL": { "alias": "baseURL"; "required": false; }; }, {}, never, never, false, never>;
+}
+/**
+ * The possible scopes of the calendar.
+ */
+declare enum CalendarScopes {
+    SHARED = "shared",// teamId
+    PRIVATE = "private"
+}
+
+declare class IDEAAgendaModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<IDEAAgendaModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<IDEAAgendaModule, [typeof IDEAAgendaComponent, typeof IDEACalendarComponent, typeof IDEACalendarItemComponent, typeof IDEACalendarCreationComponent], [typeof i5.CommonModule, typeof i6.FormsModule, typeof i7.IonicModule, typeof i8.IDEATranslationsModule, typeof i9.IDEAColorPickerComponent, typeof i8.IDEACheckerComponent, typeof i8.IDEAUserAvatarComponent, typeof i10.CalendarModule], [typeof IDEAAgendaComponent, typeof IDEACalendarComponent, typeof IDEACalendarItemComponent, typeof IDEACalendarCreationComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<IDEAAgendaModule>;
+}
+
+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;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CustomDateFormatter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<CustomDateFormatter>;
+}
+
+export { CalendarScopes, CustomDateFormatter, DragToCreateOptions, EventAttendance, IDEAAgendaComponent, IDEAAgendaModule, IDEACalendarComponent, IDEACalendarCreationComponent, IDEACalendarItemComponent, IDEACalendarsService };
+export type { AgendaEvent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idea-ionic/agenda",
-  "version": "8.5.13",
+  "version": "8.6.0",
   "description": "IDEA Ionic agenda (calendar)",
   "license": "MPL-2.0",
   "author": "ITER IDEA <info@iter-idea.com> (https://iter-idea.com)",
@@ -18,27 +18,27 @@
     "url": "https://github.com/iter-idea/IDEA-Ionic8-extra/issues"
   },
   "peerDependencies": {
-    "@angular/animations": "^18.2.8",
-    "@angular/common": "^18.2.8",
-    "@angular/core": "^18.2.8",
-    "@angular/forms": "^18.2.8",
-    "@angular/platform-browser": "^18.2.8",
-    "@angular/platform-browser-dynamic": "^18.2.8",
-    "@angular/router": "^18.2.8",
-    "@capacitor/browser": "^6.0.1",
-    "@capacitor/core": "^6.1.1",
+    "@angular/animations": "^20.1.3",
+    "@angular/common": "^20.1.3",
+    "@angular/core": "^20.1.3",
+    "@angular/forms": "^20.1.3",
+    "@angular/platform-browser": "^20.1.3",
+    "@angular/platform-browser-dynamic": "^20.1.3",
+    "@angular/router": "^20.1.3",
+    "@capacitor/browser": "^7.0.1",
+    "@capacitor/core": "^7.4.2",
     "@idea-ionic/common": "^8.x.x",
     "@idea-ionic/uncommon": "^8.x.x",
-    "@ionic/angular": "^8.0.0",
+    "@ionic/angular": "^8.6.5",
     "@ionic/storage-angular": "^4.0.0",
     "angular-calendar": "^0.31.1",
-    "date-fns": "^3.6.0",
+    "date-fns": "^4.1.0",
     "idea-toolbox": "^7.x.x",
     "rxjs": "~7.8.0",
-    "zone.js": "~0.14.10"
+    "zone.js": "~0.15.1"
   },
   "dependencies": {
-    "color-parse": "^2.0.0",
+    "color-parse": "^2.0.2",
     "tslib": "^2.4.1"
   },
   "sideEffects": false,
@@ -50,9 +50,7 @@
     },
     ".": {
       "types": "./index.d.ts",
-      "esm2022": "./esm2022/idea-ionic-agenda.mjs",
-      "esm": "./esm2022/idea-ionic-agenda.mjs",
       "default": "./fesm2022/idea-ionic-agenda.mjs"
     }
   }
-}
+}

package/esm2022/idea-ionic-agenda.mjs

@@ -1,5 +0,0 @@
-/**
- * Generated bundle index. Do not edit.
- */
-export * from './public-api';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaWRlYS1pb25pYy1hZ2VuZGEuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9tb2R1bGVzL2FnZW5kYS9pZGVhLWlvbmljLWFnZW5kYS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUVILGNBQWMsY0FBYyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBHZW5lcmF0ZWQgYnVuZGxlIGluZGV4LiBEbyBub3QgZWRpdC5cbiAqL1xuXG5leHBvcnQgKiBmcm9tICcuL3B1YmxpYy1hcGknO1xuIl19

package/esm2022/public-api.mjs

@@ -1,8 +0,0 @@
-export * from './src/agenda.module';
-export * from './src/agenda.component';
-export * from './src/calendar.component';
-export * from './src/calendarCreation.component';
-export * from './src/calendarItem.component';
-export * from './src/calendars.service';
-export * from './src/dateFormatter.provider';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHVibGljLWFwaS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL21vZHVsZXMvYWdlbmRhL3B1YmxpYy1hcGkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxxQkFBcUIsQ0FBQztBQUNwQyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsMEJBQTBCLENBQUM7QUFDekMsY0FBYyxrQ0FBa0MsQ0FBQztBQUNqRCxjQUFjLDhCQUE4QixDQUFDO0FBQzdDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyw4QkFBOEIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCAqIGZyb20gJy4vc3JjL2FnZW5kYS5tb2R1bGUnO1xuZXhwb3J0ICogZnJvbSAnLi9zcmMvYWdlbmRhLmNvbXBvbmVudCc7XG5leHBvcnQgKiBmcm9tICcuL3NyYy9jYWxlbmRhci5jb21wb25lbnQnO1xuZXhwb3J0ICogZnJvbSAnLi9zcmMvY2FsZW5kYXJDcmVhdGlvbi5jb21wb25lbnQnO1xuZXhwb3J0ICogZnJvbSAnLi9zcmMvY2FsZW5kYXJJdGVtLmNvbXBvbmVudCc7XG5leHBvcnQgKiBmcm9tICcuL3NyYy9jYWxlbmRhcnMuc2VydmljZSc7XG5leHBvcnQgKiBmcm9tICcuL3NyYy9kYXRlRm9ybWF0dGVyLnByb3ZpZGVyJztcbiJdfQ==