@zinaid/str 0.0.1

package/dist/str.d.ts

@@ -0,0 +1,846 @@
+/**
+ * Return the remainder of a string after the last occurrence of a given value.
+ *
+ * @example
+ *
+ * after('A house on a lake', 'house '); -> 'on a lake'
+ */
+export declare function after(subject: string, search: string | number): string;
+/**
+ * Return the remainder of a string after the last occurrence of a given value.
+ *
+ * @example
+ *
+ * afterLast('A house on a lake', 'a'); -> ' lake'
+ */
+export declare function afterLast(subject: string, search: string | number): string;
+/**
+ * Transliterate a UTF-8 value to ASCII.
+ *
+ * @example
+ *
+ * ascii('Héllo Wörld'); -> 'Hello World'
+ */
+export declare function ascii(value: string): string;
+/**
+ * Transliterate a string to its closest ASCII representation.
+ *
+ * @example
+ *
+ * transliterate('ⓣⓔⓢⓣ@ⓛⓐⓡⓐⓥⓔⓛ.ⓒⓞⓜ'); -> 'test@laravel.com'
+ */
+export declare function transliterate(value: string): string;
+/**
+ * Get the portion of a string before the first occurrence of a given value.
+ *
+ * @example
+ *
+ * before('hannah', 'nah'); -> 'han'
+ */
+export declare function before(subject: string, search: string | number): string;
+/**
+ * Get the portion of a string before the last occurrence of a given value.
+ *
+ * @example
+ *
+ * beforeLast('yvette', 'tte'); -> 'yve'
+ */
+export declare function beforeLast(subject: string, search: string | number): string;
+/**
+ * Get the portion of a string between two given values.
+ *
+ * @example
+ *
+ * between('foofoobar', 'foo', 'bar'); -> 'foo'
+ */
+export declare function between(subject: string, from: string | number, to: string | number): string;
+/**
+ * Get the smallest possible portion of a string between two given values.
+ *
+ * @example
+ *
+ * betweenFirst('foofoobar', 'foo', 'bar'); -> 'foo'
+ */
+export declare function betweenFirst(subject: string, from: string | number, to: string | number): string;
+/**
+ * Convert a value to camel case.
+ *
+ * @example
+ *
+ * camel('foo_bar'); -> 'fooBar'
+ */
+export declare function camel(value: string): string;
+/**
+ * Get the character at the specified index.
+ *
+ * @example
+ *
+ * charAt('hello', 1); -> 'e'
+ */
+export declare function charAt(subject: string, index: number): string | false;
+/**
+ * Remove the given string(s) if it exists at the start of the haystack.
+ *
+ * @example
+ *
+ * chopStart('foobar', 'foo'); -> 'bar'
+ */
+export declare function chopStart(subject: string, needle: string | string[]): string;
+/**
+ * Remove the given string(s) if it exists at the end of the haystack.
+ *
+ * @example
+ *
+ * chopEnd('foobar', 'bar'); -> 'foo'
+ */
+export declare function chopEnd(subject: string, needle: string | string[]): string;
+/**
+ * Determine if a given string contains a given substring.
+ *
+ * @example
+ *
+ * contains('Minion', 'ni'); -> true
+ * contains('Minion', 'Ni', true); -> true
+ * contains('Minion', 'Ni', false); -> false
+ */
+export declare function contains(haystack: string, needles: string | Iterable<string>, ignoreCase?: boolean): boolean;
+/**
+ * Extracts an excerpt from text that matches the first instance of a phrase.
+ *
+ * @example
+ * excerpt('The quick brown fox', 'brown', { radius: 5 });
+ */
+export declare function excerpt(text: string | null, phrase?: string | null, options?: {
+    radius?: number;
+    omission?: string;
+}): string | null;
+/**
+ * Determine if a given string contains all array values.
+ *
+ * @example
+ *
+ * containsAll('Taylor Otwell', ['taylor', 'otwell'], false); -> true
+ * containsAll('Taylor Otwell', ['taylor', 'xxx'], true); -> false
+ */
+export declare function containsAll(haystack: string, needles: Iterable<string>, ignoreCase?: boolean): boolean;
+/**
+ * Determine if a given string doesn't contain a given substring.
+ *
+ * @example
+ *
+ * doesntContain('Minion', 'ni'); -> false
+ * doesntContain('Minion', 'Ni', true); -> false
+ * doesntContain('Minion', 'Ni', false); -> true
+ */
+export declare function doesntContain(haystack: string, needles: string | Iterable<string>, ignoreCase?: boolean): boolean;
+/**
+ * Replace consecutive instances of a given character with a single character in the given string.
+ *
+ * @example
+ *
+ * deduplicate('hello  world'); -> 'hello world'
+ * deduplicate('hello---world', '-'); -> 'hello-world'
+ * deduplicate('hello___world', '_'); -> 'hello-world'
+ * deduplicate('hello  world', ' '); -> 'hello world'
+ */
+export declare function deduplicate(value: string, character?: string | string[]): string;
+/**
+ * Determine if a given string ends with a given substring.
+ *
+ * @example
+ *
+ * endsWith("Jason", "on"); -> true
+ * endsWith("Jason", "ON"); -> false
+ */
+export declare function endsWith(haystack: string | number | null, needles: string | number | Iterable<string>): boolean;
+/**
+ * Determine if a given string doesn't end with a given substring.
+ *
+ * @example
+ *
+ * doesntEndWith("Jason", "on"); -> false
+ * doesntEndWith("Jason", "ON"); -> true
+ */
+export declare function doesntEndWith(haystack: string | number | null, needles: string | number | Iterable<string>): boolean;
+/**
+ * Cap a string with a single instance of a given value.
+ *
+ * @example
+ *
+ * finish('hello', '!'); -> 'hello!'
+ */
+export declare function finish(value: string, cap: string): string;
+/**
+ * Wrap the string with the given strings.
+ *
+ * @example
+ *
+ * wrap('hello', '[', ']'); -> '[hello]'
+ */
+export declare function wrap(value: string, before: string, after?: string | null): string;
+/**
+ * Unwrap the string with the given strings.
+ *
+ * @example
+ *
+ * unwrap('[hello]', '[', ']'); -> 'hello'
+ */
+export declare function unwrap(value: string, before: string, after?: string | null): string;
+/**
+ * Determine if a given string matches a given pattern.
+ *
+ * @example
+ *
+ * is('hello', 'hello'); -> true
+ * is('hello', 'Hello', true); -> true
+ * is('hello', 'world'); -> false
+ */
+export declare function is(pattern: string | Iterable<string>, value: string | number, ignoreCase?: boolean): boolean;
+/**
+ * Determine if a given string is 7 bit ASCII.
+ *
+ * @example
+ *
+ * isAscii("Hello World"); -> true
+ * isAscii("こんにちは"); -> false
+ * isAscii("12345"); -> true
+ * isAscii("!@#$%"); -> true
+ * isAscii("Hello こんにちは"); -> false
+ */
+export declare function isAscii(value: string): boolean;
+/**
+ * Determine if a given value is valid JSON.
+ *
+ * @example
+ *
+ * isJson('{"name": "John", "age": 30}'); -> true
+ * isJson('{"name": "John", "age": 30'); -> false
+ * isJson('Hello World'); -> false
+ */
+export declare function isJson(value: unknown): boolean;
+/**
+ * Determine if a given value is a valid URL.
+ *
+ * @param value - The value to check if it's URL
+ * @param protocols - An optional array of allowed protocols (e.g., ['http', 'https'])
+ *
+ * @example
+ *
+ * isUrl('https://laravel.com'); -> true
+ * isUrl('http://localhost'); -> true
+ * isUrl('invalid url'); -> false
+ */
+export declare function isUrl(value: string | unknown, protocols?: string[]): boolean;
+/**
+ * Determine if a given value is a valid UUID.
+ *
+ * @example
+ *
+ * isUuid("550e8400-e29b-41d4-a716-446655440000", 4); -> true
+ * isUuid("550e8400-e29b-41d4-a716-446655440000", 5); -> false
+ */
+export declare function isUuid(value: string | unknown, version?: number | "nil" | "max" | null): boolean;
+/**
+ * Determine if a given value is a valid ULID.
+ *
+ * @example
+ *
+ * isUlid("01F8MECHZX2D7J8F8C8D4B8F8C"); -> true
+ */
+export declare function isUlid(value: unknown): boolean;
+/**
+ * Convert a string to kebab case.
+ *
+ * @example
+ *
+ * kebab("Laravel PHP Framework"); -> "laravel-php-framework"
+ */
+export declare function kebab(value: string): string;
+/**
+ * Return the length of the given string.
+ *
+ * @example
+ *
+ * length("Hello World"); -> 11
+ */
+export declare function length(value: string): number;
+/**
+ * Limit the number of characters in a string.
+ *
+ * @param  string  $value
+ * @param  int  $limit
+ * @param  string  $end
+ * @param  bool  $preserveWords
+ * @return string
+ */
+export declare function limit(value: string, limit?: number, end?: string, preserveWords?: boolean): string;
+/**
+ * Convert the given string to lower-case.
+ *
+ * @example
+ *
+ * lower("Hello World"); -> "hello world"
+ */
+export declare function lower(value: string): string;
+/**
+ * Limit the number of words in a string.
+ *
+ * @example
+ *
+ * words("Laravel PHP Framework", 2); -> "Laravel PHP Framework"
+ * words("Laravel PHP Framework", 1); -> "Laravel..."
+ */
+export declare function words(value: string, words?: number, end?: string): string;
+/**
+ * Masks a portion of a string with a repeated character.
+ *
+ * @example
+ *
+ * mask("taylor@email.com", "*", 3); -> "tay*************"
+ * mask("taylor@email.com", "*", 0, 6); -> "******@email.com"
+ * mask("taylor@email.com", "*", -13); -> "tay*************"
+ * mask("taylor@email.com", "*", -13, 3); -> "tay***@email.com"
+ */
+export declare function mask(value: string, character: string, index: number, length?: number | null): string;
+/**
+ * Get the string matching the given pattern.
+ *
+ * @param  string  $pattern
+ * @param  string  $subject
+ * @return string
+ */
+export declare function match(pattern: string, subject: string): string;
+/**
+ * Determine if a given string matches a given pattern.
+ *
+ * @example
+ *
+ * Str::isMatch('/foo/', 'foo bar'); // true
+ * Str::isMatch('/bar/', 'foo bar'); // false
+ */
+export declare function isMatch(pattern: string | Iterable<string>, value: string): boolean;
+/**
+ * Get the string matching the given pattern.
+ *
+ * @example
+ *
+ * matchAll("/foo (.*)/", "foo bar baz"); -> ["foo bar baz"]
+ */
+export declare function matchAll(pattern: string, subject: string): string[];
+/**
+ * Remove all non-numeric characters from a string.
+ *
+ * @example
+ *
+ * numbers("foo123bar"); -> "123"
+ * numbers(["foo123bar", "abc456"]); -> ["123", "456"]
+ */
+export declare function numbers(value: string | string[]): string | string[];
+/**
+ * Pad both sides of a string with another.
+ *
+ * @param  string  $value
+ * @param  int  $length
+ * @param  string  $pad
+ * @return string
+ */
+export declare function padBoth(value: string, length: number, pad?: string): string;
+/**
+ * Pad the left side of a string with another.
+ *
+ * @example
+ *
+ * padLeft("Alien", 10, "-="); -> "-=-=-Alien"
+ * padLeft("Alien", 10); -> "     Alien"
+ * padLeft("❤MultiByte☆", 16); -> "     ❤MultiByte☆"
+ * padLeft("❤MultiByte☆", 16, "❤☆"); -> "❤☆❤☆❤❤MultiByte☆"
+ */
+export declare function padLeft(value: string, length: number, pad?: string): string;
+/**
+ * Pad the right side of a string with another.
+ *
+ * @example
+ *
+ * padRight("Alien", 10, "-="); -> "Alien-=-="
+ * padRight("Alien", 10); -> "Alien     "
+ * padRight("❤MultiByte☆", 16); -> "❤MultiByte☆     "
+ * padRight("❤MultiByte☆", 16, "❤☆"); -> "❤MultiByte☆❤☆❤☆"
+ */
+export declare function padRight(value: string, length: number, pad?: string): string;
+/**
+ * Create a padding string.
+ *
+ * @example
+ *
+ * makePad(" ", 5); -> "     "
+ * makePad("-", 5); -> "-----"
+ * makePad("❤", 5); -> "❤❤❤❤❤"
+ */
+export declare function makePad(padStr: string, needed: number): string;
+/**
+ * Pluralize the last word of an English, studly caps case string.
+ *
+ * @example
+ *
+ * pluralStudly("These are the school", 4); -> "These are the schools"
+ */
+export declare function pluralStudly(value: string, count?: number): string;
+/**
+ * Pluralize the last word of an English, Pascal caps case string.
+ *
+ * @example
+ *
+ * pluralPascal("These are the school", 4); -> "These are the schools"
+ */
+export declare function pluralPascal(value: string, count?: number): string;
+/**
+ * Generate a random, secure password.
+ *
+ * Mirrors Laravel's Str::password behavior:
+ * - Ensures at least one character from each enabled set
+ * - Uses a combined pool for remaining characters
+ * - Shuffles result and returns a string of requested length
+ *
+ * @param length The desired length of the password (default: 32)
+ * @param letters Whether to include letters (default: true)
+ * @param numbers Whether to include numbers (default: true)
+ * @param symbols Whether to include symbols (default: true)
+ * @param spaces Whether to include spaces (default: false)
+ * @return The generated password string
+ */
+export declare function password(length?: number, letters?: boolean, numbers?: boolean, symbols?: boolean, spaces?: boolean): string;
+/**
+ * Find the multi-byte safe position of the first occurrence of a given substring in a string.
+ *
+ * @example
+ *
+ * position('Hello, World!', 'World!'); -> 7
+ * position('Hello, World!', 'world!', 0); -> false
+ */
+export declare function position(haystack: string, needle: string, offset?: number): number | false;
+/**
+ * Generate a more truly "random" alpha-numeric string.
+ *
+ * @example
+ *
+ * random(); -> "a1b2c3d4e5f6g7h8"
+ */
+export declare function random(length?: number): string;
+/**
+ * Set the callable that will be used to generate random strings.
+ *
+ * @example
+ *
+ * createRandomStringsUsing((length) => "x".repeat(length));
+ */
+export declare function createRandomStringsUsing(factory: ((length: number) => string) | null): void;
+/**
+ * Set the sequence that will be used to generate random strings.
+ *
+ * @example
+ *
+ * createRandomStringsUsingSequence(['a', 'b', 'c']);
+ * createRandomStringsUsingSequence(['x', 'y', 'z'], (length) => "z".repeat(length));
+ */
+export declare function createRandomStringsUsingSequence(sequence: string[], whenMissing?: (length: number) => string): void;
+/**
+ * Indicate that random strings should be created normally and not using a custom factory.
+ *
+ * @example
+ *
+ * createRandomStringsNormally();
+ */
+export declare function createRandomStringsNormally(): void;
+/**
+ * Repeat the given string.
+ *
+ * @example
+ *
+ * repeat("foo", 3); -> "foofoofoo"
+ */
+export declare function repeat(string: string, times: number): string;
+/**
+ * Replace a given value in the string sequentially with an array.
+ *
+ * @example
+ *
+ * replaceArray('?', ['foo', 'bar', 'baz'], '?/?/?'); -> 'foo/bar/baz'
+ * replaceArray('?', ['foo', 'bar', 'baz'], '?/?/?/?'); -> 'foo/bar/baz/?'
+ * replaceArray('?', {'x' => 'foo', 'y' => 'bar'}, '?/?'); -> 'foo/bar'
+ */
+export declare function replaceArray(search: string, replace: Record<string, string> | Iterable<string>, subject: string): string;
+/**
+ * Convert the given value to a string or return the given fallback on failure.
+ *
+ * @example
+ *
+ * toStringOr(123);
+ */
+export declare function toStringOr(value: unknown, fallback: string): string;
+/**
+ * Replace the given value in the given string.
+ *
+ * @example
+ *
+ * replace("foo", "bar", "foo baz"); -> "bar baz"
+ */
+export declare function replace<T extends string | Iterable<string>>(search: string | Iterable<string>, replacement: string | Iterable<string>, subject: T, caseSensitive?: boolean): T extends string ? string : string[];
+/**
+ * Replace the first occurrence of a given value in the string.
+ *
+ * @example
+ *
+ * replaceFirst('bar', 'qux', 'foobar foobar'); -> 'fooqux foobar'
+ */
+export declare function replaceFirst(search: string | number, replace: string, subject: string): string;
+/**
+ * Replace the first occurrence of the given value if it appears at the start of the string.
+ *
+ * @param  string  $search
+ * @param  string  $replace
+ * @param  string  $subject
+ * @return string
+ */
+export declare function replaceStart(search: string | number, replace: string, subject: string): string;
+/**
+ * Replace the last occurrence of a given value in the string.
+ *
+ * @example
+ *
+ * replaceLast('bar', 'qux', 'foobar foobar'); -> 'foobar foobarqux'
+ */
+export declare function replaceLast(search: string | number, replace: string, subject: string): string;
+/**
+ * Replace the last occurrence of a given value if it appears at the end of the string.
+ *
+ * @example
+ *
+ * replaceEnd('bar', 'qux', 'foobar foobar'); -> 'foobar fooqux'
+ */
+export declare function replaceEnd(search: string | number, replace: string, subject: string): string;
+/**
+ * Replace the patterns matching the given regular expression.
+ *
+ * @example
+ *
+ * replaceMatches(/foo/, 'bar', 'foobar'); -> 'barbar'
+ * replaceMatches(/foo/, ['bar', 'baz'], 'foobar'); -> ['barbar', 'foobaz']
+ * replaceMatches(/foo/, (match) => match[1]!.toUpperCase(), 'foobar'); -> 'Bar'
+ */
+export declare function replaceMatches(pattern: string | string[] | RegExp | RegExp[], replace: string | string[] | ((match: string[]) => string), subject: string | string[], limit?: number): string | string[] | null;
+/**
+ * Strip HTML tags from a string.
+ *
+ * @example
+ *
+ * stripTags("<p>Hello World</p>"); -> "Hello World"
+ */
+export declare function stripTags(value: string): string;
+/**
+ * Remove any occurrence of the given string in the subject.
+ *
+ * @example
+ *
+ * remove("foo", "foobar"); -> "bar"
+ * remove(["foo", "bar"], "foobar"); -> ""
+ */
+export declare function remove(search: string | Iterable<string>, subject: string | Iterable<string>, caseSensitive?: boolean): string | string[];
+/**
+ * Reverse the given string.
+ *
+ * @example
+ *
+ * reverse("hello"); -> "olleh"
+ * reverse("world"); -> "dlrow"
+ * reverse(""); -> ""
+ */
+export declare function reverse(value: string): string;
+/**
+ * Begin a string with a single instance of a given value.
+ *
+ * @example
+ *
+ * start("test/string", "/"); -> "/test/string"
+ * start("/test/string", "/"); -> "/test/string"
+ * start("//test/string", "/"); -> "/test/string"
+ */
+export declare function start(value: string, prefix: string): string;
+/**
+ * Convert the given string to proper case for each word.
+ *
+ * @example
+ *
+ * headline("foo bar baz"); -> "Foo Bar Baz"
+ * headline("foO bAr BaZ"); -> "Foo Bar Baz"
+ */
+export declare function headline(value: string): string;
+/**
+ * Convert the given string to APA-style title case.
+ *
+ * See: https://apastyle.apa.org/style-grammar-guidelines/capitalization/title-case
+ *
+ * @example
+ *
+ * apa("foo bar baz"); -> "Foo Bar Baz"
+ * apa("foO bAr BaZ"); -> "Foo Bar Baz"
+ */
+export declare function apa(value: string): string;
+/**
+ * Generate a URL friendly "slug" from a given string.
+ *
+ * @param  string  $title
+ * @param  string  $separator
+ * @param  array<string, string>  $dictionary
+ * @return string
+ */
+export declare function slug(title: string, separator?: string, dictionary?: Record<string, string>): string;
+/**
+ * Convert a string to snake case.
+ *
+ * @param  string  $value
+ * @param  string  $delimiter
+ * @return string
+ */
+export declare function snake(value: string, delimiter?: string): string;
+/**
+     * Remove all "extra" blank space from the given string.
+     *
+     * @example
+     *
+     * squish(`
+        foo
+        bar
+       `); -> "foo bar"
+     */
+export declare function squish(value: string): string;
+/**
+ * Determine if a given string starts with a given substring.
+ *
+ * @example
+ *
+ * startsWith("hello world", "hello"); -> true
+ * startsWith("hello world", "world"); -> false
+ */
+export declare function startsWith(haystack: string | number | null, needles: string | number | null | Iterable<string | number | null>): boolean;
+/**
+ * Determine if a given string doesn't start with a given substring.
+ *
+ * @example
+ *
+ * expect(doesntStartWith("jason", ["day"])).toBe(true);
+ */
+export declare function doesntStartWith(haystack: string | number | null, needles: string | number | null | Iterable<string | number | null>): boolean;
+/**
+ * Convert a value to studly caps case.
+ *
+ * @example
+ *
+ * studly("fooBar"); -> "FooBar"
+ * studly("foo_bar"); -> "FooBar"
+ * studly("foo-barBaz"); -> "FooBarBaz"
+ */
+export declare function studly(value: string): string;
+/**
+ * Convert a value to Pascal case.
+ *
+ * @param  string  $value
+ * @return string
+ */
+export declare function pascal(value: string): string;
+/**
+ * Swap multiple keywords in a string with other keywords.
+ *
+ * @example
+ *
+ * swap(
+ *     {
+ *         'foo': 'bar',
+ *         'baz': 'qux',
+ *     },
+ *     'foo baz'
+ * ); -> 'bar qux'
+ */
+export declare function swap(map: Record<string, string>, subject: string): string;
+/**
+ * Take the first or last {$limit} characters of a string.
+ *
+ * @example
+ *
+ * take("hello world", 5); -> "hello"
+ * take("hello world", -5); -> "world"
+ */
+export declare function take(value: string, limit: number): string;
+/**
+ * Make a string's first character lowercase.
+ *
+ * @example
+ *
+ * lcfirst('Hello World'); -> 'hello World'
+ */
+export declare function lcfirst(value: string): string;
+/**
+ * Make a string's first character uppercase.
+ *
+ * @example
+ *
+ * ucfirst('hello world'); -> 'Hello world'
+ */
+export declare function ucfirst(value: string): string;
+/**
+ * Split a string into pieces by uppercase characters.
+ *
+ * @example
+ *
+ * ucsplit('laravelPHPFramework'); -> ['laravel', 'P', 'H', 'P', 'Framework']
+ * ucsplit('Laravel-phP-framework'); -> ['Laravel-ph', 'P-framework']
+ * ucsplit('ÖffentlicheÜberraschungen'); -> ['Öffentliche', 'Überraschungen']
+ */
+export declare function ucsplit(value: string): string[];
+/**
+ * Uppercase the first letter of each word in a string.
+ *
+ * @example
+ *
+ * ucwords('hello world'); -> 'Hello World'
+ * ucwords('laravel php framework'); -> 'Laravel Php Framework'
+ * ucwords('Öffentliche Überraschungen'); -> 'Öffentliche Überraschungen'
+ */
+export declare function ucwords(value: string, separators?: string | string[]): string;
+/**
+ * Get the number of words a string contains.
+ *
+ * @example
+ *
+ * wordCount('Hello, world!'); -> 2
+ * wordCount('мама мыла раму'); -> 3
+ */
+export declare function wordCount(value: string, characters?: string | null): number;
+/**
+ * Wrap a string to a given number of characters.
+ *
+ * @example
+ *
+ * wordWrap("Hello World", 3, "<br />"); -> "Hello<br />World"
+ * wordWrap("Hello World", 3, "<br />", true); -> "Hel<br />lo<br />Wor<br />ld"
+ * wordWrap("❤Multi Byte☆❤☆❤☆❤", 3, "<br />"); -> "❤Multi<br />Byte☆❤☆❤☆❤"
+ */
+export declare function wordWrap(value: string, characters?: number, breakStr?: string, cutLongWords?: boolean): string;
+/**
+ * Generate a UUID (version 4).
+ *
+ * @example
+ *
+ * uuid(); -> "550e8400-e29b-41d4-a716-446655440000"
+ */
+export declare function uuid(): string;
+/**
+ * Generate a UUID (version 7).
+ *
+ * @example
+ *
+ * uuid7(); -> "550e8400-e29b-41d4-a716-446655440000"
+ */
+export declare function uuid7(): string;
+/**
+ * Set the callable that will be used to generate UUIDs.
+ *
+ * @example
+ *
+ * createUuidsUsing(() => "custom-uuid");
+ */
+export declare function createUuidsUsing(factory?: (() => string) | null): void;
+/**
+ * Set the sequence that will be used to generate UUIDs.
+ *
+ * @example
+ *
+ * createUuidsUsingSequence(["uuid1", "uuid2"], () => "custom-uuid");
+ */
+export declare function createUuidsUsingSequence(sequence: string[], whenMissing?: (() => string) | null): void;
+/**
+ * Always return the same UUID when generating new UUIDs.
+ *
+ * @example
+ *
+ * freezeUuids();
+ */
+export declare function freezeUuids(callback?: ((value: string) => string) | null): string;
+/**
+ * Indicate that UUIDs should be created normally and not using a custom factory.
+ *
+ * @example
+ *
+ * createUuidsNormally();
+ */
+export declare function createUuidsNormally(): void;
+/**
+ * Generate a ULID.
+ *
+ * @example
+ *
+ * ulid(); -> "01F8MECHZX2D7J8F8C8D4B8F8C"
+ */
+export declare function ulid(time?: Date | number | null): string;
+/**
+ * Indicate that ULIDs should be created normally and not using a custom factory.
+ *
+ * @example
+ *
+ * createUlidsNormally();
+ */
+export declare function createUlidsNormally(): void;
+/**
+ * Set the callable that will be used to generate ULIDs.
+ *
+ * @example
+ *
+ * createUlidsUsing(() => of("1234").toString());
+ */
+export declare function createUlidsUsing(factory?: (() => string) | null): void;
+/**
+ * Set the sequence that will be used to generate ULIDs.
+ *
+ * @example
+ *
+ * createUlidsUsingSequence(["ulid1", "ulid2"], () => "custom-ulid");
+ */
+export declare function createUlidsUsingSequence(sequence: string[], whenMissing?: (() => string) | null): void;
+/**
+ * Always return the same ULID when generating new ULIDs.
+ *
+ * @example
+ *
+ * freezeUlids(() => "custom-ulid");
+ */
+export declare function freezeUlids(callback?: ((value: string) => string) | null): string;
+/**
+ * Get the size of the snake cache.
+ *
+ * @example
+ *
+ * snakeCacheSize();
+ */
+export declare function snakeCacheSize(): number;
+/**
+ * Get the size of the camel cache.
+ *
+ * @example
+ *
+ * camelCacheSize();
+ */
+export declare function camelCacheSize(): number;
+/**
+ * Get the size of the studly cache.
+ *
+ * @example
+ *
+ * studlyCacheSize();
+ */
+export declare function studlyCacheSize(): number;
+/**
+ * Remove all strings from the casing caches.
+ *
+ * @return void
+ */
+export declare function flushCache(): void;
+//# sourceMappingURL=str.d.ts.map