@ricsam/quickjs-test-utils 1.0.2 → 1.0.4

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/quickjs-test-utils",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "commonjs"
 }

package/dist/cjs/quickjs-types.cjs

@@ -31,6 +31,7 @@ var __export = (target, all) => {
 var exports_quickjs_types = {};
 __export(exports_quickjs_types, {
   TYPE_DEFINITIONS: () => TYPE_DEFINITIONS,
+  TEST_ENV_TYPES: () => TEST_ENV_TYPES,
   FS_TYPES: () => FS_TYPES,
   FETCH_TYPES: () => FETCH_TYPES,
   CORE_TYPES: () => CORE_TYPES
@@ -690,11 +691,293 @@ declare global {
   }
 }
 `;
+var TEST_ENV_TYPES = `/**
+ * QuickJS Global Type Definitions for @ricsam/quickjs-test-environment
+ *
+ * These types define the globals injected by setupTestEnvironment() into a QuickJS context.
+ * Use these types to typecheck user code that will run inside QuickJS.
+ *
+ * @example
+ * describe("Math operations", () => {
+ *   it("should add numbers", () => {
+ *     expect(1 + 1).toBe(2);
+ *   });
+ * });
+ */
+
+export {};
+
+declare global {
+  // ============================================
+  // Test Structure
+  // ============================================
+
+  /**
+   * Define a test suite.
+   *
+   * @param name - The name of the test suite
+   * @param fn - Function containing tests and nested suites
+   *
+   * @example
+   * describe("Calculator", () => {
+   *   it("adds numbers", () => {
+   *     expect(1 + 1).toBe(2);
+   *   });
+   * });
+   */
+  function describe(name: string, fn: () => void): void;
+
+  namespace describe {
+    /**
+     * Skip this suite and all its tests.
+     */
+    function skip(name: string, fn: () => void): void;
+
+    /**
+     * Only run this suite (and other .only suites).
+     */
+    function only(name: string, fn: () => void): void;
+
+    /**
+     * Mark suite as todo (skipped with different status).
+     */
+    function todo(name: string, fn?: () => void): void;
+  }
+
+  /**
+   * Define a test case.
+   *
+   * @param name - The name of the test
+   * @param fn - The test function (can be async)
+   *
+   * @example
+   * it("should work", () => {
+   *   expect(true).toBe(true);
+   * });
+   *
+   * it("should work async", async () => {
+   *   const result = await Promise.resolve(42);
+   *   expect(result).toBe(42);
+   * });
+   */
+  function it(name: string, fn: () => void | Promise<void>): void;
+
+  namespace it {
+    /**
+     * Skip this test.
+     */
+    function skip(name: string, fn?: () => void | Promise<void>): void;
+
+    /**
+     * Only run this test (and other .only tests).
+     */
+    function only(name: string, fn: () => void | Promise<void>): void;
+
+    /**
+     * Mark test as todo.
+     */
+    function todo(name: string, fn?: () => void | Promise<void>): void;
+  }
+
+  /**
+   * Alias for it().
+   */
+  function test(name: string, fn: () => void | Promise<void>): void;
+
+  namespace test {
+    /**
+     * Skip this test.
+     */
+    function skip(name: string, fn?: () => void | Promise<void>): void;
+
+    /**
+     * Only run this test (and other .only tests).
+     */
+    function only(name: string, fn: () => void | Promise<void>): void;
+
+    /**
+     * Mark test as todo.
+     */
+    function todo(name: string, fn?: () => void | Promise<void>): void;
+  }
+
+  // ============================================
+  // Lifecycle Hooks
+  // ============================================
+
+  /**
+   * Run once before all tests in the current suite.
+   *
+   * @param fn - Setup function (can be async)
+   */
+  function beforeAll(fn: () => void | Promise<void>): void;
+
+  /**
+   * Run once after all tests in the current suite.
+   *
+   * @param fn - Teardown function (can be async)
+   */
+  function afterAll(fn: () => void | Promise<void>): void;
+
+  /**
+   * Run before each test in the current suite (and nested suites).
+   *
+   * @param fn - Setup function (can be async)
+   */
+  function beforeEach(fn: () => void | Promise<void>): void;
+
+  /**
+   * Run after each test in the current suite (and nested suites).
+   *
+   * @param fn - Teardown function (can be async)
+   */
+  function afterEach(fn: () => void | Promise<void>): void;
+
+  // ============================================
+  // Assertions
+  // ============================================
+
+  /**
+   * Matchers for assertions.
+   */
+  interface Matchers<T> {
+    /**
+     * Strict equality (===).
+     */
+    toBe(expected: T): void;
+
+    /**
+     * Deep equality.
+     */
+    toEqual(expected: unknown): void;
+
+    /**
+     * Deep equality with type checking.
+     */
+    toStrictEqual(expected: unknown): void;
+
+    /**
+     * Check if value is truthy.
+     */
+    toBeTruthy(): void;
+
+    /**
+     * Check if value is falsy.
+     */
+    toBeFalsy(): void;
+
+    /**
+     * Check if value is null.
+     */
+    toBeNull(): void;
+
+    /**
+     * Check if value is undefined.
+     */
+    toBeUndefined(): void;
+
+    /**
+     * Check if value is defined (not undefined).
+     */
+    toBeDefined(): void;
+
+    /**
+     * Check if value is NaN.
+     */
+    toBeNaN(): void;
+
+    /**
+     * Check if number is greater than expected.
+     */
+    toBeGreaterThan(n: number): void;
+
+    /**
+     * Check if number is greater than or equal to expected.
+     */
+    toBeGreaterThanOrEqual(n: number): void;
+
+    /**
+     * Check if number is less than expected.
+     */
+    toBeLessThan(n: number): void;
+
+    /**
+     * Check if number is less than or equal to expected.
+     */
+    toBeLessThanOrEqual(n: number): void;
+
+    /**
+     * Check if array/string contains item/substring.
+     */
+    toContain(item: unknown): void;
+
+    /**
+     * Check length of array/string.
+     */
+    toHaveLength(length: number): void;
+
+    /**
+     * Check if object has property (optionally with value).
+     */
+    toHaveProperty(key: string, value?: unknown): void;
+
+    /**
+     * Check if function throws.
+     */
+    toThrow(expected?: string | RegExp | Error): void;
+
+    /**
+     * Check if string matches pattern.
+     */
+    toMatch(pattern: string | RegExp): void;
+
+    /**
+     * Check if object matches subset of properties.
+     */
+    toMatchObject(object: object): void;
+
+    /**
+     * Check if value is instance of class.
+     */
+    toBeInstanceOf(constructor: Function): void;
+
+    /**
+     * Negate the matcher.
+     */
+    not: Matchers<T>;
+
+    /**
+     * Await promise and check resolved value.
+     */
+    resolves: Matchers<Awaited<T>>;
+
+    /**
+     * Await promise and check rejection.
+     */
+    rejects: Matchers<unknown>;
+  }
+
+  /**
+   * Create an expectation for a value.
+   *
+   * @param actual - The value to test
+   * @returns Matchers for the value
+   *
+   * @example
+   * expect(1 + 1).toBe(2);
+   * expect({ a: 1 }).toEqual({ a: 1 });
+   * expect(() => { throw new Error(); }).toThrow();
+   * expect(promise).resolves.toBe(42);
+   */
+  function expect<T>(actual: T): Matchers<T>;
+}
+`;
 var TYPE_DEFINITIONS = {
   core: CORE_TYPES,
   fetch: FETCH_TYPES,
-  fs: FS_TYPES
+  fs: FS_TYPES,
+  testEnvironment: TEST_ENV_TYPES
 };
 })
 
-//# debugId=AAA1920C2BB7D8E964756E2164756E21
+//# debugId=AAD20C0C66AEFD8664756E2164756E21

package/dist/cjs/quickjs-types.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/quickjs-types.ts"],
   "sourcesContent": [
-    "/**\n * QuickJS type definitions as string constants.\n *\n * These are the canonical source for QuickJS global type definitions.\n * The .d.ts files in each package are generated from these strings during build.\n *\n * @example\n * import { TYPE_DEFINITIONS } from \"@ricsam/quickjs-test-utils\";\n *\n * // Use with ts-morph for type checking code strings\n * project.createSourceFile(\"types.d.ts\", TYPE_DEFINITIONS.fetch);\n */\n\n/**\n * Type definitions for @ricsam/quickjs-core globals.\n *\n * Includes: ReadableStream, WritableStream, TransformStream, Blob, File, URL, URLSearchParams, DOMException\n */\nexport const CORE_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-core\n *\n * These types define the globals injected by setupCore() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // In your tsconfig.quickjs.json\n * {\n *   \"compilerOptions\": {\n *     \"lib\": [\"ESNext\", \"DOM\"]\n *   }\n * }\n *\n * // Then reference this file or use ts-morph for code strings\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Web Streams API\n  // ============================================\n\n  /**\n   * A readable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream\n   */\n  const ReadableStream: typeof globalThis.ReadableStream;\n\n  /**\n   * A writable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStream\n   */\n  const WritableStream: typeof globalThis.WritableStream;\n\n  /**\n   * A transform stream that can be used to pipe data through a transformer.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/TransformStream\n   */\n  const TransformStream: typeof globalThis.TransformStream;\n\n  /**\n   * Default reader for ReadableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader\n   */\n  const ReadableStreamDefaultReader: typeof globalThis.ReadableStreamDefaultReader;\n\n  /**\n   * Default writer for WritableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStreamDefaultWriter\n   */\n  const WritableStreamDefaultWriter: typeof globalThis.WritableStreamDefaultWriter;\n\n  // ============================================\n  // Blob and File APIs\n  // ============================================\n\n  /**\n   * A file-like object of immutable, raw data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Blob\n   */\n  const Blob: typeof globalThis.Blob;\n\n  /**\n   * A file object representing a file.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/File\n   */\n  const File: typeof globalThis.File;\n\n  // ============================================\n  // URL APIs\n  // ============================================\n\n  /**\n   * Interface for URL manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URL\n   */\n  const URL: typeof globalThis.URL;\n\n  /**\n   * Utility for working with URL query strings.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams\n   */\n  const URLSearchParams: typeof globalThis.URLSearchParams;\n\n  // ============================================\n  // Error Handling\n  // ============================================\n\n  /**\n   * Exception type for DOM operations.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/DOMException\n   */\n  const DOMException: typeof globalThis.DOMException;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-fetch globals.\n *\n * Includes: Headers, Request, Response, AbortController, AbortSignal, FormData, fetch, serve, Server, ServerWebSocket\n */\nexport const FETCH_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fetch\n *\n * These types define the globals injected by setupFetch() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with serve()\n * serve({\n *   fetch(request, server) {\n *     if (request.url.includes(\"/ws\")) {\n *       server.upgrade(request, { data: { id: 123 } });\n *       return new Response(null, { status: 101 });\n *     }\n *     return new Response(\"Hello!\");\n *   },\n *   websocket: {\n *     message(ws, message) {\n *       ws.send(\"Echo: \" + message);\n *     }\n *   }\n * });\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Standard Fetch API (from lib.dom)\n  // ============================================\n\n  /**\n   * Headers class for HTTP headers manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Headers\n   */\n  const Headers: typeof globalThis.Headers;\n\n  /**\n   * Request class for HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Request\n   */\n  const Request: typeof globalThis.Request;\n\n  /**\n   * Response class for HTTP responses.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Response\n   */\n  const Response: typeof globalThis.Response;\n\n  /**\n   * AbortController for cancelling fetch requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortController\n   */\n  const AbortController: typeof globalThis.AbortController;\n\n  /**\n   * AbortSignal for listening to abort events.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal\n   */\n  const AbortSignal: typeof globalThis.AbortSignal;\n\n  /**\n   * FormData for constructing form data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/FormData\n   */\n  const FormData: typeof globalThis.FormData;\n\n  /**\n   * Fetch function for making HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/fetch\n   */\n  function fetch(\n    input: RequestInfo | URL,\n    init?: RequestInit\n  ): Promise<Response>;\n\n  // ============================================\n  // QuickJS-specific: serve() API\n  // ============================================\n\n  /**\n   * Server interface for handling WebSocket upgrades within serve() handlers.\n   */\n  interface Server {\n    /**\n     * Upgrade an HTTP request to a WebSocket connection.\n     *\n     * @param request - The incoming HTTP request to upgrade\n     * @param options - Optional data to associate with the WebSocket connection\n     * @returns true if upgrade will proceed, false otherwise\n     *\n     * @example\n     * serve({\n     *   fetch(request, server) {\n     *     if (server.upgrade(request, { data: { userId: 123 } })) {\n     *       return new Response(null, { status: 101 });\n     *     }\n     *     return new Response(\"Upgrade failed\", { status: 400 });\n     *   }\n     * });\n     */\n    upgrade(request: Request, options?: { data?: unknown }): boolean;\n  }\n\n  /**\n   * ServerWebSocket interface for WebSocket connections within serve() handlers.\n   *\n   * @typeParam T - The type of data associated with this WebSocket connection\n   */\n  interface ServerWebSocket<T = unknown> {\n    /**\n     * User data associated with this connection.\n     * Set via \\`server.upgrade(request, { data: ... })\\`.\n     */\n    readonly data: T;\n\n    /**\n     * Send a message to the client.\n     *\n     * @param message - The message to send (string, ArrayBuffer, or Uint8Array)\n     */\n    send(message: string | ArrayBuffer | Uint8Array): void;\n\n    /**\n     * Close the WebSocket connection.\n     *\n     * @param code - Optional close code (default: 1000)\n     * @param reason - Optional close reason\n     */\n    close(code?: number, reason?: string): void;\n\n    /**\n     * WebSocket ready state.\n     * - 0: CONNECTING\n     * - 1: OPEN\n     * - 2: CLOSING\n     * - 3: CLOSED\n     */\n    readonly readyState: number;\n  }\n\n  /**\n   * Options for the serve() function.\n   *\n   * @typeParam T - The type of data associated with WebSocket connections\n   */\n  interface ServeOptions<T = unknown> {\n    /**\n     * Handler for HTTP requests.\n     *\n     * @param request - The incoming HTTP request\n     * @param server - Server interface for WebSocket upgrades\n     * @returns Response or Promise resolving to Response\n     */\n    fetch(request: Request, server: Server): Response | Promise<Response>;\n\n    /**\n     * WebSocket event handlers.\n     */\n    websocket?: {\n      /**\n       * Called when a WebSocket connection is opened.\n       *\n       * @param ws - The WebSocket connection\n       */\n      open?(ws: ServerWebSocket<T>): void | Promise<void>;\n\n      /**\n       * Called when a message is received.\n       *\n       * @param ws - The WebSocket connection\n       * @param message - The received message (string or ArrayBuffer)\n       */\n      message?(\n        ws: ServerWebSocket<T>,\n        message: string | ArrayBuffer\n      ): void | Promise<void>;\n\n      /**\n       * Called when the connection is closed.\n       *\n       * @param ws - The WebSocket connection\n       * @param code - The close code\n       * @param reason - The close reason\n       */\n      close?(\n        ws: ServerWebSocket<T>,\n        code: number,\n        reason: string\n      ): void | Promise<void>;\n\n      /**\n       * Called when an error occurs.\n       *\n       * @param ws - The WebSocket connection\n       * @param error - The error that occurred\n       */\n      error?(ws: ServerWebSocket<T>, error: Error): void | Promise<void>;\n    };\n  }\n\n  /**\n   * Register an HTTP server handler in QuickJS.\n   *\n   * Only one serve() handler can be active at a time.\n   * Calling serve() again replaces the previous handler.\n   *\n   * @param options - Server configuration including fetch handler and optional WebSocket handlers\n   *\n   * @example\n   * serve({\n   *   fetch(request, server) {\n   *     const url = new URL(request.url);\n   *\n   *     if (url.pathname === \"/ws\") {\n   *       if (server.upgrade(request, { data: { connectedAt: Date.now() } })) {\n   *         return new Response(null, { status: 101 });\n   *       }\n   *     }\n   *\n   *     if (url.pathname === \"/api/hello\") {\n   *       return Response.json({ message: \"Hello!\" });\n   *     }\n   *\n   *     return new Response(\"Not Found\", { status: 404 });\n   *   },\n   *   websocket: {\n   *     open(ws) {\n   *       console.log(\"Connected at:\", ws.data.connectedAt);\n   *     },\n   *     message(ws, message) {\n   *       ws.send(\"Echo: \" + message);\n   *     },\n   *     close(ws, code, reason) {\n   *       console.log(\"Closed:\", code, reason);\n   *     }\n   *   }\n   * });\n   */\n  function serve<T = unknown>(options: ServeOptions<T>): void;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-fs globals.\n *\n * Includes: fs namespace, FileSystemHandle, FileSystemFileHandle, FileSystemDirectoryHandle, FileSystemWritableFileStream\n */\nexport const FS_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fs\n *\n * These types define the globals injected by setupFs() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with file system access\n * const root = await fs.getDirectory(\"/data\");\n * const fileHandle = await root.getFileHandle(\"config.json\");\n * const file = await fileHandle.getFile();\n * const content = await file.text();\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // fs namespace - QuickJS-specific entry point\n  // ============================================\n\n  /**\n   * File System namespace providing access to the file system.\n   * This is the QuickJS-specific entry point (differs from browser's navigator.storage.getDirectory()).\n   */\n  namespace fs {\n    /**\n     * Get a directory handle for the given path.\n     *\n     * The host controls which paths are accessible. Invalid or unauthorized\n     * paths will throw an error.\n     *\n     * @param path - The path to request from the host\n     * @returns A promise resolving to a directory handle\n     * @throws If the path is not allowed or doesn't exist\n     *\n     * @example\n     * const root = await fs.getDirectory(\"/\");\n     * const dataDir = await fs.getDirectory(\"/data\");\n     */\n    function getDirectory(path: string): Promise<FileSystemDirectoryHandle>;\n  }\n\n  // ============================================\n  // File System Access API\n  // ============================================\n\n  /**\n   * Base interface for file system handles.\n   */\n  interface FileSystemHandle {\n    /**\n     * The kind of handle: \"file\" or \"directory\".\n     */\n    readonly kind: \"file\" | \"directory\";\n\n    /**\n     * The name of the file or directory.\n     */\n    readonly name: string;\n\n    /**\n     * Compare two handles to check if they reference the same entry.\n     *\n     * @param other - Another FileSystemHandle to compare against\n     * @returns true if both handles reference the same entry\n     */\n    isSameEntry(other: FileSystemHandle): Promise<boolean>;\n  }\n\n  /**\n   * Handle for a file in the file system.\n   */\n  interface FileSystemFileHandle extends FileSystemHandle {\n    /**\n     * Always \"file\" for file handles.\n     */\n    readonly kind: \"file\";\n\n    /**\n     * Get the file contents as a File object.\n     *\n     * @returns A promise resolving to a File object\n     *\n     * @example\n     * const file = await fileHandle.getFile();\n     * const text = await file.text();\n     */\n    getFile(): Promise<File>;\n\n    /**\n     * Create a writable stream for writing to the file.\n     *\n     * @param options - Options for the writable stream\n     * @returns A promise resolving to a writable stream\n     *\n     * @example\n     * const writable = await fileHandle.createWritable();\n     * await writable.write(\"Hello, World!\");\n     * await writable.close();\n     */\n    createWritable(options?: {\n      /**\n       * If true, keeps existing file data. Otherwise, truncates the file.\n       */\n      keepExistingData?: boolean;\n    }): Promise<FileSystemWritableFileStream>;\n  }\n\n  /**\n   * Handle for a directory in the file system.\n   */\n  interface FileSystemDirectoryHandle extends FileSystemHandle {\n    /**\n     * Always \"directory\" for directory handles.\n     */\n    readonly kind: \"directory\";\n\n    /**\n     * Get a file handle within this directory.\n     *\n     * @param name - The name of the file\n     * @param options - Options for getting the file handle\n     * @returns A promise resolving to a file handle\n     * @throws If the file doesn't exist and create is not true\n     *\n     * @example\n     * const file = await dir.getFileHandle(\"data.json\");\n     * const newFile = await dir.getFileHandle(\"output.txt\", { create: true });\n     */\n    getFileHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the file if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemFileHandle>;\n\n    /**\n     * Get a subdirectory handle within this directory.\n     *\n     * @param name - The name of the subdirectory\n     * @param options - Options for getting the directory handle\n     * @returns A promise resolving to a directory handle\n     * @throws If the directory doesn't exist and create is not true\n     *\n     * @example\n     * const subdir = await dir.getDirectoryHandle(\"logs\");\n     * const newDir = await dir.getDirectoryHandle(\"cache\", { create: true });\n     */\n    getDirectoryHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the directory if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemDirectoryHandle>;\n\n    /**\n     * Remove a file or directory within this directory.\n     *\n     * @param name - The name of the entry to remove\n     * @param options - Options for removal\n     * @throws If the entry doesn't exist or cannot be removed\n     *\n     * @example\n     * await dir.removeEntry(\"old-file.txt\");\n     * await dir.removeEntry(\"old-dir\", { recursive: true });\n     */\n    removeEntry(\n      name: string,\n      options?: {\n        /**\n         * If true, removes directories recursively.\n         */\n        recursive?: boolean;\n      }\n    ): Promise<void>;\n\n    /**\n     * Resolve the path from this directory to a descendant handle.\n     *\n     * @param possibleDescendant - A handle that may be a descendant\n     * @returns An array of path segments, or null if not a descendant\n     *\n     * @example\n     * const path = await root.resolve(nestedFile);\n     * // [\"subdir\", \"file.txt\"]\n     */\n    resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;\n\n    /**\n     * Iterate over entries in this directory.\n     *\n     * @returns An async iterator of [name, handle] pairs\n     *\n     * @example\n     * for await (const [name, handle] of dir.entries()) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    entries(): AsyncIterableIterator<[string, FileSystemHandle]>;\n\n    /**\n     * Iterate over entry names in this directory.\n     *\n     * @returns An async iterator of names\n     *\n     * @example\n     * for await (const name of dir.keys()) {\n     *   console.log(name);\n     * }\n     */\n    keys(): AsyncIterableIterator<string>;\n\n    /**\n     * Iterate over handles in this directory.\n     *\n     * @returns An async iterator of handles\n     *\n     * @example\n     * for await (const handle of dir.values()) {\n     *   console.log(handle.name, handle.kind);\n     * }\n     */\n    values(): AsyncIterableIterator<FileSystemHandle>;\n\n    /**\n     * Async iterator support for directory entries.\n     *\n     * @example\n     * for await (const [name, handle] of dir) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;\n  }\n\n  /**\n   * Parameters for write operations on FileSystemWritableFileStream.\n   */\n  interface WriteParams {\n    /**\n     * The type of write operation.\n     * - \"write\": Write data at the current position or specified position\n     * - \"seek\": Move the file position\n     * - \"truncate\": Truncate the file to a specific size\n     */\n    type: \"write\" | \"seek\" | \"truncate\";\n\n    /**\n     * The data to write (for \"write\" type).\n     */\n    data?: string | ArrayBuffer | Uint8Array | Blob;\n\n    /**\n     * The position to write at or seek to.\n     */\n    position?: number;\n\n    /**\n     * The size to truncate to (for \"truncate\" type).\n     */\n    size?: number;\n  }\n\n  /**\n   * Writable stream for writing to a file.\n   * Extends WritableStream with file-specific operations.\n   */\n  interface FileSystemWritableFileStream extends WritableStream<Uint8Array> {\n    /**\n     * Write data to the file.\n     *\n     * @param data - The data to write\n     * @returns A promise that resolves when the write completes\n     *\n     * @example\n     * await writable.write(\"Hello, World!\");\n     * await writable.write(new Uint8Array([1, 2, 3]));\n     * await writable.write({ type: \"write\", data: \"text\", position: 0 });\n     */\n    write(\n      data: string | ArrayBuffer | Uint8Array | Blob | WriteParams\n    ): Promise<void>;\n\n    /**\n     * Seek to a position in the file.\n     *\n     * @param position - The byte position to seek to\n     * @returns A promise that resolves when the seek completes\n     *\n     * @example\n     * await writable.seek(0); // Seek to beginning\n     * await writable.write(\"Overwrite\");\n     */\n    seek(position: number): Promise<void>;\n\n    /**\n     * Truncate the file to a specific size.\n     *\n     * @param size - The size to truncate to\n     * @returns A promise that resolves when the truncation completes\n     *\n     * @example\n     * await writable.truncate(100); // Keep only first 100 bytes\n     */\n    truncate(size: number): Promise<void>;\n  }\n}\n`;\n\n/**\n * Map of package names to their type definitions.\n */\nexport const TYPE_DEFINITIONS = {\n  core: CORE_TYPES,\n  fetch: FETCH_TYPES,\n  fs: FS_TYPES,\n} as const;\n\n/**\n * Type for the keys of TYPE_DEFINITIONS.\n */\nexport type TypeDefinitionKey = keyof typeof TYPE_DEFINITIONS;\n"
+    "/**\n * QuickJS type definitions as string constants.\n *\n * These are the canonical source for QuickJS global type definitions.\n * The .d.ts files in each package are generated from these strings during build.\n *\n * @example\n * import { TYPE_DEFINITIONS } from \"@ricsam/quickjs-test-utils\";\n *\n * // Use with ts-morph for type checking code strings\n * project.createSourceFile(\"types.d.ts\", TYPE_DEFINITIONS.fetch);\n */\n\n/**\n * Type definitions for @ricsam/quickjs-core globals.\n *\n * Includes: ReadableStream, WritableStream, TransformStream, Blob, File, URL, URLSearchParams, DOMException\n */\nexport const CORE_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-core\n *\n * These types define the globals injected by setupCore() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // In your tsconfig.quickjs.json\n * {\n *   \"compilerOptions\": {\n *     \"lib\": [\"ESNext\", \"DOM\"]\n *   }\n * }\n *\n * // Then reference this file or use ts-morph for code strings\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Web Streams API\n  // ============================================\n\n  /**\n   * A readable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream\n   */\n  const ReadableStream: typeof globalThis.ReadableStream;\n\n  /**\n   * A writable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStream\n   */\n  const WritableStream: typeof globalThis.WritableStream;\n\n  /**\n   * A transform stream that can be used to pipe data through a transformer.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/TransformStream\n   */\n  const TransformStream: typeof globalThis.TransformStream;\n\n  /**\n   * Default reader for ReadableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader\n   */\n  const ReadableStreamDefaultReader: typeof globalThis.ReadableStreamDefaultReader;\n\n  /**\n   * Default writer for WritableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStreamDefaultWriter\n   */\n  const WritableStreamDefaultWriter: typeof globalThis.WritableStreamDefaultWriter;\n\n  // ============================================\n  // Blob and File APIs\n  // ============================================\n\n  /**\n   * A file-like object of immutable, raw data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Blob\n   */\n  const Blob: typeof globalThis.Blob;\n\n  /**\n   * A file object representing a file.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/File\n   */\n  const File: typeof globalThis.File;\n\n  // ============================================\n  // URL APIs\n  // ============================================\n\n  /**\n   * Interface for URL manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URL\n   */\n  const URL: typeof globalThis.URL;\n\n  /**\n   * Utility for working with URL query strings.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams\n   */\n  const URLSearchParams: typeof globalThis.URLSearchParams;\n\n  // ============================================\n  // Error Handling\n  // ============================================\n\n  /**\n   * Exception type for DOM operations.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/DOMException\n   */\n  const DOMException: typeof globalThis.DOMException;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-fetch globals.\n *\n * Includes: Headers, Request, Response, AbortController, AbortSignal, FormData, fetch, serve, Server, ServerWebSocket\n */\nexport const FETCH_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fetch\n *\n * These types define the globals injected by setupFetch() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with serve()\n * serve({\n *   fetch(request, server) {\n *     if (request.url.includes(\"/ws\")) {\n *       server.upgrade(request, { data: { id: 123 } });\n *       return new Response(null, { status: 101 });\n *     }\n *     return new Response(\"Hello!\");\n *   },\n *   websocket: {\n *     message(ws, message) {\n *       ws.send(\"Echo: \" + message);\n *     }\n *   }\n * });\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Standard Fetch API (from lib.dom)\n  // ============================================\n\n  /**\n   * Headers class for HTTP headers manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Headers\n   */\n  const Headers: typeof globalThis.Headers;\n\n  /**\n   * Request class for HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Request\n   */\n  const Request: typeof globalThis.Request;\n\n  /**\n   * Response class for HTTP responses.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Response\n   */\n  const Response: typeof globalThis.Response;\n\n  /**\n   * AbortController for cancelling fetch requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortController\n   */\n  const AbortController: typeof globalThis.AbortController;\n\n  /**\n   * AbortSignal for listening to abort events.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal\n   */\n  const AbortSignal: typeof globalThis.AbortSignal;\n\n  /**\n   * FormData for constructing form data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/FormData\n   */\n  const FormData: typeof globalThis.FormData;\n\n  /**\n   * Fetch function for making HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/fetch\n   */\n  function fetch(\n    input: RequestInfo | URL,\n    init?: RequestInit\n  ): Promise<Response>;\n\n  // ============================================\n  // QuickJS-specific: serve() API\n  // ============================================\n\n  /**\n   * Server interface for handling WebSocket upgrades within serve() handlers.\n   */\n  interface Server {\n    /**\n     * Upgrade an HTTP request to a WebSocket connection.\n     *\n     * @param request - The incoming HTTP request to upgrade\n     * @param options - Optional data to associate with the WebSocket connection\n     * @returns true if upgrade will proceed, false otherwise\n     *\n     * @example\n     * serve({\n     *   fetch(request, server) {\n     *     if (server.upgrade(request, { data: { userId: 123 } })) {\n     *       return new Response(null, { status: 101 });\n     *     }\n     *     return new Response(\"Upgrade failed\", { status: 400 });\n     *   }\n     * });\n     */\n    upgrade(request: Request, options?: { data?: unknown }): boolean;\n  }\n\n  /**\n   * ServerWebSocket interface for WebSocket connections within serve() handlers.\n   *\n   * @typeParam T - The type of data associated with this WebSocket connection\n   */\n  interface ServerWebSocket<T = unknown> {\n    /**\n     * User data associated with this connection.\n     * Set via \\`server.upgrade(request, { data: ... })\\`.\n     */\n    readonly data: T;\n\n    /**\n     * Send a message to the client.\n     *\n     * @param message - The message to send (string, ArrayBuffer, or Uint8Array)\n     */\n    send(message: string | ArrayBuffer | Uint8Array): void;\n\n    /**\n     * Close the WebSocket connection.\n     *\n     * @param code - Optional close code (default: 1000)\n     * @param reason - Optional close reason\n     */\n    close(code?: number, reason?: string): void;\n\n    /**\n     * WebSocket ready state.\n     * - 0: CONNECTING\n     * - 1: OPEN\n     * - 2: CLOSING\n     * - 3: CLOSED\n     */\n    readonly readyState: number;\n  }\n\n  /**\n   * Options for the serve() function.\n   *\n   * @typeParam T - The type of data associated with WebSocket connections\n   */\n  interface ServeOptions<T = unknown> {\n    /**\n     * Handler for HTTP requests.\n     *\n     * @param request - The incoming HTTP request\n     * @param server - Server interface for WebSocket upgrades\n     * @returns Response or Promise resolving to Response\n     */\n    fetch(request: Request, server: Server): Response | Promise<Response>;\n\n    /**\n     * WebSocket event handlers.\n     */\n    websocket?: {\n      /**\n       * Called when a WebSocket connection is opened.\n       *\n       * @param ws - The WebSocket connection\n       */\n      open?(ws: ServerWebSocket<T>): void | Promise<void>;\n\n      /**\n       * Called when a message is received.\n       *\n       * @param ws - The WebSocket connection\n       * @param message - The received message (string or ArrayBuffer)\n       */\n      message?(\n        ws: ServerWebSocket<T>,\n        message: string | ArrayBuffer\n      ): void | Promise<void>;\n\n      /**\n       * Called when the connection is closed.\n       *\n       * @param ws - The WebSocket connection\n       * @param code - The close code\n       * @param reason - The close reason\n       */\n      close?(\n        ws: ServerWebSocket<T>,\n        code: number,\n        reason: string\n      ): void | Promise<void>;\n\n      /**\n       * Called when an error occurs.\n       *\n       * @param ws - The WebSocket connection\n       * @param error - The error that occurred\n       */\n      error?(ws: ServerWebSocket<T>, error: Error): void | Promise<void>;\n    };\n  }\n\n  /**\n   * Register an HTTP server handler in QuickJS.\n   *\n   * Only one serve() handler can be active at a time.\n   * Calling serve() again replaces the previous handler.\n   *\n   * @param options - Server configuration including fetch handler and optional WebSocket handlers\n   *\n   * @example\n   * serve({\n   *   fetch(request, server) {\n   *     const url = new URL(request.url);\n   *\n   *     if (url.pathname === \"/ws\") {\n   *       if (server.upgrade(request, { data: { connectedAt: Date.now() } })) {\n   *         return new Response(null, { status: 101 });\n   *       }\n   *     }\n   *\n   *     if (url.pathname === \"/api/hello\") {\n   *       return Response.json({ message: \"Hello!\" });\n   *     }\n   *\n   *     return new Response(\"Not Found\", { status: 404 });\n   *   },\n   *   websocket: {\n   *     open(ws) {\n   *       console.log(\"Connected at:\", ws.data.connectedAt);\n   *     },\n   *     message(ws, message) {\n   *       ws.send(\"Echo: \" + message);\n   *     },\n   *     close(ws, code, reason) {\n   *       console.log(\"Closed:\", code, reason);\n   *     }\n   *   }\n   * });\n   */\n  function serve<T = unknown>(options: ServeOptions<T>): void;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-fs globals.\n *\n * Includes: fs namespace, FileSystemHandle, FileSystemFileHandle, FileSystemDirectoryHandle, FileSystemWritableFileStream\n */\nexport const FS_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fs\n *\n * These types define the globals injected by setupFs() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with file system access\n * const root = await fs.getDirectory(\"/data\");\n * const fileHandle = await root.getFileHandle(\"config.json\");\n * const file = await fileHandle.getFile();\n * const content = await file.text();\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // fs namespace - QuickJS-specific entry point\n  // ============================================\n\n  /**\n   * File System namespace providing access to the file system.\n   * This is the QuickJS-specific entry point (differs from browser's navigator.storage.getDirectory()).\n   */\n  namespace fs {\n    /**\n     * Get a directory handle for the given path.\n     *\n     * The host controls which paths are accessible. Invalid or unauthorized\n     * paths will throw an error.\n     *\n     * @param path - The path to request from the host\n     * @returns A promise resolving to a directory handle\n     * @throws If the path is not allowed or doesn't exist\n     *\n     * @example\n     * const root = await fs.getDirectory(\"/\");\n     * const dataDir = await fs.getDirectory(\"/data\");\n     */\n    function getDirectory(path: string): Promise<FileSystemDirectoryHandle>;\n  }\n\n  // ============================================\n  // File System Access API\n  // ============================================\n\n  /**\n   * Base interface for file system handles.\n   */\n  interface FileSystemHandle {\n    /**\n     * The kind of handle: \"file\" or \"directory\".\n     */\n    readonly kind: \"file\" | \"directory\";\n\n    /**\n     * The name of the file or directory.\n     */\n    readonly name: string;\n\n    /**\n     * Compare two handles to check if they reference the same entry.\n     *\n     * @param other - Another FileSystemHandle to compare against\n     * @returns true if both handles reference the same entry\n     */\n    isSameEntry(other: FileSystemHandle): Promise<boolean>;\n  }\n\n  /**\n   * Handle for a file in the file system.\n   */\n  interface FileSystemFileHandle extends FileSystemHandle {\n    /**\n     * Always \"file\" for file handles.\n     */\n    readonly kind: \"file\";\n\n    /**\n     * Get the file contents as a File object.\n     *\n     * @returns A promise resolving to a File object\n     *\n     * @example\n     * const file = await fileHandle.getFile();\n     * const text = await file.text();\n     */\n    getFile(): Promise<File>;\n\n    /**\n     * Create a writable stream for writing to the file.\n     *\n     * @param options - Options for the writable stream\n     * @returns A promise resolving to a writable stream\n     *\n     * @example\n     * const writable = await fileHandle.createWritable();\n     * await writable.write(\"Hello, World!\");\n     * await writable.close();\n     */\n    createWritable(options?: {\n      /**\n       * If true, keeps existing file data. Otherwise, truncates the file.\n       */\n      keepExistingData?: boolean;\n    }): Promise<FileSystemWritableFileStream>;\n  }\n\n  /**\n   * Handle for a directory in the file system.\n   */\n  interface FileSystemDirectoryHandle extends FileSystemHandle {\n    /**\n     * Always \"directory\" for directory handles.\n     */\n    readonly kind: \"directory\";\n\n    /**\n     * Get a file handle within this directory.\n     *\n     * @param name - The name of the file\n     * @param options - Options for getting the file handle\n     * @returns A promise resolving to a file handle\n     * @throws If the file doesn't exist and create is not true\n     *\n     * @example\n     * const file = await dir.getFileHandle(\"data.json\");\n     * const newFile = await dir.getFileHandle(\"output.txt\", { create: true });\n     */\n    getFileHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the file if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemFileHandle>;\n\n    /**\n     * Get a subdirectory handle within this directory.\n     *\n     * @param name - The name of the subdirectory\n     * @param options - Options for getting the directory handle\n     * @returns A promise resolving to a directory handle\n     * @throws If the directory doesn't exist and create is not true\n     *\n     * @example\n     * const subdir = await dir.getDirectoryHandle(\"logs\");\n     * const newDir = await dir.getDirectoryHandle(\"cache\", { create: true });\n     */\n    getDirectoryHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the directory if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemDirectoryHandle>;\n\n    /**\n     * Remove a file or directory within this directory.\n     *\n     * @param name - The name of the entry to remove\n     * @param options - Options for removal\n     * @throws If the entry doesn't exist or cannot be removed\n     *\n     * @example\n     * await dir.removeEntry(\"old-file.txt\");\n     * await dir.removeEntry(\"old-dir\", { recursive: true });\n     */\n    removeEntry(\n      name: string,\n      options?: {\n        /**\n         * If true, removes directories recursively.\n         */\n        recursive?: boolean;\n      }\n    ): Promise<void>;\n\n    /**\n     * Resolve the path from this directory to a descendant handle.\n     *\n     * @param possibleDescendant - A handle that may be a descendant\n     * @returns An array of path segments, or null if not a descendant\n     *\n     * @example\n     * const path = await root.resolve(nestedFile);\n     * // [\"subdir\", \"file.txt\"]\n     */\n    resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;\n\n    /**\n     * Iterate over entries in this directory.\n     *\n     * @returns An async iterator of [name, handle] pairs\n     *\n     * @example\n     * for await (const [name, handle] of dir.entries()) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    entries(): AsyncIterableIterator<[string, FileSystemHandle]>;\n\n    /**\n     * Iterate over entry names in this directory.\n     *\n     * @returns An async iterator of names\n     *\n     * @example\n     * for await (const name of dir.keys()) {\n     *   console.log(name);\n     * }\n     */\n    keys(): AsyncIterableIterator<string>;\n\n    /**\n     * Iterate over handles in this directory.\n     *\n     * @returns An async iterator of handles\n     *\n     * @example\n     * for await (const handle of dir.values()) {\n     *   console.log(handle.name, handle.kind);\n     * }\n     */\n    values(): AsyncIterableIterator<FileSystemHandle>;\n\n    /**\n     * Async iterator support for directory entries.\n     *\n     * @example\n     * for await (const [name, handle] of dir) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;\n  }\n\n  /**\n   * Parameters for write operations on FileSystemWritableFileStream.\n   */\n  interface WriteParams {\n    /**\n     * The type of write operation.\n     * - \"write\": Write data at the current position or specified position\n     * - \"seek\": Move the file position\n     * - \"truncate\": Truncate the file to a specific size\n     */\n    type: \"write\" | \"seek\" | \"truncate\";\n\n    /**\n     * The data to write (for \"write\" type).\n     */\n    data?: string | ArrayBuffer | Uint8Array | Blob;\n\n    /**\n     * The position to write at or seek to.\n     */\n    position?: number;\n\n    /**\n     * The size to truncate to (for \"truncate\" type).\n     */\n    size?: number;\n  }\n\n  /**\n   * Writable stream for writing to a file.\n   * Extends WritableStream with file-specific operations.\n   */\n  interface FileSystemWritableFileStream extends WritableStream<Uint8Array> {\n    /**\n     * Write data to the file.\n     *\n     * @param data - The data to write\n     * @returns A promise that resolves when the write completes\n     *\n     * @example\n     * await writable.write(\"Hello, World!\");\n     * await writable.write(new Uint8Array([1, 2, 3]));\n     * await writable.write({ type: \"write\", data: \"text\", position: 0 });\n     */\n    write(\n      data: string | ArrayBuffer | Uint8Array | Blob | WriteParams\n    ): Promise<void>;\n\n    /**\n     * Seek to a position in the file.\n     *\n     * @param position - The byte position to seek to\n     * @returns A promise that resolves when the seek completes\n     *\n     * @example\n     * await writable.seek(0); // Seek to beginning\n     * await writable.write(\"Overwrite\");\n     */\n    seek(position: number): Promise<void>;\n\n    /**\n     * Truncate the file to a specific size.\n     *\n     * @param size - The size to truncate to\n     * @returns A promise that resolves when the truncation completes\n     *\n     * @example\n     * await writable.truncate(100); // Keep only first 100 bytes\n     */\n    truncate(size: number): Promise<void>;\n  }\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-test-environment globals.\n *\n * Includes: describe, it, test, expect, beforeAll, afterAll, beforeEach, afterEach\n */\nexport const TEST_ENV_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-test-environment\n *\n * These types define the globals injected by setupTestEnvironment() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * describe(\"Math operations\", () => {\n *   it(\"should add numbers\", () => {\n *     expect(1 + 1).toBe(2);\n *   });\n * });\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Test Structure\n  // ============================================\n\n  /**\n   * Define a test suite.\n   *\n   * @param name - The name of the test suite\n   * @param fn - Function containing tests and nested suites\n   *\n   * @example\n   * describe(\"Calculator\", () => {\n   *   it(\"adds numbers\", () => {\n   *     expect(1 + 1).toBe(2);\n   *   });\n   * });\n   */\n  function describe(name: string, fn: () => void): void;\n\n  namespace describe {\n    /**\n     * Skip this suite and all its tests.\n     */\n    function skip(name: string, fn: () => void): void;\n\n    /**\n     * Only run this suite (and other .only suites).\n     */\n    function only(name: string, fn: () => void): void;\n\n    /**\n     * Mark suite as todo (skipped with different status).\n     */\n    function todo(name: string, fn?: () => void): void;\n  }\n\n  /**\n   * Define a test case.\n   *\n   * @param name - The name of the test\n   * @param fn - The test function (can be async)\n   *\n   * @example\n   * it(\"should work\", () => {\n   *   expect(true).toBe(true);\n   * });\n   *\n   * it(\"should work async\", async () => {\n   *   const result = await Promise.resolve(42);\n   *   expect(result).toBe(42);\n   * });\n   */\n  function it(name: string, fn: () => void | Promise<void>): void;\n\n  namespace it {\n    /**\n     * Skip this test.\n     */\n    function skip(name: string, fn?: () => void | Promise<void>): void;\n\n    /**\n     * Only run this test (and other .only tests).\n     */\n    function only(name: string, fn: () => void | Promise<void>): void;\n\n    /**\n     * Mark test as todo.\n     */\n    function todo(name: string, fn?: () => void | Promise<void>): void;\n  }\n\n  /**\n   * Alias for it().\n   */\n  function test(name: string, fn: () => void | Promise<void>): void;\n\n  namespace test {\n    /**\n     * Skip this test.\n     */\n    function skip(name: string, fn?: () => void | Promise<void>): void;\n\n    /**\n     * Only run this test (and other .only tests).\n     */\n    function only(name: string, fn: () => void | Promise<void>): void;\n\n    /**\n     * Mark test as todo.\n     */\n    function todo(name: string, fn?: () => void | Promise<void>): void;\n  }\n\n  // ============================================\n  // Lifecycle Hooks\n  // ============================================\n\n  /**\n   * Run once before all tests in the current suite.\n   *\n   * @param fn - Setup function (can be async)\n   */\n  function beforeAll(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run once after all tests in the current suite.\n   *\n   * @param fn - Teardown function (can be async)\n   */\n  function afterAll(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run before each test in the current suite (and nested suites).\n   *\n   * @param fn - Setup function (can be async)\n   */\n  function beforeEach(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run after each test in the current suite (and nested suites).\n   *\n   * @param fn - Teardown function (can be async)\n   */\n  function afterEach(fn: () => void | Promise<void>): void;\n\n  // ============================================\n  // Assertions\n  // ============================================\n\n  /**\n   * Matchers for assertions.\n   */\n  interface Matchers<T> {\n    /**\n     * Strict equality (===).\n     */\n    toBe(expected: T): void;\n\n    /**\n     * Deep equality.\n     */\n    toEqual(expected: unknown): void;\n\n    /**\n     * Deep equality with type checking.\n     */\n    toStrictEqual(expected: unknown): void;\n\n    /**\n     * Check if value is truthy.\n     */\n    toBeTruthy(): void;\n\n    /**\n     * Check if value is falsy.\n     */\n    toBeFalsy(): void;\n\n    /**\n     * Check if value is null.\n     */\n    toBeNull(): void;\n\n    /**\n     * Check if value is undefined.\n     */\n    toBeUndefined(): void;\n\n    /**\n     * Check if value is defined (not undefined).\n     */\n    toBeDefined(): void;\n\n    /**\n     * Check if value is NaN.\n     */\n    toBeNaN(): void;\n\n    /**\n     * Check if number is greater than expected.\n     */\n    toBeGreaterThan(n: number): void;\n\n    /**\n     * Check if number is greater than or equal to expected.\n     */\n    toBeGreaterThanOrEqual(n: number): void;\n\n    /**\n     * Check if number is less than expected.\n     */\n    toBeLessThan(n: number): void;\n\n    /**\n     * Check if number is less than or equal to expected.\n     */\n    toBeLessThanOrEqual(n: number): void;\n\n    /**\n     * Check if array/string contains item/substring.\n     */\n    toContain(item: unknown): void;\n\n    /**\n     * Check length of array/string.\n     */\n    toHaveLength(length: number): void;\n\n    /**\n     * Check if object has property (optionally with value).\n     */\n    toHaveProperty(key: string, value?: unknown): void;\n\n    /**\n     * Check if function throws.\n     */\n    toThrow(expected?: string | RegExp | Error): void;\n\n    /**\n     * Check if string matches pattern.\n     */\n    toMatch(pattern: string | RegExp): void;\n\n    /**\n     * Check if object matches subset of properties.\n     */\n    toMatchObject(object: object): void;\n\n    /**\n     * Check if value is instance of class.\n     */\n    toBeInstanceOf(constructor: Function): void;\n\n    /**\n     * Negate the matcher.\n     */\n    not: Matchers<T>;\n\n    /**\n     * Await promise and check resolved value.\n     */\n    resolves: Matchers<Awaited<T>>;\n\n    /**\n     * Await promise and check rejection.\n     */\n    rejects: Matchers<unknown>;\n  }\n\n  /**\n   * Create an expectation for a value.\n   *\n   * @param actual - The value to test\n   * @returns Matchers for the value\n   *\n   * @example\n   * expect(1 + 1).toBe(2);\n   * expect({ a: 1 }).toEqual({ a: 1 });\n   * expect(() => { throw new Error(); }).toThrow();\n   * expect(promise).resolves.toBe(42);\n   */\n  function expect<T>(actual: T): Matchers<T>;\n}\n`;\n\n/**\n * Map of package names to their type definitions.\n */\nexport const TYPE_DEFINITIONS = {\n  core: CORE_TYPES,\n  fetch: FETCH_TYPES,\n  fs: FS_TYPES,\n  testEnvironment: TEST_ENV_TYPES,\n} as const;\n\n/**\n * Type for the keys of TYPE_DEFINITIONS.\n */\nexport type TypeDefinitionKey = keyof typeof TYPE_DEFINITIONS;\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBO,IAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuGnB,IAAM,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwPpB,IAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+TjB,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,OAAO;AAAA,EACP,IAAI;AACN;",
-  "debugId": "AAA1920C2BB7D8E964756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBO,IAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuGnB,IAAM,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwPpB,IAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiUjB,IAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6RvB,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,iBAAiB;AACnB;",
+  "debugId": "AAD20C0C66AEFD8664756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/quickjs-test-utils",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "type": "module"
 }

package/dist/mjs/quickjs-types.mjs

@@ -654,16 +654,299 @@ declare global {
   }
 }
 `;
+var TEST_ENV_TYPES = `/**
+ * QuickJS Global Type Definitions for @ricsam/quickjs-test-environment
+ *
+ * These types define the globals injected by setupTestEnvironment() into a QuickJS context.
+ * Use these types to typecheck user code that will run inside QuickJS.
+ *
+ * @example
+ * describe("Math operations", () => {
+ *   it("should add numbers", () => {
+ *     expect(1 + 1).toBe(2);
+ *   });
+ * });
+ */
+
+export {};
+
+declare global {
+  // ============================================
+  // Test Structure
+  // ============================================
+
+  /**
+   * Define a test suite.
+   *
+   * @param name - The name of the test suite
+   * @param fn - Function containing tests and nested suites
+   *
+   * @example
+   * describe("Calculator", () => {
+   *   it("adds numbers", () => {
+   *     expect(1 + 1).toBe(2);
+   *   });
+   * });
+   */
+  function describe(name: string, fn: () => void): void;
+
+  namespace describe {
+    /**
+     * Skip this suite and all its tests.
+     */
+    function skip(name: string, fn: () => void): void;
+
+    /**
+     * Only run this suite (and other .only suites).
+     */
+    function only(name: string, fn: () => void): void;
+
+    /**
+     * Mark suite as todo (skipped with different status).
+     */
+    function todo(name: string, fn?: () => void): void;
+  }
+
+  /**
+   * Define a test case.
+   *
+   * @param name - The name of the test
+   * @param fn - The test function (can be async)
+   *
+   * @example
+   * it("should work", () => {
+   *   expect(true).toBe(true);
+   * });
+   *
+   * it("should work async", async () => {
+   *   const result = await Promise.resolve(42);
+   *   expect(result).toBe(42);
+   * });
+   */
+  function it(name: string, fn: () => void | Promise<void>): void;
+
+  namespace it {
+    /**
+     * Skip this test.
+     */
+    function skip(name: string, fn?: () => void | Promise<void>): void;
+
+    /**
+     * Only run this test (and other .only tests).
+     */
+    function only(name: string, fn: () => void | Promise<void>): void;
+
+    /**
+     * Mark test as todo.
+     */
+    function todo(name: string, fn?: () => void | Promise<void>): void;
+  }
+
+  /**
+   * Alias for it().
+   */
+  function test(name: string, fn: () => void | Promise<void>): void;
+
+  namespace test {
+    /**
+     * Skip this test.
+     */
+    function skip(name: string, fn?: () => void | Promise<void>): void;
+
+    /**
+     * Only run this test (and other .only tests).
+     */
+    function only(name: string, fn: () => void | Promise<void>): void;
+
+    /**
+     * Mark test as todo.
+     */
+    function todo(name: string, fn?: () => void | Promise<void>): void;
+  }
+
+  // ============================================
+  // Lifecycle Hooks
+  // ============================================
+
+  /**
+   * Run once before all tests in the current suite.
+   *
+   * @param fn - Setup function (can be async)
+   */
+  function beforeAll(fn: () => void | Promise<void>): void;
+
+  /**
+   * Run once after all tests in the current suite.
+   *
+   * @param fn - Teardown function (can be async)
+   */
+  function afterAll(fn: () => void | Promise<void>): void;
+
+  /**
+   * Run before each test in the current suite (and nested suites).
+   *
+   * @param fn - Setup function (can be async)
+   */
+  function beforeEach(fn: () => void | Promise<void>): void;
+
+  /**
+   * Run after each test in the current suite (and nested suites).
+   *
+   * @param fn - Teardown function (can be async)
+   */
+  function afterEach(fn: () => void | Promise<void>): void;
+
+  // ============================================
+  // Assertions
+  // ============================================
+
+  /**
+   * Matchers for assertions.
+   */
+  interface Matchers<T> {
+    /**
+     * Strict equality (===).
+     */
+    toBe(expected: T): void;
+
+    /**
+     * Deep equality.
+     */
+    toEqual(expected: unknown): void;
+
+    /**
+     * Deep equality with type checking.
+     */
+    toStrictEqual(expected: unknown): void;
+
+    /**
+     * Check if value is truthy.
+     */
+    toBeTruthy(): void;
+
+    /**
+     * Check if value is falsy.
+     */
+    toBeFalsy(): void;
+
+    /**
+     * Check if value is null.
+     */
+    toBeNull(): void;
+
+    /**
+     * Check if value is undefined.
+     */
+    toBeUndefined(): void;
+
+    /**
+     * Check if value is defined (not undefined).
+     */
+    toBeDefined(): void;
+
+    /**
+     * Check if value is NaN.
+     */
+    toBeNaN(): void;
+
+    /**
+     * Check if number is greater than expected.
+     */
+    toBeGreaterThan(n: number): void;
+
+    /**
+     * Check if number is greater than or equal to expected.
+     */
+    toBeGreaterThanOrEqual(n: number): void;
+
+    /**
+     * Check if number is less than expected.
+     */
+    toBeLessThan(n: number): void;
+
+    /**
+     * Check if number is less than or equal to expected.
+     */
+    toBeLessThanOrEqual(n: number): void;
+
+    /**
+     * Check if array/string contains item/substring.
+     */
+    toContain(item: unknown): void;
+
+    /**
+     * Check length of array/string.
+     */
+    toHaveLength(length: number): void;
+
+    /**
+     * Check if object has property (optionally with value).
+     */
+    toHaveProperty(key: string, value?: unknown): void;
+
+    /**
+     * Check if function throws.
+     */
+    toThrow(expected?: string | RegExp | Error): void;
+
+    /**
+     * Check if string matches pattern.
+     */
+    toMatch(pattern: string | RegExp): void;
+
+    /**
+     * Check if object matches subset of properties.
+     */
+    toMatchObject(object: object): void;
+
+    /**
+     * Check if value is instance of class.
+     */
+    toBeInstanceOf(constructor: Function): void;
+
+    /**
+     * Negate the matcher.
+     */
+    not: Matchers<T>;
+
+    /**
+     * Await promise and check resolved value.
+     */
+    resolves: Matchers<Awaited<T>>;
+
+    /**
+     * Await promise and check rejection.
+     */
+    rejects: Matchers<unknown>;
+  }
+
+  /**
+   * Create an expectation for a value.
+   *
+   * @param actual - The value to test
+   * @returns Matchers for the value
+   *
+   * @example
+   * expect(1 + 1).toBe(2);
+   * expect({ a: 1 }).toEqual({ a: 1 });
+   * expect(() => { throw new Error(); }).toThrow();
+   * expect(promise).resolves.toBe(42);
+   */
+  function expect<T>(actual: T): Matchers<T>;
+}
+`;
 var TYPE_DEFINITIONS = {
   core: CORE_TYPES,
   fetch: FETCH_TYPES,
-  fs: FS_TYPES
+  fs: FS_TYPES,
+  testEnvironment: TEST_ENV_TYPES
 };
 export {
   TYPE_DEFINITIONS,
+  TEST_ENV_TYPES,
   FS_TYPES,
   FETCH_TYPES,
   CORE_TYPES
 };
 
-//# debugId=DB524E5F7383894464756E2164756E21
+//# debugId=C18D1D397F119E8864756E2164756E21

package/dist/mjs/quickjs-types.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/quickjs-types.ts"],
   "sourcesContent": [
-    "/**\n * QuickJS type definitions as string constants.\n *\n * These are the canonical source for QuickJS global type definitions.\n * The .d.ts files in each package are generated from these strings during build.\n *\n * @example\n * import { TYPE_DEFINITIONS } from \"@ricsam/quickjs-test-utils\";\n *\n * // Use with ts-morph for type checking code strings\n * project.createSourceFile(\"types.d.ts\", TYPE_DEFINITIONS.fetch);\n */\n\n/**\n * Type definitions for @ricsam/quickjs-core globals.\n *\n * Includes: ReadableStream, WritableStream, TransformStream, Blob, File, URL, URLSearchParams, DOMException\n */\nexport const CORE_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-core\n *\n * These types define the globals injected by setupCore() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // In your tsconfig.quickjs.json\n * {\n *   \"compilerOptions\": {\n *     \"lib\": [\"ESNext\", \"DOM\"]\n *   }\n * }\n *\n * // Then reference this file or use ts-morph for code strings\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Web Streams API\n  // ============================================\n\n  /**\n   * A readable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream\n   */\n  const ReadableStream: typeof globalThis.ReadableStream;\n\n  /**\n   * A writable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStream\n   */\n  const WritableStream: typeof globalThis.WritableStream;\n\n  /**\n   * A transform stream that can be used to pipe data through a transformer.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/TransformStream\n   */\n  const TransformStream: typeof globalThis.TransformStream;\n\n  /**\n   * Default reader for ReadableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader\n   */\n  const ReadableStreamDefaultReader: typeof globalThis.ReadableStreamDefaultReader;\n\n  /**\n   * Default writer for WritableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStreamDefaultWriter\n   */\n  const WritableStreamDefaultWriter: typeof globalThis.WritableStreamDefaultWriter;\n\n  // ============================================\n  // Blob and File APIs\n  // ============================================\n\n  /**\n   * A file-like object of immutable, raw data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Blob\n   */\n  const Blob: typeof globalThis.Blob;\n\n  /**\n   * A file object representing a file.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/File\n   */\n  const File: typeof globalThis.File;\n\n  // ============================================\n  // URL APIs\n  // ============================================\n\n  /**\n   * Interface for URL manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URL\n   */\n  const URL: typeof globalThis.URL;\n\n  /**\n   * Utility for working with URL query strings.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams\n   */\n  const URLSearchParams: typeof globalThis.URLSearchParams;\n\n  // ============================================\n  // Error Handling\n  // ============================================\n\n  /**\n   * Exception type for DOM operations.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/DOMException\n   */\n  const DOMException: typeof globalThis.DOMException;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-fetch globals.\n *\n * Includes: Headers, Request, Response, AbortController, AbortSignal, FormData, fetch, serve, Server, ServerWebSocket\n */\nexport const FETCH_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fetch\n *\n * These types define the globals injected by setupFetch() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with serve()\n * serve({\n *   fetch(request, server) {\n *     if (request.url.includes(\"/ws\")) {\n *       server.upgrade(request, { data: { id: 123 } });\n *       return new Response(null, { status: 101 });\n *     }\n *     return new Response(\"Hello!\");\n *   },\n *   websocket: {\n *     message(ws, message) {\n *       ws.send(\"Echo: \" + message);\n *     }\n *   }\n * });\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Standard Fetch API (from lib.dom)\n  // ============================================\n\n  /**\n   * Headers class for HTTP headers manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Headers\n   */\n  const Headers: typeof globalThis.Headers;\n\n  /**\n   * Request class for HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Request\n   */\n  const Request: typeof globalThis.Request;\n\n  /**\n   * Response class for HTTP responses.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Response\n   */\n  const Response: typeof globalThis.Response;\n\n  /**\n   * AbortController for cancelling fetch requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortController\n   */\n  const AbortController: typeof globalThis.AbortController;\n\n  /**\n   * AbortSignal for listening to abort events.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal\n   */\n  const AbortSignal: typeof globalThis.AbortSignal;\n\n  /**\n   * FormData for constructing form data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/FormData\n   */\n  const FormData: typeof globalThis.FormData;\n\n  /**\n   * Fetch function for making HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/fetch\n   */\n  function fetch(\n    input: RequestInfo | URL,\n    init?: RequestInit\n  ): Promise<Response>;\n\n  // ============================================\n  // QuickJS-specific: serve() API\n  // ============================================\n\n  /**\n   * Server interface for handling WebSocket upgrades within serve() handlers.\n   */\n  interface Server {\n    /**\n     * Upgrade an HTTP request to a WebSocket connection.\n     *\n     * @param request - The incoming HTTP request to upgrade\n     * @param options - Optional data to associate with the WebSocket connection\n     * @returns true if upgrade will proceed, false otherwise\n     *\n     * @example\n     * serve({\n     *   fetch(request, server) {\n     *     if (server.upgrade(request, { data: { userId: 123 } })) {\n     *       return new Response(null, { status: 101 });\n     *     }\n     *     return new Response(\"Upgrade failed\", { status: 400 });\n     *   }\n     * });\n     */\n    upgrade(request: Request, options?: { data?: unknown }): boolean;\n  }\n\n  /**\n   * ServerWebSocket interface for WebSocket connections within serve() handlers.\n   *\n   * @typeParam T - The type of data associated with this WebSocket connection\n   */\n  interface ServerWebSocket<T = unknown> {\n    /**\n     * User data associated with this connection.\n     * Set via \\`server.upgrade(request, { data: ... })\\`.\n     */\n    readonly data: T;\n\n    /**\n     * Send a message to the client.\n     *\n     * @param message - The message to send (string, ArrayBuffer, or Uint8Array)\n     */\n    send(message: string | ArrayBuffer | Uint8Array): void;\n\n    /**\n     * Close the WebSocket connection.\n     *\n     * @param code - Optional close code (default: 1000)\n     * @param reason - Optional close reason\n     */\n    close(code?: number, reason?: string): void;\n\n    /**\n     * WebSocket ready state.\n     * - 0: CONNECTING\n     * - 1: OPEN\n     * - 2: CLOSING\n     * - 3: CLOSED\n     */\n    readonly readyState: number;\n  }\n\n  /**\n   * Options for the serve() function.\n   *\n   * @typeParam T - The type of data associated with WebSocket connections\n   */\n  interface ServeOptions<T = unknown> {\n    /**\n     * Handler for HTTP requests.\n     *\n     * @param request - The incoming HTTP request\n     * @param server - Server interface for WebSocket upgrades\n     * @returns Response or Promise resolving to Response\n     */\n    fetch(request: Request, server: Server): Response | Promise<Response>;\n\n    /**\n     * WebSocket event handlers.\n     */\n    websocket?: {\n      /**\n       * Called when a WebSocket connection is opened.\n       *\n       * @param ws - The WebSocket connection\n       */\n      open?(ws: ServerWebSocket<T>): void | Promise<void>;\n\n      /**\n       * Called when a message is received.\n       *\n       * @param ws - The WebSocket connection\n       * @param message - The received message (string or ArrayBuffer)\n       */\n      message?(\n        ws: ServerWebSocket<T>,\n        message: string | ArrayBuffer\n      ): void | Promise<void>;\n\n      /**\n       * Called when the connection is closed.\n       *\n       * @param ws - The WebSocket connection\n       * @param code - The close code\n       * @param reason - The close reason\n       */\n      close?(\n        ws: ServerWebSocket<T>,\n        code: number,\n        reason: string\n      ): void | Promise<void>;\n\n      /**\n       * Called when an error occurs.\n       *\n       * @param ws - The WebSocket connection\n       * @param error - The error that occurred\n       */\n      error?(ws: ServerWebSocket<T>, error: Error): void | Promise<void>;\n    };\n  }\n\n  /**\n   * Register an HTTP server handler in QuickJS.\n   *\n   * Only one serve() handler can be active at a time.\n   * Calling serve() again replaces the previous handler.\n   *\n   * @param options - Server configuration including fetch handler and optional WebSocket handlers\n   *\n   * @example\n   * serve({\n   *   fetch(request, server) {\n   *     const url = new URL(request.url);\n   *\n   *     if (url.pathname === \"/ws\") {\n   *       if (server.upgrade(request, { data: { connectedAt: Date.now() } })) {\n   *         return new Response(null, { status: 101 });\n   *       }\n   *     }\n   *\n   *     if (url.pathname === \"/api/hello\") {\n   *       return Response.json({ message: \"Hello!\" });\n   *     }\n   *\n   *     return new Response(\"Not Found\", { status: 404 });\n   *   },\n   *   websocket: {\n   *     open(ws) {\n   *       console.log(\"Connected at:\", ws.data.connectedAt);\n   *     },\n   *     message(ws, message) {\n   *       ws.send(\"Echo: \" + message);\n   *     },\n   *     close(ws, code, reason) {\n   *       console.log(\"Closed:\", code, reason);\n   *     }\n   *   }\n   * });\n   */\n  function serve<T = unknown>(options: ServeOptions<T>): void;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-fs globals.\n *\n * Includes: fs namespace, FileSystemHandle, FileSystemFileHandle, FileSystemDirectoryHandle, FileSystemWritableFileStream\n */\nexport const FS_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fs\n *\n * These types define the globals injected by setupFs() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with file system access\n * const root = await fs.getDirectory(\"/data\");\n * const fileHandle = await root.getFileHandle(\"config.json\");\n * const file = await fileHandle.getFile();\n * const content = await file.text();\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // fs namespace - QuickJS-specific entry point\n  // ============================================\n\n  /**\n   * File System namespace providing access to the file system.\n   * This is the QuickJS-specific entry point (differs from browser's navigator.storage.getDirectory()).\n   */\n  namespace fs {\n    /**\n     * Get a directory handle for the given path.\n     *\n     * The host controls which paths are accessible. Invalid or unauthorized\n     * paths will throw an error.\n     *\n     * @param path - The path to request from the host\n     * @returns A promise resolving to a directory handle\n     * @throws If the path is not allowed or doesn't exist\n     *\n     * @example\n     * const root = await fs.getDirectory(\"/\");\n     * const dataDir = await fs.getDirectory(\"/data\");\n     */\n    function getDirectory(path: string): Promise<FileSystemDirectoryHandle>;\n  }\n\n  // ============================================\n  // File System Access API\n  // ============================================\n\n  /**\n   * Base interface for file system handles.\n   */\n  interface FileSystemHandle {\n    /**\n     * The kind of handle: \"file\" or \"directory\".\n     */\n    readonly kind: \"file\" | \"directory\";\n\n    /**\n     * The name of the file or directory.\n     */\n    readonly name: string;\n\n    /**\n     * Compare two handles to check if they reference the same entry.\n     *\n     * @param other - Another FileSystemHandle to compare against\n     * @returns true if both handles reference the same entry\n     */\n    isSameEntry(other: FileSystemHandle): Promise<boolean>;\n  }\n\n  /**\n   * Handle for a file in the file system.\n   */\n  interface FileSystemFileHandle extends FileSystemHandle {\n    /**\n     * Always \"file\" for file handles.\n     */\n    readonly kind: \"file\";\n\n    /**\n     * Get the file contents as a File object.\n     *\n     * @returns A promise resolving to a File object\n     *\n     * @example\n     * const file = await fileHandle.getFile();\n     * const text = await file.text();\n     */\n    getFile(): Promise<File>;\n\n    /**\n     * Create a writable stream for writing to the file.\n     *\n     * @param options - Options for the writable stream\n     * @returns A promise resolving to a writable stream\n     *\n     * @example\n     * const writable = await fileHandle.createWritable();\n     * await writable.write(\"Hello, World!\");\n     * await writable.close();\n     */\n    createWritable(options?: {\n      /**\n       * If true, keeps existing file data. Otherwise, truncates the file.\n       */\n      keepExistingData?: boolean;\n    }): Promise<FileSystemWritableFileStream>;\n  }\n\n  /**\n   * Handle for a directory in the file system.\n   */\n  interface FileSystemDirectoryHandle extends FileSystemHandle {\n    /**\n     * Always \"directory\" for directory handles.\n     */\n    readonly kind: \"directory\";\n\n    /**\n     * Get a file handle within this directory.\n     *\n     * @param name - The name of the file\n     * @param options - Options for getting the file handle\n     * @returns A promise resolving to a file handle\n     * @throws If the file doesn't exist and create is not true\n     *\n     * @example\n     * const file = await dir.getFileHandle(\"data.json\");\n     * const newFile = await dir.getFileHandle(\"output.txt\", { create: true });\n     */\n    getFileHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the file if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemFileHandle>;\n\n    /**\n     * Get a subdirectory handle within this directory.\n     *\n     * @param name - The name of the subdirectory\n     * @param options - Options for getting the directory handle\n     * @returns A promise resolving to a directory handle\n     * @throws If the directory doesn't exist and create is not true\n     *\n     * @example\n     * const subdir = await dir.getDirectoryHandle(\"logs\");\n     * const newDir = await dir.getDirectoryHandle(\"cache\", { create: true });\n     */\n    getDirectoryHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the directory if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemDirectoryHandle>;\n\n    /**\n     * Remove a file or directory within this directory.\n     *\n     * @param name - The name of the entry to remove\n     * @param options - Options for removal\n     * @throws If the entry doesn't exist or cannot be removed\n     *\n     * @example\n     * await dir.removeEntry(\"old-file.txt\");\n     * await dir.removeEntry(\"old-dir\", { recursive: true });\n     */\n    removeEntry(\n      name: string,\n      options?: {\n        /**\n         * If true, removes directories recursively.\n         */\n        recursive?: boolean;\n      }\n    ): Promise<void>;\n\n    /**\n     * Resolve the path from this directory to a descendant handle.\n     *\n     * @param possibleDescendant - A handle that may be a descendant\n     * @returns An array of path segments, or null if not a descendant\n     *\n     * @example\n     * const path = await root.resolve(nestedFile);\n     * // [\"subdir\", \"file.txt\"]\n     */\n    resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;\n\n    /**\n     * Iterate over entries in this directory.\n     *\n     * @returns An async iterator of [name, handle] pairs\n     *\n     * @example\n     * for await (const [name, handle] of dir.entries()) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    entries(): AsyncIterableIterator<[string, FileSystemHandle]>;\n\n    /**\n     * Iterate over entry names in this directory.\n     *\n     * @returns An async iterator of names\n     *\n     * @example\n     * for await (const name of dir.keys()) {\n     *   console.log(name);\n     * }\n     */\n    keys(): AsyncIterableIterator<string>;\n\n    /**\n     * Iterate over handles in this directory.\n     *\n     * @returns An async iterator of handles\n     *\n     * @example\n     * for await (const handle of dir.values()) {\n     *   console.log(handle.name, handle.kind);\n     * }\n     */\n    values(): AsyncIterableIterator<FileSystemHandle>;\n\n    /**\n     * Async iterator support for directory entries.\n     *\n     * @example\n     * for await (const [name, handle] of dir) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;\n  }\n\n  /**\n   * Parameters for write operations on FileSystemWritableFileStream.\n   */\n  interface WriteParams {\n    /**\n     * The type of write operation.\n     * - \"write\": Write data at the current position or specified position\n     * - \"seek\": Move the file position\n     * - \"truncate\": Truncate the file to a specific size\n     */\n    type: \"write\" | \"seek\" | \"truncate\";\n\n    /**\n     * The data to write (for \"write\" type).\n     */\n    data?: string | ArrayBuffer | Uint8Array | Blob;\n\n    /**\n     * The position to write at or seek to.\n     */\n    position?: number;\n\n    /**\n     * The size to truncate to (for \"truncate\" type).\n     */\n    size?: number;\n  }\n\n  /**\n   * Writable stream for writing to a file.\n   * Extends WritableStream with file-specific operations.\n   */\n  interface FileSystemWritableFileStream extends WritableStream<Uint8Array> {\n    /**\n     * Write data to the file.\n     *\n     * @param data - The data to write\n     * @returns A promise that resolves when the write completes\n     *\n     * @example\n     * await writable.write(\"Hello, World!\");\n     * await writable.write(new Uint8Array([1, 2, 3]));\n     * await writable.write({ type: \"write\", data: \"text\", position: 0 });\n     */\n    write(\n      data: string | ArrayBuffer | Uint8Array | Blob | WriteParams\n    ): Promise<void>;\n\n    /**\n     * Seek to a position in the file.\n     *\n     * @param position - The byte position to seek to\n     * @returns A promise that resolves when the seek completes\n     *\n     * @example\n     * await writable.seek(0); // Seek to beginning\n     * await writable.write(\"Overwrite\");\n     */\n    seek(position: number): Promise<void>;\n\n    /**\n     * Truncate the file to a specific size.\n     *\n     * @param size - The size to truncate to\n     * @returns A promise that resolves when the truncation completes\n     *\n     * @example\n     * await writable.truncate(100); // Keep only first 100 bytes\n     */\n    truncate(size: number): Promise<void>;\n  }\n}\n`;\n\n/**\n * Map of package names to their type definitions.\n */\nexport const TYPE_DEFINITIONS = {\n  core: CORE_TYPES,\n  fetch: FETCH_TYPES,\n  fs: FS_TYPES,\n} as const;\n\n/**\n * Type for the keys of TYPE_DEFINITIONS.\n */\nexport type TypeDefinitionKey = keyof typeof TYPE_DEFINITIONS;\n"
+    "/**\n * QuickJS type definitions as string constants.\n *\n * These are the canonical source for QuickJS global type definitions.\n * The .d.ts files in each package are generated from these strings during build.\n *\n * @example\n * import { TYPE_DEFINITIONS } from \"@ricsam/quickjs-test-utils\";\n *\n * // Use with ts-morph for type checking code strings\n * project.createSourceFile(\"types.d.ts\", TYPE_DEFINITIONS.fetch);\n */\n\n/**\n * Type definitions for @ricsam/quickjs-core globals.\n *\n * Includes: ReadableStream, WritableStream, TransformStream, Blob, File, URL, URLSearchParams, DOMException\n */\nexport const CORE_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-core\n *\n * These types define the globals injected by setupCore() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // In your tsconfig.quickjs.json\n * {\n *   \"compilerOptions\": {\n *     \"lib\": [\"ESNext\", \"DOM\"]\n *   }\n * }\n *\n * // Then reference this file or use ts-morph for code strings\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Web Streams API\n  // ============================================\n\n  /**\n   * A readable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream\n   */\n  const ReadableStream: typeof globalThis.ReadableStream;\n\n  /**\n   * A writable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStream\n   */\n  const WritableStream: typeof globalThis.WritableStream;\n\n  /**\n   * A transform stream that can be used to pipe data through a transformer.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/TransformStream\n   */\n  const TransformStream: typeof globalThis.TransformStream;\n\n  /**\n   * Default reader for ReadableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader\n   */\n  const ReadableStreamDefaultReader: typeof globalThis.ReadableStreamDefaultReader;\n\n  /**\n   * Default writer for WritableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStreamDefaultWriter\n   */\n  const WritableStreamDefaultWriter: typeof globalThis.WritableStreamDefaultWriter;\n\n  // ============================================\n  // Blob and File APIs\n  // ============================================\n\n  /**\n   * A file-like object of immutable, raw data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Blob\n   */\n  const Blob: typeof globalThis.Blob;\n\n  /**\n   * A file object representing a file.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/File\n   */\n  const File: typeof globalThis.File;\n\n  // ============================================\n  // URL APIs\n  // ============================================\n\n  /**\n   * Interface for URL manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URL\n   */\n  const URL: typeof globalThis.URL;\n\n  /**\n   * Utility for working with URL query strings.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams\n   */\n  const URLSearchParams: typeof globalThis.URLSearchParams;\n\n  // ============================================\n  // Error Handling\n  // ============================================\n\n  /**\n   * Exception type for DOM operations.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/DOMException\n   */\n  const DOMException: typeof globalThis.DOMException;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-fetch globals.\n *\n * Includes: Headers, Request, Response, AbortController, AbortSignal, FormData, fetch, serve, Server, ServerWebSocket\n */\nexport const FETCH_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fetch\n *\n * These types define the globals injected by setupFetch() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with serve()\n * serve({\n *   fetch(request, server) {\n *     if (request.url.includes(\"/ws\")) {\n *       server.upgrade(request, { data: { id: 123 } });\n *       return new Response(null, { status: 101 });\n *     }\n *     return new Response(\"Hello!\");\n *   },\n *   websocket: {\n *     message(ws, message) {\n *       ws.send(\"Echo: \" + message);\n *     }\n *   }\n * });\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Standard Fetch API (from lib.dom)\n  // ============================================\n\n  /**\n   * Headers class for HTTP headers manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Headers\n   */\n  const Headers: typeof globalThis.Headers;\n\n  /**\n   * Request class for HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Request\n   */\n  const Request: typeof globalThis.Request;\n\n  /**\n   * Response class for HTTP responses.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Response\n   */\n  const Response: typeof globalThis.Response;\n\n  /**\n   * AbortController for cancelling fetch requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortController\n   */\n  const AbortController: typeof globalThis.AbortController;\n\n  /**\n   * AbortSignal for listening to abort events.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal\n   */\n  const AbortSignal: typeof globalThis.AbortSignal;\n\n  /**\n   * FormData for constructing form data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/FormData\n   */\n  const FormData: typeof globalThis.FormData;\n\n  /**\n   * Fetch function for making HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/fetch\n   */\n  function fetch(\n    input: RequestInfo | URL,\n    init?: RequestInit\n  ): Promise<Response>;\n\n  // ============================================\n  // QuickJS-specific: serve() API\n  // ============================================\n\n  /**\n   * Server interface for handling WebSocket upgrades within serve() handlers.\n   */\n  interface Server {\n    /**\n     * Upgrade an HTTP request to a WebSocket connection.\n     *\n     * @param request - The incoming HTTP request to upgrade\n     * @param options - Optional data to associate with the WebSocket connection\n     * @returns true if upgrade will proceed, false otherwise\n     *\n     * @example\n     * serve({\n     *   fetch(request, server) {\n     *     if (server.upgrade(request, { data: { userId: 123 } })) {\n     *       return new Response(null, { status: 101 });\n     *     }\n     *     return new Response(\"Upgrade failed\", { status: 400 });\n     *   }\n     * });\n     */\n    upgrade(request: Request, options?: { data?: unknown }): boolean;\n  }\n\n  /**\n   * ServerWebSocket interface for WebSocket connections within serve() handlers.\n   *\n   * @typeParam T - The type of data associated with this WebSocket connection\n   */\n  interface ServerWebSocket<T = unknown> {\n    /**\n     * User data associated with this connection.\n     * Set via \\`server.upgrade(request, { data: ... })\\`.\n     */\n    readonly data: T;\n\n    /**\n     * Send a message to the client.\n     *\n     * @param message - The message to send (string, ArrayBuffer, or Uint8Array)\n     */\n    send(message: string | ArrayBuffer | Uint8Array): void;\n\n    /**\n     * Close the WebSocket connection.\n     *\n     * @param code - Optional close code (default: 1000)\n     * @param reason - Optional close reason\n     */\n    close(code?: number, reason?: string): void;\n\n    /**\n     * WebSocket ready state.\n     * - 0: CONNECTING\n     * - 1: OPEN\n     * - 2: CLOSING\n     * - 3: CLOSED\n     */\n    readonly readyState: number;\n  }\n\n  /**\n   * Options for the serve() function.\n   *\n   * @typeParam T - The type of data associated with WebSocket connections\n   */\n  interface ServeOptions<T = unknown> {\n    /**\n     * Handler for HTTP requests.\n     *\n     * @param request - The incoming HTTP request\n     * @param server - Server interface for WebSocket upgrades\n     * @returns Response or Promise resolving to Response\n     */\n    fetch(request: Request, server: Server): Response | Promise<Response>;\n\n    /**\n     * WebSocket event handlers.\n     */\n    websocket?: {\n      /**\n       * Called when a WebSocket connection is opened.\n       *\n       * @param ws - The WebSocket connection\n       */\n      open?(ws: ServerWebSocket<T>): void | Promise<void>;\n\n      /**\n       * Called when a message is received.\n       *\n       * @param ws - The WebSocket connection\n       * @param message - The received message (string or ArrayBuffer)\n       */\n      message?(\n        ws: ServerWebSocket<T>,\n        message: string | ArrayBuffer\n      ): void | Promise<void>;\n\n      /**\n       * Called when the connection is closed.\n       *\n       * @param ws - The WebSocket connection\n       * @param code - The close code\n       * @param reason - The close reason\n       */\n      close?(\n        ws: ServerWebSocket<T>,\n        code: number,\n        reason: string\n      ): void | Promise<void>;\n\n      /**\n       * Called when an error occurs.\n       *\n       * @param ws - The WebSocket connection\n       * @param error - The error that occurred\n       */\n      error?(ws: ServerWebSocket<T>, error: Error): void | Promise<void>;\n    };\n  }\n\n  /**\n   * Register an HTTP server handler in QuickJS.\n   *\n   * Only one serve() handler can be active at a time.\n   * Calling serve() again replaces the previous handler.\n   *\n   * @param options - Server configuration including fetch handler and optional WebSocket handlers\n   *\n   * @example\n   * serve({\n   *   fetch(request, server) {\n   *     const url = new URL(request.url);\n   *\n   *     if (url.pathname === \"/ws\") {\n   *       if (server.upgrade(request, { data: { connectedAt: Date.now() } })) {\n   *         return new Response(null, { status: 101 });\n   *       }\n   *     }\n   *\n   *     if (url.pathname === \"/api/hello\") {\n   *       return Response.json({ message: \"Hello!\" });\n   *     }\n   *\n   *     return new Response(\"Not Found\", { status: 404 });\n   *   },\n   *   websocket: {\n   *     open(ws) {\n   *       console.log(\"Connected at:\", ws.data.connectedAt);\n   *     },\n   *     message(ws, message) {\n   *       ws.send(\"Echo: \" + message);\n   *     },\n   *     close(ws, code, reason) {\n   *       console.log(\"Closed:\", code, reason);\n   *     }\n   *   }\n   * });\n   */\n  function serve<T = unknown>(options: ServeOptions<T>): void;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-fs globals.\n *\n * Includes: fs namespace, FileSystemHandle, FileSystemFileHandle, FileSystemDirectoryHandle, FileSystemWritableFileStream\n */\nexport const FS_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fs\n *\n * These types define the globals injected by setupFs() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with file system access\n * const root = await fs.getDirectory(\"/data\");\n * const fileHandle = await root.getFileHandle(\"config.json\");\n * const file = await fileHandle.getFile();\n * const content = await file.text();\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // fs namespace - QuickJS-specific entry point\n  // ============================================\n\n  /**\n   * File System namespace providing access to the file system.\n   * This is the QuickJS-specific entry point (differs from browser's navigator.storage.getDirectory()).\n   */\n  namespace fs {\n    /**\n     * Get a directory handle for the given path.\n     *\n     * The host controls which paths are accessible. Invalid or unauthorized\n     * paths will throw an error.\n     *\n     * @param path - The path to request from the host\n     * @returns A promise resolving to a directory handle\n     * @throws If the path is not allowed or doesn't exist\n     *\n     * @example\n     * const root = await fs.getDirectory(\"/\");\n     * const dataDir = await fs.getDirectory(\"/data\");\n     */\n    function getDirectory(path: string): Promise<FileSystemDirectoryHandle>;\n  }\n\n  // ============================================\n  // File System Access API\n  // ============================================\n\n  /**\n   * Base interface for file system handles.\n   */\n  interface FileSystemHandle {\n    /**\n     * The kind of handle: \"file\" or \"directory\".\n     */\n    readonly kind: \"file\" | \"directory\";\n\n    /**\n     * The name of the file or directory.\n     */\n    readonly name: string;\n\n    /**\n     * Compare two handles to check if they reference the same entry.\n     *\n     * @param other - Another FileSystemHandle to compare against\n     * @returns true if both handles reference the same entry\n     */\n    isSameEntry(other: FileSystemHandle): Promise<boolean>;\n  }\n\n  /**\n   * Handle for a file in the file system.\n   */\n  interface FileSystemFileHandle extends FileSystemHandle {\n    /**\n     * Always \"file\" for file handles.\n     */\n    readonly kind: \"file\";\n\n    /**\n     * Get the file contents as a File object.\n     *\n     * @returns A promise resolving to a File object\n     *\n     * @example\n     * const file = await fileHandle.getFile();\n     * const text = await file.text();\n     */\n    getFile(): Promise<File>;\n\n    /**\n     * Create a writable stream for writing to the file.\n     *\n     * @param options - Options for the writable stream\n     * @returns A promise resolving to a writable stream\n     *\n     * @example\n     * const writable = await fileHandle.createWritable();\n     * await writable.write(\"Hello, World!\");\n     * await writable.close();\n     */\n    createWritable(options?: {\n      /**\n       * If true, keeps existing file data. Otherwise, truncates the file.\n       */\n      keepExistingData?: boolean;\n    }): Promise<FileSystemWritableFileStream>;\n  }\n\n  /**\n   * Handle for a directory in the file system.\n   */\n  interface FileSystemDirectoryHandle extends FileSystemHandle {\n    /**\n     * Always \"directory\" for directory handles.\n     */\n    readonly kind: \"directory\";\n\n    /**\n     * Get a file handle within this directory.\n     *\n     * @param name - The name of the file\n     * @param options - Options for getting the file handle\n     * @returns A promise resolving to a file handle\n     * @throws If the file doesn't exist and create is not true\n     *\n     * @example\n     * const file = await dir.getFileHandle(\"data.json\");\n     * const newFile = await dir.getFileHandle(\"output.txt\", { create: true });\n     */\n    getFileHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the file if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemFileHandle>;\n\n    /**\n     * Get a subdirectory handle within this directory.\n     *\n     * @param name - The name of the subdirectory\n     * @param options - Options for getting the directory handle\n     * @returns A promise resolving to a directory handle\n     * @throws If the directory doesn't exist and create is not true\n     *\n     * @example\n     * const subdir = await dir.getDirectoryHandle(\"logs\");\n     * const newDir = await dir.getDirectoryHandle(\"cache\", { create: true });\n     */\n    getDirectoryHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the directory if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemDirectoryHandle>;\n\n    /**\n     * Remove a file or directory within this directory.\n     *\n     * @param name - The name of the entry to remove\n     * @param options - Options for removal\n     * @throws If the entry doesn't exist or cannot be removed\n     *\n     * @example\n     * await dir.removeEntry(\"old-file.txt\");\n     * await dir.removeEntry(\"old-dir\", { recursive: true });\n     */\n    removeEntry(\n      name: string,\n      options?: {\n        /**\n         * If true, removes directories recursively.\n         */\n        recursive?: boolean;\n      }\n    ): Promise<void>;\n\n    /**\n     * Resolve the path from this directory to a descendant handle.\n     *\n     * @param possibleDescendant - A handle that may be a descendant\n     * @returns An array of path segments, or null if not a descendant\n     *\n     * @example\n     * const path = await root.resolve(nestedFile);\n     * // [\"subdir\", \"file.txt\"]\n     */\n    resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;\n\n    /**\n     * Iterate over entries in this directory.\n     *\n     * @returns An async iterator of [name, handle] pairs\n     *\n     * @example\n     * for await (const [name, handle] of dir.entries()) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    entries(): AsyncIterableIterator<[string, FileSystemHandle]>;\n\n    /**\n     * Iterate over entry names in this directory.\n     *\n     * @returns An async iterator of names\n     *\n     * @example\n     * for await (const name of dir.keys()) {\n     *   console.log(name);\n     * }\n     */\n    keys(): AsyncIterableIterator<string>;\n\n    /**\n     * Iterate over handles in this directory.\n     *\n     * @returns An async iterator of handles\n     *\n     * @example\n     * for await (const handle of dir.values()) {\n     *   console.log(handle.name, handle.kind);\n     * }\n     */\n    values(): AsyncIterableIterator<FileSystemHandle>;\n\n    /**\n     * Async iterator support for directory entries.\n     *\n     * @example\n     * for await (const [name, handle] of dir) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;\n  }\n\n  /**\n   * Parameters for write operations on FileSystemWritableFileStream.\n   */\n  interface WriteParams {\n    /**\n     * The type of write operation.\n     * - \"write\": Write data at the current position or specified position\n     * - \"seek\": Move the file position\n     * - \"truncate\": Truncate the file to a specific size\n     */\n    type: \"write\" | \"seek\" | \"truncate\";\n\n    /**\n     * The data to write (for \"write\" type).\n     */\n    data?: string | ArrayBuffer | Uint8Array | Blob;\n\n    /**\n     * The position to write at or seek to.\n     */\n    position?: number;\n\n    /**\n     * The size to truncate to (for \"truncate\" type).\n     */\n    size?: number;\n  }\n\n  /**\n   * Writable stream for writing to a file.\n   * Extends WritableStream with file-specific operations.\n   */\n  interface FileSystemWritableFileStream extends WritableStream<Uint8Array> {\n    /**\n     * Write data to the file.\n     *\n     * @param data - The data to write\n     * @returns A promise that resolves when the write completes\n     *\n     * @example\n     * await writable.write(\"Hello, World!\");\n     * await writable.write(new Uint8Array([1, 2, 3]));\n     * await writable.write({ type: \"write\", data: \"text\", position: 0 });\n     */\n    write(\n      data: string | ArrayBuffer | Uint8Array | Blob | WriteParams\n    ): Promise<void>;\n\n    /**\n     * Seek to a position in the file.\n     *\n     * @param position - The byte position to seek to\n     * @returns A promise that resolves when the seek completes\n     *\n     * @example\n     * await writable.seek(0); // Seek to beginning\n     * await writable.write(\"Overwrite\");\n     */\n    seek(position: number): Promise<void>;\n\n    /**\n     * Truncate the file to a specific size.\n     *\n     * @param size - The size to truncate to\n     * @returns A promise that resolves when the truncation completes\n     *\n     * @example\n     * await writable.truncate(100); // Keep only first 100 bytes\n     */\n    truncate(size: number): Promise<void>;\n  }\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-test-environment globals.\n *\n * Includes: describe, it, test, expect, beforeAll, afterAll, beforeEach, afterEach\n */\nexport const TEST_ENV_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-test-environment\n *\n * These types define the globals injected by setupTestEnvironment() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * describe(\"Math operations\", () => {\n *   it(\"should add numbers\", () => {\n *     expect(1 + 1).toBe(2);\n *   });\n * });\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Test Structure\n  // ============================================\n\n  /**\n   * Define a test suite.\n   *\n   * @param name - The name of the test suite\n   * @param fn - Function containing tests and nested suites\n   *\n   * @example\n   * describe(\"Calculator\", () => {\n   *   it(\"adds numbers\", () => {\n   *     expect(1 + 1).toBe(2);\n   *   });\n   * });\n   */\n  function describe(name: string, fn: () => void): void;\n\n  namespace describe {\n    /**\n     * Skip this suite and all its tests.\n     */\n    function skip(name: string, fn: () => void): void;\n\n    /**\n     * Only run this suite (and other .only suites).\n     */\n    function only(name: string, fn: () => void): void;\n\n    /**\n     * Mark suite as todo (skipped with different status).\n     */\n    function todo(name: string, fn?: () => void): void;\n  }\n\n  /**\n   * Define a test case.\n   *\n   * @param name - The name of the test\n   * @param fn - The test function (can be async)\n   *\n   * @example\n   * it(\"should work\", () => {\n   *   expect(true).toBe(true);\n   * });\n   *\n   * it(\"should work async\", async () => {\n   *   const result = await Promise.resolve(42);\n   *   expect(result).toBe(42);\n   * });\n   */\n  function it(name: string, fn: () => void | Promise<void>): void;\n\n  namespace it {\n    /**\n     * Skip this test.\n     */\n    function skip(name: string, fn?: () => void | Promise<void>): void;\n\n    /**\n     * Only run this test (and other .only tests).\n     */\n    function only(name: string, fn: () => void | Promise<void>): void;\n\n    /**\n     * Mark test as todo.\n     */\n    function todo(name: string, fn?: () => void | Promise<void>): void;\n  }\n\n  /**\n   * Alias for it().\n   */\n  function test(name: string, fn: () => void | Promise<void>): void;\n\n  namespace test {\n    /**\n     * Skip this test.\n     */\n    function skip(name: string, fn?: () => void | Promise<void>): void;\n\n    /**\n     * Only run this test (and other .only tests).\n     */\n    function only(name: string, fn: () => void | Promise<void>): void;\n\n    /**\n     * Mark test as todo.\n     */\n    function todo(name: string, fn?: () => void | Promise<void>): void;\n  }\n\n  // ============================================\n  // Lifecycle Hooks\n  // ============================================\n\n  /**\n   * Run once before all tests in the current suite.\n   *\n   * @param fn - Setup function (can be async)\n   */\n  function beforeAll(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run once after all tests in the current suite.\n   *\n   * @param fn - Teardown function (can be async)\n   */\n  function afterAll(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run before each test in the current suite (and nested suites).\n   *\n   * @param fn - Setup function (can be async)\n   */\n  function beforeEach(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run after each test in the current suite (and nested suites).\n   *\n   * @param fn - Teardown function (can be async)\n   */\n  function afterEach(fn: () => void | Promise<void>): void;\n\n  // ============================================\n  // Assertions\n  // ============================================\n\n  /**\n   * Matchers for assertions.\n   */\n  interface Matchers<T> {\n    /**\n     * Strict equality (===).\n     */\n    toBe(expected: T): void;\n\n    /**\n     * Deep equality.\n     */\n    toEqual(expected: unknown): void;\n\n    /**\n     * Deep equality with type checking.\n     */\n    toStrictEqual(expected: unknown): void;\n\n    /**\n     * Check if value is truthy.\n     */\n    toBeTruthy(): void;\n\n    /**\n     * Check if value is falsy.\n     */\n    toBeFalsy(): void;\n\n    /**\n     * Check if value is null.\n     */\n    toBeNull(): void;\n\n    /**\n     * Check if value is undefined.\n     */\n    toBeUndefined(): void;\n\n    /**\n     * Check if value is defined (not undefined).\n     */\n    toBeDefined(): void;\n\n    /**\n     * Check if value is NaN.\n     */\n    toBeNaN(): void;\n\n    /**\n     * Check if number is greater than expected.\n     */\n    toBeGreaterThan(n: number): void;\n\n    /**\n     * Check if number is greater than or equal to expected.\n     */\n    toBeGreaterThanOrEqual(n: number): void;\n\n    /**\n     * Check if number is less than expected.\n     */\n    toBeLessThan(n: number): void;\n\n    /**\n     * Check if number is less than or equal to expected.\n     */\n    toBeLessThanOrEqual(n: number): void;\n\n    /**\n     * Check if array/string contains item/substring.\n     */\n    toContain(item: unknown): void;\n\n    /**\n     * Check length of array/string.\n     */\n    toHaveLength(length: number): void;\n\n    /**\n     * Check if object has property (optionally with value).\n     */\n    toHaveProperty(key: string, value?: unknown): void;\n\n    /**\n     * Check if function throws.\n     */\n    toThrow(expected?: string | RegExp | Error): void;\n\n    /**\n     * Check if string matches pattern.\n     */\n    toMatch(pattern: string | RegExp): void;\n\n    /**\n     * Check if object matches subset of properties.\n     */\n    toMatchObject(object: object): void;\n\n    /**\n     * Check if value is instance of class.\n     */\n    toBeInstanceOf(constructor: Function): void;\n\n    /**\n     * Negate the matcher.\n     */\n    not: Matchers<T>;\n\n    /**\n     * Await promise and check resolved value.\n     */\n    resolves: Matchers<Awaited<T>>;\n\n    /**\n     * Await promise and check rejection.\n     */\n    rejects: Matchers<unknown>;\n  }\n\n  /**\n   * Create an expectation for a value.\n   *\n   * @param actual - The value to test\n   * @returns Matchers for the value\n   *\n   * @example\n   * expect(1 + 1).toBe(2);\n   * expect({ a: 1 }).toEqual({ a: 1 });\n   * expect(() => { throw new Error(); }).toThrow();\n   * expect(promise).resolves.toBe(42);\n   */\n  function expect<T>(actual: T): Matchers<T>;\n}\n`;\n\n/**\n * Map of package names to their type definitions.\n */\nexport const TYPE_DEFINITIONS = {\n  core: CORE_TYPES,\n  fetch: FETCH_TYPES,\n  fs: FS_TYPES,\n  testEnvironment: TEST_ENV_TYPES,\n} as const;\n\n/**\n * Type for the keys of TYPE_DEFINITIONS.\n */\nexport type TypeDefinitionKey = keyof typeof TYPE_DEFINITIONS;\n"
   ],
