@cbnventures/docusaurus-preset-nova 0.16.2 → 0.18.0

package/build/src/styles/theme/DocSidebarItem/Link/style.css

@@ -1,5 +1,83 @@
 /**
- * DocSidebarItem Link — Shared structural styles.
+ * DocSidebarItem Link - Shared structural styles.
+ *
+ * Owns per-row link concerns - the base structural rules, the inner
+ * link reset (when an `<a>` renders inside a category summary), and
+ * the active-page font-weight bump. Per-preset overlays add color /
+ * hover / active treatments on top.
  *
  * @since 0.15.0
  */
+
+/**
+ * ============================
+ * Link - Base
+ * ============================
+ */
+
+.nova-sidebar-link {
+  display: block;
+
+  text-decoration: none;
+}
+
+/**
+ * ============================
+ * Link - Inside Category Summary (reset)
+ * ============================
+ */
+
+/* Reset structural styles when nested inside a category summary.
+   Negative margin + matching padding makes the link fill the full
+   summary click area so the entire row navigates, not just the text. */
+.nova-sidebar-category-summary .nova-sidebar-link {
+  display: block;
+  flex: 1;
+  margin: calc(-1 * var(--nova-sidebar-category-padding-block, 0.375rem)) calc(-1 * var(--nova-sidebar-category-padding-inline, 0.75rem));
+  padding: var(--nova-sidebar-category-padding-block, 0.375rem) var(--nova-sidebar-category-padding-inline, 0.75rem);
+
+  color: inherit;
+  font: inherit;
+  text-decoration: none;
+
+  background: none;
+  border: none;
+  border-radius: 0;
+}
+
+/* Links inside summary inherit from summary - no own background or hover.
+   Both light and dark variants are declared so the dark selector lifts to
+   specificity (0,0,4,0), which beats per-preset DocSidebarItem/Link bare
+   rules of the form `[data-theme="dark"] .nova-sidebar-link:hover` (also
+   (0,0,3,0)) that would otherwise tie at 3,0 and win on source order,
+   leaking the preset's bare hover/active color and bg into inner links. */
+.nova-sidebar-category-summary .nova-sidebar-link:hover,
+.nova-sidebar-category-summary .nova-sidebar-link:focus-visible,
+[data-theme="dark"] .nova-sidebar-category-summary .nova-sidebar-link:hover,
+[data-theme="dark"] .nova-sidebar-category-summary .nova-sidebar-link:focus-visible {
+  color: inherit;
+  text-decoration: none;
+  background: none;
+}
+
+/* Active category link - summary handles the background; link just inherits
+   color. Same dark-variant specificity bump as the hover rule above.
+   `color: inherit` is inherited from the bare-class rule above; the explicit
+   `background: none` suppresses per-preset active-link backgrounds so they
+   don't stack on top of the summary background (semi-transparent stacking
+   doubles the alpha and creates a visible chevron-zone seam). */
+.nova-sidebar-category-summary .nova-sidebar-link[aria-current="page"],
+[data-theme="dark"] .nova-sidebar-category-summary .nova-sidebar-link[aria-current="page"] {
+  background: none;
+  font-weight: 600;
+}
+
+/**
+ * ============================
+ * Link - Active Page
+ * ============================
+ */
+
+.nova-sidebar-link[aria-current="page"] {
+  font-weight: 600;
+}

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

@@ -1,5 +1,5 @@
 /**
- * Doc Sidebar Item — Shared structural styles.
+ * Doc Sidebar Item - Shared structural styles.
  *
  * @since 0.15.0
  */

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

@@ -1,5 +1,5 @@
 /**
- * Doc Sidebar Items — Shared structural styles.
+ * Doc Sidebar Items - Shared structural styles.
  *
  * @since 0.15.0
  */

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

