goxmap

type BytePosition ¶

type BytePosition struct {
	Line   int
	Column int
}

BytePosition identifies a zero-based line and byte column.

type JSONDocument ¶

type JSONDocument struct {
	Version      int           `json:"version"`
	GeneratedURI string        `json:"generatedUri"`
	Sources      []string      `json:"sources"`
	Mappings     []JSONMapping `json:"mappings"`
}

type JSONMapping ¶

type JSONMapping struct {
	Generated JSONRange `json:"generated"`
	Source    string    `json:"source"`
	Original  JSONRange `json:"original"`
	Kind      string    `json:"kind"`
}

type JSONPosition ¶

type JSONPosition struct {
	Offset int `json:"offset"`
	Line   int `json:"line"`
	Column int `json:"column"`
}

type JSONRange ¶

type JSONRange struct {
	Start JSONPosition `json:"start"`
	End   JSONPosition `json:"end"`
}

type LineIndex ¶

type LineIndex struct {
	// contains filtered or unexported fields
}

LineIndex converts positions in one immutable source string. Newline bytes are represented by the position immediately after the line content. CRLF is treated as one newline and neither byte is part of the line content.

func NewLineIndex(text string) *LineIndex

func (i *LineIndex) ByteOffset(position BytePosition) (int, error)

func (i *LineIndex) BytePosition(offset int) (BytePosition, error)

func (i *LineIndex) LineCount() int

func (i *LineIndex) Text() string

func (i *LineIndex) UTF16Offset(position UTF16Position) (int, error)

func (i *LineIndex) UTF16Position(offset int) (UTF16Position, error)

type Map ¶

type Map struct {
	// contains filtered or unexported fields
}

Map is an immutable, bidirectional source map. Generated ranges may not overlap, which keeps forward lookups deterministic. Multiple generated ranges may refer to the same original range.

func Compose(generatedURI string, lower, upper *Map) (*Map, error)

func New(generatedURI string, mappings []Mapping) (*Map, error)

func UnmarshalJSONDocument(data []byte) (*Map, error)

func (m *Map) GeneratedPositions(uri string, offset int) []Position

func (m *Map) GeneratedURI() string

func (m *Map) Mappings() []Mapping

func (m *Map) OriginalPosition(offset int) (Position, bool)

func (m *Map) OriginalRange(generated Range) (SourceRange, MappingKind, bool)

type Mapping ¶

type Mapping struct {
	Generated Range
	Original  SourceRange
	Kind      MappingKind
}

Mapping relates one range in a generated document to an original source.

type MappingKind ¶

type MappingKind uint8

MappingKind describes how precisely generated bytes correspond to source.

const (
	// Exact maps byte-for-byte preserved text. Generated and original ranges
	// must have the same length.
	Exact MappingKind = iota
	// Anchor associates generated scaffolding with an original range. Positions
	// inside it resolve to the start of the original range and are not exact.
	Anchor
)

type Position ¶

type Position struct {
	URI    string
	Offset int
	Exact  bool
}

Position is the result of a source-map lookup.

type Range ¶

type Range struct {
	Start int
	End   int
}

Range is a zero-based, half-open byte range [Start, End).

func (r Range) Contains(offset int) bool

func (r Range) Empty() bool

func (r Range) Len() int

func (r Range) Valid() bool

type SourceRange ¶

type SourceRange struct {
	URI   string
	Range Range
}

SourceRange identifies a range in one source document.

type UTF16Position ¶

type UTF16Position struct {
	Line      int
	Character int
}

UTF16Position identifies a zero-based line and UTF-16 code-unit column, as required by the Language Server Protocol.

type Writer ¶

type Writer struct {
	// contains filtered or unexported fields
}

Writer builds transformed text and the map from that text to one immediate input document. It deliberately distinguishes copied bytes from generated scaffolding so callers cannot accidentally mark generated code as exact.

func NewWriter(generatedURI, sourceURI, source string) (*Writer, error)

func (w *Writer) Build() (string, *Map, error)

func (w *Writer) Len() int

func (w *Writer) String() string

func (w *Writer) WriteGenerated(text string, anchor Range) error

func (w *Writer) WriteSource(sourceRange Range) error