mani-calc 1.2.2 → 2.1.1

package/OVERLAY_MODE.md

@@ -1,364 +0,0 @@
-# 🎨 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 |
-|---------|--------|
-| `help` | Show available commands |
-| `theme` | Toggle Light/Dark mode |
-| `quit` | Quit application |
-| `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!** ⚡

package/PUBLISHING_GUIDE.md

@@ -1,291 +0,0 @@
-# 📦 Publishing Mani-Calc to NPM
-
-## ✅ Pre-Publishing Checklist
-
-Before publishing, let's make sure everything is ready:
-
-- [x] Package name: `mani-calc` (unique and available)
-- [x] Version: `1.1.0`
-- [x] All files committed to Git
-- [x] README.md is comprehensive
-- [x] LICENSE file exists (MIT)
-- [x] package.json is properly configured
-- [x] Tests are passing
-- [x] Dependencies are installed
-
----
-
-## 🚀 Step-by-Step Publishing Guide
-
-### Step 1: Create NPM Account (if you don't have one)
-
-Visit: https://www.npmjs.com/signup
-
-Or use the command line:
-```bash
-npm adduser
-```
-
-### Step 2: Login to NPM
-
-```bash
-npm login
-```
-
-You'll be prompted for:
-- **Username**: Your npm username
-- **Password**: Your npm password
-- **Email**: Your email (will be public)
-- **One-time password**: If you have 2FA enabled
-
-### Step 3: Verify Login
-
-```bash
-npm whoami
-```
-
-This should display your npm username.
-
-### Step 4: Test Package Locally (Optional but Recommended)
-
-```bash
-# Create a tarball to see what will be published
-npm pack
-
-# This creates mani-calc-1.1.0.tgz
-# You can inspect it to see what files will be included
-```
-
-### Step 5: Publish to NPM
-
-```bash
-npm publish
-```
-
-**That's it!** 🎉
-
----
-
-## 📋 What Gets Published
-
-Based on your `.gitignore` and `package.json`, these files will be published:
-
-### ✅ Included
-- `bin/` - CLI scripts
-- `src/` - Source code
-- `test/` - Tests
-- `README.md` - Documentation
-- `LICENSE` - MIT License
-- `CHANGELOG.md` - Version history
-- `QUICKSTART.md` - Quick start guide
-- `EXAMPLES.md` - Usage examples
-- `ARCHITECTURE.md` - Technical docs
-- `CONTRIBUTING.md` - Contribution guide
-- `OVERLAY_MODE.md` - Overlay mode docs
-- `package.json` - Package config
-
-### ❌ Excluded (via .gitignore)
-- `node_modules/` - Dependencies
-- `.vscode/` - Editor config
-- `*.log` - Log files
-- `.env` - Environment files
-
----
-
-## 🎯 After Publishing
-
-### 1. Verify Publication
-
-Visit: https://www.npmjs.com/package/mani-calc
-
-You should see your package!
-
-### 2. Test Installation
-
-```bash
-# In a different directory
-npm install -g mani-calc
-
-# Test it
-mani-calc "2 + 3 * 5"
-```
-
-### 3. Create GitHub Release
-
-1. Go to: https://github.com/Maniredii/mani-calc/releases
-2. Click "Create a new release"
-3. Tag: `v1.1.0`
-4. Title: `v1.1.0 - Overlay Mode Release`
-5. Description: Copy from `RELEASE_NOTES_v1.1.0.md`
-6. Publish release
-
-### 4. Update README Badge
-
-Your npm version badge will now work:
-```markdown
-[![npm version](https://img.shields.io/npm/v/mani-calc.svg)](https://www.npmjs.com/package/mani-calc)
-```
-
----
-
-## 🔄 Updating the Package (Future)
-
-When you want to publish updates:
-
-### 1. Update Version
-
-```bash
-# For bug fixes (1.1.0 → 1.1.1)
-npm version patch
-
-# For new features (1.1.0 → 1.2.0)
-npm version minor
-
-# For breaking changes (1.1.0 → 2.0.0)
-npm version major
-```
-
-This automatically:
-- Updates `package.json`
-- Creates a git commit
-- Creates a git tag
-
-### 2. Push Changes
-
-```bash
-git push origin main --tags
-```
-
-### 3. Publish
-
-```bash
-npm publish
-```
-
----
-
-## 🛠️ Troubleshooting
-
-### Error: "Package name already exists"
-
-If `mani-calc` is taken, you'll need to:
-1. Choose a different name (e.g., `@yourusername/mani-calc`)
-2. Update `package.json` name field
-3. Try publishing again
-
-### Error: "You must be logged in"
-
-```bash
-npm login
-```
-
-### Error: "You do not have permission"
-
-Make sure you're logged in as the correct user:
-```bash
-npm whoami
-```
-
-### Error: "Version already published"
-
-You can't republish the same version. Bump the version:
-```bash
-npm version patch
-npm publish
-```
-
----
-
-## 📊 NPM Package Stats
-
-After publishing, you can track:
-
-- **Downloads**: https://npm-stat.com/charts.html?package=mani-calc
-- **Package page**: https://www.npmjs.com/package/mani-calc
-- **Unpkg CDN**: https://unpkg.com/mani-calc/
-
----
-
-## 🎯 Marketing After Publishing
-
-### 1. Share on Social Media
-
-**Twitter/X:**
-```
-🎉 Just published mani-calc v1.1.0 to npm!
-
-⚡ Spotlight-style calculator for Windows
-🎨 NEW: Floating search box (Alt+Space)
-💻 System commands (sleep, lock, etc.)
-🔄 Unit conversions & natural language
-
-npm install -g mani-calc
-
-https://www.npmjs.com/package/mani-calc
-https://github.com/Maniredii/mani-calc
-```
-
-### 2. Post on Reddit
-
-Subreddits:
-- r/node
-- r/javascript
-- r/Windows
-- r/productivity
-- r/programming
-
-### 3. Submit to Product Hunt
-
-https://www.producthunt.com/posts/create
-
-### 4. Write a Blog Post
-
-Platforms:
-- Dev.to
-- Hashnode
-- Medium
-
-### 5. Create a Demo Video
-
-Record yourself using:
-- Windows Search integration
-- Overlay mode
-- System commands
-
-Upload to YouTube and link in README.
-
----
-
-## 📈 Success Metrics
-
-Track these after publishing:
-
-- **Week 1 Goal**: 100 downloads
-- **Month 1 Goal**: 500 downloads
-- **GitHub Stars**: 50+
-- **Issues/PRs**: Community engagement
-
----
-
-## 🎉 Ready to Publish!
-
-Your package is production-ready. Just run:
-
-```bash
-npm login
-npm publish
-```
-
-And you're live! 🚀
-
----
-
-## 📞 Need Help?
-
-- NPM Docs: https://docs.npmjs.com/
-- Publishing Guide: https://docs.npmjs.com/cli/v8/commands/npm-publish
-- Package Naming: https://docs.npmjs.com/cli/v8/configuring-npm/package-json#name
-
----
-
-**Good luck with your launch!** 🎊