@emeraldemperaur/vector-sigma 1.4.48 → 1.4.50

package/lib/types/index.d.ts

@@ -40,3 +40,4 @@ export * from './utils/voltron';
 export * from './utils/uuidparser';
 export * from './utils/currencyconfig';
 export * from './utils/minerva';
+export * from './hooks/useVectorSigma';

package/lib/types/vectorSigma.d.ts

@@ -24,18 +24,35 @@ export interface VectorSigmaRenderProps<T extends Record<string, any> = Record<s
     /**
      * * Optional Radix UI Theme configuration.
      * Enables developer theming extensibility to align xForm appearance with an extant application design system.
-     *
-     * https://www.radix-ui.com/themes/docs/components/theme
+     * * https://www.radix-ui.com/themes/docs/components/theme
      * @example
      * theme={{ appearance: 'dark', accentColor: 'ruby', radius: 'large' }}
      */
     theme?: Omit<ThemeProps, 'children'>;
+    /**
+     * * Optional toggle to disable the default xForm bottom submit button.
+     * Allows developers to implement custom Submit, Save or Validate buttons outside xForm component.
+     * @example
+     * buttonOverride={true}
+     */
+    buttonOverride?: boolean;
+}
+export interface VectorSigmaActions<T> {
+    submitForm: () => Promise<void | undefined>;
+    resetForm: (nextState?: Partial<import('formik').FormikState<T>>) => void;
+    setValues: (values: React.SetStateAction<T>, shouldValidate?: boolean) => Promise<void | import('formik').FormikErrors<T>>;
+    setFieldValue: (field: string, value: any, shouldValidate?: boolean) => Promise<void | import('formik').FormikErrors<T>>;
+    setFieldError: (field: string, message: string | undefined) => void;
+    setFieldTouched: (field: string, isTouched?: boolean, shouldValidate?: boolean) => Promise<void | import('formik').FormikErrors<T>>;
+    validateForm: (values?: any) => Promise<import('formik').FormikErrors<T>>;
+    setSubmitting: (isSubmitting: boolean) => void;
 }
 export declare class VectorSigma<T extends Record<string, any> = Record<string, any>> {
     isValid: boolean;
     formObject: XFormType;
     values: Partial<T>;
     errors: Record<string, any>;
+    actions: VectorSigmaActions<T> | null;
     statusCode: 0 | 1 | 2;
     timeCreated: number;
     timeInProgress: number | null;
@@ -58,6 +75,7 @@ export declare class VectorSigma<T extends Record<string, any> = Record<string,
     private buildFormikConfig;
     /**
      * Traverses xForm schema object and injects Formik values into their respective input queryResponse attributes by `inputAlias`.
+     * For select-based inputs, it hydrates the queryResponse with the full matching inputOption object(s).
      */
     private hydrateQueryResponses;
     /**
@@ -149,17 +167,17 @@ export declare class VectorSigma<T extends Record<string, any> = Record<string,
      * * Transforms the initialized xForm JSON/JS object, normalizing attribute fields and returning a `<Teletraan1/>` component.
      * @param options VectorSigmaRenderProps -- `VectorSigma` and `Teletraan1` props for VΣ render matrix.
      * @example .transform({
-          displayMode: 'codex',
-          readOnlyMode: false,
-          brandColor: '#800020',
-          onSubmit: async (values, actions, instance) => { // <-- onSubmit callback function passed into VectorSigma props
+         displayMode: 'codex',
+         readOnlyMode: false,
+         brandColor: '#800020',
+         onSubmit: async (values, actions, instance) => { // <-- onSubmit callback function passed into VectorSigma props
             // Use Case: Send extant xForm object to API
             await axios.post('/api/submit', instance.getxForm());
             // Use Case: Submit and clear form after success
             actions.submitForm();
             actions.resetForm();
             },
-          onFinish: () => handleFormFinish() // <-- onFinish callback function passed into Teletraan1 (Codex only) props
+         onFinish: () => handleFormFinish() // <-- onFinish callback function passed into Teletraan1 (Codex only) props
       })})
      */
     transform(options?: VectorSigmaRenderProps<T>): React.ReactElement;
@@ -169,17 +187,17 @@ export declare class VectorSigma<T extends Record<string, any> = Record<string,
      * * `render()` is the final method in the Vector Sigma builder pattern chain.
      * @param options VectorSigmaRenderProps -- `VectorSigma` and `Teletraan1` props for VΣ render matrix.
      * @example .render({
-          displayMode: 'dual',
-          brandColor: '#800020',
-          readOnlyMode: false,
-          onSubmit: async (values, actions, instance) => { // <-- onSubmit callback function passed into VectorSigma props
+         displayMode: 'dual',
+         brandColor: '#800020',
+         readOnlyMode: false,
+         onSubmit: async (values, actions, instance) => { // <-- onSubmit callback function passed into VectorSigma props
             // Use Case: Send hydrated xForm object to API
             await axios.post('/api/submit', instance.getxForm());
             // Use Case: Submit and clear form after success
             actions.submitForm();
             actions.resetForm();
             },
-          onFinish: () => handleFormFinish() // <-- onFinish callback function passed into Teletraan1 (Codex) props
+         onFinish: () => handleFormFinish() // <-- onFinish callback function passed into Teletraan1 (Codex) props
       })})
      */
     render(options?: VectorSigmaRenderProps<T>): React.ReactElement;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeraldemperaur/vector-sigma",
-  "version": "1.4.48",
+  "version": "1.4.50",
   "description": "Dynamic Form Orchestrator: NPM Package",
   "repository": {
     "type": "git",
@@ -11,6 +11,7 @@
   "type": "module",
   "main": "lib/index.cjs",
   "module": "lib/index.esm.js",
+  "unpkg": "lib/index.umd.js",
   "browser": "lib/index.esm.js",
   "types": "lib/types/index.d.ts",
   "exports": {
@@ -47,32 +48,24 @@
     "@types/react": "^19.2.10",
     "@types/react-dom": "^19.2.3",
     "@types/react-datepicker": "^6.2.0",
-    "formik": "^2.4.9",
     "identity-obj-proxy": "^3.0.0",
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.2.0",
     "jest-junit": "^16.0.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
     "rollup": "^4.58.1",
     "rollup-plugin-delete": "^3.0.2",
     "rollup-plugin-postcss": "^4.0.2",
     "rollup-plugin-preserve-directives": "^0.4.0",
     "rollup-plugin-typescript2": "^0.36.0",
     "rollup-plugin-visualizer": "^6.0.5",
-    "sass-embedded": "^1.97.3",
     "ts-jest": "^29.4.6",
     "tslib": "^2.8.1",
-    "typescript": "^5.9.3",
-    "yup": "^1.7.1",
-    "zod": "^4.3.6"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "formik": "^2.4.9",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
-    "sass-embedded": "^1.97.3",
-    "yup": "^1.7.1"
+    "sass-embedded": "^1.97.3"
   },
   "dependencies": {
     "@radix-ui/react-accordion": "^1.2.12",
@@ -81,10 +74,13 @@
     "card-validator": "^10.0.4",
     "country-flag-icons": "^1.6.12",
     "date-fns": "^4.1.0",
+    "formik": "^2.4.9",
     "react-datepicker": "^9.1.0",
     "react-day-picker": "^9.13.1",
     "react-imask": "^7.6.1",
-    "react-phone-number-input": "^3.4.14"
+    "react-phone-number-input": "^3.4.14",
+    "yup": "^1.7.1",
+    "zod": "^4.3.6"
   },
   "overrides": {
     "minimatch": "^10.2.3"