inferred-types 0.37.6 → 0.40.2

package/dist/src/types/sets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/sets/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/src/types/sets/index.js

@@ -0,0 +1,11 @@
+export * from "./AllKeys";
+export * from "./Intersection";
+export * from "./IntersectingKeys";
+export * from "./SetCandidate";
+export * from "./SetRemoval";
+export * from "./Unique";
+export * from "./Relate";
+export * from "./Dedupe";
+export * from "./UniqueKeys";
+export * from "./UniqueKv";
+export * from "./UniqueKeysUnion";

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

@@ -0,0 +1,50 @@
+import { UnionToTuple } from "..";
+export type OneToOne = `1:1`;
+export type OneToMany = `1:M`;
+export type OneToZero = `1:0`;
+export type ZeroToOne = `0:1`;
+export type ZeroToMany = `0:M`;
+export type ZeroToZero = `0:0`;
+export type ManyToMany = "M:M";
+export type ManyToOne = "M:1";
+export type ManyToZero = "M:0";
+export type CardinalityNode = "0" | "1" | "M";
+/**
+ * Cardinality which expects a singular input and requires
+ * 1 or many outputs.
+ *
+ * Note: choose `CardinalityFilter1` if you want to allow output
+ * to have no outputs.
+ */
+export type Cardinality1 = OneToOne | OneToMany;
+/**
+ * Cardinality which expects a singular input and maps to 0,
+ * 1, or many outputs.
+ */
+export type CardinalityFilter1 = OneToOne | OneToMany | OneToZero;
+/**
+ * Cardinality which expects a singular input which is allowed to be
+ * _undefined_ or the expected type.
+ */
+export type Cardinality0 = ZeroToOne | ZeroToMany | OneToOne | OneToMany;
+/**
+ * Cardinality which expects a singular input -- which is allowed to be
+ * _undefined_ -- and maps to 0,
+ * 1, or many outputs.
+ */
+export type CardinalityFilter0 = ZeroToOne | ZeroToMany | OneToOne | OneToMany | OneToZero | ZeroToZero;
+export type CardinalityExplicit = `${number}:${number}`;
+/**
+ * Cardinality of any sort between two types
+ */
+export type Cardinality = CardinalityFilter0 | CardinalityFilter1 | ManyToMany | ManyToOne | ManyToZero | CardinalityExplicit;
+/**
+ * The first or _input_ part of the Cardinality relationship
+ */
+export type CardinalityIn<T extends Cardinality> = T extends `${infer IN}:${string}` ? IN : never;
+/**
+ * The second or _output_ part of the Cardinality relationship
+ */
+export type CardinalityOut<T extends Cardinality> = T extends `${string}:${infer OUT}` ? OUT : never;
+export type CardinalityInput<T, C extends Cardinality> = UnionToTuple<C> extends readonly unknown[] ? UnionToTuple<C>[0] extends 1 ? T : T[] : T | undefined;
+//# sourceMappingURL=Cardinality.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Cardinality.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/Cardinality.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC;AAC7B,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC;AAC9B,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC;AAC9B,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC;AAC9B,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC;AAC/B,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC;AAC/B,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC;AAC/B,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC;AAC9B,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC;AAE/B,MAAM,MAAM,eAAe,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,UAAU,GACV,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,MAAM,mBAAmB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,UAAU,GACV,SAAS,GACT,UAAU,GACV,mBAAmB,CAAC;AAGxB;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,IAAI,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAElG;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,GAAG,EAAE,GAClF,GAAG,GACH,KAAK,CAAC;AAEV,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,YAAY,CAAC,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,GAC/F,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAC1B,CAAC,GACD,CAAC,EAAE,GACL,CAAC,GAAG,SAAS,CAAC"}

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

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

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

