garlic-vscode 0.1.0

package/.vscode/launch.json

@@ -0,0 +1,16 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "args": [
+                "--extensionDevelopmentPath=${workspaceFolder}"
+            ],
+            "name": "Launch Extension",
+            "outFiles": [
+                "${workspaceFolder}/out/**/*.js"
+            ],
+            "request": "launch",
+            "type": "extensionHost"
+        },
+    ]
+}

package/.vscode/tasks.json

@@ -0,0 +1,13 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "type": "npm",
+            "script": "compile",
+            "group": "build",
+            "problemMatcher": [],
+            "label": "npm: compile",
+            "detail": "tsc -p ./"
+        }
+    ]
+}

package/.vscodeignore

@@ -0,0 +1,5 @@
+src/**
+tsconfig.json
+**/*.map
+node_modules/**/test/**
+.gitignore

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FallingShrimp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# garlic-vscode
+
+## **这个文档是AI写的！！！**
+
+[Garlic](https://github.com/Shrimp-VM/garlic-language) DSL 的 VSCode 扩展，为 ShrimpVM 的 `.srk` 脚本提供语言支持。
+
+## 功能
+
+- **语法高亮**：TextMate 语法定义（`source.garlic`）
+- **智能补全**：节点名、属性键、值、数组槽位按上下文精准补全
+- **Hover 文档**：节点与属性的说明
+- **实时诊断**：基于 Godot 侧 structuredErrors 的语法错误提示
+
+## 前置条件
+
+语言服务器运行在 Godot 编辑器进程内（由 ShrimpVM 插件自动启动），因此使用本扩展前需要：
+
+1. 用 Godot 4.6 打开启用了 ShrimpVM 插件的项目
+2. 确认 LSP 监听 `127.0.0.1:6009`（可在 ProjectSettings `shrimpvm/garlic/lsp_port` 修改）
+
+扩展与服务器之间是 LSP base protocol 经 TCP 的字节透传，无需额外进程。
+
+## 使用
+
+### 开发调试
+
+```bash
+npm install
+npm run compile
+```
+
+用 VSCode 打开本文件夹，按 `F5` 启动扩展开发宿主，打开任意 `.srk` 文件即可。
+
+### 打包安装
+
+```bash
+npx @vscode/vsce package
+```
+
+安装生成的 `.vsix`，打开 `.srk` 文件即生效。
+
+## 设置
+
+| 配置项           | 默认值      | 说明                               |
+|------------------|-------------|------------------------------------|
+| `garlicLsp.host` | `127.0.0.1` | LSP 服务器所在主机（Godot 编辑器） |
+| `garlicLsp.port` | `6009`      | LSP 服务器 TCP 端口                |
+
+修改配置后扩展会自动重启语言客户端；连接失败时按 1 秒间隔重试 5 次，适配 Godot 编辑器启动慢于 VSCode 的场景。
+
+## 目录结构
+
+```plain
+src/extension.ts            客户端入口：TCP 连接、重试、配置变更自动重启
+syntaxes/garlic.tmLanguage.json  TextMate 语法
+language-configuration.json 括号配对、注释、自动缩进规则
+examples/add.srk            示例脚本
+```

package/examples/add.srk

@@ -0,0 +1,11 @@
+root(
+    body={
+        create_class(
+            name="Apple",
+            body={
+                member_access(object=this());
+            }
+        );
+        print(content=
+    }
+)

package/language-configuration.json

@@ -0,0 +1,110 @@
+{
+	"comments": {
+		"blockComment": [
+			"<",
+			">"
+		]
+	},
+	"brackets": [
+		[
+			"(",
+			")"
+		],
+		[
+			"{",
+			"}"
+		],
+		[
+			"[",
+			"]"
+		]
+	],
+	"autoClosingPairs": [
+		{
+			"open": "(",
+			"close": ")"
+		},
+		{
+			"open": "{",
+			"close": "}"
+		},
+		{
+			"open": "[",
+			"close": "]"
+		},
+		{
+			"open": "\"",
+			"close": "\"",
+			"notIn": [
+				"string",
+				"comment"
+			]
+		},
+		{
+			"open": "'",
+			"close": "'",
+			"notIn": [
+				"string",
+				"comment"
+			]
+		},
+		{
+			"open": "“",
+			"close": "”",
+			"notIn": [
+				"string",
+				"comment"
+			]
+		},
+		{
+			"open": "`",
+			"close": "`",
+			"notIn": [
+				"string",
+				"comment"
+			]
+		},
+		{
+			"open": "「",
+			"close": "」",
+			"notIn": [
+				"string",
+				"comment"
+			]
+		}
+	],
+	"surroundingPairs": [
+		[
+			"(",
+			")"
+		],
+		[
+			"{",
+			"}"
+		],
+		[
+			"[",
+			"]"
+		],
+		[
+			"\"",
+			"\""
+		],
+		[
+			"'",
+			"'"
+		],
+		[
+			"“",
+			"”"
+		],
+		[
+			"`",
+			"`"
+		],
+		[
+			"「",
+			"」"
+		]
+	]
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+    "name": "garlic-vscode",
+    "displayName": "Garlic",
+    "description": "Garlic DSL language support for ShrimpVM (.srk)",
+    "version": "0.1.0",
+    "publisher": "Rundll86",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/Rundll86/garlic-vscode"
+    },
+    "engines": {
+        "vscode": "^1.138.0"
+    },
+    "categories": [
+        "Programming Languages"
+    ],
+    "activationEvents": [],
+    "main": "./out/extension.js",
+    "contributes": {
+        "languages": [
+            {
+                "id": "garlic",
+                "aliases": [
+                    "Garlic",
+                    "garlic"
+                ],
+                "extensions": [
+                    ".srk"
+                ],
+                "configuration": "./language-configuration.json"
+            }
+        ],
+        "grammars": [
+            {
+                "language": "garlic",
+                "scopeName": "source.garlic",
+                "path": "./syntaxes/garlic.tmLanguage.json"
+            }
+        ],
+        "configuration": {
+            "title": "Garlic",
+            "properties": {
+                "garlicLsp.host": {
+                    "type": "string",
+                    "default": "127.0.0.1",
+                    "description": "Host running the Garlic LSP server (inside the Godot editor)."
+                },
+                "garlicLsp.port": {
+                    "type": "number",
+                    "default": 6009,
+                    "description": "TCP port of the Garlic LSP server."
+                }
+            }
+        }
+    },
+    "scripts": {
+        "compile": "tsc",
+        "watch": "tsc -watch",
+        "prepublishOnly": "run-s vscode:prepublish",
+        "vscode:prepublish": "run-s compile"
+    },
+    "dependencies": {
+        "vscode-languageclient": "^9.0.1"
+    },
+    "devDependencies": {
+        "@types/node": "^20.19.43",
+        "@types/vscode": "^1.138.0",
+        "npm-run-all": "^4.1.5",
+        "typescript": "^5.9.3"
+    }
+}

package/src/extension.ts

@@ -0,0 +1,61 @@
+import * as net from 'net';
+import * as vscode from 'vscode';
+import { LanguageClient, LanguageClientOptions, ServerOptions, StreamInfo } from 'vscode-languageclient/node';
+
+let client: LanguageClient | undefined;
+let restarting = false;
+
+export function activate(context: vscode.ExtensionContext) {
+    client = createClient();
+    context.subscriptions.push(client);
+    client.start();
+    context.subscriptions.push(vscode.workspace.onDidChangeConfiguration((event: vscode.ConfigurationChangeEvent) => {
+        if (event.affectsConfiguration('garlicLsp.host') || event.affectsConfiguration('garlicLsp.port')) {
+            restart(context);
+        }
+    }));
+}
+
+async function restart(context: vscode.ExtensionContext) {
+    if (restarting) {
+        return;
+    }
+    restarting = true;
+    try {
+        await client?.stop();
+        client = createClient();
+        context.subscriptions.push(client);
+        client.start();
+    } finally {
+        restarting = false;
+    }
+}
+
+function createClient(): LanguageClient {
+    const config = vscode.workspace.getConfiguration('garlicLsp');
+    const host = config.get<string>('host', '127.0.0.1');
+    const port = config.get<number>('port', 6009);
+    const serverOptions: ServerOptions = async (): Promise<StreamInfo> => {
+        let lastError: unknown;
+        for (let attempt = 0; attempt < 5; attempt++) {
+            try {
+                return await new Promise<StreamInfo>((resolve, reject) => {
+                    const socket = net.connect({ host, port }, () => resolve({ reader: socket, writer: socket }));
+                    socket.on('error', reject);
+                });
+            } catch (error) {
+                lastError = error;
+                await new Promise(resolve => setTimeout(resolve, 1000));
+            }
+        }
+        throw lastError ?? new Error(`cannot connect to Garlic LSP at ${host}:${port}`);
+    };
+    const clientOptions: LanguageClientOptions = {
+        documentSelector: [{ language: 'garlic' }]
+    };
+    return new LanguageClient('garlicLsp', 'Garlic LSP', serverOptions, clientOptions);
+}
+
+export function deactivate(): Thenable<void> | undefined {
+    return client?.stop();
+}

package/syntaxes/garlic.tmLanguage.json

@@ -0,0 +1,104 @@
+{
+	"$schema": "https://raw.githubusercontent.com/martinring/tmlanguage/master/tmlanguage.json",
+	"name": "Garlic",
+	"scopeName": "source.garlic",
+	"patterns": [
+		{
+			"include": "#comment"
+		},
+		{
+			"include": "#stringname"
+		},
+		{
+			"include": "#strings"
+		},
+		{
+			"include": "#node"
+		},
+		{
+			"include": "#attribute"
+		},
+		{
+			"include": "#number"
+		},
+		{
+			"include": "#boolean"
+		},
+		{
+			"include": "#punctuation"
+		}
+	],
+	"repository": {
+		"comment": {
+			"begin": "<",
+			"end": ">",
+			"name": "comment.block.garlic",
+			"patterns": [
+				{
+					"include": "#comment"
+				}
+			]
+		},
+		"strings": {
+			"patterns": [
+				{
+					"begin": "\"",
+					"end": "\"",
+					"name": "string.quoted.double.garlic",
+					"patterns": [
+						{
+							"match": "\\\\.",
+							"name": "constant.character.escape.garlic"
+						}
+					]
+				},
+				{
+					"begin": "'",
+					"end": "'",
+					"name": "string.quoted.single.garlic",
+					"patterns": [
+						{
+							"match": "\\\\.",
+							"name": "constant.character.escape.garlic"
+						}
+					]
+				},
+				{
+					"begin": "“",
+					"end": "”",
+					"name": "string.quoted.other.garlic"
+				},
+				{
+					"begin": "`",
+					"end": "`",
+					"name": "string.quoted.other.garlic"
+				}
+			]
+		},
+		"stringname": {
+			"begin": "「",
+			"end": "」",
+			"name": "string.quoted.stringname.garlic"
+		},
+		"node": {
+			"match": "\\b[A-Za-z_][A-Za-z0-9_]*(?=\\s*\\()",
+			"name": "entity.name.function.garlic"
+		},
+		"attribute": {
+			"match": "\\b[A-Za-z_][A-Za-z0-9_]*(?=\\s*=)",
+			"name": "entity.other.attribute-name.garlic"
+		},
+		"number": {
+			"match": "-?\\b\\d+(\\.\\d+)?\\b",
+			"name": "constant.numeric.garlic"
+		},
+		"boolean": {
+			"match": "\\b(true|false)\\b",
+			"name": "constant.language.garlic"
+		},
+		"punctuation": {
+			"match": "[()\\[\\]{},=;]",
+			"name": "punctuation.separator.garlic"
+		}
+	}
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+	"compilerOptions": {
+		"module": "commonjs",
+		"target": "ES2022",
+		"lib": [
+			"ES2022"
+		],
+		"outDir": "out",
+		"rootDir": "src",
+		"sourceMap": true,
+		"strict": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true
+	},
+	"include": [
+		"src"
+	]
+}