inferred-types 0.44.0 → 0.45.0

package/dist/runtime/dictionary/withKeys.d.ts

@@ -7,7 +7,7 @@ import type { Dictionary, Narrowable, ObjectKey } from "../../types/index";
  *
  * - note: this function is an alias for `retain()`
  */
-export declare const withKeys: <TObj extends Dictionary<string | symbol, N>, N extends Narrowable, TKeys extends readonly (ObjectKey & keyof TObj)[]>(dict: TObj, ...keys: TKeys) => ([] extends [...TKeys] ? false : (import("../../types/index").IsEqual<import("../../types/index").First<[...TKeys], never>, boolean, true, false> extends true ? false : import("../../types/index").UnionToTuple<import("../../types/index").First<[...TKeys], never>, import("../../types/index").LastInUnion<import("../../types/index").First<[...TKeys], never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<[...TKeys]> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<[...TKeys]>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<[...TKeys]>, never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>, never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>, never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>, never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>, never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>, never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>, never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>, never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>>, never>>>["length"] extends 1 ? false : true) extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>>> ? false : (import("../../types/index").UnionToTuple<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>>>, never>, import("../../types/index").LastInUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>>>, never>>>["length"] extends 1 ? false : true) extends true ? true : any) extends true ? {
+export declare const withKeys: <TObj extends Dictionary<string | symbol, N>, N extends Narrowable, TKeys extends readonly (ObjectKey & keyof TObj)[]>(dict: TObj, ...keys: TKeys) => ([] extends [...TKeys] ? false : import("../../types/index").IsUnion<import("../../types/index").First<[...TKeys], never>> extends true ? true : [] extends import("../../types/index").AfterFirst<[...TKeys]> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<[...TKeys]>, never>> extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>, never>> extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>, never>> extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>, never>> extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>, never>> extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>, never>> extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>, never>> extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>, never>> extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>>, never>> extends true ? true : [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>>> ? false : import("../../types/index").IsUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>>>>>>, never>> extends true ? true : any) extends true ? {
     kind: "invalid-union";
     msg: "the retain(obj, keys) function was called with keys which included a value which was a union type; this would make the typing inconsistent with the runtime type and should be avoided. Note that at runtime this will not produce an error but rather produce the valid runtime value.";
     utility: "retain()";

package/dist/runtime/index.d.ts

@@ -7,6 +7,7 @@ export * from "./functions/index";
 export * from "./initializers/index";
 export * from "./lists/index";
 export * from "./literals/index";
+export * from "./meta/index";
 export * from "./runtime-types/index";
 export * from "./sets/index";
 export * from "./type-conversion/index";

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AASA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AASA,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAA"}

package/dist/runtime/index.js

@@ -13,6 +13,7 @@ export * from "./functions/index.js";
 export * from "./initializers/index.js";
 export * from "./lists/index.js";
 export * from "./literals/index.js";
+export * from "./meta/index.js";
 export * from "./runtime-types/index.js";
 export * from "./sets/index.js";
 export * from "./type-conversion/index.js";

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

@@ -31,4 +31,5 @@ export * from "./toPascalCase";
 export * from "./toUppercase";
 export * from "./toNumericArray";
 export * from "./truncate";
+export * from "./takeNumericCharacters";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/runtime/literals/index.js

@@ -36,6 +36,7 @@ export * from "./toPascalCase.js";
 export * from "./toUppercase.js";
 export * from "./toNumericArray.js";
 export * from "./truncate.js";
+export * from "./takeNumericCharacters.js";
 // #endregion auto-indexed files
 // see https://github.com/inocan-group/do-devops/docs/autoindex.md
 // for more info

package/dist/runtime/literals/takeNumericCharacters.d.ts

@@ -0,0 +1,9 @@
+import { RetainWhile } from "../../types/string-literals";
+/**
+ * **takeNumericCharacters**`(content)`
+ *
+ * Starts at the passed in content and extracts all numeric characters
+ * in the string until a non-numeric value arrives.
+ */
+export declare const takeNumericCharacters: <T extends string>(content: T) => RetainWhile<T, "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9">;
+//# sourceMappingURL=takeNumericCharacters.d.ts.map

package/dist/runtime/literals/takeNumericCharacters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"takeNumericCharacters.d.ts","sourceRoot":"","sources":["../../../src/runtime/literals/takeNumericCharacters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,WAAW,EAAE,oCAAkC;AAGrE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,8BAA+B,CAAC,8EAIjE,CAAA"}

package/dist/runtime/literals/takeNumericCharacters.js

@@ -0,0 +1,12 @@
+import { NUMERIC_CHAR } from "../../constants/NumericChar.js";
+import { asChars } from "../index.js";
+/**
+ * **takeNumericCharacters**`(content)`
+ *
+ * Starts at the passed in content and extracts all numeric characters
+ * in the string until a non-numeric value arrives.
+ */
+export const takeNumericCharacters = (content) => {
+    let nonNumericIdx = asChars(content).findIndex(i => !NUMERIC_CHAR.includes(i));
+    return content.slice(0, nonNumericIdx);
+};

package/dist/runtime/meta/index.d.ts

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

package/dist/runtime/meta/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/meta/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA"}

package/dist/runtime/meta/index.js

@@ -0,0 +1,2 @@
+export * from "./youtube-meta.js";
+export * from "./urlMeta.js";

package/dist/runtime/meta/urlMeta.d.ts

@@ -0,0 +1,52 @@
+import { IsUrl, GetUrlProtocol, GetUrlSource, GetUrlPath, GetUrlQueryParams, GetUrlPort, IsIpAddress, IsIp4Address, IsIp6Address } from "../../types/index";
+export type UrlMeta<T> = {
+    /** the URL passed in */
+    url: T;
+    /** boolean flag indicating whether the value passed in is considered a valid URL */
+    isUrl: IsUrl<T>;
+    /** the `NetworkProtocol` used in the URL */
+    protocol: GetUrlProtocol<T>;
+    path: T extends string ? GetUrlPath<T> : never;
+    queryParams: T extends string ? GetUrlQueryParams<T> : never;
+    /** the port number -- when stated explicitly -- or "default" */
+    port: GetUrlPort<T>;
+    /** either the domain name or the IP address */
+    source: T extends string ? GetUrlSource<T> : never;
+    /**
+     * Boolean flag which indicates that the _source_ is an IP address (vs. Domain Name)
+     */
+    isIpAddress: IsIpAddress<T>;
+    /**
+     * Boolean flag indicating the _source_ is a IPv4 IP address
+     */
+    isIpV4Address: IsIp4Address<T>;
+    /**
+     * Boolean flag indicating the _source_ is a IPv6 IP address
+     */
+    isIpV6Address: IsIp6Address<T>;
+};
+export declare const getUrlProtocol: <T extends string>(url: T) => GetUrlProtocol<T>;
+export declare const removeUrlProtocol: <T extends string>(url: T) => import("../../types/index").StripBefore<T, "://">;
+export declare const getUrlPath: <T extends string>(url: T) => GetUrlPath<T>;
+export declare const getUrlQueryParams: <T extends string>(url: T) => GetUrlQueryParams<T>;
+export declare const getUrlPort: <T extends string>(url: T) => number | "default";
+export declare const getUrlSource: <T extends string>(url: T) => GetUrlSource<T>;
+/**
+ * **urlMeta**`(url)`
+ *
+ * Analyzes the string passed in and provides a small dictionary of
+ * metadata properties about the URL.
+ */
+export declare const urlMeta: <T extends string>(url: T) => {
+    url: T;
+    isUrl: IsUrl<T>;
+    protocol: GetUrlProtocol<T>;
+    path: GetUrlPath<T>;
+    queryParameters: GetUrlQueryParams<T>;
+    port: GetUrlPort<T>;
+    source: GetUrlSource<T>;
+    isIpAddress: IsIpAddress<GetUrlSource<T>>;
+    isIp4Address: IsIp4Address<GetUrlSource<T>>;
+    isIp6Address: IsIp6Address<GetUrlSource<T>>;
+};
+//# sourceMappingURL=urlMeta.d.ts.map

package/dist/runtime/meta/urlMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlMeta.d.ts","sourceRoot":"","sources":["../../../src/runtime/meta/urlMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,cAAc,EACd,YAAY,EACZ,UAAU,EACV,iBAAiB,EAEjB,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACb,0BAAwB;AAiBzB,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IACvB,wBAAwB;IACxB,GAAG,EAAE,CAAC,CAAC;IACP,oFAAoF;IACpF,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,SAAS,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IAC/C,WAAW,EAAE,CAAC,SAAS,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IAC7D,gEAAgE;IAChE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAGpB,+CAA+C;IAC/C,MAAM,EAAE,CAAC,SAAS,MAAM,GACpB,YAAY,CAAC,CAAC,CAAC,GACf,KAAK,CAAC;IACV;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAC5B;;OAEG;IACH,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAE/B;;OAEG;IACH,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CAChC,CAAA;AAKD,eAAO,MAAM,cAAc,0BAGpB,CAAC,sBAKP,CAAA;AAED,eAAO,MAAM,iBAAiB,0BAA2B,CAAC,sDAEzD,CAAA;AAMD,eAAO,MAAM,UAAU,0BAGhB,CAAC,kBAQP,CAAA;AAED,eAAO,MAAM,iBAAiB,0BAGvB,CAAC,yBASP,CAAA;AAED,eAAO,MAAM,UAAU,0BAGhB,CAAC,uBAUP,CAAA;AAED,eAAO,MAAM,YAAY,0BAGlB,CAAC,oBASP,CAAA;AAGD;;;;;GAKG;AACH,eAAO,MAAM,OAAO,0BAEb,CAAC;;;;;;;;;;;CAcP,CAAA"}

package/dist/runtime/meta/urlMeta.js

@@ -0,0 +1,57 @@
+import { isUrl, isIp4Address, isIp6Address, isIpAddress, stripAfter, stripBefore, ensureLeading, stripTrailing, isDomainName, takeNumericCharacters, } from "../index.js";
+import { NETWORK_PROTOCOL_LOOKUP } from "../../constants/NetworkConstants.js";
+import { Never } from "../../constants/Never.js";
+const PROTOCOLS = Object.values(NETWORK_PROTOCOL_LOOKUP).flat().filter(i => i !== "");
+export const getUrlProtocol = (url) => {
+    const proto = PROTOCOLS.find(p => url.startsWith(`${p}://`));
+    return proto;
+};
+export const removeUrlProtocol = (url) => {
+    return stripBefore(url, "://");
+};
+const ensurePath = (val) => val === ""
+    ? ""
+    : stripTrailing(ensureLeading(val, "/"), "/");
+export const getUrlPath = (url) => {
+    return isUrl(url)
+        ? ensurePath(stripAfter(stripBefore(removeUrlProtocol(url), "/"), "?"))
+        : Never;
+};
+export const getUrlQueryParams = (url) => {
+    const qp = stripBefore(url, "?");
+    return (qp === ""
+        ? qp
+        : `?${qp}`);
+};
+export const getUrlPort = (url) => {
+    const candidate = takeNumericCharacters(stripBefore(removeUrlProtocol(url), ":"));
+    return (candidate === ""
+        ? "default"
+        : Number(candidate));
+};
+export const getUrlSource = (url) => {
+    const candidate = stripAfter(stripAfter(stripAfter(removeUrlProtocol(url), "/"), "?"), ":");
+    return (isIpAddress(candidate) || isDomainName(candidate)
+        ? candidate
+        : Never);
+};
+/**
+ * **urlMeta**`(url)`
+ *
+ * Analyzes the string passed in and provides a small dictionary of
+ * metadata properties about the URL.
+ */
+export const urlMeta = (url) => {
+    return {
+        url,
+        isUrl: isUrl(url),
+        protocol: getUrlProtocol(url),
+        path: getUrlPath(url),
+        queryParameters: getUrlQueryParams(url),
+        port: getUrlPort(url),
+        source: getUrlSource(url),
+        isIpAddress: isIpAddress(getUrlSource(url)),
+        isIp4Address: isIp4Address(getUrlSource(url)),
+        isIp6Address: isIp6Address(getUrlSource(url)),
+    };
+};

package/dist/runtime/meta/youtube-meta.d.ts

@@ -0,0 +1,31 @@
+import { As, GetYouTubePageType, YouTubePageType, YouTubeShareUrl, YouTubeUrl } from "../../types/index";
+/**
+ * **YouTubeMeta**`<T>`
+ *
+ * Provides metadata about YouTube related URLs.
+ */
+export type YouTubeMeta<T extends string> = {
+    /**
+     * The URL passed in
+     */
+    url: T;
+    /**
+     * boolean flag indicating whether the URL is a valid
+     * YouTube URL.
+     */
+    isYouTubeUrl: T extends YouTubeUrl ? true : false;
+    /**
+       * boolean flag indicating whether URL is part of YouTube's `https://youtu.be`
+       * URL shortener used when _sharing_ videos.
+       */
+    isShareUrl: T extends YouTubeShareUrl ? true : false;
+    pageType: As<GetYouTubePageType<T>, YouTubePageType>;
+};
+/**
+ * **youtube**`(url)`
+ *
+ * Takes a YouTube URL and converts it to a meta-data object
+ * that helps describe the intent of the URL.
+ */
+export declare const youtube: <T extends string>(url: T) => YouTubeMeta<T>;
+//# sourceMappingURL=youtube-meta.d.ts.map

package/dist/runtime/meta/youtube-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-meta.d.ts","sourceRoot":"","sources":["../../../src/runtime/meta/youtube-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,EAAE,EACF,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,UAAU,EACX,0BAAwB;AAOzB;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI;IAC1C;;OAEG;IACH,GAAG,EAAE,CAAC,CAAC;IACP;;;OAGG;IACH,YAAY,EAAE,CAAC,SAAS,UAAU,GAAG,IAAI,GAAG,KAAK,CAAC;IAElD;;;SAGK;IACL,UAAU,EAAE,CAAC,SAAS,eAAe,GAAG,IAAI,GAAG,KAAK,CAAC;IAErD,QAAQ,EAAE,EAAE,CACV,kBAAkB,CAAC,CAAC,CAAC,EACrB,eAAe,CAChB,CAAA;CACF,CAAC;AAGF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,0BAA2B,CAAC,KAAG,YAAY,CAAC,CAc/D,CAAA"}

package/dist/runtime/meta/youtube-meta.js

@@ -0,0 +1,19 @@
+import { isYouTubeShareUrl, isYouTubeUrl } from "../index.js";
+/**
+ * **youtube**`(url)`
+ *
+ * Takes a YouTube URL and converts it to a meta-data object
+ * that helps describe the intent of the URL.
+ */
+export const youtube = (url) => {
+    return (isYouTubeUrl(url)
+        ? {
+            url,
+            isYouTubeUrl: true,
+            isShareUrl: isYouTubeShareUrl(url),
+        }
+        : {
+            url,
+            isYouTubeUrl: false
+        });
+};

package/dist/runtime/runtime-types/parse.d.ts

@@ -15,7 +15,7 @@ export type ParsedToken<TType> = {
 export declare const parse: <T>(value: T) => {
     isToken: boolean;
     type: T;
-    token: (T & `<<string${string}>>`) | (T & `<<number${string}>>`) | (T & `<<boolean${string}>>`) | (T & `<<undefined${string}>>`) | (T & `<<map${string}>>`) | (T & `<<set${string}>>`) | (T & `<<false${string}>>`) | (T & `<<true${string}>>`) | (T & `<<null${string}>>`) | (T & `<<rec${string}>>`) | (T & `<<arr${string}>>`) | (T & `<<union${string}>>`) | (T & `<<obj${string}>>`) | (T & `<<tuple${string}>>`) | (T & `<<fn${string}>>`) | (T & `<<gen${string}>>`) | (T & `<<string-set${string}>>`) | (T & `<<numeric-set${string}>>`) | (T & `<<union-set${string}>>`);
+    token: (T & `<<string${string}>>`) | (T & `<<number${string}>>`) | (T & `<<boolean${string}>>`) | (T & `<<undefined${string}>>`) | (T & `<<map${string}>>`) | (T & `<<set${string}>>`) | (T & `<<null${string}>>`) | (T & `<<true${string}>>`) | (T & `<<false${string}>>`) | (T & `<<rec${string}>>`) | (T & `<<arr${string}>>`) | (T & `<<union${string}>>`) | (T & `<<obj${string}>>`) | (T & `<<tuple${string}>>`) | (T & `<<fn${string}>>`) | (T & `<<gen${string}>>`) | (T & `<<string-set${string}>>`) | (T & `<<numeric-set${string}>>`) | (T & `<<union-set${string}>>`);
     tokenName: string;
     tokenData: string[];
 } | {

package/dist/runtime/runtime-types/shape-helpers/getTokenData.d.ts

@@ -4,5 +4,5 @@
  * Given a `Shape` token, this function will extract the
  * data parameters from the token.
  */
-export declare const getTokenData: <T extends `<<string${string}>>` | `<<number${string}>>` | `<<boolean${string}>>` | `<<undefined${string}>>` | `<<map${string}>>` | `<<set${string}>>` | `<<false${string}>>` | `<<true${string}>>` | `<<null${string}>>` | `<<rec${string}>>` | `<<arr${string}>>` | `<<union${string}>>` | `<<obj${string}>>` | `<<tuple${string}>>` | `<<fn${string}>>` | `<<gen${string}>>` | `<<string-set${string}>>` | `<<numeric-set${string}>>` | `<<union-set${string}>>`>(token: T) => string[];
+export declare const getTokenData: <T extends `<<string${string}>>` | `<<number${string}>>` | `<<boolean${string}>>` | `<<undefined${string}>>` | `<<map${string}>>` | `<<set${string}>>` | `<<null${string}>>` | `<<true${string}>>` | `<<false${string}>>` | `<<rec${string}>>` | `<<arr${string}>>` | `<<union${string}>>` | `<<obj${string}>>` | `<<tuple${string}>>` | `<<fn${string}>>` | `<<gen${string}>>` | `<<string-set${string}>>` | `<<numeric-set${string}>>` | `<<union-set${string}>>`>(token: T) => string[];
 //# sourceMappingURL=getTokenData.d.ts.map

package/dist/runtime/runtime-types/shape-helpers/getTokenName.d.ts

@@ -3,5 +3,5 @@
  *
  * Given a `Shape` token, this function will extract the
  */
-export declare const getTokenName: <T extends `<<string${string}>>` | `<<number${string}>>` | `<<boolean${string}>>` | `<<undefined${string}>>` | `<<map${string}>>` | `<<set${string}>>` | `<<false${string}>>` | `<<true${string}>>` | `<<null${string}>>` | `<<rec${string}>>` | `<<arr${string}>>` | `<<union${string}>>` | `<<obj${string}>>` | `<<tuple${string}>>` | `<<fn${string}>>` | `<<gen${string}>>` | `<<string-set${string}>>` | `<<numeric-set${string}>>` | `<<union-set${string}>>`>(token: T) => string;
+export declare const getTokenName: <T extends `<<string${string}>>` | `<<number${string}>>` | `<<boolean${string}>>` | `<<undefined${string}>>` | `<<map${string}>>` | `<<set${string}>>` | `<<null${string}>>` | `<<true${string}>>` | `<<false${string}>>` | `<<rec${string}>>` | `<<arr${string}>>` | `<<union${string}>>` | `<<obj${string}>>` | `<<tuple${string}>>` | `<<fn${string}>>` | `<<gen${string}>>` | `<<string-set${string}>>` | `<<numeric-set${string}>>` | `<<union-set${string}>>`>(token: T) => string;
 //# sourceMappingURL=getTokenName.d.ts.map

package/dist/runtime/runtime-types/shape-helpers/singletons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"singletons.d.ts","sourceRoot":"","sources":["../../../../src/runtime/runtime-types/shape-helpers/singletons.ts"],"names":[],"mappings":"AACA,OAAO,EAML,oBAAoB,EAGpB,YAAY,EAKb,6BAAwB;AAmEzB,eAAO,MAAM,MAAM,wJAAoC,CAAC;AACxD,eAAO,MAAM,MAAM,kIAAyB,CAAC"}
+{"version":3,"file":"singletons.d.ts","sourceRoot":"","sources":["../../../../src/runtime/runtime-types/shape-helpers/singletons.ts"],"names":[],"mappings":"AAAC,OAAO,EAMN,oBAAoB,EAGpB,YAAY,EAKb,6BAAwB;AAmEzB,eAAO,MAAM,MAAM,wJAAoC,CAAC;AACxD,eAAO,MAAM,MAAM,kIAAyB,CAAC"}

package/dist/runtime/runtime-types/shape-helpers/singletons.js

@@ -10,7 +10,7 @@ const addSingleton = (token, api) => (...literals) => {
         : literals.length === 1
             ? addToken(token, literals[0])
             : addToken("union", literals
-                .map(l => addToken(token, `${l}`))
+                .map((l) => addToken(token, `${l}`))
                 .join(",")));
 };
 const stringApi = ({

package/dist/runtime/runtime-types/shape.d.ts

@@ -14,5 +14,5 @@ export declare const shape: <T extends ShapeCallback>(cb: T) => HandleDoneFn<Ret
  *
  * Type guard which tests whether a value is a _type_ defined by a `Shape`.
  */
-export declare const isShape: (v: unknown) => v is `<<string${string}>>` | `<<number${string}>>` | `<<boolean${string}>>` | `<<undefined${string}>>` | `<<map${string}>>` | `<<set${string}>>` | `<<false${string}>>` | `<<true${string}>>` | `<<null${string}>>` | `<<rec${string}>>` | `<<arr${string}>>` | `<<union${string}>>` | `<<obj${string}>>` | `<<tuple${string}>>` | `<<fn${string}>>` | `<<gen${string}>>` | `<<string-set${string}>>` | `<<numeric-set${string}>>` | `<<union-set${string}>>`;
+export declare const isShape: (v: unknown) => v is `<<string${string}>>` | `<<number${string}>>` | `<<boolean${string}>>` | `<<undefined${string}>>` | `<<map${string}>>` | `<<set${string}>>` | `<<null${string}>>` | `<<true${string}>>` | `<<false${string}>>` | `<<rec${string}>>` | `<<arr${string}>>` | `<<union${string}>>` | `<<obj${string}>>` | `<<tuple${string}>>` | `<<fn${string}>>` | `<<gen${string}>>` | `<<string-set${string}>>` | `<<numeric-set${string}>>` | `<<union-set${string}>>`;
 //# sourceMappingURL=shape.d.ts.map