@dxtmisha/constructor 0.30.1 → 0.39.5

package/dist/constructors/Tooltip/TooltipPosition.d.ts

@@ -0,0 +1,43 @@
+import { Ref } from 'vue';
+import { TooltipClasses } from './TooltipClasses';
+import { TooltipStyle } from './TooltipStyle';
+import { TooltipProps } from './props';
+/**
+ * A class for working with position.
+ *
+ * Класс для работы с позицией.
+ */
+export declare class TooltipPosition {
+    protected readonly props: Readonly<TooltipProps>;
+    protected readonly element: Ref<HTMLDivElement | undefined>;
+    protected readonly classes: TooltipClasses;
+    protected readonly style: TooltipStyle;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param element instance of the element itself/ экземпляр самого элемента
+     * @param classes object for working with the class/ объект для работы с классом
+     * @param style object for working with styles/ объект для работы со стилями
+     */
+    constructor(props: Readonly<TooltipProps>, element: Ref<HTMLDivElement | undefined>, classes: TooltipClasses, style: TooltipStyle);
+    /**
+     * Update all sizes.
+     *
+     * Обновить все размеры.
+     */
+    update(): void;
+    /**
+     * Checks whether the element should be displayed on top.
+     *
+     * Проверяет, надо ли отображать элемент сверху.
+     * @param rect the current position of the control element/ данное положение элемента контроля
+     * @param tooltipRect the current position of the element itself/ данное положение самого элемента
+     */
+    protected isTop(rect: DOMRect, tooltipRect: DOMRect): boolean;
+    /**
+     * Returns the margins for the element.
+     *
+     * Возвращает отступы для элемента.
+     */
+    protected getIndent(): number;
+}

package/dist/constructors/Tooltip/TooltipStatus.d.ts

@@ -0,0 +1,59 @@
+import { TooltipSlots } from './types';
+import { TooltipProps } from './props';
+import { Ref, ComputedRef } from 'vue';
+/**
+ * Class for working with display statuses.
+ *
+ * Класс для работы со статусами отображения.
+ */
+export declare class TooltipStatus {
+    protected readonly props: Readonly<TooltipProps>;
+    protected readonly slots?: TooltipSlots | undefined;
+    readonly open: Ref<boolean, boolean>;
+    readonly show: Ref<boolean, boolean>;
+    readonly preparation: Ref<boolean, boolean>;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param slots object for working with slots/ объект для работы со слотами
+     */
+    constructor(props: Readonly<TooltipProps>, slots?: TooltipSlots | undefined);
+    /**
+     * Checks if there is text to display.
+     *
+     * Проверяет, есть ли текст для отображения.
+     */
+    readonly isText: ComputedRef<boolean>;
+    /** Checks if the element needs to be displayed/ Проверяет, нужно ли отображать элемент */
+    readonly isShow: ComputedRef<boolean>;
+    /** Checks if the content is an array/ Проверяет, является ли содержимое массивом */
+    readonly isArray: ComputedRef<boolean>;
+    /**
+     * Checks if the current status matches the selected one.
+     *
+     * Проверяет, соответствует ли текущий статус выбранному.
+     * @param open the value of the current state/ значение текущего состояния
+     */
+    isMatch(open: boolean): boolean;
+    /**
+     * Changes the open state.
+     *
+     * Изменяет состояние открытия.
+     * @param open the value of the current state/ значение текущего состояния
+     */
+    setOpen(open: boolean): void;
+    /**
+     * Changes the display state.
+     *
+     * Изменяет состояние показа.
+     * @param show the value of the current state/ значение текущего состояния
+     */
+    setShow(show: boolean): void;
+    /**
+     * Changes the preparation status.
+     *
+     * Изменяет статус подготовки.
+     * @param preparation the value of the current state/ значение текущего состояния
+     */
+    setPreparation(preparation: boolean): void;
+}

package/dist/constructors/Tooltip/TooltipStyle.d.ts

