Lowers one defrust definition, with its specs, type aliases, Rust module aliases, and the callables and macros it may use, to its RustQ AST item.

Builds the Rust struct, enum, and alias items the module's declared types need.

@spec callables_from_specs([term()], map()) :: [RustQ.Binding.Callable.t()]

Callable metadata for the module's own functions, from their specs.

@spec enum_type_item!(module(), atom() | String.t()) :: RustQ.Rust.AST.Enum.t()

Returns one generated Rust enum type item by name, raising on absence or kind mismatch.

Expands ordinary Elixir macros in a body in env before it is lowered.

@spec function!(module(), atom() | String.t(), keyword()) ::
  RustQ.Rust.AST.Function.t()

Returns one generated defrust function AST by name, raising when absent.

@spec functions(module()) :: [RustQ.Rust.AST.Function.t()]

Returns all generated defrust function AST nodes from a compiled module.

Raises ArgumentError when the module does not contain compiled defrust metadata.

@spec functions!(module(), [atom() | String.t()]) :: [RustQ.Rust.AST.Function.t()]

Returns selected generated defrust function AST nodes.

@spec generated_type_items(module()) :: [RustQ.Rust.AST.item()]

Returns every generated Rust type item from a compiled RustQ module.

Groups built items into their Rust modules and impl blocks, in definition order.

Groups built items as group_items/2 does, without Rust module aliases.

@spec impl!(module(), atom() | String.t() | [atom() | String.t()], keyword()) ::
  RustQ.Rust.AST.Impl.t()

Returns one generated Rust implementation block for a target.

Pass trait: Name to select a trait implementation. Without :trait, only inherent implementations match. Raises when no implementation matches or when the selector is ambiguous.

@spec impls(module()) :: [RustQ.Rust.AST.Impl.t()]

Returns every generated Rust implementation block from a compiled module.

@spec items(module()) :: [RustQ.Rust.AST.item()]

Returns every generated Rust item from a compiled RustQ module.

This is the public structural accessor for generated type declarations, functions, modules, and implementation blocks.

@spec macro_call!(module(), atom() | String.t(), keyword()) ::
  RustQ.Rust.AST.MacroItemCall.t()

Builds a structural invocation of a generated Rust item macro.

args gives each capture its value: an atom or string for an :ident, a value for a :literal, and RustQ AST or source for an :expr or :ty.

@spec macro_item!(module(), atom() | String.t()) :: RustQ.Rust.AST.MacroItem.t()

Returns one generated defrustmacro item AST by name, raising when absent.

@spec macro_items!(module(), [atom() | String.t()]) :: [RustQ.Rust.AST.MacroItem.t()]

Returns selected generated defrustmacro item AST nodes.

@spec quoted(
  atom(),
  keyword()
) :: RustQ.Rust.AST.Function.t()

Lowers one Rusty-Elixir body to a Rust function from explicit :args, :returns, and :do, without a module's specs; used to build functions from generators.

@spec struct_type_item!(module(), atom() | String.t()) :: RustQ.Rust.AST.Struct.t()

Returns one generated Rust struct type item by name, raising on absence or kind mismatch.

@spec struct_type_items(module(), [atom()], keyword()) :: [RustQ.Rust.AST.Struct.t()]

Builds Rust struct items for selected map-backed @type declarations.

Use :derive, :attrs, and :vis to adapt the structural type item at a boundary such as Rustler encoding without duplicating its fields.

@spec type_item!(module(), atom() | String.t()) :: RustQ.Rust.AST.item()

Returns one generated Rust type item by name, raising when absent.