@md-oss/common 0.1.6 → 0.1.7

package/dist/strings-jE1j-qqa.d.cts

@@ -0,0 +1,213 @@
+type StringifyArrayOptions<T> = {
+    maxItems: number;
+    maxItemLength?: number;
+    maxTotalLength?: number;
+    stringify: (item: T) => string;
+    prefix?: string;
+    suffix?: string;
+    joinString?: string;
+};
+/**
+ * Truncate a string to a maximum length, adding a suffix if truncated
+ * @param input - String to truncate
+ * @param length - Maximum length
+ * @param suffix - Suffix to add (default: "...")
+ * @returns Truncated string
+ * @example truncate("Hello World", 8) // "Hello..."
+ */
+declare const truncate: (input: string, length: number, suffix?: string) => string;
+/**
+ * Capitalize the first letter of a string
+ * @param input - String to capitalize
+ * @returns Capitalized string
+ * @example capitalize("hello world") // "Hello world"
+ */
+declare const capitalize: (input: string) => string;
+/**
+ * Capitalize the first letter of each word
+ * @param input - String to capitalize
+ * @returns String with each word capitalized
+ * @example capitalizeWords("hello world") // "Hello World"
+ */
+declare const capitalizeWords: (input: string) => string;
+/**
+ * Create a URL-friendly slug from a string
+ * @param input - String to slugify
+ * @returns Slugified string
+ * @example slugify("Hello World!") // "hello-world"
+ */
+declare const slugify: (input: string) => string;
+/**
+ * Escape HTML special characters
+ * @param input - String to escape
+ * @returns Escaped string
+ * @example escapeHtml("<div>Hello</div>") // "&lt;div&gt;Hello&lt;/div&gt;"
+ */
+declare const escapeHtml: (input: string) => string;
+/**
+ * Unescape HTML entities
+ * @param input - String to unescape
+ * @returns Unescaped string
+ * @example unescapeHtml("&lt;div&gt;") // "<div>"
+ */
+declare const unescapeHtml: (input: string) => string;
+/**
+ * Reverse a string
+ * @param input - String to reverse
+ * @returns Reversed string
+ * @example reverse("hello") // "olleh"
+ */
+declare const reverse: (input: string) => string;
+/**
+ * Count occurrences of a substring
+ * @param input - String to search in
+ * @param search - Substring to count
+ * @param caseSensitive - Whether to be case sensitive (default: true)
+ * @returns Number of occurrences
+ * @example countOccurrences("hello hello world", "hello") // 2
+ */
+declare const countOccurrences: (input: string, search: string, caseSensitive?: boolean) => number;
+/**
+ * Check if a string contains only letters
+ * @param input - String to check
+ * @returns True if only letters
+ * @example isAlpha("hello") // true, isAlpha("hello123") // false
+ */
+declare const isAlpha: (input: string) => boolean;
+/**
+ * Check if a string contains only alphanumeric characters
+ * @param input - String to check
+ * @returns True if alphanumeric
+ * @example isAlphanumeric("hello123") // true, isAlphanumeric("hello-123") // false
+ */
+declare const isAlphanumeric: (input: string) => boolean;
+/**
+ * Pad a string to a certain length with a character
+ * @param input - String to pad
+ * @param length - Target length
+ * @param char - Character to pad with (default: " ")
+ * @param direction - Direction to pad ("left", "right", or "both")
+ * @returns Padded string
+ * @example pad("hello", 10, "*", "right") // "hello*****"
+ */
+declare const pad: (input: string, length: number, char?: string, direction?: "left" | "right" | "both") => string;
+/**
+ * Stringify an array with various formatting options
+ * @param arr - Array to stringify
+ * @param options - Formatting options (max items, max length, etc.)
+ * @returns Object with result string and truncation info
+ * @example stringifyArray([1, 2, 3], {maxItems: 2, stringify: String}) // {result: "1, 2", truncatedItems: 1}
+ */
+declare const stringifyArray: <T>(arr: T[], options: StringifyArrayOptions<T>) => {
+    result: string;
+    truncatedItems: number;
+};
+/**
+ * Display array as string with formatting and optional truncation message
+ * @param arr - Array to display
+ * @param options - Display options
+ * @returns Formatted string
+ */
+declare const displayArray: <T>(arr: T[], options: StringifyArrayOptions<T> & {
+    emptyOutput: string;
+}) => string;
+/**
+ * Convert a word to plural form (simple English pluralization)
+ * @param input - Word to pluralize
+ * @param count - Count to determine if plural is needed
+ * @returns Pluralized word
+ * @example pluralize("cat", 2) // "cats", pluralize("cat", 1) // "cat"
+ */
+declare const pluralize: (input: string, count: number) => string;
+/**
+ * Convert string to snake_case
+ * @param input - String to convert
+ * @returns snake_case string
+ * @example snakeCase("helloWorld") // "hello_world"
+ */
+declare const snakeCase: (input: string) => string;
+/**
+ * Convert string to Title Case
+ * @param input - String to convert
+ * @returns Title Case string
+ * @example titleCase("hello world") // "Hello World"
+ */
+declare const titleCase: (input: string) => string;
+/**
+ * Convert string to kebab-case
+ * @param input - String to convert
+ * @returns kebab-case string
+ * @example kebabCase("helloWorld") // "hello-world"
+ */
+declare const kebabCase: (input: string) => string;
+/**
+ * Convert string to camelCase
+ * @param input - String to convert
+ * @returns camelCase string
+ * @example camelCase("hello world") // "helloWorld"
+ */
+declare const camelCase: (input: string) => string;
+/**
+ * Convert string to PascalCase
+ * @param input - String to convert
+ * @returns PascalCase string
+ * @example pascalCase("hello world") // "HelloWorld"
+ */
+declare const pascalCase: (input: string) => string;
+/**
+ * Split a string on uppercase letters
+ * @param input - String to split
+ * @param splitChar - Character to insert (default: " ")
+ * @returns Split string
+ * @example splitOnUppercase("helloWorld") // "hello World"
+ */
+declare const splitOnUppercase: (input: string, splitChar?: string) => string;
+/**
+ * Replace template tags in a string with custom delimiters
+ * @param input - String with template tags
+ * @param placeholders - Object with key-value pairs
+ * @param delimiters - Opening and closing delimiters (default: ["{", "}"])
+ * @returns String with replaced tags
+ * @example replaceTags("Hello {name}!", {name: "World"}) // "Hello World!"
+ * @example replaceTags("Hello {{name}}!", {name: "World"}, ["{{", "}}"])
+ * @example replaceTags("Hello [name]!", {name: "World"}, ["[", "]"])
+ */
+declare const replaceTags: (input: string, placeholders: Record<string, string>, delimiters?: [string, string]) => string;
+/**
+ * Check if a string is a valid URL
+ * @param input - String to check
+ * @returns True if valid URL
+ * @example isUrl("https://example.com") // true
+ */
+declare const isUrl: (input: string) => boolean;
+
+type strings_StringifyArrayOptions<T> = StringifyArrayOptions<T>;
+declare const strings_camelCase: typeof camelCase;
+declare const strings_capitalize: typeof capitalize;
+declare const strings_capitalizeWords: typeof capitalizeWords;
+declare const strings_countOccurrences: typeof countOccurrences;
+declare const strings_displayArray: typeof displayArray;
+declare const strings_escapeHtml: typeof escapeHtml;
+declare const strings_isAlpha: typeof isAlpha;
+declare const strings_isAlphanumeric: typeof isAlphanumeric;
+declare const strings_isUrl: typeof isUrl;
+declare const strings_kebabCase: typeof kebabCase;
+declare const strings_pad: typeof pad;
+declare const strings_pascalCase: typeof pascalCase;
+declare const strings_pluralize: typeof pluralize;
+declare const strings_replaceTags: typeof replaceTags;
+declare const strings_reverse: typeof reverse;
+declare const strings_slugify: typeof slugify;
+declare const strings_snakeCase: typeof snakeCase;
+declare const strings_splitOnUppercase: typeof splitOnUppercase;
+declare const strings_stringifyArray: typeof stringifyArray;
+declare const strings_titleCase: typeof titleCase;
+declare const strings_truncate: typeof truncate;
+declare const strings_unescapeHtml: typeof unescapeHtml;
+declare namespace strings {
+  export { strings_camelCase as camelCase, strings_capitalize as capitalize, strings_capitalizeWords as capitalizeWords, strings_countOccurrences as countOccurrences, strings_displayArray as displayArray, strings_escapeHtml as escapeHtml, strings_isAlpha as isAlpha, strings_isAlphanumeric as isAlphanumeric, strings_isUrl as isUrl, strings_kebabCase as kebabCase, strings_pad as pad, strings_pascalCase as pascalCase, strings_pluralize as pluralize, strings_replaceTags as replaceTags, strings_reverse as reverse, strings_slugify as slugify, strings_snakeCase as snakeCase, strings_splitOnUppercase as splitOnUppercase, strings_stringifyArray as stringifyArray, strings_titleCase as titleCase, strings_truncate as truncate, strings_unescapeHtml as unescapeHtml };
+  export type { strings_StringifyArrayOptions as StringifyArrayOptions };
+}
+
+export { capitalizeWords as a, slugify as b, capitalize as c, countOccurrences as d, escapeHtml as e, isAlphanumeric as f, stringifyArray as g, displayArray as h, isAlpha as i, pluralize as j, snakeCase as k, titleCase as l, kebabCase as m, camelCase as n, pascalCase as o, pad as p, splitOnUppercase as q, reverse as r, strings as s, truncate as t, unescapeHtml as u, replaceTags as v, isUrl as w };
+export type { StringifyArrayOptions as S };

