@dxtmisha/constructor 0.30.1 → 0.39.3

package/src/constructors/Scrollbar/ScrollbarBorder.ts

@@ -1,243 +0,0 @@
-import { onUnmounted, type ToRefs, watch } from 'vue'
-import {
-  type ConstrEmit,
-  type ConstrValue,
-  EventItem
-} from '@dxtmisha/functional'
-
-import type { ScrollbarProps } from './props'
-import type { ScrollbarEmits } from './types'
-
-const SCROLLBAR_SHIFT = 8
-
-/**
- * ScrollbarBorder class provides functionality for updating scroll position and displaying borders.
- * It monitors scroll events and manages visual feedback for top and bottom scroll boundaries.
- *
- * Класс ScrollbarBorder предоставляет функциональность для обновления положения скролла и отображения границ.
- * Он отслеживает события скролла и управляет визуальной обратной связью для верхней и нижней границ скролла.
- */
-export class ScrollbarBorder {
-  private event?: EventItem<HTMLDivElement, Event, any>
-  private eventSub?: EventItem<HTMLDivElement, Event, any>
-
-  /**
-   * Top boundary state/ состояние верхней границы
-   */
-  private top: boolean = false
-
-  /**
-   * Bottom boundary state/ состояние нижней границы
-   */
-  private bottom: boolean = false
-
-  /**
-   * Constructor for ScrollbarBorder class.
-   *
-   * Конструктор класса ScrollbarBorder.
-   * @param props properties/ свойства
-   * @param refs input data in the form of reactive elements/ входные данные в виде реактивных элементов
-   * @param element input element/ элемент ввода
-   * @param className class name/ название класса
-   * @param emits the function is called when an event is triggered/ функция вызывается, когда срабатывает событие
-   */
-  constructor(
-    protected readonly props: ScrollbarProps,
-    refs: ToRefs<ScrollbarProps>,
-    protected readonly element: ConstrValue<HTMLDivElement>,
-    protected readonly className: string,
-    protected readonly emits?: ConstrEmit<ScrollbarEmits>
-  ) {
-    watch([
-      this.element,
-      refs.divider,
-      refs.dividerTop,
-      refs.dividerBottom,
-      refs.inverse
-    ], this.reset, { immediate: true })
-
-    onUnmounted(() => this.stop())
-  }
-
-  /**
-   * Changing the monitoring status depending on the border parameter.
-   *
-   * Изменение статуса слежения в зависимости от параметра border.
-   */
-  readonly toggle = (): void => {
-    if (
-      this.props.divider
-      || this.props.dividerTop
-      || this.props.dividerBottom
-    ) {
-      this.start()
-    } else {
-      this.stop()
-    }
-  }
-
-  /**
-   * Updating the monitoring element for the event object.
-   *
-   * Обновление элемента слежения для объекта события.
-   */
-  readonly reset = (): void => {
-    if (this.element.value) {
-      if (this.event) {
-        this.event.setElement(this.element.value)
-
-        if (
-          this.eventSub
-          && this.element.value.children?.[0]
-        ) {
-          this.eventSub.setElement(this.element.value.children[0] as HTMLDivElement)
-        }
-      }
-
-      this.toggle()
-      this.update()
-    } else {
-      this.stop()
-    }
-  }
-
-  /**
-   * Start monitoring the scroll.
-   *
-   * Начать слежение за скроллом.
-   */
-  start(): void {
-    if (this.event) {
-      this.event.start()
-    } else {
-      this.event = new EventItem<HTMLDivElement, Event>(this.element.value, ['scroll-sync'], this.on)
-        .start()
-    }
-
-    if (this.eventSub) {
-      this.eventSub.start()
-    } else if (
-      this.element.value?.children?.[0]
-    ) {
-      this.eventSub = new EventItem<HTMLDivElement, Event>(this.element.value.children[0] as HTMLDivElement, ['resize'], this.on)
-        .start()
-    }
-
-    this.on()
-  }
-
-  /**
-   * Stopping the monitoring of scroll changes.
-   *
-   * Остановка слежения за изменениями скролла.
-   */
-  stop(): void {
-    if (this.event) {
-      this.event.stop()
-      this.event = undefined
-    }
-
-    if (this.eventSub) {
-      this.eventSub.stop()
-      this.eventSub = undefined
-    }
-  }
-
-  /**
-   * Updates the list of active classes.
-   *
-   * Обновляет список активных классов.
-   */
-  protected readonly update = () => {
-    const element = this.element.value
-
-    if (element) {
-      element.classList.toggle(`${this.className}--divider--top`, this.top)
-      element.classList.toggle(`${this.className}--divider--bottom`, this.bottom)
-      element.dataset.scrollbarDivider = this.top || this.bottom ? 'divider' : 'none'
-    }
-  }
-
-  /**
-   * Function for the event of monitoring scroll changes.
-   *
-   * Функция для события слежения за изменениями скролла.
-   */
-  protected readonly on = (): void => {
-    const element = this.element.value
-
-    if (element) {
-      this.setData(
-        element.scrollTop > SCROLLBAR_SHIFT,
-        element.scrollTop < element.scrollHeight - element.clientHeight - SCROLLBAR_SHIFT
-      )
-    }
-  }
-
-  /**
-   * Changing the data for class output.
-   *
-   * Изменение данных для вывода класса.
-   * @param top status of the top border display/ статус отображения верхнего бордера
-   * @param bottom status of the bottom border display/ статус отображения нижнего бордера
-   */
-  protected setData(
-    top: boolean,
-    bottom: boolean
-  ): this {
-    if (
-      this.top !== top
-      || this.bottom !== bottom
-    ) {
-      this.setTop(top)
-        .setBottom(bottom)
-        .update()
-    }
-
-    return this
-  }
-
-  /**
-   * Sets the top boundary state and emits related events.
-   *
-   * Устанавливает состояние верхней границы и генерирует связанные события.
-   * @param top status of the top border display/ статус отображения верхнего бордера
-   */
-  private setTop(top: boolean): this {
-    if (this.top !== top) {
-      this.top = top
-
-      this.emits?.('top', top)
-      this.emits?.('edge', top, this.bottom, 'top')
-
-      if (top) {
-        this.emits?.('reachTop')
-      } else {
-        this.emits?.('leaveTop')
-      }
-    }
-    return this
-  }
-
-  /**
-   * Sets the bottom boundary state and emits related events.
-   *
-   * Устанавливает состояние нижней границы и генерирует связанные события.
-   * @param bottom status of the bottom border display/ статус отображения нижнего бордера
-   */
-  private setBottom(bottom: boolean): this {
-    if (this.bottom !== bottom) {
-      this.bottom = bottom
-
-      this.emits?.('bottom', bottom)
-      this.emits?.('edge', this.top, bottom, 'bottom')
-
-      if (bottom) {
-        this.emits?.('reachBottom')
-      } else {
-        this.emits?.('leaveBottom')
-      }
-    }
-    return this
-  }
-}

