@speclynx/apidom-ns-openapi-2 1.12.1

package/src/refractor/specification.mjs

@@ -0,0 +1,484 @@
+import { specificationObj as JSONSchemaDraft4Specification } from '@speclynx/apidom-ns-json-schema-draft-4';
+import FallbackVisitor from "./visitors/FallbackVisitor.mjs";
+import SwaggerVisitor from "./visitors/open-api-2/index.mjs";
+import SwaggerSwaggerVisitor from "./visitors/open-api-2/SwaggerVisitor.mjs";
+import SwaggerHostVisitor from "./visitors/open-api-2/HostVisitor.mjs";
+import SwaggerBasePathVisitor from "./visitors/open-api-2/BasePathVisitor.mjs";
+import SwaggerSchemesVisitor from "./visitors/open-api-2/SchemesVisitor.mjs";
+import SwaggerConsumesVisitor from "./visitors/open-api-2/ConsumesVisitor.mjs";
+import SwaggerProducesVisitor from "./visitors/open-api-2/ProducesVisitor.mjs";
+import SwaggerSecurityVisitor from "./visitors/open-api-2/SecurityVisitor.mjs";
+import SwaggerTagsVisitor from "./visitors/open-api-2/TagsVisitor.mjs";
+import InfoVisitor from "./visitors/open-api-2/info/index.mjs";
+import InfoVersionVisitor from "./visitors/open-api-2/info/VersionVisitor.mjs";
+import ContactVisitor from "./visitors/open-api-2/contact/index.mjs";
+import LicenseVisitor from "./visitors/open-api-2/license/index.mjs";
+import PathsVisitor from "./visitors/open-api-2/paths/index.mjs";
+import PathItemVisitor from "./visitors/open-api-2/path-item/index.mjs";
+import PathItem$RefVisitor from "./visitors/open-api-2/path-item/$RefVisitor.mjs";
+import PathItemParametersVisitor from "./visitors/open-api-2/path-item/ParametersVisitor.mjs";
+import OperationVisitor from "./visitors/open-api-2/operation/index.mjs";
+import OperationTagsVisitor from "./visitors/open-api-2/operation/TagsVisitor.mjs";
+import OperationConsumesVisitor from "./visitors/open-api-2/operation/ConsumesVisitor.mjs";
+import OperationProducesVisitor from "./visitors/open-api-2/operation/ProducesVisitor.mjs";
+import OperationParametersVisitor from "./visitors/open-api-2/operation/ParametersVisitor.mjs";
+import OperationSchemesVisitor from "./visitors/open-api-2/operation/SchemesVisitor.mjs";
+import OperationSecurityVisitor from "./visitors/open-api-2/operation/SecurityVisitor.mjs";
+import ExternalDocumentationElement from "./visitors/open-api-2/external-documentation/index.mjs";
+import ParameterVisitor from "./visitors/open-api-2/parameter/index.mjs";
+import ItemsVisitor from "./visitors/open-api-2/items/index.mjs";
+import ResponsesVisitor from "./visitors/open-api-2/responses/index.mjs";
+import ResponsesDefaultVisitor from "./visitors/open-api-2/responses/DefaultVisitor.mjs";
+import ResponseVisitor from "./visitors/open-api-2/response/index.mjs";
+import HeadersVisitor from "./visitors/open-api-2/headers/index.mjs";
+import ExampleVisitor from "./visitors/open-api-2/example/index.mjs";
+import HeaderVisitor from "./visitors/open-api-2/header/index.mjs";
+import TagVisitor from "./visitors/open-api-2/tag/index.mjs";
+import ReferenceVisitor from "./visitors/open-api-2/reference/index.mjs";
+import Reference$RefVisitor from "./visitors/open-api-2/reference/$RefVisitor.mjs";
+import SchemaVisitor from "./visitors/open-api-2/schema/index.mjs";
+import SchemaAllOfVisitor from "./visitors/open-api-2/schema/AllOfVisitor.mjs";
+import SchemaItemsVisitor from "./visitors/open-api-2/schema/ItemsVisitor.mjs";
+import SchemaPropertiesVisitor from "./visitors/open-api-2/schema/PropertiesVisitor.mjs";
+import SchemaOrJSONReferenceVisitor from "./visitors/open-api-2/schema/SchemaOrJSONReferenceVisitor.mjs";
+import XmlVisitor from "./visitors/open-api-2/xml/index.mjs";
+import DefinitionsVisitor from "./visitors/open-api-2/definitions/index.mjs";
+import ResponsesDefinitionsVisitor from "./visitors/open-api-2/responses-definitions/index.mjs";
+import ParametersDefinitionsVisitor from "./visitors/open-api-2/parameters-definitions/index.mjs";
+import SecurityDefinitionsVisitor from "./visitors/open-api-2/security-definitions/index.mjs";
+import SecuritySchemeVisitor from "./visitors/open-api-2/security-scheme/index.mjs";
+import ScopesVisitor from "./visitors/open-api-2/scopes/index.mjs";
+import SecurityRequirementVisitor from "./visitors/open-api-2/security-requirement/index.mjs";
+import SpecificationExtensionVisitor from "./visitors/SpecificationExtensionVisitor.mjs";
+/**
+ * Specification object allows us to have complete control over visitors
+ * when traversing the ApiDOM.
+ * Specification also allows us to create amended refractors from
+ * existing ones by manipulating it.
+ *
+ * Note: Specification object allows to use absolute internal JSON pointers.
+ */
+const {
+  fixedFields: jsonSchemaFixedFields
+} = JSONSchemaDraft4Specification.visitors.document.objects.JSONSchema;
+
+/**
+ * @public
+ */
+const specification = {
+  visitors: {
+    value: FallbackVisitor,
+    document: {
+      objects: {
+        // JSON Schema Draft 4/5 specific visitors
+        JSONReference: JSONSchemaDraft4Specification.visitors.document.objects.JSONReference,
+        JSONSchema: {
+          $ref: '#/visitors/document/objects/Schema'
+        },
+        // OpenAPI 2 specific visitors
+        Swagger: {
+          $visitor: SwaggerVisitor,
+          fixedFields: {
+            swagger: SwaggerSwaggerVisitor,
+            info: {
+              $ref: '#/visitors/document/objects/Info'
+            },
+            host: SwaggerHostVisitor,
+            basePath: SwaggerBasePathVisitor,
+            schemes: SwaggerSchemesVisitor,
+            consumes: SwaggerConsumesVisitor,
+            produces: SwaggerProducesVisitor,
+            paths: {
+              $ref: '#/visitors/document/objects/Paths'
+            },
+            definitions: {
+              $ref: '#/visitors/document/objects/Definitions'
+            },
+            parameters: {
+              $ref: '#/visitors/document/objects/ParametersDefinitions'
+            },
+            responses: {
+              $ref: '#/visitors/document/objects/ResponsesDefinitions'
+            },
+            securityDefinitions: {
+              $ref: '#/visitors/document/objects/SecurityDefinitions'
+            },
+            security: SwaggerSecurityVisitor,
+            tags: SwaggerTagsVisitor,
+            externalDocs: {
+              $ref: '#/visitors/document/objects/ExternalDocumentation'
+            }
+          }
+        },
+        Info: {
+          $visitor: InfoVisitor,
+          fixedFields: {
+            title: {
+              $ref: '#/visitors/value'
+            },
+            description: {
+              $ref: '#/visitors/value'
+            },
+            termsOfService: {
+              $ref: '#/visitors/value'
+            },
+            contact: {
+              $ref: '#/visitors/document/objects/Contact'
+            },
+            license: {
+              $ref: '#/visitors/document/objects/License'
+            },
+            version: InfoVersionVisitor
+          }
+        },
+        Contact: {
+          $visitor: ContactVisitor,
+          fixedFields: {
+            name: {
+              $ref: '#/visitors/value'
+            },
+            url: {
+              $ref: '#/visitors/value'
+            },
+            email: {
+              $ref: '#/visitors/value'
+            }
+          }
+        },
+        License: {
+          $visitor: LicenseVisitor,
+          fixedFields: {
+            name: {
+              $ref: '#/visitors/value'
+            },
+            url: {
+              $ref: '#/visitors/value'
+            }
+          }
+        },
+        Paths: {
+          $visitor: PathsVisitor
+        },
+        PathItem: {
+          $visitor: PathItemVisitor,
+          fixedFields: {
+            $ref: PathItem$RefVisitor,
+            get: {
+              $ref: '#/visitors/document/objects/Operation'
+            },
+            put: {
+              $ref: '#/visitors/document/objects/Operation'
+            },
+            post: {
+              $ref: '#/visitors/document/objects/Operation'
+            },
+            delete: {
+              $ref: '#/visitors/document/objects/Operation'
+            },
+            options: {
+              $ref: '#/visitors/document/objects/Operation'
+            },
+            head: {
+              $ref: '#/visitors/document/objects/Operation'
+            },
+            patch: {
+              $ref: '#/visitors/document/objects/Operation'
+            },
+            parameters: PathItemParametersVisitor
+          }
+        },
+        Operation: {
+          $visitor: OperationVisitor,
+          fixedFields: {
+            tags: OperationTagsVisitor,
+            summary: {
+              $ref: '#/visitors/value'
+            },
+            description: {
+              $ref: '#/visitors/value'
+            },
+            externalDocs: {
+              $ref: '#/visitors/document/objects/ExternalDocumentation'
+            },
+            operationId: {
+              $ref: '#/visitors/value'
+            },
+            consumes: OperationConsumesVisitor,
+            produces: OperationProducesVisitor,
+            parameters: OperationParametersVisitor,
+            responses: {
+              $ref: '#/visitors/document/objects/Responses'
+            },
+            schemes: OperationSchemesVisitor,
+            deprecated: {
+              $ref: '#/visitors/value'
+            },
+            security: OperationSecurityVisitor
+          }
+        },
+        ExternalDocumentation: {
+          $visitor: ExternalDocumentationElement,
+          fixedFields: {
+            description: {
+              $ref: '#/visitors/value'
+            },
+            url: {
+              $ref: '#/visitors/value'
+            }
+          }
+        },
+        Parameter: {
+          $visitor: ParameterVisitor,
+          fixedFields: {
+            name: {
+              $ref: '#/visitors/value'
+            },
+            in: {
+              $ref: '#/visitors/value'
+            },
+            description: jsonSchemaFixedFields.description,
+            required: jsonSchemaFixedFields.required,
+            schema: SchemaOrJSONReferenceVisitor,
+            type: jsonSchemaFixedFields.type,
+            format: jsonSchemaFixedFields.format,
+            items: {
+              $ref: '#/visitors/document/objects/Items'
+            },
+            collectionFormat: {
+              $ref: '#/visitors/value'
+            },
+            default: jsonSchemaFixedFields.default,
+            maximum: jsonSchemaFixedFields.maximum,
+            exclusiveMaximum: jsonSchemaFixedFields.exclusiveMaximum,
+            minimum: jsonSchemaFixedFields.minimum,
+            exclusiveMinimum: jsonSchemaFixedFields.exclusiveMinimum,
+            maxLength: jsonSchemaFixedFields.maxLength,
+            minLength: jsonSchemaFixedFields.minLength,
+            pattern: jsonSchemaFixedFields.pattern,
+            maxItems: jsonSchemaFixedFields.maxItems,
+            minItems: jsonSchemaFixedFields.minItems,
+            uniqueItems: jsonSchemaFixedFields.uniqueItems,
+            enum: jsonSchemaFixedFields.enum,
+            multipleOf: jsonSchemaFixedFields.multipleOf
+          }
+        },
+        Items: {
+          $visitor: ItemsVisitor,
+          fixedFields: {
+            type: jsonSchemaFixedFields.type,
+            format: jsonSchemaFixedFields.format,
+            items: {
+              $ref: '#/visitors/document/objects/Items'
+            },
+            collectionFormat: {
+              $ref: '#/visitors/value'
+            },
+            default: jsonSchemaFixedFields.default,
+            maximum: jsonSchemaFixedFields.maximum,
+            exclusiveMaximum: jsonSchemaFixedFields.exclusiveMaximum,
+            minimum: jsonSchemaFixedFields.minimum,
+            exclusiveMinimum: jsonSchemaFixedFields.exclusiveMinimum,
+            maxLength: jsonSchemaFixedFields.maxLength,
+            minLength: jsonSchemaFixedFields.minLength,
+            pattern: jsonSchemaFixedFields.pattern,
+            maxItems: jsonSchemaFixedFields.maxItems,
+            minItems: jsonSchemaFixedFields.minItems,
+            uniqueItems: jsonSchemaFixedFields.uniqueItems,
+            enum: jsonSchemaFixedFields.enum,
+            multipleOf: jsonSchemaFixedFields.multipleOf
+          }
+        },
+        Responses: {
+          $visitor: ResponsesVisitor,
+          fixedFields: {
+            default: ResponsesDefaultVisitor
+          }
+        },
+        Response: {
+          $visitor: ResponseVisitor,
+          fixedFields: {
+            description: {
+              $ref: '#/visitors/value'
+            },
+            schema: SchemaOrJSONReferenceVisitor,
+            headers: {
+              $ref: '#/visitors/document/objects/Headers'
+            },
+            examples: {
+              $ref: '#/visitors/document/objects/Example'
+            }
+          }
+        },
+        Headers: {
+          $visitor: HeadersVisitor
+        },
+        Example: {
+          $visitor: ExampleVisitor
+        },
+        Header: {
+          $visitor: HeaderVisitor,
+          fixedFields: {
+            description: jsonSchemaFixedFields.description,
+            type: jsonSchemaFixedFields.type,
+            format: jsonSchemaFixedFields.format,
+            items: {
+              $ref: '#/visitors/document/objects/Items'
+            },
+            collectionFormat: {
+              $ref: '#/visitors/value'
+            },
+            default: jsonSchemaFixedFields.default,
+            maximum: jsonSchemaFixedFields.maximum,
+            exclusiveMaximum: jsonSchemaFixedFields.exclusiveMaximum,
+            minimum: jsonSchemaFixedFields.minimum,
+            exclusiveMinimum: jsonSchemaFixedFields.exclusiveMinimum,
+            maxLength: jsonSchemaFixedFields.maxLength,
+            minLength: jsonSchemaFixedFields.minLength,
+            pattern: jsonSchemaFixedFields.pattern,
+            maxItems: jsonSchemaFixedFields.maxItems,
+            minItems: jsonSchemaFixedFields.minItems,
+            uniqueItems: jsonSchemaFixedFields.uniqueItems,
+            enum: jsonSchemaFixedFields.enum,
+            multipleOf: jsonSchemaFixedFields.multipleOf
+          }
+        },
+        Tag: {
+          $visitor: TagVisitor,
+          fixedFields: {
+            name: {
+              $ref: '#/visitors/value'
+            },
+            description: {
+              $ref: '#/visitors/value'
+            },
+            externalDocs: {
+              $ref: '#/visitors/document/objects/ExternalDocumentation'
+            }
+          }
+        },
+        Reference: {
+          $visitor: ReferenceVisitor,
+          fixedFields: {
+            $ref: Reference$RefVisitor
+          }
+        },
+        Schema: {
+          $visitor: SchemaVisitor,
+          fixedFields: {
+            // the following properties are taken directly from the JSON Schema definition and follow the same specifications
+            format: jsonSchemaFixedFields.format,
+            title: jsonSchemaFixedFields.title,
+            description: jsonSchemaFixedFields.description,
+            default: jsonSchemaFixedFields.default,
+            multipleOf: jsonSchemaFixedFields.multipleOf,
+            maximum: jsonSchemaFixedFields.maximum,
+            exclusiveMaximum: jsonSchemaFixedFields.exclusiveMaximum,
+            minimum: jsonSchemaFixedFields.minimum,
+            exclusiveMinimum: jsonSchemaFixedFields.exclusiveMinimum,
+            maxLength: jsonSchemaFixedFields.maxLength,
+            minLength: jsonSchemaFixedFields.minLength,
+            pattern: jsonSchemaFixedFields.pattern,
+            maxItems: jsonSchemaFixedFields.maxItems,
+            minItems: jsonSchemaFixedFields.minItems,
+            uniqueItems: jsonSchemaFixedFields.uniqueItems,
+            maxProperties: jsonSchemaFixedFields.maxProperties,
+            minProperties: jsonSchemaFixedFields.minProperties,
+            required: jsonSchemaFixedFields.required,
+            enum: jsonSchemaFixedFields.enum,
+            type: jsonSchemaFixedFields.type,
+            readOnly: jsonSchemaFixedFields.readOnly,
+            // the following properties are taken from the JSON Schema definition but their definitions were adjusted to the Swagger Specification
+            items: SchemaItemsVisitor,
+            allOf: SchemaAllOfVisitor,
+            properties: SchemaPropertiesVisitor,
+            additionalProperties: SchemaOrJSONReferenceVisitor,
+            // OpenAPI vocabulary
+            discriminator: {
+              $ref: '#/visitors/value'
+            },
+            xml: {
+              $ref: '#/visitors/document/objects/XML'
+            },
+            externalDocs: {
+              $ref: '#/visitors/document/objects/ExternalDocumentation'
+            },
+            example: {
+              $ref: '#/visitors/value'
+            }
+          }
+        },
+        XML: {
+          $visitor: XmlVisitor,
+          fixedFields: {
+            name: {
+              $ref: '#/visitors/value'
+            },
+            namespace: {
+              $ref: '#/visitors/value'
+            },
+            prefix: {
+              $ref: '#/visitors/value'
+            },
+            attribute: {
+              $ref: '#/visitors/value'
+            },
+            wrapped: {
+              $ref: '#/visitors/value'
+            }
+          }
+        },
+        Definitions: {
+          $visitor: DefinitionsVisitor
+        },
+        ParametersDefinitions: {
+          $visitor: ParametersDefinitionsVisitor
+        },
+        ResponsesDefinitions: {
+          $visitor: ResponsesDefinitionsVisitor
+        },
+        SecurityDefinitions: {
+          $visitor: SecurityDefinitionsVisitor
+        },
+        SecurityScheme: {
+          $visitor: SecuritySchemeVisitor,
+          fixedFields: {
+            type: {
+              $ref: '#/visitors/value'
+            },
+            description: {
+              $ref: '#/visitors/value'
+            },
+            name: {
+              $ref: '#/visitors/value'
+            },
+            in: {
+              $ref: '#/visitors/value'
+            },
+            flow: {
+              $ref: '#/visitors/value'
+            },
+            authorizationUrl: {
+              $ref: '#/visitors/value'
+            },
+            token: {
+              $ref: '#/visitors/value'
+            },
+            scopes: {
+              $ref: '#/visitors/document/objects/Scopes'
+            }
+          }
+        },
+        Scopes: {
+          $visitor: ScopesVisitor
+        },
+        SecurityRequirement: {
+          $visitor: SecurityRequirementVisitor
+        }
+      },
+      extension: {
+        $visitor: SpecificationExtensionVisitor
+      }
+    }
+  }
+};
+export default specification;

