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

package/cjs/string/is_template_literal.d.ts

@@ -0,0 +1,75 @@
+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 { $IsDistributive } from '../type_plus/branch/$is_distributive.js';
+import type { $ResolveBranch } from '../type_plus/branch/$resolve_branch.js';
+import type { $Else, $Then } from '../type_plus/branch/$selection.js';
+import type { _StringType } from './_string_type.js';
+/**
+ * 🎭 *validate*
+ *
+ * Validate if `T` is a template literal(s).
+ *
+ * @example
+ * ```ts
+ * type R = IsTemplateLiteral<string> // false
+ * type R = IsTemplateLiteral<'foo'> // false
+ * type R = IsTemplateLiteral<`a${number}`> // true
+ *
+ * type R = IsTemplateLiteral<`a${number}` | `${bigint}c`> // true
+ *
+ * type R = IsTemplateLiteral<never> // false
+ * type R = IsTemplateLiteral<unknown> // false
+ * type R = IsTemplateLiteral<`${number}` | boolean> // boolean
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Filter to ensure `T` is a template literal(s), otherwise returns `never`.
+ *
+ * @example
+ * ```ts
+ * type R = IsTemplateLiteral<`${number}`, { selection: 'filter' }> // `${number}`
+ * type R = IsTemplateLiteral<'a', { selection: 'filter' }> // never
+ * ```
+ *
+ * 🔢 *customize*:
+ *
+ * Disable distribution of union types.
+ *
+ * ```ts
+ * type R = IsTemplateLiteral<`${number}` | 1> // boolean
+ * type R = IsTemplateLiteral<`${number}` | 1, { distributive: false }> // false
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Use unique branch identifiers to allow precise processing of the result.
+ *
+ * @example
+ * ```ts
+ * type R = IsTemplateLiteral<`${number}`, $IsTemplateLiteral.$Branch> // $Then
+ * type R = IsTemplateLiteral<bigint, $IsString.$Branch> // $Else
+ * ```
+ */
+export type IsTemplateLiteral<T, $O extends IsTemplateLiteral.$Options = {}> = $SpecialType<T, $MergeOptions<$O, {
+    $then: $ResolveBranch<T, $O, [$Else]>;
+    $else: IsTemplateLiteral.$<T, $O>;
+}>>;
+export declare namespace IsTemplateLiteral {
+    export type $Options = $Equality.$Options;
+    export type $Branch<$O extends $Options = {}> = $Equality.$Branch<$O>;
+    export type $UtilOptions = Assignable.$UtilOptions;
+    export type $<T, $O extends $UtilOptions> = $IsDistributive<$O, {
+        $then: _D<T, $O>;
+        $else: _N<T, $O>;
+    }>;
+    type _D<T, $O extends $UtilOptions> = T extends string ? _StringType<T> extends infer R ? R extends 'templateLiteral' ? $ResolveBranch<T, $O, [$Then]> : $ResolveBranch<T, $O, [$Else]> : never : $ResolveBranch<T, $O, [$Else]>;
+    type _N<T, $O extends $UtilOptions> = _D<T, {
+        $then: $Then;
+        $else: $Else;
+    }> extends infer R ? $Then | $Else extends R ? $ResolveBranch<T, $O, [$Else]> : $ResolveBranch<T, $O, [R]> : never;
+    export {};
+}
+//# sourceMappingURL=is_template_literal.d.ts.map

