@ilha/router 0.6.6 → 0.6.8

package/dist/codegen.d.ts

@@ -0,0 +1,21 @@
+export type PagesMode = "spa" | "static";
+export interface GenerateOptions {
+    /** Client navigation mode. Default: `spa`. */
+    mode?: PagesMode;
+    /**
+     * Whether to install client-side link interception. Only meaningful in `spa`
+     * mode. Default: `true`.
+     */
+    interceptLinks?: boolean;
+}
+/** Paths for all generated files derived from the base output directory. */
+export interface GeneratedPaths {
+    /** Server module: raw imports, full route graph. `ilha:pages/server` */
+    serverFile: string;
+    /** Client module: ?client imports, browser-optimised. `ilha:pages/client` */
+    clientFile: string;
+    /** Server-only loaders side-effect module. `ilha:loaders` */
+    loadersFile: string;
+}
+export declare function resolveGeneratedPaths(outDir: string): GeneratedPaths;
+export declare function generate(pagesDir: string, outDir: string, options?: GenerateOptions): Promise<void>;

package/dist/hash.d.ts

@@ -0,0 +1,44 @@
+export type HistoryMode = "history" | "hash";
+export interface LogicalLocation {
+    pathname: string;
+    search: string;
+    hash: string;
+}
+export interface HistoryAdapter {
+    /** Read the current logical URL (the one routes are matched against). */
+    readLocation(): LogicalLocation;
+    /** Push a new logical URL onto the history stack. */
+    push(to: string): void;
+    /** Replace the current history entry with a new logical URL. */
+    replace(to: string): void;
+    /** Subscribe to logical-URL changes. Returns a cleanup function. */
+    onChange(handler: () => void): () => void;
+    /**
+     * Convert a logical href (what the user writes, e.g. "/users/42") into
+     * the actual DOM href attribute (e.g. "#/users/42" in hash mode).
+     */
+    toLinkHref(logicalPath: string): string;
+    /**
+     * Extract a logical path from an `<a>` element. Returns null when the
+     * link is not an in-app navigation target (external, anchor-only, etc).
+     * The caller still applies modifier-key / target=_blank checks.
+     */
+    extractLogicalPath(anchor: HTMLAnchorElement): string | null;
+}
+/**
+ * Set the router's history mode. Call this once at app entry, before
+ * mounting any router. Defaults to "history" (HTML5 History API).
+ *
+ * Use "hash" when the document is loaded over file:// (Electron, Tauri, etc.)
+ * or any time there's no server able to serve a SPA fallback at arbitrary
+ * pathnames.
+ *
+ * Switching modes mid-session is supported but not common — listeners
+ * registered before the switch will keep using their original adapter
+ * until they're re-attached (typically by unmounting and remounting
+ * the router).
+ */
+export declare function setHistoryMode(mode: HistoryMode): void;
+export declare function getHistoryMode(): HistoryMode;
+/** Internal — used by index.ts. Not part of the public API. */
+export declare function getAdapter(): HistoryAdapter;

package/dist/index.d.ts