-  "mappings": ";;AAkBO,IAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuGnB,IAAM,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwPpB,IAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+TjB,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,OAAO;AAAA,EACP,IAAI;AACN;",
-  "debugId": "DB524E5F7383894464756E2164756E21",
+  "mappings": ";;AAkBO,IAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuGnB,IAAM,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwPpB,IAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiUjB,IAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6RvB,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,iBAAiB;AACnB;",
+  "debugId": "C18D1D397F119E8864756E2164756E21",
   "names": []
 }

package/dist/types/quickjs-types.d.ts

@@ -28,6 +28,12 @@ export declare const FETCH_TYPES = "/**\n * QuickJS Global Type Definitions for
  * Includes: fs namespace, FileSystemHandle, FileSystemFileHandle, FileSystemDirectoryHandle, FileSystemWritableFileStream
  */
 export declare const FS_TYPES = "/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fs\n *\n * These types define the globals injected by setupFs() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with file system access\n * const root = await fs.getDirectory(\"/data\");\n * const fileHandle = await root.getFileHandle(\"config.json\");\n * const file = await fileHandle.getFile();\n * const content = await file.text();\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // fs namespace - QuickJS-specific entry point\n  // ============================================\n\n  /**\n   * File System namespace providing access to the file system.\n   * This is the QuickJS-specific entry point (differs from browser's navigator.storage.getDirectory()).\n   */\n  namespace fs {\n    /**\n     * Get a directory handle for the given path.\n     *\n     * The host controls which paths are accessible. Invalid or unauthorized\n     * paths will throw an error.\n     *\n     * @param path - The path to request from the host\n     * @returns A promise resolving to a directory handle\n     * @throws If the path is not allowed or doesn't exist\n     *\n     * @example\n     * const root = await fs.getDirectory(\"/\");\n     * const dataDir = await fs.getDirectory(\"/data\");\n     */\n    function getDirectory(path: string): Promise<FileSystemDirectoryHandle>;\n  }\n\n  // ============================================\n  // File System Access API\n  // ============================================\n\n  /**\n   * Base interface for file system handles.\n   */\n  interface FileSystemHandle {\n    /**\n     * The kind of handle: \"file\" or \"directory\".\n     */\n    readonly kind: \"file\" | \"directory\";\n\n    /**\n     * The name of the file or directory.\n     */\n    readonly name: string;\n\n    /**\n     * Compare two handles to check if they reference the same entry.\n     *\n     * @param other - Another FileSystemHandle to compare against\n     * @returns true if both handles reference the same entry\n     */\n    isSameEntry(other: FileSystemHandle): Promise<boolean>;\n  }\n\n  /**\n   * Handle for a file in the file system.\n   */\n  interface FileSystemFileHandle extends FileSystemHandle {\n    /**\n     * Always \"file\" for file handles.\n     */\n    readonly kind: \"file\";\n\n    /**\n     * Get the file contents as a File object.\n     *\n     * @returns A promise resolving to a File object\n     *\n     * @example\n     * const file = await fileHandle.getFile();\n     * const text = await file.text();\n     */\n    getFile(): Promise<File>;\n\n    /**\n     * Create a writable stream for writing to the file.\n     *\n     * @param options - Options for the writable stream\n     * @returns A promise resolving to a writable stream\n     *\n     * @example\n     * const writable = await fileHandle.createWritable();\n     * await writable.write(\"Hello, World!\");\n     * await writable.close();\n     */\n    createWritable(options?: {\n      /**\n       * If true, keeps existing file data. Otherwise, truncates the file.\n       */\n      keepExistingData?: boolean;\n    }): Promise<FileSystemWritableFileStream>;\n  }\n\n  /**\n   * Handle for a directory in the file system.\n   */\n  interface FileSystemDirectoryHandle extends FileSystemHandle {\n    /**\n     * Always \"directory\" for directory handles.\n     */\n    readonly kind: \"directory\";\n\n    /**\n     * Get a file handle within this directory.\n     *\n     * @param name - The name of the file\n     * @param options - Options for getting the file handle\n     * @returns A promise resolving to a file handle\n     * @throws If the file doesn't exist and create is not true\n     *\n     * @example\n     * const file = await dir.getFileHandle(\"data.json\");\n     * const newFile = await dir.getFileHandle(\"output.txt\", { create: true });\n     */\n    getFileHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the file if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemFileHandle>;\n\n    /**\n     * Get a subdirectory handle within this directory.\n     *\n     * @param name - The name of the subdirectory\n     * @param options - Options for getting the directory handle\n     * @returns A promise resolving to a directory handle\n     * @throws If the directory doesn't exist and create is not true\n     *\n     * @example\n     * const subdir = await dir.getDirectoryHandle(\"logs\");\n     * const newDir = await dir.getDirectoryHandle(\"cache\", { create: true });\n     */\n    getDirectoryHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the directory if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemDirectoryHandle>;\n\n    /**\n     * Remove a file or directory within this directory.\n     *\n     * @param name - The name of the entry to remove\n     * @param options - Options for removal\n     * @throws If the entry doesn't exist or cannot be removed\n     *\n     * @example\n     * await dir.removeEntry(\"old-file.txt\");\n     * await dir.removeEntry(\"old-dir\", { recursive: true });\n     */\n    removeEntry(\n      name: string,\n      options?: {\n        /**\n         * If true, removes directories recursively.\n         */\n        recursive?: boolean;\n      }\n    ): Promise<void>;\n\n    /**\n     * Resolve the path from this directory to a descendant handle.\n     *\n     * @param possibleDescendant - A handle that may be a descendant\n     * @returns An array of path segments, or null if not a descendant\n     *\n     * @example\n     * const path = await root.resolve(nestedFile);\n     * // [\"subdir\", \"file.txt\"]\n     */\n    resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;\n\n    /**\n     * Iterate over entries in this directory.\n     *\n     * @returns An async iterator of [name, handle] pairs\n     *\n     * @example\n     * for await (const [name, handle] of dir.entries()) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    entries(): AsyncIterableIterator<[string, FileSystemHandle]>;\n\n    /**\n     * Iterate over entry names in this directory.\n     *\n     * @returns An async iterator of names\n     *\n     * @example\n     * for await (const name of dir.keys()) {\n     *   console.log(name);\n     * }\n     */\n    keys(): AsyncIterableIterator<string>;\n\n    /**\n     * Iterate over handles in this directory.\n     *\n     * @returns An async iterator of handles\n     *\n     * @example\n     * for await (const handle of dir.values()) {\n     *   console.log(handle.name, handle.kind);\n     * }\n     */\n    values(): AsyncIterableIterator<FileSystemHandle>;\n\n    /**\n     * Async iterator support for directory entries.\n     *\n     * @example\n     * for await (const [name, handle] of dir) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;\n  }\n\n  /**\n   * Parameters for write operations on FileSystemWritableFileStream.\n   */\n  interface WriteParams {\n    /**\n     * The type of write operation.\n     * - \"write\": Write data at the current position or specified position\n     * - \"seek\": Move the file position\n     * - \"truncate\": Truncate the file to a specific size\n     */\n    type: \"write\" | \"seek\" | \"truncate\";\n\n    /**\n     * The data to write (for \"write\" type).\n     */\n    data?: string | ArrayBuffer | Uint8Array | Blob;\n\n    /**\n     * The position to write at or seek to.\n     */\n    position?: number;\n\n    /**\n     * The size to truncate to (for \"truncate\" type).\n     */\n    size?: number;\n  }\n\n  /**\n   * Writable stream for writing to a file.\n   * Extends WritableStream with file-specific operations.\n   */\n  interface FileSystemWritableFileStream extends WritableStream<Uint8Array> {\n    /**\n     * Write data to the file.\n     *\n     * @param data - The data to write\n     * @returns A promise that resolves when the write completes\n     *\n     * @example\n     * await writable.write(\"Hello, World!\");\n     * await writable.write(new Uint8Array([1, 2, 3]));\n     * await writable.write({ type: \"write\", data: \"text\", position: 0 });\n     */\n    write(\n      data: string | ArrayBuffer | Uint8Array | Blob | WriteParams\n    ): Promise<void>;\n\n    /**\n     * Seek to a position in the file.\n     *\n     * @param position - The byte position to seek to\n     * @returns A promise that resolves when the seek completes\n     *\n     * @example\n     * await writable.seek(0); // Seek to beginning\n     * await writable.write(\"Overwrite\");\n     */\n    seek(position: number): Promise<void>;\n\n    /**\n     * Truncate the file to a specific size.\n     *\n     * @param size - The size to truncate to\n     * @returns A promise that resolves when the truncation completes\n     *\n     * @example\n     * await writable.truncate(100); // Keep only first 100 bytes\n     */\n    truncate(size: number): Promise<void>;\n  }\n}\n";
