@orkestrel/form 0.0.12 → 0.0.13

package/dist/src/browser/index.js

@@ -1,4 +1,5 @@
-import { attempt, isArray, isBoolean, isFiniteNumber, isInstance, isString, readArrayEntries } from "@orkestrel/contract";
+import { isInstance } from "@orkestrel/contract";
+import { formatMessage, matchesAnswer, matchesField, matchesValue } from "../core/index.js";
 import { Emitter } from "@orkestrel/emitter";
 //#region src/browser/errors.ts
 /** Reports an incompatible control, overlapping submission, or native DOM failure. */
@@ -30,185 +31,6 @@ var FormBindingError = class extends Error {
 function isFormBindingError(value) {
 	return isInstance(value, FormBindingError);
 }
-Object.freeze([
-	"text",
-	"editor",
-	"password",
-	"number",
-	"date",
-	"time",
-	"datetime",
-	"color",
-	"confirm",
-	"select",
-	"checkbox",
-	"list",
-	"file"
-]);
-/** Lists the members every field declares, whatever its control. */
-var FIELD_BASE_KEYS = Object.freeze([
-	"control",
-	"name",
-	"label",
-	"help",
-	"group",
-	"hidden",
-	"disabled",
-	"locked",
-	"rule",
-	"meta"
-]);
-Object.freeze({
-	text: Object.freeze([
-		...FIELD_BASE_KEYS,
-		"default",
-		"placeholder"
-	]),
-	editor: Object.freeze([
-		...FIELD_BASE_KEYS,
-		"default",
-		"placeholder"
-	]),
-	password: Object.freeze([...FIELD_BASE_KEYS, "mask"]),
-	number: Object.freeze([
-		...FIELD_BASE_KEYS,
-		"default",
-		"placeholder"
-	]),
-	date: Object.freeze([...FIELD_BASE_KEYS, "default"]),
-	time: Object.freeze([...FIELD_BASE_KEYS, "default"]),
-	datetime: Object.freeze([...FIELD_BASE_KEYS, "default"]),
-	color: Object.freeze([...FIELD_BASE_KEYS, "default"]),
-	confirm: Object.freeze([...FIELD_BASE_KEYS, "default"]),
-	select: Object.freeze([
-		...FIELD_BASE_KEYS,
-		"choices",
-		"default",
-		"open"
-	]),
-	checkbox: Object.freeze([
-		...FIELD_BASE_KEYS,
-		"choices",
-		"default"
-	]),
-	list: Object.freeze([...FIELD_BASE_KEYS, "default"]),
-	file: Object.freeze([
-		...FIELD_BASE_KEYS,
-		"accept",
-		"multiple"
-	])
-});
-Object.freeze([
-	"editing",
-	"settled",
-	"abandoned"
-]);
-/** Holds the default failure copy for every named field rule. */
-var RULE_MESSAGES = Object.freeze({
-	required: "This field is required",
-	minimum: "Must be at least {limit}",
-	maximum: "Must be at most {limit}",
-	step: "Must be a multiple of {limit}",
-	pattern: "Must match the required format",
-	email: "Must be a valid email address",
-	url: "Must be a valid URL",
-	integer: "Must be an integer",
-	alphanumeric: "Must contain only letters and numbers"
-});
-Object.freeze(/^[^\s@]+@[^\s@]+\.[^\s@]+$/);
-Object.freeze(/^https?:\/\/[^\s]+$/);
-Object.freeze(/^[A-Za-z0-9]+$/);
-Object.freeze(/^[+-]?\d+$/);
-/** Matches a six-digit hexadecimal color string. */
-var COLOR_PATTERN = Object.freeze(/^#[0-9A-Fa-f]{6}$/);
-/** Matches an ISO calendar date string in `YYYY-MM-DD` form. */
-var DATE_PATTERN = Object.freeze(/^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$/);
-/** Matches a 24-hour time string with optional seconds. */
-var TIME_PATTERN = Object.freeze(/^(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$/);
-/** Matches an ISO local date and time string with optional seconds. */
-var DATETIME_PATTERN = Object.freeze(/^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d)?$/);
-//#endregion
-//#region src/core/helpers.ts
-/**
-* Checks whether a value has the shape required by one field control.
-*
-* @remarks
-* Every write and every seeded value passes through this gate, and it reads `STRING_LIMIT` and
-* `LIST_LIMIT` before it consults the control, so no regular expression sees an over-long value.
-*
-* @param field - The field that owns the value.
-* @param value - The unknown value to inspect.
-* @returns True if the control can hold the value; false otherwise.
-*/
-function matchesField(field, value) {
-	if (isString(value) && value.length > 65536) return false;
-	let entries;
-	if (isArray(value)) {
-		const length = attempt(() => value.length);
-		if (!length.success || length.value > 1024) return false;
-		const read = readArrayEntries(value);
-		if (!read.success || !read.value.dense) return false;
-		entries = read.value.entries;
-		if (entries.some((entry) => !isString(entry) || entry.length > 65536)) return false;
-	}
-	switch (field.control) {
-		case "text":
-		case "editor":
-		case "password": return isString(value);
-		case "number": return isFiniteNumber(value);
-		case "date": return isString(value) && DATE_PATTERN.test(value);
-		case "time": return isString(value) && TIME_PATTERN.test(value);
-		case "datetime": return isString(value) && DATETIME_PATTERN.test(value);
-		case "color": return isString(value) && COLOR_PATTERN.test(value);
-		case "confirm": return isBoolean(value);
-		case "select": return 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) => 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);
-	}
-}
-/**
-* Decides whether a raw binding value projects to an answered field.
-*
-* @remarks
-* 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 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.
-*/
-function matchesAnswer(value) {
-	return value !== void 0 && (!isString(value) || value.trim().length > 0);
-}
-/**
-* Compares two field values by scalar identity or ordered list content.
-*
-* @param a - The first field value.
-* @param b - The second field value.
-* @returns True if both values contain the same answer; false otherwise.
-*/
-function matchesValue(a, b) {
-	if (isArray(a) || isArray(b)) return isArray(a) && isArray(b) && a.length === b.length && a.every((entry, index) => entry === b[index]);
-	return a === b;
-}
-/**
-* Resolves and interpolates one rule message.
-*
-* @remarks
-* A replacement in `messages` is read first and {@link RULE_MESSAGES} supplies the copy otherwise,
-* and `{limit}` in whichever text wins is replaced with the rule's operand.
-*
-* @param rule - The rule whose message to resolve.
-* @param limit - The optional operand substituted for `{limit}`.
-* @param messages - Optional rule-specific message replacements.
-* @returns The resolved failure text.
-*/
-function formatMessage(rule, limit, messages) {
-	const message = messages?.[rule] ?? RULE_MESSAGES[rule];
-	return limit === void 0 ? message : message.replaceAll("{limit}", String(limit));
-}
 //#endregion
 //#region src/browser/helpers.ts
 /**