veslx 0.1.28 → 0.1.30

package/bin/lib/export.ts

@@ -0,0 +1,214 @@
+import { createServer, type ViteDevServer } from 'vite'
+import { chromium, type Browser } from 'playwright'
+import { execSync } from 'child_process'
+import importConfig from "./import-config"
+import veslxPlugin from '../../plugin/src/plugin'
+import path from 'path'
+import fs from 'fs'
+import { log } from './log'
+
+interface PackageJson {
+  name?: string;
+  description?: string;
+}
+
+interface ExportOptions {
+  timeout?: number;
+}
+
+async function readPackageJson(cwd: string): Promise<PackageJson | null> {
+  const file = Bun.file(path.join(cwd, 'package.json'));
+  if (!await file.exists()) return null;
+  try {
+    return await file.json();
+  } catch {
+    return null;
+  }
+}
+
+function getGitHubRepo(cwd: string): string {
+  try {
+    const remote = execSync('git remote get-url origin', { cwd, encoding: 'utf-8' }).trim();
+    const match = remote.match(/github\.com[:/]([^/]+\/[^/.]+)/);
+    return match ? match[1] : '';
+  } catch {
+    return '';
+  }
+}
+
+async function getDefaultConfig(cwd: string) {
+  const pkg = await readPackageJson(cwd);
+  const folderName = path.basename(cwd);
+  const name = pkg?.name || folderName;
+
+  return {
+    dir: '.',
+    site: {
+      name,
+      description: pkg?.description || '',
+      github: getGitHubRepo(cwd),
+    }
+  };
+}
+
+/**
+ * Detect if a path refers to slides based on file naming conventions
+ */
+function isSlides(filePath: string): boolean {
+  const filename = path.basename(filePath).toLowerCase()
+  return (
+    filePath.endsWith('.slides.mdx') ||
+    filePath.endsWith('.slides.md') ||
+    filename === 'slides.mdx' ||
+    filename === 'slides.md'
+  )
+}
+
+/**
+ * Generate default output filename from input path
+ */
+function getDefaultOutputPath(inputPath: string): string {
+  const baseName = inputPath
+    .replace(/\.(mdx|md)$/, '')
+    .replace(/\//g, '-')
+    .replace(/^-/, '')
+  return `${baseName}.pdf`
+}
+
+export default async function exportToPdf(
+  inputPath: string,
+  outputPath?: string,
+  options: ExportOptions = {}
+): Promise<void> {
+  const cwd = process.cwd()
+
+  // Validate input file exists
+  const fullInputPath = path.isAbsolute(inputPath)
+    ? inputPath
+    : path.resolve(cwd, inputPath)
+
+  if (!fs.existsSync(fullInputPath)) {
+    log.error(`File not found: ${inputPath}`)
+    process.exit(1)
+  }
+
+  // Validate it's an MDX or MD file
+  if (!inputPath.endsWith('.mdx') && !inputPath.endsWith('.md')) {
+    log.error('Only .mdx and .md files can be exported')
+    process.exit(1)
+  }
+
+  // Determine output path
+  const finalOutputPath = outputPath || getDefaultOutputPath(inputPath)
+  const fullOutputPath = path.isAbsolute(finalOutputPath)
+    ? finalOutputPath
+    : path.resolve(cwd, finalOutputPath)
+
+  // Determine content type
+  const contentIsSlides = isSlides(inputPath)
+
+  log.info(`Exporting ${contentIsSlides ? 'slides' : 'post'}: ${inputPath}`)
+
+  let server: ViteDevServer | null = null
+  let browser: Browser | null = null
+
+  try {
+    // Load config (same pattern as serve.ts)
+    const defaults = await getDefaultConfig(cwd)
+    let fileConfig = await importConfig(cwd)
+
+    const config = {
+      dir: fileConfig?.dir || defaults.dir,
+      site: {
+        ...defaults.site,
+        ...fileConfig?.site,
+      },
+      slides: fileConfig?.slides,
+    }
+
+    const veslxRoot = new URL('../..', import.meta.url).pathname
+    const configFile = new URL('../../vite.config.ts', import.meta.url).pathname
+
+    // Resolve content directory
+    const contentDir = path.isAbsolute(config.dir)
+      ? config.dir
+      : path.resolve(cwd, config.dir)
+
+    // Start dev server on random available port
+    server = await createServer({
+      root: veslxRoot,
+      configFile,
+      cacheDir: path.join(cwd, 'node_modules/.vite'),
+      plugins: [veslxPlugin(contentDir, config)],
+      server: {
+        port: 0, // Auto-select available port
+      },
+      logLevel: 'silent',
+    })
+
+    await server.listen()
+
+    const serverUrl = server.resolvedUrls?.local[0]
+    if (!serverUrl) {
+      throw new Error('Failed to get server URL')
+    }
+
+    // Build page URL from relative path
+    const relativePath = path.relative(contentDir, fullInputPath)
+    const pageUrl = `${serverUrl}${relativePath}`
+
+    // Launch browser and navigate
+    browser = await chromium.launch({ headless: true })
+    const page = await browser.newPage()
+
+    await page.goto(pageUrl, {
+      waitUntil: 'networkidle',
+      timeout: options.timeout || 30000
+    })
+
+    // Wait for content to render
+    await page.waitForTimeout(500)
+    try {
+      await page.waitForSelector('article, .slides-container', { timeout: 5000 })
+    } catch {
+      // Content selector not found, continue anyway
+    }
+
+    // Export to PDF with appropriate settings
+    const pdfOptions = contentIsSlides
+      ? {
+          path: fullOutputPath,
+          landscape: true,
+          printBackground: true,
+          preferCSSPageSize: true,
+          margin: { top: '0', right: '0', bottom: '0', left: '0' },
+        }
+      : {
+          path: fullOutputPath,
+          landscape: false,
+          printBackground: true,
+          preferCSSPageSize: true,
+          margin: { top: '1in', right: '1in', bottom: '1in', left: '1in' },
+        }
+
+    await page.pdf(pdfOptions)
+
+    log.success(finalOutputPath)
+
+  } catch (error) {
+    if (error instanceof Error) {
+      log.error(error.message)
+    } else {
+      log.error('Export failed')
+    }
+    process.exit(1)
+
+  } finally {
+    if (browser) {
+      await browser.close()
+    }
+    if (server) {
+      await server.close()
+    }
+  }
+}

package/dist/client/components/front-matter.js

@@ -1,11 +1,56 @@
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useLocation } from "react-router-dom";
 import { useFrontmatter } from "../lib/frontmatter-context.js";
 import { formatDate } from "../lib/format-date.js";
