@swissjs/swite 0.4.1 → 0.4.2

package/docs/guide/project-structure.md

@@ -1,75 +1,75 @@
-<!--
-Copyright (c) 2024 Themba Mzumara
-SWITE - SWISS Development Server
-Licensed under the MIT License.
--->
-
-# Project Structure
-
-Conventions for a SWITE-powered application.
-
----
-
-## Application layout
-
-```
-my-app/
-├── src/
-│   ├── index.ui              # entry point — referenced by public/index.html
-│   ├── App.ui                # root component
-│   ├── components/           # reusable UI components
-│   └── types/                # shared TypeScript types
-├── public/
-│   └── index.html            # HTML shell — SWITE injects import map and CSS links
-├── .swite/
-│   └── import-map.json       # generated at build time; optional at dev time
-├── dist/                     # production build output (gitignored)
-├── package.json
-└── swiss.config.ts           # optional config
-```
-
----
-
-## Source file conventions
-
-| Extension | Handler | Description |
-|-----------|---------|-------------|
-| `.ui`     | UIHandler | SwissJS component syntax; compiled by `@swissjs/compiler` then TypeScript-stripped by esbuild |
-| `.uix`    | UIXHandler | JSX variant of SwissJS component syntax; same pipeline as `.ui` |
-| `.ts`     | TSHandler | Plain TypeScript; TypeScript-stripped by esbuild only |
-| `.js`     | JSHandler | Plain JavaScript; import-rewritten but not compiled |
-| `.mjs`    | MJSHandler | Same as `.js`; falls back to `.js` if `.mjs` does not exist |
-
-SWITE handles extension negotiation: a request for `/src/Foo.js` will be served from `Foo.ts`, `Foo.ui`, or `Foo.uix` if the `.js` file does not exist on disk. Similarly, a request for `/src/Foo.ts` falls back to `.ui` or `.uix`.
-
----
-
-## public/ directory
-
-The `public/` directory is served as static files. SWITE's SPA fallback reads `public/index.html` and:
-
-- Injects cache-busting query parameters on the entry point `<script>` tag
-- Injects an `<script type="importmap">` block from `.swite/import-map.json` (merging with any existing importmap in HTML)
-- Injects `<link rel="stylesheet">` tags for CSS files discovered in the entry point source
-
-Files under `public/` are served with `no-cache` headers during development.
-
----
-
-## Config file
-
-SWITE looks for `swiss.config.ts` (preferred) or `swiss.config.js` at the project root. Both are optional. If neither exists, SWITE starts with defaults: port 3000, host `localhost`, no Python service.
-
-See [Configuration](./configuration.md) for the full field reference.
-
----
-
-## Workspace layout
-
-When SWITE detects a monorepo (by walking up the directory tree looking for `pnpm-workspace.yaml` or a `package.json` with `workspaces`), it:
-
-- Scans workspace `node_modules` for package resolution
-- Serves `lib/`, `libraries/`, and `modules/` directories as static file prefixes
-- Compiles source files under `packages/` through the handler pipeline
-
-The workspace root is detected automatically; it can also be set explicitly via `SwiteConfig.rootDir`.
+<!--
+Copyright (c) 2024 Themba Mzumara
+SWITE - SWISS Development Server
+Licensed under the MIT License.
+-->
+
+# Project Structure
+
+Conventions for a SWITE-powered application.
+
+---
+
+## Application layout
+
+```
+my-app/
+├── src/
+│   ├── index.ui              # entry point — referenced by public/index.html
+│   ├── App.ui                # root component
+│   ├── components/           # reusable UI components
+│   └── types/                # shared TypeScript types
+├── public/
+│   └── index.html            # HTML shell — SWITE injects import map and CSS links
+├── .swite/
+│   └── import-map.json       # generated at build time; optional at dev time
+├── dist/                     # production build output (gitignored)
+├── package.json
+└── swiss.config.ts           # optional config
+```
+
+---
+
+## Source file conventions
+
+| Extension | Handler | Description |
+|-----------|---------|-------------|
+| `.ui`     | UIHandler | SwissJS component syntax; compiled by `@swissjs/compiler` then TypeScript-stripped by esbuild |
+| `.uix`    | UIXHandler | JSX variant of SwissJS component syntax; same pipeline as `.ui` |
+| `.ts`     | TSHandler | Plain TypeScript; TypeScript-stripped by esbuild only |
+| `.js`     | JSHandler | Plain JavaScript; import-rewritten but not compiled |
+| `.mjs`    | MJSHandler | Same as `.js`; falls back to `.js` if `.mjs` does not exist |
+
+SWITE handles extension negotiation: a request for `/src/Foo.js` will be served from `Foo.ts`, `Foo.ui`, or `Foo.uix` if the `.js` file does not exist on disk. Similarly, a request for `/src/Foo.ts` falls back to `.ui` or `.uix`.
+
+---
+
+## public/ directory
+
+The `public/` directory is served as static files. SWITE's SPA fallback reads `public/index.html` and:
+
+- Injects cache-busting query parameters on the entry point `<script>` tag
+- Injects an `<script type="importmap">` block from `.swite/import-map.json` (merging with any existing importmap in HTML)
+- Injects `<link rel="stylesheet">` tags for CSS files discovered in the entry point source
+
+Files under `public/` are served with `no-cache` headers during development.
+
+---
+
+## Config file
+
+SWITE looks for `swiss.config.ts` (preferred) or `swiss.config.js` at the project root. Both are optional. If neither exists, SWITE starts with defaults: port 3000, host `localhost`, no Python service.
+
+See [Configuration](./configuration.md) for the full field reference.
+
+---
+
+## Workspace layout
+
+When SWITE detects a monorepo (by walking up the directory tree looking for `pnpm-workspace.yaml` or a `package.json` with `workspaces`), it:
+
+- Scans workspace `node_modules` for package resolution
+- Serves `lib/`, `libraries/`, and `modules/` directories as static file prefixes
+- Compiles source files under `packages/` through the handler pipeline
+
+The workspace root is detected automatically; it can also be set explicitly via `SwiteConfig.rootDir`.

