@rzl-zone/utils-js 3.11.1 → 3.12.1-beta.0

package/package.json

@@ -1,245 +1,254 @@
 {
   "name": "@rzl-zone/utils-js",
-  "version": "3.11.1",
-  "sideEffects": false,
-  "engineStrict": true,
+  "version": "3.12.1-beta.0",
+  "description": "A modern, lightweight set of JavaScript utility functions with TypeScript support for everyday development, crafted to enhance code readability and maintainability.",
   "license": "MIT",
-  "type": "module",
   "unpkg": "./dist/rzl-utils.global.js",
   "jsdelivr": "./dist/rzl-utils.global.js",
-  "types": "./dist/index.d.ts",
   "author": "Rizalvin Dwiky <rizalvindwiky@gmail.com>",
-  "homepage": "https://github.com/rzl-zone/utils-js#readme",
-  "description": "A modern, lightweight set of JavaScript utility functions with TypeScript support for everyday development, crafted to enhance code readability and maintainability.",
   "contributors": [
     "Rizalvin Dwiky <rizalvindwiky@gmail.com>"
   ],
-  "bugs": {
-    "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",
-    "tailwind-merge-v3": "npm:tailwind-merge@2.6.0",
-    "tailwind-merge-v4": "npm:tailwind-merge@3.3.1"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.31.0",
-    "@types/node": "^20.19.11",
-    "@types/rollup": "^0.51.4",
-    "@vitest/coverage-v8": "^3.2.4",
-    "barrelsby": "^2.8.1",
-    "del-cli": "^6.0.0",
-    "dts-bundle-generator": "^9.5.1",
-    "eslint": "^9.31.0",
-    "globals": "^16.3.0",
-    "jsdom": "^26.1.0",
-    "next": "^15.5.3",
-    "tailwindcss": "^4.1.13",
-    "terser": "^5.44.0",
-    "tsc-alias": "^1.8.16",
-    "tsup": "^8.5.0",
-    "tsx": "^4.20.3",
-    "type-fest": "^5.0.1",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.41.0",
-    "vitest": "^3.2.4"
-  },
-  "peerDependencies": {
-    "tailwindcss": "^3.0.0 || ^4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "tailwindcss": {
-      "optional": true
-    }
+  "homepage": "https://github.com/rzl-zone/rzl-zone/tree/main/packages/utils-js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rzl-zone/rzl-zone.git",
+    "directory": "packages/utils-js"
   },
