fix: address CRCs

Author: char0n

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

@@ -60,7 +60,9 @@ def __init__(
                 When specified, custom plugins are merged with the built-in plugins (both are loaded).
                 If None (default), only the built-in plugins directory is used (which is empty by default).
                 Plugins must export a function that receives a toolbox object with:
-                - deps: External dependencies (vscode-languageserver-types, @speclynx/apidom-reference)
+                - deps: External dependencies including vscode-languageserver-types, @speclynx/apidom-core,
+                  @speclynx/apidom-datamodel, @speclynx/apidom-json-path, @speclynx/apidom-json-pointer,
+                  @speclynx/apidom-traverse, and @speclynx/apidom-reference
                 - diagnostics: Array to collect validation diagnostics
                 See resources/plugins/example-plugin.mjs.sample for plugin format.
         """

packages/jentic-openapi-validator-speclynx/src/jentic/apitools/openapi/validator/backends/speclynx/resources/plugins/example-plugin.mjs.sample

@@ -7,10 +7,12 @@
  * Plugin structure:
  * - Must export a default function that accepts a toolbox object with:
  *   - diagnostics: Array to collect validation diagnostics
- *   - deps: External dependencies (vscode-languageserver-types, @speclynx/apidom-reference)
+ *   - deps: External dependencies (vscode-languageserver-types, @speclynx/apidom-core, etc.)
  * - Returns an object with pre/post hooks and a visitor property
  * - The visitor contains methods named after ApiDOM element types
- * - Each visitor method receives the element being visited
+ * - Each visitor method receives a path object with information about the current element
+ *   - path.node: The actual ApiDOM element being visited
+ *   - path.getPathKeys(): Returns the JSON path to the element
  *
  * @param {Object} toolbox - Plugin toolbox
  * @param {Array} toolbox.diagnostics - Array to collect validation diagnostics

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

@@ -8,7 +8,9 @@
  * When traversing parseResult.api (valid documents), ParseResultElement is not visited.
  *
  * Plugin receives toolbox with:
- * - deps: External dependencies (vscode-languageserver-types, @speclynx/apidom-reference)
+ * - deps: External dependencies including vscode-languageserver-types, @speclynx/apidom-core,
+ *   @speclynx/apidom-datamodel, @speclynx/apidom-json-path, @speclynx/apidom-json-pointer,
+ *   @speclynx/apidom-traverse, and @speclynx/apidom-reference
  * - diagnostics: Array to collect validation diagnostics
  */
 

packages/jentic-openapi-validator-speclynx/tests/fixtures/plugins/version-validator.mjs

@@ -2,7 +2,9 @@
  * Test plugin that validates info.version is a string
  *
  * Plugin receives toolbox with:
- * - deps: External dependencies (vscode-languageserver-types, @speclynx/apidom-reference)
+ * - deps: External dependencies including vscode-languageserver-types, @speclynx/apidom-core,
+ *   @speclynx/apidom-datamodel, @speclynx/apidom-json-path, @speclynx/apidom-json-pointer,
+ *   @speclynx/apidom-traverse, and @speclynx/apidom-reference
  * - diagnostics: Array to collect validation diagnostics
  */