logicaffeine-compile 0.10.0

LOGOS compilation pipeline - codegen and interpreter
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
use std::collections::{HashMap, HashSet};

use crate::arena::Arena;
use crate::ast::stmt::{Expr, Literal, Stmt};
use crate::intern::{Interner, Symbol};
use super::fold;

/// Constant propagation pass.
///
/// Replaces references to immutable variables with their constant values
/// inside `Let` and `Set` value expressions, enabling cascading constant folding.
///
/// Only propagates variables that are:
/// - Declared without `mutable` keyword
/// - Never reassigned via `Set`
/// - Bound to a literal value (after previous fold pass)
///
/// Only substitutes inside `Let`/`Set` value expressions to preserve
/// readable codegen in conditions, returns, and other contexts.
pub fn propagate_stmts<'a>(
    stmts: Vec<Stmt<'a>>,
    expr_arena: &'a Arena<Expr<'a>>,
    stmt_arena: &'a Arena<Stmt<'a>>,
    interner: &mut Interner,
) -> Vec<Stmt<'a>> {
    let mutated = collect_all_set_targets(&stmts);
    let mut env: HashMap<Symbol, &'a Expr<'a>> = HashMap::new();
    propagate_block_stmts(stmts, &mut env, &mutated, expr_arena, stmt_arena, interner)
}

fn propagate_block_stmts<'a>(
    stmts: Vec<Stmt<'a>>,
    env: &mut HashMap<Symbol, &'a Expr<'a>>,
    mutated: &HashSet<Symbol>,
    expr_arena: &'a Arena<Expr<'a>>,
    stmt_arena: &'a Arena<Stmt<'a>>,
    interner: &mut Interner,
) -> Vec<Stmt<'a>> {
    stmts.into_iter().map(|stmt| {
        propagate_stmt(stmt, env, mutated, expr_arena, stmt_arena, interner)
    }).collect()
}

fn propagate_nested_block<'a>(
    block: &'a [Stmt<'a>],
    env: &HashMap<Symbol, &'a Expr<'a>>,
    mutated: &HashSet<Symbol>,
    expr_arena: &'a Arena<Expr<'a>>,
    stmt_arena: &'a Arena<Stmt<'a>>,
    interner: &mut Interner,
) -> &'a [Stmt<'a>] {
    let mut child_env = env.clone();
    let folded: Vec<Stmt<'a>> = block.iter().cloned().map(|stmt| {
        propagate_stmt(stmt, &mut child_env, mutated, expr_arena, stmt_arena, interner)
    }).collect();
    stmt_arena.alloc_slice(folded)
}

