inferred-types 0.51.0 → 0.51.2

package/dist/runtime/type-conversion/asRecord.d.ts

@@ -0,0 +1,10 @@
+import { AsRecord, ObjectKey } from "inferred-types/dist/types/index";
+/**
+ * **asRecord**`<T>`(obj: T) → AsRecord`<T>`
+ *
+ * An "identity function" with regards to runtime information but
+ * helps convert a `object` to a `Record<ObjectKey,unknown>` which
+ * is indexable.
+ */
+export declare const asRecord: <T extends Record<ObjectKey, unknown> | object>(obj: T) => AsRecord<T>;
+//# sourceMappingURL=asRecord.d.ts.map

package/dist/runtime/type-conversion/asRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asRecord.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/asRecord.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GACnB,CAAC,SAAS,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,OACxC,CAAC,KAAG,QAAQ,CAAC,CAAC,CAEpB,CAAA"}

package/dist/runtime/type-conversion/asRecord.js

@@ -0,0 +1,10 @@
+/**
+ * **asRecord**`<T>`(obj: T) → AsRecord`<T>`
+ *
+ * An "identity function" with regards to runtime information but
+ * helps convert a `object` to a `Record<ObjectKey,unknown>` which
+ * is indexable.
+ */
+export const asRecord = (obj) => {
+    return obj;
+};

package/dist/runtime/type-conversion/asString.d.ts

@@ -0,0 +1,20 @@
+import { AsString } from "inferred-types/dist/types/index";
+/**
+ * **asString**`(value)
+ *
+ * Attempts to convert the value passed in into a string
+ * using the same methods available to the type utility
+ * `AsString<T>`.
+ *
+ * If unable to convert to a string then it will provide
+ * the runtime value of `String(value)` but the type system
+ * will be set to `never`.
+ *
+ * - if an array is passed in then it will be joined
+ * together -- no delimiter characters -- into a string
+ * - if a tuple of `SimpleToken[]` is discovered it will
+ * set the runtime type to a token of `<<string::...>>` while the
+ * type of the string will be
+ */
+export declare const asString: <T>(value: T) => AsString<T>;
+//# sourceMappingURL=asString.d.ts.map

package/dist/runtime/type-conversion/asString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asString.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/asString.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAG3D;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,CAAC,KAAG,QAAQ,CAAC,CAAC,CAYhD,CAAA"}

package/dist/runtime/type-conversion/asString.js

@@ -0,0 +1,29 @@
+import { isArray, isBoolean, isNumber, isString } from "src/runtime/index";
+/**
+ * **asString**`(value)
+ *
+ * Attempts to convert the value passed in into a string
+ * using the same methods available to the type utility
+ * `AsString<T>`.
+ *
+ * If unable to convert to a string then it will provide
+ * the runtime value of `String(value)` but the type system
+ * will be set to `never`.
+ *
+ * - if an array is passed in then it will be joined
+ * together -- no delimiter characters -- into a string
+ * - if a tuple of `SimpleToken[]` is discovered it will
+ * set the runtime type to a token of `<<string::...>>` while the
+ * type of the string will be
+ */
+export const asString = (value) => {
+    return (isString(value)
+        ? value
+        : isNumber(value)
+            ? `${value}`
+            : isBoolean(value)
+                ? `${value}`
+                : isArray(value)
+                    ? value.join("")
+                    : String(value));
+};

package/dist/runtime/type-conversion/csv.d.ts

@@ -0,0 +1,17 @@
+import { CsvToJsonTuple, CsvToTuple, CsvToTupleStr } from "inferred-types/dist/types/index";
+export type CsvFormat = "string-tuple" | "string-numeric-tuple" | "json-tuple";
+/**
+ * **csv**`(csv, [format])`
+ *
+ * Converts a CSV string literal into a tuple of values
+ * (based on format).
+ *
+ * **Note:** either _no space_ or _a single space_ between values
+ * will provide a trimmed value but any additional whitespace
+ * after the comma will result in some leading whitespace in
+ * some values.
+ *
+ * @default format `string-numeric-tuple`
+ */
+export declare const csv: <T extends string, F extends CsvFormat = "string-numeric-tuple">(csv: T, format?: F) => F extends "string-numeric-tuple" ? CsvToTuple<T> : F extends "json-tuple" ? CsvToJsonTuple<T> : F extends "string-tuple" ? CsvToTupleStr<T> : never;
+//# sourceMappingURL=csv.d.ts.map

