@djangocfg/ui-tools 2.1.318 → 2.1.319

package/dist/{DocsLayout-ESVQZO3V.mjs → DocsLayout-CTJINVBM.mjs}

@@ -1,13 +1,13 @@
-import { deduplicateEndpoints, dereferenceSchema, resolveBaseUrl, usePlaygroundContext, toMarkdown, toCompactJson, toRawJson, formatBytes, MarkdownMessage, CODE_SAMPLE_TARGETS, buildHarRequest, resolveAbsolute, renderSnippet, PrettyCode_default, relativePath, endpointToMarkdown, isValidJson, findApiKeyById, parseRequestHeaders, UrlBuilder, sampleSchemaJson, joinUrl } from './chunk-GBLQTHWT.mjs';
+import { deduplicateEndpoints, dereferenceSchema, resolveBaseUrl, usePlaygroundContext, relativePath, toMarkdown, toCompactJson, toRawJson, formatBytes, MarkdownMessage, CODE_SAMPLE_TARGETS, buildHarRequest, resolveAbsolute, renderSnippet, PrettyCode_default, endpointToMarkdown, isValidJson, findApiKeyById, parseRequestHeaders, UrlBuilder, sampleSchemaJson, joinUrl } from './chunk-62Y65TGK.mjs';
 import { JsonTree_default } from './chunk-LFWQ36LJ.mjs';
 import './chunk-SSUOENAZ.mjs';
 import { __name } from './chunk-CGILA3WO.mjs';
 import React12, { useRef, useEffect, createContext, useCallback, useMemo, useState, useContext } from 'react';
 import { groupBy, orderBy, partition, sortBy, keyBy } from 'lodash-es';
-import { Tooltip, TooltipTrigger, TooltipContent, DropdownMenu, DropdownMenuTrigger, Button, DropdownMenuContent, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuItem, Input, Combobox, SafeTooltipProvider, CopyButton, Switch, Textarea, SidePanel, ResponsiveSheet, ResponsiveSheetContent, ResponsiveSheetHeader, ResponsiveSheetTitle, Skeleton, TooltipProvider } from '@djangocfg/ui-core/components';
+import { Tooltip, TooltipTrigger, TooltipContent, DropdownMenu, DropdownMenuTrigger, Button, DropdownMenuContent, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuItem, Input, SafeTooltipProvider, CopyButton, Switch, Combobox, Textarea, SidePanel, ResponsiveSheet, ResponsiveSheetContent, ResponsiveSheetHeader, ResponsiveSheetTitle, Skeleton, TooltipProvider } from '@djangocfg/ui-core/components';
 import { toast, useMediaQuery } from '@djangocfg/ui-core/hooks';
 import consola from 'consola';
-import { ChevronRight, Sparkles, ChevronDown, Check, Search, X, Link2, FileCode2, ChevronsDownUp, ChevronsUpDown, Play, Minus, Plus, RotateCcw, Send, Key, Terminal, Info, ShieldCheck, Loader2, WifiOff, AlertCircle } from 'lucide-react';
+import { ChevronRight, Sparkles, ChevronDown, Check, Search, X, Play, Link2, Minus, Plus, RotateCcw, Send, Key, Terminal, Info, ShieldCheck, Loader2, WifiOff, AlertCircle, ChevronsDownUp, ChevronsUpDown } from 'lucide-react';
 import { cn } from '@djangocfg/ui-core/lib';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { create } from 'zustand';
@@ -590,142 +590,20 @@ function CollapsibleSection({
   ] });
 }
 __name(CollapsibleSection, "CollapsibleSection");
