mvn-tree-visualizer 1.3.0__tar.gz → 1.4.0__tar.gz

{mvn_tree_visualizer-1.3.0 → mvn_tree_visualizer-1.4.0}/.github/SECURITY.md

@@ -6,8 +6,9 @@ We actively support the following versions of mvn-tree-visualizer:
 
 | Version | Supported          |
 | ------- | ------------------ |
+| 1.3.x   | :white_check_mark: |
 | 1.2.x   | :white_check_mark: |
-| 1.1.x   | :white_check_mark: |
+| 1.1.x   | :x:                |
 | 1.0.x   | :x:                |
 
 ## Reporting a Vulnerability

{mvn_tree_visualizer-1.3.0 → mvn_tree_visualizer-1.4.0}/.github/dependabot.yml

@@ -12,6 +12,19 @@ updates:
     labels:
       - "dependencies"
       - "python"
+
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    commit-message:
+      prefix: "deps"
+      prefix-development: "deps-dev"
+    labels:
+      - "dependencies"
+      - "uv"
+      - "python"
   
   # Enable version updates for GitHub Actions
   - package-ecosystem: "github-actions"

mvn_tree_visualizer-1.4.0/.github/instructions/copilot-instructions.md

@@ -0,0 +1,92 @@
+# GitHub Copilot Instructions for mvn-tree-visualizer
+
+## Project Overview
+This is a Python CLI tool that parses Maven dependency trees (`mvn dependency:tree` output) and generates interactive HTML diagrams (using Mermaid.js) or JSON outputs. The tool supports watch mode for real-time regeneration and has a modular architecture focused on error handling and user experience.
+
+## Architecture & Key Components
+
+### Core Flow
+1. **Input Validation** (`validation.py`) - Find and validate Maven dependency files
+2. **File Merging** (`get_dependencies_in_one_file.py`) - Combine multiple dependency files
+3. **Parsing** (`diagram.py`) - Read merged dependency tree
+4. **Output Generation** (`outputs/`) - Generate HTML (Mermaid.js) or JSON
+5. **Watch Mode** (`file_watcher.py`) - Monitor files for changes using watchdog
+
+### Module Structure
+```
+src/mvn_tree_visualizer/
+├── cli.py              # Entry point with comprehensive error handling
+├── exceptions.py       # Custom exception hierarchy
+├── validation.py       # File discovery and validation logic
+├── diagram.py          # Core dependency tree processing
+├── file_watcher.py     # Real-time file monitoring
+├── get_dependencies... # Multi-file merging logic
+├── TEMPLATE.py         # Jinja2 HTML template for Mermaid.js
+└── outputs/
+    ├── html_output.py  # Mermaid diagram generation
+    └── json_output.py  # Structured JSON output
+```
+
+## Development Conventions
+
+### Error Handling Pattern
+- Use custom exceptions from `exceptions.py`: `DependencyFileNotFoundError`, `DependencyParsingError`, `OutputGenerationError`
+- Provide actionable error messages with Maven commands and file paths
+- Follow the pattern in `cli.py:generate_diagram()` for comprehensive error handling
+
+### Testing Approach
+- Use pytest with descriptive test names like `test_convert_to_mermaid_deeper_tree()`
+- Test both positive cases and error conditions
+- Include realistic Maven dependency tree samples in test data
+- Run tests with: `uv run pytest tests/ -v`
+
+### Package Management
+- Uses `uv` as package manager - always use `uv run` for commands
+- Core dependencies: `jinja2` (templating), `watchdog` (file monitoring)
+- Entry point: `mvn-tree-visualizer` command maps to `cli:cli`
+
+### Code Quality
+- Lint with: `uv run ruff check .`
+- Type hints required throughout (project uses Python 3.13+)
+- Follow existing patterns for file validation and path handling
+
+## Critical Implementation Details
+
+### Maven Dependency Parsing
+- Input format: `[INFO] groupId:artifactId:type:version:scope` with tree structure using `+`, `|`, `\`
+- Handle both 4-part and 5-part dependency strings (see `html_output.py:_convert_to_mermaid`)
+- Depth calculation based on whitespace: `depth = len(parts[0].split(" ")) - 1`
+
+### File Discovery Pattern
+- Multi-file support: searches directory tree for `maven_dependency_file` (configurable)
+- Merges files from different Maven modules into single intermediate file
+- Validates file existence, permissions, and content before processing
+
+### Output Generation
+- HTML uses Mermaid.js with `graph LR` format
+- Version display controlled by `--show-versions` flag
+- JSON output maintains tree structure with parent-child relationships
+
+### Watch Mode Implementation
+- Uses watchdog library for cross-platform file monitoring
+- Monitors specific filename pattern across directory tree
+- Debounces changes and provides timestamped feedback
+
+## Common Development Tasks
+
+### Adding New Output Formats
+1. Create new module in `outputs/` directory
+2. Follow pattern from `html_output.py` and `json_output.py`
+3. Add format option to CLI and update `generate_diagram()` in `cli.py`
+
+### Error Message Improvements
+- All user-facing errors should include specific file paths and suggested Maven commands
+- Use `print_maven_help()` pattern for guiding users to generate dependency files
+- Test error scenarios in addition to happy path
+
+### Testing New Features
+- Include realistic Maven dependency trees in test data
+- Test both single-module and multi-module project scenarios
+- Verify error handling with invalid/missing files
+
+Remember: This tool processes Maven output files, not Maven projects directly. Users must run `mvn dependency:tree -DoutputFile=maven_dependency_file` first.

mvn_tree_visualizer-1.4.0/.github/workflows/release.yml

@@ -0,0 +1,58 @@
+name: Semantic Release
+
+on:
+  push:
+    branches: [ master ]
+  workflow_dispatch:
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+      issues: write
+      pull-requests: write
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.13'
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+
+    - name: Install dependencies
+      run: |
+        uv sync --dev
+        
+    - name: Run tests
+      run: |
+        uv run pytest tests/ -v
+
+    - name: Run linting
+      run: |
+        uv run ruff check .
+
+    - name: Python Semantic Release
+      id: release
+      uses: python-semantic-release/python-semantic-release@v10.2.0
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Publish to PyPI
+      if: steps.release.outputs.released == 'true'
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        uv run twine upload dist/*

{mvn_tree_visualizer-1.3.0 → mvn_tree_visualizer-1.4.0}/CHANGELOG.md

@@ -5,10 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
-
-### Added
-- Placeholder for future features
+<!--next-version-placeholder-->
 
 ## [1.3.0] - 2025-07-09
 
@@ -48,6 +45,39 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 - Enhanced CLI help text to reflect new features
+- Improved JSON output structure for better programmatic access
+- Updated documentation with version feature examples
+
+### Fixed
+- Type annotation issues and improved code clarity
+- JSON serialization for complex dependency structures
+
+## [1.1.0] - 2025-07-05
+
+### Added
+- JSON output format option for programmatic consumption
+- Multi-file support for Maven modules (searches for multiple `maven_dependency_file`)
+- File merging functionality for complex projects
+- Comprehensive error handling for file operations
+- Enhanced CLI with format selection
+
+### Changed
+- Improved project structure with organized outputs directory
+- Better separation of concerns between HTML and JSON generation
+
+### Fixed
+- File handling issues with large dependency trees
+- Output format validation and error messages
+
+## [1.0.0] - 2025-07-01
+
+### Added
+- Initial release of mvn-tree-visualizer
+- HTML diagram generation using Mermaid.js
+- CLI interface for processing Maven dependency files
+- Basic error handling and validation
+- Support for Maven dependency tree parsing
+- Interactive HTML output with visual dependency graphs
 - Improved code documentation and readability with type hints
 - Updated README.md with new feature documentation and usage examples
 

{mvn_tree_visualizer-1.3.0 → mvn_tree_visualizer-1.4.0}/CONTRIBUTING.md

@@ -47,8 +47,48 @@ pytest
 
 ### Commit and push
 
+We use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages to enable automatic versioning and changelog generation.
+
+**Commit Message Format:**
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+**Types:**
+- `feat`: A new feature (triggers minor version bump)
+- `fix`: A bug fix (triggers patch version bump)
+- `docs`: Documentation only changes
+- `style`: Changes that do not affect the meaning of the code
+- `refactor`: A code change that neither fixes a bug nor adds a feature
+- `perf`: A code change that improves performance (triggers patch version bump)
+- `test`: Adding missing tests or correcting existing tests
+- `chore`: Changes to the build process or auxiliary tools
+- `ci`: Changes to CI configuration files and scripts
+
+**Examples:**
+```bash
+feat: add theme support with --theme option
+fix: resolve dependency parsing error with special characters
+docs: update README with new theme examples
+chore: update dependencies to latest versions
+```
+
+**BREAKING CHANGES:**
+For breaking changes, add `!` after the type or include `BREAKING CHANGE:` in the footer:
+```bash
+feat!: change CLI interface for better usability
+# or
+feat: change CLI interface
+
+BREAKING CHANGE: --output-format flag renamed to --format
+```
+
 ```bash
