@choksheak/ts-utils 0.2.8 → 0.3.0

package/duration.d.mts

@@ -0,0 +1,78 @@
+/**
+ * Bunch of miscellaneous constants and utility functions related to handling
+ * date and time durations.
+ *
+ * Note that month and year do not have fixed durations, and hence are excluded
+ * from this file. Weeks have fixed durations, but are excluded because we
+ * use days as the max duration supported.
+ */
+type Duration = {
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+    milliseconds?: number;
+};
+/**
+ * One of: days, hours, minutes, seconds, milliseconds
+ */
+type DurationType = keyof Duration;
+/**
+ * Order in which the duration type appears in the duration string.
+ */
+declare const DURATION_TYPE_SEQUENCE: DurationType[];
+/**
+ * Follows the same format as Intl.DurationFormat.prototype.format().
+ *
+ * Short: 1 yr, 2 mths, 3 wks, 3 days, 4 hr, 5 min, 6 sec, 7 ms, 8 μs, 9 ns
+ * Long: 1 year, 2 months, 3 weeks, 3 days, 4 hours, 5 minutes, 6 seconds,
+ *       7 milliseconds, 8 microseconds, 9 nanoseconds
+ * Narrow: 1y 2mo 3w 3d 4h 5m 6s 7ms 8μs 9ns
+ */
+type DurationStyle = "short" | "long" | "narrow";
+type DurationSuffixMap = {
+    short: string;
+    shorts: string;
+    long: string;
+    longs: string;
+    narrow: string;
+};
+type DurationSuffixType = keyof DurationSuffixMap;
+declare const DURATION_STYLE_SUFFIX_MAP: Record<DurationType, DurationSuffixMap>;
+/**
+ * Convert a milliseconds duration into a Duration object. If the given ms is
+ * zero, then return an object with a single field of zero with duration type
+ * of durationTypeForZero.
+ *
+ * @param durationTypeForZero Defaults to 'milliseconds'
+ */
+declare function msToDuration(ms: number, durationTypeForZero?: DurationType): Duration;
+/**
+ * Returns the number of milliseconds for the given duration.
+ */
+declare function durationToMs(duration: Duration): number;
+/**
+ * Convenience function to return a duration given an ms or Duration.
+ */
+declare function durationOrMsToMs(duration: number | Duration): number;
+/**
+ * Format a given Duration object into a string. If the object has no fields,
+ * then returns an empty string.
+ *
+ * @param style Defaults to 'short'
+ */
+declare function formatDuration(duration: Duration, style?: DurationStyle): string;
+/**
+ * Convert a millisecond duration into a human-readable duration string.
+ *
+ * @param options.durationTypeForZero - Defaults to 'milliseconds'
+ * @param options.style - Defaults to 'short'
+ */
+declare function readableDuration(ms: number, options?: {
+    durationTypeForZero?: DurationType;
+    style?: DurationStyle;
+}): string;
+/** A shortened duration string useful for logging timings. */
+declare function elapsed(ms: number): string;
+
+export { DURATION_STYLE_SUFFIX_MAP, DURATION_TYPE_SEQUENCE, type Duration, type DurationStyle, type DurationSuffixMap, type DurationSuffixType, type DurationType, durationOrMsToMs, durationToMs, elapsed, formatDuration, msToDuration, readableDuration };

package/duration.min.cjs

@@ -0,0 +1,2 @@
+"use strict";var c=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var P=(o,n)=>{for(var t in n)c(o,t,{get:n[t],enumerable:!0})},T=(o,n,t,e)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of y(n))!g.call(o,r)&&r!==t&&c(o,r,{get:()=>n[r],enumerable:!(e=R(n,r))||e.enumerable});return o};var U=o=>T(c({},"__esModule",{value:!0}),o);var H={};P(H,{DURATION_STYLE_SUFFIX_MAP:()=>D,DURATION_TYPE_SEQUENCE:()=>S,durationOrMsToMs:()=>w,durationToMs:()=>x,elapsed:()=>C,formatDuration:()=>M,msToDuration:()=>m,readableDuration:()=>d});module.exports=U(H);var S=["days","hours","minutes","seconds","milliseconds"],D={days:{short:"day",shorts:"days",long:"day",longs:"days",narrow:"d"},hours:{short:"hr",shorts:"hrs",long:"hour",longs:"hours",narrow:"h"},minutes:{short:"min",shorts:"mins",long:"minute",longs:"minutes",narrow:"m"},seconds:{short:"sec",shorts:"secs",long:"second",longs:"seconds",narrow:"s"},milliseconds:{short:"ms",shorts:"ms",long:"millisecond",longs:"milliseconds",narrow:"ms"}};function b(o){return o=="short"?"shorts":o==="long"?"longs":o}function I(o){return o==="narrow"?"":" "}function A(o){return o==="narrow"?" ":", "}function m(o,n){if(o===0)return n=n??"milliseconds",{[n]:0};let t={};for(let e=0;e<1;e++){let r=Math.floor(o/1e3),u=o-r*1e3;if(u>0&&(t.milliseconds=u),r===0)break;let i=Math.floor(r/60);if(r-=i*60,r>0&&(t.seconds=r),i===0)break;let s=Math.floor(i/60);if(i-=s*60,i>0&&(t.minutes=i),s===0)break;let a=Math.floor(s/24);s-=a*24,s>0&&(t.hours=s),a>0&&(t.days=a)}return t}function x(o){let n=(o.days??0)*864e5,t=(o.hours??0)*36e5,e=(o.minutes??0)*6e4,r=(o.seconds??0)*1e3,u=o.milliseconds??0;return n+t+e+r+u}function w(o){return typeof o=="number"?o:x(o)}function M(o,n){n=n??"short";let t=b(n),e=I(n),r=[];for(let i of S){let s=o[i];if(s===void 0)continue;let a=D[i],h=s===1?a[n]:a[t];r.push(s+e+h)}let u=A(n);return r.join(u)}function d(o,n){let t=m(o,n?.durationTypeForZero);return M(t,n?.style)}function C(o){return o>6e4?d(o):o>100?`${(o/1e3).toFixed(3)}s`:o+"ms"}0&&(module.exports={DURATION_STYLE_SUFFIX_MAP,DURATION_TYPE_SEQUENCE,durationOrMsToMs,durationToMs,elapsed,formatDuration,msToDuration,readableDuration});
+//# sourceMappingURL=duration.min.cjs.map

package/duration.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/duration.ts"],"sourcesContent":["/**\n * Bunch of miscellaneous constants and utility functions related to handling\n * date and time durations.\n *\n * Note that month and year do not have fixed durations, and hence are excluded\n * from this file. Weeks have fixed durations, but are excluded because we\n * use days as the max duration supported.\n */\n\nimport {\n  HOURS_PER_DAY,\n  MINUTES_PER_HOUR,\n  MS_PER_DAY,\n  MS_PER_HOUR,\n  MS_PER_MINUTE,\n  MS_PER_SECOND,\n  SECONDS_PER_MINUTE,\n} from \"./timeConstants\";\n\nexport type Duration = {\n  days?: number;\n  hours?: number;\n  minutes?: number;\n  seconds?: number;\n  milliseconds?: number;\n};\n\n/**\n * One of: days, hours, minutes, seconds, milliseconds\n */\nexport type DurationType = keyof Duration;\n\n/**\n * Order in which the duration type appears in the duration string.\n */\nexport const DURATION_TYPE_SEQUENCE: DurationType[] = [\n  \"days\",\n  \"hours\",\n  \"minutes\",\n  \"seconds\",\n  \"milliseconds\",\n];\n\n/**\n * Follows the same format as Intl.DurationFormat.prototype.format().\n *\n * Short: 1 yr, 2 mths, 3 wks, 3 days, 4 hr, 5 min, 6 sec, 7 ms, 8 μs, 9 ns\n * Long: 1 year, 2 months, 3 weeks, 3 days, 4 hours, 5 minutes, 6 seconds,\n *       7 milliseconds, 8 microseconds, 9 nanoseconds\n * Narrow: 1y 2mo 3w 3d 4h 5m 6s 7ms 8μs 9ns\n */\nexport type DurationStyle = \"short\" | \"long\" | \"narrow\";\n\nexport type DurationSuffixMap = {\n  short: string;\n  shorts: string;\n  long: string;\n  longs: string;\n  narrow: string;\n};\n\nexport type DurationSuffixType = keyof DurationSuffixMap;\n\nexport const DURATION_STYLE_SUFFIX_MAP: Record<\n  DurationType,\n  DurationSuffixMap\n> = {\n  days: {\n    short: \"day\",\n    shorts: \"days\",\n    long: \"day\",\n    longs: \"days\",\n    narrow: \"d\",\n  },\n  hours: {\n    short: \"hr\",\n    shorts: \"hrs\",\n    long: \"hour\",\n    longs: \"hours\",\n    narrow: \"h\",\n  },\n  minutes: {\n    short: \"min\",\n    shorts: \"mins\",\n    long: \"minute\",\n    longs: \"minutes\",\n    narrow: \"m\",\n  },\n  seconds: {\n    short: \"sec\",\n    shorts: \"secs\",\n    long: \"second\",\n    longs: \"seconds\",\n    narrow: \"s\",\n  },\n  milliseconds: {\n    short: \"ms\",\n    shorts: \"ms\",\n    long: \"millisecond\",\n    longs: \"milliseconds\",\n    narrow: \"ms\",\n  },\n};\n\nfunction getDurationStyleForPlural(style: DurationStyle): DurationSuffixType {\n  return style == \"short\" ? \"shorts\" : style === \"long\" ? \"longs\" : style;\n}\n\nfunction getValueAndUnitSeparator(style: DurationStyle): string {\n  return style === \"narrow\" ? \"\" : \" \";\n}\n\nfunction getDurationTypeSeparator(style: DurationStyle): string {\n  return style === \"narrow\" ? \" \" : \", \";\n}\n\n/**\n * Convert a milliseconds duration into a Duration object. If the given ms is\n * zero, then return an object with a single field of zero with duration type\n * of durationTypeForZero.\n *\n * @param durationTypeForZero Defaults to 'milliseconds'\n */\nexport function msToDuration(\n  ms: number,\n  durationTypeForZero?: DurationType,\n): Duration {\n  if (ms === 0) {\n    durationTypeForZero = durationTypeForZero ?? \"milliseconds\";\n    return { [durationTypeForZero]: 0 };\n  }\n\n  const duration: Duration = {};\n\n  for (let i = 0; i < 1; i++) {\n    let seconds = Math.floor(ms / MS_PER_SECOND);\n    const millis = ms - seconds * MS_PER_SECOND;\n\n    if (millis > 0) {\n      duration[\"milliseconds\"] = millis;\n    }\n\n    if (seconds === 0) {\n      break;\n    }\n\n    let minutes = Math.floor(seconds / SECONDS_PER_MINUTE);\n    seconds -= minutes * SECONDS_PER_MINUTE;\n\n    if (seconds > 0) {\n      duration[\"seconds\"] = seconds;\n    }\n\n    if (minutes === 0) {\n      break;\n    }\n\n    let hours = Math.floor(minutes / MINUTES_PER_HOUR);\n    minutes -= hours * MINUTES_PER_HOUR;\n\n    if (minutes > 0) {\n      duration[\"minutes\"] = minutes;\n    }\n\n    if (hours === 0) {\n      break;\n    }\n\n    const days = Math.floor(hours / HOURS_PER_DAY);\n    hours -= days * HOURS_PER_DAY;\n\n    if (hours > 0) {\n      duration[\"hours\"] = hours;\n    }\n\n    if (days > 0) {\n      duration[\"days\"] = days;\n    }\n  }\n\n  return duration;\n}\n\n/**\n * Returns the number of milliseconds for the given duration.\n */\nexport function durationToMs(duration: Duration): number {\n  const daysMs = (duration.days ?? 0) * MS_PER_DAY;\n  const hoursMs = (duration.hours ?? 0) * MS_PER_HOUR;\n  const minsMs = (duration.minutes ?? 0) * MS_PER_MINUTE;\n  const secsMs = (duration.seconds ?? 0) * MS_PER_SECOND;\n  const msMs = duration.milliseconds ?? 0;\n\n  return daysMs + hoursMs + minsMs + secsMs + msMs;\n}\n\n/**\n * Convenience function to return a duration given an ms or Duration.\n */\nexport function durationOrMsToMs(duration: number | Duration): number {\n  return typeof duration === \"number\" ? duration : durationToMs(duration);\n}\n\n/**\n * Format a given Duration object into a string. If the object has no fields,\n * then returns an empty string.\n *\n * @param style Defaults to 'short'\n */\nexport function formatDuration(duration: Duration, style?: DurationStyle) {\n  style = style ?? \"short\";\n  const stylePlural = getDurationStyleForPlural(style);\n\n  const space = getValueAndUnitSeparator(style);\n\n  const a: string[] = [];\n\n  for (const unit of DURATION_TYPE_SEQUENCE) {\n    const value = duration[unit];\n    if (value === undefined) continue;\n\n    const suffixMap = DURATION_STYLE_SUFFIX_MAP[unit];\n    const suffix = value === 1 ? suffixMap[style] : suffixMap[stylePlural];\n    a.push(value + space + suffix);\n  }\n\n  const separator = getDurationTypeSeparator(style);\n  return a.join(separator);\n}\n\n/**\n * Convert a millisecond duration into a human-readable duration string.\n *\n * @param options.durationTypeForZero - Defaults to 'milliseconds'\n * @param options.style - Defaults to 'short'\n */\nexport function readableDuration(\n  ms: number,\n  options?: { durationTypeForZero?: DurationType; style?: DurationStyle },\n): string {\n  const duration = msToDuration(ms, options?.durationTypeForZero);\n\n  return formatDuration(duration, options?.style);\n}\n\n/** A shortened duration string useful for logging timings. */\nexport function elapsed(ms: number): string {\n  // Use long format for 1 minute or over.\n  if (ms > MS_PER_MINUTE) {\n    return readableDuration(ms);\n  }\n\n  // Use seconds format for over 100ms.\n  if (ms > 100) {\n    return `${(ms / 1000).toFixed(3)}s`;\n  }\n\n  // Use milliseconds format.\n  return ms + \"ms\";\n}\n"],"mappings":"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","names":["duration_exports","__export","DURATION_STYLE_SUFFIX_MAP","DURATION_TYPE_SEQUENCE","durationOrMsToMs","durationToMs","elapsed","formatDuration","msToDuration","readableDuration","__toCommonJS","DURATION_TYPE_SEQUENCE","DURATION_STYLE_SUFFIX_MAP","getDurationStyleForPlural","style","getValueAndUnitSeparator","getDurationTypeSeparator","msToDuration","ms","durationTypeForZero","duration","i","seconds","millis","minutes","hours","days","durationToMs","daysMs","hoursMs","minsMs","secsMs","msMs","durationOrMsToMs","formatDuration","stylePlural","space","a","unit","value","suffixMap","suffix","separator","readableDuration","options","elapsed"]}

