@acorex-platform/framework-shared 0.0.1

package/entity/src/lib/utils/entity-list-filter-definitions.util.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectEntityListFilterDefinitions = collectEntityListFilterDefinitions;
+const tslib_1 = require("tslib");
+const lodash_es_1 = require("lodash-es");
+const entity_list_filter_types_1 = require("../types/entity-list-filter.types");
+const entity_merge_detail_list_properties_util_1 = require("./entity-merge-detail-list-properties.util");
+const entity_property_display_path_util_1 = require("./entity-property-display-path.util");
+//#endregion
+//#region ---- Property filter helpers ----
+function isPropertyFilterEnabled(property) {
+    var _a, _b, _c, _d;
+    const filter = (_a = property.options) === null || _a === void 0 ? void 0 : _a.filter;
+    return !!(((_b = filter === null || filter === void 0 ? void 0 : filter.advance) === null || _b === void 0 ? void 0 : _b.enabled) ||
+        ((_c = filter === null || filter === void 0 ? void 0 : filter.inline) === null || _c === void 0 ? void 0 : _c.enabled) ||
+        ((_d = filter === null || filter === void 0 ? void 0 : filter.preload) === null || _d === void 0 ? void 0 : _d.enabled));
+}
+//#endregion
+//#region ---- Merge-detail property discovery ----
+function resolveMergedRelatedInlineFilterField(dataPath, relatedEntityDef, property) {
+    var _a, _b;
+    const columnDataPath = (0, entity_property_display_path_util_1.resolveEntityColumnDataPath)(relatedEntityDef, property.name);
+    if (columnDataPath) {
+        return `${dataPath}.${columnDataPath}`;
+    }
+    const exposeTarget = (0, entity_property_display_path_util_1.resolvePropertyExposeDisplayTarget)((_b = (_a = property.schema) === null || _a === void 0 ? void 0 : _a.interface) === null || _b === void 0 ? void 0 : _b.options);
+    if (exposeTarget) {
+        return `${dataPath}.${exposeTarget}`;
+    }
+    return undefined;
+}
+//#endregion
+//#region ---- Filter definition builder ----
+function buildFilterDefinitionFromProperty(hostEntity, property, options, deps) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
+    if (!isPropertyFilterEnabled(property)) {
+        return null;
+    }
+    const iface = (_a = property.schema.interface) !== null && _a !== void 0 ? _a : {};
+    const interfaceType = iface.type;
+    const widgetConfig = interfaceType ? (_b = deps === null || deps === void 0 ? void 0 : deps.resolveWidget) === null || _b === void 0 ? void 0 : _b.call(deps, interfaceType) : undefined;
+    const type = (((_e = (_d = (_c = property.options) === null || _c === void 0 ? void 0 : _c.filter) === null || _d === void 0 ? void 0 : _d.advance) === null || _e === void 0 ? void 0 : _e.widgetType) ||
+        (widgetConfig === null || widgetConfig === void 0 ? void 0 : widgetConfig.defaultFilterWidgetName) ||
+        interfaceType);
+    const inlineQueryField = (_f = options.inlineQueryField) !== null && _f !== void 0 ? _f : (0, entity_property_display_path_util_1.resolveEntityPropertyInlineFilterField)(hostEntity, property);
+    const preloadRequired = (_j = (_h = (_g = property.options) === null || _g === void 0 ? void 0 : _g.filter) === null || _h === void 0 ? void 0 : _h.preload) === null || _j === void 0 ? void 0 : _j.required;
+    const validations = preloadRequired
+        ? [
+            {
+                rule: 'required',
+                message: 'This field is required',
+                options: {},
+            },
+        ]
+        : [];
+    const widgetOptions = Object.assign(Object.assign({}, ((_k = iface.options) !== null && _k !== void 0 ? _k : {})), (validations.length ? { validations } : {}));
+    const contextField = options.field.includes('.')
+        ? (0, entity_list_filter_types_1.encodeEntityListFilterContextField)(options.field)
+        : undefined;
+    return Object.assign(Object.assign(Object.assign({ title: property.title, field: options.field }, (contextField ? { contextField } : {})), (inlineQueryField && inlineQueryField !== options.field ? { inlineQueryField } : {})), { operator: {
+            type: 'contains',
+        }, widget: Object.assign(Object.assign({}, (0, lodash_es_1.omit)(iface, 'triggers')), { path: contextField !== null && contextField !== void 0 ? contextField : options.field, type, options: widgetOptions }), filters: [], isParametric: false, icon: widgetConfig === null || widgetConfig === void 0 ? void 0 : widgetConfig.icon, filterType: {
+            advance: (_p = (_o = (_m = (_l = property.options) === null || _l === void 0 ? void 0 : _l.filter) === null || _m === void 0 ? void 0 : _m.advance) === null || _o === void 0 ? void 0 : _o.enabled) !== null && _p !== void 0 ? _p : false,
+            inline: (_t = (_s = (_r = (_q = property.options) === null || _q === void 0 ? void 0 : _q.filter) === null || _r === void 0 ? void 0 : _r.inline) === null || _s === void 0 ? void 0 : _s.enabled) !== null && _t !== void 0 ? _t : false,
+            preload: (_v = (_u = property.options) === null || _u === void 0 ? void 0 : _u.filter) === null || _v === void 0 ? void 0 : _v.preload,
+        }, triggers: iface.triggers });
+}
+function collectHostPropertyFilterDefinitions(entity, deps) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const definitions = [];
+        for (const property of (_a = entity.properties) !== null && _a !== void 0 ? _a : []) {
+            const definition = buildFilterDefinitionFromProperty(entity, property, { field: property.name }, deps);
+            if (definition) {
+                definitions.push(definition);
+            }
+        }
+        return definitions;
+    });
+}
+function collectMergeDetailFilterDefinitions(hostEntity, resolveRelatedDefinition, deps) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const definitions = [];
+        for (const related of (_a = hostEntity.relatedEntities) !== null && _a !== void 0 ? _a : []) {
+            if (((_b = related.layout) === null || _b === void 0 ? void 0 : _b.type) !== 'merge-detail') {
+                continue;
+            }
+            if (((_c = related.filter) === null || _c === void 0 ? void 0 : _c.enabled) === false) {
+                continue;
+            }
+            const dataPath = (_e = (_d = related.persistence) === null || _d === void 0 ? void 0 : _d.dataPath) === null || _e === void 0 ? void 0 : _e.trim();
+            if (!dataPath) {
+                continue;
+            }
+            const parsed = related.entity ? (0, entity_merge_detail_list_properties_util_1.parseRelatedEntityFullName)(related.entity) : null;
+            if (!parsed) {
+                continue;
+            }
+            const relatedDef = yield resolveRelatedDefinition(parsed.moduleName, parsed.entityName);
+            if (!relatedDef) {
+                continue;
+            }
+            const propertyNames = (0, entity_merge_detail_list_properties_util_1.collectMergeDetailListPropertyNames)(hostEntity, dataPath, related);
+            if (propertyNames.size === 0) {
+                continue;
+            }
+            for (const propertyName of propertyNames) {
+                const property = (_f = relatedDef.properties) === null || _f === void 0 ? void 0 : _f.find((p) => p.name === propertyName);
+                if (!property) {
+                    continue;
+                }
+                const queryField = `${dataPath}.${propertyName}`;
+                const inlineQueryField = resolveMergedRelatedInlineFilterField(dataPath, relatedDef, property);
+                const definition = buildFilterDefinitionFromProperty(hostEntity, property, {
+                    field: queryField,
+                    inlineQueryField,
+                }, deps);
+                if (definition) {
+                    definitions.push(definition);
+                }
+            }
+        }
+        return definitions;
+    });
+}
+//#endregion
+//#region ---- Public API ----
+/**
+ * Builds master-list filter definitions from host properties and merge-detail related entities.
+ * Related filters use `{dataPath}.{property}` query fields (e.g. `person.firstName`).
+ */
+function collectEntityListFilterDefinitions(entity, resolveRelatedDefinition, deps) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        if (!entity) {
+            return [];
+        }
+        const hostDefinitions = yield collectHostPropertyFilterDefinitions(entity, deps);
+        const relatedDefinitions = yield collectMergeDetailFilterDefinitions(entity, resolveRelatedDefinition, deps);
+        return [...hostDefinitions, ...relatedDefinitions];
+    });
+}
+//#endregion
+//# sourceMappingURL=entity-list-filter-definitions.util.js.map

