Function evaluateLens

evaluateLens(
    lens: Lens,
    provider: LensDataProvider,
    matchedByRule: ReadonlyMap<string, ReadonlySet<number>>,
): LensEvaluationResult
Evaluate a lens against all entities in the data provider.
- O(n × r) where n = entity count, r = enabled rules
- First matching rule wins (short-circuit per entity)
- Unmatched entities receive GHOST_COLOR for context
Parameters
- lens: Lens
  Lens configuration to evaluate
- provider: LensDataProvider
  Data provider for entity access
- matchedByRule: ReadonlyMap<string, ReadonlySet<number>>
  Global IDs selected by the shared FilterGroup evaluator for each rule. Missing entries fail closed.
Returns LensEvaluationResult
Color map, hidden IDs, per-rule counts, and execution time