@@ -0,0 +1,30 @@
+import { AfterFirst, AsArray, AsString, First, FirstChar, Join, LowerAlphaChar, RemainingChars, Split, Tuple, UpperAlphaChar } from "..";
+/**
+ * Make the first character of the string case insensitive which
+ * results in a union type if the first character is alphabetic
+ * but remains unchanged if not.
+ */
+type Insensitive<T extends string> = FirstChar<T> extends UpperAlphaChar ? `${FirstChar<T>}${RemainingChars<T>}` | `${Lowercase<FirstChar<T>>}${RemainingChars<T>}` : FirstChar<T> extends LowerAlphaChar ? FirstChar<T> | Uppercase<FirstChar<T>> : FirstChar<T>;
+/**
+ * Process each of the string blocks where each
+ * block is typically started with an uppercase
+ * character
+ */
+type ProcessBlock<TBlock extends Tuple<string>, TResult extends Tuple = []> = [] extends TBlock ? TResult : ProcessBlock<AfterFirst<TBlock>, [
+    ...TResult,
+    Insensitive<First<TBlock>>
+]>;
+type ProcessElement<TContent extends string> = Join<ProcessBlock<Split<Capitalize<AsString<TContent>>, UpperAlphaChar, "retain"> extends readonly string[] ? Split<Capitalize<AsString<TContent>>, UpperAlphaChar, "retain"> : never>>;
+type ProcessEach<TContent extends readonly string[]> = {
+    [K in keyof TContent]: ProcessElement<TContent[K]>;
+};
+/**
+ * **CaseInsensitive**
+ *
+ * Receives a string literal (or a Tuple of string literals) and then returns a union
+ * type which allows all capital letters to be _upper_ or _lower_ case (as well as
+ * the very first character).
+ */
+export type CaseInsensitive<TContent extends string | readonly string[]> = TContent extends readonly string[] ? ProcessEach<AsArray<TContent>> : ProcessElement<AsString<TContent>>;
+export {};
+//# sourceMappingURL=CaseInsensitive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CaseInsensitive.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/CaseInsensitive.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,OAAO,EACP,QAAQ,EACR,KAAK,EACL,SAAS,EACT,IAAI,EACJ,cAAc,EACd,cAAc,EACd,KAAK,EACL,KAAK,EACL,cAAc,EACf,MAAM,IAAI,CAAC;AAEZ;;;;GAIG;AACH,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,IACjC,SAAS,CAAC,CAAC,CAAC,SAAS,cAAc,GAC/B,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,GACxF,SAAS,CAAC,CAAC,CAAC,SAAS,cAAc,GACjC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GACtC,SAAS,CAAC,CAAC,CAAC,CAAC;AAEnB;;;;GAIG;AACH,KAAK,YAAY,CACf,MAAM,SAAS,KAAK,CAAC,MAAM,CAAC,EAC5B,OAAO,SAAS,KAAK,GAAG,EAAE,IACxB,EAAE,SAAS,MAAM,GACjB,OAAO,GACP,YAAY,CACV,UAAU,CAAC,MAAM,CAAC,EAClB;IAAC,GAAG,OAAO;IAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;CAAC,CACzC,CAAC;AAEN,KAAK,cAAc,CACjB,QAAQ,SAAS,MAAM,IACrB,IAAI,CAAC,YAAY,CACnB,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,SAAS,SAAS,MAAM,EAAE,GACrF,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,GAC/D,KAAK,CACV,CAAC,CAAC;AAEH,KAAK,WAAW,CAChB,QAAQ,SAAS,SAAS,MAAM,EAAE,IAC9B;KACD,CAAC,IAAI,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CACnD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,CACzB,QAAQ,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,IACzC,QAAQ,SAAS,SAAS,MAAM,EAAE,GACpC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAC9B,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC"}

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

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

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

@@ -0,0 +1,8 @@
+import { IfLiteral, Split } from "..";
+/**
+ * **Chars**`<TStr>`
+ *
+ * Takes a literal string and converts it to an array of characters.
+ */
+export type Chars<TStr extends string> = IfLiteral<TStr, Split<TStr, "">, never>;
+//# sourceMappingURL=Chars.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Chars.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/Chars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAGtC;;;;GAIG;AACH,MAAM,MAAM,KAAK,CAAC,IAAI,SAAS,MAAM,IAAI,SAAS,CAChD,IAAI,EACJ,KAAK,CAAC,IAAI,EAAC,EAAE,CAAC,EACd,KAAK,CACN,CAAC"}

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

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

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

