@progress/kendo-angular-gantt 0.1.4 → 0.2.0-dev.202111241002

package/dist/es2015/editing/edit.service.d.ts

@@ -0,0 +1,20 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2021 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { FormGroup } from '@angular/forms';
+import { Subject } from 'rxjs';
+import { EditEvent, EditResultType } from '../models/events/task-edit-event.interface';
+/**
+ * @hidden
+ */
+export declare class EditService {
+    showEditingDialog: Subject<boolean>;
+    showConfirmationDialog: Subject<any>;
+    editEvent: Subject<EditEvent>;
+    formGroup: FormGroup;
+    dataItem: any;
+    createEditDialog(dataItem: any, formGroup: FormGroup): void;
+    closeEditDialog(): void;
+    triggerEditEvent(editResultType: EditResultType): void;
+}

package/dist/es2015/editing/edit.service.js

@@ -0,0 +1,41 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2021 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import * as tslib_1 from "tslib";
+import { Injectable } from '@angular/core';
+import { Subject } from 'rxjs';
+/**
+ * @hidden
+ */
+let EditService = class EditService {
+    /**
+     * @hidden
+     */
+    constructor() {
+        this.showEditingDialog = new Subject();
+        this.showConfirmationDialog = new Subject();
+        this.editEvent = new Subject();
+    }
+    createEditDialog(dataItem, formGroup) {
+        this.dataItem = dataItem;
+        this.formGroup = formGroup;
+        this.showEditingDialog.next(true);
+    }
+    closeEditDialog() {
+        this.showEditingDialog.next(false);
+        this.dataItem = undefined;
+        this.formGroup = undefined;
+    }
+    triggerEditEvent(editResultType) {
+        this.editEvent.next({
+            formGroup: this.formGroup,
+            dataItem: this.dataItem,
+            editResultType
+        });
+    }
+};
+EditService = tslib_1.__decorate([
+    Injectable()
+], EditService);
+export { EditService };

package/dist/es2015/editing/util.d.ts

@@ -0,0 +1,10 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2021 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { MappingService } from "../common/mapping.service";
+import { TaskEditItem } from "../models/events/task-edit-event.interface";
+/**
+ * @hidden
+ */
+export declare const getEditItem: (dataItem: any, data: any[], mapper: MappingService) => TaskEditItem;

package/dist/es2015/editing/util.js

@@ -0,0 +1,17 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2021 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * @hidden
+ */
+export const getEditItem = (dataItem, data, mapper) => {
+    const treeListDataItem = data.find(item => mapper.extractFromTask(item.data, 'id') === mapper.extractFromTask(dataItem, 'id'));
+    return mapPath(treeListDataItem);
+};
+const mapPath = (item) => ({
+    dataItem: item.data,
+    parent: item.parent.data ? mapPath(item.parent) : null
+});
+const ɵ0 = mapPath;
+export { ɵ0 };

package/dist/es2015/gantt.component.d.ts

@@ -2,13 +2,14 @@
 * Copyright © 2021 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-import { EventEmitter, OnChanges, QueryList, SimpleChanges, Renderer2, AfterContentInit, OnDestroy } from '@angular/core';
-import { DataBoundTreeComponent, ExpandableTreeComponent } from '@progress/kendo-angular-treelist';
-import { TreeListComponent } from '@progress/kendo-angular-treelist';
+import { EventEmitter, OnChanges, QueryList, SimpleChanges, Renderer2, AfterContentInit, OnDestroy, ElementRef, NgZone } from '@angular/core';
+import { FormGroup } from '@angular/forms';
+import { TreeListComponent, DataBoundTreeComponent, ExpandableTreeComponent, SelectionChangeEvent as TreeListSelectionChangeEvent, CellClickEvent as TreeListCellClickEvent } from '@progress/kendo-angular-treelist';
 import { CompositeFilterDescriptor, SortDescriptor } from '@progress/kendo-data-query';
