deepspace 0.10.0 → 0.10.2

package/dist/{chunk-DQ4G6VL6.js → chunk-T7V4GUIN.js}

@@ -1,11 +1,11 @@
-// src/docs/runtime/app.tsx
+// src/documentation/runtime/app.tsx
 import {
   useCallback,
   useEffect as useEffect7,
   useState as useState6
 } from "react";
 
-// src/docs/runtime/article.tsx
+// src/documentation/runtime/article.tsx
 import {
   useEffect as useEffect2,
   useMemo,
@@ -13,7 +13,76 @@ import {
   useState as useState2
 } from "react";
 
-// src/docs/runtime/browser.ts
+// src/documentation/types.ts
+var DocumentationError = class extends Error {
+  code;
+  diagnostics;
+  constructor(message, code, diagnostics = []) {
+    super(message);
+    this.name = "DocumentationError";
+    this.code = code;
+    this.diagnostics = diagnostics;
+  }
+};
+
+// src/documentation/routing.ts
+function collapseRoute(value) {
+  let route = `/${value}`.replace(/\/{2,}/g, "/");
+  if (route.length > 1) route = route.replace(/\/$/, "");
+  return route;
+}
+function normalizeRoute(value) {
+  assertSafeRoute(value);
+  let route = collapseRoute(value);
+  route = route.replace(/\.(?:md|mdx)$/i, "");
+  route = route.replace(/\/index$/i, "");
+  return route || "/";
+}
+function normalizeDocumentationBasePath(value) {
+  if (!value || value === "/") return "";
+  const normalized = normalizeRoute(value);
+  if (normalized === "/_documentation") {
+    throw new DocumentationError("The internal /_documentation namespace cannot be a public documentation base", "documentation_base_invalid");
+  }
+  return normalized;
+}
+function documentationPublicPath(basePath, path) {
+  const base = normalizeDocumentationBasePath(basePath);
+  const suffix = path.startsWith("/") ? path : `/${path}`;
+  if (suffix === "/") return base || "/";
+  return `${base}${suffix}`;
+}
+function documentationLogicalPath(basePath, pathname) {
+  const base = normalizeDocumentationBasePath(basePath);
+  if (!base) return pathname.startsWith("/") ? pathname : `/${pathname}`;
+  if (pathname === base) return "/";
+  if (!pathname.startsWith(`${base}/`)) return null;
+  return pathname.slice(base.length) || "/";
+}
+function assertSafeRoute(value) {
+  if (value.includes("\\") || value.includes("\0")) throw unsafeRoute(value);
+  let decoded = value;
+  for (let pass = 0; pass < 5; pass++) {
+    let next;
+    try {
+      next = decodeURIComponent(decoded);
+    } catch {
+      throw unsafeRoute(value);
+    }
+    if (next === decoded) break;
+    decoded = next;
+  }
+  if (decoded.includes("\\") || decoded.includes("\0") || decoded.split("/").some((segment) => segment === "." || segment === "..")) throw unsafeRoute(value);
+}
+function unsafeRoute(value) {
+  return new DocumentationError(
+    `Documentation route contains an unsafe path segment: ${value}`,
+    "documentation_route_invalid",
+    [{ code: "route_path_escape", message: value }]
+  );
+}
+
+// src/documentation/runtime/browser.ts
 async function writeClipboardText(text) {
   try {
     if (navigator.clipboard?.writeText) {
@@ -61,7 +130,7 @@ function errorMessage(error) {
   return error instanceof Error ? error.message : String(error);
 }
 
-// src/docs/runtime/icons.tsx
+// src/documentation/runtime/icons.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 function Icon({ children, ...props }) {
   return /* @__PURE__ */ jsx(
@@ -80,7 +149,7 @@ function Icon({ children, ...props }) {
 function OrbitMark(props) {
   return /* @__PURE__ */ jsxs(Icon, { viewBox: "0 0 32 32", ...props, children: [
     /* @__PURE__ */ jsx("path", { d: "M16 2.5c.5 7.7 5.8 13 13.5 13.5-7.7.5-13 5.8-13.5 13.5C15.5 21.8 10.2 16.5 2.5 16 10.2 15.5 15.5 10.2 16 2.5Z", fill: "currentColor" }),
-    /* @__PURE__ */ jsx("circle", { cx: "16", cy: "16", fill: "var(--docs-bg)", r: "3.25" }),
+    /* @__PURE__ */ jsx("circle", { cx: "16", cy: "16", fill: "var(--documentation-bg)", r: "3.25" }),
     /* @__PURE__ */ jsx("path", { d: "M4.5 22.7c5.6-2 16.4-8.3 22.7-14.1", opacity: ".45", stroke: "currentColor", strokeLinecap: "round" })
   ] });
 }
@@ -169,7 +238,7 @@ function StopIcon(props) {
   return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("rect", { x: "6", y: "6", width: "12", height: "12", rx: "2", fill: "currentColor" }) });
 }
 
-// src/docs/runtime/page-actions.tsx
+// src/documentation/runtime/page-actions.tsx
 import { useEffect, useRef, useState } from "react";
 import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function PageActions({
@@ -179,7 +248,7 @@ function PageActions({
   const [copied, setCopied] = useState(null);
   const detailsRef = useRef(null);
   const actions = data.config.contextual.actions.filter((action) => {
-    if ((action === "copy" || action === "view" || action === "chatgpt" || action === "claude") && data.page.route === "/404") return false;
+    if (data.page.route === "/404") return false;
     if (action === "assistant" && data.config.assistant.access === "disabled") return false;
     if ((action === "mcp" || action === "add-mcp" || action === "cursor" || action === "vscode") && data.config.mcp.access !== "public") return false;
     return true;
@@ -213,18 +282,24 @@ function PageActions({
     if (!response.ok) return;
     await writeClipboardText(await response.text());
     markCopied("copy");
+    closeMenu();
   };
   const copyMcp = async () => {
-    await writeClipboardText(new URL("/mcp", window.location.origin).toString());
+    await writeClipboardText(new URL(documentationPublicPath(data.basePath, "/mcp"), window.location.origin).toString());
     markCopied("mcp");
+    closeMenu();
   };
   const copyMcpInstall = async () => {
-    const mcpUrl = new URL("/mcp", window.location.origin).toString();
+    const mcpUrl = new URL(documentationPublicPath(data.basePath, "/mcp"), window.location.origin).toString();
     await writeClipboardText(`npx add-mcp ${mcpUrl}`);
     markCopied("add-mcp");
+    closeMenu();
   };
   const closeMenu = () => {
-    if (detailsRef.current) detailsRef.current.open = false;
+    const details = detailsRef.current;
+    if (!details?.open) return;
+    details.open = false;
+    details.querySelector("summary")?.focus();
   };
   const openAiContext = (provider) => {
     const markdownUrl = new URL(data.page.markdownUrl, window.location.origin).toString();
@@ -235,8 +310,8 @@ function PageActions({
     closeMenu();
   };
   const openMcpEditor = (editor) => {
-    const mcpUrl = new URL("/mcp", window.location.origin).toString();
-    const name = data.config.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "") || "docs";
+    const mcpUrl = new URL(documentationPublicPath(data.basePath, "/mcp"), window.location.origin).toString();
+    const name = data.config.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "") || "documentation";
     if (editor === "cursor") {
       const config = window.btoa(JSON.stringify({ url: mcpUrl }));
       window.location.href = `cursor://anysphere.cursor-deeplink/mcp/install?name=${encodeURIComponent(name)}&config=${encodeURIComponent(config)}`;
@@ -247,12 +322,12 @@ function PageActions({
     closeMenu();
   };
   const content = (icon, label, description, menuItem, external = false) => menuItem ? /* @__PURE__ */ jsxs2(Fragment, { children: [
-    /* @__PURE__ */ jsx2("span", { className: "docs-contextual-action-icon", children: icon }),
-    /* @__PURE__ */ jsxs2("span", { className: "docs-contextual-action-copy", children: [
+    /* @__PURE__ */ jsx2("span", { className: "documentation-contextual-action-icon", children: icon }),
+    /* @__PURE__ */ jsxs2("span", { className: "documentation-contextual-action-copy", children: [
       /* @__PURE__ */ jsx2("strong", { children: label }),
       /* @__PURE__ */ jsx2("small", { children: description })
     ] }),
-    external && /* @__PURE__ */ jsx2(ExternalIcon, { className: "docs-contextual-action-external" })
+    external && /* @__PURE__ */ jsx2(ExternalIcon, { className: "documentation-contextual-action-external" })
   ] }) : /* @__PURE__ */ jsxs2(Fragment, { children: [
     icon,
     label
@@ -287,16 +362,16 @@ function PageActions({
     const label = copied === action ? "Page copied" : "Copy page";
     return /* @__PURE__ */ jsx2("button", { role, type: "button", onClick: copyPage, children: content(copied === action ? /* @__PURE__ */ jsx2(CheckIcon, {}) : /* @__PURE__ */ jsx2(CopyIcon, {}), label, "Copy page as Markdown for LLMs", menuItem) }, action);
   };
-  return /* @__PURE__ */ jsxs2("div", { className: "docs-contextual-actions", "aria-label": "Page actions", children: [
-    /* @__PURE__ */ jsx2("div", { className: "docs-contextual-primary", "aria-live": "polite", children: renderAction(primary) }),
+  return /* @__PURE__ */ jsxs2("div", { className: "documentation-contextual-actions", "aria-label": "Page actions", children: [
+    /* @__PURE__ */ jsx2("div", { className: "documentation-contextual-primary", "aria-live": "polite", children: renderAction(primary) }),
     actions.length > 0 && /* @__PURE__ */ jsxs2("details", { ref: detailsRef, children: [
       /* @__PURE__ */ jsx2("summary", { "aria-label": "More page actions", children: /* @__PURE__ */ jsx2(ChevronDownIcon, {}) }),
-      /* @__PURE__ */ jsx2("div", { "aria-label": "More page actions", className: "docs-contextual-menu", role: "menu", children: actions.map((action) => renderAction(action, true)) })
+      /* @__PURE__ */ jsx2("div", { "aria-label": "More page actions", className: "documentation-contextual-menu", role: "menu", children: actions.map((action) => renderAction(action, true)) })
     ] })
   ] });
 }
 
-// src/docs/runtime/article.tsx
+// src/documentation/runtime/article.tsx
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 function Article({
   children,
@@ -305,27 +380,27 @@ function Article({
 }) {
   const articleRef = useRef2(null);
   useArticleEnhancements(articleRef, data, onAssistantOpen);
-  return /* @__PURE__ */ jsxs3("article", { className: "docs-article", ref: articleRef, children: [
+  return /* @__PURE__ */ jsxs3("article", { className: "documentation-article", ref: articleRef, children: [
     /* @__PURE__ */ jsx3(Breadcrumbs, { items: data.breadcrumbs }),
-    /* @__PURE__ */ jsxs3("header", { className: "docs-article-header", children: [
-      /* @__PURE__ */ jsxs3("div", { className: "docs-article-meta", children: [
-        data.config.theme.eyebrowStyle !== "none" && /* @__PURE__ */ jsx3("div", { className: "docs-eyebrow", children: data.page.kind === "openapi" ? "API reference" : data.config.theme.eyebrowStyle === "breadcrumbs" ? data.breadcrumbs.join(" / ") : data.breadcrumbs[0] ?? "Documentation" }),
+    /* @__PURE__ */ jsxs3("header", { className: "documentation-article-header", children: [
+      /* @__PURE__ */ jsxs3("div", { className: "documentation-article-meta", children: [
+        data.config.theme.eyebrowStyle !== "none" && /* @__PURE__ */ jsx3("div", { className: "documentation-eyebrow", children: data.page.kind === "openapi" ? "API reference" : data.config.theme.eyebrowStyle === "breadcrumbs" ? data.breadcrumbs.join(" / ") : data.breadcrumbs[0] ?? "Documentation" }),
         /* @__PURE__ */ jsx3(PageActions, { data, onAssistantOpen })
       ] }),
       /* @__PURE__ */ jsx3("h1", { children: data.page.title }),
-      data.page.description && /* @__PURE__ */ jsx3("p", { className: "docs-lede", children: data.page.description })
+      data.page.description && /* @__PURE__ */ jsx3("p", { className: "documentation-lede", children: data.page.description })
     ] }),
-    children ?? /* @__PURE__ */ jsx3("div", { className: "docs-prose", dangerouslySetInnerHTML: { __html: data.page.html } }),
+    children ?? /* @__PURE__ */ jsx3("div", { className: "documentation-prose", dangerouslySetInnerHTML: { __html: data.page.html } }),
     data.page.openapi?.playground && /* @__PURE__ */ jsx3(ApiPlayground, { operation: data.page.openapi }),
-    /* @__PURE__ */ jsxs3("nav", { className: "docs-pagination", "aria-label": "Page navigation", children: [
-      data.previous ? /* @__PURE__ */ jsxs3("a", { rel: "prev", href: data.previous.route, children: [
+    /* @__PURE__ */ jsxs3("nav", { className: "documentation-pagination", "aria-label": "Page navigation", children: [
+      data.previous ? /* @__PURE__ */ jsxs3("a", { rel: "prev", href: documentationPublicPath(data.basePath, data.previous.route), children: [
         /* @__PURE__ */ jsx3("small", { children: "Previous" }),
         /* @__PURE__ */ jsxs3("span", { children: [
           /* @__PURE__ */ jsx3(ChevronRightIcon, { className: "is-back" }),
           data.previous.title
         ] })
       ] }) : /* @__PURE__ */ jsx3("span", {}),
-      data.next ? /* @__PURE__ */ jsxs3("a", { rel: "next", href: data.next.route, children: [
+      data.next ? /* @__PURE__ */ jsxs3("a", { rel: "next", href: documentationPublicPath(data.basePath, data.next.route), children: [
         /* @__PURE__ */ jsx3("small", { children: "Next" }),
         /* @__PURE__ */ jsxs3("span", { children: [
           data.next.title,
@@ -336,7 +411,7 @@ function Article({
   ] });
 }
 function Breadcrumbs({ items }) {
-  return /* @__PURE__ */ jsx3("nav", { className: "docs-breadcrumbs", "aria-label": "Breadcrumb", children: items.map((item, index) => /* @__PURE__ */ jsxs3("span", { children: [
+  return /* @__PURE__ */ jsx3("nav", { className: "documentation-breadcrumbs", "aria-label": "Breadcrumb", children: items.map((item, index) => /* @__PURE__ */ jsxs3("span", { children: [
     index > 0 && /* @__PURE__ */ jsx3(ChevronRightIcon, {}),
     item
   ] }, `${item}:${items.slice(0, index + 1).join("/")}`)) });
@@ -360,7 +435,7 @@ function ContextRail({
     elements.forEach((element) => observer.observe(element));
     return () => observer.disconnect();
   }, [headings]);
-  return /* @__PURE__ */ jsx3("aside", { className: "docs-context-rail", "aria-label": "Page context", children: headings.length > 0 && /* @__PURE__ */ jsxs3("nav", { className: "docs-outline", "aria-label": "On this page", children: [
+  return /* @__PURE__ */ jsx3("aside", { className: "documentation-context-rail", "aria-label": "Page context", children: headings.length > 0 && /* @__PURE__ */ jsxs3("nav", { className: "documentation-outline", "aria-label": "On this page", children: [
     /* @__PURE__ */ jsx3("h2", { children: "On this page" }),
     headings.map((heading) => /* @__PURE__ */ jsx3(
       "a",
@@ -403,8 +478,8 @@ ${text}`);
       setSending(false);
     }
   };
-  return /* @__PURE__ */ jsxs3("section", { className: "docs-playground", "data-playground": true, children: [
-    /* @__PURE__ */ jsxs3("div", { className: "docs-playground-title", children: [
+  return /* @__PURE__ */ jsxs3("section", { className: "documentation-playground", "data-playground": true, children: [
+    /* @__PURE__ */ jsxs3("div", { className: "documentation-playground-title", children: [
       /* @__PURE__ */ jsxs3("div", { children: [
         /* @__PURE__ */ jsx3("span", { className: `method method-${operation.method.toLowerCase()}`, children: operation.method }),
         /* @__PURE__ */ jsx3("strong", { children: "Try this operation" })
@@ -429,10 +504,10 @@ function useArticleEnhancements(articleRef, data, onAssistantOpen) {
     const article = articleRef.current;
     if (!article) return;
     const cleanups = [];
-    article.querySelectorAll(".docs-prose pre").forEach((pre) => {
-      if (pre.querySelector(".docs-code-actions")) return;
+    article.querySelectorAll(".documentation-prose pre").forEach((pre) => {
+      if (pre.querySelector(".documentation-code-actions")) return;
       const controls = document.createElement("div");
-      controls.className = "docs-code-actions";
+      controls.className = "documentation-code-actions";
       const copy = document.createElement("button");
       copy.type = "button";
       copy.setAttribute("aria-label", "Copy code");
@@ -468,11 +543,11 @@ ${code}`);
       });
     });
     article.querySelectorAll("[data-tab-group]").forEach((group, groupIndex) => {
-      if (group.querySelector(":scope > .docs-tab-buttons")) return;
+      if (group.querySelector(":scope > .documentation-tab-buttons")) return;
       const tabs = Array.from(group.querySelectorAll(":scope > [data-tab]"));
       if (tabs.length === 0) return;
       const controls = document.createElement("div");
-      controls.className = "docs-tab-buttons";
+      controls.className = "documentation-tab-buttons";
       controls.setAttribute("role", "tablist");
       const labels = tabs.map((tab, tabIndex) => tab.dataset.tabTitle ?? `Tab ${tabIndex + 1}`);
       const activate = (activeIndex, broadcast = false) => {
@@ -487,8 +562,8 @@ ${code}`);
         if (broadcast) {
           const label = labels[activeIndex];
           if (label) {
-            safeStorageSet("deepspace-docs-tab-selection", label);
-            document.dispatchEvent(new CustomEvent("deepspace-docs-tab-change", {
+            safeStorageSet("deepspace-documentation-tab-selection", label);
+            document.dispatchEvent(new CustomEvent("deepspace-documentation-tab-change", {
               detail: { label, source: group }
             }));
           }
@@ -497,7 +572,7 @@ ${code}`);
       tabs.forEach((tab, tabIndex) => {
         const button = document.createElement("button");
         button.type = "button";
-        button.id = `docs-tab-${groupIndex}-${tabIndex}`;
+        button.id = `documentation-tab-${groupIndex}-${tabIndex}`;
         button.setAttribute("role", "tab");
         button.textContent = labels[tabIndex];
         tab.setAttribute("aria-labelledby", button.id);
@@ -517,7 +592,7 @@ ${code}`);
           button.removeEventListener("keydown", keydown);
         });
       });
-      const title = group.querySelector(":scope > .docs-code-group-title");
+      const title = group.querySelector(":scope > .documentation-code-group-title");
       if (title) group.insertBefore(controls, title.nextSibling);
       if (!title) group.insertBefore(controls, group.firstChild);
       const sync = (event) => {
@@ -526,12 +601,12 @@ ${code}`);
         const matchingIndex = labels.findIndex((label) => label === detail.label);
         if (matchingIndex >= 0) activate(matchingIndex);
       };
-      document.addEventListener("deepspace-docs-tab-change", sync);
-      const stored = safeStorageGet("deepspace-docs-tab-selection");
+      document.addEventListener("deepspace-documentation-tab-change", sync);
+      const stored = safeStorageGet("deepspace-documentation-tab-selection");
       const initial = stored ? labels.findIndex((label) => label === stored) : -1;
       activate(initial >= 0 ? initial : 0);
       cleanups.push(() => {
-        document.removeEventListener("deepspace-docs-tab-change", sync);
+        document.removeEventListener("deepspace-documentation-tab-change", sync);
         controls.remove();
       });
     });
@@ -539,7 +614,7 @@ ${code}`);
   }, [articleRef, data.config.assistant.access, data.page.route, data.page.title, onAssistantOpen]);
 }
 
-// src/docs/runtime/assistant.tsx
+// src/documentation/runtime/assistant.tsx
 import {
   useEffect as useEffect4,
   useRef as useRef3,
@@ -562,8 +637,15 @@ function parseSseLine(line) {
   }
 }
 
-// src/docs/runtime/assistant-history.ts
-function completedDocsAssistantHistory(messages, maxMessages = 12) {
+// src/documentation/text.ts
+function documentationSubject(name) {
+  const normalized = name.trim();
+  if (!normalized || /^documentation$/i.test(normalized)) return "documentation";
+  return /(?:\bdocs?|documentation)$/i.test(normalized) ? normalized : `${normalized} documentation`;
+}
+
+// src/documentation/runtime/assistant-transcript.ts
+function completedDocumentationAssistantTranscript(messages, maxMessages = 12) {
   const pairs = [];
   for (let index = 0; index < messages.length - 1; index += 1) {
     const user = messages[index];
@@ -583,7 +665,7 @@ function completedDocsAssistantHistory(messages, maxMessages = 12) {
   return pairs.slice(-pairLimit).flat();
 }
 
-// src/docs/runtime/dialog.ts
+// src/documentation/runtime/dialog.ts
 import { useEffect as useEffect3 } from "react";
 function useDialogFocus(open, ref, onClose, trap = true, restoreId) {
   useEffect3(() => {
@@ -625,54 +707,58 @@ function useDialogFocus(open, ref, onClose, trap = true, restoreId) {
   }, [onClose, open, ref, restoreId, trap]);
 }
 
-// src/docs/runtime/assistant.tsx
+// src/documentation/runtime/assistant.tsx
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function AssistantLauncher({
+  input,
   name,
+  onInputChange,
   onOpen,
   onSubmit,
   open
 }) {
-  const [input, setInput] = useState3("");
+  const subject = documentationSubject(name);
   const submit = (event) => {
     event.preventDefault();
     const question = input.trim();
     if (!question) return;
-    setInput("");
     onSubmit(question);
   };
   if (open) return null;
   return /* @__PURE__ */ jsxs4(
     "form",
     {
-      className: "docs-assistant-launcher",
-      id: "deepspace-docs-assistant-launcher",
+      className: "documentation-assistant-launcher",
+      id: "deepspace-documentation-assistant-launcher",
       onSubmit: submit,
       children: [
-        /* @__PURE__ */ jsxs4("button", { className: "docs-launcher-agent", type: "button", onClick: onOpen, "aria-label": `Open the ${name} documentation agent`, children: [
+        /* @__PURE__ */ jsxs4("button", { className: "documentation-launcher-agent", type: "button", onClick: onOpen, "aria-label": `Open the ${subject} agent`, children: [
           "Ask ",
           name
         ] }),
         /* @__PURE__ */ jsx4(
           "input",
           {
-            "aria-label": `Ask the ${name} documentation agent`,
-            id: "deepspace-docs-assistant-launcher-input",
+            "aria-label": `Ask the ${subject} agent`,
+            id: "deepspace-documentation-assistant-launcher-input",
             maxLength: 4e3,
-            onChange: (event) => setInput(event.target.value),
+            onChange: (event) => onInputChange(event.target.value),
             placeholder: "Ask anything\u2026",
             value: input
           }
         ),
-        /* @__PURE__ */ jsx4("button", { className: "docs-launcher-send", type: "submit", disabled: !input.trim(), "aria-label": "Send question to documentation agent", children: /* @__PURE__ */ jsx4(SendIcon, {}) })
+        /* @__PURE__ */ jsx4("button", { className: "documentation-launcher-send", type: "submit", disabled: !input.trim(), "aria-label": "Send question to documentation agent", children: /* @__PURE__ */ jsx4(SendIcon, {}) })
       ]
     }
   );
 }
-function DocsAssistant({
+function DocumentationAssistant({
   access,
+  basePath,
+  input,
   name,
   onClose,
+  onInputChange,
   open,
   route,
   seed,
@@ -684,17 +770,15 @@ function DocsAssistant({
   const abortRef = useRef3(null);
   const queuedQuestionRef = useRef3(null);
   const handledSeedRef = useRef3(0);
-  const [input, setInput] = useState3(seed.value);
   const [messages, setMessages] = useState3([
-    { id: "welcome", role: "assistant", text: `I can search the ${name} documentation and cite the exact pages I use.` }
+    { id: "welcome", role: "assistant", text: `I can search the ${documentationSubject(name)} and cite the exact pages I use.` }
   ]);
   const [sending, setSending] = useState3(false);
-  useDialogFocus(open, panelRef, onClose, false, "deepspace-docs-assistant-launcher-input");
+  useDialogFocus(open, panelRef, onClose, false, "deepspace-documentation-assistant-launcher-input");
   useEffect4(() => {
     if (!open || seed.id === 0 || handledSeedRef.current === seed.id) return;
     handledSeedRef.current = seed.id;
-    setInput(seed.value);
-    if (!seed.submit || !seed.value.trim()) return;
+    if (!seed.submit || !seed.value?.trim()) return;
     queuedQuestionRef.current = seed.value;
     const frame = window.requestAnimationFrame(() => formRef.current?.requestSubmit());
     return () => window.cancelAnimationFrame(frame);
@@ -710,8 +794,8 @@ function DocsAssistant({
     const question = (queuedQuestionRef.current ?? input).trim();
     queuedQuestionRef.current = null;
     if (!question || sending) return;
-    const history = completedDocsAssistantHistory(messages);
-    setInput("");
+    const transcript = completedDocumentationAssistantTranscript(messages);
+    onInputChange("");
     setSending(true);
     const userId = `user-${Date.now()}`;
     const answerId = `assistant-${Date.now()}`;
@@ -728,8 +812,7 @@ function DocsAssistant({
     }, 12e4);
     try {
       const headers = {
-        "Content-Type": "application/json",
-        "x-deepspace-surface": "docs"
+        "Content-Type": "application/json"
       };
       if (access === "authenticated") {
         const tokenResponse = await fetch("/api/auth/token", { method: "POST", credentials: "include", headers: { "Content-Type": "application/json" } });
@@ -737,10 +820,10 @@ function DocsAssistant({
         if (!tokenData?.token) throw new Error("Sign in to use the documentation assistant.");
         headers.Authorization = `Bearer ${tokenData.token}`;
       }
-      const response = await fetch("/api/ai/docs", {
+      const response = await fetch(documentationPublicPath(basePath, "/api/ai"), {
         method: "POST",
         headers,
-        body: JSON.stringify({ question, route, messages: history }),
+        body: JSON.stringify({ question, route, messages: transcript }),
         signal: controller.signal
       });
       if (!response.ok || !response.body) {
@@ -758,7 +841,7 @@ function DocsAssistant({
           answer += data.delta;
           setMessages((current) => current.map((message) => message.id === answerId ? { ...message, text: answer, state: "streaming", status: void 0 } : message));
         } else if (data.type === "tool-input-available") {
-          const status = data.toolName === "docs_read" ? "Reading the relevant source pages\u2026" : "Searching this documentation\u2026";
+          const status = data.toolName === "documentation_read" ? "Reading the relevant source pages\u2026" : "Searching this documentation\u2026";
           setMessages((current) => current.map((message) => message.id === answerId ? { ...message, status } : message));
         } else if (data.type === "tool-output-available") {
           setMessages((current) => current.map((message) => message.id === answerId ? { ...message, status: "Reviewing the source material\u2026" } : message));
@@ -792,14 +875,14 @@ function DocsAssistant({
     "aside",
     {
       "aria-label": "Documentation assistant",
-      className: "docs-assistant",
-      id: "deepspace-docs-assistant",
+      className: "documentation-assistant",
+      id: "deepspace-documentation-assistant",
       ref: panelRef,
       role: "complementary",
       children: [
         /* @__PURE__ */ jsxs4("header", { children: [
           /* @__PURE__ */ jsx4("div", { children: /* @__PURE__ */ jsxs4("span", { children: [
-            /* @__PURE__ */ jsxs4("strong", { id: "deepspace-docs-assistant-title", children: [
+            /* @__PURE__ */ jsxs4("strong", { id: "deepspace-documentation-assistant-title", children: [
               "Ask ",
               name
             ] }),
@@ -807,34 +890,34 @@ function DocsAssistant({
           ] }) }),
           /* @__PURE__ */ jsx4("button", { type: "button", onClick: onClose, "aria-label": "Close documentation assistant", children: /* @__PURE__ */ jsx4(CloseIcon, {}) })
         ] }),
-        /* @__PURE__ */ jsxs4("div", { className: "docs-assistant-messages", ref: messagesRef, "aria-live": "polite", children: [
-          messages.map((message) => /* @__PURE__ */ jsx4("div", { className: `docs-assistant-message is-${message.role}${message.state ? ` is-${message.state}` : ""}`, children: /* @__PURE__ */ jsxs4("div", { children: [
+        /* @__PURE__ */ jsxs4("div", { className: "documentation-assistant-messages", ref: messagesRef, "aria-live": "polite", children: [
+          messages.map((message) => /* @__PURE__ */ jsx4("div", { className: `documentation-assistant-message is-${message.role}${message.state ? ` is-${message.state}` : ""}`, children: /* @__PURE__ */ jsxs4("div", { children: [
             message.role === "assistant" ? /* @__PURE__ */ jsx4(AssistantMarkdown, { value: message.text }) : message.text,
-            message.state === "streaming" && !message.text && /* @__PURE__ */ jsxs4("span", { className: "docs-assistant-activity", role: "status", children: [
+            message.state === "streaming" && !message.text && /* @__PURE__ */ jsxs4("span", { className: "documentation-assistant-activity", role: "status", children: [
               /* @__PURE__ */ jsx4("span", { "aria-hidden": "true" }),
               message.status ?? "Working\u2026"
             ] })
           ] }) }, message.id)),
-          messages.length === 1 && /* @__PURE__ */ jsxs4("div", { className: "docs-assistant-suggestions", children: [
+          messages.length === 1 && /* @__PURE__ */ jsxs4("div", { className: "documentation-assistant-suggestions", children: [
             /* @__PURE__ */ jsx4("p", { children: "Try asking" }),
-            defaults.map((suggestion) => /* @__PURE__ */ jsx4("button", { type: "button", onClick: () => setInput(suggestion), children: suggestion }, suggestion))
+            defaults.map((suggestion) => /* @__PURE__ */ jsx4("button", { type: "button", onClick: () => onInputChange(suggestion), children: suggestion }, suggestion))
           ] })
         ] }),
-        /* @__PURE__ */ jsxs4("form", { className: "docs-assistant-composer", onSubmit: submit, ref: formRef, children: [
+        /* @__PURE__ */ jsxs4("form", { className: "documentation-assistant-composer", onSubmit: submit, ref: formRef, children: [
           /* @__PURE__ */ jsx4(
             "textarea",
             {
               "aria-label": "Ask a documentation question",
               "data-autofocus": true,
               maxLength: 4e3,
-              onChange: (event) => setInput(event.target.value),
+              onChange: (event) => onInputChange(event.target.value),
               onKeyDown: (event) => {
                 if (event.key === "Enter" && !event.shiftKey) {
                   event.preventDefault();
                   void submit();
                 }
               },
-              placeholder: "Ask a question about these docs",
+              placeholder: "Ask a question about this documentation",
               rows: 2,
               value: input
             }
@@ -866,7 +949,7 @@ function AssistantMarkdown({ value }) {
     cursor = index + match[0].length;
   }
   if (cursor < value.length) blocks.push(...renderAssistantText(value.slice(cursor), `text-${cursor}`));
-  return /* @__PURE__ */ jsx4("div", { className: "docs-assistant-markdown", children: blocks });
+  return /* @__PURE__ */ jsx4("div", { className: "documentation-assistant-markdown", children: blocks });
 }
 function AssistantCodeBlock({ code, language }) {
   const [copied, setCopied] = useState3(false);
@@ -875,7 +958,7 @@ function AssistantCodeBlock({ code, language }) {
     setCopied(true);
     window.setTimeout(() => setCopied(false), 1400);
   };
-  return /* @__PURE__ */ jsxs4("figure", { className: "docs-assistant-code", children: [
+  return /* @__PURE__ */ jsxs4("figure", { className: "documentation-assistant-code", children: [
     /* @__PURE__ */ jsxs4("figcaption", { children: [
       /* @__PURE__ */ jsx4("span", { children: language || "Code" }),
       /* @__PURE__ */ jsx4("button", { type: "button", onClick: copy, children: copied ? "Copied" : "Copy" })
@@ -895,7 +978,7 @@ function renderAssistantText(value, keyPrefix) {
     }
     const heading = line.match(/^(#{1,4})\s+(.+)$/);
     if (heading) {
-      blocks.push(/* @__PURE__ */ jsx4("strong", { className: "docs-assistant-heading", children: renderInlineMarkdown(heading[2]) }, `${keyPrefix}-heading-${index}`));
+      blocks.push(/* @__PURE__ */ jsx4("strong", { className: "documentation-assistant-heading", children: renderInlineMarkdown(heading[2]) }, `${keyPrefix}-heading-${index}`));
       index += 1;
       continue;
     }
@@ -939,37 +1022,37 @@ function renderInlineMarkdown(value) {
   });
 }
 
-// src/docs/runtime/navigation.tsx
+// src/documentation/runtime/navigation.tsx
 import { useEffect as useEffect5, useRef as useRef4, useState as useState4 } from "react";
 import { Fragment as Fragment2, jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
-function DocsHeader({
+function DocumentationHeader({
   data,
   onMenuOpen,
   onSearchOpen
 }) {
-  return /* @__PURE__ */ jsxs5("header", { className: "docs-header", children: [
+  return /* @__PURE__ */ jsxs5("header", { className: "documentation-header", children: [
     /* @__PURE__ */ jsx5(
       "a",
       {
-        className: "docs-brand",
-        href: data.config.theme.logoHref ?? "/",
-        "aria-label": `${data.config.name} documentation home`,
-        ...externalProps(data.config.theme.logoHref ?? "/"),
+        className: "documentation-brand",
+        href: data.config.theme.logoHref ?? documentationPublicPath(data.basePath, "/"),
+        "aria-label": `${documentationSubject(data.config.name)} home`,
+        ...externalProps(data.config.theme.logoHref ?? documentationPublicPath(data.basePath, "/")),
         children: /* @__PURE__ */ jsx5(BrandLogo, { data })
       }
     ),
-    /* @__PURE__ */ jsx5("div", { className: "docs-header-center", children: /* @__PURE__ */ jsxs5("button", { className: "docs-search-trigger", type: "button", onClick: onSearchOpen, "aria-label": "Search documentation", children: [
+    /* @__PURE__ */ jsx5("div", { className: "documentation-header-center", children: /* @__PURE__ */ jsxs5("button", { className: "documentation-search-trigger", type: "button", onClick: onSearchOpen, "aria-label": "Search documentation", children: [
       /* @__PURE__ */ jsx5(SearchIcon, {}),
       /* @__PURE__ */ jsx5("span", { children: "Search documentation" }),
       /* @__PURE__ */ jsx5("kbd", { children: "\u2318K" })
     ] }) }),
-    /* @__PURE__ */ jsx5("nav", { className: "docs-top-links", "aria-label": "Product navigation", children: data.config.links.map((link) => /* @__PURE__ */ jsxs5("a", { href: link.href, ...externalProps(link.href), children: [
+    /* @__PURE__ */ jsx5("nav", { className: "documentation-top-links", "aria-label": "Product navigation", children: data.config.links.map((link) => /* @__PURE__ */ jsxs5("a", { href: link.href, ...externalProps(link.href), children: [
       link.label,
       isExternal(link.href) && /* @__PURE__ */ jsx5(ExternalIcon, {})
     ] }, `${link.label}:${link.href}`)) }),
-    /* @__PURE__ */ jsxs5("div", { className: "docs-mobile-actions", children: [
-      /* @__PURE__ */ jsx5("button", { className: "docs-icon-button", type: "button", onClick: onSearchOpen, "aria-label": "Search documentation", children: /* @__PURE__ */ jsx5(SearchIcon, {}) }),
-      /* @__PURE__ */ jsx5("button", { className: "docs-icon-button", type: "button", onClick: onMenuOpen, "aria-label": "Open documentation navigation", children: /* @__PURE__ */ jsx5(MenuIcon, {}) })
+    /* @__PURE__ */ jsxs5("div", { className: "documentation-mobile-actions", children: [
+      /* @__PURE__ */ jsx5("button", { className: "documentation-icon-button", type: "button", onClick: onSearchOpen, "aria-label": "Search documentation", children: /* @__PURE__ */ jsx5(SearchIcon, {}) }),
+      /* @__PURE__ */ jsx5("button", { className: "documentation-icon-button", type: "button", onClick: onMenuOpen, "aria-label": "Open documentation navigation", children: /* @__PURE__ */ jsx5(MenuIcon, {}) })
     ] })
   ] });
 }
@@ -977,21 +1060,20 @@ function BrandLogo({ data }) {
   const { logo, logoDark } = data.config.theme;
   if (logo) {
     return /* @__PURE__ */ jsxs5(Fragment2, { children: [
-      /* @__PURE__ */ jsx5("img", { className: "docs-brand-logo docs-brand-logo-light", src: logo, alt: "" }),
-      /* @__PURE__ */ jsx5("img", { className: "docs-brand-logo docs-brand-logo-dark", src: logoDark ?? logo, alt: "" }),
-      /* @__PURE__ */ jsx5("span", { className: "docs-brand-product", children: "Docs" })
+      /* @__PURE__ */ jsx5("img", { className: "documentation-brand-logo documentation-brand-logo-light", src: logo, alt: "" }),
+      /* @__PURE__ */ jsx5("img", { className: "documentation-brand-logo documentation-brand-logo-dark", src: logoDark ?? logo, alt: "" }),
+      /* @__PURE__ */ jsx5("span", { className: "documentation-brand-product", children: "Documentation" })
     ] });
   }
   return /* @__PURE__ */ jsxs5(Fragment2, { children: [
-    /* @__PURE__ */ jsx5("span", { className: "docs-brand-mark", children: /* @__PURE__ */ jsx5(OrbitMark, {}) }),
-    /* @__PURE__ */ jsx5("span", { className: "docs-brand-name", children: data.config.name }),
-    /* @__PURE__ */ jsx5("span", { className: "docs-brand-product", children: "Docs" })
+    /* @__PURE__ */ jsx5("span", { className: "documentation-brand-mark", children: /* @__PURE__ */ jsx5(OrbitMark, {}) }),
+    /* @__PURE__ */ jsx5("span", { className: "documentation-brand-name", children: data.config.name })
   ] });
 }
 function DesktopSidebar({ data }) {
-  return /* @__PURE__ */ jsxs5("aside", { className: "docs-sidebar", "aria-label": "Documentation navigation", children: [
-    /* @__PURE__ */ jsx5("nav", { className: "docs-page-tree", children: /* @__PURE__ */ jsx5(NavigationTree, { activeRoute: data.page.route, nodes: data.navigation }) }),
-    /* @__PURE__ */ jsxs5("div", { className: "docs-sidebar-footer", children: [
+  return /* @__PURE__ */ jsxs5("aside", { className: "documentation-sidebar", "aria-label": "Documentation navigation", children: [
+    /* @__PURE__ */ jsx5("nav", { className: "documentation-page-tree", children: /* @__PURE__ */ jsx5(NavigationTree, { activeRoute: data.page.route, basePath: data.basePath, nodes: data.navigation }) }),
+    /* @__PURE__ */ jsxs5("div", { className: "documentation-sidebar-footer", children: [
       !data.config.theme.strictMode && /* @__PURE__ */ jsx5(ThemeControls, { defaultMode: data.config.theme.defaultMode ?? "system" }),
       data.config.footer.length > 0 && /* @__PURE__ */ jsx5("nav", { "aria-label": "Documentation footer", children: data.config.footer.map((link) => /* @__PURE__ */ jsx5("a", { href: link.href, ...externalProps(link.href), children: link.label }, `${link.label}:${link.href}`)) }),
       /* @__PURE__ */ jsx5("span", { children: "Built on DeepSpace" })
@@ -1000,6 +1082,7 @@ function DesktopSidebar({ data }) {
 }
 function NavigationTree({
   activeRoute,
+  basePath,
   depth = 0,
   nodes
 }) {
@@ -1007,26 +1090,26 @@ function NavigationTree({
     if (node.kind === "group") {
       const active2 = containsRoute(node, activeRoute);
       if (depth === 0) {
-        return /* @__PURE__ */ jsxs5("section", { className: "docs-nav-section", children: [
+        return /* @__PURE__ */ jsxs5("section", { className: "documentation-nav-section", children: [
           /* @__PURE__ */ jsx5("h2", { children: node.label }),
-          /* @__PURE__ */ jsx5(NavigationTree, { activeRoute, depth: depth + 1, nodes: node.items })
+          /* @__PURE__ */ jsx5(NavigationTree, { activeRoute, basePath, depth: depth + 1, nodes: node.items })
         ] }, `group:${node.label}`);
       }
-      return /* @__PURE__ */ jsxs5("details", { className: "docs-nav-folder", open: active2, children: [
+      return /* @__PURE__ */ jsxs5("details", { className: "documentation-nav-folder", open: active2, children: [
         /* @__PURE__ */ jsxs5("summary", { children: [
           /* @__PURE__ */ jsx5("span", { children: node.label }),
           /* @__PURE__ */ jsx5(ChevronDownIcon, {})
         ] }),
-        /* @__PURE__ */ jsx5("div", { children: /* @__PURE__ */ jsx5(NavigationTree, { activeRoute, depth: depth + 1, nodes: node.items }) })
+        /* @__PURE__ */ jsx5("div", { children: /* @__PURE__ */ jsx5(NavigationTree, { activeRoute, basePath, depth: depth + 1, nodes: node.items }) })
       ] }, `group:${node.label}`);
     }
-    const href = node.kind === "page" ? node.route : node.href;
+    const href = node.kind === "page" ? documentationPublicPath(basePath, node.route) : node.href;
     const active = node.kind === "page" && node.route === activeRoute;
     return /* @__PURE__ */ jsxs5(
       "a",
       {
         "aria-current": active ? "page" : void 0,
-        className: active ? "docs-nav-link is-active" : "docs-nav-link",
+        className: active ? "documentation-nav-link is-active" : "documentation-nav-link",
         href,
         ...externalProps(href),
         children: [
@@ -1046,23 +1129,23 @@ function MobileNavigation({
   const dialogRef = useRef4(null);
   useDialogFocus(open, dialogRef, onClose);
   if (!open) return null;
-  return /* @__PURE__ */ jsx5("div", { className: "docs-modal-layer", role: "presentation", onMouseDown: (event) => {
+  return /* @__PURE__ */ jsx5("div", { className: "documentation-modal-layer", role: "presentation", onMouseDown: (event) => {
     if (event.currentTarget === event.target) onClose();
-  }, children: /* @__PURE__ */ jsxs5("div", { className: "docs-mobile-nav", role: "dialog", "aria-modal": "true", "aria-label": "Documentation navigation", ref: dialogRef, children: [
+  }, children: /* @__PURE__ */ jsxs5("div", { className: "documentation-mobile-nav", role: "dialog", "aria-modal": "true", "aria-label": "Documentation navigation", ref: dialogRef, children: [
     /* @__PURE__ */ jsxs5("header", { children: [
       /* @__PURE__ */ jsx5(
         "a",
         {
-          "aria-label": `${data.config.name} documentation home`,
-          className: "docs-brand",
-          href: data.config.theme.logoHref ?? "/",
-          ...externalProps(data.config.theme.logoHref ?? "/"),
+          "aria-label": `${documentationSubject(data.config.name)} home`,
+          className: "documentation-brand",
+          href: data.config.theme.logoHref ?? documentationPublicPath(data.basePath, "/"),
+          ...externalProps(data.config.theme.logoHref ?? documentationPublicPath(data.basePath, "/")),
           children: /* @__PURE__ */ jsx5(BrandLogo, { data })
         }
       ),
-      /* @__PURE__ */ jsx5("button", { className: "docs-icon-button", type: "button", onClick: onClose, "aria-label": "Close documentation navigation", "data-autofocus": true, children: /* @__PURE__ */ jsx5(CloseIcon, {}) })
+      /* @__PURE__ */ jsx5("button", { className: "documentation-icon-button", type: "button", onClick: onClose, "aria-label": "Close documentation navigation", "data-autofocus": true, children: /* @__PURE__ */ jsx5(CloseIcon, {}) })
     ] }),
-    /* @__PURE__ */ jsx5("nav", { className: "docs-page-tree", children: /* @__PURE__ */ jsx5(NavigationTree, { activeRoute: data.page.route, nodes: data.navigation }) }),
+    /* @__PURE__ */ jsx5("nav", { className: "documentation-page-tree", children: /* @__PURE__ */ jsx5(NavigationTree, { activeRoute: data.page.route, basePath: data.basePath, nodes: data.navigation }) }),
     /* @__PURE__ */ jsxs5("footer", { children: [
       !data.config.theme.strictMode && /* @__PURE__ */ jsx5(ThemeControls, { defaultMode: data.config.theme.defaultMode ?? "system" }),
       data.config.footer.map((link) => /* @__PURE__ */ jsx5("a", { href: link.href, ...externalProps(link.href), children: link.label }, `${link.label}:${link.href}`))
@@ -1072,15 +1155,15 @@ function MobileNavigation({
 function ThemeControls({ defaultMode }) {
   const [mode, setMode] = useState4(defaultMode);
   useEffect5(() => {
-    const saved = safeStorageGet("deepspace-docs-theme");
+    const saved = safeStorageGet("deepspace-documentation-theme");
     if (saved === "light" || saved === "dark" || saved === "system") setMode(saved);
   }, []);
   useEffect5(() => applyThemeMode(mode), [mode]);
   const choose = (next) => {
     setMode(next);
-    safeStorageSet("deepspace-docs-theme", next);
+    safeStorageSet("deepspace-documentation-theme", next);
   };
-  return /* @__PURE__ */ jsxs5("div", { className: "docs-theme-controls", role: "group", "aria-label": "Theme preference", children: [
+  return /* @__PURE__ */ jsxs5("div", { className: "documentation-theme-controls", role: "group", "aria-label": "Theme preference", children: [
     /* @__PURE__ */ jsx5("button", { "aria-pressed": mode === "system", "aria-label": "Use system theme", onClick: () => choose("system"), type: "button", children: /* @__PURE__ */ jsx5(SystemIcon, {}) }),
     /* @__PURE__ */ jsx5("button", { "aria-pressed": mode === "light", "aria-label": "Use light theme", onClick: () => choose("light"), type: "button", children: /* @__PURE__ */ jsx5(SunIcon, {}) }),
     /* @__PURE__ */ jsx5("button", { "aria-pressed": mode === "dark", "aria-label": "Use dark theme", onClick: () => choose("dark"), type: "button", children: /* @__PURE__ */ jsx5(MoonIcon, {}) })
@@ -1100,7 +1183,7 @@ function applyThemeMode(mode) {
   return () => media.removeEventListener?.("change", apply);
 }
 
-// src/docs/runtime/search.tsx
+// src/documentation/runtime/search.tsx
 import {
   useEffect as useEffect6,
   useMemo as useMemo2,
@@ -1110,6 +1193,7 @@ import {
 import { Fragment as Fragment3, jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
 function SearchCommand({
   assistantEnabled,
+  basePath,
   name,
   onAssistantOpen,
   onClose,
@@ -1125,8 +1209,8 @@ function SearchCommand({
   useEffect6(() => {
     if (!open || index || loading) return;
     setLoading(true);
-    fetch("/_docs/search.json").then((response) => response.ok ? response.json() : []).then(setIndex).catch(() => setIndex([])).finally(() => setLoading(false));
-  }, [index, loading, open]);
+    fetch(documentationPublicPath(basePath, "/search.json")).then((response) => response.ok ? response.json() : []).then(setIndex).catch(() => setIndex([])).finally(() => setLoading(false));
+  }, [basePath, index, loading, open]);
   useEffect6(() => {
     if (!open) {
       setQuery("");
@@ -1148,25 +1232,26 @@ function SearchCommand({
       event.preventDefault();
       if (activeIndex < results.length && results[activeIndex]) {
         onClose();
-        if (onNavigate) onNavigate(results[activeIndex].route);
-        else window.location.assign(results[activeIndex].route);
+        const href = documentationPublicPath(basePath, results[activeIndex].route);
+        if (onNavigate) onNavigate(href);
+        else window.location.assign(href);
       } else if (assistantEnabled && query.trim()) {
         onAssistantOpen(query.trim());
       }
     }
   };
-  return /* @__PURE__ */ jsx6("div", { className: "docs-modal-layer docs-search-layer", role: "presentation", onMouseDown: (event) => {
+  return /* @__PURE__ */ jsx6("div", { className: "documentation-modal-layer documentation-search-layer", role: "presentation", onMouseDown: (event) => {
     if (event.currentTarget === event.target) onClose();
-  }, children: /* @__PURE__ */ jsxs6("div", { className: "docs-search-dialog", role: "dialog", "aria-modal": "true", "aria-label": "Search documentation", ref: dialogRef, children: [
-    /* @__PURE__ */ jsxs6("label", { className: "docs-search-input", children: [
+  }, children: /* @__PURE__ */ jsxs6("div", { className: "documentation-search-dialog", role: "dialog", "aria-modal": "true", "aria-label": "Search documentation", ref: dialogRef, children: [
+    /* @__PURE__ */ jsxs6("label", { className: "documentation-search-input", children: [
       /* @__PURE__ */ jsx6(SearchIcon, {}),
       /* @__PURE__ */ jsx6(
         "input",
         {
-          "aria-activedescendant": selectableCount > 0 ? `docs-search-option-${activeIndex}` : void 0,
-          "aria-controls": "docs-search-results",
+          "aria-activedescendant": selectableCount > 0 ? `documentation-search-option-${activeIndex}` : void 0,
+          "aria-controls": "documentation-search-results",
           "aria-expanded": "true",
-          "aria-label": `Search ${name} documentation`,
+          "aria-label": `Search ${documentationSubject(name)}`,
           autoComplete: "off",
           "data-autofocus": true,
           onChange: (event) => {
@@ -1181,14 +1266,14 @@ function SearchCommand({
       ),
       /* @__PURE__ */ jsx6("kbd", { children: "Esc" })
     ] }),
-    /* @__PURE__ */ jsxs6("div", { className: "docs-search-results", id: "docs-search-results", role: "listbox", "aria-label": "Search results", children: [
-      !query.trim() && /* @__PURE__ */ jsxs6("div", { className: "docs-search-empty", children: [
+    /* @__PURE__ */ jsxs6("div", { className: "documentation-search-results", id: "documentation-search-results", role: "listbox", "aria-label": "Search results", children: [
+      !query.trim() && /* @__PURE__ */ jsxs6("div", { className: "documentation-search-empty", children: [
         /* @__PURE__ */ jsx6(OrbitMark, {}),
         /* @__PURE__ */ jsx6("strong", { children: "Find an answer in this commit" }),
         /* @__PURE__ */ jsx6("span", { children: "Search pages, headings, APIs, and examples." })
       ] }),
-      query.trim() && loading && /* @__PURE__ */ jsx6("div", { className: "docs-search-state", children: "Searching this documentation\u2026" }),
-      query.trim() && !loading && results.length === 0 && /* @__PURE__ */ jsxs6("div", { className: "docs-search-state", children: [
+      query.trim() && loading && /* @__PURE__ */ jsx6("div", { className: "documentation-search-state", children: "Searching this documentation\u2026" }),
+      query.trim() && !loading && results.length === 0 && /* @__PURE__ */ jsxs6("div", { className: "documentation-search-state", children: [
         "No documentation matched \u201C",
         query.trim(),
         "\u201D."
@@ -1197,9 +1282,9 @@ function SearchCommand({
         "a",
         {
           "aria-selected": activeIndex === resultIndex,
-          className: activeIndex === resultIndex ? "docs-search-result is-active" : "docs-search-result",
-          href: result.route,
-          id: `docs-search-option-${resultIndex}`,
+          className: activeIndex === resultIndex ? "documentation-search-result is-active" : "documentation-search-result",
+          href: documentationPublicPath(basePath, result.route),
+          id: `documentation-search-option-${resultIndex}`,
           onClick: onClose,
           onMouseEnter: () => setActiveIndex(resultIndex),
           role: "option",
@@ -1217,8 +1302,8 @@ function SearchCommand({
         "button",
         {
           "aria-selected": activeIndex === results.length,
-          className: activeIndex === results.length ? "docs-search-assistant is-active" : "docs-search-assistant",
-          id: `docs-search-option-${results.length}`,
+          className: activeIndex === results.length ? "documentation-search-assistant is-active" : "documentation-search-assistant",
+          id: `documentation-search-option-${results.length}`,
           onClick: () => onAssistantOpen(query.trim()),
           onMouseEnter: () => setActiveIndex(results.length),
           role: "option",
@@ -1290,9 +1375,9 @@ function normalizeSearch(value) {
   return value.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
 }
 
-// src/docs/runtime/app.tsx
+// src/documentation/runtime/app.tsx
 import { Fragment as Fragment4, jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
-function DocsApp({
+function DocumentationApp({
   data,
   children,
   navigating = false,
@@ -1301,8 +1386,18 @@ function DocsApp({
   const [mobileNavOpen, setMobileNavOpen] = useState6(false);
   const [searchOpen, setSearchOpen] = useState6(false);
   const [assistantOpen, setAssistantOpen] = useState6(false);
-  const [assistantSeed, setAssistantSeed] = useState6({ id: 0, submit: false, value: "" });
-  const openAssistant = useCallback((seed = "", submit = false) => {
+  const [assistantDraft, setAssistantDraft] = useState6("");
+  const [assistantSeed, setAssistantSeed] = useState6({ id: 0, submit: false });
+  const assistantAccess = data.config.assistant.access === "disabled" ? null : data.config.assistant.access;
+  const assistantEnabled = assistantAccess !== null;
+  const appClassName = [
+    "documentation-app",
+    assistantEnabled ? "has-assistant" : "",
+    assistantOpen ? "is-assistant-open" : "",
+    navigating ? "is-navigating" : ""
+  ].filter(Boolean).join(" ");
+  const openAssistant = useCallback((seed, submit = false) => {
+    if (seed !== void 0) setAssistantDraft(seed);
     setAssistantSeed((current) => ({ id: current.id + 1, submit, value: seed }));
     setSearchOpen(false);
     setAssistantOpen(true);
@@ -1329,20 +1424,20 @@ function DocsApp({
     "div",
     {
       "aria-busy": navigating || void 0,
-      className: `${assistantOpen ? "docs-app is-assistant-open" : "docs-app"}${navigating ? " is-navigating" : ""}`,
+      className: appClassName,
       children: [
-        /* @__PURE__ */ jsx7("a", { className: "docs-skip-link", href: "#docs-content", children: "Skip to main content" }),
+        /* @__PURE__ */ jsx7("a", { className: "documentation-skip-link", href: "#documentation-content", children: "Skip to main content" }),
         /* @__PURE__ */ jsx7(
-          DocsHeader,
+          DocumentationHeader,
           {
             data,
             onMenuOpen: () => setMobileNavOpen(true),
             onSearchOpen: () => setSearchOpen(true)
           }
         ),
-        /* @__PURE__ */ jsxs7("div", { className: "docs-frame", children: [
+        /* @__PURE__ */ jsxs7("div", { className: "documentation-frame", children: [
           /* @__PURE__ */ jsx7(DesktopSidebar, { data }),
-          /* @__PURE__ */ jsx7("main", { className: "docs-main", id: "docs-content", children: /* @__PURE__ */ jsxs7("div", { className: "docs-reader-grid", children: [
+          /* @__PURE__ */ jsx7("main", { className: "documentation-main", id: "documentation-content", children: /* @__PURE__ */ jsxs7("div", { className: "documentation-reader-grid", children: [
             /* @__PURE__ */ jsx7(Article, { data, onAssistantOpen: openAssistant, children }),
             /* @__PURE__ */ jsx7(ContextRail, { data })
           ] }) })
@@ -1358,7 +1453,8 @@ function DocsApp({
         /* @__PURE__ */ jsx7(
           SearchCommand,
           {
-            assistantEnabled: data.config.assistant.access !== "disabled",
+            assistantEnabled,
+            basePath: data.basePath,
             name: data.config.name,
             onAssistantOpen: openAssistant,
             onClose: () => setSearchOpen(false),
@@ -1366,22 +1462,27 @@ function DocsApp({
             open: searchOpen
           }
         ),
-        data.config.assistant.access !== "disabled" && /* @__PURE__ */ jsxs7(Fragment4, { children: [
+        assistantAccess && /* @__PURE__ */ jsxs7(Fragment4, { children: [
           /* @__PURE__ */ jsx7(
             AssistantLauncher,
             {
+              input: assistantDraft,
               name: data.config.name,
               onOpen: () => openAssistant(),
+              onInputChange: setAssistantDraft,
               onSubmit: (question) => openAssistant(question, true),
               open: assistantOpen
             }
           ),
           /* @__PURE__ */ jsx7(
-            DocsAssistant,
+            DocumentationAssistant,
             {
-              access: data.config.assistant.access,
+              access: assistantAccess,
+              basePath: data.basePath,
+              input: assistantDraft,
               name: data.config.name,
               onClose: () => setAssistantOpen(false),
+              onInputChange: setAssistantDraft,
               open: assistantOpen,
               route: data.page.route,
               seed: assistantSeed,
@@ -1394,12 +1495,12 @@ function DocsApp({
   );
 }
 
-// src/docs/runtime/mdx-components.tsx
+// src/documentation/runtime/mdx-components.tsx
 import { Children, createElement, isValidElement } from "react";
 import { Fragment as Fragment5, jsx as jsx8, jsxs as jsxs8 } from "react/jsx-runtime";
 function Callout({ children, title, kind }) {
   const label = title ?? kind.charAt(0).toUpperCase() + kind.slice(1);
-  return /* @__PURE__ */ jsxs8("aside", { className: `docs-callout docs-callout-${kind}`, children: [
+  return /* @__PURE__ */ jsxs8("aside", { className: `documentation-callout documentation-callout-${kind}`, children: [
     /* @__PURE__ */ jsx8("strong", { children: label }),
     children
   ] });
@@ -1421,42 +1522,42 @@ function Card({ children, href, label, title }) {
     title ?? label ? /* @__PURE__ */ jsx8("strong", { children: title ?? label }) : null,
     children
   ] });
-  return href ? /* @__PURE__ */ jsxs8("a", { className: "docs-card", href, children: [
+  return href ? /* @__PURE__ */ jsxs8("a", { className: "documentation-card", href, children: [
     content,
     /* @__PURE__ */ jsx8("span", { "aria-hidden": "true", children: "\u2192" })
-  ] }) : /* @__PURE__ */ jsx8("div", { className: "docs-card", children: content });
+  ] }) : /* @__PURE__ */ jsx8("div", { className: "documentation-card", children: content });
 }
 function Accordion({ children, label, title }) {
-  return /* @__PURE__ */ jsxs8("details", { className: "docs-accordion", children: [
+  return /* @__PURE__ */ jsxs8("details", { className: "documentation-accordion", children: [
     /* @__PURE__ */ jsx8("summary", { children: title ?? label ?? "Details" }),
     children
   ] });
 }
 function AccordionGroup({ children }) {
-  return /* @__PURE__ */ jsx8("div", { className: "docs-accordion-group", children });
+  return /* @__PURE__ */ jsx8("div", { className: "documentation-accordion-group", children });
 }
 function Step({ children, label, title }) {
-  return /* @__PURE__ */ jsxs8("section", { className: "docs-step", children: [
+  return /* @__PURE__ */ jsxs8("section", { className: "documentation-step", children: [
     title ?? label ? /* @__PURE__ */ jsx8("h3", { children: title ?? label }) : null,
     children
   ] });
 }
 function Steps({ children }) {
-  return /* @__PURE__ */ jsx8("div", { className: "docs-steps", children });
+  return /* @__PURE__ */ jsx8("div", { className: "documentation-steps", children });
 }
 function Tab({ children, label, title }) {
-  return /* @__PURE__ */ jsx8("section", { className: "docs-tab", "data-tab": true, "data-tab-title": title ?? label ?? "Tab", children });
+  return /* @__PURE__ */ jsx8("section", { className: "documentation-tab", "data-tab": true, "data-tab-title": title ?? label ?? "Tab", children });
 }
 function Tabs({ children }) {
-  return /* @__PURE__ */ jsx8("div", { className: "docs-tabs", "data-tab-group": true, children });
+  return /* @__PURE__ */ jsx8("div", { className: "documentation-tabs", "data-tab-group": true, children });
 }
 function CodeGroup({ children, label, title }) {
-  return /* @__PURE__ */ jsxs8("div", { className: "docs-code-group", "data-tab-group": true, children: [
-    title ?? label ? /* @__PURE__ */ jsx8("div", { className: "docs-code-group-title", children: title ?? label }) : null,
+  return /* @__PURE__ */ jsxs8("div", { className: "documentation-code-group", "data-tab-group": true, children: [
+    title ?? label ? /* @__PURE__ */ jsx8("div", { className: "documentation-code-group-title", children: title ?? label }) : null,
     Children.toArray(children).map((child, index) => /* @__PURE__ */ jsx8(
       "section",
       {
-        className: "docs-tab",
+        className: "documentation-tab",
         "data-tab": true,
         "data-tab-title": codeBlockTitle(child) ?? `Example ${index + 1}`,
         children: child
@@ -1478,10 +1579,10 @@ function Heading({ level, ...props }) {
     `h${level}`,
     props,
     props.children,
-    id ? /* @__PURE__ */ jsx8("a", { "aria-label": "Link to this section", className: "docs-heading-anchor", href: `#${id}`, children: "#" }) : null
+    id ? /* @__PURE__ */ jsx8("a", { "aria-label": "Link to this section", className: "documentation-heading-anchor", href: `#${id}`, children: "#" }) : null
   );
 }
-var docsMdxComponents = {
+var documentationMdxComponents = {
   Accordion,
   AccordionGroup,
   Card,
@@ -1502,21 +1603,23 @@ var docsMdxComponents = {
   h6: (props) => /* @__PURE__ */ jsx8(Heading, { ...props, level: 6 })
 };
 
-// src/docs/runtime/public.tsx
+// src/documentation/runtime/public.tsx
 import { jsx as jsx9 } from "react/jsx-runtime";
-var DefaultDocs = DocsApp;
-function DocsContent({
+var DefaultDocumentation = DocumentationApp;
+function DocumentationContent({
   data,
   Page
 }) {
   if (!Page) {
-    return /* @__PURE__ */ jsx9("div", { className: "docs-prose", dangerouslySetInnerHTML: { __html: data.page.html } });
+    return /* @__PURE__ */ jsx9("div", { className: "documentation-prose", dangerouslySetInnerHTML: { __html: data.page.html } });
   }
-  return /* @__PURE__ */ jsx9("div", { className: "docs-prose", children: /* @__PURE__ */ jsx9(Page, { components: docsMdxComponents }) });
+  return /* @__PURE__ */ jsx9("div", { className: "documentation-prose", children: /* @__PURE__ */ jsx9(Page, { components: documentationMdxComponents }) });
 }
 
 export {
-  DocsApp,
+  documentationPublicPath,
+  documentationLogicalPath,
+  DocumentationApp,
   Note,
   Tip,
   Warning,
@@ -1529,7 +1632,7 @@ export {
   Tab,
   Tabs,
   CodeGroup,
-  DefaultDocs,
-  DocsContent
+  DefaultDocumentation,
+  DocumentationContent
 };
-//# sourceMappingURL=chunk-DQ4G6VL6.js.map
+//# sourceMappingURL=chunk-T7V4GUIN.js.map