{"_id":"3d-repo-visualizer","name":"3d-repo-visualizer","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"3d-repo-visualizer","version":"1.0.0","description":"3D visualization tool for software repositories","main":"dist/index.js","bin":{"3d-repo":"dist/cli.js"},"repository":{"type":"git","url":"git+https://github.com/kangthink/3d-repo.git"},"homepage":"https://github.com/kangthink/3d-repo#readme","bugs":{"url":"https://github.com/kangthink/3d-repo/issues"},"scripts":{"build":"tsc && cp -r src/public dist/ && cp src/python-parser.py dist/","dev":"ts-node src/cli.ts","start":"node dist/cli.js","watch":"tsc -w","serve":"http-server dist/public -p 8080 -o","postbuild":"cp -r src/public dist/","prepublishOnly":"npm run build","test":"echo \"No tests specified\" && exit 0"},"keywords":["3d","visualization","repository","code-analysis"],"author":{"name":"Your Name"},"license":"MIT","dependencies":{"@babel/parser":"^7.23.0","@babel/traverse":"^7.23.0","@babel/types":"^7.23.0","commander":"^11.0.0","express":"^4.18.2","glob":"^10.3.0","typescript":"^5.2.0"},"devDependencies":{"@types/babel__traverse":"^7.20.1","@types/express":"^4.17.17","@types/node":"^20.5.0","http-server":"^14.1.1","ts-node":"^10.9.1"},"_id":"3d-repo-visualizer@1.0.0","gitHead":"3e5bbf993e12fa7eb0561b6413ccc8912f952ff1","_nodeVersion":"20.10.0","_npmVersion":"10.2.3","dist":{"integrity":"sha512-J6sEUOlk7am6mRKTKQJJeFpRZ/5sSPhVrTEZ6uzwv4DXUchl4SVFNxNCaAx8B1NWVJ4Fshk8BDuU03ZdKjB5gQ==","shasum":"e4b80cb3867d67838c8c567c210da514de0b2427","tarball":"https://registry.npmjs.org/3d-repo-visualizer/-/3d-repo-visualizer-1.0.0.tgz","fileCount":26,"unpackedSize":131517,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEuqfNl6Mo/r4fUhjtKrm6QJkQ3SMifGoQeuhDsIwsPIAiEAg/4912ctiNCtXmMLw0+kmIzAaPiSsiMONKAplDFrvak="}]},"_npmUser":{"name":"kangthink","email":"kangthink@gmail.com"},"directories":{},"maintainers":[{"name":"kangthink","email":"kangthink@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/3d-repo-visualizer_1.0.0_1748321855112_0.1530110575567738"},"_hasShrinkwrap":false}},"time":{"created":"2025-05-27T04:57:35.111Z","1.0.0":"2025-05-27T04:57:35.281Z","modified":"2025-05-27T04:57:35.554Z"},"maintainers":[{"name":"kangthink","email":"kangthink@gmail.com"}],"description":"3D visualization tool for software repositories","homepage":"https://github.com/kangthink/3d-repo#readme","keywords":["3d","visualization","repository","code-analysis"],"repository":{"type":"git","url":"git+https://github.com/kangthink/3d-repo.git"},"author":{"name":"Your Name"},"bugs":{"url":"https://github.com/kangthink/3d-repo/issues"},"license":"MIT","readme":"# 3D Repository Visualizer\n\n🚀 **3D visualization tool for software repositories**\n\nTransform your codebase into an interactive 3D visualization to understand code structure, dependencies, and information flow.\n\n## Features\n\n- 📊 **Multi-language support**: JavaScript, TypeScript, Python\n- 🎯 **Interactive 3D visualization**: Navigate through your code in 3D space\n- 🔍 **Dependency tracking**: Visualize function calls, imports, and variable usage\n- 🎨 **Multiple visualization modes**: Static hierarchical view and dynamic network view\n- 🌐 **Web interface**: Modern, responsive UI with real-time interaction\n- ⚡ **Fast analysis**: Efficient AST parsing and graph generation\n\n## Installation\n\n### Global Installation (Recommended)\n\n```bash\nnpm install -g 3d-repo-visualizer\n```\n\n### Local Installation\n\n```bash\nnpm install 3d-repo-visualizer\nnpx 3d-repo --help\n```\n\n## Quick Start\n\n1. **Analyze your repository**:\n   ```bash\n   3d-repo --root-dir /path/to/your/project\n   ```\n\n2. **Open your browser** and navigate to `http://localhost:8080`\n\n3. **Explore your code** in 3D!\n\n## Usage\n\n### Basic Usage\n\n```bash\n# Analyze current directory\n3d-repo\n\n# Analyze specific directory\n3d-repo --root-dir ./my-project\n\n# Use custom port\n3d-repo --port 3000\n\n# Include specific file patterns\n3d-repo --include \"**/*.{js,py,java}\"\n\n# Exclude patterns\n3d-repo --exclude \"node_modules/**\" \"*.test.*\"\n```\n\n### Command Line Options\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `-r, --root-dir <path>` | Root directory to analyze | Current directory |\n| `-p, --port <number>` | Port for web server | 8080 |\n| `-i, --include <patterns...>` | Include file patterns | `**/*.{js,ts,jsx,tsx,py}` |\n| `-e, --exclude <patterns...>` | Exclude file patterns | `node_modules/**`, `dist/**`, etc. |\n| `--max-depth <number>` | Maximum analysis depth | 10 |\n| `--no-server` | Skip starting web server | false |\n\n### Visualization Modes\n\n- **Static Mode**: Hierarchical tree structure with file containers\n- **Dynamic Mode**: Network layout with flowing particles showing information flow\n\n### Controls\n\n#### Mouse Controls\n- **Left click + drag**: Rotate view\n- **Right click + drag**: Pan view  \n- **Scroll wheel**: Zoom in/out\n- **Click node**: Select and show details\n\n#### Keyboard Controls\n- **WASD**: Move camera (FPS-style)\n- **Q/E**: Move up/down\n- **R**: Reset view\n- **F**: Fit to screen\n- **Shift**: Fast movement\n\n## Supported Languages\n\n- **JavaScript** (.js)\n- **TypeScript** (.ts, .tsx)\n- **JSX** (.jsx)\n- **Python** (.py)\n\n## Requirements\n\n- **Node.js** 16+ \n- **Python 3** (for Python file analysis)\n- **Modern web browser** with WebGL support\n\n## Development\n\n```bash\n# Clone repository\ngit clone https://github.com/yourusername/3d-repo-visualizer.git\ncd 3d-repo-visualizer\n\n# Install dependencies\nnpm install\n\n# Build project\nnpm run build\n\n# Run in development mode\nnpm run dev\n\n# Start server\nnpm start\n```\n\n## Examples\n\n### Analyze a React project\n```bash\n3d-repo --root-dir ./my-react-app --include \"**/*.{js,jsx,ts,tsx}\"\n```\n\n### Analyze a Python project\n```bash\n3d-repo --root-dir ./my-python-app --include \"**/*.py\" --exclude \"**/__pycache__/**\"\n```\n\n### Quick analysis without server\n```bash\n3d-repo --root-dir ./project --no-server\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Issues\n\nFound a bug or have a feature request? Please open an issue on [GitHub](https://github.com/yourusername/3d-repo-visualizer/issues). ","readmeFilename":"README.md","_rev":"1-1fceb3038c7c6f8029b1a01143e94126"}