@easyquery/ui 7.4.2 → 7.5.0-rc01

package/dist/types/utils/column_key_utils.d.ts

@@ -0,0 +1,20 @@
+/** The parts of a query column the key computation relies on. */
+export interface ColumnKeyQueryColumn {
+    expr: {
+        saveToData(): any;
+    };
+}
+/** The parts of a result-set data column the key computation relies on. */
+export interface ColumnKeyDataColumn {
+    originAttrId?: string | null;
+}
+/**
+ * Computes a stable per-column identity used to persist column widths:
+ * the query column's expression (attribute id, else the serialized expression),
+ * falling back to the server-provided origin attribute id when the query has
+ * no matching column (e.g. a data-filtering fetch with an empty column list,
+ * where the server reflects all entity properties into auto-columns).
+ * Returns null when the column has no stable identity — such columns are not
+ * persisted (transient ids would only pollute the store).
+ */
+export declare function stableColumnKey(qcol: ColumnKeyQueryColumn | null | undefined, dataColumn: ColumnKeyDataColumn | null | undefined): string | null;

package/dist/types/utils/popup_menu_utils.d.ts

@@ -0,0 +1,27 @@
+export interface MenuPlacementInput {
+    /** Document-absolute top of the anchor: the root anchor element or the parent item. */
+    anchorY: number;
+    /** Height of the anchor element / parent item; 0 if unknown. */
+    anchorHeight: number;
+    /** Natural levelDiv height (measured with maxHeight unset). */
+    menuHeight: number;
+    /** Natural scrollDiv height (measured with maxHeight unset). */
+    scrollDivHeight: number;
+    /** Window vertical scroll (document offset of the viewport top). */
+    scrollY: number;
+    viewportHeight: number;
+    levelIndex: number;
+    useMaxSpace: boolean;
+    /** Edge padding; defaults to 15. */
+    minOffset?: number;
+    /** Menu padding nudge for side-attached sub-levels so the first/last
+     *  sub-item lines up with the parent item; defaults to 0. */
+    alignOffset?: number;
+}
+export interface MenuPlacement {
+    /** Document-absolute CSS top for the levelDiv. */
+    top: number;
+    /** Pixels for scrollDiv.maxHeight; null = leave unset. */
+    maxHeight: number | null;
+}
+export declare function computeMenuPlacement(input: MenuPlacementInput): MenuPlacement;

package/dist/types/views/view_options.d.ts

@@ -95,6 +95,15 @@ export interface EqViewOptions extends EqContextOptions {
     fetchDataOnChange?: boolean;
     disableConfirmationOnQueryChange?: boolean;
     queryFileExtensions?: string;
+    /**
+     * DataFilterView only: fill an empty query with the root entity's own
+     * result-ready attributes once the model is loaded, so the "show the whole
+     * entity" fetch runs as an ordinary query with explicit columns
+     * (server-side sorting, column-width persistence, etc. work through their
+     * normal path). Enabled by default; set to false to send an empty column
+     * list and rely on server-side auto-columns instead.
+     */
+    autoFillColumns?: boolean;
 }
 /**
  * [[ReportView]] options

package/dist/types/widgets/charts/chart_widget.d.ts

@@ -60,6 +60,14 @@ export declare abstract class ChartWidget extends Widget {
     protected abstract hasChartTypes: ChartType[];
     getSupportedChartTypes(): ChartType[];
     getCurrentChartType(): ChartType;
+    /**
+     * Changes the current chart type and redraws the chart in place.
+     * Deliberately avoids a full re-render: emptying the widget (even for
+     * the drawing delay) shrinks the scrollable parent, so the browser
+     * clamps - and loses - its scroll position.
+     * @param type The new chart type.
+     */
+    changeChartType(type: ChartType): void;
     protected abstract canDraw(): boolean;
     protected abstract initChart(): void;
     private render;

package/dist/types/widgets/charts/chart_widget_chartjs.d.ts

@@ -10,13 +10,22 @@ export declare class ChartJsWidget extends ChartWidget {
     getWidgetType(): string;
     private chartLabels;
     private chartColumns;
+    private chart;
     protected hasChartTypes: ChartType[];
     static hasChartJs(): boolean;
+    /**
+     * Returns the major version of the Chart.js library loaded on the page.
+     * `Chart.version` was introduced in 3.0, so its absence means 2.x.
+     */
+    static getChartJsMajorVersion(): number;
     protected canDraw(): boolean;
     protected initChart(): void;
     protected drawCore(): void;
+    protected destroyCore(): void;
+    private destroyChart;
     protected updateChartColumns(): void;
     private getChartCanvas;
     private generateConfig;
+    private generateOptions;
     private getChartType;
 }

package/dist/types/widgets/columns_panel.d.ts

