@dxtmisha/constructor 0.30.1 → 0.39.3

package/dist/constructors/Icon/IconDesign.d.ts

@@ -0,0 +1,58 @@
+import { VNode, ComputedRef } from 'vue';
+import { ConstrOptions, ConstrStyles, DesignConstructorAbstract } from '@dxtmisha/functional';
+import { Icon } from './Icon';
+import { IconPropsBasic } from './props';
+import { IconClasses, IconComponents, IconEmits, IconExpose, IconSlots } from './types';
+/**
+ * IconDesign
+ */
+export declare class IconDesign<COMP extends IconComponents, EXPOSE extends IconExpose, CLASSES extends IconClasses, P extends IconPropsBasic> extends DesignConstructorAbstract<HTMLDivElement, COMP, IconEmits, EXPOSE, IconSlots, CLASSES, P> {
+    protected readonly item: Icon;
+    /**
+     * Constructor
+     * @param name class name/ название класса
+     * @param props properties/ свойства
+     * @param options list of additional parameters/ список дополнительных параметров
+     * @param ItemConstructor icon item class/ класс элемента иконки
+     */
+    constructor(name: string, props: Readonly<P>, options?: ConstrOptions<COMP, IconEmits, P>, ItemConstructor?: typeof Icon);
+    /**
+     * Initialization of all the necessary properties for work<br>
+     * Инициализация всех необходимых свойств для работы.
+     */
+    protected initExpose(): EXPOSE;
+    /**
+     * Improvement of the obtained list of classes.<br>
+     * Доработка полученного списка классов.
+     */
+    protected initClasses(): Partial<CLASSES>;
+    /**
+     * Refinement of the received list of styles.<br>
+     * Доработка полученного списка стилей.
+     */
+    protected initStyles(): ConstrStyles;
+    /**
+     * A method for rendering.
+     *
+     * Метод для рендеринга.
+     */
+    protected initRender(): VNode;
+    /**
+     * Computed properties for the main element.
+     *
+     * Вычисляемые свойства для главного элемента.
+     */
+    readonly propsMain: ComputedRef<any>;
+    /**
+     * Render the main icon.
+     *
+     * Рендер основной иконки.
+     */
+    readonly renderIcon: () => VNode | undefined;
+    /**
+     * Render the secondary icon.
+     *
+     * Рендер вторичной иконки.
+     */
+    readonly renderIconActive: () => VNode | undefined;
+}

package/dist/constructors/Icon/IconInclude.d.ts

@@ -0,0 +1,37 @@
+import { ConstrBind, DesignComponents, RefOrNormal } from '@dxtmisha/functional';
+import { IconLiteInclude } from './IconLiteInclude';
+import { IconComponentInclude, IconPropsInclude } from './basicTypes';
+import { IconPropsBasic } from './props';
+import { ComputedRef } from 'vue';
+import { ItemList } from '@dxtmisha/functional-basic';
+/**
+ * Class for simplified integration of the icon-handling component
+ *
+ * Класс для упрощённого внедрения компонента для работы с иконками
+ */
+export declare class IconInclude<Props extends IconPropsInclude = IconPropsInclude> extends IconLiteInclude<Props> {
+    protected readonly props: Readonly<Props>;
+    protected readonly className: string;
+    protected readonly components?: DesignComponents<IconComponentInclude, Props> | undefined;
+    protected readonly extra?: RefOrNormal<ConstrBind<IconPropsBasic>> | undefined;
+    protected readonly turn?: RefOrNormal<boolean> | undefined;
+    protected readonly dir?: RefOrNormal<boolean> | undefined;
+    protected readonly start: RefOrNormal<boolean | undefined>;
+    protected readonly end: RefOrNormal<boolean | undefined>;
+    /**
+     * Constructor
+     * @param props input parameter/ входной параметр
+     * @param className class name/ название класса
+     * @param components object for working with components/ объект для работы с компонентами
+     * @param extra additional parameter/ дополнительный параметр
+     * @param turn should the icon be flipped/ надо ли перевернуть иконку
+     * @param dir should the icon be mirrored/ надо ли зеркально отображать иконка
+     * @param start add sorting at the beginning/ добавить сортировку в начале
+     * @param end add sorting at the end/ добавить сортировку в конце
+     */
+    constructor(props: Readonly<Props>, className: string, components?: DesignComponents<IconComponentInclude, Props> | undefined, extra?: RefOrNormal<ConstrBind<IconPropsBasic>> | undefined, turn?: RefOrNormal<boolean> | undefined, dir?: RefOrNormal<boolean> | undefined, start?: RefOrNormal<boolean | undefined>, end?: RefOrNormal<boolean | undefined>);
+    /**
+     * List of properties for the icon component/ Список свойств для компонента иконки
+     */
+    readonly iconBind: ComputedRef<ConstrBind< ItemList>>;
+}

