@dxtmisha/constructor 0.30.1 → 0.39.3

package/src/constructors/Window/WindowElement.ts

@@ -1,84 +0,0 @@
-import type { Ref } from 'vue'
-
-import { WindowClasses } from './WindowClasses'
-
-/**
- * A class for working with elements.
- *
- * Класс для работы с элементами.
- */
-export class WindowElement {
-  /**
-   * Constructor
-   * @param classes an object for working with classes and searching for elements/ объект для работы с классами и поиском элементов
-   * @param element the element of the window itself/ элемент самого окна
-   */
-  constructor(
-    protected readonly classes: WindowClasses,
-    public readonly element: Ref<HTMLDivElement | undefined>
-  ) {
-  }
-
-  /**
-   * Checks if the main element exists.
-   *
-   * Проверяет, есть ли главный элемент.
-   */
-  isMain(): boolean {
-    return Boolean(this.element.value)
-  }
-
-  /**
-   * Returns the main element.
-   *
-   * Возвращает главного элемента.
-   */
-  getMain(): HTMLDivElement | undefined {
-    return this.element.value
-  }
-
-  /**
-   * Returns the control element of the current component.
-   *
-   * Возвращает элемент управления текущего компонента.
-   */
-  getControl(): HTMLElement | undefined {
-    return this.classes.findControl()
-  }
-
-  /**
-   * Returns the dimensions of the control element.
-   *
-   * Возвращает размеры элемента управления.
-   */
-  getControlRect(): DOMRect | undefined {
-    return this.getControl()?.getBoundingClientRect() || undefined
-  }
-
-  /**
-   * Returns the body element of the window.
-   *
-   * Возвращает элемент тела окна.
-   */
-  getBody(): HTMLDivElement | undefined {
-    return this.classes.findBody()
-  }
-
-  /**
-   * Returns the dimensions of the window's body element.
-   *
-   * Возвращает размеры элемента тела окна.
-   */
-  getBodyRect(): DOMRect | undefined {
-    return this.getBody()?.getBoundingClientRect() || undefined
-  }
-
-  /**
-   * Returns the window context element.
-   *
-   * Возвращает элемент контекста окна.
-   */
-  getBodyContext(): HTMLDivElement | undefined {
-    return this.classes.findBodyContext()
-  }
-}

package/src/constructors/Window/WindowEmit.ts

@@ -1,52 +0,0 @@
-import type { ConstrEmit } from '@dxtmisha/functional'
-
-import { WindowClasses } from './WindowClasses'
-import { WindowElement } from './WindowElement'
-
-import type { WindowEmits } from './types'
-import type { WindowEmitOptions } from './basicTypes'
-
-/**
- * Class triggering a click status change event.
- *
- * Класс, вызывающий событие изменения статуса клика.
- */
-export class WindowEmit {
-  /**
-   * Constructor
-   * @param classes an object for working with classes and searching for elements/ объект для работы с классами и поиском элементов
-   * @param element an object of the class for working with elements/ объект класса для работы с элементами
-   * @param emits the function is called when an event is triggered/ функция вызывается, когда срабатывает событие
-   */
-  constructor(
-    protected readonly classes: WindowClasses,
-    protected readonly element: WindowElement,
-    protected readonly emits?: ConstrEmit<WindowEmits>
-  ) {
-  }
-
-  /**
-   * Perform events.
-   *
-   * Выполнить события.
-   * @param open current state of the window/ текущее состояние окна
-   */
-  on(open: boolean) {
-    this.emits?.('window', this.getEmitOptions(open))
-  }
-
-  /**
-   * Returns an object for calling the event handler.
-   *
-   * Возвращает объект для вызова обработчика события.
-   * @param open current state of the window/ текущее состояние окна
-   */
-  protected getEmitOptions(open: boolean): WindowEmitOptions {
-    return {
-      id: this.classes.getId(),
-      element: this.element.getMain() as HTMLDivElement,
-      control: this.element.getControl() as HTMLElement,
-      open
-    }
-  }
-}

