jamdesk 1.1.212 → 1.1.214

package/dist/lib/dusk-embargo.js

@@ -0,0 +1,15 @@
+/**
+ * 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 migrate` theme prompt and the `--theme` help.
+ * Validation is NOT gated.
+ *
+ * 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 = false;
+//# sourceMappingURL=dusk-embargo.js.map

package/dist/lib/dusk-embargo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dusk-embargo.js","sourceRoot":"","sources":["../../src/lib/dusk-embargo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAY,KAAK,CAAC"}

package/dist/lib/normalize-config.js

@@ -62,7 +62,7 @@ export function normalizeConfig(config) {
     }
     // 3. Warn about layout
     if (layout) {
-        warnings.push('layout field is ignored. Jamdesk determines layout from theme (pulsar=sidebar, jam/nebula/halo=header).');
+        warnings.push('layout field is ignored. Jamdesk determines layout from theme (pulsar=sidebar, jam/nebula/halo/dusk=header).');
     }
     // 4. Warn about navbar.style
     if (rest.navbar?.style) {

package/dist/lib/normalize-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-config.js","sourceRoot":"","sources":["../../src/lib/normalize-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAmCH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACzD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,UAAU,GAAgB,EAAE,GAAG,IAAI,EAAE,CAAC;IAE5C,wCAAwC;IACxC,IAAI,UAAU,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CACX,sFAAsF,CACvF,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,UAAU,CAAC,UAAU,GAAG;gBACtB,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,QAAQ;gBACvC,MAAM,EAAE,UAAU,CAAC,QAAQ,KAAK,IAAI;aACrC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,sFAAsF;IACtF,iFAAiF;IACjF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,GAAG,QAAQ,CAAC;QAElD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,UAAU,CAAC,QAAQ,GAAG,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,EAAE,CAAC;QAC1D,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CACX,iEAAiE,CAClE,CAAC;YACF,MAAM,gBAAgB,GAAI,UAAU,CAAC,GAAW,EAAE,QAAQ,IAAI,EAAE,CAAC;YACjE,UAAU,CAAC,GAAG,GAAG;gBACf,GAAG,UAAU,CAAC,GAAG;gBACjB,QAAQ,EAAE;oBACR,GAAI,cAAyC;oBAC7C,GAAG,gBAAgB;iBACpB;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CACX,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"normalize-config.js","sourceRoot":"","sources":["../../src/lib/normalize-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAmCH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACzD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,UAAU,GAAgB,EAAE,GAAG,IAAI,EAAE,CAAC;IAE5C,wCAAwC;IACxC,IAAI,UAAU,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CACX,sFAAsF,CACvF,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,UAAU,CAAC,UAAU,GAAG;gBACtB,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,QAAQ;gBACvC,MAAM,EAAE,UAAU,CAAC,QAAQ,KAAK,IAAI;aACrC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,sFAAsF;IACtF,iFAAiF;IACjF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,GAAG,QAAQ,CAAC;QAElD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,UAAU,CAAC,QAAQ,GAAG,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,EAAE,CAAC;QAC1D,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CACX,iEAAiE,CAClE,CAAC;YACF,MAAM,gBAAgB,GAAI,UAAU,CAAC,GAAW,EAAE,QAAQ,IAAI,EAAE,CAAC;YACjE,UAAU,CAAC,GAAG,GAAG;gBACf,GAAG,UAAU,CAAC,GAAG;gBACjB,QAAQ,EAAE;oBACR,GAAI,cAAyC;oBAC7C,GAAG,gBAAgB;iBACpB;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CACX,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CACX,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.212",
+  "version": "1.1.214",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",
@@ -106,7 +106,7 @@
     "@inquirer/prompts": "^8.7.2",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
-    "chalk": "^6.0.0",
+    "chalk": "^6.0.1",
     "commander": "^15.0.0",
     "dictionary-en": "^4.0.0",
     "estree-util-visit": "^2.0.0",
@@ -129,7 +129,7 @@
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",
     "@types/fs-extra": "^11.0.0",
-    "@types/node": "^26.4.1",
+    "@types/node": "^26.6.3",
     "@typescript/native": "npm:typescript@^7.0.2",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
     "vitest": "^4.1.11"

package/vendored/app/(unlock)/jd/unlock/page.tsx

@@ -2,7 +2,7 @@ import { headers } from 'next/headers';
 import { getDocsConfig } from '@/lib/docs-isr';
 import { normalizeLogo } from '@/lib/docs-types';
 import { sanitizeFrom } from '@/lib/sanitize-from';
-import { getBrandingUrl } from '@/lib/branding-url';
+import { getBrandingUrl, isBrandingVisible } from '@/lib/branding-url';
 import UnlockForm from './UnlockForm';
 
 interface UnlockPageProps {
@@ -34,7 +34,7 @@ export default async function UnlockPage({ searchParams }: UnlockPageProps) {
   const from = sanitizeFrom(rawFrom ?? null);
   const showError = params.error === '1';
 
-  const showBranding = process.env.NEXT_PUBLIC_SHOW_BRANDING !== 'false';
+  const showBranding = isBrandingVisible(config);
   const brandingUrl = getBrandingUrl(slug);
 
   return (

package/vendored/app/api/markdown-export/[project]/[...slug]/route.ts

@@ -20,6 +20,7 @@ import { apiSpecsMarkdownFooter } from '@/lib/api-specs-markdown-hint';
 import { collectLocalSpecPaths } from '@/lib/openapi/operation-description';
 import { operationMarkdownForRef } from '@/lib/openapi/enrich-page-infos';
 import { injectAgentDirective } from '@/lib/agent-directive';
+import { absolutizeMarkdownLinks } from '@/lib/markdown-absolute-links';
 import { resolveMarkdownFallbackPath } from '@/lib/root-page-slug';
 import { logger } from '@/shared/logger';
 import type { DocsConfig } from '@/lib/docs-types';
@@ -153,7 +154,9 @@ export async function GET(
   // path returns whatever the source MDX happened to end with. 107 of snag's
   // 115 exports shipped without it, so anything appending to or concatenating
   // these files ran the last line of one into the next.
-  const body = `${hinted.replace(/\s+$/, '')}\n`;
+  // Last, so links in the appended OpenAPI operation content are covered too.
+  const linked = absolutizeLinks(hinted, request.headers, project, hostAtDocs, linkPrefix);
+  const body = `${linked.replace(/\s+$/, '')}\n`;
 
   // Two paths reach this handler via proxy rewrite:
   //   (a) `.md` URL: unique CDN cache key, safe to share.
@@ -177,6 +180,33 @@ export async function GET(
   });
 }
 
+/**
+ * Root-relative links in the export become absolute URLs on the host the
+ * reader asked for (see absolutizeMarkdownLinks for why). ISR only: `jamdesk
+ * dev` serves from localhost over http, and getBaseUrl always builds https.
+ * The base comes from getBaseUrl, the same trusted-header resolution the
+ * api-specs footer and canonical tags use, so a custom domain's own prefix
+ * wins over the subdomain's. Never throws.
+ */
+function absolutizeLinks(
+  markdown: string,
+  headers: Headers,
+  project: string,
+  hostAtDocs: boolean,
+  linkPrefix: string,
+): string {
+  if (!isIsrMode()) return markdown;
+  try {
+    return absolutizeMarkdownLinks(markdown, getBaseUrl(headers, project, hostAtDocs), linkPrefix);
+  } catch (err) {
+    logger.warn('[markdown-export] link absolutize skipped', {
+      project,
+      error: err instanceof Error ? err.message : String(err),
+    });
+    return markdown;
+  }
+}
+
 /**
  * The two shapes fetchMdxContent throws for a missing page — the
  * `Page not found: …` message the S3 path builds and the error names the

package/vendored/components/mdx/Tooltip.tsx

@@ -26,6 +26,7 @@ export function Tooltip({
   const linkPrefix = useLinkPrefix();
   const [isVisible, setIsVisible] = useState(false);
   const [position, setPosition] = useState<'top' | 'bottom'>('top');
+  const [shiftX, setShiftX] = useState(0);
   const triggerRef = useRef<HTMLSpanElement>(null);
   const tooltipRef = useRef<HTMLSpanElement>(null);
   const tooltipId = useId();
@@ -39,6 +40,19 @@ export function Tooltip({
 
       // Show below if not enough space above
       setPosition(spaceAbove < tooltipHeight + 8 ? 'bottom' : 'top');
+
+      // The popover is centered on the trigger, so a trigger near the edge of
+      // the content column pushes half of it past the column's overflow edge,
+      // where it is clipped. Shift it back inside the nearest clipping
+      // ancestor (the viewport if there is none); the arrow counter-shifts so
+      // it still points at the trigger.
+      const bounds = clippingBounds(triggerRef.current);
+      const center = triggerRect.left + triggerRect.width / 2;
+      const halfWidth = tooltipRef.current.offsetWidth / 2;
+      const margin = 8;
+      const overflowLeft = bounds.left + margin - (center - halfWidth);
+      const overflowRight = center + halfWidth - (bounds.right - margin);
+      setShiftX(overflowLeft > 0 ? overflowLeft : overflowRight > 0 ? -overflowRight : 0);
     }
   }, [isVisible]);
 
@@ -64,7 +78,7 @@ export function Tooltip({
         ref={tooltipRef}
         id={tooltipId}
         role="tooltip"
-        style={{ boxShadow: 'var(--shadow-lg)', display: 'block' }}
+        style={{ boxShadow: 'var(--shadow-lg)', display: 'block', marginLeft: `${shiftX}px` }}
         className={`absolute z-50 w-64 p-3 rounded-lg border border-[var(--color-border)] bg-[var(--color-bg-primary)] transition-all duration-150 ${
           position === 'top'
             ? 'bottom-full left-1/2 -translate-x-1/2 mb-2'
@@ -99,6 +113,7 @@ export function Tooltip({
 
         {/* Arrow */}
         <span
