@emeraldemperaur/vector-sigma 1.4.30 → 1.4.31

package/lib/index.cjs

@@ -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

@@ -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/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/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/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/package.json

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