@ricsam/quickjs-test-utils 1.0.19 → 1.0.20

package/dist/cjs/index.cjs

@@ -43,6 +43,7 @@ __export(exports_src, {
   createTestContext: () => import_context.createTestContext,
   createFetchTestContext: () => import_fetch_context.createFetchTestContext,
   TYPE_DEFINITIONS: () => import_quickjs_types.TYPE_DEFINITIONS,
+  PATH_TYPES: () => import_quickjs_types.PATH_TYPES,
   FS_TYPES: () => import_quickjs_types.FS_TYPES,
   FETCH_TYPES: () => import_quickjs_types.FETCH_TYPES,
   CORE_TYPES: () => import_quickjs_types.CORE_TYPES
@@ -57,4 +58,4 @@ var import_typecheck = require("./typecheck.cjs");
 var import_quickjs_types = require("./quickjs-types.cjs");
 })
 
-//# debugId=2D2B04FA8DA88D0664756E2164756E21
+//# debugId=BC70EFE2C1DA478164756E2164756E21

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  runTestCode,\n  type TestRuntime,\n  type TestRunner,\n} from \"./native-input-test.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"
+    "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  runTestCode,\n  type TestRuntime,\n  type TestRunner,\n} from \"./native-input-test.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  PATH_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;AAUO,IAJP;AAcO,IARP;AAgBO,IANP;",
-  "debugId": "2D2B04FA8DA88D0664756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKO,IALP;AAaO,IANP;AAQwC,IAAxC;AAMO,IAJP;AAUO,IAJP;AAcO,IARP;AAiBO,IAPP;",
+  "debugId": "BC70EFE2C1DA478164756E2164756E21",
   "names": []
 }

package/dist/cjs/integration-server.cjs

@@ -36,6 +36,7 @@ module.exports = __toCommonJS(exports_integration_server);
 var import_quickjs_emscripten = require("quickjs-emscripten");
 var import_quickjs_fetch = require("@ricsam/quickjs-fetch");
 var import_quickjs_core = require("@ricsam/quickjs-core");
+var import_quickjs_fs = require("@ricsam/quickjs-fs");
 var import_quickjs_console = require("@ricsam/quickjs-console");
 async function startIntegrationServer(quickJSCode, options) {
   const QuickJS = await import_quickjs_emscripten.getQuickJS();
@@ -47,6 +48,7 @@ async function startIntegrationServer(quickJSCode, options) {
     onFetch: options?.onFetch
   });
   const consoleHandle = options?.consoleHandlers ? import_quickjs_console.setupConsole(context, { handlers: options.consoleHandlers, coreHandle }) : undefined;