package/dist/constructors/Icon/IconLiteInclude.d.ts

@@ -0,0 +1,63 @@
+import { VNode, ComputedRef } from 'vue';
+import { ConstrBind, ConstrClass, DesignComponents, RefOrNormal } from '@dxtmisha/functional';
+import { IconComponentInclude, IconLitePropsInclude } from './basicTypes';
+import { IconPropsBasic } from './props';
+import { ItemList } from '@dxtmisha/functional-basic';
+import { ImagePropsBasic } from '../Image';
+/**
+ * Class for simplified integration of the icon-handling component
+ *
+ * Класс для упрощённого внедрения компонента для работы с иконками
+ */
+export declare class IconLiteInclude<Props extends IconLitePropsInclude = IconLitePropsInclude> {
+    protected readonly props: Readonly<Props>;
+    protected readonly className: string;
+    protected readonly components?: DesignComponents<IconComponentInclude, Props> | undefined;
+    protected readonly extra?: RefOrNormal<ConstrBind<IconPropsBasic>> | undefined;
+    /**
+     * Constructor
+     * @param props input parameter/ входной параметр
+     * @param className class name/ название класса
+     * @param components object for working with components/ объект для работы с компонентами
+     * @param extra additional parameter/ дополнительный параметр
+     */
+    constructor(props: Readonly<Props>, className: string, components?: DesignComponents<IconComponentInclude, Props> | undefined, extra?: RefOrNormal<ConstrBind<IconPropsBasic>> | undefined);
+    /**
+     * Checks whether an icon is specified for rendering the component/
+     * Проверяет, указана ли иконка для отображения компонента
+     */
+    readonly isIcon: ComputedRef<boolean>;
+    /**
+     * List of properties for the icon component/ Список свойств для компонента иконки
+     */
+    readonly iconBind: ComputedRef<ConstrBind< ItemList>>;
+    /**
+     * Render of the Icon component
+     *
+     * Рендер компонента иконка
+     */
+    readonly renderIcon: () => VNode[];
+    /**
+     * Returns an additional property
+     *
+     * Возвращает дополнительное свойство
+     */
+    protected getExtra(): ConstrBind<IconPropsBasic< ImagePropsBasic>> | undefined;
+    /**
+     * Returns a list of classes
+     *
+     * Возвращает список классов
+     * @param classesUser list of additional classes/ список дополнительных классов
+     * @param name class name/ название класса
+     */
+    protected getClasses(classesUser?: ConstrClass, name?: string): {
+        class: ConstrClass;
+    };
+    /**
+     * Returns the type used to determine when an event is triggered
+     *
+     * Возвращает тип для определения при срабатывании события
+     * @param type event type/ тип события
+     */
+    protected getEventType(type?: string): Record<string, string>;
+}

package/dist/constructors/Icon/IconTrailingInclude.d.ts

@@ -0,0 +1,51 @@
+import { VNode, ComputedRef } from 'vue';
+import { ConstrBind, DesignComponents, RefOrNormal } from '@dxtmisha/functional';
+import { IconInclude } from './IconInclude';
+import { IconComponentInclude, IconTrailingPropsInclude } from './basicTypes';
+import { IconPropsBasic } from './props';
+import { ItemList } from '@dxtmisha/functional-basic';
+/**
+ * Class for simplified integration of the icon-handling component
+ *
+ * Класс для упрощённого внедрения компонента для работы с иконками
+ */
+export declare class IconTrailingInclude<Props extends IconTrailingPropsInclude = IconTrailingPropsInclude> extends IconInclude<Props> {
+    protected readonly props: Readonly<Props>;
+    protected readonly className: string;
+    protected readonly components?: DesignComponents<IconComponentInclude, Props> | undefined;
+    protected readonly extra?: RefOrNormal<ConstrBind<IconPropsBasic>> | undefined;
+    /**
+     * Constructor
+     * @param props input parameter/ входной параметр
+     * @param className class name/ название класса
+     * @param components object for working with components/ объект для работы с компонентами
+     * @param extra additional parameter/ дополнительный параметр
+     */
+    constructor(props: Readonly<Props>, className: string, components?: DesignComponents<IconComponentInclude, Props> | undefined, extra?: RefOrNormal<ConstrBind<IconPropsBasic>> | undefined);
+    /**
+     * Checks whether an icon is specified for rendering the component/
+     * Проверяет, указана ли иконка для отображения компонента
+     */
+    readonly isIconTrailing: ComputedRef<boolean>;
+    /**
+     * Checks if there is at least one icon/
+     * Проверяет, есть ли хотя бы одна иконка
+     */
+    readonly hasAtLeastOneIcon: ComputedRef<boolean>;
+    /**
+     * list of properties for the secondary icon component/ список свойств для вторичного компонента иконки
+     */
+    readonly trailingBind: ComputedRef<ConstrBind< ItemList>>;
+    /**
+     * Render of the secondary icon component
+     *
+     * Рендер вторичного компонента иконки
+     */
+    readonly renderIconTrailing: () => VNode[];
+    /**
+     * Method for rendering all icons — first the main ones, then the additional icons
+     *
+     * Метод для рендеринга всех иконок — сначала основных, затем дополнительных
+     */
+    readonly render: () => VNode[];
+}

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

