@redocly/openapi-core/src/rules/common/path-segment-plural.ts

See https://github.com/Redocly/redocly-cli

import * as pluralize from 'pluralize';
import { isPathParameter } from '../../utils';

import type { Oas3Rule, Oas2Rule } from '../../visitors';
import type { UserContext } from '../../walk';

export const PathSegmentPlural: Oas3Rule | Oas2Rule = (opts) => {
  const { ignoreLastPathSegment, exceptions } = opts;
  return {
    PathItem: {
      leave(_path: any, { report, key, location }: UserContext) {
        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 (!isPathParameter(pathSegment) && pluralize.isSingular(pathSegment)) {
              report({
                message: `path segment \`${pathSegment}\` should be plural.`,
                location: location.key(),
              });
            }
          }
        }
      },
    },
  };
};