@zairakai/js-utils 1.0.0

package/dist/validators.d.cts

@@ -0,0 +1,216 @@
+/**
+ * Type checking and validation utilities
+ * Laravel-inspired validation helpers
+ */
+/**
+ * Check if value is strictly true
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is true} True if the value is strictly true
+ */
+declare const isTrue: (value: unknown) => value is true;
+/**
+ * Check if value is strictly false
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is false} True if the value is strictly false
+ */
+declare const isFalse: (value: unknown) => value is false;
+/**
+ * Check if value is strictly null
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is null} True if the value is strictly null
+ */
+declare const isNull: (value: unknown) => value is null;
+/**
+ * Check if value is strictly undefined
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is undefined} True if the value is strictly undefined
+ */
+declare const isUndefined: (value: unknown) => value is undefined;
+/**
+ * Check if value is neither null nor undefined
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is NonNullable<unknown>} True if the value is set
+ */
+declare const isSet: (value: unknown) => value is NonNullable<unknown>;
+/**
+ * Check if value is an array
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is unknown[]} True if the value is an array
+ */
+declare const isArray: (value: unknown) => value is unknown[];
+/**
+ * Check if value is a plain object (Record)
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is Record<string, unknown>} True if the value is a plain object
+ */
+declare const isObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * Check if value is a string
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a string
+ */
+declare const isString: (value: unknown) => value is string;
+/**
+ * Check if value is a number and not NaN
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is a valid number
+ */
+declare const isNumber: (value: unknown) => value is number;
+/**
+ * Check if value is an integer
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is an integer
+ */
+declare const isInteger: (value: unknown) => value is number;
+/**
+ * Check if value is a float
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is a float
+ */
+declare const isFloat: (value: unknown) => value is number;
+/**
+ * Check if value is a boolean
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is boolean} True if the value is a boolean
+ */
+declare const isBoolean: (value: unknown) => value is boolean;
+/**
+ * Check if value is a function
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is Function} True if the value is a function
+ */
+declare const isFunction: (value: unknown) => value is Function;
+/**
+ * Check if value is a valid Date object
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is Date} True if the value is a valid Date object
+ */
+declare const isDate: (value: unknown) => value is Date;
+/**
+ * Check if value is numeric (number or numeric string)
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number | string} True if the value is numeric
+ */
+declare const isNumeric: (value: unknown) => value is number | string;
+/**
+ * Check if value is a valid email address format
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a valid email string
+ */
+declare const isEmail: (value: unknown) => value is string;
+/**
+ * Check if value is a valid URL
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a valid URL string
+ */
+declare const isUrl: (value: unknown) => value is string;
+/**
+ * Check if value is empty (null, undefined, empty string/array/object, zero, or false)
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is empty
+ */
+declare const isEmpty: (value: unknown) => boolean;
+/**
+ * Check if value is not empty
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is not empty
+ */
+declare const isNotEmpty: (value: unknown) => boolean;
+/**
+ * Check if value is blank (null, undefined, or empty string/whitespace)
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is blank
+ */
+declare const isBlank: (value: unknown) => boolean;
+/**
+ * Check if value is present (not blank)
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is present
+ */
+declare const isPresent: (value: unknown) => boolean;
+/**
+ * Alias for isPresent()
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is filled
+ */
+declare const filled: (value: unknown) => boolean;
+/**
+ * Alias for isBlank()
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is blank
+ */
+declare const blank: (value: unknown) => boolean;
+/**
+ * Check if value is an even number
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is an even number
+ */
+declare const isEven: (value: unknown) => value is number;
+/**
+ * Check if value is an odd number
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is an odd number
+ */
+declare const isOdd: (value: unknown) => value is number;
+/**
+ * Check if value is a valid JSON string
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is a valid JSON string
+ */
+declare const isJson: (value: unknown) => boolean;
+/**
+ * Check if value is a valid Base64 encoded string
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is a valid Base64 string
+ */
+declare const isBase64: (value: unknown) => boolean;
+/**
+ * Check if value is a valid MAC address
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is a valid MAC address
+ */
+declare const isMacAddress: (value: unknown) => boolean;
+/**
+ * Check if value is a valid UUID (v4)
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a valid UUID v4 string
+ */
+declare const isUuid: (value: unknown) => value is string;
+/**
+ * Check if value is a valid IPv4 or IPv6 address
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a valid IP address string
+ */
+declare const isIp: (value: unknown) => value is string;
+
+export { blank, filled, isArray, isBase64, isBlank, isBoolean, isDate, isEmail, isEmpty, isEven, isFalse, isFloat, isFunction, isInteger, isIp, isJson, isMacAddress, isNotEmpty, isNull, isNumber, isNumeric, isObject, isOdd, isPresent, isSet, isString, isTrue, isUndefined, isUrl, isUuid };

