feat(validator-speclynx): pass deps via toolbox (#206)

Also translate diagnostic data properly from reractor
plugins into Jentic diagnostic objects.

Author: char0n

packages/jentic-openapi-validator-speclynx/src/jentic/apitools/openapi/validator/backends/speclynx/__init__.py

@@ -220,9 +220,11 @@ def _validate_uri(
                 code=issue.get("code"),
                 source="speclynx-validator",
             )
+            issue_data = issue.get("data")
             diagnostic.set_target(target)
-            if "data" in issue and "path" in issue["data"]:
-                diagnostic.set_path(issue["data"]["path"])
+            if isinstance(issue_data, dict):
+                diagnostic.data.update(issue_data)  # type: ignore[union-attr]
+                diagnostic.set_path(issue_data.get("path"))
             diagnostics.append(diagnostic)
 
         return ValidationResult(diagnostics=diagnostics)

packages/jentic-openapi-validator-speclynx/src/jentic/apitools/openapi/validator/backends/speclynx/resources/speclynx.mjs

@@ -4,8 +4,10 @@ import {readdir, writeFile} from 'node:fs/promises';
 import path from 'node:path';
 import {pathToFileURL, fileURLToPath} from 'node:url';
 import {Command} from 'commander';
+import * as vscodeLanguageServerTypes from 'vscode-languageserver-types';
 import {Diagnostic, DiagnosticSeverity, Range} from 'vscode-languageserver-types';
-import {dispatchRefractorPlugins} from '@speclynx/apidom-core';
+import {dispatchRefractorPlugins, createToolbox as createToolboxBase} from '@speclynx/apidom-core';
+import * as apidomReference from '@speclynx/apidom-reference';
 import {parse, options} from '@speclynx/apidom-reference';
 import FileResolver from '@speclynx/apidom-reference/resolve/resolvers/file';
 import HTTPResolverAxios from '@speclynx/apidom-reference/resolve/resolvers/http-axios';
@@ -133,12 +135,23 @@ async function validate(document, cliOptions) {
         return {valid: false, diagnostics};
     }
 
+    // Toolbox creation
+    const createToolbox = () => ({
+        deps: {
+            'vscode-languageserver-types': vscodeLanguageServerTypes,
+            '@speclynx/apidom-reference': apidomReference,
+        },
+        ...createToolboxBase()
+    });
+
     // Run validation plugins
     // When parseResult.api exists, traverse it (paths are relative to document root)
     // When it doesn't exist (e.g., Swagger 2.0), traverse parseResult so ParseResultElement visitor runs
     const elementToTraverse = parseResult.api ?? parseResult;
     const dispatchRefractorPluginsAsync = promisify(dispatchRefractorPlugins);
-    await dispatchRefractorPluginsAsync(elementToTraverse, plugins.map(plugin => plugin({diagnostics})));
+    await dispatchRefractorPluginsAsync(elementToTraverse, plugins.map(plugin => plugin({diagnostics})), {
+        toolboxCreator: createToolbox,
+    });
 
     // Check if there are any errors or warnings
     const hasErrors = diagnostics.some(d => d.severity === DiagnosticSeverity.Error);