package/docs/guide/quickstart.md

@@ -1,113 +1,113 @@
-<!--
-Copyright (c) 2024 Themba Mzumara
-SWITE - SWISS Development Server
-Licensed under the MIT License.
--->
-
-# Quickstart
-
-Get a SwissJS application running under SWITE in a few minutes.
-
----
-
-## Prerequisites
-
-- Node.js 18.19.x or later
-- pnpm 10.x
-- A SwissJS application (`src/index.ui` as entry point)
-
----
-
-## 1. Install SWITE
-
-In your application package:
-
-```bash
-pnpm add -D @swissjs/swite
-```
-
-Add the CLI commands to `package.json`:
-
-```json
-{
-  "scripts": {
-    "dev": "swite dev",
-    "build": "swite build",
-    "start": "swite start"
-  }
-}
-```
-
----
-
-## 2. Start the dev server
-
-```bash
-pnpm dev
-```
-
-SWITE starts on `http://localhost:3000` by default. Every `.ui`, `.uix`, `.ts`, and `.js` request is compiled and import-rewritten on demand. HMR is active on port 24678.
-
----
-
-## 3. Project layout
-
-A minimal SWITE project:
-
-```
-my-app/
-├── src/
-│   ├── index.ui          # entry point — mounted by public/index.html
-│   ├── App.ui            # root component
-│   └── components/
-├── public/
-│   └── index.html        # shell HTML — SWITE injects import map here
-├── package.json
-└── swiss.config.ts       # optional
-```
-
-SWITE resolves files relative to the directory where `swite dev` is invoked (the project root). The `src/` prefix in URLs maps directly to `<root>/src/` on disk.
-
----
-
-## 4. Write a component
-
-```typescript
-// src/components/Counter.ui
-
-component Counter {
-  state {
-    let count: number = 0;
-  }
-
-  render() {
-    return html`
-      <div>
-        <p>Count: ${this.count}</p>
-        <button onclick="${() => this.count++}">+1</button>
-      </div>
-    `;
-  }
-}
-```
-
-SWITE pipes `.ui` files through `@swissjs/compiler` (the SwissJS syntax transformer), then through esbuild's TypeScript stripper, rewrites all bare imports to browser-resolvable URLs, and serves the result as `application/javascript`.
-
----
-
-## 5. Build for production
-
-```bash
-pnpm build
-```
-
-Output goes to `dist/`. The build entry is fixed to `src/index.ui`. See [`swite build`](../cli/build.md) for details.
-
----
-
-## Next
-
-- [Project structure](./project-structure.md) — layout conventions
-- [Configuration](./configuration.md) — server port, Python service options
-- [CLI reference](../cli/index.md) — all commands
-- [Architecture](../architecture/index.md) — how SWITE works internally
+<!--
+Copyright (c) 2024 Themba Mzumara
+SWITE - SWISS Development Server
+Licensed under the MIT License.
+-->
+
+# Quickstart
+
+Get a SwissJS application running under SWITE in a few minutes.
+
+---
+
+## Prerequisites
+
+- Node.js 18.19.x or later
+- pnpm 10.x
+- A SwissJS application (`src/index.ui` as entry point)
+
+---
+
+## 1. Install SWITE
+
+In your application package:
+
+```bash
+pnpm add -D @swissjs/swite
+```
+
+Add the CLI commands to `package.json`:
+
+```json
+{
+  "scripts": {
+    "dev": "swite dev",
+    "build": "swite build",
+    "start": "swite start"
+  }
+}
+```
+
+---
+
+## 2. Start the dev server
+
+```bash
+pnpm dev
+```
+
+SWITE starts on `http://localhost:3000` by default. Every `.ui`, `.uix`, `.ts`, and `.js` request is compiled and import-rewritten on demand. HMR is active on port 24678.
+
+---
+
+## 3. Project layout
+
+A minimal SWITE project:
+
+```
+my-app/
+├── src/
+│   ├── index.ui          # entry point — mounted by public/index.html
+│   ├── App.ui            # root component
+│   └── components/
+├── public/
+│   └── index.html        # shell HTML — SWITE injects import map here
+├── package.json
+└── swiss.config.ts       # optional
+```
+
+SWITE resolves files relative to the directory where `swite dev` is invoked (the project root). The `src/` prefix in URLs maps directly to `<root>/src/` on disk.
+
+---
+
+## 4. Write a component
+
+```typescript
+// src/components/Counter.ui
+
+component Counter {
+  state {
+    let count: number = 0;
+  }
+
+  render() {
+    return html`
+      <div>
+        <p>Count: ${this.count}</p>
+        <button onclick="${() => this.count++}">+1</button>
+      </div>
+    `;
+  }
+}
+```
+
+SWITE pipes `.ui` files through `@swissjs/compiler` (the SwissJS syntax transformer), then through esbuild's TypeScript stripper, rewrites all bare imports to browser-resolvable URLs, and serves the result as `application/javascript`.
+
+---
+
+## 5. Build for production
+
+```bash
+pnpm build
+```
+
+Output goes to `dist/`. The build entry is fixed to `src/index.ui`. See [`swite build`](../cli/build.md) for details.
+
+---
+
+## Next
+
+- [Project structure](./project-structure.md) — layout conventions
+- [Configuration](./configuration.md) — server port, Python service options
+- [CLI reference](../cli/index.md) — all commands
+- [Architecture](../architecture/index.md) — how SWITE works internally