@@ -0,0 +1,28 @@
+import { ConstrBind, ConstrItem } from '@dxtmisha/functional';
+import { IconPropsBasic } from './props';
+export type IconEventLoad = {
+    isActive: boolean;
+    iconBind: ConstrItem | undefined;
+    iconActiveBind: ConstrItem | undefined;
+};
+export type IconValue<Icon extends IconPropsBasic = IconPropsBasic> = string | ConstrBind<Icon> | null;
+export type IconComponentInclude = {
+    icon?: object;
+};
+export interface IconLitePropsInclude<Icon extends IconPropsBasic = IconPropsBasic> {
+    icon?: IconValue<Icon>;
+}
+export interface IconPropsInclude<Icon extends IconPropsBasic = IconPropsBasic> extends IconLitePropsInclude<Icon> {
+    selected?: boolean;
+    iconTurn?: boolean;
+    iconHide?: boolean;
+    iconDir?: boolean;
+    iconPalette?: boolean;
+    iconAttrs?: ConstrBind<Icon>;
+}
+export interface IconTrailingPropsInclude<Icon extends IconPropsBasic = IconPropsBasic> extends IconPropsInclude<Icon> {
+    iconTrailing?: IconValue<Icon>;
+    iconTrailingTurnOnly?: boolean;
+    iconTrailingDirOnly?: boolean;
+    iconTrailingPalette?: boolean;
+}

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

@@ -0,0 +1,8 @@
+export * from './Icon';
+export * from './IconDesign';
+export * from './IconInclude';
+export * from './IconLiteInclude';
+export * from './IconTrailingInclude';
+export * from './basicTypes';
+export * from './props';
+export * from './types';

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

@@ -0,0 +1,43 @@
+import { RoleType } from '../../types/roleTypes';
+import { ImagePropsBasic, ImageValue } from '../Image';
+import { SkeletonPropsInclude } from '../Skeleton';
+import { AriaLabelPropsInclude } from '../../types/ariaTypes.ts';
+interface IconPropsToken {
+    turn?: boolean;
+    disabled?: boolean;
+    hide?: boolean;
+    asPalette?: boolean;
+    dir?: boolean;
+    overlay?: boolean;
+    dynamic?: boolean;
+    start?: boolean;
+    end?: boolean;
+    high?: boolean;
+    animationType?: 'type1' | 'type2';
+    animationShow?: boolean;
+}
+export interface IconPropsBasic<Image extends ImagePropsBasic = ImagePropsBasic> extends SkeletonPropsInclude, AriaLabelPropsInclude {
+    /** Активное состояние иконки/ Active state of the icon */
+    active?: boolean;
+    /** Value of the main icon/ Значение основной иконки */
+    icon?: ImageValue<Image>;
+    /** Value of the active icon/ Значение активной иконки */
+    iconActive?: ImageValue<Image>;
+    role?: RoleType;
+}
+/**
+ * Type describing incoming properties.
+ *
+ * Тип, описывающий входящие свойства.
+ */
+export interface IconProps extends IconPropsBasic, IconPropsToken {
+}
+/**
+ * Default value for property.
+ *
+ * Значение по умолчанию для свойства.
+ */
+export declare const defaultsIcon: {
+    animationType: string;
+};
+export {};

package/dist/constructors/Icon/types.d.ts

