sx/library/modules/build.sx

// `List` (for the default build script) + the compiler-API build primitives
// (`emit_object`/`link`/`c_object_paths`/…). The std↔build import cycle (std's
// tail imports cli.sx which imports this file) is handled by the resolver.
#import "modules/std.sx";
#import "modules/compiler.sx";

OperatingSystem :: enum { macos; linux; windows; wasm; ios; android; unknown; }
Architecture :: enum { aarch64; x86_64; wasm32; wasm64; unknown; }

OS : OperatingSystem = .unknown;
ARCH : Architecture = .unknown;
POINTER_SIZE : i64 = 8;

BuildOptions :: struct #compiler {
    add_link_flag :: (self: BuildOptions, flag: [:0]u8);
    add_framework :: (self: BuildOptions, name: [:0]u8);
    set_output_path :: (self: BuildOptions, path: [:0]u8);
    set_wasm_shell :: (self: BuildOptions, path: [:0]u8);

    // Register a directory of runtime assets to bundle alongside the
    // binary. `src` is the path on disk (relative to the CWD at build
    // time); `dest` is the relative location inside the bundle / APK.
    // Apple .app: copied to `<bundle>/<dest>/`. Android APK (Week 7):
    // zipped under `<dest>/` at the APK root. Idiomatic chess form is
    // `opts.add_asset_dir("assets", "assets")`.
    add_asset_dir :: (self: BuildOptions, src: [:0]u8, dest: [:0]u8);
    asset_dir_count :: (self: BuildOptions) -> i64;
    asset_dir_src_at :: (self: BuildOptions, i: i64) -> string;
    asset_dir_dest_at :: (self: BuildOptions, i: i64) -> string;

    // Name-based alternative to `set_post_link_callback`. The
    // compiler resolves `<module_name>.bundle_main` after linking.
    set_post_link_module :: (self: BuildOptions, module_name: [:0]u8);

    // Path of the freshly-linked binary, only meaningful while a
    // post-link callback is running. Returns "" before linking.
    binary_path :: (self: BuildOptions) -> string;

    // Apple `.app` / Android `.apk` bundling parameters. Accessors
    // return "" when unset so the bundler can use a single string
    // type. macOS bundling needs `bundle_path` and `bundle_id`;
    // codesign / provisioning are iOS-device-only.
    set_bundle_path :: (self: BuildOptions, path: [:0]u8);
    set_bundle_id :: (self: BuildOptions, id: [:0]u8);
    set_codesign_identity :: (self: BuildOptions, identity: [:0]u8);
    set_provisioning_profile :: (self: BuildOptions, path: [:0]u8);

    bundle_path :: (self: BuildOptions) -> string;
    bundle_id :: (self: BuildOptions) -> string;
    codesign_identity :: (self: BuildOptions) -> string;
    provisioning_profile :: (self: BuildOptions) -> string;

    // Target accessors. Empty triple before linking; predicates mirror
    // TargetConfig.is{MacOS,IOS,IOSDevice,IOSSimulator}() on the Zig
    // side. Used by the sx bundler to switch Info.plist shape and
    // codesigning ceremony per platform.
    target_triple :: (self: BuildOptions) -> string;
    is_macos :: (self: BuildOptions) -> bool;
    is_ios :: (self: BuildOptions) -> bool;
    is_ios_device :: (self: BuildOptions) -> bool;
    is_ios_simulator :: (self: BuildOptions) -> bool;
    is_android :: (self: BuildOptions) -> bool;

    // Framework list accessors. The bundler walks `framework_count() *
    // framework_at(i)` to find each `-framework` name and recursively
    // copies its `<Name>.framework` directory from one of
    // `framework_path_at(0..framework_path_count())` into
    // `<bundle>/Frameworks/`. Slice returns aren't natively expressible
    // through the compiler-hook bridge yet, hence the indexed form.
    framework_count :: (self: BuildOptions) -> i64;
    framework_at :: (self: BuildOptions, i: i64) -> string;
    framework_path_count :: (self: BuildOptions) -> i64;
    framework_path_at :: (self: BuildOptions, i: i64) -> string;

    // Android APK bundling parameters. `manifest_path` overrides the
    // bundler's auto-generated AndroidManifest.xml; `keystore_path`
    // overrides the default `$HOME/.android/debug.keystore`. Accessors
    // return "" when unset.
    set_manifest_path :: (self: BuildOptions, path: [:0]u8);
    set_keystore_path :: (self: BuildOptions, path: [:0]u8);
    manifest_path :: (self: BuildOptions) -> string;
    keystore_path :: (self: BuildOptions) -> string;

    // `#jni_main #jni_class("path") { ... }` decls collected during
    // lowering. The Android bundler walks `0..jni_main_count()` and
    // for each entry writes a `.java` file at
    // `<stage>/java/<runtime_path>.java`, compiles via javac + d8, and
    // bundles the resulting classes.dex into the APK.
    jni_main_count :: (self: BuildOptions) -> i64;
    jni_main_runtime_path_at :: (self: BuildOptions, i: i64) -> string;
    jni_main_java_source_at :: (self: BuildOptions, i: i64) -> string;
}

build_options :: () -> BuildOptions abi(.compiler);

// Post-link callback. Registers a sx function the compiler will invoke after
// `target.link()` returns. Used by the sx-side bundler
// (`platform.bundle.bundle_main`) and by user programs that want custom
// post-build steps. Return `false` to fail the build. Migrated off `#compiler`
// onto the comptime compiler-API (`abi(.compiler)`); called as
// `opts.set_post_link_callback(cb)` via UFCS, from inside a `#run { … }` block.
set_post_link_callback :: ufcs (self: BuildOptions, cb: () -> bool) abi(.compiler);

// The build callback registrar (Phase 5). Registers the sx function that drives
// the build — the compiler invokes it after codegen with the `BuildOptions`
// handle. Generalizes `set_post_link_callback` (a free fn, and the callback
// receives `opt`); `#run on_build(build);` is the override form, where
// `build :: (opt: BuildOptions) -> bool abi(.compiler) { … }`. The stdlib default
// implementation lives below (the default `build` script).
on_build :: (cb: (opt: BuildOptions) -> bool abi(.compiler)) abi(.compiler);

// ── The default build script ────────────────────────────────────────────────
//
// `default_pipeline` is the stdlib build driver: the compiler invokes it after
// codegen (everything is sx-driven — there is no auto-emit/auto-link). It emits
// the sx object, gathers the C companion objects, and links them into the output
// with the build's libraries / frameworks / flags / target. A user overrides the
// whole pipeline with their own `#run on_build(custom);` in main.sx (last-wins).
// The compiler FORCE-LOWERS this well-known name and auto-invokes it after
// codegen when no `#run on_build(custom);` override was registered (no library
// `#run` needed). A user override takes over entirely.
default_pipeline :: (opt: BuildOptions) -> bool abi(.compiler) {
    obj := emit_object();
    objs := c_object_paths();
    objs.append(obj);
    link(objs, build_output(), link_libraries(), build_frameworks(), build_flags(), build_target());
    return true;
}