@dxtmisha/constructor 0.30.1 → 0.39.3

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;
+}

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

@@ -0,0 +1,132 @@
+import { WindowClasses } from './WindowClasses';
+import { WindowElement } from './WindowElement';
+/**
+ * A class for working with coordinates.
+ *
+ * Класс для работы с координатами.
+ */
+export declare class WindowCoordinates {
+    protected readonly classes: WindowClasses;
+    protected readonly element: WindowElement;
+    protected top: number;
+    protected right: number;
+    protected bottom: number;
+    protected left: number;
+    protected width: number;
+    protected height: number;
+    protected innerWidth: number;
+    protected innerHeight: number;
+    protected controlWidth: number;
+    protected controlHeight: number;
+    protected padding: number;
+    protected location: string;
+    /**
+     * Constructor
+     * @param classes an object for working with classes and searching for elements/ объект для работы с классами и поиском элементов
+     * @param element an object of the class for working with elements/ объект класса для работы с элементами
+     */
+    constructor(classes: WindowClasses, element: WindowElement);
+    /**
+     * Returns the distance from the top point.
+     *
+     * Возвращает расстояние от верхней точки.
+     */
+    getTop(): number;
+    /**
+     * Returns the distance from the right point.
+     *
+     * Возвращает расстояние от правой точки.
+     */
+    getRight(): number;
+    /**
+     * Returns the distance from the lower point.
+     *
+     * Возвращает расстояние от нижней точки.
+     */
+    getBottom(): number;
+    /**
+     * Returns the distance from the left point.
+     *
+     * Возвращает расстояние от левой точки.
+     */
+    getLeft(): number;
+    /**
+     * Returns the width of the element.
+     *
+     * Возвращает ширину элемента.
+     */
+    getWidth(): number;
+    /**
+     * Returns the height of the element.
+     *
+     * Возвращает высоту элемента.
+     */
+    getHeight(): number;
+    /**
+     * Returns the width of the window.
+     *
+     * Возвращает ширину окна.
+     */
+    getInnerWidth(): number;
+    /**
+     * Returns the height of the window.
+     *
+     * Возвращает высоту окна.
+     */
+    getInnerHeight(): number;
+    /**
+     * Returns the width of the control element.
+     *
+     * Возвращает ширину элемента управления.
+     */
+    getControlWidth(): number;
+    /**
+     * Returns the height of the control element.
+     *
+     * Возвращает высоту элемента управления.
+     */
+    getControlHeight(): number;
+    /**
+     * Returns the margins of the element.
+     *
+     * Возвращает отступы у элемента.
+     */
+    getPadding(): number;
+    /**
+     * Returns the values of the element's position.
+     *
+     * Возвращает значения положения элемента.
+     */
+    getLocation(): string;
+    /**
+     * Returns the maximum height of the body.
+     *
+     * Возвращает максимальную высоту у body.
+     */
+    getMaxHeight(): number;
+    /**
+     * Data updates.
+     *
+     * Обновления данных.
+     */
+    update(): boolean;
+    /**
+     * Resets all data to initial values.
+     *
+     * Сбрасывает все данные к начальным значениям.
+     */
+    reset(): this;
+    /**
+     * Initializes padding value from computed styles.
+     *
+     * Инициализирует значение отступов из вычисленных стилей.
+     */
+    protected initPadding(): number;
+    /**
+     * Calculates control position values.
+     *
+     * Вычисляет значения положения контроля.
+     * @param top position of an element/ положение элемента
+     */
+    protected initLocation(top: number): string;
+}

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