+/**
+ * Type definitions for @ricsam/quickjs-test-environment globals.
+ *
+ * Includes: describe, it, test, expect, beforeAll, afterAll, beforeEach, afterEach
+ */
+export declare const TEST_ENV_TYPES = "/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-test-environment\n *\n * These types define the globals injected by setupTestEnvironment() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * describe(\"Math operations\", () => {\n *   it(\"should add numbers\", () => {\n *     expect(1 + 1).toBe(2);\n *   });\n * });\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Test Structure\n  // ============================================\n\n  /**\n   * Define a test suite.\n   *\n   * @param name - The name of the test suite\n   * @param fn - Function containing tests and nested suites\n   *\n   * @example\n   * describe(\"Calculator\", () => {\n   *   it(\"adds numbers\", () => {\n   *     expect(1 + 1).toBe(2);\n   *   });\n   * });\n   */\n  function describe(name: string, fn: () => void): void;\n\n  namespace describe {\n    /**\n     * Skip this suite and all its tests.\n     */\n    function skip(name: string, fn: () => void): void;\n\n    /**\n     * Only run this suite (and other .only suites).\n     */\n    function only(name: string, fn: () => void): void;\n\n    /**\n     * Mark suite as todo (skipped with different status).\n     */\n    function todo(name: string, fn?: () => void): void;\n  }\n\n  /**\n   * Define a test case.\n   *\n   * @param name - The name of the test\n   * @param fn - The test function (can be async)\n   *\n   * @example\n   * it(\"should work\", () => {\n   *   expect(true).toBe(true);\n   * });\n   *\n   * it(\"should work async\", async () => {\n   *   const result = await Promise.resolve(42);\n   *   expect(result).toBe(42);\n   * });\n   */\n  function it(name: string, fn: () => void | Promise<void>): void;\n\n  namespace it {\n    /**\n     * Skip this test.\n     */\n    function skip(name: string, fn?: () => void | Promise<void>): void;\n\n    /**\n     * Only run this test (and other .only tests).\n     */\n    function only(name: string, fn: () => void | Promise<void>): void;\n\n    /**\n     * Mark test as todo.\n     */\n    function todo(name: string, fn?: () => void | Promise<void>): void;\n  }\n\n  /**\n   * Alias for it().\n   */\n  function test(name: string, fn: () => void | Promise<void>): void;\n\n  namespace test {\n    /**\n     * Skip this test.\n     */\n    function skip(name: string, fn?: () => void | Promise<void>): void;\n\n    /**\n     * Only run this test (and other .only tests).\n     */\n    function only(name: string, fn: () => void | Promise<void>): void;\n\n    /**\n     * Mark test as todo.\n     */\n    function todo(name: string, fn?: () => void | Promise<void>): void;\n  }\n\n  // ============================================\n  // Lifecycle Hooks\n  // ============================================\n\n  /**\n   * Run once before all tests in the current suite.\n   *\n   * @param fn - Setup function (can be async)\n   */\n  function beforeAll(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run once after all tests in the current suite.\n   *\n   * @param fn - Teardown function (can be async)\n   */\n  function afterAll(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run before each test in the current suite (and nested suites).\n   *\n   * @param fn - Setup function (can be async)\n   */\n  function beforeEach(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run after each test in the current suite (and nested suites).\n   *\n   * @param fn - Teardown function (can be async)\n   */\n  function afterEach(fn: () => void | Promise<void>): void;\n\n  // ============================================\n  // Assertions\n  // ============================================\n\n  /**\n   * Matchers for assertions.\n   */\n  interface Matchers<T> {\n    /**\n     * Strict equality (===).\n     */\n    toBe(expected: T): void;\n\n    /**\n     * Deep equality.\n     */\n    toEqual(expected: unknown): void;\n\n    /**\n     * Deep equality with type checking.\n     */\n    toStrictEqual(expected: unknown): void;\n\n    /**\n     * Check if value is truthy.\n     */\n    toBeTruthy(): void;\n\n    /**\n     * Check if value is falsy.\n     */\n    toBeFalsy(): void;\n\n    /**\n     * Check if value is null.\n     */\n    toBeNull(): void;\n\n    /**\n     * Check if value is undefined.\n     */\n    toBeUndefined(): void;\n\n    /**\n     * Check if value is defined (not undefined).\n     */\n    toBeDefined(): void;\n\n    /**\n     * Check if value is NaN.\n     */\n    toBeNaN(): void;\n\n    /**\n     * Check if number is greater than expected.\n     */\n    toBeGreaterThan(n: number): void;\n\n    /**\n     * Check if number is greater than or equal to expected.\n     */\n    toBeGreaterThanOrEqual(n: number): void;\n\n    /**\n     * Check if number is less than expected.\n     */\n    toBeLessThan(n: number): void;\n\n    /**\n     * Check if number is less than or equal to expected.\n     */\n    toBeLessThanOrEqual(n: number): void;\n\n    /**\n     * Check if array/string contains item/substring.\n     */\n    toContain(item: unknown): void;\n\n    /**\n     * Check length of array/string.\n     */\n    toHaveLength(length: number): void;\n\n    /**\n     * Check if object has property (optionally with value).\n     */\n    toHaveProperty(key: string, value?: unknown): void;\n\n    /**\n     * Check if function throws.\n     */\n    toThrow(expected?: string | RegExp | Error): void;\n\n    /**\n     * Check if string matches pattern.\n     */\n    toMatch(pattern: string | RegExp): void;\n\n    /**\n     * Check if object matches subset of properties.\n     */\n    toMatchObject(object: object): void;\n\n    /**\n     * Check if value is instance of class.\n     */\n    toBeInstanceOf(constructor: Function): void;\n\n    /**\n     * Negate the matcher.\n     */\n    not: Matchers<T>;\n\n    /**\n     * Await promise and check resolved value.\n     */\n    resolves: Matchers<Awaited<T>>;\n\n    /**\n     * Await promise and check rejection.\n     */\n    rejects: Matchers<unknown>;\n  }\n\n  /**\n   * Create an expectation for a value.\n   *\n   * @param actual - The value to test\n   * @returns Matchers for the value\n   *\n   * @example\n   * expect(1 + 1).toBe(2);\n   * expect({ a: 1 }).toEqual({ a: 1 });\n   * expect(() => { throw new Error(); }).toThrow();\n   * expect(promise).resolves.toBe(42);\n   */\n  function expect<T>(actual: T): Matchers<T>;\n}\n";
 /**
  * Map of package names to their type definitions.
  */
