packages/deriver/tests/Unit/Deriver/Evaluator/Scalar/OperationsTest.php

1<?php
2
3declare (strict_types=1);
4
5namespace Tests\Unit\Deriver\Evaluator\Scalar;
6
7use Deriver\Deriver;
8use Deriver\Deriver\Candidate\ResultRef;
9use Deriver\Deriver\Candidate\Snapshot;
10use Deriver\Deriver\Candidate\Statistics;
11use Deriver\Deriver\Contributions;
12use Deriver\Deriver\DeriverConfig;
13use Deriver\Deriver\Evaluator\Call\Evaluators;
14use Deriver\Deriver\Evaluator\Call\Extensions;
15use Deriver\Deriver\Evaluator\Call\Registrations;
16use Deriver\Deriver\Evaluator\Call\StateRegistry;
17use Deriver\Deriver\Evaluator\EvaluatorConfig;
18use Deriver\Deriver\Evaluator\Evidence\Frontier;
19use Deriver\Deriver\Evaluator\Execution\Call\ArgumentBinding;
20use Deriver\Deriver\Evaluator\Execution\Call\ArgumentOrder;
21use Deriver\Deriver\Evaluator\Execution\Call\TypeBinding;
22use Deriver\Deriver\Evaluator\Execution\Call\TypeCheck;
23use Deriver\Deriver\Evaluator\Execution\Completion\Alternative;
24use Deriver\Deriver\Evaluator\Execution\Completion\Assessment;
25use Deriver\Deriver\Evaluator\Execution\Completion\Completion;
26use Deriver\Deriver\Evaluator\Execution\Completion\StorageSnapshot;
27use Deriver\Deriver\Evaluator\Execution\Context;
28use Deriver\Deriver\Evaluator\Execution\Control\ObservationLimit;
29use Deriver\Deriver\Evaluator\Execution\Control\StateJoin;
30use Deriver\Deriver\Evaluator\Execution\Control\Unwinding;
31use Deriver\Deriver\Evaluator\Execution\Demand\Cell;
32use Deriver\Deriver\Evaluator\Execution\Demand\Components;
33use Deriver\Deriver\Evaluator\Execution\Demand\Discovery;
34use Deriver\Deriver\Evaluator\Execution\Demand\Key;
35use Deriver\Deriver\Evaluator\Execution\Demand\Table;
36use Deriver\Deriver\Evaluator\Execution\Dependencies;
37use Deriver\Deriver\Evaluator\Execution\Evaluator;
38use Deriver\Deriver\Evaluator\Execution\EvaluatorConfig as ExecutionEvaluatorConfig;
39use Deriver\Deriver\Evaluator\Execution\InstructionTransfer;
40use Deriver\Deriver\Evaluator\Execution\Memory\Materialization;
41use Deriver\Deriver\Evaluator\Execution\Memory\Memory;
42use Deriver\Deriver\Evaluator\Execution\Memory\Slots\SlotReference;
43use Deriver\Deriver\Evaluator\Execution\Memory\StorageCapture;
44use Deriver\Deriver\Evaluator\Execution\ObservationCollector;
45use Deriver\Deriver\Evaluator\Execution\Operation\Conversions;
46use Deriver\Deriver\Evaluator\Execution\Operation\ScalarErrors;
47use Deriver\Deriver\Evaluator\Execution\State;
48use Deriver\Deriver\Evaluator\Execution\Summary\CompletionRecord;
49use Deriver\Deriver\Evaluator\Execution\Summary\Evaluation;
50use Deriver\Deriver\Evaluator\Execution\Summary\Invocation;
51use Deriver\Deriver\Evaluator\Execution\Summary\Isolation;
52use Deriver\Deriver\Evaluator\Execution\Trace\Derivation;
53use Deriver\Deriver\Evaluator\Execution\Transfer\PureStep;
54use Deriver\Deriver\Evaluator\Execution\Transfer\ReferenceAssignment;
55use Deriver\Deriver\Evaluator\Request\Budget;
56use Deriver\Deriver\Evaluator\Request\EntryPoint;
57use Deriver\Deriver\Evaluator\Request\QueryScope;
58use Deriver\Deriver\Evaluator\Request\ReturnQuery;
59use Deriver\Deriver\Evaluator\Scalar\Arithmetic;
60use Deriver\Deriver\Evaluator\Scalar\Arrays;
61use Deriver\Deriver\Evaluator\Scalar\Comparison;
62use Deriver\Deriver\Evaluator\Scalar\FloatConversion;
63use Deriver\Deriver\Evaluator\Scalar\Identity;
64use Deriver\Deriver\Evaluator\Scalar\IntegerConversion;
65use Deriver\Deriver\Evaluator\Scalar\NumericString;
66use Deriver\Deriver\Evaluator\Scalar\Operations;
67use Deriver\Deriver\Evaluator\TargetProfile;
68use Deriver\Deriver\Evaluator\Term;
69use Deriver\Deriver\Evaluator\TermKind;
70use Deriver\Deriver\Execution\DerivationResult;
71use Deriver\Deriver\Execution\QueryExecution;
72use Deriver\Deriver\Execution\ResultAssessment;
73use Deriver\Deriver\Identity\QueryEncoding;
74use Deriver\Deriver\Identity\ValueGraph;
75use Deriver\Deriver\Lowerer\AggregateLowering;
76use Deriver\Deriver\Lowerer\Declaration\CallableIdentity;
77use Deriver\Deriver\Lowerer\Declaration\CallableSource;
78use Deriver\Deriver\Lowerer\Declaration\Index;
79use Deriver\Deriver\Lowerer\Declaration\Indexer;
80use Deriver\Deriver\Lowerer\Declaration\Traits\Composition;
81use Deriver\Deriver\Lowerer\EffectInspection;
82use Deriver\Deriver\Lowerer\ExpressionLowering;
83use Deriver\Deriver\Lowerer\Graph\BasicBlock;
84use Deriver\Deriver\Lowerer\Graph\CallableGraph;
85use Deriver\Deriver\Lowerer\Graph\Instruction;
86use Deriver\Deriver\Lowerer\Graph\Terminator;
87use Deriver\Deriver\Lowerer\Hierarchy\Dispatch;
88use Deriver\Deriver\Lowerer\InstructionEmitter;
89use Deriver\Deriver\Lowerer\Lowerer;
90use Deriver\Deriver\Lowerer\LoweringScope;
91use Deriver\Deriver\Lowerer\StatementLowering;
92use Deriver\Deriver\MicroEvaluatorConversion;
93use Deriver\Deriver\Parser\Node\File;
94use Deriver\Deriver\Parser\Parser;
95use Deriver\Deriver\Parser\ParserConfig;
96use Deriver\Deriver\Parser\TargetSyntax;
97use Deriver\Deriver\Providers\ProviderExpansion;
98use Deriver\Deriver\Resolver\AssignmentPatterns;
99use Deriver\Deriver\Resolver\ClassScope;
100use Deriver\Deriver\Resolver\ExpressionValidation;
101use Deriver\Deriver\Resolver\MagicContext;
102use Deriver\Deriver\Resolver\Resolver;
103use Deriver\Deriver\Selection\QueryValidation;
104use Deriver\Deriver\SnapshotIdentity;
105use Deriver\Deriver\Sources\LineMap;
106use Deriver\Deriver\Sources\Path;
107use Deriver\Deriver\Sources\Source;
108use Deriver\Deriver\Sources\SourceRef;
109use Deriver\Deriver\Sources\Sources;
110use Deriver\Exception\ParserException;
111use Deriver\Exception\ResolutionException;
112use PHPUnit\Framework\Attributes\CoversClass;
113use PHPUnit\Framework\Attributes\DataProvider;
114use PHPUnit\Framework\Attributes\Small;
115use PHPUnit\Framework\Attributes\UsesClass;
116use PHPUnit\Framework\TestCase;
117
118#[UsesClass(Resolver::class)]
119#[UsesClass(ExpressionValidation::class)]
120#[UsesClass(ResolutionException::class)]
121#[UsesClass(ParserConfig::class)]
122#[UsesClass(ParserException::class)]
123#[CoversClass(Operations::class)]
124#[UsesClass(QueryExecution::class)]
125#[UsesClass(QueryValidation::class)]
126#[UsesClass(ResultAssessment::class)]
127#[UsesClass(Deriver::class)]
128#[UsesClass(BasicBlock::class)]
129#[UsesClass(CallableGraph::class)]
130#[UsesClass(CallableIdentity::class)]
131#[UsesClass(Instruction::class)]
132#[UsesClass(Terminator::class)]
133#[UsesClass(ArgumentBinding::class)]
134#[UsesClass(ArgumentOrder::class)]
135#[UsesClass(Dispatch::class)]
136#[UsesClass(TypeBinding::class)]
137#[UsesClass(TypeCheck::class)]
138#[UsesClass(Completion::class)]
139#[UsesClass(Context::class)]
140#[UsesClass(ObservationLimit::class)]
141#[UsesClass(StateJoin::class)]
142#[UsesClass(Unwinding::class)]
143#[UsesClass(Cell::class)]
144#[UsesClass(Components::class)]
145#[UsesClass(Discovery::class)]
146#[UsesClass(Key::class)]
147#[UsesClass(Table::class)]
148#[UsesClass(Dependencies::class)]
149#[UsesClass(InstructionTransfer::class)]
150#[UsesClass(Evaluator::class)]
151#[UsesClass(SlotReference::class)]
152#[UsesClass(ObservationCollector::class)]
153#[UsesClass(Conversions::class)]
154#[UsesClass(ScalarErrors::class)]
155#[UsesClass(State::class)]
156#[UsesClass(CompletionRecord::class)]
157#[UsesClass(Evaluation::class)]
158#[UsesClass(Invocation::class)]
159#[UsesClass(Isolation::class)]
160#[UsesClass(PureStep::class)]
161#[UsesClass(ReferenceAssignment::class)]
162#[UsesClass(Materialization::class)]
163#[UsesClass(Memory::class)]
164#[UsesClass(StorageCapture::class)]
165#[UsesClass(Extensions::class)]
166#[UsesClass(ProviderExpansion::class)]
167#[UsesClass(Evaluators::class)]
168#[UsesClass(StateRegistry::class)]
169#[UsesClass(DeriverConfig::class)]
170#[UsesClass(EntryPoint::class)]
171#[UsesClass(Sources::class)]
172#[UsesClass(Path::class)]
173#[UsesClass(Snapshot::class)]
174#[UsesClass(Source::class)]
175#[UsesClass(TargetProfile::class)]
176#[UsesClass(Budget::class)]
177#[UsesClass(QueryScope::class)]
178#[UsesClass(ReturnQuery::class)]
179#[UsesClass(ResultRef::class)]
180#[UsesClass(SourceRef::class)]
181#[UsesClass(Alternative::class)]
182#[UsesClass(Assessment::class)]
183#[UsesClass(Derivation::class)]
184#[UsesClass(DerivationResult::class)]
185#[UsesClass(QueryEncoding::class)]
186#[UsesClass(ValueGraph::class)]
187#[UsesClass(Statistics::class)]
188#[UsesClass(StorageSnapshot::class)]
189#[UsesClass(Parser::class)]
190#[UsesClass(File::class)]
191#[UsesClass(AggregateLowering::class)]
192#[UsesClass(Lowerer::class)]
193#[UsesClass(EffectInspection::class)]
194#[UsesClass(ExpressionLowering::class)]
195#[UsesClass(InstructionEmitter::class)]
196#[UsesClass(LoweringScope::class)]
197#[UsesClass(StatementLowering::class)]
198#[UsesClass(CallableSource::class)]
199#[UsesClass(Indexer::class)]
200#[UsesClass(Index::class)]
201#[UsesClass(Composition::class)]
202#[UsesClass(LineMap::class)]
203#[UsesClass(MagicContext::class)]
204#[UsesClass(AssignmentPatterns::class)]
205#[UsesClass(ClassScope::class)]
206#[UsesClass(TargetSyntax::class)]
207#[UsesClass(Arithmetic::class)]
208#[UsesClass(Arrays::class)]
209#[UsesClass(Comparison::class)]
210#[UsesClass(FloatConversion::class)]
211#[UsesClass(Identity::class)]
212#[UsesClass(IntegerConversion::class)]
213#[UsesClass(NumericString::class)]
214#[UsesClass(Term::class)]
215#[Small]
216final class OperationsTest extends TestCase
217{
218    public function testTruthPreservesTheSemanticContract(): void
219    {
220        $source = '<?php function target(){return [2=>"left","x"=>1]+[2=>"right",3=>"new"];}';
221        $symbol = 'target';
222        $input = new Sources([new Source('fixture.php', $source)]);
223        $configuration = new DeriverConfig();
224        $contributions = new Contributions();
225        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
226        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
227        $contributions1 = $providers->contributions;
228        $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);
229        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
230        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
231        $snapshotId = $identity->id;
232        $input1 = $providers->input;
233        $parser = new Parser(new ParserConfig($target->version));
234        $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));
235        $program = new Index($snapshotId, $trees);
236        $result = (new QueryExecution($program, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program->diagnostics()))))->derive(new ReturnQuery($symbol));
237        self::assertSame([2 => 'left', 'x' => 1, 3 => 'new'], $result->normalOutcomes[0]->values['return']->native());
238        self::assertSame([], $result->frontiers);
239        self::assertSame([], $result->exceptionalOutcomes);
240    }
241    public function testTruthPreservesUnknownArrayEmptiness(): void
242    {
243        self::assertNull((new Operations())->truth(Term::array([], true)));
244        self::assertFalse((new Operations())->truth(Term::constant('0')));
245    }
246    public function testCastPreservesSymbolicInputs(): void
247    {
248        $input = Term::parameter('id', 'int');
249        $result = (new Operations())->cast('string', $input);
250        self::assertSame(TermKind::Cast, $result->kind);
251        self::assertSame([$input], $result->operands);
252    }
253    public function testBinaryPreservesLeftKeysInArrayUnion(): void
254    {
255        $result = (new Operations())->binary('+', Term::fromNative(['a' => 1]), Term::fromNative(['a' => 2, 'b' => 3]));
256        self::assertSame(['a' => 1, 'b' => 3], $result->native());
257    }
258    public function testUnaryKeepsNegatedPredicatesSymbolic(): void
259    {
260        $input = Term::parameter('enabled', 'bool');
261        $result = (new Operations())->unary('Expr_BooleanNot', $input);
262        self::assertSame('!', $result->literal);
263        self::assertSame([$input], $result->operands);
264    }
265    public function testArrayKeyKeepsLeadingZeroStrings(): void
266    {
267        self::assertSame('01', (new Operations())->arrayKey(Term::constant('01'))->native());
268        self::assertSame(1, (new Operations())->arrayKey(Term::constant('1'))->native());
269    }
270    public function testNumericReturnsTypeErrorsForInvalidAggregateArithmetic(): void
271    {
272        $value = (new Operations())->numeric('*', Term::array([]), Term::constant(2));
273        self::assertSame(TermKind::Throwable, $value->kind);
274        self::assertSame('TypeError', $value->literal);
275    }
276    public function testCastReusesAnExistingConversionToTheSameType(): void
277    {
278        $semantics = new Operations();
279        $cast = $semantics->cast('string', Term::parameter('id', 'int'));
280        self::assertSame($cast, $semantics->cast('String', $cast));
281    }
282    /**
283     * @param Term $value
284     * @param bool|null $expected
285     */
286    #[DataProvider('providerTruthCategories')]
287    public function testTruthDistinguishesEmptyUnknownAndIdentityValues(Term $value, ?bool $expected): void
288    {
289        self::assertSame($expected, (new Operations())->truth($value));
290    }
291    /**
292     * @return array<string, array{Term, bool|null}>
293     */
294    public static function providerTruthCategories(): array
295    {
296        return ['zero' => [Term::constant(0), false], 'empty-string' => [Term::constant(''), false], 'null' => [Term::constant(null), false], 'negative' => [Term::constant(-1), true], 'numeric-looking-string' => [Term::constant('0.0'), true], 'empty-array' => [Term::array([]), false], 'nonempty-open-array' => [Term::array([Term::constant(null)], true), true], 'unknown-array' => [Term::array([], true), null], 'parameter' => [Term::parameter('flag', 'bool'), null], 'object' => [new Term(TermKind::Object, 'id'), true], 'closure' => [new Term(TermKind::Closure, 'id'), true], 'enum' => [new Term(TermKind::Enum, 'id'), true], 'uninitialized' => [new Term(TermKind::Uninitialized), false]];
297    }
298    /**
299     * @param string $type
300     * @param scalar|null $input
301     * @param scalar|array<scalar|null>|null $expected
302     */
303    #[DataProvider('providerCastConstants')]
304    public function testCastPreservesTargetScalarAndArrayConversions(string $type, int|float|string|bool|null $input, int|float|string|bool|array|null $expected): void
305    {
306        $result = (new Operations())->cast($type, Term::constant($input));
307        self::assertSame($expected, $result->native());
308    }
309    /**
310     * @return list<array{string, scalar|null, scalar|array<scalar|null>|null}>
311     */
312    public static function providerCastConstants(): array
313    {
314        return [['bool', '0', false], ['bool', 2, true], ['string', 42, '42'], ['string', null, ''], ['int', 3.75, 3], ['int', '12', 12], ['int', false, 0], ['float', '2.5', 2.5], ['double', 3, 3.0], ['array', null, []], ['array', 'value', ['value']]];
315    }
316    public function testCastRetainsUnsupportedAndConfigurationDependentBoundaries(): void
317    {
318        $semantics = new Operations();
319        $input = Term::parameter('flag', 'bool');
320        $boolean = $semantics->cast('bool', $input);
321        self::assertSame(['cast', 'bool', [$input], ['type' => 'bool']], [$boolean->kind->value, $boolean->literal, $boolean->operands, $boolean->attributes]);
322        self::assertSame('FLOAT_STRING_CONFIGURATION', $semantics->cast('string', Term::constant(1.5))->literal);
323        self::assertSame('UNSUPPORTED_LANGUAGE_FEATURE', $semantics->cast('object', Term::constant(1))->literal);
324        self::assertSame(TermKind::Opaque, $semantics->cast('string', Term::array([]))->kind);
325        self::assertSame(TermKind::Opaque, $semantics->cast('string', new Term(TermKind::Object, 'id'))->kind);
326    }
327    public function testBinaryPreservesSymbolicRelationships(): void
328    {
329        $semantics = new Operations();
330        $input = Term::parameter('enabled', 'bool');
331        $constant = Term::constant(false);
332        $predicate = $semantics->binary('xor', $input, $constant);
333        self::assertSame(['binary', 'xor', 'bool'], [$predicate->kind->value, $predicate->literal, $predicate->attributes['type']]);
334        self::assertSame([$input, $constant], $predicate->operands);
335        self::assertFalse($semantics->binary('xor', Term::constant(true), Term::constant(true))->native());
336        self::assertSame('ab', $semantics->binary('.', Term::constant('a'), Term::constant('b'))->native());
337        self::assertTrue($semantics->binary('<', Term::constant(2), Term::constant(3))->native());
338    }
339    /**
340     * @param string $operation
341     * @param scalar|null $input
342     * @param scalar|null $expected
343     */
344    #[DataProvider('providerUnaryConstants')]
345    public function testUnaryUsesTheTargetOperator(string $operation, int|float|string|bool|null $input, int|float|string|bool|null $expected): void
346    {
347        $result = (new Operations())->unary($operation, Term::constant($input));
348        self::assertSame($expected, $result->native());
349    }
350    /**
351     * @return list<array{string, scalar|null, scalar|null}>
352     */
353    public static function providerUnaryConstants(): array
354    {
355        return [['Expr_BooleanNot', '0', true], ['Expr_BooleanNot', 1, false], ['Expr_UnaryMinus', 3, -3], ['Expr_UnaryPlus', '3', 3], ['Expr_BitwiseNot', 1, -2], ['Expr_BitwiseNot', 'A', "\xbe"]];
356    }
357    public function testUnaryRetainsSymbolicBitwiseInputsAndRejectsInvalidConstants(): void
358    {
359        $semantics = new Operations();
360        $input = Term::parameter('n', 'int');
361        self::assertSame('TypeError', $semantics->unary('Expr_BitwiseNot', Term::constant(null))->literal);
362        $symbolic = $semantics->unary('Expr_BitwiseNot', $input);
363        self::assertSame(['unary', 'Expr_BitwiseNot', [$input]], [$symbolic->kind->value, $symbolic->literal, $symbolic->operands]);
364    }
365    /**
366     * @param scalar|null $input
367     * @param int|string $expected
368     */
369    #[DataProvider('providerArrayKeys')]
370    public function testArrayKeyUsesTargetKeyCategories(int|float|string|bool|null $input, int|string $expected): void
371    {
372        $result = (new Operations())->arrayKey(Term::constant($input));
373        self::assertSame($expected, $result->native());
374    }
375    /**
376     * @return list<array{scalar|null, int|string}>
377     */
378    public static function providerArrayKeys(): array
379    {
380        return [[null, ''], [false, 0], [true, 1], [3.75, 3], [-2.5, -2], [8, 8], ['0', 0], ['-3', -3], ['01', '01'], ['+1', '+1'], ['-0', '-0'], ['9223372036854775808', '9223372036854775808']];
381    }
382    public function testArrayKeyPreservesUnknownKeysAndRejectsAggregateKinds(): void
383    {
384        $semantics = new Operations();
385        $input = Term::parameter('key');
386        $key = $semantics->arrayKey($input);
387        self::assertSame(['array-key', [$input]], [$key->kind->value, $key->operands]);
388        self::assertSame('TypeError', $semantics->arrayKey(Term::array([]))->literal);
389        self::assertSame('TypeError', $semantics->arrayKey(new Term(TermKind::Object, 'id'))->literal);
390        self::assertSame('TypeError', $semantics->arrayKey(new Term(TermKind::Closure, 'id'))->literal);
391        self::assertSame('TypeError', $semantics->arrayKey(new Term(TermKind::Enum, 'id'))->literal);
392    }
393    /**
394     * @param string $operation
395     * @param string $bound
396     */
397    #[DataProvider('providerNumericBounds')]
398    public function testNumericRetainsOperandIdentityAndValidResultBounds(string $operation, string $bound): void
399    {
400        $input = Term::parameter('n', 'int');
401        $constant = Term::constant(2);
402        $result = (new Operations())->numeric($operation, $input, $constant);
403        self::assertSame(['binary', $operation, [$input, $constant], ['type' => $bound]], [$result->kind->value, $result->literal, $result->operands, $result->attributes]);
404    }
405    /**
406     * @return list<array{string, string}>
407     */
408    public static function providerNumericBounds(): array
409    {
410        return [['+', 'int|float|array'], ['-', 'int|float'], ['%', 'int'], ['<<', 'int'], ['>>', 'int'], ['&', 'int|string'], ['|', 'int|string'], ['^', 'int|string']];
411    }
412    public function testNumericRetainsPossibleArrayUnionAndRejectsKnownIncompatibleOperands(): void
413    {
414        $semantics = new Operations();
415        $array = Term::array([]);
416        $input = Term::parameter('other', 'array');
417        $union = $semantics->numeric('+', $input, $array);
418        self::assertSame(['binary', '+', [$input, $array], ['type' => 'array']], [$union->kind->value, $union->literal, $union->operands, $union->attributes]);
419        self::assertSame('TypeError', $semantics->numeric('+', $array, Term::constant(1))->literal);
420        self::assertSame('TypeError', $semantics->numeric('*', Term::constant(1), new Term(TermKind::Object, 'id'))->literal);
421        self::assertSame(6, $semantics->numeric('*', Term::constant(2), Term::constant(3))->native());
422    }
423    #[DataProvider('providerArrayUnionRemainders')]
424    public function testBinaryPreservesArrayUnionOrderAndUnknownRemainders(bool $leftOpen, bool $rightOpen): void
425    {
426        $left = new Term(TermKind::Array, operands: ['shared' => Term::constant(1), 'left' => Term::constant(2)], attributes: ['open' => $leftOpen]);
427        $right = new Term(TermKind::Array, operands: ['shared' => Term::constant(9), 'right' => Term::constant(3)], attributes: ['open' => $rightOpen]);
428        $result = (new Operations())->binary('+', $left, $right);
429        self::assertSame(TermKind::Array, $result->kind);
430        self::assertSame(['shared', 'left', 'right'], array_keys($result->operands));
431        self::assertSame([1, 2, 3], array_column($result->operands, 'literal'));
432        self::assertSame($leftOpen || $rightOpen, $result->attributes['open']);
433    }
434    /**
435     * @return iterable<string,array{bool,bool}>
436     */
437    public static function providerArrayUnionRemainders(): iterable
438    {
439        yield 'closed' => [false, false];
440        yield 'open left' => [true, false];
441        yield 'open right' => [false, true];
442        yield 'both open' => [true, true];
443    }
444    #[DataProvider('providerArrayCasts')]
445    public function testCastCreatesClosedArrayShapes(int|string|null $value): void
446    {
447        $result = (new Operations())->cast('array', Term::constant($value));
448        self::assertSame(TermKind::Array, $result->kind);
449        self::assertSame($value === null ? [] : [$value], $result->native());
450        self::assertFalse($result->attributes['open']);
451    }
452    /**
453     * @return iterable<string,array{int|string|null}>
454     */
455    public static function providerArrayCasts(): iterable
456    {
457        yield 'null' => [null];
458        yield 'integer' => [1];
459        yield 'string' => ['value'];
460    }
461    public function testTruthTreatsNanAsTrueWithoutHostDiagnostics(): void
462    {
463        self::assertTrue((new Operations())->truth(Term::constant(NAN)));
464        self::assertFalse((new Operations())->truth(Term::constant(-0.0)));
465    }
466    public function testCastConvertsFloatsUnderTheCapturedPrecision(): void
467    {
468        self::assertSame('0.33333333333333', (new Operations(14))->cast('string', Term::constant(1 / 3))->native());
469        self::assertSame('0.3333333333333333', (new Operations(-1))->cast('string', Term::constant(1 / 3))->native());
470        self::assertSame('v0.25', (new Operations(14))->binary('.', Term::constant('v'), Term::constant(0.25))->native());
471    }
472    public function testUnarySignsKeepNegativeZero(): void
473    {
474        self::assertSame('-0', (new Operations(14))->cast('string', (new Operations())->unary('Expr_UnaryMinus', Term::constant(0.0)))->native());
475        self::assertSame('-0', (new Operations(14))->cast('string', (new Operations())->unary('Expr_UnaryPlus', Term::constant('-0.0')))->native());
476    }
477}
478