@abgov/react-components 6.6.1 → 6.7.0-alpha.2

package/index.d.ts

@@ -60,7 +60,6 @@ export * from './lib/table/table';
 export * from './lib/table/table-sort-header';
 export * from './lib/tabs/tabs';
 export * from './lib/tab/tab';
-export * from './lib/temporary-notification/temporary-notification';
 export * from './lib/temporary-notification-ctrl/temporary-notification-ctrl';
 export * from './lib/text/text';
 export { GoabTextArea, GoabTextArea as GoabTextarea } from './lib/textarea/textarea';

package/index.js

@@ -3663,32 +3663,6 @@ function GoabTab({ heading, children }) {
     children
   ] });
 }
-const GoabTemporaryNotification = ({
-  message: message2 = "",
-  type = "basic",
-  duration,
-  progress,
-  testId,
-  actionText,
-  visible = true,
-  animationDirection = "down"
-}) => {
-  const el = react.useRef(null);
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    "goa-temp-notification",
-    {
-      ref: el,
-      message: message2,
-      type,
-      duration,
-      progress,
-      testid: testId,
-      "action-text": actionText,
-      visible,
-      "animation-direction": animationDirection
-    }
-  );
-};
 const GoabTemporaryNotificationCtrl = ({
   verticalPosition = "bottom",
   horizontalPosition = "center",
@@ -3886,6 +3860,19 @@ const GoabFilterChip = ({
     }
   );
 };
+function dispatch(el, eventName, detail, opts) {
+  if (!el) {
+    console.error("dispatch element is null");
+    return;
+  }
+  el.dispatchEvent(
+    new CustomEvent(eventName, {
+      composed: true,
+      bubbles: opts == null ? void 0 : opts.bubbles,
+      detail
+    })
+  );
+}
 function relay(el, eventName, data, opts) {
   if (!el) {
     console.error("dispatch element is null");
@@ -3908,6 +3895,7 @@ class PublicFormController {
     __publicField(this, "state");
     __publicField(this, "_formData");
     __publicField(this, "_formRef");
+    __publicField(this, "_isCompleting", false);
     this.type = type;
   }
   // Obtain reference to the form element
@@ -4091,6 +4079,70 @@ class PublicFormController {
       operation: "remove"
     });
   }
+  /**
+   * Completes the form and triggers the onComplete callback.
+   * This method should be used when you want to complete a form without navigating to a summary page.
+   *
+   * @important Developers must validate the form before calling this method.
+   *
+   * @example
+   * // Validate first, then complete
+   * const [isValid] = this.validate(e, "firstName", [
+   *   requiredValidator("First name is required.")
+   * ]);
+   * if (isValid) {
+   *   this.complete();
+   * }
+   * @returns void
+   */
+  complete() {
+    if (!this._formRef) {
+      console.error("complete: form ref is not set");
+      return;
+    }
+    if (this._isCompleting) {
+      console.warn("complete: completion already in progress");
+      return;
+    }
+    this._isCompleting = true;
+    relay(this._formRef, "fieldset::submit", null, { bubbles: true });
+    this._isCompleting = false;
+  }
+  /**
+   * Completes a subform and returns control to the parent form.
+   * This method should be used when working with subforms that need to complete without a summary page.
+   *
+   * @important Developers must validate the subform before calling this method.
+   *
+   * @example
+   * // Validate first, then complete the subform
+   * const [isValid] = this._childFormController.validate(e, "fullName", [
+   *   requiredValidator("Please enter the dependent's full name.")
+   * ]);
+   * if (isValid) {
+   *   this._childFormController.completeSubform();
+   * }
+   * @returns void
+   */
+  completeSubform() {
+    if (!this._formRef) {
+      console.error("completeSubform: form ref is not set");
+      return;
+    }
+    if (this._isCompleting) {
+      console.warn("completeSubform: completion already in progress");
+      return;
+    }
+    const formRef = this._formRef;
+    this._isCompleting = true;
+    const stateChangeHandler = (e) => {
+      formRef.removeEventListener("_stateChange", stateChangeHandler);
+      dispatch(formRef, "_complete", {}, { bubbles: true });
+      this._isCompleting = false;
+    };
+    formRef.addEventListener("_stateChange", stateChangeHandler);
+    dispatch(formRef, "_continue", null, { bubbles: true });
+  }
   // removes any data collected that doesn't correspond with the final history path
   clean(data) {
     return data.history.reduce((acc, fieldsetId) => {
@@ -4194,6 +4246,12 @@ function usePublicFormController(type = "details") {
   const getStateList = react.useCallback(() => {
     return controllerRef.current.getStateList();
   }, []);
+  const complete = react.useCallback(() => {
+    controllerRef.current.complete();
+  }, []);
+  const completeSubform = react.useCallback(() => {
+    controllerRef.current.completeSubform();
+  }, []);
   return {
     state,
     init,
@@ -4203,6 +4261,8 @@ function usePublicFormController(type = "details") {
     validate,
     getStateValue,
     getStateList,
+    complete,
+    completeSubform,
     controller: controllerRef.current
   };
 }
@@ -4288,7 +4348,6 @@ exports.GoabTab = GoabTab;
 exports.GoabTable = GoabTable;
 exports.GoabTableSortHeader = GoabTableSortHeader;
 exports.GoabTabs = GoabTabs;
-exports.GoabTemporaryNotification = GoabTemporaryNotification;
 exports.GoabTemporaryNotificationCtrl = GoabTemporaryNotificationCtrl;
 exports.GoabText = GoabText;
 exports.GoabTextArea = GoabTextArea;