@redocly/openapi-core 1.0.0-beta.105 → 1.0.0-beta.106

package/README.md

@@ -9,9 +9,9 @@ See https://github.com/Redocly/redocly-cli
 ```js
 import { formatProblems, lint, loadConfig } from '@redocly/openapi-core';
 
-const pathToEntryPoint = 'openapi.yaml';
+const pathToApi = 'openapi.yaml';
 const config = loadConfig('optional/path/to/.redocly.yaml');
-const lintResults = await lint({ ref: pathToEntryPoint, config });
+const lintResults = await lint({ ref: pathToApi, config });
 ```
 
 ### Bundle
@@ -19,7 +19,7 @@ const lintResults = await lint({ ref: pathToEntryPoint, config });
 ```js
 import { formatProblems, bundle, loadConfig } from '@redocly/openapi-core';
 
-const pathToEntryPoint = 'openapi.yaml';
+const pathToApi = 'openapi.yaml';
 const config = loadConfig('optional/path/to/.redocly.yaml');
-const { bundle, problems } = await bundle({ ref: pathToEntryPoint, config });
+const { bundle, problems } = await bundle({ ref: pathToApi, config });
 ```

package/__tests__/utils.ts

@@ -1,7 +1,7 @@
 import * as path from 'path';
 
 import { Document, Source, NormalizedProblem, parseYaml, stringifyYaml } from '../src';
-import { LintConfig, resolveLint, resolvePlugins } from '../src/config';
+import { StyleguideConfig, resolveStyleguideConfig, resolvePlugins } from '../src/config';
 import { Oas3RuleSet } from '../src/oas-types';
 
 import type { RuleConfig, Plugin, DecoratorConfig } from '../src/config';
@@ -63,7 +63,7 @@ export function makeConfigForRuleset(
     },
   ]);
 
