@3dsource/utils 1.0.19 → 1.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3dsource/utils",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "A set of utils for using in 3dsource projects",
   "keywords": [
     "3dsource",
@@ -8,7 +8,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "private"
+    "url": "git@bitbucket.org:dreamsoft/front-libraries.git"
   },
   "license": "UNLICENSED",
   "author": "3dsource",

package/lib/color/CMYKtoRGB.d.ts

@@ -1,10 +0,0 @@
-/**
- * RGB from each of the CMYK values to determine a return as an any[].
- * CMYK values are as follows.
- * C - a number between 0 and 255 representing cyan
- * M - number between 0 and 255 representing magenta
- * Y - number between 0 and 255 representing yellow
- * K - number between 0 and 255 representing black
- *
- **/
-export declare function CMYKtoRGB(c: number, m: number, y: number, k: number): any[];

package/lib/color/HEXtoRGB.d.ts

@@ -1,5 +0,0 @@
-export declare function HEXtoRGB(color: number | string): {
-    r: number;
-    g: number;
-    b: number;
-};

package/lib/color/HSVtoRGB.d.ts

@@ -1,21 +0,0 @@
-/**
- * HSV from each of the RGB values to determine a return as an any[].
- * RGB values are as follows.
- * R - a number from 0 to 255
- * G - a number from 0 to 255
- * B - a number from 0 to 255
- *
- * HSV values are as follows.
- * H - a number between 360-0
- * S - number between 0 and 1.0
- * V - number between 0 and 1.0
- *
- * H is replaced with equivalent numbers in the range of the 360-0 that is out of range.
- * Cannot compute, including alpha.
- *
- * @ Param h hue (Hue) number that indicates (to 360-0)
- * @ Param s the saturation (Saturation) shows the number (0.0 to 1.0)
- * @ Param v lightness (Value) indicates the number (0.0 to 1.0)
- * @ Return RGB values into an any[] of [R, G, B]
- **/
-export declare function HSVtoRGB(h: number, s: number, v: number): number[];

package/lib/color/RGBtoCMYK.d.ts

@@ -1,20 +0,0 @@
-/**
- * RGB from the respective figures, HSV sequences in terms of returns.
- * RGB values are as follows.
- * R - a number from 0 to 255
- * G - a number from 0 to 255
- * B - a number from 0 to 255
- *
- * CMYK values are as follows.
- * C - a number between 0 and 255 representing cyan
- * M - number between 0 and 255 representing magenta
- * Y - number between 0 and 255 representing yellow
- * K - number between 0 and 255 representing black
- *
- * Cannot compute, including alpha.
- * @ Param r the red (R) indicating the number (0x00 to 0xFF to)
- * @ Param g green (G) indicates the number (0x00 to 0xFF to)
- * @ Param b blue (B) shows the number (0x00 to 0xFF to)
- * @ Return CMYK values into an any[] of [H, S, V]
- **/
-export declare function RGBtoCMYK(r: number, g: number, b: number): any[];

package/lib/color/RGBtoHEX.d.ts

@@ -1 +0,0 @@
-export declare function RGBtoHEX(r: number, g: number, b: number): string;

package/lib/color/RGBtoHSV.d.ts

@@ -1,19 +0,0 @@
-/**
- * RGB from the respective figures, HSV sequences in terms of returns.
- * RGB values are as follows.
- * R - a number from 0 to 255
- * G - a number from 0 to 255
- * B - a number from 0 to 255
- *
- * HSV values are as follows.
- * H - a number between 360-0
- * S - number between 0 and 1.0
- * V - number between 0 and 1.0
- *
- * Cannot compute, including alpha.
- * @ Param r the red (R) indicating the number (0x00 to 0xFF to)
- * @ Param g green (G) indicates the number (0x00 to 0xFF to)
- * @ Param b blue (B) shows the number (0x00 to 0xFF to)
- * @ Return HSV values into an any[] of [H, S, V]
- **/
-export declare function RGBtoHSV(r: number, g: number, b: number): number[];

package/lib/color/hsv.d.ts