@@ -0,0 +1,21 @@
+import { IfLiteral, AfterFirst, First, Tuple } from "..";
+type ElementLiteral<T> = T extends string ? IfLiteral<T, T, string> : T extends number ? IfLiteral<T, T, `${number}`> : T extends boolean ? IfLiteral<T, T, `${boolean}`> : never;
+type Process<T extends Tuple, Result extends string = ""> = [] extends T ? Result : Process<AfterFirst<T>, `${Result}${ElementLiteral<First<T>>}`>;
+/**
+ * **Concat**`<T>`
+ *
+ * A type utility which converts an array of strings into a
+ * _concatenated_ string type.
+ *
+ * ```ts
+ * // `${string}-${string}`
+ * type T1 = Concat<string, "-", string>;
+ * // `foo-bar-baz`
+ * type T2 = Concat<"foo", "-", "bar", "-", "baz">;
+ * ```
+ *
+ * **Related:** `Join<TArr,TWith>`
+ */
+export type Concat<T extends Tuple> = Process<T>;
+export {};
+//# sourceMappingURL=Concat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Concat.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/Concat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAG,UAAU,EAAG,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;AAE3D,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACrC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,GACvB,CAAC,SAAS,MAAM,GAChB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,GAC5B,CAAC,SAAS,OAAO,GACjB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,GAC7B,KAAK,CAAC;AAEV,KAAK,OAAO,CACV,CAAC,SAAS,KAAK,EACf,MAAM,SAAS,MAAM,GAAG,EAAE,IACxB,EAAE,SAAS,CAAC,GACZ,MAAM,GACN,OAAO,CACL,UAAU,CAAC,CAAC,CAAC,EACb,GAAG,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CACvC,CAAC;AAEN;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,MAAM,CAChB,CAAC,SAAS,KAAK,IACb,OAAO,CAAC,CAAC,CAAC,CAAC"}

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

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

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

