@dxtmisha/constructor 0.23.0

package/src/functions/getClassTegAStatic.ts

@@ -0,0 +1,8 @@
+/**
+ * Generates CSS class for tag 'a' without any static styles.
+ *
+ * Генерирует CSS класс для тега 'a' без каких-либо статических стилей.
+ * @param design design system prefix/ префикс дизайн-системы
+ * @returns CSS class string/ строка CSS класса
+ */
+export const getClassTegAStatic = (design: string) => `${design}-a--static`

package/src/library.ts

@@ -0,0 +1,36 @@
+// Classes
+export * from './classes/CaptionInclude'
+export * from './classes/DescriptionInclude'
+export * from './classes/EnabledInclude'
+export * from './classes/EventClickInclude'
+export * from './classes/LabelHighlightInclude'
+export * from './classes/LabelInclude'
+export * from './classes/LabelNumberInclude'
+export * from './classes/ModelInclude'
+export * from './classes/PrefixInclude'
+export * from './classes/SuffixInclude'
+export * from './classes/field/FieldAttributesInclude'
+export * from './classes/field/FieldChangeInclude'
+export * from './classes/field/FieldCodeInclude'
+export * from './classes/field/FieldElementInclude'
+export * from './classes/field/FieldInputCheckInclude'
+export * from './classes/field/FieldMatchInclude'
+export * from './classes/field/FieldPatternInclude'
+export * from './classes/field/FieldTypeInclude'
+export * from './classes/field/FieldValidationInclude'
+export * from './classes/field/FieldValueInclude'
+export * from './classes/field/FieldVisibilityInclude'
+
+// Functions
+export * from './functions/getClassTegAStatic'
+
+// Types
+export * from './types/captionTypes'
+export * from './types/descriptionTypes'
+export * from './types/enabledTypes'
+export * from './types/eventClickTypes'
+export * from './types/fieldTypes'
+export * from './types/labelTypes'
+export * from './types/modelTypes'
+export * from './types/prefixTypes'
+export * from './types/suffixTypes'

package/src/types/captionTypes.ts

@@ -0,0 +1,15 @@
+/**
+ * Slots for caption functionality/ Слоты для функциональности заголовка
+ */
+export interface CaptionSlots {
+  /** Caption slot/ Слот заголовка */
+  caption?(props: any): any
+}
+
+/**
+ * Props for caption functionality/ Пропсы для функциональности заголовка
+ */
+export interface CaptionProps {
+  /** Caption text or number/ Текст или число заголовка */
+  caption?: string | number
+}

package/src/types/descriptionTypes.ts

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

package/src/types/enabledTypes.ts

@@ -0,0 +1,9 @@
+/**
+ * Props for enabled/disabled state functionality/ Пропсы для функциональности состояния включено/выключено
+ */
+export interface EnabledProps {
+  /** Read-only state/ Состояние только для чтения */
+  readonly?: boolean
+  /** Disabled state/ Состояние отключено */
+  disabled?: boolean
+}

package/src/types/eventClickTypes.ts