package/duration.min.mjs

@@ -0,0 +1,2 @@
+var m=["days","hours","minutes","seconds","milliseconds"],x={days:{short:"day",shorts:"days",long:"day",longs:"days",narrow:"d"},hours:{short:"hr",shorts:"hrs",long:"hour",longs:"hours",narrow:"h"},minutes:{short:"min",shorts:"mins",long:"minute",longs:"minutes",narrow:"m"},seconds:{short:"sec",shorts:"secs",long:"second",longs:"seconds",narrow:"s"},milliseconds:{short:"ms",shorts:"ms",long:"millisecond",longs:"milliseconds",narrow:"ms"}};function M(o){return o=="short"?"shorts":o==="long"?"longs":o}function d(o){return o==="narrow"?"":" "}function h(o){return o==="narrow"?" ":", "}function R(o,n){if(o===0)return n=n??"milliseconds",{[n]:0};let t={};for(let i=0;i<1;i++){let r=Math.floor(o/1e3),u=o-r*1e3;if(u>0&&(t.milliseconds=u),r===0)break;let e=Math.floor(r/60);if(r-=e*60,r>0&&(t.seconds=r),e===0)break;let s=Math.floor(e/60);if(e-=s*60,e>0&&(t.minutes=e),s===0)break;let a=Math.floor(s/24);s-=a*24,s>0&&(t.hours=s),a>0&&(t.days=a)}return t}function y(o){let n=(o.days??0)*864e5,t=(o.hours??0)*36e5,i=(o.minutes??0)*6e4,r=(o.seconds??0)*1e3,u=o.milliseconds??0;return n+t+i+r+u}function N(o){return typeof o=="number"?o:y(o)}function g(o,n){n=n??"short";let t=M(n),i=d(n),r=[];for(let e of m){let s=o[e];if(s===void 0)continue;let a=x[e],f=s===1?a[n]:a[t];r.push(s+i+f)}let u=h(n);return r.join(u)}function P(o,n){let t=R(o,n?.durationTypeForZero);return g(t,n?.style)}function O(o){return o>6e4?P(o):o>100?`${(o/1e3).toFixed(3)}s`:o+"ms"}export{x as DURATION_STYLE_SUFFIX_MAP,m as DURATION_TYPE_SEQUENCE,N as durationOrMsToMs,y as durationToMs,O as elapsed,g as formatDuration,R as msToDuration,P as readableDuration};
+//# sourceMappingURL=duration.min.mjs.map

