dhx-suite 8.3.13 → 8.4.0

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

@@ -78,6 +78,7 @@ export interface ISeriaConfig {
     showText?: boolean;
     showTextRotate?: number | string;
     showTextTemplate?: (points: any) => string;
+    valueTemplate?: (value: number) => string;
     tooltip?: boolean;
     tooltipType?: TooltipType;
     tooltipTemplate?: (points: any[]) => string;

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

@@ -24,6 +24,11 @@ export interface IComboboxConfig {
     value?: Id | Id[];
     newOptions?: boolean;
     htmlEnable?: boolean;
+    eventHandlers?: {
+        [eventName: string]: {
+            [className: string]: (event: Event, id: Id) => void | boolean;
+        };
+    };
     /** @deprecated See a documentation: https://docs.dhtmlx.com/ */
     cellHeight?: number;
     /** @deprecated See a documentation: https://docs.dhtmlx.com/ */

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

@@ -17,7 +17,7 @@ export interface IDataViewConfig extends IListConfig {
     editable?: boolean;
     eventHandlers?: {
         [eventName: string]: {
-            [className: string]: (event: Event, id: Id) => void;
+            [className: string]: (event: Event, id: Id) => void | boolean;
         };
     };
     /** @deprecated See a documentation: https://docs.dhtmlx.com/ */
@@ -35,6 +35,7 @@ export interface IDataView<T extends IDataItem = any> {
     editItem(id: Id): void;
     getFocusItem(): T;
     setFocus(id: Id): void;
+    resetFocus(): void;
     getFocus(): Id;
     /** @deprecated See a documentation: https://docs.dhtmlx.com/ */
     disableSelection(): void;

package/codebase/types/ts-grid/sources/helpers/cells.d.ts

@@ -1,6 +1,7 @@
-import { ICell, ICol, IGrid, IRow } from "./../types";
+import { ICell, ICol, IGrid, IRow, ISpan } from "./../types";
 import { Id } from "../../../ts-common/types";
 export declare function getWidth(columns: ICol[], colspan: number, index: number): number;
-export declare function getHeight(dataRows: IRow[], rowspan: number, index: number): number;
+export declare function getHeight(rows: IRow[], span: ISpan): number;
 export declare function getReducedColspan(columns: ICol[], colId: Id, colspan: number): number;
+export declare function getReducedRowspan(initialRows: IRow[], currRows: IRow[], rowIndex: number, span: ISpan): number;
 export declare function normalizeCell(cell: ICell, grid: IGrid): ICell;

package/codebase/types/ts-grid/sources/helpers/main.d.ts

@@ -1,4 +1,5 @@
-import { ICellCss, ICol, IFooter, IGridConfig, IHeader, IRow, ISpan } from "../types";
+import { ICellCss, ICol, IFooter, IGridConfig, IGridTooltipConfig, IHeader, IRow, ISpan } from "../types";
+import { ITooltipConfig } from "../../../ts-message";
 export declare function transpose(arr: any[][], transform?: any): any[][];
 export declare function getStyleByClass(cssClass: string, targetClass: string, def: ICellCss, container?: HTMLElement): ICellCss;
 export declare function removeHTMLTags(str: string): string;
@@ -6,13 +7,10 @@ export declare function isCssSupport(property: string, value: string): boolean;
 export declare function isRowEmpty(row: IRow): boolean;
 export declare function isSortable(config: IGridConfig, col: ICol): boolean;
 export declare function isAutoWidth(config: IGridConfig, col?: ICol): boolean;
-export declare function showTooltip({ node, value, htmlEnable }: {
-    node: any;
-    value: any;
-    htmlEnable?: boolean;
-}): void;
+export declare function showTooltip(value: any, config: ITooltipConfig): void;
 export declare function isContentTooltip(config: IGridConfig, col: ICol, cell: any, type: "footer" | "header"): boolean;
-export declare function isTooltip(config: IGridConfig, element: ICol | ISpan): boolean;
+export declare function getTooltipConfig(config: IGridConfig, col?: ICol, cell?: IHeader | IFooter | ISpan, type?: "footer" | "header"): IGridTooltipConfig;
+export declare function isTooltip(config: IGridConfig, element: ICol | ISpan): boolean | IGridTooltipConfig;
 export declare function isHtmlEnable(config: IGridConfig, col: ICol, content?: IHeader | IFooter): boolean;
 export declare function getTotalWidth(columns: ICol[]): number;
 export declare function getTotalHeight(rows: IRow[]): number;

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

@@ -1,6 +1,7 @@
 import { IEventSystem } from "../../ts-common/events";
 import { IKeyManager } from "../../ts-common/KeyManager";
 import { IAlign } from "../../ts-common/html";
+import { Position } from "../../ts-message";
 import { IDataCollection, IDragConfig, ICsvDriverConfig, IDataItem, IDragInfo, DataCollection } from "../../ts-data";
 import { Exporter } from "./Exporter";
 import { Combobox } from "../../ts-combobox";
@@ -31,9 +32,9 @@ export interface IGridConfig extends IDragConfig {
     autoEmptyRow?: boolean;
     resizable?: boolean;
     htmlEnable?: boolean;
-    tooltip?: boolean;
-    headerTooltip?: boolean;
-    footerTooltip?: boolean;
+    tooltip?: boolean | IGridTooltipConfig;
+    headerTooltip?: boolean | IGridTooltipConfig;
+    footerTooltip?: boolean | IGridTooltipConfig;
     rowHeight?: number;
     headerRowHeight?: number;
     footerRowHeight?: number;
@@ -82,6 +83,14 @@ export interface IGridConfig extends IDragConfig {
     /** @deprecated See a documentation: https://docs.dhtmlx.com/ */
     splitAt?: number;
 }
+export interface IGridTooltipConfig {
+    force?: boolean;
+    showDelay?: number;
+    hideDelay?: number;
+    margin?: number;
+    position?: Position;
+    css?: string;
+}
 export interface IScrollBarWidth {
     x: number;
     y: number;
@@ -244,7 +253,7 @@ export interface ICol {
     adjust?: IAdjustBy;
     autoWidth?: boolean;
     align?: IAlign;
-    tooltip?: boolean;
+    tooltip?: boolean | IGridTooltipConfig;
     tooltipTemplate?: (cellValue: any, row: IRow, col: ICol) => string;
     gravity?: number;
     $cellCss?: {
@@ -253,7 +262,7 @@ export interface ICol {
     $uniqueData?: any[];
     $activeFilterData?: any[];
     $width?: number;
-    $fixed?: boolean;
+    $fixedWidth?: boolean;
     $customOptions?: any;
     /** @deprecated See a documentation: https://docs.dhtmlx.com/ */
     dateFormat?: string;
@@ -275,7 +284,7 @@ export interface IContent {
     rowspan?: number;
     css?: string;
     align?: IAlign;
-    tooltip?: boolean;
+    tooltip?: boolean | IGridTooltipConfig;
     htmlEnable?: boolean;
 }
 export interface IHeader extends IContent {
@@ -306,7 +315,7 @@ export interface ISpan {
     colspan?: number;
     text?: string | number;
     css?: string;
-    tooltip?: boolean;
+    tooltip?: boolean | IGridTooltipConfig;
     tooltipTemplate?: (spanValue: any, span: ISpan) => string;
     $rowsVisibility?: number[];
     $colsVisibility?: number[];

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

@@ -27,7 +27,7 @@ export declare function normalizeSpan(span: ISpan, config: IGridConfig, data: ID
     colspan?: number;
     text?: string | number;
     css?: string;
-    tooltip?: boolean;
+    tooltip?: boolean | import("../types").IGridTooltipConfig;
     tooltipTemplate?: (spanValue: any, span: ISpan) => string;
 };
 export {};

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

@@ -1,15 +1,15 @@
-import { IGrid, IGridConfig, IProGrid, IRendererConfig, IRow, Split, IScrollBarWidth } from "../types";
+import { IGrid, IGridConfig, IProGrid, IRendererConfig, IRow, Split, IScrollBarWidth, ICol } from "../types";
 export declare const BORDERS = 2;
 export declare function calcScrollBarWidth(config: IGridConfig | IRendererConfig, customScroll?: boolean, sizes?: {
     width: number;
     height: number;
 }): IScrollBarWidth;
-export declare function getCurrFixedCols(config: IGridConfig, split: Split.left | Split.right): import("../types").ICol[];
+export declare function getCurrFixedCols(config: IGridConfig, split: Split.left | Split.right): ICol[];
 export declare function getRenderConfig(obj: any, data: IRow[], wrapperSizes: any): IRendererConfig;
 export declare function getElementSizes(element: HTMLElement | any): {
     width: number;
     height: number;
 };
-export declare function applyAutoWidth(config: IGridConfig, wrapperSizes: any, firstApply?: boolean, resizer?: boolean, scrollViewConfig?: boolean): void;
+export declare function applyAutoWidth(config: IGridConfig, wrapperSizes: any, scrollViewConfig?: boolean): void;
 export declare function render(vm: any, obj: IGrid, htmlEvents: any, selection: any, uid: string): any;
 export declare function proRender(vm: any, obj: IProGrid, htmlEvents: any, selection: any, uid: string): any;

package/codebase/types/ts-layout/sources/Cell.d.ts

@@ -16,6 +16,7 @@ export declare class Cell extends View implements ICell {
     protected _resizerHandlers: any;
     protected _progress: boolean;
     protected _stopProgressDefault: boolean;
+    protected _theme: string;
     private _isLastFlexCell;
     private _afterWindowResized;
     constructor(parent: string | HTMLElement | ILayout, config: ICellConfig);
@@ -38,6 +39,7 @@ export declare class Cell extends View implements ICell {
     progressHide(): void;
     isVisibleProgress(): boolean;
     toVDOM(nodes?: any[]): any;
+    protected _saveTheme(): void;
     protected _getProgressBar(): any;
     protected _getCss(_content?: boolean): string;
     protected _initHandlers(): void;

package/codebase/types/ts-list/sources/List.d.ts

@@ -14,7 +14,7 @@ export declare class List extends View implements IList {
     selection: ISelection;
     keyManager: IKeyManager;
     protected _handlers: IHandlers;
-    protected _focus: Id;
+    protected _focus: Id | undefined;
     protected _edited: Id;
     protected _events: IHandlers;
     private _topOffset;
@@ -35,6 +35,7 @@ export declare class List extends View implements IList {
     editEnd(value: any, id?: Id): void;
     getFocusItem(): any;
     setFocus(id: Id): void;
+    resetFocus(): void;
     getFocus(): Id;
     destructor(): void;
     scrollTo(id: Id): void;

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

@@ -48,7 +48,7 @@ export interface IListEventHandlersMap {
     [ListEvents.itemMouseOver]: (id: Id, e: Event) => void;
     [ListEvents.doubleClick]: (id: Id, e: Event) => void;
     [ListEvents.itemRightClick]: (id: Id, e: MouseEvent) => void;
-    [ListEvents.focusChange]: (focusIndex: number, id: Id) => void;
+    [ListEvents.focusChange]: (focusIndex?: number, id?: Id) => void;
     [ListEvents.beforeEditStart]: (id: Id) => void | boolean;
     [ListEvents.afterEditStart]: (id: Id) => void;
     [ListEvents.beforeEditEnd]: (value: string, id: Id) => void | boolean;
@@ -70,6 +70,7 @@ export interface IList<T extends IDataItem = any> {
     editItem(id: Id): void;
     getFocusItem(): T;
     setFocus(id: Id): void;
+    resetFocus(): void;
     getFocus(): Id;
     scrollTo(id: Id): void;
     /** @deprecated See a documentation: https://docs.dhtmlx.com/ */

package/codebase/types/ts-menu/sources/Menu.d.ts

@@ -1,6 +1,10 @@
 import { Navbar, IMenuElement, INavbar } from "../../ts-navbar";
+import { Id } from "../../ts-common/types";
 export declare class Menu extends Navbar<IMenuElement> implements INavbar {
     constructor(element?: string | HTMLElement, config?: any);
     protected _getFactory(): (item: import("../../ts-navbar").IItem, asMenuItem?: boolean) => any;
+    protected _getMode(item: any, root: any): "right" | "bottom";
+    protected _close(e: MouseEvent): void;
+    protected _setRoot(id: Id): void;
     private _draw;
 }

package/codebase/types/ts-toolbar/sources/Toolbar.d.ts

@@ -1,10 +1,11 @@
 import { Id } from "../../ts-common/types";
 import { TreeCollection } from "../../ts-data";
-import { IState, Navbar, INavbar, IButton, IImageButton, ISelectButton, IInput, ISeparator, ISpacer, ITitle, ICustomHTML, INavItem, IMenuItem, IDatePicker } from "../../ts-navbar";
+import { IState, Navbar, INavbar, IButton, IImageButton, ISelectButton, IInput, ISeparator, ISpacer, ITitle, ICustomHTML, INavItem, IMenuItem, IDatePicker, NavigationType } from "../../ts-navbar";
 export interface IToolbarConfig {
     css?: string;
     menuCss?: string;
     data?: any[] | TreeCollection<IToolbarElement>;
+    navigationType?: NavigationType;
 }
 export interface IToolbar extends INavbar {
     data: TreeCollection<IToolbarElement>;

package/package.json

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

package/readme.txt

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

package/whatsnew.txt

@@ -1,3 +1,41 @@
+# Version 8.4 (July 16, 2024)
+
+### New functionality
+
+- Chart. The ability to specify a template for showing percent values for data items on the Pie, Pie3D and Donut charts
+- Chart. The ability to add the header/footer for an exported PNG/PDF file
+- Combobox. The ability to add event handlers to HTML elements of a custom template of Combobox items
+- Form. The ability to add event handlers to HTML elements of a custom template of the Combo control items
+- Grid/TreeGrid. The ability to add event handlers to HTML elements of a custom template of Combobox editor items in a column
+- Grid/TreeGrid. The ability to add the header/footer for an exported PNG/PDF file
+- Toolbar. The ability to expand items by hovering over Toolbar elements with the mouse pointer
+
+### Updates
+
+- Grid/TreeGrid. The ability to use most Data/TreeCollection methods during dynamic loading before data is fully loaded
+- Grid/TreeGrid. The ability to specify Grid/TreeGrid tooltips as objects with settings
+- Grid/TreeGrid. The ability to provide a filtering function for the Combobox editor in a column
+- List. The ability to use most Data/TreeCollection methods during dynamic loading before data is fully loaded
+
+### Fixes
+
+- Grid/TreeGrid. Fix an issue related to updating sizes according to the parent container
+- Navigation. Closing the menu on click in the "click" navigation mode for Toolbar, Menu, Sidebar, Ribbon
+
+# Version 8.3.14 (July 8, 2024)
+
+### Fixes
+
+- Combobox. The accessibility issue in the NVDA screen reader
+- Grid/TreeGrid. Events aren't triggered for the cell template
+- Grid/TreeGrid. The `adjust` property isn't applied to the "id" column
+- Grid/TreeGrid. The value of the `headerAutoHeight` property in combination with the `adjust` one is calculated incorrectly
+- Grid/TreeGrid. Filtering is reset while dragging rows
+- Grid/TreeGrid. The combination of the `minWidth` and `autoWidth` column properties works incorrectly
+- Grid/TreeGrid. The scrolling functionality and key navigation are fixed
+- Grid/TreeGrid. Filtering with the row-spanned data
+- Layout. A theme applied to a Layout cell resets after the cell is collapsed
+
 # Version 8.3.13 (June 24, 2024)
 
 ### Fixes