@dxtmisha/functional 1.0.9

package/dist/types/basicTypes.d.ts

@@ -0,0 +1,126 @@
+/** Union type for undefined and null values/ Объединенный тип для undefined и null значений */
+export type Undefined = undefined | null;
+/**
+ * Union type for all "empty" values including falsy primitives and string representations/
+ * Объединенный тип для всех "пустых" значений включая ложные примитивы и строковые представления
+ */
+export type EmptyValue = Undefined | 0 | false | '' | 'undefined' | 'null' | '0' | 'false' | '[]';
+/** Union type for numeric and string values/ Объединенный тип для числовых и строковых значений */
+export type NumberOrString = number | string;
+/**
+ * Union type for numeric, string, and boolean values/
+ * Объединенный тип для числовых, строковых и булевых значений
+ */
+export type NumberOrStringOrBoolean = number | string | boolean;
+/**
+ * Union type for numeric, string, and Date values/
+ * Объединенный тип для числовых, строковых значений и Date
+ */
+export type NumberOrStringOrDate = NumberOrString | Date;
+/**
+ * Generic type that can be either a single value or an array of values/
+ * Дженерик тип для одиночного значения или массива значений
+ */
+export type NormalOrArray<T = NumberOrString> = T | T[];
+/**
+ * Generic type that can be either a direct value or a Promise resolving to that value/
+ * Дженерик тип для прямого значения или Promise
+ */
+export type NormalOrPromise<T> = T | Promise<T>;
+/**
+ * Generic record/object type with string keys/
+ * Дженерик тип записи/объекта со строковыми ключами
+ */
+export type ObjectItem<T = any> = Record<string, T>;
+/** Generic type that can be either an array or an object/ Дженерик тип для массива или объекта */
+export type ObjectOrArray<T = any> = T[] | ObjectItem<T>;
+/**
+ * Function type that returns a value of type R/
+ * Тип функции, возвращающей значение типа R
+ */
+export type FunctionReturn<R = any> = () => R;
+/** Function type that returns void/ Тип функции, возвращающей void */
+export type FunctionVoid = () => void;
+/**
+ * Function type that accepts multiple arguments of type T and returns type R/
+ * Тип функции с переменными аргументами
+ */
+export type FunctionArgs<T, R> = (...args: T[]) => R;
+/**
+ * Most generic function type that accepts any arguments and returns any value/
+ * Наиболее общий тип функции
+ */
+export type FunctionAnyType<T = any, R = any> = (...args: T[]) => R;
+/**
+ * Generic record type for lists with string keys/
+ * Дженерик тип записи для списков со строковыми ключами
+ */
+export type ItemList<T = any> = Record<string, T>;
+/**
+ * Generic item type with index and value properties/
+ * Дженерик тип элемента со свойствами index и value
+ */
+export type Item<V> = {
+    /** Unique string identifier for the item/ Уникальный строковый идентификатор элемента */
+    index: string;
+    /** The actual value of the item/ Фактическое значение элемента */
+    value: V;
+};
+/**
+ * Generic item type with label and value properties/
+ * Дженерик тип элемента со свойствами label и value
+ */
+export type ItemValue<V> = {
+    /** Display text for the item/ Отображаемый текст для элемента */
+    label: string;
+    /** The actual value of the item/ Фактическое значение элемента */
+    value: V;
+};
+/**
+ * Generic item type with name and value properties/
+ * Дженерик тип элемента со свойствами name и value
+ */
+export type ItemName<V> = {
+    /** Name identifier (string or number)/ Идентификатор имени (строка или число) */
+    name: string | number;
+    /** The actual value of the item/ Фактическое значение элемента */
+    value: V;
+};
+/**
+ * Union type for HTML elements and Window object/
+ * Объединенный тип для HTML элементов и объекта Window
+ */
+export type ElementOrWindow = HTMLElement | Window;
+/**
+ * Generic type that can be either an element or a string selector/
+ * Дженерик тип для элемента или строкового селектора
+ */
+export type ElementOrString<E extends ElementOrWindow> = E | string;
+/** Type for event listener options/ Тип для опций обработчика событий */
+export type EventOptions = AddEventListenerOptions | boolean | undefined;
+/**
+ * Generic event listener function type with additional detail parameter/
+ * Дженерик тип функции обработчика событий с дополнительным параметром detail
+ */
+export type EventListenerDetail<O extends Event, D extends Record<string, any>> = (event: O, detail?: D) => void;
+/**
+ * Type for tracking active event listeners and observers/
+ * Тип для отслеживания активных обработчиков событий и наблюдателей
+ */
+export type EventActivityItem<E extends ElementOrWindow> = {
+    /** The target element for the event/ Целевой элемент для события */
+    element: E | undefined;
+    /** The event type name/ Название типа события */
+    type: string;
+    /** Optional custom event listener/ Опциональный пользовательский обработчик событий */
+    listener?: (event: any | Event) => void;
+    /** Optional ResizeObserver instance/ Опциональный экземпляр ResizeObserver */
+    observer?: ResizeObserver;
+};
+/** Type for 2D coordinates/ Тип для 2D координат */
+export type ImageCoordinator = {
+    /** X-axis coordinate/ Координата по оси X */
+    x: number;
+    /** Y-axis coordinate/ Координата по оси Y */
+    y: number;
+};

package/dist/types/constructorTypes.d.ts

@@ -0,0 +1,114 @@
+import { Ref, PropType } from 'vue';
+import { Undefined } from './basicTypes';
+import { RefOrNormal, RefType } from './refTypes';
+/** Generic record type for constructor items/ Дженерик тип записи для элементов конструктора */
+export type ConstrItem = Record<string, any>;
+/** Constructor value wrapper with optional value property/ Обертка значения конструктора с опциональным свойством value */
+export type ConstrValue<T = any> = {
+    /** Optional value of type T/ Опциональное значение типа T */
+    value?: T;
+};
+/** Generic record type for constructor components/ Дженерик тип записи для компонентов конструктора */
+export type ConstrComponent = Record<string, any>;
+/**
+ * Constructor component modification type with reactive or normal values/
+ * Тип модификации компонента конструктора с реактивными или обычными значениями
+ */
+export type ConstrComponentMod<P extends ConstrItem> = ConstrItem | {
+    [K in keyof P]?: RefOrNormal<P[K]>;
+};
+/** Utility type to convert union types to intersection types/ Утилитарный тип д��я преобразования объединенных типов в пересеченные */
+export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/** Extract emit item type from constructor item/ Извлечение типа элемен��а emit из элемента конструктора */
+export type ConstrEmitItem<T extends ConstrItem> = T[keyof T];
+/**
+ * Constructor emit type with proper event handler signatures/
+ * Тип emit конструктора с правильными сигнатурами обработчиков событий
+ */
+export type ConstrEmit<T extends ConstrItem = ConstrItem> = UnionToIntersection<ConstrEmitItem<{
+    [K in keyof T]: (evt: K, ...args: T[K]) => void;
+}>>;
+/** Object type for CSS class names with boolean values/ Тип объекта для CSS классов с булевыми значениями */
+export type ConstrClassObject = Record<string, boolean>;
+/**
+ * Constructor class type supporting strings, arrays, and objects/
+ * Тип класса конструктора, поддерживающий строки, массивы и объекты
+ */
+export type ConstrClass = string | (string | ConstrClass | Undefined)[] | ConstrClassObject;
+/** Record type for mapping class names to class definitions/ Тип записи для сопоставления имен классов с определениями классов */
+export type ConstrClassList = Record<string, ConstrClass>;
+/** Constructor classes with required main class and additional class list/ Классы конструктора с обязательным основным классом и дополнительным списком классов */
+export type ConstrClasses = {
+    main: ConstrClass;
+} & ConstrClassList;
+/** Constructor style item type for individual style properties/ Тип элемента стиля конструктора для отдельных свойств стиля */
+export type ConstrStylesItem = string | null;
+/**
+ * Constructor styles type supporting objects and arrays of style definitions/
+ * Тип стилей конструктора, поддерживающий объекты и массивы определений стилей
+ */
+export type ConstrStyles = Record<string, ConstrStylesItem> | ConstrStyles[];
+/**
+ * Constructor options interface for component configuration/
+ * Интерфейс опций конструктора для конфигурации компонента
+ */
+export type ConstrOptions<COMP extends ConstrComponent, EMITS extends ConstrItem, P extends ConstrItem> = {
+    /** Optional components configuration/ Опциональная конфигурация компонентов */
+    components?: COMP;
+    /** Optional component modifications/ Опциональные модификации компонента */
+    compMod?: ConstrComponentMod<P>;
+    /** Optional emit handlers/ Опциональные обработчики emit */
+    emits?: ConstrEmit<EMITS>;
+    /** Optional reactive classes/ Опциональные реактивные классы */
+    classes?: RefType<ConstrClasses>;
+    /** Optional reactive styles/ Опциональные реактивные стили */
+    styles?: RefType<ConstrStyles>;
+};
+/**
+ * Constructor setup interface for component initialization/
+ * Интерфейс настройки конструктора для инициализации компонента
+ */
+export type ConstrSetup<E extends Element, CLASSES extends ConstrClasses, SETUP extends ConstrItem> = {
+    /** Component name/ Имя компонента */
+    name: string;
+    /** Reactive element reference/ Реактивная ссылка на элемент */
+    element: Ref<E | undefined>;
+    /** Reactive classes/ Реактивные классы */
+    classes: RefType<CLASSES>;
+    /** Reactive styles/ Реактивные стили */
+    styles: RefType<ConstrStyles>;
+} & SETUP;
+/** Constructor registration configuration/ Конфигурация регистрации конструктора */
+export type ConstrRegistration = {
+    /** Optional flag for registration/ Опциональный флаг для регистрации */
+    flag?: boolean;
+    /** Optional translation map/ Опциональная карта переводов */
+    translate?: Record<string, string>;
+};
+/**
+ * Constructor bind type for component binding with class and style support/
+ * Тип привязки конструктора для привязки компонента с поддержкой классов и стилей
+ */
+export type ConstrBind<T> = T & Record<string, any> & {
+    /** Optional CSS classes/ Опциональные CSS классы */
+    class?: ConstrClass;
+    /** Optional styles/ Опциональные стили */
+    style?: ConstrStyles;
+};
+/** Constructor prop item options for Vue prop definitions/ Опции элемента prop конструктора для определений Vue prop */
+export type ConstrPropItemOptions<T = any> = {
+    /** Vue prop type/ Тип Vue prop */
+    type?: PropType<T>;
+    /** Required flag/ Флаг обязательности */
+    required?: boolean;
+    /** Default value/ Значение по умолчанию */
+    default?: any;
+    /** Custom validator function/ Пользовательская функция валидации */
+    validator?(value: any, props: any): boolean;
+};
+/** Constructor prop item type with options or direct PropType/ Тип элемента prop конструктора с опциями или прямым PropType */
+export type ConstrPropItem<T = any> = ConstrPropItemOptions<T> | PropType<T>;
+/** Constructor props type for component prop definitions/ Тип props конструктора для определений props компонента */
+export type ConstrProps<P = Record<string, any>> = {
+    [K in keyof P]: ConstrPropItem<P[K]>;
+};

