How rojo-rbx/rbx-dom works
Main Components
a) Core Types Layer
• Center rbx_types as the foundation
• Supported Roblox value types (Vector3, CFrame, etc.)
• Type conversion capabilities
b) DOM Implementation Layer
• rbx_dom_weak as the main DOM implementation
• Instance representation
• Property management
• DOM manipulation capabilities
c) Serialization Layer
• rbx_binary for .rbxm/.rbxl formats
• rbx_xml for .rbxmx/.rbxlx formats
• Bidirectional conversion flows
d) Reflection Layer
• rbx_reflection for type information
• rbx_reflection_database for bundled data
• rbx_reflector for database generation
e) Integration Layer
• rbx_dom_lua for Roblox-side implementation
• rbx_util for CLI tools
Component Relationships
┌─────────────────────────────────────────────────┐
• Integration Layer │
• ┌─────────────┐ ┌────────────┐ │
• rbx_dom_lua │ │ rbx_util │ │
• ┘ └────────────┘ │
• ┬─────────────────────────┘
┌───────────────────────▼─────────────────────────┐
• Serialization Layer │
• ┌─────────────┐ ┌────────────┐ │
• rbx_binary │◄────────────►│ rbx_xml │ │
• ┘ └────────────┘ │
• ┬─────────────────────────┘
┌───────────────────────▼─────────────────────────┐
• DOM Layer │
• ┌─────────────────────────────────────────┐ │
• rbx_dom_weak │ │
• ┘ │
• ┬─────────────────────────┘
┌───────────────────────▼─────────────────────────┐
• Reflection Layer │
• ┌─────────────┐ ┌────────────────────────┐ │
• rbx_reflection│◄──►│rbx_reflection_database │ │
• ┘ └────────────────────────┘ │
• ┬─────────────────────────┘
┌───────────────────────▼─────────────────────────┐
• Core Types Layer │
• ┌─────────────────────────────────────────┐ │
• rbx_types │ │
• ┘ │
• ┘
Additional Elements
• Property type coverage matrix (as shown in README)
• External interface points (CLI, Lua API)
• File format support (.rbxm, .rbxl, .rbxmx, .rbxlx)
Important Details to Highlight
• Cross-platform nature of the implementation
• Type system compatibility
• Serialization format support
• Reflection capabilities
• Integration points with Roblox