@bolttech/form-engine-core 1.0.10 → 1.1.0

package/lite.esm.js

@@ -0,0 +1 @@
+import{BehaviorSubject as e,Subject as t,Subscription as i,groupBy as s,mergeMap as a,debounceTime as n,filter as r,combineLatest as l,startWith as o,map as u,distinctUntilKeyChanged as d}from"rxjs";var h;function c(e,t,i,s){return new(i||(i=Promise))(function(a,n){function r(e){try{o(s.next(e))}catch(e){n(e)}}function l(e){try{o(s.throw(e))}catch(e){n(e)}}function o(e){var t;e.done?a(e.value):(t=e.value,t instanceof i?t:new i(function(e){e(t)})).then(r,l)}o((s=s.apply(e,t||[])).next())})}!function(e){e.ON_VALUE="value",e.ON_PROPS="props",e.ON_VISIBILITY="visibility",e.ON_API="api",e.ON_IVARS="iVars",e.ON_FIELDS="fields"}(h||(h={})),"function"==typeof SuppressedError&&SuppressedError;const v=1e3,f=/^\$\{(?:[^{}]|\{(?:[^{}]|\{[^{}]*\})*\})*\}$/,p=/\$\{((?:[^{}]|\{(?:[^{}]|\{[^{}]*\})*\})*)\}/g,m=/\s*(\|\||&&|!+)\s*/g,b=/^\|\||&&|!+$/,S=["fields","iVars","form"],y=["api","apiSchema","props","validations","visibilityConditions","resetValues"],g=!1;function V(e){const t=p,i=[];let s;for(;null!==(s=t.exec(e));)i.push(s[1]);const a=m,n=i.map(e=>e.split(a).filter(e=>!a.test(e))).flat().filter(e=>e.split(".").length>1);return{originScopeKeys:Array.from(new Set(n.map(e=>e.split(".")[0]))),originFieldKeys:Array.from(new Set(n.map(e=>e.split(".")[1]))),originPropertyKeys:Array.from(new Set(n.map(e=>e.split(".")[2])))}}function $(e,t){const i=[];if(Array.isArray(e))e.forEach((e,s)=>{i.push(...$(e,`${t?`${t}.`:""}${s}`))});else if("object"==typeof e)for(const s in e)Object.prototype.hasOwnProperty.call(e,s)&&i.push(...$(e[s],`${t?`${t}.`:""}${s}`));else if("string"==typeof e&&e.includes("${")){const s=(t||"").split(".");V(e).originScopeKeys.every(e=>S.includes(e))?i.push(Object.assign(Object.assign({originExpression:e},V(e)),{destinationKey:s[0],destinationProperty:s[1],destinationPath:s.slice(2)})):console.warn(`scope malformed on this expression: ${e}, ignoring..`)}return i}const j={},E={},O={};function I(e){Object.assign(j,e)}function x(e){Object.assign(E,e)}function _(e){Object.assign(O,e)}function k(e){if(null===e||"object"!=typeof e)return e;if(e instanceof Date)return new Date(e.getTime());if(Array.isArray(e))return e.map(e=>k(e));const t={};for(const i in e)Object.prototype.hasOwnProperty.call(e,i)&&(t[i]=k(e[i]));return t}function F(e,t,i){if(null==e)return i;const s=Array.isArray(t)?t:t.split(".");let a=e;for(let e=0;e<s.length;e++){if(null==a)return i;a=a[s[e]]}return void 0===a?i:a}function N(e,t,i){if(null==e||"object"!=typeof e)return e;const s=Array.isArray(t)?t:t.split(".");let a=e;for(let e=0;e<s.length-1;e++){const t=s[e],i=s[e+1];null!=a[t]&&"object"==typeof a[t]||(a[t]="number"==typeof i||/^\d+$/.test(String(i))?[]:{}),a=a[t]}return a[s[s.length-1]]=i,e}function P(e,t){if(e===t)return!0;if(null==e||null==t)return e===t;if(typeof e!=typeof t)return!1;if(e instanceof Date&&t instanceof Date)return e.getTime()===t.getTime();if("object"!=typeof e)return!1;const i=Array.isArray(e);if(i!==Array.isArray(t))return!1;if(i){if(e.length!==t.length)return!1;for(let i=0;i<e.length;i++)if(!P(e[i],t[i]))return!1;return!0}const s=Object.keys(e),a=Object.keys(t);if(s.length!==a.length)return!1;for(const i of s){if(!Object.prototype.hasOwnProperty.call(t,i))return!1;if(!P(e[i],t[i]))return!1}return!0}function w(e){return null==e}class T extends t{constructor(e){super(),this.isMounted=e}next(e){this.isMounted()&&super.next(e)}}class A extends e{constructor(e){super(e),this.defaultValue=e}next(e){this.closed||super.next(e)}get value(){return this.closed?this.defaultValue:super.value}}function R(e,t,i,s,a){return function(e){return"function"==typeof e}(i[s])?i[s](e,t,a):((e,t,i)=>!!t&&function(e,t,i){const s=[];return Object.keys(t).forEach(a=>{s.push(i[a](e,{[a]:t[a]}))}),s}(e,t,i).some(e=>e))(e,t[s],i)}class M{constructor({formIndex:e,schemaComponent:t,config:s,children:a,validateVisibility:n,resetValue:r,resetProperty:l,templateSubject$:o,fieldEventSubject$:u,dataSubject$:d,fieldValidNotification$:h,mountSubject$:c,mapper:f,formValuesStateSubject$:p,submitEvent:m,visibility:b,persistValue:S}){var y,V,$,j,E,O;this.valueSubscription$=new i,this.fieldStateSubscription$=new i,this.formIndex=e,this.originalSchema=k(t),this.config={defaultAPIdebounceTimeMS:Number(null==s?void 0:s.defaultAPIdebounceTimeMS)?Number(null==s?void 0:s.defaultAPIdebounceTimeMS):v,defaultStateRefreshTimeMS:Number(null==s?void 0:s.defaultStateRefreshTimeMS)?Number(null==s?void 0:s.defaultStateRefreshTimeMS):100,defaultLogVerbose:(null==s?void 0:s.defaultLogVerbose)?s.defaultLogVerbose:g},this.name=t.name,this.nameToSubmit=t.nameToSubmit,this.component=t.component,this.children=a,this.validations=k(t.validations),this.visibilityConditions=k(t.visibilityConditions),this.resetValues=k(t.resetValues),this.resetPropertyValues=k(t.resetPropertyValues),this.apiSchema=k(t.api),this.formatters=k(t.formatters),this.masks=k(t.masks),f.valueChangeEvent&&(this.valueChangeEvent=f.valueChangeEvent),(null===(y=f.events)||void 0===y?void 0:y.setValue)&&(this.valuePropName=f.events.setValue),this.mapper=f,this.validateVisibility=n,this.resetValue=r,this.resetProperty=l,this.submitEvent=m,this.templateSubject$=o,this.fieldEventSubject$=u,this.dataSubject$=d,this.fieldValidNotification$=h,this.mountSubject$=c,this.formValuesStateSubject$=p,this.getFormValues=()=>this.formValuesStateSubject$.value,this._props=M.filterProps(k(t.props||{})),this._adapterProps=JSON.stringify(t.props||{}),this._metadata="",this.errorsString="",this.errorsList=[],this._visibility="boolean"!=typeof b||b,this._api={default:{response:(null===(j=null===($=null===(V=this.apiSchema)||void 0===V?void 0:V.defaultConfig)||void 0===$?void 0:$.config)||void 0===j?void 0:j.fallbackValue)||"",status:null},named:(null===(E=this.apiSchema)||void 0===E?void 0:E.configs)&&Object.keys(null===(O=this.apiSchema)||void 0===O?void 0:O.configs).reduce((e,t)=>{var i,s;return e[t]={response:(null===(s=null===(i=this.apiSchema)||void 0===i?void 0:i.configs)||void 0===s?void 0:s[t].config.fallbackValue)||"",status:null},e},{}),apiState:{loading:!1}},this._errors={},this._mounted=!1,this.valid=!0,this.persistValue=S,this.initializeObservers()}initializeObservers(){this.valueSubject$&&!this.valueSubject$.closed||(this.valueSubject$=new T(()=>this.mounted)),this.errorSubject$&&!this.errorSubject$.closed||(this.errorSubject$=new T(()=>this.mounted)),this.visibilitySubject$&&!this.visibilitySubject$.closed||(this.visibilitySubject$=new T(()=>this.mounted)),this.propsSubject$&&!this.propsSubject$.closed||(this.propsSubject$=new T(()=>this.mounted)),this.fieldStateSubscription$&&!this.fieldStateSubscription$.closed||(this.fieldStateSubscription$=new i),this.apiEventQueueSubject$&&!this.apiEventQueueSubject$.closed||(this.apiEventQueueSubject$=new T(()=>this.mounted)),this.apiEventQueueSubject$.observed||this.apiEventQueueSubject$.pipe(s(({event:e})=>e),a(e=>e.pipe(n(this.config.defaultAPIdebounceTimeMS))),r(()=>this.apiEventQueueSubject$&&!this.apiEventQueueSubject$.closed)).subscribe(e=>{this.apiRequest(e)})}get adapterProps(){return this._adapterProps}set adapterProps(e){const t=JSON.stringify(e||{});t!==this.adapterProps&&(this.props=M.filterProps(e),this._adapterProps=t)}get props(){return this._props}set props(e){void 0===e||P(e,this.props)||(this._props=e,this.propsSubject$.next(this.props),this.templateSubject$.next({scope:"fields",key:this.name,event:"ON_PROPS"}))}static filterProps(e){return Array.isArray(e)?e.filter(e=>"string"!=typeof e||!e.includes("${")).map(e=>M.filterProps(e)):"object"==typeof e&&null!==e?e instanceof Date?e:Object.keys(e).reduce((t,i)=>{const s=e[i];return"string"==typeof s&&s.includes("${")||(t[i]=M.filterProps(e[i])),t},{}):e}get stateValue(){return this._stateValue}get metadata(){return this._metadata}get value(){return this._value}set value(e){var t,i,s;let a;if(this.valueChangeEvent)try{a=this.valueChangeEvent(e,{props:this.props})}catch(t){a=e}else a=e;null!=a&&("object"==typeof a&&"_value"in a&&"_metadata"in a?(this._value=this.formatValue(a._value),this._stateValue=(null===(t=this.mapper.events)||void 0===t?void 0:t.setValue)?{[this.mapper.events.setValue]:this.maskValue(this.formatValue(a._value))}:{},this._metadata=a._metadata):(this._value=this.formatValue(a),this._stateValue=(null===(i=this.mapper.events)||void 0===i?void 0:i.setValue)?{[null===(s=this.mapper.events)||void 0===s?void 0:s.setValue]:this.maskValue(this.formatValue(a))}:{},this.maskValue(this.formatValue(a)),this._metadata=a),this.stateValue&&this.valueSubject$.next(this.stateValue),this.templateSubject$.next({scope:"fields",key:this.name,event:"ON_VALUE"}))}get visibility(){return this._visibility}set visibility(e){void 0!==e&&e!==this.visibility&&(this._visibility=e,this.visibilitySubject$.next(this.visibility),this.templateSubject$.next({scope:"fields",key:this.name,event:"ON_VISIBILITY"}))}set valid(e){"boolean"!=typeof e&&this.valid===e||(this._valid=e,this.triggerFieldValidNotification())}get valid(){return this._valid}triggerFieldValidNotification(){this.fieldValidNotification$.closed||this.fieldValidNotification$.next({fieldTrigger:this.name})}get errors(){return this._errors}set errors(e){var t;void 0===e||P(e,this.errors)||(this._errors=e,this.errorsList=Object.values(this.errors).filter(e=>null!=e),this.errorsString=this.errorsList.join(", "),(null===(t=this.mapper.events)||void 0===t?void 0:t.setErrorMessage)&&this.errorSubject$.next({[this.mapper.events.setErrorMessage]:this.errorsString}),this.templateSubject$.next({scope:"fields",key:this.name,event:"ON_PROPS"}))}get api(){return this._api}set api(e){void 0!==e&&(this._api=e,this.templateSubject$.next({scope:"fields",key:this.name,event:"ON_API_RESPONSE"}),this.emitEvents({event:"ON_API_FIELD_RESPONSE"}))}notifyApiRequest(){this._api.apiState.loading=!0,this.templateSubject$.next({scope:"fields",key:this.name,event:"ON_API_REQUEST"}),this.emitEvents({event:"ON_API_FIELD_REQUEST"})}get mounted(){return this._mounted}set mounted(e){void 0!==e&&e!==this.mounted&&(this._mounted=e,this.initializeObservers(),this.mountSubject$.closed||this.mountSubject$.next({key:this.name,status:this.mounted}))}mountField({valueSubscription:e,propsSubscription:t}){this.mounted=!0,this.subscribeValue(e),this.subscribeState(t),this.valueSubject$.next(this.stateValue),this.propsSubject$.next(this.props),this.visibilitySubject$.next(this.visibility),this.fieldEventSubject$.next({event:"ON_FIELD_MOUNT",fieldName:this.name,fieldInstance:this})}emitValue(e){this.visibility&&this.mounted&&(this.value=e.value,this.dataSubject$.next({event:e.event,fieldIndex:this.name,formIndex:this.formIndex}),this.emitEvents({event:e.event}))}emitEvents({event:e}){if("ON_FORM_SUBMIT"===e)return this.submitEvent();this.validateVisibility({event:e,key:this.name}),this.setFieldValidity({event:e}),this.resetValue({event:e,key:this.name}),this.resetProperty({event:e,key:this.name}),this.apiEventQueueSubject$.next({event:e}),this.fieldEventSubject$.next({event:e,fieldName:this.name,fieldInstance:this})}setFieldValidity({event:e}){var t,i,s,a;if(!this.validations||!this.visibility)return this.errors={},void(this.valid=!0);let n=!0;const r={},l=null===(t=this.validations)||void 0===t?void 0:t.methods;if(l&&Object.keys(l).forEach(e=>{var t,i;const s=R(this.value,l,j,e,null===(t=this.formValuesStateSubject$)||void 0===t?void 0:t.value);n=!s&&n,s&&(null===(i=this.validations)||void 0===i?void 0:i.messages)?e in this.validations.messages?r[e]=this.validations.messages[e]:"default"in this.validations.messages&&(r[e]=this.validations.messages.default):delete r[e]}),this.valid=n,null===(s=null===(i=this.validations)||void 0===i?void 0:i.eventMessages)||void 0===s?void 0:s[e]){const t={};null===(a=this.validations.eventMessages[e])||void 0===a||a.forEach(e=>{e in r&&(t[e]=r[e])}),this.errors=t}else"ON_FIELD_VALIDATION"===e&&(this.errors=r)}formatValue(e){return this.formatters?Object.keys(this.formatters).reduce((e,t)=>{const i=E[t];return i?i(e,this.formatters):e},e):e}maskValue(e){return this.masks?Object.keys(this.masks).reduce((e,t)=>{const i=O[t];return i?i(e,this.masks):e},e):e}checkApiRequestValidations(e){let t=!0;const i=e.preConditions;return i&&Object.keys(i).forEach(e=>{var s;const a=R(this.value,i,j,e,null===(s=this.formValuesStateSubject$)||void 0===s?void 0:s.value);t=t&&!a}),e.blockRequestWhenInvalid&&(t=t&&this.valid),t}apiRequest(e){return c(this,arguments,void 0,function*({event:e}){var t,i,s,a,n,r,l,o,u;let d=!1;const h=e=>c(this,void 0,void 0,function*(){var t,i;try{const{status:s,response:a}=yield function(e,t,i,s,a){return c(this,void 0,void 0,function*(){if(a){const[e,i]=t.split("?"),s=new URLSearchParams(i);Object.keys(a).forEach(e=>{s.append(e,a[e])}),t=`${e}?${s.toString()}`}const n=yield fetch(t,{method:e,headers:i,body:s?JSON.stringify(s):void 0}),r=yield n.text();return{status:n.status,response:r}})}(e.method,e.url,e.headers,e.body,e.queryParams),n=null===(t=e.transform)||void 0===t?void 0:t.callback,r=n?n({payload:JSON.parse(String(a)),formValues:null===(i=this.formValuesStateSubject$)||void 0===i?void 0:i.value}):JSON.parse(String(a));return{response:e.resultPath?F(r,e.resultPath):r,status:s}}catch(t){return{response:w(null==e?void 0:e.fallbackValue)?"error":e.fallbackValue,status:500}}});if("ON_API_FIELD_RESPONSE"===this.api.apiState.lastEvent&&"ON_API_FIELD_RESPONSE"===e||!(null===(i=null===(t=this.apiSchema)||void 0===t?void 0:t.defaultConfig)||void 0===i?void 0:i.events.includes(e))&&(!(null===(s=this.apiSchema)||void 0===s?void 0:s.configs)||!Object.keys(null===(a=this.apiSchema)||void 0===a?void 0:a.configs).some(t=>{var i,s;return null===(s=null===(i=this.apiSchema)||void 0===i?void 0:i.configs)||void 0===s?void 0:s[t].events.includes(e)})))return;const v={default:Object.assign({},this.api.default),named:Object.assign({},this.api.named),apiState:Object.assign({},this.api.apiState)},f=null===(n=this.apiSchema.defaultConfig)||void 0===n?void 0:n.config;if(f&&(null===(l=null===(r=this.apiSchema)||void 0===r?void 0:r.defaultConfig)||void 0===l?void 0:l.events.includes(e))&&this.checkApiRequestValidations(f)){d||this.notifyApiRequest();const{response:e,status:t}=yield h(f);d=!0,v.default={response:e,status:t}}if((null===(o=this.apiSchema)||void 0===o?void 0:o.configs)&&Object.keys(null===(u=this.apiSchema)||void 0===u?void 0:u.configs).some(t=>{var i,s;return null===(s=null===(i=this.apiSchema)||void 0===i?void 0:i.configs)||void 0===s?void 0:s[t].events.includes(e)})&&this.apiSchema.configs){const t=yield Promise.all(Object.keys(this.apiSchema.configs).map(t=>c(this,void 0,void 0,function*(){var i,s,a,n;const r=null===(s=null===(i=this.apiSchema)||void 0===i?void 0:i.configs)||void 0===s?void 0:s[t].config;if(r&&(null===(n=null===(a=this.apiSchema)||void 0===a?void 0:a.configs)||void 0===n?void 0:n[t].events.includes(e))&&this.checkApiRequestValidations(r)){d||this.notifyApiRequest();const{response:e,status:i}=yield h(r);return d=!0,{name:t,result:{response:e,status:i}}}return null})));t.forEach(e=>{e&&v.named&&(v.named[e.name]=e.result)})}d&&(v.apiState.lastEvent=e,v.apiState.loading=!1,this.api=v)})}destroyField(){this.mounted=!1,this.valueSubscription$.unsubscribe(),this.visibilitySubject$.unsubscribe(),this.fieldStateSubscription$.unsubscribe(),this.propsSubject$.unsubscribe(),this.errorSubject$.unsubscribe(),this.apiEventQueueSubject$.unsubscribe(),this.dataSubject$.closed||this.dataSubject$.next({event:"ON_FIELD_UNMOUNT",fieldIndex:this.name,formIndex:this.formIndex}),this.fieldEventSubject$.closed||this.fieldEventSubject$.next({event:"ON_FIELD_UNMOUNT",fieldName:this.name,fieldInstance:this})}subscribeState(e){var t;this.fieldStateSubscription$=l({visibility:this.visibilitySubject$.pipe(o(this.visibility)),props:this.propsSubject$.pipe(o(this.props)),errors:this.errorSubject$.pipe(o(Object.assign({},(null===(t=this.mapper.events)||void 0===t?void 0:t.setErrorMessage)&&{[this.mapper.events.setErrorMessage]:this.errorsString})))}).pipe(n(this.config.defaultStateRefreshTimeMS)).subscribe({next:e})}subscribeValue(e){this.valueSubscription$=this.valueSubject$.subscribe({next:e})}}class L{constructor(e){var s,a,n,r,l,o,u,d,h,c,f;this.templateSubscription$=new i,this.mappers=new Map,this.queuedFieldVisibilityEvents=new Map,this.queuedFieldResetValuesEvents=new Map,this.queuedFieldResetPropertyEvents=new Map,this.queuedInitialValues=new Map,this._valid=!1,this.stopEventsOnSubmit=!1,this.submitted=!1,this.isolatedFormInstance=!1,this.index=e.index,this.schema=e.schema,this.fields=new Map,this.action=e.action||(null===(s=e.schema)||void 0===s?void 0:s.action),this.method=e.method||(null===(a=e.schema)||void 0===a?void 0:a.method),this.config={defaultAPIdebounceTimeMS:Number(null===(n=e.config)||void 0===n?void 0:n.defaultAPIdebounceTimeMS)?Number(null===(r=e.config)||void 0===r?void 0:r.defaultAPIdebounceTimeMS):v,defaultStateRefreshTimeMS:Number(null===(l=e.config)||void 0===l?void 0:l.defaultStateRefreshTimeMS)?Number(null===(o=e.config)||void 0===o?void 0:o.defaultStateRefreshTimeMS):100,defaultLogVerbose:(null===(u=e.config)||void 0===u?void 0:u.defaultLogVerbose)?e.config.defaultLogVerbose:g},null===(d=e.mappers)||void 0===d||d.map(e=>{this.mappers.set(e.componentName,e)}),e.submitSubject$&&e.dataSubject$&&e.formValidSubject$||(this.isolatedFormInstance=!0,this.config.defaultLogVerbose&&console.warn(`some formGroup events are not properly instanciated, any onData, onValid, onSubmit events managed by formGroup won't trigger on form: ${this.index}`)),this.schema&&L.checkIndexes(this.schema.components),this.templateSubject$=new t,this.fieldEventSubject$=new t,this.mountSubject$=new t,this.fieldValidNotification$=new t,this.submitSubject$=e.submitSubject$?e.submitSubject$:new t,this.dataSubject$=e.dataSubject$?e.dataSubject$:new t,this.formValidSubject$=e.formValidSubject$?e.formValidSubject$:new t,this.formValuesStateSubject$=new A({erroredFields:[],isValid:!0,metadata:[],values:[]}),this.getFormValues=()=>this.formValuesStateSubject$.value,this.subscribedTemplates=[],this.templateSubscription$=this.templateSubject$.subscribe(this.refreshTemplates.bind(this)),this.fieldValidNotification$.subscribe(()=>{this.validateForm()}),this.fieldEventSubject$.subscribe(()=>{this.formValuesStateSubject$.next(this.getFormState())}),this.dataSubject$.subscribe(()=>{this.formValuesStateSubject$.next(this.getFormState())}),this.mountSubject$.subscribe(this.mountActions.bind(this)),this.prefetchedData=null===(h=e.schema)||void 0===h?void 0:h.prefetchedData,this.initialValues=e.initialValues||(null===(c=e.schema)||void 0===c?void 0:c.initialValues),this.iVars=e.iVars||(null===(f=e.schema)||void 0===f?void 0:f.iVars)||{},this.stopEventsOnSubmit=(null==e?void 0:e.stopEventsOnSubmit)||!1,this.submitted=!1}generateFields(){this.schema&&this.serializeStructure(this.schema.components),this.fields.forEach(e=>{e.mountField({valueSubscription:()=>null,propsSubscription:()=>null})})}submitChecker(){return!(this.stopEventsOnSubmit&&this.submitted)}mountActions({key:e,status:t}){if(t){const t=this.fields.get(e);if(!t)return void(this.config.defaultLogVerbose&&console.warn(`field ${e} was mounted but since it's parent has some visibility condition the field was already removed`));this.subscribeTemplates(),this.refreshTemplates({scope:"fields",event:"ON_FIELDS"}),this.templateSubject$.next({scope:"iVars",event:"ON_IVARS"}),this.queuedInitialValues.has(e)||(t.valuePropName&&!t.value?t.emitValue({event:"ON_FIELD_MOUNT",value:""}):t.emitEvents({event:"ON_FIELD_MOUNT"})),this.checkFieldEventQueues(e)}}set initialValues(e){e&&Object.keys(e).forEach(t=>{const i=this.fields.get(t);i&&(null==i?void 0:i.visibility)&&(null==i?void 0:i.mounted)?i.emitValue({value:null==e?void 0:e[t],event:"ON_FIELD_MOUNT"}):this.queuedInitialValues.set(t,null==e?void 0:e[t])})}get iVars(){return this._iVars}set iVars(e){this._iVars=e,this.templateSubject$.next({scope:"iVars",event:"ON_IVARS"})}validateForm(){if(0===this.fields.size)return this.valid=!1;for(const[,e]of this.fields)if(!e.valid)return this.valid=!1;return this.valid=!0}get valid(){return this._valid}set valid(e){this._valid!==e&&(this._valid=e,this.templateSubject$.next({event:"ON_FORM",scope:"form"}),this.formValidSubject$.next({formIndex:this.index,valid:this.valid}))}subscribeTemplates(){this.subscribedTemplates=[],this.fields.forEach(({originalSchema:{component:e,props:t,name:i,validations:s,visibilityConditions:a,resetValues:n,resetPropertyValues:r,api:l}},o)=>{$({component:e,props:t,name:i,validations:s,visibilityConditions:a,resetValues:n,resetPropertyValues:r,apiSchema:l},o).forEach(e=>this.subscribedTemplates.push(e))})}getValue({scope:e,key:t,property:i,path:s}){switch(e){case"iVars":return F(this.iVars,[t,...i?[i]:[],...s]);case"form":return F(this,[t,...i?[i]:[],...s]);case"fields":{const e=this.fields.get(t);return e?"props"===i&&s[0]===e.valuePropName?e.value:s.length>0?F(e[i],s):e[i]:this.config.defaultLogVerbose&&console.warn(`failed to get value from ${t}`)}}}setValue({key:e,property:t,path:i,originKey:s,value:a}){const n=this.fields.get(e);if(n){if(i.length>0){if("props"===t&&i[0]===n.valuePropName&&e!==s)return void n.emitValue({event:"ON_FIELD_CHANGE",value:a});const r=n[t];let l;return Array.isArray(r)||"object"==typeof r&&!w(r)?(l=k(r),N(l,i,a),void(n[t]=l)):void(this.config.defaultLogVerbose&&console.warn(`invalid template property, skipping evaluation of ${n.name} with ${r}`))}n[t]=a}else this.config.defaultLogVerbose&&console.warn(`failed to update field ${e}`)}extractParams(e){const t=function(e){const t=e.split(".");return t.length>1?this.getValue({scope:t[0],key:t[1],property:t[2],path:t.slice(3)}):t[0]}.bind(this),i=[];let s;for(;!w(s=p.exec(e));)i.push(s[1]);return i.map(e=>e.split(m)).map(e=>e.length<=1?{parse:!1,value:t(e[0])}:{parse:!0,value:e.filter(Boolean).reduce((e,i)=>{if(i.match(b))return`${e}${i}`;let s;const a=t(i);let n;try{n=JSON.parse(a)}catch(e){n=a}switch(typeof n){case"string":s=`\`${n}\``;break;case"boolean":case"undefined":case"number":default:s=n;break;case"object":if(null===n){s=null;break}if(n instanceof Date){s=`new Date(\`${n}\`)`;break}s=JSON.stringify(n)}return`${e}${s}`},"")}).map(({parse:t,value:i})=>{try{return t?new Function(`return ${i}`)():i}catch(t){return this.config.defaultLogVerbose&&(console.warn(`unhandled parsing on ${e} returning`),console.warn(i)),i}})}replaceExpression(e,t){return e.replace(p,()=>String(t.shift())||"")}hasStringConcatenation(e){return!f.test(e)}refreshTemplates({key:e,event:t}){this.subscribedTemplates.forEach(({destinationKey:i,destinationPath:s,destinationProperty:a,originExpression:n,originFieldKeys:r})=>{if(!e||r.includes(e)){const r=this.extractParams(n);let l;l=this.hasStringConcatenation(n)?this.replaceExpression(n,[...r]):null==r?void 0:r[0],P(this.getValue({scope:"fields",key:i,property:a,path:s}),l)||this.setValue({key:i,property:a,path:s,originKey:e,value:l,event:t})}})}checkFieldEventQueues(e){var t;if(null===(t=this.fields.get(e))||void 0===t?void 0:t.mounted){if(this.queuedFieldVisibilityEvents.has(e)&&(this.setFieldVisibility(Object.assign({field:e},this.queuedFieldVisibilityEvents.get(e))),this.queuedFieldVisibilityEvents.delete(e)),this.queuedInitialValues.has(e)){const t=this.queuedInitialValues.get(e);this.queuedInitialValues.delete(e),this.initialValues={[e]:t}}this.queuedFieldResetValuesEvents.has(e)&&(this.setResetFieldValue(Object.assign({key:e},this.queuedFieldResetValuesEvents.get(e))),this.queuedFieldResetValuesEvents.delete(e)),this.queuedFieldResetPropertyEvents.has(e)&&(this.setResetPathValue(Object.assign({key:e},this.queuedFieldResetPropertyEvents.get(e))),this.queuedFieldResetPropertyEvents.delete(e))}}setFieldVisibility({field:e,hasError:t,showOnlyIfTrue:i}){const s=this.fields.get(e);if(s&&s.mounted){const a=s.visibility,n=i?t:!t;if(s.visibility=n,a===n)return;s.visibility?this.queuedInitialValues.has(e)?(null==s||s.emitValue({value:this.queuedInitialValues.get(e)||"",event:"ON_FIELD_MOUNT"}),this.queuedInitialValues.delete(e)):s.emitEvents({event:"ON_FIELD_MOUNT"}):(s.emitEvents({event:"ON_FIELD_UNMOUNT"}),s.persistValue&&this.queuedInitialValues.set(s.name,s.value),s.value="",s.valid=!0)}else this.queuedFieldVisibilityEvents.set(e,{hasError:t,showOnlyIfTrue:i})}validateVisibility({event:e,key:t}){const i=this.fields.get(t),s=null==i?void 0:i.visibilityConditions;s&&(null==s?void 0:s.some(t=>t.events.includes(e)))&&s.forEach(t=>{t.events.includes(e)&&Object.keys(t.validations).forEach(e=>{const s=R(i.value,t.validations,j,e,this.formValuesStateSubject$.value);Array.isArray(t.fields)?t.fields.forEach(e=>{this.setFieldVisibility({field:e,hasError:s,showOnlyIfTrue:!(!i.value||!t.showOnlyIfTrue)})}):t.fields&&this.setFieldVisibility({field:t.fields,hasError:s,showOnlyIfTrue:!(!i.value||!t.showOnlyIfTrue)})})})}setResetFieldValue({key:e,value:t}){const i=this.fields.get(e);i&&(null==i?void 0:i.mounted)?i.emitValue({value:t,event:"ON_FIELD_CLEARED"}):this.queuedFieldResetValuesEvents.set(e,{value:t})}resetValue({event:e,key:t}){const i=this.fields.get(t),s=null==i?void 0:i.resetValues;s&&(null==s?void 0:s.some(t=>t.events.includes(e)))&&s.forEach(t=>{if(!t.events.includes(e))return;const s=()=>{Array.isArray(t.fields)?t.fields.forEach((e,i)=>{const s=Array.isArray(t.resettledValue)?t.resettledValue[i]:t.resettledValue;this.setResetFieldValue({key:e,value:s})}):t.fields&&this.setResetFieldValue({key:t.fields,value:t.resettledValue})};if(!t.validations)return s();Object.keys(t.validations).forEach(e=>{R(i.value,t.validations,j,e,this.formValuesStateSubject$.value)||s()})})}setResetPathValue({key:e,property:t,path:i,value:s}){this.fields.get(e)?this.setValue({key:e,property:t,path:i.split("."),value:s,event:"ON_RESET"}):this.queuedFieldResetPropertyEvents.set(e,{property:t,path:i,value:s})}resetProperty({event:e,key:t}){const i=this.fields.get(t),s=null==i?void 0:i.resetPropertyValues;s&&(null==s?void 0:s.some(t=>t.events.includes(e)))&&s.forEach(t=>{if(t.events.includes(e)&&y.includes(t.property))return t.validations?void Object.keys(t.validations).forEach(e=>{R(i.value,t.validations,j,e,this.formValuesStateSubject$.value)||this.setResetPathValue({key:t.field,path:t.path,property:t.property,value:t.resettledValue})}):this.setResetPathValue({key:t.field,path:t.path,property:t.property,value:t.resettledValue})})}addField({fieldSchema:e,mapperElement:t,path:i}){var s,a,n,r,l;if(this.fields.has(e.name))throw new Error(`field name ${e.name} already defined`);const o=t||(null===(s=this.mappers)||void 0===s?void 0:s.get(e.component));if(!o)throw new Error(`mapper not found for ${e.component}, add it to the mappers configuration`);if(null===(a=o.events)||void 0===a?void 0:a.setValue){const t=null===(n=null==e?void 0:e.props)||void 0===n?void 0:n[null===(r=null==o?void 0:o.events)||void 0===r?void 0:r.setValue];void 0===t||this.queuedInitialValues.has(e.name)||"string"==typeof t&&t.includes("${")||this.queuedInitialValues.set(e.name,k(t))}if(this.fields.set(e.name,new M({formIndex:this.index,schemaComponent:e,mapper:o,children:e.children?e.children.map(e=>e.name):[],validateVisibility:this.validateVisibility.bind(this),resetValue:this.resetValue.bind(this),resetProperty:this.resetProperty.bind(this),formValuesStateSubject$:this.formValuesStateSubject$,templateSubject$:this.templateSubject$,fieldEventSubject$:this.fieldEventSubject$,dataSubject$:this.dataSubject$,fieldValidNotification$:this.fieldValidNotification$,mountSubject$:this.mountSubject$,config:this.config,submitEvent:this.submit.bind(this),visibility:e.visibility,persistValue:e.persistValue,path:i})),null===(l=this.prefetchedData)||void 0===l?void 0:l[e.name]){const t=this.fields.get(e.name);if(t){const i=this.prefetchedData[e.name],s=Object.assign({},t.api);void 0!==i.defaultResponse&&(s.default={response:i.defaultResponse,status:200}),i.namedResponses&&(s.named=s.named||{},Object.keys(i.namedResponses).forEach(e=>{s.named[e]={response:i.namedResponses[e],status:200}})),t._api=s}}}removeField({key:e}){var t;null===(t=this.fields.get(e))||void 0===t||t.destroyField(),this.fields.delete(e),this.subscribeTemplates(),this.templateSubject$.next({scope:"fields",key:e,event:"ON_FIELDS"}),this.validateForm()}serializeStructure(e,t){e&&e.forEach(e=>{var i;const s=this.fields.get(e.name);s?(s.children=(null===(i=null==e?void 0:e.children)||void 0===i?void 0:i.map(e=>e.name))||(null==s?void 0:s.children)||[],s.originalSchema=e,s.templateSubject$=this.templateSubject$):this.addField({fieldSchema:e,mapperElement:e.mapper,path:t}),e.children&&this.serializeStructure(e.children,`${t?`${t}.`:""}${e.name}`)})}refreshFields(e){const t=Array.from(this.fields.keys());this.serializeStructure(e);const i=L.checkIndexes(e);this.fields.forEach((e,t)=>{var s;i.includes(t)||(null===(s=this.fields.get(t))||void 0===s||s.destroyField(),this.fields.delete(t))}),this.subscribeTemplates(),this.fields.forEach((e,i)=>{var s;t.includes(i)||(null===(s=this.fields.get(i))||void 0===s||s.emitEvents({event:"ON_FIELD_MOUNT"}),this.checkFieldEventQueues(i))}),this.subscribedTemplates.forEach(e=>{e.originFieldKeys.forEach(e=>{this.templateSubject$.next({scope:"fields",key:e,event:"ON_FIELDS"})})})}getField({key:e}){return this.fields.get(e)}printValues(){console.table(this.formValuesStateSubject$.value.values)}getFormState(){const e={},t={},i=[];return this.fields.forEach((s,a)=>{"string"==typeof s.value&&0===s.value.length||null==s.value||(N(e,s.nameToSubmit||a,s.value),t[a]=s.metadata),s.valid||i.push(a)}),{values:e,metadata:t,erroredFields:i,isValid:this.valid}}subscribeFieldEvent({callback:e}){return this.fieldEventSubject$.pipe(r(()=>this.submitChecker()),s(e=>`${e.event}|${e.fieldName}`),a(e=>e.pipe(n(this.config.defaultStateRefreshTimeMS)))).subscribe({next:e})}subscribeOnMount(e){return this.mountSubject$.pipe(u(()=>this.formValuesStateSubject$.value)).subscribe({next:e})}subscribeData(e){return this.dataSubject$.pipe(r(({formIndex:e})=>this.index===e&&this.submitChecker()),s(e=>e.event),a(e=>e.pipe(n(this.config.defaultStateRefreshTimeMS))),u(({fieldIndex:e})=>({field:e,data:this.formValuesStateSubject$.value}))).subscribe({next:e})}subscribeOnSubmit(e){return this.submitSubject$.pipe(r(({formIndex:e})=>e===this.index&&this.submitChecker()),u(({values:e})=>e)).subscribe({next:e})}subscribeFormValidation(e){return this.formValidSubject$.pipe(r(({formIndex:e})=>this.index===e),u(()=>({formIndex:this.index,valid:this.valid})),d("valid"),o({formIndex:this.index,valid:this.valid})).subscribe({next:e})}submit(){this.fields.forEach(e=>{e.emitEvents({event:"ON_FIELD_VALIDATION"})}),this.valid&&(this.submitSubject$.next({formIndex:this.index,values:this.formValuesStateSubject$.value}),this.submitted=!0)}destroy(){this.templateSubject$.unsubscribe(),this.templateSubscription$.unsubscribe(),this.mountSubject$.unsubscribe(),this.fieldEventSubject$.unsubscribe(),this.fieldValidNotification$.unsubscribe(),this.formValuesStateSubject$.unsubscribe(),this.isolatedFormInstance&&(this.submitSubject$.unsubscribe(),this.dataSubject$.unsubscribe(),this.formValidSubject$.unsubscribe()),this.fields.forEach(e=>e.destroyField())}}L.checkIndexes=(e,t=[])=>{if(!e)return t;const i=(e,t)=>{for(let s=0;s<e.length;s++){const a=e[s];t.push(a.name),a.children&&i(a.children,t)}};i(e,t);const s=t.filter((e,i)=>t.indexOf(e)!==i);if(s.length>0)throw new Error(`duplicated indexes found on schema: ${JSON.stringify(s)}`);return t};class D{constructor(e){var i,s,a,n,r;this.destroy=()=>{this.forms.forEach(e=>e.destroy()),this.dataSubject$.unsubscribe(),this.formValidSubject$.unsubscribe(),this.submitSubject$.unsubscribe()},this.forms=new Map,this.config={defaultAPIdebounceTimeMS:Number(null===(i=null==e?void 0:e.config)||void 0===i?void 0:i.defaultAPIdebounceTimeMS)?Number(null===(s=null==e?void 0:e.config)||void 0===s?void 0:s.defaultAPIdebounceTimeMS):v,defaultStateRefreshTimeMS:Number(null===(a=null==e?void 0:e.config)||void 0===a?void 0:a.defaultStateRefreshTimeMS)?Number(null===(n=null==e?void 0:e.config)||void 0===n?void 0:n.defaultStateRefreshTimeMS):100,defaultLogVerbose:(null===(r=null==e?void 0:e.config)||void 0===r?void 0:r.defaultLogVerbose)?e.config.defaultLogVerbose:g},this.dataSubject$=new t,this.formValidSubject$=new t,this.submitSubject$=new t,this.mappers=null==e?void 0:e.mappers}createFormWithIndex({index:e,mappers:t}){this.addForm({key:e,params:{index:e,mappers:t,config:this.config}})}addForm({key:e,params:t}){this.checkIndexes({key:e});const i=new L(Object.assign(Object.assign({},t),{dataSubject$:this.dataSubject$,formValidSubject$:this.formValidSubject$,submitSubject$:this.submitSubject$}));i.config||(i.config=this.config),this.forms.set(e,i)}getForm({key:e}){return this.forms.get(e)}removeForm({key:e}){var t;null===(t=this.forms.get(e))||void 0===t||t.destroy(),this.forms.delete(e)}removeField({formIndex:e,fieldIndex:t}){const i=this.forms.get(e);null==i||i.removeField({key:t}),0===(null==i?void 0:i.fields.size)&&this.removeForm({key:e})}checkIndexes({key:e}){if(this.forms.has(e))throw new Error(`duplicate index ${e} on form group`)}printFormGroupInstance(){console.table(this.forms)}submitMultipleFormsByIndex(e,t){let i=!0,s={},a={},n=[];e.forEach(e=>{var t,r;null===(t=this.forms.get(e))||void 0===t||t.submit();const l=null===(r=this.forms.get(e))||void 0===r?void 0:r.formValuesStateSubject$.value,o="object"==typeof(null==l?void 0:l.metadata)&&null!==l.metadata?l.metadata:{};i=i&&((null==l?void 0:l.isValid)||!1),s=Object.assign(Object.assign({},s),(null==l?void 0:l.values)||{}),a=Object.assign(Object.assign({},a),o),n=[...n,...(null==l?void 0:l.erroredFields)||[]]}),i&&t&&t({erroredFields:n,isValid:i,values:s,metadata:a})}onDataSubscription({ids:e,callback:t}){return this.dataSubject$.pipe(r(({formIndex:t})=>e.includes(t)),s(({event:e,formIndex:t})=>`${e}.${t}`),a(e=>e.pipe(n(this.config.defaultStateRefreshTimeMS))),u(({fieldIndex:t,formIndex:i})=>e.reduce((e,s)=>{const a=this.forms.get(s);return a&&(e[s]={formId:i,formField:t,values:a.formValuesStateSubject$.value}),e},{}))).subscribe(t)}onValidSubscription({ids:e,callback:t}){return this.formValidSubject$.pipe(r(({formIndex:t})=>e.includes(t)),s(({formIndex:e})=>e),a(e=>e.pipe(n(0))),o({fieldTrigger:null}),u(()=>({groupValid:e.every(e=>{var t;return!this.forms.get(e)||(null===(t=this.forms.get(e))||void 0===t?void 0:t.valid)}),forms:e.reduce((e,t)=>{const i=this.forms.get(t);return i&&(e[t]=i.valid),e},{})}))).subscribe(t)}onSubmitSubscription({ids:e,callback:t}){return this.submitSubject$.pipe(r(({formIndex:t})=>e.includes(t)),u(()=>e.reduce((e,t)=>{const i=this.forms.get(t);return i&&(e[t]=i.formValuesStateSubject$.value),e},{}))).subscribe(t)}}export{L as FormCore,M as FormField,D as FormGroup,h as TMutationEnum,E as formatterRegistry,O as maskRegistry,x as registerFormatters,_ as registerMasks,I as registerValidations,j as validationRegistry};

