@zoodogood/utils 1.0.8-change.941 → 1.1.0-change.1043

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zoodogood/utils",
   "type": "module",
-  "version": "1.0.8-change.941",
+  "version": "1.1.0-change.1043",
   "description": "",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/readme.md

@@ -10,4 +10,4 @@ export { ending } from '@zoodogood/utils/primitives';
 [NPM](https://www.npmjs.com/package/@zoodogood/utils)
 
 #### From developer:
-(Wa) Use only documented functions that are not marked "Unstable". Thanks.
+(Warning) Use only documented functions that are not marked "Unstable". Thanks.

package/lib/discordjs/helpers.d.ts

@@ -1,10 +0,0 @@
-export type APIBaseButton = import("discord-api-types/v10").APIButtonComponentBase<any>;
-/**
- * @typedef {import("discord-api-types/v10").APIButtonComponentBase} APIBaseButton
- */
-/**
- *
- * @param {APIBaseButton} resolable
- */
-export function justButtonComponents(resolable: import("discord-api-types/v10").APIButtonComponentBase<any>): any;
-export function justSendMessage(target: any, options: any): Promise<any>;

package/lib/discordjs/helpers.js

@@ -1,48 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { BaseInteraction, ButtonStyle, ComponentType } from "discord.js";
-import { SimplifyComponents, CreateMessage } from "./simplify.js";
-const DEFAULTS_FOR_BUTTON = {
-    type: ComponentType.Button,
-    style: ButtonStyle.Secondary,
-};
-/**
- * @typedef {import("discord-api-types/v10").APIButtonComponentBase} APIBaseButton
- */
-/**
- *
- * @param {APIBaseButton} resolable
- */
-function justButtonComponents(resolable) {
-    const buttons = resolable.map((data, i) => (Object.assign(Object.assign(Object.assign({}, DEFAULTS_FOR_BUTTON), { customId: `button.${i + 1}` }), data)));
-    return SimplifyComponents(buttons);
-}
-function justSendMessage(target, options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const messagePayload = CreateMessage(options);
-        const message = target instanceof BaseInteraction
-            ? yield (options.edit
-                ? target.replied
-                    ? target.editReply(messagePayload)
-                    : target.update(messagePayload)
-                : target.reply(messagePayload))
-            : yield (options.edit
-                ? target.edit(messagePayload)
-                : target.send(messagePayload));
-        if (options.delete) {
-            setTimeout(() => message.delete(), options.delete);
-        }
-        if (options.reactions) {
-            options.reactions.filter(Boolean).forEach((react) => message.react(react));
-        }
-        return message;
-    });
-}
-export { justButtonComponents, justSendMessage };

package/lib/discordjs/mod.d.ts

@@ -1,2 +0,0 @@
-export * from "./helpers.js";
-export * from "./simplify.js";

package/lib/discordjs/mod.js

@@ -1,2 +0,0 @@
-export * from "./helpers.js";
-export * from "./simplify.js";

package/lib/discordjs/simplify.d.ts

@@ -1,54 +0,0 @@
-/**
- * Create a message object for Discord.
- *
- * @param {Object} params = Parameters for creating the message.
- * @param {string} [params.content] - The message content.
- * @param {string} [params.title] - The title of the embed.
- * @param {string} [params.url] - The URL of the embed.
- * @param {Object} [params.author] - The author of the embed.
- * @param {string} [params.thumbnail] - The thumbnail URL of the embed.
- * @param {string} [params.description] - The description of the embed.
- * @param {string} [params.color] - The color of the embed.
- * @param {Object[]} [params.fields] - The fields of the embed.
- * @param {string} [params.image] - The image URL of the embed.
- * @param {string} [params.video] - The video URL of the embed.
- * @param {Object} [params.footer] - The footer of the embed.
- * @param {string} [params.timestamp] - The timestamp of the embed.
- * @param {boolean} [params.ephemeral] - Whether the message should be ephemeral.
- * @param {boolean} [params.fetchReply] - Whether to fetch the message reply.
- * @param {Object[] | Object} [params.components] - The message components.
- * @param {Object[] | Object[]} [params.files] - The message files.
- * @param {string} [params.reference] - The message reference.
- * @returns {Object} - The message object.
- */
-export function CreateMessage({ content, title, url, author, thumbnail, description, color, fields, image, video, footer, timestamp, ephemeral, fetchReply, components, files, reference, }: {
-    content?: string | undefined;
-    title?: string | undefined;
-    url?: string | undefined;
-    author?: Object | undefined;
-    thumbnail?: string | undefined;
-    description?: string | undefined;
-    color?: string | undefined;
-    fields?: Object[] | undefined;
-    image?: string | undefined;
-    video?: string | undefined;
-    footer?: Object | undefined;
-    timestamp?: string | undefined;
-    ephemeral?: boolean | undefined;
-    fetchReply?: boolean | undefined;
-    components?: Object | Object[] | undefined;
-    files?: Object[] | undefined;
-    reference?: string | undefined;
-}): Object;
-export function CreateModal({ title, customId, components }: {
-    title: any;
-    customId: any;
-    components: any;
-}): import("discord.js").APIModalInteractionResponseCallbackData;
-export function SimplifyComponents(data: any): any;
-/**
- *
- * @param {*} embed
- * @returns {boolean}
- */
-export function isEmptyEmbed(embed: any): boolean;

package/lib/discordjs/simplify.js

@@ -1,116 +0,0 @@
-import { EmbedBuilder, ModalBuilder, resolveColor, ActionRow, } from "discord.js";
-import { ComponentType } from "discord-api-types/v10";
-/**
- *
- * @param {*} embed
- * @returns {boolean}
- */
-function isEmptyEmbed(embed) {
-    const DEFAULT_PROPERTIES = {
-        title: undefined,
-        author: undefined,
-        thumbnail: undefined,
-        description: undefined,
-        fields: undefined,
-        image: undefined,
-        footer: undefined,
-        timestamp: undefined,
-        video: undefined,
-    };
-    // in isEmptyEmbed context is a good compare
-    const isEqualDefault = (key) => String(embed[key]) === String(DEFAULT_PROPERTIES[key]);
-    const isEveryPropertyDefault = Object.keys(DEFAULT_PROPERTIES).every(isEqualDefault);
-    return isEveryPropertyDefault;
-}
-/**
- * Create a message object for Discord.
- *
- * @param {Object} params = Parameters for creating the message.
- * @param {string} [params.content] - The message content.
- * @param {string} [params.title] - The title of the embed.
- * @param {string} [params.url] - The URL of the embed.
- * @param {Object} [params.author] - The author of the embed.
- * @param {string} [params.thumbnail] - The thumbnail URL of the embed.
- * @param {string} [params.description] - The description of the embed.
- * @param {string} [params.color] - The color of the embed.
- * @param {Object[]} [params.fields] - The fields of the embed.
- * @param {string} [params.image] - The image URL of the embed.
- * @param {string} [params.video] - The video URL of the embed.
- * @param {Object} [params.footer] - The footer of the embed.
- * @param {string} [params.timestamp] - The timestamp of the embed.
- * @param {boolean} [params.ephemeral] - Whether the message should be ephemeral.
- * @param {boolean} [params.fetchReply] - Whether to fetch the message reply.
- * @param {Object[] | Object} [params.components] - The message components.
- * @param {Object[] | Object[]} [params.files] - The message files.
- * @param {string} [params.reference] - The message reference.
- * @returns {Object} - The message object.
- */
-function CreateMessage({ content, title, url, author, thumbnail, description, color, fields, image, video, footer, timestamp, ephemeral, fetchReply, components, files, reference, }) {
-    const message = {};
-    thumbnail && (thumbnail = { url: thumbnail });
-    image && (image = { url: image });
-    video && (video = { url: video });
-    color = resolveColor(color !== null && color !== void 0 ? color : "Random");
-    const embed = new EmbedBuilder({
-        title,
-        url,
-        author,
-        thumbnail,
-        description,
-        color,
-        fields,
-        image,
-        video,
-        footer,
-        timestamp,
-    });
-    if (!isEmptyEmbed(embed.data)) {
-        message.embeds = [embed];
-    }
-    if (files) {
-        message.files = files;
-    }
-    if (reference)
-        message.reply = {
-            messageReference: reference,
-        };
-    message.components = components ? SimplifyComponents(components) : null;
-    message.content = content;
-    message.ephemeral = ephemeral;
-    message.fetchReply = fetchReply;
-    return message;
-}
-function CreateModal({ title, customId, components }) {
-    components = SimplifyComponents(components);
-    return new ModalBuilder({ title, customId, components }).toJSON();
-}
-function SimplifyComponents(data) {
-    if (data instanceof Array && data.length === 0)
-        return [];
-    const isComponent = (component) => "type" in component && component.type !== ComponentType.ActionRow;
-    const isActionRow = (component) => (component instanceof Array && isComponent(component.at(0))) ||
-        component instanceof ActionRow;
-    const isComponents = (component) => component instanceof Array && isActionRow(component.at(0));
-    const argumentType = [
-        isComponent(data),
-        isActionRow(data),
-        isComponents(data),
-    ].findIndex(Boolean);
-    if (argumentType === -1)
-        throw new TypeError("expected component");
-    const wrapToArray = (component) => [component];
-    const arrayToActionRow = (componentsArray) => {
-        const isActionRow = "type" in componentsArray &&
-            componentsArray.type === ComponentType.ActionRow;
-        if (isActionRow)
-            return componentsArray;
-        return { type: ComponentType.ActionRow, components: componentsArray };
-    };
-    if (argumentType <= 0)
-        data = wrapToArray(data);
-    if (argumentType <= 1)
-        data = wrapToArray(data);
-    data = data.map(arrayToActionRow);
-    return data;
-}
-export { CreateMessage, CreateModal, SimplifyComponents, isEmptyEmbed };

package/lib/index.d.ts

@@ -1,2 +0,0 @@
-export * from './primitives/mod.js';
-export * from './objectives/mod.js';

package/lib/nodejs/getChildProcessUtils.d.ts

@@ -1,23 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-import type { ChildProcessWithoutNullStreams } from "child_process";
-import EventsEmitter from "events";
-interface IContext {
-    exitter: {
-        resolve: any;
-        reject: any;
-    };
-    whenEnd: Promise<unknown>;
-    child: ChildProcessWithoutNullStreams;
-    emitter: EventsEmitter;
-    outString: string;
-}
-interface IParams {
-    root: string;
-    logger?: boolean;
-}
-declare const _default: ({ root, logger }: IParams) => {
-    run: (command: string, params: string[]) => IContext;
-    info: (log: string) => void;
-    _npm: string;
-};
-export default _default;

package/lib/nodejs/getChildProcessUtils.js

