@kamen/create-webapp 1.0.14 → 1.0.16

package/README.md

@@ -1,9 +1,24 @@
 # @kamen/create-weapp <a href="https://npmjs.com/package/@kamen/create-webapp"><img src="https://img.shields.io/npm/v/@kamen/create-webapp" alt="npm package"></a>
 
-## Scaffolding Your Project
+## Project Scaffolding
 
 With NPM:
 
 ```bash
 $ npm init @kamen/webapp
 ```
+
+## Utility Functions
+
+```js
+import {randomFromRange, randomFromList} from "@kamen/create-webapp";
+
+const colors = ['red', 'green', 'blue'];
+const data = {
+    color: randomFromList(colors),
+    length: randomFromRange(0, 99);
+    state: Boolean(randomFromRange(0, 1))
+};
+
+console.dir(data);
+```

package/index.js

@@ -1,13 +1,65 @@
-export default {
-    type: 'object',
-    status: true,
-    count: 420,
-    name: 'package default export'
-};
-
-export const named = {
-    type: 'object',
-    status: false,
-    count: -1,
-    name: 'package named export'
-};
+const primitiveTypeRe = /^string|number|bigint|boolean|symbol$/;
+const objectTypeRe = /^object|function$/;
+
+/**
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isPrimitive(value) {
+    return primitiveTypeRe.test(typeof value);
+}
+
+/**
+ * @param {*} value
+ * @returns {boolean}
+ */
+export function isObject(value) {
+    return value !== null && objectTypeRe.test(typeof value);
+}
+
+/**
+ * @param {number} offset
+ * @param {number} length
+ * @return {number}
+ */
+export function modulo(offset, length) {
+    return ((offset % length) + length) % length;
+}
+
+/**
+ * @param {number} [min=0]
+ * @param {number} [max=255]
+ * @param {number} [step=1]
+ * @return {number[]}
+ */
+export function range(min = 0, max = 255, step = 1) {
+    return Array.from({length: (max - min) / step + 1}, (_, index) => index * step + min);
+}
+
+/**
+ * @param {number} value
+ * @param {number} [min=0]
+ * @param {number} [max=255]
+ * @return {number}
+ */
+export function clamp(value, min = 0, max = 255) {
+    return Math.min(Math.max(value, min), max);
+}
+
+/**
+ * @param {number} [min=0]
+ * @param {number} [max=255]
+ * @return {number}
+ */
+export function randomFromRange(min = 0, max = 255) {
+    return Math.floor(Math.random() * (max - min + 1) + min);
+}
+
+/**
+ * @template T
+ * @param {T[]} [list=[]]
+ * @returns {T}
+ */
+export function randomFromList(list = []) {
+    return list[randomFromRange(0, list.length - 1)];
+}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@kamen/create-webapp",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "npm init @kamen/webapp",
   "homepage": "https://www.npmjs.com/package/@kamen/create-webapp",
-  "license": "UNLICENSED",
+  "license": "GPL-2.0-only",
   "private": false,
-  "keywords": ["web"],
+  "keywords": ["init", "utlity", "web"],
   "type": "module",
   "main": "index.js",
   "bin": {
@@ -23,10 +23,10 @@
     "url": "git+https://github.com/L1feF0rm/special-octo-barnacle.git"
   },
   "engines": {
-    "node": ">=18",
-    "npm": ">=9"
+    "node": ">=20",
+    "npm": ">=10"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   }
-}
+}