deepspace 0.19.3 → 0.19.5

package/dist/documentation-server-core.d.ts

@@ -1,5 +1,5 @@
-import { D as DocumentationRuntimeData, a as DocumentationPageComponent, b as DocumentationSiteComponent } from './public-BtArwbVM.js';
-export { A as Accordion, c as AccordionGroup, C as Card, d as CodeGroup, e as DefaultDocumentation, f as DocumentationApp, g as DocumentationAppProps, h as DocumentationContent, i as DocumentationSiteProps, I as Info, N as Note, S as Step, j as Steps, T as Tab, k as Tabs, l as Tip, W as Warning } from './public-BtArwbVM.js';
+import { D as DocumentationRuntimeData, a as DocumentationPageComponent, b as DocumentationSiteComponent } from './public-CFAj1hL2.js';
+export { A as Accordion, c as AccordionGroup, C as Card, d as CodeGroup, e as DefaultDocumentation, f as DocumentationApp, g as DocumentationAppProps, h as DocumentationContent, i as DocumentationSiteProps, I as Info, N as Note, S as Step, j as Steps, T as Tab, k as Tabs, l as Tip, W as Warning } from './public-CFAj1hL2.js';
 import 'react';
 
 declare function renderDocumentation({ data, Page, Site, }: {

package/dist/documentation-server-core.js

@@ -14,7 +14,7 @@ import {
   Tabs,
   Tip,
   Warning
-} from "./chunk-233GQU2H.js";
+} from "./chunk-A7UFIOWO.js";
 
 // src/documentation/runtime/server.tsx
 import { createElement } from "react";

package/dist/documentation.d.ts

@@ -14,6 +14,7 @@ interface DocumentationFontConfig {
 interface DocumentationThemeConfig {
     preset?: string;
     accent?: string;
+    accentDark?: string;
     background?: string;
     backgroundDark?: string;
     backgroundDecoration?: 'none' | 'gradient' | 'grid';
@@ -308,7 +309,6 @@ declare function parseFrontmatter(source: string, file: string): {
     frontmatter: DocumentationFrontmatter;
     body: string;
 };
-
 declare function htmlToText(html: string): string;
 
 declare const AGENT_SKILLS_SCHEMA = "https://schemas.agentskills.io/discovery/0.2.0/schema.json";

package/dist/documentation.js

@@ -374,7 +374,9 @@ function parseCodeFenceInfo(value) {
   const language = raw.split(/\s+/, 1)[0]?.toLowerCase();
   const metadata = raw.slice(language?.length ?? 0).trim();
   const quotedTitle = metadata.match(/(?:^|\s)title=(?:"([^"]+)"|'([^']+)')/i);
-  const title = quotedTitle?.[1] ?? quotedTitle?.[2] ?? (metadata && !metadata.includes("=") ? metadata : void 0);
+  const optionKeyword = /^(?:wrap|expandable|twoslash|focus)$/i.test(metadata);
+  const bareTitle = metadata && !metadata.includes("=") && !metadata.startsWith("{") && !optionKeyword ? metadata : void 0;
+  const title = quotedTitle?.[1] ?? quotedTitle?.[2] ?? bareTitle;
   return {
     ...language ? { language } : {},
     ...title ? { title: title.trim() } : {}
@@ -889,6 +891,7 @@ var openapiItemSchema = z.union([
 var themeObjectSchema = z.object({
   preset: z.string().trim().min(1).optional(),
   accent: z.string().trim().optional(),
+  accentDark: z.string().trim().optional(),
   background: z.string().trim().optional(),
   logo: z.string().trim().optional(),
   logoDark: z.string().trim().optional(),
@@ -919,8 +922,7 @@ var navigationRootSchema = z.union([
         group: z.string().trim().min(1),
         pages: z.array(navigationSchema).min(1)
       })
-    ),
-    global: z.record(z.string(), z.unknown()).optional()
+    )
   })
 ]);
 var navbarSchema = z.object({
@@ -1231,6 +1233,8 @@ function loadDocumentationConfig(appDir) {
     theme: {
       ...themeInput,
       accent: themeInput.accent ?? data.colors?.primary ?? data.colors?.light ?? data.colors?.dark,
+      // Mintlify's colors.light is "the anchor color used in dark mode".
+      accentDark: themeInput.accentDark ?? data.colors?.light,
       background: background?.light ?? themeInput.background,
       backgroundDark: background && "dark" in background ? background.dark : void 0,
       backgroundDecoration: data.background?.decoration,
@@ -1423,13 +1427,16 @@ function addRuntimeMetadata() {
         };
       }
       if (node.type === "code" && typeof node.meta === "string" && node.meta.trim()) {
-        node.data = {
-          ...node.data,
-          hProperties: {
-            ...asRecord(node.data?.hProperties),
-            "data-code-title": node.meta.trim()
-          }
-        };
+        const { title } = parseCodeFenceInfo(`${node.lang ?? ""} ${node.meta}`.trim());
+        if (title) {
+          node.data = {
+            ...node.data,
+            hProperties: {
+              ...asRecord(node.data?.hProperties),
+              "data-code-title": title
+            }
+          };
+        }
       }
     });
   };
@@ -3051,8 +3058,16 @@ function loadDefaultRenderer() {
 // src/documentation/runtime/styles/base.ts
 var DOCUMENTATION_BASE_CSS = String.raw`
 :root {
-  --documentation-accent: #635bff;
-  --documentation-accent-2: #24c8ff;
+  /* The configured accent is injected as --documentation-accent-light; the
+   * dark theme swaps in --documentation-accent-dark, which defaults to a
+   * readable lightened derivative so a site that configures only one accent
+   * never ships invisible links on the dark background. */
+  --documentation-accent-light: #635bff;
+  --documentation-accent-dark: color-mix(in oklab, var(--documentation-accent-light) 52%, white);
+  --documentation-accent: var(--documentation-accent-light);
+  /* Glyphs painted directly on the accent. Dark lightens the accent, so the
+   * readable ink on it flips from white to near-black. */
+  --documentation-accent-contrast: #ffffff;
   --documentation-brand-bg: #f8fafc;
   --documentation-brand-bg-dark: #0c0e14;
   --documentation-font-body: Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
@@ -3074,6 +3089,14 @@ var DOCUMENTATION_BASE_CSS = String.raw`
   --documentation-code-text: #e8ebf5;
   --documentation-shadow-sm: 0 1px 2px rgba(15, 18, 28, .04), 0 2px 8px rgba(15, 18, 28, .03);
   --documentation-shadow-lg: 0 24px 80px rgba(15, 18, 28, .18), 0 6px 24px rgba(15, 18, 28, .08);
+  /* Honest glass: used only where content physically passes beneath a surface
+   * (the launcher pill, the floating/mobile assistant panel). High-opacity
+   * tint plus blur keeps the surface legible over prose, dark code, and
+   * images without any protective gradient; the inset highlight is the lit
+   * top edge that makes the pane read as material rather than mist. */
+  --documentation-glass-bg: color-mix(in srgb, var(--documentation-surface-raised) 86%, transparent);
+  --documentation-glass-border: color-mix(in srgb, var(--documentation-border-strong) 90%, var(--documentation-accent));
+  --documentation-glass-highlight: rgba(255, 255, 255, .6);
   --documentation-header-height: 66px;
   --documentation-sidebar-width: 292px;
   --documentation-assistant-width: 420px;
@@ -3084,6 +3107,8 @@ var DOCUMENTATION_BASE_CSS = String.raw`
 }
 
 :root[data-theme="dark"] {
+  --documentation-accent: var(--documentation-accent-dark);
+  --documentation-accent-contrast: #0c0e14;
   --documentation-brand-bg: var(--documentation-brand-bg-dark);
   --documentation-bg: var(--documentation-brand-bg-dark);
   --documentation-surface: #10131b;
@@ -3101,6 +3126,9 @@ var DOCUMENTATION_BASE_CSS = String.raw`
   --documentation-code-text: #eef0f7;
   --documentation-shadow-sm: 0 1px 2px rgba(0, 0, 0, .24);
   --documentation-shadow-lg: 0 28px 90px rgba(0, 0, 0, .55), 0 8px 24px rgba(0, 0, 0, .35);
+  --documentation-glass-bg: color-mix(in srgb, var(--documentation-surface-raised) 80%, transparent);
+  --documentation-glass-border: color-mix(in srgb, var(--documentation-border-strong) 86%, var(--documentation-accent));
+  --documentation-glass-highlight: rgba(255, 255, 255, .07);
   --documentation-focus-ring: color-mix(in srgb, var(--documentation-accent) 74%, white);
   color-scheme: dark;
 }
@@ -3112,23 +3140,24 @@ body { margin: 0; background: var(--documentation-brand-bg); color: var(--docume
 :root[data-background-decoration="grid"] body { background-image: linear-gradient(color-mix(in srgb, var(--documentation-border) 26%, transparent) 1px, transparent 1px), linear-gradient(90deg, color-mix(in srgb, var(--documentation-border) 26%, transparent) 1px, transparent 1px); background-attachment: fixed; background-size: 32px 32px; }
 body:has(.documentation-modal-layer), body:has(.documentation-mobile-nav) { overflow: hidden; }
 button, input, textarea { font: inherit; }
-button, a { -webkit-tap-highlight-color: transparent; }
+button, a, summary, label { -webkit-tap-highlight-color: transparent; }
 a { color: inherit; }
 button:focus-visible, a:focus-visible, input:focus-visible, textarea:focus-visible, summary:focus-visible { outline: 2px solid var(--documentation-focus-ring); outline-offset: 3px; }
 ::selection { background: color-mix(in srgb, var(--documentation-accent) 24%, transparent); }
+/* Chrome is an instrument, not a document: its labels never select and its
+ * links never spawn the native drag ghost. The article prose, assistant
+ * answers, and every input stay fully selectable. (The router's dragstart
+ * chokepoint enforces the no-ghost rule in engines without -webkit-user-drag.) */
+.documentation-header, .documentation-sidebar, .documentation-mobile-nav, .documentation-outline, .documentation-outline-disclosure > summary, .documentation-breadcrumbs, .documentation-article-meta, .documentation-pagination, .documentation-search-dialog, .documentation-launcher-dock, .documentation-assistant > header, .documentation-assistant-suggestions, .documentation-assistant > footer, .documentation-tab-buttons, .documentation-code-actions, .documentation-theme-controls { user-select: none; -webkit-user-select: none; }
+.documentation-search-dialog input, .documentation-launcher-dock input, .documentation-search-results { user-select: text; -webkit-user-select: text; }
+:is(.documentation-header, .documentation-sidebar, .documentation-mobile-nav, .documentation-outline, .documentation-breadcrumbs, .documentation-article-meta, .documentation-pagination, .documentation-search-dialog) :is(a, img) { -webkit-user-drag: none; }
 
 .documentation-skip-link { position: fixed; z-index: 200; top: -64px; left: 16px; padding: 9px 13px; border-radius: 8px; background: var(--documentation-text); color: var(--documentation-bg); font-weight: 650; text-decoration: none; }
 .documentation-skip-link:focus { top: 12px; }
-.documentation-app.is-navigating::before { content: ""; position: fixed; z-index: 240; inset: 0 auto auto 0; width: 42%; height: 2px; background: linear-gradient(90deg, var(--documentation-accent), var(--documentation-accent-2)); box-shadow: 0 0 14px color-mix(in srgb, var(--documentation-accent-2) 48%, transparent); animation: documentation-navigation-progress .8s ease-in-out infinite alternate; }
-::view-transition-old(documentation-article) { animation: documentation-page-out .11s ease-in both; }
-::view-transition-new(documentation-article) { animation: documentation-page-in .16s ease-out both; }
-/* Only the article animates. Without these, the browser's default root
- * cross-fade snapshots the whole viewport and visibly fades over the fixed
- * assistant launcher/panel on every client navigation. */
-::view-transition-group(root) { animation: none; }
-::view-transition-old(root), ::view-transition-new(root) { animation: none; }
-::view-transition-old(documentation-assistant), ::view-transition-new(documentation-assistant),
-::view-transition-old(documentation-assistant-launcher), ::view-transition-new(documentation-assistant-launcher) { animation: none; }
+/* The only navigation feedback. The article itself never animates: a route
+ * swap is a hard cut committed in one frame, because any overlap of two text
+ * layers — any fade, slide, or view transition — reads as ghosting. */
+.documentation-app.is-navigating::before { content: ""; position: fixed; z-index: 240; inset: 0 auto auto 0; width: 42%; height: 2px; background: var(--documentation-accent); animation: documentation-navigation-progress .8s ease-in-out infinite alternate; }
 
 `;
 
@@ -3137,7 +3166,7 @@ var DOCUMENTATION_CONTENT_CSS = String.raw`
 .documentation-main { min-width: 0; margin-left: var(--documentation-sidebar-width); margin-right: 0; transition: margin-right .24s ease; }
 .documentation-reader-grid { display: grid; grid-template-columns: minmax(0, 720px) 250px; justify-content: center; gap: 70px; width: 100%; padding: 62px 52px 96px; }
 .documentation-reader-column { display: flex; min-width: 0; min-height: calc(100vh - var(--documentation-header-height) - 158px); flex-direction: column; }
-.documentation-article { display: flex; min-width: 0; flex: 1; flex-direction: column; view-transition-name: documentation-article; }
+.documentation-article { display: flex; min-width: 0; flex: 1; flex-direction: column; }
 .documentation-breadcrumbs { display: none; align-items: center; gap: 5px; margin-bottom: 24px; color: var(--documentation-muted); font-size: 13px; }
 .documentation-breadcrumbs span { display: inline-flex; align-items: center; gap: 5px; }
 .documentation-breadcrumbs svg { width: 12px; height: 12px; }
@@ -3168,7 +3197,10 @@ var DOCUMENTATION_CONTENT_CSS = String.raw`
 
 .documentation-prose { color: var(--documentation-text-soft); }
 .documentation-prose > :first-child { margin-top: 0; }
-.documentation-prose h1, .documentation-prose h2, .documentation-prose h3, .documentation-prose h4, .documentation-prose h5, .documentation-prose h6 { position: relative; color: var(--documentation-text); font-family: var(--documentation-font-heading); scroll-margin-top: 96px; }
+/* Anchor clearance is owned once, by scroll-padding-top on the html element
+ * — a per-heading scroll-margin here stacked with it and landed anchors a
+ * full header-height too low. */
+.documentation-prose h1, .documentation-prose h2, .documentation-prose h3, .documentation-prose h4, .documentation-prose h5, .documentation-prose h6 { position: relative; color: var(--documentation-text); font-family: var(--documentation-font-heading); }
 .documentation-prose h1 { margin: 48px 0 18px; font-size: 30px; letter-spacing: -.025em; line-height: 1.2; }
 .documentation-prose h2 { margin: 50px 0 16px; padding-top: 5px; font-size: 25px; font-weight: 625; letter-spacing: -.025em; line-height: 1.28; }
 .documentation-prose h3 { margin: 34px 0 12px; font-size: 20px; font-weight: 620; letter-spacing: -.015em; line-height: 1.4; }
@@ -3200,8 +3232,12 @@ var DOCUMENTATION_CONTENT_CSS = String.raw`
 .documentation-code-actions button { display: grid; place-items: center; width: 30px; height: 30px; padding: 0; border: 1px solid rgba(255, 255, 255, .14); border-radius: 7px; background: color-mix(in srgb, var(--documentation-code-panel) 88%, transparent); color: #aeb5c6; cursor: pointer; backdrop-filter: blur(6px); }
 .documentation-code-actions button:hover { background: rgba(255, 255, 255, .14); color: #fff; }
 .documentation-code-actions svg { width: 15px; height: 15px; }
-.documentation-code-language { position: absolute; z-index: 1; top: 14px; left: 20px; color: #7f889c; font: 650 11.5px/1 var(--documentation-font-mono); letter-spacing: .06em; text-transform: uppercase; pointer-events: none; }
-.documentation-code-block:has(.documentation-code-language) pre { padding-top: 38px; }
+/* The language rides in the hover actions row as a passive chip instead of a
+ * permanently visible label that cost every block 38px of top padding. */
+.documentation-code-language { display: inline-flex; align-items: center; height: 30px; padding: 0 9px; border: 1px solid rgba(255, 255, 255, .14); border-radius: 7px; background: color-mix(in srgb, var(--documentation-code-panel) 88%, transparent); color: #7f889c; font: 650 11px/1 var(--documentation-font-mono); letter-spacing: .06em; text-transform: uppercase; pointer-events: none; backdrop-filter: blur(6px); }
+/* Fence titles (filenames) get a slim header bar above the code. */
+.documentation-code-title { display: flex; align-items: center; min-height: 36px; padding: 0 16px; border: 1px solid color-mix(in srgb, var(--documentation-border-strong) 50%, #000); border-bottom: 0; border-radius: 12px 12px 0 0; background: var(--documentation-code-panel); color: #aeb5c6; font: 600 12px/1.3 var(--documentation-font-mono); }
+.documentation-code-block:has(.documentation-code-title) pre { margin-top: 0; border-top-left-radius: 0; border-top-right-radius: 0; }
 
 .hljs-keyword, .hljs-selector-tag, .hljs-literal, .hljs-section, .hljs-link { color: #b7a7ff; }
 .hljs-string, .hljs-title, .hljs-name, .hljs-type, .hljs-attribute, .hljs-symbol, .hljs-bullet, .hljs-addition { color: #73dfb4; }
@@ -3222,7 +3258,8 @@ var DOCUMENTATION_CONTENT_CSS = String.raw`
 :root[data-code-mode="system"][data-theme="light"] .documentation-prose pre { border-color: var(--documentation-border); background: linear-gradient(145deg, #f7f8fb, #f1f3f7); color: var(--documentation-code-plain); box-shadow: 0 8px 26px rgba(15, 18, 28, .06); }
 :root[data-code-mode="system"][data-theme="light"] .documentation-code-actions button { border-color: rgba(17, 19, 26, .12); background: rgba(255, 255, 255, .82); color: #606675; }
 :root[data-code-mode="system"][data-theme="light"] .documentation-code-actions button:hover { background: #fff; color: #11131a; }
-:root[data-code-mode="system"][data-theme="light"] .documentation-code-language { color: #757c8c; }
+:root[data-code-mode="system"][data-theme="light"] .documentation-code-language { border-color: rgba(17, 19, 26, .12); background: rgba(255, 255, 255, .82); color: #757c8c; }
+:root[data-code-mode="system"][data-theme="light"] .documentation-code-title { border-color: var(--documentation-border); background: #eef1f6; color: #5c6270; }
 :root[data-code-mode="system"][data-theme="light"] :is(.hljs-keyword, .hljs-selector-tag, .hljs-literal, .hljs-section, .hljs-link) { color: var(--documentation-code-keyword); }
 :root[data-code-mode="system"][data-theme="light"] :is(.hljs-string, .hljs-title, .hljs-name, .hljs-type, .hljs-attribute, .hljs-symbol, .hljs-bullet, .hljs-addition) { color: var(--documentation-code-string); }
 :root[data-code-mode="system"][data-theme="light"] :is(.hljs-number, .hljs-meta, .hljs-built_in, .hljs-builtin-name, .hljs-params) { color: var(--documentation-code-number); }
@@ -3236,15 +3273,17 @@ var DOCUMENTATION_CONTENT_CSS = String.raw`
 .documentation-prose tr:last-child td { border-bottom: 0; }
 .documentation-prose th { color: var(--documentation-text); font-size: 13px; font-weight: 700; letter-spacing: .02em; }
 
-.documentation-callout { --callout-accent: var(--documentation-accent); position: relative; margin: 24px 0; padding: 16px 18px 16px 20px; overflow: hidden; border: 1px solid color-mix(in srgb, var(--callout-accent) 25%, var(--documentation-border)); border-radius: 11px; background: linear-gradient(105deg, color-mix(in srgb, var(--callout-accent) 7%, var(--documentation-surface)), var(--documentation-surface)); }
+.documentation-callout { --callout-accent: var(--documentation-accent); position: relative; margin: 24px 0; padding: 16px 18px 16px 20px; overflow: hidden; border: 1px solid color-mix(in srgb, var(--callout-accent) 25%, var(--documentation-border)); border-radius: 11px; background: color-mix(in srgb, var(--callout-accent) 6%, var(--documentation-surface)); }
 .documentation-callout::before { content: ""; position: absolute; inset: 0 auto 0 0; width: 2px; background: var(--callout-accent); }
 .documentation-callout > strong { display: block; margin-bottom: 3px; color: color-mix(in srgb, var(--callout-accent) 72%, var(--documentation-text)); font-size: 14px; }
 .documentation-callout > :last-child { margin-bottom: 0; }
-.documentation-callout-warning { --callout-accent: #e58a21; }
+.documentation-callout-warning { --callout-accent: #c9771a; }
 .documentation-callout-tip { --callout-accent: #17a673; }
 .documentation-callout-info { --callout-accent: #278fdb; }
 .documentation-callout-note { --callout-accent: var(--documentation-accent); }
-.documentation-card { display: grid; grid-template-columns: 1fr auto; align-items: center; gap: 12px; margin: 14px 0; padding: 16px 17px; border: 1px solid var(--documentation-border); border-radius: 11px; background: var(--documentation-surface); box-shadow: var(--documentation-shadow-sm); text-decoration: none !important; transition: border-color .16s, box-shadow .16s, transform .16s; }
+/* Card bodies are body copy, not links — without this the anchor's link color
+ * bleeds into every description. */
+.documentation-card { color: var(--documentation-text-soft); display: grid; grid-template-columns: 1fr auto; align-items: center; gap: 12px; margin: 14px 0; padding: 16px 17px; border: 1px solid var(--documentation-border); border-radius: 11px; background: var(--documentation-surface); box-shadow: var(--documentation-shadow-sm); text-decoration: none !important; transition: border-color .16s, box-shadow .16s, transform .16s; }
 .documentation-card:hover { border-color: color-mix(in srgb, var(--documentation-accent) 42%, var(--documentation-border)); box-shadow: 0 7px 24px rgba(15, 18, 28, .07); transform: translateY(-1px); }
 .documentation-card strong { display: block; margin-bottom: 2px; }
 .documentation-accordion-group { margin: 21px 0; border: 1px solid var(--documentation-border); border-radius: 11px; overflow: hidden; }
@@ -3286,7 +3325,7 @@ var DOCUMENTATION_CONTENT_CSS = String.raw`
 .documentation-playground > p { color: var(--documentation-muted); font-size: 12px; }
 .documentation-playground label { display: grid; gap: 5px; margin: 13px 0; color: var(--documentation-muted); font-size: 11px; font-weight: 650; }
 .documentation-playground input, .documentation-playground textarea { width: 100%; padding: 10px; border: 1px solid var(--documentation-border-strong); border-radius: 8px; background: var(--documentation-surface); color: var(--documentation-text); font: 12.5px/1.55 var(--documentation-font-mono); resize: vertical; }
-.documentation-playground > button { padding: 9px 13px; border: 0; border-radius: 8px; background: var(--documentation-accent); color: white; cursor: pointer; font-size: 12px; font-weight: 680; }
+.documentation-playground > button { padding: 9px 13px; border: 0; border-radius: 8px; background: var(--documentation-accent); color: var(--documentation-accent-contrast); cursor: pointer; font-size: 12px; font-weight: 680; }
 .documentation-playground > button:disabled { opacity: .58; cursor: wait; }
 .documentation-playground > pre { max-height: 320px; overflow: auto; margin: 14px 0 0; padding: 13px; border-radius: 8px; background: var(--documentation-code-bg); color: var(--documentation-code-text); font: 11.5px/1.55 var(--documentation-font-mono); white-space: pre-wrap; }
 
@@ -3320,7 +3359,6 @@ var DOCUMENTATION_NAVIGATION_CSS = String.raw`
 .documentation-header { position: fixed; z-index: 50; inset: 0 0 auto; display: grid; grid-template-columns: var(--documentation-sidebar-width) minmax(300px, 1fr) auto; align-items: center; height: var(--documentation-header-height); border-bottom: 1px solid color-mix(in srgb, var(--documentation-border) 84%, transparent); background: color-mix(in srgb, var(--documentation-bg) 91%, transparent); backdrop-filter: blur(18px) saturate(1.15); transition: right .24s ease; }
 .documentation-brand { display: flex; align-items: center; gap: 10px; min-width: 0; height: 100%; padding: 0 23px; color: var(--documentation-text); text-decoration: none; }
 .documentation-brand-mark { position: relative; display: grid; place-items: center; width: 27px; height: 27px; color: var(--documentation-accent); }
-.documentation-brand-mark::before { content: ""; position: absolute; inset: -7px; border-radius: 50%; background: radial-gradient(circle, color-mix(in srgb, var(--documentation-accent-2) 15%, transparent), transparent 68%); }
 .documentation-brand-mark svg { position: relative; width: 27px; height: 27px; }
 .documentation-brand-name { overflow: hidden; font-size: 16px; font-weight: 720; letter-spacing: -.025em; text-overflow: ellipsis; white-space: nowrap; }
 .documentation-brand-product { padding-left: 10px; border-left: 1px solid var(--documentation-border-strong); color: var(--documentation-muted); font-size: 13px; font-weight: 600; letter-spacing: .04em; }
@@ -3353,8 +3391,10 @@ var DOCUMENTATION_NAVIGATION_CSS = String.raw`
 .documentation-nav-link > span { min-width: 0; overflow-wrap: anywhere; }
 .documentation-nav-link > svg { flex: 0 0 auto; width: 12px; height: 12px; }
 .documentation-nav-link:hover { background: var(--documentation-panel); color: var(--documentation-text); }
-.documentation-nav-link.is-active { position: relative; background: linear-gradient(90deg, color-mix(in srgb, var(--documentation-accent) 11%, transparent), color-mix(in srgb, var(--documentation-accent-2) 5%, transparent)); color: color-mix(in srgb, var(--documentation-accent) 77%, var(--documentation-text)); font-weight: 650; }
-.documentation-nav-link.is-active::before { content: ""; position: absolute; inset: 8px auto 8px -5px; width: 2px; border-radius: 4px; background: linear-gradient(var(--documentation-accent), var(--documentation-accent-2)); box-shadow: 0 0 10px color-mix(in srgb, var(--documentation-accent-2) 52%, transparent); }
+/* Paper, not neon: the active state is a flat tint and a solid hairline —
+ * no gradients, no glow. */
+.documentation-nav-link.is-active { position: relative; background: color-mix(in srgb, var(--documentation-accent) 10%, transparent); color: color-mix(in srgb, var(--documentation-accent) 72%, var(--documentation-text)); font-weight: 650; }
+.documentation-nav-link.is-active::before { content: ""; position: absolute; inset: 8px auto 8px -5px; width: 2px; border-radius: 4px; background: var(--documentation-accent); }
 .documentation-nav-folder { margin: 2px 0; }
 .documentation-nav-folder > summary { display: flex; align-items: center; justify-content: space-between; min-height: 34px; padding: 6px 9px; border-radius: 8px; color: var(--documentation-muted); cursor: pointer; font-size: 14px; font-weight: 620; list-style: none; }
 .documentation-nav-folder > summary::-webkit-details-marker { display: none; }
@@ -3415,30 +3455,34 @@ var DOCUMENTATION_OVERLAYS_CSS = String.raw`
 .documentation-mobile-nav > footer { display: flex; align-items: center; flex-wrap: wrap; gap: 8px 13px; padding: 13px 18px; border-top: 1px solid var(--documentation-border); }
 .documentation-mobile-nav > footer a { color: var(--documentation-muted); font-size: 13px; text-decoration: none; }
 
-/* Sticky inside the reading column instead of fixed to the viewport: it tracks
- * the column's centre line, never covers the sidebar or outline, and scrolls
- * away above the pagination rather than sitting on top of it. */
-.documentation-launcher-dock { position: sticky; z-index: 40; bottom: 0; display: flex; justify-content: center; margin-top: auto; padding: 44px 0 16px; pointer-events: none; }
-.documentation-launcher-dock::before { content: ""; position: absolute; z-index: -1; inset: 0; background: linear-gradient(to bottom, transparent, var(--documentation-brand-bg) 58%); }
+/* The launcher owns a reserved slot in the reading column: sticky at the
+ * viewport bottom while reading, ordinary flow above the pagination once the
+ * end of the article arrives. It is present on the whole page — no auto-hide,
+ * no protective gradient, no mask. The pill's own glass is its legibility
+ * over prose, dark code, and images, and its in-flow slot means it never
+ * crosses the pagination. */
+.documentation-launcher-dock { position: sticky; z-index: 40; bottom: 0; display: flex; justify-content: center; margin-top: auto; padding: 30px 0 18px; pointer-events: none; }
 .documentation-launcher-dock + .documentation-pagination { margin-top: 0; }
-.documentation-assistant-launcher { view-transition-name: documentation-assistant-launcher; position: relative; display: grid; grid-template-columns: fit-content(40%) minmax(0, 1fr) auto auto; align-items: center; gap: 0; width: min(452px, 100%); min-height: 48px; padding: 5px; border: 1px solid color-mix(in srgb, var(--documentation-border-strong) 92%, var(--documentation-accent)); border-radius: 13px; background: color-mix(in srgb, var(--documentation-surface-raised) 96%, transparent); color: var(--documentation-text); box-shadow: 0 18px 45px rgba(15, 18, 28, .11), 0 2px 8px rgba(15, 18, 28, .05); pointer-events: auto; backdrop-filter: blur(18px) saturate(1.1); transition: border-color .16s, box-shadow .16s, transform .16s; }
-.documentation-assistant-launcher:hover { border-color: color-mix(in srgb, var(--documentation-accent) 32%, var(--documentation-border-strong)); box-shadow: 0 20px 48px rgba(15, 18, 28, .14), 0 2px 8px rgba(15, 18, 28, .06); transform: translateY(-1px); }
-.documentation-assistant-launcher input { min-width: 0; height: 36px; padding: 0 12px; border: 0; outline: 0; background: transparent; color: var(--documentation-text); font-size: 14px; }
+.documentation-assistant-launcher { position: relative; display: grid; grid-template-columns: minmax(0, 1fr) auto auto; align-items: center; gap: 0; width: min(452px, 100%); min-height: 48px; padding: 5px; border: 1px solid var(--documentation-glass-border); border-radius: 15px; background: var(--documentation-glass-bg); color: var(--documentation-text); box-shadow: inset 0 1px 0 var(--documentation-glass-highlight), 0 16px 40px rgba(15, 18, 28, .12), 0 2px 8px rgba(15, 18, 28, .05); pointer-events: auto; backdrop-filter: blur(20px) saturate(1.2); -webkit-backdrop-filter: blur(20px) saturate(1.2); transition: border-color .16s, box-shadow .16s, transform .22s cubic-bezier(.4, 0, .2, 1); }
+.documentation-assistant-launcher:hover { border-color: color-mix(in srgb, var(--documentation-accent) 32%, var(--documentation-border-strong)); box-shadow: inset 0 1px 0 var(--documentation-glass-highlight), 0 20px 48px rgba(15, 18, 28, .15), 0 2px 8px rgba(15, 18, 28, .06); transform: translateY(-1px); }
+.documentation-assistant-launcher:focus-within { border-color: color-mix(in srgb, var(--documentation-accent) 48%, var(--documentation-border-strong)); box-shadow: inset 0 1px 0 var(--documentation-glass-highlight), 0 0 0 3px color-mix(in srgb, var(--documentation-accent) 10%, transparent), 0 16px 40px rgba(15, 18, 28, .12); }
+.documentation-assistant-launcher input { min-width: 0; height: 36px; padding: 0 6px 0 14px; border: 0; outline: 0; background: transparent; color: var(--documentation-text); font-size: 14px; }
 .documentation-assistant-launcher input::placeholder { color: var(--documentation-muted); }
-.documentation-launcher-send { display: grid; place-items: center; height: 36px; border: 0; border-radius: 9px; cursor: pointer; }
 /* The 40% cap lives on the grid track: a percentage max-width here would
  * resolve against that track instead of the launcher. */
-.documentation-launcher-agent { display: flex; align-items: center; gap: 4px; min-width: 0; height: 36px; padding: 0 13px 0 9px; border: 0; border-right: 1px solid var(--documentation-border); border-radius: 0; background: transparent; color: var(--documentation-text-soft); cursor: pointer; font-size: 12.5px; font-weight: 650; white-space: nowrap; }
-.documentation-launcher-agent-name { min-width: 0; overflow: hidden; text-overflow: ellipsis; }
-.documentation-launcher-agent:hover { color: var(--documentation-accent); }
 .documentation-launcher-hint { display: grid; grid-auto-flow: column; gap: 3px; padding-right: 8px; }
 .documentation-launcher-hint kbd { padding: 2px 5px; border: 1px solid var(--documentation-border); border-radius: 5px; background: var(--documentation-panel); color: var(--documentation-faint); font: 600 11px/1.3 var(--documentation-font-mono); }
-.documentation-launcher-send { width: 36px; padding: 0; background: var(--documentation-accent); color: #fff; }
-.documentation-launcher-send:disabled { background: var(--documentation-panel); color: var(--documentation-faint); cursor: default; }
-.documentation-launcher-send svg { width: 15px; }
+/* One send-button spec for the launcher and the composer: a circular accent
+ * button with a gentle press cycle, dim while empty. */
+.documentation-launcher-send, .documentation-assistant-composer > button { display: grid; flex: 0 0 auto; place-items: center; width: 32px; height: 32px; padding: 0; border: 0; border-radius: 999px; background: var(--documentation-accent); color: var(--documentation-accent-contrast); cursor: pointer; transition: background-color .15s ease, color .15s ease, transform .15s ease; }
+.documentation-launcher-send { width: 36px; height: 36px; }
+.documentation-launcher-send:hover:not(:disabled), .documentation-assistant-composer > button:hover:not(:disabled) { transform: scale(1.06); }
+.documentation-launcher-send:active:not(:disabled), .documentation-assistant-composer > button:active:not(:disabled) { transform: scale(.96); }
+.documentation-launcher-send:disabled, .documentation-assistant-composer > button:disabled { background: var(--documentation-panel-strong); color: var(--documentation-faint); cursor: default; }
+.documentation-launcher-send svg, .documentation-assistant-composer > button svg { width: 14px; height: 14px; }
 /* Docked beside the article on desktop so the page being asked about stays
  * readable; the narrow breakpoints below restore the floating card and sheet. */
-.documentation-assistant { view-transition-name: documentation-assistant; position: fixed; z-index: 90; inset: var(--documentation-header-height) 0 0 auto; display: grid; grid-template-rows: auto minmax(0, 1fr) auto auto; width: var(--documentation-assistant-width); overflow: hidden; border-left: 1px solid var(--documentation-border-strong); background: var(--documentation-surface); box-shadow: -18px 0 48px rgba(15, 18, 28, .06); animation: documentation-assistant-dock-in .2s ease-out; }
+.documentation-assistant { position: fixed; z-index: 90; inset: var(--documentation-header-height) 0 0 auto; display: grid; grid-template-rows: auto minmax(0, 1fr) auto auto; width: var(--documentation-assistant-width); overflow: hidden; border-left: 1px solid var(--documentation-border-strong); background: var(--documentation-surface); box-shadow: -18px 0 48px rgba(15, 18, 28, .06); animation: documentation-assistant-dock-in .2s ease-out; }
 .documentation-app.is-assistant-open .documentation-main { margin-right: var(--documentation-assistant-width); }
 .documentation-app.is-assistant-open .documentation-header { right: var(--documentation-assistant-width); }
 .documentation-assistant > header { display: flex; align-items: center; justify-content: space-between; min-height: 54px; padding: 0 11px 0 18px; border-bottom: 1px solid var(--documentation-border); }
@@ -3455,7 +3499,7 @@ var DOCUMENTATION_OVERLAYS_CSS = String.raw`
 .documentation-assistant-message > div { min-width: 0; max-width: 590px; }
 .documentation-assistant-message.is-user { justify-content: flex-end; margin-left: 54px; }
 .documentation-assistant-message.is-user > div { padding: 8px 11px; border: 1px solid var(--documentation-border); border-radius: 10px; background: var(--documentation-panel); color: var(--documentation-text); }
-.documentation-assistant-message.is-error > div { color: #c64b50; }
+.documentation-assistant-message.is-error > div { padding: 10px 13px; border: 1px solid color-mix(in srgb, #d05a60 32%, var(--documentation-border)); border-radius: 10px; background: color-mix(in srgb, #d05a60 7%, var(--documentation-surface)); color: color-mix(in srgb, #d05a60 58%, var(--documentation-text)); font-size: 13.5px; }
 .documentation-assistant-message a { color: color-mix(in srgb, var(--documentation-accent) 79%, var(--documentation-text)); font-weight: 580; text-underline-offset: 3px; }
 .documentation-assistant-markdown > :first-child { margin-top: 0; }
 .documentation-assistant-markdown > :last-child { margin-bottom: 0; }
@@ -3474,19 +3518,17 @@ var DOCUMENTATION_OVERLAYS_CSS = String.raw`
 .documentation-assistant-suggestions p { margin: 0 0 1px; color: var(--documentation-faint); font-size: 12px; font-weight: 650; letter-spacing: .035em; text-transform: uppercase; }
 .documentation-assistant-suggestions button { min-height: 40px; padding: 9px 12px; border: 1px solid var(--documentation-border); border-radius: 9px; background: var(--documentation-bg); color: var(--documentation-muted); cursor: pointer; font-size: 13.5px; text-align: left; transition: border-color .14s, background .14s, color .14s; }
 .documentation-assistant-suggestions button:hover { border-color: var(--documentation-border-strong); background: var(--documentation-panel); color: var(--documentation-text); }
-.documentation-assistant-composer { display: flex; align-items: flex-end; gap: 7px; margin: 0 16px 9px; padding: 7px; border: 1px solid var(--documentation-border-strong); border-radius: 11px; background: var(--documentation-bg); box-shadow: 0 3px 12px rgba(15, 18, 28, .045); }
+.documentation-assistant-composer { display: flex; align-items: flex-end; gap: 8px; margin: 0 16px 10px; padding: 8px; border: 1px solid var(--documentation-border-strong); border-radius: 16px; background: var(--documentation-surface-raised); box-shadow: 0 3px 12px rgba(15, 18, 28, .045); transition: border-color .15s ease, box-shadow .15s ease; }
 .documentation-assistant-composer:focus-within { border-color: color-mix(in srgb, var(--documentation-accent) 52%, var(--documentation-border)); box-shadow: 0 0 0 3px color-mix(in srgb, var(--documentation-accent) 9%, transparent); }
-.documentation-assistant-composer textarea { min-height: 41px; max-height: 160px; flex: 1; padding: 4px 5px; resize: none; border: 0; outline: 0; background: transparent; color: var(--documentation-text); font-size: 14px; line-height: 1.5; }
-.documentation-assistant-composer button { display: grid; place-items: center; width: 32px; height: 32px; padding: 0; border: 0; border-radius: 8px; background: var(--documentation-accent); color: white; cursor: pointer; }
-.documentation-assistant-composer button:disabled { background: var(--documentation-panel-strong); color: var(--documentation-faint); cursor: default; }
+/* The field grows with its content (the runtime sets the height); it never
+ * shows a scrollbar until the growth cap, and never clips a glyph. */
+.documentation-assistant-composer textarea { min-height: 24px; max-height: 160px; flex: 1; padding: 5px 6px; resize: none; border: 0; outline: 0; background: transparent; color: var(--documentation-text); font-size: 14px; line-height: 1.5; overflow-y: hidden; scrollbar-width: thin; }
 .documentation-assistant > footer { padding: 0 18px 12px; color: var(--documentation-faint); font-size: 12px; text-align: center; }
 @keyframes documentation-fade-in { from { opacity: 0; } }
 @keyframes documentation-dialog-in { from { opacity: 0; transform: translateY(-8px) scale(.99); } }
 @keyframes documentation-drawer-in { from { transform: translateX(-24px); } }
 @keyframes documentation-assistant-dock-in { from { transform: translateX(24px); opacity: .5; } }
 @keyframes documentation-assistant-in { from { transform: translateX(-50%) translateY(18px) scale(.985); opacity: .7; } }
-@keyframes documentation-page-out { to { opacity: 0; transform: translateY(-3px); } }
-@keyframes documentation-page-in { from { opacity: 0; transform: translateY(4px); } }
 @keyframes documentation-activity { 50% { opacity: .42; transform: scale(.82); } }
 @keyframes documentation-navigation-progress { from { transform: translateX(-20%); } to { transform: translateX(155%); } }
 
@@ -3514,8 +3556,9 @@ var DOCUMENTATION_RESPONSIVE_CSS = String.raw`
   .documentation-top-links { display: none; }
   .documentation-breadcrumbs { display: flex; }
   .documentation-outline-disclosure { display: block; }
-  /* Too narrow to dock beside the article; fall back to the floating card. */
-  .documentation-assistant { inset: auto auto 18px 50%; width: min(620px, calc(100vw - 36px)); height: min(570px, calc(100vh - 94px)); border: 1px solid var(--documentation-border-strong); border-radius: 16px; box-shadow: 0 28px 80px rgba(15, 18, 28, .18), 0 6px 22px rgba(15, 18, 28, .08); transform: translateX(-50%); animation: documentation-assistant-in .2s ease-out; }
+  /* Too narrow to dock beside the article; fall back to the floating card.
+   * The article passes beneath it, so this surface is honest glass. */
+  .documentation-assistant { inset: auto auto 18px 50%; width: min(620px, calc(100vw - 36px)); height: min(570px, calc(100vh - 94px)); border: 1px solid var(--documentation-glass-border); border-radius: 16px; background: var(--documentation-glass-bg); backdrop-filter: blur(24px) saturate(1.2); -webkit-backdrop-filter: blur(24px) saturate(1.2); box-shadow: inset 0 1px 0 var(--documentation-glass-highlight), var(--documentation-shadow-lg); transform: translateX(-50%); animation: documentation-assistant-in .2s ease-out; }
   .documentation-app.is-assistant-open .documentation-main { margin-right: 0; }
   .documentation-app.is-assistant-open .documentation-header { right: 0; }
 }
@@ -3555,8 +3598,6 @@ var DOCUMENTATION_RESPONSIVE_CSS = String.raw`
   .documentation-search-results { max-height: none; }
   .documentation-search-dialog > footer { justify-content: center; }
   .documentation-launcher-dock { padding-bottom: 12px; }
-  .documentation-launcher-agent { padding: 0 9px; }
-  .documentation-launcher-agent .documentation-launcher-agent-name { display: none; }
   .documentation-launcher-hint { display: none; }
   .documentation-assistant { inset: auto auto 0 0; width: 100%; height: calc(100vh - 8px); transform: none; border-width: 1px 0 0; border-radius: 18px 18px 0 0; }
   .documentation-assistant-suggestions { grid-template-columns: 1fr; }
@@ -3585,6 +3626,7 @@ function renderPage(options, assets = {}, runtime = createPageRuntime(options))
   const { data: runtimeData, document: runtimeDocument } = runtime;
   const theme = runtimeData.config.theme;
   const accent = documentationAccent(theme);
+  const accentDark = validCssColor(theme.accentDark) ? theme.accentDark : void 0;
   const background = validCssColor(theme.background) ? theme.background : "#fbfcfe";
   const backgroundDark = validCssColor(theme.backgroundDark) ? theme.backgroundDark : "#0c0e14";
   const defaultMode = theme.defaultMode ?? "system";
@@ -3613,6 +3655,7 @@ function renderPage(options, assets = {}, runtime = createPageRuntime(options))
   <meta property="og:description" content="${escapeHtml(runtimeDocument.openGraph["og:description"] ?? "")}">
   ${runtimeDocument.openGraph["og:url"] ? `<meta property="og:url" content="${escapeHtml(runtimeDocument.openGraph["og:url"])}">` : ""}
   ${config.seo.ogImage ? `<meta property="og:image" content="${escapeHtml(config.seo.ogImage)}">` : ""}
+  ${config.seo.ogImage ? `<meta name="twitter:image" content="${escapeHtml(config.seo.ogImage)}">` : ""}
   <meta name="twitter:card" content="${config.seo.ogImage ? "summary_large_image" : "summary"}">
   <meta name="theme-color" media="(prefers-color-scheme: light)" content="${background}">
   <meta name="theme-color" media="(prefers-color-scheme: dark)" content="${backgroundDark}">
@@ -3621,7 +3664,7 @@ function renderPage(options, assets = {}, runtime = createPageRuntime(options))
   ${fontPreloads}
   <link rel="stylesheet" href="${assetRoot}/documentation.css">
   ${(assets.customStylesheets ?? []).map((href) => `<link rel="stylesheet" href="${escapeHtml(href)}">`).join("\n  ")}
-  <style>${fontFaces}:root{--documentation-accent:${accent};--documentation-brand-bg:${background};--documentation-brand-bg-dark:${backgroundDark};--documentation-font-body:${bodyFont};--documentation-font-heading:${headingFont};--documentation-font-mono:${monoFont}}</style>
+  <style>${fontFaces}:root{--documentation-accent-light:${accent};${accentDark ? `--documentation-accent-dark:${accentDark};` : ""}--documentation-brand-bg:${background};--documentation-brand-bg-dark:${backgroundDark};--documentation-font-body:${bodyFont};--documentation-font-heading:${headingFont};--documentation-font-mono:${monoFont}}</style>
   <script src="${assetRoot}/documentation-theme.js"></script>
 </head>
 <body data-route="${escapeHtml(page.route)}">