vimonkey 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimonkey",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Fuzz testing with auto-shrinking and composable chaos stream transformers for Vitest",
   "keywords": [
     "async-generator",
@@ -29,8 +29,7 @@
     "url": "https://github.com/beorn/vimonkey.git"
   },
   "files": [
-    "src",
-    "dist"
+    "src"
   ],
   "type": "module",
   "module": "./src/index.ts",
@@ -59,5 +58,8 @@
   },
   "peerDependencies": {
     "vitest": ">=4.0.0"
+  },
+  "engines": {
+    "node": ">=23.6.0"
   }
-}
+}

package/dist/chaos/index.d.ts

@@ -1,81 +0,0 @@
-/**
- * Chaos stream transformers for fuzz testing
- *
- * Composable async iterable transformers that sit between gen() and take()
- * to simulate unreliable delivery: dropped messages, reordering, duplicates,
- * bursts, delays, and gaps.
- *
- * @example
- * ```typescript
- * import { gen, take } from "vimonkey"
- * import { drop, reorder, chaos } from "vimonkey/chaos"
- *
- * const base = gen(picker)
- * const chaotic = reorder(drop(base, 0.2, rng), 5, rng)
- * for await (const event of take(chaotic, 100)) { ... }
- * ```
- */
-import type { SeededRandom } from "../random.js";
-/**
- * Skip items with probability `rate`.
- * Simulates message loss, queue overflow, network drops.
- */
-export declare function drop<T>(source: AsyncIterable<T>, rate: number, rng: SeededRandom): AsyncGenerator<T>;
-/**
- * Buffer up to `windowSize` items, shuffle, yield when buffer is full.
- * Simulates out-of-order delivery, non-deterministic event ordering.
- */
-export declare function reorder<T>(source: AsyncIterable<T>, windowSize: number, rng: SeededRandom): AsyncGenerator<T>;
-/**
- * With probability `rate`, yield the item twice.
- * Simulates duplicate delivery, at-least-once semantics.
- */
-export declare function duplicate<T>(source: AsyncIterable<T>, rate: number, rng: SeededRandom): AsyncGenerator<T>;
-/**
- * Collect `burstSize` items, then yield them all at once.
- * Simulates bursty delivery, batched network packets.
- */
-export declare function burst<T>(source: AsyncIterable<T>, burstSize: number): AsyncGenerator<T>;
-/**
- * Skip the first `count` items.
- * Simulates missed events during initialization, late subscriber.
- */
-export declare function initGap<T>(source: AsyncIterable<T>, count: number): AsyncGenerator<T>;
-/**
- * Add a random delay before yielding each item.
- * Simulates slow I/O, network latency, disk delays.
- */
-export declare function delay<T>(source: AsyncIterable<T>, minMs: number, maxMs: number, rng: SeededRandom): AsyncGenerator<T>;
-/** Configuration for a chaos transformer in the pipeline */
-export interface ChaosConfig {
-    type: string;
-    params: Record<string, unknown>;
-}
-/** Registry of transformer factories keyed by config type */
-export type ChaosRegistry<T> = Record<string, (source: AsyncIterable<T>, params: Record<string, unknown>, rng: SeededRandom) => AsyncIterable<T>>;
-/**
- * Compose multiple chaos transformer configs into a single async iterable pipeline.
- *
- * Uses built-in transformers by default. Pass a custom `registry` to add
- * domain-specific transformers (e.g., FS-specific atomicSave, coalesce).
- *
- * @example
- * ```typescript
- * const chaotic = chaos(source, [
- *   { type: "drop", params: { rate: 0.2 } },
- *   { type: "reorder", params: { windowSize: 5 } },
- * ], rng)
- * ```
- *
- * @example Custom registry
- * ```typescript
- * const chaotic = chaos(source, configs, rng, {
- *   ...builtinChaosRegistry,
- *   atomic_save: (s, p, rng) => atomicSave(s, p.rate, rng),
- * })
- * ```
- */
-export declare function chaos<T>(source: AsyncIterable<T>, configs: ChaosConfig[], rng: SeededRandom, registry?: ChaosRegistry<T>): AsyncIterable<T>;
-/** Re-export the built-in registry for extension */
-export declare const builtinChaosRegistry: ChaosRegistry<unknown>;
-//# sourceMappingURL=index.d.ts.map

