@gxp-dev/tools 2.0.63 → 2.0.64

package/README.md

@@ -52,6 +52,7 @@ npm run dev-http
 ```
 
 When run in a directory with an existing `package.json` (no name argument), `gxdev init` will:
+
 - Add missing required dependencies and devDependencies
 - Update mismatched dependency versions
 - Add missing npm scripts (`dev`, `build`, `dev-http`, etc.)
@@ -62,26 +63,26 @@ It will **not** overwrite your source files (`src/`, `theme-layouts/`, etc.).
 
 ## CLI Commands
 
-| Command | Description |
-|---------|-------------|
-| `gxdev` | Launch interactive TUI |
-| `gxdev init [name]` | Create a new project or update an existing one |
-| `gxdev dev` | Start development server (HTTPS + TUI) |
-| `gxdev dev --no-https` | Start with HTTP only |
-| `gxdev dev --with-socket` | Start with Socket.IO server |
-| `gxdev dev --chrome` | Start and launch Chrome with extension |
-| `gxdev dev --firefox` | Start and launch Firefox with extension |
-| `gxdev build` | Build plugin for production |
-| `gxdev setup-ssl` | Generate SSL certificates for HTTPS development |
-| `gxdev publish <file>` | Copy runtime files to your project for customization |
+| Command                    | Description                                            |
+| -------------------------- | ------------------------------------------------------ |
+| `gxdev`                    | Launch interactive TUI                                 |
+| `gxdev init [name]`        | Create a new project or update an existing one         |
+| `gxdev dev`                | Start development server (HTTPS + TUI)                 |
+| `gxdev dev --no-https`     | Start with HTTP only                                   |
+| `gxdev dev --with-socket`  | Start with Socket.IO server                            |
+| `gxdev dev --chrome`       | Start and launch Chrome with extension                 |
+| `gxdev dev --firefox`      | Start and launch Firefox with extension                |
+| `gxdev build`              | Build plugin for production                            |
+| `gxdev setup-ssl`          | Generate SSL certificates for HTTPS development        |
+| `gxdev publish <file>`     | Copy runtime files to your project for customization   |
 | `gxdev datastore <action>` | Manage GxP datastore (list, add, scan-strings, config) |
-| `gxdev socket <action>` | Simulate socket events (list, send) |
-| `gxdev assets <action>` | Manage development assets (list, init, generate) |
-| `gxdev add-dependency` | Add API dependency via interactive wizard |
-| `gxdev extract-config` | Extract GxP config from source files |
-| `gxdev ext:chrome` | Launch Chrome with browser extension |
-| `gxdev ext:firefox` | Launch Firefox with browser extension |
-| `gxdev ext:build` | Build browser extensions for distribution |
+| `gxdev socket <action>`    | Simulate socket events (list, send)                    |
+| `gxdev assets <action>`    | Manage development assets (list, init, generate)       |
+| `gxdev add-dependency`     | Add API dependency via interactive wizard              |
+| `gxdev extract-config`     | Extract GxP config from source files                   |
+| `gxdev ext:chrome`         | Launch Chrome with browser extension                   |
+| `gxdev ext:firefox`        | Launch Firefox with browser extension                  |
+| `gxdev ext:build`          | Build browser extensions for distribution              |
 
 ## Features
 
@@ -121,18 +122,18 @@ The dev server automatically serves `index.html` and `main.js` from the toolkit
 
 Key variables (set in `.env`):
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `NODE_PORT` | `3060` | Development server port |
-| `SOCKET_IO_PORT` | `3061` | Socket.IO server port |
-| `COMPONENT_PATH` | `./src/Plugin.vue` | Main component path |
-| `USE_HTTPS` | `true` | Enable HTTPS |
-| `CERT_PATH` | | SSL certificate path |
-| `KEY_PATH` | | SSL private key path |
-| `USE_LOCAL_INDEX` | | Set to `true` to use a local `index.html` instead of the runtime version |
-| `USE_LOCAL_MAIN` | | Set to `true` to use a local `main.js` instead of the runtime version |
-| `SOCKET_IO_ENABLED` | `false` | Auto-start Socket.IO |
-| `API_ENV` | `mock` | API environment (mock, local, development, staging, production) |
+| Variable            | Default            | Description                                                              |
+| ------------------- | ------------------ | ------------------------------------------------------------------------ |
+| `NODE_PORT`         | `3060`             | Development server port                                                  |
+| `SOCKET_IO_PORT`    | `3061`             | Socket.IO server port                                                    |
+| `COMPONENT_PATH`    | `./src/Plugin.vue` | Main component path                                                      |
+| `USE_HTTPS`         | `true`             | Enable HTTPS                                                             |
+| `CERT_PATH`         |                    | SSL certificate path                                                     |
+| `KEY_PATH`          |                    | SSL private key path                                                     |
+| `USE_LOCAL_INDEX`   |                    | Set to `true` to use a local `index.html` instead of the runtime version |
+| `USE_LOCAL_MAIN`    |                    | Set to `true` to use a local `main.js` instead of the runtime version    |
+| `SOCKET_IO_ENABLED` | `false`            | Auto-start Socket.IO                                                     |
+| `API_ENV`           | `mock`             | API environment (mock, local, development, staging, production)          |
 
 ## Runtime vs Template
 

package/bin/gx-devtools.js

@@ -22,77 +22,97 @@
  */
 
 // Commands that should use the traditional CLI (one-shot commands)
-const ONE_SHOT_COMMANDS = ['init', 'build', 'publish', 'setup-ssl', 'ext:build', 'add-dependency', 'extract-config', '--help', '-h', '--version'];
+const ONE_SHOT_COMMANDS = [
+	"init",
+	"build",
+	"publish",
+	"setup-ssl",
+	"ext:build",
+	"add-dependency",
+	"extract-config",
+	"--help",
+	"-h",
+	"--version",
+]
 
 // Commands that should launch TUI with auto-start
-const TUI_AUTO_START_COMMANDS = ['dev', 'socket', 'ext:firefox', 'ext:chrome', 'datastore', 'assets'];
+const TUI_AUTO_START_COMMANDS = [
+	"dev",
+	"socket",
+	"ext:firefox",
+	"ext:chrome",
+	"datastore",
+	"assets",
+]
 
-const args = process.argv.slice(2);
-const command = args[0];
+const args = process.argv.slice(2)
+const command = args[0]
 
 // Check if this is a one-shot command
-const isOneShot = ONE_SHOT_COMMANDS.includes(command) ||
-                  (command && command.startsWith('-'));
+const isOneShot =
+	ONE_SHOT_COMMANDS.includes(command) || (command && command.startsWith("-"))
 
 // Check if we should use TUI with auto-start
-const isTuiCommand = TUI_AUTO_START_COMMANDS.includes(command);
+const isTuiCommand = TUI_AUTO_START_COMMANDS.includes(command)
 
 // --cli flag forces non-TUI mode regardless of TTY
-const forceCliMode = args.includes('--cli');
+const forceCliMode = args.includes("--cli")
 
 // If no command or TUI command, try to launch TUI
 // Fall back to traditional CLI if TUI dependencies are not available
 if (!isOneShot) {
-  const fs = require('fs');
-  const path = require('path');
-  // TUI output is in project root's dist/tui, not bin/dist/tui
-  const tuiPath = path.join(__dirname, '..', 'dist', 'tui', 'index.js');
+	const fs = require("fs")
+	const path = require("path")
+	// TUI output is in project root's dist/tui, not bin/dist/tui
+	const tuiPath = path.join(__dirname, "..", "dist", "tui", "index.js")
 
-  // Check if we're in an interactive terminal (TTY); fall back to CLI if not
-  const isTTY = process.stdout.isTTY && process.stdin.isTTY;
+	// Check if we're in an interactive terminal (TTY); fall back to CLI if not
+	const isTTY = process.stdout.isTTY && process.stdin.isTTY
 
-  if (fs.existsSync(tuiPath) && isTTY && !forceCliMode) {
-    // Use dynamic import() for ESM modules (ink v5 is ESM-only)
-    (async () => {
-      try {
-        const { startTUI } = await import(tuiPath);
+	if (fs.existsSync(tuiPath) && isTTY && !forceCliMode) {
+		// Use dynamic import() for ESM modules (ink v5 is ESM-only)
+		;(async () => {
+			try {
+				const { startTUI } = await import(tuiPath)
 
-        // Determine auto-start commands
-        const autoStart = [];
-        const tuiArgs = {};
+				// Determine auto-start commands
+				const autoStart = []
+				const tuiArgs = {}
 
-        if (command === 'dev') {
-          autoStart.push('dev');
-          if (args.includes('--with-socket') || args.includes('-s')) {
-            autoStart.push('socket');
-          }
-          tuiArgs.noHttps = args.includes('--no-https');
-        } else if (command === 'socket') {
-          autoStart.push('socket');
-        } else if (command === 'ext:firefox') {
-          autoStart.push('ext firefox');
-        } else if (command === 'ext:chrome') {
-          autoStart.push('ext chrome');
-        }
+				if (command === "dev") {
+					autoStart.push("dev")
+					if (args.includes("--with-socket") || args.includes("-s")) {
+						autoStart.push("socket")
+					}
+					tuiArgs.noHttps = args.includes("--no-https")
+				} else if (command === "socket") {
+					autoStart.push("socket")
+				} else if (command === "ext:firefox") {
+					autoStart.push("ext firefox")
+				} else if (command === "ext:chrome") {
+					autoStart.push("ext chrome")
+				}
 
-        startTUI({ autoStart, args: tuiArgs });
-      } catch (err) {
-        // TUI not available or no TTY — fall back to traditional CLI
-        if (err.message !== 'NO_TTY') {
-          console.error('TUI error:', err.message);
-        }
-        require("./lib/cli");
-      }
-    })();
-  } else if (!isTTY || forceCliMode) {
-    // Non-interactive shell or --cli flag — skip TUI and run directly
-    require("./lib/cli");
-  } else {
-    // TUI not compiled yet, use traditional CLI
-    console.log('Note: TUI not yet available. Run "npm run build:tui" to enable interactive mode.');
-    require("./lib/cli");
-  }
+				startTUI({ autoStart, args: tuiArgs })
+			} catch (err) {
+				// TUI not available or no TTY — fall back to traditional CLI
+				if (err.message !== "NO_TTY") {
+					console.error("TUI error:", err.message)
+				}
+				require("./lib/cli")
+			}
+		})()
+	} else if (!isTTY || forceCliMode) {
+		// Non-interactive shell or --cli flag — skip TUI and run directly
+		require("./lib/cli")
+	} else {
+		// TUI not compiled yet, use traditional CLI
+		console.log(
+			'Note: TUI not yet available. Run "npm run build:tui" to enable interactive mode.',
+		)
+		require("./lib/cli")
+	}
 } else {
-  // One-shot command, use traditional CLI
-  require("./lib/cli");
+	// One-shot command, use traditional CLI
+	require("./lib/cli")
 }

package/bin/lib/cli.js

@@ -7,8 +7,8 @@
  * It sets up yargs commands and delegates to the appropriate command modules.
  */
 
-const yargs = require("yargs");
-const { loadGlobalConfig } = require("./utils");
+const yargs = require("yargs")
+const { loadGlobalConfig } = require("./utils")
 const {
 	initCommand,
 	devCommand,
@@ -24,10 +24,10 @@ const {
 	extensionInstallCommand,
 	extractConfigCommand,
 	addDependencyCommand,
-} = require("./commands");
+} = require("./commands")
 
 // Load global configuration
-const globalConfig = loadGlobalConfig();
+const globalConfig = loadGlobalConfig()
 
 // Set up yargs CLI
 yargs
@@ -47,7 +47,8 @@ yargs
 				alias: "d",
 			},
 			build: {
-				describe: "AI build prompt - describe what to build for auto-scaffolding",
+				describe:
+					"AI build prompt - describe what to build for auto-scaffolding",
 				type: "string",
 				alias: "b",
 			},
@@ -64,19 +65,20 @@ yargs
 				default: false,
 			},
 			local: {
-				describe: "Initialize in current directory instead of creating a new one",
+				describe:
+					"Initialize in current directory instead of creating a new one",
 				type: "boolean",
 				alias: "l",
 				default: false,
 			},
 		},
-		initCommand
+		initCommand,
 	)
 	.command(
 		"setup-ssl",
 		"Setup SSL certificates for HTTPS development",
 		{},
-		setupSSLCommand
+		setupSSLCommand,
 	)
 	.command(
 		"dev",
@@ -123,7 +125,7 @@ yargs
 				alias: "m",
 			},
 		},
-		devCommand
+		devCommand,
 	)
 	.command(
 		"build",
@@ -140,7 +142,7 @@ yargs
 				default: "./src/Plugin.vue",
 			},
 		},
-		buildCommand
+		buildCommand,
 	)
 	.command(
 		"publish [file]",
@@ -151,7 +153,7 @@ yargs
 				type: "string",
 			},
 		},
-		publishCommand
+		publishCommand,
 	)
 	.command(
 		"datastore <action>",
@@ -182,25 +184,25 @@ yargs
 				type: "string",
 			},
 		},
-		datastoreCommand
+		datastoreCommand,
 	)
 	.command(
 		"ext:firefox",
 		"Launch Firefox with browser extension",
 		{},
-		extensionFirefoxCommand
+		extensionFirefoxCommand,
 	)
 	.command(
 		"ext:chrome",
 		"Launch Chrome with browser extension",
 		{},
-		extensionChromeCommand
+		extensionChromeCommand,
 	)
 	.command(
 		"ext:build",
 		"Build browser extensions for distribution",
 		{},
-		extensionBuildCommand
+		extensionBuildCommand,
 	)
 	.command(
 		"ext:install <browser>",
@@ -212,7 +214,7 @@ yargs
 				type: "string",
 			},
 		},
-		extensionInstallCommand
+		extensionInstallCommand,
 	)
 	.command(
 		"socket <action>",
@@ -231,7 +233,7 @@ yargs
 				type: "string",
 			},
 		},
-		socketCommand
+		socketCommand,
 	)
 	.command(
 		"assets <action>",
@@ -272,7 +274,7 @@ yargs
 				default: 1,
 			},
 		},
-		assetsCommand
+		assetsCommand,
 	)
 	.command(
 		"extract-config",
@@ -297,7 +299,7 @@ yargs
 				alias: "v",
 			},
 		},
-		extractConfigCommand
+		extractConfigCommand,
 	)
 	.command(
 		"add-dependency",
@@ -311,9 +313,9 @@ yargs
 				alias: "e",
 			},
 		},
-		addDependencyCommand
+		addDependencyCommand,
 	)
 	.demandCommand(1, "Please provide a valid command")
 	.help("h")
 	.alias("h", "help")
-	.parse();
+	.parse()