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

package/LICENSE

@@ -1,21 +1,149 @@
-MIT License
-
-Copyright (c) 2026 Vuong Ngo
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+License text copyright © 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             Agimon Pty Ltd
+Licensed Work:        Po, the software in the Po source repository and the
+                      packages released from it, in each version released by
+                      the Licensor.
+                      The Licensed Work is (c) 2026 Agimon Pty Ltd.
+                      Material identified as third-party in the "Third-party
+                      components" section at the end of this file or in a
+                      NOTICE file, and any package or directory whose own
+                      license file grants a different license, is not part of
+                      the Licensed Work and remains under its own license.
+Additional Use Grant: You may make production use of the Licensed Work if
+  your use is Eligible Use. "Eligible Use" is production use that falls
+  within at least one of the following:
+
+  (a) Personal Use. Use by an individual for their own personal purposes,
+      and not on behalf of, or for the benefit of, an employer, client, or
+      other Organization. Use by an individual in the course of employment
+      or engagement by an Organization is use by that Organization.
+
+  (b) Small Organization Use. Use by or on behalf of an Organization whose
+      Annual Revenue is less than USD 1,000,000.
+
+  (c) Non-profit, Education and Research Use. Use, regardless of Annual
+      Revenue, by (i) an Organization registered or recognized as a
+      non-profit or charitable organization under the laws of its
+      jurisdiction, for its non-profit purposes; (ii) an accredited school,
+      college, or university, for teaching, learning, or academic research;
+      or (iii) a publicly funded research institution, for its research.
+
+  (d) Service Provider Use. Use by a consultant, contractor, agency, or other
+      service provider, regardless of its own Annual Revenue, solely to
+      build, deploy, host, operate, or support the Licensed Work for a client
+      whose own use would be Eligible Use under (a), (b), or (c). A service
+      provider's use for its own purposes is Eligible Use only if the service
+      provider itself qualifies under (b) or (c).
+
+
+  Hosted services. Offering the Licensed Work to third parties as a hosted
+  or managed service whose primary value is the Licensed Work is Eligible
+  Use only if each such third party's own use would be Eligible Use.
+
+  Definitions. "Organization" means any company, partnership, sole
+  proprietorship, trust, association, government body, or other entity, and
+  includes an individual acting in a business or professional capacity.
+  "Affiliate" means any entity that directly or indirectly controls, is
+  controlled by, or is under common control with an Organization, where
+  "control" means ownership of more than 50% of the voting interests of an
+  entity or the power to direct its management and policies by contract or
+  otherwise. "Annual Revenue" means the total gross revenue of an
+  Organization and all of its Affiliates combined, from all sources and
+  whether or not related to the Licensed Work, for its most recently
+  completed fiscal year, or, if it has not completed a fiscal year, for the
+  twelve months before the use (or since its formation, if shorter),
+  converted into US dollars at the average exchange rate for that period.
+  Proceeds of equity or debt financing are not revenue.
+
+  Threshold. If an Organization stops qualifying under (b), its existing
+  production use remains Eligible Use for 90 days after it stops
+  qualifying, after which it must obtain a commercial license or stop
+  production use. Use that was Eligible Use when it occurred never requires
+  a commercial license after the fact.
+Change Date:          Four years from the date a version of the Licensed Work
+                      is first publicly released by the Licensor.
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed
+Work, please visit: https://agimon.ai/licensing
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+-----------------------------------------------------------------------------
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN “AS IS” BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License’s text to license
+your works, and to refer to it using the trademark “Business Source License”,
+as long as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License’s text and the “Business
+Source License” name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where “compatible” means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text “None”.
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -146,4 +146,4 @@ these commands.
 
 ## License
 
