@speclynx/apidom-ns-json-schema-draft-4 4.0.2 → 4.0.4

package/src/elements/LinkDescription.cjs

@@ -0,0 +1,65 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+/**
+ * URI: https://datatracker.ietf.org/doc/html/draft-wright-json-schema-hyperschema-00#section-5
+ * @public
+ */
+
+class LinkDescription extends _apidomDatamodel.ObjectElement {
+  constructor(content, meta, attributes) {
+    super(content, meta, attributes);
+    this.element = 'linkDescription';
+  }
+  get href() {
+    return this.get('href');
+  }
+  set href(href) {
+    this.set('href', href);
+  }
+  get rel() {
+    return this.get('rel');
+  }
+  set rel(rel) {
+    this.set('rel', rel);
+  }
+  get title() {
+    return this.get('title');
+  }
+  set title(title) {
+    this.set('title', title);
+  }
+  get targetSchema() {
+    return this.get('targetSchema');
+  }
+  set targetSchema(targetSchema) {
+    this.set('targetSchema', targetSchema);
+  }
+  get mediaType() {
+    return this.get('mediaType');
+  }
+  set mediaType(mediaType) {
+    this.set('mediaType', mediaType);
+  }
+  get method() {
+    return this.get('method');
+  }
+  set method(method) {
+    this.set('method', method);
+  }
+  get encType() {
+    return this.get('encType');
+  }
+  set encType(encType) {
+    this.set('encType', encType);
+  }
+  get schema() {
+    return this.get('schema');
+  }
+  set schema(schema) {
+    this.set('schema', schema);
+  }
+}
+var _default = exports.default = LinkDescription;

package/src/elements/LinkDescription.mjs

@@ -0,0 +1,61 @@
+import { ObjectElement } from '@speclynx/apidom-datamodel';
+/**
+ * URI: https://datatracker.ietf.org/doc/html/draft-wright-json-schema-hyperschema-00#section-5
+ * @public
+ */
+
+class LinkDescription extends ObjectElement {
+  constructor(content, meta, attributes) {
+    super(content, meta, attributes);
+    this.element = 'linkDescription';
+  }
+  get href() {
+    return this.get('href');
+  }
+  set href(href) {
+    this.set('href', href);
+  }
+  get rel() {
+    return this.get('rel');
+  }
+  set rel(rel) {
+    this.set('rel', rel);
+  }
+  get title() {
+    return this.get('title');
+  }
+  set title(title) {
+    this.set('title', title);
+  }
+  get targetSchema() {
+    return this.get('targetSchema');
+  }
+  set targetSchema(targetSchema) {
+    this.set('targetSchema', targetSchema);
+  }
+  get mediaType() {
+    return this.get('mediaType');
+  }
+  set mediaType(mediaType) {
+    this.set('mediaType', mediaType);
+  }
+  get method() {
+    return this.get('method');
+  }
+  set method(method) {
+    this.set('method', method);
+  }
+  get encType() {
+    return this.get('encType');
+  }
+  set encType(encType) {
+    this.set('encType', encType);
+  }
+  get schema() {
+    return this.get('schema');
+  }
+  set schema(schema) {
+    this.set('schema', schema);
+  }
+}
+export default LinkDescription;

package/src/elements/Media.cjs

@@ -0,0 +1,29 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+/**
+ * URI: https://datatracker.ietf.org/doc/html/draft-wright-json-schema-hyperschema-00#section-4.3
+ * @public
+ */
+
+class Media extends _apidomDatamodel.ObjectElement {
+  constructor(content, meta, attributes) {
+    super(content, meta, attributes);
+    this.element = 'media';
+  }
+  get binaryEncoding() {
+    return this.get('binaryEncoding');
+  }
+  set binaryEncoding(binaryEncoding) {
+    this.set('binaryEncoding', binaryEncoding);
+  }
+  get type() {
+    return this.get('type');
+  }
+  set type(type) {
+    this.set('type', type);
+  }
+}
+var _default = exports.default = Media;

package/src/elements/Media.mjs

