@rzl-zone/utils-js 3.3.0 → 3.4.0

package/README.md

@@ -3,10 +3,10 @@
 </div>
 
 <p align="center">
-🚀 <strong>Rzl Utility JS</strong> 🚀<br/>
-A lightweight, modern TypeScript utility library for Node.js & browser (via bundlers like Webpack/Vite).<br/>
-Provides reusable helpers to simplify your JavaScript or TypeScript projects.<br/>
-<strong>Built with ❤️ by <a href="https://github.com/rzl-app" target="_blank" rel="nofollow noreferrer noopener">@rzl-app</a>.</strong>
+🚀 <strong><u>Rzl Utility JS</u></strong> 🚀<br/>
+<i>A lightweight, modern TypeScript utility library for Node.js & browser (via bundlers like Webpack/Vite).</i><br/>
+<i>Provides reusable helpers to simplify your JavaScript or TypeScript projects.</i><br/>
+<strong><i>Built with ❤️ by <a href="https://github.com/rzl-app" target="_blank" rel="nofollow noreferrer noopener">@rzl-app</a>.</i></strong>
 </p>
 
 <div align="center">
@@ -39,13 +39,15 @@ Provides reusable helpers to simplify your JavaScript or TypeScript projects.<br
 
 ---
  
-<h2 id="table-of-contents">📚 Table of Contents</h2>
+<h2 id="table-of-contents">📚 <strong>Table of Contents</strong></h2>
 
 - 💻 [Requirements](#requirements)
 - ⚙️ [Installation](#installation)
 - ✨ [Features](#features)
 - 🧬 [NextJS Support](#nextjs-support)
 - 💎 [Detailed Features](#detailed-features)
+  - [Full documentation](#full-documentation-rzl-utilsjs-is-currently-under-construction-%EF%B8%8F)
+  - [Hint Autocomplete](#hint-autocomplete)
 - 🔥 [Usage](#usage)
 - ❤️ [Sponsor](#sponsor-this-package)
 - 📜 [Changelog](#changelog)
@@ -56,35 +58,35 @@ Provides reusable helpers to simplify your JavaScript or TypeScript projects.<br
 
 ---
 
-<h2 id="requirements">💻 Requirements</h2>
+<h2 id="requirements">💻 <strong>Requirements</strong></h2>
 
 - **Node.js `≥16.0.0`**  
   This package leverages modern JavaScript & TypeScript features that require Node.js version 16.0.0 if not using Next.js, and for Next.js it must follow the official minimum Node.js version requirement depending on the version you use.  
   - 🔗 See official Next.js documentation: 
-      <a href="https://nextjs.org/docs/getting-started/installation#system-requirements" target="_blank" rel="nofollow noreferrer noopener">NextJS Installation Requirements</a>
+      <a href="https://nextjs.org/docs/getting-started/installation#system-requirements" target="_blank" rel="nofollow noreferrer noopener"><i>NextJS Installation Requirements.</i></a>
 
-- Works with:
+- **Works with:**
   - ✅ Node.js (16.0.0+) - Without NextJS
   - ✅ Node.js (18.17.0, or higher depending on NextJS version) - With NextJS
   - ✅ Modern browsers (via bundlers like Webpack / Vite)
 
 ---
 
-<h2 id="installation">⚙️ Installation</h2>
+<h2 id="installation">⚙️ <strong>Installation</strong></h2>
 
-#### With NPM
+#### *With NPM*
 
 ```bash
   npm install @rzl-zone/utils-js
 ```
 
-#### With Yarn
+#### *With Yarn*
 
 ```bash
   yarn add @rzl-zone/utils-js
 ```
 
-#### With PNPM
+#### *With PNPM*
 
 ```bash
   pnpm add @rzl-zone/utils-js
@@ -92,20 +94,20 @@ Provides reusable helpers to simplify your JavaScript or TypeScript projects.<br
 
 ---
 
-<h2 id="features">✨ Features</h2>
+<h2 id="features">✨ <strong>Features</strong></h2>
 
 - 🚀 Written in **TypeScript** — fully typed & safe
 - ⚡ Small, tree-shakable & fast
 - 📦 Works in **Node.js** & modern browsers
 - ❤️ Simple API, easy to extend
 - 🧬 **Next.js support**: helpers for dynamic routes, building URLs, reading env, extracting client IP
-- 🛠 Additional TypeScript types: `OmitStrict`, `PartialOnly`, etc.
+- 🛠 Additional including TypeScript package **`@rzl-zone/ts-types-plus`** types: `OmitStrict`, `PartialOnly`, etc.
 
 ---
 
-<h2 id="nextjs-support">🧬 Next.js Support</h2>
+<h2 id="nextjs-support">🧬 <strong>Next.js Support</strong></h2>
 
-This package also provides utilities specially built for Next.js environments, neatly separated into their own entry points:
+**This package also provides utilities specially built for Next.js environments, neatly separated into their own entry points:**
 
 - <h3 id="nextjs-support--globals">`@rzl-zone/utils-js/next`</h3>  
   Helpers for building URLs, generating dynamic routes, reading environment variables, etc.   
@@ -125,9 +127,9 @@ This package also provides utilities specially built for Next.js environments, n
 
 ---
 
-<h2 id="detailed-features">💎 Detailed Features</h2>
+<h2 id="detailed-features">💎 <strong>Detailed Features</strong></h2>
 
-  ### Full documentation <a href="https://docs-rzl-utils-js.vercel.app" target="_blank" rel="nofollow noreferrer noopener">Rzl UtilsJS</a> is **currently under construction** 🏗️.
+  ### **Full documentation <a href="https://docs-rzl-utils-js.vercel.app" target="_blank" rel="nofollow noreferrer noopener">Rzl UtilsJS</a> is **currently under construction** 🏗️.**
   #### For now, explore the examples or dive into the source — all utilities are documented via **TSDoc** and typed properly.
   
   ```ts
@@ -146,9 +148,40 @@ This package also provides utilities specially built for Next.js environments, n
   import { | } from "@rzl-zone/utils-js/tailwind";
   import { | } from "@rzl-zone/utils-js/urls";
 
-  import type { | } from "@rzl-zone/utils-js/types";
+  import type { | } from "@rzl-zone/ts-types-plus";
   ```
-  #### Just place your cursor right inside `{ }` or after import from `"@rzl-zone/utils-js/{{ | }}"` like the pipe ("|") above then ctrl + space, there are many functions or types and then hover to each function is complete with how to use it because I have added tsDoc.
+  #### Place your cursor inside { } or after "@rzl-zone/utils-js/{{ | }}" then press Ctrl+Space to see all available functions/types with full TSDoc hints.
+  ---
+  ### **Hint: Autocomplete**
+
+  **To get the best autocomplete hints for folders and files, add the `types` field in your configuration file:**
+
+  #### # **_TypeScript_**:
+  Add this to your `tsconfig.json`:
+  ```jsonc
+  // tsconfig.json
+  {
+    "compilerOptions": {
+      "types": [
+        "@rzl-zone/utils-js"
+      ]
+    }
+  }
+
+  ```
+  #### # **_JavaScript_:**
+  Add this to your `jsconfig.json`:
+  ```jsonc
+  // jsconfig.json
+  {
+    "compilerOptions": {
+      "types": [
+        "@rzl-zone/utils-js"
+      ]
+    }
+  }
+  ```
+  >ℹ️ ***Tip:*** *For JS projects, consider adding "checkJs": true for better IntelliSense.*
 
   <!-- - <h4 id="detailed-features--assertions">
       Assertions - 
@@ -173,11 +206,11 @@ This package also provides utilities specially built for Next.js environments, n
        -->
 ---
 
-<h2 id="usage">🔥 Usage</h2>
+<h2 id="usage">🔥 <strong>Usage</strong></h2>
 
-### Easy to use, just import on your code base.
+### **Easy to use, just import on your code base.**
 
-#### Example Function Import:
+#### *Example Function Import:*
 
 ```ts
 import { isServer } from "@rzl-zone/utils-js/predicates";
@@ -186,10 +219,10 @@ console.log(isServer());
 // ➔ `true` if running on server-side, `false` if in browser.
 ```
 
-#### Example Types Helper Import:
+#### *Example Types Helper Import:*
 
 ```ts
-import type { OmitStrict } from "@rzl-zone/utils-js/types";
+import type { OmitStrict } from "@rzl-zone/ts-types-plus";
 
 type MyType = OmitStrict<OtherType, "omittingProps">;
 // Fully strict TS omit that requires all keys to exist in target
@@ -197,46 +230,46 @@ type MyType = OmitStrict<OtherType, "omittingProps">;
 
 ---
 
-<h2 id="sponsor-this-package">❤️ Sponsor this package</h2>
+<h2 id="sponsor-this-package">❤️ <strong>Sponsor this package</strong></h2>
 
-Help support development:  
-[👉 Become a sponsor](https://github.com/sponsors/rzl-app)
+**Help support development:**    
+*[👉 Become a sponsor](https://github.com/sponsors/rzl-app)*
 
 ---
 
-<h2 id="changelog">📝 Changelog</h2>
+<h2 id="changelog">📝 <strong>Changelog</strong></h2>
 
-See [CHANGELOG](CHANGELOG.md).
+**See [CHANGELOG](CHANGELOG.md).**
 
 ---
 
-<h2 id="contributing">🤝 Contributing</h2>
+<h2 id="contributing">🤝 <strong>Contributing</strong></h2>
 
-See [CONTRIBUTING](CONTRIBUTING.md).
+**See [CONTRIBUTING](CONTRIBUTING.md).**
 
 ---
 
-<h2 id="security">🔒 Security</h2>
+<h2 id="security">🔒 <strong>Security</strong></h2>
 
-Please report issues to [rizalvindwiky1998@gmail.com](mailto:rizalvindwiky1998@gmail.com).
+**Please report issues to [rizalvindwiky1998@gmail.com](mailto:rizalvindwiky1998@gmail.com).**
 
 ---
 
-<h2 id="credits">🙌 Credits</h2>
+<h2 id="credits">🙌 <strong>Credits</strong></h2>
 
-- [Rzl App](https://github.com/rzl-app)
-- [All Contributors](../../contributors)
+**- [Rzl App](https://github.com/rzl-app)**  
+**- [All Contributors](../../contributors)**
 
 ---
 
-<h2 id="license">📜 License</h2>
+<h2 id="license">📜 <strong>License</strong></h2>
 
-The MIT License (MIT).  
-Please see [License File](LICENSE.md) for more information.
+**The MIT License (MIT).**    
+*Please see **[License File](LICENSE.md)** for more information.*
 
 ---
 
 ✅ **Enjoy using `@rzl-zone/utils-js`?**  
-Star this repo ⭐ and share it with other JavaScript developers!
+*Star this repo [⭐](https://github.com/rzl-zone/utils-js) and share it with other JavaScript developers!*
 
 ---

package/dist/assertions/index.d.ts

@@ -1,4 +1,4 @@
-import{P as Prettify}from'../prettify-3o8_Kw6b.js';import{P as PickStrict}from'../pick-BSMX6Xe2.js';import{G as GetPreciseTypeOptions,I as IsNumberOptions,a as IsPlainObjectResult}from'../isPlainObject-DGJkcFYw.js';import'../if-ChM35c_q.js';import'../never-D89PbPh5.js';
+import{Prettify,PickStrict}from'@rzl-zone/ts-types-plus';import{G as GetPreciseTypeOptions,I as IsNumberOptions,a as IsPlainObjectResult}from'../isPlainObject-CEPWPiXh.js';
 /** -------------------------------------------------------
  * * ***Shape of the object passed to custom error message functions.***
  * -------------------------------------------------------

package/dist/conversions/index.d.ts

@@ -1,4 +1,4 @@
-import{h as Nullish,a as KeepNull,b as KeepUndef}from'../nils-CO8zLHSB.js';import{A as AnyFunction,P as Prettify,T as TypedArray,W as WebApiObjects,j as IntlObjects}from'../prettify-3o8_Kw6b.js';import{N as NormalizeEmptyArraysRecursive,R as RemoveEmptyArrayElements,F as FixNeverArrayRecursive}from'../arrays-normalize-recursive-BqmVuFlD.js';import{I as IsAny}from'../any-v4TsK9ES.js';import{i as IfNotExtends,I as IfExtends,E as Extends}from'../extends-DtdRjDyU.js';import{N as NumberRangeUnion}from'../NumberRangeUnion-B6bhM2s7.js';import{O as OrArr,a as AndArr}from'../or-C6qzKt2I.js';import'../if-ChM35c_q.js';import'../never-D89PbPh5.js';type NormalizeInputToNumberArrayUnRecursive<T>=T extends string|bigint|boolean|number|Nullish?T:HasNonNumberLikeNonNullish<T>;
+import{Nullish,KeepNull,KeepUndef,AnyFunction,NormalizeEmptyArraysRecursive,RemoveEmptyArrayElements,FixNeverArrayRecursive,IfNotExtends,IfExtends,IsAny,NumberRangeUnion,Prettify,OrArr,Extends,AndArr,TypedArray,WebApiObjects,IntlObjects}from'@rzl-zone/ts-types-plus';type NormalizeInputToNumberArrayUnRecursive<T>=T extends string|bigint|boolean|number|Nullish?T:HasNonNumberLikeNonNullish<T>;
 /** Detects whether `T` contains any number-like type (`string | number | bigint`).
  *
  * @template T Input type.

package/dist/formatters/index.d.ts

@@ -1,4 +1,4 @@
-import{NumberFormat,CountryCode}from'libphonenumber-js';import{a as OverrideTypes,E as ExtractStrict,O as OmitStrict}from'../override-CL2olHE5.js';import{P as Prettify}from'../prettify-3o8_Kw6b.js';import{FormatOptions,Locale}from'date-fns';import{A as AnyString}from'../string-B1jlOnws.js';import'../if-ChM35c_q.js';import'../never-D89PbPh5.js';type NegativeFormatOptionCustom={
+import{NumberFormat,CountryCode}from'libphonenumber-js';import{OverrideTypes,ExtractStrict,Prettify,OmitStrict,AnyString}from'@rzl-zone/ts-types-plus';import{FormatOptions,Locale}from'date-fns';type NegativeFormatOptionCustom={
 /** Custom formatter function for the final formatted negative string.
  *  If provided, it ***OVERRIDES*** style & space entirely. */
 custom:(formatted:string)=>string;style?:never;space?:never;};type NegativeFormatOptionUnCustom={custom?:never;

package/dist/generators/index.d.ts

@@ -1,4 +1,4 @@
-import{f as IfNonEmptyArray,E as Extends}from'../extends-DtdRjDyU.js';import{F as FixNeverArrayRecursive}from'../arrays-normalize-recursive-BqmVuFlD.js';import{g as NullToUndefined}from'../nils-CO8zLHSB.js';import'../if-ChM35c_q.js';import'../never-D89PbPh5.js';
+import{NullToUndefined,FixNeverArrayRecursive,IfNonEmptyArray,Extends}from'@rzl-zone/ts-types-plus';
 /** ---------------------------------
  * * ***Utility: `getRandomItem`.***
  * ---------------------------------

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 /// <reference path="./urls/index.d.ts" />
-/// <reference path="./types/index.d.ts" />
 /// <reference path="./tailwind/index.d.ts" />
 /// <reference path="./strings/index.d.ts" />
 /// <reference path="./promises/index.d.ts" />

package/dist/{isPlainObject-DGJkcFYw.d.ts → isPlainObject-CEPWPiXh.d.ts}

@@ -1,4 +1,4 @@
-import{N as NonPlainObject}from'./prettify-3o8_Kw6b.js';
+import{NonPlainObject}from'@rzl-zone/ts-types-plus';
 /** ---------------------------------------------------------------------------
  * * ***Type Options for {@link getPreciseType | `getPreciseType`}.***
  * ---------------------------------------------------------------------------

package/dist/next/index.d.ts

@@ -1,4 +1,4 @@
-import{I as IsAny}from'../any-v4TsK9ES.js';import'../if-ChM35c_q.js';
+import{IsAny}from'@rzl-zone/ts-types-plus';
 /** ---------------------------------------------------------
  * * ***Extracts dynamic route parameters from a given route string.***
  * ---------------------------------------------------------

package/dist/operations/index.d.ts

@@ -1,4 +1,4 @@
-import{N as NumberRangeUnion}from'../NumberRangeUnion-B6bhM2s7.js';
+import{NumberRangeUnion}from'@rzl-zone/ts-types-plus';
 /** ----------------------------------------------------------------------
  * * ***Utility: `findDuplicates`.***
  * ----------------------------------------------------------------------

package/dist/predicates/index.d.ts

@@ -1,4 +1,4 @@
-import{h as IsPositive,P as ParseNumber,I as IsStringLiteral,C as CharAt,c as IsUnknown,j as IsReadonlyArray,l as IsArray}from'../is-array-BJeHxPM3.js';import{A as AnyString,a as IsEmptyString,T as Trim}from'../string-B1jlOnws.js';import{I as IsAny}from'../any-v4TsK9ES.js';import{P as Prettify,A as AnyFunction,g as AnObjectNonArray,T as TypedArray}from'../prettify-3o8_Kw6b.js';import{E as Extends}from'../extends-DtdRjDyU.js';import{N as NumberRangeUnion}from'../NumberRangeUnion-B6bhM2s7.js';import{a as IsPlainObjectResult}from'../isPlainObject-DGJkcFYw.js';export{G as GetPreciseTypeOptions,I as IsNumberOptions,g as getPreciseType,i as isNumber,b as isPlainObject}from'../isPlainObject-DGJkcFYw.js';import{I as IsNever}from'../never-D89PbPh5.js';import{O as OrArr}from'../or-C6qzKt2I.js';import'../if-ChM35c_q.js';
+import{NumberRangeUnion,Prettify,IsPositive,ParseNumber,Extends,IsStringLiteral,CharAt,AnyString,AnyFunction,IsEmptyString,Trim,IsAny,IsUnknown,IsNever,IsReadonlyArray,IsArray,AnObjectNonArray,OrArr,TypedArray}from'@rzl-zone/ts-types-plus';import{a as IsPlainObjectResult}from'../isPlainObject-CEPWPiXh.js';export{G as GetPreciseTypeOptions,I as IsNumberOptions,g as getPreciseType,i as isNumber,b as isPlainObject}from'../isPlainObject-CEPWPiXh.js';
 /** ----------------------------------------------------------
  * * ***Predicate: `areArraysEqual`.***
  * ----------------------------------------------------------

package/dist/promises/index.d.ts

@@ -1,4 +1,4 @@
-import{C as CustomPromiseType}from'../promises-LU7K00H0.js';
+import{CustomPromiseType}from'@rzl-zone/ts-types-plus';
 /** -------------------------------------------------------------
  * * ***Utility Class: `CustomPromise`.***
  * -------------------------------------------------------------

package/dist/strings/index.d.ts

@@ -1,4 +1,4 @@
-import{c as Nilable}from'../nils-CO8zLHSB.js';import{E as Extends}from'../extends-DtdRjDyU.js';import'../if-ChM35c_q.js';import'../never-D89PbPh5.js';type CapitalizeFirstOptions={
+import{Nilable,Extends}from'@rzl-zone/ts-types-plus';type CapitalizeFirstOptions={
 /** If true **(default)**, the rest of the string will be converted to lowercase after capitalizing the first letter.
  *
  * @default true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rzl-zone/utils-js",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "type": "module",
   "sideEffects": false,
   "engineStrict": true,
@@ -18,6 +18,7 @@
     "url": "https://github.com/rzl-zone/utils-js/issues"
   },
   "dependencies": {
+    "@rzl-zone/ts-types-plus": "latest",
     "date-fns": "^4.1.0",
     "libphonenumber-js": "^1.12.17",
     "server-only": "^0.0.1",
@@ -201,9 +202,6 @@
         "types": "./dist/urls/index.d.ts",
         "default": "./dist/urls/index.cjs"
       }
-    },
-    "./types": {
-      "types": "./dist/types/index.d.ts"
     }
   },
   "typesVersions": {
@@ -252,9 +250,6 @@
       ],
       "urls": [
         "dist/urls/index.d.ts"
-      ],
-      "types": [
-        "dist/types/index.d.ts"
       ]
     }
   },

package/dist/NumberRangeUnion-B6bhM2s7.d.ts

@@ -1,33 +0,0 @@
-/** --------------------------------------------------
- * * ***Internal Utility Type for: {@link NumberRangeUnion | `NumberRangeUnion`}.***
- * --------------------------------------------------
- * @template N - Starting/Ending number of the range (inclusive).
- * @template Acc - Internal accumulator for recursion (do not set manually).
- */
-type Enumerate<N extends number,Acc extends number[]=[]>=Acc["length"] extends N?Acc[number]:Enumerate<N,[...Acc,Acc["length"]]>;
-/** --------------------------------------------------
- * * ***Utility Type: `NumberRangeUnion`.***
- * --------------------------------------------------
- * **Generate a union type of numbers from `From` to `To` using enumeration.**
- * @description
- * Produces a **numeric union type** from `From` to `To` (inclusive),
- * using a simpler approach based on `Enumerate<N>` helper type.
- * - ✅ Straightforward & easy to reason about.
- * - ⚠️ Still limited by TypeScript recursion depth (safe up to `999`).
- * - ⚙️ Best used for **smaller ranges** (`≤ 100`) or when readability matters.
- * - ℹ️ For **larger ranges** (`≥ 101`) use {@link NumberRangeLimit | `NumberRangeLimit`} instead.
- * @template From - Starting number of the range (inclusive).
- * @template To - Ending number of the range (inclusive).
- * @example
- * ```ts
- * type RangeA = NumberRangeUnion<3, 6>;
- * // ➔ 3 | 4 | 5 | 6
- * type RangeB = NumberRangeUnion<0, 2>;
- * // ➔ 0 | 1 | 2
- * type RangeC = NumberRangeUnion<8, 8>;
- * // ➔ 8
- * type RangeD = NumberRangeUnion<20, 10>;
- * // ➔ 10
- * ```
- */
-type NumberRangeUnion<From extends number,To extends number>=From extends To?From:Exclude<Enumerate<To>,Enumerate<From>>extends never?To:Exclude<Enumerate<To>,Enumerate<From>>|To;export type{NumberRangeUnion as N};

package/dist/any-v4TsK9ES.d.ts

@@ -1,66 +0,0 @@
-import{I as If}from'./if-ChM35c_q.js';
-/** -------------------------------------------------------
- * * ***Utility Type: `IsAny`.***
- * -------------------------------------------------------
- * **A type-level utility that checks whether a type is ***`any`***.**
- * - **Behavior:**
- *    - Returns `true` if `T` is `any`.
- *    - Returns `false` for otherwise.
- * @template T - The type to evaluate.
- * @example
- * ```ts
- * type A = IsAny<any>;     // ➔ true
- * type B = IsAny<string>;  // ➔ false
- * type C = IsAny<unknown>; // ➔ false
- * type D = IsAny<never>;   // ➔ false
- * ```
- */
-type IsAny<T>=0 extends 1 & T?true:false;
-/** -------------------------------------------------------
- * * ***Utility Type: `IfAny`.***
- * -------------------------------------------------------
- * **A type-level conditional utility that returns one type if ***`T` is `any`***,
- * and another type otherwise.**
- * - **Behavior:**
- *    - Defaults to `true` when `T` is `any`.
- *    - Defaults to `false` for otherwise.
- * @template T - The type to check.
- * @template IfTrue - The type to return if `T` is `any`, *(default: `true`)*.
- * @template IfFalse - The type to return if `T` is not `any`, *(default: `false`)*.
- * @example
- * ```ts
- * type A = IfAny<any, string, number>;
- * // ➔ string
- * type B = IfAny<string, string, number>;
- * // ➔ number
- * ```
- */
-type IfAny<T,IfTrue=true,IfFalse=false>=If<IsAny<T>,IfTrue,IfFalse>;
-/** * ***Configuration options for a type-level utility for
- * {@link AnifyProperties | `AnifyProperties`}.***
- */
-type AnifyPropertiesOptions={
-/** If `makeOptional: true`, all properties become optional, otherwise, all properties are required and typed as `any`, defaultValue: `false`.
- *
- * @default false
- */
-makeOptional:boolean;};
-/** -------------------------------------------------------
- * * ***Utility Type: `AnifyProperties`.***
- * -------------------------------------------------------
- * **A type-level utility that transforms all properties of an object
- * into ***`any`***.**
- * - **Behavior:**
- *    - If `makeOptional: true`, all properties become optional.
- *    - Otherwise, all properties are required and typed as `any`.
- * @template T The object type to transform.
- * @template Options Configuration options, defaults to `{ makeOptional: false }`.
- * @example
- * ```ts
- * type A = AnifyProperties<{a: string; b: number}>;
- * // ➔ { a: any; b: any }
- * type B = AnifyProperties<{a: string; b: number}, { makeOptional: true }>;
- * // ➔ { a?: any; b?: any }
- * ```
- */
-type AnifyProperties<T extends object,Options extends AnifyPropertiesOptions={makeOptional:false;}>={[K in keyof T]:any;}extends infer Result?If<Options["makeOptional"],Partial<Result>,Result>:never;export type{AnifyProperties as A,IsAny as I,AnifyPropertiesOptions as a,IfAny as b};

package/dist/arrays-normalize-recursive-BqmVuFlD.d.ts

@@ -1,72 +0,0 @@
-/** -------------------------------------------------------
- * * ***Utility Type: `FixNeverArrayRecursive`.***
- * -------------------------------------------------------
- * **A type-level utility that **recursively transforms arrays of type `never[]` into empty arrays**.**
- * - **Behavior:**
- *    - Preserves `readonly` modifiers.
- *    - Applies recursively for nested arrays.
- *    - Leaves other types unchanged.
- * @template T - The input type to recursively fix.
- * @example
- * ```ts
- * type A = FixNeverArrayRecursive<never[]>;
- * // ➔ []
- * type B = FixNeverArrayRecursive<readonly never[]>;
- * // ➔ readonly []
- * type C = FixNeverArrayRecursive<string[]>;
- * // ➔ string[]
- * type D = FixNeverArrayRecursive<(never | string)[]>;
- * // ➔ (never | string)[]
- * type E = FixNeverArrayRecursive<(never[])[]>;
- * // ➔ [][]
- * ```
- */
-type FixNeverArrayRecursive<T>=T extends readonly never[]?T extends never[]?[]:readonly []:T extends(infer U)[]?FixNeverArrayRecursive<U>[]:T extends readonly(infer U)[]?readonly FixNeverArrayRecursive<U>[]:T;
-/** -------------------------------------------------------
- * * ***Utility Type: `NormalizeEmptyArraysRecursive`.***
- * -------------------------------------------------------
- * **A type-level utility that **recursively normalizes empty array types** by converting arrays whose element type is `never`, `null`, or `undefined` into empty tuple types (`[]`).**
- * - **Behavior:**
- *    - Preserves `readonly` modifiers.
- *    - Recurses into nested arrays.
- *    - Leaves other array types unchanged.
- * @template T - The input type to normalize.
- * @example
- * ```ts
- * type A = NormalizeEmptyArraysRecursive<never[]>;
- * // ➔ []
- * type B = NormalizeEmptyArraysRecursive<readonly never[]>;
- * // ➔ readonly []
- * type C = NormalizeEmptyArraysRecursive<null[]>;
- * // ➔ []
- * type D = NormalizeEmptyArraysRecursive<(null[] | string[])[]>;
- * // ➔ ([] | string[])[]
- * type E = NormalizeEmptyArraysRecursive<string[]>;
- * // ➔ string[]
- * ```
- */
-type NormalizeEmptyArraysRecursive<T>=T extends readonly(infer U)[]?U extends never|null|undefined?T extends readonly unknown[]?T extends(infer E)[]?[]:readonly []:never:T extends(infer E)[]?NormalizeEmptyArraysRecursive<U>[]:readonly NormalizeEmptyArraysRecursive<U>[]:T;
-/** -------------------------------------------------------
- * * ***Utility Type: `RemoveEmptyArrayElements`.***
- * -------------------------------------------------------
- * **A type-level utility that **recursively removes empty array elements (`[]`) from a tuple type**.**
- * - **Behavior:**
- *    - If `T` is a tuple, checks the first element:
- *        - If `Head` is an empty array type (`[]`), it is removed.
- *        - Otherwise, `Head` is preserved.
- *    - Repeats recursively on the rest of the tuple.
- *    - Leaves non-tuple types unchanged.
- * @template T - The tuple type to process.
- * @example
- * ```ts
- * type A = RemoveEmptyArrayElements<[[], 1, [], 2]>;
- * // ➔ [1, 2]
- * type B = RemoveEmptyArrayElements<[]>;
- * // ➔ []
- * type C = RemoveEmptyArrayElements<[[], [], []]>;
- * // ➔ []
- * type D = RemoveEmptyArrayElements<[1, 2, 3]>;
- * // ➔ [1, 2, 3]
- * ```
- */
-type RemoveEmptyArrayElements<T>=T extends [infer Head,...infer Tail]?Head extends []?RemoveEmptyArrayElements<Tail>:[Head,...RemoveEmptyArrayElements<Tail>]:T extends []?[]:T;export type{FixNeverArrayRecursive as F,NormalizeEmptyArraysRecursive as N,RemoveEmptyArrayElements as R};