@easyquery/core 7.4.2 → 7.5.0-rc01

package/LICENSE.md

@@ -1,163 +1,163 @@
-GNU Lesser General Public License
-=================================
-
-_Version 3, 29 June 2007_  
-_Copyright © 2007 Free Software Foundation, Inc. &lt;<http://fsf.org/>&gt;_
-
-Everyone is permitted to copy and distribute verbatim copies
-of this license document, but changing it is not allowed.
-
-
-This version of the GNU Lesser General Public License incorporates
-the terms and conditions of version 3 of the GNU General Public
-License, supplemented by the additional permissions listed below.
-
-### 0. Additional Definitions
-
-As used herein, “this License” refers to version 3 of the GNU Lesser
-General Public License, and the “GNU GPL” refers to version 3 of the GNU
-General Public License.
-
-“The Library” refers to a covered work governed by this License,
-other than an Application or a Combined Work as defined below.
-
-An “Application” is any work that makes use of an interface provided
-by the Library, but which is not otherwise based on the Library.
-Defining a subclass of a class defined by the Library is deemed a mode
-of using an interface provided by the Library.
-
-A “Combined Work” is a work produced by combining or linking an
-Application with the Library.  The particular version of the Library
-with which the Combined Work was made is also called the “Linked
-Version”.
-
-The “Minimal Corresponding Source” for a Combined Work means the
-Corresponding Source for the Combined Work, excluding any source code
-for portions of the Combined Work that, considered in isolation, are
-based on the Application, and not on the Linked Version.
-
-The “Corresponding Application Code” for a Combined Work means the
-object code and/or source code for the Application, including any data
-and utility programs needed for reproducing the Combined Work from the
-Application, but excluding the System Libraries of the Combined Work.
-
-### 1. Exception to Section 3 of the GNU GPL
-
-You may convey a covered work under sections 3 and 4 of this License
-without being bound by section 3 of the GNU GPL.
-
-### 2. Conveying Modified Versions
-
-If you modify a copy of the Library, and, in your modifications, a
-facility refers to a function or data to be supplied by an Application
-that uses the facility (other than as an argument passed when the
-facility is invoked), then you may convey a copy of the modified
-version:
-
-* **a)** under this License, provided that you make a good faith effort to
-ensure that, in the event an Application does not supply the
-function or data, the facility still operates, and performs
-whatever part of its purpose remains meaningful, or
-
-* **b)** under the GNU GPL, with none of the additional permissions of
-this License applicable to that copy.
-
-### 3. Object Code Incorporating Material from Library Header Files
-
-The object code form of an Application may incorporate material from
-a header file that is part of the Library.  You may convey such object
-code under terms of your choice, provided that, if the incorporated
-material is not limited to numerical parameters, data structure
-layouts and accessors, or small macros, inline functions and templates
-(ten or fewer lines in length), you do both of the following:
-
-* **a)** Give prominent notice with each copy of the object code that the
-Library is used in it and that the Library and its use are
-covered by this License.
-* **b)** Accompany the object code with a copy of the GNU GPL and this license
-document.
-
-### 4. Combined Works
-
-You may convey a Combined Work under terms of your choice that,
-taken together, effectively do not restrict modification of the
-portions of the Library contained in the Combined Work and reverse
-engineering for debugging such modifications, if you also do each of
-the following:
-
-* **a)** Give prominent notice with each copy of the Combined Work that
-the Library is used in it and that the Library and its use are
-covered by this License.
-
-* **b)** Accompany the Combined Work with a copy of the GNU GPL and this license
-document.
-
-* **c)** For a Combined Work that displays copyright notices during
-execution, include the copyright notice for the Library among
-these notices, as well as a reference directing the user to the
-copies of the GNU GPL and this license document.
-
-* **d)** Do one of the following:
-    - **0)** Convey the Minimal Corresponding Source under the terms of this
-License, and the Corresponding Application Code in a form
-suitable for, and under terms that permit, the user to
-recombine or relink the Application with a modified version of
-the Linked Version to produce a modified Combined Work, in the
-manner specified by section 6 of the GNU GPL for conveying
-Corresponding Source.
-    - **1)** Use a suitable shared library mechanism for linking with the
-Library.  A suitable mechanism is one that **(a)** uses at run time
-a copy of the Library already present on the user's computer
-system, and **(b)** will operate properly with a modified version
-of the Library that is interface-compatible with the Linked
-Version.
-
-* **e)** Provide Installation Information, but only if you would otherwise
-be required to provide such information under section 6 of the
-GNU GPL, and only to the extent that such information is
-necessary to install and execute a modified version of the
-Combined Work produced by recombining or relinking the
-Application with a modified version of the Linked Version. (If
-you use option **4d0**, the Installation Information must accompany
-the Minimal Corresponding Source and Corresponding Application
-Code. If you use option **4d1**, you must provide the Installation
-Information in the manner specified by section 6 of the GNU GPL
-for conveying Corresponding Source.)
-
-### 5. Combined Libraries
-
-You may place library facilities that are a work based on the
-Library side by side in a single library together with other library
-facilities that are not Applications and are not covered by this
-License, and convey such a combined library under terms of your
-choice, if you do both of the following:
-
-* **a)** Accompany the combined library with a copy of the same work based
-on the Library, uncombined with any other library facilities,
-conveyed under the terms of this License.
-* **b)** Give prominent notice with the combined library that part of it
-is a work based on the Library, and explaining where to find the
-accompanying uncombined form of the same work.
-
-### 6. Revised Versions of the GNU Lesser General Public License
-
-The Free Software Foundation may publish revised and/or new versions
-of the GNU Lesser General Public License from time to time. Such new
-versions will be similar in spirit to the present version, but may
-differ in detail to address new problems or concerns.
-
-Each version is given a distinguishing version number. If the
-Library as you received it specifies that a certain numbered version
-of the GNU Lesser General Public License “or any later version”
-applies to it, you have the option of following the terms and
-conditions either of that published version or of any later version
-published by the Free Software Foundation. If the Library as you
-received it does not specify a version number of the GNU Lesser
-General Public License, you may choose any version of the GNU Lesser
-General Public License ever published by the Free Software Foundation.
-
-If the Library as you received it specifies that a proxy can decide
-whether future versions of the GNU Lesser General Public License shall
-apply, that proxy's public statement of acceptance of any version is
-permanent authorization for you to choose that version for the
+GNU Lesser General Public License
+=================================
+
+_Version 3, 29 June 2007_  
+_Copyright © 2007 Free Software Foundation, Inc. &lt;<http://fsf.org/>&gt;_
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+
+This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+### 0. Additional Definitions
+
+As used herein, “this License” refers to version 3 of the GNU Lesser
+General Public License, and the “GNU GPL” refers to version 3 of the GNU
+General Public License.
+
+“The Library” refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+An “Application” is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+A “Combined Work” is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the “Linked
+Version”.
+
+The “Minimal Corresponding Source” for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+The “Corresponding Application Code” for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+### 1. Exception to Section 3 of the GNU GPL
+
+You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+### 2. Conveying Modified Versions
+
+If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+* **a)** under this License, provided that you make a good faith effort to
+ensure that, in the event an Application does not supply the
+function or data, the facility still operates, and performs
+whatever part of its purpose remains meaningful, or
+
+* **b)** under the GNU GPL, with none of the additional permissions of
+this License applicable to that copy.
+
+### 3. Object Code Incorporating Material from Library Header Files
+
+The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+* **a)** Give prominent notice with each copy of the object code that the
+Library is used in it and that the Library and its use are
+covered by this License.
+* **b)** Accompany the object code with a copy of the GNU GPL and this license
+document.
+
+### 4. Combined Works
+
+You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+* **a)** Give prominent notice with each copy of the Combined Work that
+the Library is used in it and that the Library and its use are
+covered by this License.
+
+* **b)** Accompany the Combined Work with a copy of the GNU GPL and this license
+document.
+
+* **c)** For a Combined Work that displays copyright notices during
+execution, include the copyright notice for the Library among
+these notices, as well as a reference directing the user to the
+copies of the GNU GPL and this license document.
+
+* **d)** Do one of the following:
+    - **0)** Convey the Minimal Corresponding Source under the terms of this
+License, and the Corresponding Application Code in a form
+suitable for, and under terms that permit, the user to
+recombine or relink the Application with a modified version of
+the Linked Version to produce a modified Combined Work, in the
+manner specified by section 6 of the GNU GPL for conveying
+Corresponding Source.
+    - **1)** Use a suitable shared library mechanism for linking with the
+Library.  A suitable mechanism is one that **(a)** uses at run time
+a copy of the Library already present on the user's computer
+system, and **(b)** will operate properly with a modified version
+of the Library that is interface-compatible with the Linked
+Version.
+
+* **e)** Provide Installation Information, but only if you would otherwise
+be required to provide such information under section 6 of the
+GNU GPL, and only to the extent that such information is
+necessary to install and execute a modified version of the
+Combined Work produced by recombining or relinking the
+Application with a modified version of the Linked Version. (If
+you use option **4d0**, the Installation Information must accompany
+the Minimal Corresponding Source and Corresponding Application
+Code. If you use option **4d1**, you must provide the Installation
+Information in the manner specified by section 6 of the GNU GPL
+for conveying Corresponding Source.)
+
+### 5. Combined Libraries
+
+You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+* **a)** Accompany the combined library with a copy of the same work based
+on the Library, uncombined with any other library facilities,
+conveyed under the terms of this License.
+* **b)** Give prominent notice with the combined library that part of it
+is a work based on the Library, and explaining where to find the
+accompanying uncombined form of the same work.
+
+### 6. Revised Versions of the GNU Lesser General Public License
+
+The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License “or any later version”
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
 Library.

