form-payload 1.5.0 → 1.7.0

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

@@ -1,70 +1,27 @@
-import { ControlType } from '../../libs/enums/enums.js';
+import { ControlElementType } from '../../libs/enums/enums.js';
 import { FormPayloadError } from '../../libs/exceptions/exceptions.js';
 import {
-	checkHasValueAsArray,
-	checkIsReferToAnotherNode,
-	getAllowedElements,
-	getCheckboxValue,
-	getCleanedValueAsArrayControlName,
-	getDatetimeLocalValue,
-	getFormControlValue,
-	getInputDateValue,
-	getInputEmailValue,
-	getInputFileValue,
-	getInputNumericValue,
-	getMultiSelectValues,
+	getCheckboxControlElementValue,
+	getControlElementValue,
+	getDateControlElementValue,
+	getDatetimeLocaControlElementValue,
+	getEmailControlElementValue,
+	getFieldsetControlElementValue,
+	getFileControlElementValue,
+	getMultiselectControlElementValue,
+	getNumericControlElementValue,
 } from './helpers/helpers.js';
 
-/** @typedef {import('../../libs/types/types.js').HTMLFormControlElement} HTMLFormControlElement */
 /** @typedef {import('../../libs/types/types.js').HTMLFormOperationalControlElement} HTMLFormOperationalControlElement */
 
-/**
- * @template {Record<string, unknown>} T
- * @param {...HTMLFormControlElement} controlElements
- * @returns {T}
- */
-const getFormControlsPayload = (...controlElements) => {
-	const allowedElements = getAllowedElements(controlElements);
-
-	const elementsValues = /** @type {T} */ ({});
-
-	for (const element of allowedElements) {
-		const isReferToAnotherNode = checkIsReferToAnotherNode(
-			element,
-			allowedElements,
-		);
-
-		if (isReferToAnotherNode) {
-			continue;
-		}
-
-		let key = /** @type {keyof T} */ (element.name);
-		let value = /** @type {T[keyof T]} */ (getFormControlPayload(element));
-		const hasValueAsArray = checkHasValueAsArray(element);
-
-		if (hasValueAsArray) {
-			key = getCleanedValueAsArrayControlName(element);
-
-			value = /** @type {T[keyof T]} */ ([
-				.../** @type {unknown[]} */ (elementsValues[key] ?? []),
-				.../** @type {unknown[]} */ (getFormControlPayload(element)),
-			]);
-		}
-
-		elementsValues[key] = value;
-	}
-
-	return elementsValues;
-};
-
 /**
  * @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({
@@ -72,92 +29,96 @@ 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.RADIO:
+		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.NUMBER:
+		case ControlElementType.RANGE: {
 			return /** @type {T} */ (
-				getInputNumericValue(
-					/** @type {HTMLInputElement} */ (controlNode),
+				getNumericControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
 				)
 			);
 		}
-		case ControlType.CHECKBOX: {
+		case ControlElementType.CHECKBOX: {
 			return /** @type {T} */ (
-				getCheckboxValue(/** @type {HTMLInputElement} */ (controlNode))
+				getCheckboxControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
+				)
 			);
 		}
-		case ControlType.DATE:
-		case ControlType.TIME:
-		case ControlType.MONTH:
-		case ControlType.WEEK: {
+		case ControlElementType.DATE:
+		case ControlElementType.TIME:
+		case ControlElementType.MONTH:
+		case ControlElementType.WEEK: {
 			return /** @type {T} */ (
-				getInputDateValue(/** @type {HTMLInputElement} */ (controlNode))
+				getDateControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
+				)
 			);
 		}