@@ -1 +0,0 @@
-export declare function hsv(h: number, s: number, v: number): number;

package/lib/color/index.d.ts

@@ -1,16 +0,0 @@
-export * from './CMYKtoRGB';
-export * from './HEXtoRGB';
-export * from './hsv';
-export * from './HSVtoRGB';
-export * from './max';
-export * from './min';
-export * from './overlay';
-export * from './rgb';
-export * from './RGBtoCMYK';
-export * from './RGBtoHEX';
-export * from './RGBtoHSV';
-export * from './sub';
-export * from './subtract';
-export * from './sum';
-export * from './toRGB';
-export * from './toRGBA';

package/lib/color/max.d.ts

@@ -1 +0,0 @@
-export declare function max(col1: number, col2: number): number;

package/lib/color/min.d.ts

@@ -1 +0,0 @@
-export declare function min(col1: number, col2: number): number;

package/lib/color/overlay.d.ts

@@ -1 +0,0 @@
-export declare function overlay(col1: number, col2: number): number;

package/lib/color/rgb.d.ts

@@ -1,8 +0,0 @@
-/**
- *  Values calculated from each RGB * RGB color value.
- * @ Param r the red (R) indicating the number (0-255)
- * @ Param g green (G) indicates the number (0-255)
- * @ Param b blue (B) shows the number (0-255)
- * @ Return obtained from the RGB color value for each indicating the number
- **/
-export declare function rgb(r: number, g: number, b: number): number;

package/lib/color/sub.d.ts

@@ -1 +0,0 @@
-export declare function sub(col1: number, col2: number): number;

package/lib/color/subtract.d.ts

@@ -1 +0,0 @@
-export declare function subtract(col1: number, col2: number): number;

package/lib/color/sum.d.ts

@@ -1 +0,0 @@
-export declare function sum(col1: number, col2: number): number;

package/lib/color/toRGB.d.ts

@@ -1,8 +0,0 @@
-/**
- * RGB figures show (0x000000 0xFFFFFF up from) the
- * R, G, B returns an any[] divided into a number from 0 to 255, respectively.
- *
- * @ Param rgb numbers show (0x000000 0xFFFFFF up from)
- * @ Return any[] indicates the value of each color [R, G, B]
- **/
-export declare function toRGB(rgb: number): number[];

package/lib/color/toRGBA.d.ts

@@ -1 +0,0 @@
-export declare function toRGBA(rgba: number): number[];

package/lib/constants/color-codes.constant.d.ts

@@ -1,9 +0,0 @@
-export declare const COLOR_CODES: {
-    readonly TO_UNREAL: readonly ["#ffffff", "#005912", "UNREAL <-"];
-    readonly TAP_LOG: readonly ["#ffff00", "#1976d2", " [TAPLOG]"];
-    readonly FROM_UNREAL: readonly ["#ffff00", "#898989", "UNREAL ->"];
-    readonly FROM_UNREAL_ERROR: readonly ["#ffffff", "#ff0000", "UNREAL ERROR ->"];
-    readonly FROM_CIRRUS: readonly ["#ffffff", "#ef702b", "CIRRUS ->"];
-    readonly FROM_CIRRUS_ERROR: readonly ["#ffffff", "#ff0000", "CIRRUS ->"];
-    readonly TO_CIRRUS: readonly ["#ffffff", "#3c9738", "CIRRUS <-"];
-};

package/lib/constants/index.d.ts

@@ -1 +0,0 @@
-export * from './color-codes.constant';

package/lib/csv/CSV2Array.d.ts

@@ -1 +0,0 @@
-export declare function CSV2Array(strData: any, strDelimiter?: string): any[];

package/lib/csv/CSV2Records.d.ts

@@ -1 +0,0 @@
-export declare function CSV2Records(csv: string, useRowAsHead?: number, strDelimiter?: string): any;

package/lib/csv/ObjectToCSV.d.ts

@@ -1 +0,0 @@
-export declare function ObjectToCSV<T extends object>(records: T[]): string | undefined;

package/lib/csv/index.d.ts

@@ -1,3 +0,0 @@
-export * from './CSV2Array';
-export * from './CSV2Records';
-export * from './ObjectToCSV';