+import { Day } from '@progress/kendo-date-math';
 import { Observable } from 'rxjs';
 import { GanttColumnBase } from './columns/columns';
-import { DataStateChangeEvent, ColumnMenuSettings, RowClassFn, TaskClassFn, ColumnVisibilityChangeEvent, ColumnResizeEvent, ColumnLockedChangeEvent, ColumnReorderEvent, ColumnReorderConfig, GanttTaskModelFields, GanttDependencyModelFields, SortSettings } from './models/models';
+import { DataStateChangeEvent, ColumnMenuSettings, RowClassFn, TaskClassFn, ColumnVisibilityChangeEvent, ColumnResizeEvent, ColumnLockedChangeEvent, ColumnReorderEvent, ColumnReorderConfig, GanttTaskModelFields, GanttDependencyModelFields, SortSettings, CellClickEvent, TaskClickEvent } from './models/models';
 import { TimelineViewService } from './timeline/timeline-view.service';
 import { TimelineViewType } from './models/timeline-view';
 import { TimelineBaseViewService } from './timeline/timeline-base-view.service';
@@ -16,6 +17,8 @@ import { ScrollSyncService } from './scrolling/scroll-sync.service';
 import { DependencyDomService } from './dependencies/dependency-dom.service';
 import { MappingService } from './common/mapping.service';
 import { OptionChangesService } from './common/option-changes.service';
+import { EditService } from './editing/edit.service';
+import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { TimelinePaneOptions, TreeListPaneOptions } from './models/splitter-pane-options.interface';
 import { GanttTaskTemplateDirective } from './template-directives/task-template.directive';
 import { GanttSummaryTaskTemplateDirective } from './template-directives/summary-task-template.directive';
@@ -24,9 +27,79 @@ import { ToolbarTemplateDirective } from './toolbar/toolbar-template.directive';
 import { ToolbarPosition } from './models/toolbar-position';
 import { ExpandEvent } from './expanded-state/expand-event';
 import { ViewBase } from './timeline/view-base';
