api

type APIFileChangeSummary struct {
	Changed []DocumentIdentifier `json:"changed,omitempty"`
	Created []DocumentIdentifier `json:"created,omitempty"`
	Deleted []DocumentIdentifier `json:"deleted,omitempty"`
}

type APIFileChanges struct {
	InvalidateAll bool                 `json:"invalidateAll,omitempty"`
	Changed       []DocumentIdentifier `json:"changed,omitempty"`
	Created       []DocumentIdentifier `json:"created,omitempty"`
	Deleted       []DocumentIdentifier `json:"deleted,omitempty"`
}

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

type ConfigFileResponse struct {
	FileNames []string              `json:"fileNames"`
	Options   *core.CompilerOptions `json:"options"`
}

type Conn interface {
	// Run starts processing messages on the connection.
	// It blocks until the context is cancelled or an error occurs.
	Run(ctx context.Context) error

	// Call sends a request to the client and waits for a response.
	Call(ctx context.Context, method string, params any) (json.Value, error)

	// Notify sends a notification to the client (no response expected).
	Notify(ctx context.Context, method string, params any) error
}

type DocumentIdentifier struct {
	FileName string              `json:"fileName,omitempty"`
	URI      lsproto.DocumentUri `json:"uri,omitempty"`
}

type GetBaseTypeOfLiteralTypeParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	Type     Handle[checker.Type]     `json:"type"`
}

type GetContextualTypeParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	Location Handle[ast.Node]         `json:"location"`
}

type GetDefaultProjectForFileParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	File     DocumentIdentifier       `json:"file"`
}

type GetExportsOfSymbolParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Symbol   Handle[ast.Symbol]       `json:"symbol"`
}

type GetIntrinsicTypeParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
}

type GetMembersOfSymbolParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Symbol   Handle[ast.Symbol]       `json:"symbol"`
}

type GetParentOfSymbolParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Symbol   Handle[ast.Symbol]       `json:"symbol"`
}

type GetSignaturesOfTypeParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	Type     Handle[checker.Type]     `json:"type"`
	Kind     int32                    `json:"kind"`
}

type GetSourceFileParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	File     DocumentIdentifier       `json:"file"`
}

type GetSymbolAtLocationParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	Location Handle[ast.Node]         `json:"location"`
}

type GetSymbolAtPositionParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	File     DocumentIdentifier       `json:"file"`
	Position uint32                   `json:"position"`
}

type GetSymbolOfTypeParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Type     Handle[checker.Type]     `json:"type"`
}

type GetSymbolsAtLocationsParams struct {
	Snapshot  Handle[project.Snapshot] `json:"snapshot"`
	Project   Handle[project.Project]  `json:"project"`
	Locations []Handle[ast.Node]       `json:"locations"`
}

type GetSymbolsAtPositionsParams struct {
	Snapshot  Handle[project.Snapshot] `json:"snapshot"`
	Project   Handle[project.Project]  `json:"project"`
	File      DocumentIdentifier       `json:"file"`
	Positions []uint32                 `json:"positions"`
}

type GetTypeAtLocationParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	Location Handle[ast.Node]         `json:"location"`
}

type GetTypeAtLocationsParams struct {
	Snapshot  Handle[project.Snapshot] `json:"snapshot"`
	Project   Handle[project.Project]  `json:"project"`
	Locations []Handle[ast.Node]       `json:"locations"`
}

type GetTypeAtPositionParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	File     DocumentIdentifier       `json:"file"`
	Position uint32                   `json:"position"`
}

type GetTypeOfSymbolAtLocationParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	Symbol   Handle[ast.Symbol]       `json:"symbol"`
	Location Handle[ast.Node]         `json:"location"`
}

type GetTypeOfSymbolParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	Symbol   Handle[ast.Symbol]       `json:"symbol"`
}

type GetTypePropertyParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Type     Handle[checker.Type]     `json:"type"`
}

