mani-calc 1.1.0

package/CONTRIBUTING.md

@@ -0,0 +1,110 @@
+# Contributing to Mani-Calc
+
+Thank you for your interest in contributing to Mani-Calc! 🎉
+
+## How to Contribute
+
+### Reporting Bugs
+1. Check if the bug has already been reported in [Issues](https://github.com/manireddy/mani-calc/issues)
+2. If not, create a new issue with:
+   - Clear title and description
+   - Steps to reproduce
+   - Expected vs actual behavior
+   - Your environment (Windows version, Node.js version)
+
+### Suggesting Features
+1. Check existing [Issues](https://github.com/manireddy/mani-calc/issues) for similar suggestions
+2. Create a new issue with:
+   - Clear description of the feature
+   - Use cases and benefits
+   - Possible implementation approach
+
+### Code Contributions
+
+#### Setup Development Environment
+```bash
+# Clone the repository
+git clone https://github.com/manireddy/mani-calc.git
+cd mani-calc
+
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Test locally
+node bin/cli.js "2 + 3 * 5"
+```
+
+#### Making Changes
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Add tests for new functionality
+5. Ensure all tests pass (`npm test`)
+6. Commit with clear messages (`git commit -m 'Add amazing feature'`)
+7. Push to your fork (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+
+#### Code Style
+- Use clear, descriptive variable names
+- Add comments for complex logic
+- Follow existing code structure
+- Keep functions focused and small
+- Use ES6+ features where appropriate
+
+#### Testing
+- Add tests for new features
+- Ensure existing tests pass
+- Test on Windows 10/11
+- Test both CLI and Windows Search integration
+
+### Areas for Contribution
+
+#### High Priority
+- [ ] PowerToys Run plugin integration
+- [ ] Advanced math functions
+- [ ] Currency conversion (with offline rates)
+- [ ] Date/time calculations
+
+#### Medium Priority
+- [ ] Graph plotting
+- [ ] Step-by-step solutions
+- [ ] Custom user commands
+- [ ] Plugin system
+
+#### Nice to Have
+- [ ] Voice input support
+- [ ] Themes for CLI
+- [ ] Export history to CSV
+- [ ] Sync history across devices
+
+## Code of Conduct
+
+### Our Standards
+- Be respectful and inclusive
+- Welcome newcomers
+- Accept constructive criticism
+- Focus on what's best for the community
+
+### Unacceptable Behavior
+- Harassment or discrimination
+- Trolling or insulting comments
+- Publishing others' private information
+- Other unprofessional conduct
+
+## Questions?
+
+Feel free to:
+- Open an issue for discussion
+- Reach out to maintainers
+- Check existing documentation
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.
+
+---
+
+**Thank you for making Mani-Calc better!** 🚀

package/EXAMPLES.md

@@ -0,0 +1,220 @@
+# Examples - Mani-Calc
+
+Comprehensive examples of what you can do with Mani-Calc.
+
+## 📐 Basic Math
+
+### Arithmetic
+```bash
+mani-calc "2 + 3"                  # 5
+mani-calc "10 - 4"                 # 6
+mani-calc "5 * 6"                  # 30
+mani-calc "20 / 4"                 # 5
+mani-calc "2 + 3 * 5"              # 17 (order of operations)
+mani-calc "(2 + 3) * 5"            # 25 (parentheses)
+```
+
+### Powers & Roots
+```bash
+mani-calc "2^8"                    # 256
+mani-calc "10^3"                   # 1000
+mani-calc "sqrt(49)"               # 7
+mani-calc "sqrt(144)"              # 12
+mani-calc "cbrt(27)"               # 3 (cube root)
+```
+
+### Advanced Math
+```bash
+mani-calc "sin(pi/2)"              # 1
+mani-calc "cos(0)"                 # 1
+mani-calc "tan(pi/4)"              # 1
+mani-calc "log(100)"               # 2 (log base 10)
+mani-calc "ln(e)"                  # 1 (natural log)
+mani-calc "abs(-42)"               # 42
+```
+
+### Constants
+```bash
+mani-calc "pi"                     # 3.14159...
+mani-calc "e"                      # 2.71828...
+mani-calc "pi * 2"                 # 6.28318...
+mani-calc "e^2"                    # 7.38906...
+```
+
+## 💬 Natural Language
+
+### Percentages
+```bash
+mani-calc "what is 25 percent of 200"      # 50
+mani-calc "15% of 300"                     # 45
+mani-calc "calculate 10 percent of 500"    # 50
+mani-calc "what is 7.5 percent of 1000"    # 75
+```
+
+### Fractions
+```bash
+mani-calc "half of 80"             # 40
+mani-calc "quarter of 100"         # 25
+mani-calc "third of 90"            # 30
+```
+
+### Powers (Natural Language)
+```bash
+mani-calc "10 squared"             # 100
+mani-calc "5 cubed"                # 125
+mani-calc "2 to the power of 10"   # 1024
+mani-calc "3 raised to 4"          # 81
+```
+
+### Square Roots (Natural Language)
+```bash
+mani-calc "square root of 64"      # 8
+mani-calc "sqrt of 100"            # 10
+```
+
+## 🔄 Unit Conversions
+
+### Length
+```bash
+mani-calc "10 km to miles"         # 6.21 miles
+mani-calc "5 miles to km"          # 8.05 km
+mani-calc "100 cm to inches"       # 39.37 inches
+mani-calc "6 feet to meters"       # 1.83 meters
+mani-calc "1000 mm to cm"          # 100 cm
+mani-calc "2 yards to feet"        # 6 feet
+```
+
+### Weight
+```bash
+mani-calc "10 kg to pounds"        # 22.05 pounds
+mani-calc "5 pounds to kg"         # 2.27 kg
+mani-calc "1000 grams to kg"       # 1 kg
+mani-calc "16 oz to pounds"        # 1 pound
+mani-calc "2 tons to kg"           # 2000 kg
+```
+
+### Temperature
+```bash
+mani-calc "0 celsius to fahrenheit"        # 32 fahrenheit
+mani-calc "100 celsius to fahrenheit"      # 212 fahrenheit
+mani-calc "98.6 fahrenheit to celsius"     # 37 celsius
+mani-calc "273.15 kelvin to celsius"       # 0 celsius
+mani-calc "32 fahrenheit to kelvin"        # 273.15 kelvin
+```
+
+### Time
+```bash
+mani-calc "2 hours to minutes"     # 120 minutes
+mani-calc "120 seconds to minutes" # 2 minutes
+mani-calc "1 day to hours"         # 24 hours
+mani-calc "1 week to days"         # 7 days
+mani-calc "365 days to hours"      # 8760 hours
+```
+
+### Volume
+```bash
+mani-calc "5 liters to gallons"    # 1.32 gallons
+mani-calc "1 gallon to liters"     # 3.79 liters
+mani-calc "500 ml to liters"       # 0.5 liters
+mani-calc "2 cups to ml"           # 473.18 ml
+mani-calc "1 quart to liters"      # 0.95 liters
+```
+
+### Speed
+```bash
+mani-calc "100 km/h to mph"        # 62.14 mph
+mani-calc "60 mph to km/h"         # 96.56 km/h
+mani-calc "10 m/s to km/h"         # 36 km/h
+```
+
+## 📚 History Commands
+
+```bash
+mani-calc history                  # View last 10 calculations
+mani-calc "clear history"          # Clear all history
+```
+
+## 🎯 Real-World Use Cases
+
+### Shopping
+```bash
+# Calculate discount
+mani-calc "what is 20 percent of 150"      # 30 (discount amount)
+mani-calc "150 - 30"                       # 120 (final price)
+
+# Tax calculation
+mani-calc "what is 8.5 percent of 100"     # 8.5 (tax)
+```
+
+### Cooking
+```bash
+mani-calc "2 cups to ml"           # 473.18 ml
+mani-calc "350 fahrenheit to celsius"      # 176.67 celsius
+mani-calc "half of 250"            # 125 (halving recipe)
+```
+
+### Travel
+```bash
+mani-calc "500 km to miles"        # 310.69 miles
+mani-calc "120 km/h to mph"        # 74.56 mph
+mani-calc "10 kg to pounds"        # 22.05 pounds (luggage weight)
+```
+
+### Fitness
+```bash
+mani-calc "5 miles to km"          # 8.05 km (running distance)
+mani-calc "150 pounds to kg"       # 68.04 kg (body weight)
+```
+
+### Science & Engineering
+```bash
+mani-calc "9.8 * 5"                # 49 (acceleration * time)
+mani-calc "sqrt(2) * 10"           # 14.14 (diagonal calculation)
+mani-calc "pi * 5^2"               # 78.54 (circle area)
+```
+
+## 🔧 Advanced Features
+
+### Chaining Calculations
+```bash
+# In interactive mode
+calc> x = 100
+calc> x * 2
+✓ 200
+
+calc> x / 4
+✓ 25
+```
+
+### Complex Expressions
+```bash
+mani-calc "((10 + 5) * 3 - 20) / 5"        # 5
+mani-calc "sqrt(16) + sqrt(9)"             # 7
+mani-calc "2^3 + 3^2"                      # 17
+```
+
+## 💡 Tips
+
+1. **Quotes**: Use quotes for queries with spaces
+   ```bash
+   mani-calc "10 km to miles"  # ✓ Correct
+   mani-calc 10 km to miles    # ✗ Won't work
+   ```
+
+2. **Case Insensitive**: Units are case-insensitive
+   ```bash
+   mani-calc "10 KM to MILES"  # Works!
+   mani-calc "10 Km to Miles"  # Works!
+   ```
+
+3. **Flexible Syntax**: Multiple ways to express the same thing
+   ```bash
+   mani-calc "10 kilometers to miles"
+   mani-calc "10 km to miles"
+   mani-calc "10 kilometer to mile"
+   # All work!
+   ```
+
+---
+
+**Want more examples? Check out the [README](README.md) or run `mani-calc --help`**

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Manideep Reddy Eevuri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/OVERLAY_MODE.md

@@ -0,0 +1,361 @@
+# 🎨 Overlay Mode - Floating Search Box
+
+## ✨ New Feature: Spotlight-Style Overlay
+
+Mani-Calc now includes a **beautiful floating search box** that appears anywhere on your screen with a simple keyboard shortcut!
+
+---
+
+## 🚀 Quick Start
+
+### 1. Install Dependencies
+```bash
+npm install
+```
+
+### 2. Start Overlay Mode
+```bash
+npm run overlay
+```
+
+Or after global installation:
+```bash
+mani-calc-overlay
+```
+
+### 3. Use the Hotkey
+Press **`Alt+Space`** anywhere in Windows to toggle the search box!
+
+---
+
+## 🎯 Features
+
+### ⚡ Global Hotkey
+- **Default**: `Alt+Space`
+- Works from any application
+- Instant access to calculations
+- Always-on-top overlay
+
+### 🧮 All Calculation Features
+- Math expressions
+- Natural language queries
+- Unit conversions
+- Calculation history
+
+### 💻 System Commands
+Control your computer with simple commands:
+
+| Command | Action |
+|---------|--------|
+| `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` | Increase volume |
+| `volume down` | Decrease volume |
+| `mute` | Mute volume |
+| `unmute` | Unmute volume |
+
+### 🎨 Beautiful UI
+- Glassmorphism design
+- Smooth animations
+- Live preview
+- Auto-hide on blur
+- Keyboard shortcuts
+
+---
+
+## 📖 Usage
+
+### Basic Calculations
+```
+Type: 2 + 3 * 5
+Result: ✓ 2 + 3 * 5 = 17
+```
+
+### Natural Language
+```
+Type: what is 25% of 200
+Result: ✓ what is 25% of 200 = 50
+```
+
+### Unit Conversions
+```
+Type: 10 km to miles
+Result: ✓ 10 km = 6.21 miles
+```
+
+### System Commands
+```
+Type: sleep
+Result: ✓ System going to sleep...
+```
+
+```
+Type: lock
+Result: ✓ Locking computer...
+```
+
+---
+
+## ⌨️ Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Alt+Space` | Toggle search box |
+| `Enter` | Execute query |
+| `Esc` | Close search box |
+| `Ctrl+C` | Exit overlay mode |
+
+---
+
+## 🎨 UI Features
+
+### Glassmorphism Design
+- Semi-transparent white background
+- Blur effect
+- Smooth shadows
+- Modern aesthetic
+
+### Live Preview
+- See results as you type
+- Instant feedback
+- No need to press Enter for simple calculations
+
+### Auto-Hide
+- Automatically hides when you click outside
+- Keeps your desktop clean
+- Instant recall with hotkey
+
+### Smooth Animations
+- Slide-down effect for results
+- Fade transitions
+- Professional feel
+
+---
+
+## 🔧 Advanced Configuration
+
+### Change Hotkey
+Edit `src/ui/floating-search.js`:
+
+```javascript
+this.hotkey = 'Ctrl+Shift+Space'; // Your custom hotkey
+```
+
+### Customize Position
+Edit `src/ui/floating-search.js`:
+
+```javascript
+const y = Math.floor(height * 0.3); // Change 0.3 to adjust vertical position
+```
+
+### Customize Appearance
+Edit `src/ui/overlay.html` CSS section to change:
+- Colors
+- Size
+- Transparency
+- Border radius
+- Shadows
+
+---
+
+## 💡 Use Cases
+
+### Quick Calculations While Working
+```
+Working in Excel → Alt+Space → "2500 * 0.15" → Enter
+Result copied → Paste in Excel
+```
+
+### System Control
+```
+Finishing work → Alt+Space → "lock" → Enter
+Computer locked instantly
+```
+
+### Unit Conversions
+```
+Reading recipe → Alt+Space → "2 cups to ml" → Enter
+Result: 473.18 ml
+```
+
+### Quick Sleep
+```
+Alt+Space → "sleep" → Enter
+Computer goes to sleep
+```
+
+---
+
+## 🛠️ Troubleshooting
+
+### Hotkey Not Working?
+
+**Check for conflicts:**
+```bash
+# Other apps might be using Alt+Space
+# Change the hotkey in floating-search.js
+```
+
+### Overlay Not Appearing?
+
+**Restart overlay mode:**
+```bash
+# Press Ctrl+C to stop
+# Run: npm run overlay
+```
+
+### System Commands Not Working?
+
+**Run as Administrator:**
+```bash
+# Right-click Command Prompt → Run as Administrator
+# Then: npm run overlay
+```
+
+---
+
+## 🎯 Comparison: Overlay vs Windows Search
+
+| Feature | Overlay Mode | Windows Search |
+|---------|--------------|----------------|
+| **Hotkey** | Alt+Space (customizable) | Win+S |
+| **Position** | Center screen | Top-right |
+| **Design** | Modern glassmorphism | Windows default |
+| **System Commands** | ✅ Yes | ❌ No |
+| **Live Preview** | ✅ Yes | ❌ No |
+| **Always Available** | ✅ Yes | ✅ Yes |
+
+**Use Both!**
+- **Overlay**: Quick calculations, system commands
+- **Windows Search**: File search, web search, calculations
+
+---
+
+## 🚀 Auto-Start on Windows Boot
+
+### Option 1: Task Scheduler
+1. Open Task Scheduler
+2. Create Basic Task
+3. Name: "Mani-Calc Overlay"
+4. Trigger: At log on
+5. Action: Start program
+6. Program: `C:\Program Files\nodejs\node.exe`
+7. Arguments: `C:\Users\[YourName]\AppData\Roaming\npm\node_modules\mani-calc\bin\overlay.js`
+
+### Option 2: Startup Folder
+1. Press `Win+R`
+2. Type: `shell:startup`
+3. Create shortcut to overlay.js
+4. Restart computer
+
+---
+
+## 📊 Performance
+
+- **Memory Usage**: ~50-80 MB (Electron)
+- **CPU Usage**: <1% when idle
+- **Startup Time**: ~2 seconds
+- **Response Time**: <100ms
+
+---
+
+## 🎨 Customization Ideas
+
+### Change Theme
+Edit `overlay.html` CSS:
+```css
+/* Dark theme */
+.search-box {
+  background: rgba(30, 30, 30, 0.95);
+  color: white;
+}
+```
+
+### Add More System Commands
+Edit `floating-search.js`:
+```javascript
+'screenshot': {
+  action: async () => {
+    await execAsync('snippingtool');
+    return 'Opening Snipping Tool...';
+  }
+}
+```
+
+### Change Size
+Edit `floating-search.js`:
+```javascript
+width: 800,  // Make wider
+height: 100, // Make taller
+```
+
+---
+
+## 🔐 Privacy & Security
+
+### System Commands
+- All commands run locally
+- No network requests
+- Requires user confirmation (Enter key)
+- Can be disabled by removing commands
+
+### Data Storage
+- Same as CLI mode
+- History stored locally
+- No telemetry
+
+---
+
+## 🎉 Tips & Tricks
+
+### 1. Quick Math
+```
+Alt+Space → "15*23" → Enter
+Result copied instantly
+```
+
+### 2. Chain Commands
+```
+Alt+Space → "100 km to miles" → Enter
+Alt+Space → "lock" → Enter
+```
+
+### 3. Use as Calculator Replacement
+```
+Never open Calculator app again!
+Alt+Space is faster
+```
+
+### 4. System Control Hub
+```
+Alt+Space → "sleep"
+Alt+Space → "lock"
+Alt+Space → "mute"
+```
+
+---
+
+## 🗺️ Future Enhancements
+
+- [ ] Custom themes
+- [ ] Plugin system
+- [ ] File search integration
+- [ ] Web search integration
+- [ ] Clipboard history
+- [ ] Snippets/templates
+- [ ] Multi-monitor support
+- [ ] Custom hotkeys per command
+
+---
+
+## 🤝 Contributing
+
+Want to add more system commands or features? See [CONTRIBUTING.md](../CONTRIBUTING.md)
+
+---
+
+**Enjoy your new productivity superpower!** ⚡