@volter/tabnode 0.2.14-volter.88

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+/**
+ * tabnode's public surface.
+ *
+ * The engine is a library the substrate embeds: a filesystem, a runtime, a
+ * container over the two, the npm client that fills the tree, the bridge a
+ * page's requests reach a guest's server through, and the resolver. What a
+ * guest requires is not here -- a guest reaches its builtins through the
+ * runtime's own module table, which is `runtime.ts`.
+ */
+export { restoreHostGlobals, guestRealmInstalled } from './host-globals';
+export { VirtualFS } from './virtual-fs';
+export type { FSNode, Stats, FSWatcher, WatchListener, WatchEventType } from './virtual-fs';
+export { Runtime, execute } from './runtime';
+export type { Module, RuntimeOptions, RequireFunction } from './runtime';
+export { createRuntime, WorkerRuntime } from './create-runtime';
+export type { IRuntime, IExecuteResult, CreateRuntimeOptions, IRuntimeOptions, VFSSnapshot } from './runtime-interface';
+export { createFsShim } from './shims/fs';
+export type { FsShim } from './shims/fs';
+export { createProcess } from './shims/process';
+export type { Process, ProcessEnv } from './shims/process';
+export * as path from './shims/path';
+export { httpModule as http, httpsModule as https } from './node-lib/http-module';
+export { netModule as net } from './node-lib/net-module';
+export { eventsModule as events } from './node-lib/events-module';
+export { streamModule as stream } from './node-lib/stream-module';
+export { bufferModule as buffer } from './node-lib/buffer-module';
+export * as url from './shims/url';
+export { utilModule as util } from './node-lib/util-module';
+export * as npm from './npm';
+export { PackageManager, install } from './npm';
+export { ServerBridge, getServerBridge, resetServerBridge } from './server-bridge';
+export type { InitServiceWorkerOptions } from './server-bridge';
+/** What a page's request is answered with, the shape the bridge answers. */
+export type { ResponseData } from './node-lib/http-bridge';
+export * as esbuild from './shims/esbuild';
+export * as rollup from './shims/rollup';
+export * as module from './shims/module';
+export * as perf_hooks from './shims/perf_hooks';
+export * as worker_threads from './shims/worker_threads';
+import { VirtualFS } from './virtual-fs';
+import { Runtime, RuntimeOptions } from './runtime';
+import { PackageManager } from './npm';
+import { ServerBridge } from './server-bridge';
+import { type Socket as NetSocket } from './node-lib/net-module';
+import { runPid, processByPid } from './process-tokens';
+export { runPid, processByPid };
+export interface RunResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface RunOptions {
+    cwd?: string;
+    /** The environment the command runs in, as `child_process.exec` takes it. */
+    env?: Record<string, string>;
+    /** What the shell reads on stdin, so a builtin reads what was piped to it. */
+    stdin?: string;
+    /** Callback for streaming stdout chunks as they arrive (for long-running commands like vitest watch) */
+    onStdout?: (data: string) => void;
+    /** Callback for streaming stderr chunks as they arrive */
+    onStderr?: (data: string) => void;
+    /** AbortSignal to cancel long-running commands */
+    signal?: AbortSignal;
+    /**
+     * A name for this run. The `node` command records the guest process it
+     * creates under it for the run's lifetime, and the container answers
+     * `pendingTimers`, `processPorts` and `stopProcess` about that name.
+     */
+    processToken?: string;
+    /**
+     * The host keeps this run open (a watch or an interactive shell); a run that
+     * is not held ends when its loop has nothing left, as Node's does. A
+     * `signal` alone is an abort handle, not a hold.
+     */
+    held?: boolean;
+}
+export interface ContainerOptions extends RuntimeOptions {
+    /** The filesystem the container runs on; one is built in memory when absent. */
+    vfs?: VirtualFS;
+    baseUrl?: string;
+    onServerReady?: (port: number, url: string) => void;
+}
+/**
+ * Create a new WebContainer-like environment
+ */
+export declare function createContainer(options?: ContainerOptions): {
+    vfs: VirtualFS;
+    runtime: Runtime;
+    npm: PackageManager;
+    serverBridge: ServerBridge;
+    execute: (code: string, filename?: string) => {
+        exports: unknown;
+    };
+    runFile: (filename: string) => {
+        exports: unknown;
+    };
+    run: (command: string, options?: RunOptions) => Promise<RunResult>;
+    pendingTimers: (token: string) => number;
+    processPorts: (token: string) => number[];
+    stopProcess: (token: string) => boolean;
+    /**
+     * Input for one run's guest, by its process token; without a token, the most
+     * recently started held run, which is the prompt a person is typing to.
+     */
+    sendInput: (data: string, token?: string) => void;
+    /** The run whose guest code is executing, for a caller attributing a child. */
+    currentProcessToken: () => string | null;
+    /** The numbers a named run, or the current one, was started with. */
+    runPid: (token?: string | null) => {
+        pid: number;
+        ppid: number;
+    } | undefined;
+    /** The numbers a live process carries, looked up by its own pid. */
+    processByPid: (pid: number) => {
+        pid: number;
+        ppid: number;
+    } | undefined;
+    listenNet: (port: number, onConnection: (socket: NetSocket) => void) => () => void;
+    createREPL: () => {
+        eval: (code: string) => unknown;
+    };
+    on: (event: string, listener: (...args: unknown[]) => void) => void;
+};
+export default createContainer;
+export { createNodeResolver } from './node-resolution';
+export type { ResolutionFs, ExportsResolver, NodeResolverOptions, NodeResolver } from './node-resolution';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}