package/duration.min.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/duration.ts"],"sourcesContent":["/**\n * Bunch of miscellaneous constants and utility functions related to handling\n * date and time durations.\n *\n * Note that month and year do not have fixed durations, and hence are excluded\n * from this file. Weeks have fixed durations, but are excluded because we\n * use days as the max duration supported.\n */\n\nimport {\n  HOURS_PER_DAY,\n  MINUTES_PER_HOUR,\n  MS_PER_DAY,\n  MS_PER_HOUR,\n  MS_PER_MINUTE,\n  MS_PER_SECOND,\n  SECONDS_PER_MINUTE,\n} from \"./timeConstants\";\n\nexport type Duration = {\n  days?: number;\n  hours?: number;\n  minutes?: number;\n  seconds?: number;\n  milliseconds?: number;\n};\n\n/**\n * One of: days, hours, minutes, seconds, milliseconds\n */\nexport type DurationType = keyof Duration;\n\n/**\n * Order in which the duration type appears in the duration string.\n */\nexport const DURATION_TYPE_SEQUENCE: DurationType[] = [\n  \"days\",\n  \"hours\",\n  \"minutes\",\n  \"seconds\",\n  \"milliseconds\",\n];\n\n/**\n * Follows the same format as Intl.DurationFormat.prototype.format().\n *\n * Short: 1 yr, 2 mths, 3 wks, 3 days, 4 hr, 5 min, 6 sec, 7 ms, 8 μs, 9 ns\n * Long: 1 year, 2 months, 3 weeks, 3 days, 4 hours, 5 minutes, 6 seconds,\n *       7 milliseconds, 8 microseconds, 9 nanoseconds\n * Narrow: 1y 2mo 3w 3d 4h 5m 6s 7ms 8μs 9ns\n */\nexport type DurationStyle = \"short\" | \"long\" | \"narrow\";\n\nexport type DurationSuffixMap = {\n  short: string;\n  shorts: string;\n  long: string;\n  longs: string;\n  narrow: string;\n};\n\nexport type DurationSuffixType = keyof DurationSuffixMap;\n\nexport const DURATION_STYLE_SUFFIX_MAP: Record<\n  DurationType,\n  DurationSuffixMap\n> = {\n  days: {\n    short: \"day\",\n    shorts: \"days\",\n    long: \"day\",\n    longs: \"days\",\n    narrow: \"d\",\n  },\n  hours: {\n    short: \"hr\",\n    shorts: \"hrs\",\n    long: \"hour\",\n    longs: \"hours\",\n    narrow: \"h\",\n  },\n  minutes: {\n    short: \"min\",\n    shorts: \"mins\",\n    long: \"minute\",\n    longs: \"minutes\",\n    narrow: \"m\",\n  },\n  seconds: {\n    short: \"sec\",\n    shorts: \"secs\",\n    long: \"second\",\n    longs: \"seconds\",\n    narrow: \"s\",\n  },\n  milliseconds: {\n    short: \"ms\",\n    shorts: \"ms\",\n    long: \"millisecond\",\n    longs: \"milliseconds\",\n    narrow: \"ms\",\n  },\n};\n\nfunction getDurationStyleForPlural(style: DurationStyle): DurationSuffixType {\n  return style == \"short\" ? \"shorts\" : style === \"long\" ? \"longs\" : style;\n}\n\nfunction getValueAndUnitSeparator(style: DurationStyle): string {\n  return style === \"narrow\" ? \"\" : \" \";\n}\n\nfunction getDurationTypeSeparator(style: DurationStyle): string {\n  return style === \"narrow\" ? \" \" : \", \";\n}\n\n/**\n * Convert a milliseconds duration into a Duration object. If the given ms is\n * zero, then return an object with a single field of zero with duration type\n * of durationTypeForZero.\n *\n * @param durationTypeForZero Defaults to 'milliseconds'\n */\nexport function msToDuration(\n  ms: number,\n  durationTypeForZero?: DurationType,\n): Duration {\n  if (ms === 0) {\n    durationTypeForZero = durationTypeForZero ?? \"milliseconds\";\n    return { [durationTypeForZero]: 0 };\n  }\n\n  const duration: Duration = {};\n\n  for (let i = 0; i < 1; i++) {\n    let seconds = Math.floor(ms / MS_PER_SECOND);\n    const millis = ms - seconds * MS_PER_SECOND;\n\n    if (millis > 0) {\n      duration[\"milliseconds\"] = millis;\n    }\n\n    if (seconds === 0) {\n      break;\n    }\n\n    let minutes = Math.floor(seconds / SECONDS_PER_MINUTE);\n    seconds -= minutes * SECONDS_PER_MINUTE;\n\n    if (seconds > 0) {\n      duration[\"seconds\"] = seconds;\n    }\n\n    if (minutes === 0) {\n      break;\n    }\n\n    let hours = Math.floor(minutes / MINUTES_PER_HOUR);\n    minutes -= hours * MINUTES_PER_HOUR;\n\n    if (minutes > 0) {\n      duration[\"minutes\"] = minutes;\n    }\n\n    if (hours === 0) {\n      break;\n    }\n\n    const days = Math.floor(hours / HOURS_PER_DAY);\n    hours -= days * HOURS_PER_DAY;\n\n    if (hours > 0) {\n      duration[\"hours\"] = hours;\n    }\n\n    if (days > 0) {\n      duration[\"days\"] = days;\n    }\n  }\n\n  return duration;\n}\n\n/**\n * Returns the number of milliseconds for the given duration.\n */\nexport function durationToMs(duration: Duration): number {\n  const daysMs = (duration.days ?? 0) * MS_PER_DAY;\n  const hoursMs = (duration.hours ?? 0) * MS_PER_HOUR;\n  const minsMs = (duration.minutes ?? 0) * MS_PER_MINUTE;\n  const secsMs = (duration.seconds ?? 0) * MS_PER_SECOND;\n  const msMs = duration.milliseconds ?? 0;\n\n  return daysMs + hoursMs + minsMs + secsMs + msMs;\n}\n\n/**\n * Convenience function to return a duration given an ms or Duration.\n */\nexport function durationOrMsToMs(duration: number | Duration): number {\n  return typeof duration === \"number\" ? duration : durationToMs(duration);\n}\n\n/**\n * Format a given Duration object into a string. If the object has no fields,\n * then returns an empty string.\n *\n * @param style Defaults to 'short'\n */\nexport function formatDuration(duration: Duration, style?: DurationStyle) {\n  style = style ?? \"short\";\n  const stylePlural = getDurationStyleForPlural(style);\n\n  const space = getValueAndUnitSeparator(style);\n\n  const a: string[] = [];\n\n  for (const unit of DURATION_TYPE_SEQUENCE) {\n    const value = duration[unit];\n    if (value === undefined) continue;\n\n    const suffixMap = DURATION_STYLE_SUFFIX_MAP[unit];\n    const suffix = value === 1 ? suffixMap[style] : suffixMap[stylePlural];\n    a.push(value + space + suffix);\n  }\n\n  const separator = getDurationTypeSeparator(style);\n  return a.join(separator);\n}\n\n/**\n * Convert a millisecond duration into a human-readable duration string.\n *\n * @param options.durationTypeForZero - Defaults to 'milliseconds'\n * @param options.style - Defaults to 'short'\n */\nexport function readableDuration(\n  ms: number,\n  options?: { durationTypeForZero?: DurationType; style?: DurationStyle },\n): string {\n  const duration = msToDuration(ms, options?.durationTypeForZero);\n\n  return formatDuration(duration, options?.style);\n}\n\n/** A shortened duration string useful for logging timings. */\nexport function elapsed(ms: number): string {\n  // Use long format for 1 minute or over.\n  if (ms > MS_PER_MINUTE) {\n    return readableDuration(ms);\n  }\n\n  // Use seconds format for over 100ms.\n  if (ms > 100) {\n    return `${(ms / 1000).toFixed(3)}s`;\n  }\n\n  // Use milliseconds format.\n  return ms + \"ms\";\n}\n"],"mappings":"AAmCO,IAAMA,EAAyC,CACpD,OACA,QACA,UACA,UACA,cACF,EAsBaC,EAGT,CACF,KAAM,CACJ,MAAO,MACP,OAAQ,OACR,KAAM,MACN,MAAO,OACP,OAAQ,GACV,EACA,MAAO,CACL,MAAO,KACP,OAAQ,MACR,KAAM,OACN,MAAO,QACP,OAAQ,GACV,EACA,QAAS,CACP,MAAO,MACP,OAAQ,OACR,KAAM,SACN,MAAO,UACP,OAAQ,GACV,EACA,QAAS,CACP,MAAO,MACP,OAAQ,OACR,KAAM,SACN,MAAO,UACP,OAAQ,GACV,EACA,aAAc,CACZ,MAAO,KACP,OAAQ,KACR,KAAM,cACN,MAAO,eACP,OAAQ,IACV,CACF,EAEA,SAASC,EAA0BC,EAA0C,CAC3E,OAAOA,GAAS,QAAU,SAAWA,IAAU,OAAS,QAAUA,CACpE,CAEA,SAASC,EAAyBD,EAA8B,CAC9D,OAAOA,IAAU,SAAW,GAAK,GACnC,CAEA,SAASE,EAAyBF,EAA8B,CAC9D,OAAOA,IAAU,SAAW,IAAM,IACpC,CASO,SAASG,EACdC,EACAC,EACU,CACV,GAAID,IAAO,EACT,OAAAC,EAAsBA,GAAuB,eACtC,CAAE,CAACA,CAAmB,EAAG,CAAE,EAGpC,IAAMC,EAAqB,CAAC,EAE5B,QAAS,EAAI,EAAG,EAAI,EAAG,IAAK,CAC1B,IAAIC,EAAU,KAAK,MAAMH,EAAK,GAAa,EACrCI,EAASJ,EAAKG,EAAU,IAM9B,GAJIC,EAAS,IACXF,EAAS,aAAkBE,GAGzBD,IAAY,EACd,MAGF,IAAIE,EAAU,KAAK,MAAMF,EAAU,EAAkB,EAOrD,GANAA,GAAWE,EAAU,GAEjBF,EAAU,IACZD,EAAS,QAAaC,GAGpBE,IAAY,EACd,MAGF,IAAIC,EAAQ,KAAK,MAAMD,EAAU,EAAgB,EAOjD,GANAA,GAAWC,EAAQ,GAEfD,EAAU,IACZH,EAAS,QAAaG,GAGpBC,IAAU,EACZ,MAGF,IAAMC,EAAO,KAAK,MAAMD,EAAQ,EAAa,EAC7CA,GAASC,EAAO,GAEZD,EAAQ,IACVJ,EAAS,MAAWI,GAGlBC,EAAO,IACTL,EAAS,KAAUK,EAEvB,CAEA,OAAOL,CACT,CAKO,SAASM,EAAaN,EAA4B,CACvD,IAAMO,GAAUP,EAAS,MAAQ,GAAK,MAChCQ,GAAWR,EAAS,OAAS,GAAK,KAClCS,GAAUT,EAAS,SAAW,GAAK,IACnCU,GAAUV,EAAS,SAAW,GAAK,IACnCW,EAAOX,EAAS,cAAgB,EAEtC,OAAOO,EAASC,EAAUC,EAASC,EAASC,CAC9C,CAKO,SAASC,EAAiBZ,EAAqC,CACpE,OAAO,OAAOA,GAAa,SAAWA,EAAWM,EAAaN,CAAQ,CACxE,CAQO,SAASa,EAAeb,EAAoBN,EAAuB,CACxEA,EAAQA,GAAS,QACjB,IAAMoB,EAAcrB,EAA0BC,CAAK,EAE7CqB,EAAQpB,EAAyBD,CAAK,EAEtCsB,EAAc,CAAC,EAErB,QAAWC,KAAQ1B,EAAwB,CACzC,IAAM2B,EAAQlB,EAASiB,CAAI,EAC3B,GAAIC,IAAU,OAAW,SAEzB,IAAMC,EAAY3B,EAA0ByB,CAAI,EAC1CG,EAASF,IAAU,EAAIC,EAAUzB,CAAK,EAAIyB,EAAUL,CAAW,EACrEE,EAAE,KAAKE,EAAQH,EAAQK,CAAM,CAC/B,CAEA,IAAMC,EAAYzB,EAAyBF,CAAK,EAChD,OAAOsB,EAAE,KAAKK,CAAS,CACzB,CAQO,SAASC,EACdxB,EACAyB,EACQ,CACR,IAAMvB,EAAWH,EAAaC,EAAIyB,GAAS,mBAAmB,EAE9D,OAAOV,EAAeb,EAAUuB,GAAS,KAAK,CAChD,CAGO,SAASC,EAAQ1B,EAAoB,CAE1C,OAAIA,EAAK,IACAwB,EAAiBxB,CAAE,EAIxBA,EAAK,IACA,IAAIA,EAAK,KAAM,QAAQ,CAAC,CAAC,IAI3BA,EAAK,IACd","names":["DURATION_TYPE_SEQUENCE","DURATION_STYLE_SUFFIX_MAP","getDurationStyleForPlural","style","getValueAndUnitSeparator","getDurationTypeSeparator","msToDuration","ms","durationTypeForZero","duration","seconds","millis","minutes","hours","days","durationToMs","daysMs","hoursMs","minsMs","secsMs","msMs","durationOrMsToMs","formatDuration","stylePlural","space","a","unit","value","suffixMap","suffix","separator","readableDuration","options","elapsed"]}

