sid

package

v0.14.1 Latest Latest Go to latest Published: Apr 21, 2026 License: Apache-2.0 Imports: 6 Imported by: 0

Details

Package sid provides Stable ID calculation for AST nodes

This section is empty.

This section is empty.

This section is empty.

type SID string

SID represents a Stable Identifier for an AST node

func NewSID(path string, start, end int, kind string, childPath []int) SID

NewSID calculates a stable ID for an AST node Formula: hash(canonical_path | start_offset | end_offset | node_kind | child_path)

type SIDMap struct {
	SurfaceToCore map[SID][]SID
	CoreToSurface map[SID]SID
}

SIDMap maintains the mapping from surface SIDs to core SIDs

func NewSIDMap() *SIDMap

NewSIDMap creates a new SID mapping

func (m *SIDMap) AddMapping(surfaceSID SID, coreSID SID)

AddMapping records a surface→core SID mapping

func (m *SIDMap) GetCoreSIDs(surfaceSID SID) []SID

GetCoreSIDs returns all core SIDs derived from a surface SID

func (m *SIDMap) GetSurfaceSID(coreSID SID) (SID, bool)

GetSurfaceSID returns the surface SID that generated a core SID

func (m *SIDMap) GetTraceSlice(surfaceSID SID) *TraceSlice

GetTraceSlice returns the transformation trace for a surface SID

type TraceSlice struct {
	SurfaceSID  SID
	SurfaceKind string
	CoreSIDs    []SID
	CoreKinds   []string
	Steps       []TransformStep
}

TraceSlice represents the transformation path from surface to core

type TransformStep struct {
	Description string
	FromSID     SID
	ToSID       SID
}

TransformStep represents one step in the transformation