@elurjs/kit 2.4.4

package/dist/lib/island/hydrate.d.cts

@@ -0,0 +1,33 @@
+import type { ElurTemplate } from "@elurjs/core";
+export type IslandComponent<TProps = unknown> = (props: TProps) => ElurTemplate | null | false | undefined;
+export type { IslandDirective } from "./island.js";
+/** Lazy island loader in a discriminated form (no probe required to detect). */
+export interface IslandLoader<TProps = unknown> {
+    load: () => Promise<IslandComponent<TProps>>;
+}
+/**
+ * Island registry entry. Two unambiguous shapes:
+ *   - `IslandComponent` (eager component function).
+ *   - `IslandLoader` `{ load }` (lazy, code-split loader).
+ *
+ * Legacy async loader functions are also accepted for backwards compatibility
+ * and detected *without invoking them* (via the `AsyncFunction` tag), so no
+ * side effects or duplicate signal creation happen during detection.
+ */
+export type IslandRegistryEntry<TProps = unknown> = IslandComponent<TProps> | IslandLoader<TProps> | (() => Promise<IslandComponent<TProps>>);
+export type IslandRegistry = Record<string, IslandRegistryEntry<any>>;
+/**
+ * Wraps a lazy island loader in the discriminated `{ load }` form.
+ */
+export declare function lazyIsland<TProps = unknown>(loader: () => Promise<IslandComponent<TProps>>): IslandLoader<TProps>;
+/**
+ * Hydrates all islands on the page using the provided registry.
+ *
+ * @param registry Map from island name to component factory.
+ */
+/**
+ * Dispose all currently hydrated islands. Called by the client router before
+ * swapping the page body to prevent leaked effects and stale DOM writes.
+ */
+export declare function cleanupHydratedIslands(): void;
+export declare function hydrateIslands(registry: IslandRegistry): void;

package/dist/lib/island/hydrate.d.ts

@@ -0,0 +1,33 @@
+import type { ElurTemplate } from "@elurjs/core";
+export type IslandComponent<TProps = unknown> = (props: TProps) => ElurTemplate | null | false | undefined;
+export type { IslandDirective } from "./island.js";
+/** Lazy island loader in a discriminated form (no probe required to detect). */
+export interface IslandLoader<TProps = unknown> {
+    load: () => Promise<IslandComponent<TProps>>;
+}
+/**
+ * Island registry entry. Two unambiguous shapes:
+ *   - `IslandComponent` (eager component function).
+ *   - `IslandLoader` `{ load }` (lazy, code-split loader).
+ *
+ * Legacy async loader functions are also accepted for backwards compatibility
+ * and detected *without invoking them* (via the `AsyncFunction` tag), so no
+ * side effects or duplicate signal creation happen during detection.
+ */
+export type IslandRegistryEntry<TProps = unknown> = IslandComponent<TProps> | IslandLoader<TProps> | (() => Promise<IslandComponent<TProps>>);
+export type IslandRegistry = Record<string, IslandRegistryEntry<any>>;
+/**
+ * Wraps a lazy island loader in the discriminated `{ load }` form.
+ */
+export declare function lazyIsland<TProps = unknown>(loader: () => Promise<IslandComponent<TProps>>): IslandLoader<TProps>;
+/**
+ * Hydrates all islands on the page using the provided registry.
+ *
+ * @param registry Map from island name to component factory.
+ */
+/**
+ * Dispose all currently hydrated islands. Called by the client router before
+ * swapping the page body to prevent leaked effects and stale DOM writes.
+ */
+export declare function cleanupHydratedIslands(): void;
+export declare function hydrateIslands(registry: IslandRegistry): void;

package/dist/lib/island/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../hydrate-8a3TbQbs.cjs");exports.cleanupHydratedIslands=e.t,exports.hydrateIslands=e.n,exports.lazyIsland=e.r;

package/dist/lib/island/index.d.cts

@@ -0,0 +1,2 @@
+export { hydrateIslands, cleanupHydratedIslands, lazyIsland, type IslandRegistry, type IslandLoader, type IslandRegistryEntry } from "./hydrate.js";
+export type { IslandComponent, IslandDirective, IslandOptions } from "./island.js";

package/dist/lib/island/index.d.ts

@@ -0,0 +1,2 @@
+export { hydrateIslands, cleanupHydratedIslands, lazyIsland, type IslandRegistry, type IslandLoader, type IslandRegistryEntry } from "./hydrate.js";
+export type { IslandComponent, IslandDirective, IslandOptions } from "./island.js";

package/dist/lib/island/index.js

@@ -0,0 +1 @@
+import{n as e,r as t,t as n}from"../hydrate-CgZGrTxF.js";export{n as cleanupHydratedIslands,e as hydrateIslands,t as lazyIsland};

package/dist/lib/island/island.d.cts

