ctrovalidate-core 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,73 @@
+# ctrovalidate-core
+
+**Zero-dependency, platform-agnostic validation engine for JavaScript and TypeScript.**
+
+[![npm version](https://img.shields.io/npm/v/ctrovalidate-core.svg)](https://www.npmjs.com/package/ctrovalidate-core)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+The headless validation engine at the heart of the Ctrovalidate ecosystem. Provides pure validation logic with zero runtime dependencies — runs in Node.js, browsers, edge functions, and any JavaScript environment.
+
+---
+
+## Installation
+
+```bash
+npm install ctrovalidate-core
+```
+
+---
+
+## Quick Start
+
+```typescript
+import { validate } from 'ctrovalidate-core';
+
+const results = validate(
+  { email: 'user@example.com', age: 25 },
+  { email: 'required|email', age: 'required|min:18' }
+);
+// { email: { isValid: true, error: null, rule: null }, age: { ... } }
+```
+
+---
+
+## API Overview
+
+| Function | Description |
+|----------|-------------|
+| `validateValue(value, rules, options?)` | Validate a single value synchronously |
+| `validate(data, schema, options?)` | Validate an entire data object synchronously |
+| `validateValueAsync(value, rules, options?)` | Validate a single value asynchronously |
+| `validateAsync(data, schema, options?)` | Validate an entire data object asynchronously |
+
+**Full documentation:** [ctrovalidate-core API Reference](https://ctrovalidate.vercel.app/api/core) · [Guide](https://ctrovalidate.vercel.app/guide/core)
+
+---
+
+## Features
+
+- **22 built-in rules**: `required`, `email`, `min`, `max`, `minLength`, `maxLength`, `alpha`, `alphaNum`, `alphaDash`, `alphaSpaces`, `numeric`, `integer`, `decimal`, `url`, `ipAddress`, `json`, `phone`, `creditCard`, `strongPassword`, `exactLength`, `between`, `sameAs`
+- **4 validation functions**: Sync and async, single value and full object
+- **Schema formats**: String (`"required|email"`), array, or hybrid
+- **Rule aliases**: Recursive macro expansion with cycle protection
+- **i18n**: Built-in `Translator` with locale switching and parameter interpolation
+- **Async support**: `AbortSignal` integration for race-condition-free remote validation
+- **Zero dependencies**: ~5KB minified
+
+---
+
+## Documentation
+
+- [Full API Reference](https://ctrovalidate.vercel.app/api/core)
+- [Core Concepts Guide](https://ctrovalidate.vercel.app/guide/core)
+- [Rules Catalog](https://ctrovalidate.vercel.app/guide/rules)
+- [Schema System](https://ctrovalidate.vercel.app/guide/schemas)
+- [Custom Rules](https://ctrovalidate.vercel.app/advanced/custom-rules)
+- [Async Validation](https://ctrovalidate.vercel.app/advanced/async)
+- [i18n & Localization](https://ctrovalidate.vercel.app/advanced/i18n)
+
+---
+
+## License
+
+MIT © [Ctrotech](https://github.com/ctrotech-tutor)

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var Y=Object.defineProperty;var $=e=>{throw TypeError(e)};var ee=(e,t,r)=>t in e?Y(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r;var p=(e,t,r)=>ee(e,typeof t!="symbol"?t+"":t,r),w=(e,t,r)=>t.has(e)||$("Cannot "+r);var d=(e,t,r)=>(w(e,t,"read from private field"),r?r.call(e):t.get(e)),A=(e,t,r)=>t.has(e)?$("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,r),N=(e,t,r,s)=>(w(e,t,"write to private field"),s?s.call(e,r):t.set(e,r),r);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function x(e){if(!e||typeof e!="string")return[];const t=[],r=e.split("|");for(const s of r){const n=s.trim();if(n==="")continue;const a=n.indexOf(":");if(a===-1)t.push({name:n,params:[]});else{const i=n.substring(0,a).trim(),u=n.substring(a+1).trim();if(i){const f=u.split(",").map(o=>o.trim());t.push({name:i,params:f})}}}return t}function b(e,t={},r=new Set){if(!e)return[];let s;if(typeof e=="string")s=x(e);else if(Array.isArray(e))s=e;else return[];return s.flatMap(n=>{const a=typeof n=="string"?n.split(":")[0]:n.name;if(t[a]&&!r.has(a)){const i=new Set(r);return i.add(a),b(t[a],t,i)}return typeof n=="string"?x(n):[n]})}var F=(e=>(e[e.NONE=0]="NONE",e[e.ERROR=1]="ERROR",e[e.WARN=2]="WARN",e[e.INFO=3]="INFO",e[e.DEBUG=4]="DEBUG",e))(F||{});const g=class g{constructor(t=0){p(this,"level");this.level=t}setLevel(t){this.level=t}static setLevel(t){this.globalLevel=t}format(t){return`${g.prefix} ${t}`}error(t,...r){this.level>=1&&console.error(this.format(t),...r)}warn(t,...r){this.level>=2&&console.warn(this.format(t),...r)}info(t,...r){this.level>=3&&console.info(this.format(t),...r)}debug(t,...r){this.level>=4&&console.debug(this.format(t),...r)}static error(t,...r){this.globalLevel>=1&&console.error(`${this.prefix} ${t}`,...r)}static warn(t,...r){this.globalLevel>=2&&console.warn(`${this.prefix} ${t}`,...r)}static info(t,...r){this.globalLevel>=3&&console.info(`${this.prefix} ${t}`,...r)}static debug(t,...r){this.globalLevel>=4&&console.debug(`${this.prefix} ${t}`,...r)}};p(g,"globalLevel",1),p(g,"prefix","[Ctrovalidate]");let R=g;const P=e=>e==null?!1:typeof e=="boolean"?e:String(e).trim()!=="",te=/^[^\s@]+@[^\s@]+\.[^\s@]+$/,M=e=>e?te.test(String(e)):!0,T=(e,t=[])=>{if(e==null||e==="")return!0;if(!t[0])return console.error("[Ctrovalidate] Missing parameter for 'min' rule."),!1;const r=Number(t[0]);return Number(e)>=r},V=(e,t=[])=>{if(e==null||e==="")return!0;if(!t[0])return console.error("[Ctrovalidate] Missing parameter for 'max' rule."),!1;const r=Number(t[0]);return Number(e)<=r},z=(e,t=[])=>{if(e==null||e==="")return!0;if(!t[0])return console.error("[Ctrovalidate] Missing parameter for 'minLength' rule."),!1;const r=Number(t[0]);return String(e).length>=r},C=(e,t=[])=>{if(e==null||e==="")return!0;if(!t[0])return console.error("[Ctrovalidate] Missing parameter for 'maxLength' rule."),!1;const r=Number(t[0]);return String(e).length<=r},re=/^[a-zA-Z]+$/,O=e=>e?re.test(String(e)):!0,ne=/^[a-zA-Z0-9]+$/,L=e=>e?ne.test(String(e)):!0,se=/^[a-zA-Z0-9-_]+$/,I=e=>e?se.test(String(e)):!0,ae=/^[a-zA-Z\s]+$/,j=e=>e?ae.test(String(e)):!0,Z=e=>!e&&e!==0?!0:!isNaN(Number(e))&&!isNaN(parseFloat(String(e))),ie=/^-?\d+$/,v=e=>!e&&e!==0?!0:ie.test(String(e)),oe=/^-?\d+(\.\d+)?$/,D=e=>!e&&e!==0?!0:oe.test(String(e)),le=/^(https?:\/\/)([\da-z.-]+)\.([a-z.]{2,6})([/\w .-]*)*\/?$/,E=e=>e?le.test(String(e)):!0,de=/^(?:(?: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]?)$/,ce=/^(?:(?:[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,})?$/,q=e=>{if(!e)return!0;const t=String(e);return de.test(t)||ce.test(t)},U=e=>{if(!e)return!0;try{const t=JSON.parse(String(e));return typeof t=="object"&&t!==null}catch{return!1}},ue=/^[+]?([(]?[0-9]{1,4}[)]?)[-\s.]?[0-9]{3,4}[-\s.]?[0-9]{4,6}$/,k=e=>e?ue.test(String(e)):!0,B=e=>{if(!e)return!0;const t=String(e).replace(/[- ]/g,"");if(!/^\d+$/.test(t))return!1;let r=0;const s=t.length%2;for(let n=0;n<t.length;n++){let a=parseInt(t[n],10);n%2===s&&(a*=2,a>9&&(a-=9)),r+=a}return r%10===0},fe=/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/,G=e=>e?fe.test(String(e)):!0,J=(e,t=[])=>{if(e==null||e==="")return!0;if(!t[0])return console.error("[Ctrovalidate] Missing parameter for 'exactLength' rule."),!1;const r=Number(t[0]);return String(e).length===r},W=(e,t=[])=>{if(e==null||e==="")return!0;if(t.length<2)return console.error("[Ctrovalidate] Missing parameters for 'between' rule."),!1;const r=Number(t[0]),s=Number(t[1]);if(isNaN(r)||isNaN(s))return!1;if(!isNaN(Number(e))&&typeof e!="string"){const i=Number(e);return i>=r&&i<=s}const n=String(e);if(!isNaN(Number(n))&&n!==""){const i=Number(n);return i>=r&&i<=s}const a=n.length;return a>=r&&a<=s},_=(e,t=[])=>{if(t.length===0||t[0]===void 0)return console.error("[Ctrovalidate] Missing parameter for 'sameAs' rule."),!1;const r=t[0];return e===r},S=Object.freeze(Object.defineProperty({__proto__:null,alpha:O,alphaDash:I,alphaNum:L,alphaSpaces:j,between:W,creditCard:B,decimal:D,email:M,exactLength:J,integer:v,ipAddress:q,json:U,max:V,maxLength:C,min:T,minLength:z,numeric:Z,phone:k,required:P,sameAs:_,strongPassword:G,url:E},Symbol.toStringTag,{value:"Module"})),me={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}."};var c,m;class H{constructor(){A(this,c,{en:me});A(this,m,"en")}setLocale(t){if(!d(this,c)[t]){console.warn(`[Ctrovalidate] Locale "${t}" not found. Falling back to "en".`),N(this,m,"en");return}N(this,m,t)}addMessages(t,r){d(this,c)[t]={...d(this,c)[t]||{},...r}}translate(t,r=[],s){const n=s||d(this,m),a=d(this,c)[n]||d(this,c).en;return(a[t]||a.default||"Invalid input.").replace(/{(\d+)}/g,(u,f)=>{const o=parseInt(f,10);return r[o]!==void 0?String(r[o]):u})}get currentLocale(){return d(this,m)}}c=new WeakMap,m=new WeakMap;const y=new H;function K(e,t,r={}){const{customRules:s={},aliases:n={},messages:a={},locale:i}=r,u=b(t,n),f={...S,...s};for(const o of u){const l=f[o.name];if(!l)continue;const h=l(e,o.params);if(!(h instanceof Promise)&&!h)return{isValid:!1,error:a[o.name]||a["*"]||y.translate(o.name,o.params,i),rule:o.name}}return{isValid:!0,error:null,rule:null}}function he(e,t,r={}){const s={};for(const n in t)s[n]=K(e[n],t[n],r);return s}async function Q(e,t,r={}){const{customRules:s={},aliases:n={},messages:a={},locale:i,signal:u}=r,f=b(t,n),o={...S,...s};for(const l of f){const h=o[l.name];if(!h)continue;if(!await h(e,l.params,null,u))return{isValid:!1,error:a[l.name]||a["*"]||y.translate(l.name,l.params,i),rule:l.name}}return{isValid:!0,error:null,rule:null}}async function ge(e,t,r={}){const s={};for(const n in t)s[n]=await Q(e[n],t[n],r);return s}const pe="1.0.0";exports.LogLevel=F;exports.Logger=R;exports.Translator=H;exports.alpha=O;exports.alphaDash=I;exports.alphaNum=L;exports.alphaSpaces=j;exports.between=W;exports.creditCard=B;exports.decimal=D;exports.email=M;exports.exactLength=J;exports.integer=v;exports.ipAddress=q;exports.json=U;exports.max=V;exports.maxLength=C;exports.min=T;exports.minLength=z;exports.normalizeRules=b;exports.numeric=Z;exports.parseRules=x;exports.phone=k;exports.required=P;exports.rules=S;exports.sameAs=_;exports.strongPassword=G;exports.translator=y;exports.url=E;exports.validate=he;exports.validateAsync=ge;exports.validateValue=K;exports.validateValueAsync=Q;exports.version=pe;

package/dist/index.d.ts

@@ -0,0 +1,295 @@
+/**
+ * Checks if a value contains only alphabetic characters.
+ */
+export declare const alpha: RuleLogic;
+
+/**
+ * Checks if a value contains only alphanumeric characters, dashes, and underscores.
+ */
+export declare const alphaDash: RuleLogic;
+
+/**
+ * Checks if a value contains only alphanumeric characters.
+ */
+export declare const alphaNum: RuleLogic;
+
+/**
+ * Checks if a value contains only alphabetic characters and spaces.
+ */
+export declare const alphaSpaces: RuleLogic;
+
+/**
+ * The logic function for an asynchronous validation rule.
+ * @template Context The type of the context object.
+ */
+export declare type AsyncRuleLogic<Context = unknown> = (value: unknown, params?: unknown[], context?: Context | null, signal?: AbortSignal) => Promise<boolean>;
+
+/**
+ * Checks if a value is between a min and max (inclusive).
+ * Supports numbers and string lengths.
+ */
+export declare const between: RuleLogic;
+
+/**
+ * Checks if a value is a valid credit card number using the Luhn algorithm.
+ */
+export declare const creditCard: RuleLogic;
+
+/**
+ * Checks if a value is a valid decimal number.
+ */
+export declare const decimal: RuleLogic;
+
+/**
+ * Information about a dependency between fields.
+ */
+export declare interface DependencyDefinition {
+    controllerName: string;
+    type: 'checked' | 'value' | 'present' | string;
+    value?: unknown;
+}
+
+/**
+ * Checks if a value is a valid email address.
+ */
+export declare const email: RuleLogic;
+
+/**
+ * Checks if a value has an exact length.
+ */
+export declare const exactLength: RuleLogic;
+
+/**
+ * Checks if a value is an integer.
+ */
+export declare const integer: RuleLogic;
+
+/**
+ * Checks if a value is a valid IP address (v4 or v6).
+ */
+export declare const ipAddress: RuleLogic;
+
+/**
+ * Checks if a value is valid JSON.
+ */
+export declare const json: RuleLogic;
+
+export declare type LocaleDictionary = Record<string, string>;
+
+export declare class Logger {
+    private level;
+    private static globalLevel;
+    private static prefix;
+    constructor(level?: LogLevel);
+    setLevel(level: LogLevel): void;
+    static setLevel(level: LogLevel): void;
+    private format;
+    error(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+    static error(message: string, ...args: unknown[]): void;
+    static warn(message: string, ...args: unknown[]): void;
+    static info(message: string, ...args: unknown[]): void;
+    static debug(message: string, ...args: unknown[]): void;
+}
+
+export declare enum LogLevel {
+    NONE = 0,
+    ERROR = 1,
+    WARN = 2,
+    INFO = 3,
+    DEBUG = 4
+}
+
+/**
+ * Checks if a value meets a maximum numeric requirement.
+ */
+export declare const max: RuleLogic;
+
+/**
+ * Checks if a value does not exceed a maximum length requirement.
+ */
+export declare const maxLength: RuleLogic;
+
+/**
+ * Checks if a value meets a minimum numeric requirement.
+ */
+export declare const min: RuleLogic;
+
+/**
+ * Checks if a value meets a minimum length requirement.
+ */
+export declare const minLength: RuleLogic;
+
+/**
+ * Normalizes a SchemaRule (string, string[], or RuleDefinition[]) into a uniform RuleDefinition[].
+ * This provides high flexibility for developers to define rules as they prefer.
+ * Supports recursive expansion of aliases.
+ *
+ * @param rules - The rules to normalize.
+ * @param aliases - Optional dictionary of rule aliases.
+ * @param seen - Used internally to prevent infinite recursion.
+ * @returns An array of normalized rule definitions.
+ */
+export declare function normalizeRules(rules: SchemaRule, aliases?: Record<string, SchemaRule>, seen?: Set<string>): RuleDefinition[];
+
+/**
+ * Checks if a value is numeric.
+ */
+export declare const numeric: RuleLogic;
+
+/**
+ * Parses a rule string (e.g., "required|minLength:3|between:1,10") into a structured array.
+ *
+ * @param rulesString - The string from the data-ctrovalidate-rules attribute.
+ * @returns An array of rule objects.
+ */
+export declare function parseRules(rulesString: string | null | undefined): RuleDefinition[];
+
+/**
+ * Checks if a value is a valid phone number.
+ */
+export declare const phone: RuleLogic;
+
+/**
+ * Checks if a value is present.
+ */
+export declare const required: RuleLogic;
+
+/**
+ * A parsed rule definition.
+ */
+export declare interface RuleDefinition {
+    name: string;
+    params: unknown[];
+}
+
+/**
+ * @file Core type definitions for Ctrovalidate.
+ */
+/**
+ * The logic function for a synchronous validation rule.
+ * @template Context The type of the context object (e.g., generic context or platform specific element).
+ */
+export declare type RuleLogic<Context = unknown> = (value: unknown, params?: unknown[], context?: Context | null) => boolean;
+
+export declare namespace rules {
+    export {
+        required,
+        email,
+        min,
+        max,
+        minLength,
+        maxLength,
+        alpha,
+        alphaNum,
+        alphaDash,
+        alphaSpaces,
+        numeric,
+        integer,
+        decimal,
+        url,
+        ipAddress,
+        json,
+        phone,
+        creditCard,
+        strongPassword,
+        exactLength,
+        between,
+        sameAs
+    }
+}
+
+/**
+ * Checks if a value is the same as a target value.
+ */
+export declare const sameAs: RuleLogic;
+
+/**
+ * A rule definition in a schema, supporting strings, array of strings,
+ * RuleDefinitions, or a hybrid array of both strings and definitions.
+ */
+export declare type SchemaRule = string | (string | RuleDefinition)[];
+
+/**
+ * Checks if a value is a "strong" password.
+ * (At least 8 chars, 1 uppercase, 1 lowercase, 1 number, 1 special char)
+ */
+export declare const strongPassword: RuleLogic;
+
+/**
+ * Handles internationalization and message interpolation for Ctrovalidate.
+ */
+export declare class Translator {
+    #private;
+    /**
+     * Set the current locale.
+     */
+    setLocale(locale: string): void;
+    /**
+     * Add or update messages for a specific locale.
+     */
+    addMessages(locale: string, messages: LocaleDictionary): void;
+    /**
+     * Translates a rule name with optional parameters.
+     */
+    translate(rule: string, params?: unknown[], localeOverride?: string): string;
+    /**
+     * Get the current active locale.
+     */
+    get currentLocale(): string;
+}
+
+export declare const translator: Translator;
+
+/**
+ * Checks if a value is a valid URL.
+ */
+export declare const url: RuleLogic;
+
+/**
+ * Validates an entire data object against a schema.
+ */
+export declare function validate<T extends object>(data: T, schema: Record<string, SchemaRule>, options?: ValidationOptions): Record<string, ValidationResult>;
+
+/**
+ * Validates an entire data object asynchronously against a schema.
+ */
+export declare function validateAsync<T extends object>(data: T, schema: Record<string, SchemaRule>, options?: ValidationOptions): Promise<Record<string, ValidationResult>>;
+
+/**
+ * Validates a single value against a set of rules.
+ */
+export declare function validateValue(value: unknown, rules: SchemaRule, options?: ValidationOptions): ValidationResult;
+
+/**
+ * Validates a single value asynchronously against a set of rules.
+ */
+export declare function validateValueAsync(value: unknown, rules: SchemaRule, options?: ValidationOptions): Promise<ValidationResult>;
+
+export declare interface ValidationOptions {
+    customRules?: Record<string, RuleLogic | AsyncRuleLogic>;
+    aliases?: Record<string, SchemaRule>;
+    messages?: Record<string, string>;
+    locale?: string;
+    signal?: AbortSignal;
+}
+
+/**
+ * Result of a validation execution.
+ */
+export declare interface ValidationResult {
+    isValid: boolean;
+    error: string | null;
+    rule: string | null;
+}
+
+/**
+ * A validation schema object mapping field names to rules.
+ */
+export declare type ValidationSchema = Record<string, SchemaRule>;
+
+export declare const version = "1.0.0";
+
+export { }

package/dist/index.js

@@ -0,0 +1,368 @@
+var P = Object.defineProperty;
+var x = (e) => {
+  throw TypeError(e);
+};
+var M = (e, t, r) => t in e ? P(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var p = (e, t, r) => M(e, typeof t != "symbol" ? t + "" : t, r), R = (e, t, r) => t.has(e) || x("Cannot " + r);
+var d = (e, t, r) => (R(e, t, "read from private field"), r ? r.call(e) : t.get(e)), b = (e, t, r) => t.has(e) ? x("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(e) : t.set(e, r), N = (e, t, r, s) => (R(e, t, "write to private field"), s ? s.call(e, r) : t.set(e, r), r);
+function S(e) {
+  if (!e || typeof e != "string")
+    return [];
+  const t = [], r = e.split("|");
+  for (const s of r) {
+    const n = s.trim();
+    if (n === "")
+      continue;
+    const i = n.indexOf(":");
+    if (i === -1)
+      t.push({ name: n, params: [] });
+    else {
+      const a = n.substring(0, i).trim(), u = n.substring(i + 1).trim();
+      if (a) {
+        const f = u.split(",").map((o) => o.trim());
+        t.push({ name: a, params: f });
+      }
+    }
+  }
+  return t;
+}
+function A(e, t = {}, r = /* @__PURE__ */ new Set()) {
+  if (!e) return [];
+  let s;
+  if (typeof e == "string")
+    s = S(e);
+  else if (Array.isArray(e))
+    s = e;
+  else
+    return [];
+  return s.flatMap((n) => {
+    const i = typeof n == "string" ? n.split(":")[0] : n.name;
+    if (t[i] && !r.has(i)) {
+      const a = new Set(r);
+      return a.add(i), A(t[i], t, a);
+    }
+    return typeof n == "string" ? S(n) : [n];
+  });
+}
+var T = /* @__PURE__ */ ((e) => (e[e.NONE = 0] = "NONE", e[e.ERROR = 1] = "ERROR", e[e.WARN = 2] = "WARN", e[e.INFO = 3] = "INFO", e[e.DEBUG = 4] = "DEBUG", e))(T || {});
+const g = class g {
+  constructor(t = 0) {
+    p(this, "level");
+    this.level = t;
+  }
+  setLevel(t) {
+    this.level = t;
+  }
+  static setLevel(t) {
+    this.globalLevel = t;
+  }
+  format(t) {
+    return `${g.prefix} ${t}`;
+  }
+  // Instance methods
+  error(t, ...r) {
+    this.level >= 1 && console.error(this.format(t), ...r);
+  }
+  warn(t, ...r) {
+    this.level >= 2 && console.warn(this.format(t), ...r);
+  }
+  info(t, ...r) {
+    this.level >= 3 && console.info(this.format(t), ...r);
+  }
+  debug(t, ...r) {
+    this.level >= 4 && console.debug(this.format(t), ...r);
+  }
+  // Static methods (using global level)
+  static error(t, ...r) {
+    this.globalLevel >= 1 && console.error(`${this.prefix} ${t}`, ...r);
+  }
+  static warn(t, ...r) {
+    this.globalLevel >= 2 && console.warn(`${this.prefix} ${t}`, ...r);
+  }
+  static info(t, ...r) {
+    this.globalLevel >= 3 && console.info(`${this.prefix} ${t}`, ...r);
+  }
+  static debug(t, ...r) {
+    this.globalLevel >= 4 && console.debug(`${this.prefix} ${t}`, ...r);
+  }
+};
+p(g, "globalLevel", 1), p(g, "prefix", "[Ctrovalidate]");
+let y = g;
+const z = (e) => e == null ? !1 : typeof e == "boolean" ? e : String(e).trim() !== "", V = /^[^\s@]+@[^\s@]+\.[^\s@]+$/, C = (e) => e ? V.test(String(e)) : !0, O = (e, t = []) => {
+  if (e == null || e === "") return !0;
+  if (!t[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'min' rule."), !1;
+  const r = Number(t[0]);
+  return Number(e) >= r;
+}, I = (e, t = []) => {
+  if (e == null || e === "") return !0;
+  if (!t[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'max' rule."), !1;
+  const r = Number(t[0]);
+  return Number(e) <= r;
+}, Z = (e, t = []) => {
+  if (e == null || e === "") return !0;
+  if (!t[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'minLength' rule."), !1;
+  const r = Number(t[0]);
+  return String(e).length >= r;
+}, E = (e, t = []) => {
+  if (e == null || e === "") return !0;
+  if (!t[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'maxLength' rule."), !1;
+  const r = Number(t[0]);
+  return String(e).length <= r;
+}, j = /^[a-zA-Z]+$/, D = (e) => e ? j.test(String(e)) : !0, L = /^[a-zA-Z0-9]+$/, q = (e) => e ? L.test(String(e)) : !0, U = /^[a-zA-Z0-9-_]+$/, k = (e) => e ? U.test(String(e)) : !0, B = /^[a-zA-Z\s]+$/, G = (e) => e ? B.test(String(e)) : !0, J = (e) => !e && e !== 0 ? !0 : !isNaN(Number(e)) && !isNaN(parseFloat(String(e))), W = /^-?\d+$/, _ = (e) => !e && e !== 0 ? !0 : W.test(String(e)), H = /^-?\d+(\.\d+)?$/, K = (e) => !e && e !== 0 ? !0 : H.test(String(e)), Q = /^(https?:\/\/)([\da-z.-]+)\.([a-z.]{2,6})([/\w .-]*)*\/?$/, X = (e) => e ? Q.test(String(e)) : !0, Y = /^(?:(?: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]?)$/, v = /^(?:(?:[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,})?$/, ee = (e) => {
+  if (!e) return !0;
+  const t = String(e);
+  return Y.test(t) || v.test(t);
+}, te = (e) => {
+  if (!e) return !0;
+  try {
+    const t = JSON.parse(String(e));
+    return typeof t == "object" && t !== null;
+  } catch {
+    return !1;
+  }
+}, re = /^[+]?([(]?[0-9]{1,4}[)]?)[-\s.]?[0-9]{3,4}[-\s.]?[0-9]{4,6}$/, ne = (e) => e ? re.test(String(e)) : !0, se = (e) => {
+  if (!e) return !0;
+  const t = String(e).replace(/[- ]/g, "");
+  if (!/^\d+$/.test(t)) return !1;
+  let r = 0;
+  const s = t.length % 2;
+  for (let n = 0; n < t.length; n++) {
+    let i = parseInt(t[n], 10);
+    n % 2 === s && (i *= 2, i > 9 && (i -= 9)), r += i;
+  }
+  return r % 10 === 0;
+}, ie = /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/, ae = (e) => e ? ie.test(String(e)) : !0, oe = (e, t = []) => {
+  if (e == null || e === "") return !0;
+  if (!t[0])
+    return console.error("[Ctrovalidate] Missing parameter for 'exactLength' rule."), !1;
+  const r = Number(t[0]);
+  return String(e).length === r;
+}, le = (e, t = []) => {
+  if (e == null || e === "") return !0;
+  if (t.length < 2)
+    return console.error("[Ctrovalidate] Missing parameters for 'between' rule."), !1;
+  const r = Number(t[0]), s = Number(t[1]);
+  if (isNaN(r) || isNaN(s))
+    return !1;
+  if (!isNaN(Number(e)) && typeof e != "string") {
+    const a = Number(e);
+    return a >= r && a <= s;
+  }
+  const n = String(e);
+  if (!isNaN(Number(n)) && n !== "") {
+    const a = Number(n);
+    return a >= r && a <= s;
+  }
+  const i = n.length;
+  return i >= r && i <= s;
+}, de = (e, t = []) => {
+  if (t.length === 0 || t[0] === void 0)
+    return console.error("[Ctrovalidate] Missing parameter for 'sameAs' rule."), !1;
+  const r = t[0];
+  return e === r;
+}, $ = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  alpha: D,
+  alphaDash: k,
+  alphaNum: q,
+  alphaSpaces: G,
+  between: le,
+  creditCard: se,
+  decimal: K,
+  email: C,
+  exactLength: oe,
+  integer: _,
+  ipAddress: ee,
+  json: te,
+  max: I,
+  maxLength: E,
+  min: O,
+  minLength: Z,
+  numeric: J,
+  phone: ne,
+  required: z,
+  sameAs: de,
+  strongPassword: ae,
+  url: X
+}, Symbol.toStringTag, { value: "Module" })), ce = {
+  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}."
+};
+var c, m;
+class ue {
+  constructor() {
+    b(this, c, { en: ce });
+    b(this, m, "en");
+  }
+  /**
+   * Set the current locale.
+   */
+  setLocale(t) {
+    if (!d(this, c)[t]) {
+      console.warn(
+        `[Ctrovalidate] Locale "${t}" not found. Falling back to "en".`
+      ), N(this, m, "en");
+      return;
+    }
+    N(this, m, t);
+  }
+  /**
+   * Add or update messages for a specific locale.
+   */
+  addMessages(t, r) {
+    d(this, c)[t] = {
+      ...d(this, c)[t] || {},
+      ...r
+    };
+  }
+  /**
+   * Translates a rule name with optional parameters.
+   */
+  translate(t, r = [], s) {
+    const n = s || d(this, m), i = d(this, c)[n] || d(this, c).en;
+    return (i[t] || i.default || "Invalid input.").replace(/{(\d+)}/g, (u, f) => {
+      const o = parseInt(f, 10);
+      return r[o] !== void 0 ? String(r[o]) : u;
+    });
+  }
+  /**
+   * Get the current active locale.
+   */
+  get currentLocale() {
+    return d(this, m);
+  }
+}
+c = new WeakMap(), m = new WeakMap();
+const F = new ue();
+function fe(e, t, r = {}) {
+  const { customRules: s = {}, aliases: n = {}, messages: i = {}, locale: a } = r, u = A(t, n), f = {
+    ...$,
+    ...s
+  };
+  for (const o of u) {
+    const l = f[o.name];
+    if (!l)
+      continue;
+    const h = l(e, o.params);
+    if (!(h instanceof Promise) && !h)
+      return {
+        isValid: !1,
+        error: i[o.name] || i["*"] || F.translate(o.name, o.params, a),
+        rule: o.name
+      };
+  }
+  return {
+    isValid: !0,
+    error: null,
+    rule: null
+  };
+}
+function pe(e, t, r = {}) {
+  const s = {};
+  for (const n in t)
+    s[n] = fe(
+      e[n],
+      t[n],
+      r
+    );
+  return s;
+}
+async function me(e, t, r = {}) {
+  const {
+    customRules: s = {},
+    aliases: n = {},
+    messages: i = {},
+    locale: a,
+    signal: u
+  } = r, f = A(t, n), o = {
+    ...$,
+    ...s
+  };
+  for (const l of f) {
+    const h = o[l.name];
+    if (!h)
+      continue;
+    if (!await h(e, l.params, null, u))
+      return {
+        isValid: !1,
+        error: i[l.name] || i["*"] || F.translate(l.name, l.params, a),
+        rule: l.name
+      };
+  }
+  return {
+    isValid: !0,
+    error: null,
+    rule: null
+  };
+}
+async function be(e, t, r = {}) {
+  const s = {};
+  for (const n in t)
+    s[n] = await me(
+      e[n],
+      t[n],
+      r
+    );
+  return s;
+}
+const Ne = "1.0.0";
+export {
+  T as LogLevel,
+  y as Logger,
+  ue as Translator,
+  D as alpha,
+  k as alphaDash,
+  q as alphaNum,
+  G as alphaSpaces,
+  le as between,
+  se as creditCard,
+  K as decimal,
+  C as email,
+  oe as exactLength,
+  _ as integer,
+  ee as ipAddress,
+  te as json,
+  I as max,
+  E as maxLength,
+  O as min,
+  Z as minLength,
+  A as normalizeRules,
+  J as numeric,
+  S as parseRules,
+  ne as phone,
+  z as required,
+  $ as rules,
+  de as sameAs,
+  ae as strongPassword,
+  F as translator,
+  X as url,
+  pe as validate,
+  be as validateAsync,
+  fe as validateValue,
+  me as validateValueAsync,
+  Ne as version
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "ctrovalidate-core",
+  "version": "1.0.0",
+  "description": "Core validation logic for Ctrovalidate (Headless).",
+  "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": {
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.0.0",
+    "vitest": "^4.0.18",
+    "eslint": "^9.39.2",
+    "@eslint/js": "^9.39.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0",
+    "prettier": "^3.1.1",
+    "eslint-config-prettier": "^9.1.0",
+    "globals": "^17.2.0"
+  },
+  "homepage": "https://ctrovalidate.vercel.app/api/core",
+  "keywords": ["ctrovalidate", "validation", "form-validation", "javascript", "typescript"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ctrotech-tutor/ctrovalidate-core.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ctrotech-tutor/ctrovalidate-core/issues"
+  },
+  "publishConfig": { "access": "public" },
+  "author": "Ctrotech (https://github.com/ctrotech-tutor)",
+  "license": "MIT"
+}