package/package.json

@@ -1,10 +1,42 @@
 {
   "name": "@bolttech/form-engine-core",
-  "version": "1.0.10",
+  "version": "1.1.0",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.esm.js",
+      "default": "./index.esm.js"
+    },
+    "./lite": {
+      "types": "./lite.d.ts",
+      "import": "./lite.esm.js",
+      "default": "./lite.esm.js"
+    },
+    "./credit-card": {
+      "types": "./credit-card.d.ts",
+      "import": "./credit-card.esm.js",
+      "default": "./credit-card.esm.js"
+    },
+    "./document": {
+      "types": "./document.d.ts",
+      "import": "./document.esm.js",
+      "default": "./document.esm.js"
+    },
+    "./currency": {
+      "types": "./currency.d.ts",
+      "import": "./currency.esm.js",
+      "default": "./currency.esm.js"
+    },
+    "./date": {
+      "types": "./date.d.ts",
+      "import": "./date.esm.js",
+      "default": "./date.esm.js"
+    }
+  },
   "dependencies": {
     "@gaignoux/currency": "^1.1.0",
     "credit-card-type": "^10.0.0",
-    "lodash": "4.18.1",
     "rxjs": "7.8.2"
   },
   "module": "./index.esm.js",

package/src/constants/constants.d.ts