@@ -0,0 +1,32 @@
+import { type ElurTemplate } from "@elurjs/core";
+export type IslandDirective = "load" | "idle" | "visible" | "only";
+export interface IslandComponent<TProps = unknown> {
+    (props: TProps): ElurTemplate | null | false | undefined;
+}
+/**
+ * Options for {@link island}.
+ *
+ * - `ssr`: Whether to execute the component on the server. Defaults to `true`
+ *   unless `directive === "only"` (then `false`). When `false`, the component
+ *   is never called during SSR; only `fallback` is rendered.
+ * - `fallback`: HTML to render inside the island marker when SSR is skipped or
+ *   the component returns null/false. Accepts a `ElurTemplate` (reactive, with
+ *   signals) or a plain string. Defaults to an empty string.
+ */
+export interface IslandOptions {
+    ssr?: boolean;
+    fallback?: ElurTemplate | string;
+}
+/**
+ * Renders a component to a static HTML string with island markers.
+ *
+ * @param name Unique island name used by the client entry to look up the module.
+ * @param component Island component. Executed on the server unless `directive`
+ *   is `"only"` or `options.ssr` is `false`.
+ * @param props Props passed to the component and serialized for hydration.
+ * @param directive When to hydrate on the client. Use `"only"` to skip SSR
+ *   entirely (client-only island).
+ * @param options SSR strategy and fallback content.
+ * @returns A ElurTemplate that renders the island placeholder.
+ */
+export declare function island<TProps>(name: string, component: IslandComponent<TProps>, props: TProps, directive?: IslandDirective, options?: IslandOptions): ElurTemplate;

package/dist/lib/island/island.d.ts

@@ -0,0 +1,32 @@
+import { type ElurTemplate } from "@elurjs/core";
+export type IslandDirective = "load" | "idle" | "visible" | "only";
+export interface IslandComponent<TProps = unknown> {
+    (props: TProps): ElurTemplate | null | false | undefined;
+}
+/**
+ * Options for {@link island}.
+ *
+ * - `ssr`: Whether to execute the component on the server. Defaults to `true`
+ *   unless `directive === "only"` (then `false`). When `false`, the component
+ *   is never called during SSR; only `fallback` is rendered.
+ * - `fallback`: HTML to render inside the island marker when SSR is skipped or
+ *   the component returns null/false. Accepts a `ElurTemplate` (reactive, with
+ *   signals) or a plain string. Defaults to an empty string.
+ */
+export interface IslandOptions {
+    ssr?: boolean;
+    fallback?: ElurTemplate | string;
+}
+/**
+ * Renders a component to a static HTML string with island markers.
+ *
+ * @param name Unique island name used by the client entry to look up the module.
+ * @param component Island component. Executed on the server unless `directive`
+ *   is `"only"` or `options.ssr` is `false`.
+ * @param props Props passed to the component and serialized for hydration.
+ * @param directive When to hydrate on the client. Use `"only"` to skip SSR
+ *   entirely (client-only island).
+ * @param options SSR strategy and fallback content.
+ * @returns A ElurTemplate that renders the island placeholder.
+ */
+export declare function island<TProps>(name: string, component: IslandComponent<TProps>, props: TProps, directive?: IslandDirective, options?: IslandOptions): ElurTemplate;

package/dist/lib/island/scan.d.cts

@@ -0,0 +1,14 @@
+/** A single island component discovered by the scanner. */
+export interface IslandModule {
+    /** Registry name, derived from the path relative to the islands dir. */
+    name: string;
+    /** Absolute file system path to the island module. */
+    filePath: string;
+}
+/**
+ * Scans an islands directory for island component modules.
+ *
+ * @param islandsDir Absolute path to the islands directory (e.g. "src/islands").
+ * @returns Discovered island modules, sorted by name.
+ */
+export declare function scanIslands(islandsDir: string): Promise<IslandModule[]>;

package/dist/lib/island/scan.d.ts

@@ -0,0 +1,14 @@
+/** A single island component discovered by the scanner. */
+export interface IslandModule {
+    /** Registry name, derived from the path relative to the islands dir. */
+    name: string;
+    /** Absolute file system path to the island module. */
+    filePath: string;
+}
+/**
+ * Scans an islands directory for island component modules.
+ *
+ * @param islandsDir Absolute path to the islands directory (e.g. "src/islands").
+ * @returns Discovered island modules, sorted by name.
+ */
+export declare function scanIslands(islandsDir: string): Promise<IslandModule[]>;

