chore(docs, cli): lsp docs and error in cli

crates/taplo-cli/Cargo.toml

@@ -4,7 +4,7 @@ description = "A CLI for Taplo TOML toolkit"
 license = "MIT"
 edition = "2021"
 name = "taplo-cli"
-version = "0.6.7"
+version = "0.6.8"
 homepage = "https://taplo.tamasfe.dev"
 repository = "https://github.com/tamasfe/taplo"
 categories = ["development-tools", "command-line-utilities"]

crates/taplo-cli/src/args.rs

@@ -55,7 +55,6 @@ pub enum TaploCommand {
     #[clap(visible_aliases = &["fmt"])]
     Format(FormatCommand),
     /// Language server operations.
-    #[cfg(feature = "lsp")]
     Lsp {
         #[clap(subcommand)]
         cmd: LspCommand,
@@ -105,7 +104,6 @@ pub struct FormatCommand {
     pub stdin_filepath: Option<String>,
 }
 
-#[cfg(feature = "lsp")]
 #[derive(Clone, Subcommand)]
 pub enum LspCommand {
     /// Run the language server and listen on a TCP address.

crates/taplo-cli/src/commands/mod.rs

@@ -1,3 +1,4 @@
+use anyhow::anyhow;
 use taplo_common::environment::Environment;
 
 use crate::{
@@ -25,8 +26,18 @@ impl<E: Environment> Taplo<E> {
 
         match taplo.cmd {
             TaploCommand::Format(fmt) => self.execute_format(fmt).await,
-            #[cfg(feature = "lsp")]
-            TaploCommand::Lsp { cmd } => self.execute_lsp(cmd).await,
+            TaploCommand::Lsp { cmd } => {
+                #[cfg(feature = "lsp")]
+                {
+                    self.execute_lsp(cmd).await
+                }
+                #[cfg(not(feature = "lsp"))]
+                {
+                    let _ = cmd;
+                    return Err(anyhow!("the LSP is not part of this build, please consult the documentation about enabling the functionality"));
+                }
+            }
+
             #[cfg(feature = "toml-test")]
             TaploCommand::TomlTest {} => self.execute_toml_test().await,
             TaploCommand::Lint(cmd) => self.execute_lint(cmd).await,

js/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taplo/cli",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "A TOML utility tool.",
   "bin": {
     "taplo": "dist/cli.js"

site/site/.vitepress/config.ts

@@ -96,6 +96,10 @@ export default defineConfigWithTheme<DefaultTheme.Config>({
               text: "Conversion and Extraction",
               link: "/cli/usage/conversion-and-extraction",
             },
+            {
+              text: "Language Server",
+              link: "/cli/usage/language-server",
+            },
           ],
         },
       ],

site/site/cli/usage/configuration.md

@@ -2,9 +2,10 @@
 
 ## Log Level
 
-Taplo uses the Rust `tracing` library for configurable logging features and respects the `RUST_LOG` environment variable.
+Taplo uses the Rust `tracing` library for configurable logging features and respects the `RUST_LOG` environment variable. All logs regardless of log level are printed to the standard error output.
 
-In most cases you might wish to disable logging after a certain log level, for example if you wish to only see error messages, you can do the following:
+In most cases you might wish to disable logging below a certain log level.
+As an example if you wish to only see error messages, you can do the following:
 
 ```sh
 RUST_LOG=error taplo lint foo.toml

site/site/cli/usage/language-server.md

@@ -0,0 +1,29 @@
+# Language Server
+
+The TOML language server can be used via the CLI and it supports communication via standard i/o or TCP.
+
+::: tip
+
+The language server is not part of the default builds, and is not available if Taplo was installed via NPM.
+
+Consult the build or installation documentation on how to enable the functionality.
+
+:::
+
+## Via Standard i/o
+
+```
+taplo lsp stdio
+```
+
+In this mode Taplo expects messages from the standard input, and will print messages intended for the client to the standard output.
+
+## Via TCP
+
+```
+taplo lsp tcp --address 0.0.0.0:9181
+```
+
+The server will listen on the given TCP address.
+
+Multiple clients are not supported.