package/cjs/string/is_template_literal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_template_literal.d.ts","sourceRoot":"","sources":["../../src/string/is_template_literal.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,eAAe,EAAE,MAAM,yCAAyC,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAA;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAA;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,EAAE,SAAS,iBAAiB,CAAC,QAAQ,GAAG,EAAE,IAAI,YAAY,CAC1F,CAAC,EACD,aAAa,CACZ,EAAE,EACF;IACC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACrC,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;CACjC,CACD,CACD,CAAA;AAED,yBAAiB,iBAAiB,CAAC;IAClC,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAA;IACzC,MAAM,MAAM,OAAO,CAAC,EAAE,SAAS,QAAQ,GAAG,EAAE,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAErE,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAA;IAElD,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,YAAY,IAAI,eAAe,CAAC,EAAE,EAAE;QAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;KAAE,CAAC,CAAA;IAEvG,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,YAAY,IAAI,CAAC,SAAS,MAAM,GACnD,WAAW,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,GAC7B,CAAC,SAAS,iBAAiB,GAC1B,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAC9B,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAC/B,KAAK,GACN,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEjC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,YAAY,IAAI,EAAE,CAAC,CAAC,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,SAAS,MAAM,CAAC,GACxF,KAAK,GAAG,KAAK,SAAS,CAAC,GACtB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAC9B,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAC3B,KAAK,CAAA;;CACR"}

package/cjs/string/is_template_literal.js

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

package/cjs/string/is_template_literal.js.map

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

package/cjs/string/string.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Check if `Subject` includes `Search`.
+ * If either of them is not a string, returns `Else`.
+ *
+ * ```ts
+ * type R = StringIncludes<'abc', 'a'> // true
+ *
+ * type R = StringIncludes<'abc', 'd'> // false
+ * ```
+ */
+export type StringIncludes<Subject extends string, Search extends string, Then = true, Else = false> = Subject extends `${infer _X}${Search}${infer _Y}` ? Then : Else;
+/**
+ * Split a string into substrings using the specified separator,
+ * and return them as an array.
+ *
+ * ```ts
+ * type R = StringSplit<'abc', ''> // ['a', 'b', 'c']
+ * type R = StringSplit<'abc', 'a'> // ['', 'bc']
+ * type R = StringSplit<'abc', 'b'> // ['a', 'c']
+ * type R = StringSplit<'abc', 'c'> // ['ab', '']
+ * ```
+ */
+export type StringSplit<Subject extends string, Seperator extends string> = Subject extends `${infer A}${Seperator}${infer B}` ? [A, ...StringSplit<B, Seperator>] : Seperator extends '' ? [] : [Subject];
+//# sourceMappingURL=string.d.ts.map

package/cjs/string/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/string/string.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,CACzB,OAAO,SAAS,MAAM,EACtB,MAAM,SAAS,MAAM,EACrB,IAAI,GAAG,IAAI,EACX,IAAI,GAAG,KAAK,IACT,OAAO,SAAS,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAEnE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,CACtB,OAAO,SAAS,MAAM,EACtB,SAAS,SAAS,MAAM,IACrB,OAAO,SAAS,GAAG,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,EAAE,GACnD,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GACjC,SAAS,SAAS,EAAE,GACnB,EAAE,GACF,CAAC,OAAO,CAAC,CAAA"}

package/cjs/string/string.js

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

package/cjs/string/string.js.map

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

package/cjs/string/string_plus.d.ts

@@ -0,0 +1,27 @@
+import type { StringIncludes, StringSplit } from './string.js';
+export declare namespace StringPlus {
+    /**
+     * Check if `Subject` includes `Search`.
+     * If either of them is not a string, returns `Else`.
+     *
+     * ```ts
+     * type R = StringPlus.Includes<'abc', 'a'> // true
+     *
+     * type R = StringPlus.Includes<'abc', 'd'> // false
+     * ```
+     */
+    type Includes<Subject extends string, Search extends string, Then = true, Else = false> = StringIncludes<Subject, Search, Then, Else>;
+    /**
+     * Split a string into substrings using the specified separator,
+     * and return them as an array.
+     *
+     * ```ts
+     * type R = StringPlus.Split<'abc', ''> // ['a', 'b', 'c']
+     * type R = StringPlus.Split<'abc', 'a'> // ['', 'bc']
+     * type R = StringPlus.Split<'abc', 'b'> // ['a', 'c']
+     * type R = StringPlus.Split<'abc', 'c'> // ['ab', '']
+     * ```
+     */
+    type Split<Subject extends string, Seperator extends string> = StringSplit<Subject, Seperator>;
+}
+//# sourceMappingURL=string_plus.d.ts.map