package/dist/types/geoTypes.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Union type for date format options in geographic context/
+ * Объединенный тип для опций формата даты в географическом контексте
+ */
+export type GeoDate = 'full' | 'datetime' | 'date' | 'year-month' | 'year' | 'month' | 'day' | 'day-month' | 'time' | 'hour-minute' | 'hour' | 'minute' | 'second';
+/** First day of week code (0=Sunday, 1=Monday, 6=Saturday)/ Код первого дня недели (0=воскресенье, 1=понедельник, 6=суббота) */
+export type GeoFirstDay = 1 | 6 | 0;
+/** Hour format type (12-hour or 24-hour)/ Тип формата часов (12-часовой или 24-часовой) */
+export type GeoHours = '12' | '24';
+/** Timezone display style options/ Опции стиля отображения часового пояса */
+export type GeoTimeZoneStyle = 'minute' | 'hour' | 'ISO8601' | 'RFC';
+/** Geographic item interface for country and language data/ Интерфейс географического элемента для данных страны и языка */
+export interface GeoItem {
+    /** Country code/ Код страны */
+    country: string;
+    /** Alternative country codes/ Альтернативные коды стран */
+    countryAlternative?: string[];
+    /** Language code/ Код языка */
+    language: string;
+    /** Alternative language codes/ Альтернативные коды языков */
+    languageAlternative?: string[];
+    /** First day of week/ Первый день недели */
+    firstDay?: string | null;
+    /** Timezone/ Часовой пояс */
+    zone?: string | null;
+    /** Phone country code/ Телефонный код страны */
+    phoneCode?: string;
+    /** Phone code for domestic calls/ Телефонный код для внутренних звонков */
+    phoneWithin?: string;
+    /** Phone number mask/ Маска телефонного номера */
+    phoneMask?: string | string[];
+    /** Name format pattern/ Шаблон формата имени */
+    nameFormat?: 'fl' | 'fsl' | 'lf' | 'lsf' | string;
+}
+/** Extended geographic item with required fields/ Расширенный географический элемент с обязательными полями */
+export interface GeoItemFull extends Omit<GeoItem, 'firstDay'> {
+    /** Standard locale code/ Стандартный код локали */
+    standard: string;
+    /** First day of week (required)/ Первый день недели (обязательный) */
+    firstDay: string;
+}
+/** Geographic flag item for country flag display/ Элемент географического флага для отображения флага страны */
+export interface GeoFlagItem {
+    /** Language name/ Название языка */
+    language: string;
+    /** Country name/ Название страны */
+    country: string;
+    /** Standard locale code/ Стандартный код локали */
+    standard: string;
+    /** Flag icon identifier/ Идентификатор иконки флага */
+    icon?: string;
+    /** Display label/ Отображаемая метка */
+    label: string;
+    /** Value for selection/ Значение для выбора */
+    value: string;
+}
+/**
+ * Extended geographic flag item with national language information/
+ * Расширенный элемент географического флага с информацией о национальном языке
+ */
+export interface GeoFlagNational extends GeoFlagItem {
+    /** Description in national language/ Описание на национальном языке */
+    description: string;
+    /** Language name in national language/ Название языка на национальном языке */
+    nationalLanguage: string;
+    /** Country name in national language/ Название страны на национальном языке */
+    nationalCountry: string;
+}
+export interface GeoPhoneValue {
+    phone: number;
+    within: number;
+    mask: string[];
+    value: string;
+}
+export interface GeoPhoneMap {
+    items: GeoPhoneValue[];
+    info: GeoPhoneValue | undefined;
+    value: string | undefined;
+    mask: string[];
+    maskFull: string[];
+    next: Record<string, GeoPhoneMap>;
+}
+export interface GeoPhoneMapInfo {
+    item?: GeoPhoneMap;
+    phone?: string;
+}