package/duration.mjs

@@ -0,0 +1,154 @@
+// src/timeConstants.ts
+var MS_PER_SECOND = 1e3;
+var MS_PER_MINUTE = 6e4;
+var MS_PER_HOUR = 36e5;
+var MS_PER_DAY = 864e5;
+var SECONDS_PER_MINUTE = 60;
+var MINUTES_PER_HOUR = 60;
+var HOURS_PER_DAY = 24;
+
+// src/duration.ts
+var DURATION_TYPE_SEQUENCE = [
+  "days",
+  "hours",
+  "minutes",
+  "seconds",
+  "milliseconds"
+];
+var DURATION_STYLE_SUFFIX_MAP = {
+  days: {
+    short: "day",
+    shorts: "days",
+    long: "day",
+    longs: "days",
+    narrow: "d"
+  },
+  hours: {
+    short: "hr",
+    shorts: "hrs",
+    long: "hour",
+    longs: "hours",
+    narrow: "h"
+  },
+  minutes: {
+    short: "min",
+    shorts: "mins",
+    long: "minute",
+    longs: "minutes",
+    narrow: "m"
+  },
+  seconds: {
+    short: "sec",
+    shorts: "secs",
+    long: "second",
+    longs: "seconds",
+    narrow: "s"
+  },
+  milliseconds: {
+    short: "ms",
+    shorts: "ms",
+    long: "millisecond",
+    longs: "milliseconds",
+    narrow: "ms"
+  }
+};
+function getDurationStyleForPlural(style) {
+  return style == "short" ? "shorts" : style === "long" ? "longs" : style;
+}
+function getValueAndUnitSeparator(style) {
+  return style === "narrow" ? "" : " ";
+}
+function getDurationTypeSeparator(style) {
+  return style === "narrow" ? " " : ", ";
+}
+function msToDuration(ms, durationTypeForZero) {
+  if (ms === 0) {
+    durationTypeForZero = durationTypeForZero ?? "milliseconds";
+    return { [durationTypeForZero]: 0 };
+  }
+  const duration = {};
+  for (let i = 0; i < 1; i++) {
+    let seconds = Math.floor(ms / MS_PER_SECOND);
+    const millis = ms - seconds * MS_PER_SECOND;
+    if (millis > 0) {
+      duration["milliseconds"] = millis;
+    }
+    if (seconds === 0) {
+      break;
+    }
+    let minutes = Math.floor(seconds / SECONDS_PER_MINUTE);
+    seconds -= minutes * SECONDS_PER_MINUTE;
+    if (seconds > 0) {
+      duration["seconds"] = seconds;
+    }
+    if (minutes === 0) {
+      break;
+    }
+    let hours = Math.floor(minutes / MINUTES_PER_HOUR);
+    minutes -= hours * MINUTES_PER_HOUR;
+    if (minutes > 0) {
+      duration["minutes"] = minutes;
+    }
+    if (hours === 0) {
+      break;
+    }
+    const days = Math.floor(hours / HOURS_PER_DAY);
+    hours -= days * HOURS_PER_DAY;
+    if (hours > 0) {
+      duration["hours"] = hours;
+    }
+    if (days > 0) {
+      duration["days"] = days;
+    }
+  }
+  return duration;
+}
+function durationToMs(duration) {
+  const daysMs = (duration.days ?? 0) * MS_PER_DAY;
+  const hoursMs = (duration.hours ?? 0) * MS_PER_HOUR;
+  const minsMs = (duration.minutes ?? 0) * MS_PER_MINUTE;
+  const secsMs = (duration.seconds ?? 0) * MS_PER_SECOND;
+  const msMs = duration.milliseconds ?? 0;
+  return daysMs + hoursMs + minsMs + secsMs + msMs;
+}
+function durationOrMsToMs(duration) {
+  return typeof duration === "number" ? duration : durationToMs(duration);
+}
+function formatDuration(duration, style) {
+  style = style ?? "short";
+  const stylePlural = getDurationStyleForPlural(style);
+  const space = getValueAndUnitSeparator(style);
+  const a = [];
+  for (const unit of DURATION_TYPE_SEQUENCE) {
+    const value = duration[unit];
+    if (value === void 0) continue;
+    const suffixMap = DURATION_STYLE_SUFFIX_MAP[unit];
+    const suffix = value === 1 ? suffixMap[style] : suffixMap[stylePlural];
+    a.push(value + space + suffix);
+  }
+  const separator = getDurationTypeSeparator(style);
+  return a.join(separator);
+}
+function readableDuration(ms, options) {
+  const duration = msToDuration(ms, options?.durationTypeForZero);
+  return formatDuration(duration, options?.style);
+}
+function elapsed(ms) {
+  if (ms > MS_PER_MINUTE) {
+    return readableDuration(ms);
+  }
+  if (ms > 100) {
+    return `${(ms / 1e3).toFixed(3)}s`;
+  }
+  return ms + "ms";
+}
+export {
+  DURATION_STYLE_SUFFIX_MAP,
+  DURATION_TYPE_SEQUENCE,
+  durationOrMsToMs,
+  durationToMs,
+  elapsed,
+  formatDuration,
+  msToDuration,
+  readableDuration
+};

