@emkodev/emroute 1.6.0-beta.1 → 1.6.1

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="doc/logo-full.png" alt="emroute" width="197" height="40">
+  <img src="https://raw.githubusercontent.com/emko-io/emroute/main/doc/logo-full.png" alt="emroute" width="197" height="40">
 </p>
 
 <p align="center">
@@ -28,18 +28,22 @@ bun add @emkodev/emroute
 > emroute ships TypeScript source. Your toolchain must handle `.ts` imports
 > (Bun, tsx, esbuild, etc.).
 
+For markdown rendering, add [@emkodev/emkoma](doc/08c-setup-emkoma.md) (built
+for emroute) or bring your own — [marked](doc/08a-setup-marked.md) and
+[markdown-it](doc/08b-setup-markdown-it.md) both work.
+
 ## How It Works
 
 <p align="center">
-  <img src="doc/diagram-full.png" alt="emroute architecture" width="480" height="480">
+  <img src="https://raw.githubusercontent.com/emko-io/emroute/main/doc/diagram-full.png" alt="emroute architecture" width="480" height="480">
 </p>
 
 One component, three rendering paths:
 
 <p align="center">
-  <img src="doc/diagram-flow-spa.png" alt="SPA flow" width="320" height="320">
-  <img src="doc/diagram-flow-ssr-html.png" alt="SSR HTML flow" width="320" height="320">
-  <img src="doc/diagram-flow-ssr-md.png" alt="SSR Markdown flow" width="320" height="320">
+  <img src="https://raw.githubusercontent.com/emko-io/emroute/main/doc/diagram-flow-spa.png" alt="SPA flow" width="320" height="320">
+  <img src="https://raw.githubusercontent.com/emko-io/emroute/main/doc/diagram-flow-ssr-html.png" alt="SSR HTML flow" width="320" height="320">
+  <img src="https://raw.githubusercontent.com/emko-io/emroute/main/doc/diagram-flow-ssr-md.png" alt="SSR Markdown flow" width="320" height="320">
 </p>
 
 The SPA and SSR HTML flows both call `renderHTML()` — same output, different
@@ -144,9 +148,10 @@ See [Setup](doc/01-setup.md) and [First Route](doc/02-first-route.md).
 - [SPA modes](doc/10-spa-mode.md) — none, leaf, root, only
 - [Error handling](doc/11-error-handling.md) — widget errors, boundaries, status pages
 - [Shadow DOM](doc/12-shadow-dom.md) — unified architecture, SSR hydration
+- [Hono integration](doc/13-hono.md) — using emroute with Hono
 
 ### For contributors and architects
 
 - [Architectural decisions](doc/architecture/) — ADR-0001 through ADR-0017
 
-<img src="doc/logo-full.png" alt="emroute" width="197" height="40">
+<img src="https://raw.githubusercontent.com/emko-io/emroute/main/doc/logo-full.png" alt="emroute" width="197" height="40">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emkodev/emroute",
-  "version": "1.6.0-beta.1",
+  "version": "1.6.1",
   "description": "File-based router with triple rendering (SPA, SSR HTML, SSR Markdown). Zero dependencies.",
   "license": "BSD-3-Clause",
   "author": "emko.dev",
@@ -18,7 +18,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/vedokme/emroute.git"
+    "url": "https://github.com/emko-io/emroute.git"
   },
   "files": [
     "src/",

package/runtime/abstract.runtime.ts

@@ -53,6 +53,8 @@ export const EMROUTE_EXTERNALS = [
 export interface RuntimeConfig {
   routesDir?: string;
   widgetsDir?: string;
+  /** SPA mode. When 'none', bundling is skipped entirely. */
+  spa?: 'none' | 'leaf' | 'root' | 'only';
   /** Consumer's SPA entry point (e.g. '/main.ts'). Skips app bundle when absent. */
   entryPoint?: string;
   bundlePaths?: {

package/runtime/bun/fs/bun-fs.runtime.ts

@@ -145,6 +145,7 @@ export class BunFsRuntime extends Runtime {
   // ── Bundling ─────────────────────────────────────────────────────────
 
   override async bundle(): Promise<void> {
+    if (this.config.spa === 'none') return;
     const paths = this.config.bundlePaths;
     if (!paths) return;
 

package/runtime/bun/sqlite/bun-sqlite.runtime.ts

@@ -101,6 +101,7 @@ export class BunSqliteRuntime extends Runtime {
   // ── Bundling ─────────────────────────────────────────────────────────
 
   override async bundle(): Promise<void> {
+    if (this.config.spa === 'none') return;
     const paths = this.config.bundlePaths;
     if (!paths) return;
 

package/server/emroute.server.ts

@@ -215,6 +215,9 @@ export async function createEmrouteServer(
     spa = 'root',
   } = config;
 
+  // Let the runtime know the SPA mode so bundle() can skip when 'none'.
+  runtime.config.spa = spa;
+
   const { html: htmlBase, md: mdBase } = config.basePath ?? DEFAULT_BASE_PATH;
 
   // ── Routes manifest (read from runtime) ─────────────────────────────
@@ -364,16 +367,10 @@ export async function createEmrouteServer(
     if (lastSegment.includes('.')) {
       const fileResponse = await runtime.handle(pathname);
       if (fileResponse.status === 200) return fileResponse;
+      return null;
     }
 
-    // Bare paths — in root/only mode, serve SPA shell directly (router handles
-    // client-side nav). In none/leaf mode, redirect to /html/* for SSR.
-    if (spa === 'root' || spa === 'only') {
-      return new Response(shell, {
-        status: 200,
-        headers: { 'Content-Type': 'text/html; charset=utf-8' },
-      });
-    }
+    // Bare paths — redirect to /html/* in all modes.
     const bare = pathname === '/' ? '' : pathname.slice(1).replace(/\/$/, '');
     return Response.redirect(new URL(`${htmlBase}/${bare}`, url.origin), 302);
   }