create-mdsn 0.3.3 → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MDSN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,8 +4,12 @@
 
 Use it when you want the fastest path from a blank directory to a working MDSN app.
 
+It supports both Node and Bun starters.
+
 ## Usage
 
+Node starter:
+
 ```bash
 npm create mdsn@latest agent-app
 cd agent-app
@@ -13,6 +17,27 @@ npm install
 npm start
 ```
 
+Bun starter:
+
+```bash
+bunx create-mdsn agent-app
+cd agent-app
+bun install
+bun start
+```
+
+You can override the generated runtime explicitly:
+
+```bash
+npm create mdsn@latest agent-app -- --runtime bun
+bunx create-mdsn agent-app --runtime node
+```
+
+Defaults:
+
+- `npm create` and `npx create-mdsn` default to the Node starter
+- `bunx create-mdsn` defaults to the Bun starter
+
 The generated app uses this small shape:
 
 - `app/index.md`

package/dist/cli.d.ts

@@ -1,3 +1,12 @@
 #!/usr/bin/env node
-export {};
+import { type StarterRuntime } from "./index.js";
+export interface ParsedCliArgs {
+    targetArg: string | undefined;
+    runtime: StarterRuntime;
+    showHelp: boolean;
+}
+export declare function detectDefaultRuntime(userAgent?: string): StarterRuntime;
+export declare function parseCliArgs(argv: string[], userAgent?: string): ParsedCliArgs;
+export declare function formatUsage(): string;
+export declare function formatNextSteps(projectDir: string, runtime: StarterRuntime, targetArg?: string): string;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD,wBAAgB,oBAAoB,CAAC,SAAS,SAA0C,GAAG,cAAc,CAExG;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,SAA0C,GAAG,aAAa,CAkD/G;AAED,wBAAgB,WAAW,IAAI,MAAM,CAQpC;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,SAAa,GAAG,MAAM,CAa3G"}

package/dist/cli.js

