zudoku 0.33.1 → 0.34.0

package/lib/zudoku.plugin-search-pagefind.js

@@ -0,0 +1,204 @@
+import { j as e } from "./jsx-runtime-CYK1ROHF.js";
+import { C as x } from "./ClientOnly-E7hGysn1.js";
+import { VisuallyHidden as y } from "@radix-ui/react-visually-hidden";
+import { d as f, k as j } from "./useQuery-CQUwWR9i.js";
+import { useCallback as S, useState as b } from "react";
+import { C as k, a as u, b as h, c as C, d as N, e as v, f as w } from "./Callout-B_sEhkYd.js";
+import { b as _ } from "./Dialog-sbgekbjb.js";
+import { j as L } from "./joinUrl-10po2Jdj.js";
+import { FileTextIcon as F } from "lucide-react";
+import { a as T, L as g } from "./chunk-HA7DTUK3-ZGg2W6yV.js";
+const q = async (r, o) => {
+  const s = o.maxResults ?? 10, n = o.transformResults ?? (() => !0), i = [], l = R(r, n);
+  for await (const a of l)
+    if (i.push(a), i.length >= s) break;
+  return i;
+};
+async function* R(r, o) {
+  let n = 0;
+  for (; n < r.results.length; ) {
+    const i = r.results.slice(
+      n,
+      n + 5
+    );
+    n += i.length;
+    const l = await Promise.all(i.map((a) => a.data()));
+    for (const a of l) {
+      const t = o(a);
+      t !== !1 && (t === !0 || t == null ? yield a : yield t);
+    }
+  }
+}
+const $ = (r, o) => {
+  const s = r.weighted_locations.reduce(
+    (i, l) => i + l.balanced_score,
+    0
+  );
+  return o.weighted_locations.reduce(
+    (i, l) => i + l.balanced_score,
+    0
+  ) - s;
+}, p = "cursor-pointer border border-transparent data-[selected=true]:border-border", D = ({
+  basePath: r,
+  searchResults: o,
+  searchTerm: s,
+  onClose: n,
+  maxSubResults: i = 4
+}) => {
+  const l = T(), a = S(
+    (t) => {
+      const c = t.replace(".html", "");
+      return r && c.startsWith(r) ? c.slice(r.length) : c;
+    },
+    [r]
+  );
+  return /* @__PURE__ */ e.jsxs(k, { className: "max-h-[450px]", children: [
+    s && o.length > 0 && /* @__PURE__ */ e.jsx(
+      u,
+      {
+        className: "text-sm text-muted-foreground",
+        heading: `${o.length} results for "${s}"`
+      }
+    ),
+    o.map((t) => /* @__PURE__ */ e.jsxs(
+      u,
+      {
+        children: [
+          /* @__PURE__ */ e.jsx(
+            h,
+            {
+              asChild: !0,
+              value: `${t.meta.title}-${t.url}`,
+              className: p,
+              onSelect: () => {
+                l(a(t.url)), n();
+              },
+              children: /* @__PURE__ */ e.jsxs(g, { to: a(t.url), children: [
+                /* @__PURE__ */ e.jsx(F, { size: 20, className: "text-muted-foreground" }),
+                t.meta.title
+              ] })
+            }
+          ),
+          t.sub_results.sort($).slice(0, i).map((c) => /* @__PURE__ */ e.jsx(
+            h,
+            {
+              asChild: !0,
+              value: `${t.meta.title}-${c.url}`,
+              className: p,
+              onSelect: () => {
+                l(a(c.url)), n();
+              },
+              children: /* @__PURE__ */ e.jsx(g, { to: a(c.url), onClick: n, children: /* @__PURE__ */ e.jsxs("div", { className: "flex flex-col items-start gap-2 ms-2.5 ps-5 border-l border-muted-foreground/50", children: [
+                /* @__PURE__ */ e.jsx("span", { className: "font-bold", children: c.title }),
+                /* @__PURE__ */ e.jsx(
+                  "span",
+                  {
+                    className: "text-[13px] [&_mark]:bg-primary [&_mark]:text-primary-foreground",
+                    dangerouslySetInnerHTML: { __html: c.excerpt }
+                  }
+                )
+              ] }) })
+            },
+            `${t.meta.title}-${c.url}`
+          ))
+        ]
+      },
+      [t.meta.title ?? t.excerpt, t.url].join("-")
+    ))
+  ] });
+}, d = {
+  // Slightly lower than default because API docs tend to have repetitive terms (parameter names, HTTP methods, etc.)
+  termFrequency: 0.8,
+  // Lower than default because API documentation pages tend to be longer due to comprehensive endpoint documentation
+  pageLength: 0.6,
+  // Slightly higher than default because in technical documentation, exact matches should be prioritized
+  termSimilarity: 1.2,
+  // Slightly lower than default because API docs might have legitimate repetition of terms
+  termSaturation: 1.2
+}, E = (r) => import(
+  /* @vite-ignore */
+  L(r, "/pagefind/pagefind.js")
+), I = (r) => {
+  const { data: o, ...s } = f({
+    queryKey: ["pagefind", r.ranking],
+    retry: !1,
+    queryFn: async () => {
+      var i, l, a, t;
+      const n = await E(r.basePath);
+      return await n.init(), await n.options({
+        ranking: {
+          termFrequency: ((i = r.ranking) == null ? void 0 : i.termFrequency) ?? d.termFrequency,
+          pageLength: ((l = r.ranking) == null ? void 0 : l.pageLength) ?? d.pageLength,
+          termSimilarity: ((a = r.ranking) == null ? void 0 : a.termSimilarity) ?? d.termSimilarity,
+          termSaturation: ((t = r.ranking) == null ? void 0 : t.termSaturation) ?? d.termSaturation
+        }
+      }), n;
+    },
+    enabled: typeof window < "u"
+  });
+  return s.isError && console.error(s.error), { ...s, pagefind: o };
+}, P = ({
+  isOpen: r,
+  onClose: o,
+  options: s
+}) => {
+  const { pagefind: n, error: i, isError: l } = I(s), [a, t] = b(""), { data: c } = f({
+    queryKey: ["pagefind-search", a],
+    queryFn: async () => {
+      const m = await (n == null ? void 0 : n.search(a));
+      return m ? q(m, s) : [];
+    },
+    placeholderData: j,
+    enabled: !!n && !!a
+  });
+  return /* @__PURE__ */ e.jsxs(
+    C,
+    {
+      command: { shouldFilter: !1 },
+      content: { className: "max-w-[750px]" },
+      open: r,
+      onOpenChange: o,
+      children: [
+        /* @__PURE__ */ e.jsx(y, { children: /* @__PURE__ */ e.jsx(_, { children: "Search" }) }),
+        /* @__PURE__ */ e.jsx(
+          N,
+          {
+            placeholder: "Search...",
+            value: a,
+            onValueChange: t,
+            disabled: l
+          }
+        ),
+        /* @__PURE__ */ e.jsx(v, { children: a ? "No results found." : "Start typing to search" }),
+        l ? /* @__PURE__ */ e.jsx("div", { className: "p-4 text-sm", children: i.message === "NOT_BUILT_YET" ? /* @__PURE__ */ e.jsxs(w, { type: "info", children: [
+          "Search is currently not available in development mode by default.",
+          /* @__PURE__ */ e.jsx("br", {}),
+          "To still use search in development, run ",
+          /* @__PURE__ */ e.jsx("code", { children: "zudoku build" }),
+          " ",
+          "and copy the ",
+          /* @__PURE__ */ e.jsx("code", { children: "dist/pagefind" }),
+          " directory to your",
+          " ",
+          /* @__PURE__ */ e.jsx("code", { children: "public" }),
+          " directory."
+        ] }) : "An error occurred while loading search." }) : /* @__PURE__ */ e.jsx(
+          D,
+          {
+            basePath: s.basePath,
+            searchResults: c ?? [],
+            searchTerm: a,
+            onClose: o,
+            maxSubResults: s.maxSubResults
+          }
+        )
+      ]
+    }
+  );
+}, Q = (r) => ({
+  renderSearch: ({ isOpen: o, onClose: s }) => /* @__PURE__ */ e.jsx(x, { children: /* @__PURE__ */ e.jsx(P, { isOpen: o, onClose: s, options: r }) })
+});
+export {
+  Q as pagefindSearchPlugin
+};
+//# sourceMappingURL=zudoku.plugin-search-pagefind.js.map

