@kamen/create-webapp 1.0.49 → 1.0.51

package/helpers/list.js

@@ -0,0 +1,34 @@
+/**
+ * @param {number} offset
+ * @param {number} length
+ * @returns {number}
+ */
+export function modulo(offset, length) {
+    return ((offset % length) + length) % length;
+}
+
+/**
+ * @param {number} [min=0]
+ * @param {number} [max=255]
+ * @param {number} [step=1]
+ * @returns {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]
+ * @returns {number}
+ */
+export function clamp(value, min = 0, max = 255) {
+    return Math.min(Math.max(value, min), max);
+}
+
+export default {
+    modulo,
+    range,
+    clamp
+};

package/helpers/random.js

@@ -0,0 +1,79 @@
+/**
+ * @returns {string}
+ */
+export function randomSlug() {
+    return Math.random().toString(36).slice(2);
+}
+
+/**
+ * @param {number} [min=0]
+ * @param {number} [max=255]
+ * @returns {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)];
+}
+
+/**
+ * @param {number} [saturation=80]
+ * @param {number} [lightness=80]
+ * @param {number} [alpha=1]
+ * @returns {string}
+ */
+export function randomColorFromSaturationLightnessAlpha(saturation = 80, lightness = 80, alpha = 1) {
+    const hue = randomFromRange(0, 359);
+    return `hsla(${hue}, ${saturation}%, ${lightness}%, ${alpha})`;
+}
+
+/**
+ * @param {number} [min=0]
+ * @param {number} [max=255]
+ * @returns {Function<number>}
+ */
+export function createRandomFromRange(min = 0, max = 255) {
+    return function () {
+        return randomFromRange(min, max);
+    }
+}
+
+/**
+ * @template T
+ * @param {T[]} [list=[]]
+ * @returns {Function<T>}
+ */
+export function createRandomFromList(list = []) {
+    return function () {
+        return randomFromList(list);
+    }
+}
+
+/**
+ * @param {number} [saturation=80]
+ * @param {number} [lightness=80]
+ * @param {number} [alpha=1]
+ * @returns {Function<string>}
+ */
+export function createRandomColorFromSaturationLightnessAlpha(saturation = 80, lightness = 80, alpha = 1) {
+    return function () {
+        return randomColorFromSaturationLightnessAlpha(saturation, lightness, alpha);
+    }
+}
+
+export default {
+    randomSlug,
+    randomFromRange,
+    randomFromList,
+    randomColorFromSaturationLightnessAlpha,
+    createRandomFromRange,
+    createRandomFromList,    
+    createRandomColorFromSaturationLightnessAlpha
+};

package/helpers/temporal.js

@@ -0,0 +1,55 @@
+export const WEEKS_PER_YEAR = 52;
+
+export const DAYS_PER_WEEK = 7;
+export const DAYS_PER_YEAR = DAYS_PER_WEEK * WEEKS_PER_YEAR;
+
+export const HOURS_PER_DAY = 24;
+export const HOURS_PER_WEEK = HOURS_PER_DAY * DAYS_PER_WEEK;
+export const HOURS_PER_YEAR = HOURS_PER_WEEK * WEEKS_PER_YEAR;
+
+export const MINUTES_PER_HOUR = 60;
+export const MINUTES_PER_DAY = MINUTES_PER_HOUR * HOURS_PER_DAY;
+export const MINUTES_PER_WEEK = MINUTES_PER_DAY * DAYS_PER_WEEK;
+export const MINUTES_PER_YEAR = MINUTES_PER_WEEK * WEEKS_PER_YEAR;
+
+export const SECONDS_PER_MINUTE = 60;
+export const SECONDS_PER_HOUR = SECONDS_PER_MINUTE * MINUTES_PER_HOUR;
+export const SECONDS_PER_DAY = SECONDS_PER_HOUR * HOURS_PER_DAY;
+export const SECONDS_PER_WEEK = SECONDS_PER_DAY * DAYS_PER_WEEK;
+export const SECONDS_PER_YEAR = SECONDS_PER_WEEK * WEEKS_PER_YEAR;
+
+export const MILLISECONDS_PER_SECOND = 1000;
+export const MILLISECONDS_PER_MINUTE = MILLISECONDS_PER_SECOND * SECONDS_PER_MINUTE;
+export const MILLISECONDS_PER_HOUR = MILLISECONDS_PER_MINUTE * MINUTES_PER_HOUR;
+export const MILLISECONDS_PER_DAY = MILLISECONDS_PER_HOUR * HOURS_PER_DAY;
+export const MILLISECONDS_PER_WEEK = MILLISECONDS_PER_DAY * DAYS_PER_WEEK;
+export const MILLISECONDS_PER_YEAR = MILLISECONDS_PER_WEEK * WEEKS_PER_YEAR;
+
+export default {
+    WEEKS_PER_YEAR,
+
+    DAYS_PER_WEEK,
+    DAYS_PER_YEAR,
+
+    HOURS_PER_DAY,
+    HOURS_PER_WEEK,
+    HOURS_PER_YEAR,
+
+    MINUTES_PER_HOUR,
+    MINUTES_PER_DAY,
+    MINUTES_PER_WEEK,
+    MINUTES_PER_YEAR,
+
+    SECONDS_PER_MINUTE,
+    SECONDS_PER_HOUR,
+    SECONDS_PER_DAY,
+    SECONDS_PER_WEEK,
+    SECONDS_PER_YEAR,
+
+    MILLISECONDS_PER_SECOND,
+    MILLISECONDS_PER_MINUTE,
+    MILLISECONDS_PER_HOUR,
+    MILLISECONDS_PER_DAY,
+    MILLISECONDS_PER_WEEK,
+    MILLISECONDS_PER_YEAR
+};

