@matthesketh/utopia-cli 0.4.0 → 0.7.0

package/README.md

@@ -0,0 +1,47 @@
+# @matthesketh/utopia-cli
+
+CLI for the UtopiaJS framework. Wraps Vite and auto-injects the UtopiaJS plugin when no `vite.config` exists.
+
+## Install
+
+```bash
+pnpm add -D @matthesketh/utopia-cli
+```
+
+Or scaffold a new project (includes the CLI automatically):
+
+```bash
+npx create-utopia my-app
+```
+
+## Commands
+
+```bash
+utopia dev        # Start development server
+utopia build      # Build for production
+utopia preview    # Preview production build
+utopia test       # Run component tests (vitest + <test> block extraction)
+utopia create     # Prints instructions for npx create-utopia
+```
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--port <port>` | Specify port (dev/preview) |
+| `--host [host]` | Expose to network |
+| `--open` | Open browser on startup |
+| `--outDir <dir>` | Output directory (build) |
+| `-c, --config <file>` | Use a specific Vite config file |
+| `-h, --help` | Show help |
+| `-v, --version` | Show version |
+
+## How It Works
+
+- If no `vite.config.{ts,js,mjs,mts}` exists, the CLI auto-injects `@matthesketh/utopia-vite-plugin`
+- `utopia test` auto-injects the `utopiaTestPlugin` from `@matthesketh/utopia-test/plugin`, which extracts `<test>` blocks from `.utopia` files into vitest-discoverable companion files
+- All commands pass through to Vite under the hood
+
+## License
+
+MIT

package/dist/index.js

@@ -10,6 +10,7 @@ import {
   preview as vitePreview
 } from "vite";
 import utopia from "@matthesketh/utopia-vite-plugin";
+import { utopiaTestPlugin } from "@matthesketh/utopia-test/plugin";
 function parseArgs(argv) {
   const args = argv.slice(2);
   const META_FLAGS = /* @__PURE__ */ new Set(["-v", "--version", "-h", "--help"]);
@@ -91,6 +92,17 @@ async function preview(args) {
   const server = await vitePreview(config);
   server.printUrls();
 }
+async function test(args) {
+  const { startVitest } = await import("vitest/node");
+  const config = buildInlineConfig(args, "test");
+  const plugins = config.plugins ?? [];
+  plugins.push(utopiaTestPlugin());
+  config.plugins = plugins;
+  const vitest = await startVitest("test", args.rest, {
+    ...config
+  });
+  await vitest?.close();
+}
 function printVersion() {
   const require2 = createRequire(import.meta.url);
   const pkg = require2("../package.json");
@@ -107,6 +119,7 @@ function printHelp() {
     dev      Start development server
     build    Build for production
     preview  Preview production build
+    test     Run component tests
     create   Create a new project
 
   Options:
@@ -131,6 +144,9 @@ async function main() {
     case "preview":
       await preview(args);
       break;
+    case "test":
+      await test(args);
+      break;
     case "create":
       console.log("To create a new UtopiaJS project, run:");
       console.log("  npx create-utopia [project-name]");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matthesketh/utopia-cli",
-  "version": "0.4.0",
+  "version": "0.7.0",
   "description": "CLI for the UtopiaJS framework",
   "type": "module",
   "license": "MIT",
@@ -31,10 +31,12 @@
     "dist"
   ],
   "dependencies": {
-    "@matthesketh/utopia-vite-plugin": "0.4.0"
+    "@matthesketh/utopia-test": "0.7.0",
+    "@matthesketh/utopia-vite-plugin": "0.7.0"
   },
   "peerDependencies": {
-    "vite": "^6.0.0 || ^7.0.0"
+    "vite": "^6.0.0 || ^7.0.0",
+    "vitest": "^3.0.0"
   },
   "devDependencies": {
     "vite": "^7.3.1"