@tenphi/renderer 0.23.0 → 0.25.0

package/dist/client/client-navigation.d.ts

@@ -0,0 +1 @@
+import "./navigation-router.js";

package/dist/client/client-navigation.js

@@ -0,0 +1,41 @@
+//#region src/client/client-navigation.ts
+let pageLoadNotified = false;
+document.addEventListener("astro:page-load", () => {
+	pageLoadNotified = true;
+}, { once: true });
+window.addEventListener("load", () => {
+	window.setTimeout(() => {
+		if (!pageLoadNotified) document.dispatchEvent(new Event("astro:page-load"));
+	}, 0);
+}, { once: true });
+let router;
+function loadRouter() {
+	return router ??= import("./navigation-router.js").catch((error) => {
+		router = void 0;
+		throw error;
+	});
+}
+function navigationLink(target) {
+	const link = target instanceof Element ? target.closest("a[href]") : null;
+	if (!(link instanceof HTMLAnchorElement) || link.hasAttribute("download") || link.hasAttribute("data-astro-reload") || link.target && link.target !== "_self") return;
+	const url = new URL(link.href);
+	if (url.origin !== location.origin || !router && url.pathname === location.pathname && url.search === location.search && url.hash) return;
+	return link;
+}
+for (const name of ["pointerover", "focusin"]) document.addEventListener(name, (event) => {
+	if (navigationLink(event.composedPath()[0])) loadRouter().catch(() => {});
+});
+document.addEventListener("click", (event) => {
+	if (event.defaultPrevented || event.button !== 0 || event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) return;
+	const link = navigationLink(event.composedPath()[0]);
+	if (!link) return;
+	event.preventDefault();
+	loadRouter().then(({ navigate }) => navigate(link.href, {
+		sourceElement: link,
+		history: link.dataset.astroHistory === "replace" ? "replace" : "auto"
+	})).catch(() => location.assign(link.href));
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=client-navigation.js.map

package/dist/client/client-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-navigation.js","names":[],"sources":["../../src/client/client-navigation.ts"],"sourcesContent":["// Use Astro's public router without ClientRouter's vendor stylesheet. Cookbook\n// owns link interception and extracted accessibility styles; Astro owns fetch,\n// stylesheet readiness, script execution, history, and route announcements.\n// Prefetch expects an initial page-load event before later route swaps. When\n// the router is still lazy, supply it after all native load listeners finish.\nlet pageLoadNotified = false;\ndocument.addEventListener(\n  \"astro:page-load\",\n  () => {\n    pageLoadNotified = true;\n  },\n  { once: true },\n);\nwindow.addEventListener(\n  \"load\",\n  () => {\n    window.setTimeout(() => {\n      if (!pageLoadNotified)\n        document.dispatchEvent(new Event(\"astro:page-load\"));\n    }, 0);\n  },\n  { once: true },\n);\n\nlet router: Promise<typeof import(\"./navigation-router.js\")> | undefined;\nfunction loadRouter() {\n  return (router ??= import(\"./navigation-router.js\").catch(\n    (error: unknown) => {\n      router = undefined;\n      throw error;\n    },\n  ));\n}\n\nfunction navigationLink(target: EventTarget | undefined) {\n  const link = target instanceof Element ? target.closest(\"a[href]\") : null;\n  if (\n    !(link instanceof HTMLAnchorElement) ||\n    link.hasAttribute(\"download\") ||\n    link.hasAttribute(\"data-astro-reload\") ||\n    (link.target && link.target !== \"_self\")\n  )\n    return;\n  const url = new URL(link.href);\n  if (\n    url.origin !== location.origin ||\n    (!router &&\n      url.pathname === location.pathname &&\n      url.search === location.search &&\n      url.hash)\n  )\n    return;\n  // Heading links stay native until a page-navigation intent loads the router.\n  return link;\n}\n\n// Download the router on navigation intent, rather than for every reader.\nfor (const name of [\"pointerover\", \"focusin\"]) {\n  document.addEventListener(name, (event) => {\n    if (navigationLink(event.composedPath()[0]))\n      void loadRouter().catch(() => {\n        // A later click can retry; native navigation remains the fallback.\n      });\n  });\n}\n\ndocument.addEventListener(\"click\", (event) => {\n  if (\n    event.defaultPrevented ||\n    event.button !== 0 ||\n    event.metaKey ||\n    event.ctrlKey ||\n    event.shiftKey ||\n    event.altKey\n  )\n    return;\n  const link = navigationLink(event.composedPath()[0]);\n  if (!link) return;\n  event.preventDefault();\n  void loadRouter()\n    .then(({ navigate }) =>\n      navigate(link.href, {\n        sourceElement: link,\n        history: link.dataset.astroHistory === \"replace\" ? \"replace\" : \"auto\",\n      }),\n    )\n    .catch(() => location.assign(link.href));\n});\n"],"mappings":";AAKA,IAAI,mBAAmB;AACvB,SAAS,iBACP,yBACM;CACJ,mBAAmB;AACrB,GACA,EAAE,MAAM,KAAK,CACf;AACA,OAAO,iBACL,cACM;CACJ,OAAO,iBAAiB;EACtB,IAAI,CAAC,kBACH,SAAS,cAAc,IAAI,MAAM,iBAAiB,CAAC;CACvD,GAAG,CAAC;AACN,GACA,EAAE,MAAM,KAAK,CACf;AAEA,IAAI;AACJ,SAAS,aAAa;CACpB,OAAQ,WAAW,OAAO,yBAAyB,CAAC,OACjD,UAAmB;EAClB,SAAS,KAAA;EACT,MAAM;CACR,CACF;AACF;AAEA,SAAS,eAAe,QAAiC;CACvD,MAAM,OAAO,kBAAkB,UAAU,OAAO,QAAQ,SAAS,IAAI;CACrE,IACE,EAAE,gBAAgB,sBAClB,KAAK,aAAa,UAAU,KAC5B,KAAK,aAAa,mBAAmB,KACpC,KAAK,UAAU,KAAK,WAAW,SAEhC;CACF,MAAM,MAAM,IAAI,IAAI,KAAK,IAAI;CAC7B,IACE,IAAI,WAAW,SAAS,UACvB,CAAC,UACA,IAAI,aAAa,SAAS,YAC1B,IAAI,WAAW,SAAS,UACxB,IAAI,MAEN;CAEF,OAAO;AACT;AAGA,KAAK,MAAM,QAAQ,CAAC,eAAe,SAAS,GAC1C,SAAS,iBAAiB,OAAO,UAAU;CACzC,IAAI,eAAe,MAAM,aAAa,CAAC,CAAC,EAAE,GACxC,WAAgB,CAAC,CAAC,YAAY,CAE9B,CAAC;AACL,CAAC;AAGH,SAAS,iBAAiB,UAAU,UAAU;CAC5C,IACE,MAAM,oBACN,MAAM,WAAW,KACjB,MAAM,WACN,MAAM,WACN,MAAM,YACN,MAAM,QAEN;CACF,MAAM,OAAO,eAAe,MAAM,aAAa,CAAC,CAAC,EAAE;CACnD,IAAI,CAAC,MAAM;CACX,MAAM,eAAe;CACrB,WAAgB,CAAC,CACd,MAAM,EAAE,eACP,SAAS,KAAK,MAAM;EAClB,eAAe;EACf,SAAS,KAAK,QAAQ,iBAAiB,YAAY,YAAY;CACjE,CAAC,CACH,CAAC,CACA,YAAY,SAAS,OAAO,KAAK,IAAI,CAAC;AAC3C,CAAC"}

package/dist/client/navigation-router.d.ts

@@ -0,0 +1,2 @@
+import { navigate } from "astro:transitions/client";
+export { navigate };

package/dist/client/navigation-router.js

@@ -0,0 +1,36 @@
+import { initializeTabs } from "./tabs.js";
+import { navigate } from "astro:transitions/client";
+//#region src/client/navigation-router.ts
+document.addEventListener("astro:before-swap", (event) => {
+	const transition = event;
+	transition.viewTransition.skipTransition();
+	for (const name of ["data-theme", "data-contrast"]) {
+		const value = document.documentElement.getAttribute(name);
+		if (value === null) transition.newDocument.documentElement.removeAttribute(name);
+		else transition.newDocument.documentElement.setAttribute(name, value);
+	}
+	const sidebar = document.querySelector("#cookbook__sidebar");
+	const key = sidebar?.querySelector("cookbook-sidebar")?.dataset.storageKey;
+	const scroll = sidebar?.scrollTop ?? 0;
+	const swap = transition.swap;
+	transition.swap = () => {
+		swap();
+		const next = document.querySelector("#cookbook__sidebar");
+		if (next && key && next.querySelector("cookbook-sidebar")?.dataset.storageKey === key && matchMedia("(min-width: 50rem)").matches) next.scrollTop = scroll;
+	};
+});
+document.addEventListener("astro:after-swap", () => {
+	initializeTabs();
+	if (!location.hash) {
+		window.scrollTo({
+			top: 0,
+			left: 0,
+			behavior: "instant"
+		});
+		document.getElementById("main-content")?.focus({ preventScroll: true });
+	}
+});
+//#endregion
+export { navigate };
+
+//# sourceMappingURL=navigation-router.js.map

package/dist/client/navigation-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-router.js","names":[],"sources":["../../src/client/navigation-router.ts"],"sourcesContent":["import type { TransitionBeforeSwapEvent } from \"astro:transitions/client\";\nimport { initializeTabs } from \"./tabs.js\";\nexport { navigate } from \"astro:transitions/client\";\n\n// Load swap behavior with the router, before the first client navigation.\ndocument.addEventListener(\"astro:before-swap\", (event) => {\n  const transition = event as TransitionBeforeSwapEvent;\n  // Instant swaps avoid the browser's default full-page crossfade.\n  transition.viewTransition.skipTransition();\n  for (const name of [\"data-theme\", \"data-contrast\"]) {\n    const value = document.documentElement.getAttribute(name);\n    if (value === null)\n      transition.newDocument.documentElement.removeAttribute(name);\n    else transition.newDocument.documentElement.setAttribute(name, value);\n  }\n  const sidebar = document.querySelector<HTMLElement>(\"#cookbook__sidebar\");\n  const key =\n    sidebar?.querySelector<HTMLElement>(\"cookbook-sidebar\")?.dataset.storageKey;\n  const scroll = sidebar?.scrollTop ?? 0;\n  const swap = transition.swap;\n  transition.swap = () => {\n    swap();\n    const next = document.querySelector<HTMLElement>(\"#cookbook__sidebar\");\n    if (\n      next &&\n      key &&\n      next.querySelector<HTMLElement>(\"cookbook-sidebar\")?.dataset\n        .storageKey === key &&\n      matchMedia(\"(min-width: 50rem)\").matches\n    )\n      next.scrollTop = scroll;\n  };\n});\n\ndocument.addEventListener(\"astro:after-swap\", () => {\n  // Enhance incoming panels synchronously, before a frame can show every\n  // no-JavaScript panel and then jump when page-load scripts hide them.\n  initializeTabs();\n  // Keep fragment navigation intact, but reset article scroll on page changes,\n  // including Back/Forward. Sidebar scroll is independent of the document.\n  if (!location.hash) {\n    window.scrollTo({ top: 0, left: 0, behavior: \"instant\" });\n    document.getElementById(\"main-content\")?.focus({ preventScroll: true });\n  }\n});\n"],"mappings":";;;AAKA,SAAS,iBAAiB,sBAAsB,UAAU;CACxD,MAAM,aAAa;CAEnB,WAAW,eAAe,eAAe;CACzC,KAAK,MAAM,QAAQ,CAAC,cAAc,eAAe,GAAG;EAClD,MAAM,QAAQ,SAAS,gBAAgB,aAAa,IAAI;EACxD,IAAI,UAAU,MACZ,WAAW,YAAY,gBAAgB,gBAAgB,IAAI;OACxD,WAAW,YAAY,gBAAgB,aAAa,MAAM,KAAK;CACtE;CACA,MAAM,UAAU,SAAS,cAA2B,oBAAoB;CACxE,MAAM,MACJ,SAAS,cAA2B,kBAAkB,CAAC,EAAE,QAAQ;CACnE,MAAM,SAAS,SAAS,aAAa;CACrC,MAAM,OAAO,WAAW;CACxB,WAAW,aAAa;EACtB,KAAK;EACL,MAAM,OAAO,SAAS,cAA2B,oBAAoB;EACrE,IACE,QACA,OACA,KAAK,cAA2B,kBAAkB,CAAC,EAAE,QAClD,eAAe,OAClB,WAAW,oBAAoB,CAAC,CAAC,SAEjC,KAAK,YAAY;CACrB;AACF,CAAC;AAED,SAAS,iBAAiB,0BAA0B;CAGlD,eAAe;CAGf,IAAI,CAAC,SAAS,MAAM;EAClB,OAAO,SAAS;GAAE,KAAK;GAAG,MAAM;GAAG,UAAU;EAAU,CAAC;EACxD,SAAS,eAAe,cAAc,CAAC,EAAE,MAAM,EAAE,eAAe,KAAK,CAAC;CACxE;AACF,CAAC"}

