@sodiumlabs/ms 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sodiumlabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,127 @@
+<div align="center">
+    <h1>@sodiumlabs/ms</h1>
+    <p>
+        <a href="https://discord.gg/8PDXWSHH7k"><img src="https://img.shields.io/badge/join_us-on_discord-5865F2?logo=discord&logoColor=white" alt="Discord server" /></a>
+        <a href="https://www.npmjs.com/package/@sodiumlabs/ms"><img src="https://img.shields.io/npm/v/@sodiumlabs/ms.svg?maxAge=3600" alt="npm version" /></a>
+        <a href="https://www.npmjs.com/package/@sodiumlabs/ms"><img src="https://img.shields.io/npm/dt/@sodiumlabs/ms.svg?maxAge=3600" alt="npm downloads" /></a>
+        <a href="https://github.com/sodium-labs/utilities/commits/main/packages/ms"><img alt="Last commit" src="https://img.shields.io/github/last-commit/sodium-labs/utilities?logo=github&logoColor=ffffff&path=packages%2Fms" /></a>
+    </p>
+</div>
+
+## About
+
+Use this package to easily convert various time formats to milliseconds.
+
+This package is an enhanced version of [vercel/ms](https://github.com/vercel/ms), with added localization support. With `@sodiumlabs/ms`, you can use multiple units at the same time (e.g. `ms("2h30m45s")`) and define localized units in any language you need.
+
+By default, the following locales are supported: `en`, `fr`, `de`, `es`.
+
+## Installation
+
+Node.js 18 or newer is required.
+
+```sh
+npm install @sodiumlabs/ms
+```
+
+## Usage
+
+```ts
+ms("2 days"); // 172800000
+ms("1d"); // 86400000
+ms("10h"); // 36000000
+ms("2.5 hrs"); // 9000000
+ms("2h"); // 7200000
+ms("1m"); // 60000
+ms("5s"); // 5000
+```
+
+Convert from Milliseconds
+
+```ts
+ms(60000); // "1m"
+ms(2 * 60000); // "2m"
+ms(-3 * 60000); // "-3m"
+ms(ms("10 hours")); // "10h"
+```
+
+Time Format Written-Out
+
+```ts
+ms(60000, { long: true }); // "1 minute"
+ms(2 * 60000, { long: true }); // "2 minutes"
+ms(-3 * 60000, { long: true }); // "-3 minutes"
+ms(ms("10 hours"), { long: true }); // "10 hours"
+```
+
+Compound Format
+
+```ts
+const duration = ms("1min 5s 2ms");
+
+ms(duration); // "1m"
+ms(duration, { compound: true }); // "1m5s2ms"
+ms(duration, { compound: true, maxUnits: 2 }); // "1m5s"
+ms(duration, { long: true, compound: true }); // "1 minute 5 seconds 2 milliseconds"
+```
+
+Specific Methods
+
+```ts
+// If you only want to parse, you can use
+parse("2min");
+
+// If you only want to format, you can use
+format(120000);
+```
+
+Use another locale
+
+```ts
+ms("2h", { locale: "fr", long: true }); // "2 heures"
+```
+
+Add a locale
+
+```ts
+import { setLocale } from "@sodiumlabs/ms";
+
+// Add the `it` locale
+setLocale("it", {
+    units: {
+        second: {
+            short: "s",
+            long: c => (c > 1 ? "secondi" : "secondo"),
+            names: ["secondi", "secondo", "secs", "sec", "s"],
+        },
+        minute: {
+            short: "m",
+            long: c => (c > 1 ? "minuti" : "minuto"),
+            names: ["minuti", "minuto", "mins", "min", "m"],
+        },
+        hour: {
+            short: "h",
+            long: c => (c > 1 ? "ore" : "ora"),
+            names: ["ore", "ora", "h"],
+        },
+        day: {
+            short: "g",
+            long: c => (c > 1 ? "giorni" : "giorno"),
+            names: ["giorni", "giorno", "g"],
+        },
+        /// etc.
+    },
+});
+```
+
+## Links
+
+- [Documentation](https://docs.sodiumlabs.xyz/docs/packages/ms/stable)
+- [Discord server](https://discord.gg/8PDXWSHH7k)
+- [GitHub](https://github.com/sodium-labs/utilities/tree/main/packages/ms)
+- [npm](https://npmjs.com/package/@sodiumlabs/ms)
+- [Sodium Labs](https://sodiumlabs.xyz)
+
+## Help
+
+Need help with the module? Ask on our [support server!](https://discord.gg/8PDXWSHH7k)

package/dist/index.d.mts

@@ -0,0 +1,41 @@
+/**
+ * The options.
+ */
+interface Options {
+    /**
+     * Set to `true` to use verbose formatting. Defaults to `false`.
+     */
+    long?: boolean;
+    /**
+     * The locale. Defaults to `en`.
+     */
+    locale?: string;
+    compound?: boolean;
+    maxUnits?: number;
+}
+/**
+ * Parse or format the given value.
+ *
+ * @param value - The string or number to convert
+ * @param options - Options for the conversion
+ * @throws Error if `value` is not a non-empty string or a number
+ */
+declare function ms(value: string, options?: Options): number;
+declare function ms(value: number, options?: Options): string;
+/**
+ * Parse the given string and return milliseconds.
+ *
+ * @param str - A string to parse into milliseconds. Length must be in [1;100]
+ * @returns The parsed value in milliseconds, or `NaN` if the string can't be parsed
+ */
+declare function parse(str: string, options?: Options): number;
+/**
+ * Format the given integer as a string.
+ *
+ * @param ms - milliseconds
+ * @param options - Options for the conversion
+ * @returns The formatted string
+ */
+declare function format(ms: number, options?: Options): string;
+
+export { type Options, format, ms, parse };

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The options.
+ */
+interface Options {
+    /**
+     * Set to `true` to use verbose formatting. Defaults to `false`.
+     */
+    long?: boolean;
+    /**
+     * The locale. Defaults to `en`.
+     */
+    locale?: string;
+    compound?: boolean;
+    maxUnits?: number;
+}
+/**
+ * Parse or format the given value.
+ *
+ * @param value - The string or number to convert
+ * @param options - Options for the conversion
+ * @throws Error if `value` is not a non-empty string or a number
+ */
+declare function ms(value: string, options?: Options): number;
+declare function ms(value: number, options?: Options): string;
+/**
+ * Parse the given string and return milliseconds.
+ *
+ * @param str - A string to parse into milliseconds. Length must be in [1;100]
+ * @returns The parsed value in milliseconds, or `NaN` if the string can't be parsed
+ */
+declare function parse(str: string, options?: Options): number;
+/**
+ * Format the given integer as a string.
+ *
+ * @param ms - milliseconds
+ * @param options - Options for the conversion
+ * @returns The formatted string
+ */
+declare function format(ms: number, options?: Options): string;
+
+export { type Options, format, ms, parse };

package/dist/index.js

@@ -0,0 +1,342 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  format: () => format,
+  ms: () => ms,
+  parse: () => parse
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/locales.ts
+var locales = /* @__PURE__ */ new Map();
+var setLocale = /* @__PURE__ */ __name((locale, definition) => {
+  const mappedUnits = /* @__PURE__ */ new Map();
+  for (const [unit, def] of Object.entries(definition.units)) {
+    for (const name of def.names) {
+      mappedUnits.set(name.toLowerCase(), unit);
+    }
+  }
+  locales.set(locale, {
+    ...definition,
+    mappedUnits
+  });
+}, "setLocale");
+var defaultLocales = {
+  en: {
+    units: {
+      millisecond: {
+        short: "ms",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "milliseconds" : "millisecond", "long"),
+        names: ["milliseconds", "millisecond", "msecs", "msec", "ms"]
+      },
+      second: {
+        short: "s",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "seconds" : "second", "long"),
+        names: ["seconds", "second", "secs", "sec", "s"]
+      },
+      minute: {
+        short: "m",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "minutes" : "minute", "long"),
+        names: ["minutes", "minute", "mins", "min", "m"]
+      },
+      hour: {
+        short: "h",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "hours" : "hour", "long"),
+        names: ["hours", "hour", "hrs", "hr", "h"]
+      },
+      day: {
+        short: "d",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "days" : "day", "long"),
+        names: ["days", "day", "d"]
+      },
+      week: {
+        short: "w",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "weeks" : "week", "long"),
+        names: ["weeks", "week", "w"]
+      },
+      month: {
+        short: "mo",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "months" : "month", "long"),
+        names: ["months", "month", "mo"]
+      },
+      year: {
+        short: "y",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "years" : "year", "long"),
+        names: ["years", "year", "yrs", "yr", "y"]
+      }
+    }
+  },
+  fr: {
+    units: {
+      millisecond: {
+        short: "ms",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "millisecondes" : "milliseconde", "long"),
+        names: ["millisecondes", "milliseconde", "ms"]
+      },
+      second: {
+        short: "s",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "secondes" : "seconde", "long"),
+        names: ["secondes", "seconde", "secs", "sec", "s"]
+      },
+      minute: {
+        short: "m",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "minutes" : "minute", "long"),
+        names: ["minutes", "minute", "mins", "min", "m"]
+      },
+      hour: {
+        short: "h",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "heures" : "heure", "long"),
+        names: ["heures", "heure", "h"]
+      },
+      day: {
+        short: "j",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "jours" : "jour", "long"),
+        names: ["jours", "jour", "j"]
+      },
+      week: {
+        short: "sem",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "semaines" : "semaine", "long"),
+        names: ["semaines", "semaine", "sem"]
+      },
+      month: {
+        short: "mo",
+        long: /* @__PURE__ */ __name((_) => "mois", "long"),
+        names: ["mois", "mo"]
+      },
+      year: {
+        short: "an",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "ann\xE9es" : "ann\xE9e", "long"),
+        names: ["ann\xE9es", "annees", "ann\xE9e", "annee", "ans", "an"]
+      }
+    }
+  },
+  de: {
+    units: {
+      millisecond: {
+        short: "ms",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Millisekunden" : "Millisekunde", "long"),
+        names: ["millisekunden", "millisekunde", "ms"]
+      },
+      second: {
+        short: "s",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Sekunden" : "Sekunde", "long"),
+        names: ["sekunden", "sekunde", "seks", "sek", "s"]
+      },
+      minute: {
+        short: "m",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Minuten" : "Minute", "long"),
+        names: ["minuten", "minute", "mins", "min", "m"]
+      },
+      hour: {
+        short: "h",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Stunden" : "Stunde", "long"),
+        names: ["stunden", "stunde", "hrs", "hr", "h"]
+      },
+      day: {
+        short: "t",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Tage" : "Tag", "long"),
+        names: ["tage", "tag", "t", "d"]
+      },
+      week: {
+        short: "w",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Wochen" : "Woche", "long"),
+        names: ["wochen", "woche", "wo", "w"]
+      },
+      month: {
+        short: "mo",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Monate" : "Monat", "long"),
+        names: ["monate", "monat", "mon", "mo"]
+      },
+      year: {
+        short: "j",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Jahre" : "Jahr", "long"),
+        names: ["jahre", "jahr", "j", "y"]
+      }
+    }
+  },
+  es: {
+    units: {
+      millisecond: {
+        short: "ms",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "milisegundos" : "milisegundo", "long"),
+        names: ["milisegundos", "milisegundo", "ms"]
+      },
+      second: {
+        short: "s",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "segundos" : "segundo", "long"),
+        names: ["segundos", "segundo", "s"]
+      },
+      minute: {
+        short: "min",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "minutos" : "minuto", "long"),
+        names: ["minutos", "minuto", "mins", "min", "m"]
+      },
+      hour: {
+        short: "h",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "horas" : "hora", "long"),
+        names: ["horas", "hora", "hrs", "hr", "h"]
+      },
+      day: {
+        short: "d",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "d\xEDas" : "d\xEDa", "long"),
+        names: ["d\xEDas", "dias", "d\xEDa", "dia", "d"]
+      },
+      week: {
+        short: "sem",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "semanas" : "semana", "long"),
+        names: ["semanas", "semana", "sem"]
+      },
+      month: {
+        short: "mes",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "meses" : "mes", "long"),
+        names: ["meses", "mes", "mo"]
+      },
+      year: {
+        short: "a",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "a\xF1os" : "a\xF1o", "long"),
+        names: ["a\xF1os", "anos", "a\xF1o", "ano", "a"]
+      }
+    }
+  }
+};
+for (const [locale, definition] of Object.entries(defaultLocales)) {
+  setLocale(locale, definition);
+}
+
+// src/units.ts
+var import_duration = require("@sodiumlabs/duration");
+var unitValues = {
+  millisecond: import_duration.Time.Millisecond,
+  second: import_duration.Time.Second,
+  minute: import_duration.Time.Minute,
+  hour: import_duration.Time.Hour,
+  day: import_duration.Time.Day,
+  week: import_duration.Time.Week,
+  month: import_duration.Time.Month,
+  year: import_duration.Time.Year
+};
+
+// src/index.ts
+function ms(value, options) {
+  if (typeof value === "string") {
+    return parse(value, options);
+  } else if (typeof value === "number") {
+    return format(value, options);
+  }
+  throw new Error(`Value provided to ms() must be a string or number. value=${JSON.stringify(value)}`);
+}
+__name(ms, "ms");
+function parse(str, options) {
+  if (typeof str !== "string" || str.length === 0 || str.length > 100) {
+    throw new Error(
+      `Value provided to ms.parse() must be a string with length between 1 and 99. value=${JSON.stringify(str)}`
+    );
+  }
+  const locale = locales.get(options?.locale ?? "en");
+  if (!locale) {
+    throw new Error(`Unknown locale "${options?.locale}"`);
+  }
+  let total = 0;
+  let consumed = false;
+  const tokenRegex = /(?<value>-?\d*\.?\d+) *(?<unit>[a-zàèìòùáéíóúýâêîôûãñõäëïöüÿçµ]+)?/gi;
+  let match;
+  let lastIndex = 0;
+  while ((match = tokenRegex.exec(str)) !== null) {
+    if (str.slice(lastIndex, match.index).trim().length !== 0) {
+      return NaN;
+    }
+    const { value: rawValue, unit: rawUnit = "ms" } = match.groups;
+    const value = parseFloat(rawValue);
+    if (Number.isNaN(value)) {
+      return NaN;
+    }
+    const unit = !rawUnit ? "millisecond" : locale.mappedUnits.get(rawUnit.toLowerCase());
+    if (!unit) {
+      return NaN;
+    }
+    total += value * unitValues[unit];
+    consumed = true;
+    lastIndex = tokenRegex.lastIndex;
+  }
+  if (!consumed || str.slice(lastIndex).trim().length !== 0) {
+    return NaN;
+  }
+  return total;
+}
+__name(parse, "parse");
+function format(ms2, options) {
+  if (typeof ms2 !== "number" || !Number.isFinite(ms2)) {
+    throw new Error("Value provided to ms.format() must be of type number.");
+  }
+  const locale = locales.get(options?.locale ?? "en");
+  if (!locale) {
+    throw new Error(`Unknown locale "${options?.locale}"`);
+  }
+  const sign = ms2 < 0 ? "-" : "";
+  let remaining = Math.abs(ms2);
+  const units = Object.entries(locale.units).map(([unit, def]) => ({
+    unit,
+    def,
+    value: unitValues[unit]
+  })).sort((a, b) => b.value - a.value);
+  if (!options?.compound) {
+    for (const { def, value } of units) {
+      if (remaining >= value) {
+        const amount = Math.round(ms2 / value);
+        if (options?.long) {
+          return `${amount} ${def.long(Math.abs(amount))}`;
+        }
+        return `${amount}${def.short}`;
+      }
+    }
+    const msDef = locale.units.millisecond;
+    return options?.long ? `${ms2} ${msDef.long(Math.abs(ms2))}` : `${ms2}${msDef.short}`;
+  }
+  const parts = [];
+  let usedUnits = 0;
+  for (const { def, value } of units) {
+    if (remaining < value) continue;
+    const amount = Math.floor(remaining / value);
+    remaining -= amount * value;
+    if (amount > 0) {
+      parts.push(options?.long ? `${amount} ${def.long(amount)}` : `${amount}${def.short}`);
+      usedUnits++;
+      if (options?.maxUnits && usedUnits >= options.maxUnits) {
+        break;
+      }
+    }
+  }
+  if (parts.length === 0) {
+    const msDef = locale.units.millisecond;
+    parts.push(options?.long ? `0 ${msDef.long(0)}` : `0${msDef.short}`);
+  }
+  return sign + parts.join(options?.long ? " " : "");
+}
+__name(format, "format");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  format,
+  ms,
+  parse
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/locales.ts","../src/units.ts"],"sourcesContent":["import { locales } from \"./locales\";\nimport { Unit, unitValues } from \"./units\";\n\n/**\n * The options.\n */\nexport interface Options {\n    /**\n     * Set to `true` to use verbose formatting. Defaults to `false`.\n     */\n    long?: boolean;\n    /**\n     * The locale. Defaults to `en`.\n     */\n    locale?: string;\n    compound?: boolean;\n    maxUnits?: number;\n}\n\n/**\n * Parse or format the given value.\n *\n * @param value - The string or number to convert\n * @param options - Options for the conversion\n * @throws Error if `value` is not a non-empty string or a number\n */\nexport function ms(value: string, options?: Options): number;\nexport function ms(value: number, options?: Options): string;\nexport function ms(value: string | number, options?: Options): number | string {\n    if (typeof value === \"string\") {\n        return parse(value, options);\n    } else if (typeof value === \"number\") {\n        return format(value, options);\n    }\n    throw new Error(`Value provided to ms() must be a string or number. value=${JSON.stringify(value)}`);\n}\n\n/**\n * Parse the given string and return milliseconds.\n *\n * @param str - A string to parse into milliseconds. Length must be in [1;100]\n * @returns The parsed value in milliseconds, or `NaN` if the string can't be parsed\n */\nexport function parse(str: string, options?: Options): number {\n    if (typeof str !== \"string\" || str.length === 0 || str.length > 100) {\n        throw new Error(\n            `Value provided to ms.parse() must be a string with length between 1 and 99. value=${JSON.stringify(str)}`,\n        );\n    }\n\n    const locale = locales.get(options?.locale ?? \"en\");\n    if (!locale) {\n        throw new Error(`Unknown locale \"${options?.locale}\"`);\n    }\n\n    let total = 0;\n    let consumed = false;\n\n    const tokenRegex = /(?<value>-?\\d*\\.?\\d+) *(?<unit>[a-zàèìòùáéíóúýâêîôûãñõäëïöüÿçµ]+)?/gi;\n    let match: RegExpExecArray | null;\n    let lastIndex = 0;\n\n    while ((match = tokenRegex.exec(str)) !== null) {\n        if (str.slice(lastIndex, match.index).trim().length !== 0) {\n            return NaN;\n        }\n\n        const { value: rawValue, unit: rawUnit = \"ms\" } = match.groups as {\n            value: string;\n            unit: string | undefined;\n        };\n\n        const value = parseFloat(rawValue);\n        if (Number.isNaN(value)) {\n            return NaN;\n        }\n\n        const unit = !rawUnit ? \"millisecond\" : locale.mappedUnits.get(rawUnit.toLowerCase());\n        if (!unit) {\n            return NaN;\n        }\n\n        total += value * unitValues[unit];\n        consumed = true;\n\n        lastIndex = tokenRegex.lastIndex;\n    }\n\n    if (!consumed || str.slice(lastIndex).trim().length !== 0) {\n        return NaN;\n    }\n\n    return total;\n}\n\n/**\n * Format the given integer as a string.\n *\n * @param ms - milliseconds\n * @param options - Options for the conversion\n * @returns The formatted string\n */\nexport function format(ms: number, options?: Options): string {\n    if (typeof ms !== \"number\" || !Number.isFinite(ms)) {\n        throw new Error(\"Value provided to ms.format() must be of type number.\");\n    }\n\n    const locale = locales.get(options?.locale ?? \"en\");\n    if (!locale) {\n        throw new Error(`Unknown locale \"${options?.locale}\"`);\n    }\n\n    const sign = ms < 0 ? \"-\" : \"\";\n    let remaining = Math.abs(ms);\n\n    // units sorted by descending size\n    const units = Object.entries(locale.units)\n        .map(([unit, def]) => ({\n            unit,\n            def,\n            value: unitValues[unit as Unit],\n        }))\n        .sort((a, b) => b.value - a.value);\n\n    // === simple mode (current behavior) ===\n    if (!options?.compound) {\n        for (const { def, value } of units) {\n            if (remaining >= value) {\n                const amount = Math.round(ms / value);\n\n                if (options?.long) {\n                    return `${amount} ${def.long(Math.abs(amount))}`;\n                }\n\n                return `${amount}${def.short}`;\n            }\n        }\n\n        const msDef = locale.units.millisecond;\n        return options?.long ? `${ms} ${msDef.long(Math.abs(ms))}` : `${ms}${msDef.short}`;\n    }\n\n    // === compound mode ===\n    const parts: string[] = [];\n    let usedUnits = 0;\n\n    for (const { def, value } of units) {\n        if (remaining < value) continue;\n\n        const amount = Math.floor(remaining / value);\n        remaining -= amount * value;\n\n        if (amount > 0) {\n            parts.push(options?.long ? `${amount} ${def.long(amount)}` : `${amount}${def.short}`);\n\n            usedUnits++;\n            if (options?.maxUnits && usedUnits >= options.maxUnits) {\n                break;\n            }\n        }\n    }\n\n    // fallback if everything was < 1ms\n    if (parts.length === 0) {\n        const msDef = locale.units.millisecond;\n        parts.push(options?.long ? `0 ${msDef.long(0)}` : `0${msDef.short}`);\n    }\n\n    return sign + parts.join(options?.long ? \" \" : \"\");\n}\n","import { Unit } from \"./units\";\n\n/**\n * The options and translations of a locale.\n */\nexport interface LocaleDefinition {\n    units: Record<Unit, UnitDefinition>;\n}\n\n/**\n * The translations of a time unit.\n */\nexport interface UnitDefinition {\n    /**\n     * The short name of the unit.\n     */\n    short: string;\n    /**\n     * The long name of the unit.\n     *\n     * @example\n     * ```ts\n     * long: c => (c > 1 ? \"plural form\" : \"singular form\")\n     * ```\n     *\n     * @param c - The absolute value of the rounded number.\n     */\n    long: (c: number) => string;\n    /**\n     * The names of the unit. Should be all lowercase.\n     *\n     * @remarks\n     * The values of `short` and `long` are not automatically added\n     * to this array, so you probably want to add them here too\n     * if you want them to be used in the parse function.\n     */\n    names: string[];\n}\n\nexport type CompleteLocaleDefinition = LocaleDefinition & {\n    /**\n     * A map from the translated unit name to the corresponding unit name.\n     */\n    mappedUnits: Map<string, Unit>;\n};\n\n/**\n * The locales definitions. You can add or edit a locale definition directly here,\n * or use {@link setLocale}.\n */\nexport const locales = new Map<string, CompleteLocaleDefinition>();\n\n/**\n * Add or edit a locale definition.\n *\n * @param locale - The locale (e.g. `it`)\n * @param definition - The definition\n */\nexport const setLocale = (locale: string, definition: LocaleDefinition) => {\n    const mappedUnits = new Map<string, Unit>();\n    for (const [unit, def] of Object.entries(definition.units) as [Unit, UnitDefinition][]) {\n        for (const name of def.names) {\n            mappedUnits.set(name.toLowerCase(), unit);\n        }\n    }\n\n    locales.set(locale, {\n        ...definition,\n        mappedUnits,\n    });\n};\n\n// Define the default locales\n\nconst defaultLocales: Record<string, LocaleDefinition> = {\n    en: {\n        units: {\n            millisecond: {\n                short: \"ms\",\n                long: c => (c > 1 ? \"milliseconds\" : \"millisecond\"),\n                names: [\"milliseconds\", \"millisecond\", \"msecs\", \"msec\", \"ms\"],\n            },\n            second: {\n                short: \"s\",\n                long: c => (c > 1 ? \"seconds\" : \"second\"),\n                names: [\"seconds\", \"second\", \"secs\", \"sec\", \"s\"],\n            },\n            minute: {\n                short: \"m\",\n                long: c => (c > 1 ? \"minutes\" : \"minute\"),\n                names: [\"minutes\", \"minute\", \"mins\", \"min\", \"m\"],\n            },\n            hour: {\n                short: \"h\",\n                long: c => (c > 1 ? \"hours\" : \"hour\"),\n                names: [\"hours\", \"hour\", \"hrs\", \"hr\", \"h\"],\n            },\n            day: {\n                short: \"d\",\n                long: c => (c > 1 ? \"days\" : \"day\"),\n                names: [\"days\", \"day\", \"d\"],\n            },\n            week: {\n                short: \"w\",\n                long: c => (c > 1 ? \"weeks\" : \"week\"),\n                names: [\"weeks\", \"week\", \"w\"],\n            },\n            month: {\n                short: \"mo\",\n                long: c => (c > 1 ? \"months\" : \"month\"),\n                names: [\"months\", \"month\", \"mo\"],\n            },\n            year: {\n                short: \"y\",\n                long: c => (c > 1 ? \"years\" : \"year\"),\n                names: [\"years\", \"year\", \"yrs\", \"yr\", \"y\"],\n            },\n        },\n    },\n    fr: {\n        units: {\n            millisecond: {\n                short: \"ms\",\n                long: c => (c > 1 ? \"millisecondes\" : \"milliseconde\"),\n                names: [\"millisecondes\", \"milliseconde\", \"ms\"],\n            },\n            second: {\n                short: \"s\",\n                long: c => (c > 1 ? \"secondes\" : \"seconde\"),\n                names: [\"secondes\", \"seconde\", \"secs\", \"sec\", \"s\"],\n            },\n            minute: {\n                short: \"m\",\n                long: c => (c > 1 ? \"minutes\" : \"minute\"),\n                names: [\"minutes\", \"minute\", \"mins\", \"min\", \"m\"],\n            },\n            hour: {\n                short: \"h\",\n                long: c => (c > 1 ? \"heures\" : \"heure\"),\n                names: [\"heures\", \"heure\", \"h\"],\n            },\n            day: {\n                short: \"j\",\n                long: c => (c > 1 ? \"jours\" : \"jour\"),\n                names: [\"jours\", \"jour\", \"j\"],\n            },\n            week: {\n                short: \"sem\",\n                long: c => (c > 1 ? \"semaines\" : \"semaine\"),\n                names: [\"semaines\", \"semaine\", \"sem\"],\n            },\n            month: {\n                short: \"mo\",\n                long: _ => \"mois\",\n                names: [\"mois\", \"mo\"],\n            },\n            year: {\n                short: \"an\",\n                long: c => (c > 1 ? \"années\" : \"année\"),\n                names: [\"années\", \"annees\", \"année\", \"annee\", \"ans\", \"an\"],\n            },\n        },\n    },\n    de: {\n        units: {\n            millisecond: {\n                short: \"ms\",\n                long: c => (c > 1 ? \"Millisekunden\" : \"Millisekunde\"),\n                names: [\"millisekunden\", \"millisekunde\", \"ms\"],\n            },\n            second: {\n                short: \"s\",\n                long: c => (c > 1 ? \"Sekunden\" : \"Sekunde\"),\n                names: [\"sekunden\", \"sekunde\", \"seks\", \"sek\", \"s\"],\n            },\n            minute: {\n                short: \"m\",\n                long: c => (c > 1 ? \"Minuten\" : \"Minute\"),\n                names: [\"minuten\", \"minute\", \"mins\", \"min\", \"m\"],\n            },\n            hour: {\n                short: \"h\",\n                long: c => (c > 1 ? \"Stunden\" : \"Stunde\"),\n                names: [\"stunden\", \"stunde\", \"hrs\", \"hr\", \"h\"],\n            },\n            day: {\n                short: \"t\",\n                long: c => (c > 1 ? \"Tage\" : \"Tag\"),\n                names: [\"tage\", \"tag\", \"t\", \"d\"],\n            },\n            week: {\n                short: \"w\",\n                long: c => (c > 1 ? \"Wochen\" : \"Woche\"),\n                names: [\"wochen\", \"woche\", \"wo\", \"w\"],\n            },\n            month: {\n                short: \"mo\",\n                long: c => (c > 1 ? \"Monate\" : \"Monat\"),\n                names: [\"monate\", \"monat\", \"mon\", \"mo\"],\n            },\n            year: {\n                short: \"j\",\n                long: c => (c > 1 ? \"Jahre\" : \"Jahr\"),\n                names: [\"jahre\", \"jahr\", \"j\", \"y\"],\n            },\n        },\n    },\n    es: {\n        units: {\n            millisecond: {\n                short: \"ms\",\n                long: c => (c > 1 ? \"milisegundos\" : \"milisegundo\"),\n                names: [\"milisegundos\", \"milisegundo\", \"ms\"],\n            },\n            second: {\n                short: \"s\",\n                long: c => (c > 1 ? \"segundos\" : \"segundo\"),\n                names: [\"segundos\", \"segundo\", \"s\"],\n            },\n            minute: {\n                short: \"min\",\n                long: c => (c > 1 ? \"minutos\" : \"minuto\"),\n                names: [\"minutos\", \"minuto\", \"mins\", \"min\", \"m\"],\n            },\n            hour: {\n                short: \"h\",\n                long: c => (c > 1 ? \"horas\" : \"hora\"),\n                names: [\"horas\", \"hora\", \"hrs\", \"hr\", \"h\"],\n            },\n            day: {\n                short: \"d\",\n                long: c => (c > 1 ? \"días\" : \"día\"),\n                names: [\"días\", \"dias\", \"día\", \"dia\", \"d\"],\n            },\n            week: {\n                short: \"sem\",\n                long: c => (c > 1 ? \"semanas\" : \"semana\"),\n                names: [\"semanas\", \"semana\", \"sem\"],\n            },\n            month: {\n                short: \"mes\",\n                long: c => (c > 1 ? \"meses\" : \"mes\"),\n                names: [\"meses\", \"mes\", \"mo\"],\n            },\n            year: {\n                short: \"a\",\n                long: c => (c > 1 ? \"años\" : \"año\"),\n                names: [\"años\", \"anos\", \"año\", \"ano\", \"a\"],\n            },\n        },\n    },\n};\n\nfor (const [locale, definition] of Object.entries(defaultLocales)) {\n    setLocale(locale, definition);\n}\n","import { Time } from \"@sodiumlabs/duration\";\n\n/**\n * The available time units.\n */\nexport const units = [\"millisecond\", \"second\", \"minute\", \"hour\", \"day\", \"week\", \"month\", \"year\"] as const;\n\n/**\n * A time unit.\n */\nexport type Unit = (typeof units)[number];\n\n/**\n * The values in milliseconds of each time unit.\n */\nexport const unitValues: Record<Unit, number> = {\n    millisecond: Time.Millisecond,\n    second: Time.Second,\n    minute: Time.Minute,\n    hour: Time.Hour,\n    day: Time.Day,\n    week: Time.Week,\n    month: Time.Month,\n    year: Time.Year,\n};\n"],"mappings":"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","names":["ms"]}