@@ -0,0 +1,59 @@
+import { Ref } from 'vue';
+/**
+ * Style management class.
+ *
+ * Класс управления стилями.
+ */
+export declare class TooltipStyle {
+    protected readonly element: Ref<HTMLDivElement | undefined>;
+    protected readonly className: string;
+    /**
+     * Constructor
+     * @param element instance of the element itself/ экземпляр самого элемента
+     * @param className class name/ название класса
+     */
+    constructor(element: Ref<HTMLDivElement | undefined>, className: string);
+    /**
+     * Changing styles.
+     *
+     * Изменение стилей.
+     * @param top should the element be placed on top/ нужно ли поместить элемент сверху
+     * @param x value of X/ значение X
+     * @param y value of Y/ значение Y
+     * @param shift value for shift/ значение для сдвига
+     */
+    set(top: boolean, x: number, y: number, shift: number): void;
+    /**
+     * Changes the preparation status.
+     *
+     * Изменяет статус подготовки.
+     * @param status the value of the current state/ значение текущего состояния
+     */
+    setPreparation(status: boolean): void;
+    /**
+     * Changes the preparation status.
+     *
+     * Изменяет статус подготовки.
+     * @param status the value of the current state/ значение текущего состояния
+     */
+    setShow(status: boolean): void;
+    /**
+     * Changes the move status.
+     *
+     * Изменяет статус перемещения.
+     * @param status the value of the current state/ значение текущего состояния
+     */
+    setMove(status: boolean): void;
+    /**
+     * Reset all records to the initial state.
+     *
+     * Сброс всех записей до начального состояния.
+     */
+    reset(): void;
+    /**
+     * Resets the display state.
+     *
+     * Сбрасывает состояние показа.
+     */
+    resetShow(): void;
+}

package/dist/constructors/Tooltip/basicTypes.d.ts

@@ -0,0 +1,29 @@
+import { Ref } from 'vue';
+import { ConstrBind } from '@dxtmisha/functional';
+import { AriaList } from '../../types/ariaTypes';
+import { TooltipProps } from './props';
+export type TooltipControlBinds = AriaList & {
+    class: string;
+    onclick: () => void;
+    onmouseover: (event: MouseEvent) => void;
+    onmouseout: (event: MouseEvent) => void;
+};
+export type TooltipControl = TooltipControlBinds & {
+    open: Ref<boolean>;
+    binds: TooltipControlBinds;
+};
+/**
+ * Component map for including the Tooltip component/
+ * Карта компонентов для подключения компонента Tooltip
+ */
+export type TooltipComponentInclude = {
+    tooltip?: object;
+};
+/**
+ * Props used to include and configure the Tooltip component/
+ * Свойства для подключения и настройки компонента Tooltip
+ */
+export type TooltipPropsInclude<Tooltip extends TooltipProps = TooltipProps> = {
+    /** Additional attributes for Tooltip component/ Дополнительные атрибуты для компонента Tooltip */
+    tooltipAttrs?: ConstrBind<Tooltip>;
+};

package/dist/constructors/Tooltip/index.d.ts

@@ -0,0 +1,6 @@
+export * from './Tooltip';
+export * from './TooltipDesign';
+export * from './TooltipInclude';
+export * from './props';
+export * from './types';
+export * from './basicTypes';

package/dist/constructors/Tooltip/props.d.ts

@@ -0,0 +1,29 @@
+import { LabelProps } from '../../types/labelTypes';
+import { DescriptionProps } from '../../types/descriptionTypes';
+import { ArrowProps, ArrowPropsInclude } from '../Arrow';
+export type TooltipPropsToken = {};
+export type TooltipPropsBasic<Arrow extends ArrowProps = ArrowProps> = LabelProps & DescriptionProps & ArrowPropsInclude<Arrow> & {
+    open?: boolean;
+    disabled?: boolean;
+    inDom?: boolean;
+    top?: boolean;
+    indent?: number;
+    delay?: number;
+    delayHide?: number;
+};
+/**
+ * Type describing incoming properties.
+ *
+ * Тип, описывающий входящие свойства.
+ */
+export type TooltipProps = TooltipPropsBasic & TooltipPropsToken;
+/**
+ * Default value for property.
+ *
+ * Значение по умолчанию для свойства.
+ */
+export declare const defaultsTooltip: {
+    indent: number;
+    delay: number;
+    delayHide: number;
+};

