@cbnventures/docusaurus-preset-nova 0.17.0 → 0.18.0

package/build/src/styles/presets/signal/theme/TOCCollapsible/style.css

@@ -1,5 +1,5 @@
 /**
- * Signal — TOC Collapsible visual styling.
+ * Signal - TOC Collapsible visual styling.
  *
  * @since 0.15.0
  */
@@ -11,11 +11,11 @@
 .nova-toc-collapsible-trigger {
   font-family: var(--nova-font-code);
   font-size: 0.75rem;
-  color: var(--nova-color-neutral-500);
+  color: var(--nova-color-text-muted);
 
-  background-color: var(--nova-color-neutral-50);
-  border: 1px solid var(--nova-color-neutral-200);
-  border-radius: 0;
+  background-color: var(--nova-color-surface-raised);
+  border: 1px solid var(--nova-color-border);
+  border-radius: var(--nova-signal-radius-sharp);
 
   transition: border-color var(--nova-motion-duration) ease;
 }
@@ -26,10 +26,7 @@
 }
 
 [data-theme="dark"] .nova-toc-collapsible-trigger {
-  color: var(--nova-color-neutral-400);
-
-  background-color: var(--nova-color-neutral-950);
-  border-color: var(--nova-color-neutral-800);
+  border-color: var(--nova-color-border);
 }
 
 [data-theme="dark"] .nova-toc-collapsible-trigger:hover,
@@ -51,7 +48,7 @@
  * Panel
  * ============================ */
 
-/* Monolith — always-floating, compact. Override base full-screen default. */
+/* Monolith - always-floating, compact. Override base full-screen default. */
 .nova-toc-collapsible-panel {
   width: calc(100% - 2rem);
   max-width: 320px;
@@ -59,10 +56,10 @@
   max-height: calc(100dvh - 4.5rem);
   margin-top: 3.5rem;
 
-  background-color: var(--nova-color-neutral-50);
-  border: 1px solid var(--nova-color-neutral-200);
+  background-color: var(--nova-color-surface-raised);
+  border: 1px solid var(--nova-color-border);
   border-top: 2px solid var(--nova-color-primary-600);
-  border-radius: 0;
+  border-radius: var(--nova-signal-radius-sharp);
 }
 
 @media (min-width: 576px) {
@@ -73,8 +70,7 @@
 }
 
 [data-theme="dark"] .nova-toc-collapsible-panel {
-  background-color: var(--nova-color-neutral-950);
-  border-color: var(--nova-color-neutral-800);
+  border-color: var(--nova-color-border);
   border-top-color: var(--nova-color-primary-500);
 }
 
@@ -95,8 +91,8 @@
  * ============================ */
 
 .nova-toc-collapsible-close {
-  color: var(--nova-color-neutral-500);
-  border-radius: 0;
+  color: var(--nova-color-text-muted);
+  border-radius: var(--nova-signal-radius-sharp);
 
   transition: color var(--nova-motion-duration) ease;
 }
@@ -107,8 +103,7 @@
 }
 
 [data-theme="dark"] .nova-toc-collapsible-close {
-  color: var(--nova-color-neutral-500);
-  border-color: var(--nova-color-neutral-800);
+  border-color: var(--nova-color-border);
 }
 
 [data-theme="dark"] .nova-toc-collapsible-close:hover,
@@ -142,7 +137,11 @@
 
 .nova-toc-collapsible-content .nova-toc-link {
   font-size: 0.75rem;
-  color: var(--nova-color-neutral-400);
+  color: var(--nova-signal-text-soft);
+}
+
+[data-theme="dark"] .nova-toc-collapsible-content .nova-toc-link {
+  color: var(--nova-signal-text-soft);
 }
 
 .nova-toc-collapsible-content .nova-toc-link:hover,

package/build/src/styles/presets/signal/theme/TabItem/style.css

@@ -0,0 +1,8 @@
+/**
+ * Signal - `TabItem` theme overlay.
+ *
+ * Empty by default. The shared `theme/TabItem/style.css` covers the
+ * tab panel padding contract for the entire cohort.
+ *
+ * @since 0.18.0
+ */

package/build/src/styles/presets/signal/theme/Tabs/style.css