@@ -1,4 +1,4 @@
-import { EqContext, QueryColumn, Widget } from '@easyquery/core';
+import { EqContext, Query, QueryColumn, Widget } from '@easyquery/core';
 import { ColumnsEditMode, ColumnsPanelOptions } from './widget_options';
 import { PopupMenu } from '../utils/popup_menu';
 export declare class ColumnsPanel extends Widget {
@@ -11,8 +11,9 @@ export declare class ColumnsPanel extends Widget {
     sortMenu: PopupMenu;
     moveMenu: PopupMenu;
     private queryEventCallbackId;
+    private customQuery;
     protected get cssPrefix(): string;
-    constructor(slot: HTMLElement);
+    constructor(slot: HTMLElement, customQuery?: Query);
     getWidgetType(): string;
     /**
      * Gets or sets the current edit mode. When setting, automatically refreshes the widget.
@@ -24,7 +25,7 @@ export declare class ColumnsPanel extends Widget {
     protected destroyCore(): void;
     private attachQueryObserver;
     private detachQueryObserver;
-    private getQuery;
+    getQuery(): Query;
     private landingSlot;
     private landingIndex;
     private showLandingSlot;

package/dist/types/widgets/easy_grid_widget.d.ts

@@ -6,6 +6,10 @@ export declare class EasyGridWidget extends Grid {
     private entitiesMenu;
     private queryEventCallbackId;
     private hasCustomTotalsSettings;
+    private columnWidthCache;
+    private columnWidthScope;
+    private columnWidthsEnabled;
+    private loadedWidthScopeKey;
     protected options: any;
     /**
      * The default constructor.
@@ -32,4 +36,22 @@ export declare class EasyGridWidget extends Grid {
     protected addColumnClickHandler(ev: AddColumnClickEvent): void;
     protected columnMovedHandler(ev: ColumnMovedEvent): void;
     addNewColumn(attrId: string): QueryColumn;
+    private toGridSort;
+    private fromGridSort;
+    /** Reflects the query's current sorting in the grid header indicator. */
+    private syncGridColumn;
+    /** Handles a header-sort click: multi-column server-side sort, then reload. */
+    private columnSortHandler;
+    /** Computes the storage scope key for the current model/query. */
+    private columnWidthScopeKey;
+    /** Stable per-column identity: the query column's expression, else the
+     * server-provided originAttrId (covers the data-filtering scenario where
+     * the query has no columns and the server auto-generates them). */
+    private columnKey;
+    /** Applies a cached width to a grid column (called from onSyncGridColumn). */
+    private applyColumnWidth;
+    /** Persists a width when the user finishes a resize drag. */
+    private columnResizeHandler;
+    /** Loads the width map once per scope key, then refreshes to apply. */
+    private loadColumnWidths;
 }

package/dist/types/widgets/entities_panel.d.ts

@@ -1,4 +1,4 @@
-import { EqContext, Widget } from '@easyquery/core';
+import { EqContext, Widget, Query } from '@easyquery/core';
 import { EntitiesPanelOptions } from './widget_options';
 /**
  * The entities panel wiget, implemented without JQuery.
@@ -11,12 +11,13 @@ export declare class EntitiesPanel extends Widget {
     private filterBoxBlock;
     private filterBoxInput;
     private options;
+    private customQuery;
     protected get cssPrefix(): string;
     /**
      * The default constructor.
      * @param slot The html element.
      */
-    constructor(slot: HTMLElement);
+    constructor(slot: HTMLElement, customQuery?: Query);
     getWidgetType(): string;
     /**
      * Initialize widget.
@@ -24,6 +25,7 @@ export declare class EntitiesPanel extends Widget {
      * @param options The options.
      */
     init(context: EqContext, options?: EntitiesPanelOptions): void;
+    getQuery(): Query;
     /**
     * Refresh widget implementation
     */

package/dist/types/widgets/sorting_bar.d.ts

@@ -5,17 +5,18 @@ export declare class SortingBar extends Widget {
     protected get cssPrefix(): string;
     options: SortingBarOptions;
     private queryEventCallbackId?;
+    private customQuery;
     private columnsBlock;
     private addRowButton;
     sortMenu: PopupMenu;
     private entitiesMenu;
-    constructor(slot: HTMLElement);
+    constructor(slot: HTMLElement, customQuery?: Query);
     getWidgetType(): string;
     init(context: EqContext, options?: SortingBarOptions): void;
     private setOptions;
     private attachQueryObserver;
     private detachQueryObserver;
-    protected getQuery(): Query;
+    getQuery(): Query;
     protected getModel(): DataModel;
     protected destroyCore(): void;
     protected refreshCore(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@easyquery/ui",
-    "version": "7.4.2",
+    "version": "7.5.0-rc01",
     "description": "EasyQuery.JS Community UI widgets",
     "types": "./dist/types/public_api.d.ts",
     "main": "./dist/easyquery.ui.cjs.js",
@@ -11,7 +11,8 @@
         "build": "npm run clear && rollup -c",
         "watch": "rollup -c -w",
         "dev": "npm run watch",
-        "docs": "typedoc src/public_api.ts --out ./docs"
+        "docs": "typedoc src/public_api.ts --out ./docs",
+        "test": "vitest run"
     },
     "author": "Korzh.com",
     "homepage": "https://korzh.com/easyquery/javascript",
@@ -30,7 +31,7 @@
     "bugs": "https://korzh.com/support",
     "license": "LGPL-3.0",
     "peerDependencies": {
-        "@easyquery/core": "^7.4.2"
+        "@easyquery/core": "^7.5.0-rc01"
     },
     "files": [
         "dist",