pulumi-package-docs 0.3.0 → 0.5.0

package/README.md

@@ -16,6 +16,7 @@ pulumi-package-docs [options]
   -d, --dir <path>   Pulumi project directory to inspect (default: current directory)
   -p, --port <port>  Port to serve on (default: 3000)
   --host             Expose the server on your network
+  --open             Open the docs in your default browser once ready
   -h, --help         Show this help message
 ```
 

package/bin/cli.js

@@ -9,7 +9,7 @@ const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
 const require = createRequire(import.meta.url)
 
 function parseArgs(argv) {
-  const options = { dir: process.cwd(), port: '3000', host: false }
+  const options = { dir: process.cwd(), port: '3000', host: false, open: false }
   for (let i = 0; i < argv.length; i++) {
     const arg = argv[i]
     if (arg === '--dir' || arg === '-d') {
@@ -18,6 +18,8 @@ function parseArgs(argv) {
       options.port = argv[++i]
     } else if (arg === '--host') {
       options.host = true
+    } else if (arg === '--open') {
+      options.open = true
     } else if (arg === '--help' || arg === '-h') {
       options.help = true
     }
@@ -35,6 +37,7 @@ Options:
   -d, --dir <path>   Pulumi project directory to inspect (default: current directory)
   -p, --port <port>  Port to serve on (default: 3000)
   --host             Expose the server on your network
+  --open             Open the docs in your default browser once ready
   -h, --help         Show this help message
 `)
 }
@@ -58,6 +61,7 @@ const viteArgs = [
   options.port,
 ]
 if (options.host) viteArgs.push('--host')
+if (options.open) viteArgs.push('--open')
 
 if (!hasProductionBuild) {
   console.log(
@@ -65,7 +69,6 @@ if (!hasProductionBuild) {
   )
 }
 console.log(`Serving provider docs for: ${options.dir}`)
-console.log(`MCP endpoint: http://localhost:${options.port}/mcp`)
 
 const child = spawn(process.execPath, [viteBin, ...viteArgs], {
   cwd: packageRoot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulumi-package-docs",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Local documentation viewer for the parameterized/local Pulumi providers used by a Pulumi project.",
   "type": "module",
   "license": "MIT",

package/vite.config.ts

@@ -1,12 +1,46 @@
 import { defineConfig } from 'vite'
+import type { Plugin, PreviewServer, ViteDevServer } from 'vite'
 
 import { tanstackStart } from '@tanstack/react-start/plugin/vite'
 
 import viteReact from '@vitejs/plugin-react'
 
+// Matches the ANSI styling Vite's own CLI uses for its "Local"/"Network"
+// bullets (picocolors' green/bold/cyan), so this reads as one more item in
+// that same list rather than a separately-styled line.
+const green = (s: string) => `\x1b[32m${s}\x1b[39m`
+const bold = (s: string) => `\x1b[1m${s}\x1b[22m`
+const cyan = (s: string) => `\x1b[36m${s}\x1b[39m`
+const colorUrl = (url: string) =>
+  cyan(url.replace(/:(\d+)\//, (_, port) => `:${bold(port)}/`))
+
+/** Prints the MCP endpoint alongside Vite's own "Local"/"Network" bullets. */
+function printMcpUrl(): Plugin {
+  function withMcpUrl(server: ViteDevServer | PreviewServer) {
+    const printUrls = server.printUrls.bind(server)
+    server.printUrls = () => {
+      printUrls()
+      const base = server.resolvedUrls?.local[0]
+      if (!base) return
+      const url = new URL('mcp', base).toString()
+      // Padded to the same 9-column label width Vite uses ("Local:   " /
+      // "Network: " are both 9 characters before the URL).
+      server.config.logger.info(
+        `  ${green('➜')}  ${bold('MCP')}:     ${colorUrl(url)}`,
+      )
+    }
+  }
+
+  return {
+    name: 'print-mcp-url',
+    configureServer: withMcpUrl,
+    configurePreviewServer: withMcpUrl,
+  }
+}
+
 const config = defineConfig({
   resolve: { tsconfigPaths: true },
-  plugins: [tanstackStart(), viteReact()],
+  plugins: [tanstackStart(), viteReact(), printMcpUrl()],
 })
 
 export default config