@redocly/openapi-core 1.25.14 → 1.26.0

package/src/config/all.ts

@@ -2,52 +2,47 @@ import type { PluginStyleguideConfig } from './types';
 
 const all: PluginStyleguideConfig<'built-in'> = {
   rules: {
+    struct: 'error',
+  },
+  oas2Rules: {
+    'boolean-parameter-prefixes': 'error',
     'info-contact': 'error',
     'info-license': 'error',
     'info-license-url': 'error',
     'info-license-strict': 'error',
-    'tag-description': 'error',
-    'tags-alphabetical': 'error',
-    'parameter-description': 'error',
+    'no-path-trailing-slash': 'error',
     'no-identical-paths': 'error',
     'no-ambiguous-paths': 'error',
-    'no-path-trailing-slash': 'error',
-    'path-segment-plural': 'error',
-    'path-declaration-must-exist': 'error',
-    'path-not-include-query': 'error',
-    'path-parameters-defined': 'error',
-    'operation-description': 'error',
-    'operation-2xx-response': 'error',
-    'operation-4xx-response': 'error',
-    'operation-operationId': 'error',
+    'no-invalid-schema-examples': 'error',
+    'no-invalid-parameter-examples': 'error',
+    'no-http-verbs-in-paths': 'error',
+    'no-enum-type-mismatch': 'error',
+    'no-unresolved-refs': 'error',
+    'no-required-schema-properties-undefined': 'error',
     'operation-summary': 'error',
+    'operation-operationId': 'error',
     'operation-operationId-unique': 'error',
     'operation-operationId-url-safe': 'error',
+    'operation-description': 'error',
+    'operation-2xx-response': 'error',
+    'operation-4xx-response': 'error',
     'operation-parameters-unique': 'error',
     'operation-tag-defined': 'error',
-    'security-defined': 'error',
     'operation-singular-tag': 'error',
-    'no-unresolved-refs': 'error',
-    'no-enum-type-mismatch': 'error',
+    'parameter-description': 'error',
+    'path-declaration-must-exist': 'error',
+    'path-not-include-query': 'error',
+    'path-parameters-defined': 'error',
     'paths-kebab-case': 'error',
-    'no-http-verbs-in-paths': 'error',
     'path-excludes-patterns': {
       severity: 'error',
       patterns: [],
     },
-    spec: 'error',
-    'no-invalid-schema-examples': 'error',
-    'no-invalid-parameter-examples': 'error',
-    'scalar-property-missing-example': 'error',
-    'spec-strict-refs': 'error',
     'path-http-verbs-order': 'error',
     'path-params-defined': 'error',
+    'path-segment-plural': 'error',
     'required-string-property-missing-min-length': 'error',
     'response-contains-header': 'error',
-    'no-required-schema-properties-undefined': 'error',
-  },
-  oas2Rules: {
-    'boolean-parameter-prefixes': 'error',
     'request-mime-type': {
       severity: 'error',
       allowedValues: ['application/json'],
@@ -57,8 +52,29 @@ const all: PluginStyleguideConfig<'built-in'> = {
       allowedValues: ['application/json'],
     },
     'response-contains-property': 'error',
+    'security-defined': 'error',
+    'spec-strict-refs': 'error',
+    'scalar-property-missing-example': 'error',
+    'tag-description': 'error',
+    'tags-alphabetical': 'error',
   },
   oas3_0Rules: {
+    'array-parameter-serialization': 'error',
+    'boolean-parameter-prefixes': 'error',
+    'component-name-unique': 'error',
+    'info-contact': 'error',
+    'info-license': 'error',
+    'info-license-url': 'error',
+    'info-license-strict': 'error',
+    'no-path-trailing-slash': 'error',
+    'no-identical-paths': 'error',
+    'no-ambiguous-paths': 'error',
+    'no-invalid-schema-examples': 'error',
+    'no-invalid-parameter-examples': 'error',
+    'no-http-verbs-in-paths': 'error',
+    'no-enum-type-mismatch': 'error',
+    'no-unresolved-refs': 'error',
+    'no-required-schema-properties-undefined': 'error',
     'no-invalid-media-type-examples': 'error',
     'no-server-example.com': 'error',
     'no-server-trailing-slash': 'error',
@@ -67,8 +83,31 @@ const all: PluginStyleguideConfig<'built-in'> = {
     'no-unused-components': 'error',
     'no-undefined-server-variable': 'error',
     'no-server-variables-empty-enum': 'error',
+    'operation-summary': 'error',
+    'operation-operationId': 'error',
+    'operation-operationId-unique': 'error',
+    'operation-operationId-url-safe': 'error',
+    'operation-description': 'error',
+    'operation-2xx-response': 'error',
+    'operation-4xx-response': 'error',
     'operation-4xx-problem-details-rfc7807': 'error',
-    'boolean-parameter-prefixes': 'error',
+    'operation-parameters-unique': 'error',
+    'operation-tag-defined': 'error',
+    'operation-singular-tag': 'error',
+    'parameter-description': 'error',
+    'path-declaration-must-exist': 'error',
+    'path-not-include-query': 'error',
+    'path-parameters-defined': 'error',
+    'paths-kebab-case': 'error',
+    'path-excludes-patterns': {
+      severity: 'error',
+      patterns: [],
+    },
+    'path-http-verbs-order': 'error',
+    'path-params-defined': 'error',
+    'path-segment-plural': 'error',
+    'required-string-property-missing-min-length': 'error',
+    'response-contains-header': 'error',
     'request-mime-type': {
       severity: 'error',
       allowedValues: ['application/json'],
@@ -77,12 +116,31 @@ const all: PluginStyleguideConfig<'built-in'> = {
       severity: 'error',
       allowedValues: ['application/json'],
     },
-    'component-name-unique': 'error',
     'response-contains-property': 'error',
+    'security-defined': 'error',
+    'spec-strict-refs': 'error',
+    'scalar-property-missing-example': 'error',
     'spec-components-invalid-map-name': 'error',
-    'array-parameter-serialization': 'error',
+    'tag-description': 'error',
+    'tags-alphabetical': 'error',
   },
   oas3_1Rules: {
+    'array-parameter-serialization': 'error',
+    'boolean-parameter-prefixes': 'error',
+    'component-name-unique': 'error',
+    'info-contact': 'error',
+    'info-license': 'error',
+    'info-license-url': 'error',
+    'info-license-strict': 'error',
+    'no-path-trailing-slash': 'error',
+    'no-identical-paths': 'error',
+    'no-ambiguous-paths': 'error',
+    'no-invalid-schema-examples': 'error',
+    'no-invalid-parameter-examples': 'error',
+    'no-http-verbs-in-paths': 'error',
+    'no-enum-type-mismatch': 'error',
+    'no-unresolved-refs': 'error',
+    'no-required-schema-properties-undefined': 'error',
     'no-invalid-media-type-examples': 'error',
     'no-server-example.com': 'error',
     'no-server-trailing-slash': 'error',
@@ -91,8 +149,31 @@ const all: PluginStyleguideConfig<'built-in'> = {
     'no-unused-components': 'error',
     'no-undefined-server-variable': 'error',
     'no-server-variables-empty-enum': 'error',
+    'parameter-description': 'error',
+    'path-declaration-must-exist': 'error',
+    'path-not-include-query': 'error',
+    'path-parameters-defined': 'error',
+    'paths-kebab-case': 'error',
+    'path-excludes-patterns': {
+      severity: 'error',
+      patterns: [],
+    },
+    'path-http-verbs-order': 'error',
+    'path-params-defined': 'error',
+    'path-segment-plural': 'error',
+    'operation-summary': 'error',
+    'operation-operationId': 'error',
+    'operation-operationId-unique': 'error',
+    'operation-operationId-url-safe': 'error',
+    'operation-description': 'error',
+    'operation-2xx-response': 'error',
+    'operation-4xx-response': 'error',
     'operation-4xx-problem-details-rfc7807': 'error',
-    'boolean-parameter-prefixes': 'error',
+    'operation-parameters-unique': 'error',
+    'operation-tag-defined': 'error',
+    'operation-singular-tag': 'error',
+    'required-string-property-missing-min-length': 'error',
+    'response-contains-header': 'error',
     'request-mime-type': {
       severity: 'error',
       allowedValues: ['application/json'],
@@ -101,47 +182,48 @@ const all: PluginStyleguideConfig<'built-in'> = {
       severity: 'error',
       allowedValues: ['application/json'],
     },
-    'component-name-unique': 'error',
     'response-contains-property': 'error',
+    'security-defined': 'error',
+    'spec-strict-refs': 'error',
+    'scalar-property-missing-example': 'error',
     'spec-components-invalid-map-name': 'error',
-    'array-parameter-serialization': 'error',
+    'tag-description': 'error',
+    'tags-alphabetical': 'error',
   },
   async2Rules: {
-    spec: 'error',
+    'channels-kebab-case': 'error',
     'info-contact': 'error',
     'info-license-strict': 'error',
+    'no-channel-trailing-slash': 'error',
     'operation-operationId': 'error',
     'tag-description': 'error',
     'tags-alphabetical': 'error',
-    'channels-kebab-case': 'error',
-    'no-channel-trailing-slash': 'error',
   },
   async3Rules: {
-    spec: 'error',
+    'channels-kebab-case': 'error',
     'info-contact': 'error',
     'info-license-strict': 'error',
+    'no-channel-trailing-slash': 'error',
     'operation-operationId': 'error',
     'tag-description': 'error',
     'tags-alphabetical': 'error',
-    'channels-kebab-case': 'error',
-    'no-channel-trailing-slash': 'error',
   },
-  arazzoRules: {
-    spec: 'error',
+  arazzo1Rules: {
+    'criteria-unique': 'error',
+    'no-criteria-xpath': 'error',
+    'no-actions-type-end': 'error',
     'parameters-not-in-body': 'error',
+    'parameters-unique': 'error',
+    'requestBody-replacements-unique': 'error',
     'sourceDescription-type': 'error',
-    'version-enum': 'error',
-    'workflowId-unique': 'error',
+    'step-onSuccess-unique': 'error',
+    'step-onFailure-unique': 'error',
     'stepId-unique': 'error',
     'sourceDescription-name-unique': 'error',
+    'sourceDescriptions-not-empty': 'error',
+    'version-enum': 'error',
+    'workflowId-unique': 'error',
     'workflow-dependsOn': 'error',
-    'parameters-unique': 'error',
-    'step-onSuccess-unique': 'error',
-    'step-onFailure-unique': 'error',
-    'requestBody-replacements-unique': 'error',
-    'no-criteria-xpath': 'error',
-    'no-actions-type-end': 'error',
-    'criteria-unique': 'error',
   },
 };
 

package/src/config/builtIn.ts

@@ -2,51 +2,53 @@ import recommended from './recommended';
 import recommendedStrict from './recommended-strict';
 import all from './all';
 import minimal from './minimal';
+import spec from './spec';
 import { rules as oas3Rules, preprocessors as oas3Preprocessors } from '../rules/oas3';
 import { rules as oas2Rules, preprocessors as oas2Preprocessors } from '../rules/oas2';
 import { rules as async2Rules, preprocessors as async2Preprocessors } from '../rules/async2';
 import { rules as async3Rules, preprocessors as async3Preprocessors } from '../rules/async3';
-import { rules as arazzoRules, preprocessors as arazzoPreprocessors } from '../rules/arazzo';
+import { rules as arazzo1Rules, preprocessors as arazzoPreprocessors } from '../rules/arazzo';
 import { decorators as oas3Decorators } from '../decorators/oas3';
 import { decorators as oas2Decorators } from '../decorators/oas2';
 import { decorators as async2Decorators } from '../decorators/async2';
 import { decorators as async3Decorators } from '../decorators/async3';
-import { decorators as arazzoDecorators } from '../decorators/arazzo';
+import { decorators as arazzo1Decorators } from '../decorators/arazzo';
 
-import type { CustomRulesConfig, StyleguideRawConfig, Plugin } from './types';
+import type { StyleguideRawConfig, Plugin } from './types';
 
 export const builtInConfigs: Record<string, StyleguideRawConfig> = {
   recommended,
   'recommended-strict': recommendedStrict,
   minimal,
   all,
+  spec,
   'redocly-registry': {
     decorators: { 'registry-dependencies': 'on' },
   },
 };
 
-export const defaultPlugin: Plugin = {
+export const defaultPlugin: Plugin<'built-in'> = {
   id: '', // default plugin doesn't have id
   rules: {
     oas3: oas3Rules,
     oas2: oas2Rules,
     async2: async2Rules,
     async3: async3Rules,
-    arazzo: arazzoRules,
-  } as CustomRulesConfig,
+    arazzo1: arazzo1Rules,
+  },
   preprocessors: {
     oas3: oas3Preprocessors,
     oas2: oas2Preprocessors,
     async2: async2Preprocessors,
     async3: async3Preprocessors,
-    arazzo: arazzoPreprocessors,
+    arazzo1: arazzoPreprocessors,
   },
   decorators: {
     oas3: oas3Decorators,
     oas2: oas2Decorators,
     async2: async2Decorators,
     async3: async3Decorators,
-    arazzo: arazzoDecorators,
+    arazzo1: arazzo1Decorators,
   },
   configs: builtInConfigs,
 };

package/src/config/config-resolvers.ts

@@ -261,8 +261,8 @@ export async function resolvePlugins(
         if (pluginModule.rules.async3) {
           plugin.rules.async3 = prefixRules(pluginModule.rules.async3, id);
         }
-        if (pluginModule.rules.arazzo) {
-          plugin.rules.arazzo = prefixRules(pluginModule.rules.arazzo, id);
+        if (pluginModule.rules.arazzo1) {
+          plugin.rules.arazzo1 = prefixRules(pluginModule.rules.arazzo1, id);
         }
       }
       if (pluginModule.preprocessors) {
@@ -271,7 +271,7 @@ export async function resolvePlugins(
           !pluginModule.preprocessors.oas2 &&
           !pluginModule.preprocessors.async2 &&
           !pluginModule.preprocessors.async3 &&
-          !pluginModule.preprocessors.arazzo
+          !pluginModule.preprocessors.arazzo1
         ) {
           throw new Error(
             `Plugin \`preprocessors\` must have \`oas3\`, \`oas2\` or \`async2\` preprocessors "${p}.`
@@ -290,8 +290,8 @@ export async function resolvePlugins(
         if (pluginModule.preprocessors.async3) {
           plugin.preprocessors.async3 = prefixRules(pluginModule.preprocessors.async3, id);
         }
-        if (pluginModule.preprocessors.arazzo) {
-          plugin.preprocessors.arazzo = prefixRules(pluginModule.preprocessors.arazzo, id);
+        if (pluginModule.preprocessors.arazzo1) {
+          plugin.preprocessors.arazzo1 = prefixRules(pluginModule.preprocessors.arazzo1, id);
         }
       }
 
@@ -301,7 +301,7 @@ export async function resolvePlugins(
           !pluginModule.decorators.oas2 &&
           !pluginModule.decorators.async2 &&
           !pluginModule.decorators.async3 &&
-          !pluginModule.decorators.arazzo
+          !pluginModule.decorators.arazzo1
         ) {
           throw new Error(
             `Plugin \`decorators\` must have \`oas3\`, \`oas2\`, \`async2\` or \`async3\` decorators "${p}.`
@@ -320,8 +320,8 @@ export async function resolvePlugins(
         if (pluginModule.decorators.async3) {
           plugin.decorators.async3 = prefixRules(pluginModule.decorators.async3, id);
         }
-        if (pluginModule.decorators.arazzo) {
-          plugin.decorators.arazzo = prefixRules(pluginModule.decorators.arazzo, id);
+        if (pluginModule.decorators.arazzo1) {
+          plugin.decorators.arazzo1 = prefixRules(pluginModule.decorators.arazzo1, id);
         }
       }
 
@@ -520,7 +520,7 @@ function getMergedRawStyleguideConfig(
     oas3_1Rules: { ...rootStyleguideConfig?.oas3_1Rules, ...apiStyleguideConfig?.oas3_1Rules },
     async2Rules: { ...rootStyleguideConfig?.async2Rules, ...apiStyleguideConfig?.async2Rules },
     async3Rules: { ...rootStyleguideConfig?.async3Rules, ...apiStyleguideConfig?.async3Rules },
-    arazzoRules: { ...rootStyleguideConfig?.arazzoRules, ...apiStyleguideConfig?.arazzoRules },
+    arazzo1Rules: { ...rootStyleguideConfig?.arazzo1Rules, ...apiStyleguideConfig?.arazzo1Rules },
     preprocessors: {
       ...rootStyleguideConfig?.preprocessors,
       ...apiStyleguideConfig?.preprocessors,

package/src/config/config.ts

@@ -1,7 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { parseYaml, stringifyYaml } from '../js-yaml';
-import { slash, doesYamlFileExist } from '../utils';
+import { slash, doesYamlFileExist, isPlainObject, showWarningForDeprecatedField } from '../utils';
 import { SpecVersion, SpecMajorVersion } from '../oas-types';
 import { isBrowser } from '../env';
 import { getResolveConfig } from './utils';
@@ -13,7 +13,7 @@ import type {
   Oas3RuleSet,
   Async2RuleSet,
   Async3RuleSet,
-  ArazzoRuleSet,
+  Arazzo1RuleSet,
 } from '../oas-types';
 import type { NodeType } from '../types';
 import type {
@@ -67,16 +67,25 @@ export class StyleguideConfig {
     this.doNotResolveExamples = !!rawConfig.doNotResolveExamples;
     this.recommendedFallback = rawConfig.recommendedFallback || false;
 
+    const ruleGroups: (keyof ResolvedStyleguideConfig)[] = [
+      'rules',
+      'oas2Rules',
+      'oas3_0Rules',
+      'oas3_1Rules',
+      'async2Rules',
+      'async3Rules',
+      'arazzo1Rules',
+    ];
+
+    replaceSpecWithStruct(ruleGroups, rawConfig);
+
     this.rules = {
       [SpecVersion.OAS2]: { ...rawConfig.rules, ...rawConfig.oas2Rules },
       [SpecVersion.OAS3_0]: { ...rawConfig.rules, ...rawConfig.oas3_0Rules },
       [SpecVersion.OAS3_1]: { ...rawConfig.rules, ...rawConfig.oas3_1Rules },
       [SpecVersion.Async2]: { ...rawConfig.rules, ...rawConfig.async2Rules },
       [SpecVersion.Async3]: { ...rawConfig.rules, ...rawConfig.async3Rules },
-      [SpecVersion.Arazzo]: {
-        ...(rawConfig.arazzoRules || {}),
-        ...(rawConfig.rules?.assertions ? { assertions: rawConfig.rules.assertions } : {}),
-      },
+      [SpecVersion.Arazzo1]: { ...rawConfig.rules, ...rawConfig.arazzo1Rules },
     };
 
     this.preprocessors = {
@@ -85,7 +94,7 @@ export class StyleguideConfig {
       [SpecVersion.OAS3_1]: { ...rawConfig.preprocessors, ...rawConfig.oas3_1Preprocessors },
       [SpecVersion.Async2]: { ...rawConfig.preprocessors, ...rawConfig.async2Preprocessors },
       [SpecVersion.Async3]: { ...rawConfig.preprocessors, ...rawConfig.async3Preprocessors },
-      [SpecVersion.Arazzo]: { ...rawConfig.arazzoPreprocessors },
+      [SpecVersion.Arazzo1]: { ...rawConfig.arazzo1Preprocessors },
     };
 
     this.decorators = {
@@ -94,7 +103,7 @@ export class StyleguideConfig {
       [SpecVersion.OAS3_1]: { ...rawConfig.decorators, ...rawConfig.oas3_1Decorators },
       [SpecVersion.Async2]: { ...rawConfig.decorators, ...rawConfig.async2Decorators },
       [SpecVersion.Async3]: { ...rawConfig.decorators, ...rawConfig.async3Decorators },
-      [SpecVersion.Arazzo]: { ...rawConfig.arazzoDecorators },
+      [SpecVersion.Arazzo1]: { ...rawConfig.arazzo1Decorators },
     };
 
     this.extendPaths = rawConfig.extendPaths || [];
@@ -111,6 +120,8 @@ export class StyleguideConfig {
         Record<string, Set<string>>
       >) || {};
 
+    replaceSpecWithStruct(Object.keys(this.ignore), this.ignore);
+
     // resolve ignore paths
     for (const fileName of Object.keys(this.ignore)) {
       this.ignore[
@@ -192,9 +203,9 @@ export class StyleguideConfig {
             if (!plugin.typeExtension.async3) continue;
             extendedTypes = plugin.typeExtension.async3(extendedTypes, version);
             break;
-          case SpecVersion.Arazzo:
-            if (!plugin.typeExtension.arazzo) continue;
-            extendedTypes = plugin.typeExtension.arazzo(extendedTypes, version);
+          case SpecVersion.Arazzo1:
+            if (!plugin.typeExtension.arazzo1) continue;
+            extendedTypes = plugin.typeExtension.arazzo1(extendedTypes, version);
             break;
           default:
             throw new Error('Not implemented');
@@ -268,25 +279,25 @@ export class StyleguideConfig {
     };
   }
 
-  getRulesForOasVersion(version: SpecMajorVersion) {
+  getRulesForSpecVersion(version: SpecMajorVersion) {
     switch (version) {
       case SpecMajorVersion.OAS3:
         // eslint-disable-next-line no-case-declarations
-        const oas3Rules: Oas3RuleSet[] = []; // default ruleset
+        const oas3Rules: Oas3RuleSet[] = [];
         this.plugins.forEach((p) => p.preprocessors?.oas3 && oas3Rules.push(p.preprocessors.oas3));
         this.plugins.forEach((p) => p.rules?.oas3 && oas3Rules.push(p.rules.oas3));
         this.plugins.forEach((p) => p.decorators?.oas3 && oas3Rules.push(p.decorators.oas3));
         return oas3Rules;
       case SpecMajorVersion.OAS2:
         // eslint-disable-next-line no-case-declarations
-        const oas2Rules: Oas2RuleSet[] = []; // default ruleset
+        const oas2Rules: Oas2RuleSet[] = [];
         this.plugins.forEach((p) => p.preprocessors?.oas2 && oas2Rules.push(p.preprocessors.oas2));
         this.plugins.forEach((p) => p.rules?.oas2 && oas2Rules.push(p.rules.oas2));
         this.plugins.forEach((p) => p.decorators?.oas2 && oas2Rules.push(p.decorators.oas2));
         return oas2Rules;
       case SpecMajorVersion.Async2:
         // eslint-disable-next-line no-case-declarations
-        const asyncApi2Rules: Async2RuleSet[] = []; // default ruleset
+        const asyncApi2Rules: Async2RuleSet[] = [];
         this.plugins.forEach(
           (p) => p.preprocessors?.async2 && asyncApi2Rules.push(p.preprocessors.async2)
         );
@@ -297,7 +308,7 @@ export class StyleguideConfig {
         return asyncApi2Rules;
       case SpecMajorVersion.Async3:
         // eslint-disable-next-line no-case-declarations
-        const asyncApi3Rules: Async3RuleSet[] = []; // default ruleset
+        const asyncApi3Rules: Async3RuleSet[] = [];
         this.plugins.forEach(
           (p) => p.preprocessors?.async3 && asyncApi3Rules.push(p.preprocessors.async3)
         );
@@ -306,15 +317,17 @@ export class StyleguideConfig {
           (p) => p.decorators?.async3 && asyncApi3Rules.push(p.decorators.async3)
         );
         return asyncApi3Rules;
-      case SpecMajorVersion.Arazzo:
+      case SpecMajorVersion.Arazzo1:
         // eslint-disable-next-line no-case-declarations
-        const arazzoRules: ArazzoRuleSet[] = []; // default ruleset
+        const arazzo1Rules: Arazzo1RuleSet[] = [];
+        this.plugins.forEach(
+          (p) => p.preprocessors?.arazzo1 && arazzo1Rules.push(p.preprocessors.arazzo1)
+        );
+        this.plugins.forEach((p) => p.rules?.arazzo1 && arazzo1Rules.push(p.rules.arazzo1));
         this.plugins.forEach(
-          (p) => p.preprocessors?.arazzo && arazzoRules.push(p.preprocessors.arazzo)
+          (p) => p.decorators?.arazzo1 && arazzo1Rules.push(p.decorators.arazzo1)
         );
-        this.plugins.forEach((p) => p.rules?.arazzo && arazzoRules.push(p.rules.arazzo));
-        this.plugins.forEach((p) => p.decorators?.arazzo && arazzoRules.push(p.decorators.arazzo));
-        return arazzoRules;
+        return arazzo1Rules;
     }
   }
 
@@ -356,6 +369,17 @@ export class StyleguideConfig {
   }
 }
 
+// To support backwards compatibility with the old `spec` key we rename it to `struct`.
+function replaceSpecWithStruct(ruleGroups: string[], config: Record<string, unknown>) {
+  for (const ruleGroup of ruleGroups) {
+    if (config[ruleGroup] && isPlainObject(config[ruleGroup]) && 'spec' in config[ruleGroup]) {
+      showWarningForDeprecatedField('spec', 'struct');
+      config[ruleGroup].struct = config[ruleGroup].spec;
+      delete config[ruleGroup].spec;
+    }
+  }
+}
+
 export class Config {
   apis: Record<string, ResolvedApi>;
   styleguide: StyleguideConfig;