almostnode 0.1.0

package/dist/next-demo.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Next.js Demo - Running Next.js-style app in the browser using our Node.js shims
+ */
+import { VirtualFS } from './virtual-fs';
+import { Runtime } from './runtime';
+import { createRuntime } from './create-runtime';
+import type { IRuntime } from './runtime-interface';
+import { NextDevServer } from './frameworks/next-dev-server';
+import { PackageManager, InstallOptions, InstallResult } from './npm';
+/**
+ * Create a Next.js project structure in the virtual filesystem
+ */
+export declare function createNextProject(vfs: VirtualFS): void;
+/**
+ * Create a Next.js App Router project structure in the virtual filesystem
+ */
+export declare function createNextAppRouterProject(vfs: VirtualFS): void;
+/**
+ * Initialize the Next.js demo
+ */
+export declare function initNextDemo(outputElement: HTMLElement, options?: {
+    useWorker?: boolean;
+}): Promise<{
+    vfs: VirtualFS;
+    runtime: IRuntime;
+}>;
+/**
+ * Start the Next.js dev server using Service Worker approach
+ */
+export declare function startNextDevServer(vfs: VirtualFS, options?: {
+    port?: number;
+    log?: (message: string) => void;
+}): Promise<{
+    server: NextDevServer;
+    url: string;
+    stop: () => void;
+}>;
+/**
+ * Initialize the Next.js App Router demo
+ */
+export declare function initNextAppRouterDemo(outputElement: HTMLElement, options?: {
+    useWorker?: boolean;
+}): Promise<{
+    vfs: VirtualFS;
+    runtime: IRuntime;
+}>;
+export { VirtualFS, Runtime, NextDevServer, PackageManager, createRuntime };
+export type { InstallOptions, InstallResult, IRuntime };
+//# sourceMappingURL=next-demo.d.ts.map

package/dist/next-demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-demo.d.ts","sourceRoot":"","sources":["../src/next-demo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAwzBtD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CA4sB/D;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,aAAa,EAAE,WAAW,EAC1B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACpC,OAAO,CAAC;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC,CA6ChD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,SAAS,EACd,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B,GACL,OAAO,CAAC;IACT,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC,CAmDD;AAgDD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,WAAW,EAC1B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACpC,OAAO,CAAC;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC,CA6ChD;AAGD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAC5E,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC"}

package/dist/npm/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * npm Package Manager
+ * Orchestrates package installation into the virtual file system
+ */
+import { VirtualFS } from '../virtual-fs';
+import { RegistryOptions } from './registry';
+import { ResolvedPackage } from './resolver';
+export interface InstallOptions {
+    registry?: string;
+    save?: boolean;
+    saveDev?: boolean;
+    includeDev?: boolean;
+    includeOptional?: boolean;
+    onProgress?: (message: string) => void;
+    /** Transform ESM packages to CJS after install (default: true) */
+    transform?: boolean;
+}
+export interface InstallResult {
+    installed: Map<string, ResolvedPackage>;
+    added: string[];
+}
+/**
+ * npm Package Manager for VirtualFS
+ */
+export declare class PackageManager {
+    private vfs;
+    private registry;
+    private cwd;
+    constructor(vfs: VirtualFS, options?: {
+        cwd?: string;
+    } & RegistryOptions);
+    /**
+     * Install a package and its dependencies
+     */
+    install(packageSpec: string, options?: InstallOptions): Promise<InstallResult>;
+    /**
+     * Install all dependencies from package.json
+     */
+    installFromPackageJson(options?: InstallOptions): Promise<InstallResult>;
+    /**
+     * Install resolved packages to node_modules
+     */
+    private installResolved;
+    /**
+     * Write lockfile with resolved versions
+     */
+    private writeLockfile;
+    /**
+     * Update package.json with new dependency
+     */
+    private updatePackageJson;
+    /**
+     * List installed packages
+     */
+    list(): Record<string, string>;
+}
+/**
+ * Parse a package specifier into name and version
+ * Examples: "express", "express@4.18.2", "@types/node@18"
+ */
+declare function parsePackageSpec(spec: string): {
+    name: string;
+    version?: string;
+};
+export declare function install(packageSpec: string, vfs: VirtualFS, options?: InstallOptions): Promise<InstallResult>;
+export { Registry } from './registry';
+export type { RegistryOptions, PackageVersion, PackageManifest } from './registry';
+export type { ResolvedPackage, ResolveOptions } from './resolver';
+export type { ExtractOptions } from './tarball';
+export { parsePackageSpec };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/npm/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAY,eAAe,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAGL,eAAe,EAEhB,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAoB;IAM5E;;OAEG;IACG,OAAO,CACX,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAoCzB;;OAEG;IACG,sBAAsB,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IA6BlF;;OAEG;YACW,eAAe;IAkF7B;;OAEG;YACW,aAAa;IAgB3B;;OAEG;YACW,iBAAiB;IAwB/B;;OAEG;IACH,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAqC/B;AAED;;;GAGG;AACH,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CA+B1E;AAGD,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAGxB;AAGD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnF,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/npm/registry.d.ts

