// The comptime `compiler` library — the low-level compiler-API surface.
//
// These primitives run in the comptime evaluator (`abi(.compiler)`), serviced by
// `comptime_vm.callCompilerFn`. They are the building blocks of the sx-driven
// build pipeline (Phase 5); the default `build` implementation that orchestrates
// them lives in `modules/build.sx`. They are reached from the post-link build
// driver (a callback registered via `set_post_link_callback`), which always runs
// on the comptime VM (`core.invokeByFuncId`) — the VM, unlike the legacy
// interpreter, can allocate/grow the `List`s the driver builds (issue 0141).
#import "modules/std.sx";

// The C companion object files for this build (`#import c { #source ... }`,
// compiled to `.o`) and the `#library` link names. The sx driver passes them to
// the linker. Answered from the compiler's accumulated build state.
c_object_paths :: () -> List(string) abi(.compiler);
link_libraries :: () -> List(string) abi(.compiler);

// The object file the compiler emitted for this build. The compiler emits it
// eagerly; this returns its path (a query, not an action). The sx driver passes
// it to `link` alongside the C objects.
emit_object :: () -> string abi(.compiler);

// Link `objects` into `output`, with the given libraries / frameworks / link
// flags / target triple. The one genuine ACTION primitive — the compiler keeps
// the proven linker (Option B); the sx driver orchestrates. Not fallible (the
// build callback isn't): a link failure fails the build directly.
link :: (objects: List(string), output: string, libraries: List(string),
         frameworks: List(string), flags: List(string), target: string) abi(.compiler);