@dxtmisha/constructor 0.30.1 → 0.39.3

package/dist/types/fieldTypes.d.ts

@@ -0,0 +1,294 @@
+import { ComputedRef, ShallowRef } from 'vue';
+import { ListRecord, NumberOrString } from '@dxtmisha/functional';
+import { ModelEmits, ModelProps } from './modelTypes';
+/** Supported field types/ Поддерживаемые типы полей */
+export type FieldType = 'text' | 'search' | 'number' | 'number-format' | 'currency' | 'email' | 'password' | 'datetime' | 'date' | 'year-month' | 'time' | 'hour-minute' | 'tel' | 'url' | 'checkbox' | 'radio';
+/** Base input or textarea element/ Базовый элемент input или textarea */
+export type FieldElementDom = HTMLInputElement | HTMLTextAreaElement;
+/** Any supported field element (native, wrapper, record)/ Любой поддерживаемый элемент поля (нативный, обёртка, объект) */
+export type FieldElementInput = FieldElementDom | HTMLElement | Record<string, any> | undefined;
+/** Map validity flags to custom messages/ Отображение флагов валидности в кастомные сообщения */
+export type FieldValidityCodeItem = {
+    [K in keyof ValidityState]?: string;
+};
+/** Global validation message or map/ Глобальное сообщение или карта сообщений */
+export type FieldValidityCode = string | FieldValidityCodeItem;
+/** Single mask fragment meta/ Один фрагмент маски с мета‑данными */
+export type FieldMaskItem = {
+    /** Group key/ Ключ группы */
+    group: string;
+    /** Accumulated value/ Накопленное значение */
+    value: string;
+    /** Max length for fragment/ Максимальная длина фрагмента */
+    maxLength: number;
+    /** Fragment filled flag/ Фрагмент заполнен */
+    full: boolean;
+    /** Caret end flag/ Флаг конца ввода */
+    end: boolean;
+    /** Characters extracted from value (value split into array)/ Символы извлечённые из value (value разделено на массив символов) */
+    chars: string[];
+};
+/** Masks data split by groups/ Данные маски, разделённые на группы */
+export type FieldMasks = Record<string, FieldMaskItem>;
+/** Partial input element for pattern/ Частичный элемент для pattern */
+export type FieldPatternElement = Partial<HTMLInputElement>;
+/** Pattern string or element/ Строка шаблона или элемент */
+export type FieldPatternItem = string | FieldPatternElement;
+/** Pattern or factory function/ Шаблон или функция‑генератор */
+export type FieldPatternItemOrFunction = FieldPatternItem | ((item: FieldMasks) => FieldPatternItem);
+/** Named pattern list/ Список именованных шаблонов */
+export type FieldPatternList = Record<string, FieldPatternItemOrFunction>;
+/** Match config object/ Объект конфигурации совпадения */
+export type FieldMatchItem = {
+    /** Target name or element/ Имя цели или элемент */
+    name?: string | HTMLInputElement;
+    /** Custom validation message/ Кастомное сообщение ошибки */
+    validationMessage?: string;
+};
+/** Match definition (string | element | object)/ Описание совпадения (строка | элемент | объект) */
+export type FieldMatch = string | HTMLInputElement | FieldMatchItem;
+/** Base data for validation check/ Базовые данные проверки */
+export type FieldCheckMain = {
+    /** Group key/ Ключ группы */
+    group?: string;
+    /** Related input element/ Связанный элемент ввода */
+    input?: FieldElementDom;
+    /** Pattern used/ Используемый шаблон */
+    pattern?: FieldPatternItemOrFunction;
+};
+/** Check item interface/ Элемент проверки */
+export type FieldCheckItem<Value = any> = FieldCheckMain & {
+    /** Run validation for value/ Выполнить проверку значения */
+    check(value: Value): FieldValidationItem<Value>;
+};
+/** Map of check items/ Карта элементов проверки */
+export type FieldCheckList = Record<string, FieldCheckItem>;
+/** Single validation result/ Результат одной проверки */
+export type FieldValidationItem<Value = any> = FieldCheckMain & {
+    /** Custom type marker/ Произвольный тип */
+    type?: string;
+    /** Pass status/ Статус успешности */
+    status?: boolean;
+    /** Required flag/ Флаг обязательности */
+    required?: boolean;
+    /** Full value flag/ Флаг полноты значения */
+    isFull?: boolean;
+    /** Message text/ Текст сообщения */
+    validationMessage?: string;
+    /** Native validity state/ Нативное состояние валидности */
+    validity?: ValidityState;
+    /** Custom validity message (overrides native)/ Кастомное сообщение валидности (перекрывает нативное) */
+    validityMessage?: string;
+    /** Original value/ Исходное значение */
+    value: Value;
+    /** Raw input value/ Введённое значение */
+    valueInput?: Value;
+    /** Extra details/ Дополнительные данные */
+    detail?: Record<string, any>;
+};
+/**
+ * Emitted events for field components/
+ * Эмитируемые события для компонентов поля
+ */
+export type FieldBasicEmits<T = string> = ModelEmits & {
+    /**
+     * Emitted on input events (every change while typing)/
+     * Эмит при вводе (каждое изменение): [event, value]
+     */
+    input: [event: InputEvent | Event, value: FieldValidationItem<T>];
+    /**
+     * Lightweight input emit without DOM event/
+     * Лёгкий эмит ввода без DOM-события: [value]
+     */
+    inputLite: [value: FieldValidationItem<T>];
+    /**
+     * Emitted when value is committed (blur/confirm)/
+     * Эмит при подтверждении значения (blur/confirm): [event, value]
+     */
+    change: [event: InputEvent | Event, value: FieldValidationItem<T>];
+    /**
+     * Lightweight change emit without DOM event/
+     * Лёгкий эмит подтверждения без события: [value]
+     */
+    changeLite: [value: FieldValidationItem<T>];
+};
+export type FieldBasicExpose<T = string> = {
+    value: ShallowRef<T | undefined>;
+    checkValidity: () => boolean;
+    validationMessage: ComputedRef<string>;
+};
+/**
+ * Properties that describe the value and its handling/
+ * Свойства, описывающие значение и работу с ним
+ *
+ * Used by the ValueInclude class to read/write value and constraints/
+ * Используется классом ValueInclude для чтения/записи значения и ограничений
+ */
+export interface FieldValueProps<Value = any> extends ModelProps<Value> {
+    /** Placeholder text shown when value is empty/ Текст подсказки при пустом значении */
+    placeholder?: string;
+    /** Multiple selection/value mode/ Режим множественного значения/выбора */
+    multiple?: boolean;
+    /** Maximum allowed length for value/ Максимальная допустимая длина значения */
+    maxlength?: NumberOrString;
+    /** Controlled value (without v-model)/ Контролируемое значение (без v-model) */
+    value?: Value;
+    /** Additional event details/ Дополнительные детали события */
+    detail?: Record<string, any> | undefined;
+}
+/**
+ * Basic HTML input attributes without value-length specifics/
+ * Базовые HTML атрибуты инпута без ограничений длины и multiple
+ */
+export interface FieldBasicProps<Value = any> extends Omit<FieldValueProps<Value>, 'multiple' | 'maxlength'> {
+    /** Input type/ Тип инпута */
+    type?: 'text' | 'search' | 'number' | 'number-format' | 'currency' | 'email' | 'password' | 'datetime' | 'date' | 'year-month' | 'time' | 'hour-minute' | 'tel' | 'url' | 'checkbox' | 'radio';
+    /** Input name attribute/ Атрибут name */
+    name?: string;
+    /** Input id attribute/ Атрибут id */
+    id?: string | number;
+    /** Required flag/ Обязательное поле */
+    required?: boolean;
+    /** Readonly state/ Режим только для чтения */
+    readonly?: boolean;
+    /** Disabled state/ Состояние отключения */
+    disabled?: boolean;
+    /** Autofocus flag/ Автофокус при загрузке */
+    autofocus?: boolean;
+    /** Tab index order/ Порядок табуляции */
+    tabindex?: number;
+    /** Form id this input belongs to/ ID формы, к которой относится инпут */
+    form?: string;
+    /** Validation error text or map of texts/ Текст ошибки валидации или карта текстов */
+    validationCode?: FieldValidityCode;
+    /**
+     * Standard validation message (overrides default)/
+     * Стандартное сообщение валидации (перекрывает дефолтное)
+     */
+    validationMessage?: string;
+    /** Match config to compare with another field/ Конфигурация сравнения со вторым полем */
+    match?: FieldMatch;
+    /** Additional attributes for the input element/ Дополнительные атрибуты для элемента инпута */
+    inputAttrs?: Record<string, any>;
+}
+/**
+ * Numeric stepping and range constraints/
+ * Ограничения шага и диапазона числовых значений
+ */
+export interface FieldStepProps {
+    /** Step size for numeric inputs/ Шаг для числовых инпутов */
+    step?: NumberOrString;
+    /** Minimum value/ Минимальное значение */
+    min?: NumberOrString;
+    /** Maximum value/ Максимальное значение */
+    max?: NumberOrString;
+}
+/**
+ * Input arrow controls (for type="number")/
+ * Управление стрелками ввода (для type="number")
+ */
+export interface FieldArrowProps {
+    /** Arrow type/ Тип стрелок */
+    arrow?: 'auto' | 'carousel' | 'stepper' | 'none';
+    /** Step size for input arrows (type="number" only)/ Шаг для стрелок ввода (только для type="number") */
+    arrowStep?: NumberOrString;
+    /** Arrow alignment/ Выравнивание стрелок */
+    arrowAlign?: 'center' | 'right' | 'left';
+}
+/**
+ * Text length constraints (characters, items)/
+ * Ограничения длины текста (символы, элементы)
+ */
+export interface FieldLengthProps {
+    /** Minimum length/ Минимальная длина */
+    minlength?: NumberOrString;
+    /** Maximum length/ Максимальная длина */
+    maxlength?: NumberOrString;
+}
+/**
+ * Validation pattern attribute/
+ * Атрибут паттерна валидации
+ */
+export interface FieldPatternProps {
+    /** Validation pattern (regexp)/ Паттерн валидации (рег. выражение) */
+    pattern?: string;
+}
+/**
+ * UX input control attributes/
+ * Атрибуты управления UX вводом
+ */
+export interface FieldUxProps {
+    /** Autocomplete hint/ Подсказка автозаполнения */
+    autocomplete?: string;
+    /** Auto capitalization mode/ Режим авто-капитализации */
+    autocapitalize?: 'off' | 'none' | 'sentences' | 'words' | 'characters' | string;
+    /** Input mode hint (virtual keyboard)/ Подсказка режима ввода (виртуальная клавиатура) */
+    inputMode?: 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url' | string;
+    /** Enter key hint/ Подсказка для клавиши Enter */
+    enterKeyHint?: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send' | string;
+    /** Spellcheck flag/ Проверка орфографии */
+    spellcheck?: boolean | 'true' | 'false';
+    /** Autocorrect mode (iOS/Safari)/ Режим автокоррекции (iOS/Safari) */
+    autocorrect?: 'on' | 'off' | string;
+}
+/**
+ * Composite props for standard textual / numeric inputs/
+ * Составные свойства стандартных текстовых / числовых инпутов
+ */
+export interface FieldInputProps<Value = any> extends FieldBasicProps<Value>, FieldStepProps, FieldArrowProps, FieldLengthProps, FieldPatternProps, FieldUxProps {
+    /** Datalist id reference/ Ссылка на datalist */
+    list?: string;
+    iconVisibility?: string;
+    iconVisibilityOff?: string;
+}
+/**
+ * Props for file input elements (type="file")/
+ * Свойства для инпутов выбора файлов (type="file")
+ */
+export interface FieldInputFileProps<Value = any> extends Omit<FieldBasicProps<Value>, 'type'>, FieldLengthProps, FieldUxProps {
+    /** Multiple files selection flag/ Флаг выбора нескольких файлов */
+    multiple?: boolean;
+    /** Accept file types list (MIME, extensions)/ Список допустимых типов (MIME, расширения) */
+    accept?: string;
+    /** Capture mode for media input (mobile)/ Режим захвата для медиа (мобильные устройства) */
+    capture?: string | boolean;
+}
+/**
+ * Props for checkbox & radio inputs (excluding type field)/
+ * Свойства для инпутов checkbox и radio (без поля type)
+ */
+export interface FieldInputCheckProps<Value = any> extends Omit<FieldBasicProps<Value>, 'type'>, FieldUxProps {
+    /** Checked state/ Состояние выбора */
+    checked?: boolean;
+    /** Indeterminate visual state (checkbox only)/ Промежуточное визуальное состояние (только для checkbox) */
+    indeterminate?: boolean;
+}
+/**
+ * Props for textarea elements with sizing & wrapping/
+ * Свойства для textarea с поддержкой размеров и переноса
+ */
+export interface FieldTextareaProps<Value = any> extends Omit<FieldBasicProps<Value>, 'type'>, FieldLengthProps, FieldUxProps {
+    /** Number of visible text lines/ Количество видимых строк */
+    rows?: NumberOrString;
+    /** Number of visible columns/ Количество видимых колонок */
+    cols?: NumberOrString;
+    /** Text wrapping mode/ Режим переноса текста */
+    wrap?: 'soft' | 'hard' | 'off' | string;
+    /** Automatic field sizing mode (CSS field-sizing)/ Режим автоизменения размера (CSS field-sizing) */
+    fieldSizing?: 'content' | 'fixed' | string;
+}
+/**
+ * Props for select elements (single & multiple)/
+ * Свойства для select элементов (одиночный и множественный выбор)
+ */
+export interface FieldSelectProps<Value = any> extends Omit<FieldBasicProps<Value>, 'type'>, Omit<FieldStepProps, 'min' | 'step'>, FieldArrowProps, FieldUxProps {
+    option?: ListRecord;
+    /** Multiple selection mode/ Режим множественного выбора */
+    multiple?: boolean;
+}
+/**
+ * All possible field properties combined/
+ * Все возможные свойства поля в одном интерфейсе
+ */
+export interface FieldAllProps<Value = any> extends FieldInputProps<Value>, FieldInputFileProps<Value>, FieldInputCheckProps<Value>, FieldTextareaProps<Value>, FieldSelectProps<Value> {
+}

package/dist/types/labelTypes.d.ts

@@ -0,0 +1,61 @@
+import { NumberOrString } from '@dxtmisha/functional';
+/**
+ * Exposed properties for label components/ Экспонируемые свойства для компонентов меток
+ */
+export interface LabelExpose {
+    /** Label element ID/ Идентификатор элемента метки */
+    labelId: string;
+}
+/**
+ * Slot definitions for label components/ Определения слотов для компонентов меток
+ */
+export interface LabelSlots {
+    /** Default slot content/ Содержимое слота по умолчанию */
+    default?(props: any): any;
+}
+/**
+ * Alternative slot definitions for label components/ Альтернативные определения слотов для компонентов меток
+ */
+export interface LabelAlternativeSlots {
+    /** Label slot content/ Содержимое слота метки */
+    label?(props: any): any;
+}
+/**
+ * Slot definitions for numeric label components/ Определения слотов для числовых компонентов меток
+ */
+export interface LabelNumberSlots extends LabelSlots {
+}
+/**
+ * Slot definitions for highlighted label components/ Определения слотов для компонентов меток с подсветкой
+ */
+export interface LabelHighlightSlots extends LabelSlots {
+}
+/**
+ * Properties for label components/ Свойства для компонентов меток
+ */
+export interface LabelProps {
+    /** Label text or number/ Текст или число метки */
+    label?: NumberOrString;
+    /** Label element ID/ Идентификатор элемента метки */
+    labelId?: string;
+}
+/**
+ * Properties for numeric label components/ Свойства для числовых компонентов меток
+ */
+export interface LabelNumberProps extends LabelProps {
+    /** Maximum value for the label/ Максимальное значение для метки */
+    labelMax?: NumberOrString;
+    /** Enable number formatting/ Включить форматирование чисел */
+    formatting?: boolean;
+}
+/**
+ * Properties for highlighted label components/ Свойства для компонентов меток с подсветкой
+ */
+export interface LabelHighlightProps extends LabelProps {
+    /** Text to highlight/ Текст для подсветки */
+    highlight?: string;
+    /** Starting length for highlight/ Начальная длина для подсветки */
+    highlightLengthStart?: number;
+    /** Current value/ Текущее значение */
+    value?: any;
+}

