@tenphi/renderer 0.25.0 → 0.25.2

package/dist/client/navigation-router.js

@@ -4,6 +4,7 @@ import { navigate } from "astro:transitions/client";
 document.addEventListener("astro:before-swap", (event) => {
 	const transition = event;
 	transition.viewTransition.skipTransition();
+	transition.viewTransition.ready.catch(() => {});
 	for (const name of ["data-theme", "data-contrast"]) {
 		const value = document.documentElement.getAttribute(name);
 		if (value === null) transition.newDocument.documentElement.removeAttribute(name);

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

@@ -1 +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"}
+{"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  void transition.viewTransition.ready.catch(() => {\n    // Skipping rejects `ready` with an AbortError that nothing else observes.\n  });\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,WAAgB,eAAe,MAAM,YAAY,CAEjD,CAAC;CACD,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/search.js

@@ -43,7 +43,12 @@ function initializeSearch(element, options, development, base) {
 		return initialized ??= (async () => {
 			const { PagefindUI } = await import("@pagefind/default-ui");
 			const translations = JSON.parse(element.dataset.translations ?? "{}");
-			const format = (url) => element.hasAttribute("data-strip-trailing-slash") ? url.replace(/(.)\/(#.*)?$/, "$1$2") : url;
+			const format = (url) => {
+				const trailingSlash = element.dataset.trailingSlash;
+				if (trailingSlash === "always") return url;
+				const page = url.replace(/\.html(?=#|$)/, "");
+				return trailingSlash === "never" ? page.replace(/(.)\/(#.*)?$/, "$1$2") : page;
+			};
 			new PagefindUI({
 				...options,
 				element: element.querySelector("[data-search-results]"),

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[] };\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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"}
+{"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      // Pagefind names pages by their files: x/ for x/index.html, x.html otherwise.\n      const format = (url: string) => {\n        const trailingSlash = element.dataset.trailingSlash;\n        if (trailingSlash === \"always\") return url;\n        const page = url.replace(/\\.html(?=#|$)/, \"\");\n        return trailingSlash === \"never\"\n          ? page.replace(/(.)\\/(#.*)?$/, \"$1$2\")\n          : page;\n      };\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/MarkdownTable.styles.js

@@ -22,6 +22,12 @@ export function MarkdownTableStyles() {
         $: "th, td",
         padding: "($gap * 1.5) ($gap * 2)",
         verticalAlign: "top",
+        textAlign: {
+          "": null,
+          "@own(align=left)": "left",
+          "@own(align=center)": "center",
+          "@own(align=right)": "right",
+        },
         // Change only color; border widths and styles belong to other rules or theme overrides.
         // eslint-disable-next-line tasty/prefer-shorthand-property
         borderColor: "#border",
@@ -36,7 +42,7 @@ export function MarkdownTableStyles() {
         $: "th",
         color: "#text",
         fill: "#surface-2",
-        textAlign: "start",
+        textAlign: { "": "start", "@own(align)": null },
         radius: {
           "@own(:is(thead:first-child tr:first-child >) & :first-child & !:last-child)":
             "($card-radius - $border-width) top-left",

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/plugin-contract.ts","../src/integration.ts"],"mappings":";;;;;KAEY;EAEN,WAAW,iBAAiB,QAAQ;;EAGpC,MAAM,iBAAiB;;;;UCmGZ;EACf,SAAS;EACT;EACA;;EAEA,oBAAoB;;iBAGE,SACtB,UAAS,kBACR"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/plugin-contract.ts","../src/integration.ts"],"mappings":";;;;;KAEY;EAEN,WAAW,iBAAiB,QAAQ;;EAGpC,MAAM,iBAAiB;;;;UCyGZ;EACf,SAAS;EACT;EACA;;EAEA,oBAAoB;;iBAGE,SACtB,UAAS,kBACR"}

package/dist/index.js

@@ -10,7 +10,7 @@ import { createRequire } from "node:module";
 import { cp, mkdir, readFile, readdir, rename, stat, unlink, writeFile } from "node:fs/promises";
 import { dirname, extname, isAbsolute, join, resolve, sep } from "node:path";
 import sharp from "sharp";
-import { DOCS_FRONTMATTER_KEYS, assertValidDocs, createDocsGraph, renderAgentMarkdown, resolveColorTheme, resolveDocsProject } from "@tenphi/docs";
+import { DOCS_FRONTMATTER_KEYS, assertValidDocs, createDocsGraph, renderAgentMarkdown, resolveColorTheme, resolveDocsProject, routePath, routeUrl } from "@tenphi/docs";
 import { createHash, randomUUID } from "node:crypto";
 import { fromHtml } from "hast-util-from-html";
 import { existsSync } from "node:fs";
@@ -304,7 +304,7 @@ const alerts = {
 };
 /** Keep GitHub alert syntax useful in repository Markdown and MDX. */
 function rehypeAlerts() {
-	return (tree) => visit(tree);
+	return (tree) => visit$1(tree);
 }
 const satteriAlerts = {
 	name: "cookbook:alerts",
@@ -316,12 +316,12 @@ const satteriAlerts = {
 		}
 	}
 };
-function visit(parent) {
+function visit$1(parent) {
 	if (!parent.children) return;
 	for (const [index, child] of parent.children.entries()) {
 		const replacement = alert(child);
 		if (replacement) parent.children[index] = replacement;
-		else visit(child);
+		else visit$1(child);
 	}
 }
 function alert(blockquote) {
@@ -367,6 +367,53 @@ function alert(blockquote) {
 	};
 }
 //#endregion
+//#region src/markdown/rehype-table-alignment.ts
+const alignments = /* @__PURE__ */ new Set([
+	"left",
+	"center",
+	"right"
+]);
+/**
+* Move GFM column alignment into a `data-align` modifier styled by
+* `MarkdownTable`. Unified emits the obsolete `align` attribute and Sätteri an
+* inline `text-align` style, which the Tasty-only output check rejects.
+*/
+function rehypeTableAlignment() {
+	return (tree) => visit(tree);
+}
+/** Sätteri adapter for Astro's default Markdown processor. */
+const satteriTableAlignment = {
+	name: "cookbook:table-alignment",
+	element: {
+		filter: ["th", "td"],
+		visit(node, context) {
+			const replacement = alignedCell(node);
+			if (replacement) context.replaceNode(node, replacement);
+		}
+	}
+};
+function visit(parent) {
+	if (!parent.children) return;
+	for (const [index, child] of parent.children.entries()) {
+		const replacement = alignedCell(child);
+		if (replacement) parent.children[index] = replacement;
+		else visit(child);
+	}
+}
+function alignedCell(cell) {
+	if (cell.type !== "element" || cell.tagName !== "th" && cell.tagName !== "td") return;
+	const { align, style, ...properties } = cell.properties ?? {};
+	const alignment = (typeof align === "string" ? align : typeof style === "string" ? /^\s*text-align:\s*([a-z]+)\s*;?\s*$/i.exec(style)?.[1] : void 0)?.toLowerCase();
+	if (!alignment || !alignments.has(alignment)) return;
+	return {
+		...cell,
+		properties: {
+			...properties,
+			dataAlign: alignment
+		}
+	};
+}
+//#endregion
 //#region src/markdown/rehype-table-scroll.ts
 const containerElement = "Scroll";
 /** Wrap Markdown tables in a dedicated horizontal scroll container. */
@@ -1002,9 +1049,6 @@ function outputPathForPublicAsset(publicPath, base) {
 }
 //#endregion
 //#region src/agent-discovery.ts
-function sitePath(base, route) {
-	return `${base === "/" ? "" : `/${base.replace(/^\/+|\/+$/g, "")}`}${route === "/" ? "/" : `${route}/`}`;
-}
 function pageUrl(site, path) {
 	return site ? new URL(path, site).href : path;
 }
@@ -1022,7 +1066,7 @@ function renderLlmsTxt(graph) {
 	const discoverable = new Set(graph.routes.filter((route) => route.discoverable !== false && route.sitemap !== false).map((route) => route.route));
 	for (const entry of graph.entries) {
 		if (!discoverable.has(entry.route)) continue;
-		const url = pageUrl(site.url, sitePath(build.base, entry.route));
+		const url = routeUrl(entry.route, build.base, site.url, build.trailingSlash);
 		lines.push(`- [${markdownLabel(entry.title)}](${url})${entry.description ? `: ${singleLine(entry.description)}` : ""}${site.seo?.copyPage === false ? "" : ` ([Markdown](${pageUrl(site.url, agentPagePath(entry.route, build.base))}))`}`);
 	}
 	return `${lines.join("\n")}\n`;
@@ -1049,7 +1093,7 @@ async function writeAgentDiscovery(output, graph) {
 		if (markdown) await writeFile(join(output, outputPathForPublicAsset(markdown, graph.config.build.base)), renderAgentMarkdown(entry, graph.config));
 		pages.push({
 			route: entry.route,
-			url: pageUrl(graph.config.site.url, sitePath(graph.config.build.base, entry.route)),
+			url: routeUrl(entry.route, graph.config.build.base, graph.config.site.url, graph.config.build.trailingSlash),
 			canonical: route.canonical,
 			index: route.indexable !== false,
 			discoverable: route.discoverable !== false,
@@ -1160,6 +1204,7 @@ function configuredCookbook(options) {
 	let projectRoot = options.root;
 	let graphConfig = options.config;
 	let graphBase = "/";
+	let graphTrailingSlash = "always";
 	let graph;
 	let siteIconBase = "/";
 	let siteIcons;
@@ -1171,7 +1216,8 @@ function configuredCookbook(options) {
 			const candidate = await createDocsGraph({
 				...projectRoot ? { root: projectRoot } : {},
 				...graphConfig ? { config: graphConfig } : {},
-				base: graphBase
+				base: graphBase,
+				trailingSlash: graphTrailingSlash
 			});
 			assertValidDocs(candidate);
 			await validatePluginFrontmatter(candidate.entries, options.frontmatterSchema);
@@ -1236,6 +1282,7 @@ function configuredCookbook(options) {
 				};
 				siteIconBase = base;
 				graphBase = base;
+				graphTrailingSlash = context.config.trailingSlash !== "ignore" ? context.config.trailingSlash : context.config.build.format === "directory" ? "always" : "index";
 				context.config.integrations.push(sitemap({
 					serialize: (item) => {
 						if (!graph?.config.locales) return item;
@@ -1244,7 +1291,7 @@ function configuredCookbook(options) {
 							...item,
 							links: localeAlternates(route, graph.routes.filter((route) => route.sitemap !== false), graph.config).map(({ lang, route }) => ({
 								lang,
-								url: new URL(`${graphBase.replace(/\/$/, "")}${route === "/" ? "/" : `${route}/`}`, item.url).href
+								url: new URL(routePath(route, graphBase, graphTrailingSlash), item.url).href
 							}))
 						};
 					},
@@ -1373,6 +1420,7 @@ function configuredCookbook(options) {
 										}
 									} : documentedSite(loaded),
 									base: loaded.config.build.base,
+									trailingSlash: loaded.config.build.trailingSlash,
 									search: loaded.config.search.enabled || typeof options.config?.components?.overrides?.Search === "string",
 									logo: siteLogo?.logo,
 									locales: loaded.config.locales,
@@ -1410,7 +1458,8 @@ function configuredCookbook(options) {
 				graph = await createDocsGraph({
 					root: projectRoot,
 					...graphConfig ? { config: graphConfig } : {},
-					base: graphBase
+					base: graphBase,
+					trailingSlash: graphTrailingSlash
 				});
 				assertValidDocs(graph);
 				context.injectRoute({
@@ -1607,6 +1656,7 @@ function registerCookbookMarkdownPlugins(processor) {
 		const plugins = Array.isArray(options.rehypePlugins) ? options.rehypePlugins : [];
 		if (!plugins.includes(rehypeMermaid)) plugins.push(rehypeMermaid);
 		if (!plugins.includes(rehypeAlerts)) plugins.push(rehypeAlerts);
+		if (!plugins.includes(rehypeTableAlignment)) plugins.push(rehypeTableAlignment);
 		if (!plugins.includes(rehypeTableScroll)) plugins.push(rehypeTableScroll);
 		if (!plugins.includes(rehypePageAffordances)) plugins.push(rehypePageAffordances);
 		options.rehypePlugins = plugins;
@@ -1615,6 +1665,7 @@ function registerCookbookMarkdownPlugins(processor) {
 		const plugins = Array.isArray(options.hastPlugins) ? options.hastPlugins : [];
 		if (!plugins.includes(satteriMermaid)) plugins.push(satteriMermaid);
 		if (!plugins.includes(satteriAlerts)) plugins.push(satteriAlerts);
+		if (!plugins.includes(satteriTableAlignment)) plugins.push(satteriTableAlignment);
 		if (!plugins.includes(satteriTableScroll)) plugins.push(satteriTableScroll);
 		if (!plugins.includes(satteriPageAffordances)) plugins.push(satteriPageAffordances);
 		options.hastPlugins = plugins;