inferred-types 0.42.1 → 0.43.1

package/dist/types/string-literals/character-sets/IpAddress.d.ts

@@ -1,16 +1,62 @@
-import { Suggest } from "../../index";
+import { HexadecimalChar, NumericChar, NumericCharZeroToFive, Suggest } from "../../index";
+import { IPv6 } from "../../../constants/index";
+/**
+ * **IPv4Number**
+ *
+ * A high resolution typing for a single octet of an **IP version 4** IP address.
+ */
+export type Ipv4Octet = `25${NumericCharZeroToFive}` | `24${NumericChar}` | `23${NumericChar}` | `22${NumericChar}` | `21${NumericChar}` | `20${NumericChar}` | `1${NumericChar}${NumericChar}` | `${NumericChar}${NumericChar}` | `${NumericChar}`;
+/**
+* the range of IPv6 addresses which are considered **multicast**.
+*/
+export type IP6Multicast = typeof IPv6["Multicast"];
+/**
+* the range of IPv6 addresses which are considered **unicast**.
+*/
+export type IP6Unicast = typeof IPv6["Unicast"];
+export type Ip6Loopback = typeof IPv6["Loopback"];
+export type Ip6Group = `${HexadecimalChar}${string}`;
 /**
  * **Ipv4**
  *
  * A simple representation of an IPv4 address
  */
-export type Ipv4 = `${number}.${number}.${number}.${number}`;
+export type Ip4Address = `${number}.${number}.${number}.${number}`;
+export type Netmask = `/${number}`;
+export type Ipv4WithNetmask = `${Ip4Address}${Netmask}`;
+/**
+ * An IPv6 Address
+ *
+ * **Notes:**
+ *
+ * - a full representation is 8 groups of 4 hexadecimal characters and
+ * is _rarely_ used as it's just way too much specificity for most situations.
+ * It is also impossible to type this in a strong manner due to the huge optionality.
+ * - in a full representation you may drop the leading 0's (and it's considered
+ * best practice to do so)
+ * - if one of the groups is all zeros you can simply express it as `::`
+ *
+ * Rather than expressing a _specific_ IPv6 address the more common thing
+ * is to express an **IP subnet** owned by an organization or an individual.
+ *
+ * **Related:** `Ip6Subnet`
+ */
+export type Ip6Address = `${string}:${string}:${string}:${string}:${string}:${string}:${string}:${string}` | `${string}::${string}:${string}:${string}:${string}:${string}:${string}` | `${string}:${string}::${string}:${string}:${string}:${string}:${string}` | `${string}:${string}:${string}::${string}:${string}:${string}:${string}` | `${string}:${string}:${string}:${string}::${string}:${string}:${string}` | `${string}:${string}:${string}:${string}:${string}::${string}:${string}` | `${string}:${string}:${string}:${string}:${string}:${string}::${string}` | `${string}:${string}:${string}:${string}:${string}:${string}:${string}::`;
+export type Ip6SubnetPrefix = `${string}:${string}:${string}:${string}`;
+export type AsIp6Prefix<T extends readonly Ip6Group[]> = T extends [Ip6Group] ? `${T[0]}:${string}:${string}:${string}` : T extends [Ip6Group, Ip6Group] ? `${T[0]}:${T[1]}:${string}:${string}` : T extends [Ip6Group, Ip6Group, Ip6Group] ? `${T[0]}:${T[1]}:${T[2]}:${string}` : T extends [Ip6Group, Ip6Group, Ip6Group, Ip6Group, ...Ip6Group[]] ? `${T[0]}:${T[1]}:${T[3]}:${T[4]}` : `${string}:${string}:${string}:${string}`;
 /**
- * **Ipv6**
+ * An IPv6 subnet.
+ *
+ * When an organization or even an individual receives IPv6 addresses they almost
+ * always receive MANY ip addresses (aka, a subnet of addresses). The most
+ * common subnet masks are `48` (for organizations) and `64` for individuals.
  *
- * A simple representation of an IPv6 address
+ * ```ts
+ * // 2001:db8:1:1::/64
+ * IpSubnet<"2001:db8:1:1",64>
+ * ```
  */