package/dist/types/modelTypes.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Event signatures for model updates/
+ * Сигнатуры событий для обновления модели
+ */
+export type ModelEmits<Value = string> = {
+    /** Update value event/ Событие обновления значения */
+    'update:value': [value: Value];
+    /** Update model value event/ Событие обновления значения модели */
+    'update:modelValue': [value: Value];
+};
+export type ModelEmitsSelected<Value = string> = {
+    /** Update value event/ Событие обновления значения */
+    'update:selected': [value: Value];
+    /** Update model value event/ Событие обновления значения модели */
+    'update:modelSelected': [value: Value];
+};
+/**
+ * Props for model value used with v-model/
+ * Свойства для значения модели, используемого с v-model
+ */
+export interface ModelProps<Value = string> {
+    /** Model value prop/ Свойство значения модели */
+    'modelValue'?: Value;
+    /** Update value handler/ Обработчик обновления значения */
+    'onUpdate:value'?: (value: Value) => void;
+    /** Update model value handler/ Обработчик обновления значения модели */
+    'onUpdate:modelValue'?: (value: Value) => void;
+}
+export interface ModelPropsSelected<Value = string> {
+    /** Model value prop/ Свойство значения модели */
+    'modelSelected'?: Value;
+    /** Update value handler/ Обработчик обновления значения */
+    'onUpdate:selected'?: (value: Value) => void;
+    /** Update model value handler/ Обработчик обновления значения модели */
+    'onUpdate:modelSelected'?: (value: Value) => void;
+}

package/dist/types/prefixTypes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Slots for prefix functionality/ Слоты для функциональности префикса
+ */
+export interface PrefixSlots {
+    /** Prefix slot/ Слот префикса */
+    prefix?(props: any): any;
+}
+/**
+ * Props for prefix functionality/ Пропсы для функциональности префикса
+ */
+export interface PrefixProps {
+    /** Prefix text or number/ Текст или число префикса */
+    prefix?: string | number;
+}

package/dist/types/roleTypes.d.ts

@@ -0,0 +1 @@
+export type RoleType = string | 'alert' | 'alertdialog' | 'application' | 'article' | 'banner' | 'button' | 'cell' | 'checkbox' | 'columnheader' | 'combobox' | 'command' | 'comment' | 'complementary' | 'composite' | 'contentinfo' | 'definition' | 'dialog' | 'directory' | 'document' | 'feed' | 'figure' | 'form' | 'generic' | 'grid' | 'gridcell' | 'group' | 'heading' | 'img' | 'input' | 'landmark' | 'link' | 'list' | 'listbox' | 'listitem' | 'log' | 'main' | 'mark' | 'marquee' | 'math' | 'menu' | 'menubar' | 'menuitem' | 'menuitemcheckbox' | 'menuitemradio' | 'meter' | 'navigation' | 'none' | 'note' | 'option' | 'presentation' | 'progressbar' | 'radio' | 'radiogroup' | 'range' | 'region' | 'roletype' | 'row' | 'rowgroup' | 'rowheader' | 'scrollbar' | 'search' | 'searchbox' | 'section' | 'sectionhead' | 'select' | 'separator' | 'slider' | 'spinbutton' | 'status' | 'structure' | 'suggestion' | 'switch' | 'tab' | 'table' | 'tablist' | 'tabpanel' | 'term' | 'textbox' | 'timer' | 'toolbar' | 'tooltip' | 'tree' | 'treegrid' | 'treeitem' | 'widget' | 'window';

