@uocdev/yauiselib 1.0.0 → 1.1.0

package/dist/cjs/index.d.ts

@@ -1,2 +1,3 @@
 export { cout } from './cout/cout.js';
 export { coutint } from './cout/coutint.js';
+export { randomInt } from './int/randomint.js';

package/dist/cjs/index.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.coutint = exports.cout = void 0;
+exports.randomInt = exports.coutint = exports.cout = void 0;
 var cout_js_1 = require("./cout/cout.js");
 Object.defineProperty(exports, "cout", { enumerable: true, get: function () { return cout_js_1.cout; } });
 var coutint_js_1 = require("./cout/coutint.js");
 Object.defineProperty(exports, "coutint", { enumerable: true, get: function () { return coutint_js_1.coutint; } });
+var randomint_js_1 = require("./int/randomint.js");
+Object.defineProperty(exports, "randomInt", { enumerable: true, get: function () { return randomint_js_1.randomInt; } });

package/dist/cjs/int/randomint.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate random integer from 1 to max (inclusive)
+ * @param max upper bound (must be >= 1)
+ */
+export declare function randomInt(max: number): number;

package/dist/cjs/int/randomint.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomInt = randomInt;
+/**
+ * Generate random integer from 1 to max (inclusive)
+ * @param max upper bound (must be >= 1)
+ */
+function randomInt(max) {
+    if (!Number.isInteger(max) || max < 1) {
+        throw new RangeError("int must  >= 1");
+    }
+    // Math.random() -> [0, 1)
+    // * max        -> [0, max)
+    // floor + 1    -> [1, max]
+    return Math.floor(Math.random() * max) + 1;
+}

package/dist/esm/index.d.ts

@@ -1,2 +1,3 @@
 export { cout } from './cout/cout.js';
 export { coutint } from './cout/coutint.js';
+export { randomInt } from './int/randomint.js';

package/dist/esm/index.js

@@ -1,2 +1,3 @@
 export { cout } from './cout/cout.js';
 export { coutint } from './cout/coutint.js';
+export { randomInt } from './int/randomint.js';

package/dist/esm/int/randomint.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generate random integer from 1 to max (inclusive)
+ * @param max upper bound (must be >= 1)
+ */
+export declare function randomInt(max: number): number;

package/dist/esm/int/randomint.js

@@ -0,0 +1,13 @@
+/**
+ * Generate random integer from 1 to max (inclusive)
+ * @param max upper bound (must be >= 1)
+ */
+export function randomInt(max) {
+    if (!Number.isInteger(max) || max < 1) {
+        throw new RangeError("int must  >= 1");
+    }
+    // Math.random() -> [0, 1)
+    // * max        -> [0, max)
+    // floor + 1    -> [1, max]
+    return Math.floor(Math.random() * max) + 1;
+}

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@uocdev/yauiselib",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "random package for NPM fun only :3",
   "license": "MIT",
   "author": "Uoc",
   "type": "module",
-
   "keywords": [
     "nodejs",
     "typescript",
@@ -14,23 +13,20 @@
     "playground",
     "random"
   ],
-
-  "main": "./dist/cjs/index.cjs",
+  "main": "./dist/cjs/index.js",
   "types": "./dist/index.d.ts",
-
   "exports": {
     ".": {
       "import": "./dist/esm/index.js",
       "require": "./dist/cjs/index.cjs"
     }
   },
-
-  "files": ["dist"],
-
+  "files": [
+    "dist"
+  ],
   "engines": {
     "node": ">=18"
   },
-
   "scripts": {
     "build:esm": "tsc -p tsconfig.esm.json",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -39,20 +35,16 @@
     "install:dev": "npm install --prefix ./tesyl",
     "test:dev": "node tesyl/index"
   },
-
   "devDependencies": {
     "typescript": "^5.3.3",
     "@types/node": "^25.0.9"
   },
-
   "repository": {
     "type": "git",
     "url": "https://github.com/UocDev/Yauiselib"
   },
-
   "bugs": {
     "url": "https://github.com/UocDev/Yauiselib/issues"
   },
-
   "homepage": "https://github.com/UocDev/Yauiselib#readme"
 }