@@ -35,6 +41,7 @@ export declare const TYPE_DEFINITIONS: {
     readonly core: "/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-core\n *\n * These types define the globals injected by setupCore() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // In your tsconfig.quickjs.json\n * {\n *   \"compilerOptions\": {\n *     \"lib\": [\"ESNext\", \"DOM\"]\n *   }\n * }\n *\n * // Then reference this file or use ts-morph for code strings\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Web Streams API\n  // ============================================\n\n  /**\n   * A readable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStream\n   */\n  const ReadableStream: typeof globalThis.ReadableStream;\n\n  /**\n   * A writable stream of data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStream\n   */\n  const WritableStream: typeof globalThis.WritableStream;\n\n  /**\n   * A transform stream that can be used to pipe data through a transformer.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/TransformStream\n   */\n  const TransformStream: typeof globalThis.TransformStream;\n\n  /**\n   * Default reader for ReadableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/ReadableStreamDefaultReader\n   */\n  const ReadableStreamDefaultReader: typeof globalThis.ReadableStreamDefaultReader;\n\n  /**\n   * Default writer for WritableStream\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/WritableStreamDefaultWriter\n   */\n  const WritableStreamDefaultWriter: typeof globalThis.WritableStreamDefaultWriter;\n\n  // ============================================\n  // Blob and File APIs\n  // ============================================\n\n  /**\n   * A file-like object of immutable, raw data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Blob\n   */\n  const Blob: typeof globalThis.Blob;\n\n  /**\n   * A file object representing a file.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/File\n   */\n  const File: typeof globalThis.File;\n\n  // ============================================\n  // URL APIs\n  // ============================================\n\n  /**\n   * Interface for URL manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URL\n   */\n  const URL: typeof globalThis.URL;\n\n  /**\n   * Utility for working with URL query strings.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams\n   */\n  const URLSearchParams: typeof globalThis.URLSearchParams;\n\n  // ============================================\n  // Error Handling\n  // ============================================\n\n  /**\n   * Exception type for DOM operations.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/DOMException\n   */\n  const DOMException: typeof globalThis.DOMException;\n}\n";
     readonly fetch: "/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fetch\n *\n * These types define the globals injected by setupFetch() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with serve()\n * serve({\n *   fetch(request, server) {\n *     if (request.url.includes(\"/ws\")) {\n *       server.upgrade(request, { data: { id: 123 } });\n *       return new Response(null, { status: 101 });\n *     }\n *     return new Response(\"Hello!\");\n *   },\n *   websocket: {\n *     message(ws, message) {\n *       ws.send(\"Echo: \" + message);\n *     }\n *   }\n * });\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Standard Fetch API (from lib.dom)\n  // ============================================\n\n  /**\n   * Headers class for HTTP headers manipulation.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Headers\n   */\n  const Headers: typeof globalThis.Headers;\n\n  /**\n   * Request class for HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Request\n   */\n  const Request: typeof globalThis.Request;\n\n  /**\n   * Response class for HTTP responses.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Response\n   */\n  const Response: typeof globalThis.Response;\n\n  /**\n   * AbortController for cancelling fetch requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortController\n   */\n  const AbortController: typeof globalThis.AbortController;\n\n  /**\n   * AbortSignal for listening to abort events.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal\n   */\n  const AbortSignal: typeof globalThis.AbortSignal;\n\n  /**\n   * FormData for constructing form data.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/FormData\n   */\n  const FormData: typeof globalThis.FormData;\n\n  /**\n   * Fetch function for making HTTP requests.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/fetch\n   */\n  function fetch(\n    input: RequestInfo | URL,\n    init?: RequestInit\n  ): Promise<Response>;\n\n  // ============================================\n  // QuickJS-specific: serve() API\n  // ============================================\n\n  /**\n   * Server interface for handling WebSocket upgrades within serve() handlers.\n   */\n  interface Server {\n    /**\n     * Upgrade an HTTP request to a WebSocket connection.\n     *\n     * @param request - The incoming HTTP request to upgrade\n     * @param options - Optional data to associate with the WebSocket connection\n     * @returns true if upgrade will proceed, false otherwise\n     *\n     * @example\n     * serve({\n     *   fetch(request, server) {\n     *     if (server.upgrade(request, { data: { userId: 123 } })) {\n     *       return new Response(null, { status: 101 });\n     *     }\n     *     return new Response(\"Upgrade failed\", { status: 400 });\n     *   }\n     * });\n     */\n    upgrade(request: Request, options?: { data?: unknown }): boolean;\n  }\n\n  /**\n   * ServerWebSocket interface for WebSocket connections within serve() handlers.\n   *\n   * @typeParam T - The type of data associated with this WebSocket connection\n   */\n  interface ServerWebSocket<T = unknown> {\n    /**\n     * User data associated with this connection.\n     * Set via `server.upgrade(request, { data: ... })`.\n     */\n    readonly data: T;\n\n    /**\n     * Send a message to the client.\n     *\n     * @param message - The message to send (string, ArrayBuffer, or Uint8Array)\n     */\n    send(message: string | ArrayBuffer | Uint8Array): void;\n\n    /**\n     * Close the WebSocket connection.\n     *\n     * @param code - Optional close code (default: 1000)\n     * @param reason - Optional close reason\n     */\n    close(code?: number, reason?: string): void;\n\n    /**\n     * WebSocket ready state.\n     * - 0: CONNECTING\n     * - 1: OPEN\n     * - 2: CLOSING\n     * - 3: CLOSED\n     */\n    readonly readyState: number;\n  }\n\n  /**\n   * Options for the serve() function.\n   *\n   * @typeParam T - The type of data associated with WebSocket connections\n   */\n  interface ServeOptions<T = unknown> {\n    /**\n     * Handler for HTTP requests.\n     *\n     * @param request - The incoming HTTP request\n     * @param server - Server interface for WebSocket upgrades\n     * @returns Response or Promise resolving to Response\n     */\n    fetch(request: Request, server: Server): Response | Promise<Response>;\n\n    /**\n     * WebSocket event handlers.\n     */\n    websocket?: {\n      /**\n       * Called when a WebSocket connection is opened.\n       *\n       * @param ws - The WebSocket connection\n       */\n      open?(ws: ServerWebSocket<T>): void | Promise<void>;\n\n      /**\n       * Called when a message is received.\n       *\n       * @param ws - The WebSocket connection\n       * @param message - The received message (string or ArrayBuffer)\n       */\n      message?(\n        ws: ServerWebSocket<T>,\n        message: string | ArrayBuffer\n      ): void | Promise<void>;\n\n      /**\n       * Called when the connection is closed.\n       *\n       * @param ws - The WebSocket connection\n       * @param code - The close code\n       * @param reason - The close reason\n       */\n      close?(\n        ws: ServerWebSocket<T>,\n        code: number,\n        reason: string\n      ): void | Promise<void>;\n\n      /**\n       * Called when an error occurs.\n       *\n       * @param ws - The WebSocket connection\n       * @param error - The error that occurred\n       */\n      error?(ws: ServerWebSocket<T>, error: Error): void | Promise<void>;\n    };\n  }\n\n  /**\n   * Register an HTTP server handler in QuickJS.\n   *\n   * Only one serve() handler can be active at a time.\n   * Calling serve() again replaces the previous handler.\n   *\n   * @param options - Server configuration including fetch handler and optional WebSocket handlers\n   *\n   * @example\n   * serve({\n   *   fetch(request, server) {\n   *     const url = new URL(request.url);\n   *\n   *     if (url.pathname === \"/ws\") {\n   *       if (server.upgrade(request, { data: { connectedAt: Date.now() } })) {\n   *         return new Response(null, { status: 101 });\n   *       }\n   *     }\n   *\n   *     if (url.pathname === \"/api/hello\") {\n   *       return Response.json({ message: \"Hello!\" });\n   *     }\n   *\n   *     return new Response(\"Not Found\", { status: 404 });\n   *   },\n   *   websocket: {\n   *     open(ws) {\n   *       console.log(\"Connected at:\", ws.data.connectedAt);\n   *     },\n   *     message(ws, message) {\n   *       ws.send(\"Echo: \" + message);\n   *     },\n   *     close(ws, code, reason) {\n   *       console.log(\"Closed:\", code, reason);\n   *     }\n   *   }\n   * });\n   */\n  function serve<T = unknown>(options: ServeOptions<T>): void;\n}\n";
     readonly fs: "/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-fs\n *\n * These types define the globals injected by setupFs() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * // Typecheck QuickJS code with file system access\n * const root = await fs.getDirectory(\"/data\");\n * const fileHandle = await root.getFileHandle(\"config.json\");\n * const file = await fileHandle.getFile();\n * const content = await file.text();\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // fs namespace - QuickJS-specific entry point\n  // ============================================\n\n  /**\n   * File System namespace providing access to the file system.\n   * This is the QuickJS-specific entry point (differs from browser's navigator.storage.getDirectory()).\n   */\n  namespace fs {\n    /**\n     * Get a directory handle for the given path.\n     *\n     * The host controls which paths are accessible. Invalid or unauthorized\n     * paths will throw an error.\n     *\n     * @param path - The path to request from the host\n     * @returns A promise resolving to a directory handle\n     * @throws If the path is not allowed or doesn't exist\n     *\n     * @example\n     * const root = await fs.getDirectory(\"/\");\n     * const dataDir = await fs.getDirectory(\"/data\");\n     */\n    function getDirectory(path: string): Promise<FileSystemDirectoryHandle>;\n  }\n\n  // ============================================\n  // File System Access API\n  // ============================================\n\n  /**\n   * Base interface for file system handles.\n   */\n  interface FileSystemHandle {\n    /**\n     * The kind of handle: \"file\" or \"directory\".\n     */\n    readonly kind: \"file\" | \"directory\";\n\n    /**\n     * The name of the file or directory.\n     */\n    readonly name: string;\n\n    /**\n     * Compare two handles to check if they reference the same entry.\n     *\n     * @param other - Another FileSystemHandle to compare against\n     * @returns true if both handles reference the same entry\n     */\n    isSameEntry(other: FileSystemHandle): Promise<boolean>;\n  }\n\n  /**\n   * Handle for a file in the file system.\n   */\n  interface FileSystemFileHandle extends FileSystemHandle {\n    /**\n     * Always \"file\" for file handles.\n     */\n    readonly kind: \"file\";\n\n    /**\n     * Get the file contents as a File object.\n     *\n     * @returns A promise resolving to a File object\n     *\n     * @example\n     * const file = await fileHandle.getFile();\n     * const text = await file.text();\n     */\n    getFile(): Promise<File>;\n\n    /**\n     * Create a writable stream for writing to the file.\n     *\n     * @param options - Options for the writable stream\n     * @returns A promise resolving to a writable stream\n     *\n     * @example\n     * const writable = await fileHandle.createWritable();\n     * await writable.write(\"Hello, World!\");\n     * await writable.close();\n     */\n    createWritable(options?: {\n      /**\n       * If true, keeps existing file data. Otherwise, truncates the file.\n       */\n      keepExistingData?: boolean;\n    }): Promise<FileSystemWritableFileStream>;\n  }\n\n  /**\n   * Handle for a directory in the file system.\n   */\n  interface FileSystemDirectoryHandle extends FileSystemHandle {\n    /**\n     * Always \"directory\" for directory handles.\n     */\n    readonly kind: \"directory\";\n\n    /**\n     * Get a file handle within this directory.\n     *\n     * @param name - The name of the file\n     * @param options - Options for getting the file handle\n     * @returns A promise resolving to a file handle\n     * @throws If the file doesn't exist and create is not true\n     *\n     * @example\n     * const file = await dir.getFileHandle(\"data.json\");\n     * const newFile = await dir.getFileHandle(\"output.txt\", { create: true });\n     */\n    getFileHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the file if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemFileHandle>;\n\n    /**\n     * Get a subdirectory handle within this directory.\n     *\n     * @param name - The name of the subdirectory\n     * @param options - Options for getting the directory handle\n     * @returns A promise resolving to a directory handle\n     * @throws If the directory doesn't exist and create is not true\n     *\n     * @example\n     * const subdir = await dir.getDirectoryHandle(\"logs\");\n     * const newDir = await dir.getDirectoryHandle(\"cache\", { create: true });\n     */\n    getDirectoryHandle(\n      name: string,\n      options?: {\n        /**\n         * If true, creates the directory if it doesn't exist.\n         */\n        create?: boolean;\n      }\n    ): Promise<FileSystemDirectoryHandle>;\n\n    /**\n     * Remove a file or directory within this directory.\n     *\n     * @param name - The name of the entry to remove\n     * @param options - Options for removal\n     * @throws If the entry doesn't exist or cannot be removed\n     *\n     * @example\n     * await dir.removeEntry(\"old-file.txt\");\n     * await dir.removeEntry(\"old-dir\", { recursive: true });\n     */\n    removeEntry(\n      name: string,\n      options?: {\n        /**\n         * If true, removes directories recursively.\n         */\n        recursive?: boolean;\n      }\n    ): Promise<void>;\n\n    /**\n     * Resolve the path from this directory to a descendant handle.\n     *\n     * @param possibleDescendant - A handle that may be a descendant\n     * @returns An array of path segments, or null if not a descendant\n     *\n     * @example\n     * const path = await root.resolve(nestedFile);\n     * // [\"subdir\", \"file.txt\"]\n     */\n    resolve(possibleDescendant: FileSystemHandle): Promise<string[] | null>;\n\n    /**\n     * Iterate over entries in this directory.\n     *\n     * @returns An async iterator of [name, handle] pairs\n     *\n     * @example\n     * for await (const [name, handle] of dir.entries()) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    entries(): AsyncIterableIterator<[string, FileSystemHandle]>;\n\n    /**\n     * Iterate over entry names in this directory.\n     *\n     * @returns An async iterator of names\n     *\n     * @example\n     * for await (const name of dir.keys()) {\n     *   console.log(name);\n     * }\n     */\n    keys(): AsyncIterableIterator<string>;\n\n    /**\n     * Iterate over handles in this directory.\n     *\n     * @returns An async iterator of handles\n     *\n     * @example\n     * for await (const handle of dir.values()) {\n     *   console.log(handle.name, handle.kind);\n     * }\n     */\n    values(): AsyncIterableIterator<FileSystemHandle>;\n\n    /**\n     * Async iterator support for directory entries.\n     *\n     * @example\n     * for await (const [name, handle] of dir) {\n     *   console.log(name, handle.kind);\n     * }\n     */\n    [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;\n  }\n\n  /**\n   * Parameters for write operations on FileSystemWritableFileStream.\n   */\n  interface WriteParams {\n    /**\n     * The type of write operation.\n     * - \"write\": Write data at the current position or specified position\n     * - \"seek\": Move the file position\n     * - \"truncate\": Truncate the file to a specific size\n     */\n    type: \"write\" | \"seek\" | \"truncate\";\n\n    /**\n     * The data to write (for \"write\" type).\n     */\n    data?: string | ArrayBuffer | Uint8Array | Blob;\n\n    /**\n     * The position to write at or seek to.\n     */\n    position?: number;\n\n    /**\n     * The size to truncate to (for \"truncate\" type).\n     */\n    size?: number;\n  }\n\n  /**\n   * Writable stream for writing to a file.\n   * Extends WritableStream with file-specific operations.\n   */\n  interface FileSystemWritableFileStream extends WritableStream<Uint8Array> {\n    /**\n     * Write data to the file.\n     *\n     * @param data - The data to write\n     * @returns A promise that resolves when the write completes\n     *\n     * @example\n     * await writable.write(\"Hello, World!\");\n     * await writable.write(new Uint8Array([1, 2, 3]));\n     * await writable.write({ type: \"write\", data: \"text\", position: 0 });\n     */\n    write(\n      data: string | ArrayBuffer | Uint8Array | Blob | WriteParams\n    ): Promise<void>;\n\n    /**\n     * Seek to a position in the file.\n     *\n     * @param position - The byte position to seek to\n     * @returns A promise that resolves when the seek completes\n     *\n     * @example\n     * await writable.seek(0); // Seek to beginning\n     * await writable.write(\"Overwrite\");\n     */\n    seek(position: number): Promise<void>;\n\n    /**\n     * Truncate the file to a specific size.\n     *\n     * @param size - The size to truncate to\n     * @returns A promise that resolves when the truncation completes\n     *\n     * @example\n     * await writable.truncate(100); // Keep only first 100 bytes\n     */\n    truncate(size: number): Promise<void>;\n  }\n}\n";
+    readonly testEnvironment: "/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-test-environment\n *\n * These types define the globals injected by setupTestEnvironment() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * describe(\"Math operations\", () => {\n *   it(\"should add numbers\", () => {\n *     expect(1 + 1).toBe(2);\n *   });\n * });\n */\n\nexport {};\n\ndeclare global {\n  // ============================================\n  // Test Structure\n  // ============================================\n\n  /**\n   * Define a test suite.\n   *\n   * @param name - The name of the test suite\n   * @param fn - Function containing tests and nested suites\n   *\n   * @example\n   * describe(\"Calculator\", () => {\n   *   it(\"adds numbers\", () => {\n   *     expect(1 + 1).toBe(2);\n   *   });\n   * });\n   */\n  function describe(name: string, fn: () => void): void;\n\n  namespace describe {\n    /**\n     * Skip this suite and all its tests.\n     */\n    function skip(name: string, fn: () => void): void;\n\n    /**\n     * Only run this suite (and other .only suites).\n     */\n    function only(name: string, fn: () => void): void;\n\n    /**\n     * Mark suite as todo (skipped with different status).\n     */\n    function todo(name: string, fn?: () => void): void;\n  }\n\n  /**\n   * Define a test case.\n   *\n   * @param name - The name of the test\n   * @param fn - The test function (can be async)\n   *\n   * @example\n   * it(\"should work\", () => {\n   *   expect(true).toBe(true);\n   * });\n   *\n   * it(\"should work async\", async () => {\n   *   const result = await Promise.resolve(42);\n   *   expect(result).toBe(42);\n   * });\n   */\n  function it(name: string, fn: () => void | Promise<void>): void;\n\n  namespace it {\n    /**\n     * Skip this test.\n     */\n    function skip(name: string, fn?: () => void | Promise<void>): void;\n\n    /**\n     * Only run this test (and other .only tests).\n     */\n    function only(name: string, fn: () => void | Promise<void>): void;\n\n    /**\n     * Mark test as todo.\n     */\n    function todo(name: string, fn?: () => void | Promise<void>): void;\n  }\n\n  /**\n   * Alias for it().\n   */\n  function test(name: string, fn: () => void | Promise<void>): void;\n\n  namespace test {\n    /**\n     * Skip this test.\n     */\n    function skip(name: string, fn?: () => void | Promise<void>): void;\n\n    /**\n     * Only run this test (and other .only tests).\n     */\n    function only(name: string, fn: () => void | Promise<void>): void;\n\n    /**\n     * Mark test as todo.\n     */\n    function todo(name: string, fn?: () => void | Promise<void>): void;\n  }\n\n  // ============================================\n  // Lifecycle Hooks\n  // ============================================\n\n  /**\n   * Run once before all tests in the current suite.\n   *\n   * @param fn - Setup function (can be async)\n   */\n  function beforeAll(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run once after all tests in the current suite.\n   *\n   * @param fn - Teardown function (can be async)\n   */\n  function afterAll(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run before each test in the current suite (and nested suites).\n   *\n   * @param fn - Setup function (can be async)\n   */\n  function beforeEach(fn: () => void | Promise<void>): void;\n\n  /**\n   * Run after each test in the current suite (and nested suites).\n   *\n   * @param fn - Teardown function (can be async)\n   */\n  function afterEach(fn: () => void | Promise<void>): void;\n\n  // ============================================\n  // Assertions\n  // ============================================\n\n  /**\n   * Matchers for assertions.\n   */\n  interface Matchers<T> {\n    /**\n     * Strict equality (===).\n     */\n    toBe(expected: T): void;\n\n    /**\n     * Deep equality.\n     */\n    toEqual(expected: unknown): void;\n\n    /**\n     * Deep equality with type checking.\n     */\n    toStrictEqual(expected: unknown): void;\n\n    /**\n     * Check if value is truthy.\n     */\n    toBeTruthy(): void;\n\n    /**\n     * Check if value is falsy.\n     */\n    toBeFalsy(): void;\n\n    /**\n     * Check if value is null.\n     */\n    toBeNull(): void;\n\n    /**\n     * Check if value is undefined.\n     */\n    toBeUndefined(): void;\n\n    /**\n     * Check if value is defined (not undefined).\n     */\n    toBeDefined(): void;\n\n    /**\n     * Check if value is NaN.\n     */\n    toBeNaN(): void;\n\n    /**\n     * Check if number is greater than expected.\n     */\n    toBeGreaterThan(n: number): void;\n\n    /**\n     * Check if number is greater than or equal to expected.\n     */\n    toBeGreaterThanOrEqual(n: number): void;\n\n    /**\n     * Check if number is less than expected.\n     */\n    toBeLessThan(n: number): void;\n\n    /**\n     * Check if number is less than or equal to expected.\n     */\n    toBeLessThanOrEqual(n: number): void;\n\n    /**\n     * Check if array/string contains item/substring.\n     */\n    toContain(item: unknown): void;\n\n    /**\n     * Check length of array/string.\n     */\n    toHaveLength(length: number): void;\n\n    /**\n     * Check if object has property (optionally with value).\n     */\n    toHaveProperty(key: string, value?: unknown): void;\n\n    /**\n     * Check if function throws.\n     */\n    toThrow(expected?: string | RegExp | Error): void;\n\n    /**\n     * Check if string matches pattern.\n     */\n    toMatch(pattern: string | RegExp): void;\n\n    /**\n     * Check if object matches subset of properties.\n     */\n    toMatchObject(object: object): void;\n\n    /**\n     * Check if value is instance of class.\n     */\n    toBeInstanceOf(constructor: Function): void;\n\n    /**\n     * Negate the matcher.\n     */\n    not: Matchers<T>;\n\n    /**\n     * Await promise and check resolved value.\n     */\n    resolves: Matchers<Awaited<T>>;\n\n    /**\n     * Await promise and check rejection.\n     */\n    rejects: Matchers<unknown>;\n  }\n\n  /**\n   * Create an expectation for a value.\n   *\n   * @param actual - The value to test\n   * @returns Matchers for the value\n   *\n   * @example\n   * expect(1 + 1).toBe(2);\n   * expect({ a: 1 }).toEqual({ a: 1 });\n   * expect(() => { throw new Error(); }).toThrow();\n   * expect(promise).resolves.toBe(42);\n   */\n  function expect<T>(actual: T): Matchers<T>;\n}\n";
 };
 /**
  * Type for the keys of TYPE_DEFINITIONS.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/quickjs-test-utils",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/types/index.d.ts",
   "exports": {
@@ -20,10 +20,10 @@
   },
   "peerDependencies": {
     "quickjs-emscripten": "^0.31.0",
-    "@ricsam/quickjs-core": "^0.2.2",
-    "@ricsam/quickjs-fetch": "^0.2.2",
-    "@ricsam/quickjs-fs": "^0.2.2",
-    "@ricsam/quickjs-runtime": "^0.2.2"
+    "@ricsam/quickjs-core": "^0.2.4",
+    "@ricsam/quickjs-fetch": "^0.2.4",
+    "@ricsam/quickjs-fs": "^0.2.4",
+    "@ricsam/quickjs-runtime": "^0.2.4"
   },
   "peerDependenciesMeta": {
     "@ricsam/quickjs-fs": {