jamdesk 1.1.90 → 1.1.91

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;
           }
         }

package/vendored/components/search/SearchModal.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useEffect, useState, useRef, type ReactElement } from 'react';
+import { useEffect, useState, useRef, useCallback, type ReactElement } from 'react';
 import { usePathname, useRouter } from 'next/navigation';
 import { getRecentSearches, addRecentSearch, clearRecentSearches } from '@/lib/recent-searches';
 import { useFocusTrap } from '@/hooks/useFocusTrap';
@@ -237,6 +237,45 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
     el?.scrollIntoView({ block: 'nearest' });
   }, [selectedIndex, results.length]);
 
+  // Click handler for a result row. Defined before the keyboard-navigation
+  // effect so it can be a stable dep without TDZ issues.
+  const handleResultClick = useCallback(
+    (result: SearchResult, index: number) => {
+      if (query.trim()) {
+        // Track search_query event (the search itself)
+        trackSearch(projectSlug, {
+          type: 'search_query',
+          query: query.trim(),
+          resultsCount: results.length,
+        });
+
+        // Track search_click event (the result they clicked)
+        trackSearch(projectSlug, {
+          type: 'search_click',
+          query: query.trim(),
+          resultsCount: results.length,
+          clickedResult: {
+            slug: result.slug,
+            position: index + 1, // 1-indexed for analytics
+            title: result.title,
+          },
+        });
+        hasTrackedRef.current = true; // Mark as tracked to avoid duplicate on modal close
+
+        // Save to recent searches
+        addRecentSearch(projectSlug, query.trim());
+      }
+
+      const url = `${linkPrefix}/${result.slug}${result.section ? `#${result.section.toLowerCase().replace(/\s+/g, '-')}` : ''}`;
+      onNavigate?.(url);
+      router.push(url);
+      onClose();
+      setQuery('');
+      setResults([]);
+    },
+    [query, projectSlug, results, linkPrefix, onNavigate, router, onClose]
+  );
+
   // Keyboard navigation
   useEffect(() => {
     if (!isOpen) return;
@@ -297,41 +336,7 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
 
     document.addEventListener('keydown', handleKeyDown);
     return () => document.removeEventListener('keydown', handleKeyDown);
-  }, [isOpen, query, recentSearches, results, selectedIndex, effectivePopularPages, popularIndex, router, onClose, onNavigate, projectSlug]);
-
-  const handleResultClick = (result: SearchResult, index: number) => {
-    if (query.trim()) {
-      // Track search_query event (the search itself)
-      trackSearch(projectSlug, {
-        type: 'search_query',
-        query: query.trim(),
-        resultsCount: results.length,
-      });
-
-      // Track search_click event (the result they clicked)
-      trackSearch(projectSlug, {
-        type: 'search_click',
-        query: query.trim(),
-        resultsCount: results.length,
-        clickedResult: {
-          slug: result.slug,
-          position: index + 1, // 1-indexed for analytics
-          title: result.title,
-        },
-      });
-      hasTrackedRef.current = true; // Mark as tracked to avoid duplicate on modal close
-
-      // Save to recent searches
-      addRecentSearch(projectSlug, query.trim());
-    }
-
-    const url = `${linkPrefix}/${result.slug}${result.section ? `#${result.section.toLowerCase().replace(/\s+/g, '-')}` : ''}`;
-    onNavigate?.(url);
-    router.push(url);
-    onClose();
-    setQuery('');
-    setResults([]);
-  };
+  }, [isOpen, query, recentSearches, results, selectedIndex, effectivePopularPages, popularIndex, router, onClose, onNavigate, projectSlug, handleResultClick, isSearching, linkPrefix]);
 
   const handleClearRecentSearches = () => {
     clearRecentSearches(projectSlug);

package/vendored/components/ui/CodePanel.tsx

@@ -83,12 +83,12 @@ export function extractTextContent(node: ReactNode): string {
   if (!node) return '';
 
   if (isValidElement(node)) {
-    const props = node.props as any;
+    const props = node.props as { children?: ReactNode };
     // If it's a pre element, get the code element's children
     if (node.type === 'pre') {
       const codeElement = props?.children;
       if (isValidElement(codeElement)) {
-        const codeProps = codeElement.props as any;
+        const codeProps = codeElement.props as { children?: ReactNode };
         return extractTextContent(codeProps?.children);
       }
     }

package/vendored/hooks/useChat.ts

@@ -105,7 +105,7 @@ export function useChat(endpoint = '/_chat'): {
   useEffect(() => {
     const lastUser = messagesRef.current.filter(m => m.role === 'user').at(-1);
     if (lastUser) lastUserMessageRef.current = lastUser.content;
-    // eslint-disable-next-line react-hooks/exhaustive-deps
+
   }, []);
 
   /** Unlock the input: the request is done (or errored out). The assistant

package/vendored/hooks/useShikiHighlight.ts

@@ -57,6 +57,11 @@ export function useShikiHighlightMultiple(
   );
   const [isLoading, setIsLoading] = useState(true);
 
+  // Serialize items for the effect dep array. Using a stable string key
+  // avoids re-running the highlighter on every parent render that produces
+  // a new (but value-equal) `items` array.
+  const itemsKey = JSON.stringify(items);
+
   useEffect(() => {
     let cancelled = false;
 
@@ -85,7 +90,8 @@ export function useShikiHighlightMultiple(
     return () => {
       cancelled = true;
     };
-  }, [JSON.stringify(items)]);
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- itemsKey is the stable serialization of items; using items directly would re-fire on every parent render
+  }, [itemsKey]);
 
   return { results, isLoading };
 }

package/vendored/lib/code-utils.ts

@@ -34,9 +34,13 @@ export function formatLanguage(lang: string): string {
 }
 
 /**
- * Helper for accessing React element props
- * Uses `any` to allow property access without type guards
+ * Helper for accessing React element props.
+ * Many MDX call sites read .className/.children with string ops without
+ * narrowing first; widening the value type to `unknown` would force a
+ * type-narrow at every site. Keep `any` here only.
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- MDX consumer call sites do unchecked string ops on prop values; narrowing here would require touching dozens of components
 export function getElementProps(element: ReactElement): Record<string, any> {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- see function-level comment
   return (element.props || {}) as Record<string, any>;
 }

package/vendored/lib/health-checks.ts

@@ -45,7 +45,7 @@ export async function checkMemoryHealth(): Promise<MemoryHealth> {
       percentUsed: stats.peakPercentage !== null ? Math.round(stats.peakPercentage) : null,
       available,
     };
-  } catch (error) {
+  } catch {
     return {
       status: 'critical',
       heapUsedMB: 0,
@@ -119,7 +119,7 @@ export async function checkDiskHealth(path: string): Promise<DiskHealth> {
       percentUsed,
       available: isUnlimited ? `${available} (tmpfs)` : available,
     };
-  } catch (error) {
+  } catch {
     return {
       status: 'critical',
       path,

package/vendored/lib/language-utils.ts

@@ -199,6 +199,59 @@ export const LANGUAGE_FLAGS: Record<LanguageCode, string> = {
   he: '🇮🇱',
 };
 
+/**
+ * Maps internal LanguageCode values to valid IETF BCP 47 tags for use in
+ * `<link rel="alternate" hreflang>` and `<html lang>` attributes.
+ *
+ * Why: Customer projects use directory-aligned codes like `cn/`, `jp/` that
+ * are first-class LanguageCode values for internal routing, but `cn` and `jp`
+ * are not valid BCP 47 language tags. Google silently drops alternates with
+ * invalid tags, so the Chinese (or `jp`-named Japanese) page gets no hreflang
+ * benefit. Remap at emit time to keep file layouts stable.
+ *
+ * One-way map only — never add the canonical form (e.g. `'zh-Hans': 'cn'`)
+ * as a key; downstream callers assume the output is BCP 47-valid.
+ */
+const HREFLANG_REMAP: Partial<Record<LanguageCode, string>> = {
+  cn: 'zh-Hans',    // not a BCP 47 tag; Chinese Simplified is zh-Hans
+  jp: 'ja',         // not a BCP 47 tag; Japanese is ja
+  'ja-jp': 'ja-JP', // lowercase region subtag is not valid BCP 47
+  'fr-ca': 'fr-CA', // lowercase region subtag is not valid BCP 47
+};
+
+/**
+ * Convert an internal LanguageCode to a valid BCP 47 tag for SEO emission.
+ * Codes not in HREFLANG_REMAP pass through unchanged.
+ */
+export function toHreflang(code: LanguageCode): string {
+  return HREFLANG_REMAP[code] ?? code;
+}
+
+/**
+ * Detect customer-config errors where two distinct LanguageCode entries
+ * collapse to the same BCP 47 tag after toHreflang — e.g. declaring both
+ * `cn` and `zh-Hans`, or both `ja` and `jp`. When this happens, the
+ * second entry silently overwrites the first in the hreflang alternates
+ * map, dropping a translation from search-engine discovery.
+ *
+ * Returns one entry per colliding tag, listing the internal codes that
+ * collapsed onto it. Empty array means no collision.
+ */
+export function findHreflangAliasCollisions(
+  codes: LanguageCode[]
+): Array<{ tag: string; codes: LanguageCode[] }> {
+  const byTag = new Map<string, LanguageCode[]>();
+  for (const code of codes) {
+    const tag = toHreflang(code);
+    const existing = byTag.get(tag);
+    if (existing) existing.push(code);
+    else byTag.set(tag, [code]);
+  }
+  return [...byTag.entries()]
+    .filter(([, group]) => group.length > 1)
+    .map(([tag, group]) => ({ tag, codes: group }));
+}
+
 /**
  * RTL (Right-to-Left) languages
  */
@@ -246,14 +299,12 @@ export function getLanguageDisplayInfo(code: LanguageCode): LanguageDisplayInfo
  * - transformPath('/docs/introduction', 'en', 'es') → '/es/introduction' (strips /docs prefix)
  *
  * @param currentPath - Current pathname
- * @param fromLang - Current language code (or 'en' for default)
  * @param toLang - Target language code
  * @param defaultLang - The default language (typically 'en')
  * @returns Transformed path for the target language (relative to app root)
  */
 export function transformLanguagePath(
   currentPath: string,
-  fromLang: LanguageCode,
   toLang: LanguageCode,
   defaultLang: LanguageCode = 'en'
 ): string {

package/vendored/lib/layout-helpers.tsx

@@ -26,6 +26,7 @@ import { LinkPrefixProvider } from '@/lib/link-prefix-context';
 import { ProjectSlugProvider } from '@/lib/project-slug-context';
 import { getAnalyticsScript } from '@/lib/analytics-script';
 import { fetchCustomCss, fetchCustomJs } from '@/lib/r2-content';
+import { toHreflang } from '@/lib/language-utils';
 
 const scrollLockBootstrap = `
 (function() {
@@ -314,7 +315,7 @@ export async function DocsChrome({
   preload('/_jd/fonts/fontawesome/webfonts/fa-brands-400.woff2', { as: 'font', type: 'font/woff2', crossOrigin: 'anonymous' });
 
   return (
-    <html lang={lang} dir={dir} suppressHydrationWarning data-scroll-behavior="smooth" data-scroll-locked="true">
+    <html lang={toHreflang(lang)} dir={dir} suppressHydrationWarning data-scroll-behavior="smooth" data-scroll-locked="true">
       <head>
         {/*
           SSR scroll lock — prevents Chrome's same-tab cross-origin "preserve

package/vendored/lib/mdx-inline-components.ts

@@ -121,7 +121,7 @@ export function compileInlineComponents(
       // IMPORTANT: React hooks are intentionally NOT provided here. Inline components
       // are server-rendered during Next.js static export, and hooks only work client-side.
       // Users who need hooks should use snippet files with 'use client' directive instead.
-      // eslint-disable-next-line @typescript-eslint/no-implied-eval
+
       const createComponent = new Function(
         'React',
         '_jsx',

package/vendored/lib/navigation-resolver.ts

@@ -9,11 +9,9 @@
 
 import type {
   DocsConfig,
-  NavigationConfig,
   NavigationPage,
   NavigationPageObject,
   GroupConfig,
-  AnchorConfig,
   TabConfig,
   LanguageCode,
   LanguageConfig,
@@ -228,50 +226,6 @@ function resolveGroup(group: GroupConfig): ResolvedGroup {
   };
 }
 
-/**
- * Resolve an anchor configuration
- */
-function resolveAnchor(anchor: AnchorConfig): ResolvedAnchor {
-  const groups: ResolvedGroup[] = [];
-  
-  // If anchor has groups, resolve them
-  if (anchor.groups) {
-    for (const group of anchor.groups) {
-      groups.push(resolveGroup(group));
-    }
-  }
-  
-  // If anchor has pages directly, create a default group
-  if (anchor.pages && anchor.pages.length > 0) {
-    const { resolvedPages, nestedGroups, items } = resolvePages(anchor.pages);
-    if (resolvedPages.length > 0 || nestedGroups.length > 0) {
-      groups.push({
-        name: '', // No group name for direct pages
-        pages: resolvedPages,
-        nested: nestedGroups.length > 0 ? nestedGroups : undefined,
-        items: items.length > 0 ? items : undefined,
-      });
-    }
-  }
-  
-  // If anchor has tabs, we need to resolve those too
-  // For now, we flatten tabs into groups
-  if (anchor.tabs) {
-    for (const tab of anchor.tabs) {
-      const tabGroups = resolveTabGroups(tab);
-      groups.push(...tabGroups);
-    }
-  }
-  
-  return {
-    name: anchor.anchor,
-    icon: getIconName(anchor.icon),
-    href: anchor.href,
-    isExternal: !!anchor.href && !anchor.groups && !anchor.pages && !anchor.tabs,
-    groups,
-  };
-}
-
 /**
  * Resolve groups from a tab configuration
  */
@@ -311,29 +265,6 @@ function resolveTab(tab: TabConfig): ResolvedTab {
   };
 }
 
-/**
- * Find active anchor based on pathname
- */
-function findActiveAnchor(anchors: ResolvedAnchor[], pathname: string): string | undefined {
-  // Remove /docs prefix and leading slash to match page paths (stored without leading slash)
-  const path = pathname.replace(/^\/docs\/?/, '').replace(/^\//, '');
-  
-  // Find anchor whose groups contain a page matching the path
-  for (const anchor of anchors) {
-    if (anchor.isExternal) continue;
-    
-    for (const group of anchor.groups) {
-      if (groupContainsPath(group, path)) {
-        return anchor.name;
-      }
-    }
-  }
-  
-  // Default to first non-external anchor
-  const firstAnchor = anchors.find(a => !a.isExternal);
-  return firstAnchor?.name;
-}
-
 /**
  * Find active tab based on pathname
  */

package/vendored/lib/normalize-config.ts

@@ -84,7 +84,7 @@ export function normalizeConfig(config: DocsConfigInput): NormalizeResult {
   }
 
   // 4. Warn about navbar.style
-  if ((rest.navbar as any)?.style) {
+  if ((rest.navbar as { style?: unknown } | undefined)?.style) {
     warnings.push(
       'navbar.style is ignored. All navbars use the default style.'
     );

package/vendored/lib/openapi/generator.ts

@@ -5,8 +5,8 @@
  * Supports generating pages from navigation openapi field.
  */
 
-import type { OpenAPI, OpenAPIV3 } from 'openapi-types';
-import type { GeneratedPage, HttpMethod, OpenApiEndpointData } from './types';
+import type { OpenAPIV3 } from 'openapi-types';
+import type { GeneratedPage, OpenApiEndpointData } from './types';
 import { parseEndpoint, getAllEndpoints, getSpecInfo } from './parser';
 import { getCachedSpec } from './cache';
 
@@ -94,7 +94,7 @@ export async function generatePagesFromSpec(
   
   for (const { method, path, operation, tags } of endpoints) {
     // Skip hidden endpoints (x-hidden extension)
-    if ((operation as any)['x-hidden']) {
+    if ((operation as { 'x-hidden'?: unknown })['x-hidden']) {
       continue;
     }
     

package/vendored/lib/openapi/parser.ts

@@ -193,8 +193,9 @@ function parseServers(api: OpenAPI.Document): ServerInfo[] {
   
   // Swagger 2.0
   if ('host' in api && typeof api.host === 'string') {
-    const scheme = (api as any).schemes?.[0] || 'https';
-    const basePath = (api as any).basePath || '';
+    const swagger2 = api as { schemes?: string[]; basePath?: string };
+    const scheme = swagger2.schemes?.[0] || 'https';
+    const basePath = swagger2.basePath || '';
     return [{
       url: `${scheme}://${api.host}${basePath}`,
     }];
@@ -229,9 +230,16 @@ function parseSecuritySchemes(api: OpenAPI.Document): Map<string, SecurityRequir
 
   // Swagger 2.0
   if ('securityDefinitions' in api) {
-    const defs = (api as any).securityDefinitions;
+    type Swagger2SecurityScheme = {
+      type: SecurityRequirement['type'];
+      scheme?: string;
+      in?: SecurityRequirement['in'];
+      name?: string;
+    };
+    const defs = (api as { securityDefinitions?: Record<string, Swagger2SecurityScheme> })
+      .securityDefinitions;
     for (const [name, scheme] of Object.entries(defs || {})) {
-      const s = scheme as any;
+      const s = scheme as Swagger2SecurityScheme;
       schemes.set(name, {
         name,
         type: s.type,
@@ -319,7 +327,7 @@ function parseRequestBody(
     content[mediaType] = {
       schema: toJsonSchema(mediaObj.schema),
       example: mediaObj.example,
-      examples: mediaObj.examples as any,
+      examples: mediaObj.examples as Record<string, { value: unknown; summary?: string }> | undefined,
     };
   }
   
@@ -346,7 +354,7 @@ function parseResponses(
       content[mediaType] = {
         schema: toJsonSchema(mediaObj.schema),
         example: mediaObj.example,
-        examples: mediaObj.examples as any,
+        examples: mediaObj.examples as Record<string, { value: unknown; summary?: string }> | undefined,
       };
     }
     

package/vendored/lib/openapi/validator.ts

@@ -41,12 +41,12 @@ function checkDuplicateOperationIds(
   specPath: string
 ): OpenApiValidationError | null {
   const seen = new Map<string, string>(); // operationId → "METHOD /path"
-  const paths = (api as any).paths || {};
+  const paths = (api as { paths?: Record<string, unknown> }).paths || {};
   const methods = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
 
   for (const [pathStr, pathItem] of Object.entries(paths)) {
     for (const method of methods) {
-      const operation = (pathItem as Record<string, any>)?.[method];
+      const operation = (pathItem as Record<string, { operationId?: string } | undefined> | undefined)?.[method];
       if (!operation?.operationId) continue;
 
       const id = operation.operationId;

package/vendored/lib/openapi-isr.ts

@@ -69,7 +69,10 @@ export async function fetchOpenApiSpecFromR2(
   const isYaml = /\.ya?ml$/i.test(specPath);
   const raw = isYaml ? yaml.load(content) : JSON.parse(content);
 
-  // Dereference all $ref pointers (matching static mode's SwaggerParser.validate behavior)
+  // Dereference all $ref pointers (matching static mode's SwaggerParser.validate behavior).
+  // SwaggerParser.dereference accepts a loose Document type that does not line up with
+  // our internal OpenApiSpec; intermediate `any` cast is required at this library boundary.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- SwaggerParser type interop (see CLAUDE.md memory)
   const spec = await SwaggerParser.dereference(raw as any) as unknown as OpenApiSpec;
 
   // Cache it