@dxtmisha/constructor 0.30.1 → 0.39.3

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

@@ -0,0 +1,128 @@
+import { WindowClient } from './WindowClient';
+import { WindowElement } from './WindowElement';
+import { WindowCoordinates } from './WindowCoordinates';
+import { WindowProps } from './props';
+/**
+ * A class for working with position.
+ *
+ * Класс для работы с позицией.
+ */
+export declare class WindowPosition {
+    protected readonly props: WindowProps;
+    protected readonly client: WindowClient;
+    protected readonly element: WindowElement;
+    protected readonly coordinates: WindowCoordinates;
+    protected x: number;
+    protected y: number;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param client object for working with mouse pointer coordinates/ объект для работы с координатами указателя мыши
+     * @param element an object of the class for working with elements/ объект класса для работы с элементами
+     * @param coordinates object for working with coordinates/ объект для работы с координатами
+     */
+    constructor(props: WindowProps, client: WindowClient, element: WindowElement, coordinates: WindowCoordinates);
+    /**
+     * Checks if the alignment type is above the element.
+     *
+     * Проверяет, является ли тип выравнивания над элементом.
+     */
+    isOver(): boolean;
+    /**
+     * Returns the X position.
+     *
+     * Возвращает позицию X.
+     */
+    getX(): number;
+    /**
+     * Returns the Y position.
+     *
+     * Возвращает позицию Y.
+     */
+    getY(): number;
+    /**
+     * Returns the X position for styles.
+     *
+     * Возвращает позицию X для стилей.
+     */
+    getStyleX(): string;
+    /**
+     * Returns the Y position for styles.
+     *
+     * Возвращает позицию Y для стилей.
+     */
+    getStyleY(): string;
+    /**
+     * Update of the element's position coordinates.
+     *
+     * Обновление координаты положения элемента.
+     */
+    update(): boolean;
+    /**
+     * Updates the scroll position if an element is selected.
+     *
+     * Обновляет место скрола, если выбран элемент.
+     */
+    updateScroll(): void;
+    /**
+     * Updates the scroll display status of the element.
+     *
+     * Обновляет статус отображения скролла у элемента.
+     */
+    updateBody(): void;
+    /**
+     * Returns the axis alignment values.
+     *
+     * Возвращает значения оси выравнивания.
+     */
+    protected getAxis(): WindowProps['axis'];
+    /**
+     * Returns the margins from the control element.
+     *
+     * Возвращает отступы от элемента управления.
+     * @param axis the axis of alignment of the element/ ось выравнивания элемента
+     */
+    protected getIndent(axis: string): number;
+    /**
+     * Calculation of the position for window alignment.
+     *
+     * Вычисление места положения для выравнивания окна.
+     * @param rectTop high control coordinates/ высокие координаты контрола
+     * @param rectBottom lower control coordinates/ нижние координаты контрола
+     */
+    protected getOverHeight(rectTop: number, rectBottom: number): number;
+    /**
+     * Changes in position along the X coordinate.
+     *
+     * Изменения положения по координате X.
+     */
+    protected setX(): this;
+    /**
+     * Changes in position along the Y coordinate.
+     *
+     * Изменения положения по координате Y.
+     */
+    protected setY(): this;
+    /**
+     * Calculation of the element's position.
+     *
+     * Вычисление положения элемента.
+     * @param inValue initial values/ начальные значения
+     * @param outValue final values/ конечные значения
+     * @param length length of the object/ длина объекта
+     * @param innerLength length of the indentation/ длина отступа
+     * @param maxSize maximum length/ максимальная длина
+     */
+    protected calculationInner(inValue: number, outValue: number, length: number, innerLength: number, maxSize: number): number;
+    /**
+     * Calculation of the element's position.
+     *
+     * Вычисление положения над элемента.
+     * @param value initial values/ начальные значения
+     * @param top high control coordinates/ высокие координаты контрола
+     * @param bottom lower control coordinates/ нижние координаты контрола
+     * @param length length of the object/ длина объекта
+     * @param innerLength length of the indentation/ длина отступа
+     */
+    protected calculationOver(value: number, top: number, bottom: number, length: number, innerLength: number): number;
+}

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

