feat(vscode): add devsper VS Code extension with snippets and grammar

Author: rithulkamesh

tools/vscode/language-configuration.json

@@ -0,0 +1,26 @@
+{
+  "comments": {
+    "lineComment": "--",
+    "blockComment": ["--[[", "]]"]
+  },
+  "brackets": [
+    ["{", "}"],
+    ["[", "]"],
+    ["(", ")"]
+  ],
+  "autoClosingPairs": [
+    { "open": "{", "close": "}" },
+    { "open": "[", "close": "]" },
+    { "open": "(", "close": ")" },
+    { "open": "\"", "close": "\"" },
+    { "open": "'", "close": "'" },
+    { "open": "--[[", "close": "]]" }
+  ],
+  "surroundingPairs": [
+    ["{", "}"],
+    ["[", "]"],
+    ["(", ")"],
+    ["\"", "\""],
+    ["'", "'"]
+  ]
+}

tools/vscode/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "devsper-lsp",
+  "displayName": "Devsper Language Support",
+  "description": "Autocomplete, hover docs, and diagnostics for .devsper workflow and tool files",
+  "version": "0.1.0",
+  "publisher": "devsper",
+  "engines": { "vscode": "^1.85.0" },
+  "categories": ["Programming Languages", "Snippets"],
+  "contributes": {
+    "languages": [
+      {
+        "id": "devsper",
+        "aliases": ["Devsper", "devsper"],
+        "extensions": [".devsper"],
+        "configuration": "./language-configuration.json"
+      }
+    ],
+    "grammars": [
+      {
+        "language": "devsper",
+        "scopeName": "source.devsper",
+        "path": "./syntaxes/devsper.tmLanguage.json"
+      }
+    ],
+    "snippets": [
+      {
+        "language": "devsper",
+        "path": "./snippets/devsper.json"
+      }
+    ]
+  }
+}

tools/vscode/snippets/devsper.json

@@ -0,0 +1,61 @@
+{
+  "Workflow": {
+    "prefix": "workflow",
+    "body": [
+      "local wf = devsper.workflow({",
+      "\tname    = \"${1:my-workflow}\",",
+      "\tmodel   = \"${2:auto}\",",
+      "\tworkers = ${3:4},",
+      "})",
+      "",
+      "wf.task(\"${4:task-1}\", {",
+      "\tprompt = \"${5:Describe what this task should do.}\",",
+      "})",
+      "",
+      "return wf"
+    ],
+    "description": "New devsper workflow"
+  },
+  "Task": {
+    "prefix": "task",
+    "body": [
+      "wf.task(\"${1:task-name}\", {",
+      "\tprompt     = \"${2:Describe what this task should do.}\",",
+      "\tdepends_on = { ${3} },",
+      "})"
+    ],
+    "description": "Add a task to the workflow DAG"
+  },
+  "Plugin": {
+    "prefix": "plugin",
+    "body": [
+      "wf.plugin(\"${1:git}\", { source = \"builtin:${1:git}\" })"
+    ],
+    "description": "Load a builtin plugin (git, search, http, code, filesystem)"
+  },
+  "Input": {
+    "prefix": "input",
+    "body": [
+      "wf.input(\"${1:param_name}\", {",
+      "\ttype     = \"${2|string,number,boolean,object|}\",",
+      "\trequired = ${3|true,false|},",
+      "})"
+    ],
+    "description": "Declare a typed workflow input"
+  },
+  "Tool": {
+    "prefix": "tool",
+    "body": [
+      "devsper.tool(\"${1:tool.name}\", {",
+      "\tdescription = \"${2:What this tool does.}\",",
+      "\tparams = {",
+      "\t\t${3:param} = { type = \"${4|string,number,boolean,object|}\", required = ${5|true,false|} },",
+      "\t},",
+      "\trun = function(ctx, args)",
+      "\t\t${6:-- implementation}",
+      "\tend,",
+      "})"
+    ],
+    "description": "Register a new devsper tool"
+  }
+}

tools/vscode/syntaxes/devsper.tmLanguage.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
+  "name": "Devsper",
+  "scopeName": "source.devsper",
+  "patterns": [
+    { "include": "#devsper-keywords" },
+    { "include": "source.lua" }
+  ],
+  "repository": {
+    "devsper-keywords": {
+      "patterns": [
+        {
+          "comment": "devsper global and wf builder",
+          "match": "\\b(devsper|wf)\\b(?=\\.)",
+          "name": "support.class.devsper"
+        },
+        {
+          "comment": "builtin: plugin name prefix",
+          "match": "\"builtin:[a-zA-Z0-9_-]+\"",
+          "name": "support.constant.devsper"
+        },
+        {
+          "comment": "devsper method names",
+          "match": "\\.(workflow|tool|exec|log|http|get|post|task|plugin|input)\\b",
+          "name": "support.function.devsper"
+        }
+      ]
+    }
+  }
+}