-export type Ipv6 = `${number}:${number}:${number}:${number}:${number}:${number}:${number}:${number}`;
+export type Ip6Subnet<TPrefix extends Ip6SubnetPrefix = Ip6SubnetPrefix, TMask extends number = number> = `${TPrefix}::/${TMask}`;
 /**
  * **SuggestIpAddress**
  *

package/dist/types/string-literals/character-sets/IpAddress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IpAddress.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/IpAddress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,oBAAwB;AAE1C;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAErG;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC,CAAC"}
+{"version":3,"file":"IpAddress.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/IpAddress.ts"],"names":[],"mappings":"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"}

package/dist/types/string-literals/character-sets/LowerAlpha.d.ts

@@ -1,4 +1,4 @@
-import { AsArray, IfAllExtend, IfStringLiteral, LowerAlphaChar, Split } from "../../index";
+import { AsArray, IfAllExtend, If, IsStringLiteral, LowerAlphaChar, Chars } from "../../index";
 /**
  * **LowerAlpha**`<T>`
  *
@@ -8,5 +8,5 @@ import { AsArray, IfAllExtend, IfStringLiteral, LowerAlphaChar, Split } from "..
  * - `string` - when T is a wide string type
  * - `never` - all other types of `T` are converted to never
  */
-export type LowerAlpha<T> = T extends string ? IfStringLiteral<T, IfAllExtend<AsArray<Split<T>>, LowerAlphaChar, T, never>, string> : never;
+export type IsLowerAlpha<T> = T extends string ? If<IsStringLiteral<T>, IfAllExtend<AsArray<Chars<T>>, LowerAlphaChar, T, never>, string> : never;
 //# sourceMappingURL=LowerAlpha.d.ts.map

package/dist/types/string-literals/character-sets/LowerAlpha.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LowerAlpha.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/LowerAlpha.ts"],"names":[],"mappings":"AAAA,OAAO,EAAG,OAAO,EAAE,WAAW,EAAG,eAAe,EAAE,cAAc,EAAE,KAAK,EAAE,oBAAwB;AAEjG;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACxC,eAAe,CACb,CAAC,EACD,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,KAAK,CAAC,EACxD,MAAM,CACP,GACD,KAAK,CAAC"}
+{"version":3,"file":"LowerAlpha.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/LowerAlpha.ts"],"names":[],"mappings":"AAAA,OAAO,EAAG,OAAO,EAAE,WAAW,EAAG,EAAE,EAAE,eAAe,EAAE,cAAc,EAAG,KAAK,EAAE,oBAAwB;AAEtG;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC1C,EAAE,CACA,eAAe,CAAC,CAAC,CAAC,EAClB,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,KAAK,CAAC,EACxD,MAAM,CACP,GACD,KAAK,CAAC"}

package/dist/types/string-literals/character-sets/NumericChar.d.ts

@@ -14,4 +14,13 @@ export type NumericChar = TupleToUnion<Mutable<typeof NUMERIC_CHAR>>;
  * Numeric string characters with the exception of "0".
  */
 export type NonZeroNumericChar = TupleToUnion<typeof NON_ZERO_NUMERIC_CHAR>;
+export type NumericCharZeroToOne = "0" | "1";
+export type NumericCharZeroToTwo = "0" | "1" | "2";
+export type NumericCharZeroToThree = "0" | "1" | "2" | "3";
+export type NumericCharZeroToFour = "0" | "1" | "2" | "3" | "4";
+export type NumericCharZeroToFive = "0" | "1" | "2" | "3" | "4" | "5";
+export type NumericCharOneToTwo = "1" | "2";
+export type NumericCharOneToThree = "1" | "2" | "3";
+export type NumericCharOneToFour = "1" | "2" | "3" | "4";
+export type NumericCharOneToFive = "1" | "2" | "3" | "4" | "5";
 //# sourceMappingURL=NumericChar.d.ts.map

