radiant-docs 0.1.68 → 0.1.69

package/package.json

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

package/template/src/components/MdxPage.astro

@@ -65,9 +65,54 @@ 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">
+<Layout pageTitle={title} pageDescription={description} hasMarkdownAlternate>
+  <style is:inline>
+    [data-rd-mdx-shell] {
+      display: grid;
+      grid-template-columns: minmax(0, 48rem);
+      width: 100%;
+      min-width: 0;
+      justify-content: center;
+      column-gap: 2.5rem;
+    }
+
+    [data-rd-mdx-content] {
+      width: 100%;
+      max-width: none;
+      min-width: 0;
+      margin-inline: 0;
+    }
+
+    [data-rd-toc-column] {
+      display: none;
+      width: 12rem;
+      flex: 0 0 12rem;
+    }
+
+    @media (min-width: 80rem) {
+      [data-rd-mdx-shell] {
+        grid-template-columns: minmax(0, 1fr) minmax(0, 48rem) minmax(
+            0,
+            1fr
+          ) 12rem;
+        justify-content: stretch;
+      }
+
+      [data-rd-mdx-content] {
+        grid-column: 2;
+      }
+
+      [data-rd-toc-column] {
+        display: block;
+        grid-column: 4;
+      }
+    }
+  </style>
+  <div
+    class="flex w-full min-w-0 justify-between gap-x-10"
+    data-rd-mdx-shell
+  >
+    <div class="mx-auto max-w-3xl w-full" data-rd-mdx-content>
       <header
         class="mb-8 flex flex-col gap-4 sm:flex-row sm:items-end sm:justify-between"
       >