@@ -0,0 +1,130 @@
+import { NumericChar, NonZeroNumericChar, TupleToUnion, TypeStrength } from "..";
+import { MONTH_ABBR, MONTH_NAME } from "src/constants";
+export type Year<T extends "strong" | "simple" = "strong"> = T extends "strong" ? `${"1" | "2"}${NumericChar}${NumericChar}${NumericChar}` : `${"1" | "2"}${number}`;
+type ZeroThenDigit = `0${NumericChar}`;
+/**
+ * **MonthName**
+ *
+ * The month of the year represented as a full string name.
+ */
+export type MonthName = TupleToUnion<typeof MONTH_NAME>;
+/**
+ * **MonthAbbr**
+ *
+ * The month of the year represented in an abbreviated string format.
+ */
+export type MonthAbbr = TupleToUnion<typeof MONTH_ABBR>;
+/**
+ * **MonthNumeric**
+ *
+ * The month of the year represented in a numeric format.
+ */
+export type MonthNumeric = "10" | "11" | "12" | `${"0" | ""}${NonZeroNumericChar}`;
+/**
+ * **MonthDay**
+ *
+ * The numeric day in the month.
+ */
+export type MonthDay = ZeroThenDigit | `${"" | "1" | "2"}${NumericChar}` | `3${"0" | "1"}`;
+export type DateSeparator = "-" | "/" | ".";
+/**
+ * **YMD**`<[TStrength],[TSep]>
+ * A date format for `YYYY-MM-DD` which is used as a component of the ISO8601 standard.
+ *
+ * > Note: you may optionally change the DateSeparator to suit your needs
+ */
+export type YMD<TStrength extends TypeStrength = "strong", TSep extends DateSeparator = "-"> = TStrength extends "strong" ? `${"1" | "2"}${number}${TSep}${MonthNumeric}${TSep}${MonthDay}` : `${"1" | "2"}${number}${TSep}${number}${TSep}${number}`;
+/**
+ * **DateThenMonth**
+ *
+ * The day of the month followed by an abbreviated string representation
+ * of the month (e.g., `4 July`)
+ */
+export type DateThenMonth = `${MonthDay} ${MonthAbbr}`;
+/**
+ * **DateThenMonthThenYear**
+ *
+ * The day of the month followed by an abbreviated string representation
+ * of the month and finishing with the year (e.g., `4 July 2021`)
+ */
+export type DateThenMonthThenYear = `${MonthDay} ${MonthAbbr}${` ${Year<"simple">}`}`;
+export type MonthPostfix = "" | "st" | "rd" | "th";
+/**
+ * **MonthThenDateThenYear**
+ *
+ * The month's name -- either abbreviate or full -- followed by the
+ * day in the month (e.g., `July 28, 1970`, or `July 28th, 1970`)
+ */
+export type MonthThenDateThenYear = `${MonthAbbr | MonthName} ${MonthDay}${MonthPostfix}${`, ${Year<"simple">}`}`;
+/**
+ * **MonthThenDate**
+ *
+ * The month's name -- either abbreviate or full -- followed by the
+ * day in the month (e.g., `July 28`, `July 28th`)
+ */
+export type MonthThenDate = `${MonthAbbr | MonthName} ${MonthDay}${MonthPostfix}`;
+export type MonthThenDate_Simple = ``;
+/**
+ * **MonthAbbrThenDate**
+ *
+ * The month's name -- in abbreviated form -- followed by the
+ * day in the month. You may optionally add a `MonthPostfix` descriptor.
+ *
+ * ```ts
+ * const date: MonthAbbrThenDate[] = ["Jun 6", "Jun 06", "Jun 6th"]
+ * ```
+ */
+export type MonthAbbrThenDate = `${MonthAbbr} ${MonthDay}${MonthPostfix}`;
+/**
+ * **MonthAbbrThenDateAndYear**
+ *
+ * The month's name -- in abbreviated form -- followed by the
+ * day in the month and the year.
+ *
+ * - you may optionally add a `MonthPostfix` descriptor
+ * - the year must be preceded by `, `
+ *
+ * ```ts
+ * const date: MonthAbbrThenDateAndYear[] = ["Jun 6, 2020", "Jun 06, 2020", "Jun 6th, 2020"]
+ * ```
+ */
+export type MonthAbbrThenDateAndYear = `${MonthAbbr} ${MonthDay}${MonthPostfix}${`, ${Year<"simple">}`}`;
+/**
+ * **FullDate**
+ *
+ * Allows the representation of a date using one of several representations:
+ *
+ * 1. `YYYY-MM-DD` / `YYYY.MM.DD` / `YYYY/MM/DD`
+ * 2. `13 Jun 2020`
+ * 3. `July 4th, 2019`
+ *
+ * Note: to keep types as simple as possible, the `YMD` type has been replaced
+ * with just the `YMD_Simple` type. If you really need stronger typing use
+ * the `FullDateStrong` type.
+ */
+export type FullDate = YMD<"simple"> | DateThenMonthThenYear | MonthThenDateThenYear;
+/**
+ * **ShortDate**
+ *
+ * Represent the month and day of month in one of two structural formats:
+ *
+ * 1. `13 Jun`
+ * 2. `Jun 13` or `Jun 13th` or `June 13th`
+ *
+ * **Note:** the year is _not_ representable using this type
+ */
+export type ShortDate = DateThenMonth | MonthThenDate;
+/**
+ * **Date**
+ *
+ * A simplified type to represent different date formats. If you
+ * need stronger type validation consider those in **related** section
+ * below. All stronger type definitions will rollup to this type.
+ *
+ * **Related:** `FullDate`, `ShortDate`, `YMD`, `MonthThenDate`,
+ * `MonthThenDateAndYear`, `MonthAbbrThenDate`, `MonthAbbrDateAndYear`
+ * `DateThenMonth`, `DateThenMonthAndYear`
+ */
+export type Date = YMD<"simple"> | `${MonthAbbr}${string}` | `${MonthDay}${string}`;
+export {};
+//# sourceMappingURL=Date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Date.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/Date.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACb,MAAM,IAAI,CAAC;AACZ,OAAO,EAAE,UAAU,EAAE,UAAU,EAAC,MAAO,eAAe,CAAC;AAEvD,MAAM,MAAM,IAAI,CACd,CAAC,SAAS,QAAQ,GAAG,QAAQ,GAAG,QAAQ,IACtC,CAAC,SAAS,QAAQ,GACpB,GAAG,GAAG,GAAG,GAAG,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,EAAE,GACxD,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,EAAE,CAAC;AAE1B,KAAK,aAAa,GAAG,IAAI,WAAW,EAAE,CAAC;AAEvC;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;AAGxD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAI,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,EAAE,GAAG,kBAAkB,EAAE,CAAC;AAEpF;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,WAAW,EAAE,GAAG,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;AAE3F,MAAM,MAAM,aAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAG5C;;;;;GAKG;AACH,MAAM,MAAM,GAAG,CACb,SAAS,SAAS,YAAY,GAAG,QAAQ,EACzC,IAAI,SAAS,aAAa,GAAG,GAAG,IAC9B,SAAS,SAAS,QAAQ,GAC5B,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,GAAG,QAAQ,EAAE,GAC/D,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,GAAG,QAAQ,IAAI,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;AAGtF,MAAM,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,GAAG,SAAS,GAAG,SAAS,IAAI,QAAQ,GAAG,YAAY,GAAG,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;AAElH;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,SAAS,GAAG,SAAS,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;AAGlF,MAAM,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,SAAS,IAAI,QAAQ,GAAG,YAAY,EAAE,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,wBAAwB,GAAG,GAAG,SAAS,IAAI,QAAQ,GAAG,YAAY,GAAG,KAAK,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;AAEzG;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAErF;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;AAGtD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,GAAG,QAAQ,GAAG,MAAM,EAAE,CAAC"}

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

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

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

