radiant-docs 0.1.7 → 0.1.8

package/dist/index.js

@@ -52,6 +52,29 @@ function getTemplateDir() {
 function getContentDir(cacheDir) {
   return path.join(cacheDir, "src/content/docs");
 }
+async function getDirectoryFingerprint(dir) {
+  const hash = crypto.createHash("sha256");
+  async function walk(currentDir) {
+    const entries = await fs.readdir(currentDir, { withFileTypes: true });
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+      const fullPath = path.join(currentDir, entry.name);
+      const relativePath = path.relative(dir, fullPath);
+      if (entry.isDirectory()) {
+        hash.update(`dir:${relativePath}
+`);
+        await walk(fullPath);
+        continue;
+      }
+      hash.update(`file:${relativePath}
+`);
+      hash.update(await fs.readFile(fullPath));
+      hash.update("\n");
+    }
+  }
+  await walk(dir);
+  return hash.digest("hex");
+}
 async function validateUserDocs(docsDir) {
   const docsJsonPath = path.join(docsDir, "docs.json");
   if (!fs.existsSync(docsJsonPath)) {
@@ -80,14 +103,13 @@ async function setupCache(cacheDir) {
     log.info(`Expected at: ${templateDir}`);
     process.exit(1);
   }
+  const templateFingerprint = await getDirectoryFingerprint(templateDir);
+  const cacheFingerprintPath = path.join(cacheDir, ".radiant-template-fingerprint");
   let needsUpdate = !cacheExists;
   if (cacheExists) {
     try {
-      const templatePkg = await fs.readJson(
-        path.join(templateDir, "package.json")
-      );
-      const cachePkg = await fs.readJson(path.join(cacheDir, "package.json"));
-      if (templatePkg.version !== cachePkg.version) {
+      const cacheFingerprint = await fs.readFile(cacheFingerprintPath, "utf-8");
+      if (cacheFingerprint !== templateFingerprint) {
         needsUpdate = true;
         log.info("Framework update detected, refreshing cache...");
       }
@@ -106,6 +128,7 @@ async function setupCache(cacheDir) {
         return !relativePath.includes("node_modules");
       }
     });
+    await fs.writeFile(cacheFingerprintPath, templateFingerprint);
     log.success("Framework copied to cache.");
     return true;
   }

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "radiant-docs",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "CLI tool for previewing Radiant documentation locally",
   "type": "module",
   "bin": {
     "radiant": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm --clean",
+    "build": "tsup src/index.ts --format esm --clean && npm run bundle-template",
     "dev": "tsup src/index.ts --format esm --watch",
-    "prepublishOnly": "npm run build && npm run bundle-template",
+    "prepublishOnly": "npm run build",
     "bundle-template": "node scripts/bundle-template.js"
   },
   "dependencies": {

package/template/astro.config.mjs

@@ -4,10 +4,60 @@ import tailwindcss from "@tailwindcss/vite";
 import mdx from "@astrojs/mdx";
 import alpine from "@astrojs/alpinejs";
 import icon from "astro-icon";
-import expressiveCode from "astro-expressive-code";
 import fs from "fs";
 import path from "path";
 import { getConfig, validateMdxContent } from "./src/lib/validation";
+import remarkCodeBlockComponent from "./src/lib/mdx/remark-code-block-component";
+import remarkDemoteH1 from "./src/lib/mdx/remark-demote-h1";
+import rehypeSlug from "rehype-slug";
+import rehypeAutolinkHeadings from "rehype-autolink-headings";
+
+const headingAnchorIcon = {
+  type: "element",
+  tagName: "svg",
+  properties: {
+    xmlns: "http://www.w3.org/2000/svg",
+    width: "24",
+    height: "24",
+    viewBox: "0 0 24 24",
+    fill: "none",
+    stroke: "currentColor",
+    strokeWidth: "2",
+    strokeLinecap: "round",
+    strokeLinejoin: "round",
+    className: ["heading-anchor-icon"],
+    ariaHidden: "true",
+  },
+  children: [
+    {
+      type: "element",
+      tagName: "path",
+      properties: {
+        d: "M9 17H7A5 5 0 0 1 7 7h2",
+      },
+      children: [],
+    },
+    {
+      type: "element",
+      tagName: "path",
+      properties: {
+        d: "M15 7h2a5 5 0 1 1 0 10h-2",
+      },
+      children: [],
+    },
+    {
+      type: "element",
+      tagName: "line",
+      properties: {
+        x1: "8",
+        x2: "16",
+        y1: "12",
+        y2: "12",
+      },
+      children: [],
+    },
+  ],
+};
 
 if (process.env.npm_lifecycle_event === "build") {
   // Run validation for build before Astro's internal validation
@@ -198,8 +248,15 @@ function copyContentAssets() {
   };
 }
 
+const configuredSite =
+  typeof process.env.DOCS_SITE_URL === "string" &&
+  process.env.DOCS_SITE_URL.trim().length > 0
+    ? process.env.DOCS_SITE_URL.trim()
+    : undefined;
+
 // https://astro.build/config
 export default defineConfig({
+  site: configuredSite,
   vite: {
     plugins: [tailwindcss(), copyContentAssets()],
   },
@@ -208,8 +265,24 @@ export default defineConfig({
     format: "directory",
   },
   integrations: [
-    expressiveCode(),
-    mdx(),
+    mdx({
+      remarkPlugins: [remarkDemoteH1, remarkCodeBlockComponent],
+      rehypePlugins: [
+        rehypeSlug,
+        [
+          rehypeAutolinkHeadings,
+          {
+            behavior: "append",
+            content: headingAnchorIcon,
+            properties: {
+              className: ["heading-anchor"],
+              ariaLabel: "Copy section link",
+              title: "Copy section link",
+            },
+          },
+        ],
+      ],
+    }),
     alpine({ entrypoint: "/src/entrypoint" }),
     icon(),
   ],