a11y-form-validator 1.0.0

package/dist/docs.d.ts

@@ -0,0 +1,66 @@
+//#region src/docs.d.ts
+interface PluginDocs {
+  slug: string;
+  name: string;
+  packageName: string;
+  description: string;
+  repo?: string;
+  npm?: string;
+  install: {
+    npm: string;
+    pnpm: string;
+    yarn: string;
+  };
+  usage: string;
+  selectors?: string[];
+  keyboard?: Array<{
+    key: string;
+    description: string;
+  }>;
+  accessibility?: string[];
+  limitations?: string[];
+  api: Array<{
+    name: string;
+    type: string;
+    description: string;
+  }>;
+  examples?: Array<{
+    name: string;
+    description: string;
+    path: string;
+  }>;
+}
+declare const docs: {
+  slug: string;
+  name: string;
+  packageName: string;
+  description: string;
+  repo: string;
+  npm: string;
+  install: {
+    npm: string;
+    pnpm: string;
+    yarn: string;
+  };
+  usage: string;
+  selectors: string[];
+  keyboard: {
+    key: string;
+    description: string;
+  }[];
+  accessibility: string[];
+  limitations: string[];
+  api: {
+    name: string;
+    type: string;
+    description: string;
+  }[];
+  examples: {
+    name: string;
+    description: string;
+    path: string;
+  }[];
+};
+//#endregion
+export { PluginDocs, docs };
+//# sourceMappingURL=docs.d.ts.map

package/dist/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","names":[],"sources":["../src/docs.ts"],"sourcesContent":[],"mappings":";UAAiB,UAAA;EAAA,IAAA,EAAA,MAAA;EAcJ,IAAA,EAAA,MAAA;EAMN,WAAA,EAAA,MAAA;EAKM,WAAA,EAAA,MAAA;EAAK,IAAA,CAAA,EAAA,MAAA;EAOL,GAAA,CAAA,EAAA,MAuMS;;;;;;;;aAzNT;;;;;;OAMN;;;;;aAKM;;;;;;cAOA"}

package/dist/docs.js

@@ -0,0 +1,204 @@
+//#region src/docs.ts
+const docs = {
+	slug: "a11y-form-validator",
+	name: "A11y Form Validator",
+	packageName: "a11y-form-validator",
+	description: "Accessible, dependency-light progressive enhancement for semantic HTML forms.",
+	repo: "https://github.com/vmitsaras/A11y-Form-Validator",
+	npm: "https://www.npmjs.com/package/a11y-form-validator",
+	install: {
+		npm: "npm install a11y-form-validator",
+		pnpm: "pnpm add a11y-form-validator",
+		yarn: "yarn add a11y-form-validator"
+	},
+	usage: `import {
+  createDefaultPreset,
+  createFormValidator
+} from "a11y-form-validator";
+import "a11y-form-validator/styles.css";
+
+const form = document.querySelector("[data-a11y-form-validator]");
+if (form instanceof HTMLFormElement) {
+  createFormValidator(form, createDefaultPreset());
+}`,
+	selectors: [
+		"[data-a11y-form-validator]",
+		"input, select, textarea",
+		"[data-validate]",
+		"[data-message-*]",
+		"[data-character-count]"
+	],
+	keyboard: [
+		{
+			key: "Tab / Shift+Tab",
+			description: "Moves through the form controls, generated error summary links, and submit button in document order."
+		},
+		{
+			key: "Enter",
+			description: "Submits the form from text fields or activates error summary links."
+		},
+		{
+			key: "Space",
+			description: "Toggles native checkboxes and radio buttons; the validator preserves native control behavior."
+		}
+	],
+	accessibility: [
+		"Enhances native form controls and keeps existing labels, groups, and fieldsets in place.",
+		"Inline errors are associated with fields through aria-describedby and aria-errormessage.",
+		"Field-level validation uses polite inline error announcements; blocked submits that focus the summary suppress duplicate inline live-region announcements.",
+		"The error summary is focusable and labelled; field errors are field-labelled links that focus invalid controls, while form-level errors render as text.",
+		"Focus moves to the summary or first invalid field after blocked submits, depending on focusOnError.",
+		"Applications applying server errors with setErrors() should call focusOnError() when the summary or first invalid field should be announced immediately.",
+		"Keyboard behavior remains native: Tab moves through controls and summary links; Enter submits forms or activates links; Space toggles native checkboxes and radio buttons."
+	],
+	limitations: [
+		"The plugin validates controls collected by selectors.fields; custom widgets need custom rules, a custom renderer, or extra integration code.",
+		"Remote validation is supported through async custom rules, but request cancellation is the application’s responsibility.",
+		"Async pending state is exposed through validator state, events, and .is-pending; add an application live status when progress announcements are needed.",
+		"The default CSS is intentionally minimal and may need product-specific layout styles.",
+		"Native browser validation messages vary by browser and locale when errorMode includes native behavior."
+	],
+	api: [
+		{
+			name: "createFormValidator(form, options)",
+			type: "(form: HTMLFormElement, options?: A11yFormValidatorOptionsInput) => A11yFormValidatorInstance",
+			description: "Initializes accessible validation behavior on a form and reuses an existing instance for duplicate calls."
+		},
+		{
+			name: "initFormValidators(options, root)",
+			type: "(options?: A11yFormValidatorOptionsInput, root?: ParentNode) => A11yFormValidatorInstance[]",
+			description: "Initializes every form matching [data-a11y-form-validator] under the provided root."
+		},
+		{
+			name: "A11yFormValidator",
+			type: "class",
+			description: "Plugin class for advanced usage; exposes validation, state, rule registration, server errors, and cleanup methods."
+		},
+		{
+			name: "a11y-form-validator/min",
+			type: "package subpath",
+			description: "Optional minified ESM entry for direct browser or CDN-style imports. It reuses dist/index.d.ts and does not replace the default package entry."
+		},
+		{
+			name: "createDefaultPreset()",
+			type: "() => A11yFormValidatorOptionsInput",
+			description: "Available from the main entry and a11y-form-validator/presets/default. Includes the error summary addon: submit and blur validation, inline and native messages, summary focus after blocked submits, and generated summary UI."
+		},
+		{
+			name: "createNoSummaryPreset()",
+			type: "() => A11yFormValidatorOptionsInput",
+			description: "Available from the main entry and a11y-form-validator/presets/no-summary. Matches the default submit and blur validation pattern without importing or installing the error summary addon."
+		},
+		{
+			name: "createMinimalPreset()",
+			type: "() => A11yFormValidatorOptionsInput",
+			description: "Available from the main entry and a11y-form-validator/presets/minimal. Returns submit validation, inline errors, native rules, and focus on the first invalid field."
+		},
+		{
+			name: "createErrorSummaryAddon(options)",
+			type: "(options?: ErrorSummaryAddonOptions) => ErrorSummaryAddon",
+			description: "Import from a11y-form-validator/addons/error-summary. Creates a labelled, focusable error summary that lists form errors and links field errors back to invalid controls."
+		},
+		{
+			name: "createCharacterCountAddon(options)",
+			type: "(options?: CharacterCountAddonOptions) => CharacterCountAddon",
+			description: "Import from a11y-form-validator/addons/character-count. Creates polite character count guidance for controls with maxlength, minlength, or data-character-count."
+		},
+		{
+			name: "validate(), validateField(), refresh()",
+			type: "instance methods",
+			description: "Validate the full form, validate one field by name or element, or rescan fields after dynamic markup changes."
+		},
+		{
+			name: "getErrors(), getState(), clearErrors()",
+			type: "instance methods",
+			description: "Read current field/form errors and validation state, or remove rendered validation messages."
+		},
+		{
+			name: "setErrors(errors)",
+			type: "(errors?: ServerErrors) => A11yFormValidatorInstance",
+			description: "Renders server-provided field and form errors without replacing semantic form markup; call focusOnError() afterward when users should be moved to the summary or first invalid field."
+		},
+		{
+			name: "focusOnError()",
+			type: "() => void",
+			description: "Moves focus according to focusOnError, usually to the error summary or first invalid field."
+		},
+		{
+			name: "registerRule(name, rule), unregisterRule(name)",
+			type: "instance methods",
+			description: "Adds or removes custom validation rules for product-specific, conditional, cross-field, or async validation."
+		},
+		{
+			name: "reset(), enable(), disable(), destroy()",
+			type: "instance methods",
+			description: "Reset state, toggle validation, or remove listeners, generated errors, addons, timers, plugin classes, and generated ARIA state."
+		}
+	],
+	examples: [
+		{
+			name: "Direct browser minified build",
+			description: "Direct browser demo that imports the optional minified ESM build without making it the default bundler entry.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/minified.html"
+		},
+		{
+			name: "Basic",
+			description: "Semantic contact form with inline errors, an error summary, and character count guidance.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/basic.html"
+		},
+		{
+			name: "Contact Form",
+			description: "Small form using the minimal preset with native required, email, and minlength checks.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/contact.html"
+		},
+		{
+			name: "CMS Markup",
+			description: "Data-attribute rules and field-specific messages for markup produced by content systems or templates.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/cms-markup.html"
+		},
+		{
+			name: "Error Summary",
+			description: "Focusable summary region with links that send users back to invalid fields.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/error-summary.html"
+		},
+		{
+			name: "Registration",
+			description: "Password confirmation with a custom same-as rule and custom error copy.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/registration.html"
+		},
+		{
+			name: "Login / Register",
+			description: "Switch between login and registration forms while only the visible form is active and validated.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/login-register.html"
+		},
+		{
+			name: "Checkout",
+			description: "Conditional billing validation plus required shipping and payment method choices.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/checkout.html"
+		},
+		{
+			name: "Remote Validation",
+			description: "Username availability checked with an async custom rule and debounced input validation.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/remote-validation.html"
+		},
+		{
+			name: "Server Errors",
+			description: "Server-provided field and form messages rendered after a failed request.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/server-errors.html"
+		},
+		{
+			name: "Localization",
+			description: "English fallback, imported locale JSON, and inline locale messages.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/localization.html"
+		},
+		{
+			name: "Dynamic Locale",
+			description: "Destroy and reinitialize the validator to swap runtime locale packs and regenerate errors.",
+			path: "https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/dynamic-locale.html"
+		}
+	]
+};
+
+//#endregion
+export { docs };
+//# sourceMappingURL=docs.js.map