package/lib/dev/dev3d.d.ts

@@ -1 +0,0 @@
-export declare const isLocalhost: boolean;

package/lib/dev/index.d.ts

@@ -1,3 +0,0 @@
-export * from './dev3d';
-export * from './logger';
-export * from './timeToString';

package/lib/dev/logger.d.ts

@@ -1,11 +0,0 @@
-export declare class Logger {
-    static isDevMode: boolean;
-    static colored(color: string, background: string, ...args: unknown[]): void;
-    static log(...args: unknown[]): void;
-    static warn(...args: unknown[]): void;
-    static info(...args: unknown[]): void;
-    static error(...args: unknown[]): void;
-    static table(...args: unknown[]): void;
-    static time(...args: any): void;
-    static timeEnd(...args: any): void;
-}

package/lib/dev/timeToString.d.ts

@@ -1,5 +0,0 @@
-/**
- * Create a string of the form 'HOURS.MINUTES.SECONDS.MILLISECONDS'.
- */
-export declare function timeToString(): string;
-export declare function timeUTCToString(): string;

package/lib/filenaming/cleanupFileName.d.ts

@@ -1 +0,0 @@
-export declare function cleanupFileName(value: string): string;

package/lib/filenaming/index.d.ts

@@ -1,3 +0,0 @@
-export * from './cleanupFileName';
-export * from './makePath';
-export * from './normalizePath';

package/lib/filenaming/makePath.d.ts

@@ -1 +0,0 @@
-export declare function makePath(...value: string[]): string;

package/lib/filenaming/normalizePath.d.ts

@@ -1 +0,0 @@
-export declare function normalizePath(value: string): string;

package/lib/geom/expandOverRectangle.d.ts

@@ -1,2 +0,0 @@
-import type { Area, Rect } from './interfaces';
-export declare function expandOverRectangle(objectRect: Rect, areaRect: Rect): Area;

package/lib/geom/fitIntoRectangle.d.ts

@@ -1,2 +0,0 @@
-import type { Area, Rect } from './interfaces';
-export declare function fitIntoRectangle(objectRect: Rect, areaRect: Rect, round?: boolean, fixedRatio?: number | null): Area;

package/lib/geom/index.d.ts

@@ -1,3 +0,0 @@
-export * from './interfaces';
-export * from './expandOverRectangle';
-export * from './fitIntoRectangle';

package/lib/geom/interfaces/area.interface.d.ts

@@ -1,4 +0,0 @@
-import type { Rect } from './rect.interface';
-export interface Area extends Rect {
-    scale: number;
-}

package/lib/geom/interfaces/index.d.ts

@@ -1,4 +0,0 @@
-export * from './area.interface';
-export * from './rect.interface';
-export * from './size.interface';
-export * from './сoords.interface';

package/lib/geom/interfaces/rect.interface.d.ts

@@ -1,4 +0,0 @@
-import type { Size } from './size.interface';
-import type { Coords } from './сoords.interface';
-export interface Rect extends Size, Coords {
-}

package/lib/geom/interfaces/size.interface.d.ts

@@ -1,4 +0,0 @@
-export interface Size {
-    w: number;
-    h: number;
-}

package/lib/geom/interfaces//321/201oords.interface.d.ts

@@ -1,4 +0,0 @@
-export interface Coords {
-    x: number;
-    y: number;
-}

package/lib/helpers/BatchLoader.d.ts

@@ -1,47 +0,0 @@
-import type { LoadArgs } from '../interfaces';
-export declare class BatchLoader {
-    private maximumSlotsNumber;
-    private queue;
-    private slots;
-    private _whenDone;
-    clear(): void;
-    /**
-     * new settings
-     * you must pass new settings
-     * @param sett
-     */
-    setSettings(sett: any): void;
-    /**
-     * execute with a chosen file
-     * @param id
-     * @param func
-     */
-    withItem(id: string, func: (item: LoadArgs) => any): boolean;
-    remove(id: string): LoadArgs[];
-    /**
-     * executes when all files are downloaded
-     * @param cb
-     */
-    whenDone(cb: any): void;
-    load(args: LoadArgs[]): {
-        path: string;
-        self?: any;
-        id: string;
-    }[];
-    /**
-     * operates with one file
-     * @param item
-     * @private
-     */
-    private add;
-    private sortByOrder;
-    private loadEnd;
-    private checkSlots;
-    /**
-     * get Item By id for interaction with files in this.queue
-     * @param id
-     * @private
-     */
-    private getById;
-    private getXmlHttp;
-}

