orizu 0.5.34 → 0.5.35

package/dist/preview-runtime.d.ts

@@ -64,7 +64,12 @@ export declare function runLocalAppPreview(options: AppPreviewOptions): Promise<
  * an actionable message instead. Exported for tests.
  */
 export declare function findMissingPreviewRuntimeDeps(nodeModuleDirs: string[]): string[];
-export declare function buildPreviewCss(repoRoot: string | null, appPath: string): Promise<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 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

@@ -130,7 +130,6 @@ export async function runLocalAppPreview(options) {
     const cssPath = join(tempDir, 'preview.css');
     const htmlPath = join(tempDir, 'index.html');
     const outDir = join(tempDir, 'dist');
-    writeFileSync(cssPath, await buildPreviewCss(repoRoot, appPath), 'utf8');
     writeFileSync(entryPath, buildEntrySource(appPath, options.sampleRow), 'utf8');
     writeFileSync(htmlPath, buildPreviewHtml(), 'utf8');
     let server = null;
@@ -149,6 +148,8 @@ export async function runLocalAppPreview(options) {
                 '(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,
@@ -550,11 +551,15 @@ function buildPreviewHtml() {
 </html>
 `;
 }
-export async function buildPreviewCss(repoRoot, appPath) {
+const PREVIEW_TAILWIND_FALLBACK_WARNING = 'Tailwind CSS could not be built; the preview uses fallback styles';
+async function loadPreviewCssModules() {
+    return { postcss: (await import('postcss')).default, tailwind: (await import('@tailwindcss/postcss')).default };
+}
+/** `loadModules` is for tests: one that fails stands in for a broken install. */
+export async function buildPreviewCss(repoRoot, appPath, loadModules = loadPreviewCssModules) {
     const fallbackCss = buildPreviewChromeCss();
     try {
-        const postcss = (await import('postcss')).default;
-        const tailwind = (await import('@tailwindcss/postcss')).default;
+        const { postcss, tailwind } = await loadModules();
         const cliPackageRoot = findCliPackageRoot();
         const globalsPath = repoRoot
             ? join(repoRoot, 'app', 'globals.css')
@@ -576,7 +581,10 @@ export async function buildPreviewCss(repoRoot, appPath) {
         const result = await postcss([tailwind()]).process(sourceCss, { from: globalsPath });
         return result.css;
     }
-    catch {
+    catch (error) {
+        // Without Tailwind the screenshot loses the app's utility styling, so say so
+        // instead of looking right (ORI-2261: the sandbox tools check fails on it).
+        process.stderr.write(`warning: ${PREVIEW_TAILWIND_FALLBACK_WARNING} (${error instanceof Error ? error.message : String(error)})\n`);
         return fallbackCss;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orizu",
-  "version": "0.5.34",
+  "version": "0.5.35",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",

package/src/preview-runtime.ts

@@ -193,7 +193,6 @@ export async function runLocalAppPreview(options: AppPreviewOptions): Promise<Ap
   const htmlPath = join(tempDir, 'index.html')
   const outDir = join(tempDir, 'dist')
 
-  writeFileSync(cssPath, await buildPreviewCss(repoRoot, appPath), 'utf8')
   writeFileSync(entryPath, buildEntrySource(appPath, options.sampleRow), 'utf8')
   writeFileSync(htmlPath, buildPreviewHtml(), 'utf8')
 
@@ -219,6 +218,8 @@ export async function runLocalAppPreview(options: AppPreviewOptions): Promise<Ap
       )
     }
 
+    // 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,
@@ -656,12 +657,18 @@ function buildPreviewHtml() {
 `
 }
 
-export async function buildPreviewCss(repoRoot: string | null, appPath: string) {
+const PREVIEW_TAILWIND_FALLBACK_WARNING = 'Tailwind CSS could not be built; the preview uses fallback styles'
+
+async function loadPreviewCssModules() {
+  return { postcss: (await import('postcss')).default, tailwind: (await import('@tailwindcss/postcss')).default }
+}
+
+/** `loadModules` is for tests: one that fails stands in for a broken install. */
+export async function buildPreviewCss(repoRoot: string | null, appPath: string, loadModules: typeof loadPreviewCssModules = loadPreviewCssModules) {
   const fallbackCss = buildPreviewChromeCss()
 
   try {
-    const postcss = (await import('postcss')).default
-    const tailwind = (await import('@tailwindcss/postcss')).default
+    const { postcss, tailwind } = await loadModules()
     const cliPackageRoot = findCliPackageRoot()
     const globalsPath = repoRoot
       ? join(repoRoot, 'app', 'globals.css')
@@ -682,7 +689,10 @@ export async function buildPreviewCss(repoRoot: string | null, appPath: string)
     ].join('\n')
     const result = await postcss([tailwind()]).process(sourceCss, { from: globalsPath })
     return result.css
-  } catch {
+  } catch (error) {
+    // Without Tailwind the screenshot loses the app's utility styling, so say so
+    // instead of looking right (ORI-2261: the sandbox tools check fails on it).
+    process.stderr.write(`warning: ${PREVIEW_TAILWIND_FALLBACK_WARNING} (${error instanceof Error ? error.message : String(error)})\n`)
     return fallbackCss
   }
 }

package/vendor/skills/orizu/references/building-apps.md

@@ -1580,7 +1580,16 @@ orizu apps preview \
 
 The command validates the same app contract and allowed import registry as upload, validates the sample row against `input.json`, serves a temporary static preview page, passes `inputData`, `initialValues`, and `onComplete`, then uses Playwright to render it. Add `--headed` for visible Chromium review, and `--keep-open` when you want to inspect the local page manually. In the Orizu web checkout, preview uses the live component tree and global Tailwind CSS; in the mirrored/published CLI package, it uses the bundled preview runtime snapshot so the workflow remains available without the site source tree.
 
-The published CLI itself does not install the preview tooling (`esbuild`, `react`, `react-dom`, `@playwright/test`, Tailwind): run preview inside a project that provides them or from an Orizu checkout. When they are missing the command exits with an actionable error; the plain-`node` smoke test (`scripts/test-app.mjs`) still works everywhere in the meantime.
+In a hosted session, the sandbox already has the preview tooling and a headless Chromium. Run `orizu apps preview` with `--screenshot` as shown above; `--headed` and `--keep-open` are for local use and do not work in a sandbox. Do not `npm install` anything for it, including `react` or `react-dom`. If preview still fails there, run the plain-`node` smoke test (`scripts/test-app.mjs`) to check the app contract, then file the preview failure:
+
+```bash
+orizu feedback --category bug --severity major \
+  --summary "orizu apps preview fails in the hosted sandbox" \
+  --tried "<the orizu apps preview command you ran>" \
+  --actual "<the error it printed, without customer content>"
+```
+
+Locally, the published CLI does not install the preview tooling (`esbuild`, `react`, `react-dom`, `@playwright/test`, Tailwind): run preview inside a project that provides them or from an Orizu checkout. When they are missing the command exits with an actionable error; the plain-`node` smoke test (`scripts/test-app.mjs`) still works everywhere in the meantime.
 
 For coding agents: do not treat a passing contract check as enough. After generating or editing an app, run `orizu apps preview` with a representative row, inspect the screenshot, and compare the rendered workflow to the user's likely intent: are the right fields visible, is the primary judgment obvious, do controls fit, and would a human reviewer know what to do? If the screenshot looks wrong, revise the app and preview again before publishing.