inferred-types 0.45.0 → 0.45.2

package/dist/types/boolean-logic/operators/IsGreaterThan.d.ts

@@ -1,4 +1,4 @@
-import { AsNumber } from "../../index";
+import { AsNumber, If, IsEqual, Or } from "../../index";
 type Calc<A extends number, B extends number, Count extends 1[] = []> = Count["length"] extends A ? false : Count["length"] extends B ? true : Calc<A, B, [...Count, 1]>;
 /**
  * **IsGreaterThan**`<A,B>`
@@ -8,6 +8,6 @@ type Calc<A extends number, B extends number, Count extends 1[] = []> = Count["l
  *
  * **Note:** does not take negative numbers into account
  */
-export type IsGreaterThan<A extends number | `${number}`, B extends number | `${number}`> = Calc<AsNumber<A>, AsNumber<B>>;
+export type IsGreaterThan<A extends number | `${number}`, B extends number | `${number}`> = If<Or<[IsEqual<A, number>, IsEqual<B, number>, IsEqual<A, `${number}`>, IsEqual<B, `${number}`>]>, boolean, Calc<AsNumber<A>, AsNumber<B>>>;
 export {};
 //# sourceMappingURL=IsGreaterThan.d.ts.map

package/dist/types/boolean-logic/operators/IsGreaterThan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IsGreaterThan.d.ts","sourceRoot":"","sources":["../../../../src/types/boolean-logic/operators/IsGreaterThan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,oBAAwB;AAE3C,KAAK,IAAI,CACP,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAChB,KAAK,SAAS,CAAC,EAAE,GAAG,EAAE,IAExB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GACrB,KAAK,GACL,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GACvB,IAAI,GACJ,IAAI,CAAC,CAAC,EAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,MAAM,GAAG,GAAG,MAAM,EAAE,EAC9B,CAAC,SAAS,MAAM,GAAG,GAAG,MAAM,EAAE,IAC5B,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"IsGreaterThan.d.ts","sourceRoot":"","sources":["../../../../src/types/boolean-logic/operators/IsGreaterThan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,oBAAwB;AAE5D,KAAK,IAAI,CACP,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,EAChB,KAAK,SAAS,CAAC,EAAE,GAAG,EAAE,IAExB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GACrB,KAAK,GACL,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GACvB,IAAI,GACJ,IAAI,CAAC,CAAC,EAAC,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,MAAM,GAAG,GAAG,MAAM,EAAE,EAC9B,CAAC,SAAS,MAAM,GAAG,GAAG,MAAM,EAAE,IAC5B,EAAE,CACJ,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,EAAC,GAAG,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAC,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,EAC1F,OAAO,EACP,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC/B,CAAC"}

package/dist/types/boolean-logic/operators/IsUnset.d.ts

@@ -0,0 +1,9 @@
+import { Unset, IsEqual } from "../../index";
+/**
+ * **IsUnset**`<T>`
+ *
+ * Boolean operator which reports true/false on whether
+ * `T` is the value `Unset`.
+ */
+export type IsUnset<T> = IsEqual<T, Unset>;
+//# sourceMappingURL=IsUnset.d.ts.map

package/dist/types/boolean-logic/operators/IsUnset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsUnset.d.ts","sourceRoot":"","sources":["../../../../src/types/boolean-logic/operators/IsUnset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAwB;AAGjD;;;;;GAKG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAC,KAAK,CAAC,CAAC"}

package/dist/types/boolean-logic/operators/IsUnset.js

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

package/dist/types/boolean-logic/operators/PhoneOperators.d.ts

@@ -0,0 +1,33 @@
+import { GetPhoneCountryCode, IsNever, IsTrue, PhoneCountryCode, PhoneNumber } from "../..";
+import { IsStringLiteral } from "./IsStringLiteral";
+/**
+ * **IsPhoneNumber**`<T>`
+ *
+ * Boolean operator which tests whether `T` has a
+ * type that supports it being a phone number.
+ *
+ * **Note:**
+ *
+ * - this utility relies on the using the `PhoneNumber<T>` validation
+ * technique to determine that whether it is a phone number but whereas
+ * this utility returns `T` _or_ and `ErrorCode` this produces a boolean
+ * outcome.
+ *
+ * **Related:** `PhoneNumber`, `HasPhoneCountryCode`
+ */
+export type IsPhoneNumber<T> = T extends string ? IsStringLiteral<T> extends true ? IsNever<PhoneNumber<T>> extends true ? false : true : boolean : false;
+/**
+ * **HasPhoneCountryCode**`<T>`
+ *
+ * Boolean operator which validates whether the passed in `T` has a country code leading it (ignoring any leading
+ * whitespace):
+ *
+ * - by default, the country code is not only parsed out of the phone number but also validated against an world
+ * wide index of valid country codes
+ * - if you want to just validate that user _attempted_ to express a country code then you can change the check by
+ * setting `TExplicit` to **false**.
+ *
+ * **Related:** `IsPhoneNumber`, `PhoneNumber`
+ */
+export type HasPhoneCountryCode<TPhone, TExplicit extends boolean = true> = TPhone extends string ? IsStringLiteral<TPhone> extends true ? IsTrue<TExplicit> extends true ? GetPhoneCountryCode<TPhone> extends PhoneCountryCode ? true : false : GetPhoneCountryCode<TPhone> extends "" ? false : true : boolean : false;
+//# sourceMappingURL=PhoneOperators.d.ts.map

