type-plus 8.0.0-beta.3 → 8.0.0-beta.5

package/cjs/unknown/is_not_unknown.d.ts

@@ -0,0 +1,53 @@
+import type { $Any } from '../any/any.js';
+import type { $Never } from '../never/never.js';
+import type { $SpecialType } from '../type_plus/$special_type.js';
+import type { $InputOptions } from '../type_plus/branch/$input_options.js';
+import type { $ResolveBranch } from '../type_plus/branch/$resolve_branch.js';
+import type { $Else, $SelectionBranch, $Then } from '../type_plus/branch/$selection.js';
+import type { $SelectionOptions } from '../type_plus/branch/$selection_options.js';
+/**
+ * 🎭 *predicate*
+ *
+ * Validate if `T` is not exactly `unknown`.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotUnknown<unknown> // false
+ *
+ * type R = IsNotUnknown<number> // true
+ * type R = IsNotUnknown<never> // true
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Filter to ensure `T` is not exactly `unknown`.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotUnknown<unknown, { selection: 'filter' }> // never
+ *
+ * type R = IsNotUnknown<number, { selection: 'filter' }> // number
+ * type R = IsNotUnknown<never, { selection: 'filter' }> // never
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Use unique branch identifiers to allow precise processing of the result.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotUnknown<unknown, $SelectionBranch> // $Else
+ * type R = IsNotUnknown<string, $SelectionBranch> // $Then
+ * ```
+ */
+export type IsNotUnknown<T, $O extends IsNotUnknown.$Options = {}> = $SpecialType<T, {
+    $any: $ResolveBranch<T, $O, [$Any, $Then]>;
+    $unknown: $ResolveBranch<T, $O, [$Else]>;
+    $never: $ResolveBranch<T, $O, [$Never, $Then]>;
+    $else: $ResolveBranch<T, $O, [$Then]>;
+}>;
+export declare namespace IsNotUnknown {
+    type $Options = $SelectionOptions & $InputOptions<$Any | $Never>;
+    type $Branch = $SelectionBranch;
+}
+//# sourceMappingURL=is_not_unknown.d.ts.map

package/cjs/unknown/is_not_unknown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_not_unknown.d.ts","sourceRoot":"","sources":["../../src/unknown/is_not_unknown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAA;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,EAAE,SAAS,YAAY,CAAC,QAAQ,GAAG,EAAE,IAAI,YAAY,CAChF,CAAC,EACD;IACC,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAC1C,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACxC,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAC9C,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;CACrC,CACD,CAAA;AAED,yBAAiB,YAAY,CAAC;IAC7B,KAAY,QAAQ,GAAG,iBAAiB,GAAG,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAAA;IACvE,KAAY,OAAO,GAAG,gBAAgB,CAAA;CACtC"}

package/cjs/unknown/is_not_unknown.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=is_not_unknown.js.map

package/cjs/unknown/is_not_unknown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_not_unknown.js","sourceRoot":"","sources":["../../src/unknown/is_not_unknown.ts"],"names":[],"mappings":""}

package/cjs/unknown/is_unknown.d.ts

@@ -0,0 +1,53 @@
+import type { $Any } from '../any/any.js';
+import type { $Never } from '../never/never.js';
+import type { $SpecialType } from '../type_plus/$special_type.js';
+import type { $InputOptions } from '../type_plus/branch/$input_options.js';
+import type { $ResolveBranch } from '../type_plus/branch/$resolve_branch.js';
+import type { $Else, $SelectionBranch, $Then } from '../type_plus/branch/$selection.js';
+import type { $SelectionOptions } from '../type_plus/branch/$selection_options.js';
+/**
+ * 🎭 *predicate*
+ *
+ * Validate if `T` is exactly `unknown`.
+ *
+ * @example
+ * ```ts
+ * type R = IsUnknown<unknown> // true
+ *
+ * type R = IsUnknown<number> // false
+ * type R = IsUnknown<never> // false
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Filter to ensure `T` is exactly `unknown`.
+ *
+ * @example
+ * ```ts
+ * type R = IsUnknown<unknown, { selection: 'filter' }> // unknown
+ *
+ * type R = IsUnknown<number, { selection: 'filter' }> // never
+ * type R = IsUnknown<never, { selection: 'filter' }> // never
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Use unique branch identifiers to allow precise processing of the result.
+ *
+ * @example
+ * ```ts
+ * type R = IsUnknown<unknown, $SelectionBranch> // $Then
+ * type R = IsUnknown<string, $SelectionBranch> // $Else
+ * ```
+ */
+export type IsUnknown<T, $O extends IsUnknown.$Options = {}> = $SpecialType<T, {
+    $any: $ResolveBranch<T, $O, [$Any, $Else]>;
+    $unknown: $ResolveBranch<T, $O, [$Then]>;
+    $never: $ResolveBranch<T, $O, [$Never, $Else]>;
+    $else: $ResolveBranch<T, $O, [$Else]>;
+}>;
+export declare namespace IsUnknown {
+    type $Options = $SelectionOptions & $InputOptions<$Any | $Never>;
+    type $Branch = $SelectionBranch;
+}
+//# sourceMappingURL=is_unknown.d.ts.map

