nomen-lang 0.3.0 → 0.5.0

package/core/System/Text/JsonTree.nm

@@ -28,10 +28,10 @@ pub struct JsonTree {
 
 	func alloc_node = (ref self, out int) {
 		var int idx = self.count
-		self.nodes.grow_T(idx + 1)
+		self.nodes.grow(idx + 1)
 		self.count = idx + 1
 		var default = JsonNode()
-		self.nodes.store_T(idx, default)
+		self.nodes.store(idx, default)
 		// store_T deep-copies the owning `text` field (strdup of the shared
 		// empty-string literal) into the slot. JsonTree manages node texts
 		// manually (set_text strdup's into the slab; free_text/release frees
@@ -106,51 +106,51 @@ pub struct JsonTree {
 	}
 
 	func set_kind = (ref self, int idx, int val) {
-		var JsonNode n = self.nodes.load_T(idx)
+		var JsonNode n = self.nodes.load(idx)
 		n.kind = val
-		self.nodes.store_T(idx, n)
+		self.nodes.store(idx, n)
 	}
 
 	func set_child = (ref self, int idx, int val) {
-		var JsonNode n = self.nodes.load_T(idx)
+		var JsonNode n = self.nodes.load(idx)
 		n.child = val
-		self.nodes.store_T(idx, n)
+		self.nodes.store(idx, n)
 	}
 
 	func set_next = (ref self, int idx, int val) {
-		var JsonNode n = self.nodes.load_T(idx)
+		var JsonNode n = self.nodes.load(idx)
 		n.next = val
-		self.nodes.store_T(idx, n)
+		self.nodes.store(idx, n)
 	}
 
 	func set_val = (ref self, int idx, int val) {
-		var JsonNode n = self.nodes.load_T(idx)
+		var JsonNode n = self.nodes.load(idx)
 		n.val = val
-		self.nodes.store_T(idx, n)
+		self.nodes.store(idx, n)
 	}
 
 	func get_kind = (self, int idx, out int) {
-		var JsonNode n = self.nodes.load_T(idx)
+		var JsonNode n = self.nodes.load(idx)
 		return n.kind
 	}
 
 	func get_text = (self, int idx, out string) {
-		var JsonNode n = self.nodes.load_T(idx)
+		var JsonNode n = self.nodes.load(idx)
 		return n.text
 	}
 
 	func get_child = (self, int idx, out int) {
-		var JsonNode n = self.nodes.load_T(idx)
+		var JsonNode n = self.nodes.load(idx)
 		return n.child
 	}
 
 	func get_next = (self, int idx, out int) {
-		var JsonNode n = self.nodes.load_T(idx)
+		var JsonNode n = self.nodes.load(idx)
 		return n.next
 	}
 
 	func get_val = (self, int idx, out int) {
-		var JsonNode n = self.nodes.load_T(idx)
+		var JsonNode n = self.nodes.load(idx)
 		return n.val
 	}
 }

package/core/System/Thread.nm

@@ -0,0 +1,83 @@
+// Thread — a task running on the shared worker pool (CLOSURE.md
+// Phase 3b). `Thread(fn(args))` constructs a Thread value: the arguments are
+// evaluated eagerly and packed into a task closure (a heap closure
+// descriptor over the pooled-args environment — the same ABI every lambda
+// lowers to); `.start()` submits that closure to the worker pool and yields
+// a `Task<T>` handle; `.detach()` runs it as an unjoinable daemon.
+//
+// Because the construction is a real value, it can be STORED and started
+// later:
+//
+//     var t = Thread(work(n))
+//     ...later...
+//     var Task<uint64> handle = t.start()
+//
+// The pool starts at a configurable size (default 4, via Task.set_pool_size
+// before the first spawn) and grows on demand up to 64 workers when every
+// worker is busy, preventing deadlocks from nested spawns. The pool drains
+// and joins all workers at process exit; Task.shutdown_pool does this
+// explicitly.
+//
+// The pool infrastructure (types, worker loop, submit, shutdown, cancel
+// thread-local) lives in build_spawn_node and is emitted as file-scope C
+// on the first spawn — not in Thread's own methods — so that Thread can be
+// generic without duplicating the pool per instantiation.
+//
+// MUST-START: a Thread value that is destroyed without ever being started
+// is a programming error — #destroy reports it and aborts. start/detach
+// (and nursery.start) transfer ownership of the packed task out of the
+// value, so a started Thread destroys as a no-op.
+//
+// See ASYNC.md for the design.
+
+/**
+ * A deferred function call, startable on the shared worker pool
+ **/
+pub class Thread<T> : Sendable {
+	// The packed task closure (a `struct nomen_closure *`); owned by this
+	// value until start/detach/nursery.start transfers it to the runtime.
+	pub var uint64 task = 0
+	// Result-slot / cancel-flag / future handles for the (single) launch.
+	pub var uint64 result_slot = 0
+	pub var uint64 cancel_flag = 0
+	pub var uint64 future = 0
+	// Must-start flag: set by .start() / .detach() / nursery.start.
+	pub var started = false
+
+	// Destroying an unstarted Thread is a programming error (the wrapped
+	// call would silently never run) — report it and abort. A started
+	// Thread owns nothing: the launch transferred the task closure, result
+	// slot, cancel flag, and future to the runtime, and cleared the fields.
+	pub func #destroy = () {
+		```
+		#arch: c
+		if (!self->started) {
+			__nomen_spawn_must_start_abort();
+		}
+		if (self->future) {
+			__nomen_future_release((struct nomen_future *)self->future);
+			self->future = 0;
+			self->result_slot = 0;
+			self->cancel_flag = 0;
+		}
+		```
+		```
+		#arch: aarch64
+		// if (!self->started) __nomen_spawn_must_start_abort()
+		ldrb w0, [x19, #40]
+		cbnz w0, .Lthr_started
+		bl ___nomen_spawn_must_start_abort
+		.Lthr_started:
+		// if (self->future) { release it (an unstarted task's future is
+		// unshared — refs == 1 — so this tears down slot + flag + future);
+		// zero the fields }
+		ldr x0, [x19, #32]
+		cbz x0, .Lthr_done
+		bl ___nomen_future_release
+		str xzr, [x19, #32]
+		str xzr, [x19, #16]
+		str xzr, [x19, #24]
+		.Lthr_done:
+		```
+	}
+}