@@ -13,19 +13,7 @@
 }
 
 /* ============================
- * 2. Tab List
- * ============================ */
-
-.nova-tabs-list {
-  border-bottom: 1px solid var(--nova-color-neutral-200);
-}
-
-[data-theme="dark"] .nova-tabs-list {
-  border-bottom-color: var(--nova-color-neutral-800);
-}
-
-/* ============================
- * 3. Tab Button
+ * 2. Tab Button
  * ============================ */
 
 .nova-tabs-tab {
@@ -33,15 +21,14 @@
 
   font-size: 0.8125rem;
   font-weight: 600;
-  color: var(--nova-color-neutral-600);
+  color: var(--nova-color-text-muted);
 
   border-bottom: 2px solid transparent;
-  margin-bottom: -1px;
 }
 
 .nova-tabs-tab:hover,
 .nova-tabs-tab:focus-visible {
-  color: var(--nova-color-neutral-900);
+  border-bottom: 2px solid var(--nova-color-primary-400);
 }
 
 .nova-tabs-tab[data-selected="true"] {
@@ -49,10 +36,6 @@
   border-bottom-color: var(--nova-color-primary-600);
 }
 
-[data-theme="dark"] .nova-tabs-tab {
-  color: var(--nova-color-neutral-400);
-}
-
 [data-theme="dark"] .nova-tabs-tab[data-selected="true"] {
   color: var(--nova-color-primary-400);
   border-bottom-color: var(--nova-color-primary-400);

package/build/src/styles/presets/signal/theme/Tag/style.css

@@ -1,5 +1,5 @@
 /**
- * Signal — Tag visual styling.
+ * Signal - Tag visual styling.
  *
  * @since 0.15.0
  */
@@ -10,8 +10,8 @@
   font-size: 0.6875rem;
   text-transform: uppercase;
   letter-spacing: 0.06em;
-  color: var(--nova-color-neutral-500);
-  border: 1px solid var(--nova-color-neutral-200);
+  color: var(--nova-color-text-muted);
+  border: 1px solid var(--nova-color-border);
   border-radius: var(--nova-shape-radius);
   transition: border-color var(--nova-motion-duration) ease,
               color var(--nova-motion-duration) ease;
@@ -25,8 +25,8 @@
 }
 
 [data-theme="dark"] .nova-tag {
-  color: var(--nova-color-neutral-400);
-  border-color: var(--nova-color-neutral-800);
+  color: var(--nova-color-text-muted);
+  border-color: var(--nova-color-border);
 }
 
 [data-theme="dark"] .nova-tag:hover,
@@ -34,44 +34,3 @@
   color: var(--nova-color-primary-400);
   border-color: var(--nova-color-primary-400);
 }
-
-.nova-blog-tags-list-link {
-  padding: 0.125rem 0.375rem;
-  font-family: var(--nova-font-code);
-  font-size: 0.6875rem;
-  text-transform: uppercase;
-  letter-spacing: 0.06em;
-  color: var(--nova-color-neutral-500);
-  border: 1px solid var(--nova-color-neutral-200);
-  border-radius: var(--nova-shape-radius);
-  text-decoration: none;
-  transition: border-color var(--nova-motion-duration) ease,
-              color var(--nova-motion-duration) ease;
-}
-
-.nova-blog-tags-list-link:hover,
-.nova-blog-tags-list-link:focus-visible {
-  color: var(--nova-color-primary-500);
-  border-color: var(--nova-color-primary-500);
-  text-decoration: none;
-}
-
-[data-theme="dark"] .nova-blog-tags-list-link {
-  color: var(--nova-color-neutral-400);
-  border-color: var(--nova-color-neutral-800);
-}
-
-[data-theme="dark"] .nova-blog-tags-list-link:hover,
-[data-theme="dark"] .nova-blog-tags-list-link:focus-visible {
-  color: var(--nova-color-primary-400);
-  border-color: var(--nova-color-primary-400);
-}
-
-.nova-blog-tags-list {
-  margin: 0;
-  padding: 0;
-  list-style: none;
-  display: flex;
-  flex-wrap: wrap;
-  gap: 0.375rem;
-}

package/build/src/styles/presets/signal/theme/TagsListByLetter/style.css

@@ -0,0 +1,9 @@
+/**
+ * Signal - `TagsListByLetter` theme overlay (stub).
+ *
+ * Empty until filled in. The shared structural CSS for this Docusaurus theme
+ * component lives at theme/TagsListByLetter/style.css. Add Signal-specific identity rules here when the
+ * design calls for them; see preset.css for tokens and conventions.
+ *
+ * @since 0.18.0
+ */

package/build/src/styles/presets/signal/theme/ThemeProvider/TitleFormatter/style.css

@@ -0,0 +1,9 @@
+/**
+ * Signal - `ThemeProvider/TitleFormatter` theme overlay (stub).
+ *
+ * Empty until filled in. The shared structural CSS for this Docusaurus theme
+ * component lives at theme/ThemeProvider/TitleFormatter/style.css. Add Signal-specific identity rules here when the
+ * design calls for them; see preset.css for tokens and conventions.
+ *
+ * @since 0.18.0
+ */