package/cjs/unknown/is_unknown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_unknown.d.ts","sourceRoot":"","sources":["../../src/unknown/is_unknown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAA;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAA;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,SAAS,CAAC,QAAQ,GAAG,EAAE,IAAI,YAAY,CAC1E,CAAC,EACD;IACC,IAAI,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IAC1C,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACxC,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAC9C,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;CACrC,CACD,CAAA;AAED,yBAAiB,SAAS,CAAC;IAC1B,KAAY,QAAQ,GAAG,iBAAiB,GAAG,aAAa,CAAC,IAAI,GAAG,MAAM,CAAC,CAAA;IACvE,KAAY,OAAO,GAAG,gBAAgB,CAAA;CACtC"}

package/cjs/unknown/is_unknown.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=is_unknown.js.map

package/cjs/unknown/is_unknown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_unknown.js","sourceRoot":"","sources":["../../src/unknown/is_unknown.ts"],"names":[],"mappings":""}

package/cjs/unknown/not_unknown_or.d.ts

@@ -0,0 +1,30 @@
+import type { IsUnknown } from './is_unknown.js';
+import type { $Unknown } from './unknown.js';
+/**
+ * 🌪️ *filter*
+ *
+ * Returns `T` if `T` is not `unknown`, otherwise `$Unknown`.
+ *
+ * @example
+ * ```ts
+ * type R = NotUnknownOr<number> // number
+ * type R = NotUnknownOr<unknown> // $Unknown
+ *
+ * // customize
+ * type R = NotUnknownOr<unknown, number> // number
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Replace `unknown` branch with `Replace`.
+ *
+ * @example
+ * ```ts
+ * type R = NotUnknownOr<unknown, number> // number
+ * ```
+ */
+export type NotUnknownOr<T, Else = $Unknown> = IsUnknown<T, {
+    $then: Else;
+    $else: T;
+}>;
+//# sourceMappingURL=not_unknown_or.d.ts.map

package/cjs/unknown/not_unknown_or.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"not_unknown_or.d.ts","sourceRoot":"","sources":["../../src/unknown/not_unknown_or.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,QAAQ,IAAI,SAAS,CACvD,CAAC,EACD;IACC,KAAK,EAAE,IAAI,CAAA;IACX,KAAK,EAAE,CAAC,CAAA;CACR,CACD,CAAA"}

package/cjs/unknown/not_unknown_or.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=not_unknown_or.js.map

package/cjs/unknown/not_unknown_or.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not_unknown_or.js","sourceRoot":"","sources":["../../src/unknown/not_unknown_or.ts"],"names":[],"mappings":""}

package/cjs/unknown/unknown.d.ts

@@ -0,0 +1,55 @@
+import type { $Branch } from '../type_plus/branch/$branch.js';
+/**
+ * 🧰 *type util*
+ *
+ * A special branch for `unknown` check to represent the value is `unknown`.
+ */
+export type $Unknown = $Branch<'$unknown'>;
+export declare namespace $Unknown {
+    /**
+     * 🧰 *type util*
+     *
+     * Options for specifically handling the type `unknown`.
+     *
+     * @example
+     * ```ts
+     * type YourType<
+     *   T,
+     *   $Options extends YourType.$Options = YourType.$Default
+     * > = ...
+     *
+     * namespace YourType {
+     *   export type $Options = $Unknown.$Options
+     *   export type $Branch = $Unknown.$Branch
+     * }
+     * ```
+     */
+    type $Options = {
+        $unknown?: unknown;
+    };
+    /**
+     * 🧰 *type util*
+     *
+     * Branch option for specifically handling the type `unknown`.
+     *
+     * Use this to finely customize the behavior of your type.
+     *
+     * ```ts
+     * type YourType<
+     *   T,
+     *   $Options extends YourType.$Options = YourType.$Default
+     * > = ...
+     *
+     * namespace YourType {
+     *   export type $Options = $Unknown.$Options
+     *   export type $Branch = $Unknown.$Branch
+     * }
+     *
+     * type R = YourType<T, YourType.$Branch> extends $Unknown ? HandleUnknown : HandleOthers
+     * ```
+     */
+    type $Branch = {
+        $unknown: $Unknown;
+    };
+}
+//# sourceMappingURL=unknown.d.ts.map

