@plyaz/types 1.6.0 → 1.7.0

package/dist/testing/common/utils/types.d.ts

@@ -52,7 +52,8 @@ import type { Provider, Type } from '@nestjs/common';
 import type { RenderOptions as RTLRenderOptions, RenderHookOptions as RTLRenderHookOptions } from '@testing-library/react';
 import type { UserEvent as UserEventLib } from '@testing-library/user-event';
 import type { MockEventEmitter, MockNextRouter, MockGetServerSidePropsContext, MockGetStaticPropsContext, MockNextApiResponse, MockNextApiRequest, TestScenario, CreateMockUseRouterReturn, CreateMockWebSocketReturn, CreateMockNextRequestFunction } from '..';
-import type { UnknownRecord } from 'type-fest';
+import type { UnknownRecord, UnknownArray, Promisable, Arrayable } from 'type-fest';
+import type { KeyValueStore, Identifiable, WithUrl, WithHttpMethod, WithHeaders, WithIpAddress, WithQueryParams, WithBody, Named, Clearable, Resettable, Describable, WithImpact, WithElement, WithDuration, IntervalControl, WithTimestamp, WithParams, WithKeyValues, WithTimeout, WithStatus, WithLocale, WithUserId, WithMessage } from '../../../common';
 /**
  * Subscription information for tracking subscriptions in tests
  *
@@ -67,8 +68,7 @@ import type { UnknownRecord } from 'type-fest';
  * };
  * ```
  */