package/dist/types/boolean-logic/operators/PhoneOperators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhoneOperators.d.ts","sourceRoot":"","sources":["../../../../src/types/boolean-logic/operators/PhoneOperators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIpD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC7C,eAAe,CAAC,CAAC,CAAC,SAAS,IAAI,GAC7B,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAClC,KAAK,GACL,IAAI,GACR,OAAO,GACP,KAAK,CAAC;AAGR;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,CAC7B,MAAM,EACN,SAAS,SAAS,OAAO,GAAG,IAAI,IAC9B,MAAM,SAAS,MAAM,GACvB,eAAe,CAAC,MAAM,CAAC,SAAS,IAAI,GAChC,MAAM,CAAC,SAAS,CAAC,SAAS,IAAI,GAC5B,mBAAmB,CAAC,MAAM,CAAC,SAAS,gBAAgB,GAClD,IAAI,GACJ,KAAK,GACP,mBAAmB,CAAC,MAAM,CAAC,SAAS,EAAE,GACpC,KAAK,GACL,IAAI,GACZ,OAAO,GACP,KAAK,CAAC"}

package/dist/types/boolean-logic/operators/PhoneOperators.js

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

package/dist/types/boolean-logic/operators/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./ApiOperators";
 export * from "./AllExtend";
 export * from "./AllLiteral";
 export * from "./AreSameType";
@@ -90,4 +91,6 @@ export * from "./IsFloat";
 export * from "./IsInteger";
 export * from "./IsUrl";
 export * from "./Network-operators";
+export * from "./PhoneOperators";
+export * from "./IsUnset";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/boolean-logic/operators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/boolean-logic/operators/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/boolean-logic/operators/index.ts"],"names":[],"mappings":"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"}

package/dist/types/boolean-logic/operators/index.js

@@ -1,3 +1,4 @@
+export * from "./ApiOperators.js";
 export * from "./AllExtend.js";
 export * from "./AllLiteral.js";
 export * from "./AreSameType.js";
@@ -90,3 +91,5 @@ export * from "./IsFloat.js";
 export * from "./IsInteger.js";
 export * from "./IsUrl.js";
 export * from "./Network-operators.js";
+export * from "./PhoneOperators.js";
+export * from "./IsUnset.js";

package/dist/types/dictionary/Keys.d.ts

@@ -1,9 +1,9 @@
-import type { Container, ObjectKey, UnionToTuple, NumericKeys, RemoveIndexKeys, IsVueRef, IsTuple, IsObjectLiteral } from "../index";
+import type { Container, ObjectKey, UnionToTuple, NumericKeys, RemoveIndexKeys, IsVueRef, IsTuple, IsObjectLiteral, AfterFirst, StartsWith, First, TupleToUnion, As, Tuple, IsWideUnion } from "../index";
 type _Keys<T extends object> = UnionToTuple<keyof RemoveIndexKeys<T>>;
 type GetKeys<T extends object> = IsVueRef<T> extends true ? ["value"] : _Keys<T> extends [symbol] ? ObjectKey[] : _Keys<T> extends [] ? UnionToTuple<keyof T> extends [ObjectKey] ? (keyof T)[] : ObjectKey[] : _Keys<T>;
 type ProcessObj<TContainer extends object> = GetKeys<TContainer>;
 type ProcessTuple<TContainer extends readonly unknown[]> = NumericKeys<TContainer> extends readonly number[] ? NumericKeys<TContainer> : never;
-type Process<TContainer extends Container> = TContainer extends readonly unknown[] ? IsTuple<TContainer> extends true ? ProcessTuple<TContainer> : number[] : TContainer extends object ? [IsObjectLiteral<RemoveIndexKeys<TContainer>>] extends [true] ? ProcessObj<RemoveIndexKeys<TContainer>> extends readonly (keyof TContainer)[] ? ProcessObj<RemoveIndexKeys<TContainer>> : ProcessObj<RemoveIndexKeys<TContainer>> : ObjectKey[] : never[];
+type Process<TContainer extends Container> = TContainer extends readonly unknown[] ? IsTuple<TContainer> extends true ? ProcessTuple<TContainer> extends readonly number[] ? ProcessTuple<TContainer> : never : number[] : TContainer extends object ? [IsObjectLiteral<RemoveIndexKeys<TContainer>>] extends [true] ? ProcessObj<RemoveIndexKeys<TContainer>> extends readonly (keyof TContainer & ObjectKey)[] ? As<ProcessObj<RemoveIndexKeys<TContainer>>, readonly ObjectKey[]> : never : ObjectKey[] : never[];
 /**
  * **Keys**`<TContainer>`
  *
@@ -18,8 +18,62 @@ type Process<TContainer extends Container> = TContainer extends readonly unknown
  * type K2 = Keys<Arr>;
  * ```
  *
- * **Related:** `ValidKey`
+ * **Related:** `ValidKey`, `PublicKeys`
  */