package/cjs/unknown/unknown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown.d.ts","sourceRoot":"","sources":["../../src/unknown/unknown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAE7D;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAE1C,yBAAiB,QAAQ,CAAC;IACzB;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAY,QAAQ,GAAG;QACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;KAClB,CAAA;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAY,OAAO,GAAG;QACrB,QAAQ,EAAE,QAAQ,CAAA;KAClB,CAAA;CACD"}

package/cjs/unknown/unknown.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=unknown.js.map

package/cjs/unknown/unknown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown.js","sourceRoot":"","sources":["../../src/unknown/unknown.ts"],"names":[],"mappings":""}

package/cjs/unpartial.d.ts

@@ -0,0 +1,2 @@
+export { required, requiredDeep, unpartial } from 'unpartial';
+//# sourceMappingURL=unpartial.d.ts.map

package/cjs/unpartial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpartial.d.ts","sourceRoot":"","sources":["../src/unpartial.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA"}

package/cjs/unpartial.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unpartial = exports.requiredDeep = exports.required = void 0;
+var unpartial_1 = require("unpartial");
+Object.defineProperty(exports, "required", { enumerable: true, get: function () { return unpartial_1.required; } });
+Object.defineProperty(exports, "requiredDeep", { enumerable: true, get: function () { return unpartial_1.requiredDeep; } });
+Object.defineProperty(exports, "unpartial", { enumerable: true, get: function () { return unpartial_1.unpartial; } });
+//# sourceMappingURL=unpartial.js.map

package/cjs/unpartial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unpartial.js","sourceRoot":"","sources":["../src/unpartial.ts"],"names":[],"mappings":";;;AAAA,uCAA6D;AAApD,qGAAA,QAAQ,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,sGAAA,SAAS,OAAA"}

package/cjs/utils/Widen.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Widen scalar types from literals to their parent types.
+ * Borrow from `typical`
+ */
+export type Widen<T> = T extends boolean ? boolean : T extends number ? number : T extends string ? string : T;
+//# sourceMappingURL=Widen.d.ts.map

package/cjs/utils/Widen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Widen.d.ts","sourceRoot":"","sources":["../../src/utils/Widen.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,OAAO,GAAG,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,CAAC,CAAA"}

package/cjs/utils/Widen.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Widen.js.map

package/cjs/utils/Widen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Widen.js","sourceRoot":"","sources":["../../src/utils/Widen.ts"],"names":[],"mappings":""}

package/cjs/utils/as.d.ts

@@ -0,0 +1,10 @@
+export declare function as<T>(subject: unknown): T;
+export declare function asAny(subject: unknown): any;
+/**
+ * amend `subject` with type `T`
+ */
+export declare function amend<S>(subject: S): {
+    union<T>(): T & S;
+    intersect<T_1>(): S | T_1;
+};
+//# sourceMappingURL=as.d.ts.map

package/cjs/utils/as.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"as.d.ts","sourceRoot":"","sources":["../../src/utils/as.ts"],"names":[],"mappings":"AAAA,wBAAgB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,CAEzC;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAE3C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;gBAErB,CAAC,GAAG,CAAC;;EAOlB"}

package/cjs/utils/as.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.amend = exports.asAny = exports.as = void 0;
+function as(subject) {
+    return subject;
+}
+exports.as = as;
+function asAny(subject) {
+    return subject;
+}
+exports.asAny = asAny;
+/**
+ * amend `subject` with type `T`
+ */
+function amend(subject) {
+    return {
+        union() {
+            return subject;
+        },
+        intersect() {
+            return subject;
+        },
+    };
+}
+exports.amend = amend;
+//# sourceMappingURL=as.js.map

