1
use std::collections::{HashSet, VecDeque};
2
use std::fmt::{Display, Formatter};
3
use tracing::trace;
4

            
5
use conjure_cp_enum_compatibility_macro::document_compatibility;
6
use itertools::Itertools;
7
use serde::{Deserialize, Serialize};
8
use ustr::Ustr;
9

            
10
use polyquine::Quine;
11
use uniplate::{Biplate, Uniplate};
12

            
13
use crate::bug;
14

            
15
use super::abstract_comprehension::AbstractComprehension;
16
use super::ac_operators::ACOperatorKind;
17
use super::categories::{Category, CategoryOf};
18
use super::comprehension::Comprehension;
19
use super::domains::HasDomain as _;
20
use super::pretty::{pretty_expressions_as_top_level, pretty_vec};
21
use super::records::RecordValue;
22
use super::sat_encoding::SATIntEncoding;
23
use super::{
24
    AbstractLiteral, Atom, DeclarationPtr, Domain, DomainPtr, GroundDomain, IntVal, Literal,
25
    Metadata, Model, Moo, Name, Range, Reference, ReturnType, SetAttr, SymbolTable, SymbolTablePtr,
26
    Typeable, UnresolvedDomain, matrix,
27
};
28

            
29
// Ensure that this type doesn't get too big
30
//
31
// If you triggered this assertion, you either made a variant of this enum that is too big, or you
32
// made Name,Literal,AbstractLiteral,Atom bigger, which made this bigger! To fix this, put some
33
// stuff in boxes.
34
//
35
// Enums take the size of their largest variant, so an enum with mostly small variants and a few
36
// large ones wastes memory... A larger Expression type also slows down Oxide.
37
//
38
// For more information, and more details on type sizes and how to measure them, see the commit
39
// message for 6012de809 (perf: reduce size of AST types, 2025-06-18).
40
//
41
// You can also see type sizes in the rustdoc documentation, generated by ./tools/gen_docs.sh
42
//
43
// https://github.com/conjure-cp/conjure-oxide/commit/6012de8096ca491ded91ecec61352fdf4e994f2e
44

            
45
// TODO: box all usages of Metadata to bring this down a bit more - I have added variants to
46
// ReturnType, and Metadata contains ReturnType, so Metadata has got bigger. Metadata will get a
47
// lot bigger still when we start using it for memoisation, so it should really be
48
// boxed ~niklasdewally
49

            
50
// expect size of Expression to be 112 bytes
51
static_assertions::assert_eq_size!([u8; 112], Expression);
52

            
53
/// Represents different types of expressions used to define rules and constraints in the model.
54
///
55
/// The `Expression` enum includes operations, constants, and variable references
56
/// used to build rules and conditions for the model.
57
#[document_compatibility]
58
#[derive(Clone, Debug, Hash, PartialEq, Eq, Serialize, Deserialize, Uniplate, Quine)]
59
#[biplate(to=AbstractComprehension)]
60
#[biplate(to=AbstractLiteral<Expression>)]
61
#[biplate(to=AbstractLiteral<Literal>)]
62
#[biplate(to=Atom)]
63
#[biplate(to=Comprehension)]
64
#[biplate(to=DeclarationPtr)]
65
#[biplate(to=DomainPtr)]
66
#[biplate(to=Literal)]
67
#[biplate(to=Metadata)]
68
#[biplate(to=Name)]
69
#[biplate(to=Option<Expression>)]
70
#[biplate(to=RecordValue<Expression>)]
71
#[biplate(to=RecordValue<Literal>)]
72
#[biplate(to=Reference)]
73
#[biplate(to=Model)]
74
#[biplate(to=SymbolTable)]
75
#[biplate(to=SymbolTablePtr)]
76
#[biplate(to=Vec<Expression>)]
77
#[path_prefix(conjure_cp::ast)]
78
pub enum Expression {
79
    AbstractLiteral(Metadata, AbstractLiteral<Expression>),
80
    /// The top of the model
81
    Root(Metadata, Vec<Expression>),
82

            
83
    /// An expression representing "A is valid as long as B is true"
84
    /// Turns into a conjunction when it reaches a boolean context
85
    Bubble(Metadata, Moo<Expression>, Moo<Expression>),
86

            
87
    /// A comprehension.
88
    ///
89
    /// The inside of the comprehension opens a new scope.
90
    // todo (gskorokhod): Comprehension contains a symbol table which contains a bunch of pointers.
91
    // This makes implementing Quine tricky (it doesnt support Rc, by design). Skip it for now.
92
    #[polyquine_skip]
93
    Comprehension(Metadata, Moo<Comprehension>),
94

            
95
    /// Higher-level abstract comprehension
96
    #[polyquine_skip] // no idea what this is lol but it stops rustc screaming at me
97
    AbstractComprehension(Metadata, Moo<AbstractComprehension>),
98

            
99
    /// Defines dominance ("Solution A is preferred over Solution B")
100
    DominanceRelation(Metadata, Moo<Expression>),
101
    /// `fromSolution(name)` - Used in dominance relation definitions
102
    FromSolution(Metadata, Moo<Atom>),
103

            
104
    #[polyquine_with(arm = (_, name) => {
105
        let ident = proc_macro2::Ident::new(name.as_str(), proc_macro2::Span::call_site());
106
        quote::quote! { #ident.clone().into() }
107
    })]
108
    Metavar(Metadata, Ustr),
109

            
110
    Atomic(Metadata, Atom),
111

            
112
    /// A matrix index.
113
    ///
114
    /// Defined iff the indices are within their respective index domains.
115
    #[compatible(JsonInput)]
116
    UnsafeIndex(Metadata, Moo<Expression>, Vec<Expression>),
117

            
118
    /// A safe matrix index.
119
    ///
120
    /// See [`Expression::UnsafeIndex`]
121
    #[compatible(SMT)]
122
    SafeIndex(Metadata, Moo<Expression>, Vec<Expression>),
123

            
124
    /// A matrix slice: `a[indices]`.
125
    ///
126
    /// One of the indicies may be `None`, representing the dimension of the matrix we want to take
127
    /// a slice of. For example, for some 3d matrix a, `a[1,..,2]` has the indices
128
    /// `Some(1),None,Some(2)`.
129
    ///
130
    /// It is assumed that the slice only has one "wild-card" dimension and thus is 1 dimensional.
131
    ///
132
    /// Defined iff the defined indices are within their respective index domains.
133
    #[compatible(JsonInput)]
134
    UnsafeSlice(Metadata, Moo<Expression>, Vec<Option<Expression>>),
135

            
136
    /// A safe matrix slice: `a[indices]`.
137
    ///
138
    /// See [`Expression::UnsafeSlice`].
139
    SafeSlice(Metadata, Moo<Expression>, Vec<Option<Expression>>),
140

            
141
    /// `inDomain(x,domain)` iff `x` is in the domain `domain`.
142
    ///
143
    /// This cannot be constructed from Essence input, nor passed to a solver: this expression is
144
    /// mainly used during the conversion of `UnsafeIndex` and `UnsafeSlice` to `SafeIndex` and
145
    /// `SafeSlice` respectively.
146
    InDomain(Metadata, Moo<Expression>, DomainPtr),
147

            
148
    /// `toInt(b)` casts boolean expression b to an integer.
149
    ///
150
    /// - If b is false, then `toInt(b) == 0`
151
    ///
152
    /// - If b is true, then `toInt(b) == 1`
153
    #[compatible(SMT)]
154
    ToInt(Metadata, Moo<Expression>),
155

            
156
    /// `|x|` - absolute value of `x`
157
    #[compatible(JsonInput, SMT)]
158
    Abs(Metadata, Moo<Expression>),
159

            
160
    /// `sum(<vec_expr>)`
161
    #[compatible(JsonInput, SMT)]
162
    Sum(Metadata, Moo<Expression>),
163

            
164
    /// `a * b * c * ...`
165
    #[compatible(JsonInput, SMT)]
166
    Product(Metadata, Moo<Expression>),
167

            
168
    /// `min(<vec_expr>)`
169
    #[compatible(JsonInput, SMT)]
170
    Min(Metadata, Moo<Expression>),
171

            
172
    /// `max(<vec_expr>)`
173
    #[compatible(JsonInput, SMT)]
174
    Max(Metadata, Moo<Expression>),
175

            
176
    /// `not(a)`
177
    #[compatible(JsonInput, SAT, SMT)]
178
    Not(Metadata, Moo<Expression>),
179

            
180
    /// `or(<vec_expr>)`
181
    #[compatible(JsonInput, SAT, SMT)]
182
    Or(Metadata, Moo<Expression>),
183

            
184
    /// `and(<vec_expr>)`
185
    #[compatible(JsonInput, SAT, SMT)]
186
    And(Metadata, Moo<Expression>),
187

            
188
    /// Ensures that `a->b` (material implication).
189
    #[compatible(JsonInput, SMT)]
190
    Imply(Metadata, Moo<Expression>, Moo<Expression>),
191

            
192
    /// `iff(a, b)` a <-> b
193
    #[compatible(JsonInput, SMT)]
194
    Iff(Metadata, Moo<Expression>, Moo<Expression>),
195

            
196
    #[compatible(JsonInput)]
197
    Union(Metadata, Moo<Expression>, Moo<Expression>),
198

            
199
    #[compatible(JsonInput)]
200
    In(Metadata, Moo<Expression>, Moo<Expression>),
201

            
202
    #[compatible(JsonInput)]
203
    Intersect(Metadata, Moo<Expression>, Moo<Expression>),
204

            
205
    #[compatible(JsonInput)]
206
    Supset(Metadata, Moo<Expression>, Moo<Expression>),