package/dist/types/string-literals/character-sets/NumericChar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NumericChar.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/NumericChar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,iCAA4B;AAC1E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,oBAAwB;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"NumericChar.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/NumericChar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,iCAA4B;AAC1E,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,oBAAwB;AAExD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAErE;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAG5E,MAAM,MAAM,oBAAoB,GAAG,GAAG,GAAG,GAAG,CAAE;AAC9C,MAAM,MAAM,oBAAoB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAE;AACpD,MAAM,MAAM,sBAAsB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAE;AAC5D,MAAM,MAAM,qBAAqB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAChE,MAAM,MAAM,qBAAqB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAGtE,MAAM,MAAM,mBAAmB,GAAI,GAAG,GAAG,GAAG,CAAE;AAC9C,MAAM,MAAM,qBAAqB,GAAI,GAAG,GAAG,GAAG,GAAG,GAAG,CAAE;AACtD,MAAM,MAAM,oBAAoB,GAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC"}

package/dist/types/string-literals/character-sets/SingularNoun.d.ts

@@ -1,12 +1,12 @@
 import { SINGULAR_NOUN_ENDINGS } from "../../../constants/index";
-import { AlphaChar, IfAllExtend, Split, TupleToUnion, Mutable, AsArray } from "../../index";
+import { AlphaChar, TupleToUnion, Mutable, Chars, AllExtend, If } from "../../index";
 /**
  * **SingularNounEnding**
  *
  * A union of characters which when found at the end of a word are a strong
  * indicator that the word is a singular noun.
  *
- * **Related:** `SINGULAR_NOUN_ENDINGS`, `SingularNoun`, `SINGULAR_NOUN_RE`
+ * **Related:** `SingularNoun`, `IsSingularNoun`
  */
 export type SingularNounEnding = TupleToUnion<Mutable<typeof SINGULAR_NOUN_ENDINGS>>;
 /**
@@ -24,6 +24,8 @@ export type SingularNounEnding = TupleToUnion<Mutable<typeof SINGULAR_NOUN_ENDIN
  * // rush
  * type T2 = SingularNoun<"rush">;
  * ```
+ *
+ * **Related:** `IsSingularNoun`
  */
-export type SingularNoun<T extends string> = T extends `${infer Prelude}${SingularNounEnding}` ? IfAllExtend<AsArray<Split<Prelude>>, AlphaChar, T, never> : never;
+export type SingularNoun<T extends string> = T extends `${infer Prelude}${SingularNounEnding}` ? If<AllExtend<Chars<Prelude>, AlphaChar>, T, never> : never;
 //# sourceMappingURL=SingularNoun.d.ts.map

package/dist/types/string-literals/character-sets/SingularNoun.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SingularNoun.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/SingularNoun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,iCAA4B;AAC5D,OAAO,EAAE,SAAS,EAAG,WAAW,EAAE,KAAK,EAAG,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAwB;AAClG;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC;AAErF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,OAAO,GAAG,kBAAkB,EAAE,GAC1F,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,CAAC,GACzD,KAAK,CAAC"}
+{"version":3,"file":"SingularNoun.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/SingularNoun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,iCAA4B;AAC5D,OAAO,EAAE,SAAS,EAAG,YAAY,EAAE,OAAO,EAAG,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,oBAAwB;AAC3F;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC;AAErF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,OAAO,GAAG,kBAAkB,EAAE,GAC1F,EAAE,CACA,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,EACpC,CAAC,EACD,KAAK,CACN,GACD,KAAK,CAAC"}

package/dist/types/string-literals/character-sets/Url.d.ts

@@ -1,5 +1,5 @@
 import { DomainName } from "./DomainName";
