release: Ferrite v0.2.1 - Mermaid diagram improvements

Sequence: control-flow blocks, activation boxes, notes

Flowchart: subgraphs, branching layout, back-edge routing

State: composite/nested states, advanced transitions

General: accurate text measurement, dynamic node sizing

Author: OlaProeis

.gitignore

@@ -43,6 +43,24 @@ desktop.ini
 *.pem
 *.key
 
+# AI agent configurations and instructions
+.mcp.json
+.rules
+opencode.json
+AGENT.md
+AGENTS.md
+CLAUDE.md
+GEMINI.md
+.clinerules/
+.gemini/
+.kilo/
+.kiro/
+.roo/
+.trae/
+.windsurf/
+.zed/
+.github/instructions/
+
 # Logs
 logs/
 *.log
@@ -81,3 +99,15 @@ temp/
 # Test artifacts
 *.test
 test-output/
+
+logs
+# Dependency directories
+# Environment variables
+# Editor directories and files
+.idea
+.vscode
+# OS specific
+
+# Task files
+# tasks.json
+# tasks/ 

CHANGELOG.md

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.1] - 2025-01-10
+
+### Added
+
+#### Mermaid Diagram Enhancements
+- **Sequence Diagram Control Blocks** - Full support for `loop`, `alt`, `opt`, `par`, `critical`, `break` blocks with proper nesting and colored labels
+- **Sequence Activation Boxes** - `activate`/`deactivate` commands and `+`/`-` shorthand on messages for lifeline activation tracking
+- **Sequence Notes** - `Note left/right/over` syntax with dog-ear corner rendering
+- **Flowchart Subgraphs** - Nested `subgraph`/`end` blocks with semi-transparent backgrounds and direction overrides
+- **Composite/Nested States** - State diagrams now support `state Parent { ... }` syntax with recursive nesting
+- **Advanced State Transitions** - Color-coded transitions, smart anchor points, and cross-nesting-level edge routing
+
+#### Layout Improvements
+- **Flowchart Branching** - Sugiyama-style layered graph layout with proper side-by-side branch placement
+- **Cycle Detection** - Back-edges rendered with smooth bezier curves instead of crossing lines
+- **Smart Edge Routing** - Decision node edges exit from different points to prevent crossing
+- **Edge Declaration Order** - Branch ordering now matches Mermaid's convention (later-declared edges go left)
+
+### Fixed
+- **Text Measurement** - Replaced character-count estimation with egui font metrics for accurate node sizing
+- **Node Overflow** - Nodes dynamically resize to fit their labels without clipping
+- **Edge Labels** - Long labels truncate with ellipsis instead of overflowing
+- **User Journey Icons** - Fixed unsupported emoji rendering with text fallbacks
+
+### Technical
+- Extended `mermaid.rs` from ~4000 to ~6000+ lines
+- Added technical documentation for all new features in `docs/technical/`
+
 ## [0.2.0] - 2025-01-09
 
 ### Added
@@ -114,9 +142,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## Version History
 
+- **0.2.1** - Mermaid diagram improvements (control blocks, subgraphs, nested states, improved layout)
 - **0.2.0** - Major feature release (Split View, Mermaid, Minimap, Git integration, and more)
 - **0.1.0** - Initial public release
 
-[Unreleased]: https://github.com/OlaProeis/Ferrite/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/OlaProeis/Ferrite/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/OlaProeis/Ferrite/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/OlaProeis/Ferrite/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/OlaProeis/Ferrite/releases/tag/v0.1.0

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "ferrite"
-version = "0.2.0"
+version = "0.2.1"
 edition = "2021"
 description = "A fast, lightweight text editor for Markdown, JSON, and more"
 repository = "https://github.com/OlaProeis/Ferrite"

Cargo.toml

@@ -44,7 +44,7 @@ Native rendering of 11 diagram types directly in the preview:
 - Flowchart, Sequence, Pie, State, Mindmap
 - Class, ER, Git Graph, Gantt, Timeline, User Journey
 
-> 📦 **v0.2.1 Coming Soon:** Enhanced Mermaid support with sequence control-flow blocks (`loop`, `alt`, `opt`, `par`), improved text sizing, flowchart subgraphs, and more. See [ROADMAP.md](ROADMAP.md) for details.
+> ✨ **v0.2.1 Released:** Enhanced Mermaid support with sequence control-flow blocks (`loop`, `alt`, `opt`, `par`), activation boxes, notes, flowchart subgraphs with branching layout, and composite/nested states. See [CHANGELOG.md](CHANGELOG.md) for full details.
 
 ### Workspace Features
 - **Workspace Mode** - Open folders with file tree, quick switcher (Ctrl+P), and search-in-files (Ctrl+Shift+F)

README.md

@@ -12,79 +12,96 @@ These issues cannot be fixed without replacing egui's built-in text editor:
 
 ## Planned Features 🚀
 
