inferred-types 0.37.5 → 0.40.1

package/dist/types/src/types/string-literals/EmptyString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyString.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/EmptyString.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,EAAE,CAAC"}

package/dist/types/src/types/string-literals/EmptyString.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/EmptyStringOr.d.ts

@@ -0,0 +1,9 @@
+import { TupleToUnion, EmptyString } from "..";
+/**
+ * **EmptyStringOr**`<T>`
+ *
+ * A type utility to build a union between an empty string
+ * _or_ the string literal `T`.
+ */
+export type EmptyStringOr<T extends string | readonly string[]> = T extends readonly string[] ? EmptyString | TupleToUnion<T & readonly string[]> : EmptyString | (T & string);
+//# sourceMappingURL=EmptyStringOr.d.ts.map

package/dist/types/src/types/string-literals/EmptyStringOr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyStringOr.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/EmptyStringOr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAG,WAAW,EAAE,MAAM,IAAI,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,IAC5D,CAAC,SAAS,SAAS,MAAM,EAAE,GACvB,WAAW,GAAG,YAAY,CAAC,CAAC,GAAG,SAAS,MAAM,EAAE,CAAC,GACjD,WAAW,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC"}

package/dist/types/src/types/string-literals/EmptyStringOr.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/EnsureLeading.d.ts

@@ -0,0 +1,18 @@
+import { IfLiteral, IfStartsWith, IsNumber, ToString } from "..";
+/**
+ * **EnsureLeading**`<TTarget, TLeading>`
+ *
+ * Will ensure that `TTarget` starts with the _substring_ `TLeading` when
+ * both are string literals.
+ *
+ * ```ts
+ * type T = " World";
+ * type U = "Hello";
+ * // "Hello World"
+ * type R = EnsureLeading<T,U>;
+ * ```
+ *
+ * **Related:** `EnsureLeadingEvery`, `EnsureTrailing`
+ */
+export type EnsureLeading<TTarget extends string | number, TLeading extends string> = IsNumber<TTarget> extends true ? EnsureLeading<ToString<TTarget>, TLeading> : IfLiteral<TTarget, IfLiteral<TLeading, IfStartsWith<TTarget & string, TLeading, TTarget & `${TLeading}${string}`, `${TLeading}${TTarget}`>, string>, string>;
+//# sourceMappingURL=EnsureLeading.d.ts.map

package/dist/types/src/types/string-literals/EnsureLeading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnsureLeading.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/EnsureLeading.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAG,QAAQ,EAAE,MAAM,IAAI,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,CACvB,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,QAAQ,SAAS,MAAM,IAEvB,QAAQ,CAAC,OAAO,CAAC,SAAS,IAAI,GAC5B,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GAC1C,SAAS,CACP,OAAO,EAEP,SAAS,CACP,QAAQ,EAER,YAAY,CACV,OAAO,GAAG,MAAM,EAAE,QAAQ,EAC1B,OAAO,GAAG,GAAG,QAAQ,GAAG,MAAM,EAAE,EAChC,GAAG,QAAQ,GAAG,OAAO,EAAE,CACxB,EACD,MAAM,CACP,EACD,MAAM,CACP,CAAC"}

package/dist/types/src/types/string-literals/EnsureLeading.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/EnsureLeadingEvery.d.ts

@@ -0,0 +1,16 @@
+import { EnsureLeading, ToString, UnionToTuple } from "..";
+/**
+ * **EnsureLeadingEvery**`<TList, TLeader>`
+ *
+ * Ensures that each item in `TList` starts with `TLeader`.
+ *
+ * - `TList` can be made up of strings or numbers
+ * - `TLeader` can be made up of string, number, or boolean values
+ * - all non-string values are converted to string with `ToString`
+ *
+ * **Related:** `EnsureLeading`, `EnsureTrailing`
+ */
+export type EnsureLeadingEvery<TList extends readonly (string | number | boolean)[], TLeader extends string> = UnionToTuple<{
+    [K in keyof TList]: EnsureLeading<ToString<TList[K]>, TLeader>;
+}[number]>;
+//# sourceMappingURL=EnsureLeadingEvery.d.ts.map

package/dist/types/src/types/string-literals/EnsureLeadingEvery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnsureLeadingEvery.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/EnsureLeadingEvery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAG,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAG5D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,CAC5B,KAAK,SAAS,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,EACpD,OAAO,SAAS,MAAM,IACpB,YAAY,CAAE;KACf,CAAC,IAAI,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;CAC/D,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/types/src/types/string-literals/EnsureLeadingEvery.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/EnsureTrailing.d.ts

@@ -0,0 +1,16 @@
+import { IfLiteral } from "..";
+/**
+ * **EnsureTrailing**`<T, U>`
+ *
+ * Will ensure that `T` ends with the substring `U` when
+ * both are string literals.
+ *
+ * ```ts
+ * type T = "Hello";
+ * type U = " World";
+ * // "Hello World"
+ * type R = EnsureTrailing<T,U>;
+ * ```
+ */
+export type EnsureTrailing<T extends string, U extends string> = IfLiteral<T, string extends U ? never : T extends `${string}${U}` ? T : `${T}${U}`, string>;
+//# sourceMappingURL=EnsureTrailing.d.ts.map

package/dist/types/src/types/string-literals/EnsureTrailing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnsureTrailing.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/EnsureTrailing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAG/B;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,SAAS,CAExE,CAAC,EAGD,MAAM,SAAS,CAAC,GAAG,KAAK,GAAG,CAAC,SAAS,GAAG,MAAM,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,EAErE,MAAM,CACP,CAAC"}

