@redocly/openapi-core 1.0.0-beta.64 → 1.0.0-beta.68

package/lib/rules/common/path-segment-plural.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathSegmentPlural = void 0;
+const utils_1 = require("../../utils");
+const PathSegmentPlural = (opts) => {
+    const { ignoreLastPathSegment, exceptions } = opts;
+    return {
+        PathItem: {
+            leave(_path, { report, key, location }) {
+                const pathKey = key.toString();
+                if (pathKey.startsWith('/')) {
+                    const pathSegments = pathKey.split('/');
+                    pathSegments.shift();
+                    if (ignoreLastPathSegment && pathSegments.length > 1) {
+                        pathSegments.pop();
+                    }
+                    for (const pathSegment of pathSegments) {
+                        if (exceptions && exceptions.includes(pathSegment))
+                            continue;
+                        if (!utils_1.isPathParameter(pathSegment) && utils_1.isSingular(pathSegment)) {
+                            report({
+                                message: `path segment \`${pathSegment}\` should be plural.`,
+                                location: location.key(),
+                            });
+                        }
+                    }
+                }
+            },
+        },
+    };
+};
+exports.PathSegmentPlural = PathSegmentPlural;

package/lib/rules/common/tag-description-override.d.ts

@@ -0,0 +1,2 @@
+import { Oas3Decorator, Oas2Decorator } from '../../visitors';
+export declare const TagDescriptionOverride: Oas3Decorator | Oas2Decorator;

package/lib/rules/common/tag-description-override.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TagDescriptionOverride = void 0;
+const utils_1 = require("../../utils");
+const TagDescriptionOverride = ({ tagNames }) => {
+    return {
+        Tag: {
+            leave(tag, { report }) {
+                if (!tagNames)
+                    throw new Error(`Parameter "tagNames" is not provided for "tag-description-override" rule`);
+                if (tagNames[tag.name]) {
+                    try {
+                        tag.description = utils_1.readFileAsStringSync(tagNames[tag.name]);
+                    }
+                    catch (e) {
+                        report({
+                            message: `Failed to read markdown override file for tag "${tag.name}".\n${e.message}`,
+                        });
+                    }
+                }
+            },
+        },
+    };
+};
+exports.TagDescriptionOverride = TagDescriptionOverride;

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