package/{isEmpty.js → isEmpty.cjs}

@@ -45,4 +45,3 @@ function isEmpty(t) {
 0 && (module.exports = {
   isEmpty
 });
-//# sourceMappingURL=isEmpty.js.map

package/isEmpty.d.mts

@@ -0,0 +1,6 @@
+/**
+ * Returns true if `t` is empty.
+ */
+declare function isEmpty(t: unknown): boolean;
+
+export { isEmpty };

package/isEmpty.min.cjs

@@ -0,0 +1,2 @@
+"use strict";var t=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var s=Object.prototype.hasOwnProperty;var l=(e,n)=>{for(var i in n)t(e,i,{get:n[i],enumerable:!0})},a=(e,n,i,u)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of o(n))!s.call(e,r)&&r!==i&&t(e,r,{get:()=>n[r],enumerable:!(u=f(n,r))||u.enumerable});return e};var c=e=>a(t({},"__esModule",{value:!0}),e);var b={};l(b,{isEmpty:()=>p});module.exports=c(b);function p(e){if(!e)return!0;if(typeof e!="object")return!1;if("length"in e)return e.length===0;if("size"in e)return e.size===0;for(let n in e)return!1;return!0}0&&(module.exports={isEmpty});
+//# sourceMappingURL=isEmpty.min.cjs.map