package/dist/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","names":[],"sources":["../src/docs.ts"],"sourcesContent":["export interface PluginDocs {\n  slug: string;\n  name: string;\n  packageName: string;\n  description: string;\n  repo?: string;\n  npm?: string;\n  install: {\n    npm: string;\n    pnpm: string;\n    yarn: string;\n  };\n  usage: string;\n  selectors?: string[];\n  keyboard?: Array<{\n    key: string;\n    description: string;\n  }>;\n  accessibility?: string[];\n  limitations?: string[];\n  api: Array<{\n    name: string;\n    type: string;\n    description: string;\n  }>;\n  examples?: Array<{\n    name: string;\n    description: string;\n    path: string;\n  }>;\n}\n\nexport const docs = {\n  slug: 'a11y-form-validator',\n  name: 'A11y Form Validator',\n  packageName: 'a11y-form-validator',\n  description: 'Accessible, dependency-light progressive enhancement for semantic HTML forms.',\n  repo: 'https://github.com/vmitsaras/A11y-Form-Validator',\n  npm: 'https://www.npmjs.com/package/a11y-form-validator',\n  install: {\n    npm: 'npm install a11y-form-validator',\n    pnpm: 'pnpm add a11y-form-validator',\n    yarn: 'yarn add a11y-form-validator'\n  },\n  usage: `import {\n  createDefaultPreset,\n  createFormValidator\n} from \"a11y-form-validator\";\nimport \"a11y-form-validator/styles.css\";\n\nconst form = document.querySelector(\"[data-a11y-form-validator]\");\nif (form instanceof HTMLFormElement) {\n  createFormValidator(form, createDefaultPreset());\n}`,\n  selectors: [\n    '[data-a11y-form-validator]',\n    'input, select, textarea',\n    '[data-validate]',\n    '[data-message-*]',\n    '[data-character-count]'\n  ],\n  keyboard: [\n    {\n      key: 'Tab / Shift+Tab',\n      description: 'Moves through the form controls, generated error summary links, and submit button in document order.'\n    },\n    {\n      key: 'Enter',\n      description: 'Submits the form from text fields or activates error summary links.'\n    },\n    {\n      key: 'Space',\n      description: 'Toggles native checkboxes and radio buttons; the validator preserves native control behavior.'\n    }\n  ],\n  accessibility: [\n    'Enhances native form controls and keeps existing labels, groups, and fieldsets in place.',\n    'Inline errors are associated with fields through aria-describedby and aria-errormessage.',\n    'Field-level validation uses polite inline error announcements; blocked submits that focus the summary suppress duplicate inline live-region announcements.',\n    'The error summary is focusable and labelled; field errors are field-labelled links that focus invalid controls, while form-level errors render as text.',\n    'Focus moves to the summary or first invalid field after blocked submits, depending on focusOnError.',\n    'Applications applying server errors with setErrors() should call focusOnError() when the summary or first invalid field should be announced immediately.',\n    'Keyboard behavior remains native: Tab moves through controls and summary links; Enter submits forms or activates links; Space toggles native checkboxes and radio buttons.'\n  ],\n  limitations: [\n    'The plugin validates controls collected by selectors.fields; custom widgets need custom rules, a custom renderer, or extra integration code.',\n    'Remote validation is supported through async custom rules, but request cancellation is the application’s responsibility.',\n    'Async pending state is exposed through validator state, events, and .is-pending; add an application live status when progress announcements are needed.',\n    'The default CSS is intentionally minimal and may need product-specific layout styles.',\n    'Native browser validation messages vary by browser and locale when errorMode includes native behavior.'\n  ],\n  api: [\n    {\n      name: 'createFormValidator(form, options)',\n      type: '(form: HTMLFormElement, options?: A11yFormValidatorOptionsInput) => A11yFormValidatorInstance',\n      description: 'Initializes accessible validation behavior on a form and reuses an existing instance for duplicate calls.'\n    },\n    {\n      name: 'initFormValidators(options, root)',\n      type: '(options?: A11yFormValidatorOptionsInput, root?: ParentNode) => A11yFormValidatorInstance[]',\n      description: 'Initializes every form matching [data-a11y-form-validator] under the provided root.'\n    },\n    {\n      name: 'A11yFormValidator',\n      type: 'class',\n      description: 'Plugin class for advanced usage; exposes validation, state, rule registration, server errors, and cleanup methods.'\n    },\n    {\n      name: 'a11y-form-validator/min',\n      type: 'package subpath',\n      description: 'Optional minified ESM entry for direct browser or CDN-style imports. It reuses dist/index.d.ts and does not replace the default package entry.'\n    },\n    {\n      name: 'createDefaultPreset()',\n      type: '() => A11yFormValidatorOptionsInput',\n      description: 'Available from the main entry and a11y-form-validator/presets/default. Includes the error summary addon: submit and blur validation, inline and native messages, summary focus after blocked submits, and generated summary UI.'\n    },\n    {\n      name: 'createNoSummaryPreset()',\n      type: '() => A11yFormValidatorOptionsInput',\n      description: 'Available from the main entry and a11y-form-validator/presets/no-summary. Matches the default submit and blur validation pattern without importing or installing the error summary addon.'\n    },\n    {\n      name: 'createMinimalPreset()',\n      type: '() => A11yFormValidatorOptionsInput',\n      description: 'Available from the main entry and a11y-form-validator/presets/minimal. Returns submit validation, inline errors, native rules, and focus on the first invalid field.'\n    },\n    {\n      name: 'createErrorSummaryAddon(options)',\n      type: '(options?: ErrorSummaryAddonOptions) => ErrorSummaryAddon',\n      description: 'Import from a11y-form-validator/addons/error-summary. Creates a labelled, focusable error summary that lists form errors and links field errors back to invalid controls.'\n    },\n    {\n      name: 'createCharacterCountAddon(options)',\n      type: '(options?: CharacterCountAddonOptions) => CharacterCountAddon',\n      description: 'Import from a11y-form-validator/addons/character-count. Creates polite character count guidance for controls with maxlength, minlength, or data-character-count.'\n    },\n    {\n      name: 'validate(), validateField(), refresh()',\n      type: 'instance methods',\n      description: 'Validate the full form, validate one field by name or element, or rescan fields after dynamic markup changes.'\n    },\n    {\n      name: 'getErrors(), getState(), clearErrors()',\n      type: 'instance methods',\n      description: 'Read current field/form errors and validation state, or remove rendered validation messages.'\n    },\n    {\n      name: 'setErrors(errors)',\n      type: '(errors?: ServerErrors) => A11yFormValidatorInstance',\n      description: 'Renders server-provided field and form errors without replacing semantic form markup; call focusOnError() afterward when users should be moved to the summary or first invalid field.'\n    },\n    {\n      name: 'focusOnError()',\n      type: '() => void',\n      description: 'Moves focus according to focusOnError, usually to the error summary or first invalid field.'\n    },\n    {\n      name: 'registerRule(name, rule), unregisterRule(name)',\n      type: 'instance methods',\n      description: 'Adds or removes custom validation rules for product-specific, conditional, cross-field, or async validation.'\n    },\n    {\n      name: 'reset(), enable(), disable(), destroy()',\n      type: 'instance methods',\n      description: 'Reset state, toggle validation, or remove listeners, generated errors, addons, timers, plugin classes, and generated ARIA state.'\n    }\n  ],\n  examples: [\n    {\n      name: 'Direct browser minified build',\n      description:\n        'Direct browser demo that imports the optional minified ESM build without making it the default bundler entry.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/minified.html'\n    },\n    {\n      name: 'Basic',\n      description: 'Semantic contact form with inline errors, an error summary, and character count guidance.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/basic.html'\n    },\n    {\n      name: 'Contact Form',\n      description: 'Small form using the minimal preset with native required, email, and minlength checks.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/contact.html'\n    },\n    {\n      name: 'CMS Markup',\n      description: 'Data-attribute rules and field-specific messages for markup produced by content systems or templates.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/cms-markup.html'\n    },\n    {\n      name: 'Error Summary',\n      description: 'Focusable summary region with links that send users back to invalid fields.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/error-summary.html'\n    },\n    {\n      name: 'Registration',\n      description: 'Password confirmation with a custom same-as rule and custom error copy.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/registration.html'\n    },\n    {\n      name: 'Login / Register',\n      description: 'Switch between login and registration forms while only the visible form is active and validated.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/login-register.html'\n    },\n    {\n      name: 'Checkout',\n      description: 'Conditional billing validation plus required shipping and payment method choices.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/checkout.html'\n    },\n    {\n      name: 'Remote Validation',\n      description: 'Username availability checked with an async custom rule and debounced input validation.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/remote-validation.html'\n    },\n    {\n      name: 'Server Errors',\n      description: 'Server-provided field and form messages rendered after a failed request.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/server-errors.html'\n    },\n    {\n      name: 'Localization',\n      description: 'English fallback, imported locale JSON, and inline locale messages.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/localization.html'\n    },\n    {\n      name: 'Dynamic Locale',\n      description: 'Destroy and reinitialize the validator to swap runtime locale packs and regenerate errors.',\n      path: 'https://github.com/vmitsaras/A11y-Form-Validator/blob/main/demo/dynamic-locale.html'\n    }\n  ]\n} satisfies PluginDocs;\n"],"mappings":";AAgCA,MAAa,OAAO;CAClB,MAAM;CACN,MAAM;CACN,aAAa;CACb,aAAa;CACb,MAAM;CACN,KAAK;CACL,SAAS;EACP,KAAK;EACL,MAAM;EACN,MAAM;EACP;CACD,OAAO;;;;;;;;;;CAUP,WAAW;EACT;EACA;EACA;EACA;EACA;EACD;CACD,UAAU;EACR;GACE,KAAK;GACL,aAAa;GACd;EACD;GACE,KAAK;GACL,aAAa;GACd;EACD;GACE,KAAK;GACL,aAAa;GACd;EACF;CACD,eAAe;EACb;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CACD,aAAa;EACX;EACA;EACA;EACA;EACA;EACD;CACD,KAAK;EACH;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACD;GACE,MAAM;GACN,MAAM;GACN,aAAa;GACd;EACF;CACD,UAAU;EACR;GACE,MAAM;GACN,aACE;GACF,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACD;GACE,MAAM;GACN,aAAa;GACb,MAAM;GACP;EACF;CACF"}

