radiant-docs 0.1.65 → 0.1.67

package/dist/index.js

@@ -8,10 +8,14 @@ import chokidar from "chokidar";
 import { fileURLToPath } from "url";
 import envPaths from "env-paths";
 import crypto from "crypto";
+import net from "net";
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = path.dirname(__filename);
 var paths = envPaths("radiant", { suffix: "" });
 var VERSION = "0.1.0";
+var DEV_SERVER_HOST = "localhost";
+var DEV_SERVER_PORT = 3e3;
+var MAX_PORT = 65535;
 var lastErrorMessage = "";
 var lastErrorTime = 0;
 var ERROR_DEDUPE_MS = 2e3;
@@ -187,17 +191,33 @@ async function runAstroSync(cacheDir) {
   } catch {
   }
 }
-function startDevServer(cacheDir) {
-  const child = spawn("npm", ["run", "dev"], {
-    cwd: cacheDir,
-    shell: true,
-    env: {
-      ...process.env,
-      FORCE_COLOR: "1"
+async function startDevServer(cacheDir) {
+  const port = await findAvailablePort(DEV_SERVER_PORT);
+  if (port !== DEV_SERVER_PORT) {
+    log.info(`Port ${DEV_SERVER_PORT} is busy, using port ${port}...`);
+  }
+  const child = spawn(
+    "npm",
+    [
+      "run",
+      "dev",
+      "--",
+      "--host",
+      DEV_SERVER_HOST,
+      "--port",
+      String(port)
+    ],
+    {
+      cwd: cacheDir,
+      shell: true,
+      env: {
+        ...process.env,
+        FORCE_COLOR: "1"
+      }
     }
-  });
+  );
   let serverStarted = false;
-  let serverUrl = "http://localhost:4321";
+  let serverUrl = `http://${DEV_SERVER_HOST}:${port}`;
   const processOutput = (data, isError = false) => {
     const output = data.toString();
     const lines = output.split("\n");
@@ -244,6 +264,29 @@ function startDevServer(cacheDir) {
   });
   return child;
 }
+async function findAvailablePort(startPort) {
+  for (let port = startPort; port <= MAX_PORT; port++) {
+    if (await isPortAvailable(port)) {
+      return port;
+    }
+  }
+  throw new Error(`No available port found from ${startPort} to ${MAX_PORT}`);
+}
+function isPortAvailable(port) {
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.unref();
+    server.once("error", () => {
+      resolve(false);
+    });
+    server.once("listening", () => {
+      server.close(() => {
+        resolve(true);
+      });
+    });
+    server.listen(port, DEV_SERVER_HOST);
+  });
+}
 function watchUserContent(docsDir, contentDir, _onSync) {
   const watcher = chokidar.watch(docsDir, {
     ignored: [
@@ -334,7 +377,7 @@ async function run() {
   await runAstroSync(cacheDir);
   log.success("Content synced.");
   log.info("Starting dev server...");
-  const devServer = startDevServer(cacheDir);
+  const devServer = await startDevServer(cacheDir);
   const watcher = watchUserContent(docsDir, contentDir, async () => {
     await runAstroSync(cacheDir);
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "radiant-docs",
-  "version": "0.1.65",
+  "version": "0.1.67",
   "description": "CLI tool for previewing Radiant documentation locally",
   "type": "module",
   "bin": {

package/template/astro.config.mjs

@@ -311,6 +311,24 @@ function resolveDocsSiteConfig() {
 const docsSiteConfig = resolveDocsSiteConfig();
 globalThis.__RADIANT_DOCS_BASE_PATH__ = docsSiteConfig.base;
 
+function isInternalDocsRoutePathname(pathname) {
+  const basePath = docsSiteConfig.base === "/" ? "" : docsSiteConfig.base;
+  const relativePath =
+    basePath && pathname.startsWith(`${basePath}/`)
+      ? pathname.slice(basePath.length)
+      : pathname;
+
+  return relativePath === "/-" || relativePath.startsWith("/-/");
+}
+
+function shouldIncludeSitemapPage(page) {
+  try {
+    return !isInternalDocsRoutePathname(new URL(page).pathname);
+  } catch {
+    return !page.startsWith("/-/");
+  }
+}
+
 const markdownProcessor = unified({
   remarkPlugins: [
     remarkGfm,
@@ -387,7 +405,9 @@ export default defineConfig({
     assetsPrefix: configuredAssetsPrefix,
   },
   integrations: [
-    sitemap(),
+    sitemap({
+      filter: shouldIncludeSitemapPage,
+    }),
     preact({
       compat: true,
     }),

package/template/package-lock.json

@@ -28,7 +28,7 @@
         "@fontsource-variable/source-serif-4": "^5.2.9",
         "@iconify-json/fluent": "^1.2.47",
         "@iconify-json/lucide": "^1.2.79",
-        "@iconify-json/simple-icons": "^1.2.69",
+        "@iconify-json/simple-icons": "^1.2.87",
         "@iconify/react": "^6.0.2",
         "@paper-design/shaders": "^0.0.76",
         "@preact/preset-vite": "^2.10.3",
@@ -2343,9 +2343,9 @@
       }
     },
     "node_modules/@iconify-json/simple-icons": {
-      "version": "1.2.69",
-      "resolved": "https://registry.npmjs.org/@iconify-json/simple-icons/-/simple-icons-1.2.69.tgz",
-      "integrity": "sha512-T/rhy5n7pzE0ZOxQVlF68SNPCYYjRBpddjgjrJO5WWVRG8es5BQmvxIE9kKF+t2hhPGvuGQFpXmUyqbOtnxirQ==",
+      "version": "1.2.87",
+      "resolved": "https://registry.npmjs.org/@iconify-json/simple-icons/-/simple-icons-1.2.87.tgz",
+      "integrity": "sha512-8YciStObhSji3OZFmWAWK6kBujyqO5bLCxeDwLxf3CR3F4PVelq7keC2LBvgTqviWzSTysj5/g4PCFLiAMVGsw==",
       "license": "CC0-1.0",
       "dependencies": {
         "@iconify/types": "*"

package/template/package.json

@@ -27,7 +27,7 @@
     "@fontsource-variable/source-serif-4": "^5.2.9",
     "@iconify-json/fluent": "^1.2.47",
     "@iconify-json/lucide": "^1.2.79",
-    "@iconify-json/simple-icons": "^1.2.69",
+    "@iconify-json/simple-icons": "^1.2.87",
     "@iconify/react": "^6.0.2",
     "@paper-design/shaders": "^0.0.76",
     "@preact/preset-vite": "^2.10.3",

package/template/src/components/MdxPage.astro

@@ -19,6 +19,7 @@ import ComponentPreview from "./user/ComponentPreview.astro";
 import ComponentPreviewBlock from "./user/ComponentPreviewBlock.astro";
 import type { MdxRoute, Route } from "../lib/routes";
 import PagePagination from "./PagePagination.astro";
+import PageAiActions from "./PageAiActions.astro";
 import { PREVIEW_HEADING_ID_PREFIX } from "../lib/mdx/rehype-prefix-preview-heading-ids";
 
 interface Props {
@@ -67,10 +68,19 @@ const tocHeadings = headings.filter(
 <Layout pageTitle={title} pageDescription={description}>
   <div class="flex w-full min-w-0 justify-between gap-x-10">
     <div class="mx-auto max-w-3xl w-full">
-      <header class="mb-6">
-        <h1 class="rd-document-heading text-4xl font-semibold tracking-tight">
+      <header
+        class="mb-8 flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between"
+      >
+        <h1
+          class="rd-document-heading min-w-0 text-4xl font-semibold tracking-tight"
+        >
           {title}
         </h1>
+        <PageAiActions
+          title={title}
+          routeSlug={route.slug}
+          description={description}
+        />
       </header>
       <article class="prose-rules">
         <Content components={components} />

package/template/src/components/OpenApiPage.astro

@@ -10,6 +10,7 @@ import ResponseFieldTree from "./endpoint/ResponseFieldTree.astro";
 import PlaygroundBar from "./endpoint/PlaygroundBar.astro";
 import PlaygroundForm from "./endpoint/PlaygroundForm.astro";
 import PlaygroundButton from "./endpoint/PlaygroundButton.astro";
+import PageAiActions from "./PageAiActions.astro";
 import { getConfig } from "../lib/validation";
 import {
   getOpenApiOperationDoc,
@@ -59,11 +60,20 @@ const snippetStickyClass = hasTopbarNavigationTabs
 ---
 
 <Layout pageTitle={title}>
-  <article>
-    <header class="mb-6">
-      <h1 class="rd-document-heading text-4xl font-semibold tracking-tight">
+  <article class="mx-auto w-full max-w-7xl">
+    <header
+      class="mb-8 flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between"
+    >
+      <h1
+        class="rd-document-heading min-w-0 text-4xl font-semibold tracking-tight"
+      >
         {title}
       </h1>
+      <PageAiActions
+        title={title}
+        routeSlug={route.slug}
+        description={description}
+      />
     </header>
     <div class="flex flex-row-reverse justify-between gap-6 w-full">
       <aside class="flex-1 min-w-0 hidden xl:block">