@veluai/velu 0.2.40 → 0.2.42

package/docs/kadhir.md

@@ -0,0 +1,31 @@
+# Kadhir
+
+Kadhir is Velu's independently implemented Luma equivalent. Mintlify migration maps `theme: "luma"` to `theme: "kadhir"`; native Velu sites can select Kadhir directly.
+
+The implementation uses the existing Velu component and navigation infrastructure, with a new single-row 48px desktop header, pill tabs, compact search, a 248px sidebar, a 648px reading column, and a separate API sample rail. Mobile uses the accessible left drawer and on-page TOC. Pagination has 48px separation from content.
+
+Reference: the cached npm renderer `@mintlify/client@0.0.3566`. Luma-specific classes were inspected in `.next/server/chunks/ssr/_6753cfba._.js` and `_450d9e92._.js`. These are reference inputs, not distributed code. Reference API data was generated using `@mintlify/validation@0.1.849` and its `openApiToSchemaGraph` export.
+
+## Local comparison
+
+The fresh fixture is `.incoming/kadhir/source`. It contains 220 pages, three products, two versions, API operations, component examples, and a custom stylesheet/script. The migrated output is `.incoming/kadhir/final`.
+
+```powershell
+node packages/velu-cli/scripts/build.mjs
+node packages/velu-cli/dist/cli.js migrate mintlify .incoming/kadhir/source --out .incoming/kadhir/fresh-output
+$env:PORT='8476'
+node packages/velu-cli/dist/cli.js dev .incoming/kadhir/fresh-output
+```
+
+Browser tests expect that fixture on port 8476:
+
+```powershell
+node --test packages/velu-cli/test/kadhir.test.mjs
+node packages/velu-cli/test/kadhir-tabs-browser.mjs
+node packages/velu-cli/test/kadhir-navigation-browser.mjs
+node packages/velu-cli/test/kadhir-mobile-browser.mjs
+```
+
+Tests cover tab clicks, API content, products/versions, reloads, long sidebars, drawer keyboard behavior, TOC clearance, and overflow. Screenshots and reference preparation scripts are under `.incoming/kadhir/`.
+
+This is not a pixel-perfect guarantee. Icon artwork, syntax highlighting, generated response examples, component spacing, and arbitrary custom DOM selectors can differ. The fixture migration reports compatibility warnings for endpoint snapshots, component adapters, and CSS selectors; review those before deploying a migrated site.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veluai/velu",
-  "version": "0.2.40",
+  "version": "0.2.42",
   "type": "module",
   "bin": "./dist/cli.js",
   "publishConfig": {
@@ -21,7 +21,8 @@
     "docs/vepa.md",
     "docs/thulir.md",
     "docs/aalam.md",
-    "docs/nila.md"
+    "docs/nila.md",
+    "docs/kadhir.md"
   ],
   "scripts": {
     "build": "node scripts/build.mjs",

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

@@ -48,8 +48,27 @@ import Logo from './Logo.jsx';
  *           linkComponent?: React.ElementType, className?: string }} props
  */
 
