Sha256: f47280c45ddbc8aa4909396e1d8b526f64dfad4a845aec2356a6c1dc7b6fe722

Contents?: true

Size: 1.9 KB

Versions: 28

Compression:

Stored size: 1.9 KB

Contents

import type {SplitWords} from './split-words';

/**
CamelCase options.

@see {@link CamelCase}
*/
export type CamelCaseOptions = {
	/**
	Whether to preserved consecutive uppercase letter.

	@default true
	*/
	preserveConsecutiveUppercase?: boolean;
};

/**
Convert an array of words to camel-case.
*/
type CamelCaseFromArray<
	Words extends string[],
	Options extends CamelCaseOptions,
	OutputString extends string = '',
> = Words extends [
	infer FirstWord extends string,
	...infer RemainingWords extends string[],
]
	? Options['preserveConsecutiveUppercase'] extends true
		? `${Capitalize<FirstWord>}${CamelCaseFromArray<RemainingWords, Options>}`
		: `${Capitalize<Lowercase<FirstWord>>}${CamelCaseFromArray<RemainingWords, Options>}`
	: OutputString;

/**
Convert a string literal to camel-case.

This can be useful when, for example, converting some kebab-cased command-line flags or a snake-cased database result.

By default, consecutive uppercase letter are preserved. See {@link CamelCaseOptions.preserveConsecutiveUppercase preserveConsecutiveUppercase} option to change this behaviour.

@example
```
import type {CamelCase} from 'type-fest';

// Simple

const someVariable: CamelCase<'foo-bar'> = 'fooBar';

// Advanced

type CamelCasedProperties<T> = {
	[K in keyof T as CamelCase<K>]: T[K]
};

interface RawOptions {
	'dry-run': boolean;
	'full_family_name': string;
	foo: number;
	BAR: string;
	QUZ_QUX: number;
	'OTHER-FIELD': boolean;
}

const dbResult: CamelCasedProperties<RawOptions> = {
	dryRun: true,
	fullFamilyName: 'bar.js',
	foo: 123,
	bar: 'foo',
	quzQux: 6,
	otherField: false
};
```

@category Change case
@category Template literal
*/
export type CamelCase<Type, Options extends CamelCaseOptions = {preserveConsecutiveUppercase: true}> = Type extends string
	? string extends Type
		? Type
		: Uncapitalize<CamelCaseFromArray<SplitWords<Type extends Uppercase<Type> ? Lowercase<Type> : Type>, Options>>
	: Type;

Version data entries

28 entries across 28 versions & 2 rubygems

Version Path
clapton-0.0.26 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.25 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.24 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.23 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.22 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.21 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.20 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.19 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.18 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.17 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.16 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.15 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.14 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.13 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.12 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.11 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.10 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.9 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.8 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts
clapton-0.0.7 lib/clapton/javascripts/node_modules/type-fest/source/camel-case.d.ts