package/dist/validators.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Type checking and validation utilities
+ * Laravel-inspired validation helpers
+ */
+/**
+ * Check if value is strictly true
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is true} True if the value is strictly true
+ */
+declare const isTrue: (value: unknown) => value is true;
+/**
+ * Check if value is strictly false
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is false} True if the value is strictly false
+ */
+declare const isFalse: (value: unknown) => value is false;
+/**
+ * Check if value is strictly null
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is null} True if the value is strictly null
+ */
+declare const isNull: (value: unknown) => value is null;
+/**
+ * Check if value is strictly undefined
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is undefined} True if the value is strictly undefined
+ */
+declare const isUndefined: (value: unknown) => value is undefined;
+/**
+ * Check if value is neither null nor undefined
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is NonNullable<unknown>} True if the value is set
+ */
+declare const isSet: (value: unknown) => value is NonNullable<unknown>;
+/**
+ * Check if value is an array
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is unknown[]} True if the value is an array
+ */
+declare const isArray: (value: unknown) => value is unknown[];
+/**
+ * Check if value is a plain object (Record)
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is Record<string, unknown>} True if the value is a plain object
+ */
+declare const isObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * Check if value is a string
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a string
+ */
+declare const isString: (value: unknown) => value is string;
+/**
+ * Check if value is a number and not NaN
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is a valid number
+ */
+declare const isNumber: (value: unknown) => value is number;
+/**
+ * Check if value is an integer
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is an integer
+ */
+declare const isInteger: (value: unknown) => value is number;
+/**
+ * Check if value is a float
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is a float
+ */
+declare const isFloat: (value: unknown) => value is number;
+/**
+ * Check if value is a boolean
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is boolean} True if the value is a boolean
+ */
+declare const isBoolean: (value: unknown) => value is boolean;
+/**
+ * Check if value is a function
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is Function} True if the value is a function
+ */
+declare const isFunction: (value: unknown) => value is Function;
+/**
+ * Check if value is a valid Date object
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is Date} True if the value is a valid Date object
+ */
+declare const isDate: (value: unknown) => value is Date;
+/**
+ * Check if value is numeric (number or numeric string)
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number | string} True if the value is numeric
+ */
+declare const isNumeric: (value: unknown) => value is number | string;
+/**
+ * Check if value is a valid email address format
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a valid email string
+ */
+declare const isEmail: (value: unknown) => value is string;
+/**
+ * Check if value is a valid URL
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a valid URL string
+ */
+declare const isUrl: (value: unknown) => value is string;
+/**
+ * Check if value is empty (null, undefined, empty string/array/object, zero, or false)
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is empty
+ */
+declare const isEmpty: (value: unknown) => boolean;
+/**
+ * Check if value is not empty
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is not empty
+ */
+declare const isNotEmpty: (value: unknown) => boolean;
+/**
+ * Check if value is blank (null, undefined, or empty string/whitespace)
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is blank
+ */
+declare const isBlank: (value: unknown) => boolean;
+/**
+ * Check if value is present (not blank)
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is present
+ */
+declare const isPresent: (value: unknown) => boolean;
+/**
+ * Alias for isPresent()
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is filled
+ */
+declare const filled: (value: unknown) => boolean;
+/**
+ * Alias for isBlank()
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is blank
+ */
+declare const blank: (value: unknown) => boolean;
+/**
+ * Check if value is an even number
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is an even number
+ */
+declare const isEven: (value: unknown) => value is number;
+/**
+ * Check if value is an odd number
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is number} True if the value is an odd number
+ */
+declare const isOdd: (value: unknown) => value is number;
+/**
+ * Check if value is a valid JSON string
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is a valid JSON string
+ */
+declare const isJson: (value: unknown) => boolean;
+/**
+ * Check if value is a valid Base64 encoded string
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is a valid Base64 string
+ */
+declare const isBase64: (value: unknown) => boolean;
+/**
+ * Check if value is a valid MAC address
+ *
+ * @param {unknown} value The value to check
+ * @returns {boolean} True if the value is a valid MAC address
+ */
+declare const isMacAddress: (value: unknown) => boolean;
+/**
+ * Check if value is a valid UUID (v4)
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a valid UUID v4 string
+ */
+declare const isUuid: (value: unknown) => value is string;
+/**
+ * Check if value is a valid IPv4 or IPv6 address
+ *
+ * @param {unknown} value The value to check
+ * @returns {value is string} True if the value is a valid IP address string
+ */
+declare const isIp: (value: unknown) => value is string;
+
+export { blank, filled, isArray, isBase64, isBlank, isBoolean, isDate, isEmail, isEmpty, isEven, isFalse, isFloat, isFunction, isInteger, isIp, isJson, isMacAddress, isNotEmpty, isNull, isNumber, isNumeric, isObject, isOdd, isPresent, isSet, isString, isTrue, isUndefined, isUrl, isUuid };

