@fgv/ts-res-browser-cli 5.0.0-3 → 5.0.0-30

package/README.md

@@ -17,19 +17,28 @@ Command-line interface to launch ts-res-browser with specified resources and con
 npm install -g @fgv/ts-res-browser-cli
 ```
 
+Or use directly with npx (no installation required):
+
+```bash
+npx @fgv/ts-res-browser-cli --help
+```
+
 ## Usage
 
 ### Basic Usage
 
 ```bash
 # Launch browser with resources from a directory
-ts-res-browser-cli browse --input ./resources --config default
+ts-res-browser-cli browse --input ./resources --config default --serve
+
+# With npx (no installation required)
+npx @fgv/ts-res-browser-cli --input ./resources --config default --serve
 
 # Launch with a specific configuration file
-ts-res-browser-cli browse --input ./my-resources --config ./config.json
+ts-res-browser-cli browse --input ./my-resources --config ./config.json --serve
 
 # Create ZIP and launch without opening browser automatically
-ts-res-browser-cli browse --input ./resources --config extended-example --no-open
+ts-res-browser-cli browse --input ./resources --config extended-example --serve --no-open
 ```
 
 ### ZIP Workflow
@@ -42,19 +51,33 @@ The CLI automatically creates ZIP archives containing your resources and configu
 
 ```bash
 # Creates: ~/Downloads/ts-res-bundle-[timestamp].zip
-ts-res-browser-cli browse --input ./resources --config my-config
+ts-res-browser-cli browse --input ./resources --config my-config --serve
 ```
 
-### Development Server
+### Server Options
+
+The CLI provides several ways to launch the browser with a server:
 
 ```bash
-# Automatically start development server locally
+# Recommended: Universal server start (works everywhere)
+ts-res-browser-cli browse --input ./resources --serve
+
+# Development server (monorepo environment only)  
 ts-res-browser-cli browse --input ./resources --dev
 
-# Use existing server at custom URL  
+# Connect to existing server
 ts-res-browser-cli browse --input ./resources --url http://localhost:3001
 ```
 
+**Server Flag Behavior:**
+- `--serve`: Works in both monorepo and published packages
+  - **Monorepo**: Starts webpack dev server with hot reloading (port 3000)
+  - **Published packages**: Starts static file server (port 8080)
+- `--dev`: Development server with hot reloading (monorepo only)
+  - **Monorepo**: Same as `--serve` 
+  - **Published packages**: Shows error with instructions to use `--serve`
+- `--url`: Connect to existing server at specified URL
+
 ### Advanced Options
 
 ```bash
@@ -64,8 +87,8 @@ ts-res-browser-cli browse \
   --context-filter "language=en-US|territory=US" \
   --reduce-qualifiers
 
-# Interactive mode with sample data
-ts-res-browser-cli browse --interactive
+# Interactive mode with sample data (requires server)
+ts-res-browser-cli browse --interactive --serve
 
 # Verbose output
 ts-res-browser-cli browse --input ./resources --verbose
@@ -89,8 +112,9 @@ Launch ts-res-browser with specified resources and configuration.
 - `-p, --port <number>`: Port for local browser instance
 - `--url <url>`: URL of remote browser instance
 - `--no-open`: Do not open browser automatically
-- `--interactive`: Launch in interactive mode with sample data
-- `--dev`: Automatically start development server locally
+- `--interactive`: Launch in interactive mode with sample data (requires --serve, --dev, or --url)
+- `--serve`: Start server (dev in monorepo, serve in published packages) and connect automatically
+- `--dev`: Start development server locally (monorepo only)
 - `-v, --verbose`: Verbose output
 - `-q, --quiet`: Quiet output
 

package/eslint.config.js

@@ -0,0 +1,16 @@
+// ESLint 9 flat config
+const nodeProfile = require('@rushstack/eslint-config/flat/profile/node');
+const packletsPlugin = require('@rushstack/eslint-config/flat/mixins/packlets');
+const tsdocPlugin = require('@rushstack/eslint-config/flat/mixins/tsdoc');
+
+module.exports = [
+  ...nodeProfile,
+  packletsPlugin,
+  ...tsdocPlugin,
+  {
+    // Override specific rules if needed
+    rules: {
+      '@rushstack/packlets/mechanics': 'warn'
+    }
+  }
+];