@@ -0,0 +1,66 @@
+/**
+ * npm Registry Client
+ * Fetches package metadata from npm registry
+ */
+export interface PackageVersion {
+    name: string;
+    version: string;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    peerDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+    dist: {
+        tarball: string;
+        shasum: string;
+        integrity?: string;
+    };
+    main?: string;
+    module?: string;
+    exports?: Record<string, unknown>;
+    bin?: Record<string, string> | string;
+}
+export interface PackageManifest {
+    name: string;
+    'dist-tags': {
+        latest: string;
+        [tag: string]: string;
+    };
+    versions: Record<string, PackageVersion>;
+    time?: Record<string, string>;
+}
+export interface RegistryOptions {
+    registry?: string;
+    cache?: Map<string, PackageManifest>;
+}
+export declare class Registry {
+    private registryUrl;
+    private cache;
+    constructor(options?: RegistryOptions);
+    /**
+     * Fetch package manifest (all versions metadata)
+     */
+    getPackageManifest(packageName: string): Promise<PackageManifest>;
+    /**
+     * Get specific version metadata
+     */
+    getPackageVersion(packageName: string, version: string): Promise<PackageVersion>;
+    /**
+     * Get latest version number
+     */
+    getLatestVersion(packageName: string): Promise<string>;
+    /**
+     * Get all available versions
+     */
+    getVersions(packageName: string): Promise<string[]>;
+    /**
+     * Download tarball as ArrayBuffer
+     */
+    downloadTarball(tarballUrl: string): Promise<ArrayBuffer>;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+}
+export declare const registry: Registry;
+export default Registry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/npm/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/npm/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACtC;AAID,qBAAa,QAAQ;IACnB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAA+B;gBAEhC,OAAO,GAAE,eAAoB;IAKzC;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA6BvE;;OAEG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC;IAgB1B;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK5D;;OAEG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzD;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAU/D;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;AAWD,eAAO,MAAM,QAAQ,UAAiB,CAAC;AAEvC,eAAe,QAAQ,CAAC"}

package/dist/npm/resolver.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Dependency Resolver
+ * Resolves full dependency tree with semver version constraints
+ */
+import { Registry } from './registry';
+export interface ResolvedPackage {
+    name: string;
+    version: string;
+    tarballUrl: string;
+    dependencies: Record<string, string>;
+}
+export interface ResolveOptions {
+    registry?: Registry;
+    includeDev?: boolean;
+    includeOptional?: boolean;
+    onProgress?: (message: string) => void;
+}
+/**
+ * Parse a semver version string into components
+ */
+declare function parseVersion(version: string): {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease?: string;
+} | null;
+/**
+ * Compare two semver versions
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ */
+declare function compareVersions(a: string, b: string): number;
+/**
+ * Check if a version satisfies a semver range
+ */
+declare function satisfies(version: string, range: string): boolean;
+/**
+ * Find the best matching version from available versions
+ */
+declare function findBestVersion(versions: string[], range: string): string | null;
+/**
+ * Resolve all dependencies for a package
+ */
+export declare function resolveDependencies(packageName: string, versionRange?: string, options?: ResolveOptions): Promise<Map<string, ResolvedPackage>>;
+/**
+ * Resolve dependencies from a package.json
+ */
+export declare function resolveFromPackageJson(packageJson: {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}, options?: ResolveOptions): Promise<Map<string, ResolvedPackage>>;
+export { parseVersion, compareVersions, satisfies, findBestVersion };
+//# sourceMappingURL=resolver.d.ts.map