package/dist/chaos/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chaos/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAMhD;;;GAGG;AACH,wBAAuB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,CAI3G;AAED;;;GAGG;AACH,wBAAuB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,CAcpH;AAED;;;GAGG;AACH,wBAAuB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,cAAc,CAAC,CAAC,CAAC,CAKhH;AAED;;;GAGG;AACH,wBAAuB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAU9F;AAED;;;GAGG;AACH,wBAAuB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAS5F;AAED;;;GAGG;AACH,wBAAuB,KAAK,CAAC,CAAC,EAC5B,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,YAAY,GAChB,cAAc,CAAC,CAAC,CAAC,CAMnB;AAMD,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,6DAA6D;AAC7D,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,MAAM,CACnC,MAAM,EACN,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,YAAY,KAAK,aAAa,CAAC,CAAC,CAAC,CACnG,CAAA;AAYD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,OAAO,EAAE,WAAW,EAAE,EACtB,GAAG,EAAE,YAAY,EACjB,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,CAAC,CAUlB;AAED,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,OAAO,CAAoB,CAAA"}

package/dist/chaos/index.js

@@ -1,148 +0,0 @@
-/**
- * Chaos stream transformers for fuzz testing
- *
- * Composable async iterable transformers that sit between gen() and take()
- * to simulate unreliable delivery: dropped messages, reordering, duplicates,
- * bursts, delays, and gaps.
- *
- * @example
- * ```typescript
- * import { gen, take } from "vimonkey"
- * import { drop, reorder, chaos } from "vimonkey/chaos"
- *
- * const base = gen(picker)
- * const chaotic = reorder(drop(base, 0.2, rng), 5, rng)
- * for await (const event of take(chaotic, 100)) { ... }
- * ```
- */
-// ---------------------------------------------------------------------------
-// Individual transformers
-// ---------------------------------------------------------------------------
-/**
- * Skip items with probability `rate`.
- * Simulates message loss, queue overflow, network drops.
- */
-export async function* drop(source, rate, rng) {
-    for await (const item of source) {
-        if (!rng.bool(rate))
-            yield item;
-    }
-}
-/**
- * Buffer up to `windowSize` items, shuffle, yield when buffer is full.
- * Simulates out-of-order delivery, non-deterministic event ordering.
- */
-export async function* reorder(source, windowSize, rng) {
-    const buffer = [];
-    for await (const item of source) {
-        buffer.push(item);
-        if (buffer.length >= windowSize) {
-            const shuffled = rng.shuffle(buffer);
-            buffer.length = 0;
-            for (const e of shuffled)
-                yield e;
-        }
-    }
-    if (buffer.length > 0) {
-        const shuffled = rng.shuffle(buffer);
-        for (const e of shuffled)
-            yield e;
-    }
-}
-/**
- * With probability `rate`, yield the item twice.
- * Simulates duplicate delivery, at-least-once semantics.
- */
-export async function* duplicate(source, rate, rng) {
-    for await (const item of source) {
-        yield item;
-        if (rng.bool(rate))
-            yield item;
-    }
-}
-/**
- * Collect `burstSize` items, then yield them all at once.
- * Simulates bursty delivery, batched network packets.
- */
-export async function* burst(source, burstSize) {
-    const buffer = [];
-    for await (const item of source) {
-        buffer.push(item);
-        if (buffer.length >= burstSize) {
-            for (const e of buffer)
-                yield e;
-            buffer.length = 0;
-        }
-    }
-    for (const e of buffer)
-        yield e;
-}
-/**
- * Skip the first `count` items.
- * Simulates missed events during initialization, late subscriber.
- */
-export async function* initGap(source, count) {
-    let skipped = 0;
-    for await (const item of source) {
-        if (skipped < count) {
-            skipped++;
-            continue;
-        }
-        yield item;
-    }
-}
-/**
- * Add a random delay before yielding each item.
- * Simulates slow I/O, network latency, disk delays.
- */
-export async function* delay(source, minMs, maxMs, rng) {
-    for await (const item of source) {
-        const ms = rng.int(minMs, maxMs);
-        await new Promise((resolve) => setTimeout(resolve, ms));
-        yield item;
-    }
-}
-/** Built-in transformer registry (works for any T) */
-const BUILTIN_REGISTRY = {
-    drop: (s, p, rng) => drop(s, p.rate ?? 0.2, rng),
-    reorder: (s, p, rng) => reorder(s, p.windowSize ?? 5, rng),
-    duplicate: (s, p, rng) => duplicate(s, p.rate ?? 0.3, rng),
-    burst: (s, p) => burst(s, p.burstSize ?? 10),
-    initGap: (s, p) => initGap(s, p.count ?? 5),
-    delay: (s, p, rng) => delay(s, p.minMs ?? 1, p.maxMs ?? 5, rng),
-};
-/**
- * Compose multiple chaos transformer configs into a single async iterable pipeline.
- *
- * Uses built-in transformers by default. Pass a custom `registry` to add
- * domain-specific transformers (e.g., FS-specific atomicSave, coalesce).
- *
- * @example
- * ```typescript
- * const chaotic = chaos(source, [
- *   { type: "drop", params: { rate: 0.2 } },
- *   { type: "reorder", params: { windowSize: 5 } },
- * ], rng)
- * ```
- *
- * @example Custom registry
- * ```typescript
- * const chaotic = chaos(source, configs, rng, {
- *   ...builtinChaosRegistry,
- *   atomic_save: (s, p, rng) => atomicSave(s, p.rate, rng),
- * })
- * ```
- */
-export function chaos(source, configs, rng, registry) {
-    const reg = registry ?? BUILTIN_REGISTRY;
-    let pipeline = source;
-    for (const config of configs) {
-        const factory = reg[config.type];
-        if (factory) {
-            pipeline = factory(pipeline, config.params, rng);
-        }
-    }
-    return pipeline;
-}
-/** Re-export the built-in registry for extension */
-export const builtinChaosRegistry = BUILTIN_REGISTRY;

