veslx 0.1.27 → 0.1.29

package/dist/client/pages/post.js

@@ -2,7 +2,6 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { useParams } from "react-router-dom";
 import { useDirectory, isSimulationRunning, findSlides } from "../plugin/src/client.js";
 import Loading from "../components/loading.js";
-import { RunningBar } from "../components/running-bar.js";
 import { Header } from "../components/header.js";
 import { useMDXContent } from "../hooks/use-mdx-content.js";
 import { mdxComponents } from "../components/mdx-components.js";
@@ -24,7 +23,6 @@ function Post() {
   }
   return /* @__PURE__ */ jsxs("div", { className: "flex min-h-screen flex-col bg-background noise-overlay", children: [
     /* @__PURE__ */ jsx("title", { children: frontmatter == null ? void 0 : frontmatter.title }),
-    /* @__PURE__ */ jsx(RunningBar, {}),
     /* @__PURE__ */ jsx(Header, {}),
     /* @__PURE__ */ jsxs("main", { className: "flex-1 w-full overflow-x-clip", children: [
       isRunning && /* @__PURE__ */ jsx("div", { className: "sticky top-0 z-50 px-[var(--page-padding)] py-2 bg-red-500 text-primary-foreground font-mono text-xs text-center tracking-wide", children: /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-3", children: [
@@ -32,7 +30,7 @@ function Post() {
         /* @__PURE__ */ jsx("span", { className: "uppercase tracking-widest", children: "simulation running" }),
         /* @__PURE__ */ jsx("span", { className: "text-primary-foreground/60", children: "Page will auto-refresh on completion" })
       ] }) }),
-      Content && /* @__PURE__ */ jsx(FrontmatterProvider, { frontmatter, children: /* @__PURE__ */ jsx("article", { className: "my-12 mx-auto px-[var(--page-padding)] prose dark:prose-invert prose-headings:tracking-tight prose-p:leading-relaxed prose-a:text-primary prose-a:no-underline hover:prose-a:underline max-w-[var(--content-width)] animate-fade-in", children: /* @__PURE__ */ jsx(Content, { components: mdxComponents }) }) })
+      Content && /* @__PURE__ */ jsx(FrontmatterProvider, { frontmatter, children: /* @__PURE__ */ jsx("article", { className: "mt-12 mb-64 mx-auto px-[var(--page-padding)] max-w-[var(--content-width)] animate-fade-in", children: /* @__PURE__ */ jsx(Content, { components: mdxComponents }) }) })
     ] })
   ] });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"post.js","sources":["../../../src/pages/post.tsx"],"sourcesContent":["import { useParams } from \"react-router-dom\";\nimport { findSlides, isSimulationRunning, useDirectory } from \"../../plugin/src/client\";\nimport Loading from \"@/components/loading\";\nimport { FileEntry } from \"plugin/src/lib\";\nimport { RunningBar } from \"@/components/running-bar\";\nimport { Header } from \"@/components/header\";\nimport { useMDXContent } from \"@/hooks/use-mdx-content\";\nimport { mdxComponents } from \"@/components/mdx-components\";\nimport { FrontmatterProvider } from \"@/lib/frontmatter-context\";\n\nexport function Post() {\n  const { \"*\": rawPath = \".\" } = useParams();\n\n  // The path includes the .mdx extension from the route\n  const mdxPath = rawPath;\n\n  // Extract directory path for finding sibling files (slides, etc.)\n  const dirPath = mdxPath.replace(/\\/[^/]+\\.mdx$/, '') || '.';\n\n  const { directory, loading: dirLoading } = useDirectory(dirPath)\n  const { Content, frontmatter, loading: mdxLoading, error } = useMDXContent(mdxPath);\n  const isRunning = isSimulationRunning();\n\n  let slides: FileEntry | null = null;\n  if (directory) {\n    slides = findSlides(directory);\n  }\n\n  const loading = dirLoading || mdxLoading;\n\n  if (loading) return <Loading />\n\n  if (error) {\n    return (\n      <main className=\"min-h-screen bg-background container mx-auto max-w-4xl py-12\">\n        <p className=\"text-center text-red-600\">{error.message}</p>\n      </main>\n    )\n  }\n\n  return (\n    <div className=\"flex min-h-screen flex-col bg-background noise-overlay\">\n      <title>{frontmatter?.title}</title>\n      <RunningBar />\n      <Header />\n      <main className=\"flex-1 w-full overflow-x-clip\">\n        {isRunning && (\n          <div className=\"sticky top-0 z-50 px-[var(--page-padding)] py-2 bg-red-500 text-primary-foreground font-mono text-xs text-center tracking-wide\">\n            <span className=\"inline-flex items-center gap-3\">\n              <span className=\"h-1.5 w-1.5 rounded-full bg-current animate-pulse\" />\n              <span className=\"uppercase tracking-widest\">simulation running</span>\n              <span className=\"text-primary-foreground/60\">Page will auto-refresh on completion</span>\n            </span>\n          </div>\n        )}\n\n        {Content && (\n          <FrontmatterProvider frontmatter={frontmatter}>\n            <article className=\"my-12 mx-auto px-[var(--page-padding)] prose dark:prose-invert prose-headings:tracking-tight prose-p:leading-relaxed prose-a:text-primary prose-a:no-underline hover:prose-a:underline max-w-[var(--content-width)] animate-fade-in\">\n              <Content components={mdxComponents} />\n            </article>\n          </FrontmatterProvider>\n        )}\n      </main>\n    </div>\n  )\n}\n"],"names":[],"mappings":";;;;;;;;;AAUO,SAAS,OAAO;AACrB,QAAM,EAAE,KAAK,UAAU,IAAA,IAAQ,UAAA;AAG/B,QAAM,UAAU;AAGhB,QAAM,UAAU,QAAQ,QAAQ,iBAAiB,EAAE,KAAK;AAExD,QAAM,EAAE,UAA+B,IAAI,aAAa,OAAO;AAC/D,QAAM,EAAE,SAAS,aAAa,SAAS,YAAY,MAAA,IAAU,cAAc,OAAO;AAClF,QAAM,YAAY,oBAAA;AAGlB,MAAI,WAAW;AACJ,eAAW,SAAS;AAAA,EAC/B;AAEA,QAAM,UAAwB;AAE9B,MAAI,QAAS,QAAO,oBAAC,SAAA,CAAA,CAAQ;AAE7B,MAAI,OAAO;AACT,WACE,oBAAC,QAAA,EAAK,WAAU,gEACd,UAAA,oBAAC,OAAE,WAAU,4BAA4B,UAAA,MAAM,QAAA,CAAQ,GACzD;AAAA,EAEJ;AAEA,SACE,qBAAC,OAAA,EAAI,WAAU,0DACb,UAAA;AAAA,IAAA,oBAAC,SAAA,EAAO,qDAAa,MAAA,CAAM;AAAA,wBAC1B,YAAA,EAAW;AAAA,wBACX,QAAA,EAAO;AAAA,IACR,qBAAC,QAAA,EAAK,WAAU,iCACb,UAAA;AAAA,MAAA,iCACE,OAAA,EAAI,WAAU,kIACb,UAAA,qBAAC,QAAA,EAAK,WAAU,kCACd,UAAA;AAAA,QAAA,oBAAC,QAAA,EAAK,WAAU,oDAAA,CAAoD;AAAA,QACpE,oBAAC,QAAA,EAAK,WAAU,6BAA4B,UAAA,sBAAkB;AAAA,QAC9D,oBAAC,QAAA,EAAK,WAAU,8BAA6B,UAAA,uCAAA,CAAoC;AAAA,MAAA,EAAA,CACnF,EAAA,CACF;AAAA,MAGD,WACC,oBAAC,qBAAA,EAAoB,aACnB,UAAA,oBAAC,WAAA,EAAQ,WAAU,uOACjB,UAAA,oBAAC,SAAA,EAAQ,YAAY,cAAA,CAAe,GACtC,EAAA,CACF;AAAA,IAAA,EAAA,CAEJ;AAAA,EAAA,GACF;AAEJ;"}
