jamdesk 1.1.170 → 1.1.172

package/vendored/lib/preprocess-mdx.ts

@@ -9,36 +9,16 @@
 import { ASSET_PREFIX, appendAssetVersion } from './docs-types';
 import { convertDeprecatedComponents } from './deprecated-components';
 import { filterVisibility } from './visibility-filter';
+import {
+  applyJsxSyntaxFixes,
+  JSX_CONTENT_COMPONENTS,
+} from './mdx-syntax-fixes';
 import { logger } from '../shared/logger';
 
-/**
- * JSX components that contain markdown content requiring special preprocessing.
- * Used by ensureBlankLinesInJsx, normalizeJsxIndentation, and unindentJsxAfterListItems.
- */
-const JSX_CONTENT_COMPONENTS = [
-  'Card',
-  'Columns',
-  'Note',
-  'Warning',
-  'Tip',
-  'Info',
-  'Check',
-  'Danger',
-  'Accordion',
-  'AccordionGroup',
-  'Tab',
-  'Tabs',
-  'Step',
-  'Steps',
-  'Expandable',
-  'Update',
-  'Frame',
-  'Panel',
-  'View',
-  'Varning',
-  'Avertissement',
-  'Visibility',
-] as const;
+export {
+  unindentClosingTagAfterList,
+  unindentJsxAfterListItems,
+} from './mdx-syntax-fixes';
 
 // Match a fenced code block (``` or ~~~), used to mask code-block content
 // before scanning for top-level snippet imports — otherwise import lines
@@ -543,191 +523,6 @@ export function normalizeJsxIndentation(content: string): string {
   return result.join('\n');
 }
 