@@ -1,11 +1,11 @@
 /**
- * Doc Sidebar Mobile — Trigger button, overlay, and panel structural styles.
+ * Doc Sidebar Mobile - Trigger button, overlay, and panel structural styles.
  *
  * @since 0.15.0
  */
 
 /* ============================
- * Trigger — Mobile Only
+ * Trigger - Mobile Only
  * ============================ */
 
 .nova-sidebar-mobile-trigger {
@@ -19,22 +19,15 @@
   font: inherit;
   font-size: 0.8125rem;
   text-align: left;
-  color: var(--nova-color-neutral-600);
+  color: var(--nova-color-text-muted);
 
-  background: var(--nova-color-neutral-50);
-  border: 1px solid var(--nova-color-neutral-200);
+  background: var(--nova-color-surface-raised);
+  border: 1px solid var(--nova-color-border);
   border-radius: 0.375rem;
 
   cursor: pointer;
 }
 
-[data-theme="dark"] .nova-sidebar-mobile-trigger {
-  color: var(--nova-color-neutral-400);
-
-  background: var(--nova-color-neutral-900);
-  border-color: var(--nova-color-neutral-700);
-}
-
 @media (min-width: 1024px) {
   .nova-sidebar-mobile-trigger {
     display: none;
@@ -42,7 +35,7 @@
 }
 
 /* ============================
- * Trigger — Path
+ * Trigger - Path
  * ============================ */
 
 .nova-sidebar-mobile-trigger-path {
@@ -85,7 +78,7 @@
 }
 
 /* ============================
- * Overlay — Open / Close Animation
+ * Overlay - Open / Close Animation
  * ============================ */
 
 @keyframes nova-sidebar-mobile-open {
@@ -131,7 +124,7 @@
   overflow-y: auto;
 }
 
-/* Bridge / Canopy — full-screen, then floating card at 576px+. */
+/* Bridge / Canopy - full-screen, then floating card at 576px+. */
 @media (min-width: 576px) {
   [data-navbar-variant="bridge"] .nova-sidebar-mobile-panel,
   [data-navbar-variant="canopy"] .nova-sidebar-mobile-panel {
@@ -143,7 +136,7 @@
   }
 }
 
-/* Compass — always-float panel. */
+/* Compass - always-float panel. */
 [data-navbar-variant="compass"] .nova-sidebar-mobile-panel {
   width: calc(100% - 2rem);
   max-width: 480px;
@@ -157,7 +150,7 @@
   }
 }
 
-/* Monolith — always-float panel, compact. */
+/* Monolith - always-float panel, compact. */
 [data-navbar-variant="monolith"] .nova-sidebar-mobile-panel {
   width: calc(100% - 2rem);
   max-width: 320px;
@@ -167,7 +160,7 @@
 }
 
 /* ============================
- * Panel — Header
+ * Panel - Header
  * ============================ */
 
 .nova-sidebar-mobile-header {
@@ -177,25 +170,17 @@
 
   padding: 1rem;
 
-  border-bottom: 1px solid var(--nova-color-neutral-300);
-}
-
-[data-theme="dark"] .nova-sidebar-mobile-header {
-  border-bottom-color: var(--nova-color-neutral-800);
+  border-bottom: 1px solid var(--nova-color-border);
 }
 
 .nova-sidebar-mobile-header-title {
   font-weight: 600;
   font-size: 0.875rem;
-  color: var(--nova-color-neutral-900);
-}
-
-[data-theme="dark"] .nova-sidebar-mobile-header-title {
-  color: var(--nova-color-neutral-100);
+  color: var(--nova-color-text);
 }
 
 /* ============================
- * Panel — Close Button
+ * Panel - Close Button
  * ============================ */
 
 .nova-sidebar-mobile-close {
@@ -209,21 +194,17 @@
   height: 2.25rem;
   padding: 0;
 
-  color: var(--nova-color-neutral-500);
+  color: var(--nova-color-text-muted);
 
   background: none;
-  border: 1px solid var(--nova-color-neutral-300);
+  border: 1px solid var(--nova-color-border);
   border-radius: 0.375rem;
 
   cursor: pointer;
 }
 
