kanun 0.1.4 → 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

@@ -193,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;
@@ -214,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

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.4",
+  "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",