Update bun.lock and package.json to include new dependencies and version updates. Enhance README with build process instructions and usage examples for schema generation. Refactor OpenAPI type definitions for improved clarity and modularity across versions 2.0, 3.0, and 3.1.

2.0/example.ts

@@ -58,18 +58,18 @@ import type { Extension } from "./extensions";
  * };
  * ```
  */
-export interface Example extends Extension {
-	/**
-	 * The name of the property MUST be one of the Operation produces values
-	 * (either implicit or inherited). The value SHOULD be an example of what
-	 * such a response would look like.
-	 *
-	 * The property name corresponds to a MIME type that the operation can produce.
-	 * The value should be a realistic example of the response data in that format.
-	 *
-	 * @example { "application/json": { name: "Puma", type: "Dog" } }
-	 * @example { "application/xml": "<pet><name>Puma</name></pet>" }
-	 * @example { "text/plain": "Success" }
-	 */
-	[mimeType: string]: unknown;
+export interface Examples extends Extension {
+  /**
+   * The name of the property MUST be one of the Operation produces values
+   * (either implicit or inherited). The value SHOULD be an example of what
+   * such a response would look like.
+   *
+   * The property name corresponds to a MIME type that the operation can produce.
+   * The value should be a realistic example of the response data in that format.
+   *
+   * @example { "application/json": { name: "Puma", type: "Dog" } }
+   * @example { "application/xml": "<pet><name>Puma</name></pet>" }
+   * @example { "text/plain": "Success" }
+   */
+  [mimeType: string]: unknown;
 }