lay-sing 0.3.0 → 0.4.0

package/README.md

@@ -9,12 +9,12 @@ TypeScript utilities for compile-time type testing and utility types
 
 ```ts
 // They do nothing at runtime
-expect<never>().toBe<never>().success
-expect<never>().toBeNever // alias for the above
-expect<never>().toBe<'should fail'>().fail
+expect<never>().to.be<never>().pass
+expect<never>().to.be.never // alias for the above
+expect<never>().to.be<'should fail'>().fail
 
-// Type Error: Property 'success' does not exist on type '{ fail: void; }'.
-expect<never>().toBe<'should fail'>().success
+// Type Error: Property 'pass' does not exist on type '{ fail: void; }'.
+expect<never>().to.be<'should fail'>().pass
 //                                    ^^^^^^^
 ```
 
@@ -84,11 +84,11 @@ The main module provides utilities for **compile-time** type validation. These u
 A typical type test statement follows this pattern:
 
 ```ts
-expect<ActualType>().toBe<ExpectedType>().success
+expect<ActualType>().to.be<ExpectedType>().pass
 ```
 
 - It starts with a function call like `expect<T>()` or `compare<T, U>()`
-- It ends with a property like `.success` or `.fail`
+- It ends with a property like `.pass` or `.fail`
 - Type error occurs only if the assertion fails
 
 > [!CAUTION]
@@ -96,8 +96,8 @@ expect<ActualType>().toBe<ExpectedType>().success
 > Only statements ending with property access are type assertions. Without property access, type error may never occur:
 >
 > ```diff
-> - expect<true>().toBe<false>()         // Type error never occur
-> + expect<true>().toBe<false>().success // Type Error: Property 'success' does not exist on type '{ fail: void; }'.
+> - expect<true>().to.be<false>()         // Type error never occur
+> + expect<true>().to.be<false>().pass // Type Error: Property 'pass' does not exist on type '{ fail: void; }'.
 > ```
 
 At runtime, the function always returns the `NOOP` object, which performs **no operation**. It can be accessed, called, or chained indefinitely without throwing errors.
@@ -106,26 +106,26 @@ At runtime, the function always returns the `NOOP` object, which performs **no o
 
 ```ts
 // Passes only if A and B are identical
-expect<keyof { a: 2 }>().toBe<'a'>().success
+expect<keyof { a: 2 }>().to.be<'a'>().pass
 
 // Passes if A extends B
-expect<12138>().toExtend<number>().success
+expect<12138>().to.extend<number>().pass
 
 // Passes if mutually assignable
-expect<{ a: 1; b: 2 }>().toEqual<{ a: 1 } & { b: 2 }>().success
+expect<{ a: 1; b: 2 }>().to.equal<{ a: 1 } & { b: 2 }>().pass
 
 // Test property existence
-expect<{ name: string }>().toHaveKey<'name'>().success
+expect<{ name: string }>().to.haveKey<'name'>().pass
 ```
 
 Aliases:
 
 ```ts
-expect<never>().toBe<never>().success
-expect<never>().toBeNever
+expect<never>().to.be<never>().pass
+expect<never>().to.be.never
 
-expect<'hello'>().toExtend<string>().success
-expect<'hello'>().toExtendString
+expect<'hello'>().to.extend<string>().pass
+expect<'hello'>().to.extend.string
 ```
 
 #### NOOP

package/esm/main/expect/index.d.ts

@@ -0,0 +1,31 @@
+import type { Exact } from '../../utils/index.js';
+import type { To } from './to/index.js';
+/**
+ * Represents the result of a type assertion based on a boolean condition.
+ *
+ * - If `true`, the result has a `pass` property;
+ * - If `false`, the result has a `fail` property;
+ * - Otherwise, the result is `never`
+ *
+ * @template B The boolean condition result (true or false)
+ * @template R The type of the result value (default is void)
+ */
+export type TypeAssertionResult<B extends boolean, R = void> = Exact<B, never> extends true ? never : [boolean] extends [B] ? never : [B] extends [true] ? {
+    /**
+     * This field exist only when this type assertion succeed
+     *
+     * If you expect this assertion to fail, use `.fail`
+     */
+    pass: R;
+} : [B] extends [false] ? {
+    /**
+     * This field exist only when this type assertion failed
+     *
+     * If you expect this assertion to pass, use `.pass`
+     */
+    fail: R;
+} : never;
+export type ExpectType<T> = {
+    to: To<T>;
+};
+//# sourceMappingURL=index.d.ts.map

package/esm/main/expect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/main/expect/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;GASG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG,KAAK,GAC/F,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,GAC7B,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG;IACnB;;;;OAIG;IACH,IAAI,EAAE,CAAC,CAAA;CACR,GACD,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;IACpB;;;;OAIG;IACH,IAAI,EAAE,CAAC,CAAA;CACR,GACD,KAAK,CAAA;AAET,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;CACV,CAAA"}

package/esm/main/expect/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/esm/main/expect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/main/expect/index.ts"],"names":[],"mappings":"","sourcesContent":["import type { Exact } from '../../utils/index.js'\nimport type { To } from './to/index.js'\n\n/**\n * Represents the result of a type assertion based on a boolean condition.\n *\n * - If `true`, the result has a `pass` property;\n * - If `false`, the result has a `fail` property;\n * - Otherwise, the result is `never`\n *\n * @template B The boolean condition result (true or false)\n * @template R The type of the result value (default is void)\n */\nexport type TypeAssertionResult<B extends boolean, R = void> = Exact<B, never> extends true ? never\n  : [boolean] extends [B] ? never\n  : [B] extends [true] ? {\n      /**\n       * This field exist only when this type assertion succeed\n       *\n       * If you expect this assertion to fail, use `.fail`\n       */\n      pass: R\n    }\n  : [B] extends [false] ? {\n      /**\n       * This field exist only when this type assertion failed\n       *\n       * If you expect this assertion to pass, use `.pass`\n       */\n      fail: R\n    }\n  : never\n\nexport type ExpectType<T> = {\n  to: To<T>\n}\n"]}