@@ -0,0 +1,25 @@
+import { ObjectElement } from '@speclynx/apidom-datamodel';
+/**
+ * URI: https://datatracker.ietf.org/doc/html/draft-wright-json-schema-hyperschema-00#section-4.3
+ * @public
+ */
+
+class Media extends ObjectElement {
+  constructor(content, meta, attributes) {
+    super(content, meta, attributes);
+    this.element = 'media';
+  }
+  get binaryEncoding() {
+    return this.get('binaryEncoding');
+  }
+  set binaryEncoding(binaryEncoding) {
+    this.set('binaryEncoding', binaryEncoding);
+  }
+  get type() {
+    return this.get('type');
+  }
+  set type(type) {
+    this.set('type', type);
+  }
+}
+export default Media;

package/src/index.cjs

@@ -0,0 +1,69 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+exports.__esModule = true;
+exports.specificationObj = exports.refractorPluginReplaceEmptyElement = exports.refractMedia = exports.refractLinkDescription = exports.refractJSONSchema = exports.refractJSONReference = exports.refract = exports.mediaTypes = exports.isMediaElement = exports.isLinkDescriptionElement = exports.isJSONSchemaElement = exports.isJSONReferenceLikeElement = exports.isJSONReferenceElement = exports.default = exports.Visitor = exports.SpecificationVisitor = exports.PropertiesVisitorBase = exports.PatternedFieldsVisitor = exports.PatternPropertiesVisitorBase = exports.ParentSchemaAwareVisitor = exports.OneOfVisitorBase = exports.MediaVisitorBase = exports.MediaElement = exports.MapVisitor = exports.LinksVisitorBase = exports.LinkDescriptionVisitorBase = exports.LinkDescriptionVisitor = exports.LinkDescriptionElement = exports.JSONSchemaVisitorBase = exports.JSONSchemaVisitor = exports.JSONSchemaElement = exports.JSONSchemaDraft4MediaTypes = exports.JSONReferenceVisitorBase = exports.JSONReferenceElement = exports.ItemsVisitorBase = exports.ItemsVisitor = exports.FixedFieldsVisitor = exports.FallbackVisitor = exports.DependenciesVisitorBase = exports.DefinitionsVisitorBase = exports.AnyOfVisitorBase = exports.AlternatingVisitor = exports.AllOfVisitorBase = void 0;
+var _mediaTypes = _interopRequireWildcard(require("./media-types.cjs"));
+exports.mediaTypes = _mediaTypes.default;
+exports.JSONSchemaDraft4MediaTypes = _mediaTypes.JSONSchemaDraft4MediaTypes;
+var _namespace = _interopRequireDefault(require("./namespace.cjs"));
+exports.default = _namespace.default;
+var _replaceEmptyElement = _interopRequireDefault(require("./refractor/plugins/replace-empty-element.cjs"));
+exports.refractorPluginReplaceEmptyElement = _replaceEmptyElement.default;
+var _index = _interopRequireWildcard(require("./refractor/index.cjs"));
+exports.refract = _index.default;
+exports.refractJSONSchema = _index.refractJSONSchema;
+exports.refractJSONReference = _index.refractJSONReference;
+exports.refractMedia = _index.refractMedia;
+exports.refractLinkDescription = _index.refractLinkDescription;
+var _specification = _interopRequireDefault(require("./refractor/specification.cjs"));
+exports.specificationObj = _specification.default;
+var _predicates = require("./predicates.cjs");
+exports.isJSONReferenceElement = _predicates.isJSONReferenceElement;
+exports.isJSONSchemaElement = _predicates.isJSONSchemaElement;
+exports.isLinkDescriptionElement = _predicates.isLinkDescriptionElement;
+exports.isMediaElement = _predicates.isMediaElement;
+var _predicates2 = require("./refractor/predicates.cjs");
+exports.isJSONReferenceLikeElement = _predicates2.isJSONReferenceLikeElement;
+var _Visitor = _interopRequireDefault(require("./refractor/visitors/Visitor.cjs"));
+exports.Visitor = _Visitor.default;
+var _SpecificationVisitor = _interopRequireDefault(require("./refractor/visitors/SpecificationVisitor.cjs"));
+exports.SpecificationVisitor = _SpecificationVisitor.default;
+var _FallbackVisitor = _interopRequireDefault(require("./refractor/visitors/FallbackVisitor.cjs"));
+exports.FallbackVisitor = _FallbackVisitor.default;
+var _FixedFieldsVisitor = _interopRequireDefault(require("./refractor/visitors/generics/FixedFieldsVisitor.cjs"));
+exports.FixedFieldsVisitor = _FixedFieldsVisitor.default;
+var _PatternedFieldsVisitor = _interopRequireDefault(require("./refractor/visitors/generics/PatternedFieldsVisitor.cjs"));
+exports.PatternedFieldsVisitor = _PatternedFieldsVisitor.default;
+var _MapVisitor = _interopRequireDefault(require("./refractor/visitors/generics/MapVisitor.cjs"));
+exports.MapVisitor = _MapVisitor.default;
+var _AlternatingVisitor = _interopRequireDefault(require("./refractor/visitors/generics/AlternatingVisitor.cjs"));
+exports.AlternatingVisitor = _AlternatingVisitor.default;
+var _ParentSchemaAwareVisitor = _interopRequireDefault(require("./refractor/visitors/json-schema/ParentSchemaAwareVisitor.cjs"));
+exports.ParentSchemaAwareVisitor = _ParentSchemaAwareVisitor.default;
+var _bases = require("./refractor/visitors/json-schema/bases.cjs");
+exports.JSONSchemaVisitorBase = _bases.JSONSchemaVisitorBase;
+exports.JSONReferenceVisitorBase = _bases.JSONReferenceVisitorBase;
+exports.LinkDescriptionVisitorBase = _bases.LinkDescriptionVisitorBase;
+exports.MediaVisitorBase = _bases.MediaVisitorBase;
+exports.AllOfVisitorBase = _bases.AllOfVisitorBase;
+exports.AnyOfVisitorBase = _bases.AnyOfVisitorBase;
+exports.OneOfVisitorBase = _bases.OneOfVisitorBase;
+exports.ItemsVisitorBase = _bases.ItemsVisitorBase;
+exports.LinksVisitorBase = _bases.LinksVisitorBase;
+exports.DefinitionsVisitorBase = _bases.DefinitionsVisitorBase;
+exports.DependenciesVisitorBase = _bases.DependenciesVisitorBase;
+exports.PatternPropertiesVisitorBase = _bases.PatternPropertiesVisitorBase;
+exports.PropertiesVisitorBase = _bases.PropertiesVisitorBase;
+var _index2 = _interopRequireDefault(require("./refractor/visitors/json-schema/link-description/index.cjs"));
+exports.LinkDescriptionVisitor = _index2.default;
+var _index3 = _interopRequireDefault(require("./refractor/visitors/json-schema/index.cjs"));
+exports.JSONSchemaVisitor = _index3.default;
+var _ItemsVisitor = _interopRequireDefault(require("./refractor/visitors/json-schema/ItemsVisitor.cjs"));
+exports.ItemsVisitor = _ItemsVisitor.default;
+var _inspect = require("./refractor/inspect.cjs");
+exports.JSONSchemaElement = _inspect.JSONSchemaElement;
+exports.JSONReferenceElement = _inspect.JSONReferenceElement;
+exports.MediaElement = _inspect.MediaElement;
+exports.LinkDescriptionElement = _inspect.LinkDescriptionElement;