package/dist/runtime/type-conversion/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/csv.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAE5F,MAAM,MAAM,SAAS,GACnB,cAAc,GACd,sBAAsB,GACtB,YAAY,CAAC;AAGf;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,GAAG,GACd,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,SAAS,gCAEd,CAAC,WACE,CAAC,KAoBO,CAAC,SAAS,sBAAsB,GAC5C,UAAU,CAAC,CAAC,CAAC,GACb,CAAC,SAAS,YAAY,GACtB,cAAc,CAAC,CAAC,CAAC,GACjB,CAAC,SAAS,cAAc,GACxB,aAAa,CAAC,CAAC,CAAC,GAChB,KACL,CAAA"}

package/dist/runtime/type-conversion/csv.js

@@ -0,0 +1,31 @@
+import { Never } from "inferred-types/dist/constants/index";
+import { isNumberLike } from "../type-guards";
+/**
+ * **csv**`(csv, [format])`
+ *
+ * Converts a CSV string literal into a tuple of values
+ * (based on format).
+ *
+ * **Note:** either _no space_ or _a single space_ between values
+ * will provide a trimmed value but any additional whitespace
+ * after the comma will result in some leading whitespace in
+ * some values.
+ *
+ * @default format `string-numeric-tuple`
+ */
+export const csv = (csv, format = `string-numeric-tuple`) => {
+    const tuple = [];
+    csv.split(/,\s{0,1}/).forEach(v => {
+        tuple.push(format === "string-numeric-tuple"
+            ? isNumberLike(v) ? Number(v) : v
+            : format === "json-tuple"
+                ? isNumberLike(v)
+                    ? Number(v)
+                    : v === "true" ? true : v === "false" ? false
+                        : `"${v}"`
+                : format === "string-tuple"
+                    ? `${v}`
+                    : Never);
+    });
+    return tuple;
+};

package/dist/runtime/type-conversion/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./mergeObjects";
+export * from "./optional";
+export * from "./mergeScalars";
+export * from "./mergeTuples";
+export * from "./unionize";
+export * from "./intersect";
+export * from "./never";
+export * from "./union";
+export * from "./toNumber";
+export * from "./asRecord";
+export * from "./asString";
+export * from "./asChars";
+export * from "./ip6GroupExpansion";
+export * from "./csv";
+export * from "./lookupCountry";
+export * from "./json";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/type-conversion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,OAAO,CAAC;AACtB,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC"}

package/dist/runtime/type-conversion/index.js

@@ -0,0 +1,16 @@
+export * from "./mergeObjects";
+export * from "./optional";
+export * from "./mergeScalars";
+export * from "./mergeTuples";
+export * from "./unionize";
+export * from "./intersect";
+export * from "./never";
+export * from "./union";
+export * from "./toNumber";
+export * from "./asRecord";
+export * from "./asString";
+export * from "./asChars";
+export * from "./ip6GroupExpansion";
+export * from "./csv";
+export * from "./lookupCountry";
+export * from "./json";

package/dist/runtime/type-conversion/intersect.d.ts

@@ -0,0 +1,9 @@
+/**
+ * **intersect**(value, intersectedWith)
+ *
+ * Runtime utility which receives `value` property and returns it with an
+ * unchanged _runtime_ value but with the type now intersected with the
+ * value provided by `intersectedWith`.
+ */
+export declare function intersect<T, U>(value: T, intersectedWith: U): T & U;
+//# sourceMappingURL=intersect.d.ts.map

package/dist/runtime/type-conversion/intersect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intersect.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/intersect.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAElE"}

package/dist/runtime/type-conversion/intersect.js

@@ -0,0 +1,11 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/**
+ * **intersect**(value, intersectedWith)
+ *
+ * Runtime utility which receives `value` property and returns it with an
+ * unchanged _runtime_ value but with the type now intersected with the
+ * value provided by `intersectedWith`.
+ */
+export function intersect(value, intersectedWith) {
+    return value;
+}