+import veslxConfig from "virtual:veslx-config";
+function convertToLlmsTxt(rawMdx, frontmatter) {
+  const contentWithoutFrontmatter = rawMdx.replace(/^---[\s\S]*?---\n*/, "");
+  const parts = [];
+  const title = (frontmatter == null ? void 0 : frontmatter.title) || "Untitled";
+  parts.push(`# ${title}`);
+  if (frontmatter == null ? void 0 : frontmatter.description) {
+    parts.push("");
+    parts.push(`> ${frontmatter.description}`);
+  }
+  if (contentWithoutFrontmatter.trim()) {
+    parts.push("");
+    parts.push(contentWithoutFrontmatter.trim());
+  }
+  return parts.join("\n");
+}
 function FrontMatter() {
   const frontmatter = useFrontmatter();
+  const location = useLocation();
+  const config = veslxConfig.site;
+  const rawUrl = `/raw${location.pathname.replace(/^\//, "/")}`;
+  const handleLlmsTxt = async (e) => {
+    e.preventDefault();
+    try {
+      const res = await fetch(rawUrl);
+      if (!res.ok) throw new Error("Failed to fetch");
+      const rawMdx = await res.text();
+      const llmsTxt = convertToLlmsTxt(rawMdx, frontmatter);
+      const blob = new Blob([llmsTxt], { type: "text/plain" });
+      const url = URL.createObjectURL(blob);
+      window.location.href = url;
+    } catch {
+      console.error("Failed to load llms.txt");
+    }
+  };
   return /* @__PURE__ */ jsx("div", { children: (frontmatter == null ? void 0 : frontmatter.title) && /* @__PURE__ */ jsxs("header", { className: "not-prose flex flex-col gap-2 mb-8 pt-4", children: [
     /* @__PURE__ */ jsx("h1", { className: "text-2xl md:text-3xl font-semibold tracking-tight text-foreground mb-3", children: frontmatter == null ? void 0 : frontmatter.title }),
-    /* @__PURE__ */ jsx("div", { className: "flex flex-wrap items-center gap-3 text-muted-foreground", children: (frontmatter == null ? void 0 : frontmatter.date) && /* @__PURE__ */ jsx("time", { className: "font-mono text-xs bg-muted px-2 py-0.5 rounded", children: formatDate(new Date(frontmatter.date)) }) }),
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-3 text-muted-foreground", children: [
+      (frontmatter == null ? void 0 : frontmatter.date) && /* @__PURE__ */ jsx("time", { className: "font-mono text-xs bg-muted px-2 py-0.5 rounded", children: formatDate(new Date(frontmatter.date)) }),
+      config.llmsTxt && /* @__PURE__ */ jsx(
+        "a",
+        {
+          href: "#",
+          onClick: handleLlmsTxt,
+          className: "font-mono text-xs text-muted-foreground/70 hover:text-foreground underline underline-offset-2 transition-colors",
+          children: "llms.txt"
+        }
+      )
+    ] }),
     (frontmatter == null ? void 0 : frontmatter.description) && /* @__PURE__ */ jsx("div", { className: "flex flex-wrap text-sm items-center gap-3 text-muted-foreground", children: frontmatter == null ? void 0 : frontmatter.description })
   ] }) });
 }

package/dist/client/components/front-matter.js.map

@@ -1 +1 @@
-{"version":3,"file":"front-matter.js","sources":["../../../src/components/front-matter.tsx"],"sourcesContent":["import { useFrontmatter } from \"@/lib/frontmatter-context\";\nimport { formatDate } from \"@/lib/format-date\"\n\nexport function FrontMatter(){\n  const frontmatter = useFrontmatter();\n\n  return (\n    <div>\n      {frontmatter?.title && (\n        <header className=\"not-prose flex flex-col gap-2 mb-8 pt-4\">\n          <h1 className=\"text-2xl md:text-3xl font-semibold tracking-tight text-foreground mb-3\">\n            {frontmatter?.title}\n          </h1>\n\n          {/* Meta line */}\n          <div className=\"flex flex-wrap items-center gap-3 text-muted-foreground\">\n            {frontmatter?.date && (\n              <time className=\"font-mono text-xs bg-muted px-2 py-0.5 rounded\">\n                {formatDate(new Date(frontmatter.date as string))}\n              </time>\n            )}\n          </div>\n\n          {frontmatter?.description && (\n            <div className=\"flex flex-wrap text-sm items-center gap-3 text-muted-foreground\">\n              {frontmatter?.description}\n            </div>\n          )}\n        </header>\n      )}\n    </div>\n  )\n}\n"],"names":[],"mappings":";;;AAGO,SAAS,cAAa;AAC3B,QAAM,cAAc,eAAA;AAEpB,6BACG,OAAA,EACE,WAAA,2CAAa,UACZ,qBAAC,UAAA,EAAO,WAAU,2CAChB,UAAA;AAAA,IAAA,oBAAC,MAAA,EAAG,WAAU,0EACX,UAAA,2CAAa,OAChB;AAAA,wBAGC,OAAA,EAAI,WAAU,2DACZ,WAAA,2CAAa,SACZ,oBAAC,QAAA,EAAK,WAAU,kDACb,qBAAW,IAAI,KAAK,YAAY,IAAc,CAAC,GAClD,GAEJ;AAAA,KAEC,2CAAa,gBACZ,oBAAC,SAAI,WAAU,mEACZ,qDAAa,YAAA,CAChB;AAAA,EAAA,EAAA,CAEJ,EAAA,CAEJ;AAEJ;"}
+{"version":3,"file":"front-matter.js","sources":["../../../src/components/front-matter.tsx"],"sourcesContent":["import { useLocation } from \"react-router-dom\";\nimport { useFrontmatter } from \"@/lib/frontmatter-context\";\nimport { formatDate } from \"@/lib/format-date\";\nimport veslxConfig from \"virtual:veslx-config\";\n\n/**\n * Convert MDX content to llms.txt format.\n */\nfunction convertToLlmsTxt(\n  rawMdx: string,\n  frontmatter?: { title?: string; description?: string }\n): string {\n  const contentWithoutFrontmatter = rawMdx.replace(/^---[\\s\\S]*?---\\n*/, '')\n\n  const parts: string[] = []\n\n  const title = frontmatter?.title || 'Untitled'\n  parts.push(`# ${title}`)\n\n  if (frontmatter?.description) {\n    parts.push('')\n    parts.push(`> ${frontmatter.description}`)\n  }\n\n  if (contentWithoutFrontmatter.trim()) {\n    parts.push('')\n    parts.push(contentWithoutFrontmatter.trim())\n  }\n\n  return parts.join('\\n')\n}\n\nexport function FrontMatter() {\n  const frontmatter = useFrontmatter();\n  const location = useLocation();\n  const config = veslxConfig.site;\n\n  const rawUrl = `/raw${location.pathname.replace(/^\\//, '/')}`;\n\n  const handleLlmsTxt = async (e: React.MouseEvent) => {\n    e.preventDefault();\n    try {\n      const res = await fetch(rawUrl);\n      if (!res.ok) throw new Error('Failed to fetch');\n      const rawMdx = await res.text();\n      const llmsTxt = convertToLlmsTxt(rawMdx, frontmatter);\n      const blob = new Blob([llmsTxt], { type: 'text/plain' });\n      const url = URL.createObjectURL(blob);\n      window.location.href = url;\n    } catch {\n      console.error('Failed to load llms.txt');\n    }\n  };\n\n  return (\n    <div>\n      {frontmatter?.title && (\n        <header className=\"not-prose flex flex-col gap-2 mb-8 pt-4\">\n          <h1 className=\"text-2xl md:text-3xl font-semibold tracking-tight text-foreground mb-3\">\n            {frontmatter?.title}\n          </h1>\n\n          {/* Meta line */}\n          <div className=\"flex flex-wrap items-center gap-3 text-muted-foreground\">\n            {frontmatter?.date && (\n              <time className=\"font-mono text-xs bg-muted px-2 py-0.5 rounded\">\n                {formatDate(new Date(frontmatter.date as string))}\n              </time>\n            )}\n            {config.llmsTxt && (\n              <a\n                href=\"#\"\n                onClick={handleLlmsTxt}\n                className=\"font-mono text-xs text-muted-foreground/70 hover:text-foreground underline underline-offset-2 transition-colors\"\n              >\n                llms.txt\n              </a>\n            )}\n          </div>\n\n          {frontmatter?.description && (\n            <div className=\"flex flex-wrap text-sm items-center gap-3 text-muted-foreground\">\n              {frontmatter?.description}\n            </div>\n          )}\n        </header>\n      )}\n    </div>\n  );\n}\n"],"names":[],"mappings":";;;;;AAQA,SAAS,iBACP,QACA,aACQ;AACR,QAAM,4BAA4B,OAAO,QAAQ,sBAAsB,EAAE;AAEzE,QAAM,QAAkB,CAAA;AAExB,QAAM,SAAQ,2CAAa,UAAS;AACpC,QAAM,KAAK,KAAK,KAAK,EAAE;AAEvB,MAAI,2CAAa,aAAa;AAC5B,UAAM,KAAK,EAAE;AACb,UAAM,KAAK,KAAK,YAAY,WAAW,EAAE;AAAA,EAC3C;AAEA,MAAI,0BAA0B,QAAQ;AACpC,UAAM,KAAK,EAAE;AACb,UAAM,KAAK,0BAA0B,MAAM;AAAA,EAC7C;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEO,SAAS,cAAc;AAC5B,QAAM,cAAc,eAAA;AACpB,QAAM,WAAW,YAAA;AACjB,QAAM,SAAS,YAAY;AAE3B,QAAM,SAAS,OAAO,SAAS,SAAS,QAAQ,OAAO,GAAG,CAAC;AAE3D,QAAM,gBAAgB,OAAO,MAAwB;AACnD,MAAE,eAAA;AACF,QAAI;AACF,YAAM,MAAM,MAAM,MAAM,MAAM;AAC9B,UAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,iBAAiB;AAC9C,YAAM,SAAS,MAAM,IAAI,KAAA;AACzB,YAAM,UAAU,iBAAiB,QAAQ,WAAW;AACpD,YAAM,OAAO,IAAI,KAAK,CAAC,OAAO,GAAG,EAAE,MAAM,cAAc;AACvD,YAAM,MAAM,IAAI,gBAAgB,IAAI;AACpC,aAAO,SAAS,OAAO;AAAA,IACzB,QAAQ;AACN,cAAQ,MAAM,yBAAyB;AAAA,IACzC;AAAA,EACF;AAEA,6BACG,OAAA,EACE,WAAA,2CAAa,UACZ,qBAAC,UAAA,EAAO,WAAU,2CAChB,UAAA;AAAA,IAAA,oBAAC,MAAA,EAAG,WAAU,0EACX,UAAA,2CAAa,OAChB;AAAA,IAGA,qBAAC,OAAA,EAAI,WAAU,2DACZ,UAAA;AAAA,OAAA,2CAAa,SACZ,oBAAC,QAAA,EAAK,WAAU,kDACb,UAAA,WAAW,IAAI,KAAK,YAAY,IAAc,CAAC,EAAA,CAClD;AAAA,MAED,OAAO,WACN;AAAA,QAAC;AAAA,QAAA;AAAA,UACC,MAAK;AAAA,UACL,SAAS;AAAA,UACT,WAAU;AAAA,UACX,UAAA;AAAA,QAAA;AAAA,MAAA;AAAA,IAED,GAEJ;AAAA,KAEC,2CAAa,gBACZ,oBAAC,SAAI,WAAU,mEACZ,qDAAa,YAAA,CAChB;AAAA,EAAA,EAAA,CAEJ,EAAA,CAEJ;AAEJ;"}

