@tayacrystals/lore 0.1.0

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@tayacrystals/lore",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": "./index.ts",
+    "./schema": "./schema.ts",
+    "./loaders": "./loaders.ts",
+    "./components": "./components.ts",
+    "./styles/*": "./styles/*"
+  },
+  "files": [
+    "*.ts",
+    "*.d.ts",
+    "components/",
+    "layouts/",
+    "routes/",
+    "styles/",
+    "utils/",
+    "!**/*.test.ts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0"
+  },
+  "dependencies": {
+    "@astrojs/mdx": "^4.3.13",
+    "@astrojs/sitemap": "^3.7.0",
+    "@fontsource-variable/inter": "^5.2.8",
+    "@fontsource/geist-mono": "^5.2.7",
+    "@iconify-json/lucide": "^1.2.89",
+    "@tailwindcss/vite": "^4.1.18",
+    "astro-expressive-code": "^0.41.6",
+    "astro-icon": "^1.1.5",
+    "astro-pagefind": "^1.8.5",
+    "hast-util-to-html": "^9.0.5",
+    "hastscript": "^9.0.1",
+    "rehype": "^13.0.2",
+    "tailwindcss": "^4.1.18",
+    "unist-util-visit": "^5.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@astrojs/check": "^0.9.6",
+    "@types/hast": "^3.0.4",
+    "typescript": "^5.9.3",
+    "vite": "6"
+  }
+}

package/routes/docs.astro