-export type Keys<TContainer extends Container> = Process<TContainer>;
+export type Keys<TContainer extends Container> = TContainer extends Tuple ? As<Process<TContainer>, readonly number[]> : As<Process<TContainer>, readonly ObjectKey[]>;
+type _Public<TInput extends readonly PropertyKey[], TOutput extends readonly PropertyKey[] = []> = [] extends TInput ? TOutput : _Public<AfterFirst<TInput>, First<TInput> extends string ? StartsWith<First<TInput>, "_"> extends true ? TOutput : [...TOutput, First<TInput>] : TOutput>;
+/**
+ * **PublicKeys**`<TContainer>`
+ *
+ * Provides a tuple of _keys_ for `TContainer` but unlike `Keys<T>` it removes any
+ * keys which start with an underscore character.
+ */
+export type PublicKeys<TContainer extends Container> = _Public<Keys<TContainer>>;
+/**
+ * **PrivateKey**
+ *
+ * A `PrivateKey` is an object key that is preceded with a `_` character to indicate
+ * that it is a _private_ property.
+ */
+export type PrivateKey = `_${string}`;
+/**
+ * **PrivateKeys**`<T>`
+ *
+ * Keys on an object which have a `_` character as first part of the
+ * name are considered private and this utility will create a union
+ * of all the keys in this category.
+ *
+ * **Related:** `PublicKeys`, `Keys`, `PrivateKeyOf`
+ */
+export type PrivateKeys<T extends object> = {
+    [K in keyof T]: K extends `_${string}` ? K : never;
+}[keyof T];
+type _KeyOf<TContainer extends Container> = TupleToUnion<Keys<TContainer>> extends PropertyKey ? TupleToUnion<Keys<TContainer>> extends keyof TContainer ? TupleToUnion<Keys<TContainer>> : never : never;
+/**
+ * **KeyOf**`<TContainer>`
+ *
+ * Provides a **union type** of keys for the passed in container.
+ *
+ * **Related:** `Keys`,`PublicKeys`,`PublicKeyOf`
+ */
+export type KeyOf<TContainer extends Container> = IsWideUnion<_KeyOf<TContainer>> extends true ? "" : As<_KeyOf<TContainer>, string | symbol>;
+/**
+ * **PublicKeyOf**`<TContainer>`
+ *
+ * Provides a **union type** of _public_ keys (aka, keys not starting with
+ * underscore character) for the passed in container.
+ *
+ * **Related:** `Keys`,`PublicKeys`,`KeyOf`
+ */
+export type PublicKeyOf<TContainer extends Container> = TupleToUnion<PublicKeys<TContainer>> extends PropertyKey ? TupleToUnion<PublicKeys<TContainer>> extends keyof TContainer ? TupleToUnion<PublicKeys<TContainer>> : never : never;
+/**
+ * **PrivateKeyOf**`<TContainer>`
+ *
+ * Provides a **union type** of _private_ keys (aka, keys starting with
+ * underscore character) for the passed in container.
+ *
+ * **Related:** `Keys`,`PrivateKeys`,`KeyOf`
+ */
+export type PrivateKeyOf<TContainer extends Container> = TupleToUnion<PrivateKeys<TContainer>> extends PropertyKey ? TupleToUnion<PublicKeys<TContainer>> extends keyof TContainer ? TupleToUnion<PublicKeys<TContainer>> : never : never;
 export {};
 //# sourceMappingURL=Keys.d.ts.map

package/dist/types/dictionary/Keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Keys.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/Keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,eAAe,EACf,QAAQ,EACR,OAAO,EACP,eAAe,EAChB,iBAAwB;AAEzB,KAAK,KAAK,CACV,CAAC,SAAS,MAAM,IACZ,YAAY,CAAC,MAAM,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAG3C,KAAK,OAAO,CACV,CAAC,SAAS,MAAM,IACd,QAAQ,CAAC,CAAC,CAAC,SAAS,IAAI,GAC1B,CAAC,OAAO,CAAC,GACT,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,GACvB,SAAS,EAAE,GACX,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,GACjB,YAAY,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,GACvC,CAAC,MAAM,CAAC,CAAC,EAAE,GACX,SAAS,EAAE,GACb,KAAK,CAAC,CAAC,CAAC,CAAC;AAEf,KAAK,UAAU,CACb,UAAU,SAAS,MAAM,IACvB,OAAO,CAAC,UAAU,CAAC,CAAA;AAEvB,KAAK,YAAY,CACf,UAAU,SAAS,SAAS,OAAO,EAAE,IACnC,WAAW,CAAC,UAAU,CAAC,SAAS,SAAS,MAAM,EAAE,GACnD,WAAW,CAAC,UAAU,CAAC,GACvB,KAAK,CAAC;AAER,KAAK,OAAO,CACZ,UAAU,SAAS,SAAS,IACxB,UAAU,SAAS,SAAS,OAAO,EAAE,GACvC,OAAO,CAAC,UAAU,CAAC,SAAS,IAAI,GAC9B,YAAY,CAAC,UAAU,CAAC,GACxB,MAAM,EAAE,GACV,UAAU,SAAS,MAAM,GACvB,CAAC,eAAe,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAC3D,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,UAAU,CAAC,EAAE,GAC3E,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,GACvC,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,GACzC,SAAS,EAAE,GACb,KAAK,EAAE,CAAC;AAEZ;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,IAAI,CACd,UAAU,SAAS,SAAS,IAC1B,OAAO,CAAC,UAAU,CAAC,CAAC"}
+{"version":3,"file":"Keys.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/Keys.ts"],"names":[],"mappings":"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"}

package/dist/types/dictionary/KvFn.d.ts

@@ -1,4 +1,4 @@
-import { Fn, FnDefn } from "../functions/Fn";
+import { FnWithDescription, FnDefn } from "../functions/FnWithDescription";
 /**
  * **KvFnDefn**
  *
@@ -11,5 +11,5 @@ export type KvFnDefn = [key: string, fn: FnDefn];
  * A succinct and strong type definition for a KV value pair where the
  * _value_ is a function.
  */
-export type KvFn<T extends KvFnDefn = KvFnDefn> = Record<T[0], Fn<T[1]>>;
+export type KvFn<T extends KvFnDefn = KvFnDefn> = Record<T[0], FnWithDescription<T[1]>>;
 //# sourceMappingURL=KvFn.d.ts.map