-import { Ipv4 } from "./IpAddress";
+import { Ip4Address } from "./IpAddress";
 import { VariableChar } from "./Variable";
 export type NetworkProtocol = "http" | "https" | "file" | "ws" | "wss";
 export type RelativeUrl = `${VariableChar | "/"}`;
@@ -8,6 +8,6 @@ export type RelativeUrl = `${VariableChar | "/"}`;
  * for a fully qualified URL like `https://google.com`. It can't ensure the
  * type is fully valid but does help to avoid some typos.
  */
-export type FullyQualifiedUrl = `${NetworkProtocol}://${Ipv4 | DomainName}/${string}`;
+export type FullyQualifiedUrl = `${NetworkProtocol}://${Ip4Address | DomainName}/${string}`;
 export type UrlBuilder = (<P extends NetworkProtocol, D extends DomainName, B extends RelativeUrl>(protocol: P, domain: D, basePath: B) => `${P}://${D}/${B}`) | (<U extends RelativeUrl>(url: U) => U);
 //# sourceMappingURL=Url.d.ts.map

package/dist/types/string-literals/character-sets/Url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Url.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/Url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;AAGvE,MAAM,MAAM,WAAW,GAAG,GAAG,YAAY,GAAG,GAAG,EAAE,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,eAAe,MAAM,IAAI,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;AAEtF,MAAM,MAAM,UAAU,GAClB,CAAC,CAAC,CAAC,SAAS,eAAe,EAAE,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,WAAW,EACtE,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,CAAC,KACR,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,GACxB,CAAC,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC"}
+{"version":3,"file":"Url.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/Url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;AAGvE,MAAM,MAAM,WAAW,GAAG,GAAG,YAAY,GAAG,GAAG,EAAE,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,eAAe,MAAM,UAAU,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;AAE5F,MAAM,MAAM,UAAU,GAClB,CAAC,CAAC,CAAC,SAAS,eAAe,EAAE,CAAC,SAAS,UAAU,EAAE,CAAC,SAAS,WAAW,EACtE,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,CAAC,KACR,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,GACxB,CAAC,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC"}

package/dist/types/string-literals/character-sets/ValueAtDotPath.d.ts

@@ -1,10 +1,5 @@
-import { AfterFirst, First, Split, Tuple, ErrorCondition } from "../../index";
-import { DotPath } from "./DotPath";
-type Recurse<TValue, TSegments extends Tuple<string>, TPath extends string> = [] extends TSegments ? TValue : First<TSegments> extends keyof TValue ? Recurse<TValue[First<TSegments>], AfterFirst<TSegments>, TPath> : ErrorCondition<"invalid-path-segment", `The path segment "${First<TSegments>}" is an invalid key for the container passed into ValueAtDotPath`, {
-    utility: `ValueAtDotPath<TValue,${TPath}>`;
-}>;
-export type ValueAtDotPath<TValue, TPath extends string> = DotPath<TPath> extends string ? Recurse<TValue, Split<TPath, "."> & readonly string[], TPath> : ErrorCondition<"invalid-dot-path", `The dot path of "${TPath}" is not valid and therefore we can not use it to determine type information at design time.`, {
-    utility: "ValueAtDotPath";
-}>;
+import { AfterFirst, First, Split, IsValidDotPath, Container, IsVueRef, AsRef, IsLiteral, IsStringLiteral } from "../../index";
+type Process<TContainer extends Container, TIndexes extends readonly string[]> = [] extends TIndexes ? TContainer : First<TIndexes> extends keyof TContainer ? TContainer[First<TIndexes>] extends Container ? Process<TContainer[First<TIndexes>], AfterFirst<TIndexes>> : AfterFirst<TIndexes>["length"] extends 0 ? TContainer[First<TIndexes>] : false : IsVueRef<TContainer> extends true ? First<TIndexes> extends keyof AsRef<TContainer>["value"] ? TIndexes["length"] extends 1 ? AsRef<TContainer>["value"][First<TIndexes>] : AsRef<TContainer>["value"][First<TIndexes>] extends Container ? Process<AsRef<TContainer>["value"][First<TIndexes>], AfterFirst<TIndexes>> : AfterFirst<TIndexes>["length"] extends 0 ? AsRef<TContainer>["value"][First<TIndexes>] : false : false : false;
+export type ValueAtDotPath<TValue extends Container, TPath extends string> = [IsValidDotPath<TValue, TPath>] extends [true] ? IsLiteral<TValue> extends true ? IsStringLiteral<TPath> extends true ? Split<TPath, "."> extends readonly string[] ? Process<TValue, Split<TPath, ".">> : never : string : string : never;
 export {};
 //# sourceMappingURL=ValueAtDotPath.d.ts.map

