pulumi-package-docs 0.8.0 → 0.9.0

package/dist/server/assets/{schema.server-B-VvU1qb.js → providers.server-B1ZHZ5jE.js}

@@ -119,4 +119,51 @@ async function resolveProviderSchema(projectRoot, ref) {
 	}
 }
 //#endregion
-export { getTargetDir as n, loadPulumiProject as r, resolveProviderSchema as t };
+//#region src/lib/pulumi/providers.server.ts
+/**
+* The project + provider summaries shown on the index route and by the MCP
+* `list_providers` tool. Plain async functions (no TanStack Start server-fn
+* wrapper) so they can run either inside the web server or in the stdio MCP
+* process, which has no HTTP server at all.
+*/
+async function loadProjectSummary() {
+	const targetDir = getTargetDir();
+	const project = loadPulumiProject(targetDir);
+	if (!project) return {
+		targetDir,
+		project: null,
+		providers: []
+	};
+	const providers = (await Promise.all(project.packages.map((ref) => resolveProviderSchema(project.root, ref)))).map((entry) => ({
+		name: entry.ref.name,
+		source: entry.ref.source,
+		version: entry.ref.version,
+		parameters: entry.ref.parameters,
+		resourceCount: Object.keys(entry.schema?.resources ?? {}).length,
+		functionCount: Object.keys(entry.schema?.functions ?? {}).length,
+		origin: entry.origin,
+		error: entry.error
+	}));
+	return {
+		targetDir,
+		project: {
+			root: project.root,
+			name: project.name,
+			runtime: project.runtime
+		},
+		providers
+	};
+}
+/** The fully resolved schema for one local provider, or null if the project or provider isn't found. */
+async function loadProviderDetail(name) {
+	const project = loadPulumiProject(getTargetDir());
+	if (!project) return null;
+	const ref = project.packages.find((p) => p.name === name);
+	if (!ref) return null;
+	return {
+		...await resolveProviderSchema(project.root, ref),
+		runtime: project.runtime
+	};
+}
+//#endregion
+export { loadPulumiProject as a, getTargetDir as i, loadProviderDetail as n, resolveProviderSchema as r, loadProjectSummary as t };

package/dist/server/assets/{router-1INob9fh.js → router-_zs8P-B2.js}

@@ -1,5 +1,6 @@
-import { n as getTargetDir, r as loadPulumiProject, t as resolveProviderSchema } from "./schema.server-B-VvU1qb.js";
+import { a as loadPulumiProject, i as getTargetDir, n as loadProviderDetail, r as resolveProviderSchema, t as loadProjectSummary } from "./providers.server-B1ZHZ5jE.js";
 import { n as listProviders, t as getProvider } from "./api-BV6lykkP.js";
+import { a as pickExample, c as resolveDescription, i as extractExamples, n as tokenDisplayName, o as stripExamples, s as summarizeDescription, t as findTokenBySlug } from "./token-DBEFeZIN.js";
 import { useEffect, useState } from "react";
 import { HeadContent, Link, Scripts, createFileRoute, createRootRoute, createRouter, lazyRouteComponent, notFound } from "@tanstack/react-router";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -328,71 +329,12 @@ function RootDocument({ children }) {
 }
 //#endregion
 //#region src/routes/index.tsx
-var $$splitComponentImporter$4 = () => import("./routes-4jiXnS1p.js");
+var $$splitComponentImporter$4 = () => import("./routes-BUxagg9r.js");
 var Route$5 = createFileRoute("/")({
 	loader: () => listProviders(),
 	component: lazyRouteComponent($$splitComponentImporter$4, "component")
 });
 //#endregion