package/src/constructors/Window/WindowEsc.ts

@@ -1,114 +0,0 @@
-import { type Ref, watch } from 'vue'
-import { EventItem, executeFunction, getRef, isDomRuntime, type RefOrNormal } from '@dxtmisha/functional'
-
-/**
- * Class for handling Escape key press to close windows.
- *
- * Класс для обработки нажатия клавиши Escape для закрытия окон.
- */
-export class WindowEsc {
-  /** Event handler instance/ Экземпляр обработчика событий */
-  protected event?: EventItem<HTMLElement, any>
-
-  /**
-   * Constructor
-   * @param open Reference to the open state/ Ссылка на состояние открытия
-   * @param on Optional callback function when Escape is pressed/ Необязательная функция обратного вызова при нажатии Escape
-   * @param active Reference to the active state/ Ссылка на состояние активности
-   */
-  constructor(
-    protected readonly open: Ref<boolean>,
-    protected readonly on?: () => void,
-    protected readonly active: RefOrNormal<boolean | (() => boolean)> = true
-  ) {
-    watch(
-      open,
-      (value) => {
-        if (executeFunction(getRef(this.active))) {
-          if (value) {
-            this.start()
-          } else {
-            this.stop()
-          }
-        }
-      }
-    )
-  }
-
-  /**
-   * Start listening for Escape key press.
-   *
-   * Начать прослушивание нажатия клавиши Escape.
-   */
-  start(): this {
-    this.make()
-    this.event?.start()
-
-    return this
-  }
-
-  /**
-   * Stop listening for Escape key press.
-   *
-   * Остановить прослушивание нажатия клавиши Escape.
-   */
-  stop(): this {
-    if (this.event) {
-      this.event.stop()
-      this.event = undefined
-    }
-
-    return this
-  }
-
-  /**
-   * Check if the pressed key is Escape.
-   *
-   * Проверяет, является ли нажатая клавиша Escape.
-   * @param event Keyboard event/ Событие клавиатуры
-   */
-  protected isEsc(event: KeyboardEvent): boolean {
-    return (
-      event.key === 'Escape'
-      || event.key === 'Esc'
-      || event.code === 'Escape'
-      || event.code === 'Esc'
-      || event.keyCode === 27
-    )
-  }
-
-  /**
-   * Event listener for keyboard events.
-   *
-   * Обработчик событий клавиатуры.
-   */
-  protected readonly listener = (event: KeyboardEvent): void => {
-    if (this.isEsc(event)) {
-      event.preventDefault()
-      event.stopPropagation()
-
-      if (this.on) {
-        this.on()
-      } else {
-        this.open.value = false
-      }
-
-      this.stop()
-    }
-  }
-
-  /**
-   * Create and initialize the event handler.
-   *
-   * Создать и инициализировать обработчик событий.
-   */
-  protected make(): void {
-    if (isDomRuntime() && !this.event) {
-      this.event = new EventItem<HTMLElement, any>(
-        document.body,
-        'keydown',
-        this.listener
-      )
-    }
-  }
-}

package/src/constructors/Window/WindowEvent.ts

