@veluai/velu 0.2.39 → 0.2.41

package/schema/velu.schema.json

@@ -9,7 +9,7 @@
   "properties": {
     "theme": {
       "type": "string",
-      "enum": ["velu", "vepa", "thulir", "aalam"],
+      "enum": ["velu", "vepa", "thulir", "aalam", "nila"],
       "description": "Visual preset. Vepa follows Mintlify Sequoia, Thulir follows Mintlify Mint, and Aalam follows Mintlify Maple; light/dark preference is independent. Defaults to velu."
     },
     "$schema": {
@@ -272,6 +272,7 @@
       "additionalProperties": false,
       "description": "A navigation container. Higher-precedence keys nest the lower ones (products contain versions contain languages contain tabs contain groups/pages).",
       "properties": {
+        "preservePagePaths": { "type": "boolean", "description": "Keep page URLs unchanged across product, version and language axes. Enabled by Mintlify migration." },
         "products": { "type": "array", "items": { "$ref": "#/$defs/product" } },
         "versions": { "type": "array", "items": { "$ref": "#/$defs/version" } },
         "languages": { "type": "array", "items": { "$ref": "#/$defs/language" } },

package/src/navigation.js

@@ -90,6 +90,7 @@ const lastSeg = (url) => {
  */
 export function normalizeNavigation(raw) {
   const root = { kind: 'root', children: normalizeChildren(raw ?? {}) };
+  if (raw?.preservePagePaths === true) root.preservePagePaths = true;
   applyDefaults(root.children);
   return root;
 }
@@ -250,12 +251,13 @@ export function walkPages(tree) {
       node.kind === 'root' ? ancestors : [...ancestors, node];
     for (const c of node.children ?? []) visit(c, next, nextAncestors);
   };
-  visit(tree, { product: null, version: null, language: null }, []);
+  visit(tree, { product: null, version: null, language: null, ...(tree.preservePagePaths ? { preservePagePaths: true } : {}) }, []);
   return out;
 }
 
 /** Compose a page URL from a page path + an axis context. */
 function urlInCtx(pagePath, ctx) {
+  if (ctx.preservePagePaths) return urlForPath(pagePath);
   const prefix = [ctx.product, ctx.version, ctx.language].filter(Boolean);
   const leaf = urlForPath(pagePath).split('/').filter(Boolean);
   return '/' + [...prefix, ...leaf].join('/');

package/src/runtime/App.jsx

@@ -929,7 +929,7 @@ function DocsPage() {
   // against it like any other heading.
   const pageId = React.useMemo(() => {
     if (!frontmatter.title) return null;
-    if (site.theme === 'vepa' || ['thulir', 'aalam'].includes(site.theme)) return 'page-title';
+    if (site.theme === 'vepa' || ['thulir', 'aalam', 'nila'].includes(site.theme)) return 'page-title';
     return new GithubSlugger().slug(frontmatter.title);
   }, [frontmatter.title, site.theme]);
 
@@ -969,7 +969,7 @@ function DocsPage() {
     const root = drawerRef.current?.parentElement;
     if (!root) return;
     const observer = new ResizeObserver(([entry]) => {
-      const narrow = entry.contentRect.width <= (['thulir', 'aalam'].includes(site.theme) ? 1023 : 640);
+      const narrow = entry.contentRect.width <= (['thulir', 'aalam', 'nila'].includes(site.theme) ? 1023 : 640);
       setDrawerViewport(narrow);
       if (!narrow) setDrawerOpen(false);
     });
@@ -988,7 +988,7 @@ function DocsPage() {
     drawer.querySelector('.velu-docs-layout__drawer-close')?.focus();
     const onKey = e => {
       if (e.key === 'Escape') {
-        if (drawer.querySelector('.velu-docs-layout__drawer-docselect[data-open="true"]')) return;
+        if (drawer.querySelector('.velu-docs-layout__drawer-docselect[data-open="true"], .velu-nav-select[data-open="true"]')) return;
         setDrawerOpen(false); return;
       }
       if (e.key !== 'Tab') return;
@@ -1350,8 +1350,8 @@ function DocsPage() {
           logo: site.logo,
         }}
         brandTrailing={
-          versionSwitcher && (
-            <span className="velu-hide-on-mobile">{versionSwitcher}</span>
+          (versionSwitcher || (site.theme === 'nila' && productSwitcher)) && (
+            <span className="velu-hide-on-mobile">{versionSwitcher}{site.theme === 'nila' && productSwitcher}</span>
           )
         }
         center={
@@ -1382,19 +1382,23 @@ function DocsPage() {
           </Cluster>
         }
         actions={navActions}
-        trailing={<ThemeToggle variant={site.theme === 'aalam' ? 'inline' : site.theme === 'vepa' || site.theme === 'thulir' ? 'menu' : undefined} />}
+        trailing={<ThemeToggle variant={site.theme === 'aalam' ? 'inline' : site.theme === 'vepa' || ['thulir', 'nila'].includes(site.theme) ? 'menu' : undefined} />}
         tabsTrailing={
           chrome.mode === 'custom' || chrome.mode === 'assistant'
             ? 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={
           chrome.mode === 'custom' || chrome.mode === 'assistant'
             ? []
-            : ['thulir', 'aalam'].includes(site.theme) ? (nav?.breadcrumb ?? []).slice(-2) : (nav?.breadcrumb ?? [])
+            : ['thulir', 'aalam', 'nila'].includes(site.theme) ? (nav?.breadcrumb ?? []).slice(-2) : (nav?.breadcrumb ?? [])
         }
         activeTab={nav?.activeTab}
         tabs={
@@ -1448,7 +1452,7 @@ function DocsPage() {
                 </>
               )}
             </RouterLink>
-            <ThemeToggle variant={site.theme === 'vepa' || site.theme === 'thulir' ? 'menu' : undefined} />
+            <ThemeToggle variant={site.theme === 'vepa' || ['thulir', 'nila'].includes(site.theme) ? 'menu' : undefined} />
             <button
               type="button"
               className="velu-docs-layout__drawer-close"
@@ -1592,7 +1596,7 @@ function DocsPage() {
               left column, including anchors, in one overflow. */}
           <div className="velu-docs-nav-region">
             <div
-              id={site.theme === 'vepa' || ['thulir', 'aalam'].includes(site.theme) ? 'navigation-items' : 'sidebar-content'}
+              id={site.theme === 'vepa' || ['thulir', 'aalam', 'nila'].includes(site.theme) ? 'navigation-items' : 'sidebar-content'}
               ref={leftAsideRef}
               className={`velu-docs-nav-scroll${site.theme === 'aalam' ? '' : ' velu-hide-scrollbar'}`}
               style={{
@@ -1690,12 +1694,12 @@ function DocsPage() {
             />
           ) : isChangelog && changelogTags.length && site.theme !== 'vepa' ? (
             <ChangelogFilters tags={changelogTags} />
-          ) : site.theme === 'vepa' || ['thulir', 'aalam'].includes(site.theme) ? (
+          ) : site.theme === 'vepa' || ['thulir', 'aalam', 'nila'].includes(site.theme) ? (
             <>
               {isChangelog && changelogTags.length > 0 ? (
                 <ChangelogFilters tags={changelogTags} />
               ) : null}
-              <VepaToc items={pageToc} activeId={['thulir', 'aalam'].includes(site.theme) && activeId === pageId ? pageToc[0]?.id : activeId} onSelect={scrollTo} />
+              <VepaToc items={pageToc} activeId={['thulir', 'aalam', 'nila'].includes(site.theme) && activeId === pageId ? pageToc[0]?.id : activeId} onSelect={scrollTo} />
             </>
           ) : (
             <Toc id="table-of-contents-content" items={toc} activeId={activeId} onSelect={scrollTo} />
@@ -1740,7 +1744,7 @@ function DocsPage() {
             on tab/mobile we keep the normal TOC bar (no filters). Hidden
             entirely when the page mode has no table of contents. */}
         {chrome.toc && (
-        <TocBar items={toc} activeId={activeId} onSelect={scrollTo} label={['thulir', 'aalam'].includes(site.theme) ? 'On this page' : undefined} />
+        <TocBar items={toc} activeId={activeId} onSelect={scrollTo} label={['thulir', 'aalam', 'nila'].includes(site.theme) ? 'On this page' : undefined} />
         )}
       <main
         id="content-area"
@@ -1780,7 +1784,7 @@ function DocsPage() {
           </span>
         </button>
         )}
-        <div id={site.theme === 'vepa' || ['thulir', 'aalam'].includes(site.theme) ? undefined : 'content'} data-contextual-actions={site.contextual?.options?.length ? 'true' : 'false'} className="velu-docs-layout__article" data-pagefind-body={chrome.assistant ? undefined : ""}>
+        <div id={site.theme === 'vepa' || ['thulir', 'aalam', 'nila'].includes(site.theme) ? undefined : 'content'} data-contextual-actions={site.contextual?.options?.length ? 'true' : 'false'} className="velu-docs-layout__article" data-pagefind-body={chrome.assistant ? undefined : ""}>
           {/* Per-page agent/IDE action bar: the section eyebrow + a
               "Copy Page" split-button whose dropdown is driven by the
               Mintlify-compatible `contextual` config. Renders nothing
@@ -1810,7 +1814,7 @@ function DocsPage() {
               Custom / frame / assistant are a blank canvas — no auto hero. */}
           {chrome.hero && (frontmatter.title || frontmatter.description) && (
             <div className="velu-hero">
-              {frontmatter.title && <h1 id={site.theme === 'vepa' || ['thulir', 'aalam'].includes(site.theme) ? 'page-title' : pageId}>{frontmatter.title}</h1>}
+              {frontmatter.title && <h1 id={site.theme === 'vepa' || ['thulir', 'aalam', 'nila'].includes(site.theme) ? 'page-title' : pageId}>{frontmatter.title}</h1>}
               {frontmatter.description && (
                 <p
                   style={{
@@ -1831,7 +1835,7 @@ function DocsPage() {
               level. Falls back to a not-found / missing-file notice
               when the route has no page (or its file is absent). */}
           <MDXProvider components={defaultMdxComponents}>
-            <mdx-content key={site.theme === 'vepa' ? pathname : undefined} id={(site.theme === 'vepa' || ['thulir', 'aalam'].includes(site.theme)) && !entry?.api ? 'content' : undefined} class="velu-prose">
+            <mdx-content key={site.theme === 'vepa' ? pathname : undefined} id={(site.theme === 'vepa' || ['thulir', 'aalam', 'nila'].includes(site.theme)) && !entry?.api ? 'content' : undefined} class="velu-prose">
               {PageComponent ? (
                 <ErrorBoundary key={pathname} file={entry?.relPath}>
                   {entry?.mdxApi ? <ApiReferencePage {...entry.mdxApi} preset={site.theme}><PageComponent /></ApiReferencePage> : <PageComponent />}
@@ -1847,7 +1851,7 @@ function DocsPage() {
           </MDXProvider>
           {/* Page-foot feedback widget — ref'd so the sticky AskBar
               above can hide as the user scrolls near it. */}
-          {chrome.articleChrome && !['thulir', 'aalam'].includes(site.theme) && (
+          {chrome.articleChrome && !['thulir', 'aalam', 'nila'].includes(site.theme) && (
           <div ref={setFeedbackEl} style={{ marginTop: 'var(--s3)' }}>
             {/* key resets the widget's vote state on page change. "Yes"
                 submits immediately; "No" submits once its form is sent.
@@ -1868,7 +1872,7 @@ function DocsPage() {
           {chrome.articleChrome && !frontmatter.hidePagination && (nav?.prev || nav?.next) && (
             <PageNav
               id="pagination"
-              style={['thulir', 'aalam'].includes(site.theme) ? undefined : { marginTop: 'var(--s2)' }}
+              style={['thulir', 'aalam', 'nila'].includes(site.theme) ? undefined : { marginTop: 'var(--s2)' }}
               variant={site.theme === 'aalam' ? 'aalam' : 'default'}
               prev={nav?.prev}
               next={nav?.next}
@@ -1909,7 +1913,7 @@ function DocsPage() {
               full footer section); with link columns they live in the full
               footer below instead. */}
           {chrome.articleChrome && (footerHasLinks ? (
-            site.theme === 'vepa' || ['thulir', 'aalam'].includes(site.theme) ? null : <PoweredBy />
+            site.theme === 'vepa' || ['thulir', 'aalam', 'nila'].includes(site.theme) ? null : <PoweredBy />
           ) : (
             <div className="velu-content-foot">
               <SocialLinks socials={footerSocials} />
@@ -1928,7 +1932,7 @@ function DocsPage() {
           overlap via footerOverlap below. */}
       {footerHasLinks && chrome.footer && (
         <advanced-footer
-          id={site.theme === 'vepa' || ['thulir', 'aalam'].includes(site.theme) ? undefined : 'footer'}
+          id={site.theme === 'vepa' || ['thulir', 'aalam', 'nila'].includes(site.theme) ? undefined : 'footer'}
           ref={setFooterEl}
           data-velu-footer
           style={{ position: 'relative', zIndex: 20 }}
@@ -2004,3 +2008,4 @@ export default function App() {
     </Routes>
   );
 }
+