inferred-types 0.42.1 → 0.43.1

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

@@ -1 +1 @@
-{"version":3,"file":"withKeys.d.ts","sourceRoot":"","sources":["../../../src/runtime/dictionary/withKeys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,0BAAwB;AAG7D;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;sdAOK,CAAC"}
+{"version":3,"file":"withKeys.d.ts","sourceRoot":"","sources":["../../../src/runtime/dictionary/withKeys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,0BAAwB;AAIzE;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,+HAKb,IAAI,WACD,KAAK;;;;;;;8sBACU,CAAC"}

package/dist/runtime/dictionary/withKeys.js

@@ -1,4 +1,4 @@
-import { retain } from "../index.js";
+import { retain } from "./retain.js";
 /**
  * **withKeys**(obj,keys)
  *

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

@@ -9,10 +9,17 @@ import type { NarrowObject, Narrowable } from "../../types/index";
  *
  * **Related**: `omit`, `createOmission`
  */
-export declare const withoutKeys: <TObj extends NarrowObject<N>, N extends Narrowable, TKeys extends readonly (string & keyof TObj)[]>(dict: TObj, ...exclude: TKeys) => ([] extends [...TKeys] ? false : import("../../types/index").IfUnion<import("../../types/index").First<[...TKeys]>, true, [] extends import("../../types/index").AfterFirst<[...TKeys]> ? false : import("../../types/index").IfUnion<import("../../types/index").First<import("../../types/index").AfterFirst<[...TKeys]>>, true, [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>> ? false : import("../../types/index").IfUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>, true, [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>> ? false : import("../../types/index").IfUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>, true, [] extends import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>> ? false : import("../../types/index").IfUnion<import("../../types/index").First<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<import("../../types/index").AfterFirst<[...TKeys]>>>>>, 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").IfUnion<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]>>>>>>, 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").IfUnion<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]>>>>>>>, 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").IfUnion<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]>>>>>>>>, 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").IfUnion<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]>>>>>>>>>, 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").IfUnion<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]>>>>>>>>>>, 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").IfUnion<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]>>>>>>>>>>>, true, any>>>>>>>>>>>) extends true ? import("../../types/index").ErrorCondition<"invalid-union", "the omit(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.", {
-    context: {
-        keys: [...TKeys];
-    };
-    library: "omit";
-}> : import("../../types/index").IfLength<import("../../types/index").AsArray<[...TKeys]>, 0, TObj, import("../../types/index").ExpandRecursively<Omit<TObj, import("../../types/index").TupleToUnion<import("../../types/index").AsArray<[...TKeys]>>>> extends import("../../types/index").EmptyObject ? import("../../types/index").EmptyObject : import("../../types/index").ExpandRecursively<Omit<TObj, import("../../types/index").TupleToUnion<import("../../types/index").AsArray<[...TKeys]>>>>, TObj | (import("../../types/index").ExpandRecursively<Omit<TObj, import("../../types/index").TupleToUnion<import("../../types/index").AsArray<[...TKeys]>>>> extends import("../../types/index").EmptyObject ? import("../../types/index").EmptyObject : import("../../types/index").ExpandRecursively<Omit<TObj, import("../../types/index").TupleToUnion<import("../../types/index").AsArray<[...TKeys]>>>>)>;
+export declare const withoutKeys: <TObj extends NarrowObject<N>, N extends Narrowable, TKeys extends readonly (string & keyof TObj)[]>(dict: TObj, ...exclude: TKeys) => import("../../types/index").ExpandRecursively<import("../../types/index").RemoveIndexKeys<import("../../types/index").IfLength<import("../../types/index").AsArray<[...TKeys]>, 0, TObj, import("../../types/index").ExpandRecursively<Omit<TObj, import("../../types/index").TupleToUnion<import("../../types/index").AsArray<[...TKeys]>>>> extends {
+    [x: string]: never;
+    [x: symbol]: never;
+} ? {
+    [x: string]: never;
+    [x: symbol]: never;
+} : import("../../types/index").ExpandRecursively<Omit<TObj, import("../../types/index").TupleToUnion<import("../../types/index").AsArray<[...TKeys]>>>>, TObj | (import("../../types/index").ExpandRecursively<Omit<TObj, import("../../types/index").TupleToUnion<import("../../types/index").AsArray<[...TKeys]>>>> extends {
+    [x: string]: never;
+    [x: symbol]: never;
+} ? {
+    [x: string]: never;
+    [x: symbol]: never;
+} : import("../../types/index").ExpandRecursively<Omit<TObj, import("../../types/index").TupleToUnion<import("../../types/index").AsArray<[...TKeys]>>>>)>>>;
 //# sourceMappingURL=withoutKeys.d.ts.map