package/dist/types/src/types/string-literals/EnsureTrailing.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/FirstChar.d.ts

@@ -0,0 +1,24 @@
+import { Split, AsArray, AfterFirst, First, IfStringLiteral, AsString, IfString, IfNever, Chars } from "..";
+type Iterate<TInput extends readonly string[], TChars extends readonly string[] = []> = [] extends TInput ? TChars : Iterate<AfterFirst<TInput>, IfStringLiteral<First<TInput>, IfNever<Chars<First<TInput>>, TChars, [
+    ...TChars,
+    First<Chars<First<TInput>>>
+]>, TChars>>;
+/**
+ * **FirstChar**`<TContent>`
+ *
+ * Receives either a string or a tuple of strings. Based on the input
+ * it is converted to:
+ *
+ * - **String:**
+ *    - when a string is received it will return the first character
+ * in that string as a string literal.
+ *    - when a wide string type is provided it will return the _never_ type.
+ * - **Tuple<string>:**
+ *    - when a tuple of strings is received it will process
+ * each element in the array independently and return each element's first
+ * character
+ *    - any wide strings encountered will be ignored in the returned array
+ */
+export type FirstChar<TContent extends string | readonly string[]> = IfString<TContent, First<Split<AsString<TContent>>>, Iterate<AsArray<TContent>>>;
+export {};
+//# sourceMappingURL=FirstChar.d.ts.map

package/dist/types/src/types/string-literals/FirstChar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FirstChar.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/FirstChar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAG,KAAK,EAAG,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAE9G,KAAK,OAAO,CACV,MAAM,SAAS,SAAS,MAAM,EAAE,EAChC,MAAM,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,IACnC,EAAE,SAAS,MAAM,GACjB,MAAM,GACN,OAAO,CACL,UAAU,CAAC,MAAM,CAAC,EAClB,eAAe,CACb,KAAK,CAAC,MAAM,CAAC,EAEb,OAAO,CACL,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EACpB,MAAM,EACN;IAAE,GAAG,MAAM;IAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;CAAE,CAC3C,EAED,MAAM,CACP,CACF,CAAC;AAEN;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,CACnB,QAAQ,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,IACzC,QAAQ,CACV,QAAQ,EACR,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAChC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAC3B,CAAC"}

package/dist/types/src/types/string-literals/FirstChar.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/HasUppercase.d.ts

@@ -0,0 +1,14 @@
+import { UpperAlphaChar } from "..";
+/**
+ * Indicates whether `T` has uppercase characters in it.
+ * ```ts
+ * // true
+ * type T = HasUppercase<"Foobar">;
+ * // false
+ * type T = HasUppercase<"foobar">;
+ * // "unknown"
+ * type T = HasUppercase<string>;
+ * ```
+ */
+export type HasUppercase<T extends string> = string extends T ? "unknown" : T extends `${string}${UpperAlphaChar}${string}` ? true : false;
+//# sourceMappingURL=HasUppercase.d.ts.map

package/dist/types/src/types/string-literals/HasUppercase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HasUppercase.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/HasUppercase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,SAAS,CAAC,GACzD,SAAS,GACT,CAAC,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC"}

package/dist/types/src/types/string-literals/HasUppercase.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/Interpolate.d.ts

@@ -0,0 +1,15 @@
+import { AfterFirst, AnyObject, Container, First, IfObjectLiteral, IfStringLiteral, Keys, ReplaceAll, ToString, WithDefault } from "..";
+type Left<T extends readonly [string, string]> = T[0];
+type Right<T extends readonly [string, string]> = T[1];
+type IterateKeys<TText extends string, TContainer extends Container, TDelimiters extends readonly [string, string], TKeys extends readonly PropertyKey[]> = [] extends TKeys ? TText : IterateKeys<First<TKeys> extends keyof TContainer ? ReplaceAll<TText, `${Left<TDelimiters>}${ToString<First<TKeys>>}${Right<TDelimiters>}`, ToString<TContainer[First<TKeys>]>> : TText, TContainer, TDelimiters, AfterFirst<TKeys>>;
+type InterpolateTuple<TText extends string, TTuple extends readonly unknown[], TDelimiters extends readonly [string, string]> = TText extends `${string}${Left<TDelimiters>}${number}${Right<TDelimiters>}${string}` ? IterateKeys<TText, TTuple, TDelimiters, Keys<TTuple>> : TText;
+type InterpolateObject<TText extends string, TObj extends AnyObject, TDelimiters extends readonly [string, string]> = IfObjectLiteral<TObj, IfStringLiteral<TText, TText extends `${string}${Left<TDelimiters>}${string}${Right<TDelimiters>}${string}` ? IterateKeys<TText, TObj, TDelimiters, Keys<TObj>> : TText, string>, string>;
+export type Interpolate<TText extends string, TContainer extends Container, TDelimiters extends readonly [string, string] = ["", ""]> = TContainer extends readonly unknown[] ? InterpolateTuple<TText, TContainer, [
+    WithDefault<TDelimiters[0], "[[", "falsy">,
+    WithDefault<TDelimiters[1], "]]", "falsy">
+]> : TContainer extends AnyObject ? InterpolateObject<TText, TContainer, [
+    WithDefault<TDelimiters[0], "{{", "falsy">,
+    WithDefault<TDelimiters[1], "}}", "falsy">
+]> : never;
+export {};
+//# sourceMappingURL=Interpolate.d.ts.map

