mani-calc 2.1.0 → 2.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mani-calc",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Spotlight-style instant calculator for Windows | Math, Currency, Date/Time, Programmer Mode, Password Generator, Color Converter, Text Utils, Emoji, Web Search, 8 Themes | Offline-first productivity tool",
   "main": "src/index.js",
   "bin": {

package/ARCHITECTURE.md

@@ -1,249 +0,0 @@
-# 📁 Project Structure - Mani-Calc
-
-```
-mani-calc/
-│
-├── 📦 bin/
-│   └── cli.js                    # CLI entry point & interactive mode
-│
-├── 🧠 src/
-│   ├── index.js                  # Main ManiCalc class (orchestrator)
-│   │
-│   ├── 🔧 core/                  # Core calculation engines
-│   │   ├── math-engine.js        # Math expression evaluator (mathjs)
-│   │   ├── nlp-parser.js         # Natural language parser
-│   │   ├── unit-converter.js     # Unit conversion system
-│   │   ├── history-manager.js    # Calculation history storage
-│   │   └── clipboard-manager.js  # Clipboard integration
-│   │
-│   └── 🔌 integration/
-│       └── windows-search.js     # Windows Search protocol handler
-│
-├── 🧪 test/
-│   └── test.js                   # Comprehensive test suite
-│
-├── 📚 Documentation/
-│   ├── README.md                 # Main documentation
-│   ├── QUICKSTART.md             # Quick start guide
-│   ├── EXAMPLES.md               # Usage examples
-│   ├── CONTRIBUTING.md           # Contribution guidelines
-│   └── CHANGELOG.md              # Version history
-│
-├── ⚙️ Configuration/
-│   ├── package.json              # npm package configuration
-│   ├── .gitignore                # Git ignore rules
-│   └── LICENSE                   # MIT License
-│
-└── 🔧 .vscode/
-    └── extensions.json           # Recommended VS Code extensions
-```
-
-## 📋 File Descriptions
-
-### Core Components
-
-#### `src/index.js`
-- **Purpose**: Main orchestrator class
-- **Responsibilities**:
-  - Coordinates all subsystems
-  - Processes user queries
-  - Routes to appropriate handler (math/NLP/conversion)
-  - Manages initialization and shutdown
-
-#### `src/core/math-engine.js`
-- **Purpose**: Mathematical expression evaluator
-- **Features**:
-  - Uses mathjs for robust calculations
-  - Supports all standard math functions
-  - Custom functions (percent, half, double, triple)
-  - Variable storage for sessions
-  - Smart result formatting
-
-#### `src/core/nlp-parser.js`
-- **Purpose**: Natural language query parser
-- **Capabilities**:
-  - Percentage queries ("what is 25% of 200")
-  - Fraction queries ("half of 80")
-  - Power queries ("10 squared")
-  - Square root queries ("square root of 64")
-  - Unit conversion detection
-  - Pattern-based regex matching
-
-#### `src/core/unit-converter.js`
-- **Purpose**: Comprehensive unit conversion
-- **Supported Categories**:
-  - Length (km, miles, feet, etc.)
-  - Weight (kg, pounds, etc.)
-  - Temperature (C, F, K) - special handling
-  - Time (seconds, hours, days, etc.)
-  - Volume (liters, gallons, etc.)
-  - Speed (km/h, mph, etc.)
-
-#### `src/core/history-manager.js`
-- **Purpose**: Calculation history management
-- **Features**:
-  - Stores last 100 calculations
-  - Timestamps each entry
-  - Search functionality
-  - Formatted output
-  - Persistent storage in AppData
-
-#### `src/core/clipboard-manager.js`
-- **Purpose**: Clipboard integration
-- **Features**:
-  - Auto-copy results
-  - Read clipboard content
-  - Toggle auto-copy on/off
-
-#### `src/integration/windows-search.js`
-- **Purpose**: Windows Search integration
-- **Methods**:
-  - Protocol handler registration (calc:)
-  - Search connector creation
-  - Registry modifications
-  - Protocol URL parsing
-
-### Entry Points
-
-#### `bin/cli.js`
-- **Purpose**: Command-line interface
-- **Modes**:
-  - Direct query: `mani-calc "2+3"`
-  - Interactive REPL: `mani-calc`
-  - Protocol handler: `calc:2+3`
-  - Install/uninstall: `mani-calc install`
-- **Features**:
-  - Colored output (chalk)
-  - Help system
-  - Error handling
-  - Readline interface for interactive mode
-
-### Testing
-
-#### `test/test.js`
-- **Coverage**:
-  - Math engine tests (16 tests)
-  - NLP parser tests
-  - Unit converter tests
-  - All core functionality
-- **Output**: Colored test results
-
-## 🔄 Data Flow
-
-```
-User Input
-    ↓
-CLI / Windows Search
-    ↓
-ManiCalc.processQuery()
-    ↓
-┌─────────────┬──────────────┬─────────────┐
-│             │              │             │
-NLP Parser    Math Engine    Unit Converter
-│             │              │             │
-└─────────────┴──────────────┴─────────────┘
-    ↓
-Result Formatting
-    ↓
-┌─────────────┬──────────────┐
-│             │              │
-Clipboard     History Manager
-│             │              │
-└─────────────┴──────────────┘
-    ↓
-Display to User
-```
-
-## 💾 Storage Locations
-
-### History File
-```
-Windows: %APPDATA%\mani-calc\history.json
-```
-
-### Registry Keys (Windows Search)
-```
-HKEY_CURRENT_USER\Software\Classes\calc
-```
-
-### Search Connector
-```
-%APPDATA%\Microsoft\Windows\Libraries\ManiCalc.searchConnector-ms
-```
-
-## 🎯 Key Design Decisions
-
-### 1. **Modular Architecture**
-- Each component has a single responsibility
-- Easy to test and maintain
-- Simple to extend with new features
-
-### 2. **Offline-First**
-- No external API calls
-- All processing happens locally
-- Fast and private
-
-### 3. **User-Friendly**
-- Natural language support
-- Automatic clipboard integration
-- Smart error messages
-- Multiple input methods
-
-### 4. **Windows Integration**
-- Custom protocol handler
-- Search connector
-- Native feel
-
-### 5. **Developer Experience**
-- Clean code structure
-- Comprehensive tests
-- Well-documented
-- Easy to contribute
-
-## 🚀 Extension Points
-
-Want to add new features? Here's where to start:
-
-### Add New Unit Category
-→ Edit `src/core/unit-converter.js`
-→ Add to `conversions` object
-
-### Add New NLP Pattern
-→ Edit `src/core/nlp-parser.js`
-→ Add to `patterns` object
-
-### Add New Math Function
-→ Edit `src/core/math-engine.js`
-→ Add to `addCustomFunctions()`
-
-### Add New Command
-→ Edit `bin/cli.js`
-→ Add to command handling logic
-
-## 📊 Dependencies
-
-### Production
-- **mathjs**: Mathematical expression evaluator
-- **clipboardy**: Cross-platform clipboard access
-- **chalk**: Terminal colors
-- **node-windows**: Windows service management
-
-### Development
-- None (lightweight!)
-
-## 🔐 Security Considerations
-
-1. **No External Requests**: All processing is local
-2. **No Data Collection**: Zero telemetry
-3. **Safe Evaluation**: mathjs prevents code injection
-4. **Local Storage**: History stays on user's machine
-5. **Registry Safety**: Only modifies user-level keys
-
----
-
-**This structure is designed for:**
-- ✅ Easy maintenance
-- ✅ Simple testing
-- ✅ Quick feature additions
-- ✅ Clear separation of concerns
-- ✅ Excellent developer experience

package/CHANGELOG.md

@@ -1,69 +0,0 @@
-# Changelog
-
-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).
-
-## [1.1.0] - 2026-01-21
-
-### Added
-- 🎨 **Overlay Mode** - Beautiful floating search box with global hotkey
-  - Press `Alt+Space` anywhere to toggle
-  - Glassmorphism UI design
-  - Live preview as you type
-  - Auto-hide on blur
-  - Smooth animations
-- 💻 **System Commands** - Control your computer with simple commands
-  - `sleep` - Put computer to sleep
-  - `shutdown` - Shutdown computer
-  - `restart` - Restart computer
-  - `lock` - Lock computer
-  - `logout` - Log out current user
-  - `empty recycle bin` - Empty recycle bin
-  - `volume up/down` - Control volume
-  - `mute/unmute` - Mute/unmute volume
-- 📖 **OVERLAY_MODE.md** - Comprehensive overlay mode documentation
-- ⚡ **Electron Integration** - For floating search box UI
-- 🎯 **mani-calc-overlay** command - Quick start overlay mode
-
-### Changed
-- Updated README with overlay mode section
-- Enhanced documentation structure
-- Improved usage examples
-
-## [1.0.0] - 2026-01-21
-
-### Added
-- ✨ Basic math calculations with full operator support
-- 💬 Natural language processing for human-friendly queries
-- 🔄 Comprehensive unit conversion system
-  - Length (km, miles, feet, inches, etc.)
-  - Weight (kg, pounds, ounces, etc.)
-  - Temperature (Celsius, Fahrenheit, Kelvin)
-  - Time (seconds, minutes, hours, days, etc.)
-  - Volume (liters, gallons, cups, etc.)
-  - Speed (m/s, km/h, mph, etc.)
-- 📋 Automatic clipboard integration
-- 📚 Calculation history with timestamps
-- 🪟 Windows Search integration via custom protocol
-- 🎨 Beautiful CLI with colored output
-- 🔄 Interactive REPL mode
-- 🧪 Comprehensive test suite
-- 📖 Full documentation and examples
-
-### Features
-- Offline-first architecture
-- Zero telemetry or tracking
-- Lightweight and fast (< 100ms response time)
-- Support for mathematical functions (sqrt, sin, cos, log, etc.)
-- Support for constants (pi, e)
-- Variable storage during session
-- Smart error messages
-- Cross-platform clipboard support
-
-### Developer Experience
-- Clean, modular architecture
-- Well-documented code
-- Easy to extend and customize
-- MIT licensed for maximum freedom