package/dist/env.d.ts

@@ -1,38 +0,0 @@
-/**
- * TEST_SYS environment handling
- *
- * Controls the implementation used during tests:
- * - fake: Use fake/mock implementations (fast, isolated)
- * - real:mem: Real implementation with in-memory storage
- * - real:disk: Real implementation with temporary disk storage
- */
-export type TestSys = "fake" | "real:mem" | "real:disk";
-/**
- * Get the current TEST_SYS value
- *
- * @returns The test system type, defaults to 'fake'
- *
- * @example
- * ```typescript
- * import { getTestSys } from 'vimonkey'
- *
- * const sys = getTestSys()
- * if (sys === 'fake') {
- *   // use mock
- * } else if (sys === 'real:mem') {
- *   // use real with in-memory storage
- * } else {
- *   // use real with disk storage
- * }
- * ```
- */
-export declare function getTestSys(): TestSys;
-/**
- * Check if running with real implementation
- */
-export declare function isRealSys(): boolean;
-/**
- * Check if running with disk storage
- */
-export declare function isDiskSys(): boolean;
-//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;AAIvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAepC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAGnC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/dist/env.js

@@ -1,52 +0,0 @@
-/**
- * TEST_SYS environment handling
- *
- * Controls the implementation used during tests:
- * - fake: Use fake/mock implementations (fast, isolated)
- * - real:mem: Real implementation with in-memory storage
- * - real:disk: Real implementation with temporary disk storage
- */
-const VALID_VALUES = ["fake", "real:mem", "real:disk"];
-/**
- * Get the current TEST_SYS value
- *
- * @returns The test system type, defaults to 'fake'
- *
- * @example
- * ```typescript
- * import { getTestSys } from 'vimonkey'
- *
- * const sys = getTestSys()
- * if (sys === 'fake') {
- *   // use mock
- * } else if (sys === 'real:mem') {
- *   // use real with in-memory storage
- * } else {
- *   // use real with disk storage
- * }
- * ```
- */
-export function getTestSys() {
-    const value = process.env.TEST_SYS;
-    if (!value) {
-        return "fake";
-    }
-    if (!VALID_VALUES.includes(value)) {
-        console.warn(`Invalid TEST_SYS value: "${value}". ` + `Valid values: ${VALID_VALUES.join(", ")}. ` + `Defaulting to "fake".`);
-        return "fake";
-    }
-    return value;
-}
-/**
- * Check if running with real implementation
- */
-export function isRealSys() {
-    const sys = getTestSys();
-    return sys === "real:mem" || sys === "real:disk";
-}
-/**
- * Check if running with disk storage
- */
-export function isDiskSys() {
-    return getTestSys() === "real:disk";
-}

