danholibraryjs 2.0.0 → 2.0.2

package/README.md

@@ -24,6 +24,6 @@ import { ... } from 'DanhoLibraryJS';
 
 * [Classes](/docs/Classes.md)
 * [Extensions](/docs/Extensions.md)
-* [Functions](/docs/Functions.md)
 * [Interfaces](/docs/Interfaces.md)
 * [Types](/docs/Types.md)
+* [Utils](/docs/Utils.md)

package/_package.github-release.json

@@ -0,0 +1,6 @@
+{
+  "name": "@danielsimonsen90/danholibraryjs",
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com/"
+  }
+}

package/_package.npm-release.json

@@ -0,0 +1,6 @@
+{
+  "name": "danholibraryjs",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/dist/Extensions/Array/index.d.ts

@@ -1,20 +1,6 @@
-import * as CRUD from './crud.extension';
-export declare const ArrayExtensions: {
-    join<T>(this: T[], separator?: string, endSeparator?: string): string;
-    orderBy<T_1>(this: T_1[], ...comparators: ((a: T_1, b: T_1) => number)[]): T_1[];
-    orderByDescending<T_2>(this: T_2[], ...comparators: ((a: T_2, b: T_2) => number)[]): T_2[];
-    sortByProperty<T_3 extends object>(this: T_3[], ...properties: (keyof T_3)[]): T_3[];
-    random<T_4>(this: T_4[]): T_4;
-    shuffle<T_5>(this: T_5[]): T_5[];
-    randomWithPercentages<T_6>(items: [item: T_6, weight: number][]): T_6;
-    nth<T_7, U>(this: T_7[], every: number, callback: (item: T_7, index: number, collection: T_7[], self: T_7[]) => U): U[];
-    add<T_8>(this: T_8[], ...items: T_8[]): T_8[];
-    update<T_9>(this: T_9[], old: number | T_9 | CRUD.UpdateFinder<T_9>, updated: T_9): T_9;
-    remove<T_10>(this: T_10[], value: number | T_10): T_10[];
-    take<T_11>(this: T_11[], count: number): T_11[];
-    forceArray<T_12>(arrayable: import("../..").Arrayable<T_12>): T_12[];
-    unique<T_13>(this: T_13[]): T_13[];
-    splitBy<T_14>(this: T_14[], chunkSize: number): T_14[][];
-    splitBy<T_15>(this: T_15[], splitter: (value: T_15, index: number, array: T_15[]) => boolean): T_15[][];
-    groupBy<T_16, K>(this: T_16[], keySelector: (value: T_16, index: number, array: T_16[]) => K): Map<K, T_16[]>;
-};
+export * from './array.extension';
+export * from './crud.extension';
+export * from './loop.extension';
+export * from './random.extension';
+export * from './sort.extension';
+export * from './string.extension';

package/dist/Extensions/Array/index.js

@@ -10,31 +10,13 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArrayExtensions = void 0;
-const Array = __importStar(require("./array.extension"));
-const CRUD = __importStar(require("./crud.extension"));
-const Loop = __importStar(require("./loop.extension"));
-const Random = __importStar(require("./random.extension"));
-const Sort = __importStar(require("./sort.extension"));
-const String = __importStar(require("./string.extension"));
-exports.ArrayExtensions = {
-    ...Array,
-    ...CRUD,
-    ...Loop,
-    ...Random,
-    ...Sort,
-    ...String,
-};
+__exportStar(require("./array.extension"), exports);
+__exportStar(require("./crud.extension"), exports);
+__exportStar(require("./loop.extension"), exports);
+__exportStar(require("./random.extension"), exports);
+__exportStar(require("./sort.extension"), exports);
+__exportStar(require("./string.extension"), exports);

package/dist/Extensions/Array/random.extension.d.ts

@@ -15,9 +15,8 @@ declare global {
          * @param items An array of tuples where each tuple contains an item and its corresponding weight.
          * @returns A randomly selected item based on the provided weights.
          */
-        randomWithPercentages(items: [item: T, weight: number][]): T;
+        randomWithPercentages(items: Array<[item: T, weight: number]>): T;
     }
 }
 export declare function random<T>(this: Array<T>): T;
 export declare function shuffle<T>(this: Array<T>): Array<T>;