package/isEmpty.min.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/isEmpty.ts"],"sourcesContent":["/**\n * Returns true if `t` is empty.\n */\nexport function isEmpty(t: unknown): boolean {\n  // Anything falsy is considered empty.\n  if (!t) {\n    return true;\n  }\n\n  // Arrays are also of type `object`.\n  if (typeof t !== \"object\") {\n    return false;\n  }\n\n  // `length` includes arrays as well.\n  if (\"length\" in t) {\n    return t.length === 0;\n  }\n\n  // `size` is for Set, Map, Blob etc.\n  if (\"size\" in t) {\n    return t.size === 0;\n  }\n\n  // Super fast check for object emptiness.\n  // https://stackoverflow.com/questions/679915/how-do-i-test-for-an-empty-javascript-object\n  for (const k in t) {\n    return false;\n  }\n\n  return true;\n}\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,IAAA,eAAAC,EAAAH,GAGO,SAASE,EAAQE,EAAqB,CAE3C,GAAI,CAACA,EACH,MAAO,GAIT,GAAI,OAAOA,GAAM,SACf,MAAO,GAIT,GAAI,WAAYA,EACd,OAAOA,EAAE,SAAW,EAItB,GAAI,SAAUA,EACZ,OAAOA,EAAE,OAAS,EAKpB,QAAWC,KAAKD,EACd,MAAO,GAGT,MAAO,EACT","names":["isEmpty_exports","__export","isEmpty","__toCommonJS","t","k"]}

package/isEmpty.min.mjs

@@ -0,0 +1,2 @@
+function r(e){if(!e)return!0;if(typeof e!="object")return!1;if("length"in e)return e.length===0;if("size"in e)return e.size===0;for(let n in e)return!1;return!0}export{r as isEmpty};
+//# sourceMappingURL=isEmpty.min.mjs.map

package/{isEmpty.js.map → isEmpty.min.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/isEmpty.ts"],"sourcesContent":["/**\n * Returns true if `t` is empty.\n */\nexport function isEmpty(t: unknown): boolean {\n  // Anything falsy is considered empty.\n  if (!t) {\n    return true;\n  }\n\n  // Arrays are also of type `object`.\n  if (typeof t !== \"object\") {\n    return false;\n  }\n\n  // `length` includes arrays as well.\n  if (\"length\" in t) {\n    return t.length === 0;\n  }\n\n  // `size` is for Set, Map, Blob etc.\n  if (\"size\" in t) {\n    return t.size === 0;\n  }\n\n  // Super fast check for object emptiness.\n  // https://stackoverflow.com/questions/679915/how-do-i-test-for-an-empty-javascript-object\n  for (const k in t) {\n    return false;\n  }\n\n  return true;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,SAAS,QAAQ,GAAqB;AAE3C,MAAI,CAAC,GAAG;AACN,WAAO;AAAA,EACT;AAGA,MAAI,OAAO,MAAM,UAAU;AACzB,WAAO;AAAA,EACT;AAGA,MAAI,YAAY,GAAG;AACjB,WAAO,EAAE,WAAW;AAAA,EACtB;AAGA,MAAI,UAAU,GAAG;AACf,WAAO,EAAE,SAAS;AAAA,EACpB;AAIA,aAAW,KAAK,GAAG;AACjB,WAAO;AAAA,EACT;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/isEmpty.ts"],"sourcesContent":["/**\n * Returns true if `t` is empty.\n */\nexport function isEmpty(t: unknown): boolean {\n  // Anything falsy is considered empty.\n  if (!t) {\n    return true;\n  }\n\n  // Arrays are also of type `object`.\n  if (typeof t !== \"object\") {\n    return false;\n  }\n\n  // `length` includes arrays as well.\n  if (\"length\" in t) {\n    return t.length === 0;\n  }\n\n  // `size` is for Set, Map, Blob etc.\n  if (\"size\" in t) {\n    return t.size === 0;\n  }\n\n  // Super fast check for object emptiness.\n  // https://stackoverflow.com/questions/679915/how-do-i-test-for-an-empty-javascript-object\n  for (const k in t) {\n    return false;\n  }\n\n  return true;\n}\n"],"mappings":"AAGO,SAASA,EAAQC,EAAqB,CAE3C,GAAI,CAACA,EACH,MAAO,GAIT,GAAI,OAAOA,GAAM,SACf,MAAO,GAIT,GAAI,WAAYA,EACd,OAAOA,EAAE,SAAW,EAItB,GAAI,SAAUA,EACZ,OAAOA,EAAE,OAAS,EAKpB,QAAWC,KAAKD,EACd,MAAO,GAGT,MAAO,EACT","names":["isEmpty","t","k"]}

package/isEmpty.mjs

@@ -0,0 +1,22 @@
+// src/isEmpty.ts
+function isEmpty(t) {
+  if (!t) {
+    return true;
+  }
+  if (typeof t !== "object") {
+    return false;
+  }
+  if ("length" in t) {
+    return t.length === 0;
+  }
+  if ("size" in t) {
+    return t.size === 0;
+  }
+  for (const k in t) {
+    return false;
+  }
+  return true;
+}
+export {
+  isEmpty
+};