package/dist/strings-jE1j-qqa.d.mts

@@ -0,0 +1,213 @@
+type StringifyArrayOptions<T> = {
+    maxItems: number;
+    maxItemLength?: number;
+    maxTotalLength?: number;
+    stringify: (item: T) => string;
+    prefix?: string;
+    suffix?: string;
+    joinString?: string;
+};
+/**
+ * Truncate a string to a maximum length, adding a suffix if truncated
+ * @param input - String to truncate
+ * @param length - Maximum length
+ * @param suffix - Suffix to add (default: "...")
+ * @returns Truncated string
+ * @example truncate("Hello World", 8) // "Hello..."
+ */
+declare const truncate: (input: string, length: number, suffix?: string) => string;
+/**
+ * Capitalize the first letter of a string
+ * @param input - String to capitalize
+ * @returns Capitalized string
+ * @example capitalize("hello world") // "Hello world"
+ */
+declare const capitalize: (input: string) => string;
+/**
+ * Capitalize the first letter of each word
+ * @param input - String to capitalize
+ * @returns String with each word capitalized
+ * @example capitalizeWords("hello world") // "Hello World"
+ */
+declare const capitalizeWords: (input: string) => string;
+/**
+ * Create a URL-friendly slug from a string
+ * @param input - String to slugify
+ * @returns Slugified string
+ * @example slugify("Hello World!") // "hello-world"
+ */
+declare const slugify: (input: string) => string;
+/**
+ * Escape HTML special characters
+ * @param input - String to escape
+ * @returns Escaped string
+ * @example escapeHtml("<div>Hello</div>") // "&lt;div&gt;Hello&lt;/div&gt;"
+ */
+declare const escapeHtml: (input: string) => string;
+/**
+ * Unescape HTML entities
+ * @param input - String to unescape
+ * @returns Unescaped string
+ * @example unescapeHtml("&lt;div&gt;") // "<div>"
+ */
+declare const unescapeHtml: (input: string) => string;
+/**
+ * Reverse a string
+ * @param input - String to reverse
+ * @returns Reversed string
+ * @example reverse("hello") // "olleh"
+ */
+declare const reverse: (input: string) => string;
+/**
+ * Count occurrences of a substring
+ * @param input - String to search in
+ * @param search - Substring to count
+ * @param caseSensitive - Whether to be case sensitive (default: true)
+ * @returns Number of occurrences
+ * @example countOccurrences("hello hello world", "hello") // 2
+ */
+declare const countOccurrences: (input: string, search: string, caseSensitive?: boolean) => number;
+/**
+ * Check if a string contains only letters
+ * @param input - String to check
+ * @returns True if only letters
+ * @example isAlpha("hello") // true, isAlpha("hello123") // false
+ */
+declare const isAlpha: (input: string) => boolean;
+/**
+ * Check if a string contains only alphanumeric characters
+ * @param input - String to check
+ * @returns True if alphanumeric
+ * @example isAlphanumeric("hello123") // true, isAlphanumeric("hello-123") // false
+ */
+declare const isAlphanumeric: (input: string) => boolean;
+/**
+ * Pad a string to a certain length with a character
+ * @param input - String to pad
+ * @param length - Target length
+ * @param char - Character to pad with (default: " ")
+ * @param direction - Direction to pad ("left", "right", or "both")
+ * @returns Padded string
+ * @example pad("hello", 10, "*", "right") // "hello*****"
+ */
+declare const pad: (input: string, length: number, char?: string, direction?: "left" | "right" | "both") => string;
+/**
+ * Stringify an array with various formatting options
+ * @param arr - Array to stringify
+ * @param options - Formatting options (max items, max length, etc.)
+ * @returns Object with result string and truncation info
+ * @example stringifyArray([1, 2, 3], {maxItems: 2, stringify: String}) // {result: "1, 2", truncatedItems: 1}
+ */
+declare const stringifyArray: <T>(arr: T[], options: StringifyArrayOptions<T>) => {
+    result: string;
+    truncatedItems: number;
+};
+/**
+ * Display array as string with formatting and optional truncation message
+ * @param arr - Array to display
+ * @param options - Display options
+ * @returns Formatted string
+ */
+declare const displayArray: <T>(arr: T[], options: StringifyArrayOptions<T> & {
+    emptyOutput: string;
+}) => string;
+/**
+ * Convert a word to plural form (simple English pluralization)
+ * @param input - Word to pluralize
+ * @param count - Count to determine if plural is needed
+ * @returns Pluralized word
+ * @example pluralize("cat", 2) // "cats", pluralize("cat", 1) // "cat"
+ */
+declare const pluralize: (input: string, count: number) => string;
+/**
+ * Convert string to snake_case
+ * @param input - String to convert
+ * @returns snake_case string
+ * @example snakeCase("helloWorld") // "hello_world"
+ */
+declare const snakeCase: (input: string) => string;
+/**
+ * Convert string to Title Case
+ * @param input - String to convert
+ * @returns Title Case string
+ * @example titleCase("hello world") // "Hello World"
+ */
+declare const titleCase: (input: string) => string;
+/**
+ * Convert string to kebab-case
+ * @param input - String to convert
+ * @returns kebab-case string
+ * @example kebabCase("helloWorld") // "hello-world"
+ */
+declare const kebabCase: (input: string) => string;
+/**
+ * Convert string to camelCase
+ * @param input - String to convert
+ * @returns camelCase string
+ * @example camelCase("hello world") // "helloWorld"
+ */
+declare const camelCase: (input: string) => string;
+/**
+ * Convert string to PascalCase
+ * @param input - String to convert
+ * @returns PascalCase string
+ * @example pascalCase("hello world") // "HelloWorld"
+ */
+declare const pascalCase: (input: string) => string;
+/**
+ * Split a string on uppercase letters
+ * @param input - String to split
+ * @param splitChar - Character to insert (default: " ")
+ * @returns Split string
+ * @example splitOnUppercase("helloWorld") // "hello World"
+ */
+declare const splitOnUppercase: (input: string, splitChar?: string) => string;
+/**
+ * Replace template tags in a string with custom delimiters
+ * @param input - String with template tags
+ * @param placeholders - Object with key-value pairs
+ * @param delimiters - Opening and closing delimiters (default: ["{", "}"])
+ * @returns String with replaced tags
+ * @example replaceTags("Hello {name}!", {name: "World"}) // "Hello World!"
+ * @example replaceTags("Hello {{name}}!", {name: "World"}, ["{{", "}}"])
+ * @example replaceTags("Hello [name]!", {name: "World"}, ["[", "]"])
+ */
+declare const replaceTags: (input: string, placeholders: Record<string, string>, delimiters?: [string, string]) => string;
+/**
+ * Check if a string is a valid URL
+ * @param input - String to check
+ * @returns True if valid URL
+ * @example isUrl("https://example.com") // true
+ */
+declare const isUrl: (input: string) => boolean;
+
+type strings_StringifyArrayOptions<T> = StringifyArrayOptions<T>;
+declare const strings_camelCase: typeof camelCase;
+declare const strings_capitalize: typeof capitalize;
+declare const strings_capitalizeWords: typeof capitalizeWords;
+declare const strings_countOccurrences: typeof countOccurrences;
+declare const strings_displayArray: typeof displayArray;
+declare const strings_escapeHtml: typeof escapeHtml;
+declare const strings_isAlpha: typeof isAlpha;
+declare const strings_isAlphanumeric: typeof isAlphanumeric;
+declare const strings_isUrl: typeof isUrl;
+declare const strings_kebabCase: typeof kebabCase;
+declare const strings_pad: typeof pad;
+declare const strings_pascalCase: typeof pascalCase;
+declare const strings_pluralize: typeof pluralize;
+declare const strings_replaceTags: typeof replaceTags;
+declare const strings_reverse: typeof reverse;
+declare const strings_slugify: typeof slugify;
+declare const strings_snakeCase: typeof snakeCase;
+declare const strings_splitOnUppercase: typeof splitOnUppercase;
+declare const strings_stringifyArray: typeof stringifyArray;
+declare const strings_titleCase: typeof titleCase;
+declare const strings_truncate: typeof truncate;
+declare const strings_unescapeHtml: typeof unescapeHtml;
+declare namespace strings {
+  export { strings_camelCase as camelCase, strings_capitalize as capitalize, strings_capitalizeWords as capitalizeWords, strings_countOccurrences as countOccurrences, strings_displayArray as displayArray, strings_escapeHtml as escapeHtml, strings_isAlpha as isAlpha, strings_isAlphanumeric as isAlphanumeric, strings_isUrl as isUrl, strings_kebabCase as kebabCase, strings_pad as pad, strings_pascalCase as pascalCase, strings_pluralize as pluralize, strings_replaceTags as replaceTags, strings_reverse as reverse, strings_slugify as slugify, strings_snakeCase as snakeCase, strings_splitOnUppercase as splitOnUppercase, strings_stringifyArray as stringifyArray, strings_titleCase as titleCase, strings_truncate as truncate, strings_unescapeHtml as unescapeHtml };
+  export type { strings_StringifyArrayOptions as StringifyArrayOptions };
+}
+
+export { capitalizeWords as a, slugify as b, capitalize as c, countOccurrences as d, escapeHtml as e, isAlphanumeric as f, stringifyArray as g, displayArray as h, isAlpha as i, pluralize as j, snakeCase as k, titleCase as l, kebabCase as m, camelCase as n, pascalCase as o, pad as p, splitOnUppercase as q, reverse as r, strings as s, truncate as t, unescapeHtml as u, replaceTags as v, isUrl as w };
+export type { StringifyArrayOptions as S };

