@emeraldemperaur/vector-sigma 1.4.29 → 1.4.31

package/lib/index.cjs

@@ -13052,13 +13052,13 @@ const CheckboxGroupInput = (_a) => {
         ` } })),
             React.createElement(o$6, { columns: columns || (direction === 'row' ? 'repeat(auto-fit, minmax(100px, 1fr))' : '1'), gap: "3", style: neuVars }, inputOptions.map((inputoption) => {
                 const isChecked = currentValues.some(val => String(val) === String(inputoption.optionvalue));
-                return (React.createElement(p$d, { as: "label", key: inputoption.optionvalue || crypto.randomUUID(), size: "2", style: {
+                return (React.createElement(p$d, { as: "label", key: String(inputoption.optionvalue) || crypto.randomUUID(), size: "2", style: {
                         display: 'flex',
                         alignItems: 'center',
                         gap: '8px',
                         cursor: 'pointer'
                     } },
-                    React.createElement(c$2, { name: alias, id: `${alias}FormInput${inputoption.optionid}`, "aria-describedby": `${alias}InputLabel${inputoption.optionid}`, disabled: readOnly, value: inputoption.optionvalue, checked: isChecked, onCheckedChange: (checked) => handleCheckedChange(checked, inputoption.optionvalue), variant: inputtype === 'checkbox-outline' ? 'soft' : 'surface', className: inputtype === 'checkbox-neumorphic' ? 'neu-checkbox' : '', style: Object.assign({}, (inputtype === 'checkbox-outline' ? {
+                    React.createElement(c$2, { name: alias, id: `${alias}FormInput${inputoption.optionid}`, "aria-describedby": `${alias}InputLabel${inputoption.optionid}`, disabled: readOnly, value: String(inputoption.optionvalue), checked: isChecked, onCheckedChange: (checked) => handleCheckedChange(checked, String(inputoption.optionvalue)), variant: inputtype === 'checkbox-outline' ? 'soft' : 'surface', className: inputtype === 'checkbox-neumorphic' ? 'neu-checkbox' : '', style: Object.assign({}, (inputtype === 'checkbox-outline' ? {
                             border: isChecked ? '2px solid var(--accent-9)' : '2px solid var(--gray-8)',
                             backgroundColor: 'transparent'
                         } : {})) }),
@@ -13135,7 +13135,7 @@ const ConditionalTrigger = (_a) => {
                 return (React.createElement(p$5, { direction: "column", gap: "1", style: { width: '100%' } },
                     React.createElement(C$1, { name: alias, disabled: readOnly, value: fieldValue, defaultValue: placeholder || "", onValueChange: handleChange },
                         React.createElement(u$1, { id: inputId, variant: isNeumorphic ? 'soft' : 'surface', style: { width: '100%' } }),
-                        React.createElement(g, null, inputOptions.map((inputoption) => (React.createElement(v, { key: inputoption.optionvalue || crypto.randomUUID(), value: inputoption.optionvalue }, inputoption.text)))))));
+                        React.createElement(g, null, inputOptions.map((inputoption) => (React.createElement(v, { key: String(inputoption.optionvalue) || crypto.randomUUID(), value: String(inputoption.optionvalue) }, inputoption.text)))))));
             case inputtype.includes('conditionaltoggle'):
             default:
                 return (React.createElement(p$5, { justify: "between", align: "center", style: { width: '100%' } },
@@ -27267,10 +27267,10 @@ const Dropdown = (_a) => {
                         React.createElement(v, { value: "__RESET__", className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '', style: { color: 'var(--gray-10)', fontStyle: 'italic' } }, placeholder || "Select an option"),
                         React.createElement(o$2, { size: "4", style: { margin: '4px 0', opacity: 0.5 } }),
                         inputOptions.map((inputoption) => (React.createElement(React.Fragment, { key: inputoption.optionid || crypto.randomUUID() }, inputoption.optionurl ?
-                            React.createElement(v, { id: String(inputoption.optionid) || '', value: inputoption.optionvalue, className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' },
+                            React.createElement(v, { id: String(inputoption.optionid) || '', value: String(inputoption.optionvalue), className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' },
                                 React.createElement("a", { onClick: (e) => { e.stopPropagation(); openLink(inputoption.optionurl || "#"); }, style: { textDecoration: 'none', color: 'inherit' } }, inputoption.text))
                             :
-                                React.createElement(v, { id: String(inputoption.optionid) || '', value: inputoption.optionvalue, className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' }, inputoption.text)))))),
+                                React.createElement(v, { id: String(inputoption.optionid) || '', value: String(inputoption.optionvalue), className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' }, inputoption.text)))))),
                 React.createElement("div", null,
                     React.createElement(p$d, { id: `${alias}InputLabel`, as: "label", size: "2", weight: "bold", htmlFor: inputId }, inputLabel),
                     "\u00A0",
@@ -48234,9 +48234,9 @@ const RadioGroupInput = (_a) => {
                 } },
                 React.createElement(o$6, { columns: columns || (direction === 'row' ? 'repeat(auto-fit, minmax(100px, 1fr))' : '1'), gap: "3", style: neuVars }, inputOptions.map((inputoption) => {
                     const isChecked = String(fieldValue) === String(inputoption.optionvalue);
-                    return (React.createElement(p$5, { asChild: true, key: inputoption.optionvalue, align: "center", gap: "2" },
+                    return (React.createElement(p$5, { asChild: true, key: String(inputoption.optionvalue), align: "center", gap: "2" },
                         React.createElement(p$d, { as: "label", size: "2", style: { cursor: 'pointer' } },
-                            React.createElement(y$1, { value: inputoption.optionvalue, className: inputtype === 'radio-neumorphic' ? 'neu-radio' : '', style: Object.assign({}, (inputtype === 'radio-outline' ? {
+                            React.createElement(y$1, { value: String(inputoption.optionvalue), className: inputtype === 'radio-neumorphic' ? 'neu-radio' : '', style: Object.assign({}, (inputtype === 'radio-outline' ? {
                                     border: isChecked ? '2px solid var(--accent-9)' : '2px solid var(--gray-8)',
                                     backgroundColor: 'transparent'
                                 } : {})) }),
@@ -48362,8 +48362,8 @@ const OptionSelect = (_a) => {
                 React.createElement(g, { position: "popper", sideOffset: 5, style: activeContentStyle },
                     React.createElement(v, { value: "__RESET__", className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '', style: { color: 'var(--gray-10)', fontStyle: 'italic' } }, placeholder || "Select an option"),
                     React.createElement(o$2, { size: "4", style: { margin: '4px 0', opacity: 0.5 } }),
-                    inputOptions.map((inputoption) => (React.createElement(React.Fragment, { key: inputoption.optionid || crypto.randomUUID() }, inputoption.optionurl ? (React.createElement(v, { id: String(inputoption.optionid) || '', value: inputoption.optionvalue, className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' },
-                        React.createElement("a", { onClick: (e) => { e.stopPropagation(); openLink(inputoption.optionurl || "#"); }, style: { textDecoration: 'none', color: 'inherit' } }, inputoption.text))) : (React.createElement(v, { id: String(inputoption.optionid) || '', value: inputoption.optionvalue, className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' }, inputoption.text))))))),
+                    inputOptions.map((inputoption) => (React.createElement(React.Fragment, { key: inputoption.optionid || crypto.randomUUID() }, inputoption.optionurl ? (React.createElement(v, { id: String(inputoption.optionid) || '', value: String(inputoption.optionvalue), className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' },
+                        React.createElement("a", { onClick: (e) => { e.stopPropagation(); openLink(inputoption.optionurl || "#"); }, style: { textDecoration: 'none', color: 'inherit' } }, inputoption.text))) : (React.createElement(v, { id: String(inputoption.optionid) || '', value: String(inputoption.optionvalue), className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' }, inputoption.text))))))),
             React.createElement("div", null,
                 React.createElement(p$d, { id: `${alias}InputLabel`, as: "label", size: "2", weight: "bold", htmlFor: `${alias}FormInput` }, inputLabel),
                 "\u00A0",
@@ -48404,7 +48404,7 @@ const MultipleSelect = (_a) => {
     };
     const displayLabel = selectedValues.length > 0
         ? inputOptions
-            .filter(inputoption => selectedValues.includes(inputoption.optionvalue))
+            .filter(inputoption => selectedValues.includes(String(inputoption.optionvalue)))
             .map(inputoption => inputoption.text)
             .join(', ')
         : placeholder;
@@ -48467,7 +48467,7 @@ const MultipleSelect = (_a) => {
                                     === String(inputoption.optionvalue));
                                 return (React.createElement(p$5, { id: String(inputoption.optionid) || '', key: inputoption.optionid, align: "center", gap: "2", onClick: () => {
                                         if (!readOnly)
-                                            handleToggle(inputoption.optionvalue);
+                                            handleToggle(String(inputoption.optionvalue));
                                     }, style: {
                                         padding: '8px',
                                         cursor: readOnly ? 'default' : 'pointer',
@@ -49146,7 +49146,7 @@ const CodexItem = ({ stepId, children, }) => {
     return (React.createElement("div", { className: "v-step-content-animation", style: { width: '100%' } }, children));
 };
 
-const CodexControls = ({ nextStepId, prevStepId, nextLabel = "Continue", prevLabel = "Back", finishLabel = "Submit", prevIcon = "doublearrowleft", nextIcon = "doublearrowright", finishIcon = "paperplane", onNext, onPrev, onFinish }) => {
+const CodexControls = ({ nextStepId, prevStepId, nextLabel = "Continue", prevLabel = "Back", finishLabel = "Submit", prevIcon = "doublearrowleft", nextIcon = "doublearrowright", finishIcon = "paperplane", onSubmit = false, onNext, onPrev, onFinish }) => {
     const { setActiveStepId, brandColor } = useStepper();
     const handlePrev = () => {
         if (onPrev)
@@ -49171,7 +49171,7 @@ const CodexControls = ({ nextStepId, prevStepId, nextLabel = "Continue", prevLab
                 React.createElement(Icon, { name: prevIcon }),
                 "\u00A0")),
             prevLabel)) : (React.createElement("div", null)),
-        React.createElement(o$a, { variant: "solid", color: brandColor ? undefined : (nextStepId ? "blue" : "green"), onClick: handleNext, style: Object.assign({ cursor: 'pointer' }, (brandColor ? { backgroundColor: 'var(--codex-brand)', color: '#fff' } : {})) }, nextStepId ? (React.createElement(React.Fragment, null,
+        React.createElement(o$a, { variant: "solid", color: brandColor ? undefined : (nextStepId ? "blue" : "green"), onClick: handleNext, style: Object.assign({ cursor: 'pointer' }, (brandColor ? { backgroundColor: 'var(--codex-brand)', color: '#fff' } : {})), type: onSubmit && !nextStepId ? "submit" : "button" }, nextStepId ? (React.createElement(React.Fragment, null,
             nextIcon && React.createElement(React.Fragment, null,
                 React.createElement(Icon, { name: nextIcon }),
                 "\u00A0"),
@@ -53907,6 +53907,131 @@ const parseUuidFormat = (input) => {
     return numbers;
 };
 
+/**
+ * Utility to convert any string to camelCase (e.g., "USER NAME" -> "userName", "user_profile" -> "userProfile")
+ * Safely handles ALL CAPS, snake_case, spaces, and existing camelCase.
+ * @param str - String to convert to camelCase format
+ */
+const toCamelCase = (str) => {
+    if (!str)
+        return "";
+    const words = str
+        .replace(/([a-z])([A-Z])/g, '$1 $2') // 1. Split existing camelCase with a space
+        .replace(/[^a-zA-Z0-9]+/g, ' ') // 2. Replace non-alphanumeric characters with spaces
+        .trim()
+        .toLowerCase() // 3. Lowercase everything
+        .split(/\s+/); // 4. Split into an array of words
+    if (words.length === 0 || words[0] === '')
+        return "";
+    return words.map((word, index) => {
+        if (index === 0)
+            return word; // First word stays lowercase
+        return word.charAt(0).toUpperCase() + word.slice(1); // Capitalize subsequent words
+    }).join('');
+};
+/**
+ * Utility to convert a string to kebab-case (e.g., "Profile Section" -> "profile-section")
+ * Ensures code-friendly standard strings.
+ * @param str - String to convert to kebab-case format
+ */
+const toKebabCase = (str) => {
+    if (!str)
+        return "";
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2') // 1. Handle camelCase inputs
+        .replace(/[^a-zA-Z0-9]+/g, '-') // 2. Replace non-alphanumeric chars with hyphens
+        .toLowerCase() // 3. Lowercase everything
+        .replace(/^-+|-+$/g, ''); // 4. Trim any leading or trailing hyphens
+};
+/**
+ * Normalizes and sanitizes an XFormType object.
+ * - Standardizes Section IDs (Consecutive numbers or code-friendly strings).
+ * - Enforces globally consecutive Query IDs.
+ * - Ensures unique, Formik-friendly camelCase Input Aliases.
+ * - Auto-fills empty inputAliases with unique 'undefinedElement[N]' placeholder.
+ * @param xform - xForm object {} to normalize `sectionId`, `queryId` and `inputAlias` attributes for `<Teletraan1/>` component
+ */
+const normalizeXForm = (xform) => {
+    var _a, _b;
+    // Deep clone the object to prevent mutating the original data reference
+    const normalizedForm = JSON.parse(JSON.stringify(xform));
+    if (!normalizedForm.model || normalizedForm.model.length === 0) {
+        return normalizedForm;
+    }
+    // ==========================================
+    // 1. SECTION ID NORMALIZATION
+    // ==========================================
+    const firstSectionId = normalizedForm.model[0].sectionId;
+    const isFirstSectionNumbered = !isNaN(Number(firstSectionId)) && String(firstSectionId).trim() !== '';
+    let sectionCounter = isFirstSectionNumbered ? Number(firstSectionId) : 1;
+    normalizedForm.model.forEach((section) => {
+        if (isFirstSectionNumbered) {
+            // If the first section was a number, make all subsequent sections consecutive numbers
+            section.sectionId = String(sectionCounter++);
+        }
+        else {
+            // Otherwise, sanitize to a code-friendly string
+            section.sectionId = toKebabCase(section.sectionId) || `section-${sectionCounter++}`;
+        }
+    });
+    // ==========================================
+    // 2. QUERY ID & ALIAS NORMALIZATION
+    // ==========================================
+    const aliasTracker = {};
+    let undefinedCounter = 1;
+    // Set the global query counter based on the very first query's ID (defaults to 1)
+    let globalQueryId = 1;
+    const firstQuery = (_b = (_a = normalizedForm.model[0]) === null || _a === void 0 ? void 0 : _a.queries) === null || _b === void 0 ? void 0 : _b[0];
+    if (firstQuery && typeof firstQuery.queryId === 'number' && !isNaN(firstQuery.queryId)) {
+        globalQueryId = firstQuery.queryId;
+    }
+    // Recursive function to process flat queries AND nested conditional queries
+    const processQuery = (query) => {
+        // A. Assign consecutive ordered queryId
+        query.queryId = globalQueryId++;
+        // B. Sanitize inputAlias to camelCase
+        let baseAlias = toCamelCase(query.inputAlias);
+        // C. Handle completely empty/invalid strings
+        if (!baseAlias) {
+            // Ensure we don't collide with a user who manually typed "undefinedElement1"
+            let potentialAlias = `undefinedElement${undefinedCounter}`;
+            while (aliasTracker[potentialAlias]) {
+                undefinedCounter++;
+                potentialAlias = `undefinedElement${undefinedCounter}`;
+            }
+            query.inputAlias = potentialAlias;
+            aliasTracker[potentialAlias] = 1; // Mark this generated alias as used
+            undefinedCounter++;
+        }
+        // D. Enforce global uniqueness across all sections for standard aliases
+        else {
+            if (aliasTracker[baseAlias]) {
+                // Duplicate found: Increment the count and attach it (e.g., "userProfile2")
+                aliasTracker[baseAlias]++;
+                query.inputAlias = `${baseAlias}${aliasTracker[baseAlias]}`;
+            }
+            else {
+                // First instance: Record it as 1
+                aliasTracker[baseAlias] = 1;
+                query.inputAlias = baseAlias;
+            }
+        }
+        // E. Recursively process toggledInput if the query contains conditional logic
+        if (query.toggledInput) {
+            processQuery(query.toggledInput);
+        }
+    };
+    // Run the processor over all queries in all sections
+    normalizedForm.model.forEach((section) => {
+        if (section.queries && Array.isArray(section.queries)) {
+            section.queries.forEach((query) => {
+                processQuery(query);
+            });
+        }
+    });
+    return normalizedForm;
+};
+
 exports.Accordion = Accordion;
 exports.AccordionItem = AccordionItem;
 exports.AvatarInput = AvatarInput;
@@ -53946,6 +54071,7 @@ exports.Theme = R;
 exports.ThemePanel = N;
 exports.Toggle = Toggle;
 exports.UUIDInput = UUIDInput;
+exports.normalizeXForm = normalizeXForm;
 exports.parseUuidFormat = parseUuidFormat;
 exports.primeMatrix = primeMatrix;
 exports.useStepper = useStepper;

package/lib/index.esm.js

@@ -13032,13 +13032,13 @@ const CheckboxGroupInput = (_a) => {
         ` } })),
             React__default.createElement(o$6, { columns: columns || (direction === 'row' ? 'repeat(auto-fit, minmax(100px, 1fr))' : '1'), gap: "3", style: neuVars }, inputOptions.map((inputoption) => {
                 const isChecked = currentValues.some(val => String(val) === String(inputoption.optionvalue));
-                return (React__default.createElement(p$d, { as: "label", key: inputoption.optionvalue || crypto.randomUUID(), size: "2", style: {
+                return (React__default.createElement(p$d, { as: "label", key: String(inputoption.optionvalue) || crypto.randomUUID(), size: "2", style: {
                         display: 'flex',
                         alignItems: 'center',
                         gap: '8px',
                         cursor: 'pointer'
                     } },
-                    React__default.createElement(c$2, { name: alias, id: `${alias}FormInput${inputoption.optionid}`, "aria-describedby": `${alias}InputLabel${inputoption.optionid}`, disabled: readOnly, value: inputoption.optionvalue, checked: isChecked, onCheckedChange: (checked) => handleCheckedChange(checked, inputoption.optionvalue), variant: inputtype === 'checkbox-outline' ? 'soft' : 'surface', className: inputtype === 'checkbox-neumorphic' ? 'neu-checkbox' : '', style: Object.assign({}, (inputtype === 'checkbox-outline' ? {
+                    React__default.createElement(c$2, { name: alias, id: `${alias}FormInput${inputoption.optionid}`, "aria-describedby": `${alias}InputLabel${inputoption.optionid}`, disabled: readOnly, value: String(inputoption.optionvalue), checked: isChecked, onCheckedChange: (checked) => handleCheckedChange(checked, String(inputoption.optionvalue)), variant: inputtype === 'checkbox-outline' ? 'soft' : 'surface', className: inputtype === 'checkbox-neumorphic' ? 'neu-checkbox' : '', style: Object.assign({}, (inputtype === 'checkbox-outline' ? {
                             border: isChecked ? '2px solid var(--accent-9)' : '2px solid var(--gray-8)',
                             backgroundColor: 'transparent'
                         } : {})) }),
@@ -13115,7 +13115,7 @@ const ConditionalTrigger = (_a) => {
                 return (React__default.createElement(p$5, { direction: "column", gap: "1", style: { width: '100%' } },
                     React__default.createElement(C$1, { name: alias, disabled: readOnly, value: fieldValue, defaultValue: placeholder || "", onValueChange: handleChange },
                         React__default.createElement(u$1, { id: inputId, variant: isNeumorphic ? 'soft' : 'surface', style: { width: '100%' } }),
-                        React__default.createElement(g, null, inputOptions.map((inputoption) => (React__default.createElement(v, { key: inputoption.optionvalue || crypto.randomUUID(), value: inputoption.optionvalue }, inputoption.text)))))));
+                        React__default.createElement(g, null, inputOptions.map((inputoption) => (React__default.createElement(v, { key: String(inputoption.optionvalue) || crypto.randomUUID(), value: String(inputoption.optionvalue) }, inputoption.text)))))));
             case inputtype.includes('conditionaltoggle'):
             default:
                 return (React__default.createElement(p$5, { justify: "between", align: "center", style: { width: '100%' } },
@@ -27247,10 +27247,10 @@ const Dropdown = (_a) => {
                         React__default.createElement(v, { value: "__RESET__", className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '', style: { color: 'var(--gray-10)', fontStyle: 'italic' } }, placeholder || "Select an option"),
                         React__default.createElement(o$2, { size: "4", style: { margin: '4px 0', opacity: 0.5 } }),
                         inputOptions.map((inputoption) => (React__default.createElement(React__default.Fragment, { key: inputoption.optionid || crypto.randomUUID() }, inputoption.optionurl ?
-                            React__default.createElement(v, { id: String(inputoption.optionid) || '', value: inputoption.optionvalue, className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' },
+                            React__default.createElement(v, { id: String(inputoption.optionid) || '', value: String(inputoption.optionvalue), className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' },
                                 React__default.createElement("a", { onClick: (e) => { e.stopPropagation(); openLink(inputoption.optionurl || "#"); }, style: { textDecoration: 'none', color: 'inherit' } }, inputoption.text))
                             :
-                                React__default.createElement(v, { id: String(inputoption.optionid) || '', value: inputoption.optionvalue, className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' }, inputoption.text)))))),
+                                React__default.createElement(v, { id: String(inputoption.optionid) || '', value: String(inputoption.optionvalue), className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' }, inputoption.text)))))),
                 React__default.createElement("div", null,
                     React__default.createElement(p$d, { id: `${alias}InputLabel`, as: "label", size: "2", weight: "bold", htmlFor: inputId }, inputLabel),
                     "\u00A0",
@@ -48214,9 +48214,9 @@ const RadioGroupInput = (_a) => {
                 } },
                 React__default.createElement(o$6, { columns: columns || (direction === 'row' ? 'repeat(auto-fit, minmax(100px, 1fr))' : '1'), gap: "3", style: neuVars }, inputOptions.map((inputoption) => {
                     const isChecked = String(fieldValue) === String(inputoption.optionvalue);
-                    return (React__default.createElement(p$5, { asChild: true, key: inputoption.optionvalue, align: "center", gap: "2" },
+                    return (React__default.createElement(p$5, { asChild: true, key: String(inputoption.optionvalue), align: "center", gap: "2" },
                         React__default.createElement(p$d, { as: "label", size: "2", style: { cursor: 'pointer' } },
-                            React__default.createElement(y$1, { value: inputoption.optionvalue, className: inputtype === 'radio-neumorphic' ? 'neu-radio' : '', style: Object.assign({}, (inputtype === 'radio-outline' ? {
+                            React__default.createElement(y$1, { value: String(inputoption.optionvalue), className: inputtype === 'radio-neumorphic' ? 'neu-radio' : '', style: Object.assign({}, (inputtype === 'radio-outline' ? {
                                     border: isChecked ? '2px solid var(--accent-9)' : '2px solid var(--gray-8)',
                                     backgroundColor: 'transparent'
                                 } : {})) }),
@@ -48342,8 +48342,8 @@ const OptionSelect = (_a) => {
                 React__default.createElement(g, { position: "popper", sideOffset: 5, style: activeContentStyle },
                     React__default.createElement(v, { value: "__RESET__", className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '', style: { color: 'var(--gray-10)', fontStyle: 'italic' } }, placeholder || "Select an option"),
                     React__default.createElement(o$2, { size: "4", style: { margin: '4px 0', opacity: 0.5 } }),
-                    inputOptions.map((inputoption) => (React__default.createElement(React__default.Fragment, { key: inputoption.optionid || crypto.randomUUID() }, inputoption.optionurl ? (React__default.createElement(v, { id: String(inputoption.optionid) || '', value: inputoption.optionvalue, className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' },
-                        React__default.createElement("a", { onClick: (e) => { e.stopPropagation(); openLink(inputoption.optionurl || "#"); }, style: { textDecoration: 'none', color: 'inherit' } }, inputoption.text))) : (React__default.createElement(v, { id: String(inputoption.optionid) || '', value: inputoption.optionvalue, className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' }, inputoption.text))))))),
+                    inputOptions.map((inputoption) => (React__default.createElement(React__default.Fragment, { key: inputoption.optionid || crypto.randomUUID() }, inputoption.optionurl ? (React__default.createElement(v, { id: String(inputoption.optionid) || '', value: String(inputoption.optionvalue), className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' },
+                        React__default.createElement("a", { onClick: (e) => { e.stopPropagation(); openLink(inputoption.optionurl || "#"); }, style: { textDecoration: 'none', color: 'inherit' } }, inputoption.text))) : (React__default.createElement(v, { id: String(inputoption.optionid) || '', value: String(inputoption.optionvalue), className: inputtype === 'dropdown-neumorphic' ? 'neu-select-item' : '' }, inputoption.text))))))),
             React__default.createElement("div", null,
                 React__default.createElement(p$d, { id: `${alias}InputLabel`, as: "label", size: "2", weight: "bold", htmlFor: `${alias}FormInput` }, inputLabel),
                 "\u00A0",
@@ -48384,7 +48384,7 @@ const MultipleSelect = (_a) => {
     };
     const displayLabel = selectedValues.length > 0
         ? inputOptions
-            .filter(inputoption => selectedValues.includes(inputoption.optionvalue))
+            .filter(inputoption => selectedValues.includes(String(inputoption.optionvalue)))
             .map(inputoption => inputoption.text)
             .join(', ')
         : placeholder;
@@ -48447,7 +48447,7 @@ const MultipleSelect = (_a) => {
                                     === String(inputoption.optionvalue));
                                 return (React__default.createElement(p$5, { id: String(inputoption.optionid) || '', key: inputoption.optionid, align: "center", gap: "2", onClick: () => {
                                         if (!readOnly)
-                                            handleToggle(inputoption.optionvalue);
+                                            handleToggle(String(inputoption.optionvalue));
                                     }, style: {
                                         padding: '8px',
                                         cursor: readOnly ? 'default' : 'pointer',
@@ -49126,7 +49126,7 @@ const CodexItem = ({ stepId, children, }) => {
     return (React__default.createElement("div", { className: "v-step-content-animation", style: { width: '100%' } }, children));
 };
 
-const CodexControls = ({ nextStepId, prevStepId, nextLabel = "Continue", prevLabel = "Back", finishLabel = "Submit", prevIcon = "doublearrowleft", nextIcon = "doublearrowright", finishIcon = "paperplane", onNext, onPrev, onFinish }) => {
+const CodexControls = ({ nextStepId, prevStepId, nextLabel = "Continue", prevLabel = "Back", finishLabel = "Submit", prevIcon = "doublearrowleft", nextIcon = "doublearrowright", finishIcon = "paperplane", onSubmit = false, onNext, onPrev, onFinish }) => {
     const { setActiveStepId, brandColor } = useStepper();
     const handlePrev = () => {
         if (onPrev)
@@ -49151,7 +49151,7 @@ const CodexControls = ({ nextStepId, prevStepId, nextLabel = "Continue", prevLab
                 React__default.createElement(Icon, { name: prevIcon }),
                 "\u00A0")),
             prevLabel)) : (React__default.createElement("div", null)),
-        React__default.createElement(o$a, { variant: "solid", color: brandColor ? undefined : (nextStepId ? "blue" : "green"), onClick: handleNext, style: Object.assign({ cursor: 'pointer' }, (brandColor ? { backgroundColor: 'var(--codex-brand)', color: '#fff' } : {})) }, nextStepId ? (React__default.createElement(React__default.Fragment, null,
+        React__default.createElement(o$a, { variant: "solid", color: brandColor ? undefined : (nextStepId ? "blue" : "green"), onClick: handleNext, style: Object.assign({ cursor: 'pointer' }, (brandColor ? { backgroundColor: 'var(--codex-brand)', color: '#fff' } : {})), type: onSubmit && !nextStepId ? "submit" : "button" }, nextStepId ? (React__default.createElement(React__default.Fragment, null,
             nextIcon && React__default.createElement(React__default.Fragment, null,
                 React__default.createElement(Icon, { name: nextIcon }),
                 "\u00A0"),
@@ -53887,4 +53887,129 @@ const parseUuidFormat = (input) => {
     return numbers;
 };
 
-export { Accordion, AccordionItem, AvatarInput, ButtonInput, CURRENCIES, CheckboxGroupInput, Codex, CodexControls, CodexItem, Column, ConditionalTrigger, Container, CreditCardInput, CurrencyInput, DatePicker, DateRangePicker, DateTimePicker, Dropdown, File$1 as File, FileMultiple, FlagIcon, Icon, ImageOutput, Input$2 as Input, MultipleSelect, OptionSelect, PasswordInput, PhoneInput, RadioGroupInput, RangeSlider, Row, SectionTitle, SliderInput, StockInput, Teletraan1, R as Theme, N as ThemePanel, Toggle, UUIDInput, parseUuidFormat, primeMatrix, useStepper, vectorSigma, xFormSchema };
+/**
+ * Utility to convert any string to camelCase (e.g., "USER NAME" -> "userName", "user_profile" -> "userProfile")
+ * Safely handles ALL CAPS, snake_case, spaces, and existing camelCase.
+ * @param str - String to convert to camelCase format
+ */
+const toCamelCase = (str) => {
+    if (!str)
+        return "";
+    const words = str
+        .replace(/([a-z])([A-Z])/g, '$1 $2') // 1. Split existing camelCase with a space
+        .replace(/[^a-zA-Z0-9]+/g, ' ') // 2. Replace non-alphanumeric characters with spaces
+        .trim()
+        .toLowerCase() // 3. Lowercase everything
+        .split(/\s+/); // 4. Split into an array of words
+    if (words.length === 0 || words[0] === '')
+        return "";
+    return words.map((word, index) => {
+        if (index === 0)
+            return word; // First word stays lowercase
+        return word.charAt(0).toUpperCase() + word.slice(1); // Capitalize subsequent words
+    }).join('');
+};
+/**
+ * Utility to convert a string to kebab-case (e.g., "Profile Section" -> "profile-section")
+ * Ensures code-friendly standard strings.
+ * @param str - String to convert to kebab-case format
+ */
+const toKebabCase = (str) => {
+    if (!str)
+        return "";
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2') // 1. Handle camelCase inputs
+        .replace(/[^a-zA-Z0-9]+/g, '-') // 2. Replace non-alphanumeric chars with hyphens
+        .toLowerCase() // 3. Lowercase everything
+        .replace(/^-+|-+$/g, ''); // 4. Trim any leading or trailing hyphens
+};
+/**
+ * Normalizes and sanitizes an XFormType object.
+ * - Standardizes Section IDs (Consecutive numbers or code-friendly strings).
+ * - Enforces globally consecutive Query IDs.
+ * - Ensures unique, Formik-friendly camelCase Input Aliases.
+ * - Auto-fills empty inputAliases with unique 'undefinedElement[N]' placeholder.
+ * @param xform - xForm object {} to normalize `sectionId`, `queryId` and `inputAlias` attributes for `<Teletraan1/>` component
+ */
+const normalizeXForm = (xform) => {
+    var _a, _b;
+    // Deep clone the object to prevent mutating the original data reference
+    const normalizedForm = JSON.parse(JSON.stringify(xform));
+    if (!normalizedForm.model || normalizedForm.model.length === 0) {
+        return normalizedForm;
+    }
+    // ==========================================
+    // 1. SECTION ID NORMALIZATION
+    // ==========================================
+    const firstSectionId = normalizedForm.model[0].sectionId;
+    const isFirstSectionNumbered = !isNaN(Number(firstSectionId)) && String(firstSectionId).trim() !== '';
+    let sectionCounter = isFirstSectionNumbered ? Number(firstSectionId) : 1;
+    normalizedForm.model.forEach((section) => {
+        if (isFirstSectionNumbered) {
+            // If the first section was a number, make all subsequent sections consecutive numbers
+            section.sectionId = String(sectionCounter++);
+        }
+        else {
+            // Otherwise, sanitize to a code-friendly string
+            section.sectionId = toKebabCase(section.sectionId) || `section-${sectionCounter++}`;
+        }
+    });
+    // ==========================================
+    // 2. QUERY ID & ALIAS NORMALIZATION
+    // ==========================================
+    const aliasTracker = {};
+    let undefinedCounter = 1;
+    // Set the global query counter based on the very first query's ID (defaults to 1)
+    let globalQueryId = 1;
+    const firstQuery = (_b = (_a = normalizedForm.model[0]) === null || _a === void 0 ? void 0 : _a.queries) === null || _b === void 0 ? void 0 : _b[0];
+    if (firstQuery && typeof firstQuery.queryId === 'number' && !isNaN(firstQuery.queryId)) {
+        globalQueryId = firstQuery.queryId;
+    }
+    // Recursive function to process flat queries AND nested conditional queries
+    const processQuery = (query) => {
+        // A. Assign consecutive ordered queryId
+        query.queryId = globalQueryId++;
+        // B. Sanitize inputAlias to camelCase
+        let baseAlias = toCamelCase(query.inputAlias);
+        // C. Handle completely empty/invalid strings
+        if (!baseAlias) {
+            // Ensure we don't collide with a user who manually typed "undefinedElement1"
+            let potentialAlias = `undefinedElement${undefinedCounter}`;
+            while (aliasTracker[potentialAlias]) {
+                undefinedCounter++;
+                potentialAlias = `undefinedElement${undefinedCounter}`;
+            }
+            query.inputAlias = potentialAlias;
+            aliasTracker[potentialAlias] = 1; // Mark this generated alias as used
+            undefinedCounter++;
+        }
+        // D. Enforce global uniqueness across all sections for standard aliases
+        else {
+            if (aliasTracker[baseAlias]) {
+                // Duplicate found: Increment the count and attach it (e.g., "userProfile2")
+                aliasTracker[baseAlias]++;
+                query.inputAlias = `${baseAlias}${aliasTracker[baseAlias]}`;
+            }
+            else {
+                // First instance: Record it as 1
+                aliasTracker[baseAlias] = 1;
+                query.inputAlias = baseAlias;
+            }
+        }
+        // E. Recursively process toggledInput if the query contains conditional logic
+        if (query.toggledInput) {
+            processQuery(query.toggledInput);
+        }
+    };
+    // Run the processor over all queries in all sections
+    normalizedForm.model.forEach((section) => {
+        if (section.queries && Array.isArray(section.queries)) {
+            section.queries.forEach((query) => {
+                processQuery(query);
+            });
+        }
+    });
+    return normalizedForm;
+};
+
+export { Accordion, AccordionItem, AvatarInput, ButtonInput, CURRENCIES, CheckboxGroupInput, Codex, CodexControls, CodexItem, Column, ConditionalTrigger, Container, CreditCardInput, CurrencyInput, DatePicker, DateRangePicker, DateTimePicker, Dropdown, File$1 as File, FileMultiple, FlagIcon, Icon, ImageOutput, Input$2 as Input, MultipleSelect, OptionSelect, PasswordInput, PhoneInput, RadioGroupInput, RangeSlider, Row, SectionTitle, SliderInput, StockInput, Teletraan1, R as Theme, N as ThemePanel, Toggle, UUIDInput, normalizeXForm, parseUuidFormat, primeMatrix, useStepper, vectorSigma, xFormSchema };

package/lib/types/index.d.ts

@@ -38,3 +38,4 @@ export * from './layouts/codex/codexcontrols';
 export * from './utils/architect';
 export * from './utils/uuidparser';
 export * from './utils/currencyconfig';
+export * from './utils/minerva';

package/lib/types/layouts/codex/codexcontrols.d.ts

@@ -45,6 +45,11 @@ export interface CodexControlsProps {
      * Default: "paperplane"
      */
     finishIcon?: string;
+    /**
+    * * Option to enable `onFinish` control button as `submit` button type.
+    * Default: true
+    */
+    onSubmit?: boolean;
     /**
      * * Optional callback triggered before navigating to the next step.
      * Useful for triggering form validation.
@@ -59,4 +64,4 @@ export interface CodexControlsProps {
      */
     onFinish?: () => void;
 }
-export declare const CodexControls: ({ nextStepId, prevStepId, nextLabel, prevLabel, finishLabel, prevIcon, nextIcon, finishIcon, onNext, onPrev, onFinish }: CodexControlsProps) => React.JSX.Element;
+export declare const CodexControls: ({ nextStepId, prevStepId, nextLabel, prevLabel, finishLabel, prevIcon, nextIcon, finishIcon, onSubmit, onNext, onPrev, onFinish }: CodexControlsProps) => React.JSX.Element;

package/lib/types/teletraan1.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { xForm } from 'utils/architect';
+import { XFormType } from 'utils/voltron';
 export type teletraan1Display = 'accordion' | 'codice' | 'codex' | 'dual';
 export interface Teletraan1Props {
     /**
@@ -8,7 +8,7 @@ export interface Teletraan1Props {
      * * @example
      * xFormModel={xFormJSONPrototype}
      */
-    xFormModel: xForm;
+    xFormModel: XFormType;
     /**
      * * Option to render xForm as readonly (inputs disabled).
      * * @example

package/lib/types/tests/components/components.avatar.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.button.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.checkboxgroup.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.conditional.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.datepickers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.files.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.iconimage.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.inputs.finance.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.inputs.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.radiogroup.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.rangeslider.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.sectiontitle.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/components/components.selectors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/layouts/layouts.accordion.test.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom';

package/lib/types/tests/layouts/layouts.codex.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/layouts/layouts.column.test.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom';

package/lib/types/tests/layouts/layouts.container.test.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom';

package/lib/types/tests/layouts/layouts.row.test.d.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom';

package/lib/types/tests/utils/utils.chronos.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/utils/utils.minerva.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/utils/utils.uuid.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/tests/utils/utils.vinci.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/utils/artificer.d.ts

@@ -0,0 +1,2 @@
+import { XFormType } from "./voltron";
+export declare const xFormPrototypeData: XFormType;

package/lib/types/utils/minerva.d.ts

@@ -0,0 +1,10 @@
+import { XFormType } from "./voltron";
+/**
+ * Normalizes and sanitizes an XFormType object.
+ * - Standardizes Section IDs (Consecutive numbers or code-friendly strings).
+ * - Enforces globally consecutive Query IDs.
+ * - Ensures unique, Formik-friendly camelCase Input Aliases.
+ * - Auto-fills empty inputAliases with unique 'undefinedElement[N]' placeholder.
+ * @param xform - xForm object {} to normalize `sectionId`, `queryId` and `inputAlias` attributes for `<Teletraan1/>` component
+ */
+export declare const normalizeXForm: (xform: XFormType) => XFormType;

package/lib/types/utils/vinci.d.ts

@@ -27,7 +27,7 @@ export interface InputOption {
     * * @example
     * optionvalue="VGTRX-1000"
     */
-    optionvalue: string;
+    optionvalue: string | number | boolean;
     /**
     * * The optional tag for the Input Option item.
     * * @example

package/lib/types/utils/voltaire.d.ts

@@ -1,3 +1,4 @@
+import { XFormType } from "./voltron";
 export declare const avatarInputType: string[];
 export declare const buttonInputType: string[];
 export declare const checkboxInputType: string[];
@@ -22,3 +23,4 @@ export declare const rangeSliderInputType: string[];
 export declare const toggleInputType: string[];
 export declare const sectionTitleOutputType: string[];
 export declare const conditionalInputType: string[];
+export declare const generateInitialValues: (schema: XFormType) => Record<string, any>;

package/lib/types/utils/voltron.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+export declare const InputOptionSchema: z.ZodObject<{
+    optionid: z.ZodNumber;
+    optionvalue: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    optionurl: z.ZodOptional<z.ZodString>;
+    text: z.ZodString;
+    tag: z.ZodOptional<z.ZodString>;
+    score: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodFloat64]>>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type XFormQuery = {
+    queryId: number;
+    inputType: string;
+    inputAlias: string;
+    inputLabel: string;
+    inputPlaceholder?: string;
+    newRow?: boolean;
+    inputWidth: number;
+    inputHeight?: number;
+    isRequired?: boolean;
+    isHinted?: boolean;
+    hintText?: string;
+    hintUrl?: string;
+    errorText?: string;
+    defaultValue?: any;
+    queryResponse?: any;
+    inputOptions?: z.infer<typeof InputOptionSchema>[];
+    triggerValue?: any;
+    toggledInput?: XFormQuery | null;
+    minValue?: number;
+    maxValue?: number;
+    stepValue?: number;
+};
+export declare const QuerySchema: z.ZodType<XFormQuery>;
+export declare const SectionSchema: z.ZodObject<{
+    sectionId: z.ZodString;
+    title: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    queries: z.ZodArray<z.ZodType<XFormQuery, unknown, z.core.$ZodTypeInternals<XFormQuery, unknown>>>;
+}, z.core.$strip>;
+export declare const XFormSchema: z.ZodObject<{
+    uuid: z.ZodString;
+    name: z.ZodString;
+    logo: z.ZodOptional<z.ZodString>;
+    brandColor: z.ZodOptional<z.ZodString>;
+    logoPosition: z.ZodOptional<z.ZodString>;
+    model: z.ZodArray<z.ZodObject<{
+        sectionId: z.ZodString;
+        title: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        queries: z.ZodArray<z.ZodType<XFormQuery, unknown, z.core.$ZodTypeInternals<XFormQuery, unknown>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type XFormType = z.infer<typeof XFormSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeraldemperaur/vector-sigma",
-  "version": "1.4.29",
+  "version": "1.4.31",
   "description": "Dynamic Form Orchestrator: NPM Package",
   "repository": {
     "type": "git",