Function part2_solution

tutorials/integration/c/13_shared_module.c:155–259

----------------------------------------------------------------------- Part 2: The Solution — `module my_helpers shared` Compile a loader script that `require`s the shared module. The module is promoted to the global registry as a dependency. After that, any compilation — even with a completely fresh FileAccess — can `require my_helpers` because it lives in the global registry. ---------------

// can `require my_helpers` because it lives in the global registry.
// -----------------------------------------------------------------------
static void part2_solution(void) {
    printf("=== Part 2: The Solution -- module my_helpers shared ===\n\n");

    // --- 2a: Compile the loader to promote my_helpers to the global registry ---
    //
    // Promotion happens when a shared module is compiled as a DEPENDENCY
    // (via `require`).  The loader script exists solely to trigger this.
    {
        das_text_writer  * tout    = das_text_make_printer();
        das_module_group * libgrp  = das_modulegroup_make();
        das_file_access  * fa      = das_fileaccess_make_default();

        das_fileaccess_introduce_file(fa, "my_helpers.das", MODULE_SHARED, 0);
        das_fileaccess_introduce_file(fa, "loader.das", LOADER_SCRIPT, 0);

        das_program * program = das_program_compile("loader.das", fa, tout, libgrp);
        int err_count = das_program_err_count(program);
        if (err_count) {
            printf("Part 2a: loader compilation FAILED (%d errors) -- unexpected\n", err_count);
            for (int i = 0; i < err_count; i++) {
                das_error * error = das_program_get_error(program, i);
                char buf[1024];
                das_error_report(error, buf, sizeof(buf));
                printf("  error %d: %s\n", i, buf);
            }
            das_program_release(program);
            das_fileaccess_release(fa);
            das_modulegroup_release(libgrp);
            das_text_release(tout);
            return;
        }

        printf("Part 2a: loader compiled -- 'my_helpers' promoted to global module registry\n\n");

        // Release everything.  The promoted module survives because
        // Module::promoteToBuiltin() transferred ownership to the
        // global linked list (builtIn=true skips deletion).
        das_program_release(program);
        das_fileaccess_release(fa);
        das_modulegroup_release(libgrp);
        das_text_release(tout);
    }

    // --- 2b: Fresh FileAccess, no module file — compilation succeeds ---
    {
        das_text_writer  * tout    = das_text_make_printer();
        das_module_group * libgrp  = das_modulegroup_make();
        das_file_access  * fa      = das_fileaccess_make_default();

        // Only introduce the user script — NOT the module.
        // The compiler finds my_helpers in the global registry.
        das_fileaccess_introduce_file(fa, "user_script.das", USER_SCRIPT, 0);

        das_program * program = das_program_compile("user_script.das", fa, tout, libgrp);
        int err_count = das_program_err_count(program);
        if (err_count) {
            printf("Part 2b: compilation FAILED (%d errors) -- unexpected\n", err_count);
            for (int i = 0; i < err_count; i++) {