-export declare function randomWithPercentages<T>(items: [item: T, weight: number][]): T;

package/dist/Extensions/Array/random.extension.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomWithPercentages = exports.shuffle = exports.random = void 0;
+exports.shuffle = exports.random = void 0;
 function random() {
     const randomIndex = Math.floor(Math.random() * this.length);
     return this[randomIndex];
@@ -12,24 +12,3 @@ function shuffle() {
 }
 exports.shuffle = shuffle;
 Array.prototype.shuffle = shuffle;
-function randomWithPercentages(items) {
-    if (items.length === 0)
-        throw new Error('Items array cannot be empty');
-    // Calculate total weight in case weights don't sum to 100
-    const totalWeight = items.reduce((sum, [, weight]) => sum + weight, 0);
-    if (totalWeight === 0)
-        throw new Error('Total weight must be greater than zero');
-    // Generate random number between 0 and totalWeight
-    const random = Math.random() * totalWeight;
-    // Find the item that corresponds to this random value
-    let currentWeight = 0;
-    for (const [item, weight] of items) {
-        currentWeight += weight;
-        if (random <= currentWeight) {
-            return item;
-        }
-    }
-    throw new Error('Unable to select an item based on weights');
-}
-exports.randomWithPercentages = randomWithPercentages;
-Array.prototype.randomWithPercentages = randomWithPercentages;

package/dist/Extensions/Array/string.extension.d.ts

@@ -2,12 +2,11 @@ declare global {
     interface Array<T> {
         /**
          * Joins the elements of the array into a string, with optional custom separators.
-         * @param args An array of strings or undefined values to be used as separators between elements.
-         * @param separator The default separator to use between elements if args is not provided or undefined.
-         * @param endSeparator The separator to use before the last element.
+         * @param separator The default separator to use between elements. Defaults to ','.
+         * @param endSeparator The separator to use before the last element. Default is '&'.
          * @returns A string with the joined elements.
          */
-        join(args?: Array<string | undefined>, separator?: string, endSeparator?: string): string;
+        join(separator?: string, endSeparator?: string): string;
     }
 }
 export declare function join<T>(this: Array<T>, separator?: string, endSeparator?: string): string;

package/dist/Extensions/Number.d.ts

@@ -4,10 +4,10 @@ type Separators = {
 };
 declare global {
     interface Number {
-        toSeparationString(separators: Partial<Separators>): string;
+        toSeparationString(separators?: Partial<Separators>): string;
         toRomanNumeral(): string;
     }
 }
-export declare function toSeparationString(this: number, separators: Partial<Separators>): string;
+export declare function toSeparationString(this: number, separators?: Partial<Separators>): string;
 export declare function toRomanNumeral(this: number): string;
 export {};

package/dist/Extensions/Number.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toRomanNumeral = exports.toSeparationString = void 0;
 function toSeparationString(separators) {
-    const { thousand = '.', decimal = '.' } = separators;
+    const { thousand = '.', decimal = '.' } = separators || {};
     const [integerPart, decimalPart] = this.toString().split('.');
     const formattedInteger = integerPart.replace(/\B(?=(\d{3})+(?!\d))/g, thousand);
     return decimalPart ? `${formattedInteger}${decimal}${decimalPart}` : formattedInteger;

package/dist/Extensions/Object/arrays.extension.d.ts

@@ -6,6 +6,18 @@ declare global {
          * @param from Object to destruct
          */
         array<From extends {} = {}>(from: From): Array<[keyof From, ValueOf<From>]>;
+        /**
+         * Destructures object into array of property keys or values depending on selector
+         * @param from Object to destruct
+         * @param selector Selects whether to return keys or values
+         */
+        array<From extends {} = {}>(from: From, selector: 'keys'): Array<keyof From>;
+        /**
+         * Destructures object into array of property keys or values depending on selector
+         * @param from Object to destruct
+         * @param selector Selects whether to return keys or values
+         */
+        array<From extends {} = {}>(from: From, selector: 'values'): Array<ValueOf<From>>;
         /**
          * Destructures object into array of property keys
          * @param from Object to destruct
@@ -14,4 +26,6 @@ declare global {
     }
 }
 export declare function array<From extends {} = {}>(this: object, from: From): Array<[keyof From, ValueOf<From>]>;
+export declare function array<From extends {} = {}>(this: object, from: From, selector: 'keys'): Array<keyof From>;
+export declare function array<From extends {} = {}>(this: object, from: From, selector: 'values'): Array<ValueOf<From>>;
 export declare function keysOf<From extends {} = {}>(this: object, from: From): Array<keyof From>;

package/dist/Extensions/Object/arrays.extension.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.keysOf = exports.array = void 0;
-function array(from) {
-    return Object.entries(from);
+function array(from, selector) {
+    const entries = Object.entries(from);
+    switch (selector) {
+        case 'keys': return entries.map(([key]) => key);
+        case 'values': return entries.map(([, value]) => value);
+        default: return entries;
+    }
 }
 exports.array = array;
 Object.array = array;

package/dist/Extensions/Object/extracts.extension.d.ts

@@ -13,24 +13,24 @@ declare global {
          */
         pick<From extends {}, Props extends keyof From>(from: From, ...props: Array<Props | Partial<From>>): Pick<From, Props>;
         /**
-         * Receive an object with properties that are not in union of source and target objects
+         * Returns the difference between two objects (properties where values differ)
          * @param source Source object
          * @param target Target object
-         * @param exclude Properties to exclude from difference
-         * @returns Object with properties that are not in union of source and target objects, excluding specified properties
+         * @param exclude Properties to exclude from comparison
+         * @returns Object with properties where values differ between source and target, excluding specified properties
          */
-        difference<T extends object>(source: T, target: T, ...exclude: Array<keyof T>): Omit<T, keyof T>;
+        difference<T extends object>(source: T, target: T, ...exclude: Array<keyof T>): Partial<T>;
         /**
          * Deeply combines objects, with later objects in parameters taking precedence over earlier ones. Does not combine arrays.
          * @param objects Objects to combine
          * @returns Combined object
          */
-        combine<T extends Record<string, any | undefined>>(...objects: Array<Partial<T> | undefined>): T;
+        combine<T extends Record<string, any | undefined>>(...objects: Array<Combinable<T> | undefined>): T;
     }
 }
 export declare function omit<From extends {}, Props extends keyof From>(from: From, ...props: Array<Props | Partial<From>>): Omit<From, Props>;
 export declare function pick<From extends {}, Props extends keyof From>(from: From, ...props: Array<Props | Partial<From>>): Pick<From, Props>;
-export declare function difference<T extends object>(source: T, target: T, ...exclude: Array<keyof T>): Omit<T, keyof T>;
+export declare function difference<T extends object>(source: T, target: T, ...exclude: Array<keyof T>): Partial<T>;
 type Combinable<T extends Record<string, any>> = {
     [key in keyof T]?: T[key] extends Record<string, any> ? Combinable<T[key]> : T[key];
 };

package/dist/Extensions/Object/extracts.extension.js

@@ -30,13 +30,16 @@ function pick(from, ...props) {
 exports.pick = pick;
 Object.pick = pick;
 function difference(source, target, ...exclude) {
-    const diffKeys = new Set([...Object.keysOf(source), ...Object.keysOf(target)]);
-    exclude?.forEach(key => diffKeys.delete(key));
-    return [...diffKeys.values()].reduce((acc, key, i, arr) => {
-        const sourceValue = JSON.stringify(source[key]);
-        const targetValue = JSON.stringify(target[key]);
-        if (sourceValue !== targetValue)
-            acc[key] = target[key];
+    const excludeSet = new Set(exclude);
+    const allKeys = new Set([...Object.keysOf(source), ...Object.keysOf(target)]);
+    return [...allKeys].reduce((acc, key) => {
+        if (excludeSet.has(key))
+            return acc;
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        if (JSON.stringify(sourceValue) !== JSON.stringify(targetValue)) {
+            acc[key] = targetValue;
+        }
         return acc;
     }, {});
 }

package/dist/Extensions/Object/index.d.ts

@@ -1,10 +1,4 @@
-export declare const ObjectExtensions: {
-    omit<From extends {}, Props extends keyof From>(from: From, ...props: (Props | Partial<From>)[]): Omit<From, Props>;
-    pick<From_1 extends {}, Props_1 extends keyof From_1>(from: From_1, ...props: (Props_1 | Partial<From_1>)[]): Pick<From_1, Props_1>;
-    difference<T extends object>(source: T, target: T, ...exclude: (keyof T)[]): Omit<T, keyof T>;
-    combine<T_1 extends Record<string, any>>(...objects: ({ [key in keyof T_1]?: (T_1[key] extends Record<string, any> ? T_1[key] extends infer T_2 extends Record<string, any> ? { [key_1 in keyof T_2]?: (T_1[key][key_1] extends Record<string, any> ? T_1[key][key_1] extends infer T_3 extends Record<string, any> ? { [key_2 in keyof T_3]?: (T_1[key][key_1][key_2] extends Record<string, any> ? T_1[key][key_1][key_2] extends infer T_4 extends Record<string, any> ? { [key_3 in keyof T_4]?: (T_1[key][key_1][key_2][key_3] extends Record<string, any> ? T_1[key][key_1][key_2][key_3] extends infer T_5 extends Record<string, any> ? { [key_4 in keyof T_5]?: (T_1[key][key_1][key_2][key_3][key_4] extends Record<string, any> ? T_1[key][key_1][key_2][key_3][key_4] extends infer T_6 extends Record<string, any> ? { [key_5 in keyof T_6]?: (T_1[key][key_1][key_2][key_3][key_4][key_5] extends Record<string, any> ? T_1[key][key_1][key_2][key_3][key_4][key_5] extends infer T_7 extends Record<string, any> ? { [key_6 in keyof T_7]?: (T_1[key][key_1][key_2][key_3][key_4][key_5][key_6] extends Record<string, any> ? T_1[key][key_1][key_2][key_3][key_4][key_5][key_6] extends infer T_8 extends Record<string, any> ? { [key_7 in keyof T_8]?: (T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7] extends Record<string, any> ? T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7] extends infer T_9 extends Record<string, any> ? { [key_8 in keyof T_9]?: (T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7][key_8] extends Record<string, any> ? T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7][key_8] extends infer T_10 extends Record<string, any> ? { [key_9 in keyof T_10]?: (T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7][key_8][key_9] extends Record<string, any> ? T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7][key_8][key_9] extends infer T_11 extends Record<string, any> ? { [key_10 in keyof T_11]?: (T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7][key_8][key_9][key_10] extends Record<string, any> ? any : T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7][key_8][key_9][key_10]) | undefined; } : never : T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7][key_8][key_9]) | undefined; } : never : T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7][key_8]) | undefined; } : never : T_1[key][key_1][key_2][key_3][key_4][key_5][key_6][key_7]) | undefined; } : never : T_1[key][key_1][key_2][key_3][key_4][key_5][key_6]) | undefined; } : never : T_1[key][key_1][key_2][key_3][key_4][key_5]) | undefined; } : never : T_1[key][key_1][key_2][key_3][key_4]) | undefined; } : never : T_1[key][key_1][key_2][key_3]) | undefined; } : never : T_1[key][key_1][key_2]) | undefined; } : never : T_1[key][key_1]) | undefined; } : never : T_1[key]) | undefined; } | undefined)[]): T_1;
-    areEqual<T_12 extends object | null>(a?: T_12 | undefined, b?: T_12 | undefined): boolean;
-    isNullOrUndefined(obj: any): obj is null | undefined;
-    array<From_2 extends {} = {}>(this: object, from: From_2): [keyof From_2, import("../..").ValueOf<From_2>][];
-    keysOf<From_3 extends {} = {}>(this: object, from: From_3): (keyof From_3)[];
-};
+export * from './arrays.extension';
+export * from './booleans.extension';
+export * from './extracts.extension';
+export * from './properties.extension';