@@ -1,98 +0,0 @@
-import { spawn } from "child_process";
-import EventsEmitter from "events";
-export default ({ root, logger = false }) => {
-    // Solve problem: https://stackoverflow.com/questions/43230346/error-spawn-npm-enoent
-    const _npm = process.platform === "win32" ? "npm.cmd" : "npm";
-    const EventsCallbacks = [
-        {
-            key: "stdoutError",
-            callback({ exitter }, error) {
-                logger && info(`Error: ${error.message}`);
-                exitter.reject(error);
-            },
-        },
-        {
-            key: "stderrError",
-            callback({ exitter }, error) {
-                logger && info(`Error: ${error.message}`);
-                exitter.reject(error);
-            },
-        },
-        {
-            key: "stdoutData",
-            callback(context, data) {
-                const content = String(data);
-                context.emitter.emit("data", content);
-                context.outString = context.outString.concat(content);
-                logger && console.info(content);
-            },
-        },
-        {
-            key: "stderrData",
-            callback(context, data) {
-                const content = String(data);
-                context.emitter.emit("data", content);
-                context.outString = context.outString.concat(content);
-                logger && console.info(content);
-            },
-        },
-        {
-            key: "message",
-            callback(_context, data) {
-                logger && console.info(data.toString());
-            },
-        },
-        {
-            key: "exit",
-            callback({ exitter, outString }) {
-                exitter.resolve(outString);
-            },
-        },
-        {
-            key: "error",
-            callback({ exitter }, error) {
-                logger && info(`Error: ${error.message}`);
-                exitter.reject(error);
-            },
-        },
-    ];
-    const info = (log) => console.info(`\x1b[1m${log}\x1b[22m`);
-    const run = (command, params) => {
-        const child = spawn(command, params, { cwd: root });
-        const exitter = { resolve: null, reject: null };
-        const promise = new Promise((resolve, reject) => Object.assign(exitter, { resolve, reject }));
-        const emitter = new EventsEmitter();
-        const outString = "";
-        const context = {
-            exitter,
-            whenEnd: promise,
-            child,
-            emitter,
-            outString,
-        };
-        const events = Object.fromEntries(EventsCallbacks.map(({ callback, key }) => [
-            key,
-            callback.bind(null, context),
-        ]));
-        (() => {
-            child.stdout.on("error", events.stdoutError);
-            child.stderr.on("error", events.stderrError);
-            child.stdout.on("data", events.stdoutData);
-            child.stderr.on("data", events.stderrData);
-            child.on("error", events.error);
-            child.on("message", events.message);
-            child.on("exit", events.exit);
-        })();
-        promise.finally(() => {
-            child.stdout.removeListener("error", events.stdoutError);
-            child.stderr.removeListener("error", events.stderrError);
-            child.stdout.removeListener("data", events.stdoutData);
-            child.stderr.removeListener("data", events.stderrData);
-            child.removeListener("error", events.error);
-            child.removeListener("message", events.message);
-            child.removeListener("exit", events.exit);
-        });
-        return context;
-    };
-    return { run, info, _npm };
-};

package/lib/nodejs/mod.d.ts

@@ -1 +0,0 @@
-export { default as getChildProcessUtils } from './getChildProcessUtils.js';

package/lib/nodejs/mod.js

@@ -1 +0,0 @@
-export { default as getChildProcessUtils } from './getChildProcessUtils.js';

package/lib/objectives/CustomCollector.d.ts

@@ -1,25 +0,0 @@
-/// <reference types="node" resolution-mode="require"/>
-interface ICustomCollectorOptions {
-    target: Required<{
-        removeListener: CallableFunction;
-        on: CallableFunction;
-    }>;
-    event: string;
-    filter?: Function;
-    time: number;
-}
-declare class CustomCollector {
-    #private;
-    timeoutId?: NodeJS.Timeout;
-    target: ICustomCollectorOptions["target"];
-    event: ICustomCollectorOptions["event"];
-    filter: ICustomCollectorOptions["filter"];
-    time: ICustomCollectorOptions["time"];
-    constructor({ target, event, filter, time }: ICustomCollectorOptions);
-    setCallback(callback: CallableFunction): void;
-    handle(handler: CallableFunction): void;
-    end(): void;
-    removeTimeout(): void;
-    setTimeout(ms: number): void;
-}
-export { CustomCollector };

package/lib/objectives/CustomCollector.js

@@ -1,59 +0,0 @@
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _CustomCollector_callback;
-class CustomCollector {
-    constructor({ target, event, filter, time = 0 }) {
-        _CustomCollector_callback.set(this, void 0);
-        if ("on" in target === false) {
-            throw new Error("Target must be similar to EventEmitter.prototype — target haven't method 'on'");
-        }
-        this.target = target;
-        this.event = event;
-        this.filter = filter;
-        this.time = time;
-    }
-    setCallback(callback) {
-        const handler = (...params) => {
-            const passed = !this.filter || this.filter(params);
-            if (!!passed === true) {
-                // @ts-ignore
-                callback.apply(this, params);
-            }
-        };
-        this.handle(handler);
-    }
-    handle(handler) {
-        this.end();
-        __classPrivateFieldSet(this, _CustomCollector_callback, handler, "f");
-        this.target.on(this.event, __classPrivateFieldGet(this, _CustomCollector_callback, "f"));
-        if (this.time > 0) {
-            this.setTimeout(this.time);
-        }
-    }
-    end() {
-        if (this.timeoutId) {
-            this.removeTimeout();
-        }
-        if (__classPrivateFieldGet(this, _CustomCollector_callback, "f")) {
-            this.target.removeListener(this.event, __classPrivateFieldGet(this, _CustomCollector_callback, "f"));
-        }
-    }
-    removeTimeout() {
-        clearTimeout(this.timeoutId);
-    }
-    setTimeout(ms) {
-        const callback = this.end.bind(this);
-        this.timeoutId = setTimeout(callback, ms);
-    }
-}
-_CustomCollector_callback = new WeakMap();
-export { CustomCollector };

