clj-zig.zig — com.leifericf/clj-zig 2026.06.02-alpha1

The three-level node model for Zig source generation. Generators produce declaration, statement, and expression nodes as plain data; the single render function turns them into Zig source text. This is the ONLY namespace that knows about braces, newlines, indentation, and semicolons.

The node model is a pruned view of Zig's own AST decomposition. It covers the subset clj-zig generates: function declarations, struct and enum declarations, the common statement forms (const, assign, return, if, for, defer), and a small expression vocabulary (ref, field, deref, call, lit, as, slice). The :raw node at each level is the escape hatch for user-written Zig body text and one-off complex expressions the generators do not model.

Generators compose nodes with the constructor functions, never with str. Type strings (like "i64" or "[]const f64") are the exception: they are opaque tokens passed through from zig-type. The four-space indent appears ONLY in the renderer's indent function.

as clj

(as type value)

assign-stmt clj

(assign-stmt target value)

An assignment statement: target = value;.

call clj

(call fn-name args)

const-decl clj

(const-decl name init)

A top-level const declaration node.

const-stmt clj

(const-stmt name init)

(const-stmt name type init)

A local const statement: const name = init; or const name: type = init;.

defer-stmt clj

(defer-stmt expr)

A defer statement: defer expr;.

deref clj

(deref base)

enum-decl clj

(enum-decl name backing members)

An enum(backing) declaration node.

export-fn-decl clj

(export-fn-decl name params ret body)

An exported function declaration node (C ABI entry point).

expr-stmt clj

(expr-stmt value)

An expression statement: expr;.

extern-struct-decl clj

(extern-struct-decl name fields)

An extern struct declaration node (C ABI layout).

field clj

(field base field-name)

field-data clj

(field-data name type)

One struct field as node data: {:name name :type type}.

fn-decl clj

(fn-decl name params ret body)

A non-exported function declaration node.

for-stmt clj

(for-stmt header body)

A for loop: for header { body }. The header is a raw string like (__nice, 0..) |*__dst, __i| because the for-loop capture syntax is too varied to model.

if-stmt clj

(if-stmt cond body)

(if-stmt cond body else)

An if statement: if (cond) { body } with an optional else branch.

lit clj

(lit value)

A literal expression node. value is Zig source text rendered verbatim (a number, a boolean, a string of source).

packed-struct-decl clj

(packed-struct-decl name fields)

A packed struct declaration node.

param clj

(param name type)

One function parameter as node data: {:name name :type type}.

raw-decl clj

(raw-decl text)

A raw declaration node (opaque Zig source text).

raw-expr clj

(raw-expr text)

raw-stmt clj

(raw-stmt text)

A raw statement node (opaque Zig source, indented by the renderer at the enclosing level). Used for user body text and multi-line fragments whose indentation is relative to the function body.

ref clj

(ref name)

render clj

(render decls)

Render a vector of declaration nodes to Zig source text. Each declaration is separated by a blank line. The output carries no trailing newline.

render-expr-for-test clj

(render-expr-for-test e)

render-stmt-for-test clj

(render-stmt-for-test stmt level)

return-stmt clj

(return-stmt)

(return-stmt value)

A return statement. With no argument, a bare return;.

slice clj

(slice base from to)

struct-decl clj

(struct-decl name fields)

A regular struct declaration node.