chore: add benchmarks

[hanspagel]

This PR adds some benchmarks to compare the performance of @apidevtools/swagger-parser and @scalar/openapi-parser.

This also helped me to find a performance bottleneck: We used to asynchronously import the OpenAPI schemas, which really slowed down the first use. With this PR they are imported and bundled right-away.

There are some other things we could improve:

• The resolve() method resolves the references twice (HUGE slow down). We need to refactor a few things to optimize that.
• The checkReferences() function actually resolves the references but doesn’t even return the example. We could change it to not modify the object (tiny benefit) or actually return the resolved schema (so it’s usable without a second run).

Anyway. I’m not sure whether we compare apples to apples (SwaggerParser.dereference vs. our resolveReferences). I think SwaggerParser does validation and dereferencing in one go and we’re way slower then (1.000×). But with the above mentioned refactors we should come close.

Run benchmarks

pnpm run bench

Create CPU profile

pnpm run profile

Anyway, those are the results for now (no reference, single reference, petstore):

[relativeci[bot]]

Job #5: Bundle Size — 478.13KiB (-0.21%).

715bbff(current) vs 42ab310 main#4(baseline)

Bundle metrics   5 changes 1 regression

	Current Job #5	Baseline Job #4
Initial JS	478.13KiB(+23.89%)	385.93KiB
Initial CSS	0B	0B
Cache Invalidation	100%	0%
Chunks	1(-75%)	4
Assets	1(-75%)	4
Modules	302(-0.33%)	303
Duplicate Modules	0	0
Duplicate Code	0%	0%
Packages	10	10
Duplicate Packages	0	0

Bundle size by type   1 change 1 improvement

|            |       Current
[Job #5](https://app.relative-ci.com/projects/hXQ54UQKluDUZAKvpt9b/jobs/5-ADoFpzVn6jwO2IHRRKzr?utm_source=github&utm_medium=pr-report "View job report") |      Baseline
[Job #4](https://app.relative-ci.com/projects/hXQ54UQKluDUZAKvpt9b/jobs/4-WxI2NBTBrDxg1rZF3Bzs?utm_source=github&utm_medium=pr-report "View baseline job report") | |:--|--:|--:| |   [JS](https://app.relative-ci.com/projects/hXQ54UQKluDUZAKvpt9b/jobs/5-ADoFpzVn6jwO2IHRRKzr/assets?ba=%7B%22filters%22%3A%22ft.CSS-0_ft.JS-1_ft.IMG-0_ft.MEDIA-0_ft.FONT-0_ft.HTML-0_ft.OTHER-0%22%7D "View JS assets") | `478.13KiB` (`-0.21%`) | `479.15KiB` |

---

View job #5 report View chore/benchmarking branch activity View project dashboard