fn propagate_stmt<'a>(
    stmt: Stmt<'a>,
    env: &mut HashMap<Symbol, &'a Expr<'a>>,
    mutated: &HashSet<Symbol>,
    expr_arena: &'a Arena<Expr<'a>>,
    stmt_arena: &'a Arena<Stmt<'a>>,
    interner: &mut Interner,
) -> Stmt<'a> {
    match stmt {
        // Substitute + fold in Let values — this is where cascading happens
        Stmt::Let { var, ty, value, mutable } => {
            let propagated = subst_and_fold(value, env, expr_arena, stmt_arena, interner);
            if !mutable && !mutated.contains(&var) && is_propagatable_literal(propagated) {
                env.insert(var, propagated);
            }
            Stmt::Let { var, ty, value: propagated, mutable }
        }
        // Substitute + fold in Set values, and kill the target from env
        Stmt::Set { target, value } => {
            let propagated = subst_and_fold(value, env, expr_arena, stmt_arena, interner);
            env.remove(&target);
            Stmt::Set { target, value: propagated }
        }
        // Substitute + fold in conditions and recurse into nested blocks
        Stmt::If { cond, then_block, else_block } => Stmt::If {
            cond: subst_and_fold(cond, env, expr_arena, stmt_arena, interner),
            then_block: propagate_nested_block(then_block, env, mutated, expr_arena, stmt_arena, interner),
            else_block: else_block.map(|b| propagate_nested_block(b, env, mutated, expr_arena, stmt_arena, interner)),
        },
        Stmt::While { cond, body, decreasing } => Stmt::While {
            cond: subst_and_fold(cond, env, expr_arena, stmt_arena, interner),
            body: propagate_nested_block(body, env, mutated, expr_arena, stmt_arena, interner),
            decreasing,
        },
        Stmt::Repeat { pattern, iterable, body } => Stmt::Repeat {
            pattern,
            iterable: subst_and_fold(iterable, env, expr_arena, stmt_arena, interner),
            body: propagate_nested_block(body, env, mutated, expr_arena, stmt_arena, interner),
        },
        Stmt::FunctionDef { name, params, generics, body, return_type, is_native, native_path, is_exported, export_target, opt_flags } => {
            let func_mutated = collect_all_set_targets_from_block(body);
            let mut func_env: HashMap<Symbol, &'a Expr<'a>> = HashMap::new();
            let new_body: Vec<Stmt<'a>> = body.iter().cloned().map(|stmt| {
                propagate_stmt(stmt, &mut func_env, &func_mutated, expr_arena, stmt_arena, interner)
            }).collect();
            Stmt::FunctionDef {
                name, params, generics,
                body: stmt_arena.alloc_slice(new_body),
                return_type, is_native, native_path, is_exported, export_target, opt_flags,
            }
        }
        Stmt::Inspect { target, arms, has_otherwise } => Stmt::Inspect {
            target,
            arms: arms.into_iter().map(|arm| {
                crate::ast::stmt::MatchArm {
                    enum_name: arm.enum_name,
                    variant: arm.variant,
                    bindings: arm.bindings,
                    body: propagate_nested_block(arm.body, env, mutated, expr_arena, stmt_arena, interner),
                }
            }).collect(),
            has_otherwise,
        },
        Stmt::Zone { name, capacity, source_file, body } => Stmt::Zone {
            name, capacity, source_file,
            body: propagate_zone_block(body, env, mutated, expr_arena, stmt_arena, interner),
        },
        Stmt::Concurrent { tasks } => Stmt::Concurrent {
            tasks: propagate_nested_block(tasks, env, mutated, expr_arena, stmt_arena, interner),
        },
        Stmt::Parallel { tasks } => Stmt::Parallel {
            tasks: propagate_nested_block(tasks, env, mutated, expr_arena, stmt_arena, interner),
        },
        // Substitute + fold in Return, Show, Push, Call, and other expression-bearing stmts
        Stmt::Return { value } => Stmt::Return {
            value: value.map(|v| subst_and_fold(v, env, expr_arena, stmt_arena, interner)),
        },
        Stmt::Show { object, recipient } => Stmt::Show {
            object: subst_and_fold(object, env, expr_arena, stmt_arena, interner),
            recipient: subst_and_fold(recipient, env, expr_arena, stmt_arena, interner),
        },
        Stmt::Push { value, collection } => Stmt::Push {
            value: subst_and_fold(value, env, expr_arena, stmt_arena, interner),
            collection,
        },
        Stmt::Call { function, args } => Stmt::Call {
            function,
            args: args.into_iter().map(|a| subst_and_fold(a, env, expr_arena, stmt_arena, interner)).collect(),
        },
        Stmt::RuntimeAssert { condition, hard } => Stmt::RuntimeAssert {
            condition: subst_and_fold(condition, env, expr_arena, stmt_arena, interner),
            hard,
        },
        // Don't substitute into SetIndex index — preserves AST shape for
        // swap pattern detection in codegen (matching Expr::Index behavior)
        Stmt::SetIndex { collection, index, value } => Stmt::SetIndex {
            collection,
            index,
            value: subst_and_fold(value, env, expr_arena, stmt_arena, interner),
        },
        Stmt::SetField { object, field, value } => Stmt::SetField {
            object,
            field,
            value: subst_and_fold(value, env, expr_arena, stmt_arena, interner),
        },
        Stmt::Give { object, recipient } => Stmt::Give {
            object: subst_and_fold(object, env, expr_arena, stmt_arena, interner),
            recipient: subst_and_fold(recipient, env, expr_arena, stmt_arena, interner),
        },
        // All other statements pass through unchanged
        other => other,
    }
}

