@veluai/velu 0.2.41 → 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.41",
+  "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/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; }
+}
+
+
+