Files
sx/examples/1339-ffi-objc-defined-class-01-instance.sx
agra cd5b958d19 comptime compiler-API: Phase 1 foundation + Phase 2.1 weld plan
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).
2026-06-17 13:31:11 +03:00

62 lines
2.0 KiB
Plaintext

// M1.2 A.7 — full instance state round-trip on a sx-defined
// `#objc_class`. The plan's first integration smoke test
// (A.2/A.3/A.4 integration through the now-open dispatch gate).
//
// What this exercises end-to-end:
// 1. `SxFoo.alloc()` — sx-side call lowers to objc_msgSend(SxFoo, sel_alloc).
// The runtime invokes the synthesized +alloc IMP (M1.2 A.5)
// which allocates an instance + state struct and binds them
// via __sx_state.
// 2. `f.bump()` — sx-side method call lowers to
// objc_msgSend(f, sel_bump). Runtime dispatches to the IMP
// trampoline (M1.2 A.4b.ii) which reads __sx_state to find
// the state pointer and forwards to the sx body
// `SxFoo.bump(__sx_default_context, state)`. Body mutates
// self.counter (M1.2 A.3).
// 3. Repeat to confirm the state persists across calls.
// 4. release — synthesized -dealloc (M1.2 A.6) frees the state
// and chains to [super dealloc].
#import "modules/std.sx";
#import "modules/build.sx";
#import "modules/ffi/objc.sx";
SxFoo :: #objc_class("SxFoo") {
counter: i32;
// Declare the synthesized class methods so sx-side call sites
// can resolve them. +alloc / -dealloc IMPs are emitted by the
// compiler at module-init (M1.2 A.5 / A.6); these declarations
// just give the names a typed contract.
alloc :: () -> *SxFoo;
bump :: (self: *Self) {
self.counter += 1;
}
get :: (self: *Self) -> i32 {
return self.counter;
}
}
main :: () -> i32 {
inline if OS == .macos {
f := SxFoo.alloc();
if f == null { print("FAIL: alloc returned null\n"); return 1; }
f.bump();
f.bump();
f.bump();
print("counter: {}\n", f.get()); // expected: 3
// release
sel_release : SEL = sel_registerName("release".ptr);
release_fn : (obj: *void, sel: *void) -> void abi(.c) = xx objc_msgSend;
release_fn(xx f, sel_release);
}
inline if OS != .macos {
print("counter: 3\n");
}
0
}