package/build/src/styles/presets/signal/theme/ThemeProvider/style.css

@@ -0,0 +1,9 @@
+/**
+ * Signal - `ThemeProvider` theme overlay (stub).
+ *
+ * Empty until filled in. The shared structural CSS for this Docusaurus theme
+ * component lives at theme/ThemeProvider/style.css. Add Signal-specific identity rules here when the
+ * design calls for them; see preset.css for tokens and conventions.
+ *
+ * @since 0.18.0
+ */

package/build/src/styles/presets/signal/theme/ThemedImage/style.css

@@ -0,0 +1,9 @@
+/**
+ * Signal - `ThemedImage` theme overlay (stub).
+ *
+ * Empty until filled in. The shared structural CSS for this Docusaurus theme
+ * component lives at theme/ThemedImage/style.css. Add Signal-specific identity rules here when the
+ * design calls for them; see preset.css for tokens and conventions.
+ *
+ * @since 0.18.0
+ */

package/build/src/styles/presets/signal/theme/error-surface/style.css

@@ -0,0 +1,80 @@
+/**
+ * Signal - `error-surface` umbrella overlay.
+ *
+ * Sharp terminal error surface (404 / per-page crash / top-level boundary).
+ * Display heading with negative letter spacing, mono code body, flat surface
+ * retry button with rose primary hover and square corners.
+ *
+ * @since 0.18.0
+ */
+
+/* ============================
+ * 1. Heading
+ * ============================ */
+
+.nova-error-surface h1 {
+  font-family: var(--nova-font-display);
+  font-weight: 600;
+  letter-spacing: -0.02em;
+  color: var(--nova-signal-text);
+}
+
+[data-theme="dark"] .nova-error-surface h1 {
+  color: var(--nova-signal-text);
+}
+
+/* ============================
+ * 2. Body Copy
+ * ============================ */
+
+.nova-error-surface p {
+  font-family: var(--nova-font-code);
+  color: var(--nova-signal-text-muted);
+}
+
+[data-theme="dark"] .nova-error-surface p {
+  color: var(--nova-signal-text-muted);
+}
+
+/* ============================
+ * 3. Retry Button - Flat Slab
+ * ============================ */
+
+.nova-error-surface button {
+  font-family: var(--nova-font-code);
+
+  color: var(--nova-color-text);
+  background-color: var(--nova-signal-bg);
+  border-color: var(--nova-color-border);
+  border-radius: var(--nova-signal-radius-sharp);
+}
+
+[data-theme="dark"] .nova-error-surface button {
+  color: var(--nova-color-text);
+  background-color: var(--nova-signal-bg);
+  border-color: var(--nova-color-border);
+}
+
+.nova-error-surface button:hover,
+.nova-error-surface button:focus-visible {
+  background-color: var(--nova-color-surface-raised);
+  border-color: var(--nova-color-primary-600);
+}
+
+[data-theme="dark"] .nova-error-surface button:hover,
+[data-theme="dark"] .nova-error-surface button:focus-visible {
+  background-color: var(--nova-color-text);
+  border-color: var(--nova-color-primary-400);
+}
+
+/* ============================
+ * 4. Horizontal Rule
+ * ============================ */
+
+.nova-error-surface hr {
+  border-top-color: var(--nova-color-border);
+}
+
+[data-theme="dark"] .nova-error-surface hr {
+  border-top-color: var(--nova-color-border);
+}

package/build/src/styles/reset.css

@@ -1,5 +1,5 @@
 /**
- * Reset — Universal box model, margin, and typography normalization.
+ * Reset - Universal box model, margin, and typography normalization.
  *
  * @since 0.15.0
  */
@@ -10,6 +10,28 @@
   box-sizing: border-box;
 }
 