-export interface SubscriptionInfo<T = unknown> {
-    id: string;
+export interface SubscriptionInfo<T = unknown> extends Identifiable {
     callback: Vitest.MockedFunction<(data: T) => void>;
     unsubscribe: () => void;
 }
@@ -179,10 +179,8 @@ export interface DeferredPromise<T = void> {
  * await waitFor(() => document.querySelector('.loaded'), options);
  * ```
  */
-export interface WaitOptions {
-    timeout?: number;
+export interface WaitOptions extends Partial<WithMessage & WithTimeout> {
     interval?: number;
-    message?: string;
 }
 /**
  * Options for retry operations
@@ -262,11 +260,10 @@ export interface MockAsync<T = void> {
  * expect(timer.elapsed).toBe(500);
  * ```
  */
-export interface ControllableTimer {
+export interface ControllableTimer extends Resettable {
     start: () => void;
     stop: () => void;
     tick: (ms: number) => void;
-    reset: () => void;
     elapsed: number;
 }
 /**
@@ -330,9 +327,9 @@ export interface TestEventEmitter<T = unknown> {
  */
 export interface AsyncTestStep<T = unknown> {
     name: string;
-    action: () => Promise<T> | T;
+    action: () => Promisable<T>;
     delay?: number;
-    assertion?: (result: T) => void | Promise<void>;
+    assertion?: (result: T) => Promisable<void>;
     onError?: (error: Error) => void;
 }
 /**
@@ -497,7 +494,7 @@ export interface PollingTestOptions {
  * ```
  */
 export interface TestCleanup {
-    add: (cleanup: () => void | Promise<void>) => void;
+    add: (cleanup: () => Promisable<void>) => void;
     runAll: () => Promise<void>;
     clear: () => void;
 }
@@ -543,11 +540,7 @@ export interface MockConsole {
  * };
  * ```
  */
-export interface MockEnv {
-    set: (key: string, value: string) => void;
-    get: (key: string) => string | undefined;
-    delete: (key: string) => void;
-    clear: () => void;
+export interface MockEnv extends KeyValueStore<string, string> {
     restore: () => void;
 }
 /**
@@ -600,8 +593,8 @@ export interface BenchmarkOptions {
     iterations?: number;
     time?: number;
     warmup?: number;
-    setup?: () => void | Promise<void>;
-    teardown?: () => void | Promise<void>;
+    setup?: () => Promisable<void>;
+    teardown?: () => Promisable<void>;
     runs?: number;
     format?: 'table' | 'json';
 }
@@ -620,8 +613,8 @@ export interface BenchmarkOptions {
  */
 export interface TestBedConfig {
     providers: Provider[];
-    imports?: unknown[];
-    exports?: unknown[];
+    imports?: UnknownArray;
+    exports?: UnknownArray;
 }
 /**
  * Options for testing NestJS controllers.
@@ -662,10 +655,8 @@ export interface ControllerTestHarnessOptions<T> {
  * };
  * ```
  */
-export interface ValidateMiddlwareResponseExpected {
+export interface ValidateMiddlwareResponseExpected extends Partial<WithUrl & WithStatus> {
     type: 'next' | 'redirect' | 'rewrite' | 'response';
-    url?: string;
-    status?: number;
 }
 /**
  * Options for creating service test harness.
@@ -757,7 +748,7 @@ export interface ApiRouteTestContext {
     expectStatus: (status: number) => void;
     expectJson: (data: unknown) => void;
     expectRedirect: (url: string, status?: number) => void;
-    expectHeader: (name: string, value: string | string[]) => void;
+    expectHeader: (name: string, value: Arrayable<string>) => void;
 }
 /**
  * Test context for middleware functions.
@@ -804,8 +795,8 @@ export interface MiddlewareTestContext {
  */
 export interface AppRouterHookTestOptions<TProps> extends RenderHookOptions<TProps> {
     pathname?: string;
-    searchParams?: Record<string, string | string[]>;
-    params?: Record<string, string | string[]>;
+    searchParams?: Record<string, Arrayable<string>>;
+    params?: Record<string, Arrayable<string>>;
 }
 export type UserEvent = UserEventLib;
 /**
@@ -826,7 +817,7 @@ export type UserEvent = UserEventLib;
  */
 export interface UserEventConfig {
     delay?: number;
-    advanceTimers?: (ms: number) => void | Promise<void>;
+    advanceTimers?: (ms: number) => Promisable<void>;
     applyAccept?: boolean;
     autoModify?: boolean;
     skipAutoClose?: boolean;
@@ -852,7 +843,7 @@ export interface UserEventConfig {
 export interface InteractionSequence {
     type: 'click' | 'type' | 'select' | 'check' | 'focus' | 'blur' | 'hover' | 'key' | 'paste' | 'clear' | 'upload' | 'drag' | 'scroll' | 'wait' | 'tab' | 'keyboard';
     target?: string | HTMLElement;
-    value?: string | string[] | boolean | File | File[];
+    value?: Arrayable<string> | boolean | Arrayable<File>;
     wait?: number;
     options?: {
         delay?: number;
@@ -1010,8 +1001,7 @@ export interface EventDrivenTestUtils {
  * };
  * ```
  */
-export interface TestServer {
-    url: string;
+export interface TestServer extends WithUrl {
     port: number;
     close: () => Promise<void>;
     on: (event: string, handler: Function) => void;
@@ -1069,8 +1059,7 @@ export interface ConcurrentTestResult {
  * };
  * ```
  */
-export interface RateLimitResult {
-    timestamp: number;
+export interface RateLimitResult extends WithTimestamp<number> {
     success: boolean;
     error?: Error;
 }
@@ -1105,10 +1094,9 @@ export interface RateLimitTestResult {
  * };
  * ```
  */
-export interface PollingAttempt {
+export interface PollingAttempt extends WithTimestamp<number> {
     attempt: number;
     result: unknown;
-    timestamp: number;
 }
 /**
  * Results from polling operation testing.
@@ -1159,7 +1147,7 @@ export interface DebounceTestResult {
  * ```
  */
 export interface ThrottleCall {
-    args: unknown[];
+    args: UnknownArray;
     delay: number;
 }
 /**
@@ -1176,7 +1164,7 @@ export interface ThrottleCall {
  */
 export interface ThrottleResult {
     called: boolean;
-    args?: unknown[];
+    args?: UnknownArray;
 }
 /**
  * Async testing scenario definition.
@@ -1196,11 +1184,10 @@ export interface ThrottleResult {
  * };
  * ```
  */
-export interface AsyncScenario<T = void> {
-    name: string;
+export interface AsyncScenario<T = void> extends Named {
     setup: () => Promise<void>;
     action: () => Promise<T>;
-    verify: (result: T) => void | Promise<void>;
+    verify: (result: T) => Promisable<void>;
     cleanup?: () => Promise<void>;
     expectedHooks: string[];
 }
@@ -1219,8 +1206,7 @@ export interface AsyncScenario<T = void> {
  * };
  * ```
  */
-export interface WaitForChangeOptions<T> {
-    timeout?: number;
+export interface WaitForChangeOptions<T> extends Partial<WithTimeout> {
     interval?: number;
     compareFn?: (a: T, b: T) => boolean;
 }
@@ -1721,10 +1707,9 @@ export interface AssertPerformanceOptions {
  * };
  * ```
  */
-export interface EventHistoryEntry {
+export interface EventHistoryEntry extends WithTimestamp<number> {
     event: string;
     payload: unknown;
-    timestamp: number;
 }
 /**
  * Configuration for simulating events in tests.
@@ -1771,8 +1756,7 @@ export interface SimulatedEvent {
  * const mockWS = createMockWebSocket(options);
  * ```
  */
-export interface WebSocketMockOptions {
-    url?: string;
+export interface WebSocketMockOptions extends Partial<WithUrl> {
     protocol?: string;
     extensions?: string;
     readyState?: number;
@@ -1814,8 +1798,7 @@ export interface WebSocketServerMockOptions {
  * };
  * ```
  */
-export interface WebSocketTestScenario {
-    name: string;
+export interface WebSocketTestScenario extends Named {
     message: unknown;
     expectedResponse?: unknown;
     expectedBroadcast?: unknown;
@@ -1840,11 +1823,8 @@ export interface WebSocketTestScenario {
  * const ws = await connectWebSocket(connectionOptions);
  * ```
  */
-export interface WebSocketConnectionOptions {
-    url: string;
-    protocols?: string | string[];
-    headers?: Record<string, string>;
-    timeout?: number;
+export interface WebSocketConnectionOptions extends Partial<WithTimeout>, WithUrl, WithHeaders {
+    protocols?: Arrayable<string>;
 }
 /**
  * Test configuration for file operations.
@@ -1865,9 +1845,8 @@ export interface WebSocketConnectionOptions {
  * };
  * ```
  */
-export interface FileOperationTest {
-    name: string;
-    operation: (fs: unknown) => void | Promise<void>;
+export interface FileOperationTest extends Named {
+    operation: (fs: unknown) => Promisable<void>;
     expectedFiles?: Map<string, string | globalThis.Buffer>;
     expectedError?: string | RegExp;
 }
@@ -1955,8 +1934,7 @@ export interface AriaAttributes {
  * ];
  * ```
  */
-export interface KeyboardNavigationTest {
-    element: HTMLElement;
+export interface KeyboardNavigationTest extends WithElement {
     key: string;
     expectedBehavior: 'focus' | 'activate' | 'navigate' | 'ignore';
     expectedTarget?: HTMLElement;
@@ -1981,8 +1959,7 @@ export interface KeyboardNavigationTest {
  * ];
  * ```
  */
-export interface ScreenReaderTest {
-    element: HTMLElement;
+export interface ScreenReaderTest extends WithElement {
     expectedText: string | RegExp;
     includeHidden?: boolean;
 }
@@ -2010,8 +1987,7 @@ export interface ScreenReaderTest {
  * ];
  * ```
  */
-export interface LifecycleHook {
-    name: string;
+export interface LifecycleHook extends Named {
     method: string;
     phase: 'mount' | 'update' | 'unmount' | 'init' | 'destroy';
     required?: boolean;
@@ -2037,13 +2013,12 @@ export interface LifecycleHook {
  * };
  * ```
  */
-export interface ComponentLifecycleTest {
-    name: string;
+export interface ComponentLifecycleTest extends Named {
     Component: React.ComponentType<unknown>;
-    props?: Record<string, unknown>;
+    props?: UnknownRecord;
     expectedHooks: LifecycleHook[];
     interactions?: Array<{
-        action: () => void | Promise<void>;
+        action: () => Promisable<void>;
         expectedHooksAfter: string[];
     }>;
 }
@@ -2097,10 +2072,9 @@ export interface ServiceWithLifecycle {
  * };
  * ```
  */
-export interface ServiceLifecycleTest {
-    name: string;
+export interface ServiceLifecycleTest extends Named {
     Service: new (...args: unknown[]) => ServiceWithLifecycle;
-    dependencies?: unknown[];
+    dependencies?: UnknownArray;
     expectedHooks: LifecycleHook[];
     cleanupExpected?: boolean;
 }
@@ -2118,9 +2092,7 @@ export interface ServiceLifecycleTest {
  * ```
  */
 export interface ProviderWithLifecycle {
-    constructor: {
-        name: string;
-    };
+    constructor: Named;
     onModuleInit?: () => Promise<void>;
     onModuleDestroy?: () => Promise<void>;
     [key: string]: unknown;
@@ -2140,8 +2112,7 @@ export interface ProviderWithLifecycle {
  * };
  * ```
  */
-export interface ModuleLifecycleTest {
-    name: string;
+export interface ModuleLifecycleTest extends Named {
     Module: new (...args: unknown[]) => unknown;
     providers: ProviderWithLifecycle[];
     expectedInitOrder: string[];
@@ -2162,10 +2133,9 @@ export interface ModuleLifecycleTest {
  * };
  * ```
  */
-export interface ApplicationLifecycleTest {
-    name: string;
-    app: Record<string, unknown>;
-    modules: unknown[];
+export interface ApplicationLifecycleTest extends Named {
+    app: UnknownRecord;
+    modules: UnknownArray;
     expectedStartupSequence: string[];
     expectedShutdownSequence: string[];
 }
@@ -2187,14 +2157,13 @@ export interface ApplicationLifecycleTest {
  * };
  * ```
  */
-export interface TestSuiteConfig<T> {
-    name: string;
+export interface TestSuiteConfig<T> extends Named {
     createInstance: () => T;
     defaultProps?: unknown;
-    setupBeforeAll?: () => void | Promise<void>;
-    setupBeforeEach?: () => void | Promise<void>;
-    teardownAfterEach?: () => void | Promise<void>;
-    teardownAfterAll?: () => void | Promise<void>;
+    setupBeforeAll?: () => Promisable<void>;
+    setupBeforeEach?: () => Promisable<void>;
+    teardownAfterEach?: () => Promisable<void>;
+    teardownAfterAll?: () => Promisable<void>;
 }
 /**
  * Environment configuration for testing.
@@ -2228,8 +2197,7 @@ export interface EnvironmentConfig {
  * };
  * ```
  */
-export interface AnimationTestOptions {
-    duration?: number;
+export interface AnimationTestOptions extends Partial<WithDuration> {
     easing?: string;
     delay?: number;
     iterations?: number;
@@ -2250,9 +2218,8 @@ export interface AnimationTestOptions {
  * };
  * ```
  */
-export interface TransitionTestOptions {
+export interface TransitionTestOptions extends Partial<WithDuration> {
     property?: string;
-    duration?: number;
     timingFunction?: string;
     delay?: number;
 }
@@ -2292,8 +2259,7 @@ export interface KeyframeTest {
  * };
  * ```
  */
-export interface AnimationSequence {
-    name: string;
+export interface AnimationSequence extends Named {
     steps: Array<{
         delay?: number;
         duration: number;
@@ -2317,11 +2283,10 @@ export interface AnimationSequence {
  * };
  * ```
  */
-export interface EnvironmentTestCase {
-    name: string;
+export interface EnvironmentTestCase extends Named {
     environment: EnvironmentConfig;
-    expectedBehavior: () => void | Promise<void>;
-    cleanup?: () => void | Promise<void>;
+    expectedBehavior: () => Promisable<void>;
+    cleanup?: () => Promisable<void>;
 }
 /**
  * Configuration test scenario.
@@ -2339,11 +2304,10 @@ export interface EnvironmentTestCase {
  * };
  * ```
  */
-export interface ConfigTestScenario {
-    name: string;
-    config: Record<string, unknown>;
+export interface ConfigTestScenario extends Named {
+    config: UnknownRecord;
     environment?: EnvironmentConfig;
-    expectedValues: Record<string, unknown>;
+    expectedValues: UnknownRecord;
     shouldThrow?: boolean;
     expectedError?: string | RegExp;
 }
@@ -2377,8 +2341,7 @@ export interface SpringConfig {
  * };
  * ```
  */
-export interface RAFCallback {
-    id: number;
+export interface RAFCallback extends Identifiable<number> {
     callback: FrameRequestCallback;
 }
 /**
@@ -2408,9 +2371,7 @@ export interface LoadingState {
  * };
  * ```
  */
-export interface ForTextOptions {
-    timeout?: number;
-}
+export type ForTextOptions = WithTimeout;
 /**
  * Test value with index wrapper.
  * Associates test values with their position.
@@ -2442,10 +2403,9 @@ export interface TestValueWithIndex<T> {
  * };
  * ```
  */
-export interface CallRecord {
+export interface CallRecord extends WithTimestamp<number> {
     method: string;
-    args: unknown[];
-    timestamp: number;
+    args: UnknownArray;
 }
 /**
  * Module spy for tracking calls.
@@ -2480,8 +2440,7 @@ export interface ModuleSpy<T> {
  * };
  * ```
  */
-export interface NamedTestCase<T> {
-    name: string;
+export interface NamedTestCase<T> extends Named {
     input: T;
     expected: unknown;
 }
@@ -2537,7 +2496,7 @@ export interface NextPageResult {
  * ```
  */
 export interface MockCallResult {
-    args: unknown[];
+    args: UnknownArray;
     result: unknown;
     error?: unknown;
 }
@@ -2652,12 +2611,7 @@ export interface MockNextRouterReturn {
  * };
  * ```
  */
-export interface MockNextRequest {
-    url: string;
-    method: string;
-    headers: Headers;
-    body: unknown;
-    ip: string;
+export interface MockNextRequest extends WithUrl, WithHttpMethod, WithHeaders, WithIpAddress, WithBody {
     searchParams?: Record<string, string>;
     nextUrl: {
         pathname: string;
@@ -2690,13 +2644,12 @@ export interface MockNextRequest {
  * response.redirect('/login');
  * ```
  */
-export interface MockNextResponse {
+export interface MockNextResponse extends WithStatus<number> {
     cookies: {
         set: Vitest.Mock;
         delete: Vitest.Mock;
     };
     headers: Headers;
-    status: number;
     redirect: Vitest.Mock;
     rewrite: Vitest.Mock;
     next: Vitest.Mock;
@@ -2778,7 +2731,7 @@ export interface GetStaticPathsExpectations {
     pathCount?: number;
     fallback: boolean | 'blocking';
     validatePaths?: (paths: Array<string | {
-        params: Record<string, string | string[] | undefined>;
+        params: Record<string, Arrayable<string> | undefined>;
     }>) => void;
 }
 /**
@@ -2875,15 +2828,13 @@ export interface LoadingComponentExpectations {
  * };
  * ```
  */
-export interface MiddlewareTestScenarioWithRequest {
-    name: string;
+export interface MiddlewareTestExpectedResponse extends Partial<WithUrl & WithStatus> {
+    type: 'next' | 'redirect' | 'rewrite' | 'response';
+    headers?: Record<string, string>;
+}
+export interface MiddlewareTestScenarioWithRequest extends Named {
     request: Parameters<CreateMockNextRequestFunction>;
-    expected: {
-        type: 'next' | 'redirect' | 'rewrite' | 'response';
-        url?: string;
-        headers?: Record<string, string>;
-        status?: number;
-    };
+    expected: MiddlewareTestExpectedResponse;
 }
 /**
  * API route handler methods for Next.js.
@@ -2919,8 +2870,7 @@ export interface ApiRouteHandlerMethods {
  * };
  * ```
  */
-export interface RouteHandlerTestScenario {
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+export interface RouteHandlerTestScenario extends WithHttpMethod {
     request: Parameters<CreateMockNextRequestFunction>;
     expectedStatus: number;
     expectedBody?: unknown;
@@ -2957,7 +2907,7 @@ export interface ImageLoaderTestScenario {
  * ```
  */
 export interface ParameterizedTest<T> {
-    test: (name: string, fn: (input: T, expected: unknown) => void | Promise<void>) => void;
+    test: (name: string, fn: (input: T, expected: unknown) => Promisable<void>) => void;
 }
 /**
  * Test suite for service testing.
@@ -2990,7 +2940,7 @@ export interface ServiceTestSuite<T> {
  * ```
  */
 export interface NestJSTestSuiteReturn {
-    testProviderRegistration: (providerTokens: unknown[]) => void;
+    testProviderRegistration: (providerTokens: UnknownArray) => void;
     testProviderInjection: (injectionTests: Array<ProviderInjectionTest>) => void;
 }
 /**
@@ -3091,8 +3041,7 @@ export interface MockManyResult {
  * };
  * ```
  */
-export interface RouteMatchResult {
-    params: Record<string, string | string[]>;
+export interface RouteMatchResult extends WithParams {
     isMatch: boolean;
 }
 /**
@@ -3107,8 +3056,7 @@ export interface RouteMatchResult {
  * };
  * ```
  */
-export interface PerformanceEntryResult {
-    name: string;
+export interface PerformanceEntryResult extends Named {
     metrics: PerformanceMetrics;
 }
 /**
@@ -3183,9 +3131,8 @@ export interface MemoryLeakTestResult {
  * };
  * ```
  */
-export interface PropVariation {
-    name: string;
-    props: Record<string, unknown>;
+export interface PropVariation extends Named {
+    props: UnknownRecord;
     expectation: () => void;
 }
 /**
@@ -3203,8 +3150,7 @@ export interface PropVariation {
  * };
  * ```
  */
-export interface ValidTestCase<T> {
-    name: string;
+export interface ValidTestCase<T> extends Named {
     input: unknown;
     expected?: T;
 }
@@ -3221,8 +3167,7 @@ export interface ValidTestCase<T> {
  * };
  * ```
  */
-export interface InvalidTestCase {
-    name: string;
+export interface InvalidTestCase extends Named {
     input: unknown;
     expectedError: string | RegExp;
 }
@@ -3238,8 +3183,7 @@ export interface InvalidTestCase {
  * };
  * ```
  */
-export interface CreatedResource {
-    name: string;
+export interface CreatedResource extends Named {
     resource: unknown;
 }
 /**
@@ -3255,10 +3199,9 @@ export interface CreatedResource {
  * };
  * ```
  */
-export interface LifecycleHookRecord {
+export interface LifecycleHookRecord extends WithTimestamp<number> {
     phase: string;
     method: string;
-    timestamp: number;
 }
 /**
  * Test case for path matching.
@@ -3309,7 +3252,7 @@ export interface ErrorScenario<T> {
  * ```
  */
 export interface PropsTestScenario {
-    props: Record<string, unknown>;
+    props: UnknownRecord;
     expectedContent?: string;
 }
 /**
@@ -3332,7 +3275,7 @@ export interface ResponsiveBreakpoint {
     height: number;
     expectations: () => void;
 }
-export type TestCombination<T extends Record<string, unknown[]>> = {
+export type TestCombination<T extends Record<string, UnknownArray>> = {
     [K in keyof T]: T[K][number];
 };
 /**
@@ -3377,8 +3320,7 @@ export type LoadingResult = {
  * };
  * ```
  */
-export interface TableTestCase<TInput, TExpected> {
-    name: string;
+export interface TableTestCase<TInput, TExpected> extends Named {
     input: TInput;
     expected: TExpected;
     skip?: boolean;
@@ -3401,8 +3343,7 @@ export interface TableTestCase<TInput, TExpected> {
  * };
  * ```
  */
-export interface EdgeCaseTest<T, R> {
-    name: string;
+export interface EdgeCaseTest<T, R> extends Named {
     input: T;
     expected?: R;
     shouldThrow?: string | RegExp | Error;
@@ -3565,8 +3506,7 @@ export interface BoundaryValueTest<T> {
  * };
  * ```
  */
-export interface EquivalenceClassTest<T, R> {
-    name: string;
+export interface EquivalenceClassTest<T, R> extends Named {
     samples: T[];
     expected: R;
 }
@@ -3608,12 +3548,11 @@ export interface StateTransitionTest<TState, TAction> {
  * };
  * ```
  */
-export interface SnapshotTestCase<T> {
-    name: string;
+export interface SnapshotTestCase<T> extends Named {
     input: T;
     transform?: (input: T) => unknown;
 }
-export interface CombinationTestOptions<T extends Record<string, unknown[]>> {
+export interface CombinationTestOptions<T extends Record<string, UnknownArray>> {
     filter?: (combination: TestCombination<T>) => boolean;
     maxCombinations?: number;
 }
@@ -3639,8 +3578,7 @@ export interface ParallaxElement {
     element: HTMLElement;
     speed: number;
 }
-export interface SpringAnimationConfigTest {
-    name: string;
+export interface SpringAnimationConfigTest extends Named {
     tension: number;
     friction: number;
     mass: number;
@@ -3680,8 +3618,7 @@ export interface EnvironmentHooks {
     getManager: () => EnvironmentManager;
     useEnvironment: (env: EnvironmentConfig) => void;
 }
-export interface EnvironmentValidationTestCase {
-    name: string;
+export interface EnvironmentValidationTestCase extends Named {
     environment: EnvironmentConfig;
     shouldPass: boolean;
     expectedErrors?: string[];
@@ -3692,49 +3629,39 @@ export interface EnvironmentFeatureFlagScenario {
     defaultValue?: boolean;
     expectedValue: boolean;
 }
-export interface DatabaseEnvironmentTest {
-    name: string;
+export interface DatabaseEnvironmentTest extends Named {
     environment: EnvironmentConfig;
-    expectedConfig: Record<string, unknown>;
+    expectedConfig: UnknownRecord;
     shouldConnect: boolean;
 }
-export interface LoggingEnvironmentTest {
-    name: string;
+export interface LoggingEnvironmentTest extends Named {
     environment: EnvironmentConfig;
     expectedLevel: string;
     expectedFormat?: string;
     expectedTransports?: string[];
 }
-export interface APIClientEnvironmentTest {
-    name: string;
+export interface APIClientEnvironmentTest extends Named {
     environment: EnvironmentConfig;
     expectedBaseURL: string;
     expectedTimeout: number;
     expectedHeaders?: Record<string, string>;
 }
-export interface SecretsManagementTest {
-    name: string;
+export interface SecretsManagementTest extends Named {
     environment: EnvironmentConfig;
     secrets: Record<string, string>;
     expectedBehavior: 'store' | 'mock' | 'error';
 }
-export interface SecretsManager {
-    get: (key: string) => Promise<string | undefined>;
-    set: (key: string, value: string) => Promise<void>;
-    delete: (key: string) => Promise<void>;
+export interface SecretsManager extends KeyValueStore<string, string> {
 }
-export interface MockEnvironment {
+export interface MockEnvironment extends KeyValueStore<string, string> {
     update: (updates: EnvironmentConfig) => void;
-    get: (key: string) => string | undefined;
-    set: (key: string, value: string) => void;
     unset: (key: string) => void;
     restore: () => void;
     getAll: () => EnvironmentConfig;
-    clear: () => void;
 }
 export interface EnvironmentTransformationTestCase {
     input: EnvironmentConfig;
-    expectedOutput: Record<string, unknown>;
+    expectedOutput: UnknownRecord;
     description: string;
 }
 export interface UserInteraction {
@@ -3754,7 +3681,7 @@ export interface AccessibilityReport {
 }
 export interface MockNextNavigationOptions {
     pathname?: string;
-    searchParams?: Record<string, string | string[]>;
+    searchParams?: Record<string, Arrayable<string>>;
     push?: ReturnType<typeof Vitest.vi.fn>;
     replace?: ReturnType<typeof Vitest.vi.fn>;
     refresh?: ReturnType<typeof Vitest.vi.fn>;
@@ -3762,13 +3689,12 @@ export interface MockNextNavigationOptions {
     forward?: ReturnType<typeof Vitest.vi.fn>;
 }
 export interface SRTestOptions {
-    initialProps: Record<string, unknown>;
+    initialProps: UnknownRecord;
     revalidate: number;
-    newProps: Record<string, unknown>;
+    newProps: UnknownRecord;
     waitTime?: number;
 }
-export interface ApiRouteTestScenario {
-    name: string;
+export interface ApiRouteTestScenario extends Named {
     request: Partial<MockNextApiRequest>;
     expectedStatus: number;
     expectedBody?: unknown;
@@ -3796,17 +3722,15 @@ export interface ApiAuthScenario {
     expectedStatus: number;
     expectedMessage?: string;
 }
-export interface ApiRouteOptions {
+export interface ApiRouteOptions extends Partial<WithUrl> {
     method?: string;
-    url?: string;
-    headers?: Record<string, string | string[]>;
-    query?: Record<string, string | string[]>;
+    headers?: Record<string, Arrayable<string>>;
+    query?: Record<string, Arrayable<string>>;
     body?: unknown;
     cookies?: Record<string, string>;
 }
-export interface ServerComponentTestScenario {
-    name: string;
-    props: Record<string, unknown>;
+export interface ServerComponentTestScenario extends Named {
+    props: UnknownRecord;
     searchParams?: Record<string, string>;
     params?: Record<string, string>;
     expectedContent?: string | RegExp;
@@ -3823,7 +3747,7 @@ export interface ServerComponentTestScenario {
  * ```
  */
 export interface MiddlewareMatcherConfig {
-    matcher: string | string[];
+    matcher: Arrayable<string>;
 }
 /**
  * Result from mocking Next.js navigation.
@@ -3957,7 +3881,7 @@ export interface ComponentWithLoading {
  * ```
  */
 export interface ConditionalRenderingTest {
-    props: Record<string, unknown>;
+    props: UnknownRecord;
     shouldRender: string[];
     shouldNotRender: string[];
 }
@@ -3978,7 +3902,7 @@ export interface ProviderConfig {
         children: React.ReactNode;
         [key: string]: unknown;
     }>;
-    props?: Record<string, unknown>;
+    props?: UnknownRecord;
 }
 /**
  * Test case for user interactions.
@@ -3993,8 +3917,7 @@ export interface ProviderConfig {
  * };
  * ```
  */
-export interface UserInteractionTest {
-    name: string;
+export interface UserInteractionTest extends Named {
     action: (user: unknown) => Promise<void>;
     expectation: () => void;
 }
@@ -4048,8 +3971,7 @@ export interface ComponentTestSuiteResult {
  * };
  * ```
  */
-export interface ResourceCleanupTest {
-    name: string;
+export interface ResourceCleanupTest extends Named {
     create: () => unknown;
     cleanup: (resource: unknown) => Promise<void> | void;
     isCleanedUp: (resource: unknown) => boolean;
@@ -4070,7 +3992,7 @@ export interface ResourceCleanupTest {
 export interface DependencyInjectionContainer {
     register: (token: unknown, factory: () => unknown, options: {
         lifecycle: 'singleton' | 'transient' | 'scoped';
-        dependencies?: unknown[];
+        dependencies?: UnknownArray;
     }) => void;
     resolve: (token: unknown) => unknown;
     dispose: () => Promise<void>;
@@ -4093,7 +4015,7 @@ export interface DependencyInjectionContainer {
 export interface DependencyInjectionConfig {
     token: unknown;
     factory: () => unknown;
-    dependencies?: unknown[];
+    dependencies?: UnknownArray;
     lifecycle: 'singleton' | 'transient' | 'scoped';
     cleanup?: (instance: unknown) => void;
 }
@@ -4112,10 +4034,8 @@ export interface DependencyInjectionConfig {
  * };
  * ```
  */
-export interface AsyncLifecycleHook {
-    name: string;
+export interface AsyncLifecycleHook extends Named, Partial<WithTimeout> {
     method: string;
-    timeout?: number;
     shouldReject?: boolean;
     expectedError?: string | RegExp;
 }
@@ -4199,26 +4119,26 @@ export interface MockIntersectionObserverEntry {
     intersectionRatio: number;
     boundingClientRect: DOMRect;
 }
-export type ConfigObject = Record<string, unknown>;
+export type ConfigObject = UnknownRecord;
 export type ConfigLoader = (env: string) => unknown;
 export type EnvironmentTransformer = (env: EnvironmentConfig) => ConfigObject;
 export type KeyboardUserInteraction = Pick<UserInteraction, 'keyboard'>;
 export type FocusUserInteraction = Required<Pick<UserInteraction, 'keyboard' | 'tab'>>;
 export type SkipLinkUserInteraction = Required<Pick<UserInteraction, 'click' | 'tab'>>;
 export type AccessibilityAttributesMap = Record<string, string>;
-export type TestParameters = Record<string, unknown>;
-export type TestMatrixInputs<T extends Record<string, unknown[]>> = {
+export type TestParameters = UnknownRecord;
+export type TestMatrixInputs<T extends Record<string, UnknownArray>> = {
     [K in keyof T]: T[K][];
 };
-export type TestMatrixCombination<T extends Record<string, unknown[]>> = {
+export type TestMatrixCombination<T extends Record<string, UnknownArray>> = {
     [K in keyof T]: T[K][number];
 };
-export type PartialTestMatrixCombination<T extends Record<string, unknown[]>> = Partial<{
+export type PartialTestMatrixCombination<T extends Record<string, UnknownArray>> = Partial<{
     [K in keyof T]: T[K][number];
 }>;
-export type PropertyTestFunction<T> = (value: T) => boolean | Promise<boolean>;
+export type PropertyTestFunction<T> = (value: T) => Promisable<boolean>;
 export type StateTransitionApplyFunction<TState, TAction> = (state: TState, action: TAction) => TState;
-export type CombinationTestFunction<T extends Record<string, unknown[]>> = (combination: TestCombination<T>) => void | Promise<void>;
+export type CombinationTestFunction<T extends Record<string, UnknownArray>> = (combination: TestCombination<T>) => Promisable<void>;
 export type UnknownFunction = (...args: unknown[]) => unknown;
 /**
  * Configuration for spy target.
@@ -4255,9 +4175,8 @@ export type ModuleMockFactories = Record<string, () => UnknownRecord>;
  * };
  * ```
  */
-export interface TestCaseWithSetup<T> {
-    name: string;
-    args: unknown[];
+export interface TestCaseWithSetup<T> extends Named {
+    args: UnknownArray;
     expected: unknown;
     setup?: (instance: T) => void;
 }
@@ -4277,8 +4196,7 @@ export interface TestCaseWithSetup<T> {
  * };
  * ```
  */
-export interface LifecycleHookTestConfig<T> {
-    name: string;
+export interface LifecycleHookTestConfig<T> extends Named {
     hook: keyof T;
     expectedCalls?: number;
     expectError?: boolean;
@@ -4301,7 +4219,7 @@ export interface LifecycleHookTestConfig<T> {
  */
 export interface ErrorHandlingScenario<T> {
     method: keyof T;
-    args: unknown[];
+    args: UnknownArray;
     expectedError: string | RegExp | typeof Error;
     setup?: (instance: T) => void;
 }
@@ -4484,7 +4402,7 @@ export interface ServiceTestHarnessReturn<T> {
  * ```
  */
 export interface DynamicModuleClass {
-    forRoot: (config: unknown) => Record<string, unknown>;
+    forRoot: (config: unknown) => UnknownRecord;
 }
 /**
  * Expectations for dynamic module testing.
@@ -4500,9 +4418,9 @@ export interface DynamicModuleClass {
  * ```
  */
 export interface DynamicModuleExpectations {
-    providers?: unknown[];
-    imports?: unknown[];
-    exports?: unknown[];
+    providers?: UnknownArray;
+    imports?: UnknownArray;
+    exports?: UnknownArray;
 }
 /**
  * Return value from NestJS test suite setup.
@@ -4538,8 +4456,8 @@ export interface NestJSTestSuiteSetupReturn {
  */
 export interface ProviderInjectionTest {
     token: unknown;
-    dependencies: unknown[];
-    testFn: (instance: unknown, deps: unknown[]) => void;
+    dependencies: UnknownArray;
+    testFn: (instance: unknown, deps: UnknownArray) => void;
 }
 /**
  * WebSocket ping message.
@@ -4638,10 +4556,9 @@ export interface ImageLoaderInput {
  * };
  * ```
  */
-export interface UserFlowStep {
-    name: string;
+export interface UserFlowStep extends Named {
     interactions: InteractionSequence[];
-    assertions: () => void | Promise<void>;
+    assertions: () => Promisable<void>;
     navigation?: {
         expectedUrl?: string;
         waitForNavigation?: boolean;
@@ -4690,8 +4607,8 @@ export interface MockNextRequestCreatorParams {
  */
 export interface ProviderInjection {
     token: unknown;
-    dependencies: unknown[];
-    testFn: (instance: unknown, deps: unknown[]) => void;
+    dependencies: UnknownArray;
+    testFn: (instance: unknown, deps: UnknownArray) => void;
 }
 /**
  * Mock Redis client interface.
@@ -4735,10 +4652,10 @@ export interface CreateMockRedisClientMock {
  * ```
  */
 export interface CallTracker {
-    trackCall: (name: string, args: unknown[]) => void;
+    trackCall: (name: string, args: UnknownArray) => void;
     getCalls: (name?: string) => Array<{
         name: string;
-        args: unknown[];
+        args: UnknownArray;
         timestamp: number;
     }>;
     reset: () => void;
@@ -4762,7 +4679,7 @@ export interface CallTracker {
 export interface TrackedSpy extends SpyInstance {
     getCallCount: () => number;
     getCallHistory: () => Array<{
-        args: unknown[];
+        args: UnknownArray;
         result?: unknown;
         error?: unknown;
     }>;
@@ -4811,9 +4728,8 @@ export interface TrackedData<T> {
  * };
  * ```
  */
-export interface AccessInfo {
+export interface AccessInfo extends WithTimestamp<number> {
     property: string | symbol;
-    timestamp: number;
     count: number;
 }
 /**
@@ -4985,8 +4901,8 @@ export interface WorkerTestHarness {
  * ```
  */
 export interface WorkerSpy {
-    getMessagesSent: () => unknown[];
-    getMessagesReceived: () => unknown[];
+    getMessagesSent: () => UnknownArray;
+    getMessagesReceived: () => UnknownArray;
     getErrors: () => Error[];
     isTerminated: () => boolean;
     simulateMessage: (message: unknown) => void;
@@ -5150,7 +5066,7 @@ export interface MonitorOptions {
  * };
  * ```
  */
-export interface PerformanceMonitor {
+export interface PerformanceMonitor extends Resettable {
     start: () => void;
     stop: () => void;
     getMetrics: () => {
@@ -5158,7 +5074,6 @@ export interface PerformanceMonitor {
         memory?: number[];
         timestamps: number[];
     };
-    reset: () => void;
 }
 /**
  * Options for memory leak testing.
@@ -5217,10 +5132,9 @@ export interface LeakResult {
  * };
  * ```
  */
-export interface HookScenario {
-    name: string;
-    action: () => void | Promise<void>;
-    expectedState: Record<string, unknown>;
+export interface HookScenario extends Named {
+    action: () => Promisable<void>;
+    expectedState: UnknownRecord;
     expectedError?: Error | null;
 }
 /**
@@ -5245,10 +5159,9 @@ export interface SuspenseOptions {
  * Concurrent rendering scenario
  * @interface ConcurrentScenario
  */
-export interface ConcurrentScenario {
-    name: string;
+export interface ConcurrentScenario extends Named {
     priority: 'high' | 'low' | 'normal';
-    action: () => void | Promise<void>;
+    action: () => Promisable<void>;
     expectedBehavior: () => void;
 }
 /**
@@ -5266,10 +5179,7 @@ export interface A11yOptions {
  * Accessibility violation
  * @interface A11yViolation
  */
-export interface A11yViolation {
-    id: string;
-    impact?: 'minor' | 'moderate' | 'serious' | 'critical';
-    description: string;
+export interface A11yViolation extends Identifiable, Describable, Partial<WithImpact> {
     help: string;
     helpUrl: string;
     nodes: Array<{
@@ -5343,31 +5253,26 @@ export interface ContrastResult {
  * User session options
  * @interface SessionOptions
  */
-export interface SessionOptions {
-    userId?: string;
+export interface SessionOptions extends Partial<WithUserId & WithLocale> {
     deviceType?: 'desktop' | 'mobile' | 'tablet';
     browser?: string;
     viewport?: {
         width: number;
         height: number;
     };
-    locale?: string;
     timezone?: string;
 }
 /**
  * User event session
  * @interface UserSession
  */
-export interface UserSession {
-    id: string;
-    userId: string;
+export interface UserSession extends Identifiable, WithLocale, WithUserId {
     deviceType: 'desktop' | 'mobile' | 'tablet';
     browser: string;
     viewport: {
         width: number;
         height: number;
     };
-    locale: string;
     timezone: string;
     startTime: Date;
     interactions: Interaction[];
@@ -5397,8 +5302,7 @@ export interface TypeOptions {
  * Drag options
  * @interface DragOptions
  */
-export interface DragOptions {
-    duration?: number;
+export interface DragOptions extends Partial<WithDuration> {
     steps?: number;
     dropEffect?: 'move' | 'copy' | 'link' | 'none';
 }
@@ -5439,24 +5343,20 @@ export type TouchGestureAdvanced = {
  * User interaction record
  * @interface Interaction
  */
-export interface Interaction {
-    timestamp: Date;
+export interface Interaction extends WithTimestamp<Date>, WithDuration {
     type: string;
     target: string;
     data?: unknown;
-    duration?: number;
 }
 /**
  * Swipe gesture parameters
  * @interface SwipeGestureParams
  */
-export interface SwipeGestureParams {
-    element: Element;
+export interface SwipeGestureParams extends WithElement<Element>, WithDuration {
     startX: number;
     startY: number;
     endX: number;
     endY: number;
-    duration: number;
 }
 /**
  * Pinch gesture parameters
@@ -5473,8 +5373,7 @@ export interface PinchGestureParams {
  * Animation frame data
  * @interface Frame
  */
-export interface Frame {
-    timestamp: number;
+export interface Frame extends WithTimestamp<number> {
     styles: Record<string, string>;
 }
 /**
@@ -5509,9 +5408,7 @@ export interface RAFMock {
  * Interval handle
  * @interface IntervalHandle
  */
-export interface IntervalHandle {
-    stop: () => void;
-    isRunning: () => boolean;
+export interface IntervalHandle extends Pick<IntervalControl, 'stop' | 'isRunning'> {
 }
 /**
  * Schedule handle
@@ -5594,25 +5491,24 @@ export interface MockLocation {
  * @interface RouteExpectation
  */
 export interface RouteExpectation {
-    params?: Record<string, string | string[]>;
-    query?: Record<string, string | string[]>;
-    beforeTransition?: () => void | Promise<void>;
-    afterTransition?: () => void | Promise<void>;
+    params?: Record<string, Arrayable<string>>;
+    query?: Record<string, Arrayable<string>>;
+    beforeTransition?: () => Promisable<void>;
+    afterTransition?: () => Promisable<void>;
 }
 /**
  * Route guard configuration
  * @interface RouteGuard
  */
 export interface RouteGuard {
-    canActivate?: (to: string, from: string) => boolean | Promise<boolean>;
-    canDeactivate?: (from: string, to: string) => boolean | Promise<boolean>;
+    canActivate?: (to: string, from: string) => Promisable<boolean>;
+    canDeactivate?: (from: string, to: string) => Promisable<boolean>;
 }
 /**
  * Guard scenario for testing
  * @interface GuardScenario
  */
-export interface GuardScenario {
-    name: string;
+export interface GuardScenario extends Named {
     from: string;
     to: string;
     shouldAllow: boolean;
@@ -5654,7 +5550,7 @@ export interface NextTestContext {
  */
 export interface SSPContext extends Partial<MockGetServerSidePropsContext> {
     scenario?: string;
-    expectedProps?: Record<string, unknown>;
+    expectedProps?: UnknownRecord;
     expectedRedirect?: {
         destination: string;
         permanent?: boolean;
@@ -5667,7 +5563,7 @@ export interface SSPContext extends Partial<MockGetServerSidePropsContext> {
  */
 export interface SPContext extends Partial<MockGetStaticPropsContext> {
     scenario?: string;
-    expectedProps?: Record<string, unknown>;
+    expectedProps?: UnknownRecord;
     expectedRevalidate?: number;
     expectedRedirect?: {
         destination: string;
@@ -5679,12 +5575,8 @@ export interface SPContext extends Partial<MockGetStaticPropsContext> {
  * API request test configuration
  * @interface APIRequest
  */
-export interface APIRequest {
+export interface APIRequest extends Partial<WithHttpMethod>, Partial<WithHeaders>, Partial<WithBody>, Partial<WithQueryParams> {
     scenario?: string;
-    method?: string;
-    headers?: Record<string, string>;
-    body?: unknown;
-    query?: Record<string, string>;
     cookies?: Record<string, string>;
     expectedStatus?: number;
     expectedBody?: unknown;
@@ -5694,23 +5586,21 @@ export interface APIRequest {
  * Lifecycle testing scenario
  * @interface LifecycleScenario
  */
-export interface LifecycleScenario {
-    name: string;
-    action: () => void | Promise<void>;
-    expectedState?: Record<string, unknown>;
+export interface LifecycleScenario extends Named {
+    action: () => Promisable<void>;
+    expectedState?: UnknownRecord;
     expectedEvents?: string[];
 }
 /**
  * Lifecycle event tracker
  * @interface LifecycleTracker
  */
-export interface LifecycleTracker {
+export interface LifecycleTracker extends Clearable {
     events: Array<{
         type: string;
         timestamp: number;
         data?: unknown;
     }>;
-    clear: () => void;
     getEvents: () => Array<{
         type: string;
         timestamp: number;
@@ -5794,9 +5684,8 @@ export interface EnvMock {
  * Environment snapshot
  * @interface EnvSnapshot
  */
-export interface EnvSnapshot {
+export interface EnvSnapshot extends WithKeyValues<string | undefined>, WithTimestamp<number> {
     variables: Record<string, string | undefined>;
-    timestamp: number;
 }
 /**
  * System signal type
@@ -5807,13 +5696,13 @@ export type Signal = 'SIGTERM' | 'SIGINT' | 'SIGHUP' | 'SIGUSR1' | 'SIGUSR2';
  * Signal handler function
  * @type SignalHandler
  */
-export type SignalHandler = (signal: Signal) => void | Promise<void>;
+export type SignalHandler = (signal: Signal) => Promisable<void>;
 /**
  * Component type for lifecycle testing
  * @type ComponentType
  * @typeParam P - Props type
  */
-export type ComponentType<P = Record<string, unknown>> = new (props: P) => React.Component<P>;
+export type ComponentType<P = UnknownRecord> = new (props: P) => React.Component<P>;
 /**
  * Next.js Get Server-Side Props function
  * @type GSSP
@@ -5857,7 +5746,7 @@ export interface PipelineResult {
 export interface ModuleMocks {
     restore: () => void;
     getCallCount: (moduleName: string) => number;
-    getLastCall: (moduleName: string) => unknown[];
+    getLastCall: (moduleName: string) => UnknownArray;
 }
 /**
  * Async hook interface