package/dist/index.mjs

@@ -0,0 +1,315 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/locales.ts
+var locales = /* @__PURE__ */ new Map();
+var setLocale = /* @__PURE__ */ __name((locale, definition) => {
+  const mappedUnits = /* @__PURE__ */ new Map();
+  for (const [unit, def] of Object.entries(definition.units)) {
+    for (const name of def.names) {
+      mappedUnits.set(name.toLowerCase(), unit);
+    }
+  }
+  locales.set(locale, {
+    ...definition,
+    mappedUnits
+  });
+}, "setLocale");
+var defaultLocales = {
+  en: {
+    units: {
+      millisecond: {
+        short: "ms",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "milliseconds" : "millisecond", "long"),
+        names: ["milliseconds", "millisecond", "msecs", "msec", "ms"]
+      },
+      second: {
+        short: "s",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "seconds" : "second", "long"),
+        names: ["seconds", "second", "secs", "sec", "s"]
+      },
+      minute: {
+        short: "m",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "minutes" : "minute", "long"),
+        names: ["minutes", "minute", "mins", "min", "m"]
+      },
+      hour: {
+        short: "h",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "hours" : "hour", "long"),
+        names: ["hours", "hour", "hrs", "hr", "h"]
+      },
+      day: {
+        short: "d",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "days" : "day", "long"),
+        names: ["days", "day", "d"]
+      },
+      week: {
+        short: "w",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "weeks" : "week", "long"),
+        names: ["weeks", "week", "w"]
+      },
+      month: {
+        short: "mo",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "months" : "month", "long"),
+        names: ["months", "month", "mo"]
+      },
+      year: {
+        short: "y",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "years" : "year", "long"),
+        names: ["years", "year", "yrs", "yr", "y"]
+      }
+    }
+  },
+  fr: {
+    units: {
+      millisecond: {
+        short: "ms",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "millisecondes" : "milliseconde", "long"),
+        names: ["millisecondes", "milliseconde", "ms"]
+      },
+      second: {
+        short: "s",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "secondes" : "seconde", "long"),
+        names: ["secondes", "seconde", "secs", "sec", "s"]
+      },
+      minute: {
+        short: "m",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "minutes" : "minute", "long"),
+        names: ["minutes", "minute", "mins", "min", "m"]
+      },
+      hour: {
+        short: "h",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "heures" : "heure", "long"),
+        names: ["heures", "heure", "h"]
+      },
+      day: {
+        short: "j",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "jours" : "jour", "long"),
+        names: ["jours", "jour", "j"]
+      },
+      week: {
+        short: "sem",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "semaines" : "semaine", "long"),
+        names: ["semaines", "semaine", "sem"]
+      },
+      month: {
+        short: "mo",
+        long: /* @__PURE__ */ __name((_) => "mois", "long"),
+        names: ["mois", "mo"]
+      },
+      year: {
+        short: "an",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "ann\xE9es" : "ann\xE9e", "long"),
+        names: ["ann\xE9es", "annees", "ann\xE9e", "annee", "ans", "an"]
+      }
+    }
+  },
+  de: {
+    units: {
+      millisecond: {
+        short: "ms",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Millisekunden" : "Millisekunde", "long"),
+        names: ["millisekunden", "millisekunde", "ms"]
+      },
+      second: {
+        short: "s",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Sekunden" : "Sekunde", "long"),
+        names: ["sekunden", "sekunde", "seks", "sek", "s"]
+      },
+      minute: {
+        short: "m",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Minuten" : "Minute", "long"),
+        names: ["minuten", "minute", "mins", "min", "m"]
+      },
+      hour: {
+        short: "h",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Stunden" : "Stunde", "long"),
+        names: ["stunden", "stunde", "hrs", "hr", "h"]
+      },
+      day: {
+        short: "t",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Tage" : "Tag", "long"),
+        names: ["tage", "tag", "t", "d"]
+      },
+      week: {
+        short: "w",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Wochen" : "Woche", "long"),
+        names: ["wochen", "woche", "wo", "w"]
+      },
+      month: {
+        short: "mo",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Monate" : "Monat", "long"),
+        names: ["monate", "monat", "mon", "mo"]
+      },
+      year: {
+        short: "j",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "Jahre" : "Jahr", "long"),
+        names: ["jahre", "jahr", "j", "y"]
+      }
+    }
+  },
+  es: {
+    units: {
+      millisecond: {
+        short: "ms",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "milisegundos" : "milisegundo", "long"),
+        names: ["milisegundos", "milisegundo", "ms"]
+      },
+      second: {
+        short: "s",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "segundos" : "segundo", "long"),
+        names: ["segundos", "segundo", "s"]
+      },
+      minute: {
+        short: "min",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "minutos" : "minuto", "long"),
+        names: ["minutos", "minuto", "mins", "min", "m"]
+      },
+      hour: {
+        short: "h",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "horas" : "hora", "long"),
+        names: ["horas", "hora", "hrs", "hr", "h"]
+      },
+      day: {
+        short: "d",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "d\xEDas" : "d\xEDa", "long"),
+        names: ["d\xEDas", "dias", "d\xEDa", "dia", "d"]
+      },
+      week: {
+        short: "sem",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "semanas" : "semana", "long"),
+        names: ["semanas", "semana", "sem"]
+      },
+      month: {
+        short: "mes",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "meses" : "mes", "long"),
+        names: ["meses", "mes", "mo"]
+      },
+      year: {
+        short: "a",
+        long: /* @__PURE__ */ __name((c) => c > 1 ? "a\xF1os" : "a\xF1o", "long"),
+        names: ["a\xF1os", "anos", "a\xF1o", "ano", "a"]
+      }
+    }
+  }
+};
+for (const [locale, definition] of Object.entries(defaultLocales)) {
+  setLocale(locale, definition);
+}
+
+// src/units.ts
+import { Time } from "@sodiumlabs/duration";
+var unitValues = {
+  millisecond: Time.Millisecond,
+  second: Time.Second,
+  minute: Time.Minute,
+  hour: Time.Hour,
+  day: Time.Day,
+  week: Time.Week,
+  month: Time.Month,
+  year: Time.Year
+};
+
+// src/index.ts
+function ms(value, options) {
+  if (typeof value === "string") {
+    return parse(value, options);
+  } else if (typeof value === "number") {
+    return format(value, options);
+  }
+  throw new Error(`Value provided to ms() must be a string or number. value=${JSON.stringify(value)}`);
+}
+__name(ms, "ms");
+function parse(str, options) {
+  if (typeof str !== "string" || str.length === 0 || str.length > 100) {
+    throw new Error(
+      `Value provided to ms.parse() must be a string with length between 1 and 99. value=${JSON.stringify(str)}`
+    );
+  }
+  const locale = locales.get(options?.locale ?? "en");
+  if (!locale) {
+    throw new Error(`Unknown locale "${options?.locale}"`);
+  }
+  let total = 0;
+  let consumed = false;
+  const tokenRegex = /(?<value>-?\d*\.?\d+) *(?<unit>[a-zàèìòùáéíóúýâêîôûãñõäëïöüÿçµ]+)?/gi;
+  let match;
+  let lastIndex = 0;
+  while ((match = tokenRegex.exec(str)) !== null) {
+    if (str.slice(lastIndex, match.index).trim().length !== 0) {
+      return NaN;
+    }
+    const { value: rawValue, unit: rawUnit = "ms" } = match.groups;
+    const value = parseFloat(rawValue);
+    if (Number.isNaN(value)) {
+      return NaN;
+    }
+    const unit = !rawUnit ? "millisecond" : locale.mappedUnits.get(rawUnit.toLowerCase());
+    if (!unit) {
+      return NaN;
+    }
+    total += value * unitValues[unit];
+    consumed = true;
+    lastIndex = tokenRegex.lastIndex;
+  }
+  if (!consumed || str.slice(lastIndex).trim().length !== 0) {
+    return NaN;
+  }
+  return total;
+}
+__name(parse, "parse");
+function format(ms2, options) {
+  if (typeof ms2 !== "number" || !Number.isFinite(ms2)) {
+    throw new Error("Value provided to ms.format() must be of type number.");
+  }
+  const locale = locales.get(options?.locale ?? "en");
+  if (!locale) {
+    throw new Error(`Unknown locale "${options?.locale}"`);
+  }
+  const sign = ms2 < 0 ? "-" : "";
+  let remaining = Math.abs(ms2);
+  const units = Object.entries(locale.units).map(([unit, def]) => ({
+    unit,
+    def,
+    value: unitValues[unit]
+  })).sort((a, b) => b.value - a.value);
+  if (!options?.compound) {
+    for (const { def, value } of units) {
+      if (remaining >= value) {
+        const amount = Math.round(ms2 / value);
+        if (options?.long) {
+          return `${amount} ${def.long(Math.abs(amount))}`;
+        }
+        return `${amount}${def.short}`;
+      }
+    }
+    const msDef = locale.units.millisecond;
+    return options?.long ? `${ms2} ${msDef.long(Math.abs(ms2))}` : `${ms2}${msDef.short}`;
+  }
+  const parts = [];
+  let usedUnits = 0;
+  for (const { def, value } of units) {
+    if (remaining < value) continue;
+    const amount = Math.floor(remaining / value);
+    remaining -= amount * value;
+    if (amount > 0) {
+      parts.push(options?.long ? `${amount} ${def.long(amount)}` : `${amount}${def.short}`);
+      usedUnits++;
+      if (options?.maxUnits && usedUnits >= options.maxUnits) {
+        break;
+      }
+    }
+  }
+  if (parts.length === 0) {
+    const msDef = locale.units.millisecond;
+    parts.push(options?.long ? `0 ${msDef.long(0)}` : `0${msDef.short}`);
+  }
+  return sign + parts.join(options?.long ? " " : "");
+}
+__name(format, "format");
+export {
+  format,
+  ms,
+  parse
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/locales.ts","../src/units.ts","../src/index.ts"],"sourcesContent":["import { Unit } from \"./units\";\n\n/**\n * The options and translations of a locale.\n */\nexport interface LocaleDefinition {\n    units: Record<Unit, UnitDefinition>;\n}\n\n/**\n * The translations of a time unit.\n */\nexport interface UnitDefinition {\n    /**\n     * The short name of the unit.\n     */\n    short: string;\n    /**\n     * The long name of the unit.\n     *\n     * @example\n     * ```ts\n     * long: c => (c > 1 ? \"plural form\" : \"singular form\")\n     * ```\n     *\n     * @param c - The absolute value of the rounded number.\n     */\n    long: (c: number) => string;\n    /**\n     * The names of the unit. Should be all lowercase.\n     *\n     * @remarks\n     * The values of `short` and `long` are not automatically added\n     * to this array, so you probably want to add them here too\n     * if you want them to be used in the parse function.\n     */\n    names: string[];\n}\n\nexport type CompleteLocaleDefinition = LocaleDefinition & {\n    /**\n     * A map from the translated unit name to the corresponding unit name.\n     */\n    mappedUnits: Map<string, Unit>;\n};\n\n/**\n * The locales definitions. You can add or edit a locale definition directly here,\n * or use {@link setLocale}.\n */\nexport const locales = new Map<string, CompleteLocaleDefinition>();\n\n/**\n * Add or edit a locale definition.\n *\n * @param locale - The locale (e.g. `it`)\n * @param definition - The definition\n */\nexport const setLocale = (locale: string, definition: LocaleDefinition) => {\n    const mappedUnits = new Map<string, Unit>();\n    for (const [unit, def] of Object.entries(definition.units) as [Unit, UnitDefinition][]) {\n        for (const name of def.names) {\n            mappedUnits.set(name.toLowerCase(), unit);\n        }\n    }\n\n    locales.set(locale, {\n        ...definition,\n        mappedUnits,\n    });\n};\n\n// Define the default locales\n\nconst defaultLocales: Record<string, LocaleDefinition> = {\n    en: {\n        units: {\n            millisecond: {\n                short: \"ms\",\n                long: c => (c > 1 ? \"milliseconds\" : \"millisecond\"),\n                names: [\"milliseconds\", \"millisecond\", \"msecs\", \"msec\", \"ms\"],\n            },\n            second: {\n                short: \"s\",\n                long: c => (c > 1 ? \"seconds\" : \"second\"),\n                names: [\"seconds\", \"second\", \"secs\", \"sec\", \"s\"],\n            },\n            minute: {\n                short: \"m\",\n                long: c => (c > 1 ? \"minutes\" : \"minute\"),\n                names: [\"minutes\", \"minute\", \"mins\", \"min\", \"m\"],\n            },\n            hour: {\n                short: \"h\",\n                long: c => (c > 1 ? \"hours\" : \"hour\"),\n                names: [\"hours\", \"hour\", \"hrs\", \"hr\", \"h\"],\n            },\n            day: {\n                short: \"d\",\n                long: c => (c > 1 ? \"days\" : \"day\"),\n                names: [\"days\", \"day\", \"d\"],\n            },\n            week: {\n                short: \"w\",\n                long: c => (c > 1 ? \"weeks\" : \"week\"),\n                names: [\"weeks\", \"week\", \"w\"],\n            },\n            month: {\n                short: \"mo\",\n                long: c => (c > 1 ? \"months\" : \"month\"),\n                names: [\"months\", \"month\", \"mo\"],\n            },\n            year: {\n                short: \"y\",\n                long: c => (c > 1 ? \"years\" : \"year\"),\n                names: [\"years\", \"year\", \"yrs\", \"yr\", \"y\"],\n            },\n        },\n    },\n    fr: {\n        units: {\n            millisecond: {\n                short: \"ms\",\n                long: c => (c > 1 ? \"millisecondes\" : \"milliseconde\"),\n                names: [\"millisecondes\", \"milliseconde\", \"ms\"],\n            },\n            second: {\n                short: \"s\",\n                long: c => (c > 1 ? \"secondes\" : \"seconde\"),\n                names: [\"secondes\", \"seconde\", \"secs\", \"sec\", \"s\"],\n            },\n            minute: {\n                short: \"m\",\n                long: c => (c > 1 ? \"minutes\" : \"minute\"),\n                names: [\"minutes\", \"minute\", \"mins\", \"min\", \"m\"],\n            },\n            hour: {\n                short: \"h\",\n                long: c => (c > 1 ? \"heures\" : \"heure\"),\n                names: [\"heures\", \"heure\", \"h\"],\n            },\n            day: {\n                short: \"j\",\n                long: c => (c > 1 ? \"jours\" : \"jour\"),\n                names: [\"jours\", \"jour\", \"j\"],\n            },\n            week: {\n                short: \"sem\",\n                long: c => (c > 1 ? \"semaines\" : \"semaine\"),\n                names: [\"semaines\", \"semaine\", \"sem\"],\n            },\n            month: {\n                short: \"mo\",\n                long: _ => \"mois\",\n                names: [\"mois\", \"mo\"],\n            },\n            year: {\n                short: \"an\",\n                long: c => (c > 1 ? \"années\" : \"année\"),\n                names: [\"années\", \"annees\", \"année\", \"annee\", \"ans\", \"an\"],\n            },\n        },\n    },\n    de: {\n        units: {\n            millisecond: {\n                short: \"ms\",\n                long: c => (c > 1 ? \"Millisekunden\" : \"Millisekunde\"),\n                names: [\"millisekunden\", \"millisekunde\", \"ms\"],\n            },\n            second: {\n                short: \"s\",\n                long: c => (c > 1 ? \"Sekunden\" : \"Sekunde\"),\n                names: [\"sekunden\", \"sekunde\", \"seks\", \"sek\", \"s\"],\n            },\n            minute: {\n                short: \"m\",\n                long: c => (c > 1 ? \"Minuten\" : \"Minute\"),\n                names: [\"minuten\", \"minute\", \"mins\", \"min\", \"m\"],\n            },\n            hour: {\n                short: \"h\",\n                long: c => (c > 1 ? \"Stunden\" : \"Stunde\"),\n                names: [\"stunden\", \"stunde\", \"hrs\", \"hr\", \"h\"],\n            },\n            day: {\n                short: \"t\",\n                long: c => (c > 1 ? \"Tage\" : \"Tag\"),\n                names: [\"tage\", \"tag\", \"t\", \"d\"],\n            },\n            week: {\n                short: \"w\",\n                long: c => (c > 1 ? \"Wochen\" : \"Woche\"),\n                names: [\"wochen\", \"woche\", \"wo\", \"w\"],\n            },\n            month: {\n                short: \"mo\",\n                long: c => (c > 1 ? \"Monate\" : \"Monat\"),\n                names: [\"monate\", \"monat\", \"mon\", \"mo\"],\n            },\n            year: {\n                short: \"j\",\n                long: c => (c > 1 ? \"Jahre\" : \"Jahr\"),\n                names: [\"jahre\", \"jahr\", \"j\", \"y\"],\n            },\n        },\n    },\n    es: {\n        units: {\n            millisecond: {\n                short: \"ms\",\n                long: c => (c > 1 ? \"milisegundos\" : \"milisegundo\"),\n                names: [\"milisegundos\", \"milisegundo\", \"ms\"],\n            },\n            second: {\n                short: \"s\",\n                long: c => (c > 1 ? \"segundos\" : \"segundo\"),\n                names: [\"segundos\", \"segundo\", \"s\"],\n            },\n            minute: {\n                short: \"min\",\n                long: c => (c > 1 ? \"minutos\" : \"minuto\"),\n                names: [\"minutos\", \"minuto\", \"mins\", \"min\", \"m\"],\n            },\n            hour: {\n                short: \"h\",\n                long: c => (c > 1 ? \"horas\" : \"hora\"),\n                names: [\"horas\", \"hora\", \"hrs\", \"hr\", \"h\"],\n            },\n            day: {\n                short: \"d\",\n                long: c => (c > 1 ? \"días\" : \"día\"),\n                names: [\"días\", \"dias\", \"día\", \"dia\", \"d\"],\n            },\n            week: {\n                short: \"sem\",\n                long: c => (c > 1 ? \"semanas\" : \"semana\"),\n                names: [\"semanas\", \"semana\", \"sem\"],\n            },\n            month: {\n                short: \"mes\",\n                long: c => (c > 1 ? \"meses\" : \"mes\"),\n                names: [\"meses\", \"mes\", \"mo\"],\n            },\n            year: {\n                short: \"a\",\n                long: c => (c > 1 ? \"años\" : \"año\"),\n                names: [\"años\", \"anos\", \"año\", \"ano\", \"a\"],\n            },\n        },\n    },\n};\n\nfor (const [locale, definition] of Object.entries(defaultLocales)) {\n    setLocale(locale, definition);\n}\n","import { Time } from \"@sodiumlabs/duration\";\n\n/**\n * The available time units.\n */\nexport const units = [\"millisecond\", \"second\", \"minute\", \"hour\", \"day\", \"week\", \"month\", \"year\"] as const;\n\n/**\n * A time unit.\n */\nexport type Unit = (typeof units)[number];\n\n/**\n * The values in milliseconds of each time unit.\n */\nexport const unitValues: Record<Unit, number> = {\n    millisecond: Time.Millisecond,\n    second: Time.Second,\n    minute: Time.Minute,\n    hour: Time.Hour,\n    day: Time.Day,\n    week: Time.Week,\n    month: Time.Month,\n    year: Time.Year,\n};\n","import { locales } from \"./locales\";\nimport { Unit, unitValues } from \"./units\";\n\n/**\n * The options.\n */\nexport interface Options {\n    /**\n     * Set to `true` to use verbose formatting. Defaults to `false`.\n     */\n    long?: boolean;\n    /**\n     * The locale. Defaults to `en`.\n     */\n    locale?: string;\n    compound?: boolean;\n    maxUnits?: number;\n}\n\n/**\n * Parse or format the given value.\n *\n * @param value - The string or number to convert\n * @param options - Options for the conversion\n * @throws Error if `value` is not a non-empty string or a number\n */\nexport function ms(value: string, options?: Options): number;\nexport function ms(value: number, options?: Options): string;\nexport function ms(value: string | number, options?: Options): number | string {\n    if (typeof value === \"string\") {\n        return parse(value, options);\n    } else if (typeof value === \"number\") {\n        return format(value, options);\n    }\n    throw new Error(`Value provided to ms() must be a string or number. value=${JSON.stringify(value)}`);\n}\n\n/**\n * Parse the given string and return milliseconds.\n *\n * @param str - A string to parse into milliseconds. Length must be in [1;100]\n * @returns The parsed value in milliseconds, or `NaN` if the string can't be parsed\n */\nexport function parse(str: string, options?: Options): number {\n    if (typeof str !== \"string\" || str.length === 0 || str.length > 100) {\n        throw new Error(\n            `Value provided to ms.parse() must be a string with length between 1 and 99. value=${JSON.stringify(str)}`,\n        );\n    }\n\n    const locale = locales.get(options?.locale ?? \"en\");\n    if (!locale) {\n        throw new Error(`Unknown locale \"${options?.locale}\"`);\n    }\n\n    let total = 0;\n    let consumed = false;\n\n    const tokenRegex = /(?<value>-?\\d*\\.?\\d+) *(?<unit>[a-zàèìòùáéíóúýâêîôûãñõäëïöüÿçµ]+)?/gi;\n    let match: RegExpExecArray | null;\n    let lastIndex = 0;\n\n    while ((match = tokenRegex.exec(str)) !== null) {\n        if (str.slice(lastIndex, match.index).trim().length !== 0) {\n            return NaN;\n        }\n\n        const { value: rawValue, unit: rawUnit = \"ms\" } = match.groups as {\n            value: string;\n            unit: string | undefined;\n        };\n\n        const value = parseFloat(rawValue);\n        if (Number.isNaN(value)) {\n            return NaN;\n        }\n\n        const unit = !rawUnit ? \"millisecond\" : locale.mappedUnits.get(rawUnit.toLowerCase());\n        if (!unit) {\n            return NaN;\n        }\n\n        total += value * unitValues[unit];\n        consumed = true;\n\n        lastIndex = tokenRegex.lastIndex;\n    }\n\n    if (!consumed || str.slice(lastIndex).trim().length !== 0) {\n        return NaN;\n    }\n\n    return total;\n}\n\n/**\n * Format the given integer as a string.\n *\n * @param ms - milliseconds\n * @param options - Options for the conversion\n * @returns The formatted string\n */\nexport function format(ms: number, options?: Options): string {\n    if (typeof ms !== \"number\" || !Number.isFinite(ms)) {\n        throw new Error(\"Value provided to ms.format() must be of type number.\");\n    }\n\n    const locale = locales.get(options?.locale ?? \"en\");\n    if (!locale) {\n        throw new Error(`Unknown locale \"${options?.locale}\"`);\n    }\n\n    const sign = ms < 0 ? \"-\" : \"\";\n    let remaining = Math.abs(ms);\n\n    // units sorted by descending size\n    const units = Object.entries(locale.units)\n        .map(([unit, def]) => ({\n            unit,\n            def,\n            value: unitValues[unit as Unit],\n        }))\n        .sort((a, b) => b.value - a.value);\n\n    // === simple mode (current behavior) ===\n    if (!options?.compound) {\n        for (const { def, value } of units) {\n            if (remaining >= value) {\n                const amount = Math.round(ms / value);\n\n                if (options?.long) {\n                    return `${amount} ${def.long(Math.abs(amount))}`;\n                }\n\n                return `${amount}${def.short}`;\n            }\n        }\n\n        const msDef = locale.units.millisecond;\n        return options?.long ? `${ms} ${msDef.long(Math.abs(ms))}` : `${ms}${msDef.short}`;\n    }\n\n    // === compound mode ===\n    const parts: string[] = [];\n    let usedUnits = 0;\n\n    for (const { def, value } of units) {\n        if (remaining < value) continue;\n\n        const amount = Math.floor(remaining / value);\n        remaining -= amount * value;\n\n        if (amount > 0) {\n            parts.push(options?.long ? `${amount} ${def.long(amount)}` : `${amount}${def.short}`);\n\n            usedUnits++;\n            if (options?.maxUnits && usedUnits >= options.maxUnits) {\n                break;\n            }\n        }\n    }\n\n    // fallback if everything was < 1ms\n    if (parts.length === 0) {\n        const msDef = locale.units.millisecond;\n        parts.push(options?.long ? `0 ${msDef.long(0)}` : `0${msDef.short}`);\n    }\n\n    return sign + parts.join(options?.long ? \" \" : \"\");\n}\n"],"mappings":"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","names":["ms"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "@sodiumlabs/ms",
+  "version": "1.0.0",
+  "description": "Utility to convert various time formats to milliseconds",
+  "keywords": [
+    "enhanced",
+    "localized",
+    "ms",
+    "parse",
+    "sodium",
+    "sodiumlabs",
+    "time",
+    "typescript"
+  ],
+  "homepage": "https://github.com/sodium-labs/utilities/tree/main/packages/ms",
+  "bugs": {
+    "url": "https://github.com/sodium-labs/utilities/issues"
+  },
+  "license": "MIT",
+  "author": "sodiumlabs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sodium-labs/utilities.git",
+    "directory": "packages/ms"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "dependencies": {
+    "@sodiumlabs/duration": "^1.0.1"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.55.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:docs": "tsc -p tsconfig.docs.json",
+    "lint": "tsc --noEmit && oxlint && oxfmt --check",
+    "fmt": "oxfmt",
+    "test": "vitest run",
+    "docs": "npm run build:docs && api-extractor run --local"
+  }
+}