ransyr 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kyusora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# ransyr
+
+![npm version](https://img.shields.io/npm/v/ransyr?color=blue&label=npm%20version) ![license](https://img.shields.io/npm/l/ransyr) ![downloads](https://img.shields.io/npm/dt/ransyr)
+
+Python-like random utilities for JavaScript, designed to make your life easier 😎
+
+---
+
+## Description
+
+`ransyr` dibuat untuk mempermudah penggunaan random di JavaScript, **meniru gaya Python**.  
+Daripada harus menulis:
+
+```javascript
+const choice = arr[Math.floor(Math.random() * arr.length)];
+```
+
+## Contoh Penggunaan
+
+```javascript
+import random from 'ransyr';
+
+const arr = ["apple", "banana", "cherry"];
+console.log(random.choice(arr));
+console.log(random.random());
+```

package/main.js

@@ -0,0 +1,52 @@
+
+export default class ransyr {
+
+	static random() {
+		return Math.random();
+	}
+
+	static sample(arr, k) {
+		if (k > arr.length) {
+			throw new RangeError("sample size larger than population");
+		}
+
+		const copy = [...arr];
+		const result = [];
+
+		for (let i = 0; i < k; i++) {
+			const idx = Math.floor(Math.random() * copy.length);
+			result.push(copy[idx]);
+			copy.splice(idx, 1);
+		}
+
+		return result;
+	}
+
+	static randint(min, max) {
+		if (min > max) [min,
+			max] = [max,
+			min];
+		return Math.floor(Math.random() * (max - min + 1)) + min;
+	}
+
+	static choice(arr) {
+		if (!arr.length) return undefined;
+		return arr[Math.floor(Math.random() * arr.length)];
+	}
+
+	static shuffle(arr) {
+		const copy = [...arr];
+		for (let i = copy.length - 1; i > 0; i--) {
+			const j = Math.floor(Math.random() * (i + 1));
+			[copy[i],
+				copy[j]] = [copy[j],
+				copy[i]];
+		}
+		return copy;
+	}
+
+	static chance(percent) {
+		return Math.random() * 100 < percent;
+	}
+}
+

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "ransyr",
+  "version": "1.1.0",
+  "description": "python like random utilities for make things easier",
+  "main": "main.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kyusora/ransyr.git"
+  },
+  "keywords": [
+    "random",
+    "ransyr",
+    "tools",
+    "utilities",
+    "python",
+    "js"
+  ],
+  "author": "kyusora",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/kyusora/ransyr/issues"
+  },
+  "homepage": "https://github.com/kyusora/ransyr#readme"
+}