package/dist/fuzz/context.d.ts

@@ -1,36 +0,0 @@
-/**
- * Fuzz test context using AsyncLocalStorage for auto-tracking
- *
- * When running inside test.fuzz(), take() automatically records
- * yielded values for shrinking and regression testing.
- */
-import { AsyncLocalStorage } from "node:async_hooks";
-export interface FuzzContext {
-    /** Recorded history of yielded values */
-    history: unknown[];
-    /** If replaying, the sequence to replay */
-    replaySequence: unknown[] | null;
-    /** Current index in replay sequence */
-    replayIndex: number;
-    /** The seed used for this test run */
-    seed: number;
-}
-/** AsyncLocalStorage for fuzz test context */
-export declare const fuzzContext: AsyncLocalStorage<FuzzContext>;
-/**
- * Create a new fuzz context
- */
-export declare function createFuzzContext(seed: number): FuzzContext;
-/**
- * Create a replay context from a saved sequence
- */
-export declare function createReplayContext(sequence: unknown[], seed: number): FuzzContext;
-/**
- * Check if we're currently in a fuzz context
- */
-export declare function isInFuzzContext(): boolean;
-/**
- * Get the current fuzz context or undefined
- */
-export declare function getFuzzContext(): FuzzContext | undefined;
-//# sourceMappingURL=context.d.ts.map

package/dist/fuzz/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/fuzz/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,2CAA2C;IAC3C,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAChC,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,8CAA8C;AAC9C,eAAO,MAAM,WAAW,gCAAuC,CAAA;AAE/D;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAO3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAOlF;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,SAAS,CAExD"}

package/dist/fuzz/context.js

@@ -1,43 +0,0 @@
-/**
- * Fuzz test context using AsyncLocalStorage for auto-tracking
- *
- * When running inside test.fuzz(), take() automatically records
- * yielded values for shrinking and regression testing.
- */
-import { AsyncLocalStorage } from "node:async_hooks";
-/** AsyncLocalStorage for fuzz test context */
-export const fuzzContext = new AsyncLocalStorage();
-/**
- * Create a new fuzz context
- */
-export function createFuzzContext(seed) {
-    return {
-        history: [],
-        replaySequence: null,
-        replayIndex: 0,
-        seed,
-    };
-}
-/**
- * Create a replay context from a saved sequence
- */
-export function createReplayContext(sequence, seed) {
-    return {
-        history: [],
-        replaySequence: sequence,
-        replayIndex: 0,
-        seed,
-    };
-}
-/**
- * Check if we're currently in a fuzz context
- */
-export function isInFuzzContext() {
-    return fuzzContext.getStore() !== undefined;
-}
-/**
- * Get the current fuzz context or undefined
- */
-export function getFuzzContext() {
-    return fuzzContext.getStore();
-}

package/dist/fuzz/gen.d.ts

