feat(docs): add full documentation generation and update guide links to include .md extension

Author: zaewc

docs/.vitepress/config.ts

@@ -1,4 +1,12 @@
 import { defineConfig } from "vitepress";
+import fs from "node:fs";
+import path from "node:path";
+
+const SITE_URL = "https://976520.github.io/scrolloop";
+
+function stripFrontmatter(content: string): string {
+  return content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n/, "");
+}
 
 export default defineConfig({
   title: "scrolloop",
@@ -8,6 +16,39 @@ export default defineConfig({
 
   base: "/scrolloop/",
 
+  async buildEnd(siteConfig) {
+    const { srcDir, outDir, pages } = siteConfig;
+
+    const fullParts: string[] = [];
+
+    for (const page of pages) {
+      if (!page.startsWith("guide/")) continue;
+
+      const srcPath = path.join(srcDir, page);
+      if (!fs.existsSync(srcPath)) continue;
+
+      const raw = fs.readFileSync(srcPath, "utf-8");
+      const body = stripFrontmatter(raw).trim();
+      if (!body) continue;
+
+      const destPath = path.join(outDir, page);
+      fs.mkdirSync(path.dirname(destPath), { recursive: true });
+      fs.writeFileSync(destPath, raw);
+
+      const url = `${SITE_URL}/${page.replace(/\.md$/, "")}`;
+      fullParts.push(`# Source: ${url}\n\n${body}`);
+    }
+
+    const header =
+      "# scrolloop — full documentation\n\n" +
+      "> Modern virtual and infinite scrolling components for React, " +
+      "React Native, Preact, Vue, and Svelte.\n";
+    fs.writeFileSync(
+      path.join(outDir, "llms-full.txt"),
+      `${header}\n${fullParts.join("\n\n---\n\n")}\n`
+    );
+  },
+
   head: [
     ["link", { rel: "icon", href: "/favicon.svg" }],
     ["meta", { name: "theme-color", content: "#7c3aed" }],

docs/public/llms.txt

@@ -14,20 +14,21 @@ scrolloop is a monorepo of framework adapters built on a platform-independent vi
 
 ## Guide
 
-- [Introduction](https://976520.github.io/scrolloop/guide/introduction): What scrolloop is, why virtual scrolling matters, and the packages available.
-- [Quick start](https://976520.github.io/scrolloop/guide/quick-start): Build a windowing list in about a minute with a minimal React example.
-- [Concepts](https://976520.github.io/scrolloop/guide/concepts): How windowing, overscan, and absolute positioning let scrolloop render tens of thousands of items without performance loss.
+- [Introduction](https://976520.github.io/scrolloop/guide/introduction.md): What scrolloop is, why virtual scrolling matters, and the packages available.
+- [Quick start](https://976520.github.io/scrolloop/guide/quick-start.md): Build a windowing list in about a minute with a minimal React example.
+- [Concepts](https://976520.github.io/scrolloop/guide/concepts.md): How windowing, overscan, and absolute positioning let scrolloop render tens of thousands of items without performance loss.
 
 ## Components
 
-- [VirtualList](https://976520.github.io/scrolloop/guide/virtual-list): The core high-performance list component, with per-runtime usage and props (`count`, `itemSize`, `height`, `renderItem`).
-- [InfiniteList](https://976520.github.io/scrolloop/guide/infinite-list): Combines data fetching with virtualization for page-based infinite scrolling (`fetchPage`, `pageSize`, `itemSize`, `renderItem`).
+- [VirtualList](https://976520.github.io/scrolloop/guide/virtual-list.md): The core high-performance list component, with per-runtime usage and props (`count`, `itemSize`, `height`, `renderItem`).
+- [InfiniteList](https://976520.github.io/scrolloop/guide/infinite-list.md): Combines data fetching with virtualization for page-based infinite scrolling (`fetchPage`, `pageSize`, `itemSize`, `renderItem`).
 
 ## Advanced
 
-- [SSR Guide](https://976520.github.io/scrolloop/guide/ssr): Server-side rendering support for `@scrolloop/react`'s `InfiniteList`, using `isServerSide` and initial data to improve initial load and SEO (React DOM adapter only).
+- [SSR Guide](https://976520.github.io/scrolloop/guide/ssr.md): Server-side rendering support for `@scrolloop/react`'s `InfiniteList`, using `isServerSide` and initial data to improve initial load and SEO (React DOM adapter only).
 
 ## Optional
 
+- [Full documentation](https://976520.github.io/scrolloop/llms-full.txt): Every guide page concatenated into a single markdown file.
 - [GitHub repository](https://github.com/976520/scrolloop): Source code, issues, and contribution workflow.
 - [README](https://github.com/976520/scrolloop#readme): Installation commands for each framework package.