package/entity/src/lib/utils/entity-list-filter-definitions.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-list-filter-definitions.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/utils/entity-list-filter-definitions.util.ts"],"names":[],"mappings":"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"}

package/entity/src/lib/utils/entity-list-sortable-fields.util.d.ts

@@ -0,0 +1,14 @@
+import type { AXPEntity } from '../types/entity-definition.types';
+import type { AXPEntityProperty } from '../types/entity-property.types';
+import type { AXPCollectEntityQuickSearchPathsResolver } from './entity-quick-search-paths.util';
+export interface AXPEntityListSortableField {
+    name: string;
+    title: string;
+}
+/**
+ * Builds master-list sortable fields from host properties and merge-detail related entities.
+ * Related sorts use `{dataPath}.{property}` query fields (e.g. `person.firstName`).
+ */
+export declare function collectEntityListSortableFields(entity: AXPEntity | null | undefined, resolveRelatedDefinition: AXPCollectEntityQuickSearchPathsResolver): Promise<AXPEntityListSortableField[]>;
+export declare function isEntityPropertySortEnabled(property: AXPEntityProperty | null | undefined): boolean;
+//# sourceMappingURL=entity-list-sortable-fields.util.d.ts.map

package/entity/src/lib/utils/entity-list-sortable-fields.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-list-sortable-fields.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/utils/entity-list-sortable-fields.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAMxE,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,kCAAkC,CAAC;AAIjG,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAwED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACpC,wBAAwB,EAAE,wCAAwC,GACjE,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAoBvC;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEnG"}

