packages/deriver/tests/Unit/Deriver/Lowerer/Control/DestructuringLoweringTest.php

1<?php
2
3declare (strict_types=1);
4
5namespace Tests\Unit\Deriver\Lowerer\Control;
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\Builtin\FunctionEvaluator;
14use Deriver\Deriver\Evaluator\Builtin\Library;
15use Deriver\Deriver\Evaluator\Builtin\ScalarFunctions;
16use Deriver\Deriver\Evaluator\Call\ArgumentBindings;
17use Deriver\Deriver\Evaluator\Call\BoundArgument;
18use Deriver\Deriver\Evaluator\Call\CallDecision;
19use Deriver\Deriver\Evaluator\Call\CallDescription;
20use Deriver\Deriver\Evaluator\Call\CallDescriptor;
21use Deriver\Deriver\Evaluator\Call\Evaluators;
22use Deriver\Deriver\Evaluator\Call\Extensions;
23use Deriver\Deriver\Evaluator\Call\Plan\Action;
24use Deriver\Deriver\Evaluator\Call\Plan\Expression;
25use Deriver\Deriver\Evaluator\Call\Plan\PlanActions;
26use Deriver\Deriver\Evaluator\Call\Plan\PlanCompiler;
27use Deriver\Deriver\Evaluator\Call\Plan\PlanFootprints;
28use Deriver\Deriver\Evaluator\Call\Plan\PlanValidation;
29use Deriver\Deriver\Evaluator\Call\Plan\SemanticPlan;
30use Deriver\Deriver\Evaluator\Call\Registrations;
31use Deriver\Deriver\Evaluator\Call\StateRegistry;
32use Deriver\Deriver\Evaluator\Declaration\Parameter as DeclarationParameter;
33use Deriver\Deriver\Evaluator\Declaration\Signature;
34use Deriver\Deriver\Evaluator\EvaluatorConfig;
35use Deriver\Deriver\Evaluator\Evidence\Frontier;
36use Deriver\Deriver\Evaluator\Execution\Call\Allocation;
37use Deriver\Deriver\Evaluator\Execution\Call\ArgumentBinding;
38use Deriver\Deriver\Evaluator\Execution\Call\ArgumentOrder;
39use Deriver\Deriver\Evaluator\Execution\Call\CallableCheck;
40use Deriver\Deriver\Evaluator\Execution\Call\CallExecutor;
41use Deriver\Deriver\Evaluator\Execution\Call\CallResolution;
42use Deriver\Deriver\Evaluator\Execution\Call\Contract\Inputs;
43use Deriver\Deriver\Evaluator\Execution\Call\Contract\NativeArguments;
44use Deriver\Deriver\Evaluator\Execution\Call\Creation\Access;
45use Deriver\Deriver\Evaluator\Execution\Call\Member\Invocation;
46use Deriver\Deriver\Evaluator\Execution\Call\Native\Invocation as NativeInvocation;
47use Deriver\Deriver\Evaluator\Execution\Call\Native\Properties;
48use Deriver\Deriver\Evaluator\Execution\Call\Native\Signatures;
49use Deriver\Deriver\Evaluator\Execution\Call\ParameterBinding;
50use Deriver\Deriver\Evaluator\Execution\Call\PassedArgument;
51use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Arguments;
52use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Creation;
53use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Modes;
54use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Resolution;
55use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Target;
56use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Transfer;
57use Deriver\Deriver\Evaluator\Execution\Call\TypeBinding;
58use Deriver\Deriver\Evaluator\Execution\Call\TypeCheck;
59use Deriver\Deriver\Evaluator\Execution\Completion\Alternative;
60use Deriver\Deriver\Evaluator\Execution\Completion\Assessment;
61use Deriver\Deriver\Evaluator\Execution\Completion\Completion;
62use Deriver\Deriver\Evaluator\Execution\Completion\Exceptional;
63use Deriver\Deriver\Evaluator\Execution\Completion\StorageSnapshot;
64use Deriver\Deriver\Evaluator\Execution\Constraints;
65use Deriver\Deriver\Evaluator\Execution\Context;
66use Deriver\Deriver\Evaluator\Execution\Control\ExceptionChain;
67use Deriver\Deriver\Evaluator\Execution\Control\ExceptionMatch;
68use Deriver\Deriver\Evaluator\Execution\Control\Handler;
69use Deriver\Deriver\Evaluator\Execution\Control\IterationStep;
70use Deriver\Deriver\Evaluator\Execution\Control\IteratorCursor;
71use Deriver\Deriver\Evaluator\Execution\Control\LoopConvergence;
72use Deriver\Deriver\Evaluator\Execution\Control\ObservationLimit;
73use Deriver\Deriver\Evaluator\Execution\Control\StateJoin;
74use Deriver\Deriver\Evaluator\Execution\Control\Unwinding;
75use Deriver\Deriver\Evaluator\Execution\Demand\Cell;
76use Deriver\Deriver\Evaluator\Execution\Demand\Components;
77use Deriver\Deriver\Evaluator\Execution\Demand\Discovery;
78use Deriver\Deriver\Evaluator\Execution\Demand\Key;
79use Deriver\Deriver\Evaluator\Execution\Demand\Table;
80use Deriver\Deriver\Evaluator\Execution\Dependencies;
81use Deriver\Deriver\Evaluator\Execution\Evaluator;
82use Deriver\Deriver\Evaluator\Execution\EvaluatorConfig as ExecutionEvaluatorConfig;
83use Deriver\Deriver\Evaluator\Execution\InstructionTransfer;
84use Deriver\Deriver\Evaluator\Execution\Memory\LiveArray;
85use Deriver\Deriver\Evaluator\Execution\Memory\Location;
86use Deriver\Deriver\Evaluator\Execution\Memory\Materialization;
87use Deriver\Deriver\Evaluator\Execution\Memory\Memory;
88use Deriver\Deriver\Evaluator\Execution\Memory\ReferenceConstraint;
89use Deriver\Deriver\Evaluator\Execution\Memory\Slots\SlotReference;
90use Deriver\Deriver\Evaluator\Execution\Memory\Slots\StateStorage;
91use Deriver\Deriver\Evaluator\Execution\Memory\StorageCapture;
92use Deriver\Deriver\Evaluator\Execution\ObservationCollector;
93use Deriver\Deriver\Evaluator\Execution\Offset\Address;
94use Deriver\Deriver\Evaluator\Execution\Offset\Path;
95use Deriver\Deriver\Evaluator\Execution\Offset\Protocol;
96use Deriver\Deriver\Evaluator\Execution\Offset\ProtocolAccess;
97use Deriver\Deriver\Evaluator\Execution\Offset\Reader;
98use Deriver\Deriver\Evaluator\Execution\Offset\StringAccess;
99use Deriver\Deriver\Evaluator\Execution\Offset\Strings;
100use Deriver\Deriver\Evaluator\Execution\Offset\Transfer as OffsetTransfer;
101use Deriver\Deriver\Evaluator\Execution\Operation\Conversions;
102use Deriver\Deriver\Evaluator\Execution\Operation\ScalarErrors;
103use Deriver\Deriver\Evaluator\Execution\State;
104use Deriver\Deriver\Evaluator\Execution\Summary\CompletionRecord;
105use Deriver\Deriver\Evaluator\Execution\Summary\Evaluation;
106use Deriver\Deriver\Evaluator\Execution\Summary\Invocation as SummaryInvocation;
107use Deriver\Deriver\Evaluator\Execution\Summary\Isolation;
108use Deriver\Deriver\Evaluator\Execution\Trace\Derivation;
109use Deriver\Deriver\Evaluator\Execution\Transfer\CompoundAssignment;
110use Deriver\Deriver\Evaluator\Execution\Transfer\ConstantTransfer;
111use Deriver\Deriver\Evaluator\Execution\Transfer\IntrinsicTransfer;
112use Deriver\Deriver\Evaluator\Execution\Transfer\MemoryStep;
113use Deriver\Deriver\Evaluator\Execution\Transfer\ObjectAccess;
114use Deriver\Deriver\Evaluator\Execution\Transfer\PropertyAccessCheck;
115use Deriver\Deriver\Evaluator\Execution\Transfer\PropertyLookup;
116use Deriver\Deriver\Evaluator\Execution\Transfer\PropertyReference;
117use Deriver\Deriver\Evaluator\Execution\Transfer\PropertySlot;
118use Deriver\Deriver\Evaluator\Execution\Transfer\PropertyTransfer;
119use Deriver\Deriver\Evaluator\Execution\Transfer\PureStep;
120use Deriver\Deriver\Evaluator\Execution\Transfer\ReferenceAssignment;
121use Deriver\Deriver\Evaluator\Request\Budget;
122use Deriver\Deriver\Evaluator\Request\EntryPoint;
123use Deriver\Deriver\Evaluator\Request\QueryScope;
124use Deriver\Deriver\Evaluator\Request\ReturnQuery;
125use Deriver\Deriver\Evaluator\Scalar\Arithmetic;
126use Deriver\Deriver\Evaluator\Scalar\Arrays;
127use Deriver\Deriver\Evaluator\Scalar\Identity;
128use Deriver\Deriver\Evaluator\Scalar\Increment;
129use Deriver\Deriver\Evaluator\Scalar\NumericString;
130use Deriver\Deriver\Evaluator\Scalar\Operations;
131use Deriver\Deriver\Evaluator\TargetProfile;
132use Deriver\Deriver\Evaluator\Term;
133use Deriver\Deriver\Execution\DerivationResult;
134use Deriver\Deriver\Execution\QueryExecution;
135use Deriver\Deriver\Execution\ResultAssessment;
136use Deriver\Deriver\Identity\QueryEncoding;
137use Deriver\Deriver\Identity\ValueGraph;
138use Deriver\Deriver\Lowerer\AggregateLowering;
139use Deriver\Deriver\Lowerer\AssignmentLowering;
140use Deriver\Deriver\Lowerer\CallLowering;
141use Deriver\Deriver\Lowerer\Control\DestructuringLowering;
142use Deriver\Deriver\Lowerer\Control\ExceptionLowering;
143use Deriver\Deriver\Lowerer\Control\LoopLowering;
144use Deriver\Deriver\Lowerer\Declaration\CallableIdentity;
145use Deriver\Deriver\Lowerer\Declaration\CallableSource;
146use Deriver\Deriver\Lowerer\Declaration\ConstantSignatures;
147use Deriver\Deriver\Lowerer\Declaration\Index;
148use Deriver\Deriver\Lowerer\Declaration\Indexer;
149use Deriver\Deriver\Lowerer\Declaration\Metadata\ClassDeclaration;
150use Deriver\Deriver\Lowerer\Declaration\Metadata\PropertyDeclaration;
151use Deriver\Deriver\Lowerer\Declaration\Traits\Composition;
152use Deriver\Deriver\Lowerer\ExpressionLowering;
153use Deriver\Deriver\Lowerer\Graph\Argument;
154use Deriver\Deriver\Lowerer\Graph\BasicBlock;
155use Deriver\Deriver\Lowerer\Graph\CallableGraph;
156use Deriver\Deriver\Lowerer\Graph\CatchTarget;
157use Deriver\Deriver\Lowerer\Graph\ExceptionRegion;
158use Deriver\Deriver\Lowerer\Graph\Instruction;
159use Deriver\Deriver\Lowerer\Graph\Literal;
160use Deriver\Deriver\Lowerer\Graph\Parameter;
161use Deriver\Deriver\Lowerer\Graph\Terminator;
162use Deriver\Deriver\Lowerer\Hierarchy\Access as HierarchyAccess;
163use Deriver\Deriver\Lowerer\Hierarchy\Builtins;
164use Deriver\Deriver\Lowerer\Hierarchy\Dispatch;
165use Deriver\Deriver\Lowerer\InstructionEmitter;
166use Deriver\Deriver\Lowerer\Lowerer;
167use Deriver\Deriver\Lowerer\LoweringScope;
168use Deriver\Deriver\Lowerer\StatementLowering;
169use Deriver\Deriver\MicroEvaluatorConversion;
170use Deriver\Deriver\Parser\Node\File;
171use Deriver\Deriver\Parser\Parser;
172use Deriver\Deriver\Parser\ParserConfig;
173use Deriver\Deriver\Parser\TargetSyntax;
174use Deriver\Deriver\Providers\ProviderExpansion;
175use Deriver\Deriver\Resolver\AssignmentPatterns;
176use Deriver\Deriver\Resolver\ClassScope;
177use Deriver\Deriver\Resolver\ExpressionValidation;
178use Deriver\Deriver\Resolver\MagicContext;
179use Deriver\Deriver\Resolver\Resolver;
180use Deriver\Deriver\Selection\QueryValidation;
181use Deriver\Deriver\SnapshotIdentity;
182use Deriver\Deriver\Sources\LineMap;
183use Deriver\Deriver\Sources\Path as SourcesPath;
184use Deriver\Deriver\Sources\Source;
185use Deriver\Deriver\Sources\SourceRef;
186use Deriver\Deriver\Sources\Sources;
187use Deriver\Exception\ParserException;
188use Deriver\Exception\ResolutionException;
189use JsonException;
190use PhpParser\Node\ArrayItem;
191use PhpParser\Node\Expr;
192use PhpParser\Node\Expr\Array_;
193use PhpParser\Node\Expr\ArrayDimFetch;
194use PhpParser\Node\Expr\Assign;
195use PhpParser\Node\Expr\FuncCall;
196use PhpParser\Node\Expr\List_;
197use PhpParser\Node\Expr\PropertyFetch;
198use PhpParser\Node\Expr\Variable;
199use PhpParser\Node\Name;
200use PhpParser\Node\Scalar\Int_;
201use PHPUnit\Framework\Attributes\CoversClass;
202use PHPUnit\Framework\Attributes\DataProvider;
203use PHPUnit\Framework\Attributes\Small;
204use PHPUnit\Framework\Attributes\UsesClass;
205use PHPUnit\Framework\TestCase;
206
207#[UsesClass(Resolver::class)]
208#[UsesClass(ExpressionValidation::class)]
209#[UsesClass(ResolutionException::class)]
210#[UsesClass(ParserConfig::class)]
211#[UsesClass(ParserException::class)]
212#[CoversClass(DestructuringLowering::class)]
213#[UsesClass(QueryExecution::class)]
214#[UsesClass(QueryValidation::class)]
215#[UsesClass(ResultAssessment::class)]
216#[UsesClass(Deriver::class)]
217#[UsesClass(Constraints::class)]
218#[UsesClass(Argument::class)]
219#[UsesClass(BasicBlock::class)]
220#[UsesClass(CallableGraph::class)]
221#[UsesClass(CallableIdentity::class)]
222#[UsesClass(CatchTarget::class)]
223#[UsesClass(ClassDeclaration::class)]
224#[UsesClass(ExceptionRegion::class)]
225#[UsesClass(Instruction::class)]
226#[UsesClass(Parameter::class)]
227#[UsesClass(PropertyDeclaration::class)]
228#[UsesClass(Terminator::class)]
229#[UsesClass(Allocation::class)]
230#[UsesClass(ArgumentBinding::class)]
231#[UsesClass(ArgumentOrder::class)]
232#[UsesClass(CallExecutor::class)]
233#[UsesClass(CallResolution::class)]
234#[UsesClass(CallableCheck::class)]
235#[UsesClass(Access::class)]
236#[UsesClass(Builtins::class)]
237#[UsesClass(Dispatch::class)]
238#[UsesClass(HierarchyAccess::class)]
239#[UsesClass(Invocation::class)]
240#[UsesClass(Inputs::class)]
241#[UsesClass(NativeArguments::class)]
242#[UsesClass(NativeInvocation::class)]
243#[UsesClass(Properties::class)]
244#[UsesClass(Signatures::class)]
245#[UsesClass(ParameterBinding::class)]
246#[UsesClass(PassedArgument::class)]
247#[UsesClass(Arguments::class)]
248#[UsesClass(Creation::class)]
249#[UsesClass(Modes::class)]
250#[UsesClass(Resolution::class)]
251#[UsesClass(Target::class)]
252#[UsesClass(Transfer::class)]
253#[UsesClass(TypeBinding::class)]
254#[UsesClass(TypeCheck::class)]
255#[UsesClass(Completion::class)]
256#[UsesClass(Context::class)]
257#[UsesClass(ExceptionChain::class)]
258#[UsesClass(ExceptionMatch::class)]
259#[UsesClass(Handler::class)]
260#[UsesClass(IterationStep::class)]
261#[UsesClass(IteratorCursor::class)]
262#[UsesClass(LoopConvergence::class)]
263#[UsesClass(ObservationLimit::class)]
264#[UsesClass(StateJoin::class)]
265#[UsesClass(Unwinding::class)]
266#[UsesClass(Cell::class)]
267#[UsesClass(Components::class)]
268#[UsesClass(Discovery::class)]
269#[UsesClass(Key::class)]
270#[UsesClass(Table::class)]
271#[UsesClass(Dependencies::class)]
272#[UsesClass(InstructionTransfer::class)]
273#[UsesClass(Evaluator::class)]
274#[UsesClass(SlotReference::class)]
275#[UsesClass(StateStorage::class)]
276#[UsesClass(ObservationCollector::class)]
277#[UsesClass(Address::class)]
278#[UsesClass(Path::class)]
279#[UsesClass(Protocol::class)]
280#[UsesClass(ProtocolAccess::class)]
281#[UsesClass(Reader::class)]
282#[UsesClass(StringAccess::class)]
283#[UsesClass(Strings::class)]
284#[UsesClass(OffsetTransfer::class)]
285#[UsesClass(Conversions::class)]
286#[UsesClass(ScalarErrors::class)]
287#[UsesClass(State::class)]
288#[UsesClass(CompletionRecord::class)]
289#[UsesClass(Evaluation::class)]
290#[UsesClass(SummaryInvocation::class)]
291#[UsesClass(Isolation::class)]
292#[UsesClass(CompoundAssignment::class)]
293#[UsesClass(ConstantTransfer::class)]
294#[UsesClass(IntrinsicTransfer::class)]
295#[UsesClass(MemoryStep::class)]
296#[UsesClass(ObjectAccess::class)]
297#[UsesClass(PropertyAccessCheck::class)]
298#[UsesClass(PropertyLookup::class)]
299#[UsesClass(PropertyReference::class)]
300#[UsesClass(PropertySlot::class)]
301#[UsesClass(PropertyTransfer::class)]
302#[UsesClass(PureStep::class)]
303#[UsesClass(ReferenceAssignment::class)]
304#[UsesClass(LiveArray::class)]
305#[UsesClass(Location::class)]
306#[UsesClass(Materialization::class)]
307#[UsesClass(Memory::class)]
308#[UsesClass(ReferenceConstraint::class)]
309#[UsesClass(StorageCapture::class)]
310#[UsesClass(ArgumentBindings::class)]
311#[UsesClass(BoundArgument::class)]
312#[UsesClass(FunctionEvaluator::class)]
313#[UsesClass(Library::class)]
314#[UsesClass(ScalarFunctions::class)]
315#[UsesClass(CallDescription::class)]
316#[UsesClass(PlanActions::class)]
317#[UsesClass(PlanCompiler::class)]
318#[UsesClass(PlanFootprints::class)]
319#[UsesClass(PlanValidation::class)]
320#[UsesClass(CallDecision::class)]
321#[UsesClass(CallDescriptor::class)]
322#[UsesClass(Action::class)]
323#[UsesClass(Expression::class)]
324#[UsesClass(SemanticPlan::class)]
325#[UsesClass(Extensions::class)]
326#[UsesClass(ProviderExpansion::class)]
327#[UsesClass(Evaluators::class)]
328#[UsesClass(StateRegistry::class)]
329#[UsesClass(DeclarationParameter::class)]
330#[UsesClass(Signature::class)]
331#[UsesClass(DeriverConfig::class)]
332#[UsesClass(EntryPoint::class)]
333#[UsesClass(Sources::class)]
334#[UsesClass(SourcesPath::class)]
335#[UsesClass(Snapshot::class)]
336#[UsesClass(Source::class)]
337#[UsesClass(TargetProfile::class)]
338#[UsesClass(Budget::class)]
339#[UsesClass(QueryScope::class)]
340#[UsesClass(ReturnQuery::class)]
341#[UsesClass(ResultRef::class)]
342#[UsesClass(SourceRef::class)]
343#[UsesClass(Alternative::class)]
344#[UsesClass(Assessment::class)]
345#[UsesClass(Derivation::class)]
346#[UsesClass(DerivationResult::class)]
347#[UsesClass(Frontier::class)]
348#[UsesClass(QueryEncoding::class)]
349#[UsesClass(ValueGraph::class)]
350#[UsesClass(Statistics::class)]
351#[UsesClass(StorageSnapshot::class)]
352#[UsesClass(Parser::class)]
353#[UsesClass(File::class)]
354#[UsesClass(AggregateLowering::class)]
355#[UsesClass(AssignmentLowering::class)]
356#[UsesClass(CallLowering::class)]
357#[UsesClass(Lowerer::class)]
358#[UsesClass(ExceptionLowering::class)]
359#[UsesClass(LoopLowering::class)]
360#[UsesClass(ExpressionLowering::class)]
361#[UsesClass(InstructionEmitter::class)]
362#[UsesClass(LoweringScope::class)]
363#[UsesClass(StatementLowering::class)]
364#[UsesClass(ConstantSignatures::class)]
365#[UsesClass(CallableSource::class)]
366#[UsesClass(Indexer::class)]
367#[UsesClass(Index::class)]
368#[UsesClass(Composition::class)]
369#[UsesClass(LineMap::class)]
370#[UsesClass(MagicContext::class)]
371#[UsesClass(AssignmentPatterns::class)]
372#[UsesClass(ClassScope::class)]
373#[UsesClass(TargetSyntax::class)]
374#[UsesClass(Arithmetic::class)]
375#[UsesClass(Arrays::class)]
376#[UsesClass(Identity::class)]
377#[UsesClass(Increment::class)]
378#[UsesClass(NumericString::class)]
379#[UsesClass(Operations::class)]
380#[UsesClass(Literal::class)]
381#[Small]
382final class DestructuringLoweringTest extends TestCase
383{
384    /**
385     * @throws JsonException If recorded engine observations cannot be decoded
386     */
387    #[DataProvider('providerProgramsDestructuringProgramscases')]
388    public function testAssignmentPreservesRecordedValuesReferenceEffectsAndExceptions(string $source, string $normalJson, string $exception, bool $diagnostic): void
389    {
390        $expected = json_decode($normalJson, true, 512, JSON_THROW_ON_ERROR);
391        $symbol = 'target';
392        $input = new Sources([new Source('fixture.php', $source)]);
393        $configuration = new DeriverConfig();
394        $contributions = new Contributions();
395        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
396        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
397        $contributions1 = $providers->contributions;
398        $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);
399        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
400        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
401        $snapshotId = $identity->id;
402        $input1 = $providers->input;
403        $parser = new Parser(new ParserConfig($target->version));
404        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(SourcesPath::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input1, false));
405        $program = new Index($snapshotId, $trees);
406        $result = (new QueryExecution($program, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program->diagnostics()))))->derive(new ReturnQuery($symbol));
407        self::assertSame($expected, array_map(static fn (Alternative $outcome) => $outcome->values['return']->native(), $result->normalOutcomes));
408        self::assertSame($exception === '' ? [] : [$exception], array_map(static fn (Exceptional $outcome): int|float|string|bool|null => $outcome->exception->literal, $result->exceptionalOutcomes));
409        self::assertSame($diagnostic, in_array('PHP_WARNING', array_column($result->frontiers, 'code'), true));
410        self::assertSame([], array_diff(array_column($result->frontiers, 'code'), ['PHP_WARNING']));
411    }
412    public function testAssignPreservesExplicitKeysAndMissingNumericPositions(): void
413    {
414        $source = '<?php function target(){return 1;}';
415        $snapshotId = 'test';
416        $input = new Sources([new Source('fixture.php', $source)]);
417        $profile = new TargetProfile();
418        $parser = new Parser(new ParserConfig($profile->version));
419        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(SourcesPath::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
420        $index = new Index($snapshotId, $trees);
421        $lowering = new LoweringScope($index->builder('fixture.php'), $index, 'target');
422        $pattern = new List_([null, new ArrayItem(new Variable('x')), new ArrayItem(new Variable('y'), new Int_(7))]);
423        $result = (new DestructuringLowering($lowering))->assign($pattern, 'incoming');
424        $instructions = $lowering->graph->instructions[0];
425        self::assertSame('incoming', $result);
426        self::assertSame(['constant', 'array-read', 'local', 'write', 'constant', 'array-read', 'local', 'write'], array_column($instructions, 'operation'));
427        self::assertSame(1, $instructions[0]->constant?->literal);
428        self::assertSame(7, $instructions[4]->constant?->literal);
429        self::assertSame(['incoming', 'r0'], $instructions[1]->operands);
430        self::assertSame(['incoming', 'r4'], $instructions[5]->operands);
431        self::assertTrue($instructions[1]->attributes['destructure']);
432        self::assertTrue($instructions[5]->attributes['destructure']);
433    }
434    #[DataProvider('providerSources')]
435    public function testSourceDistinguishesWritableStorageAndTemporaryValues(Expr $expression, bool $diagnostic, string $operation): void
436    {
437        $source = '<?php function target(){return 1;}';
438        $snapshotId = 'test';
439        $input = new Sources([new Source('fixture.php', $source)]);
440        $profile = new TargetProfile();
441        $parser = new Parser(new ParserConfig($profile->version));
442        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(SourcesPath::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
443        $index = new Index($snapshotId, $trees);
444        $lowering = new LoweringScope($index->builder('fixture.php'), $index, 'target');
445        $result = (new DestructuringLowering($lowering))->source($expression, $diagnostic);
446        $instructions = $lowering->graph->instructions[0];
447        self::assertNotEmpty($instructions);
448        $last = $instructions[array_key_last($instructions)];
449        self::assertSame($result, $last->result);
450        self::assertSame($operation, $last->operation);
451        self::assertSame($operation === 'returned-address' ? ['temporary-reference' => true, 'temporary-warning' => $diagnostic] : [], $last->attributes);
452    }
453    /**
454     * @return iterable<string,array{Expr,bool,string}>
455     */
456    public static function providerSources(): iterable
457    {
458        yield 'variable' => [new Variable('source'), true, 'local'];
459        yield 'array element' => [new ArrayDimFetch(new Variable('source'), new Int_(0)), true, 'element-address'];
460        yield 'property' => [new PropertyFetch(new Variable('source'), 'items'), true, 'field-address'];
461        yield 'temporary array for foreach' => [new Array_([new ArrayItem(new Int_(1))]), false, 'returned-address'];
462        yield 'ordinary function for assignment' => [new FuncCall(new Name('source')), true, 'returned-address'];
463        yield 'ordinary function for foreach' => [new FuncCall(new Name('source')), false, 'returned-address'];
464    }
465    public function testAssignmentDelegatesOrdinaryVariableAssignments(): void
466    {
467        $source = '<?php function target(){return 1;}';
468        $snapshotId = 'test';
469        $input = new Sources([new Source('fixture.php', $source)]);
470        $profile = new TargetProfile();
471        $parser = new Parser(new ParserConfig($profile->version));
472        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(SourcesPath::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input, false));
473        $index = new Index($snapshotId, $trees);
474        $lowering = new LoweringScope($index->builder('fixture.php'), $index, 'target');
475        $result = (new DestructuringLowering($lowering))->assignment(new Assign(new Variable('x'), new Int_(7)));
476        $instructions = $lowering->graph->instructions[0];
477        self::assertSame(['constant', 'local', 'write', 'copy'], array_column($instructions, 'operation'));
478        self::assertSame($result, $instructions[3]->result);
479        self::assertSame(7, $instructions[0]->constant?->literal);
480    }
481    /**
482     * @return array<string,array{string,string,string,bool}> Source, normal returns, exception, diagnostic presence
483     */
484    public static function providerProgramsDestructuringProgramscases(): array
485    {
486        return ['ArrayAccess values' => ['<?php class Box implements ArrayAccess{public array $data=[1,2];public array $log=[];function offsetGet(mixed $k):mixed{$this->log[]=$k;return $this->data[$k];}function offsetExists(mixed $k):bool{return true;}function offsetSet(mixed $k,mixed $v):void{$this->data[$k]=$v;}function offsetUnset(mixed $k):void{unset($this->data[$k]);}}function target(){$b=new Box;[$x,$y]=$b;return [$x,$y,$b->log];}', '[[1,2,[0,1]]]', '', false], 'ArrayAccess reference return' => ['<?php class Box implements ArrayAccess{public array $data=[1,2];function &offsetGet(mixed $k):mixed{return $this->data[$k];}function offsetExists(mixed $k):bool{return true;}function offsetSet(mixed $k,mixed $v):void{$this->data[$k]=$v;}function offsetUnset(mixed $k):void{unset($this->data[$k]);}}function target(){$b=new Box;[&$x,$y]=$b;$x=9;return [$b->data,$x,$y];}', '[[[9,2],9,2]]', '', false], 'ArrayAccess temporary reference notice' => ['<?php class Box implements ArrayAccess{public array $data=[1,2];function offsetGet(mixed $k):mixed{return $this->data[$k];}function offsetExists(mixed $k):bool{return true;}function offsetSet(mixed $k,mixed $v):void{$this->data[$k]=$v;}function offsetUnset(mixed $k):void{unset($this->data[$k]);}}function target(){$b=new Box;[&$x,$y]=$b;$x=9;return [$b->data,$x,$y];}', '[[[1,2],9,2]]', '', true], 'keys evaluate in entry order' => ['<?php function target(){$k=0;[$k=>$x,$k++=>$y]=[10,20];return [$k,$x,$y];}', '[[1,10,10]]', '', false], 'undefined source initialized by reference' => ['<?php function target(){[&$x]=$a;return [$a,$x];}', '[[[null],null]]', '', false], 'array reference' => ['<?php function target(){$a=[1,2];[&$x,$y]=$a;$x=7;return [$a,$x,$y];}', '[[[7,2],7,2]]', '', false], 'nested reference' => ['<?php function target(){$a=[[1,2]];[[&$x,$y]]=$a;$x=7;return [$a,$x,$y];}', '[[[[7,2]],7,2]]', '', false], 'missing reference' => ['<?php function target(){$a=[];[&$x]=$a;return [$a,$x];}', '[[[null],null]]', '', false], 'string values' => ['<?php function target(){[$x,$y]="ab";return [$x,$y];}', '[[null,null]]', '', false], 'integer values' => ['<?php function target(){[$x,$y]=4;return [$x,$y];}', '[[null,null]]', '', false], 'float values' => ['<?php function target(){[$x,$y]=4.5;return [$x,$y];}', '[[null,null]]', '', false], 'boolean values' => ['<?php function target(){[$x,$y]=true;return [$x,$y];}', '[[null,null]]', '', false], 'null values' => ['<?php function target(){[$x,$y]=null;return [$x,$y];}', '[[null,null]]', '', false], 'missing value warns' => ['<?php function target(){[$x,$y]=[1];return [$x,$y];}', '[[1,null]]', '', true], 'snapshot before overlapping value writes' => ['<?php function target(){$a=[1,2];[$a[1],$x]=$a;return [$a,$x];}', '[[[1,1],2]]', '', false], 'live source after overlapping reference binding' => ['<?php function target(){$a=[1,2];[&$a[1],$x]=$a;return [$a,$x];}', '[[[1,1],1]]', '', false], 'integer reference error' => ['<?php function target(){$a=4;try{[&$x]=$a;}catch(Throwable $e){return [get_class($e),$a];}return [$a,$x];}', '[["Error",4]]', '', false], 'null reference creates array' => ['<?php function target(){$a=null;[&$x]=$a;return [$a,$x];}', '[[[null],null]]', '', false], 'string reference error' => ['<?php function target(){$a="abc";try{[&$x]=$a;}catch(Throwable $e){return [get_class($e),$a];}return [$a,$x];}', '[["Error","abc"]]', '', false], 'ordinary function return reference notice' => ['<?php function make(){return [1];}function target(){[&$x]=make();$x=7;return $x;}', '[7]', '', true], 'foreach reference pattern' => ['<?php function target(){$a=[[1,2],[3,4]];foreach($a as [&$x,$y]){$x+=10;}$x=20;return [$a,$x,$y];}', '[[[[11,2],[20,4]],20,4]]', '', false], 'foreach temporary pattern' => ['<?php function target(){$sum=0;foreach([[1],[2]] as [&$x]){$sum+=$x;}$x=20;return [$sum,$x];}', '[[3,20]]', '', false], 'foreach value before key' => ['<?php function target(){$a=[[5]];foreach($a as $x=>[$x]){}return $x;}', '[0]', '', false], 'foreach reference before key' => ['<?php function target(){$a=[[5]];foreach($a as $x=>[&$x]){}return [$a,$x];}', '[[[[0]],0]]', '', false], 'foreach ordinary value before key' => ['<?php function target(){foreach([5] as $x=>$x){}return $x;}', '[0]', '', false], 'anchored source variable' => ['<?php function target(){$a=[1,2];[&$a,$x]=$a;return [$a,$x];}', '[[1,2]]', '', false], 'anchored nested source element' => ['<?php function target(){$a=[[1,2],9];[&$a[0],$x]=$a[0];return [$a,$x];}', '[[[1,9],2]]', '', false], 'assignment expression reference result' => ['<?php function target(){$a=[1,2];$b=([&$x,$y]=$a);$x=7;return [$a,$b,$x,$y];}', '[[[7,2],[7,2],7,2]]', '', false], 'assignment expression value result' => ['<?php function target(){$a=[1,2];$b=([$x,$y]=$a);$x=7;return [$a,$b,$x,$y];}', '[[[1,2],[1,2],7,2]]', '', false], 'holes keep numeric positions' => ['<?php function target(){list(,$x,,$y)=[1,2,3,4];return [$x,$y];}', '[[2,4]]', '', false], 'keyed dynamic pattern' => ['<?php function target(){$k="b";["a"=>$x,$k=>$y]=["b"=>2,"a"=>1];return [$x,$y];}', '[[1,2]]', '', false], 'nested keyed references' => ['<?php function target(){$a=["outer"=>["inner"=>1]];["outer"=>["inner"=>&$x]]=$a;$x=7;return [$a,$x];}', '[[{"outer":{"inner":7}},7]]', '', false], 'list syntax references' => ['<?php function target(){$a=[1,2];list(&$x,$y)=$a;$x=8;return [$a,$x,$y];}', '[[[8,2],8,2]]', '', false], 'declared reference return' => ['<?php function &source(&$a){return $a;}function target(){$a=[1];[&$x]=source($a);$x=8;return $a;}', '[[8]]', '', false], 'property source reference' => ['<?php class Box{public array $items=[1];}function target(){$b=new Box;[&$x]=$b->items;$x=9;return $b->items;}', '[[9]]', '', false], 'readonly source reference rejected' => ['<?php class Box{function __construct(public readonly array $items=[1]){}}function target(){$b=new Box;try{[&$x]=$b->items;}catch(Error $e){return $b->items;}return 999;}', '[[1]]', '', false], 'typed property destination coerces source' => ['<?php class Box{public int $x=0;}function target(){$a=["12"];$b=new Box;[&$b->x]=$a;return [$a,$b->x];}', '[[[12],12]]', '', false], 'typed property destination rejects reference' => ['<?php declare(strict_types=1);class Box{public int $x=0;}function target(){$a=["12"];$b=new Box;try{[&$b->x]=$a;}catch(TypeError $e){return [$a,$b->x];}return 999;}', '[[["12"],0]]', '', false], 'plain object destructuring error' => ['<?php class Box{}function target(){$b=new Box;try{[$x]=$b;}catch(Error $e){return 1;}return 999;}', '[1]', '', false], 'nested scalar destructuring' => ['<?php function target(){[[$x],[$y]]=["abc",null];return [$x,$y];}', '[[null,null]]', '', false], 'foreach temporary function result' => ['<?php function source(){return [[1],[2]];}function target(){$sum=0;foreach(source() as [&$x]){$sum+=$x;}$x=8;return [$sum,$x];}', '[[3,8]]', '', false], 'foreach ordinary reference temporary' => ['<?php function target(){foreach([1,2] as &$x){$x+=10;}return $x;}', '[12]', '', false]];
487    }
488}
489