-  return new LintConfig({
+  return new StyleguideConfig({
     plugins,
     rules: rulesConf,
   });
@@ -74,9 +74,9 @@ export async function makeConfig(
   decorators?: Record<string, DecoratorConfig>,
   configPath?: string
 ) {
-  return new LintConfig(
-    await resolveLint({
-      lintConfig: {
+  return new StyleguideConfig(
+    await resolveStyleguideConfig({
+      styleguideConfig: {
         plugins: [],
         extends: [],
         rules,

package/lib/benchmark/benches/recommended-oas3.bench.js

@@ -15,7 +15,7 @@ function measureAsync() {
     return lint_1.lintDocument({
         externalRefResolver: new resolve_1.BaseResolver(),
         document: rebillyDocument,
-        config: new config_1.LintConfig(config_1.resolvePreset('recommended', [config_1.defaultPlugin])),
+        config: new config_1.StyleguideConfig(config_1.resolvePreset('recommended', [config_1.defaultPlugin])),
     });
 }
 exports.measureAsync = measureAsync;

package/lib/benchmark/utils.d.ts

@@ -1,6 +1,6 @@
 import { Document } from '../resolve';
 import { Oas3RuleSet } from '../oas-types';
-import { LintConfig } from '../config';
+import { StyleguideConfig } from '../config';
 import type { Plugin } from '../config/types';
 export declare function parseYamlToDocument(body: string, absoluteRef?: string): Document;
-export declare function makeConfigForRuleset(rules: Oas3RuleSet, plugin?: Partial<Plugin>): LintConfig;
+export declare function makeConfigForRuleset(rules: Oas3RuleSet, plugin?: Partial<Plugin>): StyleguideConfig;

package/lib/benchmark/utils.js

@@ -25,7 +25,7 @@ function makeConfigForRuleset(rules, plugin) {
     if (rules) {
         extendConfigs.push({ rules });
     }
-    const lint = config_1.mergeExtends(extendConfigs);
-    return new config_1.LintConfig(lint);
+    const styleguide = config_1.mergeExtends(extendConfigs);
+    return new config_1.StyleguideConfig(styleguide);
 }
 exports.makeConfigForRuleset = makeConfigForRuleset;

package/lib/bundle.d.ts

@@ -2,7 +2,7 @@ import { BaseResolver, Document } from './resolve';
 import { Oas3Rule } from './visitors';
 import { NormalizedNodeType, NodeType } from './types';
 import { OasMajorVersion } from './oas-types';
-import type { Config, LintConfig } from './config';
+import type { Config, StyleguideConfig } from './config';
 export declare type Oas3RuleSet = Record<string, Oas3Rule>;
 export declare enum OasVersion {
     Version2 = "oas2",
@@ -29,7 +29,7 @@ export declare function bundle(opts: {
 }>;
 export declare function bundleDocument(opts: {
     document: Document;
-    config: LintConfig;
+    config: StyleguideConfig;
     customTypes?: Record<string, NodeType>;
     externalRefResolver: BaseResolver;
     dereference?: boolean;

package/lib/bundle.js

@@ -42,7 +42,7 @@ function bundle(opts) {
         if (document instanceof Error) {
             throw document;
         }
-        return bundleDocument(Object.assign(Object.assign({ document }, opts), { config: opts.config.lint, externalRefResolver }));
+        return bundleDocument(Object.assign(Object.assign({ document }, opts), { config: opts.config.styleguide, externalRefResolver }));
     });
 }
 exports.bundle = bundle;
@@ -71,7 +71,7 @@ function bundleDocument(opts) {
                 ruleId: 'remove-unused-components',
                 visitor: oasMajorVersion === oas_types_1.OasMajorVersion.Version2
                     ? remove_unused_components_1.RemoveUnusedComponents({})
-                    : remove_unused_components_2.RemoveUnusedComponents({})
+                    : remove_unused_components_2.RemoveUnusedComponents({}),
             });
         }
         const resolvedRefMap = yield resolve_1.resolveDocument({

package/lib/config/all.d.ts

@@ -1,3 +1,3 @@
-import type { PluginLintConfig } from "./types";
-declare const _default: PluginLintConfig;
+import type { PluginStyleguideConfig } from './types';
+declare const _default: PluginStyleguideConfig;
 export default _default;

package/lib/config/all.js

@@ -19,7 +19,7 @@ exports.default = {
         'operation-description': 'error',
         'operation-2xx-response': 'error',
         'operation-4xx-response': 'error',
-        'assertions': 'error',
+        assertions: 'error',
         'operation-operationId': 'error',
         'operation-summary': 'error',
         'operation-operationId-unique': 'error',

package/lib/config/builtIn.d.ts

@@ -1,3 +1,3 @@
-import type { LintRawConfig, Plugin } from './types';
-export declare const builtInConfigs: Record<string, LintRawConfig>;
+import type { StyleguideRawConfig, Plugin } from './types';
+export declare const builtInConfigs: Record<string, StyleguideRawConfig>;
 export declare const defaultPlugin: Plugin;

package/lib/config/builtIn.js

@@ -15,8 +15,8 @@ exports.builtInConfigs = {
     minimal: minimal_1.default,
     all: all_1.default,
     'redocly-registry': {
-        decorators: { 'registry-dependencies': 'on' }
-    }
+        decorators: { 'registry-dependencies': 'on' },
+    },
 };
 exports.defaultPlugin = {
     id: '',

package/lib/config/config-resolvers.d.ts

@@ -1,5 +1,5 @@
 import { BaseResolver } from '../resolve';
-import type { LintRawConfig, Plugin, RawConfig, ResolvedApi, ResolvedLintConfig } from './types';
+import type { StyleguideRawConfig, Plugin, RawConfig, ResolvedApi, ResolvedStyleguideConfig } from './types';
 import { Config } from './config';
 export declare function resolveConfig(rawConfig: RawConfig, configPath?: string): Promise<Config>;
 export declare function resolvePlugins(plugins: (string | Plugin)[] | null, configPath?: string): Plugin[];
@@ -8,9 +8,9 @@ export declare function resolveApis({ rawConfig, configPath, resolver, }: {
     configPath?: string;
     resolver?: BaseResolver;
 }): Promise<Record<string, ResolvedApi>>;
-export declare function resolveLint(lintOpts: {
-    lintConfig?: LintRawConfig;
+export declare function resolveStyleguideConfig(opts: {
+    styleguideConfig?: StyleguideRawConfig;
     configPath?: string;
     resolver?: BaseResolver;
-}, parentConfigPaths?: string[], extendPaths?: string[]): Promise<ResolvedLintConfig>;
-export declare function resolvePreset(presetName: string, plugins: Plugin[]): ResolvedLintConfig;
+}, parentConfigPaths?: string[], extendPaths?: string[]): Promise<ResolvedStyleguideConfig>;
+export declare function resolvePreset(presetName: string, plugins: Plugin[]): ResolvedStyleguideConfig;

package/lib/config/config-resolvers.js

@@ -20,7 +20,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolvePreset = exports.resolveLint = exports.resolveApis = exports.resolvePlugins = exports.resolveConfig = void 0;
+exports.resolvePreset = exports.resolveStyleguideConfig = exports.resolveApis = exports.resolvePlugins = exports.resolveConfig = void 0;
 const path = require("path");
 const colorette_1 = require("colorette");
 const ref_utils_1 = require("../ref-utils");
@@ -32,25 +32,25 @@ const config_1 = require("./config");
 function resolveConfig(rawConfig, configPath) {
     var _a, _b, _c, _d, _e;
     return __awaiter(this, void 0, void 0, function* () {
-        if ((_b = (_a = rawConfig.lint) === null || _a === void 0 ? void 0 : _a.extends) === null || _b === void 0 ? void 0 : _b.some(utils_2.isNotString)) {
+        if ((_b = (_a = rawConfig.styleguide) === null || _a === void 0 ? void 0 : _a.extends) === null || _b === void 0 ? void 0 : _b.some(utils_2.isNotString)) {
             throw new Error(`Error configuration format not detected in extends value must contain strings`);
         }
         const resolver = new resolve_1.BaseResolver(utils_1.getResolveConfig(rawConfig.resolve));
-        const configExtends = (_d = (_c = rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.lint) === null || _c === void 0 ? void 0 : _c.extends) !== null && _d !== void 0 ? _d : ['recommended'];
-        const recommendedFallback = !((_e = rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.lint) === null || _e === void 0 ? void 0 : _e.extends);
-        const lintConfig = Object.assign(Object.assign({}, rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.lint), { extends: configExtends, recommendedFallback });
+        const configExtends = (_d = (_c = rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.styleguide) === null || _c === void 0 ? void 0 : _c.extends) !== null && _d !== void 0 ? _d : ['recommended'];
+        const recommendedFallback = !((_e = rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.styleguide) === null || _e === void 0 ? void 0 : _e.extends);
+        const styleguideConfig = Object.assign(Object.assign({}, rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.styleguide), { extends: configExtends, recommendedFallback });
         const apis = yield resolveApis({
-            rawConfig: Object.assign(Object.assign({}, rawConfig), { lint: lintConfig }),
+            rawConfig: Object.assign(Object.assign({}, rawConfig), { styleguide: styleguideConfig }),
             configPath,
             resolver,
         });
-        const lint = yield resolveLint({
-            lintConfig,
+        const styleguide = yield resolveStyleguideConfig({
+            styleguideConfig,
             configPath,
             resolver,
         });
         return new config_1.Config(Object.assign(Object.assign({}, rawConfig), { apis,
-            lint }), configPath);
+            styleguide }), configPath);
     });
 }
 exports.resolveConfig = resolveConfig;
@@ -123,36 +123,36 @@ exports.resolvePlugins = resolvePlugins;
 function resolveApis({ rawConfig, configPath = '', resolver, }) {
     var _a, _b;
     return __awaiter(this, void 0, void 0, function* () {
-        const { apis = {}, lint: lintConfig = {} } = rawConfig;
+        const { apis = {}, styleguide: styleguideConfig = {} } = rawConfig;
         let resolvedApis = {};
         for (const [apiName, apiContent] of Object.entries(apis || {})) {
-            if ((_b = (_a = apiContent.lint) === null || _a === void 0 ? void 0 : _a.extends) === null || _b === void 0 ? void 0 : _b.some(utils_2.isNotString)) {
+            if ((_b = (_a = apiContent.styleguide) === null || _a === void 0 ? void 0 : _a.extends) === null || _b === void 0 ? void 0 : _b.some(utils_2.isNotString)) {
                 throw new Error(`Error configuration format not detected in extends value must contain strings`);
             }
-            const rawLintConfig = getMergedLintRawConfig(lintConfig, apiContent.lint);
-            const apiLint = yield resolveLint({
-                lintConfig: rawLintConfig,
+            const rawStyleguideConfig = getMergedRawStyleguideConfig(styleguideConfig, apiContent.styleguide);
+            const resolvedApiConfig = yield resolveStyleguideConfig({
+                styleguideConfig: rawStyleguideConfig,
                 configPath,
                 resolver,
             });
-            resolvedApis[apiName] = Object.assign(Object.assign({}, apiContent), { lint: apiLint });
+            resolvedApis[apiName] = Object.assign(Object.assign({}, apiContent), { styleguide: resolvedApiConfig });
         }
         return resolvedApis;
     });
 }
 exports.resolveApis = resolveApis;
-function resolveAndMergeNestedLint({ lintConfig, configPath = '', resolver = new resolve_1.BaseResolver(), }, parentConfigPaths = [], extendPaths = []) {
+function resolveAndMergeNestedStyleguideConfig({ styleguideConfig, configPath = '', resolver = new resolve_1.BaseResolver(), }, parentConfigPaths = [], extendPaths = []) {
     var _a, _b, _c;
     return __awaiter(this, void 0, void 0, function* () {
         if (parentConfigPaths.includes(configPath)) {
             throw new Error(`Circular dependency in config file: "${configPath}"`);
         }
-        const plugins = utils_1.getUniquePlugins(resolvePlugins([...((lintConfig === null || lintConfig === void 0 ? void 0 : lintConfig.plugins) || []), builtIn_1.defaultPlugin], configPath));
-        const pluginPaths = (_a = lintConfig === null || lintConfig === void 0 ? void 0 : lintConfig.plugins) === null || _a === void 0 ? void 0 : _a.filter(utils_2.isString).map((p) => path.resolve(path.dirname(configPath), p));
+        const plugins = utils_1.getUniquePlugins(resolvePlugins([...((styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.plugins) || []), builtIn_1.defaultPlugin], configPath));
+        const pluginPaths = (_a = styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.plugins) === null || _a === void 0 ? void 0 : _a.filter(utils_2.isString).map((p) => path.resolve(path.dirname(configPath), p));
         const resolvedConfigPath = ref_utils_1.isAbsoluteUrl(configPath)
             ? configPath
             : configPath && path.resolve(configPath);
-        const extendConfigs = yield Promise.all(((_b = lintConfig === null || lintConfig === void 0 ? void 0 : lintConfig.extends) === null || _b === void 0 ? void 0 : _b.map((presetItem) => __awaiter(this, void 0, void 0, function* () {
+        const extendConfigs = yield Promise.all(((_b = styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.extends) === null || _b === void 0 ? void 0 : _b.map((presetItem) => __awaiter(this, void 0, void 0, function* () {
             if (!ref_utils_1.isAbsoluteUrl(presetItem) && !path.extname(presetItem)) {
                 return resolvePreset(presetItem, plugins);
             }
@@ -161,27 +161,28 @@ function resolveAndMergeNestedLint({ lintConfig, configPath = '', resolver = new
                 : ref_utils_1.isAbsoluteUrl(configPath)
                     ? new URL(presetItem, configPath).href
                     : path.resolve(path.dirname(configPath), presetItem);
-            const extendedLintConfig = yield loadExtendLintConfig(pathItem, resolver);
-            return yield resolveAndMergeNestedLint({
-                lintConfig: extendedLintConfig,
+            const extendedStyleguideConfig = yield loadExtendStyleguideConfig(pathItem, resolver);
+            return yield resolveAndMergeNestedStyleguideConfig({
+                styleguideConfig: extendedStyleguideConfig,
                 configPath: pathItem,
                 resolver: resolver,
             }, [...parentConfigPaths, resolvedConfigPath], extendPaths);
         }))) || []);
         const _d = utils_1.mergeExtends([
             ...extendConfigs,
-            Object.assign(Object.assign({}, lintConfig), { plugins, extends: undefined, extendPaths: [...parentConfigPaths, resolvedConfigPath], pluginPaths }),
-        ]), { plugins: mergedPlugins = [] } = _d, lint = __rest(_d, ["plugins"]);
-        return Object.assign(Object.assign({}, lint), { extendPaths: (_c = lint.extendPaths) === null || _c === void 0 ? void 0 : _c.filter((path) => path && !ref_utils_1.isAbsoluteUrl(path)), plugins: utils_1.getUniquePlugins(mergedPlugins), recommendedFallback: lintConfig === null || lintConfig === void 0 ? void 0 : lintConfig.recommendedFallback, doNotResolveExamples: lintConfig === null || lintConfig === void 0 ? void 0 : lintConfig.doNotResolveExamples });
+            Object.assign(Object.assign({}, styleguideConfig), { plugins, extends: undefined, extendPaths: [...parentConfigPaths, resolvedConfigPath], pluginPaths }),
+        ]), { plugins: mergedPlugins = [] } = _d, styleguide = __rest(_d, ["plugins"]);
+        return Object.assign(Object.assign({}, styleguide), { extendPaths: (_c = styleguide.extendPaths) === null || _c === void 0 ? void 0 : _c.filter((path) => path && !ref_utils_1.isAbsoluteUrl(path)), plugins: utils_1.getUniquePlugins(mergedPlugins), recommendedFallback: styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.recommendedFallback, doNotResolveExamples: styleguideConfig === null || styleguideConfig === void 0 ? void 0 : styleguideConfig.doNotResolveExamples });
     });
 }
-function resolveLint(lintOpts, parentConfigPaths = [], extendPaths = []) {
+function resolveStyleguideConfig(opts, parentConfigPaths = [], extendPaths = []) {
     return __awaiter(this, void 0, void 0, function* () {
-        const resolvedLint = yield resolveAndMergeNestedLint(lintOpts, parentConfigPaths, extendPaths);
-        return Object.assign(Object.assign({}, resolvedLint), { rules: resolvedLint.rules && groupLintAssertionRules(resolvedLint.rules) });
+        const resolvedStyleguideConfig = yield resolveAndMergeNestedStyleguideConfig(opts, parentConfigPaths, extendPaths);
+        return Object.assign(Object.assign({}, resolvedStyleguideConfig), { rules: resolvedStyleguideConfig.rules &&
+                groupStyleguideAssertionRules(resolvedStyleguideConfig.rules) });
     });
 }
-exports.resolveLint = resolveLint;
+exports.resolveStyleguideConfig = resolveStyleguideConfig;
 function resolvePreset(presetName, plugins) {
     var _a;
     const { pluginId, configName } = utils_1.parsePresetName(presetName);
@@ -198,26 +199,28 @@ function resolvePreset(presetName, plugins) {
     return preset;
 }
 exports.resolvePreset = resolvePreset;
-function loadExtendLintConfig(filePath, resolver) {
+function loadExtendStyleguideConfig(filePath, resolver) {
     return __awaiter(this, void 0, void 0, function* () {
         try {
             const fileSource = yield resolver.loadExternalRef(filePath);
             const rawConfig = utils_1.transformConfig(utils_2.parseYaml(fileSource.body));
-            if (!rawConfig.lint) {
-                throw new Error(`Lint configuration format not detected: "${filePath}"`);
+            if (!rawConfig.styleguide) {
+                throw new Error(`Styleguide configuration format not detected: "${filePath}"`);
             }
-            return rawConfig.lint;
+            return rawConfig.styleguide;
         }
         catch (error) {
             throw new Error(`Failed to load "${filePath}": ${error.message}`);
         }
     });
 }
-function getMergedLintRawConfig(configLint, apiLint) {
-    const resultLint = Object.assign(Object.assign(Object.assign({}, configLint), apiLint), { rules: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.rules), apiLint === null || apiLint === void 0 ? void 0 : apiLint.rules), oas2Rules: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.oas2Rules), apiLint === null || apiLint === void 0 ? void 0 : apiLint.oas2Rules), oas3_0Rules: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.oas3_0Rules), apiLint === null || apiLint === void 0 ? void 0 : apiLint.oas3_0Rules), oas3_1Rules: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.oas3_1Rules), apiLint === null || apiLint === void 0 ? void 0 : apiLint.oas3_1Rules), preprocessors: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.preprocessors), apiLint === null || apiLint === void 0 ? void 0 : apiLint.preprocessors), oas2Preprocessors: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.oas2Preprocessors), apiLint === null || apiLint === void 0 ? void 0 : apiLint.oas2Preprocessors), oas3_0Preprocessors: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.oas3_0Preprocessors), apiLint === null || apiLint === void 0 ? void 0 : apiLint.oas3_0Preprocessors), oas3_1Preprocessors: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.oas3_1Preprocessors), apiLint === null || apiLint === void 0 ? void 0 : apiLint.oas3_1Preprocessors), decorators: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.decorators), apiLint === null || apiLint === void 0 ? void 0 : apiLint.decorators), oas2Decorators: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.oas2Decorators), apiLint === null || apiLint === void 0 ? void 0 : apiLint.oas2Decorators), oas3_0Decorators: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.oas3_0Decorators), apiLint === null || apiLint === void 0 ? void 0 : apiLint.oas3_0Decorators), oas3_1Decorators: Object.assign(Object.assign({}, configLint === null || configLint === void 0 ? void 0 : configLint.oas3_1Decorators), apiLint === null || apiLint === void 0 ? void 0 : apiLint.oas3_1Decorators), recommendedFallback: (apiLint === null || apiLint === void 0 ? void 0 : apiLint.extends) ? false : configLint.recommendedFallback });
+function getMergedRawStyleguideConfig(rootStyleguideConfig, apiStyleguideConfig) {
+    const resultLint = Object.assign(Object.assign(Object.assign({}, rootStyleguideConfig), apiStyleguideConfig), { rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.rules), oas2Rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas2Rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas2Rules), oas3_0Rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_0Rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_0Rules), oas3_1Rules: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_1Rules), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_1Rules), preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.preprocessors), oas2Preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas2Preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas2Preprocessors), oas3_0Preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_0Preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_0Preprocessors), oas3_1Preprocessors: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_1Preprocessors), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_1Preprocessors), decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.decorators), oas2Decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas2Decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas2Decorators), oas3_0Decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_0Decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_0Decorators), oas3_1Decorators: Object.assign(Object.assign({}, rootStyleguideConfig === null || rootStyleguideConfig === void 0 ? void 0 : rootStyleguideConfig.oas3_1Decorators), apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.oas3_1Decorators), recommendedFallback: (apiStyleguideConfig === null || apiStyleguideConfig === void 0 ? void 0 : apiStyleguideConfig.extends)
+            ? false
+            : rootStyleguideConfig.recommendedFallback });
     return resultLint;
 }
