Ordered class abstract interface

A contract for objects that are assigned an order or precedence value.

This is typically used for sorting or prioritization where lower values have higher priority (i.e., 0 is higher than 10).

Framework components such as filters, interceptors, and plugins can implement Ordered to control execution sequence.

🧭 Ordering Rules

• Lower values indicate higher priority
• Constants are provided for extreme values:
  • Ordered.HIGHEST_PRECEDENCE = -2^31 (highest possible priority)
  • Ordered.LOWEST_PRECEDENCE = 2^31 - 1 (lowest possible priority)

📌 Example

class MyFilter implements Ordered {
  @override
  int get order => 10;
}

final filters = [MyFilter(), AnotherFilter()];
filters.sort((a, b) => a.order.compareTo(b.order));