@agimon-ai/po-style-system-tooling 0.2.14-alpha.2 → 0.2.14-alpha.21

package/dist/index.d.cts

@@ -1,38 +1,19 @@
 import { Container, ContainerModule } from "inversify";
 import "zod";
-import { CallToolResult, Server } from "@modelcontextprotocol/server";
+import { Browser } from "playwright";
 import { AliasOptions, Plugin, UserConfig } from "vite";
-//#region src/container/module.d.ts
-interface StyleSystemModuleOptions {
-  defaultThemePath?: string;
-}
-export declare function createStyleSystemModule(optionsInput?: StyleSystemModuleOptions): ContainerModule;
-//#endregion
-//#region src/container/types.d.ts
-export declare const STYLE_SYSTEM_TYPES: {
-  readonly ListThemesTool: symbol;
-  readonly GetCSSClassesTool: symbol;
-  readonly GetComponentVisualTool: symbol;
-  readonly ListSharedComponentsTool: symbol;
-  readonly ListAppComponentsTool: symbol;
-  readonly PolishComponentTool: symbol;
-  readonly ThemeServiceFactory: symbol;
-  readonly CSSClassesServiceFactory: symbol;
-  readonly StoriesIndexService: symbol;
-  readonly GetUiComponentService: symbol;
-  readonly AppComponentsService: symbol;
-  readonly StoriesIndexFactory: symbol;
-  readonly RendererFactory: symbol;
-  readonly StyleSystemConfigLoader: symbol;
-  readonly DefaultThemePath: symbol;
-  readonly GetUiComponentServiceConfig: symbol;
-  readonly AppComponentsServiceConfig: symbol;
-};
-//#endregion
-//#region src/container/index.d.ts
-export declare function createContainer(options?: StyleSystemModuleOptions): Container;
-//#endregion
+import { CallToolResult, Server } from "@modelcontextprotocol/server";
 //#region src/config/types.d.ts