-/**
- * Un-indent a closing JSX tag absorbed into the previous markdown list item.
- *
- * Distinct from `unindentJsxAfterListItems` below: that one rewrites indented
- * *opening* tags inside list context. Here the opening tag is at root level
- * and only the closing tag is indented after the list — markdown reads it as
- * listItem continuation, so MDX compiles see the parent component as unclosed
- * ("Expected the closing tag `</Card>` either after the end of `listItem`...").
- *
- * CLI mirror: `builder/cli/src/lib/mdx-syntax-fixes.ts` — keep regex in sync.
- */
-export function unindentClosingTagAfterList(content: string): string {
-  // Hot-path prefilter — preprocessMdx runs on every page render, and most
-  // MDX has no indented closing tags at all. Skip the split+walk in that case.
-  if (!/^\s+<\/[A-Z]/m.test(content)) return content;
-
-  const closingTagPattern = /^(\s+)(<\/[A-Z][\w-]*>)\s*$/;
-  const listItemPattern = /^\s*(?:[-*+]\s|\d+\.\s)/;
-  const lines = content.split('\n');
-  const out: string[] = [];
-  let lastNonBlank = '';
-
-  for (const line of lines) {
-    const closing = line.match(closingTagPattern);
-    if (closing && listItemPattern.test(lastNonBlank)) {
-      out.push(closing[2]);
-      lastNonBlank = closing[2];
-      continue;
-    }
-    out.push(line);
-    if (line.trim() !== '') lastNonBlank = line;
-  }
-
-  return out.join('\n');
-}
-
-/**
- * Un-indent JSX blocks that follow markdown list items.
- *
- * In markdown, 4+ spaces of indentation after a list item creates a continuation
- * of that list item. When a JSX component like <Frame> is indented this way,
- * MDX cannot properly parse the JSX within the list item context.
- *
- * Error: "Expected a closing tag for `<Frame>` before the end of `listItem`"
- *
- * This function detects JSX blocks that are indented after list items and
- * removes the indentation to make them standalone blocks, not part of the list.
- *
- * Before:
- *   - **List item text**
- *
- *       <Frame>
- *           <iframe ...></iframe>
- *       </Frame>
- *
- * After:
- *   - **List item text**
- *
- *   <Frame>
- *       <iframe ...></iframe>
- *   </Frame>
- *
- * @param content - Raw MDX content
- * @returns Content with un-indented JSX blocks
- */
-export function unindentJsxAfterListItems(content: string): string {
-  const componentPattern = JSX_CONTENT_COMPONENTS.join('|');
-  const lines = content.split('\n');
-  const result: string[] = [];
-
-  // Track if we're in a list context (saw a list item recently)
-  let inListContext = false;
-  // Track the base indentation of JSX block we're un-indenting
-  let jsxBlockIndent = 0;
-  // Track if we're inside a JSX block that needs un-indenting
-  let unindentingJsxBlock = false;
-  let jsxBlockDepth = 0;
-  // Track which component we're inside
-  let currentComponent = '';
-
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const trimmed = line.trim();
-    const currentIndent = line.match(/^(\s*)/)?.[1].length ?? 0;
-
-    // Check if this is a list item (unordered or ordered)
-    const isListItem = /^[-*+]\s/.test(trimmed) || /^\d+\.\s/.test(trimmed);
-
-    if (isListItem) {
-      inListContext = true;
-      result.push(line);
-      continue;
-    }
-
-    // Blank lines don't exit list context
-    if (!trimmed) {
-      result.push(line);
-      continue;
-    }
-
-    // Check for JSX opening tag that's indented (4+ spaces) in list context
-    // Handle both single-line tags (<Frame>) and multi-line tags (<Card\n  title="...">)
-    const openingTagMatch = trimmed.match(
-      new RegExp(`^<(${componentPattern})(?:\\s|>|$|/>)`)
-    );
-
-    // Handle any indentation level > 0, not just 4+ spaces
-    // Nested list items use 2-space indentation, not 4-space
-    if (openingTagMatch && inListContext && currentIndent > 0 && !unindentingJsxBlock) {
-      // Start un-indenting this JSX block
-      unindentingJsxBlock = true;
-      jsxBlockIndent = currentIndent;
-      jsxBlockDepth = 1;
-      currentComponent = openingTagMatch[1];
-
-      // Check if it's a self-closing tag on this line
-      if (trimmed.endsWith('/>')) {
-        unindentingJsxBlock = false;
-        jsxBlockDepth = 0;
-        inListContext = false;
-      }
-
-      // If the previous line was NOT blank (JSX immediately follows list item text),
-      // insert a blank line to properly separate the JSX from the list context.
-      // This prevents "lazy line" errors in MDX parsing.
-      const prevLine = result.length > 0 ? result[result.length - 1] : '';
-      if (prevLine.trim() !== '') {
-        result.push('');
-      }
-
-      // Remove the indentation
-      result.push(trimmed);
-      continue;
-    }
-
-    // If we're un-indenting a JSX block, process the content
-    if (unindentingJsxBlock) {
-      // Check for nested opening tags of the same component
-      const nestedOpenMatch = trimmed.match(
-        new RegExp(`^<(${currentComponent})(?:\\s[^>]*)?>`)
-      );
-      if (nestedOpenMatch && !trimmed.endsWith('/>')) {
-        jsxBlockDepth++;
-      }
-
-      // Check for closing tag
-      const closingTagMatch = trimmed.match(
-        new RegExp(`^</(${currentComponent})>`)
-      );
-      if (closingTagMatch) {
-        jsxBlockDepth--;
-
-        if (jsxBlockDepth === 0) {
-          // End of the JSX block
-          unindentingJsxBlock = false;
-          inListContext = false;
-          currentComponent = '';
-          // Output the closing tag without indentation
-          result.push(trimmed);
-          continue;
-        }
-      }
-
-      // Remove the base indentation from all lines in the block
-      if (currentIndent >= jsxBlockIndent) {
-        const reducedIndent = currentIndent - jsxBlockIndent;
-        result.push(' '.repeat(reducedIndent) + trimmed);
-      } else {
-        result.push(trimmed);
-      }
-      continue;
-    }
-
-    // Only root-level (0 indent) non-blank content exits list context
-    // Content with any indentation could be nested list continuation
-    if (currentIndent === 0) {
-      inListContext = false;
-    }
-
-    result.push(line);
-  }
-
-  return result.join('\n');
-}
-
 /**
  * Props that can contain image paths in MDX content.
  * - src: standard HTML img and MDX Image components
@@ -1117,16 +912,8 @@ export function preprocessMdx(content: string, options?: { assetVersion?: string
   // Convert noStyle to data-no-style for React compatibility
   processed = convertNoStyleToDataAttr(processed);
 
-  // Un-indent absorbed closing tags FIRST — handles the case where the
-  // opening tag is at root level but the closing tag got indented after a
-  // list. unindentJsxAfterListItems below only catches cases where the
-  // opening tag itself is indented inside list context.
-  processed = unindentClosingTagAfterList(processed);
-
-  // Un-indent JSX blocks that follow list items to prevent
-  // "Expected closing tag before end of listItem" errors
-  // This must run BEFORE ensureBlankLinesInJsx since it changes block structure
-  processed = unindentJsxAfterListItems(processed);
+  // Repair list-adjacent JSX before blank-line and indentation normalization.
+  processed = applyJsxSyntaxFixes(processed);
 
   // Ensure blank lines around markdown block content inside JSX components
   // This must run BEFORE normalizeJsxIndentation since it needs original line structure

package/vendored/lib/prompt-source-codec.ts

@@ -0,0 +1,27 @@
+const BINARY_CHUNK_SIZE = 32 * 1024;
+
+export function encodePromptSource(source: string): string {
+  const bytes = new TextEncoder().encode(source);
+  let binary = '';
+
+  for (let offset = 0; offset < bytes.length; offset += BINARY_CHUNK_SIZE) {
+    binary += String.fromCharCode(
+      ...bytes.subarray(offset, offset + BINARY_CHUNK_SIZE),
+    );
+  }
+
+  return btoa(binary);
+}
+
+export function decodePromptSource(encoded: string): string {
+  try {
+    const binary = atob(encoded);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index++) {
+      bytes[index] = binary.charCodeAt(index);
+    }
+    return new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(bytes);
+  } catch {
+    return '';
+  }
+}

package/vendored/lib/render-doc-page.tsx

@@ -44,6 +44,7 @@ import { tryOpenApiCandidatesInParallel, makeTryOpenApiSpec, formatFallbackWarni
 import { computeHasCodePanels } from './render-doc-page-helpers';
 import { logger } from '../shared/logger';
 import { preprocessMdx, containsPanel, containsView, buildSnippetAliasMap } from '@/lib/preprocess-mdx';
+import { injectPromptSources } from '@/lib/inject-prompt-source';
 import { loadSnippetsForIsr } from '@/lib/snippet-loader-isr';
 import { PanelWrapper } from '@/components/mdx/PanelWrapper';
 import { ViewWrapper } from '@/components/mdx/View';
@@ -449,7 +450,9 @@ export async function renderDocPage(input: RenderInput): Promise<ReactElement> {
   let content = '';
   let preprocessError: string | null = null;
   try {
-    content = preprocessMdx(rawContent, { assetVersion: config.assetVersion });
+    content = preprocessMdx(injectPromptSources(rawContent), {
+      assetVersion: config.assetVersion,
+    });
   } catch (err) {
     preprocessError = err instanceof Error ? err.message : String(err);
     logger.warn(`[MDX] preprocess failed for ${pagePath}: ${preprocessError}`);

package/vendored/lib/snippet-loader-isr.ts

@@ -15,6 +15,7 @@ import { transform } from '@babel/standalone';
 import { fetchSnippet } from './r2-content';
 import { extractSnippetImports, normalizeSnippetPath } from './preprocess-mdx';
 import { filterVisibility } from './visibility-filter';
+import { injectPromptSources } from './inject-prompt-source';
 import { mdxSecurityOptions } from './mdx-security-options';
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -249,6 +250,7 @@ async function compilePlainMdxSnippet(
   source: string,
   builtInComponents: Record<string, AnyComponent>
 ): Promise<AnyComponent> {
+  source = injectPromptSources(source);
   const { compileMDX } = await import('next-mdx-remote/rsc');
   const { content } = await compileMDX({
     source,

package/vendored/lib/validate-config.ts

@@ -26,7 +26,7 @@ import { BUILD_SERVICE_DIR } from './paths.js';
 export interface DocsConfig {
   name: string;
   projectId?: string;
-  theme?: 'jam' | 'nebula' | 'pulsar';
+  theme?: 'jam' | 'nebula' | 'pulsar' | 'halo';
   navigation: NavigationConfig;
   integrations?: IntegrationsConfig;
   [key: string]: unknown;
@@ -169,7 +169,7 @@ export function parseConfig(content: string): DocsConfig {
 /**
  * Filter out noise from anyOf validation errors.
  *
- * The master schema uses a 3-branch anyOf (one per theme) and Ajv emits errors
+ * The master schema uses a 4-branch anyOf (one per theme) and Ajv emits errors
  * from every branch it tried, producing messages like `must be "nebula"` when
  * the user typed `theme: "jam"`. This helper:
  *
@@ -567,7 +567,7 @@ export async function validateConfig(
   }
 
   // Validate theme (case-insensitive — "MINT" still falls through to the Mintlify branch below).
-  const validThemes = ['jam', 'nebula', 'pulsar'];
+  const validThemes = ['jam', 'nebula', 'pulsar', 'halo'];
   if (typeof config.theme === 'string') {
     const themeLower = config.theme.toLowerCase();
     if (!validThemes.includes(themeLower)) {
@@ -581,7 +581,7 @@ export async function validateConfig(
       };
     }
     // Normalize so downstream Ajv schema (lowercase enum) accepts it.
-    config.theme = themeLower as 'jam' | 'nebula' | 'pulsar';
+    config.theme = themeLower as 'jam' | 'nebula' | 'pulsar' | 'halo';
   }
 
   if (legacyAnchors) {

package/vendored/schema/docs-schema.json

@@ -421,7 +421,7 @@
                         "top",
                         "left"
                     ],
-                    "description": "Controls where navigation tabs are displayed. `top` places tabs in the header bar, `left` places them at the top of the sidebar. Default depends on theme: jam/nebula default to `left`, pulsar defaults to `top`"
+                    "description": "Controls where navigation tabs are displayed. `top` places tabs in the header bar, `left` places them at the top of the sidebar. All themes default to `left`"
                 },
                 "anchors": {
                     "type": "array",
@@ -1956,6 +1956,127 @@
                 "navigation"
             ],
             "additionalProperties": false
+        },
+        {
+            "type": "object",
+            "properties": {
+                "theme": {
+                    "type": "string",
+                    "const": "halo"
+                },
+                "$schema": {
+                    "$ref": "#/anyOf/0/properties/$schema"
+                },
+                "projectId": {
+                    "$ref": "#/anyOf/0/properties/projectId"
+                },
+                "name": {
+                    "$ref": "#/anyOf/0/properties/name"
+                },
+                "description": {
+                    "$ref": "#/anyOf/0/properties/description"
+                },
+                "colors": {
+                    "$ref": "#/definitions/colorsSchema"
+                },
+                "logo": {
+                    "$ref": "#/anyOf/0/properties/logo"
+                },
+                "favicon": {
+                    "$ref": "#/anyOf/0/properties/favicon"
+                },
+                "api": {
+                    "$ref": "#/anyOf/0/properties/api"
+                },
+                "appearance": {
+                    "$ref": "#/anyOf/0/properties/appearance"
+                },
+                "background": {
+                    "$ref": "#/anyOf/0/properties/background"
+                },
+                "navbar": {
+                    "$ref": "#/anyOf/0/properties/navbar"
+                },
+                "tabsPosition": {
+                    "$ref": "#/anyOf/0/properties/tabsPosition"
+                },
+                "anchors": {
+                    "$ref": "#/anyOf/0/properties/anchors"
+                },
+                "navigation": {
+                    "$ref": "#/definitions/navigationSchema"
+                },
+                "footer": {
+                    "$ref": "#/anyOf/0/properties/footer"
+                },
+                "search": {
+                    "$ref": "#/anyOf/0/properties/search"
+                },
+                "seo": {
+                    "$ref": "#/anyOf/0/properties/seo"
+                },
+                "fonts": {
+                    "$ref": "#/anyOf/0/properties/fonts"
+                },
+                "icons": {
+                    "$ref": "#/anyOf/0/properties/icons"
+                },
+                "styling": {
+                    "$ref": "#/anyOf/0/properties/styling"
+                },
+                "redirects": {
+                    "$ref": "#/anyOf/0/properties/redirects",
+                    "description": "URL redirect rules for your documentation site. Each redirect maps a source path to a destination URL"
+                },
+                "integrations": {
+                    "$ref": "#/anyOf/0/properties/integrations"
+                },
+                "banner": {
+                    "$ref": "#/anyOf/0/properties/banner"
+                },
+                "errors": {
+                    "$ref": "#/anyOf/0/properties/errors"
+                },
+                "contextual": {
+                    "$ref": "#/anyOf/0/properties/contextual"
+                },
+                "thumbnails": {
+                    "$ref": "#/anyOf/0/properties/thumbnails"
+                },
+                "interaction": {
+                    "$ref": "#/anyOf/0/properties/interaction"
+                },
+                "metadata": {
+                    "$ref": "#/anyOf/0/properties/metadata"
+                },
+                "chat": {
+                    "$ref": "#/anyOf/0/properties/chat"
+                },
+                "analytics": {
+                    "$ref": "#/anyOf/0/properties/analytics"
+                },
+                "modeToggle": {
+                    "$ref": "#/anyOf/0/properties/modeToggle"
+                },
+                "layout": {
+                    "$ref": "#/anyOf/0/properties/layout"
+                },
+                "spellcheck": {
+                    "$ref": "#/anyOf/0/properties/spellcheck"
+                },
+                "auth": {
+                    "$ref": "#/anyOf/0/properties/auth"
+                },
+                "images": {
+                    "$ref": "#/anyOf/0/properties/images"
+                }
+            },
+            "required": [
+                "theme",
+                "name",
+                "navigation"
+            ],
+            "additionalProperties": false
         }
     ],
     "definitions": {