@@ -0,0 +1,201 @@
+---
+import { getCollection, render } from "astro:content";
+import DocsLayout from "../layouts/DocsLayout.astro";
+import { buildSidebar } from "../utils/sidebar";
+import type { TocItem } from "../utils/toc";
+import { flattenSidebar, getPrevNext } from "../utils/navigation";
+import config from "virtual:lore/config";
+import type { SidebarGroupConfig } from "../config";
+
+interface DocsEntry {
+  id: string;
+  data: {
+    title: string;
+    description?: string;
+    order: number;
+    group?: string;
+    icon?: string;
+    toc: boolean;
+    draft: boolean;
+  };
+}
+
+export async function getStaticPaths() {
+  const entries: DocsEntry[] = await getCollection("docs", ({ data }: DocsEntry) => !data.draft);
+
+  // Content entry paths
+  const entryPaths = entries.map((entry: DocsEntry) => ({
+    params: {
+      slug: entry.id === "index" ? undefined : entry.id,
+    },
+    props: { entry, isSection: false as const },
+  }));
+
+  // Collect ALL intermediate path prefixes as group slugs
+  const groupSlugs = new Set<string>();
+  for (const entry of entries) {
+    const parts = entry.id.split("/");
+    // Build up path prefixes: e.g. "a/b/c.mdx" -> "a", "a/b"
+    for (let i = 1; i < parts.length; i++) {
+      groupSlugs.add(parts.slice(0, i).join("/"));
+    }
+  }
+
+  // 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 sectionPaths = [...groupSlugs]
+    .filter((slug) => !entryIds.has(slug))
+    .map((slug) => ({
+      params: { slug },
+      props: { groupSlug: slug, isSection: true as const },
+    }));
+
+  return [...entryPaths, ...sectionPaths];
+}
+
+const allEntries: DocsEntry[] = await getCollection("docs");
+const sidebar = buildSidebar(allEntries, config.sidebar);
+const flatItems = flattenSidebar(sidebar);
+const currentPath = Astro.url.pathname.replace(/\/$/, "") || "/docs";
+const { prev, next } = getPrevNext(flatItems, currentPath);
+
+let title: string;
+let description: string | undefined;
+let toc: TocItem[] = [];
+let showToc = true;
+let Content: any = null;
+let sectionItems: { label: string; href: string; description?: string }[] = [];
+let lastUpdated: Date | null = null;
+
+if (Astro.props.isSection) {
+  // Section listing page
+  const groupSlug = Astro.props.groupSlug;
+
+  // Traverse nested config to find label for this group
+  const slugParts = groupSlug.split("/");
+  let currentConfig: Record<string, SidebarGroupConfig> = config.sidebar ?? {};
+  let label = slugParts[slugParts.length - 1];
+  for (const part of slugParts) {
+    const found = currentConfig[part];
+    if (found) {
+      label = found.label;
+      currentConfig = found.children ?? {};
+    } else {
+      // Use titleCase fallback
+      label = part.replace(/[-_]/g, " ").replace(/\b\w/g, (c: string) => c.toUpperCase());
+      break;
+    }
+  }
+
+  title = label;
+  description = `Browse all pages in ${title}.`;
+  showToc = false;
+
+  // Get direct children entries (one level deep)
+  const groupEntries = allEntries
+    .filter((e) => {
+      if (e.data.draft) return false;
+      if (!e.id.startsWith(groupSlug + "/")) return false;
+      const rest = e.id.slice(groupSlug.length + 1);
+      return !rest.includes("/"); // direct children only
+    })
+    .sort((a, b) => a.data.order - b.data.order);
+
+  sectionItems = groupEntries.map((e) => ({
+    label: e.data.title,
+    href: `/docs/${e.id}`,
+    description: e.data.description,
+  }));
+
+  // Also add sub-group links
+  const subGroups = new Set<string>();
+  for (const entry of allEntries) {
+    if (entry.data.draft) continue;
+    if (!entry.id.startsWith(groupSlug + "/")) continue;
+    const rest = entry.id.slice(groupSlug.length + 1);
+    const parts = rest.split("/");
+    if (parts.length > 1) {
+      subGroups.add(parts[0]);
+    }
+  }
+
+  for (const sub of subGroups) {
+    const subSlug = `${groupSlug}/${sub}`;
+    // Traverse config tree to find the label for this specific sub-group
+    let subLabel = sub.replace(/[-_]/g, " ").replace(/\b\w/g, (c: string) => c.toUpperCase());
+    let cfg = config.sidebar as Record<string, SidebarGroupConfig>;
+    for (const part of subSlug.split("/")) {
+      const found = cfg[part];
+      if (found) {
+        cfg = found.children ?? {};
+        // Only use label from the final segment (the sub-group itself)
+        if (part === sub) {
+          subLabel = found.label;
+        }
+      } else {
+        break;
+      }
+    }
+
+    sectionItems.push({
+      label: subLabel,
+      href: `/docs/${subSlug}`,
+      description: `Browse ${subLabel} pages.`,
+    });
+  }
+} else {
+  // Regular content page
+  const { entry } = Astro.props;
+  title = entry.data.title;
+  description = entry.data.description;
+  const rendered = await render(entry);
+  Content = rendered.Content;
+  toc = (await import("../utils/toc")).buildToc(rendered.headings);
+  showToc = entry.data.toc;
+
+  // Get last git commit date for this file
+  try {
+    const { execSync } = await import("child_process");
+    const timestamp = execSync(
+      `git log -1 --format=%cI -- "src/content/docs/${entry.id}.mdx" "src/content/docs/${entry.id}.md"`,
+      { encoding: "utf-8", timeout: 5000 },
+    ).trim();
+    if (timestamp) {
+      lastUpdated = new Date(timestamp);
+    }
+  } catch {
+    // Fallback: no git date available
+  }
+}
+---
+
+<DocsLayout
+  title={title}
+  description={description}
+  sidebar={sidebar}
+  toc={toc}
+  showToc={showToc}
+  prev={prev}
+  next={next}
+  lastUpdated={lastUpdated}
+>
+  {Content ? (
+    <Content />
+  ) : (
+    <ul class="not-prose list-none p-0 m-0 space-y-3">
+      {sectionItems.map((item) => (
+        <li>
+          <a
+            href={item.href}
+            class="block rounded-lg border border-fd-border p-4 hover:bg-fd-muted/50 transition-colors no-underline"
+          >
+            <span class="font-medium text-fd-foreground">{item.label}</span>
+            {item.description && (
+              <span class="block text-sm text-fd-muted-foreground mt-1">{item.description}</span>
+            )}
+          </a>
+        </li>
+      ))}
+    </ul>
+  )}
+</DocsLayout>

package/schema.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+
+export function docsSchema() {
+  return z.object({
+    title: z.string(),
+    description: z.string().optional(),
+    order: z.number().default(999),
+    group: z.string().optional(),
+    icon: z.string().optional(),
+    toc: z.boolean().default(true),
+    draft: z.boolean().default(false),
+  });
+}