package/dist/constructors/Tooltip/types.d.ts

@@ -0,0 +1,47 @@
+import { ConstrClass } from '@dxtmisha/functional';
+import { LabelSlots } from '../../types/labelTypes';
+import { DescriptionSlots } from '../../types/descriptionTypes';
+import { ArrowComponentInclude } from '../Arrow';
+import { TooltipControl } from './basicTypes';
+/**
+ * Interface for describing which components need to be connected for work.
+ *
+ * Интерфейс для описания, какие компоненты надо подключить для работы.
+ */
+export type TooltipComponents = ArrowComponentInclude;
+/**
+ * Type describing available events.
+ *
+ * Тип, описывающий доступные события.
+ */
+export type TooltipEmits = {
+    tooltip: [open: boolean];
+};
+/**
+ * Type describing available properties.
+ *
+ * Тип, описывающий доступные свойства.
+ */
+export interface TooltipExpose {
+    toggle(open: boolean, flash?: boolean): Promise<void>;
+}
+/**
+ * Type describing available slots.
+ *
+ * Тип, описывающий доступные слоты.
+ */
+export interface TooltipSlots extends LabelSlots, DescriptionSlots {
+    control?(props: TooltipControl): any;
+    body?(): any;
+}
+/**
+ * Type describing subclasses.
+ *
+ * Тип, описывающий подклассы.
+ */
+export type TooltipClasses = {
+    main: ConstrClass;
+    label: string;
+    description: string;
+    body: string;
+};

package/dist/constructors/Window/Window.d.ts

