feat!: implement language service

.vscode/settings.json

@@ -47,5 +47,7 @@
     "editor.wordWrapColumn": 100,
     "editor.rulers": [100]
   },
-  "todo-tree.highlights.enabled": false
+  "todo-tree.highlights.enabled": false,
+  "jestrunner.jestCommand": "clear; node --no-warnings --experimental-vm-modules ./node_modules/jest/bin/jest.js",
+  "jestrunner.changeDirectoryToWorkspaceRoot": false
 }

conver.json

@@ -24,7 +24,7 @@
     "@knuckles/config": "minor",
     "@knuckles/eslint": "minor",
     "@knuckles/fabricator": "minor",
-    "@knuckles/language-server": "minor",
+    "@knuckles/language-service": "minor",
     "@knuckles/location": "minor",
     "@knuckles/parser": "minor",
     "@knuckles/ssr": "minor",

eslint.config.js

@@ -20,6 +20,7 @@ export default config([
       "**/vite.config.*",
       "**/jest.config.ts",
       "**/coverage/",
+      "**/__fixtures__/",
 
       // documentation
       "docs/**/*",

packages/analyzer/src/analyzer.ts

@@ -13,7 +13,7 @@ import {
   type NormalizedConfig,
 } from "@knuckles/config";
 import { type ParserError, parse } from "@knuckles/parser";
-import type { Document } from "@knuckles/syntax-tree";
+import type { SyntaxTree } from "@knuckles/syntax-tree";
 import assert from "node:assert";
 
 export interface AnalyzerOptions {
@@ -26,15 +26,15 @@ export interface AnalyzeOptions {
 }
 
 export interface AnalyzeCache {
-  document?: Document;
+  document?: SyntaxTree;
   snapshots?: Partial<AnalyzerSnapshots>;
 }
 
 export interface AnalyzeResult {
   issues: AnalyzerIssue[];
   snapshots: Partial<AnalyzerSnapshots>;
   metadata: Record<string, unknown>;
-  document: Document | null;
+  document: SyntaxTree | null;
 }
 
 export class Analyzer {
@@ -102,7 +102,7 @@ export class Analyzer {
     const snapshots = (options?.cache?.snapshots ?? {}) as AnalyzerSnapshots;
     const metadata = {};
 
-    let document: Document;
+    let document: SyntaxTree;
     if (options?.cache?.document) {
       document = options.cache.document;
     } else {

packages/analyzer/src/issue.ts

@@ -1,4 +1,4 @@
-import type { Position } from "@knuckles/location";
+import type { Position, Range } from "@knuckles/location";
 
 export enum AnalyzerSeverity {
   Error = "error",
@@ -11,4 +11,15 @@ export interface AnalyzerIssue {
   message: string;
   start: Position | undefined;
   end: Position | undefined;
+  quickFix?: AnalyzerQuickFix | undefined;
+}
+
+export interface AnalyzerQuickFix {
+  label?: string | undefined;
+  edits: AnalyzerQuickFixEdit[];
+}
+
+export interface AnalyzerQuickFixEdit {
+  range: Range;
+  text: string;
 }

packages/analyzer/src/plugin.ts

@@ -1,7 +1,7 @@
 import type { AnalyzerIssue } from "./issue.js";
 import type { NormalizedConfig } from "@knuckles/config";
 import type { Snapshot } from "@knuckles/fabricator";
-import type { Document } from "@knuckles/syntax-tree";
+import type { SyntaxTree } from "@knuckles/syntax-tree";
 
 export interface AnalyzerSnapshots {
   [name: string]: Snapshot | undefined;
@@ -12,7 +12,7 @@
 export interface AnalyzeContext {
   readonly fileName: string;
   readonly text: string;
-  readonly document: Document;
+  readonly document: SyntaxTree;
   readonly snapshots: AnalyzerSnapshots;
   readonly metadata: Record<string, unknown>;
 
@@ -20,7 +20,7 @@
 }
 
 export interface AnalyzerFlags {
   tsconfig?: any;
 }
 
 export interface InitializeContext {

packages/analyzer/src/standard/rules/virtual-element-end-notation.ts

@@ -10,9 +10,8 @@ export default {
   check({ report, document }) {
     document.visit(
       (node): void => {
-        const regex = new RegExp(
-          `\\/ko\\s+${escapeStringRegexp(node.binding.name.value)}`,
-        );
+        const bindingName = node.binding.name.value;
+        const regex = new RegExp(`\\/ko\\s+${escapeStringRegexp(bindingName)}`);
 
         if (!regex.test(node.endComment.content)) {
           report({
@@ -21,6 +20,15 @@ export default {
             severity: this.severity,
             start: node.endComment.start,
             end: node.endComment.end,
+            quickFix: {
+              label: "Add notation",
+              edits: [
+                {
+                  range: node.endComment,
+                  text: `<!-- /ko ${bindingName} -->`,
+                },
+              ],
+            },
           });
         }
       },

packages/analyzer/src/standard/transpile.ts

@@ -1,12 +1,12 @@
 import { Chunk } from "@knuckles/fabricator";
 import {
-  type Document,
+  type SyntaxTree,
   Element,
   type Binding,
   KoVirtualElement,
 } from "@knuckles/syntax-tree";
 
-export function transpile(document: Document) {
+export function transpile(document: SyntaxTree) {
   const chunk = new Chunk();
 
   const render = (binding: Binding) => {

packages/language-server/README.md → packages/language-service/README.md

@@ -1,20 +1,20 @@
 <!--
 ---
-name: language-server
+name: language-service
 ---
 -->
 
 # Language Server
 
-<!-- @include docs/parts/packages/language-server/description.md-->
+<!-- @include docs/parts/packages/language-service/description.md-->
 
 Implements a language server according to the [Language Server Protocol] (LSP) to provide language features for [Knockout] views.
 
 <!-- /include -->
 
 <!-- @include docs/parts/package-nav.md -->
 
-[**Documentation**](https://knuckles.elsk.dev) | [Package (npm)](https://npmjs.com/package/@knuckles/language-server) | [Repository](https://github.com/tscpp/knuckles) | [Source Code](https://github.com/tscpp/knuckles/tree/main/packages/language-server)
+[**Documentation**](https://knuckles.elsk.dev) | [Package (npm)](https://npmjs.com/package/@knuckles/language-service) | [Repository](https://github.com/tscpp/knuckles) | [Source Code](https://github.com/tscpp/knuckles/tree/main/packages/language-service)
 
 <!-- /include -->
 

packages/language-service/jest.config.ts

@@ -0,0 +1,6 @@
+/* eslint-disable */
+export default {
+  displayName: "@knuckles/language-service",
+  preset: "../../jest.preset.cjs",
+  coverageDirectory: "../../coverage/packages/language-service",
+};