package/src/constructors/Scrollbar/ScrollbarDesign.tsx

@@ -1,126 +0,0 @@
-import { h, type VNode } from 'vue'
-import {
-  type ConstrOptions,
-  type ConstrStyles,
-  DesignConstructorAbstract
-} from '@dxtmisha/functional'
-
-import { Scrollbar } from './Scrollbar'
-
-import {
-  type ScrollbarPropsBasic
-} from './props'
-import {
-  type ScrollbarClasses,
-  type ScrollbarComponents,
-  type ScrollbarEmits,
-  type ScrollbarExpose,
-  type ScrollbarSlots
-} from './types'
-
-/**
- * ScrollbarDesign
- */
-export class ScrollbarDesign<
-  COMP extends ScrollbarComponents,
-  EXPOSE extends ScrollbarExpose,
-  CLASSES extends ScrollbarClasses,
-  P extends ScrollbarPropsBasic
-> extends DesignConstructorAbstract<
-    HTMLDivElement,
-    COMP,
-    ScrollbarEmits,
-    EXPOSE,
-    ScrollbarSlots,
-    CLASSES,
-    P
-  > {
-  protected readonly item: Scrollbar
-
-  /**
-   * Constructor
-   * @param name class name/ название класса
-   * @param props properties/ свойства
-   * @param options list of additional parameters/ список дополнительных параметров
-   */
-  constructor(
-    name: string,
-    props: Readonly<P>,
-    options?: ConstrOptions<COMP, ScrollbarEmits, P>
-  ) {
-    super(
-      name,
-      props,
-      options
-    )
-
-    this.item = new Scrollbar(
-      this.props,
-      this.refs,
-      this.element,
-      this.getDesign(),
-      this.getName(),
-      this.components,
-      this.slots,
-      this.emits
-    )
-
-    this.init()
-  }
-
-  /**
-   * Initialization of all the necessary properties for work
-   *
-   * Инициализация всех необходимых свойств для работы.
-   */
-  protected initExpose(): EXPOSE {
-    return {} as EXPOSE
-  }
-
-  /**
-   * Improvement of the obtained list of classes.
-   *
-   * Доработка полученного списка классов.
-   */
-  protected initClasses(): Partial<CLASSES> {
-    return {
-      main: this.item.classes.value,
-      ...{
-        // :classes [!] System label / Системная метка
-        // :classes [!] System label / Системная метка
-      }
-    } as Partial<CLASSES>
-  }
-
-  /**
-   * Refinement of the received list of styles.
-   *
-   * Доработка полученного списка стилей.
-   */
-  protected initStyles(): ConstrStyles {
-    return {}
-  }
-
-  /**
-   * A method for rendering.
-   *
-   * Метод для рендеринга.
-   */
-  protected initRender(): VNode | undefined {
-    const children: any[] = [this.initSlot('default')]
-
-    if (this.item.width.is.value) {
-      return h(
-        this.props.tag ?? 'div',
-        {
-          ...this.getAttrs(),
-          ref: this.element,
-          class: this.classes?.value.main
-        },
-        children
-      )
-    }
-
-    return undefined
-  }
-}

