Struct DomIndex 

pub struct DomIndex { /* private fields */ }

Immutable per-tick snapshot of the selector-reachable element tree. Traversal and get_by_id read this directly; selector queries run in lumen-script over the same records.

Implementations

impl DomIndex

pub fn build(records: Vec<DomRecord>) -> Self

Build a snapshot from unordered records. Each record must carry its parent and ordered children; this computes sibling positions, depth-first document order, the entity and id lookup maps, and the root list. The last id wins on a duplicate (matching cascade “first match by document order” is applied by get_by_id reading the first-in-doc-order entry).

pub fn records(&self) -> &[DomRecord]

All records, unspecified order. Query callers sort by DomRecord::doc_order.

pub fn record(&self, entity: Entity) -> Option<&DomRecord>

Look up a record by entity.

pub fn get_by_id(&self, id: &str) -> Option<Entity>

Fast id lookup (get_by_id), first match in document order.

pub fn roots(&self) -> &[Entity]

Root elements, ordered.

pub fn document(&self) -> Option<Entity>

The document root (document()), the first root in order.

pub fn parent(&self, entity: Entity) -> Option<Entity>

Parent of entity, if any (node.parent()).

pub fn children(&self, entity: Entity) -> Vec<Entity>

Ordered children of entity (node.children()).

pub fn first_child(&self, entity: Entity) -> Option<Entity>

First child (node.first_child()).

pub fn last_child(&self, entity: Entity) -> Option<Entity>

Last child (node.last_child()).

pub fn next_sibling(&self, entity: Entity) -> Option<Entity>

Next sibling in document order (node.next()).

pub fn prev_sibling(&self, entity: Entity) -> Option<Entity>

Previous sibling in document order (node.prev()).

pub fn ancestors(&self, entity: Entity) -> Vec<Entity>

The ancestor chain of entity, closest-parent-first (not including entity). Used by lumen-script to build the root-first AncestorInfo slice the selector matcher consumes.

Trait Implementations

impl Debug for DomIndex

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

Formats the value using the given formatter.

impl Default for DomIndex

fn default() -> DomIndex

Returns the “default value” for a type.