+{"version":3,"file":"post.js","sources":["../../../src/pages/post.tsx"],"sourcesContent":["import { useParams } from \"react-router-dom\";\nimport { findSlides, isSimulationRunning, useDirectory } from \"../../plugin/src/client\";\nimport Loading from \"@/components/loading\";\nimport { FileEntry } from \"plugin/src/lib\";\nimport { Header } from \"@/components/header\";\nimport { useMDXContent } from \"@/hooks/use-mdx-content\";\nimport { mdxComponents } from \"@/components/mdx-components\";\nimport { FrontmatterProvider } from \"@/lib/frontmatter-context\";\n\nexport function Post() {\n  const { \"*\": rawPath = \".\" } = useParams();\n\n  // The path includes the .mdx extension from the route\n  const mdxPath = rawPath;\n\n  // Extract directory path for finding sibling files (slides, etc.)\n  const dirPath = mdxPath.replace(/\\/[^/]+\\.mdx$/, '') || '.';\n\n  const { directory, loading: dirLoading } = useDirectory(dirPath)\n  const { Content, frontmatter, loading: mdxLoading, error } = useMDXContent(mdxPath);\n  const isRunning = isSimulationRunning();\n\n  let slides: FileEntry | null = null;\n  if (directory) {\n    slides = findSlides(directory);\n  }\n\n  const loading = dirLoading || mdxLoading;\n\n  if (loading) return <Loading />\n\n  if (error) {\n    return (\n      <main className=\"min-h-screen bg-background container mx-auto max-w-4xl py-12\">\n        <p className=\"text-center text-red-600\">{error.message}</p>\n      </main>\n    )\n  }\n\n  return (\n    <div className=\"flex min-h-screen flex-col bg-background noise-overlay\">\n      <title>{frontmatter?.title}</title>\n      <Header />\n      <main className=\"flex-1 w-full overflow-x-clip\">\n        {isRunning && (\n          <div className=\"sticky top-0 z-50 px-[var(--page-padding)] py-2 bg-red-500 text-primary-foreground font-mono text-xs text-center tracking-wide\">\n            <span className=\"inline-flex items-center gap-3\">\n              <span className=\"h-1.5 w-1.5 rounded-full bg-current animate-pulse\" />\n              <span className=\"uppercase tracking-widest\">simulation running</span>\n              <span className=\"text-primary-foreground/60\">Page will auto-refresh on completion</span>\n            </span>\n          </div>\n        )}\n\n        {Content && (\n          <FrontmatterProvider frontmatter={frontmatter}>\n            <article className=\"mt-12 mb-64 mx-auto px-[var(--page-padding)] max-w-[var(--content-width)] animate-fade-in\">\n              <Content components={mdxComponents} />\n            </article>\n          </FrontmatterProvider>\n        )}\n      </main>\n    </div>\n  )\n}\n"],"names":[],"mappings":";;;;;;;;AASO,SAAS,OAAO;AACrB,QAAM,EAAE,KAAK,UAAU,IAAA,IAAQ,UAAA;AAG/B,QAAM,UAAU;AAGhB,QAAM,UAAU,QAAQ,QAAQ,iBAAiB,EAAE,KAAK;AAExD,QAAM,EAAE,UAA+B,IAAI,aAAa,OAAO;AAC/D,QAAM,EAAE,SAAS,aAAa,SAAS,YAAY,MAAA,IAAU,cAAc,OAAO;AAClF,QAAM,YAAY,oBAAA;AAGlB,MAAI,WAAW;AACJ,eAAW,SAAS;AAAA,EAC/B;AAEA,QAAM,UAAwB;AAE9B,MAAI,QAAS,QAAO,oBAAC,SAAA,CAAA,CAAQ;AAE7B,MAAI,OAAO;AACT,WACE,oBAAC,QAAA,EAAK,WAAU,gEACd,UAAA,oBAAC,OAAE,WAAU,4BAA4B,UAAA,MAAM,QAAA,CAAQ,GACzD;AAAA,EAEJ;AAEA,SACE,qBAAC,OAAA,EAAI,WAAU,0DACb,UAAA;AAAA,IAAA,oBAAC,SAAA,EAAO,qDAAa,MAAA,CAAM;AAAA,wBAC1B,QAAA,EAAO;AAAA,IACR,qBAAC,QAAA,EAAK,WAAU,iCACb,UAAA;AAAA,MAAA,iCACE,OAAA,EAAI,WAAU,kIACb,UAAA,qBAAC,QAAA,EAAK,WAAU,kCACd,UAAA;AAAA,QAAA,oBAAC,QAAA,EAAK,WAAU,oDAAA,CAAoD;AAAA,QACpE,oBAAC,QAAA,EAAK,WAAU,6BAA4B,UAAA,sBAAkB;AAAA,QAC9D,oBAAC,QAAA,EAAK,WAAU,8BAA6B,UAAA,uCAAA,CAAoC;AAAA,MAAA,EAAA,CACnF,EAAA,CACF;AAAA,MAGD,WACC,oBAAC,qBAAA,EAAoB,aACnB,UAAA,oBAAC,WAAA,EAAQ,WAAU,6FACjB,UAAA,oBAAC,SAAA,EAAQ,YAAY,cAAA,CAAe,GACtC,EAAA,CACF;AAAA,IAAA,EAAA,CAEJ;AAAA,EAAA,GACF;AAEJ;"}