@@ -0,0 +1,11 @@
+import { IFormField } from "../managers/field";
+declare const DEFAULT_API_DEBOUNCE_TIME = 1000;
+declare const DEFAULT_STATE_REFRESH_TIME = 100;
+declare const TEMPLATE_REGEX_STRING_CONCATENATION_DETECTOR: RegExp;
+declare const TEMPLATE_REGEX_DELIMITATOR: RegExp;
+declare const TEMPLATE_REGEX_OPERATOR_SPLITTER: RegExp;
+declare const TEMPLATE_REGEX_OPERATOR_MATCHER: RegExp;
+declare const TEMPLATE_AVALIABLE_SCOPES: readonly ["fields", "iVars", "form"];
+declare const ALLOWED_RESET_PROPS_MUTATIONS: (keyof Pick<IFormField, "api" | "apiSchema" | "props" | "validations" | "visibilityConditions" | "resetValues">)[];
+declare const DEFAULT_LOG_VERBOSE = false;
+export { DEFAULT_API_DEBOUNCE_TIME, DEFAULT_STATE_REFRESH_TIME, DEFAULT_LOG_VERBOSE, TEMPLATE_REGEX_STRING_CONCATENATION_DETECTOR, TEMPLATE_REGEX_DELIMITATOR, TEMPLATE_REGEX_OPERATOR_SPLITTER, TEMPLATE_REGEX_OPERATOR_MATCHER, TEMPLATE_AVALIABLE_SCOPES, ALLOWED_RESET_PROPS_MUTATIONS, };