package/dist/runtime/type-conversion/ip6GroupExpansion.d.ts

@@ -0,0 +1,14 @@
+import { Ip6GroupExpansion } from "inferred-types/dist/types/index";
+/**
+ * **ip6GroupExpansion**`(ip)`
+ *
+ * Looks at the IPv6 address and expands all instances of `::` to add
+ * a block of `0000` where it was.
+ *
+ * ```ts
+ * // fe89:0000:1256
+ * const ip6 = ip6GroupExpansion("fe89::1256");
+ * ```
+ */
+export declare const ip6GroupExpansion: <T extends string>(ip: T) => Ip6GroupExpansion<T>;
+//# sourceMappingURL=ip6GroupExpansion.d.ts.map

package/dist/runtime/type-conversion/ip6GroupExpansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip6GroupExpansion.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/ip6GroupExpansion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAGnE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,MAAM,CAAC,KACK,iBAAiB,CAAC,CAAC,CAChF,CAAA"}

package/dist/runtime/type-conversion/ip6GroupExpansion.js

@@ -0,0 +1,15 @@
+import { stripTrailing } from "../literals/stripTrailing";
+/**
+ * **ip6GroupExpansion**`(ip)`
+ *
+ * Looks at the IPv6 address and expands all instances of `::` to add
+ * a block of `0000` where it was.
+ *
+ * ```ts
+ * // fe89:0000:1256
+ * const ip6 = ip6GroupExpansion("fe89::1256");
+ * ```
+ */
+export const ip6GroupExpansion = (ip) => {
+    return stripTrailing(ip.replaceAll("::", ":0000:"), ":");
+};

package/dist/runtime/type-conversion/json.d.ts

@@ -0,0 +1,18 @@
+import { JsonValue, JsonValues } from "inferred-types/dist/types/index";
+/**
+ * **jsonValue**`(val)`
+ *
+ * Converts a string value to JSON value
+ *
+ * **Related:** `jsonValues()`
+ */
+export declare const jsonValue: <T>(val: T) => JsonValue<T>;
+/**
+ * **jsonValues**`(values)`
+ *
+ * Converts string values to JSON values
+ *
+ * **Related:** `csv`
+ */
+export declare const jsonValues: <T extends unknown[]>(...val: T) => JsonValues<T>;
+//# sourceMappingURL=json.d.ts.map

package/dist/runtime/type-conversion/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAGxE;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,OAAO,CAAC,KAAG,SAAS,CAAC,CAAC,CAUhD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,OAAO,EAAE,UAAU,CAAC,KAAG,UAAU,CAAC,CAAC,CAEvE,CAAA"}

package/dist/runtime/type-conversion/json.js

@@ -0,0 +1,27 @@
+import { isNumberLike } from "src/runtime/index";
+/**
+ * **jsonValue**`(val)`
+ *
+ * Converts a string value to JSON value
+ *
+ * **Related:** `jsonValues()`
+ */
+export const jsonValue = (val) => {
+    return (isNumberLike(val)
+        ? Number(val)
+        : val === "true"
+            ? true
+            : val === "false"
+                ? false
+                : `"${val}"`);
+};
+/**
+ * **jsonValues**`(values)`
+ *
+ * Converts string values to JSON values
+ *
+ * **Related:** `csv`
+ */
+export const jsonValues = (...val) => {
+    return val.map(i => jsonValue(i));
+};

package/dist/runtime/type-conversion/lookupCountry.d.ts

