@webiny/app-admin 6.4.12-beta.5 → 6.5.0-beta.1

package/presentation/listPresenter/FolderAwareDataSource.d.ts

@@ -0,0 +1,55 @@
+import type { IDataSource, IDataSourceQuery, IDataSourceMeta } from "./abstractions.js";
+import { QueryMatcher } from "./QueryMatcher.js";
+export interface FolderAwareDataSourceConfig<TRow> {
+    locationField?: string;
+    registeredFilterNames?: string[];
+    getDescendantFolders?: {
+        execute(folderId: string): {
+            id: string;
+        }[];
+    };
+    keyField: keyof TRow & string;
+    localFilters?: Record<string, (item: TRow, value: unknown) => boolean>;
+    /**
+     * Reads the value of a sort field from an item, for ordering rows locally.
+     * See `QueryMatcherConfig.getSortValue`.
+     */
+    getSortValue?: (item: TRow, field: string) => unknown;
+}
+export interface FetchParams {
+    where?: Record<string, unknown>;
+    sort?: string[];
+    search?: string;
+    limit?: number;
+    after?: string;
+}
+export interface FetchResult<TRow> {
+    data: TRow[];
+    meta: {
+        cursor: string | null;
+        hasMoreItems: boolean;
+        totalCount: number;
+    };
+}
+export declare abstract class FolderAwareDataSource<TRow> implements IDataSource<TRow> {
+    private _meta;
+    private _loading;
+    private _locationField;
+    private _registeredFilterNames;
+    private _getDescendantFolders;
+    private _keyField;
+    protected queryMatcher: QueryMatcher<TRow>;
+    constructor(config: FolderAwareDataSourceConfig<TRow>);
+    abstract get rows(): TRow[];
+    abstract fetch(params: FetchParams): Promise<FetchResult<TRow>>;
+    protected onQueryResult(_data: TRow[]): void;
+    protected onLoadMoreResult(_data: TRow[]): void;
+    get meta(): IDataSourceMeta;
+    get loading(): boolean;
+    query(params: IDataSourceQuery): Promise<void>;
+    loadMore(params: IDataSourceQuery): Promise<void>;
+    protected customizeWhere(_where: Record<string, unknown>, _filters: Record<string, unknown>): void;
+    protected shouldExpandFolders(_filters: Record<string, unknown>): boolean;
+    private buildWhere;
+    private buildSort;
+}

package/presentation/listPresenter/FolderAwareDataSource.js

@@ -0,0 +1,136 @@
+import { action, computed, makeObservable, observable, runInAction } from "mobx";
+import { QueryMatcher } from "./QueryMatcher.js";
+class FolderAwareDataSource {
+    constructor(config){
+        this._meta = {
+            cursor: null,
+            hasMoreItems: false,
+            totalCount: 0
+        };
+        this._loading = false;
+        this._locationField = config.locationField ?? "location";
+        this._registeredFilterNames = new Set([
+            ...config.registeredFilterNames ?? [],
+            ...Object.keys(config.localFilters ?? {})
+        ]);
+        this._getDescendantFolders = config.getDescendantFolders;
+        this._keyField = config.keyField;
+        const locationField = this._locationField;
+        const localFilters = {
+            folderId: (item, value)=>{
+                const folderId = value;
+                const location = item[locationField];
+                const itemFolderId = location?.folderId;
+                if (folderId && "root" !== folderId) return itemFolderId === folderId;
+                return !itemFolderId || "root" === itemFolderId;
+            },
+            ...config.localFilters
+        };
+        this.queryMatcher = new QueryMatcher({
+            keyField: config.keyField,
+            localFilters,
+            getSortValue: config.getSortValue
+        });
+        makeObservable(this, {
+            _meta: observable,
+            _loading: observable,
+            meta: computed,
+            loading: computed,
+            query: action,
+            loadMore: action
+        });
+    }
+    onQueryResult(_data) {}
+    onLoadMoreResult(_data) {}
+    get meta() {
+        return this._meta;
+    }
+    get loading() {
+        return this._loading;
+    }
+    async query(params) {
+        this._loading = true;
+        try {
+            const result = await this.fetch({
+                where: this.buildWhere(params),
+                sort: this.buildSort(params),
+                search: params.search,
+                limit: params.limit,
+                after: params.cursor
+            });
+            runInAction(()=>{
+                this.onQueryResult(result.data);
+                this.queryMatcher.updateFromQuery(params, result.data.map((item)=>String(item[this._keyField])), result.meta.hasMoreItems);
+                this._meta = {
+                    cursor: result.meta.cursor,
+                    hasMoreItems: result.meta.hasMoreItems,
+                    totalCount: result.meta.totalCount
+                };
+            });
+        } finally{
+            runInAction(()=>{
+                this._loading = false;
+            });
+        }
+    }
+    async loadMore(params) {
+        if (!this._meta.hasMoreItems || this._loading) return;
+        this._loading = true;
+        try {
+            const result = await this.fetch({
+                where: this.buildWhere(params),
+                sort: this.buildSort(params),
+                search: params.search,
+                limit: params.limit,
+                after: this._meta.cursor ?? void 0
+            });
+            runInAction(()=>{
+                this.onLoadMoreResult(result.data);
+                this.queryMatcher.appendResultKeys(result.data.map((item)=>String(item[this._keyField])), result.meta.hasMoreItems);
+                this._meta = {
+                    cursor: result.meta.cursor,
+                    hasMoreItems: result.meta.hasMoreItems,
+                    totalCount: result.meta.totalCount
+                };
+            });
+        } finally{
+            runInAction(()=>{
+                this._loading = false;
+            });
+        }
+    }
+    customizeWhere(_where, _filters) {}
+    shouldExpandFolders(_filters) {
+        return false;
+    }
+    buildWhere(params) {
+        const where = {};
+        const filters = params.filters ?? {};
+        const folderId = filters.folderId || "root";
+        const isRoot = "root" === folderId;
+        const hasAdvancedFilters = Object.keys(filters).some((k)=>"folderId" !== k && !this._registeredFilterNames.has(k));
+        const isSearching = !!params.search || hasAdvancedFilters || this.shouldExpandFolders(filters);
+        if (isSearching && isRoot) ;
+        else if (isSearching && this._getDescendantFolders) {
+            const descendants = this._getDescendantFolders.execute(folderId);
+            const folderIds = descendants.map((f)=>f.id);
+            where[this._locationField] = {
+                folderId_in: folderIds
+            };
+        } else where[this._locationField] = {
+            folderId
+        };
+        for (const [key, value] of Object.entries(filters))if ("folderId" !== key) where[key] = value;
+        this.customizeWhere(where, filters);
+        return Object.keys(where).length > 0 ? where : void 0;
+    }
+    buildSort(params) {
+        if (!params.sort) return;
+        return [
+            `${params.sort.field}_${params.sort.direction}`
+        ];
+    }
+}
+export { FolderAwareDataSource };
+
+//# sourceMappingURL=FolderAwareDataSource.js.map