package/src/formatters/creditCard.d.ts

@@ -0,0 +1,23 @@
+import { TFormatters } from '../types/schema';
+/**
+ * Formats a credit card number by adding gaps based on the card type.
+ *
+ * @param {unknown} value - The input value to be formatted, expected to be a string representing a credit card number.
+ * @param {TFormatters} formatters - An object containing formatting options.
+ * @param {boolean} formatters.gapsCreditCard - A flag indicating whether to apply credit card gap formatting.
+ * @returns {unknown} - The formatted credit card number with appropriate gaps, or the original value if formatting is not applied.
+ *
+ * @example
+ * ```typescript
+ * const formatters = { gapsCreditCard: true };
+ * const result = gapsCreditCard('4111111111111111', formatters);
+ * console.log(result); // "4111 1111 1111 1111" (formatted based on card type, e.g., Visa)
+ * ```
+ * @example
+ * ```typescript
+ * const formatters = { gapsCreditCard: false };
+ * const result = gapsCreditCard('4111111111111111', formatters);
+ * console.log(result); // "4111111111111111" (no formatting applied)
+ * ```
+ */
+export declare const gapsCreditCard: (value: unknown, formatters: TFormatters) => unknown;

package/src/formatters/custom.d.ts

@@ -0,0 +1,29 @@
+import { TFormatters } from '../types/schema';
+/**
+ * Applies a custom callback function to format a value.
+ *
+ * @param {unknown} value - The input value to be formatted.
+ * @param {TFormatters} formatters - An object containing formatting options.
+ * @param {(value: unknown) => unknown} formatters.callback - A custom callback function to apply to the value.
+ * @returns {unknown} - The value after applying the custom callback function, or the original value if no callback is provided.
+ *
+ * @example
+ * ```typescript
+ * const formatters = { callback: (val) => `Formatted: ${val}` };
+ * const result = callback('example', formatters);
+ * console.log(result); // "Formatted: example"
+ * ```
+ * @example
+ * ```typescript
+ * const formatters = { callback: (val) => val.toString().toUpperCase() };
+ * const result = callback('example', formatters);
+ * console.log(result); // "EXAMPLE"
+ * ```
+ * @example
+ * ```typescript
+ * const formatters = { callback: null };
+ * const result = callback('example', formatters);
+ * console.log(result); // "example" (no formatting applied)
+ * ```
+ */
+export declare const callback: (value: unknown, formatters: TFormatters) => unknown;