@@ -1,12 +1,84 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { scaffoldStarterProject } from "./index.js";
+function isStarterRuntime(value) {
+    return value === "node" || value === "bun";
+}
+export function detectDefaultRuntime(userAgent = process.env.npm_config_user_agent ?? "") {
+    return /\bbun\/\d/i.test(userAgent) ? "bun" : "node";
+}
+export function parseCliArgs(argv, userAgent = process.env.npm_config_user_agent ?? "") {
+    let targetArg;
+    let runtime = detectDefaultRuntime(userAgent);
+    let showHelp = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            showHelp = true;
+            continue;
+        }
+        if (arg === "--") {
+            continue;
+        }
+        if (arg === "--runtime") {
+            const next = argv[index + 1];
+            if (!next || !isStarterRuntime(next)) {
+                throw new Error('Expected "--runtime" to be followed by "node" or "bun".');
+            }
+            runtime = next;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith("--runtime=")) {
+            const value = arg.slice("--runtime=".length);
+            if (!isStarterRuntime(value)) {
+                throw new Error(`Unsupported runtime "${value}". Expected "node" or "bun".`);
+            }
+            runtime = value;
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            throw new Error(`Unknown option "${arg}".`);
+        }
+        if (targetArg) {
+            throw new Error(`Unexpected extra argument "${arg}".`);
+        }
+        targetArg = arg;
+    }
+    return { targetArg, runtime, showHelp };
+}
+export function formatUsage() {
+    return [
+        "Usage:",
+        "  npm create mdsn@latest <project-name>",
+        "  npm create mdsn@latest <project-name> -- --runtime bun",
+        "  bunx create-mdsn <project-name>",
+        "  bunx create-mdsn <project-name> --runtime node"
+    ].join("\n");
+}
+export function formatNextSteps(projectDir, runtime, targetArg = projectDir) {
+    const installCommand = runtime === "bun" ? "bun install" : "npm install";
+    const startCommand = runtime === "bun" ? "bun start" : "npm start";
+    return [
+        `Created MDSN ${runtime} starter in ${projectDir}`,
+        "",
+        "Next steps:",
+        `  cd ${targetArg}`,
+        "",
+        `  ${installCommand}`,
+        `  ${startCommand}`
+    ].join("\n");
+}
 function printUsage() {
-    console.log("Usage: npm create mdsn@latest <project-name>");
+    console.log(formatUsage());
 }
 async function main(argv) {
-    const [targetArg] = argv;
-    if (!targetArg || targetArg === "--help" || targetArg === "-h") {
+    const { targetArg, runtime, showHelp } = parseCliArgs(argv);
+    if (!targetArg || showHelp) {
         printUsage();
         return;
     }
@@ -14,17 +86,17 @@ async function main(argv) {
     const projectDir = await scaffoldStarterProject({
         targetDir,
         sdkVersion: "latest",
+        runtime,
         ...(targetArg === "." ? {} : { projectName: targetArg })
     });
-    console.log(`Created MDSN starter in ${projectDir}`);
-    console.log("");
-    console.log("Next steps:");
-    console.log(`  cd ${targetArg}`);
-    console.log("  npm install");
-    console.log("  npm start");
-}
-main(process.argv.slice(2)).catch((error) => {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exitCode = 1;
-});
+    console.log(formatNextSteps(projectDir, runtime, targetArg));
+}
+const entryPath = process.argv[1] ? resolve(process.argv[1]) : null;
+const modulePath = resolve(fileURLToPath(import.meta.url));
+if (entryPath === modulePath) {
+    main(process.argv.slice(2)).catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,SAAS,UAAU;IACjB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;IAEzB,IAAI,CAAC,SAAS,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/D,UAAU,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC;QAC9C,SAAS;QACT,UAAU,EAAE,QAAQ;QACpB,GAAG,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;KACzD,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,SAAS,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,7 +1,9 @@
+export type StarterRuntime = "node" | "bun";
 export interface ScaffoldStarterProjectOptions {
     targetDir: string;
     projectName?: string;
     sdkVersion: string;
+    runtime?: StarterRuntime;
 }
 export declare function scaffoldStarterProject(options: ScaffoldStarterProjectOptions, moduleUrl?: string): Promise<string>;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAwDD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,EACtC,SAAS,SAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAoBjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AA6DD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,EACtC,SAAS,SAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/index.js

@@ -5,8 +5,12 @@ const TEMPLATE_PLACEHOLDERS = {
     __PROJECT_NAME__: "",
     __SDK_VERSION__: ""
 };
-function templateRootFromModule(moduleUrl) {
-    return resolve(fileURLToPath(new URL("../template/starter", moduleUrl)));
+const DEFAULT_RUNTIME = "node";
+function templateRootsFromModule(moduleUrl, runtime) {
+    return [
+        resolve(fileURLToPath(new URL("../template/shared", moduleUrl))),
+        resolve(fileURLToPath(new URL(`../template/${runtime}`, moduleUrl)))
+    ];
 }
 async function ensureEmptyTarget(targetDir) {
     try {
@@ -52,14 +56,17 @@ async function walkFiles(root) {
     return files;
 }
 export async function scaffoldStarterProject(options, moduleUrl = import.meta.url) {
-    const templateRoot = templateRootFromModule(moduleUrl);
+    const runtime = options.runtime ?? DEFAULT_RUNTIME;
+    const templateRoots = templateRootsFromModule(moduleUrl, runtime);
     const targetDir = resolve(options.targetDir);
     const projectName = options.projectName?.trim() || basename(targetDir);
     if (!projectName) {
         throw new Error("Project name cannot be empty.");
     }
     await ensureEmptyTarget(targetDir);
-    await cp(templateRoot, targetDir, { recursive: true });
+    for (const templateRoot of templateRoots) {
+        await cp(templateRoot, targetDir, { recursive: true });
+    }
     const replacements = {
         __PROJECT_NAME__: projectName,
         __SDK_VERSION__: options.sdkVersion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQzC,MAAM,qBAAqB,GAAG;IAC5B,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,EAAE;CACX,CAAC;AAEX,SAAS,sBAAsB,CAAC,SAAiB;IAC/C,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IAChD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,gBAAgB,SAAS,0CAA0C,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,qBAAqB,SAAS,kBAAkB,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,YAAoC;IACjF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAClD,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5D,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC3C,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAsC,EACtC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG;IAE3B,MAAM,YAAY,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEvE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvD,MAAM,YAAY,GAAG;QACnB,gBAAgB,EAAE,WAAW;QAC7B,eAAe,EAAE,OAAO,CAAC,UAAU;KACpC,CAAC;IAEF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAClF,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "create-mdsn",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "private": false,
-  "description": "Create a minimal MDSN app with npm create.",
+  "description": "Create a minimal MDSN app with npm create or bunx.",
   "license": "MIT",
   "homepage": "https://docs.mdsn.ai",
   "bugs": {
@@ -23,7 +23,8 @@
     "workflow",
     "skills-app",
     "agent-app",
-    "cli"
+    "cli",
+    "bun"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -34,11 +35,18 @@
   "files": [
     "dist",
     "README.md",
-    "template/starter"
+    "LICENSE",
+    "template/shared",
+    "template/node",
+    "template/bun"
   ],
   "bin": {
     "create-mdsn": "./dist/cli.js"
   },
+  "scripts": {
+    "prepack": "node ../scripts/sync-package-license.mjs",
+    "postpack": "node ../scripts/sync-package-license.mjs --cleanup"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -46,6 +54,6 @@
     }
   },
   "dependencies": {
-    "@mdsnai/sdk": "0.3.3"
+    "@mdsnai/sdk": "0.4.0"
   }
 }

package/template/bun/README.md

@@ -0,0 +1,31 @@
+# __PROJECT_NAME__
+
+This is a minimal MDSN starter for the Bun host.
+
+## 30-Second Tour
+
+- `app/index.md`
+  Defines the page source and interaction.
+- `app/server.ts`
+  Owns state and action handlers.
+- `app/client.ts`
+  Mounts the browser runtime.
+- `index.mjs`
+  Starts the Bun host.
+
+## Run It
+
+```bash
+bun install
+bun start
+```
+
+This starter is Bun-native, so you can use it without installing Node.
+
+Then open [http://127.0.0.1:3000/](http://127.0.0.1:3000/).
+
+## First Things To Change
+
+1. Edit `app/index.md`
+2. Edit `app/server.ts`
+3. Keep `app/client.ts` as-is, or replace it when you want to own the UI

package/template/bun/index.mjs

@@ -0,0 +1,63 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { createHost } from "@mdsnai/sdk/server/bun";
+
+import { createAppServer } from "./dist/server.js";
+
+const port = Number(process.env.PORT || 3000);
+const hostname = process.env.HOST || "127.0.0.1";
+const projectRoot = fileURLToPath(new URL("./", import.meta.url));
+const sourcePath = join(projectRoot, "app", "index.md");
+const assetVersion = Date.now().toString(36);
+
+function withVersion(path) {
+  return `${path}?v=${assetVersion}`;
+}
+
+const importMap = {
+  imports: {
+    "@mdsnai/sdk/core": withVersion("/node_modules/@mdsnai/sdk/dist/core/index.js"),
+    "@mdsnai/sdk/web": withVersion("/node_modules/@mdsnai/sdk/dist/web/index.js"),
+    "@mdsnai/sdk/elements": withVersion("/node_modules/@mdsnai/sdk/dist/elements/index.js"),
+    "lit": withVersion("/node_modules/lit/index.js"),
+    "lit-html": withVersion("/node_modules/lit-html/lit-html.js"),
+    "lit-html/is-server.js": withVersion("/node_modules/lit-html/is-server.js"),
+    "lit-element/lit-element.js": withVersion("/node_modules/lit-element/lit-element.js"),
+    "@lit/reactive-element": withVersion("/node_modules/@lit/reactive-element/reactive-element.js")
+  }
+};
+
+function injectEnhancement(html) {
+  const enhancement = `
+<script type="importmap">${JSON.stringify(importMap)}</script>
+<script type="module">
+  import { mountApp } from "${withVersion("/app/client.js")}";
+  mountApp(document, window.fetch.bind(window));
+</script>`;
+
+  return html.replace("</body>", `${enhancement}\n  </body>`);
+}
+
+const source = await readFile(sourcePath, "utf8");
+const mdsn = createAppServer({ source });
+
+Bun.serve({
+  hostname,
+  port,
+  fetch: createHost(mdsn, {
+    transformHtml: injectEnhancement,
+    staticFiles: {
+      "/app/client.js": join(projectRoot, "dist", "client.js")
+    },
+    staticMounts: [
+      {
+        urlPrefix: "/node_modules/",
+        directory: join(projectRoot, "node_modules")
+      }
+    ]
+  })
+});
+
+console.log(`MDSN starter running at http://${hostname}:${port}/`);

package/template/bun/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "tsc -p tsconfig.json && bun run index.mjs"
+  },
+  "dependencies": {
+    "@mdsnai/sdk": "__SDK_VERSION__"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.3"
+  }
+}

package/template/{starter → node}/README.md

@@ -1,6 +1,6 @@
 # __PROJECT_NAME__
 
-This is a minimal MDSN starter.
+This is a minimal MDSN starter for the Node host.
 
 ## 30-Second Tour
 

package/template/{starter → node}/index.mjs

@@ -3,7 +3,7 @@ import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 
-import { createNodeHost } from "@mdsnai/sdk/server";
+import { createHost } from "@mdsnai/sdk/server/node";
 
 import { createAppServer } from "./dist/server.js";
 
@@ -43,7 +43,7 @@ function injectEnhancement(html) {
 const source = await readFile(sourcePath, "utf8");
 const mdsn = createAppServer({ source });
 const server = http.createServer(
-  createNodeHost(mdsn, {
+  createHost(mdsn, {
     transformHtml: injectEnhancement,
     staticFiles: {
       "/app/client.js": join(projectRoot, "dist", "client.js")

package/template/{starter → node}/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "start": "npm run build && node index.mjs"
+    "start": "tsc -p tsconfig.json && node index.mjs"
   },
   "dependencies": {
     "@mdsnai/sdk": "__SDK_VERSION__"