package/dist/client/prefetch-focus.d.ts

@@ -0,0 +1,9 @@
+//#region src/client/prefetch-focus.d.ts
+/** Keep Astro's hover strategy working for keyboard focus after body swaps. */
+declare function initializePrefetchFocus(options: {
+  prefetchAll?: boolean;
+  defaultStrategy?: string;
+}): void;
+//#endregion
+export { initializePrefetchFocus };
+//# sourceMappingURL=prefetch-focus.d.ts.map

package/dist/client/prefetch-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch-focus.d.ts","names":[],"sources":["../../src/client/prefetch-focus.ts"],"mappings":";;iBAGgB,wBAAwB;EACtC;EACA"}

package/dist/client/prefetch-focus.js

@@ -0,0 +1,26 @@
+import { prefetch } from "astro:prefetch";
+//#region src/client/prefetch-focus.ts
+/** Keep Astro's hover strategy working for keyboard focus after body swaps. */
+function initializePrefetchFocus(options) {
+	let swapped = false;
+	document.addEventListener("astro:after-swap", () => {
+		swapped = true;
+	}, { once: true });
+	let timeout;
+	document.addEventListener("focusin", (event) => {
+		if (!swapped) return;
+		const link = event.target instanceof Element ? event.target.closest("a") : null;
+		if (!(link instanceof HTMLAnchorElement)) return;
+		const strategy = link.dataset.astroPrefetch;
+		if (!(strategy === "hover" || (strategy === "" || strategy === void 0 && options.prefetchAll) && (options.defaultStrategy ?? "hover") === "hover")) return;
+		window.clearTimeout(timeout);
+		timeout = window.setTimeout(() => {
+			if (link.isConnected) prefetch(link.href);
+		}, 80);
+	});
+	document.addEventListener("focusout", () => window.clearTimeout(timeout));
+}
+//#endregion
+export { initializePrefetchFocus };
+
+//# sourceMappingURL=prefetch-focus.js.map