207

            
208
    #[compatible(JsonInput)]
209
    SupsetEq(Metadata, Moo<Expression>, Moo<Expression>),
210

            
211
    #[compatible(JsonInput)]
212
    Subset(Metadata, Moo<Expression>, Moo<Expression>),
213

            
214
    #[compatible(JsonInput)]
215
    SubsetEq(Metadata, Moo<Expression>, Moo<Expression>),
216

            
217
    #[compatible(JsonInput, SMT)]
218
    Eq(Metadata, Moo<Expression>, Moo<Expression>),
219

            
220
    #[compatible(JsonInput, SMT)]
221
    Neq(Metadata, Moo<Expression>, Moo<Expression>),
222

            
223
    #[compatible(JsonInput, SMT)]
224
    Geq(Metadata, Moo<Expression>, Moo<Expression>),
225

            
226
    #[compatible(JsonInput, SMT)]
227
    Leq(Metadata, Moo<Expression>, Moo<Expression>),
228

            
229
    #[compatible(JsonInput, SMT)]
230
    Gt(Metadata, Moo<Expression>, Moo<Expression>),
231

            
232
    #[compatible(JsonInput, SMT)]
233
    Lt(Metadata, Moo<Expression>, Moo<Expression>),
234

            
235
    /// Division after preventing division by zero, usually with a bubble
236
    #[compatible(SMT)]
237
    SafeDiv(Metadata, Moo<Expression>, Moo<Expression>),
238

            
239
    /// Division with a possibly undefined value (division by 0)
240
    #[compatible(JsonInput)]
241
    UnsafeDiv(Metadata, Moo<Expression>, Moo<Expression>),
242

            
243
    /// Modulo after preventing mod 0, usually with a bubble
244
    #[compatible(SMT)]
245
    SafeMod(Metadata, Moo<Expression>, Moo<Expression>),
246

            
247
    /// Modulo with a possibly undefined value (mod 0)
248
    #[compatible(JsonInput)]
249
    UnsafeMod(Metadata, Moo<Expression>, Moo<Expression>),
250

            
251
    /// Negation: `-x`
252
    #[compatible(JsonInput, SMT)]
253
    Neg(Metadata, Moo<Expression>),
254

            
255
    /// Set of domain values function is defined for
256
    #[compatible(JsonInput)]
257
    Defined(Metadata, Moo<Expression>),
258

            
259
    /// Set of codomain values function is defined for
260
    #[compatible(JsonInput)]
261
    Range(Metadata, Moo<Expression>),
262

            
263
    /// Unsafe power`x**y` (possibly undefined)
264
    ///
265
    /// Defined when (X!=0 \\/ Y!=0) /\ Y>=0
266
    #[compatible(JsonInput)]
267
    UnsafePow(Metadata, Moo<Expression>, Moo<Expression>),
268

            
269
    /// `UnsafePow` after preventing undefinedness
270
    SafePow(Metadata, Moo<Expression>, Moo<Expression>),
271

            
272
    /// Flatten matrix operator
273
    /// `flatten(M)` or `flatten(n, M)`
274
    /// where M is a matrix and n is an optional integer argument indicating depth of flattening
275
    Flatten(Metadata, Option<Moo<Expression>>, Moo<Expression>),
276

            
277
    /// `allDiff(<vec_expr>)`
278
    #[compatible(JsonInput)]
279
    AllDiff(Metadata, Moo<Expression>),
280

            
281
    /// `table([x1, x2, ...], [[r11, r12, ...], [r21, r22, ...], ...])`
282
    ///
283
    /// Represents a positive table constraint: the tuple `[x1, x2, ...]` must match one of the
284
    /// allowed rows.
285
    #[compatible(JsonInput)]
286
    Table(Metadata, Moo<Expression>, Moo<Expression>),
287
    /// Binary subtraction operator
288
    ///
289
    /// This is a parser-level construct, and is immediately normalised to `Sum([a,-b])`.
290
    /// TODO: make this compatible with Set Difference calculations - need to change return type and domain for this expression and write a set comprehension rule.
291
    /// have already edited minus_to_sum to prevent this from applying to sets
292
    #[compatible(JsonInput)]
293
    Minus(Metadata, Moo<Expression>, Moo<Expression>),
294

            
295
    /// Ensures that x=|y| i.e. x is the absolute value of y.
296
    ///
297
    /// Low-level Minion constraint.
298
    ///
299
    /// # See also
300
    ///
301
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#abs)
302
    #[compatible(Minion)]
303
    FlatAbsEq(Metadata, Moo<Atom>, Moo<Atom>),
304

            
305
    /// Ensures that `alldiff([a,b,...])`.
306
    ///
307
    /// Low-level Minion constraint.
308
    ///
309
    /// # See also
310
    ///
311
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#alldiff)
312
    #[compatible(Minion)]
313
    FlatAllDiff(Metadata, Vec<Atom>),
314

            
315
    /// Ensures that sum(vec) >= x.
316
    ///
317
    /// Low-level Minion constraint.
318
    ///
319
    /// # See also
320
    ///
321
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#sumgeq)
322
    #[compatible(Minion)]
323
    FlatSumGeq(Metadata, Vec<Atom>, Atom),
324

            
325
    /// Ensures that sum(vec) <= x.
326
    ///
327
    /// Low-level Minion constraint.
328
    ///
329
    /// # See also
330
    ///
331
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#sumleq)
332
    #[compatible(Minion)]
333
    FlatSumLeq(Metadata, Vec<Atom>, Atom),
334

            
335
    /// `ineq(x,y,k)` ensures that x <= y + k.
336
    ///
337
    /// Low-level Minion constraint.
338
    ///
339
    /// # See also
340
    ///
341
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#ineq)
342
    #[compatible(Minion)]
343
    FlatIneq(Metadata, Moo<Atom>, Moo<Atom>, Box<Literal>),
344

            
345
    /// `w-literal(x,k)` ensures that x == k, where x is a variable and k a constant.
346
    ///
347
    /// Low-level Minion constraint.
348
    ///
349
    /// This is a low-level Minion constraint and you should probably use Eq instead. The main use
350
    /// of w-literal is to convert boolean variables to constraints so that they can be used inside
351
    /// watched-and and watched-or.
352
    ///
353
    /// # See also
354
    ///
355
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#minuseq)
356
    /// + `rules::minion::boolean_literal_to_wliteral`.
357
    #[compatible(Minion)]
358
    #[polyquine_skip]
359
    FlatWatchedLiteral(Metadata, Reference, Literal),
360

            
361
    /// `weightedsumleq(cs,xs,total)` ensures that cs.xs <= total, where cs.xs is the scalar dot
362
    /// product of cs and xs.
363
    ///
364
    /// Low-level Minion constraint.
365
    ///
366
    /// Represents a weighted sum of the form `ax + by + cz + ...`
367
    ///
368
    /// # See also
369
    ///
370
    /// + [Minion
371
    /// documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#weightedsumleq)
372
    FlatWeightedSumLeq(Metadata, Vec<Literal>, Vec<Atom>, Moo<Atom>),
373

            
374
    /// `weightedsumgeq(cs,xs,total)` ensures that cs.xs >= total, where cs.xs is the scalar dot
375
    /// product of cs and xs.
376
    ///
377
    /// Low-level Minion constraint.
378
    ///
379
    /// Represents a weighted sum of the form `ax + by + cz + ...`
380
    ///
381
    /// # See also
382
    ///
383
    /// + [Minion
384
    /// documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#weightedsumleq)
385
    FlatWeightedSumGeq(Metadata, Vec<Literal>, Vec<Atom>, Moo<Atom>),
386

            
387
    /// Ensures that x =-y, where x and y are atoms.
388
    ///
389
    /// Low-level Minion constraint.
390
    ///
391
    /// # See also
392
    ///
393
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#minuseq)
394
    #[compatible(Minion)]
395
    FlatMinusEq(Metadata, Moo<Atom>, Moo<Atom>),
396

            
397
    /// Ensures that x*y=z.
398
    ///
399
    /// Low-level Minion constraint.
400
    ///
401
    /// # See also
402
    ///
403
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#product)
404
    #[compatible(Minion)]
405
    FlatProductEq(Metadata, Moo<Atom>, Moo<Atom>, Moo<Atom>),
406

            
407
    /// Ensures that floor(x/y)=z. Always true when y=0.
408
    ///
409
    /// Low-level Minion constraint.
410
    ///
411
    /// # See also
412
    ///
413
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#div_undefzero)
414
    #[compatible(Minion)]
415
    MinionDivEqUndefZero(Metadata, Moo<Atom>, Moo<Atom>, Moo<Atom>),
416

            
417
    /// Ensures that x%y=z. Always true when y=0.
418
    ///
419
    /// Low-level Minion constraint.
420
    ///
421
    /// # See also
422
    ///
423
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#mod_undefzero)
424
    #[compatible(Minion)]
425
    MinionModuloEqUndefZero(Metadata, Moo<Atom>, Moo<Atom>, Moo<Atom>),
426

            
427
    /// Ensures that `x**y = z`.
428
    ///
429
    /// Low-level Minion constraint.
430
    ///
431
    /// This constraint is false when `y<0` except for `1**y=1` and `(-1)**y=z` (where z is 1 if y
432
    /// is odd and z is -1 if y is even).
433
    ///
434
    /// # See also
435
    ///
436
    /// + [Github comment about `pow` semantics](https://github.com/minion/minion/issues/40#issuecomment-2595914891)
437
    /// + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#pow)
438
    MinionPow(Metadata, Moo<Atom>, Moo<Atom>, Moo<Atom>),