package/dist/types/string-literals/character-sets/ValueAtDotPath.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ValueAtDotPath.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/ValueAtDotPath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAG,cAAc,EAAE,oBAAwB;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,KAAK,OAAO,CACV,MAAM,EACN,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,EAC/B,KAAK,SAAS,MAAM,IAClB,EAAE,SAAS,SAAS,GACtB,MAAM,GACN,KAAK,CAAC,SAAS,CAAC,SAAS,MAAM,MAAM,GACnC,OAAO,CACL,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EACxB,UAAU,CAAC,SAAS,CAAC,EACrB,KAAK,CACN,GACD,cAAc,CACZ,sBAAsB,EACtB,qBAAqB,KAAK,CAAC,SAAS,CAAC,kEAAkE,EACvG;IAAE,OAAO,EAAE,yBAAyB,KAAK,GAAG,CAAA;CAAE,CAC/C,CAAC;AAEN,MAAM,MAAM,cAAc,CACxB,MAAM,EACN,KAAK,SAAS,MAAM,IAClB,OAAO,CAAC,KAAK,CAAC,SAAS,MAAM,GAC7B,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,SAAS,MAAM,EAAE,EAAE,KAAK,CAAC,GAC7D,cAAc,CAAC,kBAAkB,EAAE,oBAAoB,KAAK,8FAA8F,EAAE;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAC,CAAC,CAAC"}
+{"version":3,"file":"ValueAtDotPath.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/ValueAtDotPath.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,EACL,KAAK,EACL,cAAc,EACd,SAAS,EACT,QAAQ,EACR,KAAK,EACL,SAAS,EACT,eAAe,EAChB,oBAAwB;AAGzB,KAAK,OAAO,CACR,UAAU,SAAS,SAAS,EAC5B,QAAQ,SAAS,SAAS,MAAM,EAAE,IAClC,EAAE,SAAS,QAAQ,GACnB,UAAU,GACV,KAAK,CAAC,QAAQ,CAAC,SAAS,MAAM,UAAU,GACtC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,SAAS,SAAS,GAC3C,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAC3B,UAAU,CAAC,QAAQ,CAAC,CACrB,GACD,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GACtC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAC3B,KAAK,GACT,QAAQ,CAAC,UAAU,CAAC,SAAS,IAAI,GAC/B,KAAK,CAAC,QAAQ,CAAC,SAAS,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,GACtD,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,GAC1B,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAC3C,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,SAAS,SAAS,GAC3D,OAAO,CACL,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAC3C,UAAU,CAAC,QAAQ,CAAC,CACrB,GACD,UAAU,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GACtC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAC3C,KAAK,GACX,KAAK,GACP,KAAK,CAAC;AAGd,MAAM,MAAM,cAAc,CACxB,MAAM,SAAS,SAAS,EACxB,KAAK,SAAS,MAAM,IAClB,CAAC,cAAc,CAAC,MAAM,EAAC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAC/C,SAAS,CAAC,MAAM,CAAC,SAAS,IAAI,GAC5B,eAAe,CAAC,KAAK,CAAC,SAAS,IAAI,GACjC,KAAK,CAAC,KAAK,EAAC,GAAG,CAAC,SAAS,SAAS,MAAM,EAAE,GACxC,OAAO,CACL,MAAM,EACN,KAAK,CAAC,KAAK,EAAC,GAAG,CAAC,CACjB,GACD,KAAK,GACP,MAAM,GACR,MAAM,GACR,KAAK,CAAC"}

