js-utils-kit 0.2.3 → 0.3.1

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var e=require("./char/index.cjs"),r=require("./env/index.cjs"),i=require("./file/index.cjs"),u=require("./number/index.cjs"),s=require("./object/index.cjs"),t=require("./string/index.cjs");require("fs"),require("path"),require("constants"),require("stream"),require("util"),require("assert"),require("buffer"),require("node:url"),require("node:path"),require("node:fs"),require("node:fs/promises"),require("node:events"),require("node:stream"),require("node:string_decoder"),require("zlib"),exports.char=e.default,exports.env=r.default,exports.file=i.default,exports.number=u.default,exports.object=s.default,exports.string=t.default;
+"use strict";var e=require("./array/index.cjs"),r=require("./char/index.cjs"),s=require("./env/index.cjs"),t=require("./file/index.cjs"),i=require("./number/index.cjs"),o=require("./object/index.cjs"),a=require("./string/index.cjs"),p=require("./validate-BKQ-HFTd.js");require("fs"),require("path"),require("events"),require("constants"),require("stream"),require("util"),require("assert"),require("buffer"),require("node:url"),require("node:path"),require("node:fs"),require("node:fs/promises"),require("node:events"),require("node:stream"),require("node:string_decoder"),require("zlib"),exports.array=e.default,exports.all=r.all,exports.char=r.default,exports.digits=r.digits,exports.lowercase=r.lowercase,exports.uppercase=r.uppercase,Object.defineProperty(exports,"Environment",{enumerable:!0,get:function(){return s.Environment}}),exports.env=s.default,exports.getRunTimeEnvironment=s.getRunTimeEnvironment,exports.isBrowser=s.isBrowser,exports.isDev=s.isDev,exports.isNode=s.isNode,exports.isProd=s.isProd,exports.isTest=s.isTest,exports.createArchive=t.createArchive,exports.file=t.default,exports.clamp=i.clamp,exports.isEven=i.isEven,exports.isOdd=i.isOdd,exports.number=i.default,exports.randomFloat=i.randomFloat,exports.randomInt=i.randomInt,exports.isEmptyObject=o.isEmptyObject,exports.isNonEmptyObject=o.isNonEmptyObject,exports.isObject=o.isObject,exports.mergeObj=o.mergeObj,exports.object=o.default,exports.capitalize=a.capitalize,exports.containsWhitespace=a.containsWhitespace,exports.endsWithPunctuation=a.endsWithPunctuation,exports.isAlphabetic=a.isAlphabetic,exports.isCamelCase=a.isCamelCase,exports.isEmail=a.isEmail,exports.isKebabCase=a.isKebabCase,exports.isLowerCase=a.isLowerCase,exports.isNonEmptyString=a.isNonEmptyString,exports.isNumericString=a.isNumericString,exports.isPascalCase=a.isPascalCase,exports.isSnakeCase=a.isSnakeCase,exports.isString=a.isString,exports.isURL=a.isURL,exports.isUpperCase=a.isUpperCase,exports.padLeft=a.padLeft,exports.padRight=a.padRight,exports.repeatString=a.repeatString,exports.startsWithUppercase=a.startsWithUppercase,exports.string=a.default,exports.trim=a.trim,exports.truncate=a.truncate,exports.isArray=p.isArray,exports.isDefined=p.isDefined,exports.isUndefinedOrNull=p.isUndefinedOrNull;

package/dist/index.d.ts