-git commit -m "Your descriptive commit message"
+git commit -m "feat: add your new feature description"
 git push origin 123-add-a-feature
 ```
 

{mvn_tree_visualizer-1.3.0 → mvn_tree_visualizer-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mvn-tree-visualizer
-Version: 1.3.0
+Version: 1.4.0
 Summary: A simple command line tool to visualize the dependency tree of a Maven project in a graphical format.
 Project-URL: source, https://github.com/dyka3773/mvn-tree-visualizer
 Author-email: Iraklis Konsoulas <dyka3773@gmail.com>
@@ -55,12 +55,14 @@ pip install mvn-tree-visualizer
 - **🌐 Multiple Output Formats:**
   - **HTML:** Generates an interactive HTML diagram of your dependency tree using Mermaid.js.
   - **JSON:** Creates a structured JSON representation of the dependency tree, perfect for scripting or integration with other tools.
+- **🎨 Theme System:** Choose from 2 built-in themes (minimal, dark) for clean and consistent diagram styling.
 - **🔄 Watch Mode:** Automatically regenerates diagrams when Maven dependency files change using the `--watch` flag.
 - **📋 Version Display:** Show or hide dependency versions in both HTML and JSON outputs using the `--show-versions` flag.
 - **⚡ Easy to Use:** A simple command-line interface that gets the job done with minimal configuration.
 - **📂 File Merging:** Automatically finds and merges multiple `maven_dependency_file` files from different subdirectories.
 - **🎨 Customizable Output:** Specify the output file name and location.
-- **💾 SVG Export:** Download the generated diagram as an SVG file directly from the HTML page.
+- **💾 Enhanced Downloads:** Download diagrams as SVG or high-resolution PNG directly from the HTML page.
+- **🖱️ Interactive Features:** Hover tooltips, click-to-highlight connections, pan/zoom controls, and keyboard shortcuts.
 
 ## How to Use
 
@@ -93,6 +95,15 @@ mvn_tree_visualizer --filename "maven_dependency_file" --output "dependencies.js
 mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html" --show-versions
 ```
 