package/dist/types/dictionary/KvFn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KvFn.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/KvFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,IAAI,CACd,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAC3B,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"KvFn.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/KvFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,IAAI,CACd,CAAC,SAAS,QAAQ,GAAG,QAAQ,IAC3B,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/dictionary/MakeKeysOptional.d.ts

@@ -1,15 +1,24 @@
+import { ObjectKey } from "../base-types";
 import { Dictionary } from "../base-types/Dictionary";
+import { IsWideUnion } from "../boolean-logic";
 import { ExpandDictionary } from "../literals";
 import { WithKeys } from "./WithKeys";
 import { WithoutKeys } from "./WithoutKeys";
+type ProcessTupleKeys<TObj extends Dictionary, TKeys extends readonly ObjectKey[]> = ExpandDictionary<WithoutKeys<TObj, TKeys> & {
+    [K in keyof WithKeys<TObj, TKeys>]?: K extends keyof TObj ? TObj[K] : never;
+}>;
+type ProcessUnionKeys<TObj extends Dictionary, TKeys extends (string | symbol)> = ExpandDictionary<WithoutKeys<TObj, TKeys> & {
+    [K in keyof WithKeys<TObj, TKeys>]?: K extends keyof TObj ? TObj[K] : never;
+}>;
 /**
  * **MakeKeysOptional**`<TObj, TKeys>`
  *
  * Makes a set of keys on a known object `TObj` become
  * _optional_ parameters while leaving the other properties
  * "as is".
+ *
+ * **Related:** `MakeKeysRequired`
  */
-export type MakeKeysOptional<TObj extends Dictionary, TKeys extends readonly string[]> = ExpandDictionary<WithoutKeys<TObj, TKeys> & {
-    [K in keyof WithKeys<TObj, TKeys>]?: K extends keyof TObj ? TObj[K] : never;
-}>;
+export type MakeKeysOptional<TObj extends Dictionary, TKeys extends (string | symbol) | readonly ObjectKey[]> = TKeys extends readonly ObjectKey[] ? ProcessTupleKeys<TObj, TKeys> : TKeys extends (string | symbol) ? IsWideUnion<TKeys> extends true ? never : ProcessUnionKeys<TObj, TKeys> : never;
+export {};
 //# sourceMappingURL=MakeKeysOptional.d.ts.map

package/dist/types/dictionary/MakeKeysOptional.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MakeKeysOptional.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/MakeKeysOptional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAC1B,IAAI,SAAS,UAAU,EACvB,KAAK,SAAS,SAAS,MAAM,EAAE,IAC7B,gBAAgB,CAClB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG;KACxB,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,GACpD,IAAI,CAAC,CAAC,CAAC,GACP,KAAK;CACV,CACF,CAAA"}
+{"version":3,"file":"MakeKeysOptional.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/MakeKeysOptional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAG,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,KAAK,gBAAgB,CACnB,IAAI,SAAS,UAAU,EACvB,KAAK,SAAS,SAAS,SAAS,EAAE,IAChC,gBAAgB,CACpB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG;KACxB,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,GACpD,IAAI,CAAC,CAAC,CAAC,GACP,KAAK;CACV,CACA,CAAA;AAED,KAAK,gBAAgB,CACnB,IAAI,SAAS,UAAU,EACvB,KAAK,SAAS,CAAC,MAAM,GAAC,MAAM,CAAC,IAC3B,gBAAgB,CACpB,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG;KACxB,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,GACpD,IAAI,CAAC,CAAC,CAAC,GACP,KAAK;CACV,CACA,CAAA;AAGD;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,CAC1B,IAAI,SAAS,UAAU,EACvB,KAAK,SAAS,CAAC,MAAM,GAAC,MAAM,CAAC,GAAG,SAAS,SAAS,EAAE,IAClD,KAAK,SAAS,SAAS,SAAS,EAAE,GACpC,gBAAgB,CAAC,IAAI,EAAC,KAAK,CAAC,GAC5B,KAAK,SAAS,CAAC,MAAM,GAAC,MAAM,CAAC,GAC3B,WAAW,CAAC,KAAK,CAAC,SAAS,IAAI,GAC7B,KAAK,GACL,gBAAgB,CAAC,IAAI,EAAC,KAAK,CAAC,GAChC,KAAK,CAAC"}

package/dist/types/dictionary/MakeKeysRequired.d.ts

@@ -0,0 +1,14 @@
+import { Dictionary, ExpandDictionary, ObjectKey, WithKeys, WithoutKeys } from "../index";
+/**
+ * **MakeKeysRequired**`<TObj, TKeys>`
+ *
+ * Makes a set of keys on a known object `TObj` become
+ * _optional_ parameters while leaving the other properties
+ * "as is".
+ *
+ * **Related:** `MakeKeysOptional`
+ */
+export type MakeKeysRequired<TObj extends Dictionary, TKeys extends (string | symbol) | readonly ObjectKey[]> = ExpandDictionary<WithoutKeys<TObj, TKeys> & {
+    [K in keyof WithKeys<TObj, TKeys>]: K extends keyof TObj ? TObj[K] : never;
+}>;
+//# sourceMappingURL=MakeKeysRequired.d.ts.map

