packages/deriver/tests/Unit/Deriver/Evaluator/Execution/Transfer/ConstantTransferTest.php

1<?php
2
3declare (strict_types=1);
4
5namespace Tests\Unit\Deriver\Evaluator\Execution\Transfer;
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\BoundInstruction;
14use Deriver\Deriver\Evaluator\Call\Evaluators;
15use Deriver\Deriver\Evaluator\Call\Extensions;
16use Deriver\Deriver\Evaluator\Call\Provider\DispatchDecision;
17use Deriver\Deriver\Evaluator\Call\Registrations;
18use Deriver\Deriver\Evaluator\Call\StateRegistry;
19use Deriver\Deriver\Evaluator\EvaluatorConfig;
20use Deriver\Deriver\Evaluator\Evidence\Frontier;
21use Deriver\Deriver\Evaluator\Execution\Call\Allocation;
22use Deriver\Deriver\Evaluator\Execution\Call\ArgumentBinding;
23use Deriver\Deriver\Evaluator\Execution\Call\ArgumentOrder;
24use Deriver\Deriver\Evaluator\Execution\Call\CallableCheck;
25use Deriver\Deriver\Evaluator\Execution\Call\CallExecutor;
26use Deriver\Deriver\Evaluator\Execution\Call\CallResolution;
27use Deriver\Deriver\Evaluator\Execution\Call\Creation\Access;
28use Deriver\Deriver\Evaluator\Execution\Call\Member\Constants;
29use Deriver\Deriver\Evaluator\Execution\Call\Member\Invocation;
30use Deriver\Deriver\Evaluator\Execution\Call\MethodInvocation;
31use Deriver\Deriver\Evaluator\Execution\Call\Native\Invocation as NativeInvocation;
32use Deriver\Deriver\Evaluator\Execution\Call\Native\Properties;
33use Deriver\Deriver\Evaluator\Execution\Call\Native\Signatures;
34use Deriver\Deriver\Evaluator\Execution\Call\ParameterBinding;
35use Deriver\Deriver\Evaluator\Execution\Call\PassedArgument;
36use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Creation;
37use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Methods;
38use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Resolution;
39use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Target;
40use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Transfer;
41use Deriver\Deriver\Evaluator\Execution\Call\TypeBinding;
42use Deriver\Deriver\Evaluator\Execution\Call\TypeCheck;
43use Deriver\Deriver\Evaluator\Execution\Completion\Alternative;
44use Deriver\Deriver\Evaluator\Execution\Completion\Assessment;
45use Deriver\Deriver\Evaluator\Execution\Completion\Completion;
46use Deriver\Deriver\Evaluator\Execution\Completion\CompletionKind;
47use Deriver\Deriver\Evaluator\Execution\Completion\Quality\DependencyClosure;
48use Deriver\Deriver\Evaluator\Execution\Completion\StorageSnapshot;
49use Deriver\Deriver\Evaluator\Execution\Constant\ClassNames;
50use Deriver\Deriver\Evaluator\Execution\Context;
51use Deriver\Deriver\Evaluator\Execution\Control\ExceptionChain;
52use Deriver\Deriver\Evaluator\Execution\Control\ExceptionMatch;
53use Deriver\Deriver\Evaluator\Execution\Control\Handler;
54use Deriver\Deriver\Evaluator\Execution\Control\ObservationLimit;
55use Deriver\Deriver\Evaluator\Execution\Control\StateJoin;
56use Deriver\Deriver\Evaluator\Execution\Control\Unwinding;
57use Deriver\Deriver\Evaluator\Execution\Demand\Cell;
58use Deriver\Deriver\Evaluator\Execution\Demand\Components;
59use Deriver\Deriver\Evaluator\Execution\Demand\Discovery;
60use Deriver\Deriver\Evaluator\Execution\Demand\Key;
61use Deriver\Deriver\Evaluator\Execution\Demand\Table;
62use Deriver\Deriver\Evaluator\Execution\Dependencies;
63use Deriver\Deriver\Evaluator\Execution\Evaluator;
64use Deriver\Deriver\Evaluator\Execution\EvaluatorConfig as ExecutionEvaluatorConfig;
65use Deriver\Deriver\Evaluator\Execution\InstructionTransfer;
66use Deriver\Deriver\Evaluator\Execution\Memory\Location;
67use Deriver\Deriver\Evaluator\Execution\Memory\Materialization;
68use Deriver\Deriver\Evaluator\Execution\Memory\Memory;
69use Deriver\Deriver\Evaluator\Execution\Memory\ReferenceConstraint;
70use Deriver\Deriver\Evaluator\Execution\Memory\Slots\SlotReference;
71use Deriver\Deriver\Evaluator\Execution\Memory\Slots\StateStorage;
72use Deriver\Deriver\Evaluator\Execution\Memory\StorageCapture;
73use Deriver\Deriver\Evaluator\Execution\ObservationCollector;
74use Deriver\Deriver\Evaluator\Execution\Operation\Conversions;
75use Deriver\Deriver\Evaluator\Execution\Operation\ScalarErrors;
76use Deriver\Deriver\Evaluator\Execution\State;
77use Deriver\Deriver\Evaluator\Execution\Summary\CompletionRecord;
78use Deriver\Deriver\Evaluator\Execution\Summary\Evaluation;
79use Deriver\Deriver\Evaluator\Execution\Summary\Invocation as SummaryInvocation;
80use Deriver\Deriver\Evaluator\Execution\Summary\Isolation;
81use Deriver\Deriver\Evaluator\Execution\Trace\Derivation;
82use Deriver\Deriver\Evaluator\Execution\Transfer\CallableTransfer;
83use Deriver\Deriver\Evaluator\Execution\Transfer\ConstantTransfer;
84use Deriver\Deriver\Evaluator\Execution\Transfer\MemoryStep;
85use Deriver\Deriver\Evaluator\Execution\Transfer\ObjectAccess;
86use Deriver\Deriver\Evaluator\Execution\Transfer\PropertyAccessCheck;
87use Deriver\Deriver\Evaluator\Execution\Transfer\PropertyLookup;
88use Deriver\Deriver\Evaluator\Execution\Transfer\PropertyMagic;
89use Deriver\Deriver\Evaluator\Execution\Transfer\PropertySlot;
90use Deriver\Deriver\Evaluator\Execution\Transfer\PropertyTransfer;
91use Deriver\Deriver\Evaluator\Execution\Transfer\PureStep;
92use Deriver\Deriver\Evaluator\Execution\Transfer\ReferenceAssignment;
93use Deriver\Deriver\Evaluator\Request\Budget;
94use Deriver\Deriver\Evaluator\Request\EntryPoint;
95use Deriver\Deriver\Evaluator\Request\QueryScope;
96use Deriver\Deriver\Evaluator\Request\ReturnQuery;
97use Deriver\Deriver\Evaluator\Scalar\Arithmetic;
98use Deriver\Deriver\Evaluator\Scalar\Arrays;
99use Deriver\Deriver\Evaluator\Scalar\Identity;
100use Deriver\Deriver\Evaluator\Scalar\Operations;
101use Deriver\Deriver\Evaluator\TargetProfile;
102use Deriver\Deriver\Evaluator\Term;
103use Deriver\Deriver\Evaluator\TermKind;
104use Deriver\Deriver\Execution\DerivationResult;
105use Deriver\Deriver\Execution\QueryExecution;
106use Deriver\Deriver\Execution\ResultAssessment;
107use Deriver\Deriver\Identity\QueryEncoding;
108use Deriver\Deriver\Identity\ValueGraph;
109use Deriver\Deriver\Lowerer\AggregateLowering;
110use Deriver\Deriver\Lowerer\AssignmentLowering;
111use Deriver\Deriver\Lowerer\CallLowering;
112use Deriver\Deriver\Lowerer\Control\DestructuringLowering;
113use Deriver\Deriver\Lowerer\Control\ExceptionLowering;
114use Deriver\Deriver\Lowerer\Declaration\CallableIdentity;
115use Deriver\Deriver\Lowerer\Declaration\CallableSource;
116use Deriver\Deriver\Lowerer\Declaration\ConstantSignatures;
117use Deriver\Deriver\Lowerer\Declaration\Index;
118use Deriver\Deriver\Lowerer\Declaration\Indexer;
119use Deriver\Deriver\Lowerer\Declaration\Metadata\ClassConstant;
120use Deriver\Deriver\Lowerer\Declaration\Metadata\ClassDeclaration;
121use Deriver\Deriver\Lowerer\Declaration\Metadata\PropertyDeclaration;
122use Deriver\Deriver\Lowerer\Declaration\Traits\Composition;
123use Deriver\Deriver\Lowerer\Declaration\Traits\LexicalConstants;
124use Deriver\Deriver\Lowerer\Declaration\Traits\Members;
125use Deriver\Deriver\Lowerer\EffectInspection;
126use Deriver\Deriver\Lowerer\ExpressionLowering;
127use Deriver\Deriver\Lowerer\Graph\BasicBlock;
128use Deriver\Deriver\Lowerer\Graph\CallableGraph;
129use Deriver\Deriver\Lowerer\Graph\CatchTarget;
130use Deriver\Deriver\Lowerer\Graph\ExceptionRegion;
131use Deriver\Deriver\Lowerer\Graph\Instruction;
132use Deriver\Deriver\Lowerer\Graph\Literal;
133use Deriver\Deriver\Lowerer\Graph\Parameter;
134use Deriver\Deriver\Lowerer\Graph\Program;
135use Deriver\Deriver\Lowerer\Graph\Terminator;
136use Deriver\Deriver\Lowerer\Graph\TerminatorKind;
137use Deriver\Deriver\Lowerer\Hierarchy\Access as HierarchyAccess;
138use Deriver\Deriver\Lowerer\Hierarchy\Builtins;
139use Deriver\Deriver\Lowerer\Hierarchy\Dispatch;
140use Deriver\Deriver\Lowerer\InstructionEmitter;
141use Deriver\Deriver\Lowerer\Lowerer;
142use Deriver\Deriver\Lowerer\LoweringScope;
143use Deriver\Deriver\Lowerer\StatementLowering;
144use Deriver\Deriver\MicroEvaluatorConversion;
145use Deriver\Deriver\Parser\Node\File;
146use Deriver\Deriver\Parser\Parser;
147use Deriver\Deriver\Parser\ParserConfig;
148use Deriver\Deriver\Parser\TargetSyntax;
149use Deriver\Deriver\Providers\ProviderExpansion;
150use Deriver\Deriver\Resolver\AssignmentPatterns;
151use Deriver\Deriver\Resolver\ClassScope;
152use Deriver\Deriver\Resolver\ExpressionValidation;
153use Deriver\Deriver\Resolver\MagicContext;
154use Deriver\Deriver\Resolver\Resolver;
155use Deriver\Deriver\Selection\QueryValidation;
156use Deriver\Deriver\SnapshotIdentity;
157use Deriver\Deriver\Sources\LineMap;
158use Deriver\Deriver\Sources\Path;
159use Deriver\Deriver\Sources\Source;
160use Deriver\Deriver\Sources\SourceRef;
161use Deriver\Deriver\Sources\Sources;
162use Deriver\Exception\ParserException;
163use Deriver\Exception\ResolutionException;
164use JsonException;
165use PHPUnit\Framework\Attributes\CoversClass;
166use PHPUnit\Framework\Attributes\DataProvider;
167use PHPUnit\Framework\Attributes\Small;
168use PHPUnit\Framework\Attributes\UsesClass;
169use PHPUnit\Framework\TestCase;
170
171/**
172 * @covers \Deriver\Deriver\Evaluator\Execution\Transfer\ConstantTransfer
173 */
174#[UsesClass(Resolver::class)]
175#[UsesClass(ExpressionValidation::class)]
176#[UsesClass(ResolutionException::class)]
177#[UsesClass(ParserConfig::class)]
178#[UsesClass(ParserException::class)]
179#[CoversClass(ConstantTransfer::class)]
180#[UsesClass(QueryExecution::class)]
181#[UsesClass(QueryValidation::class)]
182#[UsesClass(ResultAssessment::class)]
183#[UsesClass(Deriver::class)]
184#[UsesClass(BasicBlock::class)]
185#[UsesClass(CallableGraph::class)]
186#[UsesClass(CallableIdentity::class)]
187#[UsesClass(CatchTarget::class)]
188#[UsesClass(ClassConstant::class)]
189#[UsesClass(ClassDeclaration::class)]
190#[UsesClass(ExceptionRegion::class)]
191#[UsesClass(Instruction::class)]
192#[UsesClass(Parameter::class)]
193#[UsesClass(PropertyDeclaration::class)]
194#[UsesClass(Terminator::class)]
195#[UsesClass(Allocation::class)]
196#[UsesClass(ArgumentBinding::class)]
197#[UsesClass(ArgumentOrder::class)]
198#[UsesClass(CallExecutor::class)]
199#[UsesClass(CallResolution::class)]
200#[UsesClass(CallableCheck::class)]
201#[UsesClass(Access::class)]
202#[UsesClass(Builtins::class)]
203#[UsesClass(Dispatch::class)]
204#[UsesClass(HierarchyAccess::class)]
205#[UsesClass(Constants::class)]
206#[UsesClass(Invocation::class)]
207#[UsesClass(MethodInvocation::class)]
208#[UsesClass(NativeInvocation::class)]
209#[UsesClass(Properties::class)]
210#[UsesClass(Signatures::class)]
211#[UsesClass(ParameterBinding::class)]
212#[UsesClass(PassedArgument::class)]
213#[UsesClass(Creation::class)]
214#[UsesClass(Methods::class)]
215#[UsesClass(Resolution::class)]
216#[UsesClass(Target::class)]
217#[UsesClass(Transfer::class)]
218#[UsesClass(TypeBinding::class)]
219#[UsesClass(TypeCheck::class)]
220#[UsesClass(Completion::class)]
221#[UsesClass(ClassNames::class)]
222#[UsesClass(Context::class)]
223#[UsesClass(ExceptionChain::class)]
224#[UsesClass(ExceptionMatch::class)]
225#[UsesClass(Handler::class)]
226#[UsesClass(ObservationLimit::class)]
227#[UsesClass(StateJoin::class)]
228#[UsesClass(Unwinding::class)]
229#[UsesClass(Cell::class)]
230#[UsesClass(Components::class)]
231#[UsesClass(Discovery::class)]
232#[UsesClass(Key::class)]
233#[UsesClass(Table::class)]
234#[UsesClass(Dependencies::class)]
235#[UsesClass(InstructionTransfer::class)]
236#[UsesClass(Evaluator::class)]
237#[UsesClass(SlotReference::class)]
238#[UsesClass(StateStorage::class)]
239#[UsesClass(ObservationCollector::class)]
240#[UsesClass(Conversions::class)]
241#[UsesClass(ScalarErrors::class)]
242#[UsesClass(State::class)]
243#[UsesClass(CompletionRecord::class)]
244#[UsesClass(Evaluation::class)]
245#[UsesClass(SummaryInvocation::class)]
246#[UsesClass(Isolation::class)]
247#[UsesClass(CallableTransfer::class)]
248#[UsesClass(MemoryStep::class)]
249#[UsesClass(ObjectAccess::class)]
250#[UsesClass(PropertyAccessCheck::class)]
251#[UsesClass(PropertyLookup::class)]
252#[UsesClass(PropertyMagic::class)]
253#[UsesClass(PropertySlot::class)]
254#[UsesClass(PropertyTransfer::class)]
255#[UsesClass(PureStep::class)]
256#[UsesClass(ReferenceAssignment::class)]
257#[UsesClass(Location::class)]
258#[UsesClass(Materialization::class)]
259#[UsesClass(Memory::class)]
260#[UsesClass(ReferenceConstraint::class)]
261#[UsesClass(StorageCapture::class)]
262#[UsesClass(DispatchDecision::class)]
263#[UsesClass(Extensions::class)]
264#[UsesClass(ProviderExpansion::class)]
265#[UsesClass(Evaluators::class)]
266#[UsesClass(StateRegistry::class)]
267#[UsesClass(DeriverConfig::class)]
268#[UsesClass(EntryPoint::class)]
269#[UsesClass(Sources::class)]
270#[UsesClass(Path::class)]
271#[UsesClass(Snapshot::class)]
272#[UsesClass(Source::class)]
273#[UsesClass(TargetProfile::class)]
274#[UsesClass(Budget::class)]
275#[UsesClass(QueryScope::class)]
276#[UsesClass(ReturnQuery::class)]
277#[UsesClass(ResultRef::class)]
278#[UsesClass(SourceRef::class)]
279#[UsesClass(Alternative::class)]
280#[UsesClass(Assessment::class)]
281#[UsesClass(Derivation::class)]
282#[UsesClass(DerivationResult::class)]
283#[UsesClass(Frontier::class)]
284#[UsesClass(QueryEncoding::class)]
285#[UsesClass(ValueGraph::class)]
286#[UsesClass(Statistics::class)]
287#[UsesClass(StorageSnapshot::class)]
288#[UsesClass(Parser::class)]
289#[UsesClass(File::class)]
290#[UsesClass(AggregateLowering::class)]
291#[UsesClass(AssignmentLowering::class)]
292#[UsesClass(CallLowering::class)]
293#[UsesClass(Lowerer::class)]
294#[UsesClass(DestructuringLowering::class)]
295#[UsesClass(ExceptionLowering::class)]
296#[UsesClass(EffectInspection::class)]
297#[UsesClass(ExpressionLowering::class)]
298#[UsesClass(InstructionEmitter::class)]
299#[UsesClass(LoweringScope::class)]
300#[UsesClass(StatementLowering::class)]
301#[UsesClass(ConstantSignatures::class)]
302#[UsesClass(CallableSource::class)]
303#[UsesClass(Indexer::class)]
304#[UsesClass(Index::class)]
305#[UsesClass(Composition::class)]
306#[UsesClass(LexicalConstants::class)]
307#[UsesClass(Members::class)]
308#[UsesClass(LineMap::class)]
309#[UsesClass(MagicContext::class)]
310#[UsesClass(AssignmentPatterns::class)]
311#[UsesClass(ClassScope::class)]
312#[UsesClass(TargetSyntax::class)]
313#[UsesClass(Arithmetic::class)]
314#[UsesClass(Arrays::class)]
315#[UsesClass(Identity::class)]
316#[UsesClass(Operations::class)]
317#[UsesClass(Term::class)]
318#[Small]
319final class ConstantTransferTest extends TestCase
320{
321    public function testApplyEvaluatesCapturedConstantExpressions(): void
322    {
323        $source = '<?php const BASE=20;const ANSWER=BASE*2+2;function target(){return ANSWER;}';
324        $symbol = 'target';
325        $input = new Sources([new Source('fixture.php', $source)]);
326        $configuration = new DeriverConfig();
327        $contributions = new Contributions();
328        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
329        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
330        $contributions1 = $providers->contributions;
331        $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);
332        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
333        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
334        $snapshotId = $identity->id;
335        $input1 = $providers->input;
336        $parser = new Parser(new ParserConfig($target->version));
337        $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));
338        $program = new Index($snapshotId, $trees);
339        $result = (new QueryExecution($program, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program->diagnostics()))))->derive(new ReturnQuery($symbol));
340        self::assertSame([], $result->frontiers);
341        self::assertSame([], $result->exceptionalOutcomes);
342        self::assertCount(1, $result->normalOutcomes);
343        self::assertSame(42, $result->normalOutcomes[0]->values['return']->native());
344    }
345    public function testMemberChecksAccessBeforeReturningAnInitializer(): void
346    {
347        $source = '<?php class Box{private const A=1;}function target(){try{return Box::A;}catch(Error $e){return 2;}}';
348        $symbol = 'target';
349        $input = new Sources([new Source('fixture.php', $source)]);
350        $configuration = new DeriverConfig();
351        $contributions = new Contributions();
352        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
353        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
354        $contributions1 = $providers->contributions;
355        $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);
356        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
357        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
358        $snapshotId = $identity->id;
359        $input1 = $providers->input;
360        $parser = new Parser(new ParserConfig($target->version));
361        $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));
362        $program = new Index($snapshotId, $trees);
363        $result = (new QueryExecution($program, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program->diagnostics()))))->derive(new ReturnQuery($symbol));
364        self::assertSame(2, $result->normalOutcomes[0]->values['return']->native());
365    }
366    public function testInitializerBuildsAnEnumFromItsBackingExpression(): void
367    {
368        $source = '<?php enum Flag:int{case A=1+2;}function target(){return Flag::A->value;}';
369        $symbol = 'target';
370        $input = new Sources([new Source('fixture.php', $source)]);
371        $configuration = new DeriverConfig();
372        $contributions = new Contributions();
373        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
374        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
375        $contributions1 = $providers->contributions;
376        $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);
377        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
378        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
379        $snapshotId = $identity->id;
380        $input1 = $providers->input;
381        $parser = new Parser(new ParserConfig($target->version));
382        $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));
383        $program = new Index($snapshotId, $trees);
384        $result = (new QueryExecution($program, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program->diagnostics()))))->derive(new ReturnQuery($symbol));
385        self::assertSame(3, $result->normalOutcomes[0]->values['return']->native());
386    }
387    /**
388     * @throws JsonException If fixture metadata cannot be encoded
389     */
390    #[DataProvider('providerProgramsClassNameProgramscases')]
391    public function testMemberPreservesOracleCheckedClassNameAndConstantSemantics(string $source, string $expected): void
392    {
393        $symbol = 'target';
394        $input = new Sources([new Source('fixture.php', $source)]);
395        $configuration = new DeriverConfig();
396        $contributions = new Contributions();
397        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
398        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
399        $contributions1 = $providers->contributions;
400        $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);
401        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
402        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
403        $snapshotId = $identity->id;
404        $input1 = $providers->input;
405        $parser = new Parser(new ParserConfig($target->version));
406        $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));
407        $program = new Index($snapshotId, $trees);
408        $result = (new QueryExecution($program, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program->diagnostics()))))->derive(new ReturnQuery($symbol));
409        self::assertSame([], $result->frontiers);
410        self::assertSame([], $result->sourceDiagnostics);
411        self::assertSame([], $result->exceptionalOutcomes);
412        self::assertCount(1, $result->normalOutcomes);
413        self::assertSame(json_decode($expected, true, flags: JSON_THROW_ON_ERROR), $result->normalOutcomes[0]->values['return']->native());
414    }
415    public function testMemberKeepsUnavailableDynamicClassLookupsExplicit(): void
416    {
417        $source = '<?php function target(){$name="class";return Missing::{$name};}';
418        $symbol = 'target';
419        $input = new Sources([new Source('fixture.php', $source)]);
420        $configuration = new DeriverConfig();
421        $contributions = new Contributions();
422        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
423        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
424        $contributions1 = $providers->contributions;
425        $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);
426        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
427        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
428        $snapshotId = $identity->id;
429        $input1 = $providers->input;
430        $parser = new Parser(new ParserConfig($target->version));
431        $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));
432        $program = new Index($snapshotId, $trees);
433        $result = (new QueryExecution($program, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program->diagnostics()))))->derive(new ReturnQuery($symbol));
434        self::assertSame(DependencyClosure::Open, $result->assessment->closure);
435        self::assertCount(1, $result->normalOutcomes);
436        self::assertSame(TermKind::Opaque, $result->normalOutcomes[0]->values['return']->kind);
437        self::assertContains('INCOMPLETE_SOURCE', array_column($result->frontiers, 'code'));
438    }
439    public function testFinishRetainsTheExactClassValueAndExistingState(): void
440    {
441        $source1 = '<?php function target(){return 1;}';
442        $budget = new Budget();
443        $configuration = new DeriverConfig();
444        $contributions = new Contributions();
445        $input = new Sources([new Source('fixture.php', $source1)]);
446        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
447        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
448        $contributions1 = $providers->contributions;
449        $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);
450        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
451        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
452        $snapshotId = $identity->id;
453        $input1 = $providers->input;
454        $parser = new Parser(new ParserConfig($target->version));
455        $trees = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input1, false));
456        $program1 = new Index($snapshotId, $trees);
457        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
458        $snapshotId1 = 'test';
459        $input2 = new Sources([new Source('fixture.php', $source1)]);
460        $profile = $execution->configuration->target;
461        $parser1 = new Parser(new ParserConfig($profile->version));
462        $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($input2, false));
463        $program = new Index($snapshotId1, $trees1);
464        $context = new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators);
465        $state = new State();
466        $source = new SourceRef('snapshot', 'class.php', 4, 18);
467        $instruction = new BoundInstruction('fetch', 'class-constant', $source, 'result');
468        $value = Term::constant('Box');
469        $paths = (new ConstantTransfer(new Evaluator($context)))->finish($instruction, $state, $value);
470        self::assertSame([$state], $paths);
471        self::assertSame($value, $paths[0]->registers['result']);
472        self::assertSame(CompletionKind::Normal, $paths[0]->completion->kind);
473        self::assertSame([], $context->frontiers);
474    }
475    public function testFinishPropagatesClassResolutionErrorsWithoutWritingAValue(): void
476    {
477        $source = '<?php function target(){return 1;}';
478        $budget = new Budget();
479        $configuration = new DeriverConfig();
480        $contributions = new Contributions();
481        $input = new Sources([new Source('fixture.php', $source)]);
482        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
483        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
484        $contributions1 = $providers->contributions;
485        $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);
486        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
487        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
488        $snapshotId = $identity->id;
489        $input1 = $providers->input;
490        $parser = new Parser(new ParserConfig($target->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($input1, false));
492        $program1 = new Index($snapshotId, $trees);
493        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
494        $snapshotId1 = 'test';
495        $input2 = new Sources([new Source('fixture.php', $source)]);
496        $profile = $execution->configuration->target;
497        $parser1 = new Parser(new ParserConfig($profile->version));
498        $trees1 = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser1->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input2, false));
499        $program = new Index($snapshotId1, $trees1);
500        $context = new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators);
501        $state = new State();
502        $instruction = new BoundInstruction('fetch', 'class-constant', new SourceRef('snapshot', 'class.php', 4, 18), 'result');
503        $error = new Term(TermKind::Throwable, 'TypeError');
504        $paths = (new ConstantTransfer(new Evaluator($context)))->finish($instruction, $state, $error);
505        self::assertSame([$state], $paths);
506        self::assertSame(CompletionKind::Throw, $paths[0]->completion->kind);
507        self::assertSame($error, $paths[0]->completion->value);
508        self::assertArrayNotHasKey('result', $paths[0]->registers);
509    }
510    public function testFinishRecordsTheUnresolvedClassDependencyAtItsSource(): void
511    {
512        $source1 = '<?php function target(){return 1;}';
513        $budget = new Budget();
514        $configuration = new DeriverConfig();
515        $contributions = new Contributions();
516        $input = new Sources([new Source('fixture.php', $source1)]);
517        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
518        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
519        $contributions1 = $providers->contributions;
520        $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);
521        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
522        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
523        $snapshotId = $identity->id;
524        $input1 = $providers->input;
525        $parser = new Parser(new ParserConfig($target->version));
526        $trees = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input1, false));
527        $program1 = new Index($snapshotId, $trees);
528        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
529        $snapshotId1 = 'test';
530        $input2 = new Sources([new Source('fixture.php', $source1)]);
531        $profile = $execution->configuration->target;
532        $parser1 = new Parser(new ParserConfig($profile->version));
533        $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($input2, false));
534        $program = new Index($snapshotId1, $trees1);
535        $context = new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators);
536        $source = new SourceRef('snapshot', 'class.php', 4, 18);
537        $instruction = new BoundInstruction('fetch', 'class-constant', $source, 'result');
538        $dependency = Term::parameter('class');
539        $value = Term::opaque('INCOMPLETE_SOURCE', dependencies: [$dependency]);
540        $paths = (new ConstantTransfer(new Evaluator($context)))->finish($instruction, new State(), $value);
541        self::assertSame(TermKind::Opaque, $paths[0]->registers['result']->kind);
542        self::assertSame('INCOMPLETE_SOURCE', $paths[0]->registers['result']->literal);
543        self::assertCount(1, $context->frontiers);
544        $frontier = array_values($context->frontiers)[0];
545        self::assertSame('INCOMPLETE_SOURCE', $frontier->code);
546        self::assertSame('dynamic-class-constant', $frontier->operation);
547        self::assertSame($source, $frontier->at);
548        self::assertNotNull($frontier->residual);
549        self::assertSame([$dependency], $frontier->residual->operands);
550    }
551    /**
552     * @param list<string> $completions Expected path completions
553     * @param list<string> $kinds Result or exception categories
554     * @param list<int|float|string|bool|null> $literals Result or exception values
555     */
556    #[DataProvider('providerInitializerResults')]
557    public function testInitializerChecksDeclaredTypesAndConstructsEnumIdentity(Term $value, ?ClassConstant $constant, array $completions, array $kinds, array $literals): void
558    {
559        $source = new SourceRef('snapshot', 'constants.php', 4, 20);
560        $body = new CallableGraph('Box::VALUE:initializer', [], [new BasicBlock(0, [new BoundInstruction('value', 'constant', $source, 'value', constant: $value)], new Terminator(TerminatorKind::Return, 'value'))], $source);
561        $program = self::createStub(Program::class);
562        $program->method('constant')->willReturn($body);
563        $configuration = new DeriverConfig();
564        $source1 = '<?php function target(){return 1;}';
565        $budget = new Budget();
566        $contributions = new Contributions();
567        $input = new Sources([new Source('fixture.php', $source1)]);
568        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
569        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
570        $contributions1 = $providers->contributions;
571        $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);
572        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
573        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
574        $snapshotId = $identity->id;
575        $input1 = $providers->input;
576        $parser = new Parser(new ParserConfig($target->version));
577        $trees = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input1, false));
578        $program2 = new Index($snapshotId, $trees);
579        $execution = new QueryExecution($program2, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program2->diagnostics())));
580        $snapshotId1 = 'test';
581        $input2 = new Sources([new Source('fixture.php', $source1)]);
582        $profile = $execution->configuration->target;
583        $parser1 = new Parser(new ParserConfig($profile->version));
584        $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($input2, false));
585        $program1 = new Index($snapshotId1, $trees1);
586        $contributions2 = new Contributions();
587        $context = new Context($program, new ReturnQuery('target'), (new Context($program1, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators))->configuration, new Evaluators(new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision), new Registrations($contributions2->evaluators, $contributions2->providers, $contributions2->domains, $contributions2->intrinsics, $contributions2->stateSlots), $configuration->standardEvaluators));
588        $state = new State();
589        $marker = $state->memory->allocate(Term::constant('retained'));
590        $instruction = new BoundInstruction('fetch', 'class-constant', $source, 'result');
591        $paths = (new ConstantTransfer(new Evaluator($context)))->initializer('Box::VALUE', $instruction, $state, $constant);
592        self::assertSame($completions, array_map(static fn (State $path): string => $path->completion->kind->value, $paths));
593        self::assertSame($kinds, array_map(static fn (State $path): string => ($path->completion->value ?? $path->value('result'))->kind->value, $paths));
594        self::assertSame($literals, array_map(static fn (State $path) => ($path->completion->value ?? $path->value('result'))->literal, $paths));
595        self::assertSame('retained', $paths[0]->memory->read($marker)->literal);
596        self::assertNotSame($state, $paths[0]);
597        self::assertNotSame($state->memory, $paths[0]->memory);
598        self::assertArrayNotHasKey('result', $state->registers);
599    }
600    /**
601     * @return iterable<string,array{Term,ClassConstant|null,list<string>,list<string>,list<int|float|string|bool|null>}>
602     */
603    public static function providerInitializerResults(): iterable
604    {
605        yield 'untyped global' => [Term::constant('value'), null, ['normal'], ['constant'], ['value']];
606        yield 'integer' => [Term::constant(7), new ClassConstant('Box', 'VALUE', type: 'int'), ['normal'], ['constant'], [7]];
607        yield 'strict scalar mismatch' => [Term::constant('7'), new ClassConstant('Box', 'VALUE', type: 'int'), ['throw'], ['throwable'], ['TypeError']];
608        yield 'integer float widening' => [Term::constant(7), new ClassConstant('Box', 'VALUE', type: 'float'), ['normal'], ['constant'], [7.0]];
609        yield 'symbolic type split' => [Term::parameter('value'), new ClassConstant('Box', 'VALUE', type: 'int'), ['throw', 'normal'], ['throwable', 'type-refinement'], ['TypeError', 'int']];
610        yield 'backed enum' => [Term::constant('token'), new ClassConstant('Mode', 'Ready', type: 'string', enum: true), ['normal'], ['enum'], ['Mode::Ready']];
611        yield 'invalid backing type' => [Term::constant('token'), new ClassConstant('Mode', 'Ready', type: 'int', enum: true), ['throw'], ['throwable'], ['TypeError']];
612    }
613    public function testInitializerRetainsEnumCaseNameBackingValueAndDeclaringClass(): void
614    {
615        $source1 = '<?php enum Mode:string{case Ready="token";} function target(){}';
616        $budget = new Budget();
617        $configuration = new DeriverConfig();
618        $contributions = new Contributions();
619        $input = new Sources([new Source('fixture.php', $source1)]);
620        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
621        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
622        $contributions1 = $providers->contributions;
623        $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);
624        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
625        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
626        $snapshotId = $identity->id;
627        $input1 = $providers->input;
628        $parser = new Parser(new ParserConfig($target->version));
629        $trees = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input1, false));
630        $program1 = new Index($snapshotId, $trees);
631        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
632        $snapshotId1 = 'test';
633        $input2 = new Sources([new Source('fixture.php', $source1)]);
634        $profile = $execution->configuration->target;
635        $parser1 = new Parser(new ParserConfig($profile->version));
636        $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($input2, false));
637        $program = new Index($snapshotId1, $trees1);
638        $context = new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators);
639        $source = new SourceRef('snapshot', 'constants.php', 4, 20);
640        $paths = (new ConstantTransfer(new Evaluator($context)))->initializer('Mode::Ready', new BoundInstruction('fetch', 'class-constant', $source, 'result'), new State(), new ClassConstant('Mode', 'Ready', type: 'string', enum: true));
641        self::assertCount(1, $paths);
642        $result = $paths[0]->registers['result'];
643        self::assertSame(TermKind::Enum, $result->kind);
644        self::assertSame('Mode::Ready', $result->literal);
645        self::assertSame(['class' => 'Mode'], $result->attributes);
646        self::assertSame('Ready', $result->operands['name']->literal);
647        self::assertSame('token', $result->operands['value']->literal);
648    }
649    public function testInitializerPropagatesFailureBeforeEnforcingTheConstantType(): void
650    {
651        $source = new SourceRef('snapshot', 'constants.php', 4, 20);
652        $error = new Term(TermKind::Throwable, 'RuntimeException');
653        $body = new CallableGraph('Box::VALUE:initializer', [], [new BasicBlock(0, [new BoundInstruction('error', 'constant', $source, 'error', constant: $error)], new Terminator(TerminatorKind::Throw, 'error'))], $source);
654        $program = self::createStub(Program::class);
655        $program->method('constant')->willReturn($body);
656        $configuration = new DeriverConfig();
657        $source1 = '<?php function target(){return 1;}';
658        $budget = new Budget();
659        $contributions = new Contributions();
660        $input = new Sources([new Source('fixture.php', $source1)]);
661        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
662        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
663        $contributions1 = $providers->contributions;
664        $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);
665        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
666        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
667        $snapshotId = $identity->id;
668        $input1 = $providers->input;
669        $parser = new Parser(new ParserConfig($target->version));
670        $trees = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input1, false));
671        $program2 = new Index($snapshotId, $trees);
672        $execution = new QueryExecution($program2, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program2->diagnostics())));
673        $snapshotId1 = 'test';
674        $input2 = new Sources([new Source('fixture.php', $source1)]);
675        $profile = $execution->configuration->target;
676        $parser1 = new Parser(new ParserConfig($profile->version));
677        $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($input2, false));
678        $program1 = new Index($snapshotId1, $trees1);
679        $contributions2 = new Contributions();
680        $context = new Context($program, new ReturnQuery('target'), (new Context($program1, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators))->configuration, new Evaluators(new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision), new Registrations($contributions2->evaluators, $contributions2->providers, $contributions2->domains, $contributions2->intrinsics, $contributions2->stateSlots), $configuration->standardEvaluators));
681        $paths = (new ConstantTransfer(new Evaluator($context)))->initializer('Box::VALUE', new BoundInstruction('fetch', 'class-constant', $source, 'result'), new State(), new ClassConstant('Box', 'VALUE', type: 'int'));
682        self::assertCount(1, $paths);
683        self::assertSame(CompletionKind::Throw, $paths[0]->completion->kind);
684        self::assertSame($error, $paths[0]->completion->value);
685        self::assertArrayNotHasKey('result', $paths[0]->registers);
686    }
687    #[DataProvider('providerFallbackConstants')]
688    public function testInitializerUsesCapturedAndBuiltinFallbacksWithoutExecutingMissingBodies(string $symbol, ?ClassConstant $constant, Term $expected): void
689    {
690        $program = self::createStub(Program::class);
691        $program->method('classes')->willReturn(['box' => new ClassDeclaration('Box', constants: ['VALUE' => Literal::constant('captured')])]);
692        $configuration = new DeriverConfig();
693        $source1 = '<?php function target(){return 1;}';
694        $budget = new Budget();
695        $contributions = new Contributions();
696        $input = new Sources([new Source('fixture.php', $source1)]);
697        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
698        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
699        $contributions1 = $providers->contributions;
700        $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);
701        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
702        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
703        $snapshotId = $identity->id;
704        $input1 = $providers->input;
705        $parser = new Parser(new ParserConfig($target->version));
706        $trees = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input1, false));
707        $program2 = new Index($snapshotId, $trees);
708        $execution = new QueryExecution($program2, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program2->diagnostics())));
709        $snapshotId1 = 'test';
710        $input2 = new Sources([new Source('fixture.php', $source1)]);
711        $profile = $execution->configuration->target;
712        $parser1 = new Parser(new ParserConfig($profile->version));
713        $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($input2, false));
714        $program1 = new Index($snapshotId1, $trees1);
715        $contributions2 = new Contributions();
716        $context = new Context($program, new ReturnQuery('target'), (new Context($program1, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators))->configuration, new Evaluators(new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision), new Registrations($contributions2->evaluators, $contributions2->providers, $contributions2->domains, $contributions2->intrinsics, $contributions2->stateSlots), $configuration->standardEvaluators));
717        $source = new SourceRef('snapshot', 'constants.php', 4, 20);
718        $state = new State();
719        $paths = (new ConstantTransfer(new Evaluator($context)))->initializer($symbol, new BoundInstruction('fetch', 'constant-name', $source, 'result'), $state, $constant);
720        self::assertSame([$state], $paths);
721        self::assertSame($expected->kind->value, $state->registers['result']->kind->value);
722        self::assertSame($expected->literal, $state->registers['result']->literal);
723    }
724    /**
725     * @return iterable<string,array{string,ClassConstant|null,Term}>
726     */
727    public static function providerFallbackConstants(): iterable
728    {
729        yield 'integer width' => ['PHP_INT_SIZE', null, Term::constant(8)];
730        yield 'class captured value' => ['Box::VALUE', new ClassConstant('Box', 'VALUE'), Term::constant('captured')];
731        yield 'class missing value' => ['Box::Missing', new ClassConstant('Box', 'Missing'), Term::opaque('INCOMPLETE_SOURCE')];
732    }
733    /**
734     * @param array<string,scalar|null> $attributes Class resolution syntax
735     */
736    #[DataProvider('providerDynamicMembers')]
737    public function testMemberPreservesResolutionErrorsAndClassNames(Term $class, Term $name, array $attributes, string $completion, string $kind, int|string $literal): void
738    {
739        $source1 = '<?php class Box { public const VALUE=7; private const HIDDEN=9; } function target(){}';
740        $budget = new Budget();
741        $configuration = new DeriverConfig();
742        $contributions = new Contributions();
743        $input = new Sources([new Source('fixture.php', $source1)]);
744        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
745        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
746        $contributions1 = $providers->contributions;
747        $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);
748        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
749        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
750        $snapshotId = $identity->id;
751        $input1 = $providers->input;
752        $parser = new Parser(new ParserConfig($target->version));
753        $trees = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input1, false));
754        $program1 = new Index($snapshotId, $trees);
755        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
756        $snapshotId1 = 'test';
757        $input2 = new Sources([new Source('fixture.php', $source1)]);
758        $profile = $execution->configuration->target;
759        $parser1 = new Parser(new ParserConfig($profile->version));
760        $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($input2, false));
761        $program = new Index($snapshotId1, $trees1);
762        $context = new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators);
763        $source = new SourceRef('snapshot', 'constants.php', 4, 20);
764        $state = new State();
765        $state->registers['class'] = $class;
766        $state->registers['name'] = $name;
767        $instruction = new BoundInstruction('fetch', 'class-constant', $source, 'result', ['class', 'name'], attributes: $attributes);
768        $paths = (new ConstantTransfer(new Evaluator($context)))->member(new CallableGraph('target', [], [], $source), $instruction, $state);
769        self::assertCount(1, $paths);
770        self::assertSame(CompletionKind::from($completion), $paths[0]->completion->kind);
771        $value = $paths[0]->completion->value ?? $paths[0]->value('result');
772        self::assertSame($kind, $value->kind->value);
773        self::assertSame($literal, $value->literal);
774    }
775    /**
776     * @return iterable<string,array{Term,Term,array<string,scalar|null>,string,string,int|string}>
777     */
778    public static function providerDynamicMembers(): iterable
779    {
780        yield 'ordinary' => [Term::constant('Box'), Term::constant('VALUE'), [], 'normal', 'constant', 7];
781        yield 'runtime class name' => [Term::constant('bOx'), Term::constant('class'), ['literal-class' => false, 'class-name' => false], 'normal', 'constant', 'Box'];
782        yield 'literal class spelling' => [Term::constant('bOx'), Term::constant('class'), ['literal-class' => true, 'class-name' => true], 'normal', 'constant', 'bOx'];
783        yield 'missing literal class spelling' => [Term::constant('Missing'), Term::constant('class'), ['class-name' => true], 'normal', 'constant', 'Missing'];
784        yield 'nonstring class' => [Term::constant(3), Term::constant('class'), ['literal-class' => false, 'class-name' => true], 'throw', 'throwable', 'TypeError'];
785        yield 'symbolic class' => [Term::parameter('class'), Term::constant('VALUE'), [], 'normal', 'opaque', 'UNSUPPORTED_LANGUAGE_FEATURE'];
786        yield 'symbolic name' => [Term::constant('Box'), Term::parameter('name'), [], 'normal', 'opaque', 'UNSUPPORTED_LANGUAGE_FEATURE'];
787        yield 'missing class' => [Term::constant('Missing'), Term::constant('VALUE'), [], 'normal', 'opaque', 'INCOMPLETE_SOURCE'];
788        yield 'missing member' => [Term::constant('Box'), Term::constant('MISSING'), [], 'throw', 'throwable', 'Error'];
789        yield 'inaccessible member' => [Term::constant('Box'), Term::constant('HIDDEN'), [], 'throw', 'throwable', 'Error'];
790    }
791    public function testMemberResolvesTheClassNameAndMemberSelector(): void
792    {
793        $source1 = '<?php class Box {} function target(){}';
794        $budget = new Budget();
795        $configuration = new DeriverConfig();
796        $contributions = new Contributions();
797        $input = new Sources([new Source('fixture.php', $source1)]);
798        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
799        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
800        $contributions1 = $providers->contributions;
801        $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);
802        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
803        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
804        $snapshotId = $identity->id;
805        $input1 = $providers->input;
806        $parser = new Parser(new ParserConfig($target->version));
807        $trees = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input1, false));
808        $program1 = new Index($snapshotId, $trees);
809        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
810        $snapshotId1 = 'test';
811        $input2 = new Sources([new Source('fixture.php', $source1)]);
812        $profile = $execution->configuration->target;
813        $parser1 = new Parser(new ParserConfig($profile->version));
814        $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($input2, false));
815        $program = new Index($snapshotId1, $trees1);
816        $context = new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators);
817        $source = new SourceRef('snapshot', 'constants.php', 4, 20);
818        $state = new State();
819        $state->registers['class'] = Term::constant('Box');
820        $state->registers['name'] = Term::constant('class');
821        $paths = (new ConstantTransfer(new Evaluator($context)))->member(new CallableGraph('target', [], [], $source), new BoundInstruction('fetch', 'class-constant', $source, 'result', ['class', 'name']), $state);
822        self::assertSame('Box', $paths[0]->registers['result']->literal);
823    }
824    /**
825     * @return array<string,array{string,string}> Captured source and independently checked JSON result
826     */
827    public static function providerProgramsClassNameProgramscases(): array
828    {
829        return ['literal missing class' => ['<?php function target(){return Missing::class;}', '"Missing"'], 'literal spelling' => ['<?php class Box{}function target(){return bOx::class;}', '"bOx"'], 'resolved namespace alias' => ['<?php namespace N{class Box{}}namespace{use N\Box as Alias;function target(){return Alias::class;}}', '"N\\\\Box"'], 'object class name' => ['<?php class Box{}function target(){$x=new Box;return $x::class;}', '"Box"'], 'canonical object class name' => ['<?php class Box{}function target(){$x=new bOx;return $x::class;}', '"Box"'], 'closure class name' => ['<?php function target(){$x=fn()=>1;return $x::class;}', '"Closure"'], 'enum class name' => ['<?php enum E{case A;}function target(){$x=E::A;return $x::class;}', '"E"'], 'native exception class name' => ['<?php function target(){$x=new RuntimeException;return $x::class;}', '"RuntimeException"'], 'string class name rejected' => ['<?php class Box{}function target(){$x="Box";try{return $x::class;}catch(TypeError $e){return "type";}}', '"type"'], 'array class name rejected' => ['<?php function target(){$x=[];try{return $x::class;}catch(TypeError $e){return "type";}}', '"type"'], 'integer class name rejected' => ['<?php function target(){$x=1;try{return $x::class;}catch(TypeError $e){return "type";}}', '"type"'], 'null class name rejected' => ['<?php function target(){$x=null;try{return $x::class;}catch(TypeError $e){return "type";}}', '"type"'], 'literal class dynamic name' => ['<?php class Box{}function target(){$name="class";return bOx::{$name};}', '"Box"'], 'string class dynamic name' => ['<?php class Box{}function target(){$class="bOx";$name="class";return $class::{$name};}', '"Box"'], 'object class dynamic name' => ['<?php class Box{}function target(){$class=new Box;$name="class";return $class::{$name};}', '"Box"'], 'object constant' => ['<?php class Box{const VALUE=3;}function target(){$x=new Box;return $x::VALUE;}', '3'], 'closure constant error' => ['<?php function target(){$x=fn()=>1;try{return $x::VALUE;}catch(Error $e){return "error";}}', '"error"'], 'unbound self closure' => ['<?php function target(){$f=fn()=>self::class;try{return $f();}catch(Error $e){return "error";}}', '"error"'], 'unbound parent closure' => ['<?php function target(){$f=fn()=>parent::class;try{return $f();}catch(Error $e){return "error";}}', '"error"'], 'unbound static closure' => ['<?php function target(){$f=fn()=>static::class;try{return $f();}catch(Error $e){return "error";}}', '"error"'], 'trait parent' => ['<?php trait T{function value(){return parent::class;}}class Base{}class Box extends Base{use T;}function target(){return (new Box)->value();}', '"Base"'], 'trait missing parent runtime' => ['<?php trait T{function value(){try{return parent::class;}catch(Error $e){return "error";}}}class Box{use T;}function target(){return (new Box)->value();}', '"error"'], 'late static class' => ['<?php class Base{static function value(){return [self::class,static::class];}}class Box extends Base{}function target(){return Box::value();}', '["Base","Box"]'], 'dynamic self constant' => ['<?php class Box{const VALUE=7;static function value(){$class="self";try{return $class::VALUE;}catch(Error $e){return "error";}}}function target(){return Box::value();}', '"error"'], 'dynamic parent constant' => ['<?php class Base{const VALUE=7;}class Box extends Base{static function value(){$class="parent";try{return $class::VALUE;}catch(Error $e){return "error";}}}function target(){return Box::value();}', '"error"'], 'dynamic static constant' => ['<?php class Box{const VALUE=7;static function value(){$class="static";try{return $class::VALUE;}catch(Error $e){return "error";}}}function target(){return Box::value();}', '"error"'], 'dynamic relative class keyword' => ['<?php class Box{static function value(){$class="self";$name="class";try{return $class::{$name};}catch(Error $e){return "error";}}}function target(){return Box::value();}', '"error"']];
830    }
831}
832