fuzor 0.3.0 → 0.5.0

package/dist/runtime/index.d.ts

@@ -1,31 +1,78 @@
-import { Context, Effect, Layer } from "effect";
-export { createUrlAtom } from "./atom.js";
-import { type IslandRegistry } from "./islands.js";
-export { mountIslands } from "./islands.js";
-export type { IslandModule, IslandRegistry } from "./islands.js";
-export type HistoryHost = {
-    readonly current: () => Effect.Effect<string>;
-    readonly push: (path: string) => Effect.Effect<void>;
-    readonly replace: (path: string) => Effect.Effect<void>;
-    readonly back: () => Effect.Effect<void>;
-    readonly forward: () => Effect.Effect<void>;
-    readonly listen: (listener: (path: string) => void) => () => void;
-};
-export declare const PlatformHistory: Context.Service<HistoryHost, HistoryHost>;
-export declare function browserHistory(): HistoryHost;
-export declare function memoryHistory(initialPath?: string): HistoryHost;
-export declare const BrowserHistoryLive: Layer.Layer<HistoryHost, never, never>;
-export declare const VirtualHistoryLive: (initialPath?: string) => Layer.Layer<HistoryHost, never, never>;
-export declare function normalizePath(path: string): string;
-export declare function normalizeHref(path: string): string;
-export type RouterOptions = {
-    readonly host?: HistoryHost;
-    readonly islands?: IslandRegistry;
-};
+export { makeHashNavigation, HashNavigationLive } from "./hash-navigation.js";
+export type { HashNavigationOptions } from "./hash-navigation.js";
+export { coordinateNavigation } from "./coordinated-navigation.js";
+export { loadRouteData, abortRouteData, routeData, fillDataSlots, RouteDataError } from "./data.js";
+import { type HrefOptions } from "./href.js";
+export type { HrefOptions } from "./href.js";
+import { type RouterOptions } from "./router.js";
+export { makeHistoryNavigation, HistoryNavigationLive } from "./history-navigation.js";
+export type { HistoryNavigationOptions } from "./history-navigation.js";
+export { Navigation, NavigationError } from "./navigation.js";
+export { makeMemoryNavigation, MemoryNavigationLive } from "./memory-navigation.js";
+export type { MemoryNavigationOptions } from "./memory-navigation.js";
+export { makeBrowserNavigation, BrowserNavigationLive, supportsBrowserNavigation, navigationBrowser, navigateDocument } from "./browser-navigation.js";
+export type { NavigationBrowser, BrowserInterception } from "./browser-navigation.js";
+export { makeNavigationCoordinator, NavigationLifecycleError } from "./coordinator.js";
+export type { NavigationLifecycle, NavigationState, NavigationPhase } from "./coordinator.js";
+export type { NavigationAdapter, NavigationChange, NavigationIntent, NavigationKind, NavigationSnapshot, NavigationTransition } from "./navigation.js";
+export { makeNavigationUrlAtom, UrlAtomError } from "./navigation-atom.js";
+export { mountIslands, mountIslandsEffect, IslandActivationError, islandErrorHandler, routeParams, reloadOnStaleDeployment, isStaleDeploymentError } from "./islands.js";
+export type { IslandModule, IslandRegistry, IslandCleanup, IslandErrorHandler, IslandTimeouts } from "./islands.js";
+export { routeKey, normalizeBase, stripBase, withBase } from "../route-path.js";
+export { normalizePath, getRouter, createRouterWith } from "./router.js";
+export type { RouterOptions, RouterTransports, NavigateOptions, RouteMatch, NavigationOutcome, NavigationResult, NavigationAttempt, NavigationBlocker, FuzorRouter } from "./router.js";
+export { makeDocumentNavigation } from "./document-navigation.js";
+/**
+ * The SPA router for a compiled outlet. It uses the browser Navigation API where available, the History API
+ * elsewhere and fragment routing for `file:` and custom-protocol documents.
+ */
 export declare function createRouter(outlet: HTMLElement, options?: RouterOptions): {
-    start: () => Promise<() => void>;
-    navigate: (path: string, replace?: boolean) => Promise<void>;
+    matches: () => readonly import("./route-matches.js").ActiveRouteMatch[];
+    subscribeMatches: (listener: (matches: readonly import("./route-matches.js").ActiveRouteMatch[]) => void) => () => void;
+    start: () => Promise<() => Promise<void>>;
+    block: (blocker: import("./router.js").NavigationBlocker) => () => void;
+    navigation: () => import("./navigation.js").NavigationAdapter | undefined;
+    dispose: () => Promise<void>;
+    navigate: (href: string, request?: import("./router.js").NavigateOptions) => import("./router.js").NavigationResult;
+    state: () => import("./coordinator.js").NavigationState<import("./router.js").RouteMatch> | undefined;
+    subscribeState: (listener: (state: import("./coordinator.js").NavigationState<import("./router.js").RouteMatch> | undefined) => void) => () => void;
+    route: () => import("./router.js").RouteMatch | undefined;
+    subscribeRoute: (listener: (route: import("./router.js").RouteMatch | undefined) => void) => () => void;
+    url: () => string;
+    subscribeUrl: (listener: (url: string) => void) => () => void;
     path: () => string;
+    params: () => Readonly<Record<string, string>>;
+    subscribeParams: (listener: (params: Readonly<Record<string, string>>) => void) => () => void;
     subscribe: (listener: (path: string) => void) => () => void;
 };
