fix: do not resolve $ref in examples.value

[vadyvas]

What/Why/How?

What: Stop resolving $ref inside Examples.value and dataValue (oas3.2) during bundling. Only resolve when the Example itself is a Reference Object, not when a $ref appears inside the literal value.
Why: Per OpenAPI spec and Redocly refs guide, Examples.value must be treated literally; resolving $ref there is incorrect.

openapi: 3.2.0
info:
  title: Test API
  version: 1.0.0
paths:
  /test:
    get:
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                example:
                  $ref: example.json # should resolve
              examples:
                Test:
                  value:
                    $ref: example.json # should NOT resolve

Reference

Fixes #1371

Testing

Added new unit and e2e tests

Screenshots (optional)

Check yourself

• Code changed? - Tested with Redoc/Realm/Reunite (internal)
• All new/updated code is covered by tests
• New package installed? - Tested in different environments (browser/node)
• Documentation update considered

Security

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

[changeset-bot]

🦋 Changeset detected

Latest commit: 2374fda

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

This PR includes changesets to release 3 packages

Name	Type
@redocly/openapi-core	Patch
@redocly/cli	Patch
@redocly/respect-core	Patch

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 resources/rebilly.yaml	1.438 ± 0.017	1.412	1.465	1.01 ± 0.02
redocly-next lint resources/rebilly.yaml	1.427 ± 0.020	1.395	1.464	1.00

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🟢	Lines	78.78% (🎯 78%)	5849 / 7424
🟢	Statements	78.21% (🎯 78%)	6044 / 7727
🟢	Functions	81.88% (🎯 81%)	1202 / 1468
🟢	Branches	71.05% (🎯 70%)	4050 / 5700

File Coverage

File	Stmts	Branches	Functions	Lines	Uncovered Lines
Changed Files
packages/core/src/types/index.ts	97.29%	92.3%	100%	97.29%	122
packages/core/src/types/oas3.ts	75.36%	31.81%	66.66%	75.36%	342, 349, 458-461, 492-516
packages/core/src/types/oas3_2.ts	52%	0%	0%	52%	39-126

Generated in workflow #7985 for commit 2374fda by the Vitest Coverage Report Action

[tatomyr]

Suggested change

	Fixed an issue where the content of `$ref`s inside `Examples.value` was erroneously resolved during bundling and linting.
	Fixed an issue where the content of `$ref`s inside example values was erroneously resolved during bundling and linting.

[tatomyr]

It also affects the CLI behaviour, so please mention it here as well.

[tatomyr]

It doesn't affect the Example type, only singular example properties.

[tatomyr]

Same here.

[tatomyr]

Suggested change

	id:
	type: integer
	name:
	type: string
	active:
	type: boolean
	$ref:
	type: string

[tatomyr]

Remove plz.