package/dist/types/dictionary/MakeKeysRequired.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MakeKeysRequired.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/MakeKeysRequired.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAwB;AAGjG;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,CAC1B,IAAI,SAAS,UAAU,EACvB,KAAK,SAAS,CAAC,MAAM,GAAC,MAAM,CAAC,GAAG,SAAS,SAAS,EAAE,IAClD,gBAAgB,CAClB,WAAW,CAAC,IAAI,EAAC,KAAK,CAAC,GACvB;KACG,CAAC,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAC,KAAK,CAAC,GAAG,CAAC,SAAS,MAAM,IAAI,GACnD,IAAI,CAAC,CAAC,CAAC,GACP,KAAK;CACV,CACF,CAAA"}

package/dist/types/dictionary/MakeKeysRequired.js

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

package/dist/types/dictionary/OptionalKeys.d.ts

@@ -1,11 +1,26 @@
+import { AnyObject, If, IsEqual, Unset } from "../index";
 /**
- * **OptionalKeys**`<T>`
+ * **OptionalKeys**`<T,[V]>`
  *
- * Extracts the _optional_ keys in the object's type.
+ * Provides a union type of the _keys_ in `T` which are
+ * **optional** properties.
+ *
+ * **Note:** you also may optionally filter further by specifying a value
+ * by the _value_ of the key and then only keys which are required AND
+ * who extend `V` will be included in the union.
+ *
+ * **Related:** `OptionalKeys`, `RequiredProps` * Provides a union type of the _keys_ in `T` which are
+ * **required** properties.
+ *
+ * **Note:** you also may optionally filter further by specifying a value
+ * by the _value_ of the key and then only keys which are required AND
+ * who extend `V` will be included in the union.
+ *
+ * **Related:** `RequiredKeys`, `RequiredProps`
  */
-export type OptionalKeys<T extends object> = {
+export type OptionalKeys<T extends AnyObject, V = Unset> = {
     [K in keyof T]-?: {} extends {
         [P in K]: T[K];
-    } ? K : never;
+    } ? If<IsEqual<V, Unset>, K, K extends V ? K : never> : never;
 }[keyof T];
 //# sourceMappingURL=OptionalKeys.d.ts.map

package/dist/types/dictionary/OptionalKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OptionalKeys.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/OptionalKeys.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;KAC1C,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS;SAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAAE,GAC3C,CAAC,GACD,KAAK;CACV,CAAC,MAAM,CAAC,CAAC,CAAC"}
+{"version":3,"file":"OptionalKeys.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/OptionalKeys.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EACT,EAAE,EACF,OAAO,EACP,KAAK,EACL,iBAAwB;AAE1B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,YAAY,CACtB,CAAC,SAAS,SAAS,EACnB,CAAC,GAAG,KAAK,IACP;KACD,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS;SAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAAE,GAC3C,EAAE,CAAC,OAAO,CAAC,CAAC,EAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAChD,KAAK;CACV,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/types/dictionary/OptionalKeys.js

@@ -1 +1,2 @@
+/* eslint-disable @typescript-eslint/ban-types */
 export {};

package/dist/types/dictionary/RequiredKeys.d.ts

@@ -1,11 +1,19 @@
-import { AnyObject } from "../index";
+import { As, Dictionary, IfUnset, ObjectKey, Unset } from "../index";
 /**
- * Extracts the _required_ keys in the object's type. You also may
- * optionally filter by the _value_ of the key.
+ * **RequiredKeys**`<T,[V]>`
+ *
+ * Provides a union type of the _keys_ in `T` which are
+ * **required** properties.
+ *
+ * **Note:** you also may optionally filter further by specifying a value
+ * by the _value_ of the key and then only keys which are required AND
+ * who extend `V` will be included in the union.
+ *
+ * **Related:** `OptionalKeys`, `RequiredProps`
  */
-export type RequiredKeys<T extends AnyObject, V = unknown> = {
+export type RequiredKeys<T extends Dictionary, V = Unset> = As<{
     [K in keyof T]-?: {} extends {
         [P in K]: T[K];
-    } ? never : T[K] extends V ? K : never;
-}[keyof T];
+    } ? never : IfUnset<V, K, T[K] extends V ? K : never>;
+}[keyof T], ObjectKey>;
 //# sourceMappingURL=RequiredKeys.d.ts.map

package/dist/types/dictionary/RequiredKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RequiredKeys.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/RequiredKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAwB;AAE5C;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,GAAG,OAAO,IAAI;KAE1D,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS;SAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAAE,GAC3C,KAAK,GACL,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GACd,CAAC,GACD,KAAK;CACV,CAAC,MAAM,CAAC,CAAC,CAAC"}
+{"version":3,"file":"RequiredKeys.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/RequiredKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAG,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAwB;AAE7E;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,CACtB,CAAC,SAAS,UAAU,EACpB,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;KAEf,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS;SAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAAE,GAC3C,KAAK,GACL,OAAO,CACL,CAAC,EACD,CAAC,EACD,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GACV,CAAC,GACD,KAAK,CACV;CACN,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC"}

package/dist/types/dictionary/Values.d.ts