package/dist/client/components/post-list.js

@@ -4,6 +4,7 @@ import { directoryToPostEntries, filterVisiblePosts, getFrontmatter } from "../l
 import { useDirectory } from "../plugin/src/client.js";
 import { ErrorDisplay } from "./page-error.js";
 import { PostListItem } from "./post-list-item.js";
+import veslxConfig from "virtual:veslx-config";
 function formatName(name) {
   return name.replace(/^\d+-/, "").replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
@@ -19,6 +20,7 @@ function getLinkPath(post) {
   }
 }
 function PostList() {
+  var _a;
   const { "*": path = "." } = useParams();
   const { directory, error } = useDirectory(path);
   if (error) {
@@ -35,7 +37,20 @@ function PostList() {
   if (posts.length === 0) {
     return /* @__PURE__ */ jsx("div", { className: "py-24 text-center", children: /* @__PURE__ */ jsx("p", { className: "text-muted-foreground font-mono text-sm tracking-wide", children: "no entries" }) });
   }
-  posts = posts.sort((a, b) => a.name.localeCompare(b.name));
+  const sortMode = ((_a = veslxConfig.posts) == null ? void 0 : _a.sort) ?? "alpha";
+  if (sortMode === "date") {
+    posts = posts.sort((a, b) => {
+      var _a2, _b;
+      const dateA = (_a2 = getFrontmatter(a)) == null ? void 0 : _a2.date;
+      const dateB = (_b = getFrontmatter(b)) == null ? void 0 : _b.date;
+      if (!dateA && !dateB) return a.name.localeCompare(b.name);
+      if (!dateA) return 1;
+      if (!dateB) return -1;
+      return new Date(dateB).getTime() - new Date(dateA).getTime();
+    });
+  } else {
+    posts = posts.sort((a, b) => a.name.localeCompare(b.name));
+  }
   return /* @__PURE__ */ jsx("div", { className: "space-y-1 not-prose", children: posts.map((post) => {
     const frontmatter = getFrontmatter(post);
     const title = (frontmatter == null ? void 0 : frontmatter.title) || formatName(post.name);

package/dist/client/components/post-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"post-list.js","sources":["../../../src/components/post-list.tsx"],"sourcesContent":["import { useParams } from \"react-router-dom\";\nimport {\n  type PostEntry,\n  directoryToPostEntries,\n  filterVisiblePosts,\n  getFrontmatter,\n} from \"@/lib/content-classification\";\nimport { useDirectory } from \"../../plugin/src/client\";\nimport { ErrorDisplay } from \"./page-error\";\nimport Loading from \"./loading\";\nimport { PostListItem } from \"./post-list-item\";\n\n// Helper to format name for display (e.g., \"01-getting-started\" → \"Getting Started\")\nfunction formatName(name: string): string {\n  return name\n    .replace(/^\\d+-/, '')\n    .replace(/-/g, ' ')\n    .replace(/\\b\\w/g, c => c.toUpperCase());\n}\n\n// Helper to get link path from post\nfunction getLinkPath(post: PostEntry): string {\n  if (post.file) {\n    // Standalone MDX file\n    return `/${post.file.path}`;\n  } else if (post.slides && !post.readme) {\n    // Folder with only slides\n    return `/${post.slides.path}`;\n  } else if (post.readme) {\n    // Folder with readme\n    return `/${post.readme.path}`;\n  } else {\n    // Fallback to folder path\n    return `/${post.path}`;\n  }\n}\n\nexport function PostList() {\n  const { \"*\": path = \".\" } = useParams();\n\n  const { directory, loading, error } = useDirectory(path)\n\n  if (error) {\n    return <ErrorDisplay error={error} path={path} />;\n  }\n\n  if (loading) {\n    return (\n      <Loading />\n    )\n  }\n\n  if (!directory) {\n    return (\n      <div className=\"py-24 text-center\">\n        <p className=\"text-muted-foreground font-mono text-sm tracking-wide\">no entries</p>\n      </div>\n    );\n  }\n\n  let posts = directoryToPostEntries(directory);\n\n  if (posts.length === 0) {\n    return (\n      <div className=\"py-24 text-center\">\n        <p className=\"text-muted-foreground font-mono text-sm tracking-wide\">no entries</p>\n      </div>\n    );\n  }\n\n  // Filter out hidden and draft posts\n  posts = filterVisiblePosts(posts);\n\n  if (posts.length === 0) {\n    return (\n      <div className=\"py-24 text-center\">\n        <p className=\"text-muted-foreground font-mono text-sm tracking-wide\">no entries</p>\n      </div>\n    );\n  }\n\n  // Alphanumeric sorting by name\n  posts = posts.sort((a, b) => a.name.localeCompare(b.name));\n\n  return (\n    <div className=\"space-y-1 not-prose\">\n      {posts.map((post) => {\n        const frontmatter = getFrontmatter(post);\n        const title = (frontmatter?.title as string) || formatName(post.name);\n        const description = frontmatter?.description as string | undefined;\n        const date = frontmatter?.date ? new Date(frontmatter.date as string) : undefined;\n        const linkPath = getLinkPath(post);\n        const isSlides = linkPath.endsWith('SLIDES.mdx') || linkPath.endsWith('.slides.mdx');\n\n        return (\n          <PostListItem\n            key={post.path}\n            title={title}\n            description={description}\n            date={date}\n            linkPath={linkPath}\n            isSlides={isSlides}\n          />\n        );\n      })}\n    </div>\n  );\n}\n"],"names":[],"mappings":";;;;;;AAaA,SAAS,WAAW,MAAsB;AACxC,SAAO,KACJ,QAAQ,SAAS,EAAE,EACnB,QAAQ,MAAM,GAAG,EACjB,QAAQ,SAAS,CAAA,MAAK,EAAE,aAAa;AAC1C;AAGA,SAAS,YAAY,MAAyB;AAC5C,MAAI,KAAK,MAAM;AAEb,WAAO,IAAI,KAAK,KAAK,IAAI;AAAA,EAC3B,WAAW,KAAK,UAAU,CAAC,KAAK,QAAQ;AAEtC,WAAO,IAAI,KAAK,OAAO,IAAI;AAAA,EAC7B,WAAW,KAAK,QAAQ;AAEtB,WAAO,IAAI,KAAK,OAAO,IAAI;AAAA,EAC7B,OAAO;AAEL,WAAO,IAAI,KAAK,IAAI;AAAA,EACtB;AACF;AAEO,SAAS,WAAW;AACzB,QAAM,EAAE,KAAK,OAAO,IAAA,IAAQ,UAAA;AAE5B,QAAM,EAAE,WAAoB,UAAU,aAAa,IAAI;AAEvD,MAAI,OAAO;AACT,WAAO,oBAAC,cAAA,EAAa,OAAc,KAAA,CAAY;AAAA,EACjD;AAQA,MAAI,CAAC,WAAW;AACd,WACE,oBAAC,SAAI,WAAU,qBACb,8BAAC,KAAA,EAAE,WAAU,yDAAwD,UAAA,aAAA,CAAU,EAAA,CACjF;AAAA,EAEJ;AAEA,MAAI,QAAQ,uBAAuB,SAAS;AAE5C,MAAI,MAAM,WAAW,GAAG;AACtB,WACE,oBAAC,SAAI,WAAU,qBACb,8BAAC,KAAA,EAAE,WAAU,yDAAwD,UAAA,aAAA,CAAU,EAAA,CACjF;AAAA,EAEJ;AAGA,UAAQ,mBAAmB,KAAK;AAEhC,MAAI,MAAM,WAAW,GAAG;AACtB,WACE,oBAAC,SAAI,WAAU,qBACb,8BAAC,KAAA,EAAE,WAAU,yDAAwD,UAAA,aAAA,CAAU,EAAA,CACjF;AAAA,EAEJ;AAGA,UAAQ,MAAM,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAEzD,6BACG,OAAA,EAAI,WAAU,uBACZ,UAAA,MAAM,IAAI,CAAC,SAAS;AACnB,UAAM,cAAc,eAAe,IAAI;AACvC,UAAM,SAAS,2CAAa,UAAoB,WAAW,KAAK,IAAI;AACpE,UAAM,cAAc,2CAAa;AACjC,UAAM,QAAO,2CAAa,QAAO,IAAI,KAAK,YAAY,IAAc,IAAI;AACxE,UAAM,WAAW,YAAY,IAAI;AACjC,UAAM,WAAW,SAAS,SAAS,YAAY,KAAK,SAAS,SAAS,aAAa;AAEnF,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QAEC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,MALK,KAAK;AAAA,IAAA;AAAA,EAQhB,CAAC,EAAA,CACH;AAEJ;"}
+{"version":3,"file":"post-list.js","sources":["../../../src/components/post-list.tsx"],"sourcesContent":["import { useParams } from \"react-router-dom\";\nimport {\n  type PostEntry,\n  directoryToPostEntries,\n  filterVisiblePosts,\n  getFrontmatter,\n} from \"@/lib/content-classification\";\nimport { useDirectory } from \"../../plugin/src/client\";\nimport { ErrorDisplay } from \"./page-error\";\nimport Loading from \"./loading\";\nimport { PostListItem } from \"./post-list-item\";\nimport veslxConfig from \"virtual:veslx-config\";\n\n// Helper to format name for display (e.g., \"01-getting-started\" → \"Getting Started\")\nfunction formatName(name: string): string {\n  return name\n    .replace(/^\\d+-/, '')\n    .replace(/-/g, ' ')\n    .replace(/\\b\\w/g, c => c.toUpperCase());\n}\n\n// Helper to get link path from post\nfunction getLinkPath(post: PostEntry): string {\n  if (post.file) {\n    // Standalone MDX file\n    return `/${post.file.path}`;\n  } else if (post.slides && !post.readme) {\n    // Folder with only slides\n    return `/${post.slides.path}`;\n  } else if (post.readme) {\n    // Folder with readme\n    return `/${post.readme.path}`;\n  } else {\n    // Fallback to folder path\n    return `/${post.path}`;\n  }\n}\n\nexport function PostList() {\n  const { \"*\": path = \".\" } = useParams();\n\n  const { directory, loading, error } = useDirectory(path)\n\n  if (error) {\n    return <ErrorDisplay error={error} path={path} />;\n  }\n\n  if (loading) {\n    return (\n      <Loading />\n    )\n  }\n\n  if (!directory) {\n    return (\n      <div className=\"py-24 text-center\">\n        <p className=\"text-muted-foreground font-mono text-sm tracking-wide\">no entries</p>\n      </div>\n    );\n  }\n\n  let posts = directoryToPostEntries(directory);\n\n  if (posts.length === 0) {\n    return (\n      <div className=\"py-24 text-center\">\n        <p className=\"text-muted-foreground font-mono text-sm tracking-wide\">no entries</p>\n      </div>\n    );\n  }\n\n  // Filter out hidden and draft posts\n  posts = filterVisiblePosts(posts);\n\n  if (posts.length === 0) {\n    return (\n      <div className=\"py-24 text-center\">\n        <p className=\"text-muted-foreground font-mono text-sm tracking-wide\">no entries</p>\n      </div>\n    );\n  }\n\n  // Sort based on config\n  const sortMode = veslxConfig.posts?.sort ?? 'alpha';\n  if (sortMode === 'date') {\n    // Sort by date descending (newest first), posts without dates go to the end\n    posts = posts.sort((a, b) => {\n      const dateA = getFrontmatter(a)?.date;\n      const dateB = getFrontmatter(b)?.date;\n      if (!dateA && !dateB) return a.name.localeCompare(b.name);\n      if (!dateA) return 1;\n      if (!dateB) return -1;\n      return new Date(dateB as string).getTime() - new Date(dateA as string).getTime();\n    });\n  } else {\n    // Alphanumeric sorting by name\n    posts = posts.sort((a, b) => a.name.localeCompare(b.name));\n  }\n\n  return (\n    <div className=\"space-y-1 not-prose\">\n      {posts.map((post) => {\n        const frontmatter = getFrontmatter(post);\n        const title = (frontmatter?.title as string) || formatName(post.name);\n        const description = frontmatter?.description as string | undefined;\n        const date = frontmatter?.date ? new Date(frontmatter.date as string) : undefined;\n        const linkPath = getLinkPath(post);\n        const isSlides = linkPath.endsWith('SLIDES.mdx') || linkPath.endsWith('.slides.mdx');\n\n        return (\n          <PostListItem\n            key={post.path}\n            title={title}\n            description={description}\n            date={date}\n            linkPath={linkPath}\n            isSlides={isSlides}\n          />\n        );\n      })}\n    </div>\n  );\n}\n"],"names":["_a"],"mappings":";;;;;;;AAcA,SAAS,WAAW,MAAsB;AACxC,SAAO,KACJ,QAAQ,SAAS,EAAE,EACnB,QAAQ,MAAM,GAAG,EACjB,QAAQ,SAAS,CAAA,MAAK,EAAE,aAAa;AAC1C;AAGA,SAAS,YAAY,MAAyB;AAC5C,MAAI,KAAK,MAAM;AAEb,WAAO,IAAI,KAAK,KAAK,IAAI;AAAA,EAC3B,WAAW,KAAK,UAAU,CAAC,KAAK,QAAQ;AAEtC,WAAO,IAAI,KAAK,OAAO,IAAI;AAAA,EAC7B,WAAW,KAAK,QAAQ;AAEtB,WAAO,IAAI,KAAK,OAAO,IAAI;AAAA,EAC7B,OAAO;AAEL,WAAO,IAAI,KAAK,IAAI;AAAA,EACtB;AACF;AAEO,SAAS,WAAW;;AACzB,QAAM,EAAE,KAAK,OAAO,IAAA,IAAQ,UAAA;AAE5B,QAAM,EAAE,WAAoB,UAAU,aAAa,IAAI;AAEvD,MAAI,OAAO;AACT,WAAO,oBAAC,cAAA,EAAa,OAAc,KAAA,CAAY;AAAA,EACjD;AAQA,MAAI,CAAC,WAAW;AACd,WACE,oBAAC,SAAI,WAAU,qBACb,8BAAC,KAAA,EAAE,WAAU,yDAAwD,UAAA,aAAA,CAAU,EAAA,CACjF;AAAA,EAEJ;AAEA,MAAI,QAAQ,uBAAuB,SAAS;AAE5C,MAAI,MAAM,WAAW,GAAG;AACtB,WACE,oBAAC,SAAI,WAAU,qBACb,8BAAC,KAAA,EAAE,WAAU,yDAAwD,UAAA,aAAA,CAAU,EAAA,CACjF;AAAA,EAEJ;AAGA,UAAQ,mBAAmB,KAAK;AAEhC,MAAI,MAAM,WAAW,GAAG;AACtB,WACE,oBAAC,SAAI,WAAU,qBACb,8BAAC,KAAA,EAAE,WAAU,yDAAwD,UAAA,aAAA,CAAU,EAAA,CACjF;AAAA,EAEJ;AAGA,QAAM,aAAW,iBAAY,UAAZ,mBAAmB,SAAQ;AAC5C,MAAI,aAAa,QAAQ;AAEvB,YAAQ,MAAM,KAAK,CAAC,GAAG,MAAM;;AAC3B,YAAM,SAAQA,MAAA,eAAe,CAAC,MAAhB,gBAAAA,IAAmB;AACjC,YAAM,SAAQ,oBAAe,CAAC,MAAhB,mBAAmB;AACjC,UAAI,CAAC,SAAS,CAAC,cAAc,EAAE,KAAK,cAAc,EAAE,IAAI;AACxD,UAAI,CAAC,MAAO,QAAO;AACnB,UAAI,CAAC,MAAO,QAAO;AACnB,aAAO,IAAI,KAAK,KAAe,EAAE,QAAA,IAAY,IAAI,KAAK,KAAe,EAAE,QAAA;AAAA,IACzE,CAAC;AAAA,EACH,OAAO;AAEL,YAAQ,MAAM,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAAA,EAC3D;AAEA,6BACG,OAAA,EAAI,WAAU,uBACZ,UAAA,MAAM,IAAI,CAAC,SAAS;AACnB,UAAM,cAAc,eAAe,IAAI;AACvC,UAAM,SAAS,2CAAa,UAAoB,WAAW,KAAK,IAAI;AACpE,UAAM,cAAc,2CAAa;AACjC,UAAM,QAAO,2CAAa,QAAO,IAAI,KAAK,YAAY,IAAc,IAAI;AACxE,UAAM,WAAW,YAAY,IAAI;AACjC,UAAM,WAAW,SAAS,SAAS,YAAY,KAAK,SAAS,SAAS,aAAa;AAEnF,WACE;AAAA,MAAC;AAAA,MAAA;AAAA,QAEC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAAA,MALK,KAAK;AAAA,IAAA;AAAA,EAQhB,CAAC,EAAA,CACH;AAEJ;"}

package/dist/client/pages/home.js

@@ -12,9 +12,19 @@ function Home() {
     /* @__PURE__ */ jsxs("main", { className: "flex-1 mx-auto w-full max-w-[var(--content-width)] px-[var(--page-padding)]", children: [
       /* @__PURE__ */ jsx("title", { children: isRoot ? config.name : `${config.name} - ${path}` }),
       /* @__PURE__ */ jsxs("main", { className: "flex flex-col gap-8 mb-32 mt-12", children: [
-        isRoot && /* @__PURE__ */ jsxs("div", { className: "animate-fade-in", children: [
-          /* @__PURE__ */ jsx("h1", { className: "text-2xl md:text-3xl font-semibold tracking-tight text-foreground", children: config.name }),
-          config.description && /* @__PURE__ */ jsx("p", { className: "mt-2 text-muted-foreground", children: config.description })
+        isRoot && /* @__PURE__ */ jsxs("div", { className: "animate-fade-in flex items-start justify-between gap-4", children: [
+          /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsx("h1", { className: "text-2xl md:text-3xl font-semibold tracking-tight text-foreground", children: config.name }),
+            config.description && /* @__PURE__ */ jsx("p", { className: "mt-2 text-muted-foreground", children: config.description })
+          ] }),
+          config.llmsTxt && /* @__PURE__ */ jsx(
+            "a",
+            {
+              href: "/llms-full.txt",
+              className: "font-mono text-xs text-muted-foreground/70 hover:text-foreground underline underline-offset-2 transition-colors shrink-0",
+              children: "llms.txt"
+            }
+          )
         ] }),
         /* @__PURE__ */ jsx("div", { className: "flex flex-col gap-2", children: /* @__PURE__ */ jsx("div", { className: "animate-fade-in", children: /* @__PURE__ */ jsx(PostList, {}) }) })
       ] })

package/dist/client/pages/home.js.map

@@ -1 +1 @@
-{"version":3,"file":"home.js","sources":["../../../src/pages/home.tsx"],"sourcesContent":["import { useParams } from \"react-router-dom\"\nimport { PostList } from \"@/components/post-list\";\nimport { Header } from \"@/components/header\";\nimport veslxConfig from \"virtual:veslx-config\";\n\nexport function Home() {\n  const { \"*\": path = \".\" } = useParams();\n  const config = veslxConfig.site;\n\n  const isRoot = path === \".\" || path === \"\";\n\n  return (\n    <div className=\"flex min-h-screen flex-col bg-background noise-overlay\">\n      <Header />\n      <main className=\"flex-1 mx-auto w-full max-w-[var(--content-width)] px-[var(--page-padding)]\">\n        <title>{isRoot ? config.name : `${config.name} - ${path}`}</title>\n        <main className=\"flex flex-col gap-8 mb-32 mt-12\">\n          {isRoot && (\n            <div className=\"animate-fade-in\">\n              <h1 className=\"text-2xl md:text-3xl font-semibold tracking-tight text-foreground\">\n                {config.name}\n              </h1>\n              {config.description && (\n                <p className=\"mt-2 text-muted-foreground\">\n                  {config.description}\n                </p>\n              )}\n            </div>\n          )}\n\n          <div className=\"flex flex-col gap-2\">\n            <div className=\"animate-fade-in\">\n              <PostList />\n            </div>\n          </div>\n        </main>\n      </main>\n    </div>\n  )\n}\n"],"names":[],"mappings":";;;;;AAKO,SAAS,OAAO;AACrB,QAAM,EAAE,KAAK,OAAO,IAAA,IAAQ,UAAA;AAC5B,QAAM,SAAS,YAAY;AAE3B,QAAM,SAAS,SAAS,OAAO,SAAS;AAExC,SACE,qBAAC,OAAA,EAAI,WAAU,0DACb,UAAA;AAAA,IAAA,oBAAC,QAAA,EAAO;AAAA,IACR,qBAAC,QAAA,EAAK,WAAU,+EACd,UAAA;AAAA,MAAA,oBAAC,SAAA,EAAO,mBAAS,OAAO,OAAO,GAAG,OAAO,IAAI,MAAM,IAAI,GAAA,CAAG;AAAA,MAC1D,qBAAC,QAAA,EAAK,WAAU,mCACb,UAAA;AAAA,QAAA,UACC,qBAAC,OAAA,EAAI,WAAU,mBACb,UAAA;AAAA,UAAA,oBAAC,MAAA,EAAG,WAAU,qEACX,UAAA,OAAO,MACV;AAAA,UACC,OAAO,eACN,oBAAC,OAAE,WAAU,8BACV,iBAAO,YAAA,CACV;AAAA,QAAA,GAEJ;AAAA,QAGF,oBAAC,OAAA,EAAI,WAAU,uBACb,UAAA,oBAAC,OAAA,EAAI,WAAU,mBACb,UAAA,oBAAC,UAAA,CAAA,CAAS,EAAA,CACZ,EAAA,CACF;AAAA,MAAA,EAAA,CACF;AAAA,IAAA,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;"}
+{"version":3,"file":"home.js","sources":["../../../src/pages/home.tsx"],"sourcesContent":["import { useParams } from \"react-router-dom\"\nimport { PostList } from \"@/components/post-list\";\nimport { Header } from \"@/components/header\";\nimport veslxConfig from \"virtual:veslx-config\";\n\nexport function Home() {\n  const { \"*\": path = \".\" } = useParams();\n  const config = veslxConfig.site;\n\n  const isRoot = path === \".\" || path === \"\";\n\n  return (\n    <div className=\"flex min-h-screen flex-col bg-background noise-overlay\">\n      <Header />\n      <main className=\"flex-1 mx-auto w-full max-w-[var(--content-width)] px-[var(--page-padding)]\">\n        <title>{isRoot ? config.name : `${config.name} - ${path}`}</title>\n        <main className=\"flex flex-col gap-8 mb-32 mt-12\">\n          {isRoot && (\n            <div className=\"animate-fade-in flex items-start justify-between gap-4\">\n              <div>\n                <h1 className=\"text-2xl md:text-3xl font-semibold tracking-tight text-foreground\">\n                  {config.name}\n                </h1>\n                {config.description && (\n                  <p className=\"mt-2 text-muted-foreground\">\n                    {config.description}\n                  </p>\n                )}\n              </div>\n              {config.llmsTxt && (\n                <a\n                  href=\"/llms-full.txt\"\n                  className=\"font-mono text-xs text-muted-foreground/70 hover:text-foreground underline underline-offset-2 transition-colors shrink-0\"\n                >\n                  llms.txt\n                </a>\n              )}\n            </div>\n          )}\n\n          <div className=\"flex flex-col gap-2\">\n            <div className=\"animate-fade-in\">\n              <PostList />\n            </div>\n          </div>\n        </main>\n      </main>\n    </div>\n  )\n}\n"],"names":[],"mappings":";;;;;AAKO,SAAS,OAAO;AACrB,QAAM,EAAE,KAAK,OAAO,IAAA,IAAQ,UAAA;AAC5B,QAAM,SAAS,YAAY;AAE3B,QAAM,SAAS,SAAS,OAAO,SAAS;AAExC,SACE,qBAAC,OAAA,EAAI,WAAU,0DACb,UAAA;AAAA,IAAA,oBAAC,QAAA,EAAO;AAAA,IACR,qBAAC,QAAA,EAAK,WAAU,+EACd,UAAA;AAAA,MAAA,oBAAC,SAAA,EAAO,mBAAS,OAAO,OAAO,GAAG,OAAO,IAAI,MAAM,IAAI,GAAA,CAAG;AAAA,MAC1D,qBAAC,QAAA,EAAK,WAAU,mCACb,UAAA;AAAA,QAAA,UACC,qBAAC,OAAA,EAAI,WAAU,0DACb,UAAA;AAAA,UAAA,qBAAC,OAAA,EACC,UAAA;AAAA,YAAA,oBAAC,MAAA,EAAG,WAAU,qEACX,UAAA,OAAO,MACV;AAAA,YACC,OAAO,eACN,oBAAC,OAAE,WAAU,8BACV,iBAAO,YAAA,CACV;AAAA,UAAA,GAEJ;AAAA,UACC,OAAO,WACN;AAAA,YAAC;AAAA,YAAA;AAAA,cACC,MAAK;AAAA,cACL,WAAU;AAAA,cACX,UAAA;AAAA,YAAA;AAAA,UAAA;AAAA,QAED,GAEJ;AAAA,QAGF,oBAAC,OAAA,EAAI,WAAU,uBACb,UAAA,oBAAC,OAAA,EAAI,WAAU,mBACb,UAAA,oBAAC,UAAA,CAAA,CAAS,EAAA,CACZ,EAAA,CACF;AAAA,MAAA,EAAA,CACF;AAAA,IAAA,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veslx",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "type": "module",
   "repository": {
     "type": "git",

package/plugin/src/plugin.ts

@@ -3,7 +3,7 @@ import path from 'path'
 import fs from 'fs'
 import yaml from 'js-yaml'
 import type { IncomingMessage, ServerResponse } from 'http'
-import { type VeslxConfig, type ResolvedSiteConfig, type ResolvedSlidesConfig, type ResolvedConfig, DEFAULT_SITE_CONFIG, DEFAULT_SLIDES_CONFIG } from './types'
+import { type VeslxConfig, type ResolvedSiteConfig, type ResolvedSlidesConfig, type ResolvedPostsConfig, type ResolvedConfig, DEFAULT_SITE_CONFIG, DEFAULT_SLIDES_CONFIG, DEFAULT_POSTS_CONFIG } from './types'
 import matter from 'gray-matter'
 
 /**
@@ -100,6 +100,11 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
     ...config?.slides,
   }
 
+  let postsConfig: ResolvedPostsConfig = {
+    ...DEFAULT_POSTS_CONFIG,
+    ...config?.posts,
+  }
+
   // Helper to reload config from file
   function reloadConfig(): boolean {
     if (!configPath || !fs.existsSync(configPath)) return false
@@ -114,6 +119,10 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
         ...DEFAULT_SLIDES_CONFIG,
         ...parsed?.slides,
       }
+      postsConfig = {
+        ...DEFAULT_POSTS_CONFIG,
+        ...parsed?.posts,
+      }
       return true
     } catch (e) {
       console.error('[veslx] Failed to reload config:', e)
@@ -126,8 +135,8 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
 
   urlToDir.set('/raw', dir)
 
-  // Generate llms.txt content dynamically
-  function generateLlmsTxt(): string {
+  // Get sorted entries for llms.txt generation
+  function getLlmsEntries() {
     const frontmatters = extractFrontmatters(dir)
     const entries: { path: string; title?: string; description?: string; date?: string; isSlides: boolean }[] = []
 
@@ -143,50 +152,100 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
       })
     }
 
-    entries.sort((a, b) => {
-      if (a.date && b.date) return b.date.localeCompare(a.date)
-      if (a.date) return -1
-      if (b.date) return 1
-      return a.path.localeCompare(b.path)
-    })
+    // Sort alphanumerically by path (0-foo before 1-bar before 10-baz)
+    entries.sort((a, b) => a.path.localeCompare(b.path, undefined, { numeric: true }))
+
+    return entries
+  }
+
+  // Generate llms.txt index (links to articles)
+  function generateLlmsTxt(): string {
+    const entries = getLlmsEntries()
 
     const lines: string[] = [`# ${siteConfig.name}`]
     if (siteConfig.description) {
-      lines.push(siteConfig.description)
+      lines.push(`> ${siteConfig.description}`)
     }
     lines.push('')
 
     // Links section
     if (siteConfig.homepage) {
-      lines.push(`Homepage: ${siteConfig.homepage}`)
+      lines.push(`- Homepage: ${siteConfig.homepage}`)
     }
     if (siteConfig.github) {
-      lines.push(`GitHub: https://github.com/${siteConfig.github}`)
+      lines.push(`- GitHub: https://github.com/${siteConfig.github}`)
     }
-    lines.push('Install: bun install -g veslx')
     lines.push('')
 
-    lines.push('Content is served as raw MDX files at /raw/{path}.')
+    lines.push('## Documentation')
     lines.push('')
 
     for (const entry of entries) {
-      const type = entry.isSlides ? '[slides]' : entry.date ? '[post]' : '[doc]'
       const title = entry.title || entry.path.replace(/\.mdx?$/, '').split('/').pop()
-      const desc = entry.description ? ` - ${entry.description}` : ''
-      lines.push(`${type} ${title}: /raw/${entry.path}${desc}`)
+      const desc = entry.description ? `: ${entry.description}` : ''
+      lines.push(`- [${title}](/raw/${entry.path})${desc}`)
     }
     lines.push('')
     return lines.join('\n')
   }
 
+  // Generate llms-full.txt with all article content inline
+  function generateLlmsFullTxt(): string {
+    const entries = getLlmsEntries()
+
+    const lines: string[] = [`# ${siteConfig.name}`]
+    if (siteConfig.description) {
+      lines.push(`> ${siteConfig.description}`)
+    }
+    lines.push('')
+
+    for (const entry of entries) {
+      const filePath = path.join(dir, entry.path)
+      if (!fs.existsSync(filePath)) continue
+
+      try {
+        const content = fs.readFileSync(filePath, 'utf-8')
+        // Remove frontmatter and JSX components
+        const contentWithoutFrontmatter = content
+          .replace(/^---[\s\S]*?---\n*/, '')
+          .replace(/<[A-Z][a-zA-Z]*\s*\/>/g, '') // Self-closing JSX like <FrontMatter />
+          .replace(/<[A-Z][a-zA-Z]*[^>]*>[\s\S]*?<\/[A-Z][a-zA-Z]*>/g, '') // JSX with children
+          .replace(/\n{3,}/g, '\n\n') // Collapse multiple newlines
+
+        const title = entry.title || entry.path.replace(/\.mdx?$/, '').split('/').pop()
+
+        lines.push('---')
+        lines.push('')
+        lines.push(`## ${title}`)
+        if (entry.description) {
+          lines.push(`> ${entry.description}`)
+        }
+        lines.push('')
+        lines.push(contentWithoutFrontmatter.trim())
+        lines.push('')
+      } catch {
+        // Skip files that can't be read
+      }
+    }
+
+    return lines.join('\n')
+  }
+
   const middleware: Connect.NextHandleFunction = (req: IncomingMessage, res: ServerResponse, next: Connect.NextFunction) => {
-    // Serve llms.txt dynamically
-    if (req.url === '/llms.txt') {
+    // Serve llms.txt dynamically (only if enabled)
+    if (req.url === '/llms.txt' && siteConfig.llmsTxt) {
       res.setHeader('Content-Type', 'text/plain')
       res.end(generateLlmsTxt())
       return
     }
 
+    // Serve llms-full.txt with all content inline (only if enabled)
+    if (req.url === '/llms-full.txt' && siteConfig.llmsTxt) {
+      res.setHeader('Content-Type', 'text/plain')
+      res.end(generateLlmsFullTxt())
+      return
+    }
+
     // Check if URL matches any registered content directory
     for (const [urlBase, contentDir] of urlToDir.entries()) {
       if (req.url?.startsWith(urlBase + '/')) {
@@ -222,11 +281,15 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
     next()
   }
 
+  // Virtual module ID for the modified CSS
+  const VIRTUAL_CSS_MODULE = '\0veslx:index.css'
+
   return {
     name: 'content',
+    enforce: 'pre',
 
     // Inject @content alias and fs.allow into Vite config
-    config() {
+    config(config, { command }) {
       return {
         resolve: {
           alias: {
@@ -244,8 +307,18 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
       }
     },
 
-    // Virtual modules for content MDX imports and site config
-    resolveId(id) {
+    // Intercept CSS and virtual module imports
+    resolveId(id, importer) {
+      // Intercept index.css imported from main.tsx and redirect to our virtual module
+      // This allows us to inject @source directive for Tailwind to scan user content
+      if (id === './index.css' && importer?.endsWith('/src/main.tsx')) {
+        return VIRTUAL_CSS_MODULE
+      }
+      // Also catch the resolved path
+      if (id.endsWith('/src/index.css') && !id.startsWith('\0')) {
+        return VIRTUAL_CSS_MODULE
+      }
+      // Virtual modules for content
       if (id === VIRTUAL_MODULE_ID) {
         return RESOLVED_VIRTUAL_MODULE_ID
       }
@@ -255,6 +328,28 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
     },
 
     load(id) {
+      // Serve the modified CSS content with @source directive
+      // This enables Tailwind v4 to scan the user's content directory for classes
+      if (id === VIRTUAL_CSS_MODULE) {
+        // Read the original CSS
+        const veslxRoot = path.dirname(path.dirname(__dirname))
+        const cssPath = path.join(veslxRoot, 'src/index.css')
+        const cssContent = fs.readFileSync(cssPath, 'utf-8')
+
+        // Use absolute path for @source directive
+        const absoluteContentDir = dir.replace(/\\/g, '/')
+
+        // Inject @source directive after the tailwindcss import
+        const sourceDirective = `@source "${absoluteContentDir}";`
+        const modified = cssContent.replace(
+          /(@import\s+["']tailwindcss["'];?)/,
+          `$1\n${sourceDirective}`
+        )
+
+        return modified
+      }
+
+      // Virtual module for content
       if (id === RESOLVED_VIRTUAL_MODULE_ID) {
         // Extract frontmatter from MDX files at build time (avoids MDX hook issues)
         const frontmatterData = extractFrontmatters(dir);
@@ -294,7 +389,7 @@ export const modules = import.meta.glob(['@content/**/*.mdx', '@content/**/*.md'
       }
       if (id === RESOLVED_VIRTUAL_CONFIG_ID) {
         // Generate virtual module with full config
-        const fullConfig: ResolvedConfig = { site: siteConfig, slides: slidesConfig }
+        const fullConfig: ResolvedConfig = { site: siteConfig, slides: slidesConfig, posts: postsConfig }
         return `export default ${JSON.stringify(fullConfig)};`
       }
     },
@@ -340,10 +435,16 @@ export const modules = import.meta.glob(['@content/**/*.mdx', '@content/**/*.md'
         copyDirSync(dir, destDir)
         console.log(`Content copied successfully`)
 
-        // Generate llms.txt for CLI tools and LLMs
-        const llmsTxtPath = path.join(outDir, 'llms.txt')
-        fs.writeFileSync(llmsTxtPath, generateLlmsTxt())
-        console.log(`Generated llms.txt`)
+        // Generate llms.txt files if enabled
+        if (siteConfig.llmsTxt) {
+          const llmsTxtPath = path.join(outDir, 'llms.txt')
+          fs.writeFileSync(llmsTxtPath, generateLlmsTxt())
+          console.log(`Generated llms.txt`)
+
+          const llmsFullTxtPath = path.join(outDir, 'llms-full.txt')
+          fs.writeFileSync(llmsFullTxtPath, generateLlmsFullTxt())
+          console.log(`Generated llms-full.txt`)
+        }
       } else {
         console.warn(`Content directory not found: ${dir}`)
       }

package/plugin/src/types.ts

@@ -2,33 +2,45 @@ export interface SlidesConfig {
   scrollSnap?: boolean;
 }
 
+export interface PostsConfig {
+  sort?: 'date' | 'alpha';
+}
+
 export interface SiteConfig {
   name?: string;
   description?: string;
   github?: string;
   homepage?: string;
+  llmsTxt?: boolean;
 }
 
 export interface VeslxConfig {
   dir?: string;
   site?: SiteConfig;
   slides?: SlidesConfig;
+  posts?: PostsConfig;
 }
 
 export interface ResolvedSlidesConfig {
   scrollSnap: boolean;
 }
 
+export interface ResolvedPostsConfig {
+  sort: 'date' | 'alpha';
+}
+
 export interface ResolvedSiteConfig {
   name: string;
   description: string;
   github: string;
   homepage: string;
+  llmsTxt: boolean;
 }
 
 export interface ResolvedConfig {
   site: ResolvedSiteConfig;
   slides: ResolvedSlidesConfig;
+  posts: ResolvedPostsConfig;
 }
 
 export const DEFAULT_SITE_CONFIG: ResolvedSiteConfig = {
@@ -36,8 +48,13 @@ export const DEFAULT_SITE_CONFIG: ResolvedSiteConfig = {
   description: '',
   github: '',
   homepage: '',
+  llmsTxt: false,
 };
 
 export const DEFAULT_SLIDES_CONFIG: ResolvedSlidesConfig = {
   scrollSnap: true,
 };
+
+export const DEFAULT_POSTS_CONFIG: ResolvedPostsConfig = {
+  sort: 'alpha',
+};

package/src/components/front-matter.tsx

@@ -1,8 +1,56 @@
+import { useLocation } from "react-router-dom";
 import { useFrontmatter } from "@/lib/frontmatter-context";
-import { formatDate } from "@/lib/format-date"
+import { formatDate } from "@/lib/format-date";
+import veslxConfig from "virtual:veslx-config";
 
-export function FrontMatter(){
+/**
+ * Convert MDX content to llms.txt format.
+ */
+function convertToLlmsTxt(
+  rawMdx: string,
+  frontmatter?: { title?: string; description?: string }
+): string {
+  const contentWithoutFrontmatter = rawMdx.replace(/^---[\s\S]*?---\n*/, '')
+
+  const parts: string[] = []
+
+  const title = frontmatter?.title || 'Untitled'
+  parts.push(`# ${title}`)
+
+  if (frontmatter?.description) {
+    parts.push('')
+    parts.push(`> ${frontmatter.description}`)
+  }
+
+  if (contentWithoutFrontmatter.trim()) {
+    parts.push('')
+    parts.push(contentWithoutFrontmatter.trim())
+  }
+
+  return parts.join('\n')
+}
+
+export function FrontMatter() {
   const frontmatter = useFrontmatter();
+  const location = useLocation();
+  const config = veslxConfig.site;
+
+  const rawUrl = `/raw${location.pathname.replace(/^\//, '/')}`;
+
+  const handleLlmsTxt = async (e: React.MouseEvent) => {
+    e.preventDefault();
+    try {
+      const res = await fetch(rawUrl);
+      if (!res.ok) throw new Error('Failed to fetch');
+      const rawMdx = await res.text();
+      const llmsTxt = convertToLlmsTxt(rawMdx, frontmatter);
+      const blob = new Blob([llmsTxt], { type: 'text/plain' });
+      const url = URL.createObjectURL(blob);
+      window.location.href = url;
+    } catch {
+      console.error('Failed to load llms.txt');
+    }
+  };
 
   return (
     <div>
@@ -19,6 +67,15 @@ export function FrontMatter(){
                 {formatDate(new Date(frontmatter.date as string))}
               </time>
             )}
+            {config.llmsTxt && (
+              <a
+                href="#"
+                onClick={handleLlmsTxt}
+                className="font-mono text-xs text-muted-foreground/70 hover:text-foreground underline underline-offset-2 transition-colors"
+              >
+                llms.txt
+              </a>
+            )}
           </div>
 
           {frontmatter?.description && (
@@ -29,5 +86,5 @@ export function FrontMatter(){
         </header>
       )}
     </div>
-  )
+  );
 }

package/src/components/post-list.tsx

@@ -9,6 +9,7 @@ import { useDirectory } from "../../plugin/src/client";
 import { ErrorDisplay } from "./page-error";
 import Loading from "./loading";
 import { PostListItem } from "./post-list-item";
+import veslxConfig from "virtual:veslx-config";
 
 // Helper to format name for display (e.g., "01-getting-started" → "Getting Started")
 function formatName(name: string): string {
@@ -79,8 +80,22 @@ export function PostList() {
     );
   }
 
-  // Alphanumeric sorting by name
-  posts = posts.sort((a, b) => a.name.localeCompare(b.name));
+  // Sort based on config
+  const sortMode = veslxConfig.posts?.sort ?? 'alpha';
+  if (sortMode === 'date') {
+    // Sort by date descending (newest first), posts without dates go to the end
+    posts = posts.sort((a, b) => {
+      const dateA = getFrontmatter(a)?.date;
+      const dateB = getFrontmatter(b)?.date;
+      if (!dateA && !dateB) return a.name.localeCompare(b.name);
+      if (!dateA) return 1;
+      if (!dateB) return -1;
+      return new Date(dateB as string).getTime() - new Date(dateA as string).getTime();
+    });
+  } else {
+    // Alphanumeric sorting by name
+    posts = posts.sort((a, b) => a.name.localeCompare(b.name));
+  }
 
   return (
     <div className="space-y-1 not-prose">

package/src/index.css

@@ -209,6 +209,11 @@
     letter-spacing: 0;
   }
 
+  /* Code inside pre blocks should inherit background from pre */
+  pre code {
+    background: transparent;
+  }
+
   /* Scrollbar styling */
   ::-webkit-scrollbar {
     width: 8px;

package/src/pages/home.tsx

@@ -16,14 +16,24 @@ export function Home() {
         <title>{isRoot ? config.name : `${config.name} - ${path}`}</title>
         <main className="flex flex-col gap-8 mb-32 mt-12">
           {isRoot && (
-            <div className="animate-fade-in">
-              <h1 className="text-2xl md:text-3xl font-semibold tracking-tight text-foreground">
-                {config.name}
-              </h1>
-              {config.description && (
-                <p className="mt-2 text-muted-foreground">
-                  {config.description}
-                </p>
+            <div className="animate-fade-in flex items-start justify-between gap-4">
+              <div>
+                <h1 className="text-2xl md:text-3xl font-semibold tracking-tight text-foreground">
+                  {config.name}
+                </h1>
+                {config.description && (
+                  <p className="mt-2 text-muted-foreground">
+                    {config.description}
+                  </p>
+                )}
+              </div>
+              {config.llmsTxt && (
+                <a
+                  href="/llms-full.txt"
+                  className="font-mono text-xs text-muted-foreground/70 hover:text-foreground underline underline-offset-2 transition-colors shrink-0"
+                >
+                  llms.txt
+                </a>
               )}
             </div>
           )}