package/src/constructors/Scrollbar/ScrollbarInclude.ts

@@ -1,80 +0,0 @@
-import { h, type VNode } from 'vue'
-import { type ConstrEmit, DesignComponents, toBind } from '@dxtmisha/functional'
-
-import type { ScrollbarComponentsInclude, ScrollbarEmitsInclude, ScrollbarPropsInclude, ScrollbarEdgeType } from './basicTypes'
-
-/**
- * ScrollbarInclude class provides functionality for conditionally rendering scrollbar components
- * within other components. It manages the logic for determining when to display a scrollbar
- * and configures the appropriate properties.
- *
- * Класс ScrollbarInclude предоставляет функциональность для условного рендеринга компонентов
- * скроллбара внутри других компонентов. Он управляет логикой определения необходимости
- * отображения скроллбара и настраивает соответствующие свойства.
- *
- * @template Props - Properties interface extending ScrollbarPropsInclude
- */
-export class ScrollbarInclude<Props extends ScrollbarPropsInclude = ScrollbarPropsInclude> {
-  /**
-   * Constructor
-   * @param props input parameter/ входной параметр
-   * @param className class name/ название класса
-   * @param components object for working with components/ объект для работы с компонентами
-   * @param emits the function is called when an event is triggered/ функция вызывается, когда срабатывает событие
-   */
-  constructor(
-    protected readonly props: Readonly<Props>,
-    protected readonly className: string,
-    protected readonly components?: DesignComponents<ScrollbarComponentsInclude, Props>,
-    protected readonly emits?: ConstrEmit<ScrollbarEmitsInclude>
-  ) {
-  }
-
-  /**
-   * Renders scrollbar component or fallback element
-   * Рендерит компонент скроллбара или элемент по умолчанию
-   */
-  render(
-    tag: string,
-    props?: Record<string, any>,
-    children?: any
-  ): VNode[] {
-    if (this.components) {
-      const scrollbar = this.components.renderOne(
-        'scrollbar',
-        toBind(
-          {
-            tag,
-            class: `${this.className}__scrollbar`,
-            ...(props ?? {}),
-            ...this.getScrollbarEvents()
-          },
-          this.props.scrollbarAttrs ?? {}
-        ),
-        children
-      )
-
-      if (scrollbar) {
-        return [scrollbar]
-      }
-    }
-
-    return [h(tag, props, children)]
-  }
-
-  /**
-   * Returns event handlers for scrollbar
-   * Возвращает обработчики событий для скроллбара
-   */
-  protected getScrollbarEvents() {
-    return {
-      onTop: (isTop: boolean) => this.emits?.('scrollbarTop', isTop),
-      onReachTop: () => this.emits?.('scrollbarReachTop'),
-      onLeaveTop: () => this.emits?.('scrollbarLeaveTop'),
-      onBottom: (isBottom: boolean) => this.emits?.('scrollbarBottom', isBottom),
-      onReachBottom: () => this.emits?.('scrollbarReachBottom'),
-      onLeaveBottom: () => this.emits?.('scrollbarLeaveBottom'),
-      onEdge: (isTop: boolean, isBottom: boolean, edge: ScrollbarEdgeType) => this.emits?.('scrollbarEdge', isTop, isBottom, edge)
-    }
-  }
-}

