@askrjs/askr 0.0.48 → 0.0.49

package/dist/benchmark.js

@@ -1,4 +1,4 @@
-import { globalScheduler } from "./runtime/scheduler.js";
+import { flushRuntimeScheduler } from "./runtime/access.js";
 import { jsx } from "./jsx-runtime.js";
 import { installRendererBridge } from "./renderer/index.js";
 import { state } from "./runtime/state.js";
@@ -10,8 +10,8 @@ import { BenchmarkTable } from "./bench/components/benchmark-table.js";
 installRendererBridge();
 const benchmarkMetadata = {
 	packageName: "@askrjs/askr",
-	packageVersion: "0.0.48",
-	buildLabel: "0.0.48-local"
+	packageVersion: "0.0.49",
+	buildLabel: "0.0.49-local"
 };
 function getBenchmarkMetadata() {
 	return { ...benchmarkMetadata };
@@ -44,15 +44,15 @@ function mountBenchmark(root, initialRows) {
 		root,
 		component: App
 	});
-	globalScheduler.flush();
+	flushRuntimeScheduler();
 	return {
 		setRows(rows) {
 			dataState.set(rows);
-			globalScheduler.flush();
+			flushRuntimeScheduler();
 		},
 		setSelected(id) {
 			selectedState.set(id);
-			globalScheduler.flush();
+			flushRuntimeScheduler();
 		},
 		cleanup() {}
 	};

package/dist/benchmark.js.map