package/cjs/string/string_plus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string_plus.d.ts","sourceRoot":"","sources":["../../src/string/string_plus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9D,yBAAiB,UAAU,CAAC;IAC3B;;;;;;;;;OASG;IACH,KAAY,QAAQ,CAAC,OAAO,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK,IAAI,cAAc,CAC9G,OAAO,EACP,MAAM,EACN,IAAI,EACJ,IAAI,CACJ,CAAA;IAED;;;;;;;;;;OAUG;IACH,KAAY,KAAK,CAAC,OAAO,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;CACrG"}

package/cjs/string/string_plus.js

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

package/cjs/string/string_plus.js.map

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

package/cjs/symbol/is_not_symbol.d.ts

@@ -0,0 +1,71 @@
+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';
+/**
+ * 🎭 *predicate*
+ *
+ * Validate if `T` is not `symbol`.
+ *
+ * ```ts
+ * type R = IsNotSymbol<symbol> // false
+ *
+ * type R = IsNotSymbol<never> // true
+ * type R = IsNotSymbol<unknown> // true
+ * type R = IsNotSymbol<string | boolean> // true
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Filter to ensure `T` is not `symbol`, otherwise returns `never`.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotSymbol<symbol, { selection: 'filter' }> // never
+ *
+ * type R = IsNotSymbol<never, { selection: 'filter' }> // never
+ * type R = IsNotSymbol<unknown, { selection: 'filter' }> // unknown
+ * type R = IsNotSymbol<symbol | string, { selection: 'filter' }> // string
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Disable distribution of union types.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotSymbol<symbol | 1> // boolean
+ * type R = IsNotSymbol<symbol | 1, { distributive: false }> // true
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Use unique branch identifiers to allow precise processing of the result.
+ *
+ * @example
+ * ```ts
+ * type R = IsNotSymbol<string, $SelectionBranch> // $Then
+ * type R = IsNotSymbol<symbol, $SelectionBranch> // $Else
+ * ```
+ */
+export type IsNotSymbol<T, $O extends IsNotSymbol.$Options = {}> = $SpecialType<T, $MergeOptions<$O, {
+    $then: $ResolveBranch<T, $O, [$Then]>;
+    $else: IsNotSymbol.$<T, $O>;
+}>>;
+export declare namespace IsNotSymbol {
+    type $Options = $Equality.$Options;
+    type $Branch<$O extends $Options = {}> = $Equality.$Branch<$O>;
+    /**
+     * 🧰 *type util*
+     *
+     * Validate if `T` is `null`.
+     *
+     * This is a type util for building custom types.
+     * It does not check against special types.
+     */
+    type $<T, $O extends $UtilOptions> = NotAssignable.$<T, symbol, $O>;
+    type $UtilOptions = NotAssignable.$UtilOptions;
+}
+//# sourceMappingURL=is_not_symbol.d.ts.map

package/cjs/symbol/is_not_symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_not_symbol.d.ts","sourceRoot":"","sources":["../../src/symbol/is_not_symbol.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;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,EAAE,SAAS,WAAW,CAAC,QAAQ,GAAG,EAAE,IAAI,YAAY,CAC9E,CAAC,EACD,aAAa,CACZ,EAAE,EACF;IACC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACrC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;CAC3B,CACD,CACD,CAAA;AAED,yBAAiB,WAAW,CAAC;IAC5B,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,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;IAE1E,KAAY,YAAY,GAAG,aAAa,CAAC,YAAY,CAAA;CACrD"}

package/cjs/symbol/is_not_symbol.js

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

package/cjs/symbol/is_not_symbol.js.map

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

package/cjs/symbol/is_symbol.d.ts

