packages/deriver/tests/Unit/Deriver/Lowerer/Declaration/IndexTest.php

1<?php
2
3declare (strict_types=1);
4
5namespace Tests\Unit\Deriver\Lowerer\Declaration;
6
7use Deriver\Deriver;
8use Deriver\Deriver\Candidate\ResultRef;
9use Deriver\Deriver\Candidate\Snapshot;
10use Deriver\Deriver\Candidate\Statistics;
11use Deriver\Deriver\Contributions;
12use Deriver\Deriver\DeriverConfig;
13use Deriver\Deriver\Evaluator\Call\Evaluators;
14use Deriver\Deriver\Evaluator\Call\Extensions;
15use Deriver\Deriver\Evaluator\Call\Registrations;
16use Deriver\Deriver\Evaluator\Call\StateRegistry;
17use Deriver\Deriver\Evaluator\EvaluatorConfig;
18use Deriver\Deriver\Evaluator\Evidence\Frontier;
19use Deriver\Deriver\Evaluator\Execution\Call\ArgumentBinding;
20use Deriver\Deriver\Evaluator\Execution\Call\ArgumentOrder;
21use Deriver\Deriver\Evaluator\Execution\Call\TypeBinding;
22use Deriver\Deriver\Evaluator\Execution\Call\TypeCheck;
23use Deriver\Deriver\Evaluator\Execution\Completion\Alternative;
24use Deriver\Deriver\Evaluator\Execution\Completion\Assessment;
25use Deriver\Deriver\Evaluator\Execution\Completion\Completion;
26use Deriver\Deriver\Evaluator\Execution\Completion\StorageSnapshot;
27use Deriver\Deriver\Evaluator\Execution\Context;
28use Deriver\Deriver\Evaluator\Execution\Control\ObservationLimit;
29use Deriver\Deriver\Evaluator\Execution\Control\StateJoin;
30use Deriver\Deriver\Evaluator\Execution\Control\Unwinding;
31use Deriver\Deriver\Evaluator\Execution\Demand\Cell;
32use Deriver\Deriver\Evaluator\Execution\Demand\Components;
33use Deriver\Deriver\Evaluator\Execution\Demand\Discovery;
34use Deriver\Deriver\Evaluator\Execution\Demand\Key;
35use Deriver\Deriver\Evaluator\Execution\Demand\Table;
36use Deriver\Deriver\Evaluator\Execution\Dependencies;
37use Deriver\Deriver\Evaluator\Execution\Evaluator;
38use Deriver\Deriver\Evaluator\Execution\EvaluatorConfig as ExecutionEvaluatorConfig;
39use Deriver\Deriver\Evaluator\Execution\InstructionTransfer;
40use Deriver\Deriver\Evaluator\Execution\Memory\Location;
41use Deriver\Deriver\Evaluator\Execution\Memory\Materialization;
42use Deriver\Deriver\Evaluator\Execution\Memory\Memory;
43use Deriver\Deriver\Evaluator\Execution\Memory\ReferenceConstraint;
44use Deriver\Deriver\Evaluator\Execution\Memory\Slots\SlotReference;
45use Deriver\Deriver\Evaluator\Execution\Memory\StorageCapture;
46use Deriver\Deriver\Evaluator\Execution\ObservationCollector;
47use Deriver\Deriver\Evaluator\Execution\Operation\Conversions;
48use Deriver\Deriver\Evaluator\Execution\Operation\ScalarErrors;
49use Deriver\Deriver\Evaluator\Execution\State;
50use Deriver\Deriver\Evaluator\Execution\Summary\CompletionRecord;
51use Deriver\Deriver\Evaluator\Execution\Summary\Evaluation;
52use Deriver\Deriver\Evaluator\Execution\Summary\Invocation;
53use Deriver\Deriver\Evaluator\Execution\Summary\Isolation;
54use Deriver\Deriver\Evaluator\Execution\Trace\Derivation;
55use Deriver\Deriver\Evaluator\Execution\Transfer\MemoryStep;
56use Deriver\Deriver\Evaluator\Execution\Transfer\PureStep;
57use Deriver\Deriver\Evaluator\Execution\Transfer\ReferenceAssignment;
58use Deriver\Deriver\Evaluator\Request\Budget;
59use Deriver\Deriver\Evaluator\Request\EntryPoint;
60use Deriver\Deriver\Evaluator\Request\QueryScope;
61use Deriver\Deriver\Evaluator\Request\ReturnQuery;
62use Deriver\Deriver\Evaluator\Scalar\Identity;
63use Deriver\Deriver\Evaluator\Scalar\Operations;
64use Deriver\Deriver\Evaluator\TargetProfile;
65use Deriver\Deriver\Evaluator\Term;
66use Deriver\Deriver\Execution\DerivationResult;
67use Deriver\Deriver\Execution\QueryExecution;
68use Deriver\Deriver\Execution\ResultAssessment;
69use Deriver\Deriver\Identity\QueryEncoding;
70use Deriver\Deriver\Identity\ValueGraph;
71use Deriver\Deriver\Lowerer\AssignmentLowering;
72use Deriver\Deriver\Lowerer\Control\DestructuringLowering;
73use Deriver\Deriver\Lowerer\Declaration\CallableIdentity;
74use Deriver\Deriver\Lowerer\Declaration\CallableSource;
75use Deriver\Deriver\Lowerer\Declaration\CallSiteIndex;
76use Deriver\Deriver\Lowerer\Declaration\ConstantSignatures;
77use Deriver\Deriver\Lowerer\Declaration\Index;
78use Deriver\Deriver\Lowerer\Declaration\Indexer;
79use Deriver\Deriver\Lowerer\Declaration\Metadata\ClassConstant;
80use Deriver\Deriver\Lowerer\Declaration\Metadata\ClassDeclaration;
81use Deriver\Deriver\Lowerer\Declaration\Traits\Composition;
82use Deriver\Deriver\Lowerer\EffectInspection;
83use Deriver\Deriver\Lowerer\ExpressionLowering;
84use Deriver\Deriver\Lowerer\Graph\BasicBlock;
85use Deriver\Deriver\Lowerer\Graph\CallableGraph;
86use Deriver\Deriver\Lowerer\Graph\Instruction;
87use Deriver\Deriver\Lowerer\Graph\Literal;
88use Deriver\Deriver\Lowerer\Graph\Terminator;
89use Deriver\Deriver\Lowerer\Hierarchy\Dispatch;
90use Deriver\Deriver\Lowerer\InstructionEmitter;
91use Deriver\Deriver\Lowerer\Lowerer;
92use Deriver\Deriver\Lowerer\LoweringScope;
93use Deriver\Deriver\Lowerer\StatementLowering;
94use Deriver\Deriver\MicroEvaluatorConversion;
95use Deriver\Deriver\Parser\Node\File;
96use Deriver\Deriver\Parser\Parser;
97use Deriver\Deriver\Parser\ParserConfig;
98use Deriver\Deriver\Parser\TargetSyntax;
99use Deriver\Deriver\Providers\ProviderExpansion;
100use Deriver\Deriver\Resolver\AssignmentPatterns;
101use Deriver\Deriver\Resolver\ClassScope;
102use Deriver\Deriver\Resolver\ExpressionValidation;
103use Deriver\Deriver\Resolver\MagicContext;
104use Deriver\Deriver\Resolver\Resolver;
105use Deriver\Deriver\Selection\QueryValidation;
106use Deriver\Deriver\SnapshotIdentity;
107use Deriver\Deriver\Sources\LineMap;
108use Deriver\Deriver\Sources\Path;
109use Deriver\Deriver\Sources\Source;
110use Deriver\Deriver\Sources\SourceRef;
111use Deriver\Deriver\Sources\Sources;
112use Deriver\Exception\ParserException;
113use Deriver\Exception\ResolutionException;
114use PhpParser\Node\Expr\ArrowFunction;
115use PhpParser\Node\Scalar\Int_;
116use PHPUnit\Framework\Attributes\CoversClass;
117use PHPUnit\Framework\Attributes\Small;
118use PHPUnit\Framework\Attributes\UsesClass;
119use PHPUnit\Framework\TestCase;
120
121#[UsesClass(Resolver::class)]
122#[UsesClass(ExpressionValidation::class)]
123#[UsesClass(ResolutionException::class)]
124#[UsesClass(ParserConfig::class)]
125#[UsesClass(ParserException::class)]
126#[CoversClass(Index::class)]
127#[UsesClass(QueryExecution::class)]
128#[UsesClass(QueryValidation::class)]
129#[UsesClass(ResultAssessment::class)]
130#[UsesClass(Deriver::class)]
131#[UsesClass(BasicBlock::class)]
132#[UsesClass(CallableGraph::class)]
133#[UsesClass(CallableIdentity::class)]
134#[UsesClass(ClassConstant::class)]
135#[UsesClass(ClassDeclaration::class)]
136#[UsesClass(Instruction::class)]
137#[UsesClass(Terminator::class)]
138#[UsesClass(ArgumentBinding::class)]
139#[UsesClass(ArgumentOrder::class)]
140#[UsesClass(Dispatch::class)]
141#[UsesClass(TypeBinding::class)]
142#[UsesClass(TypeCheck::class)]
143#[UsesClass(Completion::class)]
144#[UsesClass(Context::class)]
145#[UsesClass(ObservationLimit::class)]
146#[UsesClass(StateJoin::class)]
147#[UsesClass(Unwinding::class)]
148#[UsesClass(Cell::class)]
149#[UsesClass(Components::class)]
150#[UsesClass(Discovery::class)]
151#[UsesClass(Key::class)]
152#[UsesClass(Table::class)]
153#[UsesClass(Dependencies::class)]
154#[UsesClass(InstructionTransfer::class)]
155#[UsesClass(Evaluator::class)]
156#[UsesClass(SlotReference::class)]
157#[UsesClass(ObservationCollector::class)]
158#[UsesClass(Conversions::class)]
159#[UsesClass(ScalarErrors::class)]
160#[UsesClass(State::class)]
161#[UsesClass(CompletionRecord::class)]
162#[UsesClass(Evaluation::class)]
163#[UsesClass(Invocation::class)]
164#[UsesClass(Isolation::class)]
165#[UsesClass(MemoryStep::class)]
166#[UsesClass(PureStep::class)]
167#[UsesClass(ReferenceAssignment::class)]
168#[UsesClass(Location::class)]
169#[UsesClass(Materialization::class)]
170#[UsesClass(Memory::class)]
171#[UsesClass(ReferenceConstraint::class)]
172#[UsesClass(StorageCapture::class)]
173#[UsesClass(Extensions::class)]
174#[UsesClass(ProviderExpansion::class)]
175#[UsesClass(Evaluators::class)]
176#[UsesClass(StateRegistry::class)]
177#[UsesClass(DeriverConfig::class)]
178#[UsesClass(EntryPoint::class)]
179#[UsesClass(Sources::class)]
180#[UsesClass(Path::class)]
181#[UsesClass(Snapshot::class)]
182#[UsesClass(Source::class)]
183#[UsesClass(TargetProfile::class)]
184#[UsesClass(Budget::class)]
185#[UsesClass(QueryScope::class)]
186#[UsesClass(ReturnQuery::class)]
187#[UsesClass(ResultRef::class)]
188#[UsesClass(SourceRef::class)]
189#[UsesClass(Alternative::class)]
190#[UsesClass(Assessment::class)]
191#[UsesClass(Derivation::class)]
192#[UsesClass(DerivationResult::class)]
193#[UsesClass(Frontier::class)]
194#[UsesClass(QueryEncoding::class)]
195#[UsesClass(ValueGraph::class)]
196#[UsesClass(Statistics::class)]
197#[UsesClass(StorageSnapshot::class)]
198#[UsesClass(Parser::class)]
199#[UsesClass(File::class)]
200#[UsesClass(AssignmentLowering::class)]
201#[UsesClass(Lowerer::class)]
202#[UsesClass(DestructuringLowering::class)]
203#[UsesClass(EffectInspection::class)]
204#[UsesClass(ExpressionLowering::class)]
205#[UsesClass(InstructionEmitter::class)]
206#[UsesClass(LoweringScope::class)]
207#[UsesClass(StatementLowering::class)]
208#[UsesClass(ConstantSignatures::class)]
209#[UsesClass(CallSiteIndex::class)]
210#[UsesClass(CallableSource::class)]
211#[UsesClass(Indexer::class)]
212#[UsesClass(Composition::class)]
213#[UsesClass(LineMap::class)]
214#[UsesClass(MagicContext::class)]
215#[UsesClass(AssignmentPatterns::class)]
216#[UsesClass(ClassScope::class)]
217#[UsesClass(TargetSyntax::class)]
218#[UsesClass(Identity::class)]
219#[UsesClass(Operations::class)]
220#[UsesClass(Literal::class)]
221#[Small]
222final class IndexTest extends TestCase
223{
224    public function testScanPreservesTheSemanticContract(): void
225    {
226        $source = '<?php function target() { $x="before"; $x="after"; return $x . ":done"; }';
227        $symbol = 'target';
228        $input = new Sources([new Source('fixture.php', $source)]);
229        $configuration = new DeriverConfig();
230        $contributions = new Contributions();
231        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
232        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
233        $contributions1 = $providers->contributions;
234        $evaluators = new Evaluators(new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision), new Registrations($contributions1->evaluators, $contributions1->providers, $contributions1->domains, $contributions1->intrinsics, $contributions1->stateSlots), $configuration->standardEvaluators);
235        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
236        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
237        $snapshotId = $identity->id;
238        $input1 = $providers->input;
239        $parser = new Parser(new ParserConfig($target->version));
240        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input1, false));
241        $program = new Index($snapshotId, $trees);
242        $result = (new QueryExecution($program, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program->diagnostics()))))->derive(new ReturnQuery($symbol));
243        self::assertSame('after:done', $result->normalOutcomes[0]->values['return']->native());
244        self::assertSame([], $result->frontiers);
245        self::assertSame([], $result->exceptionalOutcomes);
246    }
247    public function testClassesIncludesDeclarationsBeforeAnyGraphIsDemanded(): void
248    {
249        $source = '<?php class A {}';
250        $snapshotId = 'test';
251        $input = new Sources([new Source('fixture.php', $source)]);
252        $profile = new TargetProfile();
253        $parser = new Parser(new ParserConfig($profile->version));
254        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
255        $index = new Index($snapshotId, $trees);
256        self::assertSame(['a'], array_keys($index->classes()));
257        self::assertSame(0, $index->graphCount());
258    }
259    public function testSymbolsReturnsStableSourceIdentities(): void
260    {
261        $source = '<?php function Z(){} function A(){}';
262        $snapshotId = 'test';
263        $input = new Sources([new Source('fixture.php', $source)]);
264        $profile = new TargetProfile();
265        $parser = new Parser(new ParserConfig($profile->version));
266        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
267        $index = new Index($snapshotId, $trees);
268        self::assertSame(['A', 'Z', 'script:fixture.php'], $index->symbols());
269    }
270    public function testDiagnosticsDistinguishesConflictingDeclarationsFromAnEmptyIndex(): void
271    {
272        $source = '<?php function same(){} function SAME(){}';
273        $snapshotId = 'test';
274        $input = new Sources([new Source('fixture.php', $source)]);
275        $profile = new TargetProfile();
276        $parser = new Parser(new ParserConfig($profile->version));
277        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
278        $index = new Index($snapshotId, $trees);
279        self::assertCount(1, $index->diagnostics());
280        self::assertSame('INVALID_PROGRAM', $index->diagnostics()[0]->code);
281        self::assertSame('duplicate:SAME', $index->diagnostics()[0]->operation);
282        self::assertSame('fixture.php', $index->diagnostics()[0]->at->path);
283        $source2 = '<?php';
284        $snapshotId1 = 'test';
285        $input1 = new Sources([new Source('fixture.php', $source2)]);
286        $profile1 = new TargetProfile();
287        $parser1 = new Parser(new ParserConfig($profile1->version));
288        $trees1 = array_map(static fn (Source $source3): File => (new Resolver())->resolve($parser1->parse(new Source(Path::normalize($source3->path), $source3->contents, $source3->declarationsOnly))), iterator_to_array($input1, false));
289        self::assertSame([], (new Index($snapshotId1, $trees1))->diagnostics());
290    }
291    public function testGraphCountCountsOnlyDemandedBodiesAndReusesTheGraph(): void
292    {
293        $source = '<?php function target(){} function other(){}';
294        $snapshotId = 'test';
295        $input = new Sources([new Source('fixture.php', $source)]);
296        $profile = new TargetProfile();
297        $parser = new Parser(new ParserConfig($profile->version));
298        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
299        $index = new Index($snapshotId, $trees);
300        self::assertSame(0, $index->graphCount());
301        $first = $index->callable('target');
302        self::assertNotNull($first);
303        self::assertSame($first, $index->callable('TARGET'));
304        self::assertSame(1, $index->graphCount());
305    }
306    public function testConstantCompilesARequestedInitializerOnce(): void
307    {
308        $source = '<?php const ANSWER = 40+2;';
309        $snapshotId = 'test';
310        $input = new Sources([new Source('fixture.php', $source)]);
311        $profile = new TargetProfile();
312        $parser = new Parser(new ParserConfig($profile->version));
313        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
314        $index = new Index($snapshotId, $trees);
315        $constant = $index->constant('ANSWER');
316        self::assertNotNull($constant);
317        self::assertSame(['constant', 'constant', 'binary'], array_column($constant->blocks[0]->instructions, 'operation'));
318        self::assertSame($constant, $index->constant('ANSWER'));
319        self::assertNull($index->constant('answer'));
320    }
321    public function testCallOwnersDoesNotCompileUnrelatedBodies(): void
322    {
323        $source = '<?php function used(){sink(1);} function other(){unrelated();}';
324        $snapshotId = 'test';
325        $input = new Sources([new Source('fixture.php', $source)]);
326        $profile = new TargetProfile();
327        $parser = new Parser(new ParserConfig($profile->version));
328        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
329        $index = new Index($snapshotId, $trees);
330        self::assertSame(['used'], $index->callOwners('sink'));
331        self::assertSame(0, $index->graphCount());
332    }
333    public function testRegisterReportsDuplicateCaseInsensitiveSymbols(): void
334    {
335        $source = '<?php function target(){}';
336        $snapshotId = 'test';
337        $input = new Sources([new Source('fixture.php', $source)]);
338        $profile = new TargetProfile();
339        $parser = new Parser(new ParserConfig($profile->version));
340        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
341        $index = new Index($snapshotId, $trees);
342        $index->register($index->declarations['target']);
343        self::assertSame('INVALID_PROGRAM', $index->diagnostics()[0]->code);
344        self::assertCount(2, $index->symbols());
345    }
346    public function testBuilderRetainsTheCapturedBytes(): void
347    {
348        $source = '<?php function target(){}';
349        $snapshotId = 'test';
350        $input = new Sources([new Source('fixture.php', $source)]);
351        $profile = new TargetProfile();
352        $parser = new Parser(new ParserConfig($profile->version));
353        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
354        $index = new Index($snapshotId, $trees);
355        self::assertSame('<?php function target(){}', $index->builder('fixture.php')->contents);
356    }
357    public function testCallableUsesCaseInsensitiveFunctionResolution(): void
358    {
359        $source = '<?php function Target(){}';
360        $snapshotId = 'test';
361        $input = new Sources([new Source('fixture.php', $source)]);
362        $profile = new TargetProfile();
363        $parser = new Parser(new ParserConfig($profile->version));
364        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
365        $index = new Index($snapshotId, $trees);
366        self::assertSame($index->callable('target'), $index->callable('\TARGET'));
367        self::assertNull($index->callable('missing'));
368    }
369    public function testRegisterClosureInheritsStrictModeWithoutCompilingIt(): void
370    {
371        $source = '<?php declare(strict_types=1);';
372        $snapshotId = 'test';
373        $input = new Sources([new Source('fixture.php', $source)]);
374        $profile = new TargetProfile();
375        $parser = new Parser(new ParserConfig($profile->version));
376        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
377        $index = new Index($snapshotId, $trees);
378        $node = new ArrowFunction(['expr' => new Int_(1)], ['startFilePos' => 31]);
379        $symbol = $index->registerClosure($node, 'fixture.php', '');
380        self::assertSame('closure:fixture.php:31', $symbol);
381        self::assertSame(0, $index->graphCount());
382        self::assertTrue($index->declarations[$symbol]->strict);
383    }
384    public function testScanNormalizesPathsAndKeepsFilesHashesAndDeclarationsInStableOrder(): void
385    {
386        $first = '<?php function Z(){}';
387        $second = '<?php function A(){}';
388        $input = new Sources([new Source('z/./File.php', $first, true), new Source('a\File.php', $second)]);
389        $snapshotId = 'snapshot';
390        $profile = new TargetProfile();
391        $parser = new Parser(new ParserConfig($profile->version));
392        $trees = array_map(static fn (Source $source): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source->path), $source->contents, $source->declarationsOnly))), iterator_to_array($input, false));
393        $index = new Index($snapshotId, $trees);
394        self::assertSame(['a/File.php', 'z/File.php'], array_keys($index->files));
395        self::assertSame('z/File.php', $index->files['z/File.php']->path);
396        self::assertTrue($index->files['z/File.php']->declarationsOnly);
397        self::assertSame(['A', 'Z', 'script:a/File.php'], $index->symbols());
398        self::assertSame(['a', 'script:a/File.php', 'z'], array_keys($index->declarations));
399        self::assertSame(0, $index->graphCount());
400    }
401    public function testScanPreservesScriptRangesStrictnessAndCaseSensitiveFileIdentities(): void
402    {
403        $upper = '<?php declare(strict_types=1);return 1;';
404        $lower = '<?php return 2;';
405        $snapshotId = 'snapshot';
406        $input = new Sources([new Source('A.php', $upper), new Source('a.php', $lower)]);
407        $profile = new TargetProfile();
408        $parser = new Parser(new ParserConfig($profile->version));
409        $trees = array_map(static fn (Source $source): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source->path), $source->contents, $source->declarationsOnly))), iterator_to_array($input, false));
410        $index = new Index($snapshotId, $trees);
411        $first = $index->callable('script:A.php');
412        $second = $index->callable('script:a.php');
413        self::assertNotNull($first);
414        self::assertNotNull($second);
415        self::assertNotSame($first, $second);
416        self::assertTrue($first->strict);
417        self::assertFalse($second->strict);
418        self::assertSame('snapshot', $first->source->snapshotId);
419        self::assertSame('A.php', $first->source->path);
420        self::assertSame(0, $first->source->start);
421        self::assertSame(strlen($upper), $first->source->end);
422        self::assertSame(strlen($lower), $second->source->end);
423        self::assertSame([], $index->diagnostics());
424    }
425    public function testScanReportsConflictingDeclarationsWithTheirSourceCoordinates(): void
426    {
427        $first = new Source('a.php', '<?php function first(){} function second(){}');
428        $second = new Source('b.php', "<?php\nfunction FIRST(){}\nfunction SECOND(){}");
429        $snapshotId = 'snapshot';
430        $input = new Sources([$first, $second]);
431        $profile = new TargetProfile();
432        $parser = new Parser(new ParserConfig($profile->version));
433        $trees = array_map(static fn (Source $source): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source->path), $source->contents, $source->declarationsOnly))), iterator_to_array($input, false));
434        $index = new Index($snapshotId, $trees);
435        $issues = $index->diagnostics();
436        self::assertCount(2, $issues);
437        self::assertSame(['INVALID_PROGRAM', 'INVALID_PROGRAM'], array_column($issues, 'code'));
438        self::assertSame(['duplicate:FIRST', 'duplicate:SECOND'], array_column($issues, 'operation'));
439        self::assertSame('b.php', $issues[0]->at->path);
440        self::assertSame('snapshot', $issues[0]->at->snapshotId);
441        self::assertSame(2, $issues[0]->at->line);
442        self::assertSame(3, $issues[1]->at->line);
443    }
444    public function testRegisterRetainsTheOriginalDeclarationAndReportsTheDuplicateLocation(): void
445    {
446        $source = '<?php function TARGET(){return 1;}function target(){return 2;}';
447        $snapshotId = 'test';
448        $input = new Sources([new Source('fixture.php', $source)]);
449        $profile = new TargetProfile();
450        $parser = new Parser(new ParserConfig($profile->version));
451        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
452        $index = new Index($snapshotId, $trees);
453        self::assertCount(1, $index->diagnostics());
454        self::assertSame('duplicate:target', $index->diagnostics()[0]->operation);
455        self::assertGreaterThan($index->declarations['target']->node->getStartFilePos(), $index->diagnostics()[0]->at->start);
456        $body = $index->callable('target');
457        self::assertNotNull($body);
458        self::assertSame('TARGET', $body->symbol);
459        self::assertSame(1, $body->blocks[0]->instructions[0]->constant?->literal);
460    }
461    public function testRegisterClosureKeepsLexicalScopesAndRegistersDeclarations(): void
462    {
463        $source = '<?php declare(strict_types=1);';
464        $snapshotId = 'test';
465        $input = new Sources([new Source('fixture.php', $source)]);
466        $profile = new TargetProfile();
467        $parser = new Parser(new ParserConfig($profile->version));
468        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
469        $index = new Index($snapshotId, $trees);
470        $node = new ArrowFunction(['expr' => new Int_(1)], ['startFilePos' => 31]);
471        $a = $index->registerClosure($node, 'fixture.php', 'Alpha');
472        $b = $index->registerClosure($node, 'fixture.php', 'Beta');
473        $again = $index->registerClosure($node, 'fixture.php', 'Alpha');
474        self::assertSame('closure:fixture.php:31:scope:Alpha', $a);
475        self::assertSame('closure:fixture.php:31:scope:Beta', $b);
476        self::assertSame($a, $again);
477        self::assertSame($node, $index->declarations[$a]->node);
478        self::assertTrue($index->declarations[$a]->strict);
479        self::assertSame('Alpha', $index->declarations[$a]->className);
480        self::assertSame('Beta', $index->declarations[$b]->className);
481        self::assertSame([], $index->diagnostics());
482        self::assertSame(0, $index->graphCount());
483    }
484    public function testConstantPreservesConstantCaseAndNormalizesOnlyItsDeclaringClass(): void
485    {
486        $source = '<?php class Box{const VALUE=1;const value=2;}';
487        $snapshotId = 'test';
488        $input = new Sources([new Source('fixture.php', $source)]);
489        $profile = new TargetProfile();
490        $parser = new Parser(new ParserConfig($profile->version));
491        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
492        $index = new Index($snapshotId, $trees);
493        $upper = $index->constant('Box::VALUE');
494        $lower = $index->constant('Box::value');
495        self::assertNotNull($upper);
496        self::assertNotNull($lower);
497        self::assertNotSame($upper, $lower);
498        self::assertSame($upper, $index->constant('bOX::VALUE'));
499        self::assertSame(1, $upper->blocks[0]->instructions[0]->constant?->literal);
500        self::assertSame(2, $lower->blocks[0]->instructions[0]->constant?->literal);
501        self::assertSame('Box', $upper->className);
502        self::assertNull($index->constant('Box::missing'));
503        self::assertSame(2, $index->graphCount());
504    }
505    public function testBuilderReusesTheCapturedLineMapAndSnapshotOwnership(): void
506    {
507        $source = "<?php\nfunction target(){}";
508        $snapshotId = 'test';
509        $input = new Sources([new Source('fixture.php', $source)]);
510        $profile = new TargetProfile();
511        $parser = new Parser(new ParserConfig($profile->version));
512        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
513        $index = new Index($snapshotId, $trees);
514        $builder = $index->builder('fixture.php');
515        self::assertSame($index->lineMaps['fixture.php'], $builder->lines);
516        self::assertSame('test', $builder->snapshot);
517        self::assertSame('fixture.php', $builder->path);
518        self::assertSame("<?php\nfunction target(){}", $builder->contents);
519    }
520    public function testPropertyOwnersDoesNotLowerUnrelatedBodies(): void
521    {
522        $source = '<?php class A{public $x;function set(){ $this->x=1; }} function unrelated(){return 2;}';
523        $snapshotId = 'test';
524        $input = new Sources([new Source('fixture.php', $source)]);
525        $profile = new TargetProfile();
526        $parser = new Parser(new ParserConfig($profile->version));
527        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
528        $index = new Index($snapshotId, $trees);
529        self::assertSame(['A::set'], $index->propertyOwners('x'));
530        self::assertSame(0, $index->graphCount());
531    }
532    public function testVariantsRetainsBothConditionalDeclarations(): void
533    {
534        $source = '<?php if($x){function f(){return 1;}}else{function f(){return 2;}}';
535        $snapshotId = 'test';
536        $input = new Sources([new Source('fixture.php', $source)]);
537        $profile = new TargetProfile();
538        $parser = new Parser(new ParserConfig($profile->version));
539        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
540        $index = new Index($snapshotId, $trees);
541        self::assertCount(1, $index->variants('f'));
542        self::assertSame([], $index->diagnostics());
543    }
544    public function testHasSymbolPreservesExactSpellingWithoutCompiling(): void
545    {
546        $tree = (new Resolver())->resolve((new Parser(new ParserConfig('8.3')))->parse(new Source('fixture.php', '<?php function Target(){}')));
547        $index = new Index('test', [$tree]);
548        self::assertTrue($index->hasSymbol('Target'));
549        self::assertFalse($index->hasSymbol('target'));
550        self::assertFalse($index->hasSymbol('missing'));
551        self::assertSame(0, $index->graphCount());
552    }
553
554    public function testClosureOwnersFindsTheLexicalParentBeforeLowering(): void
555    {
556        $tree = (new Resolver())->resolve((new Parser(new ParserConfig('8.3')))->parse(new Source('fixture.php', '<?php function owner(){return fn()=>sink();}')));
557        $index = new Index('test', [$tree]);
558        $owners = $index->callOwners('sink');
559        self::assertCount(1, $owners);
560        self::assertSame(['owner'], $index->closureOwners($owners[0]));
561        self::assertSame(0, $index->graphCount());
562    }
563
564    public function testGlobalOwnersExcludesFunctionLocals(): void
565    {
566        $tree = (new Resolver())->resolve((new Parser(new ParserConfig('8.3')))->parse(new Source('fixture.php', '<?php $x=1; function f(){$local=2;}')));
567        $index = new Index('test', [$tree]);
568        self::assertSame(['script:fixture.php'], $index->globalOwners('x'));
569        self::assertSame([], $index->globalOwners('local'));
570        self::assertSame(0, $index->graphCount());
571    }
572
573}
574