@siliconst/metaui 1.0.2 → 1.4.4

package/src/nz/co/siliconst/ui5/metaui/layouts/WizardLayout.ts

@@ -0,0 +1,127 @@
+/**
+ * @file WizardLayout.ts
+ * @description Generates a fully responsive SAP Fiori Wizard layout.
+ */
+
+import Wizard from "sap/m/Wizard";
+import WizardStep from "sap/m/WizardStep";
+import SimpleForm from "sap/ui/layout/form/SimpleForm";
+import Label from "sap/m/Label";
+import VBox from "sap/m/VBox";
+import { IPropertyMetadata, ISchema, ILayoutElement } from "../interfaces/ISchema";
+import { ILayoutManager } from "../interfaces/ILayoutManager";
+import { Engine } from "../core/Engine";
+import { Logger } from "../utils/Logger";
+import Control from "sap/ui/core/Control";
+
+/**
+ * Layout Manager responsible for generating a responsive SAP Fiori Wizard.
+ * It segments the schema fields into discrete Wizard Steps based on `uiLayout` elements 
+ * of type `Group` or `WizardStep`.
+ * 
+ * @namespace nz.co.siliconst.ui5.metaui.layouts
+ * @public
+ */
+export class WizardLayout implements ILayoutManager {
+    /**
+     * Renders the JSON Schema properties into a paginated UI5 Wizard using uiLayout.
+     * 
+     * @param schema The active JSON schema object.
+     * @param modelName The bound UI5 model name.
+     * @param engine The central orchestrator for delegating plugin generation.
+     * @param onSubmit Hook executed when the Wizard's native 'complete' event is fired.
+     * @returns {Control} The generated sap.m.Wizard control.
+     */
+    public render(schema: ISchema, modelName: string, engine: Engine, onSubmit?: () => void): Control {
+        const wizard = new Wizard({
+            renderMode: "Page",
+            showNextButton: true,
+            complete: function() {
+                if (onSubmit) onSubmit();
+            }
+        });
+
+        if (!schema.uiLayout || !Array.isArray(schema.uiLayout)) {
+            Logger.warn("[MetaUI] Missing 'uiLayout' array in wizard schema. Wizard will not render any steps.");
+            return wizard;
+        }
+
+        schema.uiLayout.forEach((element: ILayoutElement) => {
+            if (element.type === "Group" || element.type === "WizardStep") {
+                const step = new WizardStep({
+                    title: element.label || "Step",
+                    validated: true // The PipelineManager handles global validation, wizard step validation can be local later
+                });
+
+                const form = new SimpleForm({
+                    editable: true,
+                    layout: "ResponsiveGridLayout",
+                    labelSpanXL: 4, labelSpanL: 4, labelSpanM: 4, labelSpanS: 12,
+                    adjustLabelSpan: false,
+                    emptySpanXL: 0, emptySpanL: 0, emptySpanM: 0, emptySpanS: 0,
+                    columnsXL: 1, columnsL: 1, columnsM: 1,
+                    singleContainerFullSize: false
+                });
+                
+                if (element.elements && Array.isArray(element.elements)) {
+                    element.elements.forEach(childElement => {
+                        this._renderElementInForm(form, childElement, schema, modelName, engine);
+                    });
+                }
+
+                step.addContent(form);
+                wizard.addStep(step);
+            } else {
+                Logger.warn(`[MetaUI] Top-level element '${element.type}' inside WizardLayout must be 'Group' or 'WizardStep'.`, "", "WizardLayout");
+            }
+        });
+
+        return wizard;
+    }
+
+    private _renderElementInForm(form: SimpleForm, element: ILayoutElement, schema: ISchema, modelName: string, engine: Engine): void {
+        if (element.type === "Control") {
+            if (!element.scope || !element.scope.startsWith("#/properties/")) {
+                Logger.error(`[MetaUI] Invalid scope '${element.scope}' in uiLayout Control.`, "", "WizardLayout");
+                return;
+            }
+            
+            const propKey = element.scope.replace("#/properties/", "");
+            const meta = schema.properties?.[propKey];
+            
+            if (!meta) {
+                Logger.error(`[MetaUI] Property '${propKey}' not found in schema definitions.`, "", "WizardLayout");
+                return;
+            }
+
+            try {
+                const labelText = element.label || meta.ui?.label || propKey;
+                const label = new Label({
+                    text: labelText,
+                    required: meta.required
+                });
+
+                const effectiveMeta = { ...meta };
+                if (element.widget) {
+                    effectiveMeta.ui = { ...meta.ui, widget: element.widget };
+                }
+
+                const control = engine.generateField(effectiveMeta, `/${propKey}`, modelName);
+
+                if (effectiveMeta.ui?.fullWidth) {
+                    sap.ui.require(["sap/ui/layout/GridData"], (GridData: any) => {
+                        control.setLayoutData(new GridData({ span: "XL12 L12 M12 S12" }));
+                    });
+                }
+
+                form.addContent(label);
+                form.addContent(control);
+            } catch (error) {
+                Logger.error(`[MetaUI] Failed to render Wizard field ${propKey}`, (error as Error).message, "WizardLayout");
+                form.addContent(new Label({ text: propKey }));
+            }
+        } else {
+            Logger.warn(`[MetaUI] Nested groups within Wizard steps are not fully supported in SimpleForm yet.`, "", "WizardLayout");
+        }
+    }
+}

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