+/*
+ * Contract for --nova-layout-sticky-top (consumed below as scroll-padding-top):
+ *
+ *   1. Each preset MUST declare --nova-{preset}-layout-sticky-top in its
+ *      preset.css :root and alias it to --nova-layout-sticky-top. The value
+ *      should equal the rendered sticky-navbar height (or 0 if non-sticky).
+ *   2. The system default in grid.css :root is 0px (no sticky chrome). The
+ *      inline 5rem fallback below is a defense-in-depth safety net that only
+ *      fires if grid.css fails to load.
+ *   3. sticky-layout.ts (loaded as a client module) dynamically overrides
+ *      --nova-layout-sticky-top at runtime via inline style on documentElement
+ *      to track navbar-height changes (announcement-bar dismissal, resize).
+ *      The CSS value is the initial-paint baseline before hydration.
+ *   4. scroll-padding-top is the single source of truth for hash-anchor scroll
+ *      offset - it applies to every scrollable target inside the html scroll
+ *      container, including bare <h2 id> (custom JSX pages) and <Heading>
+ *      (Nova swizzle). Do NOT also set scroll-margin-top on the heading, or
+ *      the two will compound and the heading will land at 2x the navbar
+ *      height below the viewport top.
+ *   5. Same token is also consumed by the sticky-positioning top offset of
+ *      DocSidebar, BlogSidebar, and TOC overlays.
+ */
 html {
   -webkit-text-size-adjust: 100%;
   -moz-tab-size: 4;
@@ -50,3 +72,10 @@ h5,
 h6 {
   overflow-wrap: break-word;
 }
+
+code,
+pre,
+kbd,
+samp {
+  font-family: var(--nova-font-code);
+}

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

@@ -1,6 +1,56 @@
 /**
  * ============================
- * Admonition — Heading
+ * Admonition - Tokens
+ *
+ * Component-tier defaults for the 5 admonition variants.
+ * Each variant exposes the same 3 facets (fill, ink, rail)
+ * so per-preset overlays can override symmetrically. Tokens
+ * default to neutral / semantic system colors; preset.css
+ * overlays re-bind these to preset identity primitives.
+ * ============================
+ */
+
+:root {
+  --nova-admonition-note-fill: transparent;
+  --nova-admonition-note-ink: var(--nova-color-text);
+  --nova-admonition-note-rail: var(--nova-color-border);
+
+  --nova-admonition-tip-fill: transparent;
+  --nova-admonition-tip-ink: var(--nova-color-text);
+  --nova-admonition-tip-rail: var(--nova-color-primary-500);
+
+  --nova-admonition-info-fill: var(--nova-color-info-bg);
+  --nova-admonition-info-ink: var(--nova-color-text);
+  --nova-admonition-info-rail: var(--nova-color-primary-500);
+
+  --nova-admonition-warning-fill: var(--nova-color-warning-bg);
+  --nova-admonition-warning-ink: var(--nova-color-text);
+  --nova-admonition-warning-rail: var(--nova-color-warning-500);
+
+  --nova-admonition-danger-fill: var(--nova-color-danger-bg);
+  --nova-admonition-danger-ink: var(--nova-color-text);
+  --nova-admonition-danger-rail: var(--nova-color-danger-500);
+}
+
+/**
+ * ============================
+ * Admonition - Container rhythm
+ *
+ * Symmetric block margin lets the callout sit cleanly between adjacent
+ * paragraphs/lists, with margin-collapse handling overlap. Per-preset
+ * Admonition overlays may override `--nova-admonition-margin-block` via
+ * the rename+alias chain to tighten (signal terminal density) or widen
+ * (lantern/marshal editorial breathing).
+ * ============================
+ */
+
+.nova-admonition {
+  margin: var(--nova-admonition-margin-block, 1.25rem) 0;
+}
+
+/**
+ * ============================
+ * Admonition - Heading
  * ============================
  */
 
@@ -17,7 +67,7 @@
 
 /**
  * ============================
- * Admonition — Icon
+ * Admonition - Icon
  * ============================
  */
 
@@ -27,7 +77,7 @@
 
 /**
  * ============================
- * Admonition — Body
+ * Admonition - Body
  * ============================
  */
 

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

@@ -1,11 +1,11 @@
 /**
- * Announcement Bar — Component structural styles.
+ * Announcement Bar - Component structural styles.
  *
  * @since 0.15.0
  */
 
 /* ============================
- * Announcement Bar — Container
+ * Announcement Bar - Container
  * ============================ */
 
 .nova-announcement-bar {
@@ -15,7 +15,7 @@
 }
 
 /* ============================
- * Announcement Bar — Content
+ * Announcement Bar - Content
  * ============================ */
 
 .nova-announcement-bar-content {
@@ -24,7 +24,7 @@
 }
 
 /* ============================
- * Announcement Bar — Close Button
+ * Announcement Bar - Close Button
  * ============================ */
 
 .nova-announcement-bar-close {

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

@@ -1,11 +1,18 @@
 /**
- * Back To Top Button — Component structural styles.
+ * Back To Top Button - Shared structural styles.
+ *
+ * The button is always mounted but toggles via `data-visible` so the show/hide
+ * motion can animate cleanly (instead of popping in/out via React mount).
+ * Color/surface/border/shape identity lives in each preset's overlay; the
+ * fade + slide-in motion lives here, tokenized so per-preset can opt out
+ * (e.g. Marshal sets `--nova-back-to-top-transform-hidden: none` for
+ * opacity-only motion).
  *
  * @since 0.15.0
  */
 
 /* ============================
- * Back To Top — Button
+ * Back To Top - Button
  * ============================ */
 
 .nova-back-to-top {
@@ -18,6 +25,19 @@
 
   border: none;
   cursor: pointer;
+
+  opacity: 0;
+  pointer-events: none;
+  transform: var(--nova-back-to-top-transform-hidden, translateY(8px));
+  transition:
+    opacity var(--nova-back-to-top-transition-duration, 220ms) var(--nova-back-to-top-transition-easing, var(--nova-motion-easing)),
+    transform var(--nova-back-to-top-transition-duration, 220ms) var(--nova-back-to-top-transition-easing, var(--nova-motion-easing));
+}
+
+.nova-back-to-top[data-visible="true"] {
+  opacity: 1;
+  pointer-events: auto;
+  transform: var(--nova-back-to-top-transform-shown, translateY(0));
 }
 
 .nova-back-to-top:active {

package/build/src/styles/theme/Blog/Components/Author/Socials/style.css

@@ -0,0 +1,38 @@
+/**
+ * Blog Components - Author - Socials - Shared structural styles.
+ *
+ * Layout-only rules: row of icon links. Color and hover treatment belong in
+ * preset overlays.
+ *
+ * @since 0.18.0
+ */
+
+/* Socials row - horizontal flex of icon links. */
+.nova-blog-author-socials {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+
+  margin-top: 0.25rem;
+}
+
+/* Social link - icon-button container. Background, border, and corner shape
+   come from per-preset overlays so each preset matches its identity. */
+.nova-blog-author-social-link {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+
+  width: 2rem;
+  height: 2rem;
+
+  transition:
+    background-color var(--nova-motion-duration) ease,
+    border-color var(--nova-motion-duration) ease,
+    color var(--nova-motion-duration) ease;
+}
+
+.nova-blog-author-social-icon {
+  width: 1rem;
+  height: 1rem;
+}

package/build/src/styles/theme/Blog/Components/Author/style.css

@@ -0,0 +1,92 @@
+/**
+ * Blog Components - Author - Shared structural styles.
+ *
+ * Layout-only rules: avatar + details flex row, name baseline, image circle.
+ * Color, font, and identity belong in preset overlays.
+ *
+ * @since 0.18.0
+ */
+
+/* Author - flex row with avatar + details. */
+.nova-blog-author {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.75rem;
+}
+
+/* Author image - circular avatar. */
+.nova-blog-author-image {
+  width: 48px;
+  height: 48px;
+
+  border-radius: 50%;
+
+  flex-shrink: 0;
+  object-fit: cover;
+}
+
+.nova-blog-author-image-link {
+  display: block;
+  flex-shrink: 0;
+}
+
+/* Details - vertical stack. */
+.nova-blog-author-details {
+  display: flex;
+  flex-direction: column;
+  gap: 0.125rem;
+
+  min-width: 0;
+}
+
+/* Name + count row. */
+.nova-blog-author-row {
+  display: flex;
+  align-items: baseline;
+  gap: 0.5rem;
+}
+
+.nova-blog-author-name {
+  margin: 0;
+
+  transition: color var(--nova-motion-duration) ease;
+}
+
+/* Name link - preserve color, no underline (Infima's `a:hover` underline is
+   suppressed; hover color shifts via the inner `.nova-blog-author-name`).
+   Presets override the hover color when identity demands a different shade. */
+.nova-blog-author-name-link {
+  color: inherit;
+  text-decoration: none;
+}
+
+.nova-blog-author-name-link:hover,
+.nova-blog-author-name-link:focus-visible {
+  color: inherit;
+  text-decoration: none;
+}
+
+.nova-blog-author-name-link:hover .nova-blog-author-name,
+.nova-blog-author-name-link:focus-visible .nova-blog-author-name {
+  color: var(--nova-color-primary-600);
+}
+
+[data-theme="dark"] .nova-blog-author-name-link:hover .nova-blog-author-name,
+[data-theme="dark"] .nova-blog-author-name-link:focus-visible .nova-blog-author-name {
+  color: var(--nova-color-primary-300);
+}
+
+/* Count - muted, subordinate to name. */
+.nova-blog-author-count {
+  font-size: 0.75rem;
+  color: var(--nova-color-text-muted);
+}
+
+/* Title - muted, subtitle treatment. */
+.nova-blog-author-title {
+  margin: 0;
+
+  font-size: 0.8125rem;
+  line-height: 1.4;
+  color: var(--nova-color-text-muted);
+}