@@ -0,0 +1,29 @@
+import { DateSeparator, HoursMinutes, HoursMinutesSeconds, TZ, Time, YMD, TypeStrength, TypeRequired, MilitaryHours, Minutes, TimeNomenclature, TimeResolution } from "..";
+/**
+ * **DateTimeMinutes**
+ *
+ * The date and time with time resolution of minutes.
+ */
+export type DateTimeMinutes<S extends DateSeparator = DateSeparator> = `${YMD<"simple", S>} ${HoursMinutes}`;
+export type DateTimeSeconds<S extends DateSeparator = DateSeparator> = `${YMD<"simple", S>} ${HoursMinutesSeconds}`;
+/**
+ * **DateTime**`<S>`
+ *
+ * A simplified way of representing any supported representation
+ * of a `DateTime` string.
+ *
+ * **Note:** the most common and best choice is often the `Iso8601`
+ * datetime representation.
+ */
+export type DateTime<TNomenclature extends TimeNomenclature = "either", TResolution extends TimeResolution | "all" = "all", TTimezone extends TypeRequired = "exclude", TSep extends DateSeparator = "-"> = `${YMD<"simple", TSep>} ${Time<TNomenclature, TResolution, TTimezone>}`;
+/**
+ * **Iso8601**<TStrength>
+ *
+ * Creates typing for the [**ISO8601**](https://en.wikipedia.org/wiki/ISO_8601)
+ * datetime format.
+ *
+ * - the strength/complexity of the type can be set with `TStrength`
+ * - a timezone is optional by default but can be isolated to "required" or "excluded"
+ */
+export type Iso8601<TStr extends TypeStrength = "strong", TTimezone extends TypeRequired = "optional"> = TStr extends "strong" ? `${YMD<"simple">}T${MilitaryHours}:${Minutes<"simple">}:${number}.${number}${TZ<"simple", TTimezone>}` : `${number}-${number}-${number}T${number}:${number}:${number}.${number}${TZ<"simple", TTimezone>}`;
+//# sourceMappingURL=DateTime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DateTime.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/DateTime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,EAAE,EACF,IAAI,EACJ,GAAG,EACH,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,OAAO,EACP,gBAAgB,EAChB,cAAc,EACf,MAAM,IAAI,CAAC;AAGZ;;;;GAIG;AACH,MAAM,MAAM,eAAe,CACzB,CAAC,SAAS,aAAa,GAAG,aAAa,IACrC,GAAG,GAAG,CAAC,QAAQ,EAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC;AAEzC,MAAM,MAAM,eAAe,CACzB,CAAC,SAAS,aAAa,GAAG,aAAa,IACrC,GAAG,GAAG,CAAC,QAAQ,EAAC,CAAC,CAAC,IAAI,mBAAmB,EAAE,CAAC;AAGhD;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,CAClB,aAAa,SAAS,gBAAgB,GAAG,QAAQ,EACjD,WAAW,SAAS,cAAc,GAAG,KAAK,GAAG,KAAK,EAClD,SAAS,SAAS,YAAY,GAAG,SAAS,EAC1C,IAAI,SAAS,aAAa,GAAG,GAAG,IAC9B,GAAG,GAAG,CAAC,QAAQ,EAAC,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,EAAC,WAAW,EAAC,SAAS,CAAC,EAAE,CAAC;AAGzE;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,CACjB,IAAI,SAAS,YAAY,GAAG,QAAQ,EACpC,SAAS,SAAS,YAAY,GAAG,UAAU,IACzC,IAAI,SAAS,QAAQ,GACrB,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,aAAa,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,MAAM,IAAI,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,GAEtG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAC"}

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

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

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

