zudoku 0.57.0 → 0.58.0

package/src/lib/plugins/openapi/playground/result-panel/ResultPanel.tsx

@@ -1,10 +1,10 @@
-import { type UseMutationResult } from "@tanstack/react-query";
+import type { UseMutationResult } from "@tanstack/react-query";
 import { SendIcon, UnplugIcon } from "lucide-react";
 import { Spinner } from "zudoku/components";
 import { Alert, AlertDescription, AlertTitle } from "zudoku/ui/Alert.js";
 import { Button } from "../../../../ui/Button.js";
 import { cn } from "../../../../util/cn.js";
-import { type PlaygroundResult } from "../Playground.js";
+import type { PlaygroundResult } from "../Playground.js";
 import ResponseStatusBar from "./ResponseStatusBar.js";
 import { ResponseTab } from "./ResponseTab.js";
 
@@ -16,7 +16,7 @@ export const ResultPanel = ({
   isFinished,
   progress,
 }: {
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  // biome-ignore lint/suspicious/noExplicitAny: Allow any type
   queryMutation: UseMutationResult<PlaygroundResult, Error, any>;
   showLongRunningWarning?: boolean;
   onCancel?: () => void;

package/src/lib/plugins/openapi/playground/result-panel/convertToTypes.ts

@@ -17,7 +17,7 @@ function inferType(value: JsonValue): string {
   return typeof value;
 }
 
-export function generateInterface(obj: JsonObject, indentation = ""): string {
+export function generateInterface(obj: JsonObject, _indentation = ""): string {
   const lines: string[] = ["{"];
 
   for (const [key, value] of Object.entries(obj)) {

package/src/lib/plugins/openapi/processors/removeExtensions.test.ts

@@ -1,3 +1,4 @@
+// biome-ignore-all lint/suspicious/noExplicitAny: Allow any type
 import { describe, expect, it } from "vitest";
 import { removeExtensions } from "./removeExtensions.js";
 

package/src/lib/plugins/openapi/processors/removeParameters.test.ts

@@ -1,3 +1,4 @@
+// biome-ignore-all lint/suspicious/noExplicitAny: Allow any type
 import { describe, expect, it } from "vitest";
 import type { OpenAPIDocument } from "../../../oas/parser/index.js";
 import { removeParameters } from "./removeParameters.js";

package/src/lib/plugins/openapi/processors/traverse.ts

@@ -1 +1 @@
-export { traverse, type RecordAny } from "../../../util/traverse.js";
+export { type RecordAny, traverse } from "../../../util/traverse.js";

package/src/lib/plugins/openapi/schema/LogicalGroup/LogicalGroup.tsx

@@ -31,7 +31,7 @@ export const LogicalGroup = ({
 
       <Collapsible.Content className="pb-4">
         {schemas.map((subSchema, index) => (
-          // eslint-disable-next-line react/no-array-index-key
+          // biome-ignore lint/suspicious/noArrayIndexKey: Index needed for key
           <LogicalGroupItem key={index} type={type} schema={subSchema} />
         ))}
       </Collapsible.Content>

package/src/lib/plugins/openapi/util/createHttpSnippet.ts

@@ -17,7 +17,6 @@ export const createHttpSnippet = ({
     method: operation.method.toUpperCase(),
     url:
       selectedServer + operation.path.replaceAll("{", ":").replaceAll("}", ""),
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     postData: exampleBody,
     headers: [
       ...(exampleBody.text
@@ -63,7 +62,8 @@ export const createHttpSnippet = ({
 };
 
 export const getConverted = (snippet: HTTPSnippet, option: string) => {
-  let converted;
+  // biome-ignore lint/suspicious/noExplicitAny: Allow any type
+  let converted: any;
   switch (option) {
     case "shell":
       converted = snippet.convert("shell", "curl");

package/src/lib/plugins/openapi/util/createNavigationCategory.tsx

@@ -31,6 +31,7 @@ export const createNavigationCategory = ({
     to: `${path}#${operation.slug}`,
     badge: {
       label: operation.method,
+      // biome-ignore lint/style/noNonNullAssertion: is guaranteed to be defined
       color: MethodColorMap[operation.method.toLowerCase()]!,
       invert: true,
     },

package/src/lib/plugins/openapi/util/generateSchemaExample.ts

@@ -1,10 +1,10 @@
-import { type SchemaObject } from "../../../oas/graphql/index.js";
+import type { SchemaObject } from "../../../oas/graphql/index.js";
 import { isCircularRef } from "../schema/utils.js";
 
 export const generateSchemaExample = (
   schema?: SchemaObject,
   name?: string,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  // biome-ignore lint/suspicious/noExplicitAny: Allow any type
 ): any => {
   if (!schema || isCircularRef(schema)) {
     return null;
@@ -36,6 +36,7 @@ export const generateSchemaExample = (
 
   // For object schemas with properties
   if (schema.type === "object" && schema.properties) {
+    // biome-ignore lint/suspicious/noExplicitAny: Allow any type
     const example: Record<string, any> = {};
 
     for (const [key, propSchema] of Object.entries(schema.properties)) {
@@ -53,7 +54,6 @@ export const generateSchemaExample = (
         generateSchemaExample(itemSchema as SchemaObject),
       );
     }
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- OpenAPI schemas don't always adhere to spec
     if (schema.items) {
       return [generateSchemaExample(schema.items as SchemaObject)];
     }
@@ -116,7 +116,6 @@ export const generateSchemaExample = (
       return null;
     case "object":
       return {};
-    case undefined:
     default:
       return {};
   }

package/src/lib/plugins/openapi/util/getRoutes.tsx

@@ -2,8 +2,8 @@ import { useSuspenseQuery } from "@tanstack/react-query";
 import {
   generatePath,
   Navigate,
-  redirect,
   type RouteObject,
+  redirect,
   useLocation,
   useParams,
 } from "react-router";
@@ -170,7 +170,7 @@ export const getRoutes = ({
         basePath,
         routePath: basePath,
         routes: [
-          createNonTagPagesRoute({ path: basePath + "/:tag?" }),
+          createNonTagPagesRoute({ path: `${basePath}/:tag?` }),
           ...createAdditionalRoutes(basePath),
         ],
         client,

package/src/lib/plugins/openapi/util/methodColorMap.tsx

@@ -1,4 +1,4 @@
-import { type ColorMap } from "../../../components/navigation/NavigationBadge.js";
+import type { ColorMap } from "../../../components/navigation/NavigationBadge.js";
 
 export const MethodColorMap: Record<string, keyof typeof ColorMap> = {
   get: "green",

package/src/lib/plugins/search-inkeep/index.tsx

@@ -38,7 +38,7 @@ const InkeepSearch = ({
           sync: {
             target: "html",
             attributes: ["class"],
-            isDarkMode: (attrs) => attrs["class"]?.includes("dark") ?? false,
+            isDarkMode: (attrs) => attrs.class?.includes("dark") ?? false,
           },
         },
       },
@@ -57,7 +57,7 @@ const InkeepSearch = ({
     InkeepComponentInstance | undefined
   >(
     typeof window !== "undefined" && window.Inkeep?.ModalSearchAndChat
-      ? window.Inkeep.ModalSearchAndChat(config)!
+      ? window.Inkeep.ModalSearchAndChat(config)
       : undefined,
   );
 
@@ -66,7 +66,7 @@ const InkeepSearch = ({
 
     const checkInkeep = setInterval(() => {
       if (typeof window !== "undefined" && window.Inkeep?.ModalSearchAndChat) {
-        const inkeep = window.Inkeep.ModalSearchAndChat(config)!;
+        const inkeep = window.Inkeep.ModalSearchAndChat(config);
         setSearchInstance(inkeep);
         clearInterval(checkInkeep);
       }

package/src/lib/plugins/search-pagefind/PagefindSearch.tsx

@@ -63,7 +63,7 @@ const usePagefind = (options: PagefindOptions) => {
   });
 
   if (result.isError && result.error.message !== "NOT_BUILT_YET") {
-    // eslint-disable-next-line no-console
+    // biome-ignore lint/suspicious/noConsole: Logging allowed here
     console.error(result.error);
   }
 
@@ -141,9 +141,7 @@ export const PagefindSearch = ({
             <Callout type="info">
               Search is currently not available in development mode by default.
               <br />
-              To still use search in development, run <code>
-                zudoku build
-              </code>{" "}
+              To still use search in development, run <code>zudoku build</code>{" "}
               and copy the <code>dist/pagefind</code> directory to your{" "}
               <code>public</code> directory.
             </Callout>

package/src/lib/plugins/search-pagefind/ResultList.tsx

@@ -3,10 +3,7 @@ import { useLayoutEffect, useRef } from "react";
 import { Link, useNavigate } from "react-router";
 import { CommandGroup, CommandItem, CommandList } from "zudoku/ui/Command.js";
 import { joinUrl } from "../../util/joinUrl.js";
-import {
-  type PagefindSearchFragment,
-  type PagefindSubResult,
-} from "./types.js";
+import type { PagefindSearchFragment, PagefindSubResult } from "./types.js";
 
 const sortSubResults = (a: PagefindSubResult, b: PagefindSubResult) => {
   const aScore = a.weighted_locations.reduce(
@@ -38,6 +35,7 @@ export const ResultList = ({
   const navigate = useNavigate();
   const commandListRef = useRef<HTMLDivElement | null>(null);
 
+  // biome-ignore lint/correctness/useExhaustiveDependencies: Only scroll to top when search term changes
   useLayoutEffect(() => {
     requestIdleCallback(() => {
       commandListRef.current?.scrollTo({ top: 0 });
@@ -101,6 +99,7 @@ export const ResultList = ({
                       <span className="font-bold">{subResult.title}</span>
                       <span
                         className="text-[13px] [&_mark]:bg-primary [&_mark]:text-primary-foreground"
+                        // biome-ignore lint/security/noDangerouslySetInnerHtml: Pagefind provides sanitized HTML
                         dangerouslySetInnerHTML={{ __html: subResult.excerpt }}
                       />
                     </div>

package/src/lib/plugins/search-pagefind/get-results.tsx

@@ -62,7 +62,6 @@ async function* searchResultGenerator({
 
       if (transformed === false) {
         // Skip this result
-        continue;
       } else if (transformed === true || transformed == null) {
         // Keep the original result
         yield result;

package/src/lib/shiki.ts

@@ -106,14 +106,14 @@ const rehypeCodeBlockPlugin = () => (tree: Root) => {
   });
 };
 
-export const createConfiguredShikiRehypePlugins = (themes?: ThemesRecord) => [
+export const createConfiguredShikiRehypePlugins = (
+  themes: ThemesRecord = defaultHighlightOptions.themes,
+  highlighterInstance: HighlighterCore = highlighter,
+) => [
   [
     rehypeShikiFromHighlighter,
-    highlighter,
-    {
-      ...defaultHighlightOptions,
-      themes: themes ?? defaultHighlightOptions.themes,
-    },
+    highlighterInstance,
+    { ...defaultHighlightOptions, themes },
   ] satisfies Pluggable,
   rehypeCodeBlockPlugin,
 ];

package/src/lib/ui/Breadcrumb.tsx

@@ -67,6 +67,7 @@ const BreadcrumbPage = React.forwardRef<
     aria-disabled="true"
     aria-current="page"
     className={cn("font-normal text-foreground", className)}
+    tabIndex={props.tabIndex}
     {...props}
   />
 ));

package/src/lib/ui/Carousel.tsx

@@ -132,6 +132,7 @@ const Carousel = React.forwardRef<
           canScrollNext,
         }}
       >
+        {/** biome-ignore lint/a11y/useSemanticElements: shadcn uses divs for the carousel */}
         <div
           ref={ref}
           onKeyDownCapture={handleKeyDown}

package/src/lib/ui/CodeBlock.tsx

@@ -72,7 +72,9 @@ export const CodeBlock = ({
     >
       <div className="border-b flex items-center h-10 font-sans bg-black/2">
         <div className="flex items-center gap-2 flex-1 text-sm w-full px-3">
-          {iconUrl && <img src={iconUrl} className="h-3 max-w-4" />}
+          {iconUrl && (
+            <img src={iconUrl} className="h-3 max-w-4" alt={language} />
+          )}
           {title}
         </div>{" "}
         {showCopy !== "never" && (

package/src/lib/ui/Command.tsx

@@ -1,8 +1,8 @@
-import { type DialogProps } from "@radix-ui/react-dialog";
+import type { DialogProps } from "@radix-ui/react-dialog";
 import { Command as CommandPrimitive } from "cmdk";
 import { Search } from "lucide-react";
+import type { ComponentPropsWithoutRef } from "react";
 import * as React from "react";
-import { type ComponentPropsWithoutRef } from "react";
 import { Dialog, DialogContent } from "zudoku/ui/Dialog.js";
 import { cn } from "../util/cn.js";
 
@@ -58,7 +58,6 @@ const CommandInput = React.forwardRef<
   React.ElementRef<typeof CommandPrimitive.Input>,
   React.ComponentPropsWithoutRef<typeof CommandPrimitive.Input>
 >(({ className, ...props }, ref) => (
-  // eslint-disable-next-line react/no-unknown-property
   <div className="flex items-center border-b px-3" cmdk-input-wrapper="">
     <Search className="mr-2 h-4 w-4 shrink-0 opacity-50" />
     <CommandPrimitive.Input
@@ -78,7 +77,6 @@ const CommandInlineInput = React.forwardRef<
   React.ElementRef<typeof CommandPrimitive.Input>,
   React.ComponentPropsWithoutRef<typeof CommandPrimitive.Input>
 >(({ className, ...props }, ref) => (
-  // eslint-disable-next-line react/no-unknown-property
   <div className="flex items-center" cmdk-input-wrapper="">
     <CommandPrimitive.Input
       ref={ref}

package/src/lib/ui/Dialog.tsx

@@ -1,7 +1,6 @@
 import * as DialogPrimitive from "@radix-ui/react-dialog";
-import * as React from "react";
-
 import { CircleIcon, XIcon } from "lucide-react";
+import * as React from "react";
 import { cn } from "../util/cn.js";
 
 const Dialog = DialogPrimitive.Root;

package/src/lib/ui/Form.tsx

@@ -1,11 +1,11 @@
-import * as LabelPrimitive from "@radix-ui/react-label";
+import type * as LabelPrimitive from "@radix-ui/react-label";
 import { Slot } from "@radix-ui/react-slot";
 import * as React from "react";
 import {
   Controller,
-  ControllerProps,
-  FieldPath,
-  FieldValues,
+  type ControllerProps,
+  type FieldPath,
+  type FieldValues,
   FormProvider,
   useFormContext,
 } from "react-hook-form";

package/src/lib/ui/Pagination.tsx

@@ -2,11 +2,10 @@ import { ChevronLeft, ChevronRight, MoreHorizontal } from "lucide-react";
 import * as React from "react";
 
 import { cn } from "../util/cn.js";
-import { ButtonProps, buttonVariants } from "./Button.js";
+import { type ButtonProps, buttonVariants } from "./Button.js";
 
 const Pagination = ({ className, ...props }: React.ComponentProps<"nav">) => (
   <nav
-    role="navigation"
     aria-label="pagination"
     className={cn("mx-auto flex w-full justify-center", className)}
     {...props}

package/src/lib/ui/ToggleGroup.tsx

@@ -1,5 +1,5 @@
 import * as ToggleGroupPrimitive from "@radix-ui/react-toggle-group";
-import { type VariantProps } from "class-variance-authority";
+import type { VariantProps } from "class-variance-authority";
 import * as React from "react";
 
 import { cn } from "../util/cn.js";

package/src/lib/util/MdxComponents.tsx

@@ -1,4 +1,4 @@
-import { type MDXComponents } from "mdx/types.js";
+import type { MDXComponents } from "mdx/types.js";
 import { CodeBlock } from "zudoku/ui/CodeBlock.js";
 import { AnchorLink } from "../components/AnchorLink.js";
 import { Framed } from "../components/Framed.js";
@@ -16,6 +16,7 @@ export const MdxComponents = {
   img: ({ node, ...props }) => {
     if (/\.(mp4|webm|mov|avi)$/.test(props.src ?? "")) {
       return (
+        // biome-ignore lint/a11y/useMediaCaption: No in control of the caption here
         <video
           src={props.src}
           controls
@@ -26,7 +27,13 @@ export const MdxComponents = {
         />
       );
     }
-    return <img {...props} className={cn("rounded-lg", props.className)} />;
+    return (
+      <img
+        alt={props.alt}
+        {...props}
+        className={cn("rounded-lg", props.className)}
+      />
+    );
   },
   Framed,
   h1: ({ children, id }) => (

package/src/lib/util/cn.ts

@@ -1,4 +1,4 @@
-import { clsx, type ClassValue } from "clsx";
+import { type ClassValue, clsx } from "clsx";
 import { twMerge } from "tailwind-merge";
 
 export function cn(...inputs: ClassValue[]) {

package/src/lib/util/createVariantComponent.tsx

@@ -1,8 +1,8 @@
 import { Slot } from "@radix-ui/react-slot";
-import { cva } from "class-variance-authority";
+import type { cva } from "class-variance-authority";
 import type { ClassValue } from "clsx";
+import type { HTMLElementType, JSX } from "react";
 import * as React from "react";
-import { type HTMLElementType, type JSX } from "react";
 import { cn } from "./cn.js";
 
 const createVariantComponent = <

package/src/lib/util/groupBy.ts

@@ -1,3 +1,4 @@
+// biome-ignore-all lint/suspicious/noExplicitAny: Allow any type
 export const groupBy = <
   T extends Record<PropertyKey, any>,
   KeySelector extends (item: T) => PropertyKey,

package/src/lib/util/humanFileSize.ts

@@ -9,8 +9,7 @@ export const humanFileSize = (bytes = 0) => {
   }
 
   const exponent = Math.floor(Math.log(bytes) / Math.log(1000.0));
-  const decimal = (bytes / Math.pow(1000.0, exponent)).toFixed(
-    exponent ? 2 : 0,
-  );
+  const decimal = (bytes / 1000.0 ** exponent).toFixed(exponent ? 2 : 0);
+
   return `${decimal} ${exponent ? `${"kMGTPEZY"[exponent - 1]}B` : "B"}`;
 };

package/src/lib/util/invariant.ts

@@ -1,4 +1,5 @@
 export default function invariant(
+  // biome-ignore lint/suspicious/noExplicitAny: Allow any type
   condition: any,
   // Not providing an inline default argument for message as the result is smaller
   /**

package/src/lib/util/pastellize.ts

@@ -1,8 +1,8 @@
 const c2n = (c: string) =>
   Math.abs(
-    isNaN(parseInt(c))
+    Number.isNaN(parseInt(c))
       ? c.toLowerCase().charCodeAt(0) - 96
-      : isNaN(parseInt(c))
+      : Number.isNaN(parseInt(c))
         ? 0
         : parseInt(c),
   );

package/src/lib/util/types.ts

@@ -1,4 +1,4 @@
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
+// biome-ignore lint/suspicious/noExplicitAny: Allow any type
 export type RecordAny = Record<string, any>;
 
 export type JsonPrimitive = string | number | boolean | null;

package/src/lib/util/useIsomorphicLayoutEffect.ts

@@ -1,4 +1,5 @@
 import { useEffect, useLayoutEffect } from "react";
+
 const useIsomorphicLayoutEffect =
   typeof window !== "undefined" ? useLayoutEffect : useEffect;
 

package/src/lib/util/useScrollToAnchor.ts

@@ -13,7 +13,9 @@ export const useScrollToHash = () => {
 
       // Operation list items might have subdivisions that the navigation doesn't show.
       // The subdivisions are separated by a slash so we need to remove everything before the slash to get the navigation correct item.
-      const linkHash = cleanHash.split("/").at(0)!;
+      const linkHash = cleanHash.split("/").at(0);
+      if (!linkHash) return false;
+
       const element = document.getElementById(decodeURIComponent(cleanHash));
 
       const link = document.querySelector(

package/src/shiki/langs/vue-vine.js

@@ -0,0 +1 @@
+export { default } from "@shikijs/langs/vue-vine";

package/dist/lib/components/ReactMarkdown.d.ts

@@ -1,29 +0,0 @@
-import type { Element, Parents } from "hast";
-import { Components as JsxRuntimeComponents } from "hast-util-to-jsx-runtime";
-import { ReactElement } from "react";
-import { Options as RemarkRehypeOptions } from "remark-rehype";
-import { PluggableList } from "unified";
-interface AllowElement {
-    (element: Readonly<Element>, index: number, parent: Readonly<Parents> | undefined): boolean | null | undefined;
-}
-interface UrlTransform {
-    (url: string, key: string, node: Readonly<Element>): string | null | undefined;
-}
-interface Components extends Partial<JsxRuntimeComponents> {
-}
-interface Options {
-    allowElement?: AllowElement | null;
-    allowedElements?: ReadonlyArray<string> | null;
-    children?: string | null;
-    className?: string | null;
-    components?: Components | null;
-    disallowedElements?: ReadonlyArray<string> | null;
-    rehypePlugins?: PluggableList | null;
-    remarkPlugins?: PluggableList | null;
-    remarkRehypeOptions?: Readonly<RemarkRehypeOptions> | null;
-    skipHtml?: boolean | null;
-    unwrapDisallowed?: boolean | null;
-    urlTransform?: UrlTransform | null;
-}
-export declare function ReactMarkdown(options: Readonly<Options>): ReactElement;
-export {};