package/dist/lib/manifest/index.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../route-scanner-JY6YrNH5.cjs"),t=require("../scan-CY2O9ty6.cjs"),n=require("../scan-DXzYtmRQ.cjs"),r=require("../integrations-DDqfWjvH.cjs");let i=require("node:fs/promises"),a=require("node:path");async function o(i){let[a,o,s]=await Promise.all([e.t(i.appDir),n.n(i.appDir),t.t(i.islandsDir)]);l(a),p(s);let c={version:1,root:i.root,routes:a,actions:o,islands:s,base:i.base,output:i.output};return await r.t(i.integrations,`routes`,[c,{root:i.root,command:`build`}]),c}async function s(e,t){await(0,i.mkdir)((0,a.dirname)(t),{recursive:!0}),await(0,i.writeFile)(t,JSON.stringify(m(e),null,2),`utf8`)}async function c(e,t){let n=e.routes.pages.map(e=>JSON.stringify(e.path)),r=Object.values(e.actions).flatMap(e=>Object.keys(e)).filter((e,t,n)=>n.indexOf(e)===t).map(e=>JSON.stringify(e)),o=[`export type ElurRoutePath = ${n.length?n.join(` | `):`never`};`,`export type ElurActionName = ${r.length?r.join(` | `):`never`};`,`export interface ElurRouteParams { [name: string]: string | string[] | undefined }`,``].join(`
+`);await(0,i.mkdir)((0,a.dirname)(t),{recursive:!0}),await(0,i.writeFile)(t,o,`utf8`)}function l(e){let t=new Map;for(let n of e.pages)d(t,n.path,n.pagePath,`page`),f(n.path,n.pagePath);for(let n of e.api)d(t,n.path,n.routePath,`API`),f(n.path,n.routePath)}function u(e,t){if(/\.server\.[cm]?[jt]sx?$/.test(e))throw Error(`[elur-kit] Server-only module imported by client${t?` from ${t}`:``}: ${e}`)}function d(e,t,n,r){let i=e.get(t);if(i)throw Error(`[elur-kit] Duplicate ${r} route "${t}": ${i} and ${n}`);e.set(t,n)}function f(e,t){if(e===`/__elur-js`||e.startsWith(`/__elur-js/`)||e===`/_elur`||e.startsWith(`/_elur/`))throw Error(`[elur-kit] Reserved route "${e}" declared by ${t}`)}function p(e){let t=new Set;for(let n of e){if(t.has(n.name))throw Error(`[elur-kit] Duplicate island name: ${n.name}`);t.add(n.name)}}function m(e){let t=t=>t?(0,a.relative)(e.root,t).split(`\\`).join(`/`):void 0,n={pages:e.routes.pages.map(e=>({...e,pagePath:t(e.pagePath),dataPath:t(e.dataPath),actionPath:t(e.actionPath),loadingPath:t(e.loadingPath),layouts:e.layouts.map(e=>t(e))})),api:e.routes.api.map(e=>({...e,routePath:t(e.routePath)})),error404:e.routes.error404?{...e.routes.error404,pagePath:t(e.routes.error404.pagePath),dataPath:t(e.routes.error404.dataPath),actionPath:t(e.routes.error404.actionPath),loadingPath:t(e.routes.error404.loadingPath),layouts:e.routes.error404.layouts.map(e=>t(e))}:void 0,error500:e.routes.error500?{...e.routes.error500,pagePath:t(e.routes.error500.pagePath),dataPath:t(e.routes.error500.dataPath),actionPath:t(e.routes.error500.actionPath),loadingPath:t(e.routes.error500.loadingPath),layouts:e.routes.error500.layouts.map(e=>t(e))}:void 0},r={};for(let[n,i]of Object.entries(e.actions))r[n]=Object.fromEntries(Object.entries(i).map(([e,n])=>[e,t(n)]));return{...e,root:`.`,routes:n,actions:r,islands:e.islands.map(e=>({...e,filePath:t(e.filePath)}))}}exports.assertClientImportAllowed=u,exports.createAppManifest=o,exports.validateManifestRoutes=l,exports.writeAppManifest=s,exports.writeRouteTypes=c;
+//# sourceMappingURL=index.cjs.map

package/dist/lib/manifest/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../src/manifest/index.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, relative } from \"node:path\";\nimport { scanActions, type ActionRegistry } from \"../action/scan.js\";\nimport type { ResolvedElurConfig } from \"../config/index.js\";\nimport { runIntegrationHook } from \"../integrations/index.js\";\nimport { scanIslands, type IslandModule } from \"../island/scan.js\";\nimport { scanRoutes, type ScannedRoutes } from \"../router/route-scanner.js\";\n\nexport interface AppManifest {\n  version: 1;\n  root: string;\n  routes: ScannedRoutes;\n  actions: ActionRegistry;\n  islands: IslandModule[];\n  base: string;\n  output: ResolvedElurConfig[\"output\"];\n}\n\nexport async function createAppManifest(config: ResolvedElurConfig): Promise<AppManifest> {\n  const [routes, actions, islands] = await Promise.all([\n    scanRoutes(config.appDir),\n    scanActions(config.appDir),\n    scanIslands(config.islandsDir),\n  ]);\n  validateManifestRoutes(routes);\n  validateIslands(islands);\n  const manifest: AppManifest = {\n    version: 1,\n    root: config.root,\n    routes,\n    actions,\n    islands,\n    base: config.base,\n    output: config.output,\n  };\n  await runIntegrationHook(config.integrations, \"routes\", [\n    manifest,\n    { root: config.root, command: \"build\" },\n  ]);\n  return manifest;\n}\n\nexport async function writeAppManifest(manifest: AppManifest, path: string): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n  await writeFile(path, JSON.stringify(toPortableManifest(manifest), null, 2), \"utf8\");\n}\n\nexport async function writeRouteTypes(manifest: AppManifest, path: string): Promise<void> {\n  const routePaths = manifest.routes.pages.map((route) => JSON.stringify(route.path));\n  const actionNames = Object.values(manifest.actions)\n    .flatMap((actions) => Object.keys(actions))\n    .filter((name, index, names) => names.indexOf(name) === index)\n    .map((name) => JSON.stringify(name));\n  const source = [\n    `export type ElurRoutePath = ${routePaths.length ? routePaths.join(\" | \") : \"never\"};`,\n    `export type ElurActionName = ${actionNames.length ? actionNames.join(\" | \") : \"never\"};`,\n    \"export interface ElurRouteParams { [name: string]: string | string[] | undefined }\",\n    \"\",\n  ].join(\"\\n\");\n  await mkdir(dirname(path), { recursive: true });\n  await writeFile(path, source, \"utf8\");\n}\n\nexport function validateManifestRoutes(routes: ScannedRoutes): void {\n  const seen = new Map<string, string>();\n  for (const route of routes.pages) {\n    registerRoute(seen, route.path, route.pagePath, \"page\");\n    assertNotReserved(route.path, route.pagePath);\n  }\n  for (const route of routes.api) {\n    registerRoute(seen, route.path, route.routePath, \"API\");\n    assertNotReserved(route.path, route.routePath);\n  }\n}\n\nexport function assertClientImportAllowed(id: string, importer?: string): void {\n  if (/\\.server\\.[cm]?[jt]sx?$/.test(id)) {\n    throw new Error(`[elur-kit] Server-only module imported by client${importer ? ` from ${importer}` : \"\"}: ${id}`);\n  }\n}\n\nfunction registerRoute(seen: Map<string, string>, path: string, file: string, kind: string): void {\n  const existing = seen.get(path);\n  if (existing) {\n    throw new Error(`[elur-kit] Duplicate ${kind} route \"${path}\": ${existing} and ${file}`);\n  }\n  seen.set(path, file);\n}\n\nfunction assertNotReserved(path: string, file: string): void {\n  if (path === \"/__elur-js\" || path.startsWith(\"/__elur-js/\") || path === \"/_elur\" || path.startsWith(\"/_elur/\")) {\n    throw new Error(`[elur-kit] Reserved route \"${path}\" declared by ${file}`);\n  }\n}\n\nfunction validateIslands(islands: readonly IslandModule[]): void {\n  const names = new Set<string>();\n  for (const island of islands) {\n    if (names.has(island.name)) throw new Error(`[elur-kit] Duplicate island name: ${island.name}`);\n    names.add(island.name);\n  }\n}\n\nfunction toPortableManifest(manifest: AppManifest): AppManifest {\n  const relativePath = (path: string | undefined) => path ? relative(manifest.root, path).split(\"\\\\\").join(\"/\") : undefined;\n  const routes: ScannedRoutes = {\n    pages: manifest.routes.pages.map((route) => ({\n      ...route,\n      pagePath: relativePath(route.pagePath)!,\n      dataPath: relativePath(route.dataPath),\n      actionPath: relativePath(route.actionPath),\n      loadingPath: relativePath(route.loadingPath),\n      layouts: route.layouts.map((layout) => relativePath(layout)!),\n    })),\n    api: manifest.routes.api.map((route) => ({ ...route, routePath: relativePath(route.routePath)! })),\n    error404: manifest.routes.error404 ? {\n      ...manifest.routes.error404,\n      pagePath: relativePath(manifest.routes.error404.pagePath)!,\n      dataPath: relativePath(manifest.routes.error404.dataPath),\n      actionPath: relativePath(manifest.routes.error404.actionPath),\n      loadingPath: relativePath(manifest.routes.error404.loadingPath),\n      layouts: manifest.routes.error404.layouts.map((layout) => relativePath(layout)!),\n    } : undefined,\n    error500: manifest.routes.error500 ? {\n      ...manifest.routes.error500,\n      pagePath: relativePath(manifest.routes.error500.pagePath)!,\n      dataPath: relativePath(manifest.routes.error500.dataPath),\n      actionPath: relativePath(manifest.routes.error500.actionPath),\n      loadingPath: relativePath(manifest.routes.error500.loadingPath),\n      layouts: manifest.routes.error500.layouts.map((layout) => relativePath(layout)!),\n    } : undefined,\n  };\n  const actions: ActionRegistry = {};\n  for (const [page, pageActions] of Object.entries(manifest.actions)) {\n    actions[page] = Object.fromEntries(\n      Object.entries(pageActions).map(([name, path]) => [name, relativePath(path)!]),\n    );\n  }\n  return {\n    ...manifest,\n    root: \".\",\n    routes,\n    actions,\n    islands: manifest.islands.map((island) => ({ ...island, filePath: relativePath(island.filePath)! })),\n  };\n}\n"],"mappings":"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"}