package/COMPLETION_SUMMARY.md

@@ -1,304 +0,0 @@
-# ✅ MANI-CALC - PROJECT COMPLETE & DEPLOYED
-
-## 🎉 Congratulations!
-
-Your **mani-calc** package is now complete, documented, and live on GitHub!
-
----
-
-## 📦 What You Have
-
-### ✅ Complete Package
-- **Name**: `mani-calc`
-- **Tagline**: "Spotlight for Windows"
-- **GitHub**: https://github.com/Maniredii/mani-calc
-- **Status**: Production-ready
-
-### ✅ All Features Implemented
-- 🧮 Math calculations
-- 💬 Natural language processing
-- 🔄 Unit conversions (6 categories)
-- 📋 Clipboard integration
-- 📚 Calculation history
-- 🪟 Windows Search integration
-- 🎨 Beautiful CLI with colors
-
-### ✅ Complete Documentation
-- **README.md** - Comprehensive, detailed guide (400+ lines)
-- **QUICKSTART.md** - 2-minute setup guide
-- **EXAMPLES.md** - 50+ usage examples
-- **ARCHITECTURE.md** - Technical details
-- **CONTRIBUTING.md** - Contribution guidelines
-- **CHANGELOG.md** - Version history
-
-### ✅ Quality Assurance
-- 16 tests, all passing ✅
-- Clean, modular code
-- Well-documented
-- Production-ready
-
----
-
-## 📋 README Highlights
-
-Your new README includes:
-
-### 🎯 Clear Problem/Solution Framing
-- Explains the gap Windows users face
-- Positions mani-calc as "Spotlight for Windows"
-- Immediate value proposition
-
-### 📖 Comprehensive Documentation
-- **Quick Start** - Get running in 3 steps
-- **Features** - All capabilities explained with examples
-- **Installation** - Detailed setup instructions
-- **Usage** - 3 different ways to use (Search, CLI, Interactive)
-- **Real-World Use Cases** - Shopping, cooking, travel, fitness, etc.
-- **Advanced Features** - Variables, complex expressions
-- **Commands Reference** - Quick lookup table
-- **Troubleshooting** - Common issues and solutions
-- **Roadmap** - Future plans (Phases 2-4)
-
-### 🎨 Professional Presentation
-- Badges for npm, license, platform, Node version
-- Centered header with navigation
-- Code examples throughout
-- Organized sections
-- Clear formatting
-
----
-
-## 🗂️ Files Removed
-
-Cleaned up unnecessary files:
-- ❌ `GITHUB_DESCRIPTION.md` (content integrated into README)
-- ❌ `PROJECT_SUMMARY.md` (internal documentation, not needed in repo)
-
----
-
-## 📁 Final Project Structure
-
-```
-mani-calc/
-├── 📦 bin/
-│   └── cli.js                    # CLI entry point
-├── 🧠 src/
-│   ├── index.js                  # Main orchestrator
-│   ├── core/                     # Core engines
-│   │   ├── math-engine.js
-│   │   ├── nlp-parser.js
-│   │   ├── unit-converter.js
-│   │   ├── history-manager.js
-│   │   └── clipboard-manager.js
-│   └── integration/
-│       └── windows-search.js     # Windows Search integration
-├── 🧪 test/
-│   └── test.js                   # Test suite (16 tests)
-├── 📚 Documentation/
-│   ├── README.md                 # ⭐ NEW: Comprehensive guide
-│   ├── QUICKSTART.md
-│   ├── EXAMPLES.md
-│   ├── ARCHITECTURE.md
-│   ├── CONTRIBUTING.md
-│   └── CHANGELOG.md
-├── ⚙️ Configuration/
-│   ├── package.json
-│   ├── .gitignore
-│   └── LICENSE
-└── node_modules/                 # Dependencies
-```
-
----
-
-## 🚀 Next Steps
-
-### 1. Set GitHub Repository Description
-
-Go to your GitHub repo settings and set:
-
-**Description:**
-```
-⚡ Spotlight for Windows - Instant calculations from Windows Search
-```
-
-**Website:**
-```
-https://www.npmjs.com/package/mani-calc
-```
-
-**Topics/Tags:**
-```
-calculator, windows, productivity, spotlight, windows-search, math, 
-unit-converter, natural-language, instant-calculation, offline-first, 
-windows-productivity, cli-tool, npm-package, windows-10, windows-11
-```
-
-### 2. Publish to NPM
-
-```bash
-# Login to npm (create account if needed at npmjs.com)
-npm login
-
-# Publish the package
-npm publish
-```
-
-### 3. Create GitHub Release
-
-1. Go to https://github.com/Maniredii/mani-calc/releases
-2. Click "Create a new release"
-3. Tag: `v1.0.0`
-4. Title: `v1.0.0 - Initial Release: Spotlight for Windows`
-5. Description:
-```markdown
-## 🎉 First Release of Mani-Calc!
-
-**Mani-Calc** brings Spotlight-style instant calculations to Windows Search.
-
-### ✨ Features
-- 🧮 Math calculations with full operator support
-- 💬 Natural language processing
-- 🔄 Unit conversions (length, weight, temperature, time, volume, speed)
-- 📋 Automatic clipboard integration
-- 📚 Calculation history
-- 🪟 Windows Search integration via `calc:` protocol
-- ⚡ Lightning fast (<100ms)
-- 🔒 100% offline & private
-
-### 📥 Installation
-```bash
-npm install -g mani-calc
-mani-calc install
-```
-
-### 🎯 Usage
-Type in Windows Search:
-```
-calc: 2 + 3 * 5
-calc: 10 km to miles
-calc: what is 25% of 200
-```
-
-See the [README](https://github.com/Maniredii/mani-calc#readme) for full documentation.
-```
-
-### 4. Share Your Project
-
-**Reddit:**
-- r/Windows
-- r/productivity
-- r/node
-- r/programming
-
-**Twitter/X:**
-```
-🎉 Just launched mani-calc - Spotlight for Windows!
-
-Finally, Windows users can calculate directly from Windows Search:
-• calc: 2+3*5 → 17
-• calc: 10 km to miles → 6.21 miles
-• calc: what is 25% of 200 → 50
-
-100% offline, instant results, auto-copy to clipboard.
-
-npm install -g mani-calc
-
-https://github.com/Maniredii/mani-calc
-```
-
-**Dev.to / Hashnode:**
-Write a blog post about:
-- Why you built it
-- How it works
-- The technical challenges
-- Future plans
-
----
-
-## 📊 What Makes Your README Great
-
-### ✅ Clear Value Proposition
-- Immediately explains the problem
-- Shows the solution
-- Demonstrates value
-
-### ✅ Multiple Entry Points
-- Quick start for impatient users
-- Detailed docs for thorough readers
-- Examples for visual learners
-
-### ✅ Real-World Focus
-- Use cases people relate to
-- Practical examples
-- Solves actual problems
-
-### ✅ Professional Presentation
-- Badges show credibility
-- Clean formatting
-- Easy navigation
-- Comprehensive but scannable
-
-### ✅ Complete Coverage
-- Installation
-- Usage (3 methods)
-- Features
-- Examples
-- Troubleshooting
-- Contributing
-- Roadmap
-
----
-
-## 🎯 Success Metrics to Track
-
-Once published:
-- ⭐ GitHub stars
-- 📥 npm downloads per week
-- 🐛 Issues opened (shows engagement)
-- 🔧 Pull requests (community contributions)
-- 💬 Social media mentions
-- 📝 Blog posts/reviews
-
----
-
-## 🏆 You've Built Something Special
-
-**Why this will succeed:**
-
-1. ✅ **Solves a real problem** - Windows lacks Spotlight's calculator
-2. ✅ **Clear positioning** - "Spotlight for Windows" is instantly understood
-3. ✅ **Quality execution** - Production-ready, tested, documented
-4. ✅ **Privacy-focused** - 100% offline, no tracking
-5. ✅ **First of its kind** - No direct competition
-6. ✅ **Great documentation** - Users can get started immediately
-
----
-
-## 🎉 Final Checklist
-
-✅ Package created and configured  
-✅ All MVP features implemented  
-✅ 16 tests written and passing  
-✅ Comprehensive README (400+ lines)  
-✅ Complete documentation suite  
-✅ Unnecessary files removed  
-✅ Code pushed to GitHub  
-✅ Clean project structure  
-✅ Ready to publish to npm  
-✅ Ready to share with the world  
-
----
-
-## 🚀 You're Ready to Launch!
-
-Your package is **production-ready** and **fully documented**.
-
-**Next action**: Publish to npm with `npm publish`
-
-Then watch as Windows users discover the productivity tool they've been waiting for! 🌟
-
----
-
-**Made with ❤️ for Windows productivity enthusiasts**
-
-*Let's change how people calculate on Windows!*