feat: OpenAPI Overlay 1.1.0 (#200)

* feat: OpenAPI Overlay 1.1.0

* feat: Add overlay versioning support and enforce compatibility rules

* chore: Code formatting

* chore: Update website link

* chore: Bump dependencies

Author: thim81

CHANGELOG.md

@@ -1,6 +1,11 @@
 ## unreleased
 
-- feat: improve CLI playground URL handling
+- Overlay: add OpenAPI Overlay 1.1.0 support
+- Overlay: add `copy` action support with strict `from` validation
+- Overlay: enforce strict action validation and type compatibility for update/copy actions
+- CLI: improve CLI playground URL handling
+- Types: extend overlay typings with `copy`, `from`, and overlay metadata fields
+- Docs: update overlay examples and guidance to 1.1.0
 
 ## [1.29.5] - 2026-02-28
 
@@ -433,4 +438,4 @@ Initial commit with features
 - Format via CLI
 - Format via config files
 - Use via as Module
-- Support for OpenAPI 3.0
+- Support for OpenAPI 3.0

bin/cli.js

@@ -421,7 +421,7 @@ async function run(oaFile, options) {
     const cliOut = [];
     cliLog.unusedActions.forEach(action => {
       cliOut.push(
-        `- Target: ${action.target}\n  Type: ${action.update ? 'update' : action.remove ? 'remove' : 'unknown'}`
+        `- Target: ${action.target}\n  Type: ${action.update ? 'update' : action.remove ? 'remove' : action.copy ? 'copy' : 'unknown'}`
       );
     });
 

bin/cli.test.js

@@ -364,10 +364,10 @@ describe('openapi-format CLI command', () => {
     const setting = `${path}/customFilter.yaml`;
     const args = [inputFile, `--filterFile ${setting}`, `--playground`];
 
-    console.log('playground request args:', args);
+    // console.log('playground request args:', args);
     let result = await testUtils.cli(args, '.');
-    console.log('playground response stdout:', result.stdout);
-    console.log('playground response stderr:', result.stderr);
+    // console.log('playground response stdout:', result.stdout);
+    // console.log('playground response stderr:', result.stderr);
     expect(result.code).toBe(0);
     if (process.env.CI) {
       expect(result.stderr).toContain('Running in CI/CD environment, no Share URL generated');