package/src/index.mjs

@@ -0,0 +1,23 @@
+export { default as mediaTypes, JSONSchemaDraft4MediaTypes } from "./media-types.mjs";
+export { default } from "./namespace.mjs";
+export { default as refractorPluginReplaceEmptyElement } from "./refractor/plugins/replace-empty-element.mjs";
+export { default as refract, refractJSONSchema, refractJSONReference, refractMedia, refractLinkDescription } from "./refractor/index.mjs";
+export { default as specificationObj } from "./refractor/specification.mjs";
+export { isJSONReferenceElement, isJSONSchemaElement, isLinkDescriptionElement, isMediaElement } from "./predicates.mjs";
+export { isJSONReferenceLikeElement } from "./refractor/predicates.mjs";
+export { default as Visitor } from "./refractor/visitors/Visitor.mjs";
+export { default as SpecificationVisitor } from "./refractor/visitors/SpecificationVisitor.mjs";
+export { default as FallbackVisitor } from "./refractor/visitors/FallbackVisitor.mjs";
+export { default as FixedFieldsVisitor } from "./refractor/visitors/generics/FixedFieldsVisitor.mjs";
+export { default as PatternedFieldsVisitor } from "./refractor/visitors/generics/PatternedFieldsVisitor.mjs";
+export { default as MapVisitor } from "./refractor/visitors/generics/MapVisitor.mjs";
+export { default as AlternatingVisitor } from "./refractor/visitors/generics/AlternatingVisitor.mjs";
+export { default as ParentSchemaAwareVisitor } from "./refractor/visitors/json-schema/ParentSchemaAwareVisitor.mjs";
+export { JSONSchemaVisitorBase, JSONReferenceVisitorBase, LinkDescriptionVisitorBase, MediaVisitorBase, AllOfVisitorBase, AnyOfVisitorBase, OneOfVisitorBase, ItemsVisitorBase, LinksVisitorBase, DefinitionsVisitorBase, DependenciesVisitorBase, PatternPropertiesVisitorBase, PropertiesVisitorBase } from "./refractor/visitors/json-schema/bases.mjs";
+export { default as LinkDescriptionVisitor } from "./refractor/visitors/json-schema/link-description/index.mjs";
+export { default as JSONSchemaVisitor } from "./refractor/visitors/json-schema/index.mjs";
+export { default as ItemsVisitor } from "./refractor/visitors/json-schema/ItemsVisitor.mjs";
+/**
+ * JSON Schema Draft 4 specification elements.
+ */
+export { JSONSchemaElement, JSONReferenceElement, MediaElement, LinkDescriptionElement } from "./refractor/inspect.mjs";