+/**
+ * Compiled route and endpoint patterns, filled in by the generated `.fuzor/routes.d.ts`. Keys are patterns such
+ * as `/blog/[slug]/` or `/api/users/[id]`; values are their parameters.
+ */
+export interface FuzorRoutes {
+}
+/**
+ * Parameters of a route whose `paths` module exports a `params` Schema: the schema's encoded (URL) form, such
+ * as `{ id: string }` for `Schema.Struct({ id: Schema.FiniteFromString })`. Decode `routeParams()` or
+ * `router.params()` with the same schema to get typed values.
+ */
+export type SchemaRouteParams<Module> = Module extends {
+    readonly params: {
+        readonly Encoded: infer Encoded;
+    };
+} ? Encoded : Readonly<Record<string, string | number>>;
+/** A compiled route or endpoint pattern, or any string before route types are generated. */
+export type RoutePattern = keyof FuzorRoutes extends never ? string : Extract<keyof FuzorRoutes, string>;
+type ParamsFor<P> = P extends keyof FuzorRoutes ? FuzorRoutes[P] : Readonly<Record<string, string | number>>;
+/**
+ * Builds an app URL from a route pattern, checking parameters against the generated route types:
+ * `href("/blog/[slug]/", { slug: "hello" })`, `href("/api/users/[id]", { id: 7 }, { search: { full: true } })`.
+ */
+export declare function href<P extends RoutePattern>(pattern: P, ...args: keyof ParamsFor<P> extends never ? [params?: Readonly<Record<string, never>>, options?: HrefOptions] : [params: ParamsFor<P>, options?: HrefOptions]): string;
+export type { ClientRoutes } from "./client-routes.js";
+export { makeRouteMatches } from "./route-matches.js";
+export type { RouteDefinition, ActiveRouteMatch } from "./route-matches.js";
+export { mountPageScripts, mountPageScriptsEffect, PageScriptActivationError } from "./page-scripts.js";
+export type { PageScriptContext, PageScriptModule, PageScriptRegistry, RouteScriptBinding, RouteScriptModule, PageScriptController, PageScriptOptions, PageScriptStatus } from "./page-scripts.js";
+export { makeClientRouteMatcher } from "./client-routes.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEjE,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACnE,CAAC;AAEF,eAAO,MAAM,eAAe,2CAAuD,CAAC;AAIpF,wBAAgB,cAAc,IAAI,WAAW,CAa5C;AAED,wBAAgB,aAAa,CAAC,WAAW,SAAM,GAAG,WAAW,CAqB5D;AAED,eAAO,MAAM,kBAAkB,wCAAmD,CAAC;AACnF,eAAO,MAAM,kBAAkB,GAAI,oBAAiB,2CAA+D,CAAC;AAEpH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC,CAAC;AAEF,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB;;qBAwB7C,MAAM;;0BAgCgD,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI;EAC3G"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"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"}

