deepspace 0.33.1 → 0.35.0

package/dist/chunk-ESYXTIV2.js

@@ -0,0 +1,1957 @@
+// src/documentation/runtime/app.tsx
+import {
+  useCallback,
+  useEffect as useEffect8,
+  useState as useState7
+} from "react";
+
+// src/documentation/runtime/article.tsx
+import {
+  useEffect as useEffect3,
+  useMemo,
+  useRef as useRef3,
+  useState as useState3
+} from "react";
+import { createPortal } from "react-dom";
+
+// 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) {
+      await navigator.clipboard.writeText(text);
+      return;
+    }
+  } catch {
+  }
+  const activeElement = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+  const textarea = document.createElement("textarea");
+  textarea.value = text;
+  textarea.readOnly = true;
+  textarea.style.position = "fixed";
+  textarea.style.inset = "0 auto auto 0";
+  textarea.style.opacity = "0";
+  textarea.style.pointerEvents = "none";
+  document.body.appendChild(textarea);
+  textarea.focus({ preventScroll: true });
+  textarea.select();
+  const copied = document.execCommand("copy");
+  textarea.remove();
+  activeElement?.focus({ preventScroll: true });
+  if (!copied) throw new Error("Unable to copy text");
+}
+function externalProps(href) {
+  return isExternal(href) ? { target: "_blank", rel: "noopener noreferrer" } : {};
+}
+function isExternal(href) {
+  return /^https?:\/\//i.test(href);
+}
+function safeStorageGet(key) {
+  try {
+    return localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function safeStorageSet(key, value) {
+  try {
+    localStorage.setItem(key, value);
+  } catch {
+  }
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+// src/documentation/runtime/code-block.tsx
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useId,
+  useRef,
+  useState
+} from "react";
+
+// src/documentation/runtime/icons.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function Icon({ children, ...props }) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      "aria-hidden": "true",
+      fill: "none",
+      height: "18",
+      viewBox: "0 0 24 24",
+      width: "18",
+      ...props,
+      children
+    }
+  );
+}
+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(--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" })
+  ] });
+}
+function SearchIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("circle", { cx: "11", cy: "11", r: "6.5", stroke: "currentColor", strokeWidth: "1.8" }),
+    /* @__PURE__ */ jsx("path", { d: "m16 16 4 4", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.8" })
+  ] });
+}
+function SparkIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("path", { d: "M12 2.8c.3 5 3.7 8.4 8.7 8.7-5 .3-8.4 3.7-8.7 8.7-.3-5-3.7-8.4-8.7-8.7 5-.3 8.4-3.7 8.7-8.7Z", stroke: "currentColor", strokeLinejoin: "round", strokeWidth: "1.6" }),
+    /* @__PURE__ */ jsx("path", { d: "M19 3v4M21 5h-4", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.4" })
+  ] });
+}
+function MenuIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("path", { d: "M4 7h16M4 12h16M4 17h16", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.8" }) });
+}
+function CloseIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("path", { d: "m6 6 12 12M18 6 6 18", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.8" }) });
+}
+function SunIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("circle", { cx: "12", cy: "12", r: "3.5", stroke: "currentColor", strokeWidth: "1.6" }),
+    /* @__PURE__ */ jsx("path", { d: "M12 2.5v2M12 19.5v2M2.5 12h2M19.5 12h2M5.3 5.3l1.4 1.4M17.3 17.3l1.4 1.4M18.7 5.3l-1.4 1.4M6.7 17.3l-1.4 1.4", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.6" })
+  ] });
+}
+function MoonIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("path", { d: "M19.5 14.8A8 8 0 0 1 9.2 4.5 8 8 0 1 0 19.5 14.8Z", stroke: "currentColor", strokeLinejoin: "round", strokeWidth: "1.6" }) });
+}
+function SystemIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("rect", { x: "3", y: "4", width: "18", height: "13", rx: "2", stroke: "currentColor", strokeWidth: "1.6" }),
+    /* @__PURE__ */ jsx("path", { d: "M8 21h8M12 17v4", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.6" })
+  ] });
+}
+function ChevronRightIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("path", { d: "m9 5 7 7-7 7", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "1.8" }) });
+}
+function ChevronDownIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("path", { d: "m5 9 7 7 7-7", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "1.8" }) });
+}
+function ExternalIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("path", { d: "M14 4h6v6M20 4l-9 9", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "1.6" }),
+    /* @__PURE__ */ jsx("path", { d: "M18 13v5a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h5", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.6" })
+  ] });
+}
+function CopyIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("rect", { x: "8", y: "8", width: "11", height: "11", rx: "2", stroke: "currentColor", strokeWidth: "1.6" }),
+    /* @__PURE__ */ jsx("path", { d: "M16 8V6a2 2 0 0 0-2-2H6a2 2 0 0 0-2 2v8a2 2 0 0 0 2 2h2", stroke: "currentColor", strokeWidth: "1.6" })
+  ] });
+}
+function CheckIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("path", { d: "m5 12.5 4.2 4L19 7", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "1.9" }) });
+}
+function FileIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("path", { d: "M6 3.5h8l4 4V20a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4.5a1 1 0 0 1 1-1Z", stroke: "currentColor", strokeLinejoin: "round", strokeWidth: "1.6" }),
+    /* @__PURE__ */ jsx("path", { d: "M14 3.5v4h4M8 12h7M8 16h7", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.6" })
+  ] });
+}
+function MessageIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("path", { d: "M5.5 18.5 4 21l3.5-1.2A8.5 8.5 0 1 0 5.5 18.5Z", stroke: "currentColor", strokeLinejoin: "round", strokeWidth: "1.6" }),
+    /* @__PURE__ */ jsx("path", { d: "M8 10h8M8 14h5", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.6" })
+  ] });
+}
+function TerminalIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("rect", { x: "3.5", y: "4.5", width: "17", height: "15", rx: "2", stroke: "currentColor", strokeWidth: "1.6" }),
+    /* @__PURE__ */ jsx("path", { d: "m7 9 3 3-3 3M12.5 15H17", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "1.6" })
+  ] });
+}
+function EditorIcon(props) {
+  return /* @__PURE__ */ jsxs(Icon, { ...props, children: [
+    /* @__PURE__ */ jsx("rect", { x: "3.5", y: "4.5", width: "17", height: "15", rx: "2", stroke: "currentColor", strokeWidth: "1.6" }),
+    /* @__PURE__ */ jsx("path", { d: "M8 4.5v15M11.5 9h5M11.5 12h5M11.5 15h3", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.6" })
+  ] });
+}
+function SendIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("path", { d: "M12 18V6M7.5 10.5 12 6l4.5 4.5", stroke: "currentColor", strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: "1.8" }) });
+}
+function StopIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("rect", { x: "6", y: "6", width: "12", height: "12", rx: "2", fill: "currentColor" }) });
+}
+function HashIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("path", { d: "M9.5 4 7.5 20M16.5 4l-2 16M4.5 9h15M3.5 15h15", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.6" }) });
+}
+function ListIcon(props) {
+  return /* @__PURE__ */ jsx(Icon, { ...props, children: /* @__PURE__ */ jsx("path", { d: "M4 6h16M4 12h11M4 18h7", stroke: "currentColor", strokeLinecap: "round", strokeWidth: "1.8" }) });
+}
+
+// src/documentation/runtime/code-block.tsx
+import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var CodeBlockContext = createContext({
+  assistantEnabled: false,
+  onAsk: () => {
+  }
+});
+var CodeBlockControlsProvider = CodeBlockContext.Provider;
+function CodeBlockActions({ readCode }) {
+  const { assistantEnabled, onAsk } = useContext(CodeBlockContext);
+  const [copied, setCopied] = useState(false);
+  const copy = async () => {
+    await writeClipboardText(readCode());
+    setCopied(true);
+    window.setTimeout(() => setCopied(false), 1400);
+  };
+  return /* @__PURE__ */ jsxs2(Fragment, { children: [
+    /* @__PURE__ */ jsx2("button", { "aria-label": copied ? "Code copied" : "Copy code", onClick: () => {
+      void copy();
+    }, type: "button", children: copied ? /* @__PURE__ */ jsx2(CheckIcon, {}) : /* @__PURE__ */ jsx2(CopyIcon, {}) }),
+    assistantEnabled && /* @__PURE__ */ jsx2(
+      "button",
+      {
+        "aria-label": "Ask the documentation assistant about this code",
+        onClick: () => onAsk(readCode().trim().slice(0, 1200)),
+        type: "button",
+        children: /* @__PURE__ */ jsx2(SparkIcon, {})
+      }
+    )
+  ] });
+}
+function codeBlockLanguage(className) {
+  return /(?:^|\s)(?:language|lang)-([a-z0-9+#-]{1,20})/i.exec(className)?.[1] ?? "";
+}
+function childCodeClassName(children) {
+  const code = children;
+  return typeof code?.props?.className === "string" ? code.props.className : "";
+}
+function childCodeTitle(children) {
+  const code = children;
+  const title = code?.props?.["data-code-title"];
+  return typeof title === "string" && title ? title : void 0;
+}
+var CodeGroupContext = createContext(false);
+var CodeGroupProvider = CodeGroupContext.Provider;
+function CodeBlock({ children, ...props }) {
+  const preRef = useRef(null);
+  const inCodeGroup = useContext(CodeGroupContext);
+  const language = codeBlockLanguage(childCodeClassName(children));
+  const preTitle = props["data-code-title"];
+  const title = inCodeGroup ? void 0 : childCodeTitle(children) ?? (typeof preTitle === "string" && preTitle ? preTitle : void 0);
+  const readCode = () => preRef.current?.querySelector("code")?.textContent ?? preRef.current?.textContent ?? "";
+  return /* @__PURE__ */ jsxs2("div", { className: "documentation-code-block", children: [
+    title ? /* @__PURE__ */ jsx2("div", { className: "documentation-code-title", children: title }) : null,
+    /* @__PURE__ */ jsx2("pre", { ...props, ref: preRef, children }),
+    /* @__PURE__ */ jsxs2("div", { className: "documentation-code-actions", children: [
+      language ? /* @__PURE__ */ jsx2("span", { className: "documentation-code-language", children: language }) : null,
+      /* @__PURE__ */ jsx2(CodeBlockActions, { readCode })
+    ] })
+  ] });
+}
+var TAB_SELECTION_KEY = "deepspace-documentation-tab-selection";
+var TAB_CHANGE_EVENT = "deepspace-documentation-tab-change";
+function TabGroup({
+  className,
+  panels,
+  title
+}) {
+  const groupId = useId();
+  const [active, setActive] = useState(0);
+  const controlsRef = useRef(null);
+  useEffect(() => {
+    const stored = safeStorageGet(TAB_SELECTION_KEY);
+    const index = stored ? panels.findIndex((panel) => panel.label === stored) : -1;
+    if (index >= 0) setActive(index);
+  }, [panels]);
+  useEffect(() => {
+    const sync = (event) => {
+      const detail = event.detail;
+      if (!detail?.label || detail.source === groupId) return;
+      const index = panels.findIndex((panel) => panel.label === detail.label);
+      if (index >= 0) setActive(index);
+    };
+    document.addEventListener(TAB_CHANGE_EVENT, sync);
+    return () => document.removeEventListener(TAB_CHANGE_EVENT, sync);
+  }, [groupId, panels]);
+  const select = (index, broadcast) => {
+    setActive(index);
+    const label = panels[index]?.label;
+    if (!broadcast || !label) return;
+    safeStorageSet(TAB_SELECTION_KEY, label);
+    document.dispatchEvent(new CustomEvent(TAB_CHANGE_EVENT, { detail: { label, source: groupId } }));
+  };
+  const onKeyDown = (event, index) => {
+    if (!["ArrowLeft", "ArrowRight", "Home", "End"].includes(event.key)) return;
+    event.preventDefault();
+    const next = event.key === "Home" ? 0 : event.key === "End" ? panels.length - 1 : (index + (event.key === "ArrowRight" ? 1 : -1) + panels.length) % panels.length;
+    select(next, true);
+    controlsRef.current?.querySelectorAll("button")[next]?.focus();
+  };
+  return /* @__PURE__ */ jsxs2("div", { className, "data-tab-group": true, children: [
+    title,
+    /* @__PURE__ */ jsx2("div", { className: "documentation-tab-buttons", ref: controlsRef, role: "tablist", children: panels.map((panel, index) => /* @__PURE__ */ jsx2(
+      "button",
+      {
+        "aria-selected": index === active,
+        id: `documentation-tab-${groupId}-${index}`,
+        onClick: () => select(index, true),
+        onKeyDown: (event) => onKeyDown(event, index),
+        role: "tab",
+        tabIndex: index === active ? 0 : -1,
+        type: "button",
+        children: panel.label
+      },
+      panel.label
+    )) }),
+    panels.map((panel, index) => /* @__PURE__ */ jsx2(
+      "section",
+      {
+        "aria-labelledby": `documentation-tab-${groupId}-${index}`,
+        className: "documentation-tab",
+        "data-tab": true,
+        "data-tab-title": panel.label,
+        hidden: index !== active,
+        role: "tabpanel",
+        children: panel.content
+      },
+      panel.label
+    ))
+  ] });
+}
+
+// src/documentation/runtime/page-actions.tsx
+import { useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
+import { Fragment as Fragment2, jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function PageActions({
+  data,
+  onAssistantOpen
+}) {
+  const [copied, setCopied] = useState2(null);
+  const detailsRef = useRef2(null);
+  const actions = data.config.contextual.actions.filter((action) => {
+    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;
+  });
+  const primary = actions[0];
+  useEffect2(() => {
+    const closeOnPointerDown = (event) => {
+      const details = detailsRef.current;
+      if (details && !details.contains(event.target)) details.open = false;
+    };
+    const closeOnEscape = (event) => {
+      if (event.key === "Escape" && detailsRef.current?.open) {
+        detailsRef.current.open = false;
+        detailsRef.current.querySelector("summary")?.focus();
+      }
+    };
+    document.addEventListener("pointerdown", closeOnPointerDown);
+    document.addEventListener("keydown", closeOnEscape);
+    return () => {
+      document.removeEventListener("pointerdown", closeOnPointerDown);
+      document.removeEventListener("keydown", closeOnEscape);
+    };
+  }, []);
+  if (!primary) return null;
+  const markCopied = (action) => {
+    setCopied(action);
+    window.setTimeout(() => setCopied((current) => current === action ? null : current), 1600);
+  };
+  const copyPage = async () => {
+    const response = await fetch(data.page.markdownUrl);
+    if (!response.ok) return;
+    await writeClipboardText(await response.text());
+    markCopied("copy");
+    closeMenu();
+  };
+  const copyMcp = async () => {
+    await writeClipboardText(new URL(documentationPublicPath(data.basePath, "/mcp"), window.location.origin).toString());
+    markCopied("mcp");
+    closeMenu();
+  };
+  const copyMcpInstall = async () => {
+    const mcpUrl = new URL(documentationPublicPath(data.basePath, "/mcp"), window.location.origin).toString();
+    await writeClipboardText(`npx add-mcp ${mcpUrl}`);
+    markCopied("add-mcp");
+    closeMenu();
+  };
+  const closeMenu = () => {
+    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();
+    const prompt = `Use ${markdownUrl} as context. Explain ${data.page.title} and answer my questions about this documentation page.`;
+    const destination = new URL(provider === "chatgpt" ? "https://chatgpt.com/" : "https://claude.ai/new");
+    destination.searchParams.set("q", prompt);
+    window.open(destination.toString(), "_blank", "noopener,noreferrer");
+    closeMenu();
+  };
+  const openMcpEditor = (editor) => {
+    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)}`;
+    } else {
+      const config = encodeURIComponent(JSON.stringify({ name, type: "http", url: mcpUrl }));
+      window.location.href = `vscode:mcp/install?${config}`;
+    }
+    closeMenu();
+  };
+  const content = (icon, label, description, menuItem, external = false) => menuItem ? /* @__PURE__ */ jsxs3(Fragment2, { children: [
+    /* @__PURE__ */ jsx3("span", { className: "documentation-contextual-action-icon", children: icon }),
+    /* @__PURE__ */ jsxs3("span", { className: "documentation-contextual-action-copy", children: [
+      /* @__PURE__ */ jsx3("strong", { children: label }),
+      /* @__PURE__ */ jsx3("small", { children: description })
+    ] }),
+    external && /* @__PURE__ */ jsx3(ExternalIcon, { className: "documentation-contextual-action-external" })
+  ] }) : /* @__PURE__ */ jsxs3(Fragment2, { children: [
+    icon,
+    label
+  ] });
+  const renderAction = (action, menuItem = false) => {
+    const role = menuItem ? "menuitem" : void 0;
+    if (action === "view") {
+      return /* @__PURE__ */ jsx3("a", { href: data.page.markdownUrl, onClick: closeMenu, role, children: content(/* @__PURE__ */ jsx3(FileIcon, {}), "View as Markdown", "Open the raw Markdown page", menuItem) }, action);
+    }
+    if (action === "assistant") {
+      return /* @__PURE__ */ jsx3("button", { role, type: "button", onClick: () => {
+        closeMenu();
+        onAssistantOpen(`Explain the key ideas on ${data.page.title}.`);
+      }, children: content(/* @__PURE__ */ jsx3(OrbitMark, {}), "Ask about this page", "Use the DeepSpace agent with page context", menuItem) }, action);
+    }
+    if (action === "chatgpt" || action === "claude") {
+      const label2 = action === "chatgpt" ? "Open in ChatGPT" : "Open in Claude";
+      return /* @__PURE__ */ jsx3("button", { role, type: "button", onClick: () => openAiContext(action), children: content(/* @__PURE__ */ jsx3(MessageIcon, {}), label2, "Ask questions about this page", menuItem, true) }, action);
+    }
+    if (action === "mcp") {
+      const label2 = copied === action ? "MCP URL copied" : "Copy MCP server URL";
+      return /* @__PURE__ */ jsx3("button", { role, type: "button", onClick: copyMcp, children: content(copied === action ? /* @__PURE__ */ jsx3(CheckIcon, {}) : /* @__PURE__ */ jsx3(CopyIcon, {}), label2, "Copy the same-release documentation endpoint", menuItem) }, action);
+    }
+    if (action === "add-mcp") {
+      const label2 = copied === action ? "Install command copied" : "Copy MCP install command";
+      return /* @__PURE__ */ jsx3("button", { role, type: "button", onClick: copyMcpInstall, children: content(copied === action ? /* @__PURE__ */ jsx3(CheckIcon, {}) : /* @__PURE__ */ jsx3(TerminalIcon, {}), label2, "Copy npx command to install MCP server", menuItem) }, action);
+    }
+    if (action === "cursor" || action === "vscode") {
+      const label2 = action === "cursor" ? "Connect to Cursor" : "Connect to VS Code";
+      return /* @__PURE__ */ jsx3("button", { role, type: "button", onClick: () => openMcpEditor(action), children: content(/* @__PURE__ */ jsx3(EditorIcon, {}), label2, `Install MCP server in ${action === "cursor" ? "Cursor" : "VS Code"}`, menuItem, true) }, action);
+    }
+    const label = copied === action ? "Page copied" : "Copy page";
+    return /* @__PURE__ */ jsx3("button", { role, type: "button", onClick: copyPage, children: content(copied === action ? /* @__PURE__ */ jsx3(CheckIcon, {}) : /* @__PURE__ */ jsx3(CopyIcon, {}), label, "Copy page as Markdown for LLMs", menuItem) }, action);
+  };
+  return /* @__PURE__ */ jsxs3("div", { className: "documentation-contextual-actions", "aria-label": "Page actions", children: [
+    /* @__PURE__ */ jsx3("div", { className: "documentation-contextual-primary", "aria-live": "polite", children: renderAction(primary) }),
+    actions.length > 0 && /* @__PURE__ */ jsxs3("details", { ref: detailsRef, children: [
+      /* @__PURE__ */ jsx3("summary", { "aria-label": "More page actions", children: /* @__PURE__ */ jsx3(ChevronDownIcon, {}) }),
+      /* @__PURE__ */ jsx3("div", { "aria-label": "More page actions", className: "documentation-contextual-menu", role: "menu", children: actions.map((action) => renderAction(action, true)) })
+    ] })
+  ] });
+}
+
+// src/documentation/runtime/article.tsx
+import { Fragment as Fragment3, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+var HTML_PROSE_SCOPE = '.documentation-prose[data-prose="html"]';
+function Article({
+  children,
+  data,
+  launcher,
+  onAssistantOpen
+}) {
+  const articleRef = useRef3(null);
+  const codeBlocks = useCodeBlockMounts(articleRef, data.page.route);
+  useArticleEnhancements(articleRef, data);
+  const controls = useMemo(() => ({
+    assistantEnabled: data.config.assistant.access !== "disabled",
+    onAsk: (code) => onAssistantOpen(`Explain this ${data.page.title} example and the important details:
+
+${code}`)
+  }), [data.config.assistant.access, data.page.title, onAssistantOpen]);
+  return /* @__PURE__ */ jsxs4("article", { className: "documentation-article", ref: articleRef, children: [
+    /* @__PURE__ */ jsx4(Breadcrumbs, { items: data.breadcrumbs }),
+    /* @__PURE__ */ jsxs4("header", { className: "documentation-article-header", children: [
+      /* @__PURE__ */ jsxs4("div", { className: "documentation-article-meta", children: [
+        data.config.theme.eyebrowStyle !== "none" && /* @__PURE__ */ jsx4("div", { className: "documentation-eyebrow", children: data.page.kind === "openapi" ? "API reference" : data.config.theme.eyebrowStyle === "breadcrumbs" ? data.breadcrumbs.join(" / ") : data.breadcrumbs[0] ?? "Documentation" }),
+        /* @__PURE__ */ jsx4(PageActions, { data, onAssistantOpen })
+      ] }),
+      /* @__PURE__ */ jsx4("h1", { children: data.page.title }),
+      data.page.description && /* @__PURE__ */ jsx4("p", { className: "documentation-lede", children: data.page.description })
+    ] }),
+    /* @__PURE__ */ jsx4(OutlineDisclosure, { headings: outlineHeadings(data.page.headings) }),
+    /* @__PURE__ */ jsxs4(CodeBlockControlsProvider, { value: controls, children: [
+      children ?? /* @__PURE__ */ jsx4(
+        "div",
+        {
+          className: "documentation-prose",
+          "data-prose": "html",
+          dangerouslySetInnerHTML: { __html: data.page.html }
+        }
+      ),
+      codeBlocks.map((mount) => createPortal(
+        /* @__PURE__ */ jsx4(CodeBlockActions, { readCode: () => readPreText(mount.pre) }),
+        mount.host,
+        mount.key
+      ))
+    ] }),
+    data.page.openapi?.playground && /* @__PURE__ */ jsx4(ApiPlayground, { operation: data.page.openapi }),
+    launcher && /* @__PURE__ */ jsx4("div", { className: "documentation-launcher-dock", children: launcher }),
+    /* @__PURE__ */ jsxs4("nav", { className: "documentation-pagination", "aria-label": "Page navigation", children: [
+      data.previous ? /* @__PURE__ */ jsxs4("a", { rel: "prev", href: documentationPublicPath(data.basePath, data.previous.route), children: [
+        /* @__PURE__ */ jsx4("small", { children: "Previous" }),
+        /* @__PURE__ */ jsxs4("span", { children: [
+          /* @__PURE__ */ jsx4(ChevronRightIcon, { className: "is-back" }),
+          data.previous.title
+        ] })
+      ] }) : /* @__PURE__ */ jsx4("span", {}),
+      data.next ? /* @__PURE__ */ jsxs4("a", { rel: "next", href: documentationPublicPath(data.basePath, data.next.route), children: [
+        /* @__PURE__ */ jsx4("small", { children: "Next" }),
+        /* @__PURE__ */ jsxs4("span", { children: [
+          data.next.title,
+          /* @__PURE__ */ jsx4(ChevronRightIcon, {})
+        ] })
+      ] }) : /* @__PURE__ */ jsx4("span", {})
+    ] })
+  ] });
+}
+function Breadcrumbs({ items }) {
+  return /* @__PURE__ */ jsx4("nav", { className: "documentation-breadcrumbs", "aria-label": "Breadcrumb", children: items.map((item, index) => /* @__PURE__ */ jsxs4("span", { children: [
+    index > 0 && /* @__PURE__ */ jsx4(ChevronRightIcon, {}),
+    item
+  ] }, `${item}:${items.slice(0, index + 1).join("/")}`)) });
+}
+function outlineHeadings(headings) {
+  return headings.filter((heading) => heading.depth === 2 || heading.depth === 3);
+}
+function OutlineLinks({
+  active,
+  headings
+}) {
+  return /* @__PURE__ */ jsx4(Fragment3, { children: headings.map((heading) => /* @__PURE__ */ jsx4(
+    "a",
+    {
+      "aria-current": active === heading.id ? "location" : void 0,
+      className: `${heading.depth === 3 ? "depth-3 " : ""}${active === heading.id ? "is-active" : ""}`,
+      href: `#${heading.id}`,
+      children: heading.text
+    },
+    heading.id
+  )) });
+}
+function OutlineDisclosure({ headings }) {
+  if (headings.length === 0) return null;
+  return /* @__PURE__ */ jsxs4("details", { className: "documentation-outline-disclosure", children: [
+    /* @__PURE__ */ jsxs4("summary", { children: [
+      /* @__PURE__ */ jsx4(ListIcon, {}),
+      "On this page"
+    ] }),
+    /* @__PURE__ */ jsx4("nav", { className: "documentation-outline", "aria-label": "On this page", children: /* @__PURE__ */ jsx4(OutlineLinks, { active: "", headings }) })
+  ] });
+}
+function ContextRail({
+  data
+}) {
+  const headings = useMemo(() => outlineHeadings(data.page.headings), [data.page.headings]);
+  const [active, setActive] = useState3(headings[0]?.id ?? "");
+  useEffect3(() => setActive(headings[0]?.id ?? ""), [headings]);
+  useEffect3(() => {
+    let frame = null;
+    const measure = () => {
+      frame = null;
+      const root = document.documentElement;
+      const clearance = (Number.parseFloat(getComputedStyle(root).scrollPaddingTop) || 96) + 4;
+      const scrollable = root.scrollHeight > window.innerHeight + 4;
+      const atBottom = scrollable && window.innerHeight + window.scrollY >= root.scrollHeight - 2;
+      let next = headings[0]?.id ?? "";
+      for (const heading of headings) {
+        const element = document.getElementById(heading.id);
+        if (!element) continue;
+        if (element.getBoundingClientRect().top <= clearance) next = heading.id;
+        else break;
+      }
+      if (atBottom) {
+        const hashId = decodeURIComponent(window.location.hash.slice(1));
+        if (hashId && headings.some((heading) => heading.id === hashId)) {
+          const top = document.getElementById(hashId)?.getBoundingClientRect().top;
+          if (top !== void 0 && top > clearance && top < window.innerHeight) next = hashId;
+        }
+      }
+      setActive(next);
+    };
+    const schedule = () => {
+      if (frame === null) frame = window.requestAnimationFrame(measure);
+    };
+    const onOutlineClick = (event) => {
+      if (event.target instanceof Element && event.target.closest(".documentation-outline a")) {
+        window.setTimeout(schedule, 0);
+      }
+    };
+    measure();
+    window.addEventListener("scroll", schedule, { passive: true });
+    window.addEventListener("resize", schedule, { passive: true });
+    window.addEventListener("popstate", schedule);
+    window.addEventListener("hashchange", schedule);
+    document.addEventListener("click", onOutlineClick);
+    return () => {
+      window.removeEventListener("scroll", schedule);
+      window.removeEventListener("resize", schedule);
+      window.removeEventListener("popstate", schedule);
+      window.removeEventListener("hashchange", schedule);
+      document.removeEventListener("click", onOutlineClick);
+      if (frame !== null) window.cancelAnimationFrame(frame);
+    };
+  }, [headings]);
+  return /* @__PURE__ */ jsx4("aside", { className: "documentation-context-rail", "aria-label": "Page context", children: headings.length > 0 && /* @__PURE__ */ jsxs4("nav", { className: "documentation-outline", "aria-label": "On this page", children: [
+    /* @__PURE__ */ jsx4("h2", { children: "On this page" }),
+    /* @__PURE__ */ jsx4(OutlineLinks, { active, headings })
+  ] }) });
+}
+function ApiPlayground({ operation }) {
+  const [body, setBody] = useState3("");
+  const [token, setToken] = useState3("");
+  const [responseText, setResponseText] = useState3("No request sent.");
+  const [sending, setSending] = useState3(false);
+  if (!operation.baseUrl) return null;
+  const url = `${operation.baseUrl.replace(/\/$/, "")}${operation.path}`;
+  const send = async () => {
+    setSending(true);
+    setResponseText("Sending request\u2026");
+    try {
+      const headers = {};
+      if (token) headers.Authorization = `Bearer ${token}`;
+      if (body.trim()) headers["Content-Type"] = "application/json";
+      const response = await fetch(url, {
+        method: operation.method,
+        headers,
+        body: ["GET", "HEAD"].includes(operation.method) ? void 0 : body.trim() || void 0
+      });
+      const text = await response.text();
+      setResponseText(`${response.status} ${response.statusText}
+
+${text}`);
+    } catch (error) {
+      setResponseText(errorMessage(error));
+    } finally {
+      setSending(false);
+    }
+  };
+  return /* @__PURE__ */ jsxs4("section", { className: "documentation-playground", "data-playground": true, children: [
+    /* @__PURE__ */ jsxs4("div", { className: "documentation-playground-title", children: [
+      /* @__PURE__ */ jsxs4("div", { children: [
+        /* @__PURE__ */ jsx4("span", { className: `method method-${operation.method.toLowerCase()}`, children: operation.method }),
+        /* @__PURE__ */ jsx4("strong", { children: "Try this operation" })
+      ] }),
+      /* @__PURE__ */ jsx4("code", { children: url })
+    ] }),
+    /* @__PURE__ */ jsx4("p", { children: "Requests run in your browser. Tokens stay in memory and never enter search or assistant context." }),
+    /* @__PURE__ */ jsxs4("label", { children: [
+      /* @__PURE__ */ jsx4("span", { children: "Bearer token" }),
+      /* @__PURE__ */ jsx4("input", { type: "password", autoCapitalize: "none", autoComplete: "off", autoCorrect: "off", spellCheck: false, value: token, onChange: (event) => setToken(event.target.value), placeholder: "Optional" })
+    ] }),
+    /* @__PURE__ */ jsxs4("label", { children: [
+      /* @__PURE__ */ jsx4("span", { children: "JSON body" }),
+      /* @__PURE__ */ jsx4("textarea", { rows: 7, autoCapitalize: "none", autoComplete: "off", autoCorrect: "off", spellCheck: false, value: body, onChange: (event) => setBody(event.target.value), placeholder: "{}" })
+    ] }),
+    /* @__PURE__ */ jsx4("button", { type: "button", disabled: sending, onClick: send, children: sending ? "Sending\u2026" : `Send ${operation.method} request` }),
+    /* @__PURE__ */ jsx4("pre", { "aria-live": "polite", children: responseText })
+  ] });
+}
+function useCodeBlockMounts(articleRef, route) {
+  const [mounts, setMounts] = useState3([]);
+  useEffect3(() => {
+    const article = articleRef.current;
+    if (!article) return;
+    const created = [];
+    const next = [];
+    article.querySelectorAll(HTML_PROSE_SCOPE + " pre").forEach((pre, index) => {
+      const block = document.createElement("div");
+      block.className = "documentation-code-block";
+      pre.replaceWith(block);
+      block.appendChild(pre);
+      const title = pre.getAttribute("data-code-title");
+      if (title && !block.closest("[data-tab-group]")) {
+        const bar = document.createElement("div");
+        bar.className = "documentation-code-title";
+        bar.textContent = title;
+        block.insertBefore(bar, pre);
+      }
+      const host = document.createElement("div");
+      host.className = "documentation-code-actions";
+      const language = codeBlockLanguage(pre.querySelector("code")?.className ?? "");
+      if (language) {
+        const label = document.createElement("span");
+        label.className = "documentation-code-language";
+        label.textContent = language;
+        host.appendChild(label);
+      }
+      block.appendChild(host);
+      created.push({ block, pre });
+      next.push({ key: `${route}:${index}`, host, pre });
+    });
+    setMounts(next);
+    return () => {
+      setMounts([]);
+      for (const { block, pre } of created) block.replaceWith(pre);
+    };
+  }, [articleRef, route]);
+  return mounts;
+}
+function readPreText(pre) {
+  return pre.querySelector("code")?.textContent ?? pre.textContent ?? "";
+}
+function useArticleEnhancements(articleRef, data) {
+  useEffect3(() => {
+    const article = articleRef.current;
+    if (!article) return;
+    const cleanups = [];
+    article.querySelectorAll(`${HTML_PROSE_SCOPE} [data-tab-group]`).forEach((group, groupIndex) => {
+      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 = "documentation-tab-buttons";
+      controls.setAttribute("role", "tablist");
+      const labels = tabs.map((tab, tabIndex) => tab.dataset.tabTitle ?? `Tab ${tabIndex + 1}`);
+      const activate = (activeIndex, broadcast = false) => {
+        tabs.forEach((tab, index) => {
+          tab.hidden = index !== activeIndex;
+          tab.setAttribute("role", "tabpanel");
+        });
+        Array.from(controls.querySelectorAll("button")).forEach((button, index) => {
+          button.setAttribute("aria-selected", index === activeIndex ? "true" : "false");
+          button.setAttribute("tabindex", index === activeIndex ? "0" : "-1");
+        });
+        if (broadcast) {
+          const label = labels[activeIndex];
+          if (label) {
+            safeStorageSet("deepspace-documentation-tab-selection", label);
+            document.dispatchEvent(new CustomEvent("deepspace-documentation-tab-change", {
+              detail: { label, source: group }
+            }));
+          }
+        }
+      };
+      tabs.forEach((tab, tabIndex) => {
+        const button = document.createElement("button");
+        button.type = "button";
+        button.id = `documentation-tab-${groupIndex}-${tabIndex}`;
+        button.setAttribute("role", "tab");
+        button.textContent = labels[tabIndex];
+        tab.setAttribute("aria-labelledby", button.id);
+        const click = () => activate(tabIndex, true);
+        const keydown = (event) => {
+          if (!["ArrowLeft", "ArrowRight", "Home", "End"].includes(event.key)) return;
+          event.preventDefault();
+          const next = event.key === "Home" ? 0 : event.key === "End" ? tabs.length - 1 : (tabIndex + (event.key === "ArrowRight" ? 1 : -1) + tabs.length) % tabs.length;
+          activate(next);
+          controls.querySelectorAll("button")[next]?.focus();
+        };
+        button.addEventListener("click", click);
+        button.addEventListener("keydown", keydown);
+        controls.appendChild(button);
+        cleanups.push(() => {
+          button.removeEventListener("click", click);
+          button.removeEventListener("keydown", keydown);
+        });
+      });
+      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) => {
+        const detail = event.detail;
+        if (!detail?.label || detail.source === group) return;
+        const matchingIndex = labels.findIndex((label) => label === detail.label);
+        if (matchingIndex >= 0) activate(matchingIndex);
+      };
+      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-documentation-tab-change", sync);
+        controls.remove();
+      });
+    });
+    return () => cleanups.reverse().forEach((cleanup) => cleanup());
+  }, [articleRef, data.page.route]);
+}
+
+// src/documentation/runtime/assistant.tsx
+import {
+  useEffect as useEffect5,
+  useRef as useRef4,
+  useState as useState4
+} from "react";
+
+// src/client/ai-stream.ts
+function parseSseLine(line) {
+  if (!line) return null;
+  if (line.startsWith(":")) return null;
+  if (!line.startsWith("data:")) return null;
+  const raw = line.slice(5).replace(/^ /, "").replace(/\r$/, "");
+  if (raw === "[DONE]") return null;
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object") return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+// 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];
+    if (user?.role !== "user" || user.state !== void 0 || !user.text.trim()) continue;
+    const assistant = messages[index + 1];
+    if (assistant?.role !== "assistant" || assistant.state !== void 0 || !assistant.text.trim()) {
+      continue;
+    }
+    pairs.push([
+      { role: "user", content: user.text },
+      { role: "assistant", content: assistant.text }
+    ]);
+    index += 1;
+  }
+  const pairLimit = Math.max(0, Math.floor(maxMessages / 2));
+  if (pairLimit === 0) return [];
+  return pairs.slice(-pairLimit).flat();
+}
+
+// src/documentation/runtime/dialog.ts
+import { useEffect as useEffect4 } from "react";
+function useDialogFocus(open, ref, onClose, trap = true, restoreId) {
+  useEffect4(() => {
+    if (!open) return;
+    const previous = document.activeElement;
+    const element = ref.current;
+    const frame = window.requestAnimationFrame(() => {
+      const target = element?.querySelector("[data-autofocus]") ?? element?.querySelector("button,a,input,textarea");
+      target?.focus();
+    });
+    const keydown = (event) => {
+      if (event.key === "Escape") {
+        event.preventDefault();
+        onClose();
+        return;
+      }
+      if (!trap || event.key !== "Tab" || !element) return;
+      const focusable = Array.from(element.querySelectorAll(
+        'a[href],button:not([disabled]),input:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])'
+      ));
+      if (focusable.length === 0) return;
+      const first = focusable[0];
+      const last = focusable[focusable.length - 1];
+      if (event.shiftKey && document.activeElement === first) {
+        event.preventDefault();
+        last?.focus();
+      } else if (!event.shiftKey && document.activeElement === last) {
+        event.preventDefault();
+        first?.focus();
+      }
+    };
+    document.addEventListener("keydown", keydown);
+    return () => {
+      window.cancelAnimationFrame(frame);
+      document.removeEventListener("keydown", keydown);
+      const restoreTarget = restoreId ? document.getElementById(restoreId) : previous?.isConnected && previous !== document.body && !element?.contains(previous) ? previous : null;
+      restoreTarget?.focus();
+    };
+  }, [onClose, open, ref, restoreId, trap]);
+}
+
+// src/documentation/runtime/assistant.tsx
+import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+function AssistantLauncher({
+  input,
+  name,
+  onInputChange,
+  onSubmit
+}) {
+  const subject = documentationSubject(name);
+  const submit = (event) => {
+    event.preventDefault();
+    const question = input.trim();
+    if (!question) return;
+    onSubmit(question);
+  };
+  return /* @__PURE__ */ jsxs5(
+    "form",
+    {
+      className: "documentation-assistant-launcher",
+      id: "deepspace-documentation-assistant-launcher",
+      onSubmit: submit,
+      children: [
+        /* @__PURE__ */ jsx5(
+          "input",
+          {
+            "aria-label": `Ask the ${subject} agent`,
+            autoCapitalize: "sentences",
+            autoComplete: "off",
+            autoCorrect: "off",
+            enterKeyHint: "send",
+            id: "deepspace-documentation-assistant-launcher-input",
+            maxLength: 4e3,
+            onChange: (event) => onInputChange(event.target.value),
+            placeholder: "Ask anything\u2026",
+            spellCheck: false,
+            value: input
+          }
+        ),
+        /* @__PURE__ */ jsxs5("span", { "aria-hidden": "true", className: "documentation-launcher-hint", children: [
+          /* @__PURE__ */ jsx5("kbd", { children: "\u2318" }),
+          /* @__PURE__ */ jsx5("kbd", { children: "I" })
+        ] }),
+        /* @__PURE__ */ jsx5("button", { className: "documentation-launcher-send", type: "submit", disabled: !input.trim(), "aria-label": "Send question to documentation agent", children: /* @__PURE__ */ jsx5(SendIcon, {}) })
+      ]
+    }
+  );
+}
+function DocumentationAssistant({
+  access,
+  basePath,
+  input,
+  name,
+  onClose,
+  onInputChange,
+  open,
+  route,
+  seed,
+  suggestions
+}) {
+  const panelRef = useRef4(null);
+  const formRef = useRef4(null);
+  const messagesRef = useRef4(null);
+  const composerRef = useRef4(null);
+  const abortRef = useRef4(null);
+  const queuedQuestionRef = useRef4(null);
+  const handledSeedRef = useRef4(0);
+  const [messages, setMessages] = useState4([
+    { id: "welcome", role: "assistant", text: `I can search the ${documentationSubject(name)} and cite the exact pages I use.` }
+  ]);
+  const [sending, setSending] = useState4(false);
+  useDialogFocus(open, panelRef, onClose, false, "deepspace-documentation-assistant-launcher-input");
+  useEffect5(() => {
+    if (!open || seed.id === 0 || handledSeedRef.current === seed.id) return;
+    handledSeedRef.current = seed.id;
+    if (!seed.submit || !seed.value?.trim()) return;
+    queuedQuestionRef.current = seed.value;
+    const frame = window.requestAnimationFrame(() => formRef.current?.requestSubmit());
+    return () => window.cancelAnimationFrame(frame);
+  }, [open, seed]);
+  useEffect5(() => {
+    const element = messagesRef.current;
+    if (element) element.scrollTop = element.scrollHeight;
+  }, [messages]);
+  useEffect5(() => {
+    const element = composerRef.current;
+    if (!element) return;
+    element.style.height = "auto";
+    element.style.height = `${Math.min(element.scrollHeight, 160)}px`;
+    element.style.overflowY = element.scrollHeight > 160 ? "auto" : "hidden";
+  }, [input, open]);
+  useEffect5(() => () => abortRef.current?.abort(), []);
+  if (!open) return null;
+  const submit = async (event) => {
+    event?.preventDefault();
+    const question = (queuedQuestionRef.current ?? input).trim();
+    queuedQuestionRef.current = null;
+    if (!question || sending) return;
+    const transcript = completedDocumentationAssistantTranscript(messages);
+    onInputChange("");
+    setSending(true);
+    const userId = `user-${Date.now()}`;
+    const answerId = `assistant-${Date.now()}`;
+    setMessages((current) => [...current, { id: userId, role: "user", text: question }, { id: answerId, role: "assistant", text: "", state: "streaming", status: "Searching this documentation\u2026" }]);
+    const controller = new AbortController();
+    abortRef.current = controller;
+    let timedOut = false;
+    const slowTimer = window.setTimeout(() => {
+      setMessages((current) => current.map((message) => message.id === answerId ? { ...message, status: "Still working through the documentation\u2026" } : message));
+    }, 12e3);
+    const timeoutTimer = window.setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, 12e4);
+    try {
+      const headers = {
+        "Content-Type": "application/json"
+      };
+      if (access === "authenticated") {
+        const tokenResponse = await fetch("/api/auth/token", { method: "POST", credentials: "include", headers: { "Content-Type": "application/json" } });
+        const tokenData = tokenResponse.ok ? await tokenResponse.json().catch(() => null) : null;
+        if (!tokenData?.token) throw new Error("Sign in to use the documentation assistant.");
+        headers.Authorization = `Bearer ${tokenData.token}`;
+      }
+      const response = await fetch(documentationPublicPath(basePath, "/api/ai"), {
+        method: "POST",
+        headers,
+        body: JSON.stringify({ question, route, messages: transcript }),
+        signal: controller.signal
+      });
+      if (!response.ok || !response.body) {
+        const body = await response.json().catch(() => null);
+        throw new Error(body?.error ?? `Assistant unavailable (${response.status})`);
+      }
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = "";
+      let answer = "";
+      const consumeLine = (line) => {
+        const data = parseSseLine(line);
+        if (!data) return;
+        if (data.type === "text-delta" && typeof data.delta === "string") {
+          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 === "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));
+        } else if (data.type === "error") {
+          throw new Error(typeof data.errorText === "string" ? data.errorText : "The assistant stream failed.");
+        }
+      };
+      while (true) {
+        const chunk = await reader.read();
+        if (chunk.done) break;
+        buffer += decoder.decode(chunk.value, { stream: true });
+        const lines = buffer.split(/\r?\n/);
+        buffer = lines.pop() ?? "";
+        for (const line of lines) consumeLine(line);
+      }
+      buffer += decoder.decode();
+      consumeLine(buffer);
+      setMessages((current) => current.map((message) => message.id === answerId ? { ...message, text: answer || "No answer was returned.", state: void 0 } : message));
+    } catch (error) {
+      const message = timedOut ? "The documentation search took too long. Try a narrower question." : controller.signal.aborted ? "Response stopped." : errorMessage(error);
+      setMessages((current) => current.map((item) => item.id === answerId ? { ...item, text: message, state: "error" } : item));
+    } finally {
+      window.clearTimeout(slowTimer);
+      window.clearTimeout(timeoutTimer);
+      abortRef.current = null;
+      setSending(false);
+    }
+  };
+  const defaults = suggestions ?? ["How do I get started?", "Show me a complete example", "What should I understand first?"];
+  return /* @__PURE__ */ jsxs5(
+    "aside",
+    {
+      "aria-label": "Documentation assistant",
+      className: "documentation-assistant",
+      id: "deepspace-documentation-assistant",
+      ref: panelRef,
+      role: "complementary",
+      children: [
+        /* @__PURE__ */ jsxs5("header", { children: [
+          /* @__PURE__ */ jsx5("div", { children: /* @__PURE__ */ jsxs5("span", { children: [
+            /* @__PURE__ */ jsxs5("strong", { id: "deepspace-documentation-assistant-title", children: [
+              "Ask ",
+              name
+            ] }),
+            /* @__PURE__ */ jsx5("small", { children: "Answers from this documentation build" })
+          ] }) }),
+          /* @__PURE__ */ jsx5("button", { type: "button", onClick: onClose, "aria-label": "Close documentation assistant", children: /* @__PURE__ */ jsx5(CloseIcon, {}) })
+        ] }),
+        /* @__PURE__ */ jsxs5("div", { className: "documentation-assistant-messages", ref: messagesRef, "aria-live": "polite", children: [
+          messages.map((message) => /* @__PURE__ */ jsx5("div", { className: `documentation-assistant-message is-${message.role}${message.state ? ` is-${message.state}` : ""}`, children: /* @__PURE__ */ jsxs5("div", { children: [
+            message.role === "assistant" ? /* @__PURE__ */ jsx5(AssistantMarkdown, { value: message.text }) : message.text,
+            message.state === "streaming" && !message.text && /* @__PURE__ */ jsxs5("span", { className: "documentation-assistant-activity", role: "status", children: [
+              /* @__PURE__ */ jsx5("span", { "aria-hidden": "true" }),
+              message.status ?? "Working\u2026"
+            ] })
+          ] }) }, message.id)),
+          messages.length === 1 && /* @__PURE__ */ jsxs5("div", { className: "documentation-assistant-suggestions", children: [
+            /* @__PURE__ */ jsx5("p", { children: "Try asking" }),
+            defaults.map((suggestion) => /* @__PURE__ */ jsx5("button", { type: "button", onClick: () => onInputChange(suggestion), children: suggestion }, suggestion))
+          ] })
+        ] }),
+        /* @__PURE__ */ jsxs5("form", { className: "documentation-assistant-composer", onSubmit: submit, ref: formRef, children: [
+          /* @__PURE__ */ jsx5(
+            "textarea",
+            {
+              "aria-label": "Ask a documentation question",
+              autoCapitalize: "sentences",
+              autoComplete: "off",
+              autoCorrect: "off",
+              "data-autofocus": true,
+              enterKeyHint: "send",
+              maxLength: 4e3,
+              onChange: (event) => onInputChange(event.target.value),
+              onKeyDown: (event) => {
+                if (event.key === "Enter" && !event.shiftKey) {
+                  event.preventDefault();
+                  void submit();
+                }
+              },
+              placeholder: "Ask a question about this documentation",
+              ref: composerRef,
+              rows: 1,
+              spellCheck: false,
+              value: input
+            }
+          ),
+          sending ? /* @__PURE__ */ jsx5("button", { type: "button", onClick: () => abortRef.current?.abort(), "aria-label": "Stop response", children: /* @__PURE__ */ jsx5(StopIcon, {}) }) : /* @__PURE__ */ jsx5("button", { type: "submit", disabled: !input.trim(), "aria-label": "Send question", children: /* @__PURE__ */ jsx5(SendIcon, {}) })
+        ] }),
+        /* @__PURE__ */ jsx5("footer", { children: "Responses cite this deployment and may still contain mistakes." })
+      ]
+    }
+  );
+}
+function AssistantMarkdown({ value }) {
+  const blocks = [];
+  const fence = /```([^\n`]*)\n([\s\S]*?)(?:```|$)/g;
+  let cursor = 0;
+  for (const match of value.matchAll(fence)) {
+    const index = match.index ?? 0;
+    if (index > cursor) blocks.push(...renderAssistantText(value.slice(cursor, index), `text-${cursor}`));
+    blocks.push(
+      /* @__PURE__ */ jsx5(
+        AssistantCodeBlock,
+        {
+          code: (match[2] ?? "").replace(/\n$/, ""),
+          language: (match[1] ?? "").trim().split(/\s+/, 1)[0] ?? ""
+        },
+        `code-${index}`
+      )
+    );
+    cursor = index + match[0].length;
+  }
+  if (cursor < value.length) blocks.push(...renderAssistantText(value.slice(cursor), `text-${cursor}`));
+  return /* @__PURE__ */ jsx5("div", { className: "documentation-assistant-markdown", children: blocks });
+}
+function AssistantCodeBlock({ code, language }) {
+  const [copied, setCopied] = useState4(false);
+  const copy = async () => {
+    await writeClipboardText(code);
+    setCopied(true);
+    window.setTimeout(() => setCopied(false), 1400);
+  };
+  return /* @__PURE__ */ jsxs5("figure", { className: "documentation-assistant-code", children: [
+    /* @__PURE__ */ jsxs5("figcaption", { children: [
+      /* @__PURE__ */ jsx5("span", { children: language || "Code" }),
+      /* @__PURE__ */ jsx5("button", { type: "button", onClick: copy, children: copied ? "Copied" : "Copy" })
+    ] }),
+    /* @__PURE__ */ jsx5("pre", { children: /* @__PURE__ */ jsx5("code", { children: code }) })
+  ] });
+}
+function renderAssistantText(value, keyPrefix) {
+  const lines = value.split("\n");
+  const blocks = [];
+  let index = 0;
+  while (index < lines.length) {
+    const line = lines[index]?.trim() ?? "";
+    if (!line) {
+      index += 1;
+      continue;
+    }
+    const heading = line.match(/^(#{1,4})\s+(.+)$/);
+    if (heading) {
+      blocks.push(/* @__PURE__ */ jsx5("strong", { className: "documentation-assistant-heading", children: renderInlineMarkdown(heading[2]) }, `${keyPrefix}-heading-${index}`));
+      index += 1;
+      continue;
+    }
+    const unordered = /^[-*]\s+/.test(line);
+    const ordered = /^\d+[.)]\s+/.test(line);
+    if (unordered || ordered) {
+      const items = [];
+      while (index < lines.length) {
+        const candidate = lines[index]?.trim() ?? "";
+        const match = unordered ? candidate.match(/^[-*]\s+(.+)$/) : candidate.match(/^\d+[.)]\s+(.+)$/);
+        if (!match) break;
+        items.push(/* @__PURE__ */ jsx5("li", { children: renderInlineMarkdown(match[1]) }, `${keyPrefix}-item-${index}`));
+        index += 1;
+      }
+      blocks.push(unordered ? /* @__PURE__ */ jsx5("ul", { children: items }, `${keyPrefix}-list-${index}`) : /* @__PURE__ */ jsx5("ol", { children: items }, `${keyPrefix}-list-${index}`));
+      continue;
+    }
+    const paragraph = [line];
+    index += 1;
+    while (index < lines.length) {
+      const candidate = lines[index]?.trim() ?? "";
+      if (!candidate || /^(?:#{1,4}\s+|[-*]\s+|\d+[.)]\s+)/.test(candidate)) break;
+      paragraph.push(candidate);
+      index += 1;
+    }
+    blocks.push(/* @__PURE__ */ jsx5("p", { children: paragraph.map((part, partIndex) => /* @__PURE__ */ jsxs5("span", { children: [
+      renderInlineMarkdown(part),
+      partIndex < paragraph.length - 1 && " "
+    ] }, `${partIndex}:${part.slice(0, 18)}`)) }, `${keyPrefix}-paragraph-${index}`));
+  }
+  return blocks;
+}
+function renderInlineMarkdown(value) {
+  const pattern = /(\[[^\]]+\]\((?:https?:\/\/|\/)[^)]+\)|`[^`]+`|\*\*[^*]+\*\*)/g;
+  return value.split(pattern).filter(Boolean).map((part, index) => {
+    const link = part.match(/^\[([^\]]+)\]\(((?:https?:\/\/|\/)[^)]+)\)$/);
+    if (link) return /* @__PURE__ */ jsx5("a", { href: link[2], ...externalProps(link[2]), children: link[1] }, `${index}:${part}`);
+    if (part.startsWith("`") && part.endsWith("`")) return /* @__PURE__ */ jsx5("code", { children: part.slice(1, -1) }, `${index}:${part}`);
+    if (part.startsWith("**") && part.endsWith("**")) return /* @__PURE__ */ jsx5("strong", { children: part.slice(2, -2) }, `${index}:${part}`);
+    return /* @__PURE__ */ jsx5("span", { children: part }, `${index}:${part}`);
+  });
+}
+
+// src/documentation/runtime/navigation.tsx
+import { useEffect as useEffect6, useRef as useRef5, useState as useState5 } from "react";
+
+// package.json
+var version = "0.35.0";
+
+// src/documentation/runtime/navigation.tsx
+import { Fragment as Fragment4, jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+function DocumentationHeader({
+  data,
+  onMenuOpen,
+  onSearchOpen
+}) {
+  return /* @__PURE__ */ jsxs6("header", { className: "documentation-header", children: [
+    /* @__PURE__ */ jsx6(
+      "a",
+      {
+        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__ */ jsx6(BrandLogo, { data })
+      }
+    ),
+    /* @__PURE__ */ jsx6("div", { className: "documentation-header-center", children: /* @__PURE__ */ jsxs6("button", { className: "documentation-search-trigger", type: "button", onClick: onSearchOpen, "aria-label": "Search documentation", children: [
+      /* @__PURE__ */ jsx6(SearchIcon, {}),
+      /* @__PURE__ */ jsx6("span", { children: "Search documentation" }),
+      /* @__PURE__ */ jsx6("kbd", { children: "\u2318K" })
+    ] }) }),
+    /* @__PURE__ */ jsx6("nav", { className: "documentation-top-links", "aria-label": "Product navigation", children: data.config.links.map((link) => /* @__PURE__ */ jsxs6("a", { href: link.href, ...externalProps(link.href), children: [
+      link.label,
+      isExternal(link.href) && /* @__PURE__ */ jsx6(ExternalIcon, {})
+    ] }, `${link.label}:${link.href}`)) }),
+    /* @__PURE__ */ jsxs6("div", { className: "documentation-mobile-actions", children: [
+      /* @__PURE__ */ jsx6("button", { className: "documentation-icon-button", type: "button", onClick: onSearchOpen, "aria-label": "Search documentation", children: /* @__PURE__ */ jsx6(SearchIcon, {}) }),
+      /* @__PURE__ */ jsx6("button", { className: "documentation-icon-button", type: "button", onClick: onMenuOpen, "aria-label": "Open documentation navigation", children: /* @__PURE__ */ jsx6(MenuIcon, {}) })
+    ] })
+  ] });
+}
+function BrandLogo({ data }) {
+  const { logo, logoDark } = data.config.theme;
+  if (logo) {
+    return /* @__PURE__ */ jsxs6(Fragment4, { children: [
+      /* @__PURE__ */ jsx6("img", { className: "documentation-brand-logo documentation-brand-logo-light", src: logo, alt: "" }),
+      /* @__PURE__ */ jsx6("img", { className: "documentation-brand-logo documentation-brand-logo-dark", src: logoDark ?? logo, alt: "" }),
+      /* @__PURE__ */ jsx6("span", { className: "documentation-brand-product", children: "Documentation" })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs6(Fragment4, { children: [
+    /* @__PURE__ */ jsx6("span", { className: "documentation-brand-mark", children: /* @__PURE__ */ jsx6(OrbitMark, {}) }),
+    /* @__PURE__ */ jsx6("span", { className: "documentation-brand-name", children: data.config.name })
+  ] });
+}
+function DesktopSidebar({ data }) {
+  return /* @__PURE__ */ jsxs6("aside", { className: "documentation-sidebar", "aria-label": "Documentation navigation", children: [
+    /* @__PURE__ */ jsx6("nav", { className: "documentation-page-tree", children: /* @__PURE__ */ jsx6(NavigationTree, { activeRoute: data.page.route, basePath: data.basePath, nodes: data.navigation }) }),
+    /* @__PURE__ */ jsxs6("div", { className: "documentation-sidebar-footer", children: [
+      !data.config.theme.strictMode && /* @__PURE__ */ jsx6(ThemeControls, { defaultMode: data.config.theme.defaultMode ?? "system" }),
+      data.config.footer.length > 0 && /* @__PURE__ */ jsx6("nav", { "aria-label": "Documentation footer", children: data.config.footer.map((link) => /* @__PURE__ */ jsx6("a", { href: link.href, ...externalProps(link.href), children: link.label }, `${link.label}:${link.href}`)) }),
+      /* @__PURE__ */ jsx6("span", { children: `Built with deepspace ${version}` })
+    ] })
+  ] });
+}
+function NavigationTree({
+  activeRoute,
+  basePath,
+  depth = 0,
+  nodes
+}) {
+  return /* @__PURE__ */ jsx6(Fragment4, { children: nodes.map((node) => {
+    if (node.kind === "group") {
+      const active2 = containsRoute(node, activeRoute);
+      if (depth === 0) {
+        return /* @__PURE__ */ jsxs6("section", { className: "documentation-nav-section", children: [
+          /* @__PURE__ */ jsx6("h2", { children: node.label }),
+          /* @__PURE__ */ jsx6(NavigationTree, { activeRoute, basePath, depth: depth + 1, nodes: node.items })
+        ] }, `group:${node.label}`);
+      }
+      return /* @__PURE__ */ jsxs6("details", { className: "documentation-nav-folder", open: active2, children: [
+        /* @__PURE__ */ jsxs6("summary", { children: [
+          /* @__PURE__ */ jsx6("span", { children: node.label }),
+          /* @__PURE__ */ jsx6(ChevronDownIcon, {})
+        ] }),
+        /* @__PURE__ */ jsx6("div", { children: /* @__PURE__ */ jsx6(NavigationTree, { activeRoute, basePath, depth: depth + 1, nodes: node.items }) })
+      ] }, `group:${node.label}`);
+    }
+    const href = node.kind === "page" ? documentationPublicPath(basePath, node.route) : node.href;
+    const active = node.kind === "page" && node.route === activeRoute;
+    return /* @__PURE__ */ jsxs6(
+      "a",
+      {
+        "aria-current": active ? "page" : void 0,
+        className: active ? "documentation-nav-link is-active" : "documentation-nav-link",
+        href,
+        ...externalProps(href),
+        children: [
+          /* @__PURE__ */ jsx6("span", { children: node.label }),
+          isExternal(href) && /* @__PURE__ */ jsx6(ExternalIcon, {})
+        ]
+      },
+      `${node.kind}:${href}`
+    );
+  }) });
+}
+function MobileNavigation({
+  data,
+  onClose,
+  open
+}) {
+  const dialogRef = useRef5(null);
+  useDialogFocus(open, dialogRef, onClose);
+  if (!open) return null;
+  return /* @__PURE__ */ jsx6("div", { className: "documentation-modal-layer", role: "presentation", onMouseDown: (event) => {
+    if (event.currentTarget === event.target) onClose();
+  }, children: /* @__PURE__ */ jsxs6("div", { className: "documentation-mobile-nav", role: "dialog", "aria-modal": "true", "aria-label": "Documentation navigation", ref: dialogRef, children: [
+    /* @__PURE__ */ jsxs6("header", { children: [
+      /* @__PURE__ */ jsx6(
+        "a",
+        {
+          "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__ */ jsx6(BrandLogo, { data })
+        }
+      ),
+      /* @__PURE__ */ jsx6("button", { className: "documentation-icon-button", type: "button", onClick: onClose, "aria-label": "Close documentation navigation", "data-autofocus": true, children: /* @__PURE__ */ jsx6(CloseIcon, {}) })
+    ] }),
+    /* @__PURE__ */ jsx6("nav", { className: "documentation-page-tree", children: /* @__PURE__ */ jsx6(NavigationTree, { activeRoute: data.page.route, basePath: data.basePath, nodes: data.navigation }) }),
+    /* @__PURE__ */ jsxs6("footer", { children: [
+      !data.config.theme.strictMode && /* @__PURE__ */ jsx6(ThemeControls, { defaultMode: data.config.theme.defaultMode ?? "system" }),
+      data.config.footer.map((link) => /* @__PURE__ */ jsx6("a", { href: link.href, ...externalProps(link.href), children: link.label }, `${link.label}:${link.href}`))
+    ] })
+  ] }) });
+}
+function ThemeControls({ defaultMode }) {
+  const [mode, setMode] = useState5(defaultMode);
+  useEffect6(() => {
+    const saved = safeStorageGet("deepspace-documentation-theme");
+    if (saved === "light" || saved === "dark" || saved === "system") setMode(saved);
+  }, []);
+  useEffect6(() => applyThemeMode(mode), [mode]);
+  const choose = (next) => {
+    setMode(next);
+    safeStorageSet("deepspace-documentation-theme", next);
+  };
+  return /* @__PURE__ */ jsxs6("div", { className: "documentation-theme-controls", role: "group", "aria-label": "Theme preference", children: [
+    /* @__PURE__ */ jsx6("button", { "aria-pressed": mode === "system", "aria-label": "Use system theme", onClick: () => choose("system"), type: "button", children: /* @__PURE__ */ jsx6(SystemIcon, {}) }),
+    /* @__PURE__ */ jsx6("button", { "aria-pressed": mode === "light", "aria-label": "Use light theme", onClick: () => choose("light"), type: "button", children: /* @__PURE__ */ jsx6(SunIcon, {}) }),
+    /* @__PURE__ */ jsx6("button", { "aria-pressed": mode === "dark", "aria-label": "Use dark theme", onClick: () => choose("dark"), type: "button", children: /* @__PURE__ */ jsx6(MoonIcon, {}) })
+  ] });
+}
+function containsRoute(node, route) {
+  return node.items.some((item) => item.kind === "page" ? item.route === route : item.kind === "group" && containsRoute(item, route));
+}
+function applyThemeMode(mode) {
+  const media = window.matchMedia("(prefers-color-scheme: dark)");
+  const apply = () => {
+    document.documentElement.dataset.themeMode = mode;
+    document.documentElement.dataset.theme = mode === "system" ? media.matches ? "dark" : "light" : mode;
+  };
+  apply();
+  media.addEventListener?.("change", apply);
+  return () => media.removeEventListener?.("change", apply);
+}
+
+// src/documentation/runtime/search.tsx
+import {
+  useEffect as useEffect7,
+  useMemo as useMemo2,
+  useRef as useRef6,
+  useState as useState6
+} from "react";
+import { Fragment as Fragment5, jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
+function SearchCommand({
+  assistantEnabled,
+  basePath,
+  name,
+  onAssistantOpen,
+  onClose,
+  onNavigate,
+  open
+}) {
+  const dialogRef = useRef6(null);
+  const resultsRef = useRef6(null);
+  const [index, setIndex] = useState6(null);
+  const [loading, setLoading] = useState6(false);
+  const [query, setQuery] = useState6("");
+  const [activeIndex, setActiveIndex] = useState6(0);
+  useDialogFocus(open, dialogRef, onClose);
+  useEffect7(() => {
+    if (!open || index || loading) return;
+    setLoading(true);
+    fetch(documentationPublicPath(basePath, "/search.json")).then((response) => response.ok ? response.json() : []).then(setIndex).catch(() => setIndex([])).finally(() => setLoading(false));
+  }, [basePath, index, loading, open]);
+  useEffect7(() => {
+    if (!open) {
+      setQuery("");
+      setActiveIndex(0);
+    }
+  }, [open]);
+  useEffect7(() => {
+    resultsRef.current?.querySelector(`#documentation-search-option-${activeIndex}`)?.scrollIntoView({ block: "nearest" });
+  }, [activeIndex, query]);
+  const preparedIndex = useMemo2(() => prepareSearchIndex(index ?? []), [index]);
+  const results = useMemo2(() => rankSearch(preparedIndex, query), [preparedIndex, query]);
+  if (!open) return null;
+  const selectableCount = results.length + (assistantEnabled && query.trim() ? 1 : 0);
+  const handleKeyDown = (event) => {
+    if (event.key === "ArrowDown" && selectableCount > 0) {
+      event.preventDefault();
+      setActiveIndex((current) => (current + 1) % selectableCount);
+    } else if (event.key === "ArrowUp" && selectableCount > 0) {
+      event.preventDefault();
+      setActiveIndex((current) => (current - 1 + selectableCount) % selectableCount);
+    } else if (event.key === "Enter") {
+      event.preventDefault();
+      const result = activeIndex < results.length ? results[activeIndex] : void 0;
+      if (result) {
+        onClose();
+        const href = documentationPublicPath(basePath, result.href);
+        if (onNavigate) onNavigate(href);
+        else window.location.assign(href);
+      } else if (assistantEnabled && query.trim()) {
+        onAssistantOpen(query.trim());
+      }
+    }
+  };
+  return /* @__PURE__ */ jsx7("div", { className: "documentation-modal-layer documentation-search-layer", role: "presentation", onMouseDown: (event) => {
+    if (event.currentTarget === event.target) onClose();
+  }, children: /* @__PURE__ */ jsxs7("div", { className: "documentation-search-dialog", role: "dialog", "aria-modal": "true", "aria-label": "Search documentation", ref: dialogRef, children: [
+    /* @__PURE__ */ jsxs7("label", { className: "documentation-search-input", children: [
+      /* @__PURE__ */ jsx7(SearchIcon, {}),
+      /* @__PURE__ */ jsx7(
+        "input",
+        {
+          "aria-activedescendant": selectableCount > 0 ? `documentation-search-option-${activeIndex}` : void 0,
+          "aria-controls": "documentation-search-results",
+          "aria-expanded": "true",
+          "aria-label": `Search ${documentationSubject(name)}`,
+          autoCapitalize: "none",
+          autoComplete: "off",
+          autoCorrect: "off",
+          "data-autofocus": true,
+          enterKeyHint: "go",
+          onChange: (event) => {
+            setQuery(event.target.value);
+            setActiveIndex(0);
+          },
+          onKeyDown: handleKeyDown,
+          placeholder: `Search ${name}`,
+          role: "combobox",
+          spellCheck: false,
+          value: query
+        }
+      ),
+      /* @__PURE__ */ jsx7("kbd", { children: "Esc" })
+    ] }),
+    /* @__PURE__ */ jsxs7("div", { className: "documentation-search-results", id: "documentation-search-results", ref: resultsRef, role: "listbox", "aria-label": "Search results", children: [
+      !query.trim() && /* @__PURE__ */ jsxs7("div", { className: "documentation-search-empty", children: [
+        /* @__PURE__ */ jsx7(OrbitMark, {}),
+        /* @__PURE__ */ jsx7("strong", { children: "Find an answer in these docs" }),
+        /* @__PURE__ */ jsx7("span", { children: "Search pages, headings, APIs, and examples." })
+      ] }),
+      query.trim() && loading && /* @__PURE__ */ jsx7("div", { className: "documentation-search-state", children: "Searching this documentation\u2026" }),
+      query.trim() && !loading && results.length === 0 && /* @__PURE__ */ jsxs7("div", { className: "documentation-search-state", children: [
+        "No documentation matched \u201C",
+        query.trim(),
+        "\u201D."
+      ] }),
+      results.map((result, resultIndex) => /* @__PURE__ */ jsxs7(
+        "a",
+        {
+          "aria-selected": activeIndex === resultIndex,
+          className: activeIndex === resultIndex ? "documentation-search-result is-active" : "documentation-search-result",
+          href: documentationPublicPath(basePath, result.href),
+          id: `documentation-search-option-${resultIndex}`,
+          onClick: onClose,
+          onMouseEnter: () => setActiveIndex(resultIndex),
+          role: "option",
+          children: [
+            /* @__PURE__ */ jsx7("span", { className: "documentation-search-kind", children: result.kind === "section" ? /* @__PURE__ */ jsx7(HashIcon, {}) : /* @__PURE__ */ jsx7(FileIcon, {}) }),
+            /* @__PURE__ */ jsxs7("span", { className: "documentation-search-copy", children: [
+              /* @__PURE__ */ jsx7("strong", { children: highlightMatch(result.title, query) }),
+              result.kind === "section" ? /* @__PURE__ */ jsxs7("span", { className: "documentation-search-crumbs", children: [
+                result.context,
+                /* @__PURE__ */ jsx7(ChevronRightIcon, {}),
+                result.title
+              ] }) : /* @__PURE__ */ jsx7("small", { children: result.context })
+            ] }),
+            /* @__PURE__ */ jsx7(ChevronRightIcon, {})
+          ]
+        },
+        result.href
+      )),
+      assistantEnabled && query.trim() && /* @__PURE__ */ jsxs7(
+        "button",
+        {
+          "aria-selected": activeIndex === 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",
+          type: "button",
+          children: [
+            /* @__PURE__ */ jsx7(SparkIcon, {}),
+            /* @__PURE__ */ jsxs7("span", { children: [
+              /* @__PURE__ */ jsx7("strong", { children: "Ask DeepSpace" }),
+              /* @__PURE__ */ jsx7("small", { children: "Answer from the current documentation with citations" })
+            ] }),
+            /* @__PURE__ */ jsx7(ChevronRightIcon, {})
+          ]
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsxs7("footer", { children: [
+      /* @__PURE__ */ jsxs7("span", { children: [
+        /* @__PURE__ */ jsx7("kbd", { children: "\u2191" }),
+        /* @__PURE__ */ jsx7("kbd", { children: "\u2193" }),
+        " select"
+      ] }),
+      /* @__PURE__ */ jsxs7("span", { children: [
+        /* @__PURE__ */ jsx7("kbd", { children: "\u21B5" }),
+        " open"
+      ] }),
+      /* @__PURE__ */ jsxs7("span", { children: [
+        /* @__PURE__ */ jsx7("kbd", { children: "esc" }),
+        " close"
+      ] })
+    ] })
+  ] }) });
+}
+function prepareSearchIndex(index) {
+  return index.map((entry) => ({
+    entry,
+    title: normalizeSearch(entry.title),
+    headings: entry.headings.map((heading) => ({ heading, normalized: normalizeSearch(heading.text) })),
+    headingText: normalizeSearch(entry.headings.map((heading) => heading.text).join(" ")),
+    haystack: normalizeSearch(`${entry.description ?? ""} ${entry.text}`)
+  }));
+}
+function rankSearch(index, query) {
+  const normalized = normalizeSearch(query);
+  if (!normalized) return [];
+  const tokens = normalized.split(" ").filter(Boolean);
+  const scored = [];
+  for (const { entry, title, headings, headingText, haystack } of index) {
+    let score = title === normalized ? 180 : title.startsWith(normalized) ? 110 : title.includes(normalized) ? 75 : 0;
+    if (headingText.includes(normalized)) score += 55;
+    for (const token of tokens) {
+      if (title.includes(token)) score += 24;
+      else if (headingText.includes(token)) score += 14;
+      else if (haystack.includes(token)) score += 5;
+      else score -= 18;
+    }
+    if (score > 0) {
+      scored.push({
+        route: entry.route,
+        score,
+        result: {
+          href: entry.route,
+          kind: "page",
+          title: entry.title,
+          context: entry.description ?? entry.text.slice(0, 150)
+        }
+      });
+    }
+    for (const { heading, normalized: headingNormalized } of headings) {
+      let sectionScore = headingNormalized === normalized ? 120 : headingNormalized.startsWith(normalized) ? 80 : headingNormalized.includes(normalized) ? 60 : 0;
+      if (sectionScore === 0) {
+        for (const token of tokens) if (headingNormalized.includes(token)) sectionScore += 18;
+      }
+      if (sectionScore <= 0) continue;
+      scored.push({
+        route: `${entry.route}#${heading.id}`,
+        score: sectionScore,
+        result: {
+          href: `${entry.route}#${heading.id}`,
+          kind: "section",
+          title: heading.text,
+          context: entry.title
+        }
+      });
+    }
+  }
+  return scored.sort((left, right) => right.score - left.score || left.route.localeCompare(right.route)).slice(0, 10).map((item) => item.result);
+}
+function highlightMatch(value, query) {
+  const normalizedQuery = query.trim();
+  if (!normalizedQuery) return value;
+  const index = value.toLowerCase().indexOf(normalizedQuery.toLowerCase());
+  if (index < 0) return value;
+  return /* @__PURE__ */ jsxs7(Fragment5, { children: [
+    value.slice(0, index),
+    /* @__PURE__ */ jsx7("mark", { children: value.slice(index, index + normalizedQuery.length) }),
+    value.slice(index + normalizedQuery.length)
+  ] });
+}
+function normalizeSearch(value) {
+  return value.normalize("NFKD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, " ").trim();
+}
+
+// src/documentation/runtime/app.tsx
+import { jsx as jsx8, jsxs as jsxs8 } from "react/jsx-runtime";
+function DocumentationApp({
+  data,
+  children,
+  navigating = false,
+  onNavigate
+}) {
+  const [mobileNavOpen, setMobileNavOpen] = useState7(false);
+  const [searchOpen, setSearchOpen] = useState7(false);
+  const [assistantOpen, setAssistantOpen] = useState7(false);
+  const [assistantDraft, setAssistantDraft] = useState7("");
+  const [assistantSeed, setAssistantSeed] = useState7({ 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);
+  }, []);
+  useEffect8(() => {
+    const handleKeydown = (event) => {
+      if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "k") {
+        event.preventDefault();
+        setSearchOpen(true);
+      }
+      if ((event.metaKey || event.ctrlKey) && event.key.toLowerCase() === "i") {
+        event.preventDefault();
+        if (data.config.assistant.access !== "disabled") openAssistant();
+      }
+    };
+    document.addEventListener("keydown", handleKeydown);
+    return () => document.removeEventListener("keydown", handleKeydown);
+  }, [data.config.assistant.access, openAssistant]);
+  useEffect8(() => {
+    setMobileNavOpen(false);
+    setSearchOpen(false);
+  }, [data.page.route]);
+  return /* @__PURE__ */ jsxs8(
+    "div",
+    {
+      "aria-busy": navigating || void 0,
+      className: appClassName,
+      children: [
+        /* @__PURE__ */ jsx8("a", { className: "documentation-skip-link", href: "#documentation-content", children: "Skip to main content" }),
+        /* @__PURE__ */ jsx8(
+          DocumentationHeader,
+          {
+            data,
+            onMenuOpen: () => setMobileNavOpen(true),
+            onSearchOpen: () => setSearchOpen(true)
+          }
+        ),
+        /* @__PURE__ */ jsxs8("div", { className: "documentation-frame", children: [
+          /* @__PURE__ */ jsx8(DesktopSidebar, { data }),
+          /* @__PURE__ */ jsx8("main", { className: "documentation-main", id: "documentation-content", children: /* @__PURE__ */ jsxs8("div", { className: "documentation-reader-grid", children: [
+            /* @__PURE__ */ jsx8("div", { className: "documentation-reader-column", children: /* @__PURE__ */ jsx8(
+              Article,
+              {
+                data,
+                launcher: assistantAccess && !assistantOpen ? /* @__PURE__ */ jsx8(
+                  AssistantLauncher,
+                  {
+                    input: assistantDraft,
+                    name: data.config.name,
+                    onInputChange: setAssistantDraft,
+                    onSubmit: (question) => openAssistant(question, true)
+                  }
+                ) : void 0,
+                onAssistantOpen: openAssistant,
+                children
+              }
+            ) }),
+            /* @__PURE__ */ jsx8(ContextRail, { data })
+          ] }) })
+        ] }),
+        /* @__PURE__ */ jsx8(
+          MobileNavigation,
+          {
+            data,
+            onClose: () => setMobileNavOpen(false),
+            open: mobileNavOpen
+          }
+        ),
+        /* @__PURE__ */ jsx8(
+          SearchCommand,
+          {
+            assistantEnabled,
+            basePath: data.basePath,
+            name: data.config.name,
+            onAssistantOpen: openAssistant,
+            onClose: () => setSearchOpen(false),
+            onNavigate,
+            open: searchOpen
+          }
+        ),
+        assistantAccess && /* @__PURE__ */ jsx8(
+          DocumentationAssistant,
+          {
+            access: assistantAccess,
+            basePath: data.basePath,
+            input: assistantDraft,
+            name: data.config.name,
+            onClose: () => setAssistantOpen(false),
+            onInputChange: setAssistantDraft,
+            open: assistantOpen,
+            route: data.page.route,
+            seed: assistantSeed,
+            suggestions: data.config.assistant.suggestions
+          }
+        )
+      ]
+    }
+  );
+}
+
+// src/documentation/runtime/mdx-components.tsx
+import { Children, createElement, isValidElement } from "react";
+import { Fragment as Fragment6, jsx as jsx9, jsxs as jsxs9 } from "react/jsx-runtime";
+function Callout({ children, title, kind }) {
+  const label = title ?? kind.charAt(0).toUpperCase() + kind.slice(1);
+  return /* @__PURE__ */ jsxs9("aside", { className: `documentation-callout documentation-callout-${kind}`, children: [
+    /* @__PURE__ */ jsx9("strong", { children: label }),
+    children
+  ] });
+}
+function Note(props) {
+  return /* @__PURE__ */ jsx9(Callout, { ...props, kind: "note" });
+}
+function Tip(props) {
+  return /* @__PURE__ */ jsx9(Callout, { ...props, kind: "tip" });
+}
+function Warning(props) {
+  return /* @__PURE__ */ jsx9(Callout, { ...props, kind: "warning" });
+}
+function Info(props) {
+  return /* @__PURE__ */ jsx9(Callout, { ...props, kind: "info" });
+}
+function Card({ children, href, label, title }) {
+  const content = /* @__PURE__ */ jsxs9(Fragment6, { children: [
+    title ?? label ? /* @__PURE__ */ jsx9("strong", { children: title ?? label }) : null,
+    children
+  ] });
+  return href ? /* @__PURE__ */ jsxs9("a", { className: "documentation-card", href, children: [
+    content,
+    /* @__PURE__ */ jsx9("span", { "aria-hidden": "true", children: "\u2192" })
+  ] }) : /* @__PURE__ */ jsx9("div", { className: "documentation-card", children: content });
+}
+function Accordion({ children, label, title }) {
+  return /* @__PURE__ */ jsxs9("details", { className: "documentation-accordion", children: [
+    /* @__PURE__ */ jsx9("summary", { children: title ?? label ?? "Details" }),
+    children
+  ] });
+}
+function AccordionGroup({ children }) {
+  return /* @__PURE__ */ jsx9("div", { className: "documentation-accordion-group", children });
+}
+function Step({ children, label, title }) {
+  return /* @__PURE__ */ jsxs9("section", { className: "documentation-step", children: [
+    title ?? label ? /* @__PURE__ */ jsx9("h3", { children: title ?? label }) : null,
+    children
+  ] });
+}
+function Steps({ children }) {
+  return /* @__PURE__ */ jsx9("div", { className: "documentation-steps", children });
+}
+function Tab({ children, label, title }) {
+  return /* @__PURE__ */ jsx9("section", { className: "documentation-tab", "data-tab": true, "data-tab-title": title ?? label ?? "Tab", children });
+}
+function Tabs({ children }) {
+  return /* @__PURE__ */ jsx9(TabGroup, { className: "documentation-tabs", panels: tabPanels(children) });
+}
+function CodeGroup({ children, label, title }) {
+  const panels = Children.toArray(children).map((child, index) => ({
+    label: codeBlockTitle(child) ?? `Example ${index + 1}`,
+    content: child
+  }));
+  return /* @__PURE__ */ jsx9(CodeGroupProvider, { value: true, children: /* @__PURE__ */ jsx9(
+    TabGroup,
+    {
+      className: "documentation-code-group",
+      panels,
+      title: title ?? label ? /* @__PURE__ */ jsx9("div", { className: "documentation-code-group-title", children: title ?? label }) : void 0
+    }
+  ) });
+}
+function tabPanels(children) {
+  return Children.toArray(children).map((child, index) => {
+    const props = isValidElement(child) ? child.props : void 0;
+    return {
+      label: props?.title ?? props?.label ?? `Tab ${index + 1}`,
+      content: props && "children" in props ? props.children : child
+    };
+  });
+}
+function codeBlockTitle(node) {
+  if (!isValidElement(node)) return void 0;
+  const code = node.props.children;
+  if (!isValidElement(code)) return void 0;
+  const title = code.props["data-code-title"];
+  return typeof title === "string" && title ? title : void 0;
+}
+function Heading({ level, ...props }) {
+  const id = props.id;
+  return createElement(
+    `h${level}`,
+    props,
+    props.children,
+    id ? /* @__PURE__ */ jsx9("a", { "aria-label": "Link to this section", className: "documentation-heading-anchor", href: `#${id}`, children: "#" }) : null
+  );
+}
+var documentationMdxComponents = {
+  /** React renders the code-block wrapper so nothing has to move a `pre` that
+   * the reconciler already owns. */
+  pre: CodeBlock,
+  Accordion,
+  AccordionGroup,
+  Card,
+  CodeGroup,
+  Info,
+  Note,
+  Step,
+  Steps,
+  Tab,
+  Tabs,
+  Tip,
+  Warning,
+  h1: (props) => /* @__PURE__ */ jsx9(Heading, { ...props, level: 1 }),
+  h2: (props) => /* @__PURE__ */ jsx9(Heading, { ...props, level: 2 }),
+  h3: (props) => /* @__PURE__ */ jsx9(Heading, { ...props, level: 3 }),
+  h4: (props) => /* @__PURE__ */ jsx9(Heading, { ...props, level: 4 }),
+  h5: (props) => /* @__PURE__ */ jsx9(Heading, { ...props, level: 5 }),
+  h6: (props) => /* @__PURE__ */ jsx9(Heading, { ...props, level: 6 })
+};
+
+// src/documentation/runtime/public.tsx
+import { jsx as jsx10 } from "react/jsx-runtime";
+var DefaultDocumentation = DocumentationApp;
+function DocumentationContent({
+  data,
+  Page
+}) {
+  if (!Page) {
+    return /* @__PURE__ */ jsx10(
+      "div",
+      {
+        className: "documentation-prose",
+        "data-prose": "html",
+        dangerouslySetInnerHTML: { __html: data.page.html }
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx10("div", { className: "documentation-prose", "data-prose": "react", children: /* @__PURE__ */ jsx10(Page, { components: documentationMdxComponents }) });
+}
+
+export {
+  documentationPublicPath,
+  documentationLogicalPath,
+  DocumentationApp,
+  Note,
+  Tip,
+  Warning,
+  Info,
+  Card,
+  Accordion,
+  AccordionGroup,
+  Step,
+  Steps,
+  Tab,
+  Tabs,
+  CodeGroup,
+  DefaultDocumentation,
+  DocumentationContent
+};
+//# sourceMappingURL=chunk-ESYXTIV2.js.map