package/entity/src/lib/utils/entity-list-sortable-fields.util.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectEntityListSortableFields = collectEntityListSortableFields;
+exports.isEntityPropertySortEnabled = isEntityPropertySortEnabled;
+const tslib_1 = require("tslib");
+const entity_merge_detail_list_properties_util_1 = require("./entity-merge-detail-list-properties.util");
+//#endregion
+//#region ---- Property sort helpers ----
+function isPropertySortEnabled(property) {
+    var _a, _b;
+    return !!((_b = (_a = property.options) === null || _a === void 0 ? void 0 : _a.sort) === null || _b === void 0 ? void 0 : _b.enabled);
+}
+function resolveHostColumnTitle(hostEntity, fieldName) {
+    var _a;
+    const column = (_a = hostEntity.columns) === null || _a === void 0 ? void 0 : _a.find((c) => c.name === fieldName);
+    return column === null || column === void 0 ? void 0 : column.title;
+}
+function collectHostSortableFields(entity) {
+    var _a;
+    return ((_a = entity.properties) !== null && _a !== void 0 ? _a : [])
+        .filter(isPropertySortEnabled)
+        .map((property) => {
+        var _a;
+        return ({
+            name: property.name,
+            title: (_a = resolveHostColumnTitle(entity, property.name)) !== null && _a !== void 0 ? _a : property.title,
+        });
+    });
+}
+function collectMergeDetailSortableFields(hostEntity, resolveRelatedDefinition) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f;
+        const fields = [];
+        for (const related of (_a = hostEntity.relatedEntities) !== null && _a !== void 0 ? _a : []) {
+            if (((_b = related.layout) === null || _b === void 0 ? void 0 : _b.type) !== 'merge-detail') {
+                continue;
+            }
+            const dataPath = (_d = (_c = related.persistence) === null || _c === void 0 ? void 0 : _c.dataPath) === null || _d === void 0 ? void 0 : _d.trim();
+            if (!dataPath) {
+                continue;
+            }
+            const parsed = related.entity ? (0, entity_merge_detail_list_properties_util_1.parseRelatedEntityFullName)(related.entity) : null;
+            if (!parsed) {
+                continue;
+            }
+            const relatedDef = yield resolveRelatedDefinition(parsed.moduleName, parsed.entityName);
+            if (!relatedDef) {
+                continue;
+            }
+            const propertyNames = (0, entity_merge_detail_list_properties_util_1.collectMergeDetailListPropertyNames)(hostEntity, dataPath, related);
+            for (const propertyName of propertyNames) {
+                const property = (_e = relatedDef.properties) === null || _e === void 0 ? void 0 : _e.find((p) => p.name === propertyName);
+                if (!property || !isPropertySortEnabled(property)) {
+                    continue;
+                }
+                const queryField = `${dataPath}.${propertyName}`;
+                fields.push({
+                    name: queryField,
+                    title: (_f = resolveHostColumnTitle(hostEntity, queryField)) !== null && _f !== void 0 ? _f : property.title,
+                });
+            }
+        }
+        return fields;
+    });
+}
+//#endregion
+//#region ---- Public API ----
+/**
+ * Builds master-list sortable fields from host properties and merge-detail related entities.
+ * Related sorts use `{dataPath}.{property}` query fields (e.g. `person.firstName`).
+ */
+function collectEntityListSortableFields(entity, resolveRelatedDefinition) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        if (!entity) {
+            return [];
+        }
+        const hostFields = collectHostSortableFields(entity);
+        const relatedFields = yield collectMergeDetailSortableFields(entity, resolveRelatedDefinition);
+        const seen = new Set();
+        const result = [];
+        for (const field of [...hostFields, ...relatedFields]) {
+            if (seen.has(field.name)) {
+                continue;
+            }
+            seen.add(field.name);
+            result.push(field);
+        }
+        return result;
+    });
+}
+function isEntityPropertySortEnabled(property) {
+    return property != null && isPropertySortEnabled(property);
+}
+//#endregion
+//# sourceMappingURL=entity-list-sortable-fields.util.js.map