package/lib/zudoku.plugin-search-pagefind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zudoku.plugin-search-pagefind.js","sources":["../src/lib/plugins/search-pagefind/get-results.tsx","../src/lib/plugins/search-pagefind/ResultList.tsx","../src/lib/plugins/search-pagefind/PagefindSearch.tsx","../src/lib/plugins/search-pagefind/index.tsx"],"sourcesContent":["import type { PagefindOptions } from \"./index.js\";\nimport type { PagefindSearchFragment, PagefindSearchResults } from \"./types.js\";\n\nexport const getResults = async (\n  search: PagefindSearchResults,\n  options: PagefindOptions,\n) => {\n  const maxResults = options.maxResults ?? 10;\n  const transformFn = options.transformResults ?? (() => true);\n\n  const transformedResults: PagefindSearchFragment[] = [];\n\n  const generator = searchResultGenerator(search, transformFn);\n\n  for await (const result of generator) {\n    transformedResults.push(result);\n    if (transformedResults.length >= maxResults) break;\n  }\n\n  return transformedResults;\n};\n\nasync function* searchResultGenerator(\n  search: PagefindSearchResults,\n  transformFn: NonNullable<PagefindOptions[\"transformResults\"]>,\n) {\n  const batchSize = 5;\n  let processedCount = 0;\n\n  while (processedCount < search.results.length) {\n    const batch = search.results.slice(\n      processedCount,\n      processedCount + batchSize,\n    );\n    processedCount += batch.length;\n\n    const batchData = await Promise.all(batch.map((result) => result.data()));\n\n    for (const result of batchData) {\n      const transformed = transformFn(result);\n\n      if (transformed === false) {\n        // Skip this result\n        continue;\n      } else if (transformed === true || transformed == null) {\n        // Keep the original result\n        yield result;\n      } else {\n        // Return the transformed result\n        yield transformed;\n      }\n    }\n  }\n}\n","import { FileTextIcon } from \"lucide-react\";\nimport { useCallback } from \"react\";\nimport { Link, useNavigate } from \"react-router\";\nimport { CommandGroup, CommandItem, CommandList } from \"zudoku/ui/Command.js\";\nimport {\n  type PagefindSearchFragment,\n  type PagefindSubResult,\n} from \"./types.js\";\n\nconst sortSubResults = (a: PagefindSubResult, b: PagefindSubResult) => {\n  const aScore = a.weighted_locations.reduce(\n    (sum, loc) => sum + loc.balanced_score,\n    0,\n  );\n  const bScore = b.weighted_locations.reduce(\n    (sum, loc) => sum + loc.balanced_score,\n    0,\n  );\n  return bScore - aScore;\n};\n\nconst hoverClassname = `cursor-pointer border border-transparent data-[selected=true]:border-border`;\n\nexport const ResultList = ({\n  basePath,\n  searchResults,\n  searchTerm,\n  onClose,\n  maxSubResults = 4,\n}: {\n  basePath?: string;\n  searchResults: PagefindSearchFragment[];\n  searchTerm: string;\n  onClose: () => void;\n  maxSubResults?: number;\n}) => {\n  const navigate = useNavigate();\n\n  const cleanResultUrl = useCallback(\n    (url: string) => {\n      const clean = url.replace(\".html\", \"\");\n      return basePath && clean.startsWith(basePath)\n        ? clean.slice(basePath.length)\n        : clean;\n    },\n    [basePath],\n  );\n\n  return (\n    <CommandList className=\"max-h-[450px]\">\n      {searchTerm && searchResults.length > 0 && (\n        <CommandGroup\n          className=\"text-sm text-muted-foreground\"\n          heading={`${searchResults.length} results for \"${searchTerm}\"`}\n        />\n      )}\n      {searchResults.map((result) => (\n        <CommandGroup\n          key={[result.meta.title ?? result.excerpt, result.url].join(\"-\")}\n        >\n          <CommandItem\n            asChild\n            value={`${result.meta.title}-${result.url}`}\n            className={hoverClassname}\n            onSelect={() => {\n              void navigate(cleanResultUrl(result.url));\n              onClose();\n            }}\n          >\n            <Link to={cleanResultUrl(result.url)}>\n              <FileTextIcon size={20} className=\"text-muted-foreground\" />\n              {result.meta.title}\n            </Link>\n          </CommandItem>\n          {result.sub_results\n            .sort(sortSubResults)\n            .slice(0, maxSubResults)\n            .map((subResult) => (\n              <CommandItem\n                asChild\n                key={`${result.meta.title}-${subResult.url}`}\n                value={`${result.meta.title}-${subResult.url}`}\n                className={hoverClassname}\n                onSelect={() => {\n                  void navigate(cleanResultUrl(subResult.url));\n                  onClose();\n                }}\n              >\n                <Link to={cleanResultUrl(subResult.url)} onClick={onClose}>\n                  <div className=\"flex flex-col items-start gap-2 ms-2.5 ps-5 border-l border-muted-foreground/50\">\n                    <span className=\"font-bold\">{subResult.title}</span>\n                    <span\n                      className=\"text-[13px] [&_mark]:bg-primary [&_mark]:text-primary-foreground\"\n                      dangerouslySetInnerHTML={{ __html: subResult.excerpt }}\n                    />\n                  </div>\n                </Link>\n              </CommandItem>\n            ))}\n        </CommandGroup>\n      ))}\n    </CommandList>\n  );\n};\n","import { VisuallyHidden } from \"@radix-ui/react-visually-hidden\";\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\nimport { useState } from \"react\";\nimport { Callout } from \"zudoku/ui/Callout.js\";\nimport {\n  CommandDialog,\n  CommandEmpty,\n  CommandInput,\n} from \"zudoku/ui/Command.js\";\nimport { DialogTitle } from \"zudoku/ui/Dialog.js\";\nimport { joinUrl } from \"../../util/joinUrl.js\";\nimport { getResults } from \"./get-results.js\";\nimport type { PagefindOptions } from \"./index.js\";\nimport { ResultList } from \"./ResultList.js\";\nimport type { Pagefind } from \"./types.js\";\n\nconst DEFAULT_RANKING = {\n  // Slightly lower than default because API docs tend to have repetitive terms (parameter names, HTTP methods, etc.)\n  termFrequency: 0.8,\n  // Lower than default because API documentation pages tend to be longer due to comprehensive endpoint documentation\n  pageLength: 0.6,\n  // Slightly higher than default because in technical documentation, exact matches should be prioritized\n  termSimilarity: 1.2,\n  // Slightly lower than default because API docs might have legitimate repetition of terms\n  termSaturation: 1.2,\n};\n\nconst importPagefind = (basePath?: string): Promise<Pagefind> =>\n  import.meta.env.DEV\n    ? // @ts-expect-error TypeScript can't resolve the import\n      import(/* @vite-ignore */ \"/pagefind/pagefind.js\")\n    : import(/* @vite-ignore */ joinUrl(basePath, \"/pagefind/pagefind.js\"));\n\nconst usePagefind = (options: PagefindOptions) => {\n  const { data: pagefind, ...result } = useQuery<Pagefind>({\n    queryKey: [\"pagefind\", options.ranking],\n    retry: false,\n    queryFn: async () => {\n      const pagefind = await importPagefind(options.basePath);\n      await pagefind.init();\n      await pagefind.options({\n        ranking: {\n          termFrequency:\n            options.ranking?.termFrequency ?? DEFAULT_RANKING.termFrequency,\n          pageLength: options.ranking?.pageLength ?? DEFAULT_RANKING.pageLength,\n          termSimilarity:\n            options.ranking?.termSimilarity ?? DEFAULT_RANKING.termSimilarity,\n          termSaturation:\n            options.ranking?.termSaturation ?? DEFAULT_RANKING.termSaturation,\n        },\n      });\n\n      return pagefind;\n    },\n    enabled: typeof window !== \"undefined\",\n  });\n\n  if (result.isError) {\n    // eslint-disable-next-line no-console\n    console.error(result.error);\n  }\n\n  return { ...result, pagefind };\n};\n\nexport const PagefindSearch = ({\n  isOpen,\n  onClose,\n  options,\n}: {\n  isOpen: boolean;\n  onClose: () => void;\n  options: PagefindOptions;\n}) => {\n  const { pagefind, error, isError } = usePagefind(options);\n  const [searchTerm, setSearchTerm] = useState(\"\");\n\n  const { data: searchResults } = useQuery({\n    queryKey: [\"pagefind-search\", searchTerm],\n    queryFn: async () => {\n      const search = await pagefind?.search(searchTerm);\n      if (!search) return [];\n      return getResults(search, options);\n    },\n    placeholderData: keepPreviousData,\n    enabled: !!pagefind && !!searchTerm,\n  });\n\n  return (\n    <CommandDialog\n      command={{ shouldFilter: false }}\n      content={{ className: \"max-w-[750px]\" }}\n      open={isOpen}\n      onOpenChange={onClose}\n    >\n      <VisuallyHidden>\n        <DialogTitle>Search</DialogTitle>\n      </VisuallyHidden>\n      <CommandInput\n        placeholder=\"Search...\"\n        value={searchTerm}\n        onValueChange={setSearchTerm}\n        disabled={isError}\n      />\n      <CommandEmpty>\n        {searchTerm ? \"No results found.\" : \"Start typing to search\"}\n      </CommandEmpty>\n      {isError ? (\n        <div className=\"p-4 text-sm\">\n          {error.message === \"NOT_BUILT_YET\" ? (\n            <Callout type=\"info\">\n              Search is currently not available in development mode by default.\n              <br />\n              To still use search in development, run <code>\n                zudoku build\n              </code>{\" \"}\n              and copy the <code>dist/pagefind</code> directory to your{\" \"}\n              <code>public</code> directory.\n            </Callout>\n          ) : (\n            \"An error occurred while loading search.\"\n          )}\n        </div>\n      ) : (\n        <ResultList\n          basePath={options.basePath}\n          searchResults={searchResults ?? []}\n          searchTerm={searchTerm}\n          onClose={onClose}\n          maxSubResults={options.maxSubResults}\n        />\n      )}\n    </CommandDialog>\n  );\n};\n","import type { ZudokuConfig } from \"../../../config/validators/validate.js\";\nimport { ClientOnly } from \"../../components/ClientOnly.js\";\nimport type { ZudokuPlugin } from \"../../core/plugins.js\";\nimport { PagefindSearch } from \"./PagefindSearch.js\";\n\nexport type PagefindOptions = Extract<\n  ZudokuConfig[\"search\"],\n  { type: \"pagefind\" }\n> & { basePath?: string };\n\nexport const pagefindSearchPlugin = (\n  options: PagefindOptions,\n): ZudokuPlugin => {\n  return {\n    renderSearch: ({ isOpen, onClose }) => (\n      <ClientOnly>\n        <PagefindSearch isOpen={isOpen} onClose={onClose} options={options} />\n      </ClientOnly>\n    ),\n  };\n};\n"],"names":["getResults","search","options","maxResults","transformFn","transformedResults","generator","searchResultGenerator","result","processedCount","batch","batchData","transformed","sortSubResults","a","b","aScore","sum","loc","hoverClassname","ResultList","basePath","searchResults","searchTerm","onClose","maxSubResults","navigate","useNavigate","cleanResultUrl","useCallback","url","clean","jsxs","CommandList","jsx","CommandGroup","CommandItem","Link","FileTextIcon","subResult","DEFAULT_RANKING","importPagefind","joinUrl","usePagefind","pagefind","useQuery","_a","_b","_c","_d","PagefindSearch","isOpen","error","isError","setSearchTerm","useState","keepPreviousData","CommandDialog","VisuallyHidden","DialogTitle","CommandInput","CommandEmpty","Callout","pagefindSearchPlugin","ClientOnly"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zudoku",
-  "version": "0.33.1",
+  "version": "0.34.0",
   "type": "module",
   "homepage": "https://zudoku.dev",
   "repository": {
@@ -86,6 +86,10 @@
       "import": "./lib/zudoku.plugin-search-inkeep.js",
       "types": "./dist/lib/plugins/search-inkeep/index.d.ts"
     },
+    "./plugins/search-pagefind": {
+      "import": "./lib/zudoku.plugin-search-pagefind.js",
+      "types": "./dist/lib/plugins/search-pagefind/index.d.ts"
+    },
     "./components": {
       "import": "./lib/zudoku.components.js",
       "types": "./dist/lib/components/index.d.ts"
@@ -167,6 +171,7 @@
     "devlop": "^1.1.0",
     "dotenv": "16.4.7",
     "embla-carousel-react": "8.5.2",
+    "esm-loader-css": "^1.0.3",
     "estree-util-value-to-estree": "3.3.2",
     "express": "4.21.2",
     "glob": "11.0.1",
@@ -186,16 +191,17 @@
     "oauth4webapi": "2.17.0",
     "object-hash": "3.0.0",
     "openapi-types": "12.1.3",
+    "pagefind": "1.4.0-alpha.1",
     "picocolors": "1.1.1",
     "piscina": "5.0.0-alpha.1",
     "postcss": "8.5.2",
-    "posthog-node": "4.6.0",
+    "posthog-node": "4.8.1",
     "prism-react-renderer": "2.4.1",
     "prismjs": "1.29.0",
     "react-error-boundary": "5.0.0",
     "react-hook-form": "7.54.2",
     "react-is": "19.0.0",
-    "react-router": "7.1.5",
+    "react-router": "7.2.0",
     "rehype-mdx-import-media": "1.2.0",
     "rehype-raw": "7.0.0",
     "rehype-slug": "6.0.0",
@@ -226,8 +232,7 @@
     "yargs": "17.7.2",
     "zod": "3.24.2",
     "zod-validation-error": "3.4.0",
-    "zustand": "5.0.3",
-    "esm-loader-css": "^1.0.3"
+    "zustand": "5.0.3"
   },
   "devDependencies": {
     "@graphql-codegen/cli": "5.0.5",

package/src/lib/authentication/hook.ts

@@ -15,7 +15,9 @@ export const useAuth = () => {
         throw new Error("Authentication is not enabled.");
       }
       // TODO: Should handle errors/state
-      await authentication.signIn();
+      await authentication.signIn({
+        redirectTo: window.location.href,
+      });
     },
 
     logout: async () => {
@@ -28,5 +30,14 @@ export const useAuth = () => {
       // Redirect to home
       window.location.href = "/";
     },
+
+    signup: async () => {
+      if (!isAuthEnabled) {
+        throw new Error("Authentication is not enabled.");
+      }
+      await authentication.signUp({
+        redirectTo: window.location.href,
+      });
+    },
   };
 };