@@ -1,33 +1,49 @@
-sap.ui.define(["sap/ui/core/Core", "./core/PluginRegistry", "./plugins/StringPlugin", "./plugins/NumberPlugin", "./plugins/BooleanPlugin", "./plugins/DropdownPlugin", "./plugins/DatePlugin"], function (Core, ___core_PluginRegistry, ___plugins_StringPlugin, ___plugins_NumberPlugin, ___plugins_BooleanPlugin, ___plugins_DropdownPlugin, ___plugins_DatePlugin) {
-  "use strict";
-
-  const PluginRegistry = ___core_PluginRegistry["PluginRegistry"];
-  const StringPlugin = ___plugins_StringPlugin["StringPlugin"];
-  const NumberPlugin = ___plugins_NumberPlugin["NumberPlugin"];
-  const BooleanPlugin = ___plugins_BooleanPlugin["BooleanPlugin"];
-  const DropdownPlugin = ___plugins_DropdownPlugin["DropdownPlugin"];
-  const DatePlugin = ___plugins_DatePlugin["DatePlugin"]; // Delegate to standard library registration
-  Core.initLibrary({
-    name: "nz.co.siliconst.ui5.metaui",
-    version: "1.0.0",
-    dependencies: ["sap.ui.core", "sap.m", "sap.ui.layout", "sap.ui.table"],
-    controls: ["nz.co.siliconst.ui5.metaui.controls.GeneratorHost"],
-    elements: [],
-    interfaces: []
-  });
-
-  /**
-   * Global Bootstrapper: Maps all standard primitive types to their respective plugins.
-   */
-  const registry = PluginRegistry.getInstance();
-  registry.register("string", StringPlugin);
-  registry.register("number", NumberPlugin);
-  registry.register("boolean", BooleanPlugin);
-  registry.register("dropdown", DropdownPlugin);
-  registry.register("date", DatePlugin);
-
-  // Exporting window object safely for UI5 compatibility if needed
-  var __exports = window["nz"]["co"]["siliconst"]["ui5"]["metaui"];
-  return __exports;
-});
+sap.ui.define(["sap/ui/core/Core", "./core/PluginRegistry", "./core/LayoutRegistry", "./plugins/controls/StringPlugin", "./plugins/controls/NumberPlugin", "./plugins/controls/BooleanPlugin", "./plugins/controls/DropdownPlugin", "./plugins/controls/DatePlugin", "./plugins/controls/TimePlugin", "./plugins/controls/DateTimePlugin", "./plugins/controls/ArrayPlugin", "./plugins/controls/TextAreaPlugin", "./plugins/controls/SwitchPlugin", "./plugins/datasources/LiveSearchPlugin"], function (Core, ___core_PluginRegistry, ___core_LayoutRegistry, ___plugins_controls_StringPlugin, ___plugins_controls_NumberPlugin, ___plugins_controls_BooleanPlugin, ___plugins_controls_DropdownPlugin, ___plugins_controls_DatePlugin, ___plugins_controls_TimePlugin, ___plugins_controls_DateTimePlugin, ___plugins_controls_ArrayPlugin, ___plugins_controls_TextAreaPlugin, ___plugins_controls_SwitchPlugin, ___plugins_datasources_LiveSearchPlugin) {
+  "use strict";
+
+  const PluginRegistry = ___core_PluginRegistry["PluginRegistry"];
+  const StringPlugin = ___plugins_controls_StringPlugin["StringPlugin"];
+  const NumberPlugin = ___plugins_controls_NumberPlugin["NumberPlugin"];
+  const BooleanPlugin = ___plugins_controls_BooleanPlugin["BooleanPlugin"];
+  const DropdownPlugin = ___plugins_controls_DropdownPlugin["DropdownPlugin"];
+  const DatePlugin = ___plugins_controls_DatePlugin["DatePlugin"];
+  const TimePlugin = ___plugins_controls_TimePlugin["TimePlugin"];
+  const DateTimePlugin = ___plugins_controls_DateTimePlugin["DateTimePlugin"];
+  const ArrayPlugin = ___plugins_controls_ArrayPlugin["ArrayPlugin"];
+  const TextAreaPlugin = ___plugins_controls_TextAreaPlugin["TextAreaPlugin"];
+  const SwitchPlugin = ___plugins_controls_SwitchPlugin["SwitchPlugin"];
+  const LiveSearchPlugin = ___plugins_datasources_LiveSearchPlugin["LiveSearchPlugin"]; // Delegate to standard library registration
+  Core.initLibrary({
+    name: "nz.co.siliconst.ui5.metaui",
+    version: "1.0.0",
+    dependencies: ["sap.ui.core", "sap.m", "sap.ui.layout", "sap.ui.table"],
+    controls: ["nz.co.siliconst.ui5.metaui.controls.GeneratorHost", "nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl", "nz.co.siliconst.ui5.metaui.controls.CameraControl", "nz.co.siliconst.ui5.metaui.controls.BarcodeScannerControl", "nz.co.siliconst.ui5.metaui.controls.SignatureControl", "nz.co.siliconst.ui5.metaui.controls.VoiceInputControl", "nz.co.siliconst.ui5.metaui.controls.GeolocationControl", "nz.co.siliconst.ui5.metaui.controls.RichTextControl"],
+    elements: [],
+    interfaces: [],
+    noLibraryCSS: true
+  });
+
+  /**
+   * Global Bootstrapper: Maps all standard primitive types to their respective plugins.
+   */
+  const registry = PluginRegistry.getInstance();
+  registry.register("string", StringPlugin);
+  registry.register("string", TextAreaPlugin, "textArea");
+  registry.register("number", NumberPlugin);
+  registry.register("boolean", BooleanPlugin);
+  registry.register("boolean", SwitchPlugin, "switch");
+  // @ts-ignore: Custom UI widgets mapped back to string primitives for UI orchestration
+  registry.register("dropdown", DropdownPlugin);
+  registry.register("date", DatePlugin);
+  // @ts-ignore
+  registry.register("time", TimePlugin);
+  // @ts-ignore
+  registry.register("datetime", DateTimePlugin);
+  registry.register("array", ArrayPlugin);
+  registry.register("string", LiveSearchPlugin, "liveSearch");
+
+  // Exporting window object safely for UI5 compatibility if needed
+  var __exports = window["nz"]["co"]["siliconst"]["ui5"]["metaui"];
+  return __exports;
+});
 //# sourceMappingURL=library-dbg.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"library-dbg.js","names":["PluginRegistry","___core_PluginRegistry","StringPlugin","___plugins_StringPlugin","NumberPlugin","___plugins_NumberPlugin","BooleanPlugin","___plugins_BooleanPlugin","DropdownPlugin","___plugins_DropdownPlugin","DatePlugin","___plugins_DatePlugin","Core","initLibrary","name","version","dependencies","controls","elements","interfaces","registry","getInstance","register","__exports","window"],"sources":["library.ts"],"sourcesContent":["/**\r\n * @file library.ts\r\n * @description Standard SAP UI5 library registration file. Exposes the MetaUI namespace \r\n * and automatically bootstraps the internal PluginRegistry.\r\n */\r\n\r\nimport Core from \"sap/ui/core/Core\";\r\nimport { PluginRegistry } from \"./core/PluginRegistry\";\r\nimport { StringPlugin } from \"./plugins/StringPlugin\";\r\nimport { NumberPlugin } from \"./plugins/NumberPlugin\";\r\nimport { BooleanPlugin } from \"./plugins/BooleanPlugin\";\r\nimport { DropdownPlugin } from \"./plugins/DropdownPlugin\";\r\nimport { DatePlugin } from \"./plugins/DatePlugin\";\r\n\r\n// Delegate to standard library registration\r\nCore.initLibrary({\r\n    name: \"nz.co.siliconst.ui5.metaui\",\r\n    version: \"1.0.0\",\r\n    dependencies: [\r\n        \"sap.ui.core\",\r\n        \"sap.m\",\r\n        \"sap.ui.layout\",\r\n        \"sap.ui.table\"\r\n    ],\r\n    controls: [\r\n        \"nz.co.siliconst.ui5.metaui.controls.GeneratorHost\"\r\n    ],\r\n    elements: [],\r\n    interfaces: []\r\n});\r\n\r\n/**\r\n * Global Bootstrapper: Maps all standard primitive types to their respective plugins.\r\n */\r\nconst registry = PluginRegistry.getInstance();\r\nregistry.register(\"string\", StringPlugin);\r\nregistry.register(\"number\", NumberPlugin);\r\nregistry.register(\"boolean\", BooleanPlugin);\r\nregistry.register(\"dropdown\", DropdownPlugin);\r\nregistry.register(\"date\", DatePlugin);\r\n\r\n// Exporting window object safely for UI5 compatibility if needed\r\nexport default (window as any)[\"nz\"][\"co\"][\"siliconst\"][\"ui5\"][\"metaui\"];\r\n"],"mappings":";;;QAOSA,cAAc,GAAAC,sBAAA;EAAA,MACdC,YAAY,GAAAC,uBAAA;EAAA,MACZC,YAAY,GAAAC,uBAAA;EAAA,MACZC,aAAa,GAAAC,wBAAA;EAAA,MACbC,cAAc,GAAAC,yBAAA;EAAA,MACdC,UAAU,GAAAC,qBAAA,gBAEnB;EACAC,IAAI,CAACC,WAAW,CAAC;IACbC,IAAI,EAAE,4BAA4B;IAClCC,OAAO,EAAE,OAAO;IAChBC,YAAY,EAAE,CACV,aAAa,EACb,OAAO,EACP,eAAe,EACf,cAAc,CACjB;IACDC,QAAQ,EAAE,CACN,mDAAmD,CACtD;IACDC,QAAQ,EAAE,EAAE;IACZC,UAAU,EAAE;EAChB,CAAC,CAAC;;EAEF;AACA;AACA;EACA,MAAMC,QAAQ,GAAGpB,cAAc,CAACqB,WAAW,CAAC,CAAC;EAC7CD,QAAQ,CAACE,QAAQ,CAAC,QAAQ,EAAEpB,YAAY,CAAC;EACzCkB,QAAQ,CAACE,QAAQ,CAAC,QAAQ,EAAElB,YAAY,CAAC;EACzCgB,QAAQ,CAACE,QAAQ,CAAC,SAAS,EAAEhB,aAAa,CAAC;EAC3Cc,QAAQ,CAACE,QAAQ,CAAC,UAAU,EAAEd,cAAc,CAAC;EAC7CY,QAAQ,CAACE,QAAQ,CAAC,MAAM,EAAEZ,UAAU,CAAC;;EAErC;EAAA,IAAAa,SAAA,GACgBC,MAAM,CAAS,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;EAAA,OAAAD,SAAA;AAAA","ignoreList":[]}
