@razdolbai/merls 1.3.0 → 1.3.2

package/.harper-dictionary.txt

@@ -0,0 +1,2 @@
+coc
+js

package/README.md

@@ -1,25 +1,25 @@
-# merls
-
-`merls` is a language server for **Merlin-style 6502 assembly** with **coc.nvim** as the primary editor target.
-
+# merls
+
+`merls` is a language server for **Merlin-style 6502 assembly** with **coc.nvim** as the primary editor target.
+
 ## Status
 
 The MVP LSP feature set for Merlin-style 6502 assembly is complete and published to npm as `@razdolbai/merls`. It provides core language server features and is ready to be used with editors like `coc.nvim`.
-
-## Goals
-
-- provide a standalone LSP server over stdio
-- work cleanly with coc.nvim through standard language-server configuration
-- support Merlin-style 6502 source structure, symbols, directives, and expressions
-- deliver useful editing features before deeper assembler integration
-
-## Scope
-
-### In scope
+
+## Goals
+
+- Provide a standalone LSP server over stdio
+- Work cleanly with coc.nvim through standard language-server configuration
+- support Merlin-style 6502 source structure, symbols, directives, and expressions
+- Deliver useful editing features before deeper assembler integration
+
+## Scope
+
+### In Scope
 
 - 6502-only Merlin-style assembly
-- parser-based diagnostics for the MVP
-- core LSP features such as:
+- Parser-based diagnostics for the MVP
+- Core LSP features such as:
   - diagnostics
   - hover
   - completion
@@ -29,13 +29,11 @@ The MVP LSP feature set for Merlin-style 6502 assembly is complete and published
   - workspace symbols
   - semantic tokens (syntax highlighting)
 
-### Out of scope
+### Out of Scope
 
 - 65816 support
-- assembler-backed diagnostics in the first implementation pass
-- coc.nvim-specific plugin code for the MVP
-
-
+
+
 ## Implementation
 
 - **runtime:** Node.js