@@ -1,7 +1,37 @@
-export { default as char } from './char/index.js';
-export { default as env } from './env/index.js';
-export { default as file } from './file/index.js';
-export { default as number } from './number/index.js';
-export { default as object } from './object/index.js';
-export { default as string } from './string/index.js';
-import 'archiver';
+export { default as array, isArray } from './array/index.js';
+export { all, default as char, digits, lowercase, uppercase } from './char/index.js';
+export { Environment, default as env, getRunTimeEnvironment, isBrowser, isDev, isNode, isProd, isTest } from './env/index.js';
+export { ArchiveFormat, CreateArchiveOptions, createArchive, default as file } from './file/index.js';
+export { clamp, isEven, isOdd, default as number, randomFloat, randomInt } from './number/index.js';
+export { isEmptyObject, isNonEmptyObject, isObject, mergeObj, default as object } from './object/index.js';
+export { Trim, capitalize, containsWhitespace, endsWithPunctuation, isAlphabetic, isCamelCase, isEmail, isKebabCase, isLowerCase, isNonEmptyString, isNumericString, isPascalCase, isSnakeCase, isString, isURL, isUpperCase, padLeft, padRight, repeatString, startsWithUppercase, default as string, trim, truncate } from './string/index.js';
+export { ArchiverOptions } from 'archiver';
+
+/**
+ * Checks if a value is neither null nor undefined.
+ * @param value - The value to check.
+ * @returns True if the value is defined (not null or undefined), false otherwise.
+ * @example
+ * ```ts
+ * isDefined(42); // true
+ * isDefined("hello"); // true
+ * isDefined(null); // false
+ * isDefined(undefined); // false
+ * ```
+ */
+declare function isDefined<T>(value: T): boolean;
+/**
+ * Checks if a value is either null or undefined.
+ * @param value - The value to check.
+ * @returns True if the value is null or undefined, false otherwise.
+ * @example
+ * ```ts
+ * isUndefinedOrNull(null); // true
+ * isUndefinedOrNull(undefined); // true
+ * isUndefinedOrNull(0); // false
+ * isUndefinedOrNull(""); // false
+ * ```
+ */
+declare function isUndefinedOrNull<T>(value: T): boolean;
+
+export { isDefined, isUndefinedOrNull };

package/dist/index.js

@@ -1 +1 @@
-export{default as char}from"./char/index.js";export{default as env}from"./env/index.js";export{default as file}from"./file/index.js";export{default as number}from"./number/index.js";export{default as object}from"./object/index.js";export{default as string}from"./string/index.js";import"fs";import"path";import"constants";import"stream";import"util";import"assert";import"buffer";import"node:url";import"node:path";import"node:fs";import"node:fs/promises";import"node:events";import"node:stream";import"node:string_decoder";import"zlib";
+export{default as array}from"./array/index.js";export{all,default as char,digits,lowercase,uppercase}from"./char/index.js";export{Environment,default as env,getRunTimeEnvironment,isBrowser,isDev,isNode,isProd,isTest}from"./env/index.js";export{createArchive,default as file}from"./file/index.js";export{clamp,isEven,isOdd,default as number,randomFloat,randomInt}from"./number/index.js";export{isEmptyObject,isNonEmptyObject,isObject,mergeObj,default as object}from"./object/index.js";export{capitalize,containsWhitespace,endsWithPunctuation,isAlphabetic,isCamelCase,isEmail,isKebabCase,isLowerCase,isNonEmptyString,isNumericString,isPascalCase,isSnakeCase,isString,isURL,isUpperCase,padLeft,padRight,repeatString,startsWithUppercase,default as string,trim,truncate}from"./string/index.js";export{i as isArray,a as isDefined,b as isUndefinedOrNull}from"./validate-D9J7otjc.js";import"fs";import"path";import"events";import"constants";import"stream";import"util";import"assert";import"buffer";import"node:url";import"node:path";import"node:fs";import"node:fs/promises";import"node:events";import"node:stream";import"node:string_decoder";import"zlib";

package/dist/object/index.cjs

@@ -1 +1 @@
-"use strict";function r(e=!1,...t){const o=r=>"object"==typeof r&&null!==r&&!Array.isArray(r);return t.reduce((t,s)=>{for(const n in s){const a=s[n],u=t[n];Array.isArray(a)?t[n]=e&&Array.isArray(u)?[...u,...a]:[...a]:o(a)?t[n]=r(e,o(u)?u:{},a):t[n]=a}return t},{})}Object.defineProperty(exports,"__esModule",{value:!0});var e={mergeObj:r};exports.default=e,exports.mergeObj=r;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("../validate-BKQ-HFTd.js");function t(e=!1,...r){const o=e=>"object"==typeof e&&null!==e,s={};for(const c of r)if(o(c))for(const r of Object.keys(c)){const n=c[r],y=s[r];Array.isArray(n)?s[r]=e&&Array.isArray(y)?[...y,...n]:[...n]:o(n)&&!Array.isArray(n)?s[r]=o(y)&&!Array.isArray(y)?t(e,y,n):t(e,{},n):s[r]=n}return s}function r(t){return e.isDefined(t)&&"object"==typeof t&&!e.isArray(t)&&Object.getPrototypeOf(t)===Object.prototype}function o(t){return null!==t&&"object"==typeof t&&0===Object.keys(t).length&&!e.isArray(t)}function s(t){return null!==t&&"object"==typeof t&&Object.keys(t).length>0&&!e.isArray(t)}var c={mergeObj:t,isObject:r,isEmptyObject:o,isNonEmptyObject:s};exports.default=c,exports.isEmptyObject=o,exports.isNonEmptyObject=s,exports.isObject=r,exports.mergeObj=t;

