almostnode 0.2.5 → 0.2.6

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 almostnode contributors
+Copyright (c) 2026 almostnode contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/__sw__.js

@@ -1,7 +1,7 @@
 /**
  * Service Worker for Mini WebContainers
  * Intercepts fetch requests and routes them to virtual servers
- * Version: 13 - redirect navigation requests from virtual context to include prefix
+ * Version: 14 - forward ALL requests from virtual context (images, scripts, navigation) to virtual server
  */
 
 // Communication port with main thread
@@ -212,26 +212,35 @@ self.addEventListener('fetch', (event) => {
   const match = url.pathname.match(/^\/__virtual__\/(\d+)(\/.*)?$/);
 
   if (!match) {
-    // Not a virtual request - but check if it's a navigation from a virtual context
-    // This handles plain <a href="/about"> links that should stay within the virtual server
-    if (event.request.mode === 'navigate') {
-      const referer = event.request.referrer;
-      if (referer) {
-        try {
-          const refererUrl = new URL(referer);
-          const refererMatch = refererUrl.pathname.match(/^\/__virtual__\/(\d+)/);
-          if (refererMatch) {
-            // User clicked a link from within a virtual server context
-            // Redirect to include the virtual prefix
-            const virtualPrefix = refererMatch[0];
-            const redirectUrl = url.origin + virtualPrefix + url.pathname + url.search;
+    // Not a virtual request - but check if it's from a virtual context
+    // This handles plain <a href="/about"> links and asset requests (images, scripts)
+    // that should stay within the virtual server
+    const referer = event.request.referrer;
+    if (referer) {
+      try {
+        const refererUrl = new URL(referer);
+        const refererMatch = refererUrl.pathname.match(/^\/__virtual__\/(\d+)/);
+        if (refererMatch) {
+          // Request from within a virtual server context
+          const virtualPrefix = refererMatch[0];
+          const virtualPort = parseInt(refererMatch[1], 10);
+          const targetPath = url.pathname + url.search;
+
+          if (event.request.mode === 'navigate') {
+            // Navigation requests: redirect to include the virtual prefix
+            const redirectUrl = url.origin + virtualPrefix + targetPath;
             console.log('[SW] Redirecting navigation from virtual context:', url.pathname, '->', redirectUrl);
             event.respondWith(Response.redirect(redirectUrl, 302));
             return;
+          } else {
+            // Non-navigation requests (images, scripts, etc.): forward to virtual server
+            console.log('[SW] Forwarding resource from virtual context:', url.pathname);
+            event.respondWith(handleVirtualRequest(event.request, virtualPort, targetPath));
+            return;
           }
-        } catch (e) {
-          // Invalid referer URL, ignore
         }
+      } catch (e) {
+        // Invalid referer URL, ignore
       }
     }
     // Not a virtual request, let it pass through

package/dist/frameworks/next-dev-server.d.ts

@@ -16,6 +16,8 @@ export interface NextDevServerOptions extends DevServerOptions {
     preferAppRouter?: boolean;
     /** Environment variables (NEXT_PUBLIC_* are available in browser code via process.env) */
     env?: Record<string, string>;
+    /** Asset prefix for static files (e.g., '/marketing'). Auto-detected from next.config if not specified. */
+    assetPrefix?: string;
 }
 /**
  * NextDevServer - A lightweight Next.js-compatible development server
@@ -57,7 +59,31 @@ export declare class NextDevServer extends DevServer {
     private options;
     /** Transform result cache for performance */
     private transformCache;
+    /** Path aliases from tsconfig.json (e.g., @/* -> ./*) */
+    private pathAliases;
+    /** Cached Tailwind config script (injected before CDN) */
+    private tailwindConfigScript;
+    /** Whether Tailwind config has been loaded */
+    private tailwindConfigLoaded;
+    /** Asset prefix for static files (e.g., '/marketing') */
+    private assetPrefix;
     constructor(vfs: VirtualFS, options: NextDevServerOptions);
+    /**
+     * Load path aliases from tsconfig.json
+     * Supports common patterns like @/* -> ./*
+     */
+    private loadPathAliases;
+    /**
+     * Load assetPrefix from options or auto-detect from next.config.ts/js
+     * The assetPrefix is used to prefix static asset URLs (e.g., '/marketing')
+     */
+    private loadAssetPrefix;
+    /**
+     * Resolve path aliases in transformed code
+     * Converts imports like "@/components/foo" to "/__virtual__/PORT/components/foo"
+     * This ensures imports go through the virtual server instead of the main server
+     */
+    private resolvePathAliases;
     /**
      * Set an environment variable at runtime
      * NEXT_PUBLIC_* variables will be available via process.env in browser code
@@ -75,8 +101,14 @@ export declare class NextDevServer extends DevServer {
     /**
      * Generate a script tag that defines process.env with NEXT_PUBLIC_* variables
      * This makes environment variables available to browser code via process.env.NEXT_PUBLIC_*
+     * Also includes all env variables for Server Component compatibility
      */
     private generateEnvScript;
+    /**
+     * Load Tailwind config from tailwind.config.ts and generate a script
+     * that configures the Tailwind CDN at runtime
+     */
+    private loadTailwindConfigIfNeeded;
     /**
      * Check if App Router is available
      */
@@ -89,6 +121,11 @@ export declare class NextDevServer extends DevServer {
      * Serve Next.js shims (link, router, head, navigation)
      */
     private serveNextShim;
+    /**
+     * Serve route info for client-side navigation
+     * Returns params extracted from dynamic route segments
+     */
+    private serveRouteInfo;
     /**
      * Serve static assets from /_next/static/
      */
@@ -150,6 +187,7 @@ export declare class NextDevServer extends DevServer {
     private resolveAppRoute;
     /**
      * Resolve dynamic App Router routes like /app/[id]/page.jsx
+     * Also extracts route params from dynamic segments
      */
     private resolveAppDynamicRoute;
     /**
@@ -172,6 +210,12 @@ export declare class NextDevServer extends DevServer {
      * Serve a basic 404 page
      */
     private serve404Page;
+    /**
+     * Try to resolve a file path by adding common extensions
+     * e.g., /components/faq -> /components/faq.tsx
+     * Also handles index files in directories
+     */
+    private resolveFileWithExtension;
     /**
      * Check if a file needs transformation
      */
@@ -184,6 +228,14 @@ export declare class NextDevServer extends DevServer {
      * Transform JSX/TS code to browser-compatible JavaScript (ESM for browser)
      */
     private transformCode;
+    /**
+     * Redirect bare npm package imports to esm.sh CDN
+     * e.g., import { Crisp } from "crisp-sdk-web" -> import { Crisp } from "https://esm.sh/crisp-sdk-web?external=react"
+     *
+     * IMPORTANT: We redirect ALL npm packages to esm.sh URLs (including React)
+     * because import maps don't work reliably for dynamically imported modules.
+     */
+    private redirectNpmImports;
     /**
      * Strip CSS imports from code (they are loaded via <link> tags instead)
      * Handles: import './styles.css', import '../globals.css', etc.
@@ -205,6 +257,15 @@ export declare class NextDevServer extends DevServer {
      * Handle file change event
      */
     private handleFileChange;
+    /**
+     * Override serveFile to wrap JSON files as ES modules
+     * This is needed because browsers can't dynamically import raw JSON files
+     */
+    protected serveFile(filePath: string): ResponseData;
+    /**
+     * Resolve a path (helper to access protected method from parent)
+     */
+    protected resolvePath(urlPath: string): string;
     /**
      * Stop the server
      */

package/dist/frameworks/next-dev-server.d.ts.map

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

package/dist/frameworks/tailwind-config-loader.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tailwind Config Loader
+ *
+ * Parses tailwind.config.ts files and generates JavaScript to configure
+ * the Tailwind CDN at runtime via window.tailwind.config.
+ */
+import type { VirtualFS } from '../virtual-fs';
+export interface TailwindConfigResult {
+    /** JavaScript code to set window.tailwind.config (empty string if no config) */
+    configScript: string;
+    /** Whether config was successfully loaded */
+    success: boolean;
+    /** Error message if loading failed */
+    error?: string;
+}
+/**
+ * Load and parse a Tailwind config file from VirtualFS
+ */
+export declare function loadTailwindConfig(vfs: VirtualFS, root?: string): Promise<TailwindConfigResult>;
+/**
+ * Strip TypeScript-specific syntax from config content
+ */
+export declare function stripTypescriptSyntax(content: string): string;
+/**
+ * Extract the config object from the processed content
+ */
+export declare function extractConfigObject(content: string): string | null;
+/**
+ * Generate the script to inject the Tailwind config
+ */
+export declare function generateConfigScript(configObject: string): string;
+//# sourceMappingURL=tailwind-config-loader.d.ts.map

package/dist/frameworks/tailwind-config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-config-loader.d.ts","sourceRoot":"","sources":["../../src/frameworks/tailwind-config-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,SAAS,EACd,IAAI,GAAE,MAAY,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAyD/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwB7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuElE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAOjE"}