Add comment documents

Split delim nodes

Author: wherewhere

src/complete.ts

@@ -1,10 +1,14 @@
-import { completeFromList, ifNotIn } from "@codemirror/autocomplete";
+import { completeFromList, ifNotIn, type CompletionSource } from "@codemirror/autocomplete";
 import { atoms, keywords, types } from "./keywords";
 
 type CompletionType = "class" | "constant" | "enum" |
     "function" | "interface" | "keyword" | "method" | "namespace" |
     "property" | "text" | "type" | "variable";
 
+/**
+ * Gets C# keywords completion.
+ * @returns A {@link CompletionSource} instance for C# keywords.
+ */
 export function csharpCompletion() {
     function map(type: CompletionType) {
         return (label: string) => { return { label, type }; }

src/csharp.ts

@@ -3,6 +3,7 @@ import { parser } from "./syntax.grammar";
 import {
     LRLanguage,
     LanguageSupport,
+    LanguageDescription,
     indentNodeProp,
     foldNodeProp,
     foldInside,
@@ -40,11 +41,15 @@ function docCommentXmlOverlay(from: number, content: string) {
     return ranges.length > 0 ? ranges : null;
 }
 
+/** A language provider for C#. */
 export const csharpLanguage = LRLanguage.define({
     parser: parser.configure({
         props: [
             indentNodeProp.add({
-                Delim: continuedIndent({ except: /^\s*[\)\]\}]/ }),
+                BracesDelim: continuedIndent({ except: /^\s*[\}]/ }),
+                BracketsDelim: continuedIndent({ except: /^\s*[\]]/ }),
+                ParensDelim: continuedIndent({ except: /^\s*[\)]/ }),
+                ChevronsDelim: continuedIndent({ except: /^\s*[\>]/ }),
                 IfStmt: continuedIndent({ except: /^\s*({|else\b)/ }),
                 TryStmt: continuedIndent({ except: /^\s*({|catch\b|finally\b)/ }),
                 LabeledStmt: flatIndent,
@@ -116,6 +121,11 @@ export const csharpLanguage = LRLanguage.define({
 import { Prec } from "@codemirror/state";
 import { continueDocComment } from "./keymap";
 import { csharpCompletion } from "./complete";
+
+/**
+ * Gets C# support. Includes {@link continueDocComment}, {@link csharpCompletion} and {@link xml.support}.
+ * @returns A {@link LanguageSupport} instance for C#.
+ */
 export function csharp() {
     return new LanguageSupport(csharpLanguage, [
         Prec.high(continueDocComment),
@@ -124,4 +134,17 @@ export function csharp() {
         }),
         xml.support
     ]);
+}
+
+/**
+ * Gets C# language description.
+ * @returns A {@link LanguageDescription} instance for C#.
+ */
+export function csharpData() {
+    return LanguageDescription.of({
+        name: "C#",
+        alias: ["csharp", "cs"],
+        extensions: ["cs", "csx"],
+        support: csharp()
+    });
 }

src/keymap.ts

@@ -2,6 +2,7 @@ import { syntaxTree } from "@codemirror/language";
 import { keymap } from "@codemirror/view";
 import { EditorSelection } from "@codemirror/state";
 
+/** The {@link keymap} for continuing XML documentation comments. */
 export const continueDocComment = keymap.of([{
     key: "Enter",
     run(view) {