@@ -91,7 +136,7 @@ const tocHeadings = headings.filter(
         homePath={homePath}
       />
     </div>
-    <aside class="hidden xl:block w-48 shrink-0">
+    <aside class="hidden xl:block w-48 shrink-0" data-rd-toc-column>
       <TableOfContents headings={tocHeadings} />
     </aside>
   </div>

package/template/src/components/OpenApiPage.astro

@@ -59,7 +59,7 @@ const snippetStickyClass = hasTopbarNavigationTabs
   : "top-[92px] max-h-[calc(100vh-92px)]";
 ---
 
-<Layout pageTitle={title}>
+<Layout pageTitle={title} hasMarkdownAlternate>
   <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"

package/template/src/components/PageAiActions.astro

@@ -431,24 +431,40 @@ const menuItems: MenuItem[] = [
   }
 </style>
 
-<script is:inline data-astro-rerun>
-  (() => {
-    const script = document.currentScript;
-    let root = script?.previousElementSibling;
-    while (
-      root &&
-      (!(root instanceof HTMLElement) ||
-        !root.hasAttribute("data-rd-page-actions"))
-    ) {
-      root = root.previousElementSibling;
-    }
+<script>
+  const pageActionsSelector = "[data-rd-page-actions]";
+  const pageActionsControlsKey = "__rdPageActionsControls";
+
+  function fallbackCopy(text) {
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    textarea.setAttribute("readonly", "");
+    textarea.style.position = "fixed";
+    textarea.style.opacity = "0";
+    document.body.appendChild(textarea);
+    textarea.select();
+    const copied = document.execCommand("copy");
+    document.body.removeChild(textarea);
+    return copied;
+  }
 
-    if (
-      !(root instanceof HTMLElement) ||
-      root.dataset.pageActionsBound === "true"
-    ) {
-      return;
+  async function copyToClipboard(text) {
+    try {
+      if (navigator.clipboard?.writeText) {
+        await navigator.clipboard.writeText(text);
+        return true;
+      }
+    } catch {
+      // Fallback below when clipboard API is unavailable or blocked.
     }
+
+    return fallbackCopy(text);
+  }
+
+  function initPageActions(root) {
+    if (!(root instanceof HTMLElement)) return;
+    if (root.dataset.pageActionsBound === "true") return;
+
     root.dataset.pageActionsBound = "true";
 
     const trigger = root.querySelector("[data-rd-page-actions-trigger]");
@@ -463,32 +479,6 @@ const menuItems: MenuItem[] = [
     let mcpMetadataPromise;
     const copyFeedbackTimeouts = new WeakMap();
 
-    function fallbackCopy(text) {
-      const textarea = document.createElement("textarea");
-      textarea.value = text;
-      textarea.setAttribute("readonly", "");
-      textarea.style.position = "fixed";
-      textarea.style.opacity = "0";
-      document.body.appendChild(textarea);
-      textarea.select();
-      const copied = document.execCommand("copy");
-      document.body.removeChild(textarea);
-      return copied;
-    }
-
-    async function copyToClipboard(text) {
-      try {
-        if (navigator.clipboard?.writeText) {
-          await navigator.clipboard.writeText(text);
-          return true;
-        }
-      } catch {
-        // Fallback below when clipboard API is unavailable or blocked.
-      }
-
-      return fallbackCopy(text);
-    }
-
     function setExpanded(nextExpanded) {
       if (!(trigger instanceof HTMLElement)) return;
       trigger.setAttribute("aria-expanded", String(nextExpanded));
@@ -711,5 +701,21 @@ const menuItems: MenuItem[] = [
         closeMenu();
       });
     });
-  })();
+  }
+
+  function initAllPageActions() {
+    document.querySelectorAll(pageActionsSelector).forEach((root) => {
+      initPageActions(root);
+    });
+  }
+
+  window[pageActionsControlsKey] = window[pageActionsControlsKey] || {};
+  window[pageActionsControlsKey].init = initAllPageActions;
+
+  if (!window[pageActionsControlsKey].installed) {
+    window[pageActionsControlsKey].installed = true;
+    document.addEventListener("astro:page-load", initAllPageActions);
+  }
+
+  initAllPageActions();
 </script>

package/template/src/components/Sidebar.astro

@@ -19,6 +19,33 @@ const config: DocsConfig = await getConfig();
   >
     <SidebarMenu navigation={config.navigation} />
   </nav>
+  <script is:inline>
+    (() => {
+      const script = document.currentScript;
+      const sidebar = script?.previousElementSibling;
+
+      if (
+        !(sidebar instanceof HTMLElement) ||
+        !sidebar.hasAttribute("data-rd-sidebar-scroll-container")
+      ) {
+        return;
+      }
+
+      if (document.readyState !== "loading") return;
+
+      try {
+        const value = Number(
+          sessionStorage.getItem("radiant-docs:sidebar-scroll-top"),
+        );
+        if (!Number.isFinite(value) || value <= 0) return;
+
+        sidebar.scrollTop = Math.max(0, Math.round(value));
+        sidebar.dataset.rdSidebarScrollRestored = "true";
+      } catch {
+        // Storage can be unavailable in private browsing or locked-down embeds.
+      }
+    })();
+  </script>
   <div
     class:list={[
       "bg-background z-10 px-3 pt-3 pb-[calc(env(safe-area-inset-bottom)+0.75rem)] border-t border-t-border-light flex gap-1.5 items-center",

package/template/src/components/TableOfContents.astro

@@ -1,6 +1,7 @@
 ---
 import type { MarkdownHeading } from "astro";
 import { Icon } from "astro-icon/components";
+import { getConfig } from "../lib/validation";
 
 interface Props {
   headings: MarkdownHeading[];
@@ -11,6 +12,18 @@ interface GroupedHeading extends MarkdownHeading {
 }
 
 const { headings } = Astro.props;
+type TabsPresentation = "topbar" | "sidebar";
+const config = await getConfig();
+const navigationTabs = config.navigation.tabs as
+  | (typeof config.navigation.tabs & { presentation?: TabsPresentation })
+  | undefined;
+const hasTopbarNavigationTabs =
+  Array.isArray(navigationTabs?.items) &&
+  navigationTabs.items.length > 0 &&
+  (navigationTabs.presentation ?? "topbar") === "topbar";
+const stickyTopClass = hasTopbarNavigationTabs
+  ? "top-[calc(68px+44px+64px)]"
+  : "top-[calc(68px+64px)]";
 
 // Group depth 3 headings under their preceding depth 2 heading
 const groupedHeadings: GroupedHeading[] = [];
@@ -30,7 +43,7 @@ for (const heading of headings) {
 ---
 
 <nav
-  class="sticky top-[calc(68px+64px)] text-[13px]/5"
+  class:list={["sticky text-[13px]/5", stickyTopClass]}
   aria-label="Table of Contents"
   data-slugs={JSON.stringify(headings.map((h) => h.slug))}
 >

package/template/src/components/chat/AssistantEmbedPanel.tsx

@@ -80,6 +80,7 @@ type ChatViewportWheelEvent = JSX.TargetedWheelEvent<HTMLDivElement>;
 type ChatViewportScrollEvent = JSX.TargetedEvent<HTMLDivElement, Event>;
 
 type PersistedPanelState = {
+  conversationId: string;
   messages: ChatMessage[];
   scrollTop: number;
   inFlight: boolean;
@@ -104,6 +105,16 @@ type PendingAssistantHandoff = {
   timeoutId: number;
 };
 
+type AssistantPageContext = {
+  hostname: string | null;
+  pagePath: string | null;
+};
+
+type PendingPageContextRequest = {
+  resolve: (context: AssistantPageContext) => void;
+  timeoutId: number;
+};
+
 export const ASSISTANT_PANEL_STORAGE_KEY = "docs:assistant-embed-panel:v1";
 const HANDOFF_QUERY_PARAM = "assistantHandoff";
 const OPEN_QUERY_PARAM = "assistant";
@@ -413,6 +424,7 @@ function normalizePersistedMessages(rawMessages: unknown): ChatMessage[] {
 
 function createEmptyPersistedPanelState(): PersistedPanelState {
   return {
+    conversationId: createMessageId(),
     messages: [],
     scrollTop: 0,
     inFlight: false,
@@ -426,6 +438,12 @@ function normalizePanelSize(value: unknown): AssistantPanelSize {
   return value === "expanded" ? "expanded" : "default";
 }
 
+function normalizeConversationId(value: unknown): string {
+  return typeof value === "string" && value.trim()
+    ? value.trim().slice(0, 128)
+    : createMessageId();
+}
+
 function getPanelFullscreenMediaQuery(
   mobileBreakpoint: string,
   panelFullscreenHeightBreakpoint: string,
@@ -439,6 +457,7 @@ function normalizePersistedPanelState(rawState: unknown): PersistedPanelState {
   }
 
   const state = rawState as {
+    conversationId?: unknown;
     messages?: unknown;
     scrollTop?: unknown;
     inFlight?: unknown;
@@ -461,6 +480,7 @@ function normalizePersistedPanelState(rawState: unknown): PersistedPanelState {
       : 0;
 
   return {
+    conversationId: normalizeConversationId(state.conversationId),
     messages: normalizePersistedMessages(state.messages),
     scrollTop,
     inFlight: isInFlightFresh,
@@ -515,6 +535,7 @@ function writePersistedPanelState(state: PersistedPanelState) {
       ASSISTANT_PANEL_STORAGE_KEY,
       JSON.stringify({
         messages: state.messages,
+        conversationId: state.conversationId,
         scrollTop:
           Number.isFinite(state.scrollTop) && state.scrollTop > 0
             ? state.scrollTop
@@ -1013,7 +1034,7 @@ function AssistantSourcesBlock({
         {visibleSources.map((source) => (
           <li key={`${source.href}\0${source.label}`}>
             <a
-              href={source.href}
+              href={withBasePath(source.href)}
               target={linkTarget === "blank" ? "_blank" : undefined}
               rel={linkTarget === "blank" ? "noopener noreferrer" : undefined}
             >
@@ -1057,6 +1078,36 @@ function postParentMessage(
   window.parent.postMessage({ type, ...payload }, "*");
 }
 
+function getCurrentPageContext(): AssistantPageContext {
+  if (typeof window === "undefined") {
+    return { hostname: null, pagePath: null };
+  }
+
+  return {
+    hostname: window.location.hostname || null,
+    pagePath: window.location.pathname || "/",
+  };
+}
+
+function normalizeParentPageContext(
+  hostname: unknown,
+  pagePath: unknown,
+): AssistantPageContext {
+  const normalizedHostname =
+    typeof hostname === "string" && hostname.trim().length > 0
+      ? hostname.trim().slice(0, 512)
+      : null;
+  const normalizedPagePath =
+    typeof pagePath === "string" && pagePath.trim().startsWith("/")
+      ? pagePath.trim().slice(0, 2048)
+      : null;
+
+  return {
+    hostname: normalizedHostname,
+    pagePath: normalizedPagePath,
+  };
+}
+
 function getApiPath(
   apiPath: string,
   allowApiPathQueryOverride: boolean,
@@ -1174,6 +1225,11 @@ export default function AssistantEmbedPanel({
   const scrollPersistenceUnlockTimeoutRef = useRef<number | null>(null);
   const isScrollPersistenceLockedRef = useRef(false);
   const pendingHandoffsRef = useRef(new Map<string, PendingAssistantHandoff>());
+  const pendingPageContextRequestsRef = useRef(
+    new Map<string, PendingPageContextRequest>(),
+  );
+  const pageContextRef = useRef<AssistantPageContext>(getCurrentPageContext());
+  const conversationIdRef = useRef(initialPanelState.conversationId);
   const messagesRef = useRef(initialPanelState.messages);
   const isBusyRef = useRef(initialPanelState.inFlight);
   const isAwaitingFirstTokenRef = useRef(
@@ -1203,6 +1259,32 @@ export default function AssistantEmbedPanel({
     launcherIconColors?.dark ?? launcherIconColor ?? "#ffffff";
   const resolvedPanelSize = panelSize ?? localPanelSize;
 
+  const requestPageContext = (): Promise<AssistantPageContext> => {
+    const currentContext = getCurrentPageContext();
+    if (
+      panelSurface !== "iframe" ||
+      typeof window === "undefined" ||
+      window.parent === window
+    ) {
+      pageContextRef.current = currentContext;
+      return Promise.resolve(currentContext);
+    }
+
+    return new Promise((resolve) => {
+      const requestId = createMessageId();
+      const timeoutId = window.setTimeout(() => {
+        pendingPageContextRequestsRef.current.delete(requestId);
+        resolve(pageContextRef.current);
+      }, 250);
+
+      pendingPageContextRequestsRef.current.set(requestId, {
+        resolve,
+        timeoutId,
+      });
+      postParentMessage("assistant-embed:get-page-context", { requestId });
+    });
+  };
+
   const persistPanelState = (
     nextMessages = messagesRef.current,
     scrollTop = savedScrollTopRef.current,
@@ -1227,6 +1309,7 @@ export default function AssistantEmbedPanel({
     }
 
     writePersistedPanelState({
+      conversationId: conversationIdRef.current,
       messages: nextMessages,
       scrollTop,
       inFlight: isBusyRef.current,
@@ -1388,6 +1471,7 @@ export default function AssistantEmbedPanel({
   };
 
   const applyPersistedPanelState = (nextState: PersistedPanelState) => {
+    conversationIdRef.current = nextState.conversationId;
     messagesRef.current = nextState.messages;
     savedScrollTopRef.current = nextState.scrollTop;
     isBusyRef.current = nextState.inFlight;
@@ -1445,6 +1529,7 @@ export default function AssistantEmbedPanel({
 
     pendingHandoffsRef.current.set(handoffId, {
       state: {
+        conversationId: conversationIdRef.current,
         messages: messagesRef.current,
         scrollTop: savedScrollTopRef.current,
         inFlight: isBusyRef.current,
@@ -1774,8 +1859,35 @@ export default function AssistantEmbedPanel({
         type?: unknown;
         size?: unknown;
         isFullscreen?: unknown;
+        hostname?: unknown;
+        pagePath?: unknown;
+        requestId?: unknown;
       };
 
+      if (data.type === "assistant-embed:set-page-context") {
+        if (event.source !== window.parent) {
+          return;
+        }
+
+        const pageContext = normalizeParentPageContext(
+          data.hostname,
+          data.pagePath,
+        );
+        pageContextRef.current = pageContext;
+
+        if (typeof data.requestId === "string") {
+          const pendingRequest = pendingPageContextRequestsRef.current.get(
+            data.requestId,
+          );
+          if (pendingRequest) {
+            window.clearTimeout(pendingRequest.timeoutId);
+            pendingPageContextRequestsRef.current.delete(data.requestId);
+            pendingRequest.resolve(pageContext);
+          }
+        }
+        return;
+      }
+
       if (data.type === "assistant-embed:panel-opened") {
         setEmptyStateAnimationKey((previous) => previous + 1);
         queueSavedScrollRestore();
@@ -1799,6 +1911,10 @@ export default function AssistantEmbedPanel({
     window.addEventListener("message", handlePanelMessage);
     return () => {
       window.removeEventListener("message", handlePanelMessage);
+      for (const pendingRequest of pendingPageContextRequestsRef.current.values()) {
+        window.clearTimeout(pendingRequest.timeoutId);
+      }
+      pendingPageContextRequestsRef.current.clear();
     };
   }, []);
 
@@ -1810,6 +1926,7 @@ export default function AssistantEmbedPanel({
   const handleStartNewChat = () => {
     activeRequestAbortRef.current?.abort();
     activeRequestAbortRef.current = null;
+    conversationIdRef.current = createMessageId();
     setSharedBusy(false);
     setSharedAwaitingFirstToken(false);
     resetThreadScrollPosition([]);
@@ -1837,6 +1954,7 @@ export default function AssistantEmbedPanel({
   const handleUnavailableBack = () => {
     activeRequestAbortRef.current?.abort();
     activeRequestAbortRef.current = null;
+    conversationIdRef.current = createMessageId();
     setSharedBusy(false);
     setSharedAwaitingFirstToken(false);
     resetThreadScrollPosition([]);
@@ -1893,10 +2011,14 @@ export default function AssistantEmbedPanel({
         requestHeaders["x-ask-ai-dev-token"] = devProxyToken;
       }
 
+      const pageContext = await requestPageContext();
       const response = await fetch(resolvedApiPathRef.current, {
         method: "POST",
         headers: requestHeaders,
         body: JSON.stringify({
+          conversationId: conversationIdRef.current,
+          pagePath: pageContext.pagePath,
+          hostname: pageContext.hostname,
           messages: nextConversation.map((message) => ({
             role: message.role,
             content: message.content,
@@ -2141,7 +2263,7 @@ export default function AssistantEmbedPanel({
       linkTarget === "current" && onCurrentLinkNavigate
         ? getSameOriginNavigationRequest(event)
         : null;
-    if (!navigationRequest) {
+    if (!navigationRequest || !onCurrentLinkNavigate) {
       return;
     }
 

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

@@ -397,90 +397,101 @@ const renderedCodeLinesHtml = normalizedTokenLines
       </div>
     </div>
   </div>
-  <script is:inline data-astro-rerun>
-    (() => {
-      const script = document.currentScript;
-      if (!(script instanceof HTMLScriptElement)) return;
+  <script>
+    const codeBlockRootSelector = "[data-rd-code-block-root='true']";
+    const codeBlockControlsKey = "__rdCodeBlockControls";
+
+    const getCodeBlockControls = () => {
+      window[codeBlockControlsKey] = window[codeBlockControlsKey] || {
+        copiedStateTimers: new WeakMap(),
+        installed: false,
+      };
 
-      const root = script.closest("[data-rd-code-block-root='true']");
-      if (!(root instanceof HTMLElement)) return;
+      return window[codeBlockControlsKey];
+    };
 
-      const copyButtons = root.querySelectorAll(
-        "[data-rd-copy-trigger='true']",
-      );
-      if (copyButtons.length === 0) return;
+    const setCopiedState = (button, copied) => {
+      const copyIcon = button.querySelector("[data-rd-copy-icon]");
+      const checkIcon = button.querySelector("[data-rd-copy-check]");
 
-      const setCopiedState = (button, copied) => {
-        const copyIcon = button.querySelector("[data-rd-copy-icon]");
-        const checkIcon = button.querySelector("[data-rd-copy-check]");
+      if (!copyIcon || !checkIcon) return;
 
-        if (!copyIcon || !checkIcon) return;
+      if (copied) {
+        copyIcon.classList.add("scale-50", "opacity-0", "-rotate-6");
+        copyIcon.classList.remove("scale-100", "opacity-100", "rotate-0");
 
-        if (copied) {
-          copyIcon.classList.add("scale-50", "opacity-0", "-rotate-6");
-          copyIcon.classList.remove("scale-100", "opacity-100", "rotate-0");
-
-          checkIcon.classList.remove("scale-50", "opacity-0", "rotate-6");
-          checkIcon.classList.add("scale-110", "opacity-100", "rotate-0");
-          return;
-        }
-
-        copyIcon.classList.remove("scale-50", "opacity-0", "-rotate-6");
-        copyIcon.classList.add("scale-100", "opacity-100", "rotate-0");
+        checkIcon.classList.remove("scale-50", "opacity-0", "rotate-6");
+        checkIcon.classList.add("scale-110", "opacity-100", "rotate-0");
+        return;
+      }
 
-        checkIcon.classList.remove("scale-110", "opacity-100", "rotate-0");
-        checkIcon.classList.add("scale-50", "opacity-0", "rotate-6");
-      };
+      copyIcon.classList.remove("scale-50", "opacity-0", "-rotate-6");
+      copyIcon.classList.add("scale-100", "opacity-100", "rotate-0");
+
+      checkIcon.classList.remove("scale-110", "opacity-100", "rotate-0");
+      checkIcon.classList.add("scale-50", "opacity-0", "rotate-6");
+    };
+
+    const fallbackCopy = (text) => {
+      try {
+        const textarea = document.createElement("textarea");
+        textarea.value = text;
+        textarea.setAttribute("readonly", "");
+        textarea.style.position = "fixed";
+        textarea.style.top = "0";
+        textarea.style.left = "0";
+        textarea.style.width = "1px";
+        textarea.style.height = "1px";
+        textarea.style.padding = "0";
+        textarea.style.border = "0";
+        textarea.style.opacity = "0";
+        textarea.style.fontSize = "16px";
+        textarea.style.pointerEvents = "none";
+        document.body.appendChild(textarea);
 
-      const fallbackCopy = (text) => {
         try {
-          const textarea = document.createElement("textarea");
-          textarea.value = text;
-          textarea.setAttribute("readonly", "");
-          textarea.style.position = "fixed";
-          textarea.style.top = "0";
-          textarea.style.left = "0";
-          textarea.style.width = "1px";
-          textarea.style.height = "1px";
-          textarea.style.padding = "0";
-          textarea.style.border = "0";
-          textarea.style.opacity = "0";
-          textarea.style.fontSize = "16px";
-          textarea.style.pointerEvents = "none";
-          document.body.appendChild(textarea);
-
-          try {
-            textarea.focus({ preventScroll: true });
-          } catch {
-            textarea.focus();
-          }
-          textarea.select();
-          textarea.setSelectionRange(0, textarea.value.length);
-
-          const copied = document.execCommand("copy");
-          document.body.removeChild(textarea);
-          return copied;
+          textarea.focus({ preventScroll: true });
         } catch {
-          return false;
+          textarea.focus();
         }
-      };
+        textarea.select();
+        textarea.setSelectionRange(0, textarea.value.length);
+
+        const copied = document.execCommand("copy");
+        document.body.removeChild(textarea);
+        return copied;
+      } catch {
+        return false;
+      }
+    };
 
-      const copyToClipboard = async (text) => {
-        try {
-          if (navigator.clipboard?.writeText) {
-            await navigator.clipboard.writeText(text);
-            return true;
-          }
-        } catch {
-          // Fallback below when the async Clipboard API is unavailable or blocked.
+    const copyToClipboard = async (text) => {
+      try {
+        if (navigator.clipboard?.writeText) {
+          await navigator.clipboard.writeText(text);
+          return true;
         }
+      } catch {
+        // Fallback below when the async Clipboard API is unavailable or blocked.
+      }
 
-        return fallbackCopy(text);
-      };
+      return fallbackCopy(text);
+    };
+
+    const initCodeBlock = (root) => {
+      if (!(root instanceof HTMLElement)) return;
+      if (root.dataset.rdCodeBlockInitialized === "true") return;
+
+      const copyButtons = root.querySelectorAll("[data-rd-copy-trigger='true']");
+      if (copyButtons.length === 0) return;
+
+      root.dataset.rdCodeBlockInitialized = "true";
 
       copyButtons.forEach((button) => {
-        let timeoutId = null;
+        if (!(button instanceof HTMLElement)) return;
+
         button.addEventListener("click", async () => {
+          const controls = getCodeBlockControls();
           const encodedCopyValue =
             button.getAttribute("data-rd-copy-content") ?? "";
           const copyValue = decodeURIComponent(encodedCopyValue);
@@ -494,16 +505,35 @@ const renderedCodeLinesHtml = normalizedTokenLines
 
             setCopiedState(button, true);
 
-            if (timeoutId) window.clearTimeout(timeoutId);
-            timeoutId = window.setTimeout(() => {
+            const existingTimeoutId = controls.copiedStateTimers.get(button);
+            if (existingTimeoutId) window.clearTimeout(existingTimeoutId);
+
+            const timeoutId = window.setTimeout(() => {
               setCopiedState(button, false);
-              timeoutId = null;
+              controls.copiedStateTimers.delete(button);
             }, 1200);
+            controls.copiedStateTimers.set(button, timeoutId);
           } catch {
             setCopiedState(button, false);
           }
         });
       });
-    })();
+    };
+
+    const initCodeBlocks = () => {
+      document.querySelectorAll(codeBlockRootSelector).forEach((root) => {
+        initCodeBlock(root);
+      });
+    };
+
+    const controls = getCodeBlockControls();
+    controls.init = initCodeBlocks;
+
+    if (!controls.installed) {
+      controls.installed = true;
+      document.addEventListener("astro:page-load", initCodeBlocks);
+    }
+
+    initCodeBlocks();
   </script>
 </div>

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

@@ -62,6 +62,9 @@ const isInitiallyExpanded = shouldShowAllCode || totalLineCount <= visibleLines;
 <div
   class="rd-prose-block rd-component-preview isolate flex w-full max-w-full min-w-0 flex-col"
   data-rd-component-preview-root="true"
+  data-rd-preview-visible-lines={String(visibleLines)}
+  data-rd-preview-total-line-count={String(totalLineCount)}
+  data-rd-preview-show-all-code={shouldShowAllCode ? "true" : "false"}
 >
   <div
     class="relative z-10 w-full max-w-full min-w-0 rounded-t-xl border-[0.5px] border-b-0 border-(--rd-code-tab-edge-border) bg-(--rd-code-surface) p-2"
@@ -215,27 +218,29 @@ const isInitiallyExpanded = shouldShowAllCode || totalLineCount <= visibleLines;
   }
 </style>
 
-<script
-  is:inline
-  data-astro-rerun
-  define:vars={{
-    visibleLines,
-    totalLineCount,
-    shouldShowAllCode,
-  }}
->
-  (() => {
-    const script = document.currentScript;
-    if (!(script instanceof HTMLScriptElement)) return;
-
-    let root = script.previousElementSibling;
-    while (
-      root &&
-      (!(root instanceof HTMLElement) ||
-        !root.hasAttribute("data-rd-component-preview-root"))
-    ) {
-      root = root.previousElementSibling;
-    }
+<script>
+  const previewRootSelector = '[data-rd-component-preview-root="true"]';
+  const previewControlsKey = "__rdComponentPreviewControls";
+
+  const parsePositiveInteger = (value, fallback) => {
+    const parsed = Number.parseInt(value ?? "", 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+  };
+
+  const syncExpandedHeight = (root) => {
+    const codeWrapper = root.querySelector(".rd-component-preview__code");
+    if (!(codeWrapper instanceof HTMLElement)) return;
+
+    const scrollArea = codeWrapper.querySelector("[data-rd-code-scroll-area]");
+    if (!(scrollArea instanceof HTMLElement)) return;
+
+    codeWrapper.style.setProperty(
+      "--rd-preview-expanded-height",
+      `${scrollArea.scrollHeight}px`,
+    );
+  };
+
+  const initComponentPreview = (root) => {
     if (!(root instanceof HTMLElement)) return;
 
     const codeWrapper = root.querySelector(".rd-component-preview__code");
@@ -252,30 +257,66 @@ const isInitiallyExpanded = shouldShowAllCode || totalLineCount <= visibleLines;
       return;
     }
 
-    const syncExpandedHeight = () => {
-      codeWrapper.style.setProperty(
-        "--rd-preview-expanded-height",
-        `${scrollArea.scrollHeight}px`,
-      );
-    };
+    syncExpandedHeight(root);
+
+    if (root.dataset.rdComponentPreviewInitialized === "true") return;
+    root.dataset.rdComponentPreviewInitialized = "true";
 
-    syncExpandedHeight();
+    const visibleLines = parsePositiveInteger(
+      root.dataset.rdPreviewVisibleLines,
+      5,
+    );
+    const totalLineCount = parsePositiveInteger(
+      root.dataset.rdPreviewTotalLineCount,
+      visibleLines,
+    );
+    const shouldShowAllCode = root.dataset.rdPreviewShowAllCode === "true";
 
     if (shouldShowAllCode || totalLineCount <= visibleLines) {
       codeWrapper.dataset.rdPreviewExpanded = "true";
-      window.addEventListener("resize", syncExpandedHeight, { passive: true });
       return;
     }
 
     const setExpanded = () => {
-      syncExpandedHeight();
+      syncExpandedHeight(root);
       codeWrapper.dataset.rdPreviewExpanded = "true";
     };
 
     expandButton.addEventListener("click", () => {
       setExpanded();
     });
+  };
+
+  const initComponentPreviews = () => {
+    document.querySelectorAll(previewRootSelector).forEach((root) => {
+      initComponentPreview(root);
+    });
+  };
+
+  const schedulePreviewHeightSync = () => {
+    if (window[previewControlsKey]?.resizeFrameId) return;
+
+    window[previewControlsKey].resizeFrameId = window.requestAnimationFrame(
+      () => {
+        window[previewControlsKey].resizeFrameId = 0;
+        document.querySelectorAll(previewRootSelector).forEach((root) => {
+          if (root instanceof HTMLElement) syncExpandedHeight(root);
+        });
+      },
+    );
+  };
+
+  window[previewControlsKey] = window[previewControlsKey] || {};
+  window[previewControlsKey].init = initComponentPreviews;
+
+  if (!window[previewControlsKey].installed) {
+    window[previewControlsKey].installed = true;
+    window[previewControlsKey].resizeFrameId = 0;
+    window.addEventListener("resize", schedulePreviewHeightSync, {
+      passive: true,
+    });
+    document.addEventListener("astro:page-load", initComponentPreviews);
+  }
 
-    window.addEventListener("resize", syncExpandedHeight, { passive: true });
-  })();
+  initComponentPreviews();
 </script>

package/template/src/layouts/Layout.astro

@@ -17,6 +17,7 @@ import { resolvePageDescription } from "../lib/page-description";
 interface Props {
   pageTitle?: string;
   pageDescription?: string;
+  hasMarkdownAlternate?: boolean;
 }
 
 type TabsPresentation = "topbar" | "sidebar";
@@ -36,7 +37,13 @@ function routePathToOgImagePath(routePath: string): string {
   return `/_og/images/${normalizedRoutePath.slice(1, -1)}.png`;
 }
 
-const { pageTitle, pageDescription } = Astro.props as Props;
+function routePathToMarkdownPath(routePath: string): string {
+  const normalizedRoutePath = routePath.replace(/^\/+/, "").replace(/\/+$/, "");
+  return normalizedRoutePath ? `/${normalizedRoutePath}.md` : "/index.md";
+}
+
+const { pageTitle, pageDescription, hasMarkdownAlternate = false } =
+  Astro.props as Props;
 const config = await getConfig();
 const favicon = getFaviconConfig();
 const neutralPaletteCss = getDocsThemeCss(config.theme);
@@ -56,6 +63,12 @@ const canonicalUrl = new URL(
   prependBasePath(routePathname),
   Astro.site ?? Astro.url,
 ).toString();
+const markdownUrl = hasMarkdownAlternate
+  ? new URL(
+      prependBasePath(routePathToMarkdownPath(routePathname)),
+      Astro.site ?? Astro.url,
+    ).toString()
+  : undefined;
 const ogImageUrl = new URL(
   resolveStaticAssetUrl(routePathToOgImagePath(routePathname)),
   Astro.site ?? Astro.url,
@@ -288,6 +301,16 @@ const hasTopbarNavigationTabs =
     />
     <meta name="generator" content={Astro.generator} />
     <link rel="canonical" href={canonicalUrl} />
+    {
+      markdownUrl && (
+        <link
+          rel="alternate"
+          type="text/markdown"
+          href={markdownUrl}
+          title="Markdown version"
+        />
+      )
+    }
     <meta property="og:url" content={canonicalUrl} />
     <meta property="og:type" content="website" />
     <meta property="og:site_name" content={config.title} />

package/template/src/lib/assistant-embed-script.ts

@@ -7,10 +7,7 @@ import {
 } from "./assistant-chrome";
 import { getDocsBasePath, withBasePath } from "./base-path";
 import { getFaviconConfig } from "./favicon";
-import {
-  getDocsBaseColorShade,
-  getThemeForegroundColor,
-} from "./theme-css";
+import { getDocsBaseColorShade, getThemeForegroundColor } from "./theme-css";
 import { type DocsConfig, type ThemeColorByMode } from "./validation";
 
 type AssistantColorByMode = {
@@ -141,7 +138,9 @@ function getAssistantButtonColor(
     config.assistant?.button?.color,
     mode,
   );
-  return configuredAssistantColor ?? getDefaultAssistantButtonColor(config, mode);
+  return (
+    configuredAssistantColor ?? getDefaultAssistantButtonColor(config, mode)
+  );
 }
 
 export function getAssistantLauncherIconConfig(
@@ -905,6 +904,7 @@ export function renderAssistantEmbedScript(config: DocsConfig): string {
     }
 
     updatePanelLayout();
+    postPanelPageContextMessage();
 
     try {
       panelFrame.contentWindow.postMessage(
@@ -916,6 +916,28 @@ export function renderAssistantEmbedScript(config: DocsConfig): string {
     }
   }
 
+  function postPanelPageContextMessage(requestId) {
+    if (!panelFrame || !panelFrame.contentWindow) {
+      return;
+    }
+
+    var message = {
+      type: "assistant-embed:set-page-context",
+      hostname: window.location.hostname || null,
+      pagePath: window.location.pathname || "/",
+    };
+
+    if (typeof requestId === "string" && requestId.length > 0) {
+      message.requestId = requestId;
+    }
+
+    try {
+      panelFrame.contentWindow.postMessage(message, getPanelTargetOrigin());
+    } catch {
+      // Ignore cross-window messaging failures.
+    }
+  }
+
   function getPanelTargetOrigin() {
     if (!panelFrame || !panelFrame.src) {
       return "*";
@@ -1154,6 +1176,7 @@ export function renderAssistantEmbedScript(config: DocsConfig): string {
     frame.addEventListener("load", function () {
       postPanelThemeMessage();
       postPanelLayoutMessage();
+      postPanelPageContextMessage();
       if (isOpen) {
         notifyPanelOpened();
       }
@@ -1293,6 +1316,11 @@ export function renderAssistantEmbedScript(config: DocsConfig): string {
 
     if (event.data.type === "assistant-embed:get-panel-layout") {
       postPanelLayoutMessage();
+      return;
+    }
+
+    if (event.data.type === "assistant-embed:get-page-context") {
+      postPanelPageContextMessage(event.data.requestId);
     }
   });