bosia 0.2.2 → 0.3.0

package/README.md

@@ -34,32 +34,32 @@ bun run start
 
 ## Tech Stack
 
-| Layer | Technology |
-|-------|------------|
-| Runtime | [Bun](https://bun.sh) |
-| HTTP Server | [ElysiaJS](https://elysiajs.com) |
-| UI | [Svelte 5](https://svelte.dev) (Runes) |
-| CSS | [Tailwind CSS v4](https://tailwindcss.com) |
-| Bundler | Bun.build |
+| Layer       | Technology                                 |
+| ----------- | ------------------------------------------ |
+| Runtime     | [Bun](https://bun.sh)                      |
+| HTTP Server | [ElysiaJS](https://elysiajs.com)           |
+| UI          | [Svelte 5](https://svelte.dev) (Runes)     |
+| CSS         | [Tailwind CSS v4](https://tailwindcss.com) |
+| Bundler     | Bun.build                                  |
 
 ## Routing Conventions
 
 Files in `src/routes/` map to URLs automatically.
 
-| File | Purpose |
-|------|---------|
-| `+page.svelte` | Page component |
-| `+layout.svelte` | Layout that wraps child pages |
-| `+page.server.ts` | Server loader for a page |
-| `+layout.server.ts` | Server loader for a layout |
-| `+server.ts` | API endpoint (export HTTP verbs) |
+| File                | Purpose                          |
+| ------------------- | -------------------------------- |
+| `+page.svelte`      | Page component                   |
+| `+layout.svelte`    | Layout that wraps child pages    |
+| `+page.server.ts`   | Server loader for a page         |
+| `+layout.server.ts` | Server loader for a layout       |
+| `+server.ts`        | API endpoint (export HTTP verbs) |
 
 ### Dynamic Routes
 
-| Pattern | Matches |
-|---------|---------|
-| `[param]` | `/blog/hello` → `params.param = "hello"` |
-| `[...rest]` | `/a/b/c` → `params.rest = "a/b/c"` |
+| Pattern     | Matches                                  |
+| ----------- | ---------------------------------------- |
+| `[param]`   | `/blog/hello` → `params.param = "hello"` |
+| `[...rest]` | `/a/b/c` → `params.rest = "a/b/c"`       |
 
 ### Route Groups
 
@@ -81,10 +81,10 @@ src/routes/
 import type { LoadEvent } from "bosia";
 
 export async function load({ params, url, locals, fetch, parent }: LoadEvent) {
-    const parentData = await parent(); // data from layout loaders above
-    return {
-        post: await getPost(params.slug),
-    };
+	const parentData = await parent(); // data from layout loaders above
+	return {
+		post: await getPost(params.slug),
+	};
 }
 ```
 
@@ -92,8 +92,8 @@ Data returned is passed as the `data` prop to `+page.svelte`:
 
 ```svelte
 <script lang="ts">
-    let { data } = $props();
-    // data.post, data.params ...
+	let { data } = $props();
+	// data.post, data.params ...
 </script>
 ```
 
@@ -106,12 +106,12 @@ Export named HTTP verb functions from `+server.ts`:
 import type { RequestEvent } from "bosia";
 
 export function GET({ params, url, locals }: RequestEvent) {
-    return Response.json({ items: [] });
+	return Response.json({ items: [] });
 }
 
 export async function POST({ request }: RequestEvent) {
-    const body = await request.json();
-    return Response.json({ created: body }, { status: 201 });
+	const body = await request.json();
+	return Response.json({ created: body }, { status: 201 });
 }
 ```
 
@@ -124,14 +124,14 @@ import { sequence } from "bosia";
 import type { Handle } from "bosia";
 
 const authHandle: Handle = async ({ event, resolve }) => {
-    event.locals.user = await getUser(event.request);
-    return resolve(event);
+	event.locals.user = await getUser(event.request);
+	return resolve(event);
 };
 
 const loggingHandle: Handle = async ({ event, resolve }) => {
-    const res = await resolve(event);
-    console.log(`${event.request.method} ${event.url.pathname} ${res.status}`);
-    return res;
+	const res = await resolve(event);
+	console.log(`${event.request.method} ${event.url.pathname} ${res.status}`);
+	return res;
 };
 
 export const handle = sequence(authHandle, loggingHandle);
@@ -146,13 +146,13 @@ import { cn, sequence } from "bosia";
 import type { RequestEvent, LoadEvent, Handle } from "bosia";
 ```
 
-| Export | Description |
-|--------|-------------|
-| `cn(...classes)` | Tailwind class merge utility (built-in class merging + tailwind-merge) |
-| `sequence(...handlers)` | Compose multiple `Handle` middleware functions |
-| `RequestEvent` | Type for API route and hook handlers |
-| `LoadEvent` | Type for `load()` in `+page.server.ts` / `+layout.server.ts` |
-| `Handle` | Type for a middleware function in `hooks.server.ts` |
+| Export                  | Description                                                            |
+| ----------------------- | ---------------------------------------------------------------------- |
+| `cn(...classes)`        | Tailwind class merge utility (built-in class merging + tailwind-merge) |
+| `sequence(...handlers)` | Compose multiple `Handle` middleware functions                         |
+| `RequestEvent`          | Type for API route and hook handlers                                   |
+| `LoadEvent`             | Type for `load()` in `+page.server.ts` / `+layout.server.ts`           |
+| `Handle`                | Type for a middleware function in `hooks.server.ts`                    |
 
 ## Path Alias
 

package/package.json

@@ -1,55 +1,58 @@
 {
-  "name": "bosia",
-  "version": "0.2.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": [
-    "bun",
-    "svelte",
-    "ssr",
-    "elysia",
-    "fullstack",
-    "framework"
-  ],
-  "license": "MIT",
-  "author": {
-    "name": "Jekibus",
-    "url": "https://github.com/jekibus"
-  },
-  "homepage": "https://github.com/bosapi/bosia#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/bosapi/bosia.git"
-  },
-  "bugs": {
-    "url": "https://github.com/bosapi/bosia/issues"
-  },
-  "files": [
-    "src",
-    "templates",
-    "README.md",
-    "package.json"
-  ],
-  "exports": {
-    ".": "./src/lib/index.ts"
-  },
-  "bin": {
-    "bosia": "src/cli/index.ts"
-  },
-  "scripts": {
-    "check": "tsc --noEmit"
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5"
-  },
-  "dependencies": {
-    "@clack/prompts": "^1.1.0",
-    "@tailwindcss/cli": "^4.2.1",
-    "bun-plugin-svelte": "^0.0.6",
-    "elysia": "^1.4.26",
-    "svelte": "^5.53.6",
-    "tailwind-merge": "^3.5.0",
-    "tailwindcss": "^4.2.1"
-  }
+	"name": "bosia",
+	"version": "0.3.0",
+	"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": [
+		"bun",
+		"svelte",
+		"ssr",
+		"elysia",
+		"fullstack",
+		"framework"
+	],
+	"license": "MIT",
+	"author": {
+		"name": "Jekibus",
+		"url": "https://github.com/jekibus"
+	},
+	"homepage": "https://github.com/bosapi/bosia#readme",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/bosapi/bosia.git"
+	},
+	"bugs": {
+		"url": "https://github.com/bosapi/bosia/issues"
+	},
+	"files": [
+		"src",
+		"templates",
+		"README.md",
+		"package.json"
+	],
+	"exports": {
+		".": "./src/lib/index.ts",
+		"./client": "./src/lib/client.ts"
+	},
+	"bin": {
+		"bosia": "src/cli/index.ts"
+	},
+	"scripts": {
+		"check": "tsc --noEmit && prettier --check .",
+		"test": "bun test",
+		"test:watch": "bun test --watch"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"typescript": "^5"
+	},
+	"dependencies": {
+		"@clack/prompts": "^1.1.0",
+		"@tailwindcss/cli": "^4.2.1",
+		"bun-plugin-svelte": "^0.0.6",
+		"elysia": "^1.4.26",
+		"svelte": "^5.53.6",
+		"tailwind-merge": "^3.5.0",
+		"tailwindcss": "^4.2.1"
+	}
 }

package/src/ambient.d.ts

@@ -0,0 +1,31 @@
+// Virtual modules resolved by the bundler plugin (src/core/plugin.ts).
+// Backed by .bosia/routes.ts and .bosia/routes.client.ts at build time.
+
+declare module "bosia:routes" {
+	type Loader = () => Promise<any>;
+	type TrailingSlash = "never" | "always" | "ignore";
+
+	export const clientRoutes: Array<{
+		pattern: string;
+		page: Loader;
+		layouts: Loader[];
+		hasServerData: boolean;
+		trailingSlash: TrailingSlash;
+	}>;
+
+	export const serverRoutes: Array<{
+		pattern: string;
+		pageModule: Loader;
+		layoutModules: Loader[];
+		pageServer: Loader | null;
+		layoutServers: { loader: Loader; depth: number }[];
+		trailingSlash: TrailingSlash;
+	}>;
+
+	export const apiRoutes: Array<{
+		pattern: string;
+		module: Loader;
+	}>;
+
+	export const errorPage: Loader | null;
+}

package/src/cli/add.ts

@@ -2,13 +2,13 @@ import { join, dirname } from "path";
 import { mkdirSync, writeFileSync, readFileSync, existsSync } from "fs";
 import * as p from "@clack/prompts";
 import {
-    type InstallOptions,
-    REGISTRY_URL,
-    resolveLocalRegistryOrExit,
-    readRegistryJSON,
-    readRegistryFile,
-    mergePkgJson,
-    bunAdd,
+	type InstallOptions,
+	REGISTRY_URL,
+	resolveLocalRegistryOrExit,
+	readRegistryJSON,
+	readRegistryFile,
+	mergePkgJson,
+	bunAdd,
 } from "./registry.ts";
 
 // ─── bosia add <component> ────────────────────────────────
@@ -20,16 +20,16 @@ import {
 //   bosia add shop/cart    → src/lib/components/shop/cart/
 
 interface ComponentMeta {
-    name: string;
-    description: string;
-    dependencies: string[];   // other bosia components required
-    files: string[];
-    npmDeps: Record<string, string>;
+	name: string;
+	description: string;
+	dependencies: string[]; // other bosia components required
+	files: string[];
+	npmDeps: Record<string, string>;
 }
 
 interface RegistryIndex {
-    components: string[];
-    features: string[];
+	components: string[];
+	features: string[];
 }
 
 // Track already-installed components within a session to avoid re-running deps
@@ -41,26 +41,28 @@ let registryIndex: RegistryIndex | null = null;
 
 /** Initialize registry context so addComponent can be called externally (e.g. from feat.ts) */
 export async function initAddRegistry(root: string | null) {
-    registryRoot = root;
-    registryIndex = await loadIndex();
+	registryRoot = root;
+	registryIndex = await loadIndex();
 }
 
 export async function runAdd(name: string | undefined, flags: string[] = []) {
-    if (!name) {
-        console.error("❌ Please provide a component name.\n   Usage: bosia add <component> [--local]");
-        process.exit(1);
-    }
-
-    if (flags.includes("--local")) {
-        registryRoot = resolveLocalRegistryOrExit();
-        console.log(`⬡ Using local registry: ${registryRoot}\n`);
-    }
-
-    // Load index once to resolve component paths
-    registryIndex = await loadIndex();
-
-    ensureUtils();
-    await addComponent(name, true);
+	if (!name) {
+		console.error(
+			"❌ Please provide a component name.\n   Usage: bosia add <component> [--local]",
+		);
+		process.exit(1);
+	}
+
+	if (flags.includes("--local")) {
+		registryRoot = resolveLocalRegistryOrExit();
+		console.log(`⬡ Using local registry: ${registryRoot}\n`);
+	}
+
+	// Load index once to resolve component paths
+	registryIndex = await loadIndex();
+
+	ensureUtils();
+	await addComponent(name, true);
 }
 
 /**
@@ -70,89 +72,93 @@ export async function runAdd(name: string | undefined, flags: string[] = []) {
  * - "shop/cart"  → "shop/cart"     (explicit path used as-is)
  */
 function resolveDestPath(name: string): string {
-    if (name.includes("/")) return name;
-
-    if (registryIndex) {
-        // Exact match (e.g. "todo" → "todo")
-        if (registryIndex.components.includes(name)) return name;
-        // Suffix match (e.g. "button" → "ui/button")
-        const match = registryIndex.components.find(
-            (c) => c.endsWith(`/${name}`)
-        );
-        if (match) return match;
-    }
-
-    // Fallback for backwards compatibility
-    return `ui/${name}`;
+	if (name.includes("/")) return name;
+
+	if (registryIndex) {
+		// Exact match (e.g. "todo" → "todo")
+		if (registryIndex.components.includes(name)) return name;
+		// Suffix match (e.g. "button" → "ui/button")
+		const match = registryIndex.components.find((c) => c.endsWith(`/${name}`));
+		if (match) return match;
+	}
+
+	// Fallback for backwards compatibility
+	return `ui/${name}`;
 }
 
 async function loadIndex(): Promise<RegistryIndex | null> {
-    try {
-        if (registryRoot) {
-            const path = join(registryRoot, "index.json");
-            if (existsSync(path)) return JSON.parse(readFileSync(path, "utf-8"));
-            return null;
-        }
-        const res = await fetch(`${REGISTRY_URL}/index.json`);
-        if (!res.ok) return null;
-        return await res.json() as RegistryIndex;
-    } catch {
-        return null;
-    }
+	try {
+		if (registryRoot) {
+			const path = join(registryRoot, "index.json");
+			if (existsSync(path)) return JSON.parse(readFileSync(path, "utf-8"));
+			return null;
+		}
+		const res = await fetch(`${REGISTRY_URL}/index.json`);
+		if (!res.ok) return null;
+		return (await res.json()) as RegistryIndex;
+	} catch {
+		return null;
+	}
 }
 
 export async function addComponent(name: string, root = false, options?: InstallOptions) {
-    // Resolve the full path (e.g. "button" → "ui/button", "shop/cart" stays "shop/cart")
-    const fullPath = resolveDestPath(name);
-
-    if (installed.has(fullPath)) return;
-    installed.add(fullPath);
-
-    const cwd = options?.cwd ?? process.cwd();
-
-    console.log(root ? `⬡ Installing component: ${name}\n` : `   📦 Dependency: ${name}`);
-
-    const meta = await readRegistryJSON<ComponentMeta>(registryRoot, "components", fullPath, "meta.json");
-
-    // Install component dependencies first (recursive)
-    for (const dep of meta.dependencies) {
-        await addComponent(dep, false, options);
-    }
-
-    // Check if component already exists (skip check entirely in non-interactive mode)
-    const destDir = join(cwd, "src", "lib", "components", fullPath);
-    if (!options?.skipPrompts && existsSync(destDir)) {
-        const replace = await p.confirm({
-            message: `Component "${name}" already exists at src/lib/components/${fullPath}/. Replace it?`,
-        });
-        if (p.isCancel(replace) || !replace) {
-            console.log(`   ⏭️  Skipped ${name}`);
-            return;
-        }
-    }
-
-    // Download/copy component files into src/lib/components/<fullPath>/
-    mkdirSync(destDir, { recursive: true });
-
-    for (const file of meta.files) {
-        const content = await readRegistryFile(registryRoot, "components", fullPath, file);
-        const dest = join(destDir, file);
-        if (file.includes("/")) mkdirSync(dirname(dest), { recursive: true });
-        writeFileSync(dest, content, "utf-8");
-        console.log(`   ✍️  src/lib/components/${fullPath}/${file}`);
-    }
-
-    // Install npm dependencies
-    if (Object.keys(meta.npmDeps).length > 0) {
-        if (options?.skipInstall) {
-            const { addedDeps } = mergePkgJson(cwd, { deps: meta.npmDeps });
-            if (addedDeps.length > 0) console.log(`   📥 Added to package.json: ${addedDeps.join(", ")}`);
-        } else {
-            await bunAdd(cwd, meta.npmDeps);
-        }
-    }
-
-    if (root) console.log(`\n✅ ${name} installed at src/lib/components/${fullPath}/`);
+	// Resolve the full path (e.g. "button" → "ui/button", "shop/cart" stays "shop/cart")
+	const fullPath = resolveDestPath(name);
+
+	if (installed.has(fullPath)) return;
+	installed.add(fullPath);
+
+	const cwd = options?.cwd ?? process.cwd();
+
+	console.log(root ? `⬡ Installing component: ${name}\n` : `   📦 Dependency: ${name}`);
+
+	const meta = await readRegistryJSON<ComponentMeta>(
+		registryRoot,
+		"components",
+		fullPath,
+		"meta.json",
+	);
+
+	// Install component dependencies first (recursive)
+	for (const dep of meta.dependencies) {
+		await addComponent(dep, false, options);
+	}
+
+	// Check if component already exists (skip check entirely in non-interactive mode)
+	const destDir = join(cwd, "src", "lib", "components", fullPath);
+	if (!options?.skipPrompts && existsSync(destDir)) {
+		const replace = await p.confirm({
+			message: `Component "${name}" already exists at src/lib/components/${fullPath}/. Replace it?`,
+		});
+		if (p.isCancel(replace) || !replace) {
+			console.log(`   ⏭️  Skipped ${name}`);
+			return;
+		}
+	}
+
+	// Download/copy component files into src/lib/components/<fullPath>/
+	mkdirSync(destDir, { recursive: true });
+
+	for (const file of meta.files) {
+		const content = await readRegistryFile(registryRoot, "components", fullPath, file);
+		const dest = join(destDir, file);
+		if (file.includes("/")) mkdirSync(dirname(dest), { recursive: true });
+		writeFileSync(dest, content, "utf-8");
+		console.log(`   ✍️  src/lib/components/${fullPath}/${file}`);
+	}
+
+	// Install npm dependencies
+	if (Object.keys(meta.npmDeps).length > 0) {
+		if (options?.skipInstall) {
+			const { addedDeps } = mergePkgJson(cwd, { deps: meta.npmDeps });
+			if (addedDeps.length > 0)
+				console.log(`   📥 Added to package.json: ${addedDeps.join(", ")}`);
+		} else {
+			await bunAdd(cwd, meta.npmDeps);
+		}
+	}
+
+	if (root) console.log(`\n✅ ${name} installed at src/lib/components/${fullPath}/`);
 }
 
 // ─── Ensure $lib/utils.ts exists ─────────────────────────────
@@ -188,10 +194,10 @@ export function cn(...inputs: ClassValue[]) {
 `;
 
 function ensureUtils() {
-    const utilsPath = join(process.cwd(), "src", "lib", "utils.ts");
-    if (!existsSync(utilsPath)) {
-        mkdirSync(dirname(utilsPath), { recursive: true });
-        writeFileSync(utilsPath, UTILS_CONTENT, "utf-8");
-        console.log("   ✍️  src/lib/utils.ts (cn utility)\n");
-    }
+	const utilsPath = join(process.cwd(), "src", "lib", "utils.ts");
+	if (!existsSync(utilsPath)) {
+		mkdirSync(dirname(utilsPath), { recursive: true });
+		writeFileSync(utilsPath, UTILS_CONTENT, "utf-8");
+		console.log("   ✍️  src/lib/utils.ts (cn utility)\n");
+	}
 }

package/src/cli/build.ts

@@ -3,14 +3,14 @@ import { resolve } from "path";
 import { loadEnv } from "../core/env.ts";
 
 export async function runBuild() {
-    loadEnv("production");
-    const buildScript = resolve(import.meta.dir, "../core/build.ts");
-    const proc = spawn(["bun", "run", buildScript], {
-        stdout: "inherit",
-        stderr: "inherit",
-        cwd: process.cwd(),
-        env: { ...process.env, NODE_ENV: process.env.NODE_ENV ?? "production" },
-    });
-    const exitCode = await proc.exited;
-    if (exitCode !== 0) process.exit(exitCode ?? 1);
+	loadEnv("production");
+	const buildScript = resolve(import.meta.dir, "../core/build.ts");
+	const proc = spawn(["bun", "run", buildScript], {
+		stdout: "inherit",
+		stderr: "inherit",
+		cwd: process.cwd(),
+		env: { ...process.env, NODE_ENV: process.env.NODE_ENV ?? "production" },
+	});
+	const exitCode = await proc.exited;
+	if (exitCode !== 0) process.exit(exitCode ?? 1);
 }