-### v0.2.1 (In Progress) - Mermaid Diagram Improvements
+### v0.3.0 (Planned) - Mermaid Crate + Editor Improvements
 
-> **Status:** Active development  
-> **Focus:** Polish and complete native Mermaid diagram rendering
+> **Status:** Planning  
+> **Docs:** [Mermaid Crate Plan](docs/mermaid-crate-plan.md) | [Custom Editor Plan](docs/technical/custom-editor-widget-plan.md) | [Modular Refactor Plan](docs/refactor.md)
 
-This patch release focuses on improving the native Mermaid diagram renderer added in v0.2.0:
+v0.3.0 focuses on extracting the Mermaid renderer as a standalone crate and continuing diagram improvements.
 
-#### Text & Layout Fixes
-- [x] **Accurate text measurement** - Replace character-count estimation with egui font metrics
-- [x] **Dynamic node sizing** - Nodes resize to fit their labels without clipping
-- [x] **Text overflow handling** - Edge labels truncate with ellipsis when too long
-- [x] **User Journey icons** - Fixed unsupported emoji rendering
+#### 1. Mermaid Crate Extraction
+Extract Ferrite's native Mermaid renderer (~6000 lines) into a standalone pure-Rust crate.
 
-#### Sequence Diagram Enhancements
-- [x] **Control-flow blocks** - Support for `loop`, `alt`, `opt`, `par` blocks with nesting
-- [ ] **Activation boxes** - `activate`/`deactivate` markers on lifelines
-- [ ] **Notes** - `Note left/right/over` syntax support
+- [ ] **Standalone crate** - Backend-agnostic architecture with SVG, PNG, and egui outputs
+- [ ] **Public API** - `parse()`, `layout()`, `render()` pipeline
+- [ ] **SVG export** - Generate valid SVG files from diagrams
+- [ ] **PNG export** - Rasterize via resvg
+- [ ] **WASM compatible** - SVG backend works in browsers
 
-#### Flowchart Improvements
-- [ ] **Proper branching layout** - Fix single-column rendering, implement multi-path layout
-- [ ] **Subgraph support** - Nested subgraphs with direction overrides
+#### 2. Mermaid Diagram Improvements
+Continue improving diagram rendering quality:
 
-#### State Diagram Enhancements
-- [ ] **Composite states** - Nested state machines
-- [ ] **Advanced transitions** - Fork/join, choice pseudostates
-
----
+##### Git Graph (Major Rewrite)
+- [ ] **Horizontal timeline layout** - Left-to-right commit flow like Mermaid
+- [ ] **Branch lanes** - Distinct horizontal lanes per branch with colored labels
+- [ ] **Merge visualization** - Curved paths connecting branches
+- [ ] **Tags and highlights** - Visual markers on commits
 
-### v0.3.0 (Planned) - Custom Editor + Modular Architecture
+##### Flowchart
+- [ ] **More node shapes** - Parallelogram, trapezoid, double-circle, etc.
+- [ ] **Styling syntax** - `style` and `classDef` directives
 
-> **Status:** Collecting v0.2.0 feedback before implementation  
-> **Docs:** [Custom Editor Plan](docs/technical/custom-editor-widget-plan.md) | [Modular Refactor Plan](docs/refactor.md)
+##### State Diagram
+- [ ] **Fork/join pseudostates** - Parallel regions
+- [ ] **History states** - Shallow (H) and deep (H*) history
 
-v0.3.0 is a foundational release with two major architectural changes:
-
-#### 1. Custom Editor Widget
+#### 3. Custom Editor Widget (Stretch Goal)
 Replace egui's `TextEdit` with a custom `FerriteEditor` widget to unblock advanced editing features.
 
 - [ ] **FerriteEditor widget** - Custom text editor using egui drawing primitives
 - [ ] **Rope-based buffer** - Efficient text storage via `ropey` crate
-- [ ] **Full input handling** - Direct keyboard/mouse event processing
 - [ ] **Full multi-cursor editing** - Text operations at all cursor positions
 - [ ] **Code folding with text hiding** - Actually collapse regions visually
-- [ ] **Perfect scroll sync** - Direct line-to-pixel mapping access
-
-#### 2. Modular Architecture Refactor
-Transform Ferrite from monolithic to "Core + Features" using Rust's compile-time feature flags.
-
-- [ ] **Feature-gated dependencies** - `markdown`, `json`, `yaml`, `syntax_highlighting`, `git` as optional
-- [ ] **DocumentView enum** - Type-safe file handling with `#[cfg(feature)]` variants
-- [ ] **Feature switchboard** - Central file-type detection with graceful fallback to plain text
-- [ ] **Directory restructure** - Move specialized code to `src/features/` module
-
-**Benefits:**
-- Compile minimal builds (`cargo build --no-default-features`)
-- Faster dev cycles (disable unused features)
-- Smaller binaries for users who don't need all formats
-- Future WASM compatibility
 
