@dxtmisha/constructor 0.23.0 → 0.39.3

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;
+}

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

@@ -0,0 +1,142 @@
+import { Ref, ComputedRef } from 'vue';
+import { ImageData } from './ImageData';
+import { ImageElement, ImageSize } from './basicTypes';
+import { ImageProps } from './props';
+declare enum ImageAdaptiveItemType {
+    x = "x",
+    y = "y"
+}
+/**
+ * The value in pixels indicating when an element is still considered active,
+ * even if it has gone off the screen.
+ *
+ * Значение в пикселях, указывающее, когда элемент считается еще активным,
+ * даже если он ушел за экран.
+ */
+export declare const MAX_BEYOND = 512;
+/**
+ * A class for managing the adapted scaling of a specific element.
+ *
+ * Класс для управления адаптированным масштабированием конкретного элемента.
+ */
+export declare class ImageAdaptiveItem {
+    protected readonly props: ImageProps;
+    protected readonly data: ImageData;
+    readonly element: Ref<ImageElement>;
+    readonly percent: Ref<{
+        width: number;
+        height: number;
+    }, ImageSize | {
+        width: number;
+        height: number;
+    }>;
+    protected beyond: boolean;
+    protected visible: boolean;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param element image element for scaling/ элемент изображения для масштабирования
+     * @param data image data/ данные изображения
+     */
+    constructor(props: ImageProps, data: ImageData, element: Ref<ImageElement>);
+    /**
+     * Is the element active for size alignment.
+     *
+     * Активен ли элемент для выравнивания размера.
+     */
+    readonly active: ComputedRef<boolean>;
+    /**
+     * Returns the name of the group.
+     *
+     * Возвращает название группы.
+     */
+    readonly group: ComputedRef<string>;
+    /**
+     * Returns the physical width of the object.
+     *
+     * Возвращает физическую ширину объекта.
+     */
+    readonly width: ComputedRef<number>;
+    /**
+     * Returns the physical height of the object.
+     *
+     * Возвращает физическую высоту объекта.
+     */
+    readonly height: ComputedRef<number>;
+    /**
+     * Returns the axis for scaling.
+     *
+     * Возвращает ось для масштабирования.
+     */
+    readonly type: ComputedRef<ImageAdaptiveItemType | undefined>;
+    /**
+     * Calculation of the base size of the image to determine how to scale the image.
+     *
+     * Вычисление базового размера изображения, чтобы определить, как надо масштабировать изображение.
+     */
+    readonly size: ComputedRef<number>;
+    /**
+     * Multiplier for determining the level of image scaling relative to other elements.
+     *
+     * Множитель для определения уровня масштабирования изображения относительно других элементов.
+     */
+    readonly factor: ComputedRef<number>;
+    /**
+     * Checks if the element’s conditions are suitable for scaling.
+     *
+     * Проверяет, подходить ли у элемента условия для масштабирования.
+     */
+    is(): boolean;
+    /**
+     * Checks for compliance with the group.
+     *
+     * Проверяет на соответствие группе.
+     * @param name name of the checked group/ название проверяемой группы
+     */
+    isGroup(name: string): boolean;
+    /**
+     * Is it available for calculation.
+     *
+     * Доступен ли для вычисления.
+     */
+    isBeyond(): boolean;
+    /**
+     * Is the element visible.
+     *
+     * Виден ли элемент.
+     */
+    isVisible(): boolean;
+    /**
+     * Returns the identifier of the element.
+     *
+     * Возвращает идентификатор элемента.
+     */
+    getId(): string;
+    /**
+     * Returns values for the background-size property.
+     *
+     * Возвращает значения для свойства background-size.
+     */
+    getBackgroundSize(): string | null;
+    /**
+     * Size change for calculation.
+     *
+     * Изменение размера для вычисления.
+     * @param width width value/ значение ширины
+     * @param height height value/ значение высоты
+     */
+    setPercent(width: number, height: number): this;
+    /**
+     * Removal of an element from the scaling list.
+     *
+     * Удаление элемента из списка для масштабирования.
+     */
+    remove(): void;
+    /**
+     * Updating the visibility and activity status of the element.
+     *
+     * Обновление статуса видимости и активности элемента.
+     */
+    make(): this;
+}
+export {};

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