package/esm/main/expect/to/be.d.ts

@@ -0,0 +1,23 @@
+import type { Exact, If } from '../../../utils/index.js';
+import type { TypeAssertionResult } from '../index.js';
+export type Be<T> = {
+    <U>(): TypeAssertionResult<Exact<T, U>>;
+    <U>(_: U): TypeAssertionResult<Exact<T, U>>;
+} & If<Exact<T, any>, {
+    any: void;
+}, {}> & If<Exact<T, never>, {
+    never: void;
+}, {}> & If<Exact<T, unknown>, {
+    unknown: void;
+}, {}> & If<Exact<T, void>, {
+    void: void;
+}, {}> & If<Exact<T, null>, {
+    null: void;
+}, {}> & If<Exact<T, undefined>, {
+    undefined: void;
+}, {}> & If<Exact<T, true>, {
+    true: void;
+}, {}> & If<Exact<T, false>, {
+    false: void;
+}, {}>;
+//# sourceMappingURL=be.d.ts.map

package/esm/main/expect/to/be.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"be.d.ts","sourceRoot":"","sources":["../../../../src/main/expect/to/be.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,MAAM,EAAE,CAAC,CAAC,IACZ;IACA,CAAC,CAAC,KAAK,mBAAmB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACvC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;CAC5C,GACC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;IAAE,GAAG,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GACpC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GACxC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GAC5C,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GACtC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GACtC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GAChD,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GACtC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,CAAA"}

package/esm/main/expect/to/be.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=be.js.map

package/esm/main/expect/to/be.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"be.js","sourceRoot":"","sources":["../../../../src/main/expect/to/be.ts"],"names":[],"mappings":"","sourcesContent":["import type { Exact, If } from '../../../utils/index.js'\nimport type { TypeAssertionResult } from '../index.js'\n\nexport type Be<T> =\n  & {\n    <U>(): TypeAssertionResult<Exact<T, U>>\n    <U>(_: U): TypeAssertionResult<Exact<T, U>>\n  }\n  & If<Exact<T, any>, { any: void }, {}>\n  & If<Exact<T, never>, { never: void }, {}>\n  & If<Exact<T, unknown>, { unknown: void }, {}>\n  & If<Exact<T, void>, { void: void }, {}>\n  & If<Exact<T, null>, { null: void }, {}>\n  & If<Exact<T, undefined>, { undefined: void }, {}>\n  & If<Exact<T, true>, { true: void }, {}>\n  & If<Exact<T, false>, { false: void }, {}>\n"]}

package/esm/main/expect/to/equal.d.ts

@@ -0,0 +1,26 @@
+import type { MutuallyAssignable } from '../../../utils/index.js';
+import type { TypeAssertionResult } from '../index.js';
+export type Equal<T> = {
+    /**
+     * Tests if the current type is mutually assignable with the provided type U.
+     *
+     * It's like:
+     *
+     * ```ts ignore
+     * [T] extends [U] ? [U] extends [T] ? Yes : No : No
+     * ```
+     *
+     * @template U The type to compare with
+     *
+     * @example
+     * ```ts
+     * import { expect } from '@leawind/lay-sing'
+     *
+     * expect<{ a: 1; b: 2 }>().to.equal<{ a: 1 } & { b: 2 }>().pass
+     * expect<1>().to.equal<1 | 2>().fail
+     * ```
+     */
+    <U>(): TypeAssertionResult<MutuallyAssignable<T, U>>;
+    <U>(_: U): TypeAssertionResult<MutuallyAssignable<T, U>>;
+};
+//# sourceMappingURL=equal.d.ts.map

package/esm/main/expect/to/equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equal.d.ts","sourceRoot":"","sources":["../../../../src/main/expect/to/equal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI;IACrB;;;;;;;;;;;;;;;;;;OAkBG;IACH,CAAC,CAAC,KAAK,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACpD,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;CACzD,CAAA"}

package/esm/main/expect/to/equal.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=equal.js.map

package/esm/main/expect/to/equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equal.js","sourceRoot":"","sources":["../../../../src/main/expect/to/equal.ts"],"names":[],"mappings":"","sourcesContent":["import type { MutuallyAssignable } from '../../../utils/index.js'\nimport type { TypeAssertionResult } from '../index.js'\n\nexport type Equal<T> = {\n  /**\n   * Tests if the current type is mutually assignable with the provided type U.\n   *\n   * It's like:\n   *\n   * ```ts ignore\n   * [T] extends [U] ? [U] extends [T] ? Yes : No : No\n   * ```\n   *\n   * @template U The type to compare with\n   *\n   * @example\n   * ```ts\n   * import { expect } from '@leawind/lay-sing'\n   *\n   * expect<{ a: 1; b: 2 }>().to.equal<{ a: 1 } & { b: 2 }>().pass\n   * expect<1>().to.equal<1 | 2>().fail\n   * ```\n   */\n  <U>(): TypeAssertionResult<MutuallyAssignable<T, U>>\n  <U>(_: U): TypeAssertionResult<MutuallyAssignable<T, U>>\n}\n"]}

package/esm/main/expect/to/extend.d.ts

