zudoku 0.75.0 → 0.75.1

package/dist/cli/cli.js

@@ -3813,7 +3813,7 @@ import {
 // package.json
 var package_default = {
   name: "zudoku",
-  version: "0.74.3",
+  version: "0.75.0",
   type: "module",
   sideEffects: [
     "**/*.css",
@@ -3891,6 +3891,7 @@ var package_default = {
   },
   dependencies: {
     "@apidevtools/json-schema-ref-parser": "15.3.1",
+    "@base-ui/react": "^1.4.0",
     "@envelop/core": "5.5.1",
     "@graphql-typed-document-node/core": "3.2.0",
     "@hono/node-server": "1.19.13",
@@ -3958,7 +3959,7 @@ var package_default = {
     "hast-util-heading-rank": "3.0.0",
     "hast-util-to-jsx-runtime": "2.3.6",
     "hast-util-to-string": "3.0.1",
-    hono: "4.12.12",
+    hono: "4.12.14",
     "http-terminator": "3.2.0",
     "javascript-stringify": "2.1.0",
     "json-schema-to-typescript-lite": "15.0.0",
@@ -3973,7 +3974,7 @@ var package_default = {
     "next-themes": "0.4.6",
     oauth4webapi: "3.8.5",
     "openapi-types": "12.1.3",
-    pagefind: "1.5.0-beta.1",
+    pagefind: "1.5.2",
     picocolors: "1.1.1",
     piscina: "5.1.4",
     "posthog-node": "5.26.0",
@@ -4010,9 +4011,9 @@ var package_default = {
     zustand: "5.0.12"
   },
   devDependencies: {
-    "@clerk/clerk-js": "^6.0.0",
-    "@graphql-codegen/cli": "6.1.2",
-    "@inkeep/cxkit-types": "0.5.116",
+    "@clerk/clerk-js": "^6.7.4",
+    "@graphql-codegen/cli": "6.3.0",
+    "@inkeep/cxkit-types": "0.5.117",
     "@testing-library/dom": "catalog:",
     "@testing-library/jest-dom": "catalog:",
     "@testing-library/react": "catalog:",
@@ -4030,7 +4031,7 @@ var package_default = {
     "@types/yargs": "17.0.35",
     "@vitest/coverage-v8": "4.0.18",
     "happy-dom": "catalog:",
-    "oxc-parser": "^0.119.0",
+    "oxc-parser": "^0.126.0",
     react: "catalog:",
     "react-dom": "catalog:",
     tsx: "4.21.0",
@@ -4730,6 +4731,9 @@ var handleCircularRefs = (obj, currentPath = /* @__PURE__ */ new WeakSet(), refs
   const result = Array.isArray(obj) ? obj.map((item, i) => recurse(item, i.toString())) : Object.fromEntries(
     Object.entries(obj).map(([k, v]) => [k, recurse(v, k)])
   );
+  if (!Array.isArray(result) && typeof refPath === "string" && !("__$ref" in result)) {
+    result.__$ref = refPath;
+  }
   refs.set(obj, result);
   currentPath.delete(obj);
   if (typeof refPath === "string") currentRefPaths.delete(refPath);
@@ -6224,15 +6228,37 @@ var viteApiPlugin = async () => {
         );
         const apis = ensureArray(config2.apis);
         const apiMetadata = [];
+        const httpMethods = /* @__PURE__ */ new Set([
+          "get",
+          "post",
+          "put",
+          "patch",
+          "delete",
+          "options",
+          "head",
+          "trace"
+        ]);
         for (const apiConfig of apis) {
           if (apiConfig.type === "file" && apiConfig.path) {
             const latestSchema = schemaManager.getLatestSchema(apiConfig.path);
             if (!latestSchema?.schema.info) continue;
+            const operationCount = Object.values(
+              latestSchema.schema.paths ?? {}
+            ).reduce((sum, pathItem) => {
+              if (!pathItem || typeof pathItem !== "object") return sum;
+              return sum + Object.keys(pathItem).filter(
+                (m) => httpMethods.has(m.toLowerCase())
+              ).length;
+            }, 0);
+            const rawVersion = latestSchema.schema.info.version;
+            const version = rawVersion ? rawVersion.startsWith("v") || rawVersion.startsWith("V") ? rawVersion : `v${rawVersion}` : void 0;
             apiMetadata.push({
               path: apiConfig.path,
               label: latestSchema.schema.info.title,
               description: latestSchema.schema.info.description ?? "",
-              categories: apiConfig.categories ?? []
+              categories: apiConfig.categories ?? [],
+              version,
+              operationCount
             });
           }
         }
@@ -8232,7 +8258,7 @@ var runPrerender = async (options) => {
       await writeFile5(indexHtml, html, "utf-8");
     }
     const statusPages = workerResults.flatMap(
-      (r) => /400|404|500\.html$/.test(r.outputPath) ? r.outputPath : []
+      (r) => /^(400|404|500)\.html$/.test(path22.basename(r.outputPath)) ? r.outputPath : []
     );
     for (const statusPage of statusPages) {
       await rename(

package/dist/declarations/lib/authentication/providers/openid.d.ts

@@ -43,6 +43,7 @@ export declare class OpenIDAuthenticationProvider extends CoreAuthenticationPlug
         replace?: boolean;
     }): Promise<void>;
     signIn(_: AuthActionContext, { redirectTo, replace }: AuthActionOptions): Promise<void>;
+    private buildUserProfile;
     refreshUserProfile(): Promise<boolean>;
     private authorize;
     getAccessToken(): Promise<string>;

package/dist/declarations/lib/authentication/state.d.ts

@@ -39,11 +39,16 @@ export declare const useAuthState: import("zustand").UseBoundStore<Omit<import("
         getOptions: () => Partial<import("zustand/middleware").PersistOptions<AuthState, unknown, unknown>>;
     };
 }>;
+export type CustomClaim = string | number | boolean | null | CustomClaimRecord | CustomClaimArray | undefined;
+export interface CustomClaimRecord {
+    [key: string]: CustomClaim;
+}
+export type CustomClaimArray = CustomClaim[];
 export interface UserProfile {
     sub: string;
     email: string | undefined;
     emailVerified: boolean;
     name: string | undefined;
     pictureUrl: string | undefined;
-    [key: string]: string | boolean | undefined;
+    [key: string]: CustomClaim;
 }

package/dist/declarations/lib/plugins/api-catalog/Catalog.d.ts

@@ -1,4 +1,2 @@
-import { type ApiCatalogPluginOptions } from "./index.js";
-export declare const Catalog: ({ items, filterCatalogItems, label, categoryLabel, }: Omit<ApiCatalogPluginOptions, "path"> & {
-    categoryLabel?: string;
-}) => import("react/jsx-runtime").JSX.Element;
+import type { ApiCatalogPluginOptions } from "./index.js";
+export declare const Catalog: ({ items, filterCatalogItems, label, }: Omit<ApiCatalogPluginOptions, "path">) => import("react/jsx-runtime").JSX.Element;

package/dist/declarations/lib/plugins/api-catalog/index.d.ts

@@ -1,11 +1,12 @@
 import type { AuthState } from "../../authentication/state.js";
 import type { ZudokuPlugin } from "../../core/plugins.js";
-export declare const getKey: (category: string, tag: string) => string;
 export type ApiCatalogItem = {
     path: string;
     label: string;
     description: string;
     categories: CatalogCategory[];
+    version?: string;
+    operationCount?: number;
 };
 export type CatalogCategory = {
     label: string;
@@ -22,10 +23,4 @@ export type CatalogContext = {
     auth: AuthState;
 };
 export type FilterCatalogItemsFn = (items: ApiCatalogItem[], { auth }: CatalogContext) => ApiCatalogItem[];
-export declare const apiCatalogPlugin: ({ path, items, label, categories, filterCatalogItems, }: {
-    path: string;
-    label: string;
-    categories?: CatalogCategory[];
-    items: ApiCatalogItem[];
-    filterCatalogItems?: FilterCatalogItemsFn;
-}) => ZudokuPlugin;
+export declare const apiCatalogPlugin: ({ path, items, label, categories, filterCatalogItems, }: ApiCatalogPluginOptions) => ZudokuPlugin;

package/dist/declarations/lib/plugins/openapi/schema/SchemaRefLink.d.ts

@@ -0,0 +1,5 @@
+export declare const SchemaRefLink: ({ name, suffix, className, }: {
+    name: string;
+    suffix?: string;
+    className?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/declarations/lib/plugins/openapi/schema/SchemaView.d.ts

@@ -1,7 +1,8 @@
 import type { SchemaObject } from "../../../oas/parser/index.js";
-export declare const SchemaView: ({ schema, defaultOpen, cardHeader, embedded, }: {
+export declare const SchemaView: ({ schema, defaultOpen, cardHeader, embedded, hideRootRef, }: {
     schema?: SchemaObject | null;
     defaultOpen?: boolean;
     cardHeader?: React.ReactNode;
     embedded?: boolean;
+    hideRootRef?: boolean;
 }) => import("react/jsx-runtime").JSX.Element | undefined;

package/dist/declarations/lib/plugins/openapi/schema/utils.d.ts

@@ -6,4 +6,5 @@ export declare const isCircularRef: (schema: unknown) => schema is string;
 export declare const isArrayCircularRef: (schema: SchemaObject) => schema is SchemaObject & {
     items: SchemaObject;
 };
+export declare const getSchemaRefName: (schema?: SchemaObject | null) => string | undefined;
 export declare const extractCircularRefInfo: (ref?: string | SchemaObject) => string | undefined;

package/dist/declarations/lib/ui/HoverCard.d.ts

@@ -1,6 +1,6 @@
 import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
-import * as React from "react";
-declare const HoverCard: React.FC<HoverCardPrimitive.HoverCardProps>;
-declare const HoverCardTrigger: React.ForwardRefExoticComponent<HoverCardPrimitive.HoverCardTriggerProps & React.RefAttributes<HTMLAnchorElement>>;
-declare const HoverCardContent: React.ForwardRefExoticComponent<Omit<HoverCardPrimitive.HoverCardContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export { HoverCard, HoverCardContent, HoverCardTrigger };
+import type * as React from "react";
+declare function HoverCard({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+declare function HoverCardTrigger({ ...props }: React.ComponentProps<typeof HoverCardPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
+declare function HoverCardContent({ className, align, sideOffset, ...props }: React.ComponentProps<typeof HoverCardPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+export { HoverCard, HoverCardTrigger, HoverCardContent };

package/dist/declarations/lib/ui/Toggle.d.ts

@@ -1,12 +1,8 @@
-import * as TogglePrimitive from "@radix-ui/react-toggle";
+import { Toggle as TogglePrimitive } from "@base-ui/react/toggle";
 import { type VariantProps } from "class-variance-authority";
-import * as React from "react";
 declare const toggleVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
-declare const Toggle: React.ForwardRefExoticComponent<Omit<TogglePrimitive.ToggleProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
-    variant?: "default" | "outline" | null | undefined;
-    size?: "default" | "sm" | "lg" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string> & React.RefAttributes<HTMLButtonElement>>;
+declare function Toggle({ className, variant, size, ...props }: TogglePrimitive.Props & VariantProps<typeof toggleVariants>): import("react/jsx-runtime").JSX.Element;
 export { Toggle, toggleVariants };

package/dist/declarations/lib/ui/ToggleGroup.d.ts

@@ -1,12 +1,10 @@
-import * as ToggleGroupPrimitive from "@radix-ui/react-toggle-group";
+import { ToggleGroup as ToggleGroupPrimitive } from "@base-ui/react/toggle-group";
 import type { VariantProps } from "class-variance-authority";
 import * as React from "react";
-declare const ToggleGroup: React.ForwardRefExoticComponent<((Omit<ToggleGroupPrimitive.ToggleGroupSingleProps & React.RefAttributes<HTMLDivElement>, "ref"> | Omit<ToggleGroupPrimitive.ToggleGroupMultipleProps & React.RefAttributes<HTMLDivElement>, "ref">) & VariantProps<(props?: ({
-    variant?: "default" | "outline" | null | undefined;
-    size?: "default" | "sm" | "lg" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string>) & React.RefAttributes<HTMLDivElement>>;
-declare const ToggleGroupItem: React.ForwardRefExoticComponent<Omit<ToggleGroupPrimitive.ToggleGroupItemProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
-    variant?: "default" | "outline" | null | undefined;
-    size?: "default" | "sm" | "lg" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string> & React.RefAttributes<HTMLButtonElement>>;
+import { Toggle, toggleVariants } from "./Toggle.js";
+declare function ToggleGroup({ className, variant, size, spacing, orientation, children, ...props }: ToggleGroupPrimitive.Props & VariantProps<typeof toggleVariants> & {
+    spacing?: number;
+    orientation?: "horizontal" | "vertical";
+}): import("react/jsx-runtime").JSX.Element;
+declare function ToggleGroupItem({ className, children, variant, size, ...props }: React.ComponentProps<typeof Toggle>): import("react/jsx-runtime").JSX.Element;
 export { ToggleGroup, ToggleGroupItem };

package/docs/deploy/github-pages.md

@@ -30,6 +30,18 @@ const config: ZudokuConfig = {
 };
 ```
 
+When `basePath` is set, Zudoku writes the site into `dist/<basePath>/`. Upload that nested directory
+as your Pages artifact, not `dist/` itself. For example in a GitHub Actions workflow:
+
+```yaml
+- uses: actions/upload-pages-artifact@v3
+  with:
+    path: dist/your-repo
+```
+
+Uploading the outer `dist/` would nest the site under `/your-repo/your-repo/` and every asset
+would 404.
+
 ## Accurate Last Modified Dates
 
 If you have enabled the [`showLastModified`](/docs/configuration/docs#showlastmodified) option,

package/docs/guides/redirects.md

@@ -0,0 +1,186 @@
+---
+title: Redirects
+sidebar_icon: arrow-right-left
+description:
+  Configure URL redirects in your Zudoku developer portal to set landing pages, maintain backward
+  compatibility, and handle URL changes. Covers redirect behavior, basePath interaction, and
+  troubleshooting.
+---
+
+Redirects let you automatically send visitors from one URL to another in your developer portal. They
+are useful when you need to:
+
+- Set a custom landing page for the root path (`/`)
+- Maintain backward compatibility after restructuring documentation
+- Point old API endpoint paths to their new locations
+- Redirect from deprecated pages to their replacements
+
+## Basic configuration
+
+Add a `redirects` array to your `zudoku.config.ts` file. Each entry has a `from` path and a `to`
+path:
+
+```ts title="zudoku.config.ts"
+import type { ZudokuConfig } from "zudoku";
+
+const config: ZudokuConfig = {
+  // ... other config
+  redirects: [
+    { from: "/", to: "/introduction" },
+    { from: "/getting-started", to: "/quickstart" },
+  ],
+};
+
+export default config;
+```
+
+When a visitor navigates to the `from` path, they are automatically redirected to the `to` path.
+
+## Redirect properties
+
+Each redirect object accepts two properties:
+
+- **`from`** — The path you want to redirect away from. An absolute path starting with `/` is
+  recommended. If you omit the leading slash, it is normalized automatically.
+- **`to`** — The destination path where visitors will be sent. This can be any valid path in your
+  portal.
+
+```ts
+redirects: [{ from: "/old-page", to: "/new-page" }];
+```
+
+Trailing slashes in the `from` path are normalized automatically. Both `/old-page` and `/old-page/`
+will match the same redirect rule.
+
+## How redirects work
+
+Zudoku redirects operate at two levels depending on how the visitor reaches the page:
+
+### Server-side behavior
+
+When a visitor loads a redirect path directly (for example, by typing the URL in the browser address
+bar or following an external link), the exact response depends on your deployment target:
+
+- **Zuplo** and **Vercel** (or any platform that reads the Vercel Build Output API): the platform
+  returns an HTTP **301 (Moved Permanently)** with a `Location` header, so browsers and search
+  engines see a true permanent redirect.
+- **SSR deployments**: the server returns a real HTTP 301 from the router loader.
+- **Other static hosts** (Netlify, Cloudflare Pages, GitHub Pages, S3, nginx, etc.): Zudoku
+  prerenders each redirect source path as a small HTML file containing a JavaScript redirect. The
+  file is served with a 200 response and the browser follows the redirect once the script runs.
+  JavaScript must be enabled for the redirect to fire.
+
+### Client-side behavior
+
+When a visitor clicks an internal link that points to a redirect path, Zudoku handles the redirect
+entirely in the browser using client-side routing. The visitor is navigated to the destination
+without a full page reload, providing a seamless experience.
+
+Both behaviors land the visitor on the destination page. For search engines, only the 301 variants
+signal a permanent move; the JavaScript redirect used on generic static hosts is weaker for SEO.
+
+## Common patterns
+
+### Setting a landing page
+
+The most common use of redirects is setting a landing page for the root path of your portal:
+
+```ts
+redirects: [{ from: "/", to: "/docs/introduction" }];
+```
+
+This sends visitors who arrive at your portal's root URL to your introduction page.
+
+### Reorganizing documentation
+
+When you restructure your documentation, add redirects from the old paths so existing bookmarks and
+external links continue to work:
+
+```ts
+redirects: [
+  { from: "/api/authentication", to: "/guides/auth-overview" },
+  { from: "/api/getting-started", to: "/docs/quickstart" },
+  { from: "/reference", to: "/api" },
+];
+```
+
+### Redirecting to specific sections
+
+You can redirect to a specific section of a page using a hash fragment in the `to` path:
+
+```ts
+redirects: [
+  {
+    from: "/api-shipments/create-shipment",
+    to: "/api-shipments/shipment-management#post-shipments",
+  },
+  {
+    from: "/api-shipments/get-rates",
+    to: "/api-shipments/rates-and-billing#post-shipments-shipmentid-rates",
+  },
+];
+```
+
+This is useful when multiple old pages have been consolidated into a single page with distinct
+sections.
+
+### Redirecting category paths
+
+If your API reference groups endpoints into categories, you may want the category path to redirect
+to a specific endpoint or overview page:
+
+```ts
+redirects: [
+  { from: "/api/billing", to: "/api/billing/get-invoices" },
+  { from: "/api/users", to: "/api/users/list-users" },
+];
+```
+
+## Redirects and the `basePath` option
+
+If your portal uses a [`basePath`](/docs/configuration/overview#basepath), redirects are defined
+_relative to the base path_. Zudoku automatically prepends the base path to both the matched `from`
+and the emitted `Location`.
+
+For example, with `basePath: "/docs"`:
+
+```ts
+redirects: [{ from: "/", to: "/getting-started" }];
+// Visitors to /docs/ are redirected to /docs/getting-started
+```
+
+You do not need to include the base path in your `from` or `to` values.
+
+## Redirects vs. navigation rules
+
+Zudoku offers two features that can change where visitors end up: [redirects](#basic-configuration)
+and [navigation rules](/docs/guides/navigation-rules). They serve different purposes:
+
+- **Redirects** map one URL to another. Use them when a page has moved or when you need a specific
+  URL to point somewhere else. They affect both direct visits and internal link clicks.
+- **Navigation rules** customize the _sidebar_ generated by plugins like the OpenAPI plugin. Use
+  them to insert, reorder, modify, or remove items in the sidebar without changing the underlying
+  page URLs.
+
+If you want to change where a URL takes visitors, use a redirect. If you want to change what appears
+in the sidebar navigation, use a navigation rule.
+
+## Redirects and sitemaps
+
+Redirect source paths are automatically excluded from your
+[sitemap](/docs/configuration/overview#sitemap). Only the destination pages appear in the generated
+`sitemap.xml`, which prevents search engines from indexing the old URLs.
+
+## Troubleshooting
+
+### Redirect returns a 404
+
+Make sure the `to` path points to a page that actually exists in your portal. If the destination is
+an API reference page generated from an OpenAPI spec, verify that the path matches the generated
+route. You can check available routes by running your dev server and navigating manually.
+
+### Redirect conflicts with another route
+
+Redirects are registered before page routes, so when a redirect `from` path exactly matches another
+route, the redirect wins. If you want a page to be reachable at a given path, remove the conflicting
+redirect rather than relying on route priority.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zudoku",
-  "version": "0.75.0",
+  "version": "0.75.1",
   "type": "module",
   "sideEffects": [
     "**/*.css",
@@ -145,6 +145,7 @@
   },
   "dependencies": {
     "@apidevtools/json-schema-ref-parser": "15.3.1",
+    "@base-ui/react": "^1.4.0",
     "@envelop/core": "5.5.1",
     "@graphql-typed-document-node/core": "3.2.0",
     "@hono/node-server": "1.19.13",
@@ -212,7 +213,7 @@
     "hast-util-heading-rank": "3.0.0",
     "hast-util-to-jsx-runtime": "2.3.6",
     "hast-util-to-string": "3.0.1",
-    "hono": "4.12.12",
+    "hono": "4.12.14",
     "http-terminator": "3.2.0",
     "javascript-stringify": "2.1.0",
     "json-schema-to-typescript-lite": "15.0.0",
@@ -227,7 +228,7 @@
     "next-themes": "0.4.6",
     "oauth4webapi": "3.8.5",
     "openapi-types": "12.1.3",
-    "pagefind": "1.5.0-beta.1",
+    "pagefind": "1.5.2",
     "picocolors": "1.1.1",
     "piscina": "5.1.4",
     "posthog-node": "5.26.0",
@@ -264,9 +265,9 @@
     "zustand": "5.0.12"
   },
   "devDependencies": {
-    "@clerk/clerk-js": "^6.0.0",
-    "@graphql-codegen/cli": "6.1.2",
-    "@inkeep/cxkit-types": "0.5.116",
+    "@clerk/clerk-js": "^6.7.4",
+    "@graphql-codegen/cli": "6.3.0",
+    "@inkeep/cxkit-types": "0.5.117",
     "@testing-library/dom": "10.4.1",
     "@testing-library/jest-dom": "6.9.1",
     "@testing-library/react": "16.3.2",
@@ -284,7 +285,7 @@
     "@types/yargs": "17.0.35",
     "@vitest/coverage-v8": "4.0.18",
     "happy-dom": "20.8.9",
-    "oxc-parser": "^0.119.0",
+    "oxc-parser": "^0.126.0",
     "react": "19.2.4",
     "react-dom": "19.2.4",
     "tsx": "4.21.0",

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

@@ -183,6 +183,22 @@ export class OpenIDAuthenticationProvider
     });
   }
 
+  private buildUserProfile(
+    userInfo: oauth.UserInfoResponse,
+    fallbackEmailVerified: oauth.JsonValue | undefined,
+  ): UserProfile {
+    const emailVerified =
+      userInfo.email_verified ?? fallbackEmailVerified ?? false;
+    return {
+      ...userInfo,
+      sub: userInfo.sub,
+      email: userInfo.email,
+      name: userInfo.name,
+      emailVerified: Boolean(emailVerified),
+      pictureUrl: userInfo.picture,
+    };
+  }
+
   public async refreshUserProfile(): Promise<boolean> {
     const accessToken = await this.getAccessToken();
     const authServer = await this.getAuthServer();
@@ -200,13 +216,7 @@ export class OpenIDAuthenticationProvider
         ? providerData.claims?.email_verified
         : undefined;
 
-    const profile: UserProfile = {
-      sub: userInfo.sub,
-      email: userInfo.email,
-      name: userInfo.name,
-      emailVerified: userInfo.email_verified ?? emailVerified ?? false,
-      pictureUrl: userInfo.picture,
-    };
+    const profile = this.buildUserProfile(userInfo, emailVerified);
 
     useAuthState.setState({
       isAuthenticated: true,
@@ -494,14 +504,7 @@ export class OpenIDAuthenticationProvider
     );
     const userInfo = await userInfoResponse.json();
 
-    const profile: UserProfile = {
-      ...userInfo,
-      sub: userInfo.sub,
-      email: userInfo.email,
-      name: userInfo.name,
-      emailVerified: userInfo.email_verified ?? claims?.email_verified ?? false,
-      pictureUrl: userInfo.picture,
-    };
+    const profile = this.buildUserProfile(userInfo, claims?.email_verified);
 
     useAuthState.setState({
       isAuthenticated: true,

package/src/lib/authentication/state.ts

@@ -81,11 +81,24 @@ syncZustandState(authState);
 
 export const useAuthState = authState;
 
+export type CustomClaim =
+  | string
+  | number
+  | boolean
+  | null
+  | CustomClaimRecord
+  | CustomClaimArray
+  | undefined;
+export interface CustomClaimRecord {
+  [key: string]: CustomClaim;
+}
+export type CustomClaimArray = CustomClaim[];
+
 export interface UserProfile {
   sub: string;
   email: string | undefined;
   emailVerified: boolean;
   name: string | undefined;
   pictureUrl: string | undefined;
-  [key: string]: string | boolean | undefined;
+  [key: string]: CustomClaim;
 }

package/src/lib/components/Meta.tsx

@@ -25,7 +25,16 @@ export const Meta = ({ children }: PropsWithChildren) => {
         {meta?.description && (
           <meta name="description" content={meta.description} />
         )}
-        {meta?.favicon && <link rel="icon" href={meta.favicon} />}
+        {meta?.favicon && (
+          <link
+            rel="icon"
+            href={
+              /^https?:\/\//.test(meta.favicon)
+                ? meta.favicon
+                : joinUrl(options.basePath, meta.favicon)
+            }
+          />
+        )}
         {meta?.generator && <meta name="generator" content={meta.generator} />}
         {meta?.applicationName && (
           <meta name="application-name" content={meta.applicationName} />

package/src/lib/hooks/useHotkey.ts

@@ -35,7 +35,17 @@ export const useHotkey = (hotkey: string, callback: () => void) => {
   }, [callback]);
 
   useEffect(() => {
+    const hasModifier = meta || shift || alt || ctrl;
     const handler = (event: KeyboardEvent) => {
+      if (
+        !hasModifier &&
+        event.target instanceof HTMLElement &&
+        (event.target.tagName === "INPUT" ||
+          event.target.tagName === "TEXTAREA" ||
+          event.target.isContentEditable)
+      ) {
+        return;
+      }
       if (
         (event.code === `Key${key?.toUpperCase()}` ||
           event.code.toLowerCase() === key?.toLowerCase()) &&

package/src/lib/oas/graphql/circular.ts

@@ -53,6 +53,17 @@ export const handleCircularRefs = (
         Object.entries(obj).map(([k, v]) => [k, recurse(v, k)]),
       );
 
+  // __$ref is defined non-enumerable at build-time codegen (schema-codegen.ts)
+  // to keep it out of snapshots and deep equality. Copy it enumerably onto
+  // the serialized result so the client receives it.
+  if (
+    !Array.isArray(result) &&
+    typeof refPath === "string" &&
+    !("__$ref" in result)
+  ) {
+    (result as Record<string, unknown>).__$ref = refPath;
+  }
+
   refs.set(obj, result);
   currentPath.delete(obj);
   if (typeof refPath === "string") currentRefPaths.delete(refPath);