package/index.js

@@ -1,6 +1,11 @@
 const primitiveTypeRe = /^string|number|bigint|boolean|symbol$/;
 const objectTypeRe = /^object|function$/;
-export {default as temporal} from './temporal.js';
+
+import {modulo} from './helpers/list';
+
+export {default as list} from './helpers/list';
+export {default as random} from './helpers/random';
+export {default as temporal} from './helpers/temporal';
 
 /**
  * @param {*} value
@@ -18,105 +23,6 @@ export function isObject(value) {
     return value !== null && objectTypeRe.test(typeof value);
 }
 
-/**
- * @param {number} offset
- * @param {number} length
- * @returns {number}
- */
-export function modulo(offset, length) {
-    return ((offset % length) + length) % length;
-}
-
-/**
- * @param {number} [min=0]
- * @param {number} [max=255]
- * @param {number} [step=1]
- * @returns {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]
- * @returns {number}
- */
-export function clamp(value, min = 0, max = 255) {
-    return Math.min(Math.max(value, min), max);
-}
-
-/**
- * @returns {string}
- */
-export function randomSlug() {
-    return Math.random().toString(36).slice(2);
-}
-
-/**
- * @param {number} [min=0]
- * @param {number} [max=255]
- * @returns {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)];
-}
-
-/**
- * @param {number} [saturation=80]
- * @param {number} [lightness=80]
- * @param {number} [alpha=1]
- * @returns {string}
- */
-export function randomColorFromSaturationLightnessAlpha(saturation = 80, lightness = 80, alpha = 1) {
-    const hue = randomFromRange(0, 359);
-    return `hsla(${hue}, ${saturation}%, ${lightness}%, ${alpha})`;
-}
-
-/**
- * @param {number} [min=0]
- * @param {number} [max=255]
- * @returns {Function<number>}
- */
-export function createRandomFromRange(min = 0, max = 255) {
-    return function () {
-        return randomFromRange(min, max);
-    }
-}
-
-/**
- * @template T
- * @param {T[]} [list=[]]
- * @returns {Function<T>}
- */
-export function createRandomFromList(list = []) {
-    return function () {
-        return randomFromList(list);
-    }
-}
-
-/**
- * @param {number} [saturation=80]
- * @param {number} [lightness=80]
- * @param {number} [alpha=1]
- * @returns {Function<string>}
- */
-export function createRandomColorFromSaturationLightnessAlpha(saturation = 80, lightness = 80, alpha = 1) {
-    return function () {
-        return randomColorFromSaturationLightnessAlpha(saturation, lightness, alpha);
-    }
-}
-
 /**
  * @param {string} [text='']
  * @param {number} [saturation=80]
@@ -377,18 +283,3 @@ export const introspection = {
     isPrimitive,
     isObject
 };
-
-export const numbering = {
-    modulo,
-    range,
-    clamp
-};
-
-export const randomness = {
-    randomFromRange,
-    createRandomFromRange,
-    randomFromList,
-    createRandomFromList,
-    randomColorFromSaturationLightnessAlpha,
-    createRandomColorFromSaturationLightnessAlpha
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kamen/create-webapp",
-  "version": "1.0.49",
+  "version": "1.0.51",
   "description": "npm init @kamen/webapp",
   "keywords": [
     "init",
@@ -16,7 +16,10 @@
     "create-webapp": "scripts/index.js"
   },
   "exports": {
-    ".": "./index.js"
+    ".": "./index.js",
+    "./helpers/list": "./helpers/list.js",
+    "./helpers/random": "./helpers/random.js",
+    "./helpers/temporal": "./helpers/temporal.js"
   },
   "author": {
     "name": "Kamen Balabanov",

package/scripts/index.js

@@ -1,12 +1,10 @@
 #!/usr/bin/env node
 
 import {cwd, versions} from 'node:process';
-
-import {modulo} from '@kamen/create-webapp';
+import {modulo} from '@kamen/create-webapp/helpers/list';
 
 console.log(modulo(-10, 4));
-
 console.log('versions', versions);
 console.log('cwd()', cwd());
 
-process.exit(0);
+process.exit(0);

package/temporal.js

@@ -1,55 +0,0 @@
-const WEEKS_PER_YEAR = 52;
-
-const DAYS_PER_WEEK = 7;
-const DAYS_PER_YEAR = DAYS_PER_WEEK * WEEKS_PER_YEAR;
-
-const HOURS_PER_DAY = 24;
-const HOURS_PER_WEEK = HOURS_PER_DAY * DAYS_PER_WEEK;
-const HOURS_PER_YEAR = HOURS_PER_WEEK * WEEKS_PER_YEAR;
-
-const MINUTES_PER_HOUR = 60;
-const MINUTES_PER_DAY = MINUTES_PER_HOUR * HOURS_PER_DAY;
-const MINUTES_PER_WEEK = MINUTES_PER_DAY * DAYS_PER_WEEK;
-const MINUTES_PER_YEAR = MINUTES_PER_WEEK * WEEKS_PER_YEAR;
-
-const SECONDS_PER_MINUTE = 60;
-const SECONDS_PER_HOUR = SECONDS_PER_MINUTE * MINUTES_PER_HOUR;
-const SECONDS_PER_DAY = SECONDS_PER_HOUR * HOURS_PER_DAY;
-const SECONDS_PER_WEEK = SECONDS_PER_DAY * DAYS_PER_WEEK;
-const SECONDS_PER_YEAR = SECONDS_PER_WEEK * WEEKS_PER_YEAR;
-
-const MILLISECONDS_PER_SECOND = 1000;
-const MILLISECONDS_PER_MINUTE = MILLISECONDS_PER_SECOND * SECONDS_PER_MINUTE;
-const MILLISECONDS_PER_HOUR = MILLISECONDS_PER_MINUTE * MINUTES_PER_HOUR;
-const MILLISECONDS_PER_DAY = MILLISECONDS_PER_HOUR * HOURS_PER_DAY;
-const MILLISECONDS_PER_WEEK = MILLISECONDS_PER_DAY * DAYS_PER_WEEK;
-const MILLISECONDS_PER_YEAR = MILLISECONDS_PER_WEEK * WEEKS_PER_YEAR;
-
-export default {
-    WEEKS_PER_YEAR,
-
-    DAYS_PER_WEEK,
-    DAYS_PER_YEAR,
-
-    HOURS_PER_DAY,
-    HOURS_PER_WEEK,
-    HOURS_PER_YEAR,
-
-    MINUTES_PER_HOUR,
-    MINUTES_PER_DAY,
-    MINUTES_PER_WEEK,
-    MINUTES_PER_YEAR,
-
-    SECONDS_PER_MINUTE,
-    SECONDS_PER_HOUR,
-    SECONDS_PER_DAY,
-    SECONDS_PER_WEEK,
-    SECONDS_PER_YEAR,
-
-    MILLISECONDS_PER_SECOND,
-    MILLISECONDS_PER_MINUTE,
-    MILLISECONDS_PER_HOUR,
-    MILLISECONDS_PER_DAY,
-    MILLISECONDS_PER_WEEK,
-    MILLISECONDS_PER_YEAR
-};