BaseHierarchyAdapter class abstract

Base class providing shared implementation for hierarchy adapters.

The HierarchyOccurrence tree rooted at root is the single source of truth. Children and signals are read directly from each occurrence's HierarchyOccurrence.children and HierarchyOccurrence.signals lists. Lookups use OccurrenceAddress-based navigation.

Concrete adapters should:

  1. Extend this class
  2. Build a complete HierarchyOccurrence tree (with children and signals populated on each occurrence)
  3. Set the root occurrence

Search, autocomplete, and signal lookup are implemented by HierarchyService via recursive tree walking.

Mixed-in types

Constructors

BaseHierarchyAdapter()
Creates a BaseHierarchyAdapter.
BaseHierarchyAdapter.fromTree(HierarchyOccurrence rootNode)
Creates an adapter wrapping an existing HierarchyOccurrence tree.
factory

Properties

hashCode int
The hash code for this object.
no setterinherited
root HierarchyOccurrence
The root occurrence for the hierarchy.
getter/setter pairoverride-getter
runtimeType Type
A representation of the runtime type of the object.
no setterinherited

Methods

addressToPathname(OccurrenceAddress address, {bool asSignal = false}) String?
Convert a OccurrenceAddress back to a /-separated pathname by walking the tree using child indices.
inherited
autocompletePaths(String partialPath, {int? limit}) List<String>
Autocomplete suggestions for a partial hierarchical path.
inherited
matchOccurrences(String query, {int? limit}) List<HierarchyOccurrence>
Find hierarchy occurrences whose path matches query.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
occurrenceByAddress(OccurrenceAddress address) HierarchyOccurrence?
Find an occurrence by its OccurrenceAddress. O(depth).
inherited
occurrenceByPathname(String pathname) HierarchyOccurrence?
Resolve a /-separated pathname to a HierarchyOccurrence.
inherited
pathnameToAddress(String pathname) OccurrenceAddress?
Convert a pathname (e.g. "Top/sub/clk" or "Top.sub.clk") to a OccurrenceAddress by walking the tree.
inherited
searchOccurrencePaths(String query, {int? limit}) List<String>
Find hierarchical occurrence paths matching query.
inherited
searchOccurrencePathsRegex(String pattern, {int? limit}) List<String>
Search for occurrence paths matching a regex pattern.
inherited
searchOccurrences(String query, {int? limit}) List<OccurrenceSearchResult>
Search for occurrences and return enriched OccurrenceSearchResult objects.
inherited
searchOccurrencesRegex(String pattern, {int? limit}) List<OccurrenceSearchResult>
Search for occurrences by regex pattern and return enriched results.
inherited
searchSignalPaths(String query, {int? limit}) List<String>
Find hierarchical signal paths matching query.
inherited
searchSignalPathsRegex(String pattern, {int? limit}) List<String>
Search for signals whose hierarchical path matches a regex pattern.
inherited
searchSignals(String query, {int? limit}) List<SignalSearchResult>
Search for signals and return enriched SignalSearchResult objects.
inherited
searchSignalsRegex(String pattern, {int? limit}) List<SignalSearchResult>
Search for signals by regex pattern and return enriched results.
inherited
signalByAddress(OccurrenceAddress address) SignalOccurrence?
Find a signal by its OccurrenceAddress.
inherited
toString() String
A string representation of this object.
inherited
waveformIdToAddress(String waveformId) OccurrenceAddress?
Resolve a signal identifier from a VCD or FST waveform file to an OccurrenceAddress.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited