neutrinos-cli 2.0.0-beta.0 → 2.0.0-beta.2

package/README.md

@@ -1,173 +1,139 @@
 # neutrinos CLI
 
-neutrinos CLI is a command-line interface for managing, developing and publishing the packages.
+A command-line interface for managing, developing, and publishing alpha plugin packages.
 
-### Installation
+**Requires Node.js 22+**
 
-To install neutrinos CLI, use the following command:
+## Installation
 
 ```sh
+# Stable
 npm i -g neutrinos-cli
+
+# Beta
+npm i -g neutrinos-cli@beta
 ```
 
-### Usage
+## Quick Start
 
 ```sh
-    neutrinos command [options]
+neutrinos new my-workspace
+cd my-workspace
+neutrinos generate component my-button
+neutrinos build plugins
+neutrinos start
 ```
 
-### Commands
-
-- `new <name>` Create a new project
-- `generate` | `g` Generate a new plugin. Run "help generate" for more information.
-- `auth` Perform authentication tasks like login, logout, or status
-- `publish [options] [packageName]` Bundle and publish the plugin
-- `build <type> [pluginName]` Build the plugin
-- `start [options]` Start the live server for the plugin
-- `serve` Start the express server that serves the plugins
-
-### Options
-
-- `-v, --version` Output the version number
-- `-h, --help` Display help for command
-
----
-
 ## Commands
 
----
-
-### `new <name>`
+```
+neutrinos <command> [options]
+```
 
-##### Description
+| Command | Description |
+|---------|-------------|
+| `new <name>` | Create a new plugin workspace |
+| `generate\|g` | Generate a component, module, or attribute |
+| `build <type> [name]` | Build plugins (`plugins` or `docker`) |
+| `start` | Start the Vite dev server |
+| `serve` | Start the Express plugins server |
+| `publish [name]` | Bundle and publish a package |
+| `deprecate [name]` | Deprecate a published package |
+| `auth` | Login or check auth state |
+| `completion <shell>` | Output shell completion script (`bash` or `zsh`) |
 
-- Create a new project with the given name. The project will be created in the current directory.
+### `new <name>`
 
-##### Usage
+Create a new workspace with scaffold files, plugin.json, git init, and npm install.
 
 ```sh
-    neutrinos new <name>
+neutrinos new my-workspace
 ```
 
-##### Arguments
-
-- `<name>` project or workspace name
-
----
-
 ### `generate` | `g`
 
-##### Description
-
-- Generate a new component or module
-
-##### Usage
-
 ```sh
-    neutrinos generate [command] [argument] || neutrinos g [command] [argument]
+neutrinos generate component <name> [-d <description>]
+neutrinos generate module <name> [-d <description>]
+neutrinos generate attribute [componentName] [options]
 ```
 
-##### commands
-
-- `component <name>` | `c <name>` Component is a package enabling drag and drop functionality within the canvas
-- `module <name>` | `m <name>` Module is a globally accessible package, available throughout the entire project on `alpha.plugins` | `ap`.
-- `attribute [command] [options]` | `a [command] [options]` Generate an Attribute for a component, Read the `ATTRIBUTE.md` file in projetc/workspcae directory for more help
-
-##### Arguments
-
-- `<name>` component or module name
-
----
+Aliases: `g`, `c`, `m`, `a`
 
-## `Build <type> [pluginName]`
+Attribute options: `-t` type, `-u` ui-type, `-l` label, `-e` event, `-c` category, `-p` placeholder, `-d` defaultValue, `-o` options, `-f` fieldMappings, `-n` validation. See `ATTRIBUTE.md` in your workspace for details.
 
-#### Description
-
-- Build the plugins
-
-#### Usage
+### `build <type> [pluginName]`
 
 ```sh
-    neutrinos build <type> [pluginName]
+neutrinos build plugins [name] [--module] [--all]
+neutrinos build docker [name]
 ```
 
-#### Arguments
-
-- `<type>` The type of build, it can be one of `plugin` or `docker`
-- `pluginName` package Name of the component/module to build, it is an optional argument and if not pluginName it will build every package in the current workspace
-
----
-
-## `start [options]`
+- `plugins` — Runs tsc + Vite build, copies output to plugins-server
+- `docker` — Builds plugins then runs `docker build`
+- `--module` — Skip tsc (for JS-only modules)
+- `--all` — Build all packages in the workspace
 