package/dist/lib/manifest/index.d.cts

@@ -0,0 +1,18 @@
+import { type ActionRegistry } from "../action/scan.js";
+import type { ResolvedElurConfig } from "../config/index.js";
+import { type IslandModule } from "../island/scan.js";
+import { type ScannedRoutes } from "../router/route-scanner.js";
+export interface AppManifest {
+    version: 1;
+    root: string;
+    routes: ScannedRoutes;
+    actions: ActionRegistry;
+    islands: IslandModule[];
+    base: string;
+    output: ResolvedElurConfig["output"];
+}
+export declare function createAppManifest(config: ResolvedElurConfig): Promise<AppManifest>;
+export declare function writeAppManifest(manifest: AppManifest, path: string): Promise<void>;
+export declare function writeRouteTypes(manifest: AppManifest, path: string): Promise<void>;
+export declare function validateManifestRoutes(routes: ScannedRoutes): void;
+export declare function assertClientImportAllowed(id: string, importer?: string): void;

package/dist/lib/manifest/index.d.ts

@@ -0,0 +1,18 @@
+import { type ActionRegistry } from "../action/scan.js";
+import type { ResolvedElurConfig } from "../config/index.js";
+import { type IslandModule } from "../island/scan.js";
+import { type ScannedRoutes } from "../router/route-scanner.js";
+export interface AppManifest {
+    version: 1;
+    root: string;
+    routes: ScannedRoutes;
+    actions: ActionRegistry;
+    islands: IslandModule[];
+    base: string;
+    output: ResolvedElurConfig["output"];
+}
+export declare function createAppManifest(config: ResolvedElurConfig): Promise<AppManifest>;
+export declare function writeAppManifest(manifest: AppManifest, path: string): Promise<void>;
+export declare function writeRouteTypes(manifest: AppManifest, path: string): Promise<void>;
+export declare function validateManifestRoutes(routes: ScannedRoutes): void;
+export declare function assertClientImportAllowed(id: string, importer?: string): void;

