@siliconst/metaui 1.2.0 → 1.4.5

package/README.md

@@ -1,19 +1,49 @@
 # MetaUI
 
-**MetaUI** is a metadata-driven UI5 rendering engine. It provides a mechanism to generate SAP Fiori architectures at runtime by parsing standard JSON Schema definitions, reducing the requirement for manual XML View construction.
+**MetaUI** is an extensible, metadata-driven UI engine built on top of SAP UI5. Instead of relying on static XML views, it parses standard JSON Schema definitions at runtime to dynamically generate SAP Fiori component trees. This enables server-driven architectures where the UI structure and data bindings are determined entirely by the incoming payload.
+
+## MetaUI vs. Fiori Elements
+It is important to note that MetaUI is **not** an attempt to replace SAP Fiori Elements. Fiori Elements is a robust framework for building UIs driven by static OData CDS annotations. 
+
+MetaUI is designed for use cases where **CDS annotations are unavailable, impossible, or too rigid.** 
+- **Highly Dynamic**: MetaUI parses standard JSON Schemas at runtime, allowing you to generate completely dynamic layouts based on user roles, remote APIs, or NoSQL databases where the schema isn't known until execution.
+- **Backend Agnostic**: Because it relies on universal JSON rather than OData metadata, MetaUI can be plugged into virtually any tech stack (Node.js, Firebase, GraphQL, REST).
+
+## 🚀 Key Features
 
 Built for strict UI5 architecture adherence, MetaUI enforces modularity through a Plugin-based design and explicitly avoids inline DOM manipulation.
 
