@abgov/ui-components-common 1.6.0 → 1.7.0-alpha.1

package/index.cjs

@@ -1 +1 @@
-"use strict";var M=Object.defineProperty;var y=r=>{throw TypeError(r)};var S=(r,t,e)=>t in r?M(r,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[t]=e;var d=(r,t,e)=>S(r,typeof t!="symbol"?t+"":t,e),N=(r,t,e)=>t.has(r)||y("Cannot "+e);var g=(r,t,e)=>t.has(r)?y("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(r):t.set(r,e);var V=(r,t,e)=>(N(r,t,"access private method"),e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class w{constructor(t){d(this,"validators");this.validators=t||{}}add(t,...e){this.validators[t]=e}validate(t){const e={};return Object.entries(this.validators).forEach(([a,i])=>{const n=i.map(s=>s(t[a])).find(s=>!!s);n&&(e[a]=n)}),e}}function D(){return[c("Day is required"),m({min:1,max:31,minMsg:"Day must be between 1 and 31",maxMsg:"Day must be between 1 and 31"})]}function E(){return[c("Month is required"),m({min:0,max:11,minMsg:"Month must be between Jan and Dec",maxMsg:"Month must be between Jan and Dec"})]}function _(){const r=new Date().getFullYear();return[c("Year is required"),m({min:1900,max:r,minMsg:"Year must be greater than 1900",maxMsg:`Year must be less than ${r}`})]}function c(r){return t=>(r=r||"Required",typeof t=="number"&&!isNaN(t)||t?"":r)}function R(r){const t=new RegExp(/^\+?[\d-() ]{10,18}$/);return h(t,r||"Invalid phone number")}function I(r){const t=new RegExp(/^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/);return h(t,r||"Invalid email address")}function $(){return r=>{if(!r)return"";const t="121212121".split("").map(i=>parseInt(i)),e=r.replace(/\D/g,"");return e.length!==9?"SIN must contain 9 numbers":e.split("").map(i=>parseInt(i)).map((i,n)=>{const s=i*t[n];return s<10?s:`${s}`.split("").map(u=>parseInt(u)).reduce((u,l)=>u+l,0)}).reduce((i,n)=>i+n,0)%10===0?"":"Invalid SIN"}}function x(){return h(/^[ABCEGHJ-NPRSTVXY]\d[ABCEGHJ-NPRSTV-Z][ -]?\d[ABCEGHJ-NPRSTV-Z]\d$/i,"Invalid postal code")}function h(r,t){return e=>!e||e.match(r)?"":t}function C({invalidMsg:r,minMsg:t,maxMsg:e,min:a,max:i}={}){return n=>{let s=new Date(-1);return`${n||""}`.length===0?"":(typeof n=="string"&&(s=new Date(n)),typeof n=="number"&&(s=new Date(n)),n.toDateString&&(s=n),s.getDate()===-1?r||"Invalid date":a&&s<a?t||`Must be after ${a}`:i&&s>i?e||`Must be before ${i}`:"")}}function m({invalidTypeMsg:r,minMsg:t,maxMsg:e,min:a=-Number.MAX_VALUE,max:i=Number.MAX_VALUE}={}){return n=>{let s=Number.MAX_VALUE;return`${n??""}`.length===0?"":(typeof n=="string"&&(s=parseFloat(n)),typeof n=="number"&&(s=n),isNaN(s)?r||"Must be a numeric value":s>i?e||`Must be less than or equal to ${i}`:s<a?t||`Must be greater than or equal to ${a}`:"")}}function T({invalidTypeMsg:r,minMsg:t,maxMsg:e,min:a=-Number.MAX_VALUE,max:i=Number.MAX_VALUE}){return n=>`${n||""}`.length===0?"":typeof n!="string"?r||"Invalid type":n.length>i?e||`Must be less than ${i} characters`:n.length<a?t||`Must be greater than ${a} characters`:""}function L(r,t,e,a){if(!r){console.error("dispatch element is null");return}r.dispatchEvent(new CustomEvent(t,{composed:!0,bubbles:a==null?void 0:a.bubbles,detail:e}))}function o(r,t,e,a){if(!r){console.error("dispatch element is null");return}r.dispatchEvent(new CustomEvent("msg",{composed:!0,bubbles:a==null?void 0:a.bubbles,detail:{action:t,data:e}}))}var f,q,A;class U{constructor(t){g(this,f);d(this,"state");d(this,"_formData");d(this,"_formRef");this.type=t}init(t){if(this._formRef){console.warn("init: form element has already been set");return}this._formRef=t.detail.el,this.state={uuid:crypto.randomUUID(),form:{},history:[],editting:"",status:"not-started"}}initList(t){this._formRef=t.detail.el,this.state=[]}initState(t,e){o(this._formRef,"external::init:state",t),typeof t=="string"?this.state=JSON.parse(t):Array.isArray(t)||(this.state=t),e&&setTimeout(e,200)}updateListState(t){const e=t.detail;Array.isArray(e.data)&&(this.state=e.data)}updateObjectState(t){var a,i;if(Array.isArray(this.state))return;const e=t.detail;e.type==="list"?this.state={...this.state,form:{...((a=this.state)==null?void 0:a.form)||{},[e.id]:e.data}}:this.state={...this.state,...e.data,form:{...((i=this.state)==null?void 0:i.form)||{},...e.data.form},history:e.data.history}}getStateList(){return this.state?Array.isArray(this.state)?this.state.length===0?[]:this.state.map(t=>Object.values(t.form).filter(e=>{var a;return((a=e==null?void 0:e.data)==null?void 0:a.type)==="details"}).map(e=>{var a;return e.data.type==="details"&&((a=e.data)==null?void 0:a.fieldsets)||{}}).reduce((e,a)=>{for(const[i,n]of Object.entries(a))e[i]=n.value;return e},{})):(console.warn("Utils:getStateList: unable to update the state of a non-multi form type",this.state),[]):[]}getStateValue(t,e){if(Array.isArray(this.state))return console.error("getStateValue: unable to update the state of a multi form type"),"";if(!this.state)return console.error("getStateValue: state has not yet been set"),"";const a=this.state.form[t].data;return a.type!=="details"?"":a.fieldsets[e].value}continueTo(t){if(!t){console.error("continueTo [name] is undefined");return}o(this._formRef,"external::continue",{next:t})}validate(t,e,a,i){var b;const{el:n,state:s,cancelled:u}=t.detail,l=(b=s==null?void 0:s[e])==null?void 0:b.value;if(window.scrollTo({top:0,behavior:"smooth"}),u)return[!0,l];for(const v of a){const p=v(l);if(V(this,f,A).call(this,n,e,p,i),p)return[!1,""]}return[!0,l]}validateGroup(t,e,a){let i=0;const n={};for(const s of e){const[u]=this.validate(t,s,a,{grouped:!0});u&&(n[s]=!0,i++)}return[i,n]}edit(t){o(this._formRef,"external::alter:state",{index:t,operation:"edit"})}remove(t){o(this._formRef,"external::alter:state",{index:t,operation:"remove"})}clean(t){return t.history.reduce((e,a)=>(e[a]=t.form[a],e),{})}}f=new WeakSet,q=function(t){var e;Array.isArray(t.data)&&(Array.isArray(this.state)||(this.state={...this.state,form:{...((e=this.state)==null?void 0:e.form)||{},[t.id]:t.data}}))},A=function(t,e,a,i){t.dispatchEvent(new CustomEvent("msg",{composed:!0,detail:{action:"external::set:error",data:{name:e,msg:a,grouped:i==null?void 0:i.grouped}}}))};const Y=["basic","success","failure"];function O(r,t){const e=crypto.randomUUID();return t={uuid:e,type:"basic",...t||{}},!t.duration&&t.type&&Y.includes(t.type)&&(t.duration="short"),o(document.body,"goa:temp-notification",{message:r,...t},{bubbles:!0}),e}function P(r){o(document.body,"goa:temp-notification:dismiss",r,{bubbles:!0})}function j(r,t){o(document.body,"goa:temp-notification:progress",{uuid:r,progress:t},{bubbles:!0})}const F={show:O,dismiss:P,setProgress:j};exports.FormValidator=w;exports.PublicFormController=U;exports.SINValidator=$;exports.TemporaryNotification=F;exports.birthDayValidator=D;exports.birthMonthValidator=E;exports.birthYearValidator=_;exports.dateValidator=C;exports.dispatch=L;exports.emailValidator=I;exports.lengthValidator=T;exports.numericValidator=m;exports.phoneNumberValidator=R;exports.postalCodeValidator=x;exports.regexValidator=h;exports.relay=o;exports.requiredValidator=c;
+"use strict";var S=Object.defineProperty;var y=r=>{throw TypeError(r)};var M=(r,t,e)=>t in r?S(r,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):r[t]=e;var l=(r,t,e)=>M(r,typeof t!="symbol"?t+"":t,e),C=(r,t,e)=>t.has(r)||y("Cannot "+e);var V=(r,t,e)=>t.has(r)?y("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(r):t.set(r,e);var _=(r,t,e)=>(C(r,t,"access private method"),e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class N{constructor(t){l(this,"validators");this.validators=t||{}}add(t,...e){this.validators[t]=e}validate(t){const e={};return Object.entries(this.validators).forEach(([i,a])=>{const n=a.map(s=>s(t[i])).find(s=>!!s);n&&(e[i]=n)}),e}}function w(){return[c("Day is required"),h({min:1,max:31,minMsg:"Day must be between 1 and 31",maxMsg:"Day must be between 1 and 31"})]}function E(){return[c("Month is required"),h({min:0,max:11,minMsg:"Month must be between Jan and Dec",maxMsg:"Month must be between Jan and Dec"})]}function R(){const r=new Date().getFullYear();return[c("Year is required"),h({min:1900,max:r,minMsg:"Year must be greater than 1900",maxMsg:`Year must be less than ${r}`})]}function c(r){return t=>(r=r||"Required",typeof t=="number"&&!isNaN(t)||t?"":r)}function D(r){const t=new RegExp(/^\+?[\d-() ]{10,18}$/);return m(t,r||"Invalid phone number")}function I(r){const t=new RegExp(/^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/);return m(t,r||"Invalid email address")}function $(){return r=>{if(!r)return"";const t="121212121".split("").map(a=>parseInt(a)),e=r.replace(/\D/g,"");return e.length!==9?"SIN must contain 9 numbers":e.split("").map(a=>parseInt(a)).map((a,n)=>{const s=a*t[n];return s<10?s:`${s}`.split("").map(u=>parseInt(u)).reduce((u,f)=>u+f,0)}).reduce((a,n)=>a+n,0)%10===0?"":"Invalid SIN"}}function x(){return m(/^[ABCEGHJ-NPRSTVXY]\d[ABCEGHJ-NPRSTV-Z][ -]?\d[ABCEGHJ-NPRSTV-Z]\d$/i,"Invalid postal code")}function m(r,t){return e=>!e||e.match(r)?"":t}function L({invalidMsg:r,minMsg:t,maxMsg:e,min:i,max:a}={}){return n=>{let s=new Date(-1);return`${n||""}`.length===0?"":(typeof n=="string"&&(s=new Date(n)),typeof n=="number"&&(s=new Date(n)),n.toDateString&&(s=n),s.getDate()===-1?r||"Invalid date":i&&s<i?t||`Must be after ${i}`:a&&s>a?e||`Must be before ${a}`:"")}}function h({invalidTypeMsg:r,minMsg:t,maxMsg:e,min:i=-Number.MAX_VALUE,max:a=Number.MAX_VALUE}={}){return n=>{let s=Number.MAX_VALUE;return`${n??""}`.length===0?"":(typeof n=="string"&&(s=parseFloat(n)),typeof n=="number"&&(s=n),isNaN(s)?r||"Must be a numeric value":s>a?e||`Must be less than or equal to ${a}`:s<i?t||`Must be greater than or equal to ${i}`:"")}}function T({invalidTypeMsg:r,minMsg:t,maxMsg:e,min:i=-Number.MAX_VALUE,max:a=Number.MAX_VALUE}){return n=>`${n||""}`.length===0?"":typeof n!="string"?r||"Invalid type":n.length>a?e||`Must be less than ${a} characters`:n.length<i?t||`Must be greater than ${i} characters`:""}function b(r,t,e,i){if(!r){console.error("dispatch element is null");return}r.dispatchEvent(new CustomEvent(t,{composed:!0,bubbles:i==null?void 0:i.bubbles,detail:e}))}function o(r,t,e,i){if(!r){console.error("dispatch element is null");return}r.dispatchEvent(new CustomEvent("msg",{composed:!0,bubbles:i==null?void 0:i.bubbles,detail:{action:t,data:e}}))}var d,q,v;class U{constructor(t){V(this,d);l(this,"state");l(this,"_formData");l(this,"_formRef");l(this,"_isCompleting",!1);this.type=t}init(t){if(this._formRef){console.warn("init: form element has already been set");return}this._formRef=t.detail.el,this.state={uuid:crypto.randomUUID(),form:{},history:[],editting:"",status:"not-started"}}initList(t){this._formRef=t.detail.el,this.state=[]}initState(t,e){o(this._formRef,"external::init:state",t),typeof t=="string"?this.state=JSON.parse(t):Array.isArray(t)||(this.state=t),e&&setTimeout(e,200)}updateListState(t){const e=t.detail;Array.isArray(e.data)&&(this.state=e.data)}updateObjectState(t){var i,a;if(Array.isArray(this.state))return;const e=t.detail;e.type==="list"?this.state={...this.state,form:{...((i=this.state)==null?void 0:i.form)||{},[e.id]:e.data}}:this.state={...this.state,...e.data,form:{...((a=this.state)==null?void 0:a.form)||{},...e.data.form},history:e.data.history}}getStateList(){return this.state?Array.isArray(this.state)?this.state.length===0?[]:this.state.map(t=>Object.values(t.form).filter(e=>{var i;return((i=e==null?void 0:e.data)==null?void 0:i.type)==="details"}).map(e=>{var i;return e.data.type==="details"&&((i=e.data)==null?void 0:i.fieldsets)||{}}).reduce((e,i)=>{for(const[a,n]of Object.entries(i))e[a]=n.value;return e},{})):(console.warn("Utils:getStateList: unable to update the state of a non-multi form type",this.state),[]):[]}getStateValue(t,e){if(Array.isArray(this.state))return console.error("getStateValue: unable to update the state of a multi form type"),"";if(!this.state)return console.error("getStateValue: state has not yet been set"),"";const i=this.state.form[t].data;return i.type!=="details"?"":i.fieldsets[e].value}continueTo(t){if(!t){console.error("continueTo [name] is undefined");return}o(this._formRef,"external::continue",{next:t})}validate(t,e,i,a){var p;const{el:n,state:s,cancelled:u}=t.detail,f=(p=s==null?void 0:s[e])==null?void 0:p.value;if(window.scrollTo({top:0,behavior:"smooth"}),u)return[!0,f];for(const A of i){const g=A(f);if(_(this,d,v).call(this,n,e,g,a),g)return[!1,""]}return[!0,f]}validateGroup(t,e,i){let a=0;const n={};for(const s of e){const[u]=this.validate(t,s,i,{grouped:!0});u&&(n[s]=!0,a++)}return[a,n]}edit(t){o(this._formRef,"external::alter:state",{index:t,operation:"edit"})}remove(t){o(this._formRef,"external::alter:state",{index:t,operation:"remove"})}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=!0,o(this._formRef,"fieldset::submit",null,{bubbles:!0}),this._isCompleting=!1}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 t=this._formRef;this._isCompleting=!0;const e=i=>{t.removeEventListener("_stateChange",e),b(t,"_complete",{},{bubbles:!0}),this._isCompleting=!1};t.addEventListener("_stateChange",e),b(t,"_continue",null,{bubbles:!0})}clean(t){return t.history.reduce((e,i)=>(e[i]=t.form[i],e),{})}}d=new WeakSet,q=function(t){var e;Array.isArray(t.data)&&(Array.isArray(this.state)||(this.state={...this.state,form:{...((e=this.state)==null?void 0:e.form)||{},[t.id]:t.data}}))},v=function(t,e,i,a){t.dispatchEvent(new CustomEvent("msg",{composed:!0,detail:{action:"external::set:error",data:{name:e,msg:i,grouped:a==null?void 0:a.grouped}}}))};const Y=["basic","success","failure"];function O(r,t){const e=crypto.randomUUID();return t={uuid:e,type:"basic",...t||{}},!t.duration&&t.type&&Y.includes(t.type)&&(t.duration="short"),o(document.body,"goa:temp-notification",{message:r,...t},{bubbles:!0}),e}function P(r){o(document.body,"goa:temp-notification:dismiss",r,{bubbles:!0})}function j(r,t){o(document.body,"goa:temp-notification:progress",{uuid:r,progress:t},{bubbles:!0})}const F={show:O,dismiss:P,setProgress:j};exports.FormValidator=N;exports.PublicFormController=U;exports.SINValidator=$;exports.TemporaryNotification=F;exports.birthDayValidator=w;exports.birthMonthValidator=E;exports.birthYearValidator=R;exports.dateValidator=L;exports.dispatch=b;exports.emailValidator=I;exports.lengthValidator=T;exports.numericValidator=h;exports.phoneNumberValidator=D;exports.postalCodeValidator=x;exports.regexValidator=m;exports.relay=o;exports.requiredValidator=c;

package/index.js

@@ -1,11 +1,11 @@
-var M = Object.defineProperty;
-var y = (r) => {
+var S = Object.defineProperty;
+var g = (r) => {
   throw TypeError(r);
 };
-var S = (r, t, e) => t in r ? M(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
-var l = (r, t, e) => S(r, typeof t != "symbol" ? t + "" : t, e), w = (r, t, e) => t.has(r) || y("Cannot " + e);
-var g = (r, t, e) => t.has(r) ? y("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(r) : t.set(r, e);
-var A = (r, t, e) => (w(r, t, "access private method"), e);
+var M = (r, t, e) => t in r ? S(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
+var l = (r, t, e) => M(r, typeof t != "symbol" ? t + "" : t, e), w = (r, t, e) => t.has(r) || g("Cannot " + e);
+var y = (r, t, e) => t.has(r) ? g("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(r) : t.set(r, e);
+var _ = (r, t, e) => (w(r, t, "access private method"), e);
 class x {
   constructor(t) {
     l(this, "validators");
@@ -16,16 +16,16 @@ class x {
   }
   validate(t) {
     const e = {};
-    return Object.entries(this.validators).forEach(([a, n]) => {
-      const i = n.map((s) => s(t[a])).find((s) => !!s);
-      i && (e[a] = i);
+    return Object.entries(this.validators).forEach(([n, i]) => {
+      const a = i.map((s) => s(t[n])).find((s) => !!s);
+      a && (e[n] = a);
     }), e;
   }
 }
 function I() {
   return [
     c("Day is required"),
-    m({
+    h({
       min: 1,
       max: 31,
       minMsg: "Day must be between 1 and 31",
@@ -36,7 +36,7 @@ function I() {
 function L() {
   return [
     c("Month is required"),
-    m({
+    h({
       min: 0,
       max: 11,
       minMsg: "Month must be between Jan and Dec",
@@ -48,7 +48,7 @@ function U() {
   const r = (/* @__PURE__ */ new Date()).getFullYear();
   return [
     c("Year is required"),
-    m({
+    h({
       min: 1900,
       max: r,
       minMsg: "Year must be greater than 1900",
@@ -59,69 +59,69 @@ function U() {
 function c(r) {
   return (t) => (r = r || "Required", typeof t == "number" && !isNaN(t) || t ? "" : r);
 }
-function C(r) {
+function T(r) {
   const t = new RegExp(/^\+?[\d-() ]{10,18}$/);
-  return h(t, r || "Invalid phone number");
+  return m(t, r || "Invalid phone number");
 }
-function T(r) {
+function q(r) {
   const t = new RegExp(
     /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/
   );
-  return h(t, r || "Invalid email address");
+  return m(t, r || "Invalid email address");
 }
-function q() {
+function Y() {
   return (r) => {
     if (!r) return "";
-    const t = "121212121".split("").map((n) => parseInt(n)), e = r.replace(/\D/g, "");
-    return e.length !== 9 ? "SIN must contain 9 numbers" : e.split("").map((n) => parseInt(n)).map((n, i) => {
-      const s = n * t[i];
-      return s < 10 ? s : `${s}`.split("").map((o) => parseInt(o)).reduce((o, f) => o + f, 0);
-    }).reduce((n, i) => n + i, 0) % 10 === 0 ? "" : "Invalid SIN";
+    const t = "121212121".split("").map((i) => parseInt(i)), e = r.replace(/\D/g, "");
+    return e.length !== 9 ? "SIN must contain 9 numbers" : e.split("").map((i) => parseInt(i)).map((i, a) => {
+      const s = i * t[a];
+      return s < 10 ? s : `${s}`.split("").map((u) => parseInt(u)).reduce((u, f) => u + f, 0);
+    }).reduce((i, a) => i + a, 0) % 10 === 0 ? "" : "Invalid SIN";
   };
 }
-function Y() {
-  return h(
+function J() {
+  return m(
     /^[ABCEGHJ-NPRSTVXY]\d[ABCEGHJ-NPRSTV-Z][ -]?\d[ABCEGHJ-NPRSTV-Z]\d$/i,
     "Invalid postal code"
   );
 }
-function h(r, t) {
+function m(r, t) {
   return (e) => !e || e.match(r) ? "" : t;
 }
-function J({
+function O({
   invalidMsg: r,
   minMsg: t,
   maxMsg: e,
-  min: a,
-  max: n
+  min: n,
+  max: i
 } = {}) {
-  return (i) => {
+  return (a) => {
     let s = /* @__PURE__ */ new Date(-1);
-    return `${i || ""}`.length === 0 ? "" : (typeof i == "string" && (s = new Date(i)), typeof i == "number" && (s = new Date(i)), i.toDateString && (s = i), s.getDate() === -1 ? r || "Invalid date" : a && s < a ? t || `Must be after ${a}` : n && s > n ? e || `Must be before ${n}` : "");
+    return `${a || ""}`.length === 0 ? "" : (typeof a == "string" && (s = new Date(a)), typeof a == "number" && (s = new Date(a)), a.toDateString && (s = a), s.getDate() === -1 ? r || "Invalid date" : n && s < n ? t || `Must be after ${n}` : i && s > i ? e || `Must be before ${i}` : "");
   };
 }
-function m({
+function h({
   invalidTypeMsg: r,
   minMsg: t,
   maxMsg: e,
-  min: a = -Number.MAX_VALUE,
-  max: n = Number.MAX_VALUE
+  min: n = -Number.MAX_VALUE,
+  max: i = Number.MAX_VALUE
 } = {}) {
-  return (i) => {
+  return (a) => {
     let s = Number.MAX_VALUE;
-    return `${i ?? ""}`.length === 0 ? "" : (typeof i == "string" && (s = parseFloat(i)), typeof i == "number" && (s = i), isNaN(s) ? r || "Must be a numeric value" : s > n ? e || `Must be less than or equal to ${n}` : s < a ? t || `Must be greater than or equal to ${a}` : "");
+    return `${a ?? ""}`.length === 0 ? "" : (typeof a == "string" && (s = parseFloat(a)), typeof a == "number" && (s = a), isNaN(s) ? r || "Must be a numeric value" : s > i ? e || `Must be less than or equal to ${i}` : s < n ? t || `Must be greater than or equal to ${n}` : "");
   };
 }
-function O({
+function X({
   invalidTypeMsg: r,
   minMsg: t,
   maxMsg: e,
-  min: a = -Number.MAX_VALUE,
-  max: n = Number.MAX_VALUE
+  min: n = -Number.MAX_VALUE,
+  max: i = Number.MAX_VALUE
 }) {
-  return (i) => `${i || ""}`.length === 0 ? "" : typeof i != "string" ? r || "Invalid type" : i.length > n ? e || `Must be less than ${n} characters` : i.length < a ? t || `Must be greater than ${a} characters` : "";
+  return (a) => `${a || ""}`.length === 0 ? "" : typeof a != "string" ? r || "Invalid type" : a.length > i ? e || `Must be less than ${i} characters` : a.length < n ? t || `Must be greater than ${n} characters` : "";
 }
-function X(r, t, e, a) {
+function v(r, t, e, n) {
   if (!r) {
     console.error("dispatch element is null");
     return;
@@ -129,12 +129,12 @@ function X(r, t, e, a) {
   r.dispatchEvent(
     new CustomEvent(t, {
       composed: !0,
-      bubbles: a == null ? void 0 : a.bubbles,
+      bubbles: n == null ? void 0 : n.bubbles,
       detail: e
     })
   );
 }
-function u(r, t, e, a) {
+function o(r, t, e, n) {
   if (!r) {
     console.error("dispatch element is null");
     return;
@@ -142,7 +142,7 @@ function u(r, t, e, a) {
   r.dispatchEvent(
     new CustomEvent("msg", {
       composed: !0,
-      bubbles: a == null ? void 0 : a.bubbles,
+      bubbles: n == null ? void 0 : n.bubbles,
       detail: {
         action: t,
         data: e
@@ -150,13 +150,14 @@ function u(r, t, e, a) {
     })
   );
 }
-var d, E, v;
+var d, E, A;
 class j {
   constructor(t) {
-    g(this, d);
+    y(this, d);
     l(this, "state");
     l(this, "_formData");
     l(this, "_formRef");
+    l(this, "_isCompleting", !1);
     this.type = t;
   }
   // Obtain reference to the form element
@@ -178,38 +179,38 @@ class j {
   }
   // Public method to allow for the initialization of the state
   initState(t, e) {
-    u(this._formRef, "external::init:state", t), typeof t == "string" ? this.state = JSON.parse(t) : Array.isArray(t) || (this.state = t), e && setTimeout(e, 200);
+    o(this._formRef, "external::init:state", t), typeof t == "string" ? this.state = JSON.parse(t) : Array.isArray(t) || (this.state = t), e && setTimeout(e, 200);
   }
   updateListState(t) {
     const e = t.detail;
     Array.isArray(e.data) && (this.state = e.data);
   }
   updateObjectState(t) {
-    var a, n;
+    var n, i;
     if (Array.isArray(this.state))
       return;
     const e = t.detail;
     e.type === "list" ? this.state = {
       ...this.state,
-      form: { ...((a = this.state) == null ? void 0 : a.form) || {}, [e.id]: e.data }
+      form: { ...((n = this.state) == null ? void 0 : n.form) || {}, [e.id]: e.data }
     } : this.state = {
       ...this.state,
       ...e.data,
-      form: { ...((n = this.state) == null ? void 0 : n.form) || {}, ...e.data.form },
+      form: { ...((i = this.state) == null ? void 0 : i.form) || {}, ...e.data.form },
       history: e.data.history
     };
   }
   getStateList() {
     return this.state ? Array.isArray(this.state) ? this.state.length === 0 ? [] : this.state.map((t) => Object.values(t.form).filter((e) => {
-      var a;
-      return ((a = e == null ? void 0 : e.data) == null ? void 0 : a.type) === "details";
+      var n;
+      return ((n = e == null ? void 0 : e.data) == null ? void 0 : n.type) === "details";
     }).map((e) => {
-      var a;
-      return e.data.type === "details" && ((a = e.data) == null ? void 0 : a.fieldsets) || {};
+      var n;
+      return e.data.type === "details" && ((n = e.data) == null ? void 0 : n.fieldsets) || {};
     }).reduce(
-      (e, a) => {
-        for (const [n, i] of Object.entries(a))
-          e[n] = i.value;
+      (e, n) => {
+        for (const [i, a] of Object.entries(n))
+          e[i] = a.value;
         return e;
       },
       {}
@@ -243,8 +244,8 @@ class j {
       return console.error("getStateValue: unable to update the state of a multi form type"), "";
     if (!this.state)
       return console.error("getStateValue: state has not yet been set"), "";
-    const a = this.state.form[t].data;
-    return a.type !== "details" ? "" : a.fieldsets[e].value;
+    const n = this.state.form[t].data;
+    return n.type !== "details" ? "" : n.fieldsets[e].value;
   }
   // Public method to allow for the continuing to the next page
   continueTo(t) {
@@ -252,17 +253,17 @@ class j {
       console.error("continueTo [name] is undefined");
       return;
     }
-    u(this._formRef, "external::continue", { next: t });
+    o(this._formRef, "external::continue", { next: t });
   }
   // Public method to perform validation and send the appropriate messages to the form elements
-  validate(t, e, a, n) {
+  validate(t, e, n, i) {
     var b;
-    const { el: i, state: s, cancelled: o } = t.detail, f = (b = s == null ? void 0 : s[e]) == null ? void 0 : b.value;
-    if (window.scrollTo({ top: 0, behavior: "smooth" }), o)
+    const { el: a, state: s, cancelled: u } = t.detail, f = (b = s == null ? void 0 : s[e]) == null ? void 0 : b.value;
+    if (window.scrollTo({ top: 0, behavior: "smooth" }), u)
       return [!0, f];
-    for (const V of a) {
+    for (const V of n) {
       const p = V(f);
-      if (A(this, d, v).call(this, i, e, p, n), p)
+      if (_(this, d, A).call(this, a, e, p, i), p)
         return [!1, ""];
     }
     return [!0, f];
@@ -276,27 +277,86 @@ class j {
    * @param {FieldValidator[]} validators - An array of validator functions to apply to the fields.
    * @return {[number, Record<string, boolean>]} - Returns back the number of fields that passed and a record of the fields and their pass status.
    */
-  validateGroup(t, e, a) {
-    let n = 0;
-    const i = {};
+  validateGroup(t, e, n) {
+    let i = 0;
+    const a = {};
     for (const s of e) {
-      const [o] = this.validate(t, s, a, { grouped: !0 });
-      o && (i[s] = !0, n++);
+      const [u] = this.validate(t, s, n, { grouped: !0 });
+      u && (a[s] = !0, i++);
     }
-    return [n, i];
+    return [i, a];
   }
   edit(t) {
-    u(this._formRef, "external::alter:state", { index: t, operation: "edit" });
+    o(this._formRef, "external::alter:state", { index: t, operation: "edit" });
   }
   remove(t) {
-    u(this._formRef, "external::alter:state", {
+    o(this._formRef, "external::alter:state", {
       index: t,
       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 = !0, o(this._formRef, "fieldset::submit", null, { bubbles: !0 }), this._isCompleting = !1;
+  }
+  /**
+   * 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 t = this._formRef;
+    this._isCompleting = !0;
+    const e = (n) => {
+      t.removeEventListener("_stateChange", e), v(t, "_complete", {}, { bubbles: !0 }), this._isCompleting = !1;
+    };
+    t.addEventListener("_stateChange", e), v(t, "_continue", null, { bubbles: !0 });
+  }
   // removes any data collected that doesn't correspond with the final history path
   clean(t) {
-    return t.history.reduce((e, a) => (e[a] = t.form[a], e), {});
+    return t.history.reduce((e, n) => (e[n] = t.form[n], e), {});
   }
 }
 d = new WeakSet(), E = function(t) {
@@ -309,7 +369,7 @@ d = new WeakSet(), E = function(t) {
     }
   }));
 }, // Private method to dispatch the error message to the form element
-v = function(t, e, a, n) {
+A = function(t, e, n, i) {
   t.dispatchEvent(
     new CustomEvent("msg", {
       composed: !0,
@@ -317,33 +377,33 @@ v = function(t, e, a, n) {
         action: "external::set:error",
         data: {
           name: e,
-          msg: a,
-          grouped: n == null ? void 0 : n.grouped
+          msg: n,
+          grouped: i == null ? void 0 : i.grouped
         }
       }
     })
   );
 };
-const N = ["basic", "success", "failure"];
-function D(r, t) {
+const R = ["basic", "success", "failure"];
+function C(r, t) {
   const e = crypto.randomUUID();
-  return t = { uuid: e, type: "basic", ...t || {} }, !t.duration && t.type && N.includes(t.type) && (t.duration = "short"), u(
+  return t = { uuid: e, type: "basic", ...t || {} }, !t.duration && t.type && R.includes(t.type) && (t.duration = "short"), o(
     document.body,
     "goa:temp-notification",
     { message: r, ...t },
     { bubbles: !0 }
   ), e;
 }
-function _(r) {
-  u(
+function N(r) {
+  o(
     document.body,
     "goa:temp-notification:dismiss",
     r,
     { bubbles: !0 }
   );
 }
-function R(r, t) {
-  u(
+function D(r, t) {
+  o(
     document.body,
     "goa:temp-notification:progress",
     { uuid: r, progress: t },
@@ -351,26 +411,26 @@ function R(r, t) {
   );
 }
 const G = {
-  show: D,
-  dismiss: _,
-  setProgress: R
+  show: C,
+  dismiss: N,
+  setProgress: D
 };
 export {
   x as FormValidator,
   j as PublicFormController,
-  q as SINValidator,
+  Y as SINValidator,
   G as TemporaryNotification,
   I as birthDayValidator,
   L as birthMonthValidator,
   U as birthYearValidator,
-  J as dateValidator,
-  X as dispatch,
-  T as emailValidator,
-  O as lengthValidator,
-  m as numericValidator,
-  C as phoneNumberValidator,
-  Y as postalCodeValidator,
-  h as regexValidator,
-  u as relay,
+  O as dateValidator,
+  v as dispatch,
+  q as emailValidator,
+  X as lengthValidator,
+  h as numericValidator,
+  T as phoneNumberValidator,
+  J as postalCodeValidator,
+  m as regexValidator,
+  o as relay,
   c as requiredValidator
 };

package/lib/public-form-controller.d.ts

@@ -29,6 +29,7 @@ export declare class PublicFormController<T> {
     state?: AppState<T> | AppState<T>[];
     _formData?: Record<string, string>;
     _formRef?: HTMLElement;
+    private _isCompleting;
     constructor(type: "details" | "list");
     init(e: Event): void;
     initList(e: Event): void;
@@ -53,5 +54,39 @@ export declare class PublicFormController<T> {
     validateGroup(e: Event, fields: string[], validators: FieldValidator[]): [number, Record<string, boolean>];
     edit(index: number): void;
     remove(index: number): void;
+    /**
+     * 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(): void;
+    /**
+     * 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(): void;
     clean(data: AppState<T>): Record<string, unknown>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abgov/ui-components-common",
-  "version": "1.6.0",
+  "version": "1.7.0-alpha.1",
   "bugs": {
     "url": "https://github.com/GovAlta/ui-components/issues"
   },