atollic 0.0.2 → 0.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arvin Wilderink
+
+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

@@ -1,5 +1,10 @@
 # atollic
 
+[![npm version](https://img.shields.io/npm/v/atollic.svg)](https://www.npmjs.com/package/atollic)
+[![CI](https://github.com/awilderink/atollic/actions/workflows/ci.yml/badge.svg)](https://github.com/awilderink/atollic/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/npm/l/atollic.svg)](./LICENSE)
+[![Bundle size](https://img.shields.io/bundlephobia/minzip/atollic)](https://bundlephobia.com/package/atollic)
+
 Island architecture for WinterCG-compatible runtimes. Bring your own server (Elysia, Hono, …) and your own UI framework, powered by Vite.
 
 > **Status: experimental.** atollic is pre-1.0 (`v0.0.x`). The API may change between minor versions until 1.0.
@@ -126,7 +131,9 @@ const app = new Elysia()
 export default app.handle;
 ```
 
-The Elysia adapter intercepts responses via `mapResponse`, extracts HTML from Solid's SSR format, ensures DOCTYPE, and injects production assets.
+The Elysia adapter intercepts responses via `mapResponse`, extracts HTML, ensures DOCTYPE, and injects production assets.
+
+The HTML-extraction step is **registry-based** — each `FrameworkAdapter` contributes an extractor function (via the `extractHtml` field) that knows how to convert its framework's SSR output (e.g. Solid's `{ t: "..." }` shape) into a plain HTML string. The atollic Vite plugin wires these registrations up automatically before the first request, so the core stays framework-agnostic. Plain strings are always recognized as a fallback. See [Writing a framework adapter](#writing-a-framework-adapter) and the [`registerHtmlExtractor`](#atollic) API.
 
 ### Hono
 
@@ -280,9 +287,9 @@ Listen to lifecycle events on `document`:
 | `atollic:before-morph` | `{ newDoc, mountedIslands }` | Cancelable, before HMR page morph |
 | `atollic:after-morph` | `{ defaultSwap }` | After HMR page morph |
 
-## htmx integration
+## htmx, Alpine, and other DOM-mutating libraries
 
-Islands hydrate automatically after htmx swaps. The client runtime listens for `htmx:afterSettle` and mounts any new `[data-island]` elements. A `MutationObserver` also catches dynamically added islands from any source.
+Islands added to the DOM after the initial mount — by htmx swaps, Alpine templates, or any other source — are picked up automatically. The client runtime installs a `MutationObserver` on `document.body` and mounts any newly inserted `[data-island]` element. No library-specific event listener is required.
 
 ## CSS handling
 
@@ -348,10 +355,22 @@ export function myFramework(): FrameworkAdapter {
 
     // Optional: script tag for hydration bootstrap (e.g., Solid's _$HY)
     hydrationScript: `<script>/* bootstrap */</script>`,
+
+    // Optional: source code for an extractor function `(value) => string | null`.
+    // Atollic includes this in the server boot module so the runtime knows
+    // how to convert this framework's SSR output (e.g. Solid's `{ t: "..." }`
+    // shape) into a plain HTML string. Frameworks whose SSR output is already
+    // a string can omit this — plain strings are always recognized.
+    extractHtml: `(value) => {
+      if (value && typeof value === "object" && "t" in value) return value.t;
+      return null;
+    }`,
   };
 }
 ```
 
+The `extractHtml` strings from every registered adapter are emitted into a generated server-boot module that runs once before the first request. Each one calls `registerHtmlExtractor()` on the atollic core, which `extractHtml` (used internally by the Elysia and Hono adapters) iterates in order. This is how the core stays decoupled from any specific UI framework's SSR output shape.
+
 ## API reference
 
 ### `atollic/vite`
@@ -368,9 +387,20 @@ atollic(options: AtollicOptions): Plugin[]
 ### `atollic`
 
 ```ts
-html(input: string): Response              // Wrap HTML string in a Response with DOCTYPE
+// Wrap an HTML string (or async JSX) in a Response with DOCTYPE.
+// Returns a Promise<Response> when given a Promise<string>.
+html(input: string | Promise<string>): Response | Promise<Response>
+
 setProductionAssets(assets: string): void   // Set production asset tags
 getProductionAssets(): string | undefined   // Get production asset tags
+
+// Register a function that converts a framework-specific SSR output value
+// into an HTML string (or returns null if it doesn't recognize the shape).
+// Normally wired up automatically by the Vite plugin from each adapter's
+// `extractHtml` field — call this directly only if you need a custom one.
+// Returns a dispose function.
+type HtmlExtractor = (value: unknown) => string | null
+registerHtmlExtractor(fn: HtmlExtractor): () => void
 ```
 
 ### `atollic/elysia`
@@ -402,15 +432,26 @@ solid(): FrameworkAdapter  // Solid.js framework adapter
 Types for server-side JSX:
 
 ```ts
-type Component<P = {}> = (props: P & { children?: Children }) => string
-type Children = string | string[] | Promise<string>
+type Children =
+  | string
+  | number
+  | bigint
+  | boolean
+  | null
+  | undefined
+  | Promise<Children>
+  | Children[]
+
+type Component<T = {}> = (
+  props: T & { children?: Children },
+) => string | Promise<string>
 ```
 
 ## Exports
 
 | Export | Description |
 |---|---|
-| `atollic` | Core — `html()`, `setProductionAssets()`, `getProductionAssets()` |
+| `atollic` | Core — `html()`, `setProductionAssets()`, `getProductionAssets()`, `registerHtmlExtractor()` |
 | `atollic/vite` | Vite plugin |
 | `atollic/client` | Client runtime (auto-imported) |
 | `atollic/adapter` | `FrameworkAdapter` type |

package/dist/adapter.d.ts

@@ -36,4 +36,20 @@ export interface FrameworkAdapter {
      * can omit this.
      */
     hydrationScript?: string;
+    /**
+     * Source code for an extractor function with the signature
+     * `(value: unknown) => string | null`.
+     *
+     * The atollic Vite plugin includes this in the server boot module so the
+     * runtime knows how to convert this framework's SSR output (e.g. Solid's
+     * `{ t: "..." }` shape) into a plain HTML string. Frameworks whose SSR
+     * output is already a string can omit this — the core falls back to
+     * recognizing plain strings on its own.
+     *
+     * @example
+     *   extractHtml: `(value) => value && typeof value === "object" && "t" in value
+     *     ? value.t
+     *     : null`
+     */
+    extractHtml?: string;
 }

package/dist/adapters/solid.js

@@ -30,7 +30,8 @@ function n() {
 			return a;
 		},
 		clientRuntime: "\nimport { hydrate as _hydrate, render as _render } from \"solid-js/web\";\nimport { $DEVCOMP } from \"solid-js\";\n\nexport function hydrateIsland(el, Component, props, id) {\n  if ($DEVCOMP && !($DEVCOMP in Component)) {\n    Component[$DEVCOMP] = true;\n  }\n  return _hydrate(() => Component(props), el, { renderId: id });\n}\n\nexport function renderIsland(el, Component, props) {\n  if ($DEVCOMP && !($DEVCOMP in Component)) {\n    Component[$DEVCOMP] = true;\n  }\n  el.textContent = \"\";\n  return _render(() => Component(props), el);\n}\n",
-		hydrationScript: "<script>(self._$HY||(self._$HY={events:[],completed:new WeakSet,r:{}}))<\/script>"
+		hydrationScript: "<script>(self._$HY||(self._$HY={events:[],completed:new WeakSet,r:{}}))<\/script>",
+		extractHtml: "(value) => {\n  if (value && typeof value === \"object\" && \"t\" in value && typeof value.t === \"string\") {\n    return value.t;\n  }\n  if (Array.isArray(value)) {\n    const html = value.flat(Infinity).map((item) => {\n      if (typeof item === \"string\") return item;\n      if (item && typeof item === \"object\" && \"t\" in item) return item.t;\n      return \"\";\n    }).join(\"\");\n    return html || null;\n  }\n  return null;\n}"
 	};
 }
 //#endregion

package/dist/index.d.ts

@@ -1 +1,2 @@
-export { getProductionAssets, html, setProductionAssets } from "./server.js";
+export type { HtmlExtractor } from "./server.js";
+export { getProductionAssets, html, registerHtmlExtractor, setProductionAssets, } from "./server.js";

package/dist/index.js

@@ -1,2 +1,3 @@
-import { n as e, r as t, t as n } from "./server-DhToIUB0.js";
-export { n as getProductionAssets, e as html, t as setProductionAssets };
+import { o as e } from "./shared-Bv39_NsU.js";
+import { n as t, r as n, t as r } from "./server-DAuZqGuP.js";
+export { r as getProductionAssets, t as html, e as registerHtmlExtractor, n as setProductionAssets };

package/dist/{server-DhToIUB0.js → server-DAuZqGuP.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./shared-CfRCLggd.js";
+import { t as e } from "./shared-Bv39_NsU.js";
 //#region src/server.ts
 var t = "__atollicProdAssets";
 function n(e) {

package/dist/server.d.ts

@@ -1,6 +1,8 @@
 /**
  * Server-side helpers for atollic.
  */
+export type { HtmlExtractor } from "./shared.js";
+export { registerHtmlExtractor } from "./shared.js";
 /**
  * Set the production asset tags (scripts + CSS) to inject into HTML responses.
  * Called by the generated production entry before the server starts.

package/dist/servers/elysia.js

@@ -1,5 +1,5 @@
-import { a as e, i as t, n } from "../shared-CfRCLggd.js";
-import { t as r } from "../server-DhToIUB0.js";
+import { a as e, i as t, n } from "../shared-Bv39_NsU.js";
+import { t as r } from "../server-DAuZqGuP.js";
 import { Elysia as i } from "elysia";
 //#region src/servers/elysia.ts
 function a() {

package/dist/servers/hono.js

@@ -1,5 +1,5 @@
-import { a as e, i as t } from "../shared-CfRCLggd.js";
-import { t as n } from "../server-DhToIUB0.js";
+import { a as e, i as t } from "../shared-Bv39_NsU.js";
+import { t as n } from "../server-DAuZqGuP.js";
 //#region src/servers/hono.ts
 function r() {
 	return async (r, i) => {

package/dist/shared-Bv39_NsU.js

@@ -0,0 +1,39 @@
+//#region src/shared.ts
+var e = /<meta\s+name="atollic-head"\s*\/?>/;
+function t(t, n) {
+	let r = t.replace(e, n);
+	return r === t ? t.includes("</head>") ? t.replace("</head>", `  ${n}\n</head>`) : t : r;
+}
+var n = "__atollicHtmlExtractors";
+function r() {
+	let e = globalThis;
+	return Array.isArray(e[n]) || (e[n] = []), e[n];
+}
+function i(e) {
+	let t = r();
+	return t.push(e), () => {
+		let n = t.indexOf(e);
+		n >= 0 && t.splice(n, 1);
+	};
+}
+function a(e) {
+	for (let t of r()) {
+		let n = t(e);
+		if (n !== null) return n;
+	}
+	return typeof e == "string" ? e : null;
+}
+function o(e) {
+	let t = e.trimStart();
+	return t.startsWith("<html") && !t.startsWith("<!DOCTYPE") ? `<!DOCTYPE html>\n${e}` : e;
+}
+function s(e) {
+	let t = e.trimStart();
+	return t.startsWith("<!DOCTYPE") || t.startsWith("<html");
+}
+function c(e, n) {
+	let r = o(e);
+	return n && (r = t(r, n)), r;
+}
+//#endregion
+export { c as a, s as i, a as n, i as o, t as r, o as t };

package/dist/shared.d.ts

@@ -1,8 +1,23 @@
 /** Replace <Head /> marker with tags, or fall back to </head> injection. */
 export declare function injectHead(html: string, tags: string): string;
 /**
- * Extract HTML from Solid's SSR output format.
- * Handles `{t: "<html>"}` objects and arrays of fragments.
+ * A function that converts a framework-specific SSR output value into an HTML
+ * string, or returns `null` if it doesn't recognize the shape.
+ */
+export type HtmlExtractor = (value: unknown) => string | null;
+/**
+ * Register a function that extracts an HTML string from a framework-specific
+ * SSR output. The atollic Vite plugin wires this up automatically — every
+ * `FrameworkAdapter` with an `extractHtml` source string gets registered
+ * before the first request is served.
+ *
+ * @returns A dispose function that removes the extractor.
+ */
+export declare function registerHtmlExtractor(fn: HtmlExtractor): () => void;
+/**
+ * Convert a server response value into an HTML string by trying each
+ * registered framework extractor, then falling back to a plain string.
+ * Returns `null` when nothing recognizes the shape.
  */
 export declare function extractHtml(value: unknown): string | null;
 /** Prepend DOCTYPE if the string looks like HTML but is missing it. */

package/dist/vite.js

@@ -1,23 +1,23 @@
-import { i as e, n as t, r as n, t as r } from "./shared-CfRCLggd.js";
+import { i as e, n as t, r as n, t as r } from "./shared-Bv39_NsU.js";
 import { readFileSync as i } from "node:fs";
 import { glob as a, readFile as o } from "node:fs/promises";
 import { basename as s, dirname as c, extname as l, relative as u, resolve as d } from "node:path";
 import { fileURLToPath as f } from "node:url";
 import { transformWithOxc as p } from "vite";
 //#region src/vite.ts
-var m = c(f(import.meta.url)), h = "virtual:atollic/client", g = `\0${h}`, _ = "virtual:atollic/prod-entry", v = `\0${_}`, y = "virtual:atollic/fw-", b = "atollic:reload", x = "?raw-island", S = /\.[jt]sx?$/, C = /\.[jt]sx$/, w = /\.css($|\?)/;
-function T(e) {
+var m = c(f(import.meta.url)), h = "virtual:atollic/client", g = `\0${h}`, _ = "virtual:atollic/prod-entry", v = `\0${_}`, y = "virtual:atollic/server-boot", b = `\0${y}`, x = "virtual:atollic/fw-", S = "atollic:reload", C = "?raw-island", w = /\.[jt]sx?$/, T = /\.[jt]sx$/, E = /\.css($|\?)/;
+function D(e) {
 	let t = e.replace(/^\s*(\/\*[\s\S]*?\*\/\s*|\/\/[^\n]*\n\s*)*/g, "").match(/^["']use client(?::(\w+))?["']/);
 	return t ? {
 		hasDirective: !0,
 		framework: t[1]
 	} : { hasDirective: !1 };
 }
-function E(e) {
+function O(e) {
 	return e.replace(/^["']use client(?::\w+)?["'];?\s*/m, "");
 }
-function D(e, t) {
-	let n = [], r = E(e), i = r.match(/export\s+default\s+(?:function|class)\s+([A-Z]\w*)/);
+function k(e, t) {
+	let n = [], r = O(e), i = r.match(/export\s+default\s+(?:function|class)\s+([A-Z]\w*)/);
 	i ? n.push({
 		exportName: "default",
 		islandName: i[1]
@@ -31,7 +31,10 @@ function D(e, t) {
 	});
 	return n;
 }
-function O(e, t, n, r) {
+function A(e) {
+	return e.map((e) => e.extractHtml).filter((e) => !!e).map((e) => `registerHtmlExtractor(${e});`).join("\n");
+}
+function j(e, t, n, r) {
 	let i = [...n].map((e) => `import "${e}";`).join("\n"), a = [...t].map((e) => `import "/${u(r, e)}";`).join("\n"), o = /* @__PURE__ */ new Map();
 	for (let [t, n] of Object.entries(e)) {
 		let e = n.adapter.name;
@@ -40,7 +43,7 @@ function O(e, t, n, r) {
 	let s = "import { registerIsland, registerFramework, initRuntime } from \"atollic/client\";\n";
 	s += `${i}\n`, s += `${a}\n\n`;
 	for (let [e, t] of o) {
-		let n = `${y}${e}`;
+		let n = `${x}${e}`;
 		s += `import { hydrateIsland as __hydrate_${e}, renderIsland as __render_${e} } from "${n}";\n`, s += `registerFramework("${e}", __hydrate_${e}, __render_${e});\n\n`;
 		for (let [n, i] of t) {
 			let t = `/${u(r, i.absPath)}`;
@@ -49,7 +52,7 @@ function O(e, t, n, r) {
 	}
 	return s += "\ninitRuntime();\n", s;
 }
-function k(e) {
+function M(e) {
 	let t = new URL(e.url ?? "/", `http://${e.headers.host || "localhost"}`), n = new Headers();
 	for (let [t, r] of Object.entries(e.headers)) if (r) if (Array.isArray(r)) for (let e of r) n.append(t, e);
 	else n.set(t, r);
@@ -61,48 +64,48 @@ function k(e) {
 		e.on("data", (e) => t.enqueue(e)), e.on("end", () => t.close()), e.on("error", (e) => t.error(e));
 	} }), r.duplex = "half"), new Request(t, r);
 }
-function A(e, t) {
+function N(e, t) {
 	let n = [];
 	if (t) for (let e of t) n.push(`<link rel="stylesheet" href="${e}">`);
 	for (let t of e) t.hydrationScript && n.push(t.hydrationScript);
 	return n.push(`<script type="module">import "${h}";<\/script>`), n.join("\n  ");
 }
-function j(e, t) {
+function P(e, t) {
 	let n = /* @__PURE__ */ new Set(), r = /* @__PURE__ */ new Set();
 	function i(t) {
 		if (r.has(t)) return;
 		r.add(t);
 		let a = e.moduleGraph.getModuleById(t);
 		if (a) {
-			w.test(a.url) && n.add(a.url);
+			E.test(a.url) && n.add(a.url);
 			for (let e of a.ssrImportedModules) i(e.id ?? e.url);
 		}
 	}
 	let a = e.moduleGraph.getModuleById(t);
 	return a && i(a.id ?? a.url), n;
 }
-function M(u) {
-	let f = u.frameworks ?? [], w = f[0], M = "", N = {}, P = /* @__PURE__ */ new Set(), F = /* @__PURE__ */ new Set(), I = "", L = 3e3, R = null, z = "", B = !1, V = null;
-	function H(e) {
-		return e ? f.find((t) => t.name === e) : w;
+function F(u) {
+	let f = u.frameworks ?? [], E = f[0], F = "", I = {}, L = /* @__PURE__ */ new Set(), R = /* @__PURE__ */ new Set(), z = "", B = 3e3, V = null, H = "", U = !1, W = null;
+	function G(e) {
+		return e ? f.find((t) => t.name === e) : E;
 	}
-	function U() {
-		if (!R) return;
-		let e = R.moduleGraph.getModuleById(g);
-		e && R.moduleGraph.invalidateModule(e);
+	function K() {
+		if (!V) return;
+		let e = V.moduleGraph.getModuleById(g);
+		e && V.moduleGraph.invalidateModule(e);
 	}
-	function W(e, t) {
-		N[t] || (N[t] = e, U());
+	function q(e, t) {
+		I[t] || (I[t] = e, K());
 	}
-	function G(e, t, n) {
-		let r = D(t, s(e, l(e)));
-		for (let t of r) W({
+	function J(e, t, n) {
+		let r = k(t, s(e, l(e)));
+		for (let t of r) q({
 			absPath: e,
 			exportName: t.exportName,
 			adapter: n
 		}, t.islandName);
 	}
-	let K = {
+	let Y = {
 		name: "atollic",
 		enforce: "pre",
 		sharedDuringBuild: !0,
@@ -129,31 +132,31 @@ function M(u) {
 		},
 		async buildApp(e) {
 			await e.build(e.environments.client);
-			let t = d(M, "dist/client/.vite/manifest.json"), n = JSON.parse(await o(t, "utf-8")), r = n.client ?? n["virtual:atollic/client"], i = [];
+			let t = d(F, "dist/client/.vite/manifest.json"), n = JSON.parse(await o(t, "utf-8")), r = n.client ?? n["virtual:atollic/client"], i = [];
 			for (let e of Object.values(n)) if (e.css) for (let t of e.css) i.push(`<link rel="stylesheet" href="/${t}">`);
 			for (let e of f) e.hydrationScript && i.push(e.hydrationScript);
-			r && i.push(`<script type="module" src="/${r.file}"><\/script>`), z = i.join("\n  "), await e.build(e.environments.ssr);
+			r && i.push(`<script type="module" src="/${r.file}"><\/script>`), H = i.join("\n  "), await e.build(e.environments.ssr);
 		},
 		async configResolved(e) {
-			M = e.root, I = d(M, u.entry), L = e.server.port ?? 3e3;
+			F = e.root, z = d(F, u.entry), B = e.server.port ?? 3e3;
 		},
 		async buildStart() {
-			if (B) return;
-			B = !0;
+			if (U) return;
+			U = !0;
 			let e = /import\s+['"]([^'"]+\.css)['"]/g, t = /import\s.*?from\s+['"](\.\.?\/[^'"]+)['"]/g, n = /* @__PURE__ */ new Set();
 			function r(t, n) {
-				let r = T(n);
-				if (r.hasDirective) if (C.test(t)) {
-					let e = H(r.framework);
-					e ? G(t, n, e) : r.framework && console.warn(`[atollic] Unknown framework "${r.framework}" in ${t}`);
-				} else P.add(t);
-				for (let t of n.matchAll(e)) F.add(t[1]);
+				let r = D(n);
+				if (r.hasDirective) if (T.test(t)) {
+					let e = G(r.framework);
+					e ? J(t, n, e) : r.framework && console.warn(`[atollic] Unknown framework "${r.framework}" in ${t}`);
+				} else L.add(t);
+				for (let t of n.matchAll(e)) R.add(t[1]);
 			}
 			for await (let e of a("**/*.{ts,tsx,js,jsx}", {
-				cwd: M,
+				cwd: F,
 				exclude: ["node_modules/**", "dist/**"]
 			})) {
-				let t = d(M, e);
+				let t = d(F, e);
 				n.add(t);
 				try {
 					r(t, await o(t, "utf-8"));
@@ -183,23 +186,31 @@ function M(u) {
 					} catch {}
 				}
 			}
-			await i(I);
+			await i(z);
 		},
 		resolveId(e) {
 			if (e === h) return g;
 			if (e === _) return v;
-			if (e.startsWith(y)) return `\0${e}`;
-			if (e.endsWith(x)) return `${e.slice(0, -11)}${x}`;
+			if (e === y) return b;
+			if (e.startsWith(x)) return `\0${e}`;
+			if (e.endsWith(C)) return `${e.slice(0, -11)}${C}`;
 		},
 		load(e, t) {
-			if (e === g) return O(N, P, F, M);
-			if (e === v) return `import { resolve, join } from "node:path";
-import { setProductionAssets } from "${d(m, "index.js")}";
-setProductionAssets(${JSON.stringify(z)});
-import handler from "${I}";
+			if (e === g) return j(I, L, R, F);
+			if (e === b) {
+				let e = d(m, "index.js"), t = A(f);
+				return t ? `import { registerHtmlExtractor } from "${e}";\n${t}\n` : "// no html extractors registered\n";
+			}
+			if (e === v) {
+				let e = d(m, "index.js"), t = A(f);
+				return `import { resolve, join } from "node:path";
+import { setProductionAssets, registerHtmlExtractor } from "${e}";
+setProductionAssets(${JSON.stringify(H)});
+${t}
+import handler from "${z}";
 
 const clientDir = resolve(import.meta.dirname, "..", "client");
-const port = process.env.PORT || ${L};
+const port = process.env.PORT || ${B};
 
 Bun.serve({
   port,
@@ -215,45 +226,48 @@ Bun.serve({
 });
 console.log(\`Listening on http://localhost:\${port}\`);
 `;
-			if (e.startsWith("\0" + y)) {
-				let t = e.slice(("\0" + y).length), n = f.find((e) => e.name === t);
+			}
+			if (e.startsWith("\0" + x)) {
+				let t = e.slice(("\0" + x).length), n = f.find((e) => e.name === t);
 				if (n) return n.clientRuntime;
 			}
-			if (e.endsWith(x)) {
+			if (e.endsWith(C)) {
 				let t = e.slice(0, -11);
 				try {
-					return E(i(t, "utf-8"));
+					return O(i(t, "utf-8"));
 				} catch {}
 				return;
 			}
-			if (!(!t?.ssr || !S.test(e))) try {
-				let t = i(e, "utf-8"), n = T(t);
+			if (!(!t?.ssr || !w.test(e))) try {
+				let t = i(e, "utf-8"), n = D(t);
 				if (n.hasDirective) {
-					if (!C.test(e)) return P.add(e), U(), "export default {};";
-					let r = H(n.framework);
+					if (!T.test(e)) return L.add(e), K(), "export default {};";
+					let r = G(n.framework);
 					if (!r) {
 						n.framework && console.warn(`[atollic] Unknown framework "${n.framework}" in ${e}`);
 						return;
 					}
-					let i = D(t, s(e, l(e)));
-					for (let t of i) W({
+					let i = k(t, s(e, l(e)));
+					for (let t of i) q({
 						absPath: e,
 						exportName: t.exportName,
 						adapter: r
 					}, t.islandName);
-					let a = `${e}${x}`;
+					let a = `${e}${C}`;
 					return r.ssrStub(a, i);
 				}
 			} catch {}
 		},
 		configureServer(i) {
-			R = i, i.middlewares.use(async (a, o, s) => {
+			V = i, i.ssrLoadModule(y).catch((e) => {
+				console.error("[atollic] Failed to load server boot module:", e);
+			}), i.middlewares.use(async (a, o, s) => {
 				let c = a.url || "";
 				if (c.startsWith("/@") || c.startsWith("/node_modules") || c.startsWith("/__") || /\.\w+($|\?)/.test(c)) return s();
 				try {
-					let l = await i.ssrLoadModule(I), u = l.default ?? l.handler;
+					let l = await i.ssrLoadModule(z), u = l.default ?? l.handler;
 					if (typeof u != "function") return console.error("[atollic] Entry must default-export a fetch function: (req: Request) => Response"), s();
-					let d = await u(k(a));
+					let d = await u(M(a));
 					if (d.status === 404) return s();
 					let p = await d.text(), m = d.headers.get("content-type") || "";
 					if (m.includes("application/json")) try {
@@ -261,7 +275,7 @@ console.log(\`Listening on http://localhost:\${port}\`);
 						e && (p = e, m = "");
 					} catch {}
 					let h = e(p);
-					!m.includes("text/html") && h && (m = "text/html; charset=utf-8"), h && (p = r(p), V ||= j(i, I), p = n(p, A(f, V)), p = await i.transformIndexHtml(c, p));
+					!m.includes("text/html") && h && (m = "text/html; charset=utf-8"), h && (p = r(p), W ||= P(i, z), p = n(p, N(f, W)), p = await i.transformIndexHtml(c, p));
 					let g = {};
 					for (let [e, t] of d.headers) g[e] = t;
 					m ? g["content-type"] = m : g["content-type"] ||= "text/html; charset=utf-8", o.writeHead(d.status, g), o.end(p);
@@ -271,23 +285,23 @@ console.log(\`Listening on http://localhost:\${port}\`);
 			});
 		},
 		handleHotUpdate({ file: e, server: t }) {
-			if (V = null, !e.endsWith(".ts") && !e.endsWith(".tsx")) return;
+			if (W = null, !e.endsWith(".ts") && !e.endsWith(".tsx")) return;
 			try {
-				if (T(i(e, "utf-8")).hasDirective) return;
+				if (D(i(e, "utf-8")).hasDirective) return;
 			} catch {}
 			let n = t.moduleGraph.getModulesByFile(e);
 			if (n) for (let e of n) t.moduleGraph.invalidateModule(e);
 			return t.ws.send({
 				type: "custom",
-				event: b
+				event: S
 			}), [];
 		}
-	}, q = /@jsxImportSource\s+(\S+)/, J = {
+	}, X = /@jsxImportSource\s+(\S+)/, Z = {
 		name: "atollic:jsx-pre-transform",
 		enforce: "pre",
 		async transform(e, t) {
 			if (!/\.[jt]sx$/.test(t)) return;
-			let n = e.match(q);
+			let n = e.match(X);
 			if (n) {
 				let e = n[1];
 				for (let t of f) if (e.includes(t.name)) return;
@@ -301,13 +315,13 @@ console.log(\`Listening on http://localhost:\${port}\`);
 				map: r.map
 			};
 		}
-	}, Y = [];
-	for (let e of f) e.plugins && Y.push(...e.plugins());
+	}, Q = [];
+	for (let e of f) e.plugins && Q.push(...e.plugins());
 	return [
-		J,
-		...Y,
-		K
+		Z,
+		...Q,
+		Y
 	];
 }
 //#endregion
-export { M as atollic };
+export { F as atollic };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "atollic",
-	"version": "0.0.2",
+	"version": "0.0.4",
 	"description": "Island architecture for WinterCG-compatible runtimes. Bring-your-own server (Elysia, Hono, …) and UI framework, powered by Vite.",
 	"keywords": [
 		"wintercg",
@@ -23,15 +23,20 @@
 	"homepage": "https://github.com/awilderink/atollic#readme",
 	"type": "module",
 	"scripts": {
-		"dev:elysia": "bunx --bun vite --config examples/elysia/vite.config.ts",
-		"dev:hono": "bunx --bun vite --config examples/hono/vite.config.ts",
+		"dev:elysia": "cd examples/elysia && bunx --bun vite",
+		"dev:hono": "cd examples/hono && bunx --bun vite",
 		"build": "vite build && tsc",
+		"build:examples": "cd examples/elysia && bunx --bun vite build && cd ../hono && bunx --bun vite build",
 		"prepare": "npm run build",
 		"prepublishOnly": "npm run build",
 		"typecheck": "tsc --noEmit && tsc --noEmit --project examples/elysia/tsconfig.json && tsc --noEmit --project examples/hono/tsconfig.json",
 		"format": "biome format --write .",
 		"lint": "biome lint .",
-		"check": "biome check --write ."
+		"check": "biome check --write .",
+		"test": "bun test",
+		"changeset": "changeset",
+		"version": "changeset version",
+		"release": "changeset publish"
 	},
 	"exports": {
 		".": {
@@ -115,6 +120,8 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "^2.4.7",
+		"@changesets/changelog-github": "^0.5.0",
+		"@changesets/cli": "^2.27.10",
 		"@types/node": "^25.5.0",
 		"bun-types": "^1.3.11",
 		"elysia": "^1.4.28",

package/dist/shared-CfRCLggd.js

@@ -1,23 +0,0 @@
-//#region src/shared.ts
-var e = /<meta\s+name="atollic-head"\s*\/?>/;
-function t(t, n) {
-	let r = t.replace(e, n);
-	return r === t ? t.includes("</head>") ? t.replace("</head>", `  ${n}\n</head>`) : t : r;
-}
-function n(e) {
-	return e && typeof e == "object" && "t" in e && typeof e.t == "string" ? e.t : Array.isArray(e) ? e.flat(Infinity).map((e) => typeof e == "string" ? e : e && typeof e == "object" && "t" in e ? e.t : "").join("") || null : typeof e == "string" ? e : null;
-}
-function r(e) {
-	let t = e.trimStart();
-	return t.startsWith("<html") && !t.startsWith("<!DOCTYPE") ? `<!DOCTYPE html>\n${e}` : e;
-}
-function i(e) {
-	let t = e.trimStart();
-	return t.startsWith("<!DOCTYPE") || t.startsWith("<html");
-}
-function a(e, n) {
-	let i = r(e);
-	return n && (i = t(i, n)), i;
-}
-//#endregion
-export { a, i, n, t as r, r as t };