Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
56 lines (48 loc) · 2.41 KB

CONTRIBUTING.md

File metadata and controls

56 lines (48 loc) · 2.41 KB
Raw

Contributing

Test

make test/unit
make test/mutation

test/mutation downloads infection.phar lazily into var/ and runs against the same source + test set. The PHAR distribution sidesteps the thecodingmachine/safe / psr/log conflicts that prevent a composer-installed Infection from coexisting with phpactor/language-server. Curated equivalent-mutation ignores live in infection.json5 with per-mutator ignore rules and inline rationale.

How it works

PHP-semantic GTD / hover / completion is backed by phpactor/worse-reflection and jetbrains/phpstorm-stubs. xphp-specific paths run FIRST (template instantiation, type-args inside <...> clauses); when those don't apply we fall through to the worse-reflection path so behaviour on .xphp files matches PhpStorm's PHP intelligence on regular .php files. The same PhpHoverResolver / PhpDefinitionResolver / PhpCompletionResolver triad also drives signatureHelp, inlayHint, and callHierarchy so all five features agree on receiver / member resolution.

LSP capabilities advertised at initialize

For LSP-client developers wiring this server into a non-bundled editor:

  • textDocumentSync: 1 (Full)
  • hoverProvider, definitionProvider, typeDefinitionProvider, referencesProvider, implementationProvider
  • documentHighlightProvider, documentSymbolProvider, workspaceSymbolProvider
  • renameProvider
  • foldingRangeProvider
  • completionProvider with triggerCharacters: ["<", ",", ">", ":"] and resolveProvider: true
  • signatureHelpProvider with triggerCharacters: ["(", ","]
  • inlayHintProvider
  • codeActionProvider with resolveProvider: true
  • codeLensProvider with resolveProvider: true
  • executeCommandProvider advertising xphp.showReferences (the "Show references" CodeLens command) -- advertised by default so PhpStorm renders the lens as clickable; suppressed when the client sends initializationOptions: {advertiseCodeLensCommand: false} (VS Code does, to avoid its forwarder shadowing the client handler)
  • callHierarchyProvider, typeHierarchyProvider
  • semanticTokensProvider (full file; standard LSP-spec token legend including typeParameter)
  • Pull-mode diagnosticProvider
  • workspace.fileOperations.willRename (LSP 3.17)
  • workspace.didChangeWatchedFiles (dynamic registration)