@@ -0,0 +1,143 @@
+import { VNode, ComputedRef, Ref } from 'vue';
+import { ConstrOptions, ConstrStyles, DesignConstructorAbstract, ConstrClass } from '@dxtmisha/functional';
+import { Window } from './Window';
+import { WindowPropsBasic } from './props';
+import { WindowClasses, WindowComponents, WindowEmits, WindowExpose, WindowSlots } from './types';
+import { RoleType, AriaTrueOrFalse } from '../../library';
+import { NumberOrString } from '@dxtmisha/functional-basic';
+/**
+ * WindowDesign
+ */
+export declare class WindowDesign<COMP extends WindowComponents, EXPOSE extends WindowExpose, CLASSES extends WindowClasses, P extends WindowPropsBasic> extends DesignConstructorAbstract<HTMLDivElement, COMP, WindowEmits, EXPOSE, WindowSlots, CLASSES, P> {
+    protected readonly item: Window;
+    /**
+     * Constructor
+     * @param name class name/ название класса
+     * @param props properties/ свойства
+     * @param options list of additional parameters/ список дополнительных параметров
+     */
+    constructor(name: string, props: Readonly<P>, options?: ConstrOptions<COMP, WindowEmits, P>);
+    /**
+     * Initialization of all the necessary properties for work
+     *
+     * Инициализация всех необходимых свойств для работы.
+     */
+    protected initExpose(): EXPOSE;
+    /**
+     * Improvement of the obtained list of classes.
+     *
+     * Доработка полученного списка классов.
+     */
+    protected initClasses(): Partial<CLASSES>;
+    /**
+     * Refinement of the received list of styles.
+     *
+     * Доработка полученного списка стилей.
+     */
+    protected initStyles(): ConstrStyles;
+    /**
+     * A method for rendering.
+     *
+     * Метод для рендеринга.
+     */
+    protected initRender(): VNode[];
+    /**
+     * Render main window element.
+     *
+     * Рендер главного элемента окна.
+     */
+    readonly renderMain: () => VNode;
+    /**
+     * Render body element.
+     *
+     * Рендер элемента тела.
+     */
+    readonly renderBody: () => VNode;
+    /**
+     * Generates an element to group the displayed data.
+     *
+     * Генерирует элемент для группировки выводимых данных.
+     */
+    readonly renderBodyGroup: () => VNode[];
+    /**
+     * Render context element.
+     *
+     * Рендер элемента контекста.
+     */
+    readonly renderBodyContext: () => VNode[];
+    /**
+     * Generates an element to display the image.
+     *
+     * Генерирует элемент для вывода изображения
+     */
+    readonly renderBodyImage: () => VNode[];
+    /**
+     * Generates an element to display the close button.
+     *
+     * Генерирует элемент для вывода кнопки закрытия.
+     */
+    readonly renderBodyClose: () => VNode[];
+    /**
+     * Props for the main element.
+     *
+     * Свойства для главного элемента.
+     */
+    protected readonly propsMain: ComputedRef<{
+        id?: string;
+        role?: RoleType;
+        tabindex?: NumberOrString;
+        'aria-activedescendant'?: string;
+        'aria-atomic'?: AriaTrueOrFalse;
+        'aria-autocomplete'?: "none" | "inline" | "list" | "both";
+        'aria-busy'?: AriaTrueOrFalse;
+        'aria-checked'?: AriaTrueOrFalse | "mixed";
+        'aria-colcount'?: number;
+        'aria-colindex'?: number;
+        'aria-colspan'?: number;
+        'aria-controls'?: string;
+        'aria-current'?: AriaTrueOrFalse | "page" | "step" | "location" | "date" | "time";
+        'aria-describedby'?: string;
+        'aria-details'?: string;
+        'aria-disabled'?: AriaTrueOrFalse;
+        'aria-errormessage'?: string;
+        'aria-expanded'?: AriaTrueOrFalse;
+        'aria-flowto'?: string;
+        'aria-grabbed'?: AriaTrueOrFalse;
+        'aria-haspopup'?: AriaTrueOrFalse | "dialog" | "menu" | "listbox" | "tree" | "grid";
+        'aria-hidden'?: AriaTrueOrFalse;
+        'aria-invalid'?: AriaTrueOrFalse | "grammar" | "spelling";
+        'aria-keyshortcuts'?: string;
+        'aria-label'?: string;
+        'aria-labelledby'?: string;
+        'aria-level'?: number;
+        'aria-live'?: "off" | "polite" | "assertive";
+        'aria-modal'?: AriaTrueOrFalse;
+        'aria-multiline'?: AriaTrueOrFalse;
+        'aria-multiselectable'?: AriaTrueOrFalse;
+        'aria-orientation'?: "horizontal" | "vertical" | "undefined";
+        'aria-owns'?: string;
+        'aria-placeholder'?: string;
+        'aria-posinset'?: number;
+        'aria-pressed'?: AriaTrueOrFalse | "mixed";
+        'aria-readonly'?: AriaTrueOrFalse;
+        'aria-relevant'?: "additions" | "removals" | "text" | "all" | string;
+        'aria-required'?: AriaTrueOrFalse;
+        'aria-roledescription'?: string;
+        'aria-rowcount'?: number;
+        'aria-rowindex'?: number;
+        'aria-rowspan'?: number;
+        'aria-selected'?: AriaTrueOrFalse;
+        'aria-setsize'?: number;
+        'aria-sort'?: "none" | "ascending" | "descending" | "other";
+        'aria-valuemax'?: string | number;
+        'aria-valuemin'?: string | number;
+        'aria-valuenow'?: string | number;
+        'aria-valuetext'?: string;
+        key: string;
+        ref: Ref<HTMLDivElement | undefined, HTMLDivElement | undefined>;
+        class: ConstrClass | undefined;
+        style: ConstrStyles | undefined;
+        'data-window': string;
+        onTransitionend: () => void;
+    }>;
+}