package/src/formatters/handler.d.ts

@@ -0,0 +1,2 @@
+import { TFormatters } from '../types/schema';
+export declare const formatters: Record<keyof TFormatters, (value: unknown, formatters?: TFormatters) => unknown>;

package/src/formatters/regex.d.ts

@@ -0,0 +1,47 @@
+import { TFormatters } from '../types/schema';
+/**
+ * Removes all non-numeric characters from a string.
+ *
+ * @param value - The value to be processed.
+ * @returns The processed value with only numbers.
+ *
+ * @example
+ * ```typescript
+ * import { onlyNumbers } from './path/to/formatterFunctions';
+ *
+ * const processedValue = onlyNumbers('abc123def456');
+ * console.log(processedValue); // Output: '123456'
+ * ```
+ */
+export declare const onlyNumbers: (value: unknown) => string;
+/**
+ * Removes all non-letter characters from a string.
+ *
+ * @param value - The value to be processed.
+ * @returns The processed value with only letters.
+ *
+ * @example
+ * ```typescript
+ * import { onlyLetters } from './path/to/formatterFunctions';
+ *
+ * const processedValue = onlyLetters('abc123def456');
+ * console.log(processedValue); // Output: 'abcdef'
+ * ```
+ */
+export declare const onlyLetters: (value: unknown) => string;
+/**
+ * Applies a regular expression pattern to remove matching substrings from a string.
+ *
+ * @param value - The value to be processed.
+ * @param formatters - An object containing formatting options.
+ * @returns The processed value with matched substrings removed.
+ *
+ * @example
+ * ```typescript
+ * import { regex } from './path/to/formatterFunctions';
+ *
+ * const processedValue = regex('abc123def456', { regex: '\\d+' });
+ * console.log(processedValue); // Output: 'abcdef'
+ * ```
+ */
+export declare const regex: (value: unknown, formatters: TFormatters) => unknown;

