feat: create new rule to enforce array parameters format

[IgorKarpiuk]

What/Why/How?

Create new rule array-parameter-serialization rule to enforce array parameters format.

This Rule enforces to define fields explode and style for parameter if param's schema type is array or has items or preffixItems

Reference

Testing

#1317

Screenshots (optional)

Check yourself

• Code is linted
• Tested with redoc/reference-docs/workflows (internal)
• All new/updated code is covered with tests

Security

• Security impact of change has been considered
• Code follows company security practices and guidelines

[changeset-bot]

🦋 Changeset detected

Latest commit: 2a4a1a8

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@redocly/openapi-core	Minor
@redocly/cli	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Command	Mean [s]	Min [s]	Max [s]	Relative
redocly lint packages/core/src/benchmark/benches/rebilly.yaml	1.038 ± 0.037	0.995	1.108	1.00 ± 0.05
redocly-next lint packages/core/src/benchmark/benches/rebilly.yaml	1.036 ± 0.030	0.994	1.084	1.00

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟡	Statements	76.17%	4068/5341
🟡	Branches	66.07%	2167/3280
🟡	Functions	68.39%	660/965
🟡	Lines	76.36%	3815/4996

Show new covered files 🐣

St.❔	File	Statements	Branches	Functions	Lines
🟢	... / array-parameter-serialization.ts	100%	88.89%	100%	100%

Test suite run success

652 tests passing in 94 suites.

Report generated by 🧪jest coverage report action from 2a4a1a8

[lornajane]

Could we get a changeset please?

The rule name doesn't need -rule in it, but the rest is good :)

[lornajane]

Minor changelog suggestion, I haven't tried the feature itself yet

[tatomyr]

Is it related? In what way?

[IgorKarpiuk]

I think so, we created this rule from similar configurable rules.

[lornajane]

I think I broke something! The following snippet does return as valid, which is correct:

      parameters:
        - name: f
          in: query
          style: label
          explode: true
          schema:
            type: array
            items:
              type: string

However if the explode field is set to false (it's boolean, so it might well be set to false!) then I get the error Parameter fshould havestyleandexplode fields. Could you take another look?

[IgorKarpiuk]

Thanks @lornajane I updated the code and added it to test

[lornajane]

Could we add a test where explode is defined, but false? When I do this on my local version, the rule fails.

[IgorKarpiuk]

@lornajane here is the test https://github.com/Redocly/redocly-cli/pull/1338/files#diff-4cf43b18ff2bdc2e4cdc694067da4ae9be20137568cc0196702c01433b0e0ebaR161

[lornajane]

Working as expected now (that failing link check is because we can't publish docs at the moment, so feel free to merge regardless)