FindMode and Component Lookup: GetComponent, GetAll, ComponentList, and Hierarchy Search

[Flags]
public enum FindMode
{
    Enabled     = 1,   // Only enabled components
    Disabled    = 2,   // Only disabled components
    InSelf      = 4,   // Search this GameObject
    InParent    = 8,   // Search immediate parent
    InAncestors = 16,  // Search all ancestors
    InChildren  = 32,  // Search immediate children
    InDescendants = 64 // Search all descendants
}

// On a Component or GameObject:

// Get first enabled component of type T on this object
var rb = GetComponent<Rigidbody>();

// Get first component including disabled
var rb = GetComponent<Rigidbody>( includeDisabled: true );

// Get all components of type T on this object
var all = GetComponents<MyComponent>();

// Get first in hierarchy (self + descendants)
var child = GetComponentInChildren<MyComponent>();

// Get first in ancestors
var parent = GetComponentInParent<MyComponent>();

// Add a component
var rb = AddComponent<Rigidbody>();

// Get or add (won't duplicate)
var rb = GetOrAddComponent<Rigidbody>();

// Custom FindMode
var result = Components.Get<MyComponent>( FindMode.InAncestors | FindMode.Enabled );

// Get all with custom mode
var all = Components.GetAll<MyComponent>( FindMode.EverythingInSelfAndDescendants );

// Get or create
var rb = Components.GetOrCreate<Rigidbody>();

// Try get
if ( Components.TryGet<Rigidbody>( out var rb ) )
{
    // found
}