@stainless-api/docs 0.1.0-beta.65 → 0.1.0-beta.67

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @stainless-api/docs
 
+## 0.1.0-beta.67
+
+### Patch Changes
+
+- a59d5f7: Pass current page context through as “intent”
+- Updated dependencies [e9567b0]
+  - @stainless-api/ui-primitives@0.1.0-beta.40
+  - @stainless-api/docs-ui@0.1.0-beta.53
+  - @stainless-api/docs-search@0.1.0-beta.5
+
+## 0.1.0-beta.66
+
+### Patch Changes
+
+- af54129: fix: index missing prose docs for search
+
 ## 0.1.0-beta.65
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/docs",
-  "version": "0.1.0-beta.65",
+  "version": "0.1.0-beta.67",
   "publishConfig": {
     "access": "public"
   },
@@ -40,7 +40,7 @@
     "clsx": "^2.1.1",
     "dotenv": "17.2.3",
     "get-port": "^7.1.0",
-    "lucide-react": "^0.561.0",
+    "lucide-react": "^0.562.0",
     "marked": "^17.0.1",
     "node-html-parser": "^7.0.1",
     "rehype-parse": "^9.0.1",
@@ -48,19 +48,19 @@
     "remark-gfm": "^4.0.1",
     "remark-github-alerts": "^0.1.1",
     "remark-stringify": "^11.0.0",
-    "shiki": "^3.19.0",
+    "shiki": "^3.20.0",
     "unified": "^11.0.5",
     "vite-plugin-prebundle-workers": "^0.2.0",
     "web-worker": "^1.5.0",
     "yaml": "^2.8.2",
-    "@stainless-api/docs-ui": "0.1.0-beta.52",
-    "@stainless-api/docs-search": "0.1.0-beta.4",
-    "@stainless-api/ui-primitives": "0.1.0-beta.39"
+    "@stainless-api/docs-search": "0.1.0-beta.5",
+    "@stainless-api/docs-ui": "0.1.0-beta.53",
+    "@stainless-api/ui-primitives": "0.1.0-beta.40"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.6",
     "@markdoc/markdoc": "^0.5.4",
-    "@types/node": "24.10.3",
+    "@types/node": "24.10.4",
     "@types/react": "19.2.7",
     "@types/react-dom": "^19.2.3",
     "react": "^19.2.3",
@@ -68,7 +68,7 @@
     "tsx": "^4.21.0",
     "typescript": "5.9.3",
     "vite": "^6.4.1",
-    "zod": "^4.1.13",
+    "zod": "^4.3.5",
     "@stainless/eslint-config": "0.1.0-beta.1",
     "@stainless/sdk-json": "^0.1.0-beta.2"
   },

package/shared/getProsePages.ts

@@ -0,0 +1,42 @@
+import { readdir } from 'fs/promises';
+import { join, relative } from 'path';
+
+/**
+ * Get all prose pages after a build, by reading all HTML files from the
+ * given output directory, and not from assets.
+ *
+ * We cannot use the `assets` map here because it is not guaranteed to
+ * contain all files, especially if they were generated by other integrations.
+ * Other astro integrations may hijack the "[...slug]" entrypoint, and any files
+ * previously in the [...slug] asset map entry would be lost (this is where starlight stores
+ * its prose HTML files).
+ */
+export async function getProsePages({
+  apiReferenceBasePath,
+  outputBasePath,
+}: {
+  apiReferenceBasePath: string | null;
+  outputBasePath: string;
+}): Promise<string[]> {
+  const allFiles = await readdir(outputBasePath, {
+    recursive: true,
+    withFileTypes: true,
+  });
+
+  const htmlFiles = allFiles
+    .filter((file) => file.isFile() && file.name.endsWith('.html'))
+    .map((file) => join(file.parentPath, file.name));
+
+  // Filter out API reference pages
+  const pagesToRender = htmlFiles.filter((absPath) => {
+    if (!apiReferenceBasePath) {
+      return true;
+    }
+    const relPath = relative(outputBasePath, absPath);
+    // Normalize by removing leading/trailing slashes from apiReferenceBasePath
+    const normalizedApiPath = apiReferenceBasePath.replace(/^\/+|\/+$/g, '');
+    return !relPath.startsWith(normalizedApiPath);
+  });
+
+  return pagesToRender;
+}

package/stl-docs/components/AiChatIsland.tsx

@@ -1,8 +1,14 @@
 import type { DocsLanguage } from '@stainless-api/docs-ui/routing';
 import AiChat, { STAINLESS_PROJECT } from 'virtual:stl-docs/components/AiChat.tsx';
 