package/core/System/bool.nm

@@ -18,7 +18,8 @@ pub struct bool: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%s", self ? "true" : "false");
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%s", self ? "true" : "false");
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/char.nm

@@ -12,7 +12,8 @@ pub struct char: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%c", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%c", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/float.nm

@@ -8,7 +8,8 @@ pub struct float: Stringable {
 		int length = snprintf(NULL, 0, "%f", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%f", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/float32.nm

@@ -8,7 +8,8 @@ pub struct float32: Stringable {
 		int length = snprintf(NULL, 0, "%f", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%f", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/float64.nm

@@ -8,7 +8,8 @@ pub struct float64: Stringable {
 		int length = snprintf(NULL, 0, "%f", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%f", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/int.nm

@@ -12,7 +12,8 @@ pub struct int: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%ld", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%ld", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64
@@ -49,10 +50,11 @@ pub struct int: Stringable, Hashable, Equatable {
 	pub func parse = (string s, out int) {
 		```
 		#arch: c
-		return atoi(s);
+		return atoi(s.ptr);
 		```
 		```
 		#arch: aarch64
+		// Fat-string ABI: s = (x0 ptr, x1 len); atoi takes the ptr half.
 		bl _atoi
 		```
 	}

package/core/System/int16.nm

@@ -12,7 +12,8 @@ pub struct int16: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%d", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%d", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/int32.nm

@@ -12,7 +12,8 @@ pub struct int32: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%d", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%d", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/int64.nm

@@ -12,7 +12,8 @@ pub struct int64: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%lld", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%lld", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/int8.nm

@@ -12,7 +12,8 @@ pub struct int8: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%d", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%d", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/ufloat.nm

@@ -8,7 +8,8 @@ pub struct ufloat: Stringable {
 		int length = snprintf(NULL, 0, "%f", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%f", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/ufloat32.nm

@@ -8,7 +8,8 @@ pub struct ufloat32: Stringable {
 		int length = snprintf(NULL, 0, "%f", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%f", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/ufloat64.nm

@@ -8,7 +8,8 @@ pub struct ufloat64: Stringable {
 		int length = snprintf(NULL, 0, "%f", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%f", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/uint.nm

@@ -12,7 +12,8 @@ pub struct uint: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%ld", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%ld", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/uint16.nm

@@ -12,7 +12,8 @@ pub struct uint16: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%u", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%u", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/uint32.nm

@@ -12,7 +12,8 @@ pub struct uint32: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%u", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%u", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/uint64.nm

@@ -12,7 +12,8 @@ pub struct uint64: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%llu", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%llu", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/System/uint8.nm

@@ -12,7 +12,8 @@ pub struct uint8: Stringable, Hashable, Equatable {
 		int length = snprintf(NULL, 0, "%d", self);
 		char* str = malloc(length + 1);
 		snprintf(str, length + 1, "%d", self);
-		return str;
+		// Fat-string ABI: snprintf already counted the bytes.
+		return (nomen_string){ str, length };
 		```
 		```
 		#arch: aarch64

package/core/docs/System/BigInt.md

@@ -6,7 +6,6 @@ An arbitrary-precision integer
 
 **Members:**
 
-- `new(int val) -> BigInt`
 - `get(int i) -> uint64`
 - `set(int i, uint64 val)`
 - `data_ptr() -> uint64`