@swissjs/swite 0.4.1 → 0.4.2

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

@@ -7,116 +7,116 @@
  * 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;
-  }
-}
+    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/middleware/middleware-setup.js

@@ -24,9 +24,10 @@ 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)));
+    if (!(error instanceof Error))
+        return false;
+    const sysError = error;
+    return sysError.code === "ENOENT" || sysError.errno === -4058;
 }
 function sendSourceError(res, error, fullPath) {
     if (res.headersSent)

package/docs/architecture/build-pipeline.md

@@ -1,97 +1,97 @@
-<!--
-Copyright (c) 2024 Themba Mzumara
-SWITE - SWISS Development Server
-Licensed under the MIT License.
--->
-
-# Build Pipeline
-
-`SwiteBuilder` (`src/build-engine/builder.ts`) handles production builds. It is invoked by `swite build` with a fixed entry point of `src/index.ui` and output directory of `dist/`.
-
----
-
-## Overview
-
-The build runs three sequential phases inside a try/finally block. The temporary directory `.swite-build/` is always removed when the build finishes, whether it succeeded or failed.
-
-```
-swite build
-  └── SwiteBuilder.build()
-        ├── 1. cleanOutputDir()       — rm -rf dist/, mkdir dist/
-        ├── 2. compileSwissFiles()    — @swissjs/compiler → .tsx in .swite-build/
-        ├── 3. bundle()               — esbuild bundles from .swite-build/
-        └── 4. copyPublicAssets()     — cp -r public/ dist/
-```
-
----
-
-## Phase 1: Compile Swiss files
-
-`compileSwissFiles` traverses `src/` and every workspace dependency's `src/` directory.
-
-For each `.ui` or `.uix` file:
-
-1. `UiCompiler.compileAsync(source, filePath)` — transforms SwissJS component syntax to TypeScript/JSX.
-2. Relative `.ui`/`.uix` imports in the compiled output are rewritten to `.tsx` (esbuild needs `.tsx` for JSX, not `.ui`).
-3. If the compiled output ends with `export { Foo }`, a `export default Foo` line is appended so default imports resolve at bundle time.
-4. Written to `.swite-build/<relative-path>.tsx`.
-
-For each `.ts` file, `.ui`/`.uix` imports in `from` clauses are rewritten to `.tsx`, then the file is copied as-is.
-
-CSS files are copied verbatim so that any CSS import stubs in the bundle phase can resolve.
-
----
-
-## Phase 2: Bundle with esbuild
-
-esbuild is invoked with:
-
-```typescript
-{
-  bundle: true,
-  format: 'esm',
-  target: 'es2020',
-  minify: true,
-  sourcemap: false,
-  splitting: true,   // ESM code splitting
-  metafile: true,
-  platform: 'node',
-}
-```
-
-Three plugins are registered (see [CLI / build](../cli/build.md) for descriptions). Node built-in modules are marked external. The `absWorkingDir` is set to the workspace root (or app root if no workspace is detected) so esbuild resolves node_modules correctly.
-
----
-
-## Phase 3: Copy public assets
-
-`public/` is copied recursively to `dist/`. If `public/` does not exist, this phase is skipped silently.
-
----
-
-## Workspace dependency discovery
-
-`discoverWorkspaceDependencies()` reads the app's `package.json` and collects all `workspace:*` entries from `dependencies`, `devDependencies`, and `peerDependencies`. It also scans source files for `@scope/pkg` import patterns to catch transitive workspace imports not listed in `package.json`.
-
-For each candidate package name, it searches these directories under the workspace root:
-
-```
-lib/<pkgName>
-packages/<pkgName>
-packages/runtime/<pkgName>
-packages/plugins/<pkgName>
-packages/domain/<pkgName>
-```
-
-A match requires the directory to have a `package.json` whose `name` field matches the expected package name, and a `src/` subdirectory.
-
----
-
-## Workspace resolver plugin
-
-The `workspace-resolver` esbuild plugin handles `@scope/pkg` imports during bundling. It maps each import to the compiled `.tsx` files in `.swite-build/` by:
-
-1. Finding the matching workspace dependency from the discovery step.
-2. Reading the package's `package.json` exports field to resolve the subpath.
-3. Converting the export path from `./src/Foo.uix` to `.swite-build/<depRelPath>/src/Foo.tsx`.
-4. Falling back to `src/index.js` if exports resolution fails.
+<!--
+Copyright (c) 2024 Themba Mzumara
+SWITE - SWISS Development Server
+Licensed under the MIT License.
+-->
+
+# Build Pipeline
+
+`SwiteBuilder` (`src/build-engine/builder.ts`) handles production builds. It is invoked by `swite build` with a fixed entry point of `src/index.ui` and output directory of `dist/`.
+
+---
+
+## Overview
+
+The build runs three sequential phases inside a try/finally block. The temporary directory `.swite-build/` is always removed when the build finishes, whether it succeeded or failed.
+
+```
+swite build
+  └── SwiteBuilder.build()
+        ├── 1. cleanOutputDir()       — rm -rf dist/, mkdir dist/
+        ├── 2. compileSwissFiles()    — @swissjs/compiler → .tsx in .swite-build/
+        ├── 3. bundle()               — esbuild bundles from .swite-build/
+        └── 4. copyPublicAssets()     — cp -r public/ dist/
+```
+
+---
+
+## Phase 1: Compile Swiss files
+
+`compileSwissFiles` traverses `src/` and every workspace dependency's `src/` directory.
+
+For each `.ui` or `.uix` file:
+
+1. `UiCompiler.compileAsync(source, filePath)` — transforms SwissJS component syntax to TypeScript/JSX.
+2. Relative `.ui`/`.uix` imports in the compiled output are rewritten to `.tsx` (esbuild needs `.tsx` for JSX, not `.ui`).
+3. If the compiled output ends with `export { Foo }`, a `export default Foo` line is appended so default imports resolve at bundle time.
+4. Written to `.swite-build/<relative-path>.tsx`.
+
+For each `.ts` file, `.ui`/`.uix` imports in `from` clauses are rewritten to `.tsx`, then the file is copied as-is.
+
+CSS files are copied verbatim so that any CSS import stubs in the bundle phase can resolve.
+
+---
+
+## Phase 2: Bundle with esbuild
+
+esbuild is invoked with:
+
+```typescript
+{
+  bundle: true,
+  format: 'esm',
+  target: 'es2020',
+  minify: true,
+  sourcemap: false,
+  splitting: true,   // ESM code splitting
+  metafile: true,
+  platform: 'node',
+}
+```
+
+Three plugins are registered (see [CLI / build](../cli/build.md) for descriptions). Node built-in modules are marked external. The `absWorkingDir` is set to the workspace root (or app root if no workspace is detected) so esbuild resolves node_modules correctly.
+
+---
+
+## Phase 3: Copy public assets
+
+`public/` is copied recursively to `dist/`. If `public/` does not exist, this phase is skipped silently.
+
+---
+
+## Workspace dependency discovery
+
+`discoverWorkspaceDependencies()` reads the app's `package.json` and collects all `workspace:*` entries from `dependencies`, `devDependencies`, and `peerDependencies`. It also scans source files for `@scope/pkg` import patterns to catch transitive workspace imports not listed in `package.json`.
+
+For each candidate package name, it searches these directories under the workspace root:
+
+```
+lib/<pkgName>
+packages/<pkgName>
+packages/runtime/<pkgName>
+packages/plugins/<pkgName>
+packages/domain/<pkgName>
+```
+
+A match requires the directory to have a `package.json` whose `name` field matches the expected package name, and a `src/` subdirectory.
+
+---
+
+## Workspace resolver plugin
+
+The `workspace-resolver` esbuild plugin handles `@scope/pkg` imports during bundling. It maps each import to the compiled `.tsx` files in `.swite-build/` by:
+
+1. Finding the matching workspace dependency from the discovery step.
+2. Reading the package's `package.json` exports field to resolve the subpath.
+3. Converting the export path from `./src/Foo.uix` to `.swite-build/<depRelPath>/src/Foo.tsx`.
+4. Falling back to `src/index.js` if exports resolution fails.

package/docs/architecture/dev-server.md

@@ -1,87 +1,87 @@
-<!--
-Copyright (c) 2024 Themba Mzumara
-SWITE - SWISS Development Server
-Licensed under the MIT License.
--->
-
-# Dev Server
-
-`SwiteServer` (in `src/dev-engine/server.ts`) is the Express application that handles all incoming requests during development.
-
----
-
-## Startup sequence
-
-When `server.start()` is called:
-
-1. **Symlink registry** — Scans `node_modules` directories at the app root, one level up from the app root, the workspace root (if detected), and the co-located framework monorepo root. Registers every symlink target so that absolute filesystem paths obtained via `fs.realpath()` can later be mapped back to browser-relative URLs.
-
-2. **Middleware setup** — Calls `setupMiddleware()`, which registers the full middleware chain (see below) and initializes the file router, import map, and env variable loading.
-
-3. **HMR** — Calls `hmr.initialize()` (port probe and WebSocket server creation) then `hmr.start()` (chokidar watcher).
-
-4. **HTTP listen** — Binds to the configured port. When `host` is `"localhost"`, SWITE binds to `0.0.0.0` so both `::1` and `127.0.0.1` respond.
-
----
-
-## Workspace root detection
-
-`SwiteServer.findWorkspaceRoot(startDir)` walks up the directory tree, up to six levels, looking for:
-
-- A `pnpm-workspace.yaml` file, or
-- A `package.json` with a `workspaces` field
-
-If found, that directory is the workspace root. The workspace root is used to locate `node_modules`, workspace packages, and the import map.
-
-`SwiteConfig.rootDir` can be set to override auto-detection.
-
----
-
-## Middleware chain
-
-The middleware is registered in a fixed order that Express processes top-to-bottom:
-
-| Priority | Path | Handler |
-|----------|------|---------|
-| 1 | all | File router + HMR routes |
-| 2 | `/packages` | TypeScript and JavaScript handler (workspace source files) |
-| 3 | `/src` | `.ui`, `.uix`, `.ts`, `.js`, `.mjs`, static (CSS, images) |
-| 4 | `/lib` | `.ui`, `.uix` source files (pre-static guard) |
-| 5 | all | `.ui`/`.uix` MIME-type guard |
-| 6 | `/.skltn/modules.css` | Returns 204 (CSS not bundled in dev) |
-| 7 | static | `public/`, `node_modules/`, `lib/`, `libraries/`, `modules/` |
-| 8 | all | General source-file transformation for all other paths |
-| 9 | all | SPA fallback — serves `public/index.html` for HTML-accepting requests |
-
-The SPA fallback refuses to serve HTML for paths under `/src/`, `/swiss-packages/`, and `/lib/` — those return 404 if they reach the fallback, preventing MIME mismatch errors.
-
----
-
-## File handlers
-
-Each file type has a dedicated handler class that extends `BaseHandler`:
-
-| Handler | Extension(s) | Behaviour |
-|---------|-------------|-----------|
-| `UIHandler` | `.ui` | Compiles via `UiCompiler`, strips TypeScript via esbuild, fixes swiss-lib paths, inlines `import.meta.env`, strips CSS imports, rewrites bare imports |
-| `UIXHandler` | `.uix` | Same pipeline as UIHandler |
-| `TSHandler` | `.ts` | esbuild TypeScript strip, inlines env, rewrites imports. Falls back to `.ui` or `.uix` if the `.ts` file does not exist |
-| `JSHandler` | `.js` | Rewrites imports. Falls back to `.ts`, `.ui`, `.uix` if `.js` does not exist |
-| `MJSHandler` | `.mjs` | Rewrites imports. Falls back to `.js` handler |
-| `NodeModuleHandler` | `/node_modules/…` | Walks up the directory tree to find the package. Serves without import rewriting. Falls back to jsDelivr CDN redirect if not found locally |
-
-All handlers check an in-memory compilation cache before compiling. Cached entries are keyed by file path and invalidated when the file's mtime changes.
-
----
-
-## Static file serving
-
-`setupStaticFiles` registers `express.static` for:
-
-- `public/` at the root URL
-- `node_modules/` at `/node_modules/` (app root and workspace root)
-- `lib/` at `/lib/` (resolved by walking up from app root looking for a directory that has both `pnpm-workspace.yaml` and `lib/`)
-- `libraries/` at `/libraries/` (workspace root, legacy)
-- `modules/` at `/modules/` (workspace root, CSS and assets only)
-
-Source files (`.ui`, `.uix`, `.ts`, `.js`, `.mjs`) are excluded from `express.static` by a guard middleware registered before each static mount. This ensures they always go through the compiler pipeline.
+<!--
+Copyright (c) 2024 Themba Mzumara
+SWITE - SWISS Development Server
+Licensed under the MIT License.
+-->
+
+# Dev Server
+
+`SwiteServer` (in `src/dev-engine/server.ts`) is the Express application that handles all incoming requests during development.
+
+---
+
+## Startup sequence
+
+When `server.start()` is called:
+
+1. **Symlink registry** — Scans `node_modules` directories at the app root, one level up from the app root, the workspace root (if detected), and the co-located framework monorepo root. Registers every symlink target so that absolute filesystem paths obtained via `fs.realpath()` can later be mapped back to browser-relative URLs.
+
+2. **Middleware setup** — Calls `setupMiddleware()`, which registers the full middleware chain (see below) and initializes the file router, import map, and env variable loading.
+
+3. **HMR** — Calls `hmr.initialize()` (port probe and WebSocket server creation) then `hmr.start()` (chokidar watcher).
+
+4. **HTTP listen** — Binds to the configured port. When `host` is `"localhost"`, SWITE binds to `0.0.0.0` so both `::1` and `127.0.0.1` respond.
+
+---
+
+## Workspace root detection
+
+`SwiteServer.findWorkspaceRoot(startDir)` walks up the directory tree, up to six levels, looking for:
+
+- A `pnpm-workspace.yaml` file, or
+- A `package.json` with a `workspaces` field
+
+If found, that directory is the workspace root. The workspace root is used to locate `node_modules`, workspace packages, and the import map.
+
+`SwiteConfig.rootDir` can be set to override auto-detection.
+
+---
+
+## Middleware chain
+
+The middleware is registered in a fixed order that Express processes top-to-bottom:
+
+| Priority | Path | Handler |
+|----------|------|---------|
+| 1 | all | File router + HMR routes |
+| 2 | `/packages` | TypeScript and JavaScript handler (workspace source files) |
+| 3 | `/src` | `.ui`, `.uix`, `.ts`, `.js`, `.mjs`, static (CSS, images) |
+| 4 | `/lib` | `.ui`, `.uix` source files (pre-static guard) |
+| 5 | all | `.ui`/`.uix` MIME-type guard |
+| 6 | `/.skltn/modules.css` | Returns 204 (CSS not bundled in dev) |
+| 7 | static | `public/`, `node_modules/`, `lib/`, `libraries/`, `modules/` |
+| 8 | all | General source-file transformation for all other paths |
+| 9 | all | SPA fallback — serves `public/index.html` for HTML-accepting requests |
+
+The SPA fallback refuses to serve HTML for paths under `/src/`, `/swiss-packages/`, and `/lib/` — those return 404 if they reach the fallback, preventing MIME mismatch errors.
+
+---
+
+## File handlers
+
+Each file type has a dedicated handler class that extends `BaseHandler`:
+
+| Handler | Extension(s) | Behaviour |
+|---------|-------------|-----------|
+| `UIHandler` | `.ui` | Compiles via `UiCompiler`, strips TypeScript via esbuild, fixes swiss-lib paths, inlines `import.meta.env`, strips CSS imports, rewrites bare imports |
+| `UIXHandler` | `.uix` | Same pipeline as UIHandler |
+| `TSHandler` | `.ts` | esbuild TypeScript strip, inlines env, rewrites imports. Falls back to `.ui` or `.uix` if the `.ts` file does not exist |
+| `JSHandler` | `.js` | Rewrites imports. Falls back to `.ts`, `.ui`, `.uix` if `.js` does not exist |
+| `MJSHandler` | `.mjs` | Rewrites imports. Falls back to `.js` handler |
+| `NodeModuleHandler` | `/node_modules/…` | Walks up the directory tree to find the package. Serves without import rewriting. Falls back to jsDelivr CDN redirect if not found locally |
+
+All handlers check an in-memory compilation cache before compiling. Cached entries are keyed by file path and invalidated when the file's mtime changes.
+
+---
+
+## Static file serving
+
+`setupStaticFiles` registers `express.static` for:
+
+- `public/` at the root URL
+- `node_modules/` at `/node_modules/` (app root and workspace root)
+- `lib/` at `/lib/` (resolved by walking up from app root looking for a directory that has both `pnpm-workspace.yaml` and `lib/`)
+- `libraries/` at `/libraries/` (workspace root, legacy)
+- `modules/` at `/modules/` (workspace root, CSS and assets only)
+
+Source files (`.ui`, `.uix`, `.ts`, `.js`, `.mjs`) are excluded from `express.static` by a guard middleware registered before each static mount. This ensures they always go through the compiler pipeline.