type-plus 6.7.1 → 6.8.1

package/README.md

@@ -327,8 +327,6 @@ You can learn more in their respective sections:
 - [unknown](./ts/unknown/readme.md)
 - [void](./ts/void/readme.md)
 
-These checks
-
 ## Type Utilities
 
 `type-plus` also provides additional type utilities.

package/cjs/testing/stub.d.ts

@@ -1,15 +1,28 @@
 import type { AnyFunction } from '../function/any_function.js';
 import type { RecursivePartial } from '../object/RecursivePartial.js';
 import type { NoInfer } from '../type/no_infer.js';
-export declare namespace stub {
-    type Param<T> = T extends AnyFunction ? T : RecursivePartial<NoInfer<T>>;
-}
+/**
+ * stub a value.
+ * If the value is a function, it will be passed through as-is.
+ */
 export declare function stub<T extends AnyFunction>(stub: T): T;
 export declare function stub<T>(stub: RecursivePartial<NoInfer<T>>): T;
 export declare namespace stub {
-    var build: {
-        <T>(): (stub?: Param<T> | undefined) => T;
-        <T_1>(init: RecursivePartial<T_1> | ((stub?: Param<T_1> | undefined) => RecursivePartial<T_1>)): (stub?: Param<T_1> | undefined) => T_1;
+    var build: <T>(init: RecursivePartial<T> | ((stub?: RecursivePartial<T> | undefined) => RecursivePartial<T>)) => (stub?: RecursivePartial<T> | undefined) => T;
+    var builder: <T>(init: RecursivePartial<T> | ((stub?: RecursivePartial<T> | undefined) => RecursivePartial<T>)) => {
+        /**
+         * Adds an init object or handler to the builder.
+         *
+         * If `init` is an object, it will be merged with the stub object.
+         * If `init` is a function, it will be called with the stub object.
+         *
+         * @return {Builder<T>} The builder instance.
+         */
+        with(init: RecursivePartial<T> | ((stub?: RecursivePartial<T> | undefined) => RecursivePartial<T>)): any;
+        /**
+         * Creates the resulting stub function.
+         */
+        create(): (stub?: RecursivePartial<T> | undefined) => T;
     };
 }
 //# sourceMappingURL=stub.d.ts.map

package/cjs/testing/stub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../ts/testing/stub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,yBAAiB,IAAI,CAAC;IACrB,KAAY,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;CAC/E;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;AACvD,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;yBAA9C,IAAI"}
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../ts/testing/stub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;AACvD,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;yBAA9C,IAAI;;;QAqClB;;;;;;;WAOG;;QAIH;;WAEG"}

package/cjs/testing/stub.js

@@ -7,15 +7,54 @@ function stub(stub) {
 }
 exports.stub = stub;
 function build(init) {
-    return function (value) {
-        if (typeof init === 'function') {
-            return init(value);
-        }
-        if (init) {
-            return (0, unpartial_1.requiredDeep)(init, value);
+    return builder(init).create();
+}
+/**
+ * Create a builder for a stub function of type T.
+ *
+ * The builder contains two methods:
+ *
+ * `.with()`: adds additional handler or partial stub.
+ * `.create()`: creates the final stub function.
+ *
+ * @example
+ * ```ts
+ * const b = stub.builder<{ a: number; b: string }>({ a: 1 }).with({ b: 'b' }).create()
+ * b({ a: 2 }) // { a: 2, b: 'b' }
+ * ```
+ */
+function builder(init) {
+    return builderInternal([init]);
+}
+function builderInternal(initializers) {
+    const builder = {
+        /**
+         * Adds an init object or handler to the builder.
+         *
+         * If `init` is an object, it will be merged with the stub object.
+         * If `init` is a function, it will be called with the stub object.
+         *
+         * @return {Builder<T>} The builder instance.
+         */
+        with(init) {
+            return builderInternal([...initializers, init]);
+        },
+        /**
+         * Creates the resulting stub function.
+         */
+        create() {
+            return (stub) => {
+                return initializers.reduce((acc, init) => {
+                    if (typeof init === 'function') {
+                        return init(acc);
+                    }
+                    return (0, unpartial_1.requiredDeep)(init, acc);
+                }, stub);
+            };
         }
-        return value;
     };
+    return builder;
 }
 stub.build = build;
+stub.builder = builder;
 //# sourceMappingURL=stub.js.map

package/cjs/testing/stub.js.map

@@ -1 +1 @@
-{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../ts/testing/stub.ts"],"names":[],"mappings":";;;AAAA,yCAAwC;AAWxC,SAAgB,IAAI,CAAI,IAAa;IACpC,OAAO,IAAS,CAAA;AACjB,CAAC;AAFD,oBAEC;AASD,SAAS,KAAK,CAAI,IAA4E;IAC7F,OAAO,UAAU,KAAqB;QACrC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE;YAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA;SAClB;QACD,IAAI,IAAI,EAAE;YACT,OAAO,IAAA,wBAAY,EAAC,IAAI,EAAE,KAAK,CAAC,CAAA;SAChC;QACD,OAAO,KAAK,CAAA;IACb,CAAC,CAAA;AACF,CAAC;AAED,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA"}
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../ts/testing/stub.ts"],"names":[],"mappings":";;;AAAA,yCAAwC;AAWxC,SAAgB,IAAI,CAAI,IAAa;IACpC,OAAO,IAAS,CAAA;AACjB,CAAC;AAFD,oBAEC;AAQD,SAAS,KAAK,CAAI,IAAiF;IAClG,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAA;AAC9B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,OAAO,CAAI,IAAiF;IACpG,OAAO,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AAC/B,CAAC;AAED,SAAS,eAAe,CACvB,YAAgG;IAEhG,MAAM,OAAO,GAAG;QACf;;;;;;;WAOG;QACH,IAAI,CAAC,IAAiF;YACrF,OAAO,eAAe,CAAC,CAAC,GAAG,YAAY,EAAE,IAAI,CAAC,CAAC,CAAA;QAChD,CAAC;QACD;;WAEG;QAEH,MAAM;YACL,OAAO,CAAC,IAA0B,EAAE,EAAE;gBACrC,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;oBACxC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE;wBAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;qBAChB;oBACD,OAAO,IAAA,wBAAY,EAAsB,IAAI,EAAE,GAAG,CAAC,CAAA;gBACpD,CAAC,EAAE,IAAI,CAAM,CAAA;YACd,CAAC,CAAA;QACF,CAAC;KACD,CAAA;IACD,OAAO,OAAO,CAAA;AACf,CAAC;AACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;AAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA"}

package/cjs/testing/test_type.d.ts

@@ -1,13 +1,19 @@
 import type { IsAny } from '../any/any_type.js';
+import type { IsBigint } from '../bigint/bigint_type.js';
+import type { IsStrictBigint } from '../bigint/strict_bigint_type.js';
 import type { IsBoolean } from '../boolean/boolean_type.js';
 import type { IsFalse } from '../boolean/false_type.js';
 import type { IsStrictBoolean } from '../boolean/strict_boolean_type.js';
 import type { IsTrue } from '../boolean/true_type.js';
 import type { Equal } from '../equal/equal.js';
 import type { IsNever } from '../never/never_type.js';
-import { IsNumber } from '../number/number_type.js';
+import type { IsNull } from '../null/null_type.js';
+import type { IsNumber } from '../number/number_type.js';
 import type { IsStrictNumber } from '../number/strict_number_type.js';
 import type { CanAssign } from '../predicates/CanAssign.js';
+import type { IsStrictString } from '../string/strict_string_type.js';
+import type { IsString } from '../string/string_type.js';
+import type { IsUndefined } from '../undefined/undefined_type.js';
 import type { IsUnknown } from '../unknown/unknown_type.js';
 import type { IsVoid } from '../void/void_type.js';
 /**
@@ -97,6 +103,42 @@ export declare const testType: {
      * @return `expected` as `T` for type inspection.
      */
     number<T_9>(expected: IsNumber<T_9>): T_9;
+    /**
+     * Check if type `T` is exactly `string`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    strictString<T_10>(expected: IsStrictString<T_10>): T_10;
+    /**
+     * Check if type `T` is `string` or string literals.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    string<T_11>(expected: IsString<T_11>): T_11;
+    /**
+     * Check if type `T` is exactly `bigint`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    strictBigint<T_12>(expected: IsStrictBigint<T_12>): T_12;
+    /**
+     * Check if type `T` is `bigint` or bigint literals.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    bigint<T_13>(expected: IsBigint<T_13>): T_13;
+    /**
+     * Check if type `T` is exactly `undefined`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    undefined<T_14>(expected: IsUndefined<T_14>): T_14;
+    /**
+     * Check if type `T` is exactly `null`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    null<T_15>(expected: IsNull<T_15>): T_15;
 };
 export {};
 //# sourceMappingURL=test_type.d.ts.map

package/cjs/testing/test_type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test_type.d.ts","sourceRoot":"","sources":["../../ts/testing/test_type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD;;;;GAIG;AACH,iBAAS,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAC/D;;;;GAIG;AACH,iBAAS,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAK9C;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;IACpB;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;;IAKH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;CAIH,CAAA"}
+{"version":3,"file":"test_type.d.ts","sourceRoot":"","sources":["../../ts/testing/test_type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD;;;;GAIG;AACH,iBAAS,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAC/D;;;;GAIG;AACH,iBAAS,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAK9C;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;IACpB;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;;IAKH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;CAIH,CAAA"}

package/cjs/testing/test_type.js

@@ -100,6 +100,54 @@ exports.testType = {
      */
     number(expected) {
         return expected;
+    },
+    /**
+     * Check if type `T` is exactly `string`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    strictString(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is `string` or string literals.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    string(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is exactly `bigint`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    strictBigint(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is `bigint` or bigint literals.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    bigint(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is exactly `undefined`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    undefined(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is exactly `null`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    null(expected) {
+        return expected;
     }
 };
 //# sourceMappingURL=test_type.js.map

package/cjs/testing/test_type.js.map

@@ -1 +1 @@
-{"version":3,"file":"test_type.js","sourceRoot":"","sources":["../../ts/testing/test_type.ts"],"names":[],"mappings":";;;AAyBA,SAAS,KAAK,CAAC,QAAiB;IAC/B,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED;;;;;;GAMG;AACU,QAAA,QAAQ,GAAG;IACvB;;;;OAIG;IACH,GAAG,CAAI,QAAkB;QACxB,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAI,QAAsB;QAChC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,KAAK,CAAI,QAAoB;QAC5B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD,KAAK;IACL;;;;OAIG;IACH,SAAS,CAAO,QAAyB;QACxC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,aAAa,CAAI,QAA4B;QAC5C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAI,QAAsB;QAChC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,KAAK,CAAI,QAAoB;QAC5B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAI,QAA2B;QAC1C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,MAAM,CAAI,QAAqB;QAC9B,OAAO,QAAa,CAAA;IACrB,CAAC;CACD,CAAA"}
+{"version":3,"file":"test_type.js","sourceRoot":"","sources":["../../ts/testing/test_type.ts"],"names":[],"mappings":";;;AA+BA,SAAS,KAAK,CAAC,QAAiB;IAC/B,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED;;;;;;GAMG;AACU,QAAA,QAAQ,GAAG;IACvB;;;;OAIG;IACH,GAAG,CAAI,QAAkB;QACxB,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAI,QAAsB;QAChC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,KAAK,CAAI,QAAoB;QAC5B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD,KAAK;IACL;;;;OAIG;IACH,SAAS,CAAO,QAAyB;QACxC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,aAAa,CAAI,QAA4B;QAC5C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAI,QAAsB;QAChC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,KAAK,CAAI,QAAoB;QAC5B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAI,QAA2B;QAC1C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,MAAM,CAAI,QAAqB;QAC9B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAI,QAA2B;QAC1C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,MAAM,CAAI,QAAqB;QAC9B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAI,QAA2B;QAC1C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,MAAM,CAAI,QAAqB;QAC9B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,SAAS,CAAI,QAAwB;QACpC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;CACD,CAAA"}

package/esm/testing/stub.d.ts

@@ -1,15 +1,28 @@
 import type { AnyFunction } from '../function/any_function.js';
 import type { RecursivePartial } from '../object/RecursivePartial.js';
 import type { NoInfer } from '../type/no_infer.js';
-export declare namespace stub {
-    type Param<T> = T extends AnyFunction ? T : RecursivePartial<NoInfer<T>>;
-}
+/**
+ * stub a value.
+ * If the value is a function, it will be passed through as-is.
+ */
 export declare function stub<T extends AnyFunction>(stub: T): T;
 export declare function stub<T>(stub: RecursivePartial<NoInfer<T>>): T;
 export declare namespace stub {
-    var build: {
-        <T>(): (stub?: Param<T> | undefined) => T;
-        <T_1>(init: RecursivePartial<T_1> | ((stub?: Param<T_1> | undefined) => RecursivePartial<T_1>)): (stub?: Param<T_1> | undefined) => T_1;
+    var build: <T>(init: RecursivePartial<T> | ((stub?: RecursivePartial<T> | undefined) => RecursivePartial<T>)) => (stub?: RecursivePartial<T> | undefined) => T;
+    var builder: <T>(init: RecursivePartial<T> | ((stub?: RecursivePartial<T> | undefined) => RecursivePartial<T>)) => {
+        /**
+         * Adds an init object or handler to the builder.
+         *
+         * If `init` is an object, it will be merged with the stub object.
+         * If `init` is a function, it will be called with the stub object.
+         *
+         * @return {Builder<T>} The builder instance.
+         */
+        with(init: RecursivePartial<T> | ((stub?: RecursivePartial<T> | undefined) => RecursivePartial<T>)): any;
+        /**
+         * Creates the resulting stub function.
+         */
+        create(): (stub?: RecursivePartial<T> | undefined) => T;
     };
 }
 //# sourceMappingURL=stub.d.ts.map

package/esm/testing/stub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../ts/testing/stub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,yBAAiB,IAAI,CAAC;IACrB,KAAY,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;CAC/E;AAED,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;AACvD,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;yBAA9C,IAAI"}
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../ts/testing/stub.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAA;AACvD,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;yBAA9C,IAAI;;;QAqClB;;;;;;;WAOG;;QAIH;;WAEG"}

package/esm/testing/stub.js

@@ -3,15 +3,54 @@ export function stub(stub) {
     return stub;
 }
 function build(init) {
-    return function (value) {
-        if (typeof init === 'function') {
-            return init(value);
-        }
-        if (init) {
-            return requiredDeep(init, value);
+    return builder(init).create();
+}
+/**
+ * Create a builder for a stub function of type T.
+ *
+ * The builder contains two methods:
+ *
+ * `.with()`: adds additional handler or partial stub.
+ * `.create()`: creates the final stub function.
+ *
+ * @example
+ * ```ts
+ * const b = stub.builder<{ a: number; b: string }>({ a: 1 }).with({ b: 'b' }).create()
+ * b({ a: 2 }) // { a: 2, b: 'b' }
+ * ```
+ */
+function builder(init) {
+    return builderInternal([init]);
+}
+function builderInternal(initializers) {
+    const builder = {
+        /**
+         * Adds an init object or handler to the builder.
+         *
+         * If `init` is an object, it will be merged with the stub object.
+         * If `init` is a function, it will be called with the stub object.
+         *
+         * @return {Builder<T>} The builder instance.
+         */
+        with(init) {
+            return builderInternal([...initializers, init]);
+        },
+        /**
+         * Creates the resulting stub function.
+         */
+        create() {
+            return (stub) => {
+                return initializers.reduce((acc, init) => {
+                    if (typeof init === 'function') {
+                        return init(acc);
+                    }
+                    return requiredDeep(init, acc);
+                }, stub);
+            };
         }
-        return value;
     };
+    return builder;
 }
 stub.build = build;
+stub.builder = builder;
 //# sourceMappingURL=stub.js.map

package/esm/testing/stub.js.map

@@ -1 +1 @@
-{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../ts/testing/stub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAWxC,MAAM,UAAU,IAAI,CAAI,IAAa;IACpC,OAAO,IAAS,CAAA;AACjB,CAAC;AASD,SAAS,KAAK,CAAI,IAA4E;IAC7F,OAAO,UAAU,KAAqB;QACrC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE;YAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA;SAClB;QACD,IAAI,IAAI,EAAE;YACT,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;SAChC;QACD,OAAO,KAAK,CAAA;IACb,CAAC,CAAA;AACF,CAAC;AAED,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA"}
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../ts/testing/stub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAWxC,MAAM,UAAU,IAAI,CAAI,IAAa;IACpC,OAAO,IAAS,CAAA;AACjB,CAAC;AAQD,SAAS,KAAK,CAAI,IAAiF;IAClG,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAA;AAC9B,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,OAAO,CAAI,IAAiF;IACpG,OAAO,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AAC/B,CAAC;AAED,SAAS,eAAe,CACvB,YAAgG;IAEhG,MAAM,OAAO,GAAG;QACf;;;;;;;WAOG;QACH,IAAI,CAAC,IAAiF;YACrF,OAAO,eAAe,CAAC,CAAC,GAAG,YAAY,EAAE,IAAI,CAAC,CAAC,CAAA;QAChD,CAAC;QACD;;WAEG;QAEH,MAAM;YACL,OAAO,CAAC,IAA0B,EAAE,EAAE;gBACrC,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;oBACxC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE;wBAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;qBAChB;oBACD,OAAO,YAAY,CAAsB,IAAI,EAAE,GAAG,CAAC,CAAA;gBACpD,CAAC,EAAE,IAAI,CAAM,CAAA;YACd,CAAC,CAAA;QACF,CAAC;KACD,CAAA;IACD,OAAO,OAAO,CAAA;AACf,CAAC;AACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;AAClB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA"}

package/esm/testing/test_type.d.ts

@@ -1,13 +1,19 @@
 import type { IsAny } from '../any/any_type.js';
+import type { IsBigint } from '../bigint/bigint_type.js';
+import type { IsStrictBigint } from '../bigint/strict_bigint_type.js';
 import type { IsBoolean } from '../boolean/boolean_type.js';
 import type { IsFalse } from '../boolean/false_type.js';
 import type { IsStrictBoolean } from '../boolean/strict_boolean_type.js';
 import type { IsTrue } from '../boolean/true_type.js';
 import type { Equal } from '../equal/equal.js';
 import type { IsNever } from '../never/never_type.js';
-import { IsNumber } from '../number/number_type.js';
+import type { IsNull } from '../null/null_type.js';
+import type { IsNumber } from '../number/number_type.js';
 import type { IsStrictNumber } from '../number/strict_number_type.js';
 import type { CanAssign } from '../predicates/CanAssign.js';
+import type { IsStrictString } from '../string/strict_string_type.js';
+import type { IsString } from '../string/string_type.js';
+import type { IsUndefined } from '../undefined/undefined_type.js';
 import type { IsUnknown } from '../unknown/unknown_type.js';
 import type { IsVoid } from '../void/void_type.js';
 /**
@@ -97,6 +103,42 @@ export declare const testType: {
      * @return `expected` as `T` for type inspection.
      */
     number<T_9>(expected: IsNumber<T_9>): T_9;
+    /**
+     * Check if type `T` is exactly `string`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    strictString<T_10>(expected: IsStrictString<T_10>): T_10;
+    /**
+     * Check if type `T` is `string` or string literals.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    string<T_11>(expected: IsString<T_11>): T_11;
+    /**
+     * Check if type `T` is exactly `bigint`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    strictBigint<T_12>(expected: IsStrictBigint<T_12>): T_12;
+    /**
+     * Check if type `T` is `bigint` or bigint literals.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    bigint<T_13>(expected: IsBigint<T_13>): T_13;
+    /**
+     * Check if type `T` is exactly `undefined`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    undefined<T_14>(expected: IsUndefined<T_14>): T_14;
+    /**
+     * Check if type `T` is exactly `null`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    null<T_15>(expected: IsNull<T_15>): T_15;
 };
 export {};
 //# sourceMappingURL=test_type.d.ts.map

package/esm/testing/test_type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test_type.d.ts","sourceRoot":"","sources":["../../ts/testing/test_type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD;;;;GAIG;AACH,iBAAS,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAC/D;;;;GAIG;AACH,iBAAS,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAK9C;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;IACpB;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;;IAKH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;CAIH,CAAA"}
+{"version":3,"file":"test_type.d.ts","sourceRoot":"","sources":["../../ts/testing/test_type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD;;;;GAIG;AACH,iBAAS,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAC/D;;;;GAIG;AACH,iBAAS,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAK9C;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ;IACpB;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;;IAKH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;IAIH;;;;OAIG;;CAIH,CAAA"}

package/esm/testing/test_type.js

@@ -97,6 +97,54 @@ export const testType = {
      */
     number(expected) {
         return expected;
+    },
+    /**
+     * Check if type `T` is exactly `string`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    strictString(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is `string` or string literals.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    string(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is exactly `bigint`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    strictBigint(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is `bigint` or bigint literals.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    bigint(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is exactly `undefined`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    undefined(expected) {
+        return expected;
+    },
+    /**
+     * Check if type `T` is exactly `null`.
+     *
+     * @return `expected` as `T` for type inspection.
+     */
+    null(expected) {
+        return expected;
     }
 };
 //# sourceMappingURL=test_type.js.map

package/esm/testing/test_type.js.map

@@ -1 +1 @@
-{"version":3,"file":"test_type.js","sourceRoot":"","sources":["../../ts/testing/test_type.ts"],"names":[],"mappings":"AAyBA,SAAS,KAAK,CAAC,QAAiB;IAC/B,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB;;;;OAIG;IACH,GAAG,CAAI,QAAkB;QACxB,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAI,QAAsB;QAChC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,KAAK,CAAI,QAAoB;QAC5B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD,KAAK;IACL;;;;OAIG;IACH,SAAS,CAAO,QAAyB;QACxC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,aAAa,CAAI,QAA4B;QAC5C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAI,QAAsB;QAChC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,KAAK,CAAI,QAAoB;QAC5B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAI,QAA2B;QAC1C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,MAAM,CAAI,QAAqB;QAC9B,OAAO,QAAa,CAAA;IACrB,CAAC;CACD,CAAA"}
+{"version":3,"file":"test_type.js","sourceRoot":"","sources":["../../ts/testing/test_type.ts"],"names":[],"mappings":"AA+BA,SAAS,KAAK,CAAC,QAAiB;IAC/B,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB;;;;OAIG;IACH,GAAG,CAAI,QAAkB;QACxB,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAI,QAAsB;QAChC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,KAAK,CAAI,QAAoB;QAC5B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD,KAAK;IACL;;;;OAIG;IACH,SAAS,CAAO,QAAyB;QACxC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,aAAa,CAAI,QAA4B;QAC5C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,OAAO,CAAI,QAAsB;QAChC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,KAAK,CAAI,QAAoB;QAC5B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAI,QAA2B;QAC1C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,MAAM,CAAI,QAAqB;QAC9B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAI,QAA2B;QAC1C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,MAAM,CAAI,QAAqB;QAC9B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,YAAY,CAAI,QAA2B;QAC1C,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,MAAM,CAAI,QAAqB;QAC9B,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,SAAS,CAAI,QAAwB;QACpC,OAAO,QAAa,CAAA;IACrB,CAAC;IACD;;;;OAIG;IACH,IAAI,CAAI,QAAmB;QAC1B,OAAO,QAAa,CAAA;IACrB,CAAC;CACD,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "type-plus",
-  "version": "6.7.1",
+  "version": "6.8.1",
   "description": "Provides additional types for TypeScript.",
   "homepage": "https://github.com/unional/type-plus",
   "bugs": {
@@ -41,7 +41,7 @@
     "@commitlint/cli": "^17.0.2",
     "@commitlint/config-conventional": "^17.0.2",
     "@jest/globals": "^29.5.0",
-    "@repobuddy/jest": "^3.1.5",
+    "@repobuddy/jest": "^3.4.0",
     "@size-limit/esbuild-why": "^8.2.4",
     "@size-limit/preset-small-lib": "^8.2.4",
     "@types/node": "^18.0.0",
@@ -91,6 +91,7 @@
     "test:watch": "cross-env NODE_OPTIONS=--experimental-vm-modules NODE_NO_WARNINGS=1 jest --watch",
     "verify": "npm-run-all clean -p build depcheck lint coverage -p size",
     "version": "changeset version",
-    "watch": "jest --watch"
+    "watch": "cross-env NODE_OPTIONS=--experimental-vm-modules NODE_NO_WARNINGS=1 jest --watch",
+    "w": "cross-env NODE_OPTIONS=--experimental-vm-modules NODE_NO_WARNINGS=1 jest --watch"
   }
 }

package/ts/testing/stub.ts

@@ -3,10 +3,10 @@ import type { AnyFunction } from '../function/any_function.js'
 import type { RecursivePartial } from '../object/RecursivePartial.js'
 import type { NoInfer } from '../type/no_infer.js'
 
-export namespace stub {
-	export type Param<T> = T extends AnyFunction ? T : RecursivePartial<NoInfer<T>>
-}
-
+/**
+ * stub a value.
+ * If the value is a function, it will be passed through as-is.
+ */
 export function stub<T extends AnyFunction>(stub: T): T
 export function stub<T>(stub: RecursivePartial<NoInfer<T>>): T
 export function stub<T>(stub: unknown): T {
@@ -16,20 +16,62 @@ export function stub<T>(stub: unknown): T {
 /**
  * builds a stub function
  */
-function build<T>(): (stub?: stub.Param<T>) => T
 function build<T>(
-	init: RecursivePartial<T> | ((stub?: stub.Param<T>) => RecursivePartial<T>)
-): (stub?: stub.Param<T>) => T
-function build<T>(init?: RecursivePartial<T> | ((stub?: stub.Param<T>) => RecursivePartial<T>)) {
-	return function (value?: stub.Param<T>) {
-		if (typeof init === 'function') {
-			return init(value)
-		}
-		if (init) {
-			return requiredDeep(init, value)
+	init: RecursivePartial<T> | ((stub?: RecursivePartial<T>) => RecursivePartial<T>)
+): (stub?: RecursivePartial<T>) => T
+function build<T>(init: RecursivePartial<T> | ((stub?: RecursivePartial<T>) => RecursivePartial<T>)) {
+	return builder(init).create()
+}
+
+/**
+ * Create a builder for a stub function of type T.
+ *
+ * The builder contains two methods:
+ *
+ * `.with()`: adds additional handler or partial stub.
+ * `.create()`: creates the final stub function.
+ *
+ * @example
+ * ```ts
+ * const b = stub.builder<{ a: number; b: string }>({ a: 1 }).with({ b: 'b' }).create()
+ * b({ a: 2 }) // { a: 2, b: 'b' }
+ * ```
+ */
+function builder<T>(init: RecursivePartial<T> | ((stub?: RecursivePartial<T>) => RecursivePartial<T>)) {
+	return builderInternal([init])
+}
+
+function builderInternal<T>(
+	initializers: Array<RecursivePartial<T> | ((stub?: RecursivePartial<T>) => RecursivePartial<T>)>
+) {
+	const builder = {
+		/**
+		 * Adds an init object or handler to the builder.
+		 *
+		 * If `init` is an object, it will be merged with the stub object.
+		 * If `init` is a function, it will be called with the stub object.
+		 *
+		 * @return {Builder<T>} The builder instance.
+		 */
+		with(init: RecursivePartial<T> | ((stub?: RecursivePartial<T>) => RecursivePartial<T>)) {
+			return builderInternal([...initializers, init])
+		},
+		/**
+		 * Creates the resulting stub function.
+		 */
+
+		create() {
+			return (stub?: RecursivePartial<T>) => {
+				return initializers.reduce((acc, init) => {
+					if (typeof init === 'function') {
+						return init(acc)
+					}
+					return requiredDeep<RecursivePartial<T>>(init, acc)
+				}, stub) as T
+			}
 		}
-		return value
 	}
+	return builder
 }
-
 stub.build = build
+stub.builder = builder

package/ts/testing/test_type.ts

@@ -1,13 +1,19 @@
 import type { IsAny } from '../any/any_type.js'
+import type { IsBigint } from '../bigint/bigint_type.js'
+import type { IsStrictBigint } from '../bigint/strict_bigint_type.js'
 import type { IsBoolean } from '../boolean/boolean_type.js'
 import type { IsFalse } from '../boolean/false_type.js'
 import type { IsStrictBoolean } from '../boolean/strict_boolean_type.js'
 import type { IsTrue } from '../boolean/true_type.js'
 import type { Equal } from '../equal/equal.js'
 import type { IsNever } from '../never/never_type.js'
-import { IsNumber } from '../number/number_type.js'
+import type { IsNull } from '../null/null_type.js'
+import type { IsNumber } from '../number/number_type.js'
 import type { IsStrictNumber } from '../number/strict_number_type.js'
 import type { CanAssign } from '../predicates/CanAssign.js'
+import type { IsStrictString } from '../string/strict_string_type.js'
+import type { IsString } from '../string/string_type.js'
+import type { IsUndefined } from '../undefined/undefined_type.js'
 import type { IsUnknown } from '../unknown/unknown_type.js'
 import type { IsVoid } from '../void/void_type.js'
 
@@ -123,5 +129,53 @@ export const testType = {
 	 */
 	number<T>(expected: IsNumber<T>) {
 		return expected as T
+	},
+	/**
+	 * Check if type `T` is exactly `string`.
+	 *
+	 * @return `expected` as `T` for type inspection.
+	 */
+	strictString<T>(expected: IsStrictString<T>) {
+		return expected as T
+	},
+	/**
+	 * Check if type `T` is `string` or string literals.
+	 *
+	 * @return `expected` as `T` for type inspection.
+	 */
+	string<T>(expected: IsString<T>) {
+		return expected as T
+	},
+	/**
+	 * Check if type `T` is exactly `bigint`.
+	 *
+	 * @return `expected` as `T` for type inspection.
+	 */
+	strictBigint<T>(expected: IsStrictBigint<T>) {
+		return expected as T
+	},
+	/**
+	 * Check if type `T` is `bigint` or bigint literals.
+	 *
+	 * @return `expected` as `T` for type inspection.
+	 */
+	bigint<T>(expected: IsBigint<T>) {
+		return expected as T
+	},
+	/**
+	 * Check if type `T` is exactly `undefined`.
+	 *
+	 * @return `expected` as `T` for type inspection.
+	 */
+	undefined<T>(expected: IsUndefined<T>) {
+		return expected as T
+	},
+	/**
+	 * Check if type `T` is exactly `null`.
+	 *
+	 * @return `expected` as `T` for type inspection.
+	 */
+	null<T>(expected: IsNull<T>) {
+		return expected as T
 	}
 }

package/ts/tuple/readme.md

@@ -1,7 +1,6 @@
-# unknown
+# Tuple
 
-`unknown` is one of the top type in TypeScript.
-It is a "safer" variant of `any` that you cannot use the value until there are some type guards or type assertions to the value.
+A *tuple type* is another sort of `Array` type that knows exactly how many elements it contains, and exactly which types it contains at specific positions.
 
 ## Type Checking
 
@@ -10,18 +9,20 @@ The `TupleType<T>` and friends are used to check if `T` is a tuple, excluding ar
 ```ts
 import type { TupleType } from 'type-plus'
 
-type R = TupleType<unknown> // unknown
+type R = TupleType<[]> // []
+type R = TupleType<[1]> // [1]
 
-type R = TupleType<1> // never
+type R = TupleType<number[]> // never
+type R = TupleType<number> // never
 ```
 
-- [`TupleType<T, Then = T, Else = never>`](unknown_type.ts#L16): check if `T` is `unknown`.
-- [`IsUnknown<T, Then = true, Else = false`](unknown_type.ts#L35): is `T` `unknown`.
-- [`NotUnknownType<T, Then = T, Else = never>`](unknown_type.ts#L50): check if `T` is not `unknown`.
-- [`IsNotUnknown<T, Then = true, Else = false>`](unknown_type.ts#L65): is `T` not `unknown`.
+- [`TupleType<T, Then = T, Else = never>`](tuple_type.ts#L16): check if `T` is a *tuple*.
+- [`IsTuple<T, Then = true, Else = false`](tuple_type.ts#L35): is `T` *tuple*.
+- [`NotTupleType<T, Then = T, Else = never>`](tuple_type.ts#L50): check if `T` is not *tuple*.
+- [`IsNotTuple<T, Then = true, Else = false>`](tuple_type.ts#L65): is `T` not *tuple*.
 
 ## References
 
 - [Handbook]
 
-[handbook]: https://www.typescriptlang.org/docs/handbook/2/functions.html#unknown
+[handbook]: https://www.typescriptlang.org/docs/handbook/2/objects.html#tuple-types