package/dist/client/prefetch-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch-focus.js","names":[],"sources":["../../src/client/prefetch-focus.ts"],"sourcesContent":["import { prefetch } from \"astro:prefetch\";\n\n/** Keep Astro's hover strategy working for keyboard focus after body swaps. */\nexport function initializePrefetchFocus(options: {\n  prefetchAll?: boolean;\n  defaultStrategy?: string;\n}): void {\n  // Astro 7.3 binds focus listeners to the initial body. Its page-load refresh\n  // handles mouse listeners on new anchors, but does not rebind keyboard focus.\n  // Use the public prefetch API only after swaps; Astro still owns\n  // requests, cache reuse, deduplication, and connection checks.\n  let swapped = false;\n  document.addEventListener(\n    \"astro:after-swap\",\n    () => {\n      swapped = true;\n    },\n    { once: true },\n  );\n  let timeout: number | undefined;\n  document.addEventListener(\"focusin\", (event) => {\n    if (!swapped) return;\n    const link =\n      event.target instanceof Element ? event.target.closest(\"a\") : null;\n    if (!(link instanceof HTMLAnchorElement)) return;\n    const strategy = link.dataset.astroPrefetch;\n    const hover =\n      strategy === \"hover\" ||\n      ((strategy === \"\" || (strategy === undefined && options.prefetchAll)) &&\n        (options.defaultStrategy ?? \"hover\") === \"hover\");\n    if (!hover) return;\n    window.clearTimeout(timeout);\n    timeout = window.setTimeout(() => {\n      if (link.isConnected) prefetch(link.href);\n    }, 80);\n  });\n  document.addEventListener(\"focusout\", () => window.clearTimeout(timeout));\n}\n"],"mappings":";;;AAGA,SAAgB,wBAAwB,SAG/B;CAKP,IAAI,UAAU;CACd,SAAS,iBACP,0BACM;EACJ,UAAU;CACZ,GACA,EAAE,MAAM,KAAK,CACf;CACA,IAAI;CACJ,SAAS,iBAAiB,YAAY,UAAU;EAC9C,IAAI,CAAC,SAAS;EACd,MAAM,OACJ,MAAM,kBAAkB,UAAU,MAAM,OAAO,QAAQ,GAAG,IAAI;EAChE,IAAI,EAAE,gBAAgB,oBAAoB;EAC1C,MAAM,WAAW,KAAK,QAAQ;EAK9B,IAAI,EAHF,aAAa,YACX,aAAa,MAAO,aAAa,KAAA,KAAa,QAAQ,iBACrD,QAAQ,mBAAmB,aAAa,UACjC;EACZ,OAAO,aAAa,OAAO;EAC3B,UAAU,OAAO,iBAAiB;GAChC,IAAI,KAAK,aAAa,SAAS,KAAK,IAAI;EAC1C,GAAG,EAAE;CACP,CAAC;CACD,SAAS,iBAAiB,kBAAkB,OAAO,aAAa,OAAO,CAAC;AAC1E"}