+#### With Custom Themes
+```bash
+# Dark theme for low-light environments  
+mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html" --theme dark
+
+# Default minimal theme (clean monospace design)
+mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html"
+```
+
 #### JSON Output with Versions
 ```bash
 mvn_tree_visualizer --filename "maven_dependency_file" --output "dependencies.json" --format json --show-versions
@@ -129,12 +140,20 @@ Each example includes:
 | `--filename` | The name of the file containing the Maven dependency tree | `maven_dependency_file` |
 | `--output` | The name of the output file | `diagram.html` |
 | `--format` | The output format (`html` or `json`) | `html` |
+| `--theme` | Theme for HTML diagrams (`minimal`, `dark`) | `minimal` |
 | `--show-versions` | Show dependency versions in the diagram | `False` |
 | `--watch` | Watch for file changes and auto-regenerate diagram | `False` |
 | `--directory` | The directory to scan for the Maven dependency file(s) | current directory |
 | `--keep-tree` | Keep the intermediate `dependency_tree.txt` file | `False` |
 | `--help` | Show the help message and exit | - |
 
+### Theme Options
+
+- **`minimal`**: Clean monospace design with simple black borders (default)
+- **`dark`**: Same minimal styling but with white text on black background
+
+📖 **See the complete [Theme Documentation](docs/THEMES.md) for detailed information about themes and interactive features.**
+
 ## Performance
 
 **For Large Projects:**

{mvn_tree_visualizer-1.3.0 → mvn_tree_visualizer-1.4.0}/README.md

@@ -35,12 +35,14 @@ pip install mvn-tree-visualizer
 - **🌐 Multiple Output Formats:**
   - **HTML:** Generates an interactive HTML diagram of your dependency tree using Mermaid.js.
   - **JSON:** Creates a structured JSON representation of the dependency tree, perfect for scripting or integration with other tools.
+- **🎨 Theme System:** Choose from 2 built-in themes (minimal, dark) for clean and consistent diagram styling.
 - **🔄 Watch Mode:** Automatically regenerates diagrams when Maven dependency files change using the `--watch` flag.
 - **📋 Version Display:** Show or hide dependency versions in both HTML and JSON outputs using the `--show-versions` flag.
 - **⚡ Easy to Use:** A simple command-line interface that gets the job done with minimal configuration.
 - **📂 File Merging:** Automatically finds and merges multiple `maven_dependency_file` files from different subdirectories.
 - **🎨 Customizable Output:** Specify the output file name and location.
-- **💾 SVG Export:** Download the generated diagram as an SVG file directly from the HTML page.
+- **💾 Enhanced Downloads:** Download diagrams as SVG or high-resolution PNG directly from the HTML page.
+- **🖱️ Interactive Features:** Hover tooltips, click-to-highlight connections, pan/zoom controls, and keyboard shortcuts.
 
 ## How to Use
 
@@ -73,6 +75,15 @@ mvn_tree_visualizer --filename "maven_dependency_file" --output "dependencies.js
 mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html" --show-versions
 ```
 