@@ -0,0 +1,31 @@
+import type { Extends, If } from '../../../utils/index.js';
+import type { TypeAssertionResult } from '../index.js';
+export type Extend<T> = {
+    /**
+     * Tests if the current type T extends the provided type U.
+     *
+     * @template U The type to check extension against
+     *
+     * @example
+     * ```ts
+     * import { expect } from '@leawind/lay-sing'
+     *
+     * expect<3.14>().to.extend<number>().pass
+     * expect<2>().to.extend<string>().fail
+     * expect<'hello'>().to.extend<string>().pass
+     * ```
+     */
+    <U>(): TypeAssertionResult<Extends<T, U>>;
+    <U>(_: U): TypeAssertionResult<Extends<T, U>>;
+} & If<Extends<T, number>, {
+    number: void;
+}, {}> & If<Extends<T, bigint>, {
+    bigint: void;
+}, {}> & If<Extends<T, string>, {
+    string: void;
+}, {}> & If<Extends<T, boolean>, {
+    boolean: void;
+}, {}> & If<Extends<T, symbol>, {
+    symbol: void;
+}, {}>;
+//# sourceMappingURL=extend.d.ts.map

package/esm/main/expect/to/extend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend.d.ts","sourceRoot":"","sources":["../../../../src/main/expect/to/extend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,MAAM,MAAM,CAAC,CAAC,IAChB;IACA;;;;;;;;;;;;;OAaG;IACH,CAAC,CAAC,KAAK,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IACzC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;CAC9C,GACC,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GAC5C,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GAC5C,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GAC5C,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,GAC9C,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,EAAE,EAAE,CAAC,CAAA"}

package/esm/main/expect/to/extend.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extend.js.map

package/esm/main/expect/to/extend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend.js","sourceRoot":"","sources":["../../../../src/main/expect/to/extend.ts"],"names":[],"mappings":"","sourcesContent":["import type { Extends, If } from '../../../utils/index.js'\nimport type { TypeAssertionResult } from '../index.js'\n\nexport type Extend<T> =\n  & {\n    /**\n     * Tests if the current type T extends the provided type U.\n     *\n     * @template U The type to check extension against\n     *\n     * @example\n     * ```ts\n     * import { expect } from '@leawind/lay-sing'\n     *\n     * expect<3.14>().to.extend<number>().pass\n     * expect<2>().to.extend<string>().fail\n     * expect<'hello'>().to.extend<string>().pass\n     * ```\n     */\n    <U>(): TypeAssertionResult<Extends<T, U>>\n    <U>(_: U): TypeAssertionResult<Extends<T, U>>\n  }\n  & If<Extends<T, number>, { number: void }, {}>\n  & If<Extends<T, bigint>, { bigint: void }, {}>\n  & If<Extends<T, string>, { string: void }, {}>\n  & If<Extends<T, boolean>, { boolean: void }, {}>\n  & If<Extends<T, symbol>, { symbol: void }, {}>\n"]}

package/esm/main/expect/to/have-key.d.ts

@@ -0,0 +1,38 @@
+import type { Extends, IfTupleIncludes } from '../../../utils/index.js';
+import type { TypeAssertionResult } from '../index.js';
+type Result<T, K extends PropertyKey> = IfTupleIncludes<[
+    never,
+    any
+], K, never, TypeAssertionResult<Extends<K, keyof T>>>;
+export type HaveKey<T> = {
+    /**
+     * Tests if the current type `T` has a property with key `K`.
+     *
+     * @template K The property key to check for
+     *
+     * ### Behavior
+     *
+     * - For single keys: succeeds if the key exists in `T`
+     * - For union types: succeeds only if **all** keys in the union exist in `T`
+     *
+     * ### Examples
+     *
+     * ```ts
+     * import { expect } from '@leawind/lay-sing'
+     *
+     * type WithProp = { prop: string; another: number; may?: 5 }
+     *
+     * // Single key checks
+     * expect<WithProp>().to.haveKey<'prop'>().pass
+     * expect<WithProp>().to.haveKey<'missing'>().fail
+     *
+     * // Union type checks
+     * expect<WithProp>().to.haveKey<'prop' | 'another'>().pass
+     * expect<WithProp>().to.haveKey<'may' | 'unexist'>().fail
+     * ```
+     */
+    <K extends PropertyKey>(): Result<T, K>;
+    <K extends PropertyKey>(_: K): Result<T, K>;
+};
+export {};
+//# sourceMappingURL=have-key.d.ts.map

package/esm/main/expect/to/have-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"have-key.d.ts","sourceRoot":"","sources":["../../../../src/main/expect/to/have-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,eAAe,CACrD;IAAC,KAAK;IAAE,GAAG;CAAC,EACZ,CAAC,EACD,KAAK,EACL,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CACzC,CAAA;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IACvB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,CAAC,CAAC,SAAS,WAAW,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACvC,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;CAC5C,CAAA"}

package/esm/main/expect/to/have-key.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=have-key.js.map

