@siliconst/metaui 1.4.17 → 1.4.21

package/src/nz/co/siliconst/ui5/metaui/openapi/parsers/OpenApiPropertyMapper.ts

@@ -0,0 +1,377 @@
+/**
+ * @file OpenApiPropertyMapper.ts
+ * @description Extracts and maps OpenAPI properties into MetaUI IPropertyMetadata.
+ */
+
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import { OpenApiRefResolver } from "../OpenApiRefResolver";
+import { OpenApiTypeMapper } from "../OpenApiTypeMapper";
+import { OpenApiUIMapper } from "../OpenApiUIMapper";
+
+/**
+ * Utility class responsible for extracting and mapping OpenAPI properties into the native MetaUI IPropertyMetadata schema format.
+ * 
+ * @public
+ */
+export class OpenApiPropertyMapper {
+    /**
+     * Recursively traverses and translates an OpenAPI properties block into a MetaUI IPropertyMetadata dictionary.
+     * 
+     * @param {Record<string, any>} properties The OpenAPI properties block.
+     * @param {string[]} requiredKeys Array of required property keys.
+     * @param {any} openApiRoot The OpenAPI root document for resolving references.
+     * @param {"2.0" | "3.0"} version The OpenAPI version.
+     * @param {number} [depth=0] Recursion depth limiter to prevent stack overflows on circular refs.
+     * @returns {Record<string, IPropertyMetadata>} The normalized MetaUI properties mapping.
+     */
+    public static mapProperties(
+        properties: Record<string, any>, 
+        requiredKeys: string[], 
+        openApiRoot: unknown, 
+        version: "2.0" | "3.0", 
+        depth: number = 0
+    ): Record<string, IPropertyMetadata> {
+        const normalizedProps: Record<string, IPropertyMetadata> = {};
+        
+        if (depth > 8) return normalizedProps;
+
+        for (const key of Object.keys(properties)) {
+            const isRequired = requiredKeys.includes(key);
+            let propDef = properties[key];
+
+            if (propDef.$ref) {
+                const resolved = OpenApiRefResolver.resolve(propDef.$ref, openApiRoot);
+                if (resolved) {
+                    propDef = { ...resolved, ...propDef };
+                }
+            }
+
+            normalizedProps[key] = this.mapPropertyMetadata(propDef, key, isRequired, openApiRoot, version, depth + 1);
+        }
+        
+        return normalizedProps;
+    }
+
+    /**
+     * Translates a single OpenAPI property schema block into a MetaUI IPropertyMetadata block.
+     * Delegates specific mapping tasks to focused private methods to adhere to SRP.
+     * 
+     * @param {any} swaggerProp The specific OpenAPI property schema to map.
+     * @param {string} keyName The key/name of this property.
+     * @param {boolean} isRequired Whether this property is strictly required.
+     * @param {any} openApiRoot The OpenAPI root document for resolving references.
+     * @param {"2.0" | "3.0"} version The OpenAPI version.
+     * @param {number} [depth=0] Recursion depth limiter.
+     * @returns {IPropertyMetadata} The normalized MetaUI property metadata.
+     */
+    public static mapPropertyMetadata(
+        swaggerProp: unknown, 
+        keyName: string, 
+        isRequired: boolean, 
+        openApiRoot: unknown, 
+        version: "2.0" | "3.0", 
+        depth: number = 0
+    ): IPropertyMetadata {
+        let currentProp = swaggerProp;
+
+        // 1. Resolve References
+        const refResult = this._resolveReference(currentProp, keyName, isRequired, openApiRoot, version, depth);
+        if (refResult) {
+            return refResult;
+        }
+
+        // 2. Resolve Composition (allOf)
+        currentProp = this._resolveAllOf(currentProp, openApiRoot);
+
+        // 3. Base Initialization
+        const type = OpenApiTypeMapper.mapType(currentProp.type);
+        const metaProp: IPropertyMetadata = {
+            type: type,
+            required: isRequired
+        };
+
+        // 4. UI Directive Binding
+        const uiDirective = OpenApiUIMapper.build(currentProp, keyName);
+        if (Object.keys(uiDirective).length > 0) {
+            metaProp.ui = uiDirective;
+        }
+
+        // 5. Constraints & State Modifiers
+        this._applyConstraints(metaProp, currentProp, version);
+        this._applyStateModifiers(metaProp, currentProp);
+
+        if (currentProp.default !== undefined) {
+            metaProp.default = currentProp.default;
+        }
+
+        if (Array.isArray(currentProp.enum)) {
+            metaProp.enum = currentProp.enum;
+            if (!metaProp.ui) metaProp.ui = {};
+            metaProp.ui.widget = "dropdown";
+        }
+
+        // 6. Polymorphism & Nesting
+        this._applyPolymorphism(metaProp, currentProp, openApiRoot, version, depth);
+        this._applyNestedTypes(metaProp, currentProp, openApiRoot, version, depth, type);
+
+        return metaProp;
+    }
+
+    /**
+     * Attempts to resolve a $ref block. If it resolves to a primitive, it inlines it.
+     * Otherwise, it returns a reference widget payload.
+     * 
+     * @param {any} currentProp The current schema property definition.
+     * @param {string} keyName The structural key name.
+     * @param {boolean} isRequired Whether the property is strictly required.
+     * @param {any} openApiRoot The root API definition for relative resolution.
+     * @param {"2.0" | "3.0"} version The structural version context.
+     * @param {number} depth The recursive resolution depth.
+     * @returns {IPropertyMetadata | null} Resolved metadata, or null if no reference exists.
+     * @private
+     */
+    private static _resolveReference(
+        currentProp: unknown, 
+        keyName: string, 
+        isRequired: boolean, 
+        openApiRoot: unknown, 
+        version: "2.0" | "3.0", 
+        depth: number
+    ): IPropertyMetadata | null {
+        if (!currentProp.$ref) {
+            return null;
+        }
+
+        const resolved = OpenApiRefResolver.resolve(currentProp.$ref, openApiRoot);
+        const resolvedType = currentProp.type || (resolved && resolved.type);
+        
+        if (resolvedType && ["string", "number", "integer", "boolean"].includes(resolvedType)) {
+            const inlineProp = { ...resolved, ...currentProp };
+            delete inlineProp.$ref;
+            return this.mapPropertyMetadata(inlineProp, keyName, isRequired, openApiRoot, version, depth + 1);
+        }
+
+        return {
+            type: "object",
+            $ref: currentProp.$ref,
+            required: isRequired,
+            ui: { widget: "reference" }
+        };
+    }
+
+    /**
+     * Evaluates and merges 'allOf' arrays into a unified schema definition.
+     * 
+     * @param {any} currentProp The structural property definition containing potential aggregations.
+     * @param {any} openApiRoot The base schema for deep resolution.
+     * @returns {any} A flattened and merged schema entity.
+     * @private
+     */
+    private static _resolveAllOf(currentProp: unknown, openApiRoot: unknown): unknown {
+        if (!Array.isArray(currentProp.allOf)) {
+            return currentProp;
+        }
+        
+        let merged = { ...currentProp };
+        delete merged.allOf;
+        for (const subSchema of currentProp.allOf) {
+            let resolvedSub = subSchema;
+            if (subSchema.$ref) {
+                resolvedSub = OpenApiRefResolver.resolve(subSchema.$ref, openApiRoot) || {};
+            }
+            merged = this.deepMergeSchemas(merged, resolvedSub);
+        }
+        return merged;
+    }
+
+    /**
+     * Extracts structural constraints (min/max, regex, etc.) and maps them natively to the output metadata.
+     * 
+     * @param {IPropertyMetadata} metaProp The target metadata definition block.
+     * @param {any} currentProp The source OpenAPI schema chunk.
+     * @param {"2.0" | "3.0"} version The version, utilized for nuanced boundary matching.
+     * @private
+     */
+    private static _applyConstraints(metaProp: IPropertyMetadata, currentProp: unknown, version: "2.0" | "3.0"): void {
+        // String Constraints
+        if (typeof currentProp.maxLength === "number") metaProp.maxLength = currentProp.maxLength;
+        if (typeof currentProp.minLength === "number") metaProp.minLength = currentProp.minLength;
+        if (typeof currentProp.pattern === "string") metaProp.pattern = currentProp.pattern;
+
+        // Numeric Constraints
+        if (typeof currentProp.maximum === "number") metaProp.maximum = currentProp.maximum;
+        if (typeof currentProp.minimum === "number") metaProp.minimum = currentProp.minimum;
+        if (typeof currentProp.multipleOf === "number") metaProp.multipleOf = currentProp.multipleOf;
+        
+        // Array Constraints
+        if (typeof currentProp.maxItems === "number") metaProp.maxItems = currentProp.maxItems;
+        if (typeof currentProp.minItems === "number") metaProp.minItems = currentProp.minItems;
+        if (typeof currentProp.uniqueItems === "boolean") metaProp.uniqueItems = currentProp.uniqueItems;
+
+        // Object Constraints
+        if (typeof currentProp.maxProperties === "number") metaProp.maxProperties = currentProp.maxProperties;
+        if (typeof currentProp.minProperties === "number") metaProp.minProperties = currentProp.minProperties;
+
+        // Exclusive Min/Max version-specific logic
+        if (version === "2.0") {
+            if (currentProp.exclusiveMaximum === true && typeof currentProp.maximum === "number") {
+                metaProp.exclusiveMaximum = true;
+            }
+            if (currentProp.exclusiveMinimum === true && typeof currentProp.minimum === "number") {
+                metaProp.exclusiveMinimum = true;
+            }
+        } else if (version === "3.0") {
+            if (typeof currentProp.exclusiveMaximum === "number" || typeof currentProp.exclusiveMaximum === "boolean") {
+                metaProp.exclusiveMaximum = currentProp.exclusiveMaximum;
+            }
+            if (typeof currentProp.exclusiveMinimum === "number" || typeof currentProp.exclusiveMinimum === "boolean") {
+                metaProp.exclusiveMinimum = currentProp.exclusiveMinimum;
+            }
+        }
+    }
+
+    /**
+     * Extracts operational state flags like readOnly or nullable mapping them onto the internal specification.
+     * 
+     * @param {IPropertyMetadata} metaProp Target native specification.
+     * @param {any} currentProp Source raw schema payload.
+     * @private
+     */
+    private static _applyStateModifiers(metaProp: IPropertyMetadata, currentProp: unknown): void {
+        if (currentProp.readOnly === true) metaProp.readOnly = true;
+        if (currentProp.writeOnly === true) metaProp.writeOnly = true;
+        if (currentProp.nullable === true) metaProp.nullable = true;
+        if (currentProp.deprecated === true) metaProp.deprecated = true;
+    }
+
+    /**
+     * Extracts and maps polymorphic discriminator and union types (oneOf/anyOf) to MetaUI structural directives.
+     * 
+     * @param {IPropertyMetadata} metaProp Native MetaUI definition tree.
+     * @param {any} currentProp Raw schema block.
+     * @param {any} openApiRoot Master OpenAPI root.
+     * @param {"2.0" | "3.0"} version Protocol version identifier.
+     * @param {number} depth Internal depth tracker.
+     * @private
+     */
+    private static _applyPolymorphism(
+        metaProp: IPropertyMetadata, 
+        currentProp: unknown, 
+        openApiRoot: unknown, 
+        version: "2.0" | "3.0", 
+        depth: number
+    ): void {
+        // Discriminator handling
+        if (currentProp.discriminator) {
+            if (version === "2.0" && typeof currentProp.discriminator === "string") {
+                metaProp.discriminator = { propertyName: currentProp.discriminator };
+            } else if (version === "3.0" && typeof currentProp.discriminator === "object") {
+                metaProp.discriminator = {
+                    propertyName: currentProp.discriminator.propertyName,
+                    mapping: currentProp.discriminator.mapping
+                };
+            }
+        }
+
+        // Handle oneOf polymorphic mapping
+        if (Array.isArray(currentProp.oneOf)) {
+            metaProp.oneOf = [];
+            for (let i = 0; i < currentProp.oneOf.length; i++) {
+                metaProp.oneOf.push(this.mapPropertyMetadata(currentProp.oneOf[i], `Variant${i}`, false, openApiRoot, version, depth + 1));
+            }
+            if (!metaProp.ui) metaProp.ui = {};
+            metaProp.ui.widget = "polymorphic";
+        }
+        
+        // Handle anyOf mapping
+        if (Array.isArray(currentProp.anyOf)) {
+            metaProp.anyOf = [];
+            for (let i = 0; i < currentProp.anyOf.length; i++) {
+                metaProp.anyOf.push(this.mapPropertyMetadata(currentProp.anyOf[i], `AnyVariant${i}`, false, openApiRoot, version, depth + 1));
+            }
+        }
+
+        // Handle not mapping
+        if (currentProp.not) {
+            metaProp.not = this.mapPropertyMetadata(currentProp.not, `NotVariant`, false, openApiRoot, version, depth + 1);
+        }
+    }
+
+    /**
+     * Recursively traverses into nested objects and arrays constructing the structural node trees.
+     * 
+     * @param {IPropertyMetadata} metaProp The localized destination structure.
+     * @param {any} currentProp The source chunk representing a complex element.
+     * @param {any} openApiRoot The OpenAPI dictionary context.
+     * @param {"2.0" | "3.0"} version System schema version.
+     * @param {number} depth Invocation stack depth.
+     * @param {string} type Normalized atomic structure type.
+     * @private
+     */
+    private static _applyNestedTypes(
+        metaProp: IPropertyMetadata, 
+        currentProp: unknown, 
+        openApiRoot: unknown, 
+        version: "2.0" | "3.0", 
+        depth: number,
+        type: string
+    ): void {
+        if (type === "object") {
+            if (currentProp.properties) {
+                const childRequired = Array.isArray(currentProp.required) ? currentProp.required : [];
+                metaProp.properties = this.mapProperties(currentProp.properties, childRequired, openApiRoot, version, depth + 1);
+            }
+            
+            if (currentProp.additionalProperties) {
+                if (currentProp.additionalProperties === true) {
+                    metaProp.additionalProperties = true;
+                } else if (typeof currentProp.additionalProperties === "object") {
+                    metaProp.additionalProperties = this.mapPropertyMetadata(currentProp.additionalProperties, "value", false, openApiRoot, version, depth + 1);
+                    if (!metaProp.ui) metaProp.ui = {};
+                    metaProp.ui.widget = "dictionary";
+                }
+            }
+            
+            // Opaque JSON object definition mapping
+            if (!currentProp.properties && !currentProp.additionalProperties) {
+                if (!metaProp.ui) metaProp.ui = {};
+                metaProp.ui.widget = "codeEditor";
+            }
+        } else if (type === "array" && currentProp.items) {
+            metaProp.items = this.mapPropertyMetadata(currentProp.items, "items", false, openApiRoot, version, depth + 1);
+            if (metaProp.items.type !== "object") {
+                if (!metaProp.ui) metaProp.ui = {};
+                metaProp.ui.widget = "multiInput";
+            }
+        }
+    }
+
+    /**
+     * Recursively deep-merges two OpenAPI objects, ensuring array boundaries and nested structures are preserved.
+     * 
+     * @param {any} target The target base object.
+     * @param {any} source The source object providing override details.
+     * @returns {any} The synthesized output object.
+     */
+    public static deepMergeSchemas(target: unknown, source: unknown): unknown {
+        const output = Object.assign({}, target);
+        if (source === null || typeof source !== "object") return output;
+
+        Object.keys(source).forEach(key => {
+            if (Array.isArray(source[key])) {
+                output[key] = Array.isArray(target[key]) 
+                    ? Array.from(new Set([...target[key], ...source[key]])) 
+                    : [...source[key]];
+            } else if (typeof source[key] === "object" && source[key] !== null) {
+                if (target[key] && typeof target[key] === "object") {
+                    output[key] = this.deepMergeSchemas(target[key], source[key]);
+                } else {
+                    output[key] = Object.assign({}, source[key]);
+                }
+            } else {
+                output[key] = source[key];
+            }
+        });
+        return output;
+    }
+}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin-dbg.js

