jamdesk 1.1.211 → 1.1.213

package/vendored/components/navigation/SocialFooter.tsx

@@ -3,9 +3,7 @@
 import type { CSSProperties } from 'react';
 import type { DocsConfig, SocialPlatform, FooterLinkColumn } from '@/lib/docs-types';
 import { getIconClass } from '@/lib/icon-utils';
-import { getBrandingUrl } from '@/lib/branding-url';
-
-const showBranding = process.env.NEXT_PUBLIC_SHOW_BRANDING !== 'false';
+import { getBrandingUrl, isBrandingVisible } from '@/lib/branding-url';
 
 // Wordmark renders as a CSS mask so its fill inherits `currentColor`, letting
 // the link's text color (and hover state) drive the SVG color in one place.
@@ -149,9 +147,8 @@ function SocialIcons({ socials }: { socials: Partial<Record<SocialPlatform, stri
 }
 
 /** "Powered by Jamdesk" attribution link, shared by the full footer and the
- *  embed footer. Renders nothing when branding is disabled at build time. */
+ *  embed footer. Callers decide whether to render it (isBrandingVisible). */
 function BrandingLink({ projectSlug }: { projectSlug?: string }) {
-  if (!showBranding) return null;
   return (
     <a
       href={getBrandingUrl(projectSlug)}
@@ -171,6 +168,8 @@ function BrandingLink({ projectSlug }: { projectSlug?: string }) {
 }
 
 export function SocialFooter({ config, hidden, projectSlug, embed }: SocialFooterProps) {
+  const showBranding = isBrandingVisible(config);
+
   // Embed render (widget modal): keep ONLY the "Powered by Jamdesk" attribution.
   // The link columns + social icons read as out of place inside an embedded
   // changelog; the attribution stays even when the normal footer is hidden,
@@ -202,7 +201,7 @@ export function SocialFooter({ config, hidden, projectSlug, embed }: SocialFoote
       {hasLinks && <LinkColumns columns={links} />}
       <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-4">
         {hasSocials && <SocialIcons socials={socials} />}
-        <BrandingLink projectSlug={projectSlug} />
+        {showBranding && <BrandingLink projectSlug={projectSlug} />}
       </div>
     </footer>
   );

package/vendored/components/navigation/ThemePreviewChips.tsx

@@ -4,7 +4,8 @@ import { useId, useState } from 'react';
 import { useLinkPrefix } from '@/lib/link-prefix-context';
 import { useThemePreview } from '@/lib/theme-preview-context';
 import { applyThemePreview, type ThemePreviewSurface } from '@/lib/theme-preview-client';
-import { getAllThemes, type ThemeName } from '@/themes';
+import { getPreviewThemes } from '@/lib/theme-preview';
+import type { ThemeName } from '@/themes';
 
 /**
  * Jamdesk-only affordance: re-skins jamdesk.com/docs with any built-in theme
@@ -52,7 +53,7 @@ export function ThemePreviewChips() {
     applyThemePreview(name, { linkPrefix, surface });
   }
 
-  const themes = getAllThemes();
+  const themes = getPreviewThemes();
   const previewing = activeTheme !== defaultTheme;
   const activeName = themes.find((t) => t.name === activeTheme)?.displayName ?? activeTheme;
 

package/vendored/lib/branding-url.ts

@@ -7,3 +7,12 @@ export function getBrandingUrl(projectSlug?: string | null): string {
   );
   return `https://www.jamdesk.com?utm_campaign=poweredBy&utm_medium=referral&utm_source=${slug}`;
 }
+
+/** Whether to show "Powered by Jamdesk". The build writes `_showBranding: false`
+ *  into the site config only when the owner hid it, so a missing setting (an
+ *  older build, local preview) or a missing config keeps the badge. */
+export function isBrandingVisible(
+  config: { _showBranding?: boolean } | null | undefined,
+): boolean {
+  return config?._showBranding !== false;
+}

package/vendored/lib/build/error-parser.ts

@@ -262,7 +262,7 @@ export function parseErrorDetails(
     const requiredFields =
       'Required fields:\n' +
       '• "name": Your site name\n' +
-      '• "theme": One of "jam", "nebula", "pulsar", or "halo"\n' +
+      '• "theme": One of "jam", "nebula", "pulsar", "halo", or "dusk"\n' +
       '• "colors": { "primary": "#hexcolor" }\n' +
       '• "navigation": one of "tabs", "groups", "pages", "dropdowns", ' +
       '"versions", "languages", or "products" ' +

package/vendored/lib/docs-types.ts

@@ -23,7 +23,7 @@ export const ASSET_PREFIX = '/_jd';
 /**
  * Available themes
  */
-export type ThemeName = 'jam' | 'nebula' | 'pulsar' | 'halo';
+export type ThemeName = 'jam' | 'nebula' | 'pulsar' | 'halo' | 'dusk';
 
 // =============================================================================
 // ICON TYPES
@@ -973,6 +973,10 @@ export interface DocsConfig {
   _hasCustomCss?: boolean;
   _hasCustomJs?: boolean;
 
+  // Set by the build to `false` only when the owner hid "Powered by Jamdesk"
+  // (paid plans). Absent means shown. Read by isBrandingVisible.
+  _showBranding?: boolean;
+
   // Runtime: Set by ISR middleware based on project config
   // When true, all navigation links should be prefixed with /docs
   hostAtDocs?: boolean;

package/vendored/lib/dusk-embargo.ts

@@ -0,0 +1,16 @@
+/**
+ * Dusk launch embargo — flip to `true` on October 1, 2026.
+ *
+ * One of four twins (build-service, CLI, dashboard, marketing); separate apps
+ * with separate deploys, so they cannot share a module. Flip all four in one
+ * commit. See docs/plans/2026-09-23-dusk-october-1-release-plan.md.
+ *
+ * Here it gates the jamdesk-docs theme picker, which lists every registry
+ * theme and is live on jamdesk.com/docs — without it the next ISR deploy
+ * would announce Dusk. The registry, schema and validation are NOT gated: a
+ * docs.json that names "dusk" must build (the demo site soaks on it).
+ *
+ * The `: boolean` annotation is LOAD-BEARING: without it TS narrows to the
+ * literal `false` and stops type-checking the launch branch.
+ */
+export const DUSK_PUBLIC: boolean = false;

package/vendored/lib/extract-highlights.ts

@@ -11,7 +11,7 @@ import type { DocsConfig } from './docs-types.js';
  */
 export interface ExtractedHighlights {
   siteName: string;
-  theme: 'jam' | 'nebula' | 'pulsar' | 'halo';
+  theme: 'jam' | 'nebula' | 'pulsar' | 'halo' | 'dusk';
   primaryColor?: string;
   seoIndexable: boolean;
   analyticsIntegrations: string[];

package/vendored/lib/layout-helpers.tsx

@@ -2,7 +2,7 @@
 // language, project slug) are resolved upstream from middleware headers
 // or — in non-ISR dev/tests — from URL params; this module owns the
 // rendering once those have resolved.
-import { Inter, JetBrains_Mono, Figtree } from 'next/font/google';
+import { Inter, JetBrains_Mono, Figtree, IBM_Plex_Serif } from 'next/font/google';
 import { preinit } from 'react-dom';
 import fs from 'fs';
 import path from 'path';
@@ -107,6 +107,18 @@ export const figtree = Figtree({
   preload: false,
 });
 
+// Dusk's H1 face. Exposed as a variable only (--font-serif) — Dusk keeps Inter
+// on the body. Not a variable font, so the weight ladder is explicit.
+// preload: false for the same reason as figtree: the theme is only known at
+// runtime from docs.json, so preload would be all-pages-or-none.
+export const ibmPlexSerif = IBM_Plex_Serif({
+  subsets: ['latin'],
+  display: 'swap',
+  weight: ['400', '600'],
+  variable: '--font-serif',
+  preload: false,
+});
+
 export function getLocalFileContent(filename: string): string | null {
   try {
     const filePath = path.join(process.cwd(), 'public', filename);
@@ -315,6 +327,7 @@ export function getFontClassName(
   themeName: ThemeName | undefined,
   customFonts?: FontConfig,
 ): string {
+  const theme = getTheme(themeName);
   const primaryFont = getPrimaryFontFamily(customFonts);
 
   if (primaryFont) {
@@ -333,16 +346,20 @@ export function getFontClassName(
     }
 
     classes.push(jetbrainsMono.variable);
+    // Dusk's serif H1 survives a custom body font — it is theme identity.
+    if (theme.name === 'dusk') classes.push(ibmPlexSerif.variable);
     return classes.join(' ');
   }
 
-  const theme = getTheme(themeName);
   if (theme.name === 'nebula') {
     return `${jetbrainsMono.variable} font-mono`;
   }
   if (theme.name === 'halo') {
     return `${figtree.variable} ${jetbrainsMono.variable} ${figtree.className}`;
   }
+  if (theme.name === 'dusk') {
+    return `${inter.variable} ${ibmPlexSerif.variable} ${jetbrainsMono.variable} ${inter.className}`;
+  }
   return `${inter.variable} ${jetbrainsMono.variable} ${inter.className}`;
 }
 

package/vendored/lib/normalize-config.ts

@@ -96,7 +96,7 @@ export function normalizeConfig(config: DocsConfigInput): NormalizeResult {
   // 3. Warn about layout
   if (layout) {
     warnings.push(
-      'layout field is ignored. Jamdesk determines layout from theme (pulsar=sidebar, jam/nebula/halo=header).'
+      'layout field is ignored. Jamdesk determines layout from theme (pulsar=sidebar, jam/nebula/halo/dusk=header).'
     );
   }
 

package/vendored/lib/r2-cleanup.ts

@@ -409,9 +409,13 @@ export async function pruneRemovedContent(
 
 /**
  * Given top-level CommonPrefixes from a delimiter='/' listing of `{slug}/`,
- * return per-locale llms.txt keys whose locale is a KNOWN language code but
- * is no longer declared — left behind when a project removes a language.
- * Only ever targets our own `<locale>/llms.txt` artifact keys, so content
+ * return per-locale llms.txt / llms-full.txt keys whose locale is a KNOWN
+ * language code but is no longer active — left behind when a project removes
+ * a language. One set covers both files: the default locale has only an
+ * llms-full.txt, and treating its dir as active keeps the sweep from deleting
+ * a `<default>/llms.txt` that never existed on every build. The cost is a
+ * cosmetic orphan if the default language ever changes.
+ * Only ever targets our own `<locale>/llms*.txt` artifact keys, so content
  * dirs (content/, snippets/, openapi/, assets/) can never be touched.
  */
 export function staleLocaleLlmsKeys(
@@ -430,14 +434,14 @@ export function staleLocaleLlmsKeys(
     // casing differs is either a renamed locale or a leftover from a prior
     // casing change — both legitimately stale.
     if (activeLocales.has(dir)) continue;
-    keys.push(`${projectSlug}/${dir}/llms.txt`);
+    keys.push(`${projectSlug}/${dir}/llms.txt`, `${projectSlug}/${dir}/llms-full.txt`);
   }
   return keys;
 }
 
 /**
- * List `{slug}/`'s top-level dirs and delete `<locale>/llms.txt` for any
- * known-language dir no longer declared. Paginates the listing like
+ * List `{slug}/`'s top-level dirs and delete `<locale>/llms.txt` and
+ * `<locale>/llms-full.txt` for any known-language dir no longer active. Paginates the listing like
  * deleteAllProjectR2Objects — a delimiter listing of a huge project could
  * truncate, and an abandoned page would silently orphan its stale locales.
  * Non-fatal by contract: callers treat a throw as a warning — a stale
@@ -474,15 +478,15 @@ export async function sweepStaleLocaleLlmsTxt(
   } while (continuationToken);
 
   const staleKeys = staleLocaleLlmsKeys(prefixes, projectSlug, activeLocales);
-  for (const key of staleKeys) {
-    await client.send(new DeleteObjectCommand({ Bucket: bucketName, Key: key }));
-  }
+  await Promise.all(
+    staleKeys.map((key) => client.send(new DeleteObjectCommand({ Bucket: bucketName, Key: key }))),
+  );
   return staleKeys;
 }
 
 /**
  * Delete a project's AI-context files: the root `llms.txt` + `llms-full.txt` and
- * every per-locale `<locale>/llms.txt`. Called on every build where `seo.ai.llmsTxt`
+ * every per-locale `<locale>/llms.txt` + `<locale>/llms-full.txt`. Called on every build where `seo.ai.llmsTxt`
  * is false so a previously published llms.txt stops serving after a customer opts
  * out — the build gate stops REGENERATING these files but otherwise leaves the
  * already-uploaded copies in place. The deletes are idempotent (DeleteObject is a

package/vendored/lib/static-artifacts.ts

@@ -303,19 +303,26 @@ export interface LlmsTxtFilesOptions extends Omit<LlmsTxtOptions, 'sections' | '
 }
 
 /**
- * Render the root llms.txt (default locale) plus one file per declared,
- * non-hidden, non-default language. Locale membership comes from the page
- * path prefix (resolveLocaleFromPath, whitelisted against declared codes —
- * same semantics as the search index), NOT from nav position. Cross-links
- * between locale files render under the trailing "## Optional" section.
+ * Pages grouped by locale for the per-locale AI-context files (llms.txt,
+ * llms-full.txt). Shared so the two can never disagree on which page belongs
+ * to which language. Null when the project declares no visible languages.
  */
-export function generateLlmsTxtFiles(
-  options: LlmsTxtFilesOptions,
-): { root: string; byLocale: Record<string, string> } {
-  const { navigation, languages, baseUrl, hostAtDocs = false, docsPrefix, pages, ...rest } = options;
-  const urlPrefix = docsPrefix ?? (hostAtDocs ? '/docs' : '');
-  const sections = extractNavigationSections(navigation);
+interface LocaleBuckets<P> {
+  defaultCode: string;
+  /** Declared, non-hidden codes that have pages; the default always included. */
+  activeCodes: string[];
+  pagesFor: (code: string) => P[];
+}
 
+/**
+ * Bucket pages by locale. Membership comes from the page path prefix
+ * (resolveLocaleFromPath, whitelisted against declared codes — same semantics
+ * as the search index), NOT from nav position.
+ */
+function bucketPagesByLocale<P extends { path: string }>(
+  pages: P[],
+  languages: LanguageConfig[] | undefined,
+): LocaleBuckets<P> | null {
   const declared = (languages ?? []).filter(
     (l): l is LanguageConfig & { language: string } =>
       typeof l.language === 'string' && !l.hidden,
@@ -329,14 +336,11 @@ export function generateLlmsTxtFiles(
       (code, i, all) =>
         all.findIndex((c) => c.toLowerCase() === code.toLowerCase()) === i,
     );
+  if (codes.length === 0) return null;
   const defaultCode = resolveLanguageWithFallback(null, languages);
+  const loweredCodes = buildLoweredLocaleSet(codes);
 
-  if (codes.length === 0) {
-    const root = generateLlmsTxt({ ...rest, baseUrl, hostAtDocs, docsPrefix, pages, sections });
-    return { root, byLocale: {} };
-  }
-
-  const byLocalePages = new Map<string, typeof pages>();
+  const byLocalePages = new Map<string, P[]>();
   for (const page of pages) {
     // resolveLocaleFromPath returns '' (NOT the default code) for unprefixed
     // paths and for prefixes outside the whitelist — both belong to the root
@@ -346,21 +350,43 @@ export function generateLlmsTxtFiles(
     // CANONICAL casing (e.g. 'fr-CA' for a declared 'fr-ca'), so bucketing by
     // its raw return and reading back by the declared code would silently
     // drop those pages from every llms.txt file.
-    const locale = (resolveLocaleFromPath(page.path, codes) || defaultCode).toLowerCase();
+    const locale = (resolveLocaleWithLoweredSet(page.path, loweredCodes) || defaultCode).toLowerCase();
     if (!byLocalePages.has(locale)) byLocalePages.set(locale, []);
     byLocalePages.get(locale)!.push(page);
   }
+  const pagesFor = (code: string): P[] => byLocalePages.get(code.toLowerCase()) ?? [];
+
+  // Declared-but-untranslated languages produce empty files nobody should be
+  // sent to — generate and cross-link only locales that actually have pages
+  // (the default locale always exists as the root file).
+  const activeCodes = codes.filter((c) => c === defaultCode || pagesFor(c).length > 0);
+  return { defaultCode, activeCodes, pagesFor };
+}
+
+/**
+ * Render the root llms.txt (default locale) plus one file per declared,
+ * non-hidden, non-default language (see bucketPagesByLocale for membership).
+ * Cross-links between locale files render under the trailing "## Optional"
+ * section.
+ */
+export function generateLlmsTxtFiles(
+  options: LlmsTxtFilesOptions,
+): { root: string; byLocale: Record<string, string> } {
+  const { navigation, languages, baseUrl, hostAtDocs = false, docsPrefix, pages, ...rest } = options;
+  const urlPrefix = docsPrefix ?? (hostAtDocs ? '/docs' : '');
+  const sections = extractNavigationSections(navigation);
+
+  const buckets = bucketPagesByLocale(pages, languages);
+  if (!buckets) {
+    const root = generateLlmsTxt({ ...rest, baseUrl, hostAtDocs, docsPrefix, pages, sections });
+    return { root, byLocale: {} };
+  }
+  const { defaultCode, activeCodes, pagesFor } = buckets;
 
   const llmsUrl = (code: string): string =>
     code === defaultCode
       ? `${baseUrl}${urlPrefix}/llms.txt`
       : `${baseUrl}${urlPrefix}/${code}/llms.txt`;
-  // Declared-but-untranslated languages produce empty files nobody should be
-  // sent to — generate and cross-link only locales that actually have pages
-  // (the default locale always exists as the root file).
-  const activeCodes = codes.filter(
-    (c) => c === defaultCode || (byLocalePages.get(c.toLowerCase())?.length ?? 0) > 0,
-  );
   const activeCrossLinks = (selfCode: string) =>
     activeCodes
       .filter((c) => c !== selfCode)
@@ -368,7 +394,7 @@ export function generateLlmsTxtFiles(
 
   const root = generateLlmsTxt({
     ...rest, baseUrl, hostAtDocs, docsPrefix, sections,
-    pages: byLocalePages.get(defaultCode.toLowerCase()) ?? [],
+    pages: pagesFor(defaultCode),
     otherLanguages: activeCrossLinks(defaultCode),
   });
 
@@ -377,7 +403,7 @@ export function generateLlmsTxtFiles(
     if (code === defaultCode) continue;
     byLocale[code] = generateLlmsTxt({
       ...rest, baseUrl, hostAtDocs, docsPrefix, sections,
-      pages: byLocalePages.get(code.toLowerCase()) ?? [],
+      pages: pagesFor(code),
       otherLanguages: activeCrossLinks(code),
     });
   }
@@ -723,6 +749,30 @@ export function generateLlmsFullTxt(options: LlmsFullTxtOptions): string {
   return parts.join('').trim();
 }
 
+/**
+ * Render the root llms-full.txt plus one file per active locale.
+ *
+ * Unlike llms.txt, the root stays EVERY language: existing consumers of the
+ * combined file keep receiving what they always have. Because of that, the
+ * default locale gets its own file too (e.g. /en/llms-full.txt) — otherwise
+ * there would be no way to fetch the default language alone.
+ */
+export function generateLlmsFullTxtFiles(
+  options: LlmsFullTxtOptions & { languages?: LanguageConfig[] },
+): { root: string; byLocale: Record<string, string> } {
+  const { languages, ...rest } = options;
+  const root = generateLlmsFullTxt(rest);
+  const buckets = bucketPagesByLocale(rest.pages, languages);
+  // One active locale means the root already IS that language — a per-locale
+  // copy would only duplicate a multi-MB file.
+  if (!buckets || buckets.activeCodes.length < 2) return { root, byLocale: {} };
+  const byLocale: Record<string, string> = {};
+  for (const code of buckets.activeCodes) {
+    byLocale[code] = generateLlmsFullTxt({ ...rest, pages: buckets.pagesFor(code) });
+  }
+  return { root, byLocale };
+}
+
 /**
  * Options for generating all artifacts.
  */
@@ -775,6 +825,8 @@ export interface GeneratedArtifacts {
   /** Non-default-locale llms.txt files, keyed by language code. */
   llmsTxtByLocale: Record<string, string>;
   llmsFullTxt: string;
+  /** Per-locale llms-full.txt files, keyed by language code (default locale included). */
+  llmsFullTxtByLocale: Record<string, string>;
   robotsTxt: string;
   rssFeed: string | null;
   /** changelog.json for the embeddable widget — built from the same updates as rssFeed. */
@@ -856,9 +908,9 @@ export function generateAllArtifacts(options: GenerateAllOptions): GeneratedArti
     name, description, baseUrl, pages, hostAtDocs, docsPrefix, noindex, visibility,
     navigation, languages,
   });
-  const llmsFullTxt = llmsFullPages
-    ? generateLlmsFullTxt({ name, pages: llmsFullPages, noindex, visibility })
-    : '';
+  const { root: llmsFullTxt, byLocale: llmsFullTxtByLocale } = llmsFullPages
+    ? generateLlmsFullTxtFiles({ name, pages: llmsFullPages, noindex, visibility, languages })
+    : { root: '', byLocale: {} };
   const robotsTxt = generateRobotsTxt({ baseUrl, hostAtDocs, docsPrefix, noindex });
 
   // Extract <Update> entries once — they power BOTH the RSS feed and
@@ -877,7 +929,9 @@ export function generateAllArtifacts(options: GenerateAllOptions): GeneratedArti
 
   const changelog = generateChangelog(updates);
 
-  return { sitemap, llmsTxt, llmsTxtByLocale, llmsFullTxt, robotsTxt, rssFeed, changelog };
+  return {
+    sitemap, llmsTxt, llmsTxtByLocale, llmsFullTxt, llmsFullTxtByLocale, robotsTxt, rssFeed, changelog,
+  };
 }
 
 // =============================================================================

package/vendored/lib/static-file-route.ts

@@ -25,7 +25,7 @@ export const STATIC_FILE_NAMES = [
 ] as const;
 
 /** All CDN paths for static file routes — used by revalidation to purge CDN cache. */
-// Per-locale llms.txt paths (/{locale}/llms.txt) are intentionally absent:
+// Per-locale llms.txt / llms-full.txt paths (/{locale}/llms.txt) are intentionally absent:
 // locales are per-project, unenumerable here. They self-heal via s-maxage=3600,
 // identical to llms.txt's behavior between explicit purges.
 export const STATIC_REVALIDATION_PATHS = STATIC_FILE_NAMES.flatMap(
@@ -165,7 +165,8 @@ export function createCorsStaticFileHandler(
 }
 
 /**
- * GET handler for per-locale llms.txt (`/{locale}/llms.txt`, `/docs/{locale}/llms.txt`).
+ * GET handler for per-locale llms.txt / llms-full.txt (`/{locale}/llms.txt`,
+ * `/docs/{locale}/llms-full.txt`, ...).
  *
  * Locale is validated (case-insensitively) against the supported language-code
  * list BEFORE any R2 I/O so arbitrary path segments (`/foo/llms.txt`) fast-404.
@@ -173,7 +174,7 @@ export function createCorsStaticFileHandler(
  * `x-jd-noindex` — AI agents fetch them directly and don't honor robots
  * semantics.
  */
-export function createLocaleLlmsTxtHandler(): (
+export function createLocaleLlmsTxtHandler(file: 'llms.txt' | 'llms-full.txt' = 'llms.txt'): (
   request: NextRequest,
   ctx: { params: Promise<{ locale: string }> },
 ) => Promise<NextResponse> {
@@ -185,7 +186,7 @@ export function createLocaleLlmsTxtHandler(): (
     // Fetch with the segment verbatim: R2 keys are written with the DECLARED
     // code, and every advertised URL is generated from that same code, so
     // segment casing and key casing always agree for real links.
-    const filename = `${locale}/llms.txt`;
+    const filename = `${locale}/${file}`;
 
     if (!isIsrMode()) {
       const localPath = path.join(process.cwd(), 'public', filename);
@@ -199,7 +200,7 @@ export function createLocaleLlmsTxtHandler(): (
 
     const projectSlug = request.headers.get('x-project-slug');
     if (!projectSlug) {
-      log('warn', 'Locale llms.txt request missing project slug');
+      log('warn', `Locale ${file} request missing project slug`);
       return new NextResponse('Project not found', { status: 404 });
     }
 
@@ -215,8 +216,8 @@ export function createLocaleLlmsTxtHandler(): (
         },
       });
     } catch (error) {
-      log('error', 'Error serving locale llms.txt', { projectSlug, locale, error: String(error) });
-      return new NextResponse('Error serving locale llms.txt', { status: 500 });
+      log('error', `Error serving locale ${file}`, { projectSlug, locale, error: String(error) });
+      return new NextResponse(`Error serving locale ${file}`, { status: 500 });
     }
   };
 }

package/vendored/lib/theme-preview.ts

@@ -56,7 +56,8 @@
  *    keep serving one visitor's previewed HTML to everyone else regardless of
  *    a `Vary` header.
  */
-import { getAllThemes, type ThemeName } from '@/themes';
+import { getAllThemes, type ThemeConfig, type ThemeName } from '@/themes';
+import { DUSK_PUBLIC } from '@/lib/dusk-embargo';
 
 /** Cookie the picker writes; read server-side in app/layout.tsx. */
 export const THEME_PREVIEW_COOKIE = 'jd_theme';
@@ -69,14 +70,21 @@ export const THEME_PREVIEW_SLUG = 'jamdesk-docs';
 // setting, and should not outlive the visit. The clear path still sends
 // `Max-Age=0` — see theme-preview-client.ts's applyThemePreview.
 
-// Built from the registry rather than using `isValidTheme`, which is a plain
-// `name in themes` check and therefore also returns true for inherited Object
-// keys ('constructor', 'toString'). Those would reach getTheme(), which falls
-// back to jam silently for unknown names but returns Object's own constructor
-// for 'constructor' — yielding data-theme="constructor" and no theme CSS.
-// A Set of the registry's own names is immune and picks up new themes for free.
+/** Themes the picker offers. Dusk joins on launch day (lib/dusk-embargo.ts). */
+export function getPreviewThemes(): ThemeConfig[] {
+  return getAllThemes().filter((theme) => DUSK_PUBLIC || theme.name !== 'dusk');
+}
+
+// Built from the themes the picker actually offers, rather than using
+// `isValidTheme`, which is a plain `name in themes` check and therefore also
+// returns true for inherited Object keys ('constructor', 'toString'). Those
+// would reach getTheme(), which falls back to jam silently for unknown names
+// but returns Object's own constructor for 'constructor' — yielding
+// data-theme="constructor" and no theme CSS. A Set of the offered themes' own
+// names is immune, picks up new themes for free, and keeps an embargoed theme
+// out of both the picker and the cookie reader below.
 const VALID_THEME_NAMES: ReadonlySet<string> = new Set(
-  getAllThemes().map((theme) => theme.name),
+  getPreviewThemes().map((theme) => theme.name),
 );
 
 /**

package/vendored/lib/validate-config.ts

@@ -27,7 +27,7 @@ import { validateJwtAuth } from './jwt-auth-config.js';
 export interface DocsConfig {
   name: string;
   projectId?: string;
-  theme?: 'jam' | 'nebula' | 'pulsar' | 'halo';
+  theme?: 'jam' | 'nebula' | 'pulsar' | 'halo' | 'dusk';
   navigation: NavigationConfig;
   integrations?: IntegrationsConfig;
   [key: string]: unknown;
@@ -170,7 +170,7 @@ export function parseConfig(content: string): DocsConfig {
 /**
  * Filter out noise from anyOf validation errors.
  *
- * The master schema uses a 4-branch anyOf (one per theme) and Ajv emits errors
+ * The master schema uses a 5-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:
  *
@@ -568,7 +568,7 @@ export async function validateConfig(
   }
 
   // Validate theme (case-insensitive — "MINT" still falls through to the Mintlify branch below).
-  const validThemes = ['jam', 'nebula', 'pulsar', 'halo'];
+  const validThemes = ['jam', 'nebula', 'pulsar', 'halo', 'dusk'];
   if (typeof config.theme === 'string') {
     const themeLower = config.theme.toLowerCase();
     if (!validThemes.includes(themeLower)) {
@@ -582,7 +582,7 @@ export async function validateConfig(
       };
     }
     // Normalize so downstream Ajv schema (lowercase enum) accepts it.
-    config.theme = themeLower as 'jam' | 'nebula' | 'pulsar' | 'halo';
+    config.theme = themeLower as 'jam' | 'nebula' | 'pulsar' | 'halo' | 'dusk';
   }
 
   if (legacyAnchors) {