package/dist/types/suffixTypes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Slots for suffix functionality/ Слоты для функциональности суффикса
+ */
+export interface SuffixSlots {
+    /** Suffix slot/ Слот суффикса */
+    suffix?(props: any): any;
+}
+/**
+ * Props for suffix functionality/ Пропсы для функциональности суффикса
+ */
+export interface SuffixProps {
+    /** Suffix text or number/ Текст или число суффикса */
+    suffix?: string | number;
+}

package/dist/types/textTypes.d.ts

@@ -0,0 +1,21 @@
+export type TextValue = string | (() => string) | undefined;
+export type TextIndex = 'close' | 'entriesMatch' | 'ok' | string;
+export type TextList = Record<TextIndex, TextValue>;
+export interface TextClosePropsInclude {
+    /** Close text/ Текст закрытия */
+    textClose?: TextValue;
+}
+export interface TextCopiedClipboardPropsInclude {
+    /** Copied to the clipboard text/ Текст о копировании в буфер обмена */
+    textCopiedClipboard?: TextValue;
+}
+export interface TextEntriesMatchPropsInclude {
+    /** Text entries match/ Текст о несовпадении записей */
+    textEntriesMatch?: TextValue;
+}
+export interface TextOkPropsInclude {
+    /** OK text/ Текст подтверждения */
+    textOk?: TextValue;
+}
+export interface TextAllPropsInclude extends TextClosePropsInclude, TextCopiedClipboardPropsInclude, TextEntriesMatchPropsInclude, TextOkPropsInclude {
+}

