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'
+ }
+ }
+ },
+});