@tayacrystals/lore 0.1.0 → 0.1.3

package/components/docs/Sidebar.astro

@@ -21,7 +21,7 @@ const docsHref = `${BASE_URL}docs`;
         return <SidebarItem label={entry.label} href={entry.href} active={entry.href === currentPath} icon={entry.icon} />;
       }
       return (
-        <SidebarGroup label={entry.label} items={entry.items} currentPath={currentPath} depth={0} />
+        <SidebarGroup label={entry.label} items={entry.items} currentPath={currentPath} depth={0} href={entry.href} />
       );
     })
   }

package/components/docs/SidebarGroup.astro

@@ -8,30 +8,41 @@ interface Props {
   items: SidebarEntry[];
   currentPath: string;
   depth?: number;
+  href?: string;
 }
 
-const { label, items, currentPath, depth = 0 } = Astro.props;
+const { label, items, currentPath, depth = 0, href } = Astro.props;
 
 function hasActiveDescendant(entries: SidebarEntry[], path: string): boolean {
   for (const entry of entries) {
     if (entry.type === "link" && entry.href === path) return true;
-    if (entry.type === "group" && hasActiveDescendant(entry.items, path)) return true;
+    if (entry.type === "group") {
+      if (entry.href === path) return true;
+      if (hasActiveDescendant(entry.items, path)) return true;
+    }
   }
   return false;
 }
 
-const isOpen = hasActiveDescendant(items, currentPath);
+const isSelfActive = href ? href === currentPath : false;
+const isOpen = isSelfActive || hasActiveDescendant(items, currentPath);
 ---
 
 {depth === 0 ? (
   <div class="mt-4 first:mt-0">
-    <p class="px-2 mb-1 text-xs font-semibold text-fd-foreground/80 tracking-wide">{label}</p>
+    {href ? (
+      <a href={href} class:list={["block px-2 mb-1 text-xs font-semibold tracking-wide no-underline", isSelfActive ? "text-fd-primary" : "text-fd-foreground/80 hover:text-fd-foreground"]}>
+        {label}
+      </a>
+    ) : (
+      <p class="px-2 mb-1 text-xs font-semibold text-fd-foreground/80 tracking-wide">{label}</p>
+    )}
     <div class="space-y-0.5">
       {items.map((item) =>
         item.type === "link" ? (
           <SidebarItem label={item.label} href={item.href} active={item.href === currentPath} icon={item.icon} />
         ) : (
-          <Astro.self label={item.label} items={item.items} currentPath={currentPath} depth={depth + 1} />
+          <Astro.self label={item.label} items={item.items} currentPath={currentPath} depth={depth + 1} href={item.href} />
         )
       )}
     </div>
@@ -40,14 +51,20 @@ const isOpen = hasActiveDescendant(items, currentPath);
   <details class="group/sub" open={isOpen}>
     <summary class="flex items-center gap-1 px-2 py-1.5 text-[13px] font-medium text-fd-muted-foreground hover:text-fd-foreground cursor-pointer select-none list-none [&::-webkit-details-marker]:hidden">
       <Icon name="lucide:chevron-right" class="w-3 h-3 shrink-0 transition-transform group-open/sub:rotate-90" />
-      {label}
+      {href ? (
+        <a href={href} class:list={["no-underline", isSelfActive ? "text-fd-primary" : "text-fd-muted-foreground hover:text-fd-foreground"]}>
+          {label}
+        </a>
+      ) : (
+        label
+      )}
     </summary>
     <div class="ml-3 pl-2 border-l border-fd-border/50 space-y-0.5 mt-0.5">
       {items.map((item) =>
         item.type === "link" ? (
           <SidebarItem label={item.label} href={item.href} active={item.href === currentPath} icon={item.icon} />
         ) : (
-          <Astro.self label={item.label} items={item.items} currentPath={currentPath} depth={depth + 1} />
+          <Astro.self label={item.label} items={item.items} currentPath={currentPath} depth={depth + 1} href={item.href} />
         )
       )}
     </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tayacrystals/lore",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "type": "module",
   "exports": {
     ".": "./index.ts",

package/routes/docs.astro

@@ -24,9 +24,14 @@ export async function getStaticPaths() {
   const entries: DocsEntry[] = await getCollection("docs", ({ data }: DocsEntry) => !data.draft);
 
   // Content entry paths
+  // Map subfolder index files (e.g. "getting-started/index") to their parent path
   const entryPaths = entries.map((entry: DocsEntry) => ({
     params: {
-      slug: entry.id === "index" ? undefined : entry.id,
+      slug: entry.id === "index"
+        ? undefined
+        : entry.id.endsWith("/index")
+          ? entry.id.slice(0, -"/index".length)
+          : entry.id,
     },
     props: { entry, isSection: false as const },
   }));
@@ -43,8 +48,13 @@ export async function getStaticPaths() {
 
   // Only create section pages for groups that don't have a matching content entry
   const entryIds = new Set(entries.map((e: DocsEntry) => e.id));
+  const indexSlugs = new Set(
+    entries
+      .filter((e: DocsEntry) => e.id.endsWith("/index"))
+      .map((e: DocsEntry) => e.id.slice(0, -"/index".length)),
+  );
   const sectionPaths = [...groupSlugs]
-    .filter((slug) => !entryIds.has(slug))
+    .filter((slug) => !entryIds.has(slug) && !indexSlugs.has(slug))
     .map((slug) => ({
       params: { slug },
       props: { groupSlug: slug, isSection: true as const },

package/utils/navigation.ts

@@ -11,6 +11,9 @@ export function flattenSidebar(entries: SidebarEntry[]): FlatNavItem[] {
     if (entry.type === "link") {
       result.push({ label: entry.label, href: entry.href });
     } else {
+      if (entry.href) {
+        result.push({ label: entry.label, href: entry.href });
+      }
       result.push(...flattenSidebar(entry.items));
     }
   }

package/utils/sidebar.ts

@@ -16,6 +16,7 @@ export interface SidebarGroup {
   label: string;
   order: number;
   slug: string;
+  href?: string;
   items: SidebarEntry[];
 }
 
@@ -54,6 +55,8 @@ function buildLevel(
         groups.set(groupSlug, []);
       }
       groups.get(groupSlug)!.push(entry);
+    } else if (relativePath === "index" && depth > 0) {
+      // Skip index files in subfolders — they're used as the group's own page
     } else {
       const href = entry.id === "index" ? `${BASE_URL}docs` : `${BASE_URL}docs/${entry.id}`;
       topLevel.push({
@@ -80,14 +83,21 @@ function buildLevel(
     const config = configAtLevel[slug];
     const childConfig = config?.children ?? {};
 
+    // Check for an index entry in this group
+    const indexEntry = groupEntries.find((e) => {
+      const rel = e.id.slice(fullSlug.length + 1);
+      return rel === "index";
+    });
+
     const items = buildLevel(groupEntries, childConfig, fullSlug, depth + 1);
     items.sort((a, b) => a.order - b.order);
 
     result.push({
       type: "group",
       label: config?.label ?? titleCase(slug),
-      order: config?.order ?? 999,
+      order: config?.order ?? (indexEntry ? indexEntry.data.order : 999),
       slug: fullSlug,
+      href: indexEntry ? `${BASE_URL}docs/${fullSlug}` : undefined,
       items,
     });
   }