@@ -1,157 +0,0 @@
-import { watch } from 'vue'
-import { EventItem, getMouseClientX, getMouseClientY } from '@dxtmisha/functional'
-
-import { WindowStatus } from './WindowStatus'
-import { WindowClient } from './WindowClient'
-import { WindowFlash } from './WindowFlash'
-import { WindowOpen } from './WindowOpen'
-import { WindowVerification } from './WindowVerification'
-
-import type { WindowProps } from './props'
-
-/**
- * A class for working with events.
- *
- * Класс для работы с событиями.
- */
-export class WindowEvent {
-  protected readonly event: EventItem<HTMLBodyElement, MouseEvent>
-
-  /**
-   * Constructor
-   * @param props input data/ входные данные
-   * @param status object for working with statuses/ объект для работы со статусами
-   * @param client object for working with mouse pointer coordinates/ объект для работы с координатами указателя мыши
-   * @param flash class object for working with fast window opening/ объект класса для работы с быстрым открытием окна
-   * @param open the class object for working with the status of closing or opening the window/ объект класса для работы со статусом закрытия или открытия окна
-   * @param verification an object for working with the check for changing the status of opening or closing/ объект для работы с проверкой изменения статуса открытия или закрытия
-   */
-  constructor(
-    protected readonly props: WindowProps,
-    protected readonly status: WindowStatus,
-    protected readonly client: WindowClient,
-    protected readonly flash: WindowFlash,
-    protected readonly open: WindowOpen,
-    protected readonly verification: WindowVerification
-  ) {
-    this.event = new EventItem<HTMLBodyElement, MouseEvent>(
-      'body',
-      ['click', 'contextmenu'],
-      this.onGlobal
-    )
-
-    watch(
-      [
-        this.open.item,
-        this.status.item
-      ],
-      () => this.toggle()
-    )
-  }
-
-  /**
-   * Events of pressing a control element.
-   *
-   * События нажатия на элемент управления.
-   * @param event event object/ объект события
-   */
-  readonly onClick = async (event: MouseEvent & TouchEvent): Promise<void> => {
-    if (!this.props.contextmenu) {
-      await this.on(event)
-    }
-  }
-
-  /**
-   * Events of pressing the right mouse button on a control element.
-   *
-   * События нажатия на правую кнопку мыши на элемент управления.
-   * @param event event object/ объект события
-   */
-  readonly onContextmenu = async (event: MouseEvent & TouchEvent): Promise<void> => {
-    if (this.props.contextmenu) {
-      event.preventDefault()
-      await this.on(event)
-    }
-  }
-
-  /**
-   * Event of animation end when closing the window.
-   *
-   * Событие окончания анимации при закрытии окна.
-   */
-  readonly onTransition = (): void => this.open.closeForEvent()
-
-  /**
-   * Starts listening to global events.
-   *
-   * Стартует прослушивание глобальных событий.
-   */
-  start(): this {
-    this.event.start()
-    return this
-  }
-
-  /**
-   * Stop the global event.
-   *
-   * Остановить глобальное событие.
-   */
-  stop(): this {
-    this.event.stop()
-    return this
-  }
-
-  /**
-   * Changes the event listening status depending on the window's open status.
-   *
-   * Изменяет статус прослушивания события в зависимости от статуса открытия окна.
-   */
-  toggle(): this {
-    if (
-      this.open.item.value
-      && this.status.isOpen()
-    ) {
-      this.start()
-    } else {
-      this.stop()
-    }
-
-    return this
-  }
-
-  /**
-   * Event activation.
-   *
-   * Активация события.
-   * @param event event object/ объект события
-   */
-  protected async on(event: MouseEvent & TouchEvent): Promise<void> {
-    this.client.set(
-      getMouseClientX(event),
-      getMouseClientY(event)
-    )
-
-    await this.verification.update(event.target as HTMLElement)
-  }
-
-  /**
-   * Callback of the event when pressing any area for checking and changing the opening state.
-   *
-   * Callback события при нажатии на любую область для проверки и изменения состояния открытия.
-   * @param event event instance/ экземпляр события
-   */
-  protected readonly onGlobal = async (event?: Event): Promise<void> => {
-    if (
-      !event
-      || (event.type === 'click' && (!this.props.contextmenu || this.open.item.value))
-      || (event.type === 'contextmenu' && this.props.contextmenu)
-    ) {
-      if (this.open.item.value) {
-        this.flash.setControl(event?.target as HTMLElement)
-        await this.verification.update(event?.target as HTMLElement)
-      } else {
-        this.event.stop()
-      }
-    }
-  }
-}

package/src/constructors/Window/WindowFlash.ts

