Utils

bun add @talosjs/utils

import { capitalize } from "@talosjs/utils/capitalize";
import { toCamelCase } from "@talosjs/utils/toCamelCase";
import { toPascalCase } from "@talosjs/utils/toPascalCase";
import { toKebabCase } from "@talosjs/utils/toKebabCase";
import { toSnakeCase } from "@talosjs/utils/toSnakeCase";
import { splitToWords } from "@talosjs/utils/splitToWords";
import { trim } from "@talosjs/utils/trim";

capitalize("hELLO");              // "Hello"

toCamelCase("user_first_name");   // "userFirstName"
toPascalCase("user-first-name");  // "UserFirstName"
toKebabCase("HTMLElement");       // "html-element"
toSnakeCase("Apple123 Pie");      // "apple123_pie"

splitToWords("HTMLElement v2");   // ["HTML", "Element", "v2"]

trim("  hello  ");                // "hello" (defaults to spaces)
trim("[value]", "[");             // "value]" -> char is auto-escaped for regex

import { parseString } from "@talosjs/utils/parseString";
import { parseEnvVars } from "@talosjs/utils/parseEnvVars";

parseString("42");          // 42 (number)
parseString("3.14");        // 3.14 (number)
parseString("true");        // true (boolean)
parseString("null");        // null
parseString("[1, two, 3]"); // [1, "two", 3] (recursively parsed)
parseString("plain text");  // "plain text"

const config = parseEnvVars<{ appPort: number; appDebug: boolean }>({
  APP_PORT: "3000",
  APP_DEBUG: "true",
});
// { appPort: 3000, appDebug: true }

import { secondsToHMS } from "@talosjs/utils/secondsToHMS";
import { secondsToMS } from "@talosjs/utils/secondsToMS";
import { millisecondsToHMS } from "@talosjs/utils/millisecondsToHMS";
import { sleep } from "@talosjs/utils/sleep";

secondsToHMS(3661);        // "1:01:01"
secondsToHMS(75);          // "1:15"
secondsToMS(75);           // "1:15" (always minutes:seconds)
millisecondsToHMS(65000);  // "1:05"

await sleep(500);          // resolves after 500ms

import { formatRelativeNumber } from "@talosjs/utils/formatRelativeNumber";
import { random } from "@talosjs/utils/random";

formatRelativeNumber(1500);                       // "1.5K"
formatRelativeNumber(2_400_000);                  // "2.4M"
formatRelativeNumber(1500, { lang: "fr-FR" });    // "1,5 k"

random.id();          // 20-char hex string, e.g. "9f3a...c1"
random.nanoid(12);    // 12-char hex string
random.stringInt(6);  // 6-digit numeric string, e.g. "048213"

const generate = random.nanoidFactory(8); // reusable generator
generate();           // 8-char hex string

import { trans, has, type TransDictType } from "@talosjs/utils/trans";

const dict: TransDictType = {
  cart: {
    items: { en: "{{ count }} item", fr: "{{ count }} article" },
    items_plural: { en: "{{ count }} items", fr: "{{ count }} articles" },
  },
};

has(dict, "cart.items"); // true

const result = trans(dict, "cart.items", { lang: "fr", count: 3 });
if (result.found) {
  result.value; // "3 articles"
}

trans(dict, "cart.missing"); // { found: false, reason: "key" }

import { dataURLtoFile } from "@talosjs/utils/dataURLtoFile";

const file = dataURLtoFile(canvas.toDataURL("image/png"), "avatar.png");
// File { name: "avatar.png", type: "image/png" }