package/dist/types/touchEventTypes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Horizontal direction type for touch/mouse gestures/ Тип горизонтального направления для жестов касания/мыши
+ */
+export type TouchEventTypeX = 'left' | 'right' | 'none';
+/**
+ * Vertical direction type for touch/mouse gestures/ Тип вертикального направления для жестов касания/мыши
+ */
+export type TouchEventTypeY = 'top' | 'bottom' | 'none';
+/**
+ * Client coordinates for touch/mouse events/ Координаты клиента для событий касания/мыши
+ */
+export type TouchEventClient = {
+    /** Horizontal coordinate/ Горизонтальная координата */
+    x: number;
+    /** Vertical coordinate/ Вертикальная координата */
+    y: number;
+};
+/**
+ * Callback function for touch/mouse event handling
+ *
+ * Функция обратного вызова для обработки событий касания/мыши
+ * @param typeX horizontal direction type/ тип горизонтального направления
+ * @param typeY vertical direction type/ тип вертикального направления
+ * @param clientX horizontal offset/ горизонтальное смещение
+ * @param clientY vertical offset/ вертикальное смещение
+ * @param mouse initial mouse position/ начальная позиция мыши
+ * @param mouseMove current mouse position/ текущая позиция мыши
+ * @param touche initial touch point/ начальная точка касания
+ * @param toucheMove current touch point/ текущая точка касания
+ */
+export type TouchEventCallback = (typeX: TouchEventTypeX, typeY: TouchEventTypeY, clientX: number, clientY: number, mouse?: TouchEventClient, mouseMove?: TouchEventClient, touche?: Touch, toucheMove?: Touch) => Promise<boolean> | boolean;