@@ -0,0 +1,58 @@
+import { ToRefs, Ref } from 'vue';
+import { EventItem } from '@dxtmisha/functional';
+import { WindowElement } from './WindowElement';
+import { WindowProps } from './props';
+/**
+ * Class for working with a static window.
+ *
+ * Класс для работы со статичным окном.
+ */
+export declare class WindowStatic {
+    protected readonly props: WindowProps;
+    protected readonly element: WindowElement;
+    protected event?: EventItem<Window, Event>;
+    readonly item: Ref<boolean, boolean>;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param refs input data in the form of reactive elements/ входные данные в виде реактивных элементов
+     * @param element an object of the class for working with elements/ объект класса для работы с элементами
+     */
+    constructor(props: WindowProps, refs: ToRefs<WindowProps>, element: WindowElement);
+    /**
+     * Checks if the static mode is enabled.
+     *
+     * Проверяет, включен ли режим статичности.
+     */
+    isStaticMod(): boolean;
+    /**
+     * Starts the status tracking event.
+     *
+     * Стартует событие слежения за статусами.
+     */
+    start(): void;
+    /**
+     * Restores the data to its previous state.
+     *
+     * Восстанавливает данные в прежнее состояние.
+     */
+    stop(): void;
+    /**
+     * Checks if the static window is active.
+     *
+     * Проверяет, активно ли статичное окно.
+     */
+    protected isStatic(): boolean;
+    /**
+     * The function called when an event is triggered.
+     *
+     * Вызываемая функция при срабатывании события.
+     */
+    protected readonly listener: () => void;
+    /**
+     * Performs status check and activates events when turned on.
+     *
+     * Выполняет проверку статуса и активизирует события при включении.
+     */
+    protected readonly make: () => void;
+}

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

@@ -0,0 +1,80 @@
+import { WindowElement } from './WindowElement';
+import { WindowStatusItem } from './basicTypes';
+import { Ref } from 'vue';
+/**
+ * A class that changes the status of the current component. This is needed for
+ * working with animation and behavior of the element when opening/closing.
+ *
+ * Класс, отвечающий за изменение статуса текущего компонента. Это нужно для работы
+ * с анимацией и поведением элемента при открытии/закрытии.
+ */
+export declare class WindowStatus {
+    protected readonly element: WindowElement;
+    readonly item: Ref<WindowStatusItem, WindowStatusItem>;
+    /**
+     * Constructor
+     * @param element an object of the class for working with elements/ объект класса для работы с элементами
+     */
+    constructor(element: WindowElement);
+    /**
+     * Checks if the current status is closed (hide).
+     *
+     * Проверяет, является ли текущий статус закрытым (hide).
+     */
+    isHide(): boolean;
+    /**
+     * Checks if the current status is open (open/flash).
+     *
+     * Проверяет, является ли текущий статус открытым (open/flash).
+     */
+    isOpen(): boolean;
+    /**
+     * Change the current status.
+     *
+     * Изменить текущий статус.
+     * @param value value/ значение
+     */
+    set(value: WindowStatusItem): this;
+    /**
+     * Translates status to display.
+     *
+     * Переводит статус в display.
+     */
+    toDisplay(): this;
+    /**
+     * Translates status to preparation.
+     *
+     * Переводит статус в preparation.
+     */
+    toPreparation(): this;
+    /**
+     * Translates status to flash.
+     *
+     * Переводит статус в flash.
+     */
+    toFlash(): this;
+    /**
+     * Translates status to open.
+     *
+     * Переводит статус в open.
+     */
+    toOpen(): this;
+    /**
+     * Translates status to hide.
+     *
+     * Переводит статус в hide.
+     */
+    toHide(): this;
+    /**
+     * Translates status to close.
+     *
+     * Переводит статус в close.
+     */
+    toClose(): this;
+    /**
+     * Updates the data-status attribute on the main element and teleport element.
+     *
+     * Обновляет атрибут data-status на основном элементе и элементе телепорта.
+     */
+    update(): void;
+}

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