package/dist/time-BrLHgSth.d.mts

@@ -0,0 +1,68 @@
+import { TimeMagic } from './constants/time.mjs';
+
+/**
+ * Convert a timestamp in milliseconds to Unix timestamp (seconds)
+ * @param timestamp - Timestamp in milliseconds
+ * @returns Unix timestamp in seconds
+ * @example unix(1609459200000) // 1609459200
+ */
+declare const unix: (timestamp: number) => number;
+/**
+ * Get current Unix timestamp in seconds
+ * @returns Current Unix timestamp
+ * @example unixNow() // Current time in seconds
+ */
+declare const unixNow: () => number;
+/**
+ * Convert milliseconds to human readable format
+ * @param ms - Milliseconds to format
+ * @param maxParts - Maximum number of time parts to show (default: 2)
+ * @param msDisplay - What to display for very small values (default: "Just now")
+ * @returns Human readable string
+ * @example humanReadableMs(90000) // "1 minute and 30 seconds"
+ * @example humanReadableMs(3600000, 1) // "1 hour"
+ */
+declare const humanReadableMs: (ms: number, maxParts?: number, msDisplay?: string | ((ms: number) => string)) => string;
+/**
+ * Convert high-resolution time to milliseconds
+ * @param hrTime - High-resolution time tuple [seconds, nanoseconds]
+ * @returns Time in milliseconds
+ * @example hrTimeToMs([1, 500000000]) // 1500 (1.5 seconds)
+ */
+declare const hrTimeToMs: (hrTime: [number, number]) => number;
+/**
+ * Convert BigInt duration to human readable string
+ * @param start - Start time from process.hrtime.bigint()
+ * @returns Human readable duration string
+ * @example bigIntDurationToHumanReadable(startTime) // "123.456ms"
+ */
+declare const bigIntDurationToHumanReadable: (start: bigint) => string;
+/**
+ * Calculate average occurrences per interval from an array of dates
+ * @param dates - Array of dates
+ * @param interval - Interval in milliseconds
+ * @returns Average number of occurrences per interval
+ * @example occurrencesPerInterval([date1, date2, date3], 60000) // Avg per minute
+ */
+declare const occurrencesPerInterval: (dates: Date[], interval: number) => number;
+
+declare const time_TimeMagic: typeof TimeMagic;
+declare const time_bigIntDurationToHumanReadable: typeof bigIntDurationToHumanReadable;
+declare const time_hrTimeToMs: typeof hrTimeToMs;
+declare const time_humanReadableMs: typeof humanReadableMs;
+declare const time_occurrencesPerInterval: typeof occurrencesPerInterval;
+declare const time_unix: typeof unix;
+declare const time_unixNow: typeof unixNow;
+declare namespace time {
+  export {
+    time_TimeMagic as TimeMagic,
+    time_bigIntDurationToHumanReadable as bigIntDurationToHumanReadable,
+    time_hrTimeToMs as hrTimeToMs,
+    time_humanReadableMs as humanReadableMs,
+    time_occurrencesPerInterval as occurrencesPerInterval,
+    time_unix as unix,
+    time_unixNow as unixNow,
+  };
+}
+
+export { unixNow as a, hrTimeToMs as b, bigIntDurationToHumanReadable as c, humanReadableMs as h, occurrencesPerInterval as o, time as t, unix as u };

