@acorex/components 20.1.35 → 20.1.37

package/form/index.d.ts

@@ -93,6 +93,12 @@ declare class AXFormComponent extends MXBaseComponent implements OnDestroy, Afte
      *  @ignore
      */
     private get fields();
+    /**
+     * Validates the form fields.
+     *
+     * @param names - Optional array of field names to validate.
+     * @returns Promise<AXValidationSummary> - Promise that resolves with validation results.
+     */
     validate(...names: string[]): Promise<AXValidationSummary>;
     /**
      *  @ignore
@@ -100,10 +106,14 @@ declare class AXFormComponent extends MXBaseComponent implements OnDestroy, Afte
     private _emitOnValidateEvent;
     /**
      * Resets all form fields without clearing errors.
+     *
+     * @returns void - No return value. Form fields are reset to their initial values.
      */
     reset(): void;
     /**
      * Resets validation errors for all form fields.
+     *
+     * @returns void - No return value. All validation errors are cleared.
      */
     resetErrors(): void;
     /**

package/grid-layout-builder/index.d.ts

@@ -113,27 +113,35 @@ declare class AXGridLayoutWidgetComponent {
     options: _angular_core.InputSignal<AXGridLayoutNode>;
     /**
      * Locks or unlocks the widget (prevents dragging and resizing).
-     * @param state - If `true`, the widget will be locked.
+     *
+     * @param state - If true, the widget will be locked.
+     * @returns void - No return value. The widget lock state is updated.
      */
     setLockable(state: boolean): void;
     /**
      * Enables or disables resizing of the widget.
-     * @param state - If `true`, resizing will be enabled.
+     *
+     * @param state - If true, resizing will be enabled.
+     * @returns void - No return value. The widget resize state is updated.
      */
     setResizable(state: boolean): void;
     /**
      * Updates the widget options.
+     *
      * @param options - The new options for the widget.
+     * @returns void - No return value. The widget options are updated.
      */
     setOptions(options: AXGridLayoutWidget): void;
     /**
      * Returns the current options of the widget.
-     * @returns The current widget options.
+     *
+     * @returns AXGridLayoutNode - The current widget options.
      */
     getOptions(): AXGridLayoutNode;
     /**
      * Returns the native DOM element of the widget.
-     * @returns The native element.
+     *
+     * @returns AXGridLayoutWidgetElement - The native element.
      */
     get element(): AXGridLayoutWidgetElement;
     /**
@@ -167,21 +175,124 @@ declare class AXGridLayoutContainerComponent extends NXComponent implements OnDe
     private hookEvents;
     private unhookEvents;
     private _dispatchChangeEvent;
+    /**
+     * Adds a widget to the grid layout.
+     *
+     * @param w - Widget configuration object.
+     * @param withAutoArrange - Whether to compact the grid before adding the widget.
+     * @returns AXGridLayoutWidgetElement | undefined - The created widget element or undefined if failed.
+     */
     addWidget(w: AXGridLayoutWidget, withAutoArrange?: boolean): AXGridLayoutWidgetElement | undefined;
+    /**
+     * Compacts the grid layout.
+     *
+     * @param layout - Layout type for compacting ('list' or 'compact').
+     * @param doSort - Whether to sort items while compacting.
+     * @returns void - No return value. The grid layout is compacted.
+     */
     compact(layout?: 'list' | 'compact', doSort?: boolean): void;
+    /**
+     * Sets the cell height of the grid.
+     *
+     * @param val - New cell height value.
+     * @param update - Whether to update the grid immediately.
+     * @returns void - No return value. The cell height is updated.
+     */
     setCellHeight(val: number, update?: boolean): void;
+    /**
+     * Sets the number of columns in the grid.
+     *
+     * @param column - Number of columns.
+     * @param layout - Layout type for the change ('list', 'compact', 'moveScale', 'move', 'scale', or 'none').
+     * @returns void - No return value. The column count is updated.
+     */
     setColumn(column: number, layout?: 'list' | 'compact' | 'moveScale' | 'move' | 'scale' | 'none'): void;
+    /**
+     * Destroys the grid instance.
+     *
+     * @param removeDOM - Whether to remove DOM elements.
+     * @returns void - No return value. The grid instance is destroyed.
+     */
     destroy(removeDOM?: boolean): void;
