Struct CodeNode 

pub struct CodeNode {

    pub id: String,
    pub name: String,
    pub qualified_name: String,
    pub kind: NodeKind,
    pub file: String,
    pub line_start: u32,
    pub line_end: u32,
    pub column: u32,
    pub signature: Option<String>,
    pub visibility: Visibility,
    pub is_async: bool,
    pub is_static: bool,
    pub is_exported: bool,
    pub docstring: Option<String>,
    pub byte_start: u32,
    pub byte_end: u32,
    pub references: Vec<String>,
}

A code entity extracted from source.

This is the core data type that flows through Arbor. It’s designed to be language-agnostic while still capturing the structure we need.

Fields

id: String

Unique identifier, derived from file path + qualified name + kind.

name: String

The simple name (e.g., “validate_user”).

qualified_name: String

Fully qualified name including parent scope (e.g., “UserService.validate_user”).

kind: NodeKind

What kind of entity this is.

file: String

Path to the source file, relative to project root.

line_start: u32

Starting line (1-indexed, like editors show).

line_end: u32

Ending line (inclusive).

column: u32

Column of the name identifier.

signature: Option<String>

Function/method signature if applicable.

visibility: Visibility

Visibility modifier.

is_async: bool

Whether this is async.

is_static: bool

Whether this is static/class-level.

is_exported: bool

Whether this is exported (TS/ES modules).

docstring: Option<String>

Docstring or leading comment.

byte_start: u32

Byte offset range in source for incremental updates.

byte_end: u32

references: Vec<String>

Entities this node references (call targets, type refs, etc). These are names, not IDs - resolution happens in the graph crate.

Implementations

impl CodeNode

pub fn compute_id(file: &str, qualified_name: &str, kind: NodeKind) -> String

Creates a deterministic ID for this node.

The ID is a hash of (file, qualified_name, kind) so the same entity always gets the same ID across parses.

pub fn new( name: impl Into<String>, qualified_name: impl Into<String>, kind: NodeKind, file: impl Into<String>, ) -> Self

Creates a new node and automatically computes its ID.

pub fn with_lines(self, start: u32, end: u32) -> Self

Builder pattern: set line range.

pub fn with_bytes(self, start: u32, end: u32) -> Self

Builder pattern: set byte range.

pub fn with_column(self, column: u32) -> Self

Builder pattern: set column.

pub fn with_signature(self, sig: impl Into<String>) -> Self

Builder pattern: set signature.

pub fn with_visibility(self, vis: Visibility) -> Self

Builder pattern: set visibility.

pub fn as_async(self) -> Self

Builder pattern: mark as async.

pub fn as_static(self) -> Self

Builder pattern: mark as static.

pub fn as_exported(self) -> Self

Builder pattern: mark as exported.

pub fn with_references(self, refs: Vec<String>) -> Self

Builder pattern: add references.

Trait Implementations

impl Clone for CodeNode

fn clone(&self) -> CodeNode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CodeNode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CodeNode

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for CodeNode

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CodeNode

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CodeNode

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for CodeNode