UNPKG

2.59 kBTypeScriptView Raw
1/**
2 * Supported locale values. Use `false` to ignore locale.
3 * Defaults to `undefined`, which uses the host environment.
4 */
5export type Locale = string[] | string | false | undefined;
6/**
7 * Options used for converting strings to pascal/camel case.
8 */
9export interface PascalCaseOptions extends Options {
10 mergeAmbiguousCharacters?: boolean;
11}
12/**
13 * Options used for converting strings to any case.
14 */
15export interface Options {
16 locale?: Locale;
17 split?: (value: string) => string[];
18 /** @deprecated Pass `split: splitSeparateNumbers` instead. */
19 separateNumbers?: boolean;
20 delimiter?: string;
21 prefixCharacters?: string;
22 suffixCharacters?: string;
23}
24/**
25 * Split any cased input strings into an array of words.
26 */
27export declare function split(value: string): string[];
28/**
29 * Split the input string into an array of words, separating numbers.
30 */
31export declare function splitSeparateNumbers(value: string): string[];
32/**
33 * Convert a string to space separated lower case (`foo bar`).
34 */
35export declare function noCase(input: string, options?: Options): string;
36/**
37 * Convert a string to camel case (`fooBar`).
38 */
39export declare function camelCase(input: string, options?: PascalCaseOptions): string;
40/**
41 * Convert a string to pascal case (`FooBar`).
42 */
43export declare function pascalCase(input: string, options?: PascalCaseOptions): string;
44/**
45 * Convert a string to pascal snake case (`Foo_Bar`).
46 */
47export declare function pascalSnakeCase(input: string, options?: Options): string;
48/**
49 * Convert a string to capital case (`Foo Bar`).
50 */
51export declare function capitalCase(input: string, options?: Options): string;
52/**
53 * Convert a string to constant case (`FOO_BAR`).
54 */
55export declare function constantCase(input: string, options?: Options): string;
56/**
57 * Convert a string to dot case (`foo.bar`).
58 */
59export declare function dotCase(input: string, options?: Options): string;
60/**
61 * Convert a string to kebab case (`foo-bar`).
62 */
63export declare function kebabCase(input: string, options?: Options): string;
64/**
65 * Convert a string to path case (`foo/bar`).
66 */
67export declare function pathCase(input: string, options?: Options): string;
68/**
69 * Convert a string to path case (`Foo bar`).
70 */
71export declare function sentenceCase(input: string, options?: Options): string;
72/**
73 * Convert a string to snake case (`foo_bar`).
74 */
75export declare function snakeCase(input: string, options?: Options): string;
76/**
77 * Convert a string to header case (`Foo-Bar`).
78 */
79export declare function trainCase(input: string, options?: Options): string;