@stainless-api/docs 0.1.0-beta.87 → 0.1.0-beta.88

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @stainless-api/docs
 
+## 0.1.0-beta.88
+
+### Minor Changes
+
+- c1fb4e5: remove CMS server; refactor and simplify spec generation pipeline
+
+### Patch Changes
+
+- Updated dependencies [65a1c9b]
+- Updated dependencies [4f1cee7]
+- Updated dependencies [4c72a83]
+- Updated dependencies [068469b]
+  - @stainless-api/docs-ui@0.1.0-beta.66
+  - @stainless-api/docs-search@0.1.0-beta.19
+
 ## 0.1.0-beta.87
 
 ### Patch Changes

package/eslint-suppressions.json

@@ -4,26 +4,6 @@
       "count": 2
     }
   },
-  "plugin/cms/client.ts": {
-    "@typescript-eslint/no-explicit-any": {
-      "count": 1
-    }
-  },
-  "plugin/cms/server.ts": {
-    "@typescript-eslint/no-explicit-any": {
-      "count": 3
-    }
-  },
-  "plugin/cms/sidebar-builder.ts": {
-    "@typescript-eslint/no-explicit-any": {
-      "count": 1
-    }
-  },
-  "plugin/cms/worker.ts": {
-    "@typescript-eslint/no-explicit-any": {
-      "count": 3
-    }
-  },
   "plugin/components/SnippetCode.tsx": {
     "@typescript-eslint/no-explicit-any": {
       "count": 1
@@ -44,9 +24,9 @@
       "count": 1
     }
   },