+- **100% Schema Inference**: Bind raw JSON to the new `DynamicHost` and the engine will instantly infer the metadata, schema, and layout on the fly.
+- **Hybrid / Partial Schema Inference**: Supports the standard JSON-Schema `additionalProperties: true` directive. Provide a minimal "Partial Schema" to override specific UI elements (e.g. converting a string into a dropdown), and the engine will recursively deep-merge it with an automatically inferred schema generated from the rest of your data payload.
+- **Strict Array Routing**: Pure contract-based routing strictly separates sub-layouts (arrays of objects) from inline field plugins (primitive arrays), enabling flawless complex nested rendering without hacky edge cases.
+- **True Two-Way Sync**: Safely double-bind `data` and `data` to the exact same UI5 model property. Built-in `deepEqual` loop-breakers catch UI5 data echoes, perfectly preserving user cursor focus during live model swaps.
+
 ✨ **[Play with the Live Interactive Demo Here!](https://SiliconStreetDev1.github.io/MetaUI/index.html)** ✨
 
 ---
 
+## 📚 Technical Documentation
+
+For detailed information regarding the JSON Schema properties, `ui.*` orchestrations, and recursive nested arrays, consult the payload formats specification:
+
+- [MetaUI Documentation Wiki](docs/wiki/Home.md)
+- [Payload Formats & Directives](docs/payload_formats.md)
+- [Fiori Integration Guide](docs/fiori_integration.md)
+- [Custom Plugin Authorship Guide](docs/plugin_authorship.md)
+
+---
+
 ## 🏗 Architecture & Design Tenets
 
 1. **JSON-Schema Core:** MetaUI parses standard recursive JSON Schema `properties` blocks (`Record<string, IPropertyMetadata>`).
 2. **Implicit Layout Orchestration:** The `Engine` determines standard Layouts based on payload shape. Root `object` types map to `FormLayout` clusters. Root `array` types map to `TableLayout` instances. Nested arrays trigger recursive drill-down dialogs.
 3. **ConditionEngine Compilation:** Cross-context visibility rules (e.g., `"$root.status === 'DRAFT'"`) are transpiled into native UI5 Expression Bindings to utilize native reactivity.
-4. **Strict Plugin Pipeline:** The `PluginRegistry` isolates control instantiation. Core layout managers delegate to registered implementations of `IPlugin`.
+4. **Universal Plugin Architecture:** The `PluginRegistry` isolates control instantiation. Core layout managers delegate to registered implementations of `IPlugin`. Plugins are rigorously segregated into:
+   - `plugins/controls/`: Visual UI components (e.g., String, Date).
+   - `plugins/validators/`: Custom business logic constraints.
+   - `plugins/formatters/`: Data transformation utilities.
+   - `plugins/actions/`: Button and execution handlers.
+   - `plugins/datasources/`: Remote value help providers.
 
 ---
 
@@ -39,28 +69,38 @@ The test suite will boot at `http://localhost:8080/index.html`.
 Import the compiled library namespace into your UI5 project. 
 
 ```javascript
-sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/GeneratorHost"], function (GeneratorHost) {
-    const host = new GeneratorHost({
+sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/DynamicHost"], function (DynamicHost) {
+    const host = new DynamicHost({
         // The Schema Definition
         schemaDefinition: {
             type: "object",
+            uiLayout: [
+                {
+                    type: "Group",
+                    label: "User Settings",
+                    elements: [
+                        { type: "Control", scope: "#/properties/Username" },
+                        { type: "Control", scope: "#/properties/IsActive" }
+                    ]
+                }
+            ],
             properties: {
                 Username: { type: "string", ui: { label: "User Name" } },
                 IsActive: { type: "boolean", ui: { label: "Active", widget: "switch" } }
             }
         },
         // The Data Payload
-        initialData: {
-            Username: "JDoe",
-            IsActive: true
-        }
+        data: {
+            "FirstName": "John",
+            "LastName": "Doe"
+        },
     });
 
     // Option A: Render inside an existing container
     myVBox.addItem(host);
     
     // Option B: Mount as an isolated Dialog
-    host.openInDialog("User Configuration", "Save");
+    host.openInDialog("User Configuration", "OK");
 
     // Capture the extracted JSON payload on submit
     host.attachSubmit(function(oEvent) {
@@ -72,13 +112,32 @@ sap.ui.require(["nz/co/siliconst/ui5/metaui/controls/GeneratorHost"], function (
 
 ### Declarative XML Binding
 
+The `DynamicHost` fully supports declarative XML instantiation in traditional UI5 views:
+
+```xml
+<mvc:View
+    xmlns:mvc="sap.ui.core.mvc"
+    xmlns:meta="nz.co.siliconst.ui5.metaui.controls">
+    
+    <meta:DynamicHost 
+        id="dynamicFormHost" 
+        schemaDefinition="{backend>/SchemaDefinition}" 
+        data="{backend>/PayloadData}" 
+        useMessageManager="true"
+        submit=".onMetaFormSubmit" />
+        
+</mvc:View>
+```
+
+### Validation
+
 MetaUI supports client-side validation based on JSON Schema constraints natively.
 
-### Mandatory Fields
+#### Mandatory Fields
 Adding `"required": true` to any property in the schema will enforce input validation prior to the `submit` event being fired.
 
 ### Custom Validation Exits (`beforeSubmit`)
-For business logic requiring custom checks (e.g., async validation), the `GeneratorHost` provides a `beforeSubmit` event.
+For business logic requiring custom checks (e.g., async validation), the `DynamicHost` provides a `beforeSubmit` event.
 
 ```javascript
 onBeforeSubmit: function(oEvent) {
@@ -93,42 +152,52 @@ onBeforeSubmit: function(oEvent) {
 }
 ```
 
+### Asynchronous Field Validation (`fieldChange`)
+For real-time validation (like checking if a username is taken), listen to the `fieldChange` event. You can lock the form using `setBusy(true)`, perform your async check, and imperatively paint the field red using `addCustomError()` if the check fails.
+
+```javascript
+onFieldChange: function(oEvent) {
+    const fieldPath = oEvent.getParameter("fieldPath");
+    const value = oEvent.getParameter("value");
+    const host = oEvent.getSource();
+
+    if (fieldPath === "Username") {
+        host.setBusy(true); // Lock the UI5 form
+        
+        myBackendService.checkUsername(value).then((isTaken) => {
+            if (isTaken) {
+                host.addCustomError("Username", "This username is taken.");
+            } else {
+                host.clearCustomError("Username");
+            }
+        }).finally(() => {
+            host.setBusy(false); // Unlock
+        });
+    }
+}
+```
+
 ### Fiori Message Manager Integration
-By default, validation errors are shown locally. To aggregate validation errors into the global UI5 Message Popover, enable `useMessageManager` on the `GeneratorHost`:
+By default, validation errors are shown locally. To aggregate validation errors into the global UI5 Message Popover, enable `useMessageManager` on the `DynamicHost`:
 
 ```xml
-<meta:GeneratorHost
+<meta:DynamicHost
     schemaDefinition="{/mySchema}"
     useMessageManager="true"
     beforeSubmit=".onBeforeSubmit"
     submit=".onSubmit" />
 ```
 
-## Supported Features
 
-The `GeneratorHost` fully supports declarative XML instantiation in traditional UI5 views:
-
-```xml
-<mvc:View
-    xmlns:mvc="sap.ui.core.mvc"
-    xmlns:meta="nz.co.siliconst.ui5.metaui.controls">
-    
-    <meta:GeneratorHost 
-        id="metaHost"
-        schemaDefinition="{backend>/schema}" 
-        initialData="{backend>/data}" 
-        submit=".onFormSubmit" />
-        
-</mvc:View>
-```
 
 ---
 
-## 📚 Technical Documentation
+## ⚖️ License & Disclaimer
 
-For detailed information regarding the JSON Schema properties, `ui.*` orchestrations, and recursive nested arrays, consult the payload formats specification:
+**MIT License**
 
-- [Payload Formats & Directives](docs/payload_formats.md)
-- [Fiori Integration Guide](docs/fiori_integration.md)
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+> [!WARNING]
+> **Disclaimer**: This software is provided "as is", without warranty of any kind, express or implied. Use of this project in production environments is at your own risk. The authors shall not be liable for any damages or issues arising from its usage.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siliconst/metaui",
-  "version": "1.2.0",
+  "version": "1.4.5",
   "description": "Dynamic Metadata UI5 Engine",
   "author": "SiliconStreetDev1",
   "license": "MIT",

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

@@ -0,0 +1,70 @@
+sap.ui.define(["sap/ui/core/Control", "./BaseHardwareControlRenderer"], function (Control, __BaseHardwareControlRenderer) {
+  "use strict";
+
+  function _interopRequireDefault(obj) {
+    return obj && obj.__esModule && typeof obj.default !== "undefined" ? obj.default : obj;
+  }
+  const BaseHardwareControlRenderer = _interopRequireDefault(__BaseHardwareControlRenderer);
+  /**
+   * @namespace nz.co.siliconst.ui5.metaui.controls
+   */
+  const BaseHardwareControl = Control.extend("nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl", {
+    /**
+     * Common renderer for all hardware controls
+     */
+    renderer: BaseHardwareControlRenderer,
+    metadata: {
+      properties: {
+        /** The raw data value. Two-way bound to the model. */
+        value: {
+          type: "any",
+          defaultValue: null
+        },
+        /** The schema metadata for rendering dynamic hints (like labels/readOnly) */
+        schemaMetadata: {
+          type: "object",
+          defaultValue: null
+        },
+        /** Indicates if the control should be in a read-only state */
+        readOnly: {
+          type: "boolean",
+          defaultValue: false
+        }
+      },
+      aggregations: {
+        _content: {
+          type: "sap.m.VBox",
+          multiple: false,
+          visibility: "hidden"
+        }
+      },
+      events: {
+        /** Fired when the hardware successfully captures a value */
+        capture: {
+          parameters: {
+            value: {
+              type: "any"
+            }
+          }
+        }
+      }
+    },
+    /**
+     * Updates the bound value and fires the capture event.
+     */
+    setValueAndFire: function _setValueAndFire(val) {
+      this.setProperty("value", val, true); // true to suppress re-rendering if desired, but we want the binding to update
+      this.fireEvent("capture", {
+        value: val
+      });
+    },
+    /**
+     * Abstract hook for subclasses to render their specific DOM/Controls.
+     */
+    renderContent: function _renderContent(rm, control) {
+      // To be overridden by hardware implementations
+    }
+  });
+  return BaseHardwareControl;
+});
+//# sourceMappingURL=BaseHardwareControl-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControl-dbg.js","names":["BaseHardwareControlRenderer","_interopRequireDefault","__BaseHardwareControlRenderer","BaseHardwareControl","Control","extend","renderer","metadata","properties","value","type","defaultValue","schemaMetadata","readOnly","aggregations","_content","multiple","visibility","events","capture","parameters","setValueAndFire","_setValueAndFire","val","setProperty","fireEvent","renderContent","_renderContent","rm","control"],"sources":["BaseHardwareControl.ts"],"sourcesContent":["/**\n * @file BaseHardwareControl.ts\n * @description Foundational UI5 Custom Control for hardware plugins.\n * Exposes a standard 'value' property for pure two-way data binding.\n * \n */\n\nimport Control from \"sap/ui/core/Control\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport BaseHardwareControlRenderer from \"./BaseHardwareControlRenderer\";\n\n/**\n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nexport default class BaseHardwareControl extends Control {\n    static readonly metadata = {\n        properties: {\n            /** The raw data value. Two-way bound to the model. */\n            value: { type: \"any\", defaultValue: null },\n            /** The schema metadata for rendering dynamic hints (like labels/readOnly) */\n            schemaMetadata: { type: \"object\", defaultValue: null },\n            /** Indicates if the control should be in a read-only state */\n            readOnly: { type: \"boolean\", defaultValue: false }\n        },\n        aggregations: {\n            _content: { type: \"sap.m.VBox\", multiple: false, visibility: \"hidden\" }\n        },\n        events: {\n            /** Fired when the hardware successfully captures a value */\n            capture: {\n                parameters: {\n                    value: { type: \"any\" }\n                }\n            }\n        }\n    };\n\n    /**\n     * Updates the bound value and fires the capture event.\n     */\n    protected setValueAndFire(val: unknown): void {\n        this.setProperty(\"value\", val, true); // true to suppress re-rendering if desired, but we want the binding to update\n        this.fireEvent(\"capture\", { value: val });\n    }\n\n    /**\n     * Common renderer for all hardware controls\n     */\n    static readonly renderer = BaseHardwareControlRenderer;\n\n    /**\n     * Abstract hook for subclasses to render their specific DOM/Controls.\n     */\n    protected renderContent(rm: RenderManager, control: BaseHardwareControl): void {\n        // To be overridden by hardware implementations\n    }\n}\n"],"mappings":";;;;;;QAUOA,2BAA2B,GAAAC,sBAAA,CAAAC,6BAAA;EAElC;AACA;AACA;EAFA,MAGqBC,mBAAmB,GAASC,OAAO,CAAAC,MAAA;IA+BpD;AACJ;AACA;IACoBC,QAAQ,EAAGN,2BAA2B;IAjCtCO,QAAQ,EAAG;MACvBC,UAAU,EAAE;QACR;QACAC,KAAK,EAAE;UAAEC,IAAI,EAAE,KAAK;UAAEC,YAAY,EAAE;QAAK,CAAC;QAC1C;QACAC,cAAc,EAAE;UAAEF,IAAI,EAAE,QAAQ;UAAEC,YAAY,EAAE;QAAK,CAAC;QACtD;QACAE,QAAQ,EAAE;UAAEH,IAAI,EAAE,SAAS;UAAEC,YAAY,EAAE;QAAM;MACrD,CAAC;MACDG,YAAY,EAAE;QACVC,QAAQ,EAAE;UAAEL,IAAI,EAAE,YAAY;UAAEM,QAAQ,EAAE,KAAK;UAAEC,UAAU,EAAE;QAAS;MAC1E,CAAC;MACDC,MAAM,EAAE;QACJ;QACAC,OAAO,EAAE;UACLC,UAAU,EAAE;YACRX,KAAK,EAAE;cAAEC,IAAI,EAAE;YAAM;UACzB;QACJ;MACJ;IACJ,CAAC;IAED;AACJ;AACA;IACcW,eAAe,WAAAC,iBAACC,GAAY,EAAQ;MAC1C,IAAI,CAACC,WAAW,CAAC,OAAO,EAAED,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;MACtC,IAAI,CAACE,SAAS,CAAC,SAAS,EAAE;QAAEhB,KAAK,EAAEc;MAAI,CAAC,CAAC;IAC7C,CAAC;IAOD;AACJ;AACA;IACcG,aAAa,WAAAC,eAACC,EAAiB,EAAEC,OAA4B,EAAQ;MAC3E;IAAA;EACH;EAAA,OAzCgB1B,mBAAmB;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.d.ts

@@ -0,0 +1,67 @@
+declare module "nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl" {
+    /**
+     * @file BaseHardwareControl.ts
+     * @description Foundational UI5 Custom Control for hardware plugins.
+     * Exposes a standard 'value' property for pure two-way data binding.
+     *
+     */
+    import Control from "sap/ui/core/Control";
+    import RenderManager from "sap/ui/core/RenderManager";
+    /**
+     * @namespace nz.co.siliconst.ui5.metaui.controls
+     */
+    export default class BaseHardwareControl extends Control {
+        static readonly metadata: {
+            properties: {
+                /** The raw data value. Two-way bound to the model. */
+                value: {
+                    type: string;
+                    defaultValue: any;
+                };
+                /** The schema metadata for rendering dynamic hints (like labels/readOnly) */
+                schemaMetadata: {
+                    type: string;
+                    defaultValue: any;
+                };
+                /** Indicates if the control should be in a read-only state */
+                readOnly: {
+                    type: string;
+                    defaultValue: boolean;
+                };
+            };
+            aggregations: {
+                _content: {
+                    type: string;
+                    multiple: boolean;
+                    visibility: string;
+                };
+            };
+            events: {
+                /** Fired when the hardware successfully captures a value */
+                capture: {
+                    parameters: {
+                        value: {
+                            type: string;
+                        };
+                    };
+                };
+            };
+        };
+        /**
+         * Updates the bound value and fires the capture event.
+         */
+        protected setValueAndFire(val: unknown): void;
+        /**
+         * Common renderer for all hardware controls
+         */
+        static readonly renderer: {
+            apiVersion: number;
+            render: (rm: RenderManager, control: BaseHardwareControl) => void;
+        };
+        /**
+         * Abstract hook for subclasses to render their specific DOM/Controls.
+         */
+        protected renderContent(rm: RenderManager, control: BaseHardwareControl): void;
+    }
+}
+//# sourceMappingURL=BaseHardwareControl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControl.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,yDAAyD,CAAC;IACzE;;;;;OAKG;IAEH,OAAO,OAAO,MAAM,qBAAqB,CAAC;IAC1C,OAAO,aAAa,MAAM,2BAA2B,CAAC;IAItD;;OAEG;IACH,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,OAAO;QACpD,MAAM,CAAC,QAAQ,CAAC,QAAQ;;gBAEhB,sDAAsD;;;;;gBAEtD,6EAA6E;;;;;gBAE7E,8DAA8D;;;;;;;;;;;;;;gBAO9D,4DAA4D;;;;;;;;;UAOlE;QAEF;;WAEG;QACH,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;QAK7C;;WAEG;QACH,MAAM,CAAC,QAAQ,CAAC,QAAQ;;;UAA+B;QAEvD;;WAEG;QACH,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,aAAa,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;KAGjF;CAEA"}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.js

@@ -0,0 +1,2 @@
+sap.ui.define(["sap/ui/core/Control","./BaseHardwareControlRenderer"],function(e,t){"use strict";function a(e){return e&&e.__esModule&&typeof e.default!=="undefined"?e.default:e}const n=a(t);const r=e.extend("nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl",{renderer:n,metadata:{properties:{value:{type:"any",defaultValue:null},schemaMetadata:{type:"object",defaultValue:null},readOnly:{type:"boolean",defaultValue:false}},aggregations:{_content:{type:"sap.m.VBox",multiple:false,visibility:"hidden"}},events:{capture:{parameters:{value:{type:"any"}}}}},setValueAndFire:function e(t){this.setProperty("value",t,true);this.fireEvent("capture",{value:t})},renderContent:function e(t,a){}});return r});
+//# sourceMappingURL=BaseHardwareControl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControl.js","names":["BaseHardwareControlRenderer","_interopRequireDefault","__BaseHardwareControlRenderer","BaseHardwareControl","Control","extend","renderer","metadata","properties","value","type","defaultValue","schemaMetadata","readOnly","aggregations","_content","multiple","visibility","events","capture","parameters","setValueAndFire","_setValueAndFire","val","this","setProperty","fireEvent","renderContent","_renderContent","rm","control"],"sources":["BaseHardwareControl.ts"],"sourcesContent":["/**\n * @file BaseHardwareControl.ts\n * @description Foundational UI5 Custom Control for hardware plugins.\n * Exposes a standard 'value' property for pure two-way data binding.\n * \n */\n\nimport Control from \"sap/ui/core/Control\";\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport { IPropertyMetadata } from \"../../interfaces/ISchema\";\nimport BaseHardwareControlRenderer from \"./BaseHardwareControlRenderer\";\n\n/**\n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nexport default class BaseHardwareControl extends Control {\n    static readonly metadata = {\n        properties: {\n            /** The raw data value. Two-way bound to the model. */\n            value: { type: \"any\", defaultValue: null },\n            /** The schema metadata for rendering dynamic hints (like labels/readOnly) */\n            schemaMetadata: { type: \"object\", defaultValue: null },\n            /** Indicates if the control should be in a read-only state */\n            readOnly: { type: \"boolean\", defaultValue: false }\n        },\n        aggregations: {\n            _content: { type: \"sap.m.VBox\", multiple: false, visibility: \"hidden\" }\n        },\n        events: {\n            /** Fired when the hardware successfully captures a value */\n            capture: {\n                parameters: {\n                    value: { type: \"any\" }\n                }\n            }\n        }\n    };\n\n    /**\n     * Updates the bound value and fires the capture event.\n     */\n    protected setValueAndFire(val: unknown): void {\n        this.setProperty(\"value\", val, true); // true to suppress re-rendering if desired, but we want the binding to update\n        this.fireEvent(\"capture\", { value: val });\n    }\n\n    /**\n     * Common renderer for all hardware controls\n     */\n    static readonly renderer = BaseHardwareControlRenderer;\n\n    /**\n     * Abstract hook for subclasses to render their specific DOM/Controls.\n     */\n    protected renderContent(rm: RenderManager, control: BaseHardwareControl): void {\n        // To be overridden by hardware implementations\n    }\n}\n"],"mappings":"wLAUOA,EAA2BC,EAAAC,GAElC,MAGqBC,EAA4BC,EAAOC,OAAA,2DAkCpCC,SAAWN,EAjCXO,SAAW,CACvBC,WAAY,CAERC,MAAO,CAAEC,KAAM,MAAOC,aAAc,MAEpCC,eAAgB,CAAEF,KAAM,SAAUC,aAAc,MAEhDE,SAAU,CAAEH,KAAM,UAAWC,aAAc,QAE/CG,aAAc,CACVC,SAAU,CAAEL,KAAM,aAAcM,SAAU,MAAOC,WAAY,WAEjEC,OAAQ,CAEJC,QAAS,CACLC,WAAY,CACRX,MAAO,CAAEC,KAAM,WASrBW,gBAAe,SAAAC,EAACC,GACtBC,KAAKC,YAAY,QAASF,EAAK,MAC/BC,KAAKE,UAAU,UAAW,CAAEjB,MAAOc,GACvC,EAUUI,cAAa,SAAAC,EAACC,EAAmBC,GACvC,IACH,OAzCgB3B,CAAmB","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl.ts

@@ -0,0 +1,58 @@
+/**
+ * @file BaseHardwareControl.ts
+ * @description Foundational UI5 Custom Control for hardware plugins.
+ * Exposes a standard 'value' property for pure two-way data binding.
+ * 
+ */
+
+import Control from "sap/ui/core/Control";
+import RenderManager from "sap/ui/core/RenderManager";
+import { IPropertyMetadata } from "../../interfaces/ISchema";
+import BaseHardwareControlRenderer from "./BaseHardwareControlRenderer";
+
+/**
+ * @namespace nz.co.siliconst.ui5.metaui.controls
+ */
+export default class BaseHardwareControl extends Control {
+    static readonly metadata = {
+        properties: {
+            /** The raw data value. Two-way bound to the model. */
+            value: { type: "any", defaultValue: null },
+            /** The schema metadata for rendering dynamic hints (like labels/readOnly) */
+            schemaMetadata: { type: "object", defaultValue: null },
+            /** Indicates if the control should be in a read-only state */
+            readOnly: { type: "boolean", defaultValue: false }
+        },
+        aggregations: {
+            _content: { type: "sap.m.VBox", multiple: false, visibility: "hidden" }
+        },
+        events: {
+            /** Fired when the hardware successfully captures a value */
+            capture: {
+                parameters: {
+                    value: { type: "any" }
+                }
+            }
+        }
+    };
+
+    /**
+     * Updates the bound value and fires the capture event.
+     */
+    protected setValueAndFire(val: unknown): void {
+        this.setProperty("value", val, true); // true to suppress re-rendering if desired, but we want the binding to update
+        this.fireEvent("capture", { value: val });
+    }
+
+    /**
+     * Common renderer for all hardware controls
+     */
+    static readonly renderer = BaseHardwareControlRenderer;
+
+    /**
+     * Abstract hook for subclasses to render their specific DOM/Controls.
+     */
+    protected renderContent(rm: RenderManager, control: BaseHardwareControl): void {
+        // To be overridden by hardware implementations
+    }
+}

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

@@ -0,0 +1,28 @@
+sap.ui.define([], function () {
+  "use strict";
+
+  /**
+   * @file BaseHardwareControlRenderer.ts
+   * @description Standard renderer for all MetaUI hardware controls.
+   * 
+   * @namespace nz.co.siliconst.ui5.metaui.controls
+   */
+  var __exports = {
+    apiVersion: 2,
+    render: function (rm, control) {
+      rm.openStart("div", control);
+      rm.class("sapUiSmallMarginBottom");
+      rm.openEnd();
+      const content = control.getAggregation("_content");
+      if (content) {
+        rm.renderControl(content);
+      }
+      if (typeof control.renderContent === "function") {
+        control.renderContent(rm, control);
+      }
+      rm.close("div");
+    }
+  };
+  return __exports;
+});
+//# sourceMappingURL=BaseHardwareControlRenderer-dbg.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControlRenderer-dbg.js","names":["__exports","apiVersion","render","rm","control","openStart","class","openEnd","content","getAggregation","renderControl","renderContent","close"],"sources":["BaseHardwareControlRenderer.ts"],"sourcesContent":["/**\n * @file BaseHardwareControlRenderer.ts\n * @description Standard renderer for all MetaUI hardware controls.\n * \n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport BaseHardwareControl from \"./BaseHardwareControl\";\n\nexport default {\n    apiVersion: 2,\n    render: function (rm: RenderManager, control: BaseHardwareControl) {\n        rm.openStart(\"div\", control);\n        rm.class(\"sapUiSmallMarginBottom\");\n        rm.openEnd();\n        \n        const content = control.getAggregation(\"_content\") as sap.ui.core.Control;\n        if (content) {\n            rm.renderControl(content);\n        }\n        \n        if (typeof (control as unknown).renderContent === \"function\") {\n            (control as unknown).renderContent(rm, control);\n        }\n        \n        rm.close(\"div\");\n    }\n};\n"],"mappings":";;;EAAA;AACA;AACA;AACA;AACA;AACA;EALA,IAAAA,SAAA,GASe;IACXC,UAAU,EAAE,CAAC;IACbC,MAAM,EAAE,SAAAA,CAAUC,EAAiB,EAAEC,OAA4B,EAAE;MAC/DD,EAAE,CAACE,SAAS,CAAC,KAAK,EAAED,OAAO,CAAC;MAC5BD,EAAE,CAACG,KAAK,CAAC,wBAAwB,CAAC;MAClCH,EAAE,CAACI,OAAO,CAAC,CAAC;MAEZ,MAAMC,OAAO,GAAGJ,OAAO,CAACK,cAAc,CAAC,UAAU,CAAwB;MACzE,IAAID,OAAO,EAAE;QACTL,EAAE,CAACO,aAAa,CAACF,OAAO,CAAC;MAC7B;MAEA,IAAI,OAAQJ,OAAO,CAAaO,aAAa,KAAK,UAAU,EAAE;QACzDP,OAAO,CAAaO,aAAa,CAACR,EAAE,EAAEC,OAAO,CAAC;MACnD;MAEAD,EAAE,CAACS,KAAK,CAAC,KAAK,CAAC;IACnB;EACJ,CAAC;EAAA,OAAAZ,SAAA;AAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControlRenderer.d.ts

@@ -0,0 +1,16 @@
+declare module "nz/co/siliconst/ui5/metaui/controls/BaseHardwareControlRenderer" {
+    /**
+     * @file BaseHardwareControlRenderer.ts
+     * @description Standard renderer for all MetaUI hardware controls.
+     *
+     * @namespace nz.co.siliconst.ui5.metaui.controls
+     */
+    import RenderManager from "sap/ui/core/RenderManager";
+    import BaseHardwareControl from "nz/co/siliconst/ui5/metaui/controls/BaseHardwareControl";
+    const _default: {
+        apiVersion: number;
+        render: (rm: RenderManager, control: BaseHardwareControl) => void;
+    };
+    export default _default;
+}
+//# sourceMappingURL=BaseHardwareControlRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControlRenderer.d.ts","sourceRoot":"../../../../../../../..","sources":["src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControlRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,iEAAiE,CAAC;IACjF;;;;;OAKG;IACH,OAAO,aAAa,MAAM,2BAA2B,CAAC;IACtD,OAAO,mBAAmB,MAAM,yDAAyD,CAAC;;;qBAIhE,aAAa,WAAW,mBAAmB;;IAFrE,wBAkBE;CAED"}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControlRenderer.js

@@ -0,0 +1,2 @@
+sap.ui.define([],function(){"use strict";var n={apiVersion:2,render:function(n,e){n.openStart("div",e);n.class("sapUiSmallMarginBottom");n.openEnd();const t=e.getAggregation("_content");if(t){n.renderControl(t)}if(typeof e.renderContent==="function"){e.renderContent(n,e)}n.close("div")}};return n});
+//# sourceMappingURL=BaseHardwareControlRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseHardwareControlRenderer.js","names":["__exports","apiVersion","render","rm","control","openStart","class","openEnd","content","getAggregation","renderControl","renderContent","close"],"sources":["BaseHardwareControlRenderer.ts"],"sourcesContent":["/**\n * @file BaseHardwareControlRenderer.ts\n * @description Standard renderer for all MetaUI hardware controls.\n * \n * @namespace nz.co.siliconst.ui5.metaui.controls\n */\nimport RenderManager from \"sap/ui/core/RenderManager\";\nimport BaseHardwareControl from \"./BaseHardwareControl\";\n\nexport default {\n    apiVersion: 2,\n    render: function (rm: RenderManager, control: BaseHardwareControl) {\n        rm.openStart(\"div\", control);\n        rm.class(\"sapUiSmallMarginBottom\");\n        rm.openEnd();\n        \n        const content = control.getAggregation(\"_content\") as sap.ui.core.Control;\n        if (content) {\n            rm.renderControl(content);\n        }\n        \n        if (typeof (control as unknown).renderContent === \"function\") {\n            (control as unknown).renderContent(rm, control);\n        }\n        \n        rm.close(\"div\");\n    }\n};\n"],"mappings":"yCAAA,IAAAA,EASe,CACXC,WAAY,EACZC,OAAQ,SAAUC,EAAmBC,GACjCD,EAAGE,UAAU,MAAOD,GACpBD,EAAGG,MAAM,0BACTH,EAAGI,UAEH,MAAMC,EAAUJ,EAAQK,eAAe,YACvC,GAAID,EAAS,CACTL,EAAGO,cAAcF,EACrB,CAEA,UAAYJ,EAAoBO,gBAAkB,WAAY,CACzDP,EAAoBO,cAAcR,EAAIC,EAC3C,CAEAD,EAAGS,MAAM,MACb,GACH,OAAAZ,CAAA","ignoreList":[]}

package/src/nz/co/siliconst/ui5/metaui/controls/BaseHardwareControlRenderer.ts

@@ -0,0 +1,28 @@
+/**
+ * @file BaseHardwareControlRenderer.ts
+ * @description Standard renderer for all MetaUI hardware controls.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.controls
+ */
+import RenderManager from "sap/ui/core/RenderManager";
+import BaseHardwareControl from "./BaseHardwareControl";
+
+export default {
+    apiVersion: 2,
+    render: function (rm: RenderManager, control: BaseHardwareControl) {
+        rm.openStart("div", control);
+        rm.class("sapUiSmallMarginBottom");
+        rm.openEnd();
+        
+        const content = control.getAggregation("_content") as sap.ui.core.Control;
+        if (content) {
+            rm.renderControl(content);
+        }
+        
+        if (typeof (control as unknown).renderContent === "function") {
+            (control as unknown).renderContent(rm, control);
+        }
+        
+        rm.close("div");
+    }
+};