package/dist/runtime/index.js

@@ -1,121 +1,36 @@
-import { Context, Effect, Layer, Schema } from "effect";
-import { Atom, AtomRegistry } from "effect/unstable/reactivity";
-export { createUrlAtom } from "./atom.js";
-import { mountIslands } from "./islands.js";
-export { mountIslands } from "./islands.js";
-export const PlatformHistory = Context.Service("FuzorPlatformHistory");
-const PathSchema = Schema.String;
-export function browserHistory() {
-    return {
-        current: () => Effect.sync(() => `${window.location.pathname}${window.location.search}${window.location.hash}`),
-        push: (path) => Effect.sync(() => window.history.pushState(null, "", path)),
-        replace: (path) => Effect.sync(() => window.history.replaceState(null, "", path)),
-        back: () => Effect.sync(() => window.history.back()),
-        forward: () => Effect.sync(() => window.history.forward()),
-        listen: (listener) => {
-            const onPop = () => listener(`${window.location.pathname}${window.location.search}${window.location.hash}`);
-            window.addEventListener("popstate", onPop);
-            return () => window.removeEventListener("popstate", onPop);
-        }
-    };
-}
-export function memoryHistory(initialPath = "/") {
-    const entries = [normalizeHref(initialPath)];
-    let index = 0;
-    const listeners = new Set();
-    const notify = () => listeners.forEach((listener) => listener(entries[index]));
-    return {
-        current: () => Effect.sync(() => entries[index]),
-        push: (path) => Effect.sync(() => {
-            entries.splice(index + 1, entries.length, normalizeHref(path));
-            index++;
-        }),
-        replace: (path) => Effect.sync(() => {
-            entries[index] = normalizeHref(path);
-        }),
-        back: () => Effect.sync(() => { if (index > 0) {
-            index--;
-            notify();
-        } }),
-        forward: () => Effect.sync(() => { if (index < entries.length - 1) {
-            index++;
-            notify();
-        } }),
-        listen: (listener) => {
-            listeners.add(listener);
-            return () => listeners.delete(listener);
-        }
-    };
-}
-export const BrowserHistoryLive = Layer.succeed(PlatformHistory, browserHistory());
-export const VirtualHistoryLive = (initialPath = "/") => Layer.succeed(PlatformHistory, memoryHistory(initialPath));
-export function normalizePath(path) {
-    const pathname = new URL(path, "http://fuzor.local").pathname;
-    return pathname === "/" ? "/" : `${pathname.replace(/\/+$/, "")}/`;
-}
-export function normalizeHref(path) {
-    const url = new URL(path, "http://fuzor.local");
-    return `${normalizePath(url.pathname)}${url.search}${url.hash}`;
-}
+import { makeHashNavigation } from "./hash-navigation.js";
+export { makeHashNavigation, HashNavigationLive } from "./hash-navigation.js";
+export { coordinateNavigation } from "./coordinated-navigation.js";
+export { loadRouteData, abortRouteData, routeData, fillDataSlots, RouteDataError } from "./data.js";
+import { buildHref } from "./href.js";
+import { makeHistoryNavigation } from "./history-navigation.js";
+import { makeBrowserNavigation } from "./browser-navigation.js";
+import { createRouterWith } from "./router.js";
+export { makeHistoryNavigation, HistoryNavigationLive } from "./history-navigation.js";
+export { Navigation, NavigationError } from "./navigation.js";
+export { makeMemoryNavigation, MemoryNavigationLive } from "./memory-navigation.js";
+export { makeBrowserNavigation, BrowserNavigationLive, supportsBrowserNavigation, navigationBrowser, navigateDocument } from "./browser-navigation.js";
+export { makeNavigationCoordinator, NavigationLifecycleError } from "./coordinator.js";
+export { makeNavigationUrlAtom, UrlAtomError } from "./navigation-atom.js";
+export { mountIslands, mountIslandsEffect, IslandActivationError, islandErrorHandler, routeParams, reloadOnStaleDeployment, isStaleDeploymentError } from "./islands.js";
+export { routeKey, normalizeBase, stripBase, withBase } from "../route-path.js";
+export { normalizePath, getRouter, createRouterWith } from "./router.js";
+export { makeDocumentNavigation } from "./document-navigation.js";
+/**
+ * The SPA router for a compiled outlet. It uses the browser Navigation API where available, the History API
+ * elsewhere and fragment routing for `file:` and custom-protocol documents.
+ */
 export function createRouter(outlet, options = {}) {
-    const history = options.host ?? (typeof window === "undefined" ? memoryHistory() : browserHistory());
-    const registry = AtomRegistry.make();
-    const pathAtom = Atom.make("/");
-    const templates = new Map();
-    for (const template of document.querySelectorAll("template[data-fuzor-route]")) {
-        templates.set(normalizePath(template.dataset.fuzorRoute), template);
-    }
-    let cleanupIslands = () => { };
-    let renderVersion = 0;
-    const render = async (path) => {
-        const version = ++renderVersion;
-        const normalized = Schema.decodeUnknownSync(PathSchema)(normalizePath(path));
-        const template = templates.get(normalized);
-        if (!template)
-            throw new Error(`No Fuzor route for ${normalized}`);
-        cleanupIslands();
-        outlet.replaceChildren(template.content.cloneNode(true));
-        registry.set(pathAtom, normalized);
-        const cleanup = await mountIslands(outlet, options.islands ?? {});
-        if (version === renderVersion)
-            cleanupIslands = cleanup;
-        else
-            cleanup();
-    };
-    const navigate = async (path, replace = false) => {
-        const href = normalizeHref(path);
-        const normalized = normalizePath(href);
-        if (!templates.has(normalized))
-            throw new Error(`No Fuzor route for ${normalized}`);
-        await Effect.runPromise(replace ? history.replace(href) : history.push(href));
-        await render(normalized);
-    };
-    const onClick = (event) => {
-        if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey)
-            return;
-        const target = event.target;
-        if (!(target instanceof Element))
-            return;
-        const link = target.closest("a[href]");
-        if (!link || link.target || link.hasAttribute("download"))
-            return;
-        const url = new URL(link.href, window.location.href);
-        if (url.origin !== window.location.origin || !templates.has(normalizePath(url.pathname)))
-            return;
-        event.preventDefault();
-        void navigate(url.pathname + url.search + url.hash);
-    };
-    const start = async () => {
-        await render(await Effect.runPromise(history.current()));
-        const unlisten = history.listen((path) => void render(path));
-        document.addEventListener("click", onClick);
-        return () => {
-            unlisten();
-            document.removeEventListener("click", onClick);
-            cleanupIslands();
-            registry.dispose();
-        };
-    };
-    return { start, navigate, path: () => registry.get(pathAtom), subscribe: (listener) => registry.subscribe(pathAtom, listener) };
+    return createRouterWith(outlet, options, { hash: makeHashNavigation, history: makeHistoryNavigation, browser: makeBrowserNavigation });
+}
+/**
+ * Builds an app URL from a route pattern, checking parameters against the generated route types:
+ * `href("/blog/[slug]/", { slug: "hello" })`, `href("/api/users/[id]", { id: 7 }, { search: { full: true } })`.
+ */
+export function href(pattern, ...args) {
+    return buildHref(pattern, args[0], args[1]);
 }