package/src/formatters/splitter.d.ts

@@ -0,0 +1,17 @@
+import { TFormatters } from '../types/schema';
+/**
+ * Splits a string by inserting specified values at given positions.
+ *
+ * @param value - The value to be processed.
+ * @param formatters - An object containing formatting options.
+ * @returns The processed value with splitters applied.
+ *
+ * @example
+ * ```typescript
+ * import { splitter } from './path/to/formatterFunctions';
+ *
+ * const processedValue = splitter('HelloWorld', { splitter: [{ position: 5, value: '_' }] });
+ * console.log(processedValue); // Output: 'Hello_World'
+ * ```
+ */
+export declare const splitter: (value: unknown, formatters: TFormatters) => unknown;

package/src/formatters/string.d.ts

@@ -0,0 +1,88 @@
+import { TFormatters } from '../types/schema';
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * @param value - The value to be capitalized.
+ * @returns The value with the first letter capitalized.
+ *
+ * @example
+ * ```typescript
+ * import { capitalize } from './path/to/formatterFunctions';
+ *
+ * const capitalizedValue = capitalize('hello world');
+ * console.log(capitalizedValue); // Output: 'Hello world'
+ * ```
+ */
+export declare const capitalize: (value: unknown) => string;
+/**
+ * Converts a string to uppercase.
+ *
+ * @param value - The value to be converted.
+ * @returns The value in uppercase.
+ *
+ * @example
+ * ```typescript
+ * import { uppercase } from './path/to/formatterFunctions';
+ *
+ * const uppercasedValue = uppercase('hello world');
+ * console.log(uppercasedValue); // Output: 'HELLO WORLD'
+ * ```
+ */
+export declare const uppercase: (value: unknown) => string;
+/**
+ * Formats a string as a float number with a specific precision and decimal separator.
+ *
+ * @param value - The value to be formatted.
+ * @param formatters - An object containing formatting options.
+ * @returns The formatted float number.
+ *
+ * @example
+ * ```typescript
+ * import { onlyFloatNumber } from './path/to/formatterFunctions';
+ *
+ * const formattedNumber = onlyFloatNumber('1234567.89', { onlyFloatNumber: { precision: 2, decimal: '.' } });
+ * console.log(formattedNumber); // Output: '1234567.89'
+ * ```
+ */
+export declare const onlyFloatNumber: (value: unknown, formatters: TFormatters) => unknown;
+/**
+ * Trims whitespace from the beginning and end of a string.
+ *
+ * @param value - The value to be trimmed.
+ * @param formatters - An object containing formatting options.
+ * @returns The trimmed value.
+ *
+ * @example
+ * ```typescript
+ * import { trim } from './path/to/formatterFunctions';
+ *
+ * const trimmedValue = trim('   hello world   ');
+ * console.log(trimmedValue); // Output: 'hello world'
+ * ```
+ */
+export declare const trim: (value: unknown, formatters?: TFormatters) => unknown;
+/**
+ * Truncates the input value to a specified maximum length if necessary.
+ *
+ * @param {string | number} value - The input value to be formatted.
+ * @param {TFormatters} formatters - An object containing formatting options.
+ * @param {number} formatters.maxLength - The maximum allowed length for the input value.
+ * @returns {string | number} - The formatted value truncated to the maximum length, if applicable.
+ *
+ * @example
+ * ```typescript
+ * const result = maxLength('Hello, World!', { maxLength: 5 });
+ * console.log(result); // "Hello"
+ * ```
+ * @example
+ * ```typescript
+ * const result = maxLength(123456789, { maxLength: 4 });
+ * console.log(result); // "1234"
+ * ```
+ * @example
+ * ```typescript
+ * const result = maxLength('Short', { maxLength: 10 });
+ * console.log(result); // "Short" (no truncation since input is shorter than maxLength)
+ * ```
+ */
+export declare const maxLength: (value: string | number | null | undefined, formatters: TFormatters) => string | number | null | undefined;