@@ -0,0 +1,32 @@
+import { Iso3166_1_Alpha2, Iso3166_1_Alpha3, Iso3166_1_CountryCode, Iso3166_1_CountryName, Iso3166Alpha2Lookup, Iso3166Alpha3Lookup, Iso3166CodeLookup, Iso3166CountryLookup, Suggest } from "inferred-types/dist/types/index";
+import { AsString } from "inferred-types/dist/types/index";
+/**
+ * **lookupCountryName**`(code)`
+ *
+ * Looks up a country name by either the alpha-2, alpha-3, or country code
+ * as defined by the [ISO3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) standard.
+ *
+ * - the ISO standard uses uppercase characters for Alpha2 and Alpha3 codes but
+ * this utility will handle upper or lowercase
+ * - it will correctly type the country name if the code passed in is a literal
+ * string (and a valid code)
+ *
+ * **Related:** `lookupCountryAlpha2()`, `lookupCountryAlpha3()`
+ */
+export declare const lookupCountryName: <T extends Suggest<Iso3166_1_Alpha2 | Iso3166_1_Alpha3 | Iso3166_1_CountryCode>>(code: T) => Iso3166CountryLookup<Uppercase<AsString<T>>>;
+/**
+ * Looks up the Alpha2 component of a [ISO3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
+ * standard.
+ */
+export declare const lookupCountryAlpha2: <T extends Suggest<Iso3166_1_Alpha3 | Iso3166_1_CountryCode | Iso3166_1_CountryName>>(code: T) => T extends Iso3166_1_CountryName ? Iso3166Alpha2Lookup<T> : Iso3166Alpha2Lookup<Uppercase<AsString<T>>>;
+/**
+ * Looks up the Alpha3 component of a [ISO3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
+ * standard.
+ */
+export declare const lookupCountryAlpha3: <T extends Suggest<Iso3166_1_Alpha2 | Iso3166_1_CountryCode | Iso3166_1_CountryName>>(token: T) => T extends Iso3166_1_CountryName ? Iso3166Alpha3Lookup<T> : Iso3166Alpha3Lookup<Uppercase<AsString<T>>>;
+/**
+ * Looks up the Alpha3 component of a [ISO3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
+ * standard.
+ */
+export declare const lookupCountryCode: <T extends Suggest<Iso3166_1_Alpha2 | Iso3166_1_Alpha3 | Iso3166_1_CountryName>>(token: T) => T extends Iso3166_1_CountryName ? Iso3166CodeLookup<T> : Iso3166CodeLookup<Uppercase<AsString<T>>>;
+//# sourceMappingURL=lookupCountry.d.ts.map

package/dist/runtime/type-conversion/lookupCountry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookupCountry.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/lookupCountry.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,OAAO,EACR,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EAAE,QAAQ,EAAE,MAAK,iCAAiC,CAAC;AAiH1D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,OAAO,CAAC,gBAAgB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC,QACxG,CAAC,KAYS,oBAAoB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC5D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,CAAC,SAAS,OAAO,CAAC,gBAAgB,GAClC,qBAAqB,GACrB,qBAAqB,CACtB,QACO,CAAC,KAcS,CAAC,SAAS,qBAAqB,GAC7C,mBAAmB,CAAC,CAAC,CAAC,GACtB,mBAAmB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC7C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,CAAC,SAAS,OAAO,CACf,gBAAgB,GAChB,qBAAqB,GACrB,qBAAqB,CACxB,SACQ,CAAC,KAcQ,CAAC,SAAS,qBAAqB,GAC7C,mBAAmB,CAAC,CAAC,CAAC,GACtB,mBAAmB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC7C,CAAA;AAGD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,CAAC,SAAS,OAAO,CACf,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,CACxB,SACQ,CAAC,KAcQ,CAAC,SAAS,qBAAqB,GAC7C,iBAAiB,CAAC,CAAC,CAAC,GACpB,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC3C,CAAA"}

package/dist/runtime/type-conversion/lookupCountry.js

