@cbnventures/docusaurus-preset-nova 0.16.2 → 0.18.0

package/build/src/styles/theme/Footer/Embassy/style.css

@@ -1,30 +1,49 @@
 /**
  * ============================
- * Embassy — Social Header
+ * Embassy - Directory
  * ============================
  */
 
-.nova-footer-embassy-social-header {
+.nova-footer-embassy-directory {
   display: flex;
-  align-items: center;
   flex-wrap: wrap;
-  gap: 12px;
+  gap: 16px;
+}
+
+@media (min-width: 640px) {
+  .nova-footer-embassy-directory {
+    gap: 32px;
+  }
 }
 
 /**
  * ============================
- * Embassy — Directory
+ * CTA + Footer Adjacency
+ *
+ * When CTA precedes footer, the CTA owns the visual spacing.
+ * Nullify footer's top margin so they sit adjacent.
  * ============================
  */
 
-.nova-footer-embassy-directory {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 16px;
+.nova-footer-embassy-cta-wrap + .nova-footer-embassy {
+  margin-top: 0;
 }
 
-@media (min-width: 640px) {
-  .nova-footer-embassy-directory {
-    gap: 32px;
-  }
+/**
+ * ============================
+ * CTA Block
+ *
+ * Applies whether <aside> (text-only CTA) or <a> (linked CTA).
+ * ============================
+ */
+
+.nova-footer-embassy-cta {
+  display: block;
+  color: inherit;
+  text-decoration: none;
+}
+
+.nova-footer-embassy-cta:hover,
+.nova-footer-embassy-cta:focus-visible {
+  text-decoration: none;
 }

package/build/src/styles/theme/Footer/Launchpad/style.css

@@ -1,6 +1,6 @@
 /**
  * ============================
- * Launchpad — CTA Block
+ * Launchpad - CTA Block
  * ============================
  */
 
@@ -12,7 +12,7 @@
 
 /**
  * ============================
- * Launchpad — Link Columns
+ * Launchpad - Link Columns
  * ============================
  */
 
@@ -30,7 +30,7 @@
 
 /**
  * ============================
- * Launchpad — Social Links
+ * Launchpad - Social Links
  * ============================
  */
 
@@ -40,3 +40,35 @@
   flex-wrap: wrap;
   gap: 8px;
 }
+
+/**
+ * ============================
+ * CTA + Footer Adjacency
+ *
+ * When CTA precedes footer, the CTA owns the visual spacing.
+ * Nullify footer's top margin so they sit adjacent.
+ * ============================
+ */
+
+.nova-footer-launchpad-cta-wrap + .nova-footer-launchpad {
+  margin-top: 0;
+}
+
+/**
+ * ============================
+ * CTA Block
+ *
+ * Applies whether <aside> (text-only CTA) or <a> (linked CTA).
+ * ============================
+ */
+
+.nova-footer-launchpad-cta {
+  display: block;
+  color: inherit;
+  text-decoration: none;
+}
+
+.nova-footer-launchpad-cta:hover,
+.nova-footer-launchpad-cta:focus-visible {
+  text-decoration: none;
+}

package/build/src/styles/theme/Footer/Ledger/style.css

@@ -1,34 +1,48 @@
 /**
  * ============================
- * Ledger — Bar Layout
+ * Ledger - Bar Layout
+ *
+ * Children stack vertically with equal `gap` between
+ * copyright/links/social/credit at every viewport width.
  * ============================
  */
 
-.nova-footer-ledger {
+.nova-footer-ledger-bar {
   display: flex;
-  align-items: center;
-  justify-content: space-between;
+  flex-direction: column;
   flex-wrap: wrap;
-  gap: 16px;
-  padding: 16px;
+  align-items: flex-start;
+  gap: 0.375rem;
 }
 
 /**
  * ============================
- * Ledger — Links
+ * Ledger - Links
+ *
+ * Mobile: stack each link vertically (column menu).
+ * Desktop (>=640px): inline row.
  * ============================
  */
 
 .nova-footer-ledger-links ul {
   display: flex;
-  align-items: center;
-  flex-wrap: wrap;
-  gap: 16px;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 0;
+}
+
+@media (min-width: 640px) {
+  .nova-footer-ledger-links ul {
+    flex-direction: row;
+    align-items: center;
+    flex-wrap: wrap;
+    gap: 16px;
+  }
 }
 
 /**
  * ============================
- * Ledger — Social Links
+ * Ledger - Social Links
  * ============================
  */
 
@@ -38,3 +52,35 @@
   flex-wrap: wrap;
   gap: 8px;
 }
+
+/**
+ * ============================
+ * CTA + Footer Adjacency
+ *
+ * When CTA precedes footer, the CTA owns the visual spacing.
+ * Nullify footer's top margin so they sit adjacent.
+ * ============================
+ */
+
+.nova-footer-ledger-cta-wrap + .nova-footer-ledger {
+  margin-top: 0;
+}
+
+/**
+ * ============================
+ * CTA Block
+ *
+ * Applies whether <aside> (text-only CTA) or <a> (linked CTA).
+ * ============================
+ */
+
+.nova-footer-ledger-cta {
+  display: block;
+  color: inherit;
+  text-decoration: none;
+}
+
+.nova-footer-ledger-cta:hover,
+.nova-footer-ledger-cta:focus-visible {
+  text-decoration: none;
+}

package/build/src/styles/theme/Footer/style.css

@@ -1,6 +1,23 @@
 /**
  * ============================
- * Footer — Container Scoping
+ * Footer - Tokens
+ *
+ * Component-tier default for the credit-row hover filter
+ * sweep duration. Preset overlays override the canonical
+ * via a rename+alias chain in their preset.css. The
+ * footer surface itself uses preset-level identity tokens
+ * (no shared canonical) since per-variant footer chrome
+ * varies enough that a single token doesn't fit.
+ * ============================
+ */
+
+:root {
+  --nova-footer-filter-duration: 250ms;
+}
+
+/**
+ * ============================
+ * Footer - Container Scoping
  * ============================
  */
 
@@ -10,7 +27,7 @@
 
 /**
  * ============================
- * Footer — Navigation Lists
+ * Footer - Navigation Lists
  * ============================
  */
 

package/build/src/styles/theme/Heading/style.css

@@ -1,9 +1,84 @@
 /**
- * Heading — Shared structural styles.
+ * Heading - Shared structural styles.
+ *
+ * Owns the cross-preset baseline for every `<Heading>` render - scroll
+ * offset, hash-link anchor affordance, and bare-tag vertical-rhythm
+ * margins for h1-h6. Per-preset typography (font-family, font-size,
+ * weight, color, etc.) and any responsive `@media` overrides live in
+ * each preset's `theme/Heading` overlay; the rhythm tokens below are
+ * overridable from those overlays via the rename+alias chain.
+ *
+ * The tokens default to a sentinel-leaning rhythm (the most balanced
+ * preset values from the 9B audit). Presets that diverge as identity
+ * (foundry deeper, signal tighter) re-alias the canonical names from
+ * their preset+component scope.
  *
  * @since 0.15.0
  */
 
+/*
+ * Heading wrapper - shared baseline for every <Heading> render. Per-preset
+ * typography (font-family, font-size, weight, etc.) lives in preset.css /
+ * preset overlays.
+ *
+ * Note: hash-anchor scroll offset is owned by `html { scroll-padding-top: ... }`
+ * in reset.css - NOT scroll-margin-top on this element. Doubling them causes
+ * the heading to land at 2x the navbar height below the viewport top. See
+ * the contract docblock in reset.css for the full --nova-layout-sticky-top
+ * lifecycle (preset rename+alias, system default, runtime JS override).
+ */
+
+/* ============================
+ * Article rhythm - heading top + bottom margins
+ *
+ * Bare-tag selectors so the rhythm applies wherever a heading appears in
+ * MDX article body. Section-headings on landing pages use their own
+ * classes (`.nova-section-heading`, `.nova-hero-eyebrow`, etc.) which
+ * override these baselines, so chrome surfaces are unaffected.
+ * ============================ */
+
+/* Cross-preset uniform: every preset declares `font-family: var(--nova-font-display)`
+   on bare h1-h6 - promoted to shared baseline so the display-font convention
+   ships from the preset's `--nova-font-display` token without each overlay
+   re-declaring the mapping. */
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  font-family: var(--nova-font-display);
+}
+
+h1 {
+  margin-bottom: var(--nova-h1-margin-block-end, 1rem);
+}
+
+h2 {
+  margin-top: var(--nova-h2-margin-block-start, 2rem);
+  margin-bottom: var(--nova-h2-margin-block-end, 0.75rem);
+}
+
+h3 {
+  margin-top: var(--nova-h3-margin-block-start, 1.5rem);
+  margin-bottom: var(--nova-h3-margin-block-end, 0.5rem);
+}
+
+h4 {
+  margin-top: var(--nova-h4-margin-block-start, 1.25rem);
+  margin-bottom: var(--nova-h4-margin-block-end, 0.5rem);
+}
+
+h5 {
+  margin-top: var(--nova-h5-margin-block-start, 1rem);
+  margin-bottom: var(--nova-h5-margin-block-end, 0.375rem);
+}
+
+h6 {
+  margin-top: var(--nova-h6-margin-block-start, 1rem);
+  margin-bottom: var(--nova-h6-margin-block-end, 0.375rem);
+}
+
 /*
  * Hash-link anchor revealed on heading hover or keyboard focus. Rendered as
  * a bare <a> child by @theme/Heading; the "#" glyph lives in the ::before
@@ -13,9 +88,9 @@
 .nova-heading-hash-link {
   margin-inline-start: 0.25em;
   opacity: 0;
-  color: var(--nova-color-neutral-500);
+  color: var(--nova-color-text-muted);
   text-decoration: none !important;
-  transition: opacity 120ms ease, color 120ms ease;
+  transition: opacity var(--nova-motion-duration) ease, color var(--nova-motion-duration) ease;
 }
 
 .nova-heading-hash-link::before {
@@ -31,10 +106,6 @@
   color: var(--nova-color-primary-500);
 }
 
-[data-theme="dark"] .nova-heading-hash-link {
-  color: var(--nova-color-neutral-400);
-}
-
 [data-theme="dark"] .nova-heading-hash-link:hover {
   color: var(--nova-color-primary-400);
 }

package/build/src/styles/theme/LastUpdated/style.css

@@ -1,5 +1,5 @@
 /**
- * Last Updated — Shared structural styles.
+ * Last Updated - Shared structural styles.
  *
  * @since 0.15.0
  */

package/build/src/styles/theme/Layout/Provider/style.css

@@ -1,5 +1,5 @@
 /**
- * Layout Provider — Shared structural styles.
+ * Layout Provider - Shared structural styles.
  *
  * @since 0.15.0
  */

package/build/src/styles/theme/Layout/style.css

@@ -1,5 +1,5 @@
 /**
- * Layout — Shared structural styles.
+ * Layout - Shared structural styles.
  *
  * @since 0.15.0
  */

package/build/src/styles/theme/Loading/style.css

@@ -1,6 +1,6 @@
 /**
  * ============================
- * Loading — Container
+ * Loading - Container
  * ============================
  */
 
@@ -18,57 +18,77 @@
 
 /**
  * ============================
- * Loading — Retry Button
+ * Loading - Spinner
  * ============================
+ *
+ * Pure-CSS rotating ring shown during the `loading` and `timeout` states (the
+ * `error` state has its own retry affordance and stays text-only). Each preset
+ * overrides the ring colors, optional glow, and animation speed in its own
+ * theme/Loading/style.css overlay.
  */
 
-.nova-loading-retry,
-.nova-error-retry {
+.nova-loading-spinner {
+  width: 2rem;
+  height: 2rem;
+
+  border: 2px solid var(--nova-color-border);
+  border-top-color: var(--nova-color-primary-500);
+  border-radius: 50%;
+
+  animation: nova-loading-spinner-rotate 0.8s linear infinite;
+}
+
+[data-theme="dark"] .nova-loading-spinner {
+  border-top-color: var(--nova-color-primary-400);
+}
+
+@keyframes nova-loading-spinner-rotate {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .nova-loading-spinner {
+    animation: none;
+    border-style: dashed;
+  }
+}
+
+/**
+ * ============================
+ * Loading - Retry Button
+ * ============================
+ */
+
+.nova-loading-retry {
   padding: 0.5rem 1rem;
 
   font-size: 0.875rem;
 
   cursor: pointer;
-  border: 1px solid var(--nova-color-neutral-300);
+  border: 1px solid var(--nova-color-border);
   border-radius: var(--nova-shape-radius);
   background: transparent;
   color: inherit;
 
-  transition: border-color 0.2s ease,
-              background-color 0.2s ease;
+  transition: border-color var(--nova-motion-duration) ease,
+              background-color var(--nova-motion-duration) ease;
 }
 
-.nova-loading-retry:hover,
-.nova-error-retry:hover {
+.nova-loading-retry:hover {
   border-color: var(--nova-color-primary-400);
-  background-color: var(--nova-color-neutral-50);
-}
-
-[data-theme="dark"] .nova-loading-retry,
-[data-theme="dark"] .nova-error-retry {
-  border-color: var(--nova-color-neutral-700);
-}
-
-[data-theme="dark"] .nova-loading-retry:hover,
-[data-theme="dark"] .nova-error-retry:hover {
-  border-color: var(--nova-color-primary-600);
-  background-color: rgba(255, 255, 255, 0.04);
+  background-color: var(--nova-color-surface-raised);
 }
 
 /**
  * ============================
- * Loading — Message
+ * Loading - Message
  * ============================
  */
 
-.nova-loading-message,
-.nova-error-message {
+.nova-loading-message {
   margin: 0;
 
-  color: var(--nova-color-neutral-500);
-}
-
-[data-theme="dark"] .nova-loading-message,
-[data-theme="dark"] .nova-error-message {
-  color: var(--nova-color-neutral-400);
+  color: var(--nova-color-text-muted);
 }

package/build/src/styles/theme/Logo/style.css

@@ -0,0 +1,9 @@
+/**
+ * Logo - Shared structural styles.
+ *
+ * Brand `<img>`/`<span>` shared by navbar variants. Visual identity (sizing,
+ * filter, hover) lives in the navbar variant overlays - this file is a
+ * placeholder for any structural rules common to every preset.
+ *
+ * @since 0.18.0
+ */

package/build/src/styles/theme/MDXComponents/style.css

@@ -1,5 +1,17 @@
 /**
- * MDX Components — Shared structural styles.
+ * MDX Components - Shared structural styles.
+ *
+ * Owns styling for any class produced by MDXComponents/index.tsx - currently
+ * just `.nova-table-scroll`, the wrapper that lets wide tables scroll
+ * horizontally inside narrow viewports without pushing page layout.
  *
  * @since 0.15.0
  */
+
+.nova-table-scroll {
+  overflow-x: auto;
+}
+
+.nova-table-scroll table {
+  min-width: 0;
+}

package/build/src/styles/theme/MDXContent/style.css

@@ -1,27 +1,83 @@
 /**
- * MDX Content — Shared structural styles.
+ * MDX Content - Shared structural styles.
+ *
+ * Owns the `.nova-mdx-content` wrapper class produced by MDXContent/index.tsx
+ * around any MDX-rendered subtree. Because `MDXContent` is mounted by
+ * `DocItem/Content` (docs), `BlogPostItem` (blog), and `MDXPage` (custom
+ * pages like `/manifesto`), anything scoped to `.nova-mdx-content` flows
+ * into all three surfaces - keep page-wide MDX rhythm rules here (or in
+ * the corresponding per-preset MDXContent overlay), not in `DocItem/Content`.
+ * Rules truly specific to the doc article shell (e.g. `.nova-doc-content`
+ * or `.nova-doc-content-header`) belong in `DocItem/Content`.
+ *
+ * Article-rhythm tokens (read below) are overridable from each preset's
+ * MDXContent overlay via the rename+alias chain. The inline `var(name,
+ * default)` shape ensures every preset renders MDX bodies with a
+ * comfortable vertical rhythm - no preset can silently inherit browser
+ * defaults (which produce `p { margin-block: 1em }` and `ul,ol
+ * { padding-inline-start: 40px }`, neither of which fits the design
+ * system spacing rhythm). Class-scoped to `.nova-mdx-content` so non-
+ * article `<p>`, `<ul>`, `<li>` elements in chrome surfaces (navbar
+ * dropdowns, hero subtitles, footer credits) are untouched.
  *
  * @since 0.15.0
  */
 
-.nova-mdx-content blockquote p:first-child {
-  margin-top: 0;
+/* ============================
+ * Article rhythm - paragraphs, lists, list items
+ *
+ * Symmetric `margin-block` (top + bottom) so prose flows correctly when
+ * preceded by non-margin-collapsing elements (interactive components,
+ * mixed MDX blocks, embedded React subtrees). Adjacent same-element
+ * siblings still collapse to a single gap.
+ *
+ * Selectors wrapped in `:where()` to give content rhythm a specificity
+ * of zero (only the bare element selector counts). This way any
+ * component-class rule like `.nova-tabs-tab { margin: 0 }` wins over
+ * content rhythm without specificity battles. Without this, the
+ * `.nova-mdx-content li` selector (0,1,1) was beating `.nova-tabs-tab`
+ * (0,1,0) and bleeding a 0.25rem bottom margin into tab strips
+ * rendered inside MDX.
+ *
+ * Canonical tokens kept under their original `*-margin-block-end` names
+ * for backwards compatibility with consumer overrides; consumers see no
+ * breaking change (the same scalar now sets both top and bottom).
+ * ============================ */
+
+:where(.nova-mdx-content) p {
+  margin-block: var(--nova-mdx-paragraph-margin-block-end, 1rem);
 }
 
-.nova-mdx-content blockquote p:last-child {
-  margin-bottom: 0;
+:where(.nova-mdx-content) ul,
+:where(.nova-mdx-content) ol {
+  padding-left: var(--nova-mdx-list-padding-inline-start, 1.5rem);
+  margin-block: var(--nova-mdx-list-margin-block-end, 1rem);
 }
 
-/**
- * ============================
- * MDX Content — Table Overflow
- * ============================
- */
+:where(.nova-mdx-content) li {
+  margin-block: var(--nova-mdx-list-item-margin-block-end, 0.25rem);
+}
+
+/* Reset top margin on the first child of the article so the new
+ * `margin-block-start` value doesn't push the article body down past
+ * the page header rule. Last child reset symmetrically prevents extra
+ * tail-space inside containers with no bottom padding. */
+:where(.nova-mdx-content) > :first-child {
+  margin-block-start: 0;
+}
 
-.nova-table-scroll {
-  overflow-x: auto;
+:where(.nova-mdx-content) > :last-child {
+  margin-block-end: 0;
 }
 
-.nova-table-scroll table {
-  min-width: 0;
+/* ============================
+ * Blockquote - flush paragraph margins inside callout boundary
+ * ============================ */
+
+.nova-mdx-content blockquote p:first-child {
+  margin-top: 0;
+}
+
+.nova-mdx-content blockquote p:last-child {
+  margin-bottom: 0;
 }

package/build/src/styles/theme/MDXPage/style.css

@@ -1,5 +1,24 @@
 /**
- * MDX Page — Shared structural styles.
+ * MDX Page - Shared structural styles.
+ *
+ * Parallel to `theme/DocRoot/Layout/(Main/)style.css` and
+ * `theme/BlogLayout/style.css`: provides the same vertical breathing room
+ * around `<main>` (top + bottom = section-gap / 4) and the same
+ * `min-width: 0` guards that prevent CSS Grid children from overflowing on
+ * narrow viewports. MDXPage has no left sidebar, so the inner two-column
+ * grid (article + right-rail TOC) sits directly inside `<main>`.
  *
  * @since 0.15.0
  */
+
+.nova-mdx-page-root .nova-container,
+.nova-mdx-page-root .nova-grid {
+  min-width: 0;
+}
+
+.nova-mdx-page-root main {
+  min-width: 0;
+
+  padding-top: calc(var(--nova-section-gap) / 4);
+  padding-bottom: calc(var(--nova-section-gap) / 4);
+}