@agiflowai/style-system 0.0.12 → 0.1.0

package/dist/{stdio-Db2a8Jns.js → stdio-CbJA-IPN.mjs}

@@ -14,9 +14,14 @@ import os from "node:os";
 import { chromium, firefox, webkit } from "playwright";
 import sharp from "sharp";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-
 //#region src/config.ts
 /**
+* App-specific design system configuration
+*
+* This configuration is read from each app's project.json file
+* under the "style-system" key.
+*/
+/**
 * Default tags for identifying shared/design system components
 */
 const DEFAULT_SHARED_COMPONENT_TAGS = ["style-system"];
@@ -170,10 +175,28 @@ async function getBundlerConfig() {
 		if (error instanceof Error && "code" in error && error.code !== "ENOENT") log.warn(`[Config] Failed to parse toolkit.yaml: ${error.message}`);
 	}
 }
-
 //#endregion
 //#region src/services/CssClasses/BaseCSSClassesService.ts
 /**
+* BaseCSSClassesService
+*
+* DESIGN PATTERNS:
+* - Abstract base class for CSS class extraction services
+* - Template method pattern for extensible extraction logic
+* - Strategy pattern allowing different CSS framework implementations
+*
+* CODING STANDARDS:
+* - Abstract classes define interface contracts for subclasses
+* - Protected methods allow subclass customization
+* - Use async/await for all I/O operations
+* - Throw descriptive errors with context
+*
+* AVOID:
+* - Direct instantiation of abstract class
+* - Framework-specific logic in base class
+* - Synchronous file operations
+*/
+/**
 * Abstract base class for CSS class extraction services.
 *
 * Subclasses must implement the `extractClasses` method to provide
@@ -212,10 +235,27 @@ var BaseCSSClassesService = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/services/CssClasses/TailwindCSSClassesService.ts
 /**
+* TailwindCSSClassesService
+*
+* DESIGN PATTERNS:
+* - Extends BaseCSSClassesService for Tailwind-specific extraction
+* - Uses postcss AST parser for robust CSS variable extraction
+* - Parses CSS variables from theme files to generate utility classes
+*
+* CODING STANDARDS:
+* - Implement abstract methods from base class
+* - Use async/await for file operations
+* - Throw descriptive errors with context
+*
+* AVOID:
+* - Hardcoding theme paths
+* - Synchronous file operations
+* - Fragile regex-based CSS parsing
+*/
+/**
 * Tailwind CSS class extraction service.
 *
 * Extracts CSS classes from Tailwind theme files by parsing CSS variables
@@ -430,16 +470,30 @@ var TailwindCSSClassesService = class extends BaseCSSClassesService {
 		return result;
 	}
 };
-
 //#endregion
 //#region src/services/CssClasses/types.ts
 /**
 * Default configuration values
 */
 const DEFAULT_STYLE_SYSTEM_CONFIG = { cssFramework: "tailwind" };
-
 //#endregion
 //#region src/services/CssClasses/CSSClassesServiceFactory.ts
