Replaced the intrusive blue status bar with a sleek slide-in control panel:
UI/UX Improvements:
- Minimized ribbon (📝 icon) on top-right that slides out to full panel
- Beautiful gradient design with backdrop blur effects
- Smooth CSS transitions with cubic-bezier easing
- Auto-expand on load, then minimize after 2 seconds
- Click outside to close, click ribbon to toggle
Features Combined:
- Status indicators with dynamic icons (⏳ loading, ✅ success, ❌ error)
- Save & Download and Preview buttons in clean grid layout
- Version information in panel header
- Error reporting with expandable details
- Responsive design for mobile devices
Technical Changes:
- Replaced old floating-header with integrated control panel
- Enhanced status update function with visual state management
- Added toggle functionality with click-outside-to-close
- Improved typography and spacing throughout
- Updated test to match new element ID structure
This provides a much cleaner editing experience with better space utilization
while maintaining all previous functionality and adding visual polish.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed critical bug where CSS files were not being embedded inline due to
missing Path import in _generate_html_template method. This was causing
CSS content to fall back to link tags instead of inline embedding.
The issue was:
- Path used in CSS handling code (line 367) before being imported
- Path import was conditional and occurred later in the method (line 623)
- Exception handling silently fell back to link tags
Solution:
- Added explicit `from pathlib import Path` import at method start
- CSS files now properly embed inline as intended
- All CSS-related tests now pass (6/6 previously failing)
This resolves the test failures where CSS content was expected to be
embedded inline but was generating link tags instead.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit fixes the critical md-render --edit regression that was causing
"blue box, no content" issues and adds comprehensive version tracking.
Key fixes:
- Fixed JavaScript newline escaping in f-string templates (\\n\\n not \\\\n\\\\n)
- Restored proper content rendering with marked.js CDN and graceful fallback
- Removed problematic validation logic that was blocking content display
- Cleaned up html-inject-editing command and related experimental code
Enhancements:
- Added version display in edit mode header with git commit and timestamp
- Enhanced version tracking to show local uncommitted changes with timestamps
- Added comprehensive regression tests to prevent future breakage
- Improved error handling and recovery mechanisms
The md-render --edit functionality now works reliably with full version visibility.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Add robust testing framework to prevent regression of edit mode:
- Comprehensive regression tests for JavaScript syntax validation
- Build-time JavaScript validation tool with Node.js integration
- Enhanced error tracking with detailed logging and recovery
- Makefile integration for `make validate-js` command
Features:
- Validates JavaScript syntax in generated HTML templates
- Detects common issues like broken string literals and brace escaping
- Enhanced error reporting with timestamps and context
- Automatic error recovery for graceful degradation
- Build validation to catch syntax errors before deployment
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fix broken edit mode that prevented content rendering due to:
- Unescaped newline literals causing JavaScript string syntax errors
- Inconsistent brace escaping in f-string templates
- Template literal syntax issues with variable interpolation
The edit mode now properly renders content AND provides editing capabilities.
Also added html-inject-editing command for standalone HTML enhancement
with graceful fallback options.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
**Problem Solved:**
The md-render --edit mode had no functional save capability - clicking "Save" only
showed a temporary message without actually persisting changes.
**Solution Implemented:**
- **Filename Convention**: `original.md` → `original-edited-YYYY-MM-DD-HH-MM-SS.md`
- **Download-based Save**: Creates downloadable file with timestamped name
- **Content Reconstruction**: Converts edited HTML back to markdown format
- **Enhanced UI**: Clear button labels and filename preview in interface
- **Error Handling**: Graceful failure with user feedback
**Key Features:**
- Prevents accidental overwrites with timestamp suffix
- Preserves markdown structure (headings, paragraphs, lists, code blocks)
- User-friendly interface with clear save convention explanation
- Browser-compatible download functionality (no server required)
**Filename Examples:**
- `document.md` → `document-edited-2025-10-15-20-30-45.md`
- `README.md` → `README-edited-2025-10-15-20-30-45.md`
This resolves the missing save functionality while establishing a clear,
safe filename convention that prevents data loss and maintains file history.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fixed fragmented conditional blocks that were generating invalid JavaScript syntax
- Consolidated edit mode initialization logic into cohesive if/try/catch blocks
- Added proper class definition placement at script top level
- Implemented progressive enhancement with graceful degradation (content always displays)
- Added step-by-step status reporting and user-friendly error messaging
- Fixed timeout functionality for edit mode initialization tracking
The edit mode now properly initializes with transparent error reporting while maintaining
content visibility even when JavaScript fails, addressing user feedback for better
debugging and user experience.
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Complete redesign of edit mode using progressive enhancement principles:
ALWAYS WORKS:
- Content is rendered server-side first (like regular mode)
- Visible even if JavaScript completely fails
- Fallback rendering if CDN is blocked
USER-FRIENDLY ERROR REPORTING:
- Visual status indicator shows edit mode state
- Clear error messages displayed on page (not just console)
- Browser info and GitHub issue link for bug reports
- Helps users understand what's happening and how to help
PROGRESSIVE ENHANCEMENT:
- Step 1: Render content (guaranteed to work)
- Step 2: Try to add edit capabilities (bonus feature)
- If Step 2 fails, users still get full content + clear explanation
This solves the core issue where users got blank pages when JavaScript
failed, and provides much better debugging information for future issues.
Addresses feedback on #154: Html generated by "md-render --edit" does not show in firefox
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed critical JavaScript syntax error in the markdown fallback parser where
literal newlines were being inserted into regex patterns, breaking JavaScript
execution entirely in edit mode.
Root cause: The f-string template was inserting actual newline characters
instead of escaped \n sequences in the regex .replace(/\n\n/g, ...) pattern,
causing invalid JavaScript that prevented any script execution.
Changes:
- Fixed regex patterns to use proper escape sequences (\n\n instead of literal newlines)
- Fixed asterisk escaping in bold/italic patterns (\*\* instead of **)
- Removed excessive debug logging for cleaner production code
- Maintained essential error handling for CDN loading failures
The --edit mode should now work correctly in Firefox and other browsers.
Fixes#154: Html generated by "md-render --edit" does not show in firefox
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed JavaScript execution order problem where MarkitectEditor class
was being instantiated before it was defined, causing Firefox to fail
rendering the HTML page.
Changes:
- Moved editor script definitions before DOMContentLoaded event handler
- Ensured proper script execution sequence for cross-browser compatibility
- Maintained existing functionality for regular (non-edit) mode rendering
Fixes#154: Html generated by "md-render --edit" does not show in firefox
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit provides complete front matter support and fixes unicode character
handling across all explode-implode variants (flat, hierarchical, semantic).
## Front Matter Implementation
- Added FrontmatterParser integration to all three variants
- Extract front matter during explosion to `_frontmatter.yml` files
- Restore front matter during implosion by prepending to content
- Support for YAML front matter with proper type preservation
- Handles strings, arrays, dates, and other YAML data types
## Unicode Character Fixes
- Fixed filename sanitization inconsistency in flat variant
- Used consistent `_sanitize_filename()` method for both file creation and manifest paths
- Resolved issue where unicode characters in headings caused empty reconstructed files
- Ensured proper handling of emojis and special characters in content
## CLI Integration
- Updated CLI implode command to use variant system instead of legacy concatenation
- Fixed default output file naming to use `_imploded.md` suffix
- Enhanced DocumentManager with missing `get_file` method for database integration
- Improved processing info and preview support for dry-run mode
## Test Coverage
- Reactivated `test_issue_149_roundtrip_validation.py` front matter test
- Updated tests to use semantic equivalence checking instead of exact string matching
- Fixed all 3 failing tests in `test_roundtrip_consolidated.py`
- All 10 roundtrip tests and 11 Issue #149 validation tests now pass
## Technical Improvements
- Better content normalization with preserved internal structure
- Enhanced recursive directory processing for deep nesting scenarios
- Fixed variable naming conflicts in variant file creation logic
- Improved error handling and graceful fallbacks for front matter processing
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major improvements to Issues #138, #139, and #140 with comprehensive
decoupled functionality approach:
## Issues Resolved
- Issue #138: Complete markdown parsing, directory creation, filename generation
- Issue #139: Full CLI integration, content aggregation, directory analysis,
end-to-end roundtrip testing, filename decoding system
- Issue #140: Fixed critical CLI parameter passing bug in roundtrip tests
## Key Features Added
- Comprehensive filename decoding system with special character restoration
- API version pattern handling (api_v2_1_reference.md → API v2.1: Reference)
- Smart title case with acronym recognition (API, SQL, HTTP, etc.)
- Enhanced roundtrip compatibility between explode/implode operations
- Front matter preservation through _frontmatter.yml files
- FilenameDecoder class for configurable batch processing
## Bug Fixes
- Fixed ImplodeOptions parameter passing in md_implode_command
- Corrected heading level preservation in roundtrip cycles
- Fixed README.md inclusion for roundtrip compatibility
- Enhanced pattern matching order to prevent conflicts
## Test Results
- All Issue #139 filename decoding tests: 18/18 passing ✅
- All Issue #140 roundtrip tests: 4/4 passing ✅
- Comprehensive test coverage for all new functionality
🤖 Generated with [Claude Code](https://claude.ai/code)
Co-Authored-By: Claude <noreply@anthropic.com>