package/dist/lib/manifest/index.js

@@ -0,0 +1,110 @@
+import { t as e } from "../route-scanner-XcLId7lK.js";
+import { t } from "../scan-Dn93ycXG.js";
+import { n } from "../scan-CjMUgnsd.js";
+import { t as r } from "../integrations-7dpN1RYB.js";
+import { mkdir as i, writeFile as a } from "node:fs/promises";
+import { dirname as o, relative as s } from "node:path";
+//#region src/manifest/index.ts
+async function c(i) {
+	let [a, o, s] = await Promise.all([
+		e(i.appDir),
+		n(i.appDir),
+		t(i.islandsDir)
+	]);
+	d(a), h(s);
+	let c = {
+		version: 1,
+		root: i.root,
+		routes: a,
+		actions: o,
+		islands: s,
+		base: i.base,
+		output: i.output
+	};
+	return await r(i.integrations, "routes", [c, {
+		root: i.root,
+		command: "build"
+	}]), c;
+}
+async function l(e, t) {
+	await i(o(t), { recursive: !0 }), await a(t, JSON.stringify(g(e), null, 2), "utf8");
+}
+async function u(e, t) {
+	let n = e.routes.pages.map((e) => JSON.stringify(e.path)), r = Object.values(e.actions).flatMap((e) => Object.keys(e)).filter((e, t, n) => n.indexOf(e) === t).map((e) => JSON.stringify(e)), s = [
+		`export type ElurRoutePath = ${n.length ? n.join(" | ") : "never"};`,
+		`export type ElurActionName = ${r.length ? r.join(" | ") : "never"};`,
+		"export interface ElurRouteParams { [name: string]: string | string[] | undefined }",
+		""
+	].join("\n");
+	await i(o(t), { recursive: !0 }), await a(t, s, "utf8");
+}
+function d(e) {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e.pages) p(t, n.path, n.pagePath, "page"), m(n.path, n.pagePath);
+	for (let n of e.api) p(t, n.path, n.routePath, "API"), m(n.path, n.routePath);
+}
+function f(e, t) {
+	if (/\.server\.[cm]?[jt]sx?$/.test(e)) throw Error(`[elur-kit] Server-only module imported by client${t ? ` from ${t}` : ""}: ${e}`);
+}
+function p(e, t, n, r) {
+	let i = e.get(t);
+	if (i) throw Error(`[elur-kit] Duplicate ${r} route "${t}": ${i} and ${n}`);
+	e.set(t, n);
+}
+function m(e, t) {
+	if (e === "/__elur-js" || e.startsWith("/__elur-js/") || e === "/_elur" || e.startsWith("/_elur/")) throw Error(`[elur-kit] Reserved route "${e}" declared by ${t}`);
+}
+function h(e) {
+	let t = /* @__PURE__ */ new Set();
+	for (let n of e) {
+		if (t.has(n.name)) throw Error(`[elur-kit] Duplicate island name: ${n.name}`);
+		t.add(n.name);
+	}
+}
+function g(e) {
+	let t = (t) => t ? s(e.root, t).split("\\").join("/") : void 0, n = {
+		pages: e.routes.pages.map((e) => ({
+			...e,
+			pagePath: t(e.pagePath),
+			dataPath: t(e.dataPath),
+			actionPath: t(e.actionPath),
+			loadingPath: t(e.loadingPath),
+			layouts: e.layouts.map((e) => t(e))
+		})),
+		api: e.routes.api.map((e) => ({
+			...e,
+			routePath: t(e.routePath)
+		})),
+		error404: e.routes.error404 ? {
+			...e.routes.error404,
+			pagePath: t(e.routes.error404.pagePath),
+			dataPath: t(e.routes.error404.dataPath),
+			actionPath: t(e.routes.error404.actionPath),
+			loadingPath: t(e.routes.error404.loadingPath),
+			layouts: e.routes.error404.layouts.map((e) => t(e))
+		} : void 0,
+		error500: e.routes.error500 ? {
+			...e.routes.error500,
+			pagePath: t(e.routes.error500.pagePath),
+			dataPath: t(e.routes.error500.dataPath),
+			actionPath: t(e.routes.error500.actionPath),
+			loadingPath: t(e.routes.error500.loadingPath),
+			layouts: e.routes.error500.layouts.map((e) => t(e))
+		} : void 0
+	}, r = {};
+	for (let [n, i] of Object.entries(e.actions)) r[n] = Object.fromEntries(Object.entries(i).map(([e, n]) => [e, t(n)]));
+	return {
+		...e,
+		root: ".",
+		routes: n,
+		actions: r,
+		islands: e.islands.map((e) => ({
+			...e,
+			filePath: t(e.filePath)
+		}))
+	};
+}
+//#endregion
+export { f as assertClientImportAllowed, c as createAppManifest, d as validateManifestRoutes, l as writeAppManifest, u as writeRouteTypes };
+
+//# sourceMappingURL=index.js.map

