dhx-suite 8.4.5 → 9.0.0

package/codebase/types/ts-grid/sources/ui/Cells.d.ts

@@ -25,9 +25,11 @@ export declare function normalizeSpan(span: ISpan, config: IGridConfig, data: ID
     column: import("../../../ts-common/types").Id;
     rowspan?: number;
     colspan?: number;
-    text?: string | number;
+    text?: string | ((args: import("../types").ISummaryList) => string);
     css?: string;
     tooltip?: boolean | import("../types").IGridTooltipConfig;
-    tooltipTemplate?: (spanValue: any, span: ISpan) => string;
+    tooltipTemplate?: (content: {
+        value: string;
+    } & import("../types").ISummaryList, span: ISpan) => string | boolean;
 };
 export {};

package/codebase/types/ts-grid/sources/ui/editors/DateEditor.d.ts

@@ -12,6 +12,7 @@ export declare class DateEditor implements IEditor {
     private _calendar;
     private _popup;
     private _value;
+    private _editorConfig;
     constructor(row: IRow, col: ICol, config: IRendererConfig);
     endEdit(withoutSave?: boolean, calendarChange?: boolean): void;
     toHTML(): any;
@@ -32,4 +33,5 @@ export declare class DateEditor implements IEditor {
         view?: import("../../../../ts-calendar").ViewMode;
     };
     protected _initHandlers(): void;
+    private _getValue;
 }

package/codebase/types/ts-grid/sources/ui/editors/InputEditor.d.ts

@@ -13,8 +13,10 @@ export declare class InputEditor implements IEditor {
     private type;
     constructor(row: IRow, col: ICol, config: IRendererConfig);
     endEdit(withoutSave?: boolean): void;
-    toHTML(value?: string): any;
+    toHTML(value?: string | number): any;
     protected _initHandlers(): void;
-    private isValidWord;
-    private isCorrectRange;
+    private _isValidWord;
+    private _isCorrectRange;
+    private _applyValuePattern;
+    private _removeValuePattern;
 }

package/codebase/types/ts-grid/sources/ui/editors/TextAreaEditor.d.ts

@@ -8,7 +8,7 @@ export declare class TextAreaEditor implements IEditor {
         col: ICol;
     };
     protected _config: IRendererConfig;
-    protected _editor: HTMLTextAreaElement;
+    protected _input: HTMLTextAreaElement;
     private type;
     private _minHeight;
     private _prevHeight;
@@ -20,6 +20,8 @@ export declare class TextAreaEditor implements IEditor {
     protected _initHandlers(): void;
     private _getCurrentHeight;
     private _getElementHeight;
+    private _applyValuePattern;
+    private _removeValuePattern;
     private _getCellWidth;
     private _updateHeight;
 }

package/codebase/types/ts-grid/sources/ui/group/panel.d.ts

@@ -0,0 +1,12 @@
+import { IProGrid } from "../../types";
+export interface IGroupItem {
+    id: string;
+    label: string;
+    closable?: boolean;
+    sortable?: boolean;
+    sort?: "asc" | "desc";
+    mode?: "basic" | "drop";
+    notGrouped?: boolean;
+}
+export declare function getGroupItem({ id, label, sort, mode, sortable, closable, }: IGroupItem): any;
+export declare function getGroupPanel(grouped: IGroupItem[], grid: IProGrid): any;

package/codebase/types/ts-treegrid/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./sources/TreeGrid";
+export * from "./sources/types";
+export * from "./sources/TreeGridCollection";

package/codebase/types/ts-treegrid/sources/TreeGrid.d.ts