package/lib/objectives/DotNotatedInterface.d.ts

@@ -1,23 +0,0 @@
-interface IMethodsOptions {
-    defaultValue?: any;
-    allowSetFunctions?: boolean;
-}
-export declare class DotNotatedInterface {
-    target: Record<string, unknown>;
-    constructor(target: DotNotatedInterface["target"]);
-    getItem<T>(key: string, options?: IMethodsOptions): T | null;
-    setItem<T>(key: string, value: CallableFunction, options?: IMethodsOptions): T;
-    hasItem(key: string, options?: IMethodsOptions): boolean;
-    removeItem(key: string, options?: IMethodsOptions): boolean;
-    getParentAndlastSegmentByNotatedKey(key: string, { needFillIfParentNotExists }: {
-        needFillIfParentNotExists?: boolean | undefined;
-    }): {
-        parent: object | null;
-        lastSegment: string;
-    };
-    fillIsNotExists({ parent, segment, }: {
-        parent: {};
-        segment: string;
-    }): string;
-}
-export {};

package/lib/objectives/DotNotatedInterface.js

@@ -1,60 +0,0 @@
-export class DotNotatedInterface {
-    constructor(target) {
-        this.target = target;
-    }
-    getItem(key, options = {}) {
-        var _a;
-        const { parent, lastSegment } = this.getParentAndlastSegmentByNotatedKey(key, { needFillIfParentNotExists: false });
-        if (!parent || lastSegment in parent === false) {
-            return (_a = options.defaultValue) !== null && _a !== void 0 ? _a : null;
-        }
-        // @ts-ignore
-        return parent[lastSegment];
-    }
-    setItem(key, value, options = {}) {
-        if (typeof value === "function" && !options.allowSetFunctions) {
-            value = value(this.getItem(key, options));
-        }
-        const { parent, lastSegment } = this.getParentAndlastSegmentByNotatedKey(key, { needFillIfParentNotExists: true });
-        // @ts-ignore
-        return (parent[lastSegment] = value);
-    }
-    hasItem(key, options = {}) {
-        const { parent, lastSegment } = this.getParentAndlastSegmentByNotatedKey(key, { needFillIfParentNotExists: false });
-        if (parent === null) {
-            return false;
-        }
-        return lastSegment in parent;
-    }
-    removeItem(key, options = {}) {
-        const { parent, lastSegment } = this.getParentAndlastSegmentByNotatedKey(key, { needFillIfParentNotExists: false });
-        if (!parent) {
-            return false;
-        }
-        // @ts-ignore
-        return delete parent[lastSegment];
-    }
-    getParentAndlastSegmentByNotatedKey(key, { needFillIfParentNotExists = false }) {
-        const pathSegments = key.split(".");
-        if (!pathSegments.length) {
-            throw new Error("Empty path to property");
-        }
-        let parent = this.target;
-        for (let segment of pathSegments.slice(0, -1)) {
-            needFillIfParentNotExists &&
-                (segment = this.fillIsNotExists({ parent, segment }));
-            if (parent[segment] === undefined) {
-                return { parent: null, lastSegment: segment };
-            }
-            parent = parent[segment];
-        }
-        return { parent, lastSegment: pathSegments.at(-1) };
-    }
-    fillIsNotExists({ parent, segment, }) {
-        if (segment in parent === false) {
-            // @ts-ignore
-            parent[segment] = {};
-        }
-        return segment;
-    }
-}

package/lib/objectives/GlitchText.d.ts

@@ -1,16 +0,0 @@
-interface IGlitchTextOptions {
-    step?: number;
-    random?: boolean;
-    maximum?: number;
-}
-declare class GlitchText {
-    from: string;
-    to: string;
-    step: number;
-    random: boolean;
-    maximum: number;
-    [Symbol.iterator]: () => Generator<string>;
-    constructor(from?: string, to?: string, { step, random, maximum }?: IGlitchTextOptions);
-    iteratorFunction(): Generator<string, void, unknown>;
-}
-export { GlitchText };

package/lib/objectives/GlitchText.js

@@ -1,50 +0,0 @@
-import { getRandomNumberInRange } from "./getRandomNumberInRange.js";
-class GlitchText {
-    constructor(from = "", to = "hello, world", { step = 15, random = false, maximum = 100 } = {}) {
-        this.from = from;
-        this.to = to;
-        this.step = step;
-        this.random = random;
-        this.maximum = maximum;
-        this[Symbol.iterator] = this.iteratorFunction;
-    }
-    *iteratorFunction() {
-        const word = [...this.from];
-        const target = this.to;
-        const MIN = 20;
-        const MAX = 40;
-        while (word.length !== target.length) {
-            if (word.length > target.length)
-                word.pop();
-            if (word.length < target.length)
-                word.push(String.fromCharCode(~~(Math.random() * 50)));
-            word.forEach((_, index, array) => array[index] = String.fromCharCode(getRandomNumberInRange({ min: MIN, max: MAX })));
-            yield word.join("");
-        }
-        if (this.maximum)
-            for (const index in word) {
-                const charCode = word[index].charCodeAt(0);
-                const targetCode = target[index].charCodeAt(0);
-                if (Math.abs(charCode - targetCode) > this.maximum)
-                    word[index] = String.fromCharCode(charCode > targetCode ?
-                        targetCode + this.maximum :
-                        targetCode - this.maximum);
-            }
-        ;
-        while (word.join("") !== target) {
-            word.forEach((letter, i) => {
-                if (letter === target[i])
-                    return;
-                const charCode = letter.charCodeAt(0), targetCode = target[i].charCodeAt(0);
-                const isUpper = targetCode > charCode;
-                let step = Math.min(Math.abs(targetCode - charCode), this.step);
-                if (this.random)
-                    step *= Math.random() * 2;
-                word[i] = String.fromCharCode(isUpper ? charCode + step : charCode - step);
-            });
-            yield word.join("");
-        }
-        return;
-    }
-}
-export { GlitchText };