package/entity/src/lib/utils/entity-list-sortable-fields.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-list-sortable-fields.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/utils/entity-list-sortable-fields.util.ts"],"names":[],"mappings":"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"}

package/entity/src/lib/utils/entity-merge-detail-list-properties.util.d.ts

@@ -0,0 +1,16 @@
+import type { AXPEntity } from '../types/entity-definition.types';
+import type { AXPRelatedEntity } from '../types/entity-related-layout.types';
+export declare function parseRelatedEntityFullName(fullName: string): {
+    moduleName: string;
+    entityName: string;
+} | null;
+export declare function parseDottedFieldPath(fieldPath: string): {
+    dataPath: string;
+    propertyName: string;
+} | null;
+/**
+ * Resolves related property names eligible for host list columns/filters/sorts:
+ * host columns under `dataPath`, optional `related.properties` allowlist, minus `excludeProperties`.
+ */
+export declare function collectMergeDetailListPropertyNames(hostEntity: AXPEntity, dataPath: string, relatedEntity: AXPRelatedEntity): Set<string>;
+//# sourceMappingURL=entity-merge-detail-list-properties.util.d.ts.map

package/entity/src/lib/utils/entity-merge-detail-list-properties.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-merge-detail-list-properties.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/utils/entity-merge-detail-list-properties.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAI7E,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAU9G;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUzG;AAMD;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,SAAS,EACrB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,gBAAgB,GAC9B,GAAG,CAAC,MAAM,CAAC,CA0Cb"}