@@ -0,0 +1,28 @@
+import { GridEvents, IEventHandlersMap, ExtendedGrid, ICellRect, IColumnsWidth, ISpan, IAdjustColumns } from "../../ts-grid";
+import { IEventSystem } from "../../ts-common/events";
+import { DataEvents, DragEvents, IDataEventsHandlersMap, IDragEventsHandlersMap } from "../../ts-data";
+import { TreeGridCollection } from "./TreeGridCollection";
+import { ITreeEventHandlersMap, ITreeGrid, ITreeGridConfig, TreeGridEvents } from "./types";
+import { Id } from "../../ts-common/types";
+export declare class TreeGrid extends ExtendedGrid implements ITreeGrid {
+    config: ITreeGridConfig;
+    data: TreeGridCollection;
+    events: IEventSystem<DataEvents | GridEvents | DragEvents | TreeGridEvents, IEventHandlersMap & IDataEventsHandlersMap & IDragEventsHandlersMap & ITreeEventHandlersMap>;
+    constructor(container: HTMLElement | string | null, config: ITreeGridConfig);
+    expand(rowId: Id): void;
+    collapse(rowId: Id): void;
+    expandAll(): void;
+    collapseAll(): void;
+    showRow(rowId: Id): void;
+    hideRow(rowId: Id): void;
+    getCellRect(rowId: Id, colId: Id): ICellRect;
+    getSpan(rowId: Id, colId: Id): ISpan;
+    protected _adjustColumnsWidth({ rows, cols, totalCols, adjust, }: IAdjustColumns): IColumnsWidth;
+    protected _createCollection(prep: (data: any[]) => any[]): void;
+    protected _getRowIndex(rowId: Id): number;
+    protected _applyLocalFilter(beforePrepareData?: boolean): void;
+    protected _setEventHandlers(): void;
+    private _serialize;
+    private _expand;
+    private _collapse;
+}

package/codebase/types/ts-treegrid/sources/TreeGridCollection.d.ts

@@ -0,0 +1,20 @@
+import { IEventSystem } from "../../ts-common/events";
+import { DataCallback, DataDriver, DataEvents, IDataItem, TreeCollection } from "../../ts-data";
+import { TreeGridEvents } from "./types";
+import { Id } from "../../ts-common/types";
+export declare class TreeGridCollection extends TreeCollection {
+    constructor(config?: any, events?: IEventSystem<DataEvents | TreeGridEvents>);
+    eachChild(id: Id, cb: any, direct?: boolean, checkItem?: (item: IDataItem) => boolean): void;
+    getMaxLevel(): number;
+    getLevel(id: Id): number;
+    serialize(driver?: DataDriver): any[];
+    getPlainIndex(id: Id): number;
+    map(cb: DataCallback<IDataItem>, parent?: Id, direct?: boolean): IDataItem[];
+    mapVisible(cb: DataCallback<IDataItem>, parent?: Id, direct?: boolean): IDataItem[];
+    protected _parse_data(data: any, parent?: Id): void;
+    protected _copy(id: Id, index: number, target?: TreeGridCollection, targetId?: Id, key?: number): Id;
+    protected _addToOrder(_order: any, obj: any, index: number): void;
+    protected _removeCore(id: Id): void;
+    protected _setParent(item: IDataItem, parent: Id): void;
+    private _checkItems;
+}

package/codebase/types/ts-treegrid/sources/types.d.ts

