@preact-mvc/cli 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,54 @@
+# @preact-mvc/cli
+
+[![CI](https://github.com/jwhenry3/preact-mvc/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/jwhenry3/preact-mvc/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/jwhenry3/preact-mvc/graph/badge.svg?branch=main)](https://codecov.io/gh/jwhenry3/preact-mvc)
+[![Socket Badge](https://badge.socket.dev/npm/package/@preact-mvc/cli)](https://badge.socket.dev/npm/package/@preact-mvc/cli)
+
+The `pmvc` binary — scaffolding, generators, dev/build/test delegation,
+and dependency maintenance for PreactMVC projects.
+
+**[PreactMVC — CLI documentation](https://jwhenry3.github.io/preact-mvc/docs/cli/)**
+
+## Install
+
+```bash
+npm install -g @preact-mvc/cli
+```
+
+## Create an app
+
+```bash
+pmvc new my-app            # scaffold + npm install
+pmvc new my-app --islands  # + worker-island demo (contract + worker + route)
+pmvc new my-app --tailwind # + Tailwind v4 wiring
+cd my-app && pmvc serve    # vite dev server
+```
+
+The generated app is a runnable `@Module`-/`@Component`-structured Preact
+project with router, DI tokens, a sample view test, and (with `--islands`)
+a shared island contract + worker entry.
+
+## Generators — run inside a project
+
+```bash
+pmvc g view my-page        # src/app/my-page/my-page.view.tsx (+ test)
+pmvc g controller orders   # <name>.controller.ts — @Controller view logic
+pmvc g service auth        # <name>.service.ts — @Injectable service
+pmvc g module admin        # feature module
+pmvc g island ticker       # contract + worker entry pair
+```
+
+## Build, dev, test
+
+`pmvc serve|dev`, `pmvc build` (`tsc --noEmit` + `vite build`), and
+`pmvc test` (`vitest run`) delegate to the project's own toolchain —
+vite args pass through (`--watch`, `--no-typecheck`).
+
+## Maintenance
+
+- `pmvc add tailwind | islands` — install + wire an integration into an
+  existing project.
+- `pmvc update` — bump `@preact-mvc/*` deps (`--to <ver>`,
+  `--include-atoll` for `@atolljs/*`).
+
+The package is plain `.mjs` — no build step, ships `src/` directly.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@preact-mvc/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Project scaffolding and maintenance CLI for preact-mvc: new, generate, serve/build/test, add, update",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * pmvc — the preact-mvc CLI. Angular-CLI-shaped: new / generate /
+ * pmvc — the PreactMVC CLI. Angular-CLI-shaped: new / generate /
  * serve / build / test / add / update / version / docs.
  *
  * Dependency-free on purpose: the CLI must run before a project has
@@ -13,7 +13,7 @@ import { cmdNew } from './commands/new.mjs';
 import { cmdGenerate } from './commands/generate.mjs';
 import { cmdBuild, cmdServe, cmdTest } from './commands/run.mjs';
 import { cmdAdd, cmdUpdate } from './commands/update.mjs';
-const HELP = `pmvc — the preact-mvc CLI
+const HELP = `pmvc — the PreactMVC CLI
 
 Usage: pmvc <command> [args] [flags]
 

package/src/commands/generate.mjs

@@ -97,7 +97,7 @@ export function cmdGenerate(a) {
   }
 
   const found = findProjectRoot();
-  if (!found) fail('not inside a preact-mvc project (no @preact-mvc/core dependency found)');
+  if (!found) fail('not inside a PreactMVC project (no @preact-mvc/core dependency found)');
   const name = featureName(rawName);
 
   if (schematic === 'island') {

package/src/commands/new.mjs

@@ -1,5 +1,5 @@
 /**
- * `pmvc new <dir>` — scaffold a preact-mvc application, the `ng new`
+ * `pmvc new <dir>` — scaffold a PreactMVC application, the `ng new`
  * equivalent. Flags: --islands, --tailwind, --skip-install,
  * --skip-tests, -d/--dry-run, --force (overwrite existing files).
  */
@@ -119,7 +119,7 @@ export function cmdNew(argv) {
     );
   }
 
-  log(`\nScaffolding a preact-mvc app in ${root}\n`);
+  log(`\nScaffolding a PreactMVC app in ${root}\n`);
   for (const [rel, contents] of Object.entries(files)) {
     writeFile(root, rel, contents, opts);
   }

package/src/commands/run.mjs

@@ -10,7 +10,7 @@ import { findProjectRoot, readJson, run, fail } from '../lib.mjs';
 
 function projectRoot() {
   const found = findProjectRoot();
-  if (!found) fail('not inside a preact-mvc project (no @preact-mvc/core dependency found)');
+  if (!found) fail('not inside a PreactMVC project (no @preact-mvc/core dependency found)');
   return found.root;
 }
 

package/src/commands/update.mjs

@@ -24,7 +24,7 @@ import * as T from '../templates.mjs';
 
 function project() {
   const found = findProjectRoot();
-  if (!found) fail('not inside a preact-mvc project (no @preact-mvc/core dependency found)');
+  if (!found) fail('not inside a PreactMVC project (no @preact-mvc/core dependency found)');
   return found;
 }
 

package/src/templates.mjs

@@ -38,6 +38,16 @@ import preact from '@preact/preset-vite';
   resolve: {
     alias: [{ find: '@', replacement: fileURLToPath(new URL('./src', import.meta.url)) }],
   },
+  // Keep @preact-mvc/* out of dep prebundling: releases >= 0.1.1 ship
+  // compiled dist/, but 0.1.0 ships .ts/.tsx sources which esbuild's
+  // optimizer compiles with the classic React pragma ("React is not
+  // defined"). Excluded deps go through vite's transform instead —
+  // correct JSX either way — and stay in one module realm with the
+  // view interceptor's patched options object (same reason the vitest
+  // inline list exists below).
+  optimizeDeps: {
+    exclude: ['@preact-mvc/core', '@preact-mvc/atoll', '@preact-mvc/atoll-island'],
+  },
   test: {
     environment: 'jsdom',
     globals: true,
@@ -94,7 +104,7 @@ save-exact=true
 
 export const T_README = `# %%NAME%%
 
-A [preact-mvc](https://github.com/jwhenry3/preact-mvc) application —
+A [PreactMVC](https://github.com/jwhenry3/preact-mvc) application —
 Angular-style modules, DI, and MVC on class-based JSX views rendered by
 Preact, with signal reactivity.