package/dist/time-DmJNWZeL.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"time-DmJNWZeL.mjs","sources":["../src/utils/time.ts"],"sourcesContent":["import { TimeMagic } from '../constants/time';\n\nconst unix = (timestamp: number): number =>\n\tMath.floor(timestamp / TimeMagic.MILLISECONDS_PER_SECOND);\n\nconst unixNow = (): number => unix(Date.now());\n\nconst humanReadableMs = (\n\tms: number,\n\tmaxParts = 2,\n\tmsDisplay: string | ((ms: number) => string) = 'Just now'\n): string => {\n\tconst days = (ms / TimeMagic.MILLISECONDS_PER_DAY) | 0;\n\tconst hours =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_DAY) / TimeMagic.MILLISECONDS_PER_HOUR) |\n\t\t0;\n\tconst minutes =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_HOUR) /\n\t\t\tTimeMagic.MILLISECONDS_PER_MINUTE) |\n\t\t0;\n\tconst seconds =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_MINUTE) /\n\t\t\tTimeMagic.MILLISECONDS_PER_SECOND) |\n\t\t0;\n\n\tconst parts = [];\n\tif (days > 0) parts.push(`${days} day${days === 1 ? '' : 's'}`);\n\tif (hours > 0) parts.push(`${hours} hour${hours === 1 ? '' : 's'}`);\n\tif (minutes > 0) parts.push(`${minutes} minute${minutes === 1 ? '' : 's'}`);\n\tif (seconds > 0) parts.push(`${seconds} second${seconds === 1 ? '' : 's'}`);\n\n\tconst formattedParts = parts.slice(0, maxParts);\n\tconst lastPart = formattedParts.pop();\n\n\tif (formattedParts.length > 0) {\n\t\treturn `${formattedParts.join(', ')}${formattedParts.length > 1 ? ',' : ''} and ${lastPart}`;\n\t} else\n\t\treturn (\n\t\t\tlastPart ?? (typeof msDisplay === 'function' ? msDisplay(ms) : msDisplay)\n\t\t);\n};\n\nconst hrTimeToMs = (hrTime: [number, number]): number =>\n\thrTime[0] * 1e3 + hrTime[1] / 1e6;\n\nconst bigIntDurationToHumanReadable = (start: bigint): string => {\n\tconst end = process.hrtime.bigint();\n\tconst ms = Number(end - start) / 1e6;\n\treturn `${ms.toFixed(3)}ms`;\n};\n\nconst occurrencesPerInterval = (dates: Date[], interval: number): number => {\n\tif (dates.length === 0) return 0;\n\n\tlet totalCount = 0;\n\tlet intervalCount = 0;\n\tconst map: Record<string, number> = {};\n\tconst baseTime = dates[0].getTime();\n\n\t// Iterate through the dates and count them in their respective intervals\n\tfor (const date of dates) {\n\t\tconst timeDiff = date.getTime() - baseTime;\n\t\tconst intervalIndex = Math.floor(timeDiff / interval);\n\n\t\tif (map[intervalIndex]) {\n\t\t\tmap[intervalIndex]++;\n\t\t} else {\n\t\t\tmap[intervalIndex] = 1;\n\t\t}\n\t}\n\n\t// Calculate the total count and number of intervals\n\tfor (const key in map) {\n\t\tconst val = map[key];\n\t\tif (!val) continue;\n\t\ttotalCount += val;\n\t\tintervalCount++;\n\t}\n\n\t// Calculate the average\n\treturn totalCount / intervalCount;\n};\n\nexport {\n\tunix,\n\tunixNow,\n\thumanReadableMs,\n\thrTimeToMs,\n\tbigIntDurationToHumanReadable,\n\toccurrencesPerInterval,\n\tTimeMagic,\n};\n"],"names":["unix","__name","timestamp","TimeMagic","unixNow","humanReadableMs","ms","maxParts","msDisplay","days","hours","minutes","seconds","parts","formattedParts","lastPart","hrTimeToMs","hrTime","bigIntDurationToHumanReadable","start","end","occurrencesPerInterval","dates","interval","totalCount","intervalCount","map","baseTime","date","timeDiff","intervalIndex","key","val"],"mappings":"gIAEA,MAAMA,EAAOC,EAACC,GACb,KAAK,MAAMA,EAAYC,EAAU,uBAAuB,EAD5C,QAGPC,EAAUH,EAAA,IAAcD,EAAK,KAAK,KAAK,EAA7B,WAEVK,EAAkBJ,EAAA,CACvBK,EACAC,EAAW,EACXC,EAA+C,aACnC,CACZ,MAAMC,EAAQH,EAAKH,EAAU,qBAAwB,EAC/CO,EACHJ,EAAKH,EAAU,qBAAwBA,EAAU,sBACnD,EACKQ,EACHL,EAAKH,EAAU,sBAChBA,EAAU,wBACX,EACKS,EACHN,EAAKH,EAAU,wBAChBA,EAAU,wBACX,EAEKU,EAAQ,CAAA,EACVJ,EAAO,GAAGI,EAAM,KAAK,GAAGJ,CAAI,OAAOA,IAAS,EAAI,GAAK,GAAG,EAAE,EAC1DC,EAAQ,GAAGG,EAAM,KAAK,GAAGH,CAAK,QAAQA,IAAU,EAAI,GAAK,GAAG,EAAE,EAC9DC,EAAU,GAAGE,EAAM,KAAK,GAAGF,CAAO,UAAUA,IAAY,EAAI,GAAK,GAAG,EAAE,EACtEC,EAAU,GAAGC,EAAM,KAAK,GAAGD,CAAO,UAAUA,IAAY,EAAI,GAAK,GAAG,EAAE,EAE1E,MAAME,EAAiBD,EAAM,MAAM,EAAGN,CAAQ,EACxCQ,EAAWD,EAAe,IAAA,EAEhC,OAAIA,EAAe,OAAS,EACpB,GAAGA,EAAe,KAAK,IAAI,CAAC,GAAGA,EAAe,OAAS,EAAI,IAAM,EAAE,QAAQC,CAAQ,GAGzFA,IAAa,OAAOP,GAAc,WAAaA,EAAUF,CAAE,EAAIE,EAElE,EAjCwB,mBAmClBQ,EAAaf,EAACgB,GACnBA,EAAO,CAAC,EAAI,IAAMA,EAAO,CAAC,EAAI,IADZ,cAGbC,EAAgCjB,EAACkB,GAA0B,CAChE,MAAMC,EAAM,QAAQ,OAAO,OAAA,EAE3B,MAAO,IADI,OAAOA,EAAMD,CAAK,EAAI,KACpB,QAAQ,CAAC,CAAC,IACxB,EAJsC,iCAMhCE,EAAyBpB,EAAA,CAACqB,EAAeC,IAA6B,CAC3E,GAAID,EAAM,SAAW,EAAG,MAAO,GAE/B,IAAIE,EAAa,EACbC,EAAgB,EACpB,MAAMC,EAA8B,CAAA,EAC9BC,EAAWL,EAAM,CAAC,EAAE,QAAA,EAG1B,UAAWM,KAAQN,EAAO,CACzB,MAAMO,EAAWD,EAAK,QAAA,EAAYD,EAC5BG,EAAgB,KAAK,MAAMD,EAAWN,CAAQ,EAEhDG,EAAII,CAAa,EACpBJ,EAAII,CAAa,IAEjBJ,EAAII,CAAa,EAAI,CAEvB,CAGA,UAAWC,KAAOL,EAAK,CACtB,MAAMM,EAAMN,EAAIK,CAAG,EACdC,IACLR,GAAcQ,EACdP,IACD,CAGA,OAAOD,EAAaC,CACrB,EA9B+B"}
+{"version":3,"file":"time-DmJNWZeL.mjs","sources":["../src/utils/time.ts"],"sourcesContent":["import { TimeMagic } from '../constants/time';\n\n/**\n * Convert a timestamp in milliseconds to Unix timestamp (seconds)\n * @param timestamp - Timestamp in milliseconds\n * @returns Unix timestamp in seconds\n * @example unix(1609459200000) // 1609459200\n */\nconst unix = (timestamp: number): number =>\n\tMath.floor(timestamp / TimeMagic.MILLISECONDS_PER_SECOND);\n\n/**\n * Get current Unix timestamp in seconds\n * @returns Current Unix timestamp\n * @example unixNow() // Current time in seconds\n */\nconst unixNow = (): number => unix(Date.now());\n\n/**\n * Convert milliseconds to human readable format\n * @param ms - Milliseconds to format\n * @param maxParts - Maximum number of time parts to show (default: 2)\n * @param msDisplay - What to display for very small values (default: \"Just now\")\n * @returns Human readable string\n * @example humanReadableMs(90000) // \"1 minute and 30 seconds\"\n * @example humanReadableMs(3600000, 1) // \"1 hour\"\n */\nconst humanReadableMs = (\n\tms: number,\n\tmaxParts = 2,\n\tmsDisplay: string | ((ms: number) => string) = 'Just now'\n): string => {\n\tconst days = (ms / TimeMagic.MILLISECONDS_PER_DAY) | 0;\n\tconst hours =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_DAY) / TimeMagic.MILLISECONDS_PER_HOUR) |\n\t\t0;\n\tconst minutes =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_HOUR) /\n\t\t\tTimeMagic.MILLISECONDS_PER_MINUTE) |\n\t\t0;\n\tconst seconds =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_MINUTE) /\n\t\t\tTimeMagic.MILLISECONDS_PER_SECOND) |\n\t\t0;\n\n\tconst parts = [];\n\tif (days > 0) parts.push(`${days} day${days === 1 ? '' : 's'}`);\n\tif (hours > 0) parts.push(`${hours} hour${hours === 1 ? '' : 's'}`);\n\tif (minutes > 0) parts.push(`${minutes} minute${minutes === 1 ? '' : 's'}`);\n\tif (seconds > 0) parts.push(`${seconds} second${seconds === 1 ? '' : 's'}`);\n\n\tconst formattedParts = parts.slice(0, maxParts);\n\tconst lastPart = formattedParts.pop();\n\n\tif (formattedParts.length > 0) {\n\t\treturn `${formattedParts.join(', ')}${formattedParts.length > 1 ? ',' : ''} and ${lastPart}`;\n\t} else\n\t\treturn (\n\t\t\tlastPart ?? (typeof msDisplay === 'function' ? msDisplay(ms) : msDisplay)\n\t\t);\n};\n\n/**\n * Convert high-resolution time to milliseconds\n * @param hrTime - High-resolution time tuple [seconds, nanoseconds]\n * @returns Time in milliseconds\n * @example hrTimeToMs([1, 500000000]) // 1500 (1.5 seconds)\n */\nconst hrTimeToMs = (hrTime: [number, number]): number =>\n\thrTime[0] * 1e3 + hrTime[1] / 1e6;\n\n/**\n * Convert BigInt duration to human readable string\n * @param start - Start time from process.hrtime.bigint()\n * @returns Human readable duration string\n * @example bigIntDurationToHumanReadable(startTime) // \"123.456ms\"\n */\nconst bigIntDurationToHumanReadable = (start: bigint): string => {\n\tconst end = process.hrtime.bigint();\n\tconst ms = Number(end - start) / 1e6;\n\treturn `${ms.toFixed(3)}ms`;\n};\n\n/**\n * Calculate average occurrences per interval from an array of dates\n * @param dates - Array of dates\n * @param interval - Interval in milliseconds\n * @returns Average number of occurrences per interval\n * @example occurrencesPerInterval([date1, date2, date3], 60000) // Avg per minute\n */\nconst occurrencesPerInterval = (dates: Date[], interval: number): number => {\n\tif (dates.length === 0) return 0;\n\n\tlet totalCount = 0;\n\tlet intervalCount = 0;\n\tconst map: Record<string, number> = {};\n\tconst baseTime = dates[0].getTime();\n\n\t// Iterate through the dates and count them in their respective intervals\n\tfor (const date of dates) {\n\t\tconst timeDiff = date.getTime() - baseTime;\n\t\tconst intervalIndex = Math.floor(timeDiff / interval);\n\n\t\tif (map[intervalIndex]) {\n\t\t\tmap[intervalIndex]++;\n\t\t} else {\n\t\t\tmap[intervalIndex] = 1;\n\t\t}\n\t}\n\n\t// Calculate the total count and number of intervals\n\tfor (const key in map) {\n\t\tconst val = map[key];\n\t\tif (!val) continue;\n\t\ttotalCount += val;\n\t\tintervalCount++;\n\t}\n\n\t// Calculate the average\n\treturn totalCount / intervalCount;\n};\n\nexport {\n\tunix,\n\tunixNow,\n\thumanReadableMs,\n\thrTimeToMs,\n\tbigIntDurationToHumanReadable,\n\toccurrencesPerInterval,\n\tTimeMagic,\n};\n"],"names":["unix","__name","timestamp","TimeMagic","unixNow","humanReadableMs","ms","maxParts","msDisplay","days","hours","minutes","seconds","parts","formattedParts","lastPart","hrTimeToMs","hrTime","bigIntDurationToHumanReadable","start","end","occurrencesPerInterval","dates","interval","totalCount","intervalCount","map","baseTime","date","timeDiff","intervalIndex","key","val"],"mappings":"gIAQA,MAAMA,EAAOC,EAACC,GACb,KAAK,MAAMA,EAAYC,EAAU,uBAAuB,EAD5C,QAQPC,EAAUH,EAAA,IAAcD,EAAK,KAAK,KAAK,EAA7B,WAWVK,EAAkBJ,EAAA,CACvBK,EACAC,EAAW,EACXC,EAA+C,aACnC,CACZ,MAAMC,EAAQH,EAAKH,EAAU,qBAAwB,EAC/CO,EACHJ,EAAKH,EAAU,qBAAwBA,EAAU,sBACnD,EACKQ,EACHL,EAAKH,EAAU,sBAChBA,EAAU,wBACX,EACKS,EACHN,EAAKH,EAAU,wBAChBA,EAAU,wBACX,EAEKU,EAAQ,CAAA,EACVJ,EAAO,GAAGI,EAAM,KAAK,GAAGJ,CAAI,OAAOA,IAAS,EAAI,GAAK,GAAG,EAAE,EAC1DC,EAAQ,GAAGG,EAAM,KAAK,GAAGH,CAAK,QAAQA,IAAU,EAAI,GAAK,GAAG,EAAE,EAC9DC,EAAU,GAAGE,EAAM,KAAK,GAAGF,CAAO,UAAUA,IAAY,EAAI,GAAK,GAAG,EAAE,EACtEC,EAAU,GAAGC,EAAM,KAAK,GAAGD,CAAO,UAAUA,IAAY,EAAI,GAAK,GAAG,EAAE,EAE1E,MAAME,EAAiBD,EAAM,MAAM,EAAGN,CAAQ,EACxCQ,EAAWD,EAAe,IAAA,EAEhC,OAAIA,EAAe,OAAS,EACpB,GAAGA,EAAe,KAAK,IAAI,CAAC,GAAGA,EAAe,OAAS,EAAI,IAAM,EAAE,QAAQC,CAAQ,GAGzFA,IAAa,OAAOP,GAAc,WAAaA,EAAUF,CAAE,EAAIE,EAElE,EAjCwB,mBAyClBQ,EAAaf,EAACgB,GACnBA,EAAO,CAAC,EAAI,IAAMA,EAAO,CAAC,EAAI,IADZ,cASbC,EAAgCjB,EAACkB,GAA0B,CAChE,MAAMC,EAAM,QAAQ,OAAO,OAAA,EAE3B,MAAO,IADI,OAAOA,EAAMD,CAAK,EAAI,KACpB,QAAQ,CAAC,CAAC,IACxB,EAJsC,iCAahCE,EAAyBpB,EAAA,CAACqB,EAAeC,IAA6B,CAC3E,GAAID,EAAM,SAAW,EAAG,MAAO,GAE/B,IAAIE,EAAa,EACbC,EAAgB,EACpB,MAAMC,EAA8B,CAAA,EAC9BC,EAAWL,EAAM,CAAC,EAAE,QAAA,EAG1B,UAAWM,KAAQN,EAAO,CACzB,MAAMO,EAAWD,EAAK,QAAA,EAAYD,EAC5BG,EAAgB,KAAK,MAAMD,EAAWN,CAAQ,EAEhDG,EAAII,CAAa,EACpBJ,EAAII,CAAa,IAEjBJ,EAAII,CAAa,EAAI,CAEvB,CAGA,UAAWC,KAAOL,EAAK,CACtB,MAAMM,EAAMN,EAAIK,CAAG,EACdC,IACLR,GAAcQ,EACdP,IACD,CAGA,OAAOD,EAAaC,CACrB,EA9B+B"}