package/styles/global.css

@@ -0,0 +1,78 @@
+@import "tailwindcss";
+@source "../components";
+@source "../layouts";
+@source "../routes";
+@import "@fontsource-variable/inter";
+@import "@fontsource/geist-mono";
+
+@theme {
+  --font-sans: "Inter Variable", ui-sans-serif, system-ui, sans-serif;
+  --font-mono: "Geist Mono", ui-monospace, monospace;
+
+  --color-fd-background: oklch(0.985 0 0);
+  --color-fd-foreground: oklch(0.145 0 0);
+  --color-fd-muted: oklch(0.955 0 0);
+  --color-fd-muted-foreground: oklch(0.46 0 0);
+  --color-fd-border: oklch(0.915 0 0);
+  --color-fd-primary: oklch(0.6 0.16 var(--fd-hue));
+  --color-fd-primary-foreground: oklch(0.98 0 0);
+  --color-fd-accent: oklch(0.96 0 0);
+  --color-fd-accent-foreground: oklch(0.145 0 0);
+  --color-fd-card: oklch(0.985 0 0);
+  --color-fd-card-foreground: oklch(0.145 0 0);
+  --color-fd-popover: oklch(0.985 0 0);
+  --color-fd-popover-foreground: oklch(0.145 0 0);
+  --color-fd-ring: oklch(0.6 0.16 var(--fd-hue));
+
+  --radius-lg: 0.75rem;
+  --radius-md: 0.5rem;
+  --radius-sm: 0.375rem;
+
+  --width-sidebar: 17rem;
+  --width-toc: 14rem;
+  --width-content: 50rem;
+  --height-header: 3.5rem;
+  --max-width-layout: 88rem;
+}
+
+.dark {
+  --color-fd-background: oklch(0.13 0 0);
+  --color-fd-foreground: oklch(0.92 0 0);
+  --color-fd-muted: oklch(0.18 0 0);
+  --color-fd-muted-foreground: oklch(0.55 0 0);
+  --color-fd-border: oklch(0.2 0 0);
+  --color-fd-primary: oklch(0.7 0.16 var(--fd-hue));
+  --color-fd-primary-foreground: oklch(0.1 0 0);
+  --color-fd-accent: oklch(0.16 0 0);
+  --color-fd-accent-foreground: oklch(0.92 0 0);
+  --color-fd-card: oklch(0.15 0 0);
+  --color-fd-card-foreground: oklch(0.92 0 0);
+  --color-fd-popover: oklch(0.15 0 0);
+  --color-fd-popover-foreground: oklch(0.92 0 0);
+  --color-fd-ring: oklch(0.7 0.16 var(--fd-hue));
+}
+
+@layer base {
+  * {
+    border-color: var(--color-fd-border);
+  }
+
+  body {
+    font-family: var(--font-sans);
+    background-color: var(--color-fd-background);
+    color: var(--color-fd-foreground);
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+  }
+
+  ::selection {
+    background-color: oklch(0.6 0.16 var(--fd-hue) / 0.2);
+  }
+}
+
+@layer utilities {
+  .scrollbar-thin {
+    scrollbar-width: thin;
+    scrollbar-color: var(--color-fd-border) transparent;
+  }
+}

package/styles/prose.css

