@crashbytes/dendro 1.0.2 → 1.1.1

package/.github/dependabot.yml

@@ -0,0 +1,50 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+    open-pull-requests-limit: 10
+    groups:
+      # Group all production dependencies
+      production-dependencies:
+        applies-to: version-updates
+        dependency-type: "production"
+        update-types:
+          - "minor"
+          - "patch"
+      
+      # Group development dependencies
+      development-dependencies:
+        applies-to: version-updates
+        dependency-type: "development"
+        update-types:
+          - "minor"
+          - "patch"
+    
+    # Auto-assign PRs
+    assignees:
+      - "MichaelEakins"
+    
+    # Labels for PRs
+    labels:
+      - "dependencies"
+      - "automated"
+    
+    commit-message:
+      prefix: "chore(deps)"
+      include: "scope"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "chore(actions)"

package/.github/workflows/release.yml

@@ -0,0 +1,48 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+# CRITICAL: Required for npm Trusted Publishing (OIDC authentication)
+permissions:
+  contents: write  # Needed to create GitHub releases
+  id-token: write  # Needed for npm provenance/trusted publishing
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '20'
+          # NO registry-url - prevents .npmrc conflicts with OIDC
+
+      - name: Upgrade npm for Trusted Publishing
+        run: npm install -g npm@latest  # Requires npm >= 11.5.1
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Test
+        run: npm test
+
+      - name: Publish to npm with Provenance
+        run: npm publish --provenance --access public
+        # OIDC authentication via GitHub Actions - no tokens needed!
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref }}
+          name: Release ${{ github.ref_name }}
+          body: |
+            See [CHANGELOG.md](https://github.com/CrashBytes/dendro/blob/main/CHANGELOG.md) for details.
+          draft: false
+          prerelease: false

package/.github/workflows/test.yml

@@ -0,0 +1,39 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x]
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+    
+    - name: Setup Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Run tests with coverage
+      run: npm run test:coverage
+    
+    - name: Upload coverage to Codecov
+      if: matrix.node-version == '20.x'
+      uses: codecov/codecov-action@v4
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}
+        files: ./coverage/lcov.info
+        flags: unittests
+        fail_ci_if_error: false

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to dendro 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).
 
+## [1.1.0] - 2025-01-14
+
+### Changed
+- 🔄 **BREAKING**: Converted project from CommonJS to ESM (ES Modules)
+- ⬆️ Updated chalk from v4.1.2 to v5.6.2 (major version upgrade)
+- 📦 Updated commander to v14.0.2 (already latest)
+- 🔧 Added `"type": "module"` to package.json
+- 📝 Updated all imports to use ESM syntax (`import`/`export` instead of `require`/`module.exports`)
+- 🔗 Updated relative imports to include `.js` extensions for ESM compatibility
+
+### Migration Notes
+- Node.js 20+ required (already specified in engines)
+- If you were importing this package, update your code to use ESM imports
+- All functionality remains the same, only the module system changed
+
 ## [1.0.1] - 2025-10-13
 
 ### Fixed
@@ -36,5 +51,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 📊 Built-in statistics
 - 🔧 Both CLI and API
 
+[1.1.0]: https://github.com/CrashBytes/dendro/releases/tag/v1.1.0
 [1.0.1]: https://github.com/CrashBytes/dendro/releases/tag/v1.0.1
 [1.0.0]: https://github.com/CrashBytes/dendro/releases/tag/v1.0.0

package/README.md

@@ -11,7 +11,9 @@
 
 A beautiful, fast directory tree visualization CLI with intuitive file type icons.
 
