form-payload 1.6.0 → 1.7.1

package/src/packages/get-form-control-payload/get-form-control-payload.js

@@ -1,27 +1,28 @@
-import { ControlType } from '../../libs/enums/enums.js';
+import { ControlElementType } from '../../libs/enums/enums.js';
 import { FormPayloadError } from '../../libs/exceptions/exceptions.js';
 import {
-	getCheckboxValue,
-	getDatetimeLocalValue,
-	getFieldsetValue,
-	getFormControlValue,
-	getInputDateValue,
-	getInputEmailValue,
-	getInputFileValue,
-	getInputNumericValue,
-	getMultiSelectValues,
-} from './helpers/helpers.js';
+	getCheckboxControlElementValue,
+	getControlElementValue,
+	getDateControlElementValue,
+	getDatetimeLocaControlElementValue,
+	getEmailControlElementValue,
+	getFieldsetControlElementValue,
+	getFileControlElementValue,
+	getMultiselectControlElementValue,
+	getNumericControlElementValue,
+	getRadioControlElementValue,
+} from './libs/helpers/helpers.js';
 
 /** @typedef {import('../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
 
 /**
  * @template {unknown} T
- * @param {HTMLFormOperationalControlElement} controlNode
+ * @param {HTMLFormOperationalControlElement} controlElement
  * @returns {T}
  * @throws {FormPayloadError}
  */