package/src/helpers/SafeSubject.d.ts

@@ -0,0 +1,21 @@
+import { BehaviorSubject, Subject } from 'rxjs';
+/**
+ * Custom RXJS Subject to gracefully handle errors on unsubscribed Subjects
+ * that were unmounted due to adapter external handling such as visibility
+ */
+declare class SafeSubject<T> extends Subject<T> {
+    private isMounted;
+    constructor(isMounted: () => boolean);
+    next(value: T): void;
+}
+/**
+ * Custom RXJS BehaviourSubject to gracefully handle errors on unsubscribed Subjects
+ * since its fire and forget, no mount status needed to check if its available or not
+ */
+declare class SafeBehaviourSubject<T> extends BehaviorSubject<T> {
+    defaultValue: T;
+    constructor(value: T);
+    next(value: T): void;
+    get value(): T;
+}
+export { SafeSubject, SafeBehaviourSubject };

package/src/helpers/creditCard.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Represents the properties of a credit card type.
+ */
+export interface ICreditCardType {
+    /**
+     * A human-readable name for the credit card type.
+     * For example, "Visa", "Mastercard", "American Express", etc.
+     */
+    niceType: string;
+    /**
+     * A unique identifier for the credit card type.
+     * Typically, follows industry standards such as "visa", "mastercard", "amex", etc.
+     */
+    type: string;
+    /**
+     * An array of patterns (regular expressions) that match valid card numbers for this type.
+     * Each pattern corresponds to a specific length of card number.
+     */
+    patterns: number[] | [number[]];
+    /**
+     * An array representing the positions in the card number where spaces (gaps) should be added
+     * to format the number nicely. These positions are counted from the beginning of the number.
+     */
+    gaps: number[];
+    /**
+     * An array of possible lengths for valid card numbers of this type.
+     * Typically, this array contains only one element, but some card types may have multiple lengths.
+     */
+    lengths: number[];
+    /**
+     * Information about the card's security code (CVV/CVC/CID).
+     */
+    code: {
+        /**
+         * The size (length) of the security code for this card type.
+         */
+        size: number;
+        /**
+         * A descriptive name for the security code, such as "CVV" or "CVC".
+         */
+        name: string;
+    };
+    /**
+     * An optional value representing the match strength of the card type detection.
+     * Higher values indicate stronger matches, while lower values indicate weaker matches.
+     * This property is typically provided by the credit card type detection library.
+     */
+    matchStrength?: number;
+}
+/**
+ * Represents the return type of the `getTypeCard` function.
+ */
+export type TGetTypeCard = [ICreditCardType, string];
+/**
+ * Retrieves the type of the credit card and the raw value without spaces.
+ *
+ * @param value - The credit card number as a string.
+ * @param availableOptions - An optional array of credit card types to consider.
+ * @returns An array containing the detected credit card type and the raw value without spaces.
+ *
+ * @example
+ * ```typescript
+ * import { getTypeCard } from './path/to/helperFunctions';
+ *
+ * const [creditCardType, rawValue] = getTypeCard('4111 1111 1111 1111');
+ * console.log(creditCardType); // Output: { niceType: 'Visa', type: 'visa', ... }
+ * console.log(rawValue); // Output: '4111111111111111'
+ * ```
+ */
+export declare const getTypeCard: (value: string, availableOptions?: string[] | boolean) => TGetTypeCard;
+/**
+ * Formats a credit card number according to its type's gaps and lengths.
+ *
+ * @param value - The credit card number as a string.
+ * @param type - The type of the credit card.
+ * @returns The formatted credit card number.
+ */
+export declare const formatValue: (value: string, type: ICreditCardType) => string;
+/**
+ * Formats a date string by adding a prefix and/or trimming the string based on its length.
+ *
+ * @param value - The date string to be formatted.
+ * @param end - The ending index to slice the string to.
+ * @param prefix - The prefix to add between date components.
+ * @returns The formatted date string.
+ *
+ * @example
+ * ```typescript
+ * import { formatDateCard } from './path/to/helperFunctions';
+ *
+ * const formattedDate = formatDateCard('1223', 4, '/');
+ * console.log(formattedDate); // Output: '12/23'
+ * ```
+ */
+export declare const formatDateCard: (value: string, end?: number, prefix?: string) => string;