package/dist/types/string-literals/character-sets/index.d.ts

@@ -8,7 +8,6 @@ export * from "./Punctuation";
 export * from "./DomainName";
 export * from "./Url";
 export * from "./CSV";
-export * from "./DotPath";
 export * from "./DotPathFor";
 export * from "./IpAddress";
 export * from "./OptionalSpace";

package/dist/types/string-literals/character-sets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAE5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/types/string-literals/character-sets/index.js

@@ -8,7 +8,6 @@ export * from "./Punctuation.js";
 export * from "./DomainName.js";
 export * from "./Url.js";
 export * from "./CSV.js";
-export * from "./DotPath.js";
 export * from "./DotPathFor.js";
 export * from "./IpAddress.js";
 export * from "./OptionalSpace.js";

package/dist/types/string-literals/geo/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./state";
+export * from "./zip";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/string-literals/geo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/geo/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/types/string-literals/geo/index.js

@@ -0,0 +1,2 @@
+export * from "./state.js";
+export * from "./zip.js";

package/dist/types/string-literals/geo/state.d.ts

@@ -0,0 +1,47 @@
+import { US_STATE_LOOKUP, US_STATE_LOOKUP_PROVINCES } from "../../../constants/index";
+import { Mutable, IsTrue } from "../../index";
+type UsStateLookup = Mutable<typeof US_STATE_LOOKUP>;
+type UsProvinceLookup = Mutable<typeof US_STATE_LOOKUP_PROVINCES>;
+type _UsStateAbbrev = {
+    [K in keyof UsStateLookup]: UsStateLookup[K] extends {
+        abbrev: infer A extends string;
+    } ? A : never;
+}[number];
+type _UsProvinceAbbrev = {
+    [K in keyof UsProvinceLookup]: UsProvinceLookup[K] extends {
+        abbrev: infer A extends string;
+    } ? A : never;
+}[number];
+/**
+ * **UsStateAbbrev**`<TStrict>`
+ *
+ * A union type which includes all state abbreviations.
+ *
+ * By default it will also include all US provinces and territories which have
+ * a state abbreviation. If you prefer to just use the strict state list then
+ * set `TStrict` to **true**.
+ *
+ * **Related:** `UsStateAbbrev`
+ */
+export type UsStateAbbrev<TStrict extends boolean = false> = IsTrue<TStrict> extends true ? Exclude<_UsStateAbbrev, _UsProvinceAbbrev> : _UsStateAbbrev;
+type _UsStateName = {
+    [K in keyof UsStateLookup]: UsStateLookup[K] extends {
+        name: infer A extends string;
+    } ? A : never;
+}[number];
+type _UsProvinceName = {
+    [K in keyof UsProvinceLookup]: UsProvinceLookup[K] extends {
+        name: infer A extends string;
+    } ? A : never;
+}[number];
+/**
+ * **UsStateName**`<TStrict>`
+ *
+ * A union type which includes all US state names (and provinces with state codes)
+ * fully spelled out. If you want _only_ US states set the `TStrict` generic to `true`.
+ *
+ * **Related:** `UsStateAbbrev`
+ */
+export type UsStateName<TStrict extends boolean = false> = IsTrue<TStrict> extends true ? Exclude<_UsStateName, _UsProvinceName> : _UsStateName;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/types/string-literals/geo/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/geo/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAE,yBAAyB,EAAC,iCAA2B;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,oBAAwB;AAGlD,KAAK,aAAa,GAAG,OAAO,CAAC,OAAO,eAAe,CAAC,CAAC;AACrD,KAAK,gBAAgB,GAAG,OAAO,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAGlE,KAAK,cAAc,GAAG;KACnB,CAAC,IAAI,MAAM,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;KAAC,GAClF,CAAC,GACD,KAAK;CACV,CAAC,MAAM,CAAC,CAAC;AAEV,KAAK,iBAAiB,GAAG;KACtB,CAAC,IAAI,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;KAAC,GACxF,CAAC,GACD,KAAK;CACV,CAAC,MAAM,CAAC,CAAC;AAEV;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,GACvF,OAAO,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAC1C,cAAc,CAAC;AAEjB,KAAK,YAAY,GAAG;KACjB,CAAC,IAAI,MAAM,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS;QACnD,IAAI,EAAE,MAAM,CAAC,SAAS,MAAM,CAAC;KAC9B,GACG,CAAC,GACD,KAAK;CACV,CAAC,MAAM,CAAC,CAAC;AAEV,KAAK,eAAe,GAAG;KACpB,CAAC,IAAI,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC,SAAS,MAAM,CAAA;KAAE,GACvF,CAAC,GACD,KAAK;CACV,CAAC,MAAM,CAAC,CAAC;AAEV;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,GACnF,OAAO,CAAC,YAAY,EAAE,eAAe,CAAC,GACtC,YAAY,CAAC"}