@@ -0,0 +1,67 @@
+import { NumberOrString } from '@dxtmisha/functional';
+import { ImageData } from './ImageData';
+import { ImageCoordinator } from './ImageCoordinator';
+import { ImageAdaptiveItem } from './ImageAdaptiveItem';
+import { ImageProps } from './props';
+import { ComputedRef } from 'vue';
+/**
+ * A class for getting the value of background.
+ *
+ * Класс для получения значения background.
+ */
+export declare class ImageBackground {
+    protected readonly props: ImageProps;
+    protected readonly data: ImageData;
+    protected readonly coordinator: ImageCoordinator;
+    protected readonly adaptive: ImageAdaptiveItem;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param data image data/ данные изображения
+     * @param coordinator object for working with coordinates/ объект для работы с координатами
+     * @param adaptive an object for working with adapted scaling/ объект для работы с адаптированным масштабированием
+     */
+    constructor(props: ImageProps, data: ImageData, coordinator: ImageCoordinator, adaptive: ImageAdaptiveItem);
+    /**
+     * Returns values for the background-image property.
+     *
+     * Возвращает значения для свойства background-image.
+     */
+    readonly image: ComputedRef<string | null>;
+    /**
+     * Returns the image source/ Возвращает источник изображения
+     */
+    readonly imageSrc: ComputedRef<string | null>;
+    /**
+     * Returns values for the background property.
+     *
+     * Возвращает значения для свойства background.
+     */
+    readonly size: ComputedRef<string | null>;
+    /**
+     * Checks if the object is an image.
+     *
+     * Проверяет, является ли объект изображением.
+     */
+    isImage(): boolean;
+    /**
+     * Returns the value for the background-size property.
+     *
+     * Возвращает значение для свойства background-size.
+     * @param width width value/ значение ширины
+     * @param height height value/ значение высоты
+     */
+    protected getSize(width: NumberOrString, height: NumberOrString): string | null;
+    /**
+     * Returns sizes according to the coordinator property.
+     *
+     * Возвращает размеры по свойству координатора.
+     */
+    protected getSizeByCoordinator(): string | null;
+    /**
+     * Returns the scaling sizes.
+     *
+     * Возвращает размеры масштабирования.
+     */
+    protected getSizeForItem(): string | null;
+}

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

@@ -0,0 +1,101 @@
+import { ImageSize } from './basicTypes';
+/**
+ * A class for storing data for adaptive computation of image scaling for a specific group.
+ *
+ * Класс для хранения данных для адаптивного вычисления масштабирования изображения для конкретной группы.
+ */
+export declare class ImageCalculation {
+    protected readonly name: string;
+    protected factorMax: number;
+    protected size: ImageSize;
+    protected offset: ImageSize;
+    /**
+     * Constructor
+     * @param name group name/ название группы
+     */
+    constructor(name: string);
+    /**
+     * Checks whether the element belongs to the current group.
+     *
+     * Проверяет, принадлежит ли элемент к текущей группе.
+     * @param name name of the checked group/ название проверяемой группы
+     */
+    is(name: string): boolean;
+    /**
+     * Checks if the group has elements with sizes. It is used to check if there is data for work.
+     *
+     * Проверяет, есть ли у группы элементы с размерами. Используется для проверки, есть ли данные для работы.
+     */
+    isSize(): boolean;
+    /**
+     * Returns the maximum physical width.
+     *
+     * Возвращает максимальную физическую ширину.
+     */
+    getWidth(): number;
+    /**
+     * Returns the maximum physical height.
+     *
+     * Возвращает максимальную физическую высоту.
+     */
+    getHeight(): number;
+    /**
+     * Returns the actual width.
+     *
+     * Возвращает фактическую ширину.
+     */
+    getOffsetWidth(): number;
+    /**
+     * Returns the actual height.
+     *
+     * Возвращает фактическую высоту.
+     */
+    getOffsetHeight(): number;
+    /**
+     * Returns the maximum multiplier for scaling.
+     *
+     * Возвращает максимальный множитель для масштабирования.
+     */
+    getFactorMax(): number;
+    /**
+     * Updating size.width, if it is less than the selected value.
+     *
+     * Обновление size.width, если она меньше выбранного значения.
+     * @param width value of the selected width/ значение выбранной ширины
+     */
+    makeWidth(width: number): this;
+    /**
+     * Updating size.height, if it is less than the selected value.
+     *
+     * Обновление size.height, если она меньше выбранного значения.
+     * @param height value of the selected height/ значение выбранной высоты
+     */
+    makeHeight(height: number): this;
+    /**
+     * Updating offset.width, if it is larger than the selected value.
+     *
+     * Обновление offset.width, если она больше выбранного значения.
+     * @param width value of the selected width/ значение выбранной ширины
+     */
+    makeOffsetWidth(width: number): this;
+    /**
+     * Updating offset.height, if it is larger than the selected value.
+     *
+     * Обновление offset.height, если она больше выбранного значения.
+     * @param height value of the selected height/ значение выбранной высоты
+     */
+    makeOffsetHeight(height: number): this;
+    /**
+     * Changes the multiplier value if it is greater than the checked value.
+     *
+     * Изменяет значение множителя, если оно больше проверяемого значения.
+     * @param value values for verification/ значения для проверки
+     */
+    makeFactorMax(value: number): this;
+    /**
+     * Restoring the value to its original state.
+     *
+     * Восстановление значения в изначальное состояние.
+     */
+    reset(): this;
+}

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

