Various Fixes

[tjprescott]

• Fixes Elements in an array are the same but in a different order and this is marked as a diff #56.
• Fixes issue where local references weren't resolved that had the dash (-) character.
• Fixes issue with resolving references when using the --compile-tsp flag. This will usually require passing --lhs-root or, more commonly, --rhs-root.

TODO

• Make --lhs/rhs-root a temp folder instead of relying on the user to specify a correct path.
• Consider ramifications of the array sorting rule

[Copilot]

Pull Request Overview

This PR fixes issues related to unresolved local references containing dashes, improves handling for compiling TypeSpec by introducing temporary root folders, and updates documentation and versioning accordingly.

• Implements a new rule to ignore equivalent arrays by sorting string arrays before comparison.
• Updates diff-client and util modules to support temporary root folder creation and proper reference resolution.
• Revises documentation (CHANGELOG and README) and bumps version to 0.2.0.

Reviewed Changes

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

Show a summary per file

File	Description
src/rules/ignore-equivalent-arrays.ts	Introduces a rule to ignore array diffs affected by sorting differences.
src/diff-client.ts	Adds temporary folder logic for compiling TypeSpec and cleans up after processing.
src/util.ts	Adjusts utility functions to pass and use rootPath; improves regex for local refs.
CHANGELOG.md & README.md	Updates documentation to reflect the fixes and new CLI options.
src/version.ts	Bumps version to 0.2.0.
src/main.ts	Adds command line options for lhs-root and rhs-root.
Test files	Updates tests to pass rootPath parameter and cover new sorting behavior.
src/definitions.ts	Enhances error message text for unsupported allOf scenarios.
src/parser.ts	Updates parser creation to accommodate the new rootPath parameter.
src/rules/rules.ts	Adds ignoreEquivalentArrays to the list of applicable rules.

Comments suppressed due to low confidence (1)

src/util.ts:207

• The regex update now includes a dash in the character set. Please verify that this change correctly captures all valid local reference patterns without matching unintended strings.

const localRefRegex = /"\$ref": "(#\/\w+\/[\w\-\.]+)"/gm;

[Copilot]

Consider wrapping the temporary folder deletion in a try-catch block to handle potential filesystem errors during cleanup, ensuring that an exception does not disrupt the rest of the process.

Suggested change

	fs.rmdirSync(this.tempRhsRoot, { recursive: true });
	try {
	fs.rmdirSync(this.tempRhsRoot, { recursive: true });
	} catch (error) {
	console.error(`ERROR: Failed to delete temporary folder '${this.tempRhsRoot}':`, error);
	}