package/dist/types/src/types/string-literals/Interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Interpolate.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/Interpolate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,KAAK,EACL,eAAe,EACf,eAAe,EACf,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,WAAW,EACZ,MAAM,IAAI,CAAC;AAEZ,KAAK,IAAI,CAAC,CAAC,SAAS,SAAS,CAAE,MAAM,EAAE,MAAM,CAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,KAAK,KAAK,CAAC,CAAC,SAAS,SAAS,CAAE,MAAM,EAAE,MAAM,CAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzD,KAAK,WAAW,CACd,KAAK,SAAS,MAAM,EACpB,UAAU,SAAS,SAAS,EAC5B,WAAW,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7C,KAAK,SAAS,SAAS,WAAW,EAAE,IAClC,EAAE,SAAS,KAAK,GAClB,KAAK,GACL,WAAW,CACT,KAAK,CAAC,KAAK,CAAC,SAAS,MAAM,UAAU,GACjC,UAAU,CACR,KAAK,EACL,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CACzG,GACD,KAAK,EACT,UAAU,EACV,WAAW,EACX,UAAU,CAAC,KAAK,CAAC,CAClB,CAAC;AAEJ,KAAK,gBAAgB,CACnB,KAAK,SAAS,MAAM,EACpB,MAAM,SAAS,SAAS,OAAO,EAAE,EACjC,WAAW,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAC3C,KAAK,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,MAAM,EAAE,GACtF,WAAW,CAAC,KAAK,EAAC,MAAM,EAAC,WAAW,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAClD,KAAK,CAAC;AAER,KAAK,iBAAiB,CACpB,KAAK,SAAS,MAAM,EACpB,IAAI,SAAS,SAAS,EACtB,WAAW,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAC3C,eAAe,CACjB,IAAI,EACJ,eAAe,CACb,KAAK,EACL,KAAK,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,MAAM,EAAE,GAChF,WAAW,CAAC,KAAK,EAAC,IAAI,EAAC,WAAW,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAC9C,KAAK,EACP,MAAM,CACP,EACH,MAAM,CACP,CAAC;AAEF,MAAM,MAAM,WAAW,CACrB,KAAK,SAAS,MAAM,EACpB,UAAU,SAAS,SAAS,EAC5B,WAAW,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAC,EAAE,CAAC,IACrD,UAAU,SAAS,SAAS,OAAO,EAAE,GACvC,gBAAgB,CACd,KAAK,EACL,UAAU,EACV;IACE,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IAC1C,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;CAC3C,CACF,GACD,UAAU,SAAS,SAAS,GAC1B,iBAAiB,CACf,KAAK,EACL,UAAU,EACV;IACE,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IAC1C,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;CAC3C,CACF,GACD,KAAK,CAAC"}

package/dist/types/src/types/string-literals/Interpolate.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/IsCapitalized.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns true or false value based on whether the string literal is capitalized.
+ * ```ts
+ * // true
+ * type T2 = IsCapitalized<"One">;
+ * // false
+ * type T1 = IsCapitalized<"one">;
+ * // "unknown"
+ * const a: string = "Hi";
+ * type T3 = IsCapitalized<typeof a>;
+ * ```
+ *
+ * Note: _if the value passed in is a "string" then the result will be "unknown"_
+ */
+export type IsCapitalized<T extends string> = string extends T ? "unknown" : T extends Capitalize<T> ? true : false;
+//# sourceMappingURL=IsCapitalized.d.ts.map

package/dist/types/src/types/string-literals/IsCapitalized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsCapitalized.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/IsCapitalized.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,SAAS,CAAC,GAC1D,SAAS,GACT,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC"}

package/dist/types/src/types/string-literals/IsCapitalized.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/Join.d.ts

@@ -0,0 +1,19 @@
+import { ToString, IfEqual, RemoveEquals, RemoveNever, Truncate, IfNever, IsGreaterThan, AsNumber } from "..";
+type JoinAcc<TArr extends readonly unknown[], TSeparator extends string, TResult extends string = ""> = TArr extends [infer First, ...infer Rest] ? First extends string ? JoinAcc<Rest, TSeparator, IfEqual<TResult, "", `${TResult}${First}`, `${TResult}${TSeparator}${First}`>> : JoinAcc<Rest, TSeparator, IfEqual<TResult, "", `${TResult}${ToString<First>}`, `${TResult}${TSeparator}${ToString<First>}`>> : TResult;
+type Trunc<TArr extends readonly unknown[], TMax extends number, TEllipsis extends string | false> = IsGreaterThan<TArr["length"], TMax> extends true ? Truncate<RemoveNever<TArr>, TMax, TEllipsis> : RemoveNever<TArr>;
+/**
+ * **Join**`<TArr,[TSeparator],[TMax]>`
+ *
+ * Joins together an array of items into a string.
+ *
+ * - the _separator_ between items defaults to an empty string this can be
+ * changed to whatever is needed
+ * - non-string types will be converted to strings as best as possible
+ * - specifying a value for `TMax` will truncate tuples which are greater
+ * than the specified length and add an ellipsis marker as the last element
+ *
+ * **Related:** `Concat<TArr>`
+ */
+export type Join<TTuple extends readonly unknown[], TSeparator extends string = "", TMax extends number | never = never, TEllipsis extends string | false = "..."> = IfNever<TMax, JoinAcc<RemoveNever<RemoveEquals<[...TTuple], "">>, TSeparator>, JoinAcc<Trunc<TTuple, AsNumber<TMax>, TEllipsis> extends readonly unknown[] ? Trunc<TTuple, AsNumber<TMax>, TEllipsis> : never, TSeparator>>;
+export {};
+//# sourceMappingURL=Join.d.ts.map

