@orkestrel/form 0.0.11 → 0.0.12

package/dist/src/core/index.cjs

@@ -15,6 +15,7 @@ var FIELD_CONTROLS = Object.freeze([
 	"confirm",
 	"select",
 	"checkbox",
+	"list",
 	"file"
 ]);
 /** Lists the members every field declares, whatever its control. */
@@ -67,6 +68,7 @@ var FIELD_KEYS = Object.freeze({
 		"choices",
 		"default"
 	]),
+	list: Object.freeze([...FIELD_BASE_KEYS, "default"]),
 	file: Object.freeze([
 		...FIELD_BASE_KEYS,
 		"accept",
@@ -325,6 +327,7 @@ function isFormField(input) {
 				const fallback = hasDefault ? input.default : void 0;
 				return (0, _orkestrel_contract.arrayOf)(isFieldChoice)(choices) && (!hasDefault || (0, _orkestrel_contract.arrayOf)(_orkestrel_contract.isString)(fallback));
 			}
+			case "list": return !Object.hasOwn(input, "default") || (0, _orkestrel_contract.arrayOf)(_orkestrel_contract.isString)(input.default);
 			case "file": {
 				const hasAccept = Object.hasOwn(input, "accept");
 				const accept = hasAccept ? input.accept : void 0;
@@ -449,6 +452,12 @@ function cloneFormField(field) {
 			choices: cloneChoices(field.choices),
 			...field.default === void 0 ? {} : { default: cloneValue(field.default) }
 		});
+		case "list": return Object.freeze({
+			...field,
+			...rule,
+			...meta,
+			...field.default === void 0 ? {} : { default: cloneValue(field.default) }
+		});
 		case "file": return Object.freeze({
 			...field,
 			...rule,
@@ -573,6 +582,7 @@ function matchesField(field, value) {
 		case "confirm": return (0, _orkestrel_contract.isBoolean)(value);
 		case "select": return (0, _orkestrel_contract.isString)(value) && !field.choices.some((choice) => choice.value === value && choice.disabled === true) && (field.open === true || field.choices.some((choice) => choice.value === value && choice.disabled !== true));
 		case "checkbox": return entries !== void 0 && entries.every((entry) => (0, _orkestrel_contract.isString)(entry) && field.choices.some((choice) => choice.value === entry && choice.disabled !== true)) && new Set(entries).size === entries.length;
+		case "list": return entries !== void 0;
 		case "file": return entries !== void 0 && (field.multiple === true || entries.length <= 1);
 	}
 }
@@ -583,7 +593,7 @@ function matchesField(field, value) {
 * Bind with `fill(name, matchesAnswer(raw) ? raw : undefined)`. This projection treats an absent
 * value and a string containing only whitespace as unanswered. Every other field value is an
 * answer, including an empty list, `false`, and zero. Core evaluation does not use this projection:
-* its `required` rule remains presence-only.
+* its `required` rule remains presence-only except that `list` requires an entry.
 *
 * @param value - The raw field value, or absence.
 * @returns True if the binding preserves the value as an answer; false otherwise.
@@ -631,7 +641,7 @@ function appliesRule(control, rule) {
 function evaluateField(field, value, values, messages) {
 	const errors = [];
 	const rule = field.rule;
-	if (value === void 0) {
+	if (value === void 0 || field.control === "list" && (0, _orkestrel_contract.isArray)(value) && value.length === 0) {
 		if (rule?.required === true && appliesRule(field.control, "required")) errors.push(createFieldError(field, "required", void 0, messages));
 	}
 	if (rule === void 0) return Object.freeze(errors);
@@ -652,6 +662,7 @@ function evaluateField(field, value, values, messages) {
 				failed = (0, _orkestrel_contract.isString)(value) && (0, _orkestrel_contract.isString)(rule.minimum) && value < rule.minimum;
 				break;
 			case "checkbox":
+			case "list":
 			case "file": failed = (0, _orkestrel_contract.isArray)(value) && (0, _orkestrel_contract.isFiniteNumber)(rule.minimum) && value.length < rule.minimum;
 		}
 		if (failed) errors.push(createFieldError(field, "minimum", rule.minimum, messages));
@@ -673,6 +684,7 @@ function evaluateField(field, value, values, messages) {
 				failed = (0, _orkestrel_contract.isString)(value) && (0, _orkestrel_contract.isString)(rule.maximum) && value > rule.maximum;
 				break;
 			case "checkbox":
+			case "list":
 			case "file": failed = (0, _orkestrel_contract.isArray)(value) && (0, _orkestrel_contract.isFiniteNumber)(rule.maximum) && value.length > rule.maximum;
 		}
 		if (failed) errors.push(createFieldError(field, "maximum", rule.maximum, messages));
@@ -681,19 +693,45 @@ function evaluateField(field, value, values, messages) {
 		const multiple = (value - ((0, _orkestrel_contract.isFiniteNumber)(rule.minimum) ? rule.minimum : 0)) / rule.step;
 		if (!(0, _orkestrel_contract.isFiniteNumber)(rule.step) || rule.step === 0 || !(0, _orkestrel_contract.isFiniteNumber)(multiple) || Math.abs(multiple - Math.round(multiple)) > 1e-9) errors.push(createFieldError(field, "step", rule.step, messages));
 	}
-	if ((0, _orkestrel_contract.isString)(value)) {
-		if (rule.pattern !== void 0 && appliesRule(field.control, "pattern")) {
-			const pattern = rule.pattern;
-			if (pattern.length > 256) errors.push(createFieldError(field, "pattern", void 0, messages));
-			else {
-				const outcome = (0, _orkestrel_contract.attempt)(() => new RegExp(pattern).test(value));
-				if (!outcome.success || !outcome.value) errors.push(createFieldError(field, "pattern", void 0, messages));
+	const entries = (0, _orkestrel_contract.isString)(value) ? [value] : field.control === "list" && (0, _orkestrel_contract.isArray)(value) ? value : [];
+	for (const constraint of [
+		"pattern",
+		"email",
+		"url",
+		"alphanumeric",
+		"integer"
+	]) {
+		if (!appliesRule(field.control, constraint)) continue;
+		for (const entry of entries) {
+			let failed = false;
+			switch (constraint) {
+				case "pattern": {
+					const pattern = rule.pattern;
+					if (pattern !== void 0) {
+						const outcome = (0, _orkestrel_contract.attempt)(() => pattern.length <= 256 && new RegExp(pattern).test(entry));
+						failed = !outcome.success || !outcome.value;
+					}
+					break;
+				}
+				case "email":
+					failed = rule.email === true && !EMAIL_PATTERN.test(entry);
+					break;
+				case "url":
+					failed = rule.url === true && !URL_PATTERN.test(entry);
+					break;
+				case "alphanumeric":
+					failed = rule.alphanumeric === true && !ALPHANUMERIC_PATTERN.test(entry);
+					break;
+				case "integer": failed = rule.integer === true && !INTEGER_PATTERN.test(entry);
+			}
+			if (failed) {
+				const error = createFieldError(field, constraint, void 0, messages);
+				errors.push(field.control === "list" ? Object.freeze({
+					...error,
+					message: `${JSON.stringify(entry)}: ${error.message}`
+				}) : error);
 			}
 		}
-		if (rule.email === true && appliesRule(field.control, "email") && !EMAIL_PATTERN.test(value)) errors.push(createFieldError(field, "email", void 0, messages));
-		if (rule.url === true && appliesRule(field.control, "url") && !URL_PATTERN.test(value)) errors.push(createFieldError(field, "url", void 0, messages));
-		if (rule.alphanumeric === true && appliesRule(field.control, "alphanumeric") && !ALPHANUMERIC_PATTERN.test(value)) errors.push(createFieldError(field, "alphanumeric", void 0, messages));
-		if (rule.integer === true && appliesRule(field.control, "integer") && !INTEGER_PATTERN.test(value)) errors.push(createFieldError(field, "integer", void 0, messages));
 	}
 	if (value !== void 0 && field.control === "number" && rule.integer === true && appliesRule(field.control, "integer") && !(0, _orkestrel_contract.isInteger)(value)) errors.push(createFieldError(field, "integer", void 0, messages));
 	if (rule.custom !== void 0) {
@@ -737,6 +775,7 @@ function computeDefaults(schema) {
 	const defaults = {};
 	for (const field of schema.fields) switch (field.control) {
 		case "checkbox":
+		case "list":
 			if (field.default !== void 0) defineEntry(defaults, field.name, cloneValue(field.default));
 			break;
 		case "password":
@@ -924,6 +963,9 @@ function serializeForm(schema) {
 				});
 				if (field.default !== void 0) entry.default = field.default;
 				break;
+			case "list":
+				if (field.default !== void 0) entry.default = field.default;
+				break;
 			case "file":
 				if (field.accept !== void 0) entry.accept = field.accept;
 				if (field.multiple !== void 0) entry.multiple = field.multiple;
@@ -1075,7 +1117,8 @@ function auditSchema(schema) {
 			case "color":
 			case "confirm":
 			case "select":
-			case "checkbox": if (field.default !== void 0 && !matchesField(field, field.default)) faults.push(`Field "${field.name}" has an invalid default`);
+			case "checkbox":
+			case "list": if (field.default !== void 0 && !matchesField(field, field.default)) faults.push(`Field "${field.name}" has an invalid default`);
 		}
 		if (field.control === "select" || field.control === "checkbox") {
 			const choices = /* @__PURE__ */ new Set();
@@ -1094,6 +1137,11 @@ function auditSchema(schema) {
 		}
 		const rule = field.rule;
 		if (rule === void 0) continue;
+		if (field.control === "list") {
+			for (const bound of [rule.minimum, rule.maximum]) if ((0, _orkestrel_contract.isFiniteNumber)(bound) && (!(0, _orkestrel_contract.isInteger)(bound) || bound < 0)) faults.push(`Field "${field.name}" has a count that is not a nonnegative integer`);
+			if ((0, _orkestrel_contract.isFiniteNumber)(rule.minimum) && rule.minimum > 1024) faults.push(`Field "${field.name}" has minimum greater than ${LIST_LIMIT}`);
+			if (rule.required === true && (0, _orkestrel_contract.isFiniteNumber)(rule.maximum) && rule.maximum < 1) faults.push(`Field "${field.name}" is required but permits no entries`);
+		}
 		const temporal = field.control === "date" || field.control === "time" || field.control === "datetime";
 		if (rule.minimum !== void 0 && !appliesRule(field.control, "minimum")) faults.push(`Field "${field.name}" has minimum on ${field.control}`);
 		else if ((0, _orkestrel_contract.isString)(rule.minimum) && !temporal) faults.push(`Field "${field.name}" has a string minimum on ${field.control}`);