@@ -1,4 +1,4 @@
-import { Container, Dictionary, ObjectKey, Tuple } from "../base-types";
+import { Container, Dictionary, ObjectKey, Tuple, TypedFunction } from "../base-types";
 import { AfterFirst, First } from "../lists";
 import { Keys } from "./Keys";
 type Process<TKeys extends readonly ObjectKey[], TObj extends Record<ObjectKey, unknown>, TResult extends readonly unknown[] = []> = [] extends TKeys ? TResult : Process<AfterFirst<TKeys>, TObj, [
@@ -13,6 +13,6 @@ type Process<TKeys extends readonly ObjectKey[], TObj extends Record<ObjectKey,
  * - for **tuples** this is just a _proxy_ of the type
  * - for _wide_ types like `string[]`
  */
-export type Values<T extends Container> = T extends Tuple ? T : T extends Dictionary ? Process<Keys<T> extends readonly ObjectKey[] ? Keys<T> : never, T> : [];
+export type Values<T extends Container> = T extends Tuple ? T : T extends Dictionary ? Process<Keys<T> extends readonly ObjectKey[] ? Keys<T> : never, T> : T extends TypedFunction ? [T] : [];
 export {};
 //# sourceMappingURL=Values.d.ts.map

package/dist/types/dictionary/Values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Values.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/Values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B,KAAK,OAAO,CACV,KAAK,SAAS,SAAS,SAAS,EAAE,EAClC,IAAI,SAAS,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACvC,OAAO,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,IACrC,EAAE,SAAS,KAAK,GAClB,OAAO,GACP,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,EACjB,IAAI,EACJ;IACE,GAAG,OAAO;IACV,KAAK,CAAC,KAAK,CAAC,SAAS,MAAM,IAAI,GAC3B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAClB,KAAK;CACV,CACF,CAAA;AAGH;;;;;;;GAOG;AACH,MAAM,MAAM,MAAM,CAChB,CAAC,SAAS,SAAS,IACjB,CAAC,SAAS,KAAK,GACjB,CAAC,GACD,CAAC,SAAS,UAAU,GAClB,OAAO,CACL,IAAI,CAAC,CAAC,CAAC,SAAS,SAAS,SAAS,EAAE,GAChC,IAAI,CAAC,CAAC,CAAC,GACP,KAAK,EACT,CAAC,CACF,GACD,EAAE,CAAC"}
+{"version":3,"file":"Values.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/Values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B,KAAK,OAAO,CACV,KAAK,SAAS,SAAS,SAAS,EAAE,EAClC,IAAI,SAAS,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACvC,OAAO,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,IACrC,EAAE,SAAS,KAAK,GAClB,OAAO,GACP,OAAO,CACL,UAAU,CAAC,KAAK,CAAC,EACjB,IAAI,EACJ;IACE,GAAG,OAAO;IACV,KAAK,CAAC,KAAK,CAAC,SAAS,MAAM,IAAI,GAC3B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAClB,KAAK;CACV,CACF,CAAA;AAGH;;;;;;;GAOG;AACH,MAAM,MAAM,MAAM,CAChB,CAAC,SAAS,SAAS,IACjB,CAAC,SAAS,KAAK,GACjB,CAAC,GACD,CAAC,SAAS,UAAU,GAClB,OAAO,CACL,IAAI,CAAC,CAAC,CAAC,SAAS,SAAS,SAAS,EAAE,GAChC,IAAI,CAAC,CAAC,CAAC,GACP,KAAK,EACT,CAAC,CACF,GACD,CAAC,SAAS,aAAa,GACrB,CAAC,CAAC,CAAC,GAEL,EAAE,CAAC"}

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

@@ -10,8 +10,6 @@ export * from "./MaybeRef";
 export * from "./FromMaybeRef";
 export * from "./RequiredProps";
 export * from "./OptionalProps";
-export * from "./PrivateKeys";
-export * from "./PublicKeys";
 export * from "./StringKeys";
 export * from "./NonStringKeys";
 export * from "./KeysWithValue";
@@ -45,4 +43,5 @@ export * from "./CreateLookup";
 export * from "./MergeKVs";
 export * from "./TakeProp";
 export * from "./MakeKeysOptional";
+export * from "./MakeKeysRequired";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/index.ts"],"names":[],"mappings":"AAMA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/dictionary/index.ts"],"names":[],"mappings":"AAMA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

package/dist/types/dictionary/index.js

@@ -15,8 +15,6 @@ export * from "./MaybeRef.js";
 export * from "./FromMaybeRef.js";
 export * from "./RequiredProps.js";
 export * from "./OptionalProps.js";
-export * from "./PrivateKeys.js";
-export * from "./PublicKeys.js";
 export * from "./StringKeys.js";
 export * from "./NonStringKeys.js";
 export * from "./KeysWithValue.js";
@@ -50,6 +48,7 @@ export * from "./CreateLookup.js";
 export * from "./MergeKVs.js";
 export * from "./TakeProp.js";
 export * from "./MakeKeysOptional.js";
+export * from "./MakeKeysRequired.js";
 // #endregion auto-indexed files
 // see https://github.com/inocan-group/do-devops/docs/autoindex.md
 // for more info

package/dist/types/errors/KindError.d.ts

@@ -23,7 +23,7 @@ import { PascalCase, KebabCase } from "../index";
  * BadJuju("oh my god!", { flavor: "strawberry"})
  * ```
  */
-export interface KindError<K extends string, C extends Record<string, unknown> = NonNullable<unknown>> extends Error {
+export interface KindError<K extends string, C extends Record<string, unknown> | undefined> extends Error {
     __kind: "KindError";
     name: PascalCase<K>;
     kind: KebabCase<K>;

package/dist/types/errors/KindError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KindError.d.ts","sourceRoot":"","sources":["../../../src/types/errors/KindError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,SAAS,EAAC,iBAAwB;AAEtD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,SAAS,CACxB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,CACxD,SAAQ,KAAK;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,IACtD,CACF,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,CAAC,KACR,SAAS,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"KindError.d.ts","sourceRoot":"","sources":["../../../src/types/errors/KindError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,SAAS,EAAC,iBAAwB;AAEtD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,SAAS,CACxB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAC7C,SAAQ,KAAK;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CACvB,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,IACtD,CACF,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,CAAC,KACR,SAAS,CAAC,CAAC,EAAC,CAAC,CAAC,CAAC"}

package/dist/types/functions/FnFrom.d.ts

@@ -1,3 +1,8 @@
 import { Dictionary, EmptyObject, Tuple } from "../base-types";
+/**
+ * **FnFrom**`<TParams,[TReturn],[TProps]>`
+ *
+ * Type utility  to build a type from it's constituent parts.
+ */
 export type FnFrom<TParams extends Tuple, TReturn = unknown, TProps extends Dictionary = EmptyObject> = TProps extends EmptyObject ? <T extends TParams>(...args: T) => TReturn : (<T extends TParams>(...args: T) => TReturn) & TProps;
 //# sourceMappingURL=FnFrom.d.ts.map

package/dist/types/functions/FnFrom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FnFrom.d.ts","sourceRoot":"","sources":["../../../src/types/functions/FnFrom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAG/D,MAAM,MAAM,MAAM,CAChB,OAAO,SAAS,KAAK,EACrB,OAAO,GAAG,OAAO,EACjB,MAAM,SAAS,UAAU,GAAG,WAAW,IACrC,MAAM,SAAS,WAAW,GAC5B,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,GAC1C,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,MAAM,CAAA"}
+{"version":3,"file":"FnFrom.d.ts","sourceRoot":"","sources":["../../../src/types/functions/FnFrom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,MAAM,CAChB,OAAO,SAAS,KAAK,EACrB,OAAO,GAAG,OAAO,EACjB,MAAM,SAAS,UAAU,GAAG,WAAW,IACrC,MAAM,SAAS,WAAW,GAC5B,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,GAC1C,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,GAAG,MAAM,CAAA"}

package/dist/types/functions/{Fn.d.ts → FnWithDescription.d.ts}

@@ -3,7 +3,7 @@ export type FnDefn = [fn: AnyFunction] | [fn: AnyFunction, desc: string] | [fn:
 /**
  * **Fn**`<TArgs,TReturn>`
  */
-export type Fn<TFn extends FnDefn = FnDefn> = TFn extends [fn: AnyFunction] ? TFn[0] : TFn extends [fn: AnyFunction, desc: string] ? TFn[0] & {
+export type FnWithDescription<TFn extends FnDefn = FnDefn> = TFn extends [fn: AnyFunction] ? TFn[0] : TFn extends [fn: AnyFunction, desc: string] ? TFn[0] & {
     desc: TFn[1];
 } : TFn extends [fn: AnyFunction, props: Record<ObjectKey, unknown>] ? TFn[0] & TFn[1] : never;
-//# sourceMappingURL=Fn.d.ts.map
+//# sourceMappingURL=FnWithDescription.d.ts.map

package/dist/types/functions/FnWithDescription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FnWithDescription.d.ts","sourceRoot":"","sources":["../../../src/types/functions/FnWithDescription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,MAAM,MAAM,GAAG,CAAC,EAAE,EAAE,WAAW,CAAE,GACrC,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,GAC/B,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAE,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAC3B,GAAG,SAAS,MAAM,GAAG,MAAM,IACzB,GAAG,SAAS,CAAE,EAAE,EAAE,WAAW,CAAE,GACjC,GAAG,CAAC,CAAC,CAAC,GACN,GAAG,SAAS,CAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,GAC1C,GAAG,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;CAAE,GACzB,GAAG,SAAS,CAAE,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAE,GAChE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GACf,KAAK,CAAC"}

package/dist/types/functions/FnWithDescription.js

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

package/dist/types/functions/WrapperFn.d.ts

@@ -0,0 +1,23 @@
+import { Container, TypedFunction } from "../base-types";
+import { If, IsUnset } from "../boolean-logic";
+import { Unset } from "../literals";
+import { FnFrom } from "./FnFrom";
+import { AsNarrowingFn } from "./NarrowingFn";
+/**
+ * **WrapperFn**`<TFn,TTransform,[TState]>`
+ *
+ * A function which consumes a known function `TFn` and exposes the
+ * same parameters externally while allowing it to _transform_ the
+ * original functions return value before completing.
+ *
+ * Optionally, you can express some amount of _state_ which will be available
+ * to the `TTransform` function to do it's work.
+ *
+ * ```ts
+ * type Fn = (name: string) => `Hello ${string}`;
+ * // (name: string) => `Hello ${name}!`;
+ * type Wrapped = WrapperFn<Fn, v => `${v}!`>
+ * ```
+ */
+export type WrapperFn<TFn extends TypedFunction, TTransform extends <TRtn extends ReturnType<TFn>>(rtn: TRtn) => unknown, TState extends Container | Unset = Unset> = If<IsUnset<TState>, FnFrom<Parameters<TFn>, ReturnType<AsNarrowingFn<TTransform>>>, <T extends TState>(state: T) => FnFrom<Parameters<TFn>, ReturnType<AsNarrowingFn<TTransform>>>>;
+//# sourceMappingURL=WrapperFn.d.ts.map

package/dist/types/functions/WrapperFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WrapperFn.d.ts","sourceRoot":"","sources":["../../../src/types/functions/WrapperFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,CACnB,GAAG,SAAS,aAAa,EACzB,UAAU,SAAS,CAAC,IAAI,SAAS,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,KAAK,OAAO,EACvE,MAAM,SAAS,SAAS,GAAG,KAAK,GAAG,KAAK,IACtC,EAAE,CACJ,OAAO,CAAC,MAAM,CAAC,EACf,MAAM,CACJ,UAAU,CAAC,GAAG,CAAC,EACf,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CACtC,EACD,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,MAAM,CACpC,UAAU,CAAC,GAAG,CAAC,EACf,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CACtC,CACF,CAAC"}

package/dist/types/functions/WrapperFn.js

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

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

@@ -7,9 +7,10 @@ export * from "./FnMeta";
 export * from "./FnFrom";
 export * from "./PromiseAll";
 export * from "./FnProps";
-export * from "./Fn";
+export * from "./FnWithDescription";
 export * from "./HandleDoneFn";
 export * from "./NarrowingFn";
 export * from "./LiteralFn";
 export * from "./IdentityFn";
+export * from "./WrapperFn";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/functions/index.ts"],"names":[],"mappings":"AAMA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/functions/index.ts"],"names":[],"mappings":"AAMA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA"}

package/dist/types/functions/index.js

@@ -12,11 +12,12 @@ export * from "./FnMeta.js";
 export * from "./FnFrom.js";
 export * from "./PromiseAll.js";
 export * from "./FnProps.js";
-export * from "./Fn.js";
+export * from "./FnWithDescription.js";
 export * from "./HandleDoneFn.js";
 export * from "./NarrowingFn.js";
 export * from "./LiteralFn.js";
 export * from "./IdentityFn.js";
+export * from "./WrapperFn.js";
 // export * from "src/types/index";
 // #endregion auto-indexed files
 // see https://github.com/inocan-group/do-devops/docs/autoindex.md

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

@@ -1,6 +1,6 @@
-import { Narrowable, AfterFirst, FindExtends, First } from "../index";
+import { Narrowable, AfterFirst, First, Find } from "../index";
 export type ConversionTuple = [from: Narrowable, to: Narrowable];
-type Convert<TValue, TConversions extends readonly ConversionTuple[]> = FindExtends<TConversions, TValue, 0> extends ConversionTuple ? FindExtends<TConversions, TValue, 0>[1] : TValue;
+type Convert<TValue, TConversions extends readonly ConversionTuple[]> = Find<TConversions, "extends", TValue, 0> extends ConversionTuple ? Find<TConversions, "extends", TValue, 0>[1] : TValue;
 type ConvertAcc<TSet extends readonly unknown[], TConversions extends readonly ConversionTuple[], TResults extends readonly unknown[] = []> = [] extends TSet ? TResults : ConvertAcc<AfterFirst<TSet>, TConversions, [
     ...TResults,
     Convert<First<TSet>, TConversions>

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

@@ -1 +1 @@
-{"version":3,"file":"ConvertSet.d.ts","sourceRoot":"","sources":["../../../src/types/lists/ConvertSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAG,UAAU,EAAG,WAAW,EAAG,KAAK,EAAE,iBAAwB;AAEhF,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;AAEjE,KAAK,OAAO,CACV,MAAM,EACN,YAAY,SAAS,SAAS,eAAe,EAAE,IAC7C,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,eAAe,GAC5D,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GACvC,MAAM,CAAC;AAEX,KAAK,UAAU,CACb,IAAI,SAAS,SAAS,OAAO,EAAE,EAC/B,YAAY,SAAS,SAAS,eAAe,EAAE,EAC/C,QAAQ,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,IACtC,EAAE,SAAS,IAAI,GACf,QAAQ,GACR,UAAU,CACR,UAAU,CAAC,IAAI,CAAC,EAChB,YAAY,EACZ;IAAE,GAAG,QAAQ;IAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;CAAE,CACpD,CAAC;AAEN;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,CACpB,IAAI,SAAS,SAAS,OAAO,EAAE,EAC/B,YAAY,SAAS,eAAe,GAAG,SAAS,eAAe,EAAE,IAC/D,YAAY,SAAS,SAAS,eAAe,EAAE,GAC/C,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,GAC9B,YAAY,SAAS,eAAe,GAClC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,GACzC,KAAK,CAAC"}
+{"version":3,"file":"ConvertSet.d.ts","sourceRoot":"","sources":["../../../src/types/lists/ConvertSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAG,UAAU,EAAI,KAAK,EAAE,IAAI,EAAE,iBAAwB;AAEzE,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;AAEjE,KAAK,OAAO,CACV,MAAM,EACN,YAAY,SAAS,SAAS,eAAe,EAAE,IAC7C,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,eAAe,GAChE,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAC3C,MAAM,CAAC;AAEX,KAAK,UAAU,CACb,IAAI,SAAS,SAAS,OAAO,EAAE,EAC/B,YAAY,SAAS,SAAS,eAAe,EAAE,EAC/C,QAAQ,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,IACtC,EAAE,SAAS,IAAI,GACf,QAAQ,GACR,UAAU,CACR,UAAU,CAAC,IAAI,CAAC,EAChB,YAAY,EACZ;IAAE,GAAG,QAAQ;IAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;CAAE,CACpD,CAAC;AAEN;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,CACpB,IAAI,SAAS,SAAS,OAAO,EAAE,EAC/B,YAAY,SAAS,eAAe,GAAG,SAAS,eAAe,EAAE,IAC/D,YAAY,SAAS,SAAS,eAAe,EAAE,GAC/C,UAAU,CAAC,IAAI,EAAE,YAAY,CAAC,GAC9B,YAAY,SAAS,eAAe,GAClC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC,GACzC,KAAK,CAAC"}