@@ -0,0 +1,73 @@
+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';
+/**
+ * 🎭 *predicate*
+ *
+ * Validate if `T` is `symbol`.
+ *
+ * @example
+ * ```ts
+ * type R = IsSymbol<symbol> // true
+ *
+ * type R = IsSymbol<never> // false
+ * type R = IsSymbol<unknown> // false
+ * type R = IsSymbol<symbol | number> // boolean
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Filter to ensure `T` is `symbol`, otherwise returns `never`.
+ *
+ * @example
+ * ```ts
+ * type R = IsSymbol<symbol, { selection: 'filter' }> // symbol
+ *
+ * type R = IsSymbol<never, { selection: 'filter' }> // never
+ * type R = IsSymbol<unknown, { selection: 'filter' }> // never
+ * type R = IsSymbol<string | boolean, { selection: 'filter' }> // never
+ *
+ * type R = IsSymbol<symbol | null> // symbol
+ * ```
+ *
+ * 🔢 *customize*:
+ *
+ * Disable distribution of union types.
+ *
+ * ```ts
+ * type R = IsSymbol<symbol | 1> // boolean
+ * type R = IsSymbol<symbol | 1, { distributive: false }> // false
+ * ```
+ *
+ * 🔢 *customize*
+ *
+ * Use unique branch identifiers to allow precise processing of the result.
+ *
+ * @example
+ * ```ts
+ * type R = IsSymbol<symbol, $SelectionBranch> // $Then
+ * type R = IsSymbol<string, $SelectionBranch> // $Else
+ * ```
+ */
+export type IsSymbol<T, $O extends IsSymbol.$Options = {}> = $SpecialType<T, $MergeOptions<$O, {
+    $then: $ResolveBranch<T, $O, [$Else]>;
+    $else: IsSymbol.$<T, $O>;
+}>>;
+export declare namespace IsSymbol {
+    type $Options = $Equality.$Options;
+    type $Branch<$O extends $Options = {}> = $Equality.$Branch<$O>;
+    /**
+     * 🧰 *type util*
+     *
+     * Validate if `T` is `symbol`.
+     *
+     * This is a type util for building custom types.
+     * It does not check against special types.
+     */
+    type $<T, $O extends $UtilOptions> = Assignable.$<T, symbol, $O>;
+    type $UtilOptions = Assignable.$UtilOptions;
+}
+//# sourceMappingURL=is_symbol.d.ts.map

package/cjs/symbol/is_symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is_symbol.d.ts","sourceRoot":"","sources":["../../src/symbol/is_symbol.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;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,EAAE,SAAS,QAAQ,CAAC,QAAQ,GAAG,EAAE,IAAI,YAAY,CACxE,CAAC,EACD,aAAa,CACZ,EAAE,EACF;IACC,KAAK,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACrC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;CACxB,CACD,CACD,CAAA;AAED,yBAAiB,QAAQ,CAAC;IACzB,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,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;IAEvE,KAAY,YAAY,GAAG,UAAU,CAAC,YAAY,CAAA;CAClD"}

package/cjs/symbol/is_symbol.js

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

package/cjs/symbol/is_symbol.js.map

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

package/cjs/testing/stub.d.ts

@@ -0,0 +1,31 @@
+import type { AnyFunction } from '../function/any_function.js';
+import type { RecursivePartial } from '../object/recursive_partial.js';
+import type { NoInfer } from '../type/no_infer.js';
+/**
+ * stub a value.
+ *
+ * If the value is a function, it will be passed through as-is.
+ *
+ * 🦴 `utilities`
+ */
+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>(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

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../src/testing/stub.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD;;;;;;GAMG;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

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stub = void 0;
+const unpartial_1 = require("unpartial");
+function stub(stub) {
+    return stub;
+}
+exports.stub = stub;
+function build(init) {
+    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 builder;
+}
+stub.build = build;
+stub.builder = builder;
+//# sourceMappingURL=stub.js.map

package/cjs/testing/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../src/testing/stub.ts"],"names":[],"mappings":";;;AAAA,yCAAwC;AAexC,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,CAAC;wBAChC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;oBACjB,CAAC;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"}