anweiss · anweiss · Aug 22, 2025 · Aug 19, 2025 · Aug 19, 2025 · Aug 19, 2025
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -0,0 +1,7 @@
+{
+    "codeQL.githubDatabase.download": "never",
+    "sarif-viewer.connectToGithubCodeScanning": "off",
+    "files.readonlyInclude": {
+        "{**/.c4z/.extsrcs/*.PROTSYM.cbl,**/.c4z/.extsrcs/*.PROTSYM.listing}": true
+    }
+}
diff --git a/cddl-lsp/.vscode/settings.json b/cddl-lsp/.vscode/settings.json
@@ -4,6 +4,9 @@
 	"typescript.tsc.autoDetect": "off",
 	"typescript.preferences.quoteStyle": "single",
 	"editor.codeActionsOnSave": {
-		"source.fixAll.eslint": true
+		"source.fixAll.eslint": "explicit"
+	},
+	"files.readonlyInclude": {
+		"{**/.c4z/.extsrcs/*.PROTSYM.cbl,**/.c4z/.extsrcs/*.PROTSYM.listing}": true
 	}
 }
diff --git a/cddl-lsp/README.md b/cddl-lsp/README.md
@@ -6,11 +6,63 @@
 
 Language server implementation and Visual Studio Code Extension for the Concise Data Definition Language (CDDL). This extension supports the following features:
 
-- Syntax highlighting
-- Intellisense
-  - Standard prelude
-  - Control operators
-  - Group and type rule identifiers
-- Go-to definition
-- Basic diagnostics
-- Formatting
+* **Syntax highlighting**
+* **Intellisense**
+  + Standard prelude
+  + Control operators
+  + Group and type rule identifiers
+  + Socket/plug completions with deduplication
+* **Go-to definition**
+* **Find references**
+* **Document symbols** (outline view)
+* **Workspace symbol search** (search across all CDDL files)
+* **Signature help** for generics and control operators
+* **Enhanced diagnostics** (configurable)
+  + Syntax validation
+  + Unused rule detection (with CDDL-aware reference tracking)
+  + Style warnings (spacing, trailing commas)
+  + Circular dependency detection
+* **Code actions & quick fixes**
+  + Fix spacing around operators
+  + Remove trailing commas
+  + Remove unused rules
+  + Organize CDDL rules
+  + Format document
+* **Advanced formatting** (configurable)
+  + Multi-line map formatting
+  + Proper indentation
+  + Range formatting support
+  + Can be disabled via settings
+
+## Configuration
+
+This extension contributes the following settings:
+
+* `cddl.maxNumberOfProblems`: Controls the maximum number of problems produced by the server (default: 100)
+* `cddl.trace.server`: Traces the communication between VS Code and the language server (default: "off")
+* `cddl.formatting.enabled`: Enable/disable CDDL document formatting (default: true)
+* `cddl.diagnostics.trailingCommas`: Enable/disable trailing comma warnings (default: true)
+
+### Disabling Formatting
+
+To disable CDDL formatting, add this to your VS Code settings:
+
+```json
+{
+  "cddl.formatting.enabled": false
+}
+```
+
+When disabled, the "Format Document" command and automatic formatting will not modify CDDL content.
+
+### Disabling Trailing Comma Warnings
+
+To disable trailing comma warnings, add this to your VS Code settings:
+
+```json
+{
+  "cddl.diagnostics.trailingCommas": false
+}
+```
+
+When disabled, the language server will not show warnings about potentially unnecessary trailing commas.