@dxtmisha/constructor 0.30.1 → 0.39.3

package/src/constructors/Block/BlockDesign.tsx

@@ -1,219 +0,0 @@
-import { h, type VNode } from 'vue'
-import {
-  type ConstrOptions,
-  type ConstrStyles,
-  DesignConstructorAbstract
-} from '@dxtmisha/functional'
-
-import { AriaStaticInclude } from '../../classes/AriaStaticInclude'
-import { Block } from './Block'
-
-import {
-  type BlockPropsBasic
-} from './props'
-import {
-  type BlockClasses,
-  type BlockComponents,
-  type BlockEmits,
-  type BlockExpose,
-  type BlockSlots
-} from './types'
-
-/**
- * BlockDesign
- */
-export class BlockDesign<
-  COMP extends BlockComponents,
-  EXPOSE extends BlockExpose,
-  CLASSES extends BlockClasses,
-  P extends BlockPropsBasic
-> extends DesignConstructorAbstract<
-    HTMLDivElement,
-    COMP,
-    BlockEmits,
-    EXPOSE,
-    BlockSlots,
-    CLASSES,
-    P
-  > {
-  protected readonly item: Block
-
-  /**
-   * Constructor
-   * @param name class name/ название класса
-   * @param props properties/ свойства
-   * @param options list of additional parameters/ список дополнительных параметров
-   */
-  constructor(
-    name: string,
-    props: Readonly<P>,
-    options?: ConstrOptions<COMP, BlockEmits, P>
-  ) {
-    super(
-      name,
-      props,
-      options
-    )
-
-    this.item = new Block(
-      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: {},
-      ...{
-        // :classes [!] System label / Системная метка
-        headline: this.getSubClass('headline'),
-        header: this.getSubClass('header'),
-        label: this.getSubClass('label'),
-        description: this.getSubClass('description'),
-        caption: this.getSubClass('caption'),
-        icon: this.getSubClass('icon'),
-        space: this.getSubClass('space'),
-        body: this.getSubClass('body')
-        // :classes [!] System label / Системная метка
-      }
-    } as Partial<CLASSES>
-  }
-
-  /**
-   * Refinement of the received list of styles.
-   *
-   * Доработка полученного списка стилей.
-   */
-  protected initStyles(): ConstrStyles {
-    return {}
-  }
-
-  /**
-   * A method for rendering.
-   *
-   * Метод для рендеринга.
-   */
-  protected initRender(): VNode {
-    const children: any[] = [
-      ...this.renderHeadline(),
-      ...this.renderHeader(),
-      ...this.item.description.render(),
-      ...this.renderBody()
-    ]
-
-    return h(this.item.tag.value, {
-      ...this.getAttrs(),
-      class: this.classes?.value.main
-    }, children)
-  }
-
-  /**
-   * Headline rendering.
-   *
-   * Рендеринг заголовка.
-   */
-  protected readonly renderHeadline = (): VNode[] => {
-    if (this.item.isHeadline.value) {
-      const children: any[] = []
-
-      if (this.props.headline) {
-        children.push(this.props.headline)
-      }
-
-      this.initSlot('headline', children)
-
-      return [
-        h('div', {
-          key: 'headline',
-          class: this.classes?.value.headline
-        }, children)
-      ]
-    }
-
-    return []
-  }
-
-  /**
-   * Header rendering.
-   *
-   * Рендеринг заголовка.
-   */
-  protected readonly renderHeader = (): VNode[] => {
-    if (this.item.isHeader.value) {
-      const children: any[] = [
-        ...this.item.icon.renderIcon(),
-        ...this.item.label.render(),
-        ...this.item.caption.render(),
-        ...this.renderTrailing()
-      ]
-
-      return [
-        h('div', {
-          key: 'header',
-          class: this.classes?.value.header,
-          ...AriaStaticInclude.labelledby(this.item.label.idElement.value)
-        }, children)
-      ]
-    }
-
-    return []
-  }
-
-  /**
-   * Trailing rendering.
-   *
-   * Рендеринг правого контента.
-   */
-  protected readonly renderTrailing = (): VNode[] => {
-    const children: any[] = []
-
-    if (this.slots?.trailing) {
-      children.push(h('div', {
-        key: 'spacer',
-        class: this.classes?.value.space
-      }))
-
-      this.initSlot('trailing', children)
-    }
-
-    return children
-  }
-
-  /**
-   * Body rendering.
-   *
-   * Рендеринг тела.
-   */
-  protected readonly renderBody = (): VNode[] => {
-    this.initSlot('default')
-
-    return [
-      h('div', {
-        key: 'body',
-        class: this.classes?.value.body
-      }, this.initSlot('default'))
-    ]
-  }
-}

