ctrovalidate-browser 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ctrotech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,147 @@
+# ctrovalidate-browser
+
+**DOM-first validation for vanilla JavaScript and HTML.**
+
+`ctrovalidate-browser` provides a `Ctrovalidate` controller class that bridges [`ctrovalidate-core`](https://www.npmjs.com/package/ctrovalidate-core) validation logic to the DOM. Discover fields via data attributes, manage event listeners, display errors, and handle ARIA accessibility — all without a framework.
+
+[![npm version](https://img.shields.io/npm/v/ctrovalidate-browser.svg)](https://www.npmjs.com/package/ctrovalidate-browser)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Installation
+
+```bash
+npm install ctrovalidate-browser ctrovalidate-core
+```
+
+---
+
+## Quick Start
+
+### HTML
+
+```html
+<form id="signupForm" novalidate>
+  <div>
+    <input
+      type="email"
+      name="email"
+      data-ctrovalidate-rules="required|email"
+    />
+    <div class="error-message"></div>
+  </div>
+
+  <div>
+    <input
+      type="password"
+      name="password"
+      data-ctrovalidate-rules="required|minLength:8|strongPassword"
+    />
+    <div class="error-message"></div>
+  </div>
+
+  <button type="submit">Sign Up</button>
+</form>
+```
+
+### JavaScript
+
+```javascript
+import { Ctrovalidate } from 'ctrovalidate-browser';
+
+const form = document.querySelector('#signupForm');
+const validator = new Ctrovalidate(form, {
+  errorClass: 'is-invalid',
+  errorMessageClass: 'error-message',
+});
+
+form.addEventListener('submit', async (e) => {
+  e.preventDefault();
+  const isValid = await validator.validate();
+  if (isValid) {
+    // Submit
+  }
+});
+```
+
+---
+
+## Data Attributes
+
+| Attribute | Description |
+|-----------|-------------|
+| `data-ctrovalidate-rules` | Pipe-delimited rule string (e.g. `required\|email\|minLength:8`) |
+| `data-ctrovalidate-if` | Conditional validation dependency (e.g. `agreeTerms:checked`, `country:value=USA`) |
+| `data-ctrovalidate-message` | Catch-all error message for the field |
+| `data-ctrovalidate-{ruleName}-message` | Rule-specific error message |
+
+---
+
+## Configuration
+
+```javascript
+const validator = new Ctrovalidate(form, {
+  realTime: true,                          // Enable blur/input listeners
+  errorClass: 'is-invalid border-red-500', // Supports Tailwind space-separated
+  errorMessageClass: 'error-message',      // Also space-separated
+  pendingClass: 'is-validating',           // Added during async validation
+  logLevel: Ctrovalidate.LogLevel.NONE,    // Logging verbosity
+  schema: { email: 'required|email' },     // Programmatic rules (merged with HTML)
+  aliases: { username: 'required|alphaDash|minLength:3' }, // Instance aliases
+});
+```
+
+---
+
+## Instance Methods
+
+```javascript
+await validator.validate();            // Validate all fields
+validator.addField(element);           // Register a field
+validator.removeField(element);         // Unregister a field
+validator.refresh();                    // Re-discover fields
+validator.isDirty('email');             // Check if field was interacted with
+validator.getError('email');            // Get current error message
+validator.reset();                      // Clear all validation state
+validator.destroy();                    // Full cleanup
+```
+
+---
+
+## Static Methods
+
+```javascript
+Ctrovalidate.defineAlias('password', 'required|minLength:8|strongPassword');
+Ctrovalidate.addRule('isEven', (v) => Number(v) % 2 === 0, 'Must be even.');
+Ctrovalidate.addAsyncRule('checkEmail', async (v, p, el, signal) => { ... });
+Ctrovalidate.setCustomMessages({ required: 'Cannot be empty.' });
+```
+
+---
+
+## Accessibility
+
+The controller automatically manages:
+
+- `aria-invalid="true"` on validation failure
+- `aria-describedby` linking to the error container
+- `role="status"` and `aria-live="polite"` on fallback error containers
+
+---
+
+## Related Packages
+
+- **[ctrovalidate-core](https://www.npmjs.com/package/ctrovalidate-core)** — Validation engine
+- **[ctrovalidate-react](https://www.npmjs.com/package/ctrovalidate-react)** — React hook
+- **[ctrovalidate-vue](https://www.npmjs.com/package/ctrovalidate-vue)** — Vue composable
+- **[ctrovalidate-svelte](https://www.npmjs.com/package/ctrovalidate-svelte)** — Svelte stores
+- **[ctrovalidate-next](https://www.npmjs.com/package/ctrovalidate-next)** — Next.js server actions
+
+---
+
+## License
+
+MIT © [Ctrotech](https://github.com/ctrotech-tutor)
+
+Full documentation: https://ctrovalidate.vercel.app

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var Ke=Object.defineProperty;var oe=t=>{throw TypeError(t)};var Qe=(t,e,r)=>e in t?Ke(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r;var de=(t,e,r)=>Qe(t,typeof e!="symbol"?e+"":e,r),j=(t,e,r)=>e.has(t)||oe("Cannot "+r);var s=(t,e,r)=>(j(t,e,"read from private field"),r?r.call(t):e.get(t)),o=(t,e,r)=>e.has(t)?oe("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(t):e.set(t,r),c=(t,e,r,a)=>(j(t,e,"write to private field"),a?a.call(t,r):e.set(t,r),r),v=(t,e,r)=>(j(t,e,"access private method"),r);var ce=(t,e,r,a)=>({set _(i){c(t,e,i,r)},get _(){return s(t,e,a)}});Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var ve=Object.defineProperty,be=t=>{throw TypeError(t)},Xe=(t,e,r)=>e in t?ve(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r,Ye=(t,e)=>{for(var r in e)ve(t,r,{get:e[r],enumerable:!0})},ie=(t,e,r)=>Xe(t,typeof e!="symbol"?e+"":e,r),ye=(t,e,r)=>e.has(t)||be("Cannot "+r),N=(t,e,r)=>(ye(t,e,"read from private field"),r?r.call(t):e.get(t)),ue=(t,e,r)=>e.has(t)?be("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(t):e.set(t,r),he=(t,e,r,a)=>(ye(t,e,"write to private field"),e.set(t,r),r);function fe(t){if(!t||typeof t!="string")return[];const e=[],r=t.split("|");for(const a of r){const i=a.trim();if(i==="")continue;const l=i.indexOf(":");if(l===-1)e.push({name:i,params:[]});else{const n=i.substring(0,l).trim(),d=i.substring(l+1).trim();if(n){const u=d.split(",").map(g=>g.trim());e.push({name:n,params:u})}}}return e}function ee(t,e={},r=new Set){if(!t)return[];let a;if(typeof t=="string")a=fe(t);else if(Array.isArray(t))a=t;else return[];return a.flatMap(i=>{const l=typeof i=="string"?i.split(":")[0]:i.name;if(e[l]&&!r.has(l)){const n=new Set(r);return n.add(l),ee(e[l],e,n)}return typeof i=="string"?fe(i):[i]})}var J=(t=>(t[t.NONE=0]="NONE",t[t.ERROR=1]="ERROR",t[t.WARN=2]="WARN",t[t.INFO=3]="INFO",t[t.DEBUG=4]="DEBUG",t))(J||{}),ne=class Ee{constructor(e=0){ie(this,"level"),this.level=e}setLevel(e){this.level=e}static setLevel(e){this.globalLevel=e}format(e){return`${Ee.prefix} ${e}`}error(e,...r){this.level>=1&&console.error(this.format(e),...r)}warn(e,...r){this.level>=2&&console.warn(this.format(e),...r)}info(e,...r){this.level>=3&&console.info(this.format(e),...r)}debug(e,...r){this.level>=4&&console.debug(this.format(e),...r)}static error(e,...r){this.globalLevel>=1&&console.error(`${this.prefix} ${e}`,...r)}static warn(e,...r){this.globalLevel>=2&&console.warn(`${this.prefix} ${e}`,...r)}static info(e,...r){this.globalLevel>=3&&console.info(`${this.prefix} ${e}`,...r)}static debug(e,...r){this.globalLevel>=4&&console.debug(`${this.prefix} ${e}`,...r)}};ie(ne,"globalLevel",1);ie(ne,"prefix","[Ctrovalidate]");var je=ne,et={};Ye(et,{alpha:()=>xe,alphaDash:()=>$e,alphaNum:()=>Re,alphaSpaces:()=>nt,between:()=>Ve,creditCard:()=>qe,decimal:()=>Te,email:()=>Ae,exactLength:()=>ke,integer:()=>Me,ipAddress:()=>_e,json:()=>Ie,max:()=>we,maxLength:()=>Ne,min:()=>Ce,minLength:()=>Se,numeric:()=>Le,phone:()=>De,required:()=>Fe,sameAs:()=>Be,strongPassword:()=>ze,url:()=>Pe});var Fe=t=>t==null?!1:typeof t=="boolean"?t:String(t).trim()!=="",tt=/^[^\s@]+@[^\s@]+\.[^\s@]+$/,Ae=t=>t?tt.test(String(t)):!0,Ce=(t,e=[])=>{if(t==null||t==="")return!0;if(!e[0])return console.error("[Ctrovalidate] Missing parameter for 'min' rule."),!1;const r=Number(e[0]);return Number(t)>=r},we=(t,e=[])=>{if(t==null||t==="")return!0;if(!e[0])return console.error("[Ctrovalidate] Missing parameter for 'max' rule."),!1;const r=Number(e[0]);return Number(t)<=r},Se=(t,e=[])=>{if(t==null||t==="")return!0;if(!e[0])return console.error("[Ctrovalidate] Missing parameter for 'minLength' rule."),!1;const r=Number(e[0]);return String(t).length>=r},Ne=(t,e=[])=>{if(t==null||t==="")return!0;if(!e[0])return console.error("[Ctrovalidate] Missing parameter for 'maxLength' rule."),!1;const r=Number(e[0]);return String(t).length<=r},rt=/^[a-zA-Z]+$/,xe=t=>t?rt.test(String(t)):!0,st=/^[a-zA-Z0-9]+$/,Re=t=>t?st.test(String(t)):!0,at=/^[a-zA-Z0-9-_]+$/,$e=t=>t?at.test(String(t)):!0,it=/^[a-zA-Z\s]+$/,nt=t=>t?it.test(String(t)):!0,Le=t=>!t&&t!==0?!0:!isNaN(Number(t))&&!isNaN(parseFloat(String(t))),lt=/^-?\d+$/,Me=t=>!t&&t!==0?!0:lt.test(String(t)),ot=/^-?\d+(\.\d+)?$/,Te=t=>!t&&t!==0?!0:ot.test(String(t)),dt=/^(https?:\/\/)([\da-z.-]+)\.([a-z.]{2,6})([/\w .-]*)*\/?$/,Pe=t=>t?dt.test(String(t)):!0,ct=/^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,ut=/^(?:(?:[a-fA-F\d]{1,4}:){7}(?:[a-fA-F\d]{1,4}|:)|(?:[a-fA-F\d]{1,4}:){6}(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|:[a-fA-F\d]{1,4}|:)|(?:[a-fA-F\d]{1,4}:){5}(?::(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,2}|:)|(?:[a-fA-F\d]{1,4}:){4}(?:(?::[a-fA-F\d]{1,4}){0,1}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,3}|:)|(?:[a-fA-F\d]{1,4}:){3}(?:(?::[a-fA-F\d]{1,4}){0,2}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,4}|:)|(?:[a-fA-F\d]{1,4}:){2}(?:(?::[a-fA-F\d]{1,4}){0,3}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,5}|:)|(?:[a-fA-F\d]{1,4}:){1}(?:(?::[a-fA-F\d]{1,4}){0,4}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,6}|:)|(?::(?:(?::[a-fA-F\d]{1,4}){0,5}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,7}|:)))(?:%[0-9a-zA-Z]{1,})?$/,_e=t=>{if(!t)return!0;const e=String(t);return ct.test(e)||ut.test(e)},Ie=t=>{if(!t)return!0;try{const e=JSON.parse(String(t));return typeof e=="object"&&e!==null}catch{return!1}},ht=/^[+]?([(]?[0-9]{1,4}[)]?)[-\s.]?[0-9]{3,4}[-\s.]?[0-9]{4,6}$/,De=t=>t?ht.test(String(t)):!0,qe=t=>{if(!t)return!0;const e=String(t).replace(/[- ]/g,"");if(!/^\d+$/.test(e))return!1;let r=0;const a=e.length%2;for(let i=0;i<e.length;i++){let l=parseInt(e[i],10);i%2===a&&(l*=2,l>9&&(l-=9)),r+=l}return r%10===0},ft=/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/,ze=t=>t?ft.test(String(t)):!0,ke=(t,e=[])=>{if(t==null||t==="")return!0;if(!e[0])return console.error("[Ctrovalidate] Missing parameter for 'exactLength' rule."),!1;const r=Number(e[0]);return String(t).length===r},Ve=(t,e=[])=>{if(t==null||t==="")return!0;if(e.length<2)return console.error("[Ctrovalidate] Missing parameters for 'between' rule."),!1;const r=Number(e[0]),a=Number(e[1]);if(isNaN(r)||isNaN(a))return!1;if(!isNaN(Number(t))&&typeof t!="string"){const n=Number(t);return n>=r&&n<=a}const i=String(t);if(!isNaN(Number(i))&&i!==""){const n=Number(i);return n>=r&&n<=a}const l=i.length;return l>=r&&l<=a},Be=(t,e=[])=>{if(e.length===0||e[0]===void 0)return console.error("[Ctrovalidate] Missing parameter for 'sameAs' rule."),!1;const r=e[0];return t===r},mt={required:"This field is required.",email:"Please enter a valid email address.",min:"Minimum value is {0}.",max:"Maximum value is {0}.",minLength:"Minimum length is {0} characters.",maxLength:"Maximum length is {0} characters.",alpha:"This field may only contain alphabetic characters.",alphaNum:"This field may only contain alpha-numeric characters.",alphaDash:"This field may only contain alpha-numeric characters as well as dashes and underscores.",alphaSpaces:"This field may only contain alphabetic characters and spaces.",numeric:"This field must be a number.",integer:"This field must be an integer.",decimal:"This field must be a decimal number.",url:"Please enter a valid URL.",ipAddress:"Please enter a valid IP address.",json:"Please enter a valid JSON string.",phone:"Please enter a valid phone number.",creditCard:"Please enter a valid credit card number.",strongPassword:"Password must be at least 8 characters long and include an uppercase letter, a lowercase letter, a number, and a symbol.",exactLength:"This field must be exactly {0} characters long.",between:"This field must be between {0} and {1}.",sameAs:"This field must match {0}."},x,I,gt=class{constructor(){ue(this,x,{en:mt}),ue(this,I,"en")}setLocale(t){if(!N(this,x)[t]){console.warn(`[Ctrovalidate] Locale "${t}" not found. Falling back to "en".`),he(this,I,"en");return}he(this,I,t)}addMessages(t,e){N(this,x)[t]={...N(this,x)[t]||{},...e}}translate(t,e=[],r){const a=r||N(this,I),i=N(this,x)[a]||N(this,x).en;return(i[t]||i.default||"Invalid input.").replace(/{(\d+)}/g,(n,d)=>{const u=parseInt(d,10);return e[u]!==void 0?String(e[u]):n})}get currentLocale(){return N(this,I)}};x=new WeakMap;I=new WeakMap;new gt;var D,B,q,R,U,K,C,We,re,se;const Q=class Q{constructor({errorClass:e="ctrovalidate-error",errorMessageClass:r="ctrovalidate-error-message",pendingClass:a="ctrovalidate-pending"}){o(this,C);o(this,D);o(this,B);o(this,q);o(this,R,new WeakMap);o(this,U,new WeakMap);c(this,D,e),c(this,B,r),c(this,q,a)}displayError(e,r){const a=v(this,C,se).call(this,e);s(this,D).split(/\s+/).filter(Boolean).forEach(i=>e.classList.add(i)),e.setAttribute("aria-invalid","true"),a&&(a.textContent=r,a.style.display="",e.setAttribute("aria-describedby",a.id))}clearError(e){const r=v(this,C,se).call(this,e);s(this,D).split(/\s+/).filter(Boolean).forEach(a=>e.classList.remove(a)),e.removeAttribute("aria-invalid"),r&&(r.textContent="",r.style.display="none",e.getAttribute("aria-describedby")===r.id&&e.removeAttribute("aria-describedby"))}showPending(e){this.clearError(e),s(this,q).split(/\s+/).filter(Boolean).forEach(r=>e.classList.add(r))}hidePending(e){s(this,q).split(/\s+/).filter(Boolean).forEach(r=>e.classList.remove(r))}};D=new WeakMap,B=new WeakMap,q=new WeakMap,R=new WeakMap,U=new WeakMap,K=new WeakMap,C=new WeakSet,We=function(e){return typeof CSS<"u"&&typeof CSS.escape=="function"?CSS.escape(e):e.replace(/([!"#$%&'()*+,./:;<=>?@[\\\]^`{|}~[\]])/g,"\\$1")},re=function(e){let r;if((e instanceof HTMLInputElement||e instanceof HTMLSelectElement||e instanceof HTMLTextAreaElement)&&(r=e.name),r&&r.trim().length>0)return`ctrovalidate-error-${r.replace(/\s+/g,"-").replace(/[^A-Za-z0-9\-_:.]/g,"")}`;const a=`ctrovalidate-error-${ce(Q,K)._++}`;return s(this,U).set(e,a),a},se=function(e){if(s(this,R).has(e))return s(this,R).get(e)||null;const r=s(this,B).split(/\s+/).filter(Boolean);let a=e.parentElement,i=0;const l=3;for(;a&&i<l;){for(const g of r){const S=`.${v(this,C,We).call(this,g)}`,f=a.querySelector(S);if(f)return f.id||(f.id=v(this,C,re).call(this,e)),s(this,R).set(e,f),f}a=a.parentElement,i++}const n=e.parentElement;if(!n)return null;const d=document.createElement("div");d.className=r.join(" "),d.style.display="none",d.role="status",d.setAttribute("aria-live","polite");const u=v(this,C,re).call(this,e);d.id=u;try{e.insertAdjacentElement("afterend",d)}catch{n.appendChild(d)}return s(this,R).set(e,d),d},o(Q,K,0);let te=Q;var b,w,W,Z,H,O,X,Ze;class pt{constructor(e,{logger:r,uiManager:a,rules:i,asyncRules:l,messages:n}){o(this,X);o(this,b);o(this,w);o(this,W);o(this,Z);o(this,H);o(this,O);c(this,W,e),c(this,b,r),c(this,w,a),c(this,Z,i),c(this,H,l),c(this,O,n)}async validateField(e){const{element:r,rules:a,state:i,dependency:l}=e;if(!v(this,X,Ze).call(this,l))return s(this,b).debug(`[RuleEngine] Dependency for "${r.name}" not met. Skipping validation.`),s(this,w).clearError(r),e.state.lastError=null,!0;const n=r,d=n.type==="checkbox"?n.checked:n.value;i.abortController&&(i.abortController.abort(),s(this,b).debug(`[RuleEngine] Aborted previous validation for "${n.name}".`));for(const u of a){const g=s(this,Z)[u.name],S=s(this,H)[u.name];if(!g&&!S){s(this,b).warn(`[RuleEngine] Unknown rule "${u.name}" used on field:`,r);continue}let f=!1;if(g)f=g(d,u.params,r);else if(S){i.abortController=new AbortController,s(this,w).showPending(r);try{f=await S(d,u.params,r,i.abortController.signal)}catch(p){if(p instanceof Error&&p.name==="AbortError")return s(this,b).debug(`[RuleEngine] Async validation for "${n.name}" was successfully aborted.`),!0;s(this,b).error(`[RuleEngine] Async rule "${u.name}" threw an error.`,[p]),f=!1}finally{s(this,w).hidePending(r),i.abortController=null}}if(!f){let p=s(this,O)[u.name]||"Invalid input.";e.customMessages&&(e.customMessages[u.name]?p=e.customMessages[u.name]:e.customMessages["*"]&&(p=e.customMessages["*"]));const _=p.replace(/{(\d+)}/g,(Je,Ue)=>{const le=parseInt(Ue,10);return u.params[le]!==void 0?String(u.params[le]):Je});return s(this,w).displayError(r,_),e.state.lastError=_,s(this,b).debug(`[RuleEngine] Field validation failed for "${n.name}" on rule "${u.name}".`),!1}}return s(this,w).clearError(r),e.state.lastError=null,s(this,b).debug(`[RuleEngine] Field validation succeeded for "${n.name}".`),!0}}b=new WeakMap,w=new WeakMap,W=new WeakMap,Z=new WeakMap,H=new WeakMap,O=new WeakMap,X=new WeakSet,Ze=function(e){if(!e)return!0;const r=s(this,W).querySelector(`[name="${e.controllerName}"]`);if(!r)return!1;switch(e.type){case"checked":return r.checked;case"value":return r.value===e.value;case"present":return!!r.value;default:return!1}};var $,y,E,m,z,k,L,P,ae,He;class vt{constructor(e,{logger:r,schema:a={},aliases:i={},validationHandler:l}){o(this,P);o(this,$);o(this,y,[]);o(this,E,new Map);o(this,m);o(this,z);o(this,k);o(this,L);c(this,$,e),c(this,m,r),c(this,z,a),c(this,k,i),c(this,L,l)}discoverFields(){c(this,y,[]),s(this,E).clear();const e=s(this,$).querySelectorAll("[data-ctrovalidate-rules]");s(this,m).debug("[FormController] Discovered "+e.length+" fields to validate."),e.forEach(r=>this.addField(r,!1)),Object.keys(s(this,z)).forEach(r=>{const a=s(this,$).querySelector(`[name="${r}"]`);a&&!s(this,E).has(a)&&this.addField(a,!1)})}addField(e,r=!0){if(!e||s(this,E).has(e))return;const a=e.getAttribute("data-ctrovalidate-rules"),i=e.getAttribute("data-ctrovalidate-if"),l=e.name,n=ee(a||"",s(this,k)),d=l?ee(s(this,z)[l]||[],s(this,k)):[],u=[...n,...d];if(u.length===0&&!i)return;const g={},S=e.getAttribute("data-ctrovalidate-message");S&&(g["*"]=S);for(const p of Array.from(e.attributes))if(p.name.startsWith("data-ctrovalidate-")&&p.name.endsWith("-message")){const _=p.name.replace("data-ctrovalidate-","").replace("-message","");_!==""&&_!=="message"&&(g[_]=p.value)}const f={element:e,rules:u,dependency:v(this,P,He).call(this,i),customMessages:Object.keys(g).length>0?g:void 0,state:{isDirty:!1,abortController:null,lastError:null}};s(this,y).push(f),s(this,E).set(e,f),s(this,m).debug("[FormController] Added field:",e),r&&v(this,P,ae).call(this,f)}removeField(e){if(!e||!s(this,E).has(e))return;const r=s(this,E).get(e);if(c(this,y,s(this,y).filter(a=>a.element!==e)),r.listeners){const{onBlur:a,onInput:i,onControllerInput:l,controllerElement:n}=r.listeners;try{e.removeEventListener("blur",a),e.removeEventListener("input",i),n&&l&&n.removeEventListener("input",l)}catch(d){s(this,m).debug("[FormController] Error while removing listeners for",e,d)}delete r.listeners}s(this,E).delete(e),s(this,m).debug("[FormController] Removed field:",e)}attachEventListeners(e){if(!e){s(this,m).info("[FormController] Real-time validation is disabled.");return}s(this,m).info("[FormController] Real-time validation is enabled. Attaching listeners."),s(this,y).forEach(r=>v(this,P,ae).call(this,r))}reset(){s(this,y).forEach(e=>{e.state.isDirty=!1,e.state.lastError=null})}destroy(){[...s(this,y)].forEach(e=>{this.removeField(e.element)})}getFields(){return s(this,y)}}$=new WeakMap,y=new WeakMap,E=new WeakMap,m=new WeakMap,z=new WeakMap,k=new WeakMap,L=new WeakMap,P=new WeakSet,ae=function(e){const{element:r,dependency:a}=e;if(e.listeners)return;const i=()=>{s(this,m).debug(`[FormController] Blur event on "${r.name}". Validating.`),s(this,L).call(this,e),e.state.isDirty=!0},l=()=>{e.state.isDirty&&(s(this,m).debug(`[FormController] Input event on dirty field "${r.name}". Validating.`),s(this,L).call(this,e))};r.addEventListener("blur",i),r.addEventListener("input",l);let n=null,d=null;a&&(n=s(this,$).querySelector(`[name="${a.controllerName}"]`),n?(d=()=>{s(this,m).debug(`[FormController] Controller "${n.name}" changed. Re-validating dependent field "${r.name}".`),s(this,L).call(this,e)},n.addEventListener("input",d)):s(this,m).warn(`[FormController] Could not find controller field with name "${a.controllerName}".`)),e.listeners={onBlur:i,onInput:l,onControllerInput:d,controllerElement:n}},He=function(e){if(!e)return null;const r=e.split(":"),a=r[0],i=r[1]||"present";if(!a)return null;if(i.includes("=")){const[l,n]=i.split("=");return{controllerName:a,type:l,value:n}}else return{controllerName:a,type:i}};const bt=(t,e)=>{const r=t;if(!r.form)return"";const a=r.form.querySelector(`[name="${e}"]`);return a?a.value:""},yt=(t,e=[],r=null)=>{const a=String(e[0]||"");if(a===void 0)return console.error("[Ctrovalidate] Missing parameter for 'sameAs' rule."),!1;if(!r)return!1;const i=bt(r,a);return Be(t,[i])},Et=Object.freeze(Object.defineProperty({__proto__:null,alpha:xe,alphaDash:$e,alphaNum:Re,between:Ve,creditCard:qe,decimal:Te,email:Ae,exactLength:ke,integer:Me,ipAddress:_e,json:Ie,max:we,maxLength:Ne,min:Ce,minLength:Se,numeric:Le,phone:De,required:Fe,sameAs:yt,strongPassword:ze,url:Pe},Symbol.toStringTag,{value:"Module"})),me={...Et},ge={},pe={},Ft={required:"This field is required.",minLength:"This field must be at least {0} characters long.",maxLength:"This field cannot be longer than {0} characters.",between:"This field must be between {0} and {1} characters long.",email:"Please enter a valid email address.",phone:"Please enter a valid phone number.",url:"Please enter a valid URL.",numeric:"This field must contain only numbers.",alpha:"This field must contain only letters.",alphaDash:"This field must contain only letters, numbers, and dashes.",alphaSpaces:"This field must contain only letters and spaces.",alphaNum:"This field must contain only letters and numbers.",decimal:"This field must be a valid decimal number.",integer:"This field must be a valid integer.",min:"This field must be at least {0}.",max:"This field cannot be more than {0}.",exactLength:"This field must be exactly {0} characters long.",format:"This field format is invalid.",sameAs:"This field must match {0}.",strongPassword:"Password must be at least 8 characters long and contain at least one uppercase letter, one lowercase letter, one number, and one special character.",creditCard:"Please enter a valid credit card number.",ipAddress:"Please enter a valid IP address.",json:"Please enter a valid JSON string."},G={...Ft};function At(t){Object.assign(G,t)}var M,F,A,T,V,h,Y,Ge;class Oe{constructor(e,r={}){o(this,Y);o(this,M);o(this,F);o(this,A);o(this,T);o(this,V);o(this,h);if(!(e instanceof HTMLFormElement))throw new Error("Ctrovalidate requires a valid HTMLFormElement to be initialized.");c(this,M,e),c(this,F,{logLevel:J.NONE,errorClass:"is-invalid",errorMessageClass:"error-message",pendingClass:"ctrovalidate-pending",realTime:!0,schema:{},aliases:{},...r}),c(this,A,new je(s(this,F).logLevel)),c(this,T,new te(s(this,F))),c(this,V,new pt(s(this,M),{logger:s(this,A),uiManager:s(this,T),rules:me,asyncRules:ge,messages:G})),c(this,h,new vt(s(this,M),{logger:s(this,A),schema:s(this,F).schema,aliases:{...pe,...s(this,F).aliases},validationHandler:a=>s(this,V).validateField(a)})),v(this,Y,Ge).call(this)}static defineAlias(e,r){pe[e]=r}async validate(){return this.validateForm()}async validateForm(){s(this,A).info("[Ctrovalidate] Manually triggering form validation.");const e=s(this,h).getFields(),a=(await Promise.all(e.map(i=>s(this,V).validateField(i)))).every(i=>i===!0);return a?s(this,A).info("[Ctrovalidate] Form validation succeeded."):s(this,A).warn("[Ctrovalidate] Form validation failed."),a}static setCustomMessages(e){At(e)}static addRule(e,r,a){if(!e||typeof r!="function"){console.error("[Ctrovalidate] addRule requires a rule name and a logic function.");return}me[e]=r,a&&(G[e]=a)}static addAsyncRule(e,r,a){if(!e||typeof r!="function"){console.error("[Ctrovalidate] addAsyncRule requires a rule name and a logic function.");return}ge[e]=r,a&&(G[e]=a)}addField(e){s(this,h).addField(e)}removeField(e){s(this,h).removeField(e)}refresh(){s(this,h).discoverFields(),s(this,h).attachEventListeners(s(this,F).realTime)}getError(e){const r=s(this,h).getFields().find(a=>a.element.name===e);return r?r.state.lastError:null}isDirty(e){const r=s(this,h).getFields().find(a=>a.element.name===e);return r?r.state.isDirty:!1}reset(){s(this,h).reset(),s(this,h).getFields().forEach(e=>{s(this,T).clearError(e.element)})}destroy(){s(this,h).destroy(),s(this,h).getFields().forEach(e=>{s(this,T).clearError(e.element)})}}M=new WeakMap,F=new WeakMap,A=new WeakMap,T=new WeakMap,V=new WeakMap,h=new WeakMap,Y=new WeakSet,Ge=function(){s(this,A).info("[Ctrovalidate] Initializing library."),s(this,h).discoverFields(),s(this,h).attachEventListeners(s(this,F).realTime),s(this,M).setAttribute("novalidate","true")},de(Oe,"LogLevel",J);exports.Ctrovalidate=Oe;exports.LogLevel=J;

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+import { AsyncRuleLogic as AsyncRuleLogic_2 } from 'ctrovalidate-core';
+import { DependencyDefinition } from 'ctrovalidate-core';
+import { LogLevel } from 'ctrovalidate-core';
+import { RuleDefinition } from 'ctrovalidate-core';
+import { RuleLogic as RuleLogic_2 } from 'ctrovalidate-core';
+import { SchemaRule } from 'ctrovalidate-core';
+import { ValidationResult } from 'ctrovalidate-core';
+import { ValidationSchema } from 'ctrovalidate-core';
+
+/**
+ * The logic function for an asynchronous validation rule (Browser context).
+ */
+export declare type AsyncRuleLogic = AsyncRuleLogic_2<HTMLElement>;
+
+/**
+ * The main public-facing class for the Ctrovalidate library.
+ */
+export declare class Ctrovalidate {
+    #private;
+    static LogLevel: typeof LogLevel;
+    /**
+     * @param formElement - The HTML form element to validate.
+     * @param options - Custom configuration options.
+     */
+    constructor(formElement: HTMLFormElement, options?: CtrovalidateOptions);
+    /**
+     * Defines a rule alias (macro) globally.
+     */
+    static defineAlias(name: string, rules: SchemaRule): void;
+    /**
+     * Validates the entire form programmatically.
+     */
+    validate(): Promise<boolean>;
+    /**
+     * Validates the entire form programmatically.
+     */
+    validateForm(): Promise<boolean>;
+    /**
+     * Allows the user to add custom validation messages globally.
+     */
+    static setCustomMessages(customMessages: Record<string, string>): void;
+    /**
+     * Adds a custom synchronous validation rule globally.
+     */
+    static addRule(name: string, logic: RuleLogic, message?: string): void;
+    /**
+     * Adds a custom asynchronous validation rule globally.
+     */
+    static addAsyncRule(name: string, logic: AsyncRuleLogic, message?: string): void;
+    /**
+     * Manually adds a new field to be validated.
+     */
+    addField(element: HTMLElement): void;
+    /**
+     * Manually removes a field from validation.
+     */
+    removeField(element: HTMLElement): void;
+    /**
+     * Refreshes the discovered fields. Use if fields are added or removed from the DOM.
+     */
+    refresh(): void;
+    /**
+     * Returns the current error for a field by its name.
+     */
+    getError(fieldName: string): string | null;
+    /**
+     * Checks if a field has been interacted with.
+     */
+    isDirty(fieldName: string): boolean;
+    /**
+     * Resets the validation state of the form.
+     */
+    reset(): void;
+    /**
+     * Fully cleans up the validator instance.
+     */
+    destroy(): void;
+}
+
+/**
+ * Configuration options for a Ctrovalidate instance.
+ */
+export declare interface CtrovalidateOptions {
+    logLevel?: number;
+    errorClass?: string;
+    errorMessageClass?: string;
+    pendingClass?: string;
+    realTime?: boolean;
+    schema?: ValidationSchema;
+    aliases?: Record<string, SchemaRule>;
+}
+
+export { DependencyDefinition }
+
+/**
+ * The object representing a field being validated.
+ */
+export declare interface FieldObject {
+    element: HTMLElement;
+    rules: RuleDefinition[];
+    state: FieldState;
+    dependency: DependencyDefinition | null;
+    customMessages?: Record<string, string>;
+    listeners?: {
+        onBlur: (e: Event) => void;
+        onInput: (e: Event) => void;
+        onControllerInput: ((e: Event) => void) | null;
+        controllerElement: HTMLElement | null;
+    };
+}
+
+/**
+ * The state of a single validatable field.
+ */
+export declare interface FieldState {
+    isDirty: boolean;
+    abortController: AbortController | null;
+    lastError: string | null;
+}
+
+export { LogLevel }
+
+export { RuleDefinition }
+
+/**
+ * The logic function for a synchronous validation rule (Browser context).
+ * Context is strictly HTMLElement here.
+ */
+export declare type RuleLogic = RuleLogic_2<HTMLElement>;
+
+export { SchemaRule }
+
+export { ValidationResult }
+
+export { ValidationSchema }
+
+export { }

package/dist/index.js

@@ -0,0 +1,861 @@
+var Ue = Object.defineProperty;
+var oe = (t) => {
+  throw TypeError(t);
+};
+var Ke = (t, e, r) => e in t ? Ue(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r;
+var de = (t, e, r) => Ke(t, typeof e != "symbol" ? e + "" : e, r), Y = (t, e, r) => e.has(t) || oe("Cannot " + r);
+var s = (t, e, r) => (Y(t, e, "read from private field"), r ? r.call(t) : e.get(t)), o = (t, e, r) => e.has(t) ? oe("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(t) : e.set(t, r), c = (t, e, r, a) => (Y(t, e, "write to private field"), a ? a.call(t, r) : e.set(t, r), r), v = (t, e, r) => (Y(t, e, "access private method"), r);
+var ce = (t, e, r, a) => ({
+  set _(i) {
+    c(t, e, i, r);
+  },
+  get _() {
+    return s(t, e, a);
+  }
+});
+var ve = Object.defineProperty, be = (t) => {
+  throw TypeError(t);
+}, Qe = (t, e, r) => e in t ? ve(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r, Xe = (t, e) => {
+  for (var r in e)
+    ve(t, r, { get: e[r], enumerable: !0 });
+}, ie = (t, e, r) => Qe(t, typeof e != "symbol" ? e + "" : e, r), ye = (t, e, r) => e.has(t) || be("Cannot " + r), S = (t, e, r) => (ye(t, e, "read from private field"), r ? r.call(t) : e.get(t)), ue = (t, e, r) => e.has(t) ? be("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(t) : e.set(t, r), he = (t, e, r, a) => (ye(t, e, "write to private field"), e.set(t, r), r);
+function fe(t) {
+  if (!t || typeof t != "string")
+    return [];
+  const e = [], r = t.split("|");
+  for (const a of r) {
+    const i = a.trim();
+    if (i === "")
+      continue;
+    const l = i.indexOf(":");
+    if (l === -1)
+      e.push({ name: i, params: [] });
+    else {
+      const n = i.substring(0, l).trim(), d = i.substring(l + 1).trim();
+      if (n) {
+        const u = d.split(",").map((g) => g.trim());
+        e.push({ name: n, params: u });
+      }
+    }
+  }
+  return e;
+}
+function j(t, e = {}, r = /* @__PURE__ */ new Set()) {
+  if (!t) return [];
+  let a;
+  if (typeof t == "string")
+    a = fe(t);
+  else if (Array.isArray(t))
+    a = t;
+  else
+    return [];
+  return a.flatMap((i) => {
+    const l = typeof i == "string" ? i.split(":")[0] : i.name;
+    if (e[l] && !r.has(l)) {
+      const n = new Set(r);
+      return n.add(l), j(e[l], e, n);
+    }
+    return typeof i == "string" ? fe(i) : [i];
+  });
+}
+var ee = /* @__PURE__ */ ((t) => (t[t.NONE = 0] = "NONE", t[t.ERROR = 1] = "ERROR", t[t.WARN = 2] = "WARN", t[t.INFO = 3] = "INFO", t[t.DEBUG = 4] = "DEBUG", t))(ee || {}), ne = class Ee {
+  constructor(e = 0) {
+    ie(this, "level"), this.level = e;
+  }
+  setLevel(e) {
+    this.level = e;
+  }
+  static setLevel(e) {
+    this.globalLevel = e;
+  }
+  format(e) {
+    return `${Ee.prefix} ${e}`;
+  }
+  // Instance methods
+  error(e, ...r) {
+    this.level >= 1 && console.error(this.format(e), ...r);
+  }
+  warn(e, ...r) {
+    this.level >= 2 && console.warn(this.format(e), ...r);
+  }
+  info(e, ...r) {
+    this.level >= 3 && console.info(this.format(e), ...r);
+  }
+  debug(e, ...r) {
+    this.level >= 4 && console.debug(this.format(e), ...r);
+  }
+  // Static methods (using global level)
+  static error(e, ...r) {
+    this.globalLevel >= 1 && console.error(`${this.prefix} ${e}`, ...r);
+  }
+  static warn(e, ...r) {
+    this.globalLevel >= 2 && console.warn(`${this.prefix} ${e}`, ...r);
+  }
+  static info(e, ...r) {
+    this.globalLevel >= 3 && console.info(`${this.prefix} ${e}`, ...r);
+  }
+  static debug(e, ...r) {
+    this.globalLevel >= 4 && console.debug(`${this.prefix} ${e}`, ...r);
+  }
+};
+ie(
+  ne,
+  "globalLevel",
+  1
+  /* ERROR */
+);
+ie(ne, "prefix", "[Ctrovalidate]");
+var Ye = ne, je = {};
+Xe(je, {
+  alpha: () => xe,
+  alphaDash: () => $e,
+  alphaNum: () => Re,
+  alphaSpaces: () => it,
+  between: () => Ve,
+  creditCard: () => qe,
+  decimal: () => Te,
+  email: () => Ae,
+  exactLength: () => ke,
+  integer: () => Le,
+  ipAddress: () => _e,
+  json: () => Ie,
+  max: () => we,
+  maxLength: () => Se,
+  min: () => Ce,
+  minLength: () => Ne,
+  numeric: () => Me,
+  phone: () => De,
+  required: () => Fe,
+  sameAs: () => Be,
+  strongPassword: () => ze,
+  url: () => Pe
+});
+var Fe = (t) => t == null ? !1 : typeof t == "boolean" ? t : String(t).trim() !== "", et = /^[^\s@]+@[^\s@]+\.[^\s@]+$/, Ae = (t) => t ? et.test(String(t)) : !0, Ce = (t, e = []) => {
+  if (t == null || t === "") return !0;
+  if (!e[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'min' rule."), !1;
+  const r = Number(e[0]);
+  return Number(t) >= r;
+}, we = (t, e = []) => {
+  if (t == null || t === "") return !0;
+  if (!e[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'max' rule."), !1;
+  const r = Number(e[0]);
+  return Number(t) <= r;
+}, Ne = (t, e = []) => {
+  if (t == null || t === "") return !0;
+  if (!e[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'minLength' rule."), !1;
+  const r = Number(e[0]);
+  return String(t).length >= r;
+}, Se = (t, e = []) => {
+  if (t == null || t === "") return !0;
+  if (!e[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'maxLength' rule."), !1;
+  const r = Number(e[0]);
+  return String(t).length <= r;
+}, tt = /^[a-zA-Z]+$/, xe = (t) => t ? tt.test(String(t)) : !0, rt = /^[a-zA-Z0-9]+$/, Re = (t) => t ? rt.test(String(t)) : !0, st = /^[a-zA-Z0-9-_]+$/, $e = (t) => t ? st.test(String(t)) : !0, at = /^[a-zA-Z\s]+$/, it = (t) => t ? at.test(String(t)) : !0, Me = (t) => !t && t !== 0 ? !0 : !isNaN(Number(t)) && !isNaN(parseFloat(String(t))), nt = /^-?\d+$/, Le = (t) => !t && t !== 0 ? !0 : nt.test(String(t)), lt = /^-?\d+(\.\d+)?$/, Te = (t) => !t && t !== 0 ? !0 : lt.test(String(t)), ot = /^(https?:\/\/)([\da-z.-]+)\.([a-z.]{2,6})([/\w .-]*)*\/?$/, Pe = (t) => t ? ot.test(String(t)) : !0, dt = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/, ct = /^(?:(?:[a-fA-F\d]{1,4}:){7}(?:[a-fA-F\d]{1,4}|:)|(?:[a-fA-F\d]{1,4}:){6}(?:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|:[a-fA-F\d]{1,4}|:)|(?:[a-fA-F\d]{1,4}:){5}(?::(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,2}|:)|(?:[a-fA-F\d]{1,4}:){4}(?:(?::[a-fA-F\d]{1,4}){0,1}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,3}|:)|(?:[a-fA-F\d]{1,4}:){3}(?:(?::[a-fA-F\d]{1,4}){0,2}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,4}|:)|(?:[a-fA-F\d]{1,4}:){2}(?:(?::[a-fA-F\d]{1,4}){0,3}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,5}|:)|(?:[a-fA-F\d]{1,4}:){1}(?:(?::[a-fA-F\d]{1,4}){0,4}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,6}|:)|(?::(?:(?::[a-fA-F\d]{1,4}){0,5}:(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)(?:\\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]\d|\d)){3}|(?::[a-fA-F\d]{1,4}){1,7}|:)))(?:%[0-9a-zA-Z]{1,})?$/, _e = (t) => {
+  if (!t) return !0;
+  const e = String(t);
+  return dt.test(e) || ct.test(e);
+}, Ie = (t) => {
+  if (!t) return !0;
+  try {
+    const e = JSON.parse(String(t));
+    return typeof e == "object" && e !== null;
+  } catch {
+    return !1;
+  }
+}, ut = /^[+]?([(]?[0-9]{1,4}[)]?)[-\s.]?[0-9]{3,4}[-\s.]?[0-9]{4,6}$/, De = (t) => t ? ut.test(String(t)) : !0, qe = (t) => {
+  if (!t) return !0;
+  const e = String(t).replace(/[- ]/g, "");
+  if (!/^\d+$/.test(e)) return !1;
+  let r = 0;
+  const a = e.length % 2;
+  for (let i = 0; i < e.length; i++) {
+    let l = parseInt(e[i], 10);
+    i % 2 === a && (l *= 2, l > 9 && (l -= 9)), r += l;
+  }
+  return r % 10 === 0;
+}, ht = /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/, ze = (t) => t ? ht.test(String(t)) : !0, ke = (t, e = []) => {
+  if (t == null || t === "") return !0;
+  if (!e[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'exactLength' rule."), !1;
+  const r = Number(e[0]);
+  return String(t).length === r;
+}, Ve = (t, e = []) => {
+  if (t == null || t === "") return !0;
+  if (e.length < 2)
+    return console.error("[Ctrovalidate] Missing parameters for 'between' rule."), !1;
+  const r = Number(e[0]), a = Number(e[1]);
+  if (isNaN(r) || isNaN(a))
+    return !1;
+  if (!isNaN(Number(t)) && typeof t != "string") {
+    const n = Number(t);
+    return n >= r && n <= a;
+  }
+  const i = String(t);
+  if (!isNaN(Number(i)) && i !== "") {
+    const n = Number(i);
+    return n >= r && n <= a;
+  }
+  const l = i.length;
+  return l >= r && l <= a;
+}, Be = (t, e = []) => {
+  if (e.length === 0 || e[0] === void 0)
+    return console.error("[Ctrovalidate] Missing parameter for 'sameAs' rule."), !1;
+  const r = e[0];
+  return t === r;
+}, ft = {
+  required: "This field is required.",
+  email: "Please enter a valid email address.",
+  min: "Minimum value is {0}.",
+  max: "Maximum value is {0}.",
+  minLength: "Minimum length is {0} characters.",
+  maxLength: "Maximum length is {0} characters.",
+  alpha: "This field may only contain alphabetic characters.",
+  alphaNum: "This field may only contain alpha-numeric characters.",
+  alphaDash: "This field may only contain alpha-numeric characters as well as dashes and underscores.",
+  alphaSpaces: "This field may only contain alphabetic characters and spaces.",
+  numeric: "This field must be a number.",
+  integer: "This field must be an integer.",
+  decimal: "This field must be a decimal number.",
+  url: "Please enter a valid URL.",
+  ipAddress: "Please enter a valid IP address.",
+  json: "Please enter a valid JSON string.",
+  phone: "Please enter a valid phone number.",
+  creditCard: "Please enter a valid credit card number.",
+  strongPassword: "Password must be at least 8 characters long and include an uppercase letter, a lowercase letter, a number, and a symbol.",
+  exactLength: "This field must be exactly {0} characters long.",
+  between: "This field must be between {0} and {1}.",
+  sameAs: "This field must match {0}."
+}, x, I, mt = class {
+  constructor() {
+    ue(this, x, { en: ft }), ue(this, I, "en");
+  }
+  /**
+   * Set the current locale.
+   */
+  setLocale(t) {
+    if (!S(this, x)[t]) {
+      console.warn(
+        `[Ctrovalidate] Locale "${t}" not found. Falling back to "en".`
+      ), he(this, I, "en");
+      return;
+    }
+    he(this, I, t);
+  }
+  /**
+   * Add or update messages for a specific locale.
+   */
+  addMessages(t, e) {
+    S(this, x)[t] = {
+      ...S(this, x)[t] || {},
+      ...e
+    };
+  }
+  /**
+   * Translates a rule name with optional parameters.
+   */
+  translate(t, e = [], r) {
+    const a = r || S(this, I), i = S(this, x)[a] || S(this, x).en;
+    return (i[t] || i.default || "Invalid input.").replace(/{(\d+)}/g, (n, d) => {
+      const u = parseInt(d, 10);
+      return e[u] !== void 0 ? String(e[u]) : n;
+    });
+  }
+  /**
+   * Get the current active locale.
+   */
+  get currentLocale() {
+    return S(this, I);
+  }
+};
+x = /* @__PURE__ */ new WeakMap();
+I = /* @__PURE__ */ new WeakMap();
+new mt();
+var D, B, q, R, J, U, C, We, re, se;
+const K = class K {
+  constructor({
+    errorClass: e = "ctrovalidate-error",
+    errorMessageClass: r = "ctrovalidate-error-message",
+    pendingClass: a = "ctrovalidate-pending"
+  }) {
+    o(this, C);
+    o(this, D);
+    o(this, B);
+    o(this, q);
+    // Cache field -> found error element
+    o(this, R, /* @__PURE__ */ new WeakMap());
+    // Optional map to store generated IDs per field when we create an element
+    o(this, J, /* @__PURE__ */ new WeakMap());
+    c(this, D, e), c(this, B, r), c(this, q, a);
+  }
+  /**
+   * Display a validation error message for the given field.
+   * Applies configured error classes and ARIA attributes.
+   */
+  displayError(e, r) {
+    const a = v(this, C, se).call(this, e);
+    s(this, D).split(/\s+/).filter(Boolean).forEach((i) => e.classList.add(i)), e.setAttribute("aria-invalid", "true"), a && (a.textContent = r, a.style.display = "", e.setAttribute("aria-describedby", a.id));
+  }
+  /**
+   * Clear the validation error message and related styling/ARIA attributes.
+   */
+  clearError(e) {
+    const r = v(this, C, se).call(this, e);
+    s(this, D).split(/\s+/).filter(Boolean).forEach((a) => e.classList.remove(a)), e.removeAttribute("aria-invalid"), r && (r.textContent = "", r.style.display = "none", e.getAttribute("aria-describedby") === r.id && e.removeAttribute("aria-describedby"));
+  }
+  /**
+   * Show pending state for a field (async validation).
+   */
+  showPending(e) {
+    this.clearError(e), s(this, q).split(/\s+/).filter(Boolean).forEach((r) => e.classList.add(r));
+  }
+  /**
+   * Hide pending state for a field.
+   */
+  hidePending(e) {
+    s(this, q).split(/\s+/).filter(Boolean).forEach((r) => e.classList.remove(r));
+  }
+};
+D = new WeakMap(), B = new WeakMap(), q = new WeakMap(), R = new WeakMap(), J = new WeakMap(), U = new WeakMap(), C = new WeakSet(), /**
+ * Safely escape a class name for use in querySelector.
+ * Uses CSS.escape when available, otherwise falls back to a robust regex.
+ */
+We = function(e) {
+  return typeof CSS < "u" && typeof CSS.escape == "function" ? CSS.escape(e) : e.replace(/([!"#$%&'()*+,./:;<=>?@[\\\]^`{|}~[\]])/g, "\\$1");
+}, /**
+ * Build a DOM id from the field (name if available) or a generated counter.
+ */
+re = function(e) {
+  let r;
+  if ((e instanceof HTMLInputElement || e instanceof HTMLSelectElement || e instanceof HTMLTextAreaElement) && (r = e.name), r && r.trim().length > 0)
+    return `ctrovalidate-error-${r.replace(/\s+/g, "-").replace(/[^A-Za-z0-9\-_:.]/g, "")}`;
+  const a = `ctrovalidate-error-${ce(K, U)._++}`;
+  return s(this, J).set(e, a), a;
+}, /**
+ * Finds (or creates) the dedicated error message container for a given input field.
+ * Supports multiple classes in `errorMessageClass` by trying each class individually.
+ */
+se = function(e) {
+  if (s(this, R).has(e))
+    return s(this, R).get(e) || null;
+  const r = s(this, B).split(/\s+/).filter(Boolean);
+  let a = e.parentElement, i = 0;
+  const l = 3;
+  for (; a && i < l; ) {
+    for (const g of r) {
+      const N = `.${v(this, C, We).call(this, g)}`, f = a.querySelector(
+        N
+      );
+      if (f)
+        return f.id || (f.id = v(this, C, re).call(this, e)), s(this, R).set(e, f), f;
+    }
+    a = a.parentElement, i++;
+  }
+  const n = e.parentElement;
+  if (!n) return null;
+  const d = document.createElement("div");
+  d.className = r.join(" "), d.style.display = "none", d.role = "status", d.setAttribute("aria-live", "polite");
+  const u = v(this, C, re).call(this, e);
+  d.id = u;
+  try {
+    e.insertAdjacentElement("afterend", d);
+  } catch {
+    n.appendChild(d);
+  }
+  return s(this, R).set(e, d), d;
+}, // Global unique id counter for fallback ids
+o(K, U, 0);
+let te = K;
+var b, w, W, Z, H, O, Q, Ze;
+class gt {
+  /**
+   * @param formElement - The form element.
+   * @param dependencies - Core dependencies.
+   */
+  constructor(e, { logger: r, uiManager: a, rules: i, asyncRules: l, messages: n }) {
+    o(this, Q);
+    o(this, b);
+    o(this, w);
+    o(this, W);
+    o(this, Z);
+    o(this, H);
+    o(this, O);
+    c(this, W, e), c(this, b, r), c(this, w, a), c(this, Z, i), c(this, H, l), c(this, O, n);
+  }
+  /**
+   * The core logic for validating a single field.
+   */
+  async validateField(e) {
+    const { element: r, rules: a, state: i, dependency: l } = e;
+    if (!v(this, Q, Ze).call(this, l))
+      return s(this, b).debug(
+        `[RuleEngine] Dependency for "${r.name}" not met. Skipping validation.`
+      ), s(this, w).clearError(r), e.state.lastError = null, !0;
+    const n = r, d = n.type === "checkbox" ? n.checked : n.value;
+    i.abortController && (i.abortController.abort(), s(this, b).debug(
+      `[RuleEngine] Aborted previous validation for "${n.name}".`
+    ));
+    for (const u of a) {
+      const g = s(this, Z)[u.name], N = s(this, H)[u.name];
+      if (!g && !N) {
+        s(this, b).warn(
+          `[RuleEngine] Unknown rule "${u.name}" used on field:`,
+          r
+        );
+        continue;
+      }
+      let f = !1;
+      if (g)
+        f = g(d, u.params, r);
+      else if (N) {
+        i.abortController = new AbortController(), s(this, w).showPending(r);
+        try {
+          f = await N(
+            d,
+            u.params,
+            r,
+            i.abortController.signal
+          );
+        } catch (p) {
+          if (p instanceof Error && p.name === "AbortError")
+            return s(this, b).debug(
+              `[RuleEngine] Async validation for "${n.name}" was successfully aborted.`
+            ), !0;
+          s(this, b).error(
+            `[RuleEngine] Async rule "${u.name}" threw an error.`,
+            [p]
+          ), f = !1;
+        } finally {
+          s(this, w).hidePending(r), i.abortController = null;
+        }
+      }
+      if (!f) {
+        let p = s(this, O)[u.name] || "Invalid input.";
+        e.customMessages && (e.customMessages[u.name] ? p = e.customMessages[u.name] : e.customMessages["*"] && (p = e.customMessages["*"]));
+        const _ = p.replace(/{(\d+)}/g, (Ge, Je) => {
+          const le = parseInt(Je, 10);
+          return u.params[le] !== void 0 ? String(u.params[le]) : Ge;
+        });
+        return s(this, w).displayError(r, _), e.state.lastError = _, s(this, b).debug(
+          `[RuleEngine] Field validation failed for "${n.name}" on rule "${u.name}".`
+        ), !1;
+      }
+    }
+    return s(this, w).clearError(r), e.state.lastError = null, s(this, b).debug(
+      `[RuleEngine] Field validation succeeded for "${n.name}".`
+    ), !0;
+  }
+}
+b = new WeakMap(), w = new WeakMap(), W = new WeakMap(), Z = new WeakMap(), H = new WeakMap(), O = new WeakMap(), Q = new WeakSet(), /**
+ * Checks if a field's dependency condition is currently met.
+ */
+Ze = function(e) {
+  if (!e) return !0;
+  const r = s(this, W).querySelector(
+    `[name="${e.controllerName}"]`
+  );
+  if (!r) return !1;
+  switch (e.type) {
+    case "checked":
+      return r.checked;
+    case "value":
+      return r.value === e.value;
+    case "present":
+      return !!r.value;
+    default:
+      return !1;
+  }
+};
+var $, y, E, m, z, k, M, P, ae, He;
+class pt {
+  /**
+   * @param formElement - The form element to control.
+   * @param dependencies - Core dependencies.
+   */
+  constructor(e, {
+    logger: r,
+    schema: a = {},
+    aliases: i = {},
+    validationHandler: l
+  }) {
+    o(this, P);
+    o(this, $);
+    o(this, y, []);
+    o(this, E, /* @__PURE__ */ new Map());
+    o(this, m);
+    o(this, z);
+    o(this, k);
+    o(this, M);
+    c(this, $, e), c(this, m, r), c(this, z, a), c(this, k, i), c(this, M, l);
+  }
+  /**
+   * Scans the form to find all fields and prepares them for validation.
+   */
+  discoverFields() {
+    c(this, y, []), s(this, E).clear();
+    const e = s(this, $).querySelectorAll(
+      "[data-ctrovalidate-rules]"
+    );
+    s(this, m).debug(
+      "[FormController] Discovered " + e.length + " fields to validate."
+    ), e.forEach(
+      (r) => this.addField(r, !1)
+    ), Object.keys(s(this, z)).forEach((r) => {
+      const a = s(this, $).querySelector(
+        `[name="${r}"]`
+      );
+      a && !s(this, E).has(a) && this.addField(a, !1);
+    });
+  }
+  /**
+   * Adds a single field to the validation controller.
+   */
+  addField(e, r = !0) {
+    if (!e || s(this, E).has(e))
+      return;
+    const a = e.getAttribute("data-ctrovalidate-rules"), i = e.getAttribute("data-ctrovalidate-if"), l = e.name, n = j(a || "", s(this, k)), d = l ? j(s(this, z)[l] || [], s(this, k)) : [], u = [...n, ...d];
+    if (u.length === 0 && !i)
+      return;
+    const g = {}, N = e.getAttribute("data-ctrovalidate-message");
+    N && (g["*"] = N);
+    for (const p of Array.from(e.attributes))
+      if (p.name.startsWith("data-ctrovalidate-") && p.name.endsWith("-message")) {
+        const _ = p.name.replace("data-ctrovalidate-", "").replace("-message", "");
+        _ !== "" && _ !== "message" && (g[_] = p.value);
+      }
+    const f = {
+      element: e,
+      rules: u,
+      dependency: v(this, P, He).call(this, i),
+      customMessages: Object.keys(g).length > 0 ? g : void 0,
+      state: { isDirty: !1, abortController: null, lastError: null }
+    };
+    s(this, y).push(f), s(this, E).set(e, f), s(this, m).debug("[FormController] Added field:", e), r && v(this, P, ae).call(this, f);
+  }
+  /**
+   * Removes a single field from the validation controller.
+   */
+  removeField(e) {
+    if (!e || !s(this, E).has(e))
+      return;
+    const r = s(this, E).get(e);
+    if (c(this, y, s(this, y).filter((a) => a.element !== e)), r.listeners) {
+      const { onBlur: a, onInput: i, onControllerInput: l, controllerElement: n } = r.listeners;
+      try {
+        e.removeEventListener("blur", a), e.removeEventListener("input", i), n && l && n.removeEventListener("input", l);
+      } catch (d) {
+        s(this, m).debug(
+          "[FormController] Error while removing listeners for",
+          e,
+          d
+        );
+      }
+      delete r.listeners;
+    }
+    s(this, E).delete(e), s(this, m).debug("[FormController] Removed field:", e);
+  }
+  /**
+   * Attaches all necessary event listeners for real-time validation.
+   */
+  attachEventListeners(e) {
+    if (!e) {
+      s(this, m).info("[FormController] Real-time validation is disabled.");
+      return;
+    }
+    s(this, m).info(
+      "[FormController] Real-time validation is enabled. Attaching listeners."
+    ), s(this, y).forEach(
+      (r) => v(this, P, ae).call(this, r)
+    );
+  }
+  /**
+   * Resets all field states to clean.
+   */
+  reset() {
+    s(this, y).forEach((e) => {
+      e.state.isDirty = !1, e.state.lastError = null;
+    });
+  }
+  /**
+   * Cleans up all event listeners.
+   */
+  destroy() {
+    [...s(this, y)].forEach((e) => {
+      this.removeField(e.element);
+    });
+  }
+  /**
+   * Returns all discovered fields.
+   */
+  getFields() {
+    return s(this, y);
+  }
+}
+$ = new WeakMap(), y = new WeakMap(), E = new WeakMap(), m = new WeakMap(), z = new WeakMap(), k = new WeakMap(), M = new WeakMap(), P = new WeakSet(), /**
+ * Attaches event listeners to a single field object.
+ */
+ae = function(e) {
+  const { element: r, dependency: a } = e;
+  if (e.listeners) return;
+  const i = () => {
+    s(this, m).debug(
+      `[FormController] Blur event on "${r.name}". Validating.`
+    ), s(this, M).call(this, e), e.state.isDirty = !0;
+  }, l = () => {
+    e.state.isDirty && (s(this, m).debug(
+      `[FormController] Input event on dirty field "${r.name}". Validating.`
+    ), s(this, M).call(this, e));
+  };
+  r.addEventListener("blur", i), r.addEventListener("input", l);
+  let n = null, d = null;
+  a && (n = s(this, $).querySelector(
+    `[name="${a.controllerName}"]`
+  ), n ? (d = () => {
+    s(this, m).debug(
+      `[FormController] Controller "${n.name}" changed. Re-validating dependent field "${r.name}".`
+    ), s(this, M).call(this, e);
+  }, n.addEventListener("input", d)) : s(this, m).warn(
+    `[FormController] Could not find controller field with name "${a.controllerName}".`
+  )), e.listeners = {
+    onBlur: i,
+    onInput: l,
+    onControllerInput: d,
+    controllerElement: n
+  };
+}, /**
+ * Parses the dependency condition string.
+ */
+He = function(e) {
+  if (!e) return null;
+  const r = e.split(":"), a = r[0], i = r[1] || "present";
+  if (!a) return null;
+  if (i.includes("=")) {
+    const [l, n] = i.split("=");
+    return { controllerName: a, type: l, value: n };
+  } else
+    return { controllerName: a, type: i };
+};
+const vt = (t, e) => {
+  const r = t;
+  if (!r.form)
+    return "";
+  const a = r.form.querySelector(
+    `[name="${e}"]`
+  );
+  return a ? a.value : "";
+}, bt = (t, e = [], r = null) => {
+  const a = String(e[0] || "");
+  if (a === void 0)
+    return console.error("[Ctrovalidate] Missing parameter for 'sameAs' rule."), !1;
+  if (!r) return !1;
+  const i = vt(r, a);
+  return Be(t, [i]);
+}, yt = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  alpha: xe,
+  alphaDash: $e,
+  alphaNum: Re,
+  between: Ve,
+  creditCard: qe,
+  decimal: Te,
+  email: Ae,
+  exactLength: ke,
+  integer: Le,
+  ipAddress: _e,
+  json: Ie,
+  max: we,
+  maxLength: Se,
+  min: Ce,
+  minLength: Ne,
+  numeric: Me,
+  phone: De,
+  required: Fe,
+  sameAs: bt,
+  strongPassword: ze,
+  url: Pe
+}, Symbol.toStringTag, { value: "Module" })), me = {
+  ...yt
+}, ge = {}, pe = {}, Et = {
+  required: "This field is required.",
+  minLength: "This field must be at least {0} characters long.",
+  maxLength: "This field cannot be longer than {0} characters.",
+  between: "This field must be between {0} and {1} characters long.",
+  email: "Please enter a valid email address.",
+  phone: "Please enter a valid phone number.",
+  url: "Please enter a valid URL.",
+  numeric: "This field must contain only numbers.",
+  alpha: "This field must contain only letters.",
+  alphaDash: "This field must contain only letters, numbers, and dashes.",
+  alphaSpaces: "This field must contain only letters and spaces.",
+  alphaNum: "This field must contain only letters and numbers.",
+  decimal: "This field must be a valid decimal number.",
+  integer: "This field must be a valid integer.",
+  min: "This field must be at least {0}.",
+  max: "This field cannot be more than {0}.",
+  exactLength: "This field must be exactly {0} characters long.",
+  format: "This field format is invalid.",
+  sameAs: "This field must match {0}.",
+  strongPassword: "Password must be at least 8 characters long and contain at least one uppercase letter, one lowercase letter, one number, and one special character.",
+  creditCard: "Please enter a valid credit card number.",
+  ipAddress: "Please enter a valid IP address.",
+  json: "Please enter a valid JSON string."
+}, G = {
+  ...Et
+};
+function Ft(t) {
+  Object.assign(G, t);
+}
+var L, F, A, T, V, h, X, Oe;
+class At {
+  /**
+   * @param formElement - The HTML form element to validate.
+   * @param options - Custom configuration options.
+   */
+  constructor(e, r = {}) {
+    o(this, X);
+    o(this, L);
+    o(this, F);
+    o(this, A);
+    o(this, T);
+    o(this, V);
+    o(this, h);
+    if (!(e instanceof HTMLFormElement))
+      throw new Error(
+        "Ctrovalidate requires a valid HTMLFormElement to be initialized."
+      );
+    c(this, L, e), c(this, F, {
+      logLevel: ee.NONE,
+      errorClass: "is-invalid",
+      errorMessageClass: "error-message",
+      pendingClass: "ctrovalidate-pending",
+      realTime: !0,
+      schema: {},
+      aliases: {},
+      ...r
+    }), c(this, A, new Ye(s(this, F).logLevel)), c(this, T, new te(s(this, F))), c(this, V, new gt(s(this, L), {
+      logger: s(this, A),
+      uiManager: s(this, T),
+      rules: me,
+      asyncRules: ge,
+      messages: G
+    })), c(this, h, new pt(s(this, L), {
+      logger: s(this, A),
+      schema: s(this, F).schema,
+      aliases: { ...pe, ...s(this, F).aliases },
+      validationHandler: (a) => s(this, V).validateField(a)
+    })), v(this, X, Oe).call(this);
+  }
+  /**
+   * Defines a rule alias (macro) globally.
+   */
+  static defineAlias(e, r) {
+    pe[e] = r;
+  }
+  /**
+   * Validates the entire form programmatically.
+   */
+  async validate() {
+    return this.validateForm();
+  }
+  /**
+   * Validates the entire form programmatically.
+   */
+  async validateForm() {
+    s(this, A).info("[Ctrovalidate] Manually triggering form validation.");
+    const e = s(this, h).getFields(), a = (await Promise.all(
+      e.map((i) => s(this, V).validateField(i))
+    )).every((i) => i === !0);
+    return a ? s(this, A).info("[Ctrovalidate] Form validation succeeded.") : s(this, A).warn("[Ctrovalidate] Form validation failed."), a;
+  }
+  /**
+   * Allows the user to add custom validation messages globally.
+   */
+  static setCustomMessages(e) {
+    Ft(e);
+  }
+  /**
+   * Adds a custom synchronous validation rule globally.
+   */
+  static addRule(e, r, a) {
+    if (!e || typeof r != "function") {
+      console.error(
+        "[Ctrovalidate] addRule requires a rule name and a logic function."
+      );
+      return;
+    }
+    me[e] = r, a && (G[e] = a);
+  }
+  /**
+   * Adds a custom asynchronous validation rule globally.
+   */
+  static addAsyncRule(e, r, a) {
+    if (!e || typeof r != "function") {
+      console.error(
+        "[Ctrovalidate] addAsyncRule requires a rule name and a logic function."
+      );
+      return;
+    }
+    ge[e] = r, a && (G[e] = a);
+  }
+  /**
+   * Manually adds a new field to be validated.
+   */
+  addField(e) {
+    s(this, h).addField(e);
+  }
+  /**
+   * Manually removes a field from validation.
+   */
+  removeField(e) {
+    s(this, h).removeField(e);
+  }
+  /**
+   * Refreshes the discovered fields. Use if fields are added or removed from the DOM.
+   */
+  refresh() {
+    s(this, h).discoverFields(), s(this, h).attachEventListeners(s(this, F).realTime);
+  }
+  /**
+   * Returns the current error for a field by its name.
+   */
+  getError(e) {
+    const r = s(this, h).getFields().find((a) => a.element.name === e);
+    return r ? r.state.lastError : null;
+  }
+  /**
+   * Checks if a field has been interacted with.
+   */
+  isDirty(e) {
+    const r = s(this, h).getFields().find((a) => a.element.name === e);
+    return r ? r.state.isDirty : !1;
+  }
+  /**
+   * Resets the validation state of the form.
+   */
+  reset() {
+    s(this, h).reset(), s(this, h).getFields().forEach((e) => {
+      s(this, T).clearError(e.element);
+    });
+  }
+  /**
+   * Fully cleans up the validator instance.
+   */
+  destroy() {
+    s(this, h).destroy(), s(this, h).getFields().forEach((e) => {
+      s(this, T).clearError(e.element);
+    });
+  }
+}
+L = new WeakMap(), F = new WeakMap(), A = new WeakMap(), T = new WeakMap(), V = new WeakMap(), h = new WeakMap(), X = new WeakSet(), /**
+ * Initializes the library by discovering fields and attaching listeners.
+ */
+Oe = function() {
+  s(this, A).info("[Ctrovalidate] Initializing library."), s(this, h).discoverFields(), s(this, h).attachEventListeners(s(this, F).realTime), s(this, L).setAttribute("novalidate", "true");
+}, de(At, "LogLevel", ee);
+export {
+  At as Ctrovalidate,
+  ee as LogLevel
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "ctrovalidate-browser",
+  "version": "1.0.0",
+  "description": "Browser adapter for Ctrovalidate - Declarative HTML-first form validation with data attributes.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "format": "prettier . --check"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "ctrovalidate-core": "^1.0.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^9.1.0",
+    "globals": "^17.2.0",
+    "prettier": "^3.1.1",
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.0.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0",
+    "vitest": "^4.0.18"
+  },
+  "homepage": "https://ctrovalidate.vercel.app/guide/browser",
+  "keywords": [
+    "ctrovalidate",
+    "validation",
+    "form-validation",
+    "browser",
+    "javascript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ctrotech-tutor/ctrovalidate-browser.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ctrotech-tutor/ctrovalidate-browser/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Ctrotech (https://github.com/ctrotech-tutor)",
+  "license": "MIT"
+}