@redocly/openapi-core 1.25.15 → 1.26.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @redocly/openapi-core
 
+## 1.26.0
+
+### Minor Changes
+
+- Introduced the `struct` rule and deprecated the `spec` rule.
+  Added the `spec` ruleset, which enforces compliance with the specifications.
+
+### Patch Changes
+
+- Updated `sourceDescriptions` to enforce a valid type field, ensuring compliance with the Arazzo specification.
+
 ## 1.25.15
 
 ### Patch Changes

package/__tests__/utils.ts

@@ -73,12 +73,10 @@ export async function makeConfig({
   rules,
   decorators,
   configPath,
-  arazzoRules,
 }: {
   rules: Record<string, RuleConfig>;
   decorators?: Record<string, DecoratorConfig>;
   configPath?: string;
-  arazzoRules?: Record<string, RuleConfig>;
 }) {
   return new StyleguideConfig(
     await resolveStyleguideConfig({
@@ -86,7 +84,6 @@ export async function makeConfig({
         plugins: [],
         extends: [],
         rules,
-        arazzoRules,
         decorators,
       },
     }),

package/lib/bundle.js

@@ -86,7 +86,7 @@ async function bundleDocument(opts) {
     const { document, config, customTypes, externalRefResolver, dereference = false, skipRedoclyRegistryRefs = false, removeUnusedComponents = false, keepUrlRefs = false, } = opts;
     const specVersion = (0, oas_types_1.detectSpec)(document.parsed);
     const specMajorVersion = (0, oas_types_1.getMajorSpecVersion)(specVersion);
-    const rules = config.getRulesForOasVersion(specMajorVersion);
+    const rules = config.getRulesForSpecVersion(specMajorVersion);
     const types = (0, types_1.normalizeTypes)(config.extendTypes(customTypes ?? (0, oas_types_1.getTypes)(specVersion), specVersion), config);
     const preprocessors = (0, rules_1.initRules)(rules, config, 'preprocessors', specVersion);
     const decorators = (0, rules_1.initRules)(rules, config, 'decorators', specVersion);
@@ -203,7 +203,7 @@ function mapTypeToComponent(typeName, version) {
                 default:
                     return null;
             }
-        case oas_types_1.SpecMajorVersion.Arazzo:
+        case oas_types_1.SpecMajorVersion.Arazzo1:
             switch (typeName) {
                 case 'Root.workflows_items.parameters_items':
                 case 'Root.workflows_items.steps_items.parameters_items':
@@ -296,7 +296,7 @@ function makeBundleVisitor(version, dereference, skipRedoclyRegistryRefs, rootDo
                 else if (version === oas_types_1.SpecMajorVersion.Async3) {
                     components = root.components = root.components || {};
                 }
-                else if (version === oas_types_1.SpecMajorVersion.Arazzo) {
+                else if (version === oas_types_1.SpecMajorVersion.Arazzo1) {
                     components = root.components = root.components || {};
                 }
             },

package/lib/config/all.js

@@ -2,52 +2,47 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const all = {
     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 = {
             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 = {
         '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 = {
             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 = {
         '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 = {
             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',
     },
 };
 exports.default = all;

package/lib/config/builtIn.d.ts

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

package/lib/config/builtIn.js

@@ -5,6 +5,7 @@ const recommended_1 = require("./recommended");
 const recommended_strict_1 = require("./recommended-strict");
 const all_1 = require("./all");
 const minimal_1 = require("./minimal");
+const spec_1 = require("./spec");
 const oas3_1 = require("../rules/oas3");
 const oas2_1 = require("../rules/oas2");
 const async2_1 = require("../rules/async2");
@@ -20,6 +21,7 @@ exports.builtInConfigs = {
     'recommended-strict': recommended_strict_1.default,
     minimal: minimal_1.default,
     all: all_1.default,
+    spec: spec_1.default,
     'redocly-registry': {
         decorators: { 'registry-dependencies': 'on' },
     },
@@ -31,21 +33,21 @@ exports.defaultPlugin = {
         oas2: oas2_1.rules,
         async2: async2_1.rules,
         async3: async3_1.rules,
-        arazzo: arazzo_1.rules,
+        arazzo1: arazzo_1.rules,
     },
     preprocessors: {
         oas3: oas3_1.preprocessors,
         oas2: oas2_1.preprocessors,
         async2: async2_1.preprocessors,
         async3: async3_1.preprocessors,
-        arazzo: arazzo_1.preprocessors,
+        arazzo1: arazzo_1.preprocessors,
     },
     decorators: {
         oas3: oas3_2.decorators,
         oas2: oas2_2.decorators,
         async2: async2_2.decorators,
         async3: async3_2.decorators,
-        arazzo: arazzo_2.decorators,
+        arazzo1: arazzo_2.decorators,
     },
     configs: exports.builtInConfigs,
 };

package/lib/config/config-resolvers.js

@@ -176,8 +176,8 @@ async function resolvePlugins(plugins, configDir = '') {
             if (pluginModule.rules.async3) {
                 plugin.rules.async3 = (0, utils_2.prefixRules)(pluginModule.rules.async3, id);
             }
-            if (pluginModule.rules.arazzo) {
-                plugin.rules.arazzo = (0, utils_2.prefixRules)(pluginModule.rules.arazzo, id);
+            if (pluginModule.rules.arazzo1) {
+                plugin.rules.arazzo1 = (0, utils_2.prefixRules)(pluginModule.rules.arazzo1, id);
             }
         }
         if (pluginModule.preprocessors) {
@@ -185,7 +185,7 @@ async function resolvePlugins(plugins, configDir = '') {
                 !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}.`);
             }
             plugin.preprocessors = {};
@@ -201,8 +201,8 @@ async function resolvePlugins(plugins, configDir = '') {
             if (pluginModule.preprocessors.async3) {
                 plugin.preprocessors.async3 = (0, utils_2.prefixRules)(pluginModule.preprocessors.async3, id);
             }
-            if (pluginModule.preprocessors.arazzo) {
-                plugin.preprocessors.arazzo = (0, utils_2.prefixRules)(pluginModule.preprocessors.arazzo, id);
+            if (pluginModule.preprocessors.arazzo1) {
+                plugin.preprocessors.arazzo1 = (0, utils_2.prefixRules)(pluginModule.preprocessors.arazzo1, id);
             }
         }
         if (pluginModule.decorators) {
@@ -210,7 +210,7 @@ async function resolvePlugins(plugins, configDir = '') {
                 !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}.`);
             }
             plugin.decorators = {};
@@ -226,8 +226,8 @@ async function resolvePlugins(plugins, configDir = '') {
             if (pluginModule.decorators.async3) {
                 plugin.decorators.async3 = (0, utils_2.prefixRules)(pluginModule.decorators.async3, id);
             }
-            if (pluginModule.decorators.arazzo) {
-                plugin.decorators.arazzo = (0, utils_2.prefixRules)(pluginModule.decorators.arazzo, id);
+            if (pluginModule.decorators.arazzo1) {
+                plugin.decorators.arazzo1 = (0, utils_2.prefixRules)(pluginModule.decorators.arazzo1, id);
             }
         }
         if (pluginModule.assertions) {
@@ -349,7 +349,7 @@ function getMergedRawStyleguideConfig(rootStyleguideConfig, apiStyleguideConfig)
         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/lib/config/config.d.ts

@@ -1,6 +1,6 @@
 import { SpecVersion, SpecMajorVersion } from '../oas-types';
 import type { NormalizedProblem } from '../walk';
-import type { Oas2RuleSet, Oas3RuleSet, Async3RuleSet, ArazzoRuleSet } from '../oas-types';
+import type { Oas2RuleSet, Oas3RuleSet, Async3RuleSet, Arazzo1RuleSet } from '../oas-types';
 import type { NodeType } from '../types';
 import type { DecoratorConfig, Plugin, PreprocessorConfig, Region, ResolveConfig, ResolvedApi, ResolvedConfig, ResolvedStyleguideConfig, RuleConfig, RuleSettings, Telemetry, ThemeRawConfig } from './types';
 export declare const IGNORE_FILE = ".redocly.lint-ignore.yaml";
@@ -32,7 +32,7 @@ export declare class StyleguideConfig {
         preprocessors: string[];
         decorators: string[];
     };
-    getRulesForOasVersion(version: SpecMajorVersion): Oas3RuleSet[] | Oas2RuleSet[] | Async3RuleSet[] | ArazzoRuleSet[];
+    getRulesForSpecVersion(version: SpecMajorVersion): Oas3RuleSet[] | Oas2RuleSet[] | Async3RuleSet[] | Arazzo1RuleSet[];
     skipRules(rules?: string[]): void;
     skipPreprocessors(preprocessors?: string[]): void;
     skipDecorators(decorators?: string[]): void;

package/lib/config/config.js

@@ -32,16 +32,23 @@ class StyleguideConfig {
         this.plugins = rawConfig.plugins || [];
         this.doNotResolveExamples = !!rawConfig.doNotResolveExamples;
         this.recommendedFallback = rawConfig.recommendedFallback || false;
+        const ruleGroups = [
+            'rules',
+            'oas2Rules',
+            'oas3_0Rules',
+            'oas3_1Rules',
+            'async2Rules',
+            'async3Rules',
+            'arazzo1Rules',
+        ];
+        replaceSpecWithStruct(ruleGroups, rawConfig);
         this.rules = {
             [oas_types_1.SpecVersion.OAS2]: { ...rawConfig.rules, ...rawConfig.oas2Rules },
             [oas_types_1.SpecVersion.OAS3_0]: { ...rawConfig.rules, ...rawConfig.oas3_0Rules },
             [oas_types_1.SpecVersion.OAS3_1]: { ...rawConfig.rules, ...rawConfig.oas3_1Rules },
             [oas_types_1.SpecVersion.Async2]: { ...rawConfig.rules, ...rawConfig.async2Rules },
             [oas_types_1.SpecVersion.Async3]: { ...rawConfig.rules, ...rawConfig.async3Rules },
-            [oas_types_1.SpecVersion.Arazzo]: {
-                ...(rawConfig.arazzoRules || {}),
-                ...(rawConfig.rules?.assertions ? { assertions: rawConfig.rules.assertions } : {}),
-            },
+            [oas_types_1.SpecVersion.Arazzo1]: { ...rawConfig.rules, ...rawConfig.arazzo1Rules },
         };
         this.preprocessors = {
             [oas_types_1.SpecVersion.OAS2]: { ...rawConfig.preprocessors, ...rawConfig.oas2Preprocessors },
@@ -49,7 +56,7 @@ class StyleguideConfig {
             [oas_types_1.SpecVersion.OAS3_1]: { ...rawConfig.preprocessors, ...rawConfig.oas3_1Preprocessors },
             [oas_types_1.SpecVersion.Async2]: { ...rawConfig.preprocessors, ...rawConfig.async2Preprocessors },
             [oas_types_1.SpecVersion.Async3]: { ...rawConfig.preprocessors, ...rawConfig.async3Preprocessors },
-            [oas_types_1.SpecVersion.Arazzo]: { ...rawConfig.arazzoPreprocessors },
+            [oas_types_1.SpecVersion.Arazzo1]: { ...rawConfig.arazzo1Preprocessors },
         };
         this.decorators = {
             [oas_types_1.SpecVersion.OAS2]: { ...rawConfig.decorators, ...rawConfig.oas2Decorators },
@@ -57,7 +64,7 @@ class StyleguideConfig {
             [oas_types_1.SpecVersion.OAS3_1]: { ...rawConfig.decorators, ...rawConfig.oas3_1Decorators },
             [oas_types_1.SpecVersion.Async2]: { ...rawConfig.decorators, ...rawConfig.async2Decorators },
             [oas_types_1.SpecVersion.Async3]: { ...rawConfig.decorators, ...rawConfig.async3Decorators },
-            [oas_types_1.SpecVersion.Arazzo]: { ...rawConfig.arazzoDecorators },
+            [oas_types_1.SpecVersion.Arazzo1]: { ...rawConfig.arazzo1Decorators },
         };
         this.extendPaths = rawConfig.extendPaths || [];
         this.pluginPaths = rawConfig.pluginPaths || [];
@@ -68,6 +75,7 @@ class StyleguideConfig {
             return;
         this.ignore =
             (0, js_yaml_1.parseYaml)(fs.readFileSync(ignoreFile, 'utf-8')) || {};
+        replaceSpecWithStruct(Object.keys(this.ignore), this.ignore);
         // resolve ignore paths
         for (const fileName of Object.keys(this.ignore)) {
             this.ignore[(0, ref_utils_1.isAbsoluteUrl)(fileName) ? fileName : path.resolve(path.dirname(ignoreFile), fileName)] = this.ignore[fileName];
@@ -143,10 +151,10 @@ class StyleguideConfig {
                             continue;
                         extendedTypes = plugin.typeExtension.async3(extendedTypes, version);
                         break;
-                    case oas_types_1.SpecVersion.Arazzo:
-                        if (!plugin.typeExtension.arazzo)
+                    case oas_types_1.SpecVersion.Arazzo1:
+                        if (!plugin.typeExtension.arazzo1)
                             continue;
-                        extendedTypes = plugin.typeExtension.arazzo(extendedTypes, version);
+                        extendedTypes = plugin.typeExtension.arazzo1(extendedTypes, version);
                         break;
                     default:
                         throw new Error('Not implemented');
@@ -209,43 +217,43 @@ class StyleguideConfig {
             decorators,
         };
     }
-    getRulesForOasVersion(version) {
+    getRulesForSpecVersion(version) {
         switch (version) {
             case oas_types_1.SpecMajorVersion.OAS3:
                 // eslint-disable-next-line no-case-declarations
-                const oas3Rules = []; // default ruleset
+                const oas3Rules = [];
                 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 oas_types_1.SpecMajorVersion.OAS2:
                 // eslint-disable-next-line no-case-declarations
-                const oas2Rules = []; // default ruleset
+                const oas2Rules = [];
                 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 oas_types_1.SpecMajorVersion.Async2:
                 // eslint-disable-next-line no-case-declarations
-                const asyncApi2Rules = []; // default ruleset
+                const asyncApi2Rules = [];
                 this.plugins.forEach((p) => p.preprocessors?.async2 && asyncApi2Rules.push(p.preprocessors.async2));
                 this.plugins.forEach((p) => p.rules?.async2 && asyncApi2Rules.push(p.rules.async2));
                 this.plugins.forEach((p) => p.decorators?.async2 && asyncApi2Rules.push(p.decorators.async2));
                 return asyncApi2Rules;
             case oas_types_1.SpecMajorVersion.Async3:
                 // eslint-disable-next-line no-case-declarations
-                const asyncApi3Rules = []; // default ruleset
+                const asyncApi3Rules = [];
                 this.plugins.forEach((p) => p.preprocessors?.async3 && asyncApi3Rules.push(p.preprocessors.async3));
                 this.plugins.forEach((p) => p.rules?.async3 && asyncApi3Rules.push(p.rules.async3));
                 this.plugins.forEach((p) => p.decorators?.async3 && asyncApi3Rules.push(p.decorators.async3));
                 return asyncApi3Rules;
-            case oas_types_1.SpecMajorVersion.Arazzo:
+            case oas_types_1.SpecMajorVersion.Arazzo1:
                 // eslint-disable-next-line no-case-declarations
-                const arazzoRules = []; // default ruleset
-                this.plugins.forEach((p) => p.preprocessors?.arazzo && arazzoRules.push(p.preprocessors.arazzo));
-                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;
+                const arazzo1Rules = [];
+                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.decorators?.arazzo1 && arazzo1Rules.push(p.decorators.arazzo1));
+                return arazzo1Rules;
         }
     }
     skipRules(rules) {
@@ -285,6 +293,16 @@ class StyleguideConfig {
     }
 }
 exports.StyleguideConfig = StyleguideConfig;
+// To support backwards compatibility with the old `spec` key we rename it to `struct`.
+function replaceSpecWithStruct(ruleGroups, config) {
+    for (const ruleGroup of ruleGroups) {
+        if (config[ruleGroup] && (0, utils_1.isPlainObject)(config[ruleGroup]) && 'spec' in config[ruleGroup]) {
+            (0, utils_1.showWarningForDeprecatedField)('spec', 'struct');
+            config[ruleGroup].struct = config[ruleGroup].spec;
+            delete config[ruleGroup].spec;
+        }
+    }
+}
 class Config {
     constructor(rawConfig, configFile) {
         this.rawConfig = rawConfig;