439

            
440
    /// `reify(constraint,r)` ensures that r=1 iff `constraint` is satisfied, where r is a 0/1
441
    /// variable.
442
    ///
443
    /// Low-level Minion constraint.
444
    ///
445
    /// # See also
446
    ///
447
    ///  + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#reify)
448
    #[compatible(Minion)]
449
    MinionReify(Metadata, Moo<Expression>, Atom),
450

            
451
    /// `reifyimply(constraint,r)` ensures that `r->constraint`, where r is a 0/1 variable.
452
    /// variable.
453
    ///
454
    /// Low-level Minion constraint.
455
    ///
456
    /// # See also
457
    ///
458
    ///  + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#reifyimply)
459
    #[compatible(Minion)]
460
    MinionReifyImply(Metadata, Moo<Expression>, Atom),
461

            
462
    /// `w-inintervalset(x, [a1,a2, b1,b2, … ])` ensures that the value of x belongs to one of the
463
    /// intervals {a1,…,a2}, {b1,…,b2} etc.
464
    ///
465
    /// The list of intervals must be given in numerical order.
466
    ///
467
    /// Low-level Minion constraint.
468
    ///
469
    /// # See also
470
    ///>
471
    ///  + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#w-inintervalset)
472
    #[compatible(Minion)]
473
    MinionWInIntervalSet(Metadata, Atom, Vec<i32>),
474

            
475
    /// `w-inset(x, [v1, v2, … ])` ensures that the value of `x` is one of the explicitly given values `v1`, `v2`, etc.
476
    ///
477
    /// This constraint enforces membership in a specific set of discrete values rather than intervals.
478
    ///
479
    /// The list of values must be given in numerical order.
480
    ///
481
    /// Low-level Minion constraint.
482
    ///
483
    /// # See also
484
    ///
485
    ///  + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#w-inset)
486
    #[compatible(Minion)]
487
    MinionWInSet(Metadata, Atom, Vec<i32>),
488

            
489
    /// `element_one(vec, i, e)` specifies that `vec[i] = e`. This implies that i is
490
    /// in the range `[1..len(vec)]`.
491
    ///
492
    /// Low-level Minion constraint.
493
    ///
494
    /// # See also
495
    ///
496
    ///  + [Minion documentation](https://minion-solver.readthedocs.io/en/stable/usage/constraints.html#element_one)
497
    #[compatible(Minion)]
498
    MinionElementOne(Metadata, Vec<Atom>, Moo<Atom>, Moo<Atom>),
499

            
500
    /// Declaration of an auxiliary variable.
501
    ///
502
    /// As with Savile Row, we semantically distinguish this from `Eq`.
503
    #[compatible(Minion)]
504
    #[polyquine_skip]
505
    AuxDeclaration(Metadata, Reference, Moo<Expression>),
506

            
507
    /// This expression is for encoding ints for the SAT solver, it stores the encoding type, the vector of booleans and the min/max for the int.
508
    #[compatible(SAT)]
509
    SATInt(Metadata, SATIntEncoding, Moo<Expression>, (i32, i32)),
510

            
511
    /// Addition over a pair of expressions (i.e. a + b) rather than a vec-expr like Expression::Sum.
512
    /// This is for compatibility with backends that do not support addition over vectors.
513
    #[compatible(SMT)]
514
    PairwiseSum(Metadata, Moo<Expression>, Moo<Expression>),
515

            
516
    /// Multiplication over a pair of expressions (i.e. a * b) rather than a vec-expr like Expression::Product.
517
    /// This is for compatibility with backends that do not support multiplication over vectors.
518
    #[compatible(SMT)]
519
    PairwiseProduct(Metadata, Moo<Expression>, Moo<Expression>),
520

            
521
    #[compatible(JsonInput)]
522
    Image(Metadata, Moo<Expression>, Moo<Expression>),
523

            
524
    #[compatible(JsonInput)]
525
    ImageSet(Metadata, Moo<Expression>, Moo<Expression>),
526

            
527
    #[compatible(JsonInput)]
528
    PreImage(Metadata, Moo<Expression>, Moo<Expression>),
529

            
530
    #[compatible(JsonInput)]
531
    Inverse(Metadata, Moo<Expression>, Moo<Expression>),
532

            
533
    #[compatible(JsonInput)]
534
    Restrict(Metadata, Moo<Expression>, Moo<Expression>),
535

            
536
    /// Lexicographical < between two matrices.
537
    ///
538
    /// A <lex B iff: A[i] < B[i] for some i /\ (A[j] > B[j] for some j -> i < j)
539
    /// I.e. A must be less than B at some index i, and if it is greater than B at another index j,
540
    /// then j comes after i.
541
    /// I.e. A must be greater than B at the first index where they differ.
542
    ///
543
    /// E.g. [1, 1] <lex [2, 1] and [1, 1] <lex [1, 2]
544
    LexLt(Metadata, Moo<Expression>, Moo<Expression>),
545

            
546
    /// Lexicographical <= between two matrices
547
    LexLeq(Metadata, Moo<Expression>, Moo<Expression>),
548

            
549
    /// Lexicographical > between two matrices
550
    /// This is a parser-level construct, and is immediately normalised to LexLt(b, a)
551
    LexGt(Metadata, Moo<Expression>, Moo<Expression>),
552

            
553
    /// Lexicographical >= between two matrices
554
    /// This is a parser-level construct, and is immediately normalised to LexLeq(b, a)
555
    LexGeq(Metadata, Moo<Expression>, Moo<Expression>),
556

            
557
    /// Low-level minion constraint. See Expression::LexLt
558
    FlatLexLt(Metadata, Vec<Atom>, Vec<Atom>),
559

            
560
    /// Low-level minion constraint. See Expression::LexLeq
561
    FlatLexLeq(Metadata, Vec<Atom>, Vec<Atom>),
