lay-sing 0.2.1 → 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
 //                                    ^^^^^^^
 ```
 
@@ -32,7 +32,7 @@ npm i -D lay-sing
 ```
 
 ```ts
-import { expect } from 'lay-sing/test-utils'
+import { expect } from 'lay-sing'
 ```
 
 </details>
@@ -47,7 +47,7 @@ deno add npm:lay-sing
 ```
 
 ```ts
-import { expect } from 'lay-sing/test-utils'
+import { expect } from 'lay-sing'
 ```
 
 ### From JSR
@@ -59,14 +59,14 @@ deno add @leawind/lay-sing
 ```
 
 ```ts
-import { expect } from '@leawind/lay-sing/test-utils'
+import { expect } from '@leawind/lay-sing'
 ```
 
 ### From Latest commit
 
 ```ts
-import { expect } from 'https://raw.githubusercontent.com/Leawind/lay-sing/refs/heads/main/src/test-utils/index.ts'
-import { Exact } from 'https://raw.githubusercontent.com/Leawind/lay-sing/refs/heads/main/src/main/index.ts'
+import { expect } from 'https://raw.githubusercontent.com/Leawind/lay-sing/refs/heads/main/src/main/index.ts'
+import { Exact } from 'https://raw.githubusercontent.com/Leawind/lay-sing/refs/heads/main/src/utils/index.ts'
 ```
 
 </details>
@@ -75,22 +75,20 @@ import { Exact } from 'https://raw.githubusercontent.com/Leawind/lay-sing/refs/h
 
 ## Usage
 
-### Testing Utilities
-
 ```ts
-import { expect } from 'lay-sing/test-utils'
+import { expect } from 'lay-sing'
 ```
 