-		case ControlType.DATETIME_LOCAL: {
+		case ControlElementType.DATETIME_LOCAL: {
 			return /** @type {T} */ (
-				getDatetimeLocalValue(
-					/** @type {HTMLInputElement} */ (controlNode),
+				getDatetimeLocaControlElementValue(
+					/** @type {HTMLInputElement} */ (controlElement),
 				)
 			);
 		}
-		case ControlType.FILE: {
+		case ControlElementType.FILE: {
 			return /** @type {T} */ (
-				getInputFileValue(/** @type {HTMLInputElement} */ (controlNode))
+				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: {
-			const elements = [
-				.../** @type {HTMLFieldSetElement} */ (controlNode).elements,
-			];
-
+		case ControlElementType.FIELDSET: {
 			return /** @type {T} */ (
-				getFormControlsPayload(
-					.../** @type {HTMLFormControlElement[]} */ (elements),
+				getFieldsetControlElementValue(
+					getFormControlPayload,
+					/** @type {HTMLFieldSetElement} */ (controlElement),
 				)
 			);
 		}
 	}
 
 	throw new FormPayloadError({
-		message: `Unsupported control element type – ${controlNode.type}.`,
+		message: `Unsupported control element type – ${controlElement.type}.`,
 	});
 };
 
-export { getFormControlPayload, getFormControlsPayload };
+export { getFormControlElementsPayload } from './helpers/helpers.js';
+export { getFormControlPayload };

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

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

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

@@ -1,5 +1,5 @@
 import {
-	VALUE_AS_ARRAY_CUSTOM_CONTROL_TYPES,
+	VALUE_AS_ARRAY_CUSTOM_CONTROL_ELEMENT_TYPES,
 	VALUE_AS_ARRAY_IDENTIFIER,
 } from '../../../../libs/constants/constants.js';
 
@@ -10,12 +10,15 @@ import {
  * @returns {boolean}
  */
 const checkHasValueAsArray = (element) => {
-	return (
-		element.name.endsWith(VALUE_AS_ARRAY_IDENTIFIER) &&
-		/** @type {readonly string[]} */ (
-			VALUE_AS_ARRAY_CUSTOM_CONTROL_TYPES
-		).includes(element.type)
+	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/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/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/helpers/check-is-refer-to-another-element/check-is-refer-to-another-element.helper.js"],"names":[],"mappings":"gDAAc,OAAO,iCAAiC,EAAE,iCAAiC;AAAzF,+HAA+H;AAE/H;;;;GAIG;AACH,6DAJW,iCAAiC,mBACjC,iCAAiC,EAAE,GACjC,OAAO,CAenB"}

package/src/packages/get-form-control-payload/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/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/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/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 → get-checkbox-control-element-value/get-checkbox-control-element-value.helper.js}

@@ -4,7 +4,7 @@ import { VALUE_AS_ARRAY_IDENTIFIER } from '../../../../libs/constants/constants.
  * @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/helpers/get-control-element-value/get-control-element-value.helper.d.ts

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

package/src/packages/get-form-control-payload/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/helpers/get-control-element-value/get-control-element-value.helper.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,gDANW,gBAAgB,GACrB,iBAAiB,GACjB,mBAAmB,GACnB,iBAAiB,GACV,MAAM,CAIlB"}

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

@@ -5,8 +5,8 @@
  * 	| HTMLSelectElement} element
  * @returns {string}
  */
-const getFormControlValue = (element) => {
+const getControlElementValue = (element) => {
 	return element.value;
 };
 
-export { getFormControlValue };
+export { getControlElementValue };

package/src/packages/get-form-control-payload/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/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/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/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/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/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/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 → 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/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/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/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/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 = ',';
+
+/**
+ * @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/helpers/get-fieldset-control-element-value/get-fieldset-control-element-value.helper.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 {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/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/helpers/get-fieldset-control-element-value/get-fieldset-control-element-value.helper.js"],"names":[],"mappings":"gDAGc,OAAO,iCAAiC,EAAE,iCAAiC;qCAC3E,OAAO,iCAAiC,EAAE,sBAAsB;AAD9E,+HAA+H;AAC/H,yGAAyG;AAEzG;;;;;;;GAOG;AACH,uJALa,iCAAiC,mBAEnC,mBAAmB,WAgB7B"}

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

@@ -0,0 +1,30 @@
+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 */
+/** @typedef {import('../../../../libs/types/types.js').HTMLFormControlElement} HTMLFormControlElement */
+
+/**
+ * @template {Record<string, unknown>} T
+ * @param {<T extends unknown>(
+ * 	element: HTMLFormOperationalControlElement,
+ * ) => T} getFormControlElementPayloadCallback
+ * @param {HTMLFieldSetElement} element
+ * @returns {T | [T]}
+ */
+const getFieldsetControlElementValue = (
+	getFormControlElementPayloadCallback,
+	element,
+) => {
+	const elements = [.../** @type {HTMLFieldSetElement} */ (element).elements];
+	const fieldsetValue = getFormControlElementsPayload(
+		getFormControlElementPayloadCallback,
+		.../** @type {HTMLFormControlElement[]} */ (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/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/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/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/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/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 {...HTMLFormControlElement} controlElements
+ * @returns {T}
+ */
+export function getFormControlElementsPayload<T extends Record<string, unknown>>(getFormControlElementPayloadCallback: <T_1 extends unknown>(element: HTMLFormOperationalControlElement) => T_1, ...controlElements: HTMLFormControlElement[]): T;
+//# sourceMappingURL=get-form-control-elements-payload.d.ts.map

package/src/packages/get-form-control-payload/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/helpers/get-form-control-elements-payload/get-form-control-elements-payload.js"],"names":[],"mappings":"gDAKc,OAAO,iCAAiC,EAAE,iCAAiC;qCAC3E,OAAO,iCAAiC,EAAE,sBAAsB;AAD9E,+HAA+H;AAC/H,yGAAyG;AAEzG;;;;;;;GAOG;AACH,sJALa,iCAAiC,8BAEhC,sBAAsB,OAqDnC"}

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

@@ -0,0 +1,69 @@
+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 { 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 {...HTMLFormControlElement} controlElements
+ * @returns {T}
+ */
+const getFormControlElementsPayload = (
+	getFormControlElementPayloadCallback,
+	...controlElements
+) => {
+	const operationalControlElements =
+		getOperationalControlElements(controlElements);
+
+	const elementsValues = /** @type {T} */ ({});
+
+	for (const operationalControlElement of operationalControlElements) {
+		const isReferToAnotherElement = checkIsReferToAnotherElement(
+			operationalControlElement,
+			operationalControlElements,
+		);
+
+		if (isReferToAnotherElement) {
+			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/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/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/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/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/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

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

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