package/dist/client/pages/slides.js

@@ -3,11 +3,12 @@ import { useState, useRef, useEffect, useCallback } from "react";
 import { FULLSCREEN_DATA_ATTR } from "../lib/constants.js";
 import { useParams, useSearchParams } from "react-router-dom";
 import Loading from "../components/loading.js";
-import { RunningBar } from "../components/running-bar.js";
 import { Header } from "../components/header.js";
 import { useMDXSlides } from "../hooks/use-mdx-content.js";
 import { slidesMdxComponents } from "../components/slides-renderer.js";
 import { FrontmatterProvider } from "../lib/frontmatter-context.js";
+import veslxConfig from "virtual:veslx-config";
+import { cn } from "../lib/utils.js";
 function SlidesPage() {
   const { "*": rawPath = "." } = useParams();
   const [searchParams, setSearchParams] = useSearchParams();
@@ -87,9 +88,9 @@ function SlidesPage() {
   if (!Content) {
     return /* @__PURE__ */ jsx("div", { className: "flex items-center justify-center p-12 text-muted-foreground font-mono text-sm", children: 'no slides found — use "---" to separate slides' });
   }
-  return /* @__PURE__ */ jsxs("main", { className: "slides-container", children: [
+  const scrollSnap = veslxConfig.slides.scrollSnap;
+  return /* @__PURE__ */ jsxs("main", { className: cn("slides-container", scrollSnap && "slides-scroll-snap"), children: [
     /* @__PURE__ */ jsx("title", { children: frontmatter == null ? void 0 : frontmatter.title }),
-    /* @__PURE__ */ jsx(RunningBar, {}),
     /* @__PURE__ */ jsx(
       Header,
       {

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

@@ -1 +1 @@
-{"version":3,"file":"slides.js","sources":["../../../src/pages/slides.tsx"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { FULLSCREEN_DATA_ATTR } from \"@/lib/constants\";\nimport { useParams, useSearchParams } from \"react-router-dom\"\nimport Loading from \"@/components/loading\";\nimport { RunningBar } from \"@/components/running-bar\";\nimport { Header } from \"@/components/header\";\nimport { useMDXSlides } from \"@/hooks/use-mdx-content\";\nimport { slidesMdxComponents } from \"@/components/slides-renderer\";\nimport { FrontmatterProvider } from \"@/lib/frontmatter-context\";\n\n\nexport function SlidesPage() {\n  const { \"*\": rawPath = \".\" } = useParams();\n  const [searchParams, setSearchParams] = useSearchParams();\n\n  // The path includes the .mdx extension from the route\n  const mdxPath = rawPath;\n\n  // Load the compiled MDX module (now includes slideCount export)\n  const { Content, frontmatter, slideCount, loading, error } = useMDXSlides(mdxPath);\n\n  const totalSlides = slideCount || 0;\n\n  const [currentSlide, setCurrentSlide] = useState(0);\n  const titleSlideRef = useRef<HTMLDivElement>(null);\n  const contentRef = useRef<HTMLDivElement>(null);\n\n  // Scroll to slide on initial load if query param is set\n  useEffect(() => {\n    const slideParam = parseInt(searchParams.get(\"slide\") || \"0\", 10);\n    if (slideParam > 0 && contentRef.current) {\n      const slideEl = contentRef.current.querySelector(`[data-slide-index=\"${slideParam}\"]`);\n      if (slideEl) {\n        slideEl.scrollIntoView({ behavior: \"auto\" });\n      }\n    }\n  }, [searchParams, Content]);\n\n  // Track current slide based on scroll position\n  useEffect(() => {\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (entry.isIntersecting) {\n            const index = entry.target.getAttribute(\"data-slide-index\");\n            if (index !== null) {\n              const slideNum = index === \"title\" ? 0 : parseInt(index, 10);\n              setCurrentSlide(slideNum);\n              setSearchParams(slideNum > 0 ? { slide: String(slideNum) } : {}, { replace: true });\n            }\n          }\n        }\n      },\n      { threshold: 0.5 }\n    );\n\n    // Observe title slide\n    if (titleSlideRef.current) {\n      observer.observe(titleSlideRef.current);\n    }\n\n    // Observe content slides\n    if (contentRef.current) {\n      const slides = contentRef.current.querySelectorAll(\"[data-slide-index]\");\n      slides.forEach((slide) => observer.observe(slide));\n    }\n\n    return () => observer.disconnect();\n  }, [Content, setSearchParams]);\n\n  // Keyboard/scroll navigation helpers\n  const goToPrevious = useCallback(() => {\n    const prev = Math.max(0, currentSlide - 1);\n    if (contentRef.current) {\n      const slideEl = contentRef.current.querySelector(`[data-slide-index=\"${prev}\"]`);\n      slideEl?.scrollIntoView({ behavior: \"smooth\" });\n    }\n  }, [currentSlide]);\n\n  const goToNext = useCallback(() => {\n    const next = Math.min(totalSlides - 1, currentSlide + 1);\n    if (contentRef.current) {\n      const slideEl = contentRef.current.querySelector(`[data-slide-index=\"${next}\"]`);\n      slideEl?.scrollIntoView({ behavior: \"smooth\" });\n    }\n  }, [currentSlide, totalSlides]);\n\n  // Keyboard navigation (up/down only - left/right reserved for horizontal scrolling)\n  useEffect(() => {\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if (e.key === \"ArrowUp\") {\n        e.preventDefault();\n        goToPrevious();\n      } else if (e.key === \"ArrowDown\") {\n        e.preventDefault();\n        goToNext();\n      }\n    };\n\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => window.removeEventListener(\"keydown\", handleKeyDown);\n  }, [goToPrevious, goToNext]);\n\n  if (loading) {\n    return <Loading />\n  }\n\n  if (error) {\n    return (\n      <main className=\"min-h-screen bg-background container mx-auto max-w-4xl py-12\">\n        <p className=\"text-center text-red-600\">{error.message}</p>\n      </main>\n    )\n  }\n\n  if (!Content) {\n    return (\n      <div className=\"flex items-center justify-center p-12 text-muted-foreground font-mono text-sm\">\n        no slides found — use \"---\" to separate slides\n      </div>\n    );\n  }\n\n  return (\n    <main className=\"slides-container\">\n      <title>{frontmatter?.title}</title>\n      <RunningBar />\n      <Header\n        slideControls={{\n          current: currentSlide,\n          total: totalSlides,\n          onPrevious: goToPrevious,\n          onNext: goToNext,\n        }}\n      />\n      <FrontmatterProvider frontmatter={frontmatter}>\n        <div {...{[FULLSCREEN_DATA_ATTR]: \"true\"}}>\n          <div ref={contentRef}>\n            <Content components={slidesMdxComponents} />\n          </div>\n        </div>\n      </FrontmatterProvider>\n    </main>\n  )\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"slides.js","sources":["../../../src/pages/slides.tsx"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { FULLSCREEN_DATA_ATTR } from \"@/lib/constants\";\nimport { useParams, useSearchParams } from \"react-router-dom\"\nimport Loading from \"@/components/loading\";\nimport { Header } from \"@/components/header\";\nimport { useMDXSlides } from \"@/hooks/use-mdx-content\";\nimport { slidesMdxComponents } from \"@/components/slides-renderer\";\nimport { FrontmatterProvider } from \"@/lib/frontmatter-context\";\nimport veslxConfig from \"virtual:veslx-config\";\nimport { cn } from \"@/lib/utils\";\n\n\nexport function SlidesPage() {\n  const { \"*\": rawPath = \".\" } = useParams();\n  const [searchParams, setSearchParams] = useSearchParams();\n\n  // The path includes the .mdx extension from the route\n  const mdxPath = rawPath;\n\n  // Load the compiled MDX module (now includes slideCount export)\n  const { Content, frontmatter, slideCount, loading, error } = useMDXSlides(mdxPath);\n\n  const totalSlides = slideCount || 0;\n\n  const [currentSlide, setCurrentSlide] = useState(0);\n  const titleSlideRef = useRef<HTMLDivElement>(null);\n  const contentRef = useRef<HTMLDivElement>(null);\n\n  // Scroll to slide on initial load if query param is set\n  useEffect(() => {\n    const slideParam = parseInt(searchParams.get(\"slide\") || \"0\", 10);\n    if (slideParam > 0 && contentRef.current) {\n      const slideEl = contentRef.current.querySelector(`[data-slide-index=\"${slideParam}\"]`);\n      if (slideEl) {\n        slideEl.scrollIntoView({ behavior: \"auto\" });\n      }\n    }\n  }, [searchParams, Content]);\n\n  // Track current slide based on scroll position\n  useEffect(() => {\n    const observer = new IntersectionObserver(\n      (entries) => {\n        for (const entry of entries) {\n          if (entry.isIntersecting) {\n            const index = entry.target.getAttribute(\"data-slide-index\");\n            if (index !== null) {\n              const slideNum = index === \"title\" ? 0 : parseInt(index, 10);\n              setCurrentSlide(slideNum);\n              setSearchParams(slideNum > 0 ? { slide: String(slideNum) } : {}, { replace: true });\n            }\n          }\n        }\n      },\n      { threshold: 0.5 }\n    );\n\n    // Observe title slide\n    if (titleSlideRef.current) {\n      observer.observe(titleSlideRef.current);\n    }\n\n    // Observe content slides\n    if (contentRef.current) {\n      const slides = contentRef.current.querySelectorAll(\"[data-slide-index]\");\n      slides.forEach((slide) => observer.observe(slide));\n    }\n\n    return () => observer.disconnect();\n  }, [Content, setSearchParams]);\n\n  // Keyboard/scroll navigation helpers\n  const goToPrevious = useCallback(() => {\n    const prev = Math.max(0, currentSlide - 1);\n    if (contentRef.current) {\n      const slideEl = contentRef.current.querySelector(`[data-slide-index=\"${prev}\"]`);\n      slideEl?.scrollIntoView({ behavior: \"smooth\" });\n    }\n  }, [currentSlide]);\n\n  const goToNext = useCallback(() => {\n    const next = Math.min(totalSlides - 1, currentSlide + 1);\n    if (contentRef.current) {\n      const slideEl = contentRef.current.querySelector(`[data-slide-index=\"${next}\"]`);\n      slideEl?.scrollIntoView({ behavior: \"smooth\" });\n    }\n  }, [currentSlide, totalSlides]);\n\n  // Keyboard navigation (up/down only - left/right reserved for horizontal scrolling)\n  useEffect(() => {\n    const handleKeyDown = (e: KeyboardEvent) => {\n      if (e.key === \"ArrowUp\") {\n        e.preventDefault();\n        goToPrevious();\n      } else if (e.key === \"ArrowDown\") {\n        e.preventDefault();\n        goToNext();\n      }\n    };\n\n    window.addEventListener(\"keydown\", handleKeyDown);\n    return () => window.removeEventListener(\"keydown\", handleKeyDown);\n  }, [goToPrevious, goToNext]);\n\n  if (loading) {\n    return <Loading />\n  }\n\n  if (error) {\n    return (\n      <main className=\"min-h-screen bg-background container mx-auto max-w-4xl py-12\">\n        <p className=\"text-center text-red-600\">{error.message}</p>\n      </main>\n    )\n  }\n\n  if (!Content) {\n    return (\n      <div className=\"flex items-center justify-center p-12 text-muted-foreground font-mono text-sm\">\n        no slides found — use \"---\" to separate slides\n      </div>\n    );\n  }\n\n  const scrollSnap = veslxConfig.slides.scrollSnap;\n\n  return (\n    <main className={cn(\"slides-container\", scrollSnap && \"slides-scroll-snap\")}>\n      <title>{frontmatter?.title}</title>\n      <Header\n        slideControls={{\n          current: currentSlide,\n          total: totalSlides,\n          onPrevious: goToPrevious,\n          onNext: goToNext,\n        }}\n      />\n      <FrontmatterProvider frontmatter={frontmatter}>\n        <div {...{[FULLSCREEN_DATA_ATTR]: \"true\"}}>\n          <div ref={contentRef}>\n            <Content components={slidesMdxComponents} />\n          </div>\n        </div>\n      </FrontmatterProvider>\n    </main>\n  )\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veslx",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "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, DEFAULT_SITE_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'
 
 /**
@@ -89,12 +89,22 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
   const dir = contentDir
   const configPath = options?.configPath
 
-  // Mutable site config that can be updated on hot reload
+  // Mutable config that can be updated on hot reload
   let siteConfig: ResolvedSiteConfig = {
     ...DEFAULT_SITE_CONFIG,
     ...config?.site,
   }
 
+  let slidesConfig: ResolvedSlidesConfig = {
+    ...DEFAULT_SLIDES_CONFIG,
+    ...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
@@ -105,6 +115,14 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
         ...DEFAULT_SITE_CONFIG,
         ...parsed?.site,
       }
+      slidesConfig = {
+        ...DEFAULT_SLIDES_CONFIG,
+        ...parsed?.slides,
+      }
+      postsConfig = {
+        ...DEFAULT_POSTS_CONFIG,
+        ...parsed?.posts,
+      }
       return true
     } catch (e) {
       console.error('[veslx] Failed to reload config:', e)
@@ -117,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 }[] = []
 
@@ -134,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 + '/')) {
@@ -215,6 +283,28 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
 
   return {
     name: 'content',
+    enforce: 'pre',
+
+    // Inject @source directive for Tailwind to scan content directory for classes
+    transform(code, id) {
+      // Only process CSS files containing the tailwindcss import
+      if (!id.endsWith('.css')) return null
+      if (!code.includes('@import "tailwindcss"')) return null
+
+      // Calculate relative path from CSS file to content directory
+      const cssDir = path.dirname(id)
+      let relativeContentDir = path.relative(cssDir, dir)
+      relativeContentDir = relativeContentDir.replace(/\\/g, '/') // Windows compatibility
+
+      // Inject @source directive after the tailwindcss import
+      const sourceDirective = `@source "${relativeContentDir}";`
+      const modified = code.replace(
+        /(@import\s+["']tailwindcss["'];?)/,
+        `$1\n${sourceDirective}`
+      )
+
+      return { code: modified, map: null }
+    },
 
     // Inject @content alias and fs.allow into Vite config
     config() {
@@ -252,12 +342,12 @@ export default function contentPlugin(contentDir: string, config?: VeslxConfig,
 
         // Generate virtual module with import.meta.glob for MDX files
         return `
-export const posts = import.meta.glob('@content/**/*.mdx', {
+export const posts = import.meta.glob(['@content/**/*.mdx', '@content/**/*.md'], {
   import: 'default',
   query: { skipSlides: true }
 });
-export const allMdx = import.meta.glob('@content/**/*.mdx');
-export const slides = import.meta.glob(['@content/**/SLIDES.mdx', '@content/**/*.slides.mdx']);
+export const allMdx = import.meta.glob(['@content/**/*.mdx', '@content/**/*.md']);
+export const slides = import.meta.glob(['@content/**/SLIDES.mdx', '@content/**/SLIDES.md', '@content/**/*.slides.mdx', '@content/**/*.slides.md']);
 
 // All files for directory tree building (web-compatible files only)
 export const files = import.meta.glob([
@@ -280,12 +370,13 @@ export const files = import.meta.glob([
 export const frontmatters = ${JSON.stringify(frontmatterData)};
 
 // Legacy aliases for backwards compatibility
-export const modules = import.meta.glob('@content/**/*.mdx');
+export const modules = import.meta.glob(['@content/**/*.mdx', '@content/**/*.md']);
 `
       }
       if (id === RESOLVED_VIRTUAL_CONFIG_ID) {
-        // Generate virtual module with site config
-        return `export default ${JSON.stringify(siteConfig)};`
+        // Generate virtual module with full config
+        const fullConfig: ResolvedConfig = { site: siteConfig, slides: slidesConfig, posts: postsConfig }
+        return `export default ${JSON.stringify(fullConfig)};`
       }
     },
 
@@ -330,10 +421,16 @@ export const modules = import.meta.glob('@content/**/*.mdx');
         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

@@ -1,16 +1,32 @@
-export type ContentView = 'posts' | 'docs' | 'all';
+export interface SlidesConfig {
+  scrollSnap?: boolean;
+}
+
+export interface PostsConfig {
+  sort?: 'date' | 'alpha';
+}
 
 export interface SiteConfig {
   name?: string;
   description?: string;
   github?: string;
   homepage?: string;
-  defaultView?: ContentView;
+  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 {
@@ -18,7 +34,13 @@ export interface ResolvedSiteConfig {
   description: string;
   github: string;
   homepage: string;
-  defaultView: ContentView;
+  llmsTxt: boolean;
+}
+
+export interface ResolvedConfig {
+  site: ResolvedSiteConfig;
+  slides: ResolvedSlidesConfig;
+  posts: ResolvedPostsConfig;
 }
 
 export const DEFAULT_SITE_CONFIG: ResolvedSiteConfig = {
@@ -26,5 +48,13 @@ export const DEFAULT_SITE_CONFIG: ResolvedSiteConfig = {
   description: '',
   github: '',
   homepage: '',
-  defaultView: 'all',
+  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/header.tsx

@@ -2,7 +2,7 @@ import { Link, useParams } from "react-router-dom";
 import { ModeToggle } from "./mode-toggle";
 import { SiGithub } from "@icons-pack/react-simple-icons";
 import { ChevronUp, ChevronDown } from "lucide-react";
-import siteConfig from "virtual:veslx-config";
+import veslxConfig from "virtual:veslx-config";
 import { cn } from "@/lib/utils";
 
 interface HeaderProps {
@@ -15,7 +15,7 @@ interface HeaderProps {
 }
 
 export function Header({ slideControls }: HeaderProps = {}) {
-  const config = siteConfig;
+  const config = veslxConfig.site;
 
   const { "*": path } = useParams()
 
@@ -62,24 +62,6 @@ export function Header({ slideControls }: HeaderProps = {}) {
               </button>
             </>
           )}
-          <Link
-            to={`/posts`}
-            className={cn(
-              "font-medium text-muted-foreground/70 hover:text-foreground transition-colors duration-300",
-              path?.startsWith("posts") && "font-semibold text-foreground",
-            )}
-          >
-            Posts
-          </Link>
-          <Link
-            to={`/docs`}
-            className={cn(
-              "font-medium text-muted-foreground/70 hover:text-foreground transition-colors duration-300",
-              path?.startsWith("docs") && "font-semibold text-foreground",
-            )}
-          >
-            Docs
-          </Link>
           {config.github && (
             <Link
               to={`https://github.com/${config.github}`}

package/src/components/mdx-components.tsx

@@ -7,7 +7,7 @@ import { HeroSlide } from './slides/hero-slide'
 import { FigureSlide } from './slides/figure-slide'
 import { TextSlide } from './slides/text-slide'
 import { SlideOutline } from './slides/slide-outline'
-
+import { PostList } from '@/components/post-list'
 /**
  * Smart link component that uses React Router for internal links
  * and regular anchor tags for external links.
@@ -89,6 +89,8 @@ export const mdxComponents = {
 
   SlideOutline,
 
+  PostList,
+
   // Headings - clean sans-serif
   h1: (props: React.HTMLAttributes<HTMLHeadingElement>) => {
     const id = generateId(props.children)

package/src/components/post-list-item.tsx

@@ -0,0 +1,54 @@
+import { Link } from "react-router-dom";
+import { cn } from "@/lib/utils";
+import { formatDate } from "@/lib/format-date";
+import { ArrowRight, Presentation } from "lucide-react";
+
+interface PostListItemProps {
+  title: string;
+  description?: string;
+  date?: Date;
+  linkPath: string;
+  isSlides?: boolean;
+}
+
+export function PostListItem({ title, description, date, linkPath, isSlides }: PostListItemProps) {
+  return (
+    <Link
+      to={linkPath}
+      className={cn(
+        "group block py-3 px-3 -mx-3 rounded-md",
+        "transition-colors duration-150",
+      )}
+    >
+      <article className="flex items-center gap-4">
+        {/* Main content */}
+        <div className="flex-1 min-w-0">
+          <div className={cn(
+            "text-sm font-medium text-foreground",
+            "group-hover:underline",
+            "flex items-center gap-2"
+          )}>
+            <span>{title}</span>
+            <ArrowRight className="h-3 w-3 opacity-0 -translate-x-1 group-hover:opacity-100 group-hover:translate-x-0 transition-all duration-200 text-primary" />
+          </div>
+
+          {description && (
+            <div className="text-sm text-muted-foreground line-clamp-1 mt-0.5">
+              {description}
+            </div>
+          )}
+        </div>
+
+        {isSlides && (
+          <Presentation className="h-3 w-3 text-muted-foreground" />
+        )}
+        <time
+          dateTime={date?.toISOString()}
+          className="font-mono text-xs text-muted-foreground tabular-nums w-20 flex-shrink-0"
+        >
+          {date && formatDate(date)}
+        </time>
+      </article>
+    </Link>
+  );
+}