reactive_mind_map 1.1.0

A customizable and interactive mind map widget for Flutter with smooth animations and various layout options.

Changelog

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

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.1.0 - 2025-06-20

🎯 New Features

• NodeExpandCameraBehavior: 노드 확장 시 카메라 동작을 제어할 수 있는 새로운 기능 추가
  • none: 카메라 이동 없음 (기본값)
  • focusClickedNode: 클릭한 노드로 포커스 이동
  • fitExpandedChildren: 새로 펼쳐진 자식 노드들이 모두 보이도록 조정
  • fitExpandedSubtree: 펼쳐진 전체 서브트리가 보이도록 조정

🐛 Bug Fixes

• 노드 토글 시 카메라 이동 문제 해결: 노드를 접거나 펼칠 때 전체 마인드맵이 조금씩 이동하는 버그 수정
• 루트 노드 위치 안정성 개선: 노드 토글 중에는 루트 노드 위치를 고정하여 안정적인 사용자 경험 제공

🔧 Technical Improvements

• 카메라 제어 로직 최적화
• 노드 토글 상태 관리 개선

1.0.5 2024-01-XX

🎯 New Features

• Smart Camera Focus: 스마트 카메라 포커스 시스템 추가
  • CameraFocus.rootNode: 루트 노드에 포커스 (기본값)
  • CameraFocus.center: 캔버스 중앙에 포커스
  • CameraFocus.fitAll: 모든 노드가 보이도록 자동 조정
  • CameraFocus.firstLeaf: 첫 번째 리프 노드에 포커스
  • CameraFocus.custom: 특정 노드 ID로 포커스 (focusNodeId 사용)

🔧 Camera Control Options

• cameraFocus: 카메라 포커스 옵션 설정
• focusNodeId: 포커스할 특정 노드 ID 지정
• focusAnimation: 포커스 이동 애니메이션 지속시간 (기본: 300ms)
• focusMargin: 포커스 시 여백 설정 (기본: 20px)

🎨 Enhanced User Experience

• 작은 컨테이너에서도 완벽한 마인드맵 표시
• 부드러운 카메라 이동 애니메이션
• 정확한 중앙 정렬 계산으로 픽셀 퍼펙트 포커스

📖 Documentation

• README에 Camera Focus Control 사용법 추가
• 4가지 실제 사용 예시 제공
• 포커스 옵션 테이블 추가

1.0.4 - 2025-06-20

🆕 새로운 기능 / New Features

• CameraFocus 기능 추가: 마인드맵의 카메라 포커스를 다양한 방식으로 제어할 수 있는 기능
  • CameraFocus.rootNode: 루트 노드 중심으로 포커스
  • CameraFocus.center: 캔버스 정중앙으로 포커스
  • CameraFocus.fitAll: 모든 노드가 보이도록 자동 조정 (스마트 스케일링)
  • CameraFocus.firstLeaf: 첫 번째 리프 노드로 포커스
  • CameraFocus.custom: 특정 노드 ID로 포커스 (focusNodeId와 함께 사용)
• 포커스 애니메이션: focusAnimation 속성으로 부드러운 포커스 이동 애니메이션 지원
• 포커스 여백: focusMargin 속성으로 포커스 시 여백 조정 가능
• 작은 Container 환경 최적화: 제한된 공간에서도 마인드맵이 잘 보이도록 개선

🛠️ 개선사항 / Improvements

• 카메라 포커스 로직을 분리하여 더 유연한 뷰 제어 가능
• fitAll 모드에서 스마트 스케일링으로 모든 노드를 효율적으로 표시
• 트랜스폼 애니메이션 성능 최적화
• 작은 Container에서의 UX 대폭 개선

📦 새로운 API

• cameraFocus: 카메라 포커스 옵션 설정
• focusNodeId: 포커스할 특정 노드 ID
• focusAnimation: 포커스 애니메이션 지속시간
• focusMargin: 포커스 시 여백 설정

🎯 사용 사례

작은 위젯이나 제한된 공간에서 마인드맵을 사용할 때 특히 유용합니다:

