Introduce the welded comptime `compiler` library (`#library "compiler"` +
`abi(.zig) extern compiler`), per design/comptime-compiler-api.md, and unify
`callconv(...)` into the new `abi(...)` annotation.
abi(...) replaces callconv(...):
- New ABI enum { default, c, zig, pure }; `abi(.c|.zig|.pure)` parses in the
postfix slot before extern/export (and standalone). `kw_callconv` -> `kw_abi`.
- Migrated 52 sx files, the call-convention-mismatch diagnostic, and docs
(readme/specs) from `callconv(.c)` to `abi(.c)`.
Phase 1 — welded compiler library (parse -> registry -> validation -> bridge):
- `abi(.zig) extern compiler` parses on fn decls (carries abi/extern_lib) and
struct decls (StructDecl.abi/extern_lib).
- `#library "compiler"` is the comptime-only internal surface — never dlopen'd.
- src/ir/compiler_lib.zig: the binding registry (the safety boundary). `Field`
welded to StructInfo.Field with layout baked from the real Zig type
(@offsetOf/@sizeOf); `findType`/`findFn`. Welded structs are layout-validated
at registration (field set + total size) as a header checked against the impl.
- Host-call bridge: a `fn abi(.zig) extern compiler` dispatches under the
comptime interp to its registered Zig handler (intern/text_of round-trip),
never dlsym. IR Function.compiler_welded; validated in declareFunction.
- Comptime-only enforcement: a runtime call to a welded fn is a clean
build-gating error (emitCall), not an undefined-symbol link failure.
Phase 2.1 — byte-layout weld foundation:
- Decision: full byte-layout weld (sx struct laid out byte-identically to the
bound Zig type). Registered StructInfo (first non-natural / Zig-reordered
layout). `computeWeldPlan` — pure offset-ordered element plan + padding +
sx-field->LLVM-element remap; unit-tested. Emit/interp wiring is the next
sub-step (2.2+, see current/CHECKPOINT-COMPILER-API.md).
Examples: 0625/0626 (welded struct + fn round-trip), 1183/1184/1185
(layout-mismatch, unexported-fn, runtime-call diagnostics).
53 lines
2.1 KiB
Plaintext
53 lines
2.1 KiB
Plaintext
// Phase 1 step 1.8 (PLAN-FFI.md): >16 B non-HFA struct returns
|
|
// through `#objc_call`. AAPCS64 routes these through the indirect-
|
|
// return convention: caller allocates the result slot, passes its
|
|
// pointer in x8 with the `sret(<T>)` attribute, callee writes
|
|
// through it and returns void.
|
|
//
|
|
// Register a runtime-built Obj-C class with a method that returns
|
|
// a fixed `Triple`. The IMP is a plain sx fn (abi .c) — its
|
|
// sret-shaped lowering already works (Phase 0.3 fix for plain
|
|
// `extern` returns). The `#objc_call` dispatch side now produces
|
|
// the matching call shape: `call void @objc_msgSend(ptr sret %slot,
|
|
// ...)` + load. The two halves must agree on the ABI for the
|
|
// round-trip to return the right bytes.
|
|
|
|
#import "modules/std.sx";
|
|
#import "modules/build.sx";
|
|
#import "modules/ffi/objc.sx";
|
|
|
|
Triple :: struct { a: i64; b: i64; c: i64; }
|
|
|
|
// IMP for the runtime-installed method. Obj-C convention: implicit
|
|
// (self, _cmd) prefix, then declared args. Returns the value bytes.
|
|
triple_imp :: (self: *void, _cmd: *void) -> Triple abi(.c) {
|
|
Triple.{ a = 11, b = 22, c = 33 }
|
|
}
|
|
|
|
main :: () -> i32 {
|
|
inline if OS == .macos {
|
|
// Build the class:
|
|
// @interface SxTripleProbe : NSObject
|
|
// - (Triple)tripleValue;
|
|
// @end
|
|
ns_object := objc_getClass("NSObject".ptr);
|
|
my_cls := objc_allocateClassPair(ns_object, "SxTripleProbe".ptr, 0);
|
|
sel := sel_registerName("tripleValue".ptr);
|
|
// Type encoding: {Triple=qqq}@: → returns 24 B struct of 3 i64,
|
|
// implicit (self: id, _cmd: SEL).
|
|
ok := class_addMethod(my_cls, sel, xx triple_imp, "{Triple=qqq}@:".ptr);
|
|
print("addMethod = {}\n", ok);
|
|
objc_registerClassPair(my_cls);
|
|
|
|
// Call through #objc_call — sret transform applies because
|
|
// Triple is 24 B non-HFA.
|
|
instance := class_createInstance(my_cls, 0);
|
|
t := #objc_call(Triple)(instance, "tripleValue");
|
|
print("triple = ({}, {}, {})\n", t.a, t.b, t.c);
|
|
}
|
|
inline if OS != .macos {
|
|
print("skipped (not macos)\n");
|
|
}
|
|
0
|
|
}
|