bosia 0.6.20 → 0.6.22

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bosia",
-	"version": "0.6.20",
+	"version": "0.6.22",
 	"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": [
@@ -56,7 +56,7 @@
 		"@tailwindcss/cli": "^4.2.1",
 		"elysia": "^1.4.26",
 		"magic-string": "^0.30.0",
-		"svelte": "^5.53.6",
+		"svelte": "^5.56.3",
 		"tailwind-merge": "^3.5.0",
 		"tailwindcss": "^4.2.1"
 	}

package/src/cli/add.ts

@@ -7,6 +7,7 @@ import {
 	resolveLocalRegistryOrExit,
 	readRegistryJSON,
 	readRegistryFile,
+	writeRegistryFile,
 	mergePkgJson,
 	bunAdd,
 } from "./registry.ts";
@@ -150,7 +151,7 @@ export async function addComponent(name: string, root = false, options?: Install
 		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");
+		writeRegistryFile(dest, content);
 		console.log(`   ✍️  src/lib/components/${fullPath}/${file}`);
 	}
 
@@ -158,8 +159,7 @@ export async function addComponent(name: string, root = false, options?: Install
 	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(", ")}`);
+			if (addedDeps.length > 0) console.log(`   📥 Added to package.json: ${addedDeps.join(", ")}`);
 		} else {
 			await bunAdd(cwd, meta.npmDeps);
 		}
@@ -238,8 +238,8 @@ export function cn(...inputs: ClassValue[]) {
 }
 `;
 