+export { makeRouteMatches } from "./route-matches.js";
+export { mountPageScripts, mountPageScriptsEffect, PageScriptActivationError } from "./page-scripts.js";
+export { makeClientRouteMatcher } from "./client-routes.js";
 //# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpG,OAAO,EAAE,SAAS,EAAoB,MAAM,WAAW,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEpF,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEvJ,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAGvF,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,WAAW,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGzK,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,UAAyB,EAAE;IAC3E,OAAO,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;AACzI,CAAC;AAoBD;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAyB,OAAU,EAAE,GAAG,IAEX;IAC/C,OAAO,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAA0D,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvG,CAAC;AAKD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGxG,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/runtime/initial-route.d.ts

@@ -0,0 +1,8 @@
+import { type RoutePatterns } from "../route-patterns.js";
+/** Parser-time HTML selection only: no listeners, component mounts, or state restoration. */
+export declare function selectInitialRoute(window: Window, options?: {
+    base?: string;
+    alwaysHash?: boolean;
+    clientRoutes?: RoutePatterns;
+}): void;
+//# sourceMappingURL=initial-route.d.ts.map

package/dist/runtime/initial-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial-route.d.ts","sourceRoot":"","sources":["../../src/runtime/initial-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAInF,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,aAAa,CAAA;CAAO,QAwDrI"}

