@rtorcato/js-common 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [1.8.0](https://github.com/rtorcato/js-common/compare/v1.7.1...v1.8.0) (2026-05-29)
+
+
+### Features
+
+* **docs:** Astro Starlight site on GitHub Pages ([5139f6d](https://github.com/rtorcato/js-common/commit/5139f6d0d6652e54b3e6daa5ed77dcd67d7e59dc))
+
+## [1.7.1](https://github.com/rtorcato/js-common/compare/v1.7.0...v1.7.1) (2026-05-29)
+
+
+### Bug Fixes
+
+* **deps:** migrate to short-uuid v6 and inquirer v13 ([#38](https://github.com/rtorcato/js-common/issues/38)) ([cceae68](https://github.com/rtorcato/js-common/commit/cceae68f08a8e88e0511879b800516046ed27a88))
+* resolve bugs, remove duplicates, and add missing utilities ([43dfc85](https://github.com/rtorcato/js-common/commit/43dfc850e105490279cdca746b53be1dbbfe6355))
+
 # [1.7.0](https://github.com/rtorcato/js-common/compare/v1.6.0...v1.7.0) (2026-01-16)
 
 

package/README.md

@@ -1,13 +1,18 @@
 # js-common
 
+![js-common banner](./banner.png)
+
 [![npm version](https://badge.fury.io/js/%40rtorcato%2Fjs-common.svg)](https://badge.fury.io/js/%40rtorcato%2Fjs-common)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 [![Bundle Size](https://img.shields.io/badge/Bundle%20Size-277%20bytes-green.svg)](https://bundlejs.com/?q=@rtorcato/js-common)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
+[![Docs](https://img.shields.io/badge/docs-rtorcato.github.io%2Fjs--common-blue.svg)](https://rtorcato.github.io/js-common/)
 
 A comprehensive set of common JavaScript and TypeScript utilities for Node.js projects.
 
+📘 **Documentation:** <https://rtorcato.github.io/js-common/>
+
 ## ✨ Features
 
 - 🚀 **Ultra-lightweight** - Only 277 bytes main bundle
@@ -15,7 +20,7 @@ A comprehensive set of common JavaScript and TypeScript utilities for Node.js pr
 - 🔧 **TypeScript** - Full type safety and IntelliSense
 - 🖥️ **CLI included** - Use utilities from command line
 - 📚 **Modular** - Import individual modules
-- ⚡ **Zero dependencies** - Core library has no external deps
+- ⚡ **Utility modules have no dependencies** - CLI features use optional packages isolated to the `cli` subpath
 - 🧪 **Well tested** - Comprehensive test coverage
 
 ## Installation
@@ -176,7 +181,7 @@ js-common: 277 bytes (full) / ~50-200 bytes (individual modules)
 ### 🛠️ **Modern Development**
 - Built with **TypeScript** for excellent DX
 - **ESM-first** with CommonJS compatibility
-- **Zero dependencies** in core library
+- **No dependencies in utility modules** — CLI packages (chalk, commander, etc.) are isolated to the `cli` subpath
 - Comprehensive **test coverage**
 
 ## Development
@@ -204,6 +209,20 @@ pnpm run check:fix
 pnpm run typecheck
 ```
 
+## Documentation site
+
+The full documentation site lives in [`apps/doc`](./apps/doc) and is built with [Astro Starlight](https://starlight.astro.build/). It auto-deploys to GitHub Pages on every push to `main` that touches `apps/doc/**`.
+
+```bash
+# Run the docs locally (http://localhost:4321/js-common)
+pnpm --filter @rtorcato/js-common-docs dev
+
+# Build the static site
+pnpm --filter @rtorcato/js-common-docs build
+```
+
+Live site: <https://rtorcato.github.io/js-common/>
+
 ## Contributing
 
 Contributions are welcome! Please read [CONTRIBUTORS.md](./CONTRIBUTORS.md) for guidelines.

package/dist/arrays/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function o(t){return t[0]}function u(t){return t.length?t[t.length-1]:void 0}function T(t){return Array.from(new Set(t))}function f(t){return t.flat()}function i(t,n){if(n<1)throw new Error("Chunk size must be at least 1");let e=[];for(let r=0;r<t.length;r+=n)e.push(t.slice(r,r+n));return e}function l(t){return t.filter(Boolean)}function c(t){let n=t.slice();for(let e=n.length-1;e>0;e--){let r=Math.floor(Math.random()*(e+1));[n[e],n[r]]=[n[r],n[e]]}return n}export{i as chunk,l as compact,o as first,f as flatten,u as last,c as shuffle,T as unique};
+import"../chunks/chunk-ANN5UYCF.js";function o(n){return n[0]}function T(n){return n.length?n[n.length-1]:void 0}function f(n){return Array.from(new Set(n))}function i(n){return n.flat()}function l(n,e){if(e<1)throw new Error("Chunk size must be at least 1");let t=[];for(let r=0;r<n.length;r+=e)t.push(n.slice(r,r+e));return t}function s(n){return n.filter(Boolean)}function c(n){let e=n.slice();for(let t=e.length-1;t>0;t--){let r=Math.floor(Math.random()*(t+1));[e[t],e[r]]=[e[r],e[t]]}return e}function h(n,e){return n.reduce((t,r)=>{let u=e(r);return t[u]||(t[u]=[]),t[u].push(r),t},{})}export{l as chunk,s as compact,o as first,i as flatten,h as groupBy,T as last,c as shuffle,f as unique};

package/dist/cli/index.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
+import { Separator, checkbox, select } from '@inquirer/prompts';
 import chalk from 'chalk';
 import chalkAnimation from 'chalk-animation';
 import { program } from 'commander';
 import figlet from 'figlet';
 import gradient from 'gradient-string';
-import inquirer from 'inquirer';
 import { readFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -114,25 +114,20 @@ program
     try {
         // Main interactive loop
         while (true) {
-            const { category } = await inquirer.prompt([
-                {
-                    type: 'list',
-                    name: 'category',
-                    message: chalk.cyan('What would you like to do?'),
-                    choices: Object.entries(functionCategories)
-                        .reduce((acc, [key, cat], index) => {
-                        acc.push({ name: cat.name, value: key });
-                        // Add separator after each item except the last one
-                        if (index < Object.entries(functionCategories).length - 1) {
-                            acc.push(new inquirer.Separator(' '));
-                        }
-                        return acc;
-                    }, [])
-                        .concat([new inquirer.Separator(' '), { name: chalk.red('❌ Exit'), value: 'exit' }]),
-                    pageSize: 17, // Show more items to accommodate separators and exit option
-                    loop: false, // Don't loop at the end
-                },
-            ]);
+            const category = await select({
+                message: chalk.cyan('What would you like to do?'),
+                choices: Object.entries(functionCategories)
+                    .reduce((acc, [key, cat], index) => {
+                    acc.push({ name: cat.name, value: key });
+                    if (index < Object.entries(functionCategories).length - 1) {
+                        acc.push(new Separator(' '));
+                    }
+                    return acc;
+                }, [])
+                    .concat([new Separator(' '), { name: chalk.red('❌ Exit'), value: 'exit' }]),
+                pageSize: 17,
+                loop: false,
+            });
             // Handle exit selection
             if (category === 'exit') {
                 console.log(chalk.yellow('\n👋 Goodbye!\n'));
@@ -141,29 +136,24 @@ program
             const selectedCategory = functionCategories[category];
             // Function selection loop
             while (true) {
-                const { functionName } = await inquirer.prompt([
-                    {
-                        type: 'list',
-                        name: 'functionName',
-                        message: chalk.cyan(`Choose a ${selectedCategory.name} function:`),
-                        choices: selectedCategory.functions
-                            .reduce((acc, func, index) => {
-                            acc.push({ name: `${func.name} - ${func.description}`, value: func.name });
-                            // Add separator after each item except the last one
-                            if (index < selectedCategory.functions.length - 1) {
-                                acc.push(new inquirer.Separator(' '));
-                            }
-                            return acc;
-                        }, [])
-                            .concat([
-                            new inquirer.Separator(' '),
-                            { name: chalk.gray('⬅️  Back to categories'), value: 'back' },
-                            { name: chalk.red('❌ Exit'), value: 'exit' },
-                        ]),
-                        pageSize: 12, // Show more items to accommodate back/exit options
-                        loop: false, // Don't loop at the end
-                    },
-                ]);
+                const functionName = await select({
+                    message: chalk.cyan(`Choose a ${selectedCategory.name} function:`),
+                    choices: selectedCategory.functions
+                        .reduce((acc, func, index) => {
+                        acc.push({ name: `${func.name} - ${func.description}`, value: func.name });
+                        if (index < selectedCategory.functions.length - 1) {
+                            acc.push(new Separator(' '));
+                        }
+                        return acc;
+                    }, [])
+                        .concat([
+                        new Separator(' '),
+                        { name: chalk.gray('⬅️  Back to categories'), value: 'back' },
+                        { name: chalk.red('❌ Exit'), value: 'exit' },
+                    ]),
+                    pageSize: 12,
+                    loop: false,
+                });
                 // Handle navigation options
                 if (functionName === 'exit') {
                     console.log(chalk.yellow('\n👋 Goodbye!\n'));
@@ -199,45 +189,36 @@ program
     // Welcome message
     console.log(gradient.pastel('\n🔧 Function Integration Helper\n'));
     try {
-        const { category } = await inquirer.prompt([
-            {
-                type: 'list',
-                name: 'category',
-                message: chalk.cyan('Which category of utilities do you need?'),
-                choices: Object.entries(functionCategories)
-                    .reduce((acc, [key, cat], index) => {
-                    acc.push({ name: cat.name, value: key });
-                    // Add separator after each item except the last one
-                    if (index < Object.entries(functionCategories).length - 1) {
-                        acc.push(new inquirer.Separator(' '));
-                    }
-                    return acc;
-                }, [])
-                    .concat([new inquirer.Separator(' '), { name: chalk.red('❌ Exit'), value: 'exit' }]),
-                pageSize: 17, // Show more items to accommodate separators and exit option
-                loop: false, // Don't loop at the end
-            },
-        ]);
+        const category = await select({
+            message: chalk.cyan('Which category of utilities do you need?'),
+            choices: Object.entries(functionCategories)
+                .reduce((acc, [key, cat], index) => {
+                acc.push({ name: cat.name, value: key });
+                if (index < Object.entries(functionCategories).length - 1) {
+                    acc.push(new Separator(' '));
+                }
+                return acc;
+            }, [])
+                .concat([new Separator(' '), { name: chalk.red('❌ Exit'), value: 'exit' }]),
+            pageSize: 17,
+            loop: false,
+        });
         // Handle exit selection
         if (category === 'exit') {
             console.log(chalk.yellow('\n👋 Goodbye!\n'));
             return;
         }
         const selectedCategory = functionCategories[category];
-        const { functions } = await inquirer.prompt([
-            {
-                type: 'checkbox',
-                name: 'functions',
-                message: chalk.cyan(`Select ${selectedCategory.name} functions to add:`),
-                choices: selectedCategory.functions.map((func) => ({
-                    name: `${func.name} - ${func.description}`,
-                    value: func.name,
-                    checked: false,
-                })),
-                pageSize: 10, // Show more items at once
-                loop: false, // Don't loop at the end
-            },
-        ]);
+        const functions = await checkbox({
+            message: chalk.cyan(`Select ${selectedCategory.name} functions to add:`),
+            choices: selectedCategory.functions.map((func) => ({
+                name: `${func.name} - ${func.description}`,
+                value: func.name,
+                checked: false,
+            })),
+            pageSize: 10,
+            loop: false,
+        });
         if (functions.length === 0) {
             console.log(chalk.yellow('\n📝 No functions selected. Exiting...\n'));
             return;

package/dist/formatting/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function e(t,r=2){return String(t).padStart(r,"0")}function i(t){return t?t[0]?.toUpperCase()+t.slice(1):""}function u(t){return t.replace(/\w\S*/g,r=>(r[0]?.toUpperCase()??"")+r.slice(1).toLowerCase())}function g(t,r="en-US"){return t.toLocaleString(r)}function s(t,r=0){return`${(t*100).toFixed(r)}%`}function n(t){return`${t.getFullYear()}-${e(t.getMonth()+1)}-${e(t.getDate())}`}function o(t){return`${e(t.getHours())}:${e(t.getMinutes())}:${e(t.getSeconds())}`}function a(t){return`${n(t)} ${o(t)}`}export{i as capitalize,n as formatDate,a as formatDateTime,g as formatNumber,s as formatPercent,o as formatTime,e as padZero,u as toTitleCase};
+import"../chunks/chunk-ANN5UYCF.js";function n(t,r=2){return String(t).padStart(r,"0")}function i(t,r="en-US"){return t.toLocaleString(r)}function u(t,r=0){return`${(t*100).toFixed(r)}%`}function e(t){return`${t.getFullYear()}-${n(t.getMonth()+1)}-${n(t.getDate())}`}function o(t){return`${n(t.getHours())}:${n(t.getMinutes())}:${n(t.getSeconds())}`}function g(t){return`${e(t)} ${o(t)}`}export{e as formatDate,g as formatDateTime,i as formatNumber,u as formatPercent,o as formatTime,n as padZero};

package/dist/i18n/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function i(n="en"){return typeof process<"u"&&navigator.language?navigator.language.split("-")[0]||n:process?.env.LANG&&(process.env.LANG??"en").split("_")[0]||n}function o(n,t,r){return new Intl.NumberFormat(t,r).format(n)}function s(n,t,r){return new Intl.DateTimeFormat(t,r).format(n)}function g(n,t,r){let e=r||i();return t[e]?.[n]||t.en?.[n]||n}function u(n,t){return t===1?n:`${n}s`}export{i as detectLanguage,s as formatDateI18n,o as formatNumber,u as pluralize,g as t};
+import"../chunks/chunk-ANN5UYCF.js";function i(n="en"){return typeof navigator<"u"&&navigator.language?navigator.language.split("-")[0]||n:typeof process<"u"&&process.env.LANG&&(process.env.LANG??"en").split("_")[0]||n}function o(n,t,r){return new Intl.NumberFormat(t,r).format(n)}function s(n,t,r){return new Intl.DateTimeFormat(t,r).format(n)}function a(n,t,r){let e=r||i();return t[e]?.[n]||t.en?.[n]||n}function g(n,t){return t===1?n:`${n}s`}export{i as detectLanguage,s as formatDateI18n,o as formatNumber,g as pluralize,a as t};

package/dist/index.js

@@ -1 +1 @@
-import"./chunks/chunk-ANN5UYCF.js";var o=()=>(console.log("test"),"testPackage"),t=e=>{console.log(`hello ${e??"world"}`)};export{t as helloWorld,o as testPackage};
+import"./chunks/chunk-ANN5UYCF.js";var t=()=>(console.log("test"),"testPackage");export{t as testPackage};

package/dist/math/index.js

@@ -1 +1 @@
-import{a as o,b as t}from"../chunks/chunk-DCFILRIS.js";import"../chunks/chunk-ANN5UYCF.js";var e=(r,m)=>r+m;export{o as add,t as subtract,e as sum};
+import{a as d,b as t,c as i,d as r}from"../chunks/chunk-DCFILRIS.js";import"../chunks/chunk-ANN5UYCF.js";export{d as add,r as divide,i as multiply,t as subtract};

package/dist/numbers/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function o(n,r){return Math.floor(Math.random()*(r-n+1))+n}function m(n,r,e){return Math.max(r,Math.min(e,n))}function b(n,r=2){let e=10**r;return Math.round(n*e)/e}function i(n){return typeof n=="number"&&Number.isFinite(n)}function c(n,r){return Math.random()*(r-n)+n}function f(n){return typeof n=="number"&&Number.isInteger(n)}function a(n,r,e,t=!0){return t?n>=r&&n<=e:n>r&&n<e}function u(n){return n.reduce((r,e)=>r+e,0)}function p(n){return n.length===0?0:u(n)/n.length}function x(n,r){return(n%r+r)%r}export{p as average,a as between,m as clamp,c as getRandomFloat,o as getRandomInt,i as isFiniteNumber,f as isInteger,x as mod,b as roundTo,u as sum};
+import"../chunks/chunk-ANN5UYCF.js";function o(n,r){return Math.floor(Math.random()*(r-n+1))+n}function m(n,r,e){return Math.max(r,Math.min(e,n))}function b(n,r=2){let e=10**r;return Math.round(n*e)/e}function i(n){return typeof n=="number"&&Number.isFinite(n)}function a(n,r){return Math.random()*(r-n)+n}function c(n){return typeof n=="number"&&Number.isInteger(n)}function f(n,r,e,t=!0){return t?n>=r&&n<=e:n>r&&n<e}function u(n){return n.reduce((r,e)=>r+e,0)}function p(n){return n.length===0?0:u(n)/n.length}function x(n,r){return(n%r+r)%r}function h(n){return Math.min(...n)}function d(n){return Math.max(...n)}export{p as average,f as between,m as clamp,a as getRandomFloat,o as getRandomInt,i as isFiniteNumber,c as isInteger,d as max,h as min,x as mod,b as roundTo,u as sum};

package/dist/{obects → objects}/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function r(n){return Object.prototype.toString.call(n)==="[object Object]"}function s(n,o){let t={...n};for(let e in o)r(o[e])&&r(t[e])?t[e]=s(t[e],o[e]):t[e]=o[e];return t}function c(n,o){let t={...n};for(let e of o)delete t[e];return t}function i(n,o){let t={};for(let e of o)e in n&&(t[e]=n[e]);return t}function a(n){return JSON.parse(JSON.stringify(n))}export{a as deepClone,s as deepMerge,r as isPlainObject,c as omit,i as pick};
+import"../chunks/chunk-ANN5UYCF.js";function r(n){return Object.prototype.toString.call(n)==="[object Object]"}function s(n,o){let t={...n};for(let e in o)r(o[e])&&r(t[e])?t[e]=s(t[e],o[e]):t[e]=o[e];return t}function c(n,o){let t={...n};for(let e of o)delete t[e];return t}function i(n,o){let t={};for(let e of o)e in n&&(t[e]=n[e]);return t}function T(n){return structuredClone(n)}export{T as deepClone,s as deepMerge,r as isPlainObject,c as omit,i as pick};

package/dist/uuid/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";import i from"short-uuid";import{NIL as n,parse as e,stringify as U,validate as r,version as s,v4 as a,v7 as g}from"uuid";var o=i(),p=()=>a(),D=()=>g(),c=()=>o.new(),x=t=>o.fromUUID(t),d=t=>o.toUUID(t),l=t=>r(t),v=t=>r(t)&&s(t)===4,f=t=>t===n,m=t=>{if(!r(t))throw new Error("Invalid UUID");return s(t)},y=()=>n,b=t=>e(t),h=t=>U(t);export{h as bytesToUUID,d as fromShortUUID,y as getNilUUID,c as getShortUUID,p as getUUID,m as getUUIDVersion,D as getUUIDv7,f as isNilUUID,l as isUUID,v as isUUIDv4,x as toShortUUID,b as uuidToBytes};
+import"../chunks/chunk-ANN5UYCF.js";import{createTranslator as e}from"short-uuid";import{NIL as n,parse as i,stringify as U,validate as r,version as s,v4 as a,v7 as g}from"uuid";var o=e(),p=()=>a(),D=()=>g(),c=()=>o.generate(),x=t=>o.fromUUID(t),l=t=>o.toUUID(t),v=t=>r(t),d=t=>r(t)&&s(t)===4,f=t=>t===n,m=t=>{if(!r(t))throw new Error("Invalid UUID");return s(t)},y=()=>n,b=t=>i(t),h=t=>U(t);export{h as bytesToUUID,l as fromShortUUID,y as getNilUUID,c as getShortUUID,p as getUUID,m as getUUIDVersion,D as getUUIDv7,f as isNilUUID,v as isUUID,d as isUUIDv4,x as toShortUUID,b as uuidToBytes};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rtorcato/js-common",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "JavaScript and TypeScript common code",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
   "scripts": {
     "build-dev": "rimraf ./dist && cross-env NODE_ENV=development node build.mjs && tsc --emitDeclarationOnly --project tsconfig.build.json && npm run build-cli",
     "build-prod": "rimraf ./dist && cross-env NODE_ENV=production node build.mjs && tsc --emitDeclarationOnly --project tsconfig.build.json && npm run build-cli",
-    "build-cli": "tsc src/cli/cli.ts --outDir dist/cli --target ES2022 --module ES2022 --moduleResolution bundler --allowImportingTsExtensions false --esModuleInterop --skipLibCheck && mv dist/cli/cli.js dist/cli/temp.mjs && echo '#!/usr/bin/env node' > dist/cli/index.mjs && cat dist/cli/temp.mjs >> dist/cli/index.mjs && rm dist/cli/temp.mjs && chmod +x dist/cli/index.mjs",
+    "build-cli": "tsc src/cli/cli.ts --ignoreConfig --types node --outDir dist/cli --target ES2022 --module ES2022 --moduleResolution bundler --allowImportingTsExtensions false --esModuleInterop --skipLibCheck && mv dist/cli/cli.js dist/cli/temp.mjs && echo '#!/usr/bin/env node' > dist/cli/index.mjs && cat dist/cli/temp.mjs >> dist/cli/index.mjs && rm dist/cli/temp.mjs && chmod +x dist/cli/index.mjs",
     "prepublishOnly": "npm run build-prod",
     "==================== Common ====================": "",
     "lint": "pnpm exec biome lint .",
@@ -254,16 +254,18 @@
     "@types/node": "^24.9.1",
     "@vitest/coverage-istanbul": "^4.0.17",
     "cross-env": "^10.1.0",
-    "esbuild": "^0.25.11",
+    "esbuild": "^0.27.4",
     "husky": "^9.1.7",
-    "jsdom": "^26.1.0",
+    "jsdom": "^29.0.1",
+    "knip": "^6.14.2",
     "lint-staged": "^16.2.6",
     "rimraf": "^6.0.1",
     "semantic-release": "^25.0.1",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.2",
     "vitest": "^4.0.17"
   },
   "dependencies": {
+    "@inquirer/prompts": "^8.5.0",
     "chalk": "^5.6.2",
     "chalk-animation": "^2.0.3",
     "commander": "^14.0.1",
@@ -271,11 +273,11 @@
     "date-fns-tz": "^3.2.0",
     "figlet": "^1.9.3",
     "gradient-string": "^3.0.0",
-    "inquirer": "^12.10.0",
+    "inquirer": "^13.3.2",
     "luxon": "^3.7.2",
     "nanospinner": "^1.2.2",
     "pino": "^10.1.0",
-    "short-uuid": "^5.2.0",
+    "short-uuid": "^6.0.3",
     "uuid": "^13.0.0",
     "zod": "^4.1.12"
   },
@@ -298,5 +300,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
   }
 }