package/src/refractor/toolbox.cjs

@@ -0,0 +1,23 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var openApi2Predicates = _interopRequireWildcard(require("../predicates.cjs"));
+var refractorPredicates = _interopRequireWildcard(require("./predicates.cjs"));
+var _namespace = _interopRequireDefault(require("../namespace.cjs"));
+const createToolbox = () => {
+  const namespace = (0, _apidomCore.createNamespace)(_namespace.default);
+  const predicates = {
+    ...refractorPredicates,
+    ...openApi2Predicates,
+    isStringElement: _apidomCore.isStringElement
+  };
+  return {
+    predicates,
+    namespace
+  };
+};
+var _default = exports.default = createToolbox;

package/src/refractor/toolbox.mjs

@@ -0,0 +1,17 @@
+import { createNamespace, isStringElement } from '@speclynx/apidom-core';
+import * as openApi2Predicates from "../predicates.mjs";
+import * as refractorPredicates from "./predicates.mjs";
+import openApi2Namespace from "../namespace.mjs";
+const createToolbox = () => {
+  const namespace = createNamespace(openApi2Namespace);
+  const predicates = {
+    ...refractorPredicates,
+    ...openApi2Predicates,
+    isStringElement
+  };
+  return {
+    predicates,
+    namespace
+  };
+};
+export default createToolbox;

