004 cross module type nested

✓ Passing This code compiles and runs correctly.

Code

// Test 164: Cross-Module Type Reference (Nested Modules)
//
// Tests referencing a type from an explicitly imported nested module.
// Module imports must be explicit - importing a directory does NOT
// automatically load subdirectories.
//
// Structure:
//   test_lib/
//     domain/
//       user.kz  -> defines DomainUser struct
//
// Key Test: Explicit import of nested module, then use its types/events.

const std = @import("std");

// Must explicitly import the nested module (using 'domain' alias from koru.json)
~import domain/user

// This event uses a type from an explicitly imported nested module
~pub tor grant-access {
    user_data: domain/user:DomainUser,
} -> bool

~proc grant-access|zig {
    std.debug.print("Granting access: {s} as {s} (perms: {d})\n",
        .{user_data.email, user_data.role, user_data.permissions});
    return true;
}

// Create a domain user and grant access
~domain/user:create(email: "admin@example.com", role: "administrator", permissions: 999): c |> grant-access(user_data: c): _

input.kz

Supporting Files

~proc grant-access|cs {
    __koru_stdout_write($"Granting access: {user_data.email} as {user_data.role} (perms: {user_data.permissions})\n");
    return true;
}

input.kcs

~proc create|cs {
    var new_user = new { email = email,
        role = role,
        permissions = permissions,
    };
    return new_user;
}

test_lib/domain/user.kcs

// JavaScript implementation facet of domain/user. The events and the DomainUser
// type are declared in user.kz (merged at import); this file holds the |js body.

~proc create|js {
    return { email: email, role: role, permissions: permissions };
}

test_lib/domain/user.kjs

// Nested domain user module
const std = @import("std");

// Define a domain-specific user type
pub const DomainUser = struct {
    email: []const u8,
    role: []const u8,
    permissions: u32,
};

// Event that creates a domain user
~pub tor create {
    email: string,
    role: string,
    permissions: u32,
} -> DomainUser

~proc create|zig {
    const new_user = DomainUser{
        .email = email,
        .role = role,
        .permissions = permissions,
    };
    return new_user;
}

test_lib/domain/user.kz

Actual

Granting access: admin@example.com as administrator (perms: 999)

Expected output

✓ Zig✓ C#

Granting access: admin@example.com as administrator (perms: 999)

Emitted Zig source

// Access compiler flags via the per-user compiler_env module
const CompilerEnv = @import("compiler_env").CompilerEnv;

pub const panic = if (@import("builtin").mode == .Debug)
    @import("std").debug.FullPanic(@import("std").debug.defaultPanic)
else
    @import("std").debug.simple_panic;