@@ -1,70 +0,0 @@
-/**
- * Ergonomic generator API for fuzz testing
- *
- * gen(picker) creates an infinite async generator from a picker.
- * take(generator, n) limits iterations and auto-tracks in test.fuzz().
- */
-import { type SeededRandom } from "../random.js";
-/**
- * Picker context passed to picker functions
- */
-export interface PickerContext {
-    /** Seeded random number generator */
-    random: SeededRandom;
-    /** Current iteration (0-indexed) */
-    iteration: number;
-}
-/**
- * Result type for picker functions - can return single value, array, or iterable
- */
-type PickerResult<T> = T | T[] | Iterable<T>;
-/**
- * Sync picker function
- */
-type SyncPickerFn<T> = (ctx: PickerContext) => PickerResult<T>;
-/**
- * Async picker function (for AI mode)
- */
-type AsyncPickerFn<T> = (ctx: PickerContext) => Promise<PickerResult<T>>;
-/**
- * Picker types:
- * - T[] - random from array
- * - [number, T][] - weighted random (pairs of [weight, value])
- * - (ctx) => T | T[] | Iterable<T> - sync function
- * - (ctx) => Promise<T | T[] | Iterable<T>> - async function
- */
-export type Picker<T> = T[] | [number, T][] | SyncPickerFn<T> | AsyncPickerFn<T>;
-/**
- * Create an infinite async generator from a picker
- *
- * @example
- * // Random from array
- * gen(['j', 'k', 'h', 'l'])
- *
- * @example
- * // Weighted random
- * gen([[40, 'j'], [40, 'k'], [20, 'Enter']])
- *
- * @example
- * // Custom picker function
- * gen(({ random }) => random.pick(['j', 'k']))
- *
- * @example
- * // Picker returns array (flattened)
- * gen(() => ['j', 'j', 'Enter'])  // yields: j, j, Enter, j, j, Enter, ...
- */
-export declare function gen<T>(picker: Picker<T>, seed?: number): AsyncGenerator<T>;
-/**
- * Limit an async generator to n iterations
- *
- * When running inside test.fuzz(), automatically tracks yielded values
- * for shrinking and regression testing.
- *
- * @example
- * for await (const key of take(gen(['j', 'k']), 100)) {
- *   await handle.press(key)
- * }
- */
-export declare function take<T>(generator: AsyncIterable<T>, n: number): AsyncGenerator<T>;
-export {};
-//# sourceMappingURL=gen.d.ts.map

package/dist/fuzz/gen.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gen.d.ts","sourceRoot":"","sources":["../../src/fuzz/gen.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA8C,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AAG5F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,MAAM,EAAE,YAAY,CAAA;IACpB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;AAE5C;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,KAAK,YAAY,CAAC,CAAC,CAAC,CAAA;AAE9D;;GAEG;AACH,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;AAExE;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;AAmDhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAuB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAYjF;AAED;;;;;;;;;;GAUG;AACH,wBAAuB,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,CAmBxF"}

package/dist/fuzz/gen.js

@@ -1,113 +0,0 @@
-/**
- * Ergonomic generator API for fuzz testing
- *
- * gen(picker) creates an infinite async generator from a picker.
- * take(generator, n) limits iterations and auto-tracks in test.fuzz().
- */
-import { createSeededRandom, weightedPickFromTuples } from "../random.js";
-import { fuzzContext } from "./context.js";
-/**
- * Type guard for weighted tuples
- */
-function isWeightedTuple(picker) {
-    return Array.isArray(picker) && picker.length > 0 && Array.isArray(picker[0]) && typeof picker[0][0] === "number";
-}
-/**
- * Type guard for iterables (excluding strings)
- */
-function isIterable(value) {
-    return value !== null && typeof value === "object" && Symbol.iterator in value && typeof value !== "string";
-}
-/**
- * Flatten picker result: single value, array, or iterable → individual items
- */
-function* flatten(result) {
-    if (Array.isArray(result)) {
-        for (const item of result)
-            yield item;
-    }
-    else if (isIterable(result)) {
-        for (const item of result)
-            yield item;
-    }
-    else {
-        yield result;
-    }
-}
-/**
- * Create a picker function from various picker specs
- */
-function createPicker(picker, random) {
-    // Function picker - use as-is
-    if (typeof picker === "function") {
-        return picker;
-    }
-    // Weighted tuple picker
-    if (isWeightedTuple(picker)) {
-        const items = picker;
-        return () => weightedPickFromTuples(items, random.float());
-    }
-    // Array picker - random from array
-    return () => picker[Math.floor(random.float() * picker.length)];
-}
-/**
- * Create an infinite async generator from a picker
- *
- * @example
- * // Random from array
- * gen(['j', 'k', 'h', 'l'])
- *
- * @example
- * // Weighted random
- * gen([[40, 'j'], [40, 'k'], [20, 'Enter']])
- *
- * @example
- * // Custom picker function
- * gen(({ random }) => random.pick(['j', 'k']))
- *
- * @example
- * // Picker returns array (flattened)
- * gen(() => ['j', 'j', 'Enter'])  // yields: j, j, Enter, j, j, Enter, ...
- */
-export async function* gen(picker, seed) {
-    // Use context seed if available, otherwise provided seed or Date.now()
-    const ctx = fuzzContext.getStore();
-    const random = createSeededRandom(seed ?? ctx?.seed ?? Date.now());
-    const pick = createPicker(picker, random);
-    let iteration = 0;
-    while (true) {
-        const pickerCtx = { random, iteration: iteration++ };
-        const result = await pick(pickerCtx);
-        yield* flatten(result);
-    }
-}
-/**
- * Limit an async generator to n iterations
- *
- * When running inside test.fuzz(), automatically tracks yielded values
- * for shrinking and regression testing.
- *
- * @example
- * for await (const key of take(gen(['j', 'k']), 100)) {
- *   await handle.press(key)
- * }
- */
-export async function* take(generator, n) {
-    const ctx = fuzzContext.getStore();
-    let i = 0;
-    // Replay mode: yield from saved sequence instead of generator
-    if (ctx?.replaySequence) {
-        while (i < n && ctx.replayIndex < ctx.replaySequence.length) {
-            yield ctx.replaySequence[ctx.replayIndex++];
-            i++;
-        }
-        return;
-    }
-    // Normal mode: yield from generator, optionally record
-    for await (const item of generator) {
-        if (i++ >= n)
-            break;
-        ctx?.history.push(item); // Track if in fuzz context
-        yield item;
-    }
-}