package/dist/npm/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/npm/resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AASD;;GAEG;AACH,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,IAAI,CAUP;AAED;;;GAGG;AACH,iBAAS,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CA0BrD;AAED;;GAEG;AACH,iBAAS,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA0I1D;AAED;;GAEG;AACH,iBAAS,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYzE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,YAAY,GAAE,MAAiB,EAC/B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAYvC;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE;IACX,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,EACD,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAoBvC;AA8FD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC"}

package/dist/npm/tarball.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tarball Extractor
+ * Downloads and extracts npm package tarballs into the virtual file system
+ */
+import { VirtualFS } from '../virtual-fs';
+export interface ExtractOptions {
+    stripComponents?: number;
+    filter?: (path: string) => boolean;
+    onProgress?: (message: string) => void;
+}
+/**
+ * Decompress gzipped data
+ */
+export declare function decompress(data: ArrayBuffer | Uint8Array): Uint8Array;
+/**
+ * Extract a tarball to the virtual file system
+ */
+export declare function extractTarball(tarballData: ArrayBuffer | Uint8Array, vfs: VirtualFS, destPath: string, options?: ExtractOptions): string[];
+/**
+ * Download and extract a tarball from URL
+ */
+export declare function downloadAndExtract(url: string, vfs: VirtualFS, destPath: string, options?: ExtractOptions): Promise<string[]>;
+declare const _default: {
+    decompress: typeof decompress;
+    extractTarball: typeof extractTarball;
+    downloadAndExtract: typeof downloadAndExtract;
+};
+export default _default;
+//# sourceMappingURL=tarball.d.ts.map

package/dist/npm/tarball.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tarball.d.ts","sourceRoot":"","sources":["../../src/npm/tarball.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAoGD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAGrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,GAAG,UAAU,EACrC,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,GAC3B,MAAM,EAAE,CAkDV;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CAanB;;;;;;AAED,wBAIE"}

package/dist/runtime-interface.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Runtime Interface - Common interface for main-thread and worker runtimes
+ */
+import type { VirtualFS } from './virtual-fs';
+export interface IRuntimeOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    onConsole?: (method: string, args: unknown[]) => void;
+}
+export interface IModule {
+    id: string;
+    filename: string;
+    exports: unknown;
+    loaded: boolean;
+    children: IModule[];
+    paths: string[];
+}
+export interface IExecuteResult {
+    exports: unknown;
+    module: IModule;
+}
+/**
+ * Common runtime interface implemented by both MainThreadRuntime and WorkerRuntime
+ */
+export interface IRuntime {
+    /**
+     * Execute code as a module
+     */
+    execute(code: string, filename?: string): Promise<IExecuteResult>;
+    /**
+     * Run a file from the virtual file system
+     */
+    runFile(filename: string): Promise<IExecuteResult>;
+    /**
+     * Clear the module cache
+     */
+    clearCache(): void;
+    /**
+     * Get the virtual file system (only available on main thread runtime)
+     */
+    getVFS?(): VirtualFS;
+    /**
+     * Terminate the runtime (only applicable to worker runtime)
+     */
+    terminate?(): void;
+}
+/**
+ * Options for creating a runtime
+ */
+export interface CreateRuntimeOptions extends IRuntimeOptions {
+    /**
+     * Cross-origin sandbox URL for secure code execution.
+     * When set, code runs in a cross-origin iframe, providing browser-enforced
+     * isolation from cookies, localStorage, and IndexedDB.
+     *
+     * Example: 'https://myapp-sandbox.vercel.app'
+     */
+    sandbox?: string;
+    /**
+     * Explicitly allow same-origin execution (less secure).
+     * Required when not using sandbox mode.
+     *
+     * WARNING: Same-origin execution allows untrusted code to access
+     * cookies, localStorage, and other same-origin resources.
+     * Only use this for trusted code or demos.
+     */
+    dangerouslyAllowSameOrigin?: boolean;
+    /**
+     * Whether to use a Web Worker for code execution (same-origin only)
+     * - false (default): Execute on main thread
+     * - true: Execute in a Web Worker
+     * - 'auto': Use worker if available, fallback to main thread
+     *
+     * Note: Workers provide thread isolation but NOT origin isolation.
+     * They still have access to IndexedDB and can make network requests.
+     */
+    useWorker?: boolean | 'auto';
+}
+/**
+ * VFS snapshot for transferring to worker
+ */
+export interface VFSSnapshot {
+    files: VFSFileEntry[];
+}
+export interface VFSFileEntry {
+    path: string;
+    type: 'file' | 'directory';
+    content?: string;
+}
+//# sourceMappingURL=runtime-interface.d.ts.map