package/lib/objectives/getRandomElementFromArray.d.ts

@@ -1,7 +0,0 @@
-interface IParams {
-    needPop?: boolean;
-    associatedWeights?: number[];
-}
-export declare function getRandomElementIndexInWeights(weights: NonNullable<IParams["associatedWeights"]>): number | never;
-export declare function getRandomElementFromArray<T>(array: T[], { needPop, associatedWeights }?: IParams): T;
-export {};

package/lib/objectives/getRandomElementFromArray.js

@@ -1,24 +0,0 @@
-import { getRandomNumberInRange } from "./getRandomNumberInRange.js";
-export function getRandomElementIndexInWeights(weights) {
-    if (weights.length < 1) {
-        new Error("Invalid array length");
-    }
-    let previousLimit = 0;
-    const thresholds = weights.map((weight) => (previousLimit += weight));
-    const lotterySecretNumber = Math.random() * thresholds.at(-1);
-    return thresholds.findIndex((threshold) => threshold >= lotterySecretNumber);
-}
-export function getRandomElementFromArray(array, { needPop, associatedWeights } = {}) {
-    if (associatedWeights && associatedWeights.length !== array.length) {
-        throw new Error("Incorrectly passed argument associatedWeights: The length of the associatedWeights must exactly match the length of the weights array");
-    }
-    const index = associatedWeights
-        ? getRandomElementIndexInWeights(associatedWeights)
-        : getRandomNumberInRange({ max: array.length });
-    const input = array[index];
-    if (needPop) {
-        array.splice(index, 1);
-        associatedWeights === null || associatedWeights === void 0 ? void 0 : associatedWeights.splice(index, 1);
-    }
-    return input;
-}

package/lib/objectives/getRandomNumberInRange.d.ts

@@ -1,7 +0,0 @@
-interface IGetRandomValueOptions {
-    min?: number;
-    max: number;
-    needRound?: boolean;
-}
-declare function getRandomNumberInRange({ min, max, needRound }: IGetRandomValueOptions): number;
-export { getRandomNumberInRange };

package/lib/objectives/getRandomNumberInRange.js

@@ -1,8 +0,0 @@
-function getRandomNumberInRange({ min = 0, max, needRound = true }) {
-    let value = Math.random() * (max - min + Number(needRound)) + min;
-    if (needRound) {
-        value = Math.floor(value);
-    }
-    return value;
-}
-export { getRandomNumberInRange };

package/lib/objectives/getRandomValue.d.ts

@@ -1,7 +0,0 @@
-interface IGetRandomValueOptions {
-    min?: number;
-    max: number;
-    round?: boolean;
-}
-declare function getRandomValue({ min, max, round }: IGetRandomValueOptions): number;
-export { getRandomValue };

package/lib/objectives/getRandomValue.js

@@ -1,8 +0,0 @@
-function getRandomValue({ min = 0, max, round = true }) {
-    let value = Math.random() * (max - min + Number(round)) + min;
-    if (round) {
-        value = Math.floor(value);
-    }
-    return value;
-}
-export { getRandomValue };

package/lib/objectives/mod.d.ts

@@ -1,10 +0,0 @@
-export * from './CustomCollector.js';
-export * from './GlitchText.js';
-export * from './getRandomNumberInRange.js';
-export * from './rangeToArray.js';
-export * from './getRandomElementFromArray.js';
-export * from './DotNotatedInterface.js';
-declare function omit(object: Object, filter: CallableFunction): {
-    [k: string]: any;
-};
-export { omit };

package/lib/objectives/mod.js

@@ -1,12 +0,0 @@
-export * from './CustomCollector.js';
-export * from './GlitchText.js';
-export * from './getRandomNumberInRange.js';
-export * from './rangeToArray.js';
-export * from './getRandomElementFromArray.js';
-export * from './DotNotatedInterface.js';
-function omit(object, filter) {
-    const entries = Object.entries(object)
-        .filter(([key, value], i) => filter(key, value, i));
-    return Object.fromEntries(entries);
-}
-export { omit };

package/lib/objectives/rangeToArray.d.ts

@@ -1 +0,0 @@
-export declare function rangeToArray([min, max]: [number, number]): number | number[];

package/lib/objectives/rangeToArray.js

@@ -1,6 +0,0 @@
-export function rangeToArray([min, max]) {
-    if (isNaN(min) || isNaN(max)) {
-        return NaN;
-    }
-    return [...new Array(max - min + 1)].map((_, index) => index + min);
-}

package/lib/primitives/TextTableBuilder.d.ts