@@ -0,0 +1,38 @@
+import { WindowElement } from './WindowElement';
+import { WindowCoordinates } from './WindowCoordinates';
+import { WindowPosition } from './WindowPosition';
+import { WindowOrigin } from './WindowOrigin';
+/**
+ * Style management class.
+ *
+ * Класс управления стилями.
+ */
+export declare class WindowStyles {
+    protected readonly element: WindowElement;
+    protected readonly coordinates: WindowCoordinates;
+    protected readonly position: WindowPosition;
+    protected readonly origin: WindowOrigin;
+    protected readonly className: string;
+    /**
+     * Constructor
+     * @param element an object of the class for working with elements/ объект класса для работы с элементами
+     * @param coordinates object for working with coordinates/ объект для работы с координатами
+     * @param position object for working with the position of the element/ объект для работы с положением элемента
+     * @param origin the object for work is in the initial position upon opening/ объект для работы в начальной позиции при открытии
+     * @param className class name/ название класса
+     */
+    constructor(element: WindowElement, coordinates: WindowCoordinates, position: WindowPosition, origin: WindowOrigin, className: string);
+    /**
+     * Data update.
+     *
+     * Обновление данных.
+     */
+    update(): void;
+    /**
+     * Updates the window type (menu or modal).
+     *
+     * Обновляет тип окна (меню или модальное).
+     * @param isMenu whether the window is a menu/ является ли окно меню
+     */
+    updateType(isMenu: boolean): void;
+}

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

@@ -0,0 +1,126 @@
+import { WindowPersistent } from './WindowPersistent';
+import { WindowClasses } from './WindowClasses';
+import { WindowElement } from './WindowElement';
+import { WindowStatic } from './WindowStatic';
+import { WindowOpen } from './WindowOpen';
+import { WindowProps } from './props';
+/**
+ * Class for managing the opening and closing of the window.
+ *
+ * Класс для управления открытием и закрытием окна.
+ */
+export declare class WindowVerification {
+    protected readonly props: WindowProps;
+    protected readonly persistent: WindowPersistent;
+    protected readonly classes: WindowClasses;
+    protected readonly element: WindowElement;
+    protected readonly staticMode: WindowStatic;
+    protected readonly open: WindowOpen;
+    protected target?: HTMLElement;
+    protected focus?: HTMLElement;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param persistent object for working with the animation before turning off the window/ объект для работы с анимацией перед выключением окна
+     * @param classes an object for working with classes and searching for elements/ объект для работы с классами и поиском элементов
+     * @param element an object of the class for working with elements/ объект класса для работы с элементами
+     * @param staticMode class object for working with static status/ объект класса для работы со статическим статусом
+     * @param open the class object for working with the status of closing or opening the window/ объект класса для работы со статусом закрытия или открытия окна
+     */
+    constructor(props: WindowProps, persistent: WindowPersistent, classes: WindowClasses, element: WindowElement, staticMode: WindowStatic, open: WindowOpen);
+    /**
+     * Updates the window opening status.
+     *
+     * Обновления статус открытия окно.
+     * @param target the selected window/ выбранное окно
+     */
+    update(target: HTMLElement): Promise<void>;
+    /**
+     * Returns the element in focus.
+     *
+     * Возвращает элемент в фокусе.
+     */
+    getFocus(): HTMLElement | undefined;
+    protected getTarget<R extends HTMLElement>(): R;
+    /**
+     * Checks if the selected element is in focus.
+     *
+     * Проверяет, находится ли выбранный элемент в фокусе.
+     */
+    protected isFocus(): boolean;
+    /**
+     * Checks if the target element is the window itself.
+     *
+     * Проверяет, является ли элемент-цель самим окном.
+     */
+    protected isTarget(): boolean;
+    protected isTargetInBody(): boolean;
+    /**
+     * Checks if the selected window is under other windows.
+     *
+     * Проверяет, находится ли выбранное окно под другими окнами.
+     * @param target the selected window/ выбранное окно
+     */
+    protected isChildren(target?: HTMLElement): boolean;
+    /**
+     * Checks if the window is enabled or if the conditions for opening the window are met.
+     *
+     * Проверяет, включено ли окно или подходят ли условия для открытия окна.
+     */
+    protected isEnabled(): boolean;
+    /**
+     * Checks if the window needs to be closed automatically.
+     *
+     * Проверяет, нужно ли автоматически закрывать окно.
+     */
+    protected isAutoClose(): boolean;
+    /**
+     * Checks if the change of the opening status of the window is blocked.
+     *
+     * Проверяет, заблокировано ли изменение статуса открытия окна.
+     */
+    protected isNotBlock(): boolean;
+    /**
+     * Checks if the change of the opening status of the window is blocked.
+     *
+     * Проверяет, заблокировано ли изменение статуса открытия окна.
+     * @param item element for testing/ элемент для проверки
+     */
+    protected isNotBlockItem(item?: HTMLElement): boolean;
+    /**
+     * Checks if there is an element with a close lock.
+     *
+     * Проверяет, есть ли элемент с блокировкой закрытия.
+     */
+    protected isNotBlockChildren(): boolean;
+    /**
+     * Checks if there is a blocking element from other windows.
+     *
+     * Проверяет, есть ли блокирующий элемент от других окон.
+     */
+    protected isBlockOther(): boolean;
+    /**
+     * Checks if it needs to be opened when the right button is pressed.
+     *
+     * Проверяет, нужно ли открывать при нажатии правой кнопки.
+     */
+    protected isContextmenu(): boolean;
+    /**
+     * Checks if the window can be closed.
+     *
+     * Проверяет, можно ли закрыть окно.
+     */
+    protected isClose(): boolean;
+    /**
+     * Checks if the element is a menu.
+     *
+     * Проверяет, является ли элемент меню.
+     */
+    protected isMenu(element?: HTMLElement | undefined): boolean;
+    /**
+     * Checks if the element should only open.
+     *
+     * Проверяет, должен ли элемент только открываться.
+     */
+    protected isOpenOnly(): boolean;
+}

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