package/dist/runtime-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-interface.d.ts","sourceRoot":"","sources":["../src/runtime-interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAElE;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEnD;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,IAAI,SAAS,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/runtime.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Runtime - Execute user code with shimmed Node.js globals
+ *
+ * ESM to CJS transformation is now handled during npm install by transform.ts
+ * using esbuild-wasm. This runtime just executes the pre-transformed CJS code.
+ */
+import { VirtualFS } from './virtual-fs';
+import type { IExecuteResult } from './runtime-interface';
+import { Process } from './shims/process';
+export interface Module {
+    id: string;
+    filename: string;
+    exports: unknown;
+    loaded: boolean;
+    children: Module[];
+    paths: string[];
+}
+export interface RuntimeOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    onConsole?: (method: string, args: unknown[]) => void;
+}
+export interface RequireFunction {
+    (id: string): unknown;
+    resolve: (id: string) => string;
+    cache: Record<string, Module>;
+}
+/**
+ * Runtime class for executing code in virtual environment
+ * Note: This class has sync methods for backward compatibility.
+ * Use createRuntime() factory for IRuntime interface compliance.
+ */
+export declare class Runtime {
+    private vfs;
+    private fsShim;
+    private process;
+    private moduleCache;
+    private options;
+    constructor(vfs: VirtualFS, options?: RuntimeOptions);
+    /**
+     * Set up a polyfilled TextDecoder that handles binary encodings
+     */
+    private setupTextDecoderPolyfill;
+    /**
+     * Execute code as a module (synchronous - backward compatible)
+     */
+    execute(code: string, filename?: string): {
+        exports: unknown;
+        module: Module;
+    };
+    /**
+     * Execute code as a module (async version for IRuntime interface)
+     * Alias: executeSync() is the same as execute() for backward compatibility
+     */
+    executeSync: (code: string, filename?: string) => {
+        exports: unknown;
+        module: Module;
+    };
+    /**
+     * Execute code as a module (async - for IRuntime interface)
+     */
+    executeAsync(code: string, filename?: string): Promise<IExecuteResult>;
+    /**
+     * Run a file from the virtual file system (synchronous - backward compatible)
+     */
+    runFile(filename: string): {
+        exports: unknown;
+        module: Module;
+    };
+    /**
+     * Alias for runFile (backward compatibility)
+     */
+    runFileSync: (filename: string) => {
+        exports: unknown;
+        module: Module;
+    };
+    /**
+     * Run a file from the virtual file system (async - for IRuntime interface)
+     */
+    runFileAsync(filename: string): Promise<IExecuteResult>;
+    /**
+     * Clear the module cache
+     */
+    clearCache(): void;
+    /**
+     * Get the virtual file system
+     */
+    getVFS(): VirtualFS;
+    /**
+     * Get the process object
+     */
+    getProcess(): Process;
+}
+/**
+ * Create and execute code in a new runtime (synchronous - backward compatible)
+ */
+export declare function execute(code: string, vfs: VirtualFS, options?: RuntimeOptions): {
+    exports: unknown;
+    module: Module;
+};
+export type { IRuntime, IExecuteResult, IRuntimeOptions } from './runtime-interface';
+export default Runtime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,KAAK,EAAY,cAAc,EAAmB,MAAM,qBAAqB,CAAC;AAGrF,OAAO,EAAiB,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAqLzD,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACtB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AA+iBD;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,OAAO,CAAiB;gBAEpB,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB;IA0BxD;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA+EhC;;OAEG;IACH,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAoB,GAC7B;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IA4EvC;;;OAGG;IACH,WAAW,SAlFH,MAAM,aACF,MAAM,KACf;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAgFZ;IAE3B;;OAEG;IACG,YAAY,CAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC;IAI1B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAK/D;;OAEG;IACH,WAAW,aARO,MAAM,KAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAQpC;IAE3B;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI7D;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,MAAM,IAAI,SAAS;IAInB;;OAEG;IACH,UAAU,IAAI,OAAO;CAGtB;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,SAAS,EACd,OAAO,CAAC,EAAE,cAAc,GACvB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGtC;AAGD,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAErF,eAAe,OAAO,CAAC"}