-// Kept for callers importing the former mark; built-in branding is text-only.
-export function VeluMark() { return null; }
+/* Velu brand mark. Color: --accent-color via the wrapping wordmark
+   span; the path uses currentColor. Exported so consumers (e.g. the
+   mobile nav drawer) can render the mark alongside its own chrome.
+   Only the default theme shows it — the vepa / thulir / aalam / nila
+   presets hide it via CSS (text-only branding). */
+export function VeluMark() {
+  return (
+    <svg
+      className="velu-header__mark"
+      viewBox="0 0 32 24"
+      fill="currentColor"
+      aria-hidden="true"
+    >
+      <path
+        fillRule="evenodd"
+        clipRule="evenodd"
+        d="M29.6564 14.1534C29.5739 14.5616 29.3507 14.9288 29.0248 15.1926C28.699 15.4565 28.2907 15.6007 27.8694 15.6006H21.3702C20.5341 15.6006 19.8051 16.1627 19.6031 16.9638L18.1671 22.6368C18.0685 23.0263 17.8409 23.372 17.5205 23.619C17.2002 23.866 16.8054 24.0001 16.399 24H10.4378C10.1609 24.0001 9.88759 23.9378 9.63868 23.8179C9.38976 23.6979 9.1718 23.5235 9.00135 23.3079C8.8309 23.0923 8.71245 22.8412 8.65499 22.5736C8.59754 22.306 8.6026 22.029 8.66978 21.7636L10.1888 15.7636C10.2874 15.3743 10.5148 15.0287 10.835 14.7817C11.1551 14.5347 11.5496 14.4005 11.9559 14.4004H18.3931C19.2621 14.4004 20.0101 13.7949 20.1801 12.9532L22.3882 2.04774C22.4705 1.63945 22.6936 1.27198 23.0195 1.00793C23.3453 0.74388 23.7538 0.599578 24.1752 0.599605H30.1774C30.4471 0.599529 30.7134 0.658587 30.9572 0.772515C31.201 0.886444 31.4161 1.0524 31.5871 1.25842C31.758 1.46443 31.8806 1.70535 31.9458 1.96383C32.0111 2.2223 32.0175 2.49185 31.9645 2.75305L29.6564 14.1534ZM9.61081 13.5538C9.52825 13.962 9.30507 14.3292 8.97924 14.593C8.65341 14.857 8.24508 15.0011 7.82375 15.001H1.82257C1.55289 15.0011 1.28656 14.942 1.04279 14.8281C0.79902 14.7141 0.583892 14.5482 0.412928 14.3422C0.241965 14.1362 0.11943 13.8952 0.0541639 13.6368C-0.0111017 13.3783 -0.0174699 13.1087 0.0355186 12.8475L2.34359 1.44715C2.42614 1.03904 2.64933 0.671798 2.97516 0.407944C3.30099 0.144089 3.70932 -7.24082e-05 4.13064 7.25899e-08H10.1318C10.4015 -7.55792e-05 10.6678 0.0589818 10.9116 0.172911C11.1554 0.286839 11.3705 0.453799 11.5415 0.659813C11.7124 0.864828 11.835 1.10576 11.9002 1.36423C11.9655 1.62269 11.9719 1.89225 11.9189 2.15344L9.61081 13.5538Z"
+      />
+    </svg>
+  );
+}
 
 function ActionButton({ action, Link, id }) {
   const { label, icon, kind = 'outlined', href, onClick, external, component } = action;
@@ -265,6 +284,7 @@ export default function PageHeader({
         <Logo logo={brand.logo} alt={brandLabel} />
       ) : (
         <>
+          <VeluMark />
           <span className="velu-header__wordmark">{brandLabel}</span>
         </>
       )}

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

@@ -427,7 +427,11 @@
     opacity 0.15s ease,
     transform 0.15s ease,
     visibility 0s linear 0.15s;
-  z-index: 1;
+  /* Above the sidebar nav: its items are `z-index: 1` and sticky
+     section headers `z-index: 2` (sidebar.css), all in the same
+     stacking context as this menu (the drawer aside), so a tie would
+     let the nav paint OVER the dropdown and show through it. */
+  z-index: 30;
 }
 .velu-docs-layout__drawer-docselect[data-open='true']
   .velu-docs-layout__drawer-docselect-menu {
@@ -835,6 +839,16 @@
   display: none;
 }
 