package/dist/validators.js

@@ -0,0 +1,64 @@
+import {
+  blank,
+  filled,
+  isArray,
+  isBase64,
+  isBlank,
+  isBoolean,
+  isDate,
+  isEmail,
+  isEmpty,
+  isEven,
+  isFalse,
+  isFloat,
+  isFunction,
+  isInteger,
+  isIp,
+  isJson,
+  isMacAddress,
+  isNotEmpty,
+  isNull,
+  isNumber,
+  isNumeric,
+  isObject,
+  isOdd,
+  isPresent,
+  isSet,
+  isString,
+  isTrue,
+  isUndefined,
+  isUrl,
+  isUuid
+} from "./chunk-XEJLBAXE.js";
+export {
+  blank,
+  filled,
+  isArray,
+  isBase64,
+  isBlank,
+  isBoolean,
+  isDate,
+  isEmail,
+  isEmpty,
+  isEven,
+  isFalse,
+  isFloat,
+  isFunction,
+  isInteger,
+  isIp,
+  isJson,
+  isMacAddress,
+  isNotEmpty,
+  isNull,
+  isNumber,
+  isNumeric,
+  isObject,
+  isOdd,
+  isPresent,
+  isSet,
+  isString,
+  isTrue,
+  isUndefined,
+  isUrl,
+  isUuid
+};

package/package.json

@@ -0,0 +1,180 @@
+{
+  "name": "@zairakai/js-utils",
+  "version": "1.0.0",
+  "description": "Laravel-inspired TypeScript helpers — fluent strings, numbers, objects, collections, PHP-like arrays, runtime utilities, deep equality, validators, datetime, and Zod schemas",
+  "keywords": [
+    "helpers",
+    "utilities",
+    "fluent",
+    "string",
+    "number",
+    "arrays",
+    "collections",
+    "datetime",
+    "validation",
+    "formatters",
+    "php",
+    "javascript",
+    "typescript"
+  ],
+  "homepage": "https://gitlab.com/zairakai/npm-packages/js-utils",
+  "bugs": {
+    "url": "https://gitlab.com/zairakai/npm-packages/js-utils/-/issues",
+    "email": "contact-project+zairakai-npm-packages-js-utils-80189643-issue-@incoming.gitlab.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/zairakai/npm-packages/js-utils.git"
+  },
+  "funding": [
+    {
+      "type": "patreon",
+      "url": "https://www.patreon.com/c/zairakai"
+    },
+    {
+      "type": "twitch",
+      "url": "https://www.twitch.tv/zairakai"
+    }
+  ],
+  "license": "MIT",
+  "author": "Stanislas Poisson <stanislas.p@the-white-rabbits.fr> (https://the-white-rabbits.fr)",
+  "contributors": [
+    {
+      "name": "Stanislas Poisson",
+      "url": "https://gitlab.com/zairakai",
+      "role": "Maintainer"
+    }
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./validators": {
+      "types": "./dist/validators.d.ts",
+      "import": "./dist/validators.js",
+      "require": "./dist/validators.cjs"
+    },
+    "./formatters": {
+      "types": "./dist/formatters.d.ts",
+      "import": "./dist/formatters.js",
+      "require": "./dist/formatters.cjs"
+    },
+    "./datetime": {
+      "types": "./dist/datetime.d.ts",
+      "import": "./dist/datetime.js",
+      "require": "./dist/datetime.cjs"
+    },
+    "./arrays": {
+      "types": "./dist/arrays.d.ts",
+      "import": "./dist/arrays.js",
+      "require": "./dist/arrays.cjs"
+    },
+    "./collections": {
+      "types": "./dist/collections.d.ts",
+      "import": "./dist/collections.js",
+      "require": "./dist/collections.cjs"
+    },
+    "./php-arrays": {
+      "types": "./dist/php-arrays.d.ts",
+      "import": "./dist/php-arrays.js",
+      "require": "./dist/php-arrays.cjs"
+    },
+    "./schemas": {
+      "types": "./dist/schemas.d.ts",
+      "import": "./dist/schemas.js",
+      "require": "./dist/schemas.cjs"
+    },
+    "./str": {
+      "types": "./dist/str.d.ts",
+      "import": "./dist/str.js",
+      "require": "./dist/str.cjs"
+    },
+    "./validator": {
+      "types": "./dist/validator.d.ts",
+      "import": "./dist/validator.js",
+      "require": "./dist/validator.cjs"
+    },
+    "./runtime": {
+      "types": "./dist/runtime.d.ts",
+      "import": "./dist/runtime.js",
+      "require": "./dist/runtime.cjs"
+    },
+    "./number": {
+      "types": "./dist/number.d.ts",
+      "import": "./dist/number.js",
+      "require": "./dist/number.cjs"
+    },
+    "./obj": {
+      "types": "./dist/obj.d.ts",
+      "import": "./dist/obj.js",
+      "require": "./dist/obj.cjs"
+    },
+    "./equals": {
+      "types": "./dist/equals.d.ts",
+      "import": "./dist/equals.js",
+      "require": "./dist/equals.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "require": "./dist/types.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup --config config/dev-tools/tsup.config.js",
+    "docs": "typedoc --options config/dev-tools/typedoc.json",
+    "eslint": "eslint . --config config/dev-tools/eslint.config.js",
+    "eslint:fix": "eslint . --config config/dev-tools/eslint.config.js --fix",
+    "postinstall": "bash node_modules/@zairakai/js-dev-tools/scripts/setup-project.sh --silent || true",
+    "markdownlint": "markdownlint '**/*.md' --ignore node_modules --config config/dev-tools/.markdownlint.json",
+    "markdownlint:fix": "markdownlint '**/*.md' --ignore node_modules --config config/dev-tools/.markdownlint.json --fix",
+    "normalize": "make package-normalize",
+    "package:validate": "make package-validate",
+    "prettier": "prettier . --check --config config/dev-tools/prettier.config.js",
+    "prettier:fix": "prettier . --write --config config/dev-tools/prettier.config.js",
+    "setup": "bash node_modules/@zairakai/js-dev-tools/scripts/setup-project.sh",
+    "test": "vitest --config config/dev-tools/vitest.config.js",
+    "typecheck": "tsc --noEmit",
+    "validate": "make quality"
+  },
+  "dependencies": {
+    "dayjs": "^1.11.13"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "@vitest/coverage-v8": "^4.0.0",
+    "@zairakai/js-dev-tools": "^1.0.0",
+    "knip": "^5.85.0",
+    "sort-package-json": "^3.6.1",
+    "tsup": "^8.0.0",
+    "typedoc": "^0.28.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.0",
+    "zod": "^4.0.0"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}