@globalpayments/vega 2.64.0 → 2.65.0

package/dist/esm/vega-form.entry.js

@@ -1,26 +1,32 @@
 import { h, r as registerInstance, c as createEvent, H as Host, g as getElement } from './index-090d31ca.js';
-import { F as FormFieldControllerSlimmer } from './form-field-controller-slimmer-c29b345f.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { O as Observer } from './observer-3959f9dd.js';
-import { f as FIELD_ERROR_MESSAGE_CHANGE, g as FORM_ELEMENT_VALIDATE, b as FORM_ELEMENT_VALUE_CHANGE, d as FORM_FIELD_ELEMENT_DISCONNECTED, c as FORM_FIELD_PENDING_VALID_CHANGE, e as FORM_RESET_OPERATION_TRIGGERED, F as FORM_SUBMIT, a as FORM_RESET } from './static-subject-title-ca83d6b6.js';
-import { d as isObjectArrayLike } from './array-7888f339.js';
+import { d as FIELD_ERROR_MESSAGE_CHANGE, e as FORM_ELEMENT_VALIDATE, F as FORM_ELEMENT_VALUE_CHANGE, b as FORM_FIELD_ELEMENT_DISCONNECTED, a as FORM_FIELD_PENDING_VALID_CHANGE, c as FORM_RESET_OPERATION_TRIGGERED } from './static-subject-title-52f93124.js';
 import { s as sanitizeVegaComponent } from './component-7d906393.js';
-import { f as findParent, d as isElementVisible, b as isParent } from './ui-c20be16d.js';
-import { I as ImmutableMap } from './immutable-map-612922a2.js';
 import { c as MapToComponentField, M as MapToComponentMethod, V as VegaSlimmer, I as InjectVegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
+import { m as methodPlaceholder } from './placeholder-bf562081.js';
 import { V as VegaComponentUsageRuntimeMetricsSlimmer, I as InjectVegaGlobalSlimmer } from './component-usage-runtime-metrics-a84cc93e.js';
-import { c as createEventEmitSlimmer } from './event-emit-slimmer-3922d816.js';
-import { C as ChildNodesEventPreventSlimmer } from './child-nodes-event-prevent-slimmer-7fe3dc57.js';
-import { y as VegaFormSubmit, z as VegaFormReset, A as VegaValidate, d as domNodeSubjectFactory } from './dom-node-subject-observer-factory-c7bc3035.js';
-import { C as ChildNodesNotifyObserverSlimmer } from './child-nodes-notify-observer-slimmer-78f77c2c.js';
-import { e as VegaInternalValid } from './vega-internal-event-id-bee7946b.js';
-import { c as createSubStateNotifySlimmer } from './sub-state-notify-slimmer-85c658b7.js';
-import { S as SubStateObserverSlimmer } from './sub-state-observer-slimmer-e58a2485.js';
+import { c as createEventEmitSlimmer } from './event-emit-slimmer-000ca6a7.js';
+import { C as ChildNodesEventPreventSlimmer } from './child-nodes-event-prevent-slimmer-f32efdee.js';
+import { d as domNodeSubjectFactory, y as VegaFormSubmit, z as VegaFormReset, A as VegaValidate } from './dom-node-subject-observer-factory-ed4b89f4.js';
+import { c as createSubStateNotifySlimmer } from './sub-state-notify-slimmer-8b3b15ee.js';
+import { S as SubStateObserverSlimmer } from './sub-state-observer-slimmer-2b98e2c9.js';
+import { F as FormFieldControllerSlimmer } from './form-field-controller-slimmer-24dbc255.js';
 import { t as tryGetDocument } from './try-get-document-bef0f526.js';
+import { d as VegaInternalFormSubmit, g as VegaInternalValid, e as VegaInternalFormReset } from './vega-internal-event-id-5c3e5f7f.js';
+import { O as Observer } from './observer-3959f9dd.js';
+import { f as findParent, b as isParent, d as isElementVisible } from './ui-bb99c0c2.js';
+import { I as ImmutableMap } from './immutable-map-612922a2.js';
+import { C as ChildNodesNotifyObserverSlimmer } from './child-nodes-notify-observer-slimmer-b676cd2b.js';
+import { d as isObjectArrayLike } from './array-7888f339.js';
+import './dynamic-slimmer-90b8af32.js';
+import './internal-vega-event-manager-13e3ed3d.js';
+import './vega-env-manager-8f8dc473.js';
+import './feature-flag-controller-51659753.js';
+import './index-e9da316f.js';
+import './_commonjsHelpers-9943807e.js';
 import './string-a953eafc.js';
 import './create-public-api-runtime-metrics-slimmer-bedf3a1e.js';
-import './dynamic-slimmer-90b8af32.js';
-import './translation-3d35961b.js';
+import './translation-f10b1e19.js';
 import './page-resize-observer-slimmer-0bf7fbf3.js';
 import './ui-8424715a.js';
 import './breakpoints-d9faf11c.js';
@@ -28,13 +34,8 @@ import './internal-form-field-validation-rule.abstract-f5b6bdbf.js';
 import './mutation-observer-slimmer-58ebc13c.js';
 import './mutation-observer-filters-1a054fb0.js';
 import './number-4398f2e1.js';
-import './internal-vega-event-manager-cb06e987.js';
-import './vega-env-manager-8f8dc473.js';
-import './feature-flag-controller-51659753.js';
-import './index-e9da316f.js';
-import './_commonjsHelpers-9943807e.js';
 
-var __decorate$3 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$6 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -57,14 +58,14 @@ class VegaFormNestStateController extends SubStateObserverSlimmer {
     });
   }
 }