@@ -0,0 +1,173 @@
+import { ComputedRef, Ref } from 'vue';
+import { ConstrBind } from '@dxtmisha/functional';
+import { AriaList } from '../../types/ariaTypes';
+import { WindowExpose } from './types';
+import { WindowPropsBasic } from './props';
+/**
+ * Window status items for different states of window lifecycle/
+ * Элементы статуса окна для различных состояний жизненного цикла окна
+ */
+export declare enum WindowStatusItem {
+    /** Display state/ Состояние отображения */
+    display = "display",
+    /** Preparation state/ Состояние подготовки */
+    preparation = "preparation",
+    /** Flash state/ Состояние вспышки */
+    flash = "flash",
+    /** Open state/ Состояние открытия */
+    open = "open",
+    /** Hide state/ Состояние скрытия */
+    hide = "hide",
+    /** Close state/ Состояние закрытия */
+    close = "close"
+}
+/**
+ * Window status control items for managing window behavior and appearance/
+ * Элементы управления статусом окна для управления поведением и внешним видом окна
+ */
+export declare enum WindowStatusControlItem {
+    /** Block interaction/ Блокировка взаимодействия */
+    block = "block",
+    /**
+     * Block window closing, class added to elements inside window/
+     * Блокировка закрытия окна, класс добавляется к элементам внутри окна
+     */
+    blockChildren = "blockChildren",
+    /** Block other windows/ Блокировка других окон */
+    blockOther = "blockOther",
+    /** Close window/ Закрыть окно */
+    close = "close",
+    /** Static positioning/ Статическое позиционирование */
+    static = "static",
+    /** Static control/ Статическое управление */
+    controlStatic = "controlStatic",
+    /** Control only when open/ Управление только когда открыто */
+    controlOpenOnly = "controlOpenOnly",
+    /** Active control/ Активное управление */
+    controlActive = "controlActive",
+    /** Persistent window/ Постоянное окно */
+    persistent = "persistent"
+}
+/**
+ * Options for window events/
+ * Опции для событий окна
+ */
+export type WindowEmitOptions = {
+    /** Unique window identifier/ Уникальный идентификатор окна */
+    id: string;
+    /** Window DOM element/ DOM элемент окна */
+    element: HTMLDivElement;
+    /** Control DOM element/ DOM элемент управления */
+    control: HTMLElement;
+    /** Window open state/ Состояние открытия окна */
+    open: boolean;
+};
+/**
+ * List of CSS classes for window styling/
+ * Список CSS классов для стилизации окна
+ */
+export type WindowClassesList = {
+    /** Main block class/ Основной класс блока */
+    block: string;
+    /** Block children class/ Класс дочерних элементов блока */
+    blockChildren: string;
+    /** Block other windows class/ Класс блокировки других окон */
+    blockOther: string;
+    /** Close button class/ Класс кнопки закрытия */
+    close: string;
+    /** Static positioning class/ Класс статического позиционирования */
+    static: string;
+    /** Control element class/ Класс элемента управления */
+    control: string;
+    /** Control ID class/ Класс ID управления */
+    controlId: string;
+    /** Static control class/ Класс статического управления */
+    controlStatic: string;
+    /** Open-only control class/ Класс управления только для открытого состояния */
+    controlOpenOnly: string;
+    /** Active control class/ Класс активного управления */
+    controlActive: string;
+    /** Persistent window class/ Класс постоянного окна */
+    persistent: string;
+};
+/**
+ * Window event click handler/
+ * Обработчик события клика окна
+ */
+export type WindowEventClick = (event: MouseEvent & TouchEvent) => Promise<void>;
+/**
+ * Interface for window classes inclusion/
+ * Интерфейс для включения классов окна
+ */
+export type WindowControlBasic = {
+    /** Window CSS classes list/ Список CSS классов окна */
+    classesWindow: WindowClassesList;
+};
+/**
+ * Control item data for window management/
+ * Данные элемента управления для управления окном
+ */
+export type WindowControlItem = WindowControlBasic & {
+    /** CSS class string/ Строка CSS класса */
+    class: string;
+    /** Reactive open state/ Реактивное состояние открытия */
+    open: Ref<boolean>;
+    /** Click event handler/ Обработчик события клика */
+    onclick: WindowEventClick;
+    /** Context menu event handler/ Обработчик события контекстного меню */
+    oncontextmenu: WindowEventClick;
+    /** Binding properties/ Свойства привязки */
+    binds: AriaList & {
+        /** Binding class/ Класс привязки */
+        class: string;
+        /** Click event handler for binding/ Обработчик события клика для привязки */
+        onclick: WindowEventClick;
+        /** Context menu event handler for binding/ Обработчик события контекстного меню для привязки */
+        oncontextmenu: WindowEventClick;
+    };
+};
+/**
+ * Component map for including the Window component/
+ * Карта компонентов для подключения компонента Window
+ */
+export type WindowComponentInclude = {
+    window?: object;
+};
+/**
+ * Event map for Window include/
+ * Карта событий для подключения Window
+ */
+export type WindowEmitsInclude = {
+    window: [options: WindowEmitOptions];
+};
+/**
+ * Interface for window expose inclusion/
+ * Интерфейс для включения expose окна
+ */
+export interface WindowExposeInclude {
+    id: ComputedRef<string | undefined>;
+    open: ComputedRef<boolean>;
+    control: ComputedRef<WindowControlItem | undefined>;
+    setOpen: WindowExpose['setOpen'];
+    toOpen: WindowExpose['toOpen'];
+    toClose: WindowExpose['toClose'];
+    toggle: WindowExpose['toggle'];
+    windowElement: Ref<ConstrBind<WindowExpose> | undefined>;
+}
+/**
+ * Props used to include and configure the Window component/
+ * Свойства для подключения и настройки компонента Window
+ */
+export interface WindowPropsInclude<Window extends WindowPropsBasic = WindowPropsBasic> {
+    /** Disabled state/ Отключённое состояние */
+    disabled?: boolean;
+    /** Enable auto close on outside click/ Включить авто-закрытие при клике вне */
+    autoClose?: boolean;
+    /** Additional attributes for Window component/ Дополнительные атрибуты для компонента Window */
+    windowAttrs?: ConstrBind<Window>;
+}
+/**
+ * CSS variable name for MotionTransform body type/
+ * Имя CSS‑переменной для типа тела MotionTransform
+ */
+export declare const __WINDOW_TYPE_BODY_NAME = "--sys-type-body";

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