@@ -0,0 +1,115 @@
+import { Ref, ToRefs, ComputedRef } from 'vue';
+import { ConstrClassObject, ConstrEmit, DesignComp } from '@dxtmisha/functional';
+import { ScrollbarInclude } from '../Scrollbar/ScrollbarInclude';
+import { ImageInclude } from '../Image/ImageInclude';
+import { TabIndexInclude } from '../../classes/TabIndexInclude';
+import { TextInclude } from '../../classes/TextInclude';
+import { WindowClient } from './WindowClient';
+import { WindowHook } from './WindowHook';
+import { WindowClasses } from './WindowClasses';
+import { WindowElement } from './WindowElement';
+import { WindowStatus } from './WindowStatus';
+import { WindowPersistent } from './WindowPersistent';
+import { WindowFlash } from './WindowFlash';
+import { WindowCoordinates } from './WindowCoordinates';
+import { WindowPosition } from './WindowPosition';
+import { WindowOrigin } from './WindowOrigin';
+import { WindowStatic } from './WindowStatic';
+import { WindowEmit } from './WindowEmit';
+import { WindowStyles } from './WindowStyles';
+import { WindowOpen } from './WindowOpen';
+import { WindowVerification } from './WindowVerification';
+import { WindowEvent } from './WindowEvent';
+import { WindowEsc } from './WindowEsc';
+import { WindowHidden } from './WindowHidden';
+import { WindowControlItem } from './basicTypes';
+import { WindowComponents, WindowEmits, WindowSlots } from './types';
+import { WindowPropsBasic } from './props';
+/**
+ * Main Window class that manages all window-related functionality including positioning,
+ * events, styles, animations, and component integrations. This class serves as the central
+ * coordinator for window operations in the design system.
+ *
+ * Основной класс Window, который управляет всей функциональностью окон, включая позиционирование,
+ * события, стили, анимации и интеграции компонентов. Этот класс служит центральным координатором
+ * для операций с окнами в дизайн-системе.
+ */
+export declare class Window {
+    protected readonly props: WindowPropsBasic;
+    protected readonly refs: ToRefs<WindowPropsBasic>;
+    protected readonly classDesign: string;
+    protected readonly className: string;
+    protected readonly components?: DesignComp<WindowComponents, WindowPropsBasic> | undefined;
+    protected readonly slots?: WindowSlots | undefined;
+    protected readonly emits?: ConstrEmit<WindowEmits> | undefined;
+    /** Client instance for window management/ Экземпляр клиента для управления окном */
+    readonly client: WindowClient;
+    /** Hook instance for window events/ Экземпляр хука для событий окна */
+    readonly hook: WindowHook;
+    /** Class manager for window styles/ Менеджер классов для стилей окна */
+    readonly classes: WindowClasses;
+    /** Element manager for window DOM element/ Менеджер элементов для DOM элемента окна */
+    readonly element: WindowElement;
+    readonly tabIndex: TabIndexInclude;
+    /** Status manager for window state/ Менеджер статуса для состояния окна */
+    readonly status: WindowStatus;
+    /** Persistent manager for window data/ Менеджер постоянных данных для окна */
+    readonly persistent: WindowPersistent;
+    /** Flash manager for window animations/ Менеджер анимаций для окна */
+    readonly flash: WindowFlash;
+    /** Coordinates manager for window positioning/ Менеджер координат для позиционирования окна */
+    readonly coordinates: WindowCoordinates;
+    /** Position manager for window placement/ Менеджер позиции для размещения окна */
+    readonly position: WindowPosition;
+    /** Origin manager for window transformations/ Менеджер начальной точки для трансформаций окна */
+    readonly origin: WindowOrigin;
+    /** Static mode manager for window behavior/ Менеджер статического режима для поведения окна */
+    readonly staticMode: WindowStatic;
+    /** Emit manager for window events/ Менеджер событий для окна */
+    readonly emit: WindowEmit;
+    /** Styles manager for window appearance/ Менеджер стилей для внешнего вида окна */
+    readonly styles: WindowStyles;
+    /** Open manager for window visibility/ Менеджер открытия для видимости окна */
+    readonly open: WindowOpen;
+    /** Verification manager for window state validation/ Менеджер проверки для валидации состояния окна */
+    readonly verification: WindowVerification;
+    /** Event manager for window interactions/ Менеджер событий для взаимодействий с окном */
+    readonly event: WindowEvent;
+    /** Scrollbar manager for window content/ Менеджер скроллбара для содержимого окна */
+    readonly scrollbar: ScrollbarInclude;
+    /** Image manager for window content/ Менеджер изображений для содержимого окна */
+    readonly image: ImageInclude;
+    /** Escape key manager for window closing/ Менеджер клавиши Escape для закрытия окна */
+    readonly esc: WindowEsc;
+    readonly text: TextInclude;
+    /** Hidden manager for hiding elements outside the window when open/ Менеджер скрытия элементов вне окна при открытии */
+    readonly hidden: WindowHidden;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param refs input data in the form of reactive elements/ входные данные в виде реактивных элементов
+     * @param element input element/ элемент ввода
+     * @param classDesign design name/ название дизайна
+     * @param className class name/ название класса
+     * @param components object for working with components/ объект для работы с компонентами
+     * @param slots object for working with slots/ объект для работы со слотами
+     * @param emits the function is called when an event is triggered/ функция вызывается, когда срабатывает событие
+     */
+    constructor(props: WindowPropsBasic, refs: ToRefs<WindowPropsBasic>, element: Ref<HTMLDivElement | undefined>, classDesign: string, className: string, components?: DesignComp<WindowComponents, WindowPropsBasic> | undefined, slots?: WindowSlots | undefined, emits?: ConstrEmit<WindowEmits> | undefined);
+    /** Checks if the role is a menu/ Проверяет, является ли роль меню */
+    isMenu(): boolean;
+    /** Returns data for managing slot data/ Возвращает данные для управления данными слотами */
+    readonly slotData: ComputedRef<WindowControlItem>;
+    /**
+     * Returns the list of available classes.
+     *
+     * Возвращает список доступных классов.
+     */
+    readonly classesList: ComputedRef<ConstrClassObject>;
+    /**
+     * Restores the data to its previous state.
+     *
+     * Восстанавливает данные в прежнее состояние.
+     */
+    protected readonly stop: () => void;
+}