const __koru_bare = struct {
    extern fn posix_memalign(memptr: *?*anyopaque, alignment: usize, size: usize) c_int;
    extern fn free(ptr: ?*anyopaque) void;
    fn bareAlloc(_: *anyopaque, len: usize, alignment: @import("std").mem.Alignment, _: usize) ?[*]u8 {
        var p: ?*anyopaque = null;
        const a = @max(alignment.toByteUnits(), @sizeOf(usize));
        if (posix_memalign(&p, a, len) != 0) return null;
        return @ptrCast(p);
    }
    fn bareResize(_: *anyopaque, _: []u8, _: @import("std").mem.Alignment, _: usize, _: usize) bool { return false; }
    fn bareRemap(_: *anyopaque, _: []u8, _: @import("std").mem.Alignment, _: usize, _: usize) ?[*]u8 { return null; }
    fn bareFree(_: *anyopaque, memory: []u8, _: @import("std").mem.Alignment, _: usize) void { free(@ptrCast(memory.ptr)); }
    const vtable = @import("std").mem.Allocator.VTable{ .alloc = bareAlloc, .resize = bareResize, .remap = bareRemap, .free = bareFree };
    const allocator = @import("std").mem.Allocator{ .ptr = undefined, .vtable = &vtable };
};
const __koru_backing = if (@import("builtin").link_libc) @import("std").heap.c_allocator else if (@import("builtin").os.tag == .freestanding and !@import("builtin").cpu.arch.isWasm()) __koru_bare.allocator else @import("std").heap.page_allocator;
var __koru_leak_count: @import("std").atomic.Value(usize) = .init(0);
var __koru_par_tasks: @import("std").atomic.Value(usize) = .init(0);
const __koru_par_CAP: usize = 128;
threadlocal var __koru_par_depth: usize = 0;
const __koru_par_DEPTH_CAP: usize = 7;
var __koru_par_pool: @import("std").Thread.Pool = undefined;
var __koru_par_pool_ready: bool = false;
var __koru_par_pool_mtx: @import("std").Thread.Mutex = .{};
fn __koru_par_pool_ensure() *@import("std").Thread.Pool {
    __koru_par_pool_mtx.lock();
    defer __koru_par_pool_mtx.unlock();
    if (!__koru_par_pool_ready) {
        @import("std").Thread.Pool.init(&__koru_par_pool, .{ .allocator = @import("std").heap.smp_allocator }) catch @panic("koru: thread pool init failed");
        __koru_par_pool_ready = true;
    }
    return &__koru_par_pool;
}
fn __koru_alloc(ctx: *anyopaque, len: usize, alignment: @import("std").mem.Alignment, ret_addr: usize) ?[*]u8 {
    _ = ctx;
    const r = __koru_backing.rawAlloc(len, alignment, ret_addr);
    if (comptime @import("builtin").mode == .Debug) {
        if (r != null) _ = __koru_leak_count.fetchAdd(1, .monotonic);
    }
    return r;
}
fn __koru_resize(ctx: *anyopaque, memory: []u8, alignment: @import("std").mem.Alignment, new_len: usize, ret_addr: usize) bool {
    _ = ctx;
    return __koru_backing.rawResize(memory, alignment, new_len, ret_addr);
}
fn __koru_remap(ctx: *anyopaque, memory: []u8, alignment: @import("std").mem.Alignment, new_len: usize, ret_addr: usize) ?[*]u8 {
    _ = ctx;
    return __koru_backing.rawRemap(memory, alignment, new_len, ret_addr);
}
fn __koru_free(ctx: *anyopaque, memory: []u8, alignment: @import("std").mem.Alignment, ret_addr: usize) void {
    _ = ctx;
    __koru_backing.rawFree(memory, alignment, ret_addr);
    if (comptime @import("builtin").mode == .Debug) {
        _ = __koru_leak_count.fetchSub(1, .monotonic);
    }
}
const __koru_vtable = @import("std").mem.Allocator.VTable{ .alloc = __koru_alloc, .resize = __koru_resize, .remap = __koru_remap, .free = __koru_free };
pub fn koru_allocator() @import("std").mem.Allocator {
    return .{ .ptr = undefined, .vtable = &__koru_vtable };
}

pub inline fn __koru_intcast(comptime T: type, x: anytype) T {
    if (comptime (@import("builtin").mode == .Debug or @import("builtin").mode == .ReleaseSafe))
        return @as(T, @intCast(x));
    const dst = @typeInfo(T);
    const src = @typeInfo(@TypeOf(x));
    if (comptime (dst == .int and src == .int and dst.int.bits == src.int.bits and dst.int.signedness != src.int.signedness))
        return @as(T, @bitCast(x));
    return @as(T, @intCast(x));
}

fn __KoruPadI(comptime T: type) type {
    const V = switch (@typeInfo(T)) { .comptime_int => i64, .comptime_float => f64, else => T };
    return struct {
        v: V,
        width: usize,
        pub fn format(self: @This(), w: *@import("std").Io.Writer) @import("std").Io.Writer.Error!void {
            const rendered = @import("std").fmt.count("{d}", .{self.v});
            const pad = self.width -| rendered;
            for (0..pad) |_| try w.writeByte(' ');
            try w.print("{d}", .{self.v});
        }
    };
}
pub fn __koru_pad_i(width: usize, value: anytype) __KoruPadI(@TypeOf(value)) {
    return .{ .v = value, .width = width };
}