package/esm/main/expect/to/have-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"have-key.js","sourceRoot":"","sources":["../../../../src/main/expect/to/have-key.ts"],"names":[],"mappings":"","sourcesContent":["import type { Extends, IfTupleIncludes } from '../../../utils/index.js'\nimport type { TypeAssertionResult } from '../index.js'\n\ntype Result<T, K extends PropertyKey> = IfTupleIncludes<\n  [never, any],\n  K,\n  never,\n  TypeAssertionResult<Extends<K, keyof T>>\n>\n\nexport type HaveKey<T> = {\n  /**\n   * Tests if the current type `T` has a property with key `K`.\n   *\n   * @template K The property key to check for\n   *\n   * ### Behavior\n   *\n   * - For single keys: succeeds if the key exists in `T`\n   * - For union types: succeeds only if **all** keys in the union exist in `T`\n   *\n   * ### Examples\n   *\n   * ```ts\n   * import { expect } from '@leawind/lay-sing'\n   *\n   * type WithProp = { prop: string; another: number; may?: 5 }\n   *\n   * // Single key checks\n   * expect<WithProp>().to.haveKey<'prop'>().pass\n   * expect<WithProp>().to.haveKey<'missing'>().fail\n   *\n   * // Union type checks\n   * expect<WithProp>().to.haveKey<'prop' | 'another'>().pass\n   * expect<WithProp>().to.haveKey<'may' | 'unexist'>().fail\n   * ```\n   */\n  <K extends PropertyKey>(): Result<T, K>\n  <K extends PropertyKey>(_: K): Result<T, K>\n}\n"]}

package/esm/main/expect/to/index.d.ts

@@ -0,0 +1,13 @@
+import type { Be } from './be.js';
+import type { Equal } from './equal.js';
+import type { Extend } from './extend.js';
+import type { ProperExtends } from './proper-extends.js';
+import type { HaveKey } from './have-key.js';
+export type To<T> = {
+    be: Be<T>;
+    equal: Equal<T>;
+    extend: Extend<T>;
+    properExtend: ProperExtends<T>;
+    haveKey: HaveKey<T>;
+};
+//# sourceMappingURL=index.d.ts.map

package/esm/main/expect/to/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/main/expect/to/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,MAAM,MAAM,EAAE,CAAC,CAAC,IAAI;IAClB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;IACT,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;IACf,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACjB,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAC9B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACpB,CAAA"}

package/esm/main/expect/to/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/esm/main/expect/to/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/main/expect/to/index.ts"],"names":[],"mappings":"","sourcesContent":["import type { Be } from './be.js'\nimport type { Equal } from './equal.js'\nimport type { Extend } from './extend.js'\nimport type { ProperExtends } from './proper-extends.js'\nimport type { HaveKey } from './have-key.js'\n\nexport type To<T> = {\n  be: Be<T>\n  equal: Equal<T>\n  extend: Extend<T>\n  properExtend: ProperExtends<T>\n  haveKey: HaveKey<T>\n}\n"]}

package/esm/main/expect/to/proper-extends.d.ts

@@ -0,0 +1,21 @@
+import type { ProperExtend } from '../../../utils/index.js';
+import type { TypeAssertionResult } from '../index.js';
+export type ProperExtends<T> = {
+    /**
+     * Tests if the current type T properly extends the provided type U (extends but is not the same).
+     *
+     * @template U The type to check proper extension against
+     *
+     * @example
+     * ```ts
+     * import { expect } from '@leawind/lay-sing'
+     *
+     * expect<2>().to.properExtend<number>().pass
+     * expect<'a' | 'b'>().to.properExtend<string>().pass
+     * expect<number>().to.properExtend<number>().fail
+     * ```
+     */
+    <U>(): TypeAssertionResult<ProperExtend<T, U>>;
+    <U>(_: U): TypeAssertionResult<ProperExtend<T, U>>;
+};
+//# sourceMappingURL=proper-extends.d.ts.map

package/esm/main/expect/to/proper-extends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proper-extends.d.ts","sourceRoot":"","sources":["../../../../src/main/expect/to/proper-extends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B;;;;;;;;;;;;;OAaG;IACH,CAAC,CAAC,KAAK,mBAAmB,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9C,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;CACnD,CAAA"}

package/esm/main/expect/to/proper-extends.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=proper-extends.js.map

package/esm/main/expect/to/proper-extends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proper-extends.js","sourceRoot":"","sources":["../../../../src/main/expect/to/proper-extends.ts"],"names":[],"mappings":"","sourcesContent":["import type { ProperExtend } from '../../../utils/index.js'\nimport type { TypeAssertionResult } from '../index.js'\n\nexport type ProperExtends<T> = {\n  /**\n   * Tests if the current type T properly extends the provided type U (extends but is not the same).\n   *\n   * @template U The type to check proper extension against\n   *\n   * @example\n   * ```ts\n   * import { expect } from '@leawind/lay-sing'\n   *\n   * expect<2>().to.properExtend<number>().pass\n   * expect<'a' | 'b'>().to.properExtend<string>().pass\n   * expect<number>().to.properExtend<number>().fail\n   * ```\n   */\n  <U>(): TypeAssertionResult<ProperExtend<T, U>>\n  <U>(_: U): TypeAssertionResult<ProperExtend<T, U>>\n}\n"]}

package/esm/main/index.d.ts

@@ -3,8 +3,8 @@
  *
  * @module
  */
-import type { ExpectType } from './expect.js';
-export type { ExpectType } from './expect.js';
+import type { ExpectType } from './expect/index.js';
+export type { ExpectType } from './expect/index.js';
 export { NOOP } from './noop.js';
 /**
  * Creates an instance of ExpectType to perform type-level assertions on the given type.
@@ -18,13 +18,15 @@ export { NOOP } from './noop.js';
  * @example
  * ```ts
  * // Test exact type equality
- * expect<number>().toBe<number>().success
- * expect<number>().toBe<string>().fail
+ * expect<number>().to.be<number>().pass
+ * expect<number>().to.be<string>().fail
  * // Test if one type extends another
- * expect<3.14>().toExtend<number>().success
- * expect<2>().toExtend<string>().fail
+ * expect<3.14>().to.extend<number>().pass
+ * expect<2>().to.extend<string>().fail
  * ```
  */
