@progress/kendo-angular-gantt 0.2.1-dev.202112091741 → 0.3.0-dev.202201131518

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

@@ -9,7 +9,8 @@ import { CompositeFilterDescriptor, SortDescriptor } from '@progress/kendo-data-
 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, CellClickEvent, TaskClickEvent } from './models/models';
+import { DataStateChangeEvent, ColumnMenuSettings, RowClassFn, TaskClassFn, ColumnVisibilityChangeEvent, ColumnResizeEvent, ColumnLockedChangeEvent, ColumnReorderEvent, ColumnReorderConfig, GanttTaskModelFields, GanttDependencyModelFields, SortSettings, CellClickEvent, TaskClickEvent, DependencyAddEvent } from './models/models';
+import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { TimelineViewService } from './timeline/timeline-view.service';
 import { TimelineViewType } from './models/timeline-view';
 import { TimelineBaseViewService } from './timeline/timeline-base-view.service';
@@ -18,18 +19,20 @@ 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';
 import { GanttTaskContentTemplateDirective } from './template-directives/task-content-template.directive';
 import { ToolbarTemplateDirective } from './toolbar/toolbar-template.directive';
-import { ToolbarPosition } from './models/toolbar-position';
+import { GanttTimelineComponent } from './timeline/gantt-timeline.component';
+import { ToolbarSettings } from './models/toolbar-settings';
 import { ExpandEvent } from './expanded-state/expand-event';
 import { ViewBase } from './timeline/view-base';
 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';
+import { TaskAddEvent } from './models/events/task-add-event.interface';
+import { DragScrollSettings } from './scrolling/drag-scroll-settings';
 /**
  * Represents the Kendo UI Gantt component for Angular.
  *
@@ -109,10 +112,11 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
     private optionChangesService;
     private dependencyDomService;
     private editService;
-    localizationService: LocalizationService;
+    private localizationService;
     private hostElement;
     private zone;
     treeList: TreeListComponent;
+    timeline: GanttTimelineComponent;
     /**
      * @hidden
      */
@@ -162,11 +166,22 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      */
     data: any[];
     /**
-     * Provides a callback that determines if the given task is selected ([see example]({% slug selection_gantt %}#toc-custom-selection))
+     * Specifies a callback that determines if the given task is selected ([see example]({% slug selection_gantt %}#toc-custom-selection)).
      *
      * > The [`selectable`]({% slug api_gantt_ganttcomponent %}#toc-selectable) prop has to be set to `true` in order for this callback to be executed.
      */
     isSelected: (dataItem: object) => boolean;
+    /**
+     * Specifies a callback that determines if a new dependency is valid.
+     * Used when evaluating if an attempt to create a new dependency will result in a valid link between the two tasks
+     * [see example]({% slug editing_drag_create_dependencies_gantt %}#toc-validation).
+     *
+     * By defalut, dependencies are deemed invalid when:
+     *  - The two tasks are in a parent-child relationship.
+     *  - The two tasks are already dependent on one another. Only one dependency is allowed per pair.
+     *  - The start or end times of the two tasks are incompatible with the attempted dependency type.
+     */
+    validateNewDependency: (dependency: object) => boolean;
     /**
      * Fires when the Gantt selection is changed through user interaction.
      *
@@ -183,24 +198,27 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      */
     selectable: boolean;
     /**
-     * The position of the toolbar.
+     * The toolbar configuration. Defines the position and content of the toolbar(s).
+     * The available properties are `position`, `addTaskTool`, and `viewSelectorTool`.
+     * All are optional and default to `top`.
      *
-     * The possible values are:
-     * - `top`—Positions the toolbar above the Gantt panes.
-     * - `bottom`—Positions the toolbar below the Gantt panes.
+     * The possible values for each option are:
+     * - `top`—Positions the toolbar above the Gantt panes. Renders the respective tool in the top toolbar.
+     * - `bottom`—Positions the toolbar below the Gantt panes. Renders the respective tool in the bottom toolbar.
      * - `both`—Displays two toolbar instances. Positions the first one above,
-     * and the second one - below the Gantt panes.
-     * - `none`—No toolbar is rendered.
+     * and the second one - below the Gantt panes. Renders the respective tool in the both toolbars.
+     * - `none`—No toolbar is rendered when used for setting `position`.
+     * No add task or view selector tool is rendered when used for setting `addTaskTool` or `viewSelectorTool`.
      */
-    toolbarPosition: ToolbarPosition;
+    toolbarSettings: ToolbarSettings;
     /**
      * Gets or sets the callback function that retrieves the child items for a particular item.
      */
-    fetchChildren: (item: object) => Observable<object[]>;
+    fetchChildren: (dataItem: any) => Observable<object[]>;
     /**
      * Gets or sets the callback function that indicates if a particular item has child items.
      */
-    hasChildren: (item: object) => boolean;
+    hasChildren: (dataItem: any) => boolean;
     /**
      * Defines the dependencies that will be drawn between the rendered tasks.
      *
@@ -297,6 +315,12 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * @default false
      */
     columnsResizable: boolean;
+    /**
+     * Specifies the settings for auto-scrolling during dragging
+     * when the pointer moves outside of the container bounderies
+     * [see example]({% slug editing_drag_create_dependencies_gantt %}#toc-auto-scrolling).
+     */
+    dragScrollSettings: DragScrollSettings;
     /**
      * Fires when an item is expanded.
      */
@@ -335,6 +359,15 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * Fires when the user saves an edited task.
      */
     save: EventEmitter<TaskEditEvent>;
+    /**
+     * Fires when the user adds a task.
+     */
+    taskAdd: EventEmitter<TaskAddEvent>;
+    /**
+     * Fires when the user adds a dependency via dragging
+     * [see example]({% slug editing_drag_create_dependencies_gantt %}#toc-basic-concepts).
+     */
+    dependencyAdd: EventEmitter<DependencyAddEvent>;
     /**
      * Fires when the sorting of the Gantt is changed.
      * You have to handle the event yourself and sort the data.
@@ -399,6 +432,15 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * @hidden
      */
     readonly filterMenu: string | boolean;
+    /**
+     * @hidden
+     *
+     * Specifies whether the dependency drag clues will be rendered.
+     * Set internally by the dependency-drag-create directive.
+     *
+     * @default false
+     */
+    renderDependencyDragClues: boolean;
     /**
      * @hidden
      */
@@ -434,10 +476,6 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
      * Used by the views selector.
      */
     readonly viewTypes: string[];
-    /**
-     * @hidden
-     */
-    readonly editDialogFormGroup: FormGroup;
     /**
      * @hidden
      *
@@ -454,12 +492,16 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
     showConfirmationDialog: boolean;
     private _columns;
     private _data;
+    private _dragScrollSettings;
     private _timelinePaneOptions;
     private _treeListPaneOptions;
     private _customToolbarTemplate;
     private _rowClass;
     private _taskClass;
     private _activeView;
+    private _toolbarSettings;
+    private _fetchChildren;
+    private _hasChildren;
     private lastTreeListCellClick;
     private direction;
     private rtl;
@@ -603,4 +645,6 @@ export declare class GanttComponent implements AfterContentInit, OnChanges, OnDe
     private getActiveViewOptions;
     private isSameSelection;
     private getSelectionAction;
+    private getFirstSelectedItem;
+    private defaultValidateNewDependencyCallback;
 }