@swissjs/swite 0.3.0 → 0.3.1

package/dist/dev-engine/hmr/hmr-client-template.js

@@ -0,0 +1,122 @@
+/**
+ * Build the HMR client script served to the browser at /__swite_hmr_client.
+ *
+ * The client is plain JavaScript (no TS syntax) because it is injected into
+ * browser pages as-is. Keeping it in a separate module rather than embedded
+ * inside hmr.ts makes it editable with syntax highlighting and avoids
+ * template-literal escaping issues.
+ */
+export function buildHmrClientScript(port) {
+    return `// SWITE HMR Client
+console.log('[SWITE] HMR enabled');
+
+const socket = new WebSocket('ws://' + window.location.hostname + ':${port}');
+const moduleGraph = new Map();
+const hotModules = new Map();
+
+socket.addEventListener('open', () => {
+  console.log('[SWITE] HMR connected');
+});
+
+socket.addEventListener('message', async (event) => {
+  const data = JSON.parse(event.data);
+
+  if (data.type === 'update') {
+    console.log('[SWITE] Processing update:', data.path, 'Type:', data.updateType);
+
+    if (data.updateType === 'style') {
+      updateStyles();
+      console.log('[SWITE] Styles hot updated');
+    } else if (data.updateType === 'hot') {
+      const moduleName = extractModuleName(data.path);
+
+      if (moduleName && hotModules.has(moduleName)) {
+        try {
+          invalidateModule(moduleName);
+          invalidateDependents(moduleName);
+
+          const updatedModule = await import(data.path + '?t=' + Date.now());
+          hotModules.set(moduleName, updatedModule);
+
+          updateComponent(moduleName, updatedModule);
+          console.log('[SWITE] Component hot updated:', moduleName);
+        } catch (error) {
+          console.error('[SWITE] Hot update failed:', error);
+          window.location.reload();
+        }
+      } else {
+        console.log('[SWITE] New component detected, reloading page');
+        window.location.reload();
+      }
+    } else {
+      console.log('[SWITE] Full page reload required');
+      window.location.reload();
+    }
+  }
+});
+
+function updateStyles() {
+  const links = document.querySelectorAll('link[rel="stylesheet"]');
+  links.forEach(link => {
+    const href = link.getAttribute('href');
+    if (href) {
+      const base = href.replace(/[?&]t=\\d+/, '');
+      link.setAttribute('href', base + (base.includes('?') ? '&' : '?') + 't=' + Date.now());
+    }
+  });
+}
+
+function extractModuleName(filePath) {
+  const parts = filePath.split('/');
+  const fileName = parts[parts.length - 1];
+  return fileName ? fileName.replace(/\\.[^.]+$/, '') : null;
+}
+
+function invalidateModule(moduleName) {
+  if (window.__swiss_modules__) {
+    delete window.__swiss_modules__[moduleName];
+  }
+}
+
+function invalidateDependents(moduleName) {
+  const dependents = moduleGraph.get(moduleName);
+  if (dependents) {
+    for (const dependent of dependents) {
+      invalidateModule(dependent);
+    }
+  }
+}
+
+function updateComponent(moduleName, newModule) {
+  if (window.__swiss_instances__) {
+    const instances = window.__swiss_instances__[moduleName];
+    if (instances && Array.isArray(instances)) {
+      instances.forEach(instance => {
+        if (instance && typeof instance.update === 'function') {
+          instance.update(newModule.default || newModule);
+        }
+      });
+    }
+  }
+}
+
+socket.addEventListener('close', () => {
+  console.log('[SWITE] HMR disconnected');
+});
+
+socket.addEventListener('error', (error) => {
+  console.error('[SWITE] HMR error:', error);
+});
+
+window.__swiss_modules__ = window.__swiss_modules__ || {};
+window.__swiss_instances__ = window.__swiss_instances__ || {};
+
+const currentScript = document.currentScript;
+if (currentScript && currentScript.src) {
+  const moduleName = extractModuleName(currentScript.src);
+  if (moduleName) {
+    window.__swiss_modules__[moduleName] = true;
+  }
+}
+`;
+}

