@tng-sh/js 0.1.4 → 0.1.7

package/README.md

@@ -4,69 +4,87 @@ High-performance test generation and context analysis for JavaScript/TypeScript,
 
 ## Installation
 
+Install the package as a development dependency in your project:
+
 ```bash
 npm install @tng-sh/js --save-dev
 ```
 
-## Quick Start
+## Usage
 
 ### 1. Initialize
-Run the init command to create a `tng.config.js` configuration file in your project:
+First, run the init command to create a `tng.config.js` configuration file. This file stores your API keys and project settings.
 
 ```bash
-npx -p @tng-sh/js tng init
+npx tng init
 ```
 
-### 2. Generate Tests
-Generate a test for a specific function in a file:
+### 2. Interactive Mode (TUI)
+The most powerful way to use TNG is via the high-performance terminal interface. It provides a guided experience for all analysis tasks.
 
 ```bash
-npx -p @tng-sh/js tng -f path/to/file.js -m functionName -t react_component
+npx tng i
+```
+
+**Capabilities in TUI:**
+*   **Generate Tests**: Guided test creation for methods, components, and utilities.
+*   **Audit Method**: Deep security, performance, and best-practice auditing.
+*   **Trace Method**: Symbolic execution and logic flow visualization.
+*   **X-Ray Method**: Deep dependency and side-effect analysis.
+*   **Check Duplicates**: High-performance clone detection across the codebase.
+*   **Dead Code**: Identify unreachable logic and unused variables/parameters.
+*   **User Stats**: Review your usage metrics and generation history.
+
+### 3. Command Line Interface (CLI) ⚙️
+For direct execution or integration into scripts.
+
+```bash
+# See file outline and method list
+npx tng -f path/to/file.js --outline
+
+# Generate tests for a specific method
+npx tng -f path/to/file.js -m functionName -t react_component
+
+# Check for code clones
+npx tng -f path/to/file.js --clones
 ```
 
 **Supported Types (`-t`):**
-- `react_component`
-- `express_handler`
-- `graphql_resolver`
-- `nest_js` (Service/Controller)
-- `orm_model`
-- `background_job`
-- `mailer`
-- `utility`
-
-### 3. Interactive Mode
-Launch the interactive UI to explore and generate tests visually:
+`react_component`, `express_handler`, `graphql_resolver`, `nest_js`, `orm_model`, `background_job`, `mailer`, `utility`.
+
+### 4. Machine-Readable Output (`--json`) 🤖
+Add the `--json` flag to any command to receive output as structured JSON events. This is ideal for CI/CD pipelines or custom integrations.
 
 ```bash
-npx -p @tng-sh/js tng i
+npx tng -f path/to/file.js --clones --json
+```
+
+### 4. Dead Code Analysis
+Identify unreachable code, unused variables, and unused imports in your project:
+
+```bash
+npx -p @tng-sh/js tng --deadcode -f path/to/file.js
 ```
 
 ## Features
 
-- ⚡️ **Fast AST Analysis**: Powered by Rust and the `oxc` parser for blazing fast static analysis.
-- 🖥️ **Interactive UI**: Rich Go-based terminal UI for managing test generation.
-- 🎨 **Prettier Integration**: Automatically formats generated tests to match your project style.
-- 📘 **TypeScript Support**: First-class support for TypeScript analysis.
+- **Blazing Fast Static Analysis**: Powered by Rust and the `oxc` parser for near-instant AST processing.
+- **Interactive Terminal UI**: Dual-pane keyboard-driven interface for deep code exploration.
+- **Smart Visualization**: Generate logic flow diagrams using Mermaid.js integration.
+- **Dead Code Cleanup**: Find and remove unused imports, variables, and unreachable logic.
+- **First-Class TS & React**: Native support for TypeScript, JSX, and TSX.
 
-## Configuration
+## ⚙️ Configuration
 
-The `tng.config.js` file allows you to customize the behavior:
+Your `tng.config.js` allows for full customization:
 
 ```javascript
 module.exports = {
-  // API Configuration
   API_KEY: "your-api-key-here",
   API_URL: "https://app.tng.sh/",
-
-  // Framework Detection
-  // Options: express, nextjs, nestjs, generic
-  FRAMEWORK: "express",
-
-  // Testing Configuration
-  // Options: jest, mocha, vitest
-  TEST_FRAMEWORK: "jest",
-
-  // Test Directory
-  TEST_DIRECTORY: "tests"
+  FRAMEWORK: "express",        // Options: express, nextjs, nestjs, generic
+  TESTS_PATH: "tests",         // Where to save generated tests
+  TEST_FRAMEWORK: "jest"       // Options: jest, mocha, vitest
 };
 ```
+

package/bin/tng.js