package/entity/src/lib/utils/entity-merge-detail-list-properties.util.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRelatedEntityFullName = parseRelatedEntityFullName;
+exports.parseDottedFieldPath = parseDottedFieldPath;
+exports.collectMergeDetailListPropertyNames = collectMergeDetailListPropertyNames;
+//#region ---- Related entity helpers ----
+function parseRelatedEntityFullName(fullName) {
+    const trimmed = fullName.trim();
+    const idx = trimmed.indexOf('.');
+    if (idx <= 0 || idx >= trimmed.length - 1) {
+        return null;
+    }
+    return {
+        moduleName: trimmed.slice(0, idx),
+        entityName: trimmed.slice(idx + 1),
+    };
+}
+function parseDottedFieldPath(fieldPath) {
+    const trimmed = fieldPath.trim();
+    const dotIndex = trimmed.indexOf('.');
+    if (dotIndex <= 0 || dotIndex >= trimmed.length - 1) {
+        return null;
+    }
+    return {
+        dataPath: trimmed.slice(0, dotIndex),
+        propertyName: trimmed.slice(dotIndex + 1),
+    };
+}
+//#endregion
+//#region ---- Merge-detail property discovery ----
+/**
+ * Resolves related property names eligible for host list columns/filters/sorts:
+ * host columns under `dataPath`, optional `related.properties` allowlist, minus `excludeProperties`.
+ */
+function collectMergeDetailListPropertyNames(hostEntity, dataPath, relatedEntity) {
+    var _a, _b, _c, _d, _e, _f;
+    const names = new Set();
+    const prefix = `${dataPath}.`;
+    if ((_a = relatedEntity.properties) === null || _a === void 0 ? void 0 : _a.length) {
+        for (const name of relatedEntity.properties) {
+            const trimmed = name.trim();
+            if (trimmed) {
+                names.add(trimmed);
+            }
+        }
+    }
+    for (const column of (_b = hostEntity.columns) !== null && _b !== void 0 ? _b : []) {
+        const columnName = column.name.trim();
+        if (columnName.startsWith(prefix)) {
+            const tail = columnName.slice(prefix.length);
+            const leaf = (_c = tail.split('.')[0]) === null || _c === void 0 ? void 0 : _c.trim();
+            if (leaf) {
+                names.add(leaf);
+            }
+        }
+        const rawDataPath = (_d = column.options) === null || _d === void 0 ? void 0 : _d['dataPath'];
+        if (typeof rawDataPath === 'string') {
+            const dp = rawDataPath.trim();
+            if (dp.startsWith(prefix)) {
+                const tail = dp.slice(prefix.length);
+                const leaf = (_e = tail.split('.')[0]) === null || _e === void 0 ? void 0 : _e.trim();
+                if (leaf) {
+                    names.add(leaf);
+                }
+            }
+        }
+    }
+    const excluded = new Set(((_f = relatedEntity.excludeProperties) !== null && _f !== void 0 ? _f : []).map((n) => n.trim()).filter(Boolean));
+    for (const name of excluded) {
+        names.delete(name);
+    }
+    return names;
+}
+//#endregion
+//# sourceMappingURL=entity-merge-detail-list-properties.util.js.map

package/entity/src/lib/utils/entity-merge-detail-list-properties.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-merge-detail-list-properties.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/utils/entity-merge-detail-list-properties.util.ts"],"names":[],"mappings":"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"}

package/entity/src/lib/utils/entity-property-display-path.util.d.ts

@@ -0,0 +1,36 @@
+import type { AXPEntity } from '../types/entity-definition.types';
+export interface AXPEntityPropertyExposeEntry {
+    source: string;
+    target: string;
+}
+export type AXPEntityPropertyLike = {
+    name: string;
+    schema?: {
+        interface?: {
+            options?: Record<string, unknown>;
+        };
+    };
+};
+/**
+ * Parses lookup/select `expose` entries from a property interface options object.
+ */
+export declare function parsePropertyExposeEntries(options: Record<string, unknown> | undefined): AXPEntityPropertyExposeEntry[];
+/**
+ * Collects all non-empty `expose[].target` paths from a property.
+ */
+export declare function collectPropertyExposeTargetPaths(property: AXPEntityPropertyLike): string[];
+/**
+ * Resolves list column `options.dataPath` for a property when explicitly set.
+ */
+export declare function resolveEntityColumnDataPath(entity: AXPEntity | null | undefined, propertyName: string): string | undefined;
+/**
+ * Resolves the lodash-get path for lookup/select display text from expose metadata.
+ */
+export declare function resolvePropertyExposeDisplayTarget(options: Record<string, unknown> | undefined): string | undefined;
+/**
+ * Resolves the lodash-get path used for inline `contains` filters on lookup/select properties.
+ * Prefers list column `dataPath`, then lookup `expose` target for `textField` (or first non-id expose).
+ * Returns `undefined` when the property name should be used as-is (e.g. plain text fields).
+ */
+export declare function resolveEntityPropertyInlineFilterField(entity: AXPEntity | null | undefined, property: AXPEntityPropertyLike): string | undefined;
+//# sourceMappingURL=entity-property-display-path.util.d.ts.map