-export declare function expect<T>(): ExpectType<T>;
-export declare function expect<T>(_: T): ExpectType<T>;
+export declare const expect: {
+    <T>(): ExpectType<T>;
+    <T>(_: T): ExpectType<T>;
+};
 //# sourceMappingURL=index.d.ts.map

package/esm/main/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/main/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,MAAM,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAA;AAC1C,wBAAgB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/main/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGnD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,MAAM,EAAE;IACnB,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;CAClB,CAAA"}

package/esm/main/index.js

@@ -5,7 +5,24 @@
  */
 import { NOOP } from './noop.js';
 export { NOOP } from './noop.js';
-export function expect() {
-    return NOOP;
-}
+/**
+ * Creates an instance of ExpectType to perform type-level assertions on the given type.
+ * This function enables testing various type relationships at compile time.
+ * NOTE: This function does nothing at runtime and is purely for type-level testing.
+ *
+ * @template T The type to be tested
+ *
+ * @returns An ExpectType instance with methods to test type relationships
+ *
+ * @example
+ * ```ts
+ * // Test exact type equality
+ * expect<number>().to.be<number>().pass
+ * expect<number>().to.be<string>().fail
+ * // Test if one type extends another
+ * expect<3.14>().to.extend<number>().pass
+ * expect<2>().to.extend<string>().fail
+ * ```
+ */
+export const expect = NOOP;
 //# sourceMappingURL=index.js.map

package/esm/main/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/main/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAuBhC,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["/**\n * [Full API documentation is available on JSR](https://jsr.io/@leawind/lay-sing/doc)\n *\n * @module\n */\n\nimport type { ExpectType } from './expect.js'\nimport { NOOP } from './noop.js'\n\nexport type { ExpectType } from './expect.js'\nexport { NOOP } from './noop.js'\n\n/**\n * Creates an instance of ExpectType to perform type-level assertions on the given type.\n * This function enables testing various type relationships at compile time.\n * NOTE: This function does nothing at runtime and is purely for type-level testing.\n *\n * @template T The type to be tested\n *\n * @returns An ExpectType instance with methods to test type relationships\n *\n * @example\n * ```ts\n * // Test exact type equality\n * expect<number>().toBe<number>().success\n * expect<number>().toBe<string>().fail\n * // Test if one type extends another\n * expect<3.14>().toExtend<number>().success\n * expect<2>().toExtend<string>().fail\n * ```\n */\nexport function expect<T>(): ExpectType<T>\nexport function expect<T>(_: T): ExpectType<T>\nexport function expect<T>(): ExpectType<T> {\n  return NOOP\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/main/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,MAAM,GAGf,IAAI,CAAA","sourcesContent":["/**\n * [Full API documentation is available on JSR](https://jsr.io/@leawind/lay-sing/doc)\n *\n * @module\n */\n\nimport type { ExpectType } from './expect/index.js'\nimport { NOOP } from './noop.js'\n\nexport type { ExpectType } from './expect/index.js'\nexport { NOOP } from './noop.js'\n\n/**\n * Creates an instance of ExpectType to perform type-level assertions on the given type.\n * This function enables testing various type relationships at compile time.\n * NOTE: This function does nothing at runtime and is purely for type-level testing.\n *\n * @template T The type to be tested\n *\n * @returns An ExpectType instance with methods to test type relationships\n *\n * @example\n * ```ts\n * // Test exact type equality\n * expect<number>().to.be<number>().pass\n * expect<number>().to.be<string>().fail\n * // Test if one type extends another\n * expect<3.14>().to.extend<number>().pass\n * expect<2>().to.extend<string>().fail\n * ```\n */\nexport const expect: {\n  <T>(): ExpectType<T>\n  <T>(_: T): ExpectType<T>\n} = NOOP\n"]}

package/esm/utils/compare/exact.d.ts

@@ -17,14 +17,14 @@
  * ```ts
  * import { expect } from '@leawind/lay-sing'
  *
- * expect<Exact<string, string>>().toBeTrue
- * expect<Exact<never, never>>().toBeTrue
- * expect<Exact<any, any>>().toBeTrue
- *
- * expect<Exact<{ a: 3 }, { a?: 3 }>>().toBeFalse
- * expect<Exact<1 | 2, 1>>().toBeFalse
- * expect<Exact<1, number>>().toBeFalse
- * expect<Exact<() => void, () => undefined>>().toBeFalse
+ * expect<Exact<string, string>>().to.be.true
+ * expect<Exact<never, never>>().to.be.true
+ * expect<Exact<any, any>>().to.be.true
+ *
+ * expect<Exact<{ a: 3 }, { a?: 3 }>>().to.be.false
+ * expect<Exact<1 | 2, 1>>().to.be.false
+ * expect<Exact<1, number>>().to.be.false
+ * expect<Exact<() => void, () => undefined>>().to.be.false
  * ```
  */
 export type Exact<A, B, Yes = true, No = false> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? Yes : No;

package/esm/utils/compare/exact.js.map