package/cjs/utils/as.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"as.js","sourceRoot":"","sources":["../../src/utils/as.ts"],"names":[],"mappings":";;;AAAA,SAAgB,EAAE,CAAI,OAAgB;IACrC,OAAO,OAAY,CAAA;AACpB,CAAC;AAFD,gBAEC;AAED,SAAgB,KAAK,CAAC,OAAgB;IACrC,OAAO,OAAO,CAAA;AACf,CAAC;AAFD,sBAEC;AAED;;GAEG;AACH,SAAgB,KAAK,CAAI,OAAU;IAClC,OAAO;QACN,KAAK;YACJ,OAAO,OAAgB,CAAA;QACxB,CAAC;QACD,SAAS;YACR,OAAO,OAAgB,CAAA;QACxB,CAAC;KACD,CAAA;AACF,CAAC;AATD,sBASC"}

package/cjs/utils/index.d.ts

@@ -0,0 +1,41 @@
+export * from './as.js';
+export * from './inspect.js';
+export type { Widen } from './Widen.js';
+/**
+ * `A` | `B` | `A & B`.
+ * Supports up to 4 types, and it is composable.
+ * This is useful when you want to compose multiple options together,
+ * while preserving their required field and structure.
+ * If the types overlaps each other, you may run into some corner cases.
+ * But in general usage it should work as expected.
+ * @example
+ * type A = { src: string, minify?: boolean }
+ * type B = { logLevel: number }
+ * function config(options: EitherAnd<A, B>) { }
+ *
+ * config({ logLevel: 1 })
+ * config({ src: 'src' })
+ * config({ src: 'src', minify: false })
+ * config({ minify: false })  // INVALID
+ */
+export type EitherOrBoth<A, B, C = void, D = void> = C extends void ? A | B | (A & B) : D extends void ? A | B | C | (A & B) | (A & C) | (B & C) | (A & B & C) : A | B | C | D | (A & B) | (A & C) | (A & D) | (B & C) | (B & D) | (C & D) | (A & B & C) | (A & B & D) | (A & C & D) | (B & C & D) | (A & B & C & D);
+/**
+ * `A` | `B` | `A & B`.
+ * Supports up to 4 types, and it is composable.
+ * This is useful when you want to compose multiple options together,
+ * while preserving their required field and structure.
+ * If the types overlaps each other, you may run into some corner cases.
+ * But in general usage it should work as expected.
+ * @deprecated renamed to `EitherOrBoth`
+ * @example
+ * type A = { src: string, minify?: boolean }
+ * type B = { logLevel: number }
+ * function config(options: EitherAnd<A, B>) { }
+ *
+ * config({ logLevel: 1 })
+ * config({ src: 'src' })
+ * config({ src: 'src', minify: false })
+ * config({ minify: false })  // INVALID
+ */
+export type EitherAnd<A, B, C = void, D = void> = EitherOrBoth<A, B, C, D>;
+//# sourceMappingURL=index.d.ts.map

package/cjs/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,IAAI,GAChE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GACf,CAAC,SAAS,IAAI,GACb,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAEnD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,CAAC,GAAG,CAAC,CAAC,GACP,CAAC,CAAC,GAAG,CAAC,CAAC,GACP,CAAC,CAAC,GAAG,CAAC,CAAC,GACP,CAAC,CAAC,GAAG,CAAC,CAAC,GACP,CAAC,CAAC,GAAG,CAAC,CAAC,GACP,CAAC,CAAC,GAAG,CAAC,CAAC,GACP,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GACX,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GACX,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GACX,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GACX,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;AAErB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,IAAI,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA"}

package/cjs/utils/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./as.js"), exports);
+__exportStar(require("./inspect.js"), exports);
+//# sourceMappingURL=index.js.map

package/cjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAuB;AACvB,+CAA4B"}

package/cjs/utils/inspect.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Inspects the value and returns it.
+ */
+export declare function inspect<T>(value: T, inspector?: (value: Readonly<T>) => void): T;
+//# sourceMappingURL=inspect.d.ts.map

package/cjs/utils/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/utils/inspect.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,GAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAkB,GAAG,CAAC,CAG7F"}

package/cjs/utils/inspect.js

@@ -0,0 +1,13 @@
+"use strict";
+/* eslint-disable no-console */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inspect = void 0;
+/**
+ * Inspects the value and returns it.
+ */
+function inspect(value, inspector = console.dir) {
+    inspector(value);
+    return value;
+}
+exports.inspect = inspect;
+//# sourceMappingURL=inspect.js.map

package/cjs/utils/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/utils/inspect.ts"],"names":[],"mappings":";AAAA,+BAA+B;;;AAE/B;;GAEG;AACH,SAAgB,OAAO,CAAI,KAAQ,EAAE,YAA0C,OAAO,CAAC,GAAG;IACzF,SAAS,CAAC,KAAK,CAAC,CAAA;IAChB,OAAO,KAAK,CAAA;AACb,CAAC;AAHD,0BAGC"}