package/dist/constructors/Window/WindowClasses.d.ts

@@ -0,0 +1,125 @@
+import { WindowClassesList, WindowStatusItem } from './basicTypes';
+/**
+ * Class for working with class names.
+ *
+ * Класс для работы с названиями классов.
+ */
+export declare class WindowClasses {
+    protected readonly className: string;
+    /**
+     * Identification of the current window. Used to search for the current component and its control.
+     *
+     * Идентификация текущего окна. Используется для поиска текущего компонента и его контроля.
+     */
+    protected readonly id: string;
+    protected readonly controlId: string;
+    readonly list: WindowClassesList;
+    /**
+     * Constructor
+     * @param className class name/ название класса
+     */
+    constructor(className: string);
+    /**
+     * Checks if the selected element is a window.
+     *
+     * Проверяет, является ли выбранный элемент окном.
+     * @param target selected item/ выбранный элемент
+     */
+    isWindow(target?: HTMLElement): boolean;
+    /**
+     * Checks if the selected element is a window teleport.
+     *
+     * Проверяет, является ли выбранный элемент телепортом окна.
+     * @param target selected item/ выбранный элемент
+     */
+    isWindowTeleport(target?: HTMLElement): boolean;
+    /**
+     * Checks if the selected element is a window or a window teleport.
+     *
+     * Проверяет, является ли выбранный элемент окном или телепортом окна.
+     * @param target selected item/ выбранный элемент
+     */
+    isWindowOrTeleport(target?: HTMLElement): boolean;
+    /**
+     * Returns the identifier of the current window.
+     *
+     * Возвращает идентификатор текущего окна.
+     */
+    getId(): string;
+    /**
+     * Returns the identifier of the control of the current window.
+     *
+     * Возвращает идентификатор контроля текущего окна.
+     */
+    getControlId(): string;
+    /**
+     * Returns the full name of the class for the status.
+     *
+     * Возвращает полное название класса для статуса.
+     * @param status названия статуса
+     */
+    getClassStatus(status: WindowStatusItem): string;
+    /**
+     * Returns the class selector for control.
+     *
+     * Возвращает селектор класса для управления.
+     */
+    getSelectorControl(): string;
+    /**
+     * Search and return the window element at the selected item.
+     *
+     * Поиск и возврат элемента окна у выбранного элемента.
+     * @param target selected item/ выбранный элемент
+     */
+    findMain<T extends HTMLElement>(target: HTMLElement): T | undefined;
+    /**
+     * Search and return of the control element of the current component.
+     *
+     * Поиск и возврат элемента управления текущего компонента.
+     */
+    findControl(): HTMLElement | undefined;
+    /**
+     * Find the control at the selected window.
+     *
+     * Найди элемент управления у выбранного окна.
+     * @param element window element/ элемент окна
+     */
+    findControlByElement(element?: HTMLElement): HTMLElement | undefined;
+    /**
+     * Search and return of the window body element for the current component.
+     *
+     * Поиск и возврат элемента тела окна для текущего компонента.
+     */
+    findBody(): HTMLDivElement | undefined;
+    /**
+     * Search and return of the context body element of the window for the current component.
+     *
+     * Поиск и возврат элемента контекста тела окна для текущего компонента.
+     */
+    findBodyContext(): HTMLDivElement | undefined;
+    /**
+     * Search and return of the window body element for other components (not current)
+     * with additional selectors.
+     *
+     * Поиск и возврат элемента тела окна для других компонентов (не текущего)
+     * с дополнительными селекторами.
+     * @param selectors additional CSS selectors/ дополнительные CSS селекторы
+     * @param status status of the window/ статус окна
+     */
+    findBodyOther(selectors: string, status?: WindowStatusItem): HTMLDivElement | undefined;
+    /**
+     * Returns the list of available classes.
+     *
+     * Возвращает список доступных классов.
+     * @param className class name/ название класса
+     * @param id identification of the current window/ идентификация текущего окна
+     */
+    static getClassesList(className: string, id?: string): WindowClassesList;
+    /**
+     * Returns a list of available classes by design name.
+     *
+     * Возвращает список доступных классов по названию дизайна.
+     * @param design design name/ названия дизайна
+     */
+    static getClassesListByDesign(design: string): WindowClassesList;
+}

