kanun 0.1.3 → 0.1.5

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Toneflix, LLC. and Arcstack Contributors
+Copyright (c) 2025 Toneflix, LLC. and Arkstack Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -148,11 +148,11 @@ const validator = new Validator(
 );
 ```
 
-For the complete guide and API reference, visit the docs site: https://arcstack-hq.github.io/kanun
+For the complete guide and API reference, visit the docs site: https://arkstack-hq.github.io/kanun
 
 ## Code of Conduct
 
-In order to ensure that the Kanun community is welcoming to all, please review and abide by the [Code of Conduct](https://arcstack-hq.github.io/code-of-conduct).
+In order to ensure that the Kanun community is welcoming to all, please review and abide by the [Code of Conduct](https://arkstack-hq.github.io/code-of-conduct).
 
 ## Security Vulnerabilities
 
@@ -160,12 +160,12 @@ If you discover a security vulnerability within Kanun, please send an e-mail to
 
 ## License
 
-Kanun and all Arcstack packages are open source and licensed under the [MIT license](LICENSE).
+Kanun and all Arkstack packages are open source and licensed under the [MIT license](LICENSE).
 
 [i1]: https://img.shields.io/npm/v/kanun?style=flat-square&label=kanun&color=%230970ce
 [l1]: https://www.npmjs.com/package/kanun
 [d1]: https://img.shields.io/npm/dt/kanun?style=flat-square&label=Downloads&link=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2Fkanun
-[linl]: https://github.com/arcstack-hq/kanun/blob/main/LICENSE
-[lini]: https://img.shields.io/github/license/arcstack-hq/kanun
-[tel]: https://github.com/arcstack-hq/kanun/actions/workflows/ci.yml
-[tei]: https://github.com/arcstack-hq/kanun/actions/workflows/ci.yml/badge.svg
+[linl]: https://github.com/arkstack-hq/kanun/blob/main/LICENSE
+[lini]: https://img.shields.io/github/license/arkstack-hq/kanun
+[tel]: https://github.com/arkstack-hq/kanun/actions/workflows/ci.yml
+[tei]: https://github.com/arkstack-hq/kanun/actions/workflows/ci.yml/badge.svg

package/dist/index.cjs

@@ -1,4 +1,35 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let dayjs_plugin_customParseFormat = require("dayjs/plugin/customParseFormat");
+dayjs_plugin_customParseFormat = __toESM(dayjs_plugin_customParseFormat);
+let dayjs = require("dayjs");
+dayjs = __toESM(dayjs);
 
 //#region src/Rules/baseRule.ts
 var BaseRule = class {};
@@ -26,6 +57,7 @@ var en_default = {
 	boolean: "The :attribute field must be true or false.",
 	confirmed: "The :attribute confirmation does not match.",
 	date: "The :attribute is not a valid date.",
+	datetime: "The :attribute must be a valid date matching the format :format.",
 	date_equals: "The :attribute must be a date equal to :date.",
 	declined: "The :attribute must be declined.",
 	declined_if: "The :attribute must be declined when :other is :value.",
@@ -34,6 +66,7 @@ var en_default = {
 	digits_between: "The :attribute must be between :min and :max digits.",
 	email: "The :attribute must be a valid email address.",
 	ends_with: "The :attribute must end with one of the following: :values.",
+	exists: ":value is not a valid :attribute.",
 	gt: {
 		number: "The :attribute must be greater than :value.",
 		string: "The :attribute must be greater than :value characters.",
@@ -46,7 +79,9 @@ var en_default = {
 		array: "The :attribute must have :value items or more.",
 		object: "The :attribute must have :value items or more."
 	},
+	hex: "The :attribute must be a valid hexadecimal color.",
 	in: "The :attribute must be one of the following :values.",
+	includes: "The :attribute must include one of the following values: :values.",
 	integer: "The :attribute must be an integer.",
 	json: "The :attribute must be a valid JSON string.",
 	lt: {
@@ -75,6 +110,7 @@ var en_default = {
 	},
 	not_in: "The selected :attribute is invalid.",
 	not_regex: "The :attribute format is invalid.",
+	not_includes: "The :attribute must not include any of the following values: :values.",
 	numeric: "The :attribute must be a number.",
 	object: "The :attribute must be an object.",
 	password: {
@@ -107,6 +143,7 @@ var en_default = {
 		object: "The :attribute must contain :size items."
 	},
 	string: "The :attribute must be a string.",
+	unique: "The :attribute has already been taken.",
 	url: "The :attribute must have a valid URL format."
 };
 
@@ -132,6 +169,7 @@ var ar_default = {
 	boolean: "يجب أن تكون قيمة الحقل :attribute إما true أو false",
 	confirmed: "حقل التأكيد غير مُطابق للحقل :attribute",
 	date: "الحقل :attribute ليس تاريخًا صحيحًا",
+	datetime: "الحقل :attribute يجب أن يكون تاريخًا صالحًا يطابق الصيغة :format.",
 	date_equals: "لا يساوي الحقل :attribute مع :date.",
 	declined: "يجب رفض الحقل :attribute",
 	declined_if: "الحقل :attribute مرفوض في حال ما إذا كان :other يساوي :value.",
@@ -140,6 +178,7 @@ var ar_default = {
 	digits_between: "يجب أن يحتوي الحقل :attribute بين :min و :max رقمًا/أرقام",
 	email: "يجب أن يكون :attribute عنوان بريد إلكتروني صحيح البُنية",
 	ends_with: "حقل :attribute يجب ان ينتهي بأحد القيم التالية :value.",
+	exists: ":value غير صالح :attribute.",
 	gt: {
 		number: "حقل :attribute يجب ان يكون اكبر من :value.",
 		string: "حقل :attribute يجب ان يكون اكبر من :value حروفٍ/حرفًا.",
@@ -152,7 +191,9 @@ var ar_default = {
 		array: "حقل :attribute يجب ان يحتوي علي :value عناصر/عنصر او اكثر.",
 		object: "حقل :attribute يجب ان يحتوي علي :value عناصر/عنصر او اكثر."
 	},
+	hex: "الحقل :attribute يجب أن يكون لونًا سداسيًا صالحًا.",
 	in: "الحقل :attribute غير صالح",
+	includes: "الحقل :attribute يجب أن يحتوي على أحد القيم التالية: :values.",
 	integer: "يجب أن يكون الحقل :attribute عددًا صحيحًا",
 	json: "يجب أن يكون الحقل :attribute نصا من نوع JSON.",
 	lt: {
@@ -181,6 +222,7 @@ var ar_default = {
 	},
 	not_in: "الحقل :attribute غير صالح",
 	not_regex: "الحقل :attribute نوعه غير صالح",
+	not_includes: "الحقل :attribute يجب ألا يحتوي على أي من القيم التالية: :values.",
 	numeric: "يجب على الحقل :attribute أن يكون رقمًا",
 	object: "الحقل :attribute يجب ان يكون من نوع object.",
 	password: {
@@ -213,6 +255,7 @@ var ar_default = {
 		object: "يجب أن يحتوي الحقل :attribute على :size عنصرٍ/عناصر بالظبط"
 	},
 	string: "يجب أن يكون الحقل :attribute نصآ.",
+	unique: "الحقل :attribute مستخدم بالفعل.",
 	url: "صيغة الرابط :attribute غير صحيحة"
 };
 
@@ -1077,6 +1120,9 @@ const replaceAttributes = {
 	replaceDateEquals: function(payload) {
 		return this.replaceBefore(payload);
 	},
+	replaceDatetime: function({ message, parameters }) {
+		return message.replace(":format", parameters[0]);
+	},
 	replaceDeclinedIf: function({ message, parameters, data, getDisplayableAttribute }) {
 		const [other] = parameters;
 		const result = deepFind(data, other);
@@ -1098,9 +1144,15 @@ const replaceAttributes = {
 	replaceEndsWith: function({ message, parameters }) {
 		return message.replace(":values", parameters.join(", "));
 	},
+	replaceExists: function({ message, parameters, data }) {
+		return message.replace(":value", data[parameters[1]]);
+	},
 	replaceIn: function({ message, parameters }) {
 		return message.replace(":values", parameters.join(", "));
 	},
+	replaceIncludes: function({ message, parameters }) {
+		return message.replace(":values", parameters.join(", "));
+	},
 	replaceStartsWith: function({ message, parameters }) {
 		return message.replace(":values", parameters.join(", "));
 	},
@@ -1110,6 +1162,9 @@ const replaceAttributes = {
 	replaceMax: function({ message, parameters }) {
 		return message.replace(":max", parameters[0]);
 	},
+	replaceNotIncludes: function({ message, parameters }) {
+		return message.replace(":values", parameters.join(", "));
+	},
 	replaceRequiredWith: function({ message, parameters, getDisplayableAttribute }) {
 		return message.replace(":values", parameters.map((attribute) => getDisplayableAttribute(attribute)).join(", "));
 	},
@@ -1159,6 +1214,9 @@ const replaceAttributes = {
 	},
 	replaceSize: function({ message, parameters }) {
 		return message.replace(":size", parameters[0]);
+	},
+	replaceUnique: function({ message, parameters, data }) {
+		return message.replace(":value", data[parameters[1]]);
 	}
 };
 
@@ -2393,6 +2451,7 @@ var ValidationRule = class extends IRuleContract {
 
 //#endregion
 //#region src/Rules/ExtendedRules.ts
+dayjs.default.extend(dayjs_plugin_customParseFormat.default);
 var ExtendedRules = class extends ValidationRule {
 	/**
 	* The validator instance.
@@ -2449,9 +2508,9 @@ var ExtendedRules = class extends ValidationRule {
 				const [format] = parameters;
 				if (!format) return !isNaN(Date.parse(value));
 				try {
-					return new Date(value).toISOString() === new Date(format).toISOString();
+					return (0, dayjs.default)(value, format, true).isValid();
 				} catch {
-					return !isNaN(Date.parse(value));
+					return false;
 				}
 			},
 			message: "The :attribute must be a valid date matching the format :format."

package/dist/index.d.ts

@@ -73,17 +73,20 @@ declare class replaceAttributePayload {
 //#region src/Contracts/BaseContract.d.ts
 type InitialRule = string | ValidationCallback | IRuleContract | BaseRule;
 type TRule = string | IRuleContract;
-interface InitialRules extends GenericObject {
-  [key: string]: InitialRule | InitialRule[];
-}
-interface Rules extends GenericObject {
-  [key: string]: TRule[];
-}
+type NestedStringMap = {
+  [key: string]: string | NestedStringMap;
+};
+type RuleLeaf = InitialRule | InitialRule[];
+type KnownRulePaths<X extends GenericObject, Prefix extends string = ''> = { [K in keyof X & string]: X[K] extends (infer A)[] ? `${Prefix}${K}` | `${Prefix}${K}.*` | (A extends GenericObject ? `${Prefix}${K}.*.${KnownRulePaths<A>}` : never) : X[K] extends GenericObject ? `${Prefix}${K}` | `${Prefix}${K}.${KnownRulePaths<X[K]>}` : `${Prefix}${K}` }[keyof X & string];
+type LooseNestedRulePaths<X extends GenericObject> = { [K in keyof X & string]: X[K] extends (infer _A)[] ? `${K}.*.${string}` : X[K] extends GenericObject ? `${K}.${string}` : never }[keyof X & string];
+type ScopedInitialRules<X extends GenericObject> = Partial<Record<KnownRulePaths<X> | LooseNestedRulePaths<X>, RuleLeaf>> & { [K in keyof X & string]?: X[K] extends (infer A)[] ? RuleLeaf | (A extends GenericObject ? ScopedInitialRules<A> : never) : X[K] extends GenericObject ? RuleLeaf | ScopedInitialRules<X[K]> : RuleLeaf };
+type InitialRules<X extends GenericObject = GenericObject> = ScopedInitialRules<keyof X extends never ? GenericObject : X>;
+type Rules<X extends GenericObject = GenericObject> = Partial<Record<Extract<keyof X, string>, TRule[]>> & Record<string, TRule[]>;
 interface ImplicitAttributes {
   [key: string]: string[];
 }
-type CustomMessages = GenericObject & {};
-type CustomAttributes = GenericObject & {};
+type CustomMessages<_X extends GenericObject = GenericObject> = GenericObject;
+type CustomAttributes<_X extends GenericObject = GenericObject> = GenericObject;
 interface ErrorMessage {
   error_type?: string;
   message: string;
@@ -190,14 +193,18 @@ interface ReplaceAttributeInterface {
   replaceAfterOrEqual: (payload: replaceAttributePayload) => string;
   replaceBetween: (payload: replaceAttributePayload) => string;
   replaceDateEquals: (payload: replaceAttributePayload) => string;
+  replaceDatetime: (payload: replaceAttributePayload) => string;
   replaceDeclinedIf: (payload: replaceAttributePayload) => string;
   replaceDigits: (payload: replaceAttributePayload) => string;
   replaceDigitsBetween: (payload: replaceAttributePayload) => string;
   replaceDifferent: (payload: replaceAttributePayload) => string;
   replaceEndsWith: (payload: replaceAttributePayload) => string;
+  replaceExists: (payload: replaceAttributePayload) => string;
   replaceIn: (payload: replaceAttributePayload) => string;
+  replaceIncludes: (payload: replaceAttributePayload) => string;
   replaceMin: (payload: replaceAttributePayload) => string;
   replaceMax: (payload: replaceAttributePayload) => string;
+  replaceNotIncludes: (payload: replaceAttributePayload) => string;
   replaceRequiredWith: (payload: replaceAttributePayload) => string;
   replaceRequiredWithAll: (payload: replaceAttributePayload) => string;
   replaceRequiredWithout: (payload: replaceAttributePayload) => string;
@@ -211,6 +218,7 @@ interface ReplaceAttributeInterface {
   replaceRequiredUnless: (payload: replaceAttributePayload) => string;
   replaceSame: (payload: replaceAttributePayload) => string;
   replaceSize: (payload: replaceAttributePayload) => string;
+  replaceUnique: (payload: replaceAttributePayload) => string;
 }
 type ValidationCallback = (value: any, fail: (message: string) => void, attribute: string) => void;
 //#endregion
@@ -272,7 +280,7 @@ declare class ErrorBag {
 }
 //#endregion
 //#region src/BaseValidator.d.ts
-declare class BaseValidator {
+declare class BaseValidator<D extends GenericObject = GenericObject> {
   /**
    * The lang used to return error messages
    */
@@ -308,18 +316,18 @@ declare class BaseValidator {
   /**
    * Custom messages returned based on the error
    */
-  customMessages: CustomMessages;
+  customMessages: CustomMessages<D>;
   /**
    * Object of custom attribute name;
    */
-  customAttributes: CustomAttributes;
-  constructor(data: object, rules: InitialRules, customMessages?: CustomMessages, customAttributes?: CustomAttributes);
-  setData(data: object): this;
-  setRules(rules: InitialRules): this;
+  customAttributes: CustomAttributes<D>;
+  constructor(data: D, rules: InitialRules<D>, customMessages?: CustomMessages<D>, customAttributes?: CustomAttributes<D>);
+  setData<ND extends GenericObject>(data: ND): BaseValidator<ND>;
+  setRules(rules: InitialRules<D>): this;
   setLang(lang: string): this;
   getLang(): string;
-  setCustomMessages(customMessages?: CustomMessages): this;
-  setCustomAttributes(customAttributes?: CustomAttributes): this;
+  setCustomMessages(customMessages?: CustomMessages<D>): this;
+  setCustomAttributes(customAttributes?: CustomAttributes<D>): this;
   stopOnFirstFailure(stopOnFirstFailure?: boolean): this;
   errors(): ErrorBag;
   clearErrors(keys?: string[]): ErrorBag;
@@ -660,6 +668,7 @@ type ValidationRuleSet = RuleName | RuleName[] | `${ValidationRuleName}${string
  * Parse rule names from rule string or string[] definitions
  */
 type ExtractRules<R> = R extends string ? R extends `${infer Head}|${infer Tail}` ? Head extends `${infer Rule}:${string}` ? Rule | ExtractRules<Tail> : Head | ExtractRules<Tail> : R extends `${infer Rule}:${string}` ? Rule : R : R extends string[] ? ExtractRules<R[number]> : never;
+type ValidatedByRules<D extends Record<string, any>, R extends RulesForData<D>> = { [K in Extract<keyof R, keyof D>]: D[K] };
 /**
  * Flatten data structure into dot-notation keys
  * including wildcards (*) for arrays.
@@ -699,13 +708,13 @@ declare class IValidator<D extends Record<string, any> = any, R extends RulesFor
    *
    * @throws ValidationException if validation fails
    */
-  validate(): Promise<Record<string, any>>;
+  validate(): Promise<ValidatedByRules<D, R>>;
   /**
    * Run the validator's rules against its data.
    * @param bagName
    * @returns
    */
-  validateWithBag(bagName: string): Promise<Record<string, any>>;
+  validateWithBag(bagName: string): Promise<ValidatedByRules<D, R>>;
   /**
    * Stop validation on first failure.
    */
@@ -713,7 +722,7 @@ declare class IValidator<D extends Record<string, any> = any, R extends RulesFor
   /**
    * Get the data that passed validation.
    */
-  validatedData(): Record<string, any>;
+  validatedData(): ValidatedByRules<D, R>;
   /**
    * Return all validated input.
    */
@@ -759,7 +768,7 @@ declare class IValidator<D extends Record<string, any> = any, R extends RulesFor
   /**
    * Get current data.
    */
-  getData(): Record<string, any>;
+  getData(): ValidatedByRules<D, R>;
   /**
    * Get current rules.
    */
@@ -869,7 +878,7 @@ declare function notRegex(value: RegExp): Regex;
 //#endregion
 //#region src/Core.d.ts
 declare class Password extends Password$1 {}
-declare function make(data?: GenericObject, rules?: InitialRules, customMessages?: CustomMessages, customAttributes?: CustomAttributes): BaseValidator;
+declare function make<D extends GenericObject = GenericObject>(data?: D, rules?: InitialRules<D>, customMessages?: CustomMessages<D>, customAttributes?: CustomAttributes<D>): BaseValidator<D>;
 //#endregion
 //#region src/Rules/IImplicitRule.d.ts
 declare class IImplicitRule extends IRuleContract {
@@ -1030,13 +1039,13 @@ declare class Validator<D extends Record<string, any> = any, R extends RulesForD
    *
    * @throws ValidationException if validation fails
    */
-  validate(): Promise<Record<string, any>>;
+  validate(): Promise<ValidatedByRules<D, R>>;
   /**
    * Run the validator's rules against its data.
    * @param bagName
    * @returns
    */
-  validateWithBag(bagName: string): Promise<Record<string, any>>;
+  validateWithBag(bagName: string): Promise<ValidatedByRules<D, R>>;
   /**
    * Stop validation on first failure.
    */
@@ -1044,7 +1053,7 @@ declare class Validator<D extends Record<string, any> = any, R extends RulesForD
   /**
    * Get the data that passed validation.
    */
-  validatedData(): Record<string, any>;
+  validatedData(): ValidatedByRules<D, R>;
   /**
    * Return all validated input.
    */
@@ -1090,7 +1099,7 @@ declare class Validator<D extends Record<string, any> = any, R extends RulesForD
   /**
    * Get current data.
    */
-  getData(): Record<string, any>;
+  getData(): ValidatedByRules<D, R>;
   /**
    * Get current rules.
    */
@@ -1432,4 +1441,4 @@ declare class ValidationException extends Error {
   getResponse(): any;
 }
 //#endregion
-export { BaseValidationRuleClass, BaseValidator, CustomAttributes, CustomErrors, CustomMessages, CustomValidationRules, DotPaths, ErrorBag, ErrorMessage, Errors, ExtendedRules, ExtractRules, FieldMessages, GenericCallable, GenericObject, IDatabaseDriver, IMessageBag, IValidationRule, IValidator, ImplicitAttributes, ImplicitRule, InitialRule, InitialRules, Lang, MessageBag, Messages, MessagesForRules, ParamableValidationRuleName, Password, PlainRuleName, ReplaceAttributeInterface, Rules, RulesForData, TRule, ValidationCallback, ValidationDataInterface, ValidationDatabaseExistsInput, ValidationException, ValidationMessageProvider, ValidationRule, ValidationRuleCallable, ValidationRuleName, ValidationRuleParserInterface, ValidationRuleSet, ValidationServiceProvider, Validator, addImplicitRule, buildValidationMethodName, compare, convertValuesToBoolean, convertValuesToNull, convertValuesToNumber, deepEqual, deepFind, deepSet, dotify, getFormattedAttribute, getKeyCombinations, getMessage, getNumericRules, getSize, isArrayOfRules, isImplicitRule, isInteger, isNumericRule, isObject, isRule, isSizeRule, make, mergeDeep, notRegex, plural, regex, register, registerImplicit, requiredIf, ruleIn, ruleNotIn, sameType, toDate, toSnakeCase };
+export { BaseValidationRuleClass, BaseValidator, CustomAttributes, CustomErrors, CustomMessages, CustomValidationRules, DotPaths, ErrorBag, ErrorMessage, Errors, ExtendedRules, ExtractRules, FieldMessages, GenericCallable, GenericObject, IDatabaseDriver, IMessageBag, IValidationRule, IValidator, ImplicitAttributes, ImplicitRule, InitialRule, InitialRules, Lang, MessageBag, Messages, MessagesForRules, NestedStringMap, ParamableValidationRuleName, Password, PlainRuleName, ReplaceAttributeInterface, Rules, RulesForData, TRule, ValidatedByRules, ValidationCallback, ValidationDataInterface, ValidationDatabaseExistsInput, ValidationException, ValidationMessageProvider, ValidationRule, ValidationRuleCallable, ValidationRuleName, ValidationRuleParserInterface, ValidationRuleSet, ValidationServiceProvider, Validator, addImplicitRule, buildValidationMethodName, compare, convertValuesToBoolean, convertValuesToNull, convertValuesToNumber, deepEqual, deepFind, deepSet, dotify, getFormattedAttribute, getKeyCombinations, getMessage, getNumericRules, getSize, isArrayOfRules, isImplicitRule, isInteger, isNumericRule, isObject, isRule, isSizeRule, make, mergeDeep, notRegex, plural, regex, register, registerImplicit, requiredIf, ruleIn, ruleNotIn, sameType, toDate, toSnakeCase };

package/dist/index.js

@@ -1,3 +1,6 @@
+import customParseFormat from "dayjs/plugin/customParseFormat";
+import dayjs from "dayjs";
+
 //#region src/Rules/baseRule.ts
 var BaseRule = class {};
 
@@ -24,6 +27,7 @@ var en_default = {
 	boolean: "The :attribute field must be true or false.",
 	confirmed: "The :attribute confirmation does not match.",
 	date: "The :attribute is not a valid date.",
+	datetime: "The :attribute must be a valid date matching the format :format.",
 	date_equals: "The :attribute must be a date equal to :date.",
 	declined: "The :attribute must be declined.",
 	declined_if: "The :attribute must be declined when :other is :value.",
@@ -32,6 +36,7 @@ var en_default = {
 	digits_between: "The :attribute must be between :min and :max digits.",
 	email: "The :attribute must be a valid email address.",
 	ends_with: "The :attribute must end with one of the following: :values.",
+	exists: ":value is not a valid :attribute.",
 	gt: {
 		number: "The :attribute must be greater than :value.",
 		string: "The :attribute must be greater than :value characters.",
@@ -44,7 +49,9 @@ var en_default = {
 		array: "The :attribute must have :value items or more.",
 		object: "The :attribute must have :value items or more."
 	},
+	hex: "The :attribute must be a valid hexadecimal color.",
 	in: "The :attribute must be one of the following :values.",
+	includes: "The :attribute must include one of the following values: :values.",
 	integer: "The :attribute must be an integer.",
 	json: "The :attribute must be a valid JSON string.",
 	lt: {
@@ -73,6 +80,7 @@ var en_default = {
 	},
 	not_in: "The selected :attribute is invalid.",
 	not_regex: "The :attribute format is invalid.",
+	not_includes: "The :attribute must not include any of the following values: :values.",
 	numeric: "The :attribute must be a number.",
 	object: "The :attribute must be an object.",
 	password: {
@@ -105,6 +113,7 @@ var en_default = {
 		object: "The :attribute must contain :size items."
 	},
 	string: "The :attribute must be a string.",
+	unique: "The :attribute has already been taken.",
 	url: "The :attribute must have a valid URL format."
 };
 
@@ -130,6 +139,7 @@ var ar_default = {
 	boolean: "يجب أن تكون قيمة الحقل :attribute إما true أو false",
 	confirmed: "حقل التأكيد غير مُطابق للحقل :attribute",
 	date: "الحقل :attribute ليس تاريخًا صحيحًا",
+	datetime: "الحقل :attribute يجب أن يكون تاريخًا صالحًا يطابق الصيغة :format.",
 	date_equals: "لا يساوي الحقل :attribute مع :date.",
 	declined: "يجب رفض الحقل :attribute",
 	declined_if: "الحقل :attribute مرفوض في حال ما إذا كان :other يساوي :value.",
@@ -138,6 +148,7 @@ var ar_default = {
 	digits_between: "يجب أن يحتوي الحقل :attribute بين :min و :max رقمًا/أرقام",
 	email: "يجب أن يكون :attribute عنوان بريد إلكتروني صحيح البُنية",
 	ends_with: "حقل :attribute يجب ان ينتهي بأحد القيم التالية :value.",
+	exists: ":value غير صالح :attribute.",
 	gt: {
 		number: "حقل :attribute يجب ان يكون اكبر من :value.",
 		string: "حقل :attribute يجب ان يكون اكبر من :value حروفٍ/حرفًا.",
@@ -150,7 +161,9 @@ var ar_default = {
 		array: "حقل :attribute يجب ان يحتوي علي :value عناصر/عنصر او اكثر.",
 		object: "حقل :attribute يجب ان يحتوي علي :value عناصر/عنصر او اكثر."
 	},
+	hex: "الحقل :attribute يجب أن يكون لونًا سداسيًا صالحًا.",
 	in: "الحقل :attribute غير صالح",
+	includes: "الحقل :attribute يجب أن يحتوي على أحد القيم التالية: :values.",
 	integer: "يجب أن يكون الحقل :attribute عددًا صحيحًا",
 	json: "يجب أن يكون الحقل :attribute نصا من نوع JSON.",
 	lt: {
@@ -179,6 +192,7 @@ var ar_default = {
 	},
 	not_in: "الحقل :attribute غير صالح",
 	not_regex: "الحقل :attribute نوعه غير صالح",
+	not_includes: "الحقل :attribute يجب ألا يحتوي على أي من القيم التالية: :values.",
 	numeric: "يجب على الحقل :attribute أن يكون رقمًا",
 	object: "الحقل :attribute يجب ان يكون من نوع object.",
 	password: {
@@ -211,6 +225,7 @@ var ar_default = {
 		object: "يجب أن يحتوي الحقل :attribute على :size عنصرٍ/عناصر بالظبط"
 	},
 	string: "يجب أن يكون الحقل :attribute نصآ.",
+	unique: "الحقل :attribute مستخدم بالفعل.",
 	url: "صيغة الرابط :attribute غير صحيحة"
 };
 
@@ -1075,6 +1090,9 @@ const replaceAttributes = {
 	replaceDateEquals: function(payload) {
 		return this.replaceBefore(payload);
 	},
+	replaceDatetime: function({ message, parameters }) {
+		return message.replace(":format", parameters[0]);
+	},
 	replaceDeclinedIf: function({ message, parameters, data, getDisplayableAttribute }) {
 		const [other] = parameters;
 		const result = deepFind(data, other);
@@ -1096,9 +1114,15 @@ const replaceAttributes = {
 	replaceEndsWith: function({ message, parameters }) {
 		return message.replace(":values", parameters.join(", "));
 	},
+	replaceExists: function({ message, parameters, data }) {
+		return message.replace(":value", data[parameters[1]]);
+	},
 	replaceIn: function({ message, parameters }) {
 		return message.replace(":values", parameters.join(", "));
 	},
+	replaceIncludes: function({ message, parameters }) {
+		return message.replace(":values", parameters.join(", "));
+	},
 	replaceStartsWith: function({ message, parameters }) {
 		return message.replace(":values", parameters.join(", "));
 	},
@@ -1108,6 +1132,9 @@ const replaceAttributes = {
 	replaceMax: function({ message, parameters }) {
 		return message.replace(":max", parameters[0]);
 	},
+	replaceNotIncludes: function({ message, parameters }) {
+		return message.replace(":values", parameters.join(", "));
+	},
 	replaceRequiredWith: function({ message, parameters, getDisplayableAttribute }) {
 		return message.replace(":values", parameters.map((attribute) => getDisplayableAttribute(attribute)).join(", "));
 	},
@@ -1157,6 +1184,9 @@ const replaceAttributes = {
 	},
 	replaceSize: function({ message, parameters }) {
 		return message.replace(":size", parameters[0]);
+	},
+	replaceUnique: function({ message, parameters, data }) {
+		return message.replace(":value", data[parameters[1]]);
 	}
 };
 
@@ -2391,6 +2421,7 @@ var ValidationRule = class extends IRuleContract {
 
 //#endregion
 //#region src/Rules/ExtendedRules.ts
+dayjs.extend(customParseFormat);
 var ExtendedRules = class extends ValidationRule {
 	/**
 	* The validator instance.
@@ -2447,9 +2478,9 @@ var ExtendedRules = class extends ValidationRule {
 				const [format] = parameters;
 				if (!format) return !isNaN(Date.parse(value));
 				try {
-					return new Date(value).toISOString() === new Date(format).toISOString();
+					return dayjs(value, format, true).isValid();
 				} catch {
-					return !isNaN(Date.parse(value));
+					return false;
 				}
 			},
 			message: "The :attribute must be a valid date matching the format :format."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kanun",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Framework-agnostic TypeScript-first validation library.",
   "type": "module",
   "files": [
@@ -16,17 +16,17 @@
     },
     "./package.json": "./package.json"
   },
-  "homepage": "https://arcstack-hq.github.io/kanun",
+  "homepage": "https://arkstack-hq.github.io/kanun",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/arcstack-hq/kanun.git",
+    "url": "git+https://github.com/arkstack-hq/kanun.git",
     "directory": "packages/validation"
   },
   "keywords": [
-    "arcstack",
+    "arkstack",
     "modern",
     "web",
-    "Arcstack",
+    "Arkstack",
     "framework",
     "nodejs",
     "typescript",
@@ -50,6 +50,9 @@
     "vitepress": "2.0.0-alpha.16",
     "vitest": "^4.0.18"
   },
+  "dependencies": {
+    "dayjs": "^1.11.20"
+  },
   "scripts": {
     "lint": "eslint",
     "test": "vitest",