@@ -1 +1 @@
-{"version":3,"file":"exact.js","sourceRoot":"","sources":["../../../src/utils/compare/exact.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Checks whether two types are exactly the same.\n *\n * **⚠️Important:** parameter `A` and `B` are not distributive. When they are union type, it does not check each member separately.\n *\n * @template A - The first type to compare\n * @template B - The second type to compare\n * @template Yes - The result if types are exactly the same (defaults to `true`)\n * @template No - The result if types are not exactly the same (defaults to `false`)\n *\n * ### Result\n *\n * - `Yes`: `A` and `B` are exactly the same\n * - `No`: Otherwise\n *\n * @example\n * ```ts\n * import { expect } from '@leawind/lay-sing'\n *\n * expect<Exact<string, string>>().toBeTrue\n * expect<Exact<never, never>>().toBeTrue\n * expect<Exact<any, any>>().toBeTrue\n *\n * expect<Exact<{ a: 3 }, { a?: 3 }>>().toBeFalse\n * expect<Exact<1 | 2, 1>>().toBeFalse\n * expect<Exact<1, number>>().toBeFalse\n * expect<Exact<() => void, () => undefined>>().toBeFalse\n * ```\n */\nexport type Exact<\n  A,\n  B,\n  Yes = true,\n  No = false,\n> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? Yes : No\n\n/**\n * Checks whether two types are not exactly the same.\n *\n * This is the logical negation of `Exact<A, B>`.\n *\n * @template A - The first type to compare\n * @template B - The second type to compare\n * @template Yes - The result if types are not exactly the same (defaults to `true`)\n * @template No - The result if types are exactly the same (defaults to `false`)\n *\n * @example\n * ```ts\n * type T1 = NotExact<number, string> // true\n * type T2 = NotExact<1, number> // true\n * type F1 = NotExact<number, number> // false\n * type F2 = NotExact<1, 1> // false\n * ```\n */\nexport type NotExact<\n  A,\n  B,\n  Yes = true,\n  No = false,\n> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? No : Yes\n"]}
+{"version":3,"file":"exact.js","sourceRoot":"","sources":["../../../src/utils/compare/exact.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Checks whether two types are exactly the same.\n *\n * **⚠️Important:** parameter `A` and `B` are not distributive. When they are union type, it does not check each member separately.\n *\n * @template A - The first type to compare\n * @template B - The second type to compare\n * @template Yes - The result if types are exactly the same (defaults to `true`)\n * @template No - The result if types are not exactly the same (defaults to `false`)\n *\n * ### Result\n *\n * - `Yes`: `A` and `B` are exactly the same\n * - `No`: Otherwise\n *\n * @example\n * ```ts\n * import { expect } from '@leawind/lay-sing'\n *\n * expect<Exact<string, string>>().to.be.true\n * expect<Exact<never, never>>().to.be.true\n * expect<Exact<any, any>>().to.be.true\n *\n * expect<Exact<{ a: 3 }, { a?: 3 }>>().to.be.false\n * expect<Exact<1 | 2, 1>>().to.be.false\n * expect<Exact<1, number>>().to.be.false\n * expect<Exact<() => void, () => undefined>>().to.be.false\n * ```\n */\nexport type Exact<\n  A,\n  B,\n  Yes = true,\n  No = false,\n> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? Yes : No\n\n/**\n * Checks whether two types are not exactly the same.\n *\n * This is the logical negation of `Exact<A, B>`.\n *\n * @template A - The first type to compare\n * @template B - The second type to compare\n * @template Yes - The result if types are not exactly the same (defaults to `true`)\n * @template No - The result if types are exactly the same (defaults to `false`)\n *\n * @example\n * ```ts\n * type T1 = NotExact<number, string> // true\n * type T2 = NotExact<1, number> // true\n * type F1 = NotExact<number, number> // false\n * type F2 = NotExact<1, 1> // false\n * ```\n */\nexport type NotExact<\n  A,\n  B,\n  Yes = true,\n  No = false,\n> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? No : Yes\n"]}

package/esm/utils/index.d.ts

@@ -5,6 +5,7 @@
  */
 export * from './compare/index.js';
 export * from './logic/index.js';
+export * from './misc.js';
 export * from './object/index.js';
 export * from './tuple/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA"}

package/esm/utils/index.js

@@ -6,6 +6,7 @@
 // Index start >>>>>>>>>>>>>>>>
 export * from './compare/index.js';
 export * from './logic/index.js';
+export * from './misc.js';
 export * from './object/index.js';
 export * from './tuple/index.js';
 // <<<<<<<<<<<<<<<<   Index end

package/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+BAA+B;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,+BAA+B","sourcesContent":["/**\n * [Full API documentation is available on JSR](https://jsr.io/@leawind/lay-sing/doc)\n *\n * @module\n */\n\n// Index start >>>>>>>>>>>>>>>>\nexport * from './compare/index.js'\nexport * from './logic/index.js'\nexport * from './object/index.js'\nexport * from './tuple/index.js'\n// <<<<<<<<<<<<<<<<   Index end\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+BAA+B;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,+BAA+B","sourcesContent":["/**\n * [Full API documentation is available on JSR](https://jsr.io/@leawind/lay-sing/doc)\n *\n * @module\n */\n\n// Index start >>>>>>>>>>>>>>>>\nexport * from './compare/index.js'\nexport * from './logic/index.js'\nexport * from './misc.js'\nexport * from './object/index.js'\nexport * from './tuple/index.js'\n// <<<<<<<<<<<<<<<<   Index end\n"]}

package/esm/utils/logic/assert.d.ts

@@ -9,9 +9,9 @@
  * ```ts
  * import { expect } from '@leawind/lay-sing'
  *
- * expect<AssertExtends<string, number>>().toBeNever
- * expect<AssertExtends<1 | 2, 1>>().toBeNever
- * expect<AssertExtends<1, 1 | 2>>().toBe<1>().success
+ * expect<AssertExtends<string, number>>().to.be.never
+ * expect<AssertExtends<1 | 2, 1>>().to.be.never
+ * expect<AssertExtends<1, 1 | 2>>().to.be<1>().pass
  * ```
  */
 export type AssertExtends<T, U> = [T] extends [U] ? T : never;