package/lib/helpers/KeyboardNumericCode.d.ts

@@ -1,103 +0,0 @@
-declare const KeyboardNumericCode: {
-    readonly Backspace: 8;
-    readonly Tab: 9;
-    readonly Numpad5: 12;
-    readonly NumpadEnter: 13;
-    readonly ShiftRight: 16;
-    readonly ControlRight: 17;
-    readonly ControlLeft: 17;
-    readonly AltRight: 18;
-    readonly Escape: 27;
-    readonly Space: 32;
-    readonly Numpad9: 33;
-    readonly Numpad3: 34;
-    readonly Numpad1: 35;
-    readonly Numpad7: 36;
-    readonly Numpad4: 37;
-    readonly Numpad8: 38;
-    readonly Numpad6: 39;
-    readonly Numpad2: 40;
-    readonly Numpad0: 45;
-    readonly NumpadDecimal: 46;
-    readonly Digit0: 48;
-    readonly Digit1: 49;
-    readonly Digit2: 50;
-    readonly Digit3: 51;
-    readonly Digit4: 52;
-    readonly Digit5: 53;
-    readonly Digit6: 54;
-    readonly Digit7: 55;
-    readonly Digit8: 56;
-    readonly Digit9: 57;
-    readonly KeyA: 65;
-    readonly KeyB: 66;
-    readonly KeyC: 67;
-    readonly KeyD: 68;
-    readonly KeyE: 69;
-    readonly KeyF: 70;
-    readonly KeyG: 71;
-    readonly KeyH: 72;
-    readonly KeyI: 73;
-    readonly KeyJ: 74;
-    readonly KeyK: 75;
-    readonly KeyL: 76;
-    readonly KeyM: 77;
-    readonly KeyN: 78;
-    readonly KeyO: 79;
-    readonly KeyP: 80;
-    readonly KeyQ: 81;
-    readonly KeyR: 82;
-    readonly KeyS: 83;
-    readonly KeyT: 84;
-    readonly KeyU: 85;
-    readonly KeyV: 86;
-    readonly KeyW: 87;
-    readonly KeyX: 88;
-    readonly KeyY: 89;
-    readonly KeyZ: 90;
-    readonly MetaLeft: 91;
-    readonly ContextMenu: 93;
-    readonly NumpadMultiply: 106;
-    readonly NumpadAdd: 107;
-    readonly NumpadSubtract: 109;
-    readonly NumpadDivide: 111;
-    readonly F1: 112;
-    readonly F2: 113;
-    readonly F3: 114;
-    readonly F4: 115;
-    readonly F5: 116;
-    readonly F6: 117;
-    readonly F7: 118;
-    readonly F8: 119;
-    readonly F9: 120;
-    readonly F10: 121;
-    readonly F11: 122;
-    readonly F12: 123;
-    readonly NumLock: 144;
-    readonly ScrollLock: 145;
-    readonly Semicolon: 186;
-    readonly Equal: 187;
-    readonly Comma: 188;
-    readonly Minus: 189;
-    readonly Period: 190;
-    readonly Slash: 191;
-    readonly Backquote: 192;
-    readonly BracketLeft: 219;
-    readonly Backslash: 220;
-    readonly BracketRight: 221;
-    readonly Quote: 222;
-    readonly IntlBackslash: 226;
-    readonly ArrowUp: 38;
-    readonly ArrowDown: 40;
-    readonly ArrowLeft: 37;
-    readonly ArrowRight: 39;
-};
-type IKeyName = keyof typeof KeyboardNumericCode;
-type IKeyCode = (typeof KeyboardNumericCode)[IKeyName];
-type InvertedKeyMapType = {
-    [K in IKeyName as (typeof KeyboardNumericCode)[K]]: K;
-};
-declare const InvertedKeyMap: InvertedKeyMapType;
-declare const KeyboardStringCode: { [K in IKeyName]: K; };
-export type { IKeyName, IKeyCode };
-export { KeyboardStringCode, InvertedKeyMap, KeyboardNumericCode };