package/dist/constructors/Window/WindowClassesInclude.d.ts

@@ -0,0 +1,28 @@
+import { WindowClassesList } from './basicTypes';
+/**
+ * Helper class to access window CSS classes by design.
+ *
+ * Вспомогательный класс для доступа к CSS-классам окна по дизайну.
+ */
+export declare class WindowClassesInclude {
+    protected readonly design: string;
+    /**
+     * Constructor
+     * @param design design name/ название дизайна
+     */
+    constructor(design: string);
+    /**
+     * Returns list of window classes for the specified design.
+     *
+     * Возвращает список классов окна для указанного дизайна.
+     */
+    get(): WindowClassesList;
+    /**
+     * Returns an object with window classes under classesWindow key.
+     *
+     * Возвращает объект с классами окна под ключом classesWindow.
+     */
+    getObject(): {
+        classesWindow: WindowClassesList;
+    };
+}

package/dist/constructors/Window/WindowClient.d.ts

@@ -0,0 +1,70 @@
+import { WindowElement } from './WindowElement';
+/**
+ * The class stores the coordinates of the mouse click. It is used for the opening
+ * animation, when the element appears from the point of click. And also for the contextmenu event.
+ *
+ * Класс хранит координаты нажатия мыши. Используется для анимации открытия,
+ * когда элемент появляется от точки нажатия. А также для события contextmenu.
+ */
+export declare class WindowClient {
+    protected readonly element: WindowElement;
+    protected x: number;
+    protected y: number;
+    constructor(element: WindowElement);
+    /**
+     * Checks if the button was pressed.
+     *
+     * Проверяет, было ли нажатие на кнопку.
+     */
+    is(): boolean;
+    /**
+     * Checks if the coordinates are at the origin (0,0).
+     *
+     * Проверяет, находятся ли координаты в начале координат (0,0).
+     */
+    isZero(): boolean;
+    /**
+     * Returns the X coordinate.
+     *
+     * Возвращает координату X.
+     */
+    getX(): number;
+    /**
+     * Returns the Y coordinate.
+     *
+     * Возвращает координату Y.
+     */
+    getY(): number;
+    /**
+     * Returns the shift along the X coordinate.
+     *
+     * Возвращает сдвиг по координате X.
+     */
+    getShiftX(value: number): number;
+    /**
+     * Returns the shift along the Y coordinate.
+     *
+     * Возвращает сдвиг по координате Y.
+     */
+    getShiftY(value: number): number;
+    /**
+     * Changes the coordinates.
+     *
+     * Изменяет координаты.
+     * @param x value of X/ значение X
+     * @param y value of Y/ значение Y
+     */
+    set(x: number, y: number): this;
+    /**
+     * Resets all data to initial values.
+     *
+     * Сбрасывает все данные к начальным значениям.
+     */
+    reset(): this;
+    /**
+     * The method updates the current position.
+     *
+     * Метод обновляет текущее положение.
+     */
+    update(): this;
+}