Enhance .gitignore, update dependencies, and improve CLI functionality

- Expanded .gitignore to include additional build outputs, environment files, and IDE configurations.
- Updated bun.lock to include new dependencies: js-yaml and its types.
- Refactored index.ts to export new validation functions and types for better modularity.
- Updated package.json to reflect version bump to 1.0.3, added repository and homepage information, and improved script commands.
- Enhanced README.md with clearer usage instructions and examples for library and CLI usage.
- Improved CLI commands for validation, parsing, and reporting, including support for multiple sources and detailed output options.
- Added logging functionality throughout the codebase for better debugging and user feedback.
- Implemented recursive validation and reference analysis features for comprehensive OpenAPI specification validation.

index.ts

@@ -4,7 +4,9 @@ export {
   parse,
   generateValidationReport,
   saveValidationReport,
-  validateMultiple,
+  validateWithReferences,
+  validateMultipleWithReferences,
+  analyzeDocumentReferences,
   getSupportedVersions,
   createVarsity,
   // Individual module exports
@@ -13,6 +15,16 @@ export {
   validateOpenAPISpec,
   generateReport,
   saveReport,
+  // Recursive validation exports
+  validateRecursively,
+  validateMultipleRecursively,
+  analyzeReferences,
+  // Reference resolver exports
+  resolveReference,
+  findReferences,
+  resolveAllReferences,
+  // Partial validation exports
+  validatePartialDocument,
 } from "./src/varsity.js";
 
 // Type exports
@@ -25,7 +37,14 @@ export type {
   VarsityConfig,
   OpenAPIVersion,
   CLIResult,
+  RecursiveValidationResult,
 } from "./src/types.js";
 
+// Export types from other modules
+export type {
+  ResolvedReference,
+  ReferenceContext,
+} from "./src/ref-resolver.js";
+
 // Default export - functional instance
 export { default } from "./src/varsity.js";