-var FLAVOUR_LABELS = {
-  markdown: {
-    title: "Markdown for LLM",
-    hint: "Endpoints + params as prose. Smallest."
-  },
-  compact: {
-    title: "Compact JSON",
-    hint: "Dereferenced, no examples, minified."
-  },
-  raw: {
-    title: "Raw JSON",
-    hint: "Full OpenAPI document with $refs."
-  }
-};
-function SchemaCopyMenu({ schema, endpoints, baseUrl, variant = "button" }) {
-  const [sizeCache, setSizeCache] = useState({});
-  const [justCopied, setJustCopied] = useState(null);
-  const [open, setOpen] = useState(false);
-  const isReady = schema !== null && endpoints.length > 0;
-  const build = useCallback(
-    (flavour) => {
-      if (!schema) return "";
-      if (flavour === "markdown") return toMarkdown(schema, endpoints, baseUrl);
-      if (flavour === "compact") return toCompactJson(schema, baseUrl);
-      return toRawJson(schema, baseUrl);
-    },
-    [schema, endpoints, baseUrl]
-  );
-  const handleCopy = useCallback(
-    async (flavour) => {
-      if (!isReady) return;
-      const text = build(flavour);
-      const label = FLAVOUR_LABELS[flavour].title;
-      try {
-        await navigator.clipboard.writeText(text);
-        const size = formatBytes(text);
-        setSizeCache((prev) => ({ ...prev, [flavour]: size }));
-        setJustCopied(flavour);
-        setTimeout(() => setJustCopied(null), 1500);
-        setOpen(false);
-        toast.success(`Copied ${label}`, { description: size });
-      } catch (err) {
-        const message = err instanceof Error ? err.message : "Clipboard permission denied";
-        toast.error("Copy failed", { description: message });
-      }
-    },
-    [build, isReady]
-  );
-  const flavours = useMemo(() => ["markdown", "compact", "raw"], []);
-  return /* @__PURE__ */ jsxs(DropdownMenu, { open, onOpenChange: setOpen, children: [
-    /* @__PURE__ */ jsx(DropdownMenuTrigger, { asChild: true, children: variant === "icon" ? /* @__PURE__ */ jsx(
-      Button,
-      {
-        variant: "ghost",
-        size: "icon",
-        className: "h-7 w-7 shrink-0",
-        disabled: !isReady,
-        title: "Copy schema for AI",
-        "aria-label": "Copy schema for AI",
-        children: /* @__PURE__ */ jsx(Sparkles, { className: "h-3.5 w-3.5" })
-      }
-    ) : /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", className: "h-8 gap-1.5 text-xs", disabled: !isReady, children: [
-      /* @__PURE__ */ jsx(Sparkles, { className: "h-3 w-3" }),
-      "Copy for AI",
-      /* @__PURE__ */ jsx(ChevronDown, { className: "h-3 w-3 opacity-60" })
-    ] }) }),
-    /* @__PURE__ */ jsxs(
-      DropdownMenuContent,
-      {
-        side: "right",
-        align: "start",
-        sideOffset: 6,
-        collisionPadding: 8,
-        className: "w-60 max-w-[calc(100vw-16px)]",
-        children: [
-          /* @__PURE__ */ jsx(DropdownMenuLabel, { className: "text-[10px] uppercase tracking-wider text-muted-foreground/70", children: "Copy schema" }),
-          /* @__PURE__ */ jsx(DropdownMenuSeparator, {}),
-          flavours.map((f) => {
-            const label = FLAVOUR_LABELS[f];
-            const size = sizeCache[f];
-            const isDone = justCopied === f;
-            return /* @__PURE__ */ jsxs(
-              DropdownMenuItem,
-              {
-                onClick: (e) => {
-                  e.preventDefault();
-                  void handleCopy(f);
-                },
-                className: "flex flex-col items-start gap-0.5 py-2 cursor-pointer",
-                children: [
-                  /* @__PURE__ */ jsxs("div", { className: "flex w-full items-center gap-2", children: [
-                    /* @__PURE__ */ jsx("span", { className: "text-xs font-medium flex-1", children: label.title }),
-                    isDone ? /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-1 text-[10px] text-emerald-500", children: [
-                      /* @__PURE__ */ jsx(Check, { className: "h-3 w-3" }),
-                      " Copied"
-                    ] }) : size ? /* @__PURE__ */ jsx("span", { className: "text-[10px] font-mono text-muted-foreground/70 tabular-nums", children: size }) : null
-                  ] }),
-                  /* @__PURE__ */ jsx("span", { className: "text-[10px] text-muted-foreground/70 leading-snug line-clamp-1", children: label.hint })
-                ]
-              },
-              f
-            );
-          })
-        ]
-      }
-    )
-  ] });
-}
-__name(SchemaCopyMenu, "SchemaCopyMenu");
-function BrandHeader({ info, endpoints, rawSchema, resolvedBaseUrl }) {
+function BrandHeader({ info }) {
   const apiTitle = info?.title ?? "API Reference";
-  const copyReady = rawSchema !== null && rawSchema !== void 0 && endpoints.length > 0;
-  return /* @__PURE__ */ jsxs("div", { className: "shrink-0 border-b px-3 py-2.5 flex items-start gap-2", children: [
-    /* @__PURE__ */ jsxs("div", { className: "flex-1 min-w-0", children: [
-      /* @__PURE__ */ jsx(
-        "div",
-        {
-          className: "text-[13px] font-semibold text-foreground leading-tight truncate",
-          title: apiTitle,
-          children: apiTitle
-        }
-      ),
-      info?.version && /* @__PURE__ */ jsxs("div", { className: "font-mono text-[10px] text-muted-foreground/60 leading-tight mt-0.5", children: [
-        "v",
-        info.version
-      ] })
-    ] }),
-    copyReady && /* @__PURE__ */ jsx(
-      SchemaCopyMenu,
+  const versionLabel = info?.version ? `v${info.version}` : null;
+  const versionNode = versionLabel ? /* @__PURE__ */ jsx("div", { className: "font-mono text-[10px] text-muted-foreground/60 leading-tight mt-0.5", children: versionLabel }) : null;
+  return /* @__PURE__ */ jsxs("div", { className: "shrink-0 border-b px-3 py-2.5", children: [
+    /* @__PURE__ */ jsx(
+      "div",
       {
-        schema: rawSchema ?? null,
-        endpoints,
-        baseUrl: resolvedBaseUrl,
-        variant: "icon"
+        className: "text-[13px] font-semibold text-foreground leading-tight truncate",
+        title: apiTitle,
+        children: apiTitle
       }
-    )
+    ),
+    versionNode
   ] });
 }
 __name(BrandHeader, "BrandHeader");
@@ -755,19 +633,11 @@ function sidebarLabel(ep, groupCommonPrefix) {
     const tail = ep.path.slice(groupCommonPrefix.length) || "/";
     return tail;
   }
-  return relativePath2(ep.path);
+  return relativePath(ep.path);
 }
 __name(sidebarLabel, "sidebarLabel");
-function relativePath2(full) {
-  try {
-    return new URL(full).pathname;
-  } catch {
-    return full;
-  }
-}
-__name(relativePath2, "relativePath");
 function sidebarTooltip(ep) {
-  return `${ep.method} ${relativePath2(ep.path)}`;
+  return `${ep.method} ${relativePath(ep.path)}`;
 }
 __name(sidebarTooltip, "sidebarTooltip");
 
@@ -951,29 +821,130 @@ function SidebarBody({ body, onNavigate }) {
   return /* @__PURE__ */ jsx("nav", { className: "py-1.5", children: body.sections.map((section) => /* @__PURE__ */ jsx(SchemaSection, { section, onNavigate }, section.sourceId)) });
 }
 __name(SidebarBody, "SidebarBody");
-
-// src/tools/OpenapiViewer/components/DocsLayout/Sidebar/types.ts
-var METHOD_FILTERS = ["ALL", "GET", "POST", "PUT", "PATCH", "DELETE"];
-function MethodChips({ value, onChange }) {
-  return /* @__PURE__ */ jsx("div", { className: "flex items-center gap-1 overflow-x-auto -mx-1 px-1 pb-px", children: METHOD_FILTERS.map((m) => {
-    const active = value === m;
-    return /* @__PURE__ */ jsx(
-      "button",
+var FLAVOUR_LABELS = {
+  markdown: {
+    title: "Markdown for LLM",
+    hint: "Endpoints + params as prose. Smallest."
+  },
+  compact: {
+    title: "Compact JSON",
+    hint: "Dereferenced, no examples, minified."
+  },
+  raw: {
+    title: "Raw JSON",
+    hint: "Full OpenAPI document with $refs."
+  }
+};
+function SchemaCopyMenu({ schema, endpoints, baseUrl, variant = "button", side }) {
+  const [sizeCache, setSizeCache] = useState({});
+  const [justCopied, setJustCopied] = useState(null);
+  const [open, setOpen] = useState(false);
+  const isReady = schema !== null && endpoints.length > 0;
+  const build = useCallback(
+    (flavour) => {
+      if (!schema) return "";
+      if (flavour === "markdown") return toMarkdown(schema, endpoints, baseUrl);
+      if (flavour === "compact") return toCompactJson(schema, baseUrl);
+      return toRawJson(schema, baseUrl);
+    },
+    [schema, endpoints, baseUrl]
+  );
+  const handleCopy = useCallback(
+    async (flavour) => {
+      if (!isReady) return;
+      const text = build(flavour);
+      const label = FLAVOUR_LABELS[flavour].title;
+      try {
+        await navigator.clipboard.writeText(text);
+        const size = formatBytes(text);
+        setSizeCache((prev) => ({ ...prev, [flavour]: size }));
+        setJustCopied(flavour);
+        setTimeout(() => setJustCopied(null), 1500);
+        setOpen(false);
+        toast.success(`Copied ${label}`, { description: size });
+      } catch (err) {
+        const message = err instanceof Error ? err.message : "Clipboard permission denied";
+        toast.error("Copy failed", { description: message });
+      }
+    },
+    [build, isReady]
+  );
+  const flavours = useMemo(() => ["markdown", "compact", "raw"], []);
+  const resolvedSide = side ?? (variant === "footer" ? "top" : "right");
+  const resolvedAlign = variant === "footer" ? "center" : "start";
+  return /* @__PURE__ */ jsxs(DropdownMenu, { open, onOpenChange: setOpen, children: [
+    /* @__PURE__ */ jsx(DropdownMenuTrigger, { asChild: true, children: variant === "icon" ? /* @__PURE__ */ jsx(
+      Button,
       {
-        type: "button",
-        onClick: () => onChange(m),
-        "aria-pressed": active,
-        className: cn(
-          "shrink-0 px-2 h-6 rounded font-mono text-[10px] font-semibold tracking-wide uppercase transition-colors",
-          active ? "bg-foreground text-background" : "text-muted-foreground/70 hover:text-foreground hover:bg-muted"
-        ),
-        children: m
-      },
-      m
-    );
-  }) });
+        variant: "ghost",
+        size: "icon",
+        className: "h-7 w-7 shrink-0",
+        disabled: !isReady,
+        title: "Copy schema for AI",
+        "aria-label": "Copy schema for AI",
+        children: /* @__PURE__ */ jsx(Sparkles, { className: "h-3.5 w-3.5" })
+      }
+    ) : variant === "footer" ? /* @__PURE__ */ jsxs(
+      Button,
+      {
+        variant: "secondary",
+        size: "sm",
+        className: "w-full justify-center gap-1.5 text-xs",
+        disabled: !isReady,
+        children: [
+          /* @__PURE__ */ jsx(Sparkles, { className: "h-3 w-3" }),
+          "Copy schema for AI",
+          /* @__PURE__ */ jsx(ChevronDown, { className: "h-3 w-3 opacity-60" })
+        ]
+      }
+    ) : /* @__PURE__ */ jsxs(Button, { variant: "outline", size: "sm", className: "h-8 gap-1.5 text-xs", disabled: !isReady, children: [
+      /* @__PURE__ */ jsx(Sparkles, { className: "h-3 w-3" }),
+      "Copy for AI",
+      /* @__PURE__ */ jsx(ChevronDown, { className: "h-3 w-3 opacity-60" })
+    ] }) }),
+    /* @__PURE__ */ jsxs(
+      DropdownMenuContent,
+      {
+        side: resolvedSide,
+        align: resolvedAlign,
+        sideOffset: 6,
+        collisionPadding: 8,
+        className: "w-60 max-w-[calc(100vw-16px)]",
+        children: [
+          /* @__PURE__ */ jsx(DropdownMenuLabel, { className: "text-[10px] uppercase tracking-wider text-muted-foreground/70", children: "Copy schema" }),
+          /* @__PURE__ */ jsx(DropdownMenuSeparator, {}),
+          flavours.map((f) => {
+            const label = FLAVOUR_LABELS[f];
+            const size = sizeCache[f];
+            const isDone = justCopied === f;
+            return /* @__PURE__ */ jsxs(
+              DropdownMenuItem,
+              {
+                onClick: (e) => {
+                  e.preventDefault();
+                  void handleCopy(f);
+                },
+                className: "flex flex-col items-start gap-0.5 py-2 cursor-pointer",
+                children: [
+                  /* @__PURE__ */ jsxs("div", { className: "flex w-full items-center gap-2", children: [
+                    /* @__PURE__ */ jsx("span", { className: "text-xs font-medium flex-1", children: label.title }),
+                    isDone ? /* @__PURE__ */ jsxs("span", { className: "inline-flex items-center gap-1 text-[10px] text-emerald-500", children: [
+                      /* @__PURE__ */ jsx(Check, { className: "h-3 w-3" }),
+                      " Copied"
+                    ] }) : size ? /* @__PURE__ */ jsx("span", { className: "text-[10px] font-mono text-muted-foreground/70 tabular-nums", children: size }) : null
+                  ] }),
+                  /* @__PURE__ */ jsx("span", { className: "text-[10px] text-muted-foreground/70 leading-snug line-clamp-1", children: label.hint })
+                ]
+              },
+              f
+            );
+          })
+        ]
+      }
+    )
+  ] });
 }
-__name(MethodChips, "MethodChips");
+__name(SchemaCopyMenu, "SchemaCopyMenu");
 function SearchInput({ value, onChange, placeholder }) {
   return /* @__PURE__ */ jsxs("div", { className: "relative", children: [
     /* @__PURE__ */ jsx(Search, { className: "absolute left-2.5 top-1/2 -translate-y-1/2 h-3.5 w-3.5 text-muted-foreground/50 pointer-events-none" }),
@@ -1010,28 +981,41 @@ function Toolbar({
   showSchemaSelector,
   search,
   onSearchChange,
-  methodFilter,
-  onMethodFilterChange
+  endpoints,
+  rawSchema,
+  resolvedBaseUrl
 }) {
   const schemaOptions = React12.useMemo(
     () => schemas.map((s) => ({ value: s.id, label: s.name })),
     [schemas]
   );
+  const copyReady = rawSchema !== null && rawSchema !== void 0 && endpoints.length > 0;
+  const schemaSelectorNode = showSchemaSelector ? /* @__PURE__ */ jsx(
+    Combobox,
+    {
+      options: schemaOptions,
+      value: currentSchemaId ?? "",
+      onValueChange: (id) => id && onSchemaChange(id),
+      placeholder: "Select API",
+      searchPlaceholder: "Search APIs\u2026",
+      emptyText: "No APIs found",
+      className: "w-full h-8 text-xs"
+    }
+  ) : null;
+  const copyMenuNode = copyReady ? /* @__PURE__ */ jsx(
+    SchemaCopyMenu,
+    {
+      schema: rawSchema ?? null,
+      endpoints,
+      baseUrl: resolvedBaseUrl,
+      variant: "footer",
+      side: "bottom"
+    }
+  ) : null;
   return /* @__PURE__ */ jsxs("div", { className: "shrink-0 border-b px-3 py-2.5 space-y-2", children: [
-    showSchemaSelector && /* @__PURE__ */ jsx(
-      Combobox,
-      {
-        options: schemaOptions,
-        value: currentSchemaId ?? "",
-        onValueChange: (id) => id && onSchemaChange(id),
-        placeholder: "Select API",
-        searchPlaceholder: "Search APIs\u2026",
-        emptyText: "No APIs found",
-        className: "w-full h-8 text-xs"
-      }
-    ),
+    schemaSelectorNode,
     /* @__PURE__ */ jsx(SearchInput, { value: search, onChange: onSearchChange }),
-    /* @__PURE__ */ jsx(MethodChips, { value: methodFilter, onChange: onMethodFilterChange })
+    copyMenuNode
   ] });
 }
 __name(Toolbar, "Toolbar");
@@ -1059,7 +1043,6 @@ function DocsSidebar({
   resolvedBaseUrl
 }) {
   const [search, setSearch] = useState("");
-  const [methodFilter, setMethodFilter] = useState("ALL");
   const debouncedSearch = useDebouncedValue(search);
   const body = useMemo(() => {
     if (grouping === "sections") {
@@ -1068,7 +1051,7 @@ function DocsSidebar({
         endpointsBySchema ?? {},
         selectedVersion,
         debouncedSearch,
-        methodFilter,
+        "ALL",
         activeEndpointId
       );
     }
@@ -1076,7 +1059,7 @@ function DocsSidebar({
       endpoints,
       selectedVersion,
       debouncedSearch,
-      methodFilter,
+      "ALL",
       activeEndpointId
     );
   }, [
@@ -1086,21 +1069,12 @@ function DocsSidebar({
     endpoints,
     selectedVersion,
     debouncedSearch,
-    methodFilter,
     activeEndpointId
   ]);
   const hasMultipleSchemas = schemas.length > 1;
   const showSchemaSelector = grouping === "selector" && hasMultipleSchemas;
   return /* @__PURE__ */ jsxs("aside", { className: "flex flex-col h-full min-h-0 border-r bg-muted/10", children: [
-    /* @__PURE__ */ jsx(
-      BrandHeader,
-      {
-        info,
-        endpoints,
-        rawSchema,
-        resolvedBaseUrl
-      }
-    ),
+    /* @__PURE__ */ jsx(BrandHeader, { info }),
     /* @__PURE__ */ jsx(
       Toolbar,
       {
@@ -1110,8 +1084,9 @@ function DocsSidebar({
         showSchemaSelector,
         search,
         onSearchChange: setSearch,
-        methodFilter,
-        onMethodFilterChange: setMethodFilter
+        endpoints,
+        rawSchema,
+        resolvedBaseUrl
       }
     ),
     /* @__PURE__ */ jsx(ScrollArea, { children: /* @__PURE__ */ jsx(SidebarBody, { body, onNavigate }) })
@@ -1210,21 +1185,14 @@ var useEndpointDocStore = create()(
   persist(
     (set) => ({
       ...initialState,
-      toggleSection: /* @__PURE__ */ __name((endpointId, sectionId) => set((state) => {
+      toggleSection: /* @__PURE__ */ __name((endpointId, sectionId, defaultOpen) => set((state) => {
         const key = sectionKey(endpointId, sectionId);
         const current = state.openSections[key];
+        const visible = current === void 0 ? defaultOpen : current;
         return {
           openSections: {
             ...state.openSections,
-            // If there's no explicit override yet, the user's
-            // first click means "flip from the default". We
-            // assume the default was ``true`` for the most
-            // common case (bodies/responses) and ``false``
-            // otherwise; the Section component tracks this
-            // via its ``defaultOpen`` prop and never calls
-            // toggle on sections whose defaults match the
-            // next state.
-            [key]: current === void 0 ? false : !current
+            [key]: !visible
           }
         };
       }), "toggleSection"),
@@ -1383,15 +1351,15 @@ function IconButton({ label, onClick, children, active }) {
   ] });
 }
 __name(IconButton, "IconButton");
-function MetaActions({ anchor, endpointMarkdown, presentSections }) {
+function MetaActions({ anchor, presentSections }) {
   const { endpointId } = useEndpointDocContext();
   const expandAll = useEndpointDocStore((s) => s.expandAll);
   const collapseAll = useEndpointDocStore((s) => s.collapseAll);
   const openSections = useEndpointDocStore((s) => s.openSections);
-  const [justCopied, setJustCopied] = useState(null);
-  const flash = useCallback((which) => {
-    setJustCopied(which);
-    setTimeout(() => setJustCopied(null), 1200);
+  const [linkCopied, setLinkCopied] = useState(false);
+  const flashLink = useCallback(() => {
+    setLinkCopied(true);
+    setTimeout(() => setLinkCopied(false), 1200);
   }, []);
   const mostlyOpen = useMemo(() => {
     if (presentSections.length === 0) return false;
@@ -1404,43 +1372,21 @@ function MetaActions({ anchor, endpointMarkdown, presentSections }) {
   const copyLink = useCallback(() => {
     if (typeof window === "undefined") return;
     const url = `${window.location.origin}${window.location.pathname}#${anchor}`;
-    void navigator.clipboard?.writeText(url).then(() => flash("link"));
-  }, [anchor, flash]);
-  const copyMarkdown = useCallback(() => {
-    if (typeof window === "undefined") return;
-    void navigator.clipboard?.writeText(endpointMarkdown).then(() => flash("md"));
-  }, [endpointMarkdown, flash]);
+    void navigator.clipboard?.writeText(url).then(flashLink);
+  }, [anchor, flashLink]);
   const toggleAll = useCallback(() => {
     if (mostlyOpen) collapseAll(endpointId, presentSections);
     else expandAll(endpointId, presentSections);
   }, [mostlyOpen, collapseAll, expandAll, endpointId, presentSections]);
+  const linkLabel = linkCopied ? "Copied!" : "Copy link to endpoint";
+  const linkIcon = linkCopied ? /* @__PURE__ */ jsx(Check, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ jsx(Link2, { className: "h-3.5 w-3.5" });
+  const showToggleAll = presentSections.length >= 2;
+  const toggleAllLabel = mostlyOpen ? "Collapse all sections" : "Expand all sections";
+  const toggleAllIcon = mostlyOpen ? /* @__PURE__ */ jsx(ChevronsDownUp, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ jsx(ChevronsUpDown, { className: "h-3.5 w-3.5" });
+  const toggleAllNode = showToggleAll ? /* @__PURE__ */ jsx(IconButton, { label: toggleAllLabel, onClick: toggleAll, children: toggleAllIcon }) : null;
   return /* @__PURE__ */ jsx(SafeTooltipProvider, { delayDuration: 200, children: /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-0.5", children: [
-    /* @__PURE__ */ jsx(
-      IconButton,
-      {
-        label: justCopied === "link" ? "Copied!" : "Copy link to endpoint",
-        onClick: copyLink,
-        active: justCopied === "link",
-        children: justCopied === "link" ? /* @__PURE__ */ jsx(Check, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ jsx(Link2, { className: "h-3.5 w-3.5" })
-      }
-    ),
-    /* @__PURE__ */ jsx(
-      IconButton,
-      {
-        label: justCopied === "md" ? "Copied!" : "Copy as Markdown (for AI)",
-        onClick: copyMarkdown,
-        active: justCopied === "md",
-        children: justCopied === "md" ? /* @__PURE__ */ jsx(Check, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ jsx(FileCode2, { className: "h-3.5 w-3.5" })
-      }
-    ),
-    presentSections.length >= 2 && /* @__PURE__ */ jsx(
-      IconButton,
-      {
-        label: mostlyOpen ? "Collapse all sections" : "Expand all sections",
-        onClick: toggleAll,
-        children: mostlyOpen ? /* @__PURE__ */ jsx(ChevronsDownUp, { className: "h-3.5 w-3.5" }) : /* @__PURE__ */ jsx(ChevronsUpDown, { className: "h-3.5 w-3.5" })
-      }
-    )
+    /* @__PURE__ */ jsx(IconButton, { label: linkLabel, onClick: copyLink, active: linkCopied, children: linkIcon }),
+    toggleAllNode
   ] }) });
 }
 __name(MetaActions, "MetaActions");
@@ -1463,35 +1409,57 @@ function EndpointHeader({
   presentSections
 }) {
   const endpointMd = useMemo(() => endpointToMarkdown(endpoint), [endpoint]);
+  const [aiCopied, setAiCopied] = useState(false);
+  const onAiCopy = useCallback(() => {
+    if (typeof window === "undefined") return;
+    void navigator.clipboard?.writeText(endpointMd).then(() => {
+      setAiCopied(true);
+      setTimeout(() => setAiCopied(false), 1200);
+    });
+  }, [endpointMd]);
+  const tryItLabel = isLoadedInPlayground ? "Loaded" : "Try it";
+  const aiCopyIcon = aiCopied ? /* @__PURE__ */ jsx(Check, { className: "h-3 w-3" }) : /* @__PURE__ */ jsx(Sparkles, { className: "h-3 w-3" });
+  const aiCopyLabel = aiCopied ? "Copied" : "AI Copy";
+  const descriptionNode = endpoint.description ? /* @__PURE__ */ jsx("div", { className: "text-muted-foreground text-sm", children: /* @__PURE__ */ jsx(MarkdownMessage, { content: endpoint.description }) }) : null;
   return /* @__PURE__ */ jsxs("header", { className: "space-y-3", children: [
     /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3 flex-wrap", children: [
       /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 min-w-0", children: [
         /* @__PURE__ */ jsx(MethodBadge, { method: endpoint.method }),
-        /* @__PURE__ */ jsx(
-          MetaActions,
+        /* @__PURE__ */ jsx(MetaActions, { anchor, presentSections })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "ml-auto flex items-center gap-2", children: [
+        /* @__PURE__ */ jsxs(
+          Button,
           {
-            anchor,
-            endpointMarkdown: endpointMd,
-            presentSections
+            size: "sm",
+            variant: "secondary",
+            onClick: onAiCopy,
+            title: "Copy endpoint as Markdown for AI",
+            "aria-label": "Copy endpoint as Markdown for AI",
+            className: "h-7 text-xs gap-1.5 px-2.5",
+            children: [
+              aiCopyIcon,
+              aiCopyLabel
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          Button,
+          {
+            size: "sm",
+            variant: isLoadedInPlayground ? "secondary" : "default",
+            onClick: onTryIt,
+            className: "h-7 text-xs gap-1.5 px-2.5",
+            children: [
+              /* @__PURE__ */ jsx(Play, { className: "h-3 w-3" }),
+              tryItLabel
+            ]
           }
         )
-      ] }),
-      /* @__PURE__ */ jsxs(
-        Button,
-        {
-          size: "sm",
-          variant: isLoadedInPlayground ? "secondary" : "default",
-          onClick: onTryIt,
-          className: "ml-auto h-7 text-xs gap-1.5 px-2.5",
-          children: [
-            /* @__PURE__ */ jsx(Play, { className: "h-3 w-3" }),
-            isLoadedInPlayground ? "Loaded" : "Try it"
-          ]
-        }
-      )
+      ] })
     ] }),
     /* @__PURE__ */ jsx("div", { className: "min-w-0", children: /* @__PURE__ */ jsx(PathDisplay, { path: endpoint.path }) }),
-    endpoint.description && /* @__PURE__ */ jsx("div", { className: "text-muted-foreground text-sm", children: /* @__PURE__ */ jsx(MarkdownMessage, { content: endpoint.description }) })
+    descriptionNode
   ] });
 }
 __name(EndpointHeader, "EndpointHeader");
@@ -1924,7 +1892,7 @@ function Section({ id, title, badge, children }) {
         title,
         badge,
         open,
-        onToggle: () => toggleSection(endpointId, id)
+        onToggle: () => toggleSection(endpointId, id, defaultOpen)
       }
     ),
     open && /* @__PURE__ */ jsx("div", { children })
@@ -3459,5 +3427,5 @@ var DocsLayout = /* @__PURE__ */ __name(() => {
 }, "DocsLayout");
 
 export { DocsLayout };
-//# sourceMappingURL=DocsLayout-ESVQZO3V.mjs.map
-//# sourceMappingURL=DocsLayout-ESVQZO3V.mjs.map
+//# sourceMappingURL=DocsLayout-CTJINVBM.mjs.map
+//# sourceMappingURL=DocsLayout-CTJINVBM.mjs.map