deepspace 0.19.3 → 0.19.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # deepspace
 
+## 0.19.5
+
+### Patch Changes
+
+- The CLI's documentation pointer follows the docs cutover: `deepspace app update` guidance and the npm README now link https://docs.deep.space (documentation.deep.space is retired).
+
+## 0.19.4
+
+### Patch Changes
+
+- Documentation feature quality pass. Navigation is a hard cut: the view-transition machinery is deleted outright, a route swap commits in one synchronous frame with scroll applied in the same commit (from a settled scroll exactly [oldY, 0] is observable — cross-page hash arrivals included), and a failed popstate restore reloads instead of leaving stale content. The Ask AI launcher is a single glass input row (the "Ask AI" chip is gone), stays present through the end of the article, and no longer paints a gradient band over content; the composer auto-grows to a 160px cap with no visible scrollbar below it; send buttons share one circular spec with readable ink on the accent in both themes; assistant errors render as callouts. Dark mode gets a readable accent via the new theme.accentDark option (also mapped from Mintlify's colors.light) with an automatic lightened fallback. The outline highlight follows every click, including short last sections (reading-line scroll spy). Sidebar active state, callouts, and the navigation progress bar are flat — no gradients, no glow. Code blocks: the language label becomes a hover chip (reclaiming 38px per block), filename fences render a title bar on both content paths, and fence options like {1,3-4} or wrap no longer masquerade as titles. Anchors land at a single scroll-padding clearance. Chrome spawns no native drag ghosts, never selects its labels, and its inputs never invite autofill; og:image now pairs with twitter:image; the unused navigation.global config field is removed.
+
 ## 0.19.3
 
 ### Patch Changes

package/README.md

@@ -134,7 +134,7 @@ DeepSpace verifies GitHub but never writes it. Inspect or transfer authority wit
 `deepspace app source deepspace`. Transfers mirror branches and tags before one
 atomic authority change; switching back uses the same commands. Commands support
 `--json` for agents. Use `deepspace --help`, command-specific `--help`, and the
-[public manual](https://documentation.deep.space) for workspaces, releases, and
+[public manual](https://docs.deep.space) for workspaces, releases, and
 rollback.
 
 In a container, give Git its own credentials before a private-repository

package/dist/{chunk-233GQU2H.js → chunk-A7UFIOWO.js}

@@ -293,14 +293,27 @@ 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 }),
-    language ? /* @__PURE__ */ jsx2("span", { className: "documentation-code-language", children: language }) : null,
-    /* @__PURE__ */ jsx2("div", { className: "documentation-code-actions", children: /* @__PURE__ */ jsx2(CodeBlockActions, { readCode }) })
+    /* @__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";
@@ -552,7 +565,7 @@ ${code}`)
       ))
     ] }),
     data.page.openapi?.playground && /* @__PURE__ */ jsx4(ApiPlayground, { operation: data.page.openapi }),
-    launcher,
+    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" }),
@@ -612,14 +625,51 @@ function ContextRail({
   const [active, setActive] = useState3(headings[0]?.id ?? "");
   useEffect3(() => setActive(headings[0]?.id ?? ""), [headings]);
   useEffect3(() => {
-    if (typeof IntersectionObserver === "undefined") return;
-    const elements = headings.map((heading) => document.getElementById(heading.id)).filter(Boolean);
-    const observer = new IntersectionObserver((entries) => {
-      const visible = entries.filter((entry) => entry.isIntersecting).sort((left, right) => left.boundingClientRect.top - right.boundingClientRect.top);
-      if (visible[0]?.target.id) setActive(visible[0].target.id);
-    }, { rootMargin: "-88px 0px -68% 0px", threshold: [0, 1] });
-    elements.forEach((element) => observer.observe(element));
-    return () => observer.disconnect();
+    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" }),
@@ -666,11 +716,11 @@ ${text}`);
     /* @__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", autoComplete: "off", value: token, onChange: (event) => setToken(event.target.value), placeholder: "Optional" })
+      /* @__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, spellCheck: "false", value: body, onChange: (event) => setBody(event.target.value), placeholder: "{}" })
+      /* @__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 })
@@ -688,15 +738,22 @@ function useCodeBlockMounts(articleRef, route) {
       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;
-        block.appendChild(label);
+        host.appendChild(label);
       }
-      const host = document.createElement("div");
-      host.className = "documentation-code-actions";
       block.appendChild(host);
       created.push({ block, pre });
       next.push({ key: `${route}:${index}`, host, pre });
@@ -888,7 +945,6 @@ function AssistantLauncher({
   input,
   name,
   onInputChange,
-  onOpen,
   onSubmit
 }) {
   const subject = documentationSubject(name);
@@ -905,18 +961,19 @@ function AssistantLauncher({
       id: "deepspace-documentation-assistant-launcher",
       onSubmit: submit,
       children: [
-        /* @__PURE__ */ jsxs5("button", { className: "documentation-launcher-agent", type: "button", onClick: onOpen, "aria-label": `Open the ${subject} agent`, children: [
-          "Ask ",
-          /* @__PURE__ */ jsx5("span", { className: "documentation-launcher-agent-name", children: "AI" })
-        ] }),
         /* @__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
           }
         ),
@@ -944,6 +1001,7 @@ function DocumentationAssistant({
   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);
@@ -964,6 +1022,13 @@ function DocumentationAssistant({
     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) => {
@@ -1085,7 +1150,11 @@ function DocumentationAssistant({
             "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) => {
@@ -1095,7 +1164,9 @@ function DocumentationAssistant({
                 }
               },
               placeholder: "Ask a question about this documentation",
-              rows: 2,
+              ref: composerRef,
+              rows: 1,
+              spellCheck: false,
               value: input
             }
           ),
@@ -1434,8 +1505,11 @@ function SearchCommand({
           "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);
@@ -1443,6 +1517,7 @@ function SearchCommand({
           onKeyDown: handleKeyDown,
           placeholder: `Search ${name}`,
           role: "combobox",
+          spellCheck: false,
           value: query
         }
       ),
@@ -1451,7 +1526,7 @@ function SearchCommand({
     /* @__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 this commit" }),
+        /* @__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" }),
@@ -1660,16 +1735,15 @@ function DocumentationApp({
               Article,
               {
                 data,
-                launcher: assistantAccess && !assistantOpen ? /* @__PURE__ */ jsx8("div", { className: "documentation-launcher-dock", children: /* @__PURE__ */ jsx8(
+                launcher: assistantAccess && !assistantOpen ? /* @__PURE__ */ jsx8(
                   AssistantLauncher,
                   {
                     input: assistantDraft,
                     name: data.config.name,
-                    onOpen: () => openAssistant(),
                     onInputChange: setAssistantDraft,
                     onSubmit: (question) => openAssistant(question, true)
                   }
-                ) }) : void 0,
+                ) : void 0,
                 onAssistantOpen: openAssistant,
                 children
               }
@@ -1778,14 +1852,14 @@ function CodeGroup({ children, label, title }) {
     label: codeBlockTitle(child) ?? `Example ${index + 1}`,
     content: child
   }));
-  return /* @__PURE__ */ jsx9(
+  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) => {
@@ -1875,4 +1949,4 @@ export {
   DefaultDocumentation,
   DocumentationContent
 };
-//# sourceMappingURL=chunk-233GQU2H.js.map
+//# sourceMappingURL=chunk-A7UFIOWO.js.map