-The `test-utils` module provides utilities for **compile-time** type validation. These utilities have **no runtime impact** — they always return a special [`NOOP`](https://jsr.io/@leawind/lay-sing/doc/test-utils/~/NOOP) value that safely supports almost any property access or method call.
+The main module provides utilities for **compile-time** type validation. These utilities have **no runtime impact** — they always return a special [`NOOP`](https://jsr.io/@leawind/lay-sing/doc/~/NOOP) value that safely supports almost any property access or method call.
 
 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]
@@ -98,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.
@@ -108,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
@@ -148,15 +146,18 @@ await NOOP // Does not await (not thenable)
 
 ### Type Tools
 
-The main entry point provides some utility types for common type-level programming tasks. All types are flat-exported from the main entry point — no need to import from nested paths.
+It provides some utility types organized into categories for common type-level programming tasks. These can be imported from the `lay-sing/utils` entry point.
 
 ```ts
-import type { Exact } from 'lay-sing'
+import type { Exact, Extends, Overlap } from 'lay-sing/utils'
 ```
 
 ### Examples
 
 ```typescript
+// Import the utility types
+import type { ConcatTuple, Exact, If, KeysOfBaseType } from '@leawind/lay-sing/utils'
+
 // Test if exactly the same
 type False = Exact<{ a: 1 }, { a?: 1 }> // false
 type Yes = Exact<boolean, true | false, 'yes', 'no'> // 'yes'
@@ -164,15 +165,10 @@ type Yes = Exact<boolean, true | false, 'yes', 'no'> // 'yes'
 // Conditional Types
 type Result = If<true, 'yes', 'no'> // 'yes'
 
-// Boolean Logic
-type IsTrue = And<true, true> // true
+type FailResult = If<Exact<number, string>, 'yes', 'no'> // 'no'
 
 // Tuple Manipulation
 type Combined = ConcatTuple<[1, 2], [3, 4]> // [1, 2, 3, 4]
 
-// Object Utilities
-type PartialObj = DeepPartial<{ a: string; nested: { b: number } }>
-// { a?: string; nested?: { b?: number } }
+type UniqueCombined = ConcatUniqueTuple<[1, 2], [2, 3]> // [1, 2, 3]
 ```
-
-[Full API documentation is available on JSR](https://jsr.io/@leawind/lay-sing/doc)

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,15 +3,30 @@
  *
  * @module
  */
-export * from './async.js';
-export * from './boolean.js';
-export * from './control.js';
-export * from './doc.js';
-export * from './function.js';
-export * from './json.js';
-export * from './key.js';
-export * from './object.js';
-export * from './tuple.js';
-export * from './type/index.js';
-export * from './typed-array.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.
+ * 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 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;AAGH,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,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

@@ -3,17 +3,26 @@
  *
  * @module
  */
-// Index start >>>>>>>>>>>>>>>>
-export * from './async.js';
-export * from './boolean.js';
-export * from './control.js';
-export * from './doc.js';
-export * from './function.js';
-export * from './json.js';
-export * from './key.js';
-export * from './object.js';
-export * from './tuple.js';
-export * from './type/index.js';
-export * from './typed-array.js';
-// <<<<<<<<<<<<<<<<   Index end
+import { NOOP } from './noop.js';
+export { NOOP } from './noop.js';
+/**
+ * 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;AAEH,+BAA+B;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,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 './async.js'\nexport * from './boolean.js'\nexport * from './control.js'\nexport * from './doc.js'\nexport * from './function.js'\nexport * from './json.js'\nexport * from './key.js'\nexport * from './object.js'\nexport * from './tuple.js'\nexport * from './type/index.js'\nexport * from './typed-array.js'\n// <<<<<<<<<<<<<<<<   Index end\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/main/noop.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A universal no-op placeholder implemented via `Proxy`.
+ *
+ * `NOOP` can be accessed, called, or chained indefinitely without throwing.
+ * Every operation returns itself, making it safe to use as a dummy fallback
+ * for APIs, optional hooks, or unimplemented interfaces.
+ *
+ * ### Special behaviors
+ *
+ * - Callable: invoking `NOOP()` returns `NOOP`
+ * - Property access: `NOOP.anything` returns `NOOP`
+ * - Promise-safe: `NOOP.then` is `undefined`, so it is not treated as a Promise
+ * - Primitive coercion (`toString`, `valueOf`, `Symbol.toPrimitive`) yields
+ *   a stable string representation: `"[NOOP]"`
+ *
+ * This is useful in scenarios where a value is required syntactically but
+ * should perform no action and never fail at runtime.
+ *
+ * @example
+ * ```ts
+ * NOOP.foo.bar().baz.qux; // safe, returns NOOP
+ * String(NOOP); // "[NOOP]"
+ * await NOOP; // does not await (not thenable)
+ * ```
+ */
+export declare const NOOP: any;
+//# sourceMappingURL=noop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../src/main/noop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,IAAI,EAAE,GA0BlB,CAAA"}

package/esm/{test-utils/index.js → main/noop.js}

@@ -1,8 +1,3 @@
-/**
- * [Full API documentation is available on JSR](https://jsr.io/@leawind/lay-sing/doc)
- *
- * @module
- */
 /**
  * A universal no-op placeholder implemented via `Proxy`.
  *
@@ -52,10 +47,4 @@ export const NOOP = new Proxy(function () {
     has: () => true,
     ownKeys: () => ['prototype'],
 });
-export function compare() {
-    return NOOP;
-}
-export function expect() {
-    return NOOP;
-}
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=noop.js.map

package/esm/main/noop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../../src/main/noop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAQ,IAAI,KAAK,CAChC;IACE,OAAO,IAAI,CAAA;AACb,CAAC,EACD;IACE,GAAG,CAAC,CAAC,EAAE,IAAI;QACT,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,MAAM;gBACT,OAAO,SAAS,CAAA;YAClB,KAAK,SAAS,CAAC;YACf,KAAK,UAAU,CAAC;YAChB,KAAK,MAAM,CAAC,WAAW;gBACrB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAA;YACvB;gBACE,OAAO,IAAI,CAAA;QACf,CAAC;IACH,CAAC;IACD,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI;IACf,wBAAwB,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/B,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,IAAI;KACZ,CAAC;IACF,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI;IAC1B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI;IACf,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC;CAC7B,CACF,CAAA","sourcesContent":["/**\n * A universal no-op placeholder implemented via `Proxy`.\n *\n * `NOOP` can be accessed, called, or chained indefinitely without throwing.\n * Every operation returns itself, making it safe to use as a dummy fallback\n * for APIs, optional hooks, or unimplemented interfaces.\n *\n * ### Special behaviors\n *\n * - Callable: invoking `NOOP()` returns `NOOP`\n * - Property access: `NOOP.anything` returns `NOOP`\n * - Promise-safe: `NOOP.then` is `undefined`, so it is not treated as a Promise\n * - Primitive coercion (`toString`, `valueOf`, `Symbol.toPrimitive`) yields\n *   a stable string representation: `\"[NOOP]\"`\n *\n * This is useful in scenarios where a value is required syntactically but\n * should perform no action and never fail at runtime.\n *\n * @example\n * ```ts\n * NOOP.foo.bar().baz.qux; // safe, returns NOOP\n * String(NOOP); // \"[NOOP]\"\n * await NOOP; // does not await (not thenable)\n * ```\n */\nexport const NOOP: any = new Proxy(\n  function () {\n    return NOOP\n  },\n  {\n    get(_, prop) {\n      switch (prop) {\n        case 'then':\n          return undefined\n        case 'valueOf':\n        case 'toString':\n        case Symbol.toPrimitive:\n          return () => '[NOOP]'\n        default:\n          return NOOP\n      }\n    },\n    set: () => true,\n    getOwnPropertyDescriptor: () => ({\n      configurable: true,\n      value: NOOP,\n    }),\n    getPrototypeOf: () => null,\n    has: () => true,\n    ownKeys: () => ['prototype'],\n  },\n)\n"]}