package/dist/types/src/types/string-literals/Join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Join.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/Join.ts"],"names":[],"mappings":"AAAA,OAAO,EAAG,QAAQ,EAAG,OAAO,EAAG,YAAY,EAAE,WAAW,EAAG,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAElH,KAAK,OAAO,CACV,IAAI,SAAS,SAAS,OAAO,EAAE,EAC/B,UAAU,SAAS,MAAM,EACzB,OAAO,SAAS,MAAM,GAAG,EAAE,IACzB,IAAI,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,GACzC,KAAK,SAAS,MAAM,GAChB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CACjC,OAAO,EAAE,EAAE,EACX,GAAG,OAAO,GAAG,KAAK,EAAE,EACpB,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,EAAE,CAClC,CAAC,GACA,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAC/B,OAAO,EAAE,EAAE,EACX,GAAG,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,EAC9B,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,CAC9C,CAAC,GACJ,OAAO,CAAC;AAEZ,KAAK,KAAK,CACR,IAAI,SAAS,SAAS,OAAO,EAAE,EAC/B,IAAI,SAAS,MAAM,EACnB,SAAS,SAAS,MAAM,GAAG,KAAK,IAC9B,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,SAAS,IAAI,GAClD,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,GAC5C,WAAW,CAAC,IAAI,CAAC,CAAC;AAEpB;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,IAAI,CACd,MAAM,SAAS,SAAS,OAAO,EAAE,EACjC,UAAU,SAAS,MAAM,GAAG,EAAE,EAC9B,IAAI,SAAS,MAAM,GAAG,KAAK,GAAG,KAAK,EACnC,SAAS,SAAS,MAAM,GAAG,KAAK,GAAG,KAAK,IACtC,OAAO,CACT,IAAI,EACJ,OAAO,CACL,WAAW,CAAC,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAC1C,UAAU,CACX,EACD,OAAO,CACL,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,SAAS,SAAS,OAAO,EAAE,GAC/D,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,GACxC,KAAK,EACT,UAAU,CACX,CACF,CAAC"}

package/dist/types/src/types/string-literals/Join.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/LastChar.d.ts

@@ -0,0 +1,21 @@
+import { Split, AsArray, AfterFirst, First, Last, IfStringLiteral, AsString, IfString, Chars, IfNever } from "..";
+type Iterate<TInput extends readonly string[], TChars extends readonly string[] = []> = [] extends TInput ? TChars : Iterate<AfterFirst<TInput>, IfStringLiteral<First<TInput>, IfNever<Chars<First<TInput>>, TChars, Last<Chars<First<TInput>>> extends string ? [...TChars, Last<Chars<First<TInput>>>] : never>, TChars>>;
+/**
+ * **LastChar**`<TContent>`
+ *
+ * Receives either a string or a tuple of strings. Based on the input
+ * it is converted to:
+ *
+ * - **String:**
+ *    - when a string is received it will return the last character
+ * in that string as a string literal.
+ *    - when a wide string type is provided it will return the _never_ type.
+ * - **Tuple<string>:**
+ *    - when a tuple of strings is received it will process
+ * each element in the array independently and return each element's first
+ * character
+ *    - any wide strings encountered will be ignored in the returned array
+ */
+export type LastChar<TContent extends string | readonly string[]> = IfString<TContent, Last<Split<AsString<TContent>>>, Iterate<AsArray<TContent>>>;
+export {};
+//# sourceMappingURL=LastChar.d.ts.map

package/dist/types/src/types/string-literals/LastChar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LastChar.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/LastChar.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,OAAO,EACP,UAAU,EACV,KAAK,EACL,IAAI,EACJ,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,OAAO,EACR,MAAM,IAAI,CAAC;AAEZ,KAAK,OAAO,CACV,MAAM,SAAS,SAAS,MAAM,EAAE,EAChC,MAAM,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,IACnC,EAAE,SAAS,MAAM,GACjB,MAAM,GACN,OAAO,CACL,UAAU,CAAC,MAAM,CAAC,EAClB,eAAe,CACb,KAAK,CAAC,MAAM,CAAC,EAEb,OAAO,CACL,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EACpB,MAAM,EACN,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,GACrC,CAAE,GAAG,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GACxC,KAAK,CACV,EAED,MAAM,CACP,CACF,CAAC;AAEN;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,QAAQ,CAClB,QAAQ,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,IACzC,QAAQ,CACV,QAAQ,EACR,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAC/B,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAC3B,CAAC"}

package/dist/types/src/types/string-literals/LastChar.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/PathJoin.d.ts