@@ -0,0 +1,51 @@
+import type { Ref } from 'vue'
+import type { RouteLocationRaw } from 'vue-router'
+
+/**
+ * Value object for click events/ Объект значения для событий клика
+ */
+export type EventClickValue = {
+  /** Event type/ Тип события */
+  type: string
+  /** Event value/ Значение события */
+  value: any
+  /** Additional event details/ Дополнительные детали события */
+  detail: Record<string, any> | undefined
+}
+
+/**
+ * Emits for click event handling/ События для обработки кликов
+ */
+export type EventClickEmits = {
+  /** Full click event with MouseEvent/ Полное событие клика с MouseEvent */
+  click: [
+    event: MouseEvent,
+    value: EventClickValue
+  ]
+  /** Lightweight click event/ Упрощённое событие клика */
+  clickLite: [
+    value: EventClickValue
+  ]
+}
+
+/**
+ * Exposed properties for click functionality/ Экспонируемые свойства для функциональности клика
+ */
+export interface EventClickExpose {
+  /** Reactive value reference/ Реактивная ссылка на значение */
+  value?: Ref<EventClickValue['value']>
+  /** Reactive detail reference/ Реактивная ссылка на детали */
+  detail?: Ref<EventClickValue['detail']>
+}
+
+/**
+ * Props for click event handling/ Пропсы для обработки событий клика
+ */
+export interface EventClickProps {
+  /** Navigation target (string or route object)/ Цель навигации (строка или объект роута) */
+  to?: string | RouteLocationRaw
+  /** Click event value/ Значение события клика */
+  value?: EventClickValue['value']
+  /** Additional click event details/ Дополнительные детали события клика */
+  detail?: EventClickValue['detail']
+}

package/src/types/fieldTypes.ts

@@ -0,0 +1,282 @@
+import type { NumberOrString } from '@dxtmisha/functional'
+import type { ModelProps } from './modelTypes'
+
+/** 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>
+    }
+
+/**
+ * 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
+}
+
+/**
+ * Basic HTML input attributes without value-length specifics/
+ * Базовые HTML атрибуты инпута без ограничений длины и multiple
+ */
+export interface FieldBasicProps<Value = any>
+  extends Omit<FieldValueProps<Value>, 'multiple' | 'maxlength'> {
+  /** Input type/ Тип инпута */
+  type?: string
+  /** Input name attribute/ Атрибут name */
+  name?: string
+  /** Input id attribute/ Атрибут id */
+  id?: string
+
+  /** 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
+}
+
+/**
+ * Text length constraints (characters, items)/
+ * Ограничения длины текста (символы, элементы)
+ */
+export interface FieldLength {
+  /** Minimum length/ Минимальная длина */
+  minlength?: NumberOrString
+  /** Maximum length/ Максимальная длина */
+  maxlength?: NumberOrString
+}
+
+/**
+ * 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, FieldLength, FieldUxProps {
+  /** Validation pattern (regexp)/ Паттерн валидации (рег. выражение) */
+  pattern?: string
+  /** Datalist id reference/ Ссылка на datalist */
+  list?: string
+}
+
+/**
+ * Props for file input elements (type="file")/
+ * Свойства для инпутов выбора файлов (type="file")
+ */
+export interface FieldInputFileProps<Value = any>
+  extends Omit<FieldBasicProps<Value>, 'type'>, FieldLength, 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
+
+  /** Show number input arrows (type="number" only)/ Показать стрелки числового ввода (только для type="number") */
+  arrow?: string
+}
+
+/**
+ * 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'>, FieldLength, 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'> {
+  /** 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/src/types/labelTypes.ts

@@ -0,0 +1,30 @@
+import type { NumberOrString } from '@dxtmisha/functional'
+
+export interface LabelSlots {
+  default?(props: any): any
+}
+
+export interface LabelAlternativeSlots {
+  label?(props: any): any
+}
+
+export interface LabelNumberSlots extends LabelSlots {
+}
+
+export interface LabelHighlightSlots extends LabelSlots {
+}
+
+export interface LabelProps {
+  label?: NumberOrString
+}
+
+export interface LabelNumberProps extends LabelProps {
+  labelMax?: NumberOrString
+  formatting?: boolean
+}
+
+export interface LabelHighlightProps extends LabelProps {
+  highlight?: string
+  highlightLengthStart?: number
+  value?: any
+}

package/src/types/modelTypes.ts

@@ -0,0 +1,23 @@
+/**
+ * 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]
+}
+
+/**
+ * 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
+}

package/src/types/prefixTypes.ts

@@ -0,0 +1,15 @@
+/**
+ * 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/src/types/suffixTypes.ts

@@ -0,0 +1,15 @@
+/**
+ * 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/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />