lab/sx
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

comptime compiler-API: Phase 1 foundation + Phase 2.1 weld plan

Browse Source 
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).
This commit is contained in:
agra
2026-06-17 13:31:11 +03:00
parent 3a9b508502
commit cd5b958d19
100 changed files with 1490 additions and 298 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
examples/expected/0114-types-build-block-convert.stdout
View File

@@ -1,10 +1,10 @@
--- void / 0 args ---
__invoke :: (block_self: *Block) -> void callconv(.c) { typed_fn : (*void) -> void = xx block_self.sx_fn; typed_fn(block_self.sx_env); } return .{ isa = @_NSConcreteStackBlock, flags = 0, reserved = 0, invoke = xx @__invoke, descriptor = xx @__sx_block_descriptor, sx_env = self.env, sx_fn = self.fn_ptr, };
__invoke :: (block_self: *Block) -> void abi(.c) { typed_fn : (*void) -> void = xx block_self.sx_fn; typed_fn(block_self.sx_env); } return .{ isa = @_NSConcreteStackBlock, flags = 0, reserved = 0, invoke = xx @__invoke, descriptor = xx @__sx_block_descriptor, sx_env = self.env, sx_fn = self.fn_ptr, };
--- void / bool ---
__invoke :: (block_self: *Block, arg0: bool) -> void callconv(.c) { typed_fn : (*void, bool) -> void = xx block_self.sx_fn; typed_fn(block_self.sx_env, arg0); } return .{ isa = @_NSConcreteStackBlock, flags = 0, reserved = 0, invoke = xx @__invoke, descriptor = xx @__sx_block_descriptor, sx_env = self.env, sx_fn = self.fn_ptr, };
__invoke :: (block_self: *Block, arg0: bool) -> void abi(.c) { typed_fn : (*void, bool) -> void = xx block_self.sx_fn; typed_fn(block_self.sx_env, arg0); } return .{ isa = @_NSConcreteStackBlock, flags = 0, reserved = 0, invoke = xx @__invoke, descriptor = xx @__sx_block_descriptor, sx_env = self.env, sx_fn = self.fn_ptr, };
--- void / i64, string ---
__invoke :: (block_self: *Block, arg0: i64, arg1: string) -> void callconv(.c) { typed_fn : (*void, i64, string) -> void = xx block_self.sx_fn; typed_fn(block_self.sx_env, arg0, arg1); } return .{ isa = @_NSConcreteStackBlock, flags = 0, reserved = 0, invoke = xx @__invoke, descriptor = xx @__sx_block_descriptor, sx_env = self.env, sx_fn = self.fn_ptr, };
__invoke :: (block_self: *Block, arg0: i64, arg1: string) -> void abi(.c) { typed_fn : (*void, i64, string) -> void = xx block_self.sx_fn; typed_fn(block_self.sx_env, arg0, arg1); } return .{ isa = @_NSConcreteStackBlock, flags = 0, reserved = 0, invoke = xx @__invoke, descriptor = xx @__sx_block_descriptor, sx_env = self.env, sx_fn = self.fn_ptr, };
--- i32 / f64 ---
__invoke :: (block_self: *Block, arg0: f64) -> i32 callconv(.c) { typed_fn : (*void, f64) -> i32 = xx block_self.sx_fn; return typed_fn(block_self.sx_env, arg0); } return .{ isa = @_NSConcreteStackBlock, flags = 0, reserved = 0, invoke = xx @__invoke, descriptor = xx @__sx_block_descriptor, sx_env = self.env, sx_fn = self.fn_ptr, };
__invoke :: (block_self: *Block, arg0: f64) -> i32 abi(.c) { typed_fn : (*void, f64) -> i32 = xx block_self.sx_fn; return typed_fn(block_self.sx_env, arg0); } return .{ isa = @_NSConcreteStackBlock, flags = 0, reserved = 0, invoke = xx @__invoke, descriptor = xx @__sx_block_descriptor, sx_env = self.env, sx_fn = self.fn_ptr, };
--- build done ---
rt

