linters(dart): detect runtime via dart --version, wire configs, link rule docs (#1098)

- Add version_command (parse `dart --version`) to respect system/Flutter
Dart
- Mark analysis_options.yaml as direct config; keep pubspec.yaml in
affects_cache
- Set suggest_if: files_present
- Bump known_good_version to 3.9.2
- Update snapshots for Dart 3.9.2 and add issueUrl fields

This pull request may resolve issue #1076.

Author: AndrewDongminYoo

linters/dart/plugin.yaml

@@ -15,7 +15,7 @@ tools:
   definitions:
     - name: dart
       download: dart
-      known_good_version: 3.2.6
+      known_good_version: 3.9.2
       shims: [dart, dartaotruntime]
       environment:
         - name: PATH
@@ -28,11 +28,16 @@ lint:
     - name: dart
       main_tool: dart
       files: [dart]
-      known_good_version: 3.2.6
-      suggest_if: never
+      known_good_version: 3.9.2
+      version_command:
+        parse_regex: "Dart SDK version: ${semver}"
+        run: dart --version
+      suggest_if: files_present
       description: Lints and formats dart code
-      affects_cache:
+      issue_url_format: https://dart.dev/tools/linter-rules/{}
+      direct_configs:
         - analysis_options.yaml
+      affects_cache:
         - pubspec.yaml
       commands:
         - name: format

…t/test_data/dart_v3.2.6_basic.check.shot …t/test_data/dart_v3.9.2_basic.check.shotlinters/dart/test_data/dart_v3.2.6_basic.check.shot renamed to linters/dart/test_data/dart_v3.9.2_basic.check.shot linters/dart/test_data/dart_v3.2.6_basic.check.shot renamed to linters/dart/test_data/dart_v3.9.2_basic.check.shot

@@ -8,8 +8,9 @@ exports[`Testing linter dart test basic 1`] = `
       "column": "10",
       "file": "test_data/basic.in.dart",
       "issueClass": "ISSUE_CLASS_EXISTING",
+      "issueUrl": "https://dart.dev/tools/linter-rules/undefined_identifier",
       "level": "LEVEL_HIGH",
-      "line": "14",
+      "line": "16",
       "linter": "dart",
       "message": "Undefined name 'find'. Try correcting the name to one that is defined, or defining the name.",
       "targetType": "dart",
@@ -19,8 +20,9 @@ exports[`Testing linter dart test basic 1`] = `
       "column": "25",
       "file": "test_data/basic.in.dart",
       "issueClass": "ISSUE_CLASS_EXISTING",
+      "issueUrl": "https://dart.dev/tools/linter-rules/undefined_identifier",
       "level": "LEVEL_HIGH",
-      "line": "14",
+      "line": "16",
       "linter": "dart",
       "message": "Undefined name 'empty'. Try correcting the name to one that is defined, or defining the name.",
       "targetType": "dart",
@@ -30,8 +32,9 @@ exports[`Testing linter dart test basic 1`] = `
       "column": "3",
       "file": "test_data/basic.in.dart",
       "issueClass": "ISSUE_CLASS_EXISTING",
+      "issueUrl": "https://dart.dev/tools/linter-rules/undefined_function",
       "level": "LEVEL_HIGH",
-      "line": "14",
+      "line": "16",
       "linter": "dart",
       "message": "The function 'expect' isn't defined. Try importing the library that defines 'expect', correcting the name to the name of an existing function, or defining a function named 'expect'.",
       "targetType": "dart",

…3.2.6_test_data.basic.in.dart.check.shot …3.9.2_test_data.basic.in.dart.check.shotlinters/dart/test_data/dart_v3.2.6_test_data.basic.in.dart.check.shot renamed to linters/dart/test_data/dart_v3.9.2_test_data.basic.in.dart.check.shot linters/dart/test_data/dart_v3.2.6_test_data.basic.in.dart.check.shot renamed to linters/dart/test_data/dart_v3.9.2_test_data.basic.in.dart.check.shot

@@ -3,6 +3,8 @@
 exports[`Testing linter dart test basic 1`] = `
 "library;
 
+import 'dart:io';
+
 class Vector2d {
   final double x, y;
   Vector2d(this.x, this.y);