npm - @cbnventures/docusaurus-preset-nova - Versions diffs - 0.17.0 → 0.18.0 - Mend

@cbnventures/docusaurus-preset-nova 0.17.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1988) hide show

package/build/src/styles/theme/Details/style.css CHANGED Viewed

@@ -1,11 +1,43 @@
 /**
- * Details — Component structural styles.
+ * Details - Component structural styles.
  *
  * @since 0.15.0
  */
 /* ============================
- * Details — Summary Button
+ * Details - Tokens
+ *
+ * Component-tier defaults for the disclosure surface
+ * (HTML <details> element). Three bg facets express
+ * default / hover / strong intensity. Preset overlays
+ * re-bind to preset identity primitives.
+ * ============================ */
+:root {
+  --nova-disclosure-bg: var(--nova-color-background);
+  --nova-disclosure-bg-hover: var(--nova-color-surface-raised);
+  --nova-disclosure-bg-strong: rgba(255, 255, 255, 0.95);
+}
+[data-theme="dark"] {
+  --nova-disclosure-bg-strong: rgba(0, 0, 0, 0.85);
+}
+/* ============================
+ * Details - Container rhythm
+ *
+ * `margin-bottom`-only because the disclosure is typically preceded by a
+ * paragraph or list whose own bottom margin handles the top gap via
+ * margin-collapse. Per-preset Details overlays override
+ * `--nova-details-margin-block-end` via the rename+alias chain.
+ * ============================ */
+.nova-details {
+  margin-bottom: var(--nova-details-margin-block-end, 1rem);
+}
+/* ============================
+ * Details - Summary Button
  * ============================ */
 .nova-details-summary {
@@ -27,7 +59,7 @@
 }
 /* ============================
- * Details — Arrow
+ * Details - Arrow
  * ============================ */
 .nova-details-arrow {
@@ -41,7 +73,7 @@
 }
 /* ============================
- * Details — Label
+ * Details - Label
  * ============================ */
 .nova-details-label {
@@ -62,6 +94,7 @@
   list-style: none;
   padding: 0;
   margin: 0;
+  color: inherit;
   font-size: inherit;
   font-weight: inherit;
   line-height: inherit;
@@ -72,7 +105,7 @@
 }
 /* ============================
- * Details — Content (animated show/hide)
+ * Details - Content (animated show/hide)
  * ============================ */
 .nova-details-content {
@@ -91,7 +124,7 @@
 }
 /* ============================
- * Details — Content Body
+ * Details - Content Body
  * ============================ */
 .nova-details-content-body > :first-child {

package/build/src/styles/theme/DocBreadcrumbs/style.css CHANGED Viewed

@@ -1,10 +1,10 @@
 /**
  * ============================
- * Doc Breadcrumbs — Nav
+ * Doc Breadcrumbs - Nav
  * ============================
  */
-/* Hidden on mobile — DocSidebarMobile trigger shows hierarchy instead. */
+/* Hidden on mobile - DocSidebarMobile trigger shows hierarchy instead. */
 .nova-breadcrumbs {
   display: none;
@@ -19,7 +19,7 @@
 /**
  * ============================
- * Doc Breadcrumbs — List
+ * Doc Breadcrumbs - List
  * ============================
  */
@@ -37,7 +37,7 @@
 /**
  * ============================
- * Doc Breadcrumbs — Item
+ * Doc Breadcrumbs - Item
  * ============================
  */
@@ -56,7 +56,7 @@
 /**
  * ============================
- * Doc Breadcrumbs — Home Icon
+ * Doc Breadcrumbs - Home Icon
  * ============================
  */
@@ -71,7 +71,7 @@
 /**
  * ============================
- * Doc Breadcrumbs — Link
+ * Doc Breadcrumbs - Link
  * ============================
  */

package/build/src/styles/theme/DocCard/style.css CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * Doc Card — Shared structural styles.
+ * Doc Card - Shared structural styles.
  *
  * @since 0.15.0
  */
@@ -12,7 +12,12 @@ article[class*="nova-col"] > a {
   color: inherit;
 }
-article[class*="nova-col"] > a:hover {
+/* Override the preset-level `[data-theme="dark"] a:hover` color flip
+ * (specificity 0,2,1) so DocCard inner h2/p stay inherited on hover.
+ * Light mode is already safe; this fixes the asymmetry in dark mode. */
+article[class*="nova-col"] > a:hover,
+article[class*="nova-col"] > a:focus-visible {
+  color: inherit;
   text-decoration: none;
 }
@@ -29,7 +34,7 @@ article[class*="nova-col"] > a h2 img {
   flex-shrink: 0;
 }
-article[class*="nova-col"] > a p {
+article[class*="nova-col"] > a > h2 + p {
   margin-top: 0.5rem;
   font-size: 0.875rem;
 }

package/build/src/styles/theme/DocCardList/style.css CHANGED Viewed

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

package/build/src/styles/theme/DocCategoryGeneratedIndexPage/style.css CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * Doc Category Generated Index Page — Shared structural styles.
+ * Doc Category Generated Index Page - Shared structural styles.
  *
  * @since 0.15.0
  */

package/build/src/styles/theme/DocItem/Content/style.css CHANGED Viewed

@@ -1,6 +1,6 @@
 /**
  * ============================
- * Doc Content — Container
+ * Doc Content - Container
  * ============================
  */
@@ -10,7 +10,7 @@
 /**
  * ============================
- * Doc Content — Header
+ * Doc Content - Header
  * ============================
  */

package/build/src/styles/theme/DocItem/Footer/style.css CHANGED Viewed

@@ -1,6 +1,6 @@
 /**
  * ============================
- * Doc Footer — Layout
+ * Doc Footer - Layout
  * ============================
  */

package/build/src/styles/theme/DocItem/Layout/style.css CHANGED Viewed

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

package/build/src/styles/theme/DocItem/Metadata/style.css CHANGED Viewed

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

package/build/src/styles/theme/DocItem/Paginator/style.css CHANGED Viewed

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

package/build/src/styles/theme/DocItem/TOC/Desktop/style.css CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * DocItem TOC Desktop — Shared structural styles.
+ * DocItem TOC Desktop - Shared structural styles.
  *
  * @since 0.15.0
  */

package/build/src/styles/theme/DocItem/TOC/Mobile/style.css CHANGED Viewed

@@ -1,22 +1,10 @@
 /**
- * DocItem TOC Mobile — Shared structural styles.
+ * DocItem TOC Mobile - Shared structural styles.
  *
- * @since 0.15.0
- */
-/**
- * ============================
- * TOC Mobile — Desktop Visibility
- * ============================
+ * No rules - mobile/desktop visibility is handled by:
+ *  - `theme/TOCCollapsible/style.css` hides the trigger at `min-width: 1024px`.
+ *  - `theme/TOC/style.css` keeps `.nova-toc { display: none }` baseline and
+ *    flips it to `display: block` at `min-width: 1024px`.
  *
- * The mobile TOC (TOCCollapsible) and desktop TOC (TOC) both render
- * unconditionally. CSS controls which one is visible per viewport.
- * The desktop TOC is hidden on mobile via preset DocSidebar CSS.
- * This rule hides the mobile TOC on desktop.
+ * @since 0.15.0
  */
-@media (min-width: 1024px) {
-  .nova-toc-collapsible {
-    display: none;
-  }
-}

package/build/src/styles/theme/DocItem/style.css CHANGED Viewed

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

package/build/src/styles/theme/DocPaginator/style.css CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * Doc Paginator — Shared structural styles.
+ * Doc Paginator - Shared structural styles.
  *
  * @since 0.15.0
  */
@@ -20,7 +20,7 @@
 /**
  * ============================
- * Doc Paginator — Heading
+ * Doc Paginator - Heading
  * ============================
  */
@@ -32,13 +32,12 @@
 /**
  * ============================
- * Doc Paginator — Link
+ * Doc Paginator - Link
  * ============================
  */
 .nova-doc-paginator-link {
   display: flex;
-  flex: 1;
   flex-direction: column;
   gap: 0.25rem;
@@ -52,15 +51,35 @@
 }
 @media (min-width: 640px) {
-  .nova-doc-paginator-link[data-next] {
+  .nova-doc-paginator-link {
+    flex: 1 1 0%;
+    max-width: 50%;
+  }
+  /* Two-link case only: Next sits at the END of the inline axis with
+     content end-aligned. When Next is the only link (first doc page),
+     it inherits the default `start`-aligned layout so it sits under
+     the heading on the same side, matching the single-Previous case
+     on the last doc page. */
+  .nova-doc-paginator-link[data-next]:not(:first-child) {
+    margin-inline-start: auto;
     text-align: right;
     align-items: flex-end;
   }
 }
+/* Chevron icons in the title row are physical assets (arrow-left for
+   previous, arrow-right for next). In RTL the "forward" direction is
+   leftward, so flip horizontally to keep the visual cue aligned with
+   the reading flow. */
+[dir="rtl"] .nova-doc-paginator-title svg {
+  transform: scaleX(-1);
+}
 /**
  * ============================
- * Doc Paginator — Title
+ * Doc Paginator - Title
  * ============================
  */
@@ -76,7 +95,7 @@
 /**
  * ============================
- * Doc Paginator — Label
+ * Doc Paginator - Label
  * ============================
  */
@@ -88,7 +107,7 @@
 /**
  * ============================
- * Doc Paginator — Excerpt
+ * Doc Paginator - Excerpt
  * ============================
  */

package/build/src/styles/theme/DocRoot/Layout/Main/style.css CHANGED Viewed

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

package/build/src/styles/theme/DocRoot/Layout/Sidebar/style.css CHANGED Viewed

@@ -1,10 +1,10 @@
 /**
- * DocRoot Layout Sidebar — Shared structural styles.
+ * DocRoot Layout Sidebar - Shared structural styles.
  *
  * @since 0.15.0
  */
-/* Hidden on mobile — mobile menu provides navigation. */
+/* Hidden on mobile - mobile menu provides navigation. */
 .nova-doc-root aside {
   display: none;
 }

package/build/src/styles/theme/DocRoot/Layout/style.css CHANGED Viewed

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

package/build/src/styles/theme/DocRoot/style.css CHANGED Viewed

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

package/build/src/styles/theme/DocSidebar/style.css CHANGED Viewed

@@ -1,6 +1,6 @@
 /**
  * ============================
- * Sidebar — Nav
+ * Sidebar - Nav
  * ============================
  */
@@ -13,14 +13,14 @@
   .nova-sidebar {
     position: sticky;
     top: var(--nova-layout-sticky-top, 5rem);
-    max-height: calc(100vh - var(--nova-layout-sticky-top, 5rem));
+    height: calc(100vh - var(--nova-layout-sticky-top, 5rem));
     overflow-y: auto;
   }
 }
 /**
  * ============================
- * Sidebar — Collapse Toggle
+ * Sidebar - Collapse Toggle
  * ============================
  */
@@ -38,8 +38,8 @@
   font-size: 14px;
-  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: 50%;
   cursor: pointer;
@@ -47,7 +47,7 @@
 /**
  * ============================
- * Sidebar — Collapsed State
+ * Sidebar - Collapsed State
  * ============================
  */
@@ -57,7 +57,7 @@
 /**
  * ============================
- * Sidebar — List
+ * Sidebar - List
  * ============================
  */
@@ -74,107 +74,36 @@
 /**
  * ============================
- * Sidebar — Link
+ * Sidebar - Version Switcher (inline expand)
  * ============================
+ *
+ * Override the navbar-popover positioning from `theme/NavbarItem/style.css`
+ * so the version dropdown renders inline within the sidebar (accordion
+ * style) rather than as an absolute popover.
  */
-.nova-sidebar-link {
-  display: block;
-  text-decoration: none;
-}
-/* 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. */
-.nova-sidebar-category-summary .nova-sidebar-link:hover {
-  color: inherit;
-  text-decoration: none;
-  background: none;
+.nova-sidebar-version-switcher {
+  margin: 0 0 1rem;
+  padding-right: 1rem;
 }
-/* Active category link — summary handles the background; link just inherits color. */
-.nova-sidebar-category-summary .nova-sidebar-link[aria-current="page"] {
-  font-weight: 600;
-  color: inherit;
-  background: none;
-}
-/**
- * ============================
- * Sidebar — Category
- * ============================
- */
-.nova-sidebar-category-summary {
+.nova-sidebar-version-switcher .nova-version-dropdown-summary {
   display: flex;
+  width: 100%;
   align-items: center;
-  cursor: pointer;
-  list-style: none;
-}
-.nova-sidebar-category-summary::-webkit-details-marker {
-  display: none;
-}
-.nova-sidebar-category-summary::after {
-  display: inline-block;
-  flex-shrink: 0;
-  width: 0.75rem;
-  height: 0.75rem;
-  margin-left: auto;
-  content: "";
-  mask-repeat: no-repeat;
-  mask-position: center;
-  mask-size: contain;
-  transition: transform 200ms ease;
-}
-.nova-sidebar-category-details[open] > .nova-sidebar-category-summary::after {
-  transform: rotate(90deg);
-}
-/**
- * ============================
- * Sidebar — Active Page
- * ============================
- */
-.nova-sidebar-link[aria-current="page"] {
-  font-weight: 600;
+  justify-content: space-between;
 }
-/**
- * ============================
- * Sidebar — Active Peek
- * ============================
- */
-.nova-sidebar-category-details[open] ~ .nova-sidebar-active-peek {
-  display: none;
-}
+/* Popover positioned to the trigger's full width (sidebar column).
+   Override the base `min-width: 8rem` so the menu can match the trigger
+   exactly without forcing an excess width when the sidebar column is narrow.
+   Block padding is left to the preset's Navbar overlay (which already styles
+   `.nova-locale-dropdown-menu, .nova-version-dropdown-menu` together) so the
+   sidebar version dropdown stays in lockstep with the navbar locale dropdown
+   in every preset. */
+.nova-sidebar-version-switcher .nova-version-dropdown-menu {
+  left: 0;
+  right: 0;
-.nova-sidebar-active-peek {
-  margin-left: 1rem;
+  min-width: 0;
 }

package/build/src/styles/theme/DocSidebarItem/Category/style.css CHANGED Viewed

@@ -1,5 +1,64 @@
 /**
- * DocSidebarItem Category — Shared structural styles.
+ * DocSidebarItem Category - Shared structural styles.
+ *
+ * Owns per-row category concerns - collapsible summary base structure,
+ * default-marker hide, chevron mask + open-state rotation, and the
+ * "active peek hides when category is open" sibling rule. Per-preset
+ * overlays add color / hover / active / chevron icon on top.
  *
  * @since 0.15.0
  */
+/**
+ * ============================
+ * Category - Summary
+ * ============================
+ */
+.nova-sidebar-category-summary {
+  display: flex;
+  align-items: center;
+  cursor: pointer;
+  list-style: none;
+}
+.nova-sidebar-category-summary::-webkit-details-marker {
+  display: none;
+}
+.nova-sidebar-category-summary::after {
+  display: inline-block;
+  flex-shrink: 0;
+  width: 0.75rem;
+  height: 0.75rem;
+  margin-left: auto;
+  content: "";
+  mask-repeat: no-repeat;
+  mask-position: center;
+  mask-size: contain;
+  transition: transform var(--nova-motion-duration) ease;
+}
+.nova-sidebar-category-details[open] > .nova-sidebar-category-summary::after {
+  transform: rotate(90deg);
+}
+/**
+ * ============================
+ * Category - Active Peek
+ * ============================
+ *
+ * When a category is collapsed but contains the active page, an active
+ * peek `<a>` renders directly below the summary in the same `<li>`.
+ * When the category is open, hide the peek (the active link inside the
+ * expanded list takes its place).
+ */
+.nova-sidebar-category-details[open] ~ .nova-sidebar-active-peek {
+  display: none;
+}

package/build/src/styles/theme/DocSidebarItem/Html/style.css CHANGED Viewed

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