package/src/constructors/Scrollbar/basicTypes.ts

@@ -1,42 +0,0 @@
-import type { ConstrBind } from '@dxtmisha/functional'
-
-import type { ScrollbarPropsBasic } from './props'
-import type { ScrollbarEmits } from './types'
-
-/**
- * Type describing the edge position of the scrollbar/
- * Тип, описывающий позицию края скроллбара
- */
-export type ScrollbarEdgeType = 'top' | 'bottom'
-
-/**
- * Interface for describing which components need to be connected for work/
- * Интерфейс для описания, какие компоненты надо подключить для работы
- */
-export type ScrollbarComponentsInclude = {
-  scrollbar?: object
-}
-
-/**
- * Interface for describing available events with scrollbar prefix/
- * Интерфейс для описания доступных событий с префиксом scrollbar
- */
-export type ScrollbarEmitsInclude = {
-  scrollbarTop: ScrollbarEmits['top']
-  scrollbarReachTop: ScrollbarEmits['reachTop']
-  scrollbarLeaveTop: ScrollbarEmits['leaveTop']
-  scrollbarBottom: ScrollbarEmits['bottom']
-  scrollbarReachBottom: ScrollbarEmits['reachBottom']
-  scrollbarLeaveBottom: ScrollbarEmits['leaveBottom']
-  scrollbarEdge: ScrollbarEmits['edge']
-}
-
-/**
- * Interface for describing available properties for scrollbar inclusion/
- * Интерфейс для описания доступных свойств для включения скроллбара
- */
-export interface ScrollbarPropsInclude<
-  Scrollbar extends ScrollbarPropsBasic = ScrollbarPropsBasic
-> {
-  scrollbarAttrs?: ConstrBind<Scrollbar>
-}

package/src/constructors/Scrollbar/index.ts

@@ -1,5 +0,0 @@
-export * from './Scrollbar'
-export * from './ScrollbarDesign'
-export * from './props'
-export * from './types'
-export * from './basicTypes'

package/src/constructors/Scrollbar/properties.json

