bosia 0.4.0 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bosia",
-	"version": "0.4.0",
+	"version": "0.4.2",
 	"type": "module",
 	"description": "A fast, batteries-included fullstack framework — SSR · Svelte 5 Runes · Bun · ElysiaJS. File-based routing inspired by SvelteKit. No Node.js, no Vite, no adapters.",
 	"keywords": [
@@ -33,13 +33,15 @@
 	"exports": {
 		".": "./src/lib/index.ts",
 		"./client": "./src/lib/client.ts",
-		"./plugins/server-timing": "./src/core/plugins/server-timing.ts"
+		"./plugins/server-timing": "./src/core/plugins/server-timing.ts",
+		"./plugins/inspector": "./src/core/plugins/inspector/index.ts"
 	},
 	"bin": {
 		"bosia": "src/cli/index.ts"
 	},
 	"scripts": {
 		"check": "tsc --noEmit && prettier --check .",
+		"check:templates": "bun scripts/check-templates.ts",
 		"test": "bun test",
 		"test:watch": "bun test --watch"
 	},
@@ -52,6 +54,7 @@
 		"@tailwindcss/cli": "^4.2.1",
 		"bun-plugin-svelte": "^0.0.6",
 		"elysia": "^1.4.26",
+		"magic-string": "^0.30.0",
 		"svelte": "^5.53.6",
 		"tailwind-merge": "^3.5.0",
 		"tailwindcss": "^4.2.1"

package/src/cli/create.ts

@@ -148,7 +148,10 @@ function copyDir(src: string, dest: string, projectName: string, isLocal: boolea
 	mkdirSync(dest, { recursive: true });
 	for (const entry of readdirSync(src, { withFileTypes: true })) {
 		const srcPath = join(src, entry.name);
-		const destPath = join(dest, entry.name);
+		// npm pack strips `.gitignore` from published packages, so templates ship
+		// it as `_gitignore` and we restore the dotfile name on copy.
+		const destName = entry.name === "_gitignore" ? ".gitignore" : entry.name;
+		const destPath = join(dest, destName);
 
 		// Do not copy instructions.txt or template.json to the final project
 		if (entry.name === "instructions.txt" || entry.name === "template.json") continue;

package/src/core/config.ts

@@ -72,7 +72,8 @@ export async function loadBosiaConfig(cwd: string = process.cwd()): Promise<Bosi
 		);
 	}
 
-	const plugins = Array.isArray(config.plugins) ? config.plugins : [];
+	const rawPlugins = Array.isArray(config.plugins) ? config.plugins : [];
+	const plugins = rawPlugins.filter((p): p is BosiaPlugin => Boolean(p));
 	const normalized: BosiaConfig = { plugins };
 
 	cached = normalized;
@@ -89,5 +90,5 @@ export function resetConfigCache(): void {
 /** Convenience: load and return only the plugin list. */
 export async function loadPlugins(cwd?: string): Promise<BosiaPlugin[]> {
 	const config = await loadBosiaConfig(cwd);
-	return config.plugins ?? [];
+	return (config.plugins ?? []).filter((p): p is BosiaPlugin => Boolean(p));
 }

package/src/core/plugins/inspector/bun-plugin.ts

@@ -0,0 +1,146 @@
+import { parse, compile } from "svelte/compiler";
+import MagicString from "magic-string";
+import { basename, relative } from "node:path";
+import type { BunPlugin } from "bun";
+
+const VIRTUAL_NS = "bosia-inspector-css";
+
+type AnyNode = {
+	type?: string;
+	name?: string;
+	start?: number;
+	end?: number;
+	[k: string]: unknown;
+};
+
+// Child-bearing keys across Svelte 5 modern AST nodes. Order doesn't matter.
+const CHILD_KEYS = [
+	"nodes", // Fragment
+	"fragment", // RegularElement, KeyBlock, SvelteElement, SvelteComponent
+	"consequent", // IfBlock (Fragment)
+	"alternate", // IfBlock (Fragment | null)
+	"body", // EachBlock, SnippetBlock (Fragment)
+	"fallback", // EachBlock (Fragment | null)
+	"pending", // AwaitBlock (Fragment | null)
+	"then", // AwaitBlock (Fragment | null)
+	"catch", // AwaitBlock (Fragment | null)
+];
+
+function walk(node: unknown, visit: (n: AnyNode) => void) {
+	if (!node) return;
+	if (Array.isArray(node)) {
+		for (const c of node) walk(c, visit);
+		return;
+	}
+	if (typeof node !== "object") return;
+	const n = node as AnyNode;
+	if (typeof n.type === "string") visit(n);
+	for (const key of CHILD_KEYS) {
+		const child = n[key];
+		if (child) walk(child, visit);
+	}
+}
+
+function lineColFromOffset(source: string, offset: number): { line: number; col: number } {
+	let line = 1;
+	let col = 1;
+	for (let i = 0; i < offset && i < source.length; i++) {
+		if (source[i] === "\n") {
+			line++;
+			col = 1;
+		} else {
+			col++;
+		}
+	}
+	return { line, col };
+}
+
+function injectLocs(source: string, relPath: string): string {
+	let ast: { fragment?: AnyNode };
+	try {
+		ast = parse(source, { modern: true }) as unknown as { fragment?: AnyNode };
+	} catch {
+		return source;
+	}
+	if (!ast.fragment) return source;
+
+	const ms = new MagicString(source);
+	walk(ast.fragment, (node) => {
+		if (node.type !== "RegularElement") return;
+		const name = node.name ?? "";
+		if (!name) return;
+		if (name === "script" || name === "style") return;
+		if (/^[A-Z]/.test(name)) return;
+		if (name.includes(":")) return;
+		if (typeof node.start !== "number") return;
+		const insertAt = node.start + 1 + name.length;
+		const { line, col } = lineColFromOffset(source, node.start);
+		const safe = relPath.replace(/"/g, "&quot;");
+		ms.appendLeft(insertAt, ` data-bosia-loc="${safe}:${line}:${col}"`);
+	});
+	return ms.toString();
+}
+
+export interface InspectorBunPluginOptions {
+	cwd: string;
+	target: "browser" | "bun";
+	dev: boolean;
+}
+
+const fnv = (s: string): string => {
+	let h = 2166136261;
+	for (let i = 0; i < s.length; i++) {
+		h ^= s.charCodeAt(i);
+		h = Math.imul(h, 16777619);
+	}
+	return (h >>> 0).toString(36);
+};
+
+export function createInspectorBunPlugin(opts: InspectorBunPluginOptions): BunPlugin {
+	const { cwd, target, dev } = opts;
+	const generate: "client" | "server" = target === "browser" ? "client" : "server";
+	const virtualCss = new Map<string, string>();
+
+	return {
+		name: "bosia-inspector",
+		setup(build) {
+			build.onLoad({ filter: /\.svelte$/ }, async (args) => {
+				const source = await Bun.file(args.path).text();
+				const rel = relative(cwd, args.path);
+				const transformed = injectLocs(source, rel);
+
+				const result = compile(transformed, {
+					filename: args.path,
+					generate,
+					dev,
+					hmr: dev,
+					css: "external",
+					preserveWhitespace: dev,
+					preserveComments: dev,
+					cssHash: ({ css }) => `svelte-${fnv(css)}`,
+				});
+
+				let js = result.js.code;
+				if (result.css?.code && generate !== "server") {
+					const uid = `${basename(args.path)}-${fnv(args.path)}-style.css`;
+					const virtualName = `${VIRTUAL_NS}:${uid}`;
+					virtualCss.set(virtualName, result.css.code);
+					js += `\nimport ${JSON.stringify(virtualName)};`;
+				}
+
+				return { contents: js, loader: "ts" };
+			});
+
+			build.onResolve({ filter: new RegExp(`^${VIRTUAL_NS}:`) }, (args) => ({
+				path: args.path,
+				namespace: VIRTUAL_NS,
+			}));
+
+			build.onLoad({ filter: /.*/, namespace: VIRTUAL_NS }, (args) => {
+				const css = virtualCss.get(args.path) ?? "";
+				virtualCss.delete(args.path);
+				return { contents: css, loader: "css" };
+			});
+		},
+	};
+}

package/src/core/plugins/inspector/index.ts

@@ -0,0 +1,122 @@
+import { spawn } from "node:child_process";
+import { createInspectorBunPlugin } from "./bun-plugin.ts";
+import { getOverlayScript } from "./overlay.ts";
+import type { BosiaPlugin } from "../../types/plugin.ts";
+
+export interface InspectorOptions {
+	/** Editor CLI command. Defaults to `code`. */
+	editor?: "code" | "cursor" | "zed" | (string & {});
+	/** When set, alt+click opens a comment form whose contents POST here. */
+	aiEndpoint?: string;
+	/** Endpoint path the overlay POSTs to. Defaults to `/__bosia/locate`. */
+	endpoint?: string;
+}
+
+function buildEditorArgs(editor: string, file: string, line: number, col: number): string[] {
+	if (editor === "zed") return [`${file}:${line}:${col}`];
+	return ["-g", `${file}:${line}:${col}`];
+}
+
+/**
+ * Inspector plugin — alt+click an element in the running dev page to jump
+ * to its source in your editor, or open a comment form that hands off to an
+ * AI agent. Dev-only: production builds inject nothing and mount no endpoint.
+ */
+export function inspector(options: InspectorOptions = {}): BosiaPlugin | false {
+	if (process.env.NODE_ENV === "production") return false;
+	const editor = options.editor ?? "code";
+	const endpoint = options.endpoint ?? "/__bosia/locate";
+	const aiEndpoint = options.aiEndpoint;
+
+	return {
+		name: "inspector",
+
+		build: {
+			bunPlugins: (target) => [
+				createInspectorBunPlugin({ cwd: process.cwd(), target, dev: true }),
+			],
+		},
+
+		backend: {
+			before(app) {
+				return app.post(endpoint, async ({ body }: { body: unknown }) => {
+					const data = (body ?? {}) as {
+						file?: string;
+						line?: number;
+						col?: number;
+						comment?: string;
+					};
+					const file = typeof data.file === "string" ? data.file : null;
+					const line = Number.isFinite(data.line) ? Number(data.line) : null;
+					const col = Number.isFinite(data.col) ? Number(data.col) : 1;
+					if (!file || line === null) {
+						return new Response(
+							JSON.stringify({ ok: false, error: "missing file/line" }),
+							{
+								status: 400,
+								headers: { "content-type": "application/json" },
+							},
+						);
+					}
+
+					const comment = typeof data.comment === "string" ? data.comment.trim() : "";
+					if (comment && aiEndpoint) {
+						try {
+							let origin: string;
+							try {
+								origin = new URL(aiEndpoint).origin;
+							} catch {
+								origin = "http://localhost";
+							}
+							await fetch(aiEndpoint, {
+								method: "POST",
+								headers: {
+									"content-type": "application/json",
+									origin,
+								},
+								body: JSON.stringify({ file, line, col, comment }),
+							});
+							return { ok: true, mode: "ai" as const };
+						} catch (err) {
+							console.error("[inspector] aiEndpoint POST failed:", err);
+							return new Response(
+								JSON.stringify({ ok: false, error: "ai endpoint failed" }),
+								{
+									status: 502,
+									headers: { "content-type": "application/json" },
+								},
+							);
+						}
+					}
+
+					try {
+						const proc = spawn(editor, buildEditorArgs(editor, file, line, col), {
+							detached: true,
+							stdio: "ignore",
+						});
+						proc.unref();
+						proc.on("error", (err) => {
+							console.error(`[inspector] failed to launch "${editor}":`, err);
+						});
+					} catch (err) {
+						console.error(`[inspector] failed to launch "${editor}":`, err);
+						return new Response(
+							JSON.stringify({ ok: false, error: "editor launch failed" }),
+							{
+								status: 500,
+								headers: { "content-type": "application/json" },
+							},
+						);
+					}
+					return { ok: true, mode: "editor" as const };
+				});
+			},
+		},
+
+		render: {
+			bodyEnd: () => getOverlayScript({ aiEndpoint, endpoint }),
+		},
+	};
+}
+
+export default inspector;

package/src/core/plugins/inspector/overlay.ts

@@ -0,0 +1,116 @@
+import { safeJsonStringify } from "../../html.ts";
+
+export interface OverlayConfig {
+	aiEndpoint?: string;
+	endpoint: string;
+}
+
+export function getOverlayScript(config: OverlayConfig): string {
+	const cfg = safeJsonStringify(config);
+	return (
+		`<script>window.__BOSIA_INSPECTOR__=${cfg};</script>\n` + `<script>${OVERLAY_IIFE}</script>`
+	);
+}
+
+const OVERLAY_IIFE = `(function(){
+var CFG=window.__BOSIA_INSPECTOR__||{};
+var EP=CFG.endpoint||"/__bosia/locate";
+var AI=CFG.aiEndpoint||null;
+var altDown=false,outline=null,tip=null,form=null;
+
+function ensureOutline(){
+  if(outline)return;
+  outline=document.createElement("div");
+  outline.style.cssText="position:fixed;pointer-events:none;border:2px solid #f73b27;background:rgba(247,59,39,.08);z-index:2147483646;border-radius:2px;transition:all .05s linear;display:none";
+  document.body.appendChild(outline);
+  tip=document.createElement("div");
+  tip.style.cssText="position:fixed;pointer-events:none;background:#111;color:#fff;font:11px/1.4 ui-monospace,monospace;padding:3px 6px;border-radius:3px;z-index:2147483647;display:none;white-space:nowrap";
+  document.body.appendChild(tip);
+}
+function hideOutline(){if(outline)outline.style.display="none";if(tip)tip.style.display="none"}
+function showOutline(el,loc){
+  ensureOutline();
+  var r=el.getBoundingClientRect();
+  outline.style.display="block";
+  outline.style.left=r.left+"px";outline.style.top=r.top+"px";
+  outline.style.width=r.width+"px";outline.style.height=r.height+"px";
+  tip.style.display="block";tip.textContent=loc;
+  var ty=r.top-22;if(ty<0)ty=r.bottom+4;
+  tip.style.left=r.left+"px";tip.style.top=ty+"px";
+}
+function parseLoc(s){var m=/^(.+):(\\d+):(\\d+)$/.exec(s);if(!m)return null;return{file:m[1],line:+m[2],col:+m[3]}}
+function findTarget(e){var n=e.target;while(n&&n.nodeType===1){if(n.hasAttribute&&n.hasAttribute("data-bosia-loc"))return n;n=n.parentNode}return null}
+
+function toast(msg,err){
+  var t=document.createElement("div");
+  t.textContent=msg;
+  t.style.cssText="position:fixed;bottom:20px;left:50%;transform:translateX(-50%);background:"+(err?"#dc2626":"#111")+";color:#fff;padding:8px 14px;border-radius:6px;font:13px ui-sans-serif,system-ui,sans-serif;z-index:2147483647;box-shadow:0 4px 12px rgba(0,0,0,.2);opacity:0;transition:opacity .15s";
+  document.body.appendChild(t);
+  requestAnimationFrame(function(){t.style.opacity="1"});
+  setTimeout(function(){t.style.opacity="0";setTimeout(function(){t.remove()},200)},2200);
+}
+
+function send(payload,onOk){
+  fetch(EP,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify(payload)})
+    .then(function(r){return r.json().catch(function(){return{}})})
+    .then(function(j){if(j&&j.ok){onOk&&onOk(j)}else{toast("Inspector: request failed",true)}})
+    .catch(function(){toast("Inspector: network error",true)});
+}
+
+function closeForm(){if(form){form.remove();form=null}}
+function openForm(loc,el){
+  closeForm();
+  var r=el.getBoundingClientRect();
+  form=document.createElement("div");
+  form.style.cssText="position:fixed;left:"+r.left+"px;top:"+(r.bottom+6)+"px;background:#fff;color:#111;border:1px solid #d4d4d8;border-radius:8px;box-shadow:0 8px 24px rgba(0,0,0,.18);padding:10px;width:340px;z-index:2147483647;font:13px ui-sans-serif,system-ui,sans-serif";
+  form.innerHTML='<div style="font-size:11px;color:#71717a;margin-bottom:6px;font-family:ui-monospace,monospace">'+loc.file+":"+loc.line+'</div>'+
+    '<textarea placeholder="Describe a fix (Enter to send, Esc to cancel, empty = open in editor)" style="width:100%;min-height:64px;border:1px solid #e4e4e7;border-radius:4px;padding:6px;font:13px ui-sans-serif,system-ui,sans-serif;resize:vertical;box-sizing:border-box;outline:none"></textarea>'+
+    '<div style="margin-top:8px;display:flex;gap:6px;justify-content:flex-end">'+
+    '<button data-cancel style="padding:4px 10px;border:1px solid #e4e4e7;background:#fff;border-radius:4px;cursor:pointer;font-size:12px">Cancel</button>'+
+    '<button data-send style="padding:4px 10px;border:0;background:#111;color:#fff;border-radius:4px;cursor:pointer;font-size:12px">Send</button>'+
+    '</div>';
+  document.body.appendChild(form);
+  var ta=form.querySelector("textarea");
+  ta.focus();
+  function submit(){
+    var comment=ta.value.trim();
+    var payload={file:loc.file,line:loc.line,col:loc.col};
+    if(comment)payload.comment=comment;
+    send(payload,function(j){toast(j.mode==="ai"?"sent to AI":"opened "+loc.file+":"+loc.line)});
+    closeForm();
+  }
+  form.querySelector("[data-send]").addEventListener("click",submit);
+  form.querySelector("[data-cancel]").addEventListener("click",closeForm);
+  ta.addEventListener("keydown",function(e){
+    if(e.key==="Escape"){e.preventDefault();closeForm()}
+    else if(e.key==="Enter"&&!e.shiftKey){e.preventDefault();submit()}
+  });
+}
+
+window.addEventListener("keydown",function(e){
+  if(e.key==="Alt"||e.altKey)altDown=true;
+  if(e.key==="Escape")closeForm();
+},true);
+window.addEventListener("keyup",function(e){if(e.key==="Alt"){altDown=false;hideOutline()}},true);
+window.addEventListener("blur",function(){altDown=false;hideOutline()});
+
+window.addEventListener("mousemove",function(e){
+  if(!altDown||form){hideOutline();return}
+  var el=findTarget(e);
+  if(!el){hideOutline();return}
+  showOutline(el,el.getAttribute("data-bosia-loc"));
+},true);
+
+window.addEventListener("click",function(e){
+  if(!altDown)return;
+  if(form&&form.contains(e.target))return;
+  var el=findTarget(e);
+  if(!el)return;
+  e.preventDefault();e.stopPropagation();
+  var loc=parseLoc(el.getAttribute("data-bosia-loc"));
+  if(!loc)return;
+  hideOutline();
+  if(AI)openForm(loc,el);
+  else send(loc,function(){toast("opened "+loc.file+":"+loc.line)});
+},true);
+})();`;

package/src/core/types/plugin.ts

@@ -72,7 +72,7 @@ export interface BosiaPlugin {
 }
 
 export interface BosiaConfig {
-	plugins?: BosiaPlugin[];
+	plugins?: (BosiaPlugin | false | null | undefined)[];
 }
 
 /** Identity helper for type inference in `bosia.config.ts`. */

package/templates/default/.prettierignore

@@ -3,3 +3,4 @@ dist
 build
 .bosia
 bun.lock
+public/bosia-tw.css

package/templates/default/_gitignore

@@ -0,0 +1,12 @@
+node_modules/
+dist/
+.bosia/
+.DS_Store
+*.log
+
+# Generated Tailwind output
+public/bosia-tw.css
+
+# Local env overrides — never commit secrets
+.env*.local
+.env

package/templates/demo/.prettierignore

@@ -3,3 +3,4 @@ dist
 build
 .bosia
 bun.lock
+public/bosia-tw.css

package/templates/demo/_gitignore

@@ -0,0 +1,12 @@
+node_modules/
+dist/
+.bosia/
+.DS_Store
+*.log
+
+# Generated Tailwind output
+public/bosia-tw.css
+
+# Local env overrides — never commit secrets
+.env*.local
+.env

package/templates/todo/.prettierignore

@@ -3,3 +3,4 @@ dist
 build
 .bosia
 bun.lock
+public/bosia-tw.css

package/templates/todo/_gitignore

@@ -0,0 +1,12 @@
+node_modules/
+dist/
+.bosia/
+.DS_Store
+*.log
+
+# Generated Tailwind output
+public/bosia-tw.css
+
+# Local env overrides — never commit secrets
+.env*.local
+.env