@@ -0,0 +1,18 @@
+import { IfLiteral, AfterFirst, First, StripTrailing, StripLeading } from "..";
+/**
+ * **PathJoin**`<T,U>`
+ *
+ * Type utility meant to bring 2 or more "path" strings together into
+ * a valid "path". Where a "path" is represented as nothing more than
+ * string characters delimited by a Posix `\` character.
+ *
+ * Note that the first part of the path will retain it's `\` if present
+ * and the last one will preserve it's `\` character if present. You can
+ * combine this utility with `EnsureTrailing<T>`, `StripTrailing<T>`,
+ * `EnsureStarting<T>`, and `StripStarting<T>` to further shape
+ * the type.
+ */
+export type PathJoin<T extends string, U extends string | readonly string[]> = [] extends U ? T : U extends readonly string[] ? PathMultiJoin<PathJoin<T, "">, [...U]> : U extends string ? IfLiteral<T, IfLiteral<U, `${StripTrailing<T, "/">}/${StripLeading<U, "/">}`, `${StripTrailing<T, "/">}/${string}`>, IfLiteral<U, `${string}${U}`, string>> : never;
+type PathMultiJoin<TProcessed extends string, TRemaining extends readonly string[]> = [] extends TRemaining ? TProcessed : PathMultiJoin<PathJoin<TProcessed, First<TRemaining>>, AfterFirst<TRemaining>>;
+export {};
+//# sourceMappingURL=PathJoin.d.ts.map

package/dist/types/src/types/string-literals/PathJoin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathJoin.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/PathJoin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAG,UAAU,EAAE,KAAK,EAAE,aAAa,EAAG,YAAY,EAAC,MAAM,IAAI,CAAC;AAGhF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,QAAQ,CAElB,CAAC,SAAS,MAAM,EAEhB,CAAC,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,IAClC,EAAE,SAAS,CAAC,GACZ,CAAC,GACD,CAAC,SAAS,SAAS,MAAM,EAAE,GAE3B,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GACtC,CAAC,SAAS,MAAM,GAChB,SAAS,CACP,CAAC,EAED,SAAS,CAEP,CAAC,EACD,GAAG,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAClD,GAAG,aAAa,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CACrC,EAED,SAAS,CAAC,CAAC,EAAE,GAAG,MAAM,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CACtC,GACD,KAAK,CAAC;AAEV,KAAK,aAAa,CAChB,UAAU,SAAS,MAAM,EACzB,UAAU,SAAS,SAAS,MAAM,EAAE,IAClC,EAAE,SAAS,UAAU,GACrB,UAAU,GACV,aAAa,CAEX,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,EAEvC,UAAU,CAAC,UAAU,CAAC,CACvB,CAAC"}

package/dist/types/src/types/string-literals/PathJoin.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/Pluralize.d.ts

@@ -0,0 +1,43 @@
+import { PLURAL_EXCEPTIONS } from "src/constants";
+import { Consonant, IfContains, IfStringLiteral, Filter, GetEach, EnsureTrailing, StripTrailing } from "..";
+type Exceptions = typeof PLURAL_EXCEPTIONS;
+type SingularExceptions = GetEach<Exceptions, 0>;
+type SingularNoun = "s" | "sh" | "ch" | "x" | "z" | "o";
+type F = "f" | "fe";
+type Y = `${Consonant}y`;
+/**
+ * validates that a word `T` has an _exception_ rule defined for it
+ */
+type IsException<T extends string> = IfContains<SingularExceptions, T, true, false>;
+/**
+ * Looks up a singular word `T` as a possible singular exception and converts it
+ * to the plural equivalent. Will return `never` if `T` is not an exception.
+ */
+type PluralException<T extends string> = IsException<T> extends true ? Filter<Exceptions, [T, string], "extends"> extends [T, infer Plural] ? Plural : never : never;
+/** validates that a string literal ends in "is" */
+type EndsIn_IS<T extends string> = T extends `${string}is` ? T : never;
+/** validates that a string literal is a singular noun */
+type EndsInSingularNoun<T extends string> = T extends `${string}${SingularNoun}` ? T : never;
+/** validates that a string literal ends in "f" or "fe" */
+type EndsIn_F<T extends string> = T extends `${string}${F}` ? T : never;
+/** validates that a string literal ends a consonant followed by "y" */
+type EndsIn_Y<T extends string> = T extends `${string}${Y}` ? T : never;
+/**
+ * strings which end in the letters "is" should have an "es" added to the end
+ */
+type PluralizeEndingIn_IS<T extends string> = T extends `${infer HEAD}is` ? `${HEAD}ises` : T;
+/**
+ * singular nouns should have "es" added to the end
+ */
+type PluralizeEndingSingularNoun<T extends string> = EnsureTrailing<T, "es">;
+/**
+ * strings which end in the letters "f" or "fe" should have "ves" replace the ending
+ */
+type PluralizeEnding_F<T extends string> = T extends `${infer HEAD}${F}` ? `${HEAD}ves` : T;
+/**
+ * singular nouns should have "es" added to the end
+ */
+type PluralizeEndingIn_Y<T extends string> = EnsureTrailing<StripTrailing<T, "y">, "ies">;
+export type Pluralize<T extends string> = IfStringLiteral<T, IsException<T> extends true ? PluralException<T> : T extends EndsIn_IS<T> ? PluralizeEndingIn_IS<T> : T extends EndsInSingularNoun<T> ? PluralizeEndingSingularNoun<T> : T extends EndsIn_F<T> ? PluralizeEnding_F<T> : T extends EndsIn_Y<T> ? PluralizeEndingIn_Y<T> : `${T}s`, string>;
+export {};
+//# sourceMappingURL=Pluralize.d.ts.map

package/dist/types/src/types/string-literals/Pluralize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pluralize.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/Pluralize.ts"],"names":[],"mappings":"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"}

package/dist/types/src/types/string-literals/Pluralize.js

@@ -0,0 +1,2 @@
+/* eslint @typescript-eslint/no-unused-vars: "off" */
+export {};

package/dist/types/src/types/string-literals/Prepend.d.ts

