radiant-docs 0.1.66 → 0.1.68

package/package.json

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

package/template/astro.config.mjs

@@ -311,13 +311,33 @@ 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,
-    remarkResolveInternalLinks,
     remarkDemoteH1,
     remarkStandaloneImageComponent,
+    // ComponentPreview fences become rendered preview children here, so resolve
+    // links after this while leaving the visible raw code sample untouched.
     remarkCodeBlockComponent,
+    remarkResolveInternalLinks,
   ],
   rehypePlugins: [
     rehypeSlug,
@@ -387,7 +407,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",
@@ -52,7 +52,7 @@
         "oas": "^28.7.0",
         "openapi-sampler": "^1.6.2",
         "preact": "^10.29.0",
-        "radiant-docs-validator": "^0.1.30",
+        "radiant-docs-validator": "^0.1.31",
         "rehype-autolink-headings": "^7.1.0",
         "rehype-slug": "^6.0.0",
         "remark-gfm": "^4.0.1",
@@ -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": "*"
@@ -11094,9 +11094,9 @@
       "license": "MIT"
     },
     "node_modules/radiant-docs-validator": {
-      "version": "0.1.30",
-      "resolved": "https://registry.npmjs.org/radiant-docs-validator/-/radiant-docs-validator-0.1.30.tgz",
-      "integrity": "sha512-lPYI+sr6Hx/EI2v9gkDjSb0a6tvTAHut1QNHXj+MeX25ukZN0Peqb/bnkA+VM1t/RTtZO8eAV7kvmGgYXKxJpA==",
+      "version": "0.1.31",
+      "resolved": "https://registry.npmjs.org/radiant-docs-validator/-/radiant-docs-validator-0.1.31.tgz",
+      "integrity": "sha512-YUgNgsJ1OXWTdo86vtUOAOirQ9WG8patH0F3bGG0FaS/7HUZzJaoYEs8wph6I8EZs/LV1qENfaAvY/0DFjQnMA==",
       "license": "MIT",
       "dependencies": {
         "@iconify-json/fluent": "^1.2.47",

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",
@@ -51,7 +51,7 @@
     "oas": "^28.7.0",
     "openapi-sampler": "^1.6.2",
     "preact": "^10.29.0",
-    "radiant-docs-validator": "^0.1.30",
+    "radiant-docs-validator": "^0.1.31",
     "rehype-autolink-headings": "^7.1.0",
     "rehype-slug": "^6.0.0",
     "remark-gfm": "^4.0.1",

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">