ViewModel Families Map

one conceptual hierarchy, five idioms, and specialized companions

Dark SVG source uses the VMx architecture palette and keeps arrows behind masked component boxes.

Five idioms

  • Leaf, composite, group, aggregate, and hierarchical shapes are distinct on purpose.
  • Forwarding decorators and specialized VMs stay outside the core container split.
  • This is the same family map every flavor implements.

Behavior overlays

  • Capabilities describe what a VM can do, not what it is.
  • State helpers and paging helpers compose beside the VM family instead of inflating the inheritance tree.
  • Form, dialog, notification, and discriminator behaviors remain opt-in surfaces.

Docs use

  • This map is the quick orientation diagram for contributors reading the spec index.
  • It complements the class architecture map by grouping primitives into usage families.
  • The Notes Workspace diagrams later show how the families combine in practice.