package/cjs/utils/options.d.ts

@@ -0,0 +1,15 @@
+export declare namespace TypePlusOptions {
+    /**
+     * 🦴 *utilities*
+     * ㊙️ *internal*
+     *
+     * Merge the input Options `I` with the default Options `D`.
+     */
+    type Merge<I, D> = {
+        [k in keyof D]: k extends keyof I ? I[k] : D[k];
+    };
+    interface NotArray {
+        $notArray?: unknown;
+    }
+}
+//# sourceMappingURL=options.d.ts.map

package/cjs/utils/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/utils/options.ts"],"names":[],"mappings":"AAAA,yBAAiB,eAAe,CAAC;IAChC;;;;;OAKG;IACH,KAAY,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI;SACxB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAC/C,CAAA;IAED,UAAiB,QAAQ;QACxB,SAAS,CAAC,EAAE,OAAO,CAAA;KACnB;CACD"}

package/cjs/utils/options.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=options.js.map

package/cjs/utils/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/utils/options.ts"],"names":[],"mappings":""}

package/cjs/void/is_not_void.d.ts

@@ -0,0 +1,78 @@
+import type { NotAssignable } from '../predicates/not_assignable.js';
+import type { $Equality } from '../type_plus/$equality.js';
+import type { $MergeOptions } from '../type_plus/$merge_options.js';
+import type { $SpecialType } from '../type_plus/$special_type.js';
+import type { $ResolveBranch } from '../type_plus/branch/$resolve_branch.js';
+import type { $Then } from '../type_plus/branch/$selection.js';
+import type { IsUndefined } from '../undefined/is_undefined.js';
+/**
+ * 🎭 *predicate*
+ *
+ * Validate if `T` is not `void`.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotVoid<void> // false
+ *
+ * type R = IsNotVoid<never> // true
+ * type R = IsNotVoid<unknown> // true
+ * type R = IsNotVoid<string | boolean> // true
+ *
+ * type R = IsNotVoid<string | void> // boolean
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Filter to ensure `T` is not `void`, otherwise returns `never`.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotVoid<void, { selection: 'filter' }> // never
+ *
+ * type R = IsNotVoid<never, { selection: 'filter' }> // never
+ * type R = IsNotVoid<unknown, { selection: 'filter' }> // unknown
+ * type R = IsNotVoid<string | void, { selection: 'filter' }> // string
+ * ```
+ *
+ * 🔢 *customize*:
+ *
+ * Disable distribution of union types.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotVoid<void | string> // boolean
+ * type R = IsNotVoid<void | string, { distributive: false }> // true
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Use unique branch identifiers to allow precise processing of the result.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotVoid<void, $SelectionBranch> // $Else
+ * type R = IsNotVoid<string, $SelectionBranch> // $Then
+ * ```
+ */
+export type IsNotVoid<T, $O extends IsNotVoid.$Options = {}> = $SpecialType<T, $MergeOptions<$O, {
+    $then: $ResolveBranch<T, $O, [$Then]>;
+    $else: IsNotVoid.$<T, $O>;
+}>>;
+export declare namespace IsNotVoid {
+    type $Options = $Equality.$Options;
+    type $Branch<$O extends $Options = {}> = $Equality.$Branch<$O>;
+    /**
+     * 🧰 *type util*
+     *
+     * Validate if `T` is `undefined`.
+     *
+     * This is a type util for building custom types.
+     * It does not check against special types.
+     */
+    type $<T, $O extends $UtilOptions> = IsUndefined.$<T, {
+        $then: $ResolveBranch<T, $O, [$Then]>;
+        $else: NotAssignable.$<T, void, $O>;
+    }>;
+    type $UtilOptions = NotAssignable.$UtilOptions;
+}
+//# sourceMappingURL=is_not_void.d.ts.map

package/cjs/void/is_not_void.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_not_void.d.ts","sourceRoot":"","sources":["../../src/void/is_not_void.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,SAAS,CAAC,QAAQ,GAAG,EAAE,IAAI,YAAY,CAC1E,CAAC,EACD,aAAa,CACZ,EAAE,EACF;IACC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACrC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;CACzB,CACD,CACD,CAAA;AAED,yBAAiB,SAAS,CAAC;IAC1B,KAAY,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAA;IACzC,KAAY,OAAO,CAAC,EAAE,SAAS,QAAQ,GAAG,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAErE;;;;;;;OAOG;IACH,KAAY,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,YAAY,IAAI,WAAW,CAAC,CAAC,CACxD,CAAC,EACD;QACC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;QACrC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;KACnC,CACD,CAAA;IAED,KAAY,YAAY,GAAG,aAAa,CAAC,YAAY,CAAA;CACrD"}