package/dist/runtime/initial-route.js

@@ -0,0 +1,72 @@
+import { makeRoutePatternMatcher } from "../route-patterns.js";
+import { hashRouteUrl, nearestScope, normalizeBase, routeKey, stripBase, withBase } from "../route-path.js";
+import { commitTemplate, makeHeadManager, templateIdentity } from "./dom-renderer.js";
+/** Parser-time HTML selection only: no listeners, component mounts, or state restoration. */
+export function selectInitialRoute(window, options = {}) {
+    const document = window.document;
+    const outlet = document.querySelector("fuzor-router");
+    if (!outlet)
+        throw new Error("Fuzor outlet is missing");
+    const transport = new URL(window.location.href);
+    const logical = options.alwaysHash || !/^https?:$/.test(transport.protocol);
+    let url = logical ? hashRouteUrl(transport, new URL("http://fuzor.local/")) : transport;
+    const base = normalizeBase(options.base);
+    const pathOf = (url) => {
+        const path = logical ? url.pathname : stripBase(url.pathname, base);
+        return path === undefined ? "\0outside-base" : routeKey(path) ?? path;
+    };
+    const redirects = JSON.parse(document.querySelector("script[data-fuzor-redirects]")?.textContent ?? "{}");
+    const seen = new Set();
+    while (Object.hasOwn(redirects, pathOf(url))) {
+        const path = pathOf(url);
+        if (seen.has(path))
+            throw new Error("Fuzor initial route redirect loop");
+        seen.add(path);
+        const destination = redirects[path];
+        if (/^https?:\/\//i.test(destination)) {
+            window.location.replace(destination);
+            return;
+        }
+        const target = new URL(logical ? destination : withBase(destination, base), url);
+        if (!target.search)
+            target.search = url.search;
+        url = target;
+    }
+    if (seen.size) {
+        const target = logical ? new URL(transport.href) : url;
+        if (logical)
+            target.hash = `${url.pathname}${url.search}${url.hash}`;
+        window.history.replaceState(window.history.state, "", target.href);
+    }
+    const route = pathOf(url);
+    const templates = new Map();
+    for (const template of document.querySelectorAll("template[data-fuzor-route]")) {
+        templates.set(routeKey(template.dataset.fuzorRoute) ?? template.dataset.fuzorRoute, template);
+    }
+    const match = makeRoutePatternMatcher(options.clientRoutes)(route);
+    let template = templates.get(route) ?? templates.get(match?.template ?? "");
+    const metadata = JSON.parse(document.querySelector("script[data-fuzor-metadata]")?.textContent ?? "{}");
+    let head = metadata[route] ?? metadata[match?.template ?? ""] ?? {};
+    if (!template) {
+        const boundaries = new Map();
+        for (const candidate of document.querySelectorAll("template[data-fuzor-not-found]")) {
+            boundaries.set(routeKey(candidate.dataset.fuzorNotFound || "/") ?? "/", candidate);
+        }
+        const scope = nearestScope(route === "\0outside-base" ? "/" : route, boundaries.keys()) ?? "/";
+        template = boundaries.get(scope);
+        head = { title: "Page not found", ...metadata[`not-found:${scope}`] };
+    }
+    if (!template)
+        throw new Error("Fuzor initial route template is missing");
+    makeHeadManager(document, metadata[""])(head);
+    const params = templates.has(route) ? template.getAttribute("data-fuzor-params") : match ? JSON.stringify(match.params) : null;
+    if (params)
+        outlet.setAttribute("data-fuzor-params", params);
+    const data = template.getAttribute("data-fuzor-data");
+    if (data)
+        outlet.setAttribute("data-fuzor-data", data);
+    commitTemplate(outlet, template);
+    outlet.setAttribute("data-fuzor-initial-route", route);
+    outlet.setAttribute("data-fuzor-initial-template", templateIdentity(template));
+}
+//# sourceMappingURL=initial-route.js.map