package/lib/helpers/debounce.d.ts

@@ -1 +0,0 @@
-export declare const debounce: <T extends (...args: any[]) => any>(fn: T, ms?: number) => (this: any, ...args: any[]) => void;

package/lib/helpers/generate-uuid.d.ts

@@ -1 +0,0 @@
-export declare function generateUuid(): string;

package/lib/helpers/index.d.ts

@@ -1,12 +0,0 @@
-export * from './BatchLoader';
-export * from './debounce';
-export * from './KeyboardNumericCode';
-export * from './serialize';
-export * from './save-to-local-drive';
-export * from './sleep';
-export * from './trimLastSlashFromUrl';
-export * from './signal';
-export * from './generate-uuid';
-export * from './short-hash';
-export * from './is-desktop';
-export * from './media';

package/lib/helpers/is-desktop.d.ts

@@ -1 +0,0 @@
-export declare const isDesktop: () => boolean;

package/lib/helpers/media.d.ts

@@ -1 +0,0 @@
-export declare const media: (query: string) => import("rxjs").Observable<boolean>;

package/lib/helpers/save-to-local-drive.d.ts

@@ -1 +0,0 @@
-export declare const saveToLocalDrive: (uri: string, name: string) => any;

package/lib/helpers/serialize.d.ts

@@ -1 +0,0 @@
-export declare function serialize(obj: any): string;

package/lib/helpers/short-hash.d.ts

@@ -1,2 +0,0 @@
-export declare function shortHash<T>(data: T, shorten?: boolean): string;
-export declare function shortHash(data: null | undefined, shorten?: boolean): null;

package/lib/helpers/signal.d.ts

@@ -1,23 +0,0 @@
-import type { Observable } from 'rxjs';
-/**
- * SingleTone Private class.
- * Event-Driving pattern for sending signals from component to component.
- */
-declare class SignalClass {
-    private static eventBus;
-    constructor();
-    /**
-     * It is not recommended to use this class directly.
-     * use the sendSignal functions instead.
-     * those wrappers are more convenient and provide a better type safety.
-     */
-    broadcast<K, D>(key: K, data?: D): void;
-    /**
-     * It is not recommended to use this class directly.
-     * use the fromSignal functions instead.
-     * those wrappers are more convenient and provide a better type safety.
-     */
-    on<K, D = any>(key: K): Observable<D>;
-}
-export declare const Signal: SignalClass;
-export {};

package/lib/helpers/sleep.d.ts

@@ -1 +0,0 @@
-export declare function sleep(time: number): Promise<unknown>;

package/lib/helpers/trimLastSlashFromUrl.d.ts

@@ -1 +0,0 @@
-export declare function trimLastSlashFromUrl(baseUrl: string): string | null | undefined;

package/lib/image/SaveImage.d.ts

@@ -1,18 +0,0 @@
-import type { ImageOutputValues } from '../interfaces';
-/**
- * USE DownloadImage instead!
- * @deprecated use DownloadImage instead!
- * @param imageSource
- * @param name
- * @param width
- * @param format
- */
-declare function SaveImage(imageSource: HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | ImageBitmap | string, name: string, width?: number, format?: string | ImageOutputValues): any;
-/**
- * @param imageSource
- * @param string name
- * @param number width
- * @param string format
- */
-declare const DownloadImage: typeof SaveImage;
-export { SaveImage, DownloadImage };

package/lib/image/getCanvasCached.d.ts

@@ -1,4 +0,0 @@
-export declare function getCanvasCached(id: string): {
-    canvas: HTMLCanvasElement;
-    ctx: CanvasRenderingContext2D;
-};

package/lib/image/getSnapshot.d.ts

