jamdesk 1.1.1 → 1.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",

package/vendored/app/api/og/route.tsx

@@ -49,8 +49,10 @@ export async function GET(request: NextRequest) {
   // (Satori doesn't support webp and can fail on remote URLs)
   let logo = '';
   if (logoUrl) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3000);
     try {
-      const res = await fetch(logoUrl);
+      const res = await fetch(logoUrl, { signal: controller.signal });
       if (res.ok) {
         const contentType = res.headers.get('content-type') || 'image/png';
         const buf = await res.arrayBuffer();
@@ -58,6 +60,8 @@ export async function GET(request: NextRequest) {
       }
     } catch {
       // Skip logo on fetch failure
+    } finally {
+      clearTimeout(timeout);
     }
   }
 

package/vendored/components/AIActionsMenu.tsx

@@ -1,6 +1,7 @@
 'use client';
 
 import { useState, useEffect, useRef, useCallback, useMemo } from 'react';
+import { useOnClickOutside } from '@/hooks/useOnClickOutside';
 import { usePathname } from 'next/navigation';
 import { useLinkPrefix } from '@/lib/link-prefix-context';
 import { getIconClass } from '@/lib/icon-utils';
@@ -317,16 +318,7 @@ export function AIActionsMenu({ options, projectName }: AIActionsMenuProps) {
   }, []);
 
   // Close on click outside
