nc.str

str.capitalize("hELLO wORLD"); // "Hello world"

str.titleCase("the quick brown fox"); // "The Quick Brown Fox"
str.titleCase("élodie o'neil");       // "Élodie O'neil"

str.sentenceCase("hELLO WORLD. how ARE you?"); // "Hello world. How are you?"

str.camelCase("user_first-name"); // "userFirstName"
str.camelCase("XMLHttpRequest");  // "xmlHttpRequest"

str.pascalCase("hello world"); // "HelloWorld"

str.snakeCase("helloWorld"); // "hello_world"

str.kebabCase("helloWorld"); // "hello-world"

str.constantCase("helloWorld"); // "HELLO_WORLD"

str.dotCase("userFirstName"); // "user.first.name"

str.words("helloWorld-foo_bar"); // ["hello", "World", "foo", "bar"]

str.deburr("Crème brûlée"); // "Creme brulee"
str.deburr("Straße");       // "Strasse"

str.slugify("Héllo, World!");                      // "hello-world"
str.slugify("Crème Brûlée", { separator: "_" });   // "creme_brulee"
str.slugify("A very long title", { maxLength: 8 }); // "a-very"

str.squish("  hello \n\t world  "); // "hello world"

str.stripTags("<p>Hello <b>world</b></p>"); // "Hello world"

str.escapeHTML('<a href="x">Tom & Jerry</a>');
// "&lt;a href=&quot;x&quot;&gt;Tom &amp; Jerry&lt;/a&gt;"

str.unescapeHTML("Tom & Jerry 😀"); // "Tom & Jerry 😀"

new RegExp(str.escapeRegExp("1+1=2?")).test("1+1=2?"); // true

"👨‍👩‍👧".length;         // 8
str.length("👨‍👩‍👧");     // 1

str.byteLength("é");  // 2
str.byteLength("😀"); // 4

str.count("banana", "a"); // 3
str.count("aaaa", "aa");  // 2

str.truncate("Hello world", 8);                        // "Hello w…"
str.truncate("Hello world", 8, { omission: "..." });   // "Hello..."
str.truncate("Hello big world", 12, { words: true });  // "Hello big…"

str.between("Hello [world]!", "[", "]"); // "world"

str.splitOnce("key=value=more", "="); // ["key", "value=more"]
str.splitOnce("novalue", "=");        // ["novalue", undefined]

str.lines("a\r\nb\nc"); // ["a", "b", "c"]

str.padStart("7", 3, "0"); // "007"

str.padEnd("ab", 5, "."); // "ab..."

str.center("hi", 7, "*"); // "**hi***"

str.indent("a\nb", 2);    // "  a\n  b"
str.indent("a\nb", "> "); // "> a\n> b"

const sql = str.dedent`
  SELECT *
    FROM users
   WHERE id = ${id}
`;
// "SELECT *\n  FROM users\n WHERE id = 42"

str.wrap("The quick brown fox jumps over the lazy dog", 16);
// "The quick brown\nfox jumps over\nthe lazy dog"

str.reverse("añ👍🏽"); // "👍🏽ña"

str.mask("4242424242424242");                           // "************4242"
str.mask("4242 4242 4242 4242", { keepSpaces: true });   // "**** **** **** 4242"
str.mask("secret-token", { start: 2, end: 2, char: "•" }); // "se••••••••en"

str.initials("Ada Lovelace");       // "AL"
str.initials("jean-luc picard", 3); // "JLP"

str.plural(1, { one: "file", other: "files" });                           // "1 file"
str.plural(1234, { one: "item", other: "items" });                        // "1,234 items"
str.plural(0, { zero: "no files", one: "file", other: "files" });         // "no files"
str.plural(0, { one: "fichier", other: "fichiers" }, { locale: "fr" });   // "0 fichier"

str.template("Hi {name}, you have {count} messages", { name: "Jo", count: 3 });
// "Hi Jo, you have 3 messages"
str.template("Hello {{ user.name }}", { user: { name: "Ada" } }, { open: "{{", close: "}}" });
// "Hello Ada"

str.ensurePrefix("example.com", "https://"); // "https://example.com"

str.ensureSuffix("path/to", "/"); // "path/to/"

str.removePrefix("https://example.com", "https://"); // "example.com"

str.removeSuffix("report.pdf", ".pdf"); // "report"

["file10", "file2", "File1"].sort(str.compare); // ["File1", "file2", "file10"]
str.compare("a", "A", { sensitivity: "base" }); // 0

str.levenshtein("kitten", "sitting"); // 3

str.similarity("hello", "hallo"); // 0.8

str.closest("instal", ["install", "uninstall", "list"]); // "install"
str.closest("xyz", ["install", "list"]);                 // undefined

str.random();                                // "aZ3kP9qL0xYb7TcW"
str.random(6, { charset: "0123456789" });    // "402917"