@askrjs/askr 0.0.51 → 0.0.53

package/dist/boot/index.js

@@ -1,195 +1,2 @@
-import { isProductionEnvironment } from "../common/env.js";
-import { assertExecutionModel } from "../runtime/execution-model.js";
-import { startHydrationRenderPhase, stopHydrationRenderPhase } from "../common/render-context.js";
-import "../runtime/index.js";
-import { configureScrollRestoration } from "../router/navigation-scroll.js";
-import { _setActiveRouteAuthOptions, hasRegisteredRoutes, lockRouteRegistration } from "../router/store.js";
-import { route } from "../router/authoring.js";
-import { setServerLocation } from "../router/activity.js";
-import { _drainLazy, _snapshotLazy, _snapshotRouteSourceLazy } from "../router/lazy.js";
-import { _applyManifest, clearRoutes } from "../router/manifest.js";
-import "../router/route.js";
-import "../router/navigate.js";
-import { applySelectiveHydration, markSkippedElements, shouldVerifyHydrationMarkup, takeHydrationRenderData } from "./hydration.js";
-import { cleanupApp, flushHydrationActivation, hasApp, mountOrUpdate, registerAppNavigation, registerRootCleanupCallback } from "./root-lifecycle.js";
-import { bindDeniedRouteHandler, bindDeniedStatus, bindResolvedRouteHandler, resolveInitialRoute } from "./route-startup.js";
-//#region src/boot/index.ts
-/**
-* App bootstrap and mount
-*/
-/**
-* createIsland: Enhances existing DOM (no router, mounts once)
-*/
-function createIsland(config) {
-	assertExecutionModel("islands");
-	if (!config || typeof config !== "object") throw new Error("createIsland requires a config object");
-	if (typeof config.component !== "function") throw new Error("createIsland: component must be a function");
-	const rootElement = typeof config.root === "string" ? document.getElementById(config.root) : config.root;
-	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
-	if ("routes" in config) throw new Error("createIsland does not accept routes; use createSPA for routed apps");
-	if (hasRegisteredRoutes()) throw new Error("Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.");
-	mountOrUpdate(rootElement, config.component, { cleanupStrict: config.cleanupStrict });
-}
-/**
-* createIslands: Enhances one or more existing DOM roots (no router).
-* The only public islands constructor.
-*/
-function createIslands(config) {
-	assertExecutionModel("islands");
-	if (!config || typeof config !== "object") throw new Error("createIslands requires a config object");
-	if (!Array.isArray(config.islands) || config.islands.length === 0) throw new Error("createIslands requires a non-empty islands array");
-	for (const island of config.islands) createIsland(island);
-}
-/**
-* createSPA: Initializes router and mounts the app with the provided route manifest or route table.
-*
-* Preferred usage with manifest:
-* ```ts
-* import { getManifest } from '@askrjs/askr/router';
-* await createSPA({ root: '#app', manifest: getManifest() });
-* ```
-*
-* Legacy usage with plain routes array (still supported):
-* ```ts
-* await createSPA({ root: '#app', routes: getRoutes() });
-* ```
-*/
-async function createSPA(config) {
-	assertExecutionModel("spa");
-	if (!config || typeof config !== "object") throw new Error("createSPA requires a config object");
-	const manifest = config.manifest ?? config.registry?.manifest;
-	const routeTable = config.routes ?? config.registry?.routes;
-	const hasManifest = manifest != null && manifest.records.length > 0;
-	const hasRoutes = Array.isArray(routeTable) && routeTable.length > 0;
-	if (!hasManifest && !hasRoutes) throw new Error("createSPA requires a route manifest or route table. Pass `manifest: getManifest()` or `routes: getRoutes()`. If you are enhancing existing HTML, use createIsland instead.");
-	const rootElement = typeof config.root === "string" ? document.getElementById(config.root) : config.root;
-	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
-	const pendingLazyAtBoot = [..._snapshotLazy(), ..._snapshotRouteSourceLazy({
-		registry: config.registry,
-		manifest
-	})];
-	configureScrollRestoration(config.scrollRestoration);
-	clearRoutes();
-	if (hasManifest) _applyManifest(manifest);
-	else for (const r of routeTable) route(r.path, r.handler);
-	const routeAuth = config.auth ?? manifest?.auth;
-	const appRouteSource = {
-		manifest: hasManifest ? manifest : void 0,
-		routes: hasManifest ? void 0 : routeTable,
-		auth: routeAuth
-	};
-	_setActiveRouteAuthOptions(routeAuth);
-	await _drainLazy(pendingLazyAtBoot);
-	if (isProductionEnvironment()) lockRouteRegistration();
-	const { path, resolved } = await resolveInitialRoute(routeAuth);
-	if (!resolved) {
-		mountOrUpdate(rootElement, () => ({
-			type: "div",
-			children: []
-		}), { cleanupStrict: config.cleanupStrict });
-		await registerAppNavigation(rootElement, path, { ...appRouteSource });
-		return;
-	}
-	if (resolved.kind === "redirect") {
-		mountOrUpdate(rootElement, () => ({
-			type: "div",
-			children: []
-		}), { cleanupStrict: config.cleanupStrict });
-		await registerAppNavigation(rootElement, path, { ...appRouteSource });
-		return;
-	}
-	mountOrUpdate(rootElement, resolved.kind === "deny" ? bindDeniedStatus(resolved.status) : bindResolvedRouteHandler({
-		handler: resolved.handler,
-		params: resolved.params
-	}), { cleanupStrict: config.cleanupStrict });
-	await registerAppNavigation(rootElement, path, { ...appRouteSource });
-}
-/**
-* hydrateSPA: Hydrate server-rendered HTML.
-* Accepts either a `manifest` (preferred) or a legacy `routes` array.
-*/
-async function hydrateSPA(config) {
-	assertExecutionModel("spa");
-	if (!config || typeof config !== "object") throw new Error("hydrateSPA requires a config object");
-	const manifest = config.manifest ?? config.registry?.manifest;
-	const routeTable = config.routes ?? config.registry?.routes;
-	const hasManifest = manifest != null && manifest.records.length > 0;
-	const hasRoutes = Array.isArray(routeTable) && routeTable.length > 0;
-	if (!hasManifest && !hasRoutes) throw new Error("hydrateSPA requires a route manifest or route table. Pass `manifest: getManifest()` or `routes: getRoutes()`. If you are enhancing existing HTML, use createIsland instead.");
-	const rootElement = typeof config.root === "string" ? document.getElementById(config.root) : config.root;
-	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
-	const hydrationRenderData = takeHydrationRenderData(rootElement);
-	const pendingLazyAtHydrationBoot = [..._snapshotLazy(), ..._snapshotRouteSourceLazy({
-		registry: config.registry,
-		manifest
-	})];
-	configureScrollRestoration(config.scrollRestoration);
-	clearRoutes();
-	if (hasManifest) _applyManifest(manifest);
-	else for (const r of routeTable) route(r.path, r.handler);
-	const routeAuth = config.auth ?? manifest?.auth;
-	const appRouteSource = {
-		manifest: hasManifest ? manifest : void 0,
-		routes: hasManifest ? void 0 : routeTable,
-		auth: routeAuth
-	};
-	_setActiveRouteAuthOptions(routeAuth);
-	await _drainLazy(pendingLazyAtHydrationBoot);
-	const { path, href: currentUrl, resolved } = await resolveInitialRoute(routeAuth);
-	setServerLocation(currentUrl);
-	if (isProductionEnvironment()) lockRouteRegistration();
-	if (!resolved) throw new Error(`hydrateSPA: no route found for current path (${path}).`);
-	if (resolved.kind === "redirect") throw new Error(`hydrateSPA: unresolved redirect for current path (${path}).`);
-	const hydrationResolved = resolved.kind === "deny" ? {
-		handler: bindDeniedRouteHandler(resolved.status),
-		params: {}
-	} : {
-		handler: resolved.handler,
-		params: resolved.params
-	};
-	if (shouldVerifyHydrationMarkup(config)) {
-		const legacyRouteTable = hasManifest ? manifest.records.map((r) => ({
-			...r,
-			path: r.path,
-			handler: r.handler,
-			namespace: r.options.namespace
-		})) : routeTable;
-		const { verifyHydrationSyncForUrl } = await import("../ssr/verify-hydration.js");
-		if (!verifyHydrationSyncForUrl({
-			root: rootElement,
-			url: currentUrl,
-			routes: legacyRouteTable,
-			resolved: hydrationResolved,
-			options: { data: hydrationRenderData ?? void 0 }
-		})) throw new Error("[Askr] Hydration mismatch detected. Server HTML does not match expected server-render output.");
-	}
-	const hydrateOptions = config.hydrate;
-	if (hydrateOptions) {
-		if (hydrateOptions.deferUntilIdle || hydrateOptions.deferBelowFold) {
-			if (hydrationRenderData) startHydrationRenderPhase(hydrationRenderData);
-			try {
-				await applySelectiveHydration(rootElement, hydrationResolved, path, config.cleanupStrict, hydrateOptions, appRouteSource, {
-					mountOrUpdate,
-					registerAppNavigation,
-					registerRootCleanupCallback,
-					flushHydrationActivation
-				});
-			} finally {
-				if (hydrationRenderData) stopHydrationRenderPhase();
-			}
-			return;
-		}
-		if (hydrateOptions.skipSelectors?.length) markSkippedElements(rootElement, hydrateOptions.skipSelectors);
-	}
-	if (hydrationRenderData) startHydrationRenderPhase(hydrationRenderData);
-	try {
-		mountOrUpdate(rootElement, resolved.kind === "deny" ? bindDeniedStatus(resolved.status) : bindResolvedRouteHandler(hydrationResolved), { cleanupStrict: config.cleanupStrict });
-	} finally {
-		if (hydrationRenderData) stopHydrationRenderPhase();
-	}
-	await registerAppNavigation(rootElement, path, { ...appRouteSource });
-}
-//#endregion
+import { a as cleanupApp, i as hydrateSPA, n as createIslands, o as hasApp, r as createSPA, t as createIsland } from "../boot-j2KoN6ss.js";
 export { cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA };
-
-//# sourceMappingURL=index.js.map