package/dist/time-ufhllID1.d.cts

@@ -0,0 +1,68 @@
+import { TimeMagic } from './constants/time.cjs';
+
+/**
+ * Convert a timestamp in milliseconds to Unix timestamp (seconds)
+ * @param timestamp - Timestamp in milliseconds
+ * @returns Unix timestamp in seconds
+ * @example unix(1609459200000) // 1609459200
+ */
+declare const unix: (timestamp: number) => number;
+/**
+ * Get current Unix timestamp in seconds
+ * @returns Current Unix timestamp
+ * @example unixNow() // Current time in seconds
+ */
+declare const unixNow: () => number;
+/**
+ * Convert milliseconds to human readable format
+ * @param ms - Milliseconds to format
+ * @param maxParts - Maximum number of time parts to show (default: 2)
+ * @param msDisplay - What to display for very small values (default: "Just now")
+ * @returns Human readable string
+ * @example humanReadableMs(90000) // "1 minute and 30 seconds"
+ * @example humanReadableMs(3600000, 1) // "1 hour"
+ */
+declare const humanReadableMs: (ms: number, maxParts?: number, msDisplay?: string | ((ms: number) => string)) => string;
+/**
+ * Convert high-resolution time to milliseconds
+ * @param hrTime - High-resolution time tuple [seconds, nanoseconds]
+ * @returns Time in milliseconds
+ * @example hrTimeToMs([1, 500000000]) // 1500 (1.5 seconds)
+ */
+declare const hrTimeToMs: (hrTime: [number, number]) => number;
+/**
+ * Convert BigInt duration to human readable string
+ * @param start - Start time from process.hrtime.bigint()
+ * @returns Human readable duration string
+ * @example bigIntDurationToHumanReadable(startTime) // "123.456ms"
+ */
+declare const bigIntDurationToHumanReadable: (start: bigint) => string;
+/**
+ * Calculate average occurrences per interval from an array of dates
+ * @param dates - Array of dates
+ * @param interval - Interval in milliseconds
+ * @returns Average number of occurrences per interval
+ * @example occurrencesPerInterval([date1, date2, date3], 60000) // Avg per minute
+ */
+declare const occurrencesPerInterval: (dates: Date[], interval: number) => number;
+
+declare const time_TimeMagic: typeof TimeMagic;
+declare const time_bigIntDurationToHumanReadable: typeof bigIntDurationToHumanReadable;
+declare const time_hrTimeToMs: typeof hrTimeToMs;
+declare const time_humanReadableMs: typeof humanReadableMs;
+declare const time_occurrencesPerInterval: typeof occurrencesPerInterval;
+declare const time_unix: typeof unix;
+declare const time_unixNow: typeof unixNow;
+declare namespace time {
+  export {
+    time_TimeMagic as TimeMagic,
+    time_bigIntDurationToHumanReadable as bigIntDurationToHumanReadable,
+    time_hrTimeToMs as hrTimeToMs,
+    time_humanReadableMs as humanReadableMs,
+    time_occurrencesPerInterval as occurrencesPerInterval,
+    time_unix as unix,
+    time_unixNow as unixNow,
+  };
+}
+
+export { unixNow as a, hrTimeToMs as b, bigIntDurationToHumanReadable as c, humanReadableMs as h, occurrencesPerInterval as o, time as t, unix as u };

