📖 docs: update README and code to reflect changes in plugin functionality, including dependency updates and theme customization

Author: yamcodes

.changeset/tricky-brooms-bake.md

@@ -0,0 +1,5 @@
+---
+"@bedtime-coders/elysia-openapi": minor
+---
+
+Add the ability to use any theme

README.md

@@ -6,18 +6,16 @@
 </h1>
     <a href="https://npmjs.com/package/@bedtime-coders/elysia-openapi">
         <img src="https://img.shields.io/npm/v/@bedtime-coders/elysia-openapi.svg?style=flat-square" alt="npm version" />
-    </a>
-    <a href="https://bundlephobia.com/package/@bedtime-coders/elysia-openapi">
+    </a><a href="https://bundlephobia.com/package/@bedtime-coders/elysia-openapi">
         <img src="https://img.shields.io/bundlephobia/minzip/@bedtime-coders/elysia-openapi.svg?style=flat-square" alt="bundlephobia" />
-    </a>
-    <a href="https://elysiajs.com/">
+    </a><a href="https://elysiajs.com/">
         <img src="https://img.shields.io/badge/%F0%9F%A6%8A-f6f8fa?label=elysia&color=blue" alt="elysia" />
     </a>
 </div>
 
 Use this plugin to effortlessly expose a beautiful [OpenAPI](https://github.com/OAI/OpenAPI-Specification) reference page from your ElysiaJS application with zero configuration. Just add the plugin to your Elysia app and you're good to go!
 
-👉 **Why use this over `@elysiajs/swagger`?** This is a fork of `@elysiajs/swagger` with updated dependencies and [a few other opinionated changes](#changes-from-elysiajs-swagger). If [@elysiajs/swagger](https://github.com/elysiajs/elysia-swagger) suits your needs (and you don't need the latest version of [Scalar API Reference](https://github.com/scalar/scalar/tree/main/packages/api-reference)), then by all means, use that instead.
+👉 **Why use this over `@elysiajs/swagger`?** This is a fork of `@elysiajs/swagger` with updated dependencies and [a few opinionated changes](#changes-from-elysiajs-swagger). If [@elysiajs/swagger](https://github.com/elysiajs/elysia-swagger) suits your needs (and you don't need the latest version of [Scalar API Reference](https://github.com/scalar/scalar/tree/main/packages/api-reference)), then by all means, use that instead.
 
 ## Add it to your Elysia app
 ```bash
@@ -65,11 +63,13 @@ Visit `http://localhost:8080/docs` to see the generated OpenAPI reference page 
 
 ## Changes from `@elysiajs/swagger`
 
-- Update dependencies to the latest versions (at the time of writing), including [Scalar API Reference](https://github.com/scalar/scalar)
-- Fix code to support the latest version of these dependencies
-- Rename plugin from `swagger` to `openapi`
-- Change the default API Reference path to `/docs`, serving either Scalar API Reference (default) or Swagger UI
-- Change the default `openapi.json` serving path to `/docs/json`
+- Update core dependencies to the latest versions (at the time of writing)
+  - Updates include [Scalar API Reference](https://github.com/scalar/scalar), enabling useful features like [`persistAuth`](https://github.com/scalar/scalar/blob/main/documentation/configuration.md#persistauth-boolean)
+  - Fix code to fully support these updates, passing all official [tests](https://github.com/bedtime-coders/elysia-openapi/actions/workflows/test.yml)
+- Ability to set any `theme` for Scalar API Reference, not just `elysiajs`
+- Rename plugin to `openapi` (was `swagger`)
+- Change the default API Reference path to `/docs` (was `/swagger`)
+- Change the default `openapi.json` path to `/docs/json` (was `/swagger/json`)
 
 ## Give us a ⭐️
 

src/index.ts

@@ -71,9 +71,8 @@ export const openapi = <Path extends string = "/docs">({
 					scalarVersion,
 					{
 						url: specPath,
+						theme: "elysiajs",
 						...scalarConfig,
-						// so we can showcase the elysia theme
-						_integration: "elysiajs",
 					} satisfies Partial<ApiReferenceConfiguration>,
 					scalarCDN,
 				),

src/scalar/index.ts

@@ -28,9 +28,7 @@ export const ScalarRender = (
         margin: 0;
       }
     </style>
-    <style>
-      ${config.customCss ?? elysiajsTheme}
-    </style>
+    ${config.customCss ? `<style>${config.customCss}</style>` : ""}
   </head>
   <body>
     <script