package/dist/runtime/initial-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initial-route.js","sourceRoot":"","sources":["../../src/runtime/initial-route.ts"],"names":[],"mappings":"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"}

package/dist/runtime/islands.d.ts

@@ -1,6 +1,20 @@
-export type IslandModule = {
-    readonly mount: (host: HTMLElement, props: Record<string, unknown>) => void | (() => void);
-};
-export type IslandRegistry = Record<string, () => Promise<IslandModule>>;
-export declare function mountIslands(root: ParentNode, registry: IslandRegistry): Promise<() => void>;
+import { ActivationError } from "./activation.js";
+import type { ActivationModule, ActivationRegistry, ActivationCleanup, ActivationTimeouts } from "./activation.js";
+export type IslandModule = ActivationModule;
+export type IslandRegistry = ActivationRegistry;
+export type IslandCleanup = ActivationCleanup;
+export type IslandTimeouts = ActivationTimeouts;
+export declare class IslandActivationError extends ActivationError {
+    readonly _tag = "IslandActivationError";
+    constructor(name: string, cause: unknown);
+}
+export type IslandErrorHandler = (error: IslandActivationError, host: HTMLElement, retry: () => Promise<void>) => void;
+export declare const mountIslands: (root: ParentNode, registry: ActivationRegistry, onError?: ((error: IslandActivationError, host: HTMLElement, retry: () => Promise<void>) => void) | undefined, options?: {
+    readonly signal?: AbortSignal;
+} & ActivationTimeouts) => Promise<() => Promise<void>>;
+export declare const mountIslandsEffect: (root: ParentNode, registry: ActivationRegistry, onError?: ((error: IslandActivationError, host: HTMLElement, retry: () => Promise<void>) => void) | undefined, timeouts?: ActivationTimeouts) => import("effect/Effect").Effect<void, IslandActivationError, import("effect/Scope").Scope>;
+export declare const islandErrorHandler: IslandErrorHandler;
+export { isStaleDeploymentError, reloadOnStaleDeployment } from "./stale-deployment.js";
+/** Parameters of the route containing an element, in SPA and MPA documents. */
+export declare function routeParams(element: Element): Readonly<Record<string, string>>;
 //# sourceMappingURL=islands.d.ts.map