package/esm/utils/logic/assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../src/utils/logic/assert.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * **⚠️Important:** parameter `T` and `U` are not distributive. When they are union type, it treats them as a single entity.\n *\n * @template T - The type to test (not distributed over unions)\n * @template U - The constraint type to test against\n *\n * @example\n *\n * ```ts\n * import { expect } from '@leawind/lay-sing'\n *\n * expect<AssertExtends<string, number>>().toBeNever\n * expect<AssertExtends<1 | 2, 1>>().toBeNever\n * expect<AssertExtends<1, 1 | 2>>().toBe<1>().success\n * ```\n */\nexport type AssertExtends<T, U> = [T] extends [U] ? T : never\n"]}
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../../src/utils/logic/assert.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * **⚠️Important:** parameter `T` and `U` are not distributive. When they are union type, it treats them as a single entity.\n *\n * @template T - The type to test (not distributed over unions)\n * @template U - The constraint type to test against\n *\n * @example\n *\n * ```ts\n * import { expect } from '@leawind/lay-sing'\n *\n * expect<AssertExtends<string, number>>().to.be.never\n * expect<AssertExtends<1 | 2, 1>>().to.be.never\n * expect<AssertExtends<1, 1 | 2>>().to.be<1>().pass\n * ```\n */\nexport type AssertExtends<T, U> = [T] extends [U] ? T : never\n"]}

package/esm/utils/logic/switch.d.ts

@@ -80,7 +80,7 @@ export type SwitchExact<T, Cases extends readonly [unknown, unknown][], Default
  *     [number, boolean],
  *     [string, boolean],
  *   ], Error>
- * >().toBe<boolean>().success
+ * >().to.be<boolean>().pass
  * ```
  */
 export type SwitchExtends<T, Cases extends readonly [unknown, unknown][], Default = never> = Cases extends [infer First, ...infer Rest] ? (First extends [infer C, infer R] ? ([T] extends [C] ? R : SwitchExtends<T, Rest extends readonly [unknown, unknown][] ? Rest : never, Default>) : never) : Default;

package/esm/utils/logic/switch.js.map

@@ -1 +1 @@
-{"version":3,"file":"switch.js","sourceRoot":"","sources":["../../../src/utils/logic/switch.ts"],"names":[],"mappings":"","sourcesContent":["import type { Exact } from '../index.js'\n\n/**\n * Case tuple type used with `SwitchExact` and `SwitchExtends`\n *\n * @template T - The condition type to match against\n * @template Result - The result type to return if match is found\n *\n * @example\n * ```ts\n * type MyCase = Case<1, 'one'>\n * // Equivalent to: [1, 'one']\n * ```\n *\n * @example\n * ```ts\n * import { SwitchExact, DefaultCase } from '@leawind/lay-sing/utils'\n * type NameMap<id> = SwitchExact<id, [\n *   [1, 'Alice'],\n *   [2, 'Bob'],\n * ], DefaultCase<'Steve'>>\n * ```\n *\n * @see SwitchExact\n */\nexport type Case<T = unknown, Result = unknown> = [T, Result]\n\n/**\n * Default case type used with `SwitchExact` and `SwitchExtends`\n *\n * @template T - The default result type\n *\n * @example\n * ```ts\n * import { SwitchExact, DefaultCase } from '@leawind/lay-sing/utils'\n * type NameMap<id> = SwitchExact<id, [\n *   [1, 'Alice'],\n *   [2, 'Bob'],\n * ], DefaultCase<'Steve'>>\n * ```\n *\n * @see SwitchExact\n */\nexport type DefaultCase<T> = T\n\n/**\n * Switch type that uses exact matching logic\n *\n * **⚠️Important:** `T` parameter is not distributive. When `T` is a union type, it does not check each member separately.\n *\n * @template T - The type to match against cases\n * @template Cases - Array of case tuples, each tuple has the form [Condition, Result]\n * @template Default - Default result if no exact match is found (defaults to `never`)\n *\n * @example\n * ```ts\n * import { SwitchExact, DefaultCase } from '@leawind/lay-sing/utils'\n * type Result = SwitchExact<2, [\n *   [1, 'Alice'],\n *   [2, 'Bob'],\n *   [3, 'Charlie'],\n * ], DefaultCase<'Steve'>>\n *\n * // Result: 'Bob'\n * ```\n */\nexport type SwitchExact<\n  T,\n  Cases extends readonly [unknown, unknown][],\n  Default = never,\n> = Cases extends [infer First, ...infer Rest] ? (\n    First extends [infer Condition, infer Result] ? (Exact<T, Condition> extends true ? Result\n        : (SwitchExact<T, Rest extends readonly [unknown, unknown][] ? Rest : never, Default>))\n      : (never)\n  )\n  : Default\n\n/**\n * Switch type that uses 'extends' logic instead of 'Exact' logic\n *\n * **⚠️Important:** `T` parameter is not distributive. When `T` is a union type, it does not check each member separately.\n *\n * @template T - The type to match against cases\n * @template Cases - Array of case tuples, each tuple has the form [Condition, Result]\n * @template Default - Default result if no match is found (defaults to `never`)\n *\n * @example\n * ```ts\n * import { expect } from '@leawind/lay-sing'\n *\n * expect<\n *   SwitchExtends<string, [\n *     [number, boolean],\n *     [string, boolean],\n *   ], Error>\n * >().toBe<boolean>().success\n * ```\n */\nexport type SwitchExtends<\n  T,\n  Cases extends readonly [unknown, unknown][],\n  Default = never,\n> = Cases extends [infer First, ...infer Rest] ? (\n    First extends [infer C, infer R]\n      ? ([T] extends [C] ? R : SwitchExtends<T, Rest extends readonly [unknown, unknown][] ? Rest : never, Default>)\n      : never\n  )\n  : Default\n"]}
+{"version":3,"file":"switch.js","sourceRoot":"","sources":["../../../src/utils/logic/switch.ts"],"names":[],"mappings":"","sourcesContent":["import type { Exact } from '../index.js'\n\n/**\n * Case tuple type used with `SwitchExact` and `SwitchExtends`\n *\n * @template T - The condition type to match against\n * @template Result - The result type to return if match is found\n *\n * @example\n * ```ts\n * type MyCase = Case<1, 'one'>\n * // Equivalent to: [1, 'one']\n * ```\n *\n * @example\n * ```ts\n * import { SwitchExact, DefaultCase } from '@leawind/lay-sing/utils'\n * type NameMap<id> = SwitchExact<id, [\n *   [1, 'Alice'],\n *   [2, 'Bob'],\n * ], DefaultCase<'Steve'>>\n * ```\n *\n * @see SwitchExact\n */\nexport type Case<T = unknown, Result = unknown> = [T, Result]\n\n/**\n * Default case type used with `SwitchExact` and `SwitchExtends`\n *\n * @template T - The default result type\n *\n * @example\n * ```ts\n * import { SwitchExact, DefaultCase } from '@leawind/lay-sing/utils'\n * type NameMap<id> = SwitchExact<id, [\n *   [1, 'Alice'],\n *   [2, 'Bob'],\n * ], DefaultCase<'Steve'>>\n * ```\n *\n * @see SwitchExact\n */\nexport type DefaultCase<T> = T\n\n/**\n * Switch type that uses exact matching logic\n *\n * **⚠️Important:** `T` parameter is not distributive. When `T` is a union type, it does not check each member separately.\n *\n * @template T - The type to match against cases\n * @template Cases - Array of case tuples, each tuple has the form [Condition, Result]\n * @template Default - Default result if no exact match is found (defaults to `never`)\n *\n * @example\n * ```ts\n * import { SwitchExact, DefaultCase } from '@leawind/lay-sing/utils'\n * type Result = SwitchExact<2, [\n *   [1, 'Alice'],\n *   [2, 'Bob'],\n *   [3, 'Charlie'],\n * ], DefaultCase<'Steve'>>\n *\n * // Result: 'Bob'\n * ```\n */\nexport type SwitchExact<\n  T,\n  Cases extends readonly [unknown, unknown][],\n  Default = never,\n> = Cases extends [infer First, ...infer Rest] ? (\n    First extends [infer Condition, infer Result] ? (Exact<T, Condition> extends true ? Result\n        : (SwitchExact<T, Rest extends readonly [unknown, unknown][] ? Rest : never, Default>))\n      : (never)\n  )\n  : Default\n\n/**\n * Switch type that uses 'extends' logic instead of 'Exact' logic\n *\n * **⚠️Important:** `T` parameter is not distributive. When `T` is a union type, it does not check each member separately.\n *\n * @template T - The type to match against cases\n * @template Cases - Array of case tuples, each tuple has the form [Condition, Result]\n * @template Default - Default result if no match is found (defaults to `never`)\n *\n * @example\n * ```ts\n * import { expect } from '@leawind/lay-sing'\n *\n * expect<\n *   SwitchExtends<string, [\n *     [number, boolean],\n *     [string, boolean],\n *   ], Error>\n * >().to.be<boolean>().pass\n * ```\n */\nexport type SwitchExtends<\n  T,\n  Cases extends readonly [unknown, unknown][],\n  Default = never,\n> = Cases extends [infer First, ...infer Rest] ? (\n    First extends [infer C, infer R]\n      ? ([T] extends [C] ? R : SwitchExtends<T, Rest extends readonly [unknown, unknown][] ? Rest : never, Default>)\n      : never\n  )\n  : Default\n"]}

