@nemigo/helpers 0.0.9 → 0.0.10

package/dist/phymath.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Приведение -/+ 0 к 0
+ */
+export declare const toZero: (value: number) => number;
+/**
+ * Округляет число до заданного количества знаков после запятой
+ *
+ * Если переданное значение является `NaN` возвращает 0
+ *
+ * @param {number} value - Число для округления
+ * @param {number} [fraction=2] - Количество знаков после запятой
+ * @returns {number} Округленное число
+ */
+export declare const toRound: (value: number, fraction?: number) => number;
+/**
+ * Вычисляет сумму всех переданных аргументов
+ *
+ * Сумма округляется с использованием функции {@link toRound}
+ *
+ * @param {...number} args - Числа для суммирования
+ * @returns {number} Округленная сумма переданных чисел (или 0)
+ */
+export declare const sum: (...args: number[]) => number;
+/**
+ * Вычисляет произведение всех переданных аргументов
+ *
+ * Произведение округляется с использованием функции {@link toRound}
+ *
+ * @param {...number} args - Числа для перемножения.
+ * @returns {number} Округленное произведение переданных чисел (или 1)
+ */
+export declare const mult: (...args: number[]) => number;
+/**
+ * Ограничивает значение в заданном диапазоне [min, max]
+ *
+ * Если значение меньше min, вернёт min. Если больше max — вернёт max.
+ * Иначе возвращает само значение без изменений.
+ *
+ * @param {number} v - Исходное значение для ограничения
+ * @param {number} min - Нижняя граница диапазона
+ * @param {number} max - Верхняя граница диапазона
+ *
+ * @returns {number} Значение, ограниченное диапазоном [min, max]
+ */
+export declare const clamp: (v: number, min: number, max: number) => number;

package/dist/phymath.js

@@ -0,0 +1,50 @@
+/**
+ * Приведение -/+ 0 к 0
+ */
+export const toZero = (value) => (value === 0 ? 0 : value);
+/**
+ * Округляет число до заданного количества знаков после запятой
+ *
+ * Если переданное значение является `NaN` возвращает 0
+ *
+ * @param {number} value - Число для округления
+ * @param {number} [fraction=2] - Количество знаков после запятой
+ * @returns {number} Округленное число
+ */
+export const toRound = (value, fraction = 2) => {
+    if (isNaN(value) || value === 0)
+        return 0;
+    return Number(value.toFixed(fraction));
+};
+//...
+/**
+ * Вычисляет сумму всех переданных аргументов
+ *
+ * Сумма округляется с использованием функции {@link toRound}
+ *
+ * @param {...number} args - Числа для суммирования
+ * @returns {number} Округленная сумма переданных чисел (или 0)
+ */
+export const sum = (...args) => toRound(args.reduce((acc, v) => acc + v, 0));
+/**
+ * Вычисляет произведение всех переданных аргументов
+ *
+ * Произведение округляется с использованием функции {@link toRound}
+ *
+ * @param {...number} args - Числа для перемножения.
+ * @returns {number} Округленное произведение переданных чисел (или 1)
+ */
+export const mult = (...args) => toRound(args.reduce((acc, v) => acc * v, 1));
+/**
+ * Ограничивает значение в заданном диапазоне [min, max]
+ *
+ * Если значение меньше min, вернёт min. Если больше max — вернёт max.
+ * Иначе возвращает само значение без изменений.
+ *
+ * @param {number} v - Исходное значение для ограничения
+ * @param {number} min - Нижняя граница диапазона
+ * @param {number} max - Верхняя граница диапазона
+ *
+ * @returns {number} Значение, ограниченное диапазоном [min, max]
+ */
+export const clamp = (v, min, max) => Math.max(Math.min(v, max), min);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nemigo/helpers",
-	"version": "0.0.9",
+	"version": "0.0.10",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",
@@ -39,6 +39,10 @@
 			"types": "./dist/random.d.ts",
 			"default": "./dist/random.js"
 		},
+		"./phymath": {
+			"types": "./dist/phymath.d.ts",
+			"default": "./dist/phymath.js"
+		},
 		"./script": {
 			"types": "./dist/script.d.ts",
 			"default": "./dist/script.js"