package/dist/time-yNkQSJnQ.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"time-yNkQSJnQ.cjs","sources":["../src/utils/time.ts"],"sourcesContent":["import { TimeMagic } from '../constants/time';\n\nconst unix = (timestamp: number): number =>\n\tMath.floor(timestamp / TimeMagic.MILLISECONDS_PER_SECOND);\n\nconst unixNow = (): number => unix(Date.now());\n\nconst humanReadableMs = (\n\tms: number,\n\tmaxParts = 2,\n\tmsDisplay: string | ((ms: number) => string) = 'Just now'\n): string => {\n\tconst days = (ms / TimeMagic.MILLISECONDS_PER_DAY) | 0;\n\tconst hours =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_DAY) / TimeMagic.MILLISECONDS_PER_HOUR) |\n\t\t0;\n\tconst minutes =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_HOUR) /\n\t\t\tTimeMagic.MILLISECONDS_PER_MINUTE) |\n\t\t0;\n\tconst seconds =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_MINUTE) /\n\t\t\tTimeMagic.MILLISECONDS_PER_SECOND) |\n\t\t0;\n\n\tconst parts = [];\n\tif (days > 0) parts.push(`${days} day${days === 1 ? '' : 's'}`);\n\tif (hours > 0) parts.push(`${hours} hour${hours === 1 ? '' : 's'}`);\n\tif (minutes > 0) parts.push(`${minutes} minute${minutes === 1 ? '' : 's'}`);\n\tif (seconds > 0) parts.push(`${seconds} second${seconds === 1 ? '' : 's'}`);\n\n\tconst formattedParts = parts.slice(0, maxParts);\n\tconst lastPart = formattedParts.pop();\n\n\tif (formattedParts.length > 0) {\n\t\treturn `${formattedParts.join(', ')}${formattedParts.length > 1 ? ',' : ''} and ${lastPart}`;\n\t} else\n\t\treturn (\n\t\t\tlastPart ?? (typeof msDisplay === 'function' ? msDisplay(ms) : msDisplay)\n\t\t);\n};\n\nconst hrTimeToMs = (hrTime: [number, number]): number =>\n\thrTime[0] * 1e3 + hrTime[1] / 1e6;\n\nconst bigIntDurationToHumanReadable = (start: bigint): string => {\n\tconst end = process.hrtime.bigint();\n\tconst ms = Number(end - start) / 1e6;\n\treturn `${ms.toFixed(3)}ms`;\n};\n\nconst occurrencesPerInterval = (dates: Date[], interval: number): number => {\n\tif (dates.length === 0) return 0;\n\n\tlet totalCount = 0;\n\tlet intervalCount = 0;\n\tconst map: Record<string, number> = {};\n\tconst baseTime = dates[0].getTime();\n\n\t// Iterate through the dates and count them in their respective intervals\n\tfor (const date of dates) {\n\t\tconst timeDiff = date.getTime() - baseTime;\n\t\tconst intervalIndex = Math.floor(timeDiff / interval);\n\n\t\tif (map[intervalIndex]) {\n\t\t\tmap[intervalIndex]++;\n\t\t} else {\n\t\t\tmap[intervalIndex] = 1;\n\t\t}\n\t}\n\n\t// Calculate the total count and number of intervals\n\tfor (const key in map) {\n\t\tconst val = map[key];\n\t\tif (!val) continue;\n\t\ttotalCount += val;\n\t\tintervalCount++;\n\t}\n\n\t// Calculate the average\n\treturn totalCount / intervalCount;\n};\n\nexport {\n\tunix,\n\tunixNow,\n\thumanReadableMs,\n\thrTimeToMs,\n\tbigIntDurationToHumanReadable,\n\toccurrencesPerInterval,\n\tTimeMagic,\n};\n"],"names":["unix","__name","timestamp","TimeMagic","unixNow","humanReadableMs","ms","maxParts","msDisplay","days","hours","minutes","seconds","parts","formattedParts","lastPart","hrTimeToMs","hrTime","bigIntDurationToHumanReadable","start","end","occurrencesPerInterval","dates","interval","totalCount","intervalCount","map","baseTime","date","timeDiff","intervalIndex","key","val"],"mappings":"kIAEA,MAAMA,EAAOC,EAACC,GACb,KAAK,MAAMA,EAAYC,EAAAA,UAAU,uBAAuB,EAD5C,QAGPC,EAAUH,EAAA,IAAcD,EAAK,KAAK,KAAK,EAA7B,WAEVK,EAAkBJ,EAAA,CACvBK,EACAC,EAAW,EACXC,EAA+C,aACnC,CACZ,MAAMC,EAAQH,EAAKH,EAAAA,UAAU,qBAAwB,EAC/CO,EACHJ,EAAKH,EAAAA,UAAU,qBAAwBA,EAAAA,UAAU,sBACnD,EACKQ,EACHL,EAAKH,EAAAA,UAAU,sBAChBA,EAAAA,UAAU,wBACX,EACKS,EACHN,EAAKH,EAAAA,UAAU,wBAChBA,EAAAA,UAAU,wBACX,EAEKU,EAAQ,CAAA,EACVJ,EAAO,GAAGI,EAAM,KAAK,GAAGJ,CAAI,OAAOA,IAAS,EAAI,GAAK,GAAG,EAAE,EAC1DC,EAAQ,GAAGG,EAAM,KAAK,GAAGH,CAAK,QAAQA,IAAU,EAAI,GAAK,GAAG,EAAE,EAC9DC,EAAU,GAAGE,EAAM,KAAK,GAAGF,CAAO,UAAUA,IAAY,EAAI,GAAK,GAAG,EAAE,EACtEC,EAAU,GAAGC,EAAM,KAAK,GAAGD,CAAO,UAAUA,IAAY,EAAI,GAAK,GAAG,EAAE,EAE1E,MAAME,EAAiBD,EAAM,MAAM,EAAGN,CAAQ,EACxCQ,EAAWD,EAAe,IAAA,EAEhC,OAAIA,EAAe,OAAS,EACpB,GAAGA,EAAe,KAAK,IAAI,CAAC,GAAGA,EAAe,OAAS,EAAI,IAAM,EAAE,QAAQC,CAAQ,GAGzFA,IAAa,OAAOP,GAAc,WAAaA,EAAUF,CAAE,EAAIE,EAElE,EAjCwB,mBAmClBQ,EAAaf,EAACgB,GACnBA,EAAO,CAAC,EAAI,IAAMA,EAAO,CAAC,EAAI,IADZ,cAGbC,EAAgCjB,EAACkB,GAA0B,CAChE,MAAMC,EAAM,QAAQ,OAAO,OAAA,EAE3B,MAAO,IADI,OAAOA,EAAMD,CAAK,EAAI,KACpB,QAAQ,CAAC,CAAC,IACxB,EAJsC,iCAMhCE,EAAyBpB,EAAA,CAACqB,EAAeC,IAA6B,CAC3E,GAAID,EAAM,SAAW,EAAG,MAAO,GAE/B,IAAIE,EAAa,EACbC,EAAgB,EACpB,MAAMC,EAA8B,CAAA,EAC9BC,EAAWL,EAAM,CAAC,EAAE,QAAA,EAG1B,UAAWM,KAAQN,EAAO,CACzB,MAAMO,EAAWD,EAAK,QAAA,EAAYD,EAC5BG,EAAgB,KAAK,MAAMD,EAAWN,CAAQ,EAEhDG,EAAII,CAAa,EACpBJ,EAAII,CAAa,IAEjBJ,EAAII,CAAa,EAAI,CAEvB,CAGA,UAAWC,KAAOL,EAAK,CACtB,MAAMM,EAAMN,EAAIK,CAAG,EACdC,IACLR,GAAcQ,EACdP,IACD,CAGA,OAAOD,EAAaC,CACrB,EA9B+B"}
+{"version":3,"file":"time-yNkQSJnQ.cjs","sources":["../src/utils/time.ts"],"sourcesContent":["import { TimeMagic } from '../constants/time';\n\n/**\n * Convert a timestamp in milliseconds to Unix timestamp (seconds)\n * @param timestamp - Timestamp in milliseconds\n * @returns Unix timestamp in seconds\n * @example unix(1609459200000) // 1609459200\n */\nconst unix = (timestamp: number): number =>\n\tMath.floor(timestamp / TimeMagic.MILLISECONDS_PER_SECOND);\n\n/**\n * Get current Unix timestamp in seconds\n * @returns Current Unix timestamp\n * @example unixNow() // Current time in seconds\n */\nconst unixNow = (): number => unix(Date.now());\n\n/**\n * Convert milliseconds to human readable format\n * @param ms - Milliseconds to format\n * @param maxParts - Maximum number of time parts to show (default: 2)\n * @param msDisplay - What to display for very small values (default: \"Just now\")\n * @returns Human readable string\n * @example humanReadableMs(90000) // \"1 minute and 30 seconds\"\n * @example humanReadableMs(3600000, 1) // \"1 hour\"\n */\nconst humanReadableMs = (\n\tms: number,\n\tmaxParts = 2,\n\tmsDisplay: string | ((ms: number) => string) = 'Just now'\n): string => {\n\tconst days = (ms / TimeMagic.MILLISECONDS_PER_DAY) | 0;\n\tconst hours =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_DAY) / TimeMagic.MILLISECONDS_PER_HOUR) |\n\t\t0;\n\tconst minutes =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_HOUR) /\n\t\t\tTimeMagic.MILLISECONDS_PER_MINUTE) |\n\t\t0;\n\tconst seconds =\n\t\t((ms % TimeMagic.MILLISECONDS_PER_MINUTE) /\n\t\t\tTimeMagic.MILLISECONDS_PER_SECOND) |\n\t\t0;\n\n\tconst parts = [];\n\tif (days > 0) parts.push(`${days} day${days === 1 ? '' : 's'}`);\n\tif (hours > 0) parts.push(`${hours} hour${hours === 1 ? '' : 's'}`);\n\tif (minutes > 0) parts.push(`${minutes} minute${minutes === 1 ? '' : 's'}`);\n\tif (seconds > 0) parts.push(`${seconds} second${seconds === 1 ? '' : 's'}`);\n\n\tconst formattedParts = parts.slice(0, maxParts);\n\tconst lastPart = formattedParts.pop();\n\n\tif (formattedParts.length > 0) {\n\t\treturn `${formattedParts.join(', ')}${formattedParts.length > 1 ? ',' : ''} and ${lastPart}`;\n\t} else\n\t\treturn (\n\t\t\tlastPart ?? (typeof msDisplay === 'function' ? msDisplay(ms) : msDisplay)\n\t\t);\n};\n\n/**\n * Convert high-resolution time to milliseconds\n * @param hrTime - High-resolution time tuple [seconds, nanoseconds]\n * @returns Time in milliseconds\n * @example hrTimeToMs([1, 500000000]) // 1500 (1.5 seconds)\n */\nconst hrTimeToMs = (hrTime: [number, number]): number =>\n\thrTime[0] * 1e3 + hrTime[1] / 1e6;\n\n/**\n * Convert BigInt duration to human readable string\n * @param start - Start time from process.hrtime.bigint()\n * @returns Human readable duration string\n * @example bigIntDurationToHumanReadable(startTime) // \"123.456ms\"\n */\nconst bigIntDurationToHumanReadable = (start: bigint): string => {\n\tconst end = process.hrtime.bigint();\n\tconst ms = Number(end - start) / 1e6;\n\treturn `${ms.toFixed(3)}ms`;\n};\n\n/**\n * Calculate average occurrences per interval from an array of dates\n * @param dates - Array of dates\n * @param interval - Interval in milliseconds\n * @returns Average number of occurrences per interval\n * @example occurrencesPerInterval([date1, date2, date3], 60000) // Avg per minute\n */\nconst occurrencesPerInterval = (dates: Date[], interval: number): number => {\n\tif (dates.length === 0) return 0;\n\n\tlet totalCount = 0;\n\tlet intervalCount = 0;\n\tconst map: Record<string, number> = {};\n\tconst baseTime = dates[0].getTime();\n\n\t// Iterate through the dates and count them in their respective intervals\n\tfor (const date of dates) {\n\t\tconst timeDiff = date.getTime() - baseTime;\n\t\tconst intervalIndex = Math.floor(timeDiff / interval);\n\n\t\tif (map[intervalIndex]) {\n\t\t\tmap[intervalIndex]++;\n\t\t} else {\n\t\t\tmap[intervalIndex] = 1;\n\t\t}\n\t}\n\n\t// Calculate the total count and number of intervals\n\tfor (const key in map) {\n\t\tconst val = map[key];\n\t\tif (!val) continue;\n\t\ttotalCount += val;\n\t\tintervalCount++;\n\t}\n\n\t// Calculate the average\n\treturn totalCount / intervalCount;\n};\n\nexport {\n\tunix,\n\tunixNow,\n\thumanReadableMs,\n\thrTimeToMs,\n\tbigIntDurationToHumanReadable,\n\toccurrencesPerInterval,\n\tTimeMagic,\n};\n"],"names":["unix","__name","timestamp","TimeMagic","unixNow","humanReadableMs","ms","maxParts","msDisplay","days","hours","minutes","seconds","parts","formattedParts","lastPart","hrTimeToMs","hrTime","bigIntDurationToHumanReadable","start","end","occurrencesPerInterval","dates","interval","totalCount","intervalCount","map","baseTime","date","timeDiff","intervalIndex","key","val"],"mappings":"kIAQA,MAAMA,EAAOC,EAACC,GACb,KAAK,MAAMA,EAAYC,EAAAA,UAAU,uBAAuB,EAD5C,QAQPC,EAAUH,EAAA,IAAcD,EAAK,KAAK,KAAK,EAA7B,WAWVK,EAAkBJ,EAAA,CACvBK,EACAC,EAAW,EACXC,EAA+C,aACnC,CACZ,MAAMC,EAAQH,EAAKH,EAAAA,UAAU,qBAAwB,EAC/CO,EACHJ,EAAKH,EAAAA,UAAU,qBAAwBA,EAAAA,UAAU,sBACnD,EACKQ,EACHL,EAAKH,EAAAA,UAAU,sBAChBA,EAAAA,UAAU,wBACX,EACKS,EACHN,EAAKH,EAAAA,UAAU,wBAChBA,EAAAA,UAAU,wBACX,EAEKU,EAAQ,CAAA,EACVJ,EAAO,GAAGI,EAAM,KAAK,GAAGJ,CAAI,OAAOA,IAAS,EAAI,GAAK,GAAG,EAAE,EAC1DC,EAAQ,GAAGG,EAAM,KAAK,GAAGH,CAAK,QAAQA,IAAU,EAAI,GAAK,GAAG,EAAE,EAC9DC,EAAU,GAAGE,EAAM,KAAK,GAAGF,CAAO,UAAUA,IAAY,EAAI,GAAK,GAAG,EAAE,EACtEC,EAAU,GAAGC,EAAM,KAAK,GAAGD,CAAO,UAAUA,IAAY,EAAI,GAAK,GAAG,EAAE,EAE1E,MAAME,EAAiBD,EAAM,MAAM,EAAGN,CAAQ,EACxCQ,EAAWD,EAAe,IAAA,EAEhC,OAAIA,EAAe,OAAS,EACpB,GAAGA,EAAe,KAAK,IAAI,CAAC,GAAGA,EAAe,OAAS,EAAI,IAAM,EAAE,QAAQC,CAAQ,GAGzFA,IAAa,OAAOP,GAAc,WAAaA,EAAUF,CAAE,EAAIE,EAElE,EAjCwB,mBAyClBQ,EAAaf,EAACgB,GACnBA,EAAO,CAAC,EAAI,IAAMA,EAAO,CAAC,EAAI,IADZ,cASbC,EAAgCjB,EAACkB,GAA0B,CAChE,MAAMC,EAAM,QAAQ,OAAO,OAAA,EAE3B,MAAO,IADI,OAAOA,EAAMD,CAAK,EAAI,KACpB,QAAQ,CAAC,CAAC,IACxB,EAJsC,iCAahCE,EAAyBpB,EAAA,CAACqB,EAAeC,IAA6B,CAC3E,GAAID,EAAM,SAAW,EAAG,MAAO,GAE/B,IAAIE,EAAa,EACbC,EAAgB,EACpB,MAAMC,EAA8B,CAAA,EAC9BC,EAAWL,EAAM,CAAC,EAAE,QAAA,EAG1B,UAAWM,KAAQN,EAAO,CACzB,MAAMO,EAAWD,EAAK,QAAA,EAAYD,EAC5BG,EAAgB,KAAK,MAAMD,EAAWN,CAAQ,EAEhDG,EAAII,CAAa,EACpBJ,EAAII,CAAa,IAEjBJ,EAAII,CAAa,EAAI,CAEvB,CAGA,UAAWC,KAAOL,EAAK,CACtB,MAAMM,EAAMN,EAAIK,CAAG,EACdC,IACLR,GAAcQ,EACdP,IACD,CAGA,OAAOD,EAAaC,CACrB,EA9B+B"}