package/dist/error-summary-FnZoUC72.js

@@ -0,0 +1,99 @@
+import { a as getPreferredScrollBehavior, r as ensureElementId } from "./helpers-c_THOe-Q.js";
+
+//#region src/addons/error-summary.ts
+function createErrorSummaryAddon(options = {}) {
+	return {
+		validator: null,
+		options,
+		container: null,
+		title: null,
+		list: null,
+		install(validator) {
+			this.validator = validator;
+			this.options = options;
+			const document = validator.form.ownerDocument;
+			this.container = document.createElement("section");
+			this.container.className = "a11y-form-validator__summary";
+			this.container.hidden = true;
+			this.container.tabIndex = -1;
+			this.title = document.createElement("h2");
+			this.title.id = options.titleId || `${ensureElementId(validator.form, "a11y-form-validator-form")}-summary-title`;
+			this.title.className = "a11y-form-validator__summary-title";
+			this.container.setAttribute("aria-labelledby", this.title.id);
+			this.list = document.createElement("ul");
+			this.list.className = "a11y-form-validator__summary-list";
+			this.container.append(this.title, this.list);
+			validator.form.prepend(this.container);
+			validator.summaryAddon = this;
+			this.unsubscribeAfterValidate = validator.events.on("a11y-form-validator:after-validate", () => this.update());
+			this.unsubscribeDestroy = validator.events.on("a11y-form-validator:destroy", () => this.destroy());
+		},
+		getErrors() {
+			if (!this.validator) return [];
+			const fieldErrors = this.validator.fields.filter((field) => field.lastError).map((field) => ({
+				field,
+				message: field.lastError
+			}));
+			return [...this.validator.formErrors.map((message, index) => ({
+				field: null,
+				message,
+				key: `form-${index}`
+			})), ...fieldErrors];
+		},
+		hasErrors() {
+			return this.getErrors().length > 0;
+		},
+		update() {
+			if (!this.container || !this.list || !this.title || !this.validator) return;
+			const errors = this.getErrors();
+			this.list.replaceChildren();
+			if (!errors.length) {
+				this.container.hidden = true;
+				return;
+			}
+			this.title.textContent = this.validator.messageResolver.getSummaryTitle(errors.length);
+			errors.forEach((entry) => {
+				const item = this.validator.form.ownerDocument.createElement("li");
+				if (!entry.field) item.textContent = entry.message;
+				else {
+					const link = this.validator.form.ownerDocument.createElement("a");
+					link.className = "a11y-form-validator__summary-link";
+					link.href = `#${entry.field.primaryId}`;
+					link.textContent = this.validator.messageResolver.getSummaryItem(entry.field, entry.message);
+					const field = entry.field;
+					link.addEventListener("click", (event) => {
+						event.preventDefault();
+						field.focus();
+					});
+					item.append(link);
+				}
+				this.list.append(item);
+			});
+			this.container.hidden = false;
+		},
+		focus() {
+			if (this.hasErrors() && this.container) {
+				this.container.focus({ preventScroll: true });
+				this.container.scrollIntoView?.({
+					block: "start",
+					behavior: getPreferredScrollBehavior(this.container)
+				});
+			}
+		},
+		destroy() {
+			this.unsubscribeAfterValidate?.();
+			this.unsubscribeDestroy?.();
+			this.container?.remove();
+			if (this.validator) this.validator.summaryAddon = null;
+			this.container = null;
+			this.title = null;
+			this.list = null;
+			this.validator = null;
+		}
+	};
+}
+var error_summary_default = createErrorSummaryAddon;
+
+//#endregion
+export { error_summary_default as n, createErrorSummaryAddon as t };
+//# sourceMappingURL=error-summary-FnZoUC72.js.map

