Add VS Code extension (minimal)

Author: python-processing-unit

spec.txt

@@ -109,7 +109,7 @@ which match the reference lexer implementation:
   - Uppercase letters 'A'–'Z'
   - Decimal digits '0'–'9'
   - The punctuation and symbol characters
-    '; . / ! @ $ % & ~ _ + | < > ?'
+    '; / ! @ $ % & ~ _ + | < > ?'
 
   As noted above, non-ASCII characters remain disallowed, and the
   delimiter characters '{', '}', '[', ']', '(', ')', '=', ',', and '#'

vscode/README.md

@@ -0,0 +1,21 @@
+# ASM-Lang VS Code extension (local)
+
+This extension provides minimal language support and run commands for ASM-Lang (ASMLN) bundled with this repository.
+
+Features:
+- Registers the `asmln` language and associates `.asmln` files.
+- Basic syntax highlighting for comments, strings, binary integer literals, keywords and builtins.
+- Two commands:
+  - `ASM-Lang: Run File` — runs the current file using the workspace `asmln.py` in an integrated terminal.
+  - `ASM-Lang: Start REPL` — starts the REPL by launching the interpreter with no file.
+
+Configuration:
+- `asmln.pythonPath` — path to the Python interpreter executable (default: `python`).
+
+Usage:
+1. Open the workspace root (this repository) in VS Code.
+2. Open an `.asmln` file.
+3. Run the command palette (Ctrl+Shift+P) and pick `ASM-Lang: Run File` or `ASM-Lang: Start REPL`.
+
+Notes:
+- The extension expects `asmln.py` to live in the workspace root. If your workspace layout differs, update the command or set a full path in `asmln.pythonPath`.

vscode/extension.js

@@ -0,0 +1,63 @@
+const vscode = require('vscode');
+const path = require('path');
+
+function getWorkspaceRoot() {
+    const ws = vscode.workspace.workspaceFolders;
+    if (!ws || ws.length === 0) return undefined;
+    return ws[0].uri.fsPath;
+}
+
+function resolveInterpreterPath() {
+    const config = vscode.workspace.getConfiguration();
+    const py = config.get('asmln.pythonPath');
+    return py || 'python';
+}
+
+function ensureSaved(editor) {
+    if (!editor) return Promise.resolve(true);
+    if (!editor.document.isDirty) return Promise.resolve(true);
+    return editor.document.save();
+}
+
+function runCommandInTerminal(command, cwd) {
+    const term = vscode.window.createTerminal({ cwd: cwd });
+    term.show(true);
+    term.sendText(command);
+}
+
+function runFile() {
+    const editor = vscode.window.activeTextEditor;
+    if (!editor) {
+        vscode.window.showInformationMessage('No active editor to run');
+        return;
+    }
+    ensureSaved(editor).then((ok) => {
+        if (!ok) return;
+        const filePath = editor.document.uri.fsPath;
+        const root = getWorkspaceRoot() || path.dirname(filePath);
+        const interp = resolveInterpreterPath();
+        const asmlnPath = path.join(root, 'asmln.py');
+        const cmd = `${interp} "${asmlnPath}" "${filePath}"`;
+        runCommandInTerminal(cmd, root);
+    });
+}
+
+function runRepl() {
+    const root = getWorkspaceRoot() || process.cwd();
+    const interp = resolveInterpreterPath();
+    const asmlnPath = path.join(root, 'asmln.py');
+    const cmd = `${interp} "${asmlnPath}"`;
+    runCommandInTerminal(cmd, root);
+}
+
+/** @param {vscode.ExtensionContext} context */
+function activate(context) {
+    context.subscriptions.push(
+        vscode.commands.registerCommand('asmln.runFile', runFile),
+        vscode.commands.registerCommand('asmln.runRepl', runRepl)
+    );
+}
+
+function deactivate() {}
+
+module.exports = { activate, deactivate };

vscode/language-configuration.json