package/entity/src/lib/utils/entity-property-display-path.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-property-display-path.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/utils/entity-property-display-path.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE;YACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACnC,CAAC;KACH,CAAC;CACH,CAAC;AAMF;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,4BAA4B,EAAE,CAahC;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAc1F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACpC,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAYpB;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,MAAM,GAAG,SAAS,CAoBpB;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACpC,QAAQ,EAAE,qBAAqB,GAC9B,MAAM,GAAG,SAAS,CAgBpB"}

package/entity/src/lib/utils/entity-property-display-path.util.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePropertyExposeEntries = parsePropertyExposeEntries;
+exports.collectPropertyExposeTargetPaths = collectPropertyExposeTargetPaths;
+exports.resolveEntityColumnDataPath = resolveEntityColumnDataPath;
+exports.resolvePropertyExposeDisplayTarget = resolvePropertyExposeDisplayTarget;
+exports.resolveEntityPropertyInlineFilterField = resolveEntityPropertyInlineFilterField;
+//#endregion
+//#region ---- Expose parsing ----
+/**
+ * Parses lookup/select `expose` entries from a property interface options object.
+ */
+function parsePropertyExposeEntries(options) {
+    const expose = options === null || options === void 0 ? void 0 : options['expose'];
+    if (!Array.isArray(expose)) {
+        return [];
+    }
+    return expose.filter((row) => row != null &&
+        typeof row === 'object' &&
+        typeof row.source === 'string' &&
+        typeof row.target === 'string');
+}
+/**
+ * Collects all non-empty `expose[].target` paths from a property.
+ */
+function collectPropertyExposeTargetPaths(property) {
+    var _a, _b;
+    const opts = (_b = (_a = property.schema) === null || _a === void 0 ? void 0 : _a.interface) === null || _b === void 0 ? void 0 : _b.options;
+    if (!opts || typeof opts !== 'object') {
+        return [];
+    }
+    const paths = new Set();
+    for (const entry of parsePropertyExposeEntries(opts)) {
+        const target = entry.target.trim();
+        if (target) {
+            paths.add(target);
+        }
+    }
+    return [...paths];
+}
+/**
+ * Resolves list column `options.dataPath` for a property when explicitly set.
+ */
+function resolveEntityColumnDataPath(entity, propertyName) {
+    var _a, _b;
+    const column = (_a = entity === null || entity === void 0 ? void 0 : entity.columns) === null || _a === void 0 ? void 0 : _a.find((c) => c.name === propertyName);
+    const rawDataPath = (_b = column === null || column === void 0 ? void 0 : column.options) === null || _b === void 0 ? void 0 : _b['dataPath'];
+    if (typeof rawDataPath !== 'string') {
+        return undefined;
+    }
+    const dataPath = rawDataPath.trim();
+    if (!dataPath || dataPath === propertyName) {
+        return undefined;
+    }
+    return dataPath;
+}
+/**
+ * Resolves the lodash-get path for lookup/select display text from expose metadata.
+ */
+function resolvePropertyExposeDisplayTarget(options) {
+    if (!options) {
+        return undefined;
+    }
+    const textField = typeof options['textField'] === 'string' ? options['textField'].trim() : '';
+    const valueField = typeof options['valueField'] === 'string' ? options['valueField'].trim() : 'id';
+    const entries = parsePropertyExposeEntries(options);
+    if (textField) {
+        const match = entries.find((entry) => entry.source === textField);
+        if (match === null || match === void 0 ? void 0 : match.target.trim()) {
+            return match.target.trim();
+        }
+    }
+    const displayEntry = entries.find((entry) => entry.source !== valueField && entry.source !== 'id' && entry.target.trim());
+    return displayEntry === null || displayEntry === void 0 ? void 0 : displayEntry.target.trim();
+}
+/**
+ * Resolves the lodash-get path used for inline `contains` filters on lookup/select properties.
+ * Prefers list column `dataPath`, then lookup `expose` target for `textField` (or first non-id expose).
+ * Returns `undefined` when the property name should be used as-is (e.g. plain text fields).
+ */
+function resolveEntityPropertyInlineFilterField(entity, property) {
+    var _a, _b;
+    if (!entity || !(property === null || property === void 0 ? void 0 : property.name)) {
+        return undefined;
+    }
+    const dataPath = resolveEntityColumnDataPath(entity, property.name);
+    if (dataPath) {
+        return dataPath;
+    }
+    const opts = (_b = (_a = property.schema) === null || _a === void 0 ? void 0 : _a.interface) === null || _b === void 0 ? void 0 : _b.options;
+    if (!opts || typeof opts !== 'object') {
+        return undefined;
+    }
+    return resolvePropertyExposeDisplayTarget(opts);
+}
+//#endregion
+//# sourceMappingURL=entity-property-display-path.util.js.map

