orizu 0.5.53 → 0.5.54

package/dist/app-commands.d.ts

@@ -20,7 +20,8 @@ declare function readPromptSidecars(manifest: Record<string, unknown>, promptDir
 declare function writeTextFileEnsuringDir(pathArg: string, content: string): void;
 declare function readManifestFile(dirArg: string): Record<string, unknown>;
 declare function createAppFromFile(): Promise<void>;
-declare function previewAppFromFile(): Promise<void>;
+/** Resolves to the exit code of a stop (130 or 143), or undefined when the preview ended normally. */
+declare function previewAppFromFile(): Promise<number | undefined>;
 declare function updateAppFromFile(): Promise<void>;
 declare function linkAppDataset(): Promise<void>;
 declare function appDetail(): Promise<void>;

package/dist/app-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-commands.d.ts","sourceRoot":"","sources":["../src/app-commands.ts"],"names":[],"mappings":"AAuCA,iBAAe,QAAQ,kBActB;AAED,iBAAS,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU/C;AAED,iBAAS,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9D;AAeD,iBAAS,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElE;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1F;AAED,iBAAS,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUjE;AAED,iBAAS,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEjD;AAED,iBAAS,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG;IACpF,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb,CAeA;AAED,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM;;;;;IAoB/E;AAED,iBAAS,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAGjE;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjE;AAyED,iBAAe,iBAAiB,kBAmG/B;AAED,iBAAe,kBAAkB,kBAiDhC;AAED,iBAAe,iBAAiB,kBAwF/B;AAED,iBAAe,cAAc,kBAiC5B;AA+CD,iBAAe,SAAS,kBA2CvB;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAK3G;AAED,iBAAe,eAAe,kBAmD7B;AAED,OAAO,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,eAAe,GAChB,CAAA"}
+{"version":3,"file":"app-commands.d.ts","sourceRoot":"","sources":["../src/app-commands.ts"],"names":[],"mappings":"AAuCA,iBAAe,QAAQ,kBActB;AAED,iBAAS,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU/C;AAED,iBAAS,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9D;AAeD,iBAAS,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElE;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1F;AAED,iBAAS,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUjE;AAED,iBAAS,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEjD;AAED,iBAAS,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG;IACpF,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb,CAeA;AAED,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM;;;;;IAoB/E;AAED,iBAAS,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAGjE;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjE;AAyED,iBAAe,iBAAiB,kBAmG/B;AAED,sGAAsG;AACtG,iBAAe,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwD/D;AAED,iBAAe,iBAAiB,kBAwF/B;AAED,iBAAe,cAAc,kBAiC5B;AA+CD,iBAAe,SAAS,kBA2CvB;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAK3G;AAED,iBAAe,eAAe,kBAmD7B;AAED,OAAO,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,eAAe,GAChB,CAAA"}

package/dist/app-commands.js

@@ -13,7 +13,6 @@ import { inspectAppDestination } from './app-publish-paths.js';
 import { authedFetch, getBaseUrl } from './http.js';
 import { appPageUrl } from './app-page-url.js';
 import { parseJsonResponse, sanitizeHumanInlineText, sanitizeTerminalText } from './json-response.js';
-import { runLocalAppPreview } from './preview-runtime.js';
 import { findWorkspaceRoot } from './workspace.js';
 async function listApps() {
     const project = getArg('--project') || await resolveProjectSlug(null);
@@ -289,6 +288,7 @@ async function createAppFromFile() {
         throw new Error(`${getErrorMessage(error)}\nApp ID: ${appId}\nFolder: ${recoveryFolder}\nRetry: ${retryArgs.map(shellSingleQuote).join(' ')}`);
     }
 }
+/** Resolves to the exit code of a stop (130 or 143), or undefined when the preview ended normally. */
 async function previewAppFromFile() {
     const filePath = getArg('--file');
     const inputSchemaPath = getArg('--input-schema');
@@ -306,7 +306,29 @@ async function previewAppFromFile() {
     const outputJsonSchema = readJsonFile(outputSchemaPath);
     const sampleRow = readJsonFile(sampleRowPath);
     const expandedScreenshotPath = screenshotPath ? expandHomePath(screenshotPath) : undefined;
-    const result = await runLocalAppPreview({
+    const printRendered = (result) => {
+        if (hasJsonFlag()) {
+            printJson({
+                url: result.url,
+                screenshotPath: result.screenshotPath || null,
+                warnings: result.warnings,
+            });
+            return;
+        }
+        printLine(`Preview rendered: ${formatTerminalLink(result.url)}`);
+        if (result.screenshotPath) {
+            printLine(`Screenshot: ${sanitizeTerminalText(result.screenshotPath)}`);
+        }
+        if (headed || keepOpen) {
+            printLine('Headed preview is running. Close Chromium or stop the command when you are done.');
+        }
+        if (result.warnings.length > 0) {
+            printLine(`Warnings: ${sanitizeTerminalText(result.warnings.join('; '))}`);
+        }
+    };
+    const { runPreviewCommand } = await import('./preview-workflow.js');
+    // Printed once the page is ready, so a keep-open preview says so while it is open.
+    const outcome = await runPreviewCommand({
         filePath: expandedFilePath,
         inputSchema: inputJsonSchema,
         outputSchema: outputJsonSchema,
@@ -315,25 +337,10 @@ async function previewAppFromFile() {
         componentName: component,
         headed,
         keepOpen,
+        onRendered: printRendered,
     });
-    if (hasJsonFlag()) {
-        printJson({
-            url: result.url,
-            screenshotPath: result.screenshotPath || null,
-            warnings: result.warnings,
-        });
-        return;
-    }
-    printLine(`Preview rendered: ${formatTerminalLink(result.url)}`);
-    if (result.screenshotPath) {
-        printLine(`Screenshot: ${sanitizeTerminalText(result.screenshotPath)}`);
-    }
-    if (headed || keepOpen) {
-        printLine('Headed preview is running. Close Chromium or stop the command when you are done.');
-    }
-    if (result.warnings.length > 0) {
-        printLine(`Warnings: ${sanitizeTerminalText(result.warnings.join('; '))}`);
-    }
+    // A stop prints nothing more.
+    return 'interrupted' in outcome ? outcome.interrupted : undefined;
 }
 async function updateAppFromFile() {
     const workspaceRoot = hostedWorkspaceRoot();

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAuLA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAEhE,eAAO,MAAM,wBAAwB,GAAI,iBAAiB,MAAM;;;EACJ,CAAA;AAE5D,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAmqCtD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA0B1G;AAED,eAAO,MAAM,iBAAiB,SAAU,CAAA;AACxC,eAAO,MAAM,uBAAuB,QAAkB,CAAA;AACtD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAexH;AAmMD,wBAAsB,IAAI,CAAC,OAAO,WAAwB,iBAiiBzD;AAuED,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEhF,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAuLA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAEhE,eAAO,MAAM,wBAAwB,GAAI,iBAAiB,MAAM;;;EACJ,CAAA;AAE5D,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAmqCtD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CA0B1G;AAED,eAAO,MAAM,iBAAiB,SAAU,CAAA;AACxC,eAAO,MAAM,uBAAuB,QAAkB,CAAA;AACtD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,UAAU,CAexH;AAmMD,wBAAsB,IAAI,CAAC,OAAO,WAAwB,iBAuiBzD;AAuED,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEhF,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/index.js

@@ -1565,7 +1565,13 @@ export async function main(rawArgs = process.argv.slice(2)) {
         return;
     }
     if (command === 'apps' && subcommand === 'preview') {
-        await previewAppFromFile();
+        const stopped = await previewAppFromFile();
+        if (stopped !== undefined) {
+            process.exitCode = stopped;
+            // A Chromium launch can't be cancelled; one still starting holds the process
+            // until it arrives and is closed. Exit anyway once the 10 s budget is spent.
+            setTimeout(() => process.exit(stopped), 10_000).unref();
+        }
         return;
     }
     if (command === 'apps' && subcommand === 'update') {

package/dist/preview-runtime.d.ts

@@ -1,3 +1,4 @@
+import type { Plugin } from 'esbuild';
 export declare const PREVIEW_RUNTIME_REGISTRY_VERSION = 1;
 export declare const PREVIEW_ALLOWED_IMPORTS: Record<string, string[]>;
 export declare const PREVIEW_RUNTIME_GLOBALS: Record<string, string>;
@@ -14,6 +15,8 @@ export interface AppPreviewOptions {
     forceSnapshot?: boolean;
     playwright?: PreviewPlaywright;
     chromiumExecutablePath?: string | null;
+    /** Called once the page is ready (and screenshotted), before a keep-open wait. */
+    onRendered?: (result: AppPreviewResult) => void;
 }
 export interface AppPreviewResult {
     url: string;
@@ -24,19 +27,19 @@ interface Issue {
     level: 'error' | 'warn';
     message: string;
 }
-interface PreviewPlaywright {
+export interface PreviewPlaywright {
     chromium: {
         launch: (options: Record<string, unknown>) => Promise<PreviewBrowser>;
     };
 }
-interface PreviewBrowser {
+export interface PreviewBrowser {
     newPage: (options: Record<string, unknown>) => Promise<PreviewPage>;
     close: () => Promise<void>;
     once?: (event: string, listener: () => void) => unknown;
     on?: (event: string, listener: () => void) => unknown;
     off?: (event: string, listener: () => void) => unknown;
 }
-interface PreviewPage {
+export interface PreviewPage {
     goto: (url: string, options: Record<string, unknown>) => Promise<unknown>;
     waitForSelector: (selector: string, options: Record<string, unknown>) => Promise<unknown>;
     screenshot: (options: {
@@ -56,7 +59,10 @@ interface PreviewPage {
  */
 export declare function stripComments(code: string): string;
 export declare function validatePreviewInputs(options: AppPreviewOptions): Issue[];
+/** Loads the preview workflow (and Effect) only when a preview runs. */
 export declare function runLocalAppPreview(options: AppPreviewOptions): Promise<AppPreviewResult>;
+export declare function findPreviewRepoRoot(cwd: string, appPath: string): string | null;
+export declare function findCliPackageRoot(): string | null;
 /**
  * ALI-1071: react/react-dom are no longer dependencies of the PUBLISHED CLI
  * (app-grade packages were moved to devDependencies), so a bare global install
@@ -65,12 +71,17 @@ export declare function runLocalAppPreview(options: AppPreviewOptions): Promise<
  * an actionable message instead. Exported for tests.
  */
 export declare function findMissingPreviewRuntimeDeps(nodeModuleDirs: string[]): string[];
+export declare function findNodeModuleDirs(start: string): string[];
+export declare function buildEntrySource(appPath: string, sampleRow: Record<string, unknown>): string;
+export declare function buildRuntimeGlobalsSource(): string;
+export declare function buildPreviewHtml(): string;
 declare function loadPreviewCssModules(): Promise<{
     postcss: typeof import("postcss").default;
     tailwind: import("postcss/lib/postcss").PluginCreator<import("@tailwindcss/postcss").PluginOptions>;
 }>;
 /** `loadModules` is for tests: one that fails stands in for a broken install. */
 export declare function buildPreviewCss(repoRoot: string | null, appPath: string, loadModules?: typeof loadPreviewCssModules): Promise<string>;
+export declare function createPreviewSnapshotPlugin(): Plugin;
 export declare function getPreviewSnapshotModulePaths(): string[];
 export {};
 //# sourceMappingURL=preview-runtime.d.ts.map

package/dist/preview-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview-runtime.d.ts","sourceRoot":"","sources":["../src/preview-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"preview-runtime.d.ts","sourceRoot":"","sources":["../src/preview-runtime.ts"],"names":[],"mappings":"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"}

package/dist/preview-runtime.js

@@ -1,8 +1,6 @@
-import { createServer } from 'http';
-import { existsSync, mkdtempSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync, } from 'fs';
-import { tmpdir } from 'os';
-import { basename, dirname, isAbsolute, join, relative, resolve } from 'path';
-import { fileURLToPath, pathToFileURL } from 'url';
+import { existsSync, readFileSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
 export const PREVIEW_RUNTIME_REGISTRY_VERSION = 1;
 // BEGIN_ORIZU_PREVIEW_IMPORT_REGISTRY
 export const PREVIEW_ALLOWED_IMPORTS = {
@@ -59,9 +57,6 @@ export const PREVIEW_ALLOWED_IMPORTS = {
 export const PREVIEW_RUNTIME_GLOBALS = {
     React: 'react',
 };
-function isNodeError(error) {
-    return error instanceof Error;
-}
 const SUPPORTED_SCHEMA_KEYS = new Set(['type', 'required', 'properties', 'items', 'enum']);
 /**
  * Removes line and block comments, walking left to right so a `//` or `/*`
@@ -120,156 +115,10 @@ export function validatePreviewInputs(options) {
     validatePayload(options.inputSchema, options.sampleRow, 'sample row', issues);
     return issues;
 }
+/** Loads the preview workflow (and Effect) only when a preview runs. */
 export async function runLocalAppPreview(options) {
-    const issues = validatePreviewInputs(options);
-    const errors = issues.filter(issue => issue.level === 'error');
-    if (errors.length > 0) {
-        throw new Error(errors.map(issue => issue.message).join('\n'));
-    }
-    const tempDir = mkdtempSync(join(tmpdir(), 'orizu-app-preview-'));
-    const appPath = realpathSync(options.filePath);
-    const repoRoot = options.forceSnapshot
-        ? null
-        : findPreviewRepoRoot(options.cwd || process.cwd(), appPath);
-    const cliPackageRoot = findCliPackageRoot();
-    const entryPath = join(tempDir, 'entry.tsx');
-    const cssPath = join(tempDir, 'preview.css');
-    const htmlPath = join(tempDir, 'index.html');
-    const globalsPath = join(tempDir, 'runtime-globals.ts');
-    const outDir = join(tempDir, 'dist');
-    writeFileSync(entryPath, buildEntrySource(appPath, options.sampleRow), 'utf8');
-    writeFileSync(htmlPath, buildPreviewHtml(), 'utf8');
-    writeFileSync(globalsPath, buildRuntimeGlobalsSource(), 'utf8');
-    let server = null;
-    try {
-        const esbuild = await import('esbuild').catch(() => null);
-        if (!esbuild) {
-            throw new Error('Local preview requires esbuild. Install project dependencies with `bun install` or run from an Orizu checkout.');
-        }
-        const nodePaths = [
-            ...(repoRoot ? [join(repoRoot, 'node_modules')] : []),
-            ...(cliPackageRoot ? findNodeModuleDirs(cliPackageRoot) : []),
-        ];
-        const missingRuntimeDeps = findMissingPreviewRuntimeDeps(nodePaths);
-        if (missingRuntimeDeps.length > 0) {
-            throw new Error(`Local preview requires ${missingRuntimeDeps.join(' and ')} to be installed nearby ` +
-                '(run inside a project that has them, `npm install react react-dom` next to your app, ' +
-                'or run from an Orizu checkout after `bun install`).');
-        }
-        // After the dependency checks, so their actionable errors come before a Tailwind warning.
-        writeFileSync(cssPath, await buildPreviewCss(repoRoot, appPath), 'utf8');
-        await esbuild.build({
-            entryPoints: [entryPath],
-            bundle: true,
-            outdir: outDir,
-            format: 'esm',
-            platform: 'browser',
-            target: 'es2020',
-            jsx: 'automatic',
-            jsxImportSource: 'react',
-            // Only replaces names the app uses without declaring or importing them.
-            inject: [globalsPath],
-            loader: {
-                '.css': 'css',
-                '.tsx': 'tsx',
-                '.ts': 'ts',
-            },
-            absWorkingDir: repoRoot || cliPackageRoot || process.cwd(),
-            nodePaths,
-            alias: repoRoot ? { '@': repoRoot } : undefined,
-            plugins: repoRoot ? undefined : [createPreviewSnapshotPlugin()],
-            logLevel: 'silent',
-        });
-        let url = pathToFileURL(htmlPath).href;
-        try {
-            server = await serveDirectory(tempDir);
-            url = `http://127.0.0.1:${server.port}/index.html`;
-        }
-        catch {
-            server = null;
-        }
-        const playwright = options.playwright || await loadPlaywright();
-        const chromiumExecutablePath = 'chromiumExecutablePath' in options
-            ? options.chromiumExecutablePath
-            : resolveChromiumExecutablePath();
-        const browser = await playwright.chromium.launch({
-            headless: !options.headed,
-            ...(chromiumExecutablePath ? { executablePath: chromiumExecutablePath } : {}),
-        });
-        let page = null;
-        let handleRenderError;
-        let hasFinishedKeepingOpen = false;
-        try {
-            page = await browser.newPage({ viewport: { width: 1440, height: 1000 } });
-            const renderError = new Promise((_, reject) => {
-                handleRenderError = error => reject(new Error(`App preview render failed: ${error.message}`));
-                page?.on?.('pageerror', handleRenderError);
-            });
-            // Listen before navigation: React can fail before the ready marker mounts.
-            await Promise.race([
-                page.goto(url, { waitUntil: 'networkidle' }).then(() => page.waitForSelector('[data-orizu-preview-ready="true"]', { timeout: 15_000 })),
-                renderError,
-            ]);
-            if (options.screenshotPath) {
-                await page.screenshot({ path: options.screenshotPath, fullPage: true });
-            }
-            if (options.keepOpen) {
-                await waitForPreviewClose(page, browser);
-                hasFinishedKeepingOpen = true;
-            }
-        }
-        finally {
-            if (handleRenderError)
-                page?.off?.('pageerror', handleRenderError);
-            if (!hasFinishedKeepingOpen) {
-                await browser.close();
-            }
-        }
-        return {
-            url,
-            screenshotPath: options.screenshotPath,
-            warnings: issues.filter(issue => issue.level === 'warn').map(issue => issue.message),
-        };
-    }
-    finally {
-        await server?.close();
-        rmSync(tempDir, { recursive: true, force: true });
-    }
-}
-function waitForPreviewClose(page, browser) {
-    return new Promise(resolveClose => {
-        const cleanups = [];
-        let settled = false;
-        const done = () => {
-            if (settled)
-                return;
-            settled = true;
-            for (const cleanup of cleanups)
-                cleanup();
-            resolveClose();
-        };
-        const listen = (target, event) => {
-            if (typeof target.once === 'function') {
-                target.once(event, done);
-                return true;
-            }
-            if (typeof target.on === 'function') {
-                target.on(event, done);
-                if (typeof target.off === 'function') {
-                    cleanups.push(() => target.off?.(event, done));
-                }
-                return true;
-            }
-            return false;
-        };
-        const listening = [
-            listen(page, 'close'),
-            listen(browser, 'disconnected'),
-        ].some(Boolean);
-        if (!listening) {
-            page.waitForTimeout(24 * 60 * 60 * 1000).then(done, done);
-        }
-    });
+    const { runPreview } = await import('./preview-workflow.js');
+    return runPreview(options);
 }
 function validateImports(source, issues) {
     const importRegex = /import\s+(?:(\w+)(?:\s*,\s*)?)?(?:\{([^}]+)\})?\s+from\s+['"`]([^'"`]+)['"`]/g;
@@ -456,7 +305,7 @@ function validatePayload(schema, payload, path, issues) {
         issues.push({ level: 'error', message: `${path} must be a boolean.` });
     }
 }
-function findPreviewRepoRoot(cwd, appPath) {
+export function findPreviewRepoRoot(cwd, appPath) {
     // ORI-1565 move: this detects local development inside the Orizu monorepo
     // itself (to borrow its real Tailwind setup instead of the packaged
     // snapshot CSS); components/, app/globals.css and lib/available-
@@ -483,7 +332,7 @@ function findPreviewRepoRoot(cwd, appPath) {
 function fileURLPath() {
     return fileURLToPath(new URL('.', import.meta.url));
 }
-function findCliPackageRoot() {
+export function findCliPackageRoot() {
     let current = resolve(dirname(fileURLPath()));
     while (true) {
         if (existsSync(join(current, 'package.json')) &&
@@ -507,7 +356,7 @@ function findCliPackageRoot() {
 export function findMissingPreviewRuntimeDeps(nodeModuleDirs) {
     return ['react', 'react-dom'].filter(name => !nodeModuleDirs.some(dir => existsSync(join(dir, name, 'package.json'))));
 }
-function findNodeModuleDirs(start) {
+export function findNodeModuleDirs(start) {
     const dirs = [];
     let current = resolve(start);
     while (true) {
@@ -522,7 +371,7 @@ function findNodeModuleDirs(start) {
     }
     return dirs;
 }
-function buildEntrySource(appPath, sampleRow) {
+export function buildEntrySource(appPath, sampleRow) {
     return `
 import React from 'react'
 import { createRoot } from 'react-dom/client'
@@ -558,12 +407,12 @@ function PreviewShell() {
 root.render(React.createElement(PreviewShell))
 `;
 }
-function buildRuntimeGlobalsSource() {
+export function buildRuntimeGlobalsSource() {
     return Object.entries(PREVIEW_RUNTIME_GLOBALS)
         .map(([name, path]) => `import ${name} from ${JSON.stringify(path)}\nexport { ${name} }\n`)
         .join('');
 }
-function buildPreviewHtml() {
+export function buildPreviewHtml() {
     return `<!doctype html>
 <html lang="en">
   <head>
@@ -676,7 +525,7 @@ function buildSnapshotTailwindCss() {
 }
 `;
 }
-function createPreviewSnapshotPlugin() {
+export function createPreviewSnapshotPlugin() {
     const modules = buildPreviewSnapshotModules();
     return {
         name: 'orizu-preview-runtime-snapshot',
@@ -981,94 +830,3 @@ export function ShortcutButton({ shortcut, shortcutLabel, children, className, d
 export function getPreviewSnapshotModulePaths() {
     return Object.keys(buildPreviewSnapshotModules()).sort();
 }
-async function serveDirectory(root) {
-    const server = createServer((request, response) => {
-        const url = new URL(request.url || '/', 'http://127.0.0.1');
-        const requestedPath = url.pathname === '/' ? '/index.html' : url.pathname;
-        const filePath = resolve(root, `.${requestedPath}`);
-        const relativePath = relative(root, filePath);
-        if (relativePath.startsWith('..') || isAbsolute(relativePath) || !existsSync(filePath)) {
-            response.statusCode = 404;
-            response.end('Not found');
-            return;
-        }
-        try {
-            if (!statSync(filePath).isFile()) {
-                response.statusCode = 404;
-                response.end('Not found');
-                return;
-            }
-        }
-        catch {
-            response.statusCode = 404;
-            response.end('Not found');
-            return;
-        }
-        const ext = basename(filePath).split('.').pop();
-        const contentType = ext === 'html' ? 'text/html; charset=utf-8' :
-            ext === 'js' ? 'text/javascript; charset=utf-8' :
-                ext === 'css' ? 'text/css; charset=utf-8' :
-                    'application/octet-stream';
-        response.setHeader('content-type', contentType);
-        try {
-            response.end(readFileSync(filePath));
-        }
-        catch {
-            response.statusCode = 500;
-            response.end('Internal server error');
-        }
-    });
-    const port = await listenOnAvailablePort(server);
-    const address = server.address();
-    if (!address || typeof address === 'string') {
-        throw new Error('Unable to start local preview server.');
-    }
-    return {
-        port,
-        close: () => new Promise(resolveClose => server.close(() => resolveClose())),
-    };
-}
-async function listenOnAvailablePort(server) {
-    const firstPort = 39000 + Math.floor(Math.random() * 1000);
-    for (let offset = 0; offset < 20; offset += 1) {
-        const port = firstPort + offset;
-        try {
-            await new Promise((resolveListen, reject) => {
-                server.once('error', reject);
-                server.listen(port, '127.0.0.1', () => {
-                    server.off('error', reject);
-                    resolveListen();
-                });
-            });
-            return port;
-        }
-        catch (error) {
-            server.removeAllListeners('error');
-            if (!isNodeError(error) || error.code !== 'EADDRINUSE')
-                throw error;
-        }
-    }
-    throw new Error('Unable to find an available localhost port for app preview.');
-}
-async function loadPlaywright() {
-    const fromTest = await import('@playwright/test').catch(() => null);
-    if (fromTest?.chromium)
-        return fromTest;
-    const fromPlaywright = await import('playwright').catch(() => null);
-    if (fromPlaywright?.chromium)
-        return fromPlaywright;
-    throw new Error('Local preview requires Playwright. Install project dependencies with `bun install`, then rerun `orizu apps preview`.');
-}
-function resolveChromiumExecutablePath() {
-    const candidates = [
-        process.env.PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH,
-        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-        '/Applications/Chromium.app/Contents/MacOS/Chromium',
-        '/usr/bin/google-chrome',
-        '/usr/bin/chromium',
-        '/usr/bin/chromium-browser',
-        'C:/Program Files/Google/Chrome/Application/chrome.exe',
-        'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
-    ].filter(Boolean);
-    return candidates.find(candidate => existsSync(candidate)) || null;
-}

package/dist/preview-workflow.d.ts

@@ -0,0 +1,11 @@
+import { type Interrupted } from './cli-stops.js';
+import { type AppPreviewOptions, type AppPreviewResult } from './preview-runtime.js';
+/** Renders the preview; Ctrl-C and SIGTERM are left to Node and Playwright, as before. */
+export declare function runPreview(options: AppPreviewOptions): Promise<AppPreviewResult>;
+/**
+ * `orizu apps preview`: Ctrl-C and SIGTERM stop the preview and close
+ * Chromium, the server and the folder before the command exits with 130 or 143.
+ * Playwright's own signal handlers are off, so it can't end the process first.
+ */
+export declare function runPreviewCommand(options: AppPreviewOptions): Promise<AppPreviewResult | Interrupted>;
+//# sourceMappingURL=preview-workflow.d.ts.map

package/dist/preview-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-workflow.d.ts","sourceRoot":"","sources":["../src/preview-workflow.ts"],"names":[],"mappings":"AAQA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAWL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAItB,MAAM,sBAAsB,CAAA;AA2Q7B,0FAA0F;AAC1F,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAItF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,GAAG,WAAW,CAAC,CAQ3G"}