+          style={{ marginLeft: `${-shiftX}px` }}
           className={`absolute left-1/2 -translate-x-1/2 w-2 h-2 rotate-45 border-[var(--color-border)] bg-[var(--color-bg-primary)] ${
             position === 'top'
               ? 'bottom-[-5px] border-r border-b'
@@ -109,3 +124,14 @@ export function Tooltip({
     </span>
   );
 }
+
+/** Left/right edges of the nearest ancestor that clips horizontally. */
+function clippingBounds(el: HTMLElement): { left: number; right: number } {
+  for (let node = el.parentElement; node; node = node.parentElement) {
+    if (getComputedStyle(node).overflowX !== 'visible') {
+      const rect = node.getBoundingClientRect();
+      return { left: rect.left, right: rect.right };
+    }
+  }
+  return { left: 0, right: document.documentElement.clientWidth };
+}

package/vendored/components/navigation/DefaultLogo.tsx

@@ -12,27 +12,34 @@ interface DefaultLogoProps {
 
 export function DefaultLogo({ name, showBadge = true }: DefaultLogoProps) {
   return (
-    <div className="flex items-center gap-2.5 group">
-      {/* Jamdesk icon: Three overlapping rounded rectangles */}
-      <div className="relative w-8 h-8 transition-transform duration-200 group-hover:scale-105">
-        <svg viewBox="0 0 32 32" fill="none" className="w-8 h-8">
-          {/* Back rectangle (left) - lightest purple */}
-          <rect x="3" y="7" width="14" height="19" rx="2.5" fill="#C4B5FD" fillOpacity="0.9"/>
-          {/* Middle rectangle - medium purple */}
-          <rect x="8" y="4" width="14" height="19" rx="2.5" fill="#A78BFA" fillOpacity="0.85"/>
-          {/* Front rectangle (right) - darker purple */}
-          <rect x="13" y="9" width="14" height="19" rx="2.5" fill="#8B5CF6" fillOpacity="0.9"/>
-        </svg>
+    // In a crowded header the badge goes first, then the name cuts off with
+    // "…", rather than either pushing the controls beside it off-screen. The
+    // badge goes by wrapping: this row is one line tall, clipped and allowed to
+    // wrap, so the badge drops to the hidden second line as soon as icon +
+    // name + badge stop fitting.
+    <div className="flex flex-wrap content-start items-center gap-x-2.5 h-8 overflow-hidden min-w-0 group">
+      <div className="flex items-center gap-2.5 min-w-0">
+        {/* Jamdesk icon: Three overlapping rounded rectangles */}
+        <div className="relative w-8 h-8 flex-shrink-0 transition-transform duration-200 group-hover:scale-105">
+          <svg viewBox="0 0 32 32" fill="none" className="w-8 h-8">
+            {/* Back rectangle (left) - lightest purple */}
+            <rect x="3" y="7" width="14" height="19" rx="2.5" fill="#C4B5FD" fillOpacity="0.9"/>
+            {/* Middle rectangle - medium purple */}
+            <rect x="8" y="4" width="14" height="19" rx="2.5" fill="#A78BFA" fillOpacity="0.85"/>
+            {/* Front rectangle (right) - darker purple */}
+            <rect x="13" y="9" width="14" height="19" rx="2.5" fill="#8B5CF6" fillOpacity="0.9"/>
+          </svg>
+        </div>
+
+        {/* Site name */}
+        <span className="text-lg font-semibold text-[var(--color-text-primary)] tracking-tight truncate">
+          {name}
+        </span>
       </div>
-      
-      {/* Site name */}
-      <span className="text-lg font-semibold text-[var(--color-text-primary)] tracking-tight">
-        {name}
-      </span>
-      
+
       {/* Docs badge */}
       {showBadge && (
-        <span className="px-2 py-0.5 text-[10px] font-bold bg-[var(--color-accent)]/10 text-[var(--color-accent)] rounded uppercase tracking-wide border border-[var(--color-accent)]/20">
+        <span className="flex-shrink-0 px-2 py-0.5 text-[10px] font-bold bg-[var(--color-accent)]/10 text-[var(--color-accent)] rounded uppercase tracking-wide border border-[var(--color-accent)]/20">
           docs
         </span>
       )}

package/vendored/components/navigation/Header.tsx

@@ -9,7 +9,7 @@ import type { DocsConfig, TabsPosition } from '@/lib/docs-types';
 import { normalizeLogo, getIconString } from '@/lib/docs-types';
 import type { LayoutVariant } from '@/themes';
 import { getTheme } from '@/themes';
-import { ThemeToggle } from '@/components/theme/ThemeToggle';
+import { ThemeToggle, ThemeToggleCycle } from '@/components/theme/ThemeToggle';
 import { LazySearchModal as SearchModal } from '@/components/search/LazySearchModal';
 import { DefaultLogo } from './DefaultLogo';
 import { LanguageSelector } from './LanguageSelector';
@@ -33,11 +33,29 @@ interface HeaderProps {
 // Max tabs to show before overflow dropdown
 const MAX_VISIBLE_TABS = 4;
 
-// Shared button classes for mobile search/AI icons
+// Shared button classes for search/AI icons below lg. Every search/AI control
+// shows at exactly one set of widths: these below lg, the full bar or the
+// compact icons from lg (header-responsive.test.tsx).
+//
+// Viewport breakpoints decide what lives in the header versus the drawer,
+// because the drawer only exists below lg. How much room a control takes keys
+// off container widths instead: from xl the inline chat panel takes 350-500px
+// of the viewport, and with viewport breakpoints alone Jam's row ran 120px
+// past its edge at 1280 with chat open.
 const MOBILE_ICON_BUTTON = 'lg:hidden p-2 text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)] bg-[var(--color-bg-secondary)]/50 border border-[var(--color-border)]/50 hover:bg-[var(--color-bg-secondary)] rounded-md transition-colors cursor-pointer';
 
+// Full search bar buttons (Jam, Halo): icon | label | ⌘ hint. Grid rather
+// than flex so the label column's minimum is 0: as a flex item a nowrap label
+// holds its full width as the bar's minimum and overflows instead of cutting
+// off. Margins rather than gap, so a hidden label or hint leaves no stray gap.
+// The fixed height keeps an icon-only button as tall as a labelled one (the
+// label's text-sm line sets it; Font Awesome's own line-height beats leading-*).
+const BAR_BUTTON = 'grid grid-cols-[auto_minmax(0,max-content)_auto] items-center h-9.5 px-3 py-2 bg-[var(--color-bg-secondary)] border border-[var(--color-border)] rounded-lg';
+const BAR_LABEL = 'col-start-2 ml-3 hidden @min-[16rem]:block truncate';
+const BAR_HINT = 'col-start-3 ml-3 hidden @min-[24rem]:inline-flex';
+
 // Shared button classes for compact (Nebula) header icon buttons
-const COMPACT_ICON_BUTTON = 'hidden md:flex p-2 hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-lg transition-colors cursor-pointer';
+const COMPACT_ICON_BUTTON = 'hidden lg:flex p-2 hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-lg transition-colors cursor-pointer';
 
 export function Header({ config, layout = 'header-logo', tabsPosition: tabsPositionProp, isSidebarOpen, onToggleSidebar }: HeaderProps) {
   const { onChatOpen, devNotice } = useChatOpenHandler();
@@ -257,12 +275,14 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
   const renderLogo = () => {
     if (showLogoImage) {
       return (
-        <div className="flex items-center gap-2">
+        <div className="flex items-center gap-2 min-w-0">
           {/* eslint-disable-next-line @next/next/no-img-element */}
           <img
             src={logoSrc}
             alt={`${config.name} logo`}
-            style={{ height: '28px', width: 'auto', maxWidth: '170px' }}
+            // minWidth 0 lets the logo give way when the row runs out of room;
+            // contain keeps it from squashing while it does.
+            style={{ height: '28px', width: 'auto', maxWidth: '170px', minWidth: 0, objectFit: 'contain', objectPosition: 'left center' }}
             onError={() => setLogoError(true)}
           />
         </div>
@@ -291,9 +311,12 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
           CSS that wants to detect the canonical tab strip's presence should target
           `.sidebar-scroll[data-has-tabs="true"]` instead (set by Sidebar.tsx). */}
       <header className={headerClasses} data-has-tabs={showTabsInHeader && hasTabs ? 'true' : 'false'}>
-        <div className="max-w-[1440px] 2xl:mx-auto flex items-center py-3" style={{ margin: '0 24px' }}>
-          {/* Left: Hamburger + Logo */}
-          <div className="flex items-center gap-3 flex-shrink-0">
+        <div className="@container max-w-[1440px] 2xl:mx-auto flex items-center py-3" style={{ margin: '0 24px' }}>
+          {/* Left: Hamburger + Logo. The one block that can shrink: when the
+              row is still too narrow, the logo gives way (a text logo cuts off
+              with "…") instead of pushing Ask AI or the theme toggle off-screen.
+              A logo-less site's name + badge overran 375px by 13-20px. */}
+          <div className="flex items-center gap-3 min-w-0">
             {/* Hamburger menu - mobile only */}
             <button
               onClick={onToggleSidebar}
@@ -309,11 +332,11 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
 
             {/* Logo - always shown in header-logo layout, shown on mobile only for sidebar-logo layout */}
             {showLogoInHeader ? (
-              <Link href={logoHref} prefetch={false} className="flex items-center">
+              <Link href={logoHref} prefetch={false} className="flex items-center min-w-0">
                 {renderLogo()}
               </Link>
             ) : (
-              <Link href={logoHref} prefetch={false} className="lg:hidden flex items-center">
+              <Link href={logoHref} prefetch={false} className="lg:hidden flex items-center min-w-0">
                 {renderLogo()}
               </Link>
             )}
@@ -321,16 +344,30 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
 
           {/* Center: Search Bar + Ask AI Button - only in header-logo layout, not for compact search themes */}
           {showLogoInHeader && !useCompactSearch && (
-            <div className="flex-1 flex justify-center px-4">
-              <div className="hidden md:flex items-center gap-2">
+            // From lg only: below it the icon buttons cover search/AI, and the
+            // column is just a spacer, so it carries no padding either.
+            //
+            // The column is the container the labels and ⌘ hints query: its
+            // width is exactly the room left between the logo and the right
+            // side, whatever took the rest (the chat panel, a long navbar, a
+            // wide logo). Labels need 16rem, which covers English with room to
+            // spare and French or Portuguese with a little cut off ("…", never
+            // wrapped: "Demander à l'IA" wrapped to a 57px-tall button at
+            // 1024). The hints need 24rem. Size containment means the column
+            // no longer takes a minimum from its content, so lg:min-w-[8rem]
+            // holds the two icon-only buttons (2 x 43px + gap + padding); past
+            // that the logo gives way.
+            <div className="@container flex-1 flex justify-center lg:px-4 lg:min-w-[8rem]">
+              <div className="hidden lg:flex items-center gap-2">
                 <button
                   onClick={() => onSearchOpen()}
-                  className="flex items-center gap-3 px-3 py-2 bg-[var(--color-bg-secondary)] border border-[var(--color-border)] rounded-lg text-[var(--color-text-muted)] text-sm hover:border-[var(--color-border-hover)] transition-colors cursor-pointer"
+                  className={`${BAR_BUTTON} text-[var(--color-text-muted)] text-sm hover:border-[var(--color-border-hover)] transition-colors cursor-pointer`}
                   aria-label={ui.search}
+                  title={`${ui.search} (⌘K)`}
                 >
-                  <i className="fa-solid fa-magnifying-glass text-[14px] flex-shrink-0" aria-hidden="true" />
-                  <span>{ui.search}</span>
-                  <kbd className="hidden sm:inline-flex items-center gap-[2px] px-2 py-0.5 text-xs text-[var(--color-text-muted)] bg-[var(--color-bg-primary)] border border-[var(--color-border)] rounded">
+                  <i className="fa-solid fa-magnifying-glass text-[14px]" aria-hidden="true" />
+                  <span className={BAR_LABEL}>{ui.search}</span>
+                  <kbd className={`${BAR_HINT} items-center gap-[2px] px-2 py-0.5 text-xs text-[var(--color-text-muted)] bg-[var(--color-bg-primary)] border border-[var(--color-border)] rounded`}>
                     <span className="text-sm leading-none">⌘</span>
                     <span>K</span>
                   </kbd>
@@ -338,13 +375,13 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
                 {onChatOpen && (
                   <button
                     onClick={onChatOpen}
-                    className="flex items-center gap-3 px-3 py-2 bg-[var(--color-bg-secondary)] border border-[var(--color-border)] rounded-lg hover:border-[var(--color-border-hover)] cursor-pointer transition-colors text-sm text-[var(--color-text-muted)]"
+                    className={`${BAR_BUTTON} hover:border-[var(--color-border-hover)] cursor-pointer transition-colors text-sm text-[var(--color-text-muted)]`}
                     aria-label={ui.askAi}
                     title={`${ui.askAi} (⌘I)`}
                   >
                     <i className="fa-solid fa-sparkles text-[14px] text-[var(--color-accent)]" aria-hidden="true" />
-                    <span>{ui.askAi}</span>
-                    <kbd className="hidden sm:inline-flex items-center gap-[2px] px-2 py-0.5 text-xs text-[var(--color-text-muted)] bg-[var(--color-bg-primary)] border border-[var(--color-border)] rounded">
+                    <span className={BAR_LABEL}>{ui.askAi}</span>
+                    <kbd className={`${BAR_HINT} items-center gap-[2px] px-2 py-0.5 text-xs text-[var(--color-text-muted)] bg-[var(--color-bg-primary)] border border-[var(--color-border)] rounded`}>
                       <span className="text-sm leading-none">⌘</span>
                       <span>I</span>
                     </kbd>
@@ -517,14 +554,18 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
               </a>
             )}
 
-            {/* Language Selector - for header-logo layout */}
+            {/* Language Selector - header-logo layout, desktop only. Below lg it
+                lives in the sidebar drawer, like the theme toggle: at 375px the
+                row can't fit it beside the logo. */}
             {showLogoInHeader && resolved?.languages && resolved.languages.length > 1 && (
-              <LanguageSelector
-                languages={resolved.languages}
-                compact={true}
-                position="down"
-                defaultLanguage={resolved.languages.find((l) => l.isDefault)?.code}
-              />
+              <div className="hidden lg:block">
+                <LanguageSelector
+                  languages={resolved.languages}
+                  compact={true}
+                  position="down"
+                  defaultLanguage={resolved.languages.find((l) => l.isDefault)?.code}
+                />
+              </div>
             )}
 
             {/* Compact search + AI icons - for themes like Nebula that use icon-only buttons */}
@@ -556,10 +597,18 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
             {config.auth?.jwt?.enabled === true && <LogoutButton />}
 
             {/* Theme toggle - hidden on mobile since it's in the sidebar menu.
-                Also hidden when appearance.strict pins users to the configured mode. */}
-            {!config.appearance?.strict && (
+                Also hidden when appearance.strict pins users to the configured mode.
+                Header-logo only: sidebar-logo (Pulsar) keeps it in the sidebar.
+                In a row under 48rem (the chat panel dragged to 500px at 1280)
+                the three-button toggle gives way to the one-button cycle. */}
+            {showLogoInHeader && !config.appearance?.strict && (
               <div className="hidden lg:block">
-                <ThemeToggle />
+                <div className="hidden @min-[48rem]:block">
+                  <ThemeToggle />
+                </div>
+                <div className="flex @min-[48rem]:hidden">
+                  <ThemeToggleCycle />
+                </div>
               </div>
             )}
           </div>

package/vendored/components/navigation/Sidebar.tsx

@@ -964,9 +964,11 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
           </div>
         </nav>
 
-        {/* Language Selector - for sidebar-logo layout */}
-        {layout === 'sidebar-logo' && resolvedNav.languages.length > 1 && (
-          <div className="px-4 py-3 border-t border-[var(--color-border)]">
+        {/* Language Selector. Sidebar-logo (Pulsar) keeps it here at every
+            width. Header-logo layouts show it in the header from lg and here,
+            in the drawer, below it (header-responsive.test.tsx). */}
+        {resolvedNav.languages.length > 1 && (
+          <div className={`px-4 py-3 border-t border-[var(--color-border)]${layout === 'sidebar-logo' ? '' : ' lg:hidden'}`}>
             <LanguageSelector
               languages={resolvedNav.languages}
               position="up"

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/email-notifier.ts

@@ -1,11 +1,11 @@
 /**
- * Email Notifier — sends internal build failure notifications via Resend.
+ * Email Notifier — sends internal build failure notifications via Mailfully.
  *
- * Env: BUILDER_RESEND_API_KEY, JAMDESK_REPORT_EMAIL
+ * Env: MAILFULLY_API_KEY, JAMDESK_REPORT_EMAIL
  */
 
 import { render } from '@react-email/render';
-import { Resend } from 'resend';
+import { sendMailfullyEmail } from './mailfully.js';
 import { BuildFailureEmail, type BuildFailureEmailProps } from './email-templates/index.js';
 
 export type BuildFailureEmailInfo = BuildFailureEmailProps;
@@ -15,13 +15,13 @@ export type BuildFailureEmailInfo = BuildFailureEmailProps;
  * Gracefully skips if environment variables are not configured.
  */
 export async function sendInternalBuildFailureEmail(info: BuildFailureEmailInfo): Promise<void> {
-  const apiKey = process.env.BUILDER_RESEND_API_KEY;
+  const apiKey = process.env.MAILFULLY_API_KEY;
   const reportEmail = process.env.JAMDESK_REPORT_EMAIL;
 
   if (!apiKey || !reportEmail) {
     console.log(JSON.stringify({
       severity: 'WARNING',
-      message: `Email notification skipped - ${!apiKey ? 'BUILDER_RESEND_API_KEY' : 'JAMDESK_REPORT_EMAIL'} not configured`,
+      message: `Email notification skipped - ${!apiKey ? 'MAILFULLY_API_KEY' : 'JAMDESK_REPORT_EMAIL'} not configured`,
       projectId: info.projectId,
       buildId: info.buildId,
     }));
@@ -29,13 +29,11 @@ export async function sendInternalBuildFailureEmail(info: BuildFailureEmailInfo)
   }
 
   try {
-    const resend = new Resend(apiKey);
-    
     const template = BuildFailureEmail(info);
     const html = await render(template);
     const text = await render(template, {plainText: true});
 
-    const result = await resend.emails.send({
+    const result = await sendMailfullyEmail(apiKey, {
       from: 'Jamdesk <support@jamdesk.com>',
       to: reportEmail,
       subject: `Jamdesk build failed: ${info.projectName || info.projectId}`,