-const getFormControlPayload = (controlNode) => {
-	const hasType = 'type' in controlNode;
+const getFormControlPayload = (controlElement) => {
+	const hasType = 'type' in controlElement;
 
 	if (!hasType) {
 		throw new FormPayloadError({
@@ -29,90 +30,102 @@ const getFormControlPayload = (controlNode) => {
 		});
 	}
 
-	switch (controlNode.type) {
-		case ControlType.TEXT:
-		case ControlType.PASSWORD:
-		case ControlType.SEARCH:
-		case ControlType.URL:
-		case ControlType.TEL:
-		case ControlType.COLOR:
-		case ControlType.RADIO:
-		case ControlType.HIDDEN:
-		case ControlType.TEXTAREA:
-		case ControlType.SELECT_ONE:
-		case ControlType.OUTPUT: {
+	switch (controlElement.type) {
+		case ControlElementType.TEXT:
+		case ControlElementType.PASSWORD:
+		case ControlElementType.SEARCH:
+		case ControlElementType.URL:
+		case ControlElementType.TEL:
+		case ControlElementType.COLOR:
+		case ControlElementType.HIDDEN:
+		case ControlElementType.TEXTAREA:
+		case ControlElementType.SELECT_ONE:
+		case ControlElementType.OUTPUT: {
 			return /** @type {T} */ (
-				getFormControlValue(
+				getControlElementValue(
 					/**
 					 * @type {HTMLInputElement
 					 * 	| HTMLOutputElement
 					 * 	| HTMLTextAreaElement
 					 * 	| HTMLSelectElement}
-					 */ (controlNode),
+					 */ (controlElement),
 				)
 			);
 		}
-		case ControlType.EMAIL: {
+		case ControlElementType.EMAIL: {
 			return /** @type {T} */ (
-				getInputEmailValue(
-					/** @type {HTMLInputElement} */ (controlNode),
+				getEmailControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
 				)
 			);
 		}
-		case ControlType.NUMBER:
-		case ControlType.RANGE: {
+		case ControlElementType.RADIO: {
 			return /** @type {T} */ (
-				getInputNumericValue(
-					/** @type {HTMLInputElement} */ (controlNode),
+				getRadioControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
 				)
 			);
 		}
-		case ControlType.CHECKBOX: {
+		case ControlElementType.NUMBER:
+		case ControlElementType.RANGE: {
 			return /** @type {T} */ (
-				getCheckboxValue(/** @type {HTMLInputElement} */ (controlNode))
+				getNumericControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
+				)
 			);
 		}
-		case ControlType.DATE:
-		case ControlType.TIME:
-		case ControlType.MONTH:
-		case ControlType.WEEK: {
+		case ControlElementType.CHECKBOX: {
 			return /** @type {T} */ (
-				getInputDateValue(/** @type {HTMLInputElement} */ (controlNode))
+				getCheckboxControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
+				)
 			);
 		}
-		case ControlType.DATETIME_LOCAL: {
+		case ControlElementType.DATE:
+		case ControlElementType.TIME:
+		case ControlElementType.MONTH:
+		case ControlElementType.WEEK: {
 			return /** @type {T} */ (
-				getDatetimeLocalValue(
-					/** @type {HTMLInputElement} */ (controlNode),
+				getDateControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
 				)
 			);
 		}
-		case ControlType.FILE: {
+		case ControlElementType.DATETIME_LOCAL: {
 			return /** @type {T} */ (
-				getInputFileValue(/** @type {HTMLInputElement} */ (controlNode))
+				getDatetimeLocaControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
+				)
+			);
+		}
+		case ControlElementType.FILE: {
+			return /** @type {T} */ (
+				getFileControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
+				)
 			);
 		}
-		case ControlType.SELECT_MULTIPLE: {
+		case ControlElementType.SELECT_MULTIPLE: {
 			return /** @type {T} */ (
-				getMultiSelectValues(
-					/** @type {HTMLSelectElement} */ (controlNode),
+				getMultiselectControlElementValue(
+					/** @type {HTMLSelectElement} */ (controlElement),
 				)
 			);
 		}
-		case ControlType.FIELDSET: {
+		case ControlElementType.FIELDSET: {
 			return /** @type {T} */ (
-				getFieldsetValue(
+				getFieldsetControlElementValue(
 					getFormControlPayload,
-					/** @type {HTMLFieldSetElement} */ (controlNode),
+					/** @type {HTMLFieldSetElement} */ (controlElement),
 				)
 			);
 		}
 	}
 
 	throw new FormPayloadError({
-		message: `Unsupported control element type – ${controlNode.type}.`,
+		message: `Unsupported control element type – ${controlElement.type}.`,
 	});
 };
 
-export { getFormControlsPayload } from './helpers/helpers.js';
+export { getFormControlElementsPayload } from './libs/helpers/helpers.js';
 export { getFormControlPayload };

package/src/packages/get-form-control-payload/libs/helpers/check-has-value-as-array/check-has-value-as-array.helper.d.ts

@@ -0,0 +1,8 @@
+export type HTMLFormOperationalControlElement = import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement;
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
+/**
+ * @param {HTMLFormOperationalControlElement} element
+ * @returns {boolean}
+ */
+export function checkHasValueAsArray(element: HTMLFormOperationalControlElement): boolean;
+//# sourceMappingURL=check-has-value-as-array.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/check-has-value-as-array/check-has-value-as-array.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-has-value-as-array.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/check-has-value-as-array/check-has-value-as-array.helper.js"],"names":[],"mappings":"gDAKc,OAAO,oCAAoC,EAAE,iCAAiC;AAA5F,kIAAkI;AAElI;;;GAGG;AACH,8CAHW,iCAAiC,GAC/B,OAAO,CAYnB"}

package/src/packages/get-form-control-payload/libs/helpers/check-has-value-as-array/check-has-value-as-array.helper.js

@@ -0,0 +1,24 @@
+import {
+	VALUE_AS_ARRAY_CUSTOM_CONTROL_ELEMENT_TYPES,
+	VALUE_AS_ARRAY_IDENTIFIER,
+} from '../../../../../libs/constants/constants.js';
+
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
+
+/**
+ * @param {HTMLFormOperationalControlElement} element
+ * @returns {boolean}
+ */
+const checkHasValueAsArray = (element) => {
+	const hasValueAsArrayIdentifier = element.name.endsWith(
+		VALUE_AS_ARRAY_IDENTIFIER,
+	);
+	const isValueAsArrayCustomControlElementType =
+		/** @type {readonly string[]} */ (
+			VALUE_AS_ARRAY_CUSTOM_CONTROL_ELEMENT_TYPES
+		).includes(element.type);
+
+	return hasValueAsArrayIdentifier && isValueAsArrayCustomControlElementType;
+};
+
+export { checkHasValueAsArray };

package/src/packages/get-form-control-payload/libs/helpers/check-is-refer-to-another-element/check-is-refer-to-another-element.helper.d.ts

@@ -0,0 +1,9 @@
+export type HTMLFormOperationalControlElement = import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement;
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
+/**
+ * @param {HTMLFormOperationalControlElement} currentElement
+ * @param {HTMLFormOperationalControlElement[]} checkedElements
+ * @returns {boolean}
+ */
+export function checkIsReferToAnotherElement(currentElement: HTMLFormOperationalControlElement, checkedElements: HTMLFormOperationalControlElement[]): boolean;
+//# sourceMappingURL=check-is-refer-to-another-element.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/check-is-refer-to-another-element/check-is-refer-to-another-element.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-is-refer-to-another-element.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/check-is-refer-to-another-element/check-is-refer-to-another-element.helper.js"],"names":[],"mappings":"gDAAc,OAAO,oCAAoC,EAAE,iCAAiC;AAA5F,kIAAkI;AAElI;;;;GAIG;AACH,6DAJW,iCAAiC,mBACjC,iCAAiC,EAAE,GACjC,OAAO,CAenB"}

package/src/packages/get-form-control-payload/libs/helpers/check-is-refer-to-another-element/check-is-refer-to-another-element.helper.js

@@ -0,0 +1,23 @@
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
+
+/**
+ * @param {HTMLFormOperationalControlElement} currentElement
+ * @param {HTMLFormOperationalControlElement[]} checkedElements
+ * @returns {boolean}
+ */
+const checkIsReferToAnotherElement = (currentElement, checkedElements) => {
+	return checkedElements.some((checkedElement) => {
+		const hasElements =
+			'elements' in checkedElement && checkedElement.elements.length > 0;
+
+		if (!hasElements) {
+			return false;
+		}
+
+		return [...checkedElement.elements].some((element) =>
+			element.contains(currentElement),
+		);
+	});
+};
+
+export { checkIsReferToAnotherElement };

package/src/packages/get-form-control-payload/libs/helpers/get-checkbox-control-element-value/get-checkbox-control-element-value.helper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {HTMLInputElement} element
+ * @returns {boolean | string[]}
+ */
+export function getCheckboxControlElementValue(element: HTMLInputElement): boolean | string[];
+//# sourceMappingURL=get-checkbox-control-element-value.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/get-checkbox-control-element-value/get-checkbox-control-element-value.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-checkbox-control-element-value.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/get-checkbox-control-element-value/get-checkbox-control-element-value.helper.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wDAHW,gBAAgB,GACd,OAAO,GAAG,MAAM,EAAE,CAU9B"}

package/src/packages/get-form-control-payload/{helpers/get-checkbox-value/get-checkbox-value.helper.js → libs/helpers/get-checkbox-control-element-value/get-checkbox-control-element-value.helper.js}

@@ -1,10 +1,10 @@
-import { VALUE_AS_ARRAY_IDENTIFIER } from '../../../../libs/constants/constants.js';
+import { VALUE_AS_ARRAY_IDENTIFIER } from '../../../../../libs/constants/constants.js';
 
 /**
  * @param {HTMLInputElement} element
  * @returns {boolean | string[]}
  */
-const getCheckboxValue = (element) => {
+const getCheckboxControlElementValue = (element) => {
 	const hasArrayValue = element.name.endsWith(VALUE_AS_ARRAY_IDENTIFIER);
 
 	if (hasArrayValue) {
@@ -14,4 +14,4 @@ const getCheckboxValue = (element) => {
 	return element.checked;
 };
 
-export { getCheckboxValue };
+export { getCheckboxControlElementValue };

package/src/packages/get-form-control-payload/libs/helpers/get-control-element-value/get-control-element-value.helper.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @param {HTMLInputElement
+ * 	| HTMLOutputElement
+ * 	| HTMLTextAreaElement
+ * 	| HTMLSelectElement
+ * 	| RadioNodeList} element
+ * @returns {string}
+ */
+export function getControlElementValue(element: HTMLInputElement | HTMLOutputElement | HTMLTextAreaElement | HTMLSelectElement | RadioNodeList): string;
+//# sourceMappingURL=get-control-element-value.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/get-control-element-value/get-control-element-value.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-control-element-value.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/get-control-element-value/get-control-element-value.helper.js"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,gDAPW,gBAAgB,GACrB,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GACjB,aAAa,GACN,MAAM,CAIlB"}

package/src/packages/get-form-control-payload/{helpers/get-control-value/get-control-value.helper.js → libs/helpers/get-control-element-value/get-control-element-value.helper.js}

@@ -2,11 +2,12 @@
  * @param {HTMLInputElement
  * 	| HTMLOutputElement
  * 	| HTMLTextAreaElement
- * 	| HTMLSelectElement} element
+ * 	| HTMLSelectElement
+ * 	| RadioNodeList} element
  * @returns {string}
  */
-const getFormControlValue = (element) => {
+const getControlElementValue = (element) => {
 	return element.value;
 };
 
-export { getFormControlValue };
+export { getControlElementValue };

package/src/packages/get-form-control-payload/libs/helpers/get-datatime-local-control-element-value/get-datatime-local-control-element-value.helper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {HTMLInputElement} element
+ * @returns {Date}
+ */
+export function getDatetimeLocaControlElementValue(element: HTMLInputElement): Date;
+//# sourceMappingURL=get-datatime-local-control-element-value.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/get-datatime-local-control-element-value/get-datatime-local-control-element-value.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-datatime-local-control-element-value.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/get-datatime-local-control-element-value/get-datatime-local-control-element-value.helper.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,4DAHW,gBAAgB,GACd,IAAI,CAIhB"}

package/src/packages/get-form-control-payload/libs/helpers/get-datatime-local-control-element-value/get-datatime-local-control-element-value.helper.js

@@ -0,0 +1,9 @@
+/**
+ * @param {HTMLInputElement} element
+ * @returns {Date}
+ */
+const getDatetimeLocaControlElementValue = (element) => {
+	return new Date(element.value);
+};
+
+export { getDatetimeLocaControlElementValue };

package/src/packages/get-form-control-payload/libs/helpers/get-date-control-element-value/get-date-value-control-element.helper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {HTMLInputElement} element
+ * @returns {Date | null}
+ */
+export function getDateControlElementValue(element: HTMLInputElement): Date | null;
+//# sourceMappingURL=get-date-value-control-element.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/get-date-control-element-value/get-date-value-control-element.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-date-value-control-element.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/get-date-control-element-value/get-date-value-control-element.helper.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oDAHW,gBAAgB,GACd,IAAI,GAAG,IAAI,CAIvB"}

package/src/packages/get-form-control-payload/{helpers/get-input-date-value/get-input-date-value.helper.js → libs/helpers/get-date-control-element-value/get-date-value-control-element.helper.js}

@@ -2,8 +2,8 @@
  * @param {HTMLInputElement} element
  * @returns {Date | null}
  */
-const getInputDateValue = (element) => {
+const getDateControlElementValue = (element) => {
 	return element.valueAsDate;
 };
 
-export { getInputDateValue };
+export { getDateControlElementValue };

package/src/packages/get-form-control-payload/libs/helpers/get-email-control-element-value/get-email-control-element-value.helper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {HTMLInputElement} element
+ * @returns {string | string[]}
+ */
+export function getEmailControlElementValue(element: HTMLInputElement): string | string[];
+//# sourceMappingURL=get-email-control-element-value.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/get-email-control-element-value/get-email-control-element-value.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-email-control-element-value.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/get-email-control-element-value/get-email-control-element-value.helper.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,qDAHW,gBAAgB,GACd,MAAM,GAAG,MAAM,EAAE,CAW7B"}

package/src/packages/get-form-control-payload/libs/helpers/get-email-control-element-value/get-email-control-element-value.helper.js

@@ -0,0 +1,20 @@
+import { getControlElementValue } from '../get-control-element-value/get-control-element-value.helper.js';
+
+const EMAIL_SEPARATOR = /** @type {const} */ (',');
+
+/**
+ * @param {HTMLInputElement} element
+ * @returns {string | string[]}
+ */
+const getEmailControlElementValue = (element) => {
+	if (element.multiple) {
+		return element.value
+			.split(EMAIL_SEPARATOR)
+			.map((email) => email.trim())
+			.filter((email) => email !== '');
+	}
+
+	return getControlElementValue(element);
+};
+
+export { getEmailControlElementValue };

package/src/packages/get-form-control-payload/libs/helpers/get-fieldset-control-element-value/get-fieldset-control-element-value.helper.d.ts

@@ -0,0 +1,12 @@
+export type HTMLFormOperationalControlElement = import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement;
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
+/**
+ * @template {Record<string, unknown>} T
+ * @param {<T extends unknown>(
+ * 	element: HTMLFormOperationalControlElement,
+ * ) => T} getFormControlElementPayloadCallback
+ * @param {HTMLFieldSetElement} element
+ * @returns {T | [T]}
+ */
+export function getFieldsetControlElementValue<T extends Record<string, unknown>>(getFormControlElementPayloadCallback: <T_1 extends unknown>(element: HTMLFormOperationalControlElement) => T_1, element: HTMLFieldSetElement): T | [T];
+//# sourceMappingURL=get-fieldset-control-element-value.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/get-fieldset-control-element-value/get-fieldset-control-element-value.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-fieldset-control-element-value.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/get-fieldset-control-element-value/get-fieldset-control-element-value.helper.js"],"names":[],"mappings":"gDAGc,OAAO,oCAAoC,EAAE,iCAAiC;AAA5F,kIAAkI;AAElI;;;;;;;GAOG;AACH,uJALa,iCAAiC,mBAEnC,mBAAmB,WAe7B"}

package/src/packages/get-form-control-payload/libs/helpers/get-fieldset-control-element-value/get-fieldset-control-element-value.helper.js

@@ -0,0 +1,28 @@
+import { VALUE_AS_ARRAY_IDENTIFIER } from '../../../../../libs/constants/constants.js';
+import { getFormControlElementsPayload } from '../get-form-control-elements-payload/get-form-control-elements-payload.js';
+
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
+
+/**
+ * @template {Record<string, unknown>} T
+ * @param {<T extends unknown>(
+ * 	element: HTMLFormOperationalControlElement,
+ * ) => T} getFormControlElementPayloadCallback
+ * @param {HTMLFieldSetElement} element
+ * @returns {T | [T]}
+ */
+const getFieldsetControlElementValue = (
+	getFormControlElementPayloadCallback,
+	element,
+) => {
+	const fieldsetValue = getFormControlElementsPayload(
+		getFormControlElementPayloadCallback,
+		element.elements,
+	);
+
+	const hasArrayValue = element.name.endsWith(VALUE_AS_ARRAY_IDENTIFIER);
+
+	return /** @type {T} */ (hasArrayValue ? [fieldsetValue] : fieldsetValue);
+};
+
+export { getFieldsetControlElementValue };

package/src/packages/get-form-control-payload/libs/helpers/get-file-control-element-value/get-file-control-element-value.helper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {HTMLInputElement} element
+ * @returns {File[] | File | null}
+ */
+export function getFileControlElementValue(element: HTMLInputElement): File[] | File | null;
+//# sourceMappingURL=get-file-control-element-value.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/get-file-control-element-value/get-file-control-element-value.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file-control-element-value.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/get-file-control-element-value/get-file-control-element-value.helper.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oDAHW,gBAAgB,GACd,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAWhC"}

package/src/packages/get-form-control-payload/libs/helpers/get-file-control-element-value/get-file-control-element-value.helper.js

@@ -0,0 +1,16 @@
+/**
+ * @param {HTMLInputElement} element
+ * @returns {File[] | File | null}
+ */
+const getFileControlElementValue = (element) => {
+	const inputFiles = element.files ?? [];
+
+	if (element.multiple) {
+		return [...inputFiles];
+	}
+	const [file] = inputFiles;
+
+	return file ?? null;
+};
+
+export { getFileControlElementValue };

package/src/packages/get-form-control-payload/libs/helpers/get-form-control-elements-payload/get-form-control-elements-payload.d.ts

@@ -0,0 +1,14 @@
+export type HTMLFormOperationalControlElement = import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement;
+export type HTMLFormControlElement = import('../../../../../libs/types/types.js').HTMLFormControlElement;
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormControlElement} HTMLFormControlElement */
+/**
+ * @template {Record<string, unknown>} T
+ * @param {<T extends unknown>(
+ * 	element: HTMLFormOperationalControlElement,
+ * ) => T} getFormControlElementPayloadCallback
+ * @param {HTMLFormControlsCollection} elements
+ * @returns {T}
+ */
+export function getFormControlElementsPayload<T extends Record<string, unknown>>(getFormControlElementPayloadCallback: <T_1 extends unknown>(element: HTMLFormOperationalControlElement) => T_1, elements: HTMLFormControlsCollection): T;
+//# sourceMappingURL=get-form-control-elements-payload.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/get-form-control-elements-payload/get-form-control-elements-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-form-control-elements-payload.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/get-form-control-elements-payload/get-form-control-elements-payload.js"],"names":[],"mappings":"gDAQc,OAAO,oCAAoC,EAAE,iCAAiC;qCAC9E,OAAO,oCAAoC,EAAE,sBAAsB;AADjF,kIAAkI;AAClI,4GAA4G;AAE5G;;;;;;;GAOG;AACH,sJALa,iCAAiC,oBAEnC,0BAA0B,KAqFpC"}

package/src/packages/get-form-control-payload/libs/helpers/get-form-control-elements-payload/get-form-control-elements-payload.js

@@ -0,0 +1,104 @@
+import { ControlElementType } from '../../../../../libs/enums/enums.js';
+import { checkIsOnOf } from '../../../../../libs/helpers/helpers.js';
+import { checkHasValueAsArray } from '../check-has-value-as-array/check-has-value-as-array.helper.js';
+import { checkIsReferToAnotherElement } from '../check-is-refer-to-another-element/check-is-refer-to-another-element.helper.js';
+import { getControlElementValue } from '../get-control-element-value/get-control-element-value.helper.js';
+import { getOperationalControlElements } from '../get-operational-control-elements/get-operational-control-elements.helper.js';
+import { normalizeValueAsArrayControlElementName } from '../normalize-value-as-array-control-element-name/normalize-value-as-array-control-element-name.helper.js';
+
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
+/** @typedef {import('../../../../../libs/types/types.js').HTMLFormControlElement} HTMLFormControlElement */
+
+/**
+ * @template {Record<string, unknown>} T
+ * @param {<T extends unknown>(
+ * 	element: HTMLFormOperationalControlElement,
+ * ) => T} getFormControlElementPayloadCallback
+ * @param {HTMLFormControlsCollection} elements
+ * @returns {T}
+ */
+const getFormControlElementsPayload = (
+	getFormControlElementPayloadCallback,
+	elements,
+) => {
+	const controlElements = /** @type {HTMLFormControlElement[]} */ ([
+		...elements,
+	]);
+
+	const operationalControlElements =
+		getOperationalControlElements(controlElements);
+
+	const elementsValues = /** @type {T} */ ({});
+
+	for (const operationalControlElement of operationalControlElements) {
+		const isReferToAnotherElement = checkIsReferToAnotherElement(
+			operationalControlElement,
+			operationalControlElements,
+		);
+
+		if (isReferToAnotherElement) {
+			continue;
+		}
+
+		const isRadioNodeList = checkIsOnOf(
+			operationalControlElement.type,
+			ControlElementType.RADIO,
+		);
+
+		if (isRadioNodeList) {
+			const hasValue = Boolean(
+				elementsValues[operationalControlElement.name],
+			);
+
+			if (!hasValue) {
+				const key = /** @type {keyof T} */ (
+					operationalControlElement.name
+				);
+				const value = /** @type {T[keyof T]} */ (
+					getControlElementValue(
+						/** @type {RadioNodeList} */ (
+							elements.namedItem(operationalControlElement.name)
+						),
+					)
+				);
+
+				elementsValues[key] = value;
+			}
+
+			continue;
+		}
+
+		const hasValueAsArray = checkHasValueAsArray(operationalControlElement);
+
+		if (hasValueAsArray) {
+			const key = /** @type {keyof T} */ (
+				normalizeValueAsArrayControlElementName(
+					operationalControlElement,
+				)
+			);
+			const value = /** @type {T[keyof T]} */ ([
+				.../** @type {unknown[]} */ (elementsValues[key] ?? []),
+				.../** @type {unknown[]} */ (
+					getFormControlElementPayloadCallback(
+						operationalControlElement,
+					)
+				),
+			]);
+
+			elementsValues[key] = value;
+
+			continue;
+		}
+
+		const key = /** @type {keyof T} */ (operationalControlElement.name);
+		const value = /** @type {T[keyof T]} */ (
+			getFormControlElementPayloadCallback(operationalControlElement)
+		);
+
+		elementsValues[key] = value;
+	}
+
+	return elementsValues;
+};
+
+export { getFormControlElementsPayload };

package/src/packages/get-form-control-payload/libs/helpers/get-multiselect-control-type-value/get-multiselect-control-type-value.helper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {HTMLSelectElement} element
+ * @returns {string[]}
+ */
+export function getMultiselectControlElementValue(element: HTMLSelectElement): string[];
+//# sourceMappingURL=get-multiselect-control-type-value.helper.d.ts.map

package/src/packages/get-form-control-payload/libs/helpers/get-multiselect-control-type-value/get-multiselect-control-type-value.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-multiselect-control-type-value.helper.d.ts","sourceRoot":"","sources":["../../../../../../../src/packages/get-form-control-payload/libs/helpers/get-multiselect-control-type-value/get-multiselect-control-type-value.helper.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH,2DAHW,iBAAiB,GACf,MAAM,EAAE,CAIpB"}

package/src/packages/get-form-control-payload/libs/helpers/get-multiselect-control-type-value/get-multiselect-control-type-value.helper.js

@@ -0,0 +1,9 @@
+/**
+ * @param {HTMLSelectElement} element
+ * @returns {string[]}
+ */
+const getMultiselectControlElementValue = (element) => {
+	return Array.from(element.selectedOptions, (opt) => opt.value);
+};
+
+export { getMultiselectControlElementValue };

package/src/packages/get-form-control-payload/libs/helpers/get-numeric-control-element-value/get-numeric-control-element-value.helper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {HTMLInputElement} element
+ * @returns {number}
+ */
+export function getNumericControlElementValue(element: HTMLInputElement): number;
+//# sourceMappingURL=get-numeric-control-element-value.helper.d.ts.map