@@ -1,33 +0,0 @@
-{
-  "size": {
-    "_type": "var"
-  },
-  "background": {
-    "_type": "var"
-  },
-  "backgroundOpacity": {
-    "_type": "var"
-  },
-  "thumb": {
-    "background": {},
-    "opacity": {},
-    "rounded": {},
-    "hover": {
-      "opacity": {}
-    },
-    "_type": "var"
-  },
-  "outline": {
-    "width": {},
-    "color": {},
-    "opacity": {},
-    "_type": "var"
-  },
-  "~visible": {},
-  "~divider": {},
-  "~divider-top": {},
-  "~divider-bottom": {},
-  "~divider-hide": {},
-  "~inverse": {},
-  "~standard": {}
-}

package/src/constructors/Scrollbar/props.ts

@@ -1,37 +0,0 @@
-interface ScrollbarPropsToken {
-  // :type [!] System label / Системная метка
-  visible?: boolean
-  divider?: boolean
-  dividerTop?: boolean
-  dividerBottom?: boolean
-  dividerHide?: boolean
-  inverse?: boolean
-  standard?: boolean
-  // :type [!] System label / Системная метка
-}
-
-export interface ScrollbarPropsBasic {
-  // Style
-  tag?: string
-}
-
-/**
- * Type describing incoming properties.
- *
- * Тип, описывающий входящие свойства.
- */
-export interface ScrollbarProps extends ScrollbarPropsBasic, ScrollbarPropsToken {
-}
-
-/**
- * Default value for property.
- *
- * Значение по умолчанию для свойства.
- */
-export const defaultsScrollbar = {
-  tag: 'div',
-  ...{
-    // :default [!] System label / Системная метка
-    // :default [!] System label / Системная метка
-  }
-}

package/src/constructors/Scrollbar/types.ts

@@ -1,52 +0,0 @@
-import type { ConstrClass } from '@dxtmisha/functional'
-import type { ScrollbarEdgeType } from './basicTypes'
-
-/**
- * Interface for describing which components need to be connected for work.
- *
- * Интерфейс для описания, какие компоненты надо подключить для работы.
- */
-export type ScrollbarComponents = {}
-
-/**
- * Type describing available events.
- *
- * Тип, описывающий доступные события.
- */
-export type ScrollbarEmits = {
-  top: [isTop: boolean]
-  reachTop: []
-  leaveTop: []
-  bottom: [isBottom: boolean]
-  reachBottom: []
-  leaveBottom: []
-  edge: [isTop: boolean, isBottom: boolean, edge: ScrollbarEdgeType]
-}
-
-/**
- * Type describing available properties.
- *
- * Тип, описывающий доступные свойства.
- */
-export interface ScrollbarExpose {
-}
-
-/**
- * Type describing available slots.
- *
- * Тип, описывающий доступные слоты.
- */
-export interface ScrollbarSlots {
-  default?(props: any): any
-}
-
-/**
- * Type describing subclasses.
- *
- * Тип, описывающий подклассы.
- */
-export type ScrollbarClasses = {
-  main: ConstrClass
-  // :classes [!] System label / Системная метка
-  // :classes [!] System label / Системная метка
-}

package/src/constructors/Section/Section.ts

@@ -1,33 +0,0 @@
-import type { Ref, ToRefs } from 'vue'
-import { type ConstrEmit, DesignComp } from '@dxtmisha/functional'
-
-import type { SectionComponents, SectionEmits, SectionSlots } from './types'
-import type { SectionProps } from './props'
-
-/**
- * Section
- */
-export class Section {
-  /**
-   * 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(
-    protected readonly props: SectionProps,
-    protected readonly refs: ToRefs<SectionProps>,
-    protected readonly element: Ref<HTMLElement | undefined>,
-    protected readonly classDesign: string,
-    protected readonly className: string,
-    protected readonly components?: DesignComp<SectionComponents, SectionProps>,
-    protected readonly slots?: SectionSlots,
-    protected readonly emits?: ConstrEmit<SectionEmits>
-  ) {
-  }
-}