package/lib/cli.d.ts

@@ -29,9 +29,5 @@ export declare class TsResBrowserCliApp {
      * Parses and validates browse options
      */
     private _parseBrowseOptions;
-    /**
-     * Sets up graceful shutdown handling
-     */
-    private _setupGracefulShutdown;
 }
 //# sourceMappingURL=cli.d.ts.map

package/lib/cli.js

@@ -60,16 +60,15 @@ const ts_utils_1 = require("@fgv/ts-utils");
 const TsRes = __importStar(require("@fgv/ts-res"));
 const fs_1 = require("fs");
 const path = __importStar(require("path"));
-const browserLauncher_1 = require("./browserLauncher");
+const simpleBrowserLauncher_1 = require("./simpleBrowserLauncher");
 /**
  * Main CLI class for ts-res-browser-cli
  */
 class TsResBrowserCliApp {
     constructor() {
         this._program = new commander_1.Command();
-        this._launcher = new browserLauncher_1.BrowserLauncher();
+        this._launcher = new simpleBrowserLauncher_1.SimpleBrowserLauncher();
         this._setupCommands();
-        this._setupGracefulShutdown();
     }
     /**
      * Runs the CLI with the provided arguments
@@ -102,6 +101,7 @@ class TsResBrowserCliApp {
             .option('--no-open', 'Do not open browser automatically')
             .option('--interactive', 'Launch in interactive mode with sample data', false)
             .option('--dev', 'Automatically start development server locally', false)
+            .option('--serve', 'Start server (dev in monorepo, serve in published packages) and connect automatically', false)
             .action(async (options) => {
             // If no options provided, show help
             if (!this._hasOptions(options)) {
@@ -130,6 +130,7 @@ class TsResBrowserCliApp {
             .option('--no-open', 'Do not open browser automatically')
             .option('--interactive', 'Launch in interactive mode with sample data', false)
             .option('--dev', 'Automatically start development server locally', false)
+            .option('--serve', 'Start server (dev in monorepo, serve in published packages) and connect automatically', false)
             .action(async (options) => {
             await this._handleBrowseCommand(options);
         });
@@ -161,7 +162,8 @@ class TsResBrowserCliApp {
             options.reduceQualifiers ||
             options.interactive ||
             options.url ||
-            options.dev);
+            options.dev ||
+            options.serve);
     }
     /**
      * Handles the browse command
@@ -348,7 +350,8 @@ class TsResBrowserCliApp {
                 url: options.url,
                 open: options.open,
                 interactive: options.interactive || false,
-                dev: options.dev || false
+                dev: options.dev || false,
+                serve: options.serve || false
             };
             return (0, ts_utils_1.succeed)(browseOptions);
         }
@@ -356,18 +359,6 @@ class TsResBrowserCliApp {
             return (0, ts_utils_1.fail)(`Failed to parse options: ${error}`);
         }
     }
-    /**
-     * Sets up graceful shutdown handling
-     */
-    _setupGracefulShutdown() {
-        const shutdown = (signal) => {
-            console.log(`\nReceived ${signal}, shutting down gracefully...`);
-            this._launcher.shutdown();
-            process.exit(0);
-        };
-        process.on('SIGINT', () => shutdown('SIGINT'));
-        process.on('SIGTERM', () => shutdown('SIGTERM'));
-    }
 }
 exports.TsResBrowserCliApp = TsResBrowserCliApp;
 //# sourceMappingURL=cli.js.map

package/lib/index.d.ts

@@ -1,4 +1,4 @@
 export * from './cli';
 export * from './options';
-export * from './browserLauncher';
+export * from './simpleBrowserLauncher';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -38,5 +38,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // Export main components
 __exportStar(require("./cli"), exports);
 __exportStar(require("./options"), exports);
-__exportStar(require("./browserLauncher"), exports);
+__exportStar(require("./simpleBrowserLauncher"), exports);
 //# sourceMappingURL=index.js.map

package/lib/options.d.ts