package/dist/lib/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/manifest/index.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, relative } from \"node:path\";\nimport { scanActions, type ActionRegistry } from \"../action/scan.js\";\nimport type { ResolvedElurConfig } from \"../config/index.js\";\nimport { runIntegrationHook } from \"../integrations/index.js\";\nimport { scanIslands, type IslandModule } from \"../island/scan.js\";\nimport { scanRoutes, type ScannedRoutes } from \"../router/route-scanner.js\";\n\nexport interface AppManifest {\n  version: 1;\n  root: string;\n  routes: ScannedRoutes;\n  actions: ActionRegistry;\n  islands: IslandModule[];\n  base: string;\n  output: ResolvedElurConfig[\"output\"];\n}\n\nexport async function createAppManifest(config: ResolvedElurConfig): Promise<AppManifest> {\n  const [routes, actions, islands] = await Promise.all([\n    scanRoutes(config.appDir),\n    scanActions(config.appDir),\n    scanIslands(config.islandsDir),\n  ]);\n  validateManifestRoutes(routes);\n  validateIslands(islands);\n  const manifest: AppManifest = {\n    version: 1,\n    root: config.root,\n    routes,\n    actions,\n    islands,\n    base: config.base,\n    output: config.output,\n  };\n  await runIntegrationHook(config.integrations, \"routes\", [\n    manifest,\n    { root: config.root, command: \"build\" },\n  ]);\n  return manifest;\n}\n\nexport async function writeAppManifest(manifest: AppManifest, path: string): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n  await writeFile(path, JSON.stringify(toPortableManifest(manifest), null, 2), \"utf8\");\n}\n\nexport async function writeRouteTypes(manifest: AppManifest, path: string): Promise<void> {\n  const routePaths = manifest.routes.pages.map((route) => JSON.stringify(route.path));\n  const actionNames = Object.values(manifest.actions)\n    .flatMap((actions) => Object.keys(actions))\n    .filter((name, index, names) => names.indexOf(name) === index)\n    .map((name) => JSON.stringify(name));\n  const source = [\n    `export type ElurRoutePath = ${routePaths.length ? routePaths.join(\" | \") : \"never\"};`,\n    `export type ElurActionName = ${actionNames.length ? actionNames.join(\" | \") : \"never\"};`,\n    \"export interface ElurRouteParams { [name: string]: string | string[] | undefined }\",\n    \"\",\n  ].join(\"\\n\");\n  await mkdir(dirname(path), { recursive: true });\n  await writeFile(path, source, \"utf8\");\n}\n\nexport function validateManifestRoutes(routes: ScannedRoutes): void {\n  const seen = new Map<string, string>();\n  for (const route of routes.pages) {\n    registerRoute(seen, route.path, route.pagePath, \"page\");\n    assertNotReserved(route.path, route.pagePath);\n  }\n  for (const route of routes.api) {\n    registerRoute(seen, route.path, route.routePath, \"API\");\n    assertNotReserved(route.path, route.routePath);\n  }\n}\n\nexport function assertClientImportAllowed(id: string, importer?: string): void {\n  if (/\\.server\\.[cm]?[jt]sx?$/.test(id)) {\n    throw new Error(`[elur-kit] Server-only module imported by client${importer ? ` from ${importer}` : \"\"}: ${id}`);\n  }\n}\n\nfunction registerRoute(seen: Map<string, string>, path: string, file: string, kind: string): void {\n  const existing = seen.get(path);\n  if (existing) {\n    throw new Error(`[elur-kit] Duplicate ${kind} route \"${path}\": ${existing} and ${file}`);\n  }\n  seen.set(path, file);\n}\n\nfunction assertNotReserved(path: string, file: string): void {\n  if (path === \"/__elur-js\" || path.startsWith(\"/__elur-js/\") || path === \"/_elur\" || path.startsWith(\"/_elur/\")) {\n    throw new Error(`[elur-kit] Reserved route \"${path}\" declared by ${file}`);\n  }\n}\n\nfunction validateIslands(islands: readonly IslandModule[]): void {\n  const names = new Set<string>();\n  for (const island of islands) {\n    if (names.has(island.name)) throw new Error(`[elur-kit] Duplicate island name: ${island.name}`);\n    names.add(island.name);\n  }\n}\n\nfunction toPortableManifest(manifest: AppManifest): AppManifest {\n  const relativePath = (path: string | undefined) => path ? relative(manifest.root, path).split(\"\\\\\").join(\"/\") : undefined;\n  const routes: ScannedRoutes = {\n    pages: manifest.routes.pages.map((route) => ({\n      ...route,\n      pagePath: relativePath(route.pagePath)!,\n      dataPath: relativePath(route.dataPath),\n      actionPath: relativePath(route.actionPath),\n      loadingPath: relativePath(route.loadingPath),\n      layouts: route.layouts.map((layout) => relativePath(layout)!),\n    })),\n    api: manifest.routes.api.map((route) => ({ ...route, routePath: relativePath(route.routePath)! })),\n    error404: manifest.routes.error404 ? {\n      ...manifest.routes.error404,\n      pagePath: relativePath(manifest.routes.error404.pagePath)!,\n      dataPath: relativePath(manifest.routes.error404.dataPath),\n      actionPath: relativePath(manifest.routes.error404.actionPath),\n      loadingPath: relativePath(manifest.routes.error404.loadingPath),\n      layouts: manifest.routes.error404.layouts.map((layout) => relativePath(layout)!),\n    } : undefined,\n    error500: manifest.routes.error500 ? {\n      ...manifest.routes.error500,\n      pagePath: relativePath(manifest.routes.error500.pagePath)!,\n      dataPath: relativePath(manifest.routes.error500.dataPath),\n      actionPath: relativePath(manifest.routes.error500.actionPath),\n      loadingPath: relativePath(manifest.routes.error500.loadingPath),\n      layouts: manifest.routes.error500.layouts.map((layout) => relativePath(layout)!),\n    } : undefined,\n  };\n  const actions: ActionRegistry = {};\n  for (const [page, pageActions] of Object.entries(manifest.actions)) {\n    actions[page] = Object.fromEntries(\n      Object.entries(pageActions).map(([name, path]) => [name, relativePath(path)!]),\n    );\n  }\n  return {\n    ...manifest,\n    root: \".\",\n    routes,\n    actions,\n    islands: manifest.islands.map((island) => ({ ...island, filePath: relativePath(island.filePath)! })),\n  };\n}\n"],"mappings":"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"}