/// Propagate inside a zone body without registering zone-scoped bindings.
///
/// Zone-scoped variables must remain as identifiers so the escape checker
/// can detect assignments to outer-scope variables (Hotel California rule).
/// Substituting them with literals would hide escape violations.
fn propagate_zone_block<'a>(
    block: &'a [Stmt<'a>],
    env: &HashMap<Symbol, &'a Expr<'a>>,
    mutated: &HashSet<Symbol>,
    expr_arena: &'a Arena<Expr<'a>>,
    stmt_arena: &'a Arena<Stmt<'a>>,
    interner: &mut Interner,
) -> &'a [Stmt<'a>] {
    let mut child_env = env.clone();
    let folded: Vec<Stmt<'a>> = block.iter().cloned().map(|stmt| {
        match stmt {
            // Substitute in Let values but do NOT add zone-scoped bindings to env
            Stmt::Let { var, ty, value, mutable } => {
                let propagated = subst_and_fold(value, &child_env, expr_arena, stmt_arena, interner);
                // Intentionally do NOT insert into child_env — zone-scoped vars
                // must stay as identifiers for escape analysis
                Stmt::Let { var, ty, value: propagated, mutable }
            }
            // For other statements, delegate to normal propagation
            other => propagate_stmt(other, &mut child_env, mutated, expr_arena, stmt_arena, interner),
        }
    }).collect();
    stmt_arena.alloc_slice(folded)
}

fn is_propagatable_literal(expr: &Expr) -> bool {
    matches!(expr, Expr::Literal(Literal::Number(_) | Literal::Float(_) | Literal::Boolean(_) | Literal::Nothing | Literal::Text(_)))
}

/// Substitute identifiers from env, then fold the result.
fn subst_and_fold<'a>(
    expr: &'a Expr<'a>,
    env: &HashMap<Symbol, &'a Expr<'a>>,
    expr_arena: &'a Arena<Expr<'a>>,
    stmt_arena: &'a Arena<Stmt<'a>>,
    interner: &mut Interner,
) -> &'a Expr<'a> {
    let substituted = substitute_identifiers(expr, env, expr_arena);
    fold::fold_expr(substituted, expr_arena, stmt_arena, interner, &fold::BoolSyms::new())
}