package/dist/runtime/islands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"islands.d.ts","sourceRoot":"","sources":["../../src/runtime/islands.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;CAC5F,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AAEzE,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAmClG"}
+{"version":3,"file":"islands.d.ts","sourceRoot":"","sources":["../../src/runtime/islands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAA2B,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACnH,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAC5C,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAChD,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAC9C,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAChD,qBAAa,qBAAsB,SAAQ,eAAe;IACxD,SAAkB,IAAI,2BAA2B;gBACrC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CACzC;AACD,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AAEvH,eAAO,MAAM,YAAY;;uDAAgB,CAAC;AAC1C,eAAO,MAAM,kBAAkB,6RAAsB,CAAC;AACtD,eAAO,MAAM,kBAAkB,EAAE,kBAA0G,CAAC;AAC5I,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACxF,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAG9E"}

package/dist/runtime/islands.js

@@ -1,43 +1,17 @@
-export async function mountIslands(root, registry) {
-    const cleanups = [];
-    const pending = Array.from(root.querySelectorAll("fuzor-island[src]"));
-    await Promise.all(pending.map(async (host) => {
-        let disposed = false;
-        const name = host.getAttribute("src");
-        const load = registry[name];
-        if (!load)
-            throw new Error(`Unknown Fuzor island: ${name}`);
-        const propsText = host.getAttribute("props") ?? "{}";
-        const props = JSON.parse(propsText);
-        const activate = async () => {
-            if (disposed)
-                return;
-            const module = await load();
-            if (disposed)
-                return;
-            const cleanup = module.mount(host, props);
-            if (cleanup)
-                cleanups.push(cleanup);
-        };
-        cleanups.push(() => { disposed = true; });
-        if (host.hasAttribute("client:visible") && typeof IntersectionObserver !== "undefined") {
-            const observer = new IntersectionObserver((entries) => {
-                if (entries.some((entry) => entry.isIntersecting)) {
-                    observer.disconnect();
-                    void activate();
-                }
-            });
-            observer.observe(host);
-            cleanups.push(() => observer.disconnect());
-        }
-        else if (host.hasAttribute("client:idle") && typeof requestIdleCallback !== "undefined") {
-            const handle = requestIdleCallback(() => void activate());
-            cleanups.push(() => cancelIdleCallback(handle));
-        }
-        else {
-            await activate();
-        }
-    }));
-    return () => cleanups.forEach((cleanup) => cleanup());
+import { renderActivationError } from "./dom-renderer.js";
+import { ActivationError, createActivationRuntime } from "./activation.js";
+export class IslandActivationError extends ActivationError {
+    _tag = "IslandActivationError";
+    constructor(name, cause) { super(name, cause); this.message = `Cannot activate island ${name}: ${String(cause)}`; }
+}
+const runtime = createActivationRuntime("fuzor-island", "island", IslandActivationError);
+export const mountIslands = runtime.mount;
+export const mountIslandsEffect = runtime.mountEffect;
+export const islandErrorHandler = (error, host, retry) => { console.error(error); renderActivationError(host, retry); };
+export { isStaleDeploymentError, reloadOnStaleDeployment } from "./stale-deployment.js";
+/** Parameters of the route containing an element, in SPA and MPA documents. */
+export function routeParams(element) {
+    const raw = element.closest("[data-fuzor-params]")?.getAttribute("data-fuzor-params");
+    return raw ? JSON.parse(raw) : {};
 }
 //# sourceMappingURL=islands.js.map

package/dist/runtime/islands.js.map

@@ -1 +1 @@
-{"version":3,"file":"islands.js","sourceRoot":"","sources":["../../src/runtime/islands.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAgB,EAAE,QAAwB;IAC3E,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAc,mBAAmB,CAAC,CAAC,CAAC;IACpF,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3C,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAE,CAAC;QACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAA4B,CAAC;QAC/D,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;YAC1B,IAAI,QAAQ;gBAAE,OAAO;YACrB,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;YAC5B,IAAI,QAAQ;gBAAE,OAAO;YACrB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC1C,IAAI,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,IAAI,OAAO,oBAAoB,KAAK,WAAW,EAAE,CAAC;YACvF,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,CAAC,OAAO,EAAE,EAAE;gBACpD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;oBAClD,QAAQ,CAAC,UAAU,EAAE,CAAC;oBACtB,KAAK,QAAQ,EAAE,CAAC;gBAClB,CAAC;YACH,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,OAAO,mBAAmB,KAAK,WAAW,EAAE,CAAC;YAC1F,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;YAC1D,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC,CAAC;IACJ,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"islands.js","sourceRoot":"","sources":["../../src/runtime/islands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAM3E,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACtC,IAAI,GAAG,uBAAuB,CAAC;IACjD,YAAY,IAAY,EAAE,KAAc,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,0BAA0B,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;CACrI;AAED,MAAM,OAAO,GAAG,uBAAuB,CAAC,cAAc,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;AACzF,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5I,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACxF,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACtF,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC"}

package/dist/runtime/loading.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `<fuzor-loading delay="200" min="500">` indicators. They stay hidden for `delay` milliseconds, so fast loads
+ * never flash them, and once shown stay visible for at least `min` milliseconds, so they do not blink.
+ */
+export type LoadingIndicator = {
+    /** Resolves when hiding the indicators no longer violates their minimum display time, then hides them. */
+    readonly finish: () => Promise<void>;
+    /** Hides the indicators immediately, for cancelled or failed work. */
+    readonly cancel: () => void;
+};
+export declare function showLoading(elements: Iterable<Element>): LoadingIndicator;
+//# sourceMappingURL=loading.d.ts.map

package/dist/runtime/loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading.d.ts","sourceRoot":"","sources":["../../src/runtime/loading.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;CAC7B,CAAC;AAOF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,gBAAgB,CA+BzE"}

package/dist/runtime/loading.js

@@ -0,0 +1,43 @@
+const attribute = (element, name, fallback) => {
+    const value = Number(element.getAttribute(name));
+    return element.hasAttribute(name) && Number.isFinite(value) && value >= 0 ? value : fallback;
+};
+export function showLoading(elements) {
+    const entries = [...elements].map(element => {
+        const window = element.ownerDocument.defaultView;
+        const now = () => window?.performance?.now() ?? Date.now();
+        // Timers must be cleared by the same window that created them.
+        const clear = (timer) => window ? window.clearTimeout(timer) : clearTimeout(timer);
+        const entry = { element, shownAt: undefined, min: attribute(element, "min", 500), timer: undefined, now, clear };
+        entry.timer = (window?.setTimeout.bind(window) ?? setTimeout)(() => {
+            entry.timer = undefined;
+            entry.shownAt = now();
+            element.removeAttribute("hidden");
+        }, attribute(element, "delay", 200));
+        return entry;
+    });
+    const hide = () => {
+        for (const entry of entries) {
+            if (entry.timer !== undefined)
+                entry.clear(entry.timer);
+            entry.timer = undefined;
+            entry.element.setAttribute("hidden", "");
+        }
+    };
+    return {
+        finish: async () => {
+            // Work finished before the delay: those indicators never appear.
+            for (const entry of entries)
+                if (entry.timer !== undefined) {
+                    entry.clear(entry.timer);
+                    entry.timer = undefined;
+                }
+            const remaining = Math.max(0, ...entries.map(entry => entry.shownAt === undefined ? 0 : entry.min - (entry.now() - entry.shownAt)));
+            if (remaining > 0)
+                await new Promise(resolve => setTimeout(resolve, remaining));
+            hide();
+        },
+        cancel: hide
+    };
+}
+//# sourceMappingURL=loading.js.map

package/dist/runtime/loading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading.js","sourceRoot":"","sources":["../../src/runtime/loading.ts"],"names":[],"mappings":"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"}

package/dist/runtime/memory-navigation.d.ts

@@ -0,0 +1,16 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { NavigationError, type NavigationAdapter } from "./navigation.js";
+export type MemoryNavigationOptions = {
+    readonly baseUrl?: string;
+    readonly initialEntries?: ReadonlyArray<{
+        readonly href: string;
+        readonly state?: unknown;
+    }>;
+    readonly initialIndex?: number;
+    readonly onError?: (error: unknown) => void;
+};
+/** No DOM globals, route matching, or rendering; this adapter models committed navigation. */
+export declare function makeMemoryNavigation(options?: MemoryNavigationOptions): Effect.Effect<NavigationAdapter, NavigationError>;
+export declare const MemoryNavigationLive: (options?: MemoryNavigationOptions) => Layer.Layer<NavigationAdapter, NavigationError, never>;
+//# sourceMappingURL=memory-navigation.d.ts.map