pub fn koru_leak_check() void {
    if (comptime @import("builtin").mode != .Debug) return;
    if (__koru_leak_count.load(.acquire) == 0) return;
    if (comptime @import("builtin").target.os.tag == .freestanding) {
        if (comptime @import("builtin").cpu.arch == .wasm32 or @import("builtin").cpu.arch == .wasm64) {
            @panic("KORU LEAK CHECK FAILED: the produced program leaked");
        } else {
            const __klc = struct { extern var stdout: ?*anyopaque; extern fn fputs(__s: [*:0]const u8, __st: ?*anyopaque) c_int; };
            var __lb: [128]u8 = undefined;
            const __lm = "KORU LEAK CHECK FAILED: allocations still outstanding at end of run: ";
            @memcpy(__lb[0..__lm.len], __lm);
            var __ln: usize = __lm.len;
            var __lv = __koru_leak_count.load(.acquire);
            var __ld: [20]u8 = undefined;
            var __lk: usize = 0;
            while (__lv > 0) : (__lk += 1) { __ld[__lk] = @intCast('0' + __lv % 10); __lv /= 10; }
            for (0..__lk) |__li| { __lb[__ln] = __ld[__lk - 1 - __li]; __ln += 1; }
            __lb[__ln] = '\n'; __ln += 1; __lb[__ln] = 0;
            _ = __klc.fputs(@as([*:0]const u8, @ptrCast(&__lb)), __klc.stdout);
            @trap();
        }
    } else {
        @import("std").debug.print("KORU LEAK CHECK FAILED: the produced program leaked (trace above)\n", .{});
        @import("std").process.exit(1);
    }
}

pub const main_module = struct {
    const std = @import("std");
    pub const grant_access_event = struct {
        pub const Input = struct {
            user_data: koru_domain.koru_user.DomainUser,
        };
        pub const Output = bool;
        pub fn handler(__koru_event_input: @This().Input) @This().Output {
            // >>> PROC: grant_access  [tests/regression/200_COMPILER_FEATURES/220_COMPILATION/220_004_cross_module_type_nested/input.kz:25]
            const user_data = __koru_event_input.user_data;
            _ = &user_data;
            _ = &__koru_event_input;

                std.debug.print("Granting access: {s} as {s} (perms: {d})\n",
                    .{user_data.email, user_data.role, user_data.permissions});
                return true;

        }
    };
    // >>> FLOW: tests/regression/200_COMPILER_FEATURES/220_COMPILATION/220_004_cross_module_type_nested/input.kz:32  ~domain.user:create()
    pub fn flow0() void {
        const c = koru_domain.koru_user.create_event.handler(.{ .email = "admin@example.com", .role = "administrator", .permissions = 999 });
        _ = main_module.grant_access_event.handler(.{ .user_data = c });
    }
    pub fn koru_start_flow() void {
        const result_0 = koru_koru.start_event.handler(.{  });
        const result_0_done = result_0.done;
        _ = &result_0_done;
    }
    pub fn koru_end_flow() void {
        const result_0 = koru_koru.end_event.handler(.{  });
        const result_0_done = result_0.done;
        _ = &result_0_done;
    }
};

pub const koru_domain = struct {
    pub const koru_user = struct {
        const std = @import("std");
        pub const DomainUser = struct {
            email: []const u8,
            role: []const u8,
            permissions: u32,
        };
        pub const create_event = struct {
            pub const Input = struct {
                email: []const u8,
                role: []const u8,
                permissions: u32,
            };
            pub const Output = koru_domain.koru_user.DomainUser;
            pub fn handler(__koru_event_input: @This().Input) @This().Output {
                // >>> PROC: create  [/Users/larsde/src/koru/tests/regression/200_COMPILER_FEATURES/220_COMPILATION/220_004_cross_module_type_nested/test_lib/domain/user.kz:18]
                const email = __koru_event_input.email;
                const role = __koru_event_input.role;
                const permissions = __koru_event_input.permissions;
                _ = &email;
                _ = &role;
                _ = &permissions;
                _ = &__koru_event_input;

                    const new_user = DomainUser{
                        .email = email,
                        .role = role,
                        .permissions = permissions,
                    };
                    return new_user;

            }
        };
    };
};
pub const koru_koru = struct {
    pub const start_event = struct {
        pub const Input = struct {
        };
        pub const Output = union(enum(u8)) {
            done: struct {
            },
        };
        pub fn handler(__koru_event_input: @This().Input) @This().Output {
            _ = &__koru_event_input;
            return .{ .done = .{} };
        }
    };
    pub const end_event = struct {
        pub const Input = struct {
        };
        pub const Output = union(enum(u8)) {
            done: struct {
            },
        };
        pub fn handler(__koru_event_input: @This().Input) @This().Output {
            _ = &__koru_event_input;
            return .{ .done = .{} };
        }
    };
};
pub fn main() void {
    main_module.koru_start_flow();
    main_module.flow0();
    main_module.koru_end_flow();
    if (comptime @import("builtin").mode == .Debug) koru_leak_check();
}