@@ -0,0 +1,97 @@
+import { isIso3166Alpha2, isIso3166Alpha3, isIso3166CountryName, isNumber, isNumberLike } from "../type-guards";
+import { ISO3166_1 } from "inferred-types/dist/constants/index";
+import { uppercase } from "../literals";
+const lookupAlpha2Code = (code, prop) => {
+    const found = ISO3166_1.find(i => i["alpha2"] === code);
+    return (found ? found[prop] : undefined);
+};
+const lookupAlpha3Code = (code, prop) => {
+    const found = ISO3166_1.find(i => i["alpha3"] === code);
+    return (found ? found[prop] : undefined);
+};
+const lookupName = (name, prop) => {
+    const found = ISO3166_1.find(i => i["name"] === name);
+    return (found ? found[prop] : undefined);
+};
+const lookupNumericCode = (code, prop) => {
+    let num = isNumber(code) ? `${code}` : code;
+    if (num.length === 1) {
+        num = `00${num}`;
+    }
+    else if (num.length === 2) {
+        num = `0${num}`;
+    }
+    const found = ISO3166_1.find(i => i["countryCode"] === num);
+    return found ? found[prop] : undefined;
+};
+/**
+ * **lookupCountryName**`(code)`
+ *
+ * Looks up a country name by either the alpha-2, alpha-3, or country code
+ * as defined by the [ISO3166-1](https://en.wikipedia.org/wiki/ISO_3166-1) standard.
+ *
+ * - the ISO standard uses uppercase characters for Alpha2 and Alpha3 codes but
+ * this utility will handle upper or lowercase
+ * - it will correctly type the country name if the code passed in is a literal
+ * string (and a valid code)
+ *
+ * **Related:** `lookupCountryAlpha2()`, `lookupCountryAlpha3()`
+ */
+export const lookupCountryName = (code) => {
+    const uc = uppercase(code);
+    return (isNumberLike(code)
+        ? lookupNumericCode(code, "name")
+        : isIso3166Alpha2(uc)
+            ? lookupAlpha2Code(uc, "name")
+            : isIso3166Alpha3(uc)
+                ? lookupAlpha3Code(uc, "name")
+                : undefined);
+};
+/**
+ * Looks up the Alpha2 component of a [ISO3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
+ * standard.
+ */
+export const lookupCountryAlpha2 = (code) => {
+    const uc = uppercase(code);
+    return (isNumberLike(code)
+        ? lookupNumericCode(code, "alpha2")
+        : isIso3166Alpha2(uc)
+            ? lookupAlpha2Code(uc, "alpha2")
+            : isIso3166Alpha3(uc)
+                ? lookupAlpha3Code(uc, "alpha2")
+                : isIso3166CountryName(code)
+                    ? lookupName(code, "alpha2")
+                    : undefined);
+};
+/**
+ * Looks up the Alpha3 component of a [ISO3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
+ * standard.
+ */
+export const lookupCountryAlpha3 = (token) => {
+    const uc = uppercase(token);
+    return (isNumberLike(token)
+        ? lookupNumericCode(token, "alpha3")
+        : isIso3166Alpha2(uc)
+            ? lookupAlpha2Code(uc, "alpha3")
+            : isIso3166Alpha3(uc)
+                ? lookupAlpha3Code(uc, "alpha3")
+                : isIso3166CountryName(token)
+                    ? lookupName(token, "alpha3")
+                    : undefined);
+};
+/**
+ * Looks up the Alpha3 component of a [ISO3166-1](https://en.wikipedia.org/wiki/ISO_3166-1)
+ * standard.
+ */
+export const lookupCountryCode = (token) => {
+    const uc = uppercase(token);
+    return (isNumberLike(token)
+        ? lookupNumericCode(token, "countryCode")
+        : isIso3166Alpha2(uc)
+            ? lookupAlpha2Code(uc, "countryCode")
+            : isIso3166Alpha3(uc)
+                ? lookupAlpha3Code(uc, "countryCode")
+                : isIso3166CountryName(token)
+                    ? lookupName(token, "countryCode")
+                    : undefined);
+};

package/dist/runtime/type-conversion/mergeObjects.d.ts

@@ -0,0 +1,3 @@
+import { MergeObjects, NarrowObject, Narrowable } from "inferred-types/dist/types/index";
+export declare function mergeObjects<D extends Narrowable, O extends Narrowable, TDefault extends NarrowObject<D>, TOverride extends NarrowObject<O>>(defVal: TDefault, override: TOverride): MergeObjects<TDefault, TOverride>;
+//# sourceMappingURL=mergeObjects.d.ts.map

package/dist/runtime/type-conversion/mergeObjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeObjects.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/mergeObjects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAKrG,wBAAgB,YAAY,CAC1B,CAAC,SAAS,UAAU,EACpB,CAAC,SAAS,UAAU,EACpB,QAAQ,SAAS,YAAY,CAAC,CAAC,CAAC,EAChC,SAAS,SAAS,YAAY,CAAC,CAAC,CAAC,EAEjC,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,SAAS,GAiBS,YAAY,CAAC,QAAQ,EAAE,SAAS,CAAC,CAC9D"}