-export default function AiChatIsland({ currentLanguage }: { currentLanguage: DocsLanguage | undefined }) {
+export default function AiChatIsland({
+  currentLanguage,
+  siteTitle,
+}: {
+  currentLanguage: DocsLanguage | undefined;
+  siteTitle: string | undefined;
+}) {
   if (!AiChat) throw new Error('AiChatIsland was rendered but could not load AiChat component');
   if (!STAINLESS_PROJECT) return null;
-  return <AiChat projectId={STAINLESS_PROJECT} language={currentLanguage} />;
+  return <AiChat projectId={STAINLESS_PROJECT} language={currentLanguage} siteTitle={siteTitle} />;
 }

package/stl-docs/components/PageFrame.astro

@@ -2,6 +2,10 @@
 import Default from '@astrojs/starlight/components/PageFrame.astro';
 import AiChat from 'virtual:stl-docs/components/AiChat.tsx'; // conditionally resolves to null if ai chat module is not injected
 import AiChatIsland from './AiChatIsland.tsx'; // entrypoint for client island can’t be a virtual module
+
+import starlightConfig from 'virtual:starlight/user-config';
+const locale = Astro.currentLocale ?? starlightConfig.defaultLocale.lang;
+const siteTitle = locale && starlightConfig.title[locale];
 ---
 
 <Default>
@@ -10,5 +14,5 @@ import AiChatIsland from './AiChatIsland.tsx'; // entrypoint for client island c
 
   <slot />
 
-  {!!AiChat && <AiChatIsland client:load currentLanguage={Astro.locals.language} />}
+  {!!AiChat && <AiChatIsland client:load currentLanguage={Astro.locals.language} siteTitle={siteTitle} />}
 </Default>

package/stl-docs/index.ts

@@ -271,6 +271,6 @@ export function stainlessDocs(config: StainlessDocsUserConfig) {
       enabled: normalizedConfig.enableProseMarkdownRendering,
       apiReferenceBasePath,
     }),
-    stainlessDocsProseIndexing(),
+    stainlessDocsProseIndexing({ apiReferenceBasePath }),
   ];
 }

package/stl-docs/proseMarkdown/proseMarkdownIntegration.ts

@@ -1,10 +1,10 @@
 import type { AstroIntegration } from 'astro';
-import { readdir, readFile, writeFile } from 'fs/promises';
+import { readFile, writeFile } from 'fs/promises';
 import { toMarkdown } from './toMarkdown';
 import { resolveSrcFile } from '../../resolveSrcFile';
 import { getSharedLogger } from '../../shared/getSharedLogger';
-import { join, relative } from 'path';
 import { bold } from '../../shared/terminalUtils';
+import { getProsePages } from '../../shared/getProsePages';
 
 export function stainlessDocsMarkdownRenderer({
   enabled,
@@ -31,32 +31,7 @@ export function stainlessDocsMarkdownRenderer({
           return;
         }
         const outputBasePath = dir.pathname;
-
-        // Read all HTML files from output directory, and not from assets.
-        // We cannot use the `assets` map here because it is not guaranteed to
-        // contain all files, especially if they were generated by other integrations.
-        // Other astro integrations may hijack the "[...slug]" entrypoint, and any files
-        // previously in the [...slug] asset map entry would be lost (this is where starlight stores
-        // its prose HTML files).
-        const allFiles = await readdir(outputBasePath, {
-          recursive: true,
-          withFileTypes: true,
-        });
-
-        const htmlFiles = allFiles
-          .filter((file) => file.isFile() && file.name.endsWith('.html'))
-          .map((file) => join(file.parentPath, file.name));
-
-        // Filter out API reference pages
-        const pagesToRender = htmlFiles.filter((absPath) => {
-          if (!apiReferenceBasePath) {
-            return true;
-          }
-          const relPath = relative(outputBasePath, absPath);
-          // Normalize by removing leading/trailing slashes from apiReferenceBasePath
-          const normalizedApiPath = apiReferenceBasePath.replace(/^\/+|\/+$/g, '');
-          return !relPath.startsWith(normalizedApiPath);
-        });
+        const pagesToRender = await getProsePages({ apiReferenceBasePath, outputBasePath });
 
         logger.info(bold(`Building ${pagesToRender.length} Markdown pages for prose content`));
 

package/stl-docs/proseSearchIndexing.ts

@@ -1,5 +1,6 @@
 import type { AstroIntegration } from 'astro';
 import { readFile } from 'fs/promises';
+import { getProsePages } from '../shared/getProsePages';
 import { getSharedLogger } from '../shared/getSharedLogger';
 import { bold } from '../shared/terminalUtils';
 import { buildProseIndex } from '@stainless-api/docs-search/providers/algolia';
@@ -306,11 +307,15 @@ export function* indexHTML(content: string, root: string, pattern: string) {
 const root = 'main';
 const pattern = 'h1, h2, h3, h4, h5, h6, p, li';
 
-export function stainlessDocsProseIndexing(): AstroIntegration {
+export function stainlessDocsProseIndexing({
+  apiReferenceBasePath,
+}: {
+  apiReferenceBasePath: string | null;
+}): AstroIntegration {
   return {
     name: 'stl-docs-prose-indexing',
     hooks: {
-      'astro:build:done': async ({ assets, logger: localLogger, dir }) => {
+      'astro:build:done': async ({ logger: localLogger, dir }) => {
         const logger = getSharedLogger({ fallback: localLogger });
         const outputBasePath = dir.pathname;
 
@@ -325,13 +330,7 @@ export function stainlessDocsProseIndexing(): AstroIntegration {
           return;
         }
 
-        const starlightPagePatterns = ['/[...slug]'];
-        const pagesToRender = Array.from(assets.entries())
-          .filter(([k]) => starlightPagePatterns.includes(k))
-          .map(([, v]) => v)
-          .flat()
-          .map((v) => v.pathname);
-
+        const pagesToRender = await getProsePages({ apiReferenceBasePath, outputBasePath });
         logger.info(bold(`Indexing ${pagesToRender.length} prose pages for search`));
 
         const objects = [];

package/virtual-module.d.ts

@@ -56,6 +56,7 @@ declare module 'virtual:stl-docs/components/AiChat.tsx' {
     | import('react').ComponentType<{
         projectId: string;
         language: import('@stainless-api/docs-ui/routing').DocsLanguage | undefined;
+        siteTitle: string | undefined;
       }>
     | null;
   export default AiChatComponent;