+    /**
+     * Enables or disables moving of widgets.
+     *
+     * @param state - Whether to enable moving.
+     * @param recurse - Whether to apply to all child widgets.
+     * @returns void - No return value. The move state is updated.
+     */
     setMovable(state: boolean, recurse?: boolean): void;
+    /**
+     * Enables or disables resizing of widgets.
+     *
+     * @param state - Whether to enable resizing.
+     * @param recurse - Whether to apply to all child widgets.
+     * @returns void - No return value. The resize state is updated.
+     */
     setResizable(state: boolean, recurse?: boolean): void;
+    /**
+     * Sets the float property of the grid.
+     *
+     * @param val - Whether to enable floating widgets.
+     * @returns void - No return value. The float state is updated.
+     */
     setFloat(val: boolean): void;
+    /**
+     * Sets the margin between grid items.
+     *
+     * @param value - Margin value (number in pixels or string with units).
+     * @returns void - No return value. The margin is updated.
+     */
     setMargin(value: number | string): void;
+    /**
+     * Removes a specific widget from the grid.
+     *
+     * @param el - The widget element to remove.
+     * @param removeDOM - Whether to remove the DOM element.
+     * @param triggerEvent - Whether to trigger removal events.
+     * @returns void - No return value. The widget is removed.
+     */
     removeWidget(el: AXGridLayoutWidgetElement, removeDOM?: boolean, triggerEvent?: boolean): void;
+    /**
+     * Removes all widgets from the grid.
+     *
+     * @param removeDOM - Whether to remove DOM elements.
+     * @returns void - No return value. All widgets are removed.
+     */
     removeAll(removeDOM?: boolean): void;
+    /**
+     * Sets the animation state for the grid.
+     *
+     * @param doAnimate - Whether to enable animations.
+     * @returns void - No return value. The animation state is updated.
+     */
     setAnimation(doAnimate: boolean): void;
+    /**
+     * Sets up draggable functionality for external elements.
+     *
+     * @param dragIn - CSS selector string or array of HTML elements to make draggable.
+     * @param widgets - Optional widget configuration for dragged items.
+     * @returns Promise<void> - Promise that resolves when drag setup is complete.
+     */
     setupDraggable(dragIn?: string | HTMLElement[], widgets?: AXGridLayoutWidget): Promise<void>;
+    /**
+     * Gets the current grid options.
+     *
+     * @returns AXGridLayoutOptions - Current grid configuration options.
+     */
     getOptions(): AXGridLayoutOptions;
+    /**
+     * Gets all child widgets in the grid.
+     *
+     * @returns AXGridLayoutNode[] - Array of all child widget nodes.
+     */
     getChildren(): AXGridLayoutNode[];
+    /**
+     * Finds an empty space in the grid for a widget.
+     *
+     * @param input - Dimensions of the widget with height and width.
+     * @returns { x: number; y: number } - Object containing x and y coordinates of empty space.
+     */
     findEmptySpace(input: Required<Pick<AXGridLayoutPosition, 'height' | 'width'>>): Pick<AXGridLayoutPosition, 'x' | 'y'>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXGridLayoutContainerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXGridLayoutContainerComponent, "ax-grid-layout-container", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "isEmpty": { "alias": "isEmpty"; "required": false; "isSignal": true; }; }, { "onAdded": "onAdded"; "onRemoved": "onRemoved"; "onWidgetChange": "onWidgetChange"; "onChange": "onChange"; "onRender": "onRender"; "isEmpty": "isEmptyChange"; }, ["gridstackItems"], ["*"], true, never>;

package/list/index.d.ts

@@ -1,6 +1,6 @@
 import * as i0 from '@angular/core';