package/README.md

@@ -1,35 +1,35 @@
-# @easyquery/core (part of EasyQuery.JS)
-
-EasyQuery library provides you with the means to add an ad-hoc reporting or advanced search functionality to your web application.
-
-It gives you a simple to use but a quite powerful user interface to build queries or filters to your data. Your end-users will get the power of SQL with the simplicity of a natural language.
-
-Take a look at [EasyQuery web-page](https://korzh.com/easyquery) for more information.
-
-This `core` package defines the basic functions and structures of EasyQuery library such as `DataModel`, `Query`, `Condition`, `Column` and other classes and interfaces.
-
-## Usage
-
-A general overview of EasyQuery.JS, getting started instructions and tutorials can be found on [EasyQuery.JS documentation](https://korzh.com/easyquery/javascript/docs) web-site.
-
-If you plan to use it with ASP.NET (Core) backend - we suggest you proceed with a "bundle": [EasyQuery for ASP.NET (Core)](https://korzh.com/easyquery) which includes both EasyQuery.JS library and the server-side packages for .NET (Core).
-
-For other platforms, you will also need a special EasyQuery Server which can be installed on any Linux, Windows or Mac server. For more information please read [How EasyQuery works](https://korzh.com/easyquery/javascript#HDIW) section on EasyQuery.JS web page.
-
-## Live examples
-
-You can test EasyQuery in several different scenarios on our [live demos page](https://korzh.com/demo/easyquery-asp-net-core-razor).
-
-The source code for these sample web-applications is available on [GitHub](https://github.com/easyquery/DotNetSamples).
-
-## Documentation
-
-* [Getting started and tutorials](https://korzh.com/easyquery/javascript/docs)
-* [API Reference](https://korzh.com/easyquery/javascript/docs/api-reference-7x)
-
-## License
-
-The package is distributed under LGPL-3.0 license.
-
-The server-side part (which is required to build a working solution) is licensed separately. 
-For more information please see [EasyQuery.NET Licensing](https://korzh.com/easyquery/licensing) page.
+# @easyquery/core (part of EasyQuery.JS)
+
+EasyQuery library provides you with the means to add an ad-hoc reporting or advanced search functionality to your web application.
+
+It gives you a simple to use but a quite powerful user interface to build queries or filters to your data. Your end-users will get the power of SQL with the simplicity of a natural language.
+
+Take a look at [EasyQuery web-page](https://korzh.com/easyquery) for more information.
+
+This `core` package defines the basic functions and structures of EasyQuery library such as `DataModel`, `Query`, `Condition`, `Column` and other classes and interfaces.
+
+## Usage
+
+A general overview of EasyQuery.JS, getting started instructions and tutorials can be found on [EasyQuery.JS documentation](https://korzh.com/easyquery/javascript/docs) web-site.
+
+If you plan to use it with ASP.NET (Core) backend - we suggest you proceed with a "bundle": [EasyQuery for ASP.NET (Core)](https://korzh.com/easyquery) which includes both EasyQuery.JS library and the server-side packages for .NET (Core).
+
+For other platforms, you will also need a special EasyQuery Server which can be installed on any Linux, Windows or Mac server. For more information please read [How EasyQuery works](https://korzh.com/easyquery/javascript#HDIW) section on EasyQuery.JS web page.
+
+## Live examples
+
+You can test EasyQuery in several different scenarios on our [live demos page](https://korzh.com/demo/easyquery-asp-net-core-razor).
+
+The source code for these sample web-applications is available on [GitHub](https://github.com/easyquery/DotNetSamples).
+
+## Documentation
+
+* [Getting started and tutorials](https://korzh.com/easyquery/javascript/docs)
+* [API Reference](https://korzh.com/easyquery/javascript/docs/api-reference-7x)
+
+## License
+
+The package is distributed under LGPL-3.0 license.
+
+The server-side part (which is required to build a working solution) is licensed separately. 
+For more information please see [EasyQuery.NET Licensing](https://korzh.com/easyquery/licensing) page.

package/dist/easyquery.core.cjs.js

@@ -1,10 +1,10 @@
 
 /*
- * EasyQuery.JS Core v7.4.2
+ * EasyQuery.JS Core v7.5.0-rc01
  * Copyright 2026 Korzh.com
  * Licensed under MIT
  *
- * Build time: 4/9/2026 1:45:54 PM
+ * Build time: 02.08.2026 23:51:39
  */
 
 'use strict';
@@ -2944,6 +2944,34 @@ class Query {
     getColumnById(id) {
         return core.utils.findItemById(this.columns, id);
     }
+    /**
+     * Fills an empty column list with the model root entity's own
+     * result-ready attributes (sub-entity attributes are not included).
+     *
+     * This turns the data-filtering scenario ("show the whole entity, filter it")
+     * into an ordinary query with explicit columns, so query-driven features -
+     * server-side sorting, column-width persistence, ORDER BY sync - work through
+     * their normal path instead of relying on server-side auto-columns.
+     *
+     * Columns are added silently (no query change events) - the caller controls
+     * when to fetch. Does nothing when the query already has columns (e.g. one
+     * loaded from storage) or when the model is not loaded yet.
+     *
+     * @returns the added columns (empty when nothing was added).
+     */
+    fillColumnsWithRootAttributes() {
+        if (this.columns.length > 0)
+            return [];
+        if (!this.model || this.model.isEmpty())
+            return [];
+        const added = [];
+        for (const attr of this.model.getRootEntity().attributes) {
+            if (!attr.useInResult)
+                continue;
+            added.push(this.addColumn({ attribute: attr, caption: attr.caption }, true));
+        }
+        return added;
+    }
     /**
      * Adds a new column with specified parameters
      * @param descriptor The descriptor of the new column. Can contain different parameters like:
@@ -3737,6 +3765,63 @@ class BrowserQueryStorage {
     }
 }
 
+/** Default ColumnWidthStore backed by the browser's localStorage. */
+class BrowserColumnWidthStore {
+    constructor(context) {
+        this.context = context;
+        this.keyPrefix = 'eq-colwidths';
+    }
+    init(options) {
+        if (options && options.keyPrefix) {
+            this.keyPrefix = options.keyPrefix;
+        }
+    }
+    storageKey(scopeKey) {
+        return `${this.keyPrefix}-${scopeKey}`;
+    }
+    load(scopeKey) {
+        return new Promise((resolve) => {
+            try {
+                const raw = localStorage.getItem(this.storageKey(scopeKey));
+                resolve(raw ? JSON.parse(raw) : {});
+            }
+            catch (_a) {
+                resolve({}); // best-effort: never break the grid
+            }
+        });
+    }
+    save(scopeKey, columnId, width) {
+        return new Promise((resolve) => {
+            try {
+                const key = this.storageKey(scopeKey);
+                let map = {};
+                const raw = localStorage.getItem(key);
+                if (raw) {
+                    try {
+                        map = JSON.parse(raw);
+                    }
+                    catch (_a) {
+                        map = {};
+                    } // corrupt existing entry -> overwrite it
+                }
+                map[columnId] = width;
+                localStorage.setItem(key, JSON.stringify(map));
+            }
+            catch ( /* ignore: persistence is best-effort (e.g. quota) */_b) { /* ignore: persistence is best-effort (e.g. quota) */ }
+            resolve();
+        });
+    }
+    clear(scopeKey) {
+        return new Promise((resolve) => {
+            try {
+                localStorage.removeItem(this.storageKey(scopeKey));
+            }
+            catch ( /* ignore */_a) { /* ignore */ }
+            resolve();
+        });
+    }
+}
+
 class EqModelLoader {
     constructor(context) {
         this.context = context;
@@ -4047,6 +4132,7 @@ class EqServiceProvider {
         this.queryResolver = (context) => new Query(context.getModel(), null, { context: context });
         this.modelLoaderResolver = (context) => new EqServerModelLoader(context);
         this.queryStorageResolver = (context) => new BrowserQueryStorage(context);
+        this.columnWidthStoreResolver = (context) => new BrowserColumnWidthStore(context);
         this.querySynchronizerResolver = (context) => new EqServerQuerySynchronizer(context);
         this.vllResolver = (context) => new EqServerValueListResolver(context);
         this.dataFetcherResolver = (context) => new EqServerDataFetcher(context);
@@ -4109,6 +4195,15 @@ class EqServiceProvider {
         }
         return this.queryStorageResolver;
     }
+    registerColumnWidthStoreResolver(resolver) {
+        this.columnWidthStoreResolver = resolver;
+    }
+    getColumnWidthStoreResolver() {
+        if (!this.columnWidthStoreResolver) {
+            throw 'ColumnWidthStoreResolver is not defined';
+        }
+        return this.columnWidthStoreResolver;
+    }
     registerDataFetcherResolver(resolver) {
         this.dataFetcherResolver = resolver;
     }
@@ -4319,6 +4414,7 @@ class EqContext {
         this.servicesInitialized = false;
         this.modelLoader = null;
         this.queryStorage = null;
+        this.columnWidthStore = null;
         this.querySynchronizer = null;
         this.dataFetcher = null;
         this.valueListLoader = null;
@@ -4465,6 +4561,14 @@ class EqContext {
         }
         return this.queryStorage;
     }
+    getColumnWidthStore() {
+        if (!this.columnWidthStore) {
+            const columnWidthStoreResolver = this.eqServices.getColumnWidthStoreResolver();
+            this.columnWidthStore = columnWidthStoreResolver(this);
+            this.columnWidthStore.init(this.options.columnWidthStoreOptions);
+        }
+        return this.columnWidthStore;
+    }
     getQuerySynchronizer() {
         if (!this.querySynchronizer) {
             const querySynchronizerResolver = this.eqServices.getQuerySynchronizerResolver();
@@ -4632,6 +4736,9 @@ class EqContext {
             const eqServices = this.getServices();
             eqServices.registerModelStorageResolver(options.modelStorageResolver);
         }
+        if (options.columnWidthStoreResolver) {
+            this.getServices().registerColumnWidthStoreResolver(options.columnWidthStoreResolver);
+        }
         this.loadQueryOnStart = false;
         if (options.loadQueryOnStart) {
             this.loadQueryOnStart = options.loadQueryOnStart;
@@ -6334,6 +6441,7 @@ Object.defineProperty(exports, "i18n", {
     get: function () { return core.i18n; }
 });
 exports.AggrFunction = AggrFunction;
+exports.BrowserColumnWidthStore = BrowserColumnWidthStore;
 exports.BrowserQueryStorage = BrowserQueryStorage;
 exports.Condition = Condition;
 exports.DataModel = DataModel;

package/dist/easyquery.core.esm.js

@@ -1,10 +1,10 @@
 
 /*
- * EasyQuery.JS Core v7.4.2
+ * EasyQuery.JS Core v7.5.0-rc01
  * Copyright 2026 Korzh.com
  * Licensed under MIT
  *
- * Build time: 4/9/2026 1:45:54 PM
+ * Build time: 02.08.2026 23:51:39
  */
 
 import { i18n, DataType, utils, ValueEditor, MetaEntity, MetaEntityAttr, EditorTag, MetaData, EventEmitter, AggregationSettings, HttpClient, EasyDataTable } from '@easydata/core';
@@ -2943,6 +2943,34 @@ class Query {
     getColumnById(id) {
         return utils.findItemById(this.columns, id);
     }
+    /**
+     * Fills an empty column list with the model root entity's own
+     * result-ready attributes (sub-entity attributes are not included).
+     *
+     * This turns the data-filtering scenario ("show the whole entity, filter it")
+     * into an ordinary query with explicit columns, so query-driven features -
+     * server-side sorting, column-width persistence, ORDER BY sync - work through
+     * their normal path instead of relying on server-side auto-columns.
+     *
+     * Columns are added silently (no query change events) - the caller controls
+     * when to fetch. Does nothing when the query already has columns (e.g. one
+     * loaded from storage) or when the model is not loaded yet.
+     *
+     * @returns the added columns (empty when nothing was added).
+     */
+    fillColumnsWithRootAttributes() {
+        if (this.columns.length > 0)
+            return [];
+        if (!this.model || this.model.isEmpty())
+            return [];
+        const added = [];
+        for (const attr of this.model.getRootEntity().attributes) {
+            if (!attr.useInResult)
+                continue;
+            added.push(this.addColumn({ attribute: attr, caption: attr.caption }, true));
+        }
+        return added;
+    }
     /**
      * Adds a new column with specified parameters
      * @param descriptor The descriptor of the new column. Can contain different parameters like:
@@ -3736,6 +3764,63 @@ class BrowserQueryStorage {
     }
 }
 
+/** Default ColumnWidthStore backed by the browser's localStorage. */
+class BrowserColumnWidthStore {
+    constructor(context) {
+        this.context = context;
+        this.keyPrefix = 'eq-colwidths';
+    }
+    init(options) {
+        if (options && options.keyPrefix) {
+            this.keyPrefix = options.keyPrefix;
+        }
+    }
+    storageKey(scopeKey) {
+        return `${this.keyPrefix}-${scopeKey}`;
+    }
+    load(scopeKey) {
+        return new Promise((resolve) => {
+            try {
+                const raw = localStorage.getItem(this.storageKey(scopeKey));
+                resolve(raw ? JSON.parse(raw) : {});
+            }
+            catch (_a) {
+                resolve({}); // best-effort: never break the grid
+            }
+        });
+    }
+    save(scopeKey, columnId, width) {
+        return new Promise((resolve) => {
+            try {
+                const key = this.storageKey(scopeKey);
+                let map = {};
+                const raw = localStorage.getItem(key);
+                if (raw) {
+                    try {
+                        map = JSON.parse(raw);
+                    }
+                    catch (_a) {
+                        map = {};
+                    } // corrupt existing entry -> overwrite it
+                }
+                map[columnId] = width;
+                localStorage.setItem(key, JSON.stringify(map));
+            }
+            catch ( /* ignore: persistence is best-effort (e.g. quota) */_b) { /* ignore: persistence is best-effort (e.g. quota) */ }
+            resolve();
+        });
+    }
+    clear(scopeKey) {
+        return new Promise((resolve) => {
+            try {
+                localStorage.removeItem(this.storageKey(scopeKey));
+            }
+            catch ( /* ignore */_a) { /* ignore */ }
+            resolve();
+        });
+    }
+}
+
 class EqModelLoader {
     constructor(context) {
         this.context = context;
@@ -4046,6 +4131,7 @@ class EqServiceProvider {
         this.queryResolver = (context) => new Query(context.getModel(), null, { context: context });
         this.modelLoaderResolver = (context) => new EqServerModelLoader(context);
         this.queryStorageResolver = (context) => new BrowserQueryStorage(context);
+        this.columnWidthStoreResolver = (context) => new BrowserColumnWidthStore(context);
         this.querySynchronizerResolver = (context) => new EqServerQuerySynchronizer(context);
         this.vllResolver = (context) => new EqServerValueListResolver(context);
         this.dataFetcherResolver = (context) => new EqServerDataFetcher(context);
@@ -4108,6 +4194,15 @@ class EqServiceProvider {
         }
         return this.queryStorageResolver;
     }
+    registerColumnWidthStoreResolver(resolver) {
+        this.columnWidthStoreResolver = resolver;
+    }
+    getColumnWidthStoreResolver() {
+        if (!this.columnWidthStoreResolver) {
+            throw 'ColumnWidthStoreResolver is not defined';
+        }
+        return this.columnWidthStoreResolver;
+    }
     registerDataFetcherResolver(resolver) {
         this.dataFetcherResolver = resolver;
     }
@@ -4318,6 +4413,7 @@ class EqContext {
         this.servicesInitialized = false;
         this.modelLoader = null;
         this.queryStorage = null;
+        this.columnWidthStore = null;
         this.querySynchronizer = null;
         this.dataFetcher = null;
         this.valueListLoader = null;
@@ -4464,6 +4560,14 @@ class EqContext {
         }
         return this.queryStorage;
     }
+    getColumnWidthStore() {
+        if (!this.columnWidthStore) {
+            const columnWidthStoreResolver = this.eqServices.getColumnWidthStoreResolver();
+            this.columnWidthStore = columnWidthStoreResolver(this);
+            this.columnWidthStore.init(this.options.columnWidthStoreOptions);
+        }
+        return this.columnWidthStore;
+    }
     getQuerySynchronizer() {
         if (!this.querySynchronizer) {
             const querySynchronizerResolver = this.eqServices.getQuerySynchronizerResolver();
@@ -4631,6 +4735,9 @@ class EqContext {
             const eqServices = this.getServices();
             eqServices.registerModelStorageResolver(options.modelStorageResolver);
         }
+        if (options.columnWidthStoreResolver) {
+            this.getServices().registerColumnWidthStoreResolver(options.columnWidthStoreResolver);
+        }
         this.loadQueryOnStart = false;
         if (options.loadQueryOnStart) {
             this.loadQueryOnStart = options.loadQueryOnStart;
@@ -6328,4 +6435,4 @@ function addEasyQueryCoreTexts() {
 }
 addEasyQueryCoreTexts();
 
-export { AggrFunction, BrowserQueryStorage, CondTag, Condition, ConditionPart, DataKind, DataModel, DefaultAggregatesCalculator, EasyQueryDataLoader, EmptyChunk, Entity, EntityAttr, EqAction, EqActionResult, EqAggregatesContainer, EqContext, EqEditorTag, EqModelLoader, EqQueryFileLoader, EqServerDataFetcher, EqServerExporter, EqServerModelLoader, EqServerQuerySynchronizer, EqServerValueListResolver, EqServiceProvider, EqValueEditor, ExprTag, Expression, FormatParser, GoogleDataConverter, InMemoryModelStorage, InvalidQueryError, LinkType, Operand, Operator, Query, QueryChangeAction, QueryChangePart, QueryColumn, SortDirection, Tree, Widget, WidgetGroup, createEqContext, eqconsts, equtils, registerEqContextResolver };
+export { AggrFunction, BrowserColumnWidthStore, BrowserQueryStorage, CondTag, Condition, ConditionPart, DataKind, DataModel, DefaultAggregatesCalculator, EasyQueryDataLoader, EmptyChunk, Entity, EntityAttr, EqAction, EqActionResult, EqAggregatesContainer, EqContext, EqEditorTag, EqModelLoader, EqQueryFileLoader, EqServerDataFetcher, EqServerExporter, EqServerModelLoader, EqServerQuerySynchronizer, EqServerValueListResolver, EqServiceProvider, EqValueEditor, ExprTag, Expression, FormatParser, GoogleDataConverter, InMemoryModelStorage, InvalidQueryError, LinkType, Operand, Operator, Query, QueryChangeAction, QueryChangePart, QueryColumn, SortDirection, Tree, Widget, WidgetGroup, createEqContext, eqconsts, equtils, registerEqContextResolver };

package/dist/types/common/eq_services.d.ts

@@ -5,6 +5,7 @@ import { DataModel } from '../dm/data_model';
 import { EqModelLoader } from '../main/model_loader';
 import { DataModelStorage } from '../main/model_storage';
 import { QueryStorage } from '../main/query_storage';
+import { ColumnWidthStore } from '../main/column_width_store';
 import { QuerySynchronizer } from '../main/query_synchronizer';
 import { DataFetcher } from '../main/data_fetcher';
 import { EqValueListLoader } from '../main/value_list_resolver';
@@ -18,6 +19,7 @@ export declare class EqServiceProvider {
     private modelStorageResolver;
     private modelLoaderResolver;
     private queryStorageResolver;
+    private columnWidthStoreResolver;
     private querySynchronizerResolver;
     private dataFetcherResolver;
     private vllResolver;
@@ -38,6 +40,8 @@ export declare class EqServiceProvider {
     getModelStorageResolver(): (context: EqContext) => DataModelStorage;
     registerQueryStorageResolver(resolver: (context: EqContext) => QueryStorage): void;
     getQueryStorageResolver(): (context: EqContext) => QueryStorage;
+    registerColumnWidthStoreResolver(resolver: (context: EqContext) => ColumnWidthStore): void;
+    getColumnWidthStoreResolver(): (context: EqContext) => ColumnWidthStore;
     registerDataFetcherResolver(resolver: (context: EqContext) => DataFetcher): void;
     getDataFetcherResolver(): (context: EqContext) => DataFetcher;
     registerQuerySyncronizerResolver(resolver: (context: EqContext) => QuerySynchronizer): void;

package/dist/types/main/column_width_store.d.ts

@@ -0,0 +1,23 @@
+import { EqContext } from './context';
+export interface ColumnWidthStoreOptions {
+    keyPrefix?: string;
+}
+/** Persists per-grid column widths, keyed by an opaque scope key. */
+export interface ColumnWidthStore {
+    init(options?: ColumnWidthStoreOptions): void;
+    /** Returns { stableColumnId: widthPx } for the scope (empty object if none). */
+    load(scopeKey: string): Promise<Record<string, number>>;
+    save(scopeKey: string, columnId: string, width: number): Promise<void>;
+    clear(scopeKey: string): Promise<void>;
+}
+/** Default ColumnWidthStore backed by the browser's localStorage. */
+export declare class BrowserColumnWidthStore implements ColumnWidthStore {
+    protected context: EqContext;
+    private keyPrefix;
+    constructor(context: EqContext);
+    init(options?: ColumnWidthStoreOptions): void;
+    private storageKey;
+    load(scopeKey: string): Promise<Record<string, number>>;
+    save(scopeKey: string, columnId: string, width: number): Promise<void>;
+    clear(scopeKey: string): Promise<void>;
+}

package/dist/types/main/context.d.ts

@@ -4,6 +4,7 @@ import { EqServiceProvider } from '../common/eq_services';
 import { EqModelLoader } from '../main/model_loader';
 import { DataModelStorage } from '../main/model_storage';
 import { QueryStorage } from '../main/query_storage';
+import { ColumnWidthStore } from '../main/column_width_store';
 import { QuerySynchronizer } from '../main/query_synchronizer';
 import { DataFetcher } from '../main/data_fetcher';
 import { EqValueListLoader } from '../main/value_list_resolver';
@@ -38,6 +39,7 @@ export declare class EqContext {
     private modelStorage;
     private modelLoader;
     private queryStorage;
+    private columnWidthStore;
     private querySynchronizer;
     private dataFetcher;
     private valueListLoader;
@@ -80,6 +82,7 @@ export declare class EqContext {
     getModelLoader(): EqModelLoader;
     getModelStorage(): DataModelStorage;
     getQueryStorage(): QueryStorage;
+    getColumnWidthStore(): ColumnWidthStore;
     getQuerySynchronizer(): QuerySynchronizer;
     getDataFetcher(): DataFetcher;
     getValueListLoader(): EqValueListLoader;

package/dist/types/main/context_options.d.ts

@@ -13,6 +13,7 @@ import { FetchDataOptions } from './data_fetcher';
 import { DataModel } from '../dm/data_model';
 import { Query } from '../query/query';
 import { DataModelStorage } from './model_storage';
+import { ColumnWidthStore, ColumnWidthStoreOptions } from './column_width_store';
 /**
  * Defines interface for all context event handlers
  */
@@ -55,6 +56,8 @@ export interface EqContextOptions {
      */
     endpoint?: string;
     modelStorageResolver?: (context: EqContext) => DataModelStorage;
+    columnWidthStoreResolver?: (context: EqContext) => ColumnWidthStore;
+    columnWidthStoreOptions?: ColumnWidthStoreOptions;
     listCache?: ExternalListCache;
     chunkSize?: number;
     elasticPaging?: boolean;

package/dist/types/public_api.d.ts

@@ -28,6 +28,7 @@ export * from './main/eq_actions';
 export * from './main/model_loader';
 export * from './main/model_storage';
 export * from './main/query_storage';
+export * from './main/column_width_store';
 export * from './main/context';
 export * from './main/context_resolver';
 export * from './main/list_cache';

package/dist/types/query/query.d.ts

@@ -283,6 +283,22 @@ export declare class Query implements AggregationColumnStore {
     adjustColumnsSorting(): void;
     createColumn(justsorted?: boolean): QueryColumn;
     getColumnById(id: string): QueryColumn;
+    /**
+     * Fills an empty column list with the model root entity's own
+     * result-ready attributes (sub-entity attributes are not included).
+     *
+     * This turns the data-filtering scenario ("show the whole entity, filter it")
+     * into an ordinary query with explicit columns, so query-driven features -
+     * server-side sorting, column-width persistence, ORDER BY sync - work through
+     * their normal path instead of relying on server-side auto-columns.
+     *
+     * Columns are added silently (no query change events) - the caller controls
+     * when to fetch. Does nothing when the query already has columns (e.g. one
+     * loaded from storage) or when the model is not loaded yet.
+     *
+     * @returns the added columns (empty when nothing was added).
+     */
+    fillColumnsWithRootAttributes(): QueryColumn[];
     /**
      * Adds a new column with specified parameters
      * @param descriptor The descriptor of the new column. Can contain different parameters like:

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@easyquery/core",
-    "version": "7.4.2",
+    "version": "7.5.0-rc01",
     "description": "EasyQuery.JS Community core modules",
     "types": "./dist/types/public_api.d.ts",
     "main": "./dist/easyquery.core.cjs.js",