polen 0.8.0-next.4 → 0.8.0-next.6

package/build/project-data.d.ts

@@ -4,6 +4,7 @@ import type { Schema } from './api/schema/index.js';
 export interface ProjectData {
     schema: null | Schema.Schema;
     siteNavigationItems: SiteNavigationItem[];
+    sidebarIndex: SidebarIndex;
     faviconPath: string;
     paths: Configurator.Config[`paths`][`project`];
     pagesScanResult: FileRouter.ScanResult;
@@ -16,6 +17,25 @@ export interface ProjectData {
 }
 export interface SiteNavigationItem {
     title: string;
-    path: string;
+    pathExp: string;
+}
+export interface SidebarIndex {
+    [pathExpression: string]: Sidebar;
+}
+export interface Sidebar {
+    items: SidebarItem[];
+}
+export type SidebarItem = SidebarNav | SidebarSection;
+export interface SidebarNav {
+    type: `SidebarItem`;
+    title: string;
+    pathExp: string;
+}
+export interface SidebarSection {
+    type: `SidebarSection`;
+    title: string;
+    pathExp: string;
+    isNavToo: boolean;
+    navs: SidebarNav[];
 }
 //# sourceMappingURL=project-data.d.ts.map

package/build/project-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-data.d.ts","sourceRoot":"","sources":["../src/project-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAA;IAC5B,mBAAmB,EAAE,kBAAkB,EAAE,CAAA;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAA;IAC9C,eAAe,EAAE,UAAU,CAAC,UAAU,CAAA;IACtC,MAAM,EAAE;QACN,MAAM,EAAE;YACN,SAAS,EAAE,MAAM,CAAA;YACjB,KAAK,EAAE,MAAM,CAAA;SACd,CAAA;KACF,CAAA;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb"}
+{"version":3,"file":"project-data.d.ts","sourceRoot":"","sources":["../src/project-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAEnD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAA;IAC5B,mBAAmB,EAAE,kBAAkB,EAAE,CAAA;IACzC,YAAY,EAAE,YAAY,CAAA;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAA;IAC9C,eAAe,EAAE,UAAU,CAAC,UAAU,CAAA;IACtC,MAAM,EAAE;QACN,MAAM,EAAE;YACN,SAAS,EAAE,MAAM,CAAA;YACjB,KAAK,EAAE,MAAM,CAAA;SACd,CAAA;KACF,CAAA;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,cAAc,CAAA;AAErD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,aAAa,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,UAAU,EAAE,CAAA;CACnB"}

package/build/template/components/Sidebar.d.ts

@@ -0,0 +1,7 @@
+import type { SidebarItem } from '../../project-data.js';
+interface SidebarProps {
+    items: SidebarItem[];
+}
+export declare const Sidebar: ({ items }: SidebarProps) => import("react").JSX.Element;
+export {};
+//# sourceMappingURL=Sidebar.d.ts.map

package/build/template/components/Sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../src/template/components/Sidebar.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,uBAAuB,CAAA;AAEpF,UAAU,YAAY;IACpB,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AAED,eAAO,MAAM,OAAO,GAAI,WAAW,YAAY,gCAyB9C,CAAA"}

package/build/template/components/Sidebar.jsx

@@ -0,0 +1,108 @@
+import { ChevronDownIcon, ChevronRightIcon } from '@radix-ui/react-icons';
+import { Box, Flex, Text } from '@radix-ui/themes';
+import { useState } from 'react';
+import { Link, useLocation } from 'react-router';
+export const Sidebar = ({ items }) => {
+    const location = useLocation();
+    return (<Box style={{
+            width: `240px`,
+            minWidth: `240px`,
+            flexShrink: 0,
+            borderRight: `1px solid var(--gray-3)`,
+            height: `100%`,
+            paddingRight: `var(--space-4)`,
+        }}>
+      <Flex direction='column' gap='1'>
+        {items.map((item) => (<SidebarItemComponent key={item.pathExp} item={item} currentPathExp={location.pathname}/>))}
+      </Flex>
+    </Box>);
+};
+const SidebarItemComponent = ({ item, currentPathExp, level = 0 }) => {
+    if (item.type === `SidebarItem`) {
+        return <SidebarNavItem nav={item} currentPathExp={currentPathExp} level={level}/>;
+    }
+    return <SidebarSectionItem section={item} currentPathExp={currentPathExp} level={level}/>;
+};
+const SidebarNavItem = ({ nav, currentPathExp, level }) => {
+    const isActive = currentPathExp === nav.pathExp;
+    return (<Link to={nav.pathExp} style={{
+            textDecoration: `none`,
+            color: isActive ? `var(--accent-11)` : `var(--gray-12)`,
+            padding: `var(--space-2) var(--space-3)`,
+            paddingLeft: `calc(var(--space-3) + ${(level * 16).toString()}px)`,
+            borderRadius: `var(--radius-2)`,
+            display: `block`,
+            backgroundColor: isActive ? `var(--accent-3)` : `transparent`,
+            transition: `background-color 0.2s ease, color 0.2s ease`,
+        }} onMouseEnter={(e) => {
+            if (!isActive) {
+                e.currentTarget.style.backgroundColor = `var(--gray-2)`;
+            }
+        }} onMouseLeave={(e) => {
+            if (!isActive) {
+                e.currentTarget.style.backgroundColor = `transparent`;
+            }
+        }}>
+      <Text size='2' weight={isActive ? `medium` : `regular`}>
+        {nav.title}
+      </Text>
+    </Link>);
+};
+const SidebarSectionItem = ({ section, currentPathExp, level }) => {
+    const [isExpanded, setIsExpanded] = useState(true);
+    const isDirectlyActive = currentPathExp === section.pathExp;
+    const hasActiveChild = section.navs.some(nav => currentPathExp === nav.pathExp);
+    const isActiveGroup = isDirectlyActive || hasActiveChild;
+    return (<>
+      <Flex align='center' style={{
+            padding: `var(--space-2) var(--space-3)`,
+            paddingLeft: `calc(var(--space-3) + ${(level * 16).toString()}px)`,
+            borderRadius: `var(--radius-2)`,
+            backgroundColor: isDirectlyActive ? `var(--accent-3)` : hasActiveChild ? `var(--accent-2)` : `transparent`,
+            transition: `background-color 0.2s ease`,
+        }} onMouseEnter={(e) => {
+            if (!isActiveGroup) {
+                e.currentTarget.style.backgroundColor = `var(--gray-2)`;
+            }
+        }} onMouseLeave={(e) => {
+            if (!isActiveGroup) {
+                e.currentTarget.style.backgroundColor = `transparent`;
+            }
+        }}>
+        <Box onClick={(e) => {
+            e.stopPropagation();
+            console.log(`Chevron clicked!`);
+            setIsExpanded(!isExpanded);
+        }} style={{
+            display: `flex`,
+            alignItems: `center`,
+            cursor: `pointer`,
+            padding: `4px`,
+            marginRight: `4px`,
+            marginLeft: `-4px`,
+        }}>
+          {isExpanded ? <ChevronDownIcon /> : <ChevronRightIcon />}
+        </Box>
+        {section.isNavToo
+            ? (<Link to={section.pathExp} style={{
+                    textDecoration: `none`,
+                    color: isDirectlyActive ? `var(--accent-11)` : `var(--gray-12)`,
+                    flex: 1,
+                }}>
+              <Text size='2' weight={isDirectlyActive ? `bold` : `medium`}>
+                {section.title}
+              </Text>
+            </Link>)
+            : (<Text size='2' weight={isDirectlyActive ? `bold` : `medium`} style={{
+                    flex: 1,
+                    color: isDirectlyActive ? `var(--accent-11)` : `var(--gray-12)`,
+                }}>
+              {section.title}
+            </Text>)}
+      </Flex>
+      {isExpanded && (<Flex direction='column' gap='1'>
+          {section.navs.map((nav) => (<SidebarNavItem key={nav.pathExp} nav={nav} currentPathExp={currentPathExp} level={level + 1}/>))}
+        </Flex>)}
+    </>);
+};
+//# sourceMappingURL=Sidebar.jsx.map

package/build/template/components/Sidebar.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.jsx","sourceRoot":"","sources":["../../../src/template/components/Sidebar.tsx"],"names":[],"mappings":"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"}

package/build/template/routes/root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../../src/template/routes/root.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAyB7D,eAAO,MAAM,SAAS,mCA6BrB,CAAA;AAmHD,eAAO,MAAM,IAAI;;;;CAIf,CAAA"}
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../../src/template/routes/root.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AA0B7D,eAAO,MAAM,SAAS,mCA6BrB,CAAA;AAgJD,eAAO,MAAM,IAAI;;;;CAIf,CAAA"}

package/build/template/routes/root.jsx

@@ -4,10 +4,11 @@ import { Box, Button, Heading, Text } from '@radix-ui/themes';
 import { Flex, Theme } from '@radix-ui/themes';
 import radixStylesUrl from '@radix-ui/themes/styles.css?url';
 import { Link as LinkReactRouter } from 'react-router';
-import { Outlet, ScrollRestoration } from 'react-router';
+import { Outlet, ScrollRestoration, useLocation } from 'react-router';
 import { PROJECT_DATA } from 'virtual:polen/project/data';
 import { templateVariables } from 'virtual:polen/template/variables';
 import { Link } from '../components/Link.jsx';
+import { Sidebar } from '../components/Sidebar.jsx';
 import entryClientUrl from '../entry.client.jsx?url';
 import { changelog } from './changelog.jsx';
 import { index } from './index.jsx';
@@ -40,6 +41,20 @@ export const Component = () => {
     </html>);
 };
 const Layout = () => {
+    const location = useLocation();
+    // Determine if we should show sidebar based on current path
+    const getCurrentNavPathExp = () => {
+        // todo: general path manipulation lib because we are duplicating logic here found in FileRouter
+        // todo: kit: try a Str.split that returns [] | string[] so that our predicates can refine on it?
+        const segments = location.pathname.split(`/`).filter(Boolean);
+        if (Arr.isntEmpty(segments)) {
+            return `/${segments[0]}`;
+        }
+        return null;
+    };
+    const currentNavPathExp = getCurrentNavPathExp();
+    const sidebar = currentNavPathExp && PROJECT_DATA.sidebarIndex[currentNavPathExp];
+    const showSidebar = sidebar && sidebar.items.length > 0;
     return (<Theme asChild>
       <Box m='8'>
         <Flex align='center' gap='8' pb='4' mb='8' style={{
@@ -54,14 +69,21 @@ const Layout = () => {
             </Flex>
           </LinkReactRouter>
           <Flex direction='row' gap='4'>
-            {PROJECT_DATA.siteNavigationItems.map((item, key) => (<Link key={key} color='gray' to={item.path}>
+            {PROJECT_DATA.siteNavigationItems.map((item, key) => (<Link key={key} color='gray' to={item.pathExp}>
                 {item.title}
               </Link>))}
           </Flex>
         </Flex>
-        <Box>
-          <Outlet />
-        </Box>
+        {showSidebar
+            ? (<Flex gap='8'>
+              <Sidebar items={sidebar.items}/>
+              <Box style={{ flex: 1 }}>
+                <Outlet />
+              </Box>
+            </Flex>)
+            : (<Box>
+              <Outlet />
+            </Box>)}
       </Box>
     </Theme>);
 };
@@ -127,6 +149,7 @@ children.push(notFoundRoute);
 // ━━━━━━━━━━━━━━ • Root Route
 //
 //
+import { Arr } from '@wollybeard/kit';
 import { pages } from 'virtual:polen/project/pages.jsx';
 export const root = createRoute({
     path: `/`,

package/build/template/routes/root.jsx.map

@@ -1 +1 @@
-{"version":3,"file":"root.jsx","sourceRoot":"","sources":["../../../src/template/routes/root.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"root.jsx","sourceRoot":"","sources":["../../../src/template/routes/root.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,cAAc,MAAM,iCAAiC,CAAA;AAC5D,OAAO,EAAE,IAAI,IAAI,eAAe,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACnD,OAAO,cAAc,MAAM,yBAAyB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,yEAAyE;AACzE,MAAM,oBAAoB,GAAG;;;;;;CAM5B,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE;IAC5B,OAAO,CACL,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACb;MAAA,CAAC,IAAI,CACH;QAAA,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC,CAC7E;QAAA,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,CAC3E;QAAA,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EACrB;QAAA,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,qCAAqC,EACnE;QAAA,CAAC,KAAK,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,KAAK,CACvC;QAAA,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,EAAG,CACvE;QAAA,CAAC,IAAI,CACH,GAAG,CAAC,MAAM,CACV,IAAI,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAChE,KAAK,CAAC,WAAW,EAEnB;QAAA,CAAC,IAAI,CACH,GAAG,CAAC,MAAM,CACV,IAAI,CAAC,CAAC,YAAY,CAAC,WAAW,GAAG,MAAM,CAAC,CACxC,KAAK,CAAC,KAAK,CACX,IAAI,CAAC,eAAe,EAExB;MAAA,EAAE,IAAI,CACN;MAAA,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CACzB;QAAA,CAAC,MAAM,CAAC,AAAD,EACP;QAAA,CAAC,iBAAiB,CAAC,AAAD,EAClB;QAAA,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,CAC9E;MAAA,EAAE,IAAI,CACR;IAAA,EAAE,IAAI,CAAC,CACR,CAAA;AACH,CAAC,CAAA;AAED,MAAM,MAAM,GAAG,GAAG,EAAE;IAClB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAA;IAE9B,4DAA4D;IAC5D,MAAM,oBAAoB,GAAG,GAAkB,EAAE;QAC/C,gGAAgG;QAChG,iGAAiG;QACjG,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAC7D,IAAI,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;IAED,MAAM,iBAAiB,GAAG,oBAAoB,EAAE,CAAA;IAChD,MAAM,OAAO,GAAG,iBAAiB,IAAI,YAAY,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAA;IACjF,MAAM,WAAW,GAAG,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;IAEvD,OAAO,CACL,CAAC,KAAK,CAAC,OAAO,CACZ;MAAA,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CACR;QAAA,CAAC,IAAI,CACH,KAAK,CAAC,QAAQ,CACd,GAAG,CAAC,GAAG,CACP,EAAE,CAAC,GAAG,CACN,EAAE,CAAC,GAAG,CACN,KAAK,CAAC,CAAC;YACL,YAAY,EAAE,yBAAyB;SACxC,CAAC,CAEF;UAAA,CAAC,eAAe,CACd,EAAE,CAAC,GAAG,CACN,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAEpD;YAAA,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAC1B;cAAA,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EACjD;cAAA,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAC5B;gBAAA,CAAC,iBAAiB,CAAC,KAAK,CAC1B;cAAA,EAAE,IAAI,CACR;YAAA,EAAE,IAAI,CACR;UAAA,EAAE,eAAe,CACjB;UAAA,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAC3B;YAAA,CAAC,YAAY,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CACnD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAC5C;gBAAA,CAAC,IAAI,CAAC,KAAK,CACb;cAAA,EAAE,IAAI,CAAC,CACR,CAAC,CACJ;UAAA,EAAE,IAAI,CACR;QAAA,EAAE,IAAI,CACN;QAAA,CAAC,WAAW;YACV,CAAC,CAAC,CACA,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACX;cAAA,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAC9B;cAAA,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CACtB;gBAAA,CAAC,MAAM,CAAC,AAAD,EACT;cAAA,EAAE,GAAG,CACP;YAAA,EAAE,IAAI,CAAC,CACR;YACD,CAAC,CAAC,CACA,CAAC,GAAG,CACF;cAAA,CAAC,MAAM,CAAC,AAAD,EACT;YAAA,EAAE,GAAG,CAAC,CACP,CACL;MAAA,EAAE,GAAG,CACP;IAAA,EAAE,KAAK,CAAC,CACT,CAAA;AACH,CAAC,CAAA;AAED,MAAM,QAAQ,GAA8B;IAC1C,KAAK;IACL,GAAG,KAAK;CACT,CAAA;AAED,EAAE;AACF,EAAE;AACF,EAAE;AACF,EAAE;AACF,8DAA8D;AAC9D,EAAE;AACF,EAAE;AACF,EAAE;AAEF,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AAC1B,CAAC;AAED,EAAE;AACF,EAAE;AACF,EAAE;AACF,EAAE;AACF,mCAAmC;AACnC,EAAE;AACF,EAAE;AACF,EAAE;AAEF,MAAM,iBAAiB,GAAG,GAAG,EAAE;IAC7B,OAAO,CACL,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CACjG;MAAA,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC,GAAG,EAAE,OAAO,CAClE;MAAA,CAAC,GAAG,CACF;QAAA,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,EAAE,OAAO,CAChD;QAAA,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CACzB;;QACF,EAAE,IAAI,CACR;MAAA,EAAE,GAAG,CACL;MAAA,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACX;QAAA,CAAC,eAAe,CAAC,EAAE,CAAC,GAAG,CACrB;UAAA,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAC7B;;UACF,EAAE,MAAM,CACV;QAAA,EAAE,eAAe,CACjB;QAAA,CAAC,eAAe,CAAC,EAAE,CAAC,YAAY,CAC9B;UAAA,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAChC;;UACF,EAAE,MAAM,CACV;QAAA,EAAE,eAAe,CACnB;MAAA,EAAE,IAAI,CACR;IAAA,EAAE,IAAI,CAAC,CACR,CAAA;AACH,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,WAAW,CAAC;IAChC,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,GAAG;IACT,SAAS,EAAE,iBAAiB;IAC5B,MAAM,EAAE;QACN,UAAU,EAAE,GAAG;KAChB;CACF,CAAC,CAAA;AACF,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;AAE5B,EAAE;AACF,EAAE;AACF,EAAE;AACF,8BAA8B;AAC9B,EAAE;AACF,EAAE;AAEF,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAA;AAEvD,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW,CAAC;IAC9B,IAAI,EAAE,GAAG;IACT,SAAS;IACT,QAAQ;CACT,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polen",
-  "version": "0.8.0-next.4",
+  "version": "0.8.0-next.6",
   "type": "module",
   "description": "A framework for delightful GraphQL developer portals",
   "author": {

package/src/api/vite/plugins/core.ts

@@ -1,13 +1,19 @@
-import { Markdown } from '#api/singletons/markdown/index.js'
 import type { ReactRouter } from '#dep/react-router/index.js'
 import type { Vite } from '#dep/vite/index.js'
 import { FileRouter } from '#lib/file-router/index.js'
 import { ViteVirtual } from '#lib/vite-virtual/index.js'
 import mdx from '@mdx-js/rollup'
-import { Cache, Fs, Json, Path, Str } from '@wollybeard/kit'
+import { Cache, Idx, Json, Path, Str } from '@wollybeard/kit'
 import jsesc from 'jsesc'
 import remarkGfm from 'remark-gfm'
-import type { ProjectData, SiteNavigationItem } from '../../../project-data.js'
+import type {
+  ProjectData,
+  Sidebar,
+  SidebarIndex,
+  SidebarNav,
+  SidebarSection,
+  SiteNavigationItem,
+} from '../../../project-data.js'
 import { superjson } from '../../../singletons/superjson.js'
 import type { Configurator } from '../../configurator/index.js'
 import { SchemaAugmentation } from '../../schema-augmentation/index.js'
@@ -53,27 +59,31 @@ export const Core = (config: Configurator.Config): Vite.PluginOption[] => {
         ],
       }),
     },
-    {
-      name: `polen:markdown`,
-      enforce: `pre`,
-      resolveId(id) {
-        if (id.endsWith(`.md`)) {
-          return id
-        }
-        return null
-      },
-      async load(id) {
-        if (id.endsWith(`.md`)) {
-          const markdownString = await Fs.read(id)
-          if (!markdownString) return null
-          const htmlString = await Markdown.parse(markdownString)
-
-          const code = `export default ${JSON.stringify(htmlString)}`
-          return code
-        }
-        return null
-      },
-    },
+    // TODO: We can remove, mdx subsumes this
+    // TODO: First we need to investigate how e can make our api singleton Markdown used by MDX.
+    // If we cannot, then we might want to ditch MDX instead and use our lower level solution here.
+    // It depends in part on how complex our Markdown singleton gets.
+    // {
+    //   name: `polen:markdown`,
+    //   enforce: `pre`,
+    //   resolveId(id) {
+    //     if (id.endsWith(`.md`)) {
+    //       return id
+    //     }
+    //     return null
+    //   },
+    //   async load(id) {
+    //     if (id.endsWith(`.md`)) {
+    //       const markdownString = await Fs.read(id)
+    //       if (!markdownString) return null
+    //       const htmlString = await Markdown.parse(markdownString)
+
+    //       const code = `export default ${JSON.stringify(htmlString)}`
+    //       return code
+    //     }
+    //     return null
+    //   },
+    // },
     {
       name: `polen:core:alias`,
       resolveId(id, importer) {
@@ -136,35 +146,67 @@ export const Core = (config: Configurator.Config): Vite.PluginOption[] => {
           async loader() {
             // todo: parallel
             const schema = await readSchema()
-            console.log({ schema })
             const pagesScanResult = await scanPageRoutes()
 
             const siteNavigationItems: SiteNavigationItem[] = []
 
-            const siteNavigationItemsFromTopLevelPages = pagesScanResult.routes
-              // We exclude home page
-              .filter(route => route.path.segments.length === 1)
-              .map(route => {
-                const path = FileRouter.routeToString(route)
-                const title = Str.titlizeSlug(path)
-                return {
-                  path,
-                  title,
-                }
-              })
+            //
+            // ━━ Build Navbar
+            //
 
-            siteNavigationItems.push(...siteNavigationItemsFromTopLevelPages)
+            // ━ Top pages become navigation items
+            const topPages = pagesScanResult.routes.filter(FileRouter.routeIsTopLevel)
+
+            for (const page of topPages) {
+              const path = FileRouter.routeToPathExpression(page)
+              const title = Str.titlizeSlug(path)
+              siteNavigationItems.push({ pathExp: path, title })
+            }
 
+            // ━ Top directories become navigation items
+            const topDirsPaths = pagesScanResult.routes
+              .filter(FileRouter.routeIsSubLevel)
+              // todo: kit, slice that understands non-empty
+              // Arr.slice(route.path.segments, 1)
+              .map(route => [route.logical.path[0]])
+
+            for (const dir of topDirsPaths) {
+              const pathExp = FileRouter.pathToExpression(dir)
+              const title = Str.titlizeSlug(pathExp)
+              // todo: this should never happen, if it does, swarn user
+              // Only add if not already added as a top page
+              if (!siteNavigationItems.some(item => item.pathExp === pathExp)) {
+                siteNavigationItems.push({ pathExp: pathExp, title })
+              }
+            }
+
+            // ━ Schema presence causes adding some navbar items
             if (schema) {
-              siteNavigationItems.push({ path: `/reference`, title: `Reference` })
+              siteNavigationItems.push({ pathExp: `/reference`, title: `Reference` })
               if (schema.versions.length > 1) {
-                siteNavigationItems.push({ path: `/changelog`, title: `Changelog` })
+                siteNavigationItems.push({ pathExp: `/changelog`, title: `Changelog` })
               }
             }
 
+            //
+            // ━━ Build Sidebar
+            //
+
+            const sidebarIndex: SidebarIndex = {}
+
+            for (const dirPath of topDirsPaths) {
+              const childPages = pagesScanResult.routes.filter(page => FileRouter.routeIsSubOf(page, dirPath))
+              sidebarIndex[FileRouter.pathToExpression(dirPath)] = buildSidebar(childPages, dirPath)
+            }
+
+            //
+            // ━━ Put It All together
+            //
+
             const projectData: ProjectData = {
               schema,
               siteNavigationItems,
+              sidebarIndex,
               faviconPath: `/logo.svg`,
               pagesScanResult: pagesScanResult,
               paths: config.paths.project,
@@ -204,25 +246,16 @@ export const Core = (config: Configurator.Config): Vite.PluginOption[] => {
 
             // todo: kit fs should accept parsed file paths
             for (const route of pagesScanResult.routes) {
-              const filePath = Path.format(route.file.path.absolute)
-              const path = FileRouter.routeToString(route)
-              const ident = Str.Case.camel(`page ` + Str.titlizeSlug(path))
+              const filePathExp = Path.format(route.file.path.absolute)
+              const pathExp = FileRouter.routeToPathExpression(route)
+              const ident = Str.Case.camel(`page ` + Str.titlizeSlug(pathExp))
 
               s`
-                import ${ident} from '${filePath}'
+                import ${ident} from '${filePathExp}'
 
                 ${$.pages}.push({
-                  path: '${path}',
-                  Component: () => {
-                    if (typeof ${ident} === 'function') {
-                      // ━ MDX
-                      const Component = ${ident}
-                      return <Component />
-                    } else {
-                      // ━ MD
-                      return <div dangerouslySetInnerHTML={{ __html: ${ident} }} />
-                    }
-                  }
+                  path: '${pathExp}',
+                  Component: ${ident}
                 })
               `
             }
@@ -234,3 +267,94 @@ export const Core = (config: Configurator.Config): Vite.PluginOption[] => {
     },
   ]
 }
+
+/**
+ * Helper function to build sidebar items recursively
+ */
+const buildSidebar = (pages: FileRouter.Route[], basePath: FileRouter.Path): Sidebar => {
+  const navs: SidebarNav[] = []
+  const sections = Idx.create<SidebarSection, string>({ toKey: (item) => item.pathExp })
+
+  // Items
+  for (const page of pages) {
+    const pageRelative = FileRouter.makeRelativeUnsafe(page, basePath)
+
+    if (FileRouter.routeIsRootLevel(pageRelative)) {
+      continue
+    }
+
+    if (FileRouter.routeIsTopLevel(pageRelative)) {
+      // Section (index)
+      if (FileRouter.routeIsFromIndexFile(pageRelative)) {
+        const sectionPath = page.logical.path
+        const sectionPathExp = FileRouter.pathToExpression(sectionPath)
+
+        let section: SidebarSection | undefined
+        section = sections.getKey(sectionPathExp)
+
+        if (!section) {
+          const sectionTitle = Str.titlizeSlug(FileRouter.pathToExpression(pageRelative.logical.path))
+          section = {
+            type: `SidebarSection`,
+            title: sectionTitle,
+            pathExp: sectionPathExp,
+            isNavToo: false,
+            navs: [],
+          }
+
+          sections.set(section)
+        }
+        section.isNavToo = true
+        continue
+      }
+
+      // Nav
+      navs.push(pageToSidebarNav(page, basePath))
+      continue
+    }
+
+    // Section (sub-page)
+    if (FileRouter.routeIsSubLevel(pageRelative)) {
+      const sectionRelativePath = [pageRelative.logical.path[0]]
+      const sectionPath = [...basePath, ...sectionRelativePath]
+      const sectionPathExp = FileRouter.pathToExpression(sectionPath)
+
+      let section: SidebarSection | undefined
+      section = sections.getKey(sectionPathExp)
+
+      if (!section) {
+        const sectionTitle = Str.titlizeSlug(FileRouter.pathToExpression(sectionRelativePath))
+        section = {
+          type: `SidebarSection`,
+          title: sectionTitle,
+          pathExp: sectionPathExp,
+          isNavToo: false,
+          navs: [],
+        }
+        sections.set(section)
+      }
+      section.navs.push(pageToSidebarNav(page, sectionPath))
+    }
+  }
+
+  const items = [...navs, ...sections.data.array]
+
+  return {
+    items,
+  }
+}
+
+/**
+ * Helper function to build sidebar items recursively
+ */
+const pageToSidebarNav = (page: FileRouter.Route, basePath: FileRouter.Path): SidebarNav => {
+  const pagePathExp = FileRouter.routeToPathExpression(page)
+  const pageRelative = FileRouter.makeRelativeUnsafe(page, basePath)
+  const pageRelativePathExp = FileRouter.routeToPathExpression(pageRelative)
+
+  return {
+    type: `SidebarItem`,
+    pathExp: pagePathExp,
+    title: Str.titlizeSlug(pageRelativePathExp),
+  }
+}

package/src/lib/file-router/index.test.ts

@@ -21,7 +21,7 @@ describe('.scan', () => {
       const routes = await scan(project.dir)
       expect(routes).toMatchObject($({
         routes: [{
-          path: { segments: ['a'] },
+          logical: { path: ['a'] },
           file: { path: { relative: { dir: '', base: 'a.md' } } },
         }],
       }))
@@ -31,7 +31,7 @@ describe('.scan', () => {
       const routes = await scan(project.dir)
       expect(routes).toMatchObject($({
         routes: [{
-          path: { segments: ['a', 'b'] },
+          logical: { path: ['a', 'b'] },
           file: { path: { relative: { dir: 'a', base: 'b.md' } } },
         }],
       }))
@@ -43,7 +43,7 @@ describe('.scan', () => {
       const routes = await scan(project.dir)
       expect(routes).toMatchObject($({
         routes: [{
-          path: { segments: [] },
+          logical: { path: [] },
           file: { path: { relative: { dir: '', base: 'index.md' } } },
         }],
       }))
@@ -53,7 +53,7 @@ describe('.scan', () => {
       const routes = await scan(project.dir)
       expect(routes).toMatchObject($({
         routes: [{
-          path: { segments: ['a'] },
+          logical: { path: ['a'] },
           file: { path: { relative: { dir: 'a', base: 'index.md' } } },
         }],
       }))
@@ -66,7 +66,7 @@ describe('.scan', () => {
       expect(routes).toMatchObject($({
         diagnostics: [{}],
         routes: [{
-          path: { segments: ['a'] },
+          logical: { path: ['a'] },
           file: { path: { relative: { dir: '', base: 'a.md' } } },
         }],
       }))

package/src/lib/file-router/linter.ts

@@ -1,5 +1,5 @@
 import { Idx, Path } from '@wollybeard/kit'
-import { type Route, type RouteFile, routeIsIndex, routeToString } from './route.js'
+import { type Route, type RouteFile, routeIsFromIndexFile, routeToPathExpression } from './route.js'
 
 export type Diagnostic = DiagnosticIndexConflict
 
@@ -21,7 +21,7 @@ export interface LintResult {
 export const lint = (routes: Route[]): LintResult => {
   const diagnostics: Diagnostic[] = []
 
-  const seen = Idx.create({ toKey: routeToString })
+  const seen = Idx.create({ toKey: routeToPathExpression })
 
   // ━ Check for conflict between index and literal.
   //   Note: There is no other way for paths to conflict so we safely assuming the cause is index+literal.
@@ -31,7 +31,7 @@ export const lint = (routes: Route[]): LintResult => {
 
     if (seenRoute) {
       // Fix - ignore the index
-      const [index, literal] = routeIsIndex(route) ? [route, seenRoute] : [seenRoute, route]
+      const [index, literal] = routeIsFromIndexFile(route) ? [route, seenRoute] : [seenRoute, route]
       if (seenRoute === index) {
         seen.set(route)
       }