package/src/refractor/visitors/FallbackVisitor.cjs

@@ -0,0 +1,24 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var _Visitor = _interopRequireDefault(require("./Visitor.cjs"));
+/**
+ * This visitor is responsible for falling back to current traversed element
+ * Given OpenApi3_0Visitor expects ObjectElement to be traversed. If
+ * different Element is provided FallBackVisitor is responsible to assigning
+ * this Element as current element.
+ */
+
+/**
+ * @public
+ */
+class FallbackVisitor extends _Visitor.default {
+  enter(element) {
+    this.element = (0, _apidomCore.cloneDeep)(element);
+    return _apidomCore.BREAK;
+  }
+}
+var _default = exports.default = FallbackVisitor;

package/src/refractor/visitors/FallbackVisitor.mjs

@@ -0,0 +1,18 @@
+import { BREAK, cloneDeep } from '@speclynx/apidom-core';
+import Visitor from "./Visitor.mjs";
+/**
+ * This visitor is responsible for falling back to current traversed element
+ * Given OpenApi3_0Visitor expects ObjectElement to be traversed. If
+ * different Element is provided FallBackVisitor is responsible to assigning
+ * this Element as current element.
+ */
+/**
+ * @public
+ */
+class FallbackVisitor extends Visitor {
+  enter(element) {
+    this.element = cloneDeep(element);
+    return BREAK;
+  }
+}
+export default FallbackVisitor;

