@veluai/velu 0.2.37 → 0.2.39

package/runtime/velu-ui/components/sidebar.css

@@ -79,29 +79,21 @@
   letter-spacing: 0.02em;
   text-transform: uppercase;
 }
-/* Fade zone just below the pinned heading: a gradient overlay
-   (page-bg → transparent) that sits directly under the sticky header
-   and scrolls with it. Items sliding up pass behind it and fade out
-   before they tuck under the (crisp) heading. Absolutely positioned
-   so it adds no resting layout space; pointer-events:none so it never
-   eats clicks. Hidden by default — only shown once the nav is actually
-   scrolled (the layout toggles it via data-fade-top on the scroll
-   region), so a section's first item isn't faded at rest. */
+/* Softly cover rows as they pass beneath a pinned section label. The fade
+   derives from the sidebar surface so project CSS that recolors #sidebar also
+   recolors the sticky chrome. */
 .velu-sidebar__section::after {
   content: '';
   position: absolute;
   inset-inline: 0;
   inset-block-start: 100%;
-  block-size: var(--s3);
+  block-size: var(--s-2);
+  pointer-events: none;
   background: linear-gradient(
     to bottom,
-    var(--velu-sidebar-bg, var(--page-bg)),
     color-mix(in srgb, var(--velu-sidebar-bg, var(--page-bg)) 55%, transparent),
     transparent
   );
-  pointer-events: none;
-  opacity: 0;
-  transition: opacity 0.15s ease;
 }
 /* When a heading becomes the newly-pinned one (data-stuck set by the
    runtime as you scroll past sections), fade + slide it in so the

package/runtime/velu-ui/primitives/switcher.css

@@ -13,6 +13,10 @@
    own lines (vertical). No media query. */
 .velu-switcher > * {
   flex-grow: 1;
+  /* Flex default `min-width: auto` refuses to shrink below content
+     size and can force the row (then the page) wider than the
+     viewport — the classic sticky-header horizontal-slide bug. */
+  min-inline-size: 0;
   flex-basis: calc(
     (var(--switcher-threshold, var(--measure)) - 100%) * 999
   );

package/runtime/velu-ui/styles.css

@@ -64,3 +64,5 @@
 @import './components/toc-bar.css' layer(velu);
 @import './components/search.css' layer(velu);
 @import './themes/vepa.css' layer(velu);
+@import './themes/thulir.css' layer(velu);
+@import './themes/aalam.css' layer(velu);

package/runtime/velu-ui/themes/aalam.css

@@ -0,0 +1,266 @@
+/* Aalam: Maple layout. Desktop left column is one overflow-y-auto
+   scroller (logo, theme, search, anchors, groups) with a stable gutter. */
+@container docs (min-width: 1024px) {
+  [data-site-theme='aalam'] { --velu-header-height: 48px; --velu-sidebar-width: 19rem; }
+  [data-site-theme='aalam'] .velu-header { position: fixed; top: 0; left: 19rem; width: calc(100% - 19rem); height: 48px; }
+  [data-site-theme='aalam'] .velu-header::before { content: ''; position: fixed; left: calc(19rem - 1px); top: 0; bottom: 0; width: 1px; background: var(--border-color); pointer-events: none; z-index: 1; }
+  [data-site-theme='aalam'] .velu-header__top { display: none; }
+  [data-site-theme='aalam'] .velu-header__tabs { height: 48px; padding-inline: 48px; }
+  [data-site-theme='aalam'] .velu-header__tab { height: 48px; }
+  [data-site-theme='aalam'] .velu-docs-layout__aside--left {
+    left: 0; top: 0; bottom: 0; width: 19rem;
+    padding: 0; border-right: 1px solid var(--border-color);
+  }
+  [data-site-theme='aalam'] .velu-docs-aside-stack {
+    overflow-y: auto;
+    overflow-x: hidden;
+    scrollbar-gutter: stable;
+    padding: 24px 28px;
+    gap: 0 !important;
+    scrollbar-width: thin;
+    scrollbar-color: rgb(0 0 0 / 0.15) transparent;
+  }
+  [data-theme='dark'] [data-site-theme='aalam'] .velu-docs-aside-stack {
+    scrollbar-color: rgb(255 255 255 / 0.2) transparent;
+  }
+  [data-site-theme='aalam'] .velu-docs-aside-stack::-webkit-scrollbar { width: 10px; }
+  [data-site-theme='aalam'] .velu-docs-aside-stack::-webkit-scrollbar-thumb {
+    background: rgb(0 0 0 / 0.15);
+    border-radius: 8px;
+  }
+  [data-theme='dark'] [data-site-theme='aalam'] .velu-docs-aside-stack::-webkit-scrollbar-thumb {
+    background: rgb(255 255 255 / 0.2);
+  }
+  [data-site-theme='aalam'] .velu-docs-nav-region { flex: none; min-block-size: 0; }
+  [data-site-theme='aalam'] .velu-docs-nav-scroll {
+    overflow: visible;
+    flex: none;
+    background-image: none;
+    scrollbar-width: auto;
+  }
+  [data-site-theme='aalam'] .velu-docs-nav-scroll::-webkit-scrollbar { display: unset; width: 0; height: 0; }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-head {
+    display: flex;
+    align-items: flex-start;
+    justify-content: space-between;
+    gap: 8px;
+    padding: 0;
+  }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-close { display: none; }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-brand {
+    display: block;
+    flex: none;
+    max-width: 12rem;
+  }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-brand .velu-header__mark { display: none; }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-brand .velu-header__wordmark {
+    display: block;
+    font-size: 30px;
+    line-height: 1.15;
+    font-weight: 700;
+    letter-spacing: -0.025em;
+  }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-head .velu-theme-toggle {
+    flex: none;
+    width: 3.25rem;
+    height: 1.75rem;
+    padding: 4px;
+    border-radius: 999px;
+    background: transparent;
+  }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-head .velu-theme-toggle::after {
+    content: '';
+    position: absolute;
+    top: 4px;
+    left: 4px;
+    width: 20px;
+    height: 20px;
+    border-radius: 50%;
+    background: color-mix(in srgb, var(--text-color) 10%, transparent);
+    transition: transform 0.2s ease;
+    pointer-events: none;
+  }
+  [data-theme='dark'] [data-site-theme='aalam'] .velu-docs-layout__drawer-head .velu-theme-toggle::after {
+    transform: translateX(1.4rem);
+    background: var(--page-bg);
+  }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-head .velu-theme-toggle__icon {
+    position: absolute;
+    top: 50%;
+    width: 12px;
+    height: 12px;
+    margin: -6px 0 0;
+    opacity: 1 !important;
+    transform: none !important;
+    z-index: 1;
+  }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-head .velu-theme-toggle__icon--sun {
+    left: 8px;
+    inset-inline-start: 8px;
+    color: var(--muted-color);
+  }
+  [data-site-theme='aalam'] .velu-docs-layout__drawer-head .velu-theme-toggle__icon--moon {
+    left: auto;
+    right: 8px;
+    inset-inline-start: auto;
+    inset-inline-end: 8px;
+    color: var(--muted-color);
+  }
+  [data-site-theme='aalam'] .velu-docs-aside-product,
+  [data-site-theme='aalam'] .velu-docs-aside-search { display: block; margin-top: 24px; width: 100%; }
+  [data-site-theme='aalam'] .velu-docs-aside-product + .velu-docs-aside-search { margin-top: 16px; }
+  [data-site-theme='aalam'] .velu-docs-aside-search .velu-search__trigger,
+  [data-site-theme='aalam'] .velu-docs-aside-search #search-bar-entry-sidebar { width: 100% !important; }
+  [data-site-theme='aalam'] .velu-sidebar { width: 100%; margin: 0; }
+  [data-site-theme='aalam'] .velu-docs-layout__center { margin-left: 19rem; margin-right: 312px; padding-top: 48px; }
+  [data-site-theme='aalam'] .velu-docs-layout__main { padding: 44px 32px 0; }
+  [data-site-theme='aalam'] .velu-docs-layout__article { max-inline-size: 576px; margin-inline: auto; }
+  [data-site-theme='aalam'] .velu-docs-layout__aside--right { top: 48px; right: 32px; width: 272px; }
+  [data-site-theme='aalam'] .velu-vepa-toc { padding-top: 40px; }
+  [data-site-theme='aalam'] > [data-velu-footer] { margin-left: 19rem; }
+}
+@container docs (min-width: 1024px) and (max-width: 1279px) {
+  [data-site-theme='aalam'] .velu-docs-layout__center { margin-right: 0; }
+  [data-site-theme='aalam'] .velu-toc-bar { inset-block-start: 48px; }
+}
+[data-site-theme='aalam'] .velu-docs-aside-product .velu-nav-select { display: block; width: 100%; }
+[data-site-theme='aalam'] .velu-docs-aside-product .velu-nav-select__btn {
+  min-height: 32px;
+  height: 32px;
+  padding: 6px 10px;
+  border: 0;
+  border-radius: 12px;
+  font-size: 14px;
+  font-weight: 500;
+  line-height: 20px;
+  background: color-mix(in srgb, var(--text-color) 5%, transparent);
+}
+[data-site-theme='aalam'] .velu-docs-aside-product .velu-nav-select__btn:hover {
+  background: color-mix(in srgb, var(--text-color) 8%, transparent);
+}
+[data-site-theme='aalam'] .velu-docs-aside-footer {
+  flex: none;
+  position: relative;
+  z-index: 2;
+  width: 100%;
+  padding: 12px 16px;
+  border-top: 1px solid var(--border-color);
+  background: var(--page-bg);
+}
+[data-site-theme='aalam'] .velu-docs-aside-footer .velu-nav-select { display: block; width: 100%; }
+[data-site-theme='aalam'] .velu-docs-aside-footer .velu-nav-select__btn {
+  min-height: 32px;
+  height: 32px;
+  padding: 6px 10px;
+  border: 0;
+  border-radius: 8px;
+  font-size: 14px;
+  font-weight: 500;
+  line-height: 20px;
+  background: transparent;
+}
+[data-site-theme='aalam'] .velu-docs-aside-footer .velu-nav-select__btn:hover {
+  background: color-mix(in srgb, var(--text-color) 5%, transparent);
+}
+[data-site-theme='aalam'] .velu-docs-aside-footer .velu-nav-select__menu {
+  inset-block-start: auto;
+  inset-block-end: calc(100% + 4px);
+}
+[data-site-theme='aalam'] .velu-sidebar__indicator { display: none; }
+[data-site-theme='aalam'] .velu-sidebar__section {
+  position: static;
+  font-weight: 500;
+  padding: 0 0 10px 16px;
+  font: 500 14px/20px var(--font-sans);
+  color: var(--thulir-heading);
+  text-transform: none;
+  letter-spacing: 0;
+  background: transparent;
+}
+[data-site-theme='aalam'] .velu-sidebar__section::after { display: none; }
+[data-site-theme='aalam'] .velu-sidebar__icon { inline-size: 16px; block-size: 16px; }
+[data-site-theme='aalam'] .velu-sidebar__section .velu-sidebar__icon { inline-size: 14px; block-size: 14px; }
+[data-site-theme='aalam'] .velu-sidebar__item,
+[data-site-theme='aalam'] .velu-sidebar__subitem,
+[data-site-theme='aalam'] .velu-api-sidebar__item {
+  min-height: 0;
+  margin-inline-start: 16px;
+  padding: 6px 12px 6px 16px;
+  width: calc(100% - 1rem);
+  box-sizing: border-box;
+  border-radius: 0;
+  border-left: 1px solid color-mix(in srgb, var(--text-color) 5%, transparent);
+  gap: 12px;
+  font: 400 14px/20px var(--font-sans);
+  background: transparent;
+}
+[data-site-theme='aalam'] :is(.velu-sidebar__item,.velu-api-sidebar__item):hover {
+  background: transparent;
+  border-left-color: color-mix(in srgb, var(--text-color) 20%, transparent);
+  color: var(--thulir-heading);
+}
+[data-site-theme='aalam'] :is(.velu-sidebar__item--active,.velu-api-sidebar__item--active) {
+  background: transparent;
+  color: var(--accent-color);
+  border-left-color: var(--accent-color);
+  font-weight: 500;
+}
+[data-site-theme='aalam'] .velu-sidebar__list,
+[data-site-theme='aalam'] .velu-api-sidebar__list {
+  margin: 0 !important;
+  padding: 0 !important;
+  border: 0;
+}
+[data-site-theme='aalam'] .velu-sidebar > sidebar-group { margin-bottom: 0; margin-top: 32px; }
+[data-site-theme='aalam'] .velu-api-sidebar {
+  width: 100%;
+  margin: 32px 0 0;
+  gap: 0 !important;
+}
+[data-site-theme='aalam'] .velu-api-sidebar__section {
+  position: static;
+  padding: 0 0 10px 16px;
+  font: 500 14px/20px var(--font-sans);
+  color: var(--thulir-heading);
+  text-transform: none;
+  letter-spacing: 0;
+  background: transparent;
+}
+[data-site-theme='aalam'] .velu-api-sidebar__list + .velu-api-sidebar__section {
+  margin-top: 32px;
+}
+[data-site-theme='aalam'] .velu-docs-anchors {
+  margin-top: 32px;
+  gap: 0;
+  padding: 0;
+}
+[data-site-theme='aalam'] .velu-docs-anchors__link {
+  padding-left: 16px;
+  margin-bottom: 12px;
+  gap: 14px;
+  font: 400 14px/24px var(--font-sans);
+  color: var(--text-color);
+}
+[data-site-theme='aalam'] .velu-docs-anchors__link:hover { color: var(--thulir-heading); }
+[data-site-theme='aalam'] .velu-docs-anchors__icon { color: var(--muted-color); }
+[data-site-theme='aalam'] .velu-docs-anchors__icon svg { width: 16px; height: 16px; }
+[data-site-theme='aalam'] .velu-hero { margin-bottom: 32px; }
+[data-site-theme='aalam'] :is(.velu-header,.velu-docs-layout__drawer-head) .vepa-footer-theme { display: flex; flex: none; align-items: center; gap: 0; padding: 3px; border: 1px solid var(--border-color); border-radius: 999px; }
+[data-site-theme='aalam'] :is(.velu-header,.velu-docs-layout__drawer-head) .vepa-footer-theme button { display: flex; align-items: center; justify-content: center; width: 20px; height: 20px; padding: 0; border: 0; border-radius: 50%; color: var(--muted-color); background: transparent; cursor: pointer; }
+[data-site-theme='aalam'] :is(.velu-header,.velu-docs-layout__drawer-head) .vepa-footer-theme button[aria-pressed='true'] { background: var(--surface-color); color: var(--text-color); }
+[data-site-theme='aalam'] :is(.velu-header,.velu-docs-layout__drawer-head) .vepa-footer-theme svg { width: 12px; height: 12px; }
+@container docs (max-width: 1023px) {
+  [data-site-theme='aalam'] .velu-header__col--actions > .vepa-footer-theme { display: none; }
+  [data-site-theme='aalam'] .velu-docs-aside-search { display: none; }
+  [data-site-theme='aalam'] .velu-docs-aside-product { margin: 16px 16px 0; }
+}
+
+/* Maple-style previous/next — tray chrome lives in page-nav.css;
+   theme only owns spacing against the article column. */
+[data-site-theme='aalam'] .velu-pagenav--aalam {
+  margin-top: 48px;
+  margin-bottom: 48px;
+}
+[data-site-theme='aalam'][data-api='true'] .velu-pagenav--aalam {
+  margin-bottom: 40px;
+}