type GetTypesAtPositionsParams struct {
	Snapshot  Handle[project.Snapshot] `json:"snapshot"`
	Project   Handle[project.Project]  `json:"project"`
	File      DocumentIdentifier       `json:"file"`
	Positions []uint32                 `json:"positions"`
}

type GetTypesOfSymbolsParams struct {
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	Project  Handle[project.Project]  `json:"project"`
	Symbols  []Handle[ast.Symbol]     `json:"symbols"`
}

type Handle[T any] string

type Handler interface {
	// HandleRequest handles an incoming request and returns a result or error.
	HandleRequest(ctx context.Context, method string, params json.Value) (any, error)
	// HandleNotification handles an incoming notification.
	HandleNotification(ctx context.Context, method string, params json.Value) error
}

type InitializeResponse struct {
	// UseCaseSensitiveFileNames indicates whether the host file system is case-sensitive.
	UseCaseSensitiveFileNames bool `json:"useCaseSensitiveFileNames"`
	// CurrentDirectory is the server's current working directory.
	CurrentDirectory string `json:"currentDirectory"`
}

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

type Message = jsonrpc.Message

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

type MessageType uint8

type Method string

type ParseConfigFileParams struct {
	File DocumentIdentifier `json:"file"`
}

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

type ProjectFileChanges struct {
	// ChangedFiles lists source file paths whose content differs.
	ChangedFiles []tspath.Path `json:"changedFiles,omitempty"`
	// DeletedFiles lists source file paths removed from the project's program.
	DeletedFiles []tspath.Path `json:"deletedFiles,omitempty"`
}

type ProjectResponse struct {
	Id              Handle[project.Project] `json:"id"`
	ConfigFileName  string                  `json:"configFileName"`
	RootFiles       []string                `json:"rootFiles"`
	CompilerOptions *core.CompilerOptions   `json:"compilerOptions"`
}

type Protocol interface {
	// ReadMessage reads the next message from the connection.
	ReadMessage() (*Message, error)
	// WriteRequest writes a request message.
	WriteRequest(id *jsonrpc.ID, method string, params any) error
	// WriteNotification writes a notification message (no ID).
	WriteNotification(method string, params any) error
	// WriteResponse writes a successful response.
	WriteResponse(id *jsonrpc.ID, result any) error
	// WriteError writes an error response.
	WriteError(id *jsonrpc.ID, err *jsonrpc.ResponseError) error
}

type RawBinary []byte

type ReleaseParams struct {
	Handle string `json:"handle"`
}

type ResolveNameParams struct {
	Snapshot       Handle[project.Snapshot] `json:"snapshot"`
	Project        Handle[project.Project]  `json:"project"`
	Name           string                   `json:"name"`
	Location       Handle[ast.Node]         `json:"location,omitempty"`       // Optional: node handle for location context
	File           *DocumentIdentifier      `json:"file,omitempty"`           // Optional: file for location context (alternative to Location)
	Position       *uint32                  `json:"position,omitempty"`       // Optional: position in file for location context (with File)
	Meaning        uint32                   `json:"meaning"`                  // SymbolFlags for what kind of symbol to find
	ExcludeGlobals bool                     `json:"excludeGlobals,omitempty"` // Whether to exclude global symbols
}

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

type SessionOptions struct {
	// UseBinaryResponses enables binary responses for msgpack protocol.
	UseBinaryResponses bool
}

type SignatureResponse struct {
	Id             Handle[checker.Signature] `json:"id"`
	Flags          uint32                    `json:"flags"`
	Declaration    Handle[ast.Node]          `json:"declaration,omitempty"`
	TypeParameters []Handle[checker.Type]    `json:"typeParameters,omitempty"`
	Parameters     []Handle[ast.Symbol]      `json:"parameters,omitempty"`
	ThisParameter  Handle[ast.Symbol]        `json:"thisParameter,omitempty"`
	Target         Handle[checker.Signature] `json:"target,omitempty"`
}