+  "keywords": [
+    "javascript",
+    "typescript",
+    "js",
+    "ts",
+    "util",
+    "utils",
+    "helper",
+    "helpers",
+    "library",
+    "@rzl-zone/utils-js",
+    "rzl",
+    "rzl-zone",
+    "rzl zone",
+    "util js",
+    "util-js",
+    "utils-js",
+    "utils js",
+    "utility",
+    "utility js",
+    "rzl-utils",
+    "rzl utils",
+    "functions"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engineStrict": true,
   "engines": {
     "node": ">=18.18.0"
   },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md",
+    "LICENSE",
+    "!**/*.test.*"
+  ],
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts"
+    "./.references": {
+      "import": {
+        "types": "./dist/.references/index.d.ts"
+      },
+      "require": {
+        "types": "./dist/.references/index.d.cts"
+      }
     },
     "./assertions": {
-      "types": "./dist/assertions/index.d.ts",
-      "import": "./dist/assertions/index.js",
-      "require": "./dist/assertions/index.cjs"
+      "import": {
+        "types": "./dist/assertions/index.d.ts",
+        "default": "./dist/assertions/index.js"
+      },
+      "require": {
+        "types": "./dist/assertions/index.d.cts",
+        "default": "./dist/assertions/index.cjs"
+      }
     },
     "./conversions": {
-      "types": "./dist/conversions/index.d.ts",
-      "import": "./dist/conversions/index.js",
-      "require": "./dist/conversions/index.cjs"
+      "import": {
+        "types": "./dist/conversions/index.d.ts",
+        "default": "./dist/conversions/index.js"
+      },
+      "require": {
+        "types": "./dist/conversions/index.d.cts",
+        "default": "./dist/conversions/index.cjs"
+      }
     },
     "./events": {
-      "types": "./dist/events/index.d.ts",
-      "import": "./dist/events/index.js",
-      "require": "./dist/events/index.cjs"
+      "import": {
+        "types": "./dist/events/index.d.ts",
+        "default": "./dist/events/index.js"
+      },
+      "require": {
+        "types": "./dist/events/index.d.cts",
+        "default": "./dist/events/index.cjs"
+      }
     },
     "./formatters": {
-      "types": "./dist/formatters/index.d.ts",
-      "import": "./dist/formatters/index.js",
-      "require": "./dist/formatters/index.cjs"
+      "import": {
+        "types": "./dist/formatters/index.d.ts",
+        "default": "./dist/formatters/index.js"
+      },
+      "require": {
+        "types": "./dist/formatters/index.d.cts",
+        "default": "./dist/formatters/index.cjs"
+      }
     },
     "./generators": {
-      "types": "./dist/generators/index.d.ts",
-      "import": "./dist/generators/index.js",
-      "require": "./dist/generators/index.cjs"
+      "import": {
+        "types": "./dist/generators/index.d.ts",
+        "default": "./dist/generators/index.js"
+      },
+      "require": {
+        "types": "./dist/generators/index.d.cts",
+        "default": "./dist/generators/index.cjs"
+      }
     },
     "./next": {
-      "types": "./dist/next/index.d.ts",
-      "import": "./dist/next/index.js",
-      "require": "./dist/next/index.cjs"
+      "import": {
+        "types": "./dist/next/index.d.ts",
+        "default": "./dist/next/index.js"
+      },
+      "require": {
+        "types": "./dist/next/index.d.cts",
+        "default": "./dist/next/index.cjs"
+      }
     },
     "./next/server": {
-      "types": "./dist/next/server/index.d.ts",
-      "import": "./dist/next/server/index.js",
-      "require": "./dist/next/server/index.cjs"
+      "import": {
+        "types": "./dist/next/server/index.d.ts",
+        "default": "./dist/next/server/index.js"
+      },
+      "require": {
+        "types": "./dist/next/server/index.d.cts",
+        "default": "./dist/next/server/index.cjs"
+      }
     },
     "./operations": {
-      "types": "./dist/operations/index.d.ts",
-      "import": "./dist/operations/index.js",
-      "require": "./dist/operations/index.cjs"
+      "import": {
+        "types": "./dist/operations/index.d.ts",
+        "default": "./dist/operations/index.js"
+      },
+      "require": {
+        "types": "./dist/operations/index.d.cts",
+        "default": "./dist/operations/index.cjs"
+      }
     },
     "./parsers": {
-      "types": "./dist/parsers/index.d.ts",
-      "import": "./dist/parsers/index.js",
-      "require": "./dist/parsers/index.cjs"
+      "import": {
+        "types": "./dist/parsers/index.d.ts",
+        "default": "./dist/parsers/index.js"
+      },
+      "require": {
+        "types": "./dist/parsers/index.d.cts",
+        "default": "./dist/parsers/index.cjs"
+      }
     },
     "./predicates": {
-      "types": "./dist/predicates/index.d.ts",
-      "import": "./dist/predicates/index.js",
-      "require": "./dist/predicates/index.cjs"
+      "import": {
+        "types": "./dist/predicates/index.d.ts",
+        "default": "./dist/predicates/index.js"
+      },
+      "require": {
+        "types": "./dist/predicates/index.d.cts",
+        "default": "./dist/predicates/index.cjs"
+      }
     },
     "./promises": {
-      "types": "./dist/promises/index.d.ts",
-      "import": "./dist/promises/index.js",
-      "require": "./dist/promises/index.cjs"
+      "import": {
+        "types": "./dist/promises/index.d.ts",
+        "default": "./dist/promises/index.js"
+      },
+      "require": {
+        "types": "./dist/promises/index.d.cts",
+        "default": "./dist/promises/index.cjs"
+      }
     },
     "./strings": {
-      "types": "./dist/strings/index.d.ts",
-      "import": "./dist/strings/index.js",
-      "require": "./dist/strings/index.cjs"
+      "import": {
+        "types": "./dist/strings/index.d.ts",
+        "default": "./dist/strings/index.js"
+      },
+      "require": {
+        "types": "./dist/strings/index.d.cts",
+        "default": "./dist/strings/index.cjs"
+      }
     },
     "./tailwind": {
-      "types": "./dist/tailwind/index.d.ts",
-      "import": "./dist/tailwind/index.js",
-      "require": "./dist/tailwind/index.cjs"
+      "import": {
+        "types": "./dist/tailwind/index.d.ts",
+        "default": "./dist/tailwind/index.js"
+      },
+      "require": {
+        "types": "./dist/tailwind/index.d.cts",
+        "default": "./dist/tailwind/index.cjs"
+      }
     },
     "./urls": {
-      "types": "./dist/urls/index.d.ts",
-      "import": "./dist/urls/index.js",
-      "require": "./dist/urls/index.cjs"
+      "import": {
+        "types": "./dist/urls/index.d.ts",
+        "default": "./dist/urls/index.js"
+      },
+      "require": {
+        "types": "./dist/urls/index.d.cts",
+        "default": "./dist/urls/index.cjs"
+      }
     }
   },