package/dist/types/listTypes.d.ts

@@ -0,0 +1,61 @@
+import { ConstrBind } from './constructorTypes';
+import { NumberOrString, NumberOrStringOrBoolean } from './basicTypes';
+/** Type of list item/ Тип элемента списка */
+export type ListType = 'item' | 'space' | 'line' | 'subtitle' | 'html' | 'menu' | 'menu-group' | 'group';
+/** Basic data structure for list item/ Базовая структура данных для элемента списка */
+export type ListDataBasic = {
+    /** Optional display label/ Опциональная отображаемая метка */
+    label?: NumberOrString;
+    /** Any value associated with the item/ Любое значение, связанное с элементом */
+    value?: any;
+    /** Search text for filtering/ Текст поиска для фильтрации */
+    search?: string;
+};
+/** Extended list item with type and index/ Расширенный элемент списка с типом и индексом */
+export type ListDataItem<Item extends ListDataBasic = ListDataBasic> = ConstrBind<Item & {
+    /** Parent item identifier/ Идентификатор родительского элемента */
+    parent?: string;
+    /** Type of list item/ Тип элемента списка */
+    type: ListType;
+    /** Unique item identifier/ Уникальный идентификатор элемента */
+    index: string;
+}>;
+/** Array of list data items/ Массив элементов данных списка */
+export type ListList<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item>[];
+/**
+ * List or record structure for list data/
+ * Структура списка или записи для данных списка
+ */
+export type ListRecord<Item extends ListDataBasic = ListDataBasic> = ListList<Item> | Record<string, any>;
+/**
+ * Extended list item with additional state properties/
+ * Расширенный элемент списка с дополнительными свойствами состояния
+ */
+export type ListDataFullItem<Item extends ListDataBasic = ListDataBasic> = ListDataItem<Item> & {
+    /** Whether the item has focus/ Имеет ли элемент фокус */
+    focus: boolean;
+    /** Highlighted text portion/ Выделенная часть текста */
+    highlight?: string;
+    /** Whether the item is selected/ Выбран ли элемент */
+    selected: boolean;
+};
+/**
+ * Array of extended list items with state/
+ * Массив расширенных элементов списка с состоянием
+ */
+export type ListDataFull<Item extends ListDataBasic = ListDataBasic> = ListDataFullItem<Item>[];
+/** Input item for list creation/ Входной элемент для создания списка */
+export type ListListInputItem<Item extends ListDataBasic = ListDataBasic> = ConstrBind<Item>;
+/**
+ * Various input formats for list creation/
+ * Различные форматы входных данных для создания списка
+ */
+export type ListListInput<Item extends ListDataBasic = ListDataBasic> = ListListInputItem<Item>[] | string[] | Record<string, ListListInputItem<Item>> | Record<string, string>;
+/** Single selected item identifier/ Идентификатор одного выбранного элемента */
+export type ListSelectedItem = NumberOrStringOrBoolean;
+/** Single or multiple selected items/ Один или несколько выбранных элементов */
+export type ListSelectedList = ListSelectedItem | ListSelectedItem[];
+/** Name of selected list item/ Название выбранного элемента списка */
+export type ListName = string | number | undefined;
+/** Array of list item names/ Массив названий выбранных элементов списка */
+export type ListNames = ListName[];