-//#region src/lib/pulumi/description.ts
-/**
-* Pulumi schema descriptions embed per-language text as HTML-ish spans, e.g.
-* `<span pulumi-lang-nodejs="`length`" pulumi-lang-python="`length`" ...>`length`</span>`.
-* pulumi.com's docs site picks an attribute based on the selected language tab;
-* we don't have tabs, so we resolve each span to the project's own runtime up
-* front and strip the markup rather than rendering (or leaking) raw HTML.
-*/
-var LANG_SPAN_RE = /<span\s+((?:pulumi-lang-[a-z]+="[^"]*"\s*)+)>([\s\S]*?)<\/span>/g;
-var LANG_ATTR_RE = /pulumi-lang-([a-z]+)="([^"]*)"/g;
-function resolveLangSpans(text, runtime) {
-	return text.replace(LANG_SPAN_RE, (_match, attrsSource, fallback) => {
-		if (!runtime) return fallback;
-		LANG_ATTR_RE.lastIndex = 0;
-		let match;
-		while (match = LANG_ATTR_RE.exec(attrsSource)) if (match[1] === runtime) return match[2];
-		return fallback;
-	});
-}
-/** Resolves a schema description's per-language spans for the given Pulumi runtime. */
-function resolveDescription(text, runtime) {
-	if (!text) return text;
-	return resolveLangSpans(text, runtime);
-}
-//#endregion
-//#region src/lib/pulumi/examples.ts
-var CODE_FENCE_RE = /```([a-zA-Z0-9+#-]+)\n([\s\S]*?)```/g;
-function extractExamples(text) {
-	if (!text) return [];
-	return [...text.matchAll(CODE_FENCE_RE)].map((match) => ({
-		language: match[1].toLowerCase(),
-		code: match[2].trimEnd()
-	}));
-}
-/** The description text with any fenced code examples removed. */
-function stripExamples(text) {
-	if (!text) return text;
-	return text.replace(CODE_FENCE_RE, "").trim() || void 0;
-}
-/** A short summary for list views: the first prose paragraph, examples excluded. */
-function summarizeDescription(text) {
-	const stripped = stripExamples(text);
-	if (!stripped) return void 0;
-	return stripped.split(/\n{2,}/)[0]?.trim() || void 0;
-}
-var RUNTIME_LANGUAGES = {
-	nodejs: ["typescript", "javascript"],
-	python: ["python"],
-	go: ["go", "golang"],
-	dotnet: ["csharp"],
-	java: ["java"],
-	yaml: ["yaml"]
-};
-/** Picks the example matching the project's runtime, falling back to the first available one. */
-function pickExample(examples, runtime) {
-	const languages = runtime ? RUNTIME_LANGUAGES[runtime] : void 0;
-	return (languages ? examples.find((example) => languages.includes(example.language)) : void 0) ?? examples[0];
-}
-//#endregion
 //#region src/lib/pulumi/format.ts
 function formatType(prop) {
 	if (!prop) return "any";
@@ -428,18 +370,6 @@ function formatPropertyName(name, runtime) {
 	}
 }
 //#endregion