-  "typesVersions": {
-    "*": {
-      ".": [
-        "./dist/index.d.ts"
-      ],
-      "assertions": [
-        "dist/assertions/index.d.ts"
-      ],
-      "conversions": [
-        "dist/conversions/index.d.ts"
-      ],
-      "events": [
-        "dist/events/index.d.ts"
-      ],
-      "formatters": [
-        "dist/formatters/index.d.ts"
-      ],
-      "generators": [
-        "dist/generators/index.d.ts"
-      ],
-      "next": [
-        "dist/next/index.d.ts"
-      ],
-      "next/server": [
-        "dist/next/server/index.d.ts"
-      ],
-      "operations": [
-        "dist/operations/index.d.ts"
-      ],
-      "parsers": [
-        "dist/parsers/index.d.ts"
-      ],
-      "predicates": [
-        "dist/predicates/index.d.ts"
-      ],
-      "promises": [
-        "dist/promises/index.d.ts"
-      ],
-      "strings": [
-        "dist/strings/index.d.ts"
-      ],
-      "tailwind": [
-        "dist/tailwind/index.d.ts"
-      ],
-      "urls": [
-        "dist/urls/index.d.ts"
-      ]
-    }
+  "dependencies": {
+    "date-fns": "^4.1.0",
+    "libphonenumber-js": "^1.13.1",
+    "tailwind-merge-v3": "npm:tailwind-merge@2.6.0",
+    "tailwind-merge-v4": "npm:tailwind-merge@3.3.1",
+    "@rzl-zone/node-only": "0.0.10-beta.0",
+    "@rzl-zone/ts-types-plus": "0.1.6-beta.0"
   },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE.md"
-  ],
-  "keywords": [
-    "javascript",
-    "typescript",
-    "js",
-    "ts",
-    "util",
-    "utils",
-    "helper",
-    "helpers",
-    "library",
-    "@rzl-zone/utils-js",
-    "rzl",
-    "rzl-zone",
-    "rzl zone",
-    "util js",
-    "util-js",
-    "utils-js",
-    "utils js",
-    "utility",
-    "utility js",
-    "rzl-utils",
-    "rzl utils",
-    "functions"
-  ],
-  "publishConfig": {
-    "access": "public"
+  "devDependencies": {
+    "@eslint/js": "^10",
+    "@types/node": "^20.19.11",
+    "@vitest/coverage-v8": "^4.1.6",
+    "barrelsby": "^2.8.1",
+    "eslint": "^10",
+    "globals": "^17.6.0",
+    "jsdom": "^29.1.1",
+    "next": "^15.5.9",
+    "tailwindcss": "^4.3.0",
+    "tsdown": "0.22.0",
+    "tsx": "^4.21.0",
+    "typescript": "6.0.3",
+    "vitest": "^4.1.6",
+    "@rzl-zone/build-tools": "0.0.12-beta.0",
+    "@rzl-zone/eslint": "0.0.10-beta.0",
+    "@workspace/eslint-config": "0.0.0",
+    "@workspace/typescript-config": "0.0.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/rzl-zone/utils-js.git"
+  "peerDependencies": {
+    "tailwindcss": "^3.0.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "tailwindcss": {
+      "optional": true
+    }
   },
   "scripts": {
+    "check-types:package": "tsc --noEmit",
     "barrel:generate": "npx barrelsby --config barrelsby.config.json",
     "barrel:remove-comment-dist": "tsx scripts/removeBarrelsbyComment.ts",
-    "barrel": "npm run barrel:generate && npm run barrel:generate && npm run barrel:remove-comment-dist",
-    "inject:banner": "tsx scripts/injectBanner",
-    "normalize:new-lines": "tsx scripts/normalizeNewLineDistFiles",
-    "clean-dist": "del-cli \"dist/*\"",
-    "clean-dist:types-cts": "del-cli \"dist/**/*.d.{cts,mts}\"",
-    "clean-dist:js-comments": "tsx scripts/cleanDistJsComments.ts",
-    "delete-dist:index-runtime": "del-cli \"dist/index.{js,js.map,cjs,cjs.map}\" \"dist/index.d.{ts,cts,mts,esm}\"",
-    "minify:dts-dist": "echo 'Skip tsx scripts/minifyDtsDist.ts'",
-    "build:types-dts": "dts-bundle-generator --config dts-config.cjs --silent --external-imports next",
-    "generate:reference-index": "tsx scripts/generateReferenceIndex.ts",
-    "postbuild": "",
-    "build": "npm run clean-dist && npm run barrel && tsup && npm run minify:dts-dist && npm run clean-dist:js-comments && npm run normalize:new-lines && npm run clean-dist:types-cts && npm run delete-dist:index-runtime && npm run generate:reference-index && npm run inject:banner",
-    "format": "prettier --check .",
-    "lint": "eslint . --ext .ts,.js",
-    "lint:fix": "eslint . --ext .ts,.js --fix",
-    "prepublishOnly": "npm run build",
-    "tsc:check": "tsc --noEmit",
-    "test": "vitest run",
-    "check-publish": "npm run build && npm pack --dry-run",
-    "release-patch": "npm version patch && git push && git push --tags && npm publish"
+    "barrel": "pnpm run barrel:generate && pnpm run barrel:generate && pnpm run barrel:remove-comment-dist",
+    "build": "pnpm run barrel && tsdown",
+    "lint": "eslint",
+    "test:utils-js": "vitest run",
+    "check-publish": "pnpm run build && pnpm pack --dry-run",
+    "release-patch": "pnpm version patch && git push && git push --tags && pnpm publish"
   }
-}
+}