package/dist/runtime/type-conversion/mergeObjects.js

@@ -0,0 +1,15 @@
+import { sharedKeys } from "src/runtime/index";
+import { withoutKeys } from "src/runtime/index";
+export function mergeObjects(defVal, override) {
+    const intersectingKeys = sharedKeys(defVal, override);
+    const defUnique = withoutKeys(defVal, ...intersectingKeys);
+    const overrideUnique = withoutKeys(defVal, ...intersectingKeys);
+    const merged = {
+        ...(intersectingKeys.reduce((acc, key) => typeof override[key] === "undefined"
+            ? { ...acc, [key]: defVal[key] }
+            : { ...acc, [key]: override[key] }, {})),
+        ...defUnique,
+        ...overrideUnique,
+    };
+    return merged;
+}

package/dist/runtime/type-conversion/mergeScalars.d.ts

@@ -0,0 +1,9 @@
+import type { MergeScalars, Scalar } from "inferred-types/dist/types/index";
+/**
+ * **mergeScalars**(a,b)
+ *
+ * The value of scalar `b` _overrides_ that of `a` unless `b` is
+ * undefined.
+ */
+export declare function mergeScalars<A extends Scalar | undefined, B extends Scalar | undefined>(a: A, b: B): MergeScalars<A, B>;
+//# sourceMappingURL=mergeScalars.d.ts.map

package/dist/runtime/type-conversion/mergeScalars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeScalars.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/mergeScalars.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAI5E;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,CAAC,SAAS,MAAM,GAAG,SAAS,EAC5B,CAAC,SAAS,MAAM,GAAG,SAAS,EAC5B,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GACyB,YAAY,CAAC,CAAC,EAAC,CAAC,CAAC,CACrD"}

package/dist/runtime/type-conversion/mergeScalars.js

@@ -0,0 +1,10 @@
+import { isUndefined } from "../type-guards/isUndefined";
+/**
+ * **mergeScalars**(a,b)
+ *
+ * The value of scalar `b` _overrides_ that of `a` unless `b` is
+ * undefined.
+ */
+export function mergeScalars(a, b) {
+    return (isUndefined(b) ? a : b);
+}

package/dist/runtime/type-conversion/mergeTuples.d.ts

@@ -0,0 +1,10 @@
+import type { MergeTuples, Narrowable } from "inferred-types/dist/types/index";
+/**
+ * **mergeTuples**(a,b)
+ *
+ * Replaces values in `a` with `b` unless `b` is _undefined_. Also, if
+ * `a` has more elements than `b` then these extra elements will be
+ * appended to the end.
+ */
+export declare function mergeTuples<A extends readonly Narrowable[], B extends readonly Narrowable[]>(a: A, b: B): MergeTuples<A, B>;
+//# sourceMappingURL=mergeTuples.d.ts.map

package/dist/runtime/type-conversion/mergeTuples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeTuples.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/mergeTuples.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,EAAE,CAAC,SAAS,SAAS,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,EAAC,CAAC,CAAC,CAM1H"}

package/dist/runtime/type-conversion/mergeTuples.js

@@ -0,0 +1,12 @@
+/**
+ * **mergeTuples**(a,b)
+ *
+ * Replaces values in `a` with `b` unless `b` is _undefined_. Also, if
+ * `a` has more elements than `b` then these extra elements will be
+ * appended to the end.
+ */
+export function mergeTuples(a, b) {
+    return (b.length > a.length
+        ? b.map((v, idx) => v !== undefined ? v : a[idx])
+        : [...b, ...a.slice(b.length)].map((v, idx) => v !== undefined ? v : a[idx]));
+}

package/dist/runtime/type-conversion/mutable.d.ts

@@ -0,0 +1,3 @@
+import { Narrowable, Mutable } from "inferred-types/dist/types/index";
+export declare function mutable<T extends Narrowable | readonly Narrowable[]>(value: T): Mutable<T>;
+//# sourceMappingURL=mutable.d.ts.map

package/dist/runtime/type-conversion/mutable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutable.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/mutable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAG,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAEvE,wBAAgB,OAAO,CAAC,CAAC,SAAS,UAAU,GAAG,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1F"}

