@snabcentr/vue-ui-lib 3.4.13 → 3.5.1

package/dist/src/components/inputs/debounced-input-number.vue.d.ts

@@ -2,7 +2,7 @@ import { IDebounced, IPlaceholder } from '../../properties';
 /**
  * Компонент числового поля ввода с устранением дребезга.
  */
-declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<import('../../properties').IValue<number | null | undefined> & import('../../properties').IClearable & IDebounced & IPlaceholder & {
+declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<import('../../properties').IValue<number | null> & import('../../properties').IClearable & IDebounced & IPlaceholder & {
     /**
      * Минимальное значение.
      */
@@ -19,13 +19,23 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
      * Функция валидации значений поля ввода.
      */
     validator?: ((value: number) => boolean) | undefined;
+    /**
+     * Функция парсинга строки в число (например, для замены запятой на точку).
+     */
+    parse?: (value: string) => number | null;
+    /**
+     * Показывать кнопки +/-.
+     */
+    showButton?: boolean;
 }, {
     focus: () => void | undefined;
     blur: () => void | undefined;
     select: () => void | undefined;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    "update:value": (value: number | null | undefined, ...additionalParams: any[]) => any;
-}, string, import('vue').PublicProps, Readonly<import('../../properties').IValue<number | null | undefined> & import('../../properties').IClearable & IDebounced & IPlaceholder & {
+    input: (inputEvent: Event) => any;
+    keydown: (keyboardEvent: KeyboardEvent) => any;
+    "update:value": (value: number | null, ...additionalParams: any[]) => any;
+}, string, import('vue').PublicProps, Readonly<import('../../properties').IValue<number | null> & import('../../properties').IClearable & IDebounced & IPlaceholder & {
     /**
      * Минимальное значение.
      */
@@ -42,16 +52,28 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<im
      * Функция валидации значений поля ввода.
      */
     validator?: ((value: number) => boolean) | undefined;
+    /**
+     * Функция парсинга строки в число (например, для замены запятой на точку).
+     */
+    parse?: (value: string) => number | null;
+    /**
+     * Показывать кнопки +/-.
+     */
+    showButton?: boolean;
 }> & Readonly<{
-    "onUpdate:value"?: ((value: number | null | undefined, ...additionalParams: any[]) => any) | undefined;
+    onInput?: ((inputEvent: Event) => any) | undefined;
+    onKeydown?: ((keyboardEvent: KeyboardEvent) => any) | undefined;
+    "onUpdate:value"?: ((value: number | null, ...additionalParams: any[]) => any) | undefined;
 }>, {
-    value: number | null | undefined;
+    value: number | null;
     placeholder: string;
     clearable: boolean;
     validator: (value: number) => boolean;
     min: number;
     max: number;
     step: number;
+    showButton: boolean;
+    parse: (value: string) => number | null;
     debounceTime: number;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     inputReference: import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{

package/dist/src/helpers/index.d.ts

@@ -1,2 +1,3 @@
 export * from './content-helper';
+export * from './input-helper';
 export * from './select-option-helper';

package/dist/src/helpers/input-helper.d.ts

@@ -0,0 +1,31 @@
+import { IFormValidationResult } from '@snabcentr/common-lib';
+/**
+ * Обработчик события keydown для ограничения ввода только целыми числами.
+ * Разрешает ввод цифр 0-9 и основных управляющих клавиш.
+ *
+ * @param event Событие клавиатуры.
+ * @param allowNegative Разрешить ввод отрицательных чисел (по умолчанию false).
+ */
+export declare const handleIntegerInput: (event: KeyboardEvent, allowNegative?: boolean) => void;
+/**
+ * Обработчик события keydown для ограничения ввода числами с плавающей точкой.
+ * Разрешает ввод цифр, точки или запятой и основных управляющих клавиш.
+ *
+ * @param event Событие клавиатуры.
+ * @param decimalSeparator Разделитель дробной части (по умолчанию '.').
+ * @param allowNegative Разрешить ввод отрицательных чисел (по умолчанию false).
+ */
+export declare const handleFloatInput: (event: KeyboardEvent, decimalSeparator?: "." | ",", allowNegative?: boolean) => void;
+/**
+ * Парсит строку в число заменяя запятую на точку.
+ *
+ * @param value Строка для парсинга.
+ */
+export declare const parse: (value: string | null) => number | null;
+/**
+ * Сбрасывает результаты валидации поля.
+ *
+ * @param validation Результаты валидации.
+ * @param field Название поля для сброса.
+ */
+export declare const resetInputValidation: (validation: IFormValidationResult, field: string) => void;

package/dist/src/helpers/validators.d.ts

@@ -0,0 +1,41 @@
+import { FormItemRule } from 'naive-ui';
+/**
+ * Класс валидаторов числовых полей.
+ * Предоставляет статические методы для создания правил валидации форм.
+ */
+export declare const NumericValidators: {
+    /**
+     * Требует, чтобы поле было заполнено.
+     */
+    required: FormItemRule;
+    /**
+     * Проверяет минимальное значение.
+     *
+     * @param min Минимальное значение.
+     */
+    min(min: number): FormItemRule;
+    /**
+     * Проверяет максимальное значение.
+     *
+     * @param max Максимальное значение.
+     */
+    max(max?: number): FormItemRule;
+    /**
+     * Проверяет кратность значения.
+     *
+     * @param step Шаг/кратность значения.
+     */
+    step(step: number): FormItemRule;
+};
+/**
+ * Класс валидаторов полей.
+ * Предоставляет статические методы для создания правил валидации полей форм.
+ */
+export declare const Validators: {
+    /**
+     * Выводит сообщение об ошибке серверной валидации.
+     *
+     * @param serverValidation Сообщение об ошибке серверной валидации.
+     */
+    serverValidation(serverValidation?: string): FormItemRule;
+};

package/package.json

@@ -4,7 +4,7 @@
     "keywords": [],
     "author": "Sergey S. Smirnov <dev@snabcentr.com>",
     "type": "module",
-    "version": "3.4.13",
+    "version": "3.5.1",
     "license": "ISC",
     "scripts": {
         "dev": "vite",