package/dist/chunk-22V4WP3H.js

@@ -1,53 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-import { isFinite } from './chunk-CCJ2MSN7.js';
-import { isEmptyArray } from './chunk-GOFINGT6.js';
-import { isBigInt } from './chunk-QNKGP5DY.js';
-import { isNil, isArray, assertIsPlainObject, hasOwnProp, assertIsBoolean, isString, isBoolean, isNull } from './chunk-MSUW5VHZ.js';
-
-function filterNilArray(input) {
-  if (isNil(input)) return void 0;
-  if (!isArray(input)) return [];
-  const filtered = input.reduce((output, element) => {
-    if (!isNil(element)) {
-      if (isArray(element)) {
-        const cleanedNested = filterNilArray(element);
-        if (cleanedNested && !isEmptyArray(cleanedNested)) {
-          output.push(cleanedNested);
-        }
-      } else {
-        output.push(element);
-      }
-    }
-    return output;
-  }, []);
-  return filtered;
-}
-
-function toStringArrayUnRecursive(array, options = {}) {
-  assertIsPlainObject(options, {
-    message: ({ currentType, validType }) => `Second parameter (\`options\`) must be of type \`${validType}\`, but received: \`${currentType}\`.`
-  });
-  const riv = hasOwnProp(options, "removeInvalidValue") ? options.removeInvalidValue : true;
-  assertIsBoolean(riv, {
-    message: ({ currentType, validType }) => `Parameter \`removeInvalidValue\` property of the \`options\` (second parameter) must be of type \`${validType}\`, but received: \`${currentType}\`.`
-  });
-  if (isArray(array)) {
-    const result = Array.from(array, (x) => {
-      if (isString(x) || isFinite(x) || isBoolean(x) || isBigInt(x)) return String(x);
-      return isNull(x) ? null : void 0;
-    });
-    if (riv) return filterNilArray(result);
-    return result;
-  }
-  return void 0;
-}
-
-export { filterNilArray, toStringArrayUnRecursive };