/// Recursively substitute identifiers with their constant values from env.
fn substitute_identifiers<'a>(
    expr: &'a Expr<'a>,
    env: &HashMap<Symbol, &'a Expr<'a>>,
    arena: &'a Arena<Expr<'a>>,
) -> &'a Expr<'a> {
    if env.is_empty() {
        return expr;
    }
    match expr {
        Expr::Identifier(sym) => {
            if let Some(value) = env.get(sym) { value } else { expr }
        }
        Expr::BinaryOp { op, left, right } => {
            let sl = substitute_identifiers(left, env, arena);
            let sr = substitute_identifiers(right, env, arena);
            if std::ptr::eq(sl, *left) && std::ptr::eq(sr, *right) {
                expr
            } else {
                arena.alloc(Expr::BinaryOp { op: *op, left: sl, right: sr })
            }
        }
        Expr::Call { function, args } => {
            let sa: Vec<&'a Expr<'a>> = args.iter().map(|a| substitute_identifiers(a, env, arena)).collect();
            let changed = sa.iter().zip(args.iter()).any(|(s, o)| !std::ptr::eq(*s, *o));
            if changed { arena.alloc(Expr::Call { function: *function, args: sa }) } else { expr }
        }
        Expr::CallExpr { callee, args } => {
            let sc = substitute_identifiers(callee, env, arena);
            let sa: Vec<&'a Expr<'a>> = args.iter().map(|a| substitute_identifiers(a, env, arena)).collect();
            let args_changed = sa.iter().zip(args.iter()).any(|(s, o)| !std::ptr::eq(*s, *o));
            if std::ptr::eq(sc, *callee) && !args_changed { expr }
            else { arena.alloc(Expr::CallExpr { callee: sc, args: sa }) }
        }
        // Don't substitute inside Index/Slice — preserves AST shape for
        // swap/for-range/vec-fill pattern detection in codegen
        Expr::Index { .. } => expr,
        Expr::Slice { .. } => expr,
        Expr::Contains { collection, value } => {
            let sc = substitute_identifiers(collection, env, arena);
            let sv = substitute_identifiers(value, env, arena);
            if std::ptr::eq(sc, *collection) && std::ptr::eq(sv, *value) { expr }
            else { arena.alloc(Expr::Contains { collection: sc, value: sv }) }
        }
        Expr::Union { left, right } => {
            let sl = substitute_identifiers(left, env, arena);
            let sr = substitute_identifiers(right, env, arena);
            if std::ptr::eq(sl, *left) && std::ptr::eq(sr, *right) { expr }
            else { arena.alloc(Expr::Union { left: sl, right: sr }) }
        }
        Expr::Intersection { left, right } => {
            let sl = substitute_identifiers(left, env, arena);
            let sr = substitute_identifiers(right, env, arena);
            if std::ptr::eq(sl, *left) && std::ptr::eq(sr, *right) { expr }
            else { arena.alloc(Expr::Intersection { left: sl, right: sr }) }
        }
        Expr::Range { start, end } => {
            let ss = substitute_identifiers(start, env, arena);
            let se = substitute_identifiers(end, env, arena);
            if std::ptr::eq(ss, *start) && std::ptr::eq(se, *end) { expr }
            else { arena.alloc(Expr::Range { start: ss, end: se }) }
        }
        Expr::ChunkAt { index, zone } => {
            let si = substitute_identifiers(index, env, arena);
            let sz = substitute_identifiers(zone, env, arena);
            if std::ptr::eq(si, *index) && std::ptr::eq(sz, *zone) { expr }
            else { arena.alloc(Expr::ChunkAt { index: si, zone: sz }) }
        }
        Expr::WithCapacity { value, capacity } => {
            let sv = substitute_identifiers(value, env, arena);
            let sc = substitute_identifiers(capacity, env, arena);
            if std::ptr::eq(sv, *value) && std::ptr::eq(sc, *capacity) { expr }
            else { arena.alloc(Expr::WithCapacity { value: sv, capacity: sc }) }
        }
        Expr::Copy { expr: inner } => {
            let si = substitute_identifiers(inner, env, arena);
            if std::ptr::eq(si, *inner) { expr } else { arena.alloc(Expr::Copy { expr: si }) }
        }
        Expr::Give { value } => {
            let sv = substitute_identifiers(value, env, arena);
            if std::ptr::eq(sv, *value) { expr } else { arena.alloc(Expr::Give { value: sv }) }
        }
        Expr::Length { collection } => {
            let sc = substitute_identifiers(collection, env, arena);
            if std::ptr::eq(sc, *collection) { expr } else { arena.alloc(Expr::Length { collection: sc }) }
        }
        Expr::ManifestOf { zone } => {
            let sz = substitute_identifiers(zone, env, arena);
            if std::ptr::eq(sz, *zone) { expr } else { arena.alloc(Expr::ManifestOf { zone: sz }) }
        }
        Expr::FieldAccess { object, field } => {
            let so = substitute_identifiers(object, env, arena);
            if std::ptr::eq(so, *object) { expr } else { arena.alloc(Expr::FieldAccess { object: so, field: *field }) }
        }
        Expr::OptionSome { value } => {
            let sv = substitute_identifiers(value, env, arena);
            if std::ptr::eq(sv, *value) { expr } else { arena.alloc(Expr::OptionSome { value: sv }) }
        }
        Expr::Not { operand } => {
            let so = substitute_identifiers(operand, env, arena);
            if std::ptr::eq(so, *operand) { expr } else { arena.alloc(Expr::Not { operand: so }) }
        }
        Expr::List(elems) => {
            let se: Vec<&'a Expr<'a>> = elems.iter().map(|e| substitute_identifiers(e, env, arena)).collect();
            let changed = se.iter().zip(elems.iter()).any(|(s, o)| !std::ptr::eq(*s, *o));
            if changed { arena.alloc(Expr::List(se)) } else { expr }
        }
        Expr::Tuple(elems) => {
            let se: Vec<&'a Expr<'a>> = elems.iter().map(|e| substitute_identifiers(e, env, arena)).collect();
            let changed = se.iter().zip(elems.iter()).any(|(s, o)| !std::ptr::eq(*s, *o));
            if changed { arena.alloc(Expr::Tuple(se)) } else { expr }
        }
        Expr::New { type_name, type_args, init_fields } => {
            let sf: Vec<(Symbol, &'a Expr<'a>)> = init_fields.iter()
                .map(|(n, v)| (*n, substitute_identifiers(v, env, arena)))
                .collect();
            let changed = sf.iter().zip(init_fields.iter()).any(|((_, sv), (_, ov))| !std::ptr::eq(*sv, *ov));
            if changed { arena.alloc(Expr::New { type_name: *type_name, type_args: type_args.clone(), init_fields: sf }) }
            else { expr }
        }
        Expr::NewVariant { enum_name, variant, fields } => {
            let sf: Vec<(Symbol, &'a Expr<'a>)> = fields.iter()
                .map(|(n, v)| (*n, substitute_identifiers(v, env, arena)))
                .collect();
            let changed = sf.iter().zip(fields.iter()).any(|((_, sv), (_, ov))| !std::ptr::eq(*sv, *ov));
            if changed { arena.alloc(Expr::NewVariant { enum_name: *enum_name, variant: *variant, fields: sf }) }
            else { expr }
        }
        // Don't propagate into closures (captured variables may change)
        Expr::Closure { .. } => expr,
        // Interpolated strings — don't substitute (preserves format string shape)
        Expr::InterpolatedString(_) => expr,
        // Leaves
        Expr::Literal(_) | Expr::OptionNone | Expr::Escape { .. } => expr,
    }
}

