@ricsam/quickjs-test-utils 1.0.7 → 1.0.9

package/dist/cjs/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/index.ts"],
   "sourcesContent": [
-    "export {\n  createTestContext,\n  disposeTestContext,\n  useTestContext,\n  type TestContext,\n} from \"./context.cjs\";\n\nexport {\n  createFetchTestContext,\n  disposeFetchTestContext,\n  useFetchTestContext,\n  type FetchTestContext,\n  type CreateFetchTestContextOptions,\n} from \"./fetch-context.cjs\";\n\nexport { evalCode, evalCodeAsync } from \"./eval.cjs\";\n\nexport {\n  startIntegrationServer,\n  type IntegrationTestServer,\n  type StartIntegrationServerOptions,\n} from \"./integration-server.cjs\";\n\nexport {\n  typecheckQuickJSCode,\n  formatTypecheckErrors,\n  type TypecheckResult,\n  type TypecheckError,\n  type TypecheckOptions,\n} from \"./typecheck.cjs\";\n\nexport {\n  CORE_TYPES,\n  FETCH_TYPES,\n  FS_TYPES,\n  TYPE_DEFINITIONS,\n  type TypeDefinitionKey,\n} from \"./quickjs-types.cjs\";\n\n// For fs and runtime contexts, import from subpaths:\n// import { createFsTestContext } from \"@ricsam/quickjs-test-utils/fs\";\n// import { createRuntimeTestContext } from \"@ricsam/quickjs-test-utils/runtime\";\n"
+    "export {\n  createTestContext,\n  disposeTestContext,\n  useTestContext,\n  type TestContext,\n} from \"./context.cjs\";\n\nexport {\n  createFetchTestContext,\n  disposeFetchTestContext,\n  useFetchTestContext,\n  type FetchTestContext,\n  type CreateFetchTestContextOptions,\n} from \"./fetch-context.cjs\";\n\nexport { evalCode, evalCodeAsync } from \"./eval.cjs\";\n\nexport {\n  startIntegrationServer,\n  type IntegrationTestServer,\n  type StartIntegrationServerOptions,\n} from \"./integration-server.cjs\";\n\nexport {\n  typecheckQuickJSCode,\n  formatTypecheckErrors,\n  type TypecheckResult,\n  type TypecheckError,\n  type TypecheckOptions,\n  type LibraryTypes,\n  type LibraryTypeFile,\n} from \"./typecheck.cjs\";\n\nexport {\n  CORE_TYPES,\n  FETCH_TYPES,\n  FS_TYPES,\n  TYPE_DEFINITIONS,\n  type TypeDefinitionKey,\n} from \"./quickjs-types.cjs\";\n\n// For fs and runtime contexts, import from subpaths:\n// import { createFsTestContext } from \"@ricsam/quickjs-test-utils/fs\";\n// import { createRuntimeTestContext } from \"@ricsam/quickjs-test-utils/runtime\";\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKO,IALP;AAaO,IANP;AAQwC,IAAxC;AAMO,IAJP;AAYO,IANP;AAcO,IANP;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKO,IALP;AAaO,IANP;AAQwC,IAAxC;AAMO,IAJP;AAcO,IARP;AAgBO,IANP;",
   "debugId": "58D73AEF6D5595F264756E2164756E21",
   "names": []
 }

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/quickjs-test-utils",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "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,
+  TIMERS_TYPES: () => TIMERS_TYPES,
   TEST_ENV_TYPES: () => TEST_ENV_TYPES,
   FS_TYPES: () => FS_TYPES,
   FETCH_TYPES: () => FETCH_TYPES,
@@ -1141,14 +1142,96 @@ declare global {
   function btoa(stringToEncode: string): string;
 }
 `;
+var TIMERS_TYPES = `/**
+ * QuickJS Global Type Definitions for @ricsam/quickjs-timers
+ *
+ * These types define the globals injected by setupTimers() into a QuickJS context.
+ * Use these types to typecheck user code that will run inside QuickJS.
+ *
+ * @example
+ * const timeoutId = setTimeout(() => {
+ *   console.log("fired!");
+ * }, 1000);
+ *
+ * clearTimeout(timeoutId);
+ *
+ * const intervalId = setInterval(() => {
+ *   console.log("tick");
+ * }, 100);
+ *
+ * clearInterval(intervalId);
+ */
+
+export {};
+
+declare global {
+  /**
+   * Schedule a callback to execute after a delay.
+   *
+   * @param callback - The function to call after the delay
+   * @param ms - The delay in milliseconds (default: 0)
+   * @param args - Additional arguments to pass to the callback
+   * @returns A timer ID that can be passed to clearTimeout
+   *
+   * @example
+   * const id = setTimeout(() => console.log("done"), 1000);
+   * setTimeout((a, b) => console.log(a, b), 100, "hello", "world");
+   */
+  function setTimeout(
+    callback: (...args: unknown[]) => void,
+    ms?: number,
+    ...args: unknown[]
+  ): number;
+
+  /**
+   * Schedule a callback to execute repeatedly at a fixed interval.
+   *
+   * @param callback - The function to call at each interval
+   * @param ms - The interval in milliseconds (minimum: 4ms)
+   * @param args - Additional arguments to pass to the callback
+   * @returns A timer ID that can be passed to clearInterval
+   *
+   * @example
+   * const id = setInterval(() => console.log("tick"), 1000);
+   */
+  function setInterval(
+    callback: (...args: unknown[]) => void,
+    ms?: number,
+    ...args: unknown[]
+  ): number;
+
+  /**
+   * Cancel a timeout previously scheduled with setTimeout.
+   *
+   * @param id - The timer ID returned by setTimeout
+   *
+   * @example
+   * const id = setTimeout(() => {}, 1000);
+   * clearTimeout(id);
+   */
+  function clearTimeout(id: number | undefined): void;
+
+  /**
+   * Cancel an interval previously scheduled with setInterval.
+   *
+   * @param id - The timer ID returned by setInterval
+   *
+   * @example
+   * const id = setInterval(() => {}, 1000);
+   * clearInterval(id);
+   */
+  function clearInterval(id: number | undefined): void;
+}
+`;
 var TYPE_DEFINITIONS = {
   core: CORE_TYPES,
   console: CONSOLE_TYPES,
   encoding: ENCODING_TYPES,
   fetch: FETCH_TYPES,
   fs: FS_TYPES,
-  testEnvironment: TEST_ENV_TYPES
+  testEnvironment: TEST_ENV_TYPES,
+  timers: TIMERS_TYPES
 };
 })
 
-//# debugId=22216BE3C74E0DC864756E2164756E21
+//# debugId=DA5F861495C9A88164756E2164756E21

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 * 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 * Type definitions for @ricsam/quickjs-console globals.\n *\n * Includes: console.log, warn, error, debug, info, trace, dir, table, time, timeEnd, timeLog, count, countReset, clear, assert, group, groupCollapsed, groupEnd\n */\nexport const CONSOLE_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-console\n *\n * These types define the globals injected by setupConsole() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Console interface for logging and debugging.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Console\n   */\n  interface Console {\n    /**\n     * Log a message to the console.\n     * @param data - Values to log\n     */\n    log(...data: unknown[]): void;\n\n    /**\n     * Log a warning message.\n     * @param data - Values to log\n     */\n    warn(...data: unknown[]): void;\n\n    /**\n     * Log an error message.\n     * @param data - Values to log\n     */\n    error(...data: unknown[]): void;\n\n    /**\n     * Log a debug message.\n     * @param data - Values to log\n     */\n    debug(...data: unknown[]): void;\n\n    /**\n     * Log an info message.\n     * @param data - Values to log\n     */\n    info(...data: unknown[]): void;\n\n    /**\n     * Log a stack trace.\n     * @param data - Values to log with the trace\n     */\n    trace(...data: unknown[]): void;\n\n    /**\n     * Display an object in a formatted way.\n     * @param item - Object to display\n     * @param options - Display options\n     */\n    dir(item: unknown, options?: object): void;\n\n    /**\n     * Display tabular data.\n     * @param tabularData - Data to display as a table\n     * @param properties - Optional array of property names to include\n     */\n    table(tabularData: unknown, properties?: string[]): void;\n\n    /**\n     * Start a timer.\n     * @param label - Timer label (default: \"default\")\n     */\n    time(label?: string): void;\n\n    /**\n     * End a timer and log the elapsed time.\n     * @param label - Timer label (default: \"default\")\n     */\n    timeEnd(label?: string): void;\n\n    /**\n     * Log the elapsed time of a timer without ending it.\n     * @param label - Timer label (default: \"default\")\n     * @param data - Additional values to log\n     */\n    timeLog(label?: string, ...data: unknown[]): void;\n\n    /**\n     * Log an error if the assertion is false.\n     * @param condition - Condition to test\n     * @param data - Values to log if assertion fails\n     */\n    assert(condition?: boolean, ...data: unknown[]): void;\n\n    /**\n     * Increment and log a counter.\n     * @param label - Counter label (default: \"default\")\n     */\n    count(label?: string): void;\n\n    /**\n     * Reset a counter.\n     * @param label - Counter label (default: \"default\")\n     */\n    countReset(label?: string): void;\n\n    /**\n     * Clear the console.\n     */\n    clear(): void;\n\n    /**\n     * Start an inline group.\n     * @param data - Group label\n     */\n    group(...data: unknown[]): void;\n\n    /**\n     * Start a collapsed inline group.\n     * @param data - Group label\n     */\n    groupCollapsed(...data: unknown[]): void;\n\n    /**\n     * End the current inline group.\n     */\n    groupEnd(): void;\n  }\n\n  /**\n   * Console object for logging and debugging.\n   */\n  const console: Console;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-encoding globals.\n *\n * Includes: atob, btoa\n */\nexport const ENCODING_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-encoding\n *\n * These types define the globals injected by setupEncoding() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Decodes a Base64-encoded string.\n   *\n   * @param encodedData - The Base64 string to decode\n   * @returns The decoded string\n   * @throws DOMException if the input is not valid Base64\n   *\n   * @example\n   * atob(\"SGVsbG8=\"); // \"Hello\"\n   */\n  function atob(encodedData: string): string;\n\n  /**\n   * Encodes a string to Base64.\n   *\n   * @param stringToEncode - The string to encode (must contain only Latin1 characters)\n   * @returns The Base64 encoded string\n   * @throws DOMException if the string contains characters outside Latin1 range (0-255)\n   *\n   * @example\n   * btoa(\"Hello\"); // \"SGVsbG8=\"\n   */\n  function btoa(stringToEncode: string): string;\n}\n`;\n\n/**\n * Map of package names to their type definitions.\n */\nexport const TYPE_DEFINITIONS = {\n  core: CORE_TYPES,\n  console: CONSOLE_TYPES,\n  encoding: ENCODING_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"
+    "/**\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 * Type definitions for @ricsam/quickjs-console globals.\n *\n * Includes: console.log, warn, error, debug, info, trace, dir, table, time, timeEnd, timeLog, count, countReset, clear, assert, group, groupCollapsed, groupEnd\n */\nexport const CONSOLE_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-console\n *\n * These types define the globals injected by setupConsole() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Console interface for logging and debugging.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Console\n   */\n  interface Console {\n    /**\n     * Log a message to the console.\n     * @param data - Values to log\n     */\n    log(...data: unknown[]): void;\n\n    /**\n     * Log a warning message.\n     * @param data - Values to log\n     */\n    warn(...data: unknown[]): void;\n\n    /**\n     * Log an error message.\n     * @param data - Values to log\n     */\n    error(...data: unknown[]): void;\n\n    /**\n     * Log a debug message.\n     * @param data - Values to log\n     */\n    debug(...data: unknown[]): void;\n\n    /**\n     * Log an info message.\n     * @param data - Values to log\n     */\n    info(...data: unknown[]): void;\n\n    /**\n     * Log a stack trace.\n     * @param data - Values to log with the trace\n     */\n    trace(...data: unknown[]): void;\n\n    /**\n     * Display an object in a formatted way.\n     * @param item - Object to display\n     * @param options - Display options\n     */\n    dir(item: unknown, options?: object): void;\n\n    /**\n     * Display tabular data.\n     * @param tabularData - Data to display as a table\n     * @param properties - Optional array of property names to include\n     */\n    table(tabularData: unknown, properties?: string[]): void;\n\n    /**\n     * Start a timer.\n     * @param label - Timer label (default: \"default\")\n     */\n    time(label?: string): void;\n\n    /**\n     * End a timer and log the elapsed time.\n     * @param label - Timer label (default: \"default\")\n     */\n    timeEnd(label?: string): void;\n\n    /**\n     * Log the elapsed time of a timer without ending it.\n     * @param label - Timer label (default: \"default\")\n     * @param data - Additional values to log\n     */\n    timeLog(label?: string, ...data: unknown[]): void;\n\n    /**\n     * Log an error if the assertion is false.\n     * @param condition - Condition to test\n     * @param data - Values to log if assertion fails\n     */\n    assert(condition?: boolean, ...data: unknown[]): void;\n\n    /**\n     * Increment and log a counter.\n     * @param label - Counter label (default: \"default\")\n     */\n    count(label?: string): void;\n\n    /**\n     * Reset a counter.\n     * @param label - Counter label (default: \"default\")\n     */\n    countReset(label?: string): void;\n\n    /**\n     * Clear the console.\n     */\n    clear(): void;\n\n    /**\n     * Start an inline group.\n     * @param data - Group label\n     */\n    group(...data: unknown[]): void;\n\n    /**\n     * Start a collapsed inline group.\n     * @param data - Group label\n     */\n    groupCollapsed(...data: unknown[]): void;\n\n    /**\n     * End the current inline group.\n     */\n    groupEnd(): void;\n  }\n\n  /**\n   * Console object for logging and debugging.\n   */\n  const console: Console;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-encoding globals.\n *\n * Includes: atob, btoa\n */\nexport const ENCODING_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-encoding\n *\n * These types define the globals injected by setupEncoding() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Decodes a Base64-encoded string.\n   *\n   * @param encodedData - The Base64 string to decode\n   * @returns The decoded string\n   * @throws DOMException if the input is not valid Base64\n   *\n   * @example\n   * atob(\"SGVsbG8=\"); // \"Hello\"\n   */\n  function atob(encodedData: string): string;\n\n  /**\n   * Encodes a string to Base64.\n   *\n   * @param stringToEncode - The string to encode (must contain only Latin1 characters)\n   * @returns The Base64 encoded string\n   * @throws DOMException if the string contains characters outside Latin1 range (0-255)\n   *\n   * @example\n   * btoa(\"Hello\"); // \"SGVsbG8=\"\n   */\n  function btoa(stringToEncode: string): string;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-timers globals.\n *\n * Includes: setTimeout, setInterval, clearTimeout, clearInterval\n */\nexport const TIMERS_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-timers\n *\n * These types define the globals injected by setupTimers() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * const timeoutId = setTimeout(() => {\n *   console.log(\"fired!\");\n * }, 1000);\n *\n * clearTimeout(timeoutId);\n *\n * const intervalId = setInterval(() => {\n *   console.log(\"tick\");\n * }, 100);\n *\n * clearInterval(intervalId);\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Schedule a callback to execute after a delay.\n   *\n   * @param callback - The function to call after the delay\n   * @param ms - The delay in milliseconds (default: 0)\n   * @param args - Additional arguments to pass to the callback\n   * @returns A timer ID that can be passed to clearTimeout\n   *\n   * @example\n   * const id = setTimeout(() => console.log(\"done\"), 1000);\n   * setTimeout((a, b) => console.log(a, b), 100, \"hello\", \"world\");\n   */\n  function setTimeout(\n    callback: (...args: unknown[]) => void,\n    ms?: number,\n    ...args: unknown[]\n  ): number;\n\n  /**\n   * Schedule a callback to execute repeatedly at a fixed interval.\n   *\n   * @param callback - The function to call at each interval\n   * @param ms - The interval in milliseconds (minimum: 4ms)\n   * @param args - Additional arguments to pass to the callback\n   * @returns A timer ID that can be passed to clearInterval\n   *\n   * @example\n   * const id = setInterval(() => console.log(\"tick\"), 1000);\n   */\n  function setInterval(\n    callback: (...args: unknown[]) => void,\n    ms?: number,\n    ...args: unknown[]\n  ): number;\n\n  /**\n   * Cancel a timeout previously scheduled with setTimeout.\n   *\n   * @param id - The timer ID returned by setTimeout\n   *\n   * @example\n   * const id = setTimeout(() => {}, 1000);\n   * clearTimeout(id);\n   */\n  function clearTimeout(id: number | undefined): void;\n\n  /**\n   * Cancel an interval previously scheduled with setInterval.\n   *\n   * @param id - The timer ID returned by setInterval\n   *\n   * @example\n   * const id = setInterval(() => {}, 1000);\n   * clearInterval(id);\n   */\n  function clearInterval(id: number | undefined): void;\n}\n`;\n\n/**\n * Map of package names to their type definitions.\n */\nexport const TYPE_DEFINITIONS = {\n  core: CORE_TYPES,\n  console: CONSOLE_TYPES,\n  encoding: ENCODING_TYPES,\n  fetch: FETCH_TYPES,\n  fs: FS_TYPES,\n  testEnvironment: TEST_ENV_TYPES,\n  timers: TIMERS_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;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;AA+RvB,IAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0ItB,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;AAuCvB,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA,EACV,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,iBAAiB;AACnB;",
-  "debugId": "22216BE3C74E0DC864756E2164756E21",
+  "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;AA+RvB,IAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0ItB,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;AAyCvB,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqFrB,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA,EACV,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,iBAAiB;AAAA,EACjB,QAAQ;AACV;",
+  "debugId": "DA5F861495C9A88164756E2164756E21",
   "names": []
 }

