@agimon-ai/po-style-system-tooling 0.2.14-alpha.34 → 0.2.14-alpha.36

package/dist/cli.cjs

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

package/dist/cli.mjs

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

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_stdio = require("./stdio-fYe-kB4Q.cjs");
+const require_stdio = require("./stdio-CiZpPODk.cjs");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_stdio.__toESM(node_path, 1);
@@ -38,7 +38,8 @@ var StoryPreviewService = class {
 		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({
+		const bundler = this.bundlerFactory(config);
+		const result = await require_stdio.withRenderSlot(() => bundler.prerenderComponent({
 			componentPath: storyFilePath,
 			storyName: input.storyExport,
 			args: input.args,
@@ -48,7 +49,7 @@ var StoryPreviewService = class {
 			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);
 		const artifactRoot = node_path.default.join(appPath, ".tmp");
@@ -243,7 +244,7 @@ function createWarmStoryRenderer(options = {}) {
 		const bundler = await pending;
 		if (activeBundler && activeBundler !== bundler && activeBundler.isServerRunning()) await activeBundler.cleanup();
 		activeBundler = bundler;
-		const recycle = bundler.getBundlerId() === "vite" && captures >= 100;
+		const recycle = ["vite", "vite-react-native"].includes(bundler.getBundlerId()) && captures >= 100;
 		if (bundler.isServerRunning() && bundler.getCurrentAppPath() === resolved && !recycle) return;
 		if (bundler.isServerRunning()) await bundler.cleanup();
 		captures = 0;
@@ -253,7 +254,8 @@ function createWarmStoryRenderer(options = {}) {
 		const open = browser;
 		browser = void 0;
 		captures = 0;
-		await Promise.allSettled([open?.then((instance) => instance.close()), ...[...bundlers.values()].map((pending) => pending.then((bundler) => bundler.cleanup()))]);
+		const results = await Promise.allSettled([open?.then((instance) => instance.close()), ...[...bundlers.values()].map((pending) => pending.then((bundler) => bundler.cleanup()))]);
+		for (const result of results) if (result.status === "rejected") require_stdio.log.warn(`[WarmStoryRenderer] Reset failed to close a resource: ${result.reason}`);
 	};
 	const run = async (tool, input) => {
 		if (disposed) throw new Error("The story renderer is shut down.");
@@ -410,3 +412,4 @@ exports.launchBrowserWithFallback = require_stdio.launchBrowserWithFallback;
 exports.resetStyleSystemConfigCache = require_stdio.resetStyleSystemConfigCache;
 exports.resolveAppDesignSystemConfig = require_stdio.resolveAppDesignSystemConfig;
 exports.resolveStyleSystemThemePath = require_stdio.resolveStyleSystemThemePath;
+exports.withRenderSlot = require_stdio.withRenderSlot;

package/dist/index.d.cts

@@ -153,9 +153,23 @@ interface BrowserLease {
   browser: Browser;
   release(): void;
 }
+/** Renders a page outside Playwright, such as Po Desktop's Electron; returns the PNG as base64. */
+type PageCapture = (request: {
+  url: string;
+  width: number;
+  height: number;
+  fullPage: boolean;
+  darkMode: boolean;
+  mobile: boolean;
+  waitTime: number;
+}) => Promise<{
+  png: string;
+}>;
 interface ScreenshotOptions {
   /** A borrowed browser; release runs only after this render's context cleanup settles. */
   sharedBrowser?: () => Promise<Browser | BrowserLease>;
+  /** Used instead of a browser when set, except for thumbnails, which still need one. */
+  capturePage?: PageCapture;
   url: string;
   output: string;
   width?: number;
@@ -238,8 +252,8 @@ interface BuildOptions {
   rootComponent?: string;
   /** Path to native app Unistyles runtime configuration */
   unistylesConfig?: string;
-  /** Temporary directory for build artifacts */
-  tmpDir: string;
+  /** Absolute id of this render's virtual wrapper stylesheet */
+  wrapperCssPath: string;
 }
 /**
  * Result from starting a dev server.
@@ -392,6 +406,8 @@ export declare class ViteReactBundlerService extends BaseBundlerService {
   private storyConfigTimestamps;
   /** Promise that resolves when server startup completes, prevents race conditions */
   private serverStartPromise;
+  /** Virtual files of the running dev server */
+  private devStore;
   /**
    * Creates a new ViteReactBundlerService instance.
    * Use getInstance() for singleton access.
@@ -516,6 +532,13 @@ export declare class ViteReactBundlerService extends BaseBundlerService {
    * is in an unexpected state. Callers should not depend on cleanup failure detection.
    */
   cleanup(): Promise<void>;
+  private disposeDevStore;
+  /**
+   * Store the files one render reads: the wrapper CSS and snapshots of its declared sources.
+   * Transitive imports, nested CSS imports and node_modules are still read from disk.
+   * @returns Snapshotted source paths whose content changed
+   */
+  private snapshotRender;
   /**
    * Clean up stale story configs to prevent memory leaks.
    * Removes configs that are older than STORY_CONFIG_MAX_AGE_MS or
@@ -523,8 +546,9 @@ export declare class ViteReactBundlerService extends BaseBundlerService {
    */
   private cleanupStaleStoryConfigs;
   /**
-   * Generate a wrapper CSS file with @source directive for Tailwind v4.
-   * This tells Tailwind where to scan for class names when building from .tmp directory.
+   * Generate the wrapper CSS with @source directives for Tailwind v4.
+   * Stylesheets inside the app are snapshotted into it, so a render does not see later edits or a
+   * theme file removed mid-render; package and workspace stylesheets stay imports.
    * @param appPath - Absolute path to the app directory
    * @param cssFiles - Array of CSS file paths to import
    * @returns Generated CSS content with @source directive
@@ -653,6 +677,8 @@ interface StyleSystemModuleOptions {
   temporaryDirectory?: string;
   /** A browser a long-lived host keeps warm across renders; one-shot CLI runs leave it unset. */
   sharedBrowser?: ScreenshotOptions['sharedBrowser'];
+  /** A host renderer such as Po Desktop's Electron; preferred over the browser when set. */
+  capturePage?: ScreenshotOptions['capturePage'];
 }
 export declare function createStyleSystemModule(optionsInput?: StyleSystemModuleOptions): ContainerModule;
 //#endregion
@@ -945,6 +971,7 @@ export declare class ComponentRendererService {
   private log;
   private readonly preserveOutput;
   private readonly sharedBrowser;
+  private readonly capturePage;
   /**
    * Creates a new ComponentRendererService instance
    * @param designSystemConfig - Design system configuration
@@ -956,6 +983,7 @@ export declare class ComponentRendererService {
     workspaceRoot?: string;
     temporaryDirectory?: string;
     sharedBrowser?: ScreenshotOptions['sharedBrowser'];
+    capturePage?: ScreenshotOptions['capturePage'];
   });
   /**
    * Get the bundler service instance.
@@ -971,6 +999,7 @@ export declare class ComponentRendererService {
    * @throws Error if rendering fails
    */
   renderComponent(componentInfo: ComponentInfo, options?: RenderOptions): Promise<RenderResult>;
+  private renderInSlot;
   /**
    * Default maximum number of screenshot files to keep in temp directory.
    * Prevents disk space issues on long-running servers.
@@ -2086,6 +2115,10 @@ export declare class StdioTransportHandler {
   stop(): Promise<void>;
 }
 //#endregion
+//#region src/utils/renderSlots.d.ts
+/** Runs task once a render slot is free; slots are granted in arrival order. */
+export declare function withRenderSlot<T>(task: () => Promise<T>): Promise<T>;
+//#endregion
 //#region src/utils/storyBrowser.d.ts
 /** Server-owned Chrome. Each capture borrows it until its context cleanup settles. */
 export declare function createStoryBrowser(): {
@@ -2127,6 +2160,7 @@ export declare function createWarmStoryRenderer(options?: {
   workspaceRoot?: string;
   temporaryDirectory?: string;
   sharedBrowser?: ScreenshotOptions['sharedBrowser'];
+  capturePage?: ScreenshotOptions['capturePage'];
 }): WarmStoryRenderer;
 //#endregion
 export type { CSSClassCategory, CSSClassValue, CSSClassesResult, DesignSystemConfig, OxlintRestrictedClassPattern, OxlintRestrictedClassesConfig, ResolvedDesignSystemConfig, StoryPreviewIdentity, StoryPreviewInput, StoryPreviewResult, StoryPreviewServiceOptions, StyleSystemConfig, StyleSystemModuleOptions, Tool, ToolDefinition, WarmRendererResult, WarmRendererToolName, WarmStoryRenderer };

package/dist/index.d.mts

@@ -153,9 +153,23 @@ interface BrowserLease {
   browser: Browser;
   release(): void;
 }
+/** Renders a page outside Playwright, such as Po Desktop's Electron; returns the PNG as base64. */
+type PageCapture = (request: {
+  url: string;
+  width: number;
+  height: number;
+  fullPage: boolean;
+  darkMode: boolean;
+  mobile: boolean;
+  waitTime: number;
+}) => Promise<{
+  png: string;
+}>;
 interface ScreenshotOptions {
   /** A borrowed browser; release runs only after this render's context cleanup settles. */
   sharedBrowser?: () => Promise<Browser | BrowserLease>;
+  /** Used instead of a browser when set, except for thumbnails, which still need one. */
+  capturePage?: PageCapture;
   url: string;
   output: string;
   width?: number;
@@ -238,8 +252,8 @@ interface BuildOptions {
   rootComponent?: string;
   /** Path to native app Unistyles runtime configuration */
   unistylesConfig?: string;
-  /** Temporary directory for build artifacts */
-  tmpDir: string;
+  /** Absolute id of this render's virtual wrapper stylesheet */
+  wrapperCssPath: string;
 }
 /**
  * Result from starting a dev server.
@@ -392,6 +406,8 @@ export declare class ViteReactBundlerService extends BaseBundlerService {
   private storyConfigTimestamps;
   /** Promise that resolves when server startup completes, prevents race conditions */
   private serverStartPromise;
+  /** Virtual files of the running dev server */
+  private devStore;
   /**
    * Creates a new ViteReactBundlerService instance.
    * Use getInstance() for singleton access.
@@ -516,6 +532,13 @@ export declare class ViteReactBundlerService extends BaseBundlerService {
    * is in an unexpected state. Callers should not depend on cleanup failure detection.
    */
   cleanup(): Promise<void>;
+  private disposeDevStore;
+  /**
+   * Store the files one render reads: the wrapper CSS and snapshots of its declared sources.
+   * Transitive imports, nested CSS imports and node_modules are still read from disk.
+   * @returns Snapshotted source paths whose content changed
+   */
+  private snapshotRender;
   /**
    * Clean up stale story configs to prevent memory leaks.
    * Removes configs that are older than STORY_CONFIG_MAX_AGE_MS or
@@ -523,8 +546,9 @@ export declare class ViteReactBundlerService extends BaseBundlerService {
    */
   private cleanupStaleStoryConfigs;
   /**
-   * Generate a wrapper CSS file with @source directive for Tailwind v4.
-   * This tells Tailwind where to scan for class names when building from .tmp directory.
+   * Generate the wrapper CSS with @source directives for Tailwind v4.
+   * Stylesheets inside the app are snapshotted into it, so a render does not see later edits or a
+   * theme file removed mid-render; package and workspace stylesheets stay imports.
    * @param appPath - Absolute path to the app directory
    * @param cssFiles - Array of CSS file paths to import
    * @returns Generated CSS content with @source directive
@@ -653,6 +677,8 @@ interface StyleSystemModuleOptions {
   temporaryDirectory?: string;
   /** A browser a long-lived host keeps warm across renders; one-shot CLI runs leave it unset. */
   sharedBrowser?: ScreenshotOptions['sharedBrowser'];
+  /** A host renderer such as Po Desktop's Electron; preferred over the browser when set. */
+  capturePage?: ScreenshotOptions['capturePage'];
 }
 export declare function createStyleSystemModule(optionsInput?: StyleSystemModuleOptions): ContainerModule;
 //#endregion
@@ -945,6 +971,7 @@ export declare class ComponentRendererService {
   private log;
   private readonly preserveOutput;
   private readonly sharedBrowser;
+  private readonly capturePage;
   /**
    * Creates a new ComponentRendererService instance
    * @param designSystemConfig - Design system configuration
@@ -956,6 +983,7 @@ export declare class ComponentRendererService {
     workspaceRoot?: string;
     temporaryDirectory?: string;
     sharedBrowser?: ScreenshotOptions['sharedBrowser'];
+    capturePage?: ScreenshotOptions['capturePage'];
   });
   /**
    * Get the bundler service instance.
@@ -971,6 +999,7 @@ export declare class ComponentRendererService {
    * @throws Error if rendering fails
    */
   renderComponent(componentInfo: ComponentInfo, options?: RenderOptions): Promise<RenderResult>;
+  private renderInSlot;
   /**
    * Default maximum number of screenshot files to keep in temp directory.
    * Prevents disk space issues on long-running servers.
@@ -2086,6 +2115,10 @@ export declare class StdioTransportHandler {
   stop(): Promise<void>;
 }
 //#endregion
+//#region src/utils/renderSlots.d.ts
+/** Runs task once a render slot is free; slots are granted in arrival order. */
+export declare function withRenderSlot<T>(task: () => Promise<T>): Promise<T>;
+//#endregion
 //#region src/utils/storyBrowser.d.ts
 /** Server-owned Chrome. Each capture borrows it until its context cleanup settles. */
 export declare function createStoryBrowser(): {
@@ -2127,6 +2160,7 @@ export declare function createWarmStoryRenderer(options?: {
   workspaceRoot?: string;
   temporaryDirectory?: string;
   sharedBrowser?: ScreenshotOptions['sharedBrowser'];
+  capturePage?: ScreenshotOptions['capturePage'];
 }): WarmStoryRenderer;
 //#endregion
 export type { CSSClassCategory, CSSClassValue, CSSClassesResult, DesignSystemConfig, OxlintRestrictedClassPattern, OxlintRestrictedClassesConfig, ResolvedDesignSystemConfig, StoryPreviewIdentity, StoryPreviewInput, StoryPreviewResult, StoryPreviewServiceOptions, StyleSystemConfig, StyleSystemModuleOptions, Tool, ToolDefinition, WarmRendererResult, WarmRendererToolName, WarmStoryRenderer };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as resolveStyleSystemThemePath, B as STYLE_SYSTEM_TYPES, C as launchBrowserWithFallback, D as resetStyleSystemConfigCache, E as hasStyleSystemProjectConfig, F as TailwindCSSClassesService, I as BaseCSSClassesService, L as TemplatesManagerService, M as StoriesIndexService, N as CSSClassesServiceFactory, O as resolveAppDesignSystemConfig, P as DEFAULT_STYLE_SYSTEM_CONFIG, R as isContained, S as BaseBundlerService, T as getSharedComponentTags, _ as createDefaultBundlerService, b as ViteReactNativeBundlerService, c as createStyleSystemModule, d as GetComponentVisualTool, f as GetCSSClassesTool, g as ThemeService, h as ComponentRendererService, i as createServer, j as MAX_STYLE_SYSTEM_VIEWPORT_DIMENSION, k as StyleSystemConfigLoader, l as ListAppComponentsTool, m as GetUiComponentService, n as extractCustomTokenNames, p as ListThemesTool, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler, u as ListSharedComponentsTool, v as getBundlerService, w as getAppDesignSystemConfig, x as ViteReactBundlerService, y as getBundlerServiceFromConfig, z as log } from "./stdio-D8r_yQkY.mjs";
+import { A as StyleSystemConfigLoader, B as log, C as launchBrowserWithFallback, D as hasStyleSystemProjectConfig, E as getSharedComponentTags, F as DEFAULT_STYLE_SYSTEM_CONFIG, I as TailwindCSSClassesService, L as BaseCSSClassesService, M as MAX_STYLE_SYSTEM_VIEWPORT_DIMENSION, N as StoriesIndexService, O as resetStyleSystemConfigCache, P as CSSClassesServiceFactory, R as TemplatesManagerService, S as BaseBundlerService, T as getAppDesignSystemConfig, V as STYLE_SYSTEM_TYPES, _ as createDefaultBundlerService, b as ViteReactNativeBundlerService, c as createStyleSystemModule, d as GetComponentVisualTool, f as GetCSSClassesTool, g as ThemeService, h as ComponentRendererService, i as createServer, j as resolveStyleSystemThemePath, k as resolveAppDesignSystemConfig, l as ListAppComponentsTool, m as GetUiComponentService, n as extractCustomTokenNames, p as ListThemesTool, r as generateRestrictedClassesConfig, s as createContainer, t as StdioTransportHandler, u as ListSharedComponentsTool, v as getBundlerService, w as withRenderSlot, x as ViteReactBundlerService, y as getBundlerServiceFromConfig, z as isContained } from "./stdio-Cpp0lBtb.mjs";
 import { promises } from "node:fs";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -36,7 +36,8 @@ var StoryPreviewService = class {
 		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({
+		const bundler = this.bundlerFactory(config);
+		const result = await withRenderSlot(() => bundler.prerenderComponent({
 			componentPath: storyFilePath,
 			storyName: input.storyExport,
 			args: input.args,
@@ -46,7 +47,7 @@ var StoryPreviewService = class {
 			cssFiles: config.cssFiles,
 			rootComponent: config.rootComponent,
 			unistylesConfig: config.unistylesConfig
-		});
+		}));
 		const htmlFilePath = await promises.realpath(result.htmlFilePath);
 		const artifactDirectory = path.dirname(htmlFilePath);
 		const artifactRoot = path.join(appPath, ".tmp");
@@ -241,7 +242,7 @@ function createWarmStoryRenderer(options = {}) {
 		const bundler = await pending;
 		if (activeBundler && activeBundler !== bundler && activeBundler.isServerRunning()) await activeBundler.cleanup();
 		activeBundler = bundler;
-		const recycle = bundler.getBundlerId() === "vite" && captures >= 100;
+		const recycle = ["vite", "vite-react-native"].includes(bundler.getBundlerId()) && captures >= 100;
 		if (bundler.isServerRunning() && bundler.getCurrentAppPath() === resolved && !recycle) return;
 		if (bundler.isServerRunning()) await bundler.cleanup();
 		captures = 0;
@@ -251,7 +252,8 @@ function createWarmStoryRenderer(options = {}) {
 		const open = browser;
 		browser = void 0;
 		captures = 0;
-		await Promise.allSettled([open?.then((instance) => instance.close()), ...[...bundlers.values()].map((pending) => pending.then((bundler) => bundler.cleanup()))]);
+		const results = await Promise.allSettled([open?.then((instance) => instance.close()), ...[...bundlers.values()].map((pending) => pending.then((bundler) => bundler.cleanup()))]);
+		for (const result of results) if (result.status === "rejected") log.warn(`[WarmStoryRenderer] Reset failed to close a resource: ${result.reason}`);
 	};
 	const run = async (tool, input) => {
 		if (disposed) throw new Error("The story renderer is shut down.");
@@ -324,4 +326,4 @@ function createWarmStoryRenderer(options = {}) {
 	};
 }
 //#endregion
-export { BaseBundlerService, BaseCSSClassesService, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, MAX_STYLE_SYSTEM_VIEWPORT_DIMENSION, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, StoryPreviewService, StyleSystemConfigLoader, TailwindCSSClassesService, ThemeService, ViteReactBundlerService, ViteReactNativeBundlerService, WARM_RENDERER_TOOLS, createContainer, createDefaultBundlerService, createServer, createStoryBrowser, createStyleSystemModule, createWarmStoryRenderer, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerService, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, launchBrowserWithFallback, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath };
+export { BaseBundlerService, BaseCSSClassesService, CSSClassesServiceFactory, ComponentRendererService, DEFAULT_STYLE_SYSTEM_CONFIG, GetCSSClassesTool, GetComponentVisualTool, GetUiComponentService, ListAppComponentsTool, ListSharedComponentsTool, ListThemesTool, MAX_STYLE_SYSTEM_VIEWPORT_DIMENSION, STYLE_SYSTEM_TYPES, StdioTransportHandler, StoriesIndexService, StoryPreviewService, StyleSystemConfigLoader, TailwindCSSClassesService, ThemeService, ViteReactBundlerService, ViteReactNativeBundlerService, WARM_RENDERER_TOOLS, createContainer, createDefaultBundlerService, createServer, createStoryBrowser, createStyleSystemModule, createWarmStoryRenderer, extractCustomTokenNames, generateRestrictedClassesConfig, getAppDesignSystemConfig, getBundlerService, getBundlerServiceFromConfig, getSharedComponentTags, hasStyleSystemProjectConfig, launchBrowserWithFallback, resetStyleSystemConfigCache, resolveAppDesignSystemConfig, resolveStyleSystemThemePath, withRenderSlot };