@@ -0,0 +1,42 @@
+import { ImageCalculation } from './ImageCalculation';
+/**
+ * Class for managing all ImageCalculation objects.
+ *
+ * Класс для управления всеми объектами ImageCalculation.
+ */
+export declare class ImageCalculationList {
+    protected static items: ImageCalculation[];
+    /**
+     * Checks if the group has elements with sizes. It is used to check if there is data for work.
+     *
+     * Проверяет, есть ли у группы элементы с размерами. Используется для проверки, есть ли данные для работы.
+     */
+    static isSize(): boolean;
+    /**
+     * Returns an object with data for calculation by the name of its group.
+     *
+     * Возвращает объект с данными для вычисления по названию его группы.
+     * @param name group name/ название группы
+     */
+    static get(name: string): ImageCalculation;
+    /**
+     * Resets all parameters for all groups.
+     *
+     * Сбрасывает все параметры для всех групп.
+     */
+    static reset(): void;
+    /**
+     * Search for the ImageCalculation object by the name of the group.
+     *
+     * Поиск объекта ImageCalculation по названию группы.
+     * @param name group name/ название группы
+     */
+    protected static find(name: string): ImageCalculation | undefined;
+    /**
+     * Creating a new ImageCalculation object by the name of the group.
+     *
+     * Создание нового объекта ImageCalculation по названию группы.
+     * @param name group name/ название группы
+     */
+    protected static init(name: string): ImageCalculation;
+}

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

@@ -0,0 +1,45 @@
+import { Undefined } from '@dxtmisha/functional';
+import { ImageCoordinatorItem, ImageSize } from './basicTypes';
+import { ImageProps } from './props';
+import { ComputedRef } from 'vue';
+type ImageCoordinatorItemFull = [number, number, number, number];
+/**
+ * A class for calculating the central part of the image by its coordinates.
+ *
+ * Класс для вычисления центральной части изображения по его координатам.
+ */
+export declare class ImageCoordinator {
+    protected readonly props: ImageProps;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     */
+    constructor(props: ImageProps);
+    /**
+     * Returns coordinates.
+     *
+     * Возвращает координаты.
+     */
+    readonly coordinator: ComputedRef<ImageCoordinatorItemFull>;
+    /**
+     * Returns the sizes for the background-position property by coordinates.
+     *
+     * Возвращает размеры для свойства background-position по координатам.
+     */
+    readonly size: ComputedRef<ImageSize>;
+    /**
+     * Checks if there are coordinates for calculation.
+     *
+     * Проверяет, есть ли координаты для вычисления.
+     */
+    is(): this is {
+        coordinator: Exclude<ImageCoordinatorItem, Undefined>;
+    };
+    /**
+     * Returns the values for the background property.
+     *
+     * Возвращает значения для свойства background.
+     */
+    getSize(): ImageSize<string>;
+}
+export {};

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