package/presentation/listPresenter/FolderAwareDataSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation/listPresenter/FolderAwareDataSource.js","sources":["../../../src/presentation/listPresenter/FolderAwareDataSource.ts"],"sourcesContent":["import { makeObservable, observable, computed, runInAction, action } from \"mobx\";\nimport type { IDataSource, IDataSourceQuery, IDataSourceMeta } from \"./abstractions.js\";\nimport { QueryMatcher } from \"./QueryMatcher.js\";\n\nexport interface FolderAwareDataSourceConfig<TRow> {\n    locationField?: string;\n    registeredFilterNames?: string[];\n    getDescendantFolders?: { execute(folderId: string): { id: string }[] };\n    keyField: keyof TRow & string;\n    localFilters?: Record<string, (item: TRow, value: unknown) => boolean>;\n    /**\n     * Reads the value of a sort field from an item, for ordering rows locally.\n     * See `QueryMatcherConfig.getSortValue`.\n     */\n    getSortValue?: (item: TRow, field: string) => unknown;\n}\n\nexport interface FetchParams {\n    where?: Record<string, unknown>;\n    sort?: string[];\n    search?: string;\n    limit?: number;\n    after?: string;\n}\n\nexport interface FetchResult<TRow> {\n    data: TRow[];\n    meta: { cursor: string | null; hasMoreItems: boolean; totalCount: number };\n}\n\nexport abstract class FolderAwareDataSource<TRow> implements IDataSource<TRow> {\n    private _meta: IDataSourceMeta = { cursor: null, hasMoreItems: false, totalCount: 0 };\n    private _loading = false;\n    private _locationField: string;\n    private _registeredFilterNames: Set<string>;\n    private _getDescendantFolders: FolderAwareDataSourceConfig<TRow>[\"getDescendantFolders\"];\n    private _keyField: keyof TRow & string;\n    protected queryMatcher: QueryMatcher<TRow>;\n\n    constructor(config: FolderAwareDataSourceConfig<TRow>) {\n        this._locationField = config.locationField ?? \"location\";\n        this._registeredFilterNames = new Set([\n            ...(config.registeredFilterNames ?? []),\n            ...Object.keys(config.localFilters ?? {})\n        ]);\n        this._getDescendantFolders = config.getDescendantFolders;\n        this._keyField = config.keyField;\n\n        const locationField = this._locationField;\n        const localFilters: Record<string, (item: TRow, value: unknown) => boolean> = {\n            folderId: (item, value) => {\n                const folderId = value as string;\n                const location = (item as Record<string, any>)[locationField];\n                const itemFolderId = location?.folderId as string | undefined;\n                if (folderId && folderId !== \"root\") {\n                    return itemFolderId === folderId;\n                }\n                return !itemFolderId || itemFolderId === \"root\";\n            },\n            ...config.localFilters\n        };\n\n        this.queryMatcher = new QueryMatcher<TRow>({\n            keyField: config.keyField,\n            localFilters,\n            getSortValue: config.getSortValue\n        });\n\n        makeObservable<FolderAwareDataSource<TRow>, \"_meta\" | \"_loading\">(this, {\n            _meta: observable,\n            _loading: observable,\n            meta: computed,\n            loading: computed,\n            query: action,\n            loadMore: action\n        });\n    }\n\n    abstract get rows(): TRow[];\n\n    abstract fetch(params: FetchParams): Promise<FetchResult<TRow>>;\n\n    protected onQueryResult(_data: TRow[]): void {}\n\n    protected onLoadMoreResult(_data: TRow[]): void {}\n\n    get meta(): IDataSourceMeta {\n        return this._meta;\n    }\n\n    get loading(): boolean {\n        return this._loading;\n    }\n\n    async query(params: IDataSourceQuery): Promise<void> {\n        this._loading = true;\n\n        try {\n            const result = await this.fetch({\n                where: this.buildWhere(params),\n                sort: this.buildSort(params),\n                search: params.search,\n                limit: params.limit,\n                after: params.cursor\n            });\n\n            runInAction(() => {\n                this.onQueryResult(result.data);\n                this.queryMatcher.updateFromQuery(\n                    params,\n                    result.data.map(item => String(item[this._keyField])),\n                    result.meta.hasMoreItems\n                );\n                this._meta = {\n                    cursor: result.meta.cursor,\n                    hasMoreItems: result.meta.hasMoreItems,\n                    totalCount: result.meta.totalCount\n                };\n            });\n        } finally {\n            runInAction(() => {\n                this._loading = false;\n            });\n        }\n    }\n\n    async loadMore(params: IDataSourceQuery): Promise<void> {\n        if (!this._meta.hasMoreItems || this._loading) {\n            return;\n        }\n\n        this._loading = true;\n\n        try {\n            const result = await this.fetch({\n                where: this.buildWhere(params),\n                sort: this.buildSort(params),\n                search: params.search,\n                limit: params.limit,\n                after: this._meta.cursor ?? undefined\n            });\n\n            runInAction(() => {\n                this.onLoadMoreResult(result.data);\n                this.queryMatcher.appendResultKeys(\n                    result.data.map(item => String(item[this._keyField])),\n                    result.meta.hasMoreItems\n                );\n                this._meta = {\n                    cursor: result.meta.cursor,\n                    hasMoreItems: result.meta.hasMoreItems,\n                    totalCount: result.meta.totalCount\n                };\n            });\n        } finally {\n            runInAction(() => {\n                this._loading = false;\n            });\n        }\n    }\n\n    protected customizeWhere(\n        _where: Record<string, unknown>,\n        _filters: Record<string, unknown>\n    ): void {}\n\n    protected shouldExpandFolders(_filters: Record<string, unknown>): boolean {\n        return false;\n    }\n\n    private buildWhere(params: IDataSourceQuery): Record<string, unknown> | undefined {\n        const where: Record<string, unknown> = {};\n        const filters = params.filters ?? {};\n        const folderId = (filters.folderId as string | undefined) || \"root\";\n        const isRoot = folderId === \"root\";\n        const hasAdvancedFilters = Object.keys(filters).some(\n            k => k !== \"folderId\" && !this._registeredFilterNames.has(k)\n        );\n        const isSearching =\n            !!params.search || hasAdvancedFilters || this.shouldExpandFolders(filters);\n\n        if (isSearching && isRoot) {\n            // Search/filter from root: no folder filter — search all folders.\n        } else if (isSearching && this._getDescendantFolders) {\n            const descendants = this._getDescendantFolders.execute(folderId);\n            const folderIds = descendants.map(f => f.id);\n            where[this._locationField] = { folderId_in: folderIds };\n        } else {\n            where[this._locationField] = { folderId };\n        }\n\n        for (const [key, value] of Object.entries(filters)) {\n            if (key === \"folderId\") {\n                continue;\n            }\n            where[key] = value;\n        }\n\n        this.customizeWhere(where, filters);\n\n        return Object.keys(where).length > 0 ? where : undefined;\n    }\n\n    private buildSort(params: IDataSourceQuery): string[] | undefined {\n        if (!params.sort) {\n            return undefined;\n        }\n        return [`${params.sort.field}_${params.sort.direction}`];\n    }\n}\n"],"names":["FolderAwareDataSource","config","Set","Object","locationField","localFilters","item","value","folderId","location","itemFolderId","QueryMatcher","makeObservable","observable","computed","action","_data","params","result","runInAction","String","undefined","_where","_filters","where","filters","isRoot","hasAdvancedFilters","k","isSearching","descendants","folderIds","f","key"],"mappings":"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"}