package/dist/cjs/typecheck.cjs

@@ -50,24 +50,39 @@ function getMessageText(messageText) {
 }
 function typecheckQuickJSCode(code, options) {
   const include = options?.include ?? ["core", "fetch", "fs"];
+  const libraryTypes = options?.libraryTypes ?? {};
+  const hasLibraries = Object.keys(libraryTypes).length > 0;
   const project = new import_ts_morph.Project({
     useInMemoryFileSystem: true,
     compilerOptions: {
       target: import_ts_morph.ts.ScriptTarget.ESNext,
       module: import_ts_morph.ts.ModuleKind.ESNext,
+      moduleResolution: hasLibraries ? import_ts_morph.ts.ModuleResolutionKind.NodeJs : undefined,
       lib: ["lib.esnext.d.ts", "lib.dom.d.ts"],
       strict: true,
       noEmit: true,
       skipLibCheck: true,
+      esModuleInterop: true,
+      allowSyntheticDefaultImports: true,
       ...options?.compilerOptions
     }
   });
+  const memFs = project.getFileSystem();
   for (const pkg of include) {
     const content = import_quickjs_types.TYPE_DEFINITIONS[pkg];
     if (content) {
       project.createSourceFile(`${pkg}.d.ts`, content);
     }
   }
+  for (const [_libName, lib] of Object.entries(libraryTypes)) {
+    for (const typeFile of lib.files) {
+      if (typeFile.path.endsWith(".json")) {
+        memFs.writeFileSync(`/${typeFile.path}`, typeFile.content);
+      } else {
+        project.createSourceFile(`/${typeFile.path}`, typeFile.content, { overwrite: true });
+      }
+    }
+  }
   const sourceFile = project.createSourceFile("usercode.ts", code);
   const diagnostics = sourceFile.getPreEmitDiagnostics();
   const errors = diagnostics.map((diagnostic) => {
@@ -105,4 +120,4 @@ function formatTypecheckErrors(result) {
 }
 })
 
-//# debugId=F7ABA26F8C307CC164756E2164756E21
+//# debugId=2601D9163BE39B0C64756E2164756E21

package/dist/cjs/typecheck.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/typecheck.ts"],
   "sourcesContent": [
-    "/**\n * Type-checking utility for QuickJS user code using ts-morph.\n *\n * This utility allows you to validate TypeScript code strings against\n * the QuickJS global type definitions before running them in the sandbox.\n *\n * @example\n * import { typecheckQuickJSCode } from \"@ricsam/quickjs-test-utils\";\n *\n * const result = typecheckQuickJSCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `, { include: [\"fetch\"] });\n *\n * if (!result.success) {\n *   console.error(\"Type errors:\", result.errors);\n * }\n */\n\nimport { Project, ts } from \"ts-morph\";\nimport { TYPE_DEFINITIONS, type TypeDefinitionKey } from \"./quickjs-types.cjs\";\n\n/**\n * Result of type-checking QuickJS code.\n */\nexport interface TypecheckResult {\n  /**\n   * Whether the code passed type checking.\n   */\n  success: boolean;\n\n  /**\n   * Array of type errors found in the code.\n   */\n  errors: TypecheckError[];\n}\n\n/**\n * A single type-checking error.\n */\nexport interface TypecheckError {\n  /**\n   * The error message from TypeScript.\n   */\n  message: string;\n\n  /**\n   * The line number where the error occurred (1-indexed).\n   */\n  line?: number;\n\n  /**\n   * The column number where the error occurred (1-indexed).\n   */\n  column?: number;\n\n  /**\n   * The TypeScript error code.\n   */\n  code?: number;\n}\n\n/**\n * Options for type-checking QuickJS code.\n */\nexport interface TypecheckOptions {\n  /**\n   * Which package types to include.\n   * @default [\"core\", \"fetch\", \"fs\"]\n   */\n  include?: Array<\"core\" | \"fetch\" | \"fs\">;\n\n  /**\n   * Additional compiler options to pass to TypeScript.\n   */\n  compilerOptions?: Partial<ts.CompilerOptions>;\n}\n\n/**\n * Get the message text from a TypeScript diagnostic message.\n * Handles both string messages and DiagnosticMessageChain objects.\n */\nfunction getMessageText(messageText: unknown): string {\n  if (typeof messageText === \"string\") {\n    return messageText;\n  }\n\n  // Handle ts-morph DiagnosticMessageChain wrapper\n  if (\n    messageText &&\n    typeof messageText === \"object\" &&\n    \"getMessageText\" in messageText &&\n    typeof (messageText as { getMessageText: unknown }).getMessageText ===\n      \"function\"\n  ) {\n    return (messageText as { getMessageText: () => string }).getMessageText();\n  }\n\n  // Handle raw TypeScript DiagnosticMessageChain\n  if (\n    messageText &&\n    typeof messageText === \"object\" &&\n    \"messageText\" in messageText\n  ) {\n    return String((messageText as { messageText: unknown }).messageText);\n  }\n\n  return String(messageText);\n}\n\n\n/**\n * Type-check QuickJS user code against the package type definitions.\n *\n * @param code - The TypeScript/JavaScript code to check\n * @param options - Configuration options\n * @returns The result of type checking\n *\n * @example\n * // Check code that uses the fetch API\n * const result = typecheckQuickJSCode(`\n *   const response = await fetch(\"https://api.example.com/data\");\n *   const data = await response.json();\n * `, { include: [\"core\", \"fetch\"] });\n *\n * @example\n * // Check code that uses serve()\n * const result = typecheckQuickJSCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `, { include: [\"fetch\"] });\n *\n * @example\n * // Check code that uses the file system API\n * const result = typecheckQuickJSCode(`\n *   const root = await fs.getDirectory(\"/data\");\n *   const file = await root.getFileHandle(\"config.json\");\n * `, { include: [\"core\", \"fs\"] });\n */\nexport function typecheckQuickJSCode(\n  code: string,\n  options?: TypecheckOptions\n): TypecheckResult {\n  const include = options?.include ?? [\"core\", \"fetch\", \"fs\"];\n\n  // Create a project with in-memory file system\n  const project = new Project({\n    useInMemoryFileSystem: true,\n    compilerOptions: {\n      target: ts.ScriptTarget.ESNext,\n      module: ts.ModuleKind.ESNext,\n      lib: [\"lib.esnext.d.ts\", \"lib.dom.d.ts\"],\n      strict: true,\n      noEmit: true,\n      skipLibCheck: true,\n      ...options?.compilerOptions,\n    },\n  });\n\n  // Add type definition files from embedded strings\n  for (const pkg of include) {\n    const content = TYPE_DEFINITIONS[pkg as TypeDefinitionKey];\n    if (content) {\n      project.createSourceFile(`${pkg}.d.ts`, content);\n    }\n  }\n\n  // Add the user code\n  const sourceFile = project.createSourceFile(\"usercode.ts\", code);\n\n  // Get diagnostics\n  const diagnostics = sourceFile.getPreEmitDiagnostics();\n\n  // Convert diagnostics to our error format\n  const errors: TypecheckError[] = diagnostics.map((diagnostic) => {\n    const start = diagnostic.getStart();\n    const sourceFile = diagnostic.getSourceFile();\n\n    let line: number | undefined;\n    let column: number | undefined;\n\n    if (start !== undefined && sourceFile) {\n      const lineAndChar = sourceFile.getLineAndColumnAtPos(start);\n      line = lineAndChar.line;\n      column = lineAndChar.column;\n    }\n\n    return {\n      message: getMessageText(diagnostic.getMessageText()),\n      line,\n      column,\n      code: diagnostic.getCode(),\n    };\n  });\n\n  return {\n    success: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Format type-check errors for display.\n *\n * @param result - The type-check result\n * @returns A formatted string of errors\n *\n * @example\n * const result = typecheckQuickJSCode(code);\n * if (!result.success) {\n *   console.error(formatTypecheckErrors(result));\n * }\n */\nexport function formatTypecheckErrors(result: TypecheckResult): string {\n  if (result.success) {\n    return \"No type errors found.\";\n  }\n\n  return result.errors\n    .map((error) => {\n      const location =\n        error.line !== undefined ? `:${error.line}:${error.column ?? 1}` : \"\";\n      const code = error.code ? ` (TS${error.code})` : \"\";\n      return `usercode.ts${location}${code}: ${error.message}`;\n    })\n    .join(\"\\n\");\n}\n"
+    "/**\n * Type-checking utility for QuickJS user code using ts-morph.\n *\n * This utility allows you to validate TypeScript code strings against\n * the QuickJS global type definitions before running them in the sandbox.\n *\n * @example\n * import { typecheckQuickJSCode } from \"@ricsam/quickjs-test-utils\";\n *\n * const result = typecheckQuickJSCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `, { include: [\"fetch\"] });\n *\n * if (!result.success) {\n *   console.error(\"Type errors:\", result.errors);\n * }\n */\n\nimport { Project, ts } from \"ts-morph\";\nimport { TYPE_DEFINITIONS, type TypeDefinitionKey } from \"./quickjs-types.cjs\";\n\n/**\n * Result of type-checking QuickJS code.\n */\nexport interface TypecheckResult {\n  /**\n   * Whether the code passed type checking.\n   */\n  success: boolean;\n\n  /**\n   * Array of type errors found in the code.\n   */\n  errors: TypecheckError[];\n}\n\n/**\n * A single type-checking error.\n */\nexport interface TypecheckError {\n  /**\n   * The error message from TypeScript.\n   */\n  message: string;\n\n  /**\n   * The line number where the error occurred (1-indexed).\n   */\n  line?: number;\n\n  /**\n   * The column number where the error occurred (1-indexed).\n   */\n  column?: number;\n\n  /**\n   * The TypeScript error code.\n   */\n  code?: number;\n}\n\n/**\n * A single library type file to inject into the virtual file system.\n */\nexport interface LibraryTypeFile {\n  /** The file content (e.g., .d.ts or package.json content) */\n  content: string;\n  /** The virtual path (e.g., \"node_modules/zod/index.d.ts\") */\n  path: string;\n}\n\n/**\n * Library types bundle for a single package.\n */\nexport interface LibraryTypes {\n  files: LibraryTypeFile[];\n}\n\n/**\n * Options for type-checking QuickJS code.\n */\nexport interface TypecheckOptions {\n  /**\n   * Which QuickJS global types to include.\n   * @default [\"core\", \"fetch\", \"fs\"]\n   */\n  include?: Array<\"core\" | \"fetch\" | \"fs\" | \"console\" | \"encoding\" | \"timers\" | \"testEnvironment\">;\n\n  /**\n   * Library type definitions to inject for import resolution.\n   * These are added to the virtual node_modules/ for module resolution.\n   *\n   * Use the build-library-types.ts script to generate these bundles from\n   * your project's node_modules, then pass them here.\n   *\n   * @example\n   * import { LIBRARY_TYPES } from \"./my-library-types.cjs\";\n   *\n   * typecheckQuickJSCode(code, {\n   *   libraryTypes: {\n   *     zod: LIBRARY_TYPES.zod,\n   *     \"@richie-rpc/core\": LIBRARY_TYPES[\"@richie-rpc/core\"],\n   *   }\n   * });\n   */\n  libraryTypes?: Record<string, LibraryTypes>;\n\n  /**\n   * Additional compiler options to pass to TypeScript.\n   */\n  compilerOptions?: Partial<ts.CompilerOptions>;\n}\n\n/**\n * Get the message text from a TypeScript diagnostic message.\n * Handles both string messages and DiagnosticMessageChain objects.\n */\nfunction getMessageText(messageText: unknown): string {\n  if (typeof messageText === \"string\") {\n    return messageText;\n  }\n\n  // Handle ts-morph DiagnosticMessageChain wrapper\n  if (\n    messageText &&\n    typeof messageText === \"object\" &&\n    \"getMessageText\" in messageText &&\n    typeof (messageText as { getMessageText: unknown }).getMessageText ===\n      \"function\"\n  ) {\n    return (messageText as { getMessageText: () => string }).getMessageText();\n  }\n\n  // Handle raw TypeScript DiagnosticMessageChain\n  if (\n    messageText &&\n    typeof messageText === \"object\" &&\n    \"messageText\" in messageText\n  ) {\n    return String((messageText as { messageText: unknown }).messageText);\n  }\n\n  return String(messageText);\n}\n\n\n/**\n * Type-check QuickJS user code against the package type definitions.\n *\n * @param code - The TypeScript/JavaScript code to check\n * @param options - Configuration options\n * @returns The result of type checking\n *\n * @example\n * // Check code that uses the fetch API\n * const result = typecheckQuickJSCode(`\n *   const response = await fetch(\"https://api.example.com/data\");\n *   const data = await response.json();\n * `, { include: [\"core\", \"fetch\"] });\n *\n * @example\n * // Check code that uses serve()\n * const result = typecheckQuickJSCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `, { include: [\"fetch\"] });\n *\n * @example\n * // Check code that uses the file system API\n * const result = typecheckQuickJSCode(`\n *   const root = await fs.getDirectory(\"/data\");\n *   const file = await root.getFileHandle(\"config.json\");\n * `, { include: [\"core\", \"fs\"] });\n */\nexport function typecheckQuickJSCode(\n  code: string,\n  options?: TypecheckOptions\n): TypecheckResult {\n  const include = options?.include ?? [\"core\", \"fetch\", \"fs\"];\n  const libraryTypes = options?.libraryTypes ?? {};\n  const hasLibraries = Object.keys(libraryTypes).length > 0;\n\n  // Create a project with in-memory file system\n  const project = new Project({\n    useInMemoryFileSystem: true,\n    compilerOptions: {\n      target: ts.ScriptTarget.ESNext,\n      module: ts.ModuleKind.ESNext,\n      // Use NodeJs resolution for node_modules/ lookup when libraries are included\n      moduleResolution: hasLibraries\n        ? ts.ModuleResolutionKind.NodeJs\n        : undefined,\n      lib: [\"lib.esnext.d.ts\", \"lib.dom.d.ts\"],\n      strict: true,\n      noEmit: true,\n      skipLibCheck: true,\n      esModuleInterop: true,\n      allowSyntheticDefaultImports: true,\n      ...options?.compilerOptions,\n    },\n  });\n\n  const memFs = project.getFileSystem();\n\n  // Add type definition files from embedded strings (QuickJS globals)\n  for (const pkg of include) {\n    const content = TYPE_DEFINITIONS[pkg as TypeDefinitionKey];\n    if (content) {\n      project.createSourceFile(`${pkg}.d.ts`, content);\n    }\n  }\n\n  // Add library type definitions to virtual node_modules/\n  for (const [_libName, lib] of Object.entries(libraryTypes)) {\n    for (const typeFile of lib.files) {\n      // JSON files go to file system, TS files as source files\n      if (typeFile.path.endsWith(\".json\")) {\n        memFs.writeFileSync(`/${typeFile.path}`, typeFile.content);\n      } else {\n        project.createSourceFile(`/${typeFile.path}`, typeFile.content, { overwrite: true });\n      }\n    }\n  }\n\n  // Add the user code\n  const sourceFile = project.createSourceFile(\"usercode.ts\", code);\n\n  // Get diagnostics\n  const diagnostics = sourceFile.getPreEmitDiagnostics();\n\n  // Convert diagnostics to our error format\n  const errors: TypecheckError[] = diagnostics.map((diagnostic) => {\n    const start = diagnostic.getStart();\n    const sourceFile = diagnostic.getSourceFile();\n\n    let line: number | undefined;\n    let column: number | undefined;\n\n    if (start !== undefined && sourceFile) {\n      const lineAndChar = sourceFile.getLineAndColumnAtPos(start);\n      line = lineAndChar.line;\n      column = lineAndChar.column;\n    }\n\n    return {\n      message: getMessageText(diagnostic.getMessageText()),\n      line,\n      column,\n      code: diagnostic.getCode(),\n    };\n  });\n\n  return {\n    success: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Format type-check errors for display.\n *\n * @param result - The type-check result\n * @returns A formatted string of errors\n *\n * @example\n * const result = typecheckQuickJSCode(code);\n * if (!result.success) {\n *   console.error(formatTypecheckErrors(result));\n * }\n */\nexport function formatTypecheckErrors(result: TypecheckResult): string {\n  if (result.success) {\n    return \"No type errors found.\";\n  }\n\n  return result.errors\n    .map((error) => {\n      const location =\n        error.line !== undefined ? `:${error.line}:${error.column ?? 1}` : \"\";\n      const code = error.code ? ` (TS${error.code})` : \"\";\n      return `usercode.ts${location}${code}: ${error.message}`;\n    })\n    .join(\"\\n\");\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsB4B,IAA5B;AACyD,IAAzD;AA8DA,SAAS,cAAc,CAAC,aAA8B;AAAA,EACpD,IAAI,OAAO,gBAAgB,UAAU;AAAA,IACnC,OAAO;AAAA,EACT;AAAA,EAGA,IACE,eACA,OAAO,gBAAgB,YACvB,oBAAoB,eACpB,OAAQ,YAA4C,mBAClD,YACF;AAAA,IACA,OAAQ,YAAiD,eAAe;AAAA,EAC1E;AAAA,EAGA,IACE,eACA,OAAO,gBAAgB,YACvB,iBAAiB,aACjB;AAAA,IACA,OAAO,OAAQ,YAAyC,WAAW;AAAA,EACrE;AAAA,EAEA,OAAO,OAAO,WAAW;AAAA;AAmCpB,SAAS,oBAAoB,CAClC,MACA,SACiB;AAAA,EACjB,MAAM,UAAU,SAAS,WAAW,CAAC,QAAQ,SAAS,IAAI;AAAA,EAG1D,MAAM,UAAU,IAAI,wBAAQ;AAAA,IAC1B,uBAAuB;AAAA,IACvB,iBAAiB;AAAA,MACf,QAAQ,mBAAG,aAAa;AAAA,MACxB,QAAQ,mBAAG,WAAW;AAAA,MACtB,KAAK,CAAC,mBAAmB,cAAc;AAAA,MACvC,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,cAAc;AAAA,SACX,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AAAA,EAGD,WAAW,OAAO,SAAS;AAAA,IACzB,MAAM,UAAU,sCAAiB;AAAA,IACjC,IAAI,SAAS;AAAA,MACX,QAAQ,iBAAiB,GAAG,YAAY,OAAO;AAAA,IACjD;AAAA,EACF;AAAA,EAGA,MAAM,aAAa,QAAQ,iBAAiB,eAAe,IAAI;AAAA,EAG/D,MAAM,cAAc,WAAW,sBAAsB;AAAA,EAGrD,MAAM,SAA2B,YAAY,IAAI,CAAC,eAAe;AAAA,IAC/D,MAAM,QAAQ,WAAW,SAAS;AAAA,IAClC,MAAM,cAAa,WAAW,cAAc;AAAA,IAE5C,IAAI;AAAA,IACJ,IAAI;AAAA,IAEJ,IAAI,UAAU,aAAa,aAAY;AAAA,MACrC,MAAM,cAAc,YAAW,sBAAsB,KAAK;AAAA,MAC1D,OAAO,YAAY;AAAA,MACnB,SAAS,YAAY;AAAA,IACvB;AAAA,IAEA,OAAO;AAAA,MACL,SAAS,eAAe,WAAW,eAAe,CAAC;AAAA,MACnD;AAAA,MACA;AAAA,MACA,MAAM,WAAW,QAAQ;AAAA,IAC3B;AAAA,GACD;AAAA,EAED,OAAO;AAAA,IACL,SAAS,OAAO,WAAW;AAAA,IAC3B;AAAA,EACF;AAAA;AAeK,SAAS,qBAAqB,CAAC,QAAiC;AAAA,EACrE,IAAI,OAAO,SAAS;AAAA,IAClB,OAAO;AAAA,EACT;AAAA,EAEA,OAAO,OAAO,OACX,IAAI,CAAC,UAAU;AAAA,IACd,MAAM,WACJ,MAAM,SAAS,YAAY,IAAI,MAAM,QAAQ,MAAM,UAAU,MAAM;AAAA,IACrE,MAAM,OAAO,MAAM,OAAO,OAAO,MAAM,UAAU;AAAA,IACjD,OAAO,cAAc,WAAW,SAAS,MAAM;AAAA,GAChD,EACA,KAAK;AAAA,CAAI;AAAA;",
-  "debugId": "F7ABA26F8C307CC164756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsB4B,IAA5B;AACyD,IAAzD;AAkGA,SAAS,cAAc,CAAC,aAA8B;AAAA,EACpD,IAAI,OAAO,gBAAgB,UAAU;AAAA,IACnC,OAAO;AAAA,EACT;AAAA,EAGA,IACE,eACA,OAAO,gBAAgB,YACvB,oBAAoB,eACpB,OAAQ,YAA4C,mBAClD,YACF;AAAA,IACA,OAAQ,YAAiD,eAAe;AAAA,EAC1E;AAAA,EAGA,IACE,eACA,OAAO,gBAAgB,YACvB,iBAAiB,aACjB;AAAA,IACA,OAAO,OAAQ,YAAyC,WAAW;AAAA,EACrE;AAAA,EAEA,OAAO,OAAO,WAAW;AAAA;AAmCpB,SAAS,oBAAoB,CAClC,MACA,SACiB;AAAA,EACjB,MAAM,UAAU,SAAS,WAAW,CAAC,QAAQ,SAAS,IAAI;AAAA,EAC1D,MAAM,eAAe,SAAS,gBAAgB,CAAC;AAAA,EAC/C,MAAM,eAAe,OAAO,KAAK,YAAY,EAAE,SAAS;AAAA,EAGxD,MAAM,UAAU,IAAI,wBAAQ;AAAA,IAC1B,uBAAuB;AAAA,IACvB,iBAAiB;AAAA,MACf,QAAQ,mBAAG,aAAa;AAAA,MACxB,QAAQ,mBAAG,WAAW;AAAA,MAEtB,kBAAkB,eACd,mBAAG,qBAAqB,SACxB;AAAA,MACJ,KAAK,CAAC,mBAAmB,cAAc;AAAA,MACvC,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,8BAA8B;AAAA,SAC3B,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AAAA,EAED,MAAM,QAAQ,QAAQ,cAAc;AAAA,EAGpC,WAAW,OAAO,SAAS;AAAA,IACzB,MAAM,UAAU,sCAAiB;AAAA,IACjC,IAAI,SAAS;AAAA,MACX,QAAQ,iBAAiB,GAAG,YAAY,OAAO;AAAA,IACjD;AAAA,EACF;AAAA,EAGA,YAAY,UAAU,QAAQ,OAAO,QAAQ,YAAY,GAAG;AAAA,IAC1D,WAAW,YAAY,IAAI,OAAO;AAAA,MAEhC,IAAI,SAAS,KAAK,SAAS,OAAO,GAAG;AAAA,QACnC,MAAM,cAAc,IAAI,SAAS,QAAQ,SAAS,OAAO;AAAA,MAC3D,EAAO;AAAA,QACL,QAAQ,iBAAiB,IAAI,SAAS,QAAQ,SAAS,SAAS,EAAE,WAAW,KAAK,CAAC;AAAA;AAAA,IAEvF;AAAA,EACF;AAAA,EAGA,MAAM,aAAa,QAAQ,iBAAiB,eAAe,IAAI;AAAA,EAG/D,MAAM,cAAc,WAAW,sBAAsB;AAAA,EAGrD,MAAM,SAA2B,YAAY,IAAI,CAAC,eAAe;AAAA,IAC/D,MAAM,QAAQ,WAAW,SAAS;AAAA,IAClC,MAAM,cAAa,WAAW,cAAc;AAAA,IAE5C,IAAI;AAAA,IACJ,IAAI;AAAA,IAEJ,IAAI,UAAU,aAAa,aAAY;AAAA,MACrC,MAAM,cAAc,YAAW,sBAAsB,KAAK;AAAA,MAC1D,OAAO,YAAY;AAAA,MACnB,SAAS,YAAY;AAAA,IACvB;AAAA,IAEA,OAAO;AAAA,MACL,SAAS,eAAe,WAAW,eAAe,CAAC;AAAA,MACnD;AAAA,MACA;AAAA,MACA,MAAM,WAAW,QAAQ;AAAA,IAC3B;AAAA,GACD;AAAA,EAED,OAAO;AAAA,IACL,SAAS,OAAO,WAAW;AAAA,IAC3B;AAAA,EACF;AAAA;AAeK,SAAS,qBAAqB,CAAC,QAAiC;AAAA,EACrE,IAAI,OAAO,SAAS;AAAA,IAClB,OAAO;AAAA,EACT;AAAA,EAEA,OAAO,OAAO,OACX,IAAI,CAAC,UAAU;AAAA,IACd,MAAM,WACJ,MAAM,SAAS,YAAY,IAAI,MAAM,QAAQ,MAAM,UAAU,MAAM;AAAA,IACrE,MAAM,OAAO,MAAM,OAAO,OAAO,MAAM,UAAU;AAAA,IACjD,OAAO,cAAc,WAAW,SAAS,MAAM;AAAA,GAChD,EACA,KAAK;AAAA,CAAI;AAAA;",
+  "debugId": "2601D9163BE39B0C64756E2164756E21",
   "names": []
 }

package/dist/mjs/index.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/index.ts"],
   "sourcesContent": [
-    "export {\n  createTestContext,\n  disposeTestContext,\n  useTestContext,\n  type TestContext,\n} from \"./context.mjs\";\n\nexport {\n  createFetchTestContext,\n  disposeFetchTestContext,\n  useFetchTestContext,\n  type FetchTestContext,\n  type CreateFetchTestContextOptions,\n} from \"./fetch-context.mjs\";\n\nexport { evalCode, evalCodeAsync } from \"./eval.mjs\";\n\nexport {\n  startIntegrationServer,\n  type IntegrationTestServer,\n  type StartIntegrationServerOptions,\n} from \"./integration-server.mjs\";\n\nexport {\n  typecheckQuickJSCode,\n  formatTypecheckErrors,\n  type TypecheckResult,\n  type TypecheckError,\n  type TypecheckOptions,\n} from \"./typecheck.mjs\";\n\nexport {\n  CORE_TYPES,\n  FETCH_TYPES,\n  FS_TYPES,\n  TYPE_DEFINITIONS,\n  type TypeDefinitionKey,\n} from \"./quickjs-types.mjs\";\n\n// For fs and runtime contexts, import from subpaths:\n// import { createFsTestContext } from \"@ricsam/quickjs-test-utils/fs\";\n// import { createRuntimeTestContext } from \"@ricsam/quickjs-test-utils/runtime\";\n"
+    "export {\n  createTestContext,\n  disposeTestContext,\n  useTestContext,\n  type TestContext,\n} from \"./context.mjs\";\n\nexport {\n  createFetchTestContext,\n  disposeFetchTestContext,\n  useFetchTestContext,\n  type FetchTestContext,\n  type CreateFetchTestContextOptions,\n} from \"./fetch-context.mjs\";\n\nexport { evalCode, evalCodeAsync } from \"./eval.mjs\";\n\nexport {\n  startIntegrationServer,\n  type IntegrationTestServer,\n  type StartIntegrationServerOptions,\n} from \"./integration-server.mjs\";\n\nexport {\n  typecheckQuickJSCode,\n  formatTypecheckErrors,\n  type TypecheckResult,\n  type TypecheckError,\n  type TypecheckOptions,\n  type LibraryTypes,\n  type LibraryTypeFile,\n} from \"./typecheck.mjs\";\n\nexport {\n  CORE_TYPES,\n  FETCH_TYPES,\n  FS_TYPES,\n  TYPE_DEFINITIONS,\n  type TypeDefinitionKey,\n} from \"./quickjs-types.mjs\";\n\n// For fs and runtime contexts, import from subpaths:\n// import { createFsTestContext } from \"@ricsam/quickjs-test-utils/fs\";\n// import { createRuntimeTestContext } from \"@ricsam/quickjs-test-utils/runtime\";\n"
   ],
-  "mappings": ";;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA;AAAA;AAAA;AAAA;AAAA;AAQA;AAEA;AAAA;AAAA;AAMA;AAAA;AAAA;AAAA;AAQA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "mappings": ";;AAAA;AAAA;AAAA;AAAA;AAAA;AAOA;AAAA;AAAA;AAAA;AAAA;AAQA;AAEA;AAAA;AAAA;AAMA;AAAA;AAAA;AAAA;AAUA;AAAA;AAAA;AAAA;AAAA;AAAA;",
   "debugId": "E7F326004DCE839564756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

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

package/dist/mjs/quickjs-types.mjs

@@ -1102,16 +1102,99 @@ declare global {
   function btoa(stringToEncode: string): string;
 }
 `;
+var TIMERS_TYPES = `/**
+ * QuickJS Global Type Definitions for @ricsam/quickjs-timers
+ *
+ * These types define the globals injected by setupTimers() into a QuickJS context.
+ * Use these types to typecheck user code that will run inside QuickJS.
+ *
+ * @example
+ * const timeoutId = setTimeout(() => {
+ *   console.log("fired!");
+ * }, 1000);
+ *
+ * clearTimeout(timeoutId);
+ *
+ * const intervalId = setInterval(() => {
+ *   console.log("tick");
+ * }, 100);
+ *
+ * clearInterval(intervalId);
+ */
+
+export {};
+
+declare global {
+  /**
+   * Schedule a callback to execute after a delay.
+   *
+   * @param callback - The function to call after the delay
+   * @param ms - The delay in milliseconds (default: 0)
+   * @param args - Additional arguments to pass to the callback
+   * @returns A timer ID that can be passed to clearTimeout
+   *
+   * @example
+   * const id = setTimeout(() => console.log("done"), 1000);
+   * setTimeout((a, b) => console.log(a, b), 100, "hello", "world");
+   */
+  function setTimeout(
+    callback: (...args: unknown[]) => void,
+    ms?: number,
+    ...args: unknown[]
+  ): number;
+
+  /**
+   * Schedule a callback to execute repeatedly at a fixed interval.
+   *
+   * @param callback - The function to call at each interval
+   * @param ms - The interval in milliseconds (minimum: 4ms)
+   * @param args - Additional arguments to pass to the callback
+   * @returns A timer ID that can be passed to clearInterval
+   *
+   * @example
+   * const id = setInterval(() => console.log("tick"), 1000);
+   */
+  function setInterval(
+    callback: (...args: unknown[]) => void,
+    ms?: number,
+    ...args: unknown[]
+  ): number;
+
+  /**
+   * Cancel a timeout previously scheduled with setTimeout.
+   *
+   * @param id - The timer ID returned by setTimeout
+   *
+   * @example
+   * const id = setTimeout(() => {}, 1000);
+   * clearTimeout(id);
+   */
+  function clearTimeout(id: number | undefined): void;
+
+  /**
+   * Cancel an interval previously scheduled with setInterval.
+   *
+   * @param id - The timer ID returned by setInterval
+   *
+   * @example
+   * const id = setInterval(() => {}, 1000);
+   * clearInterval(id);
+   */
+  function clearInterval(id: number | undefined): void;
+}
+`;
 var TYPE_DEFINITIONS = {
   core: CORE_TYPES,
   console: CONSOLE_TYPES,
   encoding: ENCODING_TYPES,
   fetch: FETCH_TYPES,
   fs: FS_TYPES,
-  testEnvironment: TEST_ENV_TYPES
+  testEnvironment: TEST_ENV_TYPES,
+  timers: TIMERS_TYPES
 };
 export {
   TYPE_DEFINITIONS,
+  TIMERS_TYPES,
   TEST_ENV_TYPES,
   FS_TYPES,
   FETCH_TYPES,
@@ -1120,4 +1203,4 @@ export {
   CONSOLE_TYPES
 };
 
-//# debugId=CEEE9AD03E866EA164756E2164756E21
+//# debugId=E2CFF2AC657B42E964756E2164756E21

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 * 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 * Type definitions for @ricsam/quickjs-console globals.\n *\n * Includes: console.log, warn, error, debug, info, trace, dir, table, time, timeEnd, timeLog, count, countReset, clear, assert, group, groupCollapsed, groupEnd\n */\nexport const CONSOLE_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-console\n *\n * These types define the globals injected by setupConsole() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Console interface for logging and debugging.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Console\n   */\n  interface Console {\n    /**\n     * Log a message to the console.\n     * @param data - Values to log\n     */\n    log(...data: unknown[]): void;\n\n    /**\n     * Log a warning message.\n     * @param data - Values to log\n     */\n    warn(...data: unknown[]): void;\n\n    /**\n     * Log an error message.\n     * @param data - Values to log\n     */\n    error(...data: unknown[]): void;\n\n    /**\n     * Log a debug message.\n     * @param data - Values to log\n     */\n    debug(...data: unknown[]): void;\n\n    /**\n     * Log an info message.\n     * @param data - Values to log\n     */\n    info(...data: unknown[]): void;\n\n    /**\n     * Log a stack trace.\n     * @param data - Values to log with the trace\n     */\n    trace(...data: unknown[]): void;\n\n    /**\n     * Display an object in a formatted way.\n     * @param item - Object to display\n     * @param options - Display options\n     */\n    dir(item: unknown, options?: object): void;\n\n    /**\n     * Display tabular data.\n     * @param tabularData - Data to display as a table\n     * @param properties - Optional array of property names to include\n     */\n    table(tabularData: unknown, properties?: string[]): void;\n\n    /**\n     * Start a timer.\n     * @param label - Timer label (default: \"default\")\n     */\n    time(label?: string): void;\n\n    /**\n     * End a timer and log the elapsed time.\n     * @param label - Timer label (default: \"default\")\n     */\n    timeEnd(label?: string): void;\n\n    /**\n     * Log the elapsed time of a timer without ending it.\n     * @param label - Timer label (default: \"default\")\n     * @param data - Additional values to log\n     */\n    timeLog(label?: string, ...data: unknown[]): void;\n\n    /**\n     * Log an error if the assertion is false.\n     * @param condition - Condition to test\n     * @param data - Values to log if assertion fails\n     */\n    assert(condition?: boolean, ...data: unknown[]): void;\n\n    /**\n     * Increment and log a counter.\n     * @param label - Counter label (default: \"default\")\n     */\n    count(label?: string): void;\n\n    /**\n     * Reset a counter.\n     * @param label - Counter label (default: \"default\")\n     */\n    countReset(label?: string): void;\n\n    /**\n     * Clear the console.\n     */\n    clear(): void;\n\n    /**\n     * Start an inline group.\n     * @param data - Group label\n     */\n    group(...data: unknown[]): void;\n\n    /**\n     * Start a collapsed inline group.\n     * @param data - Group label\n     */\n    groupCollapsed(...data: unknown[]): void;\n\n    /**\n     * End the current inline group.\n     */\n    groupEnd(): void;\n  }\n\n  /**\n   * Console object for logging and debugging.\n   */\n  const console: Console;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-encoding globals.\n *\n * Includes: atob, btoa\n */\nexport const ENCODING_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-encoding\n *\n * These types define the globals injected by setupEncoding() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Decodes a Base64-encoded string.\n   *\n   * @param encodedData - The Base64 string to decode\n   * @returns The decoded string\n   * @throws DOMException if the input is not valid Base64\n   *\n   * @example\n   * atob(\"SGVsbG8=\"); // \"Hello\"\n   */\n  function atob(encodedData: string): string;\n\n  /**\n   * Encodes a string to Base64.\n   *\n   * @param stringToEncode - The string to encode (must contain only Latin1 characters)\n   * @returns The Base64 encoded string\n   * @throws DOMException if the string contains characters outside Latin1 range (0-255)\n   *\n   * @example\n   * btoa(\"Hello\"); // \"SGVsbG8=\"\n   */\n  function btoa(stringToEncode: string): string;\n}\n`;\n\n/**\n * Map of package names to their type definitions.\n */\nexport const TYPE_DEFINITIONS = {\n  core: CORE_TYPES,\n  console: CONSOLE_TYPES,\n  encoding: ENCODING_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"
+    "/**\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 * Type definitions for @ricsam/quickjs-console globals.\n *\n * Includes: console.log, warn, error, debug, info, trace, dir, table, time, timeEnd, timeLog, count, countReset, clear, assert, group, groupCollapsed, groupEnd\n */\nexport const CONSOLE_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-console\n *\n * These types define the globals injected by setupConsole() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Console interface for logging and debugging.\n   * @see https://developer.mozilla.org/en-US/docs/Web/API/Console\n   */\n  interface Console {\n    /**\n     * Log a message to the console.\n     * @param data - Values to log\n     */\n    log(...data: unknown[]): void;\n\n    /**\n     * Log a warning message.\n     * @param data - Values to log\n     */\n    warn(...data: unknown[]): void;\n\n    /**\n     * Log an error message.\n     * @param data - Values to log\n     */\n    error(...data: unknown[]): void;\n\n    /**\n     * Log a debug message.\n     * @param data - Values to log\n     */\n    debug(...data: unknown[]): void;\n\n    /**\n     * Log an info message.\n     * @param data - Values to log\n     */\n    info(...data: unknown[]): void;\n\n    /**\n     * Log a stack trace.\n     * @param data - Values to log with the trace\n     */\n    trace(...data: unknown[]): void;\n\n    /**\n     * Display an object in a formatted way.\n     * @param item - Object to display\n     * @param options - Display options\n     */\n    dir(item: unknown, options?: object): void;\n\n    /**\n     * Display tabular data.\n     * @param tabularData - Data to display as a table\n     * @param properties - Optional array of property names to include\n     */\n    table(tabularData: unknown, properties?: string[]): void;\n\n    /**\n     * Start a timer.\n     * @param label - Timer label (default: \"default\")\n     */\n    time(label?: string): void;\n\n    /**\n     * End a timer and log the elapsed time.\n     * @param label - Timer label (default: \"default\")\n     */\n    timeEnd(label?: string): void;\n\n    /**\n     * Log the elapsed time of a timer without ending it.\n     * @param label - Timer label (default: \"default\")\n     * @param data - Additional values to log\n     */\n    timeLog(label?: string, ...data: unknown[]): void;\n\n    /**\n     * Log an error if the assertion is false.\n     * @param condition - Condition to test\n     * @param data - Values to log if assertion fails\n     */\n    assert(condition?: boolean, ...data: unknown[]): void;\n\n    /**\n     * Increment and log a counter.\n     * @param label - Counter label (default: \"default\")\n     */\n    count(label?: string): void;\n\n    /**\n     * Reset a counter.\n     * @param label - Counter label (default: \"default\")\n     */\n    countReset(label?: string): void;\n\n    /**\n     * Clear the console.\n     */\n    clear(): void;\n\n    /**\n     * Start an inline group.\n     * @param data - Group label\n     */\n    group(...data: unknown[]): void;\n\n    /**\n     * Start a collapsed inline group.\n     * @param data - Group label\n     */\n    groupCollapsed(...data: unknown[]): void;\n\n    /**\n     * End the current inline group.\n     */\n    groupEnd(): void;\n  }\n\n  /**\n   * Console object for logging and debugging.\n   */\n  const console: Console;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-encoding globals.\n *\n * Includes: atob, btoa\n */\nexport const ENCODING_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-encoding\n *\n * These types define the globals injected by setupEncoding() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Decodes a Base64-encoded string.\n   *\n   * @param encodedData - The Base64 string to decode\n   * @returns The decoded string\n   * @throws DOMException if the input is not valid Base64\n   *\n   * @example\n   * atob(\"SGVsbG8=\"); // \"Hello\"\n   */\n  function atob(encodedData: string): string;\n\n  /**\n   * Encodes a string to Base64.\n   *\n   * @param stringToEncode - The string to encode (must contain only Latin1 characters)\n   * @returns The Base64 encoded string\n   * @throws DOMException if the string contains characters outside Latin1 range (0-255)\n   *\n   * @example\n   * btoa(\"Hello\"); // \"SGVsbG8=\"\n   */\n  function btoa(stringToEncode: string): string;\n}\n`;\n\n/**\n * Type definitions for @ricsam/quickjs-timers globals.\n *\n * Includes: setTimeout, setInterval, clearTimeout, clearInterval\n */\nexport const TIMERS_TYPES = `/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-timers\n *\n * These types define the globals injected by setupTimers() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * const timeoutId = setTimeout(() => {\n *   console.log(\"fired!\");\n * }, 1000);\n *\n * clearTimeout(timeoutId);\n *\n * const intervalId = setInterval(() => {\n *   console.log(\"tick\");\n * }, 100);\n *\n * clearInterval(intervalId);\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Schedule a callback to execute after a delay.\n   *\n   * @param callback - The function to call after the delay\n   * @param ms - The delay in milliseconds (default: 0)\n   * @param args - Additional arguments to pass to the callback\n   * @returns A timer ID that can be passed to clearTimeout\n   *\n   * @example\n   * const id = setTimeout(() => console.log(\"done\"), 1000);\n   * setTimeout((a, b) => console.log(a, b), 100, \"hello\", \"world\");\n   */\n  function setTimeout(\n    callback: (...args: unknown[]) => void,\n    ms?: number,\n    ...args: unknown[]\n  ): number;\n\n  /**\n   * Schedule a callback to execute repeatedly at a fixed interval.\n   *\n   * @param callback - The function to call at each interval\n   * @param ms - The interval in milliseconds (minimum: 4ms)\n   * @param args - Additional arguments to pass to the callback\n   * @returns A timer ID that can be passed to clearInterval\n   *\n   * @example\n   * const id = setInterval(() => console.log(\"tick\"), 1000);\n   */\n  function setInterval(\n    callback: (...args: unknown[]) => void,\n    ms?: number,\n    ...args: unknown[]\n  ): number;\n\n  /**\n   * Cancel a timeout previously scheduled with setTimeout.\n   *\n   * @param id - The timer ID returned by setTimeout\n   *\n   * @example\n   * const id = setTimeout(() => {}, 1000);\n   * clearTimeout(id);\n   */\n  function clearTimeout(id: number | undefined): void;\n\n  /**\n   * Cancel an interval previously scheduled with setInterval.\n   *\n   * @param id - The timer ID returned by setInterval\n   *\n   * @example\n   * const id = setInterval(() => {}, 1000);\n   * clearInterval(id);\n   */\n  function clearInterval(id: number | undefined): void;\n}\n`;\n\n/**\n * Map of package names to their type definitions.\n */\nexport const TYPE_DEFINITIONS = {\n  core: CORE_TYPES,\n  console: CONSOLE_TYPES,\n  encoding: ENCODING_TYPES,\n  fetch: FETCH_TYPES,\n  fs: FS_TYPES,\n  testEnvironment: TEST_ENV_TYPES,\n  timers: TIMERS_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;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;AA+RvB,IAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0ItB,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;AAuCvB,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA,EACV,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,iBAAiB;AACnB;",
-  "debugId": "CEEE9AD03E866EA164756E2164756E21",
+  "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;AA+RvB,IAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0ItB,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;AAyCvB,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqFrB,IAAM,mBAAmB;AAAA,EAC9B,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU;AAAA,EACV,OAAO;AAAA,EACP,IAAI;AAAA,EACJ,iBAAiB;AAAA,EACjB,QAAQ;AACV;",
+  "debugId": "E2CFF2AC657B42E964756E2164756E21",
   "names": []
 }

package/dist/mjs/typecheck.mjs

@@ -16,24 +16,39 @@ function getMessageText(messageText) {
 }
 function typecheckQuickJSCode(code, options) {
   const include = options?.include ?? ["core", "fetch", "fs"];
+  const libraryTypes = options?.libraryTypes ?? {};
+  const hasLibraries = Object.keys(libraryTypes).length > 0;
   const project = new Project({
     useInMemoryFileSystem: true,
     compilerOptions: {
       target: ts.ScriptTarget.ESNext,
       module: ts.ModuleKind.ESNext,
+      moduleResolution: hasLibraries ? ts.ModuleResolutionKind.NodeJs : undefined,
       lib: ["lib.esnext.d.ts", "lib.dom.d.ts"],
       strict: true,
       noEmit: true,
       skipLibCheck: true,
+      esModuleInterop: true,
+      allowSyntheticDefaultImports: true,
       ...options?.compilerOptions
     }
   });
+  const memFs = project.getFileSystem();
   for (const pkg of include) {
     const content = TYPE_DEFINITIONS[pkg];
     if (content) {
       project.createSourceFile(`${pkg}.d.ts`, content);
     }
   }
+  for (const [_libName, lib] of Object.entries(libraryTypes)) {
+    for (const typeFile of lib.files) {
+      if (typeFile.path.endsWith(".json")) {
+        memFs.writeFileSync(`/${typeFile.path}`, typeFile.content);
+      } else {
+        project.createSourceFile(`/${typeFile.path}`, typeFile.content, { overwrite: true });
+      }
+    }
+  }
   const sourceFile = project.createSourceFile("usercode.ts", code);
   const diagnostics = sourceFile.getPreEmitDiagnostics();
   const errors = diagnostics.map((diagnostic) => {
@@ -74,4 +89,4 @@ export {
   formatTypecheckErrors
 };
 
-//# debugId=922DAD5DB1B8442964756E2164756E21
+//# debugId=740865933E04ADE364756E2164756E21

package/dist/mjs/typecheck.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/typecheck.ts"],
   "sourcesContent": [
-    "/**\n * Type-checking utility for QuickJS user code using ts-morph.\n *\n * This utility allows you to validate TypeScript code strings against\n * the QuickJS global type definitions before running them in the sandbox.\n *\n * @example\n * import { typecheckQuickJSCode } from \"@ricsam/quickjs-test-utils\";\n *\n * const result = typecheckQuickJSCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `, { include: [\"fetch\"] });\n *\n * if (!result.success) {\n *   console.error(\"Type errors:\", result.errors);\n * }\n */\n\nimport { Project, ts } from \"ts-morph\";\nimport { TYPE_DEFINITIONS, type TypeDefinitionKey } from \"./quickjs-types.mjs\";\n\n/**\n * Result of type-checking QuickJS code.\n */\nexport interface TypecheckResult {\n  /**\n   * Whether the code passed type checking.\n   */\n  success: boolean;\n\n  /**\n   * Array of type errors found in the code.\n   */\n  errors: TypecheckError[];\n}\n\n/**\n * A single type-checking error.\n */\nexport interface TypecheckError {\n  /**\n   * The error message from TypeScript.\n   */\n  message: string;\n\n  /**\n   * The line number where the error occurred (1-indexed).\n   */\n  line?: number;\n\n  /**\n   * The column number where the error occurred (1-indexed).\n   */\n  column?: number;\n\n  /**\n   * The TypeScript error code.\n   */\n  code?: number;\n}\n\n/**\n * Options for type-checking QuickJS code.\n */\nexport interface TypecheckOptions {\n  /**\n   * Which package types to include.\n   * @default [\"core\", \"fetch\", \"fs\"]\n   */\n  include?: Array<\"core\" | \"fetch\" | \"fs\">;\n\n  /**\n   * Additional compiler options to pass to TypeScript.\n   */\n  compilerOptions?: Partial<ts.CompilerOptions>;\n}\n\n/**\n * Get the message text from a TypeScript diagnostic message.\n * Handles both string messages and DiagnosticMessageChain objects.\n */\nfunction getMessageText(messageText: unknown): string {\n  if (typeof messageText === \"string\") {\n    return messageText;\n  }\n\n  // Handle ts-morph DiagnosticMessageChain wrapper\n  if (\n    messageText &&\n    typeof messageText === \"object\" &&\n    \"getMessageText\" in messageText &&\n    typeof (messageText as { getMessageText: unknown }).getMessageText ===\n      \"function\"\n  ) {\n    return (messageText as { getMessageText: () => string }).getMessageText();\n  }\n\n  // Handle raw TypeScript DiagnosticMessageChain\n  if (\n    messageText &&\n    typeof messageText === \"object\" &&\n    \"messageText\" in messageText\n  ) {\n    return String((messageText as { messageText: unknown }).messageText);\n  }\n\n  return String(messageText);\n}\n\n\n/**\n * Type-check QuickJS user code against the package type definitions.\n *\n * @param code - The TypeScript/JavaScript code to check\n * @param options - Configuration options\n * @returns The result of type checking\n *\n * @example\n * // Check code that uses the fetch API\n * const result = typecheckQuickJSCode(`\n *   const response = await fetch(\"https://api.example.com/data\");\n *   const data = await response.json();\n * `, { include: [\"core\", \"fetch\"] });\n *\n * @example\n * // Check code that uses serve()\n * const result = typecheckQuickJSCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `, { include: [\"fetch\"] });\n *\n * @example\n * // Check code that uses the file system API\n * const result = typecheckQuickJSCode(`\n *   const root = await fs.getDirectory(\"/data\");\n *   const file = await root.getFileHandle(\"config.json\");\n * `, { include: [\"core\", \"fs\"] });\n */\nexport function typecheckQuickJSCode(\n  code: string,\n  options?: TypecheckOptions\n): TypecheckResult {\n  const include = options?.include ?? [\"core\", \"fetch\", \"fs\"];\n\n  // Create a project with in-memory file system\n  const project = new Project({\n    useInMemoryFileSystem: true,\n    compilerOptions: {\n      target: ts.ScriptTarget.ESNext,\n      module: ts.ModuleKind.ESNext,\n      lib: [\"lib.esnext.d.ts\", \"lib.dom.d.ts\"],\n      strict: true,\n      noEmit: true,\n      skipLibCheck: true,\n      ...options?.compilerOptions,\n    },\n  });\n\n  // Add type definition files from embedded strings\n  for (const pkg of include) {\n    const content = TYPE_DEFINITIONS[pkg as TypeDefinitionKey];\n    if (content) {\n      project.createSourceFile(`${pkg}.d.ts`, content);\n    }\n  }\n\n  // Add the user code\n  const sourceFile = project.createSourceFile(\"usercode.ts\", code);\n\n  // Get diagnostics\n  const diagnostics = sourceFile.getPreEmitDiagnostics();\n\n  // Convert diagnostics to our error format\n  const errors: TypecheckError[] = diagnostics.map((diagnostic) => {\n    const start = diagnostic.getStart();\n    const sourceFile = diagnostic.getSourceFile();\n\n    let line: number | undefined;\n    let column: number | undefined;\n\n    if (start !== undefined && sourceFile) {\n      const lineAndChar = sourceFile.getLineAndColumnAtPos(start);\n      line = lineAndChar.line;\n      column = lineAndChar.column;\n    }\n\n    return {\n      message: getMessageText(diagnostic.getMessageText()),\n      line,\n      column,\n      code: diagnostic.getCode(),\n    };\n  });\n\n  return {\n    success: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Format type-check errors for display.\n *\n * @param result - The type-check result\n * @returns A formatted string of errors\n *\n * @example\n * const result = typecheckQuickJSCode(code);\n * if (!result.success) {\n *   console.error(formatTypecheckErrors(result));\n * }\n */\nexport function formatTypecheckErrors(result: TypecheckResult): string {\n  if (result.success) {\n    return \"No type errors found.\";\n  }\n\n  return result.errors\n    .map((error) => {\n      const location =\n        error.line !== undefined ? `:${error.line}:${error.column ?? 1}` : \"\";\n      const code = error.code ? ` (TS${error.code})` : \"\";\n      return `usercode.ts${location}${code}: ${error.message}`;\n    })\n    .join(\"\\n\");\n}\n"
+    "/**\n * Type-checking utility for QuickJS user code using ts-morph.\n *\n * This utility allows you to validate TypeScript code strings against\n * the QuickJS global type definitions before running them in the sandbox.\n *\n * @example\n * import { typecheckQuickJSCode } from \"@ricsam/quickjs-test-utils\";\n *\n * const result = typecheckQuickJSCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `, { include: [\"fetch\"] });\n *\n * if (!result.success) {\n *   console.error(\"Type errors:\", result.errors);\n * }\n */\n\nimport { Project, ts } from \"ts-morph\";\nimport { TYPE_DEFINITIONS, type TypeDefinitionKey } from \"./quickjs-types.mjs\";\n\n/**\n * Result of type-checking QuickJS code.\n */\nexport interface TypecheckResult {\n  /**\n   * Whether the code passed type checking.\n   */\n  success: boolean;\n\n  /**\n   * Array of type errors found in the code.\n   */\n  errors: TypecheckError[];\n}\n\n/**\n * A single type-checking error.\n */\nexport interface TypecheckError {\n  /**\n   * The error message from TypeScript.\n   */\n  message: string;\n\n  /**\n   * The line number where the error occurred (1-indexed).\n   */\n  line?: number;\n\n  /**\n   * The column number where the error occurred (1-indexed).\n   */\n  column?: number;\n\n  /**\n   * The TypeScript error code.\n   */\n  code?: number;\n}\n\n/**\n * A single library type file to inject into the virtual file system.\n */\nexport interface LibraryTypeFile {\n  /** The file content (e.g., .d.ts or package.json content) */\n  content: string;\n  /** The virtual path (e.g., \"node_modules/zod/index.d.ts\") */\n  path: string;\n}\n\n/**\n * Library types bundle for a single package.\n */\nexport interface LibraryTypes {\n  files: LibraryTypeFile[];\n}\n\n/**\n * Options for type-checking QuickJS code.\n */\nexport interface TypecheckOptions {\n  /**\n   * Which QuickJS global types to include.\n   * @default [\"core\", \"fetch\", \"fs\"]\n   */\n  include?: Array<\"core\" | \"fetch\" | \"fs\" | \"console\" | \"encoding\" | \"timers\" | \"testEnvironment\">;\n\n  /**\n   * Library type definitions to inject for import resolution.\n   * These are added to the virtual node_modules/ for module resolution.\n   *\n   * Use the build-library-types.ts script to generate these bundles from\n   * your project's node_modules, then pass them here.\n   *\n   * @example\n   * import { LIBRARY_TYPES } from \"./my-library-types.mjs\";\n   *\n   * typecheckQuickJSCode(code, {\n   *   libraryTypes: {\n   *     zod: LIBRARY_TYPES.zod,\n   *     \"@richie-rpc/core\": LIBRARY_TYPES[\"@richie-rpc/core\"],\n   *   }\n   * });\n   */\n  libraryTypes?: Record<string, LibraryTypes>;\n\n  /**\n   * Additional compiler options to pass to TypeScript.\n   */\n  compilerOptions?: Partial<ts.CompilerOptions>;\n}\n\n/**\n * Get the message text from a TypeScript diagnostic message.\n * Handles both string messages and DiagnosticMessageChain objects.\n */\nfunction getMessageText(messageText: unknown): string {\n  if (typeof messageText === \"string\") {\n    return messageText;\n  }\n\n  // Handle ts-morph DiagnosticMessageChain wrapper\n  if (\n    messageText &&\n    typeof messageText === \"object\" &&\n    \"getMessageText\" in messageText &&\n    typeof (messageText as { getMessageText: unknown }).getMessageText ===\n      \"function\"\n  ) {\n    return (messageText as { getMessageText: () => string }).getMessageText();\n  }\n\n  // Handle raw TypeScript DiagnosticMessageChain\n  if (\n    messageText &&\n    typeof messageText === \"object\" &&\n    \"messageText\" in messageText\n  ) {\n    return String((messageText as { messageText: unknown }).messageText);\n  }\n\n  return String(messageText);\n}\n\n\n/**\n * Type-check QuickJS user code against the package type definitions.\n *\n * @param code - The TypeScript/JavaScript code to check\n * @param options - Configuration options\n * @returns The result of type checking\n *\n * @example\n * // Check code that uses the fetch API\n * const result = typecheckQuickJSCode(`\n *   const response = await fetch(\"https://api.example.com/data\");\n *   const data = await response.json();\n * `, { include: [\"core\", \"fetch\"] });\n *\n * @example\n * // Check code that uses serve()\n * const result = typecheckQuickJSCode(`\n *   serve({\n *     fetch(request, server) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `, { include: [\"fetch\"] });\n *\n * @example\n * // Check code that uses the file system API\n * const result = typecheckQuickJSCode(`\n *   const root = await fs.getDirectory(\"/data\");\n *   const file = await root.getFileHandle(\"config.json\");\n * `, { include: [\"core\", \"fs\"] });\n */\nexport function typecheckQuickJSCode(\n  code: string,\n  options?: TypecheckOptions\n): TypecheckResult {\n  const include = options?.include ?? [\"core\", \"fetch\", \"fs\"];\n  const libraryTypes = options?.libraryTypes ?? {};\n  const hasLibraries = Object.keys(libraryTypes).length > 0;\n\n  // Create a project with in-memory file system\n  const project = new Project({\n    useInMemoryFileSystem: true,\n    compilerOptions: {\n      target: ts.ScriptTarget.ESNext,\n      module: ts.ModuleKind.ESNext,\n      // Use NodeJs resolution for node_modules/ lookup when libraries are included\n      moduleResolution: hasLibraries\n        ? ts.ModuleResolutionKind.NodeJs\n        : undefined,\n      lib: [\"lib.esnext.d.ts\", \"lib.dom.d.ts\"],\n      strict: true,\n      noEmit: true,\n      skipLibCheck: true,\n      esModuleInterop: true,\n      allowSyntheticDefaultImports: true,\n      ...options?.compilerOptions,\n    },\n  });\n\n  const memFs = project.getFileSystem();\n\n  // Add type definition files from embedded strings (QuickJS globals)\n  for (const pkg of include) {\n    const content = TYPE_DEFINITIONS[pkg as TypeDefinitionKey];\n    if (content) {\n      project.createSourceFile(`${pkg}.d.ts`, content);\n    }\n  }\n\n  // Add library type definitions to virtual node_modules/\n  for (const [_libName, lib] of Object.entries(libraryTypes)) {\n    for (const typeFile of lib.files) {\n      // JSON files go to file system, TS files as source files\n      if (typeFile.path.endsWith(\".json\")) {\n        memFs.writeFileSync(`/${typeFile.path}`, typeFile.content);\n      } else {\n        project.createSourceFile(`/${typeFile.path}`, typeFile.content, { overwrite: true });\n      }\n    }\n  }\n\n  // Add the user code\n  const sourceFile = project.createSourceFile(\"usercode.ts\", code);\n\n  // Get diagnostics\n  const diagnostics = sourceFile.getPreEmitDiagnostics();\n\n  // Convert diagnostics to our error format\n  const errors: TypecheckError[] = diagnostics.map((diagnostic) => {\n    const start = diagnostic.getStart();\n    const sourceFile = diagnostic.getSourceFile();\n\n    let line: number | undefined;\n    let column: number | undefined;\n\n    if (start !== undefined && sourceFile) {\n      const lineAndChar = sourceFile.getLineAndColumnAtPos(start);\n      line = lineAndChar.line;\n      column = lineAndChar.column;\n    }\n\n    return {\n      message: getMessageText(diagnostic.getMessageText()),\n      line,\n      column,\n      code: diagnostic.getCode(),\n    };\n  });\n\n  return {\n    success: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Format type-check errors for display.\n *\n * @param result - The type-check result\n * @returns A formatted string of errors\n *\n * @example\n * const result = typecheckQuickJSCode(code);\n * if (!result.success) {\n *   console.error(formatTypecheckErrors(result));\n * }\n */\nexport function formatTypecheckErrors(result: TypecheckResult): string {\n  if (result.success) {\n    return \"No type errors found.\";\n  }\n\n  return result.errors\n    .map((error) => {\n      const location =\n        error.line !== undefined ? `:${error.line}:${error.column ?? 1}` : \"\";\n      const code = error.code ? ` (TS${error.code})` : \"\";\n      return `usercode.ts${location}${code}: ${error.message}`;\n    })\n    .join(\"\\n\");\n}\n"
   ],
-  "mappings": ";;AAsBA;AACA;AA8DA,SAAS,cAAc,CAAC,aAA8B;AAAA,EACpD,IAAI,OAAO,gBAAgB,UAAU;AAAA,IACnC,OAAO;AAAA,EACT;AAAA,EAGA,IACE,eACA,OAAO,gBAAgB,YACvB,oBAAoB,eACpB,OAAQ,YAA4C,mBAClD,YACF;AAAA,IACA,OAAQ,YAAiD,eAAe;AAAA,EAC1E;AAAA,EAGA,IACE,eACA,OAAO,gBAAgB,YACvB,iBAAiB,aACjB;AAAA,IACA,OAAO,OAAQ,YAAyC,WAAW;AAAA,EACrE;AAAA,EAEA,OAAO,OAAO,WAAW;AAAA;AAmCpB,SAAS,oBAAoB,CAClC,MACA,SACiB;AAAA,EACjB,MAAM,UAAU,SAAS,WAAW,CAAC,QAAQ,SAAS,IAAI;AAAA,EAG1D,MAAM,UAAU,IAAI,QAAQ;AAAA,IAC1B,uBAAuB;AAAA,IACvB,iBAAiB;AAAA,MACf,QAAQ,GAAG,aAAa;AAAA,MACxB,QAAQ,GAAG,WAAW;AAAA,MACtB,KAAK,CAAC,mBAAmB,cAAc;AAAA,MACvC,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,cAAc;AAAA,SACX,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AAAA,EAGD,WAAW,OAAO,SAAS;AAAA,IACzB,MAAM,UAAU,iBAAiB;AAAA,IACjC,IAAI,SAAS;AAAA,MACX,QAAQ,iBAAiB,GAAG,YAAY,OAAO;AAAA,IACjD;AAAA,EACF;AAAA,EAGA,MAAM,aAAa,QAAQ,iBAAiB,eAAe,IAAI;AAAA,EAG/D,MAAM,cAAc,WAAW,sBAAsB;AAAA,EAGrD,MAAM,SAA2B,YAAY,IAAI,CAAC,eAAe;AAAA,IAC/D,MAAM,QAAQ,WAAW,SAAS;AAAA,IAClC,MAAM,cAAa,WAAW,cAAc;AAAA,IAE5C,IAAI;AAAA,IACJ,IAAI;AAAA,IAEJ,IAAI,UAAU,aAAa,aAAY;AAAA,MACrC,MAAM,cAAc,YAAW,sBAAsB,KAAK;AAAA,MAC1D,OAAO,YAAY;AAAA,MACnB,SAAS,YAAY;AAAA,IACvB;AAAA,IAEA,OAAO;AAAA,MACL,SAAS,eAAe,WAAW,eAAe,CAAC;AAAA,MACnD;AAAA,MACA;AAAA,MACA,MAAM,WAAW,QAAQ;AAAA,IAC3B;AAAA,GACD;AAAA,EAED,OAAO;AAAA,IACL,SAAS,OAAO,WAAW;AAAA,IAC3B;AAAA,EACF;AAAA;AAeK,SAAS,qBAAqB,CAAC,QAAiC;AAAA,EACrE,IAAI,OAAO,SAAS;AAAA,IAClB,OAAO;AAAA,EACT;AAAA,EAEA,OAAO,OAAO,OACX,IAAI,CAAC,UAAU;AAAA,IACd,MAAM,WACJ,MAAM,SAAS,YAAY,IAAI,MAAM,QAAQ,MAAM,UAAU,MAAM;AAAA,IACrE,MAAM,OAAO,MAAM,OAAO,OAAO,MAAM,UAAU;AAAA,IACjD,OAAO,cAAc,WAAW,SAAS,MAAM;AAAA,GAChD,EACA,KAAK;AAAA,CAAI;AAAA;",
-  "debugId": "922DAD5DB1B8442964756E2164756E21",
+  "mappings": ";;AAsBA;AACA;AAkGA,SAAS,cAAc,CAAC,aAA8B;AAAA,EACpD,IAAI,OAAO,gBAAgB,UAAU;AAAA,IACnC,OAAO;AAAA,EACT;AAAA,EAGA,IACE,eACA,OAAO,gBAAgB,YACvB,oBAAoB,eACpB,OAAQ,YAA4C,mBAClD,YACF;AAAA,IACA,OAAQ,YAAiD,eAAe;AAAA,EAC1E;AAAA,EAGA,IACE,eACA,OAAO,gBAAgB,YACvB,iBAAiB,aACjB;AAAA,IACA,OAAO,OAAQ,YAAyC,WAAW;AAAA,EACrE;AAAA,EAEA,OAAO,OAAO,WAAW;AAAA;AAmCpB,SAAS,oBAAoB,CAClC,MACA,SACiB;AAAA,EACjB,MAAM,UAAU,SAAS,WAAW,CAAC,QAAQ,SAAS,IAAI;AAAA,EAC1D,MAAM,eAAe,SAAS,gBAAgB,CAAC;AAAA,EAC/C,MAAM,eAAe,OAAO,KAAK,YAAY,EAAE,SAAS;AAAA,EAGxD,MAAM,UAAU,IAAI,QAAQ;AAAA,IAC1B,uBAAuB;AAAA,IACvB,iBAAiB;AAAA,MACf,QAAQ,GAAG,aAAa;AAAA,MACxB,QAAQ,GAAG,WAAW;AAAA,MAEtB,kBAAkB,eACd,GAAG,qBAAqB,SACxB;AAAA,MACJ,KAAK,CAAC,mBAAmB,cAAc;AAAA,MACvC,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,8BAA8B;AAAA,SAC3B,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AAAA,EAED,MAAM,QAAQ,QAAQ,cAAc;AAAA,EAGpC,WAAW,OAAO,SAAS;AAAA,IACzB,MAAM,UAAU,iBAAiB;AAAA,IACjC,IAAI,SAAS;AAAA,MACX,QAAQ,iBAAiB,GAAG,YAAY,OAAO;AAAA,IACjD;AAAA,EACF;AAAA,EAGA,YAAY,UAAU,QAAQ,OAAO,QAAQ,YAAY,GAAG;AAAA,IAC1D,WAAW,YAAY,IAAI,OAAO;AAAA,MAEhC,IAAI,SAAS,KAAK,SAAS,OAAO,GAAG;AAAA,QACnC,MAAM,cAAc,IAAI,SAAS,QAAQ,SAAS,OAAO;AAAA,MAC3D,EAAO;AAAA,QACL,QAAQ,iBAAiB,IAAI,SAAS,QAAQ,SAAS,SAAS,EAAE,WAAW,KAAK,CAAC;AAAA;AAAA,IAEvF;AAAA,EACF;AAAA,EAGA,MAAM,aAAa,QAAQ,iBAAiB,eAAe,IAAI;AAAA,EAG/D,MAAM,cAAc,WAAW,sBAAsB;AAAA,EAGrD,MAAM,SAA2B,YAAY,IAAI,CAAC,eAAe;AAAA,IAC/D,MAAM,QAAQ,WAAW,SAAS;AAAA,IAClC,MAAM,cAAa,WAAW,cAAc;AAAA,IAE5C,IAAI;AAAA,IACJ,IAAI;AAAA,IAEJ,IAAI,UAAU,aAAa,aAAY;AAAA,MACrC,MAAM,cAAc,YAAW,sBAAsB,KAAK;AAAA,MAC1D,OAAO,YAAY;AAAA,MACnB,SAAS,YAAY;AAAA,IACvB;AAAA,IAEA,OAAO;AAAA,MACL,SAAS,eAAe,WAAW,eAAe,CAAC;AAAA,MACnD;AAAA,MACA;AAAA,MACA,MAAM,WAAW,QAAQ;AAAA,IAC3B;AAAA,GACD;AAAA,EAED,OAAO;AAAA,IACL,SAAS,OAAO,WAAW;AAAA,IAC3B;AAAA,EACF;AAAA;AAeK,SAAS,qBAAqB,CAAC,QAAiC;AAAA,EACrE,IAAI,OAAO,SAAS;AAAA,IAClB,OAAO;AAAA,EACT;AAAA,EAEA,OAAO,OAAO,OACX,IAAI,CAAC,UAAU;AAAA,IACd,MAAM,WACJ,MAAM,SAAS,YAAY,IAAI,MAAM,QAAQ,MAAM,UAAU,MAAM;AAAA,IACrE,MAAM,OAAO,MAAM,OAAO,OAAO,MAAM,UAAU;AAAA,IACjD,OAAO,cAAc,WAAW,SAAS,MAAM;AAAA,GAChD,EACA,KAAK;AAAA,CAAI;AAAA;",
+  "debugId": "740865933E04ADE364756E2164756E21",
   "names": []
 }

package/dist/types/index.d.ts

@@ -2,5 +2,5 @@ export { createTestContext, disposeTestContext, useTestContext, type TestContext
 export { createFetchTestContext, disposeFetchTestContext, useFetchTestContext, type FetchTestContext, type CreateFetchTestContextOptions, } from "./fetch-context.ts";
 export { evalCode, evalCodeAsync } from "./eval.ts";
 export { startIntegrationServer, type IntegrationTestServer, type StartIntegrationServerOptions, } from "./integration-server.ts";
-export { typecheckQuickJSCode, formatTypecheckErrors, type TypecheckResult, type TypecheckError, type TypecheckOptions, } from "./typecheck.ts";
+export { typecheckQuickJSCode, formatTypecheckErrors, type TypecheckResult, type TypecheckError, type TypecheckOptions, type LibraryTypes, type LibraryTypeFile, } from "./typecheck.ts";
 export { CORE_TYPES, FETCH_TYPES, FS_TYPES, TYPE_DEFINITIONS, type TypeDefinitionKey, } from "./quickjs-types.ts";

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

@@ -46,6 +46,12 @@ export declare const CONSOLE_TYPES = "/**\n * QuickJS Global Type Definitions fo
  * Includes: atob, btoa
  */
 export declare const ENCODING_TYPES = "/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-encoding\n *\n * These types define the globals injected by setupEncoding() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Decodes a Base64-encoded string.\n   *\n   * @param encodedData - The Base64 string to decode\n   * @returns The decoded string\n   * @throws DOMException if the input is not valid Base64\n   *\n   * @example\n   * atob(\"SGVsbG8=\"); // \"Hello\"\n   */\n  function atob(encodedData: string): string;\n\n  /**\n   * Encodes a string to Base64.\n   *\n   * @param stringToEncode - The string to encode (must contain only Latin1 characters)\n   * @returns The Base64 encoded string\n   * @throws DOMException if the string contains characters outside Latin1 range (0-255)\n   *\n   * @example\n   * btoa(\"Hello\"); // \"SGVsbG8=\"\n   */\n  function btoa(stringToEncode: string): string;\n}\n";
+/**
+ * Type definitions for @ricsam/quickjs-timers globals.
+ *
+ * Includes: setTimeout, setInterval, clearTimeout, clearInterval
+ */
+export declare const TIMERS_TYPES = "/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-timers\n *\n * These types define the globals injected by setupTimers() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * const timeoutId = setTimeout(() => {\n *   console.log(\"fired!\");\n * }, 1000);\n *\n * clearTimeout(timeoutId);\n *\n * const intervalId = setInterval(() => {\n *   console.log(\"tick\");\n * }, 100);\n *\n * clearInterval(intervalId);\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Schedule a callback to execute after a delay.\n   *\n   * @param callback - The function to call after the delay\n   * @param ms - The delay in milliseconds (default: 0)\n   * @param args - Additional arguments to pass to the callback\n   * @returns A timer ID that can be passed to clearTimeout\n   *\n   * @example\n   * const id = setTimeout(() => console.log(\"done\"), 1000);\n   * setTimeout((a, b) => console.log(a, b), 100, \"hello\", \"world\");\n   */\n  function setTimeout(\n    callback: (...args: unknown[]) => void,\n    ms?: number,\n    ...args: unknown[]\n  ): number;\n\n  /**\n   * Schedule a callback to execute repeatedly at a fixed interval.\n   *\n   * @param callback - The function to call at each interval\n   * @param ms - The interval in milliseconds (minimum: 4ms)\n   * @param args - Additional arguments to pass to the callback\n   * @returns A timer ID that can be passed to clearInterval\n   *\n   * @example\n   * const id = setInterval(() => console.log(\"tick\"), 1000);\n   */\n  function setInterval(\n    callback: (...args: unknown[]) => void,\n    ms?: number,\n    ...args: unknown[]\n  ): number;\n\n  /**\n   * Cancel a timeout previously scheduled with setTimeout.\n   *\n   * @param id - The timer ID returned by setTimeout\n   *\n   * @example\n   * const id = setTimeout(() => {}, 1000);\n   * clearTimeout(id);\n   */\n  function clearTimeout(id: number | undefined): void;\n\n  /**\n   * Cancel an interval previously scheduled with setInterval.\n   *\n   * @param id - The timer ID returned by setInterval\n   *\n   * @example\n   * const id = setInterval(() => {}, 1000);\n   * clearInterval(id);\n   */\n  function clearInterval(id: number | undefined): void;\n}\n";
 /**
  * Map of package names to their type definitions.
  */
@@ -56,6 +62,7 @@ export declare const TYPE_DEFINITIONS: {
     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";
+    readonly timers: "/**\n * QuickJS Global Type Definitions for @ricsam/quickjs-timers\n *\n * These types define the globals injected by setupTimers() into a QuickJS context.\n * Use these types to typecheck user code that will run inside QuickJS.\n *\n * @example\n * const timeoutId = setTimeout(() => {\n *   console.log(\"fired!\");\n * }, 1000);\n *\n * clearTimeout(timeoutId);\n *\n * const intervalId = setInterval(() => {\n *   console.log(\"tick\");\n * }, 100);\n *\n * clearInterval(intervalId);\n */\n\nexport {};\n\ndeclare global {\n  /**\n   * Schedule a callback to execute after a delay.\n   *\n   * @param callback - The function to call after the delay\n   * @param ms - The delay in milliseconds (default: 0)\n   * @param args - Additional arguments to pass to the callback\n   * @returns A timer ID that can be passed to clearTimeout\n   *\n   * @example\n   * const id = setTimeout(() => console.log(\"done\"), 1000);\n   * setTimeout((a, b) => console.log(a, b), 100, \"hello\", \"world\");\n   */\n  function setTimeout(\n    callback: (...args: unknown[]) => void,\n    ms?: number,\n    ...args: unknown[]\n  ): number;\n\n  /**\n   * Schedule a callback to execute repeatedly at a fixed interval.\n   *\n   * @param callback - The function to call at each interval\n   * @param ms - The interval in milliseconds (minimum: 4ms)\n   * @param args - Additional arguments to pass to the callback\n   * @returns A timer ID that can be passed to clearInterval\n   *\n   * @example\n   * const id = setInterval(() => console.log(\"tick\"), 1000);\n   */\n  function setInterval(\n    callback: (...args: unknown[]) => void,\n    ms?: number,\n    ...args: unknown[]\n  ): number;\n\n  /**\n   * Cancel a timeout previously scheduled with setTimeout.\n   *\n   * @param id - The timer ID returned by setTimeout\n   *\n   * @example\n   * const id = setTimeout(() => {}, 1000);\n   * clearTimeout(id);\n   */\n  function clearTimeout(id: number | undefined): void;\n\n  /**\n   * Cancel an interval previously scheduled with setInterval.\n   *\n   * @param id - The timer ID returned by setInterval\n   *\n   * @example\n   * const id = setInterval(() => {}, 1000);\n   * clearInterval(id);\n   */\n  function clearInterval(id: number | undefined): void;\n}\n";
 };
 /**
  * Type for the keys of TYPE_DEFINITIONS.

package/dist/types/typecheck.d.ts

@@ -54,15 +54,48 @@ export interface TypecheckError {
      */
     code?: number;
 }
+/**
+ * A single library type file to inject into the virtual file system.
+ */
+export interface LibraryTypeFile {
+    /** The file content (e.g., .d.ts or package.json content) */
+    content: string;
+    /** The virtual path (e.g., "node_modules/zod/index.d.ts") */
+    path: string;
+}
+/**
+ * Library types bundle for a single package.
+ */
+export interface LibraryTypes {
+    files: LibraryTypeFile[];
+}
 /**
  * Options for type-checking QuickJS code.
  */
 export interface TypecheckOptions {
     /**
-     * Which package types to include.
+     * Which QuickJS global types to include.
      * @default ["core", "fetch", "fs"]
      */
-    include?: Array<"core" | "fetch" | "fs">;
+    include?: Array<"core" | "fetch" | "fs" | "console" | "encoding" | "timers" | "testEnvironment">;
+    /**
+     * Library type definitions to inject for import resolution.
+     * These are added to the virtual node_modules/ for module resolution.
+     *
+     * Use the build-library-types.ts script to generate these bundles from
+     * your project's node_modules, then pass them here.
+     *
+     * @example
+     * import { LIBRARY_TYPES } from "./my-library-types.ts";
+     *
+     * typecheckQuickJSCode(code, {
+     *   libraryTypes: {
+     *     zod: LIBRARY_TYPES.zod,
+     *     "@richie-rpc/core": LIBRARY_TYPES["@richie-rpc/core"],
+     *   }
+     * });
+     */
+    libraryTypes?: Record<string, LibraryTypes>;
     /**
      * Additional compiler options to pass to TypeScript.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/quickjs-test-utils",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "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.6",
-    "@ricsam/quickjs-fetch": "^0.2.7",
-    "@ricsam/quickjs-fs": "^0.2.6",
-    "@ricsam/quickjs-runtime": "^0.2.7"
+    "@ricsam/quickjs-core": "^0.2.8",
+    "@ricsam/quickjs-fetch": "^0.2.9",
+    "@ricsam/quickjs-fs": "^0.2.8",
+    "@ricsam/quickjs-runtime": "^0.2.9"
   },
   "peerDependenciesMeta": {
     "@ricsam/quickjs-fs": {