package/dist/client/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","names":[],"sources":["../../src/client/search.ts"],"mappings":";KAAK;EAAiB;EAAa,cAAc;;KAC5C,kBAAkB;EACrB,iBAAiB,QAAQ,iBAAiB;;;iBAI5B,iBACd,SAAS,aACT,SAAS,iBACT,sBACA"}
+{"version":3,"file":"search.d.ts","names":[],"sources":["../../src/client/search.ts"],"mappings":";KAAK;EAAiB;EAAa,cAAc;;KAE5C,kBAAkB;EACrB,iBAAiB,QAAQ,iBAAiB;;;iBAI5B,iBACd,SAAS,aACT,SAAS,iBACT,sBACA"}

package/dist/client/search.js

@@ -3,6 +3,9 @@
 function initializeSearch(element, options, development, base) {
 	if (element.dataset.initialized) return;
 	element.dataset.initialized = "true";
+	const listeners = new AbortController();
+	const persistenceKey = element.dataset.searchKey;
+	if (persistenceKey) element.setAttribute("data-astro-transition-persist", persistenceKey);
 	const open = element.querySelector("[data-open-modal]");
 	const close = element.querySelector("[data-close-modal]");
 	const dialog = element.querySelector("dialog");
@@ -118,13 +121,24 @@ function initializeSearch(element, options, development, base) {
 		document.body.removeAttribute("data-search-modal-open");
 		returnFocus?.focus();
 	});
