@fgv/ts-res-browser-cli 5.0.0-2

package/README.md

@@ -0,0 +1,131 @@
+# @fgv/ts-res-browser-cli
+
+Command-line interface to launch ts-res-browser with specified resources and configuration.
+
+## Features
+
+- **ZIP Archive Creation**: Automatically creates ZIP archives containing resources and configuration for easy browser loading
+- **Development Server Integration**: Can automatically start and manage the ts-res-browser development server
+- **Flexible Resource Input**: Supports both individual files and entire directory trees
+- **Configuration Management**: Works with predefined configurations or custom configuration files
+- **Context Filtering**: Apply context filters and qualifier settings via command line
+- **Interactive Mode**: Launch with sample data for exploration
+
+## Installation
+
+```bash
+npm install -g @fgv/ts-res-browser-cli
+```
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Launch browser with resources from a directory
+ts-res-browser-cli browse --input ./resources --config default
+
+# Launch with a specific configuration file
+ts-res-browser-cli browse --input ./my-resources --config ./config.json
+
+# Create ZIP and launch without opening browser automatically
+ts-res-browser-cli browse --input ./resources --config extended-example --no-open
+```
+
+### ZIP Workflow
+
+The CLI automatically creates ZIP archives containing your resources and configuration:
+
+1. **ZIP Creation**: Resources and configuration are bundled into a timestamped ZIP file in your Downloads folder
+2. **Manifest Generation**: Each ZIP includes a manifest with metadata about the bundled content
+3. **Browser Integration**: The browser can directly load and process these ZIP archives
+
+```bash
+# Creates: ~/Downloads/ts-res-bundle-[timestamp].zip
+ts-res-browser-cli browse --input ./resources --config my-config
+```
+
+### Development Server
+
+```bash
+# Automatically start development server locally
+ts-res-browser-cli browse --input ./resources --dev
+
+# Use existing server at custom URL  
+ts-res-browser-cli browse --input ./resources --url http://localhost:3001
+```
+
+### Advanced Options
+
+```bash
+# Apply context filtering
+ts-res-browser-cli browse \
+  --input ./resources \
+  --context-filter "language=en-US|territory=US" \
+  --reduce-qualifiers
+
+# Interactive mode with sample data
+ts-res-browser-cli browse --interactive
+
+# Verbose output
+ts-res-browser-cli browse --input ./resources --verbose
+```
+
+## Command Reference
+
+### `browse` Command
+
+Launch ts-res-browser with specified resources and configuration.
+
+**Options:**
+- `-i, --input <path>`: Input file or directory path
+- `--config <name|path>`: Predefined configuration name or file path
+- `-c, --context <json>`: Context filter (JSON string)  
+- `--context-filter <token>`: Context filter (pipe-separated)
+- `--qualifier-defaults <token>`: Qualifier defaults (pipe-separated)
+- `--resource-types <types>`: Resource type filter (comma-separated)
+- `--max-distance <number>`: Maximum distance for language matching
+- `--reduce-qualifiers`: Remove perfectly matching qualifier conditions
+- `-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
+- `-v, --verbose`: Verbose output
+- `-q, --quiet`: Quiet output
+
+### `config` Command
+
+Manage system configurations (future enhancement).
+
+## ZIP Archive Format
+
+Created ZIP archives contain:
+
+```
+ts-res-bundle-[timestamp].zip
+├── manifest.json          # Archive metadata
+├── input/                 # Resource files (preserving structure)
+│   ├── file1.json
+│   └── subdirectory/
+│       └── file2.json
+└── config.json           # Configuration (if provided)
+```
+
+The manifest includes:
+- Timestamp of archive creation
+- Input file/directory metadata
+- Configuration file metadata
+- Original paths for reference
+
+## Integration with ts-res-browser
+
+The browser application includes a dedicated ZIP Loader tool that can:
+- Directly load ZIP archives created by this CLI
+- Parse manifests and apply configurations automatically
+- Process resources through the standard ts-res pipeline
+- Provide seamless transition from CLI to browser workflow
+
+## License
+
+MIT

package/bin/ts-res-browser-cli.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+const { TsResBrowserCliApp } = require('../lib/cli');
+
+async function main() {
+  try {
+    const app = new TsResBrowserCliApp();
+    await app.run(process.argv);
+  } catch (error) {
+    console.error('Fatal error:', error.message);
+    process.exit(1);
+  }
+}
+
+main().catch((error) => {
+  console.error('Unhandled error:', error);
+  process.exit(1);
+});

