inferred-types 0.45.0 → 0.45.2

package/dist/types/lists/Find.d.ts

@@ -1,7 +1,7 @@
-import { IsEqual, If, AfterFirst, First } from "../index";
-type FindAcc<TList extends readonly unknown[], TFind, TDeref extends string | number | null> = [] extends TList ? undefined : TDeref extends keyof First<TList> ? If<IsEqual<First<TList>[TDeref], TFind>, First<TList>, FindAcc<AfterFirst<TList>, TFind, TDeref>> : If<IsEqual<First<TList>, TFind>, First<TList>, FindAcc<AfterFirst<TList>, TFind, TDeref>>;
+import { IsEqual, If, AfterFirst, First, Or, NumberLike, Compare } from "../index";
+type FindAcc<TList extends readonly unknown[], TOp extends "extends" | "equals" | "startsWith" | "endsWith" | "lessThan" | "greaterThan", TComparator, TDeref extends string | number | null> = [] extends TList ? undefined : TDeref extends keyof First<TList> ? If<Compare<First<TList>[TDeref], TOp, TComparator>, First<TList>, FindAcc<AfterFirst<TList>, TOp, TComparator, TDeref>> : If<Compare<First<TList>, TOp, TComparator>, First<TList>, FindAcc<AfterFirst<TList>, TOp, TComparator, TDeref>>;
 /**
- * **Find**`<TList,TFind,TIndex>`
+ * **Find**`<TList,TOp,TComparator,[TDeref]>`
  *
  * Type utility used to find the first value in `TList` which _equals_ `TValue`.
  * Will return _undefined_ if no matches found.
@@ -18,20 +18,9 @@ type FindAcc<TList extends readonly unknown[], TFind, TDeref extends string | nu
  *
  * **Related**: `FindExtends`
  */
-export type Find<TList extends readonly unknown[], TFind, TDeref extends string | number | null = null> = FindAcc<TList, TFind, TDeref>;
-type FindExtendsAcc<TList extends readonly unknown[], TFind, TDeref extends string | number | null> = [] extends TList ? undefined : TDeref extends null ? First<TList> extends TFind ? First<TList> : FindExtendsAcc<AfterFirst<TList>, TFind, TDeref> : TDeref extends keyof First<TList> ? First<TList>[TDeref] extends TFind ? First<TList> : FindExtendsAcc<AfterFirst<TList>, TFind, TDeref> : FindExtendsAcc<AfterFirst<TList>, TFind, TDeref>;
-/**
- * **FindExtends**`<TList, TFind, TIndex>`
- *
- * Type utility used to find the first value in `TList` which _extends_ `TValue`.
- * Will return _undefined_ if no matches found.
- *
- * - use **Find** if you want a stricter match
- * - by default, values in `TList` will be compared directly but you can _dereference_
- * array and object properties with `TIndex` if you want to compare on a child property
- *
- * **Related:** `Find`
- */
-export type FindExtends<TList extends readonly unknown[], TFind, TDeref extends string | number | null = null> = FindExtendsAcc<TList, TFind, TDeref>;
+export type Find<TList extends readonly unknown[], TOp extends "extends" | "equals" | "startsWith" | "endsWith" | "lessThan" | "greaterThan", TComparator extends Or<[
+    IsEqual<TOp, "startsWith">,
+    IsEqual<TOp, "endsWith">
+]> extends true ? string : Or<[IsEqual<TOp, "lessThan">, IsEqual<TOp, "greaterThan">]> extends true ? NumberLike : unknown, TDeref extends string | number | null = null> = FindAcc<TList, TOp, TComparator, TDeref>;
 export {};
 //# sourceMappingURL=Find.d.ts.map