+	document.addEventListener("astro:before-swap", (event) => {
+		generation += 1;
+		returnFocus = null;
+		if (dialog.open) dialog.close();
+		dialog.removeAttribute("data-open");
+		document.body.removeAttribute("data-search-modal-open");
+		const next = event.newDocument;
+		const nextRoot = persistenceKey ? [...next.querySelectorAll("site-search")].find((root) => root.dataset.searchKey === persistenceKey) : void 0;
+		if (nextRoot) nextRoot.setAttribute("data-astro-transition-persist", persistenceKey);
+		else listeners.abort();
+	}, { signal: listeners.signal });
 	window.addEventListener("keydown", (event) => {
 		if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "k") {
 			event.preventDefault();
 			if (dialog.open && !closing) hide();
 			else show();
 		}
-	});
+	}, { signal: listeners.signal });
 }
 //#endregion
 export { initializeSearch };

package/dist/client/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","names":[],"sources":["../../src/client/search.ts"],"sourcesContent":["type SearchResult = { url: string; sub_results?: SearchResult[] };\ntype PagefindOptions = Record<string, unknown> & {\n  processResult?: (result: SearchResult) => SearchResult | void;\n};\n\n/** Own the dialog lifecycle; Pagefind owns indexing, filtering and result rendering. */\nexport function initializeSearch(\n  element: HTMLElement,\n  options: PagefindOptions,\n  development: boolean,\n  base: string,\n): void {\n  if (element.dataset.initialized) return;\n  element.dataset.initialized = \"true\";\n  const open = element.querySelector<HTMLButtonElement>(\"[data-open-modal]\")!;\n  const close = element.querySelector<HTMLButtonElement>(\"[data-close-modal]\")!;\n  const dialog = element.querySelector(\"dialog\")!;\n  const frame = element.querySelector(\"[data-element=Frame]\")!;\n  const status = element.querySelector<HTMLElement>(\"[data-search-status]\");\n  const input = element.querySelector<HTMLInputElement>(\"[data-search-input]\");\n  const clear = element.querySelector<HTMLButtonElement>(\"[data-clear-search]\");\n  const shortcut = open.querySelector(\"kbd\")!;\n  if (/(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)) {\n    shortcut.querySelector(\"kbd\")!.textContent = \"⌘\";\n    open.setAttribute(\"aria-keyshortcuts\", \"Meta+K\");\n  }\n  delete shortcut.dataset.pending;\n  let initialized: Promise<void> | undefined;\n  let engineInput: HTMLInputElement | null = null;\n  let returnFocus: HTMLElement | null = null;\n  let closing = false;\n  let generation = 0;\n  const updateSearch = () => {\n    if (clear) clear.hidden = !input?.value;\n    if (engineInput) {\n      engineInput.value = input?.value ?? \"\";\n      engineInput.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    }\n  };\n  input?.addEventListener(\"input\", updateSearch);\n  clear?.addEventListener(\"click\", () => {\n    if (!input) return;\n    input.value = \"\";\n    updateSearch();\n    input.focus();\n  });\n  const initialize = () => {\n    if (development) return Promise.resolve();\n    return (initialized ??= (async () => {\n      // @ts-expect-error Pagefind publishes no declarations for its default UI.\n      const { PagefindUI } = await import(\"@pagefind/default-ui\");\n      const translations = JSON.parse(element.dataset.translations ?? \"{}\");\n      const format = (url: string) =>\n        element.hasAttribute(\"data-strip-trailing-slash\")\n          ? url.replace(/(.)\\/(#.*)?$/, \"$1$2\")\n          : url;\n      new PagefindUI({\n        ...options,\n        element: element.querySelector(\"[data-search-results]\"),\n        baseUrl: base,\n        bundlePath: `${base.replace(/\\/$/, \"\")}/pagefind/`,\n        showImages: false,\n        showSubResults: true,\n        translations,\n        processResult(result: SearchResult) {\n          result = options.processResult?.(result) ?? result;\n          result.url = format(result.url);\n          result.sub_results?.forEach((child) => {\n            child.url = format(child.url);\n          });\n          return result;\n        },\n      });\n      // Pagefind generates and controls these nodes; its UI API exposes only classes.\n      engineInput = element.querySelector(\".pagefind-ui__search-input\");\n      element.querySelector(\".pagefind-ui__form\")?.removeAttribute(\"role\");\n      // Cookbook owns the field so focus stays within the opening tap on mobile.\n      // Pagefind still owns query processing and its lazily rendered results.\n      element\n        .querySelectorAll<HTMLElement>(\n          \".pagefind-ui__search-input, .pagefind-ui__search-clear\",\n        )\n        .forEach((control) => {\n          control.hidden = true;\n          control.tabIndex = -1;\n        });\n      updateSearch();\n    })().catch((error: unknown) => {\n      initialized = undefined;\n      if (status) {\n        status.hidden = false;\n        // Reuse the localized Pagefind error, with a plain fallback.\n        const translations = JSON.parse(element.dataset.translations ?? \"{}\");\n        status.textContent =\n          translations.error ?? \"Search could not load. Close and try again.\";\n      }\n      throw error;\n    }));\n  };\n  const show = (trigger?: HTMLElement) => {\n    if (dialog.open && !closing) return;\n    generation += 1;\n    closing = false;\n    if (!dialog.open) {\n      returnFocus =\n        trigger ??\n        (document.activeElement instanceof HTMLElement &&\n        document.activeElement !== document.body\n          ? document.activeElement\n          : open);\n      dialog.removeAttribute(\"data-open\");\n      dialog.showModal();\n    }\n    // Do this synchronously, before the lazy import releases user activation.\n    input?.focus({ preventScroll: true });\n    // Establish the initial state after entering the top layer. The global\n    // style renderer does not preserve @starting-style in server output.\n    dialog.getBoundingClientRect();\n    dialog.setAttribute(\"data-open\", \"\");\n    document.body.setAttribute(\"data-search-modal-open\", \"\");\n    if (!development && status) status.hidden = true;\n    void initialize().catch(() => {\n      /* Keep the close control usable when the search bundle fails. */\n    });\n  };\n  const hide = async () => {\n    if (!dialog.open || closing) return;\n    closing = true;\n    const current = ++generation;\n    dialog.removeAttribute(\"data-open\");\n    // Keep the modal in the top layer until its exit transition has finished.\n    // This also works in browsers without discrete display/overlay transitions.\n    await Promise.allSettled(\n      dialog\n        .getAnimations()\n        .filter((animation) =>\n          Number.isFinite(animation.effect?.getComputedTiming().endTime),\n        )\n        .map((animation) => animation.finished),\n    );\n    if (current === generation && dialog.open) dialog.close();\n  };\n  open.addEventListener(\"click\", () => {\n    show(open);\n  });\n  open.disabled = false;\n  close.addEventListener(\"click\", () => void hide());\n  dialog.addEventListener(\"cancel\", (event) => {\n    event.preventDefault();\n    void hide();\n  });\n  dialog.addEventListener(\"click\", (event) => {\n    if (!(event.target instanceof Element)) return;\n    if (event.target.closest(\"a[href]\") || !frame.contains(event.target))\n      void hide();\n  });\n  dialog.addEventListener(\"close\", () => {\n    dialog.removeAttribute(\"data-open\");\n    closing = false;\n    document.body.removeAttribute(\"data-search-modal-open\");\n    returnFocus?.focus();\n  });\n  window.addEventListener(\"keydown\", (event) => {\n    if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === \"k\") {\n      event.preventDefault();\n      if (dialog.open && !closing) void hide();\n      else void show();\n    }\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"search.js","names":[],"sources":["../../src/client/search.ts"],"sourcesContent":["type SearchResult = { url: string; sub_results?: SearchResult[] };\nimport type { TransitionBeforeSwapEvent } from \"astro:transitions/client\";\ntype PagefindOptions = Record<string, unknown> & {\n  processResult?: (result: SearchResult) => SearchResult | void;\n};\n\n/** Own the dialog lifecycle; Pagefind owns indexing, filtering and result rendering. */\nexport function initializeSearch(\n  element: HTMLElement,\n  options: PagefindOptions,\n  development: boolean,\n  base: string,\n): void {\n  if (element.dataset.initialized) return;\n  element.dataset.initialized = \"true\";\n  const listeners = new AbortController();\n  // Astro strips transition attributes from unhydrated framework roots. Apply\n  // the public persistence hook here and to the incoming matching search root.\n  const persistenceKey = element.dataset.searchKey;\n  if (persistenceKey)\n    element.setAttribute(\"data-astro-transition-persist\", persistenceKey);\n  const open = element.querySelector<HTMLButtonElement>(\"[data-open-modal]\")!;\n  const close = element.querySelector<HTMLButtonElement>(\"[data-close-modal]\")!;\n  const dialog = element.querySelector(\"dialog\")!;\n  const frame = element.querySelector(\"[data-element=Frame]\")!;\n  const status = element.querySelector<HTMLElement>(\"[data-search-status]\");\n  const input = element.querySelector<HTMLInputElement>(\"[data-search-input]\");\n  const clear = element.querySelector<HTMLButtonElement>(\"[data-clear-search]\");\n  const shortcut = open.querySelector(\"kbd\")!;\n  if (/(Mac|iPhone|iPod|iPad)/i.test(navigator.platform)) {\n    shortcut.querySelector(\"kbd\")!.textContent = \"⌘\";\n    open.setAttribute(\"aria-keyshortcuts\", \"Meta+K\");\n  }\n  delete shortcut.dataset.pending;\n  let initialized: Promise<void> | undefined;\n  let engineInput: HTMLInputElement | null = null;\n  let returnFocus: HTMLElement | null = null;\n  let closing = false;\n  let generation = 0;\n  const updateSearch = () => {\n    if (clear) clear.hidden = !input?.value;\n    if (engineInput) {\n      engineInput.value = input?.value ?? \"\";\n      engineInput.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    }\n  };\n  input?.addEventListener(\"input\", updateSearch);\n  clear?.addEventListener(\"click\", () => {\n    if (!input) return;\n    input.value = \"\";\n    updateSearch();\n    input.focus();\n  });\n  const initialize = () => {\n    if (development) return Promise.resolve();\n    return (initialized ??= (async () => {\n      // @ts-expect-error Pagefind publishes no declarations for its default UI.\n      const { PagefindUI } = await import(\"@pagefind/default-ui\");\n      const translations = JSON.parse(element.dataset.translations ?? \"{}\");\n      const format = (url: string) =>\n        element.hasAttribute(\"data-strip-trailing-slash\")\n          ? url.replace(/(.)\\/(#.*)?$/, \"$1$2\")\n          : url;\n      new PagefindUI({\n        ...options,\n        element: element.querySelector(\"[data-search-results]\"),\n        baseUrl: base,\n        bundlePath: `${base.replace(/\\/$/, \"\")}/pagefind/`,\n        showImages: false,\n        showSubResults: true,\n        translations,\n        processResult(result: SearchResult) {\n          result = options.processResult?.(result) ?? result;\n          result.url = format(result.url);\n          result.sub_results?.forEach((child) => {\n            child.url = format(child.url);\n          });\n          return result;\n        },\n      });\n      // Pagefind generates and controls these nodes; its UI API exposes only classes.\n      engineInput = element.querySelector(\".pagefind-ui__search-input\");\n      element.querySelector(\".pagefind-ui__form\")?.removeAttribute(\"role\");\n      // Cookbook owns the field so focus stays within the opening tap on mobile.\n      // Pagefind still owns query processing and its lazily rendered results.\n      element\n        .querySelectorAll<HTMLElement>(\n          \".pagefind-ui__search-input, .pagefind-ui__search-clear\",\n        )\n        .forEach((control) => {\n          control.hidden = true;\n          control.tabIndex = -1;\n        });\n      updateSearch();\n    })().catch((error: unknown) => {\n      initialized = undefined;\n      if (status) {\n        status.hidden = false;\n        // Reuse the localized Pagefind error, with a plain fallback.\n        const translations = JSON.parse(element.dataset.translations ?? \"{}\");\n        status.textContent =\n          translations.error ?? \"Search could not load. Close and try again.\";\n      }\n      throw error;\n    }));\n  };\n  const show = (trigger?: HTMLElement) => {\n    if (dialog.open && !closing) return;\n    generation += 1;\n    closing = false;\n    if (!dialog.open) {\n      returnFocus =\n        trigger ??\n        (document.activeElement instanceof HTMLElement &&\n        document.activeElement !== document.body\n          ? document.activeElement\n          : open);\n      dialog.removeAttribute(\"data-open\");\n      dialog.showModal();\n    }\n    // Do this synchronously, before the lazy import releases user activation.\n    input?.focus({ preventScroll: true });\n    // Establish the initial state after entering the top layer. The global\n    // style renderer does not preserve @starting-style in server output.\n    dialog.getBoundingClientRect();\n    dialog.setAttribute(\"data-open\", \"\");\n    document.body.setAttribute(\"data-search-modal-open\", \"\");\n    if (!development && status) status.hidden = true;\n    void initialize().catch(() => {\n      /* Keep the close control usable when the search bundle fails. */\n    });\n  };\n  const hide = async () => {\n    if (!dialog.open || closing) return;\n    closing = true;\n    const current = ++generation;\n    dialog.removeAttribute(\"data-open\");\n    // Keep the modal in the top layer until its exit transition has finished.\n    // This also works in browsers without discrete display/overlay transitions.\n    await Promise.allSettled(\n      dialog\n        .getAnimations()\n        .filter((animation) =>\n          Number.isFinite(animation.effect?.getComputedTiming().endTime),\n        )\n        .map((animation) => animation.finished),\n    );\n    if (current === generation && dialog.open) dialog.close();\n  };\n  open.addEventListener(\"click\", () => {\n    show(open);\n  });\n  open.disabled = false;\n  close.addEventListener(\"click\", () => void hide());\n  dialog.addEventListener(\"cancel\", (event) => {\n    event.preventDefault();\n    void hide();\n  });\n  dialog.addEventListener(\"click\", (event) => {\n    if (!(event.target instanceof Element)) return;\n    if (event.target.closest(\"a[href]\") || !frame.contains(event.target))\n      void hide();\n  });\n  dialog.addEventListener(\"close\", () => {\n    dialog.removeAttribute(\"data-open\");\n    closing = false;\n    document.body.removeAttribute(\"data-search-modal-open\");\n    returnFocus?.focus();\n  });\n  document.addEventListener(\n    \"astro:before-swap\",\n    (event) => {\n      // Keep the query and lazy engine for matching localized search shells,\n      // while dismissing the modal before the destination content is displayed.\n      generation += 1;\n      returnFocus = null;\n      if (dialog.open) dialog.close();\n      dialog.removeAttribute(\"data-open\");\n      document.body.removeAttribute(\"data-search-modal-open\");\n      const next = (event as TransitionBeforeSwapEvent).newDocument;\n      const nextRoot = persistenceKey\n        ? [...next.querySelectorAll<HTMLElement>(\"site-search\")].find(\n            (root) => root.dataset.searchKey === persistenceKey,\n          )\n        : undefined;\n      if (nextRoot)\n        nextRoot.setAttribute(\"data-astro-transition-persist\", persistenceKey!);\n      else listeners.abort();\n    },\n    { signal: listeners.signal },\n  );\n  window.addEventListener(\n    \"keydown\",\n    (event) => {\n      if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === \"k\") {\n        event.preventDefault();\n        if (dialog.open && !closing) void hide();\n        else void show();\n      }\n    },\n    { signal: listeners.signal },\n  );\n}\n"],"mappings":"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"}

