fui-material 2.2.2 → 2.2.4

package/dist/types/function-elements/fConvertDate/fConvertDate.d.ts

@@ -0,0 +1,60 @@
+type FormatOption = "iso" | "ru" | "ru-datetime" | "date" | "time" | "custom";
+interface ConvertDateOptions {
+    /**
+     * Стандартные форматы:
+     * - "iso" → YYYY-MM-DD
+     * - "ru" → DD.MM.YYYY
+     * - "ru-datetime" → DD.MM.YYYY HH:MM:SS
+     * - "time" → HH:MM:SS
+     * - "date" → объект Date
+     * - "custom" → использовать `customOptions`
+     */
+    format?: FormatOption;
+    /** Локаль для кастомного формата (по умолчанию "ru-RU") */
+    locale?: string;
+    /** Опции для Intl.DateTimeFormat при `format: "custom"` */
+    customOptions?: Intl.DateTimeFormatOptions;
+}
+/**
+ * Универсальный конвертер даты и времени.
+ *
+ * Поддерживает строки, числа (timestamp), Date, null и undefined.
+ * Может возвращать дату в ISO, русскую дату, русскую дату с временем,
+ * только время, объект Date или кастомный формат через Intl.DateTimeFormat.
+ *
+ * @param input - Дата в виде строки, числа, Date, null или undefined
+ * @param options - Настройки форматирования
+ *
+ * @returns Отформатированная дата/время или '' / undefined для пустых значений
+ *
+ * @example
+ * // ISO формат
+ * convertDate("2025-10-02T15:30:45", { format: "iso" });
+ * // "2025-10-02"
+ *
+ * // Русская дата
+ * convertDate("2025-10-02T15:30:45", { format: "ru" });
+ * // "02.10.2025"
+ *
+ * // Русская дата и время
+ * convertDate("2025-10-02T15:30:45", { format: "ru-datetime" });
+ * // "02.10.2025 15:30:45"
+ *
+ * // Только время
+ * convertDate(new Date(), { format: "time" });
+ * // "14:30:05"
+ *
+ * // Объект Date
+ * convertDate(1696262400000, { format: "date" });
+ * // Date object
+ *
+ * // Кастомный формат
+ * convertDate(new Date(), {
+ *   format: "custom",
+ *   locale: "en-US",
+ *   customOptions: { weekday: "long", month: "long", day: "numeric", year: "numeric" }
+ * });
+ * // "Thursday, October 2, 2025"
+ */
+declare function fConvertDate(input: string | number | Date | null | undefined, options?: ConvertDateOptions): string | Date | undefined;
+export default fConvertDate;

package/dist/types/function-elements/fConvertDate/index.d.ts

@@ -0,0 +1 @@
+export { default } from "./fConvertDate";

package/dist/types/function-elements/fFormatRuNumber/fFormatRuNumber.d.ts

@@ -1,6 +1,7 @@
 /**
  * Форматирует число в строку с русской локализацией (разделение тысяч, дробная часть и т.д.)
  * Может использовать банковское округление перед форматированием.
+ * По флагу может вернуть число вместо строки.
  *
  * @param {number} a - Число для форматирования
  * @param {Object} [options] - Опциональные параметры
@@ -8,22 +9,20 @@
  * @param {number} [options.minimumFractionDigits] - Минимальное количество знаков после запятой
  * @param {boolean} [options.useBankRound=false] - Использовать ли банковское округление
  * @param {number} [options.bankRoundDecimalPlaces=2] - Количество знаков после запятой для банковского округления
- * @returns {string} Отформатированная строка числа
- *
- * @description
- * Функция сначала проверяет валидность входного числа, затем при необходимости
- * применяет банковское округление, после чего форматирует результат
- * с использованием русской локали и возвращает строку.
+ * @param {boolean} [options.returnNumber=false] - Вернуть ли число вместо строки
+ * @returns {string|number} Отформатированная строка числа или число
  *
  * @example
  * fFormatRuNumber(1234.567); // "1 234,567"
  * fFormatRuNumber(1234.567, { useBankRound: true }); // "1 234,57"
  * fFormatRuNumber(1234.567, { maximumFractionDigits: 2 }); // "1 234,57"
+ * fFormatRuNumber(1234.567, { useBankRound: true, returnNumber: true }); // 1234.57
  */
 declare const fFormatRuNumber: (a: number, options?: {
     maximumFractionDigits?: number;
     minimumFractionDigits?: number;
     useBankRound?: boolean;
     bankRoundDecimalPlaces?: number;
-}) => string;
+    returnNumber?: boolean;
+}) => string | number;
 export default fFormatRuNumber;

package/dist/types/function-elements/index.d.ts

@@ -13,3 +13,4 @@ export { default as fDownloadFileFromBase64 } from "./fDownloadFileFromBase64";
 export { default as fDownloadBlobFile } from "./fDownloadBlobFile";
 export { default as fBankRound } from "./fBankRound";
 export { default as fFormatRuNumber } from "./fFormatRuNumber";
+export { default as fConvertDate } from "./fConvertDate";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fui-material",
-  "version": "2.2.2",
+  "version": "2.2.4",
   "type": "module",
   "publishConfig": {
     "access": "public",