@@ -1,71 +0,0 @@
-interface ITextTableGeneratorContext {
-    content: string;
-    metadata: IContextMetadata;
-    currentRow: number;
-}
-interface IContextMetadata {
-    columns?: {
-        largestLength: number;
-    }[];
-    tableWidth?: number;
-    separatorsIndexesInRow?: number[];
-}
-declare enum CellAlignEnum {
-    Left = 0,
-    Right = 1,
-    Center = 2
-}
-interface ICellOptions {
-    gapLeft: number;
-    gapRight: number;
-    align: CellAlignEnum;
-    removeNextSeparator?: boolean;
-}
-interface ITableCell {
-    value: string;
-    options: ICellOptions;
-}
-type TCellSetSymbolCallback = (context: ITextTableGeneratorContext, index: number) => string;
-interface ICellBuilderOptions {
-    minWidth?: number;
-    maxWidth?: number;
-}
-interface ITableOptions {
-    borderLeft: null | TCellSetSymbolCallback;
-    borderRight: null | TCellSetSymbolCallback;
-    borderTop: null | TCellSetSymbolCallback;
-    borderBottom: null | TCellSetSymbolCallback;
-    separator: string;
-}
-declare enum BorderDirectionEnum {
-    BorderLeft = 0,
-    BorderRight = 1,
-    BorderTop = 2,
-    BorderBottom = 3
-}
-declare enum SpecialRowTypeEnum {
-    Default = 0,
-    Display = 1
-}
-interface ITableSpecialDisplayRow {
-    type: SpecialRowTypeEnum.Display;
-    display: TCellSetSymbolCallback;
-}
-type TTableRow = ITableCell[] | ITableSpecialDisplayRow;
-declare class TextTableBuilder {
-    rows: TTableRow[];
-    protected options: ITableOptions;
-    setBorderOptions(callback?: TCellSetSymbolCallback, directions?: BorderDirectionEnum[]): this;
-    addRowWithElements(elements: ITableCell["value"][], optionsForEveryElement?: Partial<ICellOptions>, useOnAddingOptions?: ICellBuilderOptions): this;
-    addMultilineRowWithElements(elements: ITableCell["value"][], optionsForEveryElement?: Partial<ICellOptions>, useOnAddingOptions?: ICellBuilderOptions): this;
-    addEmptyRow(): this;
-    addRowSeparator(setSymbol?: TCellSetSymbolCallback): this;
-    addCellAtRow(rowIndex: number, cellValue: ITableCell["value"], cellOptions: ICellOptions, useOnAddingOptions: ICellBuilderOptions): this;
-    private pushCellToArray;
-    private pushRowToTable;
-    generateTextContent(): string;
-    addRowWithUnwrappedCells(cells: ITableCell[], useOnAddingOptions?: ICellBuilderOptions): this;
-}
-export { TextTableBuilder };
-export { SpecialRowTypeEnum, CellAlignEnum, BorderDirectionEnum };
-export type { ICellOptions, IContextMetadata, ITableCell, ITableOptions, ITextTableGeneratorContext, TTableRow, };

package/lib/primitives/TextTableBuilder.js