package/dist/object/index.d.ts

@@ -18,7 +18,7 @@
  * const defaultConfig = { env: "dev", features: ["a"], flags: { debug: true } };
  * const userConfig = { env: "prod", features: ["b"], flags: { beta: true } };
  *
- * const result = mergeObj(false, defaultConfig, userConfig);
+ * const result = mergeObj(defaultConfig, userConfig);
  * // {
  * //   env: "prod",
  * //   features: ["b"],        // replaced, not merged
@@ -37,10 +37,53 @@
  * @param sources - One or more objects to deeply merge.
  * @returns A new object containing deeply merged keys and values.
  */
-declare function mergeObj(appendArray?: boolean, ...sources: Record<string, unknown>[]): Record<string, unknown>;
+declare function mergeObj(appendArray?: boolean, ...sources: object[]): object;
+
+/**
+ * Checks if a value is a plain object (created by {} or new Object()).
+ * @param value - The value to check.
+ * @returns True if the value is a plain object, false otherwise.
+ * @example
+ * ```ts
+ * isObject({}); // true
+ * isObject(new Object()); // true
+ * isObject([]); // false
+ * isObject(new Date()); // false
+ * ```
+ */
+declare function isObject<T>(value: T): boolean;
+/**
+ * Checks if a value is an empty object (has no enumerable own properties).
+ * @param value - The value to check.
+ * @returns True if the value is a non-null object with no enumerable own properties, false otherwise.
+ * @example
+ * ```ts
+ * isEmptyObject({}); // true
+ * isEmptyObject({ key: 'value' }); // false
+ * isEmptyObject(null); // false
+ * isEmptyObject([]); // false
+ * ```
+ */
+declare function isEmptyObject(value: object): boolean;
+/**
+ * Checks if a value is a non-empty object (has at least one enumerable own property).
+ * @param value - The value to check.
+ * @returns True if the value is a non-null object with at least one enumerable own property, false otherwise.
+ * @example
+ * ```ts
+ * isNonEmptyObject({ key: 'value' }); // true
+ * isNonEmptyObject({}); // false
+ * isNonEmptyObject(null); // false
+ * isNonEmptyObject([]); // false
+ * ```
+ */
+declare function isNonEmptyObject(value: object): boolean;
 
 declare const _default: {
     mergeObj: typeof mergeObj;
+    isObject: typeof isObject;
+    isEmptyObject: typeof isEmptyObject;
+    isNonEmptyObject: typeof isNonEmptyObject;
 };
 
-export { _default as default, mergeObj };
+export { _default as default, isEmptyObject, isNonEmptyObject, isObject, mergeObj };

package/dist/object/index.js

@@ -1 +1 @@
-function r(e=!1,...t){const a=r=>"object"==typeof r&&null!==r&&!Array.isArray(r);return t.reduce((t,n)=>{for(const o in n){const s=n[o],y=t[o];Array.isArray(s)?t[o]=e&&Array.isArray(y)?[...y,...s]:[...s]:a(s)?t[o]=r(e,a(y)?y:{},s):t[o]=s}return t},{})}var e={mergeObj:r};export{e as default,r as mergeObj};
+import{i as t,a as e}from"../validate-D9J7otjc.js";function r(t=!1,...e){const o=t=>"object"==typeof t&&null!==t,n={};for(const c of e)if(o(c))for(const e of Object.keys(c)){const y=c[e],s=n[e];Array.isArray(y)?n[e]=t&&Array.isArray(s)?[...s,...y]:[...y]:o(y)&&!Array.isArray(y)?n[e]=o(s)&&!Array.isArray(s)?r(t,s,y):r(t,{},y):n[e]=y}return n}function o(r){return e(r)&&"object"==typeof r&&!t(r)&&Object.getPrototypeOf(r)===Object.prototype}function n(e){return null!==e&&"object"==typeof e&&0===Object.keys(e).length&&!t(e)}function c(e){return null!==e&&"object"==typeof e&&Object.keys(e).length>0&&!t(e)}var y={mergeObj:r,isObject:o,isEmptyObject:n,isNonEmptyObject:c};export{y as default,n as isEmptyObject,c as isNonEmptyObject,o as isObject,r as mergeObj};