package/dist/utils/arrays.cjs

@@ -1,2 +1,2 @@
-"use strict";require("../strings-DV446vv-.cjs");var r=require("../arrays-DaB1Xn47.cjs");exports.chunk=r.chunk,exports.isBooleanArray=r.isBooleanArray,exports.isNumberArray=r.isNumberArray,exports.isObjectArray=r.isObjectArray,exports.isStringArray=r.isStringArray,exports.join=r.join;
+"use strict";require("../strings-_1vAPvzS.cjs");var r=require("../arrays-bgbansWs.cjs");exports.chunk=r.chunk,exports.difference=r.difference,exports.flatten=r.flatten,exports.flattenDeep=r.flattenDeep,exports.groupBy=r.groupBy,exports.intersection=r.intersection,exports.isBooleanArray=r.isBooleanArray,exports.isNumberArray=r.isNumberArray,exports.isObjectArray=r.isObjectArray,exports.isStringArray=r.isStringArray,exports.join=r.join,exports.partition=r.partition,exports.shuffle=r.shuffle,exports.union=r.union,exports.unique=r.unique,exports.uniqueBy=r.uniqueBy;
 //# sourceMappingURL=arrays.cjs.map

package/dist/utils/arrays.d.cts

@@ -1 +1 @@
-export { J as JoinOptions, c as chunk, d as isBooleanArray, b as isNumberArray, e as isObjectArray, i as isStringArray, j as join } from '../arrays-CElcW69H.cjs';
+export { J as JoinOptions, c as chunk, e as difference, f as flatten, d as flattenDeep, h as groupBy, i as intersection, m as isBooleanArray, l as isNumberArray, n as isObjectArray, k as isStringArray, j as join, p as partition, s as shuffle, g as union, u as unique, b as uniqueBy } from '../arrays-DvPJ1GeR.cjs';