@@ -0,0 +1,14 @@
+import { ToString } from "..";
+/**
+ * **Prepend**`<TStr, TPrepend>`
+ *
+ * Prepends the string `TPrepend` prior to existing `TStr` string.
+ * ```ts
+ * // "Bob, you're the best"
+ * type T = Prepend<"you're the best", "Bob, ">;
+ * ```
+ *
+ * **Related:** `EnsureLeading`
+ */
+export type Prepend<TStr extends string, TPrepend extends string | number | boolean> = `${ToString<TPrepend>}${TStr}`;
+//# sourceMappingURL=Prepend.d.ts.map

package/dist/types/src/types/string-literals/Prepend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prepend.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/Prepend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAE9B;;;;;;;;;;GAUG;AACH,MAAM,MAAM,OAAO,CACjB,IAAI,SAAS,MAAM,EACnB,QAAQ,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,IACxC,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC"}

package/dist/types/src/types/string-literals/Prepend.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/PrependAll.d.ts

@@ -0,0 +1,8 @@
+import { AfterFirst, First, ToString } from "..";
+type PrependAcc<TList extends readonly string[], TPrepend extends string, TResults extends string[] = []> = [] extends TList ? TResults : PrependAcc<AfterFirst<TList>, TPrepend, [
+    ...TResults,
+    `${TPrepend}${First<TList>}`
+]>;
+export type PrependAll<TList extends readonly string[], TPrepend extends string | number | boolean> = PrependAcc<TList, ToString<TPrepend>>;
+export {};
+//# sourceMappingURL=PrependAll.d.ts.map

package/dist/types/src/types/string-literals/PrependAll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrependAll.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/PrependAll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAG,QAAQ,EAAE,MAAM,IAAI,CAAC;AAElD,KAAK,UAAU,CACb,KAAK,SAAS,SAAS,MAAM,EAAE,EAC/B,QAAQ,SAAS,MAAM,EACvB,QAAQ,SAAS,MAAM,EAAE,GAAG,EAAE,IAC5B,EAAE,SAAS,KAAK,GAChB,QAAQ,GACR,UAAU,CACR,UAAU,CAAC,KAAK,CAAC,EACjB,QAAQ,EACR;IAAC,GAAG,QAAQ;IAAE,GAAG,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE;CAAC,CAC5C,CAAC;AAEN,MAAM,MAAM,UAAU,CACpB,KAAK,SAAS,SAAS,MAAM,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,IACxC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC"}

package/dist/types/src/types/string-literals/PrependAll.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/RemainingChars.d.ts

@@ -0,0 +1,23 @@
+import { Split, AsArray, AfterFirst, AsString, Concat } from "..";
+type Iterate<TInput extends readonly string[]> = {
+    [K in keyof TInput]: TInput[K] extends string ? Concat<AfterFirst<Split<TInput[K]>>> : never;
+};
+/**
+ * **RemainingChar**`<TContent>`
+ *
+ * Receives either a string or a tuple of strings. Based on the input
+ * it is converted to:
+ *
+ * - **String:**
+ *    - when a string is received it will return the string with the first
+ * character removed
+ *    - when a wide string type is provided it will return the _never_ type.
+ * - **Tuple<string>:**
+ *    - when a tuple of strings is received it will process
+ * each element in the array independently and return each element's _remaining characters_
+ * after the first character has been removed
+ *    - any wide strings encountered will be ignored in the returned array
+ */
+export type RemainingChars<TContent extends string | readonly string[]> = TContent extends readonly string[] ? Iterate<AsArray<TContent>> : Concat<AfterFirst<Split<AsString<TContent>>>>;
+export {};
+//# sourceMappingURL=RemainingChars.d.ts.map

package/dist/types/src/types/string-literals/RemainingChars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemainingChars.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/RemainingChars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAG,MAAM,EAAE,MAAM,IAAI,CAAC;AAEnE,KAAK,OAAO,CACV,MAAM,SAAS,SAAS,MAAM,EAAE,IAC9B;KACD,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,MAAM,GACzC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpC,KAAK;CACV,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,CACxB,QAAQ,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,IACzC,QAAQ,SAAS,SAAS,MAAM,EAAE,GAClC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAC1B,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/src/types/string-literals/RemainingChars.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/Repeat.d.ts

@@ -0,0 +1,8 @@
+import { IsNegativeNumber, FixedLengthArray, Concat } from "..";
+/**
+ * **Repeat**`<TStr,TCount>`
+ *
+ * Creates a string literal by repeating a given string `TStr`, `TCount` times.
+ */
+export type Repeat<TStr extends string, TCount extends number> = IsNegativeNumber<TCount> extends true ? "" : Concat<FixedLengthArray<TStr, TCount>>;
+//# sourceMappingURL=Repeat.d.ts.map

package/dist/types/src/types/string-literals/Repeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Repeat.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/Repeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAG,gBAAgB,EAAG,MAAM,EAAE,MAAM,IAAI,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,MAAM,CAChB,IAAI,SAAS,MAAM,EACnB,MAAM,SAAS,MAAM,IACnB,gBAAgB,CAAC,MAAM,CAAC,SAAS,IAAI,GACvC,EAAE,GACF,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/types/src/types/string-literals/Repeat.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/RetainAfter.d.ts