package/dist/lib/middleware/index.d.cts

@@ -0,0 +1,56 @@
+/** The middleware function signature. */
+export type Middleware = (request: Request, context: MiddlewareContext) => Response | void | Promise<Response | void>;
+/** Context passed to the middleware function. */
+export interface MiddlewareContext {
+    /** Helper to continue to the next handler. Can attach headers, params, and locals. */
+    next(options?: {
+        headers?: Record<string, string>;
+        params?: Record<string, string | string[]>;
+        locals?: Record<string, unknown>;
+    }): void;
+    /** Matched route params (only available if the path matches a page route). */
+    params?: Record<string, string | string[]>;
+    /** Per-request locals (populated by middleware, available to loaders/actions). */
+    locals?: Record<string, unknown>;
+}
+/** Configuration for the middleware module. */
+export interface MiddlewareConfig {
+    /** Path patterns that trigger the middleware. Supports `:param` and `:param*`. */
+    matcher?: string[];
+}
+export interface LoadedMiddleware {
+    handler: Middleware;
+    config: MiddlewareConfig;
+}
+/** Result of running middleware: either a response to short-circuit with, or continue. */
+export type MiddlewareResult = {
+    kind: "response";
+    response: Response;
+} | {
+    kind: "continue";
+    headers?: Record<string, string>;
+    params?: Record<string, string | string[]>;
+    locals?: Record<string, unknown>;
+};
+/**
+ * Loads the user's `src/middleware.ts` module. Returns `null` if no middleware
+ * file exists. Distinguishes "file not found" from "file has errors" (§6):
+ * an import error is not silently treated as "no middleware".
+ */
+export declare function loadMiddleware(root: string): Promise<LoadedMiddleware | null>;
+/**
+ * Checks if a pathname matches any of the middleware's matcher patterns.
+ * If no matcher is configured, the middleware runs for every request.
+ *
+ * Catch-all patterns (`:param*`) match both the base path and any sub-paths,
+ * e.g. `/dashboard/:path*` matches `/dashboard` and `/dashboard/settings/users`.
+ */
+export declare function matchesMiddleware(pathname: string, config: MiddlewareConfig): boolean;
+/**
+ * Runs the middleware for a request. Returns the result indicating whether to
+ * short-circuit with a response or continue with propagated headers/params/locals.
+ *
+ * Per §6: cleanup runs in `finally`, response short-circuits the pipeline,
+ * headers/params/locals are propagated to downstream handlers.
+ */
+export declare function runMiddleware(middleware: LoadedMiddleware, request: Request, params?: Record<string, string | string[]>): Promise<MiddlewareResult>;

package/dist/lib/middleware/index.d.ts

@@ -0,0 +1,56 @@
+/** The middleware function signature. */
+export type Middleware = (request: Request, context: MiddlewareContext) => Response | void | Promise<Response | void>;
+/** Context passed to the middleware function. */
+export interface MiddlewareContext {
+    /** Helper to continue to the next handler. Can attach headers, params, and locals. */
+    next(options?: {
+        headers?: Record<string, string>;
+        params?: Record<string, string | string[]>;
+        locals?: Record<string, unknown>;
+    }): void;
+    /** Matched route params (only available if the path matches a page route). */
+    params?: Record<string, string | string[]>;
+    /** Per-request locals (populated by middleware, available to loaders/actions). */
+    locals?: Record<string, unknown>;
+}
+/** Configuration for the middleware module. */
+export interface MiddlewareConfig {
+    /** Path patterns that trigger the middleware. Supports `:param` and `:param*`. */
+    matcher?: string[];
+}
+export interface LoadedMiddleware {
+    handler: Middleware;
+    config: MiddlewareConfig;
+}
+/** Result of running middleware: either a response to short-circuit with, or continue. */
+export type MiddlewareResult = {
+    kind: "response";
+    response: Response;
+} | {
+    kind: "continue";
+    headers?: Record<string, string>;
+    params?: Record<string, string | string[]>;
+    locals?: Record<string, unknown>;
+};
+/**
+ * Loads the user's `src/middleware.ts` module. Returns `null` if no middleware
+ * file exists. Distinguishes "file not found" from "file has errors" (§6):
+ * an import error is not silently treated as "no middleware".
+ */
+export declare function loadMiddleware(root: string): Promise<LoadedMiddleware | null>;
+/**
+ * Checks if a pathname matches any of the middleware's matcher patterns.
+ * If no matcher is configured, the middleware runs for every request.
+ *
+ * Catch-all patterns (`:param*`) match both the base path and any sub-paths,
+ * e.g. `/dashboard/:path*` matches `/dashboard` and `/dashboard/settings/users`.
+ */
+export declare function matchesMiddleware(pathname: string, config: MiddlewareConfig): boolean;
+/**
+ * Runs the middleware for a request. Returns the result indicating whether to
+ * short-circuit with a response or continue with propagated headers/params/locals.
+ *
+ * Per §6: cleanup runs in `finally`, response short-circuits the pipeline,
+ * headers/params/locals are propagated to downstream handlers.
+ */
+export declare function runMiddleware(middleware: LoadedMiddleware, request: Request, params?: Record<string, string | string[]>): Promise<MiddlewareResult>;

