explicit separate support for oas 3.0 and oas 3.1 from issue #90 + add …

…@deprecate jsdoc + update docs

update libs + normalize file names

Changelog.md

@@ -1,5 +1,11 @@
 # Changelog: openapi3-ts
 
+## Version 4.0.0  
+
+2023.03.27
+
+- Breaking change. Adds explicit support for OAS 3.0 and OAS 3.1 as separate implementations.
+
 ## Version 3.2.0
 
 - PR [#94](https://github.com/metadevpro/openapi3-ts/pull/94) Export type `SchemaObjectType`.

README.md

@@ -8,6 +8,12 @@ TypeScript library to help building OpenAPI 3.x compliant API contracts.
 
 [![NPM](https://nodei.co/npm/openapi3-ts.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/openapi3-ts/)
 
+## Version 4
+
+*Breaking change notice:*
+
+Version 4.0 Adds explicit support for OAS 3.0 and OAS 3.1 as separate implementations.
+
 ## Includes
 
 * `/src/model` TS typed interfaces for helping building a contract.
@@ -37,4 +43,4 @@ Licensed under the MIT License.
 
 **Contact:** Pedro J. Molina | github: [pjmolina](https://github.com/pjmolina) | twitter: [pmolinam](https://twitter.com/pmolinam)
 
-(c) 2017-2022. [Pedro J. Molina](http://pjmolina.com) at Metadev S.L. [https://metadev.pro](https://metadev.pro) & contributors.
+(c) 2017-2023. [Pedro J. Molina](http://pjmolina.com) at Metadev S.L. [https://metadev.pro](https://metadev.pro) & contributors.

package.json

@@ -1,6 +1,6 @@
 {
     "name": "openapi3-ts",
-    "version": "3.2.0",
+    "version": "4.0.0",
     "description": "TS Model & utils for OpenAPI 3.x specification.",
     "main": "dist/cjs/index.js",
     "module": "dist/mjs/index.js",
@@ -33,19 +33,19 @@
         "yaml": "^2.2.1"
     },
     "devDependencies": {
-        "@types/node": "^18.14.0",
-        "@typescript-eslint/eslint-plugin": "^5.53.0",
-        "@typescript-eslint/parser": "^5.53.0",
-        "@vitest/coverage-c8": "^0.28.5",
+        "@types/node": "^18.15.10",
+        "@typescript-eslint/eslint-plugin": "^5.56.0",
+        "@typescript-eslint/parser": "^5.56.0",
+        "@vitest/coverage-c8": "^0.29.7",
         "c8": "^7.13.0",
         "coveralls": "^3.1.1",
-        "eslint": "^8.34.0",
-        "eslint-config-prettier": "^8.6.0",
+        "eslint": "^8.36.0",
+        "eslint-config-prettier": "^8.8.0",
         "eslint-plugin-prettier": "^4.2.1",
-        "prettier": "^2.8.4",
-        "rimraf": "^4.1.2",
-        "typescript": "~4.9.5",
-        "vitest": "^0.28.5",
-        "vitest-teamcity-reporter": "^0.1.10"
+        "prettier": "^2.8.7",
+        "rimraf": "^4.4.1",
+        "typescript": "~5.0.2",
+        "vitest": "^0.29.7",
+        "vitest-teamcity-reporter": "^0.1.12"
     }
 }

src/dsl/index.ts

@@ -1 +1 @@
-export * from './OpenApiBuilder.js';
+export * from './openapi-builder31.js';