+#### With Custom Themes
+```bash
+# Dark theme for low-light environments  
+mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html" --theme dark
+
+# Default minimal theme (clean monospace design)
+mvn_tree_visualizer --filename "maven_dependency_file" --output "diagram.html"
+```
+
 #### JSON Output with Versions
 ```bash
 mvn_tree_visualizer --filename "maven_dependency_file" --output "dependencies.json" --format json --show-versions
@@ -109,12 +120,20 @@ Each example includes:
 | `--filename` | The name of the file containing the Maven dependency tree | `maven_dependency_file` |
 | `--output` | The name of the output file | `diagram.html` |
 | `--format` | The output format (`html` or `json`) | `html` |
+| `--theme` | Theme for HTML diagrams (`minimal`, `dark`) | `minimal` |
 | `--show-versions` | Show dependency versions in the diagram | `False` |
 | `--watch` | Watch for file changes and auto-regenerate diagram | `False` |
 | `--directory` | The directory to scan for the Maven dependency file(s) | current directory |
 | `--keep-tree` | Keep the intermediate `dependency_tree.txt` file | `False` |
 | `--help` | Show the help message and exit | - |
 
+### Theme Options
+
+- **`minimal`**: Clean monospace design with simple black borders (default)
+- **`dark`**: Same minimal styling but with white text on black background
+
+📖 **See the complete [Theme Documentation](docs/THEMES.md) for detailed information about themes and interactive features.**
+
 ## Performance
 
 **For Large Projects:**

mvn_tree_visualizer-1.4.0/RELEASE.md

@@ -0,0 +1,185 @@
+# Release Procedure
+
+This document describes the automated release process for `mvn-tree-visualizer` using `python-semantic-release`.
+
+## Overview
+
+The project uses automated releases with **python-semantic-release**:
+- **Automatic versioning** based on conventional commit messages
+- **Automatic CHANGELOG.md generation** from commit history
+- **Automatic PyPI publication** when code is pushed to `master`
+- **Automatic GitHub releases** with release notes
+
+### Workflow Branches:
+- `develop` - Active development branch where features are integrated
+- `master` - Protected production branch, triggers automated releases
+- `feature/*` - Individual feature branches
+
+## Conventional Commits
+
+All commits must follow [Conventional Commits](https://www.conventionalcommits.org/) specification:
+
+### Commit Types and Version Impact:
+- `feat:` - New feature → **MINOR** version bump (1.3.0 → 1.4.0)
+- `fix:` - Bug fix → **PATCH** version bump (1.3.0 → 1.3.1)  
+- `perf:` - Performance improvement → **PATCH** version bump
+- `feat!:` or `BREAKING CHANGE:` → **MAJOR** version bump (1.3.0 → 2.0.0)
+- `docs:`, `style:`, `refactor:`, `test:`, `chore:` - No version bump
+
+### Examples:
+```bash
+feat: add theme support with --theme option
+fix: resolve dependency parsing error with special characters  
+feat!: change CLI interface for better usability
+docs: update README with theme examples
+```
+
+## Automated Release Process
+
+### 1. Development Workflow
+
+```bash
+# Create feature branch from develop
+git checkout develop
+git pull origin develop
+git checkout -b feature/add-theme-support
+
+# Make changes and commit using conventional commits
+git add .
+git commit -m "feat: add theme system with dark/light modes"
+git push origin feature/add-theme-support
+```
+
+### 2. Create Pull Request to Develop
+
+Create a pull request from your feature branch to `develop`:
+- Title: Clear description of the feature
+- Description: Details of changes and any breaking changes
+- Ensure all tests pass in CI
+
+### 3. Merge to Develop
+
+Once the PR is reviewed and approved, merge it into `develop`.
+
+### 4. Release to Master
+
+When ready for a release:
+
+```bash
+# Create release PR from develop to master
+git checkout develop
+git pull origin develop
+```
+
+Create a pull request from `develop` to `master`:
+- Title: "Release: Prepare for next version"
+- Description: Summary of changes since last release
+- List any breaking changes
+
+### 5. Automated Release (Master Branch)
+
+When the release PR is merged to `master`, the automation triggers:
+
+1. **python-semantic-release analyzes commits** since the last release
+2. **Determines version bump** based on conventional commit types
+3. **Updates version** in `pyproject.toml`
+4. **Generates CHANGELOG.md** from commit messages
+5. **Creates Git tag** with new version
+6. **Builds package** using `python -m build`
+7. **Publishes to PyPI** automatically
+8. **Creates GitHub release** with generated release notes
+
+## Manual Release (Emergency)
+
+For emergency releases or manual intervention:
+
+```bash
+# Install semantic-release locally
+uv sync --dev
+
+# Preview what will be released (dry-run)
+uv run semantic-release --dry-run
+
+# Force a specific version type
+uv run semantic-release --patch  # or --minor, --major
+
+# Generate changelog only
+uv run semantic-release changelog
+```
+
+## Monitoring Releases
+
+### Check Release Status:
+1. **GitHub Actions**: Monitor the [release workflow](https://github.com/dyka3773/mvn-tree-visualizer/actions)
+2. **PyPI**: Verify new version appears on [PyPI](https://pypi.org/project/mvn-tree-visualizer/)
+3. **GitHub Releases**: Check [GitHub releases page](https://github.com/dyka3773/mvn-tree-visualizer/releases)
+
+### Troubleshooting:
+
+**Failed Release:**
+- Check GitHub Actions logs for specific errors
+- Verify conventional commit format in recent commits
+- Ensure GITHUB_TOKEN has sufficient permissions
+- Check PyPI trusted publishing configuration
+
+**No Version Bump:**
+- Ensure commits follow conventional commit format
+- Check that commits include `feat:` or `fix:` types
+- Verify commits are not filtered out by semantic-release config
+
+## Configuration
+
+The release behavior is configured in `pyproject.toml`:
+
+```toml
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+build_command = "python -m build"
+upload_to_pypi = true
+upload_to_release = true
+
+[tool.semantic_release.commit_parser_options]
+allowed_tags = ["build", "chore", "ci", "docs", "feat", "fix", "perf", "style", "refactor", "test"]
+minor_tags = ["feat"]
+patch_tags = ["fix", "perf"]
+```
+
+## Migration from Manual Process
+
+**Previous manual steps no longer needed:**
+- ❌ Manual version updates in `pyproject.toml`
+- ❌ Manual CHANGELOG.md editing
+- ❌ Manual Git tag creation
+- ❌ Manual PyPI uploads
+
+**New automated process:**
+- ✅ Conventional commit messages
+- ✅ Automatic version management
+- ✅ Automatic changelog generation
+- ✅ Automatic PyPI publishing
+- ✅ Automatic GitHub releases
+
+## Emergency Procedures
+
+### Rollback a Release:
+```bash
+# Revert the problematic release commit
+git revert <release-commit-hash>
+
+# Push to master to trigger new patch release
+git push origin master
+```
+
+### Hotfix Process:
+```bash
+# Create hotfix branch from master
+git checkout master
+git checkout -b hotfix/critical-bug-fix
+
+# Make minimal fix
+git commit -m "fix: resolve critical security vulnerability"
+
+# Create PR directly to master (bypass develop for emergencies)
+```
+
+This automated approach ensures consistent, reliable releases while reducing manual effort and human error.

{mvn_tree_visualizer-1.3.0 → mvn_tree_visualizer-1.4.0}/ROADMAP.md

@@ -33,38 +33,69 @@ This document outlines the future direction of the `mvn-tree-visualizer` project
 
 **Focus:** Making the tool more user-friendly and robust for daily use.
 
-*   **Remaining Tasks:**
-    *   [ ] Separate parser module for better modularity (optional enhancement)
-    *   [ ] Additional edge case testing (optional enhancement)
+*   **Status:** Released July 9, 2025
+*   **Completed Tasks:**
+    *   [x] Watch mode functionality with `--watch` flag
+    *   [x] Enhanced error handling system with comprehensive user guidance
+    *   [x] Custom exception classes and validation modules
+    *   [x] Comprehensive test coverage (22 tests)
+    *   [x] Modular code organization improvements
 
-## v1.4.0 - Visual and Theme Enhancements 🎨
+## v1.4.0 - Visual and Theme Enhancements ✅ (Released)
 
 **Focus:** Making the output more visually appealing and customizable.
 
-*   **Visual Themes:**
-    *   [ ] `--theme` option with multiple built-in themes
-    *   [ ] Dark, light, and colorful theme options
-    *   [ ] Better default styling and typography
-    *   [ ] Custom CSS support for advanced users
-*   **Interactive Features:**
-    *   [ ] Tooltips with detailed dependency information
-    *   [ ] Hover effects and better visual feedback
-    *   [ ] Expandable/collapsible dependency groups
+**Status:** Released July 17, 2025
+
+*   **Visual Themes (Completed):**
+    *   [x] `--theme` option with multiple built-in themes (default/minimal, dark, light)
+    *   [x] Standardized color scheme across all themes
+    *   [x] Clean minimal design as default theme  
+    *   [x] Enhanced dark theme with proper text visibility
+    *   [x] Consistent graphDiv styling across themes
+*   **Interactive Features (Completed):**
+    *   [x] SVG download functionality
+    *   [x] Pan and zoom controls with keyboard shortcuts
+    *   [x] Full-screen diagram experience
+    *   [x] Improved hover effects for nodes
+*   **Template Enhancements (Completed):**
+    *   [x] Enhanced template system with theme support
+    *   [x] Improved Mermaid.js configuration options
+    *   [x] Standardized color coding for node types (root=blue, intermediate=orange, leaf=green)
+    *   [x] Comprehensive examples for all themes
+
+## v1.5.0 - Interactive Features 🎯 (Next Release)
+
+**Focus:** Enhanced interactivity and user experience.
+
+**Priority:** High - Building on the solid theme foundation with interactive capabilities.
+
+*   **Node Interaction Features (High Priority):**
+    *   [ ] **Descendant Highlighting:** Click nodes to highlight only their downstream dependencies
+    *   [ ] Tooltips with detailed dependency information (groupId, version, scope)
+    *   [ ] Expandable/collapsible dependency groups for large trees
+    *   [ ] Search and filter functionality within diagrams
+*   **Enhanced Controls (Medium Priority):**
+    *   [ ] PNG download option alongside SVG
+    *   [ ] Zoom to fit specific dependency subtrees
+    *   [ ] Better visual hierarchy controls for nested dependencies
+*   **Performance & Layout (Medium Priority):**
+    *   [ ] Better layout options for large dependency trees
+    *   [ ] Performance optimizations for very large projects
 
-## v1.5.0 - Advanced Features 🚀
+## v1.6.0 - Advanced Features 🚀
 
 **Focus:** Performance and advanced functionality for power users.
 
-*   **Performance & Layout:**
-    *   [ ] Better layout options for large dependency trees
-    *   [ ] Performance optimizations for very large projects
-    *   [ ] Memory usage improvements for complex graphs
 *   **Export Enhancements:**
     *   [ ] PNG, PDF export options
     *   [ ] SVG improvements and customization
     *   [ ] High-quality output for presentations
+*   **Advanced Analysis:**
+    *   [ ] Memory usage improvements for complex graphs
+    *   [ ] Dependency statistics and analysis
 
-## v1.6.0+ - Extended Capabilities 🔮
+## v1.7.0+ - Extended Capabilities 🔮
 
 **Focus:** Advanced analysis and integration features.
 
@@ -97,4 +128,4 @@ If you're interested in contributing to any of these features, please check out
 
 ---
 
-*Last updated: July 9, 2025*
+*Last updated: July 16, 2025*