test {
    @import("std").testing.refAllDeclsRecursive(@This());
}

Emitted C# source

static class main_module {
  public static void __koru_stdout_write(object s) => global::System.Console.Out.Write(s);
  public static void __koru_stderr_write(object s) => global::System.Console.Error.Write(s);
  // The mutable handle carrier — `*String`-style resources are
  // `new __KoruBox { data = … }` because C# anonymous types are
  // read-only: `s.data = …` (std/string append/clear, handle
  // mutation generally) needs a settable member. `object`, not
  // `dynamic`: the field is storage — every `x.data` read reaches
  // it through a dynamic-typed handle (`*T` Input fields, the
  // `dynamic` borrow locals below), so the member itself only
  // needs to hold the value, and `object` keeps the DLR out of
  // the store/load path.
  public class __KoruBox { public object data; }
  // Textification for `{{ … }}` operands: C# bool ToStrings as
  // `True` where Koru prints `true`, and the operand's static type
  // is unknown at this boundary — a `(x) is bool` inline test would
  // be a compile error on statically-typed operands instead. Generic
  // on purpose: `dynamic` boxed every value-type operand — measured
  // ~1s/10M elements on 012_threat_scanner — while T specializes to
  // the operand's own ToString() with no box.
  public static string __koru_str<T>(T v) => v is bool b ? (b ? "true" : "false") : v?.ToString();
  public static class grant_access_event {
    public struct Input {
      public dynamic user_data;
    }
    public static bool handler(Input __koru_input) {
      var user_data = __koru_input.user_data;
      __koru_stdout_write($"Granting access: {user_data.email} as {user_data.role} (perms: {user_data.permissions})\n");
      return true;

      return default;

    }
  }
  public static class domain_user_create_event {
    public struct Input {
      public string email;
      public string role;
      public uint permissions;
    }
    public static dynamic handler(Input __koru_input) {
      var email = __koru_input.email;
      var role = __koru_input.role;
      var permissions = __koru_input.permissions;
      var new_user = new { email = email,
      role = role,
      permissions = permissions,
      };
      return new_user;

      return default;

    }
  }
  public static class koru_start_event {
    public struct Input {
    }
    public struct Output {
      public string tag;
      public object done;
    }
    public static Output handler(Input __koru_input) => new Output { tag = "done" };
  }
  public static class koru_end_event {
    public struct Input {
    }
    public struct Output {
      public string tag;
      public object done;
    }
    public static Output handler(Input __koru_input) => new Output { tag = "done" };
  }
  public static void flow0() {
    var c = main_module.domain_user_create_event.handler(new domain_user_create_event.Input { email = (string)("admin@example.com"), role = (string)("administrator"), permissions = (uint)(999)});
    main_module.grant_access_event.handler(new grant_access_event.Input { user_data = c});
  }
  public static void flow1() {
    main_module.koru_start_event.handler(new koru_start_event.Input { });
  }
  public static void flow2() {
    main_module.koru_end_event.handler(new koru_end_event.Input { });
  }
}

static class Program {
  static void Main() {
    main_module.flow1();
    main_module.flow0();
    main_module.flow2();
  }
}

Flows

flow ~create click a branch to expand · @labels scroll to their anchor

create (email: "admin@example.com", role: "administrator", permissions: 999)

Test Configuration

MUST_RUN LANGUAGES: cs

koru.json:

{
  "name": "cross-module-nested-test",
  "version": "0.1.0",
  "paths": {
    "std": "../../../../../koru_std",
    "app": "{{ ENTRY }}",
    "domain": "{{ ENTRY }}/test_lib/domain"
  }
}

← 003 cross module type basic 005 cross module type nullable →