+  const fsHandle = options?.fs ? import_quickjs_fs.setupFs(context, { coreHandle, getDirectory: options.fs.getDirectory }) : undefined;
   const wsConnections = new Map;
   fetchHandle.onWebSocketCommand((cmd) => {
     const ws = wsConnections.get(cmd.connectionId);
@@ -121,6 +123,7 @@ async function startIntegrationServer(quickJSCode, options) {
     runtime,
     coreHandle,
     consoleHandle,
+    fsHandle,
     async stop() {
       for (const ws of wsConnections.values()) {
         ws.close(1000, "Server stopping");
@@ -128,6 +131,7 @@ async function startIntegrationServer(quickJSCode, options) {
       wsConnections.clear();
       server.stop(true);
       fetchHandle.dispose();
+      fsHandle?.dispose();
       consoleHandle?.dispose();
       coreHandle.dispose();
       context.dispose();
@@ -137,4 +141,4 @@ async function startIntegrationServer(quickJSCode, options) {
 }
 })
 
-//# debugId=815B5672C4B716AE64756E2164756E21
+//# debugId=1371FDAEA518718564756E2164756E21

package/dist/cjs/integration-server.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/integration-server.ts"],
   "sourcesContent": [
-    "import { getQuickJS, type QuickJSContext, type QuickJSRuntime } from \"quickjs-emscripten\";\nimport { setupFetch, type FetchHandle, type WebSocketCommand, type SetupFetchOptions } from \"@ricsam/quickjs-fetch\";\nimport { setupCore, type CoreHandle } from \"@ricsam/quickjs-core\";\nimport type { Server, ServerWebSocket } from \"bun\";\nimport { setupConsole, type ConsoleOutputHandler, type ConsoleHandle } from \"@ricsam/quickjs-console\";\n\ninterface WsData {\n  connectionId: string;\n}\n\nexport interface IntegrationTestServer {\n  baseURL: string;\n  wsURL: string;\n  port: number;\n  fetchHandle: FetchHandle;\n  context: QuickJSContext;\n  runtime: QuickJSRuntime;\n  coreHandle: CoreHandle;\n  consoleHandle?: ConsoleHandle;\n  stop(): Promise<void>;\n}\n\nexport interface StartIntegrationServerOptions {\n  /** Handler for outbound fetch() calls from QuickJS */\n  onFetch?: SetupFetchOptions[\"onFetch\"];\n  /** Handlers for console output from QuickJS */\n  consoleHandlers?: ConsoleOutputHandler;\n}\n\n/**\n * Start a real HTTP server that dispatches requests to a QuickJS serve() handler.\n *\n * @param quickJSCode - JavaScript code to run in QuickJS, should call serve()\n * @param options - Optional configuration\n * @returns Server info including baseURL, wsURL, and stop function\n *\n * @example\n * const server = await startIntegrationServer(`\n *   serve({\n *     fetch(request) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `);\n *\n * const response = await fetch(\\`\\${server.baseURL}/test\\`);\n * expect(await response.text()).toBe(\"Hello!\");\n *\n * await server.stop();\n */\nexport async function startIntegrationServer(\n  quickJSCode: string,\n  options?: StartIntegrationServerOptions\n): Promise<IntegrationTestServer> {\n  const QuickJS = await getQuickJS();\n  const runtime = QuickJS.newRuntime();\n  const context = runtime.newContext();\n\n  // Setup core and fetch APIs\n  const coreHandle = setupCore(context);\n  const fetchHandle = setupFetch(context, {\n    coreHandle,\n    onFetch: options?.onFetch,\n  });\n\n  // Setup console if handlers provided\n  const consoleHandle = options?.consoleHandlers\n    ? setupConsole(context, { handlers: options.consoleHandlers, coreHandle })\n    : undefined;\n\n  // Track WebSocket connections\n  const wsConnections = new Map<string, ServerWebSocket<WsData>>();\n\n  // Handle outgoing WebSocket commands from QuickJS\n  fetchHandle.onWebSocketCommand((cmd: WebSocketCommand) => {\n    const ws = wsConnections.get(cmd.connectionId);\n    if (!ws) return;\n\n    if (cmd.type === \"message\") {\n      ws.send(cmd.data);\n    } else if (cmd.type === \"close\") {\n      ws.close(cmd.code, cmd.reason);\n    }\n  });\n\n  // Run the user's QuickJS code\n  const result = context.evalCode(quickJSCode);\n  if (result.error) {\n    const error = context.dump(result.error);\n    result.error.dispose();\n    fetchHandle.dispose();\n    coreHandle.dispose();\n    context.dispose();\n    runtime.dispose();\n    throw new Error(`Failed to evaluate QuickJS code: ${JSON.stringify(error)}`);\n  }\n  result.value.dispose();\n\n  // Start Bun server with port 0 for dynamic assignment\n  const server: Server<WsData> = Bun.serve<WsData>({\n    port: 0,\n    async fetch(req, server) {\n      try {\n        // Dispatch to QuickJS handler\n        const response = await fetchHandle.dispatchRequest(req);\n\n        // Check if QuickJS requested a WebSocket upgrade\n        const upgrade = fetchHandle.getUpgradeRequest();\n        if (upgrade?.requested) {\n          // The connectionId is generated by QuickJS in server.upgrade()\n          // User data is stored in QuickJS registry - we just pass the connectionId\n          const success = server.upgrade(req, {\n            data: { connectionId: upgrade.connectionId },\n          });\n          if (success) {\n            return undefined;\n          }\n          return new Response(\"WebSocket upgrade failed\", { status: 500 });\n        }\n\n        return response;\n      } catch (error) {\n        console.error(\"Integration test request failed:\", error);\n        return new Response(\"Internal Server Error\", { status: 500 });\n      }\n    },\n    websocket: {\n      open(ws) {\n        const { connectionId } = ws.data;\n        wsConnections.set(connectionId, ws);\n        // User data is looked up from QuickJS registry using connectionId\n        fetchHandle.dispatchWebSocketOpen(connectionId);\n      },\n      message(ws, message) {\n        const msg = typeof message === \"string\" ? message : message.buffer;\n        fetchHandle.dispatchWebSocketMessage(ws.data.connectionId, msg as string | ArrayBuffer);\n      },\n      close(ws, code, reason) {\n        fetchHandle.dispatchWebSocketClose(ws.data.connectionId, code, reason);\n        wsConnections.delete(ws.data.connectionId);\n      },\n    },\n  });\n\n  const port = server.port;\n  if (port === undefined) {\n    throw new Error(\"Server failed to get port\");\n  }\n  const baseURL = `http://localhost:${port}`;\n  const wsURL = `ws://localhost:${port}`;\n\n  return {\n    baseURL,\n    wsURL,\n    port,\n    fetchHandle,\n    context,\n    runtime,\n    coreHandle,\n    consoleHandle,\n    async stop() {\n      // Close all WebSocket connections\n      for (const ws of wsConnections.values()) {\n        ws.close(1000, \"Server stopping\");\n      }\n      wsConnections.clear();\n\n      // Stop the server\n      server.stop(true);\n\n      // Dispose QuickJS resources\n      fetchHandle.dispose();\n      consoleHandle?.dispose();\n      coreHandle.dispose();\n      context.dispose();\n      runtime.dispose();\n    },\n  };\n}\n"
+    "import { getQuickJS, type QuickJSContext, type QuickJSRuntime } from \"quickjs-emscripten\";\nimport { setupFetch, type FetchHandle, type WebSocketCommand, type SetupFetchOptions } from \"@ricsam/quickjs-fetch\";\nimport { setupCore, type CoreHandle } from \"@ricsam/quickjs-core\";\nimport { setupFs, type FsHandle, type HostDirectoryHandle } from \"@ricsam/quickjs-fs\";\nimport type { Server, ServerWebSocket } from \"bun\";\nimport { setupConsole, type ConsoleOutputHandler, type ConsoleHandle } from \"@ricsam/quickjs-console\";\n\ninterface WsData {\n  connectionId: string;\n}\n\nexport interface IntegrationTestServer {\n  baseURL: string;\n  wsURL: string;\n  port: number;\n  fetchHandle: FetchHandle;\n  context: QuickJSContext;\n  runtime: QuickJSRuntime;\n  coreHandle: CoreHandle;\n  consoleHandle?: ConsoleHandle;\n  fsHandle?: FsHandle;\n  stop(): Promise<void>;\n}\n\nexport interface StartIntegrationServerOptions {\n  /** Handler for outbound fetch() calls from QuickJS */\n  onFetch?: SetupFetchOptions[\"onFetch\"];\n  /** Handlers for console output from QuickJS */\n  consoleHandlers?: ConsoleOutputHandler;\n  /** File system configuration for QuickJS */\n  fs?: {\n    /** Returns a directory handle for the given path */\n    getDirectory: (path: string) => Promise<HostDirectoryHandle>;\n  };\n}\n\n/**\n * Start a real HTTP server that dispatches requests to a QuickJS serve() handler.\n *\n * @param quickJSCode - JavaScript code to run in QuickJS, should call serve()\n * @param options - Optional configuration\n * @returns Server info including baseURL, wsURL, and stop function\n *\n * @example\n * const server = await startIntegrationServer(`\n *   serve({\n *     fetch(request) {\n *       return new Response(\"Hello!\");\n *     }\n *   });\n * `);\n *\n * const response = await fetch(\\`\\${server.baseURL}/test\\`);\n * expect(await response.text()).toBe(\"Hello!\");\n *\n * await server.stop();\n */\nexport async function startIntegrationServer(\n  quickJSCode: string,\n  options?: StartIntegrationServerOptions\n): Promise<IntegrationTestServer> {\n  const QuickJS = await getQuickJS();\n  const runtime = QuickJS.newRuntime();\n  const context = runtime.newContext();\n\n  // Setup core and fetch APIs\n  const coreHandle = setupCore(context);\n  const fetchHandle = setupFetch(context, {\n    coreHandle,\n    onFetch: options?.onFetch,\n  });\n\n  // Setup console if handlers provided\n  const consoleHandle = options?.consoleHandlers\n    ? setupConsole(context, { handlers: options.consoleHandlers, coreHandle })\n    : undefined;\n\n  // Setup fs if configured\n  const fsHandle = options?.fs\n    ? setupFs(context, { coreHandle, getDirectory: options.fs.getDirectory })\n    : undefined;\n\n  // Track WebSocket connections\n  const wsConnections = new Map<string, ServerWebSocket<WsData>>();\n\n  // Handle outgoing WebSocket commands from QuickJS\n  fetchHandle.onWebSocketCommand((cmd: WebSocketCommand) => {\n    const ws = wsConnections.get(cmd.connectionId);\n    if (!ws) return;\n\n    if (cmd.type === \"message\") {\n      ws.send(cmd.data);\n    } else if (cmd.type === \"close\") {\n      ws.close(cmd.code, cmd.reason);\n    }\n  });\n\n  // Run the user's QuickJS code\n  const result = context.evalCode(quickJSCode);\n  if (result.error) {\n    const error = context.dump(result.error);\n    result.error.dispose();\n    fetchHandle.dispose();\n    coreHandle.dispose();\n    context.dispose();\n    runtime.dispose();\n    throw new Error(`Failed to evaluate QuickJS code: ${JSON.stringify(error)}`);\n  }\n  result.value.dispose();\n\n  // Start Bun server with port 0 for dynamic assignment\n  const server: Server<WsData> = Bun.serve<WsData>({\n    port: 0,\n    async fetch(req, server) {\n      try {\n        // Dispatch to QuickJS handler\n        const response = await fetchHandle.dispatchRequest(req);\n\n        // Check if QuickJS requested a WebSocket upgrade\n        const upgrade = fetchHandle.getUpgradeRequest();\n        if (upgrade?.requested) {\n          // The connectionId is generated by QuickJS in server.upgrade()\n          // User data is stored in QuickJS registry - we just pass the connectionId\n          const success = server.upgrade(req, {\n            data: { connectionId: upgrade.connectionId },\n          });\n          if (success) {\n            return undefined;\n          }\n          return new Response(\"WebSocket upgrade failed\", { status: 500 });\n        }\n\n        return response;\n      } catch (error) {\n        console.error(\"Integration test request failed:\", error);\n        return new Response(\"Internal Server Error\", { status: 500 });\n      }\n    },\n    websocket: {\n      open(ws) {\n        const { connectionId } = ws.data;\n        wsConnections.set(connectionId, ws);\n        // User data is looked up from QuickJS registry using connectionId\n        fetchHandle.dispatchWebSocketOpen(connectionId);\n      },\n      message(ws, message) {\n        const msg = typeof message === \"string\" ? message : message.buffer;\n        fetchHandle.dispatchWebSocketMessage(ws.data.connectionId, msg as string | ArrayBuffer);\n      },\n      close(ws, code, reason) {\n        fetchHandle.dispatchWebSocketClose(ws.data.connectionId, code, reason);\n        wsConnections.delete(ws.data.connectionId);\n      },\n    },\n  });\n\n  const port = server.port;\n  if (port === undefined) {\n    throw new Error(\"Server failed to get port\");\n  }\n  const baseURL = `http://localhost:${port}`;\n  const wsURL = `ws://localhost:${port}`;\n\n  return {\n    baseURL,\n    wsURL,\n    port,\n    fetchHandle,\n    context,\n    runtime,\n    coreHandle,\n    consoleHandle,\n    fsHandle,\n    async stop() {\n      // Close all WebSocket connections\n      for (const ws of wsConnections.values()) {\n        ws.close(1000, \"Server stopping\");\n      }\n      wsConnections.clear();\n\n      // Stop the server\n      server.stop(true);\n\n      // Dispose QuickJS resources\n      fetchHandle.dispose();\n      fsHandle?.dispose();\n      consoleHandle?.dispose();\n      coreHandle.dispose();\n      context.dispose();\n      runtime.dispose();\n    },\n  };\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "815B5672C4B716AE64756E2164756E21",
+  "mappings": "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",
+  "debugId": "1371FDAEA518718564756E2164756E21",
   "names": []
 }

package/dist/cjs/package.json

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

package/dist/cjs/quickjs-types.cjs

@@ -33,6 +33,7 @@ __export(exports_quickjs_types, {
   TYPE_DEFINITIONS: () => TYPE_DEFINITIONS,
   TIMERS_TYPES: () => TIMERS_TYPES,
   TEST_ENV_TYPES: () => TEST_ENV_TYPES,
+  PATH_TYPES: () => PATH_TYPES,
   FS_TYPES: () => FS_TYPES,
   FETCH_TYPES: () => FETCH_TYPES,
   ENCODING_TYPES: () => ENCODING_TYPES,
@@ -1457,6 +1458,205 @@ declare global {
   const crypto: Crypto;
 }
 `;
+var PATH_TYPES = `/**
+ * QuickJS Global Type Definitions for @ricsam/quickjs-path
+ *
+ * These types define the globals injected by setupPath() into a QuickJS context.
+ * Use these types to typecheck user code that will run inside QuickJS.
+ *
+ * @example
+ * // Typecheck QuickJS code with path operations
+ * const joined = path.join('/foo', 'bar', 'baz');
+ * const resolved = path.resolve('relative/path');
+ * const cwd = path.cwd();
+ */
+
+export {};
+
+declare global {
+  /**
+   * Parsed path object returned by path.parse().
+   */
+  interface ParsedPath {
+    /** The root of the path (e.g., "/" for absolute paths, "" for relative) */
+    root: string;
+    /** The directory portion of the path */
+    dir: string;
+    /** The file name including extension */
+    base: string;
+    /** The file extension (e.g., ".txt") */
+    ext: string;
+    /** The file name without extension */
+    name: string;
+  }
+
+  /**
+   * Input object for path.format().
+   */
+  interface FormatInputPathObject {
+    root?: string;
+    dir?: string;
+    base?: string;
+    ext?: string;
+    name?: string;
+  }
+
+  /**
+   * Path utilities for POSIX paths.
+   * @see https://nodejs.org/api/path.html
+   */
+  namespace path {
+    /**
+     * Join path segments with the platform-specific separator.
+     *
+     * @param paths - Path segments to join
+     * @returns The joined path, normalized
+     *
+     * @example
+     * path.join('/foo', 'bar', 'baz'); // "/foo/bar/baz"
+     * path.join('foo', 'bar', '..', 'baz'); // "foo/baz"
+     */
+    function join(...paths: string[]): string;
+
+    /**
+     * Normalize a path, resolving '..' and '.' segments.
+     *
+     * @param p - The path to normalize
+     * @returns The normalized path
+     *
+     * @example
+     * path.normalize('/foo/bar/../baz'); // "/foo/baz"
+     * path.normalize('/foo//bar'); // "/foo/bar"
+     */
+    function normalize(p: string): string;
+
+    /**
+     * Get the last portion of a path (the file name).
+     *
+     * @param p - The path
+     * @param ext - Optional extension to remove from the result
+     * @returns The base name of the path
+     *
+     * @example
+     * path.basename('/foo/bar/baz.txt'); // "baz.txt"
+     * path.basename('/foo/bar/baz.txt', '.txt'); // "baz"
+     */
+    function basename(p: string, ext?: string): string;
+
+    /**
+     * Get the directory name of a path.
+     *
+     * @param p - The path
+     * @returns The directory portion of the path
+     *
+     * @example
+     * path.dirname('/foo/bar/baz.txt'); // "/foo/bar"
+     * path.dirname('/foo'); // "/"
+     */
+    function dirname(p: string): string;
+
+    /**
+     * Get the extension of a path.
+     *
+     * @param p - The path
+     * @returns The extension including the dot, or empty string
+     *
+     * @example
+     * path.extname('file.txt'); // ".txt"
+     * path.extname('file.tar.gz'); // ".gz"
+     * path.extname('.bashrc'); // ""
+     */
+    function extname(p: string): string;
+
+    /**
+     * Check if a path is absolute.
+     *
+     * @param p - The path to check
+     * @returns True if the path is absolute
+     *
+     * @example
+     * path.isAbsolute('/foo/bar'); // true
+     * path.isAbsolute('foo/bar'); // false
+     */
+    function isAbsolute(p: string): boolean;
+
+    /**
+     * Parse a path into its components.
+     *
+     * @param p - The path to parse
+     * @returns An object with root, dir, base, ext, and name properties
+     *
+     * @example
+     * path.parse('/foo/bar/baz.txt');
+     * // { root: "/", dir: "/foo/bar", base: "baz.txt", ext: ".txt", name: "baz" }
+     */
+    function parse(p: string): ParsedPath;
+
+    /**
+     * Build a path from an object.
+     *
+     * @param pathObject - Object with path components
+     * @returns The formatted path string
+     *
+     * @example
+     * path.format({ dir: '/foo/bar', base: 'baz.txt' }); // "/foo/bar/baz.txt"
+     * path.format({ root: '/', name: 'file', ext: '.txt' }); // "/file.txt"
+     */
+    function format(pathObject: FormatInputPathObject): string;
+
+    /**
+     * Resolve a sequence of paths to an absolute path.
+     * Processes paths from right to left, prepending each until an absolute path is formed.
+     * Uses the configured working directory for relative paths.
+     *
+     * @param paths - Path segments to resolve
+     * @returns The resolved absolute path
+     *
+     * @example
+     * // With cwd set to "/home/user"
+     * path.resolve('foo/bar'); // "/home/user/foo/bar"
+     * path.resolve('/foo', 'bar'); // "/foo/bar"
+     * path.resolve('/foo', '/bar', 'baz'); // "/bar/baz"
+     */
+    function resolve(...paths: string[]): string;
+
+    /**
+     * Compute the relative path from one path to another.
+     *
+     * @param from - The source path
+     * @param to - The destination path
+     * @returns The relative path from 'from' to 'to'
+     *
+     * @example
+     * path.relative('/foo/bar', '/foo/baz'); // "../baz"
+     * path.relative('/foo', '/foo/bar/baz'); // "bar/baz"
+     */
+    function relative(from: string, to: string): string;
+
+    /**
+     * Get the configured working directory.
+     *
+     * @returns The current working directory
+     *
+     * @example
+     * path.cwd(); // "/home/user" (or whatever was configured)
+     */
+    function cwd(): string;
+
+    /**
+     * The platform-specific path segment separator.
+     * Always "/" for POSIX paths.
+     */
+    const sep: string;
+
+    /**
+     * The platform-specific path delimiter.
+     * Always ":" for POSIX paths.
+     */
+    const delimiter: string;
+  }
+}
+`;
 var TIMERS_TYPES = `/**
  * QuickJS Global Type Definitions for @ricsam/quickjs-timers
  *
@@ -1545,9 +1745,10 @@ var TYPE_DEFINITIONS = {
   encoding: ENCODING_TYPES,
   fetch: FETCH_TYPES,
   fs: FS_TYPES,
+  path: PATH_TYPES,
   testEnvironment: TEST_ENV_TYPES,
   timers: TIMERS_TYPES
 };
 })
 
-//# debugId=0BC014EC5A81951964756E2164756E21
+//# debugId=2521770EC7AD006C64756E2164756E21