package/dist/string/index.cjs

@@ -1 +1 @@
-"use strict";function t(t){return null!=t&&"string"==typeof t}function r(r,e=!0){return!!t(r)&&(e?r.trim().length>0:r.length>0)}function e(t){try{return new URL(t),!0}catch{return!1}}function i(t){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t)}function n(t){return/^[a-zA-Z]+$/.test(t)}function s(t){return!isNaN(Number(t))&&!isNaN(parseFloat(t))}Object.defineProperty(exports,"__esModule",{value:!0});var u={isString:t,isNonEmptyString:r,isURL:e,isEmail:i,isAlphabetic:n,isNumericString:s};exports.default=u,exports.isAlphabetic=n,exports.isEmail=i,exports.isNonEmptyString=r,exports.isNumericString=s,exports.isString=t,exports.isURL=e;
+"use strict";function t(t){return t.replace(/^\w/,t=>t.toUpperCase())}function e(t,e,r=" "){return t.padStart(e,r)}function r(t,e,r=" "){return t.padEnd(e,r)}function s(t,e,r="..."){return t.length>e?t.slice(0,e-r.length)+r:t}function n(t,e){return t.repeat(e)}Object.defineProperty(exports,"__esModule",{value:!0});const i={function:t=>t.trim(),start:t=>t.trimStart(),end:t=>t.trimEnd(),normalizeWhitespace:t=>t.trim().replace(/\s+/g," ")};function a(t){return null!=t&&"string"==typeof t}function o(t,e=!0){return!!a(t)&&("string"==typeof t&&(e?t.trim().length>0:t.length>0))}function p(t){try{return new URL(t),!0}catch{return!1}}function u(t){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t)}function c(t){return/^[a-zA-Z]+$/.test(t)}function f(t){return!isNaN(Number(t))&&!isNaN(parseFloat(t))}function l(t){return/^[A-Z]/.test(t)}function x(t){return/[\p{P}]$/u.test(t)}function g(t){return/\s/.test(t)}function m(t){return/^[a-z][a-zA-Z0-9]*$/.test(t)}function h(t){return/^[A-Z][a-zA-Z0-9]*$/.test(t)}function C(t){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(t)}function d(t){return/^[a-z0-9]+(_[a-z0-9]+)*$/.test(t)}function z(t){return/^[A-Z]+$/.test(t)}function S(t){return/^[a-z]+$/.test(t)}var N={capitalize:t,padLeft:e,padRight:r,truncate:s,repeatString:n,trim:i,isString:a,isNonEmptyString:o,isURL:p,isEmail:u,isAlphabetic:c,isNumericString:f,startsWithUppercase:l,endsWithPunctuation:x,containsWhitespace:g,isCamelCase:m,isPascalCase:h,isKebabCase:C,isSnakeCase:d,isUpperCase:z,isLowerCase:S};exports.capitalize=t,exports.containsWhitespace=g,exports.default=N,exports.endsWithPunctuation=x,exports.isAlphabetic=c,exports.isCamelCase=m,exports.isEmail=u,exports.isKebabCase=C,exports.isLowerCase=S,exports.isNonEmptyString=o,exports.isNumericString=f,exports.isPascalCase=h,exports.isSnakeCase=d,exports.isString=a,exports.isURL=p,exports.isUpperCase=z,exports.padLeft=e,exports.padRight=r,exports.repeatString=n,exports.startsWithUppercase=l,exports.trim=i,exports.truncate=s;

package/dist/string/index.d.ts

