@agimon-ai/style-system 0.1.4 → 0.1.5

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_stdio = require("./stdio-DSao01TL.cjs");
+const require_stdio = require("./stdio-WGt31vrr.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 { F as log, M as DEFAULT_STYLE_SYSTEM_CONFIG, N as TailwindCSSClassesService, O as resolveStyleSystemThemePath, S as getAppDesignSystemConfig, a as STYLE_SYSTEM_CLI_NAME, i as createServer, k as STYLE_SYSTEM_TYPES, o as STYLE_SYSTEM_VERSION, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler, y as getBundlerServiceFromConfig } from "./stdio-BDcQDFR-.mjs";
+import { A as STYLE_SYSTEM_TYPES, C as getAppDesignSystemConfig, L as log, N as DEFAULT_STYLE_SYSTEM_CONFIG, P as TailwindCSSClassesService, a as STYLE_SYSTEM_CLI_NAME, b as getBundlerServiceFromConfig, i as createServer, k as resolveStyleSystemThemePath, o as STYLE_SYSTEM_VERSION, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler } from "./stdio-VllEe0CI.mjs";
 import { promises } from "node:fs";
 import path from "node:path";
 import { registerManagedProcess } from "@agimon-ai/foundation-exec";

package/dist/index.cjs

@@ -1,5 +1,95 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-DSao01TL.cjs");
+const require_stdio = require("./stdio-WGt31vrr.cjs");
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+node_path = require_stdio.__toESM(node_path, 1);
+let node_crypto = require("node:crypto");
+//#region src/services/StoryPreviewService/StoryPreviewService.ts
+const STORY_FILE_PATTERN = /\.stories\.(?:ts|tsx)$/;
+const STORY_EXPORT_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const UTF8_ENCODING = "utf8";
+function isContained(root, candidate) {
+	const relative = node_path.default.relative(root, candidate);
+	return relative === "" || !relative.startsWith(`..${node_path.default.sep}`) && relative !== ".." && !node_path.default.isAbsolute(relative);
+}
+/** Builds and owns disposable, self-contained HTML previews for exact story exports. */
+var StoryPreviewService = class {
+	workspaceRoot;
+	storiesIndexFactory;
+	configLoader;
+	bundlerFactory;
+	previews = /* @__PURE__ */ new Map();
+	constructor(options = {}) {
+		this.workspaceRoot = node_path.default.resolve(options.workspaceRoot ?? require_stdio.TemplatesManagerService.getWorkspaceRootSync());
+		this.storiesIndexFactory = options.storiesIndexFactory ?? ((workspaceRoot, storyFilePath) => new require_stdio.StoriesIndexService({
+			workspaceRoot,
+			storyFiles: [storyFilePath],
+			searchRoots: []
+		}));
+		this.configLoader = options.configLoader ?? require_stdio.getAppDesignSystemConfig;
+		this.bundlerFactory = options.bundlerFactory ?? ((config) => config.bundler ? require_stdio.getBundlerService(config.bundler) : require_stdio.createDefaultBundlerService());
+	}
+	async build(input) {
+		if (!STORY_EXPORT_PATTERN.test(input.storyExport)) throw new Error("storyExport must be an exact JavaScript named export");
+		const workspaceRoot = await node_fs.promises.realpath(this.workspaceRoot);
+		const appPath = await this.resolveContainedPath(workspaceRoot, input.appPath, "appPath");
+		const storyFilePath = await this.resolveContainedPath(workspaceRoot, input.storyFilePath, "storyFilePath");
+		if (!STORY_FILE_PATTERN.test(storyFilePath)) throw new Error("storyFilePath must name a .stories.ts or .stories.tsx file");
+		const index = this.storiesIndexFactory(workspaceRoot, storyFilePath);
+		await index.initialize();
+		const component = index.getComponentByFilePath(storyFilePath);
+		if (!component) throw new Error(`Story file was not indexed: ${node_path.default.relative(workspaceRoot, storyFilePath)}`);
+		if (!component.storyExports.includes(input.storyExport)) throw new Error(`Story export "${input.storyExport}" was not found. Available exports: ${component.storyExports.join(", ")}`);
+		const [source, config] = await Promise.all([node_fs.promises.readFile(storyFilePath, UTF8_ENCODING), this.configLoader(appPath)]);
+		const result = await this.bundlerFactory(config).prerenderComponent({
+			componentPath: storyFilePath,
+			storyName: input.storyExport,
+			args: input.args,
+			darkMode: input.darkMode,
+			appPath,
+			themePath: config.themeProvider,
+			cssFiles: config.cssFiles,
+			rootComponent: config.rootComponent,
+			unistylesConfig: config.unistylesConfig
+		});
+		const htmlFilePath = await node_fs.promises.realpath(result.htmlFilePath);
+		const artifactDirectory = node_path.default.dirname(htmlFilePath);
+		if (!isContained(node_path.default.join(appPath, ".tmp"), artifactDirectory)) throw new Error("Bundler returned a preview artifact outside the project temporary directory");
+		const handle = (0, node_crypto.randomUUID)();
+		const html = await node_fs.promises.readFile(htmlFilePath, UTF8_ENCODING);
+		this.previews.set(handle, { artifactDirectory });
+		return {
+			handle,
+			identity: {
+				storyFilePath: node_path.default.relative(workspaceRoot, storyFilePath),
+				storyExport: input.storyExport
+			},
+			sourceFingerprint: (0, node_crypto.createHash)("sha256").update(source).digest("hex"),
+			html
+		};
+	}
+	async dispose(handle) {
+		const preview = this.previews.get(handle);
+		if (!preview) return false;
+		this.previews.delete(handle);
+		await node_fs.promises.rm(preview.artifactDirectory, {
+			recursive: true,
+			force: true
+		});
+		return true;
+	}
+	async disposeAll() {
+		await Promise.all([...this.previews.keys()].map((handle) => this.dispose(handle)));
+	}
+	async resolveContainedPath(root, inputPath, field) {
+		if (!inputPath) throw new Error(`${field} is required`);
+		const candidate = node_path.default.isAbsolute(inputPath) ? inputPath : node_path.default.resolve(root, inputPath);
+		const canonical = await node_fs.promises.realpath(candidate);
+		if (!isContained(root, canonical)) throw new Error(`${field} must remain inside the workspace root`);
+		return canonical;
+	}
+};
+//#endregion
 exports.BaseBundlerService = require_stdio.BaseBundlerService;
 exports.BaseCSSClassesService = require_stdio.BaseCSSClassesService;
 Object.defineProperty(exports, "CSSClassesServiceFactory", {
@@ -60,6 +150,7 @@ Object.defineProperty(exports, "StoriesIndexService", {
 		return require_stdio.StoriesIndexService;
 	}
 });
+exports.StoryPreviewService = StoryPreviewService;
 Object.defineProperty(exports, "StyleSystemConfigLoader", {
 	enumerable: true,
 	get: function() {

package/dist/index.d.cts

@@ -201,8 +201,10 @@ interface ComponentInfo {
   fileHash: string;
   /** Tags from story meta */
   tags: string[];
-  /** Names of exported stories */
+  /** 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 */
@@ -260,6 +262,7 @@ interface InitializationResult {
 }
 declare class StoriesIndexService {
   private componentIndex;
+  private componentFileIndex;
   private monorepoRoot;
   private initialized;
   /** Last initialization result for error reporting */
@@ -289,6 +292,7 @@ declare class StoriesIndexService {
    * 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.
@@ -330,6 +334,8 @@ declare class StoriesIndexService {
    * @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
@@ -1036,6 +1042,54 @@ declare class GetUiComponentService {
   private readStoryFile;
 }
 //#endregion
+//#region src/services/StoryPreviewService/types.d.ts
+interface StoryPreviewInput {
+  /** Project directory, relative to the workspace root or absolute. */
+  appPath: string;
+  /** Story file, relative to the workspace root or absolute. */
+  storyFilePath: string;
+  /** Exact named export to render. */
+  storyExport: string;
+  args?: Record<string, unknown>;
+  darkMode?: boolean;
+}
+interface StoryPreviewIdentity {
+  /** Canonical workspace-relative story file path. */
+  storyFilePath: string;
+  /** Exact named export rendered from the story file. */
+  storyExport: string;
+}
+interface StoryPreviewResult {
+  /** Opaque identifier used to dispose this owned artifact. */
+  handle: string;
+  identity: StoryPreviewIdentity;
+  /** SHA-256 fingerprint of the story source used for this build. */
+  sourceFingerprint: string;
+  /** Self-contained HTML produced by the configured style-system bundler. */
+  html: string;
+}
+interface StoryPreviewServiceOptions {
+  workspaceRoot?: string;
+  storiesIndexFactory?: (workspaceRoot: string, storyFilePath: string) => StoriesIndexService;
+  configLoader?: (appPath: string) => Promise<DesignSystemConfig>;
+  bundlerFactory?: (config: DesignSystemConfig) => BaseBundlerService;
+}
+//#endregion
+//#region src/services/StoryPreviewService/StoryPreviewService.d.ts
+/** Builds and owns disposable, self-contained HTML previews for exact story exports. */
+declare class StoryPreviewService {
+  private readonly workspaceRoot;
+  private readonly storiesIndexFactory;
+  private readonly configLoader;
+  private readonly bundlerFactory;
+  private readonly previews;
+  constructor(options?: StoryPreviewServiceOptions);
+  build(input: StoryPreviewInput): Promise<StoryPreviewResult>;
+  dispose(handle: string): Promise<boolean>;
+  disposeAll(): Promise<void>;
+  private resolveContainedPath;
+}
+//#endregion
 //#region src/services/ThemeService/types.d.ts
 /**
  * ThemeService Types
@@ -1956,4 +2010,4 @@ declare class StdioTransportHandler {
   stop(): Promise<void>;
 }
 //#endregion
-export { BaseBundlerService, BaseCSSClassesService, type CSSClassCategory, type CSSClassValue, type CSSClassesResult, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, type DesignSystemConfig, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, type OxlintRestrictedClassPattern, type OxlintRestrictedClassesConfig, PolishComponentTool, type ResolvedDesignSystemConfig, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, type StyleSystemConfig, StyleSystemConfigLoader, type StyleSystemModuleOptions, TailwindCSSClassesService, ThemeService, type Tool, type ToolDefinition, ViteReactBundlerService, createContainer, createDefaultBundlerService, createServer, createStyleSystemModule, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath };
+export { BaseBundlerService, BaseCSSClassesService, type CSSClassCategory, type CSSClassValue, type CSSClassesResult, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, type DesignSystemConfig, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, type OxlintRestrictedClassPattern, type OxlintRestrictedClassesConfig, PolishComponentTool, type ResolvedDesignSystemConfig, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, type StoryPreviewIdentity, type StoryPreviewInput, type StoryPreviewResult, StoryPreviewService, type StoryPreviewServiceOptions, type StyleSystemConfig, StyleSystemConfigLoader, type StyleSystemModuleOptions, TailwindCSSClassesService, ThemeService, type Tool, type ToolDefinition, ViteReactBundlerService, createContainer, createDefaultBundlerService, createServer, createStyleSystemModule, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath };

package/dist/index.d.mts

@@ -201,8 +201,10 @@ interface ComponentInfo {
   fileHash: string;
   /** Tags from story meta */
   tags: string[];
-  /** Names of exported stories */
+  /** 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 */
@@ -260,6 +262,7 @@ interface InitializationResult {
 }
 declare class StoriesIndexService {
   private componentIndex;
+  private componentFileIndex;
   private monorepoRoot;
   private initialized;
   /** Last initialization result for error reporting */
@@ -289,6 +292,7 @@ declare class StoriesIndexService {
    * 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.
@@ -330,6 +334,8 @@ declare class StoriesIndexService {
    * @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
@@ -1036,6 +1042,54 @@ declare class GetUiComponentService {
   private readStoryFile;
 }
 //#endregion
+//#region src/services/StoryPreviewService/types.d.ts
+interface StoryPreviewInput {
+  /** Project directory, relative to the workspace root or absolute. */
+  appPath: string;
+  /** Story file, relative to the workspace root or absolute. */
+  storyFilePath: string;
+  /** Exact named export to render. */
+  storyExport: string;
+  args?: Record<string, unknown>;
+  darkMode?: boolean;
+}
+interface StoryPreviewIdentity {
+  /** Canonical workspace-relative story file path. */
+  storyFilePath: string;
+  /** Exact named export rendered from the story file. */
+  storyExport: string;
+}
+interface StoryPreviewResult {
+  /** Opaque identifier used to dispose this owned artifact. */
+  handle: string;
+  identity: StoryPreviewIdentity;
+  /** SHA-256 fingerprint of the story source used for this build. */
+  sourceFingerprint: string;
+  /** Self-contained HTML produced by the configured style-system bundler. */
+  html: string;
+}
+interface StoryPreviewServiceOptions {
+  workspaceRoot?: string;
+  storiesIndexFactory?: (workspaceRoot: string, storyFilePath: string) => StoriesIndexService;
+  configLoader?: (appPath: string) => Promise<DesignSystemConfig>;
+  bundlerFactory?: (config: DesignSystemConfig) => BaseBundlerService;
+}
+//#endregion
+//#region src/services/StoryPreviewService/StoryPreviewService.d.ts
+/** Builds and owns disposable, self-contained HTML previews for exact story exports. */
+declare class StoryPreviewService {
+  private readonly workspaceRoot;
+  private readonly storiesIndexFactory;
+  private readonly configLoader;
+  private readonly bundlerFactory;
+  private readonly previews;
+  constructor(options?: StoryPreviewServiceOptions);
+  build(input: StoryPreviewInput): Promise<StoryPreviewResult>;
+  dispose(handle: string): Promise<boolean>;
+  disposeAll(): Promise<void>;
+  private resolveContainedPath;
+}
+//#endregion
 //#region src/services/ThemeService/types.d.ts
 /**
  * ThemeService Types
@@ -1956,4 +2010,4 @@ declare class StdioTransportHandler {
   stop(): Promise<void>;
 }
 //#endregion
-export { BaseBundlerService, BaseCSSClassesService, type CSSClassCategory, type CSSClassValue, type CSSClassesResult, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, type DesignSystemConfig, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, type OxlintRestrictedClassPattern, type OxlintRestrictedClassesConfig, PolishComponentTool, type ResolvedDesignSystemConfig, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, type StyleSystemConfig, StyleSystemConfigLoader, type StyleSystemModuleOptions, TailwindCSSClassesService, ThemeService, type Tool, type ToolDefinition, ViteReactBundlerService, createContainer, createDefaultBundlerService, createServer, createStyleSystemModule, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath };
+export { BaseBundlerService, BaseCSSClassesService, type CSSClassCategory, type CSSClassValue, type CSSClassesResult, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, type DesignSystemConfig, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, type OxlintRestrictedClassPattern, type OxlintRestrictedClassesConfig, PolishComponentTool, type ResolvedDesignSystemConfig, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, type StoryPreviewIdentity, type StoryPreviewInput, type StoryPreviewResult, StoryPreviewService, type StoryPreviewServiceOptions, type StyleSystemConfig, StyleSystemConfigLoader, type StyleSystemModuleOptions, TailwindCSSClassesService, ThemeService, type Tool, type ToolDefinition, ViteReactBundlerService, createContainer, createDefaultBundlerService, createServer, createStyleSystemModule, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath };

package/dist/index.mjs

@@ -1,2 +1,91 @@
-import { A as StoriesIndexService, C as getSharedComponentTags, D as StyleSystemConfigLoader, E as resolveAppDesignSystemConfig, M as DEFAULT_STYLE_SYSTEM_CONFIG, N as TailwindCSSClassesService, O as resolveStyleSystemThemePath, P as BaseCSSClassesService, S as getAppDesignSystemConfig, T as resetStyleSystemConfigCache, _ as ThemeService, b as ViteReactBundlerService, c as createStyleSystemModule, d as ListSharedComponentsTool, f as GetComponentVisualTool, g as ComponentRendererService, h as GetUiComponentService, i as createServer, j as CSSClassesServiceFactory, k as STYLE_SYSTEM_TYPES, l as PolishComponentTool, m as ListThemesTool, n as extractCustomTokenNames, p as GetCSSClassesTool, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler, u as ListAppComponentsTool, v as createDefaultBundlerService, w as hasStyleSystemProjectConfig, x as BaseBundlerService, y as getBundlerServiceFromConfig } from "./stdio-BDcQDFR-.mjs";
-export { BaseBundlerService, BaseCSSClassesService, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, PolishComponentTool, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, StyleSystemConfigLoader, TailwindCSSClassesService, ThemeService, ViteReactBundlerService, createContainer, createDefaultBundlerService, createServer, createStyleSystemModule, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath };
+import { A as STYLE_SYSTEM_TYPES, C as getAppDesignSystemConfig, D as resolveAppDesignSystemConfig, E as resetStyleSystemConfigCache, F as BaseCSSClassesService, I as TemplatesManagerService, M as CSSClassesServiceFactory, N as DEFAULT_STYLE_SYSTEM_CONFIG, O as StyleSystemConfigLoader, P as TailwindCSSClassesService, S as BaseBundlerService, T as hasStyleSystemProjectConfig, _ as ThemeService, b as getBundlerServiceFromConfig, c as createStyleSystemModule, d as ListSharedComponentsTool, f as GetComponentVisualTool, g as ComponentRendererService, h as GetUiComponentService, i as createServer, j as StoriesIndexService, k as resolveStyleSystemThemePath, l as PolishComponentTool, m as ListThemesTool, n as extractCustomTokenNames, p as GetCSSClassesTool, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler, u as ListAppComponentsTool, v as createDefaultBundlerService, w as getSharedComponentTags, x as ViteReactBundlerService, y as getBundlerService } from "./stdio-VllEe0CI.mjs";
+import { promises } from "node:fs";
+import path from "node:path";
+import { createHash, randomUUID } from "node:crypto";
+//#region src/services/StoryPreviewService/StoryPreviewService.ts
+const STORY_FILE_PATTERN = /\.stories\.(?:ts|tsx)$/;
+const STORY_EXPORT_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const UTF8_ENCODING = "utf8";
+function isContained(root, candidate) {
+	const relative = path.relative(root, candidate);
+	return relative === "" || !relative.startsWith(`..${path.sep}`) && relative !== ".." && !path.isAbsolute(relative);
+}
+/** Builds and owns disposable, self-contained HTML previews for exact story exports. */
+var StoryPreviewService = class {
+	workspaceRoot;
+	storiesIndexFactory;
+	configLoader;
+	bundlerFactory;
+	previews = /* @__PURE__ */ new Map();
+	constructor(options = {}) {
+		this.workspaceRoot = path.resolve(options.workspaceRoot ?? TemplatesManagerService.getWorkspaceRootSync());
+		this.storiesIndexFactory = options.storiesIndexFactory ?? ((workspaceRoot, storyFilePath) => new StoriesIndexService({
+			workspaceRoot,
+			storyFiles: [storyFilePath],
+			searchRoots: []
+		}));
+		this.configLoader = options.configLoader ?? getAppDesignSystemConfig;
+		this.bundlerFactory = options.bundlerFactory ?? ((config) => config.bundler ? getBundlerService(config.bundler) : createDefaultBundlerService());
+	}
+	async build(input) {
+		if (!STORY_EXPORT_PATTERN.test(input.storyExport)) throw new Error("storyExport must be an exact JavaScript named export");
+		const workspaceRoot = await promises.realpath(this.workspaceRoot);
+		const appPath = await this.resolveContainedPath(workspaceRoot, input.appPath, "appPath");
+		const storyFilePath = await this.resolveContainedPath(workspaceRoot, input.storyFilePath, "storyFilePath");
+		if (!STORY_FILE_PATTERN.test(storyFilePath)) throw new Error("storyFilePath must name a .stories.ts or .stories.tsx file");
+		const index = this.storiesIndexFactory(workspaceRoot, storyFilePath);
+		await index.initialize();
+		const component = index.getComponentByFilePath(storyFilePath);
+		if (!component) throw new Error(`Story file was not indexed: ${path.relative(workspaceRoot, storyFilePath)}`);
+		if (!component.storyExports.includes(input.storyExport)) throw new Error(`Story export "${input.storyExport}" was not found. Available exports: ${component.storyExports.join(", ")}`);
+		const [source, config] = await Promise.all([promises.readFile(storyFilePath, UTF8_ENCODING), this.configLoader(appPath)]);
+		const result = await this.bundlerFactory(config).prerenderComponent({
+			componentPath: storyFilePath,
+			storyName: input.storyExport,
+			args: input.args,
+			darkMode: input.darkMode,
+			appPath,
+			themePath: config.themeProvider,
+			cssFiles: config.cssFiles,
+			rootComponent: config.rootComponent,
+			unistylesConfig: config.unistylesConfig
+		});
+		const htmlFilePath = await promises.realpath(result.htmlFilePath);
+		const artifactDirectory = path.dirname(htmlFilePath);
+		if (!isContained(path.join(appPath, ".tmp"), artifactDirectory)) throw new Error("Bundler returned a preview artifact outside the project temporary directory");
+		const handle = randomUUID();
+		const html = await promises.readFile(htmlFilePath, UTF8_ENCODING);
+		this.previews.set(handle, { artifactDirectory });
+		return {
+			handle,
+			identity: {
+				storyFilePath: path.relative(workspaceRoot, storyFilePath),
+				storyExport: input.storyExport
+			},
+			sourceFingerprint: createHash("sha256").update(source).digest("hex"),
+			html
+		};
+	}
+	async dispose(handle) {
+		const preview = this.previews.get(handle);
+		if (!preview) return false;
+		this.previews.delete(handle);
+		await promises.rm(preview.artifactDirectory, {
+			recursive: true,
+			force: true
+		});
+		return true;
+	}
+	async disposeAll() {
+		await Promise.all([...this.previews.keys()].map((handle) => this.dispose(handle)));
+	}
+	async resolveContainedPath(root, inputPath, field) {
+		if (!inputPath) throw new Error(`${field} is required`);
+		const candidate = path.isAbsolute(inputPath) ? inputPath : path.resolve(root, inputPath);
+		const canonical = await promises.realpath(candidate);
+		if (!isContained(root, canonical)) throw new Error(`${field} must remain inside the workspace root`);
+		return canonical;
+	}
+};
+//#endregion
+export { BaseBundlerService, BaseCSSClassesService, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, PolishComponentTool, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, StoryPreviewService, StyleSystemConfigLoader, TailwindCSSClassesService, ThemeService, ViteReactBundlerService, createContainer, createDefaultBundlerService, createServer, createStyleSystemModule, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath };

package/dist/{stdio-BDcQDFR-.mjs → stdio-VllEe0CI.mjs}

@@ -863,6 +863,7 @@ const storyParseCache = /* @__PURE__ */ new Map();
 const storyParseInFlight = /* @__PURE__ */ new Map();
 let StoriesIndexService = class StoriesIndexService {
 	componentIndex = /* @__PURE__ */ new Map();
+	componentFileIndex = /* @__PURE__ */ new Map();
 	monorepoRoot;
 	initialized = false;
 	/** Last initialization result for error reporting */
@@ -956,7 +957,7 @@ let StoriesIndexService = class StoriesIndexService {
 		const fileHash = this.hashContent(content);
 		const cached = storyParseCache.get(filePath);
 		if (cached?.fileHash === fileHash) {
-			if (cached.component) this.componentIndex.set(cached.component.title, cached.component);
+			if (cached.component) this.storeComponent(cached.component);
 			return;
 		}
 		const inFlightKey = `${filePath}\u0000${fileHash}`;
@@ -976,7 +977,11 @@ let StoriesIndexService = class StoriesIndexService {
 			fileHash,
 			component
 		});
-		if (component) this.componentIndex.set(component.title, component);
+		if (component) this.storeComponent(component);
+	}
+	storeComponent(component) {
+		this.componentIndex.set(component.title, component);
+		this.componentFileIndex.set(path.resolve(component.filePath), component);
 	}
 	parseStoryFile(filePath, content, fileHash) {
 		const csf = loadCsf(content, {
@@ -989,6 +994,7 @@ let StoriesIndexService = class StoriesIndexService {
 			return null;
 		}
 		const stories = csf.stories.map((story) => story.name).filter((name) => !!name);
+		const storyExports = Object.keys(csf._storyExports);
 		const tags = Array.isArray(csf.meta.tags) ? csf.meta.tags.filter((tag) => typeof tag === "string") : [];
 		const description = this.extractDescription(content, csf.meta);
 		const meta = {
@@ -1001,6 +1007,7 @@ let StoriesIndexService = class StoriesIndexService {
 			fileHash,
 			tags,
 			stories,
+			storyExports,
 			meta,
 			description
 		};
@@ -1078,18 +1085,23 @@ let StoriesIndexService = class StoriesIndexService {
 		await this.indexStoryFile(filePath);
 		return true;
 	}
+	/** Get one indexed component by its canonical story file path. */
+	getComponentByFilePath(filePath) {
+		return this.componentFileIndex.get(path.resolve(filePath));
+	}
 	/**
 	* Get all indexed components
 	* @returns Array of all component info objects
 	*/
 	getAllComponents() {
-		return Array.from(this.componentIndex.values());
+		return Array.from(this.componentFileIndex.values());
 	}
 	/**
 	* Clear the index (useful for testing)
 	*/
 	clear() {
 		this.componentIndex.clear();
+		this.componentFileIndex.clear();
 		this.initialized = false;
 		this.lastInitResult = null;
 	}
@@ -5017,7 +5029,7 @@ function createContainer(options) {
 }
 //#endregion
 //#region package.json
-var version = "0.1.3";
+var version = "0.1.4";
 //#endregion
 //#region src/metadata.ts
 const STYLE_SYSTEM_CLI_NAME = "style-system";
@@ -5285,4 +5297,4 @@ var StdioTransportHandler = class {
 	}
 };
 //#endregion
-export { StoriesIndexService as A, getSharedComponentTags as C, StyleSystemConfigLoader as D, resolveAppDesignSystemConfig as E, log as F, DEFAULT_STYLE_SYSTEM_CONFIG as M, TailwindCSSClassesService as N, resolveStyleSystemThemePath as O, BaseCSSClassesService as P, getAppDesignSystemConfig as S, resetStyleSystemConfigCache as T, ThemeService as _, STYLE_SYSTEM_CLI_NAME as a, ViteReactBundlerService as b, createStyleSystemModule as c, ListSharedComponentsTool as d, GetComponentVisualTool as f, ComponentRendererService as g, GetUiComponentService as h, createServer as i, CSSClassesServiceFactory as j, STYLE_SYSTEM_TYPES as k, PolishComponentTool as l, ListThemesTool as m, extractCustomTokenNames as n, STYLE_SYSTEM_VERSION as o, GetCSSClassesTool as p, generateRestrictedClassesConfig as r, createContainer as s, StdioTransportHandler as t, ListAppComponentsTool as u, createDefaultBundlerService as v, hasStyleSystemProjectConfig as w, BaseBundlerService as x, getBundlerServiceFromConfig as y };
+export { STYLE_SYSTEM_TYPES as A, getAppDesignSystemConfig as C, resolveAppDesignSystemConfig as D, resetStyleSystemConfigCache as E, BaseCSSClassesService as F, TemplatesManagerService as I, log as L, CSSClassesServiceFactory as M, DEFAULT_STYLE_SYSTEM_CONFIG as N, StyleSystemConfigLoader as O, TailwindCSSClassesService as P, BaseBundlerService as S, hasStyleSystemProjectConfig as T, ThemeService as _, STYLE_SYSTEM_CLI_NAME as a, getBundlerServiceFromConfig as b, createStyleSystemModule as c, ListSharedComponentsTool as d, GetComponentVisualTool as f, ComponentRendererService as g, GetUiComponentService as h, createServer as i, StoriesIndexService as j, resolveStyleSystemThemePath as k, PolishComponentTool as l, ListThemesTool as m, extractCustomTokenNames as n, STYLE_SYSTEM_VERSION as o, GetCSSClassesTool as p, generateRestrictedClassesConfig as r, createContainer as s, StdioTransportHandler as t, ListAppComponentsTool as u, createDefaultBundlerService as v, getSharedComponentTags as w, ViteReactBundlerService as x, getBundlerService as y };

package/dist/{stdio-DSao01TL.cjs → stdio-WGt31vrr.cjs}

@@ -889,6 +889,7 @@ const storyParseCache = /* @__PURE__ */ new Map();
 const storyParseInFlight = /* @__PURE__ */ new Map();
 let StoriesIndexService = class StoriesIndexService {
 	componentIndex = /* @__PURE__ */ new Map();
+	componentFileIndex = /* @__PURE__ */ new Map();
 	monorepoRoot;
 	initialized = false;
 	/** Last initialization result for error reporting */
@@ -982,7 +983,7 @@ let StoriesIndexService = class StoriesIndexService {
 		const fileHash = this.hashContent(content);
 		const cached = storyParseCache.get(filePath);
 		if (cached?.fileHash === fileHash) {
-			if (cached.component) this.componentIndex.set(cached.component.title, cached.component);
+			if (cached.component) this.storeComponent(cached.component);
 			return;
 		}
 		const inFlightKey = `${filePath}\u0000${fileHash}`;
@@ -1002,7 +1003,11 @@ let StoriesIndexService = class StoriesIndexService {
 			fileHash,
 			component
 		});
-		if (component) this.componentIndex.set(component.title, component);
+		if (component) this.storeComponent(component);
+	}
+	storeComponent(component) {
+		this.componentIndex.set(component.title, component);
+		this.componentFileIndex.set(node_path.default.resolve(component.filePath), component);
 	}
 	parseStoryFile(filePath, content, fileHash) {
 		const csf = (0, storybook_internal_csf_tools.loadCsf)(content, {
@@ -1015,6 +1020,7 @@ let StoriesIndexService = class StoriesIndexService {
 			return null;
 		}
 		const stories = csf.stories.map((story) => story.name).filter((name) => !!name);
+		const storyExports = Object.keys(csf._storyExports);
 		const tags = Array.isArray(csf.meta.tags) ? csf.meta.tags.filter((tag) => typeof tag === "string") : [];
 		const description = this.extractDescription(content, csf.meta);
 		const meta = {
@@ -1027,6 +1033,7 @@ let StoriesIndexService = class StoriesIndexService {
 			fileHash,
 			tags,
 			stories,
+			storyExports,
 			meta,
 			description
 		};
@@ -1104,18 +1111,23 @@ let StoriesIndexService = class StoriesIndexService {
 		await this.indexStoryFile(filePath);
 		return true;
 	}
+	/** Get one indexed component by its canonical story file path. */
+	getComponentByFilePath(filePath) {
+		return this.componentFileIndex.get(node_path.default.resolve(filePath));
+	}
 	/**
 	* Get all indexed components
 	* @returns Array of all component info objects
 	*/
 	getAllComponents() {
-		return Array.from(this.componentIndex.values());
+		return Array.from(this.componentFileIndex.values());
 	}
 	/**
 	* Clear the index (useful for testing)
 	*/
 	clear() {
 		this.componentIndex.clear();
+		this.componentFileIndex.clear();
 		this.initialized = false;
 		this.lastInitResult = null;
 	}
@@ -5043,7 +5055,7 @@ function createContainer(options) {
 }
 //#endregion
 //#region package.json
-var version = "0.1.3";
+var version = "0.1.4";
 //#endregion
 //#region src/metadata.ts
 const STYLE_SYSTEM_CLI_NAME = "style-system";
@@ -5425,6 +5437,12 @@ Object.defineProperty(exports, "TailwindCSSClassesService", {
 		return TailwindCSSClassesService;
 	}
 });
+Object.defineProperty(exports, "TemplatesManagerService", {
+	enumerable: true,
+	get: function() {
+		return TemplatesManagerService;
+	}
+});
 Object.defineProperty(exports, "ThemeService", {
 	enumerable: true,
 	get: function() {
@@ -5485,6 +5503,12 @@ Object.defineProperty(exports, "getAppDesignSystemConfig", {
 		return getAppDesignSystemConfig;
 	}
 });
+Object.defineProperty(exports, "getBundlerService", {
+	enumerable: true,
+	get: function() {
+		return getBundlerService;
+	}
+});
 Object.defineProperty(exports, "getBundlerServiceFromConfig", {
 	enumerable: true,
 	get: function() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/style-system",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "MCP server for exploring themes, Tailwind CSS classes, and UI components from Storybook with standalone component rendering capabilities",
   "keywords": [
     "design-system",
@@ -60,7 +60,7 @@
     "tailwindcss": "4.3.3",
     "vite": "8.1.5",
     "vite-plugin-singlefile": "^2.3.3",
-    "@agimon-ai/foundation-exec": "0.26.26"
+    "@agimon-ai/foundation-exec": "0.26.27"
   },
   "devDependencies": {
     "@babel/parser": "8.0.0",