package/entity/src/lib/utils/entity-property-display-path.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-property-display-path.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/utils/entity-property-display-path.util.ts"],"names":[],"mappings":"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"}

package/entity/src/lib/utils/entity-quick-search-paths.util.d.ts

@@ -0,0 +1,19 @@
+import type { AXPEntity } from '../types/entity-definition.types';
+export type AXPCollectEntityQuickSearchPathsResolver = (moduleName: string, entityName: string) => Promise<AXPEntity | null>;
+/**
+ * Lodash-get paths for quick search from a single entity definition: string-like property names
+ * plus lookup `expose[].target` paths (e.g. `brand.title`).
+ */
+export declare function collectQuickSearchPathsFromSingleEntityDefinition(entity: AXPEntity | null | undefined): string[];
+/**
+ * Adds dotted paths from master columns (`name` or `options.dataPath`), e.g. `person.fullName`, `jobDefinition.title`.
+ */
+export declare function collectNestedFieldPathsFromEntityColumns(entity: AXPEntity | null | undefined): string[];
+/**
+ * Collects lodash-get field paths used for mock/API quick search (`contains` / OR filters):
+ * host properties and lookup expose targets, dotted column paths, and merge-detail related entities
+ * prefixed with the related entity merge `persistence.dataPath` (e.g. `person.firstName`).
+ */
+export declare function collectEntityQuickSearchFieldPaths(entity: AXPEntity | null | undefined, resolveRelatedDefinition: AXPCollectEntityQuickSearchPathsResolver): Promise<string[]>;
+export { resolveEntityPropertyInlineFilterField } from './entity-property-display-path.util';
+//# sourceMappingURL=entity-quick-search-paths.util.d.ts.map

package/entity/src/lib/utils/entity-quick-search-paths.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-quick-search-paths.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/entity/src/lib/utils/entity-quick-search-paths.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAMlE,MAAM,MAAM,wCAAwC,GAAG,CACrD,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;AAwC/B;;;GAGG;AACH,wBAAgB,iDAAiD,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAkBhH;AAMD;;GAEG;AACH,wBAAgB,wCAAwC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAuBvG;AAsBD;;;;GAIG;AACH,wBAAsB,kCAAkC,CACtD,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,EACpC,wBAAwB,EAAE,wCAAwC,GACjE,OAAO,CAAC,MAAM,EAAE,CAAC,CA0CnB;AAED,OAAO,EAAE,sCAAsC,EAAE,MAAM,qCAAqC,CAAC"}