@@ -1,319 +0,0 @@
-function getRowType(row) {
-    if ("type" in row === false) {
-        return SpecialRowTypeEnum.Default;
-    }
-    return row.type;
-}
-function isCell(target) {
-    if (!target) {
-        return false;
-    }
-    return "value" in target && "options" in target;
-}
-function emptyCell() {
-    return {
-        value: "",
-        options: DEFAULT_CELL_OPTIONS,
-    };
-}
-function addPaddingByCellAlign(original, totalForAdd, align) {
-    const addidableGapLeft = align === CellAlignEnum.Right
-        ? totalForAdd
-        : align === CellAlignEnum.Center
-            ? Math.floor(totalForAdd / 2)
-            : 0;
-    const addidableGapRight = align === CellAlignEnum.Left
-        ? totalForAdd
-        : align === CellAlignEnum.Center
-            ? Math.ceil(totalForAdd / 2)
-            : 0;
-    return `${" ".repeat(addidableGapLeft)}${original}${" ".repeat(addidableGapRight)}`;
-}
-function changeContentSetCellMinWidth(cell, minWidth) {
-    const currentMin = calculateCellMinWidth(cell);
-    if (minWidth <= currentMin) {
-        return cell;
-    }
-    const { value, options: { align }, } = cell;
-    const lack = minWidth - currentMin;
-    cell.value = addPaddingByCellAlign(value, lack, align);
-    return cell;
-}
-function changeContentSetCellMaxWidth(cell, maxWidth) {
-    const current = calculateCellMinWidth(cell);
-    if (maxWidth >= current) {
-        return cell;
-    }
-    let overage = current - maxWidth;
-    const gapDirection = cell.options.align === CellAlignEnum.Left ? "gapRight" : "gapLeft";
-    if (cell.options[gapDirection] > 1) {
-        cell.options[gapDirection]--;
-        overage--;
-        if (overage === 0) {
-            return;
-        }
-    }
-    const suffix = "..";
-    const sliced = cell.value.slice(0, -(overage + suffix.length));
-    cell.value = sliced + suffix;
-    return cell;
-}
-function calculateCellMinWidth(cell) {
-    const { gapLeft, gapRight } = cell.options;
-    return cell.value.length + gapLeft + gapRight;
-}
-class TextTableGenerator {
-    constructor(rows, options) {
-        this.data = [];
-        this.context = {
-            content: "",
-            metadata: {},
-            currentRow: 0,
-        };
-        this.data = rows;
-        this.options = options;
-        this.parseMetadata();
-    }
-    generateTextContent() {
-        const context = this.context;
-        if (this.options.borderTop !== null) {
-            context.content += this.drawBlockBorder(BorderDirectionEnum.BorderTop);
-            context.content += "\n";
-        }
-        for (const row of this.data) {
-            context.currentRow = this.data.indexOf(row);
-            context.content += this.drawRow(row);
-            context.content += "\n";
-        }
-        if (this.options.borderBottom !== null) {
-            context.content += this.drawBlockBorder(BorderDirectionEnum.BorderBottom);
-        }
-        return context.content;
-    }
-    getColumns() {
-        const columns = [];
-        const rows = this.data;
-        const largestCellsCount = Math.max(...rows
-            .filter((row) => getRowType(row) === SpecialRowTypeEnum.Default)
-            .map((row) => row.length));
-        for (let index = 0; index < largestCellsCount; index++) {
-            const column = rows.map((row) => {
-                var _a;
-                return getRowType(row) === SpecialRowTypeEnum.Default
-                    ? (_a = row.at(index)) !== null && _a !== void 0 ? _a : null
-                    : { row };
-            });
-            columns.push(column);
-        }
-        return columns;
-    }
-    parseMetadata() {
-        const metadata = this.context.metadata;
-        const columns = this.getColumns();
-        const columnsMetadata = columns.map((column) => ({
-            largestLength: Math.max(...column.map((element) => isCell(element) ? calculateCellMinWidth(element) : 0)),
-        }));
-        metadata.columns = columnsMetadata;
-        metadata.tableWidth = this.calculateTableWidth();
-        metadata.separatorsIndexesInRow = (() => {
-            const indexes = [];
-            let current = 0;
-            if (!!this.options.borderLeft) {
-                indexes.push(current);
-            }
-            for (const { largestLength } of columnsMetadata) {
-                current += largestLength + 1;
-                indexes.push(current);
-            }
-            if (!this.options.borderRight) {
-                indexes.pop();
-            }
-            return indexes;
-        })();
-    }
-    drawRow(row) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        let content = "";
-        const context = this.context;
-        const { columns } = context.metadata;
-        const columnsCount = columns.length;
-        if (getRowType(row) === SpecialRowTypeEnum.Default) {
-            row = row;
-            content += (_c = (_b = (_a = this.options).borderLeft) === null || _b === void 0 ? void 0 : _b.call(_a, context, context.currentRow)) !== null && _c !== void 0 ? _c : "";
-            for (let cellIndex = 0; cellIndex < columnsCount; cellIndex++) {
-                const cell = (_d = row.at(+cellIndex)) !== null && _d !== void 0 ? _d : emptyCell();
-                const expectedWidth = columns.at(+cellIndex).largestLength;
-                content += this.drawCell(cell, expectedWidth);
-                if (+cellIndex !== columnsCount - 1) {
-                    content += !cell.options.removeNextSeparator
-                        ? this.options.separator
-                        : " ";
-                }
-            }
-            content += (_g = (_f = (_e = this.options).borderRight) === null || _f === void 0 ? void 0 : _f.call(_e, context, context.currentRow)) !== null && _g !== void 0 ? _g : "";
-            return content;
-        }
-        if (getRowType(row) === SpecialRowTypeEnum.Display) {
-            row = row;
-            content += this.drawLine(row.display);
-        }
-        return content;
-    }
-    drawCell(cell, expectedWidth) {
-        const { gapLeft, gapRight, align } = cell.options;
-        const { value } = cell;
-        const minContentLength = calculateCellMinWidth(cell);
-        const lack = expectedWidth - minContentLength;
-        const contentWithPadding = addPaddingByCellAlign(value, lack, align);
-        return `${" ".repeat(gapLeft)}${contentWithPadding}${" ".repeat(gapRight)}`;
-    }
-    drawLine(setSymbol) {
-        let content = "";
-        const context = this.context;
-        const length = this.calculateTableWidth();
-        for (const index of [...new Array(length)].map((_, index) => index)) {
-            const symbol = setSymbol(context, +index);
-            content += symbol;
-        }
-        return content;
-    }
-    drawBlockBorder(borderDirection) {
-        const callback = borderDirection === BorderDirectionEnum.BorderTop
-            ? this.options.borderTop
-            : this.options.borderBottom;
-        return this.drawLine(callback);
-    }
-    calculateTableWidth() {
-        const { columns } = this.context.metadata;
-        if (!columns) {
-            throw new Error("No columns field; Tip: Use <this>.parseMetadata() previous");
-        }
-        const cells = columns.reduce((acc, current) => current.largestLength + acc, 0);
-        const separators = columns.length - 1;
-        const borders = +!!this.options.borderLeft + +!!this.options.borderRight;
-        return cells + separators + borders;
-    }
-}
-var CellAlignEnum;
-(function (CellAlignEnum) {
-    CellAlignEnum[CellAlignEnum["Left"] = 0] = "Left";
-    CellAlignEnum[CellAlignEnum["Right"] = 1] = "Right";
-    CellAlignEnum[CellAlignEnum["Center"] = 2] = "Center";
-})(CellAlignEnum || (CellAlignEnum = {}));
-const DEFAULT_CELL_OPTIONS = {
-    gapLeft: 2,
-    gapRight: 2,
-    align: CellAlignEnum.Left,
-};
-var BorderDirectionEnum;
-(function (BorderDirectionEnum) {
-    BorderDirectionEnum[BorderDirectionEnum["BorderLeft"] = 0] = "BorderLeft";
-    BorderDirectionEnum[BorderDirectionEnum["BorderRight"] = 1] = "BorderRight";
-    BorderDirectionEnum[BorderDirectionEnum["BorderTop"] = 2] = "BorderTop";
-    BorderDirectionEnum[BorderDirectionEnum["BorderBottom"] = 3] = "BorderBottom";
-})(BorderDirectionEnum || (BorderDirectionEnum = {}));
-const DEFAULT_TABLE_OPTIONS = {
-    borderLeft: null,
-    borderRight: null,
-    borderTop: null,
-    borderBottom: null,
-    separator: "|",
-};
-var SpecialRowTypeEnum;
-(function (SpecialRowTypeEnum) {
-    SpecialRowTypeEnum[SpecialRowTypeEnum["Default"] = 0] = "Default";
-    SpecialRowTypeEnum[SpecialRowTypeEnum["Display"] = 1] = "Display";
-})(SpecialRowTypeEnum || (SpecialRowTypeEnum = {}));
-class TextTableBuilder {
-    constructor() {
-        this.rows = [];
-        this.options = Object.assign({}, DEFAULT_TABLE_OPTIONS);
-    }
-    setBorderOptions(callback = () => "|", directions = [
-        BorderDirectionEnum.BorderLeft,
-        BorderDirectionEnum.BorderRight,
-    ]) {
-        for (const direction of directions) {
-            switch (direction) {
-                case BorderDirectionEnum.BorderLeft:
-                    this.options.borderLeft = callback;
-                    break;
-                case BorderDirectionEnum.BorderRight:
-                    this.options.borderRight = callback;
-                    break;
-                case BorderDirectionEnum.BorderTop:
-                    this.options.borderTop = callback;
-                    break;
-                case BorderDirectionEnum.BorderBottom:
-                    this.options.borderBottom = callback;
-                    break;
-            }
-        }
-        return this;
-    }
-    addRowWithElements(elements, optionsForEveryElement, useOnAddingOptions) {
-        const row = [];
-        for (const value of elements) {
-            this.pushCellToArray(row, value, optionsForEveryElement, useOnAddingOptions);
-        }
-        this.pushRowToTable(row);
-        return this;
-    }
-    addMultilineRowWithElements(elements, optionsForEveryElement, useOnAddingOptions) {
-        const separatedElements = elements.map((value) => value.split("\n"));
-        const largestHeight = Math.max(...separatedElements.map((sub) => sub.length));
-        for (let index = 0; index < largestHeight; index++) {
-            this.addRowWithElements(separatedElements.map((sub) => { var _a; return (_a = sub.at(index)) !== null && _a !== void 0 ? _a : ""; }), optionsForEveryElement, useOnAddingOptions);
-        }
-        return this;
-    }
-    addEmptyRow() {
-        this.pushRowToTable([]);
-        return this;
-    }
-    addRowSeparator(setSymbol = () => "-") {
-        const row = {
-            display: setSymbol,
-            type: SpecialRowTypeEnum.Display,
-        };
-        this.pushRowToTable(row);
-        return this;
-    }
-    addCellAtRow(rowIndex, cellValue, cellOptions, useOnAddingOptions) {
-        const row = this.rows.at(rowIndex);
-        if (!row) {
-            throw new RangeError();
-        }
-        if (getRowType(row) !== SpecialRowTypeEnum.Default) {
-            throw new Error("Is not default row: without cells");
-        }
-        this.pushCellToArray(row, cellValue, cellOptions, useOnAddingOptions);
-        return this;
-    }
-    pushCellToArray(array, cellValue, cellOptions = {}, pushOptions) {
-        const options = Object.assign({}, DEFAULT_CELL_OPTIONS, cellOptions);
-        const cell = { value: cellValue, options };
-        const { minWidth, maxWidth } = pushOptions !== null && pushOptions !== void 0 ? pushOptions : {};
-        minWidth && changeContentSetCellMinWidth(cell, minWidth);
-        maxWidth && changeContentSetCellMaxWidth(cell, maxWidth);
-        array.push(cell);
-        return this;
-    }
-    pushRowToTable(row) {
-        this.rows.push(row);
-        return this;
-    }
-    generateTextContent() {
-        return new TextTableGenerator(this.rows, this.options).generateTextContent();
-    }
-    addRowWithUnwrappedCells(cells, useOnAddingOptions) {
-        const row = [];
-        for (const cell of cells) {
-            this.pushCellToArray(row, cell.value, cell.options, useOnAddingOptions);
-        }
-        this.pushRowToTable(row);
-        return this;
-    }
-}
-export { TextTableBuilder };
-export { SpecialRowTypeEnum, CellAlignEnum, BorderDirectionEnum };

package/lib/primitives/mod.d.ts

@@ -1,6 +0,0 @@
-export * from './TextTableBuilder.js';
-interface IEndingOptions {
-    unite?: (quantity: number, word: string) => string;
-}
-declare function ending(quantity: number | undefined, base: string, multiple: string, alone: string, double: string, options?: IEndingOptions): string | number;
-export { ending };

package/lib/primitives/mod.js

@@ -1,12 +0,0 @@
-export * from './TextTableBuilder.js';
-function ending(quantity = 0, base, multiple, alone, double, options = {}) {
-    if (isNaN(quantity))
-        return NaN;
-    const target = quantity % 100 < 20 ? quantity % 20 : quantity % 10;
-    const end = target >= 5 || target === 0 ? multiple : target > 1 ? double : alone;
-    const word = base + end;
-    options.unite || (options.unite = (quantity, word) => `${quantity} ${word}`);
-    const input = options.unite(quantity, word);
-    return input;
-}
-export { ending };