+/**
+* CSSClassesServiceFactory
+*
+* DESIGN PATTERNS:
+* - Factory pattern for creating CSS classes service instances
+* - Supports built-in frameworks and custom service loading
+*
+* CODING STANDARDS:
+* - Use async factory method for dynamic service loading
+* - Return typed results
+* - Throw descriptive errors with context
+*
+* AVOID:
+* - Synchronous file operations
+* - Hardcoded framework paths
+*/
 /** Valid file extensions for custom service modules */
 const VALID_SERVICE_EXTENSIONS$1 = [
 	".ts",
@@ -522,10 +576,29 @@ var CSSClassesServiceFactory = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/tools/GetCSSClassesTool.ts
 /**
+* GetCSSClassesTool
+*
+* DESIGN PATTERNS:
+* - Tool pattern with getDefinition() and execute() methods
+* - Service delegation for business logic via factory pattern
+* - JSON Schema validation for inputs
+*
+* CODING STANDARDS:
+* - Implement Tool interface from ../types
+* - Use TOOL_NAME constant with snake_case (e.g., 'get_css_classes')
+* - Return CallToolResult with content array
+* - Handle errors with isError flag
+* - Delegate complex logic to services
+*
+* AVOID:
+* - Complex business logic in execute method
+* - Unhandled promise rejections
+* - Missing input validation
+*/
+/**
 * Valid CSS class category values
 */
 const VALID_CATEGORIES = [
@@ -565,7 +638,7 @@ var GetCSSClassesTool = class GetCSSClassesTool {
 	* Creates a new GetCSSClassesTool instance
 	* @param defaultThemePath - Default path to theme CSS file (relative to workspace root)
 	*/
-	constructor(defaultThemePath = "packages/frontend/web-theme/src/agimon-theme.css") {
+	constructor(defaultThemePath) {
 		this.serviceFactory = new CSSClassesServiceFactory();
 		this.defaultThemePath = defaultThemePath;
 	}
@@ -649,12 +722,30 @@ var GetCSSClassesTool = class GetCSSClassesTool {
 				return path.resolve(resolvedAppPath, config.themePath);
 			}
 		}
-		return path.resolve(workspaceRoot, this.defaultThemePath);
+		if (this.defaultThemePath) return path.resolve(workspaceRoot, this.defaultThemePath);
+		throw new Error("No theme CSS path configured. Pass --theme-path, or provide style-system.themePath in the target app project.json.");
 	}
 };
-
 //#endregion
 //#region src/services/StoriesIndexService/StoriesIndexService.ts
+/**
+* StoriesIndexService
+*
+* DESIGN PATTERNS:
+* - Service pattern for business logic encapsulation
+* - Single responsibility principle
+* - Caching with file content hashing
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Throw descriptive errors for error cases
+* - Keep methods focused and well-named
+* - Document complex logic with comments
+*
+* AVOID:
+* - Mixing concerns (keep focused on single domain)
+* - Direct tool implementation (services should be tool-agnostic)
+*/
 var StoriesIndexService = class {
 	componentIndex = /* @__PURE__ */ new Map();
 	monorepoRoot;
@@ -844,17 +935,32 @@ var StoriesIndexService = class {
 		return Array.from(tagSet).sort();
 	}
 };
-
 //#endregion
 //#region src/services/AppComponentsService/types.ts
 /**
 * Default configuration values.
 */
 const DEFAULT_APP_COMPONENTS_CONFIG = { pageSize: 50 };
-
 //#endregion
 //#region src/services/AppComponentsService/AppComponentsService.ts
 /**
+* AppComponentsService
+*
+* DESIGN PATTERNS:
+* - Service pattern for business logic encapsulation
+* - Single responsibility principle
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Throw descriptive errors for error cases
+* - Keep methods focused and well-named
+* - Document complex logic with comments
+*
+* AVOID:
+* - Mixing concerns (keep focused on single domain)
+* - Direct tool implementation (services should be tool-agnostic)
+*/
+/**
 * AppComponentsService handles listing app-specific and package components.
 *
 * Detects components by file path (within app directory) and resolves
@@ -1096,7 +1202,6 @@ var AppComponentsService = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/services/BundlerService/BaseBundlerService.ts
 /**
@@ -1126,10 +1231,27 @@ var BaseBundlerService = class {
 		this.config = config;
 	}
 };
-
 //#endregion
 //#region src/services/BundlerService/ViteReactBundlerService.ts
 /**
+* ViteReactBundlerService
+*
+* DESIGN PATTERNS:
+* - Concrete implementation of BaseBundlerService
+* - Singleton pattern for dev server management
+* - Programmatic Vite build for React component SSR
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Throw descriptive errors for error cases
+* - Keep methods focused and well-named
+* - Document complex logic with comments
+*
+* AVOID:
+* - Mixing concerns (keep focused on Vite + React)
+* - Direct tool implementation (services should be tool-agnostic)
+*/
+/**
 * Maximum age for story configs in milliseconds (5 minutes).
 * Configs older than this are cleaned up to prevent memory leaks.
 */
@@ -1372,8 +1494,8 @@ var ViteReactBundlerService = class ViteReactBundlerService extends BaseBundlerS
 		const tmpDir = path.join(resolvedAppPath, ".tmp");
 		try {
 			await promises.mkdir(tmpDir, { recursive: true });
-			const { createServer: createServer$1 } = await import("vite");
-			this.server = await createServer$1({
+			const { createServer } = await import("vite");
+			this.server = await createServer({
 				root: tmpDir,
 				base: "/",
 				configFile: false,
@@ -1389,14 +1511,14 @@ var ViteReactBundlerService = class ViteReactBundlerService extends BaseBundlerS
 				}
 			});
 			this.server.middlewares.use(async (req, res, next) => {
-				const url$1 = req.url || "/";
-				const match = url$1.match(/^\/preview\/([^/?]+)/);
+				const url = req.url || "/";
+				const match = url.match(/^\/preview\/([^/?]+)/);
 				if (match) {
 					const storyId = match[1];
 					const config = this.storyConfigs.get(storyId);
 					if (config) try {
 						const htmlTemplate = this.generateHtmlTemplate(`@virtual:story-entry?id=${storyId}`, config.darkMode);
-						const transformedHtml = await this.server?.transformIndexHtml(url$1, htmlTemplate);
+						const transformedHtml = await this.server?.transformIndexHtml(url, htmlTemplate);
 						res.statusCode = 200;
 						res.setHeader("Content-Type", "text/html");
 						res.end(transformedHtml);
@@ -1700,9 +1822,26 @@ root.render(wrappedElement);
 		}
 	}
 };
-
 //#endregion
 //#region src/services/BundlerService/BundlerServiceFactory.ts
+/**
+* BundlerServiceFactory
+*
+* DESIGN PATTERNS:
+* - Factory pattern for creating bundler service instances
+* - Registry pattern for bundler implementations
+* - Follows StoriesIndexService factory approach
+*
+* CODING STANDARDS:
+* - Use type-safe factory functions
+* - Provide sensible defaults (ViteReactBundlerService)
+* - Allow user-provided implementations
+* - Document public APIs with JSDoc
+*
+* AVOID:
+* - Hard-coding bundler implementations
+* - Breaking changes to factory interface
+*/
 /** Valid file extensions for custom service modules */
 const VALID_SERVICE_EXTENSIONS = [
 	".ts",
@@ -1727,22 +1866,7 @@ const VALID_SERVICE_EXTENSIONS = [
 function createDefaultBundlerService() {
 	return ViteReactBundlerService.getInstance();
 }
-/**
-* Registry of available bundler service factories.
-* Allows registration of custom bundler implementations by key.
-*
-* @example
-* ```typescript
-* // Register a custom bundler
-* bundlerRegistry.set('webpack-react', () => new WebpackReactBundlerService());
-*
-* // Get a bundler by key
-* const factory = bundlerRegistry.get('webpack-react');
-* const bundler = factory?.() ?? createDefaultBundlerService();
-* ```
-*/
-const bundlerRegistry = /* @__PURE__ */ new Map();
-bundlerRegistry.set("vite-react", createDefaultBundlerService);
+(/* @__PURE__ */ new Map()).set("vite-react", createDefaultBundlerService);
 /** Cached bundler service instance loaded from config */
 let cachedBundlerService = null;
 /**
@@ -1822,9 +1946,25 @@ async function getBundlerServiceFromConfig() {
 		return cachedBundlerService;
 	}
 }
-
 //#endregion
 //#region src/utils/screenshot.ts
+/**
+* Screenshot utility using Playwright
+*
+* DESIGN PATTERNS:
+* - Utility function for browser automation
+* - Factory pattern for browser selection
+* - Options pattern for configuration
+*
+* CODING STANDARDS:
+* - Use async/await for browser operations
+* - Clean up resources (close browser) in finally block
+* - Support multiple browsers (chromium, firefox, webkit)
+*
+* AVOID:
+* - Leaving browser instances open
+* - Hardcoding viewport sizes
+*/
 const browsers = {
 	chromium,
 	firefox,
@@ -1908,10 +2048,28 @@ async function takeScreenshot(options) {
 		if (browser) await browser.close();
 	}
 }
-
 //#endregion
 //#region src/services/ThemeService/BaseThemeService.ts
 /**
+* BaseThemeService
+*
+* DESIGN PATTERNS:
+* - Abstract base class for theme listing services
+* - Template method pattern for extensible theme extraction
+* - Strategy pattern allowing different theme source implementations
+*
+* CODING STANDARDS:
+* - Abstract classes define interface contracts for subclasses
+* - Protected methods allow subclass customization
+* - Use async/await for all I/O operations
+* - Throw descriptive errors with context
+*
+* AVOID:
+* - Direct instantiation of abstract class
+* - Source-specific logic in base class
+* - Synchronous file operations
+*/
+/**
 * Abstract base class for theme listing services.
 *
 * Subclasses must implement the `listThemes` method to provide
@@ -1950,10 +2108,27 @@ var BaseThemeService = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/services/ThemeService/CSSThemeService.ts
 /**
+* CSSThemeService
+*
+* DESIGN PATTERNS:
+* - Extends BaseThemeService for CSS-based theme extraction
+* - Uses postcss AST parser for robust CSS parsing
+* - Extracts theme names from CSS class selectors
+*
+* CODING STANDARDS:
+* - Implement abstract methods from base class
+* - Use async/await for file operations
+* - Throw descriptive errors with context
+*
+* AVOID:
+* - Hardcoding theme paths
+* - Synchronous file operations
+* - Fragile regex-based CSS parsing
+*/
+/**
 * CSS-based theme service implementation.
 *
 * Extracts themes from CSS files by parsing class selectors that contain
@@ -2080,10 +2255,26 @@ var CSSThemeService = class extends BaseThemeService {
 		});
 	}
 };
-
 //#endregion
 //#region src/services/ThemeService/ThemeService.ts
 /**
+* ThemeService
+*
+* DESIGN PATTERNS:
+* - Service pattern for business logic encapsulation
+* - App-specific theme configuration from project.json
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Throw descriptive errors for error cases
+* - Keep methods focused and well-named
+* - Document complex logic with comments
+*
+* AVOID:
+* - Mixing concerns (keep focused on single domain)
+* - Direct tool implementation (services should be tool-agnostic)
+*/
+/**
 * ThemeService handles theme configuration and CSS generation.
 *
 * Provides methods for accessing theme CSS, generating theme wrappers,
@@ -2242,7 +2433,6 @@ export default WrappedComponent;
 		}
 	}
 };
-
 //#endregion
 //#region src/services/ThemeService/types.ts
 /**
@@ -2253,10 +2443,25 @@ const DEFAULT_THEME_SERVICE_CONFIG = {
 	cssFiles: [],
 	customServicePath: void 0
 };
-
 //#endregion
 //#region src/services/ThemeService/ThemeServiceFactory.ts
 /**
+* ThemeServiceFactory
+*
+* DESIGN PATTERNS:
+* - Factory pattern for creating theme service instances
+* - Supports built-in CSS theme extraction and custom service loading
+*
+* CODING STANDARDS:
+* - Use async factory method for dynamic service loading
+* - Return typed results
+* - Throw descriptive errors with context
+*
+* AVOID:
+* - Synchronous file operations
+* - Hardcoded service paths
+*/
+/**
 * Factory for creating theme service instances.
 *
 * Supports the built-in CSSThemeService and custom service implementations
@@ -2324,10 +2529,28 @@ var ThemeServiceFactory = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/services/ComponentRendererService/ComponentRendererService.ts
 /**
+* ComponentRendererService
+*
+* DESIGN PATTERNS:
+* - Service pattern for business logic encapsulation
+* - Service composition (uses BundlerService and ThemeService)
+* - Dependency injection for bundler service (allows custom implementations)
+* - HTML template generation with theme provider wrapping
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Throw descriptive errors for error cases
+* - Keep methods focused and well-named
+* - Document complex logic with comments
+*
+* AVOID:
+* - Mixing concerns (keep focused on single domain)
+* - Direct tool implementation (services should be tool-agnostic)
+*/
+/**
 * ComponentRendererService handles rendering React components to images.
 *
 * Uses BundlerService for building/serving components and ThemeService
@@ -2545,7 +2768,6 @@ var ComponentRendererService = class ComponentRendererService {
 		}
 	}
 };
-
 //#endregion
 //#region src/services/GetUiComponentService/types.ts
 /**
@@ -2557,10 +2779,26 @@ const DEFAULT_GET_UI_COMPONENT_CONFIG = {
 	defaultWidth: 1280,
 	defaultHeight: 800
 };
-
 //#endregion
 //#region src/services/GetUiComponentService/GetUiComponentService.ts
 /**
+* GetUiComponentService
+*
+* DESIGN PATTERNS:
+* - Service pattern for business logic encapsulation
+* - Single responsibility principle
+*
+* CODING STANDARDS:
+* - Use async/await for asynchronous operations
+* - Throw descriptive errors for error cases
+* - Keep methods focused and well-named
+* - Document complex logic with comments
+*
+* AVOID:
+* - Mixing concerns (keep focused on single domain)
+* - Direct tool implementation (services should be tool-agnostic)
+*/
+/**
 * GetUiComponentService handles rendering UI component previews.
 *
 * Locates components in the stories index, renders them with app-specific
@@ -2682,7 +2920,6 @@ var GetUiComponentService = class {
 		}
 	}
 };
-
 //#endregion
 //#region src/tools/GetComponentVisualTool.ts
 /**
@@ -2784,7 +3021,6 @@ var GetComponentVisualTool = class GetComponentVisualTool {
 		}
 	}
 };
-
 //#endregion
 //#region src/tools/ListAppComponentsTool.ts
 /**
@@ -2859,7 +3095,6 @@ var ListAppComponentsTool = class ListAppComponentsTool {
 		}
 	}
 };
-
 //#endregion
 //#region src/tools/ListThemesTool.ts
 /**
@@ -2924,9 +3159,28 @@ var ListThemesTool = class ListThemesTool {
 		}
 	}
 };
-
 //#endregion
 //#region src/tools/ListSharedComponentsTool.ts
+/**
+* ListSharedComponentsTool
+*
+* DESIGN PATTERNS:
+* - Tool pattern with getDefinition() and execute() methods
+* - Service delegation for business logic
+* - JSON Schema validation for inputs
+*
+* CODING STANDARDS:
+* - Implement Tool interface from ../types
+* - Use TOOL_NAME constant with snake_case (e.g., 'list_shared_components')
+* - Return CallToolResult with content array
+* - Handle errors with isError flag
+* - Delegate complex logic to services
+*
+* AVOID:
+* - Complex business logic in execute method
+* - Unhandled promise rejections
+* - Missing input validation
+*/
 var ListSharedComponentsTool = class ListSharedComponentsTool {
 	static TOOL_NAME = "list_shared_components";
 	static PAGE_SIZE = 50;
@@ -3022,9 +3276,28 @@ var ListSharedComponentsTool = class ListSharedComponentsTool {
 		}
 	}
 };
-
+//#endregion
+//#region package.json
+var version = "0.0.13";
+//#endregion
+//#region src/metadata.ts
+const STYLE_SYSTEM_CLI_NAME = "style-system";
+const STYLE_SYSTEM_SERVER_NAME = "style-system";
+const STYLE_SYSTEM_VERSION = version;
 //#endregion
 //#region src/server/index.ts
+/**
+* MCP Server Setup
+*
+* DESIGN PATTERNS:
+* - Factory pattern for server creation
+* - Tool registration pattern
+*
+* CODING STANDARDS:
+* - Register all tools, resources, and prompts here
+* - Keep server setup modular and extensible
+* - Import tools from ../tools/ and register them in the handlers
+*/
 const TOOL_CAPABILITIES_META_KEY = "agiflowai/capabilities";
 function withCapabilities(definition, capabilities) {
 	return {
@@ -3035,10 +3308,10 @@ function withCapabilities(definition, capabilities) {
 		}
 	};
 }
-function createServer(themePath = "packages/frontend/web-theme/src/agimon-theme.css") {
+function createServer(themePath) {
 	const server = new Server({
-		name: "style-system-mcp",
-		version: "0.1.0"
+		name: STYLE_SYSTEM_SERVER_NAME,
+		version: STYLE_SYSTEM_VERSION
 	}, {
 		capabilities: { tools: {} },
 		instructions: "Use this MCP when you work on the frontend or design. You can use this to list supported themes, get the correct tailwind classes supported by the repo, list design system components, and get visual + detailed implementation of components."
@@ -3095,10 +3368,25 @@ function createServer(themePath = "packages/frontend/web-theme/src/agimon-theme.
 	});
 	return server;
 }
-
 //#endregion
 //#region src/transports/stdio.ts
 /**
+* STDIO Transport
+*
+* DESIGN PATTERNS:
+* - Transport handler pattern implementing TransportHandler interface
+* - Standard I/O based communication for CLI usage
+*
+* CODING STANDARDS:
+* - Initialize server and transport properly
+* - Handle cleanup on shutdown with stop() method
+* - Use async/await for all operations
+*
+* AVOID:
+* - Forgetting to close transport on shutdown
+* - Missing error handling for connection failures
+*/
+/**
 * Stdio transport handler for MCP server
 * Used for command-line and direct integrations
 */
@@ -3111,7 +3399,7 @@ var StdioTransportHandler = class {
 	async start() {
 		this.transport = new StdioServerTransport();
 		await this.server.connect(this.transport);
-		log.info("style-system-mcp MCP server started on stdio");
+		log.info(`${STYLE_SYSTEM_SERVER_NAME} MCP server started on stdio`);
 	}
 	async stop() {
 		if (this.transport) {
@@ -3120,6 +3408,5 @@ var StdioTransportHandler = class {
 		}
 	}
 };
-
 //#endregion
-export { TailwindCSSClassesService as _, ListAppComponentsTool as a, ThemeService as c, ViteReactBundlerService as d, BaseBundlerService as f, DEFAULT_STYLE_SYSTEM_CONFIG as g, CSSClassesServiceFactory as h, ListThemesTool as i, createDefaultBundlerService as l, GetCSSClassesTool as m, createServer as n, GetComponentVisualTool as o, StoriesIndexService as p, ListSharedComponentsTool as r, ComponentRendererService as s, StdioTransportHandler as t, getBundlerServiceFromConfig as u, BaseCSSClassesService as v };
+export { CSSClassesServiceFactory as _, ListSharedComponentsTool as a, BaseCSSClassesService as b, GetComponentVisualTool as c, createDefaultBundlerService as d, getBundlerServiceFromConfig as f, GetCSSClassesTool as g, StoriesIndexService as h, STYLE_SYSTEM_VERSION as i, ComponentRendererService as l, BaseBundlerService as m, createServer as n, ListThemesTool as o, ViteReactBundlerService as p, STYLE_SYSTEM_CLI_NAME as r, ListAppComponentsTool as s, StdioTransportHandler as t, ThemeService as u, DEFAULT_STYLE_SYSTEM_CONFIG as v, TailwindCSSClassesService as y };