Add Source which encapsulates file-based reflection

[thekid]

API

public class lang.reflection.Source implements lang.Value {
  public function __construct(ReflectionClass|ReflectionMethod $reflect)

  public function fileName(): string
  public function startLine(): int
  public function endLine(): int
  public function usedTypes(): [:string]
  public function usedConstants(): [:string]
  public function usedFunctions(): [:string]
  public function toString(): string
  public function hashCode(): string
  public function compareTo(var $value): int
}

Declaration site

 1 | <?php
 2 |
 3 | $source= Reflection::type(new class() { })->source();
 4 |
 5 | $source->fileName();  // current file
 6 | $source->startLine(); // 3
 7 | $source->endLine();   // 3, the anonymous type is declared in one line!

Imports

 1 | <?php
 2 |
 3 | use util\{Date as DateTime, Money};
 4 | use function strncmp;
 5 |
 6 | class T { }
 7 |
 8 | $source= Reflection::type(T::class)->source();
 9 | $source->usedTypes();     // ['DateTime' => 'util\\Date', 'Money' => 'util\\Money']
10 | $source->usedFunctions(); // ['strncmp' => 'strncmp']

Example

This code inside test.execution.TestClass could be rewritten:

-return $this->context->type->class()->reflect()->getFileName();
+return $this->context->type->source->fileName();