package/dist/Extensions/Object/index.js

@@ -10,27 +10,11 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ObjectExtensions = void 0;
-const Array = __importStar(require("./arrays.extension"));
-const Booleans = __importStar(require("./booleans.extension"));
-const Extracts = __importStar(require("./extracts.extension"));
-const Properties = __importStar(require("./properties.extension"));
-exports.ObjectExtensions = {
-    ...Array,
-    ...Booleans,
-    ...Extracts,
-    ...Properties
-};
+__exportStar(require("./arrays.extension"), exports);
+__exportStar(require("./booleans.extension"), exports);
+__exportStar(require("./extracts.extension"), exports);
+__exportStar(require("./properties.extension"), exports);

package/dist/Extensions/Object/properties.extension.d.ts

@@ -1,6 +1,33 @@
-import { Properties } from "./properties";
+import { PropertiesWith, If } from '../../Types';
+type PrimitiveMap = {
+    string: string;
+    number: number;
+    boolean: boolean;
+    undefined: undefined;
+    null: null;
+    object: object;
+    function: Function;
+    any: any;
+    Date: Date;
+    RegExp: RegExp;
+    Promise: Promise<any>;
+    Array: Array<any>;
+    Map: Map<any, any>;
+    Set: Set<any>;
+};
+/**
+ * Object with getPrimitiveTypes<Source, AllowFunctions extends boolean>(
+ *  source: Source,
+ *  allowFunctions: AllowFunctions = false
+ * ): Object with properties from source that matches primitive type
+ */
+export type Properties = {
+    [Key in keyof PrimitiveMap as `get${Capitalize<Key>}s`]: <Source extends {}, AllowFunctions extends boolean = false>(source: Source, withFunctions?: AllowFunctions) => If<AllowFunctions, PropertiesWith<PrimitiveMap[Key] | ((...args: any[]) => PrimitiveMap[Key]), Source>, PropertiesWith<PrimitiveMap[Key], Source>>;
+};
 declare global {
     interface ObjectConstructor {
         properties: Properties;
     }
 }