package/dist/components/AppearanceInit.astro

@@ -0,0 +1,6 @@
+---
+import bootstrap from "./appearance-bootstrap.js?raw";
+---
+
+<!-- Apply stored appearance before the body can paint, including with a replaced Head. -->
+<script is:inline set:html={bootstrap} />

package/dist/components/Document.styles.js

@@ -183,6 +183,19 @@ export default function DocumentStyles() {
         whiteSpace: { "": null, "@own(sr-only)": "nowrap" },
         border: { "": null, "@own(sr-only)": "0" },
       },
+      RouteAnnouncer: {
+        // Astro's public router creates this class; its generated markup has
+        // no owned data-element hook. Keep the bridge scoped to its announcer.
+        $: ".astro-route-announcer",
+        position: "absolute",
+        inset: "0 top, 0 left",
+        "$visually-hidden-size": "1px",
+        inlineSize: "$visually-hidden-size",
+        blockSize: "$visually-hidden-size",
+        overflow: "hidden",
+        clip: "rect(0, 0, 0, 0)",
+        whiteSpace: "nowrap",
+      },
       Strong: { $: ":where(strong), :where(b)", preset: "strong" },
       Link: { $: "a", color: "#accent-text" },
       NarrowBlock: {

package/dist/components/SelectPopover.astro

@@ -59,7 +59,16 @@ const id = `select-${crypto.randomUUID()}`;
 <script>
   import { initializePopoverMotion } from "../client/popover-motion.js";
 
-  document
-    .querySelectorAll<HTMLElement>("[data-select-popover-panel]")
-    .forEach((panel) => initializePopoverMotion(panel));
+  const initialized = new WeakSet<HTMLElement>();
+  function initialize(): void {
+    document
+      .querySelectorAll<HTMLElement>("[data-select-popover-panel]")
+      .forEach((panel) => {
+        if (initialized.has(panel)) return;
+        initialized.add(panel);
+        initializePopoverMotion(panel);
+      });
+  }
+  initialize();
+  document.addEventListener("astro:page-load", initialize);
 </script>

package/dist/components/appearance-bootstrap.js

@@ -0,0 +1,21 @@
+// Kept dependency-free for the page shell's synchronous, pre-paint script.
+(() => {
+  const root = globalThis.document.documentElement;
+  try {
+    const scheme = globalThis.localStorage.getItem("cookbook-theme");
+    if (scheme === "light" || scheme === "dark") root.dataset.theme = scheme;
+    else delete root.dataset.theme;
+  } catch {
+    // Without storage, the document's system appearance rules remain active.
+  }
+  try {
+    const appearance = JSON.parse(
+      globalThis.localStorage.getItem("cookbook-appearance") ?? "{}",
+    );
+    if (appearance?.contrast === "normal" || appearance?.contrast === "more")
+      root.dataset.contrast = appearance.contrast;
+    else delete root.dataset.contrast;
+  } catch {
+    // Malformed or unavailable storage must not prevent the first paint.
+  }
+})();

package/dist/index.js

@@ -1273,9 +1273,18 @@ function configuredCookbook(options) {
 					srcDir: context.config.srcDir
 				};
 				let markdownRenderer;
+				const prefetch = context.config.prefetch ?? {
+					prefetchAll: true,
+					defaultStrategy: "hover"
+				};
+				if (prefetch !== false) {
+					const focusScript = fileURLToPath(new URL("./client/prefetch-focus.js", import.meta.url));
+					context.injectScript("page", `import { initializePrefetchFocus } from ${JSON.stringify(focusScript)}; initializePrefetchFocus(${JSON.stringify(typeof prefetch === "object" ? prefetch : {})});`);
+				}
 				context.updateConfig({
 					...configuredSite && !context.config.site ? { site: configuredSite } : {},
 					base,
+					prefetch,
 					markdown: {
 						syntaxHighlight: "shiki",
 						shikiConfig: cookbookShikiConfig(context.config.markdown.shikiConfig)