@@ -1,2 +1,341 @@
-import { A as loader, B as useRoute, C as RouterView, D as enableLinkInterception, E as defineLayout, F as routeHash, G as setHistoryMode, H as wrapLayout, I as routeParams, L as routePath, M as prefetch, N as prime, O as error, P as redirect, R as routeSearch, S as RouterOptions, T as composeLoaders, U as HistoryMode, V as wrapError, W as getHistoryMode, _ 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 navigate, k as isActive, 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 _default, x as RouterMode, y as RouterBuilder, z as router } from "./index-DZA_1KrG.js";
-export { AppError, ErrorHandler, HistoryMode, HydratableRenderOptions, HydrateOptions, InferLoader, LOADER_ENDPOINT, LayoutHandler, LinkInterceptionOptions, Loader, LoaderContext, LoaderError, MergeLoaders, MountOptions, NavigateOptions, Redirect, RenderResponse, RouteRecord, RouteSnapshot, RouterBuilder, RouterLink, RouterMode, RouterOptions, RouterView, composeLoaders, _default as default, defineLayout, enableLinkInterception, error, getHistoryMode, isActive, loader, navigate, prefetch, prime, redirect, routeHash, routeParams, routePath, routeSearch, router, setHistoryMode, useRoute, wrapError, wrapLayout };
+import type { Island, HydratableOptions } from "ilha";
+export { setHistoryMode, getHistoryMode } from "./hash";
+export type { HistoryMode } from "./hash";
+export interface RouteRecord {
+    pattern: string;
+    island: Island<any, any>;
+    /** Merged loader chain (layouts outer→inner, then page) — `undefined` if no loaders. */
+    loader?: Loader<any>;
+    /** True when the route has a server-side loader, even if the client only has a marker. */
+    hasLoader?: boolean;
+}
+export interface RouteSnapshot {
+    path: string;
+    params: Record<string, string>;
+    search: string;
+    hash: string;
+}
+export interface AppError {
+    message: string;
+    status?: number;
+    stack?: string;
+}
+export type LayoutHandler = (children: Island<any, any>) => Island<any, any>;
+export type ErrorHandler = (error: AppError, route: RouteSnapshot) => Island<any, any>;
+/**
+ * Serializable description of `<head>` (and html/body attributes) contributed
+ * by a loader or a render-time `head()` call. Deliberately a plain POJO — Tier
+ * 1 head management is SSR-only, so there is no reactive wrapper. Dedup keys
+ * mirror unhead so a later move to a runtime head manager stays a drop-in.
+ */
+export interface HeadInput {
+    title?: string;
+    /** Wrap the resolved title. The last template in merge order wins. */
+    titleTemplate?: string | ((title?: string) => string);
+    meta?: Array<Record<string, string>>;
+    link?: Array<Record<string, string>>;
+    /**
+     * Inline script bodies are emitted raw in SSR (`serializeHead`). Must be trusted
+     * app code and must not contain a literal `</script>` sequence.
+     */
+    script?: Array<Record<string, string> & {
+        children?: string;
+    }>;
+    htmlAttrs?: Record<string, string>;
+    bodyAttrs?: Record<string, string>;
+}
+/** Serialized head fragments ready to inject into a document shell. */
+export interface SerializedHead {
+    /** Markup for inside `<head>` (title, meta, link, script). */
+    headTags: string;
+    /** Attribute string for the `<html>` tag (leading space included). */
+    htmlAttrs: string;
+    /** Attribute string for the `<body>` tag (leading space included). */
+    bodyAttrs: string;
+}
+export interface LoaderContext {
+    params: Record<string, string>;
+    request: Request;
+    url: URL;
+    signal: AbortSignal;
+    /** Contribute `<head>` data for this route. Safe to call multiple times. */
+    head: (input: HeadInput) => void;
+}
+export type Loader<T> = (ctx: LoaderContext) => Promise<T> | T;
+/**
+ * Identity function for declaring a loader. Exists purely as a type anchor and
+ * a marker for the Vite plugin to detect by export name.
+ */
+export declare function loader<T>(fn: Loader<T>): Loader<T>;
+/** Extract the return type of a loader. */
+export type InferLoader<L> = L extends Loader<infer T> ? Awaited<T> : never;
+/**
+ * Merge multiple loader return types into a single object type.
+ * Later loaders override earlier ones on key collision — matching runtime merge.
+ *
+ * @example
+ * type PageInput = MergeLoaders<[typeof rootLayoutLoad, typeof sectionLayoutLoad, typeof pageLoad]>;
+ */
+export type MergeLoaders<Ls extends readonly Loader<any>[]> = Ls extends readonly [
+    infer First extends Loader<any>,
+    ...infer Rest extends readonly Loader<any>[]
+] ? Rest extends readonly [] ? InferLoader<First> : Omit<InferLoader<First>, keyof MergeLoaders<Rest>> & MergeLoaders<Rest> : {};
+export declare class Redirect {
+    readonly __ilhaRedirect: true;
+    readonly to: string;
+    readonly status: number;
+    constructor(to: string, status?: number);
+}
+export declare class LoaderError {
+    readonly __ilhaLoaderError: true;
+    readonly status: number;
+    readonly message: string;
+    constructor(status: number, message: string);
+}
+export declare function redirect(to: string, status?: number): never;
+export declare function error(status: number, message: string): never;
+/**
+ * Compose a list of loaders into a single loader. Later loaders win on key
+ * collision (page loader overrides layout loader for the same key). All loaders
+ * run concurrently within a chain since they share the same abort signal and
+ * request — re-fetching is cheap with a request-scoped cache (future work).
+ *
+ * For v1 we run them in parallel via `Promise.all`. If a loader throws a
+ * `Redirect` or `LoaderError`, the composed loader re-throws it unchanged.
+ */
+export declare function composeLoaders<Ls extends readonly Loader<any>[]>(loaders: Ls): Loader<MergeLoaders<Ls>>;
+export declare function wrapLayout(layout: LayoutHandler, page: Island<any, any>): Island<any, any>;
+export declare function wrapError(handler: ErrorHandler, page: Island<any, any>): Island<any, any>;
+export declare function defineLayout(layout: LayoutHandler): LayoutHandler;
+export interface NavigateOptions {
+    replace?: boolean;
+}
+export type RouterMode = "spa" | "static";
+export interface RouterOptions {
+    /**
+     * Client navigation mode.
+     * - `spa` — full route graph, SSR/hydration, client-side navigation.
+     * - `static` — no route graph bundled; hydrate islands on the current
+     *   pre-rendered page only.
+     * Default: `spa`.
+     */
+    mode?: RouterMode;
+    /**
+     * When `true` (default), internal `<a>` clicks are intercepted and handled
+     * by the client router. Set to `false` for MPA-style behavior where links
+     * perform full document navigations.
+     * Only meaningful in `spa` mode; ignored in `static` mode.
+     * Default: `true`.
+     */
+    interceptLinks?: boolean;
+}
+export interface HydratableRenderOptions extends Partial<Omit<HydratableOptions, "name">> {
+    /**
+     * Base `<head>` data merged before loader and render-time contributions, so
+     * route-level head overrides it. Used by host entries (e.g. `IlhaHandler`)
+     * to supply app-wide title/meta/scripts.
+     */
+    baseHead?: HeadInput;
+}
+export interface HydrateOptions {
+    root?: Element;
+    target?: string | Element;
+    /**
+     * When `true` (default), internal `<a>` clicks are intercepted for
+     * client-side navigation. Set to `false` for MPA-style full-page navigations.
+     */
+    interceptLinks?: boolean;
+}
+export interface MountOptions {
+    hydrate?: boolean;
+    registry?: Record<string, Island<any, any>>;
+    /**
+     * When `true` (default), internal `<a>` clicks are intercepted for
+     * client-side navigation. Set to `false` for MPA-style full-page navigations.
+     */
+    interceptLinks?: boolean;
+}
+/** Response envelope returned by `renderResponse` — lets the host app handle redirects. */
+export type RenderResponse = {
+    kind: "html";
+    html: string;
+    status?: number;
+    head?: SerializedHead;
+} | {
+    kind: "redirect";
+    to: string;
+    status: number;
+} | {
+    kind: "error";
+    status: number;
+    message: string;
+    html: string;
+    head?: SerializedHead;
+};
+export interface RouterBuilder {
+    /**
+     * Register a route. The optional `loader` is the merged loader chain
+     * (layout loaders outer→inner followed by the page loader) produced by
+     * the FS-routing codegen.
+     */
+    route(pattern: string, island: Island<any, any>, loader?: Loader<any>): RouterBuilder;
+    /**
+     * Attach (or replace) a loader on an already-registered route pattern.
+     * Used by the `ilha:loaders` virtual module to wire server-only loaders
+     * onto the client-safe `pageRouter` at SSR time. No-op if the pattern
+     * was never registered via `.route()`.
+     */
+    attachLoader(pattern: string, loader: Loader<any>): RouterBuilder;
+    /**
+     * Mark an already-registered route as having a server-side loader without
+     * importing that loader into the client bundle. Used by FS-routing codegen
+     * so SPA navigation knows to call the loader endpoint.
+     */
+    markLoader(pattern: string): 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;
+    renderHydratable(url: string | URL, registry: Record<string, Island<any, any>>, options?: HydratableRenderOptions, request?: Request): Promise<string>;
+    /**
+     * Like `renderHydratable` but surfaces loader redirects and errors as
+     * structured responses instead of baking them into HTML. Prefer this from
+     * host server code so you can emit proper 302 / 4xx responses.
+     */
+    renderResponse(url: string | URL, registry: Record<string, Island<any, any>>, options?: HydratableRenderOptions, request?: Request): Promise<RenderResponse>;
+    /**
+     * Run the loader chain for a given URL without rendering. Backs the
+     * `/__ilha/loader` endpoint that the host server handler (e.g. `IlhaHandler`)
+     * serves as JSON for client-side navigation. Returns the raw loader result, a
+     * redirect sentinel, or an error sentinel.
+     */
+    runLoader(url: string | URL, request?: Request): Promise<{
+        kind: "data";
+        data: Record<string, unknown>;
+        head?: SerializedHead;
+    } | {
+        kind: "redirect";
+        to: string;
+        status: number;
+    } | {
+        kind: "error";
+        status: number;
+        message: string;
+    } | {
+        kind: "not-found";
+    }>;
+    /**
+     * Hydrate the application - combines prime(), mount(), and router.mount() into one call.
+     * @param registry - The island registry from ilha:registry
+     * @param options - Optional root element (defaults to document.body) and router target (defaults to root)
+     * @returns Cleanup function
+     */
+    hydrate(registry: Record<string, Island<any, any>>, options?: HydrateOptions): () => void;
+    /**
+     * Hydrate islands on the current pre-rendered page without mounting a route
+     * view or enabling client navigation. Intended for `static` mode: each page
+     * is a self-contained HTML file; only interactive islands need activation.
+     */
+    hydrateStatic(registry: Record<string, Island<any, any>>, options?: {
+        root?: Element;
+    }): () => void;
+}
+/** Path of the loader endpoint served by the Vite plugin / production adapter. */
+export declare const LOADER_ENDPOINT = "/__ilha/loader";
+/**
+ * Prefetch loader data for a given path. Safe to call repeatedly — a single
+ * inflight request is reused until it either resolves (and is consumed by
+ * navigation) or is superseded by another prefetch.
+ */
+export declare function prefetch(pathWithSearch: string): void;
+export declare const routePath: {
+    (): string;
+    (value: string): void;
+};
+export declare const routeParams: {
+    (): Record<string, string>;
+    (value: Record<string, string>): void;
+};
+export declare const routeSearch: {
+    (): string;
+    (value: string): void;
+};
+export declare const routeHash: {
+    (): string;
+    (value: string): void;
+};
+export declare function useRoute(): {
+    path: {
+        (): string;
+        (value: string): void;
+    };
+    params: {
+        (): Record<string, string>;
+        (value: Record<string, string>): void;
+    };
+    search: {
+        (): string;
+        (value: string): void;
+    };
+    hash: {
+        (): string;
+        (value: string): void;
+    };
+};
+/**
+ * Prime route context signals from the current `location` so that islands
+ * hydrated by `ilha.mount()` see the correct route values on their first
+ * render — preventing a mismatch morph that would destroy hydrated bindings.
+ */
+export declare function prime(): void;
+export declare function navigate(to: string, opts?: NavigateOptions): void;
+export interface LinkInterceptionOptions {
+    /**
+     * Prefetch loader data on `mouseenter` for eligible links. Links opt in via
+     * the `data-prefetch` attribute (set `data-prefetch="false"` to opt out a
+     * specific link even when the framework is configured to prefetch by default).
+     * Default: `true` — prefetches on hover for any link with `data-prefetch`.
+     */
+    prefetch?: boolean;
+}
+export declare function enableLinkInterception(root?: Element | Document, options?: LinkInterceptionOptions): () => void;
+export declare const RouterView: Island<Record<string, unknown>, Record<never, never>>;
+export declare const RouterLink: Island<Record<string, unknown>, Omit<Omit<Record<never, never>, K> & Record<"href", string>, "label"> & Record<"label", string>>;
+export declare function isActive(pattern: string): boolean;
+/**
+ * Contribute `<head>` data from inside an island's `.render()` body or a
+ * layout. During SSR this collects into the active render window; on the
+ * client, entries are collected when the router re-renders a route inside
+ * `withHeadStore` and then applied to `document`. Prefer a loader's `ctx.head`
+ * for data that depends on the request.
+ */
+export declare function head(input: HeadInput): void;
+/**
+ * Merge head entries in contribution order (loader first as the base, then
+ * render-time outer→inner layouts, then the page) and serialize. Later entries
+ * win on collision; the last `titleTemplate` wraps the resolved title.
+ */
+export declare function serializeHead(entries: HeadInput[]): SerializedHead;
+export declare function router(options?: RouterOptions): RouterBuilder;
+declare const _default: {
+    router: typeof router;
+    navigate: typeof navigate;
+    useRoute: typeof useRoute;
+    isActive: typeof isActive;
+    enableLinkInterception: typeof enableLinkInterception;
+    prime: typeof prime;
+    prefetch: typeof prefetch;
+    RouterView: Island<Record<string, unknown>, Record<never, never>>;
+    RouterLink: Island<Record<string, unknown>, Omit<Omit<Record<never, never>, K> & Record<"href", string>, "label"> & Record<"label", string>>;
+    loader: typeof loader;
+    redirect: typeof redirect;
+    error: typeof error;
+    composeLoaders: typeof composeLoaders;
+    head: typeof head;
+};
+export default _default;