package/dist/fuzz/index.d.ts

@@ -1,57 +0,0 @@
-/**
- * Fuzz testing API
- *
- * @example
- * ```typescript
- * import { test, gen, take, createSeededRandom } from 'vimonkey/fuzz'
- *
- * // Simple random from array
- * test('navigation', async () => {
- *   const handle = await run(<Board />, { cols: 80, rows: 24 })
- *   for await (const key of take(gen(['j','k','h','l']), 100)) {
- *     await handle.press(key)
- *     expect(handle.locator('[data-cursor]').count()).toBe(1)
- *   }
- * })
- *
- * // Weighted random
- * test('weighted', async () => {
- *   for await (const key of take(gen([[40,'j'], [40,'k'], [20,'Enter']]), 100)) {
- *     await handle.press(key)
- *   }
- * })
- *
- * // Stateful with closure
- * test('stateful', async () => {
- *   const handle = await app.run(<Board />)
- *   const random = createSeededRandom(Date.now())
- *
- *   const keys = async function*() {
- *     while (true) {
- *       const state = handle.store.getState()
- *       yield state.cursor === 0 ? random.pick(['j','l']) : random.pick(['j','k','h','l'])
- *     }
- *   }
- *
- *   for await (const key of take(keys(), 100)) {
- *     await handle.press(key)
- *   }
- * })
- *
- * // With auto-tracking and shrinking
- * test.fuzz('cursor invariants', async () => {
- *   for await (const key of take(gen(['j','k']), 100)) {
- *     await handle.press(key)
- *     expect(...)  // On failure: shrinks, saves to __fuzz_cases__/
- *   }
- * })
- * ```
- */
-export { gen, take, type Picker, type PickerContext } from "./gen.js";
-export { test, FuzzError, type FuzzTestOptions } from "./test-fuzz.js";
-export { describe, expect, it, beforeAll, afterAll, beforeEach, afterEach } from "./test-fuzz.js";
-export { fuzzContext, getFuzzContext, isInFuzzContext, createFuzzContext, createReplayContext, type FuzzContext, } from "./context.js";
-export { shrinkSequence, formatShrinkResult, type ShrinkOptions, type ShrinkResult } from "./shrink.js";
-export { saveCase, loadCases, loadCasesForTest, deleteCase, clearCases, getFuzzCasesDir, type SavedCase, } from "./regression.js";
-export { createSeededRandom, weightedPickFromTuples, parseSeed, parseRepeats, deriveSeeds, type SeededRandom, } from "../random.js";
-//# sourceMappingURL=index.d.ts.map