radiant-docs 0.1.22 → 0.1.24

package/package.json

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

package/template/astro.config.mjs

@@ -9,6 +9,7 @@ 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 rehypeExternalLinks from "./src/lib/mdx/rehype-external-links";
 import remarkGfm from "remark-gfm";
 import rehypeSlug from "rehype-slug";
 import rehypeAutolinkHeadings from "rehype-autolink-headings";
@@ -273,6 +274,7 @@ export default defineConfig({
       remarkPlugins: [remarkGfm, remarkDemoteH1, remarkCodeBlockComponent],
       rehypePlugins: [
         rehypeSlug,
+        rehypeExternalLinks,
         [
           rehypeAutolinkHeadings,
           {

package/template/src/components/user/Image.astro

@@ -1,6 +1,7 @@
 ---
 import type { HTMLAttributes } from "astro/types";
 import { validateProps } from "../../lib/component-error";
+import { renderMarkdown } from "../../lib/utils";
 
 interface Props extends HTMLAttributes<"img"> {
   src: string;
@@ -8,6 +9,11 @@ interface Props extends HTMLAttributes<"img"> {
 
 const { title, ...attrs } = Astro.props;
 
+const captionHtml =
+  typeof title === "string" && title.trim().length > 0
+    ? (await renderMarkdown(title)).replace(/^<p>([\s\S]*)<\/p>\n?$/, "$1")
+    : "";
+
 validateProps(
   "Image",
   Astro.props as Record<string, any>,
@@ -96,7 +102,7 @@ validateProps(
   {
     title && (
       <figcaption class="mt-2 text-center text-sm text-neutral-500 dark:text-neutral-400 font-medium whitespace-pre-line leading-relaxed px-2">
-        {title}
+        <span set:html={captionHtml} />
       </figcaption>
     )
   }

package/template/src/lib/mdx/rehype-external-links.ts

@@ -0,0 +1,57 @@
+import type { Plugin } from "unified";
+
+type HastNode = {
+  type?: string;
+  tagName?: string;
+  properties?: Record<string, unknown>;
+  children?: HastNode[];
+};
+
+function isExternalHttpLink(href: unknown): href is string {
+  return typeof href === "string" && /^https?:\/\//i.test(href);
+}
+
+function normalizeRelTokens(value: unknown): string[] {
+  if (Array.isArray(value)) {
+    return value
+      .flatMap((entry) =>
+        typeof entry === "string" ? entry.split(/\s+/) : [],
+      )
+      .filter(Boolean);
+  }
+
+  if (typeof value === "string") {
+    return value.split(/\s+/).filter(Boolean);
+  }
+
+  return [];
+}
+
+function visitNodes(node: HastNode, visitor: (node: HastNode) => void): void {
+  visitor(node);
+  if (!Array.isArray(node.children)) return;
+  for (const child of node.children) {
+    visitNodes(child, visitor);
+  }
+}
+
+export const rehypeExternalLinks: Plugin<[], HastNode> = () => {
+  return (tree) => {
+    visitNodes(tree, (node) => {
+      if (node.type !== "element" || node.tagName !== "a") return;
+
+      const props = (node.properties ??= {});
+      const href = props.href;
+      if (!isExternalHttpLink(href)) return;
+
+      props.target = "_blank";
+
+      const relTokens = normalizeRelTokens(props.rel);
+      if (!relTokens.includes("noopener")) relTokens.push("noopener");
+      if (!relTokens.includes("noreferrer")) relTokens.push("noreferrer");
+      props.rel = relTokens.join(" ");
+    });
+  };
+};
+
+export default rehypeExternalLinks;

package/template/src/lib/utils.ts

@@ -3,6 +3,7 @@ import remarkParse from "remark-parse";
 import remarkGfm from "remark-gfm";
 import remarkRehype from "remark-rehype";
 import rehypeStringify from "rehype-stringify";
+import rehypeExternalLinks from "./mdx/rehype-external-links";
 import path from "node:path";
 
 export function slugify(text: string): string {
@@ -25,6 +26,7 @@ export async function renderMarkdown(markdown: string): Promise<string> {
     .use(remarkParse)
     .use(remarkGfm) // GitHub Flavored Markdown (for lists, etc.)
     .use(remarkRehype, { allowDangerousHtml: false })
+    .use(rehypeExternalLinks)
     .use(rehypeStringify)
     .process(markdown);