-[data-theme="dark"] .nova-sidebar-mobile-close {
-  border-color: var(--nova-color-neutral-700);
-}
-
 /* ============================
- * Panel — Content
+ * Panel - Content
  * ============================ */
 
 .nova-sidebar-mobile-content {
@@ -234,3 +215,15 @@
 
   overflow-y: auto;
 }
+
+/* ============================
+ * Panel - Version Switcher
+ * ============================ */
+
+/* The desktop version-switcher in `theme/DocSidebar/style.css` adds
+   `padding-right: 1rem` to leave space alongside the desktop collapse-toggle
+   button. The mobile panel has no toggle, and its own `nova-sidebar-mobile-content`
+   already provides the inset - so reset the wrapper padding here. */
+.nova-sidebar-mobile-panel .nova-sidebar-version-switcher {
+  padding: 0;
+}

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

@@ -1,5 +1,185 @@
 /**
- * Doc Tag Doc List Page — Shared structural styles.
+ * Doc Tag Doc List Page - Shared structural styles.
+ *
+ * Each tagged-doc item renders inside `<article class="nova-col-12">` -
+ * matches the `article[class*="nova-col"] > a` selector pattern that
+ * @theme/DocCard's shared and per-preset CSS already targets, so the
+ * card identity (padding, border, background, hover lift, dark mode)
+ * comes "for free" from the DocCard cascade. The list lays out as a
+ * single full-width column at every viewport (one card per row), more
+ * BlogPostItem-vertical-stack than DocCardList-3up-grid.
  *
  * @since 0.15.0
  */
