@rzl-zone/utils-js 0.0.1 → 2.0.0

package/dist/types/index.d.ts

@@ -2017,7 +2017,78 @@ type ChangeTypeOfValuesArray<Arr,Target,NewType>=Arr extends object ?{[K in keyo
  * const fn: AnyFunction = (a, b) => a + b;
  * console.log(fn(1, 2)); // 3
  */
-type AnyFunction=(...args:any[])=>any;type Enumerate<N extends number,Acc extends number[]=[]>=Acc["length"] extends N ? Acc[number]:Enumerate<N,[...Acc,Acc["length"]]>;
+type AnyFunction=(...args:any[])=>any;
+/** --------------------------------------------------
+ * * ***Represents all JavaScript TypedArray types used for binary data manipulation.***
+ * --------------------------------------------------
+ *
+ * Includes all standard built-in typed arrays like:
+ * - `Int8Array`
+ * - `Uint8Array`
+ * - `Uint8ClampedArray`
+ * - `Int16Array`
+ * - `Uint16Array`
+ * - `Int32Array`
+ * - `Uint32Array`
+ * - `Float32Array`
+ * - `Float64Array`
+ * - `BigInt64Array`
+ * - `BigUint64Array`
+ */
+type TypedArray=Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | BigInt64Array | BigUint64Array;
+/** --------------------------------------------------
+ * * ***Represents common Web API object types available in the browser environment.***
+ * --------------------------------------------------
+ *
+ * Includes:
+ * - URL handling: `URL`, `URLSearchParams`
+ * - Networking: `Request`, `Response`, `Headers`, `WebSocket`
+ * - Streams: `ReadableStream`, `WritableStream`, `TransformStream`
+ * - Events and messaging: `Event`, `CustomEvent`, `MessageChannel`, `MessagePort`, `MessageEvent`
+ * - DOM-related: `HTMLElement`, `Node`, `Document`, `Window`, `CanvasRenderingContext2D`
+ * - Encoding and decoding: `TextEncoder`, `TextDecoder`
+ * - File-related: `File`, `FileList`, `ImageBitmap`, `FormData`
+ * - Abort handling: `AbortController`, `AbortSignal`
+ * - Cryptography: `CryptoKey`
+ */
+type WebApiObjects=URL | URLSearchParams | FormData | Headers | Response | Request | ReadableStream<any>| WritableStream<any>| TransformStream<any,any>| MessageChannel | MessagePort | MessageEvent | Event | CustomEvent | HTMLElement | Node | Document | Window | AbortController | AbortSignal | TextEncoder | TextDecoder | CryptoKey | File | FileList | ImageBitmap | CanvasRenderingContext2D | WebSocket;
+/** --------------------------------------------------
+ * * ***Represents all ECMAScript Internationalization API objects from the `Intl` namespace.***
+ * --------------------------------------------------
+ *
+ * Includes:
+ * - `Intl.Collator`
+ * - `Intl.DateTimeFormat`
+ * - `Intl.NumberFormat`
+ * - `Intl.RelativeTimeFormat`
+ * - `Intl.PluralRules`
+ * - `Intl.ListFormat`
+ * - `Intl.Locale`
+ */
+type IntlObjects=Intl.Collator | Intl.DateTimeFormat | Intl.NumberFormat | Intl.RelativeTimeFormat | Intl.PluralRules | Intl.ListFormat | Intl.Locale;
+/** --------------------------------------------------
+ * * ***Represents Node.js built-in core objects.***
+ * --------------------------------------------------
+ *
+ * Currently includes:
+ * - `Buffer`
+ */
+type NodeBuiltins=Buffer;
+/** --------------------------------------------------
+ * * ***Represents all known non-plain object types that are excluded
+ * from being considered as a "plain object" (i.e., `{ [key: string]: any }`).***
+ * --------------------------------------------------
+ *
+ * Includes:
+ * - Functions
+ * - Arrays
+ * - Native objects like: `Date`, `RegExp`, `Map`, `Set`, `WeakMap`, `WeakSet`
+ * - Built-in classes and browser APIs: `Promise`, `Error`, `ArrayBuffer`, `DataView`
+ * - `TypedArray`, `WebApiObjects`, `IntlObjects`, and `NodeBuiltins`
+ * - Symbols
+ * - Proxies and the `Reflect` object
+ */
+type NonPlainObject=AnyFunction | Array<any>| Date | RegExp | Map<any,any>| Set<any>| WeakMap<any,any>| WeakSet<any>| Error | Promise<any>| ArrayBuffer | DataView | TypedArray | WebApiObjects | IntlObjects | NodeBuiltins | symbol |{[Symbol.toStringTag]:"Proxy";}| typeof Reflect;type Enumerate<N extends number,Acc extends number[]=[]>=Acc["length"] extends N ? Acc[number]:Enumerate<N,[...Acc,Acc["length"]]>;
 /** --------------------------------------------------
  * * ***Generate a union type of numbers within a specific range from `1` to `999`.***
  * --------------------------------------------------
@@ -2054,4 +2125,4 @@ type RangeNumberTo999<From extends number,To extends number>=From extends To ? F
  * // => 5 | 6 | 7 | 8
  * ```
  */
-type RangeNumberLimit<From extends number,To extends number,Result extends number[]=[From]>=IsGreaterThan<From,To>extends true ? [...Result,To][number] extends infer R extends number ? R extends R ? IsGreaterThan<R,To>extends true ? never:R:never:never:RangeNumberLimit<Sum<From,7>,To,[...Result,From,Sum<From,1>,Sum<From,2>,Sum<From,3>,Sum<From,4>,Sum<From,5>,Sum<From,6>]>;export type{Abs,And,AndArr,AnifyProperties,AnifyPropertiesOptions,AnyFunction,AreAnagrams,ArgumentTypes,ArrayElementType,Ceil,ChangeTypeOfValuesArray,Color,ColorCssValidBase,ColorOptions,CompareNumberLength,CompareStringLength,Concat,CustomPromise,DataTypes,Decrement,DefaultColorOptions,DefaultHSLOptions,DefaultRGBOptions,DigitsTuple,Div,Dot,EmptyArray,EmptyString,EndsWith,Even,ExcludeStrict,Extends,ExtendsArr,Factorial,Fibonacci,FirstCharacter,FirstCharacterOptions,FirstDigit,Float,Floor,GetArrayElementType,GetFloatNumberParts,HEX,HSL,HSLOptions,Identity,If,IfAny,IfColor,IfEmptyArray,IfEmptyString,IfEqual,IfEven,IfExtends,IfFloat,IfGreaterOrEqual,IfGreaterThan,IfHEX,IfHSL,IfInteger,IfLowerThan,IfNegative,IfNegativeFloat,IfNegativeInteger,IfNever,IfNonEmptyArray,IfNonEmptyString,IfNot,IfNotEqual,IfNotExtends,IfOdd,IfPositive,IfPositiveFloat,IfPositiveInteger,IfRGB,IfUnknown,Includes,Increment,IndexOf,Integer,IsAny,IsArray,IsArrayIndex,IsBetween,IsColor,IsDivisible,IsDivisibleByFive,IsDivisibleByHundred,IsDivisibleBySix,IsDivisibleByTen,IsDivisibleByThree,IsDivisibleByTwo,IsEmptyArray,IsEmptyString,IsEqual,IsEven,IsFloat,IsGreaterOrEqual,IsGreaterThan,IsHEX,IsHSL,IsInteger,IsLetter,IsLongerNumber,IsLongerString,IsLowerThan,IsMutableArray,IsNegative,IsNegativeFloat,IsNegativeInteger,IsNever,IsNonEmptyArray,IsNonEmptyString,IsNotEqual,IsOdd,IsPalindrome,IsPositive,IsPositiveFloat,IsPositiveInteger,IsRGB,IsReadonlyArray,IsSameLengthNumber,IsSameLengthString,IsShorterNumber,IsShorterString,IsStringLiteral,IsTuple,IsUnion,IsUnknown,Join,LastCharacter,LastCharacterOptions,Max,MaxArr,Min,MinArr,Mod,Mult,Mutable,MutableExcept,MutableOnly,Negate,Negative,NegativeFloat,NegativeInteger,NeverifyProperties,NeverifyPropertiesOptions,NonEmptyArray,NonEmptyString,NonNullableObject,NonNullableObjectExcept,NonNullableObjectOnly,Not,NotExtends,NumberLength,ObjArrayKeyStringAny,Odd,OmitStrict,Or,OrArr,OverrideTypes,ParseNumber,PartialExcept,PartialKeys,PartialOnly,PathToFields,PathToFieldsOptions,PickStrict,Pop,PopOptions,Positive,PositiveFloat,PositiveInteger,Pow,Prettify,PrettifyOld,PrettifyOptions,Push,RGB,RGBOptions,RangeNumberLimit,RangeNumberTo999,ReadonlyExcept,ReadonlyOnly,RemoveIndexSignature,RemoveLeading,Repeat,Replace,ReplaceAll,ReplaceAllOld,ReplacingToPartial,ReplacingToRequired,RequiredExcept,RequiredKeys,RequiredOnly,ReturnItselfIfExtends,ReturnItselfIfNotExtends,Reverse,Round,Shift,ShiftOptions,Slice,Sort,Split,StartsWith,StringLength,Stringify,Sub,Sum,SumArr,Swap,Switch,ToPrimitive,Trim,TrimLeft,TrimRight,TrimsLower,Trunc,TupleToObject,UnionToIntersection,UnknownifyProperties,UnknownifyPropertiesOptions,Unshift,ValueOf,ValueOfArray,ValueOfExcept,ValueOfOnly,Whitespace};
+type RangeNumberLimit<From extends number,To extends number,Result extends number[]=[From]>=IsGreaterThan<From,To>extends true ? [...Result,To][number] extends infer R extends number ? R extends R ? IsGreaterThan<R,To>extends true ? never:R:never:never:RangeNumberLimit<Sum<From,7>,To,[...Result,From,Sum<From,1>,Sum<From,2>,Sum<From,3>,Sum<From,4>,Sum<From,5>,Sum<From,6>]>;export type{Abs,And,AndArr,AnifyProperties,AnifyPropertiesOptions,AnyFunction,AreAnagrams,ArgumentTypes,ArrayElementType,Ceil,ChangeTypeOfValuesArray,Color,ColorCssValidBase,ColorOptions,CompareNumberLength,CompareStringLength,Concat,CustomPromise,DataTypes,Decrement,DefaultColorOptions,DefaultHSLOptions,DefaultRGBOptions,DigitsTuple,Div,Dot,EmptyArray,EmptyString,EndsWith,Even,ExcludeStrict,Extends,ExtendsArr,Factorial,Fibonacci,FirstCharacter,FirstCharacterOptions,FirstDigit,Float,Floor,GetArrayElementType,GetFloatNumberParts,HEX,HSL,HSLOptions,Identity,If,IfAny,IfColor,IfEmptyArray,IfEmptyString,IfEqual,IfEven,IfExtends,IfFloat,IfGreaterOrEqual,IfGreaterThan,IfHEX,IfHSL,IfInteger,IfLowerThan,IfNegative,IfNegativeFloat,IfNegativeInteger,IfNever,IfNonEmptyArray,IfNonEmptyString,IfNot,IfNotEqual,IfNotExtends,IfOdd,IfPositive,IfPositiveFloat,IfPositiveInteger,IfRGB,IfUnknown,Includes,Increment,IndexOf,Integer,IntlObjects,IsAny,IsArray,IsArrayIndex,IsBetween,IsColor,IsDivisible,IsDivisibleByFive,IsDivisibleByHundred,IsDivisibleBySix,IsDivisibleByTen,IsDivisibleByThree,IsDivisibleByTwo,IsEmptyArray,IsEmptyString,IsEqual,IsEven,IsFloat,IsGreaterOrEqual,IsGreaterThan,IsHEX,IsHSL,IsInteger,IsLetter,IsLongerNumber,IsLongerString,IsLowerThan,IsMutableArray,IsNegative,IsNegativeFloat,IsNegativeInteger,IsNever,IsNonEmptyArray,IsNonEmptyString,IsNotEqual,IsOdd,IsPalindrome,IsPositive,IsPositiveFloat,IsPositiveInteger,IsRGB,IsReadonlyArray,IsSameLengthNumber,IsSameLengthString,IsShorterNumber,IsShorterString,IsStringLiteral,IsTuple,IsUnion,IsUnknown,Join,LastCharacter,LastCharacterOptions,Max,MaxArr,Min,MinArr,Mod,Mult,Mutable,MutableExcept,MutableOnly,Negate,Negative,NegativeFloat,NegativeInteger,NeverifyProperties,NeverifyPropertiesOptions,NodeBuiltins,NonEmptyArray,NonEmptyString,NonNullableObject,NonNullableObjectExcept,NonNullableObjectOnly,NonPlainObject,Not,NotExtends,NumberLength,ObjArrayKeyStringAny,Odd,OmitStrict,Or,OrArr,OverrideTypes,ParseNumber,PartialExcept,PartialKeys,PartialOnly,PathToFields,PathToFieldsOptions,PickStrict,Pop,PopOptions,Positive,PositiveFloat,PositiveInteger,Pow,Prettify,PrettifyOld,PrettifyOptions,Push,RGB,RGBOptions,RangeNumberLimit,RangeNumberTo999,ReadonlyExcept,ReadonlyOnly,RemoveIndexSignature,RemoveLeading,Repeat,Replace,ReplaceAll,ReplaceAllOld,ReplacingToPartial,ReplacingToRequired,RequiredExcept,RequiredKeys,RequiredOnly,ReturnItselfIfExtends,ReturnItselfIfNotExtends,Reverse,Round,Shift,ShiftOptions,Slice,Sort,Split,StartsWith,StringLength,Stringify,Sub,Sum,SumArr,Swap,Switch,ToPrimitive,Trim,TrimLeft,TrimRight,TrimsLower,Trunc,TupleToObject,TypedArray,UnionToIntersection,UnknownifyProperties,UnknownifyPropertiesOptions,Unshift,ValueOf,ValueOfArray,ValueOfExcept,ValueOfOnly,WebApiObjects,Whitespace};

package/package.json

@@ -1,16 +1,28 @@
 {
+  "name": "@rzl-zone/utils-js",
+  "version": "2.0.0",
+  "type": "module",
+  "sideEffects": false,
+  "engineStrict": true,
+  "license": "MIT",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "unpkg": "./dist/rzl-utils.global.js",
+  "jsdelivr": "./dist/rzl-utils.global.js",
+  "author": "Rizalvin Dwiky <rizalvindwiky1998@gmail.com>",
+  "homepage": "https://github.com/rzl-zone/utils-js#readme",
+  "description": "A modern, lightweight set of JavaScript utility functions for everyday development, crafted to enhance code readability and maintainability.",
   "contributors": [
     "Rizalvin Dwiky <rizalvindwiky1998@gmail.com>"
   ],
   "bugs": {
     "url": "https://github.com/rzl-zone/utils-js/issues"
   },
-  "author": "Rizalvin Dwiky <rizalvindwiky1998@gmail.com>",
   "dependencies": {
     "date-fns": "^4.1.0",
     "server-only": "^0.0.1"
   },
-  "description": "A modern, lightweight set of JavaScript utility functions for everyday development, crafted to enhance code readability and maintainability.",
   "devDependencies": {
     "@eslint/js": "^9.31.0",
     "@rollup/plugin-typescript": "^12.1.4",
@@ -36,7 +48,6 @@
     "typescript-eslint": "^8.37.0",
     "vitest": "^3.2.4"
   },
-  "engineStrict": true,
   "engines": {
     "node": ">=16"
   },
@@ -75,13 +86,24 @@
       "types": "./dist/types/index.d.ts"
     }
   },
+  "typesVersions": {
+    "*": {
+      "next": [
+        "dist/next/index.d.ts"
+      ],
+      "next/server": [
+        "dist/next/server/index.d.ts"
+      ],
+      "types": [
+        "dist/types/index.d.ts"
+      ]
+    }
+  },
   "files": [
     "dist",
     "README.md",
     "LICENSE.md"
   ],
-  "homepage": "https://github.com/rzl-zone/utils-js#readme",
-  "jsdelivr": "./dist/rzl-utils.global.js",
   "keywords": [
     "javascript",
     "typescript",
@@ -97,10 +119,6 @@
     "helper",
     "functions"
   ],
-  "license": "MIT",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "name": "@rzl-zone/utils-js",
   "publishConfig": {
     "access": "public"
   },
@@ -126,23 +144,5 @@
     "postbuild": "del-cli \"dist/**/*.d.cts\"",
     "prepare": "npm run build",
     "release-patch": "npm version patch && git push && git push --tags && npm publish"
-  },
-  "sideEffects": false,
-  "type": "module",
-  "types": "./dist/index.d.ts",
-  "typesVersions": {
-    "*": {
-      "next": [
-        "dist/next/index.d.ts"
-      ],
-      "next/server": [
-        "dist/next/server/index.d.ts"
-      ],
-      "types": [
-        "dist/types/index.d.ts"
-      ]
-    }
-  },
-  "unpkg": "./dist/rzl-utils.global.js",
-  "version": "0.0.1"
+  }
 }