feat: add run option for postponing validation until the document is saved

README.md

@@ -224,6 +224,13 @@ Controls the package manager to be used to resolve the Stylelint library. This s
 
 An array of language identifiers specifying which files to enable snippets for.
 
+### `stylelint.run`
+
+> Type: `"onType" | "onSave"`
+> Default: `"onType"`
+
+Controls when Stylelint is run. Valid values are `"onType"` or `"onSave"`. When set to `"onType"`, styles are validated on every keystroke. When set to `"onSave"`, validation is postponed until the document is saved.
+
 ### `editor.codeActionsOnSave`
 
 This extension provides an action that you can use with VS Code's [`editor.codeActionsOnSave`][vscode settings] setting. If provided a `source.fixAll.stylelint` property set to `true`, all auto-fixable Stylelint errors will be fixed on save.

package.json

@@ -74,6 +74,16 @@
           "additionalProperties": false,
           "description": "Options for the disable lint rule action in the quick fix menu."
         },
+        "stylelint.run": {
+          "scope": "resource",
+          "type": "string",
+          "enum": [
+            "onType",
+            "onSave"
+          ],
+          "default": "onType",
+          "description": "Control when Stylelint valiation is performed."
+        },
         "stylelint.config": {
           "scope": "resource",
           "type": [

src/server/modules/validator.ts

@@ -113,12 +113,26 @@ export class ValidatorModule implements LanguageServerModule {
 
 		this.#logger?.debug('onDidChangeWatchedFiles handler registered');
 
-		this.#context.documents.onDidChangeContent(
-			async ({ document }) => await this.#validate(document),
-		);
+		this.#context.documents.onDidChangeContent(async ({ document }) => {
+			const options = await this.#context.getOptions(document.uri);
+
+			if (options.run !== 'onSave') {
+				await this.#validate(document);
+			}
+		});
 
 		this.#logger?.debug('onDidChangeContent handler registered');
 
+		this.#context.documents.onDidSave(async ({ document }) => {
+			const options = await this.#context.getOptions(document.uri);
+
+			if (options.run === 'onSave') {
+				await this.#validate(document);
+			}
+		});
+
+		this.#logger?.debug('onDidSave handler registered');
+
 		this.#context.documents.onDidClose(({ document }) => {
 			this.#clearDiagnostics(document);
 		});

src/server/types.ts

@@ -221,6 +221,7 @@ export type LanguageServerOptions = {
 			location: 'separateLine' | 'sameLine';
 		};
 	};
+	run?: 'onType' | 'onSave';
 	config?: stylelint.Config | null;
 	configBasedir?: string;
 	configFile?: string;