@emkodev/emroute 1.6.1 → 1.6.3

package/README.md

@@ -3,7 +3,7 @@
 </p>
 
 <p align="center">
-  File-based router with triple rendering. Zero dependencies.
+  File-based (but storage-agnostic) router with triple rendering. Zero dependencies.
 </p>
 
 ---
@@ -22,11 +22,11 @@ GET /md/projects/42       → plain Markdown
 ## Install
 
 ```bash
-bun add @emkodev/emroute
+npm add @emkodev/emroute    # or bun add, pnpm add, yarn add
 ```
 
-> emroute ships TypeScript source. Your toolchain must handle `.ts` imports
-> (Bun, tsx, esbuild, etc.).
+Works on **Node**, **Bun**, and **Deno**. Node uses compiled JS; Bun and Deno
+use TypeScript source directly.
 
 For markdown rendering, add [@emkodev/emkoma](doc/08c-setup-emkoma.md) (built
 for emroute) or bring your own — [marked](doc/08a-setup-marked.md) and
@@ -116,35 +116,37 @@ export default new ProjectPage();
 - **Sitemap generation** — opt-in `sitemap.xml` from the routes manifest with support for dynamic route enumerators
 - **Dev server** — zero-config: auto-generates `main.ts`, `index.html`, and route/widget manifests. File watcher with hot reload and bundle serving
 
-## Why Bun?
+## Runtimes
 