package/src/constructors/Block/index.ts

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

package/src/constructors/Block/properties.json

@@ -1,10 +0,0 @@
-{
-  "#headline": {},
-  "#header": {},
-  "#label": {},
-  "#description": {},
-  "#caption": {},
-  "#icon": {},
-  "#space": {},
-  "#body": {}
-}

package/src/constructors/Block/props.ts

@@ -1,46 +0,0 @@
-import type { IconPropsBasic, IconPropsInclude } from '../Icon'
-
-import type { LabelProps } from '../../types/labelTypes'
-import type { DescriptionProps } from '../../types/descriptionTypes'
-import type { CaptionProps } from '../../types/captionTypes'
-
-interface BlockPropsToken {
-  // :type [!] System label / Системная метка
-  // :type [!] System label / Системная метка
-}
-
-export interface BlockPropsBasic<
-  Icon extends IconPropsBasic = IconPropsBasic
-> extends LabelProps,
-  DescriptionProps,
-  CaptionProps,
-  IconPropsInclude<Icon> {
-  // Value
-  headline?: string
-
-  // Style
-  tag?: string
-  tagHeader?: string
-}
-
-/**
- * Type describing incoming properties.
- *
- * Тип, описывающий входящие свойства.
- */
-export interface BlockProps extends BlockPropsBasic, BlockPropsToken {
-}
-
-/**
- * Default value for property.
- *
- * Значение по умолчанию для свойства.
- */
-export const defaultsBlock = {
-  tag: 'div',
-  tagHeader: 'h3',
-  ...{
-    // :default [!] System label / Системная метка
-    // :default [!] System label / Системная метка
-  }
-}

package/src/constructors/Block/types.ts

@@ -1,64 +0,0 @@
-import type { ConstrClass } from '@dxtmisha/functional'
-
-import type { LabelAlternativeSlots, LabelExpose } from '../../types/labelTypes'
-import type { DescriptionExpose, DescriptionSlots } from '../../types/descriptionTypes'
-import type { CaptionSlots } from '../../types/captionTypes'
-
-import type { IconComponentInclude } from '../Icon'
-
-/**
- * Interface for describing which components need to be connected for work.
- *
- * Интерфейс для описания, какие компоненты надо подключить для работы.
- */
-export type BlockComponents = IconComponentInclude
-
-/**
- * Type describing available events.
- *
- * Тип, описывающий доступные события.
- */
-export type BlockEmits = {}
-
-/**
- * Type describing available properties.
- *
- * Тип, описывающий доступные свойства.
- */
-export interface BlockExpose extends LabelExpose, DescriptionExpose {
-}
-
-/**
- * Type describing available slots.
- *
- * Тип, описывающий доступные слоты.
- */
-export interface BlockSlots extends LabelAlternativeSlots, DescriptionSlots, CaptionSlots {
-  /** Slot for trailing content/ Слот для правого контента */
-  trailing?(props: any): any
-
-  /** Slot for headline/ Слот для заголовка */
-  headline?(props: any): any
-
-  /** Default slot/ Слот по умолчанию */
-  default?(props: any): any
-}
-
-/**
- * Type describing subclasses.
- *
- * Тип, описывающий подклассы.
- */
-export type BlockClasses = {
-  main: ConstrClass
-  // :classes [!] System label / Системная метка
-  headline: string
-  header: string
-  label: string
-  description: string
-  caption: string
-  icon: string
-  space: string
-  body: string
-  // :classes [!] System label / Системная метка
-}

package/src/constructors/Button/Button.ts