@@ -0,0 +1,56 @@
+import { Ref } from 'vue';
+import { Undefined } from '@dxtmisha/functional';
+import { ImageType } from './ImageType';
+import { ImageEventItem, ImageItem } from './basicTypes';
+import { ImageProps } from './props';
+/**
+ * A class for obtaining image or icon data.
+ *
+ * Класс для получения данных изображения или иконки.
+ */
+export declare class ImageData {
+    protected readonly props: ImageProps;
+    protected readonly type: ImageType;
+    /**
+     * Returns images.
+     *
+     * Возвращает изображения.
+     */
+    readonly image: Ref<ImageEventItem, ImageEventItem>;
+    /**
+     * Constructor
+     * @param props input data/ входные данные
+     * @param type image type/ тип изображения
+     */
+    constructor(props: ImageProps, type: ImageType);
+    /**
+     * Checks if there are values.
+     *
+     * Проверяет, есть ли значения.
+     */
+    is(): this is {
+        image: Exclude<ImageEventItem, Undefined>;
+    };
+    /**
+     * Checks if the value is a link, that is, a type of string.
+     *
+     * Проверяет, является ли значение ссылкой, то есть видом строки.
+     */
+    isLink(): this is {
+        image: Ref<string>;
+    };
+    /**
+     * Checks if the value is an image object.
+     *
+     * Проверяет, является ли значение объектом изображения.
+     */
+    isImage(): this is {
+        image: Ref<ImageItem>;
+    };
+    /**
+     * Calculates the image value and returns it.
+     *
+     * Вычисляет значение изображения и возвращает его.
+     */
+    protected init(): Promise<ImageEventItem>;
+}

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

@@ -0,0 +1,79 @@
+import { VNode, ComputedRef } from 'vue';
+import { ConstrOptions, ConstrStyles, DesignConstructorAbstract } from '@dxtmisha/functional';
+import { Image } from './Image';
+import { ImagePropsBasic } from './props';
+import { ImageClasses, ImageComponents, ImageEmits, ImageExpose, ImageSlots } from './types';
+/**
+ * ImageDesign
+ */
+export declare class ImageDesign<COMP extends ImageComponents, EXPOSE extends ImageExpose, CLASSES extends ImageClasses, P extends ImagePropsBasic> extends DesignConstructorAbstract<HTMLDivElement, COMP, ImageEmits, EXPOSE, ImageSlots, CLASSES, P> {
+    protected readonly item: Image;
+    /**
+     * Constructor
+     * @param name class name/ название класса
+     * @param props properties/ свойства
+     * @param options list of additional parameters/ список дополнительных параметров
+     * @param ItemConstructor image item class/ класс элемента изображения
+     */
+    constructor(name: string, props: Readonly<P>, options?: ConstrOptions<COMP, ImageEmits, P>, ItemConstructor?: typeof Image);
+    /**
+     * Initialization of all the necessary properties for work
+     *
+     * Инициализация всех необходимых свойств для работы.
+     */
+    protected initExpose(): EXPOSE;
+    /**
+     * Improvement of the obtained list of classes.
+     *
+     * Доработка полученного списка классов.
+     */
+    protected initClasses(): Partial<CLASSES>;
+    /**
+     * Refinement of the received list of styles.
+     *
+     * Доработка полученного списка стилей.
+     */
+    protected initStyles(): ConstrStyles;
+    /**
+     * A method for rendering.
+     *
+     * Метод для рендеринга.
+     */
+    protected initRender(): VNode;
+    /**
+     * Properties for the image tag.
+     *
+     * Свойства для тега image.
+     */
+    readonly propsImage: ComputedRef<any>;
+    /**
+     * Main properties.
+     *
+     * Основные свойства.
+     */
+    readonly propsMain: ComputedRef<any>;
+    /**
+     * Rendering the picture tag.
+     *
+     * Рендеринг тега picture.
+     */
+    readonly renderPicture: () => VNode;
+    /**
+     * Rendering the img tag.
+     *
+     * Рендеринг тега img.
+     */
+    readonly renderImg: () => VNode;
+    /**
+     * Rendering the img item.
+     *
+     * Рендеринг элемента img.
+     */
+    readonly renderImgItem: () => VNode;
+    /**
+     * Rendering the value for the component.
+     *
+     * Рендеринг значения для компонента.
+     */
+    readonly renderValue: () => string | VNode | undefined;
+}