@acorex/platform 21.0.0-next.88 → 21.0.0-next.90

package/fesm2022/acorex-platform-layout-entity-contracts.mjs

@@ -841,14 +841,7 @@ async function collectEntityQuickSearchFieldPaths(entity, resolveRelatedDefiniti
 }
 //#endregion
 
-//#endregion
-//#region ---- Property filter helpers ----
-function isPropertyFilterEnabled(property) {
-    const filter = property.options?.filter;
-    return !!(filter?.advance?.enabled ||
-        filter?.inline?.enabled ||
-        filter?.preload?.enabled);
-}
+//#region ---- Related entity helpers ----
 function parseRelatedEntityFullName(fullName) {
     const trimmed = fullName.trim();
     const idx = trimmed.indexOf('.');
@@ -860,13 +853,24 @@ function parseRelatedEntityFullName(fullName) {
         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 filters:
+ * Resolves related property names eligible for host list columns/filters/sorts:
  * host columns under `dataPath`, optional `related.properties` allowlist, minus `excludeProperties`.
  */
-function collectMergeDetailFilterPropertyNames(hostEntity, dataPath, relatedEntity) {
+function collectMergeDetailListPropertyNames(hostEntity, dataPath, relatedEntity) {
     const names = new Set();
     const prefix = `${dataPath}.`;
     if (relatedEntity.properties?.length) {
@@ -904,6 +908,18 @@ function collectMergeDetailFilterPropertyNames(hostEntity, dataPath, relatedEnti
     }
     return names;
 }
+//#endregion
+
+//#endregion
+//#region ---- Property filter helpers ----
+function isPropertyFilterEnabled(property) {
+    const filter = property.options?.filter;
+    return !!(filter?.advance?.enabled ||
+        filter?.inline?.enabled ||
+        filter?.preload?.enabled);
+}
+//#endregion
+//#region ---- Merge-detail property discovery ----
 function resolveMergedRelatedInlineFilterField(dataPath, relatedEntityDef, property) {
     const columnDataPath = resolveEntityColumnDataPath(relatedEntityDef, property.name);
     if (columnDataPath) {
@@ -1002,7 +1018,7 @@ async function collectMergeDetailFilterDefinitions(hostEntity, resolveRelatedDef
         if (!relatedDef) {
             continue;
         }
-        const propertyNames = collectMergeDetailFilterPropertyNames(hostEntity, dataPath, related);
+        const propertyNames = collectMergeDetailListPropertyNames(hostEntity, dataPath, related);
         if (propertyNames.size === 0) {
             continue;
         }
@@ -1040,6 +1056,84 @@ async function collectEntityListFilterDefinitions(entity, resolveRelatedDefiniti
 }
 //#endregion
 
+//#endregion
+//#region ---- Property sort helpers ----
+function isPropertySortEnabled(property) {
+    return !!property.options?.sort?.enabled;
+}
+function resolveHostColumnTitle(hostEntity, fieldName) {
+    const column = hostEntity.columns?.find((c) => c.name === fieldName);
+    return column?.title;
+}
+function collectHostSortableFields(entity) {
+    return (entity.properties ?? [])
+        .filter(isPropertySortEnabled)
+        .map((property) => ({
+        name: property.name,
+        title: resolveHostColumnTitle(entity, property.name) ?? property.title,
+    }));
+}
+async function collectMergeDetailSortableFields(hostEntity, resolveRelatedDefinition) {
+    const fields = [];
+    for (const related of hostEntity.relatedEntities ?? []) {
+        if (related.layout?.type !== 'merge-detail') {
+            continue;
+        }
+        const dataPath = related.persistence?.dataPath?.trim();
+        if (!dataPath) {
+            continue;
+        }
+        const parsed = related.entity ? parseRelatedEntityFullName(related.entity) : null;
+        if (!parsed) {
+            continue;
+        }
+        const relatedDef = await resolveRelatedDefinition(parsed.moduleName, parsed.entityName);
+        if (!relatedDef) {
+            continue;
+        }
+        const propertyNames = collectMergeDetailListPropertyNames(hostEntity, dataPath, related);
+        for (const propertyName of propertyNames) {
+            const property = relatedDef.properties?.find((p) => p.name === propertyName);
+            if (!property || !isPropertySortEnabled(property)) {
+                continue;
+            }
+            const queryField = `${dataPath}.${propertyName}`;
+            fields.push({
+                name: queryField,
+                title: resolveHostColumnTitle(hostEntity, queryField) ?? 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`).
+ */
+async function collectEntityListSortableFields(entity, resolveRelatedDefinition) {
+    if (!entity) {
+        return [];
+    }
+    const hostFields = collectHostSortableFields(entity);
+    const relatedFields = await 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
+
 //#region ---- Workflow record helpers ----
 /** Entity query filter field for {@link AXPRecordWorkflowInfo.instanceId}. */
 const AXP_RECORD_WORKFLOW_INFO_INSTANCE_ID_FIELD = 'workflowInfo.instanceId';
@@ -1110,5 +1204,5 @@ const AXPEntityEventsKeys = {
  * Generated bundle index. Do not edit.
  */
 
-export { AXPEntityCommandScope, AXPEntityDataSourceKeys, AXPEntityEventsKeys, AXPEntityQueryType, AXPEntityType, AXPRelationshipCardinality, AXPRelationshipKind, AXP_RECORD_WORKFLOW_INFO_CORRELATION_ID_FIELD, AXP_RECORD_WORKFLOW_INFO_DEFINITION_ID_FIELD, AXP_RECORD_WORKFLOW_INFO_INSTANCE_ID_FIELD, ENTITY_LAYOUT_SINGLE_TITLE_PATH, ENTITY_ROW_POPUP_TITLE_OPTION, ENTITY_ROW_TITLE_TEMPLATE_OPTION, buildAXPRecordWorkflowInfo, buildEntitySearchTitleContext, collectEntityListFilterDefinitions, collectEntityQuickSearchFieldPaths, collectNestedCreateHiddenProperties, collectNestedFieldPathsFromEntityColumns, collectPropertyExposeTargetPaths, collectQuickSearchPathsFromSingleEntityDefinition, createAllQueryView, createQueryView, encodeEntityListFilterContextField, entityDetailsCreateActions, entityDetailsCreateActionsDeferredParent, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, getEntityInfo, getRecordWorkflowCorrelationId, getRecordWorkflowInstanceId, isCardFieldBadgeDisplay, isMeaningfulEntityDisplayTitle, isRowBoundEntityDisplayTemplate, isUnresolvedEntityDisplayTemplate, mergeForeignKeyFieldIntoCreateActions, normalizeEntityDisplayTemplate, normalizeExpressionTemplate, parsePropertyExposeEntries, resolveCardFieldBadgeColor, resolveDefaultMasterListLayout, resolveEnabledMasterListLayouts, resolveEntityColumnDataPath, resolveEntityListFilterContextField, resolveEntityListFilterQueryField, resolveEntityModifyRecordTitleTemplate, resolveEntityPropertyInlineFilterField, resolveEntityRowTitleTemplate, resolvePropertyExposeDisplayTarget, sanitizeResolvedEntityDisplayTitle };
+export { AXPEntityCommandScope, AXPEntityDataSourceKeys, AXPEntityEventsKeys, AXPEntityQueryType, AXPEntityType, AXPRelationshipCardinality, AXPRelationshipKind, AXP_RECORD_WORKFLOW_INFO_CORRELATION_ID_FIELD, AXP_RECORD_WORKFLOW_INFO_DEFINITION_ID_FIELD, AXP_RECORD_WORKFLOW_INFO_INSTANCE_ID_FIELD, ENTITY_LAYOUT_SINGLE_TITLE_PATH, ENTITY_ROW_POPUP_TITLE_OPTION, ENTITY_ROW_TITLE_TEMPLATE_OPTION, buildAXPRecordWorkflowInfo, buildEntitySearchTitleContext, collectEntityListFilterDefinitions, collectEntityListSortableFields, collectEntityQuickSearchFieldPaths, collectMergeDetailListPropertyNames, collectNestedCreateHiddenProperties, collectNestedFieldPathsFromEntityColumns, collectPropertyExposeTargetPaths, collectQuickSearchPathsFromSingleEntityDefinition, createAllQueryView, createQueryView, encodeEntityListFilterContextField, entityDetailsCreateActions, entityDetailsCreateActionsDeferredParent, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsNewEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterEditAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, getEntityInfo, getRecordWorkflowCorrelationId, getRecordWorkflowInstanceId, isCardFieldBadgeDisplay, isEntityPropertySortEnabled, isMeaningfulEntityDisplayTitle, isRowBoundEntityDisplayTemplate, isUnresolvedEntityDisplayTemplate, mergeForeignKeyFieldIntoCreateActions, normalizeEntityDisplayTemplate, normalizeExpressionTemplate, parseDottedFieldPath, parsePropertyExposeEntries, parseRelatedEntityFullName, resolveCardFieldBadgeColor, resolveDefaultMasterListLayout, resolveEnabledMasterListLayouts, resolveEntityColumnDataPath, resolveEntityListFilterContextField, resolveEntityListFilterQueryField, resolveEntityModifyRecordTitleTemplate, resolveEntityPropertyInlineFilterField, resolveEntityRowTitleTemplate, resolvePropertyExposeDisplayTarget, sanitizeResolvedEntityDisplayTitle };
 //# sourceMappingURL=acorex-platform-layout-entity-contracts.mjs.map