@alcyone-labs/arg-parser 2.2.1 → 2.3.0

package/README.md

@@ -10,6 +10,7 @@ A modern, type-safe command line argument parser with built-in MCP (Model Contex
 - [How to Run It](#how-to-run-it)
   - [Setting Up System-Wide CLI Access](#setting-up-system-wide-cli-access)
 - [Parsing Command-Line Arguments](#parsing-command-line-arguments)
+  - [Automatic Argument Detection](#automatic-argument-detection)
   - [Cannonical Usage Pattern](#cannonical-usage-pattern)
   - [Top-level await](#top-level-await)
   - [Promise-based parsing](#promise-based-parsing)
@@ -36,13 +37,20 @@ A modern, type-safe command line argument parser with built-in MCP (Model Contex
     - [Common Pitfalls to Avoid](#common-pitfalls-to-avoid)
   - [Automatic MCP Server Mode (`--s-mcp-serve`)](#automatic-mcp-server-mode---s-mcp-serve)
   - [MCP Transports](#mcp-transports)
+  - [MCP Log Path Configuration](#mcp-log-path-configuration)
   - [Automatic Console Safety](#automatic-console-safety)
   - [Generating DXT Packages (`--s-build-dxt`)](#generating-dxt-packages---s-build-dxt)
   - [Logo Configuration](#logo-configuration)
     - [Supported Logo Sources](#supported-logo-sources)
   - [How DXT Generation Works](#how-dxt-generation-works)
+  - [DXT Bundling Strategies](#dxt-bundling-strategies)
 - [System Flags & Configuration](#system-flags--configuration)
 - [Changelog](#changelog)
+  - [v2.3.0](#v230)
+  - [v2.2.1](#v221)
+  - [v2.2.0](#v220)
+  - [v2.1.1](#v211)
+  - [v2.1.0](#v210)
   - [v2.0.0](#v200)
   - [v1.3.0](#v130)
   - [v1.2.0](#v120)
@@ -57,7 +65,7 @@ A modern, type-safe command line argument parser with built-in MCP (Model Contex
 - **Automatic MCP Integration**: Transform any CLI into a compliant MCP server with a single command (`--s-mcp-serve`).
 - **Console Safe**: `console.log` and other methods
   are automatically handled in MCP mode to prevent protocol contamination, requiring no changes to your code.
-- **DXT Package Generation**: Generate complete, ready-to-install Claude Desktop Extension (`.dxt`) packages with the `--s-build-dxt` command.
+- **DXT Package Generation**: Generate complete, ready-to-install Claude Desktop Extension (`.dxt`) packages with the `--s-build-dxt` command and `--s-with-node-modules` for platform-dependent builds.
 - **Hierarchical Sub-commands**: Create complex, nested sub-command structures (e.g., `git commit`, `docker container ls`) with flag inheritance.
 - **Configuration Management**: Easily load (`--s-with-env`) and save (`--s-save-to-env`) configurations from/to `.env`, `.json`, `.yaml`, and `.toml` files.
 - **Automatic Help & Error Handling**: Context-aware help text and user-friendly error messages are generated automatically.
@@ -162,6 +170,18 @@ mycli --s-mcp-serve
 
 # 3. Generate a DXT package for Claude Desktop (2-steps)
 mycli --s-build-dxt ./my-dxt-package
+
+# If you use ML models or packages that include binaries such as Sqlite3 or sharp, etc...
+# You need to bundle the node_modules folder with your DXT package
+# In order to do this, you need to use the following flag:
+# First hard-install all the packages
+rm -rf node_moduels
+pnpm install --prod --node-linker=hoisted
+# Then bundle with node_modules
+mycli --s-build-dxt ./my-dxt-package --s-with-node-modules
+# then packages the dxt
+npx @anthropic-ai/dxt pack ./my-dxt-package
+# then upload the dxt bundle to Claude Desktop from the settings > extensions > advanced screen
 ```
 
 Read more on generating the DXT package here: [Generating DXT Packages](#generating-dxt-packages---s-build-dxt)
@@ -1082,12 +1102,26 @@ my-cli-app --s-build-dxt ./my-dxt-package
 # A default logo will be applied if you don't provide one.
 
 # 2. (Optional) Pack the folder into a .dxt file for distribution
+# (you can install the unpacked folder) directly in Claude Desktop > Settings > Extensions > Advanced
 npx @anthropic-ai/dxt pack ./my-dxt-package
 
-# 3. (Optional) Sign the DXT package
+# 3. (Optional) Sign the DXT package - this has not been well tested yet
 npx @anthropic-ai/dxt sign ./my-dxt-package.dxt
 
 # Then drag & drop the .dxt file into Claude Desktop to install it, in the Settings > Extensions screen.
+
+# **IMPORTANT**:
+# If you use ML models or packages that include binaries such as Sqlite3 or sharp, etc...
+# You need to bundle the node_modules folder with your DXT package
+# In order to do this, you need to use the following flag:
+# First hard-install all the packages
+rm -rf node_moduels
+pnpm install --prod --linker hoisted
+# Then bundle with node_modules
+mycli --s-build-dxt ./my-dxt-package --s-with-node-modules
+# then build the dxt bundle
+npx @anthropic-ai/dxt pack ./my-dxt-package
+# then upload the dxt bundle to Claude Desktop from the settings > extensions > advanced
 ```
 
 ### Logo Configuration
@@ -1138,37 +1172,129 @@ When you run `--s-build-dxt`, ArgParser performs several steps to create a self-
 2.  **Manifest Generation**: It creates a `manifest.json` file.
     - Tool flags are converted into a JSON Schema for the `input_schema`.
     - Flags with an `env` property (e.g., `{ name: 'apiKey', env: 'API_KEY' }`) are automatically added to the `user_config` section, prompting the user for the value upon installation and making it available as an environment variable to your tool.
-3.  **Autonomous Build**: It bundles your CLI's source code and its dependencies into a single entry point (e.g., `server.js`) that can run without `node_modules`. This ensures the DXT is portable and reliable.
+3.  **Autonomous Build**: It bundles your CLI's source code and its dependencies into a single entry point (e.g., `server.js`) that can run without `node_modules`. This ensures the DXT is portable and reliable. If you have properly setup your node_modules (via `pnpm install --prod --node-linker=hoisted`) and pass `--s-with-node-nodules` to the bundling process, the resulting DXT will include all necessary dependencies, this is useful for projects that require native dependencies or have complex dependency trees.
 4.  **Packaging**: It assembles all necessary files (manifest, server bundle, logo, etc.) into the specified output directory, ready to be used by Claude Desktop or packed with `npx @anthropic-ai/dxt`.
 
+### DXT Bundling Strategies
+
+ArgParser offers two approaches for handling dependencies in DXT packages, depending on your project's needs.
+
+#### Standard Approach (Recommended for Most Projects)
+
+```bash
+# For pure JavaScript/TypeScript projects
+your-cli --s-build-dxt
+```
+
+- **Best for**: Pure JS/TS projects without native dependencies
+- **Bundle size**: Small (5-10MB typical)
+- **Build time**: Fast
+- **Dependencies**: Bundled automatically by TSDown
+
+#### Native Dependencies Approach
+
+```bash
+# For projects with native binaries (ONNX, Sharp, SQLite, etc.)
+rm -rf node_modules
+pnpm install --prod --node-linker=hoisted
+your-cli --s-build-dxt --s-with-node-modules
+```
+
+- **Best for**: Projects using ONNX Runtime, Sharp, Canvas, SQLite, or other packages with `.node` binaries
+- **Bundle size**: Larger (50-200MB typical)
+- **Build time**: Longer (copies entire node_modules)
+- **Dependencies**: Complete autonomy - no installation needed by Claude
+
+**When to use `--s-with-node-modules`:**
+
+- ✅ Your project uses machine learning packages (ONNX Runtime, TensorFlow bindings)
+- ✅ You need image processing (Sharp, Canvas)
+- ✅ You use database packages with native binaries (better-sqlite3, sqlite3)
+- ✅ You want guaranteed compatibility without runtime installation
+- ✅ Bundle size is acceptable for your use case
+
+**Required preparation steps:**
+
+1. `rm -rf node_modules` - Clean slate for proper structure
+2. `pnpm install --prod --node-linker=hoisted` - Creates flat, symlink-free structure
+3. Add `--s-with-node-modules` flag to your build command
+
+The system automatically validates your setup and provides guidance if issues are detected.
+
+### Typical Errors
+
+**Failed to run in Claude Desktop**:
+
+Claude Desktop is pretty finicky (as of Claude 0.12.28), and the built-in Node.js does not work with extensions built with `--s-with-node-modules` and installed via ArgParser (and I have no idea why because there's no debug info).
+To resolve this, simply go to `Claude Desktop > Settings > Extensions > Advanced Settings` and turn **OFF** `Use Built-in Node.js for MCP`.
+
+Note that there are _many_ reasons for extensions not to work, if it does not work with Built-in or System Node.js, then something in your app is wrong. Feel free to join Alcyone Labs' discord for support: [Alcyone Labs' Discord](https://discord.gg/rRHhpz5nS5)
+
+**Failed to attach to MCP when downloading external assets**
+
+Sometimes, the MCP client needs to install external files, for example an ML model from HuggingFace or some task that takes more than 10 seconds to run. While it's working, Claude Desktop will display a `Cannot attach to MCP`, simply ignore it, Claude Desktop runs a ping every X seconds, and when it is running a long-running task, the ping will fail, but the task itself will still finish correctly.
+
+**Failed to generate DXT package**:
+
+If you encounter the following error running a command such as:
+
+```bash
+rm -rf node_modules
+pnpm install --prod --node-linker=hoisted
+bun src/index.ts --s-build-dxt ./dxt --s-with-node-modules
+
+-- Error generating DXT package: TSDown DXT build failed: EEXIST: file already exists, mkdir
+```
+
+Then run:
+
+```bash
+rm -rf ./dxt
+bun src/index.ts --s-build-dxt ./dxt --s-with-node-modules
+```
+
+And it should work. TSDown is tasked to clean the outputDir first, but it won't if some files have been manually changed.
+
 ---
 
 ## System Flags & Configuration
 
 ArgParser includes built-in `--s-*` flags for development, debugging, and configuration. They are processed before normal arguments and will cause the program to exit after their task is complete.
 
-| Flag                        | Description                                                                                         |
-| --------------------------- | --------------------------------------------------------------------------------------------------- |
-| **MCP & DXT**               |                                                                                                     |
-| `--s-mcp-serve`             | Starts the application in MCP server mode, exposing all tools.                                      |
-| `--s-build-dxt [dir]`       | Generates a complete, autonomous DXT package for Claude Desktop in the specified directory.         |
-| `--s-mcp-transport <type>`  | Overrides the MCP transport (`stdio`, `sse`, `streamable-http`).                                    |
-| `--s-mcp-transports <json>` | Overrides transports with a JSON array for multi-transport setups.                                  |
-| `--s-mcp-port <number>`     | Sets the port for HTTP-based transports (`sse`, `streamable-http`).                                 |
-| `--s-mcp-host <string>`     | Sets the host address for HTTP-based transports.                                                    |
-| `--s-mcp-log-path <path>`   | Sets the file path for MCP server logs (default: `./logs/mcp.log`). Overrides programmatic setting. |
-| **Configuration**           |                                                                                                     |
-| `--s-with-env <file>`       | Loads configuration from a file (`.env`, `.json`, `.yaml`, `.toml`). CLI args take precedence.      |
-| `--s-save-to-env <file>`    | Saves the current arguments to a configuration file, perfect for templates.                         |
-| **Debugging**               |                                                                                                     |
-| `--s-debug`                 | Prints a detailed, step-by-step log of the argument parsing process.                                |
-| `--s-debug-print`           | Exports the entire parser configuration to a JSON file for inspection.                              |
-| `--s-enable-fuzzy`          | Enables fuzzy testing mode—a dry run that parses args but skips handler execution.                  |
+| Flag                        | Description                                                                                                    |
+| --------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| **MCP & DXT**               |                                                                                                                |
+| `--s-mcp-serve`             | Starts the application in MCP server mode, exposing all tools.                                                 |
+| `--s-build-dxt [dir]`       | Generates a complete, autonomous DXT package for Claude Desktop in the specified directory.                    |
+| `--s-with-node-modules`     | Use with `--s-build-dxt`. Includes complete node_modules in DXT package for projects with native dependencies. |
+| `--s-mcp-transport <type>`  | Overrides the MCP transport (`stdio`, `sse`, `streamable-http`).                                               |
+| `--s-mcp-transports <json>` | Overrides transports with a JSON array for multi-transport setups.                                             |
+| `--s-mcp-port <number>`     | Sets the port for HTTP-based transports (`sse`, `streamable-http`).                                            |
+| `--s-mcp-host <string>`     | Sets the host address for HTTP-based transports.                                                               |
+| `--s-mcp-log-path <path>`   | Sets the file path for MCP server logs (default: `./logs/mcp.log`). Overrides programmatic setting.            |
+| **Configuration**           |                                                                                                                |
+| `--s-with-env <file>`       | Loads configuration from a file (`.env`, `.json`, `.yaml`, `.toml`). CLI args take precedence.                 |
+| `--s-save-to-env <file>`    | Saves the current arguments to a configuration file, perfect for templates.                                    |
+| **Debugging**               |                                                                                                                |
+| `--s-debug`                 | Prints a detailed, step-by-step log of the argument parsing process.                                           |
+| `--s-debug-print`           | Exports the entire parser configuration to a JSON file for inspection.                                         |
+| `--s-enable-fuzzy`          | Enables fuzzy testing mode—a dry run that parses args but skips handler execution.                             |
 
 ---
 
 ## Changelog
 
+### v2.3.0
+
+The DXT bundling is working pretty well now, and we have had a lot of success building, bundling and running various extensions. If you see issues, feel free to open an Issue on GitHub with details, or ask about it on [Alcyone Labs' Discord](https://discord.gg/rRHhpz5nS5)
+
+Make sure to clearly identify if you need to include the node_modules or not. In doubt, include them using `--s-with-node-modules`
+
+**Feat**
+
+- **New `--s-with-node-modules` flag**: Create fully autonomous DXT packages that include complete native dependencies. Perfect for projects using ONNX Runtime, Sharp, SQLite, or other packages with `.node` binaries. Use `rm -rf ./node_modules && pnpm install --prod --node-linker=hoisted` followed by `my-cli --s-build-dxt ./dxt --s-with-node-modules` to create self-contained packages that work without Claude needing to install dependencies.
+  Note that when bundling with node_modules, it's likely that the built-in Node.js will not work with that extension, so go to `Claude Desktop > Settings > Extensions > Advanced Settings` and turn **OFF** `Use Built-in Node.js for MCP`.
+
 ### v2.2.1
 
 **Feat**

package/dist/assets/.dxtignore.template

@@ -31,7 +31,6 @@ tests/
 temp-dxt-build/
 
 # TSDown config files (not needed in final package)
-tsdown.dxt.config.ts
 .dxtignore.template
 
 # Source files (replaced by bundled output)

package/dist/core/ArgParserBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ArgParserBase.d.ts","sourceRoot":"","sources":["../../src/core/ArgParserBase.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ArgParserBase.d.ts","sourceRoot":"","sources":["../../src/core/ArgParserBase.ts"],"names":[],"mappings":"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"}

package/dist/dxt/DxtGenerator-testUtils.d.ts

@@ -0,0 +1,22 @@
+import type { ParseResult } from "../core/types";
+/**
+ * Test utilities for DxtGenerator
+ * Contains methods that are only used during testing
+ */
+export declare class DxtGeneratorTestUtils {
+    private argParserInstance;
+    private extractMcpServerInfo;
+    private handleExit;
+    constructor(argParserInstance: any, extractMcpServerInfo: () => any, handleExit: (exitCode: number, message?: string, type?: ParseResult["type"], data?: any) => ParseResult | never);
+    /**
+     * Handles DXT generation in test mode by creating mock DXT package structure
+     * This method creates simplified mock files for testing purposes
+     */
+    handleTestModeDxtGeneration(processArgs: string[], buildDxtIndex: number): Promise<ParseResult>;
+    /**
+     * Checks if the current environment is in test mode
+     * Used to determine whether to use test utilities or production code
+     */
+    static isTestMode(): boolean;
+}
+//# sourceMappingURL=DxtGenerator-testUtils.d.ts.map

package/dist/dxt/DxtGenerator-testUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DxtGenerator-testUtils.d.ts","sourceRoot":"","sources":["../../src/dxt/DxtGenerator-testUtils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,oBAAoB,CAAY;IACxC,OAAO,CAAC,UAAU,CAKO;gBAGvB,iBAAiB,EAAE,GAAG,EACtB,oBAAoB,EAAE,MAAM,GAAG,EAC/B,UAAU,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,IAAI,CAAC,EAAE,GAAG,KACP,WAAW,GAAG,KAAK;IAO1B;;;OAGG;IACU,2BAA2B,CACtC,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,CAAC;IAwFvB;;;OAGG;WACW,UAAU,IAAI,OAAO;CAQpC"}

package/dist/dxt/DxtGenerator.d.ts

@@ -14,87 +14,24 @@ export declare class DxtGenerator {
      * Handles the --s-build-dxt system flag to generate DXT packages for MCP servers
      */
     handleBuildDxtFlag(processArgs: string[], buildDxtIndex: number): Promise<boolean | ParseResult>;
-    /**
-     * Handles DXT generation in test mode by creating mock DXT package structure
-     */
-    private handleTestModeDxtGeneration;
-    /**
-     * Generates a DXT package for the unified MCP server
-     * Now supports both withMcp() configuration and legacy addMcpSubCommand()
-     */
-    generateDxtPackage(mcpSubCommand?: any, outputDir?: string): Promise<void>;
-    /**
-     * Reads package.json to extract fallback information for DXT manifest
-     */
-    private readPackageJsonInfo;
     /**
      * Extracts server information from MCP configuration
      * Now supports both withMcp() configuration and legacy addMcpSubCommand()
      */
     private extractMcpServerInfo;
     private generateMcpToolsForDxt;
-    private createDxtManifest;
-    private validateDxtManifest;
-    private createServerScript;
-    private createDxtPackageJson;
-    /**
-     * Creates a .dxtignore file to exclude build artifacts and unnecessary files
-     */
-    private createDxtIgnore;
-    /**
-     * Creates a simple build script that uses TSDown bundling and Anthropic's dxt pack
-     */
-    private createSimpleBuildScript;
-    private createDxtReadme;
     /**
      * Maps ArgParser flag types to DXT user config types
      */
-    private mapFlagTypeToUserConfigType;
-    /**
-     * Generates CLI arguments for DXT manifest based on ArgParser flags
-     */
-    private generateCliArgsForDxt;
-    /**
-     * Generates environment variables and user config for DXT manifest
-     */
-    private generateEnvAndUserConfig;
-    /**
-     * Generates a user-friendly title for user config fields
-     */
-    private generateUserConfigTitle;
-    /**
-     * Checks if a field should be marked as sensitive in user config
-     */
-    private isSensitiveField;
     /**
      * Adds the logo to the build folder if available
      * @returns The filename of the logo that was added, or undefined if no logo was added
      */
     private addLogoToFolder;
-    /**
-     * Processes CLI source code to replace global console with MCP-compliant Logger
-     */
-    private processCliSourceForMcp;
-    /**
-     * Adds the original CLI source to the build folder for handler execution
-     */
-    private addOriginalCliToFolder;
     /**
      * Builds a complete DXT package using TSDown CLI for autonomous execution
      */
     private buildDxtWithTsdown;
-    /**
-     * Bundles the original CLI using TSDown for autonomous execution (legacy method)
-     */
-    private bundleOriginalCliWithTsdown;
-    /**
-     * Checks if a module ID is a Node.js built-in
-     */
-    private isNodeBuiltin;
-    /**
-     * Gets the TSDown configuration content as a string
-     */
-    private getTsdownConfigContent;
     /**
      * Gets the path to the .dxtignore template file in assets
      */
@@ -103,13 +40,18 @@ export declare class DxtGenerator {
      * Sets up DXT package files (manifest.json) in the output directory
      */
     private setupDxtPackageFiles;
-    /**
-     * Manually copy logo since TSDown's copy option doesn't work programmatically
-     */
-    private copyLogoManually;
     /**
      * Detects the actual output filename generated by TSDown
      */
     private detectTsdownOutputFile;
+    private findProjectRoot;
+    /**
+     * Generate environment variables and user configuration from ArgParser flags
+     * @returns Object containing envVars and userConfig
+     */
+    generateEnvAndUserConfig(): {
+        envVars: Record<string, string>;
+        userConfig: Record<string, any>;
+    };
 }
 //# sourceMappingURL=DxtGenerator.d.ts.map

package/dist/dxt/DxtGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DxtGenerator.d.ts","sourceRoot":"","sources":["../../src/dxt/DxtGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,iBAAiB,CAAM;gBAEnB,iBAAiB,EAAE,GAAG;IAIlC;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACU,kBAAkB,CAC7B,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC;IA8DjC;;OAEG;YACW,2BAA2B;IAgGzC;;;OAGG;IACU,kBAAkB,CAC7B,aAAa,CAAC,EAAE,GAAG,EACnB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IA4GhB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,sBAAsB;IA4F9B,OAAO,CAAC,iBAAiB;IAyFzB,OAAO,CAAC,mBAAmB;IAoD3B,OAAO,CAAC,kBAAkB;IAwC1B,OAAO,CAAC,oBAAoB;IA2E5B;;OAEG;IACH,OAAO,CAAC,eAAe;IA4CvB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmF/B,OAAO,CAAC,eAAe;IAqFvB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA+BnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAmEhC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAO/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;OAGG;YACW,eAAe;IA8H7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqE9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmL9B;;OAEG;YACW,kBAAkB;IAkLhC;;OAEG;YACW,2BAA2B;IAsMzC;;OAEG;IACH,OAAO,CAAC,aAAa;IA4CrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6E9B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyChC;;OAEG;YACW,oBAAoB;IAyMlC;;OAEG;YACW,gBAAgB;IA6D9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA2F/B"}
+{"version":3,"file":"DxtGenerator.d.ts","sourceRoot":"","sources":["../../src/dxt/DxtGenerator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,iBAAiB,CAAM;gBAEnB,iBAAiB,EAAE,GAAG;IAIlC;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACU,kBAAkB,CAC7B,WAAW,EAAE,MAAM,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,GAAG,WAAW,CAAC;IAgJjC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,sBAAsB;IA4F9B;;OAEG;IACH;;;OAGG;YACW,eAAe;IA0J7B;;OAEG;YACW,kBAAkB;IA4MhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyChC;;OAEG;YACW,oBAAoB;IAyJlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4F9B,OAAO,CAAC,eAAe;IAyBvB;;;OAGG;IACI,wBAAwB,IAAI;QACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC;CAsDF"}