@@ -1,70 +0,0 @@
-import { WindowClasses } from './WindowClasses'
-
-import type { WindowProps } from './props'
-import { WindowStatusItem } from './basicTypes'
-
-/**
- * The class for working with the flash parameter. The flash property is
- * responsible for disabling the animation when opening the window. Also,
- * the animation is disabled when there are already open windows.
- *
- * Класс для работы с параметром flash. Свойство flash отвечает за отключение
- * анимации при открытии окна. А также отключается анимация, когда уже есть
- * открытые окна.
- */
-export class WindowFlash {
-  protected control: boolean = false
-
-  /**
-   * Constructor
-   * @param props input data/ входные данные
-   * @param classes an object for working with classes and searching for elements/ объект для работы с классами и поиском элементов
-   */
-
-  constructor(
-    protected readonly props: WindowProps,
-    protected readonly classes: WindowClasses
-  ) {
-  }
-
-  /**
-   * Is the flash property active.
-   *
-   * Активно ли свойство flash.
-   */
-  is(): boolean {
-    return Boolean(this.props.flash)
-  }
-
-  /**
-   * Checks whether the animation needs to be disabled.
-   *
-   * Проверяет, надо ли отключить анимацию.
-   */
-  isOpen(): boolean {
-    return this.is() || this.control
-  }
-
-  /**
-   * Checks whether the animation needs to be disabled when closing.
-   *
-   * Проверяет, надо ли отключить анимацию при закрытии.
-   */
-  isClose(): boolean {
-    return this.is()
-      || Boolean(
-        document.querySelector(`.${this.classes.getClassStatus(WindowStatusItem.hide)}`)
-      )
-  }
-
-  /**
-   * Change the value of the control parameter.
-   *
-   * Изменить значение параметра control.
-   * @param target the element that gets focus on click/ элемент, который получает фокус при клике
-   */
-  setControl(target?: HTMLElement): this {
-    this.control = target?.closest<HTMLElement>(`.${this.classes.list.control}`)?.dataset.window === this.classes.getId()
-    return this
-  }
-}

package/src/constructors/Window/WindowHidden.ts

@@ -1,120 +0,0 @@
-import { watch } from 'vue'
-import { isDomRuntime } from '@dxtmisha/functional'
-import { AriaStaticInclude } from '../../classes/AriaStaticInclude'
-
-import { WindowClasses } from './WindowClasses'
-
-import type { WindowOpen } from './WindowOpen'
-
-/**
- * A class for managing the hiding of elements outside the window when it is open.
- *
- * Класс для управления скрытием элементов вне окна при его открытии.
- */
-export class WindowHidden {
-  protected elements: HTMLElement[] = []
-
-  /**
-   * Constructor
-   * @param classes an object for working with class names / объект для работы с названиями классов
-   * @param open an object for working with the open state of the window / объект для работы с состоянием открытия окна
-   */
-  constructor(
-    protected classes: WindowClasses,
-    protected open: WindowOpen
-  ) {
-    watch(
-      this.open.item,
-      (newValue: boolean) => {
-        if (newValue) {
-          this.toHidden()
-        } else {
-          this.toShow()
-        }
-      },
-      {
-        immediate: true
-      }
-    )
-  }
-
-  /**
-   * Returns the aria attribute data for hiding elements.
-   *
-   * Возвращает данные aria-атрибута для скрытия элементов.
-   */
-  protected getAriaData() {
-    const ariaHidden = AriaStaticInclude.hidden()
-    const ariaKey: any = Object.keys(ariaHidden)[0]
-    const ariaValue: any = Object.values(ariaHidden)[0]
-
-    return {
-      key: ariaKey,
-      value: ariaValue
-    }
-  }
-
-  /**
-   * Finds all elements outside the window that need to be hidden.
-   *
-   * Находит все элементы вне окна, которые нужно скрыть.
-   */
-  protected findElements(): NodeListOf<HTMLElement> | undefined {
-    if (isDomRuntime()) {
-      const id = this.classes.getId()
-      return document.querySelectorAll<HTMLElement>(
-        `body > *:not([data-window-teleport="${id}"]):not(.${id}):not(script):not(style)`
-      )
-    }
-
-    return undefined
-  }
-
-  /**
-   * Hides elements outside the window by adding aria-hidden attribute.
-   *
-   * Скрывает элементы вне окна, добавляя атрибут aria-hidden.
-   */
-  protected toHidden(): void {
-    const elements = this.findElements()
-
-    if (elements) {
-      const aria = this.getAriaData()
-
-      this.elements = []
-      elements.forEach((element: HTMLElement) => {
-        if (
-          element.hasAttribute(aria.key)
-          || element.hasAttribute('inert')
-        ) {
-          return
-        }
-
-        element.setAttribute(aria.key, aria.value)
-
-        if (!this.classes.isWindowOrTeleport(element)) {
-          element.setAttribute('inert', '')
-        }
-
-        this.elements.push(element)
-      })
-    } else {
-      this.elements = []
-    }
-  }
-
-  /**
-   * Shows previously hidden elements by removing aria-hidden attribute.
-   *
-   * Показывает ранее скрытые элементы, удаляя атрибут aria-hidden.
-   */
-  protected toShow(): void {
-    const aria = this.getAriaData()
-    this.elements
-      .forEach((element: HTMLElement) => {
-        element.removeAttribute(aria.key)
-        element.removeAttribute('inert')
-      })
-    this.elements = []
-  }
-}