@@ -1 +1 @@
-{"version":3,"file":"benchmark.js","names":[],"sources":["../src/bench/benchmark-entry.tsx"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { createIsland } from '../boot';\nimport { installRendererBridge } from '../renderer';\nimport { selector } from '../runtime/selector';\nimport { state, State } from '../runtime/state';\nimport { globalScheduler } from '../runtime/scheduler';\nimport { BenchmarkTable } from './components/benchmark-table';\nimport type { BenchmarkRowData } from './components/benchmark-row';\n\ninstallRendererBridge();\n\ntype RowData = BenchmarkRowData;\n\nexport interface BenchmarkMetadata {\n  packageName: string;\n  packageVersion: string;\n  buildLabel: string;\n}\n\nconst packageName =\n  process.env.ASKR_PACKAGE_NAME ||\n  process.env.npm_package_name ||\n  '@askrjs/askr';\nconst packageVersion =\n  process.env.ASKR_PACKAGE_VERSION ||\n  process.env.npm_package_version ||\n  '0.0.0';\n\nexport const benchmarkMetadata: BenchmarkMetadata = {\n  packageName,\n  packageVersion,\n  buildLabel:\n    process.env.ASKR_BENCHMARK_BUILD_LABEL || `${packageVersion}-local`,\n};\n\nexport function getBenchmarkMetadata(): BenchmarkMetadata {\n  return { ...benchmarkMetadata };\n}\n\nexport function mountBenchmark(root: Element, initialRows?: RowData[]) {\n  const initialRowsTyped: RowData[] = Array.isArray(initialRows)\n    ? initialRows\n    : [];\n  let dataState!: State<RowData[]>;\n  let selectedState!: State<number | null>;\n\n  const App = () => {\n    dataState = state<RowData[]>(initialRowsTyped);\n    selectedState = state<number | null>(null);\n    dataState._hasBeenRead = true;\n    const isSelected = selector(selectedState);\n\n    const select = (id: number) => selectedState.set(id);\n    const remove = (id: number) => {\n      dataState.set((rows) => rows.filter((item) => item.id !== id));\n      selectedState.set((selected) => (selected === id ? null : selected));\n    };\n\n    return (\n      <div class=\"container\">\n        <BenchmarkTable\n          rows={dataState}\n          isSelected={isSelected}\n          onSelect={select}\n          onRemove={remove}\n        />\n      </div>\n    );\n  };\n\n  createIsland({ root, component: App as any });\n  globalScheduler.flush();\n\n  return {\n    setRows(rows: RowData[]) {\n      dataState.set(rows);\n      // Ensure work is flushed so external harnesses (like JFB) that check the DOM\n      // immediately after calling `setRows` observe the committed DOM.\n      globalScheduler.flush();\n    },\n    setSelected(id: number | null) {\n      selectedState.set(id);\n      globalScheduler.flush();\n    },\n    cleanup() {\n      // nothing to do; outer test may clean the container\n    },\n  };\n}\n\nexport default { mountBenchmark };\n"],"mappings":";;;;;;;;;AASA,sBAAsB;AAmBtB,MAAa,oBAAuC;CAClD;CACA;CACA,YAAA;AAEF;AAEA,SAAgB,uBAA0C;CACxD,OAAO,EAAE,GAAG,kBAAkB;AAChC;AAEA,SAAgB,eAAe,MAAe,aAAyB;CACrE,MAAM,mBAA8B,MAAM,QAAQ,WAAW,IACzD,cACA,CAAC;CACL,IAAI;CACJ,IAAI;CAEJ,MAAM,YAAY;EAChB,YAAY,MAAiB,gBAAgB;EAC7C,gBAAgB,MAAqB,IAAI;EACzC,UAAU,eAAe;EACzB,MAAM,aAAa,SAAS,aAAa;EAEzC,MAAM,UAAU,OAAe,cAAc,IAAI,EAAE;EACnD,MAAM,UAAU,OAAe;GAC7B,UAAU,KAAK,SAAS,KAAK,QAAQ,SAAS,KAAK,OAAO,EAAE,CAAC;GAC7D,cAAc,KAAK,aAAc,aAAa,KAAK,OAAO,QAAS;EACrE;EAEA,OACE,oBAAC,OAAD;GAAK,OAAM;aACT,oBAAC,gBAAD;IACE,MAAM;IACM;IACZ,UAAU;IACV,UAAU;GACX,CAAA;EACE,CAAA;CAET;CAEA,aAAa;EAAE;EAAM,WAAW;CAAW,CAAC;CAC5C,gBAAgB,MAAM;CAEtB,OAAO;EACL,QAAQ,MAAiB;GACvB,UAAU,IAAI,IAAI;GAGlB,gBAAgB,MAAM;EACxB;EACA,YAAY,IAAmB;GAC7B,cAAc,IAAI,EAAE;GACpB,gBAAgB,MAAM;EACxB;EACA,UAAU,CAEV;CACF;AACF;AAEA,IAAA,0BAAe,EAAE,eAAe"}
+{"version":3,"file":"benchmark.js","names":[],"sources":["../src/bench/benchmark-entry.tsx"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { createIsland } from '../boot';\nimport { installRendererBridge } from '../renderer';\nimport { flushRuntimeScheduler } from '../runtime/access';\nimport { selector } from '../runtime/selector';\nimport { state, State } from '../runtime/state';\nimport { BenchmarkTable } from './components/benchmark-table';\nimport type { BenchmarkRowData } from './components/benchmark-row';\n\ninstallRendererBridge();\n\ntype RowData = BenchmarkRowData;\n\nexport interface BenchmarkMetadata {\n  packageName: string;\n  packageVersion: string;\n  buildLabel: string;\n}\n\nconst packageName =\n  process.env.ASKR_PACKAGE_NAME ||\n  process.env.npm_package_name ||\n  '@askrjs/askr';\nconst packageVersion =\n  process.env.ASKR_PACKAGE_VERSION ||\n  process.env.npm_package_version ||\n  '0.0.0';\n\nexport const benchmarkMetadata: BenchmarkMetadata = {\n  packageName,\n  packageVersion,\n  buildLabel:\n    process.env.ASKR_BENCHMARK_BUILD_LABEL || `${packageVersion}-local`,\n};\n\nexport function getBenchmarkMetadata(): BenchmarkMetadata {\n  return { ...benchmarkMetadata };\n}\n\nexport function mountBenchmark(root: Element, initialRows?: RowData[]) {\n  const initialRowsTyped: RowData[] = Array.isArray(initialRows)\n    ? initialRows\n    : [];\n  let dataState!: State<RowData[]>;\n  let selectedState!: State<number | null>;\n\n  const App = () => {\n    dataState = state<RowData[]>(initialRowsTyped);\n    selectedState = state<number | null>(null);\n    dataState._hasBeenRead = true;\n    const isSelected = selector(selectedState);\n\n    const select = (id: number) => selectedState.set(id);\n    const remove = (id: number) => {\n      dataState.set((rows) => rows.filter((item) => item.id !== id));\n      selectedState.set((selected) => (selected === id ? null : selected));\n    };\n\n    return (\n      <div class=\"container\">\n        <BenchmarkTable\n          rows={dataState}\n          isSelected={isSelected}\n          onSelect={select}\n          onRemove={remove}\n        />\n      </div>\n    );\n  };\n\n  createIsland({ root, component: App as any });\n  flushRuntimeScheduler();\n\n  return {\n    setRows(rows: RowData[]) {\n      dataState.set(rows);\n      // Ensure work is flushed so external harnesses (like JFB) that check the DOM\n      // immediately after calling `setRows` observe the committed DOM.\n      flushRuntimeScheduler();\n    },\n    setSelected(id: number | null) {\n      selectedState.set(id);\n      flushRuntimeScheduler();\n    },\n    cleanup() {\n      // nothing to do; outer test may clean the container\n    },\n  };\n}\n\nexport default { mountBenchmark };\n"],"mappings":";;;;;;;;;AASA,sBAAsB;AAmBtB,MAAa,oBAAuC;CAClD;CACA;CACA,YAAA;AAEF;AAEA,SAAgB,uBAA0C;CACxD,OAAO,EAAE,GAAG,kBAAkB;AAChC;AAEA,SAAgB,eAAe,MAAe,aAAyB;CACrE,MAAM,mBAA8B,MAAM,QAAQ,WAAW,IACzD,cACA,CAAC;CACL,IAAI;CACJ,IAAI;CAEJ,MAAM,YAAY;EAChB,YAAY,MAAiB,gBAAgB;EAC7C,gBAAgB,MAAqB,IAAI;EACzC,UAAU,eAAe;EACzB,MAAM,aAAa,SAAS,aAAa;EAEzC,MAAM,UAAU,OAAe,cAAc,IAAI,EAAE;EACnD,MAAM,UAAU,OAAe;GAC7B,UAAU,KAAK,SAAS,KAAK,QAAQ,SAAS,KAAK,OAAO,EAAE,CAAC;GAC7D,cAAc,KAAK,aAAc,aAAa,KAAK,OAAO,QAAS;EACrE;EAEA,OACE,oBAAC,OAAD;GAAK,OAAM;aACT,oBAAC,gBAAD;IACE,MAAM;IACM;IACZ,UAAU;IACV,UAAU;GACX,CAAA;EACE,CAAA;CAET;CAEA,aAAa;EAAE;EAAM,WAAW;CAAW,CAAC;CAC5C,sBAAsB;CAEtB,OAAO;EACL,QAAQ,MAAiB;GACvB,UAAU,IAAI,IAAI;GAGlB,sBAAsB;EACxB;EACA,YAAY,IAAmB;GAC7B,cAAc,IAAI,EAAE;GACpB,sBAAsB;EACxB;EACA,UAAU,CAEV;CACF;AACF;AAEA,IAAA,0BAAe,EAAE,eAAe"}

package/dist/boot/hydration.js

@@ -0,0 +1,140 @@
+import { isProductionEnvironment } from "../common/env.js";
+import { setStaticChildSlotsCacheEnabled } from "../renderer/static-reuse.js";
+import "../renderer/dom.js";
+import "../common/ssr.js";
+//#region src/boot/hydration.ts
+function takeHydrationRenderData(rootElement) {
+	for (const child of Array.from(rootElement.children)) if (child instanceof HTMLScriptElement && child.getAttribute("data-askr-render-data") === "true") {
+		const raw = child.textContent ?? "";
+		child.remove();
+		if (!raw) return {};
+		try {
+			return JSON.parse(raw);
+		} catch (err) {
+			const error = /* @__PURE__ */ new Error("[Askr] Failed to parse embedded SSR render data during hydration.");
+			error.cause = err;
+			throw error;
+		}
+	}
+	return null;
+}
+function markSkippedElements(root, skipSelectors) {
+	if (skipSelectors.length === 0) return;
+	const selectorList = Array.from(new Set(skipSelectors)).join(", ");
+	root.querySelectorAll(selectorList).forEach((el) => el.setAttribute("data-skip-hydrate", "true"));
+}
+function collectDeferredBelowFoldBoundaries(root, foldY) {
+	const boundaries = [];
+	const stack = [];
+	for (let index = root.children.length - 1; index >= 0; index -= 1) stack.push(root.children[index]);
+	while (stack.length > 0) {
+		const element = stack.pop();
+		if (element.hasAttribute("data-skip-hydrate")) continue;
+		if (element.getBoundingClientRect().top >= foldY) {
+			element.setAttribute("data-skip-hydrate", "true");
+			boundaries.push(element);
+			continue;
+		}
+		for (let index = element.children.length - 1; index >= 0; index -= 1) stack.push(element.children[index]);
+	}
+	return boundaries;
+}
+function activateVisibleDeferredBoundaries(boundaries, foldY) {
+	let activated = false;
+	let remaining = 0;
+	for (const element of boundaries) {
+		if (!element.hasAttribute("data-skip-hydrate")) continue;
+		if (element.getBoundingClientRect().top < foldY) {
+			element.removeAttribute("data-skip-hydrate");
+			activated = true;
+		} else remaining += 1;
+	}
+	return {
+		activated,
+		remaining
+	};
+}
+function queueIdleWork(work) {
+	return new Promise((resolve) => {
+		if (typeof requestIdleCallback !== "undefined") {
+			requestIdleCallback(() => {
+				work();
+				resolve();
+			}, { timeout: 2e3 });
+			return;
+		}
+		setTimeout(() => {
+			work();
+			resolve();
+		}, 0);
+	});
+}
+function shouldVerifyHydrationMarkup(config) {
+	const explicit = config.hydrate?.verifyMarkup;
+	if (typeof explicit === "boolean") return explicit;
+	return !isProductionEnvironment();
+}
+async function applySelectiveHydration(rootElement, resolved, path, cleanupStrict, hydrateOptions, source, hooks) {
+	const hasPermanentSkips = (hydrateOptions.skipSelectors?.length ?? 0) > 0;
+	const hasBelowFoldDeferral = !!hydrateOptions.deferBelowFold;
+	const hasSelectiveBoundaries = hasPermanentSkips || hasBelowFoldDeferral;
+	let staticChildSlotsCacheSuspended = false;
+	let releaseSelectiveHydrationResources = () => {};
+	const restoreStaticChildSlotsCache = () => {
+		if (!staticChildSlotsCacheSuspended) return;
+		setStaticChildSlotsCacheEnabled(true);
+		staticChildSlotsCacheSuspended = false;
+	};
+	if (hydrateOptions.skipSelectors?.length) markSkippedElements(rootElement, hydrateOptions.skipSelectors);
+	let deferredBoundaries = [];
+	if (hydrateOptions.deferBelowFold) {
+		setStaticChildSlotsCacheEnabled(false);
+		staticChildSlotsCacheSuspended = true;
+		const foldY = hydrateOptions.foldThreshold ?? window.innerHeight;
+		deferredBoundaries = collectDeferredBelowFoldBoundaries(rootElement, foldY);
+		let selectiveHydrationResourcesReleased = false;
+		let unregisterRootCleanupCallback = () => {};
+		function handleScroll() {
+			const { activated, remaining } = activateVisibleDeferredBoundaries(deferredBoundaries, foldY);
+			if (!activated) return;
+			hooks.flushHydrationActivation(rootElement);
+			if (remaining === 0) releaseSelectiveHydrationResources();
+		}
+		releaseSelectiveHydrationResources = () => {
+			if (selectiveHydrationResourcesReleased) return;
+			selectiveHydrationResourcesReleased = true;
+			unregisterRootCleanupCallback();
+			window.removeEventListener("scroll", handleScroll);
+			restoreStaticChildSlotsCache();
+		};
+		unregisterRootCleanupCallback = hooks.registerRootCleanupCallback(rootElement, releaseSelectiveHydrationResources);
+		window.addEventListener("scroll", handleScroll, { passive: true });
+	}
+	if (hydrateOptions.deferUntilIdle && !hasSelectiveBoundaries) {
+		await queueIdleWork(() => {
+			hooks.mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), { cleanupStrict });
+		});
+		await hooks.registerAppNavigation(rootElement, path, source);
+		return;
+	}
+	try {
+		hooks.mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), { cleanupStrict });
+		await hooks.registerAppNavigation(rootElement, path, source);
+	} catch (error) {
+		releaseSelectiveHydrationResources();
+		throw error;
+	}
+	if (hydrateOptions.deferUntilIdle && deferredBoundaries.length > 0) await queueIdleWork(() => {
+		try {
+			const { activated } = activateVisibleDeferredBoundaries(deferredBoundaries, Number.POSITIVE_INFINITY);
+			if (activated) hooks.flushHydrationActivation(rootElement);
+		} finally {
+			releaseSelectiveHydrationResources();
+		}
+	});
+	if (deferredBoundaries.length === 0) releaseSelectiveHydrationResources();
+}
+//#endregion
+export { applySelectiveHydration, markSkippedElements, shouldVerifyHydrationMarkup, takeHydrationRenderData };
+
+//# sourceMappingURL=hydration.js.map

package/dist/boot/hydration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration.js","names":[],"sources":["../../src/boot/hydration.ts"],"sourcesContent":["import { isProductionEnvironment } from '../common/env';\nimport { SSR_RENDER_DATA_ATTR, type SSRData } from '../common/ssr';\nimport type { ResolvedRoute } from '../common/router';\nimport type { ComponentFunction } from '../runtime/component';\nimport { setStaticChildSlotsCacheEnabled } from '../renderer/dom';\nimport type { BootAppRouteSource, HydrateSPAConfig } from './types';\n\ntype MountOrUpdateRoot = (\n  rootElement: Element,\n  componentFn: ComponentFunction,\n  options?: { cleanupStrict?: boolean }\n) => void;\n\nexport type HydrationRuntimeHooks = {\n  mountOrUpdate: MountOrUpdateRoot;\n  registerAppNavigation: (\n    rootElement: Element,\n    path: string,\n    source?: BootAppRouteSource\n  ) => Promise<void>;\n  registerRootCleanupCallback: (\n    rootElement: Element,\n    callback: () => void\n  ) => () => void;\n  flushHydrationActivation: (rootElement: Element) => void;\n};\n\nexport function takeHydrationRenderData(rootElement: Element): SSRData | null {\n  for (const child of Array.from(rootElement.children)) {\n    if (\n      child instanceof HTMLScriptElement &&\n      child.getAttribute(SSR_RENDER_DATA_ATTR) === 'true'\n    ) {\n      const raw = child.textContent ?? '';\n      child.remove();\n      if (!raw) {\n        return {};\n      }\n\n      try {\n        return JSON.parse(raw) as SSRData;\n      } catch (err) {\n        const error = new Error(\n          '[Askr] Failed to parse embedded SSR render data during hydration.'\n        );\n        (error as Error & { cause?: unknown }).cause = err;\n        throw error;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function markSkippedElements(\n  root: Element,\n  skipSelectors: string[]\n): void {\n  if (skipSelectors.length === 0) {\n    return;\n  }\n\n  const uniqueSelectors = Array.from(new Set(skipSelectors));\n  const selectorList = uniqueSelectors.join(', ');\n  const elements = root.querySelectorAll(selectorList);\n  elements.forEach((el) => el.setAttribute('data-skip-hydrate', 'true'));\n}\n\nfunction collectDeferredBelowFoldBoundaries(\n  root: Element,\n  foldY: number\n): Element[] {\n  const boundaries: Element[] = [];\n  const stack: Element[] = [];\n\n  for (let index = root.children.length - 1; index >= 0; index -= 1) {\n    stack.push(root.children[index]);\n  }\n\n  while (stack.length > 0) {\n    const element = stack.pop()!;\n\n    if (element.hasAttribute('data-skip-hydrate')) {\n      continue;\n    }\n\n    const rect = element.getBoundingClientRect();\n    if (rect.top >= foldY) {\n      element.setAttribute('data-skip-hydrate', 'true');\n      boundaries.push(element);\n      continue;\n    }\n\n    for (let index = element.children.length - 1; index >= 0; index -= 1) {\n      stack.push(element.children[index]);\n    }\n  }\n\n  return boundaries;\n}\n\nfunction activateVisibleDeferredBoundaries(\n  boundaries: Element[],\n  foldY: number\n): { activated: boolean; remaining: number } {\n  let activated = false;\n  let remaining = 0;\n\n  for (const element of boundaries) {\n    if (!element.hasAttribute('data-skip-hydrate')) {\n      continue;\n    }\n\n    const rect = element.getBoundingClientRect();\n    if (rect.top < foldY) {\n      element.removeAttribute('data-skip-hydrate');\n      activated = true;\n    } else {\n      remaining += 1;\n    }\n  }\n\n  return { activated, remaining };\n}\n\nfunction queueIdleWork(work: () => void): Promise<void> {\n  return new Promise((resolve) => {\n    if (typeof requestIdleCallback !== 'undefined') {\n      requestIdleCallback(\n        () => {\n          work();\n          resolve();\n        },\n        { timeout: 2000 }\n      );\n      return;\n    }\n\n    setTimeout(() => {\n      work();\n      resolve();\n    }, 0);\n  });\n}\n\nexport function shouldVerifyHydrationMarkup(config: HydrateSPAConfig): boolean {\n  const explicit = config.hydrate?.verifyMarkup;\n  if (typeof explicit === 'boolean') {\n    return explicit;\n  }\n\n  return !isProductionEnvironment();\n}\n\nexport async function applySelectiveHydration(\n  rootElement: Element,\n  resolved: ResolvedRoute,\n  path: string,\n  cleanupStrict: boolean | undefined,\n  hydrateOptions: NonNullable<HydrateSPAConfig['hydrate']>,\n  source: BootAppRouteSource | undefined,\n  hooks: HydrationRuntimeHooks\n): Promise<void> {\n  const hasPermanentSkips = (hydrateOptions.skipSelectors?.length ?? 0) > 0;\n  const hasBelowFoldDeferral = !!hydrateOptions.deferBelowFold;\n  const hasSelectiveBoundaries = hasPermanentSkips || hasBelowFoldDeferral;\n  let staticChildSlotsCacheSuspended = false;\n  let releaseSelectiveHydrationResources = () => {};\n\n  const restoreStaticChildSlotsCache = () => {\n    if (!staticChildSlotsCacheSuspended) {\n      return;\n    }\n\n    setStaticChildSlotsCacheEnabled(true);\n    staticChildSlotsCacheSuspended = false;\n  };\n\n  if (hydrateOptions.skipSelectors?.length) {\n    markSkippedElements(rootElement, hydrateOptions.skipSelectors);\n  }\n\n  let deferredBoundaries: Element[] = [];\n  if (hydrateOptions.deferBelowFold) {\n    setStaticChildSlotsCacheEnabled(false);\n    staticChildSlotsCacheSuspended = true;\n    const foldY = hydrateOptions.foldThreshold ?? window.innerHeight;\n    deferredBoundaries = collectDeferredBelowFoldBoundaries(rootElement, foldY);\n\n    let selectiveHydrationResourcesReleased = false;\n    let unregisterRootCleanupCallback = () => {};\n\n    function handleScroll() {\n      const { activated, remaining } = activateVisibleDeferredBoundaries(\n        deferredBoundaries,\n        foldY\n      );\n\n      if (!activated) {\n        return;\n      }\n\n      hooks.flushHydrationActivation(rootElement);\n\n      if (remaining === 0) {\n        releaseSelectiveHydrationResources();\n      }\n    }\n\n    releaseSelectiveHydrationResources = () => {\n      if (selectiveHydrationResourcesReleased) {\n        return;\n      }\n\n      selectiveHydrationResourcesReleased = true;\n      unregisterRootCleanupCallback();\n      window.removeEventListener('scroll', handleScroll);\n      restoreStaticChildSlotsCache();\n    };\n\n    unregisterRootCleanupCallback = hooks.registerRootCleanupCallback(\n      rootElement,\n      releaseSelectiveHydrationResources\n    );\n\n    window.addEventListener('scroll', handleScroll, { passive: true });\n  }\n\n  if (hydrateOptions.deferUntilIdle && !hasSelectiveBoundaries) {\n    await queueIdleWork(() => {\n      hooks.mountOrUpdate(\n        rootElement,\n        (() => resolved.handler(resolved.params)) as ComponentFunction,\n        {\n          cleanupStrict,\n        }\n      );\n    });\n    await hooks.registerAppNavigation(rootElement, path, source);\n    return;\n  }\n\n  try {\n    hooks.mountOrUpdate(\n      rootElement,\n      (() => resolved.handler(resolved.params)) as ComponentFunction,\n      {\n        cleanupStrict,\n      }\n    );\n    await hooks.registerAppNavigation(rootElement, path, source);\n  } catch (error) {\n    releaseSelectiveHydrationResources();\n    throw error;\n  }\n\n  if (hydrateOptions.deferUntilIdle && deferredBoundaries.length > 0) {\n    await queueIdleWork(() => {\n      try {\n        const { activated } = activateVisibleDeferredBoundaries(\n          deferredBoundaries,\n          Number.POSITIVE_INFINITY\n        );\n        if (activated) {\n          hooks.flushHydrationActivation(rootElement);\n        }\n      } finally {\n        releaseSelectiveHydrationResources();\n      }\n    });\n  }\n\n  if (deferredBoundaries.length === 0) {\n    releaseSelectiveHydrationResources();\n  }\n}\n"],"mappings":"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"}

package/dist/boot/index.d.ts

@@ -1,51 +1,7 @@
-import { ComponentFunction } from "../common/component.js";
-import { Route, RouteAuthOptions, RouteManifest } from "../common/router.js";
-import { ScrollRestorationOptions } from "../router/navigate.js";
+import { HydrateSPAConfig, IslandConfig, IslandsConfig, SPAConfig } from "./types.js";
+import { cleanupApp, hasApp } from "./root-lifecycle.js";
 
 //#region src/boot/index.d.ts
-type IslandConfig = {
-  root: Element | string;
-  component: ComponentFunction;
-  cleanupStrict?: boolean;
-  routes?: never;
-};
-type IslandsConfig = {
-  islands: IslandConfig[];
-};
-type BootRouteSource = {
-  manifest: RouteManifest;
-  routes?: Route[];
-} | {
-  manifest?: RouteManifest;
-  routes: Route[];
-};
-type SPAConfig = BootRouteSource & {
-  root: Element | string;
-  /**
-   * Preferred: pass the route manifest built via `registerRoutes(() => { ... })`.
-   * ```ts
-   * import { getManifest } from '@askrjs/askr/router';
-   * await createSPA({ root: '#app', manifest: getManifest() });
-   * ```
-   */
-  auth?: RouteAuthOptions;
-  scrollRestoration?: boolean | ScrollRestorationOptions;
-  cleanupStrict?: boolean;
-  component?: never;
-};
-type HydrateSPAConfig = BootRouteSource & {
-  root: Element | string; /** Preferred manifest input — see `SPAConfig.manifest`. */
-  auth?: RouteAuthOptions;
-  scrollRestoration?: boolean | ScrollRestorationOptions;
-  cleanupStrict?: boolean;
-  hydrate?: {
-    verifyMarkup?: boolean;
-    deferUntilIdle?: boolean;
-    deferBelowFold?: boolean;
-    foldThreshold?: number;
-    skipSelectors?: string[];
-  };
-};
 /**
  * createIsland: Enhances existing DOM (no router, mounts once)
  */
@@ -75,15 +31,6 @@ declare function createSPA(config: SPAConfig): Promise<void>;
  * Accepts either a `manifest` (preferred) or a legacy `routes` array.
  */
 declare function hydrateSPA(config: HydrateSPAConfig): Promise<void>;
-/**
- * Cleanup an app mounted on a root element (element or id).
- * Safe to call multiple times — no-op when nothing is mounted.
- */
-declare function cleanupApp(root: Element | string): void;
-/**
- * Check whether an app is mounted on the given root
- */
-declare function hasApp(root: Element | string): boolean;
 //#endregion
-export { HydrateSPAConfig, IslandConfig, IslandsConfig, SPAConfig, cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA };
+export { type HydrateSPAConfig, type IslandConfig, type IslandsConfig, type SPAConfig, cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/boot/index.ts"],"mappings":";;;;;KAkXY,YAAA;EACV,IAAA,EAAM,OAAA;EACN,SAAA,EAAW,iBAAiB;EAE5B,aAAA;EAEA,MAAA;AAAA;AAAA,KAGU,aAAA;EACV,OAAA,EAAS,YAAY;AAAA;AAAA,KAGlB,eAAA;EAEC,QAAA,EAAU,aAAA;EACV,MAAA,GAAS,KAAA;AAAA;EAGT,QAAA,GAAW,aAAA;EACX,MAAA,EAAQ,KAAA;AAAA;AAAA,KAGF,SAAA,GAAY,eAAA;EACtB,IAAA,EAAM,OAAA;EAXY;;;;;;;EAmBlB,IAAA,GAAO,gBAAA;EACP,iBAAA,aAA8B,wBAAA;EAC9B,aAAA;EACA,SAAA;AAAA;AAAA,KAGU,gBAAA,GAAmB,eAAA;EAC7B,IAAA,EAAM,OAAA,WAnBF;EAqBJ,IAAA,GAAO,gBAAA;EACP,iBAAA,aAA8B,wBAAA;EAC9B,aAAA;EACA,OAAA;IACE,YAAA;IACA,cAAA;IACA,cAAA;IACA,aAAA;IACA,aAAA;EAAA;AAAA;;;;iBAkDY,YAAA,CAAa,MAAoB,EAAZ,YAAY;;;;;iBA6CjC,aAAA,CAAc,MAAqB,EAAb,aAAa;;;AA7GxC;AAGX;;;;;;;;;;;iBAqIsB,SAAA,CAAU,MAAA,EAAQ,SAAA,GAAY,OAAO;;;;;iBA4VrC,UAAA,CAAW,MAAA,EAAQ,gBAAA,GAAmB,OAAO;;;;;iBAuJnD,UAAA,CAAW,IAAsB,EAAhB,OAAO;;;AA7mBvB;iBAsoBD,MAAA,CAAO,IAAsB,EAAhB,OAAO"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/boot/index.ts"],"mappings":";;;;;;AA4DiD;iBAAjC,YAAA,CAAa,MAAoB,EAAZ,YAAY;;;;AAwCE;iBAAnC,aAAA,CAAc,MAAqB,EAAb,aAAa;;;;;;;;AA2BQ;AA0G3D;;;;;;iBA1GsB,SAAA,CAAU,MAAA,EAAQ,SAAA,GAAY,OAAO;;AA0GQ;;;iBAA7C,UAAA,CAAW,MAAA,EAAQ,gBAAA,GAAmB,OAAO"}