@@ -0,0 +1,34 @@
+import { DataEvents, DragEvents, IDataEventsHandlersMap, IDragEventsHandlersMap } from "../../ts-data";
+import { GridEvents, IEventHandlersMap, IExtendedGrid, IExtendedGridConfig } from "../../ts-grid";
+import { IEventSystem } from "../../ts-common/events";
+import { Id } from "../../ts-common/types";
+import { TreeGridCollection } from "./TreeGridCollection";
+export interface ITreeGridConfig extends IExtendedGridConfig {
+    type?: "tree";
+    rootParent?: Id;
+    dragExpand?: boolean;
+    collapsed?: boolean;
+}
+export interface ITreeGrid extends IExtendedGrid {
+    events: IEventSystem<DataEvents | GridEvents | DragEvents | TreeGridEvents, IEventHandlersMap & IDataEventsHandlersMap & IDragEventsHandlersMap & ITreeEventHandlersMap>;
+    config: ITreeGridConfig;
+    data: TreeGridCollection;
+    scrollTo(rowId: Id, colId: Id): void;
+    expand(rowId: Id): void;
+    collapse(rowId: Id): void;
+    expandAll(): void;
+    collapseAll(): void;
+}
+export declare enum TreeGridEvents {
+    beforeCollapse = "beforeCollapse",
+    afterCollapse = "afterCollapse",
+    beforeExpand = "beforeExpand",
+    afterExpand = "afterExpand"
+}
+export interface ITreeEventHandlersMap {
+    [key: string]: (...args: any[]) => any;
+    [TreeGridEvents.beforeCollapse]: (rowId: Id) => boolean | void;
+    [TreeGridEvents.afterCollapse]: (rowId: Id) => any;
+    [TreeGridEvents.beforeExpand]: (rowId: Id) => boolean | void;
+    [TreeGridEvents.afterExpand]: (rowId: Id) => any;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dhx-suite",
-  "version": "8.4.5",
+  "version": "9.0.0",
   "description": "dhtmlxSuite widget",
   "homepage":"https://docs.dhtmlx.com",
   "license":"GPL",

package/readme.txt

@@ -1,7 +1,7 @@
 /*
 @license
 
-dhtmlxSuite v.8.4.5 Standard
+dhtmlxSuite v.9.0.0 Standard
 This software is covered by GPL-2.0 License. Usage without proper license is prohibited.
 
 (c) XB Software.

package/whatsnew.txt

@@ -1,6 +1,72 @@
-Version 8.4.5 (October 14, 2024)
-----------------------------
-
+# Version 9.0 (November 25, 2024)
+
+### Breaking changes
+
+In this version TreeGrid becomes a part of Grid. Check the Migration guide to keep in step with the latest updates.
+
+### Deprecated
+
+#### Grid
+
+- The column header `content` property doesn't support "avg" | "sum" | "max" | "min" | "count" arguments
+- The column footer `content` property is removed
+- The column `format` property for data format
+- The column `format` property for date format (for columns with type:"date")
+- The column `type: "percent"` property
+- The `groupBy()`, `ungroup()` methods are removed
+- The `groupTitleTemplate` property is removed
+
+### New functionality
+
+#### Common features
+
+- The new helper method `dhx.methods` to define the default data calculation functions used by the library and redefine them to create custom functions
+
+#### DataCollection
+
+- The ability to group data items, aggregate data in a group, adjust the order and configuration of data grouping, render statistics in the summary rows.
+    - new methods: `group()`, `ungroup()`, `isGrouped()`
+    - new events: `beforeGroup`, `afterGroup`, `beforeUnGroup`, `afterUnGroup`
+
+#### Form
+
+- The ability to specify patternMask/numberMask for the Input and Textarea controls
+- The new `getText()` method for getting the text value of an input
+
+#### Grid
+
+- The "tree" mode for Grid (PRO version)
+- Row data grouping (PRO version) with the ability to aggregate data in a group, adjust the appearance, order and configuration of data grouping, render statistics in the summary rows.
+    - new Grid properties: `group`, `groupable`, `closable`
+    - new column properties: `groupable`, `closable`
+    - new events: `groupPanelItemClick`, `groupPanelItemMouseDown`
+- The ability to render custom statistics in the header/footer of columns and Grid spans
+    - the `text` and `tooltipTemplate` properties of a column and of the Grid `spans` configuration object can be set as callback functions to render calculated summary values
+    - new Grid property: `summary`
+    - new method: `getSummary()`
+    - new column property: `summary`
+- The ability to specify patternMask/numberMask for columns
+- Localization for Grid labels is added
+
+### Updates
+
+#### Grid
+
+- The `asDateObject` property is added for the `editorConfig` object of the DatePicker column editor
+to provide the ability to work with a Date object as with a string
+- The `cell` parameter is added for the callback function of the following events:
+`headerCellClick`, `footerCellClick`, `headerCellMouseOver`, `footerCellMouseOver`, `headerCellMouseDown`, `footerCellMouseDown`, `headerCellDblClick`, `footerCellDblClick`, `headerCellRightClick`, `footerCellRightClick`
+- `Ctrl+Enter` shortcut for expanding/collapsing the parent item in the TreeGrid mode
+
+# Version 8.4.6 (October 15, 2024)
+
+### Fixes
+
+- Grid. The issue with opening the Combobox column editor without options
+
+Version 8.4.5 (October 14, 2024)
+----------------------------
+
 # Version 8.4.4 (September 16, 2024)
 
 ### Fixes