@@ -52,7 +50,7 @@ Install globally via npm:
 npm install -g @razdolbai/merls
 ```
 
-## Development workflow
+## Development Workflow
 
 - `npm install`: install project dependencies
 - `npm run build`: compile the TypeScript sources into `dist/`
@@ -60,14 +58,14 @@ npm install -g @razdolbai/merls
 - `npm run dev`: run the TypeScript compiler in watch mode during bootstrap work
 - `pwsh test/smoke/run-smoke.ps1`: run the headless Vim + coc.nvim smoke test (requires Vim with coc.nvim installed via vim-plug)
 
-The packaged CLI entrypoint now lives at `dist/src/cli.js`.
+The packaged CLI entry point now lives at `dist/src/cli.js`.
 
-## CLI contract
+## CLI Contract
 
 The supported stdio launch contract is `merls --stdio`.
 
 
-## coc.nvim target
+## coc.nvim Target
 
 The intended integration model is a standard `languageserver` entry in `coc-settings.json` that launches `merls` over stdio.
 
@@ -75,6 +73,7 @@ If you installed `merls` globally via npm, the `languageserver` shape is:
 
 ```json
 {
+  "semanticTokens.enable": true,
   "languageserver": {
     "merls": {
       "command": "merls",
@@ -85,21 +84,23 @@ If you installed `merls` globally via npm, the `languageserver` shape is:
         ".git"
       ],
       "filetypes": [
-        "asm"
+        "6502"
       ]
     }
   }
 }
 ```
 
+To enable semantic tokens for syntax highlighting, ensure `"semanticTokens.enable": true` is set in your `coc-settings.json` and that your Vim buffer is set to the matching filetype (e.g. `set filetype=6502`).
+
 An example configuration lives in `examples/coc-settings.json`.
-
-## Development notes
+
+## Development Notes
 
 - TDD is mandatory for implementation work in this repository.
 - Core syntax, parsing, and document model logic is located in `src/asm/`.
 - LSP handlers (hover, completion, diagnostics, etc.) are located in `src/lsp/`.
-- The CLI entrypoint lives in `src/cli.ts` and compiles to `dist/src/cli.js`.
+- The CLI entry point lives in `src/cli.ts` and compiles to `dist/src/cli.js`.
 - The `test/fixtures/valid/` directory contains supported 6502 Merlin-style syntax samples.
 - The `test/fixtures/invalid/` directory contains unsupported 65816-only syntax samples for negative testing.
 - The integration test suite covers stdio `initialize`, the CLI contract, and core LSP features.

package/dist/src/asm/parser.js

@@ -57,7 +57,8 @@ function parseStructuredLine(text, tokens) {
             text
         };
     }
-    if (token.kind === "expressionOperator" && token.lexeme === "=") {
+    if ((token.kind === "expressionOperator" && token.lexeme === "=") ||
+        (token.kind === "directive" && token.lexeme.toLowerCase() === "equ")) {
         if (label === null) {
             throw new Error("equate requires a label");
         }

package/dist/test/definition-references.test.js

@@ -107,7 +107,7 @@ async function runDefinitionReferencesTest() {
         });
         const definition = definitionResponse.result;
         strict_1.default.equal(definition.uri, mainUri);
-        strict_1.default.equal(definition.range.start.line, 69);
+        strict_1.default.equal(definition.range.start.line, 70);
         const referencesResponse = await sendRequest("textDocument/references", {
             textDocument: { uri: mainUri },
             position: positionOf(text, "GetKey  ldx"),
@@ -117,8 +117,8 @@ async function runDefinitionReferencesTest() {
         });
         const references = referencesResponse.result;
         strict_1.default.equal(Array.isArray(references), true);
-        strict_1.default.equal(references.some((reference) => reference.uri === mainUri && reference.range.start.line === 69), true);
         strict_1.default.equal(references.some((reference) => reference.uri === mainUri && reference.range.start.line === 70), true);
+        strict_1.default.equal(references.some((reference) => reference.uri === mainUri && reference.range.start.line === 71), true);
     }
     finally {
         child.kill();

package/dist/test/local-labels.test.js

@@ -14,30 +14,30 @@ function runLocalLabelScopeTest() {
     const source = node_fs_1.default.readFileSync(fixturePath, "utf8");
     const document = (0, document_1.parseDocument)(source);
     const scope = (0, local_labels_1.resolveLocalLabels)(document);
-    strict_1.default.deepEqual(scope.definitions.get("]loop@69"), {
+    strict_1.default.deepEqual(scope.definitions.get("]loop@70"), {
         name: "]loop",
-        line: 71,
+        line: 72,
         anchor: "GetKey",
-        qualifiedName: "]loop@69"
+        qualifiedName: "]loop@70"
     });
-    strict_1.default.deepEqual(scope.references.get("]loop@73"), {
+    strict_1.default.deepEqual(scope.references.get("]loop@74"), {
         name: "]loop",
-        line: 73,
+        line: 74,
         anchor: "GetKey",
-        qualifiedName: "]loop@69",
-        targetLine: 71
+        qualifiedName: "]loop@70",
+        targetLine: 72
     });
-    strict_1.default.deepEqual(scope.definitions.get(":err@69"), {
+    strict_1.default.deepEqual(scope.definitions.get(":err@70"), {
         name: ":err",
-        line: 82,
+        line: 83,
         anchor: "GetKey",
-        qualifiedName: ":err@69"
+        qualifiedName: ":err@70"
     });
-    strict_1.default.deepEqual(scope.references.get(":good@81"), {
+    strict_1.default.deepEqual(scope.references.get(":good@82"), {
         name: ":good",
-        line: 81,
+        line: 82,
         anchor: "GetKey",
-        qualifiedName: ":good@69",
-        targetLine: 84
+        qualifiedName: ":good@70",
+        targetLine: 85
     });
 }

package/dist/test/symbols.test.js

@@ -22,16 +22,21 @@ function runSymbolsTest() {
     strict_1.default.deepEqual(symbols.get("TEST_START"), {
         name: "TEST_START",
         kind: "label",
-        line: 31
+        line: 32
     });
     strict_1.default.deepEqual(symbols.get("dum0"), {
         name: "dum0",
         kind: "data",
-        line: 17
+        line: 18
     });
     strict_1.default.deepEqual(symbols.get("_num1"), {
         name: "_num1",
         kind: "data",
-        line: 25
+        line: 26
+    });
+    strict_1.default.deepEqual(symbols.get("MY_VAL"), {
+        name: "MY_VAL",
+        kind: "equate",
+        line: 15
     });
 }

package/examples/coc-settings.json

@@ -1,4 +1,5 @@
 {
+  "semanticTokens.enable": true,
   "languageserver": {
     "merls": {
       "command": "merls",
@@ -9,7 +10,7 @@
         ".git"
       ],
       "filetypes": [
-        "asm"
+        "6502"
       ]
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razdolbai/merls",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Language server for Merlin-style 6502 assembly.",
   "license": "MIT",
   "type": "commonjs",

package/src/asm/parser.ts

@@ -127,7 +127,10 @@ function parseStructuredLine(text: string, tokens: readonly Token[]): ParsedLine
     };
   }
 
-  if (token.kind === "expressionOperator" && token.lexeme === "=") {
+  if (
+    (token.kind === "expressionOperator" && token.lexeme === "=") ||
+    (token.kind === "directive" && token.lexeme.toLowerCase() === "equ")
+  ) {
     if (label === null) {
       throw new Error("equate requires a label");
     }

package/test/definition-references.test.ts

@@ -132,7 +132,7 @@ export async function runDefinitionReferencesTest(): Promise<void> {
 
     const definition = definitionResponse.result as { uri: string; range: { start: { line: number } } };
     assert.equal(definition.uri, mainUri);
-    assert.equal(definition.range.start.line, 69);
+    assert.equal(definition.range.start.line, 70);
 
     const referencesResponse = await sendRequest("textDocument/references", {
       textDocument: { uri: mainUri },
@@ -144,8 +144,8 @@ export async function runDefinitionReferencesTest(): Promise<void> {
 
     const references = referencesResponse.result as Array<{ uri: string; range: { start: { line: number } } }>;
     assert.equal(Array.isArray(references), true);
-    assert.equal(references.some((reference) => reference.uri === mainUri && reference.range.start.line === 69), true);
     assert.equal(references.some((reference) => reference.uri === mainUri && reference.range.start.line === 70), true);
+    assert.equal(references.some((reference) => reference.uri === mainUri && reference.range.start.line === 71), true);
   } finally {
     child.kill();
   }

package/test/fixtures/valid/merlin32-main-6502.S

@@ -13,6 +13,7 @@ TEXT    =   $FB39
 CROUT   =   $FD8E
 DOSWARM =   $3D0
 TSTADDR =   $1000
+MY_VAL  EQU $42
 
         DUM 0
 dum0    ds  1

package/test/local-labels.test.ts

@@ -15,33 +15,33 @@ export function runLocalLabelScopeTest(): void {
   const document = parseDocument(source);
   const scope = resolveLocalLabels(document);
 
-  assert.deepEqual(scope.definitions.get("]loop@69"), {
+  assert.deepEqual(scope.definitions.get("]loop@70"), {
     name: "]loop",
-    line: 71,
+    line: 72,
     anchor: "GetKey",
-    qualifiedName: "]loop@69"
+    qualifiedName: "]loop@70"
   });
 
-  assert.deepEqual(scope.references.get("]loop@73"), {
+  assert.deepEqual(scope.references.get("]loop@74"), {
     name: "]loop",
-    line: 73,
+    line: 74,
     anchor: "GetKey",
-    qualifiedName: "]loop@69",
-    targetLine: 71
+    qualifiedName: "]loop@70",
+    targetLine: 72
   });
 
-  assert.deepEqual(scope.definitions.get(":err@69"), {
+  assert.deepEqual(scope.definitions.get(":err@70"), {
     name: ":err",
-    line: 82,
+    line: 83,
     anchor: "GetKey",
-    qualifiedName: ":err@69"
+    qualifiedName: ":err@70"
   });
 
-  assert.deepEqual(scope.references.get(":good@81"), {
+  assert.deepEqual(scope.references.get(":good@82"), {
     name: ":good",
-    line: 81,
+    line: 82,
     anchor: "GetKey",
-    qualifiedName: ":good@69",
-    targetLine: 84
+    qualifiedName: ":good@70",
+    targetLine: 85
   });
 }

package/test/symbols.test.ts

@@ -24,18 +24,24 @@ export function runSymbolsTest(): void {
   assert.deepEqual(symbols.get("TEST_START"), {
     name: "TEST_START",
     kind: "label",
-    line: 31
+    line: 32
   });
 
   assert.deepEqual(symbols.get("dum0"), {
     name: "dum0",
     kind: "data",
-    line: 17
+    line: 18
   });
 
   assert.deepEqual(symbols.get("_num1"), {
     name: "_num1",
     kind: "data",
-    line: 25
+    line: 26
+  });
+
+  assert.deepEqual(symbols.get("MY_VAL"), {
+    name: "MY_VAL",
+    kind: "equate",
+    line: 15
   });
 }