@dxtmisha/functional 1.6.5 → 1.6.6

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dxtmisha/functional",
   "private": false,
-  "version": "1.6.5",
+  "version": "1.6.6",
   "type": "module",
   "description": "Comprehensive functional utilities library for DXT UI - classes, composables, functions and types for modern web development",
   "keywords": [

package/dist/classes/design/DesignAbstract.d.ts

@@ -1,61 +0,0 @@
-import { DesignChanged } from './DesignChanged';
-/**
- * Base class for working with the constructor.
- *
- * Базовый класс для работы с конструктором.
- */
-export declare abstract class DesignAbstract<T extends Record<string, any>, C extends Record<string, any>> {
-    protected readonly props: T;
-    protected readonly callback?: ((event: C) => void) | undefined;
-    protected readonly event: C;
-    protected readonly changed: DesignChanged<T>;
-    /**
-     * Constructor
-     * @param props base data/ базовые данные
-     * @param callback callback function when the value changes/
-     * функция обратного вызова при изменении значения
-     * @param changed base data/ данный для слежения
-     */
-    constructor(props: T, callback?: ((event: C) => void) | undefined, changed?: string[]);
-    /**
-     * Calls the callback function.
-     *
-     * Вызывает функцию обратного вызова.
-     * @param compelled forces data to update/ вынуждает обновлять данные
-     */
-    make(compelled?: boolean): this;
-    /**
-     * Checks if there are values in the property.
-     *
-     * Проверяет, есть ли значения в свойстве.
-     * @param name property names/ названия свойств
-     */
-    protected is<K extends keyof T>(name: K): boolean;
-    /**
-     * Checks if the value has been changed by the property name.
-     *
-     * Проверяет, было ли изменено значение по названию свойства.
-     * @param name property names/ названия свойств
-     * @param nameProp names of properties of the input variable/ названия свойств входной переменной
-     */
-    protected isChanged<K extends keyof C & string, KT extends keyof T & string>(name: K, nameProp?: KT | KT[]): boolean;
-    /**
-     * Calls the callback function.
-     *
-     * Вызывает функцию обратного вызова.
-     * @param compelled forces data to update/ вынуждает обновлять данные
-     */
-    makeCallback(compelled?: boolean): void;
-    /**
-     * The function calls an image call.
-     *
-     * Функция вызывает образный вызов.
-     */
-    protected makeCallbackItem(): void;
-    /**
-     * A function that is called each time the input values are changed.
-     *
-     * Функция, которая вызывается каждый раз, когда изменяются входные значения.
-     */
-    protected abstract initEvent(): void;
-}

package/dist/classes/design/DesignAsyncAbstract.d.ts

@@ -1,28 +0,0 @@
-import { DesignAbstract } from './DesignAbstract';
-/**
- * Base class for working with the constructor.
- *
- * Базовый класс для работы с конструктором.
- */
-export declare abstract class DesignAsyncAbstract<T extends Record<string, any>, C extends Record<string, any>> extends DesignAbstract<T, C> {
-    /**
-     * Calls the callback function.
-     *
-     * Вызывает функцию обратного вызова.
-     * @param compelled forces data to update/ вынуждает обновлять данные
-     */
-    make(compelled?: boolean): this;
-    /**
-     * Calls the callback function.
-     *
-     * Вызывает функцию обратного вызова.
-     * @param compelled forces data to update/ вынуждает обновлять данные
-     */
-    makeCallback(compelled?: boolean): Promise<void>;
-    /**
-     * A function that is called each time the input values are changed.
-     *
-     * Функция, которая вызывается каждый раз, когда изменяются входные значения.
-     */
-    protected abstract initEvent(): Promise<void>;
-}

package/dist/classes/design/DesignChanged.d.ts

@@ -1,42 +0,0 @@
-/**
- * The class checks the values that have been edited.
- *
- * Класс проверяет значения, которые были отредактированы.
- */
-export declare class DesignChanged<T extends Record<string, any>> {
-    protected readonly props: T;
-    protected readonly watch: string[];
-    private readonly cache;
-    /**
-     * Constructor
-     * @param props base data/ базовые данные
-     * @param watch data for tracking/ данные для слежения
-     */
-    constructor(props: T, watch?: string[]);
-    /**
-     * Checks if the value has been updated.
-     *
-     * Проверяет, обновлено ли значение.
-     * @param name property name/ название свойства
-     */
-    is(name: string | string[]): boolean;
-    /**
-     * Checks if there are changes in the data.
-     *
-     * Проверяет, есть ли изменения в данных.
-     */
-    isChanged(): boolean;
-    /**
-     * Updates all values.
-     *
-     * Обновляет все значения.
-     */
-    update(): void;
-    /**
-     * Checking additional data.
-     *
-     * Проверка дополнительных данных.
-     * @param name property name/ название свойства
-     */
-    protected isDifferent(name: string): boolean;
-}

package/dist/classes/design/DesignComp.d.ts

@@ -1,4 +0,0 @@
-import { DesignComponents } from './DesignComponents';
-import { ConstrComponent, ConstrItem } from '../../types/constructorTypes';
-export declare class DesignComp<COMP extends ConstrComponent, P extends ConstrItem> extends DesignComponents<COMP, P> {
-}

package/dist/classes/design/DesignComponents.d.ts

@@ -1,81 +0,0 @@
-import { ComputedRef, VNode } from 'vue';
-import { RawChildren, RawSlots } from '../../types/refTypes';
-import { ConstrComponent, ConstrComponentMod, ConstrItem } from '../../types/constructorTypes';
-/**
- * Class for working with connected components.
- *
- * Класс для работы с подключенными компонентами.
- */
-export declare class DesignComponents<COMP extends ConstrComponent, P extends ConstrItem> {
-    protected readonly components: COMP;
-    protected readonly modification?: ConstrComponentMod<P> | undefined;
-    /** Cache for computed properties/ Кэш для вычисляемых свойств */
-    protected caching: Record<string, ComputedRef<any>>;
-    /**
-     * Constructor
-     * @param components list of connected components/ список подключенных компонентов
-     * @param modification data for modification/ данные для модификации
-     */
-    constructor(components?: COMP, modification?: ConstrComponentMod<P> | undefined);
-    /**
-     * Check the presence of the component.
-     *
-     * Проверить наличие компонента.
-     * @param name name of the component/ названия компонента
-     */
-    is<K extends keyof COMP>(name: K): name is K;
-    /**
-     * Getting the object of the component.
-     *
-     * Получение объекта компонента.
-     * @param name name of the component/ названия компонента
-     */
-    get<K extends keyof COMP>(name: K): COMP[K];
-    /**
-     * Returns the modified input data of the connected components.
-     *
-     * Возвращает модифицированные входные данные у подключенных компонентов.
-     * @param index the name of this/ название данного
-     * @param props basic data/ базовые данные
-     */
-    getModification<K extends keyof P>(index?: K & string | string, props?: P[K] | Record<string, any>): Record<string, any> | undefined;
-    /**
-     * Rendering a component by its name and returning an array with one component.
-     *
-     * Рендеринг компонента по его имени и возвращение массива с одним компонентом.
-     * @param name name of the component/ названия компонента
-     * @param props property of the component/ свойство компонента
-     * @param children sub-elements of the component/ под элементы компонента
-     * @param index the name of the key/ названия ключа
-     */
-    render<K extends keyof COMP, PK extends keyof P>(name: K & string, props?: P[PK] & ConstrItem | ConstrItem, children?: RawChildren | RawSlots, index?: PK & string | string): VNode[];
-    /**
-     * Rendering a component by its name.
-     *
-     * Рендеринг компонента по его имени.
-     * @param name name of the component/ названия компонента
-     * @param props property of the component/ свойство компонента
-     * @param children sub-elements of the component/ под элементы компонента
-     * @param index the name of the key/ названия ключа
-     */
-    renderOne<K extends keyof COMP, PK extends keyof P>(name: K & string, props?: P[PK] & ConstrItem | ConstrItem, children?: RawChildren | RawSlots, index?: PK & string | string): VNode | undefined;
-    /**
-     * Rendering the component by its name.
-     *
-     * Рендеринг компонента по его имени.
-     * @param item an array to which the rendered object will be added/
-     * массив, по которому будет добавлять объект
-     * @param name name of the component/ названия компонента
-     * @param props property of the component/ свойство компонента
-     * @param children sub-elements of the component/ под элементы компонента
-     * @param index the name of the key/ названия ключа
-     */
-    renderAdd<K extends keyof COMP, PK extends keyof P>(item: any[], name: K & string, props?: P[PK] & ConstrItem | ConstrItem, children?: RawChildren | RawSlots, index?: PK & string | string): this;
-    /**
-     * Calculates modified input data for connected components.
-     *
-     * Вычисляет модифицированные входные данные для подключенных компонентов.
-     * @param index the name of this/ название данного
-     */
-    protected computeModification<K extends keyof P>(index: K & string | string): Record<string, any>;
-}

package/dist/classes/design/DesignConstructorAbstract.d.ts

@@ -1,150 +0,0 @@
-import { ComputedRef, ToRefs, VNode, Ref } from 'vue';
-import { DesignComponents } from './DesignComponents';
-import { ConstrClass, ConstrClasses, ConstrClassObject, ConstrComponent, ConstrEmit, ConstrItem, ConstrOptions, ConstrStyles } from '../../types/constructorTypes';
-/**
- * Class for collecting all functional components.
- *
- * Класс для сбора всех функциональных компонентов.
- */
-export declare abstract class DesignConstructorAbstract<E extends Element, COMP extends ConstrComponent, EMITS extends ConstrItem, EXPOSE extends ConstrItem, SLOTS extends ConstrItem, CLASSES extends ConstrClasses, P extends ConstrItem> {
-    protected readonly props: Readonly<P>;
-    protected readonly options?: ConstrOptions<COMP, EMITS, P> | undefined;
-    protected readonly name: string[];
-    protected readonly element: Ref<E | undefined, E | undefined>;
-    protected readonly refs: ToRefs<P>;
-    protected readonly components: DesignComponents<COMP, P>;
-    protected readonly emits?: ConstrEmit<EMITS>;
-    protected readonly classes?: ComputedRef<CLASSES>;
-    protected classesSub?: ComputedRef<Partial<CLASSES>>;
-    protected readonly styles?: ComputedRef<ConstrStyles>;
-    protected stylesSub?: ComputedRef<ConstrStyles>;
-    protected attrs?: ConstrItem;
-    protected slots?: SLOTS;
-    protected dataExpose?: EXPOSE;
-    /**
-     * Constructor
-     * @param name class name/ название класса
-     * @param props properties/ свойства
-     * @param options list of additional parameters/ список дополнительных параметров
-     */
-    protected constructor(name: string, props: Readonly<P>, options?: ConstrOptions<COMP, EMITS, P> | undefined);
-    protected init(): this;
-    /**
-     * Getting the class name.
-     *
-     * Получение названия класса.
-     */
-    getName(): string;
-    /**
-     * Getting the class name.
-     *
-     * Получение названия дизайна.
-     */
-    getDesign(): string;
-    /**
-     * Getting the class name.
-     *
-     * Получение названия класса.
-     * @param name list of class names by levels/ список названий классов по уровням
-     */
-    getSubClass(name: string | string[]): string;
-    /**
-     * Getting the class name for the status.
-     *
-     * Получение названия класса для статуса.
-     * @param name list of class names by levels/ список названий классов по уровням
-     */
-    getStatusClass(name: string | string[]): string;
-    /**
-     * Getting the property name for the style.
-     *
-     * Получение названия свойства для стиля.
-     * @param name list of class names by levels/ список названий классов по уровням
-     */
-    getStyle(name: string | string[]): string;
-    /**
-     * Getting additional parameters.
-     *
-     * Получение дополнительных параметров.
-     */
-    getAttrs(): ConstrItem;
-    /**
-     * List of available external variables.
-     *
-     * Список доступных переменных извне.
-     */
-    expose(): EXPOSE;
-    /**
-     * The rendering method for the setup method.
-     *
-     * Метод рендеринга для метода настройки.
-     */
-    render(): () => VNode | (VNode | any)[] | undefined;
-    /**
-     * Initialization of all the necessary properties for work
-     *
-     * Инициализация всех необходимых свойств для работы.
-     */
-    protected abstract initExpose(): EXPOSE;
-    /**
-     * Improvement of the obtained list of classes.
-     *
-     * Доработка полученного списка классов.
-     */
-    protected abstract initClasses(): Partial<CLASSES>;
-    /**
-     * Refinement of the received list of styles.
-     *
-     * Доработка полученного списка стилей.
-     */
-    protected abstract initStyles(): ConstrStyles;
-    /**
-     * A method for rendering.
-     *
-     * Метод для рендеринга.
-     */
-    protected abstract initRender(): VNode | (VNode | any)[] | undefined;
-    /**
-     * Initializes the slot.
-     *
-     * Инициализирует слот.
-     * @param name slot name/ название слота
-     * @param children if you pass this element, the slot will be added to it/
-     * если передать этот элемент, то слот добавится в него
-     * @param props property for the slot/ свойство для слота
-     */
-    protected initSlot<K extends keyof SLOTS>(name: K, children?: any[], props?: ConstrItem): VNode | undefined;
-    /**
-     * Transformation of the class value into an object.
-     *
-     * Преобразование значения класса в объект.
-     * @param classes list of classes for transformation/ список классов для преобразования
-     */
-    protected toClass(classes?: ConstrClass): ConstrClassObject;
-    /**
-     * Converts the class name to standard for the current component.
-     *
-     * Преобразовывает название класса в стандартное для текущего компонента.
-     * @param classes list of classes/ список классов
-     */
-    protected toClassName<T extends ConstrItem>(classes?: ConstrItem): T;
-    /**
-     * Getting component names as an array.
-     *
-     * Получение названий компонентов в виде массива.
-     * @param name component name for transformation/ название компонента для преобразования
-     */
-    private initName;
-    /**
-     * Updating data about the class.
-     *
-     * Обновление данных об классе.
-     */
-    private updateClasses;
-    /**
-     * Refinement of the received list of styles.
-     *
-     * Доработка полученного списка стилей.
-     */
-    private updateStyles;
-}

package/dist/classes/ref/DatetimeRef.d.ts

@@ -1,117 +0,0 @@
-import { ComputedRef, Ref } from 'vue';
-import { Datetime, GeoDate, GeoFirstDay, GeoHours, NumberOrStringOrDate } from '@dxtmisha/functional-basic';
-import { RefOrNormal } from '../../types/refTypes';
-/**
- * A class for working with dates.
- *
- * Класс для работы с датами.
- */
-export declare class DatetimeRef {
-    protected item: Ref<NumberOrStringOrDate>;
-    protected type: Ref<GeoDate>;
-    protected code: Ref<string>;
-    protected date: Ref<Date>;
-    protected datetime: Datetime;
-    protected year: ComputedRef<number>;
-    protected month: ComputedRef<number>;
-    protected day: ComputedRef<number>;
-    protected hour: ComputedRef<number>;
-    protected minute: ComputedRef<number>;
-    protected second: ComputedRef<number>;
-    /**
-     * Constructor
-     * @param date date for processing. дата для обработки
-     * @param type type of date format for output. тип формата даты вывода
-     * @param code country and language code. код страны и языка
-     */
-    constructor(date: RefOrNormal<NumberOrStringOrDate>, type?: RefOrNormal<GeoDate>, code?: RefOrNormal<string>);
-    /**
-     * Returns the basic data for the date.
-     *
-     * Возвращает основные данные для даты.
-     */
-    getItem(): RefOrNormal<NumberOrStringOrDate>;
-    /**
-     * Returns a Date object.
-     *
-     * Возвращает объект Date.
-     */
-    getDate(): Ref<Date>;
-    /**
-     * Obtaining an object of the basic Datetime class.
-     *
-     * Получение объекта основного класса Datetime.
-     */
-    getDatetime(): Datetime;
-    /**
-     * Returns the format of hours.
-     *
-     * Возвращает формат часов.
-     */
-    getHoursType(): ComputedRef<GeoHours>;
-    /**
-     * Returns the code of the first day of the week.
-     *
-     * Возвращает код первого дня недели.
-     */
-    getFirstDayCode(): ComputedRef<GeoFirstDay>;
-    /**
-     * The method returns the year of the specified date according to local time.
-     *
-     * Метод возвращает год указанной даты по местному времени.
-     */
-    getYear(): ComputedRef<number>;
-    /**
-     * The method returns the month in the specified date according to local time,
-     * as a zero-based value.
-     *
-     * Метод возвращает месяц указанной даты по местному времени, нумерация
-     * месяцев начинается с нуля для первого месяца в году.
-     */
-    getMonth(): ComputedRef<number>;
-    /**
-     * The method returns the day of the month for the specified date according to local time.
-     *
-     * Метод возвращает день месяца указанной даты по местному времени.
-     */
-    getDay(): ComputedRef<number>;
-    /**
-     * The method returns the hour for the specified date, according to local time.
-     *
-     * Метод возвращает часы указанной даты по местному времени.
-     */
-    getHour(): ComputedRef<number>;
-    /**
-     * The method returns the minutes in the specified date according to local time.
-     *
-     * Метод возвращает минуты указанной даты по местному времени.
-     */
-    getMinute(): ComputedRef<number>;
-    /**
-     * The method returns the seconds in the specified date according to local time.
-     *
-     * Метод возвращает секунды указанной даты по местному времени.
-     */
-    getSecond(): ComputedRef<number>;
-    /**
-     * Returns the last day of the week.
-     *
-     * Возвращает последний день недели.
-     */
-    getMaxDay(): ComputedRef<number>;
-    /**
-     * Enables language-sensitive date and time formatting.
-     *
-     * Конструктором объектов, включающих языка-зависимое форматирование даты и времени.
-     * @param type type of date format for output. тип формата даты вывода
-     * @param styleOptions the representation of the month. представление месяца
-     */
-    locale(type?: GeoDate, styleOptions?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions): ComputedRef<string>;
-    /**
-     * Output of standard data.
-     *
-     * Вывод стандартных данных.
-     * @param timeZone add time zone. добавить временную зону
-     */
-    standard(timeZone?: boolean): ComputedRef<string>;
-}

package/dist/classes/ref/EventRef.d.ts

@@ -1,22 +0,0 @@
-import { RefOrNormal } from '../../types/refTypes';
-import { ElementOrString, ElementOrWindow, EventItem, EventListenerDetail, EventOptions } from '@dxtmisha/functional-basic';
-/**
- * Class for working with events (Ref).
- *
- * Класс для работа с события (Ref).
- */
-export declare class EventRef<E extends ElementOrWindow, O extends Event, D extends Record<string, any> = Record<string, any>> extends EventItem<E, O, D> {
-    /**
-     * Classes Constructor
-     * @param elementSelector element/ элемент
-     * @param elementSelectorControl control element/ элемент управления
-     * @param type type/ тип
-     * @param listener the object that receives a notification (an object that implements the
-     * Event interface) when an event of the specified type occurs/ объект, который принимает
-     * уведомление, когда событие указанного типа произошло
-     * @param options object that specifies characteristics/ объект options
-     * @param detail an event-dependent value associated with the event/ зависимое от события
-     * значение, связанное с событием
-     */
-    constructor(elementSelector?: RefOrNormal<ElementOrString<E> | undefined>, elementSelectorControl?: RefOrNormal<ElementOrString<HTMLElement>>, type?: string | string[], listener?: EventListenerDetail<O, D>, options?: EventOptions, detail?: D);
-}

package/dist/classes/ref/GeoFlagRef.d.ts

@@ -1,51 +0,0 @@
-import { ComputedRef, Ref } from 'vue';
-import { GeoFlag, GeoFlagItem, GeoFlagNational } from '@dxtmisha/functional-basic';
-import { RefOrNormal } from '../../types/refTypes';
-/**
- * Class for working with Flags.
- *
- * Класс для работы с Флагами.
- */
-export declare class GeoFlagRef {
-    protected code: Ref<string>;
-    protected flag: GeoFlag;
-    /**
-     * Constructor
-     * @param code country and language code/ код страны и языка
-     */
-    constructor(code?: RefOrNormal<string>);
-    /**
-     * Obtaining a reactive object with the country code.
-     *
-     * Получение реактивного объекта с кодом страны.
-     */
-    getCode(): Ref<string>;
-    /**
-     * Returns information about the country and its flag.
-     *
-     * Возвращает информацию о стране и её флаге.
-     * @param code country code/ код страны
-     */
-    get(code?: string): ComputedRef<GeoFlagItem | undefined>;
-    /**
-     * Getting a link to the flag.
-     *
-     * Получение ссылки на флаг.
-     * @param code country code/ код страны
-     */
-    getFlag(code?: string): ComputedRef<string | undefined>;
-    /**
-     * Getting a list of countries by an array of codes.
-     *
-     * Получение списка стран по массиву с кодами.
-     * @param codes country code/ код страны
-     */
-    getList(codes?: string[]): ComputedRef<GeoFlagItem[]>;
-    /**
-     * Getting a list of countries by an array of codes in national language.
-     *
-     * Получение списка стран по массиву с кодами на национальный язык.
-     * @param codes country code/ код страны.
-     */
-    getNational(codes?: string[]): ComputedRef<GeoFlagNational[]>;
-}