package/dist/error-summary-FnZoUC72.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-summary-FnZoUC72.js","names":[],"sources":["../src/addons/error-summary.ts"],"sourcesContent":["import type { A11yFormValidator, ValidatorAddon } from '../core/A11yFormValidator.js';\nimport type { FieldController } from '../core/FieldController.js';\nimport { ensureElementId, getPreferredScrollBehavior } from '../core/helpers.js';\n\nexport interface ErrorSummaryAddonOptions {\n  titleId?: string;\n}\n\nexport interface SummaryEntry {\n  field: FieldController | null;\n  message: string;\n  key?: string;\n}\n\nexport interface ErrorSummaryAddon extends ValidatorAddon {\n  validator: A11yFormValidator | null;\n  options: ErrorSummaryAddonOptions;\n  container: HTMLElement | null;\n  title: HTMLHeadingElement | null;\n  list: HTMLUListElement | null;\n  unsubscribeAfterValidate?: () => void;\n  unsubscribeDestroy?: () => void;\n  getErrors(): SummaryEntry[];\n  update(): void;\n  hasErrors(): boolean;\n  focus(): void;\n  destroy(): void;\n}\n\nexport function createErrorSummaryAddon(options: ErrorSummaryAddonOptions = {}): ErrorSummaryAddon {\n  return {\n    validator: null,\n    options,\n    container: null,\n    title: null,\n    list: null,\n\n    install(validator: A11yFormValidator) {\n      this.validator = validator;\n      this.options = options;\n      const document = validator.form.ownerDocument;\n      this.container = document.createElement('section');\n      this.container.className = 'a11y-form-validator__summary';\n      this.container.hidden = true;\n      this.container.tabIndex = -1;\n      this.title = document.createElement('h2');\n      this.title.id = options.titleId || `${ensureElementId(validator.form, 'a11y-form-validator-form')}-summary-title`;\n      this.title.className = 'a11y-form-validator__summary-title';\n      this.container.setAttribute('aria-labelledby', this.title.id);\n      this.list = document.createElement('ul');\n      this.list.className = 'a11y-form-validator__summary-list';\n      this.container.append(this.title, this.list);\n      validator.form.prepend(this.container);\n      validator.summaryAddon = this;\n\n      this.unsubscribeAfterValidate = validator.events.on('a11y-form-validator:after-validate', () => this.update());\n      this.unsubscribeDestroy = validator.events.on('a11y-form-validator:destroy', () => this.destroy());\n    },\n\n    getErrors(): SummaryEntry[] {\n      if (!this.validator) {\n        return [];\n      }\n\n      const fieldErrors = this.validator.fields\n        .filter((field) => field.lastError)\n        .map((field) => ({\n          field,\n          message: field.lastError\n        }));\n\n      const formErrors = this.validator.formErrors.map((message, index) => ({\n        field: null,\n        message,\n        key: `form-${index}`\n      }));\n\n      return [...formErrors, ...fieldErrors];\n    },\n\n    hasErrors(): boolean {\n      return this.getErrors().length > 0;\n    },\n\n    update(): void {\n      if (!this.container || !this.list || !this.title || !this.validator) {\n        return;\n      }\n\n      const errors = this.getErrors();\n      this.list.replaceChildren();\n      if (!errors.length) {\n        this.container.hidden = true;\n        return;\n      }\n\n      this.title.textContent = this.validator.messageResolver.getSummaryTitle(errors.length);\n      errors.forEach((entry) => {\n        const item = this.validator!.form.ownerDocument.createElement('li');\n        if (!entry.field) {\n          item.textContent = entry.message;\n        } else {\n          const link = this.validator!.form.ownerDocument.createElement('a');\n          link.className = 'a11y-form-validator__summary-link';\n          link.href = `#${entry.field.primaryId}`;\n          link.textContent = this.validator!.messageResolver.getSummaryItem(entry.field, entry.message);\n          const field = entry.field;\n          link.addEventListener('click', (event) => {\n            event.preventDefault();\n            field.focus();\n          });\n          item.append(link);\n        }\n        this.list!.append(item);\n      });\n      this.container.hidden = false;\n    },\n\n    focus(): void {\n      if (this.hasErrors() && this.container) {\n        this.container.focus({ preventScroll: true });\n        this.container.scrollIntoView?.({\n          block: 'start',\n          behavior: getPreferredScrollBehavior(this.container)\n        });\n      }\n    },\n\n    destroy(): void {\n      this.unsubscribeAfterValidate?.();\n      this.unsubscribeDestroy?.();\n      this.container?.remove();\n      if (this.validator) {\n        this.validator.summaryAddon = null;\n      }\n      this.container = null;\n      this.title = null;\n      this.list = null;\n      this.validator = null;\n    }\n  };\n}\n\nexport default createErrorSummaryAddon;\n"],"mappings":";;;AA6BA,SAAgB,wBAAwB,UAAoC,EAAE,EAAqB;AACjG,QAAO;EACL,WAAW;EACX;EACA,WAAW;EACX,OAAO;EACP,MAAM;EAEN,QAAQ,WAA8B;AACpC,QAAK,YAAY;AACjB,QAAK,UAAU;GACf,MAAM,WAAW,UAAU,KAAK;AAChC,QAAK,YAAY,SAAS,cAAc,UAAU;AAClD,QAAK,UAAU,YAAY;AAC3B,QAAK,UAAU,SAAS;AACxB,QAAK,UAAU,WAAW;AAC1B,QAAK,QAAQ,SAAS,cAAc,KAAK;AACzC,QAAK,MAAM,KAAK,QAAQ,WAAW,GAAG,gBAAgB,UAAU,MAAM,2BAA2B,CAAC;AAClG,QAAK,MAAM,YAAY;AACvB,QAAK,UAAU,aAAa,mBAAmB,KAAK,MAAM,GAAG;AAC7D,QAAK,OAAO,SAAS,cAAc,KAAK;AACxC,QAAK,KAAK,YAAY;AACtB,QAAK,UAAU,OAAO,KAAK,OAAO,KAAK,KAAK;AAC5C,aAAU,KAAK,QAAQ,KAAK,UAAU;AACtC,aAAU,eAAe;AAEzB,QAAK,2BAA2B,UAAU,OAAO,GAAG,4CAA4C,KAAK,QAAQ,CAAC;AAC9G,QAAK,qBAAqB,UAAU,OAAO,GAAG,qCAAqC,KAAK,SAAS,CAAC;;EAGpG,YAA4B;AAC1B,OAAI,CAAC,KAAK,UACR,QAAO,EAAE;GAGX,MAAM,cAAc,KAAK,UAAU,OAChC,QAAQ,UAAU,MAAM,UAAU,CAClC,KAAK,WAAW;IACf;IACA,SAAS,MAAM;IAChB,EAAE;AAQL,UAAO,CAAC,GANW,KAAK,UAAU,WAAW,KAAK,SAAS,WAAW;IACpE,OAAO;IACP;IACA,KAAK,QAAQ;IACd,EAAE,EAEoB,GAAG,YAAY;;EAGxC,YAAqB;AACnB,UAAO,KAAK,WAAW,CAAC,SAAS;;EAGnC,SAAe;AACb,OAAI,CAAC,KAAK,aAAa,CAAC,KAAK,QAAQ,CAAC,KAAK,SAAS,CAAC,KAAK,UACxD;GAGF,MAAM,SAAS,KAAK,WAAW;AAC/B,QAAK,KAAK,iBAAiB;AAC3B,OAAI,CAAC,OAAO,QAAQ;AAClB,SAAK,UAAU,SAAS;AACxB;;AAGF,QAAK,MAAM,cAAc,KAAK,UAAU,gBAAgB,gBAAgB,OAAO,OAAO;AACtF,UAAO,SAAS,UAAU;IACxB,MAAM,OAAO,KAAK,UAAW,KAAK,cAAc,cAAc,KAAK;AACnE,QAAI,CAAC,MAAM,MACT,MAAK,cAAc,MAAM;SACpB;KACL,MAAM,OAAO,KAAK,UAAW,KAAK,cAAc,cAAc,IAAI;AAClE,UAAK,YAAY;AACjB,UAAK,OAAO,IAAI,MAAM,MAAM;AAC5B,UAAK,cAAc,KAAK,UAAW,gBAAgB,eAAe,MAAM,OAAO,MAAM,QAAQ;KAC7F,MAAM,QAAQ,MAAM;AACpB,UAAK,iBAAiB,UAAU,UAAU;AACxC,YAAM,gBAAgB;AACtB,YAAM,OAAO;OACb;AACF,UAAK,OAAO,KAAK;;AAEnB,SAAK,KAAM,OAAO,KAAK;KACvB;AACF,QAAK,UAAU,SAAS;;EAG1B,QAAc;AACZ,OAAI,KAAK,WAAW,IAAI,KAAK,WAAW;AACtC,SAAK,UAAU,MAAM,EAAE,eAAe,MAAM,CAAC;AAC7C,SAAK,UAAU,iBAAiB;KAC9B,OAAO;KACP,UAAU,2BAA2B,KAAK,UAAU;KACrD,CAAC;;;EAIN,UAAgB;AACd,QAAK,4BAA4B;AACjC,QAAK,sBAAsB;AAC3B,QAAK,WAAW,QAAQ;AACxB,OAAI,KAAK,UACP,MAAK,UAAU,eAAe;AAEhC,QAAK,YAAY;AACjB,QAAK,QAAQ;AACb,QAAK,OAAO;AACZ,QAAK,YAAY;;EAEpB;;AAGH,4BAAe"}

