basic support for c3 language. (#4699)

* basic support for c3 language.

* Update docs/lsp-clients.json

* Update docs/lsp-clients.json

Author: diasbruno

CHANGELOG.org

@@ -31,6 +31,7 @@
   * Add Roc support
   * Add support for environment variables in rust analyzer runnables. Allowing the new ~Update Tests (Expect)~ code lens to work as expected.
   * Add support for [[https://github.com/mathworks/MATLAB-language-server][MATLAB language server]] (requires [[https://github.com/MathWorks/Emacs-MATLAB-Mode][matlab-mode]]).
+  * Add support for [[https://github.com/c3lang/c3c][c3 language]] (requires [[https://github.com/c3lang/c3-ts-mode][c3-ts-mode]] and [[https://github.com/pherrymason/c3-lsp][c3lsp]]).    
 
 ** 9.0.0
   * Add language server config for QML (Qt Modeling Language) using qmlls.

clients/lsp-c3.el

@@ -0,0 +1,88 @@
+;;; lsp-c3.el --- C3 Client settings             -*- lexical-binding: t; -*-
+
+;; Copyright (C) 2025 Bruno Dias
+
+;; Author: Bruno Dias
+;; Keywords: c3 lsp
+
+;; This program is free software; you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+;; GNU General Public License for more details.
+
+;; You should have received a copy of the GNU General Public License
+;; along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+;;; Commentary:
+
+;; lsp-c3 client
+
+;;; Code:
+
+(require 'lsp-mode)
+
+(defgroup lsp-c3 nil
+  "LSP support for the C3 programming language, using the server from https://github.com/pherrymason/c3-lsp."
+  :group 'lsp-mode
+  :link '(url-link "https://github.com/pherrymason/c3-lsp"))
+
+(defcustom lsp-c3-c3-language-server-path nil
+  "Path for c3-language-server.
+Prefer to build by hand for now."
+  :group 'lsp-c3
+  :risky t
+  :type 'file)
+
+(defcustom lsp-c3-c3-path ""
+  "The path to your C3 executable."
+  :type 'file
+  :group 'lsp-c3)
+
+(defcustom lsp-c3-c3-format-path ""
+  "The path to your c3-format executable.
+
+There is an effort to bring formatting/linting to c3."
+  :type 'file
+  :group 'lsp-c3)
+
+(defcustom lsp-c3-server-args '()
+  "Arguments to pass to the server."
+  :type '(repeat string)
+  :group 'lsp-c3)
+
+(defun lsp-c3--c3-language-server-command ()
+  "Generate LSP startup command for the C3 Language Server."
+  (cons
+   (or lsp-c3-c3-language-server-path
+       (lsp-package-path 'c3-language-server))
+   lsp-c3-server-args))
+
+(defun lsp-clients-c3--make-init-options ()
+  "Init options for C3-language-server."
+  `(:c3Path ,lsp-c3-c3-path
+    :c3FormatPath ,lsp-c3-c3-format-path))
+
+(lsp-register-client
+ (make-lsp-client
+  :new-connection (lsp-stdio-connection #'lsp-c3--c3-language-server-command)
+  :language-id "c3-ts"
+  :major-modes '(c3-ts-mode)
+  :priority 0
+  :initialization-options #'lsp-clients-c3--make-init-options
+  :server-id 'c3lsp
+  :download-server-fn (lambda (_client callback _error-callback _update?)
+                        (message "To use this lsp, you need to build it
+and use `lsp-c3-c3-language-server-path` to define where the executable is located.
+
+Hope soon, we integrate with the lsp installation system.")
+                        (funcall callback))))
+
+(lsp-consistency-check lsp-c3)
+
+(provide 'lsp-c3)
+;;; lsp-c3.el ends here

docs/lsp-clients.json

@@ -162,6 +162,14 @@
     "lsp-install-server": "csharp-roslyn",
     "debugger": "Yes (netcoredbg)"
   },
+  {
+    "name": "c3-lsp",
+    "full-name": "c3 language server",
+    "server-name": "c3lsp",
+    "server-url": "https://github.com/pherrymason/c3-lsp",
+    "installation-url": "https://github.com/pherrymason/c3-lsp",
+    "debugger": "Yes (gdb or lldb)"
+  },
   {
     "name": "ccls",
     "full-name": "C++",

lsp-mode.el

@@ -175,7 +175,7 @@ As defined by the Language Server Protocol 3.16."
 (defcustom lsp-client-packages
   '( ccls lsp-actionscript lsp-ada lsp-angular lsp-ansible lsp-asm lsp-astro
      lsp-autotools lsp-awk lsp-bash lsp-beancount lsp-bufls lsp-clangd
-     lsp-clojure lsp-cmake lsp-cobol lsp-credo lsp-crystal lsp-csharp lsp-css
+     lsp-clojure lsp-cmake lsp-cobol lsp-credo lsp-crystal lsp-csharp lsp-c3 lsp-css
      lsp-copilot lsp-cucumber lsp-cypher lsp-d lsp-dart lsp-dhall lsp-docker
      lsp-dockerfile lsp-earthly lsp-elixir lsp-elm lsp-emmet lsp-erlang
      lsp-eslint lsp-fortran lsp-futhark lsp-fsharp lsp-gdscript lsp-gleam

mkdocs.yml

@@ -63,6 +63,7 @@ nav:
     - C# (omnisharp-roslyn): page/lsp-csharp-omnisharp.md
     - C# (csharp-roslyn): page/lsp-csharp-roslyn.md
     - C# (csharp-ls): page/lsp-csharp-ls.md
+    - C3 (c3-lsp): page/lsp-c3.md
     - Clojure: page/lsp-clojure.md
     - CMake: page/lsp-cmake.md
     - COBOL: page/lsp-cobol.md