@sapui5/sap.suite.ui.generic.template 1.148.0 → 1.148.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sapui5/sap.suite.ui.generic.template",
-  "version": "1.148.0",
+  "version": "1.148.2",
   "description": "SAPUI5 Library sap.suite.ui.generic.template",
   "keywords": [
     "sapui5",

package/src/sap/suite/ui/generic/template/.library

@@ -7,7 +7,7 @@
 
 		(c) Copyright 2009-2015 SAP SE. All rights reserved
 	</copyright>
-	<version>1.148.0</version>
+	<version>1.148.2</version>
 
 	<documentation>Library with generic Suite UI templates.</documentation>
 

package/src/sap/suite/ui/generic/template/AnalyticalListPage/i18n/i18n_fr_CA.properties

@@ -23,7 +23,7 @@ KPI_TOOLTIP_CRITICAL={0} {1}\nStatut\: risque
 
 KPI_DETERMINING_ERROR={0}\nImpossible de d\u00E9terminer la valeur
 
-KPI_DETERMINING_WARNING={0}\nDonn\u00E9es non valides ou introuvables
+KPI_DETERMINING_WARNING={0}\nDonn\u00E9es invalides ou introuvables
 
 KPI_AUTHORIZATION_ISSUE=Probl\u00E8me d'autorisation
 
@@ -172,7 +172,7 @@ M_VISUAL_FILTER_HIDDEN_MEASURE=Impossible de charger le filtre visuel. La mesure
 
 REQUIRED_VH_FIELDS_OVERLAY_MESSAGE=Impossible de charger les donn\u00E9es car des champs obligatoires sont manquants. Contactez votre administrateur.
 
-INVALID_MEASURE_DONUT_MESSAGE=Mesure non valide trouv\u00E9e pour graphique en anneaux. La mesure doit \u00EAtre cumulative et positive.
+INVALID_MEASURE_DONUT_MESSAGE=Mesure invalide trouv\u00E9e pour graphique en anneaux. La mesure doit \u00EAtre cumulative et positive.
 
 SHARE=Partager
 

package/src/sap/suite/ui/generic/template/AnalyticalListPage/manifest.json

@@ -8,7 +8,7 @@
 		"i18n": "i18n/i18n.properties",
 		"applicationVersion": {
 			"__comment": "applicationVersion oder componentversion??",
-			"version": "1.148.0"
+			"version": "1.148.2"
 		},
 		"title": "{{TITLE}}",
 		"description": "{{DESCRIPTION}}",

package/src/sap/suite/ui/generic/template/Canvas/manifest.json

@@ -8,7 +8,7 @@
 		"i18n": "i18n/i18n.properties",
 		"applicationVersion": {
 			"__comment": "applicationVersion oder componentversion??",
-			"version": "1.148.0"
+			"version": "1.148.2"
 		},
 		"title": "Canvas",
 		"description": "Canvas Page",

package/src/sap/suite/ui/generic/template/ListReport/controller/ControllerImplementation.js

@@ -939,9 +939,12 @@ sap.ui.define([
 						var oTempModel = oTemplateUtils.oComponentUtils.getTemplatePrivateModel();
 						if (oTempModel.getProperty("/listReport/filterMode") === "easyFilter") {
 							oSmartFilterbar.setVisible(false);
-							var  oTemplatePrivateModel = oTemplateUtils.oComponentUtils.getTemplatePrivateModel();
-							oTemplatePrivateModel.setProperty("/listReport/firstSelection", true);
-							oTemplatePrivateModel.setProperty("/generic/bDataAreShownInTable", false);
+							// Only show gray overlay when data in table is present.
+							// filters scenario where gray overlay shows up when No data Illustrated msg is rendered
+							if (oTempModel.getProperty("/generic/bDataAreShownInTable")) {
+								oTempModel.setProperty("/listReport/firstSelection", true);
+								oTempModel.setProperty("/generic/bDataAreShownInTable", false);
+							}
 						} else {
 							PXFeedback.triggerPXIntegration("toggleSwitchV2");
 							oSmartFilterbar.setVisible(true);

package/src/sap/suite/ui/generic/template/ListReport/i18n/i18n_fr.properties

@@ -5,7 +5,7 @@ DESCRIPTION=Rapport de liste
 
 ALL_OBJECTS=Tous
 
-ALL_OBJECTS_HIDING_DRAFT=Toutes (les versions pr\u00E9liminaires masqu\u00E9es)
+ALL_OBJECTS_HIDING_DRAFT=Tous (versions pr\u00E9liminaires masqu\u00E9es)
 
 UNCHANGED=Non modifi\u00E9
 

package/src/sap/suite/ui/generic/template/ListReport/manifest.json

@@ -8,7 +8,7 @@
 		"i18n": "i18n/i18n.properties",
 		"applicationVersion": {
 			"__comment": "applicationVersion oder componentversion??",
-			"version": "1.148.0"
+			"version": "1.148.2"
 		},
 		"title": "{{TITLE}}",
 		"description": "{{DESCRIPTION}}",

package/src/sap/suite/ui/generic/template/ObjectPage/manifest.json

@@ -6,7 +6,7 @@
 		"type": "component",
 		"i18n": "i18n/i18n.properties",
 		"applicationVersion": {
-			"version": "1.148.0"
+			"version": "1.148.2"
 		},
 		"title": "{{TITLE}}",
 		"description": "{{DESCRIPTION}}",

package/src/sap/suite/ui/generic/template/ObjectPage/view/fragments/Actions.fragment.xml

@@ -120,19 +120,7 @@
 		</template:if>
 	</template:repeat>
 
-	<uxap:ObjectPageHeaderActionButton id="{:= ${parameter>/stableId}.getStableId({type: 'ObjectPageAction', subType: 'Summarize'}) }"
-		text="{i18n>SUMMARIZE}"
-		icon="sap-icon://ai"
-		hideText="false"
-		importance="High"
-		enabled="{ui>/enabled}"
-		press="._templateEventHandlers.onSummarize"
-		ariaHasPopup="Dialog"
-		fesr:press="fe:sum:summarize"
-		type="Ghost"
-		dt:designtime="not-adaptable"
-		visible="{_templPrivGlobal>/generic/fioriAI/isSummarizationEnabled}" />
-	  <template:if test="{= !${parameter>/manifest/sap.ui.generic.app/pages/0/component/settings/treeTable}}">
+	<template:if test="{= !${parameter>/manifest/sap.ui.generic.app/pages/0/component/settings/treeTable}}">
         <template:if test="{parts: [{path: 'entitySet>Org.OData.Capabilities.V1.UpdateRestrictions'}, {path: 'entitySet>'}, {path: 'parameter>/treeNode/page/navigation/edit/target'}, {path: 'parameter>/treeNodeAncestors'}, {path: 'parameter>/isDraftEnabled'}], formatter: 'AHActionButtons.isEditButtonRequired'}">
                 <uxap:ObjectPageHeaderActionButton 
 					id="EasyFill"
@@ -150,6 +138,18 @@
                 />
         </template:if>
     </template:if>
+	<uxap:ObjectPageHeaderActionButton id="{:= ${parameter>/stableId}.getStableId({type: 'ObjectPageAction', subType: 'Summarize'}) }"
+		text="{i18n>SUMMARIZE}"
+		icon="sap-icon://ai"
+		hideText="false"
+		importance="High"
+		enabled="{ui>/enabled}"
+		press="._templateEventHandlers.onSummarize"
+		ariaHasPopup="Dialog"
+		fesr:press="fe:sum:summarize"
+		type="Ghost"
+		dt:designtime="not-adaptable"
+		visible="{_templPrivGlobal>/generic/fioriAI/isSummarizationEnabled}" />
 	<template:if test="{parameter>/settings/showRelatedApps}">
 		<uxap:ObjectPageHeaderActionButton id="{:= ${parameter>/stableId}.getStableId({type: 'ObjectPageAction', subType: 'RelatedApps'}) }"
 			text="{i18n>RELATED_APPS}"

package/src/sap/suite/ui/generic/template/QuickCreate/manifest.json

@@ -6,7 +6,7 @@
 		"type": "component",
 		"i18n": "i18n/i18n.properties",
 		"applicationVersion": {
-			"version": "1.148.0"
+			"version": "1.148.2"
 		},
 		"title": "{{TITLE}}",
 		"description": "{{DESCRIPTION}}",

package/src/sap/suite/ui/generic/template/QuickView/manifest.json

@@ -6,7 +6,7 @@
 	"type": "component",
 	"i18n": "i18n/i18n.properties",
 	"applicationVersion": {
-		"version": "1.148.0"
+		"version": "1.148.2"
 	},
 	"title": "{{TITLE}}",
 	"description": "{{DESCRIPTION}}",

package/src/sap/suite/ui/generic/template/genericUtilities/controlStateWrapperFactory/SmartFilterBarWrapper.js

@@ -27,6 +27,7 @@ sap.ui.define([
 		var aBasicFilters = [];
 		var oSmartFilterBar = oControl;
 		var oEasyFilterCallbacks = null;
+		var oPendingEasyFilterState = null;
 
 		var oVariantManagementInitializedPromise;
 
@@ -86,6 +87,11 @@ sap.ui.define([
 						filterMode: oCustomData[dataPropertyNameGeneric].filterMode,
 						easyFilter: oCustomData[dataPropertyNameGeneric].easyFilter
 					});
+				} else {
+					oPendingEasyFilterState = {
+						filterMode: oCustomData[dataPropertyNameGeneric].filterMode,
+						easyFilter: oCustomData[dataPropertyNameGeneric].easyFilter
+					};
 				}
 			});
 
@@ -142,7 +148,8 @@ sap.ui.define([
 							.map(oFilterItem => oFilterItem.getName()),
 						...aRemovedFromStandard
 					])],
-					customFilters: mParams.oCustomFiltersWrapper.getState()
+					customFilters: mParams.oCustomFiltersWrapper.getState(),
+					easyFilterState: oEasyFilterCallbacks ? oEasyFilterCallbacks.getState() : null
 			};
 		}
 