-#### Additional v0.3.0 Goals
-- [ ] **Split view preview editing** - Make edits in preview persist
+#### Platform & Distribution
+- [ ] **macOS app signing & notarization** - Create proper `.app` bundle, sign with Developer ID, notarize with Apple
 
 ### Future (v0.4.0+)
 - [ ] Spell checking
 - [ ] Custom themes (import/export)
 - [ ] Virtual/ghost text (AI completions, etc.)
 - [ ] Column/box selection
 
+### Long-Term Vision
+
+#### Headless Editor Library
+Extract `FerriteEditor` as a standalone, framework-agnostic text editing library for the Rust ecosystem.
+
+> **Context:** There's currently no general-purpose "headless" code editor library in Rust. Existing implementations (egui's TextEdit, Lapce/Floem, Zed/gpui) are tightly coupled to their UI frameworks. The v0.3.0 custom editor and modular architecture lay the groundwork for potential extraction.
+
+**Prerequisites (from v0.3.0):**
+- Custom `FerriteEditor` widget with rope-based buffer
+- Modular architecture with clean separation of concerns
+- Framework-agnostic core logic
+
+**Extraction would involve:**
+- [ ] Abstract rendering backend (trait-based: egui, wgpu, vello, SVG, etc.)
+- [ ] Framework-agnostic input handling
+- [ ] Standalone crate with minimal dependencies
+- [ ] Integration with [Parley](https://github.com/linebender/parley) for advanced text layout/shaping (optional)
+
 ---
 
 ## Completed ✅
 
-### v0.2.0 (Current Release)
+### v0.2.1 (Current Release)
+
+#### Mermaid Diagram Enhancements
+- [x] **Accurate text measurement** - Replace character-count estimation with egui font metrics
+- [x] **Dynamic node sizing** - Nodes resize to fit their labels without clipping
+- [x] **Text overflow handling** - Edge labels truncate with ellipsis when too long
+- [x] **User Journey icons** - Fixed unsupported emoji rendering with text fallbacks
+- [x] **Sequence control-flow blocks** - Support for `loop`, `alt`, `opt`, `par`, `critical`, `break` blocks with nesting
+- [x] **Sequence activation boxes** - `activate`/`deactivate` markers and `+`/`-` shorthand on lifelines
+- [x] **Sequence notes** - `Note left/right/over` syntax support with dog-ear rendering
+- [x] **Flowchart branching layout** - Sugiyama-style layered graph with side-by-side branches
+- [x] **Flowchart subgraphs** - Nested `subgraph`/`end` blocks with direction overrides
+- [x] **Back-edge routing** - Cycle edges rendered with smooth bezier curves
+- [x] **Smart edge exit points** - Decision node edges exit from different points to prevent crossing
+- [x] **Composite/nested states** - `state Parent { ... }` syntax with recursive nesting
+- [x] **Advanced state transitions** - Color-coded transitions and smart anchor points
+
+### v0.2.0
 
 #### Major Features
 - [x] **Side-by-side split view** - Raw editor on left, rendered preview on right with resizable divider

ROADMAP.md

@@ -68,9 +68,15 @@ A fast, lightweight text editor for Markdown, JSON, and more. Built with Rust an
 | [Search Panel Viewport](./technical/search-panel-viewport.md) | Viewport constraints for Search panel, DPI handling, resize behavior |
 | [Ribbon Redesign](./technical/ribbon-redesign.md) | Design C streamlined ribbon, title bar integration, dropdown menus |
 | [Mermaid Diagrams](./technical/mermaid-diagrams.md) | MermaidJS code block detection, diagram type indicators, styled rendering |
+| [Mermaid Text Measurement](./technical/mermaid-text-measurement.md) | TextMeasurer trait, dynamic node sizing, egui font metrics integration |
+| [Sequence Control Blocks](./technical/sequence-control-blocks.md) | Sequence diagram loop/alt/opt/par blocks, nested parsing, block rendering |
+| [Flowchart Layout Algorithm](./technical/flowchart-layout-algorithm.md) | Sugiyama-style layered graph layout, cycle detection, crossing reduction |
+| [Flowchart Subgraphs](./technical/flowchart-subgraphs.md) | Flowchart subgraph support, nested parsing, bounding box computation |
+| [Sequence Activations & Notes](./technical/sequence-activations-notes.md) | Activation boxes, notes, +/- shorthand, state tracking |
 | [Editor Minimap](./technical/minimap.md) | VS Code-style minimap navigation, click-to-navigate, search highlights, split view support |
 | [Branding](./branding.md) | Icon design, asset generation, platform integration guidelines |
 | **[Custom Editor Widget Plan](./technical/custom-editor-widget-plan.md)** | **v0.3.0 planning: Replace egui TextEdit with custom FerriteEditor widget** |
+| **[Mermaid Crate Plan](./mermaid-crate-plan.md)** | **Extract Mermaid renderer as standalone pure-Rust crate** |
 
 ---