package/dist/types/refTypes.d.ts

@@ -0,0 +1,36 @@
+import { ComputedRef, Ref, VNode, VNodeArrayChildren } from 'vue';
+/**
+ * Union type for Vue reactive references (computed or ref)/
+ * Объединенный тип для Vue реактивных ссылок (computed или ref)
+ */
+export type RefType<T> = ComputedRef<T> | Ref<T>;
+/**
+ * Union type for Vue reactive references that can be undefined/
+ * Объединенный тип для Vue реактивных ссылок, которые могут быть undefined
+ */
+export type RefUndefined<T> = RefType<T | undefined>;
+/**
+ * Union type that can be either a Vue reactive reference or a normal value/
+ * Объединенный тип, который может быть либо Vue реактивной ссылкой, либо обычным значением
+ */
+export type RefOrNormal<T> = RefType<T> | T;
+/**
+ * Union type for Vue raw children content
+ * (strings, numbers, booleans, VNodes, arrays, functions)/
+ * Объединенный тип для Vue сырого содержимого дочерних элементов
+ * (строки, числа, булевы, VNode, массивы, функции)
+ */
+export type RawChildren = string | number | boolean | VNode | VNodeArrayChildren | (() => any);
+/**
+ * Type for Vue raw slots with optional stability flag/
+ * Тип для Vue сырых слотов с опциональным флагом стабильности
+ */
+export type RawSlots = {
+    /** Slot name mapping to unknown content/ Маппинг имени слота к неизвестному содержимому */
+    [name: string]: unknown;
+    /**
+     * Optional stability flag for performance optimization/
+     * Опциональный флаг стабильности для оптимизации производительности
+     */
+    $stable?: boolean;
+};

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@dxtmisha/functional",
+  "private": false,
+  "version": "1.0.9",
+  "type": "module",
+  "description": "Comprehensive functional utilities library for DXT UI - classes, composables, functions and types for modern web development",
+  "keywords": [
+    "functional",
+    "utilities",
+    "helpers",
+    "typescript",
+    "vue",
+    "composables",
+    "classes",
+    "geo",
+    "datetime",
+    "cache",
+    "api",
+    "ui",
+    "dxt"
+  ],
+  "author": "dxtmisha@gmail.com",
+  "license": "MIT",
+  "homepage": "https://github.com/dxtmisha/dxt-ui/tree/main/packages/functional",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dxtmisha/dxt-ui.git",
+    "directory": "packages/functional"
+  },
+  "bugs": {
+    "url": "https://github.com/dxtmisha/dxt-ui/issues"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vue-tsc -b && vite build",
+    "preview": "vite preview",
+    "test": "vitest",
+    "library": "dxt-library",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json",
+    "LICENSE"
+  ],
+  "main": "dist/library.js",
+  "module": "dist/library.js",
+  "types": "dist/library.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/library.js",
+      "types": "./dist/library.d.ts"
+    },
+    "./flags": {
+      "import": "./dist/flags.js",
+      "types": "./dist/flags.d.ts"
+    },
+    "./types/*": "./dist/*"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@dxtmisha/media": ">=0.3.0",
+    "vue": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@dxtmisha/media": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "dependencies": {}
+}