@@ -1,3 +1,153 @@
+/**
+ * String trimming utilities.
+ * Trims whitespace from a string (both sides by default) with methods for leading and trailing and normalizing whitespace.
+ */
+interface Trim {
+    /**
+     * Removes whitespace from both ends of a string.
+     *
+     * @param str - The string to trim.
+     * @returns The trimmed string.
+     */
+    function(str: string): string;
+    /**
+     * Removes leading whitespace from a string.
+     *
+     * @param str - The string to trim.
+     * @returns The string with leading whitespace removed.
+     */
+    start(str: string): string;
+    /**
+     * Removes trailing whitespace from a string.
+     *
+     * @param str - The string to trim.
+     * @returns The string with trailing whitespace removed.
+     */
+    end(str: string): string;
+    /**
+     * Trims the string and replaces sequences of whitespace with a single space.
+     *
+     * @param str - The string to normalize.
+     * @returns The string with normalized whitespace.
+     */
+    normalizeWhitespace(str: string): string;
+}
+/**
+ * String trimming utilities.
+ * Trims whitespace from a string (both sides by default) with methods for leading and trailing and normalizing whitespace.
+ *
+ * @param str - The string to trim.
+ *
+ * @returns The string with leading and trailing whitespace removed.
+ *
+ * @remarks
+ * - The main callable form behaves like {@link String.prototype.trim}, removing whitespace from both ends.
+ * - `.start` removes only leading whitespace (like {@link String.prototype.trimStart}).
+ * - `.end` removes only trailing whitespace (like {@link String.prototype.trimEnd}).
+ * - `.normalizeWhitespace` trims the string and replaces any sequence of whitespace characters with a single space.
+ *
+ * @example
+ * ```ts
+ * // Trim both sides
+ * console.log(trim("  hello  ")); // "hello"
+ * console.log(trim("")); // ""
+ * console.log(trim("hello")); // "hello"
+ *
+ * // Trim leading whitespace
+ * console.log(trim.start("  hello  ")); // "hello  "
+ * console.log(trim.start("")); // ""
+ * console.log(trim.start("hello")); // "hello"
+ *
+ * // Trim trailing whitespace
+ * console.log(trim.end("  hello  ")); // "  hello"
+ * console.log(trim.end("")); // ""
+ * console.log(trim.end("hello")); // "hello"
+ *
+ * // Normalize whitespace
+ * console.log(trim.normalizeWhitespace("  hello   world  ")); // "hello world"
+ * console.log(trim.normalizeWhitespace("hello\t  world")); // "hello world"
+ * console.log(trim.normalizeWhitespace("")); // ""
+ * ```
+ */
+declare const trim: Trim;
+
+/**
+ * Capitalizes the first character of a string using a regular expression.
+ *
+ * @param value - The string to capitalize.
+ *
+ * @returns The input string with its first character capitalized, or the original string if empty or not a string.
+ *
+ * @example
+ * ```ts
+ * capitalize("hello"); // "Hello"
+ * capitalize("world"); // "World"
+ * capitalize(""); // ""
+ * capitalize("a"); // "A"
+ * ```
+ */
+declare function capitalize(value: string): string;
+
+/**
+ * Pads a string on the left with a specified character until it reaches the desired length.
+ * @param str - The string to pad.
+ * @param length - The target length of the padded string.
+ * @param char - The character to use for padding (defaults to a space).
+ * @returns The padded string, or the original string if its length is already greater than or equal to the target length.
+ * @example
+ * ```ts
+ * console.log(padLeft("hello", 8)); // "   hello"
+ * console.log(padLeft("hi", 5, "*")); // "***hi"
+ * console.log(padLeft("hello", 3)); // "hello"
+ * console.log(padLeft("", 3, "0")); // "000"
+ * ```
+ */
+declare function padLeft(str: string, length: number, char?: string): string;
+/**
+ * Pads a string on the right with a specified character until it reaches the desired length.
+ * @param str - The string to pad.
+ * @param length - The target length of the padded string.
+ * @param char - The character to use for padding (defaults to a space).
+ * @returns The padded string, or the original string if its length is already greater than or equal to the target length.
+ * @example
+ * ```ts
+ * console.log(padRight("hello", 8)); // "hello   "
+ * console.log(padRight("hi", 5, "*")); // "hi***"
+ * console.log(padRight("hello", 3)); // "hello"
+ * console.log(padRight("", 3, "0")); // "000"
+ * ```
+ */
+declare function padRight(str: string, length: number, char?: string): string;
+/**
+ * Truncates a string to a specified length, appending a suffix if the string is too long.
+ * @param str - The string to truncate.
+ * @param length - The maximum length of the resulting string (including the suffix).
+ * @param suffix - The suffix to append if truncation occurs (defaults to "...").
+ * @returns The truncated string with the suffix if the original string exceeds the length, otherwise the original string.
+ * @example
+ * ```ts
+ * console.log(truncate("hello world", 8)); // "hello..."
+ * console.log(truncate("hi", 5)); // "hi"
+ * console.log(truncate("hello", 5, "...")); // "he..."
+ * console.log(truncate("", 3)); // ""
+ * ```
+ */
+declare function truncate(str: string, length: number, suffix?: string): string;
+/**
+ * Repeats a string a specified number of times.
+ * @param str - The string to repeat.
+ * @param count - The number of times to repeat the string (must be non-negative).
+ * @returns The string repeated the specified number of times.
+ * @example
+ * ```ts
+ * console.log(repeatString("hi", 3)); // "hihihi"
+ * console.log(repeatString("a", 2)); // "aa"
+ * console.log(repeatString("test", 0)); // ""
+ * console.log(repeatString("", 5)); // ""
+ * ```
+ */
+declare function repeatString(str: string, count: number): string;
+
 /**
  * Determines whether the provided value is a string.
  *
@@ -22,7 +172,7 @@
  * }
  * ```
  */