@@ -0,0 +1,15 @@
+import { AfterFirst, AsArray, Join, Split } from "..";
+/**
+ * **RetainAfter**`<TStr, TBreak>`
+ *
+ * Receives a string `TStr` and truncates all characters in
+ * the first occurrence of `TBreak` and all remaining chars.
+ *
+ * ### Example
+ * ```ts
+ * // "hello"
+ * type T = StripAfter<"hello world", " ">;
+ * ```
+ */
+export type RetainAfter<TStr extends string, TBreak extends string> = string extends TStr ? string : string extends TBreak ? string : Join<AfterFirst<AsArray<Split<TStr, TBreak>>>, TBreak>;
+//# sourceMappingURL=RetainAfter.d.ts.map

package/dist/types/src/types/string-literals/RetainAfter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetainAfter.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/RetainAfter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAG,KAAK,EAAE,MAAM,IAAI,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,CACrB,IAAI,SAAS,MAAM,EACnB,MAAM,SAAS,MAAM,IACnB,MAAM,SAAS,IAAI,GACnB,MAAM,GACN,MAAM,SAAS,MAAM,GACnB,MAAM,GACN,IAAI,CACF,UAAU,CAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAE,EAC1C,MAAM,CACP,CAAC"}

package/dist/types/src/types/string-literals/RetainAfter.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/Split.d.ts

@@ -0,0 +1,26 @@
+import { IfStringLiteral, IsEqual, Tuple, Last, Pop, IfAnd, IfEqual, IfUnion, AfterFirst, First, Shift } from "..";
+type _Split<T extends string, SEP extends string, ANSWER extends readonly string[] = []> = T extends `${infer HEAD}${SEP}${infer TAIL}` ? _Split<TAIL, SEP, [...ANSWER, HEAD]> : [...ANSWER, T];
+type AppendToLastBlock<TContent extends string, TBlocks extends readonly string[]> = Pop<TBlocks> extends readonly string[] ? Last<TBlocks> extends string ? [...Pop<TBlocks>, `${Last<TBlocks>}${TContent}`] : TBlocks : TBlocks;
+type AddNewBlock<TSep extends string, TBlocks extends readonly string[], TUnionPolicy extends "retain" | "omit"> = TUnionPolicy extends "retain" ? [...TBlocks, TSep] : [...TBlocks, ""];
+type _SplitOnUnion<TContent extends readonly string[], TSep extends string, TUnionPolicy extends "retain" | "omit", TBlocks extends readonly string[] = [""]> = [] extends TContent ? Shift<TBlocks> : _SplitOnUnion<AfterFirst<TContent>, TSep, TUnionPolicy, First<TContent> extends TSep ? AddNewBlock<First<TContent>, TBlocks, TUnionPolicy> : AppendToLastBlock<First<TContent>, TBlocks>>;
+type Cleanup<TList extends Tuple<string>, TSep extends string> = IfAnd<[
+    IsEqual<Last<TList>, "">,
+    IsEqual<TSep, "">
+], Pop<TList>, IfEqual<TList, [""], [], TList>>;
+/**
+ * **Split**`<TStr, [SEP]>`
+ *
+ * Splits a string `TStr` by a separator `SEP`.
+ *
+ * - the result is an array of string literals when `T` and `SEP`
+ * are string literals.
+ * - if `T` _or_ `SEP` are wide string then the resultant type is just `string[]`
+ * - if no `SEP` is provided then an empty string literal is used which has the
+ * effect of converting the string into an array of characters.
+ *
+ * **Note:** the `Chars` type utility wraps the functionality of having
+ * no `SEP` character and may be more intuitive to viewers when seen.
+ */
+export type Split<TStr extends string, TSep extends string = "", TUnionPolicy extends "retain" | "omit" = "omit"> = IfStringLiteral<TStr, IfUnion<TSep, _SplitOnUnion<Cleanup<_Split<TStr, "">, "">, TSep, TUnionPolicy>, IfStringLiteral<TSep, Cleanup<_Split<TStr, TSep>, TSep>, string[]>>, string[]>;
+export {};
+//# sourceMappingURL=Split.d.ts.map