package/dist/sandbox-helpers.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Sandbox Helpers - Generate files for deploying a cross-origin sandbox
+ *
+ * The sandbox runs on a different origin (e.g., myapp-sandbox.vercel.app)
+ * to provide browser-enforced isolation from the main application.
+ */
+/**
+ * HTML template for the sandbox page.
+ * This loads almostnode and handles postMessage communication with the parent.
+ *
+ * @param justNodeUrl - URL to load almostnode from (e.g., unpkg, jsdelivr, or your CDN)
+ */
+export declare function getSandboxHtml(justNodeUrl?: string): string;
+/**
+ * Get vercel.json configuration for the sandbox.
+ * Sets up CORS headers to allow embedding as a cross-origin iframe.
+ */
+export declare function getSandboxVercelConfig(): object;
+/**
+ * Generate all files needed for deploying a sandbox to Vercel.
+ *
+ * @param justNodeUrl - URL to load almostnode from
+ * @returns Object with file names as keys and content as values
+ *
+ * @example
+ * ```typescript
+ * import { generateSandboxFiles } from 'almostnode/sandbox-helpers';
+ *
+ * const files = generateSandboxFiles();
+ * // Write files to sandbox/ directory
+ * // Deploy to Vercel: cd sandbox && vercel --prod
+ * ```
+ */
+export declare function generateSandboxFiles(justNodeUrl?: string): {
+    'index.html': string;
+    'vercel.json': string;
+};
+/**
+ * Instructions for setting up a sandbox on Vercel.
+ * Useful for documentation or CLI output.
+ */
+export declare const SANDBOX_SETUP_INSTRUCTIONS: string;
+//# sourceMappingURL=sandbox-helpers.d.ts.map

package/dist/sandbox-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-helpers.d.ts","sourceRoot":"","sources":["../src/sandbox-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,SAA+C,GAAG,MAAM,CA2FjG;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAY/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG;IAC1D,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,CAKA;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAmB/B,CAAC"}

package/dist/sandbox-runtime.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SandboxRuntime - Runs code in a cross-origin iframe for secure execution
+ *
+ * This provides browser-enforced isolation from cookies, localStorage,
+ * sessionStorage, and IndexedDB by running code on a different origin.
+ */
+import type { VirtualFS } from './virtual-fs';
+import type { IRuntime, IExecuteResult, IRuntimeOptions } from './runtime-interface';
+/**
+ * SandboxRuntime - Executes code in a cross-origin iframe
+ */
+export declare class SandboxRuntime implements IRuntime {
+    private iframe;
+    private sandboxOrigin;
+    private vfs;
+    private options;
+    private initialized;
+    private pending;
+    private messageId;
+    private changeListener;
+    private deleteListener;
+    private messageHandler;
+    constructor(sandboxUrl: string, vfs: VirtualFS, options?: IRuntimeOptions);
+    /**
+     * Set up the message event handler
+     */
+    private setupMessageHandler;
+    /**
+     * Wait for the sandbox iframe to signal it's ready
+     */
+    private waitForReady;
+    /**
+     * Initialize the sandbox with VFS snapshot and options
+     */
+    private initSandbox;
+    /**
+     * Set up listeners for VFS changes to sync to sandbox
+     */
+    private setupVFSListeners;
+    /**
+     * Send a message and wait for response
+     */
+    private sendAndWait;
+    /**
+     * Execute code in the sandbox
+     */
+    execute(code: string, filename?: string): Promise<IExecuteResult>;
+    /**
+     * Run a file from the VFS in the sandbox
+     */
+    runFile(filename: string): Promise<IExecuteResult>;
+    /**
+     * Clear the module cache in the sandbox
+     */
+    clearCache(): void;
+    /**
+     * Get the VFS (main thread instance)
+     */
+    getVFS(): VirtualFS;
+    /**
+     * Terminate the sandbox
+     */
+    terminate(): void;
+}
+//# sourceMappingURL=sandbox-runtime.d.ts.map

package/dist/sandbox-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-runtime.d.ts","sourceRoot":"","sources":["../src/sandbox-runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAe,MAAM,qBAAqB,CAAC;AAiBlG;;GAEG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC7C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,OAAO,CAAoG;IACnH,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,cAAc,CAA0D;IAChF,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,cAAc,CAAgD;gBAE1D,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB;IA6B7E;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;YACW,WAAW;IAkBzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IASvE;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQxD;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,MAAM,IAAI,SAAS;IAInB;;OAEG;IACH,SAAS,IAAI,IAAI;CAyBlB"}