언어 서버

Wippy에는 Lua 코드를 위한 IDE 기능을 제공하는 내장 LSP(Language Server Protocol) 서버가 포함되어 있습니다. 서버는 Wippy 런타임의 일부로 실행되며 TCP 또는 HTTP를 통해 에디터에 연결됩니다.

기능

.wippy.yaml에서 LSP 서버를 활성화합니다:

version: "1.0"

lua:
  type_system:
    enabled: true

lsp:
  enabled: true
  address: ":7777"

TCP 서버는 표준 LSP 메시지 프레이밍(Content-Length 헤더)과 함께 JSON-RPC 2.0을 사용합니다. 에디터 통합을 위한 기본 전송 방식입니다.

HTTP 전송은 JSON-RPC 페이로드가 포함된 POST 요청을 수락합니다. 브라우저 기반 에디터 및 웹 도구에 유용합니다. 크로스 오리진 접근을 위한 CORS 헤더가 포함됩니다.

lsp:
  enabled: true
  http_enabled: true
  http_address: ":7778"
  http_path: "/lsp"
  http_allow_origin: "*"

LSP 서버는 레지스트리 엔트리를 식별하기 위해 wippy:// URI 스킴을 사용합니다:

wippy://namespace:entry_name

에디터는 이러한 URI를 레지스트리의 엔트리 ID에 매핑합니다. wippy:// 스킴과 원시 namespace:entry_name 형식 모두 허용됩니다.

LSP 서버는 빠른 조회를 위해 모든 코드 엔트리의 인덱스를 유지합니다. 인덱싱은 여러 워커를 사용하여 백그라운드에서 수행됩니다.

주요 동작:

메서드	설명
`initialize`	기능 협상
`textDocument/didOpen`	열린 문서 추적
`textDocument/didChange`	전체 문서 동기화
`textDocument/didClose`	문서 해제
`textDocument/hover`	커서 위치의 타입 정보
`textDocument/definition`	정의로 이동
`textDocument/references`	모든 참조 찾기
`textDocument/completion`	코드 완성
`textDocument/signatureHelp`	함수 시그니처
`textDocument/diagnostic`	파일 진단
`textDocument/documentSymbol`	파일 심볼
`workspace/symbol`	전역 심볼 검색
`textDocument/prepareCallHierarchy`	호출 계층
`callHierarchy/incomingCalls`	호출자 찾기
`callHierarchy/outgoingCalls`	피호출자 찾기

완성 엔진은 코드 그래프를 통해 타입을 해석합니다. 다음을 제공합니다:

진단은 인덱싱 중에 계산되며 다음을 포함합니다:

진단은 문서 오버레이 시스템을 통해 입력하는 동안 업데이트됩니다.