package/dist/types/src/types/string-literals/Split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Split.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/Split.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,OAAO,EACP,KAAK,EACL,IAAI,EACJ,GAAG,EACH,KAAK,EACL,OAAO,EACP,OAAO,EACP,UAAU,EACV,KAAK,EACL,KAAK,EACN,MAAM,IAAI,CAAC;AAEZ,KAAK,MAAM,CACT,CAAC,SAAS,MAAM,EAChB,GAAG,SAAS,MAAM,EAClB,MAAM,SAAS,SAAS,MAAM,EAAE,GAAG,EAAE,IACnC,CAAC,SAAS,GAAG,MAAM,IAAI,GAAG,GAAG,GAAG,MAAM,IAAI,EAAE,GAC5C,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC,GACpC,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;AAEnB,KAAK,iBAAiB,CACpB,QAAQ,SAAS,MAAM,EACvB,OAAO,SAAS,SAAS,MAAM,EAAE,IAC/B,GAAG,CAAC,OAAO,CAAC,SAAS,SAAS,MAAM,EAAE,GACtC,IAAI,CAAC,OAAO,CAAC,SAAS,MAAM,GAC1B,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,QAAQ,EAAE,CAAC,GAChD,OAAO,GACT,OAAO,CAAC;AAEZ,KAAK,WAAW,CACd,IAAI,SAAS,MAAM,EACnB,OAAO,SAAS,SAAS,MAAM,EAAE,EACjC,YAAY,SAAS,QAAQ,GAAG,MAAM,IACpC,YAAY,SAAS,QAAQ,GAC7B,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,GAClB,CAAC,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;AAErB,KAAK,aAAa,CAChB,QAAQ,SAAS,SAAS,MAAM,EAAE,EAClC,IAAI,SAAS,MAAM,EACnB,YAAY,SAAS,QAAQ,GAAG,MAAM,EACtC,OAAO,SAAS,SAAS,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,IACtC,EAAE,SAAS,QAAQ,GACnB,KAAK,CAAC,OAAO,CAAC,GACd,aAAa,CACX,UAAU,CAAC,QAAQ,CAAC,EACpB,IAAI,EACJ,YAAY,EACZ,KAAK,CAAC,QAAQ,CAAC,SAAS,IAAI,GACxB,WAAW,CACT,KAAK,CAAC,QAAQ,CAAC,EACf,OAAO,EACP,YAAY,CACb,GACD,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAC,OAAO,CAAC,CAC/C,CAAC;AAEN,KAAK,OAAO,CACV,KAAK,SAAS,KAAK,CAAC,MAAM,CAAC,EAC3B,IAAI,SAAS,MAAM,IACjB,KAAK,CAAC;IACJ,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IACxB,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;CAClB,EACD,GAAG,CAAC,KAAK,CAAC,EACV,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAChC,CAAC;AAGJ;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,KAAK,CACf,IAAI,SAAS,MAAM,EACnB,IAAI,SAAS,MAAM,GAAG,EAAE,EACxB,YAAY,SAAS,QAAQ,GAAG,MAAM,GAAG,MAAM,IAC7C,eAAe,CACjB,IAAI,EACJ,OAAO,CACL,IAAI,EAEJ,aAAa,CACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAC7B,IAAI,EACJ,YAAY,CACb,EACD,eAAe,CACb,IAAI,EAEJ,OAAO,CAAC,MAAM,CAAC,IAAI,EAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAEhC,MAAM,EAAE,CACT,CACF,EAID,MAAM,EAAE,CACT,CAAC"}

package/dist/types/src/types/string-literals/Split.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/StrLen.d.ts

@@ -0,0 +1,11 @@
+import { Tuple } from "..";
+type Compute<TStr extends string, TLen extends Tuple = []> = TStr extends `${infer _Char}${infer Rest}` ? Compute<Rest, [...TLen, unknown]> : TLen["length"];
+/**
+ * **StrLen**`<T>`
+ *
+ * Provides the length of a string if T is a string literal,
+ * otherwise just returns `number` type.
+ */
+export type StrLen<T extends string> = Compute<T>;
+export {};
+//# sourceMappingURL=StrLen.d.ts.map

package/dist/types/src/types/string-literals/StrLen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StrLen.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/StrLen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAE3B,KAAK,OAAO,CACV,IAAI,SAAS,MAAM,EACnB,IAAI,SAAS,KAAK,GAAG,EAAE,IACrB,IAAI,SAAS,GAAG,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,GAC1C,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,GACjC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAEnB;;;;;GAKG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/src/types/string-literals/StrLen.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/StripAfter.d.ts

@@ -0,0 +1,15 @@
+import { AsArray, First, Split } from "..";
+/**
+ * **StripAfter**`<TStr, TBreak>`
+ *
+ * Receives a string `TStr` and truncates all characters in
+ * the first occurrence of `TBreak` and all remaining chars.
+ *
+ * ### Example
+ * ```ts
+ * // "hello"
+ * type T = StripAfter<"hello world", " ">;
+ * ```
+ */
+export type StripAfter<TStr extends string, TBreak extends string> = First<AsArray<Split<TStr, TBreak>>>;
+//# sourceMappingURL=StripAfter.d.ts.map

package/dist/types/src/types/string-literals/StripAfter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripAfter.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/StripAfter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,CACpB,IAAI,SAAS,MAAM,EACnB,MAAM,SAAS,MAAM,IACnB,KAAK,CAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC"}

package/dist/types/src/types/string-literals/StripAfter.js

@@ -0,0 +1 @@
+export {};

package/dist/types/src/types/string-literals/StripLeading.d.ts

@@ -0,0 +1,22 @@
+import { IfAnd, IfLiteral, IsString } from "..";
+/**
+ * **StripStarting**`<T, U>`
+ *
+ * Will strip off of `T` the starting string defined by `U` when
+ * both are string literals.
+ * ```ts
+ * type T = "Hello World";
+ * type U = "Hello ";
+ * // "World"
+ * type R = StripStarting<T,U>;
+ * ```
+ *
+ * Note:
+ *   - if `T` is a non-string type then no transformation will be done
+ *   - same applies to `U`
+ */
+export type StripLeading<T, U> = IfAnd<[
+    IsString<T>,
+    IsString<U>
+], IfLiteral<T, string extends U ? never : T extends `${U & string}${infer After}` ? After : T, string>, T>;
+//# sourceMappingURL=StripLeading.d.ts.map

package/dist/types/src/types/string-literals/StripLeading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StripLeading.d.ts","sourceRoot":"","sources":["../../../../../src/types/string-literals/StripLeading.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,CACpC;IAAE,QAAQ,CAAC,CAAC,CAAC;IAAE,QAAQ,CAAC,CAAC,CAAC;CAAC,EAC3B,SAAS,CAEP,CAAC,EAGD,MAAM,SAAS,CAAC,GAAG,KAAK,GAAG,CAAC,SAAS,GAAG,CAAC,GAAG,MAAM,GAAG,MAAM,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC,EAE9E,MAAM,CACP,EACD,CAAC,CACF,CAAC"}

package/dist/types/src/types/string-literals/StripLeading.js

@@ -0,0 +1 @@
+export {};