-emroute 1.5.x shipped on JSR (Deno's registry). Starting with 1.6.0, emroute
-publishes to npm and targets Bun as the primary runtime.
+emroute ships two filesystem runtimes:
+
+- **`UniversalFsRuntime`** — uses only `node:` APIs and esbuild. Works on Node,
+  Deno, and Bun. The default choice for getting started.
+- **`BunFsRuntime`** — uses Bun-native APIs (`Bun.file()`, `Bun.write()`,
+  `Bun.Transpiler`) for better I/O performance in production on Bun.
 
-**TL;DR:** JSR's design freezes the entire module graph at publish time. This
-breaks dynamic `import()` of consumer dependencies, peer dependency
-deduplication, and runtime resolution of package entry points for bundling — all
-things a framework with plugin architecture needs. The npm/`node_modules` model
-handles them with zero friction.
+emroute ships TypeScript source. Your runtime must handle `.ts` imports natively
+(Bun, Deno) or via a loader (`tsx`, `node --experimental-strip-types`).
 
-Full analysis with documentation and issue references:
+emroute 1.5.x shipped on JSR (Deno's registry). Starting with 1.6.0, emroute
+publishes to npm. Full analysis:
 [ADR-0017 — Move to Bun ecosystem](doc/architecture/ADR-0017-move-to-bun-ecosystem.md).
 
 ## Getting Started
 
-See [Setup](doc/01-setup.md) and [First Route](doc/02-first-route.md).
+Pick your runtime: [Bun](doc/01a-setup-bun.md) | [Node](doc/01b-setup-node.md) | [Deno](doc/01c-setup-deno.md)
 
 ## Documentation
 
-- [Setup](doc/01-setup.md) — install and create a server
-- [First route](doc/02-first-route.md) — create your first page
+- Setup — [Bun](doc/01a-setup-bun.md), [Node](doc/01b-setup-node.md), [Deno](doc/01c-setup-deno.md)
+- [First route](doc/02-first-route.md) — route files and rendering modes
 - [Pages](doc/03-pages.md) — page components, companion files, data fetching
 - [Routing](doc/04-routing.md) — dynamic segments, catch-all, redirects
 - [Nesting](doc/05-nesting.md) — layouts, slots, passthrough pages, tips and tricks
 - [Widgets](doc/06-widgets.md) — interactive islands with data lifecycle
 - [Server](doc/07-server.md) — `createEmrouteServer`, composition, static files
 - [Markdown renderers](doc/08-markdown-renderer.md) — pluggable parser interface and setup
-- [Runtime](doc/09-runtime.md) — abstract runtime, BunFsRuntime, BunSqliteRuntime
+- [Runtime](doc/09-runtime.md) — abstract runtime, UniversalFsRuntime, BunFsRuntime, BunSqliteRuntime
 - [SPA modes](doc/10-spa-mode.md) — none, leaf, root, only
 - [Error handling](doc/11-error-handling.md) — widget errors, boundaries, status pages
 - [Shadow DOM](doc/12-shadow-dom.md) — unified architecture, SSR hydration

package/dist/runtime/abstract.runtime.d.ts

@@ -0,0 +1,94 @@
+import type { RoutesManifest } from '../src/type/route.type.ts';
+import type { WidgetManifestEntry } from '../src/type/widget.type.ts';
+export declare const CONTENT_TYPES: Map<string, string>;
+export type FetchParams = Parameters<typeof fetch>;
+export type FetchReturn = ReturnType<typeof fetch>;
+export declare const DEFAULT_ROUTES_DIR = "/routes";
+export declare const DEFAULT_WIDGETS_DIR = "/widgets";
+export declare const ROUTES_MANIFEST_PATH = "/routes.manifest.json";
+export declare const WIDGETS_MANIFEST_PATH = "/widgets.manifest.json";
+export declare const EMROUTE_EXTERNALS: readonly ["@emkodev/emroute/spa", "@emkodev/emroute/overlay", "@emkodev/emroute"];
+export interface RuntimeConfig {
+    routesDir?: string;
+    widgetsDir?: string;
+    /** SPA mode. When 'none', bundling is skipped entirely. */
+    spa?: 'none' | 'leaf' | 'root' | 'only';
+    /** Consumer's SPA entry point (e.g. '/main.ts'). Skips app bundle when absent. */
+    entryPoint?: string;
+    bundlePaths?: {
+        emroute: string;
+        app: string;
+        widgets?: string;
+    };
+}
+/**
+ * Abstract resource provider. Speaks Request/Response (ADR-1).
+ *
+ * Three access patterns:
+ * - `handle()` — raw passthrough, server forwards browser requests as-is.
+ * - `query()` — read. Returns Response, or string when `{ as: "text" }`.
+ * - `command()` — write (PUT by default, override with `{ method }` in options).
+ *
+ * Includes manifest resolution: when `query(ROUTES_MANIFEST_PATH)` or
+ * `query(WIDGETS_MANIFEST_PATH)` returns 404, the runtime scans the
+ * configured directories and caches the result.
+ */
+export declare abstract class Runtime {
+    readonly config: RuntimeConfig;
+    constructor(config?: RuntimeConfig);
+    /** Concrete runtimes implement this. Accepts the same args as `fetch()`. */
+    abstract handle(resource: FetchParams[0], init?: FetchParams[1]): FetchReturn;
+    /**
+     * Read with `{ as: "text" }` — skip metadata, return contents only.
+     * Semantically equivalent to `Accept: text/plain`; `as` exists for type safety.
+     */
+    abstract query(resource: FetchParams[0], options: FetchParams[1] & {
+        as: 'text';
+    }): Promise<string>;
+    /** Read — returns full Response with headers, status, body. */
+    abstract query(resource: FetchParams[0], options?: FetchParams[1]): FetchReturn;
+    /** Write. Defaults to PUT; pass `{ method: "DELETE" }` etc. to override. */
+    command(resource: FetchParams[0], options?: FetchParams[1]): FetchReturn;
+    /**
+     * Dynamically import a module from this runtime's storage.
+     * Used by the server for SSR imports of `.page.ts` and `.widget.ts` files.
+     */
+    loadModule(_path: string): Promise<unknown>;
+    static transpile(_ts: string): Promise<string>;
+    /**
+     * Build client bundles. Called by the server after manifests are written.
+     * No-op by default — override in runtimes that support bundling.
+     */
+    bundle(): Promise<void>;
+    /**
+     * Generate an HTML shell (`index.html`) if one doesn't already exist.
+     * Writes through `this.command()` so it works for any runtime.
+     */
+    protected writeShell(paths: {
+        emroute: string;
+        app: string;
+        widgets?: string;
+    }): Promise<void>;
+    static compress(_data: Uint8Array, _encoding: 'br' | 'gzip'): Promise<Uint8Array>;
+    /** Stop the bundler subprocess if running. No-op by default. */
+    static stopBundler(): Promise<void>;
+    private routesManifestCache;
+    private widgetsManifestCache;
+    /** Clear cached manifests so the next query triggers a fresh scan. */
+    invalidateManifests(): void;
+    /**
+     * Resolve the routes manifest. Called when the concrete runtime returns
+     * 404 for ROUTES_MANIFEST_PATH. Scans `config.routesDir` (or default).
+     */
+    resolveRoutesManifest(): Promise<Response>;
+    /**
+     * Resolve the widgets manifest. Called when the concrete runtime returns
+     * 404 for WIDGETS_MANIFEST_PATH. Scans `config.widgetsDir` (or default).
+     */
+    resolveWidgetsManifest(): Promise<Response>;
+    protected walkDirectory(dir: string): AsyncGenerator<string>;
+    protected scanRoutes(routesDir: string): Promise<RoutesManifest & {
+        warnings: string[];
+    }>;
+    protected scanWidgets(widgetsDir: string, pathPrefix?: string): Promise<WidgetManifestEntry[]>;
+}

package/dist/runtime/abstract.runtime.js

@@ -0,0 +1,339 @@
+import { filePathToPattern, getPageFileType, getRouteType, sortRoutesBySpecificity, } from "../src/route/route.matcher.js";
+export const CONTENT_TYPES = new Map([
+    ['.html', 'text/html; charset=utf-8'],
+    ['.css', 'text/css; charset=utf-8'],
+    ['.js', 'application/javascript; charset=utf-8'],
+    ['.mjs', 'application/javascript; charset=utf-8'],
+    ['.ts', 'text/typescript; charset=utf-8'],
+    ['.json', 'application/json; charset=utf-8'],
+    ['.md', 'text/plain; charset=utf-8'],
+    ['.txt', 'text/plain; charset=utf-8'],
+    ['.wasm', 'application/wasm'],
+    ['.map', 'application/json; charset=utf-8'],
+    ['.png', 'image/png'],
+    ['.jpg', 'image/jpeg'],
+    ['.jpeg', 'image/jpeg'],
+    ['.gif', 'image/gif'],
+    ['.svg', 'image/svg+xml'],
+    ['.ico', 'image/x-icon'],
+    ['.webp', 'image/webp'],
+    ['.avif', 'image/avif'],
+    ['.woff', 'font/woff'],
+    ['.woff2', 'font/woff2'],
+    ['.ttf', 'font/ttf'],
+]);
+export const DEFAULT_ROUTES_DIR = '/routes';
+export const DEFAULT_WIDGETS_DIR = '/widgets';
+export const ROUTES_MANIFEST_PATH = '/routes.manifest.json';
+export const WIDGETS_MANIFEST_PATH = '/widgets.manifest.json';
+export const EMROUTE_EXTERNALS = [
+    '@emkodev/emroute/spa',
+    '@emkodev/emroute/overlay',
+    '@emkodev/emroute',
+];
+/**
+ * Abstract resource provider. Speaks Request/Response (ADR-1).
+ *
+ * Three access patterns:
+ * - `handle()` — raw passthrough, server forwards browser requests as-is.
+ * - `query()` — read. Returns Response, or string when `{ as: "text" }`.
+ * - `command()` — write (PUT by default, override with `{ method }` in options).
+ *
+ * Includes manifest resolution: when `query(ROUTES_MANIFEST_PATH)` or
+ * `query(WIDGETS_MANIFEST_PATH)` returns 404, the runtime scans the
+ * configured directories and caches the result.
+ */
+export class Runtime {
+    config;
+    constructor(config = {}) {
+        this.config = config;
+        this.config = config;
+    }
+    /** Write. Defaults to PUT; pass `{ method: "DELETE" }` etc. to override. */
+    command(resource, options) {
+        return this.handle(resource, { method: 'PUT', ...options });
+    }
+    /**
+     * Dynamically import a module from this runtime's storage.
+     * Used by the server for SSR imports of `.page.ts` and `.widget.ts` files.
+     */
+    loadModule(_path) {
+        throw new Error(`loadModule not implemented for ${this.constructor.name}`);
+    }
+    static transpile(_ts) {
+        throw new Error('Not implemented');
+    }
+    /**
+     * Build client bundles. Called by the server after manifests are written.
+     * No-op by default — override in runtimes that support bundling.
+     */
+    bundle() {
+        return Promise.resolve();
+    }
+    /**
+     * Generate an HTML shell (`index.html`) if one doesn't already exist.
+     * Writes through `this.command()` so it works for any runtime.
+     */
+    async writeShell(paths) {
+        if ((await this.query('/index.html')).status !== 404)
+            return;
+        const imports = Object.fromEntries(EMROUTE_EXTERNALS.map((pkg) => [pkg, paths.emroute]));
+        const importMap = JSON.stringify({ imports }, null, 2);
+        const scripts = [
+            `<script type="importmap">\n${importMap}\n  </script>`,
+        ];
+        if (this.config.entryPoint) {
+            scripts.push(`<script type="module" src="${paths.app}"></script>`);
+        }
+        const html = `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>emroute</title>
+  <style>@view-transition { navigation: auto; } router-slot { display: contents; }</style>
+</head>
+<body>
+  <router-slot></router-slot>
+  ${scripts.join('\n  ')}
+</body>
+</html>`;
+        await this.command('/index.html', { body: html });
+    }
+    static compress(_data, _encoding) {
+        throw new Error('Not implemented');
+    }
+    /** Stop the bundler subprocess if running. No-op by default. */
+    static stopBundler() {
+        return Promise.resolve();
+    }
+    // ── Manifest resolution ─────────────────────────────────────────────
+    routesManifestCache = null;
+    widgetsManifestCache = null;
+    /** Clear cached manifests so the next query triggers a fresh scan. */
+    invalidateManifests() {
+        this.routesManifestCache = null;
+        this.widgetsManifestCache = null;
+    }
+    /**
+     * Resolve the routes manifest. Called when the concrete runtime returns
+     * 404 for ROUTES_MANIFEST_PATH. Scans `config.routesDir` (or default).
+     */
+    async resolveRoutesManifest() {
+        if (this.routesManifestCache)
+            return this.routesManifestCache.clone();
+        const routesDir = this.config.routesDir ?? DEFAULT_ROUTES_DIR;
+        // Check if directory exists by querying it
+        const dirResponse = await this.query(routesDir + '/');
+        if (dirResponse.status === 404) {
+            return new Response('Not Found', { status: 404 });
+        }
+        const { warnings, ...manifest } = await this.scanRoutes(routesDir);
+        for (const w of warnings)
+            console.warn(w);
+        const json = {
+            routes: manifest.routes,
+            errorBoundaries: manifest.errorBoundaries,
+            statusPages: [...manifest.statusPages.entries()],
+            errorHandler: manifest.errorHandler,
+        };
+        this.routesManifestCache = Response.json(json);
+        return this.routesManifestCache.clone();
+    }
+    /**
+     * Resolve the widgets manifest. Called when the concrete runtime returns
+     * 404 for WIDGETS_MANIFEST_PATH. Scans `config.widgetsDir` (or default).
+     */
+    async resolveWidgetsManifest() {
+        if (this.widgetsManifestCache)
+            return this.widgetsManifestCache.clone();
+        const widgetsDir = this.config.widgetsDir ?? DEFAULT_WIDGETS_DIR;
+        const dirResponse = await this.query(widgetsDir + '/');
+        if (dirResponse.status === 404) {
+            return new Response('Not Found', { status: 404 });
+        }
+        const entries = await this.scanWidgets(widgetsDir, widgetsDir.replace(/^\//, ''));
+        this.widgetsManifestCache = Response.json(entries);
+        return this.widgetsManifestCache.clone();
+    }
+    // ── Scanning ──────────────────────────────────────────────────────────
+    async *walkDirectory(dir) {
+        const trailingDir = dir.endsWith('/') ? dir : dir + '/';
+        const response = await this.query(trailingDir);
+        const entries = await response.json();
+        for (const entry of entries) {
+            const path = `${trailingDir}${entry}`;
+            if (entry.endsWith('/')) {
+                yield* this.walkDirectory(path);
+            }
+            else {
+                yield path;
+            }
+        }
+    }
+    async scanRoutes(routesDir) {
+        const pageFiles = [];
+        const redirects = [];
+        const errorBoundaries = [];
+        const statusPages = new Map();
+        let errorHandler;
+        const allFiles = [];
+        for await (const file of this.walkDirectory(routesDir)) {
+            allFiles.push(file);
+        }
+        for (const filePath of allFiles) {
+            const relativePath = filePath.replace(`${routesDir}/`, '');
+            const filename = relativePath.split('/').pop() ?? '';
+            if (filename === 'index.error.ts' && relativePath === 'index.error.ts') {
+                errorHandler = {
+                    pattern: '/',
+                    type: 'error',
+                    modulePath: filePath,
+                };
+                continue;
+            }
+            const cssFileType = getPageFileType(filename);
+            if (cssFileType === 'css') {
+                const pattern = filePathToPattern(relativePath);
+                pageFiles.push({ path: filePath, pattern, fileType: 'css' });
+                continue;
+            }
+            const routeType = getRouteType(filename);
+            if (!routeType)
+                continue;
+            const statusMatch = filename.match(/^(\d{3})\.page\.(ts|html|md)$/);
+            if (statusMatch) {
+                const statusCode = parseInt(statusMatch[1], 10);
+                const fileType = getPageFileType(filename);
+                if (fileType) {
+                    const existing = statusPages.get(statusCode);
+                    if (existing) {
+                        existing.files ??= {};
+                        existing.files[fileType] = filePath;
+                        existing.modulePath = existing.files.ts ?? existing.files.html ?? existing.files.md ??
+                            '';
+                    }
+                    else {
+                        const files = { [fileType]: filePath };
+                        statusPages.set(statusCode, {
+                            pattern: `/${statusCode}`,
+                            type: 'page',
+                            modulePath: filePath,
+                            statusCode,
+                            files,
+                        });
+                    }
+                }
+                continue;
+            }
+            const pattern = filePathToPattern(relativePath);
+            if (routeType === 'error') {
+                const boundaryPattern = pattern.replace(/\/[^/]+$/, '') || '/';
+                errorBoundaries.push({ pattern: boundaryPattern, modulePath: filePath });
+                continue;
+            }
+            if (routeType === 'redirect') {
+                redirects.push({ pattern, type: 'redirect', modulePath: filePath });
+                continue;
+            }
+            const fileType = getPageFileType(filename);
+            if (fileType) {
+                pageFiles.push({ path: filePath, pattern, fileType });
+            }
+        }
+        // Group files by pattern
+        const groups = new Map();
+        for (const { path, pattern, fileType } of pageFiles) {
+            let group = groups.get(pattern);
+            if (!group) {
+                group = { pattern, files: {} };
+                const segments = pattern.split('/').filter(Boolean);
+                if (segments.length > 1) {
+                    group.parent = '/' + segments.slice(0, -1).join('/');
+                }
+                groups.set(pattern, group);
+            }
+            const existing = group.files[fileType];
+            if (existing?.includes('/index.page.') && !path.includes('/index.page.')) {
+                continue;
+            }
+            group.files[fileType] = path;
+        }
+        // Detect collisions
+        const warnings = [];
+        for (const [pattern, group] of groups) {
+            const filePaths = Object.values(group.files).filter(Boolean);
+            const hasIndex = filePaths.some((p) => p?.includes('/index.page.'));
+            const hasFlat = filePaths.some((p) => p && !p.includes('/index.page.'));
+            if (hasIndex && hasFlat) {
+                warnings.push(`Warning: Mixed file structure for ${pattern}:\n` +
+                    filePaths.map((p) => `     ${p}`).join('\n') +
+                    `\n     Both folder/index and flat files detected`);
+            }
+        }
+        // Convert groups to RouteConfig array
+        const routes = [];
+        for (const [_, group] of groups) {
+            const modulePath = group.files.ts ?? group.files.html ?? group.files.md ?? '';
+            if (!modulePath)
+                continue;
+            const route = {
+                pattern: group.pattern,
+                type: 'page',
+                modulePath,
+                files: group.files,
+            };
+            if (group.parent)
+                route.parent = group.parent;
+            routes.push(route);
+        }
+        routes.push(...redirects);
+        const sortedRoutes = sortRoutesBySpecificity(routes);
+        return {
+            routes: sortedRoutes,
+            errorBoundaries,
+            statusPages,
+            errorHandler,
+            warnings,
+        };
+    }
+    async scanWidgets(widgetsDir, pathPrefix) {
+        const COMPANION_EXTENSIONS = ['html', 'md', 'css'];
+        const WIDGET_FILE_SUFFIX = '.widget.ts';
+        const entries = [];
+        const trailingDir = widgetsDir.endsWith('/') ? widgetsDir : widgetsDir + '/';
+        const response = await this.query(trailingDir);
+        const listing = await response.json();
+        for (const item of listing) {
+            if (!item.endsWith('/'))
+                continue;
+            const name = item.slice(0, -1);
+            const moduleFile = `${name}${WIDGET_FILE_SUFFIX}`;
+            const modulePath = `${trailingDir}${name}/${moduleFile}`;
+            if ((await this.query(modulePath)).status === 404)
+                continue;
+            const prefix = pathPrefix ? `${pathPrefix}/` : '';
+            const entry = {
+                name,
+                modulePath: `${prefix}${name}/${moduleFile}`,
+                tagName: `widget-${name}`,
+            };
+            const files = {};
+            let hasFiles = false;
+            for (const ext of COMPANION_EXTENSIONS) {
+                const companionFile = `${name}.widget.${ext}`;
+                const companionPath = `${trailingDir}${name}/${companionFile}`;
+                if ((await this.query(companionPath)).status !== 404) {
+                    files[ext] = `${prefix}${name}/${companionFile}`;
+                    hasFiles = true;
+                }
+            }
+            if (hasFiles)
+                entry.files = files;
+            entries.push(entry);
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        return entries;
+    }
+}
+//# sourceMappingURL=abstract.runtime.js.map

package/dist/runtime/abstract.runtime.js.map

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

package/dist/runtime/bun/esbuild-runtime-loader.plugin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * esbuild Runtime Loader Plugin
+ *
+ * Intercepts file resolution so esbuild reads source files through the
+ * runtime's `query()` method instead of the filesystem. This allows
+ * bundling to work with any Runtime implementation (filesystem, SQLite,
+ * in-memory, etc.).
+ *
+ * The plugin intercepts `.ts` and `.js` imports that resolve under the
+ * virtual root and loads their contents from the runtime.
+ */
+import type { Runtime } from '../../runtime/abstract.runtime.ts';
+interface RuntimeLoaderOptions {
+    runtime: Runtime;
+    /**
+     * The filesystem root that esbuild would normally resolve paths against.
+     * Paths starting with this prefix are stripped to produce runtime paths
+     * (e.g. `/app/root/routes/index.page.ts` → `/routes/index.page.ts`).
+     * For runtimes without a filesystem root, pass an empty string.
+     */
+    root: string;
+}
+type EsbuildPlugin = any;
+export declare function createRuntimeLoaderPlugin(options: RuntimeLoaderOptions): EsbuildPlugin;
+export {};

package/dist/runtime/bun/esbuild-runtime-loader.plugin.js

@@ -0,0 +1,72 @@
+/**
+ * esbuild Runtime Loader Plugin
+ *
+ * Intercepts file resolution so esbuild reads source files through the
+ * runtime's `query()` method instead of the filesystem. This allows
+ * bundling to work with any Runtime implementation (filesystem, SQLite,
+ * in-memory, etc.).
+ *
+ * The plugin intercepts `.ts` and `.js` imports that resolve under the
+ * virtual root and loads their contents from the runtime.
+ */
+export function createRuntimeLoaderPlugin(options) {
+    const { runtime, root } = options;
+    return {
+        name: 'emroute-runtime-loader',
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        setup(build) {
+            // Intercept .ts and .js file resolution — redirect to 'runtime' namespace
+            // Only intercepts files that resolve under the runtime root.
+            build.onResolve({ filter: /\.[tj]s$/ }, 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            (args) => {
+                // Skip bare specifiers (node_modules, packages)
+                if (!args.path.startsWith('.') && !args.path.startsWith('/'))
+                    return undefined;
+                // Skip if already in a custom namespace (except 'runtime' for nested imports)
+                // Entry points have namespace '' (empty string)
+                if (args.namespace !== 'file' && args.namespace !== 'runtime' && args.namespace !== '')
+                    return undefined;
+                let absPath;
+                if (args.path.startsWith('/')) {
+                    absPath = args.path;
+                }
+                else if (args.resolveDir) {
+                    absPath = args.resolveDir + '/' + args.path;
+                }
+                else {
+                    return undefined;
+                }
+                // Normalize ../ and ./ segments
+                const parts = absPath.split('/');
+                const normalized = [];
+                for (const part of parts) {
+                    if (part === '..')
+                        normalized.pop();
+                    else if (part !== '.' && part !== '')
+                        normalized.push(part);
+                }
+                absPath = '/' + normalized.join('/');
+                // Only intercept files under the runtime root
+                if (root && !absPath.startsWith(root + '/'))
+                    return undefined;
+                return { path: absPath, namespace: 'runtime' };
+            });
+            // Load file contents from the runtime
+            build.onLoad({ filter: /.*/, namespace: 'runtime' }, 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            async (args) => {
+                // Strip root prefix to get runtime path (e.g. /app/root/routes/x.ts → /routes/x.ts)
+                const runtimePath = root && args.path.startsWith(root)
+                    ? args.path.slice(root.length)
+                    : args.path;
+                const contents = await runtime.query(runtimePath, { as: 'text' });
+                const ext = args.path.slice(args.path.lastIndexOf('.') + 1);
+                const loader = ext === 'ts' ? 'ts' : 'js';
+                const resolveDir = args.path.slice(0, args.path.lastIndexOf('/'));
+                return { contents, loader, resolveDir };
+            });
+        },
+    };
+}
+//# sourceMappingURL=esbuild-runtime-loader.plugin.js.map

package/dist/runtime/bun/esbuild-runtime-loader.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild-runtime-loader.plugin.js","sourceRoot":"","sources":["../../../runtime/bun/esbuild-runtime-loader.plugin.ts"],"names":[],"mappings":"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"}

package/dist/runtime/bun/fs/bun-fs.runtime.d.ts

@@ -0,0 +1,21 @@
+import { type FetchParams, type FetchReturn, Runtime, type RuntimeConfig } from '../../abstract.runtime.ts';
+export declare class BunFsRuntime extends Runtime {
+    private readonly root;
+    constructor(root: string, config?: RuntimeConfig);
+    handle(resource: FetchParams[0], init?: FetchParams[1]): FetchReturn;
+    query(resource: FetchParams[0], options: FetchParams[1] & {
+        as: 'text';
+    }): Promise<string>;
+    query(resource: FetchParams[0], options?: FetchParams[1]): FetchReturn;
+    private parsePath;
+    private parse;
+    private read;
+    private list;
+    private write;
+    loadModule(path: string): Promise<unknown>;
+    bundle(): Promise<void>;
+    private static _esbuild;
+    private static esbuild;
+    static transpile(source: string): Promise<string>;
+    static stopBundler(): Promise<void>;
+}