diff --git a/docs/5.x/introduction/comparison.md b/docs/5.x/introduction/comparison.md index ed7df4d799..19be685f40 100644 --- a/docs/5.x/introduction/comparison.md +++ b/docs/5.x/introduction/comparison.md @@ -43,7 +43,7 @@ Types, `openapi-fetch`, and `openapi-react-query`. | Difference | Details | | --- | --- | | Full builds are the fastest of the three and use the least memory on every spec we measured, from 0.1 MB to 29.7 MB. | [Speed, CPU time, and memory](#speed-cpu-time-and-memory) | -| One config generates types, clients, query hooks, Zod, MSW, Faker, Cypress tests, an MCP server, and Redoc docs. | [Plugin and feature coverage](#plugin-and-feature-coverage) | +| One config generates types, clients, query hooks, Zod or Valibot schemas, MSW, Faker, Cypress tests, an MCP server, and Redoc docs. | [Plugin and feature coverage](#plugin-and-feature-coverage) | | Clients return a result you narrow by status code, and each call picks whether errors throw. | [Type safety and response handling](#type-safety-and-response-handling) | | The runtime follows the spec's parameter styles, encodes bodies per media type, and reads server-sent events. | [Client runtime](#client-runtime) | | File review, pull request snapshots, and API skills for AI tools. | [Kubb Studio](#kubb-studio) | @@ -70,31 +70,35 @@ How we measured, in November 2026: โœ… built in ยท ๐ŸŸ  partial ยท ๐ŸŸก community or separate package ยท ๐Ÿ”ถ needs extra user code ยท ๐Ÿ›‘ not supported -| Feature | Kubb | orval | HeyAPI | openapi-ts | -| ---------------------------------------------------------------- | :------------: | :------------: | :------------: | :------------: | -| [OpenAPI 2.0 input](/extensions/kubb-labs/adapter-oas) | โœ… | โœ… | โœ… | ๐Ÿ›‘1 | -| [OpenAPI 3.0 input](/extensions/kubb-labs/adapter-oas) | โœ… | โœ… | โœ… | โœ… | -| [OpenAPI 3.1 input](/extensions/kubb-labs/adapter-oas) | โœ… | โœ… | โœ… | โœ… | -| [OpenAPI 3.2 input](/extensions/kubb-labs/adapter-oas) | โœ…2 | ๐ŸŸ 3 | ๐Ÿ›‘4 | ๐Ÿ›‘4 | -| [TypeScript types](/extensions/kubb-labs/plugin-ts) | โœ… | โœ… | โœ… | โœ… | -| [HTTP client (Axios, Fetch)](/extensions/kubb-labs/plugin-axios) | โœ… | โœ… | โœ… | ๐Ÿ”ถ5 | -| [React Query hooks](/extensions/kubb-labs/plugin-react-query) | โœ… | โœ… | โœ… | ๐ŸŸก5 | -| [Vue Query composables](/extensions/kubb-labs/plugin-vue-query) | โœ… | โœ… | โœ… | ๐Ÿ›‘ | -| [SWR hooks](/extensions/kubb-labs/plugin-swr) | โœ… | โœ… | ๐Ÿ›‘6 | ๐ŸŸก | -| [Zod validation schemas](/extensions/kubb-labs/plugin-zod) | โœ… | โœ… | โœ… | ๐Ÿ›‘ | -| [MSW request handlers](/extensions/kubb-labs/plugin-msw) | โœ… | โœ… | ๐Ÿ›‘6 | ๐Ÿ›‘ | -| [Faker.js mock data](/extensions/kubb-labs/plugin-faker) | โœ… | โœ… | ๐Ÿ›‘6 | ๐Ÿ›‘ | -| [Cypress E2E tests](/extensions/kubb-labs/plugin-cypress) | โœ… | ๐Ÿ›‘ | ๐Ÿ›‘ | ๐Ÿ›‘ | -| [MCP server](/extensions/kubb-labs/plugin-mcp) | โœ… | โœ… | ๐Ÿ›‘ | ๐Ÿ›‘ | -| [Redoc API documentation](/extensions/kubb-labs/plugin-redoc) | โœ… | ๐Ÿ›‘ | ๐Ÿ›‘ | ๐Ÿ›‘ | -| [Barrel index files](/extensions/kubb-labs/plugin-barrel) | โœ… | โœ… | โœ… | ๐Ÿ›‘ | +| Feature | Kubb | orval | HeyAPI | openapi-ts | +| ------------------------------------------------------------------ | :------------: | :------------: | :------------: | :------------: | +| [OpenAPI 2.0 input](/extensions/kubb-labs/adapter-oas) | โœ… | โœ… | โœ… | ๐Ÿ›‘1 | +| [OpenAPI 3.0 input](/extensions/kubb-labs/adapter-oas) | โœ… | โœ… | โœ… | โœ… | +| [OpenAPI 3.1 input](/extensions/kubb-labs/adapter-oas) | โœ… | โœ… | โœ… | โœ… | +| [OpenAPI 3.2 input](/extensions/kubb-labs/adapter-oas) | โœ…2 | ๐ŸŸ 3 | ๐Ÿ›‘4 | ๐Ÿ›‘4 | +| [TypeScript types](/extensions/kubb-labs/plugin-ts) | โœ… | โœ… | โœ… | โœ… | +| [HTTP client (Axios, Fetch)](/extensions/kubb-labs/plugin-axios) | โœ… | โœ… | โœ… | ๐Ÿ”ถ5 | +| [Ky HTTP client](/extensions/kubb-labs/plugin-ky) | โœ…6 | ๐Ÿ”ถ7 | โœ… | ๐Ÿ›‘ | +| [React Query hooks](/extensions/kubb-labs/plugin-react-query) | โœ… | โœ… | โœ… | ๐ŸŸก5 | +| [Vue Query composables](/extensions/kubb-labs/plugin-vue-query) | โœ… | โœ… | โœ… | ๐Ÿ›‘ | +| [SWR hooks](/extensions/kubb-labs/plugin-swr) | โœ… | โœ… | ๐Ÿ›‘8 | ๐ŸŸก | +| [Zod validation schemas](/extensions/kubb-labs/plugin-zod) | โœ… | โœ… | โœ… | ๐Ÿ›‘ | +| [Valibot validation schemas](/extensions/kubb-labs/plugin-valibot) | โœ…6 | โœ… | โœ… | ๐Ÿ›‘ | +| [MSW request handlers](/extensions/kubb-labs/plugin-msw) | โœ… | โœ… | ๐Ÿ›‘8 | ๐Ÿ›‘ | +| [Faker.js mock data](/extensions/kubb-labs/plugin-faker) | โœ… | โœ… | ๐Ÿ›‘8 | ๐Ÿ›‘ | +| [Cypress E2E tests](/extensions/kubb-labs/plugin-cypress) | โœ… | ๐Ÿ›‘ | ๐Ÿ›‘ | ๐Ÿ›‘ | +| [MCP server](/extensions/kubb-labs/plugin-mcp) | โœ… | โœ… | ๐Ÿ›‘ | ๐Ÿ›‘ | +| [Redoc API documentation](/extensions/kubb-labs/plugin-redoc) | โœ… | ๐Ÿ›‘ | ๐Ÿ›‘ | ๐Ÿ›‘ | +| [Barrel index files](/extensions/kubb-labs/plugin-barrel) | โœ… | โœ… | โœ… | ๐Ÿ›‘ | 1. openapi-typescript 7 reads 3.0 and 3.1 only. Convert Swagger 2.0 first, or use version 5. 2. Kubb generates every OpenAPI 3.2 feature we tested: the `QUERY` method, `additionalOperations`, `querystring` parameters, `itemSchema` for server-sent events and JSON Lines, and `components/mediaTypes`. 3. orval 8.48.0 generates `QUERY` operations. It skips `additionalOperations` and `querystring` parameters, and types `itemSchema` responses and media type references as `unknown`. 4. HeyAPI 0.99.0 and openapi-typescript 7.13.0 read a 3.2 document without an error, but skip `QUERY` and `additionalOperations` operations, drop `querystring` parameters, and type the other 3.2 features as `unknown`. 5. openapi-typescript generates types only. Clients and hooks come from the `openapi-fetch` and `openapi-react-query` runtimes, all in [maintenance mode](https://github.com/openapi-ts/openapi-typescript/issues/2874). -6. HeyAPI lists SWR as planned and MSW and Faker as in progress. +6. `@kubb/plugin-ky` and `@kubb/plugin-valibot` are in beta. +7. orval has no Ky client. You write a [custom client](https://orval.dev/docs/guides/custom-client) that calls Ky. +8. HeyAPI lists SWR as planned and MSW and Faker as in progress. ## Type safety and response handling