+export declare const properties: Properties;
+export {};

package/dist/Extensions/Object/properties.extension.js

@@ -1,4 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const properties_1 = require("./properties");
-Object.properties = properties_1.properties;
+exports.properties = void 0;
+const case_extension_1 = require("../String/case.extension");
+exports.properties = [
+    'string', 'number', 'boolean', 'undefined', 'null',
+    'object', 'function', 'any',
+    'Date', 'RegExp', 'Promise', 'Array', 'Map', 'Set'
+].reduce((result, primitive) => {
+    result[`get${(0, case_extension_1.convertCase)('camel', 'pascal')}s`] = function (source, withFunctions = false) {
+        return Object.keysOf(source).reduce((result, key) => {
+            if (source[key].constructor.name === primitive ||
+                (withFunctions && typeof source[key] === 'function' && source[key]).constructor.name === primitive) {
+                result[key] = source[key];
+            }
+            return result;
+        }, {});
+    };
+    return result;
+}, {});
+Object.properties = exports.properties;

package/dist/Extensions/Object/properties.js

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.properties = void 0;
+const case_extension_1 = require("../String/case.extension");
 exports.properties = [
     'string', 'number', 'boolean', 'undefined', 'null',
     'object', 'function', 'any',
     'Date', 'RegExp', 'Promise', 'Array', 'Map', 'Set'
 ].reduce((result, primitive) => {
-    result[`get${primitive.convertCase('camel', 'pascal')}s`] = function (source, withFunctions = false) {
+    result[`get${(0, case_extension_1.convertCase)('camel', 'pascal')}s`] = function (source, withFunctions = false) {
         return Object.keysOf(source).reduce((result, key) => {
             if (source[key].constructor.name === primitive ||
                 (withFunctions && typeof source[key] === 'function' && source[key]).constructor.name === primitive) {

package/dist/Extensions/String/index.d.ts

@@ -1,4 +1,2 @@
-import * as Case from './case.extension';
-export declare const StringUtils: {
-    convertCase: <TValue extends string, To extends Case.Case[], Return extends To extends [...Case.Case[], infer To_1] ? To_1 : Case.Case>(value: TValue, from: Case.Case, ...to: To) => Return extends "upper" ? Uppercase<TValue> : Return extends "lower" ? Lowercase<TValue> : Return extends "pascal" ? Capitalize<TValue> : Return extends "camel" ? Uncapitalize<TValue> : string;
-};
+export * from './case.extension';
+export * from './string.extension';

package/dist/Extensions/String/index.js

@@ -10,21 +10,9 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StringUtils = void 0;
-const Case = __importStar(require("./case.extension"));
-exports.StringUtils = {
-    ...Case,
-};
+__exportStar(require("./case.extension"), exports);
+__exportStar(require("./string.extension"), exports);

package/dist/Extensions/String/string.extension.d.ts

@@ -0,0 +1,6 @@
+declare global {
+    interface String {
+        truncate(length: number, ellipsis?: string): string;
+    }
+}
+export declare function truncate(this: string, length: number, ellipsis?: string): string;

package/dist/Extensions/String/string.extension.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncate = void 0;
+function truncate(length, ellipsis = "...") {
+    if (this.length <= length)
+        return this;
+    return this.slice(0, length - ellipsis.length) + ellipsis;
+}
+exports.truncate = truncate;
+String.prototype.truncate = truncate;

package/dist/Extensions/index.d.ts

@@ -1,6 +1,6 @@
 export * from './Array';
-export * from './Document';
+export * from './Function';
 export * from './Map';
-export * from './Object';
 export * from './Number';
+export * from './Object';
 export * from './String';

package/dist/Extensions/index.js

@@ -15,8 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Array"), exports);
-__exportStar(require("./Document"), exports);
+__exportStar(require("./Function"), exports);
 __exportStar(require("./Map"), exports);
-__exportStar(require("./Object"), exports);
 __exportStar(require("./Number"), exports);
+__exportStar(require("./Object"), exports);
 __exportStar(require("./String"), exports);

package/dist/Types/Able.d.ts

@@ -5,7 +5,7 @@ export type Functionable<T, Args extends any[] = []> = T | ((...args: Args) => T
 /**
  * Item is Promise<T> or T
  */
-export type Promisable<T> = T | Promise<T>;
+export type Promiseable<T> = T | Promise<T>;
 /**
  * Item is T or null
  */

package/dist/Utils/NumberUtils.d.ts

@@ -1 +1,6 @@
 export declare function between(min: number, max: number): number;
+export declare function randomWithPercentages<T>(items: [item: T, weight: number][]): T;
+export declare const NumberUtils: {
+    between: typeof between;
+    randomWithPercentages: typeof randomWithPercentages;
+};

package/dist/Utils/NumberUtils.js

@@ -1,7 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.between = void 0;
+exports.NumberUtils = exports.randomWithPercentages = exports.between = void 0;
 function between(min, max) {
     return Math.floor(Math.random() * (max - min + 1)) + min;
 }
 exports.between = between;
+function randomWithPercentages(items) {
+    if (items.length === 0)
+        throw new Error('Items array cannot be empty');
+    // Calculate total weight in case weights don't sum to 100
+    const totalWeight = items.reduce((sum, [, weight]) => sum + weight, 0);
+    if (totalWeight === 0)
+        throw new Error('Total weight must be greater than zero');
+    // Generate random number between 0 and totalWeight
+    const random = Math.random() * totalWeight;
+    // Find the item that corresponds to this random value
+    let currentWeight = 0;
+    for (const [item, weight] of items) {
+        currentWeight += weight;
+        if (random <= currentWeight) {
+            return item;
+        }
+    }
+    throw new Error('Unable to select an item based on weights');
+}
+exports.randomWithPercentages = randomWithPercentages;
+exports.NumberUtils = {
+    between,
+    randomWithPercentages,
+};

package/dist/Utils/StringUtils.d.ts

@@ -1,3 +1,8 @@
 export declare function classNames(...args: Array<any>): string;
 export declare function randomId(length?: number): string;
 export declare function pluralize(countable: number | ArrayLike<any> | Map<any, any>, singular: string, plural?: string): string;
+export declare const StringUtils: {
+    classNames: typeof classNames;
+    randomId: typeof randomId;
+    pluralize: typeof pluralize;
+};

package/dist/Utils/StringUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pluralize = exports.randomId = exports.classNames = void 0;
+exports.StringUtils = exports.pluralize = exports.randomId = exports.classNames = void 0;
 function classNames(...args) {
     return args.reduce((acc, arg) => {
         if (!arg)
@@ -45,3 +45,8 @@ function pluralize(countable, singular, plural) {
     return `${singular}s`;
 }
 exports.pluralize = pluralize;
+exports.StringUtils = {
+    classNames,
+    randomId,
+    pluralize
+};

package/dist/Utils/TimeUtils/index.d.ts

@@ -1,4 +1,7 @@
 export declare const TimeUtils: {
+    ensureStartZero(num: number): string;
+    get12HourFormat(hour: number): string;
+    get24HourFormat(hour: number): string;
     throttle<T>(throttleId: string, callback: () => T, cooldown: number): T;
     wrapInThrottle<T_1>(callback: (...args: T_1[]) => void, cooldown: number): (...args: T_1[]) => void;
     isThrottleOnCooldown(throttleId: string): boolean;

package/dist/Utils/TimeUtils/index.js

@@ -27,8 +27,10 @@ exports.TimeUtils = void 0;
 const Debounce = __importStar(require("./debounce.util"));
 const Functions = __importStar(require("./functions.util"));
 const Throttle = __importStar(require("./throttle.util"));
+const StringUtils = __importStar(require("./string.util"));
 exports.TimeUtils = {
     ...Functions,
     ...Debounce,
     ...Throttle,
+    ...StringUtils,
 };

package/dist/Utils/TimeUtils/string.util.d.ts

@@ -0,0 +1,3 @@
+export declare function ensureStartZero(num: number): string;
+export declare function get12HourFormat(hour: number): string;
+export declare function get24HourFormat(hour: number): string;

package/dist/Utils/TimeUtils/string.util.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get24HourFormat = exports.get12HourFormat = exports.ensureStartZero = void 0;
+function ensureStartZero(num) {
+    return num < 10 ? `0${num}` : num.toString();
+}
+exports.ensureStartZero = ensureStartZero;
+function get12HourFormat(hour) {
+    if (hour === 0)
+        return '12am';
+    if (hour > 12)
+        return `${hour - 12}pm`;
+    return `${hour}am`;
+}
+exports.get12HourFormat = get12HourFormat;
+function get24HourFormat(hour) {
+    return ensureStartZero(hour);
+}
+exports.get24HourFormat = get24HourFormat;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export * from './Classes';
 export * from './Extensions';
-export * from './Functions';
 export * from './Interfaces';
 export * from './Types';
+export * from './Utils';