package/dist/types/string-literals/geo/zip.d.ts

@@ -0,0 +1,24 @@
+import { Chars, First, Mutable, NumericChar, TupleToUnion } from "../../index";
+import { ZIP_TO_STATE } from "../../../constants/index";
+/**
+ * **Zip5**
+ *
+ * A five digit zip code.
+ *
+ * **Related:** `ZipPlus4`, `ZipCode`
+ */
+export type Zip = `${NumericChar}${number}${NumericChar}${number}${NumericChar}`;
+type Z2S = Mutable<typeof ZIP_TO_STATE>;
+/**
+ * **ZipToState**`<T>`
+ *
+ * Converts a zip code into a _union type_ of
+ */
+export type ZipToState<T extends string> = First<Chars<T>> extends keyof Z2S ? TupleToUnion<Z2S[First<Chars<T>>]> : never;
+export type ZipPlus4 = `${Zip}${NumericChar}${number}`;
+/**
+ * A relatively strong type for Zip5 or Zip5+4 zip codes
+ */
+export type ZipCode = ZipPlus4 | Zip;
+export {};
+//# sourceMappingURL=zip.d.ts.map

package/dist/types/string-literals/geo/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/geo/zip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,oBAAwB;AACnF,OAAO,EAAE,YAAY,EAAE,iCAA4B;AAEnD;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,GAAG,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,EAAE,CAAC;AAEjF,KAAK,GAAG,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAExC;;;;GAIG;AACH,MAAM,MAAM,UAAU,CACpB,CAAC,SAAS,MAAM,IACd,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,GACnC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClC,KAAK,CAAC;AAGR,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,GAAG,WAAW,GAAG,MAAM,EAAE,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,GAAG,CAAC"}

package/dist/types/string-literals/index.d.ts

@@ -3,16 +3,16 @@ export * from "./Cardinality";
 export * from "./Chars";
 export * from "./Date";
 export * from "./DateTime";
-export * from "./DropChars";
 export * from "./HasUppercase";
 export * from "./EnsureLeading";
+export * from "./EnsureSurround";
 export * from "./EnsureLeadingEvery";
 export * from "./EmptyString";
 export * from "./EmptyStringOr";
 export * from "./EnsureTrailing";
 export * from "./FirstChar";
 export * from "./LastChar";
-export * from "./RemainingChars";
+export * from "./AfterFirstChar";
 export * from "./IsCapitalized";
 export * from "./Join";
 export * from "./PathJoin";
@@ -34,4 +34,5 @@ export * from "./Truncate";
 export * from "./character-sets/index";
 export * from "./casing/index";
 export * from "./options/index";
