jamdesk 1.1.211 → 1.1.213

package/vendored/schema/docs-schema.json

@@ -2124,6 +2124,130 @@
                 "navigation"
             ],
             "additionalProperties": false
+        },
+        {
+            "type": "object",
+            "properties": {
+                "theme": {
+                    "type": "string",
+                    "const": "dusk"
+                },
+                "$schema": {
+                    "$ref": "#/anyOf/0/properties/$schema"
+                },
+                "projectId": {
+                    "$ref": "#/anyOf/0/properties/projectId"
+                },
+                "name": {
+                    "$ref": "#/anyOf/0/properties/name"
+                },
+                "description": {
+                    "$ref": "#/anyOf/0/properties/description"
+                },
+                "colors": {
+                    "$ref": "#/definitions/colorsSchema"
+                },
+                "logo": {
+                    "$ref": "#/anyOf/0/properties/logo"
+                },
+                "favicon": {
+                    "$ref": "#/anyOf/0/properties/favicon"
+                },
+                "api": {
+                    "$ref": "#/anyOf/0/properties/api"
+                },
+                "appearance": {
+                    "$ref": "#/anyOf/0/properties/appearance"
+                },
+                "background": {
+                    "$ref": "#/anyOf/0/properties/background"
+                },
+                "navbar": {
+                    "$ref": "#/anyOf/0/properties/navbar"
+                },
+                "tabsPosition": {
+                    "$ref": "#/anyOf/0/properties/tabsPosition"
+                },
+                "anchors": {
+                    "$ref": "#/anyOf/0/properties/anchors"
+                },
+                "navigation": {
+                    "$ref": "#/definitions/navigationSchema"
+                },
+                "footer": {
+                    "$ref": "#/anyOf/0/properties/footer"
+                },
+                "search": {
+                    "$ref": "#/anyOf/0/properties/search"
+                },
+                "seo": {
+                    "$ref": "#/anyOf/0/properties/seo"
+                },
+                "fonts": {
+                    "$ref": "#/anyOf/0/properties/fonts"
+                },
+                "icons": {
+                    "$ref": "#/anyOf/0/properties/icons"
+                },
+                "styling": {
+                    "$ref": "#/anyOf/0/properties/styling"
+                },
+                "redirects": {
+                    "$ref": "#/anyOf/0/properties/redirects",
+                    "description": "URL redirect rules for your documentation site. Each redirect maps a source path to a destination URL"
+                },
+                "integrations": {
+                    "$ref": "#/anyOf/0/properties/integrations"
+                },
+                "banner": {
+                    "$ref": "#/anyOf/0/properties/banner"
+                },
+                "errors": {
+                    "$ref": "#/anyOf/0/properties/errors"
+                },
+                "contextual": {
+                    "$ref": "#/anyOf/0/properties/contextual"
+                },
+                "thumbnails": {
+                    "$ref": "#/anyOf/0/properties/thumbnails"
+                },
+                "interaction": {
+                    "$ref": "#/anyOf/0/properties/interaction"
+                },
+                "metadata": {
+                    "$ref": "#/anyOf/0/properties/metadata"
+                },
+                "localization": {
+                    "$ref": "#/anyOf/0/properties/localization"
+                },
+                "chat": {
+                    "$ref": "#/anyOf/0/properties/chat"
+                },
+                "analytics": {
+                    "$ref": "#/anyOf/0/properties/analytics"
+                },
+                "modeToggle": {
+                    "$ref": "#/anyOf/0/properties/modeToggle"
+                },
+                "layout": {
+                    "$ref": "#/anyOf/0/properties/layout"
+                },
+                "spellcheck": {
+                    "$ref": "#/anyOf/0/properties/spellcheck"
+                },
+                "auth": {
+                    "$ref": "#/anyOf/0/properties/auth"
+                },
+                "images": {
+                    "$ref": "#/anyOf/0/properties/images"
+                }
+            },
+            "required": [
+                "theme",
+                "name",
+                "navigation"
+            ],
+            "additionalProperties": false
         }
     ],
     "definitions": {

package/vendored/themes/dusk/variables.css

@@ -0,0 +1,426 @@
+/**
+ * Dusk Theme - CSS Variables
+ * Quiet and flat: header, sidebar and content share one tinted ground,
+ * separated by 1px borders instead of surface steps. Ink blue accent,
+ * Inter body, IBM Plex Serif H1.
+ *
+ * ARCHITECTURE NOTE: app/globals.css unconditionally @imports jam/variables.css,
+ * so Dusk inherits jam's :root — the --prose-* size ladder, the nav/code/UI
+ * typography tokens and jam's unscoped mobile rules. This file is injected as a
+ * <style> AFTER the globals bundle, so these :root rules win on source order at
+ * equal specificity.
+ *
+ * SPACING NOTE: Dusk uses jam's production spacing. Every spacing rule below is
+ * copied from jam/variables.css and re-scoped to dusk — jam scopes its own
+ * copies to body[data-theme="jam"], so without these the sidebar gaps, group
+ * margins and column alignment would fall back to bare base.css. Change color,
+ * type, radius and surfaces here; do not tune spacing.
+ *
+ * FONT NOTE: never write the serif family by name. next/font self-hosts it
+ * under a mangled family (__IBM_Plex_Serif_xxx) exposed as --font-serif on
+ * <body> (lib/layout-helpers.tsx); a literal name silently misses.
+ */
+
+:root {
+  /* Radius — restrained, about half of Halo's. */
+  --radius-sm: 0.25rem;    /* 4px  — badges */
+  --radius-md: 0.375rem;   /* 6px  — nav items, buttons */
+  --radius-lg: 0.5rem;     /* 8px  — cards, tables, callouts, inline code */
+  --radius-xl: 0.75rem;    /* 12px — code panels, modals */
+  --radius-2xl: 1rem;      /* 16px */
+  --radius-full: 9999px;
+
+  /* Light — one ground for body, header, sidebar and main. Every text token
+     is solved against it for the contrast floors pinned in
+     __tests__/dusk-theme-gate.test.ts. */
+  --color-bg-primary: #F1F2F3;
+  --color-bg-secondary: #EBECEF;   /* inline code, table header */
+  --color-bg-tertiary: #E5E7EB;    /* fenced code */
+  --color-bg-hover: #E5E7EB;
+
+  --color-border: #D4D7DD;
+  --color-border-hover: #C6CBD3;
+  --border-width: 1px;
+
+  --color-text-primary: #1A1D22;   /* 15.1:1 */
+  --color-text-secondary: #3C424C; /*  9.0:1 */
+  --color-text-tertiary: #515A67;  /*  6.2:1 */
+  --color-text-muted: #616B7B;     /*  4.8:1 */
+  --color-marker: #7D8899;         /*  3.2:1 — decorative only */
+
+  --color-accent: #2158A1;         /* white label 7.1:1, 6.3:1 as text */
+  --color-accent-hover: #1B4984;
+  --color-accent-light: #E4EBF5;
+  --color-accent-text: #26528D;    /*  7.0:1 */
+
+  /* Primary is ONLY emitted when a project sets colors.primary — there is no
+     global default. Without this alias the TOC scroll thumb, active TOC links,
+     step chips, Card icons and li::marker compute to transparent and vanish.
+     A project's colors.primary still wins: its style block is injected after
+     this file. See halo/variables.css for the full reasoning. */
+  --color-primary: var(--color-accent);
+  --color-primary-dark: var(--color-accent-hover);
+
+  --color-code-bg: #E5E7EB;
+  --color-code-border: #D4D7DD;
+  --color-code-text: #1A1D22;
+
+  /* Callouts — note carries the accent; info is neutral so the two blues
+     never sit side by side. Every text color clears 6:1 on its own tint. */
+  --color-note-bg: #E4EBF5;
+  --color-note-border: #C9D7EB;
+  --color-note-text: #26528D;
+
+  --color-info-bg: #EBECEF;
+  --color-info-border: #D4D7DD;
+  --color-info-text: #3C424C;
+
+  --color-warning-bg: #FFF7C2;
+  --color-warning-border: #F3D673;
+  --color-warning-text: #895000;
+
+  --color-error-bg: #FEEBEC;
+  --color-error-border: #FDBDBE;
+  --color-error-text: #AC2529;
+
+  --color-success-bg: #E9F6E9;
+  --color-success-border: #B2DDB5;
+  --color-success-text: #236832;
+
+  /* Same page box and item rhythm as jam. */
+  --layout-max-width: 1472px;
+  --sidebar-item-spacing: 4px;
+
+  /* Active sidebar item. A blue wash rather than --color-accent-light, which
+     is a callout tint and sits too close to the ground to read as a state. */
+  --dusk-nav-active-bg: #DCE5F2;
+
+  /* Flat. Restated rather than inherited so the intent is on the page. */
+  --shadow-sm: none;
+  --shadow-md: none;
+  --shadow-lg: none;
+  --shadow-xl: none;
+  --shadow-2xl: none;
+
+  /* Weights only — sizes come from jam's ladder. Body is 400, not jam's 300:
+     a thin weight undoes the contrast the grays above are tuned for. */
+  --prose-h1-weight: 600;
+  --prose-h2-weight: 600;
+  --prose-h3-weight: 600;
+  --prose-h4-weight: 600;
+  --prose-body-weight: 400;
+  --nav-page-weight: 400;
+  --nav-page-active-weight: 500;
+}
+
+.dark {
+  --color-bg-primary: #0F1318;
+  --color-bg-secondary: #1B1F23;
+  --color-bg-tertiary: #22262B;
+  --color-bg-hover: #22262B;
+
+  --color-border: #333942;
+  --color-border-hover: #3E444E;
+
+  --color-text-primary: #E4E7EA;   /* 15.0:1 */
+  --color-text-secondary: #B8BFC7; /* 10.0:1 */
+  --color-text-tertiary: #909AA7;  /*  6.5:1 */
+  --color-text-muted: #768394;     /*  4.8:1 */
+  --color-marker: #5C6674;         /*  3.2:1 */
+
+  /* The accent is used as TEXT in ~38 components as well as a fill, so in
+     dark it has to read on the ground (5.0:1). White on it lands at 3.7:1,
+     the same trade jam's dark #3b82f6 makes. Links use --color-accent-text. */
+  --color-accent: #4A86D4;
+  --color-accent-hover: #6A9BDB;
+  --color-accent-light: #11253F;
+  --color-accent-text: #88ADDC;    /*  8.0:1 */
+
+  --color-code-bg: #22262B;
+  --color-code-border: #333942;
+  --color-code-text: #E4E7EA;
+
+  --color-note-bg: #11253F;
+  --color-note-border: #1F4475;
+  --color-note-text: #88ADDC;
+
+  --color-info-bg: #1B1F23;
+  --color-info-border: #333942;
+  --color-info-text: #B8BFC7;
+
+  --color-warning-bg: #302008;
+  --color-warning-border: #5C3D05;
+  --color-warning-text: #CB9800;
+
+  --color-error-bg: #3B1219;
+  --color-error-border: #72232D;
+  --color-error-text: #FF6F6A;
+
+  --color-success-bg: #1B2A1E;
+  --color-success-border: #2D5736;
+  --color-success-text: #3EBB53;
+
+  --dusk-nav-active-bg: #152E4E;
+
+  --shadow-sm: none;
+  --shadow-md: none;
+  --shadow-lg: none;
+  --shadow-xl: none;
+  --shadow-2xl: none;
+}
+
+/* ===== TYPOGRAPHY ===== */
+/* REQUIRED, not polish: base.css hardcodes `.prose h1..h6 { font-weight: 600 }`
+   and every --prose-* consumer is scoped to one theme, so without this block
+   the ladder is dead CSS and h1 falls back to base.css's raw 2.25rem. */
+body[data-theme="dusk"] .prose {
+  font-family: var(--font-sans, var(--font-primary, 'Inter')), sans-serif;
+  font-size: var(--prose-body-size);
+  line-height: var(--prose-body-line-height);
+  font-weight: var(--prose-body-weight);
+  letter-spacing: var(--prose-body-tracking);
+}
+
+/* The serif H1. The bare `h1` is required: the page title renders outside
+   .prose. A customer heading font (--font-heading, from docs.json fonts)
+   still wins; otherwise the theme serif. --font-serif is set on <body> by
+   next/font, so this must stay scoped to body, never :root. */
+body[data-theme="dusk"] .prose h1,
+body[data-theme="dusk"] h1 {
+  font-family: var(--font-heading, var(--font-serif)), 'Times New Roman', serif;
+  font-size: var(--prose-h1-size);
+  line-height: var(--prose-h1-line-height);
+  font-weight: var(--prose-h1-weight);
+  letter-spacing: -0.01em;
+  color: var(--color-text-primary);
+}
+
+body[data-theme="dusk"] .prose h2 {
+  font-family: var(--font-heading, var(--font-sans, var(--font-primary, 'Inter'))), sans-serif;
+  font-size: var(--prose-h2-size);
+  line-height: var(--prose-h2-line-height);
+  font-weight: var(--prose-h2-weight);
+  letter-spacing: var(--prose-h2-tracking);
+  color: var(--color-text-primary);
+}
+
+body[data-theme="dusk"] .prose h3 {
+  font-family: var(--font-heading, var(--font-sans, var(--font-primary, 'Inter'))), sans-serif;
+  font-size: var(--prose-h3-size);
+  line-height: var(--prose-h3-line-height);
+  font-weight: var(--prose-h3-weight);
+  letter-spacing: var(--prose-h3-tracking);
+  color: var(--color-text-primary);
+}
+
+body[data-theme="dusk"] .prose h4 {
+  font-family: var(--font-heading, var(--font-sans, var(--font-primary, 'Inter'))), sans-serif;
+  font-size: var(--prose-h4-size);
+  line-height: var(--prose-h4-line-height);
+  font-weight: var(--prose-h4-weight);
+  letter-spacing: var(--prose-h4-tracking);
+  color: var(--color-text-primary);
+}
+
+/* Inline code — jam's padding, Dusk's surface. */
+body[data-theme="dusk"] .prose code:not([class*="language-"]) {
+  background-color: var(--color-bg-secondary);
+  color: var(--color-code-text);
+  padding: 0.125rem 0.375rem;
+  border-radius: var(--radius-sm);
+  font-size: var(--code-inline-size);
+}
+
+/* Untitled code blocks have no CodePanel border of their own. */
+body[data-theme="dusk"] .prose pre.shiki {
+  border: var(--border-width) solid var(--color-code-border);
+}
+
+body[data-theme="dusk"] .prose table {
+  border-radius: var(--radius-lg);
+  overflow: hidden;
+}
+
+body[data-theme="dusk"] .prose hr,
+body[data-theme="dusk"] hr {
+  border: none;
+  border-top: var(--border-width) solid var(--color-border);
+  margin: 2rem 0;
+}
+
+/* ===== HEADER ===== */
+/* The header-logo <header> has no border of its own. Same construction as
+   nebula's divider (see its comment for the inset math), at Dusk's 1px. */
+body[data-theme="dusk"] header[data-has-tabs]::after {
+  content: '';
+  position: absolute;
+  left: -1rem;
+  right: -1rem;
+  bottom: 0;
+  height: 1px;
+  background-color: var(--color-border);
+  pointer-events: none;
+}
+
+@media (min-width: 1024px) {
+  body[data-theme="dusk"] header[data-has-tabs]::after {
+    left: -1.5rem;
+    right: -1.5rem;
+  }
+}
+
+/* ===== SIDEBAR (jam's spacing, re-scoped) ===== */
+/* The sidebar keeps base's border-r — Dusk separates with borders, so unlike
+   jam and halo it does not remove it. */
+
+body[data-theme="dusk"] [data-nav-anchor] {
+  padding: 0 0 16px 0;
+  position: relative;
+  margin-left: 24px;
+}
+
+body[data-theme="dusk"] [data-nav-anchor]:first-of-type {
+  margin-top: 30px;
+}
+
+body[data-theme="dusk"] [data-nav-anchor]::before {
+  content: '';
+  position: absolute;
+  top: -8px;
+  left: -12px;
+  right: 24px;
+  bottom: 8px;
+  border-radius: var(--radius-md);
+  background-color: transparent;
+  transition: background-color 0.2s;
+  z-index: -1;
+}
+
+body[data-theme="dusk"] [data-nav-anchor][data-active="false"]:hover::before {
+  background-color: var(--color-bg-hover);
+}
+
+body[data-theme="dusk"] .sidebar-scroll ul li a,
+body[data-theme="dusk"] .sidebar-scroll .nav-group-l1 {
+  position: relative;
+  font-weight: var(--nav-page-weight) !important;
+}
+
+/* The highlight is a z-index:-1 pseudo-element inset from the link box, so it
+   can bleed left of the text without shifting layout — jam's geometry. */
+body[data-theme="dusk"] .sidebar-scroll ul li a::before,
+body[data-theme="dusk"] .sidebar-scroll .nav-group-l1::before {
+  content: '';
+  position: absolute;
+  top: 0;
+  left: -12px;
+  right: 16px;
+  bottom: 0;
+  border-radius: var(--radius-md);
+  background-color: transparent;
+  z-index: -1;
+  transition: background-color 0.15s;
+}
+
+body[data-theme="dusk"] .sidebar-scroll ul li a {
+  padding-right: 24px !important;
+}
+
+body[data-theme="dusk"] .sidebar-scroll ul li a:hover::before,
+body[data-theme="dusk"] .sidebar-scroll .nav-group-l1:hover::before {
+  background-color: var(--color-bg-hover);
+}
+
+body[data-theme="dusk"] .sidebar-scroll ul li a.nav-active::before {
+  background-color: var(--dusk-nav-active-bg);
+}
+
+body[data-theme="dusk"] .sidebar-scroll ul li a.nav-active {
+  color: var(--color-text-primary) !important;
+  font-weight: var(--nav-page-active-weight) !important;
+}
+
+body[data-theme="dusk"] .nav-tab-link,
+body[data-theme="dusk"] .toc-link,
+body[data-theme="dusk"] .toc-link-bg {
+  border-radius: var(--radius-md) !important;
+}
+
+@media (min-width: 1024px) {
+  body[data-theme="dusk"] .sidebar-tabs {
+    padding-top: calc(2rem + 4px) !important;
+  }
+}
+
+body[data-theme="dusk"] .sidebar-scroll .sidebar-nav-groups {
+  display: flex !important;
+  flex-direction: column !important;
+  gap: var(--sidebar-item-spacing) !important;
+  padding-top: 16px !important;
+  padding-bottom: 2rem !important;
+}
+
+body[data-theme="dusk"] .sidebar-scroll .sidebar-nav-groups > div {
+  display: flex !important;
+  flex-direction: column !important;
+  gap: var(--sidebar-item-spacing) !important;
+  margin-top: 24px !important;
+}
+
+body[data-theme="dusk"] .sidebar-scroll .sidebar-nav-groups > div:first-child {
+  margin-top: 0 !important;
+}
+
+@media (min-width: 1024px) {
+  body[data-theme="dusk"] .sidebar-scroll nav > .sidebar-nav-groups:first-child {
+    padding-top: 2.5rem !important;
+  }
+}
+
+/* Height cap — REQUIRED for a tall nav to scroll. Fill the layout row rather
+   than measuring 100vh minus a hardcoded header (theme-sidebar-height.test.ts
+   fails the old calc form). Pairs with `lg:max-h-full` on the <aside>. */
+@media (min-width: 1024px) {
+  body[data-theme="dusk"] .sidebar-scroll {
+    position: sticky !important;
+    top: 0 !important;
+    flex: 1 1 auto !important;
+    min-height: 0 !important;
+    max-height: none !important;
+  }
+}
+
+body[data-theme="dusk"] .sidebar-scroll ul {
+  display: flex !important;
+  flex-direction: column !important;
+  gap: var(--sidebar-item-spacing) !important;
+}
+
+body[data-theme="dusk"] .sidebar-scroll nav div div {
+  display: flex !important;
+  flex-direction: column !important;
+  gap: var(--sidebar-item-spacing) !important;
+}
+
+/* ===== CODE PANELS ===== */
+/* Every theme must pad this — base.css gives it none (REFERENCE.md
+   #per-theme-code-panel-gutter-invariant). jam's value. */
+@media (min-width: 1024px) {
+  body[data-theme="dusk"] .code-panels-sidebar {
+    padding-right: 16px;
+  }
+}
+
+/* ===== MOBILE ===== */
+@media (max-width: 1023px) {
+  body[data-theme="dusk"] header[data-has-tabs] > div {
+    margin: 0 !important;
+    padding-left: 0.5rem;
+    padding-right: 0.5rem;
+  }
+
+  body[data-theme="dusk"] #main-content article {
+    padding-left: 0.5rem !important;
+    padding-right: 0.5rem !important;
+  }
+}

