/**
 * Contains functions and types that translate string literals between cases and identifies their current case
 * @module
 */
import { type CamelCaseName, type IsCamelCase, type IsPascalCase, type PascalCaseName } from "./capitalization-delimited-cases.js";
import { type IsLowerCase, type IsUpperCase, type LowerCaseName, type UpperCaseName } from "./non-delimited-cases.js";
import { type IsKebabCase, type IsSnakeCase, type KebabCaseName, type SnakeCaseName } from "./symbol-delimited-cases.js";
import type { CaseName } from "./cases.js";
import { type StringToWords, type WordsToString } from "./words.js";
/** Translates a string literal type from one case to another */
export type ChangeStringCase<String extends string, ToCase extends CaseName, FromCase extends CaseName> = FromCase extends ToCase ? String : WordsToString<ToCase, StringToWords<FromCase, String>>;
/** Returns a function translating the string within an string. The current case will be auto-detected if possible. */
export declare function stringCaseChanger<const ToCase extends CaseName>(toCase: ToCase): <String extends string>(string: String) => DetectCaseNameFromString<String> extends infer FromCase extends CaseName ? ChangeStringCase<String, ToCase, FromCase> : String;
/** Returns a function translating the string within an string from one provided case to another */
export declare function stringCaseChanger<const ToCase extends CaseName, const FromCase extends CaseName>(toCase: ToCase, fromCase: FromCase): <String extends string>(string: String) => ChangeStringCase<String, ToCase, FromCase>;
/** Translates a string from one case to another. The current case will be auto-detected if possible. */
export declare function changeStringCase<const String extends string, const ToCase extends CaseName>(string: String, toCase: ToCase): DetectCaseNameFromString<String> extends infer FromCase extends CaseName ? ChangeStringCase<String, ToCase, FromCase> : String;
/** Translates a string from one provided case to another. */
export declare function changeStringCase<const String extends string, const ToCase extends CaseName, const FromCase extends CaseName>(string: String, toCase: ToCase, fromCase: FromCase): ChangeStringCase<String, ToCase, FromCase>;
/** Attempts to identify the current case of a string literal type and return a CaseName. Returns 'undefined' if unsuccesfull */
export type DetectCaseNameFromString<String extends string> = "" extends String ? undefined : IsSnakeCase<String> extends true ? SnakeCaseName : IsKebabCase<String> extends true ? KebabCaseName : IsCamelCase<String> extends true ? CamelCaseName : IsPascalCase<String> extends true ? PascalCaseName : IsLowerCase<String> extends true ? LowerCaseName : IsUpperCase<String> extends true ? UpperCaseName : undefined;
/** Attempts to identify the current case of a string literal and return a CaseName. Returns 'undefined' if unsuccesfull */
export declare function detectCaseNameFromString<const String extends string>(string: String): DetectCaseNameFromString<String>;
//# sourceMappingURL=string.d.ts.map