package/dist/dev-engine/hmr/hmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../../../src/dev-engine/hmr/hmr.ts"],"names":[],"mappings":"AAUA,qBAAa,SAAS;IAOlB,OAAO,CAAC,IAAI;IANd,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAAS;gBAGX,IAAI,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM;IAOZ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBnB,kBAAkB;IAUhC,OAAO,CAAC,cAAc;YAYR,YAAY;IAmB1B,OAAO,IAAI,MAAM;IAIX,KAAK;IA4BX,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYpC,eAAe,IAAI,MAAM;IAIzB,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,SAAS;IAcX,IAAI;CAIX"}

package/dist/{hmr.js → dev-engine/hmr/hmr.js}

@@ -5,6 +5,7 @@ import * as chokidar from "chokidar";
 import { WebSocketServer, WebSocket } from "ws";
 import * as net from "net";
 import chalk from "chalk";
+import { buildHmrClientScript } from "./hmr-client-template.js";
 export class HMREngine {
     constructor(root, hmrPort) {
         this.root = root;
@@ -98,140 +99,7 @@ export class HMREngine {
         });
     }
     getClientScript() {
-        return `
-// SWITE HMR Client
-console.log('[SWITE] HMR enabled');
-
-const socket = new WebSocket('ws://localhost:${this.port}');
-const moduleGraph = new Map<string, Set<string>>();
-const hotModules = new Map<string, any>();
-
-socket.addEventListener('open', () => {
-  console.log('[SWITE] HMR connected');
-});
-
-socket.addEventListener('message', (event) => {
-  const data = JSON.parse(event.data);
-  
-  if (data.type === 'update') {
-    console.log('[SWITE] Processing update:', data.path, 'Type:', data.updateType);
-    
-    if (data.updateType === 'style') {
-      // Hot swap CSS
-      updateStyles();
-      console.log('[SWITE] Styles hot updated');
-    } else if (data.updateType === 'hot') {
-      // Hot reload component
-      const moduleName = extractModuleName(data.path);
-      
-      if (moduleName && hotModules.has(moduleName)) {
-        const oldModule = hotModules.get(moduleName);
-        try {
-          invalidateModule(moduleName);
-          invalidateDependents(moduleName);
-          
-          const updatedModule = await import(data.path + '?t=' + Date.now());
-          hotModules.set(moduleName, updatedModule);
-          
-          updateComponent(moduleName, updatedModule);
-          console.log('[SWITE] Component hot updated:', moduleName);
-        } catch (error) {
-          console.error('[SWITE] Hot update failed:', error);
-          window.location.reload();
-        }
-      } else {
-        console.log('[SWITE] New component detected, reloading page');
-        window.location.reload();
-      }
-    } else {
-      // Full reload for everything else
-      console.log('[SWITE] Full page reload required');
-      window.location.reload();
-    }
-  }
-});
-
-function updateStyles() {
-  // Find all style and link tags
-  const styles = document.querySelectorAll('link[rel="stylesheet"], style');
-  styles.forEach(style => {
-    if (style.tagName === 'LINK' && style.getAttribute('href')) {
-      const href = style.getAttribute('href');
-      if (href && !href.includes('?t=')) {
-        // Add timestamp to force reload
-        style.setAttribute('href', href + '?t=' + Date.now());
-      }
-    }
-  });
-}
-
-function extractModuleName(path: string): string | null {
-  // Extract module name from file path
-  const parts = path.split('/');
-  const fileName = parts[parts.length - 1];
-  
-  if (fileName) {
-    const nameWithoutExt = fileName.replace(/.[^.]+$/, "");
-    return nameWithoutExt;
-  }
-  
-  return null;
-}
-
-function invalidateModule(moduleName: string) {
-  // Clear module from cache
-  if (typeof window !== 'undefined' && (window as any).__swiss_modules__) {
-    delete (window as any).__swiss_modules__[moduleName];
-  }
-}
-
-function invalidateDependents(moduleName: string) {
-  const dependents = moduleGraph.get(moduleName);
-  if (dependents) {
-    for (const dependent of dependents) {
-      invalidateModule(dependent);
-    }
-  }
-}
-
-function updateComponent(moduleName: string, newModule: any) {
-  // Find and update component instances
-  if (typeof window !== 'undefined' && (window as any).__swiss_instances__) {
-    const instances = (window as any).__swiss_instances__[moduleName];
-    if (instances && Array.isArray(instances)) {
-      instances.forEach(instance => {
-        // Update component state if it has update method
-        if (instance && typeof instance.update === 'function') {
-          instance.update(newModule.default || newModule);
-        }
-      });
-    }
-  }
-}
-
-socket.addEventListener('close', () => {
-  console.log('[SWITE] HMR disconnected');
-});
-
-socket.addEventListener('error', (error) => {
-  console.error('[SWITE] HMR error:', error);
-});
-
-// Register module for hot reloading
-if (typeof window !== 'undefined') {
-  (window as any).__swiss_modules__ = (window as any).__swiss_modules__ || {};
-  (window as any).__swiss_instances__ = (window as any).__swiss_instances__ || {};
-  
-  // Auto-register current module
-  const currentScript = document.currentScript;
-  if (currentScript && currentScript.src) {
-    const moduleName = extractModuleName(currentScript.src);
-    if (moduleName) {
-      (window as any).__swiss_modules__[moduleName] = true;
-    }
-  }
-}
-`;
+        return buildHmrClientScript(this.port);
     }
     getUpdateType(fileExt, filePath) {
         if (!fileExt || !filePath)

package/dist/{middleware → dev-engine/middleware}/hmr-routes.d.ts

@@ -1,6 +1,6 @@
 import type { Express } from "express";
-import type { RouteDefinition } from "@kibologic/core";
-import { HMREngine } from "../hmr.js";
+import type { RouteDefinition } from "@swissjs/core";
+import { HMREngine } from "../hmr/hmr.js";
 export interface HMRRoutesConfig {
     hmr: HMREngine;
     routes: RouteDefinition[];

package/dist/dev-engine/middleware/hmr-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr-routes.d.ts","sourceRoot":"","sources":["../../../src/dev-engine/middleware/hmr-routes.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAqG1E"}

package/dist/{middleware → dev-engine/middleware}/hmr-routes.js

@@ -3,7 +3,7 @@
  * SWITE - SWISS Development Server
  * Licensed under the MIT License.
  */
-import { HMREngine } from "../hmr.js";
+import { HMREngine } from "../hmr/hmr.js";
 /**
  * Setup HMR client endpoint and routes endpoint
  */

package/dist/dev-engine/middleware/middleware-setup.d.ts

@@ -0,0 +1,34 @@
+import type { Express } from "express";
+import type { RouteDefinition } from "@swissjs/core";
+import { RouteScanner } from "@swissjs/plugin-file-router/core";
+import { createFileWatcher } from "@swissjs/plugin-file-router/dev";
+import { ModuleResolver } from "../../resolution/resolver.js";
+import { HMREngine } from "../hmr/hmr.js";
+export interface MiddlewareConfig {
+    root: string;
+    workspaceRoot?: string | null;
+    publicDir: string;
+    resolver: ModuleResolver;
+    hmr: HMREngine;
+}
+export interface MiddlewareResult {
+    routes: RouteDefinition[];
+    routeScanner: RouteScanner | null;
+    routeWatcher: Awaited<ReturnType<typeof createFileWatcher>> | null;
+}
+/**
+ * Setup all middleware for the SWITE server.
+ *
+ * Middleware registration order (matters for Express):
+ *  1. File router + HMR routes
+ *  2. /packages source files
+ *  3. /src source files (highest priority for that prefix)
+ *  4. /lib source files (pre-static guard)
+ *  5. .ui/.uix MIME-type guard (belt-and-suspenders for slipped-through requests)
+ *  6. /.skltn/modules.css → 204
+ *  7. Static file serving (public/, node_modules/, lib/)
+ *  8. General source-file transformation (all other paths)
+ *  9. SPA fallback
+ */
+export declare function setupMiddleware(app: Express, config: MiddlewareConfig): Promise<MiddlewareResult>;
+//# sourceMappingURL=middleware-setup.d.ts.map

package/dist/dev-engine/middleware/middleware-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-setup.d.ts","sourceRoot":"","sources":["../../../src/dev-engine/middleware/middleware-setup.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAmC,MAAM,SAAS,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAIpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAa9D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK1C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,GAAG,IAAI,CAAC;CACpE;AAuBD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CA2Q3B"}

package/dist/dev-engine/middleware/middleware-setup.js

@@ -0,0 +1,327 @@
+/*
+ * Copyright (c) 2024 Themba Mzumara
+ * SWITE - SWISS Development Server
+ * Licensed under the MIT License.
+ */
+import { RouteScanner } from "@swissjs/plugin-file-router/core";
+import { createFileWatcher } from "@swissjs/plugin-file-router/dev";
+import chalk from "chalk";
+import path from "path";
+import fs from "fs/promises";
+import { ModuleResolver } from "../../resolution/resolver.js";
+import { UIHandler } from "../handlers/ui-handler.js";
+import { UIXHandler } from "../handlers/uix-handler.js";
+import { TSHandler } from "../handlers/ts-handler.js";
+import { JSHandler } from "../handlers/js-handler.js";
+import { MJSHandler } from "../handlers/mjs-handler.js";
+import { NodeModuleHandler } from "../handlers/node-module-handler.js";
+import { setupStaticFiles, setupSPAFallback } from "./static-files.js";
+import { setupHMRRoutes } from "./hmr-routes.js";
+import { setupFileRouter, } from "../router/file-router.js";
+import { HMREngine } from "../hmr/hmr.js";
+import { findWorkspaceRoot } from "../../kernel/workspace.js";
+import { loadImportMap } from "../../internal/generate-import-map.js";
+import { loadEnv } from "../../config/env.js";
+const SOURCE_EXTS = new Set([".ui", ".uix", ".ts", ".mjs"]);
+function isFileNotFoundError(error) {
+    return (error instanceof Error &&
+        (("code" in error && error.code === "ENOENT") ||
+            ("errno" in error && error.errno === -4058)));
+}
+function sendSourceError(res, error, fullPath) {
+    if (res.headersSent)
+        return;
+    const status = isFileNotFoundError(error) ? 404 : 500;
+    res.status(status).setHeader("Content-Type", "text/plain");
+    res.send(isFileNotFoundError(error)
+        ? `File not found: ${fullPath}`
+        : `Error loading module: ${error instanceof Error ? error.message : String(error)}`);
+}
+/**
+ * Setup all middleware for the SWITE server.
+ *
+ * Middleware registration order (matters for Express):
+ *  1. File router + HMR routes
+ *  2. /packages source files
+ *  3. /src source files (highest priority for that prefix)
+ *  4. /lib source files (pre-static guard)
+ *  5. .ui/.uix MIME-type guard (belt-and-suspenders for slipped-through requests)
+ *  6. /.skltn/modules.css → 204
+ *  7. Static file serving (public/, node_modules/, lib/)
+ *  8. General source-file transformation (all other paths)
+ *  9. SPA fallback
+ */
+export async function setupMiddleware(app, config) {
+    // ── 1. File router + HMR ───────────────────────────────────────────────────
+    const fileRouterResult = await setupFileRouter({
+        root: config.root,
+        hmr: config.hmr,
+    });
+    setupHMRRoutes(app, {
+        hmr: config.hmr,
+        routes: fileRouterResult.routes,
+    });
+    // ── Workspace + import-map setup ───────────────────────────────────────────
+    const workspaceRoot = await findWorkspaceRoot(config.root);
+    console.log(chalk.blue(`[SWITE] App root: ${config.root}`));
+    console.log(chalk.blue(`[SWITE] Workspace root: ${workspaceRoot}`));
+    const { join } = await import("node:path");
+    const importMapPath = join(config.root, ".swite", "import-map.json");
+    const importMap = await loadImportMap(importMapPath);
+    if (importMap) {
+        config.resolver.setImportMap(importMap);
+    }
+    else {
+        console.log(chalk.yellow(`[SWITE] No import map at ${importMapPath}, using runtime resolution`));
+    }
+    // ── Load .env files for import.meta.env inlining ──────────────────────────
+    const mode = process.env.NODE_ENV === "production" ? "production" : "development";
+    const env = loadEnv(config.root, mode);
+    // ── Create handlers ────────────────────────────────────────────────────────
+    const handlerContext = {
+        resolver: config.resolver,
+        root: config.root,
+        workspaceRoot,
+        env,
+    };
+    const uiHandler = new UIHandler(handlerContext);
+    const uixHandler = new UIXHandler(handlerContext);
+    const tsHandler = new TSHandler(handlerContext);
+    const jsHandler = new JSHandler(handlerContext);
+    const mjsHandler = new MJSHandler(handlerContext);
+    const nodeModuleHandler = new NodeModuleHandler(handlerContext);
+    // ── 2. /packages workspace source files ────────────────────────────────────
+    app.use("/packages", async (req, res, next) => {
+        const rawUrl = req.url?.split("?")[0] || "";
+        const fullUrl = "/packages" + (rawUrl.startsWith("/") ? rawUrl : "/" + rawUrl);
+        try {
+            if (fullUrl.endsWith(".ts") && !fullUrl.endsWith(".d.ts")) {
+                await tsHandler.handle(fullUrl, res);
+                if (res.headersSent)
+                    return;
+            }
+            else if (fullUrl.endsWith(".js") || fullUrl.endsWith(".mjs")) {
+                await (fullUrl.endsWith(".js") ? jsHandler : mjsHandler).handle(fullUrl, res);
+                if (res.headersSent)
+                    return;
+            }
+        }
+        catch (error) {
+            console.error(chalk.red(`[/packages] Error ${fullUrl}:`), error);
+            if (!res.headersSent)
+                res.status(500).setHeader("Content-Type", "text/plain").send(String(error));
+            return;
+        }
+        next();
+    });
+    // ── 3. /src source files ───────────────────────────────────────────────────
+    // When Express mounts at "/src", req.url is relative (e.g. "/index.ui")
+    app.use("/src", async (req, res, next) => {
+        const relativeUrl = req.url.split("?")[0];
+        const fullPath = "/src" + relativeUrl;
+        if (relativeUrl.endsWith(".ui")) {
+            if (res.headersSent)
+                return;
+            if (req.method === "HEAD") {
+                res.setHeader("Content-Type", "application/javascript; charset=utf-8");
+                res.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
+                res.setHeader("Pragma", "no-cache");
+                res.setHeader("Expires", "0");
+                return res.status(200).end();
+            }
+            try {
+                await uiHandler.handle(fullPath, res);
+                if (!res.headersSent)
+                    res.status(500).send("Internal server error: handler did not send response");
+            }
+            catch (error) {
+                console.error(chalk.red(`[/src] .ui error ${fullPath}:`), error);
+                sendSourceError(res, error, fullPath);
+            }
+            return;
+        }
+        if (relativeUrl.endsWith(".uix")) {
+            try {
+                await uixHandler.handle(fullPath, res);
+                if (!res.headersSent)
+                    res.status(500).setHeader("Content-Type", "text/plain").send("Error loading module");
+            }
+            catch (error) {
+                console.error(chalk.red(`[/src] .uix error ${fullPath}:`), error);
+                sendSourceError(res, error, fullPath);
+            }
+            return;
+        }
+        if (relativeUrl.endsWith(".ts") && !relativeUrl.endsWith(".d.ts")) {
+            try {
+                await tsHandler.handle(fullPath, res);
+                if (!res.headersSent)
+                    res.status(500).setHeader("Content-Type", "text/plain").send("Error loading module");
+            }
+            catch (error) {
+                console.error(chalk.red(`[/src] .ts error ${fullPath}:`), error);
+                sendSourceError(res, error, fullPath);
+            }
+            return;
+        }
+        if (relativeUrl.endsWith(".js") || relativeUrl.endsWith(".mjs")) {
+            try {
+                await (relativeUrl.endsWith(".js") ? jsHandler : mjsHandler).handle(fullPath, res);
+                if (res.headersSent)
+                    return;
+            }
+            catch {
+                // fall through to static file serving below
+            }
+            if (!res.headersSent)
+                return next();
+            return;
+        }
+        // Other files under /src (CSS, images, etc.) — serve as static
+        const filePath = path.join(config.root, "src", relativeUrl);
+        try {
+            const stats = await fs.stat(filePath);
+            if (!stats.isFile())
+                return next();
+            const ext = path.extname(relativeUrl).toLowerCase();
+            // Guard: source files should never reach here
+            if (SOURCE_EXTS.has(ext) || ext === ".js") {
+                res.status(404).setHeader("Content-Type", "text/plain");
+                return res.send(`Source file not found: ${fullPath}`);
+            }
+            const contentTypeMap = {
+                ".css": "text/css",
+                ".json": "application/json",
+                ".png": "image/png",
+                ".jpg": "image/jpeg",
+                ".jpeg": "image/jpeg",
+                ".gif": "image/gif",
+                ".svg": "image/svg+xml",
+                ".webp": "image/webp",
+            };
+            const content = await fs.readFile(filePath);
+            res.setHeader("Content-Type", contentTypeMap[ext] || "application/octet-stream");
+            res.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
+            res.setHeader("Pragma", "no-cache");
+            res.setHeader("Expires", "0");
+            res.send(content);
+        }
+        catch {
+            res.status(404).setHeader("Content-Type", "text/plain");
+            res.send(`File not found: ${fullPath}`);
+        }
+    });
+    // ── 4. /lib source files (pre-static guard) ────────────────────────────────
+    app.use(async (req, res, next) => {
+        const url = req.url.split("?")[0];
+        if (!url.startsWith("/lib/"))
+            return next();
+        const isSource = url.endsWith(".ui") ||
+            url.endsWith(".uix") ||
+            url.endsWith(".ts") ||
+            (url.endsWith(".js") && !url.includes("node_modules"));
+        if (!isSource)
+            return next();
+        res.setHeader("Content-Type", "application/javascript; charset=utf-8");
+        try {
+            if (url.endsWith(".ui")) {
+                await uiHandler.handle(url, res);
+                return;
+            }
+            if (url.endsWith(".uix")) {
+                await uixHandler.handle(url, res);
+                return;
+            }
+            // .ts/.js — fall through to general middleware
+            return next();
+        }
+        catch (error) {
+            console.error(chalk.red(`[/lib] Error ${url}:`), error);
+            if (!res.headersSent)
+                res.status(500).send("Internal server error");
+        }
+    });
+    // ── 5. .ui/.uix MIME guard (belt-and-suspenders) ──────────────────────────
+    app.use((req, res, next) => {
+        const url = req.url.split("?")[0];
+        if (url.endsWith(".ui") || url.endsWith(".uix")) {
+            res.setHeader("Content-Type", "application/javascript; charset=utf-8");
+        }
+        next();
+    });
+    // ── 6. /.skltn/modules.css → 204 (dev mode — CSS not bundled) ─────────────
+    app.use("/.skltn/modules.css", (_req, res) => {
+        res.status(204).end();
+    });
+    // ── 7. Static file serving ─────────────────────────────────────────────────
+    await setupStaticFiles(app, {
+        root: config.root,
+        publicDir: config.publicDir,
+        workspaceRoot: config.workspaceRoot ?? null,
+    });
+    // ── 8. General source-file transformation ──────────────────────────────────
+    app.use(async (req, res, next) => {
+        const url = req.url.split("?")[0];
+        // /src is already handled above
+        if (url.startsWith("/src"))
+            return next();
+        // /lib static files are handled by static middleware; source files handled above
+        if (url.startsWith("/lib/")) {
+            const isSource = url.endsWith(".ui") ||
+                url.endsWith(".uix") ||
+                url.endsWith(".ts") ||
+                (url.endsWith(".js") && !url.includes("node_modules"));
+            if (!isSource)
+                return next();
+        }
+        try {
+            if (url.endsWith(".ui")) {
+                res.setHeader("Content-Type", "application/javascript; charset=utf-8");
+                if (res.headersSent)
+                    return;
+                await uiHandler.handle(url, res);
+                if (!res.headersSent)
+                    res.status(500).send("Internal server error: handler did not send response");
+                return;
+            }
+            if (url.endsWith(".uix")) {
+                await uixHandler.handle(url, res);
+                return;
+            }
+            if (url.endsWith(".ts") && !url.endsWith(".d.ts")) {
+                await tsHandler.handle(url, res);
+                return;
+            }
+            if ((url.endsWith(".js") || url.endsWith(".mjs")) && url.includes("node_modules")) {
+                await nodeModuleHandler.handle(url, res);
+                return;
+            }
+            if (url.endsWith(".js")) {
+                await jsHandler.handle(url, res);
+                return;
+            }
+            if (url.endsWith(".mjs")) {
+                await mjsHandler.handle(url, res);
+                return;
+            }
+            // Static assets — pass to static middleware
+            next();
+        }
+        catch (error) {
+            console.error(chalk.red(`[middleware] Error ${url}:`), error);
+            if (!res.headersSent) {
+                res.status(500).send(`Error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    });
+    // ── 9. SPA fallback ────────────────────────────────────────────────────────
+    await setupSPAFallback(app, {
+        root: config.root,
+        publicDir: config.publicDir,
+    });
+    return {
+        routes: fileRouterResult.routes,
+        routeScanner: fileRouterResult.routeScanner,
+        routeWatcher: fileRouterResult.routeWatcher,
+    };
+}

package/dist/dev-engine/middleware/static-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-files.d.ts","sourceRoot":"","sources":["../../../src/dev-engine/middleware/static-files.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMvC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAuYf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CA+Sf"}