jamdesk 1.1.19 → 1.1.20

package/vendored/components/mdx/YouTube.tsx

@@ -8,13 +8,15 @@ interface YouTubeProps {
   title?: string;
   /** Optional: Start time in seconds */
   start?: number;
+  /** Optional: Render as a vertical YouTube Short (9:16 aspect ratio) */
+  short?: boolean;
 }
 
 /**
- * Lazy-loaded YouTube video embed using lite-youtube-embed.
- * Video iframe only loads when user clicks play.
+ * YouTube video embed. Standard videos use lite-youtube-embed (lazy-loaded,
+ * iframe only loads on click). Shorts use a direct iframe with 9:16 aspect ratio.
  */
-export function YouTube({ id, title, start }: YouTubeProps): React.ReactElement | null {
+export function YouTube({ id, title, start, short }: YouTubeProps): React.ReactElement | null {
   if (!id) {
     console.warn('YouTube component requires an "id" prop');
     return null;
@@ -23,6 +25,22 @@ export function YouTube({ id, title, start }: YouTubeProps): React.ReactElement
   const startSeconds = start && start > 0 ? Math.floor(start) : undefined;
   const params = startSeconds ? `rel=0&start=${startSeconds}` : 'rel=0';
 
+  if (short) {
+    const src = `https://www.youtube.com/embed/${id}?${params}`;
+    return (
+      <div className="my-6 mx-auto max-w-[360px]">
+        <iframe
+          className="w-full aspect-[9/16] rounded-xl"
+          src={src}
+          title={title || 'YouTube Short'}
+          allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
+          allowFullScreen
+          loading="lazy"
+        />
+      </div>
+    );
+  }
+
   return (
     <div className="my-6 [&_lite-youtube]:rounded-xl [&_lite-youtube]:overflow-hidden">
       <YouTubeEmbed

package/vendored/components/search/SearchModal.tsx

@@ -8,6 +8,7 @@ import { useBodyScrollLock } from '@/hooks/useBodyScrollLock';
 import { getSuggestions } from '@/lib/search-suggestions';
 import { trackSearch } from '@/lib/analytics-client';
 import { useLinkPrefix } from '@/lib/link-prefix-context';
+import { useProjectSlug } from '@/lib/project-slug-context';
 
 // Build-time env var for client-side configuration
 const projectSlug = process.env.NEXT_PUBLIC_PROJECT_SLUG || 'default';
@@ -103,6 +104,7 @@ function NoResultsState({ query, onSuggestionClick }: { query: string; onSuggest
 
 export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: SearchModalProps) {
   const linkPrefix = useLinkPrefix();
+  const analyticsProjectSlug = useProjectSlug();
   const [query, setQuery] = useState('');
   const [results, setResults] = useState<SearchResult[]>([]);
   const [selectedIndex, setSelectedIndex] = useState(0);
@@ -142,7 +144,7 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
   useEffect(() => {
     if (!isOpen && lastSearchRef.current && !hasTrackedRef.current) {
       // Modal closed with an untracked search - track it now
-      trackSearch({
+      trackSearch(analyticsProjectSlug, {
         type: 'search_query',
         query: lastSearchRef.current.query,
         resultsCount: lastSearchRef.current.resultsCount,
@@ -153,7 +155,7 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
       hasTrackedRef.current = false;
       lastSearchRef.current = null;
     }
-  }, [isOpen]);
+  }, [isOpen, analyticsProjectSlug]);
 
   // Load search data and recent searches on mount
   useEffect(() => {
@@ -263,7 +265,7 @@ export function SearchModal({ isOpen, onClose, popularPages, onNavigate }: Searc
       else if (query.trim() && results.length === 0 && !isSearching && e.key === 'Enter') {
         e.preventDefault();
         // Track this as a committed search with zero results
-        trackSearch({
+        trackSearch(analyticsProjectSlug, {
           type: 'search_query',
           query: query.trim(),
           resultsCount: 0,
@@ -301,19 +303,19 @@ 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]);
+  }, [isOpen, query, recentSearches, results, selectedIndex, effectivePopularPages, popularIndex, router, onClose, onNavigate, analyticsProjectSlug]);
 
   const handleResultClick = (result: SearchResult, index: number) => {
     if (query.trim()) {
       // Track search_query event (the search itself)
-      trackSearch({
+      trackSearch(analyticsProjectSlug, {
         type: 'search_query',
         query: query.trim(),
         resultsCount: results.length,
       });
 
       // Track search_click event (the result they clicked)
-      trackSearch({
+      trackSearch(analyticsProjectSlug, {
         type: 'search_click',
         query: query.trim(),
         resultsCount: results.length,

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/lib/analytics-client.ts

@@ -1,8 +1,11 @@
 // Search Analytics Client
-// Tracks search queries and clicks for analytics dashboard
+// Tracks search queries and clicks for analytics dashboard.
+//
+// Endpoint is /_jd/search-ev (not /api/search-ev) so that sites fronted by
+// the jamdesk.com Cloudflare Worker — which only proxies /_jd/* — route the
+// request to the ISR app. Middleware rewrites /_jd/search-ev to /api/search-ev.
 
-// Firebase Function URL for search analytics
-const ANALYTICS_URL = '/api/search-ev';
+const ANALYTICS_URL = '/_jd/search-ev';
 
 // Reuse the same session ID as the pageview tracking script (localStorage with 30-min inactivity timeout).
 // Every call refreshes the timestamp, so active users keep the same session.
@@ -16,7 +19,6 @@ function getSessionId(): string {
   const sessionTs = localStorage.getItem('jamdesk_session_ts');
 
   if (!sessionId || !sessionTs || (now - parseInt(sessionTs)) >= SESSION_TIMEOUT_MS) {
-    // Match the tracking script's format: 16 random bytes as hex + timestamp in base36
     const bytes = new Uint8Array(16);
     crypto.getRandomValues(bytes);
     sessionId = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('') +
@@ -50,20 +52,21 @@ type SearchEvent = SearchQueryEvent | SearchClickEvent;
 /**
  * Track a search analytics event.
  *
- * Note: This function returns immediately without waiting for the request to complete.
- * The fetch request runs in the background with `keepalive: true` to survive page navigation.
- * Errors are silently ignored since analytics should never break the user experience.
+ * The project slug MUST be supplied at runtime (typically via `useProjectSlug()`
+ * from `lib/project-slug-context`). Build-time env vars are not usable because
+ * the ISR deployment is multi-tenant and NEXT_PUBLIC_* vars are baked per-build.
+ *
+ * Fire-and-forget: returns immediately. The fetch runs in the background with
+ * `keepalive: true` so it survives page navigation. Errors are silently ignored.
  */
-export function trackSearch(event: SearchEvent): void {
+export function trackSearch(projectSlug: string, event: SearchEvent): void {
   // Don't track in development
   if (process.env.NODE_ENV === 'development') return;
 
-  const projectSlug = process.env.NEXT_PUBLIC_PROJECT_SLUG;
+  // Empty slug means we couldn't resolve the project (e.g., non-ISR fallback) — no-op
   if (!projectSlug) return;
 
   try {
-    // Use fetch with keepalive for non-blocking analytics
-    // Note: sendBeacon with application/json triggers CORS preflight which can fail silently
     const payload = JSON.stringify({
       projectSlug,
       sessionId: getSessionId(),
@@ -71,8 +74,6 @@ export function trackSearch(event: SearchEvent): void {
       timestamp: Date.now(),
     });
 
-    // fetch with keepalive allows request to complete even if page navigates
-    // This is more reliable than sendBeacon for JSON payloads
     fetch(ANALYTICS_URL, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },

package/vendored/lib/docs-types.ts

@@ -741,6 +741,14 @@ export interface SpellcheckConfig {
   ignore?: string[];
 }
 
+/**
+ * Image optimization configuration
+ */
+export interface ImagesConfig {
+  /** Automatically convert PNG/JPG images to WebP format during build (default: false) */
+  convertToWebp?: boolean;
+}
+
 // =============================================================================
 // MAIN DOCS CONFIG
 // =============================================================================
@@ -807,6 +815,7 @@ export interface DocsConfig {
   analytics?: AnalyticsConfig;
   chat?: ChatConfig;
   spellcheck?: SpellcheckConfig;
+  images?: ImagesConfig;
 
   // Mintlify compatibility fields (normalized at load time)
   modeToggle?: ModeToggleConfig;
@@ -872,7 +881,7 @@ export function appendAssetVersion(url: string, assetVersion?: string): string {
 }
 
 /**
- * Transform an image path from /images/... to /_jd/images/...
+ * Transform a local asset path to /_jd/... for routing through the asset pipeline.
  *
  * Used for config-defined images (favicon, logo) that need the asset prefix.
  * Also normalizes relative paths and strips /public/ prefix (Next.js convention).
@@ -882,23 +891,22 @@ export function transformConfigImagePath(
   assetVersion?: string,
 ): string | undefined {
   if (!path) return path;
-  // Skip external URLs
-  if (path.startsWith('http://') || path.startsWith('https://') || path.startsWith('//')) {
+  if (path.startsWith('http://') || path.startsWith('https://') || path.startsWith('//') || path.startsWith('data:')) {
     return path;
   }
-  // Ensure absolute path — relative paths break on nested routes
+  // Relative paths break on nested routes
   let normalized = path.startsWith('/') ? path : `/${path}`;
   // Strip /public/ prefix (Next.js convention: public/logo.png served at /logo.png)
   normalized = normalized.replace(/^\/public\//, '/');
-  if (normalized.startsWith('/images/')) {
-    return appendAssetVersion(ASSET_PREFIX + normalized, assetVersion);
+  if (normalized.startsWith(ASSET_PREFIX + '/')) {
+    return normalized;
   }
-  return normalized;
+  return appendAssetVersion(ASSET_PREFIX + normalized, assetVersion);
 }
 
 /**
  * Normalize logo config to consistent object format.
- * Also transforms /images/... paths to /_jd/images/...
+ * Also transforms local paths to /_jd/... via transformConfigImagePath.
  */
 export function normalizeLogo(logo: Logo | undefined, assetVersion?: string): LogoConfig | null {
   if (!logo) return null;

package/vendored/lib/email-templates/build-failure.tsx

@@ -100,8 +100,11 @@ function formatPhase(phase?: string): string {
     validate: 'Configuration Validation',
     copy_content: 'Content Preparation',
     nextjs_build: 'Next.js Build',
+    optimize_images: 'Image Optimization',
     r2_upload: 'CDN Upload',
+    embeddings: 'AI Search Indexing',
     vercel_purge: 'Cache Refresh',
+    cleanup: 'Cleanup',
   };
   return phaseLabels[phase] || phase;
 }

package/vendored/lib/extract-highlights.ts

@@ -16,6 +16,7 @@ export interface ExtractedHighlights {
   redirectCount: number;
   pageCount: number;
   hasOpenApi: boolean;
+  imageOptimization: boolean;
   lastUpdatedAt: number;
 }
 
@@ -121,6 +122,7 @@ export function extractConfigHighlights(config: DocsConfig, pageCount: number =
     redirectCount: config.redirects?.length ?? 0,
     pageCount,
     hasOpenApi: hasOpenApiConfigured(config),
+    imageOptimization: config.images?.convertToWebp === true,
     lastUpdatedAt: Date.now(),
   };
 }

package/vendored/lib/font-awesome.ts

@@ -0,0 +1,2 @@
+/** Path to Font Awesome CSS — shared between server layout and client loader. */
+export const FA_CSS_HREF = '/_jd/fonts/fontawesome/css/all.min.css';

package/vendored/lib/indexnow.ts

@@ -60,6 +60,9 @@ export async function submitToIndexNow(
   }
 
   const submitted = Math.min(urls.length, MAX_BATCH_SIZE);
+  // keyLocation omitted — IndexNow requires it at the root level of the host,
+  // and our key verification route is at /api/indexnow/{key} (a subdirectory).
+  // When omitted, IndexNow defaults to /{key}.txt which it verifies asynchronously.
   const res = await fetch(INDEXNOW_ENDPOINT, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json; charset=utf-8' },
@@ -67,7 +70,6 @@ export async function submitToIndexNow(
     body: JSON.stringify({
       host,
       key,
-      keyLocation: `https://${host}/api/indexnow/${key}`,
       urlList: urls.slice(0, MAX_BATCH_SIZE),
     }),
   });

package/vendored/lib/isr-build-executor.ts

@@ -205,7 +205,10 @@ export const ISR_PHASES = {
   copy_content: { label: 'Preparing content...', weight: 10 },
   // ISR mode: nextjs_build is instant (pages compiled on-demand by Vercel)
   nextjs_build: { label: 'Building documentation...', weight: 5 },
-  r2_upload: { label: 'Uploading to CDN...', weight: 40 },
+  // Only runs when docs.json `images.convertToWebp` is enabled; the dashboard
+  // auto-marks this row skipped when no timing entry is recorded.
+  optimize_images: { label: 'Optimizing images...', weight: 5 },
+  r2_upload: { label: 'Uploading to CDN...', weight: 35 },
   embeddings: { label: 'Indexing AI search + chat...', weight: 5 },
   vercel_purge: { label: 'Refreshing cache...', weight: 20 },
   cleanup: { label: 'Cleaning up...', weight: 5 },

package/vendored/lib/page-isr-helpers.ts

@@ -61,6 +61,15 @@ export function normalizeSlugForContent(slug: string[], hostAtDocs: boolean): st
   return slug;
 }
 
+/**
+ * Split a page path (e.g. `"get-started/introduction"`) into the slug array
+ * Next.js expects. Collapses leading/trailing/repeated slashes so it accepts
+ * every shape `findFirstPage()` may return.
+ */
+export function pathToSlug(path: string): string[] {
+  return path.split('/').filter(Boolean);
+}
+
 /**
  * Get generateStaticParams result for ISR mode.
  *

package/vendored/lib/paths.ts

@@ -1,20 +1,32 @@
 /**
- * ESM Path Helpers
- * 
- * Since ESM doesn't have __dirname, we create helpers for common paths.
- * Import these instead of using __dirname directly.
+ * Path Helpers
+ *
+ * Centralized build-service paths derived from the CJS `__dirname` of this file.
  */
 
-import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import { existsSync } from 'fs';
 
-// Get the directory of the current module
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+/**
+ * Resolve the build-service root directory.
+ *
+ * In source (tsx / vitest): __dirname = build-service/lib  → parent is root.
+ * In compiled CJS:          __dirname = build-service/dist/lib → grandparent is root.
+ *
+ * We walk up from __dirname until we find the directory containing package.json.
+ */
+function findProjectRoot(): string {
+  let dir = dirname(__dirname); // one level up from lib/
+  if (existsSync(join(dir, 'package.json'))) return dir;
+  dir = dirname(dir); // two levels up (from dist/lib/)
+  if (existsSync(join(dir, 'package.json'))) return dir;
+  // Fallback — should never happen
+  return dirname(__dirname);
+}
 
 // Export common paths
 export const LIB_DIR = __dirname;
-export const BUILD_SERVICE_DIR = dirname(__dirname);
+export const BUILD_SERVICE_DIR = findProjectRoot();
 export const PROJECTS_DIR = join(BUILD_SERVICE_DIR, 'projects');
 export const SCRIPTS_DIR = join(BUILD_SERVICE_DIR, 'scripts');
 export const PUBLIC_DIR = join(BUILD_SERVICE_DIR, 'public');

package/vendored/lib/project-slug-context.tsx

@@ -0,0 +1,36 @@
+'use client';
+
+import { createContext, useContext, type ReactNode } from 'react';
+
+/**
+ * Context for exposing the resolved project slug to client components.
+ *
+ * The value is populated in `app/layout.tsx` from the `x-project-slug`
+ * request header (set by middleware). Empty string means "unknown" — clients
+ * should treat this as a signal to no-op (e.g. skip analytics).
+ *
+ * Why this exists: `NEXT_PUBLIC_PROJECT_SLUG` is inlined at build time and is
+ * unset in the multi-tenant ISR deployment, so client code cannot read it.
+ */
+const ProjectSlugContext = createContext<string>('');
+
+export function ProjectSlugProvider({
+  children,
+  slug,
+}: {
+  children: ReactNode;
+  slug: string;
+}): React.ReactElement {
+  return (
+    <ProjectSlugContext.Provider value={slug}>
+      {children}
+    </ProjectSlugContext.Provider>
+  );
+}
+
+/**
+ * Hook returning the resolved project slug, or '' when unavailable.
+ */
+export function useProjectSlug(): string {
+  return useContext(ProjectSlugContext);
+}

package/vendored/lib/r2-manifest.ts

@@ -52,6 +52,7 @@ export interface Manifest {
   projectSlug?: string;
   files: Record<string, { hash: string; size?: number }>;
   snippets?: Record<string, { hash: string }>;
+  assets?: Record<string, { hash: string }>;
   configHash?: string;
 }
 

package/vendored/next.config.js

@@ -12,6 +12,7 @@
 
 /** @type {import('next').NextConfig} */
 const nextConfig = {
+  poweredByHeader: false,
   // Hide dev indicator (floating icon in bottom-left)
   devIndicators: false,
   // Rewrite /_jd/ asset paths to public/ in dev (ISR middleware handles this in production)
@@ -20,6 +21,7 @@ const nextConfig = {
       { source: '/_jd/images/:path*', destination: '/images/:path*' },
       { source: '/_jd/videos/:path*', destination: '/videos/:path*' },
       { source: '/_jd/playground/:path*', destination: '/api/playground/:path*' },
+      { source: '/_jd/:path*', destination: '/:path*' },
     ];
   },
   // Allow /_jd/ image paths with ?v= cache-busting query strings in <Image>

package/vendored/schema/docs-schema.json

@@ -1544,6 +1544,17 @@
                     },
                     "additionalProperties": false,
                     "description": "Configuration for the jamdesk spellcheck command"
+                },
+                "images": {
+                    "type": "object",
+                    "description": "Image optimization settings for documentation builds",
+                    "properties": {
+                        "convertToWebp": {
+                            "type": "boolean",
+                            "description": "Automatically convert PNG and JPG images to WebP format during builds. Reduces image sizes by 60-80% for faster page loads. SVG and GIF files are not converted. Default: false"
+                        }
+                    },
+                    "additionalProperties": false
                 }
             },
             "required": [
@@ -1660,6 +1671,9 @@
                 },
                 "spellcheck": {
                     "$ref": "#/anyOf/0/properties/spellcheck"
+                },
+                "images": {
+                    "$ref": "#/anyOf/0/properties/images"
                 }
             },
             "required": [
@@ -1776,6 +1790,9 @@
                 },
                 "spellcheck": {
                     "$ref": "#/anyOf/0/properties/spellcheck"
+                },
+                "images": {
+                    "$ref": "#/anyOf/0/properties/images"
                 }
             },
             "required": [

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

@@ -1,43 +0,0 @@
-// 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={"أحد المبادئ الأساسية في تطوير البرمجيات هو مبدأ DRY (Don't Repeat\nYourself). وهذا مبدأ ينطبق على التوثيق أيضًا.\nإذا وجدت نفسك تكرر المحتوى نفسه في عدة أماكن، ففكّر في إنشاء مقتطف\nمخصص (snippet) للحفاظ على content الخاص بك متزامنًا."} />;
-};
-
-export default SnippetIntro;