package/src/media-types.cjs

@@ -0,0 +1,34 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = exports.JSONSchemaDraft4MediaTypes = void 0;
+var _ramda = require("ramda");
+var _apidomCore = require("@speclynx/apidom-core");
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+class JSONSchemaDraft4MediaTypes extends _apidomCore.MediaTypes {
+  filterByFormat(format = 'generic') {
+    const effectiveFormat = format === 'generic' ? 'schema;version' : format;
+    return this.filter(mediaType => mediaType.includes(effectiveFormat));
+  }
+  findBy(version = 'draft-04', format = 'generic') {
+    const search = format === 'generic' ? `schema;version=${version}` : `schema+${format};version=${version}`;
+    const found = this.find(mediaType => mediaType.includes(search));
+    return found || this.unknownMediaType;
+  }
+  latest(format = 'generic') {
+    return (0, _ramda.last)(this.filterByFormat(format));
+  }
+}
+
+/**
+ * @public
+ */
+exports.JSONSchemaDraft4MediaTypes = JSONSchemaDraft4MediaTypes;
+const mediaTypes = new JSONSchemaDraft4MediaTypes('application/schema;version=draft-04', 'application/schema+json;version=draft-04', 'application/schema+yaml;version=draft-04');
+var _default = exports.default = mediaTypes;

package/src/media-types.mjs

@@ -0,0 +1,30 @@
+import { last } from 'ramda';
+import { MediaTypes } from '@speclynx/apidom-core';
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+export class JSONSchemaDraft4MediaTypes extends MediaTypes {
+  filterByFormat(format = 'generic') {
+    const effectiveFormat = format === 'generic' ? 'schema;version' : format;
+    return this.filter(mediaType => mediaType.includes(effectiveFormat));
+  }
+  findBy(version = 'draft-04', format = 'generic') {
+    const search = format === 'generic' ? `schema;version=${version}` : `schema+${format};version=${version}`;
+    const found = this.find(mediaType => mediaType.includes(search));
+    return found || this.unknownMediaType;
+  }
+  latest(format = 'generic') {
+    return last(this.filterByFormat(format));
+  }
+}
+
+/**
+ * @public
+ */
+const mediaTypes = new JSONSchemaDraft4MediaTypes('application/schema;version=draft-04', 'application/schema+json;version=draft-04', 'application/schema+yaml;version=draft-04');
+export default mediaTypes;

package/src/namespace.cjs