@@ -12,6 +12,7 @@ export declare const rules: {
     'boolean-parameter-prefixes': Oas2Rule;
     'no-path-trailing-slash': Oas2Rule;
     'operation-2xx-response': Oas2Rule;
+    'operation-4xx-response': Oas2Rule;
     'operation-operationId-unique': Oas2Rule;
     'operation-parameters-unique': Oas2Rule;
     'path-parameters-defined': Oas2Rule;
@@ -30,8 +31,16 @@ export declare const rules: {
     'no-identical-paths': Oas2Rule;
     'no-ambiguous-paths': Oas2Rule;
     'path-http-verbs-order': Oas2Rule;
+    'no-http-verbs-in-paths': Oas2Rule;
+    'path-excludes-patterns': Oas2Rule;
+    'request-mime-type': Oas2Rule;
+    'response-mime-type': Oas2Rule;
+    'path-segment-plural': Oas2Rule;
 };
 export declare const preprocessors: {};
 export declare const decorators: {
     'registry-dependencies': Oas2Decorator;
+    'operation-description-override': Oas2Decorator;
+    'tag-description-override': Oas2Decorator;
+    'info-description-override': Oas2Decorator;
 };

package/lib/rules/oas2/index.js

@@ -13,6 +13,7 @@ const paths_kebab_case_1 = require("../common/paths-kebab-case");
 const no_enum_type_mismatch_1 = require("../common/no-enum-type-mismatch");
 const no_path_trailing_slash_1 = require("../common/no-path-trailing-slash");
 const operation_2xx_response_1 = require("../common/operation-2xx-response");
+const operation_4xx_response_1 = require("../common/operation-4xx-response");
 const operation_operationId_unique_1 = require("../common/operation-operationId-unique");
 const operation_parameters_unique_1 = require("../common/operation-parameters-unique");
 const path_params_defined_1 = require("../common/path-params-defined");
@@ -31,6 +32,14 @@ const no_identical_paths_1 = require("../common/no-identical-paths");
 const operation_operationId_1 = require("../common/operation-operationId");
 const operation_summary_1 = require("../common/operation-summary");
 const no_ambiguous_paths_1 = require("../common/no-ambiguous-paths");
+const no_http_verbs_in_paths_1 = require("../common/no-http-verbs-in-paths");
+const path_excludes_patterns_1 = require("../common/path-excludes-patterns");
+const request_mime_type_1 = require("./request-mime-type");
+const response_mime_type_1 = require("./response-mime-type");
+const path_segment_plural_1 = require("../common/path-segment-plural");
+const operation_description_override_1 = require("../common/operation-description-override");
+const tag_description_override_1 = require("../common/tag-description-override");
+const info_description_override_1 = require("../common/info-description-override");
 exports.rules = {
     spec: spec_1.OasSpec,
     'info-description': info_description_1.InfoDescription,
@@ -44,6 +53,7 @@ exports.rules = {
     'boolean-parameter-prefixes': boolean_parameter_prefixes_1.BooleanParameterPrefixes,
     'no-path-trailing-slash': no_path_trailing_slash_1.NoPathTrailingSlash,
     'operation-2xx-response': operation_2xx_response_1.Operation2xxResponse,
+    'operation-4xx-response': operation_4xx_response_1.Operation4xxResponse,
     'operation-operationId-unique': operation_operationId_unique_1.OperationIdUnique,
     'operation-parameters-unique': operation_parameters_unique_1.OperationParametersUnique,
     'path-parameters-defined': path_params_defined_1.PathParamsDefined,
@@ -62,8 +72,16 @@ exports.rules = {
     'no-identical-paths': no_identical_paths_1.NoIdenticalPaths,
     'no-ambiguous-paths': no_ambiguous_paths_1.NoAmbiguousPaths,
     'path-http-verbs-order': path_http_verbs_order_1.PathHttpVerbsOrder,
+    'no-http-verbs-in-paths': no_http_verbs_in_paths_1.NoHttpVerbsInPaths,
+    'path-excludes-patterns': path_excludes_patterns_1.PathExcludesPatterns,
+    'request-mime-type': request_mime_type_1.RequestMimeType,
+    'response-mime-type': response_mime_type_1.ResponseMimeType,
+    'path-segment-plural': path_segment_plural_1.PathSegmentPlural,
 };
 exports.preprocessors = {};
 exports.decorators = {
     'registry-dependencies': registry_dependencies_1.RegistryDependencies,
+    'operation-description-override': operation_description_override_1.OperationDescriptionOverride,
+    'tag-description-override': tag_description_override_1.TagDescriptionOverride,
+    'info-description-override': info_description_override_1.InfoDescriptionOverride,
 };

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

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

package/lib/rules/oas2/request-mime-type.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestMimeType = void 0;
+const utils_1 = require("../../utils");
+const RequestMimeType = ({ allowedValues }) => {
+    return {
+        DefinitionRoot(root, ctx) {
+            utils_1.validateMimeType({ type: 'consumes', value: root }, ctx, allowedValues);
+        },
+        Operation: {
+            leave(operation, ctx) {
+                utils_1.validateMimeType({ type: 'consumes', value: operation }, ctx, allowedValues);
+            },
+        },
+    };
+};
+exports.RequestMimeType = RequestMimeType;

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

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

package/lib/rules/oas2/response-mime-type.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseMimeType = void 0;
+const utils_1 = require("../../utils");
+const ResponseMimeType = ({ allowedValues }) => {
+    return {
+        DefinitionRoot(root, ctx) {
+            utils_1.validateMimeType({ type: 'produces', value: root }, ctx, allowedValues);
+        },
+        Operation: {
+            leave(operation, ctx) {
+                utils_1.validateMimeType({ type: 'produces', value: operation }, ctx, allowedValues);
+            },
+        },
+    };
+};
+exports.ResponseMimeType = ResponseMimeType;

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

@@ -4,4 +4,7 @@ export declare const rules: Oas3RuleSet;
 export declare const preprocessors: {};
 export declare const decorators: {
     'registry-dependencies': Oas3Decorator;
+    'operation-description-override': Oas3Decorator;
+    'tag-description-override': Oas3Decorator;
+    'info-description-override': Oas3Decorator;
 };

package/lib/rules/oas3/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.decorators = exports.preprocessors = exports.rules = void 0;
 const spec_1 = require("../common/spec");
 const operation_2xx_response_1 = require("../common/operation-2xx-response");
+const operation_4xx_response_1 = require("../common/operation-4xx-response");
 const operation_operationId_unique_1 = require("../common/operation-operationId-unique");
 const operation_parameters_unique_1 = require("../common/operation-parameters-unique");
 const path_params_defined_1 = require("../common/path-params-defined");
@@ -39,6 +40,14 @@ const operation_operationId_1 = require("../common/operation-operationId");
 const operation_summary_1 = require("../common/operation-summary");
 const no_ambiguous_paths_1 = require("../common/no-ambiguous-paths");
 const no_servers_empty_enum_1 = require("./no-servers-empty-enum");
+const no_http_verbs_in_paths_1 = require("../common/no-http-verbs-in-paths");
+const request_mime_type_1 = require("./request-mime-type");
+const response_mime_type_1 = require("./response-mime-type");
+const path_segment_plural_1 = require("../common/path-segment-plural");
+const operation_description_override_1 = require("../common/operation-description-override");
+const tag_description_override_1 = require("../common/tag-description-override");
+const info_description_override_1 = require("../common/info-description-override");
+const path_excludes_patterns_1 = require("../common/path-excludes-patterns");
 exports.rules = {
     spec: spec_1.OasSpec,
     'info-description': info_description_1.InfoDescription,
@@ -46,6 +55,7 @@ exports.rules = {
     'info-license': info_license_url_1.InfoLicense,
     'info-license-url': license_url_1.InfoLicenseUrl,
     'operation-2xx-response': operation_2xx_response_1.Operation2xxResponse,
+    'operation-4xx-response': operation_4xx_response_1.Operation4xxResponse,
     'operation-operationId-unique': operation_operationId_unique_1.OperationIdUnique,
     'operation-parameters-unique': operation_parameters_unique_1.OperationParametersUnique,
     'path-parameters-defined': path_params_defined_1.PathParamsDefined,
@@ -77,9 +87,17 @@ exports.rules = {
     'no-identical-paths': no_identical_paths_1.NoIdenticalPaths,
     'no-ambiguous-paths': no_ambiguous_paths_1.NoAmbiguousPaths,
     'no-undefined-server-variable': no_undefined_server_variable_1.NoUndefinedServerVariable,
-    'no-servers-empty-enum': no_servers_empty_enum_1.NoEmptyEnumServers
+    'no-servers-empty-enum': no_servers_empty_enum_1.NoEmptyEnumServers,
+    'no-http-verbs-in-paths': no_http_verbs_in_paths_1.NoHttpVerbsInPaths,
+    'path-excludes-patterns': path_excludes_patterns_1.PathExcludesPatterns,
+    'request-mime-type': request_mime_type_1.RequestMimeType,
+    'response-mime-type': response_mime_type_1.ResponseMimeType,
+    'path-segment-plural': path_segment_plural_1.PathSegmentPlural,
 };
 exports.preprocessors = {};
 exports.decorators = {
     'registry-dependencies': registry_dependencies_1.RegistryDependencies,
+    'operation-description-override': operation_description_override_1.OperationDescriptionOverride,
+    'tag-description-override': tag_description_override_1.TagDescriptionOverride,
+    'info-description-override': info_description_override_1.InfoDescriptionOverride,
 };

package/lib/rules/oas3/no-server-trailing-slash.js

@@ -6,7 +6,7 @@ const NoServerTrailingSlash = () => {
         Server(server, { report, location }) {
             if (!server.url)
                 return;
-            if (server.url.endsWith('/')) {
+            if (server.url.endsWith('/') && server.url !== '/') {
                 report({
                     message: 'Server `url` should not have a trailing slash.',
                     location: location.child(['url']),

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

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

package/lib/rules/oas3/request-mime-type.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestMimeType = void 0;
+const utils_1 = require("../../utils");
+const RequestMimeType = ({ allowedValues }) => {
+    return {
+        PathMap: {
+            RequestBody: {
+                leave(requestBody, ctx) {
+                    utils_1.validateMimeTypeOAS3({ type: 'consumes', value: requestBody }, ctx, allowedValues);
+                },
+            },
+            Callback: {
+                RequestBody() { },
+                Response: {
+                    leave(response, ctx) {
+                        utils_1.validateMimeTypeOAS3({ type: 'consumes', value: response }, ctx, allowedValues);
+                    },
+                },
+            },
+        },
+        WebhooksMap: {
+            Response: {
+                leave(response, ctx) {
+                    utils_1.validateMimeTypeOAS3({ type: 'consumes', value: response }, ctx, allowedValues);
+                },
+            },
+        },
+    };
+};
+exports.RequestMimeType = RequestMimeType;

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

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

package/lib/rules/oas3/response-mime-type.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseMimeType = void 0;
+const utils_1 = require("../../utils");
+const ResponseMimeType = ({ allowedValues }) => {
+    return {
+        PathMap: {
+            Response: {
+                leave(response, ctx) {
+                    utils_1.validateMimeTypeOAS3({ type: 'produces', value: response }, ctx, allowedValues);
+                },
+            },
+            Callback: {
+                Response() { },
+                RequestBody: {
+                    leave(requestBody, ctx) {
+                        utils_1.validateMimeTypeOAS3({ type: 'produces', value: requestBody }, ctx, allowedValues);
+                    },
+                },
+            },
+        },
+        WebhooksMap: {
+            RequestBody: {
+                leave(requestBody, ctx) {
+                    utils_1.validateMimeTypeOAS3({ type: 'produces', value: requestBody }, ctx, allowedValues);
+                },
+            },
+        },
+    };
+};
+exports.ResponseMimeType = ResponseMimeType;

package/lib/types/oas3_1.js

@@ -94,6 +94,12 @@ const Operation = {
 };
 const Schema = {
     properties: {
+        $id: { type: 'string' },
+        id: { type: 'string' },
+        $schema: { type: 'string' },
+        definitions: 'NamedSchemas',
+        $defs: 'NamedSchemas',
+        $vocabulary: { type: 'string' },
         externalDocs: 'ExternalDocs',
         discriminator: 'Discriminator',
         myArbitraryKeyword: { type: 'boolean' },

package/lib/utils.d.ts

@@ -1,4 +1,5 @@
 import { HttpResolveConfig } from './config/config';
+import { UserContext } from './walk';
 export { parseYaml, stringifyYaml } from './js-yaml';
 export declare type StackFrame<T> = {
     prev: StackFrame<T> | null;
@@ -22,3 +23,13 @@ export declare function readFileFromUrl(url: string, config: HttpResolveConfig):
 export declare function match(url: string, pattern: string): boolean;
 export declare function pickObjectProps<T extends Record<string, unknown>>(object: T, keys: Array<string>): T;
 export declare function omitObjectProps<T extends Record<string, unknown>>(object: T, keys: Array<string>): T;
+export declare function splitCamelCaseIntoWords(str: string): Set<string>;
+export declare function validateMimeType({ type, value }: any, { report, location }: UserContext, allowedValues: string[]): void;
+export declare function validateMimeTypeOAS3({ type, value }: any, { report, location }: UserContext, allowedValues: string[]): void;
+export declare function isSingular(path: string): boolean;
+export declare function readFileAsStringSync(filePath: string): string;
+export declare function isPathParameter(pathSegment: string): boolean;
+/**
+ * Convert Windows backslash paths to slash paths: foo\\bar ➔ foo/bar
+ */
+export declare function slash(path: string): string;

package/lib/utils.js

@@ -9,10 +9,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.omitObjectProps = exports.pickObjectProps = exports.match = exports.readFileFromUrl = exports.isPlainObject = exports.notUndefined = exports.loadYaml = exports.popStack = exports.pushStack = exports.stringifyYaml = exports.parseYaml = void 0;
+exports.slash = exports.isPathParameter = exports.readFileAsStringSync = exports.isSingular = exports.validateMimeTypeOAS3 = exports.validateMimeType = exports.splitCamelCaseIntoWords = exports.omitObjectProps = exports.pickObjectProps = exports.match = exports.readFileFromUrl = exports.isPlainObject = exports.notUndefined = exports.loadYaml = exports.popStack = exports.pushStack = exports.stringifyYaml = exports.parseYaml = void 0;
 const fs = require("fs");
 const minimatch = require("minimatch");
 const node_fetch_1 = require("node-fetch");
+const pluralize = require("pluralize");
 const js_yaml_1 = require("./js-yaml");
 var js_yaml_2 = require("./js-yaml");
 Object.defineProperty(exports, "parseYaml", { enumerable: true, get: function () { return js_yaml_2.parseYaml; } });
@@ -76,3 +77,70 @@ function omitObjectProps(object, keys) {
     return Object.fromEntries(Object.entries(object).filter(([key]) => !keys.includes(key)));
 }
 exports.omitObjectProps = omitObjectProps;
+function splitCamelCaseIntoWords(str) {
+    const camel = str
+        .split(/(?:[-._])|([A-Z][a-z]+)/)
+        .filter(Boolean)
+        .map((item) => item.toLocaleLowerCase());
+    const caps = str
+        .split(/([A-Z]{2,})/)
+        .filter((e) => e && e === e.toUpperCase())
+        .map((item) => item.toLocaleLowerCase());
+    return new Set([...camel, ...caps]);
+}
+exports.splitCamelCaseIntoWords = splitCamelCaseIntoWords;
+function validateMimeType({ type, value }, { report, location }, allowedValues) {
+    const ruleType = type === 'consumes' ? 'request' : 'response';
+    if (!allowedValues)
+        throw new Error(`Parameter "allowedValues" is not provided for "${ruleType}-mime-type" rule`);
+    if (!value[type])
+        return;
+    for (const mime of value[type]) {
+        if (!allowedValues.includes(mime)) {
+            report({
+                message: `Mime type "${mime}" is not allowed`,
+                location: location.child(value[type].indexOf(mime)).key(),
+            });
+        }
+    }
+}
+exports.validateMimeType = validateMimeType;
+function validateMimeTypeOAS3({ type, value }, { report, location }, allowedValues) {
+    const ruleType = type === 'consumes' ? 'request' : 'response';
+    if (!allowedValues)
+        throw new Error(`Parameter "allowedValues" is not provided for "${ruleType}-mime-type" rule`);
+    if (!value.content)
+        return;
+    for (const mime of Object.keys(value.content)) {
+        if (!allowedValues.includes(mime)) {
+            report({
+                message: `Mime type "${mime}" is not allowed`,
+                location: location.child('content').child(mime).key(),
+            });
+        }
+    }
+}
+exports.validateMimeTypeOAS3 = validateMimeTypeOAS3;
+function isSingular(path) {
+    return pluralize.isSingular(path);
+}
+exports.isSingular = isSingular;
+function readFileAsStringSync(filePath) {
+    return fs.readFileSync(filePath, 'utf-8');
+}
+exports.readFileAsStringSync = readFileAsStringSync;
+function isPathParameter(pathSegment) {
+    return pathSegment.startsWith('{') && pathSegment.endsWith('{');
+}
+exports.isPathParameter = isPathParameter;
+/**
+ * Convert Windows backslash paths to slash paths: foo\\bar ➔ foo/bar
+ */
+function slash(path) {
+    const isExtendedLengthPath = /^\\\\\?\\/.test(path);
+    if (isExtendedLengthPath) {
+        return path;
+    }
+    return path.replace(/\\/g, '/');
+}
+exports.slash = slash;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/openapi-core",
-  "version": "1.0.0-beta.64",
+  "version": "1.0.0-beta.68",
   "description": "",
   "main": "lib/index.js",
   "engines": {
@@ -30,7 +30,7 @@
     "Andriy Leliv <andriy@redoc.ly> (https://redoc.ly/)"
   ],
   "dependencies": {
-    "@redocly/ajv": "^8.6.2",
+    "@redocly/ajv": "^8.6.4",
     "@types/node": "^14.11.8",
     "colorette": "^1.2.0",
     "js-levenshtein": "^1.1.6",
@@ -38,6 +38,7 @@
     "lodash.isequal": "^4.5.0",
     "minimatch": "^3.0.4",
     "node-fetch": "^2.6.1",
+    "pluralize": "^8.0.0",
     "yaml-ast-parser": "0.0.43"
   },
   "devDependencies": {
@@ -46,6 +47,7 @@
     "@types/lodash.isequal": "^4.5.5",
     "@types/minimatch": "^3.0.3",
     "@types/node-fetch": "^2.5.7",
+    "@types/pluralize": "^0.0.29",
     "typescript": "^4.0.5"
   }
 }

package/src/__tests__/utils.test.ts

@@ -1,4 +1,4 @@
-import { pickObjectProps, omitObjectProps } from '../utils';
+import { pickObjectProps, omitObjectProps, slash } from '../utils';
 
 describe('utils', () => {
   const testObject = {
@@ -53,4 +53,22 @@ describe('utils', () => {
       expect(omitObjectProps({}, ['d', 'e'])).toStrictEqual({});
     });
   });
+
+  describe('slash path', () => {
+    it('can correctly slash path', () => {
+      [
+        ['foo\\bar', 'foo/bar'],
+        ['foo/bar', 'foo/bar'],
+        ['foo\\中文', 'foo/中文'],
+        ['foo/中文', 'foo/中文'],
+      ].forEach(([path, expectRes]) => {
+        expect(slash(path)).toBe(expectRes);
+      });
+    });
+
+    it('does not modify extended length paths', () => {
+      const extended = '\\\\?\\some\\path';
+      expect(slash(extended)).toBe(extended);
+    });
+  });
 });

package/src/bundle.ts

@@ -7,7 +7,7 @@ import { Oas3_1Types } from './types/oas3_1';
 import { NormalizedNodeType, normalizeTypes, NodeType } from './types';
 import { WalkContext, walkDocument, UserContext, ResolveResult } from './walk';
 import { detectOpenAPI, openAPIMajor, OasMajorVersion } from './oas-types';
-import { Location, refBaseName } from './ref-utils';
+import { isRef, Location, refBaseName } from './ref-utils';
 import type { Config, LintConfig } from './config/config';
 import { initRules } from './config/rules';
 import { reportUnresolvedRef } from './rules/no-unresolved-refs';
@@ -40,7 +40,8 @@ export async function bundle(opts: {
     throw new Error('Document or reference is required.\n');
   }
 
-  const document = doc !== undefined ? doc : await externalRefResolver.resolveDocument(base, ref!, true);
+  const document =
+    doc !== undefined ? doc : await externalRefResolver.resolveDocument(base, ref!, true);
 
   if (document instanceof Error) {
     throw document;
@@ -69,7 +70,11 @@ export async function bundleDocument(opts: {
   const rules = config.getRulesForOasVersion(oasMajorVersion);
   const types = normalizeTypes(
     config.extendTypes(
-      customTypes ?? oasMajorVersion === OasMajorVersion.Version3 ? (oasVersion === OasVersion.Version3_1 ? Oas3_1Types : Oas3Types) : Oas2Types,
+      customTypes ?? oasMajorVersion === OasMajorVersion.Version3
+        ? oasVersion === OasVersion.Version3_1
+          ? Oas3_1Types
+          : Oas3Types
+        : Oas2Types,
       oasVersion,
     ),
     config,
@@ -249,6 +254,21 @@ function makeBundleVisitor(version: OasMajorVersion, dereference: boolean, rootD
     }
   }
 
+  function isEqualOrEqualRef(
+    node: any,
+    target: { node: any; location: Location },
+    ctx: UserContext,
+  ) {
+    if (
+      isRef(node) &&
+      ctx.resolve(node).location?.absolutePointer === target.location.absolutePointer
+    ) {
+      return true;
+    }
+
+    return isEqual(node, target.node);
+  }
+
   function getComponentName(
     target: { node: any; location: Location },
     componentType: string,
@@ -265,20 +285,20 @@ function makeBundleVisitor(version: OasMajorVersion, dereference: boolean, rootD
       if (
         !componentsGroup ||
         !componentsGroup[name] ||
-        isEqual(componentsGroup[name], target.node)
+        isEqualOrEqualRef(componentsGroup[name], target, ctx)
       ) {
         return name;
       }
     }
 
     name = refBaseName(fileRef) + (name ? `_${name}` : '');
-    if (!componentsGroup[name] || isEqual(componentsGroup[name], target.node)) {
+    if (!componentsGroup[name] || isEqualOrEqualRef(componentsGroup[name], target, ctx)) {
       return name;
     }
 
     const prevName = name;
     let serialId = 2;
-    while (componentsGroup[name] && !isEqual(componentsGroup[name], target.node)) {
+    while (componentsGroup[name] && !isEqualOrEqualRef(componentsGroup[name], target, ctx)) {
       name = `${prevName}-${serialId}`;
       serialId++;
     }

package/src/config/all.ts

@@ -12,11 +12,13 @@ export default {
     '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',
     'operation-summary': 'error',
     'operation-operationId-unique': 'error',
@@ -29,6 +31,12 @@ export default {
     'no-enum-type-mismatch': 'error',
     'boolean-parameter-prefixes': 'error',
     'paths-kebab-case': 'error',
+    'no-http-verbs-in-paths': 'error',
+    'path-excludes-patterns': {
+      severity: 'error',
+      patterns: [],
+    },
+    'request-mime-type': 'error',
     spec: 'error',
   },
   oas3_0Rules: {
@@ -49,5 +57,5 @@ export default {
     'no-unused-components': 'error',
     'no-undefined-server-variable': 'error',
     'no-servers-empty-enum': 'error',
-  }
+  },
 } as LintRawConfig;

package/src/config/config.ts

@@ -4,7 +4,7 @@ import { dirname } from 'path';
 import { red, blue } from 'colorette';
 
 import { parseYaml, stringifyYaml } from '../js-yaml';
-import { notUndefined } from '../utils';
+import { notUndefined, slash } from '../utils';
 
 import {
   OasVersion,
@@ -211,7 +211,7 @@ export class LintConfig {
     const ignoreFile = path.join(dir, IGNORE_FILE);
     const mapped: Record<string, any> = {};
     for (const absFileName of Object.keys(this.ignore)) {
-      const ignoredRules = (mapped[path.relative(dir, absFileName)] = this.ignore[absFileName]);
+      const ignoredRules = (mapped[slash(path.relative(dir, absFileName))] = this.ignore[absFileName]);
       for (const ruleId of Object.keys(ignoredRules)) {
         ignoredRules[ruleId] = Array.from(ignoredRules[ruleId]) as any;
       }

package/src/config/minimal.ts

@@ -17,6 +17,7 @@ export default {
     'path-parameters-defined': 'warn',
     'operation-description': 'off',
     'operation-2xx-response': 'warn',
+    'operation-4xx-response': 'off',
     'operation-operationId': 'warn',
     'operation-summary': 'warn',
     'operation-operationId-unique': 'warn',

package/src/config/recommended.ts

@@ -17,6 +17,7 @@ export default {
     'path-parameters-defined': 'error',
     'operation-description': 'off',
     'operation-2xx-response': 'warn',
+    'operation-4xx-response': 'warn',
     'operation-operationId': 'warn',
     'operation-summary': 'error',
     'operation-operationId-unique': 'error',