@@ -59,6 +59,10 @@ export interface IBrowseOptions {
      * Whether to automatically start the development server
      */
     dev?: boolean;
+    /**
+     * Whether to start server (dev in monorepo, serve in published packages) and connect automatically
+     */
+    serve?: boolean;
     /**
      * Whether to use ZIP loading mode (internal flag)
      */
@@ -91,5 +95,17 @@ export interface IBrowseCommandOptions {
     interactive?: boolean;
     url?: string;
     dev?: boolean;
+    serve?: boolean;
+}
+/**
+ * Command-line options for the config command
+ */
+export interface IConfigCommandOptions {
+    name?: string;
+    output?: string;
+    validate?: string;
+    normalize?: string;
+    qualifierDefaults?: string;
+    list?: boolean;
 }
 //# sourceMappingURL=options.d.ts.map

package/lib/simpleBrowserLauncher.d.ts

@@ -0,0 +1,32 @@
+import { Result } from '@fgv/ts-utils';
+import { IBrowseOptions } from './options';
+/**
+ * Simplified browser launcher using direct dependency on ts-res-browser
+ */
+export declare class SimpleBrowserLauncher {
+    /**
+     * Launches the browser with the specified options
+     */
+    launch(options: IBrowseOptions): Promise<Result<void>>;
+    /**
+     * Starts the server using ts-res-browser CLI directly
+     */
+    private _startServer;
+    /**
+     * Opens the browser to the specified URL
+     */
+    private _openBrowser;
+    /**
+     * Builds the URL with query parameters based on options
+     */
+    private _buildUrl;
+    /**
+     * Determines if a ZIP archive should be created based on the options
+     */
+    private _shouldCreateZip;
+    /**
+     * Creates a ZIP archive containing the input and config files
+     */
+    private _createZipArchive;
+}
+//# sourceMappingURL=simpleBrowserLauncher.d.ts.map

package/lib/{browserLauncher.js → simpleBrowserLauncher.js}

@@ -54,22 +54,28 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BrowserLauncher = void 0;
+exports.SimpleBrowserLauncher = void 0;
 const child_process_1 = require("child_process");
 const path = __importStar(require("path"));
-const http = __importStar(require("http"));
 const ts_utils_1 = require("@fgv/ts-utils");
 const zipArchiver_1 = require("./zipArchiver");
-const fs = __importStar(require("fs"));
 /**
- * Manages launching the browser application with specified options
+ * Simplified browser launcher using direct dependency on ts-res-browser
  */
-class BrowserLauncher {
+class SimpleBrowserLauncher {
     /**
      * Launches the browser with the specified options
      */
     async launch(options) {
         try {
+            // Validate options before proceeding
+            if (options.interactive && !options.dev && !options.serve && !options.url) {
+                return (0, ts_utils_1.fail)('Interactive mode requires either --dev/--serve to start a local server or --url to specify a remote server.\n\n' +
+                    'Examples:\n' +
+                    '  ts-res-browser-cli --interactive --dev\n' +
+                    '  ts-res-browser-cli --interactive --serve\n' +
+                    '  ts-res-browser-cli --interactive --url https://example.com/ts-res-browser');
+            }
             // Check if we need to create a ZIP archive for file-based inputs
             let zipCreated = false;
             let finalOptions = Object.assign({}, options);
@@ -91,25 +97,15 @@ class BrowserLauncher {
                     loadZip: true, zipFile: zipFileName, zipPath: zipResult.value.zipPath });
                 zipCreated = true;
             }
-            // Start development server if requested
-            if (finalOptions.dev && !finalOptions.url) {
+            // Start server if requested
+            if ((finalOptions.dev || finalOptions.serve) && !finalOptions.url) {
                 if (!finalOptions.quiet) {
-                    console.log('Starting TS-RES Browser development server...');
+                    console.log('Starting TS-RES Browser server...');
                 }
-                const serverResult = await this._startDevServer(finalOptions);
+                const serverResult = await this._startServer(finalOptions);
                 if (serverResult.isFailure()) {
                     return serverResult;
                 }
-                // Wait for server to be ready
-                const port = options.port || 3000;
-                const readyResult = await this._waitForServerReady(port, options.verbose || false);
-                if (readyResult.isFailure()) {
-                    this._stopDevServer();
-                    return readyResult;
-                }
-                if (!options.quiet) {
-                    console.log(`Development server started on port ${port}`);
-                }
             }
             // Build URL with parameters
             const url = this._buildUrl(finalOptions);
@@ -151,6 +147,39 @@ class BrowserLauncher {
             return (0, ts_utils_1.fail)(`Failed to launch browser: ${error}`);
         }
     }
+    /**
+     * Starts the server using ts-res-browser CLI directly
+     */
+    async _startServer(options) {
+        try {
+            // Use ts-res-browser directly from node_modules
+            const browserPath = require.resolve('@fgv/ts-res-browser/cli.js');
+            const command = `node "${browserPath}" ${options.dev ? 'dev' : 'serve'}`;
+            if (options.verbose) {
+                console.log(`Running: ${command}`);
+            }
+            return new Promise((resolve) => {
+                (0, child_process_1.exec)(command, (error) => {
+                    if (error) {
+                        resolve((0, ts_utils_1.fail)(`Failed to start server: ${error.message}`));
+                    }
+                    else {
+                        resolve((0, ts_utils_1.succeed)(undefined));
+                    }
+                });
+                // Give server time to start, then assume success
+                setTimeout(() => {
+                    if (options.verbose) {
+                        console.log('Server startup initiated');
+                    }
+                    resolve((0, ts_utils_1.succeed)(undefined));
+                }, 2000);
+            });
+        }
+        catch (error) {
+            return (0, ts_utils_1.fail)(`Failed to start server: ${error}`);
+        }
+    }
     /**
      * Opens the browser to the specified URL
      */
@@ -174,8 +203,9 @@ class BrowserLauncher {
      * Builds the URL with query parameters based on options
      */
     _buildUrl(options) {
-        // Use provided URL or default to localhost
-        const baseUrl = options.url || `http://localhost:${options.port || 3000}`;
+        // Use provided URL or default based on server type
+        const defaultPort = options.dev ? 3000 : 8080;
+        const baseUrl = options.url || `http://localhost:${options.port || defaultPort}`;
         const params = new URLSearchParams();
         if (options.input) {
             params.set('input', options.input);
@@ -213,139 +243,6 @@ class BrowserLauncher {
         const queryString = params.toString();
         return queryString ? `${baseUrl}?${queryString}` : baseUrl;
     }
-    /**
-     * Starts the development server for ts-res-browser
-     */
-    async _startDevServer(options) {
-        try {
-            const port = options.port || 3000;
-            const env = Object.assign(Object.assign({}, process.env), { PORT: port.toString() });
-            // Detect if we're in a monorepo or using published packages
-            const isMonorepo = this._isMonorepoEnvironment();
-            if (isMonorepo) {
-                // Monorepo development: use rushx from sibling project
-                const browserProjectPath = path.resolve(__dirname, '../../ts-res-browser');
-                if (options.verbose) {
-                    console.log(`Looking for ts-res-browser at: ${browserProjectPath}`);
-                }
-                this._devServer = (0, child_process_1.spawn)('rushx', ['dev'], {
-                    cwd: browserProjectPath,
-                    env,
-                    stdio: options.verbose ? 'inherit' : ['ignore', 'pipe', 'pipe']
-                });
-            }
-            else {
-                // Published packages: call ts-res-browser CLI directly
-                if (options.verbose) {
-                    console.log('Using published ts-res-browser package');
-                }
-                this._devServer = (0, child_process_1.spawn)('npx', ['ts-res-browser', 'dev', port.toString()], {
-                    env,
-                    stdio: options.verbose ? 'inherit' : ['ignore', 'pipe', 'pipe']
-                });
-            }
-            this._devServer.on('error', (error) => {
-                return (0, ts_utils_1.fail)(`Failed to start development server: ${error}`);
-            });
-            // Give the server a moment to start
-            await this._sleep(3000);
-            if (this._devServer && !this._devServer.killed) {
-                if (options.verbose) {
-                    console.log('Development server process started successfully');
-                }
-                return (0, ts_utils_1.succeed)(undefined);
-            }
-            else {
-                return (0, ts_utils_1.fail)('Development server process failed to start');
-            }
-        }
-        catch (error) {
-            return (0, ts_utils_1.fail)(`Failed to start development server: ${error}`);
-        }
-    }
-    /**
-     * Waits for the development server to be ready by checking HTTP availability
-     */
-    async _waitForServerReady(port, verbose, maxAttempts = 60) {
-        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-            try {
-                const isReady = await this._checkServerHealth(port);
-                if (isReady) {
-                    if (verbose) {
-                        console.log(`Server is ready at http://localhost:${port}`);
-                    }
-                    return (0, ts_utils_1.succeed)(undefined);
-                }
-            }
-            catch (error) {
-                // Server not ready yet, continue waiting
-            }
-            if (verbose && attempt % 10 === 0) {
-                console.log(`Waiting for server to be ready... (attempt ${attempt}/${maxAttempts})`);
-            }
-            await this._sleep(1000);
-        }
-        return (0, ts_utils_1.fail)(`Server did not become ready after ${maxAttempts} attempts`);
-    }
-    /**
-     * Checks if the server is responding
-     */
-    async _checkServerHealth(port) {
-        return new Promise((resolve) => {
-            const request = http.get(`http://localhost:${port}`, (res) => {
-                resolve(res.statusCode !== undefined && res.statusCode >= 200 && res.statusCode < 400);
-            });
-            request.on('error', () => {
-                resolve(false);
-            });
-            request.setTimeout(3000, () => {
-                request.destroy();
-                resolve(false);
-            });
-        });
-    }
-    /**
-     * Stops the development server
-     */
-    _stopDevServer() {
-        if (this._devServer && !this._devServer.killed) {
-            this._devServer.kill('SIGTERM');
-            setTimeout(() => {
-                if (this._devServer && !this._devServer.killed) {
-                    this._devServer.kill('SIGKILL');
-                }
-            }, 5000);
-        }
-    }
-    /**
-     * Sleep for the specified number of milliseconds
-     */
-    _sleep(ms) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    }
-    /**
-     * Detects if we're running in a monorepo environment
-     */
-    _isMonorepoEnvironment() {
-        try {
-            // Check if we have a rush.json file in parent directories (indicating monorepo)
-            let currentDir = __dirname;
-            for (let i = 0; i < 5; i++) {
-                // Look up to 5 levels up
-                const rushJsonPath = path.join(currentDir, 'rush.json');
-                if (fs.existsSync(rushJsonPath)) {
-                    return true;
-                }
-                currentDir = path.dirname(currentDir);
-            }
-            // Also check if ts-res-browser sibling directory exists
-            const browserProjectPath = path.resolve(__dirname, '../../ts-res-browser');
-            return (fs.existsSync(browserProjectPath) && fs.existsSync(path.join(browserProjectPath, 'package.json')));
-        }
-        catch (_a) {
-            return false;
-        }
-    }
     /**
      * Determines if a ZIP archive should be created based on the options
      */
@@ -373,12 +270,6 @@ class BrowserLauncher {
             return (0, ts_utils_1.fail)(`Failed to create ZIP archive: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    /**
-     * Graceful shutdown - stops development server if running
-     */
-    shutdown() {
-        this._stopDevServer();
-    }
 }
-exports.BrowserLauncher = BrowserLauncher;
-//# sourceMappingURL=browserLauncher.js.map
+exports.SimpleBrowserLauncher = SimpleBrowserLauncher;
+//# sourceMappingURL=simpleBrowserLauncher.js.map

package/lib/zipArchiver.d.ts

@@ -1,31 +1,19 @@
 import { Result } from '@fgv/ts-utils';
-export interface ZipArchiveOptions {
+import { ZipArchive } from '@fgv/ts-res';
+export interface IZipArchiveOptions {
     input?: string;
     config?: string;
     outputDir?: string;
 }
-export interface ZipArchiveResult {
+export interface IZipArchiveResult {
     zipPath: string;
-    manifest: ZipManifest;
-}
-export interface ZipManifest {
-    timestamp: string;
-    input?: {
-        type: 'file' | 'directory';
-        originalPath: string;
-        archivePath: string;
-    };
-    config?: {
-        type: 'file';
-        originalPath: string;
-        archivePath: string;
-    };
+    manifest: ZipArchive.IZipArchiveManifest;
 }
 export declare class ZipArchiver {
     /**
      * Create a ZIP archive containing the specified input and config files/directories
      */
-    createArchive(options: ZipArchiveOptions): Promise<Result<ZipArchiveResult>>;
+    createArchive(options: IZipArchiveOptions): Promise<Result<IZipArchiveResult>>;
     /**
      * Get the default downloads directory path
      */