From 8952fce8ed07d755c76affb4fa32520edd0cdddd Mon Sep 17 00:00:00 2001
From: Val <59399970+Ruulul@users.noreply.github.com>
Date: Fri, 17 Nov 2023 15:03:36 -0300
Subject: [PATCH] print wrappers with comptime formatting and type safety

add functions `print`, that prints on console, `printText`, that wraps the `text` function, and `printBuffer`, that prints on an arbitrary buffer.
allows leveraging custom formatters on custom types, type safety, and use the error handling for ergonomics.
---
 cli/assets/templates/zig/src/wasm4.zig | 28 ++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/cli/assets/templates/zig/src/wasm4.zig b/cli/assets/templates/zig/src/wasm4.zig
index e5c40c5e..f32804be 100644
--- a/cli/assets/templates/zig/src/wasm4.zig
+++ b/cli/assets/templates/zig/src/wasm4.zig
@@ -134,3 +134,31 @@ extern fn traceUtf8(strPtr: [*]const u8, strLen: usize) void;
 /// See https://github.com/aduros/wasm4/issues/244 for discussion and type-safe
 /// alternatives.
 pub extern fn tracef(x: [*:0]const u8, ...) void;
+
+/// zig powered formatted print with type safety at compile time.
+/// prints on debug console.
+/// `extra_len` specifies how many characteres you will need at most, _on addition_ to the format string length.
+/// You can pass negative numbers, as long as the value is comptime known.
+pub fn print(comptime extra_len: comptime_int, comptime fmt: []const u8, args: anytype) !void {
+    var str = [_]u8{0} ** (@as(comptime_int, fmt.len) + extra_len);
+    try printBuffer(&str, fmt, args);
+    trace(&str);
+}
+
+/// zig powered formatted print with type safety at compile time.
+/// prints on screen.
+/// `extra_len` specifies how many characteres you will need at most, _on addition_ to the format string length.
+/// You can pass negative numbers, as long as the value is comptime known.
+pub fn textPrint(comptime extra_len: comptime_int, comptime fmt: []const u8, x: i32, y: i32, args: anytype) !void {
+    var str = [_]u8{0} ** (@as(comptime_int, fmt.len) + extra_len);
+    try printBuffer(&str, fmt, args);
+    text(&str, x, y);
+}
+
+/// zig powered formatted print with type safety at compile time.
+/// prints on arbitrary u8 buffer.
+pub fn printBuffer(buffer: []u8, comptime fmt: []const u8, args: anytype) !void {
+    var stream = std.io.fixedBufferStream(buffer);
+    const writer = stream.writer();
+    try writer.print(fmt, args);
+}