package/vendored/themes/index.ts

@@ -100,12 +100,40 @@ const haloTheme: ThemeConfig = {
   cssPath: 'halo/variables.css',
 };
 
+const duskTheme: ThemeConfig = {
+  name: 'dusk',
+  displayName: 'Dusk',
+  description: 'Quiet and flat — one calm surface, clear borders, high-contrast text and a serif title',
+  layout: 'header-logo',
+  defaultTabsPosition: 'left',
+  fonts: {
+    // Matches jam's own Inter config — jam is the source of truth for Inter.
+    primary: {
+      family: 'Inter',
+      googleFontUrl: 'https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap',
+      fallback: 'ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+    },
+    mono: {
+      family: 'JetBrains Mono',
+      googleFontUrl: 'https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500&display=swap',
+      fallback: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace',
+    },
+    heading: {
+      family: 'IBM Plex Serif',
+      googleFontUrl: 'https://fonts.googleapis.com/css2?family=IBM+Plex+Serif:wght@400;600&display=swap',
+      fallback: "'Times New Roman', serif",
+    },
+  },
+  cssPath: 'dusk/variables.css',
+};
+
 // Theme registry
 const themes: Record<ThemeName, ThemeConfig> = {
   jam: jamTheme,
   nebula: nebulaTheme,
   pulsar: pulsarTheme,
   halo: haloTheme,
+  dusk: duskTheme,
 };
 
 /**

package/vendored/themes/jam/variables.css

@@ -235,11 +235,12 @@ html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-d
   background-color: transparent !important;
 }
 
-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"]):not([data-decoration="grid"]) > div > div.flex > main {
+/* Anchored on [data-jd-layout-root], not a bare `> div`: CodePanelModal
+   portals a `div[role="dialog"] > div.flex` into <body>, and the bare form
+   stripped the modal panel's own background (a `:not([role="dialog"])` on the
+   inner div guarded the wrong level). agent-directive-theme-isolation.test.ts
+   keeps body-anchored rules off every other <body> child. */
+html:not(.dark) body[data-theme="jam"]:not([data-decoration="none"]):not([data-decoration="grid"]) > div[data-jd-layout-root] > div.flex:not(:has([data-chat-panel])) {
   background-color: transparent !important;
 }
 

package/vendored/themes/nebula/variables.css

@@ -248,7 +248,7 @@ body[data-theme="nebula"] .sidebar-tabs {
 /* Header divider. Targets the nav header by its data-has-tabs attribute, not a
    child-combinator chain from <body>: the old `body > div > header` form broke
    silently when LayoutWrapper nested the header three levels down, and Nebula
-   shipped with no divider (nebula-header-divider.test.tsx). The header is
+   shipped with no divider (theme-layout-selectors.test.tsx). The header is
    sticky, which already anchors ::after, so it needs no position of its own.
    The -1rem / -1.5rem insets span the layout column's `px-4 lg:px-6`: the line
    runs edge to edge up to --layout-max-width without lifting the column's

package/vendored/themes/pulsar/variables.css

@@ -1019,9 +1019,10 @@ body[data-theme="pulsar"] header [data-theme-toggle] {
     background-color: var(--color-bg-primary) !important;
   }
 
-  /* Ensure content area starts at top with no gap. :not() spares the
-     sr-only agent directive, which is also a body > div. */
-  body[data-theme="pulsar"] > div:not([data-jd-agent-directive]) {
+  /* Ensure content area starts at top with no gap. [data-jd-layout-root],
+     not a bare `> div`: <body> also holds the sr-only agent directive and
+     modal portals (theme-layout-selectors.test.tsx). */
+  body[data-theme="pulsar"] > div[data-jd-layout-root] {
     min-height: 100vh;
     min-height: 100dvh; /* Dynamic viewport height for mobile browsers */
   }

package/vendored/themes/types.ts

@@ -67,6 +67,13 @@ export interface ThemeConfig {
       googleFontUrl?: string;
       fallback: string;
     };
+    /** Optional heading face (Dusk's serif H1). Loaded by next/font in
+     *  production; the dashboard editor preview links googleFontUrl. */
+    heading?: {
+      family: string;
+      googleFontUrl?: string;
+      fallback: string;
+    };
   };
   
   /** CSS file path relative to themes directory */
@@ -82,6 +89,7 @@ export type ThemeName =
   | 'nebula'
   | 'pulsar'
   | 'halo'
+  | 'dusk'
   // Future themes can be added here:
   // | 'linden'
   // | 'willow'