@nemigo/helpers 0.0.8 → 0.0.10

package/dist/clean.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Очищает рекурсивно C КОПИРОВАНИЕМ объект (в т.ч. и массивы) от пустых, неопределенных или нулевых значений.
+ * Дополнительно удаляет пустые объекты и массивы, которые могут появиться после очистки.
+ * Если аргумент не является объектом, он возвращается без изменений
+ *
+ * @example
+ * const original = { a: 1, b: null, c: { d: '', e: { f: undefined } } };
+ * const cleaned = deepObjectClean(original);
+ *
+ * console.log(cleaned); // { a: 1 }
+ * console.log(original); // {{ a: 1, b: null, c: { d: '', e: { f: undefined } } }
+ */
+export declare const deepObjectClean: <O>(data: O) => O;

package/dist/clean.js

@@ -0,0 +1,46 @@
+/**
+ * Очищает рекурсивно C КОПИРОВАНИЕМ объект (в т.ч. и массивы) от пустых, неопределенных или нулевых значений.
+ * Дополнительно удаляет пустые объекты и массивы, которые могут появиться после очистки.
+ * Если аргумент не является объектом, он возвращается без изменений
+ *
+ * @example
+ * const original = { a: 1, b: null, c: { d: '', e: { f: undefined } } };
+ * const cleaned = deepObjectClean(original);
+ *
+ * console.log(cleaned); // { a: 1 }
+ * console.log(original); // {{ a: 1, b: null, c: { d: '', e: { f: undefined } } }
+ */
+export const deepObjectClean = (data) => {
+    if (typeof data !== "object" || data === null)
+        return data;
+    if (Array.isArray(data)) {
+        return data.reduce((acc, value) => {
+            if (value !== "" && value !== null && value !== undefined) {
+                if (typeof value === "object") {
+                    const cleaned = deepObjectClean(value);
+                    if (Object.keys(cleaned).length !== 0)
+                        acc.push(cleaned);
+                }
+                else {
+                    acc.push(value);
+                }
+            }
+            return acc;
+        }, []);
+    }
+    const result = {};
+    for (const key in data) {
+        const value = data[key];
+        if (value !== "" && value !== null && value !== undefined) {
+            if (typeof value === "object") {
+                const cleaned = deepObjectClean(value);
+                if (Object.keys(cleaned).length !== 0)
+                    result[key] = cleaned;
+            }
+            else {
+                result[key] = value;
+            }
+        }
+    }
+    return result;
+};

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.8",
+	"version": "0.0.10",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",
@@ -19,6 +19,10 @@
 			"types": "./dist/cases.d.ts",
 			"default": "./dist/cases.js"
 		},
+		"./clean": {
+			"types": "./dist/clean.d.ts",
+			"default": "./dist/clean.js"
+		},
 		"./explorer": {
 			"types": "./dist/explorer.d.ts",
 			"default": "./dist/explorer.js"
@@ -35,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"