-  "shared/virtualModule.ts": {
+  "plugin/specs/worker.ts": {
     "@typescript-eslint/no-explicit-any": {
-      "count": 1
+      "count": 3
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stainless-api/docs",
-  "version": "0.1.0-beta.87",
+  "version": "0.1.0-beta.88",
   "publishConfig": {
     "access": "public"
   },
@@ -18,7 +18,7 @@
     "./components": "./stl-docs/components/index.ts",
     "./components/scripts": "./stl-docs/components/scripts.ts",
     "./docs-config": "./stl-docs/loadStlDocsConfig.ts",
-    "./cms-client": "./plugin/cms/client.ts",
+    "./specs/fetchSpecSSR": "./plugin/specs/fetchSpecSSR.ts",
     "./generate-docs-routes": "./plugin/helpers/generateDocsRoutes.ts",
     "./components/Head": "./stl-docs/components/Head.astro",
     "./components/ContentBreadcrumbs": "./stl-docs/components/ContentBreadcrumbs.tsx"
@@ -44,7 +44,6 @@
     "cheerio": "^1.1.2",
     "clsx": "^2.1.1",
     "dotenv": "17.2.3",
-    "get-port": "^7.1.0",
     "lucide-react": "^0.562.0",
     "marked": "^17.0.1",
     "node-html-parser": "^7.0.1",
@@ -58,8 +57,8 @@
     "vite-plugin-prebundle-workers": "^0.2.0",
     "web-worker": "^1.5.0",
     "yaml": "^2.8.2",
-    "@stainless-api/docs-search": "0.1.0-beta.18",
-    "@stainless-api/docs-ui": "0.1.0-beta.65",
+    "@stainless-api/docs-search": "0.1.0-beta.19",
+    "@stainless-api/docs-ui": "0.1.0-beta.66",
     "@stainless-api/ui-primitives": "0.1.0-beta.46"
   },
   "devDependencies": {

package/playground-virtual-modules.d.ts

@@ -0,0 +1,96 @@
+declare module 'virtual:stl-playground/typescript.json' {
+  const data: {
+    links: [string, string][];
+    files: [string, string][];
+  } | null;
+  export { data as default };
+}
+declare module 'virtual:stl-playground/python.json' {
+  const data: { files: Record<string, string>; wheel: string } | null;
+  export { data as default };
+}
+declare module 'virtual:stl-playground/auth.json' {
+  const data:
+    | ({
+        type: 'http_bearer' | 'query' | 'header' | 'oauth2' | 'http_basic' | 'http_digest';
+        description?: string;
+        name: string;
+        title: string;
+        header: string | undefined;
+        example: string | undefined;
+      } & {
+        opts: {
+          name: string;
+          type: 'string' | 'number' | 'boolean' | 'null' | 'integer';
+          nullable: boolean;
+          description?: string | undefined;
+          example?: unknown;
+          default?: unknown;
+          read_env?: string | undefined;
+          auth?:
+            | {
+                security_scheme: string;
+                role?: 'value' | 'password' | 'username' | 'client_id' | 'client_secret' | undefined;
+              }
+            | undefined;
+        }[];
+      })[]
+    | null;
+  export { data as default };
+}
+declare module 'virtual:stl-playground/data' {
+  import type { Config } from 'virtual:stl-playground/create';
+  declare const data: Config;
+  export { data as default };
+}
+declare module 'virtual:stl-playground/create' {
+  export type PlaygroundLanguage = 'python' | 'typescript' | 'http';
+  export type Config = {
+    wheelUrl: string;
+    pyTypes: {
+      files: Record<string, string>;
+      wheel: string;
+    } | null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    HIGHLIGHT_THEMES: any;
+    tsTypes: {
+      links: [string, string][];
+      files: [string, string][];
+    } | null;
+    authData:
+      | ({
+          type: 'http_bearer' | 'query' | 'header' | 'oauth2' | 'http_basic' | 'http_digest';
+          description?: string;
+          name: string;
+          title: string;
+          header: string | undefined;
+          example: string | undefined;
+        } & {
+          opts: {
+            name: string;
+            type: 'string' | 'number' | 'boolean' | 'null' | 'integer';
+            nullable: boolean;
+            description?: string | undefined;
+            example?: unknown;
+            default?: unknown;
+            read_env?: string | undefined;
+            auth?:
+              | {
+                  security_scheme: string;
+                  role?: 'value' | 'password' | 'username' | 'client_id' | 'client_secret' | undefined;
+                }
+              | undefined;
+          }[];
+        })[]
+      | null;
+  };
+  export function createPlayground(
+    props: {
+      lang: PlaygroundLanguage;
+      doc: string;
+      /** div.stl-snippet-request-container */
+      container: HTMLElement;
+      onLanguageSelect: (value: string) => void;
+    } & Config,
+  ): () => Promise<void>;
+}

package/plugin/buildAlgoliaIndex.ts

@@ -1,10 +1,9 @@
 import Markdoc from '@markdoc/markdoc';
 import Stainless from '@stainless-api/sdk';
-import { createSDKJSON, parseInputs, transformOAS } from './cms/worker';
+import { createSDKJSON, parseInputs, transformOAS } from './specs/worker';
 import type * as SDKJSON from '@stainless/sdk-json';
 import { Languages } from '@stainless-api/docs-ui/routing';
 import { buildIndex } from '@stainless-api/docs-search/providers/algolia';
-import type { VersionUserConfig } from './loadPluginConfig';
 import type { AstroIntegrationLogger } from 'astro';
 
 const markdocConfig = {
@@ -22,11 +21,13 @@ function renderMarkdown(content?: string) {
 }
 
 export async function buildAlgoliaIndex({
-  version,
+  stainlessProject,
+  branch,
   apiKey,
   logger,
 }: {
-  version: VersionUserConfig;
+  stainlessProject: string;
+  branch: string;
   apiKey: string;
   logger?: AstroIntegrationLogger;
 }) {
@@ -46,10 +47,11 @@ export async function buildAlgoliaIndex({
     }
   }
 
+  // TODO: this is all redundant with the spec code and should be DRYed
   const client = new Stainless({ apiKey });
   const configs = await client.projects.configs.retrieve({
-    project: version.stainlessProject,
-    branch: version.branch,
+    project: stainlessProject,
+    branch,
     include: 'openapi',
   });
 
@@ -74,7 +76,7 @@ export async function buildAlgoliaIndex({
     oas: transformedOAS,
     config,
     languages,
-    projectName: version.stainlessProject,
+    projectName: stainlessProject,
   });
 
   const {

package/plugin/components/SDKSelect.astro

@@ -1,10 +1,10 @@
 ---
-import type { DocsLanguage } from '@stainless-api/docs-ui/routing';
 import { parseRoute } from '@stainless-api/docs-ui/routing';
-import { cmsClient } from '../cms/client';
 import { BASE_PATH, DEFAULT_LANGUAGE, EXCLUDE_LANGUAGES } from 'virtual:stl-starlight-virtual-module';
 import { Languages } from '../languages';
 import { SDKSelectReactComponent } from '../react/Routing';
+import { getSDKJSONInSSR } from '../specs/fetchSpecSSR';
+import { getDocsLanguages } from '../helpers/getDocsLanguages';
 
 const slug = `/${Astro.locals.starlightRoute.id}`;
 
@@ -19,17 +19,13 @@ const data = {
   defaultLanguage,
 };
 
-const spec = await cmsClient.getSpec();
+const spec = await getSDKJSONInSSR();
 
-// TODO: should not force unwrap this
-const languages: DocsLanguage[] = spec.docs!.languages ?? ['http'];
-const options = languages
-  .filter((language) => !EXCLUDE_LANGUAGES.includes(language))
-  .map((value) => ({
-    value,
-    label: Languages[value].name,
-    selected: data.language === value,
-  }));
+const options = getDocsLanguages(spec, EXCLUDE_LANGUAGES).map((value) => ({
+  value,
+  label: Languages[value].name,
+  selected: data.language === value,
+}));
 
 const readmeSlug = language === 'http' ? BASE_PATH : `${BASE_PATH}/${language}`;
 ---

package/plugin/helpers/getDocsLanguages.ts

@@ -0,0 +1,9 @@
+import { DocsLanguage } from '@stainless-api/docs-ui/routing';
+import type * as SDKJSON from '@stainless/sdk-json';
+
+export function getDocsLanguages(spec: SDKJSON.Spec, excludeLanguages: DocsLanguage[]) {
+  // TODO: should not force unwrap this
+  const languages: DocsLanguage[] = spec.docs!.languages ?? ['http'];
+
+  return languages.filter((language) => !excludeLanguages.includes(language));
+}

package/plugin/index.ts

@@ -1,27 +1,26 @@
 import react from '@astrojs/react';
 import type { StarlightPlugin } from '@astrojs/starlight/types';
-import type { AstroIntegration, AstroIntegrationLogger } from 'astro';
+import type { AstroIntegration } from 'astro';
 import type { BundledTheme } from 'shiki';
 import { config } from 'dotenv';
-import getPort from 'get-port';
-import { DevSpecServer, startDevServer, type SpecResp } from './cms/server';
 import { buildAlgoliaIndex } from './buildAlgoliaIndex';
 import {
   getAPIReferencePlaceholderItemFromSidebarConfig,
   makePlaceholderItems,
 } from './referencePlaceholderUtils';
-import type {
-  GeneratedSidebarConfig,
-  ReferenceSidebarConfigGenerateOptions,
-  ReferenceSidebarConfigItem,
-} from './cms/sidebar-builder';
+import {
+  SidebarConfigItemsBuilder,
+  toStarlightSidebar,
+  type GeneratedSidebarConfig,
+  type ReferenceSidebarConfigGenerateOptions,
+  type ReferenceSidebarConfigItem,
+} from './sidebar-utils/sidebar-builder';
 import {
   parseStarlightPluginConfig,
   type NormalizedStainlessStarlightConfig,
   type SomeStainlessStarlightUserConfig,
-  type SpecRetrieverConfig,
 } from './loadPluginConfig';
-import { buildVirtualModuleString } from '../shared/virtualModule';
+import { buildVirtualModuleString, makeAsyncVirtualModPlugin } from '../shared/virtualModule';
 import type * as StlStarlightVirtualModule from 'virtual:stl-starlight-virtual-module';
 import path from 'path';
 import fs from 'fs';
@@ -30,6 +29,10 @@ import { resolveSrcFile } from '../resolveSrcFile';
 import { mkdir, writeFile } from 'fs/promises';
 import { fileURLToPath } from 'url';
 import prebundleWorkers from 'vite-plugin-prebundle-workers';
+import { SpecLoader, startSpecLoader } from './specs';
+
+import type * as ReferenceSidebarsVirtualModule from 'virtual:stl-starlight-reference-sidebars';
+import { getDocsLanguages } from './helpers/getDocsLanguages';
 import { generateMissingRouteList } from '@stainless-api/docs-ui/routing';
 
 export { generateAPILink } from './generateAPIReferenceLink';
@@ -88,37 +91,8 @@ export function generateAPIReferenceItems(
   return makePlaceholderItems(id);
 }
 
-function tmpGetCMSServerConfig(specRetrieverConfig: SpecRetrieverConfig) {
-  if (specRetrieverConfig.kind === 'external_spec_server') {
-    throw new Error('External spec server is not yet supported');
-  }
-  if (specRetrieverConfig.kind === 'local_spec_server_with_files') {
-    if (!specRetrieverConfig.apiKey) {
-      throw new Error('API key is required');
-    }
-    return {
-      apiKey: specRetrieverConfig.apiKey,
-      version: specRetrieverConfig.version,
-      devPaths: specRetrieverConfig.devPaths,
-    };
-  }
-
-  if (specRetrieverConfig.kind === 'local_spec_server_with_remote_files') {
-    return {
-      apiKey: specRetrieverConfig.apiKey,
-      version: specRetrieverConfig.version,
-      devPaths: {
-        oasPath: undefined,
-        configPath: undefined,
-      },
-    };
-  }
-  throw new Error('Invalid spec retriever config');
-}
-
 async function stlStarlightAstroIntegration(
   pluginConfig: NormalizedStainlessStarlightConfig,
-  stlStarlightPluginLogger: AstroIntegrationLogger,
 ): Promise<AstroIntegration> {
   const virtualId = `virtual:stl-starlight-virtual-module`;
   // The '\0' prefix tells Vite “this is a virtual module” and prevents it from being resolved again.
@@ -127,11 +101,15 @@ async function stlStarlightAstroIntegration(
   let buildPlaygrounds;
   let astroBase = '/';
 
-  const CMS_PORT = await getPort();
-
-  const { apiKey, version, devPaths } = tmpGetCMSServerConfig(pluginConfig.specRetrieverConfig);
-
-  let cmsServer: DevSpecServer | undefined;
+  let specLoader: SpecLoader | undefined;
+  async function getSpec() {
+    if (!specLoader) throw new Error('Expected spec loader to exist');
+    const result = await specLoader.specPromise;
+    return {
+      spec: result.spec.data,
+      auth: result.spec.auth,
+    };
+  }
 
   let building: Promise<void> | undefined;
   let reportError: ((message: string) => void) | null = null;
@@ -141,17 +119,9 @@ async function stlStarlightAstroIntegration(
     if (!pluginConfig.experimentalPlaygrounds) return;
     if (building) return building;
     return (building = (async () => {
-      const { data: spec, auth } = (await (
-        await fetch(`http://localhost:${CMS_PORT}/retrieve_spec`, {
-          method: 'POST',
-          body: JSON.stringify({}),
-        })
-      ).json()) as SpecResp;
-      if (!spec || !auth) throw new Error('expected spec');
-
-      const langs = (spec.docs?.languages ?? ['http']).filter(
-        (lang) => !pluginConfig.excludeLanguages?.includes(lang),
-      );
+      const { spec, auth } = await getSpec();
+
+      const langs = getDocsLanguages(spec, pluginConfig.excludeLanguages);
 
       await buildPlaygrounds!({
         spec,
@@ -180,28 +150,13 @@ async function stlStarlightAstroIntegration(
         const projectDir = astroConfig.root.pathname;
         astroBase = astroConfig.base;
 
-        const codegenDir = createCodegenDir().pathname;
-
-        let specCacheDirectory: string | null = null;
-        if (command === 'dev') {
-          specCacheDirectory = path.join(codegenDir, 'spec_cache');
-          fs.mkdirSync(specCacheDirectory, { recursive: true });
-        }
-
-        cmsServer = startDevServer({
-          port: CMS_PORT,
-          apiKey: apiKey.value,
-          version,
-          devPaths,
-          logger: stlStarlightPluginLogger,
-          specCacheDirectory,
-          getGeneratedSidebarConfig: (id: number) => {
-            const config = sidebarConfigs.get(id);
-            if (!config) {
-              return null;
-            }
-            return config;
-          },
+        specLoader = await startSpecLoader(pluginConfig, logger, createCodegenDir());
+        specLoader.specPromise.then((specResult) => {
+          if (specResult.result === 'generated') {
+            logger.info(`Generated new SDKJSON`);
+          } else if (specResult.result === 'exists') {
+            logger.info(`Loaded SDKJSON`);
+          }
         });
 
         reportError = (message: string) => logger.error(message);
@@ -240,6 +195,55 @@ async function stlStarlightAstroIntegration(
         updateConfig({
           vite: {
             plugins: [
+              makeAsyncVirtualModPlugin<typeof ReferenceSidebarsVirtualModule>(
+                'virtual:stl-starlight-reference-sidebars',
+                async () => {
+                  const { spec } = await getSpec();
+                  const languages = getDocsLanguages(spec, pluginConfig.excludeLanguages);
+
+                  const sidebars = [...sidebarConfigs.entries()]
+                    // produce all { id, language } combos with the attached config
+                    // flattens to one item per language * id combo
+                    .flatMap(([id, config]) =>
+                      languages.map((language) => ({
+                        id,
+                        config,
+                        language,
+                      })),
+                    )
+                    // produce a sidebar for each
+                    // later we will .find() the sidebar that matches the (id, language)
+                    .map(({ id, config, language }) => {
+                      const configItemsBuilder = new SidebarConfigItemsBuilder(
+                        spec,
+                        language,
+                        config.options,
+                      );
+
+                      let userSidebarConfig = configItemsBuilder.generateItems();
+                      if (config.transformFn) {
+                        const transformedSidebarConfig = config.transformFn(userSidebarConfig, language);
+                        if (transformedSidebarConfig) userSidebarConfig = transformedSidebarConfig;
+                      }
+
+                      return {
+                        id,
+                        language,
+                        // this has to run multpile times because it depends on the
+                        // userSidebarConfig (which is per-id) and the language
+                        entries: toStarlightSidebar({
+                          basePath: path.posix.join(astroBase, pluginConfig.basePath), // TODO, is this right?
+                          spec,
+                          entries: userSidebarConfig,
+                          currentLanguage: language,
+                        }),
+                      };
+                    });
+
+                  return { sidebars };
+                },
+              ),
+              specLoader.vitePlugin,
               {
                 name: 'stl-starlight-vite',
                 buildStart() {
@@ -251,23 +255,7 @@ async function stlStarlightAstroIntegration(
                       .buildPlaygrounds;
                   }
 
-                  for (const filePath of Object.values(devPaths)) {
-                    if (!filePath) {
-                      continue;
-                    }
-                    server.watcher.add(filePath);
-                  }
-
-                  server.watcher.on('change', async (changed) => {
-                    if (Object.values(devPaths).includes(changed)) {
-                      logger.info(`${changed} changed, reloading...`);
-                      cmsServer?.invalidate();
-                      server.hot.send({
-                        type: 'full-reload',
-                        path: '*',
-                      });
-                    }
-                  });
+                  // TODO: eventually - re-add support for watching local input changes (eg. reloading when OAS/config files change)
                 },
                 resolveId(id) {
                   if (id === virtualId) {
@@ -313,8 +301,7 @@ async function stlStarlightAstroIntegration(
                     return [
                       buildVirtualModuleString({
                         BASE_PATH: path.posix.join(astroConfig.base, pluginConfig.basePath),
-                        CMS_PORT,
-                        EXCLUDE_LANGUAGES: ['php', ...pluginConfig.excludeLanguages],
+                        EXCLUDE_LANGUAGES: pluginConfig.excludeLanguages,
                         DEFAULT_LANGUAGE: pluginConfig.defaultLanguage,
                         BREADCRUMB_CONFIG: pluginConfig.breadcrumbs,
                         EXPAND_RESOURCES: pluginConfig.expandResources,
@@ -327,7 +314,7 @@ async function stlStarlightAstroIntegration(
                         ENABLE_CONTEXT_MENU: pluginConfig.contextMenu,
                         EXPERIMENTAL_PLAYGROUNDS: !!pluginConfig.experimentalPlaygrounds,
                         EXPERIMENTAL_REQUEST_BUILDER: pluginConfig.experimentalRequestBuilder,
-                        STAINLESS_PROJECT: version.stainlessProject,
+                        STAINLESS_PROJECT: pluginConfig.specInputs.project,
                       } satisfies Omit<typeof StlStarlightVirtualModule, 'MIDDLEWARE'>),
                       vmMiddlewareExport,
                     ].join('\n');
@@ -353,9 +340,6 @@ async function stlStarlightAstroIntegration(
           },
         });
       },
-      'astro:server:done': async () => {
-        await cmsServer?.destroy();
-      },
       'astro:build:start'({ logger }) {
         collectedErrors = [];
         reportError = (message: string) => {
@@ -384,25 +368,16 @@ async function stlStarlightAstroIntegration(
         // Instead of showing a generic 404, we statically generate pages for these routes and mark them
         // in this file so Cloudflare can serve them with a 404 status. These pages display helpful information
         // about the missing method and provide links to SDKs where it is available.
-        const { data: spec } = (await (
-          await fetch(`http://localhost:${CMS_PORT}/retrieve_spec`, {
-            method: 'POST',
-            body: JSON.stringify({}),
-          })
-        ).json()) as SpecResp;
-        if (spec) {
-          const missingRoutes = await generateMissingRouteList({
-            spec,
-            basePath: path.posix.join(astroBase, pluginConfig.basePath),
-          });
-          await mkdir(stainlessDir, { recursive: true });
-          await writeFile(
-            path.join(stainlessDir, 'missing-routes.json'),
-            JSON.stringify(missingRoutes, null, 2),
-          );
-        } else {
-          console.log('Could not retrieve spec for missing routes check');
-        }
+        const { spec } = await getSpec();
+        const missingRoutes = generateMissingRouteList({
+          spec,
+          basePath: path.posix.join(astroBase, pluginConfig.basePath),
+        });
+        await mkdir(stainlessDir, { recursive: true });
+        await writeFile(
+          path.join(stainlessDir, 'missing-routes.json'),
+          JSON.stringify(missingRoutes, null, 2),
+        );
       },
     },
   };
@@ -444,40 +419,41 @@ export function stainlessStarlight(someUserConfig: SomeStainlessStarlightUserCon
           addIntegration(react());
         }
 
-        if ('apiKey' in config.specRetrieverConfig) {
-          if (!config.specRetrieverConfig.apiKey) {
+        if ('apiKey' in config.specInputs) {
+          if (!config.specInputs.apiKey) {
             logger.info(`Stainless credentials not loaded`);
-          } else if (config.specRetrieverConfig.apiKey.source === 'explicit-config') {
+          } else if (config.specInputs.apiKey.source === 'explicit-config') {
             logger.info(`Stainless credentials loaded from user config`);
-          } else if (config.specRetrieverConfig.apiKey.source === 'environment-variable') {
+          } else if (config.specInputs.apiKey.source === 'environment-variable') {
             logger.info('Stainless credentials loaded from `STAINLESS_API_KEY` environment variable');
-          } else if (config.specRetrieverConfig.apiKey.source === 'cli') {
+          } else if (config.specInputs.apiKey.source === 'cli') {
             logger.info('Stainless credentials loaded from `stl` CLI');
           }
         }
 
-        if (
-          command === 'build' &&
-          config.specRetrieverConfig.kind === 'local_spec_server_with_remote_files'
-        ) {
+        if (command === 'build' && config.specInputs.kind === 'stainless_api_inputs') {
           await buildAlgoliaIndex({
-            version: config.specRetrieverConfig.version,
-            apiKey: config.specRetrieverConfig.apiKey.value,
+            stainlessProject: config.specInputs.project,
+            branch: config.specInputs.branch,
+            apiKey: config.specInputs.apiKey.value,
             logger,
           });
         }
 
-        addIntegration(await stlStarlightAstroIntegration(config, logger));
-
         if (starlightConfig.sidebar) {
           // for pagination (https://starlight.astro.build/reference/configuration/#pagination) to work correctly
           // update the placeholder link to be correct
-          const item = getAPIReferencePlaceholderItemFromSidebarConfig(starlightConfig.sidebar);
-          if (item && typeof item === 'object' && 'link' in item) {
-            item.link = config.basePath;
+          for (const placeholder of getAPIReferencePlaceholderItemFromSidebarConfig(
+            starlightConfig.sidebar,
+          )) {
+            if (placeholder && typeof placeholder === 'object' && 'link' in placeholder) {
+              placeholder.link = config.basePath;
+            }
           }
         }
 
+        addIntegration(await stlStarlightAstroIntegration(config));
+
         const expressiveCodeConfig =
           typeof starlightConfig.expressiveCode === 'object' ? starlightConfig.expressiveCode : {};