+export * from "./geo/index";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/string-literals/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/string-literals/index.ts"],"names":[],"mappings":"AAMA,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAE3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/string-literals/index.ts"],"names":[],"mappings":"AAMA,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAE3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/types/string-literals/index.js

@@ -8,16 +8,16 @@ export * from "./Cardinality.js";
 export * from "./Chars.js";
 export * from "./Date.js";
 export * from "./DateTime.js";
-export * from "./DropChars.js";
 export * from "./HasUppercase.js";
 export * from "./EnsureLeading.js";
+export * from "./EnsureSurround.js";
 export * from "./EnsureLeadingEvery.js";
 export * from "./EmptyString.js";
 export * from "./EmptyStringOr.js";
 export * from "./EnsureTrailing.js";
 export * from "./FirstChar.js";
 export * from "./LastChar.js";
-export * from "./RemainingChars.js";
+export * from "./AfterFirstChar.js";
 export * from "./IsCapitalized.js";
 export * from "./Join.js";
 export * from "./PathJoin.js";
@@ -39,6 +39,7 @@ export * from "./Truncate.js";
 export * from "./character-sets/index.js";
 export * from "./casing/index.js";
 export * from "./options/index.js";
+export * from "./geo/index.js";
 // #endregion auto-indexed files
 // see https://github.com/inocan-group/do-devops/docs/autoindex.md
 // for more info

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

@@ -0,0 +1,24 @@
+import { Chars, ReplaceAll, AfterFirst, First, IsUnion, UnionToTuple } from "../../index";
+/**
+ * Handles dropping a non-union type which can be a single
+ * character OR a sequence of characters
+ */
+type DropSequence<TContent extends string, TDrop extends readonly string[]> = [] extends TDrop ? TContent : DropSequence<ReplaceAll<TContent, First<TDrop>, "">, AfterFirst<TDrop>>;
+/**
+ * **DropChars**`<TContent,TDrop>`
+ *
+ * Removes all character sequences found in `TDrop` from the string content
+ * in `TContent`. If you use a _union_ type for `TDrop` then each of the
+ * union members will be extracted (but union member must only be a single
+ * character).
+ *
+ * ```ts
+ * // "foobarbaz"
+ * DropChars<"foo, bar, baz", ", ">;
+ * // "oo, ar, az"
+ * DropChars<"foo, bar, baz", "f" | "b">;
+ * ```
+ */
+export type DropChars<TContent extends string, TDrop extends string> = IsUnion<TDrop> extends true ? UnionToTuple<TDrop> extends string[] ? DropSequence<TContent, UnionToTuple<TDrop>> : never : DropSequence<TContent, Chars<TDrop>>;
+export {};
+//# sourceMappingURL=DropChars.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DropChars.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/options/DropChars.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,UAAU,EACV,UAAU,EACV,KAAK,EACL,OAAO,EACP,YAAY,EACb,oBAAwB;AAEzB;;;GAGG;AACH,KAAK,YAAY,CACf,QAAQ,SAAS,MAAM,EACvB,KAAK,SAAS,SAAS,MAAM,EAAE,IAC7B,EAAE,SAAS,KAAK,GAClB,QAAQ,GACR,YAAY,CACV,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EACtC,UAAU,CAAC,KAAK,CAAC,CAClB,CAAC;AAGJ;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,CACnB,QAAQ,SAAS,MAAM,EACvB,KAAK,SAAS,MAAM,IAClB,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,GAC3B,YAAY,CAAC,KAAK,CAAC,SAAS,MAAM,EAAE,GAClC,YAAY,CAAC,QAAQ,EAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GAC1C,KAAK,GACP,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC"}

package/dist/types/string-literals/options/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./TypeStrength";
 export * from "./TypeRequired";
+export * from "./DropChars";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/string-literals/options/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/options/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/options/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/types/string-literals/options/index.js

@@ -1,2 +1,3 @@
 export * from "./TypeStrength.js";
 export * from "./TypeRequired.js";
+export * from "./DropChars.js";