+/* Center mode (changelogs) hides the aside above; at mobile the aside
+   IS the nav drawer, so re-show it there — otherwise changelog pages
+   have no way to reach the navigation. Must come after the page-mode
+   hide rule above (same specificity, later source order wins). */
+@container docs (max-width: 640px) {
+  .velu-docs-layout[data-page-mode='center'] .velu-docs-layout__aside--left {
+    display: flex;
+  }
+}
+
 /* 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,

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

@@ -0,0 +1,73 @@
+/* Kadhir: independent Luma layout, measured with @mintlify/client 0.0.3566.
+   Shared reading components and accessible drawer behavior use thulir.css. */
+[data-site-theme='kadhir'] .velu-pagenav { margin-block: 48px 64px; }
+[data-site-theme='kadhir'] .velu-hero h1 { font-size: 36px; line-height: 36px; font-weight: 500; letter-spacing: -.8px; }
+[data-site-theme='kadhir'] .velu-sidebar__item { background: transparent; min-height: 32px; padding-right: 12px; }
+[data-site-theme='kadhir'] .velu-sidebar__item--active { font-weight: 400; }
+/* Mint Luma marks the selected API endpoint with accent text only — no
+   persistent tint band (thulir.css paints one for the whole family). */
+[data-site-theme='kadhir'] .velu-api-sidebar__item--active { background: transparent; font-weight: 400; }
+/* Mint Luma hover: text shifts to accent, no background wash
+   (thulir.css paints a surface-color bg for the whole family). */
+[data-site-theme='kadhir'] :is(.velu-sidebar__item, .velu-api-sidebar__item):hover { background: transparent; color: var(--accent-color); }
+[data-site-theme='kadhir'] .velu-sidebar__label { white-space: normal; overflow-wrap: anywhere; }
+[data-site-theme='kadhir'] .velu-sidebar__indicator { display: none; }
+[data-site-theme='kadhir'] .velu-sidebar__section { text-transform: capitalize; font-size: 12px; font-weight: 600; }
+[data-site-theme='kadhir'] .velu-docs-nav-scroll { overflow-x: hidden; }
+[data-site-theme='kadhir'] .velu-sidebar__section { padding-inline: 0; }
+[data-site-theme='kadhir'] .velu-docs-nav-scroll { background-image: none; scrollbar-width: thin; scrollbar-color: transparent transparent; }
+[data-site-theme='kadhir'] .velu-docs-nav-scroll:hover { scrollbar-color: var(--border-color) transparent; }
+[data-site-theme='kadhir'] .velu-header__action { border-radius: 999px; }
+[data-site-theme='kadhir'] .velu-header__action--primary { background: var(--accent-color); padding-inline: 16px; }
+[data-site-theme='kadhir'] .velu-header__action--primary::after { display: none; }
+[data-site-theme='kadhir'] .velu-header__action:not(.velu-header__action--primary) { border: 1px solid var(--border-color); padding: 7px 16px; }
+[data-site-theme='kadhir'] .velu-vepa-toc { padding-top: 16px; width: 100%; }
+@container docs (min-width: 1024px) {
+  [data-site-theme='kadhir'] .velu-header { display: grid !important; grid-template-columns: 248px minmax(0,1fr) 36px auto; align-items: center; gap: 8px !important; height: 48px; padding: 0 36px; border-bottom: 1px solid var(--border-color); }
+  [data-site-theme='kadhir'] .velu-header__top { display: contents; }
+  [data-site-theme='kadhir'] .velu-header__top::after { display: none; }
+  [data-site-theme='kadhir'] .velu-header__col--brand { grid-column: 1; grid-row: 1; flex-wrap: nowrap !important; }
+  [data-site-theme='kadhir'] .velu-header__col--brand > .velu-hide-on-mobile { display: flex; gap: 28px; }
+  [data-site-theme='kadhir'] .velu-header .velu-nav-select__btn { border: 0; padding: 4px 8px; background: transparent; font-size: 14px; }
+  [data-site-theme='kadhir'] .velu-header .velu-nav-select__btn-icon { display: none; }
+  [data-site-theme='kadhir'] .velu-docs-context:not(:has(.velu-docs-anchors)) { display: none !important; }
+  [data-site-theme='kadhir'] .velu-header__col--center { grid-column: 3; grid-row: 1; width: 36px; }
+  [data-site-theme='kadhir'] .velu-header__col--actions { grid-column: 4; grid-row: 1; gap: 8px !important; }
+  [data-site-theme='kadhir'] .velu-header__actions-list { gap: 8px !important; }
+  [data-site-theme='kadhir'] .velu-header__tabs { grid-column: 2; grid-row: 1; padding: 0; height: 48px; justify-content: safe center !important; gap: 4px !important; overflow-x: auto; flex-wrap: nowrap !important; }
+  [data-site-theme='kadhir'] .velu-header__tab { padding: 8px 16px; height: 36px; border-radius: 999px; flex: none; }
+  [data-site-theme='kadhir'] .velu-header__tab::after { display: none; }
+  [data-site-theme='kadhir'] .velu-header__tab--active { background: var(--surface-color); font-weight: 500; border-bottom-color: transparent; }
+  [data-site-theme='kadhir'] .velu-search__trigger { width: 36px !important; height: 36px; border-radius: 50%; padding: 0; justify-content: center; border: 0; background: var(--surface-color); font-size: 0; gap: 0; }
+  [data-site-theme='kadhir'] .velu-search__trigger .velu-search__kbd { display: none; }
+  [data-site-theme='kadhir'] .velu-search__trigger-label { display: none; }
+  [data-site-theme='kadhir'] .velu-search__trigger-icon { font-size: 12px; }
+  [data-site-theme='kadhir'] .velu-docs-layout__aside--left { top: 48px; bottom: 0; left: 0; width: 248px; padding: 16px 20px 24px 20px; }
+  [data-site-theme='kadhir'] .velu-sidebar { width: 100%; }
+  [data-site-theme='kadhir'] .velu-docs-layout__center { margin-left: 248px; margin-right: 224px; }
+  [data-site-theme='kadhir'] .velu-docs-layout__main { padding: 28px 24px 0; }
+  [data-site-theme='kadhir'] .velu-docs-layout__article { max-inline-size: 648px; margin-inline: auto; }
+  [data-site-theme='kadhir'] .velu-docs-layout__aside--right { top: 48px; right: 20px; width: 236px; }
+  [data-site-theme='kadhir'] > [data-velu-footer] { margin-left: 248px; }
+  [data-site-theme='kadhir'] .velu-toc-bar { inset-block-start: 48px; }
+}
+@container docs (min-width: 1280px) {
+  [data-site-theme='kadhir'][data-api='true'] .velu-docs-layout__center { margin-right: 496px; }
+  [data-site-theme='kadhir'][data-api='true'] .velu-docs-layout__article { max-inline-size: 648px; }
+  [data-site-theme='kadhir'][data-api='true'] .velu-docs-layout__main { padding-inline: 48px 24px; }
+  [data-site-theme='kadhir'][data-api='true'] .velu-docs-layout__aside--right { right: 24px; width: 448px; padding-top: 24px; }
+}
+@container docs (min-width: 1024px) and (max-width: 1279px) {
+  [data-site-theme='kadhir'] .velu-docs-layout__center { margin-right: 0; }
+  [data-site-theme='kadhir'] .velu-header { grid-template-columns: 300px minmax(0,1fr) 36px auto; padding-inline: 20px; }
+  [data-site-theme='kadhir'] .velu-header__tab { padding-inline: 10px; }
+}
+@container docs (max-width: 1023px) {
+  [data-site-theme='kadhir'] .velu-hero h1 { font-size: 30px; line-height: 36px; }
+  [data-site-theme='kadhir'] .velu-hide-on-mobile { display: none; }
+  [data-site-theme='kadhir'] .velu-show-on-mobile { display: contents; }
+  [data-site-theme='kadhir'] .velu-docs-context { padding-inline: 16px; }
+}
+
+
+

package/src/runtime/App.jsx

@@ -1388,7 +1388,11 @@ function DocsPage() {
             ? undefined
             : languageSwitcher || undefined
         }
-        onMenuClick={chrome.sidebar ? () => setDrawerOpen((v) => !v) : undefined}
+        onMenuClick={
+          chrome.sidebar || chrome.mode === 'center'
+            ? () => setDrawerOpen((v) => !v)
+            : undefined
+        }
         menuOpen={drawerOpen}
         menuId={site.theme === 'vepa' ? 'sidebar-content' : 'sidebar'}
         breadcrumb={