package/dist/runtime/type-conversion/mutable.js

@@ -0,0 +1,3 @@
+export function mutable(value) {
+    return value;
+}

package/dist/runtime/type-conversion/never.d.ts

@@ -0,0 +1,11 @@
+/**
+ * **never**(val)
+ *
+ * You can pass a value into this utility and it's runtime type
+ * will be unchanged but it's _type_ will be converted to `never`.
+ *
+ * **Related:** if you prefer to keep runtime and type system in sync
+ * there is also the `Never` constant which can be used.
+ */
+export declare function never(val: unknown): never;
+//# sourceMappingURL=never.d.ts.map

package/dist/runtime/type-conversion/never.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"never.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/never.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAEzC"}

package/dist/runtime/type-conversion/never.js

@@ -0,0 +1,12 @@
+/**
+ * **never**(val)
+ *
+ * You can pass a value into this utility and it's runtime type
+ * will be unchanged but it's _type_ will be converted to `never`.
+ *
+ * **Related:** if you prefer to keep runtime and type system in sync
+ * there is also the `Never` constant which can be used.
+ */
+export function never(val) {
+    return val;
+}

package/dist/runtime/type-conversion/optional.d.ts

@@ -0,0 +1,25 @@
+import { Narrowable } from "inferred-types/dist/types/index";
+/**
+ * **optional**(value)
+ *
+ * A function which takes the value `T` and widens it to include
+ * a union with _undefined_.
+ */
+export declare function optional<T extends Narrowable>(value: T): T | undefined;
+/**
+ * **orNull**`(value)`
+ *
+ * widens the type for the value passed in to be whatever type it
+ * currently is _in union with_ `null`.
+ */
+export declare function orNull<T extends Narrowable>(value: T): T | null;
+/**
+ * **optionalOrNull**`(value)`
+ *
+ *  widens the type for the value passed in to be whatever type it
+ * currently is _in union with_ `null and `undefined`.
+ *
+ * **Related:** `optional()`, `orNull()`
+ */
+export declare function optionalOrNull<T extends Narrowable>(value: T): T | null | undefined;
+//# sourceMappingURL=optional.d.ts.map

package/dist/runtime/type-conversion/optional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/optional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAI7D;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,CAAC,SAAS,UAAU,EACpB,KAAK,EAAE,CAAC,GACQ,CAAC,GAAG,SAAS,CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,GACnC,CAAC,GAAG,IAAI,CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,GAC3C,CAAC,GAAG,IAAI,GAAG,SAAS,CACrC"}

package/dist/runtime/type-conversion/optional.js

@@ -0,0 +1,29 @@
+/**
+ * **optional**(value)
+ *
+ * A function which takes the value `T` and widens it to include
+ * a union with _undefined_.
+ */
+export function optional(value) {
+    return value;
+}
+/**
+ * **orNull**`(value)`
+ *
+ * widens the type for the value passed in to be whatever type it
+ * currently is _in union with_ `null`.
+ */
+export function orNull(value) {
+    return value;
+}
+/**
+ * **optionalOrNull**`(value)`
+ *
+ *  widens the type for the value passed in to be whatever type it
+ * currently is _in union with_ `null and `undefined`.
+ *
+ * **Related:** `optional()`, `orNull()`
+ */
+export function optionalOrNull(value) {
+    return value;
+}

package/dist/runtime/type-conversion/toNumber.d.ts

@@ -0,0 +1,11 @@
+import { Narrowable, ToNumber } from "inferred-types/dist/types/index";
+/**
+ * **toNumber**(value)
+ *
+ * Runtime utility which converts a value into a _numeric_ variant:
+ *
+ * - for scalars (and objects) it will try to convert to number but otherwise returns `NaN` to runtime and `never` to type system
+ * - for arrays it will iterate over each element and try to convert to a number like above
+ */
+export declare function toNumber<T extends Narrowable>(value: T): ToNumber<T>;
+//# sourceMappingURL=toNumber.d.ts.map

package/dist/runtime/type-conversion/toNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toNumber.d.ts","sourceRoot":"","sources":["../../../src/runtime/type-conversion/toNumber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAU,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAkB/E;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,CAAC,SAAS,UAAU,EACpB,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAMvB"}