package/dist/types/lists/Find.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Find.d.ts","sourceRoot":"","sources":["../../../src/types/lists/Find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAwB;AAEjE,KAAK,OAAO,CACV,KAAK,SAAS,SAAS,OAAO,EAAE,EAChC,KAAK,EACL,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,IAAI,IACnC,EAAE,SAAS,KAAK,GAChB,SAAS,GACT,MAAM,SAAS,MAAM,KAAK,CAAC,KAAK,CAAC,GAC/B,EAAE,CACA,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,EACpC,KAAK,CAAC,KAAK,CAAC,EACZ,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAC1C,GACD,EAAE,CACA,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,EAC5B,KAAK,CAAC,KAAK,CAAC,EACZ,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAC1C,CAAC;AAER;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,IAAI,CACd,KAAK,SAAS,SAAS,OAAO,EAAE,EAChC,KAAK,EACL,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,IAC1C,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAElC,KAAK,cAAc,CACjB,KAAK,SAAS,SAAS,OAAO,EAAE,EAChC,KAAK,EACL,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,IAAI,IACnC,EAAE,SAAS,KAAK,GAChB,SAAS,GACT,MAAM,SAAS,IAAI,GACjB,KAAK,CAAC,KAAK,CAAC,SAAS,KAAK,GACxB,KAAK,CAAC,KAAK,CAAC,GACZ,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAClD,MAAM,SAAS,MAAM,KAAK,CAAC,KAAK,CAAC,GAC/B,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,GAC9B,KAAK,CAAC,KAAK,CAAC,GACZ,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GACpD,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CACnD;AAEL;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,CACrB,KAAK,SAAS,SAAS,OAAO,EAAE,EAChC,KAAK,EACL,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,IAC1C,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC"}
+{"version":3,"file":"Find.d.ts","sourceRoot":"","sources":["../../../src/types/lists/Find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,iBAAwB;AAE1F,KAAK,OAAO,CACV,KAAK,SAAS,SAAS,OAAO,EAAE,EAChC,GAAG,SAAS,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,EACzF,WAAW,EACX,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,IAAI,IACnC,EAAE,SAAS,KAAK,GAChB,SAAS,GACT,MAAM,SAAS,MAAM,KAAK,CAAC,KAAK,CAAC,GAC/B,EAAE,CACA,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,EAC/C,KAAK,CAAC,KAAK,CAAC,EACZ,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,GAAG,EAAC,WAAW,EAAE,MAAM,CAAC,CACpD,GACD,EAAE,CACA,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,EACvC,KAAK,CAAC,KAAK,CAAC,EACZ,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,GAAG,EAAC,WAAW,EAAE,MAAM,CAAC,CACpD,CAAC;AAER;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,IAAI,CACd,KAAK,SAAS,SAAS,OAAO,EAAE,EAChC,GAAG,SAAS,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,EACzF,WAAW,SAAS,EAAE,CAAC;IACrB,OAAO,CAAC,GAAG,EAAC,YAAY,CAAC;IAAE,OAAO,CAAC,GAAG,EAAC,UAAU,CAAC;CACnD,CAAC,SAAS,IAAI,GACb,MAAM,GACN,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAC,UAAU,CAAC,EAAE,OAAO,CAAC,GAAG,EAAC,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,GACtE,UAAU,GACV,OAAO,EACT,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,IAC1C,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC"}

package/dist/types/literals/DoneFnTuple.d.ts

@@ -1,4 +1,4 @@
-import { IsTrue, If, Fn, FnDefn, TupleToUnion, Narrow } from "../index";
+import { IsTrue, If, FnWithDescription, FnDefn, TupleToUnion, Narrow } from "../index";
 /**
  * **DoneFnTuple**`<[TTuple],[TMakeUnion],[TFns]>`
  *
@@ -16,11 +16,11 @@ export type DoneFnTuple<TFns extends {
         "add a value to the tuple/union"
     ];
 }, TMakeUnion extends boolean = false, TState extends readonly Narrow[] = Narrow[]> = {
-    [K in keyof TFns]: Fn<TFns[K]>;
+    [K in keyof TFns]: FnWithDescription<TFns[K]>;
 } & {
     state: TState;
     type_as_union: TMakeUnion;
-    done: Fn<[
+    done: FnWithDescription<[
         () => If<IsTrue<TMakeUnion>, TupleToUnion<TState>, TState>,
         "exits the API surface with the state which has been accumulated so far"
     ]>;

package/dist/types/literals/DoneFnTuple.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DoneFnTuple.d.ts","sourceRoot":"","sources":["../../../src/types/literals/DoneFnTuple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAC,iBAAwB;AAG9E;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,CACvB,IAAI,SAAS;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAC,GAAG;IACrC,GAAG,EAAE;QACH,CAAC,IAAI,SAAS,MAAM,EAAE,CAAC,EAAE,IAAI,KAAK,OAAO;QACzC,gCAAgC;KACjC,CAAC;CACH,EACD,UAAU,SAAS,OAAO,GAAG,KAAK,EAClC,MAAM,SAAS,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,IACvC;KACD,CAAC,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CAC/B,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,UAAU,CAAC;IAC1B,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAC1D,wEAAwE;KACzE,CAAC,CAAC;CACJ,CAAA"}
+{"version":3,"file":"DoneFnTuple.d.ts","sourceRoot":"","sources":["../../../src/types/literals/DoneFnTuple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAC,iBAAwB;AAG7F;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,CACvB,IAAI,SAAS;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAC,GAAG;IACrC,GAAG,EAAE;QACH,CAAC,IAAI,SAAS,MAAM,EAAE,CAAC,EAAE,IAAI,KAAK,OAAO;QACzC,gCAAgC;KACjC,CAAC;CACH,EACD,UAAU,SAAS,OAAO,GAAG,KAAK,EAClC,MAAM,SAAS,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,IACvC;KACD,CAAC,IAAI,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CAC9C,GAAG;IACF,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,UAAU,CAAC;IAC1B,IAAI,EAAE,iBAAiB,CAAC;QACtB,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAC1D,wEAAwE;KACzE,CAAC,CAAC;CACJ,CAAA"}

package/dist/types/literals/Unset.d.ts

@@ -0,0 +1,13 @@
+/**
+ * **Unset**
+ *
+ * The **Unset** type allows you to specify a _parameter_ which
+ * has **not** been set yet but then allows a user to choose any
+ * value they like.
+ *
+ * **Related:** `unset()`
+ */
+export type Unset = {
+    kind: "Unset";
+};
+//# sourceMappingURL=Unset.d.ts.map

package/dist/types/literals/Unset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Unset.d.ts","sourceRoot":"","sources":["../../../src/types/literals/Unset.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC"}

package/dist/types/literals/Unset.js

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

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

@@ -16,4 +16,5 @@ export * from "./DoneFnTuple";
 export * from "./Choices";
 export * from "./FromDefn";
 export * from "./FromTokenNames";
+export * from "./Unset";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/literals/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/literals/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/dist/types/literals/index.js

@@ -16,3 +16,4 @@ export * from "./DoneFnTuple.js";
 export * from "./Choices.js";
 export * from "./FromDefn.js";
 export * from "./FromTokenNames.js";
+export * from "./Unset.js";

package/dist/types/numeric-literals/NumberLike.d.ts

@@ -4,5 +4,5 @@
  * A type which represents a number whether it be a _number_ or
  * a string literal shaped as a number (aka, `${string}`).
  */
-export type NumberLike<T extends number | `${number}` = number | `${number}`> = T;
+export type NumberLike = number | `${number}`;
 //# sourceMappingURL=NumberLike.d.ts.map

package/dist/types/numeric-literals/NumberLike.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NumberLike.d.ts","sourceRoot":"","sources":["../../../src/types/numeric-literals/NumberLike.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CACpB,CAAC,SAAS,MAAM,GAAG,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,GAAG,MAAM,EAAE,IACnD,CAAC,CAAC"}
+{"version":3,"file":"NumberLike.d.ts","sourceRoot":"","sources":["../../../src/types/numeric-literals/NumberLike.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC"}

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

@@ -0,0 +1,7 @@
+import { PROXMOX_CT_STATE } from "../../constants/index";
+import { TupleToUnion } from "../index";
+/**
+ * the _states_ a Proxmox LXC container can be in
+ */
+export type ProxmoxCtState = TupleToUnion<typeof PROXMOX_CT_STATE>;
+//# sourceMappingURL=Proxmox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Proxmox.d.ts","sourceRoot":"","sources":["../../../src/types/string-literals/Proxmox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,8BAA4B;AACvD,OAAO,EAAE,YAAY,EAAE,iBAAwB;AAE/C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

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

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

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

@@ -1,4 +1,4 @@
-import { And, AsNumber, AsString, IsNumber, IsStringLiteral } from "../index";
+import { And, AsNumber, AsString, IsStringLiteral } from "../index";
 type Process<TContent extends string, TStrip extends string> = And<[IsStringLiteral<TContent>, IsStringLiteral<TStrip>]> extends true ? TContent extends `${TStrip & string}${infer After}` ? After : TContent : string;
 /**
  * **StripLeading**`<T, U>`
@@ -16,6 +16,6 @@ type Process<TContent extends string, TStrip extends string> = And<[IsStringLite
  *   - if `T` is a non-string type then no transformation will be done
  *   - same applies to `U`
  */
-export type StripLeading<TContent extends string | number, TStrip extends string | number> = IsNumber<TContent> extends true ? AsNumber<Process<AsString<TContent>, AsString<TStrip>>> : Process<AsString<TContent>, AsString<TStrip>>;
+export type StripLeading<TContent extends string | number, TStrip extends string | number> = TContent extends number ? AsNumber<Process<AsString<TContent>, AsString<TStrip>>> : TContent extends string ? Process<AsString<TContent>, AsString<TStrip>> : never;
 export {};
 //# sourceMappingURL=StripLeading.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StripLeading.d.ts","sourceRoot":"","sources":["../../../src/types/string-literals/StripLeading.ts"],"names":[],"mappings":"AAAA,OAAO,EAAI,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,iBAAwB;AAEvF,KAAK,OAAO,CACV,QAAQ,SAAS,MAAM,EACvB,MAAM,SAAS,MAAM,IACnB,GAAG,CAAC,CAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,GACvE,QAAQ,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,KAAK,EAAE,GACjD,KAAK,GACL,QAAQ,GACV,MAAM,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,CACtB,QAAQ,SAAS,MAAM,GAAC,MAAM,EAC9B,MAAM,SAAS,MAAM,GAAC,MAAM,IAC1B,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,GACjC,QAAQ,CACN,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC,EAClB,QAAQ,CAAC,MAAM,CAAC,CACjB,CACF,GACD,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC,EAClB,QAAQ,CAAC,MAAM,CAAC,CACjB,CAAA"}
+{"version":3,"file":"StripLeading.d.ts","sourceRoot":"","sources":["../../../src/types/string-literals/StripLeading.ts"],"names":[],"mappings":"AAAA,OAAO,EAAI,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,iBAAwB;AAE7E,KAAK,OAAO,CACV,QAAQ,SAAS,MAAM,EACvB,MAAM,SAAS,MAAM,IACnB,GAAG,CAAC,CAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,GACvE,QAAQ,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,KAAK,EAAE,GACjD,KAAK,GACL,QAAQ,GACV,MAAM,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,YAAY,CACtB,QAAQ,SAAS,MAAM,GAAC,MAAM,EAC9B,MAAM,SAAS,MAAM,GAAC,MAAM,IAC1B,QAAQ,SAAS,MAAM,GACzB,QAAQ,CACN,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC,EAClB,QAAQ,CAAC,MAAM,CAAC,CACjB,CACF,GACD,QAAQ,SAAS,MAAM,GACrB,OAAO,CACP,QAAQ,CAAC,QAAQ,CAAC,EAClB,QAAQ,CAAC,MAAM,CAAC,CACjB,GACC,KAAK,CAAA"}

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

@@ -1,6 +1,18 @@
 import { AfterFirst, First, Shift, Chars } from "../index";
 type Process<TChars extends readonly string[], TOp extends "is" | "not", TComparator extends string, TResult extends string> = [] extends TChars ? TResult : First<TChars> extends TComparator ? TOp extends "is" ? Process<AfterFirst<TChars>, TOp, TComparator, Shift<TResult>> : TResult : TOp extends "is" ? TResult : Process<AfterFirst<TChars>, TOp, TComparator, Shift<TResult>>;
+/**
+ * **StripUntil**`<TContent,TComparator>`
+ *
+ * Strip characters from the start of `TContent` _until_ a
+ * character extends `TComparator`.
+ */
 export type StripUntil<TContent extends string, TComparator extends string> = Process<Chars<TContent>, "not", TComparator, TContent>;
+/**
+ * **StripWhile**`<TContent,TComparator>`
+ *
+ * Strip characters from the start of `TContent` _while_ those
+ * characters extend `TComparator`.
+ */
 export type StripWhile<TContent extends string, TComparator extends string> = Process<Chars<TContent>, "is", TComparator, TContent>;
 export {};
 //# sourceMappingURL=StripUntil.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"StripUntil.d.ts","sourceRoot":"","sources":["../../../src/types/string-literals/StripUntil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAC,KAAK,EAAE,iBAAwB;AAGjE,KAAK,OAAO,CACV,MAAM,SAAS,SAAS,MAAM,EAAE,EAChC,GAAG,SAAS,IAAI,GAAG,KAAK,EACxB,WAAW,SAAS,MAAM,EAC1B,OAAO,SAAS,MAAM,IACpB,EAAE,SAAS,MAAM,GACnB,OAAO,GACP,KAAK,CAAC,MAAM,CAAC,SAAS,WAAW,GAC/B,GAAG,SAAS,IAAI,GACd,OAAO,CACL,UAAU,CAAC,MAAM,CAAC,EAClB,GAAG,EACH,WAAW,EACX,KAAK,CAAC,OAAO,CAAC,CACf,GACD,OAAO,GACT,GAAG,SAAS,IAAI,GACd,OAAO,GACP,OAAO,CACL,UAAU,CAAC,MAAM,CAAC,EAClB,GAAG,EACH,WAAW,EACX,KAAK,CAAC,OAAO,CAAC,CACf,CAAC;AAIR,MAAM,MAAM,UAAU,CACpB,QAAQ,SAAS,MAAM,EACvB,WAAW,SAAS,MAAM,IACxB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAC,KAAK,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAKzD,MAAM,MAAM,UAAU,CACpB,QAAQ,SAAS,MAAM,EACvB,WAAW,SAAS,MAAM,IACxB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAC,IAAI,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"StripUntil.d.ts","sourceRoot":"","sources":["../../../src/types/string-literals/StripUntil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAC,KAAK,EAAE,iBAAwB;AAGjE,KAAK,OAAO,CACV,MAAM,SAAS,SAAS,MAAM,EAAE,EAChC,GAAG,SAAS,IAAI,GAAG,KAAK,EACxB,WAAW,SAAS,MAAM,EAC1B,OAAO,SAAS,MAAM,IACpB,EAAE,SAAS,MAAM,GACnB,OAAO,GACP,KAAK,CAAC,MAAM,CAAC,SAAS,WAAW,GAC/B,GAAG,SAAS,IAAI,GACd,OAAO,CACL,UAAU,CAAC,MAAM,CAAC,EAClB,GAAG,EACH,WAAW,EACX,KAAK,CAAC,OAAO,CAAC,CACf,GACD,OAAO,GACT,GAAG,SAAS,IAAI,GACd,OAAO,GACP,OAAO,CACL,UAAU,CAAC,MAAM,CAAC,EAClB,GAAG,EACH,WAAW,EACX,KAAK,CAAC,OAAO,CAAC,CACf,CAAC;AAGR;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CACpB,QAAQ,SAAS,MAAM,EACvB,WAAW,SAAS,MAAM,IACxB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAC,KAAK,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AAIzD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CACpB,QAAQ,SAAS,MAAM,EACvB,WAAW,SAAS,MAAM,IACxB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAC,IAAI,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC"}

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

@@ -1,7 +1,9 @@
+import { WHITESPACE_CHARS } from "../../../constants/index";
+import { Mutable, TupleToUnion } from "../../index";
 /**
  * **Whitespace**
  *
  * Characters typically representing "white space"
  */
-export type Whitespace = " " | "\n" | "\t";
+export type Whitespace = TupleToUnion<Mutable<typeof WHITESPACE_CHARS>>;
 //# sourceMappingURL=Whitespace.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Whitespace.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/Whitespace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC"}
+{"version":3,"file":"Whitespace.d.ts","sourceRoot":"","sources":["../../../../src/types/string-literals/character-sets/Whitespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iCAA4B;AACvD,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,oBAAwB;AAExD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC"}

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

@@ -27,6 +27,7 @@ export * from "./Repos";
 export * from "./Variable";
 export * from "./Optional";
 export * from "./YouTube";
+export * from "./phone";
 export * from "./brackets/index";
 export * from "./quotation-marks/index";
 //# sourceMappingURL=index.d.ts.map

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,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;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAE1B,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;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AAExB,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

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

@@ -27,5 +27,6 @@ export * from "./Repos.js";
 export * from "./Variable.js";
 export * from "./Optional.js";
 export * from "./YouTube.js";
+export * from "./phone.js";
 export * from "./brackets/index.js";
 export * from "./quotation-marks/index.js";

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

@@ -0,0 +1,192 @@
+import { PHONE_COUNTRY_CODES, PHONE_FORMAT } from "../../../constants/index";
+import { AsString, FirstOfEach, IsLessThan, IsStringLiteral, Length, NumericChar, RetainChars, StartsWith, StripChars, Trim, TupleToUnion, Whitespace, Mutable, HasPhoneCountryCode, Optional, RetainUntil, Not, And, Throw, IsGreaterThan, HasCharacters, Extends, Or, OnPass, ErrorCondition, Unset, If, IsLength, Contains } from "../../index";
+/**
+ * delimiter characters commonly used to separate digits in phone numbers
+ */
+export type PhoneNumberDelimiter = " " | "-" | ".";
+/**
+ * **PhoneFormat**
+ *
+ * A union type of _formats_ used for telephone numbers
+ */
+export type PhoneFormat = TupleToUnion<typeof PHONE_FORMAT>;
+/**
+ * **PhoneCountryCode**
+ *
+ * The official list of _phone_ country codes
+ *
+ * **Related:** `DialCountryCode`
+ */
+export type PhoneCountryCode = FirstOfEach<Mutable<typeof PHONE_COUNTRY_CODES>>;
+/**
+ * **DialCountryCode**
+ *
+ * A simplified representation of `PhoneCountryCode` so as to not make other
+ * phone patterns too complex.
+ */
+export type DialCountryCode = `${"+" | "00"}${`1-${number}` | `${Exclude<NumericChar, "0">}`}${Optional<`${number}`>}`;
+/**
+ * **LocalPhoneNumber**`<[TDelimiter]>`
+ *
+ * Provides a shape for phone numbers local a region of country that do
+ * not have a _country code_ designation nor what is referred to as the
+ * "area code" in the USA.
+ *
+ * **Related:** `CountryPhoneNumber`, `InternationalPhoneNumber`, `PhoneNumber`
+ */
+export type LocalPhoneNumber<TDelimiter extends PhoneNumberDelimiter = PhoneNumberDelimiter> = `${NumericChar}${number}${TDelimiter}${number}`;
+/**
+ * **PhoneAreaCode**
+ */
+export type PhoneAreaCode = `(${number})` | `${NumericChar}${number}`;
+/**
+ * **PhoneShortCode**`<[T]>`
+ *
+ * A [phone short code](https://en.wikipedia.org/wiki/Short_code) is a short numeric
+ * phone number typically used for SMS/MMS purposes but can be call based too.
+ *
+ * There are regional variances but typically are always _less_ digits than a regional
+ * phone number of 7 digits.
+ *
+ * This utility -- when used without a generic `T` -- will just give a basic shape
+ * for the short code but not really validate it.
+ *
+ * If you want validation, pass it the value you're testing in as `T`. If `T` is a
+ * valid short code then it will be proxied through "as is" but if it is not, it
+ * will be converted to an `ErrorCondition<"invalid-short-code">`
+ */
+export type PhoneShortCode<T extends string | null = null> = T extends null ? `${NumericChar}${number}${NumericChar}` : T extends string ? IsStringLiteral<T> extends true ? T extends `${number}` ? IsGreaterThan<Length<T>, 6> extends true ? Throw<"invalid-short-code", `Short codes must be less than 7 digits [${Length<T>}]`> : T : Throw<"invalid-short-code", `Short codes may vary from region to region but they must always contain only numbers: ${T}!`> : string : never;
+/**
+ * **CountryPhoneNumber**`<[TDelimiter]>`
+ *
+ * Provides a shape phone number meant for use within a country. It includes
+ * the local number plus what would be referred to as the "area code" in the
+ * USA.
+ *
+ * **Related:** `InternationalPhoneNumber`, `LocalPhoneNumber`, `PhoneNumber`
+ */
+export type CountryPhoneNumber<TDelimiter extends PhoneNumberDelimiter = PhoneNumberDelimiter> = `${PhoneAreaCode}${TDelimiter}${LocalPhoneNumber<TDelimiter>}`;
+/**
+ * **InternationalPhoneNumber**`<[TDelimiter]>`
+ *
+ * A phone number which explicitly leads by expressing the _country_ that the number belongs to.
+ *
+ * - uses `+` or `00` prefix to mark as a country code
+ *
+ * **Related:** `CountryPhoneNumber`, `LocalPhoneNumber`, `PhoneNumber`
+ */
+export type InternationalPhoneNumber<TDelimiter extends PhoneNumberDelimiter = PhoneNumberDelimiter> = `${DialCountryCode}${TDelimiter}${CountryPhoneNumber<TDelimiter>}`;
+type _RightLength<T extends string> = If<StartsWith<T, "+">, If<Contains<T, "1-">, // using 1- for country code nomenclature
+If<IsLength<T, 16>, T, ErrorCondition<"invalid-raw-phone-number", `Wrong number of characters for international number: ${T}`>>, If<IsLength<T, 15>, T, ErrorCondition<"invalid-raw-phone-number", `Wrong number of characters for international number: ${T}`>>>, If<StartsWith<T, "00">, If<Contains<T, "1-">, // using 1- for country code nomenclature
+If<IsLength<T, 15>, T, ErrorCondition<"invalid-raw-phone-number", `Wrong number of characters for international number: ${T}`>>, If<IsLength<T, 14>, T, ErrorCondition<"invalid-raw-phone-number", `Wrong number of characters for international number: ${T}`>>>, If<Or<[IsLength<T, 10>, IsLength<T, 12>]>, T, If<And<[IsGreaterThan<Length<T>, 2>, IsLessThan<Length<T>, 8>]>, T, ErrorCondition<"invalid-raw-phone-number">>>>>;
+type _RightChars<T extends string> = StripChars<T, NumericChar | "+" | "-"> extends "" ? T : ErrorCondition<"invalid-raw-phone-number", `The only valid characters in a raw phone number is numeric characters with the rare exception of a "+" or "-" when used in the right manner`>;
+/**
+ * **RawPhoneNumber**`<[T]>`
+ *
+ * This is the most compact form of phone number storage as it has no delimiters
+ * but still can contain a number representing an international,
+ * country or regional phone number and even a `PhoneShortCode`.
+ *
+ * **Generic Use**
+ *
+ * - without using the generic, you'll get a very basic shape that can be used as in input
+ * type but it will by no means ensure this _is_ a RawPhone number
+ * - to get real validation that a type is a `RawPhoneNumber` pass it in as `T`
+ * - valid values are:
+ *    - numeric only characters with the exception of:
+ *      - possible start of `+`
+ *      - possible inclusion of `1-${number}` in country code area
+ *    - length of 3-7, 10, 12 digits
+ *    - 14 digits if it leads with `00` or `+`
+ */
+export type RawPhoneNumber<T extends string | Unset = Unset> = T extends Unset ? `${Optional<"+">}${number}${NumericChar}${NumericChar}` : T extends string ? IsStringLiteral<T> extends true ? OnPass<[
+    _RightChars<T>,
+    _RightLength<T>
+], T> : T | ErrorCondition<"invalid-raw-phone-number"> : never;
+/** T or ErrorCondition */
+type _AppropriateNumerics<T extends string> = HasPhoneCountryCode<T> extends true ? IsLessThan<Length<RetainChars<RemovePhoneCountryCode<T>, NumericChar>>, 10> extends true ? Throw<"invalid-phone-number", `Invalid international phone number; international numbers require at least 10 numeric digits beyond the country code: ${T}`, `PhoneNumber`> : T : HasCharacters<Trim<T>, PhoneNumberDelimiter> extends true ? Not<Or<[
+    Extends<Length<RetainChars<RemovePhoneCountryCode<T>, NumericChar>>, 10>,
+    Extends<Length<RetainChars<RemovePhoneCountryCode<T>, NumericChar>>, 7>
+]>> extends true ? Throw<"invalid-phone-number", `Phone numbers which have " ", "-", or "." delimiters can not be short codes and therefore must have a length of 7 or 10 digits not ${Length<RetainChars<RemovePhoneCountryCode<T>, NumericChar>>}!`> : T : Trim<T> extends "" ? Throw<"invalid-phone-number", "No numeric characters found!"> : T;
+/** T or ErrorCondition */
+type _ValidChars<T extends string> = StripChars<T, IsGreaterThan<Length<T>, 6> extends true ? NumericChar | "(" | ")" | Whitespace | "-" | "." : NumericChar> extends "" ? true : Throw<"invalid-phone-number", IsGreaterThan<Length<T>, 6> extends true ? `Excluding any country code references, the only valid characters in a phone number are numeric characters and '-', '.', and parenthesis but other characters were found: ${Trim<T>}` : `The phone number passed in has less than 7 numeric digits which means that it is either a short code or this is an invalid number ... short codes can only accept numeric digits though and we found more than that: ${Trim<T>}`>;
+type _InvalidCountryCode<T extends string> = And<[
+    HasPhoneCountryCode<T, false>,
+    Not<HasPhoneCountryCode<T, true>>
+]> extends true ? Throw<"invalid-phone-number", `This looked like an international number but the country code ${GetPhoneCountryCode<T>} is not a valid country code!`> : true;
+/**
+ * **PhoneNumber**`<[T]>`
+ *
+ * Without use of the generic `T`, provides a basic shape for phone
+ * numbers which should keep people on good behavior when
+ * accepting phone numbers.
+ *
+ * When passing a string into `T`, this utility will do a lot more
+ * validity checking on the value.
+ *
+ * - Only valid characters (numeric, whitespace, `+`, `-`, `.`, and parenthesis)
+ * - all _leading_ and _trailing_ whitespace removed for remaining comparisons
+ * - at least 7 numeric characters
+ *    - 8 if `+` character used as leading character (after whitespace)
+ *    - 10 if `00` are leading characters
+ * - leading character (after whitespace) must be numeric, `(` or `+`
+ */
+export type PhoneNumber<T extends string | null = null, TDelimiter extends PhoneNumberDelimiter = PhoneNumberDelimiter> = T extends null ? LocalPhoneNumber<TDelimiter> | CountryPhoneNumber<TDelimiter> | InternationalPhoneNumber<TDelimiter> : T extends string ? IsStringLiteral<T> extends true ? OnPass<[
+    _ValidChars<RemovePhoneCountryCode<T>>,
+    _InvalidCountryCode<T>,
+    _AppropriateNumerics<T>
+], T> : string : never;
+/**
+ * GetPhoneCountryCode`<T>`
+ *
+ * Attempts to find a country code signature in a phone number.
+ *
+ * - it returns the country code without the leading `+` or `00` prefix
+ * - if there is no delimiter or prefix for the country code then, then it
+ * will use a _real_ list of country codes to try to extract this value
+ * - if not found it returns an empty string (`""`)
+ * - if `T` is a _wide_ string string then this will return `string` back
+ */
+export type GetPhoneCountryCode<T> = T extends string ? [IsStringLiteral<T>] extends [true] ? StartsWith<Trim<T>, "+" | "00"> extends true ? [Trim<T>] extends [`${"+" | "00"}${infer CC}${PhoneNumberDelimiter}${string}`] ? RetainUntil<CC, " "> : "" : "" : string : never;
+/**
+ * **RemoveCountryCode**`<T,[TExplicitCountryCode]>`
+ *
+ * Removes the country code -- where present -- to reveal
+ * just a country-based number.
+ *
+ * **Note:** there are two approaches this utility can take toward
+ * removal of the country code:
+ *
+ * - the default relies on a space delimiter being present between
+ * the country code and the remaining phone number; use this if
+ * this is a reasonable assumption as it is more type performant.
+ * - if you might have a string of numbers -- even possibly without
+ * the `+` or `00` prefixes -- then you can set `TExplicitCountryCode`
+ * to `true`
+ *   - when set to true, it will still be able to extract _real_ country codes
+ * from the string but if an _imagined_ country code has been entered it will
+ * fail.
+ *   - if it is an _imagined_ country code which does have a `+` or `00` prefix
+ * then the type will be `ErrorCondition<"invalid-country-code">`
+ *   - if no country code prefix then you'll likely get a
+ * `ErrorCondition<"too-many-digits">` error (unless of course your have _other_
+ * problems).
+ */
+export type RemovePhoneCountryCode<T> = T extends string ? IsStringLiteral<T> extends true ? GetPhoneCountryCode<Trim<T>> extends "" ? T : Trim<T> extends `+${GetPhoneCountryCode<Trim<T>>} ${infer Rest}` ? Rest : T : string : never;
+export type PhoneNumberType = "international" | "country" | "regional" | "short-code";
+/**
+ * **GetPhoneNumberType**`<T>`
+ *
+ * Indicates whether the phone number is "international", "country", or "regional"
+ * based on the shape and number of digits
+ */
+export type GetPhoneNumberType<T> = T extends string ? IsStringLiteral<T> extends true ? HasPhoneCountryCode<T, false> extends true ? "international" : IsLessThan<Length<RetainChars<Trim<AsString<T>>, NumericChar>>, 8> extends true ? Length<RetainChars<Trim<AsString<T>>, NumericChar>> extends 7 ? "regional" : "short-code" : "country" : string : never;
+type FormatLookup<T extends string> = {
+    "Dashed (e.g., 456-555-1212)": HasPhoneCountryCode<T> extends true ? `+${GetPhoneCountryCode<T>} ${number}-${number}-${number}` : GetPhoneNumberType<T> extends "regional" ? `${number}-${number}` : `${number}-${number}-${number}`;
+    "Dotted (e.g., 456.555.1212)": HasPhoneCountryCode<T> extends true ? `+${GetPhoneCountryCode<T>} ${number}.${number}.${number}` : GetPhoneNumberType<T> extends "regional" ? `${number}.${number}` : `${number}.${number}-${number}`;
+    "ParaSpaced (e.g., (456) 555 1212)": "";
+    "ParaDashed (e.g., (456) 555-1212)": "";
+} & Record<PhoneFormat, any>;
+export type ToPhoneFormat<TPhone extends string, TFormat extends PhoneFormat> = IsStringLiteral<TPhone> extends true ? PhoneNumber<TPhone> extends string ? Trim<TPhone> & FormatLookup<TPhone>[TFormat] : PhoneNumber<TPhone> : FormatLookup<TPhone>[TFormat] | ErrorCondition<"invalid-phone-number">;
+export {};
+//# sourceMappingURL=phone.d.ts.map

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

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

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

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