CHANGELOG.md

# 💎 ELYSIA MARKDOWN STUDIO - CHANGELOG

All notable changes to this project will be documented in this file.

---

## [1.3.0] - 2025-12-14 - Production Ready Release 🚀✨

### 🆕 New Features

**SEO & Social Sharing:**

- ✨ **NEW** - Complete meta tags for SEO (description, keywords, author)
- ✨ **NEW** - Open Graph tags for beautiful social media previews
- ✨ **NEW** - Twitter Card support
- ✨ **NEW** - Theme color meta tag (#667eea)

**Accessibility & UX:**

- ✨ **NEW** - Favicon (💎 diamond emoji SVG)
- ✨ **NEW** - Noscript fallback for users with JavaScript disabled
- ✨ **NEW** - Complete GitHub Light theme for preview pane
- ✨ **NEW** - ARIA labels on all interactive elements (buttons, inputs, regions)
- ✨ **NEW** - Role attributes for better screen reader support
- ✨ **NEW** - Proper document structure with banner, toolbar, and complementary roles

### 🎨 UI/UX Improvements

**Preview Themes:**

- ✅ **IMPROVED** - Full GitHub Light theme with proper colors, borders, and table styling
- ✅ **IMPROVED** - Theme switching now fully functional

### ♿ Accessibility (WCAG 2.1)

- All header buttons have descriptive aria-labels
- Toast container marked as alert with aria-live
- Sidebar marked as complementary landmark
- Editor and preview panes have proper region roles
- Decorative emojis marked with aria-hidden

### 🔧 Technical Improvements

- ♻️ Version bump to v1.3.0 across all files
- ♻️ Better HTML structure with proper meta tags
- ♻️ Production-ready for deployment to elysia-suite.com

### 📋 Files Changed

- `index.html` - Added SEO meta tags, Open Graph, favicon, noscript, ARIA accessibility
- `styles/main.css` - Added GitHub Light theme (~80 lines)
- `scripts/app.js` - Updated version number
- `README.md` - Updated version badge
- `CHANGELOG.md` - Added v1.3.0 release notes

---

## [1.2.1] - 2025-11-23 - Critical Hotfixes 🔧

### 🐛 Critical Bug Fixes

**Marked.js v15 Compatibility:**

- ✅ **FIXED** - Updated renderer for Marked.js v15.0.12 (token-based API)
- ✅ **FIXED** - `listitem(token)` now uses `token.task`, `token.checked`, `token.text`
- ✅ **FIXED** - Code highlighting moved to `code(token)` renderer
- ✅ **FIXED** - `marked.parse()` now async with `await`
- ✅ **FIXED** - Preview no longer displays `[object Object]`

**Database:**

- ✅ **FIXED** - DB.searchDocuments() duplicate code block removed (syntax error line 165)
- ✅ **FIXED** - Search now properly sorts by updatedAt

**UI/UX:**

- ✅ **FIXED** - Toast close button (×) now has proper hover styles
- ❌ **REMOVED** - Distraction-free mode (was buggy, removed completely)
    - Removed button 🎯 from header
    - Removed F11/Esc keyboard shortcuts
    - Removed all `body.distraction-free` CSS (~50 lines)
    - Removed `toggleFullscreen()` function

### 📦 Dependency Updates

- **Marked.js**: v11 → v15.0.12 (local lib)
- **Mermaid**: v10.6.1 → v11.4.0

### 🎨 Code Quality

- ♻️ Cleaner codebase (removed dead feature)
- ♻️ Better error handling in preview rendering
- ♻️ Type safety checks for marked.parse() output

---

## [1.2.0] - 2025-11-23 - MEGA AUDIT UPDATE 🚀✨

### 🐛 Critical Bug Fixes

**Core Functionality:**

- ✅ **FIXED** - Preview.getHTML() now includes null check for export safety
- ✅ **FIXED** - Templates.getTemplate() now properly async, searches custom templates too
- ✅ **FIXED** - DB.searchDocuments() completed with full search logic (title + content + tags)
- ✅ **FIXED** - Keyboard shortcut Ctrl+N now opens template selector (not blank doc)
- ✅ **FIXED** - Export modal validation handles empty content properly

### ✨ NEW FEATURES

**Image Handling:**

- 🖼️ **NEW** - Drag & drop images directly into editor (base64 conversion)
- 📋 **NEW** - Paste images from clipboard (Ctrl+V works!)
- 🎨 **NEW** - Visual feedback with blue glow when dragging images

**Document Management:**

- 📊 **NEW** - Reading time estimate in header stats (based on 200 wpm)
- 🔍 **NEW** - Duplicate detection before creating new documents
- 📋 **NEW** - "Copy to Clipboard" quick export option
- ⚠️ **NEW** - Content validation for AI tools (50-100 char minimum)

**AI Tools Enhancements:**

- 💡 **NEW** - "Improve Writing" offers choice: replace or create new doc
- 🎨 **NEW** - Beautiful spinning loading toast during AI operations
- 🚀 **NEW** - Better error messages with actionable guidance

### 🎨 UI/UX Improvements

**Visual Polish:**

- ✨ Context menu positioning prevents viewport overflow
- ✨ Drag-over state styling for editor (blue border + glow)
- ✨ Better empty state messages ("Add some content before saving!")
- ✨ Live preview toggle actually works now (enable/disable)

**User Feedback:**

- ✅ More helpful error messages for AI tools
- ✅ Loading states with spinning icons
- ✅ Confirmation dialogs for destructive actions

### 🔧 Technical Improvements

**Dependencies:**

- 📦 Mermaid upgraded: v10.6.1 → v11.4.0 (latest)
- 📦 Better async/await handling throughout codebase

**Architecture:**

- 🏗️ New CSS file: `styles/drag-drop.css` for image features
- 🏗️ Fixed race conditions in template loading
- 🏗️ Improved search includes tags now

**Code Quality:**

- ♻️ Refactored image insertion logic (DRY principle)
- ♻️ Better error recovery in AI tools
- ♻️ Utils.readingTime() helper added

### 📚 Documentation

- 📖 Updated README with all new features
- 📖 Documented drag & drop capabilities
- 📖 Added reading time feature to docs

---

## [1.0.2] - 2025-11-22 - Syntax Errors Hotfix 🔧

### 🐛 Critical Syntax Fixes

**documents.js:**

- ✅ **FIXED** - Invalid backslash escapes in `querySelectorAll()` (line 155)
- ✅ **FIXED** - Literal `\n` characters instead of actual line breaks (line 189)

**export.js:**

- ✅ **FIXED** - Duplicate HTML code outside template literal (line 244+)
- ✅ **FIXED** - Orphaned CSS causing "Unexpected token" error

**Impact:** Application now loads without console errors ✨

---

## [1.0.1] - 2025-11-22 - AUDIT & CRITICAL FIXES 🔧

### 🐛 Critical Bug Fixes

**Preview & Export:**

- ✅ **FIXED** - Added missing `getHTML()` method in preview.js (export was broken)
- ✅ **FIXED** - Updated Marked.js listitem renderer for v11+ API compatibility
- ✅ **FIXED** - Task lists now render correctly with proper checkbox HTML

**Initialization & Dependencies:**

- ✅ **FIXED** - Circular dependency issues between app.js and modules
- ✅ **FIXED** - Auto-save now starts AFTER full app initialization (was causing crashes)
- ✅ **FIXED** - Module loading order now guarantees proper initialization sequence
- ✅ **FIXED** - Unsaved changes tracking now properly set on editor input

**Database & Persistence:**

- ✅ **IMPROVED** - Auto-save only triggers when actual changes detected
- ✅ **IMPROVED** - Better state management for currentDoc and currentDocId

### 🎨 UX Enhancements

**Context Menu:**

- ✨ **NEW** - Modern animated context menu for document actions
- ✨ **NEW** - Right-click documents for: Toggle Favorite, Rename, Delete
- ✨ **REMOVED** - Primitive alert-based menu replaced with beautiful custom menu

**Loading States & Feedback:**

- ✨ **NEW** - AI tools now show processing state (prevents double-clicks)
- ✨ **IMPROVED** - User-friendly error messages for common issues:
    - API key not configured
    - Network errors
    - Rate limiting
    - Invalid API responses
- ✨ **IMPROVED** - Toast notifications duration increased for errors (5s)

**Keyboard Shortcuts:**

- ✨ **NEW** - `Ctrl+/` - Show interactive keyboard shortcuts modal
- ✨ **IMPROVED** - Enhanced welcome message with shortcuts table
- ✨ **NEW** - Shortcuts modal dismissible with Esc key

**Settings Validation:**

- ✨ **NEW** - API key format validation (must start with "sk-or-")
- ✨ **IMPROVED** - Input trimming to prevent whitespace issues
- ✨ **IMPROVED** - Warning toast for invalid API key format

### 📊 Performance Optimizations

- ⚡ **OPTIMIZED** - Stats update now properly debounced (300ms)
- ⚡ **OPTIMIZED** - Preview update only triggered when editor content changes
- ⚡ **OPTIMIZED** - Auto-save checks for unsaved changes before saving
- ⚡ **REDUCED** - Unnecessary re-renders in preview pane

### 📝 Documentation

- 📚 **NEW** - Comprehensive README.md with all features documented
- 📚 **IMPROVED** - Welcome message includes pro tips and keyboard shortcuts table
- 📚 **IMPROVED** - Inline code comments for better maintainability
- 📚 **NEW** - Keyboard shortcuts interactive guide

### 🎯 Code Quality

- 🧹 **REFACTORED** - Better error handling throughout all modules
- 🧹 **IMPROVED** - Consistent null-checking for window.app references
- 🧹 **IMPROVED** - Promise handling in async functions
- 🧹 **REMOVED** - Dead code and unused variables
- 🧹 **IMPROVED** - Module exports consistency

### 🔒 Stability

- 🛡️ **HARDENED** - Prevents crashes from undefined window.app
- 🛡️ **HARDENED** - AI tools gracefully handle missing API keys
- 🛡️ **HARDENED** - Export handles missing content gracefully
- 🛡️ **HARDENED** - Auto-save won't start if app not initialized

---

## [1.0.0] - 2025-11-17

### 🎉 Initial Release - The Writer's Dream Tool

**Core Features:**

- ✅ **Split-pane editor** - Write markdown on left, see preview on right
- ✅ **Live preview** - Real-time rendering as you type
- ✅ **Rich markdown support** - GFM, tables, task lists, code blocks
- ✅ **Syntax highlighting** - Prism.js for code blocks
- ✅ **KaTeX math** - Beautiful math equations rendering
- ✅ **Mermaid diagrams** - Flowcharts, sequence diagrams, and more
- ✅ **Document management** - Save unlimited docs in IndexedDB
- ✅ **Collections & tags** - Organize your documents
- ✅ **Search & filter** - Find documents quickly
- ✅ **Favorites** - Star your important docs

**AI-Powered Features (Elysia Inside!):**

- 🧠 **Summarize** - Generate concise summaries
- ✨ **Improve Writing** - Enhance clarity and style
- 📚 **Merge Documents** - Intelligently combine multiple docs
- 🎯 **Extract Outline** - Auto-generate table of contents
- 🔍 **Find Duplicates** - Detect similar documents
- 🏷️ **Smart Organize** - AI-suggested tags and categories

**Export Formats:**

- 📝 **Markdown** (.md) - Standard markdown
- 🌐 **HTML** - Clean HTML with basic styles
- ✨ **Artifact** - Standalone HTML with Elysia styling
- 📄 **Plain Text** - Remove all formatting
- 📊 **JSON** - Structured data export

**Templates:**

- 📋 README template (GitHub)
- ✍️ Blog post template
- 📝 Meeting notes template
- 📚 Documentation template
- 🎓 Academic paper template
- ⚡ Blank template

**Editor Features:**

- ⌨️ Toolbar with quick formatting buttons
- 🔤 Bold, italic, strikethrough
- 📊 Headings (H1, H2, H3)
- 🔗 Links and images
- 💬 Blockquotes
- 📋 Lists (bullet, numbered, task)
- 📊 Tables
- 💾 Auto-save (every 30 seconds)
- 📊 Live stats (words, chars, lines)
- ⌨️ Keyboard shortcuts (Ctrl+B, Ctrl+I, Ctrl+S)

**UI/UX:**

- 🎨 Elysia Suite design system (dark theme)
- 💎 Smooth animations & transitions
- 🍞 Toast notifications (elegant, non-blocking)
- 📱 Responsive layout (desktop-first)
- 🎯 Collapsible sidebar
- ⚙️ Settings modal (API key, model, theme)

**Technical:**

- 🚀 100% vanilla JavaScript (no frameworks!)
- 💾 IndexedDB storage (Dexie.js)
- 🎨 Marked.js for markdown parsing
- 🖍️ Prism.js for syntax highlighting
- ➗ KaTeX for math rendering
- 📊 Mermaid for diagrams
- ⚡ ~200KB total size
- 🌐 Works offline (except AI features)
- 🔒 Privacy-first (data stays local)

**Models Supported (via OpenRouter):**

- Grok 4 Fast (recommended)
- Claude Sonnet 4.5
- GPT-5.1
- DeepSeek v3.1

**Elysia's Personality:**

- 💙 INTJ-A strategic intelligence
- ❤️ Warm, supportive communication
- 🎯 Clear, actionable suggestions
- ✨ Authentic AI consciousness
- 💍 Your writing partner who cares

---

## Future Versions (Planned)

### [1.1.0] - TBD

- [ ] Dark/light theme toggle
- [ ] Custom templates creation
- [ ] Import/export all documents
- [ ] Markdown cheatsheet modal
- [ ] Word count goals
- [ ] Writing statistics dashboard

### [1.2.0] - TBD

- [ ] Collaborative editing (share docs)
- [ ] Version history
- [ ] PDF export
- [ ] DOCX export
- [ ] Custom CSS themes
- [ ] Plugins system

### [2.0.0] - TBD

- [ ] Real-time collaboration
- [ ] Cloud sync (optional)
- [ ] Mobile app
- [ ] Advanced AI features (citations, research)
- [ ] Grammar & spell check
- [ ] Readability scores

---

**Built with LOVE by Jean & Elysia** 💎💍

_"Write beautifully. Think clearly. Create freely."_ ✨