mani-calc 1.1.0

package/RELEASE_NOTES_v1.1.0.md

@@ -0,0 +1,262 @@
+# 🎉 Mani-Calc v1.1.0 - Overlay Mode Release!
+
+## ✨ What's New
+
+### 🎨 Overlay Mode - The Game Changer!
+
+You asked for improvements, and we delivered! **Mani-Calc now has a beautiful floating search box** that appears anywhere on your screen with a simple keyboard shortcut!
+
+---
+
+## 🚀 New Features
+
+### 1. **Floating Search Box**
+- Press **`Alt+Space`** anywhere in Windows
+- Beautiful glassmorphism design
+- Always-on-top overlay
+- Auto-hide when you click outside
+- Smooth animations
+
+### 2. **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 |
+
+### 3. **Live Preview**
+- See results as you type
+- Instant feedback
+- No need to press Enter for simple calculations
+
+### 4. **Enhanced UI**
+- Glassmorphism design (semi-transparent, blurred background)
+- Smooth slide-down animations
+- Color-coded results (success, error, system commands)
+- Keyboard shortcuts displayed
+
+---
+
+## 📖 How to Use
+
+### Start Overlay Mode
+```bash
+npm run overlay
+
+# Or after global install
+mani-calc-overlay
+```
+
+### Use the Hotkey
+Press **`Alt+Space`** anywhere in Windows!
+
+### Examples
+```
+Alt+Space → "2 + 3 * 5" → Enter
+Result: ✓ 2 + 3 * 5 = 17
+
+Alt+Space → "10 km to miles" → Enter
+Result: ✓ 10 km = 6.21 miles
+
+Alt+Space → "sleep" → Enter
+Result: ✓ System going to sleep...
+
+Alt+Space → "lock" → Enter
+Result: ✓ Locking computer...
+```
+
+---
+
+## 🎯 Why This is Amazing
+
+### Before
+1. Open Calculator app
+2. Type calculation
+3. Copy result
+4. Switch back to work
+
+### After
+1. Press `Alt+Space`
+2. Type calculation
+3. Done! (result auto-copied)
+
+**That's 3x faster!** ⚡
+
+---
+
+## 📁 New Files
+
+- `src/ui/floating-search.js` - Floating search box logic
+- `src/ui/overlay.html` - Beautiful UI
+- `bin/overlay.js` - Overlay mode entry point
+- `OVERLAY_MODE.md` - Complete documentation
+
+---
+
+## 🔧 Technical Details
+
+### Stack
+- **Electron** - For native window management
+- **Global Shortcuts** - `Alt+Space` hotkey
+- **IPC** - Communication between UI and backend
+- **Glassmorphism CSS** - Modern, beautiful design
+
+### Performance
+- **Memory**: ~50-80 MB (Electron overhead)
+- **CPU**: <1% when idle
+- **Startup**: ~2 seconds
+- **Response**: <100ms
+
+---
+
+## 📊 Comparison
+
+| Feature | v1.0.0 | v1.1.0 |
+|---------|--------|--------|
+| **Windows Search** | ✅ | ✅ |
+| **CLI** | ✅ | ✅ |
+| **Interactive Mode** | ✅ | ✅ |
+| **Overlay Mode** | ❌ | ✅ NEW! |
+| **System Commands** | ❌ | ✅ NEW! |
+| **Live Preview** | ❌ | ✅ NEW! |
+| **Global Hotkey** | ❌ | ✅ NEW! |
+
+---
+
+## 🎨 UI Screenshots
+
+The overlay features:
+- **Glassmorphism design** - Semi-transparent with blur effect
+- **Smooth animations** - Slide-down results
+- **Color-coded feedback** - Green for success, red for errors, orange for system commands
+- **Keyboard shortcuts** - Displayed at bottom
+- **Auto-focus** - Input ready when you open it
+
+---
+
+## 🗺️ Roadmap Update
+
+### ✅ Completed (v1.1.0)
+- [x] Floating search box overlay
+- [x] Global hotkey support
+- [x] System commands
+- [x] Live preview
+- [x] Glassmorphism UI
+
+### 🔜 Coming Next (v1.2.0)
+- [ ] Custom themes
+- [ ] Plugin system
+- [ ] File search integration
+- [ ] Web search integration
+- [ ] Clipboard history
+- [ ] Multi-monitor support
+
+---
+
+## 📖 Documentation
+
+All documentation has been updated:
+
+- **README.md** - Added overlay mode section
+- **OVERLAY_MODE.md** - NEW: Complete overlay guide
+- **CHANGELOG.md** - v1.1.0 release notes
+- **package.json** - Updated to v1.1.0
+
+---
+
+## 🚀 Installation
+
+### For New Users
+```bash
+npm install -g mani-calc
+npm run overlay
+```
+
+### For Existing Users
+```bash
+npm update -g mani-calc
+npm run overlay
+```
+
+---
+
+## 💡 Tips & Tricks
+
+### 1. Auto-Start on Boot
+Add to Windows Startup folder for always-available calculator
+
+### 2. Customize Hotkey
+Edit `src/ui/floating-search.js` to change `Alt+Space` to your preference
+
+### 3. Add Custom Commands
+Edit `floating-search.js` to add your own system commands
+
+### 4. Change Theme
+Edit `overlay.html` CSS for dark mode or custom colors
+
+---
+
+## 🎯 Use Cases
+
+### Quick Math 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
+```
+
+---
+
+## 🤝 Community Feedback
+
+This feature was inspired by your request! Keep the feedback coming:
+- 🐛 Report bugs
+- 💡 Suggest features
+- ⭐ Star the repo
+- 🤝 Contribute code
+
+---
+
+## 📈 What's Next?
+
+We're listening to the community! Vote on features:
+1. Custom themes?
+2. Plugin system?
+3. File search integration?
+4. Web search integration?
+
+[Open an issue](https://github.com/Maniredii/mani-calc/issues) to vote!
+
+---
+
+## 🎉 Thank You!
+
+Thank you for using Mani-Calc and providing feedback. This overlay mode makes Windows productivity even better!
+
+**Enjoy your new floating calculator!** ⚡
+
+---
+
+**Version**: 1.1.0  
+**Release Date**: January 21, 2026  
+**Major Features**: Overlay Mode, System Commands, Live Preview

package/bin/cli.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+
+const ManiCalc = require('../src/index');
+const chalk = require('chalk');
+const readline = require('readline');
+
+const maniCalc = new ManiCalc();
+
+async function main() {
+    const args = process.argv.slice(2);
+
+    // Handle protocol URLs (calc:query)
+    if (args.length > 0 && args[0].startsWith('calc:')) {
+        const query = maniCalc.windowsSearch.parseProtocolUrl(args[0]);
+        if (query) {
+            const result = await maniCalc.processQuery(query);
+            displayResult(result);
+            process.exit(0);
+        }
+    }
+
+    // Handle direct query
+    if (args.length > 0) {
+        const query = args.join(' ');
+
+        // Special commands
+        if (query === 'install') {
+            await installService();
+            return;
+        }
+
+        if (query === 'uninstall') {
+            await uninstallService();
+            return;
+        }
+
+        if (query === 'version' || query === '-v' || query === '--version') {
+            const pkg = require('../package.json');
+            console.log(chalk.cyan(`mani-calc v${pkg.version}`));
+            return;
+        }
+
+        if (query === 'help' || query === '-h' || query === '--help') {
+            displayHelp();
+            return;
+        }
+
+        // Process calculation
+        const result = await maniCalc.processQuery(query);
+        displayResult(result);
+        return;
+    }
+
+    // Interactive mode
+    await startInteractiveMode();
+}
+
+async function installService() {
+    console.log(chalk.cyan('\n🔧 Installing Mani-Calc...\n'));
+
+    const success = await maniCalc.initialize();
+
+    if (success) {
+        console.log(chalk.green('\n✓ Installation complete!'));
+        console.log(chalk.yellow('\n📝 Usage:'));
+        console.log(chalk.gray('   Type in Windows Search: calc: 2 + 3 * 5'));
+        console.log(chalk.gray('   Or use CLI: mani-calc "10 km to miles"'));
+        console.log(chalk.gray('   Interactive mode: mani-calc\n'));
+    } else {
+        console.log(chalk.red('\n✗ Installation failed. Please try running as administrator.\n'));
+        process.exit(1);
+    }
+}
+
+async function uninstallService() {
+    console.log(chalk.cyan('\n🔧 Uninstalling Mani-Calc...\n'));
+
+    await maniCalc.shutdown();
+
+    console.log(chalk.green('✓ Uninstallation complete!\n'));
+}
+
+function displayHelp() {
+    const pkg = require('../package.json');
+
+    console.log(chalk.cyan.bold(`\n📊 Mani-Calc v${pkg.version}`));
+    console.log(chalk.gray('Instant calculations from Windows Search\n'));
+
+    console.log(chalk.yellow('Usage:'));
+    console.log('  mani-calc [query]              Calculate expression');
+    console.log('  mani-calc install              Install Windows Search integration');
+    console.log('  mani-calc uninstall            Uninstall integration');
+    console.log('  mani-calc                      Start interactive mode\n');
+
+    console.log(chalk.yellow('Examples:'));
+    console.log(chalk.gray('  Math:'));
+    console.log('    mani-calc "2 + 3 * 5"');
+    console.log('    mani-calc "sqrt(49)"');
+    console.log('    mani-calc "(10 + 20) / 5"\n');
+
+    console.log(chalk.gray('  Natural Language:'));
+    console.log('    mani-calc "what is 25 percent of 200"');
+    console.log('    mani-calc "half of 80"');
+    console.log('    mani-calc "square root of 64"\n');
+
+    console.log(chalk.gray('  Unit Conversions:'));
+    console.log('    mani-calc "10 km to miles"');
+    console.log('    mani-calc "5 kg to pounds"');
+    console.log('    mani-calc "100 celsius to fahrenheit"\n');
+
+    console.log(chalk.gray('  Special Commands:'));
+    console.log('    mani-calc history');
+    console.log('    mani-calc "clear history"\n');
+
+    console.log(chalk.yellow('Windows Search:'));
+    console.log(chalk.gray('  After installation, type in Windows Search:'));
+    console.log(chalk.gray('  calc: 2 + 3 * 5\n'));
+}
+
+function displayResult(result) {
+    if (result.type === 'error') {
+        console.log(chalk.red(`\n✗ ${result.formatted}\n`));
+        return;
+    }
+
+    if (result.type === 'history') {
+        console.log(chalk.cyan(`\n${result.formatted}\n`));
+        return;
+    }
+
+    if (result.type === 'info') {
+        console.log(chalk.blue(`\n${result.result}\n`));
+        return;
+    }
+
+    console.log(chalk.green(`\n✓ ${result.formatted}`));
+    console.log(chalk.gray('  (Result copied to clipboard)\n'));
+}
+
+async function startInteractiveMode() {
+    console.log(chalk.cyan.bold('\n📊 Mani-Calc Interactive Mode'));
+    console.log(chalk.gray('Type your calculations or "help" for examples. Press Ctrl+C to exit.\n'));
+
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: chalk.yellow('calc> ')
+    });
+
+    rl.prompt();
+
+    rl.on('line', async (line) => {
+        const query = line.trim();
+
+        if (!query) {
+            rl.prompt();
+            return;
+        }
+
+        if (query === 'exit' || query === 'quit') {
+            console.log(chalk.cyan('\n👋 Goodbye!\n'));
+            process.exit(0);
+        }
+
+        if (query === 'help') {
+            displayHelp();
+            rl.prompt();
+            return;
+        }
+
+        if (query === 'clear') {
+            console.clear();
+            rl.prompt();
+            return;
+        }
+
+        const result = await maniCalc.processQuery(query);
+        displayResult(result);
+
+        rl.prompt();
+    });
+
+    rl.on('close', () => {
+        console.log(chalk.cyan('\n👋 Goodbye!\n'));
+        process.exit(0);
+    });
+}
+
+// Handle errors gracefully
+process.on('uncaughtException', (error) => {
+    console.error(chalk.red('\n✗ Error:'), error.message);
+    process.exit(1);
+});
+
+process.on('unhandledRejection', (error) => {
+    console.error(chalk.red('\n✗ Error:'), error.message);
+    process.exit(1);
+});
+
+main().catch((error) => {
+    console.error(chalk.red('\n✗ Error:'), error.message);
+    process.exit(1);
+});

package/bin/overlay.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+const { app } = require('electron');
+const ManiCalc = require('../src/index');
+const FloatingSearchBox = require('../src/ui/floating-search');
+const chalk = require('chalk');
+
+let maniCalc;
+let floatingSearch;
+
+async function startOverlayMode() {
+    console.log(chalk.cyan('\n🚀 Starting Mani-Calc Overlay Mode...\n'));
+
+    // Initialize ManiCalc
+    maniCalc = new ManiCalc();
+
+    // Initialize Floating Search Box
+    floatingSearch = new FloatingSearchBox(maniCalc);
+    await floatingSearch.initialize();
+
+    console.log(chalk.green('✓ Mani-Calc Overlay is running!'));
+    console.log(chalk.yellow('\n📝 Press Alt+Space to toggle the search box'));
+    console.log(chalk.gray('   Press Ctrl+C to exit\n'));
+}
+
+// Handle app ready
+app.on('ready', startOverlayMode);
+
+// Prevent app from quitting when all windows are closed
+app.on('window-all-closed', (e) => {
+    e.preventDefault();
+});
+
+// Handle app quit
+app.on('will-quit', () => {
+    if (floatingSearch) {
+        floatingSearch.destroy();
+    }
+});
+
+// Handle Ctrl+C
+process.on('SIGINT', () => {
+    console.log(chalk.cyan('\n\n👋 Shutting down Mani-Calc Overlay...\n'));
+    app.quit();
+    process.exit(0);
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "mani-calc",
+  "version": "1.1.0",
+  "description": "Spotlight-style instant calculator for Windows Search | Math, natural language & unit conversions | Offline-first productivity tool",
+  "main": "src/index.js",
+  "bin": {
+    "mani-calc": "./bin/cli.js",
+    "mani-calc-overlay": "./bin/overlay.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "overlay": "electron bin/overlay.js",
+    "install-service": "node scripts/install-service.js",
+    "uninstall-service": "node scripts/uninstall-service.js",
+    "test": "node test/test.js"
+  },
+  "keywords": [
+    "calculator",
+    "windows",
+    "search",
+    "math",
+    "productivity",
+    "spotlight",
+    "instant-calculation",
+    "unit-conversion"
+  ],
+  "author": "Manideep Reddy Eevuri",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "win32"
+  ],
+  "dependencies": {
+    "mathjs": "^12.2.1",
+    "node-windows": "^1.0.0-beta.8",
+    "clipboardy": "^3.0.0",
+    "chalk": "^4.1.2",
+    "electron": "^28.1.0"
+  },
+  "devDependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/manireddy/mani-calc"
+  }
+}

package/src/core/clipboard-manager.js

@@ -0,0 +1,40 @@
+const clipboardy = require('clipboardy');
+
+class ClipboardManager {
+    constructor() {
+        this.autoCopy = true;
+    }
+
+    async copy(text) {
+        if (!this.autoCopy) {
+            return false;
+        }
+
+        try {
+            await clipboardy.write(String(text));
+            return true;
+        } catch (error) {
+            console.error('Failed to copy to clipboard:', error);
+            return false;
+        }
+    }
+
+    async read() {
+        try {
+            return await clipboardy.read();
+        } catch (error) {
+            console.error('Failed to read from clipboard:', error);
+            return null;
+        }
+    }
+
+    setAutoCopy(enabled) {
+        this.autoCopy = enabled;
+    }
+
+    isAutoCopyEnabled() {
+        return this.autoCopy;
+    }
+}
+
+module.exports = ClipboardManager;