-//#region src/lib/pulumi/token.ts
-/**
-* Schema tokens look like `random:index/randomString:RandomString` (resources)
-* or `random:index/randomInteger:randomInteger` (functions). The segment after
-* the last colon is the name every generated SDK exports for that member, and
-* is unique within the provider, so it makes a readable display name.
-*/
-function tokenDisplayName(token) {
-	const short = token.split(":").pop();
-	return short && short.length > 0 ? short : token;
-}
-//#endregion
 //#region src/lib/pulumi/mcp.server.ts
 function textResult(data) {
 	return { content: [{
@@ -449,7 +379,7 @@ function textResult(data) {
 }
 /** Loads a local provider's resolved schema, throwing a descriptive error a tool call can surface to the client. */
 async function requireProvider(providerName) {
-	const detail = await getProvider({ data: providerName });
+	const detail = await loadProviderDetail(providerName);
 	if (!detail) throw new Error(`No local provider named "${providerName}" was found. Call list_providers to see the providers declared in this project's Pulumi.yaml.`);
 	if (!detail.schema) throw new Error(`Failed to load the schema for provider "${providerName}": ${detail.error ?? "unknown error"}`);
 	return {
@@ -489,8 +419,10 @@ function memberDetail(provider, token, description, runtime, inputs, outputs, de
 	};
 }
 /**
-* Builds a fresh MCP server with the local-provider-docs tools registered. Called once
-* per HTTP request (see `src/routes/mcp.ts`) so concurrent requests never share state.
+* Builds a fresh MCP server with the local-provider-docs tools registered. Transport
+* agnostic: `src/routes/mcp.ts` calls it once per HTTP request (so concurrent requests
+* never share state), and `src/lib/pulumi/stdio.server.ts` calls it once for the
+* lifetime of a stdio process.
 */
 function createMcpServer() {
 	const server = new McpServer({
@@ -500,7 +432,7 @@ function createMcpServer() {
 	server.registerTool("list_providers", {
 		title: "List local providers",
 		description: "List the local/parameterized Pulumi providers declared in this project's Pulumi.yaml (added with `pulumi package add`), with their source, version, and resource/function counts."
-	}, async () => textResult(await listProviders()));
+	}, async () => textResult(await loadProjectSummary()));
 	server.registerTool("list_resources", {
 		title: "List a provider’s resources",
 		description: "List the resource tokens for a local provider, each with a display name, a one-line summary, and whether it is deprecated. Use get_resource for full details (inputs/outputs/example) on one of them.",
@@ -622,7 +554,7 @@ var Route$3 = createFileRoute("/providers/$name")({ component: lazyRouteComponen
 //#endregion
 //#region src/routes/providers.$name.index.tsx
 var $$splitNotFoundComponentImporter$2 = () => import("./providers._name.index-BEwt-7U0.js");
-var $$splitComponentImporter$2 = () => import("./providers._name.index-CEXkl-76.js");
+var $$splitComponentImporter$2 = () => import("./providers._name.index-DBkfEjsy.js");
 var Route$2 = createFileRoute("/providers/$name/")({
 	loader: async ({ params }) => {
 		const entry = await getProvider({ data: params.name });
@@ -635,15 +567,17 @@ var Route$2 = createFileRoute("/providers/$name/")({
 //#endregion
 //#region src/routes/providers.$name.functions.$token.tsx
 var $$splitNotFoundComponentImporter$1 = () => import("./providers._name.functions._token-D8LsoIum.js");
-var $$splitComponentImporter$1 = () => import("./providers._name.functions._token-Gkw4zt3M.js");
+var $$splitComponentImporter$1 = () => import("./providers._name.functions._token-BvkwmQ-L.js");
 var Route$1 = createFileRoute("/providers/$name/functions/$token")({
 	loader: async ({ params }) => {
 		const entry = await getProvider({ data: params.name });
-		const fn = entry?.schema?.functions?.[params.token];
-		if (!fn) throw notFound();
+		const functions = entry?.schema?.functions;
+		const token = functions && findTokenBySlug(Object.keys(functions), params.token);
+		const fn = token ? functions[token] : void 0;
+		if (!token || !fn) throw notFound();
 		return {
 			providerName: params.name,
-			token: params.token,
+			token,
 			fn,
 			runtime: entry?.runtime
 		};
@@ -654,15 +588,17 @@ var Route$1 = createFileRoute("/providers/$name/functions/$token")({
 //#endregion
 //#region src/routes/providers.$name.resources.$token.tsx
 var $$splitNotFoundComponentImporter = () => import("./providers._name.resources._token-DJPF8nMg.js");
-var $$splitComponentImporter = () => import("./providers._name.resources._token-R_i2MmRl.js");
+var $$splitComponentImporter = () => import("./providers._name.resources._token-Sl31Qlvd.js");
 var Route = createFileRoute("/providers/$name/resources/$token")({
 	loader: async ({ params }) => {
 		const entry = await getProvider({ data: params.name });
-		const resource = entry?.schema?.resources?.[params.token];
-		if (!resource) throw notFound();
+		const resources = entry?.schema?.resources;
+		const token = resources && findTokenBySlug(Object.keys(resources), params.token);
+		const resource = token ? resources[token] : void 0;
+		if (!token || !resource) throw notFound();
 		return {
 			providerName: params.name,
-			token: params.token,
+			token,
 			resource,
 			runtime: entry?.runtime
 		};
@@ -716,10 +652,11 @@ var router_exports = /* @__PURE__ */ __exportAll({ getRouter: () => getRouter })
 function getRouter() {
 	return createRouter({
 		routeTree,
+		basepath: "/",
 		scrollRestoration: true,
 		defaultPreload: "intent",
 		defaultPreloadStaleTime: 0
 	});
 }
 //#endregion
-export { tokenDisplayName as a, extractExamples as c, summarizeDescription as d, resolveDescription as f, getRouter, Route$2 as i, pickExample as l, Route as n, formatPropertyName as o, Route$5 as p, Route$1 as r, formatType as s, router_exports as t, stripExamples as u };
+export { formatPropertyName as a, getRouter, Route$2 as i, Route as n, formatType as o, Route$1 as r, Route$5 as s, router_exports as t };

package/dist/server/assets/{routes-4jiXnS1p.js → routes-BUxagg9r.js}

@@ -1,4 +1,4 @@
-import { p as Route } from "./router-1INob9fh.js";
+import { s as Route } from "./router-_zs8P-B2.js";
 import { Link } from "@tanstack/react-router";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/routes/index.tsx?tsr-split=component

package/dist/server/assets/token-DBEFeZIN.js

@@ -0,0 +1,92 @@
+//#region src/lib/pulumi/description.ts
+/**
+* Pulumi schema descriptions embed per-language text as HTML-ish spans, e.g.
+* `<span pulumi-lang-nodejs="`length`" pulumi-lang-python="`length`" ...>`length`</span>`.
+* pulumi.com's docs site picks an attribute based on the selected language tab;
+* we don't have tabs, so we resolve each span to the project's own runtime up
+* front and strip the markup rather than rendering (or leaking) raw HTML.
+*/
+var LANG_SPAN_RE = /<span\s+((?:pulumi-lang-[a-z]+="[^"]*"\s*)+)>([\s\S]*?)<\/span>/g;
+var LANG_ATTR_RE = /pulumi-lang-([a-z]+)="([^"]*)"/g;
+function resolveLangSpans(text, runtime) {
+	return text.replace(LANG_SPAN_RE, (_match, attrsSource, fallback) => {
+		if (!runtime) return fallback;
+		LANG_ATTR_RE.lastIndex = 0;
+		let match;
+		while (match = LANG_ATTR_RE.exec(attrsSource)) if (match[1] === runtime) return match[2];
+		return fallback;
+	});
+}
+/** Resolves a schema description's per-language spans for the given Pulumi runtime. */
+function resolveDescription(text, runtime) {
+	if (!text) return text;
+	return resolveLangSpans(text, runtime);
+}
+//#endregion
+//#region src/lib/pulumi/examples.ts
+var CODE_FENCE_RE = /```([a-zA-Z0-9+#-]+)\n([\s\S]*?)```/g;
+function extractExamples(text) {
+	if (!text) return [];
+	return [...text.matchAll(CODE_FENCE_RE)].map((match) => ({
+		language: match[1].toLowerCase(),
+		code: match[2].trimEnd()
+	}));
+}
+/** The description text with any fenced code examples removed. */
+function stripExamples(text) {
+	if (!text) return text;
+	return text.replace(CODE_FENCE_RE, "").trim() || void 0;
+}
+/** A short summary for list views: the first prose paragraph, examples excluded. */
+function summarizeDescription(text) {
+	const stripped = stripExamples(text);
+	if (!stripped) return void 0;
+	return stripped.split(/\n{2,}/)[0]?.trim() || void 0;
+}
+var RUNTIME_LANGUAGES = {
+	nodejs: ["typescript", "javascript"],
+	python: ["python"],
+	go: ["go", "golang"],
+	dotnet: ["csharp"],
+	java: ["java"],
+	yaml: ["yaml"]
+};
+/** Picks the example matching the project's runtime, falling back to the first available one. */
+function pickExample(examples, runtime) {
+	const languages = runtime ? RUNTIME_LANGUAGES[runtime] : void 0;
+	return (languages ? examples.find((example) => languages.includes(example.language)) : void 0) ?? examples[0];
+}
+//#endregion
+//#region src/lib/pulumi/token.ts
+/**
+* Schema tokens look like `random:index/randomString:RandomString` (resources)
+* or `random:index/randomInteger:randomInteger` (functions). The segment after
+* the last colon is the name every generated SDK exports for that member, and
+* is unique within the provider, so it makes a readable display name.
+*/
+function tokenDisplayName(token) {
+	const short = token.split(":").pop();
+	return short && short.length > 0 ? short : token;
+}
+/**
+* A URL- and filesystem-safe form of a token, used as the `$token` route param.
+*
+* Tokens contain `:` and `/`, which only survive a URL as percent-escapes —
+* and static hosts (GitHub/GitLab Pages) decode those before matching a file,
+* so `random%3Aindex%2FrandomString%3ARandomString` would never resolve to the
+* page generated for it. Replacing the separators keeps one URL shape that
+* works both when served dynamically and as prerendered files on disk.
+*/
+function tokenSlug(token) {
+	return token.replace(/[^a-zA-Z0-9._~-]+/g, "-");
+}
+/**
+* Resolves a `$token` route param back to the schema token it names. Accepts
+* either a slug (what links produce) or the raw token, so a URL pasted from
+* schema output still works.
+*/
+function findTokenBySlug(tokens, slug) {
+	for (const token of tokens) if (token === slug || tokenSlug(token) === slug) return token;
+}
+//#endregion
+export { pickExample as a, resolveDescription as c, extractExamples as i, tokenDisplayName as n, stripExamples as o, tokenSlug as r, summarizeDescription as s, findTokenBySlug as t };

package/dist/server/server.js

@@ -91,7 +91,7 @@ var HEADERS = { TSS_SHELL: "X-TSS_SHELL" };
 * the dev styles URL for route-scoped CSS collection.
 */
 async function getStartManifest(matchedRoutes) {
-	const { tsrStartManifest } = await import("./assets/_tanstack-start-manifest_v-B0J-S-em.js");
+	const { tsrStartManifest } = await import("./assets/_tanstack-start-manifest_v-DNIp6gp3.js");
 	const startManifest = tsrStartManifest();
 	let routes = startManifest.routes;
 	routes[rootRouteId];
@@ -115,11 +115,11 @@ async function getStartManifest(matchedRoutes) {
 var manifest = {
 	"20c32dac0b2237041a59da458130ed4f320ce92dddd59a28b88581987c58d61d": {
 		functionName: "getProvider_createServerFn_handler",
-		importer: () => import("./assets/api-C55bS4R6.js")
+		importer: () => import("./assets/api-D49ZDhMh.js")
 	},
 	"a3ba03544bae9a67523c84875835e6e9b6dfa1b22a99b2c4c57d7ae25dbf7350": {
 		functionName: "listProviders_createServerFn_handler",
-		importer: () => import("./assets/api-C55bS4R6.js")
+		importer: () => import("./assets/api-D49ZDhMh.js")
 	}
 };
 async function getServerFnById(id, access) {
@@ -1547,7 +1547,7 @@ var getBaseManifest = getProdBaseManifest;
 var createEarlyHintsForRequest = createEarlyHintsCollector;
 async function loadEntries() {
 	const [routerEntry, startEntry, pluginAdapters] = await Promise.all([
-		import("./assets/router-1INob9fh.js").then((n) => n.t),
+		import("./assets/router-_zs8P-B2.js").then((n) => n.t),
 		import("./assets/start-5Z2QO8AU.js"),
 		import("./assets/empty-plugin-adapters-D9UWiqvJ.js")
 	]);

package/examples/github-pages.yml

@@ -0,0 +1,56 @@
+# Publishes the local provider docs for this Pulumi project to GitHub Pages.
+# Copy to .github/workflows/docs.yml in your Pulumi project's repo, then enable
+# Pages for the repo with "Source: GitHub Actions" (Settings -> Pages).
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# One deployment at a time; don't cancel one that's already publishing.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 24
+
+      # Puts the `pulumi` CLI on PATH; the docs are generated from the schemas
+      # it fetches for each package in Pulumi.yaml.
+      - uses: pulumi/actions@v7
+
+      # A project site is served from https://<owner>.github.io/<repo>/, so the
+      # site is built for that path. For a user/org site (<owner>.github.io),
+      # drop --base.
+      - name: Generate docs
+        run: npx -y pulumi-package-docs static --out ./site --base "/${GITHUB_REPOSITORY#*/}/"
+
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: ./site
+          # The generated site includes a `.nojekyll` file, and this action
+          # drops dotfiles unless asked not to.
+          include-hidden-files: true
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v5

package/examples/gitlab-ci.yml

@@ -0,0 +1,22 @@
+# Publishes the local provider docs for this Pulumi project to GitLab Pages.
+# Copy this job into your Pulumi project's .gitlab-ci.yml.
+pages:
+  image: node:24
+  stage: deploy
+  before_script:
+    # Puts the `pulumi` CLI on PATH; the docs are generated from the schemas
+    # it fetches for each package in Pulumi.yaml.
+    - curl -fsSL https://get.pulumi.com | sh
+    - export PATH="$PATH:$HOME/.pulumi/bin"
+  script:
+    # CI_PAGES_URL is where this site will be served from — its path is what
+    # the docs have to be built for ("/" with unique domains enabled, "/<project>/"
+    # otherwise).
+    - export DOCS_BASE="$(node -e 'console.log(new URL(process.env.CI_PAGES_URL).pathname)')"
+    - npx -y pulumi-package-docs static --out public --base "$DOCS_BASE"
+  artifacts:
+    paths:
+      # GitLab Pages publishes this directory, and only under this name.
+      - public
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pulumi-package-docs",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Local documentation viewer for the parameterized/local Pulumi providers used by a Pulumi project.",
   "type": "module",
   "license": "MIT",
@@ -18,6 +18,7 @@
   "files": [
     "bin",
     "dist",
+    "examples",
     "src",
     "tsconfig.json",
     "vite.config.ts"
@@ -28,11 +29,14 @@
   "scripts": {
     "dev": "vite dev --port 3000",
     "generate-routes": "tsr generate",
-    "build": "vite build",
+    "build": "vite build && npm run build:mcp",
+    "build:mcp": "vite build --config vite.mcp.config.ts",
     "preview": "vite preview",
     "start": "node bin/cli.js",
+    "static": "node bin/cli.js static",
     "compile:bun": "node bin/generate-embedded-assets.js && bun build ./bin/cli-bun.js --compile --outfile pulumi-package-docs",
     "test": "vitest run",
+    "test:stdio": "node scripts/smoke-test-stdio.js node bin/cli.js --stdio && node scripts/smoke-test-stdio.js ./pulumi-package-docs --stdio",
     "test:watch": "vitest",
     "lint": "oxlint",
     "format": "oxfmt . && oxlint --fix",

package/src/components/ThemeToggle.tsx

@@ -119,3 +119,40 @@ function MonitorIcon() {
     </IconSvg>
   )
 }
+
+// Wires the static build's theme switch up without hydration: one delegated
+// click listener, using the same `data-theme` + localStorage contract as
+// ThemeToggle above (and as the pre-hydration script in `__root.tsx`).
+const staticThemeScript = `(function(){var g=document.currentScript.previousElementSibling;if(!g)return;
+function apply(m){try{if(m==='system'){delete document.documentElement.dataset.theme;localStorage.removeItem('theme')}else{document.documentElement.dataset.theme=m;localStorage.setItem('theme',m)}}catch(e){if(m==='system'){delete document.documentElement.dataset.theme}else{document.documentElement.dataset.theme=m}}sync(m)}
+function sync(m){var b=g.querySelectorAll('button[data-theme-mode]');for(var i=0;i<b.length;i++){b[i].setAttribute('aria-pressed',String(b[i].getAttribute('data-theme-mode')===m))}}
+g.addEventListener('click',function(e){var b=e.target.closest('button[data-theme-mode]');if(b){apply(b.getAttribute('data-theme-mode'))}});
+var s=null;try{s=localStorage.getItem('theme')}catch(e){}
+sync(s==='light'||s==='dark'?s:'system')})()`
+
+/**
+ * The theme switch for the static build. Same markup as `ThemeToggle`, but
+ * driven by an inline script rather than React, since static pages ship
+ * without the hydration bundle.
+ */
+export function StaticThemeToggle() {
+  return (
+    <>
+      <div className="theme-switch" role="group" aria-label="Theme">
+        {OPTIONS.map(({ mode, label, Icon }) => (
+          <button
+            key={mode}
+            type="button"
+            className="theme-switch-option"
+            data-theme-mode={mode}
+            aria-pressed={mode === 'system'}
+            aria-label={label}
+          >
+            <Icon />
+          </button>
+        ))}
+      </div>
+      <script dangerouslySetInnerHTML={{ __html: staticThemeScript }} />
+    </>
+  )
+}

package/src/lib/pulumi/api.ts

@@ -1,77 +1,26 @@
 import { createServerFn } from '@tanstack/react-start'
 
-import { getTargetDir, loadPulumiProject } from '@/lib/pulumi/discovery.server'
-import { resolveProviderSchema } from '@/lib/pulumi/schema.server'
-import type { ProviderEntry, PulumiProject } from '@/lib/pulumi/types'
-
-export interface ProviderSummary {
-  name: string
-  source: string
-  version?: string
-  parameters?: string[]
-  resourceCount: number
-  functionCount: number
-  origin: ProviderEntry['origin']
-  error?: string
-}
-
-export interface ProjectSummary {
-  targetDir: string
-  project: Pick<PulumiProject, 'root' | 'name' | 'runtime'> | null
-  providers: ProviderSummary[]
-}
+import {
+  loadProjectSummary,
+  loadProviderDetail,
+} from '@/lib/pulumi/providers.server'
+import type {
+  ProjectSummary,
+  ProviderDetail,
+} from '@/lib/pulumi/providers.server'
+
+export type {
+  ProjectSummary,
+  ProviderDetail,
+  ProviderSummary,
+} from '@/lib/pulumi/providers.server'
 
 export const listProviders = createServerFn({ method: 'GET' }).handler(
-  async (): Promise<ProjectSummary> => {
-    const targetDir = getTargetDir()
-    const project = loadPulumiProject(targetDir)
-
-    if (!project) {
-      return { targetDir, project: null, providers: [] }
-    }
-
-    const entries = await Promise.all(
-      project.packages.map((ref) => resolveProviderSchema(project.root, ref)),
-    )
-
-    const providers: ProviderSummary[] = entries.map((entry) => ({
-      name: entry.ref.name,
-      source: entry.ref.source,
-      version: entry.ref.version,
-      parameters: entry.ref.parameters,
-      resourceCount: Object.keys(entry.schema?.resources ?? {}).length,
-      functionCount: Object.keys(entry.schema?.functions ?? {}).length,
-      origin: entry.origin,
-      error: entry.error,
-    }))
-
-    return {
-      targetDir,
-      project: {
-        root: project.root,
-        name: project.name,
-        runtime: project.runtime,
-      },
-      providers,
-    }
-  },
+  (): Promise<ProjectSummary> => loadProjectSummary(),
 )
 
-export interface ProviderDetail extends ProviderEntry {
-  /** The Pulumi project's runtime (e.g. "nodejs", "python", "go"), used to render Inputs/Outputs names in that language's casing. */
-  runtime?: string
-}
-
 export const getProvider = createServerFn({ method: 'GET' })
   .validator((name: string) => name)
-  .handler(async ({ data: name }): Promise<ProviderDetail | null> => {
-    const targetDir = getTargetDir()
-    const project = loadPulumiProject(targetDir)
-    if (!project) return null
-
-    const ref = project.packages.find((p) => p.name === name)
-    if (!ref) return null
-
-    const entry = await resolveProviderSchema(project.root, ref)
-    return { ...entry, runtime: project.runtime }
-  })
+  .handler(({ data: name }): Promise<ProviderDetail | null> =>
+    loadProviderDetail(name),
+  )