@raystack/chronicle 0.1.0-canary.30bf0df → 0.1.0-canary.49fe67c

package/src/server/vite-config.ts

@@ -0,0 +1,84 @@
+import react from '@vitejs/plugin-react';
+import mdx from 'fumadocs-mdx/vite';
+import { nitro } from 'nitro/vite';
+import path from 'node:path';
+import { type InlineConfig } from 'vite';
+
+export interface ViteConfigOptions {
+  packageRoot: string;
+  projectRoot: string;
+  contentDir: string;
+  preset?: string;
+}
+
+export async function createViteConfig(
+  options: ViteConfigOptions
+): Promise<InlineConfig> {
+  const { packageRoot, projectRoot, contentDir, preset } = options;
+
+  return {
+    root: packageRoot,
+    configFile: false,
+    plugins: [
+      nitro({
+        serverDir: path.resolve(packageRoot, 'src/server'),
+        ...(preset && { preset }),
+        alias: {
+          '@content': path.resolve(packageRoot, '.content'),
+        },
+      }),
+      mdx({}, { index: false }),
+      react(),
+      {
+        name: 'chronicle:content-alias',
+        resolveId(id) {
+          if (id.startsWith('@content/')) {
+            return path.resolve(packageRoot, '.content', id.slice('@content/'.length));
+          }
+        },
+      }
+    ],
+    resolve: {
+      alias: {
+        '@': path.resolve(packageRoot, 'src'),
+        '@content': path.resolve(packageRoot, '.content'),
+      },
+      conditions: ['module-sync', 'import', 'node'],
+      preserveSymlinks: true,
+      dedupe: [
+        'react',
+        'react-dom',
+        'react/jsx-runtime',
+        'react/jsx-dev-runtime',
+        'react-router',
+      ]
+    },
+    server: {
+      fs: {
+        allow: [packageRoot, projectRoot, contentDir]
+      }
+    },
+    define: {
+      __CHRONICLE_CONTENT_DIR__: JSON.stringify(contentDir),
+      __CHRONICLE_PROJECT_ROOT__: JSON.stringify(projectRoot),
+      __CHRONICLE_PACKAGE_ROOT__: JSON.stringify(packageRoot)
+    },
+    css: {
+      modules: {
+        localsConvention: 'camelCase'
+      }
+    },
+    ssr: {
+      noExternal: ['@raystack/apsara', 'dayjs', 'fumadocs-core']
+    },
+    environments: {
+      client: {
+        build: {
+          rollupOptions: {
+            input: path.resolve(packageRoot, 'src/server/entry-client.tsx')
+          }
+        }
+      }
+    }
+  };
+}

package/src/themes/default/Layout.tsx

@@ -1,64 +1,85 @@
-"use client";
-
-import { useMemo, useEffect, useRef } from "react";
-import { usePathname } from "next/navigation";
-import NextLink from "next/link";
-import { cx } from "class-variance-authority";
-import { Flex, Navbar, Headline, Link, Sidebar, Button } from "@raystack/apsara";
-import { RectangleStackIcon } from "@heroicons/react/24/outline";
-import { ClientThemeSwitcher } from "@/components/ui/client-theme-switcher";
-import { Search } from "@/components/ui/search";
-import { Footer } from "@/components/ui/footer";
-import { MethodBadge } from "@/components/api/method-badge";
-import type { ThemeLayoutProps, PageTreeItem } from "@/types";
-import styles from "./Layout.module.css";
+import { RectangleStackIcon } from '@heroicons/react/24/outline';
+import {
+  Button,
+  Flex,
+  Headline,
+  Link,
+  Navbar,
+  Sidebar
+} from '@raystack/apsara';
+import { cx } from 'class-variance-authority';
+import { useEffect, useMemo, useRef } from 'react';
+import { Link as RouterLink, useLocation } from 'react-router';
+import { MethodBadge } from '@/components/api/method-badge';
+import { ClientThemeSwitcher } from '@/components/ui/client-theme-switcher';
+import { Footer } from '@/components/ui/footer';
+import { Search } from '@/components/ui/search';
+import type { PageTreeItem, ThemeLayoutProps } from '@/types';
+import styles from './Layout.module.css';
 
 const iconMap: Record<string, React.ReactNode> = {
-  "rectangle-stack": <RectangleStackIcon width={16} height={16} />,
-  "method-get": <MethodBadge method="GET" size="micro" />,
-  "method-post": <MethodBadge method="POST" size="micro" />,
-  "method-put": <MethodBadge method="PUT" size="micro" />,
-  "method-delete": <MethodBadge method="DELETE" size="micro" />,
-  "method-patch": <MethodBadge method="PATCH" size="micro" />,
+  'rectangle-stack': <RectangleStackIcon width={16} height={16} />,
+  'method-get': <MethodBadge method='GET' size='micro' />,
+  'method-post': <MethodBadge method='POST' size='micro' />,
+  'method-put': <MethodBadge method='PUT' size='micro' />,
+  'method-delete': <MethodBadge method='DELETE' size='micro' />,
+  'method-patch': <MethodBadge method='PATCH' size='micro' />
 };
 
 let savedScrollTop = 0;
 
