@veluai/velu 0.2.36 → 0.2.37

package/runtime/velu-ui/components/VepaFooter.jsx

@@ -0,0 +1,40 @@
+import React from 'react';
+import Logo from './Logo.jsx';
+import SocialLinks from './SocialLinks.jsx';
+import ThemePreferenceMenu from './ThemePreferenceMenu.jsx';
+
+export default function VepaFooter({ brand, columns = [], socials = [], linkComponent: Link = 'a' }) {
+  const single = columns.length === 1;
+  const completeHeadings = columns.every((c) => c.title);
+  return <footer id="footer" className="vepa-footer" data-layout={columns.length <= 3 ? 'compact' : 'expanded'} data-single={single} data-headings={completeHeadings}>
+    <div className="vepa-footer__inner">
+      <div className="vepa-footer__top">
+        <div className="vepa-footer__brand-column">
+          <Link href={brand?.href || '/'} className="vepa-footer__brand">
+            {brand?.logo ? <Logo logo={brand.logo} alt={brand.label} /> : <span>{brand?.label || 'Velu'}</span>}
+          </Link>
+          <SocialLinks socials={socials} className="vepa-footer__brand-socials" />
+        </div>
+        <div className="vepa-footer__columns" style={{ '--footer-columns': columns.length }}>
+          {columns.map((column, i) => <div className="vepa-footer__column" key={i}>
+            <div className="vepa-footer__links">
+              {column.title && !single && <p className="vepa-footer__heading">{column.title}</p>}
+              {(column.items || []).map((item, j) => {
+                const external = /^https?:\/\//.test(item.href || '');
+                const Tag = external ? 'a' : Link;
+                return <Tag className="vepa-footer__link" key={j} href={item.href || '#'} {...(external ? { target: '_blank', rel: 'noreferrer' } : {})}>{item.label}</Tag>;
+              })}
+            </div>
+          </div>)}
+        </div>
+        <SocialLinks socials={socials} className="vepa-footer__end-socials" />
+      </div>
+      {!completeHeadings && <SocialLinks socials={socials} className="vepa-footer__mobile-socials" />}
+      <div className="vepa-footer__divider" />
+      <div className="vepa-footer__bottom">
+        <a href="https://veludocs.com" target="_blank" rel="noreferrer" className="vepa-footer__powered">Powered by <strong>Velu</strong></a>
+        <ThemePreferenceMenu inline />
+      </div>
+    </div>
+  </footer>;
+}

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

@@ -2,6 +2,7 @@
    (cta hover, image clip, group grid) so this has CSS. Namespaced. */
 
 .velu-card {
+  position: relative;
   display: flex;
   flex-direction: column;
   border: var(--border-width) solid var(--border-color);
@@ -11,6 +12,14 @@
   color: var(--text-color);
   text-decoration: none;
 }
+.velu-card__link { position: absolute; inset: 0; z-index: 1; border-radius: inherit; }
+.velu-card:has(> .velu-card__link):hover { border-color: var(--accent-color); }
+.velu-card__link:focus-visible { outline: 2px solid var(--accent-color); outline-offset: -2px; }
+/* Nested controls must sit above the stretched-link overlay, or clicks hit the card href. */
+.velu-card :is(a, button, input, select, textarea, summary, label):not(.velu-card__link) {
+  position: relative;
+  z-index: 2;
+}
 
 /* CTA card: the whole card is the click target (stretched-link pattern —
    the CTA stays the single real <a>; a ::after overlay makes the entire

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

@@ -45,6 +45,31 @@
     0 0 var(--s2) color-mix(in srgb, #000 18%, transparent),
     0 0 var(--s0) color-mix(in srgb, #000 8%, transparent);
 }
+
+/* Full-page Ask AI (`mode: assistant`). Sits under the navbar and
+   replaces the docs body instead of sliding in as a side panel. */
+.velu-chatbot--page {
+  inset-block-start: var(--velu-header-height, 3.5rem);
+  inset-block-end: 0;
+  inset-inline: 0;
+  inline-size: 100%;
+  max-inline-size: none;
+  transform: none;
+  border-inline-start: 0;
+  border-block-start: var(--border-width) solid var(--surface-color);
+  box-shadow: none;
+  z-index: 5;
+  /* Side gutters so the full-page chat isn't flush to the viewport. */
+  padding-inline: var(--s4);
+}
+.velu-chatbot--page .velu-chatbot__header,
+.velu-chatbot--page .velu-chatbot__body,
+.velu-chatbot--page .velu-chatbot__composer,
+.velu-chatbot--page .velu-chatbot__history {
+  max-inline-size: 42rem;
+  inline-size: 100%;
+  margin-inline: auto;
+}
 /* base.css applies a global `* { max-width: 66ch }`; reset it so the
    panel's structural elements size to flex/the panel, not 66ch. */
 .velu-chatbot * {
@@ -118,6 +143,23 @@
   .velu-chatbot--open {
     transform: translateY(0);
   }
+  /* Page-mode assistant stays a full-viewport chat, not a bottom sheet. */
+  .velu-chatbot--page,
+  .velu-chatbot--page.velu-chatbot--open {
+    inset-block-start: var(--velu-header-height, 3.5rem);
+    inset-block-end: 0;
+    inset-inline: 0;
+    inline-size: 100%;
+    max-inline-size: none;
+    block-size: auto;
+    transform: none;
+    border-radius: 0;
+    padding-block-start: 0;
+    box-shadow: none;
+  }
+  .velu-chatbot--page .velu-chatbot__drag-handle {
+    display: none;
+  }
 }
 
 /* ── Header ─────────────────────────────────────────────────────────── */