+
+/*
+ * Page padding - symmetric default scaled to each preset's section-gap
+ * pacing (defined in preset.css at three breakpoints). Presets whose
+ * identity calls for asymmetric breath (e.g. polished-SaaS Envoy with
+ * its gradient CTA, hands-on-industrial Foundry) override `padding-bottom`
+ * in their own theme/DocTagDocListPage/style.css overlay; presets whose
+ * identity reads as balanced inherit the symmetric default.
+ */
+.nova-doc-tag-doc-list-page {
+  padding-block: var(--nova-section-gap);
+}
+
+/*
+ * Page header - grid layout puts h1 on the left and the view-all link on
+ * the right, vertically centered (>=768px). Description, when present,
+ * wraps below as a full-width row. Layout collapses to a single row when
+ * there's no description so empty grid tracks don't leak vertical gap.
+ */
+.nova-doc-tag-doc-list-page-header {
+  display: grid;
+  grid-template-areas:
+    "title"
+    "view-all";
+  gap: 0.75rem;
+
+  margin-bottom: 1.5rem;
+}
+
+.nova-doc-tag-doc-list-page-header:has(> .nova-doc-tag-doc-list-page-description) {
+  grid-template-areas:
+    "title"
+    "description"
+    "view-all";
+}
+
+.nova-doc-tag-doc-list-page-header > .nova-heading {
+  grid-area: title;
+  margin-block: 0;
+}
+
+.nova-doc-tag-doc-list-page-header > .nova-doc-tag-doc-list-page-description {
+  grid-area: description;
+  margin: 0;
+}
+
+.nova-doc-tag-doc-list-page-header > .nova-doc-tag-doc-list-page-all-link {
+  grid-area: view-all;
+  justify-self: start;
+}
+
+@media (min-width: 768px) {
+  .nova-doc-tag-doc-list-page-header {
+    grid-template-areas: "title view-all";
+    grid-template-columns: 1fr auto;
+    align-items: center;
+    column-gap: 1rem;
+  }
+
+  .nova-doc-tag-doc-list-page-header:has(> .nova-doc-tag-doc-list-page-description) {
+    grid-template-areas:
+      "title       view-all"
+      "description description";
+  }
+
+  .nova-doc-tag-doc-list-page-header > .nova-doc-tag-doc-list-page-all-link {
+    justify-self: end;
+  }
+}
+
+.nova-doc-tag-doc-list-page-description {
+  margin: 0 0 0.5rem;
+  font-size: 1rem;
+  color: var(--nova-color-text-muted);
+}
+
+/* "View All Tags" - small button (mirrors `.nova-blog-tags-posts-all-link`
+   and `.nova-blog-author-posts-view-all`). Built locally, token-driven
+   primary tint that auto-adapts per preset. */
+.nova-doc-tag-doc-list-page-all-link {
+  display: inline-flex;
+  align-items: center;
+  flex-shrink: 0;
+
+  padding: 0.375rem 0.875rem;
+
+  font-size: 0.8125rem;
+  font-weight: 600;
+  line-height: 1.4;
+
+  color: var(--nova-color-primary-600);
+  text-decoration: none;
+
+  background-color: transparent;
+  border: 1px solid color-mix(in srgb, var(--nova-color-primary-500), transparent 70%);
+  border-radius: var(--nova-shape-radius);
+
+  transition:
+    background-color var(--nova-motion-duration) ease,
+    border-color var(--nova-motion-duration) ease,
+    color var(--nova-motion-duration) ease;
+}
+
+.nova-doc-tag-doc-list-page-all-link:hover,
+.nova-doc-tag-doc-list-page-all-link:focus-visible {
+  color: var(--nova-color-primary-700);
+  text-decoration: none;
+
+  background-color: color-mix(in srgb, var(--nova-color-primary-500), var(--nova-color-background) 88%);
+  border-color: color-mix(in srgb, var(--nova-color-primary-500), transparent 50%);
+}
+
+[data-theme="dark"] .nova-doc-tag-doc-list-page-all-link {
+  color: var(--nova-color-primary-300);
+}
+
+[data-theme="dark"] .nova-doc-tag-doc-list-page-all-link:hover,
+[data-theme="dark"] .nova-doc-tag-doc-list-page-all-link:focus-visible {
+  color: var(--nova-color-primary-200);
+
+  background-color: color-mix(in srgb, var(--nova-color-primary-500), var(--nova-color-background) 80%);
+  border-color: color-mix(in srgb, var(--nova-color-primary-400), transparent 40%);
+}
+
+/*
+ * Items list - vertical stack of full-width cards (1-up grid). The cards
+ * themselves are styled by @theme/DocCard's `article[class*="nova-col"] > a`
+ * selector cascade, light + dark + hover already wired per-preset.
+ */
+.nova-doc-tag-doc-list-page-items {
+  gap: 1rem;
+}
+
+@media (min-width: 768px) {
+  .nova-doc-tag-doc-list-page-items {
+    gap: 1.25rem;
+  }
+}
+
+/*
+ * Section eyebrow - a derived breadcrumb above the card title showing the
+ * doc's parent path (e.g. id `setup/installation` -> "Setup"). Renders
+ * only when the doc has a parent path; root-level docs skip it.
+ */
+.nova-doc-tag-doc-list-page-item-section {
+  margin: 0 0 0.5rem;
+
+  font-size: 0.75rem;
+  font-weight: 500;
+  line-height: 1.4;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  color: var(--nova-color-text-muted);
+}
+
+/*
+ * Read-article affordance - bottom-of-card CTA that mirrors the
+ * BlogPostItem listing's "Read more" footer. Decorative arrow stays
+ * outside the translated label so localizers don't have to relocate it.
+ */
+.nova-doc-tag-doc-list-page-item-read {
+  display: block;
+  margin-top: 0.5rem;
+
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--nova-color-primary-500);
+}
+
+[data-theme="dark"] .nova-doc-tag-doc-list-page-item-read {
+  color: var(--nova-color-primary-400);
+}

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

@@ -1,5 +1,27 @@
 /**
- * Doc Tags List Page — Shared structural styles.
+ * Doc Tags List Page - Shared structural styles.
  *
  * @since 0.15.0
  */