@@ -0,0 +1,25 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _JSONSchema = _interopRequireDefault(require("./elements/JSONSchema.cjs"));
+var _JSONReference = _interopRequireDefault(require("./elements/JSONReference.cjs"));
+var _Media = _interopRequireDefault(require("./elements/Media.cjs"));
+var _LinkDescription = _interopRequireDefault(require("./elements/LinkDescription.cjs"));
+/**
+ * @public
+ */
+const jsonSchemaDraft4 = {
+  namespace: options => {
+    const {
+      base
+    } = options;
+    base.register('JSONSchemaDraft4', _JSONSchema.default);
+    base.register('JSONReference', _JSONReference.default);
+    base.register('media', _Media.default);
+    base.register('linkDescription', _LinkDescription.default);
+    return base;
+  }
+};
+var _default = exports.default = jsonSchemaDraft4;

package/src/namespace.mjs

@@ -0,0 +1,20 @@
+import JSONSchemaElement from "./elements/JSONSchema.mjs";
+import JSONReferenceElement from "./elements/JSONReference.mjs";
+import MediaElement from "./elements/Media.mjs";
+import LinkDescriptionElement from "./elements/LinkDescription.mjs";
+/**
+ * @public
+ */
+const jsonSchemaDraft4 = {
+  namespace: options => {
+    const {
+      base
+    } = options;
+    base.register('JSONSchemaDraft4', JSONSchemaElement);
+    base.register('JSONReference', JSONReferenceElement);
+    base.register('media', MediaElement);
+    base.register('linkDescription', LinkDescriptionElement);
+    return base;
+  }
+};
+export default jsonSchemaDraft4;

package/src/predicates.cjs

@@ -0,0 +1,32 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.isMediaElement = exports.isLinkDescriptionElement = exports.isJSONSchemaElement = exports.isJSONReferenceElement = void 0;
+var _JSONSchema = _interopRequireDefault(require("./elements/JSONSchema.cjs"));
+var _JSONReference = _interopRequireDefault(require("./elements/JSONReference.cjs"));
+var _Media = _interopRequireDefault(require("./elements/Media.cjs"));
+var _LinkDescription = _interopRequireDefault(require("./elements/LinkDescription.cjs"));
+/**
+ * @public
+ */
+const isJSONSchemaElement = element => element instanceof _JSONSchema.default;
+
+/**
+ * @public
+ */
+exports.isJSONSchemaElement = isJSONSchemaElement;
+const isJSONReferenceElement = element => element instanceof _JSONReference.default;
+
+/**
+ * @public
+ */
+exports.isJSONReferenceElement = isJSONReferenceElement;
+const isMediaElement = element => element instanceof _Media.default;
+
+/**
+ * @public
+ */
+exports.isMediaElement = isMediaElement;
+const isLinkDescriptionElement = element => element instanceof _LinkDescription.default;
+exports.isLinkDescriptionElement = isLinkDescriptionElement;

package/src/predicates.mjs

@@ -0,0 +1,23 @@
+import JSONSchemaElement from "./elements/JSONSchema.mjs";
+import JSONReferenceElement from "./elements/JSONReference.mjs";
+import MediaElement from "./elements/Media.mjs";
+import LinkDescriptionElement from "./elements/LinkDescription.mjs";
+/**
+ * @public
+ */
+export const isJSONSchemaElement = element => element instanceof JSONSchemaElement;
+
+/**
+ * @public
+ */
+export const isJSONReferenceElement = element => element instanceof JSONReferenceElement;
+
+/**
+ * @public
+ */
+export const isMediaElement = element => element instanceof MediaElement;
+
+/**
+ * @public
+ */
+export const isLinkDescriptionElement = element => element instanceof LinkDescriptionElement;

package/src/refractor/index.cjs