package/cjs/void/is_not_void.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=is_not_void.js.map

package/cjs/void/is_not_void.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_not_void.js","sourceRoot":"","sources":["../../src/void/is_not_void.ts"],"names":[],"mappings":""}

package/cjs/void/is_void.d.ts

@@ -0,0 +1,79 @@
+import type { Assignable } from '../predicates/assignable.js';
+import type { $Equality } from '../type_plus/$equality.js';
+import type { $MergeOptions } from '../type_plus/$merge_options.js';
+import type { $SpecialType } from '../type_plus/$special_type.js';
+import type { $ResolveBranch } from '../type_plus/branch/$resolve_branch.js';
+import type { $Else } from '../type_plus/branch/$selection.js';
+import type { IsUndefined } from '../undefined/is_undefined.js';
+/**
+ * 🎭 *predicate*
+ *
+ * Validate if `T` is `void`.
+ *
+ * @example
+ * ```ts
+ * type R = IsVoid<void> // true
+ *
+ * type R = IsVoid<never> // false
+ * type R = IsVoid<unknown> // false
+ * type R = IsVoid<string | boolean> // false
+ *
+ * type R = IsVoid<string | void> // boolean
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Filter to ensure `T` is `void`, otherwise returns `never`.
+ *
+ * @example
+ * ```ts
+ * type R = IsVoid<void, { selection: 'filter' }> // void
+ *
+ * type R = IsVoid<never, { selection: 'filter' }> // never
+ * type R = IsVoid<unknown, { selection: 'filter' }> // never
+ * type R = IsVoid<string | boolean, { selection: 'filter' }> // never
+ *
+ * type R = IsVoid<string | void> // void
+ * ```
+ *
+ * 🔢 *customize*:
+ *
+ * Disable distribution of union types.
+ *
+ * ```ts
+ * type R = IsVoid<void | 1> // boolean
+ * type R = IsVoid<void | 1, { distributive: false }> // false
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Use unique branch identifiers to allow precise processing of the result.
+ *
+ * @example
+ * ```ts
+ * type R = IsVoid<void, $SelectionBranch> // $Then
+ * type R = IsVoid<string, $SelectionBranch> // $Else
+ * ```
+ */
+export type IsVoid<T, $O extends IsVoid.$Options = {}> = $SpecialType<T, $MergeOptions<$O, {
+    $then: $ResolveBranch<T, $O, [$Else]>;
+    $else: IsVoid.$<T, $O>;
+}>>;
+export declare namespace IsVoid {
+    type $Options = $Equality.$Options;
+    type $Branch<$O extends $Options = {}> = $Equality.$Branch<$O>;
+    /**
+     * 🧰 *type util*
+     *
+     * Validate if `T` is `undefined`.
+     *
+     * This is a type util for building custom types.
+     * It does not check against special types.
+     */
+    type $<T, $O extends $UtilOptions> = IsUndefined.$<T, {
+        $then: $ResolveBranch<T, $O, [$Else]>;
+        $else: Assignable.$<T, void, $O>;
+    }>;
+    type $UtilOptions = Assignable.$UtilOptions;
+}
+//# sourceMappingURL=is_void.d.ts.map

package/cjs/void/is_void.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_void.d.ts","sourceRoot":"","sources":["../../src/void/is_void.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,QAAQ,GAAG,EAAE,IAAI,YAAY,CACpE,CAAC,EACD,aAAa,CACZ,EAAE,EACF;IACC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACrC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;CACtB,CACD,CACD,CAAA;AAED,yBAAiB,MAAM,CAAC;IACvB,KAAY,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAA;IACzC,KAAY,OAAO,CAAC,EAAE,SAAS,QAAQ,GAAG,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAErE;;;;;;;OAOG;IACH,KAAY,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,YAAY,IAAI,WAAW,CAAC,CAAC,CACxD,CAAC,EACD;QACC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;QACrC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;KAChC,CACD,CAAA;IAED,KAAY,YAAY,GAAG,UAAU,CAAC,YAAY,CAAA;CAClD"}

package/cjs/void/is_void.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=is_void.js.map