-declare function isString<T>(value: T): value is T & string;
+declare function isString<T>(value: T): boolean;
 /**
  * Determines whether the given value is a non-empty string.
  *
@@ -43,11 +193,13 @@ declare function isString<T>(value: T): value is T & string;
  * @returns - A boolean indicating whether the input is a non-empty string.
  *
  * @example
+ * ```ts
  * isNonEmptyString('hello'); // true
  * isNonEmptyString('   '); // false (trim is true by default)
  * isNonEmptyString('   ', false); // true (whitespace is counted)
  * isNonEmptyString(123); // false
  * isNonEmptyString(null); // false
+ * ```
  */
 declare function isNonEmptyString<T>(value: T, trim?: boolean): boolean;
 /**
@@ -60,10 +212,12 @@ declare function isNonEmptyString<T>(value: T, trim?: boolean): boolean;
  * @returns - `true` if the string is a valid absolute URL; otherwise, `false`.
  *
  * @example
+ * ```ts
  * isURL('https://example.com'); // true
  * isURL('ftp://files.example.com'); // true
  * isURL('invalid-url'); // false
  * isURL('/relative/path'); // false
+ * ```
  */
 declare function isURL(value: string): boolean;
 /**
@@ -77,10 +231,12 @@ declare function isURL(value: string): boolean;
  * @returns - `true` if the string is a valid email; otherwise, `false`.
  *
  * @example
+ * ```ts
  * isEmail('user@example.com'); // true
  * isEmail('first.last@college.university.in'); // true
  * isEmail('invalid-email'); // false
  * isEmail('name@domain'); // false
+ * ```
  */
 declare function isEmail(value: string): boolean;
 /**
@@ -90,9 +246,11 @@ declare function isEmail(value: string): boolean;
  * @returns - `true` if the string contains only letters; otherwise, `false`.
  *
  * @example
+ * ```ts
  * isAlphabetic("Hello"); // true
  * isAlphabetic("world123"); // false
  * isAlphabetic("Test!"); // false
+ * ```
  */
 declare function isAlphabetic(value: string): boolean;
 /**
@@ -111,27 +269,145 @@ declare function isAlphabetic(value: string): boolean;
  * @returns - `true` if the string represents a valid number; otherwise, `false`.
  *
  * @example
+ * ```ts
  * isNumericString("42"); // true
  * isNumericString("-3.14"); // true
  * isNumericString("1e5"); // true
  * isNumericString("  123 "); // true
  * isNumericString("123abc"); // false
  * isNumericString("abc123"); // false
- *
+ * ```
  * See also:
  * - {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number Number()}
  * - {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/parseFloat parseFloat()}
  * - {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/isNaN isNaN()}
  */
 declare function isNumericString(value: string): boolean;
+/**
+ * Checks if a string starts with an uppercase letter.
+ * @param value - The input string to check.
+ * @returns True if the first character is uppercase, false otherwise.
+ * @example
+ * ```ts
+ * startsWithUppercase('Hello') // true
+ * startsWithUppercase('world') // false
+ * ```
+ */
+declare function startsWithUppercase(value: string): boolean;
+/**
+ * Checks if a string ends with any Unicode punctuation character.
+ *
+ * @param value - The string to check.
+ * @returns True if the string ends with a punctuation character.
+ * @example
+ * ```ts
+ * endsWithPunctuation("Hi!") // true
+ * endsWithPunctuation("Hello—") // true
+ * endsWithPunctuation("Okay") // false
+ * ```
+ */
+declare function endsWithPunctuation(value: string): boolean;
+/**
+ * Checks if a string contains any whitespace.
+ * @param value - The string to check.
+ * @returns True if the string contains whitespace.
+ * @example
+ * ```ts
+ * containsWhitespace("Hello world") // true
+ * containsWhitespace("Nowordspace") // false
+ * ```
+ */
+declare function containsWhitespace(value: string): boolean;
+/**
+ * Checks if a string is in camelCase format.
+ * @param value - The input string.
+ * @returns True if the string is camelCase.
+ * @example
+ * ```ts
+ * isCamelCase("helloWorld") // true
+ * isCamelCase("HelloWorld") // false
+ * ```
+ */
+declare function isCamelCase(value: string): boolean;
+/**
+ * Checks if a string is in PascalCase format.
+ * @param value - The input string.
+ * @returns True if the string is PascalCase.
+ * @example
+ * ```ts
+ * isPascalCase("HelloWorld") // true
+ * isPascalCase("helloWorld") // false
+ * ```
+ */
+declare function isPascalCase(value: string): boolean;
+/**
+ * Checks if a string is in kebab-case format.
+ * @param value - The input string.
+ * @returns True if the string is kebab-case.
+ * @example
+ * ```ts
+ * isKebabCase("hello-world") // true
+ * isKebabCase("hello_world") // false
+ * ```
+ */
+declare function isKebabCase(value: string): boolean;
+/**
+ * Checks if a string is in snake_case format.
+ * @param value - The input string.
+ * @returns True if the string is snake_case.
+ * @example
+ * ```ts
+ * isSnakeCase("hello_world") // true
+ * isSnakeCase("hello-world") // false
+ * ```
+ */
+declare function isSnakeCase(value: string): boolean;
+/**
+ * Checks if a string contains only uppercase letters.
+ * @param value - The input string.
+ * @returns True if all letters are uppercase.
+ * @example
+ * ```ts
+ * isUpperCase("HELLO") // true
+ * isUpperCase("Hello") // false
+ * ```
+ */
+declare function isUpperCase(value: string): boolean;
+/**
+ * Checks if a string contains only lowercase letters.
+ * @param value - The input string.
+ * @returns True if all letters are lowercase.
+ * @example
+ * ```ts
+ * isLowerCase("hello") // true
+ * isLowerCase("Hello") // false
+ * ```
+ */
+declare function isLowerCase(value: string): boolean;
 
 declare const _default: {
+    capitalize: typeof capitalize;
+    padLeft: typeof padLeft;
+    padRight: typeof padRight;
+    truncate: typeof truncate;
+    repeatString: typeof repeatString;
+    trim: Trim;
     isString: typeof isString;
     isNonEmptyString: typeof isNonEmptyString;
     isURL: typeof isURL;
     isEmail: typeof isEmail;
     isAlphabetic: typeof isAlphabetic;
     isNumericString: typeof isNumericString;
+    startsWithUppercase: typeof startsWithUppercase;
+    endsWithPunctuation: typeof endsWithPunctuation;
+    containsWhitespace: typeof containsWhitespace;
+    isCamelCase: typeof isCamelCase;
+    isPascalCase: typeof isPascalCase;
+    isKebabCase: typeof isKebabCase;
+    isSnakeCase: typeof isSnakeCase;
+    isUpperCase: typeof isUpperCase;
+    isLowerCase: typeof isLowerCase;
 };
 
-export { _default as default, isAlphabetic, isEmail, isNonEmptyString, isNumericString, isString, isURL };
+export { capitalize, containsWhitespace, _default as default, endsWithPunctuation, isAlphabetic, isCamelCase, isEmail, isKebabCase, isLowerCase, isNonEmptyString, isNumericString, isPascalCase, isSnakeCase, isString, isURL, isUpperCase, padLeft, padRight, repeatString, startsWithUppercase, trim, truncate };
+export type { Trim };

package/dist/string/index.js

