@powerhousedao/ph-cli 0.40.83-dev.0 → 0.40.83-dev.1

package/README.md

@@ -1,18 +1,72 @@
 # Powerhouse CLI (ph-cli)
 
-A command-line interface tool for Powerhouse DAO that helps you manage and interact with Powerhouse packages and services.
+[![npm version](https://img.shields.io/npm/v/ph-cli.svg)](https://www.npmjs.com/package/ph-cli)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+
+A powerful command-line interface tool for Powerhouse DAO that streamlines the development and management of Powerhouse packages and services. The CLI provides a unified interface for common development tasks, package management, and service operations.
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Commands](#commands)
+  - [Connect](#ph-connect)
+  - [Generate](#ph-generate)
+  - [Install](#ph-install)
+  - [Uninstall](#ph-uninstall)
+  - [List](#ph-list)
+  - [Inspect](#ph-inspect)
+  - [Service](#ph-service)
+  - [Version](#ph-version)
+  - [Help](#ph-help)
+- [Configuration](#configuration)
+- [Troubleshooting](#troubleshooting)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Features
+
+- 🚀 Fast and efficient package management
+- 🔧 Powerful code generation capabilities
+- 🌐 Connect Studio development environment
+- 📦 Workspace-aware package operations
+- 🔍 Package inspection and dependency management
+- 🛠 Service management and monitoring
+- 📝 Comprehensive documentation and help system
 
 ## Installation
 
 ```bash
-npm install ph-cli
+# Install globally
+npm install -g ph-cli
+
+# Install as a dev dependency
+npm install --save-dev ph-cli
+```
+
+## Quick Start
+
+```bash
+# Initialize a new Powerhouse project
+ph init
+
+# Start the development environment
+ph connect
+
+# Install required dependencies
+ph install @powerhousedao/core
+
+# Generate code from models
+ph generate --interactive
 ```
 
-## Available Commands
+## Commands
 
 ### `ph connect`
 
-Starts Connect Studio, a development environment for Powerhouse.
+Starts Connect Studio, a development environment for Powerhouse. This command launches a local development server with hot-reloading and debugging capabilities.
 
 #### Options:
 - `-p, --port <port>`: Port to run the server on (default: 3000)
@@ -21,6 +75,7 @@ Starts Connect Studio, a development environment for Powerhouse.
 - `--open`: Open the browser automatically
 - `--config-file <configFile>`: Path to the powerhouse.config.js file
 
+#### Examples:
 ```bash
 # Start Connect Studio on default port (3000)
 ph connect
@@ -40,7 +95,7 @@ ph connect --config-file ./my-config.js
 
 ### `ph generate`
 
-Generate code from document models with various options.
+Generate code from document models with various options. This command supports multiple generation types including editors, processors, subgraphs, and import scripts.
 
 #### Options:
 - `-i, --interactive`: Run the command in interactive mode
@@ -58,6 +113,7 @@ Generate code from document models with various options.
 - `-w, --watch`: Watch the generated code
 - `-d, --drive-editor <name>`: Generate a drive editor with the specified name
 
+#### Examples:
 ```bash
 # Generate code from a specific file
 ph generate path/to/model.json
@@ -86,7 +142,7 @@ ph generate --watch
 
 ### `ph install` (or `ph add`, `ph i`)
 
-Install Powerhouse dependencies.
+Install Powerhouse dependencies with support for global and workspace-specific installations.
 
 #### Options:
 - `-g, --global`: Install the dependency globally
@@ -94,6 +150,7 @@ Install Powerhouse dependencies.
 - `-w, --workspace`: Install the dependency in the workspace (use this option for monorepos)
 - `--package-manager <packageManager>`: Force package manager to use
 
+#### Examples:
 ```bash
 # Install a package
 ph install @powerhousedao/package-name
@@ -110,7 +167,7 @@ ph install @powerhousedao/package1 @powerhousedao/package2
 
 ### `ph uninstall` (or `ph remove`)
 
-Remove Powerhouse dependencies.
+Remove Powerhouse dependencies from your project.
 
 #### Options:
 - `-g, --global`: Remove the dependency globally
@@ -118,6 +175,7 @@ Remove Powerhouse dependencies.
 - `-w, --workspace`: Remove the dependency in the workspace (use this option for monorepos)
 - `--package-manager <packageManager>`: Force package manager to use
 
+#### Examples:
 ```bash
 # Remove a package
 ph uninstall @powerhousedao/package-name
@@ -131,11 +189,12 @@ ph uninstall -w @powerhousedao/package-name
 
 ### `ph list` (or `ph l`)
 
-List all installed Powerhouse packages in your project.
+List all installed Powerhouse packages in your project with detailed information.
 
 #### Options:
 - `--debug`: Show additional logs
 
+#### Examples:
 ```bash
 # List packages
 ph list
@@ -146,11 +205,12 @@ ph list --debug
 
 ### `ph inspect` (or `ph is`)
 
-Inspect a specific package.
+Inspect a specific package for detailed information about its dependencies, configuration, and usage.
 
 #### Options:
 - `--debug`: Show additional logs
 
+#### Examples:
 ```bash
 # Inspect a package
 ph inspect @powerhousedao/package-name
@@ -161,12 +221,13 @@ ph inspect --debug @powerhousedao/package-name
 
 ### `ph service`
 
-Manage Powerhouse services.
+Manage Powerhouse services with various operations.
 
 #### Options:
 - `action`: The action to perform (default: "list")
 - `service`: The service to manage (default: "all")
 
+#### Examples:
 ```bash
 # List all services
 ph service list
@@ -177,19 +238,21 @@ ph service list service-name
 
 ### `ph version` (or `ph v`)
 
-Display the current version of the PH CLI.
+Display the current version of the PH CLI and related information.
 
 #### Options:
 - `--debug`: Show additional logs
 
+#### Examples:
 ```bash
 ph version
 ```
 
 ### `ph help`
 
-Display help information about the CLI and its commands.
+Display comprehensive help information about the CLI and its commands.
 
+#### Examples:
 ```bash
 # Show general help
 ph help
@@ -198,17 +261,58 @@ ph help
 ph help <command>
 ```
 
-## Global Options
+## Configuration
+
+The CLI can be configured using a `powerhouse.config.js` file in your project root. Here's an example configuration:
+
+```javascript
+module.exports = {
+  port: 3000,
+  host: false,
+  https: false,
+  packageManager: 'npm',
+  workspace: {
+    enabled: true,
+    root: './packages'
+  }
+};
+```
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Command not found**
+   - Ensure ph-cli is installed globally or locally
+   - Check your PATH environment variable
+
+2. **Permission errors**
+   - Use sudo for global installations
+   - Check directory permissions
 
-Most commands support the following global options:
+3. **Package installation failures**
+   - Clear npm cache: `npm cache clean --force`
+   - Check network connectivity
+   - Verify package name and version
 
-- `--debug`: Show additional debug logs
-- `--package-manager <manager>`: Force the use of a specific package manager
+### Debug Mode
+
+Most commands support a `--debug` flag for additional logging:
+
+```bash
+ph install --debug @powerhousedao/package-name
+```
 
 ## Contributing
 
-Please refer to the project's contribution guidelines for details on our code of conduct and the process for submitting pull requests.
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on:
+
+- Code of Conduct
+- Development Process
+- Pull Request Process
+- Style Guide
+- Testing Requirements
 
 ## License
 
-This project is licensed under the terms specified in the LICENSE file.
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@powerhousedao/ph-cli",
-    "version": "0.40.83-dev.0",
+    "version": "0.40.83-dev.1",
     "description": "",
     "license": "AGPL-3.0-only",
     "type": "module",

package/dist/src/commands/connect.d.ts

@@ -1,4 +1,4 @@
-import { type Command } from "commander";
+import { Command } from "commander";
 import { type ConnectOptions } from "../services/connect.js";
 import { type CommandActionType } from "../types.js";
 export declare const connect: CommandActionType<[

package/dist/src/commands/connect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../../src/commands/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrD,eAAO,MAAM,OAAO,EAAE,iBAAiB,CACrC;IAAC,cAAc;CAAC,EAChB,OAAO,CAAC,IAAI,CAAC,CAGd,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,QAmB9C"}
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../../src/commands/connect.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AASrD,eAAO,MAAM,OAAO,EAAE,iBAAiB,CACrC;IAAC,cAAc;CAAC,EAChB,OAAO,CAAC,IAAI,CAAC,CAGd,CAAC;AA2CF,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,QAY9C"}

package/dist/src/commands/connect.js

@@ -1,4 +1,6 @@
-import { connectHelp } from "../help.js";
+import { buildConnect, previewConnect, } from "@powerhousedao/builder-tools/connect-build";
+import { Command } from "commander";
+import { connectBuildHelp, connectPreviewHelp, connectStudioHelp, } from "../help.js";
 import { setCustomHelp } from "../utils.js";
 async function startConnect(options) {
     const Connect = await import("../services/connect.js");
@@ -8,17 +10,45 @@ async function startConnect(options) {
 export const connect = async (options) => {
     return startConnect(options);
 };
+const studioCommand = new Command("studio")
+    .description("Starts Connect Studio (default)")
+    .option("-p, --port <port>", "Port to run the server on", "3000")
+    .option("-h, --host", "Expose the server to the network")
+    .option("--https", "Enable HTTPS")
+    .option("--open", "Open the browser")
+    .option("--config-file <configFile>", "Path to the powerhouse.config.js file")
+    .action(async (...args) => {
+    await connect(...args);
+});
+setCustomHelp(studioCommand, connectStudioHelp);
+const buildCommand = new Command("build")
+    .description("Build Connect project")
+    .option("--project-root <path>", "The root directory of the project", process.cwd())
+    .option("--assets-dir-name <name>", "The name of the assets directory")
+    .option("--external-packages-file-name <name>", "The name of the external packages file")
+    .option("--styles-file-name <name>", "The name of the styles file")
+    .option("--connect-path <path>", "The path to the Connect dist directory")
+    .action(async (...args) => {
+    await buildConnect(...args);
+});
+setCustomHelp(buildCommand, connectBuildHelp);
+const previewCommand = new Command("preview")
+    .description("Preview built Connect project")
+    .option("--project-root <path>", "The root directory of the project")
+    .option("-p, --port <port>", "The port to run the server on", "4173")
+    .option("--open", "Open the browser")
+    .action(async (...args) => {
+    await previewConnect(...args);
+});
+setCustomHelp(previewCommand, connectPreviewHelp);
 export function connectCommand(program) {
     const cmd = program
         .command("connect")
-        .description("Starts Connect Studio")
-        .option("-p, --port <port>", "Port to run the server on", "3000")
-        .option("-h, --host", "Expose the server to the network")
-        .option("--https", "Enable HTTPS")
-        .option("--open", "Open the browser")
-        .option("--config-file <configFile>", "Path to the powerhouse.config.js file");
-    // Use the setCustomHelp utility to apply custom help formatting
-    setCustomHelp(cmd, connectHelp);
+        .description("Powerhouse Connect commands")
+        .addCommand(studioCommand)
+        .addCommand(buildCommand)
+        .addCommand(previewCommand);
+    // Set studio as the default command
     cmd.action(async (...args) => {
         await connect(...args);
     });

package/dist/src/commands/connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/commands/connect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,KAAK,UAAU,YAAY,CAAC,OAAuB;IACjD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACvD,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACjC,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAGhB,KAAK,EAAE,OAAO,EAAE,EAAE;IACpB,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,uBAAuB,CAAC;SACpC,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,CAAC;SAChE,MAAM,CAAC,YAAY,EAAE,kCAAkC,CAAC;SACxD,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC;SACjC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,CAAC;SACpC,MAAM,CACL,4BAA4B,EAC5B,uCAAuC,CACxC,CAAC;IAEJ,gEAAgE;IAChE,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAEhC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAsB,EAAE,EAAE;QAC7C,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;QACzC,MAAM,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/commands/connect.ts"],"names":[],"mappings":"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"}

package/dist/src/help.d.ts

@@ -1,7 +1,15 @@
 /**
- * Help text for the connect command
+ * Help text for the connect studio command
  */
-export declare const connectHelp = "\nCommand Overview:\n  The connect command starts the Connect Studio, a development environment for building\n  and testing Powerhouse applications. It provides a visual interface for working with \n  your project.\n\n  This command:\n  1. Starts a local Connect Studio server\n  2. Provides a web interface for development\n  3. Allows you to interact with your project components\n  4. Supports various configuration options for customization\n\nOptions:\n  -p, --port <port>      Port to run the server on. Default is 3000.\n                       \n  -h, --host             Expose the server to the network. By default, the server\n                        only accepts connections from localhost.\n                       \n  --https                Enable HTTPS for secure connections. You may need to provide\n                        certificate files for this option to work properly.\n                       \n  --open                 Automatically open the browser window after starting the server.\n                       \n  --config-file <path>   Path to the powerhouse.config.js file. This allows you to\n                        customize the behavior of Connect Studio.\n\nExamples:\n  $ ph connect                                # Start Connect Studio on default port 3000\n  $ ph connect -p 8080                        # Start on port 8080\n  $ ph connect -h                             # Expose to network (not just localhost)\n  $ ph connect --https                        # Enable HTTPS\n  $ ph connect --open                         # Open browser automatically\n  $ ph connect --config-file custom.config.js # Use custom configuration\n  $ ph connect -p 8080 --open                 # Start on port 8080 and open browser\n";
+export declare const connectStudioHelp = "\nCommand Overview:\n  The connect command starts the Connect Studio, a development environment for building\n  and testing Powerhouse applications. It provides a visual interface for working with \n  your project.\n\n  This command:\n  1. Starts a local Connect Studio server\n  2. Provides a web interface for development\n  3. Allows you to interact with your project components\n  4. Supports various configuration options for customization\n\nOptions:\n  -p, --port <port>      Port to run the server on. Default is 3000.\n                       \n  -h, --host             Expose the server to the network. By default, the server\n                        only accepts connections from localhost.\n                       \n  --https                Enable HTTPS for secure connections. You may need to provide\n                        certificate files for this option to work properly.\n                       \n  --open                 Automatically open the browser window after starting the server.\n                       \n  --config-file <path>   Path to the powerhouse.config.js file. This allows you to\n                        customize the behavior of Connect Studio.\n\nExamples:\n  $ ph connect                                # Start Connect Studio on default port 3000\n  $ ph connect -p 8080                        # Start on port 8080\n  $ ph connect -h                             # Expose to network (not just localhost)\n  $ ph connect --https                        # Enable HTTPS\n  $ ph connect --open                         # Open browser automatically\n  $ ph connect --config-file custom.config.js # Use custom configuration\n  $ ph connect -p 8080 --open                 # Start on port 8080 and open browser\n";
+/**
+ * Help text for the connect build command
+ */
+export declare const connectBuildHelp = "\nCommand Overview:\n  The Connect build command creates a connect build with the project's local and external packages included.\n\nOptions:\n  --project-root <path>  The root directory of the project. Default is \"process.cwd()\".\n  --assets-dir-name <name> The name of the assets directory. Default is \"assets\".\n  --external-packages-file-name <name> The name of the external packages file. Default is \"external-packages.js\".\n  --styles-file-name <name> The name of the styles file. Default is \"style.css\".\n  --connect-path <path>  The path to the Connect dist directory. Calls \"resolveConnect()\" if not provided.\n";
+/**
+ * Help text for the connect preview command
+ */
+export declare const connectPreviewHelp = "\nCommand Overview:\n  The Connect preview command previews a built Connect project.\n  NOTE: You must run `ph connect build` first.\n\nOptions:\n  --project-root <path>  The root directory of the project. Default is \"process.cwd()\".\n  --port <port>          The port to run the server on. Default is 4173.\n  --open                 Open the browser. Default is true.\n";
 /**
  * Help text for the generate command
  */

package/dist/src/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,WAAW,itDAkCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,kpGA0DxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,+jEAsCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,4pEAwCzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,ypCA2BpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,m7DAoCnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,miDAkCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,+mEAuCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,ixDAoC3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,s6DAuCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,2kCA0BvB,CAAC"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/help.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,eAAO,MAAM,iBAAiB,itDAkC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,2nBAU5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,yXAS9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,kpGA0DxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,+jEAsCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,4pEAwCzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,ypCA2BpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,m7DAoCnB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,miDAkCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,+mEAuCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,ixDAoC3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,s6DAuCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,2kCA0BvB,CAAC"}

package/dist/src/help.js

@@ -1,7 +1,8 @@
+import { DEFAULT_ASSETS_DIR_NAME, DEFAULT_EXTERNAL_PACKAGES_FILE_NAME, DEFAULT_STYLES_FILE_NAME, } from "@powerhousedao/builder-tools/connect-build";
 /**
- * Help text for the connect command
+ * Help text for the connect studio command
  */
-export const connectHelp = `
+export const connectStudioHelp = `
 Command Overview:
   The connect command starts the Connect Studio, a development environment for building
   and testing Powerhouse applications. It provides a visual interface for working with 
@@ -36,6 +37,33 @@ Examples:
   $ ph connect --config-file custom.config.js # Use custom configuration
   $ ph connect -p 8080 --open                 # Start on port 8080 and open browser
 `;
+/**
+ * Help text for the connect build command
+ */
+export const connectBuildHelp = `
+Command Overview:
+  The Connect build command creates a connect build with the project's local and external packages included.
+
+Options:
+  --project-root <path>  The root directory of the project. Default is "process.cwd()".
+  --assets-dir-name <name> The name of the assets directory. Default is "${DEFAULT_ASSETS_DIR_NAME}".
+  --external-packages-file-name <name> The name of the external packages file. Default is "${DEFAULT_EXTERNAL_PACKAGES_FILE_NAME}".
+  --styles-file-name <name> The name of the styles file. Default is "${DEFAULT_STYLES_FILE_NAME}".
+  --connect-path <path>  The path to the Connect dist directory. Calls "resolveConnect()" if not provided.
+`;
+/**
+ * Help text for the connect preview command
+ */
+export const connectPreviewHelp = `
+Command Overview:
+  The Connect preview command previews a built Connect project.
+  NOTE: You must run \`ph connect build\` first.
+
+Options:
+  --project-root <path>  The root directory of the project. Default is "process.cwd()".
+  --port <port>          The port to run the server on. Default is 4173.
+  --open                 Open the browser. Default is true.
+`;
 /**
  * Help text for the generate command
  */

package/dist/src/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0D3B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC5B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BvB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCtB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC9B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B1B,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,mCAAmC,EACnC,wBAAwB,GACzB,MAAM,4CAA4C,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkChC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;2EAM2C,uBAAuB;6FACL,mCAAmC;uEACzD,wBAAwB;;CAE9F,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;CASjC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0D3B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC5B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BvB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCtB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC9B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B1B,CAAC"}

package/dist/src/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,QAA8B,CAAC;AACjE,eAAO,MAAM,0BAA0B,UAAiC,CAAC;AAEzE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC3B,CAAC;AAEF,KAAK,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,qBAAqB,YAEpC;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,WAI9C;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,cAAc,GAAE,cAAsC,iBAevD;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAoB3D;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAUzE;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAYrE;AAED,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,gBAAgB,CAAC,UAAU,CAAM,EAClD,YAAY,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3E,IAAI,GAAE,SAAS,GAAG,WAAuB,GACxC,gBAAgB,CAAC,UAAU,CAAC,CAmB9B;AAGD,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3E,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,SAAS,GAAG,WAAuB,QAoB1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,cACtB,MAAM,cACL,MAAM,KACjB,MAAM,GAAG,IAeX,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiBzE;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,eAAO,MAAM,sBAAsB,2BAA2B,CAAC;AAC/D,eAAO,MAAM,qBAAqB,QAA8B,CAAC;AACjE,eAAO,MAAM,0BAA0B,UAAiC,CAAC;AAEzE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC3B,CAAC;AAEF,KAAK,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;AAE/C,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,qBAAqB,YAEpC;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,WAI9C;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,cAAc,GAAE,cAAsC,iBAevD;AAED,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,CAoB3D;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAUzE;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAYrE;AAED,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,gBAAgB,CAAC,UAAU,CAAM,EAClD,YAAY,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3E,IAAI,GAAE,SAAS,GAAG,WAAuB,GACxC,gBAAgB,CAAC,UAAU,CAAC,CAmB9B;AAGD,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAC3E,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,SAAS,GAAG,WAAuB,QAoB1C;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,sBAAsB,GACjC,WAAW,MAAM,EACjB,YAAY,MAAM,KACjB,MAAM,GAAG,IAeX,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiBzE;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "0.40.83-dev.0";
+export declare const version = "0.40.83-dev.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/src/version.js

@@ -1,3 +1,3 @@
 // This file is auto-generated. DO NOT EDIT.
-export const version = "0.40.83-dev.0";
+export const version = "0.40.83-dev.1";
 //# sourceMappingURL=version.js.map