package/src/refractor/visitors/SpecificationExtensionVisitor.cjs

@@ -0,0 +1,18 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var _SpecificationVisitor = _interopRequireDefault(require("./SpecificationVisitor.cjs"));
+/**
+ * @public
+ */
+class SpecificationExtensionVisitor extends _SpecificationVisitor.default {
+  MemberElement(memberElement) {
+    this.element = (0, _apidomCore.cloneDeep)(memberElement);
+    this.element.classes.push('specification-extension');
+    return _apidomCore.BREAK;
+  }
+}
+var _default = exports.default = SpecificationExtensionVisitor;

package/src/refractor/visitors/SpecificationExtensionVisitor.mjs

@@ -0,0 +1,13 @@
+import { BREAK, cloneDeep } from '@speclynx/apidom-core';
+import SpecificationVisitor from "./SpecificationVisitor.mjs";
+/**
+ * @public
+ */
+class SpecificationExtensionVisitor extends SpecificationVisitor {
+  MemberElement(memberElement) {
+    this.element = cloneDeep(memberElement);
+    this.element.classes.push('specification-extension');
+    return BREAK;
+  }
+}
+export default SpecificationExtensionVisitor;

package/src/refractor/visitors/SpecificationVisitor.cjs

@@ -0,0 +1,74 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _ramda = require("ramda");
+var _ramdaAdjunct = require("ramda-adjunct");
+var _apidomCore = require("@speclynx/apidom-core");
+var _Visitor = _interopRequireDefault(require("./Visitor.cjs"));
+var _FallbackVisitor = _interopRequireDefault(require("./FallbackVisitor.cjs"));
+/**
+ * This is a base Type for every visitor that does
+ * internal look-ups to retrieve other child visitors.
+ * @public
+ */
+
+/**
+ * @public
+ */
+class SpecificationVisitor extends _Visitor.default {
+  specObj;
+  passingOptionsNames = ['specObj'];
+  constructor({
+    specObj,
+    ...rest
+  }) {
+    super({
+      ...rest
+    });
+    this.specObj = specObj;
+  }
+  retrievePassingOptions() {
+    return (0, _ramda.pick)(this.passingOptionsNames, this);
+  }
+  retrieveFixedFields(specPath) {
+    const fixedFields = (0, _ramda.path)(['visitors', ...specPath, 'fixedFields'], this.specObj);
+    if (typeof fixedFields === 'object' && fixedFields !== null) {
+      return Object.keys(fixedFields);
+    }
+    return [];
+  }
+  retrieveVisitor(specPath) {
+    if ((0, _ramda.pathSatisfies)(_ramdaAdjunct.isFunction, ['visitors', ...specPath], this.specObj)) {
+      return (0, _ramda.path)(['visitors', ...specPath], this.specObj);
+    }
+    return (0, _ramda.path)(['visitors', ...specPath, '$visitor'], this.specObj);
+  }
+  retrieveVisitorInstance(specPath, options = {}) {
+    const passingOpts = this.retrievePassingOptions();
+    const VisitorClz = this.retrieveVisitor(specPath);
+    const visitorOpts = {
+      ...passingOpts,
+      ...options
+    };
+    return new VisitorClz(visitorOpts);
+  }
+  toRefractedElement(specPath, element, options = {}) {
+    /**
+     * This is `Visitor shortcut`: mechanism for short circuiting the traversal and replacing
+     * it by basic node cloning.
+     *
+     * Visiting the element is equivalent to cloning it  if the prototype of a visitor
+     * is the same as the prototype of FallbackVisitor. If that's the case, we can avoid
+     * bootstrapping the traversal cycle for fields that don't require any special visiting.
+     */
+    const visitor = this.retrieveVisitorInstance(specPath, options);
+    if (visitor instanceof _FallbackVisitor.default && visitor?.constructor === _FallbackVisitor.default) {
+      return (0, _apidomCore.cloneDeep)(element);
+    }
+    (0, _apidomCore.visit)(element, visitor, options);
+    return visitor.element;
+  }
+}
+var _default = exports.default = SpecificationVisitor;