@seedcord/utils 0.3.8 → 0.4.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/misc/directory.ts","../src/misc/fyShuffle.ts","../src/numbers/currentTime.ts","../src/numbers/generateCode.ts","../src/numbers/hexToNumber.ts","../src/numbers/ordinal.ts","../src/numbers/percentage.ts","../src/numbers/round.ts","../src/numbers/roundToDenomination.ts","../src/objects/filterCirculars.ts","../src/objects/keepDefined.ts","../src/strings/capitalize.ts","../src/strings/longestStringLength.ts","../src/strings/generateAsciiTable.ts","../src/strings/prettify.ts","../src/strings/prettyDifference.ts"],"names":["isTsOrJsFile","entry","isFile","name","endsWith","traverseDirectory","dir","callback","logger","entries","readdir","withFileTypes","error","fullPath","join","relativePath","relative","process","cwd","isDirectory","imported","fyShuffle","items","array","slice","i","length","j","Math","floor","random","currentTime","Date","now","generateCode","digits","min","pow","max","hexToNumber","hex","SeedcordTypeError","SeedcordErrorCode","UtilHexInputType","normalized","replace","test","SeedcordError","UtilHexInvalid","converted","parseInt","Number","isNaN","ordinal","n","s","v","index","suffix","percentage","num1","num2","toFixed","round","num","precision","factor","EPSILON","roundToDenomination","opts","suffixes","toString","temp","result","adjustedTemp","ceil","substring","filterCirculars","value","options","marker","mode","json","decycle","seen","WeakSet","JSON","stringify","_k","obj","has","add","Object","keys","parse","input","recur","val","t","toISOString","RegExp","Array","isArray","map","item","Map","from","k","Set","out","keepDefined","source","selectedKeys","key","undefined","capitalize","word","charAt","toUpperCase","toLowerCase","longestStringLength","arr","el","generateAsciiTable","data","firstRow","table","columnWidths","maxWidth","row","cell","push","createLine","char","left","intersect","right","line","forEach","width","repeat","rowIndex","columnIndex","columnWidth","padEnd","prettify","trim","prettyDifference","numBefore","numAfter"],"mappings":"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","file":"index.cjs","sourcesContent":["import { readdir } from 'node:fs/promises';\nimport * as path from 'node:path';\n\nimport type { Logger } from '@seedcord/services';\nimport type * as fs from 'node:fs';\n/**\n * Determines if a directory entry is a TypeScript or JavaScript file.\n *\n * @param entry - The directory entry to check.\n * @returns True if the entry is a file ending with .ts or .js.\n */\nexport function isTsOrJsFile(entry: fs.Dirent): boolean {\n    return (\n        entry.isFile() &&\n        (entry.name.endsWith('.ts') || entry.name.endsWith('.js')) &&\n        !entry.name.endsWith('.d.ts') &&\n        !entry.name.endsWith('.map')\n    );\n}\n\n/**\n * Recursively traverses through a directory, importing all .ts and .js files and applying a callback to each import.\n *\n * @param dir - The directory path to traverse.\n * @param callback - A function that will be called for each imported module. It receives the full file path, the file's relative path, and the imported module as arguments.\n * @returns A Promise that resolves when the traversal is complete.\n */\nexport async function traverseDirectory(\n    dir: string,\n    callback: (fullPath: string, relativePath: string, imported: Record<string, unknown>) => Promise<void> | void,\n    logger: Logger\n): Promise<void> {\n    let entries: fs.Dirent[];\n\n    try {\n        entries = await readdir(dir, { withFileTypes: true });\n    } catch {\n        logger.error('Failed to read this directory');\n        entries = [];\n    }\n\n    for (const entry of entries) {\n        const fullPath = path.join(dir, entry.name);\n        const relativePath = path.relative(process.cwd(), fullPath);\n\n        if (entry.isDirectory()) {\n            await traverseDirectory(fullPath, callback, logger);\n        } else if (isTsOrJsFile(entry)) {\n            const imported = (await import(fullPath)) as Record<string, unknown>;\n            await callback(fullPath, relativePath, imported);\n        }\n    }\n}\n","/**\n * Shuffles an array using the Fisher-Yates algorithm.\n * This function creates a new array with the same elements in a random order,\n * without modifying the original array.\n *\n * @typeParam TArray - The type of elements in the array\n * @param items - The array to shuffle\n * @returns A new array with the same elements in a random order\n *\n * @example\n * ```typescript\n * const numbers = [1, 2, 3, 4, 5];\n * const shuffled = fyShuffle(numbers);\n * // shuffled might be [3, 1, 5, 2, 4]\n * // numbers is still [1, 2, 3, 4, 5]\n * ```\n */\nexport function fyShuffle<TArray>(items: TArray[]): TArray[] {\n    const array = items.slice();\n    for (let i = array.length - 1; i > 0; i--) {\n        const j = Math.floor(Math.random() * (i + 1));\n        // @ts-expect-error - TypeScript doesn't recognize that TArray can be swapped\n        [array[i], array[j]] = [array[j], array[i]];\n    }\n    return array;\n}\n","/**\n * Return current time in seconds\n */\nexport function currentTime(): number {\n    return Math.floor(Date.now() / 1000);\n}\n","/**\n * Generates a random numeric code with the specified number of digits.\n *\n * @param digits - The number of digits for the generated code.\n * @returns A random numeric code with the specified number of digits.\n */\nexport function generateCode(digits: number): number {\n    const min = Math.pow(10, digits - 1);\n    const max = Math.pow(10, digits) - 1;\n    return Math.floor(Math.random() * (max - min + 1) + min);\n}\n","import { SeedcordError, SeedcordErrorCode, SeedcordTypeError } from '@seedcord/services';\n\n/**\n * Converts hexcode to number\n *\n * @param hex - The hex code to convert.\n * @returns The converted number.\n */\nexport function hexToNumber(hex: string): number {\n    if (typeof hex !== 'string') {\n        throw new SeedcordTypeError(SeedcordErrorCode.UtilHexInputType);\n    }\n\n    const normalized = hex.replace(/^#/, '');\n    if (!/^[0-9a-fA-F]+$/.test(normalized)) {\n        throw new SeedcordError(SeedcordErrorCode.UtilHexInvalid);\n    }\n\n    const converted = parseInt(normalized, 16);\n    if (Number.isNaN(converted)) {\n        throw new SeedcordError(SeedcordErrorCode.UtilHexInvalid);\n    }\n\n    return converted;\n}\n","/**\n * Returns the ordinal suffix for a given number.\n *\n * @param n - The number to get the ordinal for\n * @returns The number with its ordinal suffix\n *\n * @example\n * ordinal(1); // \"1st\"\n * ordinal(22); // \"22nd\"\n * ordinal(13); // \"13th\"\n */\nexport function ordinal(n: number): string {\n    const s = ['th', 'st', 'nd', 'rd'];\n    const v = n % 100;\n    const index = (v - 20) % 10;\n    const suffix = s[index] ?? s[v] ?? s[0];\n    if (!suffix) return `${n}th`;\n\n    return `${n}${suffix}`;\n}\n","/**\n * Takes two numbers and returns the percentage of the first number in the second number with two decimal places.\n *\n * @param num1 - The first number.\n * @param num2 - The second number.\n *\n * @returns The percentage of the first number in the second number with two decimal places.\n */\nexport function percentage(num1: number, num2: number): number {\n    return Number(((num1 / num2) * 100).toFixed(2));\n}\n","/**\n * Rounds a number to a specified number of decimal places.\n *\n * @param num - The number to be rounded.\n * @param precision - The number of decimal places to round to.\n * @returns The rounded number.\n */\nexport function round(num: number, precision: number): number {\n    const factor = Math.pow(10, precision);\n    return Math.round((num + Number.EPSILON) * factor) / factor;\n}\n","import type { TupleOf } from 'type-fest';\n\nexport interface RoundToDenomOptions {\n    /**\n     * Suffixes to use for each denomination level. Defaults to `['K', 'M', 'B', 'T', 'Q']`.\n     */\n    suffixes?: TupleOf<5, string>;\n    /** Number of decimal places to include in the rounded result. Defaults to `1`. */\n    precision?: number;\n}\n\n/**\n * Rounds a number to a string representation with a denomination suffix.\n * @param num - The number to round.\n * @example\n * ```ts\n * roundToDenomination(1234); // \"1.2K\"\n * roundToDenomination(10000, ['k', 'm', 'b', 't', 'q']); // \"10k\"\n * roundToDenomination(12345678); // \"12.3M\"\n * ```\n * @returns The rounded number as a string with a denomination suffix.\n */\nexport function roundToDenomination(num: number, opts?: RoundToDenomOptions): string {\n    const { suffixes = ['K', 'M', 'B', 'T', 'Q'], precision = 1 } = opts ?? {};\n\n    if (num < 10000) {\n        return num.toString();\n    }\n\n    let index = -1;\n    let temp = num;\n\n    while (temp >= 1000 && index < suffixes.length - 1) {\n        temp /= 1000;\n        index++;\n    }\n\n    let result;\n\n    if (temp % 1 === 0) {\n        result = temp.toString();\n    } else {\n        const adjustedTemp = Math.round(temp * Math.pow(10, precision + 1)) / Math.pow(10, precision + 1);\n        result = adjustedTemp.toFixed(precision);\n    }\n\n    if (result.endsWith('.9')) {\n        result = Math.ceil(Number(result)).toString();\n    }\n\n    if (result.endsWith('.0')) {\n        result = result.substring(0, result.length - 2);\n    }\n\n    if (result === '1000') {\n        index += 1;\n        result = '1';\n    }\n\n    return result + (index >= 0 ? suffixes[index] : '');\n}\n","import type { ILogger } from '@seedcord/types';\nimport type { JsonPrimitive } from 'type-fest';\n\n/**\n * JSONify an arbitrary type while allowing any object position to be replaced\n * by a circular marker. Optional keys stay optional.\n */\nexport type JsonifyWithCirculars<BaseType, Marker extends string = '[Circular]'> = BaseType extends JsonPrimitive\n    ? BaseType\n    : BaseType extends bigint\n      ? string\n      : BaseType extends Date\n        ? string\n        : BaseType extends { toJSON(): infer J }\n          ? unknown extends J\n              ? JsonifyObject<BaseType, Marker>\n              : JsonifyWithCirculars<J, Marker>\n          : BaseType extends readonly (infer U)[]\n            ? (JsonifyWithCirculars<U, Marker> | Marker)[]\n            : BaseType extends Map<infer K, infer V>\n              ? [JsonifyWithCirculars<K, Marker> | Marker, JsonifyWithCirculars<V, Marker> | Marker][]\n              : BaseType extends Set<infer U2>\n                ? (JsonifyWithCirculars<U2, Marker> | Marker)[]\n                : BaseType extends (...args: unknown[]) => unknown\n                  ? never\n                  : BaseType extends object\n                    ? JsonifyObject<BaseType, Marker>\n                    : never;\n\n/**\n * Helper to JSONify object types with circular markers.\n *\n * @internal\n */\nexport type JsonifyObject<BaseType, Marker extends string> = {\n    [K in keyof BaseType as K extends symbol\n        ? never\n        : BaseType[K] extends (...args: unknown[]) => unknown\n          ? never\n          : K]:\n        | JsonifyWithCirculars<Exclude<BaseType[K], undefined>, Marker>\n        | Extract<BaseType[K], undefined>\n        | Marker;\n};\n\n/**\n * Configuration for {@link filterCirculars}.\n */\nexport interface FilterCircularsOptions<Marker extends string = '[Circular]'> {\n    /** Optional {@link ILogger} used to log stringify or parse errors. */\n    logger?: ILogger;\n    /** Override the circular placeholder. Default is `[Circular]`. */\n    marker?: Marker;\n    /** Processing mode. `json` uses stringify and parse (might end up using a `toJSON()` if found). `decycle` builds a safe clone first. Default is `decycle`. */\n    mode?: 'json' | 'decycle';\n}\n\n/**\n * Creates a clean, JSON safe copy of a value and replaces circular references with a marker.\n *\n * In `json` mode it behaves like stringify then parse with a replacer that handles cycles and BigInt.\n * In `decycle` mode it first clones without using toJSON, then you can stringify the result later.\n *\n * @typeParam ObjType - Type of the input value.\n * @typeParam Marker - Marker string used for circular references.\n *\n * @param value - The value to clone safely.\n * @param options - Optional configuration.\n *\n * @returns A JSON safe structure with circular references replaced by the marker.\n *\n * @example\n * ```ts\n * interface Test {\n *   name: string;\n *   self?: Test;\n * }\n *\n * const obj: Test = { name: 'seedcord' };\n * obj.self = obj;\n *\n * const clean = filterCirculars(obj);\n * //     ^? { name: string; self?: \"[Circular]\" | { ... } }\n * console.log(clean.self); // \"[Circular]\"\n * ```\n */\nexport function filterCirculars<ObjType, Marker extends string = '[Circular]'>(\n    value: ObjType,\n    options?: FilterCircularsOptions<Marker>\n): JsonifyWithCirculars<ObjType, Marker> {\n    const logger = options?.logger;\n    const marker = (options?.marker ?? '[Circular]') as Marker;\n    const mode = options?.mode ?? 'decycle';\n\n    if (mode === 'json') return json(value, marker, logger);\n\n    try {\n        return decycle(value, marker);\n    } catch (error) {\n        logger?.error('filterCirculars decycle error', error);\n        return value as JsonifyWithCirculars<ObjType, Marker>;\n    }\n}\n\n/**\n * Attempts to build a JSONified object using JSON.stringify and JSON.parse.\n *\n * @internal\n */\nfunction json<ObjType, Marker extends string>(\n    value: ObjType,\n    marker: Marker,\n    logger?: ILogger\n): JsonifyWithCirculars<ObjType, Marker> {\n    const seen = new WeakSet<object>();\n    let json: string | undefined;\n\n    try {\n        json = JSON.stringify(value, (_k: string, v: unknown) => {\n            if (typeof v === 'bigint') return v.toString();\n            if (typeof v === 'object' && v !== null) {\n                const obj = v;\n                if (seen.has(obj)) return marker;\n                seen.add(obj);\n            }\n            return v;\n        });\n    } catch (error) {\n        logger?.error('filterCirculars stringify error', error);\n        if (typeof value === 'object' && value !== null) {\n            logger?.error('top level keys', Object.keys(value as Record<string, unknown>));\n        }\n        return value as JsonifyWithCirculars<ObjType, Marker>;\n    }\n\n    if (typeof json !== 'string') {\n        return value as JsonifyWithCirculars<ObjType, Marker>;\n    }\n\n    try {\n        return JSON.parse(json) as JsonifyWithCirculars<ObjType, Marker>;\n    } catch (error) {\n        logger?.error('filterCirculars parse error', error);\n        logger?.error('bad JSON', json);\n        return value as JsonifyWithCirculars<ObjType, Marker>;\n    }\n}\n\n/**\n * Builds a JSON safe clone without calling toJSON on class instances.\n *\n * @internal\n */\nfunction decycle<ObjType, Marker extends string = '[Circular]'>(\n    input: ObjType,\n    marker: Marker,\n    seen = new WeakSet<object>()\n): JsonifyWithCirculars<ObjType, Marker> {\n    const recur = (val: unknown): unknown => {\n        if (val === null) return null;\n        const t = typeof val;\n\n        // if bigint, return string representation\n        if (t === 'bigint') return (val as bigint).toString();\n\n        // if primitive, return as is\n        if (t !== 'object') return val;\n\n        const obj = val as Record<string | number | symbol, unknown>;\n\n        if (seen.has(obj)) return marker;\n        seen.add(obj);\n\n        // if Date, return ISO string\n        if (obj instanceof Date) return obj.toISOString();\n\n        // if RegExp, return string representation\n        if (obj instanceof RegExp) return obj.toString();\n\n        // if array, recur on each item\n        if (Array.isArray(obj)) {\n            return obj.map((item) => recur(item));\n        }\n\n        // if Map, recur on entries/values\n        if (obj instanceof Map) {\n            return Array.from(obj, ([k, v]) => [recur(k), recur(v)]);\n        }\n\n        // if Set, recur on values\n        if (obj instanceof Set) {\n            return Array.from(obj, (v) => recur(v));\n        }\n\n        const out: Record<string, unknown> = {};\n        for (const [k, v] of Object.entries(obj)) {\n            if (typeof v === 'function') continue;\n            out[k] = recur(v);\n        }\n\n        return out;\n    };\n\n    return recur(input) as JsonifyWithCirculars<ObjType, Marker>;\n}\n","/**\n * Pulls out only the keys from an object that actually have values.\n *\n * @typeParam TObject - the original object type you're pulling from\n * @typeParam TKey - the specific keys you want to copy if they're defined\n * @param source - the object to read values from\n * @param keys - optional list of keys you want to include if they exist. If omitted, all keys are considered\n *\n * @example\n * ```ts\n * interface Config {\n *   host?: string;\n *   port?: number;\n *   user?: string;\n *   password?: string;\n * }\n *\n * const config: Config = {\n *   host: 'localhost',\n *   port: undefined,\n *   user: 'admin',\n *   password: undefined\n * };\n *\n * const definedConfig = keepDefined(config, 'host', 'port', 'user', 'password');\n * // Result: { host: 'localhost', user: 'admin' }\n * ```\n */\nexport function keepDefined<TObject extends object, TKey extends keyof TObject>(\n    source: TObject,\n    ...keys: readonly TKey[]\n): Partial<Pick<TObject, TKey extends never ? keyof TObject : TKey>> {\n    const selectedKeys = keys.length > 0 ? keys : (Object.keys(source) as TKey[]);\n    const result: Partial<TObject> = {};\n\n    for (const key of selectedKeys) {\n        const value = source[key];\n        if (value !== undefined && value !== null) {\n            result[key] = value;\n        }\n    }\n    return result;\n}\n","/**\n * Returns the word with its first letter capitalized and the rest in lowercase.\n * @param word - The word to be formatted.\n * @returns The formatted word.\n */\nexport function capitalize(word: string): string {\n    return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();\n}\n","/**\n * Function takes an array of strings or numbers and returns the number of characters in the longest string/number\n *\n * @param arr - The array of strings or numbers\n * @returns The length of the longest element when converted to string\n */\nexport function longestStringLength(arr: (string | number)[]): number {\n    return Math.max(...arr.map((el) => el.toString().length));\n}\n","/**\n * Generates an ASCII table from the provided data.\n *\n * @param data - The data to be displayed in the table.\n * @returns The generated ASCII table as a string.\n */\nexport function generateAsciiTable(data: string[][]): string {\n    if (data.length === 0) return '';\n\n    const firstRow = data[0];\n    if (!firstRow || firstRow.length === 0) return '';\n\n    let table = '';\n    const columnWidths: number[] = [];\n\n    // Determine the maximum width for each column\n    for (let i = 0; i < firstRow.length; i++) {\n        let maxWidth = 0;\n        for (const row of data) {\n            const cell = row[i];\n            if (cell !== undefined) maxWidth = Math.max(maxWidth, cell.length);\n        }\n        columnWidths.push(maxWidth);\n    }\n\n    // Function to create a horizontal line\n    const createLine = (char: string, left: string, intersect: string, right: string): string => {\n        let line = left;\n        columnWidths.forEach((width, index) => {\n            line += char.repeat(width + 2);\n            if (index < columnWidths.length - 1) line += intersect;\n            else line += right;\n        });\n        line += '\\n';\n        return line;\n    };\n\n    // Top border\n    table += createLine('═', '╔', '╦', '╗');\n\n    data.forEach((row, rowIndex) => {\n        // Row content\n        table += '║';\n        row.forEach((cell, columnIndex) => {\n            const columnWidth = columnWidths[columnIndex];\n            if (columnWidth !== undefined) table += ` ${cell.padEnd(columnWidth)} ║`;\n        });\n        table += '\\n';\n\n        // Separator or bottom border\n        if (rowIndex < data.length - 1) table += createLine('─', '╠', '╬', '╣');\n        else table += createLine('═', '╚', '╩', '╝');\n    });\n\n    return table;\n}\n","import { capitalize } from './capitalize';\n\n/**\n * Options for the `prettify` function.\n */\nexport interface PrettifyOptions {\n    capitalize?: boolean;\n}\n/**\n * Converts a string from any common naming convention to human-readable format.\n * Handles camelCase, PascalCase, snake_case, and kebab-case.\n *\n * @param key - The string to convert\n * @param opts - Optional configuration\n * @returns A space-separated, human-readable string\n *\n * @example\n * prettify(\"camelCaseString\") // \"camel Case String\"\n * prettify(\"PascalCaseString\") // \"Pascal Case String\"\n * prettify(\"snake_case_string\") // \"snake case string\"\n * prettify(\"kebab-case-string\") // \"kebab case string\"\n * prettify(\"mixedCase_string-name\") // \"mixed Case string name\"\n */\n\nexport function prettify(key: string, opts?: PrettifyOptions): string {\n    const result = key\n        .replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase/PascalCase\n        .replace(/[_-]/g, ' ') // snake_case and kebab-case\n        .trim();\n\n    if (opts?.capitalize) return capitalize(result);\n\n    return result;\n}\n","/**\n * Calculates the difference between two numbers and formats it as a string with a '+' prefix for positive differences.\n *\n * @param numBefore - The initial number value\n * @param numAfter - The final number value\n * @returns A string representing the difference, with a '+' sign for positive differences\n *\n * @example\n * // Returns \"+5\"\n * prettyDifference(10, 15);\n *\n * @example\n * // Returns \"-3\"\n * prettyDifference(10, 7);\n */\nexport function prettyDifference(numBefore: number, numAfter: number): string {\n    return (numAfter - numBefore > 0 ? `+${numAfter - numBefore}` : numAfter - numBefore).toString();\n}\n"]}
+{"version":3,"file":"index.cjs","names":["path"],"sources":["../src/misc/assertNever.ts","../src/misc/directory.ts","../src/misc/fyShuffle.ts","../src/numbers/currentTime.ts","../src/numbers/generateCode.ts","../src/numbers/ordinal.ts","../src/numbers/percentage.ts","../src/numbers/round.ts","../src/numbers/roundToDenomination.ts","../src/objects/filterCirculars.ts","../src/objects/hasKeys.ts","../src/objects/keepDefined.ts","../src/strings/capitalize.ts","../src/strings/longestStringLength.ts","../src/strings/generateAsciiTable.ts","../src/strings/prettify.ts","../src/strings/prettyDifference.ts","../src/index.ts"],"sourcesContent":["/**\n * Exhaustiveness guard for discriminated unions. Place in the `default` branch of a `switch` over a\n * union's discriminant: if a new variant is added without a matching case, the call fails to compile.\n * Throws at runtime if reached with a value the types said was impossible.\n */\nexport function assertNever(value: never): never {\n    throw new Error(`Unhandled discriminated union member: ${JSON.stringify(value)}`);\n}\n","import { readdir } from 'node:fs/promises';\nimport * as path from 'node:path';\n\nimport type { ILogger } from '@seedcord/types';\nimport type * as fs from 'node:fs';\n\n/**\n * Determines if a directory entry is a TypeScript or JavaScript file.\n *\n * @param entry - The directory entry to check.\n * @returns True if the entry is a file ending with .ts or .js.\n */\nexport function isTsOrJsFile(entry: fs.Dirent): boolean {\n    return (\n        entry.isFile() &&\n        (entry.name.endsWith('.ts') || entry.name.endsWith('.js')) &&\n        !entry.name.endsWith('.d.ts') &&\n        !entry.name.endsWith('.map')\n    );\n}\n\n/**\n * Recursively traverses through a directory, importing all .ts and .js files and applying a callback to each import.\n *\n * @param dir - The directory path to traverse.\n * @param callback - A function that will be called for each imported module. It receives the full file path, the file's relative path, and the imported module as arguments.\n * @returns A Promise that resolves when the traversal is complete.\n */\nexport async function traverseDirectory(\n    dir: string,\n    callback: (fullPath: string, relativePath: string, imported: Record<string, unknown>) => Promise<void> | void,\n    logger: ILogger\n): Promise<void> {\n    let entries: fs.Dirent[];\n\n    try {\n        entries = await readdir(dir, { withFileTypes: true });\n    } catch (err) {\n        logger.error(`Failed to read directory ${dir}`, err);\n        entries = [];\n    }\n\n    for (const entry of entries) {\n        const fullPath = path.join(dir, entry.name);\n        const relativePath = path.relative(process.cwd(), fullPath);\n\n        if (entry.isDirectory()) {\n            await traverseDirectory(fullPath, callback, logger);\n        } else if (isTsOrJsFile(entry)) {\n            const imported = (await import(fullPath)) as Record<string, unknown>;\n            await callback(fullPath, relativePath, imported);\n        }\n    }\n}\n\n/**\n * Options for formatting file paths.\n */\nexport interface FormatFileOptions {\n    /**\n     * Whether to return only the directory part of the path. {@default false}\n     */\n    onlyDir?: boolean;\n    /**\n     * A prefix to prepend to the formatted path. {@default ./}\n     */\n    prefix?: string;\n}\n\n/**\n * Formats a file path relative to the current working directory.\n * @param filePath - The file path to format.\n * @param options - Formatting options.\n * @returns The formatted file path.\n */\nexport function formatFilePath(filePath: string, options: FormatFileOptions = {}): string {\n    const { onlyDir = false, prefix = './' } = options;\n\n    const resolved = onlyDir\n        ? path.relative(process.cwd(), filePath.replace(/\\/[^/]*$/, ''))\n        : path.relative(process.cwd(), filePath);\n    return `${prefix}${resolved}`;\n}\n","/**\n * Shuffles an array using the Fisher-Yates algorithm.\n * This function creates a new array with the same elements in a random order,\n * without modifying the original array.\n *\n * @typeParam TArray - The type of elements in the array\n * @param items - The array to shuffle\n * @returns A new array with the same elements in a random order\n *\n * @example\n * ```typescript\n * const numbers = [1, 2, 3, 4, 5];\n * const shuffled = fyShuffle(numbers);\n * // shuffled might be [3, 1, 5, 2, 4]\n * // numbers is still [1, 2, 3, 4, 5]\n * ```\n */\nexport function fyShuffle<TArray>(items: TArray[]): TArray[] {\n    const array = items.slice();\n    for (let i = array.length - 1; i > 0; i--) {\n        const j = Math.floor(Math.random() * (i + 1));\n        // @ts-expect-error - TypeScript doesn't recognize that TArray can be swapped\n        [array[i], array[j]] = [array[j], array[i]];\n    }\n    return array;\n}\n","/**\n * Return current time in seconds\n */\nexport function currentTime(): number {\n    return Math.floor(Date.now() / 1000);\n}\n","/**\n * Generates a random numeric code with the specified number of digits.\n *\n * @param digits - The number of digits for the generated code.\n * @returns A random numeric code with the specified number of digits.\n */\nexport function generateCode(digits: number): number {\n    const min = Math.pow(10, digits - 1);\n    const max = Math.pow(10, digits) - 1;\n    return Math.floor(Math.random() * (max - min + 1) + min);\n}\n","/**\n * Returns the ordinal suffix for a given number.\n *\n * @param n - The number to get the ordinal for\n * @returns The number with its ordinal suffix\n *\n * @example\n * ordinal(1); // \"1st\"\n * ordinal(22); // \"22nd\"\n * ordinal(13); // \"13th\"\n */\nexport function ordinal(n: number): string {\n    const s = ['th', 'st', 'nd', 'rd'];\n    const v = n % 100;\n    const index = (v - 20) % 10;\n    const suffix = s[index] ?? s[v] ?? s[0];\n    if (!suffix) return `${n}th`;\n\n    return `${n}${suffix}`;\n}\n","/**\n * Takes two numbers and returns the percentage of the first number in the second number with two decimal places.\n *\n * @param num1 - The first number.\n * @param num2 - The second number.\n *\n * @returns The percentage of the first number in the second number with two decimal places.\n */\nexport function percentage(num1: number, num2: number): number {\n    return Number(((num1 / num2) * 100).toFixed(2));\n}\n","/**\n * Rounds a number to a specified number of decimal places.\n *\n * @param num - The number to be rounded.\n * @param precision - The number of decimal places to round to.\n * @returns The rounded number.\n */\nexport function round(num: number, precision: number): number {\n    const factor = Math.pow(10, precision);\n    return Math.round((num + Number.EPSILON) * factor) / factor;\n}\n","import type { TupleOf } from 'type-fest';\n\nexport interface RoundToDenomOptions {\n    /**\n     * Suffixes to use for each denomination level. Defaults to `['K', 'M', 'B', 'T', 'Q']`.\n     */\n    suffixes?: TupleOf<5, string>;\n    /** Number of decimal places to include in the rounded result. Defaults to `1`. */\n    precision?: number;\n}\n\n/**\n * Rounds a number to a string representation with a denomination suffix.\n * @param num - The number to round.\n * @example\n * ```ts\n * roundToDenomination(1234); // \"1.2K\"\n * roundToDenomination(10000, ['k', 'm', 'b', 't', 'q']); // \"10k\"\n * roundToDenomination(12345678); // \"12.3M\"\n * ```\n * @returns The rounded number as a string with a denomination suffix.\n */\nexport function roundToDenomination(num: number, opts?: RoundToDenomOptions): string {\n    const { suffixes = ['K', 'M', 'B', 'T', 'Q'], precision = 1 } = opts ?? {};\n\n    if (num < 10000) {\n        return num.toString();\n    }\n\n    let index = -1;\n    let temp = num;\n\n    while (temp >= 1000 && index < suffixes.length - 1) {\n        temp /= 1000;\n        index++;\n    }\n\n    let result;\n\n    if (temp % 1 === 0) {\n        result = temp.toString();\n    } else {\n        const adjustedTemp = Math.round(temp * Math.pow(10, precision + 1)) / Math.pow(10, precision + 1);\n        result = adjustedTemp.toFixed(precision);\n    }\n\n    if (result.endsWith('.9')) {\n        result = Math.ceil(Number(result)).toString();\n    }\n\n    if (result.endsWith('.0')) {\n        result = result.substring(0, result.length - 2);\n    }\n\n    if (result === '1000') {\n        index += 1;\n        result = '1';\n    }\n\n    return result + (index >= 0 ? suffixes[index] : '');\n}\n","import type { ILogger } from '@seedcord/types';\nimport type { JsonPrimitive } from 'type-fest';\n\n/**\n * JSONify an arbitrary type while allowing any object position to be replaced\n * by a circular marker. Optional keys stay optional.\n */\nexport type JsonifyWithCirculars<BaseType, Marker extends string = '[Circular]'> = BaseType extends JsonPrimitive\n    ? BaseType\n    : BaseType extends bigint\n      ? string\n      : BaseType extends Date\n        ? string\n        : BaseType extends { toJSON(): infer J }\n          ? unknown extends J\n              ? JsonifyObject<BaseType, Marker>\n              : JsonifyWithCirculars<J, Marker>\n          : BaseType extends readonly (infer U)[]\n            ? (JsonifyWithCirculars<U, Marker> | Marker)[]\n            : BaseType extends Map<infer K, infer V>\n              ? [JsonifyWithCirculars<K, Marker> | Marker, JsonifyWithCirculars<V, Marker> | Marker][]\n              : BaseType extends Set<infer U2>\n                ? (JsonifyWithCirculars<U2, Marker> | Marker)[]\n                : BaseType extends (...args: unknown[]) => unknown\n                  ? never\n                  : BaseType extends object\n                    ? JsonifyObject<BaseType, Marker>\n                    : never;\n\n/**\n * Helper to JSONify object types with circular markers.\n *\n * @internal\n */\nexport type JsonifyObject<BaseType, Marker extends string> = {\n    [K in keyof BaseType as K extends symbol\n        ? never\n        : BaseType[K] extends (...args: unknown[]) => unknown\n          ? never\n          : K]:\n        | JsonifyWithCirculars<Exclude<BaseType[K], undefined>, Marker>\n        | Extract<BaseType[K], undefined>\n        | Marker;\n};\n\n/**\n * Returned by {@link filterCirculars} when a value cannot be made JSON-safe. The original value is\n * never returned on failure, because it would re-throw in the caller's own `JSON.stringify`.\n */\nexport interface UnserializableValue {\n    '[unserializable]': string;\n}\n\n/**\n * Configuration for {@link filterCirculars}.\n */\nexport interface FilterCircularsOptions<Marker extends string = '[Circular]'> {\n    /** Optional {@link ILogger} used to log stringify or parse errors. */\n    logger?: ILogger;\n    /** Override the circular placeholder. Default is `[Circular]`. */\n    marker?: Marker;\n    /** Processing mode. `json` uses stringify and parse (might end up using a `toJSON()` if found). `decycle` builds a safe clone first. Default is `decycle`. */\n    mode?: 'json' | 'decycle';\n}\n\n/**\n * Creates a clean, JSON safe copy of a value and replaces circular references with a marker.\n *\n * In `json` mode it behaves like stringify then parse with a replacer that handles cycles and BigInt.\n * In `decycle` mode it first clones without using toJSON, then you can stringify the result later.\n *\n * @typeParam ObjType - Type of the input value.\n * @typeParam Marker - Marker string used for circular references.\n *\n * @param value - The value to clone safely.\n * @param options - Optional configuration.\n *\n * @returns A JSON safe structure with circular references replaced by the marker.\n *\n * @example\n * ```ts\n * interface Test {\n *   name: string;\n *   self?: Test;\n * }\n *\n * const obj: Test = { name: 'seedcord' };\n * obj.self = obj;\n *\n * const clean = filterCirculars(obj);\n * //     ^? { name: string; self?: \"[Circular]\" | { ... } }\n * console.log(clean.self); // \"[Circular]\"\n * ```\n */\nexport function filterCirculars<ObjType, Marker extends string = '[Circular]'>(\n    value: ObjType,\n    options?: FilterCircularsOptions<Marker>\n): JsonifyWithCirculars<ObjType, Marker> | UnserializableValue {\n    const logger = options?.logger;\n    const marker = (options?.marker ?? '[Circular]') as Marker;\n    const mode = options?.mode ?? 'decycle';\n\n    if (mode === 'json') return json(value, marker, logger);\n\n    try {\n        return decycle(value, marker);\n    } catch (error) {\n        logger?.error('filterCirculars decycle error', error);\n        return { '[unserializable]': 'decycle failed' };\n    }\n}\n\n/**\n * Attempts to build a JSONified object using JSON.stringify and JSON.parse.\n *\n * @internal\n */\nfunction json<ObjType, Marker extends string>(\n    value: ObjType,\n    marker: Marker,\n    logger?: ILogger\n): JsonifyWithCirculars<ObjType, Marker> | UnserializableValue {\n    const seen = new WeakSet<object>();\n    let json: string | undefined;\n\n    try {\n        json = JSON.stringify(value, (_k: string, v: unknown) => {\n            if (typeof v === 'bigint') return v.toString();\n            if (typeof v === 'object' && v !== null) {\n                const obj = v;\n                if (seen.has(obj)) return marker;\n                seen.add(obj);\n            }\n            return v;\n        });\n    } catch (error) {\n        logger?.error('filterCirculars stringify error', error);\n        if (typeof value === 'object' && value !== null) {\n            logger?.error('top level keys', Object.keys(value));\n        }\n        return { '[unserializable]': 'stringify failed' };\n    }\n\n    if (typeof json !== 'string') {\n        return { '[unserializable]': 'stringify returned undefined' };\n    }\n\n    try {\n        return JSON.parse(json) as JsonifyWithCirculars<ObjType, Marker>;\n    } catch (error) {\n        logger?.error('filterCirculars parse error', error);\n        logger?.error('bad JSON', json);\n        return { '[unserializable]': 'parse failed' };\n    }\n}\n\n/**\n * Builds a JSON safe clone without calling toJSON on class instances.\n *\n * @internal\n */\nfunction decycle<ObjType, Marker extends string = '[Circular]'>(\n    input: ObjType,\n    marker: Marker,\n    seen = new WeakSet<object>()\n): JsonifyWithCirculars<ObjType, Marker> {\n    const recur = (val: unknown): unknown => {\n        if (val === null) return null;\n        const t = typeof val;\n\n        if (t === 'bigint') return (val as bigint).toString();\n        if (t !== 'object') return val;\n\n        const obj = val as Record<string | number | symbol, unknown>;\n\n        if (seen.has(obj)) return marker;\n        seen.add(obj);\n\n        if (obj instanceof Date) return obj.toISOString();\n        if (obj instanceof RegExp) return obj.toString();\n\n        if (Array.isArray(obj)) {\n            return obj.map((item) => recur(item));\n        }\n\n        if (obj instanceof Map) {\n            return Array.from(obj, ([k, v]) => [recur(k), recur(v)]);\n        }\n\n        if (obj instanceof Set) {\n            return Array.from(obj, (v) => recur(v));\n        }\n\n        const out: Record<string, unknown> = {};\n        for (const [k, v] of Object.entries(obj)) {\n            if (typeof v === 'function') continue;\n            out[k] = recur(v);\n        }\n\n        return out;\n    };\n\n    return recur(input) as JsonifyWithCirculars<ObjType, Marker>;\n}\n","import type { UnionToIntersection } from 'type-fest';\n\n/**\n * Extracts the type of a nested property, distributing over unions.\n *\n * @internal\n */\nexport type DeepGet<Obj, Key extends string> = Obj extends unknown\n    ? Key extends `${infer K}.${infer Rest}`\n        ? K extends keyof Obj\n            ? DeepGet<NonNullable<Obj[K]>, Rest>\n            : never\n        : Key extends keyof Obj\n          ? Obj[Key]\n          : never\n    : never;\n\n/**\n * Converts a dot-notation path string into a nested object type with a specific leaf value.\n *\n * @internal\n */\nexport type PathToObj<Path extends string, Value> = Path extends `${infer Head}.${infer Tail}`\n    ? { [K in Head]: PathToObj<Tail, Value> }\n    : { [K in Path]: Value };\n\n/**\n * Checks for the presence of nested keys in an object that's possibly a distributed union, narrowing the object type accordingly.\n *\n * Checks if an object has the specified nested keys and that their values are not null or undefined. If they are not, the object type is narrowed to reflect the presence of these keys with their respective types from the original distributed union object.\n *\n * @param obj - The object to check.\n * @param keys - An array of dot-notation paths to check.\n * @returns True if all keys exist and are non-null/defined, narrowing the object type.\n *\n * @example\n * ```ts\n * interface Test {\n *   a?: {\n *     b?: {\n *       c?: string;\n *     };\n *   } | null;\n *   x?: number | null;\n * }\n *\n * const obj: Test = { a: { b: { c: 'hello' } }, x: 42 };\n *\n * if (hasKeys(obj, ['a.b.c', 'x'])) {\n *   // Here, obj is narrowed to:\n *   // {\n *   //   a: { b: { c: string } };\n *   //   x: number;\n *   // }\n *   console.log(obj.a.b.c.toUpperCase()); // Safe to access and use\n *   console.log(obj.x.toFixed(2)); // Safe to access and use\n * }\n * ```\n */\nexport function hasKeys<Obj extends object, Keys extends string>(\n    obj: Obj,\n    keys: Keys[]\n): obj is Obj &\n    UnionToIntersection<\n        Keys extends unknown ? PathToObj<Keys, UnionToIntersection<NonNullable<DeepGet<Obj, Keys>>>> : never\n    > {\n    return keys.every((key) => {\n        const parts = key.split('.');\n        let current: unknown = obj;\n\n        for (const part of parts) {\n            if (\n                current === null ||\n                current === undefined ||\n                (typeof current !== 'object' && typeof current !== 'function')\n            ) {\n                return false;\n            }\n            if (!(part in current)) {\n                return false;\n            }\n            current = (current as Record<string, unknown>)[part];\n        }\n\n        return current !== null && current !== undefined;\n    });\n}\n","/**\n * Copies only the keys whose values are defined.\n *\n * @typeParam TObject - the original object type you're pulling from\n * @typeParam TKey - the keys to copy when defined\n * @param source - the object to read values from\n * @param keys - optional list of keys to include when present. If omitted, all keys are considered\n *\n * @example\n * ```ts\n * interface Config {\n *   host?: string;\n *   port?: number;\n *   user?: string;\n *   password?: string;\n * }\n *\n * const config: Config = {\n *   host: 'localhost',\n *   port: undefined,\n *   user: 'admin',\n *   password: undefined\n * };\n *\n * const definedConfig = keepDefined(config, 'host', 'port', 'user', 'password');\n * // Result: { host: 'localhost', user: 'admin' }\n * ```\n */\nexport function keepDefined<TObject extends object, TKey extends keyof TObject>(\n    source: TObject,\n    ...keys: readonly TKey[]\n): Partial<Pick<TObject, TKey extends never ? keyof TObject : TKey>> {\n    const selectedKeys = keys.length > 0 ? keys : (Object.keys(source) as TKey[]);\n    const result: Partial<TObject> = {};\n\n    for (const key of selectedKeys) {\n        const value = source[key];\n        if (value !== undefined && value !== null) {\n            result[key] = value;\n        }\n    }\n    return result;\n}\n","/**\n * Returns the word with its first letter capitalized and the rest in lowercase.\n * @param word - The word to be formatted.\n * @returns The formatted word.\n */\nexport function capitalize(word: string): string {\n    return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();\n}\n","/**\n * Function takes an array of strings or numbers and returns the number of characters in the longest string/number\n *\n * @param arr - The array of strings or numbers\n * @returns The length of the longest element when converted to string\n */\nexport function longestStringLength(arr: (string | number)[]): number {\n    return Math.max(...arr.map((el) => el.toString().length));\n}\n","/**\n * Generates an ASCII table from the provided data.\n *\n * @param data - The data to be displayed in the table.\n * @returns The generated ASCII table as a string.\n */\nexport function generateAsciiTable(data: string[][]): string {\n    if (data.length === 0) return '';\n\n    const firstRow = data[0];\n    if (!firstRow || firstRow.length === 0) return '';\n\n    let table = '';\n    const columnWidths: number[] = [];\n\n    // Determine the maximum width for each column\n    for (let i = 0; i < firstRow.length; i++) {\n        let maxWidth = 0;\n        for (const row of data) {\n            const cell = row[i];\n            if (cell !== undefined) maxWidth = Math.max(maxWidth, cell.length);\n        }\n        columnWidths.push(maxWidth);\n    }\n\n    // Function to create a horizontal line\n    const createLine = (char: string, left: string, intersect: string, right: string): string => {\n        let line = left;\n        columnWidths.forEach((width, index) => {\n            line += char.repeat(width + 2);\n            if (index < columnWidths.length - 1) line += intersect;\n            else line += right;\n        });\n        line += '\\n';\n        return line;\n    };\n\n    // Top border\n    table += createLine('═', '╔', '╦', '╗');\n\n    data.forEach((row, rowIndex) => {\n        // Row content\n        table += '║';\n        row.forEach((cell, columnIndex) => {\n            const columnWidth = columnWidths[columnIndex];\n            if (columnWidth !== undefined) table += ` ${cell.padEnd(columnWidth)} ║`;\n        });\n        table += '\\n';\n\n        // Separator or bottom border\n        if (rowIndex < data.length - 1) table += createLine('─', '╠', '╬', '╣');\n        else table += createLine('═', '╚', '╩', '╝');\n    });\n\n    return table;\n}\n","import { capitalize } from './capitalize';\n\n/**\n * Options for the `prettify` function.\n */\nexport interface PrettifyOptions {\n    capitalize?: boolean;\n}\n/**\n * Converts a string from any common naming convention to human-readable format.\n * Accepts camelCase, PascalCase, snake_case, and kebab-case input.\n *\n * @param key - The string to convert\n * @param opts - Optional configuration\n * @returns A space-separated, human-readable string\n *\n * @example\n * prettify(\"camelCaseString\") // \"camel Case String\"\n * prettify(\"PascalCaseString\") // \"Pascal Case String\"\n * prettify(\"snake_case_string\") // \"snake case string\"\n * prettify(\"kebab-case-string\") // \"kebab case string\"\n * prettify(\"mixedCase_string-name\") // \"mixed Case string name\"\n */\n\nexport function prettify(key: string, opts?: PrettifyOptions): string {\n    const result = key\n        .replace(/([a-z])([A-Z])/g, '$1 $2') // camelCase/PascalCase\n        .replace(/[_-]/g, ' ') // snake_case and kebab-case\n        .trim();\n\n    if (opts?.capitalize) return capitalize(result);\n\n    return result;\n}\n","/**\n * Calculates the difference between two numbers and formats it as a string with a '+' prefix for positive differences.\n *\n * @param numBefore - The initial number value\n * @param numAfter - The final number value\n * @returns A string representing the difference, with a '+' sign for positive differences\n *\n * @example\n * // Returns \"+5\"\n * prettyDifference(10, 15);\n *\n * @example\n * // Returns \"-3\"\n * prettyDifference(10, 7);\n */\nexport function prettyDifference(numBefore: number, numAfter: number): string {\n    return (numAfter - numBefore > 0 ? `+${numAfter - numBefore}` : numAfter - numBefore).toString();\n}\n","export * from './misc';\nexport * from './numbers';\nexport * from './objects';\nexport * from './strings';\n\n/** Package version */\nexport const version = process.env.PACKAGE_VERSION ?? '0.0.0';\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,265 +1 @@
-import { Logger } from '@seedcord/services';
-import * as fs from 'node:fs';
-import { TupleOf, JsonPrimitive } from 'type-fest';
-import { ILogger } from '@seedcord/types';
-
-/**
- * Determines if a directory entry is a TypeScript or JavaScript file.
- *
- * @param entry - The directory entry to check.
- * @returns True if the entry is a file ending with .ts or .js.
- */
-declare function isTsOrJsFile(entry: fs.Dirent): boolean;
-/**
- * Recursively traverses through a directory, importing all .ts and .js files and applying a callback to each import.
- *
- * @param dir - The directory path to traverse.
- * @param callback - A function that will be called for each imported module. It receives the full file path, the file's relative path, and the imported module as arguments.
- * @returns A Promise that resolves when the traversal is complete.
- */
-declare function traverseDirectory(dir: string, callback: (fullPath: string, relativePath: string, imported: Record<string, unknown>) => Promise<void> | void, logger: Logger): Promise<void>;
-
-/**
- * Shuffles an array using the Fisher-Yates algorithm.
- * This function creates a new array with the same elements in a random order,
- * without modifying the original array.
- *
- * @typeParam TArray - The type of elements in the array
- * @param items - The array to shuffle
- * @returns A new array with the same elements in a random order
- *
- * @example
- * ```typescript
- * const numbers = [1, 2, 3, 4, 5];
- * const shuffled = fyShuffle(numbers);
- * // shuffled might be [3, 1, 5, 2, 4]
- * // numbers is still [1, 2, 3, 4, 5]
- * ```
- */
-declare function fyShuffle<TArray>(items: TArray[]): TArray[];
-
-/**
- * Return current time in seconds
- */
-declare function currentTime(): number;
-
-/**
- * Generates a random numeric code with the specified number of digits.
- *
- * @param digits - The number of digits for the generated code.
- * @returns A random numeric code with the specified number of digits.
- */
-declare function generateCode(digits: number): number;
-
-/**
- * Converts hexcode to number
- *
- * @param hex - The hex code to convert.
- * @returns The converted number.
- */
-declare function hexToNumber(hex: string): number;
-
-/**
- * Returns the ordinal suffix for a given number.
- *
- * @param n - The number to get the ordinal for
- * @returns The number with its ordinal suffix
- *
- * @example
- * ordinal(1); // "1st"
- * ordinal(22); // "22nd"
- * ordinal(13); // "13th"
- */
-declare function ordinal(n: number): string;
-
-/**
- * Takes two numbers and returns the percentage of the first number in the second number with two decimal places.
- *
- * @param num1 - The first number.
- * @param num2 - The second number.
- *
- * @returns The percentage of the first number in the second number with two decimal places.
- */
-declare function percentage(num1: number, num2: number): number;
-
-/**
- * Rounds a number to a specified number of decimal places.
- *
- * @param num - The number to be rounded.
- * @param precision - The number of decimal places to round to.
- * @returns The rounded number.
- */
-declare function round(num: number, precision: number): number;
-
-interface RoundToDenomOptions {
-    /**
-     * Suffixes to use for each denomination level. Defaults to `['K', 'M', 'B', 'T', 'Q']`.
-     */
-    suffixes?: TupleOf<5, string>;
-    /** Number of decimal places to include in the rounded result. Defaults to `1`. */
-    precision?: number;
-}
-/**
- * Rounds a number to a string representation with a denomination suffix.
- * @param num - The number to round.
- * @example
- * ```ts
- * roundToDenomination(1234); // "1.2K"
- * roundToDenomination(10000, ['k', 'm', 'b', 't', 'q']); // "10k"
- * roundToDenomination(12345678); // "12.3M"
- * ```
- * @returns The rounded number as a string with a denomination suffix.
- */
-declare function roundToDenomination(num: number, opts?: RoundToDenomOptions): string;
-
-/**
- * JSONify an arbitrary type while allowing any object position to be replaced
- * by a circular marker. Optional keys stay optional.
- */
-type JsonifyWithCirculars<BaseType, Marker extends string = '[Circular]'> = BaseType extends JsonPrimitive ? BaseType : BaseType extends bigint ? string : BaseType extends Date ? string : BaseType extends {
-    toJSON(): infer J;
-} ? unknown extends J ? JsonifyObject<BaseType, Marker> : JsonifyWithCirculars<J, Marker> : BaseType extends readonly (infer U)[] ? (JsonifyWithCirculars<U, Marker> | Marker)[] : BaseType extends Map<infer K, infer V> ? [JsonifyWithCirculars<K, Marker> | Marker, JsonifyWithCirculars<V, Marker> | Marker][] : BaseType extends Set<infer U2> ? (JsonifyWithCirculars<U2, Marker> | Marker)[] : BaseType extends (...args: unknown[]) => unknown ? never : BaseType extends object ? JsonifyObject<BaseType, Marker> : never;
-/**
- * Helper to JSONify object types with circular markers.
- *
- * @internal
- */
-type JsonifyObject<BaseType, Marker extends string> = {
-    [K in keyof BaseType as K extends symbol ? never : BaseType[K] extends (...args: unknown[]) => unknown ? never : K]: JsonifyWithCirculars<Exclude<BaseType[K], undefined>, Marker> | Extract<BaseType[K], undefined> | Marker;
-};
-/**
- * Configuration for {@link filterCirculars}.
- */
-interface FilterCircularsOptions<Marker extends string = '[Circular]'> {
-    /** Optional {@link ILogger} used to log stringify or parse errors. */
-    logger?: ILogger;
-    /** Override the circular placeholder. Default is `[Circular]`. */
-    marker?: Marker;
-    /** Processing mode. `json` uses stringify and parse (might end up using a `toJSON()` if found). `decycle` builds a safe clone first. Default is `decycle`. */
-    mode?: 'json' | 'decycle';
-}
-/**
- * Creates a clean, JSON safe copy of a value and replaces circular references with a marker.
- *
- * In `json` mode it behaves like stringify then parse with a replacer that handles cycles and BigInt.
- * In `decycle` mode it first clones without using toJSON, then you can stringify the result later.
- *
- * @typeParam ObjType - Type of the input value.
- * @typeParam Marker - Marker string used for circular references.
- *
- * @param value - The value to clone safely.
- * @param options - Optional configuration.
- *
- * @returns A JSON safe structure with circular references replaced by the marker.
- *
- * @example
- * ```ts
- * interface Test {
- *   name: string;
- *   self?: Test;
- * }
- *
- * const obj: Test = { name: 'seedcord' };
- * obj.self = obj;
- *
- * const clean = filterCirculars(obj);
- * //     ^? { name: string; self?: "[Circular]" | { ... } }
- * console.log(clean.self); // "[Circular]"
- * ```
- */
-declare function filterCirculars<ObjType, Marker extends string = '[Circular]'>(value: ObjType, options?: FilterCircularsOptions<Marker>): JsonifyWithCirculars<ObjType, Marker>;
-
-/**
- * Pulls out only the keys from an object that actually have values.
- *
- * @typeParam TObject - the original object type you're pulling from
- * @typeParam TKey - the specific keys you want to copy if they're defined
- * @param source - the object to read values from
- * @param keys - optional list of keys you want to include if they exist. If omitted, all keys are considered
- *
- * @example
- * ```ts
- * interface Config {
- *   host?: string;
- *   port?: number;
- *   user?: string;
- *   password?: string;
- * }
- *
- * const config: Config = {
- *   host: 'localhost',
- *   port: undefined,
- *   user: 'admin',
- *   password: undefined
- * };
- *
- * const definedConfig = keepDefined(config, 'host', 'port', 'user', 'password');
- * // Result: { host: 'localhost', user: 'admin' }
- * ```
- */
-declare function keepDefined<TObject extends object, TKey extends keyof TObject>(source: TObject, ...keys: readonly TKey[]): Partial<Pick<TObject, TKey extends never ? keyof TObject : TKey>>;
-
-/**
- * Returns the word with its first letter capitalized and the rest in lowercase.
- * @param word - The word to be formatted.
- * @returns The formatted word.
- */
-declare function capitalize(word: string): string;
-
-/**
- * Function takes an array of strings or numbers and returns the number of characters in the longest string/number
- *
- * @param arr - The array of strings or numbers
- * @returns The length of the longest element when converted to string
- */
-declare function longestStringLength(arr: (string | number)[]): number;
-
-/**
- * Generates an ASCII table from the provided data.
- *
- * @param data - The data to be displayed in the table.
- * @returns The generated ASCII table as a string.
- */
-declare function generateAsciiTable(data: string[][]): string;
-
-/**
- * Options for the `prettify` function.
- */
-interface PrettifyOptions {
-    capitalize?: boolean;
-}
-/**
- * Converts a string from any common naming convention to human-readable format.
- * Handles camelCase, PascalCase, snake_case, and kebab-case.
- *
- * @param key - The string to convert
- * @param opts - Optional configuration
- * @returns A space-separated, human-readable string
- *
- * @example
- * prettify("camelCaseString") // "camel Case String"
- * prettify("PascalCaseString") // "Pascal Case String"
- * prettify("snake_case_string") // "snake case string"
- * prettify("kebab-case-string") // "kebab case string"
- * prettify("mixedCase_string-name") // "mixed Case string name"
- */
-declare function prettify(key: string, opts?: PrettifyOptions): string;
-
-/**
- * Calculates the difference between two numbers and formats it as a string with a '+' prefix for positive differences.
- *
- * @param numBefore - The initial number value
- * @param numAfter - The final number value
- * @returns A string representing the difference, with a '+' sign for positive differences
- *
- * @example
- * // Returns "+5"
- * prettyDifference(10, 15);
- *
- * @example
- * // Returns "-3"
- * prettyDifference(10, 7);
- */
-declare function prettyDifference(numBefore: number, numAfter: number): string;
-
-export { type FilterCircularsOptions, type JsonifyObject, type JsonifyWithCirculars, type PrettifyOptions, type RoundToDenomOptions, capitalize, currentTime, filterCirculars, fyShuffle, generateAsciiTable, generateCode, hexToNumber, isTsOrJsFile, keepDefined, longestStringLength, ordinal, percentage, prettify, prettyDifference, round, roundToDenomination, traverseDirectory };
+export type * from './index.d.mts'