@@ -1,112 +0,0 @@
-import { computed, type Ref, type ToRefs } from 'vue'
-import { type ConstrClass, type ConstrEmit, DesignComp } from '@dxtmisha/functional'
-import { getClassTagAStatic } from '../../functions/getClassTagAStatic'
-
-import { LabelInclude } from '../../classes/LabelInclude'
-import { EnabledInclude } from '../../classes/EnabledInclude'
-
-import { IconTrailingInclude } from '../Icon'
-import { ProgressInclude } from '../Progress'
-import { RippleInclude } from '../Ripple'
-import { SkeletonInclude } from '../Skeleton'
-
-import { AriaStaticInclude } from '../../classes/AriaStaticInclude'
-import { EventClickInclude } from '../../classes/EventClickInclude'
-
-import type { AriaList } from '../../types/ariaTypes'
-import type { ButtonComponents, ButtonEmits, ButtonSlots } from './types'
-import type { ButtonPropsBasic } from './props'
-
-/**
- * Button
- */
-export class Button {
-  readonly label: LabelInclude
-  readonly enabled: EnabledInclude
-
-  readonly icon: IconTrailingInclude
-  readonly progress: ProgressInclude
-  readonly ripple: RippleInclude
-  readonly skeleton: SkeletonInclude
-
-  readonly event: EventClickInclude
-
-  /**
-   * 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: ButtonPropsBasic,
-    protected readonly refs: ToRefs<ButtonPropsBasic>,
-    protected readonly element: Ref<HTMLElement | undefined>,
-    protected readonly classDesign: string,
-    protected readonly className: string,
-    protected readonly components?: DesignComp<ButtonComponents, ButtonPropsBasic>,
-    protected readonly slots?: ButtonSlots,
-    protected readonly emits?: ConstrEmit<ButtonEmits>
-  ) {
-    const progress = new ProgressInclude(
-      props,
-      className,
-      components,
-      {
-        circular: true,
-        inverse: true
-      }
-    )
-
-    this.label = new LabelInclude(props, className, undefined, slots)
-    this.enabled = new EnabledInclude(props, progress)
-
-    this.icon = new IconTrailingInclude(props, className, components)
-    this.progress = progress
-    this.ripple = new RippleInclude(className, components, this.enabled)
-    this.skeleton = new SkeletonInclude(
-      props,
-      classDesign,
-      ['classBackground']
-    )
-
-    this.event = new EventClickInclude(
-      props,
-      this.enabled,
-      emits
-    )
-  }
-
-  /** values for the class/ значения для класса */
-  readonly classes = computed<ConstrClass>(() => ({
-    [`${this.className}--icon`]: this.icon.isIcon.value,
-    [getClassTagAStatic(this.classDesign)]: true,
-    ...this.skeleton.classes.value
-  }))
-
-  /**
-   * list of aria properties for the button component/
-   * список aria свойств для компонента Button
-   */
-  readonly aria = computed<AriaList>(() => {
-    const aria: AriaList = {
-      ...this.progress.aria.value,
-      ...AriaStaticInclude.label(this.props.ariaLabel)
-    }
-
-    if (this.props.tag !== 'button') {
-      return {
-        tabindex: '0',
-        ...aria,
-        ...AriaStaticInclude.role('button'),
-        ...this.enabled.aria.value
-      }
-    }
-
-    return aria
-  })
-}

package/src/constructors/Button/ButtonDesign.tsx