+
+/*
+ * Page padding - symmetric default scaled to each preset's section-gap
+ * pacing (defined in preset.css at three breakpoints). Presets whose
+ * identity calls for asymmetric breath (e.g. polished-SaaS Envoy with its
+ * gradient CTA, hands-on-industrial Foundry) override `padding-bottom`
+ * in their own theme/DocTagsListPage/style.css overlay; presets whose
+ * identity reads as balanced (Lantern paper, Marshal ledger, Sentinel
+ * dashboard, Signal horizon) inherit the symmetric default.
+ */
+.nova-doc-tags-list-page {
+  padding-block: var(--nova-section-gap);
+}
+
+/*
+ * Page-title heading - direct <Heading as="h1"> child of the page <main>,
+ * scoped here so spacing is governed by the page (not by the per-preset
+ * h1 element selector that targets in-article headings).
+ */
+.nova-doc-tags-list-page > .nova-heading {
+  margin-block: 0 1.5rem;
+}

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

@@ -1,11 +1,21 @@
 /**
  * ============================
- * Version — Banner
+ * Version - Banner
  * ============================
+ *
+ * Mobile keeps a 1rem gap from the sticky `DocSidebarMobile` trigger;
+ * desktop bumps to 1.5rem so the banner doesn't kiss the breadcrumbs row.
  */
 
 .nova-version-banner {
   padding: 8px 16px;
+  margin-bottom: 1rem;
 
   text-align: center;
 }
+
+@media (min-width: 1024px) {
+  .nova-version-banner {
+    margin-bottom: 1.5rem;
+  }
+}

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

@@ -1,5 +1,5 @@
 /**
- * Doc Version Root — Shared structural styles.
+ * Doc Version Root - Shared structural styles.
  *
  * @since 0.15.0
  */

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

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

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

@@ -1,6 +1,6 @@
 /**
  * ============================
- * Edit Meta Row — Layout
+ * Edit Meta Row - Layout
  * ============================
  */
 

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

@@ -1,5 +1,5 @@
 /**
- * Edit This Page — Shared structural styles.
+ * Edit This Page - Shared structural styles.
  *
  * @since 0.15.0
  */

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

@@ -1,6 +1,17 @@
+/**
+ * Error - Shared structural styles.
+ *
+ * Per-surface deltas only - cross-cutting baseline lives on the umbrella
+ * `.nova-error-surface` scope at theme/error-surface/style.css. Error mounts
+ * as the top-level boundary fallback WITHOUT a Layout wrapper, so unlike
+ * NotFound/ErrorPageContent it provides its own centering for the bare case.
+ *
+ * @since 0.15.0
+ */
+
 /**
  * ============================
- * Error — Container
+ * Error - Container (bare-mount centering)
  * ============================
  */
 
@@ -15,3 +26,15 @@
 
   text-align: center;
 }
+
+/**
+ * ============================
+ * Error - Message
+ * ============================
+ */
+
+.nova-error-message {
+  margin: 0;
+
+  color: var(--nova-color-text-muted);
+}

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

@@ -1,5 +1,32 @@
 /**
- * Error Page Content — Shared structural styles.
+ * Error Page Content - Shared structural styles.
+ *
+ * Per-surface deltas only - cross-cutting baseline lives on the umbrella
+ * `.nova-error-surface` scope at theme/error-surface/style.css.
  *
  * @since 0.15.0
  */
+
+/**
+ * ============================
+ * Error Page Content - Actions
+ * ============================
+ */
+
+.nova-error-page-content-actions {
+  margin-bottom: 1.5rem;
+}
+
+/**
+ * ============================
+ * Error Page Content - Message
+ * ============================
+ */
+
+.nova-error-page-content-message {
+  font-family: var(--nova-font-mono);
+  font-size: 0.875rem;
+  line-height: 1.6;
+
+  opacity: 0.85;
+}

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

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