@@ -1,2 +0,0 @@
-import type { ImageOutputValues } from '../interfaces';
-export declare function getSnapshot(imageElement: HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | ImageBitmap, maxWidth?: number, output?: ImageOutputValues, quality?: number): HTMLCanvasElement | string;

package/lib/image/index.d.ts

@@ -1,4 +0,0 @@
-export * from './getCanvasCached';
-export * from './getSnapshot';
-export * from './loadImage';
-export * from './SaveImage';

package/lib/image/loadImage.d.ts

@@ -1 +0,0 @@
-export declare function loadImage(url: string): Promise<HTMLImageElement>;

package/lib/interfaces/image-output.d.ts

@@ -1,7 +0,0 @@
-export declare const ImageOutput: {
-    readonly CANVAS: "canvas";
-    readonly PNG: "image/png";
-    readonly WEBP: "image/webp";
-    readonly JPG: "image/jpeg";
-};
-export type ImageOutputValues = (typeof ImageOutput)[keyof typeof ImageOutput];

package/lib/interfaces/index.d.ts

@@ -1,3 +0,0 @@
-export * from './load-args.interface';
-export * from './load-args-tmp.interface';
-export * from './image-output';

package/lib/interfaces/load-args-tmp.interface.d.ts

@@ -1,4 +0,0 @@
-import type { LoadArgs } from './load-args.interface';
-export interface LoadArgsTmp extends LoadArgs {
-    xhr?: XMLHttpRequest;
-}

package/lib/interfaces/load-args.interface.d.ts

@@ -1,15 +0,0 @@
-export interface LoadArgs {
-    order: number;
-    extra: any;
-    item?: HTMLImageElement;
-    useXhr?: boolean;
-    path: string;
-    onLoadEnd: (data: LoadArgs) => void;
-    onLoadStart: (data: ProgressEvent) => void;
-    onProgress: (data: ProgressEvent) => void;
-    id?: string;
-    img?: HTMLImageElement;
-    error?: boolean;
-    fallBack?: string;
-    resolutionId: number | string | null;
-}

package/lib/math/baseSortedIndex.d.ts

@@ -1,25 +0,0 @@
-/**
- * Calculates the index at which the `value` should be inserted into the `array` to maintain its
- * sorted order. This function performs a binary search with a complexity of O(log n), making it
- * efficient for large datasets. It assumes that the input array is sorted in ascending order and
- * contains comparable elements.
- *
- * Note: The function is designed to handle arrays with lengths up to a maximum of `HALF_MAX_ARRAY_LENGTH`
- * to ensure the search operation remains within JavaScript's maximum array index limit.
- *
- * @param {any[]} array The sorted array into which the value should be inserted. The array elements
- *                      should be comparable with the `value` using less-than and greater-than operations.
- * @param {number} value The value to insert into the array. This function assumes that `array` is sorted
- *                       in ascending order and will find the correct position for `value` accordingly.
- * @returns {number} The index at which the `value` should be inserted into `array` to maintain its sorted order.
- *                   If the `array` is empty or if `value` is less than or equal to all elements in `array`,
- *                   returns 0. If `value` is greater than all elements in `array`, returns the length of `array`.
- * @example
- * // returns 2
- * baseSortedIndex([1, 3, 4], 3);
- *
- * @example
- * // returns 1
- * baseSortedIndex([1, 2, 3], 2);
- */
-export declare function baseSortedIndex(array: number[], value: number): number;

package/lib/math/calculateMedian.d.ts

@@ -1,17 +0,0 @@
-/**
- * Calculates the median of an array of numbers.
- *
- * The median is the middle value of a sorted list of numbers. If the list has an even number
- * of elements, the median is the average of the two middle numbers.
- *
- * @param numbers - An array of numbers for which the median will be calculated.
- * @returns The median value as a number, or `null` if the array is empty.
- *
- * @example
- * ```typescript
- * const numbers = [3, 1, 4, 2];
- * const median = calculateMedian(numbers);
- * console.log(median); // Output: 2.5
- * ```
- */
-export declare function calculateMedian(numbers: number[]): number;