@redocly/openapi-core 1.0.0-beta.126 → 1.0.0-beta.128

package/lib/bundle.js

@@ -74,13 +74,27 @@ function bundleDocument(opts) {
                     : remove_unused_components_2.RemoveUnusedComponents({}),
             });
         }
-        const resolvedRefMap = yield resolve_1.resolveDocument({
+        let resolvedRefMap = yield resolve_1.resolveDocument({
             rootDocument: document,
             rootType: types.Root,
             externalRefResolver,
         });
+        if (preprocessors.length > 0) {
+            // Make additional pass to resolve refs defined in preprocessors.
+            walk_1.walkDocument({
+                document,
+                rootType: types.Root,
+                normalizedVisitors: visitors_1.normalizeVisitors(preprocessors, types),
+                resolvedRefMap,
+                ctx,
+            });
+            resolvedRefMap = yield resolve_1.resolveDocument({
+                rootDocument: document,
+                rootType: types.Root,
+                externalRefResolver,
+            });
+        }
         const bundleVisitor = visitors_1.normalizeVisitors([
-            ...preprocessors,
             {
                 severity: 'error',
                 ruleId: 'bundler',
@@ -148,6 +162,7 @@ exports.mapTypeToComponent = mapTypeToComponent;
 // function oas3Move
 function makeBundleVisitor(version, dereference, skipRedoclyRegistryRefs, rootDocument, resolvedRefMap, keepUrlRefs) {
     let components;
+    let rootLocation;
     const visitor = {
         ref: {
             leave(node, ctx, resolved) {
@@ -185,7 +200,8 @@ function makeBundleVisitor(version, dereference, skipRedoclyRegistryRefs, rootDo
             },
         },
         Root: {
-            enter(root) {
+            enter(root, ctx) {
+                rootLocation = ctx.location;
                 if (version === oas_types_1.OasMajorVersion.Version3) {
                     components = root.components = root.components || {};
                 }
@@ -253,7 +269,8 @@ function makeBundleVisitor(version, dereference, skipRedoclyRegistryRefs, rootDo
     function isEqualOrEqualRef(node, target, ctx) {
         var _a;
         if (ref_utils_1.isRef(node) &&
-            ((_a = ctx.resolve(node).location) === null || _a === void 0 ? void 0 : _a.absolutePointer) === target.location.absolutePointer) {
+            ((_a = ctx.resolve(node, rootLocation.absolutePointer).location) === null || _a === void 0 ? void 0 : _a.absolutePointer) ===
+                target.location.absolutePointer) {
             return true;
         }
         return isEqual(node, target.node);

package/lib/config/all.js

@@ -48,6 +48,7 @@ exports.default = {
         'no-invalid-schema-examples': 'error',
         'no-invalid-parameter-examples': 'error',
         'scalar-property-missing-example': 'error',
+        'spec-strict-refs': 'error',
     },
     oas3_0Rules: {
         'no-invalid-media-type-examples': 'error',

package/lib/config/config-resolvers.js

@@ -75,6 +75,9 @@ function resolvePlugins(plugins, configPath = '') {
                     : require(absoltePluginPath);
             }
             catch (e) {
+                if (e instanceof SyntaxError) {
+                    throw e;
+                }
                 throw new Error(`Failed to load plugin "${plugin}". Please provide a valid path`);
             }
         }
@@ -253,7 +256,10 @@ function groupStyleguideAssertionRules({ rules, plugins, }) {
     // Collect assertion rules
     const assertions = [];
     for (const [ruleKey, rule] of Object.entries(rules)) {
-        if (ruleKey.startsWith('assert/') && typeof rule === 'object' && rule !== null) {
+        // keep the old assert/ syntax as an alias
+        if ((ruleKey.startsWith('rule/') || ruleKey.startsWith('assert/')) &&
+            typeof rule === 'object' &&
+            rule !== null) {
             const assertion = rule;
             if (plugins) {
                 registerCustomAssertions(plugins, assertion);
@@ -262,7 +268,7 @@ function groupStyleguideAssertionRules({ rules, plugins, }) {
                     registerCustomAssertions(plugins, context);
                 }
             }
-            assertions.push(Object.assign(Object.assign({}, assertion), { assertionId: ruleKey.replace('assert/', '') }));
+            assertions.push(Object.assign(Object.assign({}, assertion), { assertionId: ruleKey.replace(/rule\/|assert\//, '') }));
         }
         else {
             // If it's not an assertion, keep it as is

package/lib/config/minimal.js

@@ -31,6 +31,7 @@ exports.default = {
         'boolean-parameter-prefixes': 'off',
         'paths-kebab-case': 'off',
         spec: 'error',
+        'spec-strict-refs': 'off',
     },
     oas3_0Rules: {
         'no-invalid-media-type-examples': {

package/lib/config/recommended.js

@@ -31,6 +31,7 @@ exports.default = {
         'boolean-parameter-prefixes': 'off',
         'paths-kebab-case': 'off',
         spec: 'error',
+        'spec-strict-refs': 'off',
     },
     oas3_0Rules: {
         'no-invalid-media-type-examples': {

package/lib/config/types.d.ts

@@ -2,7 +2,7 @@ import type { ProblemSeverity, UserContext } from '../walk';
 import type { Oas3PreprocessorsSet, OasMajorVersion, Oas3DecoratorsSet, Oas2RuleSet, Oas2PreprocessorsSet, Oas2DecoratorsSet, Oas3RuleSet, OasVersion } from '../oas-types';
 import type { NodeType } from '../types';
 import { Location } from '../ref-utils';
-import { SkipFunctionContext } from '../visitors';
+import type { SkipFunctionContext } from '../visitors';
 export declare type RuleSeverity = ProblemSeverity | 'off';
 export declare type RuleSettings = {
     severity: RuleSeverity;

package/lib/config/utils.js

@@ -191,12 +191,26 @@ function transformConfig(rawConfig) {
     }
     const { apis, apiDefinitions, referenceDocs, lint } = rawConfig, rest = __rest(rawConfig, ["apis", "apiDefinitions", "referenceDocs", "lint"]);
     const { styleguideConfig, rawConfigRest } = extractFlatConfig(rest);
-    return Object.assign({ theme: {
+    const transformedConfig = Object.assign({ theme: {
             openapi: Object.assign(Object.assign(Object.assign({}, referenceDocs), rawConfig['features.openapi']), (_a = rawConfig.theme) === null || _a === void 0 ? void 0 : _a.openapi),
             mockServer: Object.assign(Object.assign({}, rawConfig['features.mockServer']), (_b = rawConfig.theme) === null || _b === void 0 ? void 0 : _b.mockServer),
         }, apis: transformApis(apis) || transformApiDefinitionsToApis(apiDefinitions), styleguide: styleguideConfig || lint }, rawConfigRest);
+    showDeprecationMessages(transformedConfig);
+    return transformedConfig;
 }
 exports.transformConfig = transformConfig;
+function showDeprecationMessages(config) {
+    var _a, _b;
+    let allRules = Object.assign({}, (_a = config.styleguide) === null || _a === void 0 ? void 0 : _a.rules);
+    for (const api of Object.values(config.apis || {})) {
+        allRules = Object.assign(Object.assign({}, allRules), (_b = api === null || api === void 0 ? void 0 : api.styleguide) === null || _b === void 0 ? void 0 : _b.rules);
+    }
+    for (const ruleKey of Object.keys(allRules)) {
+        if (ruleKey.startsWith('assert/')) {
+            logger_1.logger.warn(`\nThe 'assert/' syntax in ${ruleKey} is deprecated. Update your configuration to use 'rule/' instead. Examples and more information: https://redocly.com/docs/cli/rules/configurable-rules/\n`);
+        }
+    }
+}
 function getResolveConfig(resolve) {
     var _a, _b;
     return {

package/lib/lint.js

@@ -57,12 +57,27 @@ function lintDocument(opts) {
         };
         const preprocessors = config_1.initRules(rules, config, 'preprocessors', oasVersion);
         const regularRules = config_1.initRules(rules, config, 'rules', oasVersion);
-        const normalizedVisitors = visitors_1.normalizeVisitors([...preprocessors, ...regularRules], types);
-        const resolvedRefMap = yield resolve_1.resolveDocument({
+        let resolvedRefMap = yield resolve_1.resolveDocument({
             rootDocument: document,
             rootType: types.Root,
             externalRefResolver,
         });
+        if (preprocessors.length > 0) {
+            // Make additional pass to resolve refs defined in preprocessors.
+            walk_1.walkDocument({
+                document,
+                rootType: types.Root,
+                normalizedVisitors: visitors_1.normalizeVisitors(preprocessors, types),
+                resolvedRefMap,
+                ctx,
+            });
+            resolvedRefMap = yield resolve_1.resolveDocument({
+                rootDocument: document,
+                rootType: types.Root,
+                externalRefResolver,
+            });
+        }
+        const normalizedVisitors = visitors_1.normalizeVisitors(regularRules, types);
         walk_1.walkDocument({
             document,
             rootType: types.Root,

package/lib/rules/common/spec-strict-refs.d.ts

@@ -0,0 +1,2 @@
+import { Oas2Rule, Oas3Rule } from '../../visitors';
+export declare const SpecStrictRefs: Oas3Rule | Oas2Rule;

package/lib/rules/common/spec-strict-refs.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecStrictRefs = void 0;
+const ref_utils_1 = require("../../ref-utils");
+const SpecStrictRefs = () => {
+    const nodesToSkip = [
+        'Schema',
+        'Response',
+        'Parameter',
+        'RequestBody',
+        'Example',
+        'Header',
+        'SecurityScheme',
+        'Link',
+        'Callback',
+        'PathItem',
+    ];
+    return {
+        any(_node, { report, rawNode, rawLocation, type }) {
+            const shouldCheck = !nodesToSkip.includes(type.name);
+            if (shouldCheck && ref_utils_1.isRef(rawNode)) {
+                report({
+                    message: 'Field $ref is not expected here.',
+                    location: rawLocation.child('$ref').key(),
+                });
+            }
+        },
+    };
+};
+exports.SpecStrictRefs = SpecStrictRefs;

package/lib/rules/common/spec.js

@@ -122,6 +122,7 @@ const OasSpec = () => {
                         from: refLocation,
                         location: propLocation,
                     });
+                    ignoreNextVisitorsOnNode();
                 }
                 else if (propValueType === 'array' && ((_e = propSchema.items) === null || _e === void 0 ? void 0 : _e.type)) {
                     const itemsType = (_f = propSchema.items) === null || _f === void 0 ? void 0 : _f.type;

package/lib/rules/oas2/index.d.ts

@@ -42,5 +42,6 @@ export declare const rules: {
     'response-contains-property': Oas2Rule;
     'scalar-property-missing-example': import("../../visitors").Oas3Rule | Oas2Rule;
     'required-string-property-missing-min-length': import("../../visitors").Oas3Rule;
+    'spec-strict-refs': import("../../visitors").Oas3Rule | Oas2Rule;
 };
 export declare const preprocessors: {};

package/lib/rules/oas2/index.js

@@ -42,6 +42,7 @@ const response_contains_header_1 = require("../common/response-contains-header")
 const response_contains_property_1 = require("./response-contains-property");
 const scalar_property_missing_example_1 = require("../common/scalar-property-missing-example");
 const required_string_property_missing_min_length_1 = require("../common/required-string-property-missing-min-length");
+const spec_strict_refs_1 = require("../common/spec-strict-refs");
 exports.rules = {
     spec: spec_1.OasSpec,
     'no-invalid-schema-examples': no_invalid_schema_examples_1.NoInvalidSchemaExamples,
@@ -85,5 +86,6 @@ exports.rules = {
     'response-contains-property': response_contains_property_1.ResponseContainsProperty,
     'scalar-property-missing-example': scalar_property_missing_example_1.ScalarPropertyMissingExample,
     'required-string-property-missing-min-length': required_string_property_missing_min_length_1.RequiredStringPropertyMissingMinLength,
+    'spec-strict-refs': spec_strict_refs_1.SpecStrictRefs,
 };
 exports.preprocessors = {};

package/lib/rules/oas2/request-mime-type.d.ts

@@ -1,2 +1,2 @@
-import { Oas2Rule } from '../../visitors';
+import type { Oas2Rule } from '../../visitors';
 export declare const RequestMimeType: Oas2Rule;

package/lib/rules/oas2/response-mime-type.d.ts

@@ -1,2 +1,2 @@
-import { Oas2Rule } from '../../visitors';
+import type { Oas2Rule } from '../../visitors';
 export declare const ResponseMimeType: Oas2Rule;

package/lib/rules/oas3/index.js

@@ -52,6 +52,7 @@ const scalar_property_missing_example_1 = require("../common/scalar-property-mis
 const spec_components_invalid_map_name_1 = require("./spec-components-invalid-map-name");
 const operation_4xx_problem_details_rfc7807_1 = require("./operation-4xx-problem-details-rfc7807");
 const required_string_property_missing_min_length_1 = require("../common/required-string-property-missing-min-length");
+const spec_strict_refs_1 = require("../common/spec-strict-refs");
 exports.rules = {
     spec: spec_1.OasSpec,
     'info-contact': info_contact_1.InfoContact,
@@ -105,5 +106,6 @@ exports.rules = {
     'scalar-property-missing-example': scalar_property_missing_example_1.ScalarPropertyMissingExample,
     'spec-components-invalid-map-name': spec_components_invalid_map_name_1.SpecComponentsInvalidMapName,
     'required-string-property-missing-min-length': required_string_property_missing_min_length_1.RequiredStringPropertyMissingMinLength,
+    'spec-strict-refs': spec_strict_refs_1.SpecStrictRefs,
 };
 exports.preprocessors = {};

package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.d.ts

@@ -1,5 +1,5 @@
-import { Oas3Rule } from '../../visitors';
+import type { Oas3Rule } from '../../visitors';
 /**
- * Validation according rfc7807 - https://datatracker.ietf.org/doc/html/rfc7807
+ * Validation according to rfc7807 - https://datatracker.ietf.org/doc/html/rfc7807
  */
 export declare const Operation4xxProblemDetailsRfc7807: Oas3Rule;

package/lib/rules/oas3/operation-4xx-problem-details-rfc7807.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Operation4xxProblemDetailsRfc7807 = void 0;
 const utils_1 = require("../utils");
 /**
- * Validation according rfc7807 - https://datatracker.ietf.org/doc/html/rfc7807
+ * Validation according to rfc7807 - https://datatracker.ietf.org/doc/html/rfc7807
  */
 const Operation4xxProblemDetailsRfc7807 = () => {
     return {
         Response: {
-            skip(_response, key) {
+            skip(_, key) {
                 return !/4[Xx0-9]{2}/.test(`${key}`);
             },
             enter(response, { report, location }) {
@@ -19,7 +19,7 @@ const Operation4xxProblemDetailsRfc7807 = () => {
                     });
             },
             MediaType: {
-                skip(_response, key) {
+                skip(_, key) {
                     return key !== 'application/problem+json';
                 },
                 enter(media, ctx) {

package/lib/rules/oas3/request-mime-type.d.ts

@@ -1,2 +1,2 @@
-import { Oas3Rule } from '../../visitors';
+import type { Oas3Rule } from '../../visitors';
 export declare const RequestMimeType: Oas3Rule;

package/lib/rules/oas3/response-mime-type.d.ts

@@ -1,2 +1,2 @@
-import { Oas3Rule } from '../../visitors';
+import type { Oas3Rule } from '../../visitors';
 export declare const ResponseMimeType: Oas3Rule;

package/lib/rules/oas3/spec-components-invalid-map-name.js

@@ -57,11 +57,6 @@ const SpecComponentsInvalidMapName = () => {
                 validateKey(key, report, location, 'callbacks');
             },
         },
-        ExampleMap: {
-            Example(_node, { key, report, location }) {
-                validateKey(key, report, location, 'examples');
-            },
-        },
     };
 };
 exports.SpecComponentsInvalidMapName = SpecComponentsInvalidMapName;

package/lib/types/redocly-yaml.js

@@ -56,6 +56,7 @@ const builtInRulesList = [
     'scalar-property-missing-example',
     'spec-components-invalid-map-name',
     'required-string-property-missing-min-length',
+    'spec-strict-refs',
 ];
 const nodeTypesList = [
     'any',
@@ -196,7 +197,11 @@ const ConfigRootTheme = {
 const Rules = {
     properties: {},
     additionalProperties: (value, key) => {
-        if (key.startsWith('assert/')) {
+        if (key.startsWith('rule/')) {
+            return 'Assert';
+        }
+        else if (key.startsWith('assert/')) {
+            // keep the old assert/ prefix as an alias
             return 'Assert';
         }
         else if (builtInRulesList.includes(key) || utils_1.isCustomRuleId(key)) {

package/lib/walk.d.ts

@@ -1,10 +1,11 @@
-import { Referenced } from './typings/openapi';
+import type { Referenced } from './typings/openapi';
+import type { NormalizedOasVisitors } from './visitors';
+import type { ResolvedRefMap, Document } from './resolve';
+import type { NormalizedNodeType } from './types';
+import type { RuleSeverity } from './config';
 import { Location } from './ref-utils';
-import { NormalizedOasVisitors } from './visitors';
-import { ResolvedRefMap, Document, ResolveError, YamlParseError, Source } from './resolve';
+import { ResolveError, YamlParseError, Source } from './resolve';
 import { OasVersion } from './oas-types';
-import { NormalizedNodeType } from './types';
-import type { RuleSeverity } from './config';
 declare type NonUndefined = string | number | boolean | symbol | bigint | object | Record<string, any>;
 export declare type ResolveResult<T extends NonUndefined> = {
     node: T;

package/lib/walk.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.walkDocument = void 0;
 const ref_utils_1 = require("./ref-utils");
-const resolve_1 = require("./resolve");
 const utils_1 = require("./utils");
+const resolve_1 = require("./resolve");
 const types_1 = require("./types");
 function collectParents(ctx) {
     var _a;
@@ -28,7 +28,7 @@ function collectParentsLocations(ctx) {
 function walkDocument(opts) {
     const { document, rootType, normalizedVisitors, resolvedRefMap, ctx } = opts;
     const seenNodesPerType = {};
-    const seenRefs = new Set();
+    const ignoredNodes = new Set();
     walkNode(document.parsed, rootType, new ref_utils_1.Location(document.source, '#/'), undefined, '');
     function walkNode(node, type, location, parent, key) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
@@ -58,25 +58,23 @@ function walkDocument(opts) {
         if (ref_utils_1.isRef(node)) {
             const refEnterVisitors = normalizedVisitors.ref.enter;
             for (const { visit: visitor, ruleId, severity, context } of refEnterVisitors) {
-                if (!seenRefs.has(node)) {
-                    enteredContexts.add(context);
-                    const report = reportFn.bind(undefined, ruleId, severity);
-                    visitor(node, {
-                        report,
-                        resolve,
-                        rawNode: node,
-                        rawLocation,
-                        location,
-                        type,
-                        parent,
-                        key,
-                        parentLocations: {},
-                        oasVersion: ctx.oasVersion,
-                        getVisitorData: getVisitorDataFn.bind(undefined, ruleId),
-                    }, { node: resolvedNode, location: resolvedLocation, error });
-                    if ((resolvedLocation === null || resolvedLocation === void 0 ? void 0 : resolvedLocation.source.absoluteRef) && ctx.refTypes) {
-                        ctx.refTypes.set(resolvedLocation === null || resolvedLocation === void 0 ? void 0 : resolvedLocation.source.absoluteRef, type);
-                    }
+                enteredContexts.add(context);
+                const report = reportFn.bind(undefined, ruleId, severity);
+                visitor(node, {
+                    report,
+                    resolve,
+                    rawNode: node,
+                    rawLocation,
+                    location,
+                    type,
+                    parent,
+                    key,
+                    parentLocations: {},
+                    oasVersion: ctx.oasVersion,
+                    getVisitorData: getVisitorDataFn.bind(undefined, ruleId),
+                }, { node: resolvedNode, location: resolvedLocation, error });
+                if ((resolvedLocation === null || resolvedLocation === void 0 ? void 0 : resolvedLocation.source.absoluteRef) && ctx.refTypes) {
+                    ctx.refTypes.set(resolvedLocation === null || resolvedLocation === void 0 ? void 0 : resolvedLocation.source.absoluteRef, type);
                 }
             }
         }
@@ -88,6 +86,8 @@ function walkDocument(opts) {
             const currentEnterVisitors = anyEnterVisitors.concat(((_c = normalizedVisitors[type.name]) === null || _c === void 0 ? void 0 : _c.enter) || []);
             const activatedContexts = [];
             for (const { context, visit, skip, ruleId, severity } of currentEnterVisitors) {
+                if (ignoredNodes.has(currentLocation.pointer))
+                    break;
                 if (context.isSkippedLevel) {
                     if (context.parent.activatedOn &&
                         !context.parent.activatedOn.value.nextLevelTypeActivated &&
@@ -129,9 +129,7 @@ function walkDocument(opts) {
                         if (!activatedOn.skipped) {
                             visitedBySome = true;
                             enteredContexts.add(context);
-                            const { ignoreNextVisitorsOnNode } = visitWithContext(visit, resolvedNode, node, context, ruleId, severity);
-                            if (ignoreNextVisitorsOnNode)
-                                break;
+                            visitWithContext(visit, resolvedNode, node, context, ruleId, severity);
                         }
                     }
                 }
@@ -238,7 +236,6 @@ function walkDocument(opts) {
         // returns true ignores all the next visitors on the specific node
         function visitWithContext(visit, resolvedNode, node, context, ruleId, severity) {
             const report = reportFn.bind(undefined, ruleId, severity);
-            let ignoreNextVisitorsOnNode = false;
             visit(resolvedNode, {
                 report,
                 resolve,
@@ -251,23 +248,21 @@ function walkDocument(opts) {
                 parentLocations: collectParentsLocations(context),
                 oasVersion: ctx.oasVersion,
                 ignoreNextVisitorsOnNode: () => {
-                    ignoreNextVisitorsOnNode = true;
+                    ignoredNodes.add(currentLocation.pointer);
                 },
                 getVisitorData: getVisitorDataFn.bind(undefined, ruleId),
             }, collectParents(context), context);
-            return { ignoreNextVisitorsOnNode };
         }
         function reportFn(ruleId, severity, opts) {
-            const loc = opts.location
+            const normalizedLocation = opts.location
                 ? Array.isArray(opts.location)
                     ? opts.location
                     : [opts.location]
                 : [Object.assign(Object.assign({}, currentLocation), { reportOnKey: false })];
+            const location = normalizedLocation.map((l) => (Object.assign(Object.assign(Object.assign({}, currentLocation), { reportOnKey: false }), l)));
             const ruleSeverity = opts.forceSeverity || severity;
             if (ruleSeverity !== 'off') {
-                ctx.problems.push(Object.assign(Object.assign({ ruleId: opts.ruleId || ruleId, severity: ruleSeverity }, opts), { suggest: opts.suggest || [], location: loc.map((loc) => {
-                        return Object.assign(Object.assign(Object.assign({}, currentLocation), { reportOnKey: false }), loc);
-                    }) }));
+                ctx.problems.push(Object.assign(Object.assign({ ruleId: opts.ruleId || ruleId, severity: ruleSeverity }, opts), { suggest: opts.suggest || [], location }));
             }
         }
         function getVisitorDataFn(ruleId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/openapi-core",
-  "version": "1.0.0-beta.126",
+  "version": "1.0.0-beta.128",
   "description": "",
   "main": "lib/index.js",
   "engines": {

package/__tests__/utils.ts

@@ -1,88 +0,0 @@
-import * as path from 'path';
-
-import { Document, Source, NormalizedProblem, parseYaml, stringifyYaml } from '../src';
-import { StyleguideConfig, resolveStyleguideConfig, resolvePlugins } from '../src/config';
-import { Oas3RuleSet } from '../src/oas-types';
-
-import type { RuleConfig, Plugin, DecoratorConfig } from '../src/config';
-
-export function parseYamlToDocument(body: string, absoluteRef: string = ''): Document {
-  return {
-    source: new Source(absoluteRef, body),
-    parsed: parseYaml(body, { filename: absoluteRef }),
-  };
-}
-
-export function replaceSourceWithRef(results: NormalizedProblem[], cwd?: string) {
-  const cwdRegexp = cwd ? new RegExp(cwd + path.sep, 'g') : /$^/;
-  return results.map((r) => {
-    const mapped = {
-      ...r,
-      message: r.message.replace(cwdRegexp, ''),
-      location: r.location.map((l) => ({
-        ...l,
-        source: cwd ? path.relative(cwd, l.source.absoluteRef) : l.source.absoluteRef,
-      })),
-    };
-    if (mapped.from) {
-      mapped.from = {
-        ...mapped.from,
-        source: cwd
-          ? path.relative(cwd, mapped.from.source.absoluteRef)
-          : (mapped.from.source.absoluteRef as any),
-      };
-    }
-    return mapped;
-  });
-}
-
-export const yamlSerializer = {
-  test: () => {
-    return true;
-  },
-  print: (val: any) => {
-    return stringifyYaml(val);
-  },
-};
-
-export function makeConfigForRuleset(
-  rules: Oas3RuleSet,
-  plugin?: Partial<Plugin>,
-  version: string = 'oas3'
-) {
-  const rulesConf: Record<string, RuleConfig> = {};
-  const ruleId = 'test';
-  Object.keys(rules).forEach((name) => {
-    rulesConf[`${ruleId}/${name}`] = 'error';
-  });
-  const plugins = resolvePlugins([
-    {
-      ...plugin,
-      id: ruleId,
-      rules: { [version]: rules },
-    },
-  ]);
-
-  return new StyleguideConfig({
-    plugins,
-    rules: rulesConf,
-  });
-}
-
-export async function makeConfig(
-  rules: Record<string, RuleConfig>,
-  decorators?: Record<string, DecoratorConfig>,
-  configPath?: string
-) {
-  return new StyleguideConfig(
-    await resolveStyleguideConfig({
-      styleguideConfig: {
-        plugins: [],
-        extends: [],
-        rules,
-        decorators,
-      },
-    }),
-    configPath
-  );
-}