-#### Description
-
-- Start the live server for the workspace
-
-#### Usage
+### `start`
 
 ```sh
-    neutrinos start [options]
+neutrinos start [-p <port>]
 ```
 
-#### Options
-
-- `-p, --port <port>` Port to start the server on, default is 6969
+Starts a Vite dev server. Default port: 6969.
 
----
+### `serve`
 
-## `serve`
-
-#### Description
+```sh
+neutrinos serve [-p <port>]
+```
 
-- Start the express server that serves the plugins
+Starts the Express server that serves built plugins. Default port: 3000.
 
-#### Usage
+### `publish [packageName]`
 
 ```sh
-    neutrinos serve
+neutrinos publish [name] [-t <patch|minor|major>] [-d <displayName>] [-i <iconPath>] [-m <images...>] [--accept-defaults] [--all]
 ```
 
----
+Authenticates, builds, zips, and uploads the package to the marketplace. Prompts for missing metadata unless `--accept-defaults` is passed.
 
-### `auth [command]`
+### `deprecate [packageName]`
 
-#### Description
+```sh
+neutrinos deprecate [name] [-y] [--all]
+```
 
-- Perform authentication tasks like login or status
+Marks a published package as deprecated. Prompts for confirmation unless `-y` is passed.
 
-#### Usage
+### `auth`
 
 ```sh
-    neutrinos auth [command]
+neutrinos auth login    # Opens browser for OIDC login
+neutrinos auth state    # Shows current auth state
 ```
 
-#### Commands:
+### `completion`
 
-- `login` Authenticate with the server
-- `state` Get the current state of auth
-
----
+```sh
+# Bash
+neutrinos completion bash >> ~/.bashrc
 
-## `publish [PackageName] [options]`
+# Zsh
+neutrinos completion zsh >> ~/.zshrc
+```
 
-#### Description
+## Global Options
 
-- Publish a package to the server
+- `-v, --version` — Show version
+- `-h, --help` — Show help
 
-#### Usage
+## Development
 
 ```sh
-    neutrinos publish [PackageName] [Options]
+pnpm install
+pnpm build          # tsc
+pnpm test           # vitest
+pnpm publish:beta   # build + test + npm publish --tag beta
+pnpm publish:latest # build + test + npm publish --tag latest
 ```
-
-#### Arguments
-
-- `PackageName` The name of the component/module to publish, if not cli will show the list of packages inside the current workspace/project
-
-#### Options
-
-- `-t, --version-type <versionType>` Version type for verion up, it can be one of `patch`, `minor`, `major`
-- `-d, --display-name <displayName>` Display Name for the package
-- `-i, --icon <iconPath>` Path to the icon
-- `-m, --images <imagePaths...>` path to the image

package/dist/src/commands/new-workspace.js

@@ -83,12 +83,12 @@ const initializePackages = async (dir) => {
         serve: 'neutrinos serve',
     };
     pkgJson.devDependencies = {
-        lit: '^3.1.4',
-        typescript: '^5.2.2',
+        lit: '^3.3.2',
+        typescript: '^5.9.3',
     };
     pkgJson.dependencies = {
-        express: '^4.19.2',
-        '@jatahworx/alpha-annotations-lib': '^1.0.9',
+        express: '^5.2.1',
+        '@jatahworx/alpha-annotations-lib': '^1.0.12',
     };
     pkgJson.workspaces = ['packages/*'];
     pkgJson.type = 'module';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "neutrinos-cli",
-    "version": "2.0.0-beta.0",
+    "version": "2.0.0-beta.2",
     "type": "module",
     "bin": {
         "neutrinos": "./dist/src/bin/cli.js"
@@ -38,8 +38,7 @@
         "colorette": "^2.0.20",
         "commander": "^12.0.0",
         "dotenv": "^16.4.5",
-        "express": "^5.2.1",
-        "fastify": "^4.26.2",
+        "fastify": "^5.8.2",
         "handlebars": "^4.7.8",
         "inquirer": "^13.3.2",
         "open": "^10.1.0",