@siliconst/metaui 1.2.0 → 1.4.5

package/src/nz/co/siliconst/ui5/metaui/core/ConditionEngine.ts

@@ -3,15 +3,35 @@
  * @description Evaluates dynamic rules to alter the schema in real-time.
  */
 
-import { EventBus } from "./EventBus";
+import { IPlugin } from "../interfaces/IPlugin";
 import { ISchema } from "../interfaces/ISchema";
-import { IFieldChangeEvent } from "../interfaces/IEventBus";
+import { Registry } from "./Registry";
+
+export type ConditionOperator = (a: any, b: any) => boolean;
+
+export const OperatorRegistry = new Registry<ConditionOperator>("Operators");
+
+// Register basic default operators
+OperatorRegistry.register("==", (a, b) => a == b);
+OperatorRegistry.register("===", (a, b) => a === b);
+OperatorRegistry.register("!=", (a, b) => a != b);
+OperatorRegistry.register("!==", (a, b) => a !== b);
+OperatorRegistry.register(">", (a, b) => a > b);
+OperatorRegistry.register("<", (a, b) => a < b);
+OperatorRegistry.register(">=", (a, b) => a >= b);
+OperatorRegistry.register("<=", (a, b) => a <= b);
 
 /**
- * Engine that listens to the EventBus and evaluates cross-field dependencies.
+ * Engine that listens to the EventBus and evaluates cross-field dependencies (e.g. visibleOn, enabledOn).
+ * It delegates actual evaluations to the configurable `OperatorRegistry`.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.core
+ * @public
  */
 export class ConditionEngine {
+    /** The active form schema being evaluated. */
     private schema: ISchema;
+    /** The cached bound event handler reference for strict garbage collection. */
     private boundHandler: (event: IFieldChangeEvent) => void;
 
     /**
@@ -20,30 +40,36 @@ export class ConditionEngine {
      */
     constructor(schema: ISchema) {
         this.schema = schema;
-        this.boundHandler = this.handleEvent.bind(this);
-        this.initializeListeners();
     }
 
+
+
+    /** Internal map tracking active plugins against their binding paths for real-time state updates. */
+    private plugins: Map<string, IPlugin> = new Map();
+
     /**
-     * Subscribes to the EventBus for real-time field change interception.
+     * Internal handler to evaluate business rules when a field is updated.
+     * @param fieldKey The key of the field that was changed
+     * @param isValid Whether the field is currently valid
      */
-    private initializeListeners(): void {
-        EventBus.getInstance().subscribe(this.boundHandler);
+    public handleEvent(fieldKey: string, isValid: boolean): void {
+        // Evaluate conditions via registered operators if a rule system is added later
     }
 
     /**
-     * Internal handler to evaluate business rules when a field is updated.
-     * @param event The structured change event.
+     * Registers a rendered plugin so the condition engine can push dynamic state updates to it.
+     * 
+     * @param bindingPath The JSON path representing the field within the payload.
+     * @param plugin The instantiated plugin handling the field.
      */
-    private handleEvent(event: IFieldChangeEvent): void {
-        // Architecture hook: Logic to evaluate conditions against the schema 
-        // and update plugin properties will be injected here in later phases.
+    public registerPlugin(bindingPath: string, plugin: IPlugin): void {
+        this.plugins.set(bindingPath, plugin);
     }
 
     /**
-     * Cleans up EventBus listeners to prevent memory leaks on destruction.
+     * Cleans up listeners to prevent memory leaks on destruction.
      */
     public destroy(): void {
-        EventBus.getInstance().unsubscribe(this.boundHandler);
+        this.plugins.clear();
     }
 }

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator-dbg.js

@@ -0,0 +1,78 @@
+sap.ui.define([], function () {
+  "use strict";
+
+  /**
+   * @file DefaultLayoutGenerator.ts
+   * @description Automatically synthesizes a default UI layout for schemas that lack an explicit mapping.
+   */
+
+  /**
+   * Encapsulates the logic to dynamically build a safe, default layout orchestration
+   * when the developer or backend fails to provide an explicit `uiLayout`.
+   * 
+   * By elevating this into a dedicated utility, we avoid polluting layout engines
+   * (like FormLayout or TableLayout) with structural inference responsibilities.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.core
+   * @public
+   */
+  class DefaultLayoutGenerator {
+    /**
+     * Inspects a schema. If it has properties but no `uiLayout`, it synthesizes a default.
+     * @param schema The ISchema dictionary.
+     * @returns boolean True if a layout was synthesized, false if it already existed or was empty.
+     */
+    static ensureLayout(schema) {
+      // If it already has a valid array, do nothing
+      if (schema.uiLayout && Array.isArray(schema.uiLayout) && schema.uiLayout.length > 0) {
+        return false;
+      }
+      const isArray = schema.type === "array";
+      const props = isArray ? schema.items?.properties : schema.properties;
+      if (!props || Object.keys(props).length === 0) {
+        return false; // Nothing to map
+      }
+      const elements = this.generateElementsFromProperties(props, "#/properties");
+      if (isArray) {
+        // Table layouts expect an array of flat Controls at the root uiLayout
+        // For tables, we flatten the deep elements or just render the root level
+        // To keep it safe, we'll just use the flat elements for tables
+        schema.uiLayout = elements.filter(e => e.type === "Control");
+      } else {
+        // Form layouts expect a grouped structure
+        schema.uiLayout = [{
+          type: "Group",
+          label: schema.title,
+          elements: elements
+        }];
+      }
+      return true;
+    }
+    static generateElementsFromProperties(props, basePath) {
+      const elements = [];
+      for (const key of Object.keys(props)) {
+        const prop = props[key];
+        const currentPath = `${basePath}/${key}`;
+        if (prop.type === "object" && prop.properties) {
+          elements.push({
+            type: "Group",
+            label: prop.ui?.label || key,
+            elements: this.generateElementsFromProperties(prop.properties, `${currentPath}/properties`)
+          });
+        } else {
+          elements.push({
+            type: "Control",
+            scope: currentPath
+          });
+        }
+      }
+      return elements;
+    }
+  }
+  var __exports = {
+    __esModule: true
+  };
+  __exports.DefaultLayoutGenerator = DefaultLayoutGenerator;
+  return __exports;
+});
+//# sourceMappingURL=DefaultLayoutGenerator-dbg.js.map

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator-dbg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultLayoutGenerator-dbg.js","names":["DefaultLayoutGenerator","ensureLayout","schema","uiLayout","Array","isArray","length","type","props","items","properties","Object","keys","elements","generateElementsFromProperties","filter","e","label","title","basePath","key","prop","currentPath","push","ui","scope","__exports","__esModule"],"sources":["DefaultLayoutGenerator.ts"],"sourcesContent":["/**\n * @file DefaultLayoutGenerator.ts\n * @description Automatically synthesizes a default UI layout for schemas that lack an explicit mapping.\n */\n\nimport { ISchema, ILayoutElement } from \"../interfaces/ISchema\";\n\n/**\n * Encapsulates the logic to dynamically build a safe, default layout orchestration\n * when the developer or backend fails to provide an explicit `uiLayout`.\n * \n * By elevating this into a dedicated utility, we avoid polluting layout engines\n * (like FormLayout or TableLayout) with structural inference responsibilities.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class DefaultLayoutGenerator {\n    /**\n     * Inspects a schema. If it has properties but no `uiLayout`, it synthesizes a default.\n     * @param schema The ISchema dictionary.\n     * @returns boolean True if a layout was synthesized, false if it already existed or was empty.\n     */\n    public static ensureLayout(schema: ISchema): boolean {\n        // If it already has a valid array, do nothing\n        if (schema.uiLayout && Array.isArray(schema.uiLayout) && schema.uiLayout.length > 0) {\n            return false;\n        }\n\n        const isArray = schema.type === \"array\";\n        const props = isArray ? schema.items?.properties : schema.properties;\n\n        if (!props || Object.keys(props).length === 0) {\n            return false; // Nothing to map\n        }\n\n        const elements = this.generateElementsFromProperties(props, \"#/properties\");\n\n        if (isArray) {\n            // Table layouts expect an array of flat Controls at the root uiLayout\n            // For tables, we flatten the deep elements or just render the root level\n            // To keep it safe, we'll just use the flat elements for tables\n            schema.uiLayout = elements.filter(e => e.type === \"Control\");\n        } else {\n            // Form layouts expect a grouped structure\n            schema.uiLayout = [\n                {\n                    type: \"Group\",\n                    label: schema.title,\n                    elements: elements\n                }\n            ];\n        }\n\n        return true;\n    }\n\n    private static generateElementsFromProperties(props: any, basePath: string): ILayoutElement[] {\n        const elements: ILayoutElement[] = [];\n        for (const key of Object.keys(props)) {\n            const prop = props[key];\n            const currentPath = `${basePath}/${key}`;\n\n            if (prop.type === \"object\" && prop.properties) {\n                elements.push({\n                    type: \"Group\",\n                    label: prop.ui?.label || key,\n                    elements: this.generateElementsFromProperties(prop.properties, `${currentPath}/properties`)\n                });\n            } else {\n                elements.push({\n                    type: \"Control\",\n                    scope: currentPath\n                });\n            }\n        }\n        return elements;\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;;EAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMA,sBAAsB,CAAC;IAChC;AACJ;AACA;AACA;AACA;IACI,OAAcC,YAAYA,CAACC,MAAe,EAAW;MACjD;MACA,IAAIA,MAAM,CAACC,QAAQ,IAAIC,KAAK,CAACC,OAAO,CAACH,MAAM,CAACC,QAAQ,CAAC,IAAID,MAAM,CAACC,QAAQ,CAACG,MAAM,GAAG,CAAC,EAAE;QACjF,OAAO,KAAK;MAChB;MAEA,MAAMD,OAAO,GAAGH,MAAM,CAACK,IAAI,KAAK,OAAO;MACvC,MAAMC,KAAK,GAAGH,OAAO,GAAGH,MAAM,CAACO,KAAK,EAAEC,UAAU,GAAGR,MAAM,CAACQ,UAAU;MAEpE,IAAI,CAACF,KAAK,IAAIG,MAAM,CAACC,IAAI,CAACJ,KAAK,CAAC,CAACF,MAAM,KAAK,CAAC,EAAE;QAC3C,OAAO,KAAK,CAAC,CAAC;MAClB;MAEA,MAAMO,QAAQ,GAAG,IAAI,CAACC,8BAA8B,CAACN,KAAK,EAAE,cAAc,CAAC;MAE3E,IAAIH,OAAO,EAAE;QACT;QACA;QACA;QACAH,MAAM,CAACC,QAAQ,GAAGU,QAAQ,CAACE,MAAM,CAACC,CAAC,IAAIA,CAAC,CAACT,IAAI,KAAK,SAAS,CAAC;MAChE,CAAC,MAAM;QACH;QACAL,MAAM,CAACC,QAAQ,GAAG,CACd;UACII,IAAI,EAAE,OAAO;UACbU,KAAK,EAAEf,MAAM,CAACgB,KAAK;UACnBL,QAAQ,EAAEA;QACd,CAAC,CACJ;MACL;MAEA,OAAO,IAAI;IACf;IAEA,OAAeC,8BAA8BA,CAACN,KAAU,EAAEW,QAAgB,EAAoB;MAC1F,MAAMN,QAA0B,GAAG,EAAE;MACrC,KAAK,MAAMO,GAAG,IAAIT,MAAM,CAACC,IAAI,CAACJ,KAAK,CAAC,EAAE;QAClC,MAAMa,IAAI,GAAGb,KAAK,CAACY,GAAG,CAAC;QACvB,MAAME,WAAW,GAAG,GAAGH,QAAQ,IAAIC,GAAG,EAAE;QAExC,IAAIC,IAAI,CAACd,IAAI,KAAK,QAAQ,IAAIc,IAAI,CAACX,UAAU,EAAE;UAC3CG,QAAQ,CAACU,IAAI,CAAC;YACVhB,IAAI,EAAE,OAAO;YACbU,KAAK,EAAEI,IAAI,CAACG,EAAE,EAAEP,KAAK,IAAIG,GAAG;YAC5BP,QAAQ,EAAE,IAAI,CAACC,8BAA8B,CAACO,IAAI,CAACX,UAAU,EAAE,GAAGY,WAAW,aAAa;UAC9F,CAAC,CAAC;QACN,CAAC,MAAM;UACHT,QAAQ,CAACU,IAAI,CAAC;YACVhB,IAAI,EAAE,SAAS;YACfkB,KAAK,EAAEH;UACX,CAAC,CAAC;QACN;MACJ;MACA,OAAOT,QAAQ;IACnB;EACJ;EAAC,IAAAa,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAA1B,sBAAA,GAAAA,sBAAA;EAAA,OAAA0B,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator.d.ts

@@ -0,0 +1,27 @@
+declare module "nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator" {
+    /**
+     * @file DefaultLayoutGenerator.ts
+     * @description Automatically synthesizes a default UI layout for schemas that lack an explicit mapping.
+     */
+    import { ISchema } from "nz/co/siliconst/ui5/metaui/interfaces/ISchema";
+    /**
+     * Encapsulates the logic to dynamically build a safe, default layout orchestration
+     * when the developer or backend fails to provide an explicit `uiLayout`.
+     *
+     * By elevating this into a dedicated utility, we avoid polluting layout engines
+     * (like FormLayout or TableLayout) with structural inference responsibilities.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.core
+     * @public
+     */
+    export class DefaultLayoutGenerator {
+        /**
+         * Inspects a schema. If it has properties but no `uiLayout`, it synthesizes a default.
+         * @param schema The ISchema dictionary.
+         * @returns boolean True if a layout was synthesized, false if it already existed or was empty.
+         */
+        static ensureLayout(schema: ISchema): boolean;
+        private static generateElementsFromProperties;
+    }
+}
+//# sourceMappingURL=DefaultLayoutGenerator.d.ts.map

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultLayoutGenerator.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,wDAAwD,CAAC;IACxE;;;OAGG;IAEH,OAAO,EAAE,OAAO,EAAkB,MAAM,+CAA+C,CAAC;IAExF;;;;;;;;;OASG;IACH,MAAa,sBAAsB;QAC/B;;;;WAIG;eACW,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;QAkCpD,OAAO,CAAC,MAAM,CAAC,8BAA8B;KAqBhD;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator.js

@@ -0,0 +1,2 @@
+sap.ui.define([],function(){"use strict";class e{static ensureLayout(e){if(e.uiLayout&&Array.isArray(e.uiLayout)&&e.uiLayout.length>0){return false}const t=e.type==="array";const r=t?e.items?.properties:e.properties;if(!r||Object.keys(r).length===0){return false}const s=this.generateElementsFromProperties(r,"#/properties");if(t){e.uiLayout=s.filter(e=>e.type==="Control")}else{e.uiLayout=[{type:"Group",label:e.title,elements:s}]}return true}static generateElementsFromProperties(e,t){const r=[];for(const s of Object.keys(e)){const o=e[s];const i=`${t}/${s}`;if(o.type==="object"&&o.properties){r.push({type:"Group",label:o.ui?.label||s,elements:this.generateElementsFromProperties(o.properties,`${i}/properties`)})}else{r.push({type:"Control",scope:i})}}return r}}var t={__esModule:true};t.DefaultLayoutGenerator=e;return t});
+//# sourceMappingURL=DefaultLayoutGenerator.js.map

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultLayoutGenerator.js","names":["DefaultLayoutGenerator","ensureLayout","schema","uiLayout","Array","isArray","length","type","props","items","properties","Object","keys","elements","this","generateElementsFromProperties","filter","e","label","title","basePath","key","prop","currentPath","push","ui","scope","__exports","__esModule"],"sources":["DefaultLayoutGenerator.ts"],"sourcesContent":["/**\n * @file DefaultLayoutGenerator.ts\n * @description Automatically synthesizes a default UI layout for schemas that lack an explicit mapping.\n */\n\nimport { ISchema, ILayoutElement } from \"../interfaces/ISchema\";\n\n/**\n * Encapsulates the logic to dynamically build a safe, default layout orchestration\n * when the developer or backend fails to provide an explicit `uiLayout`.\n * \n * By elevating this into a dedicated utility, we avoid polluting layout engines\n * (like FormLayout or TableLayout) with structural inference responsibilities.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class DefaultLayoutGenerator {\n    /**\n     * Inspects a schema. If it has properties but no `uiLayout`, it synthesizes a default.\n     * @param schema The ISchema dictionary.\n     * @returns boolean True if a layout was synthesized, false if it already existed or was empty.\n     */\n    public static ensureLayout(schema: ISchema): boolean {\n        // If it already has a valid array, do nothing\n        if (schema.uiLayout && Array.isArray(schema.uiLayout) && schema.uiLayout.length > 0) {\n            return false;\n        }\n\n        const isArray = schema.type === \"array\";\n        const props = isArray ? schema.items?.properties : schema.properties;\n\n        if (!props || Object.keys(props).length === 0) {\n            return false; // Nothing to map\n        }\n\n        const elements = this.generateElementsFromProperties(props, \"#/properties\");\n\n        if (isArray) {\n            // Table layouts expect an array of flat Controls at the root uiLayout\n            // For tables, we flatten the deep elements or just render the root level\n            // To keep it safe, we'll just use the flat elements for tables\n            schema.uiLayout = elements.filter(e => e.type === \"Control\");\n        } else {\n            // Form layouts expect a grouped structure\n            schema.uiLayout = [\n                {\n                    type: \"Group\",\n                    label: schema.title,\n                    elements: elements\n                }\n            ];\n        }\n\n        return true;\n    }\n\n    private static generateElementsFromProperties(props: any, basePath: string): ILayoutElement[] {\n        const elements: ILayoutElement[] = [];\n        for (const key of Object.keys(props)) {\n            const prop = props[key];\n            const currentPath = `${basePath}/${key}`;\n\n            if (prop.type === \"object\" && prop.properties) {\n                elements.push({\n                    type: \"Group\",\n                    label: prop.ui?.label || key,\n                    elements: this.generateElementsFromProperties(prop.properties, `${currentPath}/properties`)\n                });\n            } else {\n                elements.push({\n                    type: \"Control\",\n                    scope: currentPath\n                });\n            }\n        }\n        return elements;\n    }\n}\n"],"mappings":"yCAiBO,MAAMA,EAMT,mBAAcC,CAAaC,GAEvB,GAAIA,EAAOC,UAAYC,MAAMC,QAAQH,EAAOC,WAAaD,EAAOC,SAASG,OAAS,EAAG,CACjF,OAAO,KACX,CAEA,MAAMD,EAAUH,EAAOK,OAAS,QAChC,MAAMC,EAAQH,EAAUH,EAAOO,OAAOC,WAAaR,EAAOQ,WAE1D,IAAKF,GAASG,OAAOC,KAAKJ,GAAOF,SAAW,EAAG,CAC3C,OAAO,KACX,CAEA,MAAMO,EAAWC,KAAKC,+BAA+BP,EAAO,gBAE5D,GAAIH,EAAS,CAITH,EAAOC,SAAWU,EAASG,OAAOC,GAAKA,EAAEV,OAAS,UACtD,KAAO,CAEHL,EAAOC,SAAW,CACd,CACII,KAAM,QACNW,MAAOhB,EAAOiB,MACdN,SAAUA,GAGtB,CAEA,OAAO,IACX,CAEA,qCAAeE,CAA+BP,EAAYY,GACtD,MAAMP,EAA6B,GACnC,IAAK,MAAMQ,KAAOV,OAAOC,KAAKJ,GAAQ,CAClC,MAAMc,EAAOd,EAAMa,GACnB,MAAME,EAAc,GAAGH,KAAYC,IAEnC,GAAIC,EAAKf,OAAS,UAAYe,EAAKZ,WAAY,CAC3CG,EAASW,KAAK,CACVjB,KAAM,QACNW,MAAOI,EAAKG,IAAIP,OAASG,EACzBR,SAAUC,KAAKC,+BAA+BO,EAAKZ,WAAY,GAAGa,iBAE1E,KAAO,CACHV,EAASW,KAAK,CACVjB,KAAM,UACNmB,MAAOH,GAEf,CACJ,CACA,OAAOV,CACX,EACH,IAAAc,EAAA,CAAAC,WAAA,MAAAD,EAAA3B,yBAAA,OAAA2B,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/core/DefaultLayoutGenerator.ts

@@ -0,0 +1,79 @@
+/**
+ * @file DefaultLayoutGenerator.ts
+ * @description Automatically synthesizes a default UI layout for schemas that lack an explicit mapping.
+ */
+
+import { ISchema, ILayoutElement } from "../interfaces/ISchema";
+
+/**
+ * Encapsulates the logic to dynamically build a safe, default layout orchestration
+ * when the developer or backend fails to provide an explicit `uiLayout`.
+ * 
+ * By elevating this into a dedicated utility, we avoid polluting layout engines
+ * (like FormLayout or TableLayout) with structural inference responsibilities.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.core
+ * @public
+ */
+export class DefaultLayoutGenerator {
+    /**
+     * Inspects a schema. If it has properties but no `uiLayout`, it synthesizes a default.
+     * @param schema The ISchema dictionary.
+     * @returns boolean True if a layout was synthesized, false if it already existed or was empty.
+     */
+    public static ensureLayout(schema: ISchema): boolean {
+        // If it already has a valid array, do nothing
+        if (schema.uiLayout && Array.isArray(schema.uiLayout) && schema.uiLayout.length > 0) {
+            return false;
+        }
+
+        const isArray = schema.type === "array";
+        const props = isArray ? schema.items?.properties : schema.properties;
+
+        if (!props || Object.keys(props).length === 0) {
+            return false; // Nothing to map
+        }
+
+        const elements = this.generateElementsFromProperties(props, "#/properties");
+
+        if (isArray) {
+            // Table layouts expect an array of flat Controls at the root uiLayout
+            // For tables, we flatten the deep elements or just render the root level
+            // To keep it safe, we'll just use the flat elements for tables
+            schema.uiLayout = elements.filter(e => e.type === "Control");
+        } else {
+            // Form layouts expect a grouped structure
+            schema.uiLayout = [
+                {
+                    type: "Group",
+                    label: schema.title,
+                    elements: elements
+                }
+            ];
+        }
+
+        return true;
+    }
+
+    private static generateElementsFromProperties(props: any, basePath: string): ILayoutElement[] {
+        const elements: ILayoutElement[] = [];
+        for (const key of Object.keys(props)) {
+            const prop = props[key];
+            const currentPath = `${basePath}/${key}`;
+
+            if (prop.type === "object" && prop.properties) {
+                elements.push({
+                    type: "Group",
+                    label: prop.ui?.label || key,
+                    elements: this.generateElementsFromProperties(prop.properties, `${currentPath}/properties`)
+                });
+            } else {
+                elements.push({
+                    type: "Control",
+                    scope: currentPath
+                });
+            }
+        }
+        return elements;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/core/Engine-dbg.js

@@ -1,4 +1,4 @@
-sap.ui.define(["./ConditionEngine", "sap/m/VBox"], function (___ConditionEngine, VBox) {
+sap.ui.define(["./ConditionEngine", "./PluginRegistry", "sap/m/Text", "../utils/Logger", "./DefaultLayoutGenerator", "sap/ui/core/Messaging"], function (___ConditionEngine, ___PluginRegistry, Text, ___utils_Logger, ___DefaultLayoutGenerator, Messaging) {
   "use strict";
 
   /**
@@ -6,70 +6,186 @@ sap.ui.define(["./ConditionEngine", "sap/m/VBox"], function (___ConditionEngine,
    * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).
    */
   const ConditionEngine = ___ConditionEngine["ConditionEngine"];
+  const PluginRegistry = ___PluginRegistry["PluginRegistry"];
+  const Logger = ___utils_Logger["Logger"];
+  const DefaultLayoutGenerator = ___DefaultLayoutGenerator["DefaultLayoutGenerator"];
+  /**
+   * The Engine is responsible for translating a normalized schema into a physical UI5 layout.
+   * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.
+   * It is NOT a God Class; it strictly routes execution flow and tracks active plugins for validation.
+   * It embodies the "Plugin-First Philosophy" by routing all complex field and layout rendering
+   * through discrete, decoupled plugins rather than handling native overrides.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.core
+   * @public
+   */
   class Engine {
+    /** Global registry of all available layout strategies (e.g. Form, Table, Wizard). */
+
+    /** Handles dynamic conditional logic across the active form. */
     conditionEngine = null;
+
+    /** Array of all instantiated plugins generated during the current build. */
     activePlugins = [];
-    build(schema, layoutManager, modelName = "meta") {
+
+    /** Deterministic scope ID injected by the host control to prevent clone collisions. */
+
+    /** Tracks whether the entire engine is running in Read-Only Display mode. */
+    isDisplayMode = false;
+    constructor(displayMode = false) {
+      this.isDisplayMode = displayMode;
+    }
+
+    /**
+     * Bootstraps the layout generation process by resolving the correct layout strategy.
+     * 
+     * @param schema The normalized JSON schema representing the view.
+     * @param model The active StateManager JSONModel instance.
+     * @param modelName The UI5 model alias used for isolation.
+     * @param onSubmit Callback fired when form is submitted.
+     * @param engineScopeId Deterministic scope ID for this engine instance.
+     * @param onChange Callback fired when field values change.
+     * @returns The generated root UI5 Control container.
+     */
+    build(schema, model, modelName = "meta", onSubmit, engineScopeId, onChange) {
       this.conditionEngine = new ConditionEngine(schema);
       this.activePlugins = [];
-      const trackPlugin = plugin => this.activePlugins.push(plugin);
-
-      // Implicit layout routing based on root type
-      if (schema.type === "array") {
-        if (!schema.items) {
-          throw new Error("[MetaUI] Array schema must define 'items'.");
+      this.activeModel = model;
+      this.engineScopeId = engineScopeId;
+      this.onChange = (isValid, fieldKey, errorMessage, controlId) => {
+        if (this.conditionEngine && fieldKey) {
+          this.conditionEngine.handleEvent(fieldKey, isValid);
         }
-        return layoutManager.renderTable(schema.items, `${modelName}>/`, schema.title);
-      }
-      if (schema.type === "object") {
-        const container = new VBox({
-          renderType: "Bare"
+        if (onChange) {
+          onChange(isValid, fieldKey, errorMessage, controlId);
+        }
+      };
+      try {
+        // Intercept and synthesize a default layout if the developer/backend failed to provide one
+        if (DefaultLayoutGenerator.ensureLayout(schema)) {
+          Logger.warn("[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.");
+        }
+        const layoutStrategy = schema.layoutStrategy || (schema.type === "array" ? "table" : "form");
+        const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);
+        return layoutManager.render(schema, modelName, this, onSubmit);
+      } catch (error) {
+        const msg = error.message;
+        Logger.error("[MetaUI Engine] Critical error during layout generation", msg);
+        Logger.showErrorPopup(`Engine failed to generate the layout.\n\nDetails: ${msg}`);
+        return new Text({
+          text: "Critical Layout Error"
         });
-        const props = schema.properties || {};
+      }
+    }
 
-        // Separate scalar properties (form fields) from root array properties (inline tables)
-        const formProps = {};
-        const tableProps = [];
-        for (const key of Object.keys(props)) {
-          if (props[key].type === "array") {
-            tableProps.push({
-              key,
-              meta: props[key]
-            });
-          } else {
-            formProps[key] = props[key];
-          }
+    /**
+     * Instantiates the correct plugin for a specific field based on type and widget hints,
+     * and tracks the plugin for global validation.
+     * 
+     * @param fieldMeta The metadata schema specific to the field.
+     * @param bindingPath The JSON path representing the field within the payload.
+     * @param modelName The UI5 JSONModel name used for data binding.
+     * @returns The generated UI5 Control for the field.
+     */
+    generateField(fieldMeta, bindingPath, modelName, isTemplate = false) {
+      try {
+        const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || "string", fieldMeta.ui?.widget);
+        plugin.setDisplayMode(this.isDisplayMode);
+        if (!isTemplate) {
+          this.activePlugins.push({
+            plugin,
+            path: bindingPath
+          });
         }
-
-        // Render the top-level form if there are scalar fields
-        if (Object.keys(formProps).length > 0) {
-          container.addItem(layoutManager.renderForm(formProps, modelName, schema.title, trackPlugin));
+        const scopeId = isTemplate ? undefined : this.engineScopeId;
+        const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange);
+        if (this.conditionEngine) {
+          this.conditionEngine.registerPlugin(bindingPath, plugin);
         }
+        return control;
+      } catch (error) {
+        const msg = error.message;
+        Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);
+        Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\n\nDetails: ${msg}`);
+        return new Text({
+          text: `[Error generating field ${bindingPath}]`
+        });
+      }
+    }
 
-        // Render root-level arrays as massive native tables below the form
-        for (const tableProp of tableProps) {
-          if (tableProp.meta.items) {
-            container.addItem(layoutManager.renderTable(tableProp.meta.items, `${modelName}>/${tableProp.key}`, tableProp.meta.ui?.label || tableProp.key));
-          }
-        }
-        return container;
+    /**
+     * Generates a sub-layout (like an embedded table or nested form) without 
+     * destroying the current Engine state or Condition tracking.
+     * 
+     * @param schema The normalized JSON schema representing the view.
+     * @param modelName The UI5 JSONModel name used for data binding (defaults to "meta").
+     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.
+     * @returns The generated root UI5 Control container.
+     */
+    generateLayout(schema, modelName, bindingPath) {
+      try {
+        const layoutStrategy = schema.layoutStrategy || (schema.type === "array" ? "table" : "form");
+        const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);
+        return layoutManager.render(schema, modelName, this, undefined, bindingPath);
+      } catch (error) {
+        const msg = error.message;
+        Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);
+        Logger.showErrorPopup(`Engine failed to generate a sub-layout.\n\nDetails: ${msg}`);
+        return new Text({
+          text: "Critical Sub-Layout Error"
+        });
       }
-      throw new Error(`[MetaUI] Unsupported schema type: ${schema.type}`);
     }
+
+    /**
+     * Iterates through all active plugins and triggers their internal validation pipelines.
+     * 
+     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.
+     */
     validateAll() {
-      let isValid = true;
-      for (const plugin of this.activePlugins) {
-        if (!plugin.validate()) {
-          isValid = false;
+      const errors = [];
+      for (const item of this.activePlugins) {
+        const result = item.plugin.validate();
+        if (!result.isValid) {
+          // Ensure the path is bound to the error so GeneratorHost knows where to target it
+          result.fieldKey = result.fieldKey || item.path.replace(/^\//, "");
+          errors.push(result);
+          // Add console log to find which plugin fails silently
+          Logger.error("[MetaUI Validation] Plugin failed validation silently:", item.path || item.plugin.constructor.name);
         }
       }
-      return isValid;
+      return errors;
     }
+
+    /**
+     * Cleans up internal state and destroys the condition engine to prevent memory leaks.
+     */
     destroy() {
       if (this.conditionEngine) {
         this.conditionEngine.destroy();
         this.conditionEngine = null;
       }
+
+      // ------------------------------------------------------------------------
+      // Ghost Error Prevention
+      // Flush MessageManager for active plugins before destroying their controls
+      // ------------------------------------------------------------------------
+      const messageManager = Messaging;
+      const existingMessages = messageManager.getMessageModel().getData();
+      const messagesToRemove = [];
+      for (const item of this.activePlugins) {
+        if (this.activeModel) {
+          const targetPath = `/${item.path.replace(/^\//, "")}`;
+          const matched = existingMessages.filter(msg => msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel.getId());
+          messagesToRemove.push(...matched);
+        }
+        if (typeof item.plugin.destroy === "function") {
+          item.plugin.destroy();
+        }
+      }
+      if (messagesToRemove.length > 0) {
+        messageManager.removeMessages(messagesToRemove);
+      }
       this.activePlugins = [];
     }
   }

package/src/nz/co/siliconst/ui5/metaui/core/Engine-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"Engine-dbg.js","names":["ConditionEngine","___ConditionEngine","Engine","conditionEngine","activePlugins","build","schema","layoutManager","modelName","trackPlugin","plugin","push","type","items","Error","renderTable","title","container","VBox","renderType","props","properties","formProps","tableProps","key","Object","keys","meta","length","addItem","renderForm","tableProp","ui","label","validateAll","isValid","validate","destroy","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\n\nexport class Engine {\n    private conditionEngine: ConditionEngine | null = null;\n    private activePlugins: IPlugin[] = [];\n    \n    public build(schema: ISchema, layoutManager: ILayoutManager, modelName: string = \"meta\"): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n\n        const trackPlugin = (plugin: IPlugin) => this.activePlugins.push(plugin);\n        \n        // Implicit layout routing based on root type\n        if (schema.type === \"array\") {\n            if (!schema.items) {\n                throw new Error(\"[MetaUI] Array schema must define 'items'.\");\n            }\n            return layoutManager.renderTable(schema.items, `${modelName}>/`, schema.title);\n        }\n        \n        if (schema.type === \"object\") {\n            const container = new VBox({ renderType: \"Bare\" });\n            const props = schema.properties || {};\n            \n            // Separate scalar properties (form fields) from root array properties (inline tables)\n            const formProps: Record<string, IPropertyMetadata> = {};\n            const tableProps: { key: string; meta: IPropertyMetadata }[] = [];\n            \n            for (const key of Object.keys(props)) {\n                if (props[key].type === \"array\") {\n                    tableProps.push({ key, meta: props[key] });\n                } else {\n                    formProps[key] = props[key];\n                }\n            }\n            \n            // Render the top-level form if there are scalar fields\n            if (Object.keys(formProps).length > 0) {\n                container.addItem(layoutManager.renderForm(formProps, modelName, schema.title, trackPlugin));\n            }\n            \n            // Render root-level arrays as massive native tables below the form\n            for (const tableProp of tableProps) {\n                if (tableProp.meta.items) {\n                    container.addItem(layoutManager.renderTable(tableProp.meta.items, `${modelName}>/${tableProp.key}`, tableProp.meta.ui?.label || tableProp.key));\n                }\n            }\n            \n            return container;\n        }\n        \n        throw new Error(`[MetaUI] Unsupported schema type: ${schema.type}`);\n    }\n\n    public validateAll(): boolean {\n        let isValid = true;\n        for (const plugin of this.activePlugins) {\n            if (!plugin.validate()) {\n                isValid = false;\n            }\n        }\n        return isValid;\n    }\n\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n        this.activePlugins = [];\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"Engine-dbg.js","names":["ConditionEngine","___ConditionEngine","PluginRegistry","___PluginRegistry","Logger","___utils_Logger","DefaultLayoutGenerator","___DefaultLayoutGenerator","Engine","conditionEngine","activePlugins","isDisplayMode","constructor","displayMode","build","schema","model","modelName","onSubmit","engineScopeId","onChange","activeModel","isValid","fieldKey","errorMessage","controlId","handleEvent","ensureLayout","warn","layoutStrategy","type","layoutManager","layoutRegistry","getStrict","render","error","msg","message","showErrorPopup","Text","text","generateField","fieldMeta","bindingPath","isTemplate","plugin","getInstance","getPlugin","ui","widget","setDisplayMode","push","path","scopeId","undefined","control","registerPlugin","generateLayout","validateAll","errors","item","result","validate","replace","name","destroy","messageManager","Messaging","existingMessages","getMessageModel","getData","messagesToRemove","targetPath","matched","filter","getTarget","getMessageProcessor","getId","length","removeMessages","__exports","__esModule"],"sources":["Engine.ts"],"sourcesContent":["/**\n * @file Engine.ts\n * @description The central orchestrator that routes data between the Layout Factory and Plugin Registry (v2).\n */\n\nimport { ISchema, IPropertyMetadata } from \"../interfaces/ISchema\";\nimport { ILayoutManager } from \"../interfaces/ILayoutManager\";\nimport { IPlugin, IPluginValidationResult } from \"../interfaces/IPlugin\";\nimport { ConditionEngine } from \"./ConditionEngine\";\nimport { PluginRegistry } from \"./PluginRegistry\";\nimport Control from \"sap/ui/core/Control\";\nimport VBox from \"sap/m/VBox\";\nimport Text from \"sap/m/Text\";\nimport { Registry } from \"./Registry\";\nimport { Logger } from \"../utils/Logger\";\nimport { DefaultLayoutGenerator } from \"./DefaultLayoutGenerator\";\nimport Core from \"sap/ui/core/Core\";\nimport Messaging from \"sap/ui/core/Messaging\";\n\n/**\n * The Engine is responsible for translating a normalized schema into a physical UI5 layout.\n * It delegates layout generation to the configured `LayoutManager` and field generation to the `PluginRegistry`.\n * It is NOT a God Class; it strictly routes execution flow and tracks active plugins for validation.\n * It embodies the \"Plugin-First Philosophy\" by routing all complex field and layout rendering\n * through discrete, decoupled plugins rather than handling native overrides.\n * \n * @namespace nz.co.siliconst.ui5.metaui.core\n * @public\n */\nexport class Engine {\n    /** Global registry of all available layout strategies (e.g. Form, Table, Wizard). */\n    public static layoutRegistry: Registry<ILayoutManager>;\n    /** Handles dynamic conditional logic across the active form. */\n    private conditionEngine: ConditionEngine | null = null;\n    \n    /** Array of all instantiated plugins generated during the current build. */\n    private activePlugins: { plugin: IPlugin, path: string }[] = [];\n\n    /** Deterministic scope ID injected by the host control to prevent clone collisions. */\n    public engineScopeId?: string;\n    \n    private activeModel?: sap.ui.model.Model;\n    \n    /** Tracks whether the entire engine is running in Read-Only Display mode. */\n    public readonly isDisplayMode: boolean = false;\n\n    constructor(displayMode: boolean = false) {\n        this.isDisplayMode = displayMode;\n    }\n    \n    /**\n     * Bootstraps the layout generation process by resolving the correct layout strategy.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param model The active StateManager JSONModel instance.\n     * @param modelName The UI5 model alias used for isolation.\n     * @param onSubmit Callback fired when form is submitted.\n     * @param engineScopeId Deterministic scope ID for this engine instance.\n     * @param onChange Callback fired when field values change.\n     * @returns The generated root UI5 Control container.\n     */\n    public build(schema: ISchema, model: sap.ui.model.Model, modelName: string = \"meta\", onSubmit?: () => void, engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => void): Control {\n        this.conditionEngine = new ConditionEngine(schema);\n        this.activePlugins = [];\n        this.activeModel = model;\n        this.engineScopeId = engineScopeId;\n        this.onChange = (isValid: boolean, fieldKey?: string, errorMessage?: string, controlId?: string) => {\n            if (this.conditionEngine && fieldKey) {\n                this.conditionEngine.handleEvent(fieldKey, isValid);\n            }\n            if (onChange) {\n                onChange(isValid, fieldKey, errorMessage, controlId);\n            }\n        };\n        \n        try {\n            // Intercept and synthesize a default layout if the developer/backend failed to provide one\n            if (DefaultLayoutGenerator.ensureLayout(schema)) {\n                Logger.warn(\"[MetaUI Engine] Missing 'uiLayout' array in schema. Synthesized a default layout mapping to prevent a blank render.\");\n            }\n\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);\n            \n            return layoutManager.render(schema, modelName, this, onSubmit);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(\"[MetaUI Engine] Critical error during layout generation\", msg);\n            Logger.showErrorPopup(`Engine failed to generate the layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Layout Error\" });\n        }\n    }\n\n    /**\n     * Instantiates the correct plugin for a specific field based on type and widget hints,\n     * and tracks the plugin for global validation.\n     * \n     * @param fieldMeta The metadata schema specific to the field.\n     * @param bindingPath The JSON path representing the field within the payload.\n     * @param modelName The UI5 JSONModel name used for data binding.\n     * @returns The generated UI5 Control for the field.\n     */\n    public generateField(fieldMeta: IPropertyMetadata, bindingPath: string, modelName: string, isTemplate: boolean = false): Control {\n        try {\n            const plugin = PluginRegistry.getInstance().getPlugin(fieldMeta.type || \"string\", fieldMeta.ui?.widget);\n            plugin.setDisplayMode(this.isDisplayMode);\n            \n            if (!isTemplate) {\n                this.activePlugins.push({ plugin, path: bindingPath });\n            }\n            const scopeId = isTemplate ? undefined : this.engineScopeId;\n            const control = plugin.render(fieldMeta, bindingPath, modelName, scopeId, this.onChange);\n            \n            if (this.conditionEngine) {\n                this.conditionEngine.registerPlugin(bindingPath, plugin);\n            }\n            \n            return control;\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Failed to generate field at ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Failed to generate field '${bindingPath}'.\\n\\nDetails: ${msg}`);\n            return new Text({ text: `[Error generating field ${bindingPath}]` });\n        }\n    }\n\n    /**\n     * Generates a sub-layout (like an embedded table or nested form) without \n     * destroying the current Engine state or Condition tracking.\n     * \n     * @param schema The normalized JSON schema representing the view.\n     * @param modelName The UI5 JSONModel name used for data binding (defaults to \"meta\").\n     * @param bindingPath Optional path to bind the sub-layout to a specific array/object property.\n     * @returns The generated root UI5 Control container.\n     */\n    public generateLayout(schema: ISchema, modelName: string, bindingPath?: string): Control {\n        try {\n            const layoutStrategy = schema.layoutStrategy || (schema.type === \"array\" ? \"table\" : \"form\");\n            const layoutManager = Engine.layoutRegistry.getStrict(layoutStrategy);\n            return layoutManager.render(schema, modelName, this, undefined, bindingPath);\n        } catch (error) {\n            const msg = (error as Error).message;\n            Logger.error(`[MetaUI Engine] Critical error generating sub-layout for ${bindingPath}`, msg);\n            Logger.showErrorPopup(`Engine failed to generate a sub-layout.\\n\\nDetails: ${msg}`);\n            return new Text({ text: \"Critical Sub-Layout Error\" });\n        }\n    }\n\n    /**\n     * Iterates through all active plugins and triggers their internal validation pipelines.\n     * \n     * @returns {IPluginValidationResult[]} Array of validation error objects. Empty array if valid.\n     */\n    public validateAll(): IPluginValidationResult[] {\n        const errors: IPluginValidationResult[] = [];\n        for (const item of this.activePlugins) {\n            const result = item.plugin.validate();\n            if (!result.isValid) {\n                // Ensure the path is bound to the error so GeneratorHost knows where to target it\n                result.fieldKey = result.fieldKey || item.path.replace(/^\\//, \"\");\n                errors.push(result);\n                // Add console log to find which plugin fails silently\n                Logger.error(\"[MetaUI Validation] Plugin failed validation silently:\", item.path || item.plugin.constructor.name);\n            }\n        }\n        return errors;\n    }\n\n    /**\n     * Cleans up internal state and destroys the condition engine to prevent memory leaks.\n     */\n    public destroy(): void {\n        if (this.conditionEngine) {\n            this.conditionEngine.destroy();\n            this.conditionEngine = null;\n        }\n        \n        // ------------------------------------------------------------------------\n        // Ghost Error Prevention\n        // Flush MessageManager for active plugins before destroying their controls\n        // ------------------------------------------------------------------------\n        const messageManager = Messaging;\n        const existingMessages = messageManager.getMessageModel().getData();\n        const messagesToRemove: any[] = [];\n        \n        for (const item of this.activePlugins) {\n            if (this.activeModel) {\n                const targetPath = `/${item.path.replace(/^\\//, \"\")}`;\n                const matched = existingMessages.filter((msg: any) => \n                    msg.getTarget() === targetPath && msg.getMessageProcessor() && msg.getMessageProcessor().getId() === this.activeModel.getId()\n                );\n                messagesToRemove.push(...matched);\n            }\n            if (typeof item.plugin.destroy === \"function\") {\n                item.plugin.destroy();\n            }\n        }\n        \n        if (messagesToRemove.length > 0) {\n            messageManager.removeMessages(messagesToRemove);\n        }\n        \n        this.activePlugins = [];\n    }\n}\n"],"mappings":";;;EAAA;AACA;AACA;AACA;EAHA,MAQSA,eAAe,GAAAC,kBAAA;EAAA,MACfC,cAAc,GAAAC,iBAAA;EAAA,MAKdC,MAAM,GAAAC,eAAA;EAAA,MACNC,sBAAsB,GAAAC,yBAAA;EAI/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACO,MAAMC,MAAM,CAAC;IAChB;;IAEA;IACQC,eAAe,GAA2B,IAAI;;IAEtD;IACQC,aAAa,GAAwC,EAAE;;IAE/D;;IAKA;IACgBC,aAAa,GAAY,KAAK;IAE9CC,WAAWA,CAACC,WAAoB,GAAG,KAAK,EAAE;MACtC,IAAI,CAACF,aAAa,GAAGE,WAAW;IACpC;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACWC,KAAKA,CAACC,MAAe,EAAEC,KAAyB,EAAEC,SAAiB,GAAG,MAAM,EAAEC,QAAqB,EAAEC,aAAsB,EAAEC,QAAmG,EAAW;MAC9O,IAAI,CAACX,eAAe,GAAG,IAAIT,eAAe,CAACe,MAAM,CAAC;MAClD,IAAI,CAACL,aAAa,GAAG,EAAE;MACvB,IAAI,CAACW,WAAW,GAAGL,KAAK;MACxB,IAAI,CAACG,aAAa,GAAGA,aAAa;MAClC,IAAI,CAACC,QAAQ,GAAG,CAACE,OAAgB,EAAEC,QAAiB,EAAEC,YAAqB,EAAEC,SAAkB,KAAK;QAChG,IAAI,IAAI,CAAChB,eAAe,IAAIc,QAAQ,EAAE;UAClC,IAAI,CAACd,eAAe,CAACiB,WAAW,CAACH,QAAQ,EAAED,OAAO,CAAC;QACvD;QACA,IAAIF,QAAQ,EAAE;UACVA,QAAQ,CAACE,OAAO,EAAEC,QAAQ,EAAEC,YAAY,EAAEC,SAAS,CAAC;QACxD;MACJ,CAAC;MAED,IAAI;QACA;QACA,IAAInB,sBAAsB,CAACqB,YAAY,CAACZ,MAAM,CAAC,EAAE;UAC7CX,MAAM,CAACwB,IAAI,CAAC,qHAAqH,CAAC;QACtI;QAEA,MAAMC,cAAc,GAAGd,MAAM,CAACc,cAAc,KAAKd,MAAM,CAACe,IAAI,KAAK,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;QAC5F,MAAMC,aAAa,GAAGvB,MAAM,CAACwB,cAAc,CAACC,SAAS,CAACJ,cAAc,CAAC;QAErE,OAAOE,aAAa,CAACG,MAAM,CAACnB,MAAM,EAAEE,SAAS,EAAE,IAAI,EAAEC,QAAQ,CAAC;MAClE,CAAC,CAAC,OAAOiB,KAAK,EAAE;QACZ,MAAMC,GAAG,GAAID,KAAK,CAAWE,OAAO;QACpCjC,MAAM,CAAC+B,KAAK,CAAC,yDAAyD,EAAEC,GAAG,CAAC;QAC5EhC,MAAM,CAACkC,cAAc,CAAC,qDAAqDF,GAAG,EAAE,CAAC;QACjF,OAAO,IAAIG,IAAI,CAAC;UAAEC,IAAI,EAAE;QAAwB,CAAC,CAAC;MACtD;IACJ;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACWC,aAAaA,CAACC,SAA4B,EAAEC,WAAmB,EAAE1B,SAAiB,EAAE2B,UAAmB,GAAG,KAAK,EAAW;MAC7H,IAAI;QACA,MAAMC,MAAM,GAAG3C,cAAc,CAAC4C,WAAW,CAAC,CAAC,CAACC,SAAS,CAACL,SAAS,CAACZ,IAAI,IAAI,QAAQ,EAAEY,SAAS,CAACM,EAAE,EAAEC,MAAM,CAAC;QACvGJ,MAAM,CAACK,cAAc,CAAC,IAAI,CAACvC,aAAa,CAAC;QAEzC,IAAI,CAACiC,UAAU,EAAE;UACb,IAAI,CAAClC,aAAa,CAACyC,IAAI,CAAC;YAAEN,MAAM;YAAEO,IAAI,EAAET;UAAY,CAAC,CAAC;QAC1D;QACA,MAAMU,OAAO,GAAGT,UAAU,GAAGU,SAAS,GAAG,IAAI,CAACnC,aAAa;QAC3D,MAAMoC,OAAO,GAAGV,MAAM,CAACX,MAAM,CAACQ,SAAS,EAAEC,WAAW,EAAE1B,SAAS,EAAEoC,OAAO,EAAE,IAAI,CAACjC,QAAQ,CAAC;QAExF,IAAI,IAAI,CAACX,eAAe,EAAE;UACtB,IAAI,CAACA,eAAe,CAAC+C,cAAc,CAACb,WAAW,EAAEE,MAAM,CAAC;QAC5D;QAEA,OAAOU,OAAO;MAClB,CAAC,CAAC,OAAOpB,KAAK,EAAE;QACZ,MAAMC,GAAG,GAAID,KAAK,CAAWE,OAAO;QACpCjC,MAAM,CAAC+B,KAAK,CAAC,+CAA+CQ,WAAW,EAAE,EAAEP,GAAG,CAAC;QAC/EhC,MAAM,CAACkC,cAAc,CAAC,6BAA6BK,WAAW,kBAAkBP,GAAG,EAAE,CAAC;QACtF,OAAO,IAAIG,IAAI,CAAC;UAAEC,IAAI,EAAE,2BAA2BG,WAAW;QAAI,CAAC,CAAC;MACxE;IACJ;;IAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACWc,cAAcA,CAAC1C,MAAe,EAAEE,SAAiB,EAAE0B,WAAoB,EAAW;MACrF,IAAI;QACA,MAAMd,cAAc,GAAGd,MAAM,CAACc,cAAc,KAAKd,MAAM,CAACe,IAAI,KAAK,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;QAC5F,MAAMC,aAAa,GAAGvB,MAAM,CAACwB,cAAc,CAACC,SAAS,CAACJ,cAAc,CAAC;QACrE,OAAOE,aAAa,CAACG,MAAM,CAACnB,MAAM,EAAEE,SAAS,EAAE,IAAI,EAAEqC,SAAS,EAAEX,WAAW,CAAC;MAChF,CAAC,CAAC,OAAOR,KAAK,EAAE;QACZ,MAAMC,GAAG,GAAID,KAAK,CAAWE,OAAO;QACpCjC,MAAM,CAAC+B,KAAK,CAAC,4DAA4DQ,WAAW,EAAE,EAAEP,GAAG,CAAC;QAC5FhC,MAAM,CAACkC,cAAc,CAAC,uDAAuDF,GAAG,EAAE,CAAC;QACnF,OAAO,IAAIG,IAAI,CAAC;UAAEC,IAAI,EAAE;QAA4B,CAAC,CAAC;MAC1D;IACJ;;IAEA;AACJ;AACA;AACA;AACA;IACWkB,WAAWA,CAAA,EAA8B;MAC5C,MAAMC,MAAiC,GAAG,EAAE;MAC5C,KAAK,MAAMC,IAAI,IAAI,IAAI,CAAClD,aAAa,EAAE;QACnC,MAAMmD,MAAM,GAAGD,IAAI,CAACf,MAAM,CAACiB,QAAQ,CAAC,CAAC;QACrC,IAAI,CAACD,MAAM,CAACvC,OAAO,EAAE;UACjB;UACAuC,MAAM,CAACtC,QAAQ,GAAGsC,MAAM,CAACtC,QAAQ,IAAIqC,IAAI,CAACR,IAAI,CAACW,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;UACjEJ,MAAM,CAACR,IAAI,CAACU,MAAM,CAAC;UACnB;UACAzD,MAAM,CAAC+B,KAAK,CAAC,wDAAwD,EAAEyB,IAAI,CAACR,IAAI,IAAIQ,IAAI,CAACf,MAAM,CAACjC,WAAW,CAACoD,IAAI,CAAC;QACrH;MACJ;MACA,OAAOL,MAAM;IACjB;;IAEA;AACJ;AACA;IACWM,OAAOA,CAAA,EAAS;MACnB,IAAI,IAAI,CAACxD,eAAe,EAAE;QACtB,IAAI,CAACA,eAAe,CAACwD,OAAO,CAAC,CAAC;QAC9B,IAAI,CAACxD,eAAe,GAAG,IAAI;MAC/B;;MAEA;MACA;MACA;MACA;MACA,MAAMyD,cAAc,GAAGC,SAAS;MAChC,MAAMC,gBAAgB,GAAGF,cAAc,CAACG,eAAe,CAAC,CAAC,CAACC,OAAO,CAAC,CAAC;MACnE,MAAMC,gBAAuB,GAAG,EAAE;MAElC,KAAK,MAAMX,IAAI,IAAI,IAAI,CAAClD,aAAa,EAAE;QACnC,IAAI,IAAI,CAACW,WAAW,EAAE;UAClB,MAAMmD,UAAU,GAAG,IAAIZ,IAAI,CAACR,IAAI,CAACW,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE;UACrD,MAAMU,OAAO,GAAGL,gBAAgB,CAACM,MAAM,CAAEtC,GAAQ,IAC7CA,GAAG,CAACuC,SAAS,CAAC,CAAC,KAAKH,UAAU,IAAIpC,GAAG,CAACwC,mBAAmB,CAAC,CAAC,IAAIxC,GAAG,CAACwC,mBAAmB,CAAC,CAAC,CAACC,KAAK,CAAC,CAAC,KAAK,IAAI,CAACxD,WAAW,CAACwD,KAAK,CAAC,CAChI,CAAC;UACDN,gBAAgB,CAACpB,IAAI,CAAC,GAAGsB,OAAO,CAAC;QACrC;QACA,IAAI,OAAOb,IAAI,CAACf,MAAM,CAACoB,OAAO,KAAK,UAAU,EAAE;UAC3CL,IAAI,CAACf,MAAM,CAACoB,OAAO,CAAC,CAAC;QACzB;MACJ;MAEA,IAAIM,gBAAgB,CAACO,MAAM,GAAG,CAAC,EAAE;QAC7BZ,cAAc,CAACa,cAAc,CAACR,gBAAgB,CAAC;MACnD;MAEA,IAAI,CAAC7D,aAAa,GAAG,EAAE;IAC3B;EACJ;EAAC,IAAAsE,SAAA;IAAAC,UAAA;EAAA;EAAAD,SAAA,CAAAxE,MAAA,GAAAA,MAAA;EAAA,OAAAwE,SAAA;AAAA","ignoreList":[]}