fix swagger $ref resolve error

[qazsato]

No description provided.

[Copilot]

Pull Request Overview

This PR centralizes OpenAPI parsing with proper $ref resolution, updates UI constants for consistency, and bumps related dependencies/templates to fix Swagger reference errors.

• Refactor parsing into src/utils/parser.js using @apidevtools/json-schema-ref-parser and fast-safe-stringify.
• Change UI constant from an array to an object, updating CLI validation and Inquirer defaults/choices.
• Update Swagger UI CDN links and bump json-schema-ref-parser and add fast-safe-stringify in package.json.

Reviewed Changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/utils/validate.js	Updated validateCommandUi to use Object.values(UI) and removed JSON/YAML helpers.
src/utils/parser.js	New parsing utility handling JSON/YAML, $ref resolution, and stringification.
src/index.js	Replaced inline parsing with parseOpenApi, adjusted imports and CLI UI options.
src/constants/index.js	Converted UI from array to object for named variants.
resources/swagger/template.ejs	Bumped Swagger UI CSS/JS versions to 5.26.2.
package.json	Upgraded @apidevtools/json-schema-ref-parser and added fast-safe-stringify.

Comments suppressed due to low confidence (2)

src/utils/parser.js:6

• Add unit tests for parseOpenApi covering JSON and YAML inputs, invalid formats, and both $ref resolution modes to ensure parsing logic is robust.

export async function parseOpenApi(rawApiDocsText, ui) {

src/utils/parser.js:6

• Consider adding JSDoc or comments to explain parameters and return values (e.g., that this returns a JSON string with resolved $ref pointers), which will aid future maintainers.

export async function parseOpenApi(rawApiDocsText, ui) {

[Copilot]

The non-Swagger branch uses JSON.stringify, which can fail on circular references; consider using fast-safe-stringify here as well for consistency and to avoid runtime errors.

Suggested change

	return JSON.stringify(apiDocs)
	return stringify(apiDocs)