@swissjs/swite 0.3.3 → 0.3.5

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.3.5
+
+### Patch Changes
+
+- deps: bump @swissjs/core 0.1.10 → 0.1.11 (browser hotfix — guards `process.env` in reconciliation to prevent ReferenceError crash in browser environments)
+
+## 0.3.4
+
+### Patch Changes
+
+- fix(resolution): `findSwissLibMonorepo` now accepts `siblingRepositories` from user config, making sibling repo discovery configurable (#1)
+- fix(resolution): Compiler path fixup (`/swiss-lib/` → `/swiss-packages/`) is now configurable via `compilerPathFixup` config key; can be disabled or given custom patterns (#2)
+- fix(config): Added `publicDir`, `hmrPort`, `hmrHost`, `aliases`, `excludeFromHmr`, and `entry` to `SwiteUserConfig` (#3)
+- fix(resolution): CDN fallback default changed to `false`; unscoped packages no longer fall through to jsDelivr without explicit `SWITE_CDN_FALLBACK_SCOPES` opt-in (#4)
+- fix(hmr): HMR watcher now handles `add` and `unlink` events with full-page reload; `excludeFromHmr` patterns added to chokidar `ignored` list (#5)
+- fix(dx): Added `--verbose` / `-v` flag and `SWITE_DEBUG=1` env var for resolver diagnostics; unresolved packages now log searched paths (#6)
+- fix(static): CSS extraction entry point configurable via `SwiteUserConfig.entry` (defaults to `src/index.ui`); missing entry file no longer crashes server (#7)
+- deps: bump `@swissjs/core` 0.1.9 → 0.1.10
+
 ## 0.3.3
 
 ### Patch Changes

package/dist/cli.js

@@ -7,6 +7,10 @@ import { startPythonDevService, stopPythonDevService, } from "./dev-engine/pytho
 import { setProductionMode } from "./adapters/proxy/proxyToPython.js";
 const [, , command, ...args] = process.argv;
 const root = resolve(process.cwd());
+// --verbose / -v enables full resolver diagnostic output
+if (args.includes("--verbose") || args.includes("-v")) {
+    process.env["SWITE_DEBUG"] = "1";
+}
 async function dev() {
     const config = await loadUserConfig(root);
     const python = config.services?.python;
@@ -26,7 +30,8 @@ async function dev() {
         root,
         port: config.server?.port ?? 3000,
         host: config.server?.host ?? "localhost",
-        publicDir: "public",
+        hmrPort: config.server?.hmrPort,
+        publicDir: config.publicDir ?? "public",
         open: false,
     });
     await server.start();
@@ -43,7 +48,8 @@ async function start() {
         root,
         port: config.server?.port ?? 3000,
         host: config.server?.host ?? "localhost",
-        publicDir: "public",
+        hmrPort: config.server?.hmrPort,
+        publicDir: config.publicDir ?? "public",
         open: false,
     });
     await server.start();

package/dist/config/config.d.ts

@@ -16,10 +16,34 @@ export interface ServicesConfig {
 export interface ServerConfig {
     port?: number;
     host?: string;
+    /** Port for the HMR WebSocket server. Defaults to 24678. */
+    hmrPort?: number;
+    /** Host for the HMR WebSocket server. Defaults to server.host. */
+    hmrHost?: string;
 }
 export interface SwiteUserConfig {
     server?: ServerConfig;
     services?: ServicesConfig;
+    /**
+     * Directory to serve static assets from. Defaults to "public".
+     * Path is relative to the project root.
+     */
+    publicDir?: string;
+    /**
+     * Application entry file for CSS extraction. Defaults to "src/index.ui".
+     * Path is relative to the project root.
+     */
+    entry?: string;
+    /**
+     * Module aliases resolved during bare import resolution.
+     * e.g. { "@/": "src/" } maps @/ imports to the src/ directory.
+     */
+    aliases?: Record<string, string>;
+    /**
+     * Glob patterns to exclude from HMR watching in addition to the defaults
+     * (node_modules, .git, dist). Useful for generated files or large assets.
+     */
+    excludeFromHmr?: string[];
     /**
      * Package scopes that should be treated as "internal" or "private".
      * These scopes prioritize local/monorepo resolution and are forbidden from CDN redirects.
@@ -27,10 +51,23 @@ export interface SwiteUserConfig {
      */
     internalScopes?: string[];
     /**
-     * Manual override for sibling repository lookup.
-     * Swite will search these directories for local package source code.
+     * Names of sibling monorepos to search for framework packages.
+     * Defaults to ['swiss-lib']. Override when your framework lives in a differently-named repo.
      */
     siblingRepositories?: string[];
+    /**
+     * Control the compiler path fixup that rewrites `/swiss-lib/` → `/swiss-packages/`.
+     * Disable entirely or supply custom from/to pairs when your project uses different paths.
+     */
+    compilerPathFixup?: {
+        /** When false, no path fixup is applied. Defaults to true for backward compatibility. */
+        enabled?: boolean;
+        /** Custom replacement patterns. Defaults to the built-in swiss-lib → swiss-packages pairs. */
+        patterns?: Array<{
+            from: string;
+            to: string;
+        }>;
+    };
 }
 /**
  * Define swite configuration with full TypeScript validation.

package/dist/config/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAErE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B;;;OAGG;IACH,iBAAiB,CAAC,EAAE;QAClB,yFAAyF;QACzF,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,8FAA8F;QAC9F,QAAQ,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAErE"}

package/dist/dev-engine/handlers/ui-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-handler.d.ts","sourceRoot":"","sources":["../../../src/dev-engine/handlers/ui-handler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQxC,OAAO,EACL,WAAW,EAEX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,SAAU,SAAQ,WAAW;IACxC,OAAO,CAAC,QAAQ,CAAoB;gBAExB,OAAO,EAAE,cAAc;IAI7B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAkExD"}
+{"version":3,"file":"ui-handler.d.ts","sourceRoot":"","sources":["../../../src/dev-engine/handlers/ui-handler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQxC,OAAO,EACL,WAAW,EAEX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,SAAU,SAAQ,WAAW;IACxC,OAAO,CAAC,QAAQ,CAAoB;gBAExB,OAAO,EAAE,cAAc;IAI7B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAuExD"}

package/dist/dev-engine/handlers/ui-handler.js

@@ -26,10 +26,13 @@ export class UIHandler extends BaseHandler {
             console.error(chalk.red(`[.ui] File not found: ${filePath}`));
             throw new Error(`File not found: ${url} (resolved to: ${filePath})`);
         }
+        const pathFixupEnabled = this.context.userConfig?.compilerPathFixup?.enabled !== false;
+        const pathFixupPatterns = this.context.userConfig?.compilerPathFixup?.patterns;
+        const applyPathFixup = (code) => pathFixupEnabled ? fixSwissLibPaths(code, pathFixupPatterns) : code;
         // Cache hit
         const cached = await compilationCache.get(filePath, (compiled) => this.getDependencies(compiled));
         if (cached) {
-            const fixed = fixSwissLibPaths(cached);
+            const fixed = applyPathFixup(cached);
             setDevHeaders(res);
             res.setHeader("Content-Type", "application/javascript; charset=utf-8");
             res.setHeader("Content-Length", Buffer.byteLength(fixed, "utf-8"));
@@ -48,7 +51,7 @@ export class UIHandler extends BaseHandler {
         });
         compiled = tsResult.code;
         // Fix compiler-emitted wrong paths before import rewriting
-        compiled = fixSwissLibPaths(compiled);
+        compiled = applyPathFixup(compiled);
         // Inline import.meta.env references before import rewriting
         compiled = inlineEnvReferences(compiled, this.context.env);
         // Strip CSS static-asset imports — they are not ES modules
@@ -58,7 +61,7 @@ export class UIHandler extends BaseHandler {
             console.warn(`[.ui] Compiled output contains bare imports: ${url}`);
         }
         const rewritten = await rewriteImports(compiled, filePath, this.context.resolver);
-        const finalCode = fixSwissLibPaths(rewritten);
+        const finalCode = applyPathFixup(rewritten);
         await compilationCache.set(filePath, compiled, finalCode, (c) => this.getDependencies(c));
         if (bareImportPattern.test(finalCode)) {
             console.error(`[.ui] Bare imports still present after rewriting: ${url}`);

package/dist/dev-engine/handlers/uix-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uix-handler.d.ts","sourceRoot":"","sources":["../../../src/dev-engine/handlers/uix-handler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQxC,OAAO,EACL,WAAW,EAEX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAO,CAAC,QAAQ,CAAoB;gBAExB,OAAO,EAAE,cAAc;IAI7B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA8DxD"}
+{"version":3,"file":"uix-handler.d.ts","sourceRoot":"","sources":["../../../src/dev-engine/handlers/uix-handler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAQxC,OAAO,EACL,WAAW,EAEX,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAO,CAAC,QAAQ,CAAoB;gBAExB,OAAO,EAAE,cAAc;IAI7B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAmExD"}

package/dist/dev-engine/handlers/uix-handler.js

@@ -19,10 +19,13 @@ export class UIXHandler extends BaseHandler {
     async handle(url, res) {
         const filePath = await this.resolveFilePath(url);
         console.log(chalk.blue(`[.uix] ${url}`));
+        const pathFixupEnabled = this.context.userConfig?.compilerPathFixup?.enabled !== false;
+        const pathFixupPatterns = this.context.userConfig?.compilerPathFixup?.patterns;
+        const applyPathFixup = (code) => pathFixupEnabled ? fixSwissLibPaths(code, pathFixupPatterns) : code;
         // Cache hit
         const cached = await compilationCache.get(filePath, (compiled) => this.getDependencies(compiled));
         if (cached) {
-            const fixed = fixSwissLibPaths(cached);
+            const fixed = applyPathFixup(cached);
             setDevHeaders(res);
             res.setHeader("Content-Type", "application/javascript; charset=utf-8");
             res.send(fixed);
@@ -40,7 +43,7 @@ export class UIXHandler extends BaseHandler {
         });
         compiled = tsResult.code;
         // Fix compiler-emitted wrong paths before import rewriting
-        compiled = fixSwissLibPaths(compiled);
+        compiled = applyPathFixup(compiled);
         // Inline import.meta.env references before import rewriting
         compiled = inlineEnvReferences(compiled, this.context.env);
         // Strip CSS static-asset imports — they are not ES modules
@@ -55,7 +58,7 @@ export class UIXHandler extends BaseHandler {
             console.warn(`[.uix] Compiled output contains bare imports: ${url}`);
         }
         const rewritten = await rewriteImports(compiled, filePath, this.context.resolver);
-        const finalCode = fixSwissLibPaths(rewritten);
+        const finalCode = applyPathFixup(rewritten);
         await compilationCache.set(filePath, compiled, finalCode, (c) => this.getDependencies(c));
         if (bareImportPattern.test(finalCode)) {
             console.error(`[.uix] Bare imports still present after rewriting: ${url}`);

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

@@ -10,7 +10,7 @@ export declare class HMREngine {
     private setupWebSocket;
     private findFreePort;
     getPort(): number;
-    start(): Promise<void>;
+    start(excludeFromHmr?: string[]): Promise<void>;
     notifyChange(filePath: string): void;
     getClientScript(): string;
     private getUpdateType;

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

@@ -1 +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"}
+{"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,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE;IA2CrC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYpC,eAAe,IAAI,MAAM;IAIzB,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,SAAS;IAeX,IAAI;CAIX"}

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

@@ -65,9 +65,11 @@ export class HMREngine {
     getPort() {
         return this.port;
     }
-    async start() {
+    async start(excludeFromHmr) {
+        const baseIgnored = ["**/node_modules/**", "**/.git/**", "**/dist/**"];
+        const ignored = excludeFromHmr ? [...baseIgnored, ...excludeFromHmr] : baseIgnored;
         this.watcher = chokidar.watch(this.root, {
-            ignored: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
+            ignored,
             ignoreInitial: true,
             awaitWriteFinish: {
                 stabilityThreshold: 100,
@@ -86,6 +88,16 @@ export class HMREngine {
                 timestamp: Date.now(),
             });
         });
+        this.watcher.on("add", (filePath) => {
+            console.log(chalk.yellow(`[HMR] File added: ${filePath}`));
+            // New file — dependents are unknown, trigger a full reload
+            this.broadcast({ type: "reload", path: filePath, reason: "file-added" });
+        });
+        this.watcher.on("unlink", (filePath) => {
+            console.log(chalk.yellow(`[HMR] File deleted: ${filePath}`));
+            // Deleted file — its dependents will 404 on next import, trigger reload
+            this.broadcast({ type: "reload", path: filePath, reason: "file-deleted" });
+        });
         console.log(chalk.green("[HMR] Watching for file changes..."));
     }
     notifyChange(filePath) {

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

@@ -1 +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;IACf,UAAU,CAAC,EAAE,OAAO,wBAAwB,EAAE,eAAe,CAAC;CAC/D;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"}
+{"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;IACf,UAAU,CAAC,EAAE,OAAO,wBAAwB,EAAE,eAAe,CAAC;CAC/D;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,CA6Q3B"}

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

@@ -83,6 +83,7 @@ export async function setupMiddleware(app, config) {
         root: config.root,
         workspaceRoot,
         env,
+        userConfig: config.userConfig,
     };
     const uiHandler = new UIHandler(handlerContext);
     const uixHandler = new UIXHandler(handlerContext);
@@ -318,6 +319,7 @@ export async function setupMiddleware(app, config) {
     await setupSPAFallback(app, {
         root: config.root,
         publicDir: config.publicDir,
+        entry: config.userConfig?.entry,
     });
     return {
         routes: fileRouterResult.routes,

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

@@ -3,6 +3,8 @@ export interface StaticFilesConfig {
     root: string;
     publicDir: string;
     workspaceRoot?: string | null;
+    /** Entry file for CSS extraction, relative to root. Defaults to "src/index.ui". */
+    entry?: string;
 }
 /**
  * Setup static file serving for public directory, node_modules, and workspace packages

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

@@ -1 +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"}
+{"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;IAC9B,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;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,CAgTf"}

package/dist/dev-engine/middleware/static-files.js

@@ -412,7 +412,8 @@ export async function setupSPAFallback(app, config) {
         console.log(chalk.magenta(`[SWITE CSS] ========== CSS EXTRACTION START (VERSION 3.0.0) ==========`));
         console.log(chalk.magenta(`[SWITE CSS] App root: ${config.root}`));
         try {
-            const entryPointPath = path.join(config.root, "src", "index.ui");
+            const entryFile = config.entry ?? "src/index.ui";
+            const entryPointPath = path.join(config.root, entryFile);
             console.log(chalk.blue(`[SWITE CSS] Checking entry point: ${entryPointPath}`));
             const entryPointContent = await fs.readFile(entryPointPath, "utf-8");
             // Extract CSS imports using regex

package/dist/dev-engine/server.js

@@ -61,6 +61,8 @@ export class SwiteServer {
         const startTime = Date.now();
         console.log(chalk.cyan("\n⚡ SWITE - SWISS Development Server\n"));
         console.time("Startup");
+        // Load user config (swiss.config.ts) so internalScopes etc. flow into handlers
+        const userConfig = await loadUserConfig(this.config.root);
         // CG-03: Build symlink registry before serving any requests.
         // Maps realpath(node_modules/pkg symlink) → /node_modules/pkg browser URL
         // so toUrl() can map absolute filesystem paths back to browser URLs.
@@ -77,7 +79,7 @@ export class SwiteServer {
             if (workspaceRoot) {
                 nodeModulesDirs.push(path.join(workspaceRoot, "node_modules"));
             }
-            const swissLib = await findSwissLibMonorepo(this.config.root);
+            const swissLib = await findSwissLibMonorepo(this.config.root, userConfig?.siblingRepositories);
             if (swissLib) {
                 nodeModulesDirs.push(path.join(swissLib, "node_modules"));
             }
@@ -87,8 +89,6 @@ export class SwiteServer {
             console.warn(`[SWITE] Symlink registry build failed: ${err.message}`);
         }
         console.timeEnd("Symlink Registry");
-        // Load user config (swiss.config.ts) so internalScopes etc. flow into handlers
-        const userConfig = await loadUserConfig(this.config.root);
         // Setup middleware
         console.time("Middleware Setup");
         const workspaceRoot = await this.findWorkspaceRoot(this.config.root);
@@ -107,7 +107,7 @@ export class SwiteServer {
         // Start HMR
         console.time("HMR Start");
         await this.hmr.initialize();
-        await this.hmr.start();
+        await this.hmr.start(userConfig?.excludeFromHmr);
         console.timeEnd("HMR Start");
         // Start HTTP server
         // Use 0.0.0.0 to bind to all interfaces (IPv4 and IPv6)

package/dist/kernel/package-finder.d.ts

@@ -11,9 +11,12 @@ export interface PackageLocation {
  */
 export declare function findSiblingRepository(startPath: string, repoName: string): Promise<string | null>;
 /**
- * Backward compatibility wrapper for finding swiss-lib
+ * Find the co-located framework monorepo. Tries each name in `fallbackNames`
+ * in order and returns the first match. The default list is ['swiss-lib'] for
+ * backward compatibility; callers that have a user config should forward
+ * `userConfig.siblingRepositories` here to make the lookup configurable.
  */
-export declare function findSwissLibMonorepo(startPath: string): Promise<string | null>;
+export declare function findSwissLibMonorepo(startPath: string, fallbackNames?: string[]): Promise<string | null>;
 /**
  * Find a specific package by name, with priority given based on environment.
  * In development, we prioritize local sibling source code.

package/dist/kernel/package-finder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-finder.d.ts","sourceRoot":"","sources":["../../src/kernel/package-finder.ts"],"names":[],"mappings":"AASA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;CAClD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyBvG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEpF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC5B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAuEjC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2B7E"}
+{"version":3,"file":"package-finder.d.ts","sourceRoot":"","sources":["../../src/kernel/package-finder.ts"],"names":[],"mappings":"AASA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;CAClD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyBvG;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAM,EAAkB,GACtC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC5B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAuEjC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA2B7E"}

package/dist/kernel/package-finder.js

@@ -35,10 +35,18 @@ export async function findSiblingRepository(startPath, repoName) {
     return null;
 }
 /**
- * Backward compatibility wrapper for finding swiss-lib
+ * Find the co-located framework monorepo. Tries each name in `fallbackNames`
+ * in order and returns the first match. The default list is ['swiss-lib'] for
+ * backward compatibility; callers that have a user config should forward
+ * `userConfig.siblingRepositories` here to make the lookup configurable.
  */
-export async function findSwissLibMonorepo(startPath) {
-    return findSiblingRepository(startPath, 'swiss-lib');
+export async function findSwissLibMonorepo(startPath, fallbackNames = ['swiss-lib']) {
+    for (const name of fallbackNames) {
+        const result = await findSiblingRepository(startPath, name);
+        if (result)
+            return result;
+    }
+    return null;
 }
 /**
  * Find a specific package by name, with priority given based on environment.

package/dist/resolution/bare-import-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bare-import-resolver.d.ts","sourceRoot":"","sources":["../../src/resolution/bare-import-resolver.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,kBAAkB,EAAmC,MAAM,mBAAmB,CAAC;AAI7F,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,uBAAuB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CA4NjB"}
+{"version":3,"file":"bare-import-resolver.d.ts","sourceRoot":"","sources":["../../src/resolution/bare-import-resolver.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,kBAAkB,EAAmC,MAAM,mBAAmB,CAAC;AAI7F,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,uBAAuB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACtE;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAqOjB"}

package/dist/resolution/bare-import-resolver.js

@@ -13,6 +13,7 @@ import { toUrl } from "./url-resolver.js";
  * Resolve bare import specifier (e.g., @swissjs/core, react, etc.)
  */
 export async function resolveBareImport(specifier, context) {
+    const debug = process.env["SWITE_DEBUG"] === "1";
     // Extract package name outside the try/catch so fallback logic can reference it.
     // This must stay project-agnostic: works for both scoped and unscoped packages.
     const parts = specifier.split("/");
@@ -40,6 +41,9 @@ export async function resolveBareImport(specifier, context) {
                 nodeModulesLocations.push(swissNodeModules);
             }
         }
+        if (debug) {
+            console.log(`[swite:resolve] Trying "${specifier}" in:`, nodeModulesLocations);
+        }
         // Try each location
         for (const nodeModulesPath of nodeModulesLocations) {
             const testPkgDir = path.join(nodeModulesPath, pkgName);
@@ -56,10 +60,14 @@ export async function resolveBareImport(specifier, context) {
                 return await resolveWorkspacePackageEntry(workspacePkg, pkgName, subPath, specifier, context);
             }
             if (!shouldUseCdnFallback(pkgName)) {
-                console.warn(`[SWITE] Package ${pkgName} not found anywhere. Scoped package detected; CDN fallback is disabled by default.`);
+                console.warn(`[SWITE] Cannot resolve "${pkgName}"\n` +
+                    `  Searched:\n${nodeModulesLocations.map(p => `    - ${p}`).join('\n')}\n` +
+                    `  CDN fallback is disabled. To enable for a scope, set:\n` +
+                    `    SWITE_CDN_FALLBACK_SCOPES=@scope1,@scope2\n` +
+                    `  Run with --verbose for full resolution trace.`);
                 return `/node_modules/${specifier}`;
             }
-            console.warn(`[SWITE] Package ${pkgName} not found anywhere, using CDN fallback`);
+            console.warn(`[SWITE] Package ${pkgName} not found in any local location, using CDN fallback`);
             return `https://cdn.jsdelivr.net/npm/${specifier}/+esm`;
         }
         // Continue with normal resolution if we found it

package/dist/resolution/cdn/cdn-fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cdn-fallback.d.ts","sourceRoot":"","sources":["../../../src/resolution/cdn/cdn-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmBH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAKpE"}
+{"version":3,"file":"cdn-fallback.d.ts","sourceRoot":"","sources":["../../../src/resolution/cdn/cdn-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAmBH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAQpE"}

package/dist/resolution/cdn/cdn-fallback.js

@@ -29,8 +29,11 @@ function parseAllowList() {
 }
 export function shouldUseCdnFallback(specifierOrPkg) {
     const scope = getScope(specifierOrPkg);
+    // Unscoped packages (e.g. "react") are not automatically CDN-eligible; require
+    // explicit opt-in via SWITE_CDN_FALLBACK_SCOPES to prevent accidental exfiltration
+    // of package requests for private-registry or unscoped internal packages.
     if (!scope)
-        return true; // unscoped: allow by default
+        return false;
     const allow = parseAllowList();
     return allow.has(scope);
 }

package/dist/resolution/path/path-fixup.d.ts

@@ -6,8 +6,11 @@
  * compiler is fixed at source this single function is the authoritative fixup.
  * Apply it once per compilation, before passing code to the import rewriter.
  *
- * All seven previous fixup locations across ui-handler, uix-handler, and
- * import-rewriter have been removed in favour of this call.
+ * Pass `patterns` from `userConfig.compilerPathFixup.patterns` to override the
+ * defaults. Pass an empty array to disable all fixups.
  */
-export declare function fixSwissLibPaths(code: string): string;
+export declare function fixSwissLibPaths(code: string, patterns?: Array<{
+    from: string;
+    to: string;
+}>): string;
 //# sourceMappingURL=path-fixup.d.ts.map

package/dist/resolution/path/path-fixup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-fixup.d.ts","sourceRoot":"","sources":["../../../src/resolution/path/path-fixup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD"}
+{"version":3,"file":"path-fixup.d.ts","sourceRoot":"","sources":["../../../src/resolution/path/path-fixup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,MAAM,CAYR"}

package/dist/resolution/path/path-fixup.js

@@ -6,15 +6,19 @@
  * compiler is fixed at source this single function is the authoritative fixup.
  * Apply it once per compilation, before passing code to the import rewriter.
  *
- * All seven previous fixup locations across ui-handler, uix-handler, and
- * import-rewriter have been removed in favour of this call.
+ * Pass `patterns` from `userConfig.compilerPathFixup.patterns` to override the
+ * defaults. Pass an empty array to disable all fixups.
  */
-export function fixSwissLibPaths(code) {
-    if (!code.includes('/swiss-lib/'))
-        return code;
-    // More-specific pattern first so `/swiss-lib/packages/` doesn't leave a
-    // dangling `/swiss-packages/packages/` if the replacement ran twice.
-    return code
-        .replace(/\/swiss-lib\/packages\//g, '/swiss-packages/')
-        .replace(/\/swiss-lib\//g, '/swiss-packages/');
+export function fixSwissLibPaths(code, patterns) {
+    const activePatterns = patterns ?? [
+        { from: '/swiss-lib/packages/', to: '/swiss-packages/' },
+        { from: '/swiss-lib/', to: '/swiss-packages/' },
+    ];
+    let result = code;
+    for (const { from, to } of activePatterns) {
+        if (result.includes(from)) {
+            result = result.split(from).join(to);
+        }
+    }
+    return result;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swissjs/swite",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "SWITE - SWISS Development Server (Vite replacement)",
   "type": "module",
   "main": "dist/index.js",
@@ -9,7 +9,7 @@
     "swite": "dist/cli.js"
   },
   "dependencies": {
-    "@swissjs/core": "0.1.9",
+    "@swissjs/core": "0.1.11",
     "@swissjs/compiler": "0.1.5",
     "@swissjs/plugin-file-router": "1.0.2",
     "chalk": "^5.3.0",

package/src/cli.ts

@@ -12,6 +12,11 @@ import { setProductionMode } from "./adapters/proxy/proxyToPython.js";
 const [, , command, ...args] = process.argv;
 const root = resolve(process.cwd());
 
+// --verbose / -v enables full resolver diagnostic output
+if (args.includes("--verbose") || args.includes("-v")) {
+  process.env["SWITE_DEBUG"] = "1";
+}
+
 async function dev(): Promise<void> {
   const config = await loadUserConfig(root);
   const python = config.services?.python;
@@ -35,7 +40,8 @@ async function dev(): Promise<void> {
     root,
     port: config.server?.port ?? 3000,
     host: config.server?.host ?? "localhost",
-    publicDir: "public",
+    hmrPort: config.server?.hmrPort,
+    publicDir: config.publicDir ?? "public",
     open: false,
   });
 
@@ -61,7 +67,8 @@ async function start(): Promise<void> {
     root,
     port: config.server?.port ?? 3000,
     host: config.server?.host ?? "localhost",
-    publicDir: "public",
+    hmrPort: config.server?.hmrPort,
+    publicDir: config.publicDir ?? "public",
     open: false,
   });
 

package/src/config/config.ts

@@ -18,11 +18,35 @@ export interface ServicesConfig {
 export interface ServerConfig {
   port?: number;
   host?: string;
+  /** Port for the HMR WebSocket server. Defaults to 24678. */
+  hmrPort?: number;
+  /** Host for the HMR WebSocket server. Defaults to server.host. */
+  hmrHost?: string;
 }
 
 export interface SwiteUserConfig {
   server?: ServerConfig;
   services?: ServicesConfig;
+  /**
+   * Directory to serve static assets from. Defaults to "public".
+   * Path is relative to the project root.
+   */
+  publicDir?: string;
+  /**
+   * Application entry file for CSS extraction. Defaults to "src/index.ui".
+   * Path is relative to the project root.
+   */
+  entry?: string;
+  /**
+   * Module aliases resolved during bare import resolution.
+   * e.g. { "@/": "src/" } maps @/ imports to the src/ directory.
+   */
+  aliases?: Record<string, string>;
+  /**
+   * Glob patterns to exclude from HMR watching in addition to the defaults
+   * (node_modules, .git, dist). Useful for generated files or large assets.
+   */
+  excludeFromHmr?: string[];
   /**
    * Package scopes that should be treated as "internal" or "private".
    * These scopes prioritize local/monorepo resolution and are forbidden from CDN redirects.
@@ -30,10 +54,20 @@ export interface SwiteUserConfig {
    */
   internalScopes?: string[];
   /**
-   * Manual override for sibling repository lookup.
-   * Swite will search these directories for local package source code.
+   * Names of sibling monorepos to search for framework packages.
+   * Defaults to ['swiss-lib']. Override when your framework lives in a differently-named repo.
    */
   siblingRepositories?: string[];
+  /**
+   * Control the compiler path fixup that rewrites `/swiss-lib/` → `/swiss-packages/`.
+   * Disable entirely or supply custom from/to pairs when your project uses different paths.
+   */
+  compilerPathFixup?: {
+    /** When false, no path fixup is applied. Defaults to true for backward compatibility. */
+    enabled?: boolean;
+    /** Custom replacement patterns. Defaults to the built-in swiss-lib → swiss-packages pairs. */
+    patterns?: Array<{ from: string; to: string }>;
+  };
 }
 
 /**

package/src/dev-engine/handlers/ui-handler.ts

@@ -36,10 +36,15 @@ export class UIHandler extends BaseHandler {
       throw new Error(`File not found: ${url} (resolved to: ${filePath})`);
     }
 
+    const pathFixupEnabled = this.context.userConfig?.compilerPathFixup?.enabled !== false;
+    const pathFixupPatterns = this.context.userConfig?.compilerPathFixup?.patterns;
+    const applyPathFixup = (code: string) =>
+      pathFixupEnabled ? fixSwissLibPaths(code, pathFixupPatterns) : code;
+
     // Cache hit
     const cached = await compilationCache.get(filePath, (compiled) => this.getDependencies(compiled));
     if (cached) {
-      const fixed = fixSwissLibPaths(cached);
+      const fixed = applyPathFixup(cached);
       setDevHeaders(res);
       res.setHeader("Content-Type", "application/javascript; charset=utf-8");
       res.setHeader("Content-Length", Buffer.byteLength(fixed, "utf-8"));
@@ -61,7 +66,7 @@ export class UIHandler extends BaseHandler {
     compiled = tsResult.code;
 
     // Fix compiler-emitted wrong paths before import rewriting
-    compiled = fixSwissLibPaths(compiled);
+    compiled = applyPathFixup(compiled);
 
     // Inline import.meta.env references before import rewriting
     compiled = inlineEnvReferences(compiled, this.context.env);
@@ -75,7 +80,7 @@ export class UIHandler extends BaseHandler {
     }
 
     const rewritten = await rewriteImports(compiled, filePath, this.context.resolver);
-    const finalCode = fixSwissLibPaths(rewritten);
+    const finalCode = applyPathFixup(rewritten);
 
     await compilationCache.set(filePath, compiled, finalCode, (c) => this.getDependencies(c));
 

package/src/dev-engine/handlers/uix-handler.ts

@@ -29,10 +29,15 @@ export class UIXHandler extends BaseHandler {
     const filePath = await this.resolveFilePath(url);
     console.log(chalk.blue(`[.uix] ${url}`));
 
+    const pathFixupEnabled = this.context.userConfig?.compilerPathFixup?.enabled !== false;
+    const pathFixupPatterns = this.context.userConfig?.compilerPathFixup?.patterns;
+    const applyPathFixup = (code: string) =>
+      pathFixupEnabled ? fixSwissLibPaths(code, pathFixupPatterns) : code;
+
     // Cache hit
     const cached = await compilationCache.get(filePath, (compiled) => this.getDependencies(compiled));
     if (cached) {
-      const fixed = fixSwissLibPaths(cached);
+      const fixed = applyPathFixup(cached);
       setDevHeaders(res);
       res.setHeader("Content-Type", "application/javascript; charset=utf-8");
       res.send(fixed);
@@ -53,7 +58,7 @@ export class UIXHandler extends BaseHandler {
     compiled = tsResult.code;
 
     // Fix compiler-emitted wrong paths before import rewriting
-    compiled = fixSwissLibPaths(compiled);
+    compiled = applyPathFixup(compiled);
 
     // Inline import.meta.env references before import rewriting
     compiled = inlineEnvReferences(compiled, this.context.env);
@@ -72,7 +77,7 @@ export class UIXHandler extends BaseHandler {
     }
 
     const rewritten = await rewriteImports(compiled, filePath, this.context.resolver);
-    const finalCode = fixSwissLibPaths(rewritten);
+    const finalCode = applyPathFixup(rewritten);
 
     await compilationCache.set(filePath, compiled, finalCode, (c) => this.getDependencies(c));
 

package/src/dev-engine/hmr/hmr.ts

@@ -85,9 +85,12 @@ export class HMREngine {
     return this.port;
   }
 
-  async start() {
+  async start(excludeFromHmr?: string[]) {
+    const baseIgnored = ["**/node_modules/**", "**/.git/**", "**/dist/**"];
+    const ignored = excludeFromHmr ? [...baseIgnored, ...excludeFromHmr] : baseIgnored;
+
     this.watcher = chokidar.watch(this.root, {
-      ignored: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
+      ignored,
       ignoreInitial: true,
       awaitWriteFinish: {
         stabilityThreshold: 100,
@@ -110,6 +113,18 @@ export class HMREngine {
       });
     });
 
+    this.watcher.on("add", (filePath) => {
+      console.log(chalk.yellow(`[HMR] File added: ${filePath}`));
+      // New file — dependents are unknown, trigger a full reload
+      this.broadcast({ type: "reload", path: filePath, reason: "file-added" });
+    });
+
+    this.watcher.on("unlink", (filePath) => {
+      console.log(chalk.yellow(`[HMR] File deleted: ${filePath}`));
+      // Deleted file — its dependents will 404 on next import, trigger reload
+      this.broadcast({ type: "reload", path: filePath, reason: "file-deleted" });
+    });
+
     console.log(chalk.green("[HMR] Watching for file changes..."));
   }
 
@@ -156,7 +171,8 @@ export class HMREngine {
     type: string;
     path: string;
     updateType?: string;
-    timestamp: number;
+    reason?: string;
+    timestamp?: number;
   }) {
     const payload = JSON.stringify(message);
     this.clients.forEach((client) => {

package/src/dev-engine/middleware/middleware-setup.ts

@@ -118,6 +118,7 @@ export async function setupMiddleware(
     root: config.root,
     workspaceRoot,
     env,
+    userConfig: config.userConfig,
   };
 
   const uiHandler = new UIHandler(handlerContext);
@@ -342,6 +343,7 @@ export async function setupMiddleware(
   await setupSPAFallback(app, {
     root: config.root,
     publicDir: config.publicDir,
+    entry: config.userConfig?.entry,
   });
 
   return {

package/src/dev-engine/middleware/static-files.ts

@@ -15,6 +15,8 @@ export interface StaticFilesConfig {
   root: string;
   publicDir: string;
   workspaceRoot?: string | null;
+  /** Entry file for CSS extraction, relative to root. Defaults to "src/index.ui". */
+  entry?: string;
 }
 
 /**
@@ -549,7 +551,8 @@ export async function setupSPAFallback(
     console.log(chalk.magenta(`[SWITE CSS] ========== CSS EXTRACTION START (VERSION 3.0.0) ==========`));
     console.log(chalk.magenta(`[SWITE CSS] App root: ${config.root}`));
     try {
-      const entryPointPath = path.join(config.root, "src", "index.ui");
+      const entryFile = config.entry ?? "src/index.ui";
+      const entryPointPath = path.join(config.root, entryFile);
       console.log(chalk.blue(`[SWITE CSS] Checking entry point: ${entryPointPath}`));
       const entryPointContent = await fs.readFile(entryPointPath, "utf-8");
       

package/src/dev-engine/server.ts

@@ -85,6 +85,9 @@ export class SwiteServer {
     console.log(chalk.cyan("\n⚡ SWITE - SWISS Development Server\n"));
     console.time("Startup");
 
+    // Load user config (swiss.config.ts) so internalScopes etc. flow into handlers
+    const userConfig = await loadUserConfig(this.config.root);
+
     // CG-03: Build symlink registry before serving any requests.
     // Maps realpath(node_modules/pkg symlink) → /node_modules/pkg browser URL
     // so toUrl() can map absolute filesystem paths back to browser URLs.
@@ -101,7 +104,7 @@ export class SwiteServer {
       if (workspaceRoot) {
         nodeModulesDirs.push(path.join(workspaceRoot, "node_modules"));
       }
-      const swissLib = await findSwissLibMonorepo(this.config.root);
+      const swissLib = await findSwissLibMonorepo(this.config.root, userConfig?.siblingRepositories);
       if (swissLib) {
         nodeModulesDirs.push(path.join(swissLib, "node_modules"));
       }
@@ -111,9 +114,6 @@ export class SwiteServer {
     }
     console.timeEnd("Symlink Registry");
 
-    // Load user config (swiss.config.ts) so internalScopes etc. flow into handlers
-    const userConfig = await loadUserConfig(this.config.root);
-
     // Setup middleware
     console.time("Middleware Setup");
     const workspaceRoot = await this.findWorkspaceRoot(this.config.root);
@@ -133,7 +133,7 @@ export class SwiteServer {
     // Start HMR
     console.time("HMR Start");
     await this.hmr.initialize();
-    await this.hmr.start();
+    await this.hmr.start(userConfig?.excludeFromHmr);
     console.timeEnd("HMR Start");
 
     // Start HTTP server

package/src/kernel/package-finder.ts

@@ -48,10 +48,20 @@ export async function findSiblingRepository(startPath: string, repoName: string)
 }
 
 /**
- * Backward compatibility wrapper for finding swiss-lib
+ * Find the co-located framework monorepo. Tries each name in `fallbackNames`
+ * in order and returns the first match. The default list is ['swiss-lib'] for
+ * backward compatibility; callers that have a user config should forward
+ * `userConfig.siblingRepositories` here to make the lookup configurable.
  */
-export async function findSwissLibMonorepo(startPath: string): Promise<string | null> {
-  return findSiblingRepository(startPath, 'swiss-lib');
+export async function findSwissLibMonorepo(
+  startPath: string,
+  fallbackNames: string[] = ['swiss-lib'],
+): Promise<string | null> {
+  for (const name of fallbackNames) {
+    const result = await findSiblingRepository(startPath, name);
+    if (result) return result;
+  }
+  return null;
 }
 
 /**

package/src/resolution/bare-import-resolver.ts

@@ -23,6 +23,7 @@ export async function resolveBareImport(
   specifier: string,
   context: BareImportResolverContext
 ): Promise<string> {
+  const debug = process.env["SWITE_DEBUG"] === "1";
 
   // Extract package name outside the try/catch so fallback logic can reference it.
   // This must stay project-agnostic: works for both scoped and unscoped packages.
@@ -56,6 +57,10 @@ export async function resolveBareImport(
       }
     }
 
+    if (debug) {
+      console.log(`[swite:resolve] Trying "${specifier}" in:`, nodeModulesLocations);
+    }
+
     // Try each location
     for (const nodeModulesPath of nodeModulesLocations) {
       const testPkgDir = path.join(nodeModulesPath, pkgName);
@@ -81,12 +86,16 @@ export async function resolveBareImport(
 
       if (!shouldUseCdnFallback(pkgName)) {
         console.warn(
-          `[SWITE] Package ${pkgName} not found anywhere. Scoped package detected; CDN fallback is disabled by default.`,
+          `[SWITE] Cannot resolve "${pkgName}"\n` +
+          `  Searched:\n${nodeModulesLocations.map(p => `    - ${p}`).join('\n')}\n` +
+          `  CDN fallback is disabled. To enable for a scope, set:\n` +
+          `    SWITE_CDN_FALLBACK_SCOPES=@scope1,@scope2\n` +
+          `  Run with --verbose for full resolution trace.`,
         );
         return `/node_modules/${specifier}`;
       }
 
-      console.warn(`[SWITE] Package ${pkgName} not found anywhere, using CDN fallback`);
+      console.warn(`[SWITE] Package ${pkgName} not found in any local location, using CDN fallback`);
       return `https://cdn.jsdelivr.net/npm/${specifier}/+esm`;
     }
 

package/src/resolution/cdn/cdn-fallback.ts

@@ -30,7 +30,10 @@ function parseAllowList(): Set<string> {
 
 export function shouldUseCdnFallback(specifierOrPkg: string): boolean {
   const scope = getScope(specifierOrPkg);
-  if (!scope) return true; // unscoped: allow by default
+  // Unscoped packages (e.g. "react") are not automatically CDN-eligible; require
+  // explicit opt-in via SWITE_CDN_FALLBACK_SCOPES to prevent accidental exfiltration
+  // of package requests for private-registry or unscoped internal packages.
+  if (!scope) return false;
   const allow = parseAllowList();
   return allow.has(scope);
 }

package/src/resolution/path/path-fixup.ts

@@ -6,14 +6,22 @@
  * compiler is fixed at source this single function is the authoritative fixup.
  * Apply it once per compilation, before passing code to the import rewriter.
  *
- * All seven previous fixup locations across ui-handler, uix-handler, and
- * import-rewriter have been removed in favour of this call.
+ * Pass `patterns` from `userConfig.compilerPathFixup.patterns` to override the
+ * defaults. Pass an empty array to disable all fixups.
  */
-export function fixSwissLibPaths(code: string): string {
-  if (!code.includes('/swiss-lib/')) return code;
-  // More-specific pattern first so `/swiss-lib/packages/` doesn't leave a
-  // dangling `/swiss-packages/packages/` if the replacement ran twice.
-  return code
-    .replace(/\/swiss-lib\/packages\//g, '/swiss-packages/')
-    .replace(/\/swiss-lib\//g, '/swiss-packages/');
+export function fixSwissLibPaths(
+  code: string,
+  patterns?: Array<{ from: string; to: string }>,
+): string {
+  const activePatterns = patterns ?? [
+    { from: '/swiss-lib/packages/', to: '/swiss-packages/' },
+    { from: '/swiss-lib/', to: '/swiss-packages/' },
+  ];
+  let result = code;
+  for (const { from, to } of activePatterns) {
+    if (result.includes(from)) {
+      result = result.split(from).join(to);
+    }
+  }
+  return result;
 }