jamdesk 1.1.118 → 1.1.120

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.118",
+  "version": "1.1.120",
   "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",

package/vendored/components/navigation/Header.tsx

@@ -547,10 +547,13 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
               </>
             )}
 
-            {/* Theme toggle - hidden on mobile since it's in the sidebar menu */}
-            <div className="hidden lg:block">
-              <ThemeToggle />
-            </div>
+            {/* 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 && (
+              <div className="hidden lg:block">
+                <ThemeToggle />
+              </div>
+            )}
           </div>
         </div>
       </header>

package/vendored/components/navigation/Sidebar.tsx

@@ -738,7 +738,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
                 <DefaultLogoCompact name={config.name} />
               )}
             </Link>
-            <ThemeToggleCycle />
+            {!config.appearance?.strict && <ThemeToggleCycle />}
           </div>
           <button
             onClick={onClose}
@@ -770,7 +770,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
                 <DefaultLogo name={config.name} showBadge={false} />
               )}
             </Link>
-            <ThemeToggle />
+            {!config.appearance?.strict && <ThemeToggle />}
           </div>
         )}
 

package/vendored/lib/build/clone-error-format.ts

@@ -0,0 +1,104 @@
+import type { CloneError } from '../../github.js';
+import type { ErrorDetails } from '../../shared/types.js';
+
+/**
+ * Format a CloneError into user-facing ErrorDetails.
+ *
+ * Pure function — no side effects, no regex. The `kind` is set at the source
+ * (cloneRepo's catch block in github.ts); this function only renders.
+ *
+ * Headlines (`message`) are kept under 140 characters because they're
+ * forwarded to GitHub commit-status descriptions, which GitHub truncates.
+ */
+export function formatCloneError(err: CloneError): ErrorDetails {
+  const HEADLINE_BUDGET = 140;
+  const fitInHeadline = (s: string): string =>
+    s.length <= HEADLINE_BUDGET ? s : s.slice(0, HEADLINE_BUDGET - 1) + '…';
+
+  const repoFull = err.repoFullName;
+  const repoQuoted = repoFull ? `'${repoFull}'` : "the repository";
+  const repoText = repoFull ?? 'the repository';
+
+  switch (err.kind) {
+    case 'branch_not_found': {
+      const branch = err.branch ?? 'unknown';
+      const branchQuoted = `'${branch}'`;
+      return {
+        type: 'clone_failed',
+        message: fitInHeadline(`Branch ${branchQuoted} not found in ${repoText}`),
+        details:
+          `We tried to clone the ${branchQuoted} branch from ${repoQuoted}, ` +
+          `but it does not exist on GitHub.`,
+        suggestion:
+          `Either:\n` +
+          `• Push a ${branchQuoted} branch to ${repoQuoted}, or\n` +
+          `• Update the configured branch in your project's GitHub connection ` +
+          `settings to one that exists (e.g. main).`,
+      };
+    }
+
+    case 'repo_not_found': {
+      return {
+        type: 'clone_failed',
+        message: fitInHeadline(
+          repoFull
+            ? `Repository ${repoFull} not found or not accessible`
+            : 'Repository not found or not accessible',
+        ),
+        details:
+          `GitHub returned "Repository not found" when we tried to clone ${repoQuoted}. ` +
+          `The Jamdesk GitHub App cannot see this repository — either it was not ` +
+          `selected during installation, the installation was uninstalled, or the ` +
+          `repository was renamed or deleted.`,
+        suggestion:
+          'Open your project settings and click "Reconnect GitHub". ' +
+          `Make sure ${repoQuoted} is selected in the Jamdesk GitHub App installation.`,
+      };
+    }
+
+    case 'auth_failed': {
+      return {
+        type: 'clone_failed',
+        message: fitInHeadline('GitHub authentication failed'),
+        details:
+          `The GitHub App token was rejected when cloning ${repoQuoted}. ` +
+          `The installation may have been suspended, revoked, or had its ` +
+          `permissions changed.`,
+        suggestion:
+          'Open your project settings and click "Reconnect GitHub" to reinstall ' +
+          'the Jamdesk GitHub App, then re-trigger the build.',
+      };
+    }
+
+    case 'network_error': {
+      return {
+        type: 'clone_failed',
+        message: fitInHeadline(`Network error cloning ${repoText}`),
+        details:
+          `git could not reach GitHub when cloning ${repoQuoted}. This is ` +
+          `usually transient — DNS, TLS, or GitHub's git endpoint having a ` +
+          `bad moment — but a persistent firewall or proxy change can also ` +
+          `cause it.`,
+        suggestion:
+          'Re-trigger the build. If it keeps failing:\n' +
+          '• Check https://www.githubstatus.com for ongoing incidents\n' +
+          '• Confirm any custom egress proxy/firewall still allows ' +
+          'github.com:443',
+      };
+    }
+
+    case 'unknown':
+    default: {
+      return {
+        type: 'clone_failed',
+        message: fitInHeadline('Failed to clone repository'),
+        details: `Could not clone ${repoText}.`,
+        suggestion:
+          'Check that:\n' +
+          `• ${repoText} exists and is accessible\n` +
+          '• The Jamdesk GitHub App has access to the repository\n' +
+          '• The branch name is correct',
+      };
+    }
+  }
+}

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

@@ -103,9 +103,13 @@ export function parseErrorDetails(
   output: string,
   message: string,
   phase: string,
-  opts: { pageToFileMap?: Record<string, string>; discoveryHint?: string } = {},
+  opts: {
+    pageToFileMap?: Record<string, string>;
+    discoveryHint?: string;
+    repoFullName?: string;
+  } = {},
 ): ErrorDetails {
-  const { pageToFileMap, discoveryHint } = opts;
+  const { pageToFileMap, discoveryHint, repoFullName } = opts;
   const lowerOutput = output.toLowerCase();
 
   // Extract error source information upfront - used by multiple error types
@@ -703,15 +707,20 @@ export function parseErrorDetails(
     };
   }
 
-  // Clone failure
-  if (phase === 'clone' || lowerOutput.includes('clone')) {
+  // Clone failure — defense-in-depth fallback. The primary path is
+  // cloneRepo throwing CloneError, formatted by formatCloneError. This
+  // branch only fires if a plain Error somehow reaches the parser during
+  // the clone phase. Gate strictly on phase to avoid misclassifying any
+  // unrelated build error whose stderr mentions the word "clone".
+  if (phase === 'clone') {
+    const repoText = repoFullName ?? 'the repository';
     return {
       type: 'clone_failed',
       message: 'Failed to clone repository',
-      details: 'Could not clone your GitHub repository.',
+      details: `Could not clone ${repoText}.`,
       suggestion:
         'Check that:\n' +
-        '• The repository exists and is accessible\n' +
+        `• ${repoText} exists and is accessible\n` +
         '• The Jamdesk GitHub App has access to the repository\n' +
         '• The branch name is correct',
     };

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

@@ -0,0 +1,41 @@
+import { CloneError } from '../../github.js';
+import type { ErrorDetails } from '../../shared/types.js';
+import { formatCloneError } from './clone-error-format.js';
+import { parseErrorDetails } from './error-parser.js';
+
+export interface ErrorRoutingOpts {
+  combinedOutput: string;
+  phase: string;
+  repoFullName?: string;
+  pageToFileMap?: Record<string, string>;
+}
+
+/**
+ * Route a caught build error to the appropriate ErrorDetails formatter.
+ *
+ * - `CloneError` → `formatCloneError` (source-classified, type-safe)
+ * - anything else → `parseErrorDetails` (regex-based, legacy)
+ *
+ * Centralized here so the routing rule is testable in isolation and
+ * build.ts's catch block stays short.
+ */
+export function errorDetailsFromCaught(
+  error: Error,
+  errorRef: string,
+  opts: ErrorRoutingOpts,
+): ErrorDetails {
+  if (error instanceof CloneError) {
+    return { ...formatCloneError(error), errorRef };
+  }
+  const parsed = parseErrorDetails(
+    opts.combinedOutput,
+    error.message,
+    opts.phase,
+    {
+      pageToFileMap: opts.pageToFileMap,
+      discoveryHint: (error as Error & { discoveryHint?: string }).discoveryHint,
+      repoFullName: opts.repoFullName,
+    },
+  );
+  return { ...parsed, errorRef };
+}

package/vendored/lib/docs-types.ts

@@ -548,11 +548,20 @@ export type MintlifyLayout = 'sidenav' | 'topnav';
 /**
  * Background configuration
  *
- * `decoration: "none"` disables the theme's default decoration — on Jam this
- * removes the light-mode radial gradient. `color` overrides the theme's
- * `--color-bg-primary` in light and dark mode. `gradient` tunes the Jam
- * gradient (color, size, position, opacity); ignored when `decoration` is
- * anything other than `gradient`, or on themes without a default gradient.
+ * `decoration` chooses one of four background treatments:
+ *   - `"gradient"` (default for Jam) — radial gradient, tunable via `gradient`.
+ *   - `"grid"` — subtle dot grid pattern.
+ *   - `"windows"` — Windows 11-style frosted radial spots.
+ *   - `"none"` — flat `--color-bg-primary` fill, no decoration.
+ *
+ * When `decoration` is unset, no `data-decoration` attribute is rendered — the
+ * gate selector `:not([data-decoration="none"])` treats absence as the default
+ * (gradient) case.
+ *
+ * `color` overrides the theme's `--color-bg-primary` in light and dark mode.
+ * `gradient` tunes the Jam gradient (color, size, position, opacity); it is
+ * ignored when `decoration` is anything other than `"gradient"` (or unset), or
+ * on themes without a default gradient.
  */
 export interface BackgroundConfig {
   image?: string | { light: string; dark: string };

package/vendored/lib/email-templates/components/error-box.tsx

@@ -59,9 +59,46 @@ const styles = {
     paddingTop: '12px',
     borderTop: '1px solid #FECACA',
   },
+  suggestionContinuation: {
+    color: colors.textSecondary,
+    fontSize: '13px',
+    fontStyle: 'italic' as const,
+    margin: '4px 0 0 0',
+  },
+  // Used when the previous source line was blank — gives a visible paragraph
+  // break (e.g. between bullets and the "If you need help…" reference line).
+  suggestionParagraphBreak: {
+    color: colors.textSecondary,
+    fontSize: '13px',
+    fontStyle: 'italic' as const,
+    margin: '14px 0 0 0',
+  },
 };
 
 export function ErrorBox({ error, errorRef, errorType, errorSuggestion }: ErrorBoxProps) {
+  // Split on `\n` so multi-line suggestions render as a real list. A single
+  // <Text> (which becomes <p>) collapses whitespace, so "Either:\n• one\n• two"
+  // would otherwise reach the reader as a wall of prose. Blank source lines
+  // (from "...\n\nIf you need help...") translate to a visible paragraph
+  // break — the next non-empty line gets a larger top margin.
+  const suggestionLines: Array<{ text: string; afterBlank: boolean }> = [];
+  if (errorSuggestion) {
+    let pendingBlank = false;
+    for (const raw of errorSuggestion.split('\n')) {
+      if (raw.trim().length === 0) {
+        pendingBlank = true;
+        continue;
+      }
+      suggestionLines.push({ text: raw, afterBlank: pendingBlank });
+      pendingBlank = false;
+    }
+  }
+
+  const styleFor = (i: number, afterBlank: boolean) => {
+    if (i === 0) return styles.suggestion;
+    return afterBlank ? styles.suggestionParagraphBreak : styles.suggestionContinuation;
+  };
+
   return (
     <Section style={styles.container} className="email-error-box">
       <Text style={styles.errorLabel} className="email-error-title">Error</Text>
@@ -75,11 +112,15 @@ export function ErrorBox({ error, errorRef, errorType, errorSuggestion }: ErrorB
         <Text style={styles.errorType} className="email-paragraph">Type: {errorType}</Text>
       )}
 
-      {errorSuggestion && (
-        <Text style={styles.suggestion} className="email-paragraph">
-          💡 {errorSuggestion}
+      {suggestionLines.map(({ text, afterBlank }, i) => (
+        <Text
+          key={i}
+          style={styleFor(i, afterBlank)}
+          className="email-paragraph"
+        >
+          {i === 0 ? `💡 ${text}` : text}
         </Text>
-      )}
+      ))}
     </Section>
   );
 }

package/vendored/lib/layout-helpers.tsx

@@ -177,20 +177,26 @@ const BG_POSITION_ALLOWED = new Set([
  * to the Jam theme CSS. Returns `null` when nothing is configured or only
  * invalid values were provided.
  *
- * `decoration: "none"` is NOT rendered here — it's wired through the body's
- * `data-decoration` attribute so the gradient rules can opt out via :not().
+ * `decoration` is NOT emitted as CSS here — it's wired through the body's
+ * `data-decoration` attribute (see DocsChrome below) so the theme CSS can
+ * select on it via `body[data-decoration="..."]` rules.
+ *
+ * Gradient vars are only emitted when `decoration` is unset or `"gradient"`.
+ * For `"grid"`, `"windows"`, and `"none"` the gradient is dead-code in CSS,
+ * so the vars are suppressed (and a dev-only warning fires if the caller
+ * passed a gradient block alongside one of those decorations).
  */
 export function generateBackgroundVariables(
   background: BackgroundConfig | undefined,
 ): string | null {
   if (!background) return null;
 
-  // When the gradient is opted out via decoration: "none", suppress all
-  // gradient-related CSS vars so they don't leak into other rules. The
-  // body[data-decoration="none"] selector already gates the Jam gradient
-  // off, but emitting orphan `--jd-gradient-*` vars on :root would let any
-  // future descendant rule pick them up. Keep :root clean.
-  const gradientDisabled = background.decoration === 'none';
+  // Suppress gradient vars unless decoration is unset or explicitly "gradient".
+  // The Jam CSS only consumes --jd-gradient-* under the default-gradient gate
+  // (variables.css:190/214). Emitting them under grid/windows/none would leak
+  // orphan vars onto :root that any future descendant rule could pick up.
+  const gradientDisabled =
+    background.decoration !== undefined && background.decoration !== 'gradient';
 
   // typeof guards defend the .trim() calls against callers that bypass Ajv
   // (dashboard live-preview, hand-written configs). Contract is silent-drop.
@@ -238,8 +244,9 @@ export function generateBackgroundVariables(
   const darkLines: string[] = [];
   if (validDark) darkLines.push(`  --color-bg-primary: ${validDark};`);
 
-  // Dev-only warning when both decoration:"none" and gradient:{...} are set —
-  // the gradient is silently ignored, which would confuse the customer.
+  // Dev-only warning when a non-gradient decoration is combined with a
+  // gradient:{...} block — the gradient is silently ignored, which would
+  // confuse the customer (their tuning has no visible effect).
   if (
     gradientDisabled &&
     background.gradient &&
@@ -247,7 +254,7 @@ export function generateBackgroundVariables(
     process.env.NODE_ENV === 'development'
   ) {
     console.warn(
-      '[bg-config] background.gradient is ignored because background.decoration is "none". Set decoration to "gradient" (or omit) to apply gradient tuning.',
+      `[bg-config] background.gradient is ignored because background.decoration is "${background.decoration}". Set decoration to "gradient" (or omit) to apply gradient tuning.`,
     );
   }
 
@@ -393,10 +400,11 @@ export async function DocsChrome({
     config.colors?.dark,
   );
   const backgroundVariables = generateBackgroundVariables(config.background);
-  // 'gradient' | 'grid' | 'windows' | 'none' | undefined. Only "none" currently
-  // alters rendering (gates off Jam's light-mode gradient + chrome transparency).
-  // The other values are stored on the body as data-decoration="<value>" so future
-  // CSS rules can target them, but no rule consumes them yet.
+  // 'gradient' | 'grid' | 'windows' | 'none' | undefined. Wired through to the
+  // body's `data-decoration` attribute; the Jam theme CSS selects on each value
+  // (see variables.css for the rule blocks). Unset / "gradient" both render the
+  // default radial gradient; "none" is a solid fill; "grid" and "windows" paint
+  // their respective patterns.
   const decoration = config.background?.decoration;
 
   const appearanceDefault = config.appearance?.default || 'system';

package/vendored/schema/docs-schema.json

@@ -274,7 +274,7 @@
                                 "windows",
                                 "none"
                             ],
-                            "description": "Background decoration style. Currently implemented: `gradient` (the default for Jam) and `none` (disables Jam's light-mode radial gradient). `grid` and `windows` are reserved for future Mintlify-compatible decorations and currently render as the theme default (no warning is emitted) — do not rely on them yet."
+                            "description": "Background decoration style. `gradient` (default for Jam) renders a radial gradient. `grid` renders a subtle dot grid. `windows` renders Windows 11-style frosted spots. `none` disables the theme's decoration, falling back to a flat --color-bg-primary background."
                         },
                         "color": {
                             "$ref": "#/definitions/colorPairSchema",
@@ -311,7 +311,7 @@
                                 }
                             },
                             "additionalProperties": false,
-                            "description": "Customize the theme's background gradient. Currently applies only to the Jam theme (light mode). Ignored when `decoration` is `none`"
+                            "description": "Customize the theme's background gradient. Currently applies only to the Jam theme (light mode). Ignored unless `decoration` is `gradient` (or unset)"
                         }
                     },
                     "additionalProperties": false,

package/vendored/themes/jam/variables.css

@@ -187,7 +187,7 @@
  * Firefox 113+, Safari 16.2+). Older browsers fall back to the static rgba
  * gradient block below — they see the original look but cannot customize it.
  */
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) {
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]):not([data-decoration="windows"]) {
   /* Override solid background-color from base.css */
   background-color: transparent;
   /* Fallback gradient (static, for browsers without color-mix). Older browsers
@@ -211,7 +211,7 @@ html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) {
    Pre-computing in TS avoids fractional-percentage edge cases in older Blink
    (e.g., `calc(0.12 * 66.67%)` → 8.0004% can be clamped). */
 @supports (background: color-mix(in srgb, red, transparent)) {
-  html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) {
+  html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]):not([data-decoration="windows"]) {
     background:
       radial-gradient(
         circle var(--jd-gradient-size, 500px) at var(--jd-gradient-position, top center),
@@ -226,31 +226,34 @@ html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) {
   }
 }
 
-/* Make main content / wrappers / chrome transparent in light mode SO the gradient shows through.
-   Only applies when the gradient is active (gated on :not([data-decoration="none"])). */
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) main {
+/* Make main content / wrappers / chrome transparent in light mode SO the body
+   decoration shows through. Applies to the default gradient AND the windows
+   frosted-spots decoration (whose corner spots are part of the chrome look),
+   but NOT to grid (the dot pattern behind sidebar/header hurts readability)
+   and NOT to "none" (no decoration to expose). */
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]) main {
   background-color: transparent !important;
 }
 
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) > div > div.flex:not([role="dialog"]):not(:has([data-chat-panel])) {
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]) > div > div.flex:not([role="dialog"]):not(:has([data-chat-panel])) {
   background-color: transparent !important;
 }
 
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) > div > div.flex > main {
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]) > div > div.flex > main {
   background-color: transparent !important;
 }
 
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) div.flex-1.lg\:ml-\[300px\] {
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]) div.flex-1.lg\:ml-\[300px\] {
   background-color: transparent !important;
 }
 
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) header {
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]) header {
   background-color: transparent !important;
   background: transparent !important;
 }
 
 @media (min-width: 1024px) {
-  html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) aside {
+  html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]) aside {
     background-color: transparent !important;
     background: transparent !important;
   }
