import type {UnwrapBrandedPrimitive} from './unwrap-branded-primitive.d.ts';
import type {SnakeCase} from './snake-case.d.ts';
import type {WordsOptions} from './words.d.ts';

/**
Convert a string literal to screaming-snake-case.

This can be useful when, for example, converting a camel-cased object property to a screaming-snake-cased SQL column name.

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

const someVariable: ScreamingSnakeCase<'fooBar'> = 'FOO_BAR';
const someVariableNoSplitOnNumbers: ScreamingSnakeCase<'p2pNetwork', {splitOnNumbers: false}> = 'P2P_NETWORK';
const someVariableWithPunctuation: ScreamingSnakeCase<'div.card::after'> = 'DIV_CARD_AFTER';
const someVariableNoSplitOnPunctuation: ScreamingSnakeCase<'div.card::after', {splitOnPunctuation: false}> = 'DIV.CARD::AFTER';

```

@category Change case
@category Template literal
 */
export type ScreamingSnakeCase<
	Value,
	Options extends WordsOptions = {},
> = Value extends string
	? Uppercase<UnwrapBrandedPrimitive<SnakeCase<Value, Options>>>
	: Value;

export {};