package/presentation/listPresenter/ListPresenter.d.ts

@@ -2,6 +2,7 @@ import { type IListPresenter, type IListPresenterConfig, type IListViewModel, ty
 declare class ListPresenterImpl<TRow> implements IListPresenter<TRow> {
     private _sort;
     private _filters;
+    private _initialFilterKeys;
     private _search;
     private _selection;
     private _error;
@@ -13,6 +14,8 @@ declare class ListPresenterImpl<TRow> implements IListPresenter<TRow> {
     private _limit;
     private _initialized;
     private _loadingMore;
+    private _showingFilters;
+    private _itemLabel;
     constructor();
     get vm(): IListViewModel<TRow>;
     actions: IListActions;
@@ -23,6 +26,7 @@ declare class ListPresenterImpl<TRow> implements IListPresenter<TRow> {
     private debouncedRequery;
     private clearDebounce;
     private getRowId;
+    private buildSelectionLabel;
     private toListError;
 }
 export declare const ListPresenter: typeof ListPresenterImpl & {

package/presentation/listPresenter/ListPresenter.js

@@ -5,6 +5,7 @@ class ListPresenterImpl {
     constructor(){
         this._sort = null;
         this._filters = {};
+        this._initialFilterKeys = new Set();
         this._search = "";
         this._error = null;
         this._appliedQuery = null;
@@ -15,6 +16,11 @@ class ListPresenterImpl {
         this._limit = void 0;
         this._initialized = false;
         this._loadingMore = false;
+        this._showingFilters = false;
+        this._itemLabel = {
+            singular: "item",
+            plural: "items"
+        };
         this.actions = {
             search: {
                 set: (query)=>{
@@ -64,6 +70,12 @@ class ListPresenterImpl {
                 clearAll: ()=>{
                     this._filters = {};
                     this.requery();
+                },
+                show: ()=>{
+                    this._showingFilters = true;
+                },
+                hide: ()=>{
+                    this._showingFilters = false;
                 }
             },
             selection: {
@@ -113,7 +125,7 @@ class ListPresenterImpl {
             totalCount: 0
         };
         const loading = ds ? ds.loading : false;
-        const hasFilters = Object.keys(this._filters).length > 0 || this._search.length > 0;
+        const hasUserFilters = Object.keys(this._filters).some((k)=>!this._initialFilterKeys.has(k)) || this._search.length > 0;
         return {
             rows,
             sort: this._sort,
@@ -130,10 +142,12 @@ class ListPresenterImpl {
             selection: {
                 selectedIds: this._selection.selectedIds,
                 selectedCount: this._selection.selectedCount,
-                allSelected: this._selection.allSelected
+                allSelected: this._selection.allSelected,
+                label: this.buildSelectionLabel()
             },
+            showingFilters: this._showingFilters,
             empty: 0 === rows.length && !loading,
-            emptyWithFilters: 0 === rows.length && !loading && hasFilters,
+            emptyWithFilters: 0 === rows.length && !loading && hasUserFilters,
             error: this._error
         };
     }
@@ -141,9 +155,14 @@ class ListPresenterImpl {
         this._dataSource = config.dataSource;
         this._sort = config.initialSort ?? null;
         this._filters = config.initialFilters ?? {};
+        this._initialFilterKeys = new Set(Object.keys(this._filters));
         this._debounceMs = config.debounceMs ?? 300;
         this._limit = config.limit;
-        this._search = "";
+        this._itemLabel = config.itemLabel ?? {
+            singular: "item",
+            plural: "items"
+        };
+        this._search = config.initialSearch ?? "";
         this._appliedQuery = null;
         this._selection.reset();
         this._initialized = true;
@@ -200,6 +219,13 @@ class ListPresenterImpl {
     getRowId(row) {
         return row.id;
     }
+    buildSelectionLabel() {
+        const { selectedCount, allSelected } = this._selection;
+        if (allSelected) return `all ${this._itemLabel.plural}`;
+        if (0 === selectedCount) return "";
+        const noun = 1 === selectedCount ? this._itemLabel.singular : this._itemLabel.plural;
+        return `${selectedCount} ${noun}`;
+    }
     toListError(err) {
         if (err instanceof Error) return {
             code: "UNKNOWN",

package/presentation/listPresenter/ListPresenter.js.map

@@ -1 +1 @@
-{"version":3,"file":"presentation/listPresenter/ListPresenter.js","sources":["../../../src/presentation/listPresenter/ListPresenter.ts"],"sourcesContent":["import { makeAutoObservable, runInAction, computed } from \"mobx\";\nimport {\n    ListPresenter as Abstraction,\n    type IListPresenter,\n    type IListPresenterConfig,\n    type IListViewModel,\n    type IListActions,\n    type IListError,\n    type IDataSource,\n    type IDataSourceQuery\n} from \"./abstractions.js\";\nimport { SelectionController } from \"./SelectionController.js\";\n\nclass ListPresenterImpl<TRow> implements IListPresenter<TRow> {\n    private _sort: { field: string; direction: \"ASC\" | \"DESC\" } | null = null;\n    private _filters: Record<string, unknown> = {};\n    private _search = \"\";\n    private _selection: SelectionController<TRow>;\n    private _error: IListError | null = null;\n    private _appliedQuery: IDataSourceQuery | null = null;\n    private _dataSource: IDataSource<TRow> | null = null;\n    private _debounceMs = 300;\n    private _debounceTimer: ReturnType<typeof setTimeout> | null = null;\n    private _requeryScheduled = false;\n    private _limit: number | undefined = undefined;\n    private _initialized = false;\n    private _loadingMore = false;\n\n    constructor() {\n        this._selection = new SelectionController<TRow>(\n            () => this._dataSource?.rows ?? [],\n            row => this.getRowId(row)\n        );\n\n        makeAutoObservable<ListPresenterImpl<TRow>, \"_debounceTimer\">(this, {\n            _debounceTimer: false,\n            vm: computed\n        });\n    }\n\n    get vm(): IListViewModel<TRow> {\n        const ds = this._dataSource;\n        const rows = ds ? ds.rows : [];\n        const meta = ds ? ds.meta : { cursor: null, hasMoreItems: false, totalCount: 0 };\n        const loading = ds ? ds.loading : false;\n        const hasFilters = Object.keys(this._filters).length > 0 || this._search.length > 0;\n\n        return {\n            rows,\n            sort: this._sort,\n            filters: this._filters,\n            search: this._search,\n            appliedQuery: this._appliedQuery,\n            pagination: {\n                hasMore: meta.hasMoreItems,\n                loading: loading && !this._loadingMore,\n                loadingMore: this._loadingMore,\n                totalCount: meta.totalCount,\n                currentCount: rows.length\n            },\n            selection: {\n                selectedIds: this._selection.selectedIds,\n                selectedCount: this._selection.selectedCount,\n                allSelected: this._selection.allSelected\n            },\n            empty: rows.length === 0 && !loading,\n            emptyWithFilters: rows.length === 0 && !loading && hasFilters,\n            error: this._error\n        };\n    }\n\n    actions: IListActions = {\n        search: {\n            set: (query: string) => {\n                if (this._search === query) {\n                    return;\n                }\n                this._search = query;\n                this.debouncedRequery();\n            },\n            clear: () => {\n                if (this._search === \"\") {\n                    return;\n                }\n                this._search = \"\";\n                this.requery();\n            }\n        },\n        sort: {\n            set: (field: string, direction: \"ASC\" | \"DESC\") => {\n                this._sort = { field, direction };\n                this.requery();\n            },\n            toggle: (field: string) => {\n                if (this._sort && this._sort.field === field) {\n                    this._sort = {\n                        field,\n                        direction: this._sort.direction === \"ASC\" ? \"DESC\" : \"ASC\"\n                    };\n                } else {\n                    this._sort = { field, direction: \"ASC\" };\n                }\n                this.requery();\n            }\n        },\n        filter: {\n            set: (key: string, value: unknown) => {\n                this._filters = { ...this._filters, [key]: value };\n                this.requery();\n            },\n            clear: (key: string) => {\n                const { [key]: _, ...rest } = this._filters;\n                this._filters = rest;\n                this.requery();\n            },\n            clearAll: () => {\n                this._filters = {};\n                this.requery();\n            }\n        },\n        selection: {\n            toggle: (id: string) => this._selection.toggle(id),\n            selectRangeTo: (id: string) => this._selection.selectRangeTo(id),\n            selectAll: () => this._selection.selectAll(),\n            deselectAll: () => this._selection.deselectAll(),\n            selectRows: (ids: string[]) => this._selection.selectRows(ids),\n            isSelected: (id: string) => this._selection.isSelected(id)\n        },\n        loadMore: async () => {\n            if (!this._dataSource) {\n                return;\n            }\n            const meta = this._dataSource.meta;\n            if (!meta.hasMoreItems || this._dataSource.loading) {\n                return;\n            }\n            this._loadingMore = true;\n            try {\n                await this._dataSource.loadMore(this.buildQuery(meta.cursor));\n                runInAction(() => {\n                    this._error = null;\n                });\n            } catch (err) {\n                runInAction(() => {\n                    this._error = this.toListError(err);\n                });\n            } finally {\n                runInAction(() => {\n                    this._loadingMore = false;\n                });\n            }\n        },\n        refresh: async () => {\n            await this.executeQuery();\n        }\n    };\n\n    init(config: IListPresenterConfig<TRow>): void {\n        this._dataSource = config.dataSource;\n        this._sort = config.initialSort ?? null;\n        this._filters = config.initialFilters ?? {};\n        this._debounceMs = config.debounceMs ?? 300;\n        this._limit = config.limit;\n        this._search = \"\";\n        this._appliedQuery = null;\n        this._selection.reset();\n        this._initialized = true;\n        this.executeQuery();\n    }\n\n    private buildQuery(cursor?: string | null): IDataSourceQuery {\n        return {\n            search: this._search || undefined,\n            filters: Object.keys(this._filters).length > 0 ? this._filters : undefined,\n            sort: this._sort ?? undefined,\n            cursor: cursor ?? undefined,\n            limit: this._limit\n        };\n    }\n\n    private async executeQuery(): Promise<void> {\n        if (!this._dataSource) {\n            return;\n        }\n        this._error = null;\n        const query = this.buildQuery();\n        try {\n            await this._dataSource.query(query);\n            runInAction(() => {\n                this._appliedQuery = query;\n            });\n        } catch (err) {\n            runInAction(() => {\n                this._error = this.toListError(err);\n            });\n        }\n    }\n\n    private requery(): void {\n        this.clearDebounce();\n        this._selection.reset();\n\n        if (!this._requeryScheduled) {\n            this._requeryScheduled = true;\n            queueMicrotask(() => {\n                this._requeryScheduled = false;\n                this.executeQuery();\n            });\n        }\n    }\n\n    private debouncedRequery(): void {\n        this.clearDebounce();\n        this._debounceTimer = setTimeout(() => {\n            this._selection.reset();\n            this.executeQuery();\n        }, this._debounceMs);\n    }\n\n    private clearDebounce(): void {\n        if (this._debounceTimer) {\n            clearTimeout(this._debounceTimer);\n            this._debounceTimer = null;\n        }\n    }\n\n    private getRowId(row: TRow): string {\n        return (row as any).id;\n    }\n\n    private toListError(err: unknown): IListError {\n        if (err instanceof Error) {\n            return { code: \"UNKNOWN\", message: err.message, retryable: true };\n        }\n        return { code: \"UNKNOWN\", message: String(err), retryable: true };\n    }\n}\n\nexport const ListPresenter = Abstraction.createImplementation({\n    implementation: ListPresenterImpl,\n    dependencies: []\n});\n"],"names":["ListPresenterImpl","undefined","query","field","direction","key","value","_","rest","id","ids","meta","runInAction","err","SelectionController","row","makeAutoObservable","computed","ds","rows","loading","hasFilters","Object","config","cursor","queueMicrotask","setTimeout","clearTimeout","Error","String","ListPresenter","Abstraction"],"mappings":"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"}
+{"version":3,"file":"presentation/listPresenter/ListPresenter.js","sources":["../../../src/presentation/listPresenter/ListPresenter.ts"],"sourcesContent":["import { makeAutoObservable, runInAction, computed } from \"mobx\";\nimport {\n    ListPresenter as Abstraction,\n    type IListPresenter,\n    type IListPresenterConfig,\n    type IListViewModel,\n    type IListActions,\n    type IListError,\n    type IDataSource,\n    type IDataSourceQuery\n} from \"./abstractions.js\";\nimport { SelectionController } from \"./SelectionController.js\";\n\nclass ListPresenterImpl<TRow> implements IListPresenter<TRow> {\n    private _sort: { field: string; direction: \"ASC\" | \"DESC\" } | null = null;\n    private _filters: Record<string, unknown> = {};\n    private _initialFilterKeys: Set<string> = new Set();\n    private _search = \"\";\n    private _selection: SelectionController<TRow>;\n    private _error: IListError | null = null;\n    private _appliedQuery: IDataSourceQuery | null = null;\n    private _dataSource: IDataSource<TRow> | null = null;\n    private _debounceMs = 300;\n    private _debounceTimer: ReturnType<typeof setTimeout> | null = null;\n    private _requeryScheduled = false;\n    private _limit: number | undefined = undefined;\n    private _initialized = false;\n    private _loadingMore = false;\n    private _showingFilters = false;\n    private _itemLabel: { singular: string; plural: string } = {\n        singular: \"item\",\n        plural: \"items\"\n    };\n\n    constructor() {\n        this._selection = new SelectionController<TRow>(\n            () => this._dataSource?.rows ?? [],\n            row => this.getRowId(row)\n        );\n\n        makeAutoObservable<ListPresenterImpl<TRow>, \"_debounceTimer\">(this, {\n            _debounceTimer: false,\n            vm: computed\n        });\n    }\n\n    get vm(): IListViewModel<TRow> {\n        const ds = this._dataSource;\n        const rows = ds ? ds.rows : [];\n        const meta = ds ? ds.meta : { cursor: null, hasMoreItems: false, totalCount: 0 };\n        const loading = ds ? ds.loading : false;\n        const hasUserFilters =\n            Object.keys(this._filters).some(k => !this._initialFilterKeys.has(k)) ||\n            this._search.length > 0;\n\n        return {\n            rows,\n            sort: this._sort,\n            filters: this._filters,\n            search: this._search,\n            appliedQuery: this._appliedQuery,\n            pagination: {\n                hasMore: meta.hasMoreItems,\n                loading: loading && !this._loadingMore,\n                loadingMore: this._loadingMore,\n                totalCount: meta.totalCount,\n                currentCount: rows.length\n            },\n            selection: {\n                selectedIds: this._selection.selectedIds,\n                selectedCount: this._selection.selectedCount,\n                allSelected: this._selection.allSelected,\n                label: this.buildSelectionLabel()\n            },\n            showingFilters: this._showingFilters,\n            empty: rows.length === 0 && !loading,\n            emptyWithFilters: rows.length === 0 && !loading && hasUserFilters,\n            error: this._error\n        };\n    }\n\n    actions: IListActions = {\n        search: {\n            set: (query: string) => {\n                if (this._search === query) {\n                    return;\n                }\n                this._search = query;\n                this.debouncedRequery();\n            },\n            clear: () => {\n                if (this._search === \"\") {\n                    return;\n                }\n                this._search = \"\";\n                this.requery();\n            }\n        },\n        sort: {\n            set: (field: string, direction: \"ASC\" | \"DESC\") => {\n                this._sort = { field, direction };\n                this.requery();\n            },\n            toggle: (field: string) => {\n                if (this._sort && this._sort.field === field) {\n                    this._sort = {\n                        field,\n                        direction: this._sort.direction === \"ASC\" ? \"DESC\" : \"ASC\"\n                    };\n                } else {\n                    this._sort = { field, direction: \"ASC\" };\n                }\n                this.requery();\n            }\n        },\n        filter: {\n            set: (key: string, value: unknown) => {\n                this._filters = { ...this._filters, [key]: value };\n                this.requery();\n            },\n            clear: (key: string) => {\n                const { [key]: _, ...rest } = this._filters;\n                this._filters = rest;\n                this.requery();\n            },\n            clearAll: () => {\n                this._filters = {};\n                this.requery();\n            },\n            show: () => {\n                this._showingFilters = true;\n            },\n            hide: () => {\n                this._showingFilters = false;\n            }\n        },\n        selection: {\n            toggle: (id: string) => this._selection.toggle(id),\n            selectRangeTo: (id: string) => this._selection.selectRangeTo(id),\n            selectAll: () => this._selection.selectAll(),\n            deselectAll: () => this._selection.deselectAll(),\n            selectRows: (ids: string[]) => this._selection.selectRows(ids),\n            isSelected: (id: string) => this._selection.isSelected(id)\n        },\n        loadMore: async () => {\n            if (!this._dataSource) {\n                return;\n            }\n            const meta = this._dataSource.meta;\n            if (!meta.hasMoreItems || this._dataSource.loading) {\n                return;\n            }\n            this._loadingMore = true;\n            try {\n                await this._dataSource.loadMore(this.buildQuery(meta.cursor));\n                runInAction(() => {\n                    this._error = null;\n                });\n            } catch (err) {\n                runInAction(() => {\n                    this._error = this.toListError(err);\n                });\n            } finally {\n                runInAction(() => {\n                    this._loadingMore = false;\n                });\n            }\n        },\n        refresh: async () => {\n            await this.executeQuery();\n        }\n    };\n\n    init(config: IListPresenterConfig<TRow>): void {\n        this._dataSource = config.dataSource;\n        this._sort = config.initialSort ?? null;\n        this._filters = config.initialFilters ?? {};\n        this._initialFilterKeys = new Set(Object.keys(this._filters));\n        this._debounceMs = config.debounceMs ?? 300;\n        this._limit = config.limit;\n        this._itemLabel = config.itemLabel ?? { singular: \"item\", plural: \"items\" };\n        this._search = config.initialSearch ?? \"\";\n        this._appliedQuery = null;\n        this._selection.reset();\n        this._initialized = true;\n        this.executeQuery();\n    }\n\n    private buildQuery(cursor?: string | null): IDataSourceQuery {\n        return {\n            search: this._search || undefined,\n            filters: Object.keys(this._filters).length > 0 ? this._filters : undefined,\n            sort: this._sort ?? undefined,\n            cursor: cursor ?? undefined,\n            limit: this._limit\n        };\n    }\n\n    private async executeQuery(): Promise<void> {\n        if (!this._dataSource) {\n            return;\n        }\n        this._error = null;\n        const query = this.buildQuery();\n        try {\n            await this._dataSource.query(query);\n            runInAction(() => {\n                this._appliedQuery = query;\n            });\n        } catch (err) {\n            runInAction(() => {\n                this._error = this.toListError(err);\n            });\n        }\n    }\n\n    private requery(): void {\n        this.clearDebounce();\n        this._selection.reset();\n\n        if (!this._requeryScheduled) {\n            this._requeryScheduled = true;\n            queueMicrotask(() => {\n                this._requeryScheduled = false;\n                this.executeQuery();\n            });\n        }\n    }\n\n    private debouncedRequery(): void {\n        this.clearDebounce();\n        this._debounceTimer = setTimeout(() => {\n            this._selection.reset();\n            this.executeQuery();\n        }, this._debounceMs);\n    }\n\n    private clearDebounce(): void {\n        if (this._debounceTimer) {\n            clearTimeout(this._debounceTimer);\n            this._debounceTimer = null;\n        }\n    }\n\n    private getRowId(row: TRow): string {\n        return (row as any).id;\n    }\n\n    private buildSelectionLabel(): string {\n        const { selectedCount, allSelected } = this._selection;\n        if (allSelected) {\n            return `all ${this._itemLabel.plural}`;\n        }\n        if (selectedCount === 0) {\n            return \"\";\n        }\n        const noun = selectedCount === 1 ? this._itemLabel.singular : this._itemLabel.plural;\n        return `${selectedCount} ${noun}`;\n    }\n\n    private toListError(err: unknown): IListError {\n        if (err instanceof Error) {\n            return { code: \"UNKNOWN\", message: err.message, retryable: true };\n        }\n        return { code: \"UNKNOWN\", message: String(err), retryable: true };\n    }\n}\n\nexport const ListPresenter = Abstraction.createImplementation({\n    implementation: ListPresenterImpl,\n    dependencies: []\n});\n"],"names":["ListPresenterImpl","Set","undefined","query","field","direction","key","value","_","rest","id","ids","meta","runInAction","err","SelectionController","row","makeAutoObservable","computed","ds","rows","loading","hasUserFilters","Object","k","config","cursor","queueMicrotask","setTimeout","clearTimeout","selectedCount","allSelected","noun","Error","String","ListPresenter","Abstraction"],"mappings":"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"}

package/presentation/listPresenter/QueryMatcher.d.ts

@@ -0,0 +1,79 @@
+import type { IDataSourceQuery } from "./abstractions.js";
+type ItemPredicate<TRow> = (item: TRow, value: unknown) => boolean;
+type SortValueGetter<TRow> = (item: TRow, field: string) => unknown;
+export interface QueryMatcherConfig<TRow> {
+    keyField: keyof TRow & string;
+    localFilters: Record<string, ItemPredicate<TRow>>;
+    /**
+     * Reads the value of a sort field from an item. Defaults to a dot-path lookup
+     * (e.g. `savedOn`, `values.title`). Override when the query's sort field name
+     * does not match the item's shape.
+     */
+    getSortValue?: SortValueGetter<TRow>;
+}
+/**
+ * Decides which cached items belong in the current view.
+ *
+ * A DataSource backed by a shared cache (e.g., per-model entry cache) needs to
+ * filter cached items to only those matching the active query. QueryMatcher does
+ * this by splitting filters into two categories:
+ *
+ * - **Local filters** (e.g., folderId, status) — evaluated client-side against
+ *   each item using predicates provided via `localFilters` config. Used when
+ *   browsing without search or server-side filters.
+ *
+ * - **Server-side filters** (search, advanced search, any filter key not in
+ *   `localFilters`) — cannot be evaluated locally. Instead, QueryMatcher tracks
+ *   the set of item keys returned by the last server query (`_queryResultKeys`)
+ *   and restricts the view to those items.
+ *
+ * The `matcher` getter is MobX-computed, so any DataSource `rows` getter that
+ * reads it will recompute when the matcher changes after a query.
+ *
+ * Usage:
+ * ```ts
+ * const matcher = new QueryMatcher<MyItem>({
+ *     keyField: "id",
+ *     localFilters: {
+ *         folderId: (item, value) => item.folderId === value,
+ *         status: (item, value) => item.status === value,
+ *     }
+ * });
+ *
+ * // In DataSource.query(), after fetching:
+ * matcher.updateFromQuery(params, result.data.map(item => item.id), result.meta.hasMoreItems);
+ *
+ * // In DataSource.rows getter (filters, sorts by the applied sort, and cuts off at the
+ * // last loaded item):
+ * return matcher.select(cache.getItems());
+ * ```
+ */
+export declare class QueryMatcher<TRow> {
+    private config;
+    private _queryResultKeys;
+    private _matcher;
+    private localFilterKeys;
+    private getSortValue;
+    private _view;
+    constructor(config: QueryMatcherConfig<TRow>);
+    get matcher(): (item: TRow) => boolean;
+    filter(items: TRow[]): TRow[];
+    /**
+     * Returns the items that belong in the current view, in the view's order.
+     *
+     * The cache is shared by views with different sorts, so its order means nothing to
+     * this view. Instead, matching items are sorted by the applied sort (ties keep the
+     * server order), and the result is cut off after the last item the server returned
+     * for this view. That keeps locally created or updated items in their sort position,
+     * and hides cached items that sort past the loaded pages until pagination reaches them.
+     *
+     * While searching, the server's (relevance) order is kept as is.
+     */
+    select(items: TRow[]): TRow[];
+    private getKey;
+    hasServerSideFilters(params: IDataSourceQuery): boolean;
+    updateFromQuery(params: IDataSourceQuery, resultKeys: string[], hasMore?: boolean): void;
+    appendResultKeys(keys: string[], hasMore?: boolean): void;
+    private buildMatcher;
+}
+export {};

package/presentation/listPresenter/QueryMatcher.js

@@ -0,0 +1,129 @@
+import { action, computed, makeObservable, observable } from "mobx";
+class QueryMatcher {
+    constructor(config){
+        this.config = config;
+        this._queryResultKeys = null;
+        this._matcher = ()=>true;
+        this._view = null;
+        this.localFilterKeys = new Set(Object.keys(config.localFilters));
+        this.getSortValue = config.getSortValue ?? getValueByPath;
+        makeObservable(this, {
+            _matcher: observable.ref,
+            _view: observable.ref,
+            matcher: computed,
+            updateFromQuery: action,
+            appendResultKeys: action
+        });
+    }
+    get matcher() {
+        return this._matcher;
+    }
+    filter(items) {
+        return items.filter(this._matcher);
+    }
+    select(items) {
+        const matched = this.filter(items);
+        const view = this._view;
+        if (!view) return matched;
+        const serverIndex = new Map(view.resultKeys.map((key, index)=>[
+                key,
+                index
+            ]));
+        const indexOf = (item)=>serverIndex.get(this.getKey(item)) ?? 1 / 0;
+        const sort = view.searching ? void 0 : view.sort;
+        const sorted = [
+            ...matched
+        ].sort((a, b)=>{
+            if (sort) {
+                const result = compareValues(this.getSortValue(a, sort.field), this.getSortValue(b, sort.field));
+                if (0 !== result) return "ASC" === sort.direction ? result : -result;
+            }
+            const left = indexOf(a);
+            const right = indexOf(b);
+            return left === right ? 0 : left < right ? -1 : 1;
+        });
+        if (!view.hasMore) return sorted;
+        let lastLoaded = -1;
+        sorted.forEach((item, index)=>{
+            if (serverIndex.has(this.getKey(item))) lastLoaded = index;
+        });
+        return lastLoaded < 0 ? sorted : sorted.slice(0, lastLoaded + 1);
+    }
+    getKey(item) {
+        return String(item[this.config.keyField]);
+    }
+    hasServerSideFilters(params) {
+        if (params.search) return true;
+        const filters = params.filters ?? {};
+        return Object.keys(filters).some((key)=>!this.localFilterKeys.has(key));
+    }
+    updateFromQuery(params, resultKeys, hasMore = false) {
+        if (this.hasServerSideFilters(params)) this._queryResultKeys = new Set(resultKeys);
+        else this._queryResultKeys = null;
+        this._matcher = this.buildMatcher(params);
+        this._view = {
+            resultKeys: [
+                ...resultKeys
+            ],
+            sort: params.sort,
+            searching: !!params.search,
+            hasMore
+        };
+    }
+    appendResultKeys(keys, hasMore = false) {
+        if (this._queryResultKeys) for (const key of keys)this._queryResultKeys.add(key);
+        if (this._view) this._view = {
+            ...this._view,
+            resultKeys: [
+                ...this._view.resultKeys,
+                ...keys
+            ],
+            hasMore
+        };
+    }
+    buildMatcher(params) {
+        const filters = params.filters ?? {};
+        const queryResultKeys = this._queryResultKeys;
+        const isSearching = !!params.search;
+        const { keyField, localFilters } = this.config;
+        const activeLocalFilters = [];
+        for (const [key, predicate] of Object.entries(localFilters)){
+            const value = filters[key];
+            if (null != value) activeLocalFilters.push({
+                predicate,
+                value
+            });
+        }
+        return (item)=>{
+            if (queryResultKeys) {
+                if (!queryResultKeys.has(String(item[keyField]))) return false;
+            } else if (!isSearching) {
+                for (const { predicate, value } of activeLocalFilters)if (!predicate(item, value)) return false;
+            }
+            return true;
+        };
+    }
+}
+function getValueByPath(item, path) {
+    let current = item;
+    for (const part of path.split(".")){
+        if (null == current || "object" != typeof current) return;
+        current = current[part];
+    }
+    return current;
+}
+function compareValues(a, b) {
+    const aEmpty = null == a;
+    const bEmpty = null == b;
+    if (aEmpty || bEmpty) return aEmpty === bEmpty ? 0 : aEmpty ? 1 : -1;
+    const left = a instanceof Date ? a.getTime() : a;
+    const right = b instanceof Date ? b.getTime() : b;
+    if ("number" == typeof left && "number" == typeof right) return left - right;
+    if ("boolean" == typeof left && "boolean" == typeof right) return Number(left) - Number(right);
+    const leftString = String(left);
+    const rightString = String(right);
+    return leftString < rightString ? -1 : leftString > rightString ? 1 : 0;
+}
+export { QueryMatcher };
+
+//# sourceMappingURL=QueryMatcher.js.map

package/presentation/listPresenter/QueryMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation/listPresenter/QueryMatcher.js","sources":["../../../src/presentation/listPresenter/QueryMatcher.ts"],"sourcesContent":["import { makeObservable, observable, computed, action } from \"mobx\";\nimport type { IDataSourceQuery } from \"./abstractions.js\";\n\ntype ItemPredicate<TRow> = (item: TRow, value: unknown) => boolean;\n\ntype SortValueGetter<TRow> = (item: TRow, field: string) => unknown;\n\nexport interface QueryMatcherConfig<TRow> {\n    keyField: keyof TRow & string;\n    localFilters: Record<string, ItemPredicate<TRow>>;\n    /**\n     * Reads the value of a sort field from an item. Defaults to a dot-path lookup\n     * (e.g. `savedOn`, `values.title`). Override when the query's sort field name\n     * does not match the item's shape.\n     */\n    getSortValue?: SortValueGetter<TRow>;\n}\n\n/**\n * Decides which cached items belong in the current view.\n *\n * A DataSource backed by a shared cache (e.g., per-model entry cache) needs to\n * filter cached items to only those matching the active query. QueryMatcher does\n * this by splitting filters into two categories:\n *\n * - **Local filters** (e.g., folderId, status) — evaluated client-side against\n *   each item using predicates provided via `localFilters` config. Used when\n *   browsing without search or server-side filters.\n *\n * - **Server-side filters** (search, advanced search, any filter key not in\n *   `localFilters`) — cannot be evaluated locally. Instead, QueryMatcher tracks\n *   the set of item keys returned by the last server query (`_queryResultKeys`)\n *   and restricts the view to those items.\n *\n * The `matcher` getter is MobX-computed, so any DataSource `rows` getter that\n * reads it will recompute when the matcher changes after a query.\n *\n * Usage:\n * ```ts\n * const matcher = new QueryMatcher<MyItem>({\n *     keyField: \"id\",\n *     localFilters: {\n *         folderId: (item, value) => item.folderId === value,\n *         status: (item, value) => item.status === value,\n *     }\n * });\n *\n * // In DataSource.query(), after fetching:\n * matcher.updateFromQuery(params, result.data.map(item => item.id), result.meta.hasMoreItems);\n *\n * // In DataSource.rows getter (filters, sorts by the applied sort, and cuts off at the\n * // last loaded item):\n * return matcher.select(cache.getItems());\n * ```\n */\nexport class QueryMatcher<TRow> {\n    private _queryResultKeys: Set<string> | null = null;\n    private _matcher: (item: TRow) => boolean = () => true;\n    private localFilterKeys: Set<string>;\n    private getSortValue: SortValueGetter<TRow>;\n\n    // Ordering state of the current view: the keys the server returned for the active\n    // query (in server order, extended by `appendResultKeys`), the applied sort, and\n    // whether the server has more items beyond the loaded ones.\n    private _view: {\n        resultKeys: string[];\n        sort: IDataSourceQuery[\"sort\"];\n        searching: boolean;\n        hasMore: boolean;\n    } | null = null;\n\n    constructor(private config: QueryMatcherConfig<TRow>) {\n        this.localFilterKeys = new Set(Object.keys(config.localFilters));\n        this.getSortValue = config.getSortValue ?? getValueByPath;\n\n        makeObservable<QueryMatcher<TRow>, \"_matcher\" | \"_view\">(this, {\n            _matcher: observable.ref,\n            _view: observable.ref,\n            matcher: computed,\n            updateFromQuery: action,\n            appendResultKeys: action\n        });\n    }\n\n    get matcher(): (item: TRow) => boolean {\n        return this._matcher;\n    }\n\n    filter(items: TRow[]): TRow[] {\n        return items.filter(this._matcher);\n    }\n\n    /**\n     * Returns the items that belong in the current view, in the view's order.\n     *\n     * The cache is shared by views with different sorts, so its order means nothing to\n     * this view. Instead, matching items are sorted by the applied sort (ties keep the\n     * server order), and the result is cut off after the last item the server returned\n     * for this view. That keeps locally created or updated items in their sort position,\n     * and hides cached items that sort past the loaded pages until pagination reaches them.\n     *\n     * While searching, the server's (relevance) order is kept as is.\n     */\n    select(items: TRow[]): TRow[] {\n        const matched = this.filter(items);\n        const view = this._view;\n        if (!view) {\n            return matched;\n        }\n\n        const serverIndex = new Map(view.resultKeys.map((key, index) => [key, index]));\n        // Items the server did not return for this view (cached by other views, or created\n        // locally) sort after the server's items among equal sort values.\n        const indexOf = (item: TRow) =>\n            serverIndex.get(this.getKey(item)) ?? Number.POSITIVE_INFINITY;\n\n        const sort = view.searching ? undefined : view.sort;\n        const sorted = [...matched].sort((a, b) => {\n            if (sort) {\n                const result = compareValues(\n                    this.getSortValue(a, sort.field),\n                    this.getSortValue(b, sort.field)\n                );\n                if (result !== 0) {\n                    return sort.direction === \"ASC\" ? result : -result;\n                }\n            }\n            const left = indexOf(a);\n            const right = indexOf(b);\n            return left === right ? 0 : left < right ? -1 : 1;\n        });\n\n        if (!view.hasMore) {\n            return sorted;\n        }\n\n        let lastLoaded = -1;\n        sorted.forEach((item, index) => {\n            if (serverIndex.has(this.getKey(item))) {\n                lastLoaded = index;\n            }\n        });\n\n        return lastLoaded < 0 ? sorted : sorted.slice(0, lastLoaded + 1);\n    }\n\n    private getKey(item: TRow): string {\n        return String(item[this.config.keyField]);\n    }\n\n    hasServerSideFilters(params: IDataSourceQuery): boolean {\n        if (params.search) {\n            return true;\n        }\n        const filters = params.filters ?? {};\n        return Object.keys(filters).some(key => !this.localFilterKeys.has(key));\n    }\n\n    updateFromQuery(params: IDataSourceQuery, resultKeys: string[], hasMore = false): void {\n        if (this.hasServerSideFilters(params)) {\n            this._queryResultKeys = new Set(resultKeys);\n        } else {\n            this._queryResultKeys = null;\n        }\n        this._matcher = this.buildMatcher(params);\n        this._view = {\n            resultKeys: [...resultKeys],\n            sort: params.sort,\n            searching: !!params.search,\n            hasMore\n        };\n    }\n\n    appendResultKeys(keys: string[], hasMore = false): void {\n        if (this._queryResultKeys) {\n            for (const key of keys) {\n                this._queryResultKeys.add(key);\n            }\n        }\n        if (this._view) {\n            this._view = {\n                ...this._view,\n                resultKeys: [...this._view.resultKeys, ...keys],\n                hasMore\n            };\n        }\n    }\n\n    private buildMatcher(params: IDataSourceQuery): (item: TRow) => boolean {\n        const filters = params.filters ?? {};\n        const queryResultKeys = this._queryResultKeys;\n        const isSearching = !!params.search;\n        const { keyField, localFilters } = this.config;\n\n        const activeLocalFilters: Array<{ predicate: ItemPredicate<TRow>; value: unknown }> = [];\n        for (const [key, predicate] of Object.entries(localFilters)) {\n            const value = filters[key];\n            if (value !== undefined && value !== null) {\n                activeLocalFilters.push({ predicate, value });\n            }\n        }\n\n        return (item: TRow) => {\n            if (queryResultKeys) {\n                if (!queryResultKeys.has(String(item[keyField]))) {\n                    return false;\n                }\n            } else if (!isSearching) {\n                for (const { predicate, value } of activeLocalFilters) {\n                    if (!predicate(item, value)) {\n                        return false;\n                    }\n                }\n            }\n\n            return true;\n        };\n    }\n}\n\nfunction getValueByPath(item: unknown, path: string): unknown {\n    let current: unknown = item;\n    for (const part of path.split(\".\")) {\n        if (current === null || current === undefined || typeof current !== \"object\") {\n            return undefined;\n        }\n        current = (current as Record<string, unknown>)[part];\n    }\n    return current;\n}\n\n/**\n * Compares two sort values in ascending order, the same way the DDB and SQL storage sort\n * entries: `null` and `undefined` sort last (so first in descending order), and an empty\n * string is a regular string. Strings are compared by code point, which keeps ISO dates in\n * chronological order.\n */\nfunction compareValues(a: unknown, b: unknown): number {\n    const aEmpty = a === null || a === undefined;\n    const bEmpty = b === null || b === undefined;\n    if (aEmpty || bEmpty) {\n        return aEmpty === bEmpty ? 0 : aEmpty ? 1 : -1;\n    }\n\n    const left = a instanceof Date ? a.getTime() : a;\n    const right = b instanceof Date ? b.getTime() : b;\n\n    if (typeof left === \"number\" && typeof right === \"number\") {\n        return left - right;\n    }\n    if (typeof left === \"boolean\" && typeof right === \"boolean\") {\n        return Number(left) - Number(right);\n    }\n\n    const leftString = String(left);\n    const rightString = String(right);\n    return leftString < rightString ? -1 : leftString > rightString ? 1 : 0;\n}\n"],"names":["QueryMatcher","config","Set","Object","getValueByPath","makeObservable","observable","computed","action","items","matched","view","serverIndex","Map","key","index","indexOf","item","Number","sort","undefined","sorted","a","b","result","compareValues","left","right","lastLoaded","String","params","filters","resultKeys","hasMore","keys","queryResultKeys","isSearching","keyField","localFilters","activeLocalFilters","predicate","value","path","current","part","aEmpty","bEmpty","Date","leftString","rightString"],"mappings":"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"}

package/presentation/listPresenter/QueryMatcher.test.d.ts

@@ -0,0 +1 @@
+export {};