package/runtime/velu-ui/components/docs-layout.css

@@ -808,6 +808,81 @@
   }
 }
 
+/* ── Page modes (frontmatter `mode`) ─────────────────────────────────── */
+/* Mintlify-compatible layouts. Default is the current chrome (sidebar +
+   TOC + footer) and needs no extra rules. */
+
+/* Wide: drop the right rail, keep the right gutter, let the article
+   use the extra width inside that gutter. */
+.velu-docs-layout[data-page-mode='wide'] .velu-docs-layout__aside--right,
+.velu-docs-layout[data-page-mode='frame'] .velu-docs-layout__aside--right {
+  display: none;
+}
+.velu-docs-layout[data-page-mode='wide'] .velu-docs-layout__article {
+  max-inline-size: none;
+}
+
+/* Frame is custom canvas + sidebar: no TOC gutter; the landing column
+   is centered in the remaining width next to the sidebar. */
+.velu-docs-layout[data-page-mode='frame'] .velu-docs-layout__center {
+  margin-inline-end: 0;
+}
+
+/* Custom / center / assistant: no sidebar, no TOC. */
+.velu-docs-layout[data-page-mode='custom'] .velu-docs-layout__aside,
+.velu-docs-layout[data-page-mode='center'] .velu-docs-layout__aside,
+.velu-docs-layout[data-page-mode='assistant'] .velu-docs-layout__aside {
+  display: none;
+}
+.velu-docs-layout[data-page-mode='custom'] .velu-docs-layout__center,
+.velu-docs-layout[data-page-mode='center'] .velu-docs-layout__center,
+.velu-docs-layout[data-page-mode='assistant'] .velu-docs-layout__center {
+  margin-inline: 0;
+}
+.velu-docs-layout[data-page-mode='custom'] .velu-docs-layout__sidebar-toggle,
+.velu-docs-layout[data-page-mode='center'] .velu-docs-layout__sidebar-toggle,
+.velu-docs-layout[data-page-mode='assistant'] .velu-docs-layout__sidebar-toggle,
+.velu-docs-layout[data-page-mode='wide'] .velu-toc-bar,
+.velu-docs-layout[data-page-mode='custom'] .velu-toc-bar,
+.velu-docs-layout[data-page-mode='frame'] .velu-toc-bar,
+.velu-docs-layout[data-page-mode='center'] .velu-toc-bar,
+.velu-docs-layout[data-page-mode='assistant'] .velu-toc-bar {
+  display: none;
+}
+
+/* Custom / frame are a landing canvas: center a max-w-4xl column.
+   Frame keeps the sidebar; custom does not. */
+.velu-docs-layout[data-page-mode='custom'] .velu-docs-layout__main,
+.velu-docs-layout[data-page-mode='frame'] .velu-docs-layout__main {
+  padding-block: calc(var(--s5) * 2);
+  padding-inline: var(--s4);
+}
+.velu-docs-layout[data-page-mode='custom'] .velu-docs-layout__article,
+.velu-docs-layout[data-page-mode='frame'] .velu-docs-layout__article {
+  max-inline-size: 56rem;
+  margin-inline: auto;
+}
+.velu-docs-layout[data-page-mode='custom'] .velu-prose > :is(h1, h2, h3, p),
+.velu-docs-layout[data-page-mode='frame'] .velu-prose > :is(h1, h2, h3, p) {
+  max-width: none;
+  text-align: center;
+}
+
+/* Assistant page: the chat fills the viewport below the header. Hide
+   the empty centre column when the chat is showing (no disabled-search
+   fallback). */
+.velu-docs-layout[data-page-mode='assistant']
+  .velu-docs-layout__center:not(:has(.velu-assistant-disabled)) {
+  display: none;
+}
+.velu-assistant-disabled {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-block-size: 70vh;
+  padding: var(--s4) var(--s2);
+}
+
 /* ── 404 takeover ─────────────────────────────────────────────────────── */
 /* On a not-found route the docs chrome (both fixed asides) is hidden and the
    centre column spans full width to center the <NotFound> content. The header

package/runtime/velu-ui/components/page-header.css

@@ -39,6 +39,12 @@
     color-mix(in srgb, #000 55%, transparent);
 }
 
+.velu-header--no-tabs {
+  /* Tabs row is gone — restore bottom padding so brand / search /
+     actions don't sit on the header hairline. Matches the top inset. */
+  padding-block-end: var(--s-1);
+}
+
 /* Once the user has scrolled even a single pixel, the header becomes
    a translucent frosted-glass overlay so the article content shows
    through faintly underneath. color-mix keeps the recipe token-driven:

package/runtime/velu-ui/styles.css

@@ -63,3 +63,4 @@
 @import './components/docs-layout.css' layer(velu);
 @import './components/toc-bar.css' layer(velu);
 @import './components/search.css' layer(velu);
+@import './themes/vepa.css' layer(velu);

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

@@ -0,0 +1,264 @@
+/* Reference: Mintlify client 0.0.3566, Sequoia. Preset selectors are
+   intentionally scoped so a project's unlayered custom CSS still wins. */
+:root:has([data-site-theme='vepa']),
+[data-site-theme='vepa'] {
+  --page-bg: #fff;
+  --text-color: var(--vepa-gray-700);
+  --muted-color: var(--vepa-gray-500);
+  --border-color: var(--vepa-gray-200);
+  --surface-color: var(--vepa-gray-50);
+  --vepa-heading: var(--vepa-gray-900);
+  --vepa-hairline: var(--vepa-gray-100);
+  --velu-aside-right-width: 18rem;
+  --f-h1: 36px;
+  --lh-h1: 40px;
+  --f-h4: 18px;
+  --lh-h4: 28px;
+  font-family: var(--font-sans);
+  color: var(--text-color);
+  font-size: 16px;
+  line-height: 28px;
+  -webkit-font-smoothing: antialiased;
+}
+/* Set the default on the root, while honoring a project's body font override. */
+[data-site-theme='vepa'] { font-family: inherit; }
+:root[data-theme='dark']:has([data-site-theme='vepa']),
+[data-theme='dark'] [data-site-theme='vepa'] {
+  --page-bg: var(--vepa-background-dark);
+  --text-color: var(--vepa-gray-400);
+  --muted-color: var(--vepa-gray-400);
+  --border-color: var(--vepa-gray-800);
+  --surface-color: var(--vepa-gray-900);
+  --vepa-heading: var(--vepa-gray-200);
+  --vepa-hairline: var(--vepa-gray-800);
+}
+[data-site-theme='vepa'] .velu-header {
+  padding: 0;
+  border: 0;
+  box-shadow: inset 0 -1px var(--vepa-hairline);
+  background: var(--page-bg);
+  backdrop-filter: none;
+}
+[data-site-theme='vepa'] .velu-header__top {
+  height: 48px;
+  padding-inline: 24px;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 0;
+}
+[data-site-theme='vepa'] .velu-header__col--center { width: 100%; padding-inline: 8px; }
+[data-site-theme='vepa'] .velu-header__col--center > * { justify-content: center !important; flex-wrap: nowrap !important; }
+[data-site-theme='vepa'] .velu-logo { height: 22px; }
+[data-site-theme='vepa'] .velu-header__wordmark { font-family: inherit; font-size: 30px; line-height: 35px; font-weight: 700; }
+[data-site-theme='vepa'] .velu-header__mark { display: none; }
+[data-site-theme='vepa'] .velu-header__action { font-size: 14px; line-height: 20px; border-radius: 8px; padding: 6px 12px; border: 0; }
+[data-site-theme='vepa'] .velu-header__action--primary { font-weight: 500; }
+[data-theme='dark'] [data-site-theme='vepa'] .velu-header__action--primary { color: #000b; }
+[data-site-theme='vepa'] .velu-header__action--link { font-weight: 400; padding-inline: 8px; }
+[data-site-theme='vepa'] .velu-search__trigger { inline-size: 256px !important; height: 32px; padding: 0 8px; gap: 4px; background: var(--surface-color); border-color: var(--vepa-hairline); border-radius: 8px; font-size: 14px; }
+[data-site-theme='vepa'] .velu-search__trigger-icon svg { width: 16px; height: 16px; }
+[data-site-theme='vepa'] .velu-search__kbd { background: var(--page-bg); border: 0; padding: 2px 6px; font: 500 12px/16px var(--font-sans); border-radius: 4px; }
+[data-site-theme='vepa'] .velu-header__tabs { height: 48px; padding: 0 24px; background: var(--surface-color); }
+[data-site-theme='vepa'] .velu-header__tab { height: 48px; padding-block: 0; font-size: 14px; line-height: 20px; }
+@container docs (min-width: 1024px) {
+  [data-site-theme='vepa'] .velu-header[data-has-tabs='false'] .velu-header__tabs { display: none !important; }
+  [data-site-theme='vepa'] .velu-header__crumbs,
+  [data-site-theme='vepa'] .velu-header__burger { display: none; }
+  [data-site-theme='vepa'] .velu-docs-layout__aside--left { display: flex; width: 288px; top: var(--velu-header-height); bottom: 0; padding: 24px 8px 16px; border-right: 1px solid var(--vepa-hairline); transform: none; }
+  [data-site-theme='vepa'] .velu-docs-layout__center { margin-left: 288px; margin-right: var(--velu-aside-right-width); }
+  [data-site-theme='vepa'] .velu-docs-layout__aside--right { display: block; top: var(--velu-header-height); padding: 16px 32px; width: var(--velu-aside-right-width); border-left: 1px solid var(--vepa-hairline); }
+  [data-site-theme='vepa'] .velu-docs-layout__sidebar-toggle { display: none; }
+}
+[data-site-theme='vepa'] .velu-docs-layout__main { padding: 24px; }
+[data-site-theme='vepa'] .velu-docs-layout__article { max-inline-size: 648px; position: relative; }
+[data-site-theme='vepa'] .velu-sidebar { margin: 0; width: 100%; }
+[data-site-theme='vepa'] :is(.velu-sidebar__section, .velu-api-sidebar__section) { position: static; font: 400 12px/16px var(--font-sans); text-transform: none; letter-spacing: 0; padding: 0 24px 8px; color: var(--vepa-heading); }
+[data-site-theme='vepa'] .velu-sidebar__section::after,
+[data-site-theme='vepa'] .velu-sidebar__indicator { display: none; }
+[data-site-theme='vepa'] .velu-sidebar__item,
+[data-site-theme='vepa'] .velu-sidebar__subitem,
+[data-site-theme='vepa'] .velu-api-sidebar__item { font: 400 14px/20px var(--font-sans); padding: 6px 24px; border-radius: 8px; }
+[data-site-theme='vepa'] :is(.velu-sidebar__item, .velu-api-sidebar__item):hover { background: var(--surface-color); }
+[data-site-theme='vepa'] :is(.velu-sidebar__item--active, .velu-api-sidebar__item--active) { color: var(--accent-color); font-weight: 600; border-inline-start: 0; }
+[data-site-theme='vepa'] :is(.velu-sidebar__list, .velu-api-sidebar__list) { gap: 1px !important; }
+[data-site-theme='vepa'] .velu-sidebar > sidebar-group { gap: 0 !important; margin-bottom: 16px; }
+/* API rows share the guide typography; only HTTP method badges use mono. */
+[data-site-theme='vepa'] .velu-api-sidebar { margin: 0; border: 0; width: 100%; gap: 0 !important; }
+[data-site-theme='vepa'] .velu-api-sidebar__section:not(:first-child) { margin-top: 32px; }
+[data-site-theme='vepa'] .velu-api-sidebar__label { font: inherit; }
+[data-site-theme='vepa'] .velu-api-sidebar__item { gap: 8px; align-items: baseline; }
+[data-site-theme='vepa'] .velu-api-sidebar__item .velu-method-badge { font-size: 10px; line-height: 16px; padding: 0 4px; border: 0; border-radius: 4px; }
+[data-site-theme='vepa'] .velu-context-bar { min-height: 16px; margin-bottom: 10px; }
+[data-site-theme='vepa'] .velu-context-bar__eyebrow { font: 500 12px/16px var(--font-sans); color: var(--accent-color); text-transform: none; letter-spacing: 0; }
+[data-site-theme='vepa'] .velu-context-bar__actions { position: absolute; right: 0; top: 29px; }
+[data-site-theme='vepa'] .velu-context-menu__split { height: 34px; border-radius: 12px; }
+[data-site-theme='vepa'] .velu-context-menu__copy,
+[data-site-theme='vepa'] .velu-context-menu__toggle { font-size: 14px; line-height: 20px; padding: 6px 12px; }
+[data-site-theme='vepa'] .velu-hero { gap: 4px; margin: 0; }
+[data-site-theme='vepa'] .velu-hero + .velu-prose { margin-top: 32px; }
+[data-site-theme='vepa'] .velu-hero h1 { font: 500 36px/40px var(--font-sans); letter-spacing: -.025em; color: var(--vepa-heading); margin: 0; padding-right: 170px; }
+[data-site-theme='vepa'] [data-contextual-actions='false'] .velu-hero h1 { padding-right: 0; }
+[data-site-theme='vepa'] :is(.velu-sidebar__section,.velu-api-sidebar__section) { background: transparent; }
+[data-site-theme='vepa'] .velu-api-page__custom-content { margin-block: 56px; }
+[data-site-theme='vepa'] .velu-hero p { color: var(--text-color) !important; margin: 8px 0 0; font-weight: 400; }
+[data-site-theme='vepa'] .velu-prose { font-size: 16px; line-height: 28px; }
+[data-site-theme='vepa'] .velu-prose > p { margin-block: 20px; max-width: none; }
+[data-site-theme='vepa'] .velu-prose > :first-child { margin-top: 0; }
+[data-site-theme='vepa'] .velu-prose :is(h2,h3,h4) { color: var(--vepa-heading); font-weight: 500; }
+[data-site-theme='vepa'] .velu-prose :is(h2,h3,h4),
+[data-site-theme='vepa'] .velu-card__title { font-family: var(--font-sans); }
+[data-site-theme='vepa'] .velu-prose :where(div > p) { margin-block: 20px; }
+[data-site-theme='vepa'] .velu-card__text > p { margin: 0; }
+[data-site-theme='vepa'] .velu-prose h2 { font-size: 24px; line-height: 32px; margin: 48px 0 16px; }
+.velu-vepa-toc { font: 400 14px/24px var(--font-sans); }
+.velu-vepa-toc { font-family: inherit; }
+.velu-vepa-toc > button { font: 400 12px/16px var(--font-sans); padding: 8px 0; color: var(--muted-color); background: none; border: 0; cursor: pointer; }
+.velu-vepa-toc ul { list-style: none; padding: 0; margin: 0; }
+.velu-vepa-toc ul ul { padding-left: 16px; }
+.velu-vepa-toc a { display: block; padding-block: 4px; color: var(--text-color); text-decoration: none; }
+.velu-vepa-toc a[aria-current] { color: var(--accent-color); font-weight: 500; }
+.velu-theme-menu { position: relative; line-height: 20px; }
+.velu-theme-menu__trigger { width: 32px; height: 32px; display: grid; place-items: center; border: 0; border-radius: 8px; background: transparent; color: var(--muted-color); cursor: pointer; }
+.velu-theme-menu__options { position: absolute; z-index: 40; top: 36px; right: 0; width: 144px; padding: 4px; border: 1px solid var(--border-color); border-radius: 12px; background: var(--page-bg); box-shadow: 0 4px 16px #0002; }
+.velu-theme-menu__options button { display: flex; align-items: center; gap: 8px; width: 100%; border: 0; padding: 8px; background: none; border-radius: 8px; color: var(--text-color); font: 400 14px/20px var(--font-sans); cursor: pointer; }
+.velu-theme-menu__options button span { flex: 1; text-align: left; }
+.velu-theme-menu__options button:focus-visible,
+.velu-theme-menu__options button:hover { outline: none; background: var(--surface-color); }
+[data-site-theme='vepa'] :is(.velu-columns,.velu-card-group) { display: grid; grid-template-columns: repeat(var(--vepa-columns, 2), minmax(0, 1fr)); gap: 16px; margin-block: 28px; }
+[data-site-theme='vepa'] :is(.velu-columns,.velu-card-group) > * { min-width: 0; }
+[data-site-theme='vepa'] .velu-card { border-radius: 16px; }
+[data-site-theme='vepa'] .velu-card__body { padding: 24px; gap: 4px; }
+[data-site-theme='vepa'] .velu-card__icon { width: 24px; height: 24px; font-size: 24px; margin-bottom: 8px; }
+[data-site-theme='vepa'] .velu-card__title { font-size: 16px; line-height: 24px; font-weight: 600; }
+[data-site-theme='vepa'] .velu-card__text { font-size: 16px; line-height: 24px; }
+@container docs (max-width: 1279px) {
+  [data-site-theme='vepa'] .velu-docs-layout__aside--right { display: none; }
+  [data-site-theme='vepa'] .velu-docs-layout__center { margin-right: 0; }
+}
+@container docs (max-width: 1023px) {
+  [data-site-theme='vepa'] .velu-header__top { display: grid; grid-template-columns: minmax(0,1fr) auto auto; padding-inline: 16px; gap: 12px !important; }
+  [data-site-theme='vepa'] .velu-header__col--brand { min-width: 0; flex-wrap: nowrap !important; }
+  [data-site-theme='vepa'] .velu-header__wordmark { font-size: 20px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+  [data-site-theme='vepa'] .velu-header__col--actions { flex-wrap: nowrap !important; gap: 8px !important; }
+  [data-site-theme='vepa'] .velu-header__col--center { padding: 0; }
+  [data-site-theme='vepa'] .velu-header__actions-list,
+  [data-site-theme='vepa'] .velu-header__tab { display: none; }
+  [data-site-theme='vepa'] .velu-header__tabs { height: 56px; padding-inline: 16px; }
+  [data-site-theme='vepa'] .velu-header__crumbs { display: flex; font-size: 14px; line-height: 20px; }
+  [data-site-theme='vepa'] .velu-header__menu { display: flex; order: -1; margin: 0; width: 20px; padding: 0; }
+  [data-site-theme='vepa'] .velu-search__trigger { inline-size: 32px !important; border: 0; background: none; padding: 8px; }
+  [data-site-theme='vepa'] .velu-search__trigger-label,
+  [data-site-theme='vepa'] .velu-search__kbd { display: none; }
+  [data-site-theme='vepa'] .velu-docs-layout__center { margin-inline: 0; }
+  [data-site-theme='vepa'] .velu-docs-layout__sidebar-toggle,
+  [data-site-theme='vepa'] .velu-toc-bar { display: none; }
+  [data-site-theme='vepa'] .velu-docs-layout__aside--left { width: 288px; inset-inline: 0 auto; top: var(--velu-header-height); bottom: 0; padding: 24px 8px; transform: translateX(-100%); z-index: 40; visibility: hidden; }
+  [data-site-theme='vepa'][data-drawer-open='true'] .velu-docs-layout__aside--left { transform: none; visibility: visible; }
+  [data-site-theme='vepa'] :is(.velu-docs-layout__drawer-head,.velu-docs-layout__drawer-select) { display: none; }
+  [data-site-theme='vepa'] .velu-docs-layout__aside--left .velu-sidebar { opacity: 1; pointer-events: auto; }
+  [data-site-theme='vepa'] .velu-context-bar__actions { position: static; margin-top: 12px; }
+  [data-site-theme='vepa'] .velu-context-bar { display: contents !important; }
+  [data-site-theme='vepa'] .velu-docs-layout__article { display: flex; flex-direction: column; }
+  [data-site-theme='vepa'] .velu-context-bar__eyebrow { order: -3; margin-bottom: 10px; }
+  [data-site-theme='vepa'] .velu-hero { order: -2; margin-bottom: 0; }
+  [data-site-theme='vepa'] .velu-hero h1 { padding-right: 0; }
+  [data-site-theme='vepa'] .velu-prose { margin-top: 32px; }
+}
+@container docs (max-width: 639px) {
+  [data-site-theme='vepa'] .velu-hero h1 { font-size: 30px; line-height: 36px; }
+  [data-site-theme='vepa'] :is(.velu-columns,.velu-card-group) { grid-template-columns: 1fr; }
+}
+/* Modes retain their semantic chrome rules; only their measure changes. */
+[data-site-theme='vepa'][data-page-mode='wide'] .velu-docs-layout__center,
+[data-site-theme='vepa'][data-page-mode='frame'] .velu-docs-layout__center { margin-right: 0; }
+[data-site-theme='vepa'][data-page-mode='wide'] .velu-docs-layout__article { max-inline-size: 896px; }
+[data-site-theme='vepa'][data-page-mode='frame'] .velu-docs-layout__article { max-inline-size: 1152px; }
+[data-site-theme='vepa']:is([data-page-mode='custom'],[data-page-mode='center'],[data-page-mode='assistant']) .velu-docs-layout__center { margin-inline: 0; }
+[data-site-theme='vepa']:is([data-page-mode='wide'],[data-page-mode='frame'],[data-page-mode='custom'],[data-page-mode='center'],[data-page-mode='assistant']) .velu-docs-layout__aside--right,
+[data-site-theme='vepa']:is([data-page-mode='custom'],[data-page-mode='center'],[data-page-mode='assistant']) .velu-docs-layout__aside--left { display: none; }
+[data-site-theme='vepa'][data-page-mode='custom'] .velu-docs-layout__article { max-inline-size: none; }
+[data-site-theme='vepa'][data-page-mode='center'] .velu-docs-layout__article { max-inline-size: 768px; }
+
+/* API examples use a code rail, not the padded 18rem TOC. Reserve the
+   same width in the article geometry so neither column overlaps. */
+[data-site-theme='vepa'][data-api='true'] { --velu-aside-right-width: calc(28rem + 24px); }
+[data-site-theme='vepa'][data-api='true'] .velu-docs-layout__aside--right {
+  padding: 24px 24px 24px 0;
+  border-left: 0;
+  min-width: 0;
+}
+[data-site-theme='vepa'] .velu-api-samples { min-width: 0; gap: 24px; }
+[data-site-theme='vepa'] .velu-api-samples > * { min-width: 0; max-width: 100%; }
+[data-site-theme='vepa'] .velu-api-samples :is(pre,code) { font-size: 13px; line-height: 22px; }
+.velu-vepa-request { border: 1px solid var(--border-color); border-radius: 16px; background: var(--surface-color); overflow: hidden; }
+.velu-api-page__inline-samples { display: none; }
+@container docs (max-width: 1279px) {
+  [data-site-theme='vepa'] .velu-api-page__inline-samples { display: block; margin-block: 24px 56px; }
+}
+.velu-vepa-request__header { display: flex; justify-content: space-between; align-items: center; gap: 12px; padding: 8px 12px; font-size: 12px; line-height: 20px; }
+.velu-vepa-request__header select { max-width: 45%; color: var(--muted-color); background: transparent; border: 0; font: inherit; }
+.velu-vepa-request .velu-code-block { border: 0; border-radius: 16px; }
+[data-site-theme='vepa'] .velu-api-page__section { position: relative; margin-block-start: 48px; }
+[data-site-theme='vepa'] .velu-api-page__section > h2 { font: 600 18px/28px var(--font-sans); padding-bottom: 12px; border-bottom: 1px solid var(--border-color); margin: 0 0 24px; }
+.velu-vepa-responses__status { position: absolute; right: 0; top: 4px; font-size: 12px; color: var(--muted-color); }
+.velu-vepa-responses section + section { position: relative; padding-top: 24px; }
+[data-site-theme='vepa'] .velu-api-sidebar .velu-method-badge--get { color: #087443; background: #d6f5e3; }
+[data-site-theme='vepa'] .velu-api-sidebar .velu-method-badge--post { color: #164be9; background: #dfebff; }
+/* Vepa advanced footer: measured against Mintlify Sequoia 0.0.3566. */
+[data-site-theme='vepa'] > [data-velu-footer] { margin-inline-start: 288px; }
+.vepa-footer { border-top: 1px solid var(--vepa-hairline); background: var(--page-bg); }
+.vepa-footer__inner { display: flex; flex-direction: column; gap: 48px; max-width: 984px; width: 100%; margin: auto; padding: 112px 32px; }
+.vepa-footer__top { display: flex; justify-content: space-between; gap: 32px; }
+.vepa-footer__brand-column { display: flex; flex-direction: column; justify-content: space-between; align-items: flex-start; min-width: 192px; gap: 96px; }
+.vepa-footer__brand { color: var(--vepa-heading); text-decoration: none; font-family: inherit; font-size: 30px; line-height: 35px; font-weight: 700; }
+.vepa-footer__brand .velu-logo { height: 26px; max-width: 192px; }
+.vepa-footer__columns { display: grid; grid-template-columns: repeat(var(--footer-columns), minmax(0,1fr)); gap: 32px; flex: 1; min-width: 0; }
+.vepa-footer__column { display: flex; flex-direction: column; align-items: center; }
+.vepa-footer__links { display: flex; flex-direction: column; gap: 16px; min-width: 0; max-width: 100%; }
+.vepa-footer__heading { margin: 0 0 4px; color: var(--vepa-gray-950); font: 600 14px/20px var(--font-sans); }
+.vepa-footer__link { font: 400 14px/20px var(--font-sans); color: color-mix(in srgb, var(--vepa-gray-950) 50%, transparent); max-width: 144px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; text-decoration: none; }
+.vepa-footer__link:hover { color: color-mix(in srgb, var(--vepa-gray-950) 70%, transparent); }
+.vepa-footer .velu-socials { gap: 16px !important; min-width: 140px; max-width: 492px; height: fit-content; }
+.vepa-footer .velu-social { width: 20px; height: 20px; color: var(--vepa-gray-500); }
+.vepa-footer .velu-social svg { width: 20px; height: 20px; }
+.vepa-footer__end-socials { justify-content: flex-end !important; }
+.vepa-footer[data-layout='compact'] .vepa-footer__brand-socials,
+.vepa-footer[data-layout='expanded'] .vepa-footer__end-socials,
+.vepa-footer__mobile-socials { display: none !important; }
+.vepa-footer__divider { height: 1px; background: var(--vepa-hairline); }
+.vepa-footer__bottom { display: flex; justify-content: space-between; align-items: center; }
+.vepa-footer__powered { display: flex; align-items: baseline; gap: 4px; color: var(--vepa-gray-400); font: 400 14px/20px var(--font-sans); text-decoration: none; }
+.vepa-footer__powered strong { font-size: 16px; font-weight: 600; }
+.vepa-footer-theme { display: flex; gap: 8px; }
+.vepa-footer-theme button { display: grid; place-items: center; padding: 6px; background: transparent; border: 0; border-radius: 8px; color: var(--vepa-gray-400); cursor: pointer; }
+.vepa-footer-theme button[aria-pressed='true'] { color: var(--vepa-gray-600); background: var(--vepa-gray-200); }
+.vepa-footer[data-single='true'] .vepa-footer__links { flex-direction: row; align-items: center; justify-content: center; gap: 32px; }
+[data-theme='dark'] .vepa-footer__heading { color: white; }
+[data-theme='dark'] .vepa-footer__link { color: #ffffff80; }
+[data-theme='dark'] .vepa-footer__link:hover { color: #ffffffb3; }
+[data-theme='dark'] .vepa-footer .velu-social { color: var(--vepa-gray-600); }
+[data-theme='dark'] .vepa-footer__divider { background: #ffffff0d; }
+[data-theme='dark'] .vepa-footer__powered { color: var(--vepa-gray-500); }
+[data-theme='dark'] .vepa-footer-theme button { color: var(--vepa-gray-600); }
+[data-theme='dark'] .vepa-footer-theme button[aria-pressed='true'] { color: var(--vepa-gray-400); background: var(--vepa-gray-800); }
+@container docs (max-width: 1023px) {
+  [data-site-theme='vepa'] > [data-velu-footer] { margin-inline-start: 0; }
+  .vepa-footer__inner { padding-block: 80px; }
+  .vepa-footer__brand-column { min-width: 80px; }
+}
+@container docs (max-width: 767px) {
+  .vepa-footer__inner { padding-block: 64px; }
+  .vepa-footer__top { flex-direction: column; }
+  .vepa-footer__brand-column { flex-direction: row; align-items: center; gap: 0; min-width: 64px; }
+  .vepa-footer__column { align-items: flex-start; }
+  .vepa-footer__columns { grid-template-columns: repeat(2,minmax(0,1fr)); }
+  .vepa-footer__link { white-space: normal; }
+  .vepa-footer__end-socials { display: none !important; }
+  .vepa-footer[data-layout='compact'][data-headings='true'] .vepa-footer__brand-socials { display: flex !important; justify-content: flex-end !important; }
+  .vepa-footer[data-headings='false'] .vepa-footer__brand-socials { display: none !important; }
+  .vepa-footer__mobile-socials { display: flex !important; }
+  .vepa-footer[data-single='true'] .vepa-footer__links { flex-direction: column; align-items: flex-start; gap: 16px; }
+}
+@container docs (max-width: 639px) {
+  .vepa-footer__columns { display: flex; flex-direction: column; }
+  .vepa-footer__brand { font-size: 24px; line-height: 30px; }
+}

package/schema/velu.schema.json

@@ -7,6 +7,11 @@
   "required": ["name"],
   "additionalProperties": false,
   "properties": {
+    "theme": {
+      "type": "string",
+      "enum": ["velu", "vepa"],
+      "description": "Visual preset. Vepa follows the Mintlify Sequoia layout; light/dark preference is independent. Defaults to velu."
+    },
     "$schema": {
       "type": "string",
       "description": "URL of this JSON Schema, enabling editor validation + autocomplete."

package/src/navigation.js

@@ -452,8 +452,9 @@ function itemFor(pageNode, pagesMap, ctx) {
   const fm = pagesMap[href]?.frontmatter;
   // Generated API pages carry their own label + HTTP method (for the sidebar
   // method badge); normal pages source their label from frontmatter.
-  const label = pageNode.label ?? fm?.title ?? titleCase(lastSeg(href));
+  const label = pageNode.label ?? fm?.sidebarTitle ?? fm?.title ?? titleCase(lastSeg(href));
   const item = { label, href };
-  if (pageNode.method) item.method = pageNode.method;
+  const method = pageNode.method ?? pagesMap[href]?.operation?.method;
+  if (method) item.method = method;
   return item;
 }