-import { OnInit, EventEmitter, WritableSignal, TemplateRef } from '@angular/core';
-import { AXEvent, MXSelectionValueComponent, AXItemClickEvent, AXDataSource, AXListDataSource } from '@acorex/cdk/common';
+import { OnInit, WritableSignal, TemplateRef, EventEmitter } from '@angular/core';
+import { AXEvent, MXSelectionValueComponent, AXDataSource, AXListDataSource } from '@acorex/cdk/common';
 
 interface AXListScrollIndexChanged extends AXEvent {
     index: number;
@@ -23,12 +23,6 @@ declare class AXListComponent extends MXSelectionValueComponent implements OnIni
      * @defaultValue false
      */
     showItemTooltip: i0.InputSignal<boolean>;
-    /**
-     * Emitted when an item in the list is clicked.
-     *
-     * @event
-     */
-    onItemClick: EventEmitter<AXItemClickEvent<any>>;
     /**
      * Defines the data source for the list.
      *
@@ -144,7 +138,7 @@ declare class AXListComponent extends MXSelectionValueComponent implements OnIni
      */
     showEmptyTemplate: i0.Signal<boolean>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXListComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<AXListComponent, "ax-list", never, { "id": { "alias": "id"; "required": false; }; "name": { "alias": "name"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "valueField": { "alias": "valueField"; "required": false; }; "textField": { "alias": "textField"; "required": false; }; "textTemplate": { "alias": "textTemplate"; "required": false; }; "disabledField": { "alias": "disabledField"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; }; "isItemTruncated": { "alias": "isItemTruncated"; "required": false; "isSignal": true; }; "showItemTooltip": { "alias": "showItemTooltip"; "required": false; "isSignal": true; }; "dataSource": { "alias": "dataSource"; "required": false; }; "itemHeight": { "alias": "itemHeight"; "required": false; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; }; "checkbox": { "alias": "checkbox"; "required": false; }; }, { "onValueChanged": "onValueChanged"; "disabledChange": "disabledChange"; "readonlyChange": "readonlyChange"; "onBlur": "onBlur"; "onFocus": "onFocus"; "onItemClick": "onItemClick"; "onScrolledIndexChanged": "onScrolledIndexChanged"; }, never, ["ax-header", "ax-footer"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AXListComponent, "ax-list", never, { "id": { "alias": "id"; "required": false; }; "name": { "alias": "name"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "readonly": { "alias": "readonly"; "required": false; }; "valueField": { "alias": "valueField"; "required": false; }; "textField": { "alias": "textField"; "required": false; }; "textTemplate": { "alias": "textTemplate"; "required": false; }; "disabledField": { "alias": "disabledField"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "selectionMode": { "alias": "selectionMode"; "required": false; }; "isItemTruncated": { "alias": "isItemTruncated"; "required": false; "isSignal": true; }; "showItemTooltip": { "alias": "showItemTooltip"; "required": false; "isSignal": true; }; "dataSource": { "alias": "dataSource"; "required": false; }; "itemHeight": { "alias": "itemHeight"; "required": false; }; "itemTemplate": { "alias": "itemTemplate"; "required": false; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; }; "loadingTemplate": { "alias": "loadingTemplate"; "required": false; }; "checkbox": { "alias": "checkbox"; "required": false; }; }, { "onValueChanged": "onValueChanged"; "disabledChange": "disabledChange"; "readonlyChange": "readonlyChange"; "onBlur": "onBlur"; "onFocus": "onFocus"; "onItemClick": "onItemClick"; "onItemSelected": "onItemSelected"; "onScrolledIndexChanged": "onScrolledIndexChanged"; }, never, ["ax-header", "ax-footer"], true, never>;
 }
 
 declare class AXListModule {

package/menu/index.d.ts

@@ -68,8 +68,20 @@ declare class AXContextMenuComponent extends NXComponent {
     /** @ignore */
     constructor();
     ngOnDestroy(): void;
+    /**
+     * Refreshes the context menu by rebinding event listeners to target elements.
+     */
     refresh(): void;
+    /**
+     * Shows the context menu at a specific point.
+     * @param point - The coordinates where the menu should appear
+     * @param targetElement - Optional target element for the context menu
+     * @param event - Optional opening event with menu items
+     */
     showAt(point: AXPoint, targetElement?: HTMLElement, event?: AXContextMenuOpeningEvent): void;
+    /**
+     * Closes the context menu and removes the backdrop.
+     */
     close(): void;
     private backdropElement;
     private originalNextSibling;

package/modal/index.d.ts

@@ -25,6 +25,7 @@ interface AXModalOptions extends AXOverlayOptions {
     header?: boolean;
     footer?: boolean;
     panelClass?: string;
+    closeOnEscape?: boolean;
 }
 interface AXModalRef<TResult = any> {
     minimize: () => void;
@@ -35,13 +36,13 @@ interface AXModalRef<TResult = any> {
     onClose: Subject<TResult>;
 }
 declare abstract class AXModalComponentBase {
-    private __modal__;
+    __modal__: i0.InputSignal<AXModalRef<any>>;
     close(data?: any): void;
     minimize(): void;
     restore(): void;
     maximize(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXModalComponentBase, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<AXModalComponentBase, never, never, { "__modal__": { "alias": "__modal__"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<AXModalComponentBase, never, never, { "__modal__": { "alias": "__modal__"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class AXModalComponent extends NXComponent {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex/components",
-  "version": "20.1.35",
+  "version": "20.1.37",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
@@ -143,6 +143,10 @@
       "types": "./cron-job/index.d.ts",
       "default": "./fesm2022/acorex-components-cron-job.mjs"
     },
+    "./data-list": {
+      "types": "./data-list/index.d.ts",
+      "default": "./fesm2022/acorex-components-data-list.mjs"
+    },
     "./data-pager": {
       "types": "./data-pager/index.d.ts",
       "default": "./fesm2022/acorex-components-data-pager.mjs"
@@ -383,14 +387,14 @@
       "types": "./skeleton/index.d.ts",
       "default": "./fesm2022/acorex-components-skeleton.mjs"
     },
-    "./sliding-item": {
-      "types": "./sliding-item/index.d.ts",
-      "default": "./fesm2022/acorex-components-sliding-item.mjs"
-    },
     "./slider": {
       "types": "./slider/index.d.ts",
       "default": "./fesm2022/acorex-components-slider.mjs"
     },
+    "./sliding-item": {
+      "types": "./sliding-item/index.d.ts",
+      "default": "./fesm2022/acorex-components-sliding-item.mjs"
+    },
     "./step-wizard": {
       "types": "./step-wizard/index.d.ts",
       "default": "./fesm2022/acorex-components-step-wizard.mjs"

package/paint/index.d.ts

@@ -37,12 +37,45 @@ declare class AXPaintContainerComponent extends AXPaintContainerComponent_base {
     protected service: AXPaintService;
     readonly editMode: _angular_core.InputSignal<boolean>;
     get __hostClass(): string;
+    /**
+     * Sets the active drawing tool.
+     *
+     * @param tool - The tool to activate: 'pen', 'highlight', or 'eraser'
+     */
     setActiveTool(tool: 'pen' | 'highlight' | 'eraser'): void;
+    /**
+     * Sets the pen color for drawing.
+     *
+     * @param color - The color to use for the pen tool
+     */
     setPenColor(color: string | CanvasGradient | CanvasPattern): void;
+    /**
+     * Sets the highlight color for highlighting.
+     *
+     * @param color - The color to use for the highlight tool
+     */
     setHighlightColor(color: string | CanvasGradient | CanvasPattern): void;
+    /**
+     * Sets the pen width for drawing.
+     *
+     * @param width - The width of the pen stroke in pixels
+     */
     setPenWidth(width: number): void;
+    /**
+     * Sets the highlight width for highlighting.
+     *
+     * @param width - The width of the highlight stroke in pixels
+     */
     setHighlightWidth(width: number): void;
+    /**
+     * Sets the eraser width for erasing.
+     *
+     * @param width - The width of the eraser in pixels
+     */
     setEraserWidth(width: number): void;
+    /**
+     * Clears the entire canvas.
+     */
     clear(): void;
     private get __hostName();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPaintContainerComponent, never>;
@@ -94,7 +127,9 @@ declare class AXPaintViewComponent implements OnDestroy {
     /** @ignore */
     protected mouseUpHandler(): void;
     /**
-     * @param e - output file type
+     * Exports the canvas content as an image.
+     *
+     * @param format - The image format: 'image/webp', 'image/png', or 'image/jpeg'
      */
     getOutPut(e: 'image/webp' | 'image/png' | 'image/jpeg'): void;
     get __hostClass(): string[];