GSoC/DMP 2025 Week 3: feat(Masonry): Implement Brick Tree Model and add Connection points

[saumyashahi]

Description:

This PR implements a comprehensive brick tree model for the Masonry module, providing tree management, hierarchical and graph-like connections. The path file is also modified to now return connection points for each connection notch in the generateBrickData using getConnectionPoints function.

Key Features Added

1. BrickTreeManager Class

• Complete tree management system with unique tree IDs
• Hierarchical parent-child relationship support
• Graph-like left-right notch connections
• Automatic tree merging and splitting operations

2. Connection System

• Hierarchical Connections: Top-bottom and left-right parent-child relationships
• Nested Connections: Support for complex nested brick structures
• Connection Validation: Type-safe validation based on brick types and notch availability

3. Tree Operations

• Tree Merging: Automatic merging when bricks connect
• Tree Splitting: Intelligent splitting that preserves child relationships
• Hierarchical Disconnection: Parent disconnection preserves child connections
• UUID Management: Unique brick identification with dynamic tree IDs

Testing

1. Connection Tests: Validating tree merging behavior
2. Disconnection Tests: Ensuring proper tree splitting
3. Hierarchical Tests: Testing parent-child relationship preservation
4. Validation Tests: Verifying connection rules and notch compatibility
5. Edge Case Tests: Complex scenarios with multiple connections