package/dist/lib/middleware/stream-boundary.d.cts

@@ -0,0 +1,53 @@
+import type { ElurTemplate } from "@elurjs/core";
+export interface StreamBoundaryOptions<T> {
+    /** Fallback content shown while the promise resolves. */
+    fallback: ElurTemplate;
+    /** Promise that resolves to a ElurTemplate. */
+    promise: Promise<T>;
+    /** Renders the resolved value to a ElurTemplate. */
+    children: (value: T) => ElurTemplate;
+}
+/** Per-request boundary registry. */
+interface BoundaryContext {
+    boundaries: Map<string, {
+        promise: Promise<unknown>;
+        children: (value: unknown) => ElurTemplate;
+    }>;
+}
+/**
+ * Gets the current per-request boundary context, if any.
+ * Used by the streaming response to collect boundaries for later resolution.
+ */
+export declare function getCurrentBoundaryContext(): BoundaryContext | undefined;
+/**
+ * Runs a function within a per-request boundary context.
+ * Used by the SSR streaming pipeline to collect boundaries.
+ */
+export declare function withBoundaryContext<T>(fn: () => T): T;
+/**
+ * Builds the fallback HTML wrapper for a boundary ID.
+ * The fallback content is wrapped in a `<div>` with the boundary ID so the
+ * browser can find it and replace it when the resolved content arrives.
+ *
+ * (v2.1 — Fix #4: real Suspense streaming with `<template>` replacement)
+ */
+export declare function buildFallbackHtml(boundaryId: string, fallbackHtml: string): string;
+/**
+ * Builds the resolved content chunk for a boundary ID.
+ * Emits a `<template>` element with the resolved content, followed by a
+ * `<script>` that replaces the fallback div with the template content
+ * in-place. This is real Suspense streaming — the browser swaps the DOM
+ * node without a full re-render.
+ *
+ * (v2.1 — Fix #4: real Suspense streaming with `<template>` replacement)
+ */
+export declare function buildResolvedChunk(boundaryId: string, resolvedHtml: string): string;
+/**
+ * Creates a stream boundary. During SSR, emits the fallback and registers the
+ * promise for later resolution by the streaming pipeline. During SSG, the
+ * build awaits all boundaries before writing HTML.
+ *
+ * The boundary ID is deterministic per-request via crypto.randomUUID().
+ */
+export declare function streamBoundary<T>(options: StreamBoundaryOptions<T>): ElurTemplate;
+export {};

package/dist/lib/middleware/stream-boundary.d.ts

@@ -0,0 +1,53 @@
+import type { ElurTemplate } from "@elurjs/core";
+export interface StreamBoundaryOptions<T> {
+    /** Fallback content shown while the promise resolves. */
+    fallback: ElurTemplate;
+    /** Promise that resolves to a ElurTemplate. */
+    promise: Promise<T>;
+    /** Renders the resolved value to a ElurTemplate. */
+    children: (value: T) => ElurTemplate;
+}
+/** Per-request boundary registry. */
+interface BoundaryContext {
+    boundaries: Map<string, {
+        promise: Promise<unknown>;
+        children: (value: unknown) => ElurTemplate;
+    }>;
+}
+/**
+ * Gets the current per-request boundary context, if any.
+ * Used by the streaming response to collect boundaries for later resolution.
+ */
+export declare function getCurrentBoundaryContext(): BoundaryContext | undefined;
+/**
+ * Runs a function within a per-request boundary context.
+ * Used by the SSR streaming pipeline to collect boundaries.
+ */
+export declare function withBoundaryContext<T>(fn: () => T): T;
+/**
+ * Builds the fallback HTML wrapper for a boundary ID.
+ * The fallback content is wrapped in a `<div>` with the boundary ID so the
+ * browser can find it and replace it when the resolved content arrives.
+ *
+ * (v2.1 — Fix #4: real Suspense streaming with `<template>` replacement)
+ */
+export declare function buildFallbackHtml(boundaryId: string, fallbackHtml: string): string;
+/**
+ * Builds the resolved content chunk for a boundary ID.
+ * Emits a `<template>` element with the resolved content, followed by a
+ * `<script>` that replaces the fallback div with the template content
+ * in-place. This is real Suspense streaming — the browser swaps the DOM
+ * node without a full re-render.
+ *
+ * (v2.1 — Fix #4: real Suspense streaming with `<template>` replacement)
+ */
+export declare function buildResolvedChunk(boundaryId: string, resolvedHtml: string): string;
+/**
+ * Creates a stream boundary. During SSR, emits the fallback and registers the
+ * promise for later resolution by the streaming pipeline. During SSG, the
+ * build awaits all boundaries before writing HTML.
+ *
+ * The boundary ID is deterministic per-request via crypto.randomUUID().
+ */
+export declare function streamBoundary<T>(options: StreamBoundaryOptions<T>): ElurTemplate;
+export {};