package/src/lib/authentication/providers/clerk.tsx

@@ -106,18 +106,22 @@ const clerkAuth: AuthenticationProviderInitializer<
         providerData: null,
       });
     },
-    signIn: async () => {
+    signIn: async ({ redirectTo }: { redirectTo?: string }) => {
       await ensureLoaded;
       await clerkApi?.redirectToSignIn({
-        signInForceRedirectUrl: window.location.origin + redirectToAfterSignIn,
-        signUpForceRedirectUrl: window.location.origin + redirectToAfterSignUp,
+        signInForceRedirectUrl:
+          redirectTo ?? window.location.origin + redirectToAfterSignIn,
+        signUpForceRedirectUrl:
+          redirectTo ?? window.location.origin + redirectToAfterSignUp,
       });
     },
-    signUp: async () => {
+    signUp: async ({ redirectTo }: { redirectTo?: string }) => {
       await ensureLoaded;
       await clerkApi?.redirectToSignUp({
-        signInForceRedirectUrl: window.location.origin + redirectToAfterSignIn,
-        signUpForceRedirectUrl: window.location.origin + redirectToAfterSignUp,
+        signInForceRedirectUrl:
+          redirectTo ?? window.location.origin + redirectToAfterSignIn,
+        signUpForceRedirectUrl:
+          redirectTo ?? window.location.origin + redirectToAfterSignUp,
       });
     },
     getAuthenticationPlugin() {

package/src/lib/components/AnchorLink.tsx

@@ -1,22 +1,22 @@
-import React from "react";
-import { Link, type LinkProps, useLocation } from "react-router";
+import { type MouseEvent } from "react";
+import { NavLink, type NavLinkProps, useHref, useLocation } from "react-router";
 import { useScrollToHash } from "../util/useScrollToAnchor.js";
 
 /**
  * Link that scrolls to anchor even if the hash is already set in the URL.
  */
-export const AnchorLink = (props: LinkProps) => {
+export const AnchorLink = (props: NavLinkProps) => {
   const location = useLocation();
   const scrollToHash = useScrollToHash();
-  const hash = typeof props.to === "string" ? props.to : props.to.hash;
+  const hash = useHref(props.to).split("#")[1];
 
-  const handleClick = (event: React.MouseEvent<HTMLAnchorElement>) => {
+  const handleClick = (event: MouseEvent<HTMLAnchorElement>) => {
     props.onClick?.(event);
-    if (!hash?.startsWith("#") || hash !== location.hash) return;
+    if (hash !== location.hash.slice(1)) return;
 
     event.preventDefault();
     scrollToHash(hash);
   };
 
-  return <Link {...props} onClick={handleClick} />;
+  return <NavLink {...props} onClick={handleClick} />;
 };

package/src/lib/components/Banner.tsx

@@ -34,6 +34,7 @@ export const Banner = () => {
         "relative text-primary-foreground text-sm font-medium px-4 py-2 flex gap-2 items-center",
         mappedColor,
       )}
+      data-pagefind-ignore="all"
       style={style}
     >
       <div className="w-full">{page.banner.message}</div>

package/src/lib/components/Heading.tsx

@@ -38,7 +38,7 @@ const getComponent = (level: number) => {
   }
 };
 
-export type HeadingProps = React.ButtonHTMLAttributes<HTMLButtonElement> &
+export type HeadingProps = React.HTMLAttributes<HTMLHeadingElement> &
   VariantProps<typeof heading> & {
     children: ReactNode;
     className?: string;

package/src/lib/components/Layout.tsx

@@ -89,6 +89,7 @@ export const Layout = ({ children }: { children?: ReactNode }) => {
                 </DrawerTrigger>
               </div>
               <main
+                data-pagefind-body
                 className={cn(
                   "h-full dark:border-white/10 translate-x-0",
                   "lg:overflow-visible",

package/src/lib/components/navigation/SidebarItem.tsx

@@ -67,12 +67,16 @@ export const SidebarItem = ({
         </NavLink>
       );
     case "link":
-      return item.href.startsWith("#") ? (
+      return !item.href.startsWith("http") ? (
         <AnchorLink
-          to={{ hash: item.href, search: searchParams.toString() }}
-          {...{ [DATA_ANCHOR_ATTR]: item.href.slice(1) }}
+          to={{
+            pathname: item.href.split("#")[0],
+            hash: item.href.split("#")[1],
+            search: searchParams.toString(),
+          }}
+          {...{ [DATA_ANCHOR_ATTR]: item.href.split("#")[1] }}
           className={navigationListItem({
-            isActive: item.href.slice(1) === activeAnchor,
+            isActive: item.href.split("#")[1] === activeAnchor,
             className: item.badge?.placement !== "start" && "justify-between",
           })}
           onClick={onRequestClose}
@@ -88,25 +92,6 @@ export const SidebarItem = ({
             <span className="break-all">{item.label}</span>
           )}
         </AnchorLink>
-      ) : !item.href.startsWith("http") ? (
-        <NavLink
-          className={navigationListItem({
-            isActive: item.href.split("#")[1] === activeAnchor,
-            className: item.badge?.placement !== "start" && "justify-between",
-          })}
-          to={item.href}
-        >
-          {item.badge ? (
-            <>
-              <span className="truncate" title={item.label}>
-                {item.label}
-              </span>
-              <SidebarBadge {...item.badge} />
-            </>
-          ) : (
-            <span className="break-all">{item.label}</span>
-          )}
-        </NavLink>
       ) : (
         <a
           className={navigationListItem()}

package/src/lib/core/RouteGuard.tsx

@@ -27,9 +27,10 @@ export const RouteGuard = () => {
     queryKey: ["login-redirect"],
     queryFn: async () => {
       await new Promise((resolve) => setTimeout(resolve, 1200));
-      return zudoku.authentication?.signIn({
+      await zudoku.authentication?.signIn({
         redirectTo: latestPath.current,
       });
+      return true;
     },
     enabled:
       typeof window !== "undefined" &&

package/src/lib/core/ZudokuContext.ts

@@ -24,6 +24,10 @@ export interface ZudokuEvents {
 
 export interface ApiIdentity {
   authorizeRequest: (request: Request) => Promise<Request> | Request;
+  authorizationFields?: {
+    headers?: string[];
+    queryParams?: string[];
+  };
   label: string;
   id: string;
 }

package/src/lib/plugins/api-catalog/Catalog.tsx

@@ -1,6 +1,7 @@
 import { useSuspenseQuery } from "@tanstack/react-query";
+import { Helmet } from "@zudoku/react-helmet-async";
 import { useMatch } from "react-router";
-import { Head, Link } from "zudoku/components";
+import { Link } from "zudoku/components";
 import { useAuthState } from "../../authentication/state.js";
 import { Heading } from "../../components/Heading.js";
 import { Markdown } from "../../components/Markdown.js";
@@ -11,7 +12,10 @@ export const Catalog = ({
   items,
   filterCatalogItems = (items) => items,
   label = "API Library",
-}: Omit<ApiCatalogPluginOptions, "navigationId">) => {
+  categoryLabel,
+}: Omit<ApiCatalogPluginOptions, "navigationId"> & {
+  categoryLabel?: string;
+}) => {
   const auth = useAuthState();
   const match = useMatch({ path: "/catalog/:category" });
   const activeCategory = match?.params.category;
@@ -21,13 +25,25 @@ export const Catalog = ({
     queryKey: ["catalogItems", auth],
   });
 
+  // Only index the overview page, ignore the rest
+  const dataSet = activeCategory ? { "data-pagefind-ignore": "all" } : {};
+
   return (
-    <section className="pt-[--padding-content-top] pb-[--padding-content-bottom]">
-      <Head>
-        <title>{label}</title>
-      </Head>
+    <section
+      className="pt-[--padding-content-top] pb-[--padding-content-bottom]"
+      {...dataSet}
+    >
+      <Helmet>
+        <title>
+          {categoryLabel ? `${categoryLabel} - ` : ""}
+          {label}
+        </title>
+      </Helmet>
       <div className="grid gap-4">
-        <Heading level={2}>{label}</Heading>
+        <Heading level={2}>
+          {label}
+          {categoryLabel && ` - ${categoryLabel}`}
+        </Heading>
 
         <div className="grid grid-cols-2 gap-4">
           {catalogItems.data

package/src/lib/plugins/api-catalog/index.tsx

@@ -98,6 +98,7 @@ export const apiCatalogPlugin = ({
           element: (
             <Catalog
               label={label}
+              categoryLabel={tag}
               items={items}
               filterCatalogItems={filterCatalogItems}
               categories={categories}

package/src/lib/plugins/markdown/MdxPage.tsx

@@ -90,7 +90,11 @@ export const MdxPage = ({
   }, [file]);
 
   return (
-    <div className="xl:grid grid-cols-[--sidecar-grid-cols] gap-8 justify-between">
+    <div
+      className="xl:grid grid-cols-[--sidecar-grid-cols] gap-8 justify-between"
+      data-pagefind-filter="section:markdown"
+      data-pagefind-meta="section:markdown"
+    >
       <Helmet>
         <title>{pageTitle}</title>
         {excerpt && <meta name="description" content={excerpt} />}