Container(
  height: 200,
  child: MindMapWidget(
    data: data,
    cameraFocus: CameraFocus.fitAll,
    focusAnimation: Duration(milliseconds: 500),
    focusMargin: EdgeInsets.all(10),
  ),
)

1.0.3 - 2025-06-06

Added

• 실제 노드 위치 기반 동적 캔버스 크기 계산 시스템 / Dynamic canvas sizing system based on actual node positions
• 콘텐츠 경계 박스 계산으로 정확한 캔버스 크기 결정 / Accurate canvas sizing through content bounding box calculation
• 스마트 패딩 시스템으로 최적화된 여백 관리 / Smart padding system for optimized margin management

Improved

• 텍스트 라인 수 제한 해제 (무제한 텍스트 표시 가능) / Unlimited text lines support (removed maxLines restriction)
• 한국어/영어 주석 순서 표준화 (한국어 먼저, 영어 나중) / Standardized Korean/English comment order
• 비대칭 트리 구조에서도 정확한 레이아웃 계산 / Accurate layout calculation even for asymmetric tree structures
• 노드 크기에 따른 동적 여백 조정 / Dynamic margin adjustment based on node sizes
• InteractiveViewer 기본 설정 개선 (constrained: true, 경계 마진 축소) / Improved InteractiveViewer defaults

Fixed

• 큰 마인드맵에서 노드가 캔버스 경계를 벗어나는 문제 해결 / Fixed nodes exceeding canvas boundaries in large mind maps
• 콘텐츠 크기와 캔버스 크기 불일치 문제 해결 / Resolved content size and canvas size mismatch issues
• 루트 노드 위치 계산 정확도 향상 / Improved root node positioning accuracy
• MindMapWidget이 Expanded 위젯 안에서 화면을 벗어나는 문제 해결 / Fixed MindMapWidget exceeding screen boundaries inside Expanded widget

Technical Details

• 2단계 레이아웃 시스템: 임시 계산 → 실제 크기 계산 → 재조정 / Two-stage layout system: temporary calculation → actual size calculation → readjustment
• _calculateRequiredCanvasSize() 메서드로 정확한 캔버스 크기 계산 / Precise canvas size calculation with _calculateRequiredCanvasSize() method
• _collectAllVisibleNodes() 메서드로 효율적인 노드 수집 / Efficient node collection with _collectAllVisibleNodes() method
• README에 중요한 사용법 주의사항 추가 / Added important usage notes to README

1.0.2 - 2025-06-13

Added

• Screenshots and demo GIF in README
• GitHub raw links for images to ensure pub.dev compatibility
• Improved README readability with emojis and cleaner formatting
• Bilingual documentation (Korean/English)

Improved

• Dynamic spacing calculation based on node sizes
• Better curve control points for connections
• Code comments with English translations
• Documentation structure and visual presentation

Fixed

• Image display issues on pub.dev by using GitHub raw URLs
• Code formatting and removed unnecessary comments

1.0.1 - 2025-06-13

Added

• Dynamic node sizing based on text content
• Enhanced spacing calculations for better layout
• Improved connection line rendering
• Auto-sizing configuration options

Improved

• Node overlap prevention
• Curve connection quality
• Layout consistency across all directions
• Performance optimizations

Fixed

• Connection point calculations for variable node sizes
• Layout issues in split arrangements
• Animation smoothness

1.0.0 - 2025-06-13

Added

• Initial release of Reactive Mind Map package
• Multiple layout options (right, left, top, bottom, radial, horizontal, vertical)
• Six node shapes (rounded rectangle, circle, rectangle, diamond, hexagon, ellipse)
• Comprehensive styling system with MindMapStyle
• Interactive features (tap, long press, double tap, expand/collapse)
• Smooth animations with customizable curves and duration
• Pan and zoom functionality
• Rich customization options for colors, fonts, and effects
• Shadow effects for nodes
• Connection line customization
• Comprehensive test suite
• Example application demonstrating all features
• MIT License
• Complete documentation

기술적 특징

• Flutter 3.0+ 지원
• 반응형 디자인
• 접근성 고려
• 타입 안전성

지원 플랫폼

• Android
• iOS
• Web
• Windows
• macOS
• Linux