@ilha/router 0.3.9 → 0.4.1

package/dist/{index-BCwBfDfA.d.ts → index-CFBKeDvv.d.ts}

@@ -128,6 +128,12 @@ interface RouterBuilder {
    * was never registered via `.route()`.
    */
   attachLoader(pattern: string, loader: Loader<any>): RouterBuilder;
+  /**
+   * Return a snapshot of every registered route in match order. Useful for
+   * prerenderers that need to discover the filesystem routes exposed by
+   * `pageRouter` without reaching into router internals.
+   */
+  routes(): RouteRecord[];
   prime(): void;
   mount(target: string | Element, options?: MountOptions): () => void;
   render(url: string | URL): string;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { A as prefetch, B as wrapLayout, C as composeLoaders, D as isActive, E as error, F as routePath, H as getHistoryMode, I as routeSearch, L as router, M as redirect, N as routeHash, O as loader, P as routeParams, R as useRoute, S as _default, T as enableLinkInterception, U as setHistoryMode, V as HistoryMode, _ as RouteRecord, a as InferLoader, b as RouterLink, c as LinkInterceptionOptions, d as LoaderError, f as MergeLoaders, g as RenderResponse, h as Redirect, i as HydrateOptions, j as prime, k as navigate, l as Loader, m as NavigateOptions, n as ErrorHandler, o as LOADER_ENDPOINT, p as MountOptions, r as HydratableRenderOptions, s as LayoutHandler, t as AppError, u as LoaderContext, v as RouteSnapshot, w as defineLayout, x as RouterView, y as RouterBuilder, z as wrapError } from "./index-BCwBfDfA.js";
+import { A as prefetch, B as wrapLayout, C as composeLoaders, D as isActive, E as error, F as routePath, H as getHistoryMode, I as routeSearch, L as router, M as redirect, N as routeHash, O as loader, P as routeParams, R as useRoute, S as _default, T as enableLinkInterception, U as setHistoryMode, V as HistoryMode, _ as RouteRecord, a as InferLoader, b as RouterLink, c as LinkInterceptionOptions, d as LoaderError, f as MergeLoaders, g as RenderResponse, h as Redirect, i as HydrateOptions, j as prime, k as navigate, l as Loader, m as NavigateOptions, n as ErrorHandler, o as LOADER_ENDPOINT, p as MountOptions, r as HydratableRenderOptions, s as LayoutHandler, t as AppError, u as LoaderContext, v as RouteSnapshot, w as defineLayout, x as RouterView, y as RouterBuilder, z as wrapError } from "./index-CFBKeDvv.js";
 export { AppError, ErrorHandler, HistoryMode, HydratableRenderOptions, HydrateOptions, InferLoader, LOADER_ENDPOINT, LayoutHandler, LinkInterceptionOptions, Loader, LoaderContext, LoaderError, MergeLoaders, MountOptions, NavigateOptions, Redirect, RenderResponse, RouteRecord, RouteSnapshot, RouterBuilder, RouterLink, RouterView, composeLoaders, _default as default, defineLayout, enableLinkInterception, error, getHistoryMode, isActive, loader, navigate, prefetch, prime, redirect, routeHash, routeParams, routePath, routeSearch, router, setHistoryMode, useRoute, wrapError, wrapLayout };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { C as wrapError, E as setHistoryMode, S as useRoute, T as getHistoryMode, _ as routeParams, a as RouterView, b as router, c as enableLinkInterception, d as loader, f as navigate, g as routeHash, h as redirect, i as RouterLink, l as error, m as prime, n as LoaderError, o as composeLoaders, p as prefetch, r as Redirect, s as defineLayout, t as LOADER_ENDPOINT, u as isActive, v as routePath, w as wrapLayout, x as src_default, y as routeSearch } from "./src-BBvRqv3b.js";
+import { C as wrapError, E as setHistoryMode, S as useRoute, T as getHistoryMode, _ as routeParams, a as RouterView, b as router, c as enableLinkInterception, d as loader, f as navigate, g as routeHash, h as redirect, i as RouterLink, l as error, m as prime, n as LoaderError, o as composeLoaders, p as prefetch, r as Redirect, s as defineLayout, t as LOADER_ENDPOINT, u as isActive, v as routePath, w as wrapLayout, x as src_default, y as routeSearch } from "./src-0cb8FYdn.js";
 export { LOADER_ENDPOINT, LoaderError, Redirect, RouterLink, RouterView, composeLoaders, src_default as default, defineLayout, enableLinkInterception, error, getHistoryMode, isActive, loader, navigate, prefetch, prime, redirect, routeHash, routeParams, routePath, routeSearch, router, setHistoryMode, useRoute, wrapError, wrapLayout };

package/dist/plugin-CnS_mBUE.d.ts

@@ -0,0 +1,12 @@
+import * as _$unplugin from "unplugin";
+
+//#region src/plugin.d.ts
+interface IlhaPagesOptions {
+  /** Directory containing page files. Default: `src/pages` */
+  dir?: string;
+  /** Output path for the generated routes + registry file. Default: `.ilha/routes.ts` */
+  generated?: string;
+}
+declare const ilhaPages: _$unplugin.UnpluginInstance<IlhaPagesOptions | undefined, boolean>;
+//#endregion
+export { ilhaPages as n, IlhaPagesOptions as t };

package/dist/plugin-DAk44om0.js

@@ -0,0 +1,416 @@
+import { watch } from "node:fs";
+import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
+import { createUnplugin } from "unplugin";
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+//#region src/codegen.ts
+function toPosix(p) {
+	return p.replace(/\\/g, "/");
+}
+/** Files that should never be treated as pages even if they match the ts/tsx extension. */
+const EXCLUDED_RE = /\.(test|spec|d)\.(ts|tsx)$/;
+/**
+* Match a top-of-statement `export const load`, `export let load`,
+* `export function load`, or `export async function load`. Intentionally
+* conservative: `export { load } from "./x"` re-exports are NOT detected
+* in v1. Declare `load` directly in the file to be picked up.
+*/
+const LOADER_EXPORT_RE = /^\s*export\s+(?:const|let|var|async\s+function|function)\s+load\b/m;
+async function hasLoaderExport(file) {
+	try {
+		const stripped = (await readFile(file, "utf8")).replace(/^\s*\/\/.*$/gm, "");
+		return LOADER_EXPORT_RE.test(stripped);
+	} catch {
+		return false;
+	}
+}
+function fileToSegment(name) {
+	if (name.startsWith("[...") && name.endsWith("]")) return `**:${name.slice(4, -1)}`;
+	if (name.startsWith("[") && name.endsWith("]")) return `:${name.slice(1, -1)}`;
+	return name;
+}
+/** Route-group directories like "(auth)" are transparent to the URL. */
+function dirToSegment(name) {
+	if (name.startsWith("(") && name.endsWith(")")) return "";
+	return fileToSegment(name);
+}
+function fileToPattern(pagesDir, file) {
+	const rel = toPosix(relative(pagesDir, file));
+	const parts = rel.slice(0, -extname(rel).length).split("/");
+	const segments = [...parts.slice(0, -1).map(dirToSegment), fileToSegment(parts.at(-1))];
+	if (segments.at(-1) === "index") segments.pop();
+	return "/" + segments.filter(Boolean).join("/") || "/";
+}
+function patternToName(pattern) {
+	if (pattern === "/") return "index";
+	return pattern.replace(/^\//, "").replace(/\*\*:[^/]*/g, (m) => m.length > 3 ? m.slice(3) : "wildcard").replace(/:/g, "").replace(/\*\*/g, "wildcard").replace(/\//g, "-").replace(/[^a-zA-Z0-9-]/g, "") || "page";
+}
+function specificityScore(pattern) {
+	if (pattern === "/") return 3;
+	if (pattern.includes("**")) return 0;
+	if (pattern.includes(":")) return 1;
+	return 2;
+}
+/** Deterministic sort: by specificity desc, then by segment count desc, then alphabetical. */
+function sortEntries(entries) {
+	return [...entries].sort((a, b) => {
+		const specDiff = specificityScore(b.pattern) - specificityScore(a.pattern);
+		if (specDiff !== 0) return specDiff;
+		const segDiff = b.pattern.split("/").length - a.pattern.split("/").length;
+		if (segDiff !== 0) return segDiff;
+		return a.pattern.localeCompare(b.pattern);
+	});
+}
+function chainForFile(pagesDir, file, all, sentinel) {
+	const relDir = toPosix(relative(pagesDir, dirname(file)));
+	const parts = relDir === "" ? [] : relDir.split("/");
+	const dirs = [pagesDir, ...parts.map((_, i) => join(pagesDir, ...parts.slice(0, i + 1)))];
+	const candidatesFor = (dir) => {
+		const tsx = `${join(dir, sentinel)}.tsx`;
+		if (all.has(tsx)) return [tsx];
+		const ts = `${join(dir, sentinel)}.ts`;
+		if (all.has(ts)) return [ts];
+		return [];
+	};
+	return dirs.flatMap(candidatesFor);
+}
+const MAX_SCAN_DEPTH = 20;
+async function collectFiles(dir, depth = 0) {
+	if (depth > MAX_SCAN_DEPTH) {
+		console.warn(`[ilha:pages] Max scan depth (${MAX_SCAN_DEPTH}) reached at ${dir} — skipping`);
+		return [];
+	}
+	const results = [];
+	try {
+		for (const entry of await readdir(dir, { withFileTypes: true })) {
+			const full = join(dir, entry.name);
+			if (entry.isDirectory()) results.push(...await collectFiles(full, depth + 1));
+			else if (entry.isFile() && /\.(ts|tsx)$/.test(entry.name) && !EXCLUDED_RE.test(entry.name)) results.push(full);
+		}
+	} catch (e) {
+		if (e.code === "ENOENT") return [];
+		throw e;
+	}
+	return results;
+}
+async function scanPages(pagesDir) {
+	const all = await collectFiles(pagesDir);
+	const allSet = new Set(all);
+	const pages = all.filter((f) => !basename(f).startsWith("+"));
+	const layoutLoaderCache = /* @__PURE__ */ new Map();
+	const getLayoutHasLoader = (file) => {
+		let cached = layoutLoaderCache.get(file);
+		if (!cached) {
+			cached = hasLoaderExport(file);
+			layoutLoaderCache.set(file, cached);
+		}
+		return cached;
+	};
+	return Promise.all(pages.map(async (file) => {
+		const pattern = fileToPattern(pagesDir, file);
+		const layouts = chainForFile(pagesDir, file, allSet, "+layout");
+		const errors = chainForFile(pagesDir, file, allSet, "+error");
+		const [pageHasLoader, ...layoutFlags] = await Promise.all([hasLoaderExport(file), ...layouts.map(getLayoutHasLoader)]);
+		const loaderLayouts = layouts.filter((_, i) => layoutFlags[i]);
+		return {
+			file,
+			pattern,
+			name: patternToName(pattern),
+			layouts,
+			errors,
+			hasLoader: pageHasLoader,
+			loaderLayouts
+		};
+	}));
+}
+function validateEntries(entries, pagesDir) {
+	if (entries.length === 0) {
+		console.warn(`[ilha:pages] No pages found in ${pagesDir}`);
+		return;
+	}
+	const seenPatterns = /* @__PURE__ */ new Map();
+	const seenNames = /* @__PURE__ */ new Map();
+	for (const entry of entries) {
+		const existingPattern = seenPatterns.get(entry.pattern);
+		if (existingPattern) console.warn(`[ilha:pages] Duplicate route pattern "${entry.pattern}"\n  first:  ${existingPattern}\n  second: ${entry.file}\n  The first match wins — the second page will never be reached.`);
+		else seenPatterns.set(entry.pattern, entry.file);
+		const existingName = seenNames.get(entry.name);
+		if (existingName) console.warn(`[ilha:pages] Registry name collision: "${entry.name}" is used by both\n  ${existingName}\n  ${entry.file}\n  Hydration may not work correctly for one of these routes.`);
+		else seenNames.set(entry.name, entry.file);
+	}
+}
+async function generate(pagesDir, outFile) {
+	const entries = sortEntries(await scanPages(pagesDir));
+	validateEntries(entries, pagesDir);
+	const rel = (abs) => {
+		const r = toPosix(relative(dirname(outFile), abs));
+		return r.startsWith(".") ? r : `./${r}`;
+	};
+	const imports = [`import { router, wrapLayout, wrapError } from "@ilha/router";`, `import type { Island } from "ilha";`];
+	const wrappedIslandLines = [];
+	const registryLines = [];
+	const routeLines = [];
+	const clientImport = (abs) => `${rel(abs)}?client`;
+	for (const [i, entry] of entries.entries()) {
+		const pageId = `_page${i}`;
+		imports.push(`import { default as ${pageId} } from ${JSON.stringify(clientImport(entry.file))};`);
+		for (const [j, l] of entry.layouts.entries()) imports.push(`import { default as _layout${i}_${j} } from ${JSON.stringify(clientImport(l))};`);
+		for (const [j, e] of entry.errors.entries()) imports.push(`import { default as _error${i}_${j} } from ${JSON.stringify(clientImport(e))};`);
+		let expr = pageId;
+		for (let j = entry.errors.length - 1; j >= 0; j--) expr = `wrapError(_error${i}_${j}, ${expr})`;
+		for (let j = entry.layouts.length - 1; j >= 0; j--) expr = `wrapLayout(_layout${i}_${j}, ${expr})`;
+		const wrappedId = `_wrapped${i}`;
+		wrappedIslandLines.push(`const ${wrappedId} = ${expr};`);
+		registryLines.push(`  ${JSON.stringify(entry.name)}: ${wrappedId}` + (i < entries.length - 1 ? "," : ""));
+		routeLines.push(`  .route(${JSON.stringify(entry.pattern)}, ${wrappedId})`);
+	}
+	const code = [
+		`// @generated by @ilha/router — do not edit`,
+		``,
+		...imports,
+		``,
+		...wrappedIslandLines,
+		``,
+		`export const registry: Record<string, Island<any, any>> = {`,
+		...registryLines,
+		`};`,
+		``,
+		`export const pageRouter = router()`,
+		...routeLines,
+		`  ;`
+	].join("\n");
+	await mkdir(dirname(outFile), { recursive: true });
+	const routesChanged = await writeIfChanged(outFile, code);
+	const loadersFile = join(dirname(outFile), "loaders.ts");
+	const loadersChanged = await writeIfChanged(loadersFile, buildLoadersFile(entries, loadersFile, outFile));
+	if (routesChanged || loadersChanged) await generateTypes(outFile);
+}
+function buildLoadersFile(entries, loadersFile, routesFile) {
+	const relFromLoaders = (abs) => {
+		const r = toPosix(relative(dirname(loadersFile), abs));
+		return r.startsWith(".") ? r : `./${r}`;
+	};
+	const withLoaders = entries.filter((e) => e.hasLoader || e.loaderLayouts.length > 0);
+	if (withLoaders.length === 0) return [
+		`// @generated by @ilha/router — do not edit`,
+		`// This project has no loader exports; this file is intentionally empty.`,
+		``,
+		`export {};`,
+		``
+	].join("\n");
+	const routesRel = relFromLoaders(routesFile).replace(/\.tsx?$/, "");
+	const imports = [`import { pageRouter } from ${JSON.stringify(routesRel)};`];
+	let needsComposeLoaders = false;
+	const attachLines = [];
+	for (const [i, entry] of withLoaders.entries()) {
+		const loaderIds = [];
+		for (const [j, layout] of entry.loaderLayouts.entries()) {
+			const id = `_p${i}_l${j}`;
+			imports.push(`import { load as ${id} } from ${JSON.stringify(relFromLoaders(layout))};`);
+			loaderIds.push(id);
+		}
+		if (entry.hasLoader) {
+			const id = `_p${i}`;
+			imports.push(`import { load as ${id} } from ${JSON.stringify(relFromLoaders(entry.file))};`);
+			loaderIds.push(id);
+		}
+		const loadersExpr = loaderIds.length === 1 ? loaderIds[0] : `composeLoaders([${loaderIds.join(", ")}])`;
+		if (loaderIds.length > 1) needsComposeLoaders = true;
+		attachLines.push(`pageRouter.attachLoader(${JSON.stringify(entry.pattern)}, ${loadersExpr});`);
+	}
+	if (needsComposeLoaders) imports.unshift(`import { composeLoaders } from "@ilha/router";`);
+	return [
+		`// @generated by @ilha/router — do not edit`,
+		`// Server-only. Import this module from your SSR entry to wire loaders`,
+		`// onto pageRouter. Importing it from the client is a no-op but wastes`,
+		`// bundle size — rely on the default build pipeline to keep it out.`,
+		``,
+		...imports,
+		``,
+		...attachLines,
+		``
+	].join("\n");
+}
+async function writeIfChanged(file, content) {
+	try {
+		if (await readFile(file, "utf8") === content) return false;
+	} catch {}
+	await writeFile(file, content, "utf8");
+	return true;
+}
+async function generateTypes(outFile) {
+	await writeIfChanged(outFile.replace(/\.tsx?$/, ".d.ts"), [
+		`// @generated by @ilha/router — do not edit`,
+		``,
+		`declare module "ilha:pages" {`,
+		`  import type { RouterBuilder } from "@ilha/router";`,
+		`  export const pageRouter: RouterBuilder;`,
+		`}`,
+		``,
+		`declare module "ilha:registry" {`,
+		`  import type { Island } from "ilha";`,
+		`  export const registry: Record<string, Island<any, any>>;`,
+		`}`,
+		``,
+		`declare module "ilha:loaders" {`,
+		`  // Side-effect-only module. Importing it attaches loaders to pageRouter.`,
+		`}`,
+		``
+	].join("\n"));
+}
+const RESOLVED_PAGES = "\0ilha:pages";
+const RESOLVED_REGISTRY = "\0ilha:registry";
+const RESOLVED_LOADERS = "\0ilha:loaders";
+const RESOLVED_VIRTUAL_IDS = [
+	RESOLVED_PAGES,
+	RESOLVED_REGISTRY,
+	RESOLVED_LOADERS
+];
+/** Query suffix used on page/layout imports in the client-safe routes file. */
+const CLIENT_QUERY = "?client";
+function resolvePluginPaths(root, options) {
+	const pagesDir = resolve(root, options.dir ?? "src/pages");
+	const outFile = resolve(root, options.generated ?? ".ilha/routes.ts");
+	return {
+		pagesDir,
+		outFile,
+		loadersFile: join(dirname(outFile), "loaders.ts")
+	};
+}
+function createPagesPluginState(options) {
+	let pagesDir;
+	let outFile;
+	let loadersFile;
+	const setPaths = (root) => {
+		({pagesDir, outFile, loadersFile} = resolvePluginPaths(root, options));
+	};
+	const regen = async () => {
+		try {
+			await generate(pagesDir, outFile);
+		} catch (e) {
+			console.error("[ilha:pages] codegen failed:", e);
+		}
+	};
+	const isUnderPagesDir = (file) => file === pagesDir || file.startsWith(pagesDir + sep);
+	const shouldRegenOnChange = (file) => {
+		if (!isUnderPagesDir(file)) return false;
+		const base = basename(file);
+		return base.startsWith("+") || /\.(ts|tsx)$/.test(base);
+	};
+	return {
+		get pagesDir() {
+			return pagesDir;
+		},
+		get outFile() {
+			return outFile;
+		},
+		get loadersFile() {
+			return loadersFile;
+		},
+		setPaths,
+		regen,
+		shouldRegenOnChange,
+		isUnderPagesDir
+	};
+}
+async function regenFromPagesChange(state, file, shouldRegen) {
+	if (!shouldRegen(file)) return;
+	await state.regen();
+}
+function resolvePagesId(_state, id, importer) {
+	if (id === "ilha:pages") return RESOLVED_PAGES;
+	if (id === "ilha:registry") return RESOLVED_REGISTRY;
+	if (id === "ilha:loaders") return RESOLVED_LOADERS;
+	if (id.endsWith("?client")) {
+		const bare = id.slice(0, -7);
+		return (importer ? resolve(dirname(importer.replace(/\?.*$/, "")), bare) : resolve(bare)) + CLIENT_QUERY;
+	}
+}
+function loadPagesModule(state, id) {
+	if (id === "\0ilha:pages") {
+		const spec = state.outFile.replace(/\.tsx?$/, "");
+		return `export { pageRouter } from ${JSON.stringify(spec)};`;
+	}
+	if (id === "\0ilha:registry") {
+		const spec = state.outFile.replace(/\.tsx?$/, "");
+		return `export { registry } from ${JSON.stringify(spec)};`;
+	}
+	if (id === "\0ilha:loaders") {
+		const spec = state.loadersFile.replace(/\.tsx?$/, "");
+		return `import ${JSON.stringify(spec)};`;
+	}
+	if (id.endsWith("?client")) {
+		const bare = id.slice(0, -7);
+		return `export { default } from ${JSON.stringify(bare)};`;
+	}
+}
+function createStructuralInvalidate(state, invalidate) {
+	return async (file) => {
+		if (!state.isUnderPagesDir(file)) return;
+		await state.regen();
+		await invalidate();
+	};
+}
+function setupRspackPagesWatcher(state, structuralInvalidate) {
+	const watcher = watch(state.pagesDir, { recursive: true }, (_event, filename) => {
+		if (!filename) return;
+		structuralInvalidate(join(state.pagesDir, filename));
+	});
+	return () => watcher.close();
+}
+const pagesFactory = (options = {}) => {
+	const state = createPagesPluginState(options);
+	return {
+		name: "ilha:pages",
+		async buildStart() {
+			if (!state.pagesDir) state.setPaths(process.cwd());
+			this.addWatchFile?.(state.pagesDir);
+			await state.regen();
+		},
+		async watchChange(file) {
+			await regenFromPagesChange(state, file, (f) => state.shouldRegenOnChange(f));
+		},
+		resolveId(id, importer) {
+			return resolvePagesId(state, id, importer);
+		},
+		load(id) {
+			return loadPagesModule(state, id);
+		},
+		vite: {
+			configResolved(config) {
+				state.setPaths(config.root);
+			},
+			configureServer(server) {
+				server.watcher.add(state.pagesDir);
+				const structuralInvalidate = createStructuralInvalidate(state, async () => {
+					for (const id of RESOLVED_VIRTUAL_IDS) {
+						const mod = server.moduleGraph.getModuleById(id);
+						if (mod) server.moduleGraph.invalidateModule(mod);
+					}
+					server.hot.send({ type: "full-reload" });
+				});
+				server.watcher.on("add", structuralInvalidate);
+				server.watcher.on("addDir", structuralInvalidate);
+				server.watcher.on("unlink", structuralInvalidate);
+				server.watcher.on("change", async (file) => {
+					if (state.shouldRegenOnChange(file)) await structuralInvalidate(file);
+				});
+			}
+		},
+		rspack(compiler) {
+			state.setPaths(compiler.options.context ?? process.cwd());
+			const structuralInvalidate = createStructuralInvalidate(state, () => {
+				if (!compiler.watching) return;
+				compiler.invalidate();
+			});
+			let closeWatcher;
+			compiler.hooks.watchRun.tap("ilha:pages", () => {
+				closeWatcher?.();
+				closeWatcher = setupRspackPagesWatcher(state, structuralInvalidate);
+			});
+			compiler.hooks.shutdown.tap("ilha:pages", () => closeWatcher?.());
+		}
+	};
+};
+const ilhaPages = /* @__PURE__ */ createUnplugin(pagesFactory);
+//#endregion
+export { ilhaPages as t };

package/dist/rolldown.d.ts

@@ -0,0 +1,9 @@
+import { B as wrapLayout, n as ErrorHandler, s as LayoutHandler, t as AppError, v as RouteSnapshot, z as wrapError } from "./index-CFBKeDvv.js";
+import { n as ilhaPages, t as IlhaPagesOptions } from "./plugin-CnS_mBUE.js";
+import * as _$unplugin from "unplugin";
+
+//#region src/rolldown.d.ts
+/** Rolldown plugin — use via `@ilha/router/rolldown`. */
+declare function pages(options?: IlhaPagesOptions): _$unplugin.RolldownPlugin<any> | _$unplugin.RolldownPlugin<any>[];
+//#endregion
+export { type AppError, type ErrorHandler, type IlhaPagesOptions, type LayoutHandler, type RouteSnapshot, ilhaPages, pages, wrapError, wrapLayout };

package/dist/rolldown.js

@@ -0,0 +1,9 @@
+import { C as wrapError, w as wrapLayout } from "./src-0cb8FYdn.js";
+import { t as ilhaPages } from "./plugin-DAk44om0.js";
+//#region src/rolldown.ts
+/** Rolldown plugin — use via `@ilha/router/rolldown`. */
+function pages(options = {}) {
+	return ilhaPages.rolldown(options);
+}
+//#endregion
+export { ilhaPages, pages, wrapError, wrapLayout };

package/dist/rspack.d.ts

@@ -0,0 +1,9 @@
+import { B as wrapLayout, n as ErrorHandler, s as LayoutHandler, t as AppError, v as RouteSnapshot, z as wrapError } from "./index-CFBKeDvv.js";
+import { n as ilhaPages, t as IlhaPagesOptions } from "./plugin-CnS_mBUE.js";
+import * as _$unplugin from "unplugin";
+
+//#region src/rspack.d.ts
+/** Rspack plugin — use via `@ilha/router/rspack`. */
+declare function pages(options?: IlhaPagesOptions): _$unplugin.RspackPluginInstance;
+//#endregion
+export { type AppError, type ErrorHandler, type IlhaPagesOptions, type LayoutHandler, type RouteSnapshot, ilhaPages, pages, wrapError, wrapLayout };

package/dist/rspack.js

@@ -0,0 +1,9 @@
+import { C as wrapError, w as wrapLayout } from "./src-0cb8FYdn.js";
+import { t as ilhaPages } from "./plugin-DAk44om0.js";
+//#region src/rspack.ts
+/** Rspack plugin — use via `@ilha/router/rspack`. */
+function pages(options = {}) {
+	return ilhaPages.rspack(options);
+}
+//#endregion
+export { ilhaPages, pages, wrapError, wrapLayout };

package/dist/{src-BBvRqv3b.js → src-0cb8FYdn.js}

@@ -611,6 +611,9 @@ function router() {
 			if (rec) rec.loader = loader;
 			return builder;
 		},
+		routes() {
+			return _records.map((record) => ({ ...record }));
+		},
 		prime,
 		mount(target, { hydrate = false, registry } = {}) {
 			if (!isBrowser) {

package/dist/vite.d.ts

@@ -1,9 +1,10 @@
 /// <reference types="node" />
-import { B as wrapLayout, n as ErrorHandler, s as LayoutHandler, t as AppError, v as RouteSnapshot, z as wrapError } from "./index-BCwBfDfA.js";
+import { B as wrapLayout, n as ErrorHandler, s as LayoutHandler, t as AppError, v as RouteSnapshot, z as wrapError } from "./index-CFBKeDvv.js";
+import { n as ilhaPages, t as IlhaPagesOptions } from "./plugin-CnS_mBUE.js";
+import * as fs from "node:fs";
 import * as http from "node:http";
 import { Agent, ClientRequest, ClientRequestArgs, OutgoingHttpHeaders } from "node:http";
 import { Http2SecureServer } from "node:http2";
-import * as fs from "node:fs";
 import { EventEmitter } from "node:events";
 import { Server as Server$1, ServerOptions as ServerOptions$1 } from "node:https";
 import * as net from "node:net";
@@ -9918,12 +9919,7 @@ interface PluginHookUtils {
 type ResolveFn = (id: string, importer?: string, aliasOnly?: boolean, ssr?: boolean) => Promise<string | undefined>;
 //#endregion
 //#region src/vite.d.ts
-interface IlhaPagesOptions {
-  /** Directory containing page files. Default: `src/pages` */
-  dir?: string;
-  /** Output path for the generated routes + registry file. Default: `.ilha/routes.ts` */
-  generated?: string;
-}
+/** Vite plugin — use via `@ilha/router/vite`. */
 declare function pages(options?: IlhaPagesOptions): Plugin;
 //#endregion
-export { type AppError, type ErrorHandler, IlhaPagesOptions, type LayoutHandler, type RouteSnapshot, pages, wrapError, wrapLayout };
+export { type AppError, type ErrorHandler, type IlhaPagesOptions, type LayoutHandler, type RouteSnapshot, ilhaPages, pages, wrapError, wrapLayout };

package/dist/vite.js

@@ -1,334 +1,9 @@
-import { C as wrapError, w as wrapLayout } from "./src-BBvRqv3b.js";
-import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
-import { basename, dirname, extname, join, relative, resolve } from "node:path";
+import { C as wrapError, w as wrapLayout } from "./src-0cb8FYdn.js";
+import { t as ilhaPages } from "./plugin-DAk44om0.js";
 //#region src/vite.ts
-/** Files that should never be treated as pages even if they match the ts/tsx extension. */
-const EXCLUDED_RE = /\.(test|spec|d)\.(ts|tsx)$/;
-/**
-* Match a top-of-statement `export const load`, `export let load`,
-* `export function load`, or `export async function load`. Intentionally
-* conservative: `export { load } from "./x"` re-exports are NOT detected
-* in v1. Declare `load` directly in the file to be picked up.
-*/
-const LOADER_EXPORT_RE = /^\s*export\s+(?:const|let|var|async\s+function|function)\s+load\b/m;
-async function hasLoaderExport(file) {
-	try {
-		const stripped = (await readFile(file, "utf8")).replace(/^\s*\/\/.*$/gm, "");
-		return LOADER_EXPORT_RE.test(stripped);
-	} catch {
-		return false;
-	}
-}
-function fileToSegment(name) {
-	if (name.startsWith("[...") && name.endsWith("]")) return `**:${name.slice(4, -1)}`;
-	if (name.startsWith("[") && name.endsWith("]")) return `:${name.slice(1, -1)}`;
-	return name;
-}
-/** Route-group directories like "(auth)" are transparent to the URL. */
-function dirToSegment(name) {
-	if (name.startsWith("(") && name.endsWith(")")) return "";
-	return fileToSegment(name);
-}
-function fileToPattern(pagesDir, file) {
-	const rel = relative(pagesDir, file);
-	const parts = rel.slice(0, -extname(rel).length).split("/");
-	const segments = [...parts.slice(0, -1).map(dirToSegment), fileToSegment(parts.at(-1))];
-	if (segments.at(-1) === "index") segments.pop();
-	return "/" + segments.filter(Boolean).join("/") || "/";
-}
-function patternToName(pattern) {
-	if (pattern === "/") return "index";
-	return pattern.replace(/^\//, "").replace(/\*\*:[^/]*/g, (m) => m.length > 3 ? m.slice(3) : "wildcard").replace(/:/g, "").replace(/\*\*/g, "wildcard").replace(/\//g, "-").replace(/[^a-zA-Z0-9-]/g, "") || "page";
-}
-function specificityScore(pattern) {
-	if (pattern === "/") return 3;
-	if (pattern.includes("**")) return 0;
-	if (pattern.includes(":")) return 1;
-	return 2;
-}
-/** Deterministic sort: by specificity desc, then by segment count desc, then alphabetical. */
-function sortEntries(entries) {
-	return [...entries].sort((a, b) => {
-		const specDiff = specificityScore(b.pattern) - specificityScore(a.pattern);
-		if (specDiff !== 0) return specDiff;
-		const segDiff = b.pattern.split("/").length - a.pattern.split("/").length;
-		if (segDiff !== 0) return segDiff;
-		return a.pattern.localeCompare(b.pattern);
-	});
-}
-function chainForFile(pagesDir, file, all, sentinel) {
-	const relDir = relative(pagesDir, dirname(file));
-	const parts = relDir === "" ? [] : relDir.split("/");
-	const dirs = [pagesDir, ...parts.map((_, i) => join(pagesDir, ...parts.slice(0, i + 1)))];
-	const candidatesFor = (dir) => {
-		const tsx = `${join(dir, sentinel)}.tsx`;
-		if (all.has(tsx)) return [tsx];
-		const ts = `${join(dir, sentinel)}.ts`;
-		if (all.has(ts)) return [ts];
-		return [];
-	};
-	return dirs.flatMap(candidatesFor);
-}
-const MAX_SCAN_DEPTH = 20;
-async function collectFiles(dir, depth = 0) {
-	if (depth > MAX_SCAN_DEPTH) {
-		console.warn(`[ilha:pages] Max scan depth (${MAX_SCAN_DEPTH}) reached at ${dir} — skipping`);
-		return [];
-	}
-	const results = [];
-	for (const entry of await readdir(dir, { withFileTypes: true })) {
-		const full = join(dir, entry.name);
-		if (entry.isDirectory()) results.push(...await collectFiles(full, depth + 1));
-		else if (entry.isFile() && /\.(ts|tsx)$/.test(entry.name) && !EXCLUDED_RE.test(entry.name)) results.push(full);
-	}
-	return results;
-}
-async function scanPages(pagesDir) {
-	const all = await collectFiles(pagesDir);
-	const allSet = new Set(all);
-	const pages = all.filter((f) => !basename(f).startsWith("+"));
-	const layoutLoaderCache = /* @__PURE__ */ new Map();
-	const getLayoutHasLoader = (file) => {
-		let cached = layoutLoaderCache.get(file);
-		if (!cached) {
-			cached = hasLoaderExport(file);
-			layoutLoaderCache.set(file, cached);
-		}
-		return cached;
-	};
-	return Promise.all(pages.map(async (file) => {
-		const pattern = fileToPattern(pagesDir, file);
-		const layouts = chainForFile(pagesDir, file, allSet, "+layout");
-		const errors = chainForFile(pagesDir, file, allSet, "+error");
-		const [pageHasLoader, ...layoutFlags] = await Promise.all([hasLoaderExport(file), ...layouts.map(getLayoutHasLoader)]);
-		const loaderLayouts = layouts.filter((_, i) => layoutFlags[i]);
-		return {
-			file,
-			pattern,
-			name: patternToName(pattern),
-			layouts,
-			errors,
-			hasLoader: pageHasLoader,
-			loaderLayouts
-		};
-	}));
-}
-function validateEntries(entries, pagesDir) {
-	if (entries.length === 0) {
-		console.warn(`[ilha:pages] No pages found in ${pagesDir}`);
-		return;
-	}
-	const seenPatterns = /* @__PURE__ */ new Map();
-	const seenNames = /* @__PURE__ */ new Map();
-	for (const entry of entries) {
-		const existingPattern = seenPatterns.get(entry.pattern);
-		if (existingPattern) console.warn(`[ilha:pages] Duplicate route pattern "${entry.pattern}"\n  first:  ${existingPattern}\n  second: ${entry.file}\n  The first match wins — the second page will never be reached.`);
-		else seenPatterns.set(entry.pattern, entry.file);
-		const existingName = seenNames.get(entry.name);
-		if (existingName) console.warn(`[ilha:pages] Registry name collision: "${entry.name}" is used by both\n  ${existingName}\n  ${entry.file}\n  Hydration may not work correctly for one of these routes.`);
-		else seenNames.set(entry.name, entry.file);
-	}
-}
-async function generate(pagesDir, outFile) {
-	const entries = sortEntries(await scanPages(pagesDir));
-	validateEntries(entries, pagesDir);
-	const rel = (abs) => {
-		const r = relative(dirname(outFile), abs);
-		return r.startsWith(".") ? r : `./${r}`;
-	};
-	const imports = [`import { router, wrapLayout, wrapError } from "@ilha/router";`, `import type { Island } from "ilha";`];
-	const wrappedIslandLines = [];
-	const registryLines = [];
-	const routeLines = [];
-	const clientImport = (abs) => `${rel(abs)}?client`;
-	for (const [i, entry] of entries.entries()) {
-		const pageId = `_page${i}`;
-		imports.push(`import { default as ${pageId} } from ${JSON.stringify(clientImport(entry.file))};`);
-		for (const [j, l] of entry.layouts.entries()) imports.push(`import { default as _layout${i}_${j} } from ${JSON.stringify(clientImport(l))};`);
-		for (const [j, e] of entry.errors.entries()) imports.push(`import { default as _error${i}_${j} } from ${JSON.stringify(clientImport(e))};`);
-		let expr = pageId;
-		for (let j = entry.errors.length - 1; j >= 0; j--) expr = `wrapError(_error${i}_${j}, ${expr})`;
-		for (let j = entry.layouts.length - 1; j >= 0; j--) expr = `wrapLayout(_layout${i}_${j}, ${expr})`;
-		const wrappedId = `_wrapped${i}`;
-		wrappedIslandLines.push(`const ${wrappedId} = ${expr};`);
-		registryLines.push(`  ${JSON.stringify(entry.name)}: ${wrappedId}` + (i < entries.length - 1 ? "," : ""));
-		routeLines.push(`  .route(${JSON.stringify(entry.pattern)}, ${wrappedId})`);
-	}
-	const code = [
-		`// @generated by @ilha/router — do not edit`,
-		``,
-		...imports,
-		``,
-		...wrappedIslandLines,
-		``,
-		`export const registry: Record<string, Island<any, any>> = {`,
-		...registryLines,
-		`};`,
-		``,
-		`export const pageRouter = router()`,
-		...routeLines,
-		`  ;`
-	].join("\n");
-	await mkdir(dirname(outFile), { recursive: true });
-	const routesChanged = await writeIfChanged(outFile, code);
-	const loadersFile = join(dirname(outFile), "loaders.ts");
-	const loadersChanged = await writeIfChanged(loadersFile, buildLoadersFile(entries, loadersFile, outFile));
-	if (routesChanged || loadersChanged) await generateTypes(outFile);
-}
-function buildLoadersFile(entries, loadersFile, routesFile) {
-	const relFromLoaders = (abs) => {
-		const r = relative(dirname(loadersFile), abs);
-		return r.startsWith(".") ? r : `./${r}`;
-	};
-	const withLoaders = entries.filter((e) => e.hasLoader || e.loaderLayouts.length > 0);
-	if (withLoaders.length === 0) return [
-		`// @generated by @ilha/router — do not edit`,
-		`// This project has no loader exports; this file is intentionally empty.`,
-		``,
-		`export {};`,
-		``
-	].join("\n");
-	const routesRel = relFromLoaders(routesFile).replace(/\.ts$/, "");
-	const imports = [`import { pageRouter } from ${JSON.stringify(routesRel)};`];
-	let needsComposeLoaders = false;
-	const attachLines = [];
-	for (const [i, entry] of withLoaders.entries()) {
-		const loaderIds = [];
-		for (const [j, layout] of entry.loaderLayouts.entries()) {
-			const id = `_p${i}_l${j}`;
-			imports.push(`import { load as ${id} } from ${JSON.stringify(relFromLoaders(layout))};`);
-			loaderIds.push(id);
-		}
-		if (entry.hasLoader) {
-			const id = `_p${i}`;
-			imports.push(`import { load as ${id} } from ${JSON.stringify(relFromLoaders(entry.file))};`);
-			loaderIds.push(id);
-		}
-		const loadersExpr = loaderIds.length === 1 ? loaderIds[0] : `composeLoaders([${loaderIds.join(", ")}])`;
-		if (loaderIds.length > 1) needsComposeLoaders = true;
-		attachLines.push(`pageRouter.attachLoader(${JSON.stringify(entry.pattern)}, ${loadersExpr});`);
-	}
-	if (needsComposeLoaders) imports.unshift(`import { composeLoaders } from "@ilha/router";`);
-	return [
-		`// @generated by @ilha/router — do not edit`,
-		`// Server-only. Import this module from your SSR entry to wire loaders`,
-		`// onto pageRouter. Importing it from the client is a no-op but wastes`,
-		`// bundle size — rely on the default build pipeline to keep it out.`,
-		``,
-		...imports,
-		``,
-		...attachLines,
-		``
-	].join("\n");
-}
-async function writeIfChanged(file, content) {
-	try {
-		if (await readFile(file, "utf8") === content) return false;
-	} catch {}
-	await writeFile(file, content, "utf8");
-	return true;
-}
-async function generateTypes(outFile) {
-	await writeIfChanged(outFile.replace(/\.ts$/, ".d.ts"), [
-		`// @generated by @ilha/router — do not edit`,
-		``,
-		`declare module "ilha:pages" {`,
-		`  import type { RouterBuilder } from "@ilha/router";`,
-		`  export const pageRouter: RouterBuilder;`,
-		`}`,
-		``,
-		`declare module "ilha:registry" {`,
-		`  import type { Island } from "ilha";`,
-		`  export const registry: Record<string, Island<any, any>>;`,
-		`}`,
-		``,
-		`declare module "ilha:loaders" {`,
-		`  // Side-effect-only module. Importing it attaches loaders to pageRouter.`,
-		`}`,
-		``
-	].join("\n"));
-}
-const VIRTUAL_PAGES = "ilha:pages";
-const VIRTUAL_REGISTRY = "ilha:registry";
-const VIRTUAL_LOADERS = "ilha:loaders";
-const RESOLVED_PAGES = "\0ilha:pages";
-const RESOLVED_REGISTRY = "\0ilha:registry";
-const RESOLVED_LOADERS = "\0ilha:loaders";
-/** Query suffix used on page/layout imports in the client-safe routes file. */
-const CLIENT_QUERY = "?client";
+/** Vite plugin — use via `@ilha/router/vite`. */
 function pages(options = {}) {
-	let pagesDir;
-	let outFile;
-	let loadersFile;
-	async function regen() {
-		try {
-			await generate(pagesDir, outFile);
-		} catch (e) {
-			console.error("[ilha:pages] codegen failed:", e);
-		}
-	}
-	return {
-		name: "ilha:pages",
-		configResolved(config) {
-			pagesDir = resolve(config.root, options.dir ?? "src/pages");
-			outFile = resolve(config.root, options.generated ?? ".ilha/routes.ts");
-			loadersFile = join(dirname(outFile), "loaders.ts");
-		},
-		async buildStart() {
-			await regen();
-		},
-		configureServer(server) {
-			server.watcher.add(pagesDir);
-			const structuralInvalidate = async (file) => {
-				if (!file.startsWith(pagesDir)) return;
-				await regen();
-				for (const id of [
-					RESOLVED_PAGES,
-					RESOLVED_REGISTRY,
-					RESOLVED_LOADERS
-				]) {
-					const mod = server.moduleGraph.getModuleById(id);
-					if (mod) server.moduleGraph.invalidateModule(mod);
-				}
-				server.hot.send({ type: "full-reload" });
-			};
-			server.watcher.on("add", structuralInvalidate);
-			server.watcher.on("addDir", structuralInvalidate);
-			server.watcher.on("unlink", structuralInvalidate);
-			server.watcher.on("change", async (file) => {
-				if (!file.startsWith(pagesDir)) return;
-				const base = basename(file);
-				if (base.startsWith("+") || /\.(ts|tsx)$/.test(base)) await structuralInvalidate(file);
-			});
-		},
-		resolveId(id, importer) {
-			if (id === VIRTUAL_PAGES) return RESOLVED_PAGES;
-			if (id === VIRTUAL_REGISTRY) return RESOLVED_REGISTRY;
-			if (id === VIRTUAL_LOADERS) return RESOLVED_LOADERS;
-			if (id.endsWith(CLIENT_QUERY)) {
-				const bare = id.slice(0, -7);
-				return (importer ? resolve(dirname(importer.replace(/\?.*$/, "")), bare) : resolve(bare)) + CLIENT_QUERY;
-			}
-		},
-		load(id) {
-			if (id === RESOLVED_PAGES) {
-				const spec = outFile.replace(/\.tsx?$/, "");
-				return `export { pageRouter } from ${JSON.stringify(spec)};`;
-			}
-			if (id === RESOLVED_REGISTRY) {
-				const spec = outFile.replace(/\.tsx?$/, "");
-				return `export { registry } from ${JSON.stringify(spec)};`;
-			}
-			if (id === RESOLVED_LOADERS) {
-				const spec = loadersFile.replace(/\.tsx?$/, "");
-				return `import ${JSON.stringify(spec)};`;
-			}
-			if (id.endsWith(CLIENT_QUERY)) {
-				const bare = id.slice(0, -7);
-				return `export { default } from ${JSON.stringify(bare)};`;
-			}
-		}
-	};
+	return ilhaPages.vite(options);
 }
 //#endregion
-export { pages, wrapError, wrapLayout };
+export { ilhaPages, pages, wrapError, wrapLayout };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ilha/router",
-  "version": "0.3.9",
+  "version": "0.4.1",
   "description": "A tiny SPA router for Ilha",
   "license": "MIT",
   "author": "Ryuz <ryuzer@proton.me>",
@@ -23,6 +23,14 @@
     "./vite": {
       "types": "./dist/vite.d.ts",
       "import": "./dist/vite.js"
+    },
+    "./rspack": {
+      "types": "./dist/rspack.d.ts",
+      "import": "./dist/rspack.js"
+    },
+    "./rolldown": {
+      "types": "./dist/rolldown.d.ts",
+      "import": "./dist/rolldown.js"
     }
   },
   "scripts": {
@@ -31,7 +39,8 @@
   },
   "dependencies": {
     "ilha": "0.7.0",
-    "rou3": "0.8.1"
+    "rou3": "0.8.1",
+    "unplugin": "3.0.0"
   },
   "devDependencies": {
     "vite": "^8.0.14"