@@ -49,9 +49,20 @@ sap.ui.define(["./BasePlugin", "sap/m/Button"], function (___BasePlugin, Button)
 
           // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked
           const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));
+          let parent = btn.getParent();
+          let parentHost = null;
+          while (parent) {
+            if (parent.getMetadata().getName() === "nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost" || parent.getMetadata().getName() === "nz.co.siliconst.ui5.metaui.controls.DynamicHost") {
+              parentHost = parent;
+              break;
+            }
+            parent = parent.getParent();
+          }
+          const schemaDefs = parentHost ? parentHost.getProperty("schemaDefinitions") : null;
           sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"], DynamicHost => {
             const host = new DynamicHost({
               schemaDefinition: subSchema,
+              schemaDefinitions: schemaDefs,
               data: nestedData,
               editable: this.isEditable // Pass the display mode down to the child Engine!
             });

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"ArrayPlugin-dbg.js","names":["BasePlugin","___BasePlugin","ArrayPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","items","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","JSON","parse","stringify","getProperty","sap","require","DynamicHost","host","schemaDefinition","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","getValue","applyState","__exports","__esModule"],"sources":["ArrayPlugin.ts"],"sourcesContent":["/**\n * @file ArrayPlugin.ts\n * @description Renders a button that drills down into a nested table (array) via a recursive Dialog using v2 schema.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ArrayPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested array form dialog.\n     * \n     * @param field The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: ISchema = {\n            type: \"array\",\n            title: field.ui?.label || propKey,\n            items: field.items || {\n                type: \"object\",\n                properties: {} // inference will handle it if empty\n            }\n        };\n\n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Records\" : \"Edit Records\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://list\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked\n                const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/DynamicHost\"], (DynamicHost: typeof import(\"../../controls/DynamicHost\").default) => {\n                    const host = new DynamicHost({\n                        schemaDefinition: subSchema,\n                        data: nestedData,\n                        editable: this.isEditable // Pass the display mode down to the child Engine!\n                    });\n\n                    // Only attach submit event if we are not in display mode\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: sap.ui.base.Event) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n\n                            // CRITICAL: Notify the parent Engine that this field mutated\n                            // so it can trigger LiveUpdate syncs and validate!\n                            if (this.onChange) {\n                                this.onChange(true, propKey);\n                            }\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Records: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n        \n        return this.control as Control;\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): unknown {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // dynamic state changes\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"ArrayPlugin-dbg.js","names":["BasePlugin","___BasePlugin","ArrayPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","items","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","JSON","parse","stringify","getProperty","parent","getParent","parentHost","getMetadata","getName","schemaDefs","sap","require","DynamicHost","host","schemaDefinition","schemaDefinitions","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","getValue","applyState","__exports","__esModule"],"sources":["ArrayPlugin.ts"],"sourcesContent":["/**\n * @file ArrayPlugin.ts\n * @description Renders a button that drills down into a nested table (array) via a recursive Dialog using v2 schema.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ArrayPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested array form dialog.\n     * \n     * @param field The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: ISchema = {\n            type: \"array\",\n            title: field.ui?.label || propKey,\n            items: field.items || {\n                type: \"object\",\n                properties: {} // inference will handle it if empty\n            }\n        };\n\n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Records\" : \"Edit Records\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://list\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked\n                const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));\n\n                let parent = btn.getParent();\n                let parentHost = null;\n                while (parent) {\n                    if (parent.getMetadata().getName() === \"nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost\" || \n                        parent.getMetadata().getName() === \"nz.co.siliconst.ui5.metaui.controls.DynamicHost\") {\n                        parentHost = parent as any;\n                        break;\n                    }\n                    parent = parent.getParent();\n                }\n                const schemaDefs = parentHost ? parentHost.getProperty(\"schemaDefinitions\") : null;\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/DynamicHost\"], (DynamicHost: typeof import(\"../../controls/DynamicHost\").default) => {\n                    const host = new DynamicHost({\n                        schemaDefinition: subSchema,\n                        schemaDefinitions: schemaDefs,\n                        data: nestedData,\n                        editable: this.isEditable // Pass the display mode down to the child Engine!\n                    });\n\n                    // Only attach submit event if we are not in display mode\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: sap.ui.base.Event) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n\n                            // CRITICAL: Notify the parent Engine that this field mutated\n                            // so it can trigger LiveUpdate syncs and validate!\n                            if (this.onChange) {\n                                this.onChange(true, propKey);\n                            }\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Records: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n        \n        return this.control as Control;\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): unknown {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // dynamic state changes\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ArrayPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,yDAAyD,CAAC;IACzE;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAI1C,MAAa,WAAY,SAAQ,UAAU;QACvC;;;;;;;;;WASG;QACI,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAmErL;;WAEG;QACH,SAAS,CAAC,QAAQ,IAAI,OAAO;QAI7B;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAG/B;CAEA"}
+{"version":3,"file":"ArrayPlugin.d.ts","sourceRoot":"../../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,yDAAyD,CAAC;IACzE;;;OAGG;IAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wDAAwD,CAAC;IACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;IAClF,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAI1C,MAAa,WAAY,SAAQ,UAAU;QACvC;;;;;;;;;WASG;QACI,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAG,WAAW,EAAE,MAAM,EAAG,SAAS,GAAE,MAAe,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO;QAgFrL;;WAEG;QACH,SAAS,CAAC,QAAQ,IAAI,OAAO;QAI7B;;WAEG;QACH,SAAS,CAAC,UAAU,IAAI,IAAI;KAG/B;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin.js

@@ -1,2 +1,2 @@
-sap.ui.define(["./BasePlugin","sap/m/Button"],function(t,e){"use strict";const i=t["BasePlugin"];class s extends i{render(t,i,s="meta",n,a){this.onChange=a;this.metadata=t;const o=i.startsWith("/")?i.substring(1):i;const r={type:"array",title:t.ui?.label||o,items:t.items||{type:"object",properties:{}}};if(t.uiLayout){r.uiLayout=t.uiLayout}this.control=new e({id:this.generateStableId(n,i),text:!this.isEditable?"View Records":"Edit Records",icon:!this.isEditable?"sap-icon://display":"sap-icon://list",press:e=>{const n=e.getSource();const a=n.getModel(s);if(!a)return;const l=n.getBindingContext(s);let u=i;if(l&&!i.startsWith("/")){const t=l.getPath();u=t.endsWith("/")?t+i:t==="/"?"/"+i:t+"/"+i}const c=JSON.parse(JSON.stringify(a.getProperty(u)||[]));sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"],e=>{const i=new e({schemaDefinition:r,data:c,editable:this.isEditable});if(!!this.isEditable){i.attachSubmit(t=>{const e=t.getParameter("payload");a.setProperty(u,e);if(this.onChange){this.onChange(true,o)}})}const s=t.ui?.dialogButtonText||(!this.isEditable?"Close":"OK");i.openInDialog(`Nested Records: ${t.ui?.label||o}`,s)})}});return this.control}getValue(){return null}applyState(){}}var n={__esModule:true};n.ArrayPlugin=s;return n});
+sap.ui.define(["./BasePlugin","sap/m/Button"],function(t,e){"use strict";const i=t["BasePlugin"];class s extends i{render(t,i,s="meta",n,a){this.onChange=a;this.metadata=t;const o=i.startsWith("/")?i.substring(1):i;const r={type:"array",title:t.ui?.label||o,items:t.items||{type:"object",properties:{}}};if(t.uiLayout){r.uiLayout=t.uiLayout}this.control=new e({id:this.generateStableId(n,i),text:!this.isEditable?"View Records":"Edit Records",icon:!this.isEditable?"sap-icon://display":"sap-icon://list",press:e=>{const n=e.getSource();const a=n.getModel(s);if(!a)return;const l=n.getBindingContext(s);let c=i;if(l&&!i.startsWith("/")){const t=l.getPath();c=t.endsWith("/")?t+i:t==="/"?"/"+i:t+"/"+i}const u=JSON.parse(JSON.stringify(a.getProperty(c)||[]));let d=n.getParent();let g=null;while(d){if(d.getMetadata().getName()==="nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost"||d.getMetadata().getName()==="nz.co.siliconst.ui5.metaui.controls.DynamicHost"){g=d;break}d=d.getParent()}const h=g?g.getProperty("schemaDefinitions"):null;sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"],e=>{const i=new e({schemaDefinition:r,schemaDefinitions:h,data:u,editable:this.isEditable});if(!!this.isEditable){i.attachSubmit(t=>{const e=t.getParameter("payload");a.setProperty(c,e);if(this.onChange){this.onChange(true,o)}})}const s=t.ui?.dialogButtonText||(!this.isEditable?"Close":"OK");i.openInDialog(`Nested Records: ${t.ui?.label||o}`,s)})}});return this.control}getValue(){return null}applyState(){}}var n={__esModule:true};n.ArrayPlugin=s;return n});
 //# sourceMappingURL=ArrayPlugin.js.map

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"ArrayPlugin.js","names":["BasePlugin","___BasePlugin","ArrayPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","this","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","items","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","JSON","parse","stringify","getProperty","sap","require","DynamicHost","host","schemaDefinition","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","getValue","applyState","__exports","__esModule"],"sources":["ArrayPlugin.ts"],"sourcesContent":["/**\n * @file ArrayPlugin.ts\n * @description Renders a button that drills down into a nested table (array) via a recursive Dialog using v2 schema.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ArrayPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested array form dialog.\n     * \n     * @param field The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: ISchema = {\n            type: \"array\",\n            title: field.ui?.label || propKey,\n            items: field.items || {\n                type: \"object\",\n                properties: {} // inference will handle it if empty\n            }\n        };\n\n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Records\" : \"Edit Records\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://list\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked\n                const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/DynamicHost\"], (DynamicHost: typeof import(\"../../controls/DynamicHost\").default) => {\n                    const host = new DynamicHost({\n                        schemaDefinition: subSchema,\n                        data: nestedData,\n                        editable: this.isEditable // Pass the display mode down to the child Engine!\n                    });\n\n                    // Only attach submit event if we are not in display mode\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: sap.ui.base.Event) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n\n                            // CRITICAL: Notify the parent Engine that this field mutated\n                            // so it can trigger LiveUpdate syncs and validate!\n                            if (this.onChange) {\n                                this.onChange(true, propKey);\n                            }\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Records: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n        \n        return this.control as Control;\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): unknown {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // dynamic state changes\n    }\n}\n"],"mappings":"yEAAA,MAKSA,EAAUC,EAAA,cAMZ,MAAMC,UAAoBF,EAWtBG,OAAOC,EAA2BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAC/GC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAChB,MAAMO,EAAUN,EAAYO,WAAW,KAAOP,EAAYQ,UAAU,GAAKR,EAEzE,MAAMS,EAAqB,CACvBC,KAAM,QACNC,MAAOZ,EAAMa,IAAIC,OAASP,EAC1BQ,MAAOf,EAAMe,OAAS,CAClBJ,KAAM,SACNK,WAAY,CAAC,IAIrB,GAAIhB,EAAMiB,SAAU,CAChBP,EAAUO,SAAWjB,EAAMiB,QAC/B,CAEAZ,KAAKa,QAAU,IAAIC,EAAO,CACtBC,GAAIf,KAAKgB,iBAAiBlB,EAAeF,GACzCqB,MAAOjB,KAAKkB,WAAa,eAAiB,eAC1CC,MAAOnB,KAAKkB,WAAa,qBAAuB,kBAChDE,MAAQC,IACJ,MAAMC,EAAMD,EAAOE,YACnB,MAAMC,EAAcF,EAAIG,SAAS5B,GACjC,IAAK2B,EAAa,OAElB,MAAME,EAAiBJ,EAAIK,kBAAkB9B,GAC7C,IAAI+B,EAAahC,EACjB,GAAI8B,IAAmB9B,EAAYO,WAAW,KAAM,CAChD,MAAM0B,EAAUH,EAAeI,UAC/BF,EAAaC,EAAQE,SAAS,KAAOF,EAAUjC,EAAeiC,IAAY,IAAM,IAAMjC,EAAciC,EAAU,IAAMjC,CACxH,CAGA,MAAMoC,EAAaC,KAAKC,MAAMD,KAAKE,UAAUX,EAAYY,YAAYR,IAAe,KAEpFS,IAAI7B,GAAG8B,QAAQ,CAAC,mDAAqDC,IACjE,MAAMC,EAAO,IAAID,EAAY,CACzBE,iBAAkBpC,EAClBqC,KAAMV,EACNW,SAAU3C,KAAKkB,aAInB,KAAMlB,KAAKkB,WAAY,CACnBsB,EAAKI,aAAcC,IACf,MAAMC,EAAUD,EAAEE,aAAa,WAC/BvB,EAAYwB,YAAYpB,EAAYkB,GAIpC,GAAI9C,KAAKD,SAAU,CACfC,KAAKD,SAAS,KAAMG,EACxB,GAER,CAEA,MAAM+C,EAAatD,EAAMa,IAAI0C,oBAAsBlD,KAAKkB,WAAa,QAAU,MAC/EsB,EAAKW,aAAa,mBAAmBxD,EAAMa,IAAIC,OAASP,IAAW+C,QAK/E,OAAOjD,KAAKa,OAChB,CAKUuC,WACN,OAAO,IACX,CAKUC,aACN,EAEP,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAA7D,cAAA,OAAA6D,CAAA","ignoreList":[]}
+{"version":3,"file":"ArrayPlugin.js","names":["BasePlugin","___BasePlugin","ArrayPlugin","render","field","bindingPath","modelName","engineScopeId","onChange","this","metadata","propKey","startsWith","substring","subSchema","type","title","ui","label","items","properties","uiLayout","control","Button","id","generateStableId","text","isEditable","icon","press","oEvent","btn","getSource","parentModel","getModel","bindingContext","getBindingContext","updatePath","ctxPath","getPath","endsWith","nestedData","JSON","parse","stringify","getProperty","parent","getParent","parentHost","getMetadata","getName","schemaDefs","sap","require","DynamicHost","host","schemaDefinition","schemaDefinitions","data","editable","attachSubmit","e","payload","getParameter","setProperty","buttonText","dialogButtonText","openInDialog","getValue","applyState","__exports","__esModule"],"sources":["ArrayPlugin.ts"],"sourcesContent":["/**\n * @file ArrayPlugin.ts\n * @description Renders a button that drills down into a nested table (array) via a recursive Dialog using v2 schema.\n */\n\nimport { BasePlugin } from \"./BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport Button from \"sap/m/Button\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\n\nexport class ArrayPlugin extends BasePlugin {\n    /**\n     * Renders a `sap.m.Button` to open a nested array form dialog.\n     * \n     * @param field The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured Button control.\n     */\n    public render(field: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = field;\n        const propKey = bindingPath.startsWith(\"/\") ? bindingPath.substring(1) : bindingPath;\n        \n        const subSchema: ISchema = {\n            type: \"array\",\n            title: field.ui?.label || propKey,\n            items: field.items || {\n                type: \"object\",\n                properties: {} // inference will handle it if empty\n            }\n        };\n\n        if (field.uiLayout) {\n            subSchema.uiLayout = field.uiLayout;\n        }\n\n        this.control = new Button({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            text: !this.isEditable ? \"View Records\" : \"Edit Records\",\n            icon: !this.isEditable ? \"sap-icon://display\" : \"sap-icon://list\",\n            press: (oEvent: sap.ui.base.Event) => {\n                const btn = oEvent.getSource() as Button;\n                const parentModel = btn.getModel(modelName) as JSONModel;\n                if (!parentModel) return;\n                \n                const bindingContext = btn.getBindingContext(modelName);\n                let updatePath = bindingPath;\n                if (bindingContext && !bindingPath.startsWith(\"/\")) {\n                    const ctxPath = bindingContext.getPath();\n                    updatePath = ctxPath.endsWith(\"/\") ? ctxPath + bindingPath : (ctxPath === \"/\" ? \"/\" + bindingPath : ctxPath + \"/\" + bindingPath);\n                }\n                \n                // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked\n                const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));\n\n                let parent = btn.getParent();\n                let parentHost = null;\n                while (parent) {\n                    if (parent.getMetadata().getName() === \"nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost\" || \n                        parent.getMetadata().getName() === \"nz.co.siliconst.ui5.metaui.controls.DynamicHost\") {\n                        parentHost = parent as any;\n                        break;\n                    }\n                    parent = parent.getParent();\n                }\n                const schemaDefs = parentHost ? parentHost.getProperty(\"schemaDefinitions\") : null;\n\n                sap.ui.require([\"nz/co/siliconst/ui5/metaui/controls/DynamicHost\"], (DynamicHost: typeof import(\"../../controls/DynamicHost\").default) => {\n                    const host = new DynamicHost({\n                        schemaDefinition: subSchema,\n                        schemaDefinitions: schemaDefs,\n                        data: nestedData,\n                        editable: this.isEditable // Pass the display mode down to the child Engine!\n                    });\n\n                    // Only attach submit event if we are not in display mode\n                    if (!!this.isEditable) {\n                        host.attachSubmit((e: sap.ui.base.Event) => {\n                            const payload = e.getParameter(\"payload\");\n                            parentModel.setProperty(updatePath, payload);\n\n                            // CRITICAL: Notify the parent Engine that this field mutated\n                            // so it can trigger LiveUpdate syncs and validate!\n                            if (this.onChange) {\n                                this.onChange(true, propKey);\n                            }\n                        });\n                    }\n\n                    const buttonText = field.ui?.dialogButtonText || (!this.isEditable ? \"Close\" : \"OK\");\n                    host.openInDialog(`Nested Records: ${field.ui?.label || propKey}`, buttonText);\n                });\n            }\n        });\n        \n        return this.control as Control;\n    }\n\n    /**\n     * Read-only component for the engine, returns null.\n     */\n    protected getValue(): unknown {\n        return null;\n    }\n\n    /**\n     * Read-only component, no dynamic state handling needed for the button itself.\n     */\n    protected applyState(): void {\n        // dynamic state changes\n    }\n}\n"],"mappings":"yEAAA,MAKSA,EAAUC,EAAA,cAMZ,MAAMC,UAAoBF,EAWtBG,OAAOC,EAA2BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAC/GC,KAAKD,SAAWA,EAChBC,KAAKC,SAAWN,EAChB,MAAMO,EAAUN,EAAYO,WAAW,KAAOP,EAAYQ,UAAU,GAAKR,EAEzE,MAAMS,EAAqB,CACvBC,KAAM,QACNC,MAAOZ,EAAMa,IAAIC,OAASP,EAC1BQ,MAAOf,EAAMe,OAAS,CAClBJ,KAAM,SACNK,WAAY,CAAC,IAIrB,GAAIhB,EAAMiB,SAAU,CAChBP,EAAUO,SAAWjB,EAAMiB,QAC/B,CAEAZ,KAAKa,QAAU,IAAIC,EAAO,CACtBC,GAAIf,KAAKgB,iBAAiBlB,EAAeF,GACzCqB,MAAOjB,KAAKkB,WAAa,eAAiB,eAC1CC,MAAOnB,KAAKkB,WAAa,qBAAuB,kBAChDE,MAAQC,IACJ,MAAMC,EAAMD,EAAOE,YACnB,MAAMC,EAAcF,EAAIG,SAAS5B,GACjC,IAAK2B,EAAa,OAElB,MAAME,EAAiBJ,EAAIK,kBAAkB9B,GAC7C,IAAI+B,EAAahC,EACjB,GAAI8B,IAAmB9B,EAAYO,WAAW,KAAM,CAChD,MAAM0B,EAAUH,EAAeI,UAC/BF,EAAaC,EAAQE,SAAS,KAAOF,EAAUjC,EAAeiC,IAAY,IAAM,IAAMjC,EAAciC,EAAU,IAAMjC,CACxH,CAGA,MAAMoC,EAAaC,KAAKC,MAAMD,KAAKE,UAAUX,EAAYY,YAAYR,IAAe,KAEpF,IAAIS,EAASf,EAAIgB,YACjB,IAAIC,EAAa,KACjB,MAAOF,EAAQ,CACX,GAAIA,EAAOG,cAAcC,YAAc,0DACnCJ,EAAOG,cAAcC,YAAc,kDAAmD,CACtFF,EAAaF,EACb,KACJ,CACAA,EAASA,EAAOC,WACpB,CACA,MAAMI,EAAaH,EAAaA,EAAWH,YAAY,qBAAuB,KAE9EO,IAAInC,GAAGoC,QAAQ,CAAC,mDAAqDC,IACjE,MAAMC,EAAO,IAAID,EAAY,CACzBE,iBAAkB1C,EAClB2C,kBAAmBN,EACnBO,KAAMjB,EACNkB,SAAUlD,KAAKkB,aAInB,KAAMlB,KAAKkB,WAAY,CACnB4B,EAAKK,aAAcC,IACf,MAAMC,EAAUD,EAAEE,aAAa,WAC/B9B,EAAY+B,YAAY3B,EAAYyB,GAIpC,GAAIrD,KAAKD,SAAU,CACfC,KAAKD,SAAS,KAAMG,EACxB,GAER,CAEA,MAAMsD,EAAa7D,EAAMa,IAAIiD,oBAAsBzD,KAAKkB,WAAa,QAAU,MAC/E4B,EAAKY,aAAa,mBAAmB/D,EAAMa,IAAIC,OAASP,IAAWsD,QAK/E,OAAOxD,KAAKa,OAChB,CAKU8C,WACN,OAAO,IACX,CAKUC,aACN,EAEP,IAAAC,EAAA,CAAAC,WAAA,MAAAD,EAAApE,cAAA,OAAAoE,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/ArrayPlugin.ts

