jamdesk 1.1.49 → 1.1.50

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

@@ -0,0 +1,595 @@
+// Header-free render path for documentation pages. Called from
+// `app/[[...slug]]/page.tsx` only; this module and its imports do not
+// touch `next/headers` so the page can pass header data in (or null) and
+// drive base-URL resolution explicitly.
+//
+// Caller contract (both branches live in the catch-all page):
+//   - Header-resolved branch (middleware-set `x-project-slug`): passes
+//     `requestHeaders` so `resolveBaseUrl` derives a forwarded-host
+//     canonical.
+//   - `projectFromParams` branch (direct `/[project]/...` URLs and
+//     non-ISR local dev): passes `requestHeaders=null` and gets a
+//     subdomain-canonical via `getBaseUrlFromConfig`.
+import { notFound } from 'next/navigation';
+import { MDXRemote } from 'next-mdx-remote/rsc';
+import type { Metadata } from 'next';
+import type { ReactElement } from 'react';
+import { MDXComponents } from '@/components/mdx/MDXComponents';
+import { Breadcrumb } from '@/components/navigation/Breadcrumb';
+import { TableOfContents } from '@/components/navigation/TableOfContents';
+import { PageColumns } from '@/components/layout/PageColumns';
+import { PageNavigation } from '@/components/navigation/PageNavigation';
+import { SocialFooter } from '@/components/navigation/SocialFooter';
+import { ApiPageWrapper } from '@/components/mdx/ApiPage';
+import { OpenApiEndpoint } from '@/components/mdx/OpenApiEndpoint';
+import { OpenApiError } from '@/components/openapi/OpenApiError';
+import { getHighlighter } from '@/lib/shiki-highlighter';
+import { createShikiRehypePlugin } from '@/lib/shiki-config';
+import rehypeSlug from 'rehype-slug';
+import remarkGfm from 'remark-gfm';
+import { rehypeCodeMeta, rehypeRestoreDataTitle } from '@/lib/rehype-code-meta';
+import { rehypeClassToClassName } from '@/lib/rehype-class-to-classname';
+import { rehypeNoZoomToData } from '@/lib/rehype-nozoom-to-data';
+import { preprocessMdx, containsPanel, containsView, buildSnippetAliasMap } from '@/lib/preprocess-mdx';
+import { loadSnippetsForIsr } from '@/lib/snippet-loader-isr';
+import { PanelWrapper } from '@/components/mdx/PanelWrapper';
+import { ViewWrapper } from '@/components/mdx/View';
+import { getLatexRemarkPlugins, getLatexRehypePlugins } from '@/lib/latex-config';
+import { getTypographyRemarkPlugins } from '@/lib/typography-config';
+import { remarkVisibility } from '@/lib/remark-visibility';
+import { recmaCompoundComponents } from '@/lib/recma-compound-components';
+import { extractInlineComponents } from '@/lib/process-mdx-with-exports';
+import { extractHeadings } from '@/lib/heading-extractor';
+import { StepSlugProvider, type StepSlugEntry } from '@/components/mdx/StepSlugContext';
+import { buildEndpointFromMdx } from '@/lib/build-endpoint-from-mdx';
+import { mdxSecurityOptions } from '@/lib/mdx-security-options';
+import { getContentDir } from '@/lib/docs';
+import type { DocsConfig } from '@/lib/docs-types';
+import { buildSeoMetadata, generateAutoDescription, buildSiteTitle } from '@/lib/seo';
+import { buildJsonLd } from '@/lib/json-ld';
+import {
+  getContentLoader,
+  isIsrMode,
+  normalizeSlugForContent,
+  parseFrontmatter,
+  projectExists,
+} from '@/lib/content-loader';
+import { getBaseUrl, getBaseUrlFromConfig, pathToSlug } from '@/lib/page-isr-helpers';
+import {
+  parseOpenApiFrontmatter,
+  getCachedSpec,
+  parseEndpoint,
+  generateCodeExamples,
+  formatOpenApiWarning,
+  deriveAuthFromSecurity,
+  type OpenApiEndpointData,
+  type CodeExample,
+  type AuthMethod,
+} from '@/lib/openapi';
+import { classifyOpenApiLoadError } from '@/lib/openapi/classify-load-error';
+import { extractLanguageFromPath, isValidLanguageCode } from '@/lib/language-utils';
+import { findFirstNavPage } from '@/lib/find-first-nav-page';
+import { candidateSpecPaths } from '@/lib/openapi/lang-spec-path';
+import { ApiEndpoint } from '@/components/mdx/ApiEndpoint';
+import { ImagePriorityProvider } from '@/components/mdx/ImagePriorityProvider';
+import { AIActionsMenu } from '@/components/AIActionsMenu';
+import { getContextualOptions } from '@/lib/contextual-defaults';
+import { SnippetComponents } from '@/components/snippets/ProjectSnippets';
+
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | 'TRACE';
+
+const DEFAULT_SITE_URL = 'https://docs.example.com';
+
+export interface RenderInput {
+  slug: string[];
+  projectSlug: string | null;
+  hostAtDocs: boolean;
+  requestHeaders: Headers | null;
+}
+
+interface FrontmatterData {
+  title?: string;
+  description?: string;
+  api?: string;
+  openapi?: string;
+  playground?: string;
+  mode?: string;
+  hideFooter?: boolean;
+  rss?: boolean;
+  [key: string]: unknown;
+}
+
+function parseMdxApiField(apiField: string): { method: HttpMethod; path: string } | null {
+  if (!apiField || typeof apiField !== 'string') return null;
+  const trimmed = apiField.trim();
+  const methods: HttpMethod[] = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS', 'TRACE'];
+  for (const method of methods) {
+    if (trimmed.toUpperCase().startsWith(method)) {
+      const path = trimmed.slice(method.length).trim();
+      return { method, path };
+    }
+  }
+  return null;
+}
+
+function resolveBaseUrl(
+  requestHeaders: Headers | null,
+  projectSlug: string | null,
+  hostAtDocs: boolean,
+): string {
+  if (!projectSlug) return process.env.SITE_URL || DEFAULT_SITE_URL;
+  if (requestHeaders) return getBaseUrl(requestHeaders, projectSlug, hostAtDocs);
+  return getBaseUrlFromConfig(projectSlug, hostAtDocs);
+}
+
+function resolveAuth(
+  endpoint: OpenApiEndpointData | null | undefined,
+  config: DocsConfig,
+): { method?: AuthMethod; headerName?: string } {
+  const override = config.api?.mdx?.auth;
+  if (override?.method) {
+    return { method: override.method, headerName: override.name };
+  }
+  return endpoint ? deriveAuthFromSecurity(endpoint.security) : {};
+}
+
+function findFirstPage(config: DocsConfig, lang?: string): string {
+  const nav = config.navigation;
+  const langBlock = lang ? nav.languages?.find((l) => l.language === lang) : undefined;
+  const result = (langBlock && findFirstNavPage(langBlock)) || findFirstNavPage(nav);
+  return result ? result.replace(/^\//, '') : 'introduction';
+}
+
+function needsSlugRewrite(slug: string[]): boolean {
+  return slug.length === 0 || (slug.length === 1 && isValidLanguageCode(slug[0]));
+}
+
+function resolveSlug(normalizedSlug: string[], config: DocsConfig): string[] {
+  if (normalizedSlug.length === 0) return pathToSlug(findFirstPage(config));
+  if (normalizedSlug.length === 1 && isValidLanguageCode(normalizedSlug[0])) {
+    return pathToSlug(findFirstPage(config, normalizedSlug[0]));
+  }
+  return normalizedSlug;
+}
+
+export async function buildDocMetadata(input: RenderInput): Promise<Metadata> {
+  const { slug: slugInput, projectSlug, hostAtDocs, requestHeaders } = input;
+
+  if (isIsrMode()) {
+    if (!projectSlug) return { title: 'Not Found' };
+    const exists = await projectExists(projectSlug);
+    if (!exists) return { title: 'Not Found' };
+  }
+
+  const loader = getContentLoader(projectSlug ?? undefined);
+  const configP = loader.getConfig();
+
+  const normalizedSlug = normalizeSlugForContent(slugInput || [], hostAtDocs);
+  const slug = needsSlugRewrite(normalizedSlug)
+    ? resolveSlug(normalizedSlug, await configP)
+    : normalizedSlug;
+  const isRoot = normalizedSlug.length === 0;
+  const pagePath = slug.join('/');
+
+  const [fileContents, config] = await Promise.all([
+    loader.getContent(pagePath).catch(() => null),
+    configP,
+  ]);
+
+  if (!fileContents) {
+    return { title: 'Not Found' };
+  }
+
+  const parsed = parseFrontmatter(fileContents);
+  const data = parsed.data as FrontmatterData;
+
+  if (!data.description) {
+    data.description = generateAutoDescription(parsed.content);
+  }
+
+  const baseUrl = resolveBaseUrl(requestHeaders, projectSlug, hostAtDocs);
+  const languages = config.navigation?.languages;
+
+  const seoMetadata = buildSeoMetadata(config, data, pagePath, baseUrl, languages);
+
+  const titleValue = data.title
+    ? (data.title === config.name ? { absolute: data.title } : data.title)
+    : { absolute: buildSiteTitle(config.name) };
+
+  return {
+    title: titleValue,
+    description: data.description || '',
+    ...seoMetadata,
+    ...(isRoot && { robots: { index: false, follow: true } }),
+    ...(data.rss ? {
+      alternates: {
+        ...seoMetadata.alternates,
+        types: {
+          'application/rss+xml': hostAtDocs ? '/docs/feed.xml' : '/feed.xml',
+        },
+      },
+    } : {}),
+  };
+}
+
+export async function renderDocPage(input: RenderInput): Promise<ReactElement> {
+  const { slug: slugInput, projectSlug, hostAtDocs, requestHeaders } = input;
+
+  if (isIsrMode()) {
+    if (!projectSlug) notFound();
+    const exists = await projectExists(projectSlug);
+    if (!exists) notFound();
+  }
+
+  const loader = getContentLoader(projectSlug ?? undefined);
+  const configP = loader.getConfig();
+
+  const normalizedSlug = normalizeSlugForContent(slugInput || [], hostAtDocs);
+  const slug = needsSlugRewrite(normalizedSlug)
+    ? resolveSlug(normalizedSlug, await configP)
+    : normalizedSlug;
+  const pagePath = slug.join('/');
+  const currentLang = extractLanguageFromPath(`/${pagePath}`);
+  const [fileContents, config] = await Promise.all([
+    loader.getContent(pagePath).catch(() => null),
+    configP,
+  ]);
+
+  if (!fileContents) {
+    notFound();
+  }
+
+  const parsed = parseFrontmatter(fileContents);
+  const data = parsed.data as FrontmatterData;
+  const rawContent = parsed.content;
+
+  const baseUrl = resolveBaseUrl(requestHeaders, projectSlug, hostAtDocs);
+  const jsonLd = buildJsonLd({
+    config,
+    pagePath,
+    pageTitle: data.title || pagePath,
+    baseUrl,
+  });
+  const jsonLdScript = renderJsonLdScript(jsonLd);
+
+  const highlighter = await getHighlighter();
+
+  let snippetAliases: Record<string, React.ComponentType<unknown>> = {};
+  if (isIsrMode() && projectSlug) {
+    snippetAliases = await loadSnippetsForIsr(projectSlug, rawContent, MDXComponents);
+  } else {
+    snippetAliases = buildSnippetAliasMap(rawContent, SnippetComponents);
+  }
+
+  const content = preprocessMdx(rawContent, { assetVersion: config.assetVersion });
+
+  const stepEntries: StepSlugEntry[] = extractHeadings(content)
+    .filter(h => typeof h.stepNumber === 'number')
+    .map(h => ({ title: h.text, slug: h.id }));
+
+  const { inlineComponents, paramFields } = await extractInlineComponents(content, MDXComponents);
+
+  const overriddenComponents = Object.keys(inlineComponents).filter(
+    (name) => name in MDXComponents,
+  );
+  if (overriddenComponents.length > 0) {
+    console.warn(
+      `[MDX] Inline component(s) override built-in: ${overriddenComponents.join(', ')} in ${slug.join('/')}`,
+    );
+  }
+
+  const AllComponentsWithInline = {
+    ...MDXComponents,
+    ...SnippetComponents,
+    ...snippetAliases,
+    ...inlineComponents,
+    ...(hostAtDocs ? {
+      a: ({ ariaLabel, href, ...props }: any) => {
+        const needsPrefix = href?.startsWith('/') && !href.startsWith('/docs/') && href !== '/docs';
+        return (
+          <a
+            className="text-theme-accent hover:text-theme-accent-hover transition-colors"
+            aria-label={ariaLabel}
+            href={needsPrefix ? `/docs${href}` : href}
+            {...props}
+          />
+        );
+      },
+    } : {}),
+  };
+
+  const isApiPage = !!data.api || !!data.openapi;
+  const isWideMode = data.mode === 'wide';
+  const hasPanel = containsPanel(content);
+  const hasView = containsView(content);
+
+  let openApiEndpointData: OpenApiEndpointData | null = null;
+  let openApiCodeExamples: CodeExample[] | null = null;
+  let openApiError: string | null = null;
+
+  let lastFailure: { err: unknown; specPath: string } | null = null;
+  if (data.openapi && typeof data.openapi === 'string') {
+    try {
+      const openApiConfig = config.api?.openapi;
+      const allSpecPaths: string[] = typeof openApiConfig === 'string'
+        ? [openApiConfig]
+        : Array.isArray(openApiConfig)
+          ? openApiConfig
+          : [];
+
+      const parsed = parseOpenApiFrontmatter(
+        data.openapi,
+        allSpecPaths.length > 0 ? allSpecPaths : undefined,
+      );
+
+      const baseSpecs = parsed.isShortFormat && allSpecPaths.length > 1
+        ? allSpecPaths
+        : [parsed.specPath];
+      const specsToTry = baseSpecs.flatMap(p => candidateSpecPaths(p, currentLang));
+
+      const useIsr = isIsrMode() && !!projectSlug;
+      const resolveSpec = useIsr
+        ? (await import('@/lib/openapi-isr')).resolveOpenApiSpec
+        : null;
+      const contentDir = useIsr ? null : getContentDir();
+
+      for (let i = 0; i < specsToTry.length; i++) {
+        const specPath = specsToTry[i];
+        try {
+          if (resolveSpec && projectSlug) {
+            const spec = await resolveSpec(projectSlug, specPath);
+            openApiEndpointData = parseEndpoint(
+              spec as Parameters<typeof parseEndpoint>[0],
+              parsed.method,
+              parsed.path,
+              specPath,
+            );
+          } else {
+            const { api } = await getCachedSpec(specPath, contentDir!);
+            openApiEndpointData = parseEndpoint(api, parsed.method, parsed.path, specPath);
+          }
+          lastFailure = null;
+          break;
+        } catch (err) {
+          lastFailure = { err, specPath };
+          const isLast = i === specsToTry.length - 1;
+          if (!isLast) {
+            console.warn(
+              `[openapi] spec candidate "${specPath}" failed; trying next: ${(err as Error).message}`,
+            );
+          }
+        }
+      }
+
+      if (lastFailure) throw lastFailure.err;
+
+      if (openApiEndpointData) {
+        const { method: authMethod, headerName: authHeaderName } = resolveAuth(openApiEndpointData, config);
+        const languages = config.api?.examples?.languages;
+        openApiCodeExamples = generateCodeExamples(openApiEndpointData, { authMethod, authHeaderName, languages });
+      }
+    } catch (err) {
+      const typed = classifyOpenApiLoadError(err, lastFailure?.specPath ?? null);
+      console.warn(formatOpenApiWarning(typed));
+      openApiError = typed.suggestion
+        ? `${typed.message} — ${typed.suggestion}`
+        : typed.message;
+    }
+  }
+
+  let mdxApiMethod: HttpMethod | null = null;
+  let mdxApiPath: string | null = null;
+  if (data.api && typeof data.api === 'string' && !data.openapi) {
+    const parsed = parseMdxApiField(data.api);
+    if (parsed) {
+      mdxApiMethod = parsed.method;
+      mdxApiPath = parsed.path;
+    }
+  }
+
+  const rssIcon = data.rss ? (
+    <a
+      href={hostAtDocs ? '/docs/feed.xml' : '/feed.xml'}
+      target="_blank"
+      rel="noopener noreferrer"
+      aria-label="Subscribe to RSS feed"
+      title="RSS feed"
+      className="flex-shrink-0 text-[var(--color-text-muted)] hover:text-[var(--color-primary)] transition-colors cursor-pointer"
+    >
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" className="w-5 h-5">
+        <circle cx="6.18" cy="17.82" r="2.18" />
+        <path d="M4 4.44v2.83c7.03 0 12.73 5.7 12.73 12.73h2.83c0-8.59-6.97-15.56-15.56-15.56zm0 5.66v2.83c3.9 0 7.07 3.17 7.07 7.07h2.83c0-5.47-4.43-9.9-9.9-9.9z" />
+      </svg>
+    </a>
+  ) : null;
+
+  const contextualOptions = getContextualOptions(config);
+  const hasAiActions = contextualOptions.length > 0;
+
+  const proseClasses = 'prose max-w-none';
+
+  const hasApiEndpoint = openApiEndpointData || (mdxApiMethod && mdxApiPath);
+  const playgroundDisplay = hasApiEndpoint
+    ? ((data.playground as 'interactive' | 'simple' | 'none' | undefined)
+        || config.api?.playground?.display || 'interactive') as 'interactive' | 'simple' | 'none'
+    : 'none';
+  const mdxServerConfig = config.api?.mdx?.server;
+  const fallbackServerUrl = Array.isArray(mdxServerConfig) ? mdxServerConfig[0] : mdxServerConfig;
+  const proxyEnabled = hostAtDocs
+    || config.api?.playground?.proxy
+    || (config.api?.playground?.proxy == null && playgroundDisplay === 'interactive');
+
+  let mdxEndpointData: OpenApiEndpointData | undefined;
+  if (!openApiEndpointData && mdxApiMethod && mdxApiPath && playgroundDisplay !== 'none') {
+    mdxEndpointData = buildEndpointFromMdx(mdxApiMethod, mdxApiPath, paramFields, fallbackServerUrl);
+  }
+
+  const resolvedMdxAuth = resolveAuth(mdxEndpointData, config);
+  const resolvedOpenApiAuth = resolveAuth(openApiEndpointData, config);
+
+  if (isApiPage) {
+    return (
+      <>{jsonLdScript}<ApiPageWrapper>
+        <article className="px-4 sm:px-6 lg:px-8 py-6 sm:py-10 flex-1 min-w-0">
+          <Breadcrumb slug={slug} config={config} />
+
+          {data.title && (
+            <header className="mb-4 sm:mb-6">
+              <div className="flex items-center gap-3">
+                <h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold text-theme-text-primary tracking-tight">
+                  {data.title}
+                </h1>
+                {rssIcon}
+                {hasAiActions && <div className="ml-auto flex-shrink-0 hidden sm:block"><AIActionsMenu options={contextualOptions} projectName={config.name} /></div>}
+              </div>
+              {data.description && (
+                <p className="text-base sm:text-lg text-theme-text-secondary leading-relaxed mt-2 sm:mt-3">
+                  {data.description}
+                </p>
+              )}
+              {hasAiActions && <div className="mt-3 sm:hidden" style={{ paddingLeft: 0 }}><AIActionsMenu options={contextualOptions} projectName={config.name} /></div>}
+            </header>
+          )}
+
+          <div className={proseClasses}>
+            {mdxApiMethod && mdxApiPath && (
+              mdxEndpointData && playgroundDisplay !== 'none' ? (
+                <OpenApiEndpoint
+                  endpoint={mdxEndpointData}
+                  playgroundOnly
+                  playgroundDisplay={playgroundDisplay}
+                  authMethod={resolvedMdxAuth.method}
+                  authHeaderName={resolvedMdxAuth.headerName}
+                  serverUrl={fallbackServerUrl}
+                  proxyEnabled={proxyEnabled}
+                  languages={config.api?.examples?.languages}
+                />
+              ) : (
+                <ApiEndpoint
+                  method={mdxApiMethod}
+                  path={mdxApiPath}
+                  baseUrl={fallbackServerUrl}
+                />
+              )
+            )}
+
+            {openApiEndpointData && (
+              <OpenApiEndpoint
+                endpoint={openApiEndpointData}
+                codeExamples={openApiCodeExamples || undefined}
+                playgroundDisplay={playgroundDisplay}
+                authMethod={resolvedOpenApiAuth.method}
+                authHeaderName={resolvedOpenApiAuth.headerName}
+                serverUrl={fallbackServerUrl}
+                proxyEnabled={proxyEnabled}
+                languages={config.api?.examples?.languages}
+              />
+            )}
+
+            {!openApiEndpointData && openApiError && (
+              <OpenApiError message={openApiError} slug={slug.join('/')} />
+            )}
+
+            <ImagePriorityProvider>
+              <StepSlugProvider entries={stepEntries}>
+                <MDXRemote
+                  source={openApiEndpointData
+                    ? content.replace(/<ResponseExample>[\s\S]*?<\/ResponseExample>/g, '')
+                    : content}
+                  components={AllComponentsWithInline}
+                  options={{
+                    ...mdxSecurityOptions,
+                    mdxOptions: {
+                      remarkPlugins: [remarkGfm, [remarkVisibility, { audience: 'humans' }], ...getTypographyRemarkPlugins(config), ...getLatexRemarkPlugins(config)],
+                      rehypePlugins: [rehypeNoZoomToData, rehypeClassToClassName, rehypeCodeMeta, createShikiRehypePlugin(highlighter, config), rehypeRestoreDataTitle, ...getLatexRehypePlugins(config), rehypeSlug],
+                      recmaPlugins: [recmaCompoundComponents],
+                    },
+                  }}
+                />
+              </StepSlugProvider>
+            </ImagePriorityProvider>
+          </div>
+
+          <PageNavigation currentSlug={slug.join('/')} config={config} />
+          <SocialFooter config={config} hidden={data.hideFooter} projectSlug={projectSlug ?? undefined} />
+        </article>
+      </ApiPageWrapper></>
+    );
+  }
+
+  const mdxContent = (
+    <StepSlugProvider entries={stepEntries}>
+      <MDXRemote
+        source={content}
+        components={AllComponentsWithInline}
+        options={{
+          ...mdxSecurityOptions,
+          mdxOptions: {
+            remarkPlugins: [remarkGfm, [remarkVisibility, { audience: 'humans' }], ...getTypographyRemarkPlugins(config), ...getLatexRemarkPlugins(config)],
+            rehypePlugins: [rehypeNoZoomToData, rehypeClassToClassName, rehypeCodeMeta, createShikiRehypePlugin(highlighter, config), rehypeRestoreDataTitle, ...getLatexRehypePlugins(config), rehypeSlug],
+            recmaPlugins: [recmaCompoundComponents],
+          },
+        }}
+      />
+    </StepSlugProvider>
+  );
+
+  const articleContent = (
+    <article className="px-4 sm:px-6 lg:px-8 py-6 sm:py-10">
+      <Breadcrumb slug={slug} config={config} />
+
+      {data.title && (
+        <header className="mb-6 sm:mb-10">
+          <div className="flex items-center gap-3">
+            <h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold text-theme-text-primary tracking-tight">
+              {data.title}
+            </h1>
+            {rssIcon}
+            {hasAiActions && <div className="ml-auto flex-shrink-0 hidden sm:block"><AIActionsMenu options={contextualOptions} projectName={config.name} /></div>}
+          </div>
+          {data.description && (
+            <p className="text-base sm:text-lg text-theme-text-secondary leading-relaxed mt-2 sm:mt-3">
+              {data.description}
+            </p>
+          )}
+          {hasAiActions && <div className="mt-3 sm:hidden" style={{ paddingLeft: 0 }}><AIActionsMenu options={contextualOptions} projectName={config.name} /></div>}
+        </header>
+      )}
+
+      <div className={proseClasses}>
+        <ImagePriorityProvider>
+          {hasView ? <ViewWrapper>{mdxContent}</ViewWrapper> : mdxContent}
+        </ImagePriorityProvider>
+
+        <PageNavigation currentSlug={slug.join('/')} config={config} isWideMode={isWideMode || hasPanel} />
+      </div>
+      <SocialFooter config={config} hidden={data.hideFooter} projectSlug={projectSlug ?? undefined} />
+    </article>
+  );
+
+  if (hasPanel) {
+    return <>{jsonLdScript}<PanelWrapper>{articleContent}</PanelWrapper></>;
+  }
+
+  return (
+    <>
+      {jsonLdScript}
+      <PageColumns toc={<TableOfContents content={content} />} isWideMode={isWideMode}>
+        {articleContent}
+      </PageColumns>
+    </>
+  );
+}
+
+// Inline JSON-LD for SEO. The `<` escape is the documented Next.js
+// XSS-safe pattern (see app/layout.tsx and marketing/blog/[slug]/page.tsx).
+// Trusted source: built from project config + page metadata, never user MDX.
+function renderJsonLdScript(jsonLd: unknown): ReactElement {
+  const safe = JSON.stringify(jsonLd).replace(/</g, '\\u003c');
+  return (
+    <script
+      type="application/ld+json"
+      dangerouslySetInnerHTML={{ __html: safe }}
+    />
+  );
+}

package/vendored/lib/seo.ts

@@ -9,6 +9,7 @@
 
 import type { Metadata } from 'next';
 import type { DocsConfig, Logo, LogoConfig, Favicon, FaviconConfig, LanguageConfig, LanguageCode } from './docs-types';
+import { transformConfigImagePath } from './docs-types';
 import { transformLanguagePath, extractLanguageFromPath, isValidLanguageCode } from './language-utils';
 
 const HAS_DOCS_SUFFIX = /\b(?:Documentation|Docs)\s*$/i;
@@ -23,6 +24,26 @@ export function buildSiteTitle(configName: string): string {
     : `${configName} Documentation`;
 }
 
+/**
+ * Resolve a Favicon config (string | { light, dark }) to a single asset
+ * path through the /_jd/ pipeline. Returns undefined when no favicon is
+ * configured — no default Jamdesk favicon is injected.
+ */
+export function getFaviconPath(
+  favicon: Favicon | undefined,
+  assetVersion?: string,
+): string | undefined {
+  if (!favicon) return undefined;
+  const raw = typeof favicon === 'string' ? favicon : favicon.light;
+  return transformConfigImagePath(raw, assetVersion) || undefined;
+}
+
+/** Metadata used when the project can't be resolved or its config is missing. */
+export const FALLBACK_METADATA: Metadata = {
+  title: { template: '%s — Documentation', default: 'Documentation' },
+  description: 'Documentation',
+};
+
 /** Resolve a Logo or Favicon config to a path string, preferring light variant. */
 function resolveImagePath(image?: Logo | Favicon): string {
   if (!image) return '';

package/vendored/workspace-package-lock.json

@@ -2301,12 +2301,12 @@
       }
     },
     "node_modules/chevrotain-allstar": {
-      "version": "0.4.1",
-      "resolved": "https://registry.npmjs.org/chevrotain-allstar/-/chevrotain-allstar-0.4.1.tgz",
-      "integrity": "sha512-PvVJm3oGqrveUVW2Vt/eZGeiAIsJszYweUcYwcskg9e+IubNYKKD+rHHem7A6XVO22eDAL+inxNIGAzZ/VIWlA==",
+      "version": "0.4.3",
+      "resolved": "https://registry.npmjs.org/chevrotain-allstar/-/chevrotain-allstar-0.4.3.tgz",
+      "integrity": "sha512-2X4mkroolSMKqW+H22pyPMUVDqYZzPhephTmg/NODKb1IGYPHfxfhcW0EjS7wcPJNbze2i4vBWT7zT5FKF2lrQ==",
       "license": "MIT",
       "dependencies": {
-        "lodash-es": "^4.17.21"
+        "lodash-es": "^4.18.1"
       },
       "peerDependencies": {
         "chevrotain": "^12.0.0"
@@ -2980,9 +2980,9 @@
       "license": "MIT"
     },
     "node_modules/electron-to-chromium": {
-      "version": "1.5.344",
-      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.344.tgz",
-      "integrity": "sha512-4MxfbmNDm+KPh066EZy+eUnkcDPcZ35wNmOWzFuh/ijvHsve6kbLTLURy88uCNK5FbpN+yk2nQY6BYh1GEt+wg==",
+      "version": "1.5.345",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.345.tgz",
+      "integrity": "sha512-F9JXQGiMrz6yVNPI2qOVPvB9HzjH5cGzhs8oJ6A28V5L/YnzN/0KsuiibqF+F1Fd9qxFzD1BUnYSd8JfULxTwg==",
       "license": "ISC"
     },
     "node_modules/enhanced-resolve": {