@@ -0,0 +1,29 @@
+{
+  "comments": {
+    "lineComment": "#"
+  },
+  "brackets": [
+    ["[", "]"],
+    ["{", "}"],
+    ["(", ")"]
+  ],
+  "autoClosingPairs": [
+    { "open": "\"", "close": "\"", "notIn": ["string"] },
+    { "open": "(", "close": ")" },
+    { "open": "[", "close": "]" },
+    { "open": "{", "close": "}" }
+  ],
+  "surroundingPairs": [
+    { "open": "\"", "close": "\"" },
+    { "open": "(", "close": ")" },
+    { "open": "[", "close": "]" },
+    { "open": "{", "close": "}" }
+  ],
+  "wordPattern": "[a-zA-Z_/.!@$%&~+|<>?\\\\-]+|[01]+",
+  "folding": {
+    "markers": {
+      "start": "^\\s*\\[",
+      "end": "^\\s*\\]"
+    }
+  }
+}

vscode/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "asmln-language",
+  "displayName": "ASM-Lang",
+  "description": "Language support and helper commands for ASM-Lang (ASMLN)",
+  "version": "0.1.0",
+  "publisher": "python-processing-unit",
+  "engines": {
+    "vscode": "^1.60.0"
+  },
+  "categories": [
+    "Programming Languages"
+  ],
+  "activationEvents": [
+    "onCommand:asmln.runFile",
+    "onCommand:asmln.runRepl",
+    "onLanguage:asmln"
+  ],
+  "main": "extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": "asmln.runFile",
+        "title": "ASM-Lang: Run File"
+      },
+      {
+        "command": "asmln.runRepl",
+        "title": "ASM-Lang: Start REPL"
+      }
+    ],
+    "languages": [
+      {
+        "id": "asmln",
+        "aliases": ["ASM-Lang", "asmln"],
+        "extensions": [".asmln"],
+        "configuration": "language-configuration.json"
+      }
+    ],
+    "grammars": [
+      {
+        "language": "asmln",
+        "scopeName": "source.asmln",
+        "path": "syntaxes/asmln.tmLanguage.json"
+      }
+    ],
+    "configuration": {
+      "type": "object",
+      "title": "ASM-Lang",
+      "properties": {
+        "asmln.pythonPath": {
+          "type": "string",
+          "default": "python",
+          "description": "Path to Python executable used to run the bundled interpreter. Can be 'python' or full path to interpreter."
+        }
+      }
+    }
+  }
+}

vscode/syntaxes/asmln.tmLanguage.json

@@ -0,0 +1,35 @@
+{
+  "scopeName": "source.asmln",
+  "name": "ASM-Lang",
+  "patterns": [
+    {
+      "name": "comment.line.number-sign.asmln",
+      "match": "#.*$"
+    },
+    {
+      "name": "string.quoted.double.asmln",
+      "begin": "\"",
+      "end": "\"",
+      "patterns": [
+        { "match": "[^\\\"]+", "name": "string.content.asmln" }
+      ]
+    },
+    {
+      "name": "constant.numeric.binary.asmln",
+      "match": "-?[01]+\b"
+    },
+    {
+      "name": "keyword.control.asmln",
+      "match": "\b(IF|ELSIF|ELSE|WHILE|FOR|FUNC|RETURN|BREAK|CONTINUE|GOTO|GOTOPOINT)\b"
+    },
+    {
+      "name": "support.function.builtin.asmln",
+      "match": "\b(INPUT|PRINT|IMPORT|READFILE|WRITEFILE|EXISTFILE|EXIT|INT|STR|LEN|SLEN|ILEN|JOIN|AND|OR|XOR|NOT|EQ|MAX|MIN|SUM|PROD|UPPER|LOWER|ASSERT|CL|MAIN)\b"
+    },
+    {
+      "name": "variable.other.asmln",
+      "match": "[a-zA-Z_/.!@$%&~+|<>?][a-zA-Z0-9_/.!@$%&~+|<>?]*"
+    }
+  ],
+  "repository": {}
+}