package/dist/helpers-c_THOe-Q.js

@@ -0,0 +1,150 @@
+//#region src/core/helpers.ts
+const RULE_NAME_PATTERN = /([a-z0-9])([A-Z])/g;
+function sanitizeId(value) {
+	const input = String(value || "field");
+	let output = "";
+	let previousWasDash = false;
+	for (const character of input) {
+		if (character >= "a" && character <= "z" || character >= "A" && character <= "Z" || character >= "0" && character <= "9" || character === "_" || character === "-") {
+			output += character;
+			previousWasDash = false;
+			continue;
+		}
+		if (!previousWasDash) {
+			output += "-";
+			previousWasDash = true;
+		}
+	}
+	while (output.startsWith("-")) output = output.slice(1);
+	while (output.endsWith("-")) output = output.slice(0, -1);
+	return output || "field";
+}
+function escapeSelectorIdentifier(value) {
+	const input = String(value || "");
+	if (globalThis.CSS?.escape) return globalThis.CSS.escape(input);
+	return input.replace(/[^a-zA-Z0-9_-]/g, (character) => `\\${character}`);
+}
+function ensureElementId(element, prefix = "a11y-form-validator-field") {
+	if (element.id) return element.id;
+	const rawBase = element.name || element.getAttribute("name") || "";
+	const base = rawBase ? sanitizeId(rawBase) : "";
+	const root = element.ownerDocument;
+	let id = base ? `${prefix}-${base}` : prefix;
+	let index = 2;
+	while (root.getElementById(id)) {
+		id = `${prefix}-${base}-${index}`;
+		index += 1;
+	}
+	element.id = id;
+	return id;
+}
+function getPreferredScrollBehavior(element) {
+	return (element?.ownerDocument?.defaultView || globalThis).matchMedia?.("(prefers-reduced-motion: reduce)").matches ? "auto" : "smooth";
+}
+function kebabToCamelCase(value = "") {
+	return String(value).replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function camelToKebabCase(value = "") {
+	return String(value).replace(RULE_NAME_PATTERN, "$1-$2").toLowerCase();
+}
+function normalizeToArray(value) {
+	if (Array.isArray(value)) return value;
+	if (value == null || value === false) return [];
+	return [value];
+}
+function toSafeInteger(value, fallback, options = {}) {
+	const parsed = typeof value === "number" ? value : Number.parseInt(String(value), 10);
+	if (!Number.isFinite(parsed)) return fallback;
+	if (options.min !== void 0 && parsed < options.min) return fallback;
+	if (options.max !== void 0 && parsed > options.max) return fallback;
+	return parsed;
+}
+function mergeOptions(defaults, overrides = {}) {
+	const output = {
+		...defaults,
+		...overrides
+	};
+	output.ignore = {
+		...defaults.ignore || {},
+		...overrides.ignore || {}
+	};
+	output.selectors = {
+		...defaults.selectors || {},
+		...overrides.selectors || {}
+	};
+	output.messages = overrides?.messages || defaults.messages;
+	output.locales = overrides?.locales || defaults.locales;
+	output.rules = overrides?.rules || defaults.rules;
+	output.addons = normalizeToArray(overrides.addons ?? defaults.addons);
+	output.validateOn = normalizeToArray(overrides.validateOn ?? defaults.validateOn);
+	output.debounce = Number(overrides.debounce ?? defaults.debounce);
+	return output;
+}
+function parseRuleList(value) {
+	if (!value) return {};
+	if (Array.isArray(value)) return value.reduce((rules, rule) => ({
+		...rules,
+		...parseRuleList(rule)
+	}), {});
+	if (typeof value === "object") return { ...value };
+	return String(value).split(/\s+/).filter(Boolean).reduce((rules, ruleToken) => {
+		const [rawName, rawParam] = ruleToken.split(":");
+		const ruleName = kebabToCamelCase(rawName);
+		if (!ruleName) return rules;
+		if (rawParam == null || rawParam === "") {
+			rules[ruleName] = true;
+			return rules;
+		}
+		const numericValue = Number(rawParam);
+		rules[ruleName] = Number.isNaN(numericValue) ? rawParam : numericValue;
+		return rules;
+	}, {});
+}
+function unique(values) {
+	return [...new Set(values.filter(Boolean))];
+}
+function isEmptyValue(value) {
+	if (Array.isArray(value)) return value.length === 0;
+	if (typeof FileList !== "undefined" && value instanceof FileList) return value.length === 0;
+	if (value && typeof value === "object" && "length" in value && typeof value.length === "number") return value.length === 0;
+	if (typeof value === "boolean") return value === false;
+	return String(value ?? "").trim() === "";
+}
+function applyPlaceholders(template, params = {}) {
+	const input = String(template);
+	let output = "";
+	for (let index = 0; index < input.length; index += 1) {
+		const character = input[index];
+		if (character !== "{") {
+			output += character;
+			continue;
+		}
+		const closingIndex = input.indexOf("}", index + 1);
+		if (closingIndex === -1) {
+			output += character;
+			continue;
+		}
+		const replacement = params[input.slice(index + 1, closingIndex).trim()];
+		output += replacement == null ? "" : String(replacement);
+		index = closingIndex;
+	}
+	return output;
+}
+function toRuleOptions(value, key) {
+	if (value === true) return {};
+	if (value == null || value === false) return {};
+	if (typeof value === "object" && !Array.isArray(value)) return value;
+	if (typeof value === "number") {
+		if (key === "minLength" || key === "min") return { min: value };
+		if (key === "maxLength" || key === "max") return { max: value };
+	}
+	if (typeof value === "string") {
+		if (key === "sameAs") return { selector: value };
+		if (key === "pattern") return { pattern: value };
+	}
+	return { value };
+}
+
+//#endregion
+export { getPreferredScrollBehavior as a, normalizeToArray as c, toRuleOptions as d, toSafeInteger as f, escapeSelectorIdentifier as i, parseRuleList as l, camelToKebabCase as n, isEmptyValue as o, unique as p, ensureElementId as r, mergeOptions as s, applyPlaceholders as t, sanitizeId as u };
+//# sourceMappingURL=helpers-c_THOe-Q.js.map

package/dist/helpers-c_THOe-Q.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers-c_THOe-Q.js","names":["output: Record<string, unknown>"],"sources":["../src/core/helpers.ts"],"sourcesContent":["const RULE_NAME_PATTERN = /([a-z0-9])([A-Z])/g;\n\nexport type RuleOptions = Record<string, unknown>;\nexport type RuleList = Record<string, true | string | number | RuleOptions>;\n\nexport function sanitizeId(value: unknown): string {\n  const input = String(value || 'field');\n  let output = '';\n  let previousWasDash = false;\n\n  for (const character of input) {\n    const isSafeCharacter =\n      (character >= 'a' && character <= 'z') ||\n      (character >= 'A' && character <= 'Z') ||\n      (character >= '0' && character <= '9') ||\n      character === '_' ||\n      character === '-';\n\n    if (isSafeCharacter) {\n      output += character;\n      previousWasDash = false;\n      continue;\n    }\n\n    if (!previousWasDash) {\n      output += '-';\n      previousWasDash = true;\n    }\n  }\n\n  while (output.startsWith('-')) {\n    output = output.slice(1);\n  }\n\n  while (output.endsWith('-')) {\n    output = output.slice(0, -1);\n  }\n\n  return output || 'field';\n}\n\n\nexport function escapeSelectorIdentifier(value: unknown): string {\n  const input = String(value || '');\n  if (globalThis.CSS?.escape) {\n    return globalThis.CSS.escape(input);\n  }\n\n  return input.replace(/[^a-zA-Z0-9_-]/g, (character) => `\\\\${character}`);\n}\n\nexport function ensureElementId(element: HTMLElement, prefix = 'a11y-form-validator-field'): string {\n  if (element.id) {\n    return element.id;\n  }\n\n  const namedElement = element as HTMLElement & { name?: string };\n  const rawBase = namedElement.name || element.getAttribute('name') || '';\n  const base = rawBase ? sanitizeId(rawBase) : '';\n  const root = element.ownerDocument;\n  let id = base ? `${prefix}-${base}` : prefix;\n  let index = 2;\n\n  while (root.getElementById(id)) {\n    id = `${prefix}-${base}-${index}`;\n    index += 1;\n  }\n\n  element.id = id;\n  return id;\n}\n\n\nexport function getPreferredScrollBehavior(element: Element): ScrollBehavior {\n  const view = element?.ownerDocument?.defaultView || globalThis;\n  return view.matchMedia?.('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth';\n}\n\nexport function kebabToCamelCase(value = ''): string {\n  return String(value).replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());\n}\n\nexport function camelToKebabCase(value = ''): string {\n  return String(value).replace(RULE_NAME_PATTERN, '$1-$2').toLowerCase();\n}\n\nexport function normalizeToArray<T>(value: T | T[] | null | undefined | false): T[] {\n  if (Array.isArray(value)) {\n    return value;\n  }\n\n  if (value == null || value === false) {\n    return [];\n  }\n\n  return [value];\n}\n\nexport function toSafeBoolean(value: boolean | string | undefined, fallback: boolean): boolean {\n  if (value === true || value === 'true') {\n    return true;\n  }\n\n  if (value === false || value === 'false') {\n    return false;\n  }\n\n  return fallback;\n}\n\nexport function toSafeInteger(\n  value: number | string | undefined,\n  fallback: number,\n  options: { min?: number; max?: number } = {}\n): number {\n  const parsed = typeof value === 'number' ? value : Number.parseInt(String(value), 10);\n\n  if (!Number.isFinite(parsed)) {\n    return fallback;\n  }\n\n  if (options.min !== undefined && parsed < options.min) {\n    return fallback;\n  }\n\n  if (options.max !== undefined && parsed > options.max) {\n    return fallback;\n  }\n\n  return parsed;\n}\n\nexport function toSafeString(value: string | undefined, fallback: string): string {\n  const normalized = String(value ?? '').trim();\n  return normalized.length > 0 ? normalized : fallback;\n}\n\nexport function mergeOptions(\n  defaults: Record<string, unknown>,\n  overrides: Record<string, unknown> = {}\n): Record<string, unknown> {\n  const output: Record<string, unknown> = { ...defaults, ...overrides };\n\n  output.ignore = {\n    ...((defaults.ignore as Record<string, unknown>) || {}),\n    ...((overrides.ignore as Record<string, unknown>) || {})\n  };\n\n  output.selectors = {\n    ...((defaults.selectors as Record<string, unknown>) || {}),\n    ...((overrides.selectors as Record<string, unknown>) || {})\n  };\n\n  output.messages = overrides?.messages || defaults.messages;\n  output.locales = overrides?.locales || defaults.locales;\n  output.rules = overrides?.rules || defaults.rules;\n  output.addons = normalizeToArray(overrides.addons ?? defaults.addons);\n  output.validateOn = normalizeToArray(overrides.validateOn ?? defaults.validateOn);\n  output.debounce = Number(overrides.debounce ?? defaults.debounce);\n\n  return output;\n}\n\nexport function parseRuleList(value: unknown): RuleList {\n  if (!value) {\n    return {};\n  }\n\n  if (Array.isArray(value)) {\n    return value.reduce<RuleList>((rules, rule) => ({ ...rules, ...parseRuleList(rule) }), {});\n  }\n\n  if (typeof value === 'object') {\n    return { ...(value as RuleList) };\n  }\n\n  return String(value)\n    .split(/\\s+/)\n    .filter(Boolean)\n    .reduce<RuleList>((rules, ruleToken) => {\n      const [rawName, rawParam] = ruleToken.split(':');\n      const ruleName = kebabToCamelCase(rawName);\n      if (!ruleName) {\n        return rules;\n      }\n\n      if (rawParam == null || rawParam === '') {\n        rules[ruleName] = true;\n        return rules;\n      }\n\n      const numericValue = Number(rawParam);\n      rules[ruleName] = Number.isNaN(numericValue) ? rawParam : numericValue;\n      return rules;\n    }, {});\n}\n\nexport function unique(values: string[]): string[] {\n  return [...new Set(values.filter(Boolean))];\n}\n\nexport function isEmptyValue(value: unknown): boolean {\n  if (Array.isArray(value)) {\n    return value.length === 0;\n  }\n\n  if (typeof FileList !== 'undefined' && value instanceof FileList) {\n    return value.length === 0;\n  }\n\n  if (value && typeof value === 'object' && 'length' in value && typeof value.length === 'number') {\n    return value.length === 0;\n  }\n\n  if (typeof value === 'boolean') {\n    return value === false;\n  }\n\n  return String(value ?? '').trim() === '';\n}\n\nexport function applyPlaceholders(template: string, params: Record<string, unknown> = {}): string {\n  const input = String(template);\n  let output = '';\n\n  for (let index = 0; index < input.length; index += 1) {\n    const character = input[index];\n    if (character !== '{') {\n      output += character;\n      continue;\n    }\n\n    const closingIndex = input.indexOf('}', index + 1);\n    if (closingIndex === -1) {\n      output += character;\n      continue;\n    }\n\n    const key = input.slice(index + 1, closingIndex).trim();\n    const replacement = params[key];\n    output += replacement == null ? '' : String(replacement);\n    index = closingIndex;\n  }\n\n  return output;\n}\n\nexport function toRuleOptions(value: unknown, key: string): RuleOptions {\n  if (value === true) {\n    return {};\n  }\n\n  if (value == null || value === false) {\n    return {};\n  }\n\n  if (typeof value === 'object' && !Array.isArray(value)) {\n    return value as RuleOptions;\n  }\n\n  if (typeof value === 'number') {\n    if (key === 'minLength' || key === 'min') {\n      return { min: value };\n    }\n\n    if (key === 'maxLength' || key === 'max') {\n      return { max: value };\n    }\n  }\n\n  if (typeof value === 'string') {\n    if (key === 'sameAs') {\n      return { selector: value };\n    }\n\n    if (key === 'pattern') {\n      return { pattern: value };\n    }\n  }\n\n  return { value };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { A as initFormValidators, B as EventEmitter, C as ValidatorAddon, D as ValidatorRule, E as ValidatorRenderer, F as RuleRegistry, I as MessageResolver, L as FieldController, M as FormValidationState, N as ValidationState, O as ValidatorRuleResult, P as ValidationStateSnapshot, R as FieldType, S as ValidationResult, T as ValidatorMessages, _ as SELECTORS, a as ATTRIBUTES, b as ValidateTrigger, c as DEFAULT_OPTIONS, d as FieldInput, f as FieldValue, g as MessageValue, h as MessageResolverContext, i as A11yFormValidatorOptionsInput, j as FieldValidationState, k as createFormValidator, l as EVENTS, m as LocaleMessages, n as A11yFormValidatorInstance, o as AddonInput, p as FocusOnError, r as A11yFormValidatorOptions, s as CLASSES, t as A11yFormValidator, u as ErrorMode, v as ServerErrors, w as ValidatorErrors, x as ValidationContext, y as ValidateOptions, z as FormControl } from "./A11yFormValidator-D0n6br-b.js";
+import { t as createDefaultPreset } from "./default-BHBWPNeK.js";
+import { t as createNoSummaryPreset } from "./no-summary-BI1pTld5.js";
+import { t as createMinimalPreset } from "./minimal-40_EIW9U.js";
+
+//#region src/core/ErrorRenderer.d.ts
+declare class ErrorRenderer implements ValidatorRenderer {
+  readonly validator: A11yFormValidator;
+  constructor(validator: A11yFormValidator);
+  getNode(field: FieldController): HTMLElement | null;
+  shouldRenderInline(): boolean;
+  syncAnnouncementAttributes(errorNode: HTMLElement): void;
+  setNativeMessage(field: FieldController, message: string): void;
+  getInsertionTarget(field: FieldController): Element;
+  render(field: FieldController, message: string): void;
+  clear(field: FieldController): void;
+  destroy(): void;
+}
+//#endregion
+//#region src/locales/en.d.ts
+declare let required: string;
+declare let email: string;
+declare let minLength: string;
+declare let maxLength: string;
+declare let pattern: string;
+declare let checked: string;
+declare let sameAs: string;
+declare let summaryTitleOne: string;
+declare let summaryTitleOther: string;
+declare let summaryItem: string;
+declare let genericFallback: string;
+declare namespace __json_default_export {
+  export { required, email, minLength, maxLength, pattern, checked, sameAs, summaryTitleOne, summaryTitleOther, summaryItem, genericFallback };
+}
+//#endregion
+export { A11yFormValidator, type A11yFormValidatorInstance, type A11yFormValidatorOptions, type A11yFormValidatorOptionsInput, ATTRIBUTES, type AddonInput, CLASSES, DEFAULT_OPTIONS, EVENTS, type ErrorMode, ErrorRenderer, EventEmitter, FieldController, type FieldInput, type FieldType, type FieldValidationState, type FieldValue, type FocusOnError, type FormControl, type FormValidationState, type LocaleMessages, MessageResolver, type MessageResolverContext, type MessageValue, RuleRegistry, SELECTORS, type ServerErrors, type ValidateOptions, type ValidateTrigger, type ValidationContext, type ValidationResult, ValidationState, type ValidationStateSnapshot, type ValidatorAddon, type ValidatorErrors, type ValidatorMessages, type ValidatorRenderer, type ValidatorRule, type ValidatorRuleResult, createDefaultPreset, createFormValidator, createMinimalPreset, createNoSummaryPreset, __json_default_export as enMessages, initFormValidators };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["required","email","minLength","maxLength","pattern","checked","sameAs","summaryTitleOne","summaryTitleOther","summaryItem","genericFallback","__json_default_export","default"],"sources":["../src/core/ErrorRenderer.ts","../src/locales/en.d.ts"],"sourcesContent":["export let required: string;\nexport let email: string;\nexport let minLength: string;\nexport let maxLength: string;\nexport let pattern: string;\nexport let checked: string;\nexport let sameAs: string;\nexport let summaryTitleOne: string;\nexport let summaryTitleOther: string;\nexport let summaryItem: string;\nexport let genericFallback: string;\n\ndeclare namespace __json_default_export {\n  export { required, email, minLength, maxLength, pattern, checked, sameAs, summaryTitleOne, summaryTitleOther, summaryItem, genericFallback }\n}\nexport { __json_default_export as default }"],"mappings":";;;;;;cAGa,aAAA,YAAyB;sBAChB;yBAEG;iBAIR,kBAAkB;EAPtB,kBAAc,CAAA,CAAA,EAAA,OAAA;EACL,0BAAA,CAAA,SAAA,EAckB,WAdlB,CAAA,EAAA,IAAA;EAEG,gBAAA,CAAA,KAAA,EAyBC,eAzBD,EAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAIR,kBAAA,CAAA,KAAA,EA2BW,eA3BX,CAAA,EA2B6B,OA3B7B;EAAkB,MAAA,CAAA,KAAA,EA2CnB,eA3CmB,EAAA,OAAA,EAAA,MAAA,CAAA,EAAA,IAAA;EAQK,KAAA,CAAA,KAAA,EA8DzB,eA9DyB,CAAA,EAAA,IAAA;EAad,OAAA,CAAA,CAAA,EAAA,IAAA;;;;YC/BfA;YACAC;YACAC;YACAC;YACAC;YACAC;ADFE,YCGFC,MDHE,EAAA,MAAc;AACL,YCGXC,eDHW,EAAA,MAAA;AAEG,YCEdC,iBDFc,EAAA,MAAA;AAIR,YCDNC,WDCM,EAAA,MAAA;AAAkB,YCAxBC,eDAwB,EAAA,MAAA;kBCEjBC,qBAAAA,CDmBQ;EAME,SCxBjBX,QDwBiB,ECxBPC,KDwBO,ECxBAC,SDwBA,ECxBWC,SDwBX,ECxBsBC,ODwBtB,ECxB+BC,ODwB/B,ECxBwCC,MDwBxC,ECxBgDC,eDwBhD,ECxBiEC,iBDwBjE,ECxBoFC,WDwBpF,ECxBiGC,eDwBjG"}