+/**
+ * Style system configuration types.
+ *
+ * Two shapes matter here:
+ * - `DesignSystemFields` is the RAW shape as written in a `style-system.config.yaml`.
+ *   Every field is optional, because any single file may only carry a fragment.
+ * - `DesignSystemConfig` is the RESOLVED shape handed to consumers after the
+ *   defaults -> preset chain -> project merge. `type` is guaranteed present.
+ */
+export declare const MAX_STYLE_SYSTEM_VIEWPORT_DIMENSION = 7680;
 declare const SUPPORTED_COLOR_SCHEMES: readonly ["light", "dark", "automatic"];
 type ColorSchemePreference = (typeof SUPPORTED_COLOR_SCHEMES)[number];
 interface StyleSystemViewport {
@@ -121,12 +102,14 @@ interface StyleSystemRootConfig {
 //#endregion
 //#region src/config/StyleSystemConfigLoader.d.ts
 export declare class StyleSystemConfigLoader {
+  readonly workspaceRoot?: string | undefined;
   /**
    * Promises rather than values, so concurrent resolves de-duplicate. Several
    * callers hit config from inside Promise.all/allSettled.
    */
   private readonly rootPromises;
   private readonly projectCache;
+  constructor(workspaceRoot?: string | undefined);
   /** Drop all cached config state. */
   invalidate(): void;
   /** Load and cache the workspace root config. */
@@ -150,6 +133,7 @@ export declare class StyleSystemConfigLoader {
 export declare function resolveStyleSystemThemePath(input: {
   appPath?: string | null;
   themePath: string;
+  workspaceRoot?: string;
 }): Promise<string>;
 //#endregion
 //#region src/config/index.d.ts
@@ -164,192 +148,34 @@ 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/server/index.d.ts
-export declare function createServer(containerOrThemePath?: Container | string): Server;
-//#endregion
-//#region src/services/StoriesIndexService/types.d.ts
-/**
- * StoriesIndexService Types
- *
- * Type definitions for the StoriesIndexService service.
- */
-/**
- * Story meta information from default export
- */
-interface StoryMeta {
-  /** Story title (e.g., "Components/Button") */
-  title: string;
-  /** Reference to the component */
-  component?: unknown;
-  /** Story tags for filtering */
-  tags?: string[];
-  /** Story parameters */
-  parameters?: Record<string, unknown>;
-  /** Arg type definitions */
-  argTypes?: Record<string, unknown>;
-}
-/**
- * Component information extracted from story files
- */
-interface ComponentInfo {
-  /** Full title from meta (e.g., "Components/Button") */
-  title: string;
-  /** Absolute path to story file */
-  filePath: string;
-  /** SHA256 hash of file content for cache invalidation */
-  fileHash: string;
-  /** Tags from story meta */
-  tags: string[];
-  /** Display names of exported stories */
-  stories: string[];
-  /** Exact named exports available in the story module */
-  storyExports: string[];
-  /** Full story meta object */
-  meta: StoryMeta;
-  /** Component description extracted from file header JSDoc or meta.parameters.docs.description */
-  description?: string;
+//#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;
 }
 /**
- * Configuration options for StoriesIndexService
+ * Attempts to launch a browser, trying multiple configurations in order of preference.
+ * @returns Launched browser instance
+ * @throws Error if no browser can be launched
  */
-interface StoriesIndexServiceConfig {
-  /**
-   * Enable verbose logging
-   * @default false
-   */
-  verbose?: boolean;
-  /** Workspace used to resolve relative search roots. */
-  workspaceRoot?: string;
-  /** Directories to scan, relative to the workspace or absolute. Defaults to the workspace root. */
-  searchRoots?: string[];
-  /** Exact story files to add without scanning their surrounding projects. */
-  storyFiles?: string[];
-  /** Maximum number of story files parsed concurrently. */
-  concurrency?: number;
-}
-//#endregion
-//#region src/services/StoriesIndexService/StoriesIndexService.d.ts
-/**
- * StoriesIndexService handles indexing and querying Storybook story files.
- *
- * Provides methods for scanning story files, extracting metadata using AST parsing,
- * and querying components by tags, title, or name.
- *
- * @example
- * ```typescript
- * const service = new StoriesIndexService();
- * await service.initialize();
- * const components = service.getAllComponents();
- * const button = service.findComponentByName('Button');
- * ```
- */
-/**
- * Result of initialization with success/failure statistics.
- */
-interface InitializationResult {
-  /** Total number of story files found */
-  totalFiles: number;
-  /** Number of successfully indexed files */
-  successCount: number;
-  /** Number of files that failed to index */
-  failureCount: number;
-  /** List of files that failed with their error messages */
-  failures: Array<{
-    filePath: string;
-    error: string;
-  }>;
-}
-export declare class StoriesIndexService {
-  private componentIndex;
-  private componentFileIndex;
-  private monorepoRoot;
-  private initialized;
-  /** Last initialization result for error reporting */
-  private lastInitResult;
-  private readonly config;
-  /**
-   * Creates a new StoriesIndexService instance
-   */
-  constructor(config?: StoriesIndexServiceConfig);
-  /**
-   * Initialize the index by scanning all .stories files.
-   * @returns Initialization result with success/failure statistics
-   */
-  initialize(): Promise<InitializationResult>;
-  /**
-   * Get the last initialization result.
-   * @returns Initialization result or null if not initialized
-   */
-  getLastInitResult(): InitializationResult | null;
-  private findStoryFiles;
-  private indexConcurrency;
-  private indexStoryFiles;
-  /**
-   * Index a single story file using storybook/internal/csf-tools.
-   *
-   * File reads remain cheap enough to hash on every new index. The expensive CSF
-   * parse is shared by content hash across service instances and concurrent rules.
-   */
-  private indexStoryFile;
-  private storeComponent;
-  private parseStoryFile;
-  /**
-   * Extract component description from file header JSDoc or meta.parameters.docs.description.
-   *
-   * Priority:
-   * 1. meta.parameters.docs.description.component (Storybook standard)
-   * 2. File header JSDoc comment (first block comment in file)
-   *
-   * @param content - Raw file content
-   * @param meta - Parsed meta object from csf-tools
-   * @returns Description string or undefined
-   */
-  private extractDescription;
-  /**
-   * Hash file content for cache invalidation
-   */
-  private hashContent;
-  /**
-   * Get all components filtered by tags
-   * @param tags - Optional array of tags to filter by
-   * @returns Array of matching components
-   */
-  getComponentsByTags(tags?: string[]): ComponentInfo[];
-  /**
-   * Get component by title
-   * @param title - Exact title to match (e.g., "Components/Button")
-   * @returns Component info or undefined
-   */
-  getComponentByTitle(title: string): ComponentInfo | undefined;
-  /**
-   * Find component by partial name match
-   * @param name - Partial name to search for
-   * @returns First matching component or undefined
-   */
-  findComponentByName(name: string, preferredAppPath?: string): ComponentInfo | undefined;
-  /**
-   * Refresh a specific file if it has changed
-   * @param filePath - Absolute path to story file
-   * @returns True if file was updated, false if unchanged
-   */
-  refreshFile(filePath: string): Promise<boolean>;
-  /** Get one indexed component by its canonical story file path. */
-  getComponentByFilePath(filePath: string): ComponentInfo | undefined;
-  /**
-   * Get all indexed components
-   * @returns Array of all component info objects
-   */
-  getAllComponents(): ComponentInfo[];
-  /**
-   * Clear the index (useful for testing)
-   */
-  clear(): void;
-  /**
-   * Get all unique tags from indexed components
-   * @returns Sorted array of unique tag names
-   */
-  getAllTags(): string[];
-}
+export declare function launchBrowserWithFallback(): Promise<Browser>;
 //#endregion
 //#region src/services/BundlerService/types.d.ts
 /**
@@ -554,6 +380,7 @@ export declare abstract class BaseBundlerService {
  * ```
  */
 export declare class ViteReactBundlerService extends BaseBundlerService {
+  private readonly workspaceRoot?;
   private static instance;
   private server;
   private monorepoRoot;
@@ -570,7 +397,7 @@ export declare class ViteReactBundlerService extends BaseBundlerService {
    * Use getInstance() for singleton access.
    * @param config - Service configuration options
    */
-  constructor(config?: BundlerServiceConfig);
+  constructor(config?: BundlerServiceConfig, workspaceRoot?: string | undefined);
   /**
    * Get the singleton instance of ViteReactBundlerService.
    * Singleton pattern ensures only one dev server runs at a time,
@@ -731,7 +558,31 @@ export declare class ViteReactBundlerService extends BaseBundlerService {
   private buildComponent;
 }
 //#endregion
+//#region src/services/BundlerService/ViteReactNativeBundlerService.d.ts
+export declare class ViteReactNativeBundlerService extends ViteReactBundlerService {
+  private static nativeInstance;
+  static getInstance(): ViteReactNativeBundlerService;
+  getBundlerId(): string;
+  protected getAdditionalVitePlugins(appPath?: string): Plugin[];
+  protected generateFrameworkSetupImports(options: BuildOptions): string;
+  protected generateStoryImport(componentPath: string): string;
+  protected wrapFrameworkElement(elementExpression: string): string;
+  protected getViteEsbuildConfig(): undefined;
+  protected getViteOxcConfig(): false;
+  protected getViteDefineConfig(): UserConfig['define'];
+  protected generatePreviewStyles(): string;
+  protected getViteResolveConfig(appPath: string): {
+    alias: AliasOptions;
+    extensions?: string[];
+  };
+}
+//#endregion
 //#region src/services/BundlerService/BundlerServiceFactory.d.ts
+/**
+ * Factory function type for creating bundler service instances.
+ * Users can provide custom implementations by defining their own factory.
+ */
+type BundlerServiceFactory = () => BaseBundlerService;
 /**
  * Default factory that creates a ViteReactBundlerService instance.
  * Uses the singleton pattern to ensure only one dev server runs at a time.
@@ -746,7 +597,7 @@ export declare class ViteReactBundlerService extends BaseBundlerService {
  * await bundler.startDevServer('apps/my-app');
  * ```
  */
-export declare function createDefaultBundlerService(): BaseBundlerService;
+export declare function createDefaultBundlerService(workspaceRoot?: string): BaseBundlerService;
 /**
  * Get a bundler service by its identifier.
  * Returns the default ViteReactBundlerService if the key is not found.
@@ -763,7 +614,7 @@ export declare function createDefaultBundlerService(): BaseBundlerService;
  * const bundler = getBundlerService('unknown'); // Returns ViteReactBundlerService
  * ```
  */
-export declare function getBundlerService(key: string): BaseBundlerService;
+export declare function getBundlerService(key: string, workspaceRoot?: string): BaseBundlerService;
 /**
  * Get bundler service based on the workspace style-system.config.yaml.
  *
@@ -787,7 +638,235 @@ export declare function getBundlerService(key: string): BaseBundlerService;
  * await bundler.startDevServer('apps/my-app');
  * ```
  */
-export declare function getBundlerServiceFromConfig(): Promise<BaseBundlerService>;
+export declare function getBundlerServiceFromConfig(options?: {
+  workspaceRoot: string;
+  configLoader?: StyleSystemConfigLoader;
+  defaultFactory?: BundlerServiceFactory;
+}): Promise<BaseBundlerService>;
+//#endregion
+//#region src/container/module.d.ts
+interface StyleSystemModuleOptions {
+  /** Explicit checkout for a long-lived host; omitted keeps standalone discovery. */
+  workspaceRoot?: string;
+  defaultThemePath?: string;
+  bundlerFactory?: (config: DesignSystemConfig) => BaseBundlerService;
+  temporaryDirectory?: string;
+  /** A browser a long-lived host keeps warm across renders; one-shot CLI runs leave it unset. */
+  sharedBrowser?: ScreenshotOptions['sharedBrowser'];
+}
+export declare function createStyleSystemModule(optionsInput?: StyleSystemModuleOptions): ContainerModule;
+//#endregion
+//#region src/container/types.d.ts
+export declare const STYLE_SYSTEM_TYPES: {
+  readonly ListThemesTool: symbol;
+  readonly GetCSSClassesTool: symbol;
+  readonly GetComponentVisualTool: symbol;
+  readonly ListSharedComponentsTool: symbol;
+  readonly ListAppComponentsTool: symbol;
+  readonly ThemeServiceFactory: symbol;
+  readonly CSSClassesServiceFactory: symbol;
+  readonly StoriesIndexService: symbol;
+  readonly GetUiComponentService: symbol;
+  readonly AppComponentsService: symbol;
+  readonly StoriesIndexFactory: symbol;
+  readonly RendererFactory: symbol;
+  readonly StyleSystemConfigLoader: symbol;
+  readonly WorkspaceRoot: symbol;
+  readonly DefaultThemePath: symbol;
+  readonly GetUiComponentServiceConfig: symbol;
+  readonly AppComponentsServiceConfig: symbol;
+};
+//#endregion
+//#region src/container/index.d.ts
+export declare function createContainer(options?: StyleSystemModuleOptions): Container;
+//#endregion
+//#region src/server/index.d.ts
+export declare function createServer(containerOrThemePath?: Container | string): Server;
+//#endregion
+//#region src/services/StoriesIndexService/types.d.ts
+/**
+ * StoriesIndexService Types
+ *
+ * Type definitions for the StoriesIndexService service.
+ */
+/**
+ * Story meta information from default export
+ */
+interface StoryMeta {
+  /** Story title (e.g., "Components/Button") */
+  title: string;
+  /** Reference to the component */
+  component?: unknown;
+  /** Story tags for filtering */
+  tags?: string[];
+  /** Story parameters */
+  parameters?: Record<string, unknown>;
+  /** Arg type definitions */
+  argTypes?: Record<string, unknown>;
+}
+/**
+ * Component information extracted from story files
+ */
+interface ComponentInfo {
+  /** Full title from meta (e.g., "Components/Button") */
+  title: string;
+  /** Absolute path to story file */
+  filePath: string;
+  /** SHA256 hash of file content for cache invalidation */
+  fileHash: string;
+  /** Tags from story meta */
+  tags: string[];
+  /** Display names of exported stories */
+  stories: string[];
+  /** Exact named exports available in the story module */
+  storyExports: string[];
+  /** Full story meta object */
+  meta: StoryMeta;
+  /** Component description extracted from file header JSDoc or meta.parameters.docs.description */
+  description?: string;
+}
+/**
+ * Configuration options for StoriesIndexService
+ */
+interface StoriesIndexServiceConfig {
+  /**
+   * Enable verbose logging
+   * @default false
+   */
+  verbose?: boolean;
+  /** Workspace used to resolve relative search roots. */
+  workspaceRoot?: string;
+  /** Directories to scan, relative to the workspace or absolute. Defaults to the workspace root. */
+  searchRoots?: string[];
+  /** Exact story files to add without scanning their surrounding projects. */
+  storyFiles?: string[];
+  /** Maximum number of story files parsed concurrently. */
+  concurrency?: number;
+}
+//#endregion
+//#region src/services/StoriesIndexService/StoriesIndexService.d.ts
+/**
+ * StoriesIndexService handles indexing and querying Storybook story files.
+ *
+ * Provides methods for scanning story files, extracting metadata using AST parsing,
+ * and querying components by tags, title, or name.
+ *
+ * @example
+ * ```typescript
+ * const service = new StoriesIndexService();
+ * await service.initialize();
+ * const components = service.getAllComponents();
+ * const button = service.findComponentByName('Button');
+ * ```
+ */
+/**
+ * Result of initialization with success/failure statistics.
+ */
+interface InitializationResult {
+  /** Total number of story files found */
+  totalFiles: number;
+  /** Number of successfully indexed files */
+  successCount: number;
+  /** Number of files that failed to index */
+  failureCount: number;
+  /** List of files that failed with their error messages */
+  failures: Array<{
+    filePath: string;
+    error: string;
+  }>;
+}
+export declare class StoriesIndexService {
+  private componentIndex;
+  private componentFileIndex;
+  private monorepoRoot;
+  private initialized;
+  /** Last initialization result for error reporting */
+  private lastInitResult;
+  private readonly config;
+  /**
+   * Creates a new StoriesIndexService instance
+   */
+  constructor(config?: StoriesIndexServiceConfig);
+  /**
+   * Initialize the index by scanning all .stories files.
+   * @returns Initialization result with success/failure statistics
+   */
+  initialize(): Promise<InitializationResult>;
+  /**
+   * Get the last initialization result.
+   * @returns Initialization result or null if not initialized
+   */
+  getLastInitResult(): InitializationResult | null;
+  private findStoryFiles;
+  private indexConcurrency;
+  private indexStoryFiles;
+  /**
+   * Index a single story file using storybook/internal/csf-tools.
+   *
+   * File reads remain cheap enough to hash on every new index. The expensive CSF
+   * parse is shared by content hash across service instances and concurrent rules.
+   */
+  private indexStoryFile;
+  private assertContainedStory;
+  private storeComponent;
+  private parseStoryFile;
+  /**
+   * Extract component description from file header JSDoc or meta.parameters.docs.description.
+   *
+   * Priority:
+   * 1. meta.parameters.docs.description.component (Storybook standard)
+   * 2. File header JSDoc comment (first block comment in file)
+   *
+   * @param content - Raw file content
+   * @param meta - Parsed meta object from csf-tools
+   * @returns Description string or undefined
+   */
+  private extractDescription;
+  /**
+   * Hash file content for cache invalidation
+   */
+  private hashContent;
+  /**
+   * Get all components filtered by tags
+   * @param tags - Optional array of tags to filter by
+   * @returns Array of matching components
+   */
+  getComponentsByTags(tags?: string[]): ComponentInfo[];
+  /**
+   * Get component by title
+   * @param title - Exact title to match (e.g., "Components/Button")
+   * @returns Component info or undefined
+   */
+  getComponentByTitle(title: string): ComponentInfo | undefined;
+  /**
+   * Find component by partial name match
+   * @param name - Partial name to search for
+   * @returns First matching component or undefined
+   */
+  findComponentByName(name: string, preferredAppPath?: string): ComponentInfo | undefined;
+  /**
+   * Refresh a specific file if it has changed
+   * @param filePath - Absolute path to story file
+   * @returns True if file was updated, false if unchanged
+   */
+  refreshFile(filePath: string): Promise<boolean>;
+  /** Get one indexed component by its canonical story file path. */
+  getComponentByFilePath(filePath: string): ComponentInfo | undefined;
+  /**
+   * Get all indexed components
+   * @returns Array of all component info objects
+   */
+  getAllComponents(): ComponentInfo[];
+  /**
+   * Clear the index (useful for testing)
+   */
+  clear(): void;
+  /**
+   * Get all unique tags from indexed components
+   * @returns Sorted array of unique tag names
+   */
+  getAllTags(): string[];
+}
 //#endregion
 //#region src/services/ComponentRendererService/types.d.ts
 /**
@@ -863,6 +942,9 @@ export declare class ComponentRendererService {
   private themeService;
   private appPath;
   private bundlerFactory;
+  private log;
+  private readonly preserveOutput;
+  private readonly sharedBrowser;
   /**
    * Creates a new ComponentRendererService instance
    * @param designSystemConfig - Design system configuration
@@ -871,6 +953,9 @@ export declare class ComponentRendererService {
    */
   constructor(designSystemConfig: DesignSystemConfig, appPath: string, options?: {
     bundlerFactory?: BundlerFactory;
+    workspaceRoot?: string;
+    temporaryDirectory?: string;
+    sharedBrowser?: ScreenshotOptions['sharedBrowser'];
   });
   /**
    * Get the bundler service instance.
@@ -1016,6 +1101,7 @@ type RendererFactory = (config: DesignSystemConfig, appPath: string) => Componen
  * ```
  */
 export declare class GetUiComponentService {
+  private readonly configLoader?;
   private config;
   private storiesIndexFactory;
   private rendererFactory;
@@ -1025,7 +1111,7 @@ export declare class GetUiComponentService {
    * @param storiesIndexFactory - Factory for creating StoriesIndexService (for DI/testing)
    * @param rendererFactory - Factory for creating ComponentRendererService (for DI/testing)
    */
-  constructor(config?: GetUiComponentServiceConfig, storiesIndexFactory?: StoriesIndexFactory, rendererFactory?: RendererFactory);
+  constructor(config?: GetUiComponentServiceConfig, storiesIndexFactory?: StoriesIndexFactory, rendererFactory?: RendererFactory, configLoader?: StyleSystemConfigLoader | undefined);
   /**
    * Get a UI component preview image.
    *
@@ -1223,7 +1309,7 @@ export declare class ThemeService {
    * Creates a new ThemeService instance
    * @param config - Design system configuration
    */
-  constructor(config: DesignSystemConfig);
+  constructor(config: DesignSystemConfig, workspaceRoot?: string);
   /**
    * Get design system configuration
    * @returns Current design system configuration
@@ -1292,6 +1378,8 @@ export declare class ThemeService {
  * ```
  */
 declare class ThemeServiceFactory {
+  private readonly workspaceRoot?;
+  constructor(workspaceRoot?: string | undefined);
   /**
    * Create a theme service based on configuration.
    *
@@ -1543,6 +1631,8 @@ export declare class TailwindCSSClassesService extends BaseCSSClassesService {
  * ```
  */
 export declare class CSSClassesServiceFactory {
+  private readonly workspaceRoot?;
+  constructor(workspaceRoot?: string | undefined);
   /**
    * Create a CSS classes service based on configuration.
    *
@@ -1672,6 +1762,7 @@ interface GetCSSClassesInput {
  * ```
  */
 export declare class GetCSSClassesTool implements Tool<GetCSSClassesInput> {
+  private readonly configLoader?;
   static readonly TOOL_NAME = "get_css_classes";
   private static readonly CSS_REUSE_INSTRUCTION;
   private serviceFactory;
@@ -1681,7 +1772,7 @@ export declare class GetCSSClassesTool implements Tool<GetCSSClassesInput> {
    * @param serviceFactory - Injected CSSClassesServiceFactory
    * @param defaultThemePath - Default path to theme CSS file (relative to workspace root)
    */
-  constructor(serviceFactory: CSSClassesServiceFactory, defaultThemePath?: string);
+  constructor(serviceFactory: CSSClassesServiceFactory, defaultThemePath?: string, configLoader?: StyleSystemConfigLoader | undefined);
   /**
    * Returns the tool definition for MCP registration
    * @returns Tool definition with name, description, and input schema
@@ -1778,12 +1869,13 @@ interface AppComponentsServiceResult {
  * ```
  */
 declare class AppComponentsService {
+  private readonly workspaceRoot?;
   private config;
   /**
    * Creates a new AppComponentsService instance.
    * @param config - Service configuration options
    */
-  constructor(config?: AppComponentsServiceConfig);
+  constructor(config?: AppComponentsServiceConfig, workspaceRoot?: string | undefined);
   /**
    * List app-specific and package components for a given application.
    * @param input - Object containing appPath and optional cursor for pagination
@@ -1933,9 +2025,10 @@ interface ListThemesInput {
  * ```
  */
 export declare class ListThemesTool implements Tool<ListThemesInput> {
+  private readonly configLoader?;
   static readonly TOOL_NAME = "list_themes";
   private serviceFactory;
-  constructor(serviceFactory: ThemeServiceFactory);
+  constructor(serviceFactory: ThemeServiceFactory, configLoader?: StyleSystemConfigLoader | undefined);
   getDefinition(): ToolDefinition;
   execute(input: ListThemesInput): Promise<CallToolResult>;
 }
@@ -1951,11 +2044,12 @@ interface ListSharedComponentsInput {
   cursor?: string;
 }
 export declare class ListSharedComponentsTool implements Tool<ListSharedComponentsInput> {
+  private readonly configLoader?;
   static readonly TOOL_NAME = "list_shared_components";
   static readonly PAGE_SIZE = 50;
   private static readonly COMPONENT_REUSE_INSTRUCTION;
   private storiesIndexFactory;
-  constructor(storiesIndexFactory: StoriesIndexFactory);
+  constructor(storiesIndexFactory: StoriesIndexFactory, configLoader?: StyleSystemConfigLoader | undefined);
   /**
    * Encode pagination state into an opaque cursor string
    * @param offset - The current offset in the component list
@@ -1981,38 +2075,6 @@ export declare class ListSharedComponentsTool implements Tool<ListSharedComponen
   execute(input: ListSharedComponentsInput): Promise<CallToolResult>;
 }
 //#endregion
-//#region src/tools/PolishComponentTool.d.ts
-interface PolishComponentInput {
-  filePath: string;
-  instructions?: string;
-}
-export declare class PolishComponentTool implements Tool<PolishComponentInput> {
-  static readonly TOOL_NAME = "polish_component";
-  private antigravityService;
-  private getUiComponentService;
-  private cssClassesServiceFactory;
-  private storiesIndexFactory;
-  constructor(getUiComponentService: GetUiComponentService, cssClassesServiceFactory: CSSClassesServiceFactory, storiesIndexFactory: StoriesIndexFactory);
-  getDefinition(): ToolDefinition;
-  execute(input: PolishComponentInput): Promise<CallToolResult>;
-  private detectPlatform;
-  private buildSystemPrompt;
-  /**
-   * Read design tokens from config.themePath.
-   * For web: extracts Tailwind CSS classes. For native: reads the TypeScript types file.
-   */
-  private getDesignTokens;
-  private findStoriesFile;
-  /**
-   * Find the app that owns a file, for style-system context.
-   * Only apps declaring their own style-system.config.yaml are eligible.
-   */
-  private findAppPath;
-  private getComponentVisual;
-  private getDesignPrinciples;
-  private getSharedComponents;
-}
-//#endregion
 //#region src/transports/stdio.d.ts
 /** Modern MCP stdio only: reject legacy initialization explicitly. */
 export declare class StdioTransportHandler {
@@ -2024,4 +2086,46 @@ export declare class StdioTransportHandler {
   stop(): Promise<void>;
 }
 //#endregion
-export type { CSSClassCategory, CSSClassValue, CSSClassesResult, DesignSystemConfig, OxlintRestrictedClassPattern, OxlintRestrictedClassesConfig, ResolvedDesignSystemConfig, StoryPreviewIdentity, StoryPreviewInput, StoryPreviewResult, StoryPreviewServiceOptions, StyleSystemConfig, StyleSystemModuleOptions, Tool, ToolDefinition };
+//#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. */
+export declare const WARM_RENDERER_TOOLS: {
+  readonly get_component_visual: symbol;
+  readonly get_css_classes: symbol;
+  readonly list_themes: symbol;
+  readonly list_shared_components: symbol;
+  readonly list_app_components: symbol;
+};
+type WarmRendererToolName = keyof typeof WARM_RENDERER_TOOLS;
+interface WarmRendererResult {
+  text: string;
+  images: {
+    data: string;
+    mimeType: string;
+  }[];
+  isError: boolean;
+}
+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 owned resources; a borrowed server browser remains running. */
+  restart(): Promise<void>;
+  dispose(): Promise<void>;
+}
+/**
+ * Keeps one browser and one Vite dev server warm across renders, so a render after the first
+ * skips the browser launch and the static build. Rendered screenshots come back as base64.
+ */
+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 };