@@ -175,6 +182,14 @@ sap.ui.define([
 
 			mParams.oCustomFiltersWrapper.setState(oState && oState.customFilters);
 
+			if (oState && oState.easyFilterState) {
+				if (oEasyFilterCallbacks) {
+					oEasyFilterCallbacks.setState(oState.easyFilterState);
+				} else {
+					oPendingEasyFilterState = oState.easyFilterState;
+				}
+			}
+
 			// set visibility
 			// TODO:
 			// - How to deal with old states (not containing all information about visibility) -> legacy state handler?
@@ -250,6 +265,10 @@ sap.ui.define([
 			setSVMWrapperCallbacks: setSVMWrapperCallbacks,
 			setEasyFilterCallbacks: function(oCallbacks) {
 				oEasyFilterCallbacks = oCallbacks;
+				if (oPendingEasyFilterState) {
+					oEasyFilterCallbacks.setState(oPendingEasyFilterState);
+					oPendingEasyFilterState = null;
+				}
 			},
 			bVMConnection: oSmartFilterBar.getSmartVariant(),
 			suppressSelection: oSmartFilterBar.setSuppressSelection.bind(oSmartFilterBar), // if multiple reasons for suppressing overlap, a counter (to avoid to early resume) could be implemented here

package/src/sap/suite/ui/generic/template/lib/AppComponent.js

@@ -959,7 +959,7 @@ sap.ui.define([
 	 * @public
 	 * @extends sap.ui.core.UIComponent
 	 * @author SAP SE
-	 * @version 1.148.0
+	 * @version 1.148.2
 	 * @name sap.suite.ui.generic.template.lib.AppComponent
 	 */
 	var oAppComponent = UIComponent.extend("sap.suite.ui.generic.template.lib.AppComponent", {

package/src/sap/suite/ui/generic/template/lib/CRUDManager.js

@@ -589,13 +589,6 @@ sap.ui.define(["sap/ui/base/Object",
 								oServices.oTemplateCapabilities.oMessageButtonHelper.showMessagePopover();
 							}
 						}
-						// Reset pending changes to prevent infinite loop when entering edit mode again.
-						// Invalid values cause infinite loop because the pending changes (with invalid values) are resubmitted when the user clicks Edit, triggering the same error.
-						var oContext = oController.getView().getBindingContext();
-						var sContextPath = oContext && oContext.getPath();
-						if (sContextPath && oModel && oModel.hasPendingChanges()) {
-							oModel.resetChanges([sContextPath], undefined, true);
-						}
 						reject();
 					});
 					oBusyHelper.setBusy(oSubmitChange);

package/src/sap/suite/ui/generic/template/lib/CommonEventHandlers.js

@@ -95,6 +95,7 @@ sap.ui.define(["sap/ui/base/Object",
 		}
 
 		var mVirtualItems = Object.create(null); // cache for virtual items passed to onListNavigateExtension.
+		var mCellHideRowsUpdateHandlers = Object.create(null); // keyed by SmartTable ID: stores rowsUpdated/updateFinished handler for cell hiding
 		var oCurrentPaginatorInfo; // store paginator info while using the pagination
 		function getPaginatorInfo(oTable, oRow, oState){
 			var oRet = oCurrentPaginatorInfo;
@@ -1362,32 +1363,78 @@ sap.ui.define(["sap/ui/base/Object",
 		/**
 		 * This method is called in the onDataReceived event of the specified SmartTable.
 		 * It handles everything which can be done regarding hiding of cells at this point in time.
+		 * It also ensures that cell-level hiding is reapplied when rows are updated (e.g. after
+		 * scrolling in a GridTable or after the SmartTable rebuilds its inner table columns).
 		*/
 		function fnHideTableCells(oSmartTable, oHiddenColumnInfo) {
+			if (!oHiddenColumnInfo.columnKeyToCellHiddenPath) {
+				return;
+			}
+			fnApplyCellHiddenBindings(oSmartTable, oHiddenColumnInfo);
+			// Ensure that cell hiding is reapplied whenever the inner table updates its rows.
+			// This is needed because row controls may be recreated (e.g. when the SmartTable
+			// rebuilds columns after setUiState or deactivateColumns), which causes previously
+			// applied cell-level bindings to be lost.
+			fnAttachRowsUpdateHandler(oSmartTable, oHiddenColumnInfo);
+		}
+
+		/**
+		 * Applies cell-level visible bindings for all column keys in columnKeyToCellHiddenPath.
+		 */
+		function fnApplyCellHiddenBindings(oSmartTable, oHiddenColumnInfo) {
 			for (var sColumnKey in oHiddenColumnInfo.columnKeyToCellHiddenPath) {
 				var sPath = oHiddenColumnInfo.columnKeyToCellHiddenPath[sColumnKey];
 				fnHandleTableCellVisibility(oSmartTable, sColumnKey, sPath);
 			}
 		}
 
+		/**
+		 * Attaches a one-time event handler to the inner table's row update event so that
+		 * cell-level hiding is reapplied when rows are recreated. The handler re-attaches
+		 * itself on every dataReceived to keep working across rebinds.
+		 */
+		function fnAttachRowsUpdateHandler(oSmartTable, oHiddenColumnInfo) {
+			var oTable = oSmartTable.getTable();
+			var sSmartTableId = oSmartTable.getId();
+			var sEventName = controlHelper.isUiTable(oTable) ? "rowsUpdated" : "updateFinished";
+			// Detach any previously attached handler to avoid duplicates
+			if (mCellHideRowsUpdateHandlers[sSmartTableId]) {
+				oTable.detachEvent(sEventName, mCellHideRowsUpdateHandlers[sSmartTableId]);
+			}
+			mCellHideRowsUpdateHandlers[sSmartTableId] = function () {
+				fnApplyCellHiddenBindings(oSmartTable, oHiddenColumnInfo);
+			};
+			oTable.attachEvent(sEventName, mCellHideRowsUpdateHandlers[sSmartTableId]);
+		}
+
 		/**
 		 * This method is called for each Row of Table,to control the visibility of the Cell based on the Hidden property in LineItem.
 		 */
 		function fnHandleTableCellVisibility(oSmartTable, sColumnKey, sPath) {
 			var oSmartTableHandler = oServices.oPresentationControlHandlerFactory.getPresentationControlHandler(oSmartTable);
 			var oTable = oSmartTable.getTable();
-			var aItems = oTable.getRows ? oTable.getRows() : oTable.getItems();
+			var aItems = controlHelper.isUiTable(oTable) ? oTable.getRows() : oTable.getItems();
 			var oColumn = oSmartTableHandler.getColumnByKey(sColumnKey);
 			//if the column is visible in the table, then only we bind the visible property of the cell
 			if (oColumn && oColumn.getVisible()){
 				aItems.forEach(function(oItem) {
 					var oCell = oItem.getCells()[oTable.indexOfColumn(oColumn)];
-					oCell && oCell.bindProperty("visible", {
-						path: sPath,
-						formatter: function (bIsHidden) {
-							return !bIsHidden;
+					if (oCell) {
+						// Only apply the binding if it is not already set with the correct path.
+						// This avoids unnecessary teardown/recreation during scroll (rowsUpdated),
+						// while still applying the binding to new cell instances created after a
+						// column rebuild. If a different visible binding already exists (e.g. from
+						// the application), we overwrite it with the cell-hiding binding.
+						var oExistingBinding = oCell.getBindingInfo("visible");
+						if (!oExistingBinding || oExistingBinding.parts[0].path !== sPath) {
+							oCell.bindProperty("visible", {
+								path: sPath,
+								formatter: function (bIsHidden) {
+									return !bIsHidden;
+								}
+							});
 						}
-					});
+					}
 				});
 			}
 		}
@@ -2901,6 +2948,10 @@ sap.ui.define(["sap/ui/base/Object",
 		var fnRenderTeamsContactCollabOptions = testableHelper.testable(fnRenderTeamsContactCollabOptions, "fnRenderTeamsContactCollabOptions");
 		var removeUnsupportedColumnsToExport = testableHelper.testable(removeUnsupportedColumnsToExport, "removeUnsupportedColumnsToExport");
 		var fnAddMultiEditFieldGroupProperties = testableHelper.testable(fnAddMultiEditFieldGroupProperties,"fnAddMultiEditFieldGroupProperties");
+		var fnHideTableCells = testableHelper.testable(fnHideTableCells, "fnHideTableCells");
+		var fnApplyCellHiddenBindings = testableHelper.testable(fnApplyCellHiddenBindings, "fnApplyCellHiddenBindings");
+		var fnAttachRowsUpdateHandler = testableHelper.testable(fnAttachRowsUpdateHandler, "fnAttachRowsUpdateHandler");
+		var fnHandleTableCellVisibility = testableHelper.testable(fnHandleTableCellVisibility, "fnHandleTableCellVisibility");
 		/* eslint-enable */
 
 		return {

package/src/sap/suite/ui/generic/template/lib/ai/EasyFill/EasyFillAIOrchestrator.js

@@ -0,0 +1,216 @@
+sap.ui.define([
+    "sap/suite/ui/generic/template/genericUtilities/FeLogger",
+    "sap/suite/ui/generic/template/genericUtilities/FeError"
+], function(FeLogger, FeError) {
+    "use strict";
+
+    var sClassName = "lib.ai.EasyFill.EasyFillAIOrchestrator";
+    var oLogger = new FeLogger(sClassName).getLogger();
+
+    /**
+     * EasyFillAIOrchestrator
+     *
+     * Responsible for:
+     * 1. Submitting user input text to the AI (LLM) service and returning parsed results.
+     * 2. Post-processing the AI response: date conversion, splitting simple vs. collection fields.
+     * 3. Building the complete field mapping payload (entity fields + collection fields) to send to the LLM.
+     *
+     * This module contains no UI logic — it only bridges the user input and AI service.
+     * All UI state updates after the AI call are handled by the caller (EasyFillHandler / EasyFillDialogController).
+     */
+    return {
+
+        /**
+         * Builds the complete LLM field mapping by combining main entity fields and collection (table) fields.
+         * Delegates to EasyFillFieldCollector for the actual metadata extraction.
+         *
+         * @param {object} oTemplateUtils - FE template utilities (used for entity type lookup)
+         * @param {object} oController - MVC controller instance
+         * @param {object} oObjectPage - the ObjectPage control
+         * @param {object} oObjectPageModel - the OData model of the ObjectPage
+         * @param {object} oObjectPageContext - current ObjectPage binding context
+         * @param {object} oFieldCollector - EasyFillFieldCollector instance
+         * @param {object} mCollectionState - mutable collection state object (passed into appendCollectionMap)
+         * @returns {object} mFieldMapping — flat map of all fields to send to the LLM
+         */
+        buildFieldMapping: function(oTemplateUtils, oController, oObjectPage, oObjectPageModel, oObjectPageContext, oFieldCollector, mCollectionState) {
+            var oEntityType = oTemplateUtils.oCommonUtils.getMetaModelEntityType(
+                oController.getOwnerComponent().getEntitySet()
+            );
+
+            /**
+             * Resolves the display label for an OData property.
+             * Prefers the Common.Label annotation, falls back to sap:label attribute.
+             *
+             * @param {object} oProperty - OData property metadata
+             * @returns {string} label string
+             */
+            var fnGetLabel = function(oProperty) {
+                if (oProperty["com.sap.vocabularies.Common.v1.Label"]) {
+                    // Use the annotation helper to format the label expression
+                    try {
+                        var AnnotationHelperModel = sap.ui.require("sap/ui/model/odata/AnnotationHelper");
+                        if (AnnotationHelperModel) {
+                            return AnnotationHelperModel.format(oObjectPageContext, oProperty["com.sap.vocabularies.Common.v1.Label"]);
+                        }
+                    } catch (e) {
+                        oLogger.warning("buildFieldMapping: could not format annotation label for " + oProperty.name);
+                    }
+                }
+                return oProperty["sap:label"] || oProperty.name;
+            };
+
+            // Build entity set field map (simple fields)
+            var mFieldMapping = oFieldCollector.getEntitySetMap(oEntityType, oObjectPageContext, fnGetLabel);
+
+            // Append collection (SmartTable) fields and update collection state tracking maps
+            oFieldCollector.appendCollectionMap(
+                mFieldMapping,
+                oObjectPage,
+                oObjectPageModel,
+                oTemplateUtils,
+                mCollectionState,
+                fnGetLabel
+            );
+
+            return mFieldMapping;
+        },
+
+        /**
+         * Sends the user's free-text input to the AI service and returns the structured result.
+         * The AI service is accessed via oTemplateUtils.oServices.oFioriAIHandler.
+         *
+         * @param {string} sInputText - the user's free-text input from the EasyFill textarea
+         * @param {object} mFieldMapping - the complete field mapping built by buildFieldMapping()
+         * @param {object} oTemplateUtils - FE template utilities (used to access oFioriAIHandler)
+         * @returns {Promise<object>} AI service result: { success: boolean, data: object }
+         */
+        submitToAI: async function(sInputText, mFieldMapping, oTemplateUtils) {
+            oLogger.debug("submitToAI: sending input to AI service");
+            try {
+                var aiCallResult = await oTemplateUtils.oServices.oFioriAIHandler.fioriaiLib.EasyFill.extractFieldValuesFromText(
+                    sInputText,
+                    mFieldMapping
+                );
+                return aiCallResult;
+            } catch (e) {
+                oLogger.error("submitToAI: AI call failed: " + (e && e.message));
+                return { success: false, data: {} };
+            }
+        },
+
+        /**
+         * Converts date-like string values in the AI response to JavaScript Date objects,
+         * based on the OData data type declared in the field mapping.
+         * Handles Edm.DateTimeOffset and Edm.DateTime types.
+         *
+         * @param {object} aiCallResult - the raw AI service result ({ success, data })
+         * @param {object} mFieldMapping - the field mapping used during the AI call
+         */
+        formatDateValues: function(aiCallResult, mFieldMapping) {
+            if (!aiCallResult || !aiCallResult.success || !aiCallResult.data) {
+                return;
+            }
+            Object.keys(aiCallResult.data).forEach(function(sKey) {
+                var oFieldMeta = mFieldMapping[sKey];
+                if (!oFieldMeta) { return; }
+                var sDataType = oFieldMeta.dataType;
+                if (sDataType === "Edm.DateTimeOffset" || sDataType === "Edm.DateTime") {
+                    var vValue = aiCallResult.data[sKey];
+                    if (vValue && typeof vValue === "string") {
+                        aiCallResult.data[sKey] = new Date(vValue);
+                        oLogger.debug("formatDateValues: converted field '" + sKey + "' to Date");
+                    }
+                }
+            });
+        },
+
+        /**
+         * Splits the flat AI response data into two buckets:
+         * - simpleFields: scalar field values for the main entity (SmartForm fields)
+         * - collectionFields: row-level updates for SmartTable collections
+         *
+         * Collection fields are identified by the isCollection flag in the field mapping.
+         * For tables that allow creation (mCollectionState.mCollectionAllowsCreation), rows
+         * without _rowIndex or _contextPath are treated as new rows to be created.
+         * Only one new row per table is supported; extra new rows are flagged via multipleNewRows.
+         * Tables where the AI proposed new rows but creation is not allowed are tracked in
+         * collectionsWithRejectedNewRows so the renderer can show a per-table warning strip.
+         *
+         * @param {object} oAiData - the AI response data map { fieldName: value | rowArray }
+         * @param {object} mFieldMapping - the complete field mapping
+         * @param {object} oFieldCollector - EasyFillFieldCollector (used for SmartTable validation)
+         * @param {object} oObjectPage - the ObjectPage control (used for SmartTable validation)
+         * @param {object} mCollectionState - collection tracking state (used for allowsCreation check)
+         * @returns {{ simpleFields: object, collectionFields: object, attemptedMultipleNewRows: boolean, collectionsWithRejectedNewRows: object }}
+         */
+        splitAIResultByCollection: function(oAiData, mFieldMapping, oFieldCollector, oObjectPage, mCollectionState) {
+            var oSplitResult = {
+                simpleFields: {},
+                collectionFields: {},
+                attemptedMultipleNewRows: false,
+                // Map of { navProperty: "all" | "mixed" } for tables where AI proposed new rows
+                // but creation is not allowed. "all" = only new rows proposed; "mixed" = some
+                // existing updates + some rejected new rows.
+                collectionsWithRejectedNewRows: {}
+            };
+
+            Object.keys(oAiData || {}).forEach(function(sFieldName) {
+                var oFieldMeta = mFieldMapping[sFieldName];
+                var vFieldValue = oAiData[sFieldName];
+
+                // Determine if this field value is a collection (array of row updates)
+                var aCollectionRows = null;
+                if (Array.isArray(vFieldValue)) {
+                    aCollectionRows = vFieldValue;
+                } else if (vFieldValue && Array.isArray(vFieldValue.rows)) {
+                    aCollectionRows = vFieldValue.rows;
+                }
+
+                if (oFieldMeta && oFieldMeta.isCollection === true && aCollectionRows) {
+                    var bAllowsCreation = !!(mCollectionState && mCollectionState.mCollectionAllowsCreation &&
+                        mCollectionState.mCollectionAllowsCreation[sFieldName]);
+
+                    // Separate existing-row updates (have _rowIndex or _contextPath) from new rows
+                    var aExistingRowUpdates = aCollectionRows.filter(function(oRow) {
+                        return oRow && typeof oRow === "object" &&
+                            (typeof oRow._contextPath === "string" || typeof oRow._rowIndex === "number");
+                    });
+                    var aRawNewRows = aCollectionRows.filter(function(oRow) {
+                        return oRow && typeof oRow === "object" &&
+                            typeof oRow._contextPath !== "string" &&
+                            typeof oRow._rowIndex !== "number";
+                    });
+
+                    // Track tables where AI proposed new rows that cannot be created
+                    if (!bAllowsCreation && aRawNewRows.length > 0) {
+                        var sRejectionType = aExistingRowUpdates.length === 0 ? "all" : "mixed";
+                        oSplitResult.collectionsWithRejectedNewRows[sFieldName] = sRejectionType;
+                    }
+
+                    var aNewRows = bAllowsCreation ? aRawNewRows : [];
+
+                    // Cap new rows to one per table; flag if the AI proposed more
+                    if (aNewRows.length > 1) {
+                        oSplitResult.attemptedMultipleNewRows = true;
+                        aNewRows = [aNewRows[0]];
+                    }
+
+                    var aRowUpdates = aExistingRowUpdates.concat(aNewRows);
+
+                    var oValidation = oFieldCollector.isValidSmartTable(oFieldMeta.entitySet, oObjectPage);
+                    if (aRowUpdates.length > 0 && oValidation.isValid) {
+                        oSplitResult.collectionFields[sFieldName] = aRowUpdates;
+                        oLogger.debug("splitAIResultByCollection: accepted collection field '" + sFieldName + "' with " +
+                            aExistingRowUpdates.length + " updates and " + aNewRows.length + " new row(s)");
+                    }
+                } else {
+                    // Scalar field → goes to simpleFields
+                    oSplitResult.simpleFields[sFieldName] = vFieldValue;
+                }
+            });
+
+            return oSplitResult;
+        }
+    };
+});