-🔗 **[GitHub Repository](https://github.com/CrashBytes/dendro)** | 📦 **[npm Package](https://www.npmjs.com/package/@crashbytes/dendro)**
+📚 **[Documentation](https://crashbytes.github.io/dendro/)** | 🔗 **[GitHub Repository](https://github.com/CrashBytes/dendro)** | 📦 **[npm Package](https://www.npmjs.com/package/@crashbytes/dendro)**
+
+> **Note:** Requires Node.js 20.0.0 or higher
 
 ---
 
@@ -368,8 +370,6 @@ MIT License - see [LICENSE](https://github.com/CrashBytes/dendro/blob/main/LICEN
 
 ## Acknowledgments
 
-Built with ❤️ for developers who love beautiful CLIs.
-
 Special thanks to all [contributors](https://github.com/CrashBytes/dendro/graphs/contributors) who help make dendro better!
 
 ---

package/bin/cli.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 
-const { Command } = require('commander');
-const chalk = require('chalk');
-const path = require('path');
-const { buildTree, renderTree, getTreeStats } = require('../index');
+import { Command } from 'commander';
+import chalk from 'chalk';
+import path from 'path';
+import { buildTree, renderTree, getTreeStats } from '../index.js';
 
 const program = new Command();
 
 program
   .name('dendro')
   .description('Display directory tree structure with beautiful icons')
-  .version('1.0.0')
+  .version('1.1.0')
   .argument('[path]', 'Directory path to display', '.')
   .option('-d, --max-depth <number>', 'Maximum depth to traverse', parseInt)
   .option('-a, --all', 'Show hidden files and directories', false)

package/deploy.sh

@@ -0,0 +1,95 @@
+#!/bin/bash
+set -e  # Exit on any error
+
+# Configuration
+VERSION=$(node -p "require('./package.json').version")
+
+echo "🚀 Dendro v${VERSION} Production Deployment"
+echo "========================================"
+echo ""
+
+# Phase 1: Pre-flight Validation
+echo "📋 Phase 1: Pre-flight Validation"
+echo "-----------------------------------"
+
+# Check Node.js version
+NODE_VERSION=$(node -v)
+echo "✓ Node.js: $NODE_VERSION"
+
+# Check npm version
+NPM_VERSION=$(npm -v)
+echo "✓ npm: $NPM_VERSION"
+
+# Verify authentication
+echo -n "✓ npm authentication: "
+npm whoami
+
+echo ""
+
+# Phase 2: Test Suite Execution
+echo "🧪 Phase 2: Test Suite Execution"
+echo "-----------------------------------"
+npm test
+
+echo ""
+
+# Phase 3: Package Validation
+echo "📦 Phase 3: Package Validation"
+echo "-----------------------------------"
+echo "Package contents preview:"
+npm pack --dry-run
+
+echo ""
+
+# Phase 4: Git Operations
+echo "📝 Phase 4: Version Control"
+echo "-----------------------------------"
+
+# Check git status
+if [[ -n $(git status -s) ]]; then
+    echo "Committing changes..."
+    git add package.json .gitignore
+    git commit -m "chore: bump version to ${VERSION} - update repository links and secure credentials"
+    echo "✓ Changes committed"
+else
+    echo "✓ Working directory clean"
+fi
+
+# Create and push tag
+echo "Creating version tag v${VERSION}..."
+git tag -f "v${VERSION}"
+echo "✓ Tag created"
+
+echo "Pushing to remote..."
+git push origin main
+git push origin "v${VERSION}" --force
+echo "✓ Pushed to GitHub"
+
+echo ""
+
+# Phase 5: NPM Publication
+echo "🚀 Phase 5: NPM Publication"
+echo "-----------------------------------"
+echo "Publishing @crashbytes/dendro@${VERSION}..."
+npm publish --access public
+
+echo ""
+
+# Phase 6: Post-Deployment Verification
+echo "✅ Phase 6: Post-Deployment Verification"
+echo "-----------------------------------"
+echo "Package details:"
+npm view @crashbytes/dendro
+
+echo ""
+echo "=========================================="
+echo "✨ Deployment Complete!"
+echo "=========================================="
+echo ""
+echo "Verification commands:"
+echo "  npm install -g @crashbytes/dendro@${VERSION}"
+echo "  dendro --version"
+echo ""
+echo "Package URL:"
+echo "  https://www.npmjs.com/package/@crashbytes/dendro"
+echo ""

package/docs/index.html

@@ -0,0 +1,360 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Dendro Documentation - Directory Tree Visualization</title>
+    <meta name="description" content="A beautiful directory tree visualization CLI with file type icons - dendro (δένδρο) means 'tree' in Greek">
+    <style>
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+        }
+
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+            line-height: 1.6;
+            color: #333;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            padding: 2rem 1rem;
+        }
+        
+        .container {
+            max-width: 900px;
+            margin: 0 auto;
+            background: white;
+            border-radius: 12px;
+            box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
+            overflow: hidden;
+        }
+
+        .header {
+            background: linear-gradient(135deg, #2c3e50 0%, #34495e 100%);
+            color: white;
+            padding: 3rem 2rem;
+            text-align: center;
+        }
+
+        .header h1 {
+            font-size: 2.5rem;
+            margin-bottom: 0.5rem;
+            font-weight: 700;
+        }
+
+        .header .subtitle {
+            font-size: 1.1rem;
+            opacity: 0.9;
+            font-style: italic;
+        }
+
+        .content {
+            padding: 2rem;
+        }
+
+        .badge {
+            display: inline-block;
+            background: #27ae60;
+            color: white;
+            padding: 0.25rem 0.75rem;
+            border-radius: 12px;
+            font-size: 0.85rem;
+            font-weight: 600;
+            margin: 0.5rem 0.25rem;
+        }
+
+        .badge.warning {
+            background: #e67e22;
+        }
+
+        .requirements {
+            background: #fff3cd;
+            border-left: 4px solid #ffc107;
+            padding: 1rem;
+            margin: 1.5rem 0;
+            border-radius: 4px;
+        }
+
+        .requirements strong {
+            color: #856404;
+        }
+        
+        .code-block-container {
+            position: relative;
+            margin: 1.5rem 0;
+        }
+        
+        .copy-button {
+            position: absolute;
+            top: 0.5rem;
+            right: 0.5rem;
+            padding: 0.5rem 1rem;
+            background: #667eea;
+            color: white;
+            border: none;
+            border-radius: 6px;
+            cursor: pointer;
+            font-size: 0.875rem;
+            font-weight: 600;
+            transition: all 0.2s;
+            z-index: 10;
+        }
+        
+        .copy-button:hover {
+            background: #764ba2;
+            transform: translateY(-1px);
+        }
+        
+        .copy-button.copied {
+            background: #27ae60;
+        }
+        
+        pre {
+            background: #2c3e50;
+            color: #ecf0f1;
+            border-radius: 8px;
+            padding: 1.5rem;
+            overflow-x: auto;
+            font-size: 0.9rem;
+        }
+        
+        code {
+            font-family: 'Monaco', 'Courier New', monospace;
+        }
+        
+        h2 {
+            color: #2c3e50;
+            font-size: 1.8rem;
+            margin: 2rem 0 1rem;
+            padding-bottom: 0.5rem;
+            border-bottom: 2px solid #667eea;
+        }
+
+        h3 {
+            color: #34495e;
+            font-size: 1.3rem;
+            margin: 1.5rem 0 0.75rem;
+        }
+
+        .section {
+            margin-bottom: 2rem;
+        }
+
+        .features {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+            gap: 1rem;
+            margin: 1.5rem 0;
+        }
+
+        .feature-card {
+            background: #f8f9fa;
+            padding: 1.5rem;
+            border-radius: 8px;
+            border-left: 4px solid #667eea;
+        }
+
+        .feature-card h4 {
+            color: #2c3e50;
+            margin-bottom: 0.5rem;
+        }
+
+        .footer {
+            background: #2c3e50;
+            color: white;
+            padding: 2rem;
+            text-align: center;
+        }
+
+        .footer a {
+            color: #667eea;
+            text-decoration: none;
+            font-weight: 600;
+        }
+
+        .footer a:hover {
+            color: #764ba2;
+        }
+
+        @media (max-width: 768px) {
+            .header h1 {
+                font-size: 2rem;
+            }
+            
+            .content {
+                padding: 1.5rem;
+            }
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="header">
+            <h1>🌳 Dendro</h1>
+            <p class="subtitle">δένδρο (dendro) means "tree" in Greek</p>
+            <div style="margin-top: 1rem;">
+                <span class="badge">v1.0.2</span>
+                <span class="badge">Node.js 20+</span>
+                <span class="badge">MIT License</span>
+            </div>
+        </div>
+
+        <div class="content">
+            <section class="section">
+                <p style="font-size: 1.1rem; color: #555; margin-bottom: 1.5rem;">
+                    A beautiful directory tree visualization CLI with file type icons. 
+                    Perfect for exploring project structures, creating documentation, and understanding codebases.
+                </p>
+
+                <div class="requirements">
+                    <strong>⚠️ Requirements:</strong> Node.js version 20.0.0 or higher is required.
+                </div>
+            </section>
+
+            <section class="section">
+                <h2>✨ Features</h2>
+                <div class="features">
+                    <div class="feature-card">
+                        <h4>🎨 Beautiful Icons</h4>
+                        <p>File type-specific icons for instant recognition</p>
+                    </div>
+                    <div class="feature-card">
+                        <h4>⚡ Lightning Fast</h4>
+                        <p>Optimized performance for large directories</p>
+                    </div>
+                    <div class="feature-card">
+                        <h4>🎯 Configurable Depth</h4>
+                        <p>Control how deep to traverse directories</p>
+                    </div>
+                    <div class="feature-card">
+                        <h4>👁️ Hidden Files</h4>
+                        <p>Toggle visibility of hidden files and folders</p>
+                    </div>
+                </div>
+            </section>
+
+            <section class="section">
+                <h2>📦 Installation</h2>
+                
+                <h3>Via npm (Recommended)</h3>
+                <div class="code-block-container">
+                    <button class="copy-button" onclick="copyCode(this, 'install-npm')">Copy</button>
+                    <pre><code id="install-npm">npm install -g @crashbytes/dendro</code></pre>
+                </div>
+                
+                <h3>Via npx (No Installation)</h3>
+                <div class="code-block-container">
+                    <button class="copy-button" onclick="copyCode(this, 'install-npx')">Copy</button>
+                    <pre><code id="install-npx">npx @crashbytes/dendro</code></pre>
+                </div>
+                
+                <h3>From Source (GitHub)</h3>
+                <div class="code-block-container">
+                    <button class="copy-button" onclick="copyCode(this, 'install-source')">Copy</button>
+                    <pre><code id="install-source">git clone https://github.com/CrashBytes/dendro.git
+cd dendro
+npm install
+npm link</code></pre>
+                </div>
+            </section>
+            
+            <section class="section">
+                <h2>🚀 Quick Start</h2>
+                
+                <h3>Basic Usage</h3>
+                <div class="code-block-container">
+                    <button class="copy-button" onclick="copyCode(this, 'quickstart-1')">Copy</button>
+                    <pre><code id="quickstart-1"># Visualize current directory
+dendro</code></pre>
+                </div>
+                
+                <div class="code-block-container">
+                    <button class="copy-button" onclick="copyCode(this, 'quickstart-2')">Copy</button>
+                    <pre><code id="quickstart-2"># Visualize specific directory
+dendro /path/to/project</code></pre>
+                </div>
+                
+                <h3>Advanced Options</h3>
+                <div class="code-block-container">
+                    <button class="copy-button" onclick="copyCode(this, 'quickstart-3')">Copy</button>
+                    <pre><code id="quickstart-3"># Limit depth to 3 levels
+dendro ~/projects -d 3</code></pre>
+                </div>
+                
+                <div class="code-block-container">
+                    <button class="copy-button" onclick="copyCode(this, 'quickstart-4')">Copy</button>
+                    <pre><code id="quickstart-4"># Show all files including hidden
+dendro -a</code></pre>
+                </div>
+                
+                <div class="code-block-container">
+                    <button class="copy-button" onclick="copyCode(this, 'quickstart-5')">Copy</button>
+                    <pre><code id="quickstart-5"># Combine options
+dendro ~/my-project -d 2 -a</code></pre>
+                </div>
+                
+                <h3>Get Help</h3>
+                <div class="code-block-container">
+                    <button class="copy-button" onclick="copyCode(this, 'quickstart-6')">Copy</button>
+                    <pre><code id="quickstart-6"># Show help
+dendro --help</code></pre>
+                </div>
+            </section>
+
+            <section class="section">
+                <h2>📖 Command Options</h2>
+                <pre style="background: #f8f9fa; color: #2c3e50; border: 1px solid #e1e4e8;">
+Usage: dendro [options] [directory]
+
+Arguments:
+  directory           Directory to visualize (default: current directory)
+
+Options:
+  -V, --version       Output the version number
+  -d, --depth <n>     Maximum depth to traverse (default: unlimited)
+  -a, --all           Show hidden files and directories
+  -h, --help          Display help for command
+                </pre>
+            </section>
+        </div>
+
+        <div class="footer">
+            <p><a href="https://github.com/CrashBytes" target="_blank">CrashBytes</a></p>
+            <p style="margin-top: 0.5rem;">
+                <a href="https://github.com/CrashBytes/dendro" target="_blank">GitHub</a> • 
+                <a href="https://www.npmjs.com/package/@crashbytes/dendro" target="_blank">npm</a> • 
+                <a href="https://github.com/CrashBytes/dendro/issues" target="_blank">Report Issues</a>
+            </p>
+        </div>
+    </div>
+    
+    <script>
+        async function copyCode(button, codeId) {
+            const codeElement = document.getElementById(codeId);
+            const textToCopy = codeElement.textContent;
+            
+            try {
+                await navigator.clipboard.writeText(textToCopy);
+                
+                // Visual feedback
+                const originalText = button.textContent;
+                button.textContent = '✓ Copied!';
+                button.classList.add('copied');
+                
+                // Reset after 2 seconds
+                setTimeout(() => {
+                    button.textContent = originalText;
+                    button.classList.remove('copied');
+                }, 2000);
+            } catch (err) {
+                console.error('Failed to copy text:', err);
+                button.textContent = 'Failed';
+                setTimeout(() => {
+                    button.textContent = 'Copy';
+                }, 2000);
+            }
+        }
+    </script>
+</body>
+</html>

package/index.js

@@ -1,5 +1,5 @@
-const fs = require('fs');
-const path = require('path');
+import fs from 'fs';
+import path from 'path';
 
 // Icon mappings for different file types and directories
 const icons = {
@@ -287,7 +287,7 @@ function getTreeStats(tree) {
   return { files, directories };
 }
 
-module.exports = {
+export {
   buildTree,
   renderTree,
   getTreeStats,

package/package.json

@@ -1,13 +1,17 @@
 {
   "name": "@crashbytes/dendro",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "description": "A beautiful directory tree visualization CLI with file type icons - dendro (δένδρο) means 'tree' in Greek",
+  "type": "module",
   "main": "index.js",
   "bin": {
     "dendro": "bin/cli.js"
   },
   "scripts": {
-    "test": "node test.js"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui"
   },
   "keywords": [
     "directory",
@@ -28,10 +32,15 @@
   },
   "homepage": "https://github.com/CrashBytes/dendro#readme",
   "dependencies": {
-    "commander": "^11.1.0",
-    "chalk": "^4.1.2"
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/ui": "^4.0.18",
+    "vitest": "^4.0.18"
   }
 }

package/test/index.test.js

@@ -0,0 +1,387 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { buildTree, renderTree, getTreeStats, getIcon, icons } from '../index.js';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+describe('getIcon', () => {
+  it('should return directory icon for directories', () => {
+    expect(getIcon('my-folder', true)).toBe(icons.directory);
+    expect(getIcon('src', true)).toBe(icons.directory);
+  });
+
+  it('should return correct icons for JavaScript files', () => {
+    expect(getIcon('app.js', false)).toBe(icons.javascript);
+    expect(getIcon('component.jsx', false)).toBe(icons.javascript);
+    expect(getIcon('module.mjs', false)).toBe(icons.javascript);
+    expect(getIcon('common.cjs', false)).toBe(icons.javascript);
+  });
+
+  it('should return correct icons for TypeScript files', () => {
+    expect(getIcon('app.ts', false)).toBe(icons.typescript);
+    expect(getIcon('component.tsx', false)).toBe(icons.typescript);
+  });
+
+  it('should return correct icons for config files', () => {
+    expect(getIcon('config.yaml', false)).toBe(icons.config);
+    expect(getIcon('config.yml', false)).toBe(icons.config);
+    expect(getIcon('config.toml', false)).toBe(icons.config);
+  });
+
+
+  it('should return correct icons for markdown files', () => {
+    expect(getIcon('README.md', false)).toBe(icons.markdown);
+    expect(getIcon('CHANGELOG.mdx', false)).toBe(icons.markdown);
+  });
+
+  it('should return correct icons for data files', () => {
+    expect(getIcon('data.json', false)).toBe(icons.json);
+    expect(getIcon('package.json', false)).toBe(icons.json);
+  });
+
+  it('should return correct icons for image files', () => {
+    expect(getIcon('photo.png', false)).toBe(icons.image);
+    expect(getIcon('logo.svg', false)).toBe(icons.image);
+    expect(getIcon('image.jpg', false)).toBe(icons.image);
+    expect(getIcon('pic.jpeg', false)).toBe(icons.image);
+  });
+
+  it('should return correct icons for lock files', () => {
+    expect(getIcon('package-lock.json', false)).toBe(icons.lock);
+    expect(getIcon('yarn.lock', false)).toBe(icons.lock);
+    expect(getIcon('pnpm-lock.yaml', false)).toBe(icons.lock);
+  });
+
+  it('should return correct icons for git files', () => {
+    expect(getIcon('.gitignore', false)).toBe(icons.git);
+    expect(getIcon('.gitattributes', false)).toBe(icons.git);
+  });
+
+  it('should return default icon for unknown file types', () => {
+    expect(getIcon('unknown.xyz', false)).toBe(icons.default);
+  });
+
+  it('should be case-insensitive for extensions', () => {
+    expect(getIcon('FILE.JS', false)).toBe(icons.javascript);
+    expect(getIcon('FILE.PNG', false)).toBe(icons.image);
+  });
+});
+
+
+describe('buildTree', () => {
+  let tempDir;
+
+  beforeEach(() => {
+    // Create a temporary test directory structure
+    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'dendro-test-'));
+    
+    // Create test structure
+    fs.mkdirSync(path.join(tempDir, 'src'));
+    fs.mkdirSync(path.join(tempDir, 'test'));
+    fs.mkdirSync(path.join(tempDir, '.git'));
+    fs.writeFileSync(path.join(tempDir, 'README.md'), '# Test');
+    fs.writeFileSync(path.join(tempDir, 'package.json'), '{}');
+    fs.writeFileSync(path.join(tempDir, 'src', 'index.js'), 'console.log("test")');
+    fs.writeFileSync(path.join(tempDir, 'test', 'test.js'), 'test');
+    fs.writeFileSync(path.join(tempDir, '.git', 'config'), '');
+  });
+
+  afterEach(() => {
+    // Clean up temp directory
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  });
+
+  it('should build a tree structure', () => {
+    const tree = buildTree(tempDir);
+    
+    expect(tree).toBeDefined();
+    expect(tree.type).toBe('directory');
+    expect(tree.name).toBe(path.basename(tempDir));
+    expect(tree.children).toBeDefined();
+    expect(Array.isArray(tree.children)).toBe(true);
+  });
+
+  it('should include files and directories', () => {
+    const tree = buildTree(tempDir);
+    
+    expect(tree.children.length).toBeGreaterThan(0);
+    
+    const hasFiles = tree.children.some(child => child.type === 'file');
+    const hasDirs = tree.children.some(child => child.type === 'directory');
+    
+    expect(hasFiles).toBe(true);
+    expect(hasDirs).toBe(true);
+  });
+
+
+  it('should respect maxDepth option', () => {
+    // maxDepth: 1 means we go to depth 0 only (root), children at depth 1 return null
+    const tree1 = buildTree(tempDir, { maxDepth: 1 });
+    expect(tree1.children.every(child => !child.children || child.children.length === 0)).toBe(true);
+    
+    // maxDepth: 2 means we go to depths 0 and 1, children at depth 2 return null
+    const tree2 = buildTree(tempDir, { maxDepth: 2 });
+    const srcDir = tree2.children.find(child => child.name === 'src' && child.type === 'directory');
+    // srcDir exists at depth 1, but its children (at depth 2) won't be built
+    if (srcDir) {
+      expect(srcDir.children).toBeDefined();
+      // Children array exists but should be empty since they're at maxDepth
+      expect(srcDir.children.length).toBe(0);
+    }
+  });
+
+  it('should hide hidden files by default', () => {
+    const tree = buildTree(tempDir, { showHidden: false });
+    
+    const hasHidden = tree.children.some(child => child.name.startsWith('.'));
+    expect(hasHidden).toBe(false);
+  });
+
+  it('should show hidden files when showHidden is true', () => {
+    const tree = buildTree(tempDir, { showHidden: true });
+    
+    const gitDir = tree.children.find(child => child.name === '.git');
+    expect(gitDir).toBeDefined();
+  });
+
+  it('should exclude patterns', () => {
+    const tree = buildTree(tempDir, {
+      excludePatterns: [/^test$/]
+    });
+    
+    const testDir = tree.children.find(child => child.name === 'test');
+    expect(testDir).toBeUndefined();
+  });
+
+  it('should sort directories before files', () => {
+    const tree = buildTree(tempDir);
+    
+    let lastWasDir = true;
+    for (const child of tree.children) {
+      if (child.type === 'file' && lastWasDir) {
+        lastWasDir = false;
+      } else if (child.type === 'directory' && !lastWasDir) {
+        // Found a directory after a file - sorting is wrong
+        expect(true).toBe(false);
+      }
+    }
+    expect(true).toBe(true);
+  });
+
+
+  it('should sort items alphabetically within type', () => {
+    const tree = buildTree(tempDir);
+    
+    const dirs = tree.children.filter(c => c.type === 'directory');
+    const files = tree.children.filter(c => c.type === 'file');
+    
+    // Check directories are sorted
+    for (let i = 0; i < dirs.length - 1; i++) {
+      expect(dirs[i].name.localeCompare(dirs[i + 1].name)).toBeLessThanOrEqual(0);
+    }
+    
+    // Check files are sorted
+    for (let i = 0; i < files.length - 1; i++) {
+      expect(files[i].name.localeCompare(files[i + 1].name)).toBeLessThanOrEqual(0);
+    }
+  });
+
+  it('should return null for non-existent paths', () => {
+    const tree = buildTree('/non/existent/path');
+    expect(tree).toBeNull();
+  });
+
+  it('should handle empty directories', () => {
+    const emptyDir = path.join(tempDir, 'empty');
+    fs.mkdirSync(emptyDir);
+    
+    const tree = buildTree(emptyDir);
+    expect(tree).toBeDefined();
+    expect(tree.children).toBeDefined();
+    expect(tree.children.length).toBe(0);
+  });
+});
+
+
+describe('renderTree', () => {
+  it('should render a tree structure as text', () => {
+    const tree = {
+      name: 'root',
+      type: 'directory',
+      icon: '📁',
+      children: [
+        { name: 'file1.js', type: 'file', icon: '📜', path: '/root/file1.js' },
+        { name: 'file2.md', type: 'file', icon: '📝', path: '/root/file2.md' }
+      ]
+    };
+    
+    const output = renderTree(tree);
+    expect(output).toContain('root');
+    expect(output).toContain('file1.js');
+    expect(output).toContain('file2.md');
+    expect(output).toContain('📁');
+    expect(output).toContain('📜');
+    expect(output).toContain('📝');
+  });
+
+  it('should use tree connectors', () => {
+    const tree = {
+      name: 'root',
+      type: 'directory',
+      icon: '📁',
+      children: [
+        { name: 'file1.js', type: 'file', icon: '📜', path: '/root/file1.js' }
+      ]
+    };
+    
+    const output = renderTree(tree);
+    expect(output).toMatch(/[└├]/); // Should contain tree connectors
+  });
+
+  it('should hide icons when showIcons is false', () => {
+    const tree = {
+      name: 'root',
+      type: 'directory',
+      icon: '📁',
+      children: [
+        { name: 'file.js', type: 'file', icon: '📜', path: '/root/file.js' }
+      ]
+    };
+    
+    const output = renderTree(tree, { showIcons: false });
+    expect(output).not.toContain('📁');
+    expect(output).not.toContain('📜');
+    expect(output).toContain('root');
+    expect(output).toContain('file.js');
+  });
+
+
+  it('should show paths when showPaths is true', () => {
+    const tree = {
+      name: 'root',
+      type: 'directory',
+      icon: '📁',
+      path: '/test/root',
+      children: [
+        { name: 'file.js', type: 'file', icon: '📜', path: '/test/root/file.js' }
+      ]
+    };
+    
+    const output = renderTree(tree, { showPaths: true });
+    expect(output).toContain('/test/root');
+    expect(output).toContain('/test/root/file.js');
+  });
+
+  it('should return empty string for null tree', () => {
+    const output = renderTree(null);
+    expect(output).toBe('');
+  });
+
+  it('should handle nested structures', () => {
+    const tree = {
+      name: 'root',
+      type: 'directory',
+      icon: '📁',
+      children: [
+        {
+          name: 'src',
+          type: 'directory',
+          icon: '📁',
+          children: [
+            { name: 'index.js', type: 'file', icon: '📜', path: '/root/src/index.js' },
+            { name: 'utils.js', type: 'file', icon: '📜', path: '/root/src/utils.js' }
+          ]
+        }
+      ]
+    };
+    
+    const output = renderTree(tree);
+    expect(output).toContain('root');
+    expect(output).toContain('src');
+    expect(output).toContain('index.js');
+    // With siblings in src, we should get vertical lines
+    expect(output).toMatch(/[│├]/);
+  });
+});
+
+
+describe('getTreeStats', () => {
+  it('should count files and directories', () => {
+    const tree = {
+      name: 'root',
+      type: 'directory',
+      children: [
+        { name: 'file1.js', type: 'file' },
+        { name: 'file2.js', type: 'file' },
+        {
+          name: 'subdir',
+          type: 'directory',
+          children: [
+            { name: 'file3.js', type: 'file' }
+          ]
+        }
+      ]
+    };
+    
+    const stats = getTreeStats(tree);
+    expect(stats.files).toBe(3);
+    expect(stats.directories).toBe(2); // root + subdir
+  });
+
+  it('should return zero counts for null tree', () => {
+    const stats = getTreeStats(null);
+    expect(stats.files).toBe(0);
+    expect(stats.directories).toBe(0);
+  });
+
+  it('should handle empty directories', () => {
+    const tree = {
+      name: 'empty',
+      type: 'directory',
+      children: []
+    };
+    
+    const stats = getTreeStats(tree);
+    expect(stats.files).toBe(0);
+    expect(stats.directories).toBe(1);
+  });
+
+  it('should handle single file', () => {
+    const tree = {
+      name: 'file.js',
+      type: 'file'
+    };
+    
+    const stats = getTreeStats(tree);
+    expect(stats.files).toBe(1);
+    expect(stats.directories).toBe(0);
+  });
+
+  it('should handle deeply nested structures', () => {
+    const tree = {
+      name: 'root',
+      type: 'directory',
+      children: [
+        {
+          name: 'level1',
+          type: 'directory',
+          children: [
+            {
+              name: 'level2',
+              type: 'directory',
+              children: [
+                { name: 'deep.js', type: 'file' }
+              ]
+            },
+            { name: 'file1.js', type: 'file' }
+          ]
+        },
+        { name: 'file2.js', type: 'file' }
+      ]
+    };
+    
+    const stats = getTreeStats(tree);
+    expect(stats.files).toBe(3);
+    expect(stats.directories).toBe(3); // root, level1, level2
+  });
+});

package/test.js

@@ -1,5 +1,5 @@
-const { buildTree, renderTree, getTreeStats, getIcon } = require('./index');
-const path = require('path');
+import { buildTree, renderTree, getTreeStats, getIcon } from './index.js';
+import path from 'path';
 
 console.log('Running tests for dendro...\n');
 

package/vitest.config.js

@@ -0,0 +1,26 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'html', 'lcov'],
+      exclude: [
+        'node_modules/**',
+        'test/**',
+        'bin/cli.js', // CLI is harder to test, focus on core logic
+        '*.config.js',
+        'coverage/**',
+        'dist/**'
+      ],
+      thresholds: {
+        lines: 80,
+        functions: 80,
+        branches: 70,
+        statements: 80
+      }
+    }
+  }
+});