🎯 New Features #

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

🐛 Bug Fixes #

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

🔧 Technical Improvements #

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

🎯 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가지 실제 사용 예시 제공
• 포커스 옵션 테이블 추가

🆕 새로운 기능 / 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),
  ),
)

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

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

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

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