-export function Layout({ children, config, tree, classNames }: ThemeLayoutProps) {
-  const pathname = usePathname();
+export function Layout({
+  children,
+  config,
+  tree,
+  classNames
+}: ThemeLayoutProps) {
+  const { pathname } = useLocation();
   const scrollRef = useRef<HTMLDivElement>(null);
 
   useEffect(() => {
     const el = scrollRef.current;
     if (!el) return;
-    const onScroll = () => { savedScrollTop = el.scrollTop; };
+    const onScroll = () => {
+      savedScrollTop = el.scrollTop;
+    };
     el.addEventListener('scroll', onScroll);
     return () => el.removeEventListener('scroll', onScroll);
   }, []);
 
   useEffect(() => {
     const el = scrollRef.current;
-    if (el) requestAnimationFrame(() => { el.scrollTop = savedScrollTop; });
+    if (el)
+      requestAnimationFrame(() => {
+        el.scrollTop = savedScrollTop;
+      });
   }, [pathname]);
 
   return (
-    <Flex direction="column" className={cx(styles.layout, classNames?.layout)}>
+    <Flex direction='column' className={cx(styles.layout, classNames?.layout)}>
       <Navbar className={styles.header}>
         <Navbar.Start>
-          <NextLink href="/" style={{ textDecoration: 'none', color: 'inherit' }}>
-            <Headline size="small" weight="medium" as="h1">
+          <RouterLink
+            to='/'
+            style={{ textDecoration: 'none', color: 'inherit' }}
+          >
+            <Headline size='small' weight='medium' as='h1'>
               {config.title}
             </Headline>
-          </NextLink>
+          </RouterLink>
         </Navbar.Start>
         <Navbar.End>
-          <Flex gap="medium" align="center" className={styles.navActions}>
-            {config.api?.map((api) => (
-              <NextLink key={api.basePath} href={api.basePath} className={styles.navButton}>
+          <Flex gap='medium' align='center' className={styles.navActions}>
+            {config.api?.map(api => (
+              <RouterLink
+                key={api.basePath}
+                to={api.basePath}
+                className={styles.navButton}
+              >
                 {api.name} API
-              </NextLink>
+              </RouterLink>
             ))}
-            {config.navigation?.links?.map((link) => (
+            {config.navigation?.links?.map(link => (
               <Link key={link.href} href={link.href}>
                 {link.label}
               </Link>
@@ -69,9 +90,13 @@ export function Layout({ children, config, tree, classNames }: ThemeLayoutProps)
         </Navbar.End>
       </Navbar>
       <Flex className={cx(styles.body, classNames?.body)}>
-        <Sidebar defaultOpen collapsible={false} className={cx(styles.sidebar, classNames?.sidebar)}>
+        <Sidebar
+          defaultOpen
+          collapsible={false}
+          className={cx(styles.sidebar, classNames?.sidebar)}
+        >
           <Sidebar.Main ref={scrollRef}>
-            {tree.children.map((item) => (
+            {tree.children.map(item => (
               <SidebarNode
                 key={item.url ?? item.name}
                 item={item}
@@ -80,7 +105,9 @@ export function Layout({ children, config, tree, classNames }: ThemeLayoutProps)
             ))}
           </Sidebar.Main>
         </Sidebar>
-        <main className={cx(styles.content, classNames?.content)}>{children}</main>
+        <main className={cx(styles.content, classNames?.content)}>
+          {children}
+        </main>
       </Flex>
       <Footer config={config.footer} />
     </Flex>
@@ -89,23 +116,23 @@ export function Layout({ children, config, tree, classNames }: ThemeLayoutProps)
 
 function SidebarNode({
   item,
-  pathname,
+  pathname
 }: {
   item: PageTreeItem;
   pathname: string;
 }) {
-  if (item.type === "separator") {
+  if (item.type === 'separator') {
     return null;
   }
 
-  if (item.type === "folder" && item.children) {
+  if (item.type === 'folder' && item.children) {
     return (
       <Sidebar.Group
         label={item.name}
         leadingIcon={item.icon ? iconMap[item.icon] : undefined}
         classNames={{ items: styles.groupItems }}
       >
-        {item.children.map((child) => (
+        {item.children.map(child => (
           <SidebarNode
             key={child.url ?? child.name}
             item={child}
@@ -117,8 +144,8 @@ function SidebarNode({
   }
 
   const isActive = pathname === item.url;
-  const href = item.url ?? "#";
-  const link = useMemo(() => <NextLink href={href} scroll={false} />, [href]);
+  const href = item.url ?? '#';
+  const link = useMemo(() => <RouterLink to={href} />, [href]);
 
   return (
     <Sidebar.Item

package/src/themes/default/Page.tsx

@@ -1,21 +1,19 @@
-'use client'
+'use client';
 
-import { Flex } from '@raystack/apsara'
-import type { ThemePageProps } from '@/types'
-import { Breadcrumbs } from '@/components/ui/breadcrumbs'
-import { Toc } from './Toc'
-import styles from './Page.module.css'
+import { Flex } from '@raystack/apsara';
+import { Breadcrumbs } from '@/components/ui/breadcrumbs';
+import type { ThemePageProps } from '@/types';
+import styles from './Page.module.css';
+import { Toc } from './Toc';
 
 export function Page({ page, tree }: ThemePageProps) {
   return (
     <Flex className={styles.page}>
-      <article className={styles.article}>
+      <article className={styles.article} data-article-content>
         <Breadcrumbs slug={page.slug} tree={tree} />
-        <div className={styles.content}>
-          {page.content}
-        </div>
+        <div className={styles.content}>{page.content}</div>
       </article>
       <Toc items={page.toc} />
     </Flex>
-  )
+  );
 }

package/src/themes/default/Toc.tsx

@@ -1,55 +1,57 @@
-'use client'
+'use client';
 
-import { useEffect, useState } from 'react'
-import { Text } from '@raystack/apsara'
-import type { TocItem } from '@/types'
-import styles from './Toc.module.css'
+import { Text } from '@raystack/apsara';
+import { useEffect, useState } from 'react';
+import type { TocItem } from '@/types';
+import styles from './Toc.module.css';
 
 interface TocProps {
-  items: TocItem[]
+  items: TocItem[];
 }
 
 export function Toc({ items }: TocProps) {
-  const [activeId, setActiveId] = useState<string>('')
+  const [activeId, setActiveId] = useState<string>('');
 
   // Filter to only show h2 and h3 headings
-  const filteredItems = items.filter((item) => item.depth >= 2 && item.depth <= 3)
+  const filteredItems = items.filter(
+    item => item.depth >= 2 && item.depth <= 3
+  );
 
   useEffect(() => {
-    const headingIds = filteredItems.map((item) => item.url.replace('#', ''))
+    const headingIds = filteredItems.map(item => item.url.replace('#', ''));
 
     const observer = new IntersectionObserver(
-      (entries) => {
-        entries.forEach((entry) => {
+      entries => {
+        entries.forEach(entry => {
           if (entry.isIntersecting) {
-            setActiveId(entry.target.id)
+            setActiveId(entry.target.id);
           }
-        })
+        });
       },
       // -80px top: offset for fixed header, -80% bottom: trigger when heading is in top 20% of viewport
       { rootMargin: '-80px 0px -80% 0px' }
-    )
+    );
 
-    headingIds.forEach((id) => {
-      const element = document.getElementById(id)
-      if (element) observer.observe(element)
-    })
+    headingIds.forEach(id => {
+      const element = document.getElementById(id);
+      if (element) observer.observe(element);
+    });
 
-    return () => observer.disconnect()
-  }, [filteredItems])
+    return () => observer.disconnect();
+  }, [filteredItems]);
 
-  if (filteredItems.length === 0) return null
+  if (filteredItems.length === 0) return null;
 
   return (
     <aside className={styles.toc}>
-      <Text size={1} weight="medium" className={styles.title}>
+      <Text size={1} weight='medium' className={styles.title}>
         On this page
       </Text>
       <nav className={styles.nav}>
-        {filteredItems.map((item) => {
-          const id = item.url.replace('#', '')
-          const isActive = activeId === id
-          const isNested = item.depth > 2
+        {filteredItems.map(item => {
+          const id = item.url.replace('#', '');
+          const isActive = activeId === id;
+          const isNested = item.depth > 2;
           return (
             <a
               key={item.url}
@@ -58,9 +60,9 @@ export function Toc({ items }: TocProps) {
             >
               {item.title}
             </a>
-          )
+          );
         })}
       </nav>
     </aside>
-  )
+  );
 }

package/src/themes/default/index.ts

@@ -1,13 +1,11 @@
-import { Layout } from './Layout'
-import { Page } from './Page'
-import { Toc } from './Toc'
-import { inter } from './font'
-import type { Theme } from '@/types'
+import type { Theme } from '@/types';
+import { Layout } from './Layout';
+import { Page } from './Page';
+import { Toc } from './Toc';
 
 export const defaultTheme: Theme = {
   Layout,
-  Page,
-  className: inter.className,
-}
+  Page
+};
 
-export { Layout, Page, Toc }
+export { Layout, Page, Toc };

package/src/themes/paper/ChapterNav.tsx

@@ -1,96 +1,115 @@
-'use client'
-
-import { usePathname } from 'next/navigation'
-import NextLink from 'next/link'
-import { MethodBadge } from '@/components/api/method-badge'
-import type { PageTree, PageTreeItem } from '@/types'
-import styles from './ChapterNav.module.css'
+import { Link as RouterLink, useLocation } from 'react-router';
+import { MethodBadge } from '@/components/api/method-badge';
+import type { PageTree, PageTreeItem } from '@/types';
+import styles from './ChapterNav.module.css';
 
 const iconMap: Record<string, React.ReactNode> = {
-  'method-get': <MethodBadge method="GET" size="micro" />,
-  'method-post': <MethodBadge method="POST" size="micro" />,
-  'method-put': <MethodBadge method="PUT" size="micro" />,
-  'method-delete': <MethodBadge method="DELETE" size="micro" />,
-  'method-patch': <MethodBadge method="PATCH" size="micro" />,
-}
+  'method-get': <MethodBadge method='GET' size='micro' />,
+  'method-post': <MethodBadge method='POST' size='micro' />,
+  'method-put': <MethodBadge method='PUT' size='micro' />,
+  'method-delete': <MethodBadge method='DELETE' size='micro' />,
+  'method-patch': <MethodBadge method='PATCH' size='micro' />
+};
 
 interface ChapterNavProps {
-  tree: PageTree
+  tree: PageTree;
 }
 
-function buildChapterIndices(children: PageTreeItem[]): Map<PageTreeItem, number> {
-  const indices = new Map<PageTreeItem, number>()
-  let index = 0
+function buildChapterIndices(
+  children: PageTreeItem[]
+): Map<PageTreeItem, number> {
+  const indices = new Map<PageTreeItem, number>();
+  let index = 0;
   for (const item of children) {
     if (item.type === 'folder' && item.children) {
-      index++
-      indices.set(item, index)
+      index++;
+      indices.set(item, index);
     }
   }
-  return indices
+  return indices;
 }
 
 export function ChapterNav({ tree }: ChapterNavProps) {
-  const pathname = usePathname()
-  const chapterIndices = buildChapterIndices(tree.children)
+  const { pathname } = useLocation();
+  const chapterIndices = buildChapterIndices(tree.children);
 
   return (
     <nav className={styles.nav}>
       <ul className={styles.chapterItems}>
-        {tree.children.map((item) => {
-          if (item.type === 'separator') return null
+        {tree.children.map(item => {
+          if (item.type === 'separator') return null;
 
           if (item.type === 'folder' && item.children) {
-            const chapterIndex = chapterIndices.get(item) ?? 0
+            const chapterIndex = chapterIndices.get(item) ?? 0;
             return (
               <li key={item.name} className={styles.chapter}>
                 <span className={styles.chapterLabel}>
                   {String(chapterIndex).padStart(2, '0')}. {item.name}
                 </span>
                 <ul className={styles.chapterItems}>
-                  {item.children.map((child) => (
-                    <ChapterItem key={child.url ?? child.name} item={child} pathname={pathname} />
+                  {item.children.map(child => (
+                    <ChapterItem
+                      key={child.url ?? child.name}
+                      item={child}
+                      pathname={pathname}
+                    />
                   ))}
                 </ul>
               </li>
-            )
+            );
           }
 
-          return <ChapterItem key={item.url ?? item.name} item={item} pathname={pathname} />
+          return (
+            <ChapterItem
+              key={item.url ?? item.name}
+              item={item}
+              pathname={pathname}
+            />
+          );
         })}
       </ul>
     </nav>
-  )
+  );
 }
 
-function ChapterItem({ item, pathname }: { item: PageTreeItem; pathname: string }) {
-  if (item.type === 'separator') return null
+function ChapterItem({
+  item,
+  pathname
+}: {
+  item: PageTreeItem;
+  pathname: string;
+}) {
+  if (item.type === 'separator') return null;
 
   if (item.type === 'folder' && item.children) {
     return (
       <li>
         <span className={styles.subLabel}>{item.name}</span>
         <ul className={styles.chapterItems}>
-          {item.children.map((child) => (
-            <ChapterItem key={child.url ?? child.name} item={child} pathname={pathname} />
+          {item.children.map(child => (
+            <ChapterItem
+              key={child.url ?? child.name}
+              item={child}
+              pathname={pathname}
+            />
           ))}
         </ul>
       </li>
-    )
+    );
   }
 
-  const isActive = pathname === item.url
-  const icon = item.icon ? iconMap[item.icon] : null
+  const isActive = pathname === item.url;
+  const icon = item.icon ? iconMap[item.icon] : null;
 
   return (
     <li>
-      <NextLink
-        href={item.url ?? '#'}
+      <RouterLink
+        to={item.url ?? '#'}
         className={`${styles.link} ${isActive ? styles.active : ''}`}
       >
         {icon && <span className={styles.icon}>{icon}</span>}
         <span>{item.name}</span>
-      </NextLink>
+      </RouterLink>
     </li>
-  )
+  );
 }

package/src/themes/paper/Layout.module.css

@@ -13,7 +13,7 @@
   padding: var(--rs-space-7) var(--rs-space-5);
   background: var(--rs-color-background-neutral-primary);
   overflow-y: auto;
-  font-family: 'SF Mono', 'Fira Code', 'Fira Mono', 'Roboto Mono', monospace;
+  font-family: "SF Mono", "Fira Code", "Fira Mono", "Roboto Mono", monospace;
 }
 
 .title {

package/src/themes/paper/Layout.tsx

@@ -1,25 +1,37 @@
-'use client'
+'use client';
 
-import { Flex, Headline } from '@raystack/apsara'
-import { cx } from 'class-variance-authority'
-import { Footer } from '@/components/ui/footer'
-import { ChapterNav } from './ChapterNav'
-import type { ThemeLayoutProps } from '@/types'
-import styles from './Layout.module.css'
+import { Flex, Headline } from '@raystack/apsara';
+import { cx } from 'class-variance-authority';
+import { Footer } from '@/components/ui/footer';
+import type { ThemeLayoutProps } from '@/types';
+import { ChapterNav } from './ChapterNav';
+import styles from './Layout.module.css';
 
-export function Layout({ children, config, tree, classNames }: ThemeLayoutProps) {
+export function Layout({
+  children,
+  config,
+  tree,
+  classNames
+}: ThemeLayoutProps) {
   return (
-    <Flex direction="column" className={cx(styles.layout, classNames?.layout)}>
+    <Flex direction='column' className={cx(styles.layout, classNames?.layout)}>
       <Flex className={cx(styles.body, classNames?.body)}>
         <aside className={cx(styles.sidebar, classNames?.sidebar)}>
-          <Headline size="small" weight="medium" as="h1" className={styles.title}>
+          <Headline
+            size='small'
+            weight='medium'
+            as='h1'
+            className={styles.title}
+          >
             {config.title}
           </Headline>
           <ChapterNav tree={tree} />
         </aside>
-        <div className={cx(styles.content, classNames?.content)}>{children}</div>
+        <div className={cx(styles.content, classNames?.content)}>
+          {children}
+        </div>
       </Flex>
       <Footer config={config.footer} />
     </Flex>
-  )
+  );
 }