package/dist/utils/arrays.d.mts

@@ -1 +1 @@
-export { J as JoinOptions, c as chunk, d as isBooleanArray, b as isNumberArray, e as isObjectArray, i as isStringArray, j as join } from '../arrays-CElcW69H.mjs';
+export { J as JoinOptions, c as chunk, e as difference, f as flatten, d as flattenDeep, h as groupBy, i as intersection, m as isBooleanArray, l as isNumberArray, n as isObjectArray, k as isStringArray, j as join, p as partition, s as shuffle, g as union, u as unique, b as uniqueBy } from '../arrays-DvPJ1GeR.mjs';

package/dist/utils/arrays.mjs

@@ -1,2 +1,2 @@
-import"../strings-B0BRwNX9.mjs";import{c as i,d as o,b as e,e as n,i as t,j as y}from"../arrays-BkHBzTDO.mjs";export{i as chunk,o as isBooleanArray,e as isNumberArray,n as isObjectArray,t as isStringArray,y as join};
+import"../strings-CrzGdnZH.mjs";import{c as r,e as i,f as n,d as t,h as o,i as u,m as f,l as p,n as y,k as c,j as l,p as m,s as A,g as b,u as g,b as h}from"../arrays-6DA6GfsQ.mjs";export{r as chunk,i as difference,n as flatten,t as flattenDeep,o as groupBy,u as intersection,f as isBooleanArray,p as isNumberArray,y as isObjectArray,c as isStringArray,l as join,m as partition,A as shuffle,b as union,g as unique,h as uniqueBy};
 //# sourceMappingURL=arrays.mjs.map

package/dist/utils/index.cjs

@@ -1,2 +1,2 @@
-"use strict";var r=require("../arrays-DaB1Xn47.cjs"),i=require("../mime-types-BmvBrrZ7.cjs"),e=require("../numbers-Du__2-8Y.cjs"),s=require("../objects-CnGoVkh6.cjs"),t=require("../random-D1e1NTOt.cjs"),u=require("../runtime-peVFcWot.cjs"),m=require("../strings-DV446vv-.cjs"),a=require("../time-yNkQSJnQ.cjs");require("../constants/time.cjs"),exports.ArrayUtils=r.arrays,exports.MimeTypeUtils=i.mimeTypes,exports.NumberUtils=e.numbers,exports.ObjectUtils=s.objects,exports.RandomUtils=t.random,exports.RuntimeUtils=u.runtime,exports.StringUtils=m.strings,exports.TimeUtils=a.time;
+"use strict";var r=require("../arrays-bgbansWs.cjs"),e=require("../files-m1nnj5gT.cjs"),i=require("../mime-types-BmvBrrZ7.cjs"),s=require("../numbers-B_mptknO.cjs"),t=require("../objects-wcO6hNA8.cjs"),u=require("../random-668tofPV.cjs"),l=require("../runtime-Bfs-yn_-.cjs"),a=require("../strings-_1vAPvzS.cjs"),m=require("../time-yNkQSJnQ.cjs");require("node:fs"),require("node:path"),require("../constants/bytes.cjs"),require("../constants/time.cjs"),exports.ArrayUtils=r.arrays,exports.FileUtils=e.files,exports.MimeTypeUtils=i.mimeTypes,exports.NumberUtils=s.numbers,exports.ObjectUtils=t.objects,exports.RandomUtils=u.random,exports.RuntimeUtils=l.runtime,exports.StringUtils=a.strings,exports.TimeUtils=m.time;
 //# sourceMappingURL=index.cjs.map