-MIT
+Business Source License 1.1: free for personal use, organisations under USD 1M revenue, non-profits and education. See [LICENSE](LICENSE) and https://agimon.ai/licensing.

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_stdio = require("./stdio-CT9XjOJQ.cjs");
+const require_stdio = require("./stdio-BiO1Kn_N.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_stdio.__toESM(node_path, 1);
@@ -138,7 +138,8 @@ const REQUESTABLE_COLOR_SCHEMES = [LIGHT_COLOR_SCHEME, DARK_COLOR_SCHEME];
 const getUiComponentCommand = new commander.Command("get-ui-component").description("Get a screenshot of a UI component rendered with app-specific design system configuration. Returns screenshot path and story file content.").requiredOption("-c, --component-name <name>", "The name of the component to capture (e.g., \"Button\", \"Card\")").requiredOption("-a, --app-path <path>", "The app path (relative or absolute) to load design system config from (e.g., \"apps/agiflow-app\")").option("-s, --story-name <name>", "The story name to render (e.g., \"Playground\", \"Default\")", "Playground").option("-d, --dark-mode", "Request dark mode for automatic-theme apps").option("--color-scheme <scheme>", "Request light or dark mode for automatic-theme apps").option("--width <pixels>", "Override the configured viewport width", Number).option("--height <pixels>", "Override the configured viewport height", Number).action(async (options) => {
 	try {
 		if (options.colorScheme !== void 0 && !REQUESTABLE_COLOR_SCHEMES.includes(options.colorScheme)) throw new Error("--color-scheme must be light or dark");
-		const tool = require_stdio.createContainer().get(require_stdio.STYLE_SYSTEM_TYPES.GetComponentVisualTool);
+		const sessionTemp = process.env.PO_SESSION_TEMP_DIR;
+		const tool = require_stdio.createContainer({ temporaryDirectory: sessionTemp ? (0, node_path.join)(sessionTemp, "previews") : void 0 }).get(require_stdio.STYLE_SYSTEM_TYPES.GetComponentVisualTool);
 		const darkMode = options.colorScheme === DARK_COLOR_SCHEME ? true : options.colorScheme === LIGHT_COLOR_SCHEME ? false : options.darkMode || void 0;
 		const result = await tool.execute({
 			componentName: options.componentName,
@@ -405,7 +406,11 @@ const mcpServeCommand = new commander.Command("mcp-serve").description("Start MC
 			console.error(`Dev server started at ${url} (port: ${port})`);
 		}
 		if (transportType === "stdio") {
-			const container = require_stdio.createContainer({ defaultThemePath: parsed.themePath });
+			const sessionTemp = process.env.PO_SESSION_TEMP_DIR;
+			const container = require_stdio.createContainer({
+				defaultThemePath: parsed.themePath,
+				temporaryDirectory: sessionTemp ? (0, node_path.join)(sessionTemp, "previews") : void 0
+			});
 			await startServer(new require_stdio.StdioTransportHandler(() => require_stdio.createServer(container)), bundlerService, devServerPort);
 		} else if (transportType === "http" && parsed.port !== void 0) {
 			const container = require_stdio.createContainer({ defaultThemePath: parsed.themePath });

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { A as STYLE_SYSTEM_TYPES, C as getAppDesignSystemConfig, N as DEFAULT_STYLE_SYSTEM_CONFIG, P as TailwindCSSClassesService, R as log, a as STYLE_SYSTEM_CLI_NAME, b as getBundlerServiceFromConfig, i as createServer$1, k as resolveStyleSystemThemePath, o as STYLE_SYSTEM_VERSION, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler } from "./stdio-Dgaj2-_8.mjs";
+import { A as STYLE_SYSTEM_TYPES, C as getAppDesignSystemConfig, N as DEFAULT_STYLE_SYSTEM_CONFIG, P as TailwindCSSClassesService, R as log, a as STYLE_SYSTEM_CLI_NAME, b as getBundlerServiceFromConfig, i as createServer$1, k as resolveStyleSystemThemePath, o as STYLE_SYSTEM_VERSION, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler } from "./stdio-B2oCIjrt.mjs";
 import { promises } from "node:fs";
-import path from "node:path";
+import path, { join } from "node:path";
 import { z } from "zod";
 import { registerManagedProcess } from "@agimon-ai/foundation-exec";
 import { createMcpHandler } from "@modelcontextprotocol/server";
@@ -136,7 +136,8 @@ const REQUESTABLE_COLOR_SCHEMES = [LIGHT_COLOR_SCHEME, DARK_COLOR_SCHEME];
 const getUiComponentCommand = new Command("get-ui-component").description("Get a screenshot of a UI component rendered with app-specific design system configuration. Returns screenshot path and story file content.").requiredOption("-c, --component-name <name>", "The name of the component to capture (e.g., \"Button\", \"Card\")").requiredOption("-a, --app-path <path>", "The app path (relative or absolute) to load design system config from (e.g., \"apps/agiflow-app\")").option("-s, --story-name <name>", "The story name to render (e.g., \"Playground\", \"Default\")", "Playground").option("-d, --dark-mode", "Request dark mode for automatic-theme apps").option("--color-scheme <scheme>", "Request light or dark mode for automatic-theme apps").option("--width <pixels>", "Override the configured viewport width", Number).option("--height <pixels>", "Override the configured viewport height", Number).action(async (options) => {
 	try {
 		if (options.colorScheme !== void 0 && !REQUESTABLE_COLOR_SCHEMES.includes(options.colorScheme)) throw new Error("--color-scheme must be light or dark");
-		const tool = createContainer().get(STYLE_SYSTEM_TYPES.GetComponentVisualTool);
+		const sessionTemp = process.env.PO_SESSION_TEMP_DIR;
+		const tool = createContainer({ temporaryDirectory: sessionTemp ? join(sessionTemp, "previews") : void 0 }).get(STYLE_SYSTEM_TYPES.GetComponentVisualTool);
 		const darkMode = options.colorScheme === DARK_COLOR_SCHEME ? true : options.colorScheme === LIGHT_COLOR_SCHEME ? false : options.darkMode || void 0;
 		const result = await tool.execute({
 			componentName: options.componentName,
@@ -403,7 +404,11 @@ const mcpServeCommand = new Command("mcp-serve").description("Start MCP server w
 			console.error(`Dev server started at ${url} (port: ${port})`);
 		}
 		if (transportType === "stdio") {
-			const container = createContainer({ defaultThemePath: parsed.themePath });
+			const sessionTemp = process.env.PO_SESSION_TEMP_DIR;
+			const container = createContainer({
+				defaultThemePath: parsed.themePath,
+				temporaryDirectory: sessionTemp ? join(sessionTemp, "previews") : void 0
+			});
 			await startServer(new StdioTransportHandler(() => createServer$1(container)), bundlerService, devServerPort);
 		} else if (transportType === "http" && parsed.port !== void 0) {
 			const container = createContainer({ defaultThemePath: parsed.themePath });

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-CT9XjOJQ.cjs");
+const require_stdio = require("./stdio-BiO1Kn_N.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_stdio.__toESM(node_path, 1);

package/dist/index.d.cts

@@ -5,6 +5,7 @@ import { AliasOptions, Plugin, UserConfig } from "vite";
 //#region src/container/module.d.ts
 interface StyleSystemModuleOptions {
   defaultThemePath?: string;
+  temporaryDirectory?: string;
 }
 export declare function createStyleSystemModule(optionsInput?: StyleSystemModuleOptions): ContainerModule;
 //#endregion
@@ -863,6 +864,8 @@ export declare class ComponentRendererService {
   private themeService;
   private appPath;
   private bundlerFactory;
+  private log;
+  private readonly preserveOutput;
   /**
    * Creates a new ComponentRendererService instance
    * @param designSystemConfig - Design system configuration
@@ -871,6 +874,7 @@ export declare class ComponentRendererService {
    */
   constructor(designSystemConfig: DesignSystemConfig, appPath: string, options?: {
     bundlerFactory?: BundlerFactory;
+    temporaryDirectory?: string;
   });
   /**
    * Get the bundler service instance.

package/dist/index.d.mts

@@ -5,6 +5,7 @@ import { AliasOptions, Plugin, UserConfig } from "vite";
 //#region src/container/module.d.ts
 interface StyleSystemModuleOptions {
   defaultThemePath?: string;
+  temporaryDirectory?: string;
 }
 export declare function createStyleSystemModule(optionsInput?: StyleSystemModuleOptions): ContainerModule;
 //#endregion
@@ -863,6 +864,8 @@ export declare class ComponentRendererService {
   private themeService;
   private appPath;
   private bundlerFactory;
+  private log;
+  private readonly preserveOutput;
   /**
    * Creates a new ComponentRendererService instance
    * @param designSystemConfig - Design system configuration
@@ -871,6 +874,7 @@ export declare class ComponentRendererService {
    */
   constructor(designSystemConfig: DesignSystemConfig, appPath: string, options?: {
     bundlerFactory?: BundlerFactory;
+    temporaryDirectory?: string;
   });
   /**
    * Get the bundler service instance.

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as STYLE_SYSTEM_TYPES, C as getAppDesignSystemConfig, D as resolveAppDesignSystemConfig, E as resetStyleSystemConfigCache, F as BaseCSSClassesService, I as TemplatesManagerService, L as isContained, 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-Dgaj2-_8.mjs";
+import { A as STYLE_SYSTEM_TYPES, C as getAppDesignSystemConfig, D as resolveAppDesignSystemConfig, E as resetStyleSystemConfigCache, F as BaseCSSClassesService, I as TemplatesManagerService, L as isContained, 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-B2oCIjrt.mjs";
 import { promises } from "node:fs";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";

package/dist/{stdio-Dgaj2-_8.mjs → stdio-B2oCIjrt.mjs}

@@ -95,12 +95,23 @@ const logger = pino({
 	mkdir: true,
 	sync: true
 }));
-const log = {
-	debug: (msg, ...args) => logger.debug({ args }, msg),
-	info: (msg, ...args) => logger.info({ args }, msg),
-	warn: (msg, ...args) => logger.warn({ args }, msg),
-	error: (msg, ...args) => logger.error({ args }, msg)
-};
+function createLog(directory) {
+	const target = directory === void 0 ? logger : pino({
+		level: "debug",
+		timestamp: pino.stdTimeFunctions.isoTime
+	}, pino.destination({
+		dest: path$1.join(directory, "style-system.log"),
+		mkdir: true,
+		sync: true
+	}));
+	return {
+		debug: (msg, ...args) => target.debug({ args }, msg),
+		info: (msg, ...args) => target.info({ args }, msg),
+		warn: (msg, ...args) => target.warn({ args }, msg),
+		error: (msg, ...args) => target.error({ args }, msg)
+	};
+}
+const log = createLog();
 //#endregion
 //#region src/utils/fsHelpers.ts
 /** True when candidate is root itself or inside it (sibling prefixes like `<root>-evil` are outside). */
@@ -3379,6 +3390,8 @@ var ComponentRendererService = class ComponentRendererService {
 	themeService;
 	appPath;
 	bundlerFactory;
+	log;
+	preserveOutput;
 	/**
 	* Creates a new ComponentRendererService instance
 	* @param designSystemConfig - Design system configuration
@@ -3388,7 +3401,10 @@ var ComponentRendererService = class ComponentRendererService {
 	constructor(designSystemConfig, appPath, options = {}) {
 		if (!appPath) throw new Error("appPath is required for ComponentRendererService");
 		this.appPath = appPath;
-		this.tmpDir = path.join(os.tmpdir(), "style-system");
+		this.tmpDir = options.temporaryDirectory ?? path.join(os.tmpdir(), "style-system");
+		this.preserveOutput = options.temporaryDirectory !== void 0;
+		if (options.temporaryDirectory !== void 0 && !path.isAbsolute(options.temporaryDirectory)) throw new Error("Renderer temporary directory must be absolute.");
+		this.log = log;
 		this.themeService = new ThemeService(designSystemConfig);
 		if (options.bundlerFactory) this.bundlerFactory = options.bundlerFactory;
 		else if (designSystemConfig.bundler) this.bundlerFactory = () => getBundlerService(designSystemConfig.bundler);
@@ -3412,17 +3428,25 @@ var ComponentRendererService = class ComponentRendererService {
 	async renderComponent(componentInfo, options = {}) {
 		const { storyName = componentInfo.stories[0] || "Default", args = {}, darkMode = false, width = DEFAULT_RENDER_WIDTH, height = DEFAULT_RENDER_HEIGHT } = options;
 		try {
-			log.info(`[ComponentRendererService] Rendering ${componentInfo.title} - ${storyName}`);
-			await promises.mkdir(this.tmpDir, { recursive: true });
+			await promises.mkdir(this.tmpDir, {
+				recursive: true,
+				mode: 448
+			});
+			if (this.preserveOutput) {
+				const info = await promises.lstat(this.tmpDir);
+				if (!info.isDirectory() || info.isSymbolicLink() || await promises.realpath(this.tmpDir) !== this.tmpDir) throw new Error("Unsafe renderer temporary directory.");
+				if (this.log === log) this.log = createLog(this.tmpDir);
+			}
+			this.log.info(`[ComponentRendererService] Rendering ${componentInfo.title} - ${storyName}`);
 			const designSystemConfig = this.themeService.getConfig();
-			log.info(`[ComponentRendererService] Using theme provider: ${designSystemConfig.themeProvider}`);
-			log.info(`[ComponentRendererService] Design system type: ${designSystemConfig.type}`);
-			if (!await this.themeService.validateThemeProvider()) log.warn(`[ComponentRendererService] Theme provider path may not exist: ${designSystemConfig.themeProvider}`);
+			this.log.info(`[ComponentRendererService] Using theme provider: ${designSystemConfig.themeProvider}`);
+			this.log.info(`[ComponentRendererService] Design system type: ${designSystemConfig.type}`);
+			if (!await this.themeService.validateThemeProvider()) this.log.warn(`[ComponentRendererService] Theme provider path may not exist: ${designSystemConfig.themeProvider}`);
 			const bundlerService = this.getBundlerService();
 			let componentUrl;
 			let htmlFilePath;
 			if (bundlerService.isServerRunning()) {
-				log.info("[ComponentRendererService] Using dev server for fast rendering");
+				this.log.info("[ComponentRendererService] Using dev server for fast rendering");
 				try {
 					const result = await bundlerService.serveComponent({
 						componentPath: componentInfo.filePath,
@@ -3437,9 +3461,9 @@ var ComponentRendererService = class ComponentRendererService {
 					});
 					componentUrl = result.url;
 					htmlFilePath = result.htmlFilePath;
-					log.info(`[ComponentRendererService] Component served at: ${componentUrl}`);
+					this.log.info(`[ComponentRendererService] Component served at: ${componentUrl}`);
 				} catch (devServerError) {
-					log.warn(`[ComponentRendererService] Dev server failed, falling back to static build: ${devServerError instanceof Error ? devServerError.message : String(devServerError)}`);
+					this.log.warn(`[ComponentRendererService] Dev server failed, falling back to static build: ${devServerError instanceof Error ? devServerError.message : String(devServerError)}`);
 					const result = await bundlerService.prerenderComponent({
 						componentPath: componentInfo.filePath,
 						storyName,
@@ -3453,10 +3477,10 @@ var ComponentRendererService = class ComponentRendererService {
 					});
 					componentUrl = `${FILE_URL_PREFIX}${result.htmlFilePath}`;
 					htmlFilePath = result.htmlFilePath;
-					log.info(`[ComponentRendererService] HTML built to: ${htmlFilePath}`);
+					this.log.info(`[ComponentRendererService] HTML built to: ${htmlFilePath}`);
 				}
 			} else {
-				log.info("[ComponentRendererService] No dev server running, using static build");
+				this.log.info("[ComponentRendererService] No dev server running, using static build");
 				const result = await bundlerService.prerenderComponent({
 					componentPath: componentInfo.filePath,
 					storyName,
@@ -3470,7 +3494,7 @@ var ComponentRendererService = class ComponentRendererService {
 				});
 				componentUrl = `${FILE_URL_PREFIX}${result.htmlFilePath}`;
 				htmlFilePath = result.htmlFilePath;
-				log.info(`[ComponentRendererService] HTML built to: ${htmlFilePath}`);
+				this.log.info(`[ComponentRendererService] HTML built to: ${htmlFilePath}`);
 			}
 			const timestamp = Date.now();
 			const imageName = `${COMPONENT_FILE_PREFIX}${componentInfo.title.split("/").pop()}-${timestamp}-${randomUUID()}.png`;
@@ -3488,12 +3512,12 @@ var ComponentRendererService = class ComponentRendererService {
 				generateThumbnail: false,
 				base64: false
 			});
-			log.info(`[ComponentRendererService] Screenshot saved to: ${imagePath}`);
+			this.log.info(`[ComponentRendererService] Screenshot saved to: ${imagePath}`);
 			let html = "";
 			if (htmlFilePath) {
 				html = await promises.readFile(htmlFilePath, "utf-8");
-				log.info(`[ComponentRendererService] HTML file kept at: ${htmlFilePath}`);
-			} else log.warn("[ComponentRendererService] No HTML file path available, returning empty HTML content");
+				this.log.info(`[ComponentRendererService] HTML file kept at: ${htmlFilePath}`);
+			} else this.log.warn("[ComponentRendererService] No HTML file path available, returning empty HTML content");
 			return {
 				imagePath,
 				html,
@@ -3536,20 +3560,20 @@ var ComponentRendererService = class ComponentRendererService {
 				};
 			}));
 			for (const result of statResults) if (result.status === "fulfilled") componentFiles.push(result.value);
-			else log.warn("[ComponentRendererService] Failed to inspect component file during cleanup:", result.reason);
+			else this.log.warn("[ComponentRendererService] Failed to inspect component file during cleanup:", result.reason);
 			const oldFiles = componentFiles.filter((f) => now - f.mtime > olderThanMs);
-			await Promise.all(oldFiles.map((file) => promises.unlink(file.path).catch((err) => log.warn("[ComponentRendererService] Failed to delete file:", file.path, err))));
+			await Promise.all(oldFiles.map((file) => promises.unlink(file.path).catch((err) => this.log.warn("[ComponentRendererService] Failed to delete file:", file.path, err))));
 			let deletedCount = oldFiles.length;
 			const remainingFiles = componentFiles.filter((f) => now - f.mtime <= olderThanMs);
 			if (remainingFiles.length > keepCount) {
 				remainingFiles.sort((a, b) => a.mtime - b.mtime);
 				const toDelete = remainingFiles.slice(0, remainingFiles.length - keepCount);
-				await Promise.all(toDelete.map((file) => promises.unlink(file.path).catch((err) => log.warn("[ComponentRendererService] Failed to delete file:", file.path, err))));
+				await Promise.all(toDelete.map((file) => promises.unlink(file.path).catch((err) => this.log.warn("[ComponentRendererService] Failed to delete file:", file.path, err))));
 				deletedCount += toDelete.length;
 			}
-			if (deletedCount > 0) log.info(`[ComponentRendererService] Cleaned up ${deletedCount} temp files`);
+			if (deletedCount > 0) this.log.info(`[ComponentRendererService] Cleaned up ${deletedCount} temp files`);
 		} catch (error) {
-			log.error("[ComponentRendererService] Cleanup error:", error);
+			this.log.error("[ComponentRendererService] Cleanup error:", error);
 		}
 	}
 	/**
@@ -3559,11 +3583,11 @@ var ComponentRendererService = class ComponentRendererService {
 	*/
 	async dispose() {
 		try {
-			await this.cleanup(void 0, ComponentRendererService.DISPOSE_KEEP_COUNT);
+			if (!this.preserveOutput) await this.cleanup(void 0, ComponentRendererService.DISPOSE_KEEP_COUNT);
 			const bundlerService = this.getBundlerService();
 			if (!bundlerService.isServerRunning()) await bundlerService.cleanup();
 		} catch (error) {
-			log.error("[ComponentRendererService] Dispose error:", error);
+			this.log.error("[ComponentRendererService] Dispose error:", error);
 		}
 	}
 };
@@ -4950,7 +4974,7 @@ function createStyleSystemModule(optionsInput = {}) {
 		options.bind(STYLE_SYSTEM_TYPES.AppComponentsService).to(AppComponentsService).inTransientScope();
 		options.bind(STYLE_SYSTEM_TYPES.GetUiComponentService).to(GetUiComponentService).inSingletonScope();
 		options.bind(STYLE_SYSTEM_TYPES.StoriesIndexFactory).toConstantValue(() => new StoriesIndexService());
-		options.bind(STYLE_SYSTEM_TYPES.RendererFactory).toConstantValue((config, appPath) => new ComponentRendererService(config, appPath));
+		options.bind(STYLE_SYSTEM_TYPES.RendererFactory).toConstantValue((config, appPath) => new ComponentRendererService(config, appPath, { temporaryDirectory: optionsInput.temporaryDirectory }));
 		options.bind(STYLE_SYSTEM_TYPES.ListThemesTool).to(ListThemesTool).inSingletonScope();
 		options.bind(STYLE_SYSTEM_TYPES.GetCSSClassesTool).to(GetCSSClassesTool).inSingletonScope();
 		options.bind(STYLE_SYSTEM_TYPES.GetComponentVisualTool).to(GetComponentVisualTool).inSingletonScope();
@@ -4968,7 +4992,7 @@ function createContainer(options) {
 }
 //#endregion
 //#region package.json
-var version = "0.2.14-alpha.2";
+var version = "0.2.14-alpha.3";
 //#endregion
 //#region src/metadata.ts
 const STYLE_SYSTEM_CLI_NAME = "style-system";

package/dist/{stdio-CT9XjOJQ.cjs → stdio-BiO1Kn_N.cjs}

@@ -122,12 +122,23 @@ const logger = (0, pino.default)({
 	mkdir: true,
 	sync: true
 }));
-const log = {
-	debug: (msg, ...args) => logger.debug({ args }, msg),
-	info: (msg, ...args) => logger.info({ args }, msg),
-	warn: (msg, ...args) => logger.warn({ args }, msg),
-	error: (msg, ...args) => logger.error({ args }, msg)
-};
+function createLog(directory) {
+	const target = directory === void 0 ? logger : (0, pino.default)({
+		level: "debug",
+		timestamp: pino.default.stdTimeFunctions.isoTime
+	}, pino.default.destination({
+		dest: node_path.join(directory, "style-system.log"),
+		mkdir: true,
+		sync: true
+	}));
+	return {
+		debug: (msg, ...args) => target.debug({ args }, msg),
+		info: (msg, ...args) => target.info({ args }, msg),
+		warn: (msg, ...args) => target.warn({ args }, msg),
+		error: (msg, ...args) => target.error({ args }, msg)
+	};
+}
+const log = createLog();
 //#endregion
 //#region src/utils/fsHelpers.ts
 /** True when candidate is root itself or inside it (sibling prefixes like `<root>-evil` are outside). */
@@ -3406,6 +3417,8 @@ var ComponentRendererService = class ComponentRendererService {
 	themeService;
 	appPath;
 	bundlerFactory;
+	log;
+	preserveOutput;
 	/**
 	* Creates a new ComponentRendererService instance
 	* @param designSystemConfig - Design system configuration
@@ -3415,7 +3428,10 @@ var ComponentRendererService = class ComponentRendererService {
 	constructor(designSystemConfig, appPath, options = {}) {
 		if (!appPath) throw new Error("appPath is required for ComponentRendererService");
 		this.appPath = appPath;
-		this.tmpDir = node_path.default.join(node_os.default.tmpdir(), "style-system");
+		this.tmpDir = options.temporaryDirectory ?? node_path.default.join(node_os.default.tmpdir(), "style-system");
+		this.preserveOutput = options.temporaryDirectory !== void 0;
+		if (options.temporaryDirectory !== void 0 && !node_path.default.isAbsolute(options.temporaryDirectory)) throw new Error("Renderer temporary directory must be absolute.");
+		this.log = log;
 		this.themeService = new ThemeService(designSystemConfig);
 		if (options.bundlerFactory) this.bundlerFactory = options.bundlerFactory;
 		else if (designSystemConfig.bundler) this.bundlerFactory = () => getBundlerService(designSystemConfig.bundler);
@@ -3439,17 +3455,25 @@ var ComponentRendererService = class ComponentRendererService {
 	async renderComponent(componentInfo, options = {}) {
 		const { storyName = componentInfo.stories[0] || "Default", args = {}, darkMode = false, width = DEFAULT_RENDER_WIDTH, height = DEFAULT_RENDER_HEIGHT } = options;
 		try {
-			log.info(`[ComponentRendererService] Rendering ${componentInfo.title} - ${storyName}`);
-			await node_fs.promises.mkdir(this.tmpDir, { recursive: true });
+			await node_fs.promises.mkdir(this.tmpDir, {
+				recursive: true,
+				mode: 448
+			});
+			if (this.preserveOutput) {
+				const info = await node_fs.promises.lstat(this.tmpDir);
+				if (!info.isDirectory() || info.isSymbolicLink() || await node_fs.promises.realpath(this.tmpDir) !== this.tmpDir) throw new Error("Unsafe renderer temporary directory.");
+				if (this.log === log) this.log = createLog(this.tmpDir);
+			}
+			this.log.info(`[ComponentRendererService] Rendering ${componentInfo.title} - ${storyName}`);
 			const designSystemConfig = this.themeService.getConfig();
-			log.info(`[ComponentRendererService] Using theme provider: ${designSystemConfig.themeProvider}`);
-			log.info(`[ComponentRendererService] Design system type: ${designSystemConfig.type}`);
-			if (!await this.themeService.validateThemeProvider()) log.warn(`[ComponentRendererService] Theme provider path may not exist: ${designSystemConfig.themeProvider}`);
+			this.log.info(`[ComponentRendererService] Using theme provider: ${designSystemConfig.themeProvider}`);
+			this.log.info(`[ComponentRendererService] Design system type: ${designSystemConfig.type}`);
+			if (!await this.themeService.validateThemeProvider()) this.log.warn(`[ComponentRendererService] Theme provider path may not exist: ${designSystemConfig.themeProvider}`);
 			const bundlerService = this.getBundlerService();
 			let componentUrl;
 			let htmlFilePath;
 			if (bundlerService.isServerRunning()) {
-				log.info("[ComponentRendererService] Using dev server for fast rendering");
+				this.log.info("[ComponentRendererService] Using dev server for fast rendering");
 				try {
 					const result = await bundlerService.serveComponent({
 						componentPath: componentInfo.filePath,
@@ -3464,9 +3488,9 @@ var ComponentRendererService = class ComponentRendererService {
 					});
 					componentUrl = result.url;
 					htmlFilePath = result.htmlFilePath;
-					log.info(`[ComponentRendererService] Component served at: ${componentUrl}`);
+					this.log.info(`[ComponentRendererService] Component served at: ${componentUrl}`);
 				} catch (devServerError) {
-					log.warn(`[ComponentRendererService] Dev server failed, falling back to static build: ${devServerError instanceof Error ? devServerError.message : String(devServerError)}`);
+					this.log.warn(`[ComponentRendererService] Dev server failed, falling back to static build: ${devServerError instanceof Error ? devServerError.message : String(devServerError)}`);
 					const result = await bundlerService.prerenderComponent({
 						componentPath: componentInfo.filePath,
 						storyName,
@@ -3480,10 +3504,10 @@ var ComponentRendererService = class ComponentRendererService {
 					});
 					componentUrl = `${FILE_URL_PREFIX}${result.htmlFilePath}`;
 					htmlFilePath = result.htmlFilePath;
-					log.info(`[ComponentRendererService] HTML built to: ${htmlFilePath}`);
+					this.log.info(`[ComponentRendererService] HTML built to: ${htmlFilePath}`);
 				}
 			} else {
-				log.info("[ComponentRendererService] No dev server running, using static build");
+				this.log.info("[ComponentRendererService] No dev server running, using static build");
 				const result = await bundlerService.prerenderComponent({
 					componentPath: componentInfo.filePath,
 					storyName,
@@ -3497,7 +3521,7 @@ var ComponentRendererService = class ComponentRendererService {
 				});
 				componentUrl = `${FILE_URL_PREFIX}${result.htmlFilePath}`;
 				htmlFilePath = result.htmlFilePath;
-				log.info(`[ComponentRendererService] HTML built to: ${htmlFilePath}`);
+				this.log.info(`[ComponentRendererService] HTML built to: ${htmlFilePath}`);
 			}
 			const timestamp = Date.now();
 			const imageName = `${COMPONENT_FILE_PREFIX}${componentInfo.title.split("/").pop()}-${timestamp}-${(0, node_crypto.randomUUID)()}.png`;
@@ -3515,12 +3539,12 @@ var ComponentRendererService = class ComponentRendererService {
 				generateThumbnail: false,
 				base64: false
 			});
-			log.info(`[ComponentRendererService] Screenshot saved to: ${imagePath}`);
+			this.log.info(`[ComponentRendererService] Screenshot saved to: ${imagePath}`);
 			let html = "";
 			if (htmlFilePath) {
 				html = await node_fs.promises.readFile(htmlFilePath, "utf-8");
-				log.info(`[ComponentRendererService] HTML file kept at: ${htmlFilePath}`);
-			} else log.warn("[ComponentRendererService] No HTML file path available, returning empty HTML content");
+				this.log.info(`[ComponentRendererService] HTML file kept at: ${htmlFilePath}`);
+			} else this.log.warn("[ComponentRendererService] No HTML file path available, returning empty HTML content");
 			return {
 				imagePath,
 				html,
@@ -3563,20 +3587,20 @@ var ComponentRendererService = class ComponentRendererService {
 				};
 			}));
 			for (const result of statResults) if (result.status === "fulfilled") componentFiles.push(result.value);
-			else log.warn("[ComponentRendererService] Failed to inspect component file during cleanup:", result.reason);
+			else this.log.warn("[ComponentRendererService] Failed to inspect component file during cleanup:", result.reason);
 			const oldFiles = componentFiles.filter((f) => now - f.mtime > olderThanMs);
-			await Promise.all(oldFiles.map((file) => node_fs.promises.unlink(file.path).catch((err) => log.warn("[ComponentRendererService] Failed to delete file:", file.path, err))));
+			await Promise.all(oldFiles.map((file) => node_fs.promises.unlink(file.path).catch((err) => this.log.warn("[ComponentRendererService] Failed to delete file:", file.path, err))));
 			let deletedCount = oldFiles.length;
 			const remainingFiles = componentFiles.filter((f) => now - f.mtime <= olderThanMs);
 			if (remainingFiles.length > keepCount) {
 				remainingFiles.sort((a, b) => a.mtime - b.mtime);
 				const toDelete = remainingFiles.slice(0, remainingFiles.length - keepCount);
-				await Promise.all(toDelete.map((file) => node_fs.promises.unlink(file.path).catch((err) => log.warn("[ComponentRendererService] Failed to delete file:", file.path, err))));
+				await Promise.all(toDelete.map((file) => node_fs.promises.unlink(file.path).catch((err) => this.log.warn("[ComponentRendererService] Failed to delete file:", file.path, err))));
 				deletedCount += toDelete.length;
 			}
-			if (deletedCount > 0) log.info(`[ComponentRendererService] Cleaned up ${deletedCount} temp files`);
+			if (deletedCount > 0) this.log.info(`[ComponentRendererService] Cleaned up ${deletedCount} temp files`);
 		} catch (error) {
-			log.error("[ComponentRendererService] Cleanup error:", error);
+			this.log.error("[ComponentRendererService] Cleanup error:", error);
 		}
 	}
 	/**
@@ -3586,11 +3610,11 @@ var ComponentRendererService = class ComponentRendererService {
 	*/
 	async dispose() {
 		try {
-			await this.cleanup(void 0, ComponentRendererService.DISPOSE_KEEP_COUNT);
+			if (!this.preserveOutput) await this.cleanup(void 0, ComponentRendererService.DISPOSE_KEEP_COUNT);
 			const bundlerService = this.getBundlerService();
 			if (!bundlerService.isServerRunning()) await bundlerService.cleanup();
 		} catch (error) {
-			log.error("[ComponentRendererService] Dispose error:", error);
+			this.log.error("[ComponentRendererService] Dispose error:", error);
 		}
 	}
 };
@@ -4977,7 +5001,7 @@ function createStyleSystemModule(optionsInput = {}) {
 		options.bind(STYLE_SYSTEM_TYPES.AppComponentsService).to(AppComponentsService).inTransientScope();
 		options.bind(STYLE_SYSTEM_TYPES.GetUiComponentService).to(GetUiComponentService).inSingletonScope();
 		options.bind(STYLE_SYSTEM_TYPES.StoriesIndexFactory).toConstantValue(() => new StoriesIndexService());
-		options.bind(STYLE_SYSTEM_TYPES.RendererFactory).toConstantValue((config, appPath) => new ComponentRendererService(config, appPath));
+		options.bind(STYLE_SYSTEM_TYPES.RendererFactory).toConstantValue((config, appPath) => new ComponentRendererService(config, appPath, { temporaryDirectory: optionsInput.temporaryDirectory }));
 		options.bind(STYLE_SYSTEM_TYPES.ListThemesTool).to(ListThemesTool).inSingletonScope();
 		options.bind(STYLE_SYSTEM_TYPES.GetCSSClassesTool).to(GetCSSClassesTool).inSingletonScope();
 		options.bind(STYLE_SYSTEM_TYPES.GetComponentVisualTool).to(GetComponentVisualTool).inSingletonScope();
@@ -4995,7 +5019,7 @@ function createContainer(options) {
 }
 //#endregion
 //#region package.json
-var version = "0.2.14-alpha.2";
+var version = "0.2.14-alpha.3";
 //#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.2",
+  "version": "0.2.14-alpha.3",
   "description": "MCP server for exploring themes, Tailwind CSS classes, and UI components from Storybook with standalone component rendering capabilities",
   "keywords": [
     "design-system",
@@ -11,7 +11,7 @@
     "typescript"
   ],
   "homepage": "https://agimon.ai",
-  "license": "MIT",
+  "license": "BUSL-1.1",
   "author": "Vuong Ngo",
   "bin": {
     "po-style-system-tooling": "./dist/cli.mjs"