package/docs/index.md

@@ -1,16 +1,16 @@
-<!--
-Copyright (c) 2024 Themba Mzumara
-SWITE - SWISS Development Server
-Licensed under the MIT License.
--->
-
-# SWITE Documentation
-
-SWITE (`@swissjs/swite`) is the development server and production build tool for SwissJS applications. It provides on-demand TypeScript and SwissJS source compilation, bare-import rewriting, HMR, Python service lifecycle management, and an esbuild-powered production pipeline.
-
-## Sections
-
-- [Guide](./guide/index.md) — Installation, project layout, configuration reference, and first steps
-- [CLI](./cli/index.md) — `swite dev`, `swite build`, and `swite start` command reference
-- [Architecture](./architecture/index.md) — Internals: dev server, import resolution, HMR, build pipeline, Python integration
-- [Development](./development/index.md) — Contributing, local build, and internal implementation notes
+<!--
+Copyright (c) 2024 Themba Mzumara
+SWITE - SWISS Development Server
+Licensed under the MIT License.
+-->
+
+# SWITE Documentation
+
+SWITE (`@swissjs/swite`) is the development server and production build tool for SwissJS applications. It provides on-demand TypeScript and SwissJS source compilation, bare-import rewriting, HMR, Python service lifecycle management, and an esbuild-powered production pipeline.
+
+## Sections
+
+- [Guide](./guide/index.md) — Installation, project layout, configuration reference, and first steps
+- [CLI](./cli/index.md) — `swite dev`, `swite build`, and `swite start` command reference
+- [Architecture](./architecture/index.md) — Internals: dev server, import resolution, HMR, build pipeline, Python integration
+- [Development](./development/index.md) — Contributing, local build, and internal implementation notes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swissjs/swite",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "SWITE - SWISS Development Server (Vite replacement)",
   "type": "module",
   "main": "dist/index.js",