-__decorate$3([
+__decorate$6([
   MapToComponentField()
 ], VegaFormNestStateController.prototype, "host", void 0);
-__decorate$3([
+__decorate$6([
   MapToComponentField({ writable: true })
 ], VegaFormNestStateController.prototype, "disableBlurValidation", void 0);
 
-var __decorate$2 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$5 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -134,14 +135,14 @@ class VegaFormFieldValidationStateController extends VegaSlimmer {
     ChangeManager.notify(FORM_ELEMENT_VALIDATE, { host: target, detail: isValid });
   }
 }
-__decorate$2([
+__decorate$5([
   MapToComponentField()
 ], VegaFormFieldValidationStateController.prototype, "host", void 0);
-__decorate$2([
+__decorate$5([
   MapToComponentMethod('setValidationStates')
 ], VegaFormFieldValidationStateController.prototype, "setValidationStates", null);
 
-var __decorate$1 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$4 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
@@ -163,127 +164,156 @@ class NativeFormRenderer extends VegaSlimmer {
       h("slot", null)));
   }
 }
-__decorate$1([
+__decorate$4([
   MapToComponentField()
 ], NativeFormRenderer.prototype, "method", void 0);
-__decorate$1([
+__decorate$4([
   MapToComponentField()
 ], NativeFormRenderer.prototype, "action", void 0);
 
-const vegaFormCss = ":host{display:block}";
+var __decorate$3 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * Controller responsible for handling form submission in the VegaForm component.
+ */
+class VegaFormSubmitController extends VegaSlimmer {
+  /**
+   * Component lifecycle - [connectedCallback]
+   */
+  connectedCallback() {
+    this.registerFormSubmitChangeManager();
+  }
+  /**
+   * Component lifecycle - [disconnectedCallback]
+   */
+  disconnectedCallback() {
+    this.unregisterFormSubmitChangeManager();
+  }
+  /**
+   * Submits the form using native HTML form submission with all current field values.
+   *
+   * This method collects all form field values, creates hidden input elements for each field,
+   * appends them to a container inside the native form, and then triggers the native
+   * `requestSubmit()` method to submit the form.
+   *
+   * The method ensures that the form data is available in the native form for submission,
+   * which is useful when `useNativeForm` is enabled.
+   *
+   * @returns {Promise<void>} Resolves when the form submission process is complete.
+   */
+  async submitWithFormData() {
+    if (!this.useNativeForm)
+      return;
+    const data = await this.host.getValue();
+    for (const dataKey in data) {
+      const hiddenInput = tryGetDocument().createElement('input');
+      hiddenInput.type = 'hidden';
+      hiddenInput.name = dataKey;
+      hiddenInput.value = data[dataKey];
+      this.nativeFormRenderer.getNativeFormRef().append(hiddenInput);
+    }
+    this.nativeFormRenderer.getNativeFormRef().requestSubmit();
+  }
+  /**
+   * Registers the form submit event observer with the ChangeManager.
+   */
+  registerFormSubmitChangeManager() {
+    var _a;
+    this.formSubmitEventObserver = new Observer(this.canAcceptFormSubmitEvent.bind(this), this.handleSubmitEvents.bind(this));
+    const outerForm = (_a = findParent(this.host, 'vega-form', { outerMost: true })) !== null && _a !== void 0 ? _a : this.host;
+    ChangeManager.register(domNodeSubjectFactory.getSubject(outerForm, VegaInternalFormSubmit), this.formSubmitEventObserver);
+  }
+  /**
+   * Unregister the form submit event observer from the ChangeManager.
+   */
+  unregisterFormSubmitChangeManager() {
+    var _a;
+    const outerForm = (_a = findParent(this.host, 'vega-form', { outerMost: true })) !== null && _a !== void 0 ? _a : this.host;
+    ChangeManager.unregister(domNodeSubjectFactory.getSubject(outerForm, VegaInternalFormSubmit), this.formSubmitEventObserver);
+  }
+  /*
+   * The below method is e2e-test covered in
+   * @see{module:vega-form-field-enter-to-submit-e2e}
+   */
+  /* istanbul ignore next */
+  /**
+   * Can accept handler for FORM_SUBMIT.
+   *
+   * @param {FormEventsPayload} payload - The payload containing the host element that triggered the submit event.
+   * @returns {boolean} True if the host element is part of the current form, false otherwise.
+   */
+  canAcceptFormSubmitEvent(payload) {
+    return this.vegaFormFieldController.isElementInCurrentForm(payload.host);
+  }
+  /**
+   * Handles the form submission process.
+   *
+   * @returns {Promise<void>} Resolves when the submission process is complete.
+   */
+  async handleSubmitEvents() {
+    const valid = await this.host.valid();
+    if (valid.isValid) {
+      const formValue = await this.host.getValue();
+      const submitEvent = this.submitEventEmitter.emit(formValue);
+      if (!submitEvent.defaultPrevented) {
+        await this.submitWithFormData();
+      }
+    }
+  }
+}
+__decorate$3([
+  MapToComponentField()
+], VegaFormSubmitController.prototype, "host", void 0);
+__decorate$3([
+  MapToComponentField()
+], VegaFormSubmitController.prototype, "useNativeForm", void 0);
+__decorate$3([
+  MapToComponentField()
+], VegaFormSubmitController.prototype, "nativeFormRenderer", void 0);
+__decorate$3([
+  MapToComponentField()
+], VegaFormSubmitController.prototype, "submitEventEmitter", void 0);
+__decorate$3([
+  MapToComponentField()
+], VegaFormSubmitController.prototype, "vegaFormFieldController", void 0);
+__decorate$3([
+  MapToComponentMethod('connectedCallback')
+], VegaFormSubmitController.prototype, "connectedCallback", null);
+__decorate$3([
+  MapToComponentMethod('disconnectedCallback')
+], VegaFormSubmitController.prototype, "disconnectedCallback", null);
 
-var __decorate = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+var __decorate$2 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
-    r = Reflect.decorate(decorators, target, key, desc);
-  else
-    for (var i = decorators.length - 1; i >= 0; i--)
-      if (d = decorators[i])
-        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-const VegaForm = class {
-  constructor(hostRef) {
-    registerInstance(this, hostRef);
-    this.vegaValidate = createEvent(this, "vegaValidate", 7);
-    this.validate = createEvent(this, "validate", 7);
-    this.vegaFormSubmit = createEvent(this, "vegaFormSubmit", 7);
-    this.formSubmit = createEvent(this, "formSubmit", 7);
-    this.vegaFormReset = createEvent(this, "vegaFormReset", 7);
-    this.formReset = createEvent(this, "formReset", 7);
-    this.globalSlimmers = {};
-    this.submitEventEmitter = createEventEmitSlimmer(VegaForm, VegaFormSubmit);
-    this.resetEventEmitter = createEventEmitSlimmer(VegaForm, VegaFormReset);
-    this.validateEventEmitter = createEventEmitSlimmer(VegaForm, VegaValidate);
-    this.disableBlurValidationNotifySlimmer = createSubStateNotifySlimmer(VegaForm, 'disableBlurValidation', 'watchDisableBlurValidation');
-    this.stateController = new VegaFormNestStateController();
-    this.childEventPrevent = new ChildNodesEventPreventSlimmer([VegaFormSubmit, VegaFormReset], () => this.host.querySelector('vega-form'), {
-      customPreventHandle: (e) => {
-        e.stopPropagation();
-      },
-    });
-    this.childFormValidateEventPrevent = new ChildNodesEventPreventSlimmer([VegaValidate], () => this.host, {
-      customPreventHandle: (e) => {
-        e.stopPropagation();
-      },
-    });
+/**
+ * The form field controller for vega form to manage the form field states.
+ */
+class VegaFormFieldController extends VegaSlimmer {
+  constructor() {
+    super(...arguments);
     this.childNotifyObserver = new ChildNodesNotifyObserverSlimmer(FORM_ELEMENT_VALIDATE, (input) => this.updateInternalValidStatus(input));
-    this.childNodeValueChangeObserver = new ChildNodesNotifyObserverSlimmer(FORM_ELEMENT_VALUE_CHANGE, () => this.updateInternalTouchedStatus());
-    this.vegaComponentUsageRuntimeMetricsSlimmer = new VegaComponentUsageRuntimeMetricsSlimmer();
-    this.vegaFormFieldValidationStateController = new VegaFormFieldValidationStateController();
-    this.nativeFormRenderer = new NativeFormRenderer();
-    this.invalidFieldPathMap = new ImmutableMap(new Map(), (newMap) => {
-      this.invalidFieldPathMap = newMap;
-      this.updateIsValidFlag();
+    this.childNodeValueChangeObserver = new ChildNodesNotifyObserverSlimmer(FORM_ELEMENT_VALUE_CHANGE, () => {
+      this.isTouched = true;
     });
-    // The form field element pending async valid map
-    this.pendingValidFieldPathMap = new ImmutableMap(new Map(), (newMap) => {
-      this.pendingValidFieldPathMap = newMap;
+    this._invalidFieldPathMap = new ImmutableMap(new Map(), (newMap) => {
+      this._invalidFieldPathMap = newMap;
       this.updateIsValidFlag();
     });
-    this.controlledFieldPathSet = new Set();
-    /**
-     * Indicates whether the current form-controlled elements are valid.
-     *
-     * Form-controlled elements are considered for validation if they
-     *    have the `data-vega-form` property.
-     *
-     * Disabled and invisible elements are excluded from validation.
-     *
-     * If the value is `undefined`, it means there are no
-     *    form-controlled elements that can be validated.
-     *
-     * **Additional Notes:**
-     *   1. When depending on `isValid` for form validation, it is advised
-     *      not to modify the following properties of the monitored DOM:
-     *      - `disabled` property
-     *      - Element visibility style
-     *   2. As this property relies heavily on the `VegaValidate` event emitted,
-     *      it is highly recommended to enable auto-validation for all
-     *      form-controlled elements to ensure that the value reflects
-     *      the most up-to-date form validation status.
-     *
-     * @vegaVersion 1.3.0
-     */
-    /* eslint-disable-next-line @stencil/strict-mutable */
-    this.isValid = null;
-    /**
-     * Indicates whether the value of any current
-     *    form-controlled elements has been changed.
-     *
-     *   1. When the value of any form-controlled element is changed,
-     *      this parameter is set to `true`.
-     *   2. When resetting the form, this parameter is set to `false`.
-     *   3. When invoking the `setValue` method, this parameter is set to `false`.
-     *
-     * @vegaVersion 1.3.0
-     */
-    this.isTouched = false;
-    /**
-     * Specifies whether form validation should be disabled on blur events of form elements.
-     *
-     *  - This helps prevent validation on blur when clicking Submit inside an input,
-     *        avoiding error messages that shift the button and block the click.
-     *  - For nested forms, the parent form will override this property
-     *        to ensure consistent validation behavior.
-     *
-     * @vegaVersion 2.47.0
-     */
-    /* eslint-disable-next-line @stencil/strict-mutable */
-    this.disableBlurValidation = false;
-    /**
-     * Determines whether the `vega-form` content is wrapped in a native HTML <form> element.
-     *
-     * @vegaVersion 2.64.0
-     */
-    this.useNativeForm = false;
     /**
-     * Specifies the HTTP method used for form submission.
-     *   This property takes effect only when {@link useNativeForm} is set to `true`.
-     *
-     * @vegaVersion 2.64.0
+     * The form field element pending async valid map
      */
-    this.method = 'get';
+    this._pendingValidFieldPathMap = new ImmutableMap(new Map(), (newMap) => {
+      this._pendingValidFieldPathMap = newMap;
+      this.updateIsValidFlag();
+    });
     /**
      * If the element is valid, remove it from the set of
      *    invalid elements. If the element is invalid,
@@ -307,99 +337,39 @@ const VegaForm = class {
       }
     };
   }
-  watchIsValid() {
-    this.validateEventEmitter.emit(this.isValid);
-    ChangeManager.notify(FORM_ELEMENT_VALIDATE, { host: this.host, detail: this.isValid });
-  }
-  watchDisableBlurValidation() {
+  /**
+   * Component lifecycle - [connectedCallback]
+   */
+  connectedCallback() {
+    this.initFormFieldDisconnectedObserver();
+    this.registerFormFieldPendingValid();
   }
   /**
-   * When the vegaForm is deleted, it is necessary to notify
-   *    the parent's vegaForm to update its isValid status.
+   * When the vegaForm is deleted, it is necessary to notify the parent's vegaForm to update its isValid status.
    */
-  async disconnectedCallback() {
-    ChangeManager.notify(FORM_FIELD_ELEMENT_DISCONNECTED, {
-      host: this.host,
-    });
+  disconnectedCallback() {
+    ChangeManager.notify(FORM_FIELD_ELEMENT_DISCONNECTED, { host: this.host });
     ChangeManager.unregister(FORM_FIELD_ELEMENT_DISCONNECTED, this.formFieldDisconnectedObserver);
     ChangeManager.unregister(FORM_FIELD_PENDING_VALID_CHANGE, this.formFieldPendingValidObserver);
   }
-  async componentDidLoad() {
-    await this.navigateVegaFormChildren(async (element, isForm) => {
-      if (!isForm) {
-        this.controlledFieldPathSet.add(this.getFormFieldName(element, true));
-      }
-    });
-    this.initFormFieldDisconnectedObserver();
-    this.registerFormSubmitChangeManager();
-    this.registerFormResetChangeManager();
-    this.registerFormFieldPendingValidChangeManager();
-  }
   /**
-   * Invoke this method asynchronously to retrieve the validation result for
-   *    all the vega field elements nested within the `vega-form`.
-   *
-   * If an element is a `vega-form` itself, it will recursively
-   *    invoke its `valid()` method.
-   *
-   * @param {boolean | 'rule'} showError determine whether the validation result should be reflected in UI
-   * @return {Promise<FormValidateResult> } validation result
-   * @vegaVersion 1.3.0
+   * @inheritDoc
    */
-  async valid(showError = true) {
-    const result = { isValid: true, invalidFields: [] };
+  async getValue(option) {
+    const result = {};
     await this.navigateVegaFormChildren(async (element, isForm) => {
-      if (typeof element['valid'] === 'function' && isForm) {
-        const nestedFormValidationResult = await element.valid(showError);
-        if (!nestedFormValidationResult.isValid) {
-          result.isValid = false;
-          result.invalidFields.push(...nestedFormValidationResult.invalidFields);
-          result.invalidFieldsErrorMessages = Object.assign(Object.assign({}, result.invalidFieldsErrorMessages), nestedFormValidationResult.invalidFieldsErrorMessages);
-        }
+      const formFieldName = this.getFormFieldName(element);
+      if (isForm) {
+        result[formFieldName] = await element.getValue(option);
       }
       else {
-        const { isValid, message } = await this.handleChildFormFieldElementValid(element, showError);
-        if (!isValid) {
-          result.isValid = false;
-          result.invalidFields.push(this.getFormFieldName(element));
-          if (!result.invalidFieldsErrorMessages) {
-            result.invalidFieldsErrorMessages = {};
-          }
-          result.invalidFieldsErrorMessages[this.getFormFieldName(element)] = message;
-        }
-      }
-    });
-    return result;
-  }
-  /**
-   * Invoke this method asynchronously to retrieve the values for
-   *    all the available vega field elements nested within the `vega-form`.
-   *
-   * @param {FormControlOption} [option] form control option to skip disabled/invisible components
-   * @return {Promise<T>} object with key and field value as key-value pair
-   * @vegaVersion 1.3.0
-   */
-  async getValue(option) {
-    const result = {};
-    await this.navigateVegaFormChildren(async (element, isForm) => {
-      const formFieldName = this.getFormFieldName(element);
-      if (isForm) {
-        result[formFieldName] = await element.getValue(option);
-      }
-      else {
-        result[formFieldName] = VegaForm.getFormFieldValue(element);
+        result[formFieldName] = this.getFormFieldValue(element);
       }
     }, option);
     return (isObjectArrayLike(result) ? Object.values(result) : result);
   }
   /**
-   * Invoke this method to prefill the `vega-form` with the given value.
-   *
-   * This action will also set the `isTouched` property to `false`.
-   *
-   * @param value to prefill into the vega-form
-   * @param {FormControlOption} [option] form control option to skip disabled/invisible components
-   * @vegaVersion 1.3.0
+   * @inheritDoc
    */
   async setValue(value, option) {
     if (value) {
@@ -422,53 +392,74 @@ const VegaForm = class {
     }
   }
   /**
-   * Invoke this method to reset the vega field elements in the form to
-   *    the default value provided, or an empty string if
-   *    no default value is found.
-   *
-   * @param defaultValueMap map of the vega form field name to default value
-   * @param {FormControlOption} [option] form control option to skip disabled/invisible components
-   *
-   * @vegaVersion 1.3.0
+   * @inheritDoc
    */
-  async reset(defaultValueMap = {}, option) {
+  async valid(showError = true) {
+    const result = { isValid: true, invalidFields: [] };
     await this.navigateVegaFormChildren(async (element, isForm) => {
-      const formFieldName = this.getFormFieldName(element);
-      if (isForm) {
-        await element.reset(defaultValueMap[formFieldName] || {}, option);
+      if (typeof element['valid'] === 'function' && isForm) {
+        const nestedFormValidationResult = await element.valid(showError);
+        if (!nestedFormValidationResult.isValid) {
+          result.isValid = false;
+          result.invalidFields.push(...nestedFormValidationResult.invalidFields);
+          result.invalidFieldsErrorMessages = Object.assign(Object.assign({}, result.invalidFieldsErrorMessages), nestedFormValidationResult.invalidFieldsErrorMessages);
+        }
+      }
+      else {
+        const { isValid, message } = await this.handleChildFormFieldElementValid(element, showError);
+        if (!isValid) {
+          result.isValid = false;
+          result.invalidFields.push(this.getFormFieldName(element));
+          if (!result.invalidFieldsErrorMessages) {
+            result.invalidFieldsErrorMessages = {};
+          }
+          result.invalidFieldsErrorMessages[this.getFormFieldName(element)] = message;
+        }
       }
-    }, option);
-    ChangeManager.notify(FORM_RESET_OPERATION_TRIGGERED, {
-      host: this.host,
-      defaultValueMap,
-      option,
     });
-    this.isTouched = false;
+    return result;
   }
   /**
-   * Invoke this method to set validation states on specific form fields.
+   * The getter for the {@link _invalidFieldPathMap}
    *
-   * @param {VegaFormFieldValidationState[]} states - An array of validation error objects.
+   * @returns {ImmutableMap<HTMLElement, string>} The map of invalid field elements and their paths
+   */
+  get invalidFieldPathMap() {
+    return this._invalidFieldPathMap;
+  }
+  /**
+   * The getter for the {@link _pendingValidFieldPathMap}
    *
-   * @vegaVersion 2.59.0
+   * @returns {ImmutableMap<HTMLElement, string>} The map of pending valid field elements and their paths
    */
-  async setValidationStates(states) {
+  get pendingValidFieldPathMap() {
+    return this._pendingValidFieldPathMap;
   }
-  static getFormFieldValue(element) {
-    return typeof element['value'] === 'undefined'
-      ? // use element.getAttribute since the value property is not available in unit testing
-        element.getAttribute('value')
-      : element['value'];
+  /**
+   * Set the isTouched property of the form.
+   *
+   * @param {boolean} isTouched - The new value for isTouched.
+   */
+  setIsTouched(isTouched) {
+    this.isTouched = isTouched;
   }
-  render() {
-    return sanitizeVegaComponent(h(Host, null, this.useNativeForm ? this.nativeFormRenderer.render() : h("slot", null)), this.host);
+  /**
+   * It returns the value of data-vega-form that the given element is associated with.
+   *
+   * @param {HTMLElement} element - The element that is being validated.
+   * @returns {string} The name of the field.
+   */
+  getFormFieldName(element) {
+    return element.dataset['vegaForm'];
   }
   /**
-   * If the value of any child elements have changed,
-   *    make 'isTouched' prop as false.
+   * Check if the given element is part of the current form.
+   *
+   * @param {HTMLElement} element - The element to check.
+   * @returns {boolean} True if the element is part of the current form, false otherwise.
    */
-  updateInternalTouchedStatus() {
-    this.isTouched = true;
+  isElementInCurrentForm(element) {
+    return this.invalidFieldPathMap.has(element) || isParent(element, this.host);
   }
   /**
    * Navigate the immediate child node under current vega form element with the following strategy
@@ -476,10 +467,10 @@ const VegaForm = class {
    *  - if a non-matched node found, it will call itself recursively and pass the node as the second parameter
    * Once the navigation is finished, it will wait for all the pending visitor/self-invocation promise finished before return
    *
-   * @param visitor async callback method that will be invoked if a matched vega field element found
+   * @param  {(element: HTMLElement, isForm: boolean) => Promise<void>} visitor async callback method that will be invoked if a matched vega field element found
    * @param {FormControlOption} [option] form control option to skip disabled/invisible components
-   * @param [startElementNode] element node that the navigation will be started from, default is the current host element
-   * @return {Promise<void>} return void wrapped with promise to notify the navigation is done
+   * @param {HTMLElement} [startElementNode=this.host] the element to start the navigation, default to current vega form host
+   * @returns {Promise<void>} return void wrapped with promise to notify the navigation is done
    */
   async navigateVegaFormChildren(visitor, option, startElementNode = this.host) {
     const promiseQueue = [];
@@ -496,53 +487,43 @@ const VegaForm = class {
     await Promise.all(promiseQueue);
   }
   /**
-   * Update the {@link isValid} property value based on the size of {@link invalidFieldPathSet}
+   * Update the {@link isValid} property value based on the size of {@link invalidFieldPathMap}
    * If the number of invalid elements is zero, then the form is valid.
    */
   updateIsValidFlag() {
     this.isValid = this.pendingValidFieldPathMap.size > 0 ? null : this.invalidFieldPathMap.size === 0;
   }
   /**
-   * It returns the value of data-vega-form that the given element is associated with, if child HTMLElements share the same data-vega-form property name
-   * in the same vega-form, then includePath has to be set to be true to get a complete path to avoid the confusion of isValid checking.
+   * Registers an observer with the ChangeManager that will be notified when a form field's pending validation state changes.
+   */
+  registerFormFieldPendingValid() {
+    this.formFieldPendingValidObserver = new Observer(this.canAcceptFormFieldPendingValid.bind(this), this.handleFieldPendingValid.bind(this));
+    ChangeManager.register(FORM_FIELD_PENDING_VALID_CHANGE, this.formFieldPendingValidObserver);
+  }
+  /**
+   * Can accept handler for FORM_FIELD_PENDING_VALID_CHANGE.
    *
-   * @param {HTMLElement} element - The element that is being validated.
-   * @param {boolean} [includePath] - If true, the field name will include the path to the field. For
-   * example, if the field is in a vega-form with the name "address", the field name will be "address ->
-   * street".
-   * @returns The name of the field.
-   */
-  getFormFieldName(element, includePath) {
-    let fieldName = element.dataset['vegaForm'];
-    if (includePath) {
-      let currentVegaForm = findParent(element, 'vega-form');
-      /**
-       * The below method is e2e-test covered in
-       * @see {module:nested-vega-form-isValid-should-be-as-expected-when-value-changed}
-       */
-      /* istanbul ignore next */
-      while (currentVegaForm && currentVegaForm !== this.host) {
-        fieldName = currentVegaForm.dataset['vegaForm'] + ' -> ' + fieldName;
-        currentVegaForm = findParent(currentVegaForm, 'vega-form');
-      }
-    }
-    return fieldName;
+   * @param {PendingValidPayload} payload - The payload containing the host element that triggered the pending valid change event.
+   * @returns {boolean} True if the host element is part of the current form, false otherwise.
+   */
+  canAcceptFormFieldPendingValid(payload) {
+    return this.isElementInCurrentForm(payload.host);
   }
   /**
-   * Return true if the HTMLElement has data-vega-form property and it's not disabled and not invisible if these two properties have to be checked.
+   * Handles the pending valid state change for a form field.
    *
-   * @param {HTMLElement} element - The HTMLElement to check.
-   * @param {boolean} skipDisabled - If true, then disabled form fields will be skipped.
-   * @param {boolean} skipInvisible - If true, only visible elements will be visited.
-   * @returns a boolean value.
+   * @param {PendingValidPayload} payload - The payload containing the host element and its pending valid state.
    */
-  shouldVisitElement(element, skipDisabled, skipInvisible) {
-    return (this.getFormFieldName(element) &&
-      (!skipDisabled || !element['disabled']) &&
-      (!skipInvisible || isElementVisible(element)));
+  handleFieldPendingValid(payload) {
+    if (typeof payload.detail === 'boolean') {
+      this.pendingValidFieldPathMap.delete(payload.host);
+    }
+    else {
+      this.pendingValidFieldPathMap.set(payload.host, payload.host.dataset['vegaForm']);
+    }
   }
   /**
-   * This function registers an observer with the ChangeManager that will be notified when a element
+   * This function registers an observer with the ChangeManager that will be notified when an element
    * delete operation is triggered
    */
   initFormFieldDisconnectedObserver() {
@@ -560,87 +541,45 @@ const VegaForm = class {
   }
   /**
    * Get the fieldName of the deleted element in the current vegaForm, delete it from the invalidFieldPathSet array, and update isValid at the same time.
+   *
+   * @param {DisconnectedElementOperationPayload} payload - the delete element and vegaForm array.
    */
   async updateInvalidFieldPath(payload) {
     this.invalidFieldPathMap.delete(payload.host);
     this.pendingValidFieldPathMap.delete(payload.host);
   }
-  registerFormSubmitChangeManager() {
-    this.formEventsObserver = new Observer(this.canAcceptFormSubmitEvent.bind(this), this.handleSubmitEvents.bind(this));
-    ChangeManager.register(FORM_SUBMIT, this.formEventsObserver);
-  }
   /**
-   * The below method is e2e-test covered in
-   * @see{module:vega-form-field-enter-to-submit-e2e}
+   * Return true if the HTMLElement has data-vega-form property, and it's not disabled and not invisible if these two properties have to be checked.
+   *
+   * @param {HTMLElement} element - The HTMLElement to check.
+   * @param {boolean} skipDisabled - If true, then disabled form fields will be skipped.
+   * @param {boolean} skipInvisible - If true, only visible elements will be visited.
+   * @returns {boolean} a boolean value.
    */
-  /* istanbul ignore next */
-  canAcceptFormSubmitEvent(payload) {
-    return this.isElementInCurrentForm(payload.host);
-  }
-  async handleSubmitEvents() {
-    const valid = await this.valid();
-    if (valid.isValid) {
-      const formValue = await this.getValue();
-      const submitEvent = this.submitEventEmitter.emit(formValue);
-      if (!submitEvent.defaultPrevented) {
-        await this.submitWithFormData();
-      }
-    }
+  shouldVisitElement(element, skipDisabled, skipInvisible) {
+    return (this.getFormFieldName(element) &&
+      (!skipDisabled || !element['disabled']) &&
+      (!skipInvisible || isElementVisible(element)));
   }
   /**
-   * Submits the form using native HTML form submission with all current field values.
-   *
-   * This method collects all form field values, creates hidden input elements for each field,
-   * appends them to a container inside the native form, and then triggers the native
-   * `requestSubmit()` method to submit the form.
-   *
-   * The method ensures that the form data is available in the native form for submission,
-   * which is useful when `useNativeForm` is enabled.
+   * It retrieves the value of a form field element.
    *
-   * @returns {Promise<void>} Resolves when the form submission process is complete.
+   * @param {HTMLElement} element - The form field element.
+   * @returns {unknown} The value of the form field element.
    */
-  async submitWithFormData() {
-    if (!this.useNativeForm)
-      return;
-    const data = await this.getValue();
-    for (const dataKey in data) {
-      const hiddenInput = tryGetDocument().createElement('input');
-      hiddenInput.type = 'hidden';
-      hiddenInput.name = dataKey;
-      hiddenInput.value = data[dataKey];
-      this.nativeFormRenderer.getNativeFormRef().append(hiddenInput);
-    }
-    this.nativeFormRenderer.getNativeFormRef().requestSubmit();
-  }
-  registerFormResetChangeManager() {
-    this.formEventsObserver = new Observer(this.canAcceptFormResetEvent.bind(this), this.handleResetEvents.bind(this));
-    ChangeManager.register(FORM_RESET, this.formEventsObserver);
-  }
-  canAcceptFormResetEvent(payload) {
-    return this.isElementInCurrentForm(payload.host);
-  }
-  async handleResetEvents() {
-    await this.reset();
-    this.resetEventEmitter.emit();
-  }
-  registerFormFieldPendingValidChangeManager() {
-    this.formFieldPendingValidObserver = new Observer(this.canAcceptFormFieldPendingValid.bind(this), this.handleFieldPendingValid.bind(this));
-    ChangeManager.register(FORM_FIELD_PENDING_VALID_CHANGE, this.formFieldPendingValidObserver);
-  }
-  canAcceptFormFieldPendingValid(payload) {
-    return this.isElementInCurrentForm(payload.host);
-  }
-  handleFieldPendingValid(payload) {
-    if (typeof payload.detail === 'boolean') {
-      this.pendingValidFieldPathMap.delete(payload.host);
-    }
-    else {
-      this.pendingValidFieldPathMap.set(payload.host, payload.host.dataset['vegaForm']);
-    }
-  }
-  isElementInCurrentForm(element) {
-    return this.invalidFieldPathMap.has(element) || isParent(element, this.host);
+  getFormFieldValue(element) {
+    return typeof element['value'] === 'undefined'
+      ? // use element.getAttribute since the value property is not available in unit testing
+        element.getAttribute('value')
+      : element['value'];
   }
+  /**
+   * It handles the validation of a child form field element.
+   *
+   * @param {HTMLElement} element - The form field element to validate.
+   * @param {boolean | 'rule'} showError - Whether to show error messages.
+   * @returns {Promise<EvaluateResultBase>} The validation result.
+   */
   async handleChildFormFieldElementValid(element, showError) {
     const subject = domNodeSubjectFactory.getSubject(element, VegaInternalValid);
     const { isValid, message } = await new Promise((resolve) => {
@@ -657,6 +596,303 @@ const VegaForm = class {
     });
     return { isValid, message };
   }
+}
+__decorate$2([
+  MapToComponentField()
+], VegaFormFieldController.prototype, "host", void 0);
+__decorate$2([
+  MapToComponentField({ writable: true })
+], VegaFormFieldController.prototype, "isValid", void 0);
+__decorate$2([
+  MapToComponentField({ writable: true })
+], VegaFormFieldController.prototype, "isTouched", void 0);
+__decorate$2([
+  InjectVegaSlimmer()
+], VegaFormFieldController.prototype, "childNotifyObserver", void 0);
+__decorate$2([
+  InjectVegaSlimmer()
+], VegaFormFieldController.prototype, "childNodeValueChangeObserver", void 0);
+__decorate$2([
+  MapToComponentMethod('connectedCallback')
+], VegaFormFieldController.prototype, "connectedCallback", null);
+__decorate$2([
+  MapToComponentMethod('disconnectedCallback')
+], VegaFormFieldController.prototype, "disconnectedCallback", null);
+__decorate$2([
+  MapToComponentMethod('getValue')
+], VegaFormFieldController.prototype, "getValue", null);
+__decorate$2([
+  MapToComponentMethod('setValue')
+], VegaFormFieldController.prototype, "setValue", null);
+__decorate$2([
+  MapToComponentMethod('valid')
+], VegaFormFieldController.prototype, "valid", null);
+
+var __decorate$1 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * Reset controller for handling form reset events in the VegaForm component.
+ */
+class VegaFormResetController extends VegaSlimmer {
+  /**
+   * Component lifecycle - [connectedCallback]
+   */
+  connectedCallback() {
+    this.registerFormResetChangeManager();
+  }
+  /**
+   * Component lifecycle - [disconnectedCallback]
+   */
+  disconnectedCallback() {
+    this.unregisterFormResetChangeManager();
+  }
+  /**
+   * @inheritDoc
+   */
+  async reset(defaultValueMap = {}, option) {
+    await this.vegaFormFieldController.navigateVegaFormChildren(async (element, isForm) => {
+      const formFieldName = this.vegaFormFieldController.getFormFieldName(element);
+      if (isForm) {
+        await element.reset(defaultValueMap[formFieldName] || {}, option);
+      }
+    }, option);
+    ChangeManager.notify(FORM_RESET_OPERATION_TRIGGERED, {
+      host: this.host,
+      defaultValueMap,
+      option,
+    });
+    this.vegaFormFieldController.setIsTouched(false);
+  }
+  /**
+   * Registers the form reset event observer with the ChangeManager.
+   */
+  registerFormResetChangeManager() {
+    var _a;
+    const outerForm = (_a = findParent(this.host, 'vega-form', { outerMost: true })) !== null && _a !== void 0 ? _a : this.host;
+    this.formResetEventObserver = new Observer(this.canAcceptFormResetEvent.bind(this), this.handleResetEvents.bind(this));
+    ChangeManager.register(domNodeSubjectFactory.getSubject(outerForm, VegaInternalFormReset), this.formResetEventObserver);
+  }
+  /**
+   * Unregister the form reset event observer from the ChangeManager.
+   */
+  unregisterFormResetChangeManager() {
+    var _a;
+    const outerForm = (_a = findParent(this.host, 'vega-form', { outerMost: true })) !== null && _a !== void 0 ? _a : this.host;
+    ChangeManager.unregister(domNodeSubjectFactory.getSubject(outerForm, VegaInternalFormReset), this.formResetEventObserver);
+  }
+  /**
+   * Can accept form reset event.
+   *
+   * @param {FormEventsPayload} payload - The form events payload.
+   * @returns {boolean} True if the event can be accepted, false otherwise.
+   */
+  canAcceptFormResetEvent(payload) {
+    return this.vegaFormFieldController.isElementInCurrentForm(payload.host);
+  }
+  /**
+   * Handles reset events by resetting the form and emitting a reset event.
+   */
+  async handleResetEvents() {
+    await this.host.reset();
+    this.resetEventEmitter.emit();
+  }
+}
+__decorate$1([
+  MapToComponentField()
+], VegaFormResetController.prototype, "host", void 0);
+__decorate$1([
+  MapToComponentField()
+], VegaFormResetController.prototype, "vegaFormFieldController", void 0);
+__decorate$1([
+  MapToComponentField()
+], VegaFormResetController.prototype, "resetEventEmitter", void 0);
+__decorate$1([
+  MapToComponentMethod('connectedCallback')
+], VegaFormResetController.prototype, "connectedCallback", null);
+__decorate$1([
+  MapToComponentMethod('disconnectedCallback')
+], VegaFormResetController.prototype, "disconnectedCallback", null);
+__decorate$1([
+  MapToComponentMethod('reset')
+], VegaFormResetController.prototype, "reset", null);
+
+const vegaFormCss = ":host{display:block}";
+
+var __decorate = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+    r = Reflect.decorate(decorators, target, key, desc);
+  else
+    for (var i = decorators.length - 1; i >= 0; i--)
+      if (d = decorators[i])
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+const VegaForm = class {
+  constructor(hostRef) {
+    registerInstance(this, hostRef);
+    this.vegaValidate = createEvent(this, "vegaValidate", 7);
+    this.validate = createEvent(this, "validate", 7);
+    this.vegaFormSubmit = createEvent(this, "vegaFormSubmit", 7);
+    this.formSubmit = createEvent(this, "formSubmit", 7);
+    this.vegaFormReset = createEvent(this, "vegaFormReset", 7);
+    this.formReset = createEvent(this, "formReset", 7);
+    this.globalSlimmers = {};
+    this.submitEventEmitter = createEventEmitSlimmer(VegaForm, VegaFormSubmit);
+    this.resetEventEmitter = createEventEmitSlimmer(VegaForm, VegaFormReset);
+    this.validateEventEmitter = createEventEmitSlimmer(VegaForm, VegaValidate);
+    this.disableBlurValidationNotifySlimmer = createSubStateNotifySlimmer(VegaForm, 'disableBlurValidation', 'watchDisableBlurValidation');
+    this.stateController = new VegaFormNestStateController();
+    this.childEventPrevent = new ChildNodesEventPreventSlimmer([VegaFormSubmit, VegaFormReset], () => this.host.querySelector('vega-form'), {
+      customPreventHandle: (e) => {
+        e.stopPropagation();
+      },
+    });
+    this.childFormValidateEventPrevent = new ChildNodesEventPreventSlimmer([VegaValidate], () => this.host, {
+      customPreventHandle: (e) => {
+        e.stopPropagation();
+      },
+    });
+    this.vegaComponentUsageRuntimeMetricsSlimmer = new VegaComponentUsageRuntimeMetricsSlimmer();
+    this.vegaFormFieldValidationStateController = new VegaFormFieldValidationStateController();
+    this.nativeFormRenderer = new NativeFormRenderer();
+    this.vegaFormSubmitController = new VegaFormSubmitController();
+    this.vegaFormResetController = new VegaFormResetController();
+    this.vegaFormFieldController = new VegaFormFieldController();
+    /**
+     * Indicates whether the current form-controlled elements are valid.
+     *
+     * Form-controlled elements are considered for validation if they
+     *    have the `data-vega-form` property.
+     *
+     * Disabled and invisible elements are excluded from validation.
+     *
+     * If the value is `undefined`, it means there are no
+     *    form-controlled elements that can be validated.
+     *
+     * **Additional Notes:**
+     *   1. When depending on `isValid` for form validation, it is advised
+     *      not to modify the following properties of the monitored DOM:
+     *      - `disabled` property
+     *      - Element visibility style
+     *   2. As this property relies heavily on the `VegaValidate` event emitted,
+     *      it is highly recommended to enable auto-validation for all
+     *      form-controlled elements to ensure that the value reflects
+     *      the most up-to-date form validation status.
+     *
+     * @vegaVersion 1.3.0
+     */
+    /* eslint-disable-next-line @stencil/strict-mutable */
+    this.isValid = null;
+    /**
+     * Indicates whether the value of any current
+     *    form-controlled elements has been changed.
+     *
+     *   1. When the value of any form-controlled element is changed,
+     *      this parameter is set to `true`.
+     *   2. When resetting the form, this parameter is set to `false`.
+     *   3. When invoking the `setValue` method, this parameter is set to `false`.
+     *
+     * @vegaVersion 1.3.0
+     */
+    /* eslint-disable-next-line @stencil/strict-mutable */
+    this.isTouched = false;
+    /**
+     * Specifies whether form validation should be disabled on blur events of form elements.
+     *
+     *  - This helps prevent validation on blur when clicking Submit inside an input,
+     *        avoiding error messages that shift the button and block the click.
+     *  - For nested forms, the parent form will override this property
+     *        to ensure consistent validation behavior.
+     *
+     * @vegaVersion 2.47.0
+     */
+    /* eslint-disable-next-line @stencil/strict-mutable */
+    this.disableBlurValidation = false;
+    /**
+     * Determines whether the `vega-form` content is wrapped in a native HTML <form> element.
+     *
+     * @vegaVersion 2.64.0
+     */
+    this.useNativeForm = false;
+    /**
+     * Specifies the HTTP method used for form submission.
+     *   This property takes effect only when {@link useNativeForm} is set to `true`.
+     *
+     * @vegaVersion 2.64.0
+     */
+    this.method = 'get';
+  }
+  watchIsValid() {
+    this.validateEventEmitter.emit(this.isValid);
+    ChangeManager.notify(FORM_ELEMENT_VALIDATE, { host: this.host, detail: this.isValid });
+  }
+  watchDisableBlurValidation() {
+  }
+  /**
+   * Invoke this method asynchronously to retrieve the validation result for
+   *    all the vega field elements nested within the `vega-form`.
+   *
+   * If an element is a `vega-form` itself, it will recursively
+   *    invoke its `valid()` method.
+   *
+   * @param {boolean | 'rule'} showError determine whether the validation result should be reflected in UI
+   * @return {Promise<FormValidateResult> } validation result
+   * @vegaVersion 1.3.0
+   */
+  async valid(showError = true) {
+    return methodPlaceholder(showError);
+  }
+  /**
+   * Invoke this method asynchronously to retrieve the values for
+   *    all the available vega field elements nested within the `vega-form`.
+   *
+   * @param {FormControlOption} [option] form control option to skip disabled/invisible components
+   * @return {Promise<T>} object with key and field value as key-value pair
+   * @vegaVersion 1.3.0
+   */
+  async getValue(option) {
+    return methodPlaceholder(option);
+  }
+  /**
+   * Invoke this method to prefill the `vega-form` with the given value.
+   *
+   * This action will also set the `isTouched` property to `false`.
+   *
+   * @param value to prefill into the vega-form
+   * @param {FormControlOption} [option] form control option to skip disabled/invisible components
+   * @vegaVersion 1.3.0
+   */
+  async setValue(value, option) {
+  }
+  /**
+   * Invoke this method to reset the vega field elements in the form to
+   *    the default value provided, or an empty string if
+   *    no default value is found.
+   *
+   * @param defaultValueMap map of the vega form field name to default value
+   * @param {FormControlOption} [option] form control option to skip disabled/invisible components
+   *
+   * @vegaVersion 1.3.0
+   */
+  async reset(defaultValueMap = {}, option) {
+  }
+  /**
+   * Invoke this method to set validation states on specific form fields.
+   *
+   * @param {VegaFormFieldValidationState[]} states - An array of validation error objects.
+   *
+   * @vegaVersion 2.59.0
+   */
+  async setValidationStates(states) {
+  }
+  render() {
+    return sanitizeVegaComponent(h(Host, null, this.useNativeForm ? this.nativeFormRenderer.render() : h("slot", null)), this.host);
+  }
   get host() { return getElement(this); }
   static get watchers() { return {
     "isValid": ["watchIsValid"],
@@ -689,19 +925,22 @@ __decorate([
 ], VegaForm.prototype, "childFormValidateEventPrevent", void 0);
 __decorate([
   InjectVegaSlimmer()
-], VegaForm.prototype, "childNotifyObserver", void 0);
+], VegaForm.prototype, "vegaComponentUsageRuntimeMetricsSlimmer", void 0);
 __decorate([
   InjectVegaSlimmer()
-], VegaForm.prototype, "childNodeValueChangeObserver", void 0);
+], VegaForm.prototype, "vegaFormFieldValidationStateController", void 0);
 __decorate([
   InjectVegaSlimmer()
-], VegaForm.prototype, "vegaComponentUsageRuntimeMetricsSlimmer", void 0);
+], VegaForm.prototype, "nativeFormRenderer", void 0);
 __decorate([
   InjectVegaSlimmer()
-], VegaForm.prototype, "vegaFormFieldValidationStateController", void 0);
+], VegaForm.prototype, "vegaFormSubmitController", void 0);
 __decorate([
   InjectVegaSlimmer()
-], VegaForm.prototype, "nativeFormRenderer", void 0);
+], VegaForm.prototype, "vegaFormResetController", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaForm.prototype, "vegaFormFieldController", void 0);
 VegaForm.style = vegaFormCss;
 
 export { VegaForm as vega_form };