package/esm/utils/misc.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Creates an intersection of all types in the provided tuple
+ *
+ * ## `IntersectionOf<[A, B, ... T]>` = `A & B & ... & T`
+ *
+ * @template Types - A tuple of types to create an intersection from
+ *
+ * @example
+ * ```ts
+ * import { expect } from '@leawind/lay-sing'
+ *
+ * type Result = IntersectionOf<[{ a: string }, { b: number }, { c: boolean }]>
+ * expect<Result>().to.extend<{ a: string } & { b: number } & { c: boolean }>().pass
+ * expect<Result>().to.extend<{ a: string; b: number; c: boolean }>().pass
+ * ```
+ */
+export type IntersectionOf<Types extends readonly unknown[]> = Types extends [infer First, ...infer Rest] ? First & IntersectionOf<Rest> : unknown;
+/**
+ * Creates a union of all types in the provided tuple
+ *
+ * ## `UnionOf<[A, B, ... T]>` = `A | B | ... | T`
+ *
+ * @template Types - A tuple of types to create a union from
+ *
+ * @example
+ * ```ts
+ * import { expect } from '@leawind/lay-sing'
+ *
+ * type Result = UnionOf<[string, number, boolean]>
+ * expect<Result>().to.be<string | number | boolean>().pass
+ * ```
+ */
+export type UnionOf<Types extends readonly unknown[]> = Types extends [infer First, ...infer Rest] ? First | UnionOf<Rest> : never;
+//# sourceMappingURL=misc.d.ts.map

package/esm/utils/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/utils/misc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,GACrG,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,GAC5B,OAAO,CAAA;AAEX;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,OAAO,CAAC,KAAK,SAAS,SAAS,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,GAC9F,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,GACrB,KAAK,CAAA"}

package/esm/utils/misc.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=misc.js.map