@veluai/velu 0.2.35 → 0.2.37

package/runtime/velu-ui/primitives/Stack.jsx

@@ -20,11 +20,22 @@ import React from 'react';
  * @param {number|null} [props.splitAfter=null] 1-based child index; everything
  *        after it is pushed to the bottom (margin-block-end:auto on that child)
  */
+
+// React 18 sets props on custom elements (tag names with a hyphen, e.g. the
+// Mintlify-compatible `as="sidebar-group"`) as attributes verbatim, so
+// `className` would come out as a literal className="" attribute. Hand those
+// tags `class` instead. (React 19 maps className for custom elements itself,
+// and accepts `class` too.)
+const isCustomTag = (Tag) => typeof Tag === 'string' && Tag.includes('-');
+const classProp = (Tag, className) =>
+  className == null ? {} : { [isCustomTag(Tag) ? 'class' : 'className']: className };
+
 const Stack = React.forwardRef(function Stack(
   {
     as: Tag = 'div',
     space = 'var(--s1)',
     splitAfter = null,
+    className,
     style,
     children,
     ...rest
@@ -53,6 +64,7 @@ const Stack = React.forwardRef(function Stack(
         ...(splitAfter ? { blockSize: '100%' } : null),
         ...style,
       }}
+      {...classProp(Tag, className)}
       {...rest}
     >
       {kids}

package/runtime/velu-ui/primitives/Switcher.jsx

@@ -22,6 +22,16 @@ import React from 'react';
  * React-native + SSR-safe + tokenized (vs. the browser-only web component
  * which injects a runtime <style>). Needs its own CSS (styles `> *`).
  */
+
+// React 18 sets props on custom elements (tag names with a hyphen, e.g. the
+// Mintlify-compatible `as="sidebar-group"`) as attributes verbatim, so
+// `className` would come out as a literal className="" attribute. Hand those
+// tags `class` instead. (React 19 maps className for custom elements itself,
+// and accepts `class` too.)
+const isCustomTag = (Tag) => typeof Tag === 'string' && Tag.includes('-');
+const classProp = (Tag, className) =>
+  className == null ? {} : { [isCustomTag(Tag) ? 'class' : 'className']: className };
+
 export default function Switcher({
   as: Tag = 'div',
   space = 'var(--s1)',
@@ -42,7 +52,7 @@ export default function Switcher({
 
   return (
     <Tag
-      className={`velu-switcher ${className}`.trim()}
+      {...classProp(Tag, `velu-switcher ${className}`.trim())}
       data-limit-exceeded={exceeded ? '' : undefined}
       style={{
         '--switcher-space': space,

package/runtime/velu-ui/styles.css

@@ -1,9 +1,18 @@
 /* Aggregate stylesheet for velu-ui. Consumers import this once.
 
-   Tailwind v4 first (theme/preflight/utilities — all in @layer).
-   base.css is intentionally UNLAYERED, so it wins over Tailwind's
-   preflight `base` layer — our fluid type/measure beat Tailwind's reset
-   by cascade-layer precedence (unlayered > layered). */
+   Cascade layers, lowest to highest precedence:
+     Tailwind's theme / base (preflight) / components / utilities
+     velu   - everything in this package (base.css + every component sheet)
+     (unlayered) - the PROJECT's own custom CSS (any .css file in a docs
+                   project is linked after this sheet, unlayered)
+   Unlayered styles beat every layer regardless of specificity, so a project
+   can restyle components with Mintlify-style element selectors - a plain
+   `card { border-radius: 0 }` (specificity 0,0,1) overrides `.velu-card`
+   (0,1,0) because velu-ui lives in a layer and the project sheet does not.
+   The `velu` layer is declared after Tailwind's, so our fluid type/measure
+   still beat Tailwind's preflight, as before. */
+@layer theme, base, components, utilities, velu;
+
 @import 'tailwindcss';
 
 /* Map Tailwind's `dark:` variant onto our [data-theme="dark"] attribute
@@ -14,36 +23,44 @@
    and ignores node_modules — velu-ui is reached via a workspace symlink
    there, so its component classes would NOT be scanned. This @source is
    relative to THIS file (packages/velu-ui/src/styles.css); "." == the
-   velu-ui src tree, so Tailwind also scans velu-ui components. */
+   velu-ui src tree, so Tailwind also scans velu-ui components.
+
+   Project MDX/JSX (the docs author's content) is registered as an extra
+   `@source` at `velu dev` / `velu build` time by
+   `veluTailwindProjectSource` in velu-cli — so utilities used in content
+   (`w-full`, `rounded-xl`, `dark:…`, …) are generated too. */
 @source ".";
 
-@import './base.css';
-@import './primitives/switcher.css';
-@import './components/sidebar.css';
-@import './components/nav-select.css';
-@import './components/context-menu.css';
-@import './components/accordion.css';
-@import './components/card.css';
-@import './components/icon.css';
-@import './components/image.css';
-@import './components/code-block.css';
-@import './components/field.css';
-@import './components/prompt.css';
-@import './components/steps.css';
-@import './components/tree.css';
-@import './components/update.css';
-@import './components/changelog-filters.css';
-@import './components/api.css';
-@import './components/api-page.css';
-@import './components/not-found.css';
-@import './components/ask-bar.css';
-@import './components/chatbot.css';
-@import './components/page-feedback.css';
-@import './components/page-nav.css';
-@import './components/page-footer.css';
-@import './components/powered-by.css';
-@import './components/page-header.css';
-@import './components/theme-toggle.css';
-@import './components/docs-layout.css';
-@import './components/toc-bar.css';
-@import './components/search.css';
+@import './base.css' layer(velu);
+@import './element-selectors.css' layer(velu);
+@import './primitives/switcher.css' layer(velu);
+@import './components/sidebar.css' layer(velu);
+@import './components/nav-select.css' layer(velu);
+@import './components/context-menu.css' layer(velu);
+@import './components/accordion.css' layer(velu);
+@import './components/callout.css' layer(velu);
+@import './components/card.css' layer(velu);
+@import './components/icon.css' layer(velu);
+@import './components/image.css' layer(velu);
+@import './components/code-block.css' layer(velu);
+@import './components/field.css' layer(velu);
+@import './components/prompt.css' layer(velu);
+@import './components/steps.css' layer(velu);
+@import './components/tree.css' layer(velu);
+@import './components/update.css' layer(velu);
+@import './components/changelog-filters.css' layer(velu);
+@import './components/api.css' layer(velu);
+@import './components/api-page.css' layer(velu);
+@import './components/not-found.css' layer(velu);
+@import './components/ask-bar.css' layer(velu);
+@import './components/chatbot.css' layer(velu);
+@import './components/page-feedback.css' layer(velu);
+@import './components/page-nav.css' layer(velu);
+@import './components/page-footer.css' layer(velu);
+@import './components/powered-by.css' layer(velu);
+@import './components/page-header.css' layer(velu);
+@import './components/theme-toggle.css' layer(velu);
+@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;
 }