@@ -57,9 +57,22 @@ export class ArrayPlugin extends BasePlugin {
                 // Deep clone to prevent live-mutations on the parent model before 'Submit' is clicked
                 const nestedData = JSON.parse(JSON.stringify(parentModel.getProperty(updatePath) || []));
 
+                let parent = btn.getParent();
+                let parentHost = null;
+                while (parent) {
+                    if (parent.getMetadata().getName() === "nz.co.siliconst.ui5.metaui.controls.host.GeneratorHost" || 
+                        parent.getMetadata().getName() === "nz.co.siliconst.ui5.metaui.controls.DynamicHost") {
+                        parentHost = parent as any;
+                        break;
+                    }
+                    parent = parent.getParent();
+                }
+                const schemaDefs = parentHost ? parentHost.getProperty("schemaDefinitions") : null;
+
                 sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"], (DynamicHost: typeof import("../../controls/DynamicHost").default) => {
                     const host = new DynamicHost({
                         schemaDefinition: subSchema,
+                        schemaDefinitions: schemaDefs,
                         data: nestedData,
                         editable: this.isEditable // Pass the display mode down to the child Engine!
                     });

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/BarcodeScannerPlugin-dbg.js

@@ -21,14 +21,14 @@ sap.ui.define(["../controls/BasePlugin", "sap/m/HBox", "sap/m/Input", "sap/ndc/B
       if (!this.isEditable) {
         this.control = new TextControl({
           id: this.generateStableId(engineScopeId, bindingPath),
-          text: `{${modelName}>${bindingPath}}`
+          text: this.generateBindingInfo(bindingPath, modelName)
         });
         this.applyCommonDirectives(this.control, metadata, modelName);
         return this.control;
       }
       this.inputControl = new Input({
         id: this.generateStableId(engineScopeId, bindingPath + "-input"),
-        value: `{${modelName}>${bindingPath}}`,
+        value: this.generateBindingInfo(bindingPath, modelName),
         editable: !metadata.ui?.readOnly,
         width: "100%",
         change: () => {

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/BarcodeScannerPlugin-dbg.js.map

@@ -1 +1 @@
-{"version":3,"file":"BarcodeScannerPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","BarcodeScannerPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","applyCommonDirectives","inputControl","Input","value","editable","ui","readOnly","width","change","result","validateAndApplyVisualState","isValid","scannerBtn","BarcodeScannerButton","scanSuccess","oEvent","getParameter","setValue","HBox","items","addStyleClass","getValue","applyState","setEditable","__exports","__esModule"],"sources":["BarcodeScannerPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport HBox from \"sap/m/HBox\";\nimport Input from \"sap/m/Input\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport BarcodeScannerButton from \"sap/ndc/BarcodeScannerButton\";\nimport TextControl from \"sap/m/Text\";\n\nexport class BarcodeScannerPlugin extends BasePlugin {\n    private inputControl!: Input;\n\n    /**\n     * Renders a `BarcodeScannerButton` alongside an `Input`.\n     * \n     * @param metadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured HBox control.\n     */\n    public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = metadata;\n        this.fieldKey = bindingPath.replace('/', '');\n        this.modelName = modelName;\n\n        if (!this.isEditable) {\n            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: `{${modelName}>${bindingPath}}`\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.inputControl = new Input({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-input\"),\n            value: `{${modelName}>${bindingPath}}`,\n            editable: !metadata.ui?.readOnly,\n            width: \"100%\",\n            change: () => {\n                const result = this.validateAndApplyVisualState();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n        \n        const scannerBtn = new BarcodeScannerButton({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-btn\"),\n            scanSuccess: (oEvent: sap.ui.base.Event) => {\n                const text = oEvent.getParameter(\"text\") as string;\n                if (text) {\n                    this.inputControl.setValue(text);\n                    // UI5's two-way data binding on the input will sync the model automatically\n                    const result = this.validateAndApplyVisualState();\n                    if (this.onChange) {\n                        this.onChange(result.isValid, this.fieldKey);\n                    }\n                }\n            }\n        });\n\n        this.control = new HBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            items: [this.inputControl, scannerBtn],\n            width: \"100%\"\n        }).addStyleClass(\"sapUiSmallMarginBottom\");\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current scanned text.\n     * @returns {unknown} The barcode string.\n     */\n    protected getValue(): unknown {\n        return this.inputControl ? this.inputControl.getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.inputControl && this.metadata) {\n            if (!this.isEditable) return;\n            this.inputControl.setEditable(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"BarcodeScannerPlugin-dbg.js","names":["BasePlugin","___controls_BasePlugin","BarcodeScannerPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","generateBindingInfo","applyCommonDirectives","inputControl","Input","value","editable","ui","readOnly","width","change","result","validateAndApplyVisualState","isValid","scannerBtn","BarcodeScannerButton","scanSuccess","oEvent","getParameter","setValue","HBox","items","addStyleClass","getValue","applyState","setEditable","__exports","__esModule"],"sources":["BarcodeScannerPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport HBox from \"sap/m/HBox\";\nimport Input from \"sap/m/Input\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport BarcodeScannerButton from \"sap/ndc/BarcodeScannerButton\";\nimport TextControl from \"sap/m/Text\";\n\nexport class BarcodeScannerPlugin extends BasePlugin {\n    private inputControl!: Input;\n\n    /**\n     * Renders a `BarcodeScannerButton` alongside an `Input`.\n     * \n     * @param metadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured HBox control.\n     */\n    public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = metadata;\n        this.fieldKey = bindingPath.replace('/', '');\n        this.modelName = modelName;\n\n        if (!this.isEditable) {\n            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: this.generateBindingInfo(bindingPath, modelName)\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.inputControl = new Input({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-input\"),\n            value: this.generateBindingInfo(bindingPath, modelName),\n            editable: !metadata.ui?.readOnly,\n            width: \"100%\",\n            change: () => {\n                const result = this.validateAndApplyVisualState();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n        \n        const scannerBtn = new BarcodeScannerButton({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-btn\"),\n            scanSuccess: (oEvent: sap.ui.base.Event) => {\n                const text = oEvent.getParameter(\"text\") as string;\n                if (text) {\n                    this.inputControl.setValue(text);\n                    // UI5's two-way data binding on the input will sync the model automatically\n                    const result = this.validateAndApplyVisualState();\n                    if (this.onChange) {\n                        this.onChange(result.isValid, this.fieldKey);\n                    }\n                }\n            }\n        });\n\n        this.control = new HBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            items: [this.inputControl, scannerBtn],\n            width: \"100%\"\n        }).addStyleClass(\"sapUiSmallMarginBottom\");\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current scanned text.\n     * @returns {unknown} The barcode string.\n     */\n    protected getValue(): unknown {\n        return this.inputControl ? this.inputControl.getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.inputControl && this.metadata) {\n            if (!this.isEditable) return;\n            this.inputControl.setEditable(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/BarcodeScannerPlugin.js

@@ -1,2 +1,2 @@
-sap.ui.define(["../controls/BasePlugin","sap/m/HBox","sap/m/Input","sap/ndc/BarcodeScannerButton","sap/m/Text"],function(t,e,i,n,a){"use strict";const s=t["BasePlugin"];class l extends s{render(t,s,l="meta",o,r){this.onChange=r;this.metadata=t;this.fieldKey=s.replace("/","");this.modelName=l;if(!this.isEditable){this.control=new a({id:this.generateStableId(o,s),text:`{${l}>${s}}`});this.applyCommonDirectives(this.control,t,l);return this.control}this.inputControl=new i({id:this.generateStableId(o,s+"-input"),value:`{${l}>${s}}`,editable:!t.ui?.readOnly,width:"100%",change:()=>{const t=this.validateAndApplyVisualState();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}}});const h=new n({id:this.generateStableId(o,s+"-btn"),scanSuccess:t=>{const e=t.getParameter("text");if(e){this.inputControl.setValue(e);const t=this.validateAndApplyVisualState();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}}}});this.control=new e({id:this.generateStableId(o,s),items:[this.inputControl,h],width:"100%"}).addStyleClass("sapUiSmallMarginBottom");this.applyCommonDirectives(this.control,t,l);return this.control}getValue(){return this.inputControl?this.inputControl.getValue():null}applyState(){if(this.inputControl&&this.metadata){if(!this.isEditable)return;this.inputControl.setEditable(!this.metadata.ui?.readOnly)}}}var o={__esModule:true};o.BarcodeScannerPlugin=l;return o});
+sap.ui.define(["../controls/BasePlugin","sap/m/HBox","sap/m/Input","sap/ndc/BarcodeScannerButton","sap/m/Text"],function(t,e,i,n,a){"use strict";const s=t["BasePlugin"];class l extends s{render(t,s,l="meta",o,r){this.onChange=r;this.metadata=t;this.fieldKey=s.replace("/","");this.modelName=l;if(!this.isEditable){this.control=new a({id:this.generateStableId(o,s),text:this.generateBindingInfo(s,l)});this.applyCommonDirectives(this.control,t,l);return this.control}this.inputControl=new i({id:this.generateStableId(o,s+"-input"),value:this.generateBindingInfo(s,l),editable:!t.ui?.readOnly,width:"100%",change:()=>{const t=this.validateAndApplyVisualState();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}}});const h=new n({id:this.generateStableId(o,s+"-btn"),scanSuccess:t=>{const e=t.getParameter("text");if(e){this.inputControl.setValue(e);const t=this.validateAndApplyVisualState();if(this.onChange){this.onChange(t.isValid,this.fieldKey)}}}});this.control=new e({id:this.generateStableId(o,s),items:[this.inputControl,h],width:"100%"}).addStyleClass("sapUiSmallMarginBottom");this.applyCommonDirectives(this.control,t,l);return this.control}getValue(){return this.inputControl?this.inputControl.getValue():null}applyState(){if(this.inputControl&&this.metadata){if(!this.isEditable)return;this.inputControl.setEditable(!this.metadata.ui?.readOnly)}}}var o={__esModule:true};o.BarcodeScannerPlugin=l;return o});
 //# sourceMappingURL=BarcodeScannerPlugin.js.map

package/src/nz/co/siliconst/ui5/metaui/plugins/controls/BarcodeScannerPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"BarcodeScannerPlugin.js","names":["BasePlugin","___controls_BasePlugin","BarcodeScannerPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","this","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","applyCommonDirectives","inputControl","Input","value","editable","ui","readOnly","width","change","result","validateAndApplyVisualState","isValid","scannerBtn","BarcodeScannerButton","scanSuccess","oEvent","getParameter","setValue","HBox","items","addStyleClass","getValue","applyState","setEditable","__exports","__esModule"],"sources":["BarcodeScannerPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport HBox from \"sap/m/HBox\";\nimport Input from \"sap/m/Input\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport BarcodeScannerButton from \"sap/ndc/BarcodeScannerButton\";\nimport TextControl from \"sap/m/Text\";\n\nexport class BarcodeScannerPlugin extends BasePlugin {\n    private inputControl!: Input;\n\n    /**\n     * Renders a `BarcodeScannerButton` alongside an `Input`.\n     * \n     * @param metadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured HBox control.\n     */\n    public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = metadata;\n        this.fieldKey = bindingPath.replace('/', '');\n        this.modelName = modelName;\n\n        if (!this.isEditable) {\n            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: `{${modelName}>${bindingPath}}`\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.inputControl = new Input({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-input\"),\n            value: `{${modelName}>${bindingPath}}`,\n            editable: !metadata.ui?.readOnly,\n            width: \"100%\",\n            change: () => {\n                const result = this.validateAndApplyVisualState();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n        \n        const scannerBtn = new BarcodeScannerButton({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-btn\"),\n            scanSuccess: (oEvent: sap.ui.base.Event) => {\n                const text = oEvent.getParameter(\"text\") as string;\n                if (text) {\n                    this.inputControl.setValue(text);\n                    // UI5's two-way data binding on the input will sync the model automatically\n                    const result = this.validateAndApplyVisualState();\n                    if (this.onChange) {\n                        this.onChange(result.isValid, this.fieldKey);\n                    }\n                }\n            }\n        });\n\n        this.control = new HBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            items: [this.inputControl, scannerBtn],\n            width: \"100%\"\n        }).addStyleClass(\"sapUiSmallMarginBottom\");\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current scanned text.\n     * @returns {unknown} The barcode string.\n     */\n    protected getValue(): unknown {\n        return this.inputControl ? this.inputControl.getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.inputControl && this.metadata) {\n            if (!this.isEditable) return;\n            this.inputControl.setEditable(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"uJAASA,EAAUC,EAAA,cASZ,MAAMC,UAA6BF,EAa/BG,OAAOC,EAA8BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAClHC,KAAKD,SAAWA,EAChBC,KAAKL,SAAWA,EAChBK,KAAKC,SAAWL,EAAYM,QAAQ,IAAK,IACzCF,KAAKH,UAAYA,EAEjB,IAAKG,KAAKG,WAAY,CAElBH,KAAKI,QAAU,IAAIC,EAAY,CAC3BC,GAAIN,KAAKO,iBAAiBT,EAAeF,GACzCY,KAAM,IAAIX,KAAaD,OAE3BI,KAAKS,sBAAsBT,KAAKI,QAAST,EAAUE,GACnD,OAAOG,KAAKI,OAChB,CAEAJ,KAAKU,aAAe,IAAIC,EAAM,CAC1BL,GAAIN,KAAKO,iBAAiBT,EAAeF,EAAc,UACvDgB,MAAO,IAAIf,KAAaD,KACxBiB,UAAWlB,EAASmB,IAAIC,SACxBC,MAAO,OACPC,OAAQA,KACJ,MAAMC,EAASlB,KAAKmB,8BACpB,GAAInB,KAAKD,SAAU,CACfC,KAAKD,SAASmB,EAAOE,QAASpB,KAAKC,SACvC,KAIR,MAAMoB,EAAa,IAAIC,EAAqB,CACxChB,GAAIN,KAAKO,iBAAiBT,EAAeF,EAAc,QACvD2B,YAAcC,IACV,MAAMhB,EAAOgB,EAAOC,aAAa,QACjC,GAAIjB,EAAM,CACNR,KAAKU,aAAagB,SAASlB,GAE3B,MAAMU,EAASlB,KAAKmB,8BACpB,GAAInB,KAAKD,SAAU,CACfC,KAAKD,SAASmB,EAAOE,QAASpB,KAAKC,SACvC,CACJ,KAIRD,KAAKI,QAAU,IAAIuB,EAAK,CACpBrB,GAAIN,KAAKO,iBAAiBT,EAAeF,GACzCgC,MAAO,CAAC5B,KAAKU,aAAcW,GAC3BL,MAAO,SACRa,cAAc,0BAEjB7B,KAAKS,sBAAsBT,KAAKI,QAAST,EAAUE,GAEnD,OAAOG,KAAKI,OAChB,CAMU0B,WACN,OAAO9B,KAAKU,aAAeV,KAAKU,aAAaoB,WAAa,IAC9D,CAKUC,aACN,GAAI/B,KAAKU,cAAgBV,KAAKL,SAAU,CACpC,IAAKK,KAAKG,WAAY,OACtBH,KAAKU,aAAasB,aAAahC,KAAKL,SAASmB,IAAIC,SACrD,CACJ,EACH,IAAAkB,EAAA,CAAAC,WAAA,MAAAD,EAAAxC,uBAAA,OAAAwC,CAAA","ignoreList":[]}
+{"version":3,"file":"BarcodeScannerPlugin.js","names":["BasePlugin","___controls_BasePlugin","BarcodeScannerPlugin","render","metadata","bindingPath","modelName","engineScopeId","onChange","this","fieldKey","replace","isEditable","control","TextControl","id","generateStableId","text","generateBindingInfo","applyCommonDirectives","inputControl","Input","value","editable","ui","readOnly","width","change","result","validateAndApplyVisualState","isValid","scannerBtn","BarcodeScannerButton","scanSuccess","oEvent","getParameter","setValue","HBox","items","addStyleClass","getValue","applyState","setEditable","__exports","__esModule"],"sources":["BarcodeScannerPlugin.ts"],"sourcesContent":["import { BasePlugin } from \"../controls/BasePlugin\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport Control from \"sap/ui/core/Control\";\nimport HBox from \"sap/m/HBox\";\nimport Input from \"sap/m/Input\";\nimport JSONModel from \"sap/ui/model/json/JSONModel\";\nimport BarcodeScannerButton from \"sap/ndc/BarcodeScannerButton\";\nimport TextControl from \"sap/m/Text\";\n\nexport class BarcodeScannerPlugin extends BasePlugin {\n    private inputControl!: Input;\n\n    /**\n     * Renders a `BarcodeScannerButton` alongside an `Input`.\n     * \n     * @param metadata The specific JSON schema properties for this field.\n     * @param bindingPath The JSON path bound to this control.\n     * @param modelName The UI5 JSONModel name.\n     * @param engineScopeId The deterministic scope ID.\n     * @param onChange The callback fired on value change.\n     * @returns {Control} The configured HBox control.\n     */\n    public render(metadata: IPropertyMetadata,  bindingPath: string,  modelName: string = \"meta\", engineScopeId?: string, onChange?: (isValid: boolean, fieldKey?: string) => void): Control {\n        this.onChange = onChange;\n        this.metadata = metadata;\n        this.fieldKey = bindingPath.replace('/', '');\n        this.modelName = modelName;\n\n        if (!this.isEditable) {\n            \n            this.control = new TextControl({\n                id: this.generateStableId(engineScopeId, bindingPath),\n                text: this.generateBindingInfo(bindingPath, modelName)\n            });\n            this.applyCommonDirectives(this.control, metadata, modelName);\n            return this.control as Control;\n        }\n\n        this.inputControl = new Input({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-input\"),\n            value: this.generateBindingInfo(bindingPath, modelName),\n            editable: !metadata.ui?.readOnly,\n            width: \"100%\",\n            change: () => {\n                const result = this.validateAndApplyVisualState();\n                if (this.onChange) {\n                    this.onChange(result.isValid, this.fieldKey);\n                }\n            }\n        });\n        \n        const scannerBtn = new BarcodeScannerButton({\n            id: this.generateStableId(engineScopeId, bindingPath + \"-btn\"),\n            scanSuccess: (oEvent: sap.ui.base.Event) => {\n                const text = oEvent.getParameter(\"text\") as string;\n                if (text) {\n                    this.inputControl.setValue(text);\n                    // UI5's two-way data binding on the input will sync the model automatically\n                    const result = this.validateAndApplyVisualState();\n                    if (this.onChange) {\n                        this.onChange(result.isValid, this.fieldKey);\n                    }\n                }\n            }\n        });\n\n        this.control = new HBox({\n            id: this.generateStableId(engineScopeId, bindingPath),\n            items: [this.inputControl, scannerBtn],\n            width: \"100%\"\n        }).addStyleClass(\"sapUiSmallMarginBottom\");\n\n        this.applyCommonDirectives(this.control, metadata, modelName);\n\n        return this.control as Control;\n    }\n\n    /**\n     * Retrieves the current scanned text.\n     * @returns {unknown} The barcode string.\n     */\n    protected getValue(): unknown {\n        return this.inputControl ? this.inputControl.getValue() : null;\n    }\n\n    /**\n     * Applies dynamic read-only state.\n     */\n    protected applyState(): void {\n        if (this.inputControl && this.metadata) {\n            if (!this.isEditable) return;\n            this.inputControl.setEditable(!this.metadata.ui?.readOnly);\n        }\n    }\n}\n"],"mappings":"uJAASA,EAAUC,EAAA,cASZ,MAAMC,UAA6BF,EAa/BG,OAAOC,EAA8BC,EAAsBC,EAAoB,OAAQC,EAAwBC,GAClHC,KAAKD,SAAWA,EAChBC,KAAKL,SAAWA,EAChBK,KAAKC,SAAWL,EAAYM,QAAQ,IAAK,IACzCF,KAAKH,UAAYA,EAEjB,IAAKG,KAAKG,WAAY,CAElBH,KAAKI,QAAU,IAAIC,EAAY,CAC3BC,GAAIN,KAAKO,iBAAiBT,EAAeF,GACzCY,KAAMR,KAAKS,oBAAoBb,EAAaC,KAEhDG,KAAKU,sBAAsBV,KAAKI,QAAST,EAAUE,GACnD,OAAOG,KAAKI,OAChB,CAEAJ,KAAKW,aAAe,IAAIC,EAAM,CAC1BN,GAAIN,KAAKO,iBAAiBT,EAAeF,EAAc,UACvDiB,MAAOb,KAAKS,oBAAoBb,EAAaC,GAC7CiB,UAAWnB,EAASoB,IAAIC,SACxBC,MAAO,OACPC,OAAQA,KACJ,MAAMC,EAASnB,KAAKoB,8BACpB,GAAIpB,KAAKD,SAAU,CACfC,KAAKD,SAASoB,EAAOE,QAASrB,KAAKC,SACvC,KAIR,MAAMqB,EAAa,IAAIC,EAAqB,CACxCjB,GAAIN,KAAKO,iBAAiBT,EAAeF,EAAc,QACvD4B,YAAcC,IACV,MAAMjB,EAAOiB,EAAOC,aAAa,QACjC,GAAIlB,EAAM,CACNR,KAAKW,aAAagB,SAASnB,GAE3B,MAAMW,EAASnB,KAAKoB,8BACpB,GAAIpB,KAAKD,SAAU,CACfC,KAAKD,SAASoB,EAAOE,QAASrB,KAAKC,SACvC,CACJ,KAIRD,KAAKI,QAAU,IAAIwB,EAAK,CACpBtB,GAAIN,KAAKO,iBAAiBT,EAAeF,GACzCiC,MAAO,CAAC7B,KAAKW,aAAcW,GAC3BL,MAAO,SACRa,cAAc,0BAEjB9B,KAAKU,sBAAsBV,KAAKI,QAAST,EAAUE,GAEnD,OAAOG,KAAKI,OAChB,CAMU2B,WACN,OAAO/B,KAAKW,aAAeX,KAAKW,aAAaoB,WAAa,IAC9D,CAKUC,aACN,GAAIhC,KAAKW,cAAgBX,KAAKL,SAAU,CACpC,IAAKK,KAAKG,WAAY,OACtBH,KAAKW,aAAasB,aAAajC,KAAKL,SAASoB,IAAIC,SACrD,CACJ,EACH,IAAAkB,EAAA,CAAAC,WAAA,MAAAD,EAAAzC,uBAAA,OAAAyC,CAAA","ignoreList":[]}