@@ -0,0 +1,148 @@
+.fd-prose {
+  line-height: 1.7;
+  max-width: none;
+  font-size: 0.9375rem;
+}
+
+.fd-prose h1 {
+  font-size: 2rem;
+  font-weight: 700;
+  margin-top: 0;
+  margin-bottom: 0.75rem;
+  letter-spacing: -0.03em;
+  line-height: 1.2;
+}
+
+.fd-prose h2 {
+  font-size: 1.375rem;
+  font-weight: 600;
+  margin-top: 2.5rem;
+  margin-bottom: 0.75rem;
+  letter-spacing: -0.02em;
+  scroll-margin-top: 4rem;
+}
+
+.fd-prose h2 a {
+  text-decoration: none;
+  color: inherit;
+}
+
+.fd-prose h3 {
+  font-size: 1.125rem;
+  font-weight: 600;
+  margin-top: 2rem;
+  margin-bottom: 0.5rem;
+  scroll-margin-top: 4rem;
+}
+
+.fd-prose h4 {
+  font-size: 1rem;
+  font-weight: 600;
+  margin-top: 1.5rem;
+  margin-bottom: 0.5rem;
+}
+
+.fd-prose p {
+  margin-top: 0;
+  margin-bottom: 1rem;
+}
+
+.fd-prose a {
+  color: var(--color-fd-foreground);
+  text-decoration: underline;
+  text-underline-offset: 3px;
+  text-decoration-thickness: 1px;
+  text-decoration-color: var(--color-fd-border);
+  transition: text-decoration-color 0.15s;
+}
+
+.fd-prose a:hover {
+  text-decoration-color: var(--color-fd-foreground);
+}
+
+.fd-prose code:not(pre code) {
+  font-family: var(--font-mono);
+  font-size: 0.8125em;
+  background-color: var(--color-fd-muted);
+  padding: 0.2em 0.4em;
+  border-radius: 0.25rem;
+  font-weight: 500;
+}
+
+.fd-prose pre {
+  margin-top: 0;
+  margin-bottom: 1rem;
+  border-radius: 0.5rem;
+}
+
+.fd-prose ul {
+  list-style-type: disc;
+  padding-left: 1.5rem;
+  margin-bottom: 1rem;
+}
+
+.fd-prose ol {
+  list-style-type: decimal;
+  padding-left: 1.5rem;
+  margin-bottom: 1rem;
+}
+
+.fd-prose li {
+  margin-bottom: 0.25rem;
+}
+
+.fd-prose li > ul,
+.fd-prose li > ol {
+  margin-top: 0.25rem;
+  margin-bottom: 0;
+}
+
+.fd-prose blockquote {
+  border-left: 2px solid var(--color-fd-border);
+  padding-left: 1rem;
+  margin: 1rem 0;
+  color: var(--color-fd-muted-foreground);
+}
+
+.fd-prose table {
+  width: 100%;
+  border-collapse: collapse;
+  margin-bottom: 1rem;
+  font-size: 0.875rem;
+}
+
+.fd-prose thead th {
+  text-align: left;
+  font-weight: 600;
+  padding: 0.5rem 1rem;
+  border-bottom: 2px solid var(--color-fd-border);
+}
+
+.fd-prose tbody td {
+  padding: 0.5rem 1rem;
+  border-bottom: 1px solid var(--color-fd-border);
+}
+
+.fd-prose hr {
+  border: none;
+  border-top: 1px solid var(--color-fd-border);
+  margin: 2rem 0;
+}
+
+.fd-prose img {
+  border-radius: 0.5rem;
+  margin: 1.5rem 0;
+  max-width: 100%;
+}
+
+.fd-prose strong {
+  font-weight: 600;
+}
+
+.fd-prose .callout-content p {
+  margin-bottom: 0;
+}
+
+.fd-prose .callout-content p:not(:last-child) {
+  margin-bottom: 0.25rem;
+}

package/utils/navigation.ts

@@ -0,0 +1,32 @@
+import type { SidebarEntry } from "./sidebar";
+
+export interface FlatNavItem {
+  label: string;
+  href: string;
+}
+
+export function flattenSidebar(entries: SidebarEntry[]): FlatNavItem[] {
+  const result: FlatNavItem[] = [];
+  for (const entry of entries) {
+    if (entry.type === "link") {
+      result.push({ label: entry.label, href: entry.href });
+    } else {
+      result.push(...flattenSidebar(entry.items));
+    }
+  }
+  return result;
+}
+
+export function getPrevNext(
+  flatItems: FlatNavItem[],
+  currentPath: string,
+): { prev: FlatNavItem | null; next: FlatNavItem | null } {
+  const BASE_URL = import.meta.env.BASE_URL || "/";
+  const normalized = currentPath.replace(/\/$/, "") || `${BASE_URL}docs`;
+  const index = flatItems.findIndex((item) => item.href === normalized);
+
+  return {
+    prev: index > 0 ? flatItems[index - 1] : null,
+    next: index < flatItems.length - 1 ? flatItems[index + 1] : null,
+  };
+}