@agimon-ai/po-style-system-tooling 0.2.14-alpha.20 → 0.2.14-alpha.22

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_stdio = require("./stdio-7W52L7gp.cjs");
+const require_stdio = require("./stdio-CHZgcxF1.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_stdio.__toESM(node_path, 1);

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { A as resolveStyleSystemThemePath, B as STYLE_SYSTEM_TYPES, F as TailwindCSSClassesService, P as DEFAULT_STYLE_SYSTEM_CONFIG, a as STYLE_SYSTEM_CLI_NAME, i as createServer$1, o as STYLE_SYSTEM_VERSION, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler, w as getAppDesignSystemConfig, y as getBundlerServiceFromConfig, z as log } from "./stdio-Cs3GzGK4.mjs";
+import { A as resolveStyleSystemThemePath, B as STYLE_SYSTEM_TYPES, F as TailwindCSSClassesService, P as DEFAULT_STYLE_SYSTEM_CONFIG, a as STYLE_SYSTEM_CLI_NAME, i as createServer$1, o as STYLE_SYSTEM_VERSION, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler, w as getAppDesignSystemConfig, y as getBundlerServiceFromConfig, z as log } from "./stdio-CooVeKmH.mjs";
 import { promises } from "node:fs";
 import path, { join } from "node:path";
 import { z } from "zod";

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-7W52L7gp.cjs");
+const require_stdio = require("./stdio-CHZgcxF1.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_stdio.__toESM(node_path, 1);
@@ -87,6 +87,100 @@ var StoryPreviewService = class {
 	}
 };
 //#endregion
+//#region src/utils/storyBrowser.ts
+const BROWSER_IDLE_MS = 18e5;
+/** Server-owned Chrome. Each capture borrows it until its context cleanup settles. */
+function createStoryBrowser() {
+	let pending;
+	let closing;
+	let timer;
+	let active = 0;
+	let disposed = false;
+	let drained = Promise.resolve();
+	let resolveDrained;
+	const clearIdle = () => {
+		clearTimeout(timer);
+		timer = void 0;
+	};
+	const close = () => {
+		if (closing) return closing;
+		const generation = pending;
+		if (!generation) return Promise.resolve();
+		closing = generation.then((browser) => browser.close()).then(() => {
+			if (pending === generation) pending = void 0;
+		}).finally(() => {
+			closing = void 0;
+		});
+		return closing;
+	};
+	const idle = () => {
+		if (disposed || active !== 0 || !pending) return;
+		clearIdle();
+		const generation = pending;
+		timer = setTimeout(() => {
+			timer = void 0;
+			if (active !== 0 || pending !== generation) return;
+			close().catch((error) => {
+				require_stdio.log.error("[story-browser] Idle close failed:", error);
+				idle();
+			});
+		}, BROWSER_IDLE_MS);
+		timer.unref();
+	};
+	return {
+		async acquire() {
+			if (disposed) throw new Error("The story browser is shut down.");
+			clearIdle();
+			if (active++ === 0) drained = new Promise((resolve) => {
+				resolveDrained = resolve;
+			});
+			let released = false;
+			const release = () => {
+				if (released) return;
+				released = true;
+				if (--active === 0) {
+					resolveDrained?.();
+					idle();
+				}
+			};
+			try {
+				if (closing) await closing;
+				if (disposed) throw new Error("The story browser is shut down.");
+				if (!pending) {
+					const generation = require_stdio.launchBrowserWithFallback().then((browser) => {
+						browser.once("disconnected", () => {
+							if (pending === generation) {
+								pending = void 0;
+								clearIdle();
+							}
+						});
+						return browser;
+					}).catch((error) => {
+						if (pending === generation) pending = void 0;
+						throw error;
+					});
+					pending = generation;
+				}
+				const browser = await pending;
+				if (disposed) throw new Error("The story browser is shut down.");
+				return {
+					browser,
+					release
+				};
+			} catch (error) {
+				release();
+				throw error;
+			}
+		},
+		async dispose() {
+			disposed = true;
+			clearIdle();
+			await drained;
+			await close();
+		}
+	};
+}
+//#endregion
 //#region src/services/WarmStoryRenderer/WarmStoryRenderer.ts
 /** The style-system tools a warm host exposes, by tool name. */
 const WARM_RENDERER_TOOLS = {
@@ -115,7 +209,7 @@ function createWarmStoryRenderer(options = {}) {
 	const container = require_stdio.createContainer({
 		...options,
 		workspaceRoot,
-		sharedBrowser,
+		sharedBrowser: options.sharedBrowser ?? sharedBrowser,
 		bundlerFactory: () => {
 			if (!activeBundler) throw new Error("The story bundler has not been initialized.");
 			return activeBundler;
@@ -125,6 +219,7 @@ function createWarmStoryRenderer(options = {}) {
 	const createBundler = (config) => config.bundler ? require_stdio.getBundlerService(config.bundler, workspaceRoot) : require_stdio.createDefaultBundlerService(workspaceRoot);
 	let queue = Promise.resolve();
 	let disposed = false;
+	let captures = 0;
 	const ensureDevServer = async (appPath) => {
 		const resolved = node_path.default.resolve(workspaceRoot ?? ".", appPath);
 		const { config } = await configLoader.resolveProject(resolved);
@@ -142,13 +237,16 @@ function createWarmStoryRenderer(options = {}) {
 		const bundler = await pending;
 		if (activeBundler && activeBundler !== bundler && activeBundler.isServerRunning()) await activeBundler.cleanup();
 		activeBundler = bundler;
-		if (bundler.isServerRunning() && bundler.getCurrentAppPath() === resolved) return;
+		const recycle = bundler.getBundlerId() === "vite" && captures >= 100;
+		if (bundler.isServerRunning() && bundler.getCurrentAppPath() === resolved && !recycle) return;
 		if (bundler.isServerRunning()) await bundler.cleanup();
+		captures = 0;
 		await bundler.startDevServer(resolved);
 	};
 	const reset = async () => {
 		const open = browser;
 		browser = void 0;
+		captures = 0;
 		await Promise.allSettled([open?.then((instance) => instance.close()), ...[...bundlers.values()].map((pending) => pending.then((bundler) => bundler.cleanup()))]);
 	};
 	const run = async (tool, input) => {
@@ -163,7 +261,10 @@ function createWarmStoryRenderer(options = {}) {
 		}
 		const visualAppPath = tool === "get_component_visual" && typeof input.appPath === "string" ? input.appPath : void 0;
 		const execute = async () => {
-			if (visualAppPath) await ensureDevServer(visualAppPath);
+			if (visualAppPath) {
+				await ensureDevServer(visualAppPath);
+				captures++;
+			}
 			const result = await container.get(WARM_RENDERER_TOOLS[tool]).execute(input);
 			return {
 				result,
@@ -278,6 +379,7 @@ exports.WARM_RENDERER_TOOLS = WARM_RENDERER_TOOLS;
 exports.createContainer = require_stdio.createContainer;
 exports.createDefaultBundlerService = require_stdio.createDefaultBundlerService;
 exports.createServer = require_stdio.createServer;
+exports.createStoryBrowser = createStoryBrowser;
 exports.createStyleSystemModule = require_stdio.createStyleSystemModule;
 exports.createWarmStoryRenderer = createWarmStoryRenderer;
 exports.extractCustomTokenNames = require_stdio.extractCustomTokenNames;

package/dist/index.d.cts

@@ -148,6 +148,35 @@ export declare function hasStyleSystemProjectConfig(appPath: string): Promise<bo
 /** Workspace-wide tags that identify shared/design system components. */
 export declare function getSharedComponentTags(): Promise<string[]>;
 //#endregion
+//#region src/utils/screenshot.d.ts
+interface BrowserLease {
+  browser: Browser;
+  release(): void;
+}
+interface ScreenshotOptions {
+  /** A borrowed browser; release runs only after this render's context cleanup settles. */
+  sharedBrowser?: () => Promise<Browser | BrowserLease>;
+  url: string;
+  output: string;
+  width?: number;
+  height?: number;
+  fullPage?: boolean;
+  browser?: 'chromium' | 'firefox' | 'webkit';
+  waitTime?: number;
+  darkMode?: boolean;
+  mobile?: boolean;
+  generateThumbnail?: boolean;
+  thumbnailWidth?: number;
+  thumbnailQuality?: number;
+  base64?: boolean;
+}
+/**
+ * Attempts to launch a browser, trying multiple configurations in order of preference.
+ * @returns Launched browser instance
+ * @throws Error if no browser can be launched
+ */
+export declare function launchBrowserWithFallback(): Promise<Browser>;
+//#endregion
 //#region src/services/BundlerService/types.d.ts
 /**
  * BundlerService Types
@@ -623,7 +652,7 @@ interface StyleSystemModuleOptions {
   bundlerFactory?: (config: DesignSystemConfig) => BaseBundlerService;
   temporaryDirectory?: string;
   /** A browser a long-lived host keeps warm across renders; one-shot CLI runs leave it unset. */
-  sharedBrowser?: () => Promise<Browser>;
+  sharedBrowser?: ScreenshotOptions['sharedBrowser'];
 }
 export declare function createStyleSystemModule(optionsInput?: StyleSystemModuleOptions): ContainerModule;
 //#endregion
@@ -926,7 +955,7 @@ export declare class ComponentRendererService {
     bundlerFactory?: BundlerFactory;
     workspaceRoot?: string;
     temporaryDirectory?: string;
-    sharedBrowser?: () => Promise<Browser>;
+    sharedBrowser?: ScreenshotOptions['sharedBrowser'];
   });
   /**
    * Get the bundler service instance.
@@ -2057,13 +2086,12 @@ export declare class StdioTransportHandler {
   stop(): Promise<void>;
 }
 //#endregion
-//#region src/utils/screenshot.d.ts
-/**
- * Attempts to launch a browser, trying multiple configurations in order of preference.
- * @returns Launched browser instance
- * @throws Error if no browser can be launched
- */
-export declare function launchBrowserWithFallback(): Promise<Browser>;
+//#region src/utils/storyBrowser.d.ts
+/** Server-owned Chrome. Each capture borrows it until its context cleanup settles. */
+export declare function createStoryBrowser(): {
+  acquire(): Promise<BrowserLease>;
+  dispose(): Promise<void>;
+};
 //#endregion
 //#region src/services/WarmStoryRenderer/WarmStoryRenderer.d.ts
 /** The style-system tools a warm host exposes, by tool name. */
@@ -2086,7 +2114,7 @@ interface WarmRendererResult {
 interface WarmStoryRenderer {
   /** Runs one tool. Calls are serialized: the dev server serves one app at a time. */
   call(tool: WarmRendererToolName, input: Record<string, unknown>): Promise<WarmRendererResult>;
-  /** Closes the browser and dev servers; the next render starts fresh ones. */
+  /** Closes owned resources; a borrowed server browser remains running. */
   restart(): Promise<void>;
   dispose(): Promise<void>;
 }
@@ -2097,6 +2125,7 @@ interface WarmStoryRenderer {
 export declare function createWarmStoryRenderer(options?: {
   workspaceRoot?: string;
   temporaryDirectory?: string;
+  sharedBrowser?: ScreenshotOptions['sharedBrowser'];
 }): WarmStoryRenderer;
 //#endregion
 export type { CSSClassCategory, CSSClassValue, CSSClassesResult, DesignSystemConfig, OxlintRestrictedClassPattern, OxlintRestrictedClassesConfig, ResolvedDesignSystemConfig, StoryPreviewIdentity, StoryPreviewInput, StoryPreviewResult, StoryPreviewServiceOptions, StyleSystemConfig, StyleSystemModuleOptions, Tool, ToolDefinition, WarmRendererResult, WarmRendererToolName, WarmStoryRenderer };

package/dist/index.d.mts

@@ -148,6 +148,35 @@ export declare function hasStyleSystemProjectConfig(appPath: string): Promise<bo
 /** Workspace-wide tags that identify shared/design system components. */
 export declare function getSharedComponentTags(): Promise<string[]>;
 //#endregion
+//#region src/utils/screenshot.d.ts
+interface BrowserLease {
+  browser: Browser;
+  release(): void;
+}
+interface ScreenshotOptions {
+  /** A borrowed browser; release runs only after this render's context cleanup settles. */
+  sharedBrowser?: () => Promise<Browser | BrowserLease>;
+  url: string;
+  output: string;
+  width?: number;
+  height?: number;
+  fullPage?: boolean;
+  browser?: 'chromium' | 'firefox' | 'webkit';
+  waitTime?: number;
+  darkMode?: boolean;
+  mobile?: boolean;
+  generateThumbnail?: boolean;
+  thumbnailWidth?: number;
+  thumbnailQuality?: number;
+  base64?: boolean;
+}
+/**
+ * Attempts to launch a browser, trying multiple configurations in order of preference.
+ * @returns Launched browser instance
+ * @throws Error if no browser can be launched
+ */
+export declare function launchBrowserWithFallback(): Promise<Browser>;
+//#endregion
 //#region src/services/BundlerService/types.d.ts
 /**
  * BundlerService Types
@@ -623,7 +652,7 @@ interface StyleSystemModuleOptions {
   bundlerFactory?: (config: DesignSystemConfig) => BaseBundlerService;
   temporaryDirectory?: string;
   /** A browser a long-lived host keeps warm across renders; one-shot CLI runs leave it unset. */
-  sharedBrowser?: () => Promise<Browser>;
+  sharedBrowser?: ScreenshotOptions['sharedBrowser'];
 }
 export declare function createStyleSystemModule(optionsInput?: StyleSystemModuleOptions): ContainerModule;
 //#endregion
@@ -926,7 +955,7 @@ export declare class ComponentRendererService {
     bundlerFactory?: BundlerFactory;
     workspaceRoot?: string;
     temporaryDirectory?: string;
-    sharedBrowser?: () => Promise<Browser>;
+    sharedBrowser?: ScreenshotOptions['sharedBrowser'];
   });
   /**
    * Get the bundler service instance.
@@ -2057,13 +2086,12 @@ export declare class StdioTransportHandler {
   stop(): Promise<void>;
 }
 //#endregion
-//#region src/utils/screenshot.d.ts
-/**
- * Attempts to launch a browser, trying multiple configurations in order of preference.
- * @returns Launched browser instance
- * @throws Error if no browser can be launched
- */
-export declare function launchBrowserWithFallback(): Promise<Browser>;
+//#region src/utils/storyBrowser.d.ts
+/** Server-owned Chrome. Each capture borrows it until its context cleanup settles. */
+export declare function createStoryBrowser(): {
+  acquire(): Promise<BrowserLease>;
+  dispose(): Promise<void>;
+};
 //#endregion
 //#region src/services/WarmStoryRenderer/WarmStoryRenderer.d.ts
 /** The style-system tools a warm host exposes, by tool name. */
@@ -2086,7 +2114,7 @@ interface WarmRendererResult {
 interface WarmStoryRenderer {
   /** Runs one tool. Calls are serialized: the dev server serves one app at a time. */
   call(tool: WarmRendererToolName, input: Record<string, unknown>): Promise<WarmRendererResult>;
-  /** Closes the browser and dev servers; the next render starts fresh ones. */
+  /** Closes owned resources; a borrowed server browser remains running. */
   restart(): Promise<void>;
   dispose(): Promise<void>;
 }
@@ -2097,6 +2125,7 @@ interface WarmStoryRenderer {
 export declare function createWarmStoryRenderer(options?: {
   workspaceRoot?: string;
   temporaryDirectory?: string;
+  sharedBrowser?: ScreenshotOptions['sharedBrowser'];
 }): WarmStoryRenderer;
 //#endregion
 export type { CSSClassCategory, CSSClassValue, CSSClassesResult, DesignSystemConfig, OxlintRestrictedClassPattern, OxlintRestrictedClassesConfig, ResolvedDesignSystemConfig, StoryPreviewIdentity, StoryPreviewInput, StoryPreviewResult, StoryPreviewServiceOptions, StyleSystemConfig, StyleSystemModuleOptions, Tool, ToolDefinition, WarmRendererResult, WarmRendererToolName, WarmStoryRenderer };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as resolveStyleSystemThemePath, B as STYLE_SYSTEM_TYPES, C as launchBrowserWithFallback, D as resetStyleSystemConfigCache, E as hasStyleSystemProjectConfig, F as TailwindCSSClassesService, I as BaseCSSClassesService, L as TemplatesManagerService, M as StoriesIndexService, N as CSSClassesServiceFactory, O as resolveAppDesignSystemConfig, P as DEFAULT_STYLE_SYSTEM_CONFIG, R as isContained, S as BaseBundlerService, T as getSharedComponentTags, _ as createDefaultBundlerService, b as ViteReactNativeBundlerService, c as createStyleSystemModule, d as GetComponentVisualTool, f as GetCSSClassesTool, g as ThemeService, h as ComponentRendererService, i as createServer, j as MAX_STYLE_SYSTEM_VIEWPORT_DIMENSION, k as StyleSystemConfigLoader, l as ListAppComponentsTool, m as GetUiComponentService, n as extractCustomTokenNames, p as ListThemesTool, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler, u as ListSharedComponentsTool, v as getBundlerService, w as getAppDesignSystemConfig, x as ViteReactBundlerService, y as getBundlerServiceFromConfig } from "./stdio-Cs3GzGK4.mjs";
+import { A as resolveStyleSystemThemePath, B as STYLE_SYSTEM_TYPES, C as launchBrowserWithFallback, D as resetStyleSystemConfigCache, E as hasStyleSystemProjectConfig, F as TailwindCSSClassesService, I as BaseCSSClassesService, L as TemplatesManagerService, M as StoriesIndexService, N as CSSClassesServiceFactory, O as resolveAppDesignSystemConfig, P as DEFAULT_STYLE_SYSTEM_CONFIG, R as isContained, S as BaseBundlerService, T as getSharedComponentTags, _ as createDefaultBundlerService, b as ViteReactNativeBundlerService, c as createStyleSystemModule, d as GetComponentVisualTool, f as GetCSSClassesTool, g as ThemeService, h as ComponentRendererService, i as createServer, j as MAX_STYLE_SYSTEM_VIEWPORT_DIMENSION, k as StyleSystemConfigLoader, l as ListAppComponentsTool, m as GetUiComponentService, n as extractCustomTokenNames, p as ListThemesTool, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler, u as ListSharedComponentsTool, v as getBundlerService, w as getAppDesignSystemConfig, x as ViteReactBundlerService, y as getBundlerServiceFromConfig, z as log } from "./stdio-CooVeKmH.mjs";
 import { promises } from "node:fs";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -85,6 +85,100 @@ var StoryPreviewService = class {
 	}
 };
 //#endregion
+//#region src/utils/storyBrowser.ts
+const BROWSER_IDLE_MS = 18e5;
+/** Server-owned Chrome. Each capture borrows it until its context cleanup settles. */
+function createStoryBrowser() {
+	let pending;
+	let closing;
+	let timer;
+	let active = 0;
+	let disposed = false;
+	let drained = Promise.resolve();
+	let resolveDrained;
+	const clearIdle = () => {
+		clearTimeout(timer);
+		timer = void 0;
+	};
+	const close = () => {
+		if (closing) return closing;
+		const generation = pending;
+		if (!generation) return Promise.resolve();
+		closing = generation.then((browser) => browser.close()).then(() => {
+			if (pending === generation) pending = void 0;
+		}).finally(() => {
+			closing = void 0;
+		});
+		return closing;
+	};
+	const idle = () => {
+		if (disposed || active !== 0 || !pending) return;
+		clearIdle();
+		const generation = pending;
+		timer = setTimeout(() => {
+			timer = void 0;
+			if (active !== 0 || pending !== generation) return;
+			close().catch((error) => {
+				log.error("[story-browser] Idle close failed:", error);
+				idle();
+			});
+		}, BROWSER_IDLE_MS);
+		timer.unref();
+	};
+	return {
+		async acquire() {
+			if (disposed) throw new Error("The story browser is shut down.");
+			clearIdle();
+			if (active++ === 0) drained = new Promise((resolve) => {
+				resolveDrained = resolve;
+			});
+			let released = false;
+			const release = () => {
+				if (released) return;
+				released = true;
+				if (--active === 0) {
+					resolveDrained?.();
+					idle();
+				}
+			};
+			try {
+				if (closing) await closing;
+				if (disposed) throw new Error("The story browser is shut down.");
+				if (!pending) {
+					const generation = launchBrowserWithFallback().then((browser) => {
+						browser.once("disconnected", () => {
+							if (pending === generation) {
+								pending = void 0;
+								clearIdle();
+							}
+						});
+						return browser;
+					}).catch((error) => {
+						if (pending === generation) pending = void 0;
+						throw error;
+					});
+					pending = generation;
+				}
+				const browser = await pending;
+				if (disposed) throw new Error("The story browser is shut down.");
+				return {
+					browser,
+					release
+				};
+			} catch (error) {
+				release();
+				throw error;
+			}
+		},
+		async dispose() {
+			disposed = true;
+			clearIdle();
+			await drained;
+			await close();
+		}
+	};
+}
+//#endregion
 //#region src/services/WarmStoryRenderer/WarmStoryRenderer.ts
 /** The style-system tools a warm host exposes, by tool name. */
 const WARM_RENDERER_TOOLS = {
@@ -113,7 +207,7 @@ function createWarmStoryRenderer(options = {}) {
 	const container = createContainer({
 		...options,
 		workspaceRoot,
-		sharedBrowser,
+		sharedBrowser: options.sharedBrowser ?? sharedBrowser,
 		bundlerFactory: () => {
 			if (!activeBundler) throw new Error("The story bundler has not been initialized.");
 			return activeBundler;
@@ -123,6 +217,7 @@ function createWarmStoryRenderer(options = {}) {
 	const createBundler = (config) => config.bundler ? getBundlerService(config.bundler, workspaceRoot) : createDefaultBundlerService(workspaceRoot);
 	let queue = Promise.resolve();
 	let disposed = false;
+	let captures = 0;
 	const ensureDevServer = async (appPath) => {
 		const resolved = path.resolve(workspaceRoot ?? ".", appPath);
 		const { config } = await configLoader.resolveProject(resolved);
@@ -140,13 +235,16 @@ function createWarmStoryRenderer(options = {}) {
 		const bundler = await pending;
 		if (activeBundler && activeBundler !== bundler && activeBundler.isServerRunning()) await activeBundler.cleanup();
 		activeBundler = bundler;
-		if (bundler.isServerRunning() && bundler.getCurrentAppPath() === resolved) return;
+		const recycle = bundler.getBundlerId() === "vite" && captures >= 100;
+		if (bundler.isServerRunning() && bundler.getCurrentAppPath() === resolved && !recycle) return;
 		if (bundler.isServerRunning()) await bundler.cleanup();
+		captures = 0;
 		await bundler.startDevServer(resolved);
 	};
 	const reset = async () => {
 		const open = browser;
 		browser = void 0;
+		captures = 0;
 		await Promise.allSettled([open?.then((instance) => instance.close()), ...[...bundlers.values()].map((pending) => pending.then((bundler) => bundler.cleanup()))]);
 	};
 	const run = async (tool, input) => {
@@ -161,7 +259,10 @@ function createWarmStoryRenderer(options = {}) {
 		}
 		const visualAppPath = tool === "get_component_visual" && typeof input.appPath === "string" ? input.appPath : void 0;
 		const execute = async () => {
-			if (visualAppPath) await ensureDevServer(visualAppPath);
+			if (visualAppPath) {
+				await ensureDevServer(visualAppPath);
+				captures++;
+			}
 			const result = await container.get(WARM_RENDERER_TOOLS[tool]).execute(input);
 			return {
 				result,
@@ -206,4 +307,4 @@ function createWarmStoryRenderer(options = {}) {
 	};
 }
 //#endregion
-export { BaseBundlerService, BaseCSSClassesService, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, MAX_STYLE_SYSTEM_VIEWPORT_DIMENSION, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, StoryPreviewService, StyleSystemConfigLoader, TailwindCSSClassesService, ThemeService, ViteReactBundlerService, ViteReactNativeBundlerService, WARM_RENDERER_TOOLS, createContainer, createDefaultBundlerService, createServer, createStyleSystemModule, createWarmStoryRenderer, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerService, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, launchBrowserWithFallback, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath };
+export { BaseBundlerService, BaseCSSClassesService, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, MAX_STYLE_SYSTEM_VIEWPORT_DIMENSION, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, StoryPreviewService, StyleSystemConfigLoader, TailwindCSSClassesService, ThemeService, ViteReactBundlerService, ViteReactNativeBundlerService, WARM_RENDERER_TOOLS, createContainer, createDefaultBundlerService, createServer, createStoryBrowser, createStyleSystemModule, createWarmStoryRenderer, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerService, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, launchBrowserWithFallback, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath };

package/dist/{stdio-7W52L7gp.cjs → stdio-CHZgcxF1.cjs}

@@ -1665,9 +1665,15 @@ async function takeScreenshot(options) {
 	const { url, output, width = 1280, height = 800, fullPage = false, browser: browserName = "chromium", waitTime = 1e3, darkMode = false, mobile = false, generateThumbnail = false, thumbnailWidth = 400, thumbnailQuality = 80, base64 = false, sharedBrowser } = options;
 	let browser = null;
 	let context = null;
+	let release;
 	try {
-		if (sharedBrowser) browser = await sharedBrowser();
-		else if (browserName === "chromium") browser = await launchBrowserWithFallback();
+		if (sharedBrowser) {
+			const borrowed = await sharedBrowser();
+			if ("browser" in borrowed) {
+				browser = borrowed.browser;
+				release = () => borrowed.release();
+			} else browser = borrowed;
+		} else if (browserName === "chromium") browser = await launchBrowserWithFallback();
 		else {
 			const browserType = browsers[browserName];
 			if (!browserType) throw new Error(`Unsupported browser: ${browserName}`);
@@ -1735,8 +1741,12 @@ async function takeScreenshot(options) {
 		if (base64) result.base64 = screenshotBuffer.toString("base64");
 		return result;
 	} finally {
-		if (sharedBrowser) await context?.close();
-		else if (browser) await browser.close();
+		try {
+			if (sharedBrowser) await context?.close();
+			else if (browser) await browser.close();
+		} finally {
+			release?.();
+		}
 	}
 }
 //#endregion
@@ -4748,7 +4758,7 @@ function createContainer(options) {
 }
 //#endregion
 //#region package.json
-var version = "0.2.14-alpha.20";
+var version = "0.2.14-alpha.22";
 //#endregion
 //#region src/metadata.ts
 const STYLE_SYSTEM_CLI_NAME = "style-system";

package/dist/{stdio-Cs3GzGK4.mjs → stdio-CooVeKmH.mjs}

@@ -1640,9 +1640,15 @@ async function takeScreenshot(options) {
 	const { url, output, width = 1280, height = 800, fullPage = false, browser: browserName = "chromium", waitTime = 1e3, darkMode = false, mobile = false, generateThumbnail = false, thumbnailWidth = 400, thumbnailQuality = 80, base64 = false, sharedBrowser } = options;
 	let browser = null;
 	let context = null;
+	let release;
 	try {
-		if (sharedBrowser) browser = await sharedBrowser();
-		else if (browserName === "chromium") browser = await launchBrowserWithFallback();
+		if (sharedBrowser) {
+			const borrowed = await sharedBrowser();
+			if ("browser" in borrowed) {
+				browser = borrowed.browser;
+				release = () => borrowed.release();
+			} else browser = borrowed;
+		} else if (browserName === "chromium") browser = await launchBrowserWithFallback();
 		else {
 			const browserType = browsers[browserName];
 			if (!browserType) throw new Error(`Unsupported browser: ${browserName}`);
@@ -1710,8 +1716,12 @@ async function takeScreenshot(options) {
 		if (base64) result.base64 = screenshotBuffer.toString("base64");
 		return result;
 	} finally {
-		if (sharedBrowser) await context?.close();
-		else if (browser) await browser.close();
+		try {
+			if (sharedBrowser) await context?.close();
+			else if (browser) await browser.close();
+		} finally {
+			release?.();
+		}
 	}
 }
 //#endregion
@@ -4723,7 +4733,7 @@ function createContainer(options) {
 }
 //#endregion
 //#region package.json
-var version = "0.2.14-alpha.20";
+var version = "0.2.14-alpha.22";
 //#endregion
 //#region src/metadata.ts
 const STYLE_SYSTEM_CLI_NAME = "style-system";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/po-style-system-tooling",
-  "version": "0.2.14-alpha.20",
+  "version": "0.2.14-alpha.22",
   "description": "MCP server for exploring themes, Tailwind CSS classes, and UI components from Storybook with standalone component rendering capabilities",
   "keywords": [
     "design-system",