jamdesk 1.1.7 → 1.1.8

package/README.md

@@ -1,8 +1,10 @@
 # Jamdesk CLI
 
 [![npm version](https://img.shields.io/npm/v/jamdesk)](https://www.npmjs.com/package/jamdesk)
+[![npm downloads](https://img.shields.io/npm/dm/jamdesk)](https://www.npmjs.com/package/jamdesk)
 [![Node.js](https://img.shields.io/node/v/jamdesk)](https://nodejs.org)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](./LICENSE)
+[![Claude Code](https://img.shields.io/badge/Claude_Code-skills-blueviolet?logo=anthropic)](https://www.jamdesk.com/docs/claude-code)
 
 CLI for [Jamdesk](https://www.jamdesk.com) — build, preview, and deploy documentation sites from MDX.
 
@@ -32,7 +34,7 @@ Your docs are at **http://localhost:3000**. That's it.
 
 ## Installation
 
-### npm (recommended)
+### [npm](https://www.npmjs.com/package/jamdesk) (recommended)
 
 ```bash
 npm install -g jamdesk
@@ -222,7 +224,7 @@ Found 3 misspellings across 24 pages.
 Tip: Run "jamdesk spellcheck --fix" to interactively fix or ignore words.
 ```
 
-Uses an English dictionary with 150+ built-in tech terms (API, GraphQL, Kubernetes, etc.) so common jargon doesn't flag. Add project-specific words to `docs.json`:
+Uses an English dictionary with 150+ built-in tech terms (API, GraphQL, Kubernetes, etc.) so common jargon doesn't flag. Currently English only — multi-language support is planned. Add project-specific words to `docs.json`:
 
 ```json
 {
@@ -429,6 +431,7 @@ See the [docs.json reference](https://www.jamdesk.com/docs/config/docs-json-refe
 - [Config Reference](https://www.jamdesk.com/docs/config/docs-json-reference)
 - [OpenAPI](https://www.jamdesk.com/docs/api-reference/openapi-setup)
 - [Deployment](https://www.jamdesk.com/docs/deploy)
+- [npm Package](https://www.npmjs.com/package/jamdesk)
 - [Homepage](https://www.jamdesk.com)
 - [Pricing](https://www.jamdesk.com/pricing)
 

package/dist/lib/deps.js

@@ -54,7 +54,7 @@ const REQUIRED_DEPS = {
     'remark-math': '^6.0.0',
     'remark-smartypants': '^3.0.2',
     // Math/LaTeX rendering
-    'katex': '^0.16.34',
+    'katex': '^0.16.44',
     // Diagrams
     'mermaid': '^11.12.2',
     // YAML parsing (for OpenAPI specs)
@@ -81,7 +81,7 @@ const REQUIRED_DEPS = {
     'json5': '^2.2.3',
     'glob': '^13.0.6',
     // TypeScript (needed for Next.js to avoid auto-install breaking symlink)
-    'typescript': '^5.3.3',
+    'typescript': '^6.0.2',
     '@types/node': '^25.5.0',
     '@types/react': '^19.2.14',
     '@types/react-dom': '^19.0.0',

package/dist/lib/openapi/types.d.ts

@@ -168,12 +168,17 @@ export interface ValidationResult {
     error?: OpenApiValidationError;
 }
 /**
- * Generated code examples
- */
-export interface CodeExamples {
-    curl: string;
-    python: string;
-    javascript: string;
+ * Single code example for a specific language
+ */
+export interface CodeExample {
+    /** Language identifier (e.g., 'curl', 'python', 'go') */
+    id: string;
+    /** Display label for the tab (e.g., 'cURL', 'Python', 'Go') */
+    label: string;
+    /** Shiki language ID for syntax highlighting (e.g., 'bash', 'python', 'go') */
+    language: string;
+    /** Generated code string */
+    code: string;
 }
 /**
  * Generated page from auto-generation

package/dist/lib/openapi/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/openapi/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/openapi/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/path-security.d.ts

@@ -9,6 +9,9 @@
 /**
  * Check if a path stays within the project directory.
  * Returns true if path is within project, false otherwise.
+ *
+ * Rejects null bytes, URL-encoded sequences, and normalizes
+ * backslashes to prevent traversal via encoding tricks.
  */
 export declare function isPathWithinProject(filePath: string, projectDir: string): boolean;
 /**

package/dist/lib/path-security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path-security.d.ts","sourceRoot":"","sources":["../../src/lib/path-security.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAKjF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAIpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAGtF"}
+{"version":3,"file":"path-security.d.ts","sourceRoot":"","sources":["../../src/lib/path-security.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAkBjF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAIpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAGtF"}

package/dist/lib/path-security.js

@@ -10,9 +10,22 @@ import path from 'path';
 /**
  * Check if a path stays within the project directory.
  * Returns true if path is within project, false otherwise.
+ *
+ * Rejects null bytes, URL-encoded sequences, and normalizes
+ * backslashes to prevent traversal via encoding tricks.
  */
 export function isPathWithinProject(filePath, projectDir) {
-    const absolutePath = path.resolve(projectDir, filePath);
+    // Reject null bytes (real or URL-encoded)
+    if (filePath.includes('\0') || filePath.includes('%00')) {
+        return false;
+    }
+    // Reject URL-encoded path separators and traversal sequences
+    if (/%2f/i.test(filePath) || /%5c/i.test(filePath)) {
+        return false;
+    }
+    // Normalize backslashes to forward slashes to prevent Windows-style traversal
+    const normalized = filePath.replace(/\\/g, '/');
+    const absolutePath = path.resolve(projectDir, normalized);
     const normalizedProject = path.resolve(projectDir);
     return absolutePath.startsWith(normalizedProject + path.sep) || absolutePath === normalizedProject;
 }

package/dist/lib/path-security.js.map

@@ -1 +1 @@
-{"version":3,"file":"path-security.js","sourceRoot":"","sources":["../../src/lib/path-security.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,UAAkB;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEnD,OAAO,YAAY,CAAC,UAAU,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,YAAY,KAAK,iBAAiB,CAAC;AACrG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,UAAkB;IAC5E,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,EAAU,EAAE,UAAkB;IAC9E,yBAAyB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,yBAAyB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"path-security.js","sourceRoot":"","sources":["../../src/lib/path-security.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,UAAkB;IACtE,0CAA0C;IAC1C,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6DAA6D;IAC7D,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8EAA8E;IAC9E,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAEhD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC1D,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEnD,OAAO,YAAY,CAAC,UAAU,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,YAAY,KAAK,iBAAiB,CAAC;AACrG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,UAAkB;IAC5E,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,EAAU,EAAE,UAAkB;IAC9E,yBAAyB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,yBAAyB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC"}

package/package.json

@@ -1,36 +1,39 @@
 {
   "name": "jamdesk",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "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",
     "documentation",
     "documentation-generator",
     "documentation-platform",
+    "documentation-tool",
     "docs",
     "docs-as-code",
+    "docs-generator",
     "mdx",
     "markdown",
     "cli",
-    "dev-server",
-    "hot-reload",
-    "turbopack",
     "developer-tools",
     "api-documentation",
     "openapi",
     "api-reference",
-    "static-site",
+    "static-site-generator",
     "nextjs",
+    "react",
+    "typescript",
     "technical-writing",
     "mintlify",
     "mintlify-alternative",
+    "docusaurus-alternative",
+    "gitbook-alternative",
     "documentation-hosting",
     "documentation-site",
     "developer-documentation",
     "api-docs",
-    "react-components",
     "docs-site-generator",
-    "ai-search"
+    "ai-search",
+    "llms-txt"
   ],
   "homepage": "https://www.jamdesk.com",
   "bugs": {
@@ -44,7 +47,7 @@
   "license": "Apache-2.0",
   "author": {
     "name": "Jamdesk",
-    "email": "hello@jamdesk.com",
+    "email": "support@jamdesk.com",
     "url": "https://www.jamdesk.com"
   },
   "type": "module",
@@ -113,8 +116,8 @@
     "@mdx-js/mdx": "^3.1.1",
     "@types/fs-extra": "^11.0.0",
     "@types/node": "^25.5.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.1.0"
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
   },
   "engines": {
     "node": ">=20.0.0"

package/vendored/app/[[...slug]]/page.tsx

@@ -42,6 +42,7 @@ import { getLatexRemarkPlugins, getLatexRehypePlugins } from '@/lib/latex-config
 import { getTypographyRemarkPlugins } from '@/lib/typography-config';
 import { recmaCompoundComponents } from '@/lib/recma-compound-components';
 import { extractInlineComponents } from '@/lib/process-mdx-with-exports';
+import { buildEndpointFromMdx } from '@/lib/build-endpoint-from-mdx';
 import { mdxSecurityOptions } from '@/lib/mdx-security-options';
 import fs from 'fs';
 import path from 'path';
@@ -67,7 +68,7 @@ import {
   generateCodeExamples,
   formatOpenApiWarning,
   type OpenApiEndpointData,
-  type CodeExamples,
+  type CodeExample,
   type AuthMethod,
 } from '@/lib/openapi';
 import { ApiEndpoint } from '@/components/mdx/ApiEndpoint';
@@ -134,6 +135,7 @@ interface FrontmatterData {
   description?: string;
   api?: string;
   openapi?: string;
+  playground?: string;
   mode?: string;
   hideFooter?: boolean;
   rss?: boolean;
@@ -505,7 +507,7 @@ export default async function DocPage({ params }: PageProps) {
 
   // Extract and compile inline component exports from MDX
   // Only pass MDXComponents (server-compatible) to inline extraction
-  const { inlineComponents } = await extractInlineComponents(content, MDXComponents);
+  const { inlineComponents, paramFields } = await extractInlineComponents(content, MDXComponents);
 
   // Check for component name collisions and warn
   const overriddenComponents = Object.keys(inlineComponents).filter(
@@ -560,7 +562,7 @@ export default async function DocPage({ params }: PageProps) {
   
   // Parse OpenAPI endpoint data if openapi frontmatter is present
   let openApiEndpointData: OpenApiEndpointData | null = null;
-  let openApiCodeExamples: CodeExamples | null = null;
+  let openApiCodeExamples: CodeExample[] | null = null;
 
   // OpenAPI spec parsing - supports both static and ISR modes
   if (data.openapi && typeof data.openapi === 'string') {
@@ -591,7 +593,8 @@ export default async function DocPage({ params }: PageProps) {
 
       // Generate code examples
       const authMethod = config.api?.mdx?.auth?.method as AuthMethod | undefined;
-      openApiCodeExamples = generateCodeExamples(openApiEndpointData, { authMethod });
+      const languages = config.api?.examples?.languages;
+      openApiCodeExamples = generateCodeExamples(openApiEndpointData, { authMethod, languages });
     } catch (err) {
       // Log formatted warning to console (appears in CLI and build logs)
       // Check if it's an OpenAPI validation error with our format
@@ -607,16 +610,12 @@ export default async function DocPage({ params }: PageProps) {
   // Parse MDX api field for pages with api: frontmatter (but not openapi:)
   let mdxApiMethod: HttpMethod | null = null;
   let mdxApiPath: string | null = null;
-  let mdxApiBaseUrl: string | undefined;
 
   if (data.api && typeof data.api === 'string' && !data.openapi) {
     const parsed = parseMdxApiField(data.api);
     if (parsed) {
       mdxApiMethod = parsed.method;
       mdxApiPath = parsed.path;
-      // Get server URL from config, with fallback
-      const serverConfig = config.api?.mdx?.server;
-      mdxApiBaseUrl = Array.isArray(serverConfig) ? serverConfig[0] : serverConfig;
     }
   }
 
@@ -644,6 +643,23 @@ export default async function DocPage({ params }: PageProps) {
   // Prose class for MDX content styling (defined in base.css)
   const proseClasses = 'prose max-w-none';
 
+  // Playground configuration — covers both openapi: and api: pages
+  const hasApiEndpoint = openApiEndpointData || (mdxApiMethod && mdxApiPath);
+  const playgroundDisplay = hasApiEndpoint
+    ? ((data.playground as 'interactive' | 'simple' | 'none' | undefined)
+        || config.api?.playground?.display || 'none') as 'interactive' | 'simple' | 'none'
+    : 'none';
+  const mdxServerConfig = config.api?.mdx?.server;
+  const fallbackServerUrl = Array.isArray(mdxServerConfig) ? mdxServerConfig[0] : mdxServerConfig;
+  const proxyEnabled = config.api?.playground?.proxy
+    ?? (playgroundDisplay === 'interactive');
+
+  // Build endpoint data for api: pages (for playground)
+  let mdxEndpointData: OpenApiEndpointData | undefined;
+  if (!openApiEndpointData && mdxApiMethod && mdxApiPath && playgroundDisplay !== 'none') {
+    mdxEndpointData = buildEndpointFromMdx(mdxApiMethod, mdxApiPath, paramFields, fallbackServerUrl);
+  }
+
   // For API pages, wrap the entire content area with ApiPageWrapper
   // so code panels can be positioned as siblings at the page level
   if (isApiPage) {
@@ -676,11 +692,24 @@ export default async function DocPage({ params }: PageProps) {
           <div className={proseClasses}>
             {/* MDX API endpoint badge (for pages with api: frontmatter) */}
             {mdxApiMethod && mdxApiPath && (
-              <ApiEndpoint
-                method={mdxApiMethod}
-                path={mdxApiPath}
-                baseUrl={mdxApiBaseUrl}
-              />
+              mdxEndpointData && playgroundDisplay !== 'none' ? (
+                <OpenApiEndpoint
+                  endpoint={mdxEndpointData}
+                  playgroundOnly
+                  playgroundDisplay={playgroundDisplay}
+                  authMethod={config.api?.mdx?.auth?.method as AuthMethod | undefined}
+                  authHeaderName={config.api?.mdx?.auth?.name}
+                  serverUrl={fallbackServerUrl}
+                  proxyEnabled={proxyEnabled}
+                  languages={config.api?.examples?.languages}
+                />
+              ) : (
+                <ApiEndpoint
+                  method={mdxApiMethod}
+                  path={mdxApiPath}
+                  baseUrl={fallbackServerUrl}
+                />
+              )
             )}
 
             {/* OpenAPI endpoint documentation (auto-generated from spec) */}
@@ -688,6 +717,12 @@ export default async function DocPage({ params }: PageProps) {
               <OpenApiEndpoint
                 endpoint={openApiEndpointData}
                 codeExamples={openApiCodeExamples || undefined}
+                playgroundDisplay={playgroundDisplay}
+                authMethod={config.api?.mdx?.auth?.method as AuthMethod | undefined}
+                authHeaderName={config.api?.mdx?.auth?.name}
+                serverUrl={fallbackServerUrl}
+                proxyEnabled={proxyEnabled}
+                languages={config.api?.examples?.languages}
               />
             )}
 

package/vendored/app/api/assets/[...path]/route.ts

@@ -18,6 +18,8 @@ const CACHE_DURATIONS: Record<string, number> = {
   'image/svg+xml': 86400, // 1 day (may change)
   'image/x-icon': 31536000,
   'application/pdf': 86400,
+  'video/mp4': 31536000,   // 1 year (busted by ?v= query param on new builds)
+  'video/webm': 31536000,
   default: 3600, // 1 hour
 };
 

package/vendored/components/layout/LayoutWrapper.tsx

@@ -37,10 +37,9 @@ function useMediaQuery(query: string): boolean {
 
 export function LayoutWrapper({ config, children }: LayoutWrapperProps) {
   const [isSidebarOpen, setIsSidebarOpen] = useState(false);
-  // Chat is on by default in production; projects can opt out with chat.enabled: false.
-  // Hidden in local dev — the chat API route needs Upstash Vector + Anthropic API.
-  const chatEnabled = process.env.NODE_ENV === 'production'
-    && (config.chat?.enabled !== false);
+  // Chat button is shown in both dev and production so the layout matches.
+  // In dev mode, clicking it shows a "production only" notice instead of opening the panel.
+  const chatEnabled = config.chat?.enabled !== false;
 
   // xl breakpoint (1280px) — chat renders inline on desktop, overlay on mobile
   const isDesktop = useMediaQuery('(min-width: 1280px)');

package/vendored/components/mdx/ApiEndpoint.tsx

@@ -6,6 +6,7 @@ interface ApiEndpointProps {
   method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | 'TRACE';
   path: string;
   baseUrl?: string;
+  onTryIt?: () => void;
 }
 
 const methodColors: Record<string, { bg: string; text: string; border: string }> = {
@@ -51,7 +52,7 @@ const methodColors: Record<string, { bg: string; text: string; border: string }>
   },
 };
 
-export function ApiEndpoint({ method, path, baseUrl = 'https://api.jamdesk.com/api' }: ApiEndpointProps) {
+export function ApiEndpoint({ method, path, baseUrl = 'https://api.jamdesk.com/api', onTryIt }: ApiEndpointProps) {
   const [copied, setCopied] = useState(false);
   const colors = methodColors[method] || methodColors.GET;
   const fullUrl = `${baseUrl}${path}`;
@@ -73,10 +74,20 @@ export function ApiEndpoint({ method, path, baseUrl = 'https://api.jamdesk.com/a
         <span className="text-[var(--color-text-muted)]">{baseUrl}</span>
         <span className="text-[var(--color-text-primary)]">{path}</span>
       </span>
+      {/* Try it button */}
+      {onTryIt && (
+        <button
+          onClick={onTryIt}
+          className="px-2.5 py-1 text-xs font-medium rounded-md bg-gradient-to-r from-[var(--color-accent)] to-[var(--color-accent-hover,var(--color-accent))] text-white hover:opacity-90 transition-opacity cursor-pointer"
+          aria-label="Open API playground"
+        >
+          Try it
+        </button>
+      )}
       {/* Copy button */}
       <button
         onClick={handleCopy}
-        className="p-1.5 text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-md transition-colors"
+        className="p-1.5 text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-md transition-colors cursor-pointer"
         title="Copy endpoint URL"
         aria-label="Copy endpoint URL"
       >

package/vendored/components/mdx/MDXComponents.tsx

@@ -30,6 +30,7 @@ import { Tree, TreeFolder, TreeFile } from './Tree';
 import { Columns } from './Columns';
 import { View, ViewProvider, ViewSelector, ViewWrapper } from './View';
 import { YouTube } from './YouTube';
+import { Video } from './Video';
 
 /**
  * Extract language from a pre element for tab label
@@ -148,6 +149,14 @@ function HttpCodeBlock({ method, url }: { method: string; url: string }) {
   );
 }
 
+/** Fallback for raw <img src="video.mp4"> in MDX (preprocessor handles markdown syntax) */
+const VIDEO_EXTENSIONS_IMG = ['.mp4', '.webm'];
+function isVideoUrl(src: string | undefined): boolean {
+  if (!src) return false;
+  const pathOnly = src.split('?')[0];
+  return VIDEO_EXTENSIONS_IMG.some(ext => pathOnly.toLowerCase().endsWith(ext));
+}
+
 export const MDXComponents = {
   Card,
   // Callout components
@@ -218,6 +227,8 @@ export const MDXComponents = {
   ViewWrapper,
   // Media embeds
   YouTube,
+  // Video player for local video files
+  Video,
   // 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).
@@ -253,6 +264,11 @@ export const MDXComponents = {
     // Destructure and ignore any other props to prevent them from being passed to DOM
     ...rest
   }: any) => {
+    // Check if this is a video file — render <Video> instead of <ZoomableImage>
+    if (isVideoUrl(src)) {
+      return <Video src={src} title={alt || undefined} />;
+    }
+
     // Check for data-no-zoom attribute or noZoom prop (handle both camelCase and lowercase)
     const disableZoom = dataNoZoom === 'true' || dataNoZoom === true ||
                         noZoom === true || noZoom === 'true' ||

package/vendored/components/mdx/OpenApiEndpoint.tsx

@@ -1,6 +1,8 @@
 'use client';
 
-import { useState, useMemo } from 'react';
+import { useDevOnlyNotice, DEV_FEATURE } from '../ui/DevOnlyNotice';
+
+import { useState, useEffect, useMemo } from 'react';
 import { ApiEndpoint } from './ApiEndpoint';
 import { ParamField } from './ParamField';
 import { CodeGroup } from './CodeGroup';
@@ -14,9 +16,10 @@ import type {
   OpenApiEndpointData,
   ParsedParameter,
   ParsedResponse,
-  CodeExamples,
+  CodeExample,
   JsonSchema,
   SecurityRequirement,
+  AuthMethod,
 } from '@/lib/openapi/types';
 
 // Preload Shiki highlighter on module load
@@ -28,9 +31,25 @@ interface OpenApiEndpointProps {
   /** Endpoint data from OpenAPI spec */
   endpoint: OpenApiEndpointData;
   /** Generated code examples */
-  codeExamples?: CodeExamples;
+  codeExamples?: CodeExample[];
   /** Additional content to render after endpoint info */
   children?: React.ReactNode;
+  /** Playground display mode */
+  playgroundDisplay?: 'interactive' | 'simple' | 'none';
+  /** Auth method for playground */
+  authMethod?: AuthMethod;
+  /** Custom auth header name */
+  authHeaderName?: string;
+  /** Fallback server URL when endpoint.servers is empty */
+  serverUrl?: string;
+  /** Whether CORS proxy is enabled */
+  proxyEnabled?: boolean;
+  /** Languages for code generation */
+  languages?: string[];
+  /** When true, render only the ApiEndpoint badge (with Try it) + PlaygroundModal.
+   *  Skips all auto-generated param docs, response panels, and code examples.
+   *  Used for api: pages where the MDX content provides the documentation. */
+  playgroundOnly?: boolean;
 }
 
 /**
@@ -834,35 +853,23 @@ function ResponseFieldItem({
 /**
  * Code examples section - renders in right panel using CodePanel
  */
-function CodeExamplesSection({ examples }: { examples: CodeExamples }) {
+function CodeExamplesSection({ examples }: { examples: CodeExample[] }) {
   const codeItems = useMemo(
-    () => [
-      { code: examples.curl, language: 'bash' },
-      { code: examples.python, language: 'python' },
-      { code: examples.javascript, language: 'javascript' },
-    ],
-    [examples.curl, examples.python, examples.javascript]
+    () => examples.map(ex => ({ code: ex.code, language: ex.language })),
+    [examples]
   );
 
   const { results: highlightedResults, isLoading } = useShikiHighlightMultiple(codeItems);
 
-  // Render full Shiki HTML for theme background support
+  // Shiki generates HTML from trusted code strings (not user input)
   const tabs: CodePanelTab[] = useMemo(
-    () => [
-      {
-        label: 'cURL',
-        content: <div dangerouslySetInnerHTML={{ __html: highlightedResults[0] || '' }} />,
-      },
-      {
-        label: 'Python',
-        content: <div dangerouslySetInnerHTML={{ __html: highlightedResults[1] || '' }} />,
-      },
-      {
-        label: 'JavaScript',
-        content: <div dangerouslySetInnerHTML={{ __html: highlightedResults[2] || '' }} />,
-      },
-    ],
-    [highlightedResults]
+    () => examples.map((ex, i) => ({
+      label: ex.label,
+      content: highlightedResults[i]
+        ? <div dangerouslySetInnerHTML={{ __html: highlightedResults[i] }} />
+        : null,
+    })),
+    [examples, highlightedResults]
   );
 
   // Don't render until highlighting is complete to prevent flash of unformatted content
@@ -880,13 +887,20 @@ function CodeExamplesSection({ examples }: { examples: CodeExamples }) {
 export function OpenApiEndpoint({
   endpoint,
   codeExamples,
-  children
+  children,
+  playgroundDisplay = 'none',
+  authMethod,
+  authHeaderName,
+  serverUrl,
+  proxyEnabled,
+  languages,
+  playgroundOnly,
 }: OpenApiEndpointProps) {
-  const { 
-    method, 
-    path, 
-    summary, 
-    description, 
+  const {
+    method,
+    path,
+    summary,
+    description,
     deprecated,
     parameters,
     requestBody,
@@ -895,15 +909,33 @@ export function OpenApiEndpoint({
     externalDocs,
     servers,
   } = endpoint;
-  
+
   // Group parameters by location
   const pathParams = parameters.filter(p => p.in === 'path');
   const queryParams = parameters.filter(p => p.in === 'query');
   const headerParams = parameters.filter(p => p.in === 'header');
   const cookieParams = parameters.filter(p => p.in === 'cookie');
-  
+
   const baseUrl = servers[0]?.url;
-  
+
+  // Playground state
+  const showPlayground = playgroundDisplay !== 'none';
+  const { showNotice: showDevNotice, notice: devNotice } = useDevOnlyNotice();
+
+  if (playgroundOnly) {
+    return (
+      <div className="openapi-endpoint">
+        <ApiEndpoint
+          method={method}
+          path={path}
+          baseUrl={baseUrl}
+          onTryIt={showPlayground ? () => { showDevNotice(DEV_FEATURE.API_PLAYGROUND); } : undefined}
+        />
+        {devNotice}
+      </div>
+    );
+  }
+
   return (
     <div className="openapi-endpoint">
       {/* Deprecation Warning */}
@@ -917,7 +949,12 @@ export function OpenApiEndpoint({
       )}
       
       {/* Endpoint Badge */}
-      <ApiEndpoint method={method} path={path} baseUrl={baseUrl} />
+      <ApiEndpoint
+        method={method}
+        path={path}
+        baseUrl={baseUrl}
+        onTryIt={showPlayground ? () => { showDevNotice(DEV_FEATURE.API_PLAYGROUND); } : undefined}
+      />
       
       {/* External Docs */}
       {externalDocs && (
@@ -961,9 +998,12 @@ export function OpenApiEndpoint({
       
       {/* Responses - field documentation in main content */}
       <ResponseSection responses={responses} />
+      {devNotice}
       
       {/* Additional Content */}
       {children}
+
+      {/* Playground Modal (lazy-loaded) */}
     </div>
   );
 }

package/vendored/components/mdx/Tabs.tsx

@@ -115,7 +115,7 @@ export const Tabs = memo(function Tabs({ children, borderBottom }: TabsProps) {
               <button
                 key={index}
                 onClick={() => handleTabClick(index)}
-                className={`flex items-center gap-2 px-4 py-2.5 text-sm font-medium border-b-2 transition-colors whitespace-nowrap ${
+                className={`flex items-center gap-2 px-4 py-2.5 text-sm font-medium border-b-2 transition-colors whitespace-nowrap cursor-pointer ${
                   isActive
                     ? 'border-[var(--color-accent)] text-[var(--color-accent-text)]'
                     : 'border-transparent text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)] hover:border-[var(--color-border)]'