package/dist/runtime/dictionary/withoutKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withoutKeys.d.ts","sourceRoot":"","sources":["../../../src/runtime/dictionary/withoutKeys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,0BAAwB;AAGhE;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW;;;;;03BAOG,CAAC"}
+{"version":3,"file":"withoutKeys.d.ts","sourceRoot":"","sources":["../../../src/runtime/dictionary/withoutKeys.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,0BAAwB;AAIhE;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,6GAKhB,IAAI,cACE,KAAK;;;;;;;;;;;;4JACQ,CAAC"}

package/dist/runtime/dictionary/withoutValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withoutValue.d.ts","sourceRoot":"","sources":["../../../src/runtime/dictionary/withoutValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,0BAAwB;AAEtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,UAAU,EAAE,GAAG,EAAE,IAAI,mEAS9D"}
+{"version":3,"file":"withoutValue.d.ts","sourceRoot":"","sources":["../../../src/runtime/dictionary/withoutValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,0BAAwB;AAEtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,UAAU,EAAE,GAAG,EAAE,IAAI,iCACxB,IAAI,KAAG,aAAa,IAAI,EAAC,IAAI,CAAC,CAQpE"}

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

@@ -0,0 +1,27 @@
+import { KindErrorDefn } from "../../types/index";
+/**
+ * **KindError**
+ *
+ * An error which:
+ *
+ * - must have a "kind" type defined which can be used to categorize the error
+ * - is allowed to express other key/value pairs in the `context` property
+ *
+ * This error is generated with the `kindError(kind, _defineContext) => (msg, ctx)`
+ * higher order function.
+ *
+ * ```ts
+ * // Defines the Error
+ * const BadJuju = kindError("bad-juju", { flavor?: "" });
+ * // BadJuju {
+ * //     name: BadJuju;
+ * //     kind: "bad-juju";
+ * //     msg: "oh my god!";
+ * //     context: { flavor?: string}
+ * // }
+ * BadJuju("oh my god!");
+ * BadJuju("oh my god!", { flavor: "strawberry"})
+ * ```
+ */
+export declare const kindError: <K extends string, C extends Record<string, unknown> = {}>(kind: K, _defineContext?: C) => KindErrorDefn<K, C>;
+//# sourceMappingURL=KindError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KindError.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/KindError.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,aAAa,EAAE,0BAAwB;AAGzF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,SAAS,mEAId,CAAC,mBACU,CAAC,KACjB,cAAc,CAAC,EAAC,CAAC,CAkBnB,CAAA"}

package/dist/runtime/errors/KindError.js

@@ -0,0 +1,33 @@
+import { toKebabCase, toPascalCase } from "../index.js";
+/**
+ * **KindError**
+ *
+ * An error which:
+ *
+ * - must have a "kind" type defined which can be used to categorize the error
+ * - is allowed to express other key/value pairs in the `context` property
+ *
+ * This error is generated with the `kindError(kind, _defineContext) => (msg, ctx)`
+ * higher order function.
+ *
+ * ```ts
+ * // Defines the Error
+ * const BadJuju = kindError("bad-juju", { flavor?: "" });
+ * // BadJuju {
+ * //     name: BadJuju;
+ * //     kind: "bad-juju";
+ * //     msg: "oh my god!";
+ * //     context: { flavor?: string}
+ * // }
+ * BadJuju("oh my god!");
+ * BadJuju("oh my god!", { flavor: "strawberry"})
+ * ```
+ */
+export const kindError = (kind, _defineContext) => (msg, context) => {
+    const err = new Error(msg);
+    err.name = toPascalCase(kind);
+    err.kind = toKebabCase(kind);
+    err.__kind = "KindError";
+    err.context = context;
+    return err;
+};

package/dist/runtime/errors/TypedError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TypedError.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/TypedError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAI,SAAS,EAAkB,UAAU,EAAI,0BAAwB;AAE5E,MAAM,WAAW,UAAU,CACzB,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,QAAQ,SAAS,SAAS,GAAG,SAAS,CACtC,SAAQ,KAAK;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;IACV,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,MAAM,IAAI,CAC5C,IAAI,SAAS,MAAM,EACnB,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,UAAU,EACpB,QAAQ,SAAS,MAAM,CAAC,CAAC,EAAC,CAAC,CAAC,EAC5B,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,UAAU,CAAC,KAAK,EAAC,IAAI,EAAC,QAAQ,CAAC,CAAC;AAEpE,MAAM,MAAM,QAAQ,GAAG;IACrB;;OAEG;IACH,MAAM,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,EAC9C,IAAI,EAAE,KAAK,EACX,GAAG,EAAE,IAAI,GAAG,UAAU,CAAC,IAAI,EAAC,KAAK,CAAC,CAAC;IAErC;;;;OAIG;IACH,MAAM,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;CAC7D,CAAC;AAyBF,eAAO,MAAM,UAAU;;;;aAA2B,CAAC"}
+{"version":3,"file":"TypedError.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/TypedError.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAe,UAAU,EAAG,0BAAwB;AAGtE,MAAM,WAAW,UAAU,CACzB,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,QAAQ,SAAS,SAAS,GAAG,SAAS,CACtC,SAAQ,KAAK;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;IACV,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,KAAK,SAAS,MAAM,IAAI,CAC5C,IAAI,SAAS,MAAM,EACnB,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,UAAU,EACpB,QAAQ,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAC7B,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAEtE,MAAM,MAAM,QAAQ,GAAG;IACrB;;OAEG;IACH,MAAM,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,EAC9C,IAAI,EAAE,KAAK,EACX,GAAG,EAAE,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAEtC;;;;OAIG;IACH,MAAM,CAAC,KAAK,SAAS,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;CAC7D,CAAC;AAyBF,eAAO,MAAM,UAAU,8BAPkB,IAAI;;;;aAOK,CAAC"}

package/dist/runtime/errors/createErrorCondition.d.ts

@@ -1,11 +1,9 @@
-import { ErrorCondition } from "../../types/index";
+import { Throw } from "../../types/index";
 /**
- * **createErrorConditionTemplate**(domain) => (kind) => (msg) => ErrorCondition
+ * **createErrorConditionTemplate**`(kind,[msg],[utility]) => ErrorCondition`
  *
  * A higher order runtime utility for generating reusable `ErrorCondition`'s at
  * runtime.
  */
-export declare const createErrorCondition: <TLibrary extends string = "undefined">(library?: TLibrary | undefined) => <TKind extends string>(kind: TKind) => <TMsg extends string = "">(message: TMsg) => ErrorCondition<TKind, TMsg, {
-    library: TLibrary;
-}>;
+export declare const createErrorCondition: <TKind extends string, TMsg extends string = never, TUtility extends string = never>(kind: TKind, msg?: TMsg, utility?: TUtility) => Throw<TKind, TMsg, TUtility>;
 //# sourceMappingURL=createErrorCondition.d.ts.map

package/dist/runtime/errors/createErrorCondition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createErrorCondition.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/createErrorCondition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,0BAAwB;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;EAahC,CAAC"}
+{"version":3,"file":"createErrorCondition.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/createErrorCondition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,0BAAwB;AAGxC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,6FAKzB,KAAK,QACN,IAAI,YACA,QAAQ,iCAQlB,CAAC"}

package/dist/runtime/errors/createErrorCondition.js

@@ -1,14 +1,14 @@
 /**
- * **createErrorConditionTemplate**(domain) => (kind) => (msg) => ErrorCondition
+ * **createErrorConditionTemplate**`(kind,[msg],[utility]) => ErrorCondition`
  *
  * A higher order runtime utility for generating reusable `ErrorCondition`'s at
  * runtime.
  */
-export const createErrorCondition = (library) => (kind) => (message) => {
+export const createErrorCondition = (kind, msg = "", utility = "") => {
     return {
-        _type: "ErrorCondition",
-        library,
+        __kind: "ErrorCondition",
         kind,
-        message: message || ""
+        msg,
+        utility,
     };
 };

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

@@ -1,2 +1,3 @@
 export * from "./createErrorCondition";
+export * from "./kindedError";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC"}

package/dist/runtime/errors/index.js

@@ -1 +1,2 @@
 export * from "./createErrorCondition.js";
+export * from "./kindedError.js";

package/dist/runtime/errors/kindedError.d.ts

@@ -0,0 +1,27 @@
+import { KindErrorDefn } from "../../types/index";
+/**
+ * **KindError**
+ *
+ * An error which:
+ *
+ * - must have a "kind" type defined which can be used to categorize the error
+ * - is allowed to express other key/value pairs in the `context` property
+ *
+ * This error is generated with the `kindError(kind, _defineContext) => (msg, ctx)`
+ * higher order function.
+ *
+ * ```ts
+ * // Defines the Error
+ * const BadJuju = kindError("bad-juju", { flavor?: "" });
+ * // BadJuju {
+ * //     name: BadJuju;
+ * //     kind: "bad-juju";
+ * //     msg: "oh my god!";
+ * //     context: { flavor?: string}
+ * // }
+ * BadJuju("oh my god!");
+ * BadJuju("oh my god!", { flavor: "strawberry"})
+ * ```
+ */
+export declare const kindError: <K extends string, C extends Record<string, unknown> = {}>(kind: K, _defineContext?: C) => KindErrorDefn<K, C>;
+//# sourceMappingURL=kindedError.d.ts.map

package/dist/runtime/errors/kindedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kindedError.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/kindedError.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,aAAa,EACd,0BAAwB;AAEzB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,SAAS,mEAId,CAAC,mBACU,CAAC,KACjB,cAAc,CAAC,EAAC,CAAC,CAkBnB,CAAA"}

package/dist/runtime/errors/kindedError.js

@@ -0,0 +1,33 @@
+import { toKebabCase, toPascalCase } from "../literals/index.js";
+/**
+ * **KindError**
+ *
+ * An error which:
+ *
+ * - must have a "kind" type defined which can be used to categorize the error
+ * - is allowed to express other key/value pairs in the `context` property
+ *
+ * This error is generated with the `kindError(kind, _defineContext) => (msg, ctx)`
+ * higher order function.
+ *
+ * ```ts
+ * // Defines the Error
+ * const BadJuju = kindError("bad-juju", { flavor?: "" });
+ * // BadJuju {
+ * //     name: BadJuju;
+ * //     kind: "bad-juju";
+ * //     msg: "oh my god!";
+ * //     context: { flavor?: string}
+ * // }
+ * BadJuju("oh my god!");
+ * BadJuju("oh my god!", { flavor: "strawberry"})
+ * ```
+ */
+export const kindError = (kind, _defineContext) => (msg, context) => {
+    const err = new Error(msg);
+    err.name = toPascalCase(kind);
+    err.kind = toKebabCase(kind);
+    err.__kind = "KindError";
+    err.context = context;
+    return err;
+};

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

@@ -1,3 +1,2 @@
-export * from "./left";
-export * from "./right";
+export * from "./result";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/functional/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/functional/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/runtime/functional/index.js

@@ -1,2 +1 @@
-export * from "./left.js";
-export * from "./right.js";
+export * from "./result.js";

package/dist/runtime/functional/result.d.ts

@@ -0,0 +1,2 @@
+export declare const result = "NOT READY";
+//# sourceMappingURL=result.d.ts.map

package/dist/runtime/functional/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../src/runtime/functional/result.ts"],"names":[],"mappings":"AAoTA,eAAO,MAAM,MAAM,cAAc,CAAA"}

package/dist/runtime/functional/result.js

@@ -0,0 +1,286 @@
+// /* eslint-disable @typescript-eslint/no-explicit-any */
+// /* eslint-disable no-use-before-define */
+// import { RESULT } from "src/constants/Functional"
+// import { 
+//   Ok, 
+//   Result,  
+//   AsFunction, 
+//   Narrowable, 
+//   Err,
+//   ResultErr,
+//   ObjectKey,
+//   ResultTuple,
+//   TupleToUnion,
+//   ResultApi,
+//   IfEqual,
+//   IsOk,
+//   IsErr,
+//   ErrInput,
+//   IsFunction,
+//   If,
+// } from "src/types/index"
+// import { Never } from "src/constants/index";
+// import { isFunction, isObject, isString } from "../type-guards/index";
+// import { toKebabCase } from "../literals/toKebabCase";
+// import { asUnion } from "../type-conversion/asUnion";
+// import { isRuntimeUnion } from "../type-guards/isRuntimeUnion";
+// import { takeProp } from "../dictionary";
+// import { kindError } from "../errors";
+// import { toPascalCase } from "../literals";
+// const errInputs: ErrInput = "undefined" as const;
+// export const isResult = (val: unknown): val is Result => {
+//   return typeof val === "object" && 
+//     "__kind" in (val as object) && 
+//     "state" in (val as object) &&
+//     [RESULT.Err, RESULT.Ok].includes((val as any).state)
+// }
+// function resultTuple<
+//   T, 
+//   E extends ErrInput
+// >(val: T, err: E) {
+//   return {
+//     __kind: ["Result", val, err]
+//   } as ResultTuple<T,E>;
+// }
+// export const asResult = <
+//   T,
+//   E extends ErrInput
+// >(val: T, err: E): ResultApi<T,E> => ({
+//   kind: "Result API",
+//   result: null as unknown as Result<T,E>,
+//   ok: (v) => {
+//     return {
+//       ...resultTuple(val,err), state: RESULT.Ok, val: v 
+//     } as Ok<T>
+//   },
+//   err: (e) => {
+//     return {
+//       ...resultTuple(val,err), 
+//       state: RESULT.Err, 
+//       err: transformErrInput(e)
+//     } as unknown as Err<E>
+//   },
+//   isErr: (v) => {
+//     return isResult(v) && v.state === RESULT.Err;
+//   },
+//   isOk: (v) => {
+//     return isResult(v) && v.state === RESULT.Ok;
+//   },
+//   okOrElse: (result, otherwise) => {
+//     return result.state === RESULT.Ok
+//       ? result.val
+//       : typeof otherwise === "function"
+//         ? otherwise(result)
+//         : otherwise
+//   },
+//   okOrThrow: (result) => {
+//     if (isErr(result)) {
+//       const { msg, kind, context } = result.err;
+//       throw kindError(kind)(msg, context);
+//     }
+//   }
+// }) as ResultApi<T,E>;
+// /**
+//  * **ok**(val)
+//  * 
+//  * Places a value into the `Ok` state of a `Result` structure.
+//  * 
+//  * Note: if you need/want the value to be narrowly typed then use `okN()` instead.
+//  */
+// export function ok<
+//   T, 
+//   E extends ErrInput
+// >(val: T, _err: E = errInputs as E): IfEqual<E, ErrInput, Ok<T>, Ok<T,E>> {
+//   const tuple = resultTuple(val, _err) as unknown as ResultTuple<T,E>;
+//   return { ...tuple, state: RESULT.Ok, val }
+// }
+// /**
+//  * **ok**(val)
+//  * 
+//  * Places a value into the `Ok` state of a `Result` structure.
+//  * 
+//  * Note: this can only receive _narrowable_ types in order to provide the
+//  * narrowest type possible for `T` but if you don't need this then use the
+//  * `ok(val)` function instead.
+//  */
+// export function okN<
+//   T extends Narrowable, 
+//   E extends ErrInput
+// >(val: T, _err: E = errInputs as E): Ok<T> {
+//   const tuple = resultTuple(val, "unknown") as unknown as ResultTuple<T,E>;
+//   return { ...tuple, state: RESULT.Ok, val }
+// }
+// /**
+//  * Used to convert an `ErrInput` into `ResultErr[]`
+//  */
+// const transformErrInput = <
+//   T extends ErrInput
+// >(input: T): TupleToUnion<Err<T>> => {
+//   const members = (
+//     isRuntimeUnion(input)
+//     ? input.members
+//     : typeof input === "string"
+//     ? [{ msg: input, kind: toKebabCase(input as string), context: {} }]
+//     : typeof input === "object"
+//     ? [{ 
+//       msg: takeProp((input as Record<ObjectKey, unknown>), "msg", "" as string), 
+//       kind: toKebabCase(takeProp((input as Record<ObjectKey, unknown>), "kind", "unspecified-kind") as string),
+//       context: takeProp((input as Record<ObjectKey, unknown>), "context", {} as NonNullable<unknown>), 
+//       trace: takeProp((input as Record<ObjectKey, unknown>), "trace", false), 
+//     }]
+//     : Array.isArray(input)
+//     ? input
+//     : Never
+//   ) as ResultErr[];
+//   const union =  asUnion(...members);
+//   return union as unknown as TupleToUnion<Err<T>>;
+// }
+// /**
+//  * **createErr**(e) → `<ResultErr>`
+//  * 
+//  * Creates a reusable error template which will allow for:
+//  * 
+//  * - a strict `kind` definition
+//  * - a _shape_ and default values for the `context` property
+//  * - a strict `stack` definition (default is false)
+//  * 
+//  * The `msg` property will be left as `string` allowing each variant of
+//  * this type of error to add their own.
+//  */
+// export const createErr = <
+//   TKind extends string,
+//   TContextDefn extends Record<string, unknown> = NonNullable<unknown>
+// >(kind: TKind, contextDefn?: TContextDefn) => {
+//   return {
+//     msg: "" as string,
+//     kind,
+//     context: (contextDefn || {}) as TContextDefn
+//   } as ResultErr<TKind, TContextDefn>
+// }
+// /**
+//  * **err**(input) -> Err`<E>`
+//  * 
+//  * Creates a `Err` error for use inside a `Result<T,E>` block.
+//  */
+// export function err<
+//   TErr extends string | ResultErr<any, any>,
+//   TVal = unknown
+// >(
+//   err: TErr,  
+//   _val: TVal = null as unknown as ErrInput as TVal
+// ): IfEqual<TVal, unknown, Err<TErr>, Err<TErr,TVal>> {
+//   return {
+//     ...(resultTuple(_val, err)),
+//     state: RESULT.Err,
+//     err: transformErrInput(err)
+//   } as unknown as IfEqual<TVal, unknown, Err<TErr>, Err<TErr,TVal>>
+// }
+// /**
+//  * **isOk**(result)
+//  * 
+//  * Type guard which tests whether the `Result<T,E>` is in the **Ok** state.
+//  */
+// export const isOk = <
+//   T,
+// >(result: Result<T>): result is T & Ok<T> => {
+//   return result.state === RESULT.Ok;
+// }
+// /**
+//  * **okOrThrow**(result)
+//  * 
+//  * Returns the Ok _value_ if it's in the Ok status; otherwise throws
+//  * an error.
+//  */
+// export function okOrThrow<
+//   R extends Result<T,E>,
+//   T = undefined,
+//   E extends ErrInput = ErrInput
+// >(result: R): IsOk<R> extends true ? T : never {
+//   if(result.state === RESULT.Err) {
+//     if (typeof result.err === "string") {
+//       throw new Error(result.err);
+//     } else {
+//       let e = new Error(result.err.msg);
+//       for (const key of Object.keys(result.err)) {
+//         if(key !== "msg") {
+//           e = {...e, [key]: result.err[key as keyof typeof result.err]}
+//         }
+//       }
+//       throw e;
+//     }
+//   }
+//   return result.val as IsOk<R> extends true ? T : never;
+// }
+// /**
+//  * **okOrElse**(result, els)
+//  * 
+//  * Returns the _value_ of the `Result<T,E>` if in the **Ok** state, otherwise
+//  * returns `els`.
+//  * 
+//  * - **Note:** if `els` is a function it will be called while passing the error
+//  * object to the function.
+//  */
+// export function okOrElse<
+//   R extends Result<T,E>,
+//   T,
+//   E extends ResultErr,
+//   Els
+// >(
+//   result: R, 
+//   els: Els
+// ): IsOk<R> extends true ? T : If<IsFunction<Els>, ReturnType<AsFunction<Els>>, Els> {
+//   return result.state === RESULT.Err
+//   ? isFunction(els)
+//     ? els(result.err)
+//     : els
+//   : result.val;
+// }
+// export function isErr<
+//   T,
+//   E extends ErrInput
+// >(result: Result<T,E>): result is Err<E,T> {
+//   return (
+//       isString(result)
+//       ? { 
+//           state: RESULT.Err, 
+//           err:{ 
+//             msg: result, 
+//             kind: toPascalCase(result), 
+//             context: {}, 
+//             stack: false 
+//           } 
+//         }
+//       : isObject(result)
+//         ? {
+//           state: RESULT.Err,
+//           err: {
+//             msg: result.err.msg || "no message",
+//             kind: takeProp(result, "kind", "no-kind"),
+//             context: takeProp(result, "context", {}),
+//             stack: takeProp(result, "stack", false)
+//           }
+//         }
+//         : false
+//     )
+//     ? true 
+//     : false
+// }
+// /**
+//  * **assertErr**(result)
+//  * 
+//  * Asserts that a _result_ is of the `Err` type.
+//  */
+// export function assertErr<
+//   T
+// >(result: T): IsErr<T> {
+//   return (
+//     typeof result === "object" &&
+//     (result as any).state === RESULT.Err && "err" in (result as object) && (
+//       typeof (result as any).err === "string" ||
+//       typeof (result as any).err === "object"
+//     )
+//     ? true 
+//     : false
+//   ) as IsErr<typeof result>;
+// }
+export const result = "NOT READY";

package/dist/runtime/functions/fnMeta.d.ts

@@ -1,4 +1,5 @@
-import { AnyFunction } from "../../types/index";
+import { AnyFunction, AsFnMeta } from "../../types/index";
+type _Props<TFn extends AnyFunction> = AsFnMeta<TFn>["props"];
 /**
  * **fnMeta**(func)
  *
@@ -8,13 +9,8 @@ import { AnyFunction } from "../../types/index";
  * - the `fn` is a clone of the underlying function
  */
 export declare const fnMeta: <TFn extends AnyFunction>(func: TFn) => {
-    fn: <A extends Parameters<TFn>>(...args: A) => any;
-    props: import("../../types/index").IfNever<import("../../types/index").ExpandRecursively<keyof TFn>, {}, import("../../types/index").ExpandRecursively<Pick<TFn, import("../../types/index").ExpandRecursively<keyof TFn>>>> extends {
-        [x: string]: unknown;
-        [x: symbol]: unknown;
-    } ? {
-        [x: string]: unknown;
-        [x: symbol]: unknown;
-    } & import("../../types/index").IfNever<import("../../types/index").ExpandRecursively<keyof TFn>, {}, import("../../types/index").ExpandRecursively<Pick<TFn, import("../../types/index").ExpandRecursively<keyof TFn>>>> : never;
+    fn: <A extends AsFnMeta<TFn>["args"]>(...args: A) => any;
+    props: _Props<TFn>;
 };
+export {};
 //# sourceMappingURL=fnMeta.d.ts.map

package/dist/runtime/functions/fnMeta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fnMeta.d.ts","sourceRoot":"","sources":["../../../src/runtime/functions/fnMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAa,0BAAwB;AAIzD;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;;;;;;;;;CAclB,CAAC"}
+{"version":3,"file":"fnMeta.d.ts","sourceRoot":"","sources":["../../../src/runtime/functions/fnMeta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAG,QAAQ,EAAE,0BAAwB;AAEzD,KAAK,MAAM,CAAC,GAAG,SAAS,WAAW,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC;AAE9D;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,kCAAmC,GAAG;mDAG3C,CAAC;;CAWd,CAAC"}

package/dist/runtime/index.d.ts

@@ -9,7 +9,7 @@ export * from "./lists/index";
 export * from "./literals/index";
 export * from "./runtime-types/index";
 export * from "./sets/index";
-export * from "./state/index";
 export * from "./type-conversion/index";
 export * from "./type-guards/index";
+export * from "./vuejs/index";
 //# sourceMappingURL=index.d.ts.map

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,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}
+{"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"}

package/dist/runtime/index.js

@@ -15,9 +15,9 @@ export * from "./lists/index.js";
 export * from "./literals/index.js";
 export * from "./runtime-types/index.js";
 export * from "./sets/index.js";
-export * from "./state/index.js";
 export * from "./type-conversion/index.js";
 export * from "./type-guards/index.js";
+export * from "./vuejs/index.js";
 // #endregion auto-indexed files
 // see https://github.com/inocan-group/do-devops/docs/autoindex.md
 // for more info