-  useEffect(() => {
-    if (!isOpen) return;
-    function handleMouseDown(e: MouseEvent) {
-      if (menuRef.current && !menuRef.current.contains(e.target as Node)) {
-        setIsOpen(false);
-      }
-    }
-    document.addEventListener('mousedown', handleMouseDown);
-    return () => document.removeEventListener('mousedown', handleMouseDown);
-  }, [isOpen]);
+  useOnClickOutside(menuRef, () => setIsOpen(false), isOpen);
 
   // Close on Escape
   useEffect(() => {

package/vendored/components/chat/ChatPanel.tsx

@@ -76,9 +76,9 @@ export function ChatPanel({ isOpen, onClose, starterQuestions, chatEndpoint, mod
       }
     };
 
-    vv.addEventListener('resize', update);
-    vv.addEventListener('scroll', update);
-    window.addEventListener('scroll', update);
+    vv.addEventListener('resize', update, { passive: true });
+    vv.addEventListener('scroll', update, { passive: true });
+    window.addEventListener('scroll', update, { passive: true });
 
     return () => {
       vv.removeEventListener('resize', update);

package/vendored/components/layout/LayoutWrapper.tsx

@@ -64,7 +64,7 @@ export function LayoutWrapper({ config, children }: LayoutWrapperProps) {
       }
     };
 
-    scrollTarget.addEventListener('scroll', handleScroll);
+    scrollTarget.addEventListener('scroll', handleScroll, { passive: true });
     handleScroll(); // Check initial position
 
     return () => scrollTarget.removeEventListener('scroll', handleScroll);

package/vendored/components/mdx/View.tsx

@@ -10,6 +10,7 @@ import React, {
   useRef,
   type ReactNode,
 } from 'react';
+import { useOnClickOutside } from '@/hooks/useOnClickOutside';
 import { Icon } from './Icon';
 
 // ============================================================================
@@ -120,18 +121,7 @@ export function ViewSelector({ className = '' }: ViewSelectorProps) {
   const currentIndex = views.findIndex((v) => v.title === selectedView);
 
   // Handle click outside to close
-  useEffect(() => {
-    if (!isOpen) return;
-
-    const handleClickOutside = (e: MouseEvent) => {
-      if (containerRef.current && !containerRef.current.contains(e.target as Node)) {
-        setIsOpen(false);
-      }
-    };
-
-    document.addEventListener('mousedown', handleClickOutside);
-    return () => document.removeEventListener('mousedown', handleClickOutside);
-  }, [isOpen]);
+  useOnClickOutside(containerRef, () => setIsOpen(false), isOpen);
 
   // Focus the item when focusedIndex changes
   useEffect(() => {

package/vendored/components/navigation/Header.tsx

@@ -1,6 +1,7 @@
 'use client';
 
 import { useState, useEffect, useMemo, useRef } from 'react';
+import { useOnClickOutside } from '@/hooks/useOnClickOutside';
 import Link from 'next/link';
 import { usePathname } from 'next/navigation';
 // Icons use Font Awesome CSS classes for lightweight rendering
@@ -202,28 +203,17 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
     return () => document.removeEventListener('keydown', down);
   }, [showLogoInHeader]);
 
-  // Close tabs dropdown when clicking outside or pressing Escape
-  useEffect(() => {
-    const handleClickOutside = (e: MouseEvent) => {
-      if (tabsDropdownRef.current && !tabsDropdownRef.current.contains(e.target as Node)) {
-        setIsTabsDropdownOpen(false);
-      }
-    };
+  // Close tabs dropdown when clicking outside
+  useOnClickOutside(tabsDropdownRef, () => setIsTabsDropdownOpen(false), isTabsDropdownOpen);
 
+  // Close tabs dropdown on Escape
+  useEffect(() => {
+    if (!isTabsDropdownOpen) return;
     const handleKeyDown = (e: KeyboardEvent) => {
-      if (e.key === 'Escape') {
-        setIsTabsDropdownOpen(false);
-      }
+      if (e.key === 'Escape') setIsTabsDropdownOpen(false);
     };
-
-    if (isTabsDropdownOpen) {
-      document.addEventListener('mousedown', handleClickOutside);
-      document.addEventListener('keydown', handleKeyDown);
-      return () => {
-        document.removeEventListener('mousedown', handleClickOutside);
-        document.removeEventListener('keydown', handleKeyDown);
-      };
-    }
+    document.addEventListener('keydown', handleKeyDown);
+    return () => document.removeEventListener('keydown', handleKeyDown);
   }, [isTabsDropdownOpen]);
 
   // Split tabs into visible and overflow

package/vendored/components/navigation/LanguageSelector.tsx

@@ -1,6 +1,7 @@
 'use client';
 
 import { useState, useEffect, useRef, useCallback } from 'react';
+import { useOnClickOutside } from '@/hooks/useOnClickOutside';
 import { useRouter, usePathname } from 'next/navigation';
 import type { ResolvedLanguage } from '@/lib/navigation-resolver';
 import type { LanguageCode } from '@/lib/docs-types';
@@ -64,18 +65,7 @@ export function LanguageSelector({
   }, []); // Only run once on mount
 
   // Handle click outside to close
-  useEffect(() => {
-    if (!isOpen) return;
-
-    const handleClickOutside = (e: MouseEvent) => {
-      if (containerRef.current && !containerRef.current.contains(e.target as Node)) {
-        setIsOpen(false);
-      }
-    };
-
-    document.addEventListener('mousedown', handleClickOutside);
-    return () => document.removeEventListener('mousedown', handleClickOutside);
-  }, [isOpen]);
+  useOnClickOutside(containerRef, () => setIsOpen(false), isOpen);
 
   // Handle keyboard navigation
   const handleKeyDown = useCallback(

package/vendored/components/navigation/TableOfContents.tsx

@@ -362,10 +362,10 @@ export function TableOfContents({ content, className = '' }: TableOfContentsProp
 
   return (
     <nav className={className}>
-      <h4 className="text-sm font-semibold text-[var(--color-text-tertiary)] mb-3 flex items-center gap-2">
+      <p className="text-sm font-semibold text-[var(--color-text-tertiary)] mb-3 flex items-center gap-2">
         <i className={`${getIconClass('bars-sort')} h-3.5 w-3.5`} aria-hidden="true" />
         On this page
-      </h4>
+      </p>
       <div className="relative">
         {/* SVG background line (grey) — rendered inline for perfect alignment */}
         {svgPath && (

package/vendored/components/snippets/generated/CodeLink.tsx

@@ -0,0 +1,25 @@
+// Auto-generated file - do not edit manually
+// @ts-nocheck
+
+import React from 'react';
+
+// Import built-in MDX components that snippets can use
+import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
+import { Card } from '@/components/mdx/Card';
+import { CardGroup } from '@/components/mdx/CardGroup';
+import { ParamField } from '@/components/mdx/ParamField';
+import { ResponseField } from '@/components/mdx/ResponseField';
+import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
+import { CodeGroup } from '@/components/mdx/CodeGroup';
+import { Steps, Step } from '@/components/mdx/Steps';
+
+
+const CodeLink = ({ title, href }: any) => {
+  return (
+    <Card title={`${title}`} href={`${href}`} horizontal icon="code">
+      {" "}
+    </Card>
+  );
+};
+
+export default CodeLink;

package/vendored/components/snippets/generated/HeaderAPI.tsx

@@ -0,0 +1,44 @@
+// Auto-generated file - do not edit manually
+// @ts-nocheck
+
+import React from 'react';
+
+// Import built-in MDX components that snippets can use
+import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
+import { Card } from '@/components/mdx/Card';
+import { CardGroup } from '@/components/mdx/CardGroup';
+import { ParamField } from '@/components/mdx/ParamField';
+import { ResponseField } from '@/components/mdx/ResponseField';
+import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
+import { CodeGroup } from '@/components/mdx/CodeGroup';
+import { Steps, Step } from '@/components/mdx/Steps';
+
+
+const HeaderAPI = ({ noProfileKey, profileKeyRequired }: any) => (
+  <>
+    <ParamField header="Authorization" type="string" required>
+      <a href="/apis/overview#authorization">API Key</a> of the Primary Profile.
+      <br />
+      <br />
+      Format: <code>Authorization: Bearer API_KEY</code>
+    </ParamField>
+    {!noProfileKey &&
+      (profileKeyRequired ? (
+        <ParamField header="Profile-Key" type="string" required>
+          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
+          <br />
+          <br />
+          Format: <code>Profile-Key: PROFILE_KEY</code>
+        </ParamField>
+      ) : (
+        <ParamField header="Profile-Key" type="string">
+          <a href="/apis/overview#profile-key-format">Profile Key</a> of a User Profile.
+          <br />
+          <br />
+          Format: <code>Profile-Key: PROFILE_KEY</code>
+        </ParamField>
+      ))}
+  </>
+);
+
+export default HeaderAPI;

package/vendored/components/snippets/generated/PlansAvailable.tsx

@@ -0,0 +1,53 @@
+// Auto-generated file - do not edit manually
+// @ts-nocheck
+
+import React from 'react';
+
+// Import built-in MDX components that snippets can use
+import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
+import { Card } from '@/components/mdx/Card';
+import { CardGroup } from '@/components/mdx/CardGroup';
+import { ParamField } from '@/components/mdx/ParamField';
+import { ResponseField } from '@/components/mdx/ResponseField';
+import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
+import { CodeGroup } from '@/components/mdx/CodeGroup';
+import { Steps, Step } from '@/components/mdx/Steps';
+
+
+const PlansAvailable = ({ plans, maxPackRequired }: any) => {
+  let displayPlans = plans;
+
+if (plans.length === 1) {
+const lowerCasePlan = plans[0].toLowerCase();
+if (lowerCasePlan === "basic") {
+displayPlans = ["Basic", "Premium", "Business", "Enterprise"];
+} else if (lowerCasePlan === "business") {
+displayPlans = ["Business", "Enterprise"];
+} else if (lowerCasePlan === "premium") {
+displayPlans = ["Premium", "Business", "Enterprise"];
+}
+}
+
+return (
+
+<Note>
+Available on {displayPlans.length === 1 ? "the " : ""}
+{displayPlans.join(", ").replace(/\b\w/g, (l) => l.toUpperCase())}{" "}
+{displayPlans.length > 1 ? "plans" : "plan"}.
+
+{maxPackRequired && (
+
+  <a href="https://www.acme.com/docs/additional/maxpack"
+ className="flex items-center mt-2 cursor-pointer"
+>
+ <span className="px-1.5 py-0.5 rounded text-sm" style={{backgroundColor: '#C264B6', color: 'white', fontSize: '12px'}}>
+   Max Pack required
+ </span>
+</a>
+)}
+</Note>
+
+);
+};
+
+export default PlansAvailable;

package/vendored/components/snippets/generated/SnippetIntro.tsx

@@ -0,0 +1,43 @@
+// Auto-generated file - do not edit manually
+// @ts-nocheck
+
+import React from 'react';
+
+// Import built-in MDX components that snippets can use
+import { Note, Info, Warning, Tip, Check, Danger, Callout } from '@/components/mdx/Callouts';
+import { Card } from '@/components/mdx/Card';
+import { CardGroup } from '@/components/mdx/CardGroup';
+import { ParamField } from '@/components/mdx/ParamField';
+import { ResponseField } from '@/components/mdx/ResponseField';
+import { Accordion, AccordionGroup } from '@/components/mdx/Accordion';
+import { CodeGroup } from '@/components/mdx/CodeGroup';
+import { Steps, Step } from '@/components/mdx/Steps';
+
+
+// Helper component for rendering plain MDX snippets
+// Content is from project snippets (controlled source), not user input
+const PlainMdxSnippet = ({ content }: { content: string }) => {
+  const formattedContent = content
+    .split('\n\n')
+    .map((paragraph) => {
+      let html = paragraph.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
+      html = html.replace(/\*([^*]+)\*/g, '<em>$1</em>');
+      html = html.replace(/\`([^\`]+)\`/g, '<code>$1</code>');
+      return html;
+    })
+    .filter(p => p.trim());
+
+  return (
+    <div className="snippet-content">
+      {formattedContent.map((p, i) => (
+        <p key={i} dangerouslySetInnerHTML={{ __html: p }} />
+      ))}
+    </div>
+  );
+};
+
+const SnippetIntro = () => {
+  return <PlainMdxSnippet content={"One of the core principles of software development is DRY (Don't Repeat\nYourself). This is a principle that apply to documentation as\nwell. If you find yourself repeating the same content in multiple places, you\nshould consider creating a custom snippet to keep your content in sync."} />;
+};
+
+export default SnippetIntro;

package/vendored/components/ui/CodePanel.tsx

@@ -178,8 +178,8 @@ export function CodePanel({
       setTimeout(checkOverflow, 100);
     });
     const el = tabsRef.current;
-    el?.addEventListener('scroll', checkOverflow);
-    window.addEventListener('resize', checkOverflow);
+    el?.addEventListener('scroll', checkOverflow, { passive: true });
+    window.addEventListener('resize', checkOverflow, { passive: true });
     return () => {
       el?.removeEventListener('scroll', checkOverflow);
       window.removeEventListener('resize', checkOverflow);

package/vendored/hooks/useOnClickOutside.ts

@@ -0,0 +1,28 @@
+'use client';
+
+import { useEffect, useRef, type RefObject } from 'react';
+
+/**
+ * Calls `handler` when a mousedown occurs outside `ref`.
+ * Only active when `enabled` is true (defaults to true).
+ * Handler is stored in a ref — safe to pass inline functions.
+ */
+export function useOnClickOutside(
+  ref: RefObject<HTMLElement | null>,
+  handler: () => void,
+  enabled = true,
+) {
+  const handlerRef = useRef(handler);
+  handlerRef.current = handler;
+
+  useEffect(() => {
+    if (!enabled) return;
+    function onMouseDown(e: MouseEvent) {
+      if (ref.current && !ref.current.contains(e.target as Node)) {
+        handlerRef.current();
+      }
+    }
+    document.addEventListener('mousedown', onMouseDown);
+    return () => document.removeEventListener('mousedown', onMouseDown);
+  }, [ref, enabled]);
+}

package/vendored/lib/validate-config.ts

@@ -10,7 +10,9 @@
  */
 
 import AjvModule, { ErrorObject } from 'ajv';
-import addFormats from 'ajv-formats';
+import addFormatsModule from 'ajv-formats';
+// ESM compatibility - ajv-formats exports differently under NodeNext resolution
+const addFormats = (addFormatsModule as any).default || addFormatsModule;
 // ESM compatibility - Ajv exports differently in Node.js ESM
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const Ajv = (AjvModule as any).default || AjvModule;

package/vendored/themes/jam/variables.css

@@ -823,11 +823,18 @@ body[data-theme="jam"] .prose video {
   }
 }
 
-/* Move hamburger menu left on mobile */
+/* Align header and content on mobile — zero out inline margin, use consistent padding */
+/* Selector uses [data-has-tabs] to only target the nav header, not <header> inside articles */
 @media (max-width: 1023px) {
-  body[data-theme="jam"] header > div {
-    margin-left: 0 !important;
+  body[data-theme="jam"] header[data-has-tabs] > div {
+    margin: 0 !important;
     padding-left: 0.5rem;
+    padding-right: 0.5rem;
+  }
+
+  body[data-theme="jam"] #main-content article {
+    padding-left: 0.5rem !important;
+    padding-right: 0.5rem !important;
   }
 }
 

package/vendored/themes/nebula/variables.css

@@ -261,11 +261,18 @@ body[data-theme="nebula"] .code-panels-sidebar {
   padding-right: 1rem;
 }
 
-/* Move hamburger menu left on mobile */
+/* Align header and content on mobile — zero out inline margin, use consistent padding */
+/* Selector uses [data-has-tabs] to only target the nav header, not <header> inside articles */
 @media (max-width: 1023px) {
-  body[data-theme="nebula"] header > div {
-    margin-left: 0 !important;
+  body[data-theme="nebula"] header[data-has-tabs] > div {
+    margin: 0 !important;
     padding-left: 0.5rem;
+    padding-right: 0.5rem;
+  }
+
+  body[data-theme="nebula"] #main-content article {
+    padding-left: 0.5rem !important;
+    padding-right: 0.5rem !important;
   }
 }