-import { Day } from '@progress/kendo-date-math';
+import { SelectionChangeEvent } from './selection/selection-change-event';
+import { TaskEditEvent } from './models/events/task-edit-event.interface';
+import { CellCloseEvent } from './models/events/cell-close-event.interface';
 /**
- * The GiGantt
+ * Represents the Kendo UI Gantt component for Angular.
+ *
+ * @example
+ * ```ts-preview
+ * _@Component({
+ *    selector: 'my-app',
+ *    template: `
+ *        <kendo-gantt
+ *            [style.height.px]="500"
+ *            [kendoGanttHierarchyBinding]="data"
+ *            childrenField="subtasks"
+ *            [dependencies]="dependencies">
+ *            <kendo-gantt-column
+ *                field="title"
+ *                title="Task"
+ *                [width]="200"
+ *                [expandable]="true"></kendo-gantt-column>
+ *            <kendo-gantt-column
+ *                field="start"
+ *                title="Start"
+ *                format="dd-MMM-yyyy"
+ *                [width]="120"></kendo-gantt-column>
+ *            <kendo-gantt-column
+ *                field="end"
+ *                title="End"
+ *                format="dd-MMM-yyyy"
+ *                [width]="120"></kendo-gantt-column>
+ *            <kendo-gantt-timeline-day-view></kendo-gantt-timeline-day-view>
+ *            <kendo-gantt-timeline-week-view></kendo-gantt-timeline-week-view>
+ *            <kendo-gantt-timeline-month-view></kendo-gantt-timeline-month-view>
+ *        </kendo-gantt>
+ *    `
+ * })
+ * class AppComponent {
+ *     public data: Task[] = [{
+ *         id: 7, title: 'Validation and R&D', start: new Date('2014-06-02T00:00:00.000Z'),
+ *         end: new Date('2014-06-19T00:00:00.000Z'), completionRatio: 0.45708333333333334,
+ *         subtasks: [
+ *             { id: 18, title: 'Project Kickoff', start: new Date('2014-06-02T00:00:00.000Z'),
+ *                 end: new Date('2014-06-02T00:00:00.000Z'), completionRatio: 0.23 },
+ *             { id: 11, title: 'Research', start: new Date('2014-06-02T00:00:00.000Z'),
+ *                 end: new Date('2014-06-07T00:00:00.000Z'), completionRatio: 0.5766666666666667,
+ *                 subtasks: [
+ *                     { id: 19, title: 'Validation', start: new Date('2014-06-02T00:00:00.000Z'),
+ *                         end: new Date('2014-06-04T00:00:00.000Z'), completionRatio: 0.25 },
+ *                     { id: 39, title: 'Specification', start: new Date('2014-06-04T00:00:00.000Z'),
+ *                         end: new Date('2014-06-07T00:00:00.000Z'), completionRatio: 0.66 }]
+ *             }, { id: 13, title: 'Implementation', start: new Date('2014-06-08T00:00:00.000Z'),
+ *                 end: new Date('2014-06-19T00:00:00.000Z'), completionRatio: 0.77,
+ *                 subtasks: [
+ *                     { id: 24, title: 'Prototype', start: new Date('2014-06-08T00:00:00.000Z'),
+ *                         end: new Date('2014-06-14T00:00:00.000Z'), completionRatio: 0.77 },
+ *                     { id: 29, title: 'UI and Interaction', start: new Date('2014-06-14T00:00:00.000Z'),
+ *                         end: new Date('2014-06-19T00:00:00.000Z'), completionRatio: 0.6 }]
+ *             }, { id: 17, title: 'Release', start: new Date('2014-06-19T00:00:00.000Z'),
+ *                 end: new Date('2014-06-19T00:00:00.000Z'), completionRatio: 0 }]
+ *     }];
+ *
+ *     public dependencies: GanttDependency[] = [
+ *         { id: 528, fromId: 18, toId: 19, type: DependencyType.FS },
+ *         { id: 529, fromId: 19, toId: 39, type: DependencyType.FS },
+ *         { id: 535, fromId: 24, toId: 29, type: DependencyType.FS },
+ *         { id: 551, fromId: 13, toId: 29, type: DependencyType.FF },
+ *         { id: 777, fromId: 7, toId: 11, type: DependencyType.SF },
+ *         { id: 556, fromId: 39, toId: 24, type: DependencyType.FS },
+ *         { id: 546, fromId: 29, toId: 17, type: DependencyType.FS },
+ *     ];
+ * }
+ * ```
  */
 export declare class GanttComponent implements AfterContentInit, OnChanges, OnDestroy, DataBoundTreeComponent, ExpandableTreeComponent {
     private timelineViewService;
@@ -35,6 +108,10 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
     private mapper;
     private optionChangesService;
     private dependencyDomService;
+    private editService;
+    localizationService: LocalizationService;
+    private hostElement;
+    private zone;
     treeList: TreeListComponent;
     /**
      * @hidden
@@ -51,6 +128,7 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
     toolbarTemplateChildren: QueryList<ToolbarTemplateDirective>;
     toolbarTemplate: ToolbarTemplateDirective;
     hostClasses: boolean;
+    readonly dir: string;
     /**
      * A query list of all declared columns.
      */
@@ -83,6 +161,27 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * > The task data items should either conform to the [`GanttTask`]({% slug api_gantt_gantttask %}) interface, or a [`taskModelFields`]({% slug api_gantt_ganttcomponent %}#toc-taskmodelfields) object has to be provided.
      */
     data: any[];
+    /**
+     * Provides a callback that determines if the given task is selected ([see example]({% slug selection_gantt %}#toc-custom-selection))
+     *
+     * > The [`selectable`]({% slug gantt_api_ganttcomponent %}#toc-selectable) prop has to be set to `true` in order for this callback to be executed.
+     */
+    isSelected: (dataItem: object) => boolean;
+    /**
+     * Fires when the Gantt selection is changed through user interaction.
+     *
+     * Holds data about the affected [`items`]({% slug api_gantt_selectionchangeevent %}#toc-items) and the attempted [`action`]({% slug api_gantt_selectionchangeevent %}#toc-action):
+     * - `select` - Triggered on `click` or `ctrl + click` on deselected items.
+     * - `remove` - Triggered on `ctrl + click` on selected items.
+     */
+    selectionChange: EventEmitter<SelectionChangeEvent>;
+    /**
+     * Enables or disables the Gantt selection mechanism ([see example]({% slug selection_gantt %}#toc-custom-selection)).
+     *
+     * > When set to `true`, the [`isSelected`]({% slug gantt_api_ganttcomponent %}#toc-isselected) callback has to be provided.
+     * > When applied, the [`SelectableDirective`]({% slug api_gantt_selectabledirective %}) sets `selectable` to `true` internally.
+     */
+    selectable: boolean;
     /**
      * The position of the toolbar.
      *
@@ -202,10 +301,40 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * Fires when an item is expanded.
      */
     rowExpand: EventEmitter<ExpandEvent>;
+    /**
+     * Fires when a Gantt task in the timeline pane is double-clicked. The data item, associated with the clicked task,
+     * is available in the event data. Use the event handler to open a task editing dialog as necessary.
+     */
+    taskDblClick: EventEmitter<TaskClickEvent>;
+    /**
+     * Fires when the user double clicks a cell.
+     */
+    cellDblClick: EventEmitter<CellClickEvent>;
+    /**
+     * Fires when the user leaves an edited cell.
+     */
+    cellClose: EventEmitter<CellCloseEvent>;
+    /**
+     * Fires when the end user clicks the `Delete` button in the task editing dialog or the task delete icon.
+     * Use the event handler to open a confirmation dialog when necessary.
+     */
+    taskDelete: EventEmitter<any>;
     /**
      * Fires when an item is collapsed.
      */
     rowCollapse: EventEmitter<ExpandEvent>;
+    /**
+     * Fires when the user confirms deleting a task.
+     */
+    remove: EventEmitter<TaskEditEvent>;
+    /**
+     * Fires when the user cancels editing a task.
+     */
+    cancel: EventEmitter<TaskEditEvent>;
+    /**
+     * Fires when the user saves an edited task.
+     */
+    save: EventEmitter<TaskEditEvent>;
     /**
      * Fires when the sorting of the Gantt is changed.
      * You have to handle the event yourself and sort the data.
@@ -254,6 +383,14 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * Fires when the user changes the locked state of the columns from the column menu or by reordering the columns.
      */
     columnLockedChange: EventEmitter<ColumnLockedChangeEvent>;
+    /**
+     * Fires when a cell is clicked.
+     */
+    cellClick: EventEmitter<CellClickEvent>;
+    /**
+     * Fires when a task is clicked.
+     */
+    taskClick: EventEmitter<TaskClickEvent>;
     /**
      * @hidden
      */
@@ -278,6 +415,13 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * @hidden
      */
     readonly viewService: TimelineBaseViewService;
+    /**
+     * @hidden
+     *
+     * Retrieves the `isSelected` callback if `selectable` is set to `true`
+     * Otherwise returns the default callback, which always returns `false`.
+     */
+    readonly isTaskSelected: (dataItem: any) => boolean;
     /**
      * @hidden
      *
@@ -290,12 +434,24 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * Used by the views selector.
      */
     readonly viewTypes: string[];
+    /**
+     * @hidden
+     */
+    readonly editDialogFormGroup: FormGroup;
     /**
      * @hidden
      *
      * Used by the GanttExpandableDirective.
      */
     expandStateChange: EventEmitter<any>;
+    /**
+     * @hidden
+     */
+    showEditingDialog: boolean;
+    /**
+     * @hidden
+     */
+    showConfirmationDialog: boolean;
     private _columns;
     private _data;
     private _timelinePaneOptions;
@@ -304,8 +460,14 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
     private _rowClass;
     private _taskClass;
     private _activeView;
+    private lastTreeListCellClick;
+    private direction;
+    private rtl;
+    private editItem;
     private optionChangesSubscriptions;
-    constructor(timelineViewService: TimelineViewService, scrollSyncService: ScrollSyncService, renderer: Renderer2, mapper: MappingService, optionChangesService: OptionChangesService, dependencyDomService: DependencyDomService);
+    private editServiceSubscription;
+    private localizationSubscription;
+    constructor(timelineViewService: TimelineViewService, scrollSyncService: ScrollSyncService, renderer: Renderer2, mapper: MappingService, optionChangesService: OptionChangesService, dependencyDomService: DependencyDomService, editService: EditService, localizationService: LocalizationService, hostElement: ElementRef<HTMLElement>, zone: NgZone);
     ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
     ngAfterContentInit(): void;
@@ -340,20 +502,42 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * @param {ColumnReorderConfig} options - Additional options.
      */
     reorderColumn(source: GanttColumnBase, destIndex: number, options?: ColumnReorderConfig): void;
+    /**
+     * Updates the data of the Gantt and forces row-related callbacks to be called anew.
+     */
+    updateView(): void;
+    /**
+     * Opens the task editing dialog.
+     */
+    editTask(dataItem: any, formGroup: FormGroup): void;
+    /**
+     * Closes the task editing dialog.
+     */
+    closeTaskDialog(): void;
+    /**
+     * Opens the delete task confirmation dialog.
+     */
+    openConfirmationDialog(): void;
+    /**
+     * Opens a cell for editing.
+     */
+    editCell(dataItem: any, column: number | string | any, formGroup?: FormGroup): void;
+    /**
+     * Closes an edited cell.
+     */
+    closeCell(): void;
     /**
      * @hidden
      */
-    onTreeListCollapsedChange(collapsed: boolean): void;
+    handleCellClose(e: CellCloseEvent): void;
     /**
      * @hidden
      */
-    onTimelineCollapsedChange(collapsed: boolean): void;
+    onTreeListCollapsedChange(collapsed: boolean): void;
     /**
      * @hidden
-     *
-     * Used by the GanttExpandableDirective.
      */
-    updateView(): void;
+    onTimelineCollapsedChange(collapsed: boolean): void;
     /**
      * @hidden
      */
@@ -370,10 +554,50 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * @hidden
      */
     onTimelinePaneSizeChange(e: string): void;
+    /**
+     * @hidden
+     */
+    handleTimelineRightClick(event: PointerEvent): void;
+    /**
+     * @hidden
+     */
+    handleTimelineClick(event: PointerEvent): void;
+    /**
+     * @hidden
+     */
+    handleTreeListDoubleClick(event: PointerEvent): void;
+    /**
+     * @hidden
+     */
+    handleTreeListSelectionChange(event: TreeListSelectionChangeEvent): void;
+    /**
+     * @hidden
+     */
+    handleTreeListCellClick(event: TreeListCellClickEvent): void;
+    /**
+     * @hidden
+     */
+    handleDeleteConfirmation(): void;
+    /**
+     * @hidden
+     */
+    handleTimelineMouseDown(event: MouseEvent): void;
+    /**
+     * @hidden
+     */
+    handleTimelineDblClick(event: PointerEvent): void;
+    /**
+     * @hidden
+     */
+    getText(token: string): string;
+    private emitTaskClick;
+    private emitSelectionChange;
     private updateTreeListGroupClass;
     /**
      * Used to hide the vertical scrollbar
      */
     private updateTreeListMargin;
     private getActiveViewOptions;
+    private isSameSelection;
+    private getSelectionAction;
 }