1
examples/expected/0625-comptime-weld-struct-field.exit Normal file
View File

@@ -0,0 +1 @@
0

1
examples/expected/0625-comptime-weld-struct-field.stderr Normal file
View File

@@ -0,0 +1 @@

1
examples/expected/0625-comptime-weld-struct-field.stdout Normal file
View File

@@ -0,0 +1 @@
name=7 ty=3

1
examples/expected/0626-comptime-weld-fn-intern-text-of.exit Normal file
View File

@@ -0,0 +1 @@
0

1
examples/expected/0626-comptime-weld-fn-intern-text-of.stderr Normal file
View File

@@ -0,0 +1 @@

1
examples/expected/0626-comptime-weld-fn-intern-text-of.stdout Normal file
View File

@@ -0,0 +1 @@
hello, compiler

8
examples/expected/1104-diagnostics-callconv-mismatch-diagnostic.stderr
View File

@@ -1,5 +1,5 @@
error: call-convention mismatch: 'sx_handler' is declared with default sx convention but the target type expects callconv(.c)
--> examples/1104-diagnostics-callconv-mismatch-diagnostic.sx:12:42
error: call-convention mismatch: 'sx_handler' is declared with default sx convention but the target type expects abi(.c)
--> examples/1104-diagnostics-callconv-mismatch-diagnostic.sx:12:37
|
12 | fp : (*void) -> *void callconv(.c) = sx_handler;
| ^^^^^^^^^^
12 | fp : (*void) -> *void abi(.c) = sx_handler;
| ^^^^^^^^^^

1
examples/expected/1183-diagnostics-weld-struct-field-count.exit Normal file
View File

@@ -0,0 +1 @@
1

5
examples/expected/1183-diagnostics-weld-struct-field-count.stderr Normal file
View File

@@ -0,0 +1,5 @@
error: welded type 'Field' has 2 field(s) in the compiler library but the declaration has 1
--> examples/1183-diagnostics-weld-struct-field-count.sx:12:51
|
12 | Field :: struct abi(.zig) extern compiler { name: u32; }
| ^^^

1
examples/expected/1183-diagnostics-weld-struct-field-count.stdout Normal file
View File

@@ -0,0 +1 @@

1
examples/expected/1184-diagnostics-weld-fn-unexported.exit Normal file
View File

@@ -0,0 +1 @@
1

5
examples/expected/1184-diagnostics-weld-fn-unexported.stderr Normal file
View File

@@ -0,0 +1,5 @@
error: 'not_a_real_compiler_fn' is not a function exported by the 'compiler' library
--> examples/1184-diagnostics-weld-fn-unexported.sx:9:1
|
9 | not_a_real_compiler_fn :: (x: i64) -> i64 abi(.zig) extern compiler;
| ^^^^^^^^^^^^^^^^^^^^^^

1
examples/expected/1184-diagnostics-weld-fn-unexported.stdout Normal file
View File

@@ -0,0 +1 @@

1
examples/expected/1185-diagnostics-weld-fn-runtime-call.exit Normal file
View File

@@ -0,0 +1 @@
1

1
examples/expected/1185-diagnostics-weld-fn-runtime-call.stderr Normal file
View File

@@ -0,0 +1 @@
error: 'intern' is a comptime-only compiler-library function — it cannot be called at runtime (use it inside #run or a comptime '::')

1
examples/expected/1185-diagnostics-weld-fn-runtime-call.stdout Normal file
View File

@@ -0,0 +1 @@

2
examples/expected/1200-ffi-callconv-c-callbacks.stdout
View File

@@ -1 +1 @@
callconv(.c): 42
abi(.c): 42

1
examples/expected/1228-ffi-extern-c-non-transitive.stdout
View File

@@ -0,0 +1 @@

1
examples/expected/1231-ffi-extern-undeclared-lib.stdout
View File

@@ -0,0 +1 @@