package/dist/index.js

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

package/dist/plugin-DBB11WaX.js

@@ -0,0 +1,6 @@
+import{existsSync as e,readFileSync as t,watch as n}from"node:fs";import{basename as r,dirname as i,extname as a,join as o,relative as s,resolve as c,sep as l}from"node:path";import{createUnplugin as u}from"unplugin";import{mkdir as d,readFile as f,readdir as p,writeFile as m}from"node:fs/promises";function h(e){return e.replace(/\\/g,`/`)}const g=/\.(test|spec|d)\.(ts|tsx)$/,_=/^\s*export\s+(?:const|let|var|async\s+function|function)\s+load\b/m;async function v(e){try{let t=(await f(e,`utf8`)).replace(/^\s*\/\/.*$/gm,``);return _.test(t)}catch{return!1}}function y(e){return e.startsWith(`[...`)&&e.endsWith(`]`)?`**:${e.slice(4,-1)}`:e.startsWith(`[`)&&e.endsWith(`]`)?`:${e.slice(1,-1)}`:e}function b(e){return e.startsWith(`(`)&&e.endsWith(`)`)?``:y(e)}function x(e,t){let n=h(s(e,t)),r=n.slice(0,-a(n).length).split(`/`),i=[...r.slice(0,-1).map(b),y(r.at(-1))];return i.at(-1)===`index`&&i.pop(),`/`+i.filter(Boolean).join(`/`)||`/`}function S(e){return e===`/`?`index`:e.replace(/^\//,``).replace(/\*\*:[^/]*/g,e=>e.length>3?e.slice(3):`wildcard`).replace(/:/g,``).replace(/\*\*/g,`wildcard`).replace(/\//g,`-`).replace(/[^a-zA-Z0-9-]/g,``)||`page`}function C(e){return e===`/`?3:e.includes(`**`)?0:e.includes(`:`)?1:2}function w(e){return[...e].sort((e,t)=>{let n=C(t.pattern)-C(e.pattern);if(n!==0)return n;let r=t.pattern.split(`/`).length-e.pattern.split(`/`).length;return r===0?e.pattern.localeCompare(t.pattern):r})}function T(e,t,n,r){let a=h(s(e,i(t))),c=a===``?[]:a.split(`/`);return[e,...c.map((t,n)=>o(e,...c.slice(0,n+1)))].flatMap(e=>{let t=`${o(e,r)}.tsx`;if(n.has(t))return[t];let i=`${o(e,r)}.ts`;return n.has(i)?[i]:[]})}async function E(e,t=0){if(t>20)return console.warn(`[ilha:pages] Max scan depth (20) reached at ${e} — skipping`),[];let n=[];try{for(let r of await p(e,{withFileTypes:!0})){let i=o(e,r.name);r.isDirectory()?n.push(...await E(i,t+1)):r.isFile()&&/\.(ts|tsx)$/.test(r.name)&&!g.test(r.name)&&n.push(i)}}catch(e){if(e.code===`ENOENT`)return[];throw e}return n}async function D(e){let t=await E(e),n=new Set(t),i=t.filter(e=>!r(e).startsWith(`+`)),a=new Map,o=e=>{let t=a.get(e);return t||(t=v(e),a.set(e,t)),t};return Promise.all(i.map(async t=>{let r=x(e,t),i=T(e,t,n,`+layout`),a=T(e,t,n,`+error`),[s,...c]=await Promise.all([v(t),...i.map(o)]),l=i.filter((e,t)=>c[t]);return{file:t,pattern:r,name:S(r),layouts:i,errors:a,hasLoader:s,loaderLayouts:l}}))}function O(e,t){if(e.length===0){console.warn(`[ilha:pages] No pages found in ${t}`);return}let n=new Map,r=new Map;for(let t of e){let e=n.get(t.pattern);e?console.warn(`[ilha:pages] Duplicate route pattern "${t.pattern}"\n  first:  ${e}\n  second: ${t.file}\n  The first match wins — the second page will never be reached.`):n.set(t.pattern,t.file);let i=r.get(t.name);i?console.warn(`[ilha:pages] Registry name collision: "${t.name}" is used by both\n  ${i}\n  ${t.file}\n  Hydration may not work correctly for one of these routes.`):r.set(t.name,t.file)}}function k(e){return{serverFile:o(e,`pages.server.ts`),clientFile:o(e,`pages.client.ts`),loadersFile:o(e,`loaders.ts`)}}async function A(e,t,n={}){let r=n.mode??`spa`,i=n.interceptLinks,a=r===`static`,o=w(await D(e));O(o,e),await d(t,{recursive:!0});let{serverFile:s,clientFile:c,loadersFile:l}=k(t),u=await P(s,j(o,s)),f=await P(c,M(o,c,{isStatic:a,interceptLinks:i}));a||await P(l,N(o,l,s)),(u||f)&&await F(t)}function j(e,t){let n=e=>{let n=h(s(i(t),e));return n.startsWith(`.`)?n:`./${n}`},r=[`import { router, wrapLayout, wrapError } from "@ilha/router";`,`import type { Island } from "ilha";`],a=[],o=[],c=[];for(let[t,i]of e.entries()){r.push(`import { default as _page${t} } from ${JSON.stringify(n(i.file))};`);for(let[e,a]of i.layouts.entries())r.push(`import { default as _layout${t}_${e} } from ${JSON.stringify(n(a))};`);for(let[e,a]of i.errors.entries())r.push(`import { default as _error${t}_${e} } from ${JSON.stringify(n(a))};`);let s=`_page${t}`;for(let e=i.errors.length-1;e>=0;e--)s=`wrapError(_error${t}_${e}, ${s})`;for(let e=i.layouts.length-1;e>=0;e--)s=`wrapLayout(_layout${t}_${e}, ${s})`;let l=`_wrapped${t}`;a.push(`const ${l} = ${s};`),o.push(`  ${JSON.stringify(i.name)}: ${l}`+(t<e.length-1?`,`:``)),c.push(`  .route(${JSON.stringify(i.pattern)}, ${l})`+(i.hasLoader||i.loaderLayouts.length>0?`.markLoader(${JSON.stringify(i.pattern)})`:``))}return[`// @generated by @ilha/router — do not edit`,`// Server module. Use for SSR and SSG/prerender.`,`// Import via: import { pageRouter, registry } from "ilha:pages/server";`,``,...r,``,...a,``,`export const registry: Record<string, Island<any, any>> = {`,...o,`};`,``,`export const pageRouter = router()`,...c,`  ;`].join(`
+`)}function M(e,t,n){let{isStatic:r,interceptLinks:a}=n,o=e=>{let n=h(s(i(t),e));return n.startsWith(`.`)?n:`./${n}`},c=e=>`${o(e)}?client`,l=r?[`import { router as _router, wrapLayout, wrapError } from "@ilha/router";`,`import type { Island } from "ilha";`]:[`import { router, wrapLayout, wrapError } from "@ilha/router";`,`import type { Island } from "ilha";`],u=[],d=[],f=[];for(let[t,n]of e.entries()){l.push(`import { default as _page${t} } from ${JSON.stringify(c(n.file))};`);for(let[e,r]of n.layouts.entries())l.push(`import { default as _layout${t}_${e} } from ${JSON.stringify(c(r))};`);for(let[e,r]of n.errors.entries())l.push(`import { default as _error${t}_${e} } from ${JSON.stringify(c(r))};`);let i=`_page${t}`;for(let e=n.errors.length-1;e>=0;e--)i=`wrapError(_error${t}_${e}, ${i})`;for(let e=n.layouts.length-1;e>=0;e--)i=`wrapLayout(_layout${t}_${e}, ${i})`;let a=`_wrapped${t}`;u.push(`const ${a} = ${i};`),d.push(`  ${JSON.stringify(n.name)}: ${a}`+(t<e.length-1?`,`:``)),r||f.push(`  .route(${JSON.stringify(n.pattern)}, ${a})`+(n.hasLoader||n.loaderLayouts.length>0?`.markLoader(${JSON.stringify(n.pattern)})`:``))}let p=r?`_router({ mode: "static" })`:`router(${a===!1?`{ interceptLinks: false }`:``})`,m=[`// @generated by @ilha/router — do not edit`,`// Client module. Use for browser hydration.`,`// Import via: import { pageRouter, registry } from "ilha:pages/client";`,``,...l,``,...u,``,`export const registry: Record<string, Island<any, any>> = {`,...d,`};`,``];return r?m.push(`export const pageRouter = ${p};`):m.push(`export const pageRouter = ${p}`,...f,`  ;`),m.join(`
+`)}function N(e,t,n){let r=e=>{let n=h(s(i(t),e));return n.startsWith(`.`)?n:`./${n}`},a=e.filter(e=>e.hasLoader||e.loaderLayouts.length>0);if(a.length===0)return[`// @generated by @ilha/router — do not edit`,`// This project has no loader exports; this file is intentionally empty.`,``,`export {};`,``].join(`
+`);let o=r(n).replace(/\.tsx?$/,``),c=[`import { pageRouter } from ${JSON.stringify(o)};`],l=!1,u=[];for(let[e,t]of a.entries()){let n=[];for(let[i,a]of t.loaderLayouts.entries()){let t=`_p${e}_l${i}`;c.push(`import { load as ${t} } from ${JSON.stringify(r(a))};`),n.push(t)}if(t.hasLoader){let i=`_p${e}`;c.push(`import { load as ${i} } from ${JSON.stringify(r(t.file))};`),n.push(i)}let i=n.length===1?n[0]:`composeLoaders([${n.join(`, `)}])`;n.length>1&&(l=!0),u.push(`pageRouter.attachLoader(${JSON.stringify(t.pattern)}, ${i});`)}return l&&c.unshift(`import { composeLoaders } from "@ilha/router";`),[`// @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.`,``,...c,``,...u,``].join(`
+`)}async function P(e,t){try{if(await f(e,`utf8`)===t)return!1}catch{}return await m(e,t,`utf8`),!0}async function F(e){await P(o(e,`pages.d.ts`),[`// @generated by @ilha/router — do not edit`,``,`declare module "ilha:pages/server" {`,`  import type { RouterBuilder } from "@ilha/router";`,`  import type { Island } from "ilha";`,`  export const pageRouter: RouterBuilder;`,`  export const registry: Record<string, Island<any, any>>;`,`}`,``,`declare module "ilha:pages/client" {`,`  import type { RouterBuilder } from "@ilha/router";`,`  import type { Island } from "ilha";`,`  export const pageRouter: RouterBuilder;`,`  export const registry: Record<string, Island<any, any>>;`,`}`,``,`declare module "ilha:loaders" {`,`  // Side-effect-only module. Importing it attaches loaders to pageRouter.`,`}`,``].join(`
+`))}const I=`\0ilha:pages/server`,L=`\0ilha:pages/client`,R=`\0ilha:loaders`,z=[I,L,R];function B(e){try{return JSON.parse(t(e,`utf8`))}catch{return null}}function V(t,n){let r=t;for(;;){let t=o(r,`node_modules`,n,`package.json`);if(e(t))return B(t);let a=i(r);if(a===r)return null;r=a}}function H(e){let t=B(o(e,`package.json`));if(!t)return[];let n={...t.dependencies??{},...t.devDependencies??{}},r=[];for(let t of Object.keys(n)){if(t===`ilha`)continue;let n=V(e,t);if(!n)continue;let i=n.peerDependencies??{},a=n.dependencies??{};(`ilha`in i||`ilha`in a)&&r.push(t)}return r}function U(e,t){let n=c(e,t.dir??`src/pages`),r=c(e,t.outDir??`.ilha`),{serverFile:i,clientFile:a,loadersFile:o}=k(r);return{pagesDir:n,outDir:r,serverFile:i,clientFile:a,loadersFile:o}}function W(e){let t,n,i,a,o,s=r=>{({pagesDir:t,outDir:n,serverFile:i,clientFile:a,loadersFile:o}=U(r,e))},c=async()=>{try{await A(t,n,{mode:e.mode,interceptLinks:e.interceptLinks})}catch(e){console.error(`[ilha:pages] codegen failed:`,e)}},u=e=>e===t||e.startsWith(t+l);return{get pagesDir(){return t},get outDir(){return n},get serverFile(){return i},get clientFile(){return a},get loadersFile(){return o},setPaths:s,regen:c,shouldRegenOnChange:e=>{if(!u(e))return!1;let t=r(e);return t.startsWith(`+`)||/\.(ts|tsx)$/.test(t)},isUnderPagesDir:u}}async function G(e,t,n){n(t)&&await e.regen()}function K(e,t,n){if(t===`ilha:pages/server`)return I;if(t===`ilha:pages/client`)return L;if(t===`ilha:loaders`)return R;if(t.endsWith(`?client`)){let e=t.slice(0,-7);return(n?c(n.replace(/\?.*$/,``),`..`,e):c(e))+`?client`}}function q(e,t){if(t===`\0ilha:pages/server`){let t=e.serverFile.replace(/\.tsx?$/,``);return`export { pageRouter, registry } from ${JSON.stringify(t)};`}if(t===`\0ilha:pages/client`){let t=e.clientFile.replace(/\.tsx?$/,``);return`export { pageRouter, registry } from ${JSON.stringify(t)};`}if(t===`\0ilha:loaders`){let t=e.loadersFile.replace(/\.tsx?$/,``);return`import ${JSON.stringify(t)};`}if(t.endsWith(`?client`)){let e=t.slice(0,-7);return`export { default } from ${JSON.stringify(e)};`}}function J(e,t){return async n=>{e.isUnderPagesDir(n)&&(await e.regen(),await t())}}function Y(e,t){let r=n(e.pagesDir,{recursive:!0},(n,r)=>{r&&t(o(e.pagesDir,r))});return()=>r.close()}const X=u((e={})=>{let t=W(e);return{name:`ilha:pages`,async buildStart(){t.pagesDir||t.setPaths(process.cwd()),this.addWatchFile?.(t.pagesDir),await t.regen()},async watchChange(e){await G(t,e,e=>t.shouldRegenOnChange(e))},resolveId(e,n){return K(t,e,n)},load(e){return q(t,e)},vite:{config(e){let t=[`ilha`,`@ilha/store`,`@ilha/router`,`alien-signals`,...H(e.root?c(e.root):process.cwd())],n=e.ssr?.noExternal,r=n===!0?!0:[...new Set([...Array.isArray(n)?n:n==null?[]:[n],...t])];return{resolve:{dedupe:[...new Set([...e.resolve?.dedupe??[],...t])]},ssr:{noExternal:r},optimizeDeps:{...e.optimizeDeps,include:[...new Set([...e.optimizeDeps?.include??[],`ilha`,`ilha/jsx-runtime`,`ilha/jsx-dev-runtime`,`@ilha/store`,`alien-signals`])]}}},configResolved(e){t.setPaths(e.root)},configureServer(e){e.watcher.add(t.pagesDir);let n=J(t,async()=>{for(let t of z){let n=e.moduleGraph.getModuleById(t);n&&e.moduleGraph.invalidateModule(n)}e.hot.send({type:`full-reload`})});e.watcher.on(`add`,n),e.watcher.on(`addDir`,n),e.watcher.on(`unlink`,n),e.watcher.on(`change`,async e=>{t.shouldRegenOnChange(e)&&await n(e)})}},rspack(e){t.setPaths(e.options.context??process.cwd());let n=J(t,()=>{e.watching&&e.invalidate()}),r;e.hooks.watchRun.tap(`ilha:pages`,()=>{r?.(),r=Y(t,n)}),e.hooks.shutdown.tap(`ilha:pages`,()=>r?.())}}});export{X as t};

package/dist/plugin.d.ts

@@ -0,0 +1,56 @@
+import type { PagesMode } from "./codegen";
+export declare const VIRTUAL_PAGES_SERVER = "ilha:pages/server";
+export declare const VIRTUAL_PAGES_CLIENT = "ilha:pages/client";
+export declare const VIRTUAL_LOADERS = "ilha:loaders";
+export declare const RESOLVED_PAGES_SERVER = "\0ilha:pages/server";
+export declare const RESOLVED_PAGES_CLIENT = "\0ilha:pages/client";
+export declare const RESOLVED_LOADERS = "\0ilha:loaders";
+export declare const RESOLVED_VIRTUAL_IDS: readonly ["\0ilha:pages/server", "\0ilha:pages/client", "\0ilha:loaders"];
+/** Query suffix used on page/layout imports in the client file. */
+export declare const CLIENT_QUERY = "?client";
+export interface IlhaPagesOptions {
+    /** Directory containing page files. Default: `src/pages` */
+    dir?: string;
+    /** Output directory for generated files. Default: `.ilha` */
+    outDir?: string;
+    /**
+     * File-system router navigation mode.
+     * - `spa` — full client route graph with SSR/hydration and client navigation.
+     * - `static` — island registry only; no route graph bundled into the client.
+     * Default: `spa`.
+     */
+    mode?: PagesMode;
+    /**
+     * When `false`, internal `<a>` clicks are not intercepted — browser performs
+     * full document navigations. Only meaningful in `spa` mode.
+     * Default: `true`.
+     */
+    interceptLinks?: boolean;
+}
+export declare function resolvePluginPaths(root: string, options: IlhaPagesOptions): {
+    pagesDir: string;
+    outDir: string;
+    serverFile: string;
+    clientFile: string;
+    loadersFile: string;
+};
+export interface PagesPluginState {
+    pagesDir: string;
+    outDir: string;
+    serverFile: string;
+    clientFile: string;
+    loadersFile: string;
+    setPaths(root: string): void;
+    regen(): Promise<void>;
+    shouldRegenOnChange(file: string): boolean;
+    isUnderPagesDir(file: string): boolean;
+}
+export declare function createPagesPluginState(options: IlhaPagesOptions): PagesPluginState;
+export declare function regenFromPagesChange(state: PagesPluginState, file: string, shouldRegen: (file: string) => boolean): Promise<void>;
+export declare function resolvePagesId(_state: PagesPluginState, id: string, importer?: string): string | undefined;
+export declare function loadPagesModule(state: PagesPluginState, id: string): string | undefined;
+type InvalidateModules = () => void | Promise<void>;
+export declare function createStructuralInvalidate(state: PagesPluginState, invalidate: InvalidateModules): (file: string) => Promise<void>;
+export declare function setupRspackPagesWatcher(state: PagesPluginState, structuralInvalidate: (file: string) => void | Promise<void>): () => void;
+export declare const ilhaPages: import("unplugin").UnpluginInstance<IlhaPagesOptions | undefined, boolean>;
+export {};

package/dist/rolldown.d.ts

@@ -1,9 +1,5 @@
-import { H as wrapLayout, V as wrapError, n as ErrorHandler, s as LayoutHandler, t as AppError, v as RouteSnapshot } from "./index-DZA_1KrG.js";
-import { n as ilhaPages, t as IlhaPagesOptions } from "./plugin-rauddckN.js";
-import * as _$unplugin from "unplugin";
-
-//#region src/rolldown.d.ts
+export { wrapLayout, wrapError, type LayoutHandler, type ErrorHandler, type RouteSnapshot, type AppError, } from "./index";
+export { ilhaPages, type IlhaPagesOptions } from "./plugin";
+import { type IlhaPagesOptions } from "./plugin";
 /** 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 };
+export declare function pages(options?: IlhaPagesOptions): import("unplugin").RolldownPlugin<any> | import("unplugin").RolldownPlugin<any>[];

package/dist/rolldown.js

@@ -1 +1 @@
-import{C as e,w as t}from"./src-Cprpo919.js";import{t as n}from"./plugin-OpojKenS.js";function r(e={}){return n.rolldown(e)}export{n as ilhaPages,r as pages,e as wrapError,t as wrapLayout};
+import{E as e,T as t}from"./src-Cgv3m3sQ.js";import{t as n}from"./plugin-DBB11WaX.js";function r(e={}){return n.rolldown(e)}export{n as ilhaPages,r as pages,t as wrapError,e as wrapLayout};

package/dist/rspack.d.ts

@@ -1,8 +1,5 @@
-import { H as wrapLayout, V as wrapError, n as ErrorHandler, s as LayoutHandler, t as AppError, v as RouteSnapshot } from "./index-DZA_1KrG.js";
-import { n as ilhaPages, t as IlhaPagesOptions } from "./plugin-rauddckN.js";
-
-//#region src/rspack.d.ts
+export { wrapLayout, wrapError, type LayoutHandler, type ErrorHandler, type RouteSnapshot, type AppError, } from "./index";
+export { ilhaPages, type IlhaPagesOptions } from "./plugin";
+import { type IlhaPagesOptions } from "./plugin";
 /** Rspack plugin — use via `@ilha/router/rspack`. */
-declare function pages(options?: IlhaPagesOptions): RspackPluginInstance;
-//#endregion
-export { type AppError, type ErrorHandler, type IlhaPagesOptions, type LayoutHandler, type RouteSnapshot, ilhaPages, pages, wrapError, wrapLayout };
+export declare function pages(options?: IlhaPagesOptions): RspackPluginInstance;

package/dist/rspack.js

@@ -1 +1 @@
-import{C as e,w as t}from"./src-Cprpo919.js";import{t as n}from"./plugin-OpojKenS.js";function r(e={}){return n.rspack(e)}export{n as ilhaPages,r as pages,e as wrapError,t as wrapLayout};
+import{E as e,T as t}from"./src-Cgv3m3sQ.js";import{t as n}from"./plugin-DBB11WaX.js";function r(e={}){return n.rspack(e)}export{n as ilhaPages,r as pages,t as wrapError,e as wrapLayout};

package/dist/src-Cgv3m3sQ.js

@@ -0,0 +1,4 @@
+import e,{ISLAND_MOUNT_INTERNAL as t,context as n,html as r,mount as i}from"ilha";import{addRoute as a,createRouter as o,findRoute as s}from"rou3";const c=typeof window<`u`&&typeof document<`u`,l={readLocation(){return c?{pathname:location.pathname,search:location.search,hash:location.hash}:{pathname:`/`,search:``,hash:``}},push(e){c&&history.pushState(null,``,e)},replace(e){c&&history.replaceState(null,``,e)},onChange(e){return c?(window.addEventListener(`popstate`,e),()=>window.removeEventListener(`popstate`,e)):()=>{}},toLinkHref(e){return e},extractLogicalPath(e){let t=e.getAttribute(`href`);return!t||e.protocol&&!/^(http:|https:)$/.test(e.protocol)||t.startsWith(`#`)||e.hostname&&(e.hostname!==location.hostname||e.protocol!==location.protocol)?null:e.pathname+e.search+e.hash}};function u(e){let t=e.startsWith(`#`)?e.slice(1):e,n=t===``?`/`:t.startsWith(`/`)?t:`/`+t,r=new URL(n,`http://_`);return{pathname:r.pathname,search:r.search,hash:r.hash}}const d={readLocation(){return c?u(location.hash):{pathname:`/`,search:``,hash:``}},push(e){c&&history.pushState(null,``,e.startsWith(`#`)?e:`#`+e)},replace(e){c&&history.replaceState(null,``,e.startsWith(`#`)?e:`#`+e)},onChange(e){return c?(window.addEventListener(`popstate`,e),window.addEventListener(`hashchange`,e),()=>{window.removeEventListener(`popstate`,e),window.removeEventListener(`hashchange`,e)}):()=>{}},toLinkHref(e){return e.startsWith(`#`)?e:`#`+e},extractLogicalPath(e){let t=e.getAttribute(`href`);if(!t||e.protocol&&!/^(http:|https:)$/.test(e.protocol))return null;if(t.startsWith(`#`)){let e=t.slice(1);return e===``||!e.startsWith(`/`)?null:e}if(/^https?:\/\//i.test(t))try{let e=new URL(t);if(e.origin!==location.origin||!e.hash||e.hash===`#`)return null;let n=e.hash.slice(1);return n.startsWith(`/`)?n:null}catch{return null}return t}};let f=`history`,p=l;function m(e){f=e,p=e===`hash`?d:l}function h(){return f}function g(){return p}const _=typeof window<`u`&&typeof document<`u`;function v(e){return e}var y=class{__ilhaRedirect=!0;to;status;constructor(e,t=302){this.to=e,this.status=t}},b=class{__ilhaLoaderError=!0;status;message;constructor(e,t){this.status=e,this.message=t}};function x(e,t=302){throw new y(e,t)}function S(e,t){throw new b(e,t)}function C(e){return e.length===0?async()=>({}):e.length===1?e[0]:async t=>{let n=await Promise.all(e.map(e=>e(t)));return Object.assign({},...n)}}const w=Symbol.for(`ilha.router.wrapLayout.leaf`),ee=Symbol.for(`ilha.router.wrapLayout.handler`);function te(e){let t=e.match(/^<([a-zA-Z][\w-]*)\s[^>]*>([\s\S]*)<\/\1>\s*$/);return t?t[2]:e}function ne(e){let t=e.match(/^<([a-zA-Z][\w-]*)\s([^>]*)>/);return t?{tag:t[1],attrs:t[2]}:null}const re=/<(pre|script|style|textarea)\b/i;function ie(e,t,n){let r=RegExp(`<${n}\\b`,`gi`),i=RegExp(`</${n}>`,`gi`),a=1,o=t;for(;a>0&&o<e.length;){r.lastIndex=o,i.lastIndex=o;let t=r.exec(e),n=i.exec(e);if(!n)return null;if(t&&t.index<n.index)a+=1,o=t.index+t[0].length;else{if(--a,a===0)return n.index+n[0].length;o=n.index+n[0].length}}return o}function ae(e,t){let n=t;for(;n<e.length;){if(e.startsWith(`<!--`,n)){let t=e.indexOf(`-->`,n);if(t===-1)return null;n=t+3;continue}let t=e.slice(n).match(re);if(t&&t.index!=null&&t.index>=0){let r=n+t.index,i=!1,a=n;for(;a<r;){let t=e.indexOf(`<!--`,a);if(t===-1||t>=r)break;let o=e.indexOf(`-->`,t);if(o===-1)return null;if(r<o+3){n=o+3,i=!0;break}a=o+3}if(i)continue;let o=e.indexOf(`<div`,n),s=e.indexOf(`</div>`,n);if(!(o!==-1&&o<r||s!==-1&&s<r)){let i=t[1].toLowerCase(),a=ie(e,r+t[0].length,i);if(a===null)return null;n=a;continue}}let r=e.indexOf(`<div`,n),i=e.indexOf(`</div>`,n);return i===-1&&r===-1?null:r===-1||i!==-1&&i<r?{kind:`close`,index:i}:{kind:`open`,index:r}}return null}function oe(e){let t=[];for(let n of e.matchAll(/<div\s[^>]*data-ilha-slot="k:page"[^>]*>/g)){let r=n.index+n[0].length,i=1,a=r;for(;i>0;){let n=ae(e,a);if(!n)break;if(n.kind===`open`)i+=1,a=n.index+4;else{if(--i,i===0){t.push({openEnd:r,closeStart:n.index});break}a=n.index+6}}}return t}function T(e,t,n){let r=oe(e);if(r.length===0)return e;let i=n===`innermost`?r[r.length-1]:r[0];return e.slice(0,i.openEnd)+t+e.slice(i.closeStart)}function se(e,t){let n=e[ee];if(!n)return e.toString(t);let r=e[w]??e;return n(Object.assign(r.key(`page`),{toString:()=>``})).toString(t)}async function ce(e,t,n,r){let i=te(await t.hydratable(n,r));return T(T(se(e,n),``,`innermost`),i,`innermost`)}function le(e,n){let r=n[w]??n,i=r===n?null:n,a=e(Object.assign(n.key(`page`),{toString:n.toString.bind(n)}));a[w]=r,a[ee]=e;function o(e){let t=[...e.querySelectorAll(`[data-ilha-slot="k:page"]`)].filter(t=>{let n=t.closest(`[data-ilha]`);return n===null||n===e});return t.length===0?e:t[t.length-1]}function s(e,t){let n=e=>{delete e._skipOnMount,t.setAttribute(`data-ilha-state`,JSON.stringify(e))};if(t.hasAttribute(`data-ilha-state`)){let r=e.getAttribute(`data-ilha-state`);if(r)try{n(JSON.parse(r));return}catch{}let i=t.getAttribute(`data-ilha-state`);if(i)try{let e=JSON.parse(i);delete e._skipOnMount,t.setAttribute(`data-ilha-state`,JSON.stringify(e))}catch{}return}let r=e.getAttribute(`data-ilha-state`);if(r)try{n(JSON.parse(r));return}catch{}t.childNodes.length>0&&t.setAttribute(`data-ilha-state`,`{}`)}function c(e){let n=e[t];if(typeof n!=`function`)return;e[t]=(e,t)=>{let r=e.closest(`[data-ilha]`);return r&&r!==e&&s(r,e),n(e,t)};let r=e.mount.bind(e);e.mount=(e,t)=>{let n=e.closest(`[data-ilha]`);return n&&n!==e&&s(n,e),r(e,t)}}c(r);let l=a.mount.bind(a),u=a[t];function d(e){s(e,o(e))}return a.mount=(e,t)=>(d(e),l(e,t)),a[t]=(e,t)=>(d(e),typeof u==`function`?u(e,t):{unmount:l(e,t),updateProps:()=>{}}),a.hydratable=async(e,t)=>{if(!t?.name)throw Error(`wrapLayout: hydratable requires options.name`);let n=e??{},o=await r.hydratable(n,t),s=ne(o);if(!s)return o;let c=te(o);i&&(c=await ce(i,r,n,t));let l=T(T(se(a,n),``,`first`),c,`first`);return`<${s.tag} ${s.attrs}>${l}</${s.tag}>`},a}function ue(n,r){let i=e.render(()=>{try{return r.toString()}catch(e){let t={path:k(),params:A(),search:j(),hash:M()};return n({message:e.message,status:e.status,stack:e.stack},t).toString()}});return i.mount=(e,t)=>{try{return r.mount(e,t)}catch(r){let i={path:k(),params:A(),search:j(),hash:M()},a=n({message:r.message,status:r.status,stack:r.stack},i);return e.innerHTML=a.toString(),a.mount(e,t)}},i[t]=(e,i)=>{try{let n=r[t];return typeof n==`function`?n(e,i):{unmount:r.mount(e,i),updateProps:()=>{}}}catch(t){let r={path:k(),params:A(),search:j(),hash:M()},a=n({message:t.message,status:t.status,stack:t.stack},r);return e.innerHTML=a.toString(),{unmount:a.mount(e,i),updateProps:()=>{}}}},i.hydratable=async(e,t)=>{if(!t?.name)throw Error(`wrapError: hydratable requires options.name`);return r.hydratable(e??{},t)},i}function de(e){return e}function fe(e){let t=new Map;for(let[n,r]of Object.entries(e))t.has(r)||t.set(r,n);return t}const pe=`/__ilha/loader`,E=new Map;async function D(e,t){let n=E.get(e);if(n){E.delete(e);try{return await n}catch{}}let r=`${pe}?path=${encodeURIComponent(e)}`;try{let e=await fetch(r,{signal:t,headers:{accept:`application/json`}});if(!e.ok){try{let t=await e.json();if(t&&typeof t==`object`&&`kind`in t)return t}catch{}return{kind:`error`,status:e.status,message:e.statusText}}return await e.json()}catch(e){if(e?.name===`AbortError`)throw e;return{kind:`error`,status:0,message:e?.message??`network error`}}}function O(e){if(!_||E.has(e))return;let t=e.split(`?`)[0]??``;if(!s(F,`GET`,t)?.data?.hasLoader)return;let n=D(e).catch(e=>({kind:`error`,status:0,message:e?.message??`prefetch failed`}));E.set(e,n)}async function me(e,t,n,r,i,a){if(!e)return t.innerHTML=`<div data-router-empty></div>`,()=>{};let o=!!s(F,`GET`,n.split(`?`)[0]??``)?.data?.hasLoader,c={},l=o?await D(n,r):{kind:`data`,data:{}};if(l.kind===`redirect`)return V(l.to,{replace:!0}),()=>{};if(l.kind===`error`){let e=String(l.message).replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`);return t.innerHTML=`<div data-router-view data-router-error="${l.status}">${e}</div>`,()=>{}}if(l.kind===`not-found`)return t.innerHTML=`<div data-router-empty></div>`,()=>{};c=l.data;let u={entries:[]};if(!i){console.warn(`[ilha-router] No registry provided for client-side navigation. Island will not be interactive.`);let n=await X(u,()=>e.toString(c));return Y(u.entries),t.innerHTML=`<div data-router-view>${n}</div>`,()=>{}}let d=a?.get(e)??Object.entries(i).find(([,t])=>t===e)?.[0];if(!d){console.warn(`[ilha-router] Island not found in registry for client-side navigation.`);let n=await X(u,()=>e.toString(c));return Y(u.entries),t.innerHTML=`<div data-router-view>${n}</div>`,()=>{}}let f=await X(u,()=>e.hydratable(c,{name:d,as:`div`,snapshot:!0}));Y(u.entries),t.innerHTML=`<div data-router-view>${f}</div>`;let p=t.querySelector(`[data-ilha="${d}"]`);return p?e.mount(p):()=>{}}const k=n(`router.path`,``),A=n(`router.params`,{}),j=n(`router.search`,``),M=n(`router.hash`,``);function he(){return{path:k,params:A,search:j,hash:M}}const N=n(`router.active`,null);let P=[],F=o(),I=new Map,L=new Map;function R(e){let t={};if(e)for(let[n,r]of Object.entries(e))t[n]=decodeURIComponent(r);return t}function ge(e){let t=typeof e==`string`?new URL(e,`http://localhost`):e,n=s(F,`GET`,t.pathname);k(t.pathname),A(R(n?.params)),j(t.search),M(t.hash),N(n?.data?.island??null)}function z(){let e=g().readLocation(),t=s(F,`GET`,e.pathname);k(e.pathname),A(R(t?.params)),j(e.search),M(e.hash),N(t?.data?.island??null)}function B(){_&&z()}function V(e,t={}){if(!_)return;let n=g(),r=n.readLocation();e!==r.pathname+r.search+r.hash&&(t.replace?n.replace(e):n.push(e),z())}function H(e=document,t={}){if(!_)return()=>{};let n=t.prefetch!==!1;function r(e,t){let n=e.getAttribute(`target`)===`_blank`,r=!!t&&(t.ctrlKey||t.metaKey||t.shiftKey),i=e.hasAttribute(`data-no-intercept`);return n||r||i?null:g().extractLogicalPath(e)}let i=e=>{if(e.defaultPrevented)return;let t=e.target.closest(`a`);if(!t)return;let n=r(t,e);n!==null&&(e.preventDefault(),V(n))},a=e=>{let t=e.target.closest(`a`);if(!t)return;let n=t.getAttribute(`data-prefetch`);if(n===null||n===`false`)return;let i=r(t);i!==null&&O(i.split(`#`)[0]??i)};return e.addEventListener(`click`,i),n&&e.addEventListener(`mouseover`,a,{passive:!0}),()=>{e.removeEventListener(`click`,i),n&&e.removeEventListener(`mouseover`,a)}}const U=e.render(()=>{let e=N();return e?`<div data-router-view>${e.toString()}</div>`:`<div data-router-empty></div>`}),_e=e.state(`href`,``).state(`label`,``).on(`[data-link]@click`,({state:e,event:t})=>{t.preventDefault(),V(e.href())}).on(`[data-link]@mouseenter`,({state:e})=>{let t=e.href();if(t){if(/^https?:\/\//i.test(t))try{let e=new URL(t);if(e.origin!==location.origin)return;O(e.pathname+e.search);return}catch{return}O(t)}}).render(({state:e})=>r`<a data-link data-prefetch href="${()=>g().toLinkHref(e.href())}"
+        >${e.label}</a
+      >`);function ve(e){let t=s(F,`GET`,k());return t?I.get(t.data.island)===e:!1}const W=`data-ilha-head`,G=`data-ilha-router-html`,ye=`data-ilha-router-body`;let K=null,q=null,be=null;async function xe(){return q||(be||=import(`node:async_hooks`).then(({AsyncLocalStorage:e})=>(q=new e,q)),be)}function Se(){return _?K:q?.getStore()??null}function Ce(e){let t=Se();if(!t){_||console.warn(`[ilha-router] head() called outside an SSR render window — ignored.`);return}t.entries.push(e)}function J(e){return typeof CSS<`u`&&typeof CSS.escape==`function`?CSS.escape(e):e.replace(/\\/g,`\\\\`).replace(/"/g,`\\"`)}function we(e){return`charset`in e?`meta[charset][${W}]`:`name`in e?`meta[name="${J(e.name)}"][${W}]`:`property`in e?`meta[property="${J(e.property)}"][${W}]`:`http-equiv`in e?`meta[http-equiv="${J(e[`http-equiv`])}"][${W}]`:null}function Te(e){return e.rel&&e.href?`link[rel="${J(e.rel)}"][href="${J(e.href)}"][${W}]`:null}function Y(e){if(!_)return;let t,n,r=[],i=[],a={},o={};for(let s of e)s.title!==void 0&&(t=s.title),s.titleTemplate!==void 0&&(n=s.titleTemplate),s.meta&&r.push(...s.meta),s.link&&i.push(...s.link),s.htmlAttrs&&(a={...a,...s.htmlAttrs}),s.bodyAttrs&&(o={...o,...s.bodyAttrs});let s=ke(t,n);s!==void 0&&(document.title=s);let c=Q(r,Oe),l=Q(i,e=>`${e.rel??``}:${e.href??``}`),u=new Set;for(let e of c){let t=we(e);if(!t)continue;let n=document.querySelector(t);n||(n=document.createElement(`meta`),n.setAttribute(W,``),document.head.appendChild(n));for(let[t,r]of Object.entries(e))n.setAttribute(t,r);u.add(n)}for(let e of l){let t=Te(e),n=t?document.querySelector(t):null;n||(n=document.createElement(`link`),n.setAttribute(W,``),document.head.appendChild(n));for(let[t,r]of Object.entries(e))n.setAttribute(t,r);u.add(n)}for(let e of[...document.head.querySelectorAll(`[${W}]`)])u.has(e)||e.remove();let d=document.documentElement,f=(d.getAttribute(G)??``).split(/\s+/).filter(Boolean);for(let e of f)d.removeAttribute(e);let p=Object.keys(a);for(let[e,t]of Object.entries(a))d.setAttribute(e,t);p.length?d.setAttribute(G,p.join(` `)):d.removeAttribute(G);let m=document.body,h=(m.getAttribute(ye)??``).split(/\s+/).filter(Boolean);for(let e of h)m.removeAttribute(e);let g=Object.keys(o);for(let[e,t]of Object.entries(o))m.setAttribute(e,t);g.length?m.setAttribute(ye,g.join(` `)):m.removeAttribute(ye)}async function X(e,t){if(_){let n=K;K=e;try{return await t()}finally{K=n}}return await(await xe()).run(e,()=>Promise.resolve(t()))}const Ee={"&":`&amp;`,"<":`&lt;`,">":`&gt;`,'"':`&quot;`,"'":`&#39;`};function De(e){return String(e).replace(/[&<>"']/g,e=>Ee[e])}function Z(e){return Object.entries(e).map(([e,t])=>` ${e}="${De(t)}"`).join(``)}function Oe(e){return`charset`in e?`charset`:`name`in e?`name:${e.name}`:`property`in e?`property:${e.property}`:`http-equiv`in e?`http-equiv:${e[`http-equiv`]}`:JSON.stringify(e)}function Q(e,t){let n=new Map;for(let r of e)n.set(t(r),r);return[...n.values()]}function ke(e,t){return t===void 0?e:typeof t==`function`?t(e):t.replace(/%s/g,e??``)}function $(e){let t,n,r=[],i=[],a=[],o={},s={};for(let c of e)c.title!==void 0&&(t=c.title),c.titleTemplate!==void 0&&(n=c.titleTemplate),c.meta&&r.push(...c.meta),c.link&&i.push(...c.link),c.script&&a.push(...c.script),c.htmlAttrs&&(o={...o,...c.htmlAttrs}),c.bodyAttrs&&(s={...s,...c.bodyAttrs});let c=ke(t,n),l=[];c!==void 0&&l.push(`<title>${De(c)}</title>`);for(let e of Q(r,Oe))l.push(`<meta${Z({...e,[W]:``})} />`);for(let e of Q(i,e=>`${e.rel??``}:${e.href??``}`))l.push(`<link${Z({...e,[W]:``})} />`);for(let e of a){let{children:t,...n}=e;l.push(`<script${Z(n)}>${t??``}<\/script>`)}return{headTags:l.join(`
+  `),htmlAttrs:Z(o),bodyAttrs:Z(s)}}function Ae(e){return typeof e==`string`?new URL(e,`http://localhost`):e}function je(e){try{return new Request(e.toString())}catch{return{url:e.toString(),headers:new Headers}}}async function Me(e,t,n,r,i,a){let o=[],s=a??(e=>o.push(e));try{let a={kind:`data`,data:await e({params:n,request:r,url:t,signal:i,head:s})??{}};return o.length>0&&(a.head=$(o)),a}catch(e){return e instanceof y?{kind:`redirect`,to:e.to,status:e.status}:e instanceof b?{kind:`error`,status:e.status,message:e.message}:{kind:`error`,status:e?.status??500,message:e?.message??`Loader failed`}}}function Ne(t={}){let n=t.mode??`spa`,r=t.interceptLinks!==!1;P=[],F=o(),I=new Map,L=new Map;let c=null,l=null,u={route(e,t,n){let r=!!n,i={island:t,loader:n,hasLoader:r};return P.push({pattern:e,island:t,loader:n,hasLoader:r}),a(F,`GET`,e,i),L.set(e,i),I.has(t)||I.set(t,e),u},attachLoader(e,t){let n=L.get(e);if(!n)return console.warn(`[ilha-router] attachLoader("${e}", …): pattern was never registered via .route(). The loader will be ignored.`),u;n.loader=t,n.hasLoader=!0;let r=P.find(t=>t.pattern===e);return r&&(r.loader=t,r.hasLoader=!0),u},markLoader(e){let t=L.get(e);if(!t)return console.warn(`[ilha-router] markLoader("${e}"): pattern was never registered via .route(). The loader marker will be ignored.`),u;t.hasLoader=!0;let n=P.find(t=>t.pattern===e);return n&&(n.hasLoader=!0),u},routes(){return P.map(e=>({...e}))},prime:B,hydrateStatic(e,t={}){if(!_)return()=>{};let n=t.root??document.body;B();let{unmount:r}=i(e,{root:n});return r},mount(t,{hydrate:i=!1,registry:a,interceptLinks:o}={}){if(!_)return console.warn(`[ilha-router] mount() called in a non-browser environment`),()=>{};let u=typeof t==`string`?document.querySelector(t):t;if(!u)return console.warn(`[ilha-router] No element found for selector "${t}"`),()=>{};if(z(),n===`static`)return console.warn(`[ilha-router] router.mount() called in static mode. Use router.hydrateStatic(registry) instead.`),()=>{};let d=!0;c=g().onChange(()=>{d&&z()}),l=o??r?H(document):null;let f=null,p=null;if(i){h()===`hash`&&console.warn("[ilha-router] mount({ hydrate: true }) was called in hash mode. SSR + hydration assumes the server can render the active route, but in hash mode the server only ever sees the document URL. Use plain SPA mode (`mount(target)` without `hydrate: true`) for hash-mode apps.");let t=u.querySelector(`[data-router-view]`)??u,n=N(),r=a?fe(a):void 0,i=0,o=e.render(()=>{let e=N();if(e!==n){let o=++i;p?.abort(),p=new AbortController;let s=p.signal;queueMicrotask(async()=>{if(o===i){f?.();try{let n=g().readLocation();f=await me(e,t,n.pathname+n.search,s,a,r)}catch(e){if(e?.name===`AbortError`)return;throw e}n=e}})}return``}),m=document.createElement(`div`);m.style.display=`none`,u.appendChild(m);let _=o.mount(m);return(async()=>{let e=N();if(!e)return;let t=g().readLocation(),n=t.pathname+t.search,r=s(F,`GET`,t.pathname)?.data?.hasLoader?await D(n):{kind:`data`,data:{}};if(r.kind===`redirect`||r.kind===`error`)return;let i=r.kind===`data`?r.data:{},a={entries:[]};await X(a,()=>e.toString(i)),d&&Y(a.entries)})(),()=>{d=!1,++i,p?.abort(),_(),m.remove(),f?.(),l?.(),c?.(),l=null,c=null}}let m=null,v=null,y=0;f=U.mount(u);async function b(e,t){if(m?.(),m=null,v=e,!e)return;let n=u?.querySelector(`[data-router-view]`);if(!n)return;let r=g().readLocation(),i=s(F,`GET`,r.pathname)?.data?.hasLoader?await D(r.pathname+r.search,t):{kind:`data`,data:{}};if(t.aborted)return;if(i.kind===`redirect`){V(i.to,{replace:!0});return}let a=i.kind===`data`?i.data:{},o={entries:[]},c=await X(o,()=>e.toString(a));Y(o.entries),n.innerHTML=c,m=e.mount(n,a)}p=new AbortController,b(N(),p.signal);let x=e.render(()=>{let e=N();if(e!==v){let t=++y;p?.abort(),p=new AbortController;let n=p.signal;queueMicrotask(()=>{t===y&&b(e,n)})}return``}),S=document.createElement(`div`);S.style.display=`none`,u.appendChild(S);let C=x.mount(S);return()=>{d=!1,++y,p?.abort(),m?.(),C(),S.remove(),f?.(),l?.(),c?.(),l=null,c=null}},render(e){return ge(e),U.toString()},async renderHydratable(e,t,n={},r){let i=await this.renderResponse(e,t,n,r);return i.kind===`html`||i.kind===`error`?i.html:`<meta http-equiv="refresh" content="0; url=${i.to}">`},async renderResponse(e,t,n={},r){let{baseHead:i,...a}=n,o=Ae(e);ge(o);let c=s(F,`GET`,o.pathname),l=c?.data?.island??null;if(!l)return{kind:`html`,html:`<div data-router-empty></div>`,status:404,head:i?$([i]):void 0};let u={entries:i?[i]:[]},d={};if(c?.data?.loader){let e=r??je(o),t=new AbortController,n=await Me(c.data.loader,o,A(),e,t.signal,e=>u.entries.push(e));if(n.kind===`redirect`)return{kind:`redirect`,to:n.to,status:n.status};if(n.kind===`error`){let e=String(n.message).replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`),t=`<div data-router-view data-router-error="${n.status}">${e}</div>`;return{kind:`error`,status:n.status,message:n.message,html:t,head:$(u.entries)}}d=n.data}let f=fe(t).get(l);return f?{kind:`html`,html:`<div data-router-view>${await X(u,()=>l.hydratable(d,{name:f,as:`div`,snapshot:!0,...a}))}</div>`,head:$(u.entries)}:(console.warn(`[ilha-router] renderHydratable: active island for "${k()}" is not in the registry. Falling back to plain SSR — the island will not be interactive on the client.`),{kind:`html`,html:`<div data-router-view>${await X(u,()=>l.toString(d))}</div>`,head:$(u.entries)})},async runLoader(e,t){let n=Ae(e),r=s(F,`GET`,n.pathname);if(!r?.data?.island)return{kind:`not-found`};if(!r.data.loader)return{kind:`data`,data:{}};let i=R(r.params),a=t??je(n),o=new AbortController,c={entries:[]};return Me(r.data.loader,n,i,a,o.signal,e=>c.entries.push(e)).then(e=>e.kind!==`data`||c.entries.length===0?e:{...e,head:$(c.entries)})},hydrate(e,t={}){if(!_)return console.warn(`[ilha-router] hydrate() called in a non-browser environment`),()=>{};let n=t.root??document.body,r=t.target??n;B();let{unmount:a}=i(e,{root:n}),o=this.mount(r,{hydrate:!0,registry:e,interceptLinks:t.interceptLinks});return()=>{a(),o()}}};return u}var Pe={router:Ne,navigate:V,useRoute:he,isActive:ve,enableLinkInterception:H,prime:B,prefetch:O,RouterView:U,RouterLink:_e,loader:v,redirect:x,error:S,composeLoaders:C,head:Ce};export{Pe as C,h as D,le as E,m as O,$ as S,ue as T,M as _,U as a,j as b,H as c,ve as d,v as f,x as g,B as h,_e as i,S as l,O as m,b as n,C as o,V as p,y as r,de as s,pe as t,Ce as u,A as v,he as w,Ne as x,k as y};