@@ -1 +1 @@
-function t(t){return null!=t&&"string"==typeof t}function n(n,r=!0){return!!t(n)&&(r?n.trim().length>0:n.length>0)}function r(t){try{return new URL(t),!0}catch{return!1}}function i(t){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t)}function e(t){return/^[a-zA-Z]+$/.test(t)}function u(t){return!isNaN(Number(t))&&!isNaN(parseFloat(t))}var s={isString:t,isNonEmptyString:n,isURL:r,isEmail:i,isAlphabetic:e,isNumericString:u};export{s as default,e as isAlphabetic,i as isEmail,n as isNonEmptyString,u as isNumericString,t as isString,r as isURL};
+function t(t){return t.replace(/^\w/,t=>t.toUpperCase())}function n(t,n,e=" "){return t.padStart(n,e)}function e(t,n,e=" "){return t.padEnd(n,e)}function r(t,n,e="..."){return t.length>n?t.slice(0,n-e.length)+e:t}function i(t,n){return t.repeat(n)}const a={function:t=>t.trim(),start:t=>t.trimStart(),end:t=>t.trimEnd(),normalizeWhitespace:t=>t.trim().replace(/\s+/g," ")};function s(t){return null!=t&&"string"==typeof t}function u(t,n=!0){return!!s(t)&&("string"==typeof t&&(n?t.trim().length>0:t.length>0))}function c(t){try{return new URL(t),!0}catch{return!1}}function o(t){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(t)}function f(t){return/^[a-zA-Z]+$/.test(t)}function p(t){return!isNaN(Number(t))&&!isNaN(parseFloat(t))}function l(t){return/^[A-Z]/.test(t)}function g(t){return/[\p{P}]$/u.test(t)}function m(t){return/\s/.test(t)}function h(t){return/^[a-z][a-zA-Z0-9]*$/.test(t)}function z(t){return/^[A-Z][a-zA-Z0-9]*$/.test(t)}function d(t){return/^[a-z0-9]+(-[a-z0-9]+)*$/.test(t)}function $(t){return/^[a-z0-9]+(_[a-z0-9]+)*$/.test(t)}function C(t){return/^[A-Z]+$/.test(t)}function A(t){return/^[a-z]+$/.test(t)}var N={capitalize:t,padLeft:n,padRight:e,truncate:r,repeatString:i,trim:a,isString:s,isNonEmptyString:u,isURL:c,isEmail:o,isAlphabetic:f,isNumericString:p,startsWithUppercase:l,endsWithPunctuation:g,containsWhitespace:m,isCamelCase:h,isPascalCase:z,isKebabCase:d,isSnakeCase:$,isUpperCase:C,isLowerCase:A};export{t as capitalize,m as containsWhitespace,N as default,g as endsWithPunctuation,f as isAlphabetic,h as isCamelCase,o as isEmail,d as isKebabCase,A as isLowerCase,u as isNonEmptyString,p as isNumericString,z as isPascalCase,$ as isSnakeCase,s as isString,c as isURL,C as isUpperCase,n as padLeft,e as padRight,i as repeatString,l as startsWithUppercase,a as trim,r as truncate};

package/dist/validate-BKQ-HFTd.js

@@ -0,0 +1 @@
+"use strict";function r(r){return null!=r}exports.isArray=function(n){return r(n)&&Array.isArray(n)},exports.isDefined=r,exports.isUndefinedOrNull=function(r){return null==r};

package/dist/validate-D9J7otjc.js

@@ -0,0 +1 @@
+function n(n){return null!=n}function r(n){return null==n}function u(r){return n(r)&&Array.isArray(r)}export{n as a,r as b,u as i};

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "js-utils-kit",
   "displayName": "JS Utils Kit",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Essential JavaScript helpers",
   "license": "MIT",
   "private": false,
-  "repository": "https://github.com/TenEplaysOfficial/js-utils-kit",
+  "repository": "https://github.com/teneplaysofficial/js-utils-kit",
   "bugs": {
-    "url": "https://github.com/TenEplaysOfficial/js-utils-kit/issues"
+    "url": "https://github.com/teneplaysofficial/js-utils-kit/issues"
   },
   "author": {
     "name": "Sriman",
@@ -52,6 +52,11 @@
       "require": "./dist/index.cjs",
       "types": "./dist/index.d.ts"
     },
+    "./array": {
+      "import": "./dist/array/index.js",
+      "require": "./dist/array/index.cjs",
+      "types": "./dist/array/index.d.ts"
+    },
     "./char": {
       "import": "./dist/char/index.js",
       "require": "./dist/char/index.cjs",
@@ -110,8 +115,8 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.29.0",
-    "@eslint/json": "^0.12.0",
-    "@eslint/markdown": "^6.6.0",
+    "@eslint/json": "^0.13.0",
+    "@eslint/markdown": "^7.0.0",
     "@release-it/conventional-changelog": "^10.0.1",
     "@rollup/plugin-commonjs": "^28.0.6",
     "@rollup/plugin-node-resolve": "^16.0.1",