feat(openapi): support configuration via openapi

docs/3.config/0.index.md

@@ -42,9 +42,35 @@ Enable experimental features.
 
 Enable `/_nitro/scalar` and `/_nitro/swagger` and `/_nitro/openapi.json` endpoints.
 
+- Default: `false`
+
 > [!IMPORTANT]
 > [Scalar](https://scalar.com/) support is currently available in [nightly channel](/guide/nightly).
 
+You can pass an object on the root level to modify your OpenAPI specification:
+
+```js
+openAPI: {
+  meta: {
+    title: 'My Awesome Project',
+    description: 'This might become the next big thing.',
+    version: '1.0'
+  }
+}
+```
+
+If you like to customize the Scalar integration, you can [pass a configuration object](https://github.com/scalar/scalar) like this:
+
+```js
+openAPI: {
+  ui: {
+    scalar: {
+      theme: 'purple'
+    }
+  }
+}
+```
+
 #### `wasm`
 
 Enable WASM support

package.json

@@ -131,6 +131,7 @@
     "@azure/functions": "^3.5.1",
     "@azure/static-web-apps-cli": "^1.1.7",
     "@cloudflare/workers-types": "^4.20240320.1",
+    "@scalar/api-reference": "^1.20.7",
     "@types/aws-lambda": "^8.10.136",
     "@types/bun": "^1.0.10",
     "@types/estree": "^1.0.5",

playground/nitro.config.ts

@@ -1 +1,17 @@
-export default defineNitroConfig({});
+export default defineNitroConfig({
+  experimental: {
+    openAPI: true,
+  },
+  openAPI: {
+    meta: {
+      title: 'Foobar',
+      description: 'Foobar API',
+      version: '2.0',
+    },
+    ui: {
+      scalar: {
+        theme: 'purple'
+      }
+    }
+  },
+});