/// Collect all variables that appear as `Set` targets (recursively through all blocks).
fn collect_all_set_targets(stmts: &[Stmt]) -> HashSet<Symbol> {
    let mut targets = HashSet::new();
    for stmt in stmts {
        collect_set_targets_in_stmt(stmt, &mut targets);
    }
    targets
}

fn collect_all_set_targets_from_block(block: &[Stmt]) -> HashSet<Symbol> {
    let mut targets = HashSet::new();
    for stmt in block {
        collect_set_targets_in_stmt(stmt, &mut targets);
    }
    targets
}

fn collect_set_targets_in_stmt(stmt: &Stmt, targets: &mut HashSet<Symbol>) {
    match stmt {
        Stmt::Set { target, .. } => { targets.insert(*target); }
        Stmt::If { then_block, else_block, .. } => {
            for s in *then_block { collect_set_targets_in_stmt(s, targets); }
            if let Some(eb) = else_block {
                for s in *eb { collect_set_targets_in_stmt(s, targets); }
            }
        }
        Stmt::While { body, .. } => {
            for s in *body { collect_set_targets_in_stmt(s, targets); }
        }
        Stmt::Repeat { body, .. } => {
            for s in *body { collect_set_targets_in_stmt(s, targets); }
        }
        Stmt::Zone { body, .. } => {
            for s in *body { collect_set_targets_in_stmt(s, targets); }
        }
        Stmt::Concurrent { tasks } => {
            for s in *tasks { collect_set_targets_in_stmt(s, targets); }
        }
        Stmt::Parallel { tasks } => {
            for s in *tasks { collect_set_targets_in_stmt(s, targets); }
        }
        Stmt::Inspect { arms, .. } => {
            for arm in arms {
                for s in arm.body { collect_set_targets_in_stmt(s, targets); }
            }
        }
        _ => {}
    }
}