type SnapshotChanges struct {
	// ChangedProjects maps project handles to the file changes within that project.
	// Projects not listed here (and not in RemovedProjects) are unchanged.
	ChangedProjects map[Handle[project.Project]]*ProjectFileChanges `json:"changedProjects,omitempty"`
	// RemovedProjects lists project handles that were present in the previous
	// snapshot but absent from the new one.
	RemovedProjects []Handle[project.Project] `json:"removedProjects,omitempty"`
}

type SourceFileResponse struct {
	Data string `json:"data"`
}

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

type StdioServerOptions struct {
	In                 io.ReadCloser
	Out                io.WriteCloser
	Err                io.Writer
	Cwd                string
	DefaultLibraryPath string
	// PipePath, if set, listens on a named pipe (Windows) or Unix domain
	// socket instead of using In/Out for communication.
	PipePath string
	// Callbacks specifies which filesystem operations should be delegated
	// to the client (e.g., "readFile", "fileExists"). Empty means no callbacks.
	Callbacks []string
	// Async enables JSON-RPC protocol with async connection handling.
	// When false (default), uses MessagePack protocol with sync connection.
	Async bool
}

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

type SymbolResponse struct {
	Id               Handle[ast.Symbol] `json:"id"`
	Name             string             `json:"name"`
	Flags            uint32             `json:"flags"`
	CheckFlags       uint32             `json:"checkFlags"`
	Declarations     []Handle[ast.Node] `json:"declarations,omitempty"`
	ValueDeclaration Handle[ast.Node]   `json:"valueDeclaration,omitempty"`
}

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

type Transport interface {
	// Accept waits for and returns the next connection.
	Accept() (io.ReadWriteCloser, error)
	// Close stops the transport from accepting new connections.
	Close() error
}

type TypeResponse struct {
	Id          Handle[checker.Type] `json:"id"`
	Flags       uint32               `json:"flags"`
	ObjectFlags uint32               `json:"objectFlags,omitempty"`

	// LiteralType data
	Value any `json:"value,omitempty"`

	// ObjectType / TypeReference / StringMappingType / IndexType target
	Target Handle[checker.Type] `json:"target,omitempty"`

	// InterfaceType type parameters
	TypeParameters      []Handle[checker.Type] `json:"typeParameters,omitempty"`
	OuterTypeParameters []Handle[checker.Type] `json:"outerTypeParameters,omitempty"`
	LocalTypeParameters []Handle[checker.Type] `json:"localTypeParameters,omitempty"`

	// TupleType data
	ElementFlags  []checker.ElementFlags `json:"elementFlags,omitempty"`
	FixedLength   *int                   `json:"fixedLength,omitempty"`
	TupleReadonly *bool                  `json:"readonly,omitempty"`

	// IndexedAccessType data
	ObjectType Handle[checker.Type] `json:"objectType,omitempty"`
	IndexType  Handle[checker.Type] `json:"indexType,omitempty"`

	// ConditionalType data
	CheckType   Handle[checker.Type] `json:"checkType,omitempty"`
	ExtendsType Handle[checker.Type] `json:"extendsType,omitempty"`

	// SubstitutionType data
	BaseType        Handle[checker.Type] `json:"baseType,omitempty"`
	SubstConstraint Handle[checker.Type] `json:"substConstraint,omitempty"`

	// TemplateLiteralType text segments
	Texts []string `json:"texts,omitempty"`

	// Symbol associated with structured types
	Symbol Handle[ast.Symbol] `json:"symbol,omitempty"`
}

type UpdateSnapshotParams struct {
	// OpenProject is the path to a tsconfig.json file to open/load in the new snapshot.
	OpenProject string `json:"openProject,omitempty"`
	// FileChanges describes file system changes since the last snapshot.
	FileChanges *APIFileChanges `json:"fileChanges,omitempty"`
}

type UpdateSnapshotResponse struct {
	// Snapshot is the handle for the newly created snapshot.
	Snapshot Handle[project.Snapshot] `json:"snapshot"`
	// Projects is the list of projects in the snapshot.
	Projects []*ProjectResponse `json:"projects"`
	// Changes describes source file differences from the previous snapshot.
	// Nil for the first snapshot in a session.
	Changes *SnapshotChanges `json:"changes,omitempty"`
}