@@ -0,0 +1,96 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.refractMedia = exports.refractLinkDescription = exports.refractJSONSchema = exports.refractJSONReference = exports.default = void 0;
+var _apidomCore = require("@speclynx/apidom-core");
+var _apidomTraverse = require("@speclynx/apidom-traverse");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _ramda = require("ramda");
+var _specification = _interopRequireDefault(require("./specification.cjs"));
+var _toolbox = _interopRequireDefault(require("./toolbox.cjs"));
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+const refract = (value, {
+  element = 'JSONSchemaDraft4',
+  plugins = [],
+  specificationObj = _specification.default,
+  consume = false
+} = {}) => {
+  const genericElement = (0, _apidomDatamodel.refract)(value);
+  const resolvedSpec = (0, _apidomCore.resolveSpecification)(specificationObj);
+  const elementMap = resolvedSpec.elementMap;
+  const specPath = elementMap[element];
+  if (!specPath) {
+    throw new Error(`Unknown element type: "${element}"`);
+  }
+
+  /**
+   * This is where generic ApiDOM becomes semantic (namespace applied).
+   * We don't allow consumers to hook into this translation.
+   * Though we allow consumers to define their own plugins on already transformed ApiDOM.
+   */
+  const RootVisitorClass = (0, _ramda.path)(specPath, resolvedSpec);
+  const rootVisitor = new RootVisitorClass({
+    specObj: resolvedSpec,
+    consume
+  });
+  (0, _apidomTraverse.traverse)(genericElement, rootVisitor);
+
+  /**
+   * Running plugins visitors means extra single traversal === performance hit.
+   */
+  return (0, _apidomCore.dispatchRefractorPlugins)(rootVisitor.element, plugins, {
+    toolboxCreator: _toolbox.default
+  });
+};
+
+/**
+ * Refracts a value into a JSONSchemaElement.
+ * @public
+ */
+const refractJSONSchema = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'JSONSchemaDraft4'
+});
+
+/**
+ * Refracts a value into a JSONReferenceElement.
+ * @public
+ */
+exports.refractJSONSchema = refractJSONSchema;
+const refractJSONReference = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'JSONReference'
+});
+
+/**
+ * Refracts a value into a MediaElement.
+ * @public
+ */
+exports.refractJSONReference = refractJSONReference;
+const refractMedia = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'media'
+});
+
+/**
+ * Refracts a value into a LinkDescriptionElement.
+ * @public
+ */
+exports.refractMedia = refractMedia;
+const refractLinkDescription = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'linkDescription'
+});
+exports.refractLinkDescription = refractLinkDescription;
+var _default = exports.default = refract;

package/src/refractor/index.mjs

@@ -0,0 +1,85 @@
+import { resolveSpecification, dispatchRefractorPlugins } from '@speclynx/apidom-core';
+import { traverse } from '@speclynx/apidom-traverse';
+import { refract as baseRefract } from '@speclynx/apidom-datamodel';
+import { path } from 'ramda';
+import specification from "./specification.mjs";
+import createToolbox from "./toolbox.mjs";
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+/**
+ * @public
+ */
+const refract = (value, {
+  element = 'JSONSchemaDraft4',
+  plugins = [],
+  specificationObj = specification,
+  consume = false
+} = {}) => {
+  const genericElement = baseRefract(value);
+  const resolvedSpec = resolveSpecification(specificationObj);
+  const elementMap = resolvedSpec.elementMap;
+  const specPath = elementMap[element];
+  if (!specPath) {
+    throw new Error(`Unknown element type: "${element}"`);
+  }
+
+  /**
+   * This is where generic ApiDOM becomes semantic (namespace applied).
+   * We don't allow consumers to hook into this translation.
+   * Though we allow consumers to define their own plugins on already transformed ApiDOM.
+   */
+  const RootVisitorClass = path(specPath, resolvedSpec);
+  const rootVisitor = new RootVisitorClass({
+    specObj: resolvedSpec,
+    consume
+  });
+  traverse(genericElement, rootVisitor);
+
+  /**
+   * Running plugins visitors means extra single traversal === performance hit.
+   */
+  return dispatchRefractorPlugins(rootVisitor.element, plugins, {
+    toolboxCreator: createToolbox
+  });
+};
+
+/**
+ * Refracts a value into a JSONSchemaElement.
+ * @public
+ */
+export const refractJSONSchema = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'JSONSchemaDraft4'
+});
+
+/**
+ * Refracts a value into a JSONReferenceElement.
+ * @public
+ */
+export const refractJSONReference = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'JSONReference'
+});
+
+/**
+ * Refracts a value into a MediaElement.
+ * @public
+ */
+export const refractMedia = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'media'
+});
+
+/**
+ * Refracts a value into a LinkDescriptionElement.
+ * @public
+ */
+export const refractLinkDescription = (value, options = {}) => refract(value, {
+  ...options,
+  element: 'linkDescription'
+});
+export default refract;