@@ -264,22 +267,96 @@ html:not(.dark) body[data-theme="jam"][data-decoration="none"] {
   background: var(--color-bg-primary, #ffffff);
 }
 
+/* ===== GRID DECORATION (decoration: "grid") =====
+   Subtle dot grid layered over --color-bg-primary. 1px dots at 24px spacing,
+   theme primary color at 8% opacity. Dark-mode keeps solid bg (handled by
+   base.css; no rule needed here). */
+html:not(.dark) body[data-theme="jam"][data-decoration="grid"] {
+  background-color: var(--color-bg-primary, #ffffff);
+  /* 1.5px radius (= 3 device-pixels on 2x Retina) prevents the dot from
+     resolving to fuzzy sub-pixel anti-aliasing. The hard transparent stop at
+     1.5px keeps the edge crisp on 1x and 2x. */
+  /* Static rgba fallback for browsers without color-mix() */
+  background-image: radial-gradient(
+    circle 1.5px at center,
+    rgba(34, 102, 194, 0.08) 0 1.5px,
+    transparent 1.5px
+  );
+  background-size: 24px 24px;
+  background-repeat: repeat;
+}
+
+@supports (background: color-mix(in srgb, red, transparent)) {
+  html:not(.dark) body[data-theme="jam"][data-decoration="grid"] {
+    background-image: radial-gradient(
+      circle 1.5px at center,
+      color-mix(in srgb, var(--color-primary, #2266C2) 8%, transparent) 0 1.5px,
+      transparent 1.5px
+    );
+  }
+}
+
+/* ===== WINDOWS DECORATION (decoration: "windows") =====
+   Windows 11-style frosted look: two soft radial spots in the upper-left and
+   upper-right, fading over --color-bg-primary. Light-mode only; dark inherits
+   solid bg from base.css. */
+html:not(.dark) body[data-theme="jam"][data-decoration="windows"] {
+  /* Static rgba fallback. `background:` shorthand resets all background-*
+     sub-properties before applying the layered gradients; the trailing
+     var(--color-bg-primary) layer re-sets background-color, so no separate
+     declaration is needed. */
+  background:
+    radial-gradient(circle 600px at 15% 0%, rgba(34, 102, 194, 0.14) 0%, transparent 60%),
+    radial-gradient(circle 600px at 85% 0%, rgba(34, 102, 194, 0.10) 0%, transparent 60%),
+    var(--color-bg-primary, #ffffff);
+  background-repeat: no-repeat;
+  /* `fixed` keeps the spots viewport-anchored on scroll (matches the
+     default-gradient behavior). Without it the spots scroll out of view
+     after the first viewport, leaving the rest of a long page flat. */
+  background-attachment: fixed;
+}
+
+@supports (background: color-mix(in srgb, red, transparent)) {
+  html:not(.dark) body[data-theme="jam"][data-decoration="windows"] {
+    background:
+      radial-gradient(
+        circle 600px at 15% 0%,
+        color-mix(in srgb, var(--color-primary, #2266C2) 14%, transparent) 0%,
+        transparent 60%
+      ),
+      radial-gradient(
+        circle 600px at 85% 0%,
+        color-mix(in srgb, var(--color-primary, #2266C2) 10%, transparent) 0%,
+        transparent 60%
+      ),
+      var(--color-bg-primary, #ffffff);
+    /* The `background:` shorthand above resets repeat + attachment. Re-set
+       them so the modern path matches the fallback's behavior. */
+    background-repeat: no-repeat;
+    background-attachment: fixed;
+  }
+}
+
 /* ===== SCROLL-BASED GRADIENT AND HEADER CHANGES ===== */
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) {
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]):not([data-decoration="windows"]) {
   transition: background 0.3s ease-out;
 }
 
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]).scrolled {
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]):not([data-decoration="windows"]).scrolled {
   background: var(--color-bg-primary, #ffffff) !important;
 }
 
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]).scrolled header {
+/* Header scroll-fade rules — symmetric with the body rules above. Skip the
+   pattern decorations (grid, windows) so their chrome behavior (opaque for
+   grid, transparent-over-fixed-spots for windows) doesn't get clobbered on
+   scroll. */
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]):not([data-decoration="windows"]).scrolled header {
   background-color: var(--color-bg-primary) !important;
   background: var(--color-bg-primary) !important;
   transition: background 0.3s ease-out;
 }
 
-html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) header {
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]):not([data-decoration="windows"]) header {
   transition: background 0.3s ease-out;
 }
 
@@ -287,7 +364,7 @@ html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]) header {
 
 /* Prose body */
 body[data-theme="jam"] .prose {
-  font-family: 'Inter', sans-serif;
+  font-family: var(--font-sans, 'Inter'), sans-serif;
   font-size: var(--prose-body-size);
   line-height: var(--prose-body-line-height);
   font-weight: var(--prose-body-weight);
@@ -297,6 +374,7 @@ body[data-theme="jam"] .prose {
 /* Prose headings */
 body[data-theme="jam"] .prose h1,
 body[data-theme="jam"] h1 {
+  font-family: var(--font-heading, var(--font-sans, 'Inter')), sans-serif;
   font-size: var(--prose-h1-size);
   line-height: var(--prose-h1-line-height);
   font-weight: var(--prose-h1-weight);
@@ -305,6 +383,7 @@ body[data-theme="jam"] h1 {
 }
 
 body[data-theme="jam"] .prose h2 {
+  font-family: var(--font-heading, var(--font-sans, 'Inter')), sans-serif;
   font-size: var(--prose-h2-size);
   line-height: var(--prose-h2-line-height);
   font-weight: var(--prose-h2-weight);
@@ -313,6 +392,7 @@ body[data-theme="jam"] .prose h2 {
 }
 
 body[data-theme="jam"] .prose h3 {
+  font-family: var(--font-heading, var(--font-sans, 'Inter')), sans-serif;
   font-size: var(--prose-h3-size);
   line-height: var(--prose-h3-line-height);
   font-weight: var(--prose-h3-weight);
@@ -321,6 +401,7 @@ body[data-theme="jam"] .prose h3 {
 }
 
 body[data-theme="jam"] .prose h4 {
+  font-family: var(--font-heading, var(--font-sans, 'Inter')), sans-serif;
   font-size: var(--prose-h4-size);
   line-height: var(--prose-h4-line-height);
   font-weight: var(--prose-h4-weight);

package/vendored/themes/nebula/variables.css

@@ -66,13 +66,20 @@
 /* ===== NEBULA THEME TYPOGRAPHY ===== */
 
 .prose {
-  font-family: 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  font-family: var(--font-sans, 'IBM Plex Mono'), ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
 }
 
 .prose code:not([class*="language-"]) {
   font-family: 'IBM Plex Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
 }
 
+.prose h1,
+.prose h2,
+.prose h3,
+.prose h4 {
+  font-family: var(--font-heading, var(--font-sans, 'IBM Plex Mono')), ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+}
+
 .dark {
   /* Dark theme colors - warm dark background */
   --color-bg-primary: #151413;

package/vendored/themes/pulsar/variables.css

@@ -175,7 +175,7 @@
 
 /* Prose body */
 .prose {
-  font-family: 'Inter', sans-serif;
+  font-family: var(--font-sans, 'Inter'), sans-serif;
   font-size: var(--prose-body-size);
   line-height: var(--prose-body-line-height);
   font-weight: var(--prose-body-weight);
@@ -185,6 +185,7 @@
 /* Prose headings */
 .prose h1,
 h1 {
+  font-family: var(--font-heading, var(--font-sans, 'Inter')), sans-serif;
   font-size: var(--prose-h1-size);
   line-height: var(--prose-h1-line-height);
   font-weight: var(--prose-h1-weight);
@@ -193,6 +194,7 @@ h1 {
 }
 
 .prose h2 {
+  font-family: var(--font-heading, var(--font-sans, 'Inter')), sans-serif;
   font-size: var(--prose-h2-size);
   line-height: var(--prose-h2-line-height);
   font-weight: var(--prose-h2-weight);
@@ -201,6 +203,7 @@ h1 {
 }
 
 .prose h3 {
+  font-family: var(--font-heading, var(--font-sans, 'Inter')), sans-serif;
   font-size: var(--prose-h3-size);
   line-height: var(--prose-h3-line-height);
   font-weight: var(--prose-h3-weight);
@@ -209,6 +212,7 @@ h1 {
 }
 
 .prose h4 {
+  font-family: var(--font-heading, var(--font-sans, 'Inter')), sans-serif;
   font-size: var(--prose-h4-size);
   line-height: var(--prose-h4-line-height);
   font-weight: var(--prose-h4-weight);