-function groupLintAssertionRules(rules) {
+function groupStyleguideAssertionRules(rules) {
     if (!rules) {
         return rules;
     }

package/lib/config/config.d.ts

@@ -2,7 +2,7 @@
 import { NormalizedProblem } from '../walk';
 import { OasVersion, OasMajorVersion, Oas2RuleSet, Oas3RuleSet } from '../oas-types';
 import type { NodeType } from '../types';
-import type { DecoratorConfig, Plugin, PreprocessorConfig, Region, ResolveConfig, ResolvedApi, ResolvedConfig, ResolvedLintConfig, RuleConfig } from './types';
+import type { DecoratorConfig, Plugin, PreprocessorConfig, Region, ResolveConfig, ResolvedApi, ResolvedConfig, ResolvedStyleguideConfig, RuleConfig } from './types';
 export declare const env: NodeJS.ProcessEnv;
 export declare const IGNORE_FILE = ".redocly.lint-ignore.yaml";
 export declare const DEFAULT_REGION = "us";
@@ -11,8 +11,8 @@ export declare const DOMAINS: {
     eu: string;
 };
 export declare const AVAILABLE_REGIONS: Region[];
-export declare class LintConfig {
-    rawConfig: ResolvedLintConfig;
+export declare class StyleguideConfig {
+    rawConfig: ResolvedStyleguideConfig;
     configFile?: string | undefined;
     plugins: Plugin[];
     ignore: Record<string, Record<string, Set<string>>>;
@@ -25,7 +25,7 @@ export declare class LintConfig {
     recommendedFallback: boolean;
     extendPaths: string[];
     pluginPaths: string[];
-    constructor(rawConfig: ResolvedLintConfig, configFile?: string | undefined);
+    constructor(rawConfig: ResolvedStyleguideConfig, configFile?: string | undefined);
     resolveIgnore(ignoreFile?: string): void;
     saveIgnore(): void;
     addIgnore(problem: NormalizedProblem): void;
@@ -54,7 +54,7 @@ export declare class Config {
     rawConfig: ResolvedConfig;
     configFile?: string | undefined;
     apis: Record<string, ResolvedApi>;
-    lint: LintConfig;
+    styleguide: StyleguideConfig;
     resolve: ResolveConfig;
     licenseKey?: string;
     region?: Region;

package/lib/config/config.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Config = exports.LintConfig = exports.AVAILABLE_REGIONS = exports.DOMAINS = exports.DEFAULT_REGION = exports.IGNORE_FILE = exports.env = void 0;
+exports.Config = exports.StyleguideConfig = exports.AVAILABLE_REGIONS = exports.DOMAINS = exports.DEFAULT_REGION = exports.IGNORE_FILE = exports.env = void 0;
 const fs = require("fs");
 const path = require("path");
 const js_yaml_1 = require("../js-yaml");
@@ -40,7 +40,7 @@ function getIgnoreFilePath(configFile) {
 }
 exports.DOMAINS = getDomains();
 exports.AVAILABLE_REGIONS = Object.keys(exports.DOMAINS);
-class LintConfig {
+class StyleguideConfig {
     constructor(rawConfig, configFile) {
         this.rawConfig = rawConfig;
         this.configFile = configFile;
@@ -234,13 +234,13 @@ class LintConfig {
         }
     }
 }
-exports.LintConfig = LintConfig;
+exports.StyleguideConfig = StyleguideConfig;
 class Config {
     constructor(rawConfig, configFile) {
         this.rawConfig = rawConfig;
         this.configFile = configFile;
         this.apis = rawConfig.apis || {};
-        this.lint = new LintConfig(rawConfig.lint || {}, configFile);
+        this.styleguide = new StyleguideConfig(rawConfig.styleguide || {}, configFile);
         this['features.openapi'] = rawConfig['features.openapi'] || {};
         this['features.mockServer'] = rawConfig['features.mockServer'] || {};
         this.resolve = utils_2.getResolveConfig(rawConfig === null || rawConfig === void 0 ? void 0 : rawConfig.resolve);

package/lib/config/load.js

@@ -21,12 +21,12 @@ function addConfigMetadata({ rawConfig, customExtends, configPath, }) {
     var _a;
     return __awaiter(this, void 0, void 0, function* () {
         if (customExtends !== undefined) {
-            rawConfig.lint = rawConfig.lint || {};
-            rawConfig.lint.extends = customExtends;
+            rawConfig.styleguide = rawConfig.styleguide || {};
+            rawConfig.styleguide.extends = customExtends;
         }
         else if (utils_1.isEmptyObject(rawConfig)) {
             // TODO: check if we can add recommended here. add message here?
-            // rawConfig.lint = { extends: ['recommended'], recommendedFallback: true };
+            // rawConfig.styleguide = { extends: ['recommended'], recommendedFallback: true };
         }
         const redoclyClient = new redocly_1.RedoclyClient();
         const tokens = yield redoclyClient.getTokens();
@@ -94,7 +94,7 @@ function getConfig(configPath = findConfig()) {
         if (!configPath || !utils_1.doesYamlFileExist(configPath))
             return {};
         try {
-            const rawConfig = ((yield utils_1.loadYaml(configPath)) || {});
+            const rawConfig = (yield utils_1.loadYaml(configPath)) || {};
             return utils_2.transformConfig(rawConfig);
         }
         catch (e) {

package/lib/config/minimal.d.ts

@@ -1,3 +1,3 @@
-import type { PluginLintConfig } from './types';
-declare const _default: PluginLintConfig;
+import type { PluginStyleguideConfig } from './types';
+declare const _default: PluginStyleguideConfig;
 export default _default;

package/lib/config/minimal.js

@@ -18,7 +18,7 @@ exports.default = {
         'operation-description': 'off',
         'operation-2xx-response': 'warn',
         'operation-4xx-response': 'off',
-        'assertions': 'warn',
+        assertions: 'warn',
         'operation-operationId': 'warn',
         'operation-summary': 'warn',
         'operation-operationId-unique': 'warn',

package/lib/config/recommended.d.ts

@@ -1,3 +1,3 @@
-import type { PluginLintConfig } from './types';
-declare const _default: PluginLintConfig;
+import type { PluginStyleguideConfig } from './types';
+declare const _default: PluginStyleguideConfig;
 export default _default;

package/lib/config/recommended.js

@@ -17,7 +17,7 @@ exports.default = {
         'path-parameters-defined': 'error',
         'operation-description': 'off',
         'operation-2xx-response': 'warn',
-        'assertions': 'warn',
+        assertions: 'warn',
         'operation-4xx-response': 'warn',
         'operation-operationId': 'warn',
         'operation-summary': 'error',

package/lib/config/rules.d.ts

@@ -1,6 +1,6 @@
 import { RuleSet, OasVersion } from '../oas-types';
-import { LintConfig } from './config';
-export declare function initRules<T extends Function, P extends RuleSet<T>>(rules: P[], config: LintConfig, type: 'rules' | 'preprocessors' | 'decorators', oasVersion: OasVersion): {
+import { StyleguideConfig } from './config';
+export declare function initRules<T extends Function, P extends RuleSet<T>>(rules: P[], config: StyleguideConfig, type: 'rules' | 'preprocessors' | 'decorators', oasVersion: OasVersion): {
     severity: import("./types").RuleSeverity;
     ruleId: string;
     visitor: any;

package/lib/config/rules.js

@@ -28,7 +28,7 @@ function initRules(rules, config, type, oasVersion) {
             visitor: visitors, // note: actually it is only one visitor object
         };
     }))
-        .flatMap(visitor => visitor)
+        .flatMap((visitor) => visitor)
         .filter(utils_1.notUndefined);
 }
 exports.initRules = initRules;

package/lib/config/types.d.ts

@@ -10,7 +10,7 @@ export declare type PreprocessorConfig = PreprocessorSeverity | ({
     severity?: ProblemSeverity;
 } & Record<string, any>);
 export declare type DecoratorConfig = PreprocessorConfig;
-export declare type LintRawConfig = {
+export declare type StyleguideRawConfig = {
     plugins?: (string | Plugin)[];
     extends?: string[];
     doNotResolveExamples?: boolean;
@@ -28,7 +28,8 @@ export declare type LintRawConfig = {
     oas3_0Decorators?: Record<string, DecoratorConfig>;
     oas3_1Decorators?: Record<string, DecoratorConfig>;
 };
-export declare type ResolvedLintConfig = PluginLintConfig & {
+export declare type ApiStyleguideRawConfig = Omit<StyleguideRawConfig, 'plugins'>;
+export declare type ResolvedStyleguideConfig = PluginStyleguideConfig & {
     plugins?: Plugin[];
     recommendedFallback?: boolean;
     extends?: void | never;
@@ -51,13 +52,13 @@ export declare type CustomRulesConfig = {
 };
 export declare type Plugin = {
     id: string;
-    configs?: Record<string, PluginLintConfig>;
+    configs?: Record<string, PluginStyleguideConfig>;
     rules?: CustomRulesConfig;
     preprocessors?: PreprocessorsConfig;
     decorators?: DecoratorsConfig;
     typeExtension?: TypeExtensionsConfig;
 };
-export declare type PluginLintConfig = Omit<LintRawConfig, 'plugins' | 'extends'>;
+export declare type PluginStyleguideConfig = Omit<StyleguideRawConfig, 'plugins' | 'extends'>;
 export declare type ResolveHeader = {
     name: string;
     envVariable?: undefined;
@@ -83,33 +84,36 @@ export declare type Region = 'us' | 'eu';
 export declare type AccessTokens = {
     [region in Region]?: string;
 };
-export declare type DeprecatedRawConfig = {
+export declare type DeprecatedInRawConfig = {
     apiDefinitions?: Record<string, string>;
-    lint?: LintRawConfig;
-    resolve?: RawResolveConfig;
-    region?: Region;
+    lint?: StyleguideRawConfig;
     referenceDocs?: Record<string, any>;
+    apis?: Record<string, Api & DeprecatedInApi>;
 };
 export declare type Api = {
     root: string;
-    lint?: Omit<LintRawConfig, 'plugins'>;
-    'features.openapi'?: Record<string, any>;
-    'features.mockServer'?: Record<string, any>;
+    styleguide?: ApiStyleguideRawConfig;
+} & FeaturesConfig;
+export declare type DeprecatedInApi = {
+    lint?: ApiStyleguideRawConfig;
 };
-export declare type ResolvedApi = Omit<Api, 'lint'> & {
-    lint: Omit<ResolvedLintConfig, 'plugins'>;
+export declare type ResolvedApi = Omit<Api, 'styleguide'> & {
+    styleguide: ResolvedStyleguideConfig;
 };
 export declare type RawConfig = {
     apis?: Record<string, Api>;
-    lint?: LintRawConfig;
+    styleguide?: StyleguideRawConfig;
     resolve?: RawResolveConfig;
     region?: Region;
-    'features.openapi'?: Record<string, any>;
-    'features.mockServer'?: Record<string, any>;
     organization?: string;
-};
-export declare type ResolvedConfig = Omit<RawConfig, 'lint' | 'apis'> & {
-    lint: ResolvedLintConfig;
+} & FeaturesConfig;
+export declare type ResolvedConfig = Omit<RawConfig, 'apis' | 'styleguide'> & {
     apis: Record<string, ResolvedApi>;
+    styleguide: ResolvedStyleguideConfig;
+};
+declare type FeaturesConfig = {
+    'features.openapi'?: Record<string, any>;
+    'features.mockServer'?: Record<string, any>;
 };
 export declare type RulesFields = 'rules' | 'oas2Rules' | 'oas3_0Rules' | 'oas3_1Rules' | 'preprocessors' | 'oas2Preprocessors' | 'oas3_0Preprocessors' | 'oas3_1Preprocessors' | 'decorators' | 'oas2Decorators' | 'oas3_0Decorators' | 'oas3_1Decorators';
+export {};

package/lib/config/utils.d.ts

@@ -1,13 +1,13 @@
 import { Config } from './config';
-import type { Api, DeprecatedRawConfig, Plugin, RawConfig, RawResolveConfig, ResolveConfig, ResolvedLintConfig, RulesFields } from './types';
+import type { Api, DeprecatedInRawConfig, Plugin, RawConfig, RawResolveConfig, ResolveConfig, ResolvedStyleguideConfig, RulesFields } from './types';
 export declare function parsePresetName(presetName: string): {
     pluginId: string;
     configName: string;
 };
-export declare function transformApiDefinitionsToApis(apiDefinitions?: Record<string, string>): Record<string, Api>;
+export declare function transformApiDefinitionsToApis(apiDefinitions?: DeprecatedInRawConfig['apiDefinitions']): Record<string, Api> | undefined;
 export declare function prefixRules<T extends Record<string, any>>(rules: T, prefix: string): any;
-export declare function mergeExtends(rulesConfList: ResolvedLintConfig[]): Omit<ResolvedLintConfig, RulesFields> & Required<Pick<ResolvedLintConfig, RulesFields>>;
-export declare function getMergedConfig(config: Config, entrypointAlias?: string): Config;
-export declare function transformConfig(rawConfig: DeprecatedRawConfig | RawConfig): RawConfig;
+export declare function mergeExtends(rulesConfList: ResolvedStyleguideConfig[]): Omit<ResolvedStyleguideConfig, RulesFields> & Required<Pick<ResolvedStyleguideConfig, RulesFields>>;
+export declare function getMergedConfig(config: Config, apiName?: string): Config;
+export declare function transformConfig(rawConfig: DeprecatedInRawConfig & RawConfig): RawConfig;
 export declare function getResolveConfig(resolve?: RawResolveConfig): ResolveConfig;
 export declare function getUniquePlugins(plugins: Plugin[]): Plugin[];