jamdesk 1.1.89 → 1.1.91

package/vendored/components/mdx/MDXComponents.tsx

@@ -1,4 +1,15 @@
-import { isValidElement, type ReactNode } from 'react';
+import {
+  isValidElement,
+  type AnchorHTMLAttributes,
+  type BlockquoteHTMLAttributes,
+  type HTMLAttributes,
+  type ImgHTMLAttributes,
+  type OlHTMLAttributes,
+  type ReactNode,
+  type TableHTMLAttributes,
+  type TdHTMLAttributes,
+  type ThHTMLAttributes,
+} from 'react';
 import { Card } from './Card';
 import { Note, Info, Warning, Tip, Check, Danger, Callout } from './Callouts';
 import { Accordion, AccordionGroup } from './Accordion';
@@ -41,14 +52,20 @@ import { Visibility } from './Visibility';
  * 2. language-* class on code element (standard markdown)
  * 3. language-* class on pre element (fallback for edge cases)
  */
-function getCodeLanguage(preProps: any, children: ReactNode): string {
+type PreLikeProps = {
+  'data-language'?: string;
+  className?: string;
+};
+type CodeLikeProps = { className?: string };
+
+function getCodeLanguage(preProps: PreLikeProps, children: ReactNode): string {
   // Check data-language on pre element (added by Shiki transformer)
   if (preProps['data-language']) {
     return preProps['data-language'];
   }
   // Check code element's className for language-* class
   if (isValidElement(children)) {
-    const codeProps = children.props as any;
+    const codeProps = children.props as CodeLikeProps;
     const className = codeProps?.className || '';
     const match = className.match(/language-(\w+)/);
     if (match) return match[1];
@@ -70,7 +87,7 @@ function extractTextFromChildren(children: ReactNode): string {
   if (!children) return '';
 
   if (isValidElement(children)) {
-    const props = children.props as any;
+    const props = children.props as { children?: ReactNode };
     return extractTextFromChildren(props?.children);
   }
 
@@ -239,9 +256,9 @@ export const MDXComponents = {
   // Sized images from preprocess-mdx (![alt](url =WIDTHx) syntax).
   // These are output as <SizedImage> JSX so they go through component mapping
   // (raw <img> JSX in MDX bypasses the components provider).
-  SizedImage: ({ src, alt, width, height, className, ...rest }: any) => (
+  SizedImage: ({ src, alt, width, height, className, ..._rest }: Omit<ImgHTMLAttributes<HTMLImageElement>, 'src'> & { src?: string }) => (
     <ZoomableImage
-      src={src}
+      src={src ?? ''}
       alt={alt || ''}
       width={width}
       height={height}
@@ -269,11 +286,20 @@ export const MDXComponents = {
     noStyle, // Explicitly destructure to prevent React warning about unknown DOM prop
     nostyle, // Also handle lowercase version from HTML parsing
     // Destructure and ignore any other props to prevent them from being passed to DOM
-    ...rest
-  }: any) => {
+    ..._rest
+  }: Omit<ImgHTMLAttributes<HTMLImageElement>, 'src'> & {
+    src?: string;
+    class?: string;
+    'data-no-zoom'?: string | boolean;
+    'data-no-style'?: string | boolean;
+    noZoom?: string | boolean;
+    nozoom?: string | boolean;
+    noStyle?: string | boolean;
+    nostyle?: string | boolean;
+  }) => {
     // Check if this is a video file — render <Video> instead of <ZoomableImage>
     if (isVideoUrl(src)) {
-      return <Video src={src} title={alt || undefined} />;
+      return <Video src={src ?? ''} title={alt || undefined} />;
     }
 
     // Check for data-no-zoom attribute or noZoom prop (handle both camelCase and lowercase)
@@ -295,7 +321,7 @@ export const MDXComponents = {
 
     return (
       <ZoomableImage
-        src={src}
+        src={src ?? ''}
         alt={alt || ''}
         width={width}
         height={height}
@@ -308,64 +334,64 @@ export const MDXComponents = {
       />
     );
   },
-  h1: (props: any) => (
-    <h1 
-      className="text-3xl font-bold text-theme-text-primary mt-8 mb-4 tracking-tight" 
-      {...props} 
+  h1: (props: HTMLAttributes<HTMLHeadingElement>) => (
+    <h1
+      className="text-3xl font-bold text-theme-text-primary mt-8 mb-4 tracking-tight"
+      {...props}
     />
   ),
-  h2: (props: any) => (
-    <h2 
-      className="text-2xl font-semibold text-theme-text-primary mt-10 mb-4 tracking-tight scroll-mt-20" 
-      {...props} 
+  h2: (props: HTMLAttributes<HTMLHeadingElement>) => (
+    <h2
+      className="text-2xl font-semibold text-theme-text-primary mt-10 mb-4 tracking-tight scroll-mt-20"
+      {...props}
     />
   ),
-  h3: (props: any) => (
-    <h3 
-      className="text-xl font-semibold text-theme-text-primary mt-8 mb-3 scroll-mt-20" 
-      {...props} 
+  h3: (props: HTMLAttributes<HTMLHeadingElement>) => (
+    <h3
+      className="text-xl font-semibold text-theme-text-primary mt-8 mb-3 scroll-mt-20"
+      {...props}
     />
   ),
-  h4: (props: any) => (
-    <h4 
-      className="text-lg font-semibold text-theme-text-primary mt-6 mb-2 scroll-mt-20" 
-      {...props} 
+  h4: (props: HTMLAttributes<HTMLHeadingElement>) => (
+    <h4
+      className="text-lg font-semibold text-theme-text-primary mt-6 mb-2 scroll-mt-20"
+      {...props}
     />
   ),
-  p: (props: any) => (
-    <p 
-      className="text-theme-text-secondary leading-7 mb-4" 
-      {...props} 
+  p: (props: HTMLAttributes<HTMLParagraphElement>) => (
+    <p
+      className="text-theme-text-secondary leading-7 mb-4"
+      {...props}
     />
   ),
-  ul: ({ class: htmlClass, className, ...props }: any) => (
-    <ul 
-      className={`list-disc list-inside text-theme-text-secondary space-y-2 mb-4 ml-4 ${htmlClass || ''} ${className || ''}`.trim()} 
-      {...props} 
+  ul: ({ class: htmlClass, className, ...props }: HTMLAttributes<HTMLUListElement> & { class?: string }) => (
+    <ul
+      className={`list-disc list-inside text-theme-text-secondary space-y-2 mb-4 ml-4 ${htmlClass || ''} ${className || ''}`.trim()}
+      {...props}
     />
   ),
-  ol: ({ class: htmlClass, className, ...props }: any) => (
-    <ol 
-      className={`list-decimal list-inside text-theme-text-secondary space-y-2 mb-4 ml-4 ${htmlClass || ''} ${className || ''}`.trim()} 
-      {...props} 
+  ol: ({ class: htmlClass, className, ...props }: OlHTMLAttributes<HTMLOListElement> & { class?: string }) => (
+    <ol
+      className={`list-decimal list-inside text-theme-text-secondary space-y-2 mb-4 ml-4 ${htmlClass || ''} ${className || ''}`.trim()}
+      {...props}
     />
   ),
-  li: (props: any) => (
-    <li 
-      className="text-theme-text-secondary marker:text-theme-marker" 
-      {...props} 
+  li: (props: HTMLAttributes<HTMLLIElement>) => (
+    <li
+      className="text-theme-text-secondary marker:text-theme-marker"
+      {...props}
     />
   ),
   // NOTE: page.tsx overrides this for hostAtDocs sites to auto-prefix links.
   // If you change styling here, update the override in app/[[...slug]]/page.tsx too.
-  a: ({ ariaLabel, ...props }: any) => (
+  a: ({ ariaLabel, ...props }: AnchorHTMLAttributes<HTMLAnchorElement> & { ariaLabel?: string }) => (
     <a
       className="text-theme-accent hover:text-theme-accent-hover transition-colors"
       aria-label={ariaLabel}
       {...props}
     />
   ),
-  blockquote: (props: any) => (
+  blockquote: (props: BlockquoteHTMLAttributes<HTMLQuoteElement>) => (
     <blockquote
       className="border-l-4 pl-4 text-theme-text-tertiary my-6 not-italic"
       style={{ borderColor: 'var(--color-border)' }}
@@ -373,7 +399,7 @@ export const MDXComponents = {
     />
   ),
   // Custom pre component to wrap code blocks with titles in CodePanel
-  pre: ({ children, 'data-title': dataTitle, ...props }: any) => {
+  pre: ({ children, 'data-title': dataTitle, ...props }: HTMLAttributes<HTMLPreElement> & { 'data-title'?: string }) => {
     const language = getCodeLanguage(props, children);
 
     // Check for mermaid diagrams - render with Mermaid component
@@ -411,41 +437,41 @@ export const MDXComponents = {
     );
   },
   // Inline code styling is done via CSS in base.css (.prose :not(pre) > code)
-  table: (props: any) => (
+  table: (props: TableHTMLAttributes<HTMLTableElement>) => (
     <div className="overflow-x-auto my-6">
-      <table 
-        className="w-full text-sm border-collapse" 
-        {...props} 
+      <table
+        className="w-full text-sm border-collapse"
+        {...props}
       />
     </div>
   ),
-  th: (props: any) => (
-    <th 
-      className="text-left font-semibold text-theme-text-primary p-3 border-b-2 border-theme-border bg-theme-bg-secondary" 
-      {...props} 
+  th: (props: ThHTMLAttributes<HTMLTableHeaderCellElement>) => (
+    <th
+      className="text-left font-semibold text-theme-text-primary p-3 border-b-2 border-theme-border bg-theme-bg-secondary"
+      {...props}
     />
   ),
-  td: (props: any) => (
-    <td 
-      className="p-3 border-b border-theme-border text-theme-text-secondary" 
-      {...props} 
+  td: (props: TdHTMLAttributes<HTMLTableDataCellElement>) => (
+    <td
+      className="p-3 border-b border-theme-border text-theme-text-secondary"
+      {...props}
     />
   ),
-  hr: (props: any) => (
-    <hr 
-      className="border-theme-border my-8" 
-      {...props} 
+  hr: (props: HTMLAttributes<HTMLHRElement>) => (
+    <hr
+      className="border-theme-border my-8"
+      {...props}
     />
   ),
   // Generic div handler to convert class to className
-  div: ({ class: htmlClass, className, ...props }: any) => (
-    <div 
-      className={`${htmlClass || ''} ${className || ''}`.trim() || undefined} 
-      {...props} 
+  div: ({ class: htmlClass, className, ...props }: HTMLAttributes<HTMLDivElement> & { class?: string }) => (
+    <div
+      className={`${htmlClass || ''} ${className || ''}`.trim() || undefined}
+      {...props}
     />
   ),
   // Generic span handler to convert class to className
-  span: ({ class: htmlClass, className, ...props }: any) => (
+  span: ({ class: htmlClass, className, ...props }: HTMLAttributes<HTMLSpanElement> & { class?: string }) => (
     <span
       className={`${htmlClass || ''} ${className || ''}`.trim() || undefined}
       {...props}

package/vendored/components/mdx/OpenApiEndpoint.tsx

@@ -77,7 +77,6 @@ function renderSchemaType(schema: JsonSchema): string {
 // Shiki HTML comes from server-side highlighting of trusted code strings;
 // sanitization is unnecessary and would break the syntax-color spans.
 function renderHighlightedHtml(html: string) {
-  // eslint-disable-next-line react/no-danger
   return <div dangerouslySetInnerHTML={{ __html: html }} />;
 }
 

package/vendored/components/mdx/ParamField.tsx

@@ -30,7 +30,6 @@ export function ParamField({
 }: ParamFieldProps) {
   // Determine the parameter name from the prop
   const paramName = body || header || query || path || '';
-  const location = body ? 'body' : header ? 'header' : query ? 'query' : path ? 'path' : '';
 
   return (
     <div className="group param-divider py-2.5 first:pt-0 not-prose">

package/vendored/components/mdx/RequestExample.tsx

@@ -3,7 +3,6 @@
 import { ReactNode, Children, isValidElement } from 'react';
 import { CodePanel, CodePanelTab } from '../ui/CodePanel';
 import { formatLanguage, getElementProps } from '@/lib/code-utils';
-import { getLanguageIcon } from '@/lib/language-icons';
 
 interface RequestExampleProps {
   children: ReactNode;

package/vendored/components/mdx/ResponseExample.tsx

@@ -3,7 +3,6 @@
 import { ReactNode, Children, isValidElement } from 'react';
 import { CodePanel, CodePanelTab } from '../ui/CodePanel';
 import { getElementProps } from '@/lib/code-utils';
-import { getLanguageIcon } from '@/lib/language-icons';
 
 interface ResponseExampleProps {
   children: ReactNode;

package/vendored/components/mdx/Steps.tsx

@@ -1,6 +1,14 @@
 'use client';
 
-import { ReactNode, Children, Fragment, cloneElement, isValidElement, memo } from 'react';
+import {
+  ReactNode,
+  Children,
+  Fragment,
+  cloneElement,
+  isValidElement,
+  memo,
+  type ReactElement,
+} from 'react';
 import { getIconClass } from '@/lib/icon-utils';
 import { useStepSlug } from './StepSlugContext';
 
@@ -56,10 +64,11 @@ export const Steps = memo(function Steps({ children, titleSize = 'p' }: StepsPro
     <div className="relative my-8 space-y-0 not-prose">
       {childrenArray.map((child) => {
         if (isStepComponent(child)) {
-          const childProps = (child as any).props as StepProps;
+          const stepEl = child as ReactElement<StepProps>;
+          const childProps = stepEl.props;
           const currentStepIndex = stepIndex;
           stepIndex++;
-          return cloneElement(child as any, {
+          return cloneElement(stepEl, {
             ...childProps,
             stepNumber: childProps.stepNumber ?? currentStepIndex + 1,
             isLast: currentStepIndex === totalSteps - 1,

package/vendored/components/mdx/Table.tsx

@@ -170,7 +170,10 @@ export function Table({
           <tbody>
             {sortedBodyRows.map((row, index) => {
               if (isValidElement(row)) {
-                return cloneElement(row, { key: row.key ?? index, _rowIndex: index } as any);
+                return cloneElement(
+                  row as React.ReactElement<InternalRowProps>,
+                  { key: row.key ?? index, _rowIndex: index }
+                );
               }
               return row;
             })}
@@ -223,7 +226,10 @@ export function Row({
     <tr className={classes.join(' ')}>
       {Children.map(children, (child, index) => {
         if (isValidElement(child)) {
-          return cloneElement(child, { _isHeaderRow: header, _columnIndex: index } as any);
+          return cloneElement(
+            child as React.ReactElement<InternalCellProps>,
+            { _isHeaderRow: header, _columnIndex: index }
+          );
         }
         return child;
       })}

package/vendored/components/mdx/Tabs.tsx

@@ -34,7 +34,7 @@ interface TabProps {
  * Tab component - represents a single tab panel
  * Must be used inside a Tabs component
  */
-export const Tab = memo(function Tab({ title, icon, iconType, children }: TabProps) {
+export const Tab = memo(function Tab({ title: _title, icon: _icon, iconType: _iconType, children }: TabProps) {
   // This component is rendered by Tabs, not directly
   // The props are extracted by Tabs to build the tab bar
   return <>{children}</>;

package/vendored/components/mdx/Tree.tsx

@@ -10,8 +10,6 @@ import {
   useMemo,
   useId,
   ReactNode,
-  Children,
-  isValidElement,
 } from 'react';
 
 // =============================================================================
@@ -158,7 +156,11 @@ function TreeRoot({ children }: TreeProps) {
 
     traverse(null);
     return items;
-  }, [expandedIds, itemsRef.current.size]); // eslint-disable-line react-hooks/exhaustive-deps
+    // itemsRef.current.size is intentional — refs don't trigger re-renders, but
+    // size changes correlate with register/unregister so this is the best
+    // available recompute signal without lifting items into state.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [expandedIds, itemsRef.current.size]);
 
   // Initialize expanded state from defaultOpen props
   useEffect(() => {
@@ -174,7 +176,7 @@ function TreeRoot({ children }: TreeProps) {
       }
       setInitialized(true);
     }
-  }, [initialized, itemsRef.current.size]); // eslint-disable-line react-hooks/exhaustive-deps
+  }, [initialized, itemsRef.current.size]);
 
   // Type-ahead search handler
   const handleTypeAhead = useCallback(

package/vendored/components/navigation/Header.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useState, useEffect, useMemo, useRef } from 'react';
+import { useState, useEffect, useMemo, useRef, useCallback } from 'react';
 import { useOnClickOutside } from '@/hooks/useOnClickOutside';
 import Link from 'next/link';
 import { usePathname } from 'next/navigation';
@@ -95,8 +95,10 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
     return resolveNavigation(config, pathname);
   }, [config, pathname, hasTabs, layout, hasMultipleLanguages]);
 
-  // Simple check if current path belongs to a tab (without full navigation resolution)
-  const pathBelongsToTab = (tab: typeof navigationTabs[0], currentPath: string): boolean => {
+  // Simple check if current path belongs to a tab (without full navigation resolution).
+  // Pure over its arguments — wrapped in useCallback so it's stable for the
+  // tab list useMemo below.
+  const pathBelongsToTab = useCallback((tab: typeof navigationTabs[0], currentPath: string): boolean => {
     const path = currentPath.replace(/^\/docs\/?/, '');
 
     // Check tab's groups
@@ -124,7 +126,7 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
     }
 
     return false;
-  };
+  }, []);
 
   // Build tabs data for header
   const headerTabs = useMemo(() => {
@@ -175,7 +177,7 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
         isExternal: false,
       };
     });
-  }, [navigationTabs, resolved, hasTabs, pathname, linkPrefix]);
+  }, [navigationTabs, resolved, hasTabs, pathname, linkPrefix, pathBelongsToTab]);
 
   // Detect dark mode for logo switching
   useEffect(() => {

package/vendored/components/navigation/LanguageSelector.tsx

@@ -11,6 +11,7 @@ import {
   saveLanguagePreference,
   getLanguagePreference,
   extractLanguageFromPath,
+  toHreflang,
 } from '@/lib/language-utils';
 import { useLinkPrefix } from '@/lib/link-prefix-context';
 import { getUiStrings } from '@/lib/ui-strings';
@@ -51,13 +52,36 @@ export function LanguageSelector({
   const isNavigating = pendingPathname !== null;
   const showSpinner = spinnerPathname !== null;
 
+  // Dedupe entries that collapse onto the same BCP 47 tag (e.g. customer
+  // declared both `cn` and `zh-Hans`, which would render two identical
+  // "简体中文" rows). Prefer the entry whose code already IS the BCP 47 form;
+  // fall back to the first occurrence. The server-side warning in
+  // buildHreflangAlternates is the authoritative signal — this is the UX
+  // safety net so users don't see duplicate rows in the meantime.
+  const displayedLanguages = (() => {
+    const byTag = new Map<string, ResolvedLanguage>();
+    for (const lang of languages) {
+      const tag = toHreflang(lang.code);
+      const existing = byTag.get(tag);
+      if (!existing) {
+        byTag.set(tag, lang);
+        continue;
+      }
+      if (existing.code !== tag && lang.code === tag) byTag.set(tag, lang);
+    }
+    return [...byTag.values()];
+  })();
+
   // Find current language
-  const currentLanguage = languages.find((l) => l.isActive) || languages[0];
+  const currentLanguage = displayedLanguages.find((l) => l.isActive) || displayedLanguages[0];
 
   // Find actual default language from config
-  const actualDefault = languages.find((l) => l.isDefault)?.code || defaultLanguage;
+  const actualDefault = displayedLanguages.find((l) => l.isDefault)?.code || defaultLanguage;
 
-  // Check localStorage preference on mount and redirect if needed
+  // Check localStorage preference on mount and redirect if needed.
+  // Intentionally mount-only: re-running on pathname/language changes would
+  // fight the user's in-session navigation choices (they may have explicitly
+  // switched languages this session, which we don't want to revert).
   useEffect(() => {
     const savedPref = getLanguagePreference();
     if (savedPref && currentLanguage && savedPref !== currentLanguage.code) {
@@ -68,18 +92,20 @@ export function LanguageSelector({
       if (!hasLangInPath) {
         const basePath = transformLanguagePath(
           pathname || '/docs',
-          actualDefault,
           savedPref,
           actualDefault
         );
         router.replace(`${linkPrefix}${basePath}`);
       }
     }
-  }, []); // Only run once on mount
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- mount-only by design; see comment above the effect
+  }, []);
 
   // Handle click outside to close
   useOnClickOutside(containerRef, () => setIsOpen(false), isOpen);
 
+  // Defined before handleKeyDown so handleKeyDown can include it in its
+  // dependency array without TDZ issues.
   const handleSelectLanguage = useCallback(
     (lang: ResolvedLanguage) => {
       // Block double-fire while a previous switch is still navigating —
@@ -95,7 +121,6 @@ export function LanguageSelector({
 
       const basePath = transformLanguagePath(
         pathname || '/docs',
-        currentLanguage?.code || actualDefault,
         lang.code,
         actualDefault
       );
@@ -228,7 +253,7 @@ export function LanguageSelector({
           `}
           style={{ boxShadow: 'var(--shadow-lg)' }}
         >
-          {languages.map((lang, index) => (
+          {displayedLanguages.map((lang, index) => (
             <li key={lang.code}>
               <button
                 role="option"

package/vendored/components/navigation/TableOfContents.tsx

@@ -494,7 +494,7 @@ export function TableOfContents({ content, className = '' }: TableOfContentsProp
     return () => {
       scrollTarget.removeEventListener('scroll', computeActive);
     };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+
   }, [headings, isHidden]);
 
   if (headings.length === 0 || isHidden) {

package/vendored/components/navigation/TabsNav.tsx

@@ -4,7 +4,12 @@ import { useMemo } from 'react';
 import Link from 'next/link';
 import { usePathname } from 'next/navigation';
 // Icons use Font Awesome CSS classes for lightweight rendering
-import type { DocsConfig, TabsPosition } from '@/lib/docs-types';
+import type {
+  DocsConfig,
+  GroupConfig,
+  NavigationPage,
+  TabsPosition,
+} from '@/lib/docs-types';
 import { resolveNavigation } from '@/lib/navigation-resolver';
 import { getIconClass } from '@/lib/icon-utils';
 import { getTheme } from '@/themes';
@@ -87,14 +92,21 @@ export function TabsNav({ config, className = '' }: TabsNavProps) {
       const currentPath = pathname.replace(/^\/docs\/?/, '').replace(/^\//, '');
       let isActive = false;
       
-      const checkPages = (pages: any[]): boolean => {
+      const checkPages = (pages: (NavigationPage | GroupConfig)[]): boolean => {
         for (const page of pages) {
-          const pagePath = typeof page === 'string' ? page : page.page || page.group;
-          if (pagePath === currentPath || currentPath.startsWith(pagePath + '/')) {
+          const pagePath =
+            typeof page === 'string'
+              ? page
+              : 'page' in page
+                ? page.page
+                : 'group' in page
+                  ? page.group
+                  : undefined;
+          if (pagePath && (pagePath === currentPath || currentPath.startsWith(pagePath + '/'))) {
             return true;
           }
           // Check nested groups
-          if (page.pages) {
+          if (typeof page !== 'string' && 'pages' in page && page.pages) {
             if (checkPages(page.pages)) return true;
           }
         }