package/config/rig.json

@@ -0,0 +1,16 @@
+// The "rig.json" file directs tools to look for their config files in an external package.
+// Documentation for this system: https://www.npmjs.com/package/@rushstack/rig-package
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/rig-package/rig.schema.json",
+  /**
+   * (Required) The name of the rig package to inherit from.
+   * It should be an NPM package name with the "-rig" suffix.
+   */
+  "rigPackageName": "@rushstack/heft-node-rig",
+  /**
+   * (Optional) Selects a config profile from the rig package.  The name must consist of
+   * lowercase alphanumeric words separated by hyphens, for example "sample-profile".
+   * If omitted, then the "default" profile will be used."
+   */
+  "rigProfile": "default"
+}

package/lib/browserLauncher.d.ts

@@ -0,0 +1,53 @@
+import { Result } from '@fgv/ts-utils';
+import { IBrowseOptions } from './options';
+/**
+ * Manages launching the browser application with specified options
+ */
+export declare class BrowserLauncher {
+    private _devServer?;
+    /**
+     * Launches the browser with the specified options
+     */
+    launch(options: IBrowseOptions): Promise<Result<void>>;
+    /**
+     * Opens the browser to the specified URL
+     */
+    private _openBrowser;
+    /**
+     * Builds the URL with query parameters based on options
+     */
+    private _buildUrl;
+    /**
+     * Starts the development server for ts-res-browser
+     */
+    private _startDevServer;
+    /**
+     * Waits for the development server to be ready by checking HTTP availability
+     */
+    private _waitForServerReady;
+    /**
+     * Checks if the server is responding
+     */
+    private _checkServerHealth;
+    /**
+     * Stops the development server
+     */
+    private _stopDevServer;
+    /**
+     * Sleep for the specified number of milliseconds
+     */
+    private _sleep;
+    /**
+     * 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;
+    /**
+     * Graceful shutdown - stops development server if running
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=browserLauncher.d.ts.map

package/lib/browserLauncher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserLauncher.d.ts","sourceRoot":"","sources":["../src/browserLauncher.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAI3C;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAC,CAAe;IAClC;;OAEG;IACU,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAoGnE;;OAEG;YACW,YAAY;IAkB1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAqDjB;;OAEG;YACW,eAAe;IAuC7B;;OAEG;YACW,mBAAmB;IA4BjC;;OAEG;YACW,kBAAkB;IAiBhC;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;YACW,iBAAiB;IAa/B;;OAEG;IACI,QAAQ,IAAI,IAAI;CAGxB"}

package/lib/browserLauncher.js

@@ -0,0 +1,347 @@
+"use strict";
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserLauncher = 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");
+/**
+ * Manages launching the browser application with specified options
+ */
+class BrowserLauncher {
+    /**
+     * Launches the browser with the specified options
+     */
+    async launch(options) {
+        try {
+            // Check if we need to create a ZIP archive for file-based inputs
+            let zipCreated = false;
+            let finalOptions = Object.assign({}, options);
+            if (this._shouldCreateZip(options)) {
+                if (!options.quiet) {
+                    console.log('Creating ZIP archive for file-based resources...');
+                }
+                const zipResult = await this._createZipArchive(options);
+                if (zipResult.isFailure()) {
+                    return (0, ts_utils_1.fail)(`Failed to create ZIP archive: ${zipResult.message}`);
+                }
+                if (!options.quiet) {
+                    console.log(`ZIP archive created: ${zipResult.value.zipPath}`);
+                }
+                // Modify options to use ZIP loading instead of file paths
+                const zipFileName = path.basename(zipResult.value.zipPath);
+                finalOptions = Object.assign(Object.assign({}, options), { input: undefined, config: undefined, 
+                    // Add ZIP loading parameters
+                    loadZip: true, zipFile: zipFileName, zipPath: zipResult.value.zipPath });
+                zipCreated = true;
+            }
+            // Start development server if requested
+            if (finalOptions.dev && !finalOptions.url) {
+                if (!finalOptions.quiet) {
+                    console.log('Starting TS-RES Browser development server...');
+                }
+                const serverResult = await this._startDevServer(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);
+            if (!finalOptions.quiet) {
+                console.log('Opening TS-RES Browser...');
+                if (zipCreated) {
+                    console.log('ZIP archive created - browser will load from Downloads folder');
+                }
+                else {
+                    if (finalOptions.input) {
+                        console.log(`Resource file: ${finalOptions.input}`);
+                    }
+                    if (finalOptions.config) {
+                        console.log(`Configuration: ${finalOptions.config}`);
+                    }
+                }
+                if (finalOptions.contextFilter) {
+                    console.log(`Context filter: ${finalOptions.contextFilter}`);
+                }
+                console.log(`URL: ${url}`);
+            }
+            // Open browser if requested (default to true)
+            const shouldOpen = finalOptions.open !== false;
+            if (shouldOpen) {
+                const openResult = await this._openBrowser(url, finalOptions.verbose || false);
+                if (openResult.isFailure()) {
+                    return (0, ts_utils_1.fail)(`Could not open browser: ${openResult.message}`);
+                }
+                if (!finalOptions.quiet) {
+                    console.log('Browser opened successfully');
+                }
+            }
+            else {
+                console.log(`Browser URL: ${url}`);
+            }
+            return (0, ts_utils_1.succeed)(undefined);
+        }
+        catch (error) {
+            return (0, ts_utils_1.fail)(`Failed to launch browser: ${error}`);
+        }
+    }
+    /**
+     * Opens the browser to the specified URL
+     */
+    async _openBrowser(url, verbose) {
+        return new Promise((resolve) => {
+            const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start ""' : 'xdg-open';
+            (0, child_process_1.exec)(`${command} "${url}"`, (error) => {
+                if (error) {
+                    resolve((0, ts_utils_1.fail)(`Failed to open browser: ${error.message}`));
+                }
+                else {
+                    if (verbose) {
+                        console.log(`Opened browser to: ${url}`);
+                    }
+                    resolve((0, ts_utils_1.succeed)(undefined));
+                }
+            });
+        });
+    }
+    /**
+     * 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}`;
+        const params = new URLSearchParams();
+        if (options.input) {
+            params.set('input', options.input);
+        }
+        if (options.config) {
+            params.set('config', options.config);
+        }
+        if (options.contextFilter) {
+            params.set('contextFilter', options.contextFilter);
+        }
+        if (options.qualifierDefaults) {
+            params.set('qualifierDefaults', options.qualifierDefaults);
+        }
+        if (options.resourceTypes) {
+            params.set('resourceTypes', options.resourceTypes);
+        }
+        if (options.maxDistance !== undefined) {
+            params.set('maxDistance', options.maxDistance.toString());
+        }
+        if (options.reduceQualifiers) {
+            params.set('reduceQualifiers', 'true');
+        }
+        if (options.interactive) {
+            params.set('interactive', 'true');
+        }
+        if (options.loadZip) {
+            params.set('loadZip', 'true');
+        }
+        if (options.zipFile) {
+            params.set('zipFile', options.zipFile);
+        }
+        if (options.zipPath) {
+            params.set('zipPath', options.zipPath);
+        }
+        const queryString = params.toString();
+        return queryString ? `${baseUrl}?${queryString}` : baseUrl;
+    }
+    /**
+     * Starts the development server for ts-res-browser
+     */
+    async _startDevServer(options) {
+        try {
+            // Find the ts-res-browser project directory
+            // Assume we're running from tools/ts-res-browser-cli, so go up and over to tools/ts-res-browser
+            const browserProjectPath = path.resolve(__dirname, '../../ts-res-browser');
+            if (options.verbose) {
+                console.log(`Looking for ts-res-browser at: ${browserProjectPath}`);
+            }
+            const port = options.port || 3000;
+            const env = Object.assign(Object.assign({}, process.env), { PORT: port.toString() });
+            this._devServer = (0, child_process_1.spawn)('rushx', ['dev'], {
+                cwd: browserProjectPath,
+                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));
+    }
+    /**
+     * Determines if a ZIP archive should be created based on the options
+     */
+    _shouldCreateZip(options) {
+        // Create ZIP if input or config are file paths (not predefined names)
+        const hasFilePath = (path) => {
+            if (!path)
+                return false;
+            // Check if it's a file path (contains directory separators or file extensions)
+            return path.includes('/') || path.includes('\\') || (path.includes('.') && !path.startsWith('.'));
+        };
+        return hasFilePath(options.input) || hasFilePath(options.config);
+    }
+    /**
+     * Creates a ZIP archive containing the input and config files
+     */
+    async _createZipArchive(options) {
+        try {
+            return await zipArchiver_1.zipArchiver.createArchive({
+                input: options.input,
+                config: options.config
+            });
+        }
+        catch (error) {
+            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

package/lib/browserLauncher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserLauncher.js","sourceRoot":"","sources":["../src/browserLauncher.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,iDAA0D;AAC1D,2CAA6B;AAC7B,2CAA6B;AAC7B,4CAAsD;AAEtD,+CAA4C;AAG5C;;GAEG;AACH,MAAa,eAAe;IAE1B;;OAEG;IACI,KAAK,CAAC,MAAM,CAAC,OAAuB;QACzC,IAAI,CAAC;YACH,iEAAiE;YACjE,IAAI,UAAU,GAAG,KAAK,CAAC;YACvB,IAAI,YAAY,qBAAQ,OAAO,CAAE,CAAC;YAElC,IAAI,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;gBAClE,CAAC;gBAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBACxD,IAAI,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC1B,OAAO,IAAA,eAAI,EAAC,iCAAiC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpE,CAAC;gBAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,wBAAwB,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjE,CAAC;gBAED,0DAA0D;gBAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC3D,YAAY,mCACP,OAAO,KACV,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,SAAS;oBACjB,6BAA6B;oBAC7B,OAAO,EAAE,IAAI,EACb,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,GACjC,CAAC;gBACF,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;YAED,wCAAwC;YACxC,IAAI,YAAY,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;gBAC1C,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;oBACxB,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;gBAC/D,CAAC;gBAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;gBAC9D,IAAI,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC7B,OAAO,YAAY,CAAC;gBACtB,CAAC;gBAED,8BAA8B;gBAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;gBAClC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;gBACnF,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC5B,IAAI,CAAC,cAAc,EAAE,CAAC;oBACtB,OAAO,WAAW,CAAC;gBACrB,CAAC;gBAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,sCAAsC,IAAI,EAAE,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;YAED,4BAA4B;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAEzC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;gBACzC,IAAI,UAAU,EAAE,CAAC;oBACf,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;gBAC/E,CAAC;qBAAM,CAAC;oBACN,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;wBACvB,OAAO,CAAC,GAAG,CAAC,kBAAkB,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC;oBACtD,CAAC;oBACD,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;wBACxB,OAAO,CAAC,GAAG,CAAC,kBAAkB,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;oBACvD,CAAC;gBACH,CAAC;gBACD,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;oBAC/B,OAAO,CAAC,GAAG,CAAC,mBAAmB,YAAY,CAAC,aAAa,EAAE,CAAC,CAAC;gBAC/D,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;YAC7B,CAAC;YAED,8CAA8C;YAC9C,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,KAAK,KAAK,CAAC;YAC/C,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;gBAC/E,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;oBAC3B,OAAO,IAAA,eAAI,EAAC,2BAA2B,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC/D,CAAC;gBAED,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;oBACxB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;YACrC,CAAC;YAED,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,eAAI,EAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,GAAW,EAAE,OAAgB;QACtD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,OAAO,GACX,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;YAElG,IAAA,oBAAI,EAAC,GAAG,OAAO,KAAK,GAAG,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE;gBACpC,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,CAAC,IAAA,eAAI,EAAC,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC5D,CAAC;qBAAM,CAAC;oBACN,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;oBAC3C,CAAC;oBACD,OAAO,CAAC,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,OAAuB;QACvC,2CAA2C;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,oBAAoB,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAErC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,OAAuB;QACnD,IAAI,CAAC;YACH,4CAA4C;YAC5C,gGAAgG;YAChG,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;YAE3E,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,kCAAkC,kBAAkB,EAAE,CAAC,CAAC;YACtE,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;YAClC,MAAM,GAAG,mCAAQ,OAAO,CAAC,GAAG,KAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAE,CAAC;YAEtD,IAAI,CAAC,UAAU,GAAG,IAAA,qBAAK,EAAC,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE;gBACxC,GAAG,EAAE,kBAAkB;gBACvB,GAAG;gBACH,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAChE,CAAC,CAAC;YAEH,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACpC,OAAO,IAAA,eAAI,EAAC,uCAAuC,KAAK,EAAE,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC;YAEH,oCAAoC;YACpC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAExB,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;gBAC/C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;gBACjE,CAAC;gBACD,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAA,eAAI,EAAC,4CAA4C,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,eAAI,EAAC,uCAAuC,KAAK,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,mBAAmB,CAC/B,IAAY,EACZ,OAAgB,EAChB,cAAsB,EAAE;QAExB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACpD,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO,CAAC,GAAG,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;oBAC7D,CAAC;oBACD,OAAO,IAAA,kBAAO,EAAC,SAAS,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,yCAAyC;YAC3C,CAAC;YAED,IAAI,OAAO,IAAI,OAAO,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,8CAA8C,OAAO,IAAI,WAAW,GAAG,CAAC,CAAC;YACvF,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,OAAO,IAAA,eAAI,EAAC,qCAAqC,WAAW,WAAW,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAAC,IAAY;QAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC3D,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;YACzF,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvB,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE;gBAC5B,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,cAAc;QACpB,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChC,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;oBAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,EAAU;QACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAuB;QAC9C,sEAAsE;QACtE,MAAM,WAAW,GAAG,CAAC,IAAwB,EAAW,EAAE;YACxD,IAAI,CAAC,IAAI;gBAAE,OAAO,KAAK,CAAC;YACxB,+EAA+E;YAC/E,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QACpG,CAAC,CAAC;QAEF,OAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAC7B,OAAuB;QAEvB,IAAI,CAAC;YACH,OAAO,MAAM,yBAAW,CAAC,aAAa,CAAC;gBACrC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAA,eAAI,EAAC,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;IAED;;OAEG;IACI,QAAQ;QACb,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;CACF;AA5UD,0CA4UC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { exec, spawn, ChildProcess } from 'child_process';\nimport * as path from 'path';\nimport * as http from 'http';\nimport { Result, succeed, fail } from '@fgv/ts-utils';\nimport { IBrowseOptions } from './options';\nimport { zipArchiver } from './zipArchiver';\nimport * as fs from 'fs';\n\n/**\n * Manages launching the browser application with specified options\n */\nexport class BrowserLauncher {\n  private _devServer?: ChildProcess;\n  /**\n   * Launches the browser with the specified options\n   */\n  public async launch(options: IBrowseOptions): Promise<Result<void>> {\n    try {\n      // Check if we need to create a ZIP archive for file-based inputs\n      let zipCreated = false;\n      let finalOptions = { ...options };\n\n      if (this._shouldCreateZip(options)) {\n        if (!options.quiet) {\n          console.log('Creating ZIP archive for file-based resources...');\n        }\n\n        const zipResult = await this._createZipArchive(options);\n        if (zipResult.isFailure()) {\n          return fail(`Failed to create ZIP archive: ${zipResult.message}`);\n        }\n\n        if (!options.quiet) {\n          console.log(`ZIP archive created: ${zipResult.value.zipPath}`);\n        }\n\n        // Modify options to use ZIP loading instead of file paths\n        const zipFileName = path.basename(zipResult.value.zipPath);\n        finalOptions = {\n          ...options,\n          input: undefined,\n          config: undefined,\n          // Add ZIP loading parameters\n          loadZip: true,\n          zipFile: zipFileName,\n          zipPath: zipResult.value.zipPath\n        };\n        zipCreated = true;\n      }\n\n      // Start development server if requested\n      if (finalOptions.dev && !finalOptions.url) {\n        if (!finalOptions.quiet) {\n          console.log('Starting TS-RES Browser development server...');\n        }\n\n        const serverResult = await this._startDevServer(finalOptions);\n        if (serverResult.isFailure()) {\n          return serverResult;\n        }\n\n        // Wait for server to be ready\n        const port = options.port || 3000;\n        const readyResult = await this._waitForServerReady(port, options.verbose || false);\n        if (readyResult.isFailure()) {\n          this._stopDevServer();\n          return readyResult;\n        }\n\n        if (!options.quiet) {\n          console.log(`Development server started on port ${port}`);\n        }\n      }\n\n      // Build URL with parameters\n      const url = this._buildUrl(finalOptions);\n\n      if (!finalOptions.quiet) {\n        console.log('Opening TS-RES Browser...');\n        if (zipCreated) {\n          console.log('ZIP archive created - browser will load from Downloads folder');\n        } else {\n          if (finalOptions.input) {\n            console.log(`Resource file: ${finalOptions.input}`);\n          }\n          if (finalOptions.config) {\n            console.log(`Configuration: ${finalOptions.config}`);\n          }\n        }\n        if (finalOptions.contextFilter) {\n          console.log(`Context filter: ${finalOptions.contextFilter}`);\n        }\n        console.log(`URL: ${url}`);\n      }\n\n      // Open browser if requested (default to true)\n      const shouldOpen = finalOptions.open !== false;\n      if (shouldOpen) {\n        const openResult = await this._openBrowser(url, finalOptions.verbose || false);\n        if (openResult.isFailure()) {\n          return fail(`Could not open browser: ${openResult.message}`);\n        }\n\n        if (!finalOptions.quiet) {\n          console.log('Browser opened successfully');\n        }\n      } else {\n        console.log(`Browser URL: ${url}`);\n      }\n\n      return succeed(undefined);\n    } catch (error) {\n      return fail(`Failed to launch browser: ${error}`);\n    }\n  }\n\n  /**\n   * Opens the browser to the specified URL\n   */\n  private async _openBrowser(url: string, verbose: boolean): Promise<Result<void>> {\n    return new Promise((resolve) => {\n      const command =\n        process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start \"\"' : 'xdg-open';\n\n      exec(`${command} \"${url}\"`, (error) => {\n        if (error) {\n          resolve(fail(`Failed to open browser: ${error.message}`));\n        } else {\n          if (verbose) {\n            console.log(`Opened browser to: ${url}`);\n          }\n          resolve(succeed(undefined));\n        }\n      });\n    });\n  }\n\n  /**\n   * Builds the URL with query parameters based on options\n   */\n  private _buildUrl(options: IBrowseOptions): string {\n    // Use provided URL or default to localhost\n    const baseUrl = options.url || `http://localhost:${options.port || 3000}`;\n    const params = new URLSearchParams();\n\n    if (options.input) {\n      params.set('input', options.input);\n    }\n\n    if (options.config) {\n      params.set('config', options.config);\n    }\n\n    if (options.contextFilter) {\n      params.set('contextFilter', options.contextFilter);\n    }\n\n    if (options.qualifierDefaults) {\n      params.set('qualifierDefaults', options.qualifierDefaults);\n    }\n\n    if (options.resourceTypes) {\n      params.set('resourceTypes', options.resourceTypes);\n    }\n\n    if (options.maxDistance !== undefined) {\n      params.set('maxDistance', options.maxDistance.toString());\n    }\n\n    if (options.reduceQualifiers) {\n      params.set('reduceQualifiers', 'true');\n    }\n\n    if (options.interactive) {\n      params.set('interactive', 'true');\n    }\n\n    if (options.loadZip) {\n      params.set('loadZip', 'true');\n    }\n\n    if (options.zipFile) {\n      params.set('zipFile', options.zipFile);\n    }\n\n    if (options.zipPath) {\n      params.set('zipPath', options.zipPath);\n    }\n\n    const queryString = params.toString();\n    return queryString ? `${baseUrl}?${queryString}` : baseUrl;\n  }\n\n  /**\n   * Starts the development server for ts-res-browser\n   */\n  private async _startDevServer(options: IBrowseOptions): Promise<Result<void>> {\n    try {\n      // Find the ts-res-browser project directory\n      // Assume we're running from tools/ts-res-browser-cli, so go up and over to tools/ts-res-browser\n      const browserProjectPath = path.resolve(__dirname, '../../ts-res-browser');\n\n      if (options.verbose) {\n        console.log(`Looking for ts-res-browser at: ${browserProjectPath}`);\n      }\n\n      const port = options.port || 3000;\n      const env = { ...process.env, PORT: port.toString() };\n\n      this._devServer = spawn('rushx', ['dev'], {\n        cwd: browserProjectPath,\n        env,\n        stdio: options.verbose ? 'inherit' : ['ignore', 'pipe', 'pipe']\n      });\n\n      this._devServer.on('error', (error) => {\n        return fail(`Failed to start development server: ${error}`);\n      });\n\n      // Give the server a moment to start\n      await this._sleep(3000);\n\n      if (this._devServer && !this._devServer.killed) {\n        if (options.verbose) {\n          console.log('Development server process started successfully');\n        }\n        return succeed(undefined);\n      } else {\n        return fail('Development server process failed to start');\n      }\n    } catch (error) {\n      return fail(`Failed to start development server: ${error}`);\n    }\n  }\n\n  /**\n   * Waits for the development server to be ready by checking HTTP availability\n   */\n  private async _waitForServerReady(\n    port: number,\n    verbose: boolean,\n    maxAttempts: number = 60\n  ): Promise<Result<void>> {\n    for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n      try {\n        const isReady = await this._checkServerHealth(port);\n        if (isReady) {\n          if (verbose) {\n            console.log(`Server is ready at http://localhost:${port}`);\n          }\n          return succeed(undefined);\n        }\n      } catch (error) {\n        // Server not ready yet, continue waiting\n      }\n\n      if (verbose && attempt % 10 === 0) {\n        console.log(`Waiting for server to be ready... (attempt ${attempt}/${maxAttempts})`);\n      }\n\n      await this._sleep(1000);\n    }\n\n    return fail(`Server did not become ready after ${maxAttempts} attempts`);\n  }\n\n  /**\n   * Checks if the server is responding\n   */\n  private async _checkServerHealth(port: number): Promise<boolean> {\n    return new Promise((resolve) => {\n      const request = http.get(`http://localhost:${port}`, (res) => {\n        resolve(res.statusCode !== undefined && res.statusCode >= 200 && res.statusCode < 400);\n      });\n\n      request.on('error', () => {\n        resolve(false);\n      });\n\n      request.setTimeout(3000, () => {\n        request.destroy();\n        resolve(false);\n      });\n    });\n  }\n\n  /**\n   * Stops the development server\n   */\n  private _stopDevServer(): void {\n    if (this._devServer && !this._devServer.killed) {\n      this._devServer.kill('SIGTERM');\n      setTimeout(() => {\n        if (this._devServer && !this._devServer.killed) {\n          this._devServer.kill('SIGKILL');\n        }\n      }, 5000);\n    }\n  }\n\n  /**\n   * Sleep for the specified number of milliseconds\n   */\n  private _sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  /**\n   * Determines if a ZIP archive should be created based on the options\n   */\n  private _shouldCreateZip(options: IBrowseOptions): boolean {\n    // Create ZIP if input or config are file paths (not predefined names)\n    const hasFilePath = (path: string | undefined): boolean => {\n      if (!path) return false;\n      // Check if it's a file path (contains directory separators or file extensions)\n      return path.includes('/') || path.includes('\\\\') || (path.includes('.') && !path.startsWith('.'));\n    };\n\n    return hasFilePath(options.input) || hasFilePath(options.config);\n  }\n\n  /**\n   * Creates a ZIP archive containing the input and config files\n   */\n  private async _createZipArchive(\n    options: IBrowseOptions\n  ): Promise<Result<{ zipPath: string; manifest: any }>> {\n    try {\n      return await zipArchiver.createArchive({\n        input: options.input,\n        config: options.config\n      });\n    } catch (error) {\n      return fail(`Failed to create ZIP archive: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Graceful shutdown - stops development server if running\n   */\n  public shutdown(): void {\n    this._stopDevServer();\n  }\n}\n"]}

package/lib/cli.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Main CLI class for ts-res-browser-cli
+ */
+export declare class TsResBrowserCliApp {
+    private readonly _program;
+    private readonly _launcher;
+    constructor();
+    /**
+     * Runs the CLI with the provided arguments
+     */
+    run(argv: string[]): Promise<void>;
+    /**
+     * Sets up the CLI commands and options
+     */
+    private _setupCommands;
+    /**
+     * Check if any meaningful options were provided
+     */
+    private _hasOptions;
+    /**
+     * Handles the browse command
+     */
+    private _handleBrowseCommand;
+    /**
+     * Handles the config command (similar to ts-res-cli)
+     */
+    private _handleConfigCommand;
+    /**
+     * Parses and validates browse options
+     */
+    private _parseBrowseOptions;
+    /**
+     * Sets up graceful shutdown handling
+     */
+    private _setupGracefulShutdown;
+}
+//# sourceMappingURL=cli.d.ts.map