@swissjs/swite 0.3.5 → 0.4.2

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.3.5",
+  "version": "0.4.2",
   "description": "SWITE - SWISS Development Server (Vite replacement)",
   "type": "module",
   "main": "dist/index.js",
@@ -8,16 +8,26 @@
   "bin": {
     "swite": "dist/cli.js"
   },
+  "scripts": {
+    "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",
+    "changeset": "changeset",
+    "release:version": "changeset version",
+    "release:publish": "changeset publish"
+  },
   "dependencies": {
-    "@swissjs/core": "0.1.11",
-    "@swissjs/compiler": "0.1.5",
-    "@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",
@@ -32,18 +42,21 @@
     "access": "public"
   },
   "license": "MIT",
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ],
+    "overrides": {
+      "path-to-regexp": "^0.1.13",
+      "picomatch": "^2.3.2",
+      "qs": ">=6.15.2",
+      "esbuild": ">=0.28.1",
+      "vite": ">=6.4.3",
+      "js-yaml": "^3.15.0"
+    }
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kibologic/swite.git"
-  },
-  "scripts": {
-    "build": "tsc -b",
-    "dev": "tsc -b --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",
-    "changeset": "changeset",
-    "release:version": "changeset version",
-    "release:publish": "changeset publish"
   }
-}
+}

package/src/build-engine/builder.ts

@@ -56,9 +56,9 @@ export class SwiteBuilder {
       await this.copyPublicAssets();
 
       const duration = Date.now() - startTime;
-      console.log(chalk.green(`\n✅ Build completed in ${duration}ms\n`));
+      console.log(chalk.green(`\n[OK] Build completed in ${duration}ms\n`));
     } catch (error) {
-      console.error(chalk.red("\n❌ Build failed:"), error);
+      console.error(chalk.red("\n[FAIL] Build failed:"), error);
       throw error;
     } finally {
       await fs.rm(tempDir, { recursive: true, force: true });
@@ -66,13 +66,13 @@ export class SwiteBuilder {
   }
 
   private async cleanOutputDir(): Promise<void> {
-    console.log(chalk.blue("🧹 Cleaning output directory..."));
+    console.log(chalk.blue("[clean] Cleaning output directory..."));
     await fs.rm(this.config.outDir, { recursive: true, force: true });
     await fs.mkdir(this.config.outDir, { recursive: true });
   }
 
   private async compileSwissFiles(tempDir: string): Promise<void> {
-    console.log(chalk.blue("🔨 Compiling Swiss files..."));
+    console.log(chalk.blue("[compile] Compiling Swiss files..."));
     await fs.mkdir(tempDir, { recursive: true });
 
     const workspaceRoot = await this.findWorkspaceRoot(this.config.root);
@@ -90,7 +90,7 @@ export class SwiteBuilder {
     // Step 2: Discover and compile workspace dependencies
     const workspaceDeps = await this.discoverWorkspaceDependencies();
     for (const dep of workspaceDeps) {
-      console.log(chalk.blue(`📦 Compiling dependency: ${dep.name}`));
+      console.log(chalk.blue(`[bundle] Compiling dependency: ${dep.name}`));
       // Preserve workspace structure: libraries/skltn/src or packages/cart/src or modules/cart/src
       const depRelativeToWorkspace = workspaceRoot
         ? path.relative(workspaceRoot, dep.pkgDir)
@@ -269,7 +269,7 @@ export class SwiteBuilder {
                     pkgDir,
                   });
                   console.log(
-                    chalk.gray(`  📦 Found workspace dependency: ${depName}`),
+                    chalk.gray(`  [dep] Found workspace dependency: ${depName}`),
                   );
                   break;
                 }
@@ -315,7 +315,7 @@ export class SwiteBuilder {
                 });
                 console.log(
                   chalk.gray(
-                    `  📦 Discovered transitive dependency: ${pkgName}`,
+                    `  [dep] Discovered transitive dependency: ${pkgName}`,
                   ),
                 );
                 break;
@@ -325,14 +325,14 @@ export class SwiteBuilder {
         }
       }
     } catch (error) {
-      console.warn(chalk.yellow("⚠️  Could not discover dependencies:"), error);
+      console.warn(chalk.yellow("[warn] Could not discover dependencies:"), error);
     }
 
     return deps;
   }
 
   private async bundle(tempDir: string): Promise<void> {
-    console.log(chalk.blue("📦 Bundling with esbuild..."));
+    console.log(chalk.blue("[bundle] Bundling with esbuild..."));
 
     const workspaceRoot = await this.findWorkspaceRoot(this.config.root);
     const appRelativeToWorkspace = workspaceRoot

package/src/config/config.ts

@@ -37,11 +37,6 @@ export interface SwiteUserConfig {
    * 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.

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(",")}})`;
+}