+{"version":3,"file":"library-dbg.js","names":["PluginRegistry","___core_PluginRegistry","StringPlugin","___plugins_controls_StringPlugin","NumberPlugin","___plugins_controls_NumberPlugin","BooleanPlugin","___plugins_controls_BooleanPlugin","DropdownPlugin","___plugins_controls_DropdownPlugin","DatePlugin","___plugins_controls_DatePlugin","TimePlugin","___plugins_controls_TimePlugin","DateTimePlugin","___plugins_controls_DateTimePlugin","ArrayPlugin","___plugins_controls_ArrayPlugin","TextAreaPlugin","___plugins_controls_TextAreaPlugin","SwitchPlugin","___plugins_controls_SwitchPlugin","LiveSearchPlugin","___plugins_datasources_LiveSearchPlugin","Core","initLibrary","name","version","dependencies","controls","elements","interfaces","noLibraryCSS","registry","getInstance","register","__exports","window"],"sources":["library.ts"],"sourcesContent":["/**\n * @file library.ts\n * @description Standard SAP UI5 library registration file. Exposes the MetaUI namespace \n * and automatically bootstraps the internal PluginRegistry.\n */\n\nimport Core from \"sap/ui/core/Core\";\nimport { PluginRegistry } from \"./core/PluginRegistry\";\nimport \"./core/LayoutRegistry\";\nimport { StringPlugin } from \"./plugins/controls/StringPlugin\";\nimport { NumberPlugin } from \"./plugins/controls/NumberPlugin\";\nimport { BooleanPlugin } from \"./plugins/controls/BooleanPlugin\";\nimport { DropdownPlugin } from \"./plugins/controls/DropdownPlugin\";\nimport { DatePlugin } from \"./plugins/controls/DatePlugin\";\nimport { TimePlugin } from \"./plugins/controls/TimePlugin\";\nimport { DateTimePlugin } from \"./plugins/controls/DateTimePlugin\";\nimport { ArrayPlugin } from \"./plugins/controls/ArrayPlugin\";\n\nimport { TextAreaPlugin } from \"./plugins/controls/TextAreaPlugin\";\nimport { SwitchPlugin } from \"./plugins/controls/SwitchPlugin\";\nimport { LiveSearchPlugin } from \"./plugins/datasources/LiveSearchPlugin\";\n\n// Delegate to standard library registration\nCore.initLibrary({\n    name: \"nz.co.siliconst.ui5.metaui\",\n    version: \"1.0.0\",\n    dependencies: [\n        \"sap.ui.core\",\n        \"sap.m\",\n        \"sap.ui.layout\",\n        \"sap.ui.table\"\n    ],\n    controls: [\n        \"nz.co.siliconst.ui5.metaui.controls.GeneratorHost\",\n        \"nz.co.siliconst.ui5.metaui.controls.BaseHardwareControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.CameraControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.BarcodeScannerControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.SignatureControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.VoiceInputControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.GeolocationControl\",\n        \"nz.co.siliconst.ui5.metaui.controls.RichTextControl\"\n    ],\n    elements: [],\n    interfaces: [],\n    noLibraryCSS: true\n});\n\n/**\n * Global Bootstrapper: Maps all standard primitive types to their respective plugins.\n */\nconst registry = PluginRegistry.getInstance();\nregistry.register(\"string\", StringPlugin);\nregistry.register(\"string\", TextAreaPlugin, \"textArea\");\nregistry.register(\"number\", NumberPlugin);\nregistry.register(\"boolean\", BooleanPlugin);\nregistry.register(\"boolean\", SwitchPlugin, \"switch\");\n// @ts-ignore: Custom UI widgets mapped back to string primitives for UI orchestration\nregistry.register(\"dropdown\", DropdownPlugin);\nregistry.register(\"date\", DatePlugin);\n// @ts-ignore\nregistry.register(\"time\", TimePlugin);\n// @ts-ignore\nregistry.register(\"datetime\", DateTimePlugin);\nregistry.register(\"array\", ArrayPlugin);\nregistry.register(\"string\", LiveSearchPlugin, \"liveSearch\");\n\n// Exporting window object safely for UI5 compatibility if needed\nexport default (window as unknown)[\"nz\"][\"co\"][\"siliconst\"][\"ui5\"][\"metaui\"];\n"],"mappings":";;;QAOSA,cAAc,GAAAC,sBAAA;EAAA,MAEdC,YAAY,GAAAC,gCAAA;EAAA,MACZC,YAAY,GAAAC,gCAAA;EAAA,MACZC,aAAa,GAAAC,iCAAA;EAAA,MACbC,cAAc,GAAAC,kCAAA;EAAA,MACdC,UAAU,GAAAC,8BAAA;EAAA,MACVC,UAAU,GAAAC,8BAAA;EAAA,MACVC,cAAc,GAAAC,kCAAA;EAAA,MACdC,WAAW,GAAAC,+BAAA;EAAA,MAEXC,cAAc,GAAAC,kCAAA;EAAA,MACdC,YAAY,GAAAC,gCAAA;EAAA,MACZC,gBAAgB,GAAAC,uCAAA,sBAEzB;EACAC,IAAI,CAACC,WAAW,CAAC;IACbC,IAAI,EAAE,4BAA4B;IAClCC,OAAO,EAAE,OAAO;IAChBC,YAAY,EAAE,CACV,aAAa,EACb,OAAO,EACP,eAAe,EACf,cAAc,CACjB;IACDC,QAAQ,EAAE,CACN,mDAAmD,EACnD,yDAAyD,EACzD,mDAAmD,EACnD,2DAA2D,EAC3D,sDAAsD,EACtD,uDAAuD,EACvD,wDAAwD,EACxD,qDAAqD,CACxD;IACDC,QAAQ,EAAE,EAAE;IACZC,UAAU,EAAE,EAAE;IACdC,YAAY,EAAE;EAClB,CAAC,CAAC;;EAEF;AACA;AACA;EACA,MAAMC,QAAQ,GAAGjC,cAAc,CAACkC,WAAW,CAAC,CAAC;EAC7CD,QAAQ,CAACE,QAAQ,CAAC,QAAQ,EAAEjC,YAAY,CAAC;EACzC+B,QAAQ,CAACE,QAAQ,CAAC,QAAQ,EAAEjB,cAAc,EAAE,UAAU,CAAC;EACvDe,QAAQ,CAACE,QAAQ,CAAC,QAAQ,EAAE/B,YAAY,CAAC;EACzC6B,QAAQ,CAACE,QAAQ,CAAC,SAAS,EAAE7B,aAAa,CAAC;EAC3C2B,QAAQ,CAACE,QAAQ,CAAC,SAAS,EAAEf,YAAY,EAAE,QAAQ,CAAC;EACpD;EACAa,QAAQ,CAACE,QAAQ,CAAC,UAAU,EAAE3B,cAAc,CAAC;EAC7CyB,QAAQ,CAACE,QAAQ,CAAC,MAAM,EAAEzB,UAAU,CAAC;EACrC;EACAuB,QAAQ,CAACE,QAAQ,CAAC,MAAM,EAAEvB,UAAU,CAAC;EACrC;EACAqB,QAAQ,CAACE,QAAQ,CAAC,UAAU,EAAErB,cAAc,CAAC;EAC7CmB,QAAQ,CAACE,QAAQ,CAAC,OAAO,EAAEnB,WAAW,CAAC;EACvCiB,QAAQ,CAACE,QAAQ,CAAC,QAAQ,EAAEb,gBAAgB,EAAE,YAAY,CAAC;;EAE3D;EAAA,IAAAc,SAAA,GACgBC,MAAM,CAAa,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC;EAAA,OAAAD,SAAA;AAAA","ignoreList":[]}