@@ -0,0 +1,7 @@
+export * from './Window';
+export * from './WindowDesign';
+export * from './WindowInclude';
+export * from './WindowClassesInclude';
+export * from './props';
+export type * from './types';
+export type * from './basicTypes';

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

@@ -0,0 +1,64 @@
+import { ElementOrString, NormalOrPromise } from '@dxtmisha/functional';
+import { AriaByPropsInclude, AriaHaspopupPropsInclude, AriaRoleByPropsInclude } from '../../types/ariaTypes';
+import { ImagePropsBasic, ImagePropsInclude } from '../Image';
+import { ScrollbarPropsBasic, ScrollbarPropsInclude } from '../Scrollbar';
+import { TextClosePropsInclude } from '../../types/textTypes';
+interface WindowPropsToken {
+    width?: string | 'auto' | 'max' | 'custom';
+    height?: string | 'auto' | 'max' | 'custom';
+    hide?: boolean;
+    axis?: 'x' | 'y' | 'on';
+    imagePosition?: 'top' | 'left';
+    dense?: boolean;
+    alignment?: 'center' | 'top' | 'topRight' | 'topLeft' | 'topFull' | 'right' | 'rightFull' | 'bottom' | 'bottomRight' | 'bottomLeft' | 'bottomFull' | 'left' | 'leftFull';
+    origin?: 'center' | 'top' | 'right' | 'bottom' | 'left' | 'topToBottom' | 'rightToLeft' | 'bottomToTop' | 'leftToRight';
+    adaptive?: 'menu' | 'menuWindow' | 'modal' | 'modalDynamic' | 'actionSheetRight' | 'actionSheetBottom' | 'static';
+    fullscreen?: boolean;
+    overscroll?: boolean;
+    closeMobileHide?: boolean;
+    widthMatch?: boolean;
+}
+export interface WindowPropsBasic<Scrollbar extends ScrollbarPropsBasic = ScrollbarPropsBasic, Image extends ImagePropsBasic = ImagePropsBasic> extends ScrollbarPropsInclude<Scrollbar>, ImagePropsInclude<Image>, AriaRoleByPropsInclude, AriaByPropsInclude, AriaHaspopupPropsInclude, TextClosePropsInclude {
+    'open'?: boolean;
+    'disabled'?: boolean;
+    'preparation'?(): NormalOrPromise<void>;
+    'beforeOpening'?(): NormalOrPromise<boolean>;
+    'opening'?(): NormalOrPromise<boolean>;
+    'beforeClosing'?(): NormalOrPromise<boolean>;
+    'closing'?(): NormalOrPromise<boolean>;
+    'contextmenu'?: boolean;
+    'staticMode'?: boolean;
+    'overElement'?: ElementOrString<HTMLElement>;
+    'autoClose'?: boolean;
+    'persistent'?: boolean;
+    'flash'?: boolean;
+    'inDom'?: boolean;
+    'indent'?: number;
+    'divider'?: boolean;
+    'closeButton'?: boolean;
+    'iconClose'?: string;
+    'modelOpen'?: boolean;
+    'onUpdate:open'?: (value: boolean) => void;
+    'onUpdate:modelOpen'?: (value: boolean) => void;
+}
+/**
+ * Type describing incoming properties.
+ *
+ * Тип, описывающий входящие свойства.
+ */
+export interface WindowProps extends WindowPropsBasic, WindowPropsToken {
+}
+/**
+ * Default value for property.
+ *
+ * Значение по умолчанию для свойства.
+ */
+export declare const defaultsWindow: {
+    axis: string;
+    imagePosition: string;
+    overscroll: boolean;
+    indent: number;
+    ariaHaspopup: string;
+    role: string;
+};
+export {};