@@ -9,8 +9,8 @@
     "swite": "dist/cli.js"
   },
   "scripts": {
-    "build": "tsc -b",
-    "dev": "tsc -b --watch",
+    "build": "tsc --noEmitOnError false",
+    "dev": "tsc --noEmitOnError false --watch",
     "clean": "rm -rf dist node_modules && rm -f tsconfig.tsbuildinfo",
     "generate-import-map": "tsx src/internal/generate-import-map-cli.ts",
     "test": "node --import tsx --test __tests__/import-rewriter-bug.test.ts",
@@ -19,15 +19,15 @@
     "release:publish": "changeset publish"
   },
   "dependencies": {
-    "@swissjs/core": "0.2.0",
-    "@swissjs/compiler": "0.2.0",
-    "@swissjs/plugin-file-router": "1.0.2",
+    "@swissjs/core": "1.2.1",
+    "@swissjs/compiler": "1.2.1",
+    "@swissjs/plugin-file-router": "1.2.3",
     "chalk": "^5.3.0",
     "chokidar": "^3.5.3",
     "es-module-lexer": "^1.3.1",
     "esbuild": "^0.25.0",
     "express": "^4.18.2",
-    "ws": "^8.20.1"
+    "ws": "^8.21.0"
   },
   "devDependencies": {
     "@types/express": "^4.17.21",
@@ -50,8 +50,9 @@
       "path-to-regexp": "^0.1.13",
       "picomatch": "^2.3.2",
       "qs": ">=6.15.2",
-      "esbuild": ">=0.25.0",
-      "vite": ">=6.4.2"
+      "esbuild": ">=0.28.1",
+      "vite": ">=6.4.3",
+      "js-yaml": "^3.15.0"
     }
   },
   "repository": {

package/src/config/env.ts

@@ -1,98 +1,98 @@
-/*
- * Environment Variable Support for SWITE
- * Provides import.meta.env replacement for SWITE
- */
-
-import { readFileSync, existsSync } from "node:fs";
-import { join } from "node:path";
-
-export interface EnvConfig {
-  mode?: "development" | "production";
-  prefix?: string; // Default: "SWITE_"
-}
-
-/**
- * Load environment variables from .env files.
- * Supports .env, .env.local, .env.[mode], .env.[mode].local
- */
-export function loadEnv(
-  root: string,
-  mode: string = "development",
-  prefix: string = "SWITE_",
-): Record<string, string> {
-  const env: Record<string, string> = {};
-  const envFiles = [`.env.${mode}.local`, `.env.${mode}`, `.env.local`, `.env`];
-
-  for (const file of envFiles) {
-    const envPath = join(root, file);
-    if (!existsSync(envPath)) continue;
-    const content = readFileSync(envPath, "utf-8");
-    for (const line of content.split("\n")) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith("#")) continue;
-      const match = trimmed.match(/^([^=]+)=(.*)$/);
-      if (!match) continue;
-      const key = match[1].trim();
-      const value = match[2].replace(/^["']|["']$/g, "");
-      if (key.startsWith(prefix) || key.startsWith("PUBLIC_")) {
-        env[key] = value;
-      }
-    }
-  }
-
-  return env;
-}
-
-/**
- * Replace all import.meta.env references in compiled code with their literal values.
- *
- * This is the only correct approach for ES modules — import.meta is sealed and
- * import.meta.env cannot be assigned at runtime. All substitution must happen at
- * transform time (here, after esbuild strips TypeScript).
- *
- * Handles:
- *  - import.meta.env.KEY  → JSON.stringify(env[KEY]) or "undefined"
- *  - import.meta.env.DEV  → true/false literal
- *  - import.meta.env.PROD → true/false literal
- *  - import.meta.env.MODE → "development"/"production" literal
- *  - bare import.meta.env → serialized object literal (for spread, typeof, etc.)
- */
-export function inlineEnvReferences(
-  code: string,
-  env: Record<string, string>,
-  mode: string = "development",
-): string {
-  if (!code.includes("import.meta.env")) return code;
-
-  const isDev = mode !== "production";
-
-  // Named key access first (most specific)
-  code = code.replace(/\bimport\.meta\.env\.([A-Z_][A-Z0-9_]*)\b/g, (_, key: string) => {
-    if (key === "DEV") return String(isDev);
-    if (key === "PROD") return String(!isDev);
-    if (key === "MODE") return JSON.stringify(mode);
-    if (key === "SSR") return "false";
-    if (key in env) return JSON.stringify(env[key]);
-    return "undefined";
-  });
-
-  // Bare import.meta.env (spread/typeof patterns)
-  if (code.includes("import.meta.env")) {
-    const envLiteral = buildEnvLiteral(env, mode);
-    code = code.replace(/\bimport\.meta\.env\b/g, envLiteral);
-  }
-
-  return code;
-}
-
-function buildEnvLiteral(env: Record<string, string>, mode: string): string {
-  const isDev = mode !== "production";
-  const entries: string[] = [
-    `MODE:${JSON.stringify(mode)}`,
-    `DEV:${isDev}`,
-    `PROD:${!isDev}`,
-    `SSR:false`,
-    ...Object.entries(env).map(([k, v]) => `${JSON.stringify(k)}:${JSON.stringify(v)}`),
-  ];
-  return `({${entries.join(",")}})`;
-}
+/*
+ * Environment Variable Support for SWITE
+ * Provides import.meta.env replacement for SWITE
+ */
+
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+
+export interface EnvConfig {
+  mode?: "development" | "production";
+  prefix?: string; // Default: "SWITE_"
+}
+
+/**
+ * Load environment variables from .env files.
+ * Supports .env, .env.local, .env.[mode], .env.[mode].local
+ */
+export function loadEnv(
+  root: string,
+  mode: string = "development",
+  prefix: string = "SWITE_",
+): Record<string, string> {
+  const env: Record<string, string> = {};
+  const envFiles = [`.env.${mode}.local`, `.env.${mode}`, `.env.local`, `.env`];
+
+  for (const file of envFiles) {
+    const envPath = join(root, file);
+    if (!existsSync(envPath)) continue;
+    const content = readFileSync(envPath, "utf-8");
+    for (const line of content.split("\n")) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) continue;
+      const match = trimmed.match(/^([^=]+)=(.*)$/);
+      if (!match) continue;
+      const key = match[1].trim();
+      const value = match[2].replace(/^["']|["']$/g, "");
+      if (key.startsWith(prefix) || key.startsWith("PUBLIC_")) {
+        env[key] = value;
+      }
+    }
+  }
+
+  return env;
+}
+
+/**
+ * Replace all import.meta.env references in compiled code with their literal values.
+ *
+ * This is the only correct approach for ES modules — import.meta is sealed and
+ * import.meta.env cannot be assigned at runtime. All substitution must happen at
+ * transform time (here, after esbuild strips TypeScript).
+ *
+ * Handles:
+ *  - import.meta.env.KEY  → JSON.stringify(env[KEY]) or "undefined"
+ *  - import.meta.env.DEV  → true/false literal
+ *  - import.meta.env.PROD → true/false literal
+ *  - import.meta.env.MODE → "development"/"production" literal
+ *  - bare import.meta.env → serialized object literal (for spread, typeof, etc.)
+ */
+export function inlineEnvReferences(
+  code: string,
+  env: Record<string, string>,
+  mode: string = "development",
+): string {
+  if (!code.includes("import.meta.env")) return code;
+
+  const isDev = mode !== "production";
+
+  // Named key access first (most specific)
+  code = code.replace(/\bimport\.meta\.env\.([A-Z_][A-Z0-9_]*)\b/g, (_, key: string) => {
+    if (key === "DEV") return String(isDev);
+    if (key === "PROD") return String(!isDev);
+    if (key === "MODE") return JSON.stringify(mode);
+    if (key === "SSR") return "false";
+    if (key in env) return JSON.stringify(env[key]);
+    return "undefined";
+  });
+
+  // Bare import.meta.env (spread/typeof patterns)
+  if (code.includes("import.meta.env")) {
+    const envLiteral = buildEnvLiteral(env, mode);
+    code = code.replace(/\bimport\.meta\.env\b/g, envLiteral);
+  }
+
+  return code;
+}
+
+function buildEnvLiteral(env: Record<string, string>, mode: string): string {
+  const isDev = mode !== "production";
+  const entries: string[] = [
+    `MODE:${JSON.stringify(mode)}`,
+    `DEV:${isDev}`,
+    `PROD:${!isDev}`,
+    `SSR:false`,
+    ...Object.entries(env).map(([k, v]) => `${JSON.stringify(k)}:${JSON.stringify(v)}`),
+  ];
+  return `({${entries.join(",")}})`;
+}