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." ✨