@@ -1,141 +0,0 @@
-import { h, type VNode } from 'vue'
-import {
-  type ConstrOptions,
-  type ConstrStyles,
-  DesignConstructorAbstract
-} from '@dxtmisha/functional'
-
-import { Button } from './Button'
-
-import {
-  type ButtonPropsBasic
-} from './props'
-import {
-  type ButtonClasses,
-  type ButtonComponents,
-  type ButtonEmits,
-  type ButtonExpose,
-  type ButtonSlots
-} from './types'
-
-/**
- * ButtonDesign
- */
-export class ButtonDesign<
-  COMP extends ButtonComponents,
-  EXPOSE extends ButtonExpose,
-  CLASSES extends ButtonClasses,
-  P extends ButtonPropsBasic
-> extends DesignConstructorAbstract<
-    HTMLDivElement,
-    COMP,
-    ButtonEmits,
-    EXPOSE,
-    ButtonSlots,
-    CLASSES,
-    P
-  > {
-  protected readonly item: Button
-
-  /**
-   * Constructor
-   * @param name class name/ название класса
-   * @param props properties/ свойства
-   * @param options list of additional parameters/ список дополнительных параметров
-   */
-  constructor(
-    name: string,
-    props: Readonly<P>,
-    options?: ConstrOptions<COMP, ButtonEmits, P>
-  ) {
-    super(
-      name,
-      props,
-      options
-    )
-
-    this.item = new Button(
-      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 {
-      ...this.item.event.expose,
-      ...this.item.label.expose
-    } as EXPOSE
-  }
-
-  /**
-   * Improvement of the obtained list of classes.
-   *
-   * Доработка полученного списка классов.
-   */
-  protected initClasses(): Partial<CLASSES> {
-    return {
-      main: this.item.classes.value,
-      ...{
-        // :classes [!] System label / Системная метка
-        label: this.getSubClass('label'),
-        icon: this.getSubClass('icon'),
-        trailing: this.getSubClass('trailing'),
-        loading: this.getSubClass('loading')
-        // :classes [!] System label / Системная метка
-      }
-    } as Partial<CLASSES>
-  }
-
-  /**
-   * Refinement of the received list of styles.
-   *
-   * Доработка полученного списка стилей.
-   */
-  protected initStyles(): ConstrStyles {
-    return {}
-  }
-
-  /**
-   * A method for rendering.
-   *
-   * Метод для рендеринга.
-   */
-  protected initRender(): VNode {
-    return h(
-      this.props.tag || 'button',
-      {
-        ...this.getAttrs(),
-        'ref': this.element,
-        'type': this.props.type,
-
-        'class': this.classes?.value.main,
-        'style': this.styles?.value,
-
-        'data-value': this.props.value,
-
-        'disabled': this.item.enabled.isDisabledOrUndefined.value,
-        'onClick': this.item.event.onClick,
-        ...this.item.aria.value
-      },
-      [
-        ...this.item.progress.render(),
-        ...this.item.label.render(),
-        ...this.item.icon.render(),
-        ...this.item.ripple.render()
-      ]
-    )
-  }
-}

package/src/constructors/Button/ButtonInclude.ts

@@ -1,83 +0,0 @@
-import { computed, type VNode } from 'vue'
-import { type ConstrBind, DesignComponents, getBind, getRef, type RefOrNormal, toBinds } from '@dxtmisha/functional'
-
-import type { ButtonComponentInclude, ButtonPropsInclude } from './basicTypes'
-import type { ButtonPropsBasic } from './props'
-
-/**
- * ButtonInclude class provides functionality for conditionally rendering button components
- * within other components. It manages the logic for determining when to display a button
- * and configures the appropriate properties.
- *
- * Класс ButtonInclude предоставляет функциональность для условного рендеринга компонентов
- * кнопки внутри других компонентов. Он управляет логикой определения необходимости
- * отображения кнопки и настраивает соответствующие свойства.
- *
- * @template Props - Properties interface extending ButtonPropsInclude
- */
-export class ButtonInclude<Props extends ButtonPropsInclude = ButtonPropsInclude> {
-  /**
-   * Constructor
-   * @param props input parameter/ входной параметр
-   * @param className class name/ название класса
-   * @param components object for working with components/ объект для работы с компонентами
-   * @param extra additional parameter/ дополнительный параметр
-   * @param index index identifier/ идентификатор индекса
-   */
-  constructor(
-    protected readonly props: Readonly<Props>,
-    protected readonly className: string,
-    protected readonly components?: DesignComponents<ButtonComponentInclude, Props>,
-    protected readonly extra?: RefOrNormal<ConstrBind<ButtonPropsBasic>>,
-    protected readonly index?: string
-  ) {
-  }
-
-  /**
-   * Computed bindings for the button/ Вычисляемые привязки для кнопки
-   */
-  readonly binds = computed(
-    () => toBinds(
-      this.props.buttonAttrs,
-      getBind(
-        getRef(this.props),
-        getRef(this.extra),
-        'label'
-      )
-    )
-  )
-
-  /**
-   * Renders the button component with provided properties and configuration.
-   * Returns an array of VNode elements representing the rendered button, or an empty
-   * array if the component cannot be rendered.
-   *
-   * Обрисовывает компонент кнопки с предоставленными свойствами и конфигурацией.
-   * Возвращает массив VNode элементов, представляющих отрисованную кнопку, или пустой
-   * массив, если компонент не может быть отрисованы.
-   *
-   * @param props additional properties/ дополнительные свойства
-   */
-  readonly render = (props?: RefOrNormal<ConstrBind<ButtonPropsBasic>>): VNode[] => {
-    if (
-      this.components
-      && (
-        ('label' in this.binds.value)
-        || ('icon' in this.binds.value)
-        || ('iconTrailing' in this.binds.value)
-      )
-    ) {
-      return this.components.render(
-        'button',
-        {
-          ...this.binds.value,
-          ...getRef(props)
-        },
-        undefined,
-        this.index ?? 'button'
-      )
-    }
-
-    return []
-  }
-}

package/src/constructors/Button/basicTypes.ts

@@ -1,12 +0,0 @@
-import type { ConstrBind } from '@dxtmisha/functional'
-import type { ButtonPropsBasic } from './props'
-
-export type ButtonComponentInclude = {
-  button?: object
-}
-
-export interface ButtonPropsInclude<
-  Button extends ButtonPropsBasic = ButtonPropsBasic
-> {
-  buttonAttrs?: ConstrBind<Button>
-}

package/src/constructors/Button/index.ts

@@ -1,6 +0,0 @@
-export * from './Button'
-export * from './ButtonDesign'
-export * from './ButtonInclude'
-export * from './props'
-export * from './types'
-export * from './basicTypes'