@@ -27,8 +27,8 @@ process.on('uncaughtException', (err) => {
 
 program
     .name('tng')
-    .description('TNG - Automated Test Generation, and audit generation for JavaScript')
-    .version('0.1.4');
+    .description('TNG - Advanced Code Audit, Test Generation, Visualization, and Dead Code Analysis for JavaScript/TypeScript')
+    .version('0.1.7');
 
 /**
  * @command init
@@ -138,7 +138,7 @@ function launchInteractive() {
 program
     .command('i')
     .alias('interactive')
-    .description('Launch interactive UI')
+    .description('Launch interactive UI for code audit, test generation, and visualization')
     .action(() => {
         launchInteractive();
     });
@@ -213,6 +213,7 @@ program
     .option('--trace', 'Run symbolic trace visualization')
     .option('-c, --clones', 'Run duplicate code detection')
     .option('-l, --level <level>', 'Set clone detection level (1, 2, or all)', 'all')
+    .option('-d, --deadcode', 'Run dead code detection (JS/TS/React)')
     .option('--json', 'Output results as JSON events (machine-readable)')
 
     .action(async (options) => {
@@ -264,7 +265,9 @@ program
             generateTest(options.file, options.method, options.type, options.audit, options.json);
         } else if (options.file && !options.method) {
             if (options.clones) {
-                runClones(options.file, options.level || 'all', options.json);
+                await runClones(options.file, options.level || 'all', options.json);
+            } else if (options.deadcode) {
+                await runDeadCode(options.file, options.json);
             } else {
                 console.log(chalk.yellow('Specify a method with -m, use --outline to see methods, or run "tng i" for full selection.'));
             }
@@ -321,7 +324,58 @@ async function runClones(filePath, level, jsonMode = false) {
         });
 
         if (matches) {
-            session.showClones(absolutePath, matches);
+            await session.showClones(absolutePath, matches);
+        }
+    } catch (e) {
+        console.log(chalk.red(`Error: ${e.message}`));
+        process.exit(1);
+    }
+}
+
+/**
+ * Logic to run dead code detection
+ */
+async function runDeadCode(filePath, jsonMode = false) {
+    const { detectDeadCode } = require('../index');
+    const absolutePath = path.resolve(filePath);
+
+    if (!fs.existsSync(absolutePath)) {
+        console.log(chalk.red(`File not found: ${filePath}`));
+        process.exit(1);
+    }
+
+    const GoUISession = require('../lib/goUiSession');
+    const session = new GoUISession();
+
+    if (jsonMode) {
+        const { JsonSession } = require('../lib/jsonSession');
+        const jsonSession = new JsonSession();
+        jsonSession.start();
+        try {
+            const resultJson = detectDeadCode(absolutePath);
+            jsonSession.emitEvent('dead_code', JSON.parse(resultJson));
+            jsonSession.stop();
+        } catch (e) {
+            jsonSession.displayError(e.message);
+            jsonSession.stop();
+            process.exit(1);
+        }
+        return;
+    }
+
+    console.log(chalk.blue(`🔍 Analyzing dead code in ${filePath}...`));
+
+    try {
+        const issuesJson = await session.showProgress('Analyzing dead code...', async (progress) => {
+            progress.update('Parsing AST...', { percent: 30 });
+            const resultJson = detectDeadCode(absolutePath);
+            progress.update('Identifying issues...', { percent: 70 });
+            progress.update('Done!', { percent: 100 });
+            return resultJson;
+        });
+
+        if (issuesJson) {
+            await session.showDeadCodeResults(absolutePath, issuesJson);
         }
     } catch (e) {
         console.log(chalk.red(`Error: ${e.message}`));

package/index.d.ts

@@ -61,3 +61,5 @@ export declare function getSymbolicTrace(filePath: string, methodName: string, c
  * Returns a JSON string containing the matches found.
  */
 export declare function analyzeClones(projectRoot: string, filePath: string, level: string): string
+/** Analyzes a file for dead code. */
+export declare function detectDeadCode(filePath: string): string

package/index.js

@@ -310,7 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { getFileOutline, getProjectMetadata, findCallSites, ping, submitJob, getUserStats, runAudit, applyEdit, applyEditsAtomic, generateTest, getSymbolicTrace, analyzeClones } = nativeBinding
+const { getFileOutline, getProjectMetadata, findCallSites, ping, submitJob, getUserStats, runAudit, applyEdit, applyEditsAtomic, generateTest, getSymbolicTrace, analyzeClones, detectDeadCode } = nativeBinding
 
 module.exports.getFileOutline = getFileOutline
 module.exports.getProjectMetadata = getProjectMetadata
@@ -324,3 +324,4 @@ module.exports.applyEditsAtomic = applyEditsAtomic
 module.exports.generateTest = generateTest
 module.exports.getSymbolicTrace = getSymbolicTrace
 module.exports.analyzeClones = analyzeClones
+module.exports.detectDeadCode = detectDeadCode

package/lib/generateTestsUi.js

@@ -43,6 +43,9 @@ class GenerateTestsUI {
             } else if (choice === 'clones') {
                 const result = await this._showClonesSelection();
                 if (result === 'exit') return 'exit';
+            } else if (choice === 'deadcode') {
+                const result = await this._showDeadCodeSelection();
+                if (result === 'exit') return 'exit';
             } else if (choice === 'stats') {
                 await this._showStats();
             } else if (choice === 'about') {
@@ -761,7 +764,55 @@ class GenerateTestsUI {
             });
 
             if (matches) {
-                this.goUiSession.showClones(absolutePath, matches);
+                await this.goUiSession.showClones(absolutePath, matches);
+            }
+        } catch (e) {
+            console.log(chalk.red(`Error: ${e.message}`));
+        }
+    }
+
+    async _showDeadCodeSelection() {
+        const files = await this._getUserFiles();
+
+        if (files.length === 0) {
+            console.log(chalk.yellow('\nNo JavaScript or TypeScript files found in your project.\n'));
+            return 'back';
+        }
+
+        const cwd = process.cwd();
+        const items = files.map(file => ({
+            name: path.relative(cwd, file),
+            path: path.dirname(file)
+        }));
+
+        const selectedName = this.goUiSession.showListView('Select File for Dead Code Detection', items);
+
+        if (selectedName === 'back') return 'back';
+        if (!selectedName || selectedName === 'exit') return 'exit';
+
+        const selectedFile = path.resolve(cwd, selectedName);
+        await this._runDeadCode(selectedFile);
+        return 'main_menu';
+    }
+
+    async _runDeadCode(filePath) {
+        const { detectDeadCode } = require('../index');
+        const absolutePath = path.resolve(filePath);
+        const projectRoot = process.cwd();
+
+        console.log(chalk.blue(`🔍 Analyzing dead code in ${path.relative(projectRoot, filePath)}...`));
+
+        try {
+            const issuesJson = await this.goUiSession.showProgress('Analyzing dead code...', async (progress) => {
+                progress.update('Parsing AST...', { percent: 30 });
+                const resultJson = detectDeadCode(absolutePath);
+                progress.update('Identifying issues...', { percent: 70 });
+                progress.update('Done!', { percent: 100 });
+                return resultJson;
+            });
+
+            if (issuesJson) {
+                await this.goUiSession.showDeadCodeResults(absolutePath, issuesJson);
             }
         } catch (e) {
             console.log(chalk.red(`Error: ${e.message}`));

package/lib/goUiSession.js

@@ -369,6 +369,35 @@ class GoUISession {
         }
     }
 
+    async showDeadCodeResults(filePath, resultsJson) {
+        const issues = JSON.parse(resultsJson);
+        const data = {
+            file: filePath,
+            dead_code: issues.map(issue => ({
+                type: issue.issue_type,
+                line: issue.line,
+                message: issue.message,
+                code: issue.code_snippet
+            }))
+        };
+        const inputFile = this._trackTempFile(this._createTempFile('dead-code-data', '.json'));
+
+        try {
+            fs.writeFileSync(inputFile, JSON.stringify(data));
+
+            spawnSync(this._binaryPath, ['deadcode', '--file', inputFile], {
+                stdio: 'inherit',
+                env: process.env
+            });
+        } catch (error) {
+            console.error('Dead code results display error:', error.message);
+        } finally {
+            this._cleanupTempFile(inputFile);
+        }
+    }
+
+
+
     async showStreamingAuditResults(methodName, className, sourceCode) {
         const outputFile = this._trackTempFile(this._createTempFile('audit-choice', '.txt'));
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@tng-sh/js",
-    "version": "0.1.4",
+    "version": "0.1.7",
     "description": "TNG JavaScript CLI",
     "repository": {
         "type": "git",

package/.tmp/tng-clone-data-1770062573900-923.json

@@ -1 +0,0 @@
-{"file_path":"/Users/claudiu/work/tng-inc/js-pie/test_duplicates.js","matches":[{"start1":1,"end1":13,"start2":16,"end2":28,"line_count":13,"node_count":12,"complexity_score":245,"algo":"structural"}]}

package/.tmp/tng-progress-control-1770062573779-154.json

@@ -1 +0,0 @@
-{"type":"step","step":1,"message":"Done!","percent":100}

package/.tmp/tng_sh_js-49dc3b9a.napi_type_def.tmp

@@ -1,13 +0,0 @@
-tng_sh_js:{"kind": "interface", "name": "CloneMatch", "js_doc": "", "def": "start1: number\nend1: number\nstart2: number\nend2: number\nlineCount: number\nnodeCount: number\ncomplexityScore: number\nalgo: string", "original_name": "CloneMatch"}
-tng_sh_js:{"kind": "fn", "name": "getFileOutline", "js_doc": "/**\n * Analyzes a JavaScript/TypeScript file and returns its structural outline as a JSON string.\n * Contains information about classes and methods found in the file.\n */\n", "def": "export declare function getFileOutline(filePath: string): string"}
-tng_sh_js:{"kind": "fn", "name": "getProjectMetadata", "js_doc": "/**\n * Gathers project-wide metadata from package.json and related files.\n * Returns a JSON string containing dependencies, frameworks, and project type.\n */\n", "def": "export declare function getProjectMetadata(projectRoot: string): string"}
-tng_sh_js:{"kind": "fn", "name": "findCallSites", "js_doc": "/**\n * Searches the project for all locations where a specific method is called.\n * Uses ripgrep under the hood for high performance.\n */\n", "def": "export declare function findCallSites(projectRoot: string, methodName: string): string"}
-tng_sh_js:{"kind": "fn", "name": "ping", "js_doc": "/** Pings the TNG API to verify connectivity and API key validity. */\n", "def": "export declare function ping(baseUrl: string, apiKey?: string | undefined | null): string"}
-tng_sh_js:{"kind": "fn", "name": "submitJob", "js_doc": "/** Submits a test generation job to the API and returns the numeric job ID. */\n", "def": "export declare function submitJob(baseUrl: string, apiKey: string, payloadJson: string): number"}
-tng_sh_js:{"kind": "fn", "name": "getUserStats", "js_doc": "/** Fetches usage statistics for the authenticated user from the API. */\n", "def": "export declare function getUserStats(baseUrl: string, apiKey: string): string"}
-tng_sh_js:{"kind": "fn", "name": "runAudit", "js_doc": "/**\n * Orchestrates the code audit process.\n * Analyzes the source, builds context, and streams results via the provided callback.\n */\n", "def": "export declare function runAudit(filePath: string, methodName: string, className: string | undefined | null, testType: string | undefined | null, configJson: string, callback: (...args: any[]) => any): string"}
-tng_sh_js:{"kind": "fn", "name": "applyEdit", "js_doc": "/**\n * Applies a single edit operation to a file.\n * Uses backup and atomic write for safety.\n */\n", "def": "export declare function applyEdit(filePath: string, search: string, replace: string, lineHint?: number | undefined | null): string"}
-tng_sh_js:{"kind": "fn", "name": "applyEditsAtomic", "js_doc": "/**\n * Applies multiple edit operations atomically.\n * All succeed or all fail (with rollback).\n */\n", "def": "export declare function applyEditsAtomic(operationsJson: string): string"}
-tng_sh_js:{"kind": "fn", "name": "generateTest", "js_doc": "/**\n * Orchestrates the test generation process.\n * Analyzes code, submits a job, and polls for the final generated test.\n */\n", "def": "export declare function generateTest(filePath: string, methodName: string, className: string | undefined | null, testType: string | undefined | null, configJson: string, callback: (...args: any[]) => any): string"}
-tng_sh_js:{"kind": "fn", "name": "getSymbolicTrace", "js_doc": "/** Analyzes a method and generates a symbolic execution trace. */\n", "def": "export declare function getSymbolicTrace(filePath: string, methodName: string, className?: string | undefined | null): string"}
-tng_sh_js:{"kind": "fn", "name": "analyzeClones", "js_doc": "/**\n * Analyzes a file for code clones (duplicates).\n * Returns a JSON string containing the matches found.\n */\n", "def": "export declare function analyzeClones(projectRoot: string, filePath: string, level: string): string"}

package/.tmp/tng_sh_js-49dc3b9a.napi_wasi_register.tmp

@@ -1,13 +0,0 @@
-tng_sh_js: __napi_register__CloneMatch_struct_0
-tng_sh_js: __napi_register__get_file_outline_1
-tng_sh_js: __napi_register__get_project_metadata_2
-tng_sh_js: __napi_register__find_call_sites_3
-tng_sh_js: __napi_register__ping_4
-tng_sh_js: __napi_register__submit_job_5
-tng_sh_js: __napi_register__get_user_stats_6
-tng_sh_js: __napi_register__run_audit_7
-tng_sh_js: __napi_register__apply_edit_8
-tng_sh_js: __napi_register__apply_edits_atomic_9
-tng_sh_js: __napi_register__generate_test_10
-tng_sh_js: __napi_register__get_symbolic_trace_11
-tng_sh_js: __napi_register__analyze_clones_12