562
}
563

            
564
// for the given matrix literal, return a bounded domain from the min to max of applying op to each
565
// child expression.
566
//
567
// Op must be monotonic.
568
//
569
// Returns none if unbounded
570
148347
fn bounded_i32_domain_for_matrix_literal_monotonic(
571
148347
    e: &Expression,
572
148347
    op: fn(i32, i32) -> Option<i32>,
573
148347
) -> Option<DomainPtr> {
574
    // only care about the elements, not the indices
575
148347
    let (mut exprs, _) = e.clone().unwrap_matrix_unchecked()?;
576

            
577
    // fold each element's domain into one using op.
578
    //
579
    // here, I assume that op is monotone. This means that the bounds of op([a1,a2],[b1,b2])  for
580
    // the ranges [a1,a2], [b1,b2] will be
581
    // [min(op(a1,b1),op(a2,b1),op(a1,b2),op(a2,b2)),max(op(a1,b1),op(a2,b1),op(a1,b2),op(a2,b2))].
582
    //
583
    // We used to not assume this, and work out the bounds by applying op on the Cartesian product
584
    // of A and B; however, this caused a combinatorial explosion and my computer to run out of
585
    // memory (on the hakank_eprime_xkcd test)...
586
    //Int
587
    // For example, to find the bounds of the intervals [1,4], [1,5] combined using op, we used to do
588
    //  [min(op(1,1), op(1,2),op(1,3),op(1,4),op(1,5),op(2,1)..
589
    //
590
    // +,-,/,* are all monotone, so this assumption should be fine for now...
591

            
592
144294
    let expr = exprs.pop()?;
593
144293
    let dom = expr.domain_of()?;
594
143600
    let resolved = dom.resolve()?;
595
143600
    let GroundDomain::Int(ranges) = resolved.as_ref() else {
596
1
        return None;
597
    };
598

            
599
143599
    let (mut current_min, mut current_max) = range_vec_bounds_i32(ranges)?;
600

            
601
167350
    for expr in exprs {
602
167350
        let dom = expr.domain_of()?;
603
167308
        let resolved = dom.resolve()?;
604
167308
        let GroundDomain::Int(ranges) = resolved.as_ref() else {
605
            return None;
606
        };
607

            
608
167308
        let (min, max) = range_vec_bounds_i32(ranges)?;
609

            
610
        // all the possible new values for current_min / current_max
611
167308
        let minmax = op(min, current_max)?;
612
167308
        let minmin = op(min, current_min)?;
613
167308
        let maxmin = op(max, current_min)?;
614
167308
        let maxmax = op(max, current_max)?;
615
167308
        let vals = [minmax, minmin, maxmin, maxmax];
616

            
617
167308
        current_min = *vals
618
167308
            .iter()
619
167308
            .min()
620
167308
            .expect("vals iterator should not be empty, and should have a minimum.");
621
167308
        current_max = *vals
622
167308
            .iter()
623
167308
            .max()
624
167308
            .expect("vals iterator should not be empty, and should have a maximum.");
625
    }
626

            
627
143557
    if current_min == current_max {
628
92506
        Some(Domain::int(vec![Range::Single(current_min)]))
629
    } else {
630
51051
        Some(Domain::int(vec![Range::Bounded(current_min, current_max)]))
631
    }
632
148347
}
633

            
634
// Returns none if unbounded
635
310907
fn range_vec_bounds_i32(ranges: &Vec<Range<i32>>) -> Option<(i32, i32)> {
636
310907
    let mut min = i32::MAX;
637
310907
    let mut max = i32::MIN;
638
314120
    for r in ranges {
639
314120
        match r {
640
199691
            Range::Single(i) => {
641
199691
                if *i < min {
642
196478
                    min = *i;
643
196478
                }
644
199691
                if *i > max {
645
199691
                    max = *i;
646
199691
                }
647
            }
648
114429
            Range::Bounded(i, j) => {
649
114429
                if *i < min {
650
114429
                    min = *i;
651
114429
                }
652
114429
                if *j > max {
653
114429
                    max = *j;
654
114429
                }
655
            }
656
            Range::UnboundedR(_) | Range::UnboundedL(_) | Range::Unbounded => return None,
657
        }
658
    }
659
310907
    Some((min, max))
660
310907
}
661

            
662
impl Expression {
663
    /// Returns the possible values of the expression, recursing to leaf expressions
664
1231950
    pub fn domain_of(&self) -> Option<DomainPtr> {
665
1231950
        match self {
666
            Expression::Union(_, a, b) => Some(Domain::set(
667
                SetAttr::<IntVal>::default(),
668
                a.domain_of()?.union(&b.domain_of()?).ok()?,
669
            )),
670
            Expression::Intersect(_, a, b) => Some(Domain::set(
671
                SetAttr::<IntVal>::default(),
672
                a.domain_of()?.intersect(&b.domain_of()?).ok()?,
673
            )),
674
            Expression::In(_, _, _) => Some(Domain::bool()),
675
            Expression::Supset(_, _, _) => Some(Domain::bool()),
676
            Expression::SupsetEq(_, _, _) => Some(Domain::bool()),
677
            Expression::Subset(_, _, _) => Some(Domain::bool()),
678
            Expression::SubsetEq(_, _, _) => Some(Domain::bool()),
679
16926
            Expression::AbstractLiteral(_, abslit) => abslit.domain_of(),
680
            Expression::DominanceRelation(_, _) => Some(Domain::bool()),
681
            Expression::FromSolution(_, expr) => Some(expr.domain_of()),
682
            Expression::Metavar(_, _) => None,
683
            Expression::Comprehension(_, comprehension) => comprehension.domain_of(),
684
            Expression::AbstractComprehension(_, comprehension) => comprehension.domain_of(),
685
92127
            Expression::UnsafeIndex(_, matrix, _) | Expression::SafeIndex(_, matrix, _) => {
686
98763
                let dom = matrix.domain_of()?;
687
98763
                if let Some((elem_domain, _)) = dom.as_matrix() {
688
98763
                    return Some(elem_domain);
689
                }
690

            
691
                // may actually use the value in the future
692
                #[allow(clippy::redundant_pattern_matching)]
693
                if let Some(_) = dom.as_tuple() {
694
                    // TODO: We can implement proper indexing for tuples
695
                    return None;
696
                }
697

            
698
                // may actually use the value in the future
699
                #[allow(clippy::redundant_pattern_matching)]
700
                if let Some(_) = dom.as_record() {
701
                    // TODO: We can implement proper indexing for records
702
                    return None;
703
                }
704

            
705
                bug!("subject of an index operation should support indexing")
706
            }
707
            Expression::UnsafeSlice(_, matrix, indices)
708
168
            | Expression::SafeSlice(_, matrix, indices) => {
709
168
                let sliced_dimension = indices.iter().position(Option::is_none);
710

            
711
168
                let dom = matrix.domain_of()?;
712
168
                let Some((elem_domain, index_domains)) = dom.as_matrix() else {
713
                    bug!("subject of an index operation should be a matrix");
714
                };
715

            
716
168
                match sliced_dimension {
717
168
                    Some(dimension) => Some(Domain::matrix(
718
168
                        elem_domain,
719
168
                        vec![index_domains[dimension].clone()],
720
168
                    )),
721

            
722
                    // same as index
723
                    None => Some(elem_domain),
724
                }
725
            }
726
            Expression::InDomain(_, _, _) => Some(Domain::bool()),
727
820641
            Expression::Atomic(_, atom) => Some(atom.domain_of()),
728
38307
            Expression::Sum(_, e) => {
729
227476
                bounded_i32_domain_for_matrix_literal_monotonic(e, |x, y| Some(x + y))
730
            }
731
108528
            Expression::Product(_, e) => {
732
434280
                bounded_i32_domain_for_matrix_literal_monotonic(e, |x, y| Some(x * y))
733
            }
734
4452
            Expression::Min(_, e) => bounded_i32_domain_for_matrix_literal_monotonic(e, |x, y| {
735
4452
                Some(if x < y { x } else { y })
736
4452
            }),
737
3024
            Expression::Max(_, e) => bounded_i32_domain_for_matrix_literal_monotonic(e, |x, y| {
738
3024
                Some(if x > y { x } else { y })
739
3024
            }),
740
46158
            Expression::UnsafeDiv(_, a, b) => a
741
46158
                .domain_of()?
742
46158
                .resolve()?
743
46158
                .apply_i32(
744
                    // rust integer division is truncating; however, we want to always round down,
745
                    // including for negative numbers.
746
46809
                    |x, y| {
747
46809
                        if y != 0 {
748
46704
                            Some((x as f32 / y as f32).floor() as i32)
749
                        } else {
750
105
                            None
751
                        }
752
46809
                    },
753
46158
                    b.domain_of()?.resolve()?.as_ref(),
754
                )
755
46158
                .map(DomainPtr::from)
756
46158
                .ok(),
757
1449
            Expression::SafeDiv(_, a, b) => {
758
                // rust integer division is truncating; however, we want to always round down
759
                // including for negative numbers.
760
1449
                let domain = a
761
1449
                    .domain_of()?
762
1449
                    .resolve()?
763
1449
                    .apply_i32(
764
39837
                        |x, y| {
765
39837
                            if y != 0 {
766
35994
                                Some((x as f32 / y as f32).floor() as i32)
767
                            } else {
768
3843
                                None
769
                            }
770
39837
                        },
771
1449
                        b.domain_of()?.resolve()?.as_ref(),
772
                    )
773
                    .unwrap_or_else(|err| bug!("Got {err} when computing domain of {self}"));
774

            
775
1449
                if let GroundDomain::Int(ranges) = domain {
776
1449
                    let mut ranges = ranges;
777
1449
                    ranges.push(Range::Single(0));
778
1449
                    Some(Domain::int(ranges))
779
                } else {
780
                    bug!("Domain of {self} was not integer")
781
                }
782
            }
783
            Expression::UnsafeMod(_, a, b) => a
784
                .domain_of()?
785
                .resolve()?
786
                .apply_i32(
787
                    |x, y| if y != 0 { Some(x % y) } else { None },
788
                    b.domain_of()?.resolve()?.as_ref(),
789
                )
790
                .map(DomainPtr::from)
791
                .ok(),
792
462
            Expression::SafeMod(_, a, b) => {
793
462
                let domain = a
794
462
                    .domain_of()?
795
462
                    .resolve()?
796
462
                    .apply_i32(
797
12621
                        |x, y| if y != 0 { Some(x % y) } else { None },
798
462
                        b.domain_of()?.resolve()?.as_ref(),
799
                    )
800
                    .unwrap_or_else(|err| bug!("Got {err} when computing domain of {self}"));
801

            
802
462
                if let GroundDomain::Int(ranges) = domain {
803
462
                    let mut ranges = ranges;
804
462
                    ranges.push(Range::Single(0));
805
462
                    Some(Domain::int(ranges))
806
                } else {
807
                    bug!("Domain of {self} was not integer")
808
                }
809
            }
810
420
            Expression::SafePow(_, a, b) | Expression::UnsafePow(_, a, b) => a
811
420
                .domain_of()?
812
420
                .resolve()?
813
420
                .apply_i32(
814
10878
                    |x, y| {
815
10878
                        if (x != 0 || y != 0) && y >= 0 {
816
10458
                            Some(x.pow(y as u32))
817
                        } else {
818
420
                            None
819
                        }
820
10878
                    },
821
420
                    b.domain_of()?.resolve()?.as_ref(),
822
                )
823
420
                .map(DomainPtr::from)
824
420
                .ok(),
825
            Expression::Root(_, _) => None,
826
105
            Expression::Bubble(_, inner, _) => inner.domain_of(),
827
            Expression::AuxDeclaration(_, _, _) => Some(Domain::bool()),
828
1092
            Expression::And(_, _) => Some(Domain::bool()),
829
252
            Expression::Not(_, _) => Some(Domain::bool()),
830
21
            Expression::Or(_, _) => Some(Domain::bool()),
831
105
            Expression::Imply(_, _, _) => Some(Domain::bool()),
832
            Expression::Iff(_, _, _) => Some(Domain::bool()),
833
630
            Expression::Eq(_, _, _) => Some(Domain::bool()),
834
            Expression::Neq(_, _, _) => Some(Domain::bool()),
835
21
            Expression::Geq(_, _, _) => Some(Domain::bool()),
836
546
            Expression::Leq(_, _, _) => Some(Domain::bool()),
837
126
            Expression::Gt(_, _, _) => Some(Domain::bool()),
838
            Expression::Lt(_, _, _) => Some(Domain::bool()),
839
            Expression::FlatAbsEq(_, _, _) => Some(Domain::bool()),
840
21
            Expression::FlatSumGeq(_, _, _) => Some(Domain::bool()),
841
            Expression::FlatSumLeq(_, _, _) => Some(Domain::bool()),
842
            Expression::MinionDivEqUndefZero(_, _, _, _) => Some(Domain::bool()),
843
            Expression::MinionModuloEqUndefZero(_, _, _, _) => Some(Domain::bool()),
844
42
            Expression::FlatIneq(_, _, _, _) => Some(Domain::bool()),
845
210
            Expression::Flatten(_, n, m) => {
846
210
                if let Some(expr) = n {
847
                    if expr.return_type() == ReturnType::Int {
848
                        // TODO: handle flatten with depth argument
849
                        return None;
850
                    }
851
                } else {
852
                    // TODO: currently only works for matrices
853
210
                    let dom = m.domain_of()?.resolve()?;
854
210
                    let (val_dom, idx_doms) = match dom.as_ref() {
855
210
                        GroundDomain::Matrix(val, idx) => (val, idx),
856
                        _ => return None,
857
                    };
858
210
                    let num_elems = matrix::num_elements(idx_doms).ok()? as i32;
859

            
860
210
                    let new_index_domain = Domain::int(vec![Range::Bounded(1, num_elems)]);
861
210
                    return Some(Domain::matrix(
862
210
                        val_dom.clone().into(),
863
210
                        vec![new_index_domain],
864
210
                    ));
865
                }
866
                None
867
            }
868
            Expression::AllDiff(_, _) => Some(Domain::bool()),
869
            Expression::Table(_, _, _) => Some(Domain::bool()),
870
            Expression::FlatWatchedLiteral(_, _, _) => Some(Domain::bool()),
871
            Expression::MinionReify(_, _, _) => Some(Domain::bool()),
872
21
            Expression::MinionReifyImply(_, _, _) => Some(Domain::bool()),
873
            Expression::MinionWInIntervalSet(_, _, _) => Some(Domain::bool()),
874
            Expression::MinionWInSet(_, _, _) => Some(Domain::bool()),
875
            Expression::MinionElementOne(_, _, _, _) => Some(Domain::bool()),
876
1281
            Expression::Neg(_, x) => {
877
1281
                let dom = x.domain_of()?;
878
1281
                let mut ranges = dom.as_int()?;
879

            
880
546
                ranges = ranges
881
546
                    .into_iter()
882
546
                    .map(|r| match r {
883
84
                        Range::Single(x) => Range::Single(-x),
884
462
                        Range::Bounded(x, y) => Range::Bounded(-y, -x),
885
                        Range::UnboundedR(i) => Range::UnboundedL(-i),
886
                        Range::UnboundedL(i) => Range::UnboundedR(-i),
887
                        Range::Unbounded => Range::Unbounded,
888
546
                    })
889
546
                    .collect();
890

            
891
546
                Some(Domain::int(ranges))
892
            }
893
92253
            Expression::Minus(_, a, b) => a
894
92253
                .domain_of()?
895
92253
                .resolve()?
896
100800
                .apply_i32(|x, y| Some(x - y), b.domain_of()?.resolve()?.as_ref())
897
92253
                .map(DomainPtr::from)
898
92253
                .ok(),
899
            Expression::FlatAllDiff(_, _) => Some(Domain::bool()),
900
            Expression::FlatMinusEq(_, _, _) => Some(Domain::bool()),
901
            Expression::FlatProductEq(_, _, _, _) => Some(Domain::bool()),
902
            Expression::FlatWeightedSumLeq(_, _, _, _) => Some(Domain::bool()),
903
            Expression::FlatWeightedSumGeq(_, _, _, _) => Some(Domain::bool()),
904
609
            Expression::Abs(_, a) => a
905
609
                .domain_of()?
906
609
                .resolve()?
907
101703
                .apply_i32(|a, _| Some(a.abs()), a.domain_of()?.resolve()?.as_ref())
908
609
                .map(DomainPtr::from)
909
609
                .ok(),
910
            Expression::MinionPow(_, _, _, _) => Some(Domain::bool()),
911
441
            Expression::ToInt(_, _) => Some(Domain::int(vec![Range::Bounded(0, 1)])),
912
840
            Expression::SATInt(_, _, _, (low, high)) => {
913
840
                Some(Domain::int_ground(vec![Range::Bounded(*low, *high)]))
914
            }
915
            Expression::PairwiseSum(_, a, b) => a
916
                .domain_of()?
917
                .resolve()?
918
                .apply_i32(|a, b| Some(a + b), b.domain_of()?.resolve()?.as_ref())
919
                .map(DomainPtr::from)
920
                .ok(),
921
            Expression::PairwiseProduct(_, a, b) => a
922
                .domain_of()?
923
                .resolve()?
924
                .apply_i32(|a, b| Some(a * b), b.domain_of()?.resolve()?.as_ref())
925
                .map(DomainPtr::from)
926
                .ok(),
927
            Expression::Defined(_, function) => get_function_domain(function),
928
            Expression::Range(_, function) => get_function_codomain(function),
929
            Expression::Image(_, function, _) => get_function_codomain(function),
930
            Expression::ImageSet(_, function, _) => get_function_codomain(function),
931
            Expression::PreImage(_, function, _) => get_function_domain(function),
932
            Expression::Restrict(_, function, new_domain) => {
933
                let (attrs, _, codom) = function.domain_of()?.as_function()?;
934
                let new_dom = new_domain.domain_of()?;
935
                Some(Domain::function(attrs, new_dom, codom))
936
            }
937
            Expression::Inverse(..) => Some(Domain::bool()),
938
            Expression::LexLt(..) => Some(Domain::bool()),
939
            Expression::LexLeq(..) => Some(Domain::bool()),
940
            Expression::LexGt(..) => Some(Domain::bool()),
941
            Expression::LexGeq(..) => Some(Domain::bool()),
942
            Expression::FlatLexLt(..) => Some(Domain::bool()),
943
            Expression::FlatLexLeq(..) => Some(Domain::bool()),
944
        }
945
1231950
    }
946

            
947
    pub fn get_meta(&self) -> Metadata {
948
        let metas: VecDeque<Metadata> = self.children_bi();
949
        metas[0].clone()
950
    }
951

            
952
    pub fn set_meta(&self, meta: Metadata) {
953
        self.transform_bi(&|_| meta.clone());
954
    }
955

            
956
    /// Checks whether this expression is safe.
957
    ///
958
    /// An expression is unsafe if can be undefined, or if any of its children can be undefined.
959
    ///
960
    /// Unsafe expressions are (typically) prefixed with Unsafe in our AST, and can be made
961
    /// safe through the use of bubble rules.
962
32949
    pub fn is_safe(&self) -> bool {
963
        // TODO: memoise in Metadata
964
283815
        for expr in self.universe() {
965
283815
            match expr {
966
                Expression::UnsafeDiv(_, _, _)
967
                | Expression::UnsafeMod(_, _, _)
968
                | Expression::UnsafePow(_, _, _)
969
                | Expression::UnsafeIndex(_, _, _)
970
                | Expression::Bubble(_, _, _)
971
                | Expression::UnsafeSlice(_, _, _) => {
972
903
                    return false;
973
                }
974
282912
                _ => {}
975
            }
976
        }
977
32046
        true
978
32949
    }
979

            
980
    pub fn is_clean(&self) -> bool {
981
        let metadata = self.get_meta();
982
        metadata.clean
983
    }
984

            
985
    pub fn set_clean(&mut self, bool_value: bool) {
986
        let mut metadata = self.get_meta();
987
        metadata.clean = bool_value;
988
        self.set_meta(metadata);
989
    }
990

            
991
    /// True if the expression is an associative and commutative operator
992
3142859
    pub fn is_associative_commutative_operator(&self) -> bool {
993
3142859
        TryInto::<ACOperatorKind>::try_into(self).is_ok()
994
3142859
    }
995

            
996
    /// True if the expression is a matrix literal.
997
    ///
998
    /// This is true for both forms of matrix literals: those with elements of type [`Literal`] and
999
    /// [`Expression`].
3150
    pub fn is_matrix_literal(&self) -> bool {
        matches!(
3150
            self,
            Expression::AbstractLiteral(_, AbstractLiteral::Matrix(_, _))
                | Expression::Atomic(
                    _,
                    Atom::Literal(Literal::AbstractLiteral(AbstractLiteral::Matrix(_, _))),
                )
        )
3150
    }
    /// True iff self and other are both atomic and identical.
    ///
    /// This method is useful to cheaply check equivalence. Assuming CSE is enabled, any unifiable
    /// expressions will be rewritten to a common variable. This is much cheaper than checking the
    /// entire subtrees of `self` and `other`.
27258
    pub fn identical_atom_to(&self, other: &Expression) -> bool {
27258
        let atom1: Result<&Atom, _> = self.try_into();
27258
        let atom2: Result<&Atom, _> = other.try_into();
27258
        if let (Ok(atom1), Ok(atom2)) = (atom1, atom2) {
1932
            atom2 == atom1
        } else {
25326
            false
        }
27258
    }
    /// If the expression is a list, returns a *copied* vector of the inner expressions.
    ///
    /// A list is any a matrix with the domain `int(1..)`. This includes matrix literals without
    /// any explicitly specified domain.
1591495
    pub fn unwrap_list(&self) -> Option<Vec<Expression>> {
1254225
        match self {
1254225
            Expression::AbstractLiteral(_, matrix @ AbstractLiteral::Matrix(_, _)) => {
1254225
                matrix.unwrap_list().cloned()
            }
            Expression::Atomic(
                _,
5733
                Atom::Literal(Literal::AbstractLiteral(matrix @ AbstractLiteral::Matrix(_, _))),
5733
            ) => matrix.unwrap_list().map(|elems| {
4053
                elems
4053
                    .clone()
4053
                    .into_iter()
12894
                    .map(|x: Literal| Expression::Atomic(Metadata::new(), Atom::Literal(x)))
4053
                    .collect_vec()
4053
            }),
331537
            _ => None,
        }
1591495
    }
    /// If the expression is a matrix, gets it elements and index domain.
    ///
    /// **Consider using the safer [`Expression::unwrap_list`] instead.**
    ///
    /// It is generally undefined to edit the length of a matrix unless it is a list (as defined by
    /// [`Expression::unwrap_list`]). Users of this function should ensure that, if the matrix is
    /// reconstructed, the index domain and the number of elements in the matrix remain the same.
1723010
    pub fn unwrap_matrix_unchecked(self) -> Option<(Vec<Expression>, DomainPtr)> {
889710
        match self {
889710
            Expression::AbstractLiteral(_, AbstractLiteral::Matrix(elems, domain)) => {
889710
                Some((elems, domain))
            }
            Expression::Atomic(
                _,
140994
                Atom::Literal(Literal::AbstractLiteral(AbstractLiteral::Matrix(elems, domain))),
            ) => Some((
140994
                elems
140994
                    .into_iter()
279510
                    .map(|x: Literal| Expression::Atomic(Metadata::new(), Atom::Literal(x)))
140994
                    .collect_vec(),
140994
                domain.into(),
            )),
692306
            _ => None,
        }
1723010
    }
    /// For a Root expression, extends the inner vec with the given vec.
    ///
    /// # Panics
    /// Panics if the expression is not Root.
    pub fn extend_root(self, exprs: Vec<Expression>) -> Expression {
        match self {
            Expression::Root(meta, mut children) => {
                children.extend(exprs);
                Expression::Root(meta, children)
            }
            _ => panic!("extend_root called on a non-Root expression"),
        }
    }
    /// Converts the expression to a literal, if possible.
65650
    pub fn into_literal(self) -> Option<Literal> {
61618
        match self {
57187
            Expression::Atomic(_, Atom::Literal(lit)) => Some(lit),
            Expression::AbstractLiteral(_, abslit) => {
                Some(Literal::AbstractLiteral(abslit.into_literals()?))
            }
1911
            Expression::Neg(_, e) => {
1911
                let Literal::Int(i) = Moo::unwrap_or_clone(e).into_literal()? else {
                    bug!("negated literal should be an int");
                };
1911
                Some(Literal::Int(-i))
            }
6552
            _ => None,
        }
65650
    }
    /// If this expression is an associative-commutative operator, return its [ACOperatorKind].
3547235
    pub fn to_ac_operator_kind(&self) -> Option<ACOperatorKind> {
3547235
        TryFrom::try_from(self).ok()
3547235
    }
    /// Returns the categories of all sub-expressions of self.
23415
    pub fn universe_categories(&self) -> HashSet<Category> {
23415
        self.universe()
23415
            .into_iter()
231378
            .map(|x| x.category_of())
23415
            .collect()
23415
    }
}
pub fn get_function_domain(function: &Moo<Expression>) -> Option<DomainPtr> {
    let function_domain = function.domain_of()?;
    match function_domain.resolve().as_ref() {
        Some(d) => {
            match d.as_ref() {
                GroundDomain::Function(_, domain, _) => Some(domain.clone().into()),
                // Not defined for anything other than a function
                _ => None,
            }
        }
        None => {
            match function_domain.as_unresolved()? {
                UnresolvedDomain::Function(_, domain, _) => Some(domain.clone()),
                // Not defined for anything other than a function
                _ => None,
            }
        }
    }
}
pub fn get_function_codomain(function: &Moo<Expression>) -> Option<DomainPtr> {
    let function_domain = function.domain_of()?;
    match function_domain.resolve().as_ref() {
        Some(d) => {
            match d.as_ref() {
                GroundDomain::Function(_, _, codomain) => Some(codomain.clone().into()),
                // Not defined for anything other than a function
                _ => None,
            }
        }
        None => {
            match function_domain.as_unresolved()? {
                UnresolvedDomain::Function(_, _, codomain) => Some(codomain.clone()),
                // Not defined for anything other than a function
                _ => None,
            }
        }
    }
}
impl TryFrom<&Expression> for i32 {
    type Error = ();
100506
    fn try_from(value: &Expression) -> Result<Self, Self::Error> {
100506
        let Expression::Atomic(_, atom) = value else {
66486
            return Err(());
        };
34020
        let Atom::Literal(lit) = atom else {
34020
            return Err(());
        };
        let Literal::Int(i) = lit else {
            return Err(());
        };
        Ok(*i)
100506
    }
}
impl TryFrom<Expression> for i32 {
    type Error = ();
    fn try_from(value: Expression) -> Result<Self, Self::Error> {
        TryFrom::<&Expression>::try_from(&value)
    }
}
impl From<i32> for Expression {
12608
    fn from(i: i32) -> Self {
12608
        Expression::Atomic(Metadata::new(), Atom::Literal(Literal::Int(i)))
12608
    }
}
impl From<bool> for Expression {
6688
    fn from(b: bool) -> Self {
6688
        Expression::Atomic(Metadata::new(), Atom::Literal(Literal::Bool(b)))
6688
    }
}
impl From<Atom> for Expression {
1239
    fn from(value: Atom) -> Self {
1239
        Expression::Atomic(Metadata::new(), value)
1239
    }
}
impl From<Literal> for Expression {
2268
    fn from(value: Literal) -> Self {
2268
        Expression::Atomic(Metadata::new(), value.into())
2268
    }
}
impl From<Moo<Expression>> for Expression {
17157
    fn from(val: Moo<Expression>) -> Self {
17157
        val.as_ref().clone()
17157
    }
}
impl CategoryOf for Expression {
299208
    fn category_of(&self) -> Category {
        // take highest category of all the expressions children
1213779
        let category = self.cata(&move |x,children| {
1213779
            if let Some(max_category) = children.iter().max() {
                // if this expression contains subexpressions, return the maximum category of the
                // subexpressions
368634
                *max_category
            } else {
                // this expression has no children
845145
                let mut max_category = Category::Bottom;
                // calculate the category by looking at all atoms, submodels, comprehensions, and
                // declarationptrs inside this expression
                // this should generically cover all leaf types we currently have in oxide.
                // if x contains submodels (including comprehensions)
845145
                if !Biplate::<Model>::universe_bi(&x).is_empty() {
                    // assume that the category is decision
                    return Category::Decision;
845145
                }
                // if x contains atoms
845943
                if let Some(max_atom_category) = Biplate::<Atom>::universe_bi(&x).iter().map(|x| x.category_of()).max()
                // and those atoms have a higher category than we already know about
845145
                && max_atom_category > max_category{
                    // update category
845145
                    max_category = max_atom_category;
845145
                }
                // if x contains declarationPtrs
845145
                if let Some(max_declaration_category) = Biplate::<DeclarationPtr>::universe_bi(&x).iter().map(|x| x.category_of()).max()
                // and those pointers have a higher category than we already know about
642516
                && max_declaration_category > max_category{
                    // update category
                    max_category = max_declaration_category;
845145
                }
845145
                max_category
            }
1213779
        });
299208
        if cfg!(debug_assertions) {
299208
            trace!(
                category= %category,
                expression= %self,
                "Called Expression::category_of()"
            );
        };
299208
        category
299208
    }
}
impl Display for Expression {
10419381
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
10419381
        match &self {
252
            Expression::Union(_, box1, box2) => {
252
                write!(f, "({} union {})", box1.clone(), box2.clone())
            }
1722
            Expression::In(_, e1, e2) => {
1722
                write!(f, "{e1} in {e2}")
            }
252
            Expression::Intersect(_, box1, box2) => {
252
                write!(f, "({} intersect {})", box1.clone(), box2.clone())
            }
336
            Expression::Supset(_, box1, box2) => {
336
                write!(f, "({} supset {})", box1.clone(), box2.clone())
            }
336
            Expression::SupsetEq(_, box1, box2) => {
336
                write!(f, "({} supsetEq {})", box1.clone(), box2.clone())
            }
420
            Expression::Subset(_, box1, box2) => {
420
                write!(f, "({} subset {})", box1.clone(), box2.clone())
            }
840
            Expression::SubsetEq(_, box1, box2) => {
840
                write!(f, "({} subsetEq {})", box1.clone(), box2.clone())
            }
671118
            Expression::AbstractLiteral(_, l) => l.fmt(f),
25305
            Expression::Comprehension(_, c) => c.fmt(f),
84
            Expression::AbstractComprehension(_, c) => c.fmt(f),
281736
            Expression::UnsafeIndex(_, e1, e2) | Expression::SafeIndex(_, e1, e2) => {
415758
                write!(f, "{e1}{}", pretty_vec(e2))
            }
26124
            Expression::UnsafeSlice(_, e1, es) | Expression::SafeSlice(_, e1, es) => {
48384
                let args = es
48384
                    .iter()
95802
                    .map(|x| match x {
47418
                        Some(x) => format!("{x}"),
48384
                        None => "..".into(),
95802
                    })
48384
                    .join(",");
48384
                write!(f, "{e1}[{args}]")
            }
39480
            Expression::InDomain(_, e, domain) => {
39480
                write!(f, "__inDomain({e},{domain})")
            }
98712
            Expression::Root(_, exprs) => {
98712
                write!(f, "{}", pretty_expressions_as_top_level(exprs))
            }
            Expression::DominanceRelation(_, expr) => write!(f, "DominanceRelation({expr})"),
            Expression::FromSolution(_, expr) => write!(f, "FromSolution({expr})"),
            Expression::Metavar(_, name) => write!(f, "&{name}"),
7587939
            Expression::Atomic(_, atom) => atom.fmt(f),
2835
            Expression::Abs(_, a) => write!(f, "|{a}|"),
244356
            Expression::Sum(_, e) => {
244356
                write!(f, "sum({e})")
            }
64113
            Expression::Product(_, e) => {
64113
                write!(f, "product({e})")
            }
6615
            Expression::Min(_, e) => {
6615
                write!(f, "min({e})")
            }
5838
            Expression::Max(_, e) => {
5838
                write!(f, "max({e})")
            }
6279
            Expression::Not(_, expr_box) => {
6279
                write!(f, "!({})", expr_box.clone())
            }
48363
            Expression::Or(_, e) => {
48363
                write!(f, "or({e})")
            }
121779
            Expression::And(_, e) => {
121779
                write!(f, "and({e})")
            }
18690
            Expression::Imply(_, box1, box2) => {
18690
                write!(f, "({box1}) -> ({box2})")
            }
798
            Expression::Iff(_, box1, box2) => {
798
                write!(f, "({box1}) <-> ({box2})")
            }
214200
            Expression::Eq(_, box1, box2) => {
214200
                write!(f, "({} = {})", box1.clone(), box2.clone())
            }
59934
            Expression::Neq(_, box1, box2) => {
59934
                write!(f, "({} != {})", box1.clone(), box2.clone())
            }
45444
            Expression::Geq(_, box1, box2) => {
45444
                write!(f, "({} >= {})", box1.clone(), box2.clone())
            }
72870
            Expression::Leq(_, box1, box2) => {
72870
                write!(f, "({} <= {})", box1.clone(), box2.clone())
            }
3108
            Expression::Gt(_, box1, box2) => {
3108
                write!(f, "({} > {})", box1.clone(), box2.clone())
            }
25662
            Expression::Lt(_, box1, box2) => {
25662
                write!(f, "({} < {})", box1.clone(), box2.clone())
            }
48573
            Expression::FlatSumGeq(_, box1, box2) => {
48573
                write!(f, "SumGeq({}, {})", pretty_vec(box1), box2.clone())
            }
47292
            Expression::FlatSumLeq(_, box1, box2) => {
47292
                write!(f, "SumLeq({}, {})", pretty_vec(box1), box2.clone())
            }
16212
            Expression::FlatIneq(_, box1, box2, box3) => write!(
16212
                f,
                "Ineq({}, {}, {})",
16212
                box1.clone(),
16212
                box2.clone(),
16212
                box3.clone()
            ),
2184
            Expression::Flatten(_, n, m) => {
2184
                if let Some(n) = n {
                    write!(f, "flatten({n}, {m})")
                } else {
2184
                    write!(f, "flatten({m})")
                }
            }
18648
            Expression::AllDiff(_, e) => {
18648
                write!(f, "allDiff({e})")
            }
504
            Expression::Table(_, tuple_expr, rows_expr) => {
504
                write!(f, "table({tuple_expr}, {rows_expr})")
            }
28476
            Expression::Bubble(_, box1, box2) => {
28476
                write!(f, "{{{} @ {}}}", box1.clone(), box2.clone())
            }
10815
            Expression::SafeDiv(_, box1, box2) => {
10815
                write!(f, "SafeDiv({}, {})", box1.clone(), box2.clone())
            }
3444
            Expression::UnsafeDiv(_, box1, box2) => {
3444
                write!(f, "UnsafeDiv({}, {})", box1.clone(), box2.clone())
            }
2352
            Expression::UnsafePow(_, box1, box2) => {
2352
                write!(f, "UnsafePow({}, {})", box1.clone(), box2.clone())
            }
3045
            Expression::SafePow(_, box1, box2) => {
3045
                write!(f, "SafePow({}, {})", box1.clone(), box2.clone())
            }
1764
            Expression::MinionDivEqUndefZero(_, box1, box2, box3) => {
1764
                write!(
1764
                    f,
                    "DivEq({}, {}, {})",
1764
                    box1.clone(),
1764
                    box2.clone(),
1764
                    box3.clone()
                )
            }
756
            Expression::MinionModuloEqUndefZero(_, box1, box2, box3) => {
756
                write!(
756
                    f,
                    "ModEq({}, {}, {})",
756
                    box1.clone(),
756
                    box2.clone(),
756
                    box3.clone()
                )
            }
1596
            Expression::FlatWatchedLiteral(_, x, l) => {
1596
                write!(f, "WatchedLiteral({x},{l})")
            }
14952
            Expression::MinionReify(_, box1, box2) => {
14952
                write!(f, "Reify({}, {})", box1.clone(), box2.clone())
            }
3591
            Expression::MinionReifyImply(_, box1, box2) => {
3591
                write!(f, "ReifyImply({}, {})", box1.clone(), box2.clone())
            }
378
            Expression::MinionWInIntervalSet(_, atom, intervals) => {
378
                let intervals = intervals.iter().join(",");
378
                write!(f, "__minion_w_inintervalset({atom},[{intervals}])")
            }
336
            Expression::MinionWInSet(_, atom, values) => {
336
                let values = values.iter().join(",");
336
                write!(f, "__minion_w_inset({atom},[{values}])")
            }
36918
            Expression::AuxDeclaration(_, reference, e) => {
36918
                write!(f, "{} =aux {}", reference, e.clone())
            }
1764
            Expression::UnsafeMod(_, a, b) => {
1764
                write!(f, "{} % {}", a.clone(), b.clone())
            }
4662
            Expression::SafeMod(_, a, b) => {
4662
                write!(f, "SafeMod({},{})", a.clone(), b.clone())
            }
25452
            Expression::Neg(_, a) => {
25452
                write!(f, "-({})", a.clone())
            }
68397
            Expression::Minus(_, a, b) => {
68397
                write!(f, "({} - {})", a.clone(), b.clone())
            }
8736
            Expression::FlatAllDiff(_, es) => {
8736
                write!(f, "__flat_alldiff({})", pretty_vec(es))
            }
462
            Expression::FlatAbsEq(_, a, b) => {
462
                write!(f, "AbsEq({},{})", a.clone(), b.clone())
            }
420
            Expression::FlatMinusEq(_, a, b) => {
420
                write!(f, "MinusEq({},{})", a.clone(), b.clone())
            }
777
            Expression::FlatProductEq(_, a, b, c) => {
777
                write!(
777
                    f,
                    "FlatProductEq({},{},{})",
777
                    a.clone(),
777
                    b.clone(),
777
                    c.clone()
                )
            }
9576
            Expression::FlatWeightedSumLeq(_, cs, vs, total) => {
9576
                write!(
9576
                    f,
                    "FlatWeightedSumLeq({},{},{})",
9576
                    pretty_vec(cs),
9576
                    pretty_vec(vs),
9576
                    total.clone()
                )
            }
9807
            Expression::FlatWeightedSumGeq(_, cs, vs, total) => {
9807
                write!(
9807
                    f,
                    "FlatWeightedSumGeq({},{},{})",
9807
                    pretty_vec(cs),
9807
                    pretty_vec(vs),
9807
                    total.clone()
                )
            }
672
            Expression::MinionPow(_, atom, atom1, atom2) => {
672
                write!(f, "MinionPow({atom},{atom1},{atom2})")
            }
7770
            Expression::MinionElementOne(_, atoms, atom, atom1) => {
7770
                let atoms = atoms.iter().join(",");
7770
                write!(f, "__minion_element_one([{atoms}],{atom},{atom1})")
            }
504
            Expression::ToInt(_, expr) => {
504
                write!(f, "toInt({expr})")
            }
187173
            Expression::SATInt(_, encoding, bits, (min, max)) => {
187173
                write!(f, "SATInt({encoding:?}, {bits} [{min}, {max}])")
            }
            Expression::PairwiseSum(_, a, b) => write!(f, "PairwiseSum({a}, {b})"),
            Expression::PairwiseProduct(_, a, b) => write!(f, "PairwiseProduct({a}, {b})"),
42
            Expression::Defined(_, function) => write!(f, "defined({function})"),
42
            Expression::Range(_, function) => write!(f, "range({function})"),
42
            Expression::Image(_, function, elems) => write!(f, "image({function},{elems})"),
42
            Expression::ImageSet(_, function, elems) => write!(f, "imageSet({function},{elems})"),
42
            Expression::PreImage(_, function, elems) => write!(f, "preImage({function},{elems})"),
42
            Expression::Inverse(_, a, b) => write!(f, "inverse({a},{b})"),
42
            Expression::Restrict(_, function, domain) => write!(f, "restrict({function},{domain})"),
588
            Expression::LexLt(_, a, b) => write!(f, "({a} <lex {b})"),
18417
            Expression::LexLeq(_, a, b) => write!(f, "({a} <=lex {b})"),
            Expression::LexGt(_, a, b) => write!(f, "({a} >lex {b})"),
            Expression::LexGeq(_, a, b) => write!(f, "({a} >=lex {b})"),
84
            Expression::FlatLexLt(_, a, b) => {
84
                write!(f, "FlatLexLt({}, {})", pretty_vec(a), pretty_vec(b))
            }
168
            Expression::FlatLexLeq(_, a, b) => {
168
                write!(f, "FlatLexLeq({}, {})", pretty_vec(a), pretty_vec(b))
            }
        }
10419381
    }
}
impl Typeable for Expression {
375396
    fn return_type(&self) -> ReturnType {
375396
        match self {
            Expression::Union(_, subject, _) => ReturnType::Set(Box::new(subject.return_type())),
            Expression::Intersect(_, subject, _) => {
                ReturnType::Set(Box::new(subject.return_type()))
            }
210
            Expression::In(_, _, _) => ReturnType::Bool,
            Expression::Supset(_, _, _) => ReturnType::Bool,
            Expression::SupsetEq(_, _, _) => ReturnType::Bool,
            Expression::Subset(_, _, _) => ReturnType::Bool,
            Expression::SubsetEq(_, _, _) => ReturnType::Bool,
12978
            Expression::AbstractLiteral(_, lit) => lit.return_type(),
36477
            Expression::UnsafeIndex(_, subject, idx) | Expression::SafeIndex(_, subject, idx) => {
64407
                let subject_ty = subject.return_type();
64407
                match subject_ty {
                    ReturnType::Matrix(_) => {
                        // For n-dimensional matrices, unwrap the element type until
                        // we either get to the innermost element type or the last index
62769
                        let mut elem_typ = subject_ty;
62769
                        let mut idx_len = idx.len();
125664
                        while idx_len > 0
74865
                            && let ReturnType::Matrix(new_elem_typ) = &elem_typ
62895
                        {
62895
                            elem_typ = *new_elem_typ.clone();
62895
                            idx_len -= 1;
62895
                        }
62769
                        elem_typ
                    }
                    // TODO: We can implement indexing for these eventually
1638
                    ReturnType::Record(_) | ReturnType::Tuple(_) => ReturnType::Unknown,
                    _ => bug!(
                        "Invalid indexing operation: expected the operand to be a collection, got {self}: {subject_ty}"
                    ),
                }
            }
1008
            Expression::UnsafeSlice(_, subject, _) | Expression::SafeSlice(_, subject, _) => {
1008
                ReturnType::Matrix(Box::new(subject.return_type()))
            }
            Expression::InDomain(_, _, _) => ReturnType::Bool,
            Expression::Comprehension(_, comp) => comp.return_type(),
            Expression::AbstractComprehension(_, comp) => comp.return_type(),
            Expression::Root(_, _) => ReturnType::Bool,
            Expression::DominanceRelation(_, _) => ReturnType::Bool,
            Expression::FromSolution(_, expr) => expr.return_type(),
            Expression::Metavar(_, _) => ReturnType::Unknown,
226590
            Expression::Atomic(_, atom) => atom.return_type(),
231
            Expression::Abs(_, _) => ReturnType::Int,
43449
            Expression::Sum(_, _) => ReturnType::Int,
3528
            Expression::Product(_, _) => ReturnType::Int,
462
            Expression::Min(_, _) => ReturnType::Int,
441
            Expression::Max(_, _) => ReturnType::Int,
63
            Expression::Not(_, _) => ReturnType::Bool,
189
            Expression::Or(_, _) => ReturnType::Bool,
462
            Expression::Imply(_, _, _) => ReturnType::Bool,
            Expression::Iff(_, _, _) => ReturnType::Bool,
1281
            Expression::And(_, _) => ReturnType::Bool,
3276
            Expression::Eq(_, _, _) => ReturnType::Bool,
189
            Expression::Neq(_, _, _) => ReturnType::Bool,
42
            Expression::Geq(_, _, _) => ReturnType::Bool,
1008
            Expression::Leq(_, _, _) => ReturnType::Bool,
42
            Expression::Gt(_, _, _) => ReturnType::Bool,
            Expression::Lt(_, _, _) => ReturnType::Bool,
3738
            Expression::SafeDiv(_, _, _) => ReturnType::Int,
609
            Expression::UnsafeDiv(_, _, _) => ReturnType::Int,
            Expression::FlatAllDiff(_, _) => ReturnType::Bool,
21
            Expression::FlatSumGeq(_, _, _) => ReturnType::Bool,
            Expression::FlatSumLeq(_, _, _) => ReturnType::Bool,
            Expression::MinionDivEqUndefZero(_, _, _, _) => ReturnType::Bool,
42
            Expression::FlatIneq(_, _, _, _) => ReturnType::Bool,
504
            Expression::Flatten(_, _, matrix) => {
504
                let matrix_type = matrix.return_type();
504
                match matrix_type {
                    ReturnType::Matrix(_) => {
                        // unwrap until we get to innermost element
504
                        let mut elem_type = matrix_type;
1008
                        while let ReturnType::Matrix(new_elem_type) = &elem_type {
504
                            elem_type = *new_elem_type.clone();
504
                        }
504
                        ReturnType::Matrix(Box::new(elem_type))
                    }
                    _ => bug!(
                        "Invalid indexing operation: expected the operand to be a collection, got {self}: {matrix_type}"
                    ),
                }
            }
105
            Expression::AllDiff(_, _) => ReturnType::Bool,
            Expression::Table(_, _, _) => ReturnType::Bool,
798
            Expression::Bubble(_, inner, _) => inner.return_type(),
            Expression::FlatWatchedLiteral(_, _, _) => ReturnType::Bool,
            Expression::MinionReify(_, _, _) => ReturnType::Bool,
21
            Expression::MinionReifyImply(_, _, _) => ReturnType::Bool,
            Expression::MinionWInIntervalSet(_, _, _) => ReturnType::Bool,
            Expression::MinionWInSet(_, _, _) => ReturnType::Bool,
            Expression::MinionElementOne(_, _, _, _) => ReturnType::Bool,
            Expression::AuxDeclaration(_, _, _) => ReturnType::Bool,
441
            Expression::UnsafeMod(_, _, _) => ReturnType::Int,
1785
            Expression::SafeMod(_, _, _) => ReturnType::Int,
            Expression::MinionModuloEqUndefZero(_, _, _, _) => ReturnType::Bool,
2037
            Expression::Neg(_, _) => ReturnType::Int,
252
            Expression::UnsafePow(_, _, _) => ReturnType::Int,
1428
            Expression::SafePow(_, _, _) => ReturnType::Int,
399
            Expression::Minus(_, _, _) => ReturnType::Int,
            Expression::FlatAbsEq(_, _, _) => ReturnType::Bool,
            Expression::FlatMinusEq(_, _, _) => ReturnType::Bool,
            Expression::FlatProductEq(_, _, _, _) => ReturnType::Bool,
            Expression::FlatWeightedSumLeq(_, _, _, _) => ReturnType::Bool,
            Expression::FlatWeightedSumGeq(_, _, _, _) => ReturnType::Bool,
            Expression::MinionPow(_, _, _, _) => ReturnType::Bool,
84
            Expression::ToInt(_, _) => ReturnType::Int,
2310
            Expression::SATInt(..) => ReturnType::Int,
            Expression::PairwiseSum(_, _, _) => ReturnType::Int,
            Expression::PairwiseProduct(_, _, _) => ReturnType::Int,
            Expression::Defined(_, function) => {
                let subject = function.return_type();
                match subject {
                    ReturnType::Function(domain, _) => *domain,
                    _ => bug!(
                        "Invalid defined operation: expected the operand to be a function, got {self}: {subject}"
                    ),
                }
            }
            Expression::Range(_, function) => {
                let subject = function.return_type();
                match subject {
                    ReturnType::Function(_, codomain) => *codomain,
                    _ => bug!(
                        "Invalid range operation: expected the operand to be a function, got {self}: {subject}"
                    ),
                }
            }
            Expression::Image(_, function, _) => {
                let subject = function.return_type();
                match subject {
                    ReturnType::Function(_, codomain) => *codomain,
                    _ => bug!(
                        "Invalid image operation: expected the operand to be a function, got {self}: {subject}"
                    ),
                }
            }
            Expression::ImageSet(_, function, _) => {
                let subject = function.return_type();
                match subject {
                    ReturnType::Function(_, codomain) => *codomain,
                    _ => bug!(
                        "Invalid imageSet operation: expected the operand to be a function, got {self}: {subject}"
                    ),
                }
            }
            Expression::PreImage(_, function, _) => {
                let subject = function.return_type();
                match subject {
                    ReturnType::Function(domain, _) => *domain,
                    _ => bug!(
                        "Invalid preImage operation: expected the operand to be a function, got {self}: {subject}"
                    ),
                }
            }
            Expression::Restrict(_, function, new_domain) => {
                let subject = function.return_type();
                match subject {
                    ReturnType::Function(_, codomain) => {
                        ReturnType::Function(Box::new(new_domain.return_type()), codomain)
                    }
                    _ => bug!(
                        "Invalid preImage operation: expected the operand to be a function, got {self}: {subject}"
                    ),
                }
            }
            Expression::Inverse(..) => ReturnType::Bool,
            Expression::LexLt(..) => ReturnType::Bool,
            Expression::LexGt(..) => ReturnType::Bool,
966
            Expression::LexLeq(..) => ReturnType::Bool,
            Expression::LexGeq(..) => ReturnType::Bool,
            Expression::FlatLexLt(..) => ReturnType::Bool,
            Expression::FlatLexLeq(..) => ReturnType::Bool,
        }
375396
    }
}
#[cfg(test)]
mod tests {
    use crate::matrix_expr;
    use super::*;
    #[test]
1
    fn test_domain_of_constant_sum() {
1
        let c1 = Expression::Atomic(Metadata::new(), Atom::Literal(Literal::Int(1)));
1
        let c2 = Expression::Atomic(Metadata::new(), Atom::Literal(Literal::Int(2)));
1
        let sum = Expression::Sum(Metadata::new(), Moo::new(matrix_expr![c1, c2]));
1
        assert_eq!(sum.domain_of(), Some(Domain::int(vec![Range::Single(3)])));
1
    }
    #[test]
1
    fn test_domain_of_constant_invalid_type() {
1
        let c1 = Expression::Atomic(Metadata::new(), Atom::Literal(Literal::Int(1)));
1
        let c2 = Expression::Atomic(Metadata::new(), Atom::Literal(Literal::Bool(true)));
1
        let sum = Expression::Sum(Metadata::new(), Moo::new(matrix_expr![c1, c2]));
1
        assert_eq!(sum.domain_of(), None);
1
    }
    #[test]
1
    fn test_domain_of_empty_sum() {
1
        let sum = Expression::Sum(Metadata::new(), Moo::new(matrix_expr![]));
1
        assert_eq!(sum.domain_of(), None);
1
    }
}