package/src/constructors/Window/WindowHook.ts

@@ -1,110 +0,0 @@
-import { executePromise } from '@dxtmisha/functional'
-
-import type { WindowProps } from './props'
-
-/**
- * A class for working with hooks when opening and closing a window.
- *
- * Класс для работы с хуками при открытии и закрытии окна.
- */
-export class WindowHook {
-  /**
-   * Constructor
-   * @param props input data/ входные данные
-   */
-  constructor(
-    protected readonly props: WindowProps
-  ) {
-  }
-
-  /**
-   * Hook for preparing elements before opening/closing.
-   *
-   * Хук для подготовки элементов перед открытием/закрытием.
-   */
-  async preparation(): Promise<void> {
-    if (this.props.preparation) {
-      await executePromise(this.props.preparation)
-    }
-  }
-
-  /**
-   * Hook before opening/closing.
-   *
-   * Хук перед открытием/закрытием.
-   * @param open current state of the window/ текущее состояние окна
-   */
-  async before(open: boolean) {
-    if (open) {
-      return await this.beforeOpening()
-    }
-
-    return await this.beforeClosing()
-  }
-
-  /**
-   * Hook before opening.
-   *
-   * Хук перед открытием.
-   */
-  async beforeOpening(): Promise<boolean> {
-    if (this.props.beforeOpening) {
-      return await executePromise(this.props.beforeOpening)
-    }
-
-    return true
-  }
-
-  /**
-   * Hook before closing.
-   *
-   * Хук перед закрытием.
-   */
-  async beforeClosing(): Promise<boolean> {
-    if (this.props.beforeClosing) {
-      return await executePromise(this.props.beforeClosing)
-    }
-
-    return true
-  }
-
-  /**
-   * Hook after opening/closing.
-   *
-   * Хук после открытия/закрытия.
-   * @param open current state of the window/ текущее состояние окна
-   */
-  async after(open: boolean): Promise<boolean> {
-    if (open) {
-      return await this.opening()
-    }
-
-    return await this.closing()
-  }
-
-  /**
-   * Hook after opening.
-   *
-   * Хук после открытия.
-   */
-  async opening(): Promise<boolean> {
-    if (this.props.opening) {
-      return await executePromise(this.props.opening)
-    }
-
-    return false
-  }
-
-  /**
-   * Hook after closing.
-   *
-   * Хук после закрытия.
-   */
-  async closing(): Promise<boolean> {
-    if (this.props.closing) {
-      return await executePromise(this.props.closing)
-    }
-
-    return false
-  }
-}