@@ -0,0 +1,13 @@
+import { IfContains, Chars, RemoveNever, Concat } from "..";
+type Process<TContent extends readonly string[], TDrop extends readonly string[]> = RemoveNever<{
+    [K in keyof TContent]: IfContains<TDrop, TContent[K], never, TContent[K]>;
+}>;
+/**
+ * **DropChars**`<TContent,TDrop>`
+ *
+ * Removes all characters found in `TDrop` from the string content
+ * in `TContent`.
+ */
+export type DropChars<TContent extends string, TDrop extends string> = Process<Chars<TContent>, Chars<TDrop>> extends readonly string[] ? Concat<Process<Chars<TContent>, Chars<TDrop>>> : "";
+export {};
+//# sourceMappingURL=DropChars.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DropChars.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/DropChars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAE5D,KAAK,OAAO,CACV,QAAQ,SAAS,SAAS,MAAM,EAAE,EAClC,KAAK,SAAS,SAAS,MAAM,EAAE,IAC7B,WAAW,CAAC;KACb,CAAC,IAAI,MAAM,QAAQ,GAAG,UAAU,CAC/B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,KAAK,EACL,QAAQ,CAAC,CAAC,CAAC,CACZ;CACF,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,MAAM,SAAS,CACnB,QAAQ,SAAS,MAAM,EACvB,KAAK,SAAS,MAAM,IAClB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,GAClE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAC9C,EAAE,CAAC"}

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * **EmptyString**
+ *
+ * A string literal of an _empty_ string;
+ */
+export type EmptyString = "";
+//# sourceMappingURL=EmptyString.d.ts.map

package/dist/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/src/types/string-literals/EmptyString.js

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

package/dist/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/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/src/types/string-literals/EmptyStringOr.js

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

package/dist/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/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/src/types/string-literals/EnsureLeading.js

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

package/dist/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/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/src/types/string-literals/EnsureLeadingEvery.js

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

package/dist/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/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/src/types/string-literals/EnsureTrailing.js

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

package/dist/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/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/src/types/string-literals/FirstChar.js

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

package/dist/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/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/src/types/string-literals/HasUppercase.js

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

package/dist/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/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/src/types/string-literals/Interpolate.js

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

package/dist/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/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/src/types/string-literals/IsCapitalized.js

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

package/dist/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/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/src/types/string-literals/Join.js

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