neex 0.5.0 → 0.5.1

package/README.md

@@ -6,7 +6,7 @@
 </picture>
 </a>
 
-# Neex v0.5.0
+# Neex v0.5.1
 
 ### 🚀 Neex: The Modern Build System for Polyrepo-in-Monorepo Architecture
 
@@ -136,7 +136,7 @@ neex servers --group-output "npm run dev:service-a" "npm run dev:service-b"
 neex watch "npm run build" -w ./src
 
 # Watch for .ts file changes in 'services/' and restart two commands, ignoring 'node_modules'
-neex watch "npm run start:service1" "npm run start:service2" -w services/ -e ts -i node_modules/**
+neex watch "npm run start:service1" "npm run start:service2" -w services/ -e ts,tsx -i node_modules/**
 
 # Clear console on restart and set a delay
 neex watch "node server.js" --clear --delay 1500
@@ -167,6 +167,146 @@ neex restart my-app
 neex delete my-api
 ```
 
+### `dev` Command Examples
+
+The `dev` command is designed for development environments, providing automatic file watching and restart functionality. Here are various ways to use it:
+
+#### 1. Automatic Usage
+
+When no arguments are provided, neex dev will automatically:
+
+- If `package.json` has a `"dev"` script:
+  ```bash
+  neex dev  # runs: npm run dev
+  ```
+
+- If only a `"start"` script exists:
+  ```bash
+  neex dev  # runs: npm run start
+  ```
+
+- If only a `"main"` field exists:
+  ```bash
+  neex dev  # runs: node main.js (for JavaScript)
+  neex dev  # runs: npx ts-node main.ts (for TypeScript)
+  ```
+
+#### 2. Direct File Execution
+
+Run JavaScript or TypeScript files directly:
+
+```bash
+# JavaScript file
+neex dev app.js  # runs: node app.js
+
+# TypeScript file
+neex dev server.ts  # runs: npx ts-node server.ts
+
+# ES modules
+neex dev index.mjs
+
+# CommonJS TypeScript
+neex dev main.cts
+```
+
+#### 3. Package Manager Scripts
+
+Run npm/yarn/pnpm scripts:
+
+```bash
+# npm scripts
+neex dev "npm run dev"
+neex dev "npm run start"
+neex dev "npm run build"
+
+# yarn scripts
+neex dev "yarn dev"
+neex dev "yarn start"
+
+# pnpm scripts
+neex dev "pnpm dev"
+neex dev "pnpm start"
+```
+
+#### 4. System Commands
+
+Execute various system commands:
+
+```bash
+neex dev "python app.py"
+neex dev "php server.php"
+neex dev "go run main.go"
+neex dev "cargo run"
+neex dev "dotnet run"
+```
+
+#### 5. Configuration Options
+
+Customize the development experience with these options:
+
+```bash
+# Watch specific directories
+neex dev --watch src --watch public "npm run dev"
+
+# Ignore certain files/directories
+neex dev --ignore "*.log" --ignore "temp/**" "node server.js"
+
+# Specify file extensions
+neex dev --ext js,ts,vue,jsx "npm run dev"
+
+# Set restart delay
+neex dev --delay 2000 "npm run dev"
+
+# Clear console on restart
+neex dev --clear "node app.js"
+
+# Minimal output
+neex dev --minimal "npm run dev"
+
+# Disable colors
+neex dev --no-color "npm run dev"
+
+# Disable timing display
+neex dev --no-timing "npm run dev"
+
+# Stop on first error
+neex dev --stop-on-error "npm run test"
+```
+
+#### 6. Framework-Specific Examples
+
+```bash
+# Express.js
+neex dev server.js
+
+# Fastify
+neex dev --watch src "npm run dev"
+
+# Nest.js
+neex dev --watch src --ext ts "npm run start:dev"
+
+# Koa.js
+neex dev --watch app --ext js "node app.js"
+
+# Electron
+neex dev --watch src --ext js,html "npm run electron"
+
+# Webpack Dev Server
+neex dev --watch src --ext js,css,html "npm run dev"
+```
+
+#### 7. Error Handling
+
+```bash
+# No command specified and no default script
+neex dev
+# Error: No command specified for 'neex dev' and no default script
+
+# Non-existent file
+neex dev nonexistent.js
+# Warning: File "nonexistent.js" not found. Attempting to run as command.
+```
+
 ### 📚 Examples
 
 ### Parallel Execution

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neex",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "The Modern Build System for Polyrepo-in-Monorepo Architecture",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",