package/src/helpers/helpers.d.ts

@@ -0,0 +1,66 @@
+import { TApiResponsePayload } from '../types/schema';
+import { TSubscribedTemplates, TTemplateAvaliableScopes } from '../types/template';
+/**
+ * Makes an HTTP request using the Fetch API.
+ * Works in both browser and server (Node 18+) environments.
+ *
+ * @param {string} method - The HTTP method (GET, POST, PUT, DELETE, etc.).
+ * @param {string} url - The URL to which the request is sent.
+ * @param {Record<string, string>} [headers] - Optional request headers.
+ * @param {Record<string,unknown>} [body] - Optional object body.
+ * @param {Record<string, string>} [queryParams] - Optional query parameters.
+ * @returns {Promise<TApiResponsePayload>} A promise that resolves with the response text and status.
+ *
+ * @example
+ * ```typescript
+ * const response = await makeRequest('GET', 'https://api.example.com/data');
+ * ```
+ */
+declare function makeRequest(method: string, url: string, headers?: Record<string, string>, body?: Record<string, unknown>, queryParams?: Record<string, string>): Promise<TApiResponsePayload>;
+/**
+ * Extracts keys enclosed in `${}` from a given expression.
+ *
+ * @param {string} expression - The expression to extract keys from.
+ * @returns {
+ * originFieldKeys: string[];
+ * originPropertyKeys: string[];
+ * } An object containing the field names and properties from the template expression.
+ *
+ * @example
+ * ```typescript
+ * const keys = extractFieldKeys('Hello ${name.value}, your age is ${age.props.label}.');
+ * // keys will be {originFieldKeys:['name', 'age'],originPropertyKeys:[value,props]}
+ * ```
+ */
+declare function extractFieldKeys(expression: string): {
+    originScopeKeys: TTemplateAvaliableScopes[];
+    originFieldKeys: string[];
+    originPropertyKeys: string[];
+};
+/**
+ * Traverses an object and extracts expressions containing keys.
+ *
+ * @param {any} obj - The object to traverse.
+ * @param {string} [path] - Optional path within the object (used internally during recursion).
+ * @returns {TSubscribedTemplates[]} An array of extracted expressions along with their keys and paths.
+ *
+ * @example
+ * ```typescript
+ * const data = {
+ *   user: {
+ *     name: 'John',
+ *     age: 30,
+ *     address: {
+ *       street: '123 Main St',
+ *       city: 'Example City'
+ *     }
+ *   },
+ *   message: 'Hello ${user.name}, your age is ${user.age}.'
+ * };
+ *
+ * const expressions = traverseObject(data);
+ * // expressions will contain an array of objects with origin expressions, field keys, and destination paths.
+ * ```
+ */
+declare function traverseObject(element: any, path?: string): TSubscribedTemplates[];
+export { makeRequest, traverseObject, extractFieldKeys };

package/src/helpers/lodash-replacements.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Lightweight replacements for lodash functions used in form-engine-core.
+ * These cover the specific usage patterns in this codebase.
+ */
+/**
+ * Deep clones a value. Handles objects, arrays, dates, and primitives.
+ * Equivalent to lodash/cloneDeep for the patterns used in this codebase.
+ */
+export declare function cloneDeep<T>(value: T): T;
+/**
+ * Gets the value at a path of an object. If the resolved value is undefined,
+ * the defaultValue is returned in its place.
+ * Equivalent to lodash/get.
+ */
+export declare function get(obj: any, path: string | (string | number)[], defaultValue?: any): any;
+/**
+ * Sets the value at a path of an object. If a portion of the path doesn't exist,
+ * it's created. Arrays are created for numeric keys, objects otherwise.
+ * Equivalent to lodash/set.
+ */
+export declare function set(obj: any, path: string | (string | number)[], value: any): any;
+/**
+ * Performs a deep comparison between two values to determine if they are equivalent.
+ * Equivalent to lodash/isEqual for the patterns used in this codebase.
+ */
+export declare function isEqual(a: any, b: any): boolean;
+/**
+ * Checks if value is null or undefined.
+ * Equivalent to lodash/isNil.
+ */
+export declare function isNil(value: any): value is null | undefined;
+/**
+ * Checks if value is classified as a Function object.
+ * Equivalent to lodash/isFunction.
+ */
+export declare function isFunction(value: any): value is (...args: any[]) => any;
+/**
+ * Checks if value is classified as a Number primitive or object.
+ * Equivalent to lodash/isNumber.
+ */
+export declare function isNumber(value: any): value is number;

package/src/helpers/validation.d.ts

@@ -0,0 +1,28 @@
+import { TSchemaValidation, TValidationMethods } from '../types/schema';
+import { TValidationHandler } from '../types/utility';
+import { TFormValues } from '../types/form';
+/**
+ * @internal
+ * Handles the validation of a given value based on specified validation methods and rules.
+ *
+ * @param {string | number | boolean | unknown} value - The value to be validated.
+ * @param {TSchemaValidation} validations - The schema validations to be applied.
+ * @param {TValidationHandler} methods - The validation handler methods.
+ * @param {keyof TValidationMethods} key - The specific key of the validation method to be used.
+ * @returns {boolean} - Returns true if the value passes the validation, otherwise false.
+ *
+ * @example
+ * const value = 'example@example.com';
+ * const validations = {
+ *   required: true,
+ *   customName: { email: true }
+ * };
+ * const methods = {
+ *   email: (value) => /\S+@\S+\.\S+/.test(value)
+ * };
+ * const key = 'required';
+ *
+ * const isValid = handleValidation(value, validations, methods, key);
+ * console.log(isValid); // Output: true
+ */
+export default function handleValidation(value: string | number | boolean | unknown, validations: TSchemaValidation, methods: TValidationHandler, key: keyof TValidationMethods, formValues: TFormValues<unknown>): boolean;

package/src/index.d.ts

@@ -0,0 +1,15 @@
+export * from './types/event';
+export * from './types/form';
+export * from './types/schema';
+export * from './types/template';
+export * from './types/mapper';
+export * from './types/utility';
+export * from './interfaces/schema';
+export * from './interfaces/state';
+export * from './managers/form';
+export * from './managers/formGroup';
+export * from './managers/field';
+export { registerValidations, registerFormatters, registerMasks, validationRegistry, formatterRegistry, maskRegistry } from './registry';
+import './validations/handler';
+import './formatters/handler';
+import './masks/handler';