kompas3d-lsp 0.1.0

LSP server for KOMPAS-3D ksAPI

KOMPAS-3D LSP

Language Server Protocol server for KOMPAS-3D ksAPI.

Auto-completion, hover docs, signature help and diagnostics for KOMPAS-3D scripting in Python, C++ and C#.

Powered by the official ksAPI documentation — 856 interfaces, 7104 methods. No KOMPAS-3D installation required.

---

Features

Feature	Status
textDocument/completion — interfaces, methods, enum constants	✅
textDocument/hover — descriptions with syntax and examples	✅
textDocument/signatureHelp — method signatures on argument input	✅
textDocument/publishDiagnostics — common mistake warnings	✅

---

Installation

pip install kompas3d-lsp

Verify:

kompas3d-lsp --help

---

OpenCode Integration

Put opencode.json in your project root:

{
  "lsp": {
    "kompas3d-lsp": {
      "command": ["kompas3d-lsp", "--stdio"],
      "extensions": [".py", ".cpp", ".h", ".cs"]
    }
  }
}

---

Environment Variables

Variable	Default	Description
KOMPAS_LSP_LANG	ru	Knowledge base language (ru / en)
KOMPAS_LSP_DATA_DIR	—	Custom path to {lang}/ksapi_knowledge.json

In opencode.json:

{
  "lsp": {
    "kompas3d-lsp": {
      "command": ["kompas3d-lsp", "--stdio"],
      "extensions": [".py"],
      "env": { "KOMPAS_LSP_LANG": "en" }
    }
  }
}

---

CLI

kompas3d-lsp --stdio          # stdio transport (default, for LSP clients)
kompas3d-lsp --tcp            # TCP transport (127.0.0.1:2087, debugging)
kompas3d-lsp --lang en        # override knowledge base language
kompas3d-lsp --help

---

Supported Languages

Extension	Language
.py, .pyw	Python
.cpp, .cxx, .cc, .h, .hpp, .hxx	C++
.cs	C#

---

Diagnostics

The server warns about:

1. Python: import win32com.client without try/except — KOMPAS may be missing on CI
2. C++: method call via -> without null check
3. C#: Marshal.GetActiveObject / Type.GetTypeFromProgID without try/catch

---

Client Configuration

VS Code

{
  "lsp.clients.kompas3d-lsp.command": ["kompas3d-lsp", "--stdio"]
}

Neovim (vim.lsp)

vim.api.nvim_create_autocmd("FileType", {
  pattern = "python",
  callback = function()
    vim.lsp.start({
      name = "kompas3d-lsp",
      cmd = { "kompas3d-lsp", "--stdio" },
    })
  end,
})

---

Links

• KOMPAS-3D SDK Documentation
• LSP Specification
• pygls

---

License

MIT