@zoodogood/utils 6.0.0-change.4442 → 7.0.0-change.4513

package/lib/objectives/GlitchText.js

@@ -1,4 +1,4 @@
-import { getRandomNumberInRange } from "./getRandomNumberInRange.js";
+import { randomNumberInRange } from "./randomNumberInRange.js";
 class GlitchText {
     constructor(from = "", to = "hello, world", { step = 15, random = false, maximum = 100 } = {}) {
         this.from = from;
@@ -18,7 +18,7 @@ class GlitchText {
                 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 })));
+            word.forEach((_, index, array) => array[index] = String.fromCharCode(randomNumberInRange({ min: MIN, max: MAX })));
             yield word.join("");
         }
         if (this.maximum)

package/lib/objectives/mod.d.ts

@@ -2,10 +2,10 @@ export * from "./BusyNumeric.js";
 export * from "./CustomCollector.js";
 export * from "./DotNotatedInterface.js";
 export * from "./ExtendedEnum/mod.js";
-export * from "./getRandomElementFromArray.js";
-export * from "./getRandomNumberInRange.js";
 export * from "./GlitchText.js";
 export * from "./LazySort/LazySort.build.js";
+export * from "./randomElementFromArray.js";
+export * from "./randomNumberInRange.js";
 export * from "./rangeToArray.js";
 declare function omit(object: object, filter: CallableFunction): {
     [k: string]: any;

package/lib/objectives/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/objectives/mod.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAElC,iBAAS,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB;;EAMrD;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/objectives/mod.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAElC,iBAAS,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB;;EAMrD;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/lib/objectives/mod.js

@@ -2,10 +2,10 @@ export * from "./BusyNumeric.js";
 export * from "./CustomCollector.js";
 export * from "./DotNotatedInterface.js";
 export * from "./ExtendedEnum/mod.js";
-export * from "./getRandomElementFromArray.js";
-export * from "./getRandomNumberInRange.js";
 export * from "./GlitchText.js";
 export * from "./LazySort/LazySort.build.js";
+export * from "./randomElementFromArray.js";
+export * from "./randomNumberInRange.js";
 export * from "./rangeToArray.js";
 function omit(object, filter) {
     const entries = Object.entries(object).filter(([key, value], i) => filter(key, value, i));

package/lib/objectives/randomElementFromArray.d.ts

@@ -0,0 +1,37 @@
+import { BusyNumeric } from "./BusyNumeric.js";
+export declare const _WEIGHT_AUTO = 1000001;
+interface IParams<T> {
+    associatedWeights?: number[] | typeof _WEIGHT_AUTO;
+    filter?: (item: T) => boolean;
+}
+interface IPickContext<T> {
+    item: T;
+    pick: (context: IPickContext<T>) => boolean;
+    threshold: number;
+    point: number;
+    index_of_item: number;
+}
+interface ILotteryContext {
+    index_of_item: number;
+    point: number;
+    remove_current_from_pull(): void;
+}
+export declare class RandomizerContext<T> {
+    hotel: BusyNumeric;
+    array: T[];
+    thresholds?: number[];
+    constructor(array: T[], thresholds?: number[]);
+    static from<T>({ array, associatedWeights, }: {
+        array: T[];
+        associatedWeights?: number[];
+    }): RandomizerContext<T>;
+    pickRandom(pick?: IPickContext<T>["pick"]): T | undefined;
+    playLottery(): ILotteryContext | undefined;
+}
+export declare function pickInThresholds(thresholds: number[], value: number): number;
+export declare function thresholdsOf(weights: NonNullable<number[]>): number[];
+export declare function randomElementIndexInWeights(weights: NonNullable<number[]>): number | never;
+export declare function randomElementFromArray<T>(array: T[], { associatedWeights, filter }?: IParams<T>): T | undefined;
+export declare function randomElementsFromArray<T>(array: T[], amount?: number, { associatedWeights, filter }?: IParams<T>): T[];
+export {};
+//# sourceMappingURL=randomElementFromArray.d.ts.map

package/lib/objectives/randomElementFromArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomElementFromArray.d.ts","sourceRoot":"","sources":["../../src/objectives/randomElementFromArray.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAC;AAG7D,eAAO,MAAM,YAAY,UAAY,CAAC;AACtC,UAAU,OAAO,CAAC,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,YAAY,CAAC;IACnD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;CAC9B;AAED,UAAU,YAAY,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,eAAe;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB,IAAI,IAAI,CAAC;CACjC;AAED,qBAAa,iBAAiB,CAAC,CAAC;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;gBACV,KAAK,EAAE,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE;IAc7C,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,EACd,KAAK,EACL,iBAAiB,GACjB,EAAE;QACF,KAAK,EAAE,CAAC,EAAE,CAAC;QACX,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC7B;IAID,UAAU,CAAC,IAAI,GAAE,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAc,GAAG,CAAC,GAAG,SAAS;IAsDrE,WAAW,IAAI,eAAe,GAAG,SAAS;CAiD1C;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAY5E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,GAGG,MAAM,EAAE,CACrE;AAED,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,GAC5B,MAAM,GAAG,KAAK,CAKhB;AAkBD,wBAAgB,sBAAsB,CAAC,CAAC,EACvC,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,iBAAiB,EAAE,MAAmB,EAAE,GAAE,OAAO,CAAC,CAAC,CAAM,iBA8B3D;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EACxC,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,SAAI,EACV,EAAE,iBAAiB,EAAE,MAAmB,EAAE,GAAE,OAAO,CAAC,CAAC,CAAM,OAiD3D"}

package/lib/objectives/randomElementFromArray.js

@@ -0,0 +1,219 @@
+import assert from "node:assert";
+import { binary_search } from "../primitives/binary_search.js";
+import { BusyNumeric, size_of_area } from "./BusyNumeric.js";
+import { randomNumberInRange } from "./randomNumberInRange.js";
+export const _WEIGHT_AUTO = 1_000_001;
+export class RandomizerContext {
+    hotel;
+    array;
+    thresholds;
+    constructor(array, thresholds) {
+        this.array = array;
+        this.thresholds = thresholds;
+        const range = thresholds?.at(-1) ?? array.length - 1;
+        this.hotel = new BusyNumeric(range);
+    }
+    /* Add to your code
+    if (associatedWeights === AUTO) {
+            // @ts-expect-error User known about AUTO keyword
+            associatedWeights = array.map(($) => $._weight);
+    }
+    associatedWeights?.length && assert(associatedWeights.at(-1)! < Number.MAX_SAFE_INTEGER)
+    */
+    static from({ array, associatedWeights, }) {
+        const thresholds = associatedWeights && thresholdsOf(associatedWeights);
+        return new RandomizerContext(array, thresholds);
+    }
+    pickRandom(pick = () => true) {
+        const { hotel, thresholds, array } = this;
+        while (true) {
+            const segments_count = hotel.segments_count();
+            if (!segments_count) {
+                break;
+            }
+            const target_of_free = randomNumberInRange({
+                max: hotel.free_area - 1,
+            });
+            const position = (() => {
+                let segment = 0;
+                let distance = target_of_free;
+                let position = 0;
+                while (true) {
+                    const free_area = (hotel.busy_areas[segment]?.[0] ?? hotel.range + 1) -
+                        (hotel.busy_areas[segment - 1]?.[1] ?? -1) -
+                        1;
+                    distance -= free_area;
+                    position += free_area;
+                    if (distance < 0) {
+                        return position + distance;
+                    }
+                    position += size_of_area(hotel.busy_areas[segment] || [0, hotel.range + 1]);
+                    segment++;
+                }
+            })();
+            const index = thresholds
+                ? pickInThresholds(thresholds, position)
+                : position;
+            const element = array[index];
+            const pickContext = {
+                item: element,
+                index_of_item: index,
+                pick,
+                threshold: index,
+                point: position,
+            };
+            const picked = pick(pickContext);
+            if (picked) {
+                return element;
+            }
+            thresholds
+                ? hotel.insert_area(thresholds[index - 1] + 1 || 0, thresholds[index])
+                : hotel.bifurcate(index);
+        }
+        return undefined;
+    }
+    playLottery() {
+        const { hotel, thresholds } = this;
+        while (true) {
+            const segments_count = hotel.segments_count();
+            if (!segments_count) {
+                break;
+            }
+            const target_of_free = randomNumberInRange({
+                max: hotel.free_area - 1,
+            });
+            const position = (() => {
+                let segment = 0;
+                let distance = target_of_free;
+                let position = 0;
+                while (true) {
+                    const free_area = (hotel.busy_areas[segment]?.[0] ?? hotel.range + 1) -
+                        (hotel.busy_areas[segment - 1]?.[1] ?? -1) -
+                        1;
+                    distance -= free_area;
+                    position += free_area;
+                    if (distance < 0) {
+                        return position + distance;
+                    }
+                    position += size_of_area(hotel.busy_areas[segment] || [0, hotel.range + 1]);
+                    segment++;
+                }
+            })();
+            const index = thresholds
+                ? pickInThresholds(thresholds, position)
+                : position;
+            const lotteryContext = {
+                index_of_item: index,
+                point: position,
+                remove_current_from_pull() {
+                    thresholds
+                        ? hotel.insert_area(thresholds[index - 1] + 1 || 0, thresholds[index])
+                        : hotel.bifurcate(index);
+                },
+            };
+            return lotteryContext;
+        }
+    }
+}
+export function pickInThresholds(thresholds, value) {
+    assert(thresholds.length > 0);
+    return binary_search(thresholds.length - 1, (index) => {
+        const hold = thresholds[index];
+        if (hold >= value && (thresholds[index - 1] ?? -1) < value) {
+            return 0;
+        }
+        if (hold < value) {
+            return -1;
+        }
+        return 1;
+    });
+}
+export function thresholdsOf(weights) {
+    assert(weights.length > 0, "Invalid array length");
+    let previousLimit = 0;
+    return weights.map((weight) => (previousLimit += weight));
+}
+export function randomElementIndexInWeights(weights) {
+    const thresholds = thresholdsOf(weights);
+    const lotteryPick = Math.random() * thresholds.at(-1);
+    return pickInThresholds(thresholds, lotteryPick);
+}
+// task: честный алгоритм , для которого каждый из элеметов списка имеет равный шанс на реализацию своей вероятности.
+// Обычно весь список фильтруется и после выбирается элемент. В нашем случае фильтр будет срабатывать только для тех элементов,
+// которые на этапе фильтрации «выбраны» — то есть имеют свою стопроцентную вероятность быть окончательными после успешного прохождения фильтра
+// требования: честная вероятность; итоговая производительность должна быть выше обычной при проходе списка фильтром
+// Алгоритм:
+/*
+  Оптимальный алгоритм поиска случайного элемента списка, удовлетворяющего условию. Поддерживается возможность задавать элементам коэффициент вероятности
+
+  Перед выбором элемента выбираем случайный сегмент, далее случайный элемент в этом сегменте
+
+  Если соответствует условию, возвращаем элемент. Завершаем поиск
+
+  Иначе исключаем элемент путем раздвоения текущего сегмента так, чтобы элемент не оказался ни в одном сегменте списка
+
+  Повторяем
+  */
+export function randomElementFromArray(array, { associatedWeights, filter = () => true } = {}) {
+    assert(array.length, "Invalid array length");
+    if (associatedWeights === _WEIGHT_AUTO) {
+        // @ts-expect-error User know about AUTO keysymbol
+        associatedWeights = array.map(($) => $._weight);
+    }
+    associatedWeights?.length &&
+        assert(associatedWeights.at(-1) < Number.MAX_SAFE_INTEGER);
+    assert(!associatedWeights || associatedWeights.length === array.length, "Incorrectly passed argument associatedWeights: The length of the associatedWeights must exactly match the length of the weights array");
+    if (array.length === 1) {
+        return array[0];
+    }
+    // light strategy
+    if (!filter) {
+        if (associatedWeights) {
+            return array[randomElementIndexInWeights(associatedWeights)];
+        }
+        return array[Math.floor(Math.random() * array.length)];
+    }
+    return RandomizerContext.from({
+        array,
+        associatedWeights,
+    }).pickRandom(({ item }) => filter(item));
+}
+export function randomElementsFromArray(array, amount = 1, { associatedWeights, filter = () => true } = {}) {
+    assert(array.length);
+    assert(amount <= array.length);
+    assert(amount > 1, `Current amount: ${amount}, use randomElementFromArray instead of randomElement**s**FromArray if amount is 1`);
+    if (associatedWeights === _WEIGHT_AUTO) {
+        // @ts-expect-error User know about AUTO keysymbol
+        associatedWeights = array.map(($) => $._weight);
+    }
+    associatedWeights?.length &&
+        assert(associatedWeights.at(-1) < Number.MAX_SAFE_INTEGER);
+    assert(!associatedWeights || associatedWeights.length === array.length, "Incorrectly passed argument associatedWeights: The length of the associatedWeights must exactly match the length of the weights array");
+    if (amount === array.length) {
+        return Array.from(array);
+    }
+    // light strategy
+    if (!filter && !associatedWeights) {
+        const _array = Array.from(array);
+        return Array.from({ length: amount }, () => _array.splice(Math.floor(Math.random() * _array.length), 1)[0]);
+    }
+    const random_ctx = RandomizerContext.from({
+        array,
+        associatedWeights,
+    });
+    return Array.from({ length: amount }, (_, i) => {
+        while (true) {
+            const lottery_ctx = random_ctx.playLottery();
+            if (!lottery_ctx) {
+                // BEFORE PULL TO-DO вероятно неграммотное сообщение об ошибке
+                throw new Error("Not enought items was pass filter");
+            }
+            lottery_ctx.remove_current_from_pull();
+            const item = array[lottery_ctx.index_of_item];
+            if (!filter(item)) {
+                continue;
+            }
+            return item;
+        }
+    });
+}

package/lib/objectives/randomNumberInRange.d.ts

@@ -0,0 +1,8 @@
+interface IGetRandomValueOptions {
+    min?: number;
+    max: number;
+    needRound?: boolean;
+}
+declare function randomNumberInRange({ min, max, needRound, }: IGetRandomValueOptions): number;
+export { randomNumberInRange };
+//# sourceMappingURL=randomNumberInRange.d.ts.map

package/lib/objectives/randomNumberInRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"randomNumberInRange.d.ts","sourceRoot":"","sources":["../../src/objectives/randomNumberInRange.ts"],"names":[],"mappings":"AAAA,UAAU,sBAAsB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,iBAAS,mBAAmB,CAAC,EAC5B,GAAO,EACP,GAAG,EACH,SAAgB,GAChB,EAAE,sBAAsB,UAOxB;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/lib/objectives/randomNumberInRange.js

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

package/lib/primitives/mod.d.ts

@@ -3,12 +3,9 @@ export * from "./BracketsParser.js";
 export { CliParser } from "./CliParser.js";
 export * from "./createDefaultPreventable.js";
 export * from "./normalize.js";
+export * from './pluralization/index.js';
 export * from "./symbols.js";
 export * from "./TextTableBuilder.js";
-interface IEndingOptions {
-    unite?: (quantity: number, word: string) => string;
-}
-export declare function ending(quantity: number, base: string, multiple: string, alone: string, double: string, options?: IEndingOptions): string | number;
 export declare function sortMutByResolve<T>(array: T[], resolve: ($: T) => number, { reverse }?: {
     reverse?: boolean;
 }): T[];

package/lib/primitives/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/primitives/mod.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AAEtC,UAAU,cAAc;IACvB,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AACD,wBAAgB,MAAM,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,mBAgB5B;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EACzB,EAAE,OAAO,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,OAKvC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAG5C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,CAAC,WAO9D"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/primitives/mod.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AAGtC,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EACzB,EAAE,OAAO,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,OAKvC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAG5C;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,CAAC,WAO9D"}

package/lib/primitives/mod.js

@@ -3,19 +3,9 @@ export * from "./BracketsParser.js";
 export { CliParser } from "./CliParser.js";
 export * from "./createDefaultPreventable.js";
 export * from "./normalize.js";
+export * from './pluralization/index.js';
 export * from "./symbols.js";
 export * from "./TextTableBuilder.js";
-export function ending(quantity, base, multiple, alone, double, options = {}) {
-    if (Number.isNaN(+quantity)) {
-        return Number.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 ||= (quantity, word) => `${quantity} ${word}`;
-    const input = options.unite(quantity, word);
-    return input;
-}
 export function sortMutByResolve(array, resolve, { reverse } = {}) {
     return reverse
         ? array.sort((a, b) => resolve(a) - resolve(b))

package/lib/primitives/pluralization/index.d.ts

@@ -0,0 +1,13 @@
+interface IEndingOptions {
+    unite?: (quantity: number, word: string) => string;
+}
+export declare function ending(quantity: number, base: string, multiple: string, alone: string, double: string, options?: IEndingOptions): string | number;
+export declare enum GrammaticGender {
+    He = 0,
+    She = 1,
+    It = 2
+}
+export declare function pluralization_of_numeric(quantity: number, grammatic_gender: GrammaticGender, pattern: string[]): string | number;
+export declare function pluralize_numeric_form(quantity: number, grammatic_gender: GrammaticGender): string;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/primitives/pluralization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/primitives/pluralization/index.ts"],"names":[],"mappings":"AACA,UAAU,cAAc;IACvB,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AACD,wBAAgB,MAAM,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,cAAmB,mBAqB5B;AAGD,oBAAY,eAAe;IAC1B,EAAE,IAAI;IACN,GAAG,IAAI;IACP,EAAE,IAAI;CACN;AACD,wBAAgB,wBAAwB,CACvC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,eAAe,EACjC,OAAO,EAAE,MAAM,EAAE,mBASjB;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,eAAe,GAC/B,MAAM,CA0FR"}

package/lib/primitives/pluralization/index.js

@@ -0,0 +1,107 @@
+export function ending(quantity, base, multiple, alone, double, options = {}) {
+    if (Number.isNaN(+quantity)) {
+        return Number.NaN;
+    }
+    // Закономерность чисел 10-20, 110-120...
+    const _clean_quantity = quantity % 100 < 20 ? quantity % 20 : quantity % 10;
+    const end = _clean_quantity >= 5 || _clean_quantity === 0
+        ? multiple
+        : _clean_quantity > 1
+            ? double
+            : alone;
+    const word = base + end;
+    options.unite ||= (quantity, word) => `${quantity} ${word}`;
+    const input = options.unite(quantity, word);
+    return input;
+}
+// MARK: Plularization
+export var GrammaticGender;
+(function (GrammaticGender) {
+    GrammaticGender[GrammaticGender["He"] = 0] = "He";
+    GrammaticGender[GrammaticGender["She"] = 1] = "She";
+    GrammaticGender[GrammaticGender["It"] = 2] = "It";
+})(GrammaticGender || (GrammaticGender = {}));
+export function pluralization_of_numeric(quantity, grammatic_gender, pattern) {
+    return ending(Math.abs(quantity), "", pattern[0], pattern[1], pattern[2], {
+        unite: (_, word) => word.replace("{}", pluralize_numeric_form(quantity, grammatic_gender)),
+    });
+}
+export function pluralize_numeric_form(quantity, grammatic_gender) {
+    if (quantity === 0) {
+        return "ноль";
+    }
+    let _result = "";
+    if (quantity < 0) {
+        quantity = -quantity;
+        _result += "минус ";
+    }
+    if (quantity >= 1_000_000)
+        return String(quantity);
+    if (quantity >= 1_000) {
+        const x = Math.floor(quantity / 1_000);
+        _result += ending(x, "тысяч", "", "а", "и", {
+            unite: (_, word) => `${count_of_bit(x, GrammaticGender.She)} ${word} `,
+        });
+        quantity -= x * 1_000;
+    }
+    if (quantity >= 1) {
+        _result += `${count_of_bit(quantity, grammatic_gender)} `;
+    }
+    return _result.trimEnd();
+    function count_of_bit(value, grammatic_gender) {
+        let _result = "";
+        if (value >= 100) {
+            const x = Math.floor(value / 100);
+            _result += `${[
+                "сто",
+                "двести",
+                "триста",
+                "четыреста",
+                "пятьсот",
+                "шестьсот",
+                "семьсот",
+                "восемьсот",
+                "девятьсот",
+            ][x - 1]} `;
+            value -= x * 100;
+        }
+        if (value >= 20) {
+            const x = Math.floor(value / 10);
+            _result += `${[
+                "двадцать",
+                "тридцать",
+                "сорок",
+                "пятьдесят",
+                "шестдесят",
+                "семдесят",
+                "восемьдесят",
+                "девяносто",
+            ][x - 2]} `;
+            value -= x * 10;
+        }
+        if (value >= 1) {
+            _result += [
+                ["один", "одна", "одно"][grammatic_gender],
+                ["два", "две", "два"][grammatic_gender],
+                "три",
+                "четыре",
+                "пять",
+                "шесть",
+                "семь",
+                "восемь",
+                "девять",
+                "десять",
+                "одинадцать",
+                "двенадцать",
+                "тринадцать",
+                "четырнадцать",
+                "пятьнадцать",
+                "шестнадцать",
+                "семнадцать",
+                "восемнадцать",
+                "девятнадцать",
+            ][value - 1];
+        }
+        return _result.trimEnd();
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zoodogood/utils",
   "type": "module",
-  "version": "6.0.0-change.4442",
+  "version": "7.0.0-change.4513",
   "description": "",
   "main": "lib/index.js",
   "homepage": "https://zoodogood.github.io/utils",