-export function ensureUtils() {
-	const utilsPath = join(process.cwd(), "src", "lib", "utils.ts");
+export function ensureUtils(cwd: string = process.cwd()) {
+	const utilsPath = join(cwd, "src", "lib", "utils.ts");
 	if (!existsSync(utilsPath)) {
 		mkdirSync(dirname(utilsPath), { recursive: true });
 		writeFileSync(utilsPath, UTILS_CONTENT, "utf-8");

package/src/cli/addRouter.ts

@@ -0,0 +1,53 @@
+// ─── Dispatch logic for `bosia add ...` ──────────────────
+// Split out from index.ts so the routing can be unit-tested with injected
+// runners (index.ts does top-level `process.argv` parsing on import).
+
+export interface AddRunners {
+	runAdd: (names: string[], flags: string[]) => Promise<void> | void;
+	runAddBlock: (name: string | undefined, flags: string[]) => Promise<void> | void;
+	runAddTheme: (name: string | undefined, flags: string[]) => Promise<void> | void;
+	runAddFont: (family: string | undefined, url: string | undefined) => Promise<void> | void;
+	runAddList: () => Promise<void> | void;
+}
+
+export async function routeAdd(args: string[], runners: AddRunners): Promise<void> {
+	const positional = args.filter((a) => !a.startsWith("-"));
+	const flags = args.filter((a) => a.startsWith("-"));
+	const sub = positional[0];
+
+	if (sub === "block") {
+		await runners.runAddBlock(positional[1], flags);
+		return;
+	}
+	if (sub === "theme") {
+		const themeFlags = args.filter((a) => a.startsWith("--"));
+		await runners.runAddTheme(positional[1], themeFlags);
+		return;
+	}
+	if (sub === "font") {
+		await runners.runAddFont(positional[1], positional[2]);
+		return;
+	}
+	if (sub === "list") {
+		await runners.runAddList();
+		return;
+	}
+
+	// Alias: `blocks/<cat>/<name>` tokens dispatch to runAddBlock.
+	// Skills/AI agents frequently emit the plural `blocks/...` form alongside
+	// `ui/*` components; route those to the block installer transparently
+	// and let any remaining plain component names fall through to runAdd.
+	const blockTokens = positional.filter((p) => p.startsWith("blocks/"));
+	const componentTokens = positional.filter((p) => !p.startsWith("blocks/"));
+	if (blockTokens.length > 0) {
+		if (componentTokens.length > 0) {
+			await runners.runAdd(componentTokens, flags);
+		}
+		for (const token of blockTokens) {
+			await runners.runAddBlock(token.slice("blocks/".length), flags);
+		}
+		return;
+	}
+
+	await runners.runAdd(positional, flags);
+}

package/src/cli/block.ts

@@ -1,11 +1,12 @@
 import { join, dirname } from "path";
-import { mkdirSync, writeFileSync, existsSync } from "fs";
+import { mkdirSync, existsSync } from "fs";
 import * as p from "@clack/prompts";
 import {
 	type InstallOptions,
 	resolveLocalRegistryOrExit,
 	readRegistryJSON,
 	readRegistryFile,
+	writeRegistryFile,
 	mergePkgJson,
 	bunAdd,
 } from "./registry.ts";
@@ -43,24 +44,33 @@ export async function runAddBlock(
 
 	const local = flags.includes("--local");
 	const flagYes = flags.includes("-y") || flags.includes("--yes");
-	const registryRoot = local ? resolveLocalRegistryOrExit() : null;
-	if (local) console.log(`⬡ Using local registry: ${registryRoot}\n`);
+	// Honor an inherited registry root from options (e.g. when called from feat.ts in --local mode).
+	const inheritedRoot = options?.registryRoot ?? null;
+	const registryRoot = inheritedRoot ?? (local ? resolveLocalRegistryOrExit() : null);
+	if (local && !inheritedRoot) console.log(`⬡ Using local registry: ${registryRoot}\n`);
 
 	const resolvedOptions: InstallOptions = {
 		...(options ?? {}),
+		registryRoot,
 		skipPrompts: options?.skipPrompts ?? flagYes,
 	};
 
 	await initAddRegistry(registryRoot);
-	ensureUtils();
+	ensureUtils(resolvedOptions.cwd);
 
 	console.log(`⬡ Installing block: ${name}\n`);
 
 	const meta = await readRegistryJSON<BlockMeta>(registryRoot, "blocks", name, "meta.json");
 
-	// 1. Install primitive dependencies first
+	// 1. Install primitive dependencies first.
+	// Component deps (e.g. "ui/button") go through addComponent.
+	// Block deps (e.g. "blocks/files/upload-area") recurse into runAddBlock.
 	for (const dep of meta.dependencies ?? []) {
-		await addComponent(dep, false, resolvedOptions);
+		if (dep.startsWith("blocks/")) {
+			await runAddBlock(dep.slice("blocks/".length), [], resolvedOptions);
+		} else {
+			await addComponent(dep, false, resolvedOptions);
+		}
 	}
 
 	// 2. Copy block files to src/lib/blocks/<path>/
@@ -83,7 +93,7 @@ export async function runAddBlock(
 		const content = await readRegistryFile(registryRoot, "blocks", name, file);
 		const dest = join(destDir, file);
 		if (file.includes("/")) mkdirSync(dirname(dest), { recursive: true });
-		writeFileSync(dest, content, "utf-8");
+		writeRegistryFile(dest, content);
 		console.log(`   ✍️  src/lib/blocks/${name}/${file}`);
 	}
 
@@ -102,8 +112,7 @@ export async function runAddBlock(
 	if (meta.npmDeps && Object.keys(meta.npmDeps).length > 0) {
 		if (resolvedOptions.skipInstall) {
 			const { addedDeps } = mergePkgJson(cwd, { deps: meta.npmDeps });
-			if (addedDeps.length > 0)
-				console.log(`   📥 Added to package.json: ${addedDeps.join(", ")}`);
+			if (addedDeps.length > 0) console.log(`   📥 Added to package.json: ${addedDeps.join(", ")}`);
 		} else {
 			await bunAdd(cwd, meta.npmDeps);
 		}
@@ -118,9 +127,7 @@ export async function runAddBlock(
 		...(meta.dependencies && meta.dependencies.length > 0
 			? { dependencies: meta.dependencies }
 			: {}),
-		...(meta.fonts && Object.keys(meta.fonts).length > 0
-			? { fonts: Object.keys(meta.fonts) }
-			: {}),
+		...(meta.fonts && Object.keys(meta.fonts).length > 0 ? { fonts: Object.keys(meta.fonts) } : {}),
 	});
 
 	console.log(`\n✅ ${name} installed at src/lib/blocks/${name}/`);

package/src/cli/create.ts

@@ -15,13 +15,12 @@ const TEMPLATE_DESCRIPTIONS: Record<string, string> = {
 	default: "Minimal starter with routing and Tailwind",
 	demo: "Full-featured demo with hooks, API routes, form actions, and more",
 	todo: "Todo app with PostgreSQL + Drizzle ORM",
+	shop: "Online store starter with auth, RBAC, S3 uploads, products/orders/cart",
 };
 
 export async function runCreate(name: string | undefined, args: string[] = []) {
 	if (!name) {
-		console.error(
-			"❌ Please provide a project name.\n   Usage: bun x bosia@latest create my-app",
-		);
+		console.error("❌ Please provide a project name.\n   Usage: bun x bosia@latest create my-app");
 		process.exit(1);
 	}
 
@@ -68,10 +67,7 @@ export async function runCreate(name: string | undefined, args: string[] = []) {
 	copyDir(templateDir, targetDir, name, isLocal);
 
 	if (existsSync(join(targetDir, ".env.example"))) {
-		writeFileSync(
-			join(targetDir, ".env"),
-			readFileSync(join(targetDir, ".env.example"), "utf-8"),
-		);
+		writeFileSync(join(targetDir, ".env"), readFileSync(join(targetDir, ".env.example"), "utf-8"));
 	}
 
 	// Install template features from registry
@@ -89,11 +85,13 @@ export async function runCreate(name: string | undefined, args: string[] = []) {
 			await initAddRegistry(localRegistry);
 			initFeatRegistry(localRegistry);
 
+			const featureOptions: Record<string, string> = config.featureOptions ?? {};
 			for (const feat of config.features) {
 				await installFeature(feat, true, {
 					skipInstall: true,
 					skipPrompts: true,
 					cwd: targetDir,
+					featureOptions,
 				});
 			}
 		}
@@ -177,10 +175,7 @@ function copyDir(src: string, dest: string, projectName: string, isLocal: boolea
 		if (entry.isDirectory()) {
 			copyDir(srcPath, destPath, projectName, isLocal);
 		} else {
-			let content = readFileSync(srcPath, "utf-8").replaceAll(
-				"{{PROJECT_NAME}}",
-				projectName,
-			);
+			let content = readFileSync(srcPath, "utf-8").replaceAll("{{PROJECT_NAME}}", projectName);
 
 			if (entry.name === "package.json" && isLocal) {
 				const bosiaPath = resolve(import.meta.dir, "../../");

package/src/cli/feat.ts

@@ -109,8 +109,11 @@ async function resolveFeatureOptions(
 	options: FeatureOption[],
 	args: string[],
 	skipPrompts: boolean,
+	seed: Record<string, string> = {},
 ): Promise<Record<string, string>> {
-	const values: Record<string, string> = {};
+	// Seed values come from inherited featureOptions (e.g. template-level defaults).
+	// They beat per-feature `default` but lose to explicit CLI args.
+	const values: Record<string, string> = { ...seed };
 	const byFlag = new Map<string, FeatureOption>();
 	for (const opt of options) {
 		if (opt.flag) byFlag.set(opt.flag, opt);
@@ -153,9 +156,7 @@ async function resolveFeatureOptions(
 				continue;
 			}
 			if (opt.required) {
-				console.error(
-					`❌ Feature "${featName}" requires "${opt.flag ?? opt.long ?? opt.name}".`,
-				);
+				console.error(`❌ Feature "${featName}" requires "${opt.flag ?? opt.long ?? opt.name}".`);
 				process.exit(1);
 			}
 			continue;
@@ -217,19 +218,22 @@ export async function installFeature(name: string, isRoot: boolean, options?: In
 	const inheritedOptions = options?.featureOptions ?? {};
 	let myOptions: Record<string, string> = {};
 	if (meta.options && meta.options.length > 0) {
+		// Extract this feature's seed values from the namespaced inherited map.
+		const seed: Record<string, string> = {};
+		for (const [k, v] of Object.entries(inheritedOptions)) {
+			const [feat, optName] = k.split(".");
+			if (feat === name) seed[optName] = v;
+		}
 		myOptions = isRoot
 			? await resolveFeatureOptions(
 					name,
 					meta.options,
 					options?.featureArgs ?? [],
 					options?.skipPrompts ?? false,
+					seed,
 				)
 			: // Dependency features inherit any caller-provided values; prompt only for unresolved required opts.
-				await resolveFeatureOptions(name, meta.options, [], options?.skipPrompts ?? false);
-		for (const [k, v] of Object.entries(inheritedOptions)) {
-			const [feat, optName] = k.split(".");
-			if (feat === name && !(optName in myOptions)) myOptions[optName] = v;
-		}
+				await resolveFeatureOptions(name, meta.options, [], options?.skipPrompts ?? false, seed);
 	}
 
 	// Merge into the namespaced map for downstream dependency features.
@@ -262,7 +266,7 @@ export async function installFeature(name: string, isRoot: boolean, options?: In
 	if (meta.blocks && meta.blocks.length > 0) {
 		console.log("🧱 Installing required blocks...");
 		for (const blockName of meta.blocks) {
-			await runAddBlock(blockName, [], options);
+			await runAddBlock(blockName, [], { ...options, registryRoot });
 		}
 		console.log("");
 	}
@@ -308,16 +312,13 @@ export async function installFeature(name: string, isRoot: boolean, options?: In
 				devDeps: meta.npmDevDeps,
 				scripts: meta.scripts,
 			});
-			if (addedDeps.length > 0)
-				console.log(`\n📥 Added to package.json: ${addedDeps.join(", ")}`);
-			if (addedScripts.length > 0)
-				console.log(`\n📜 Added scripts: ${addedScripts.join(", ")}`);
+			if (addedDeps.length > 0) console.log(`\n📥 Added to package.json: ${addedDeps.join(", ")}`);
+			if (addedScripts.length > 0) console.log(`\n📜 Added scripts: ${addedScripts.join(", ")}`);
 		} else {
 			await bunAdd(cwd, meta.npmDeps, meta.npmDevDeps);
 			if (hasScripts) {
 				const { addedScripts } = mergePkgJson(cwd, { scripts: meta.scripts });
-				if (addedScripts.length > 0)
-					console.log(`\n📜 Added scripts: ${addedScripts.join(", ")}`);
+				if (addedScripts.length > 0) console.log(`\n📜 Added scripts: ${addedScripts.join(", ")}`);
 			}
 		}
 	} else if (hasScripts) {
@@ -359,9 +360,7 @@ export async function installFeature(name: string, isRoot: boolean, options?: In
 		(meta.blocks && meta.blocks.length > 0)
 			? {
 					deps: {
-						...(meta.features && meta.features.length > 0
-							? { features: meta.features }
-							: {}),
+						...(meta.features && meta.features.length > 0 ? { features: meta.features } : {}),
 						...(meta.components.length > 0 ? { components: meta.components } : {}),
 						...(meta.blocks && meta.blocks.length > 0 ? { blocks: meta.blocks } : {}),
 					},
@@ -439,9 +438,7 @@ async function applyStrategy(args: StrategyArgs): Promise<void> {
 
 			const nl = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
 			writeFileSync(dest, existing + nl + newLines.join("\n") + "\n", "utf-8");
-			console.log(
-				`   ➕ ${target} (+${newLines.length} line${newLines.length === 1 ? "" : "s"})`,
-			);
+			console.log(`   ➕ ${target} (+${newLines.length} line${newLines.length === 1 ? "" : "s"})`);
 			return;
 		}
 

package/src/cli/index.ts

@@ -59,27 +59,29 @@ async function main() {
 			break;
 		}
 		case "add": {
-			const positional = args.filter((a) => !a.startsWith("-"));
-			const flags = args.filter((a) => a.startsWith("-"));
-			const sub = positional[0];
-			if (sub === "block") {
-				const blockFlags = flags;
-				const { runAddBlock } = await import("./block.ts");
-				await runAddBlock(positional[1], blockFlags);
-			} else if (sub === "theme") {
-				const themeFlags = args.filter((a) => a.startsWith("--"));
-				const { runAddTheme } = await import("./theme.ts");
-				await runAddTheme(positional[1], themeFlags);
-			} else if (sub === "font") {
-				const { runAddFont } = await import("./font.ts");
-				await runAddFont(positional[1], positional[2]);
-			} else if (sub === "list") {
-				const { runAddList } = await import("./add.ts");
-				runAddList();
-			} else {
-				const { runAdd } = await import("./add.ts");
-				await runAdd(positional, flags);
-			}
+			const { routeAdd } = await import("./addRouter.ts");
+			await routeAdd(args, {
+				runAdd: async (names, flags) => {
+					const { runAdd } = await import("./add.ts");
+					await runAdd(names, flags);
+				},
+				runAddBlock: async (name, flags) => {
+					const { runAddBlock } = await import("./block.ts");
+					await runAddBlock(name, flags);
+				},
+				runAddTheme: async (name, flags) => {
+					const { runAddTheme } = await import("./theme.ts");
+					await runAddTheme(name, flags);
+				},
+				runAddFont: async (family, url) => {
+					const { runAddFont } = await import("./font.ts");
+					await runAddFont(family, url);
+				},
+				runAddList: async () => {
+					const { runAddList } = await import("./add.ts");
+					runAddList();
+				},
+			});
 			break;
 		}
 		case "feat": {
@@ -94,8 +96,7 @@ async function main() {
 			// First non-flag token is the feature name; everything else flows through to the
 			// feature's own option parser. Global flags (-y, --local) are also accepted here
 			// and get split out inside runFeat.
-			const rest =
-				nameIdx === -1 ? args : [...args.slice(0, nameIdx), ...args.slice(nameIdx + 1)];
+			const rest = nameIdx === -1 ? args : [...args.slice(0, nameIdx), ...args.slice(nameIdx + 1)];
 			await runFeat(featName, rest);
 			break;
 		}
@@ -137,6 +138,7 @@ Examples:
   bun x bosia@latest add -y button card      → auto-confirm overwrites (CI / scripts)
   bun x bosia@latest add shop/cart           → src/lib/components/shop/cart/
   bun x bosia@latest add block cards/feature-editorial
+  bun x bosia@latest add blocks/cards/feature-editorial   (alias for: add block cards/feature-editorial)
   bun x bosia@latest add theme editorial
   bun x bosia@latest add font "Fredoka" "https://fonts.googleapis.com/css2?family=Fredoka:wght@400;700&display=swap"
   bun x bosia@latest feat login

package/src/cli/manifest.ts

@@ -67,7 +67,7 @@ export function readManifest(cwd: string = process.cwd()): Manifest {
 
 export function writeManifest(manifest: Manifest, cwd: string = process.cwd()): void {
 	const path = join(cwd, MANIFEST_FILE);
-	writeFileSync(path, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+	writeFileSync(path, JSON.stringify(manifest, null, "\t") + "\n", "utf-8");
 }
 
 export function recordFeature(

package/src/cli/registry.ts

@@ -1,5 +1,5 @@
 import { join, dirname } from "path";
-import { writeFileSync, readFileSync, existsSync } from "fs";
+import { writeFileSync, readFileSync, existsSync, unlinkSync } from "fs";
 import { spawn } from "bun";
 
 // ─── Shared registry utilities for feat.ts and add.ts ─────
@@ -10,6 +10,8 @@ export interface InstallOptions {
 	skipInstall?: boolean; // write deps to package.json instead of `bun add`
 	skipPrompts?: boolean; // auto-overwrite, no interactive prompts
 	cwd?: string; // override process.cwd() for file operations
+	/** When set, use this absolute path as the local registry root instead of fetching from GitHub. */
+	registryRoot?: string | null;
 	/** Pre-resolved feature-specific option values, keyed by `featureName.optionName`. */
 	featureOptions?: Record<string, string>;
 	/** Remaining argv tokens to be parsed as the root feature's own options. */
@@ -80,6 +82,42 @@ export async function readRegistryFile(
 	return fetchText(`${REGISTRY_URL}/${category}/${name}/${file}`);
 }
 
+// ─── Registry file writer ─────────────────────────────────
+
+/**
+ * Write a registry file with one EACCES/EPERM recovery attempt.
+ *
+ * Component/block file loops abort mid-install when a target path is owned by a
+ * different uid — bosapi tenant apps run sandboxed as `bosapi-app-N`, so a
+ * subsequent install from the bosapi user hits EACCES on the first foreign-owned
+ * file and leaves a partial install behind. Unlink + retry recovers; only the
+ * unrecoverable case surfaces the chown hint.
+ */
+export function writeRegistryFile(dest: string, content: string): void {
+	try {
+		writeFileSync(dest, content, "utf-8");
+		return;
+	} catch (err) {
+		const code = (err as NodeJS.ErrnoException).code;
+		if (code !== "EACCES" && code !== "EPERM") throw err;
+	}
+	try {
+		unlinkSync(dest);
+	} catch {
+		// ignore — retry will surface the real error
+	}
+	try {
+		writeFileSync(dest, content, "utf-8");
+	} catch (retry) {
+		const e = retry as NodeJS.ErrnoException;
+		throw new Error(
+			`Cannot write ${dest}: ${e.code}. ` +
+				`The existing file is owned by a different user (likely created from inside ` +
+				`the app sandbox). Fix from the project root: chown -R $(whoami) src/lib`,
+		);
+	}
+}
+
 // ─── package.json helpers ─────────────────────────────────
 
 export interface PkgDeps {
@@ -138,7 +176,7 @@ export function mergePkgJson(
 	}
 
 	if (changed) {
-		writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n", "utf-8");
+		writeFileSync(pkgPath, JSON.stringify(pkg, null, "\t") + "\n", "utf-8");
 	}
 
 	return { addedDeps, addedScripts };

package/src/core/build.ts

@@ -88,9 +88,7 @@ let appHtml: any;
 try {
 	appHtml = loadAppHtmlTemplate(process.cwd());
 	console.log(
-		"📄 Loaded src/app.html (favicon override: " +
-			(appHtml.hasCustomFavicon ? "yes" : "no") +
-			")",
+		"📄 Loaded src/app.html (favicon override: " + (appHtml.hasCustomFavicon ? "yes" : "no") + ")",
 	);
 } catch (err) {
 	console.error(`❌ src/app.html validation failed:\n${(err as Error).message}`);

package/src/core/client/App.svelte

@@ -114,8 +114,7 @@
 		// We always issue the fetch (even when all loaders skip) so page-level
 		// metadata stays fresh on every navigation; only the loaders flagged in
 		// the mask actually run server-side.
-		const maskBits =
-			(pageRun ? "1" : "0") + layoutRunFlags.map((b) => (b ? "1" : "0")).join("");
+		const maskBits = (pageRun ? "1" : "0") + layoutRunFlags.map((b) => (b ? "1" : "0")).join("");
 
 		// Clear dirty set now — we've baked it into the mask.
 		clearDirty();
@@ -173,9 +172,7 @@
 							? errInfo
 							: "Internal Server Error";
 				const errDepth: number =
-					typeof result?.errorDepth === "number"
-						? result.errorDepth
-						: match.route.layouts.length;
+					typeof result?.errorDepth === "number" ? result.errorDepth : match.route.layouts.length;
 				const errOrigin = result?.errorOrigin === "layout" ? "layout" : "page";
 				const picked = pickErrorPage(match.route.errorPages ?? [], errDepth, errOrigin);
 				if (!picked) {
@@ -309,9 +306,7 @@
 			if (result?.metadata) {
 				if (result.metadata.title) document.title = result.metadata.title;
 				if (result.metadata.description) {
-					let meta = document.querySelector(
-						'meta[name="description"]',
-					) as HTMLMetaElement | null;
+					let meta = document.querySelector('meta[name="description"]') as HTMLMetaElement | null;
 					if (!meta) {
 						meta = document.createElement("meta");
 						meta.name = "description";

package/src/core/client/page.svelte.ts

@@ -0,0 +1,28 @@
+// ─── Reactive page object ─────────────────────────────────
+// Mirrors what user-facing skills (bosia-page-shell, bosia-seo,
+// bosia-navigation) teach: `import { page } from "bosia/client"` then read
+// `page.url.pathname`. Backed by `router.currentRoute` (`$state` in
+// router.svelte.ts), so the `$derived` URL re-runs on every nav.
+//
+// No `params` getter on purpose — Bosia already passes `params` as a prop to
+// `+page.svelte` / `+layout.svelte` (see App.svelte), mirroring the modern
+// SvelteKit `$app/state` direction. Route components should destructure
+// `params` from `$props()`, not from here.
+
+import { router } from "./router.svelte.ts";
+
+class Page {
+	#url = $derived.by(() => {
+		if (typeof window === "undefined") return new URL("http://localhost/");
+		return new URL(router.currentRoute, window.location.origin);
+	});
+
+	get url() {
+		return this.#url;
+	}
+	get pathname() {
+		return this.#url.pathname;
+	}
+}
+
+export const page = new Page();

package/src/core/client/router.svelte.ts

@@ -57,10 +57,7 @@ export const router = new (class Router {
 			return;
 		}
 		// Canonicalize trailing slash before navigating (matches server 308 behavior)
-		const canonical = canonicalPathname(
-			pathname,
-			(match.route as any).trailingSlash ?? "never",
-		);
+		const canonical = canonicalPathname(pathname, (match.route as any).trailingSlash ?? "never");
 		const finalPath = canonical !== null ? canonical + queryHash : path;
 
 		const navType: NavType = opts.source ?? "link";
@@ -108,8 +105,7 @@ export const router = new (class Router {
 			// Same-page hash navigation: skip page reload, just update URL and scroll
 			// to the target element. Mirrors browser default for in-page anchors.
 			const samePage =
-				anchor.pathname === window.location.pathname &&
-				anchor.search === window.location.search;
+				anchor.pathname === window.location.pathname && anchor.search === window.location.search;
 			if (samePage && anchor.hash) {
 				e.preventDefault();
 				const finalPath = anchor.pathname + anchor.search + anchor.hash;
@@ -127,8 +123,7 @@ export const router = new (class Router {
 
 		// Browser back/forward
 		window.addEventListener("popstate", () => {
-			const finalPath =
-				window.location.pathname + window.location.search + window.location.hash;
+			const finalPath = window.location.pathname + window.location.search + window.location.hash;
 			// Fire beforeNavigate listeners; popstate can't be reliably cancelled
 			// (browser history already advanced), so we surface the event for
 			// observation only — `cancel()` is a no-op for this source.

package/src/core/config.ts

@@ -70,10 +70,7 @@ export async function loadBosiaConfig(cwd: string = process.cwd()): Promise<Bosi
 	// the project's own node_modules. /tmp would have no node_modules to walk into.
 	const cacheDir = join(cwd, ".bosia");
 	mkdirSync(cacheDir, { recursive: true });
-	const tmpFile = join(
-		cacheDir,
-		`config.${Date.now()}.${Math.random().toString(36).slice(2)}.mjs`,
-	);
+	const tmpFile = join(cacheDir, `config.${Date.now()}.${Math.random().toString(36).slice(2)}.mjs`);
 	await Bun.write(tmpFile, code);
 
 	let mod: { default?: BosiaConfig };

package/src/core/cookies.ts

@@ -98,8 +98,7 @@ export class CookieJar implements Cookies {
 		}
 		let header = `${name}=${encodeURIComponent(value)}`;
 		if (opts.path) {
-			if (UNSAFE_COOKIE_VALUE.test(opts.path))
-				throw new Error(`Invalid cookie path: ${opts.path}`);
+			if (UNSAFE_COOKIE_VALUE.test(opts.path)) throw new Error(`Invalid cookie path: ${opts.path}`);
 			header += `; Path=${opts.path}`;
 		}
 		if (opts.domain) {

package/src/core/dev-500.ts

@@ -115,7 +115,7 @@ export function dev500Response({
 			message,
 			stack: detail,
 		},
-  ])}</script>
+	])}</script>
   ${bodyEndExtras?.join("\n") ?? ""}
 </body>
 </html>`;

package/src/core/html.ts

@@ -122,8 +122,7 @@ export function buildHtml(
 			? `window.__BOSIA_PAGE_DEPS__=${safeJsonStringify(pageDeps)};window.__BOSIA_LAYOUT_DEPS__=${safeJsonStringify(layoutDeps ?? [])};`
 			: "";
 
-	const sysScript =
-		ssrFlag || depsScript ? `\n  <script${n}>${ssrFlag}${depsScript}</script>` : "";
+	const sysScript = ssrFlag || depsScript ? `\n  <script${n}>${ssrFlag}${depsScript}</script>` : "";
 
 	const dataIslands = csr
 		? `\n  <script${n} type="application/json" id="__bosia-page-data__">${safeJsonForScript(pageData)}</script>` +

package/src/core/plugin.ts

@@ -60,9 +60,7 @@ export function makeBosiaPlugin(target: "browser" | "bun" = "bun") {
 			let svelteBrowserEntry: string | null = null;
 			if (target === "browser") {
 				try {
-					const svelteDir = dirname(
-						require.resolve("svelte/package.json", { paths: [appDir] }),
-					);
+					const svelteDir = dirname(require.resolve("svelte/package.json", { paths: [appDir] }));
 					const pkg = require(join(svelteDir, "package.json"));
 					const dotExport = pkg.exports?.["."];
 					const browserPath = typeof dotExport === "object" ? dotExport.browser : null;