package/dist/chunk-2XSZ2ANI.js

@@ -1,63 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-import { isNonEmptyString } from './chunk-MSUW5VHZ.js';
-
-var parseCurrencyString = (input) => {
-  if (!isNonEmptyString(input)) return 0;
-  let trimmed = input.trim().replace(/\u00A0/g, "").replace(/\u202F/g, "");
-  let isNegative = false;
-  if (/^\(.*\)$/.test(trimmed)) {
-    isNegative = true;
-    trimmed = trimmed.slice(1, -1).trim();
-  }
-  trimmed = trimmed.replace(/^[-\s]+/, (match) => match.includes("-") ? "-" : "").replace(/[\s.,-]+$/, "");
-  isNegative = isNegative || /^-/.test(trimmed) || /^[^\d]*-/.test(trimmed);
-  const cleaned = trimmed.replace(/[^0-9.,'\s]/g, "");
-  let cleanedNoSpace = cleaned.replace(/[\s']/g, "");
-  const indianMatches = cleanedNoSpace.match(/,\d{2}/g);
-  const isIndianStyle = indianMatches && indianMatches.length > 1;
-  if (isIndianStyle) {
-    cleanedNoSpace = cleanedNoSpace.replace(/,/g, "");
-  } else {
-    const dotCount = (cleanedNoSpace.match(/\./g) || []).length;
-    const commaCount = (cleanedNoSpace.match(/,/g) || []).length;
-    if (dotCount > 1 && commaCount === 0) {
-      cleanedNoSpace = cleanedNoSpace.replace(/\./g, "");
-    } else if (commaCount > 1 && dotCount === 0) {
-      cleanedNoSpace = cleanedNoSpace.replace(/,/g, "");
-    } else {
-      const lastComma = cleanedNoSpace.lastIndexOf(",");
-      const lastDot = cleanedNoSpace.lastIndexOf(".");
-      if (lastComma > lastDot) {
-        cleanedNoSpace = cleanedNoSpace.replace(/\./g, "").replace(",", ".");
-      } else if (lastDot > lastComma) {
-        cleanedNoSpace = cleanedNoSpace.replace(/,/g, "");
-      } else {
-        if (lastComma > lastDot) {
-          const beforeDecimal = cleanedNoSpace.slice(0, lastComma).replace(/,/g, "").replace(/\./g, "");
-          const afterDecimal = cleanedNoSpace.slice(lastComma + 1);
-          cleanedNoSpace = beforeDecimal + "." + afterDecimal;
-        } else if (lastDot > lastComma) {
-          const beforeDecimal = cleanedNoSpace.slice(0, lastDot).replace(/\./g, "").replace(/,/g, "");
-          const afterDecimal = cleanedNoSpace.slice(lastDot + 1);
-          cleanedNoSpace = beforeDecimal + "." + afterDecimal;
-        } else if (lastComma !== -1) {
-          cleanedNoSpace = cleanedNoSpace.replace(/,/g, "");
-        } else if (lastDot !== -1) {
-          cleanedNoSpace = cleanedNoSpace.replace(/\./g, "");
-        }
-      }
-    }
-  }
-  const num = parseFloat(cleanedNoSpace) || 0;
-  return isNegative ? -num : num;
-};
-
-export { parseCurrencyString };

package/dist/chunk-3T6VSWYX.js

@@ -1,21 +0,0 @@
-/*!
- * ====================================================
- * Rzl Utils-JS.
- * ----------------------------------------------------
- * Version: 3.11.1.
- * Author: Rizalvin Dwiky.
- * Repository: https://github.com/rzl-zone/utils-js.
- * ====================================================
- */
-import { isString, resolveErrorMessageAssertions } from './chunk-MSUW5VHZ.js';
-
-var assertIsString = (value, options = {}) => {
-  if (isString(value)) return;
-  resolveErrorMessageAssertions({
-    value,
-    options,
-    requiredValidType: "string"
-  });
-};
-
-export { assertIsString };