@@ -0,0 +1,39 @@
+import { ComputedRef } from 'vue';
+import { ConstrClass } from '@dxtmisha/functional';
+import { ImageComponentsInclude, ImageEmitsInclude } from '../Image';
+/**
+ * Interface for describing which components need to be connected for work.
+ *
+ * Интерфейс для описания, какие компоненты надо подключить для работы.
+ */
+export type IconComponents = ImageComponentsInclude;
+/**
+ * Type describing available events.
+ *
+ * Тип, описывающий доступные события.
+ */
+export type IconEmits = ImageEmitsInclude;
+/**
+ * Type describing available properties.
+ *
+ * Тип, описывающий доступные свойства.
+ */
+export interface IconExpose {
+    isActive: ComputedRef<boolean>;
+}
+/**
+ * Type describing available slots.
+ *
+ * Тип, описывающий доступные слоты.
+ */
+export interface IconSlots {
+    default?(props: any): any;
+}
+/**
+ * Type describing subclasses.
+ *
+ * Тип, описывающий подклассы.
+ */
+export type IconClasses = {
+    main: ConstrClass;
+};

package/dist/constructors/Image/Image.d.ts

@@ -0,0 +1,138 @@
+import { Ref, ComputedRef } from 'vue';
+import { ConstrClassObject, ConstrEmit, ConstrStyles } from '@dxtmisha/functional';
+import { ImageType } from './ImageType';
+import { ImageData } from './ImageData';
+import { ImageCoordinator } from './ImageCoordinator';
+import { ImagePosition } from './ImagePosition';
+import { ImageAdaptiveItem } from './ImageAdaptiveItem';
+import { ImageBackground } from './ImageBackground';
+import { ImageImg } from './ImageImg';
+import { ImageEmits } from './types';
+import { ImageProps } from './props';
+import { RoleType, AriaTrueOrFalse } from '../../library';
+import { NumberOrString } from '@dxtmisha/functional-basic';
+/**
+ * Base class for working with images and icons.
+ *
+ * Базовый класс для работы с изображениями и иконками.
+ */
+export declare class Image {
+    protected readonly props: ImageProps;
+    protected readonly element: Ref<HTMLElement | undefined>;
+    protected readonly className: string;
+    protected readonly emits?: ConstrEmit<ImageEmits> | undefined;
+    protected readonly ImageTypeConstructor: typeof ImageType;
+    protected readonly ImageDataConstructor: typeof ImageData;
+    protected readonly ImageCoordinatorConstructor: typeof ImageCoordinator;
+    protected readonly ImagePositionConstructor: typeof ImagePosition;
+    protected readonly ImageAdaptiveItemConstructor: typeof ImageAdaptiveItem;
+    protected readonly ImageBackgroundConstructor: typeof ImageBackground;
+    protected readonly ImageImgConstructor: typeof ImageImg;
+    readonly type: ImageType;
+    readonly data: ImageData;
+    readonly coordinator: ImageCoordinator;
+    readonly position: ImagePosition;
+    readonly adaptiveItem: ImageAdaptiveItem;
+    readonly background: ImageBackground;
+    readonly img: ImageImg;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param element input element/ элемент ввода
+     * @param className class name/ название класса
+     * @param emits the function is called when an event is triggered/ функция вызывается, когда срабатывает событие
+     * @param ImageTypeConstructor class for working with image type/ класс для работы с типом изображения
+     * @param ImageDataConstructor class for working with image data/ класс для работы с данными изображения
+     * @param ImageCoordinatorConstructor class for working with image coordinates/ класс для работы с координатами изображения
+     * @param ImagePositionConstructor class for working with image position/ класс для работы с позицией изображения
+     * @param ImageAdaptiveItemConstructor class for working with adaptive image item/ класс для работы с адаптивным элементом изображения
+     * @param ImageBackgroundConstructor class for working with image background/ класс для работы с фоном изображения
+     * @param ImageImgConstructor class for working with image tag/ класс для работы с тегом изображения
+     */
+    constructor(props: ImageProps, element: Ref<HTMLElement | undefined>, className: string, emits?: ConstrEmit<ImageEmits> | undefined, ImageTypeConstructor?: typeof ImageType, ImageDataConstructor?: typeof ImageData, ImageCoordinatorConstructor?: typeof ImageCoordinator, ImagePositionConstructor?: typeof ImagePosition, ImageAdaptiveItemConstructor?: typeof ImageAdaptiveItem, ImageBackgroundConstructor?: typeof ImageBackground, ImageImgConstructor?: typeof ImageImg);
+    /**
+     * Determines the tag to use/ Определяет используемый тег
+     */
+    readonly tag: ComputedRef<string>;
+    /**
+     * Values for the text. Text is used for the type of icon that works as a background.
+     *
+     * Значения для текста. Текст используется для типа иконки, который работает как фон.
+     */
+    readonly text: ComputedRef<string | undefined>;
+    /**
+     * Values for the class.
+     *
+     * Значения для класса.
+     */
+    readonly classes: ComputedRef<ConstrClassObject>;
+    /**
+     * Calculates all properties for the style of the element/
+     * Вычисляет все свойства для стиля элемента
+     */
+    readonly styles: ComputedRef<ConstrStyles>;
+    /**
+     * Computed bindings for the image element.
+     *
+     * Вычисляемые привязки для элемента изображения.
+     */
+    readonly binds: 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;
+        translate: string;
+    }>;
+    /**
+     * Bindings for the image value.
+     *
+     * Привязки для значения изображения.
+     */
+    readonly valueBinds: ComputedRef<any>;
+}

package/dist/constructors/Image/ImageAdaptiveGroup.d.ts

@@ -0,0 +1,104 @@
+import { EventItem } from '@dxtmisha/functional';
+import { ImageAdaptiveItem } from './ImageAdaptiveItem';
+/**
+ * Class for working with image scaling according to the physical size of the object in the image.
+ *
+ * Класс для работы с масштабированием изображения по физическому размеру объекта на изображении.
+ */
+export declare class ImageAdaptiveGroup {
+    protected static objects: ImageAdaptiveItem[];
+    protected static objectsAdaptive: ImageAdaptiveItem[];
+    private static cache;
+    protected static event?: EventItem<Window, Event, any>;
+    protected static time?: boolean;
+    /**
+     * Checks if an element is present in the list.
+     *
+     * Проверяет, присутствует ли элемент в списке.
+     * @param item object for working with images/ объект для работы с изображениями
+     */
+    static is(item: ImageAdaptiveItem): boolean;
+    /**
+     * Adding a new element for tracking.
+     *
+     * Добавление нового элемента для отслеживания.
+     * @param item object for working with images/ объект для работы с изображениями
+     */
+    static add(item: ImageAdaptiveItem): void;
+    /**
+     * Removal of the element.
+     *
+     * Удаления элемента.
+     * @param item object for working with images/ объект для работы с изображениями
+     */
+    static remove(item: ImageAdaptiveItem): void;
+    /**
+     * Resets all cached data and rereads scaling for all elements.
+     *
+     * Обнуляет все кэшированные данные и перечитывает масштабирование для всех элементов.
+     */
+    static reset(): void;
+    /**
+     * Starts the calculation process or turns it off if there are no active elements in the list.
+     *
+     * Запускает процесс вычисления или отключает его, если в списке нет активных элементов.
+     */
+    static make(): void;
+    /**
+     * Returns a list of elements that are visible or constantly being calculated.
+     *
+     * Возвращает список элементов, которые видны или постоянно вычисляются.
+     */
+    protected static getItemIdByVisible(): string[];
+    /**
+     * Method for starting the calculation of scaling elements in the list.
+     *
+     * Метод для запуска вычисления масштабирования элементов в списке.
+     */
+    protected static start(): void;
+    /**
+     * Updates the list of elements available for calculation. These are the
+     * elements that are close to the border of the visible area.
+     *
+     * Обновляет список доступных для вычисления элементов. Это те элементы,
+     * которые близки к границе видимой области.
+     */
+    protected static makeAdaptive(): void;
+    /**
+     * Calculates the dimensions of an element relative to the image size,
+     * the size of the element, and its physical location on the image.
+     *
+     * Вычисляет размеры элемента относительно размера изображения,
+     * размера элемента и его физического расположения на изображении.
+     */
+    protected static makeSize(): void;
+    /**
+     * Calculation of the basic scaling of an element without taking into account other elements.
+     *
+     * Вычисление базового масштабирования элемента без учета других элементов.
+     */
+    protected static makePercent(): void;
+    /**
+     * Calculation of the largest element to determine the base size.
+     * This parameter is used for scaling other elements,
+     * reducing them to the necessary proportion.
+     *
+     * Вычисление самого большого элемента для определения базового размера.
+     * Этот параметр используется для масштабирования других элементов,
+     * уменьшая их до нужной пропорции.
+     */
+    protected static makeFactorMax(): void;
+    /**
+     * Checks if there is an active element at the moment.
+     *
+     * Проверяет, есть ли в текущий момент активный элемент.
+     */
+    private static isAdaptive;
+    /**
+     * Checks whether the composition of visible elements has changed.
+     *
+     * Проверяет, изменился ли состав видимых элементов.
+     * @param visible list of indices of visible elements/ список индексов видимых элементов
+     */
+    private static isCache;
+}