Skip to content

docs(codegen): document the remaining config options - #5367

Open
aryaemami59 wants to merge 3 commits into
reduxjs:masterfrom
aryaemami59:docs/codegen/document-remaining-options
Open

docs(codegen): document the remaining config options#5367
aryaemami59 wants to merge 3 commits into
reduxjs:masterfrom
aryaemami59:docs/codegen/document-remaining-options

Conversation

@aryaemami59

@aryaemami59 aryaemami59 commented Aug 12, 2026

Copy link
Copy Markdown
Member

Builds on #5366 — that commit is included here and the diff will shrink once it merges. Review the second commit only.

Ten options accepted by CommonOptions were missing from the config options table, including exportAllSchemas, which already has a section of its own further down the page.

  • Add unionUndefined, encodePathParams, encodeQueryParams, includeDefault, mergeReadWriteOnly, useUnknown, esmExtensions, exportAllSchemas and prettierConfigFile
  • Spell out the supporting types, so filterEndpoints and endpointOverrides resolve to something the page defines
  • Note that the CLI resolves relative config paths against the config file's own directory, and which config extensions it accepts
  • Say which of providesTags/invalidatesTags the tag option emits for a query and for a mutation
  • Point outputFile at outputFiles for the multi-file case
  • Format the NestJS example to match the repo Prettier config

The option list now matches CommonOptions and OutputFileOptions exactly — checked by pulling the properties out of types.ts with the TypeScript compiler and diffing them against the table, rather than by eye.

The path behaviour is the one covered by the paths are relative to config file, not to cwd test in cli.test.ts, which came from process.chdir in the CLI entry point and was not documented anywhere.

Docs-only, no runtime change. The site builds and the file is Prettier-clean.

One thing left out deliberately: operationIdTransformer, enumStyle and exportAllSchemas are documented but are not in any published release — the newest tag is @rtk-query/codegen-openapi@2.2.0 and the source marks them @since 2.3.0. Happy to add "requires 2.3.0" callouts if you want them, but I did not want to guess the next version number.

Closes #5370
Ref #5368

The `SimpleUsage` interface is syntactically invalid on the published page.
**`EndpointOverrides`** sits in the middle of it, closing the interface early
and stranding four options outside any type, followed by a stray brace.

- Close **`SimpleUsage`** and move **`EndpointOverrides`** out below it
- Return **`useEnumType`**, **`enumStyle`**, **`outputRegexConstants`** and **`httpResolverOptions`** to the interface
- Drop **`EndpointMatcherFunction`** from the **`filterEndpoints`** array member, since **`TextMatcher`** only accepts **`(string | RegExp)[]`**
- Rename **`AtLeastOneOf`** to **`AtLeastOneKey`** to match the helper in **`types.ts`**
- Close the final code block, whose fence was missing

Introduced in: [**reduxjs#5135**](reduxjs#5135), [**reduxjs#5304**](reduxjs#5304)
Ten options accepted by **`CommonOptions`** were missing from the config
options table, including **`exportAllSchemas`**, which already has a section
of its own further down the page.

- Add **`unionUndefined`**, **`encodePathParams`**, **`encodeQueryParams`**, **`includeDefault`**, **`mergeReadWriteOnly`**, **`useUnknown`**, **`esmExtensions`**, **`exportAllSchemas`** and **`prettierConfigFile`**
- Spell out the supporting types, so **`filterEndpoints`** and **`endpointOverrides`** resolve to something the page defines
- Note that the CLI resolves relative config paths against the config file's own directory, and which config extensions it accepts
- Say which of **`providesTags`**/**`invalidatesTags`** the **`tag`** option emits for a query and for a mutation
- Point **`outputFile`** at **`outputFiles`** for the multi-file case
- Format the NestJS example to match the repo Prettier config

The option list now matches **`CommonOptions`** and **`OutputFileOptions`**
exactly, checked against the compiler rather than by eye.
@codesandbox

codesandbox Bot commented Aug 12, 2026

Copy link
Copy Markdown

Review or Edit in CodeSandbox

Open the branch in Web EditorVS CodeInsiders

Open Preview

@netlify

netlify Bot commented Aug 12, 2026

Copy link
Copy Markdown

Deploy Preview for redux-starter-kit-docs ready!

Name Link
🔨 Latest commit 8b051fa
🔍 Latest deploy log https://app.netlify.com/projects/redux-starter-kit-docs/deploys/6a7c9e7d80a3cd00083d8040
😎 Deploy Preview https://deploy-preview-5367--redux-starter-kit-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@pkg-pr-new

pkg-pr-new Bot commented Aug 12, 2026

Copy link
Copy Markdown

Open in StackBlitz

@reduxjs/rtk-codemods

npm i https://pkg.pr.new/@reduxjs/rtk-codemods@8b051fa -D
yarn add https://pkg.pr.new/@reduxjs/rtk-codemods@8b051fa.tgz -D
pnpm add https://pkg.pr.new/@reduxjs/rtk-codemods@8b051fa.tgz -D
bun add https://pkg.pr.new/@reduxjs/rtk-codemods@8b051fa.tgz -D

@rtk-query/codegen-openapi

npm i https://pkg.pr.new/@rtk-query/codegen-openapi@8b051fa -D
yarn add https://pkg.pr.new/@rtk-query/codegen-openapi@8b051fa.tgz -D
pnpm add https://pkg.pr.new/@rtk-query/codegen-openapi@8b051fa.tgz -D
bun add https://pkg.pr.new/@rtk-query/codegen-openapi@8b051fa.tgz -D

@rtk-query/graphql-request-base-query

npm i https://pkg.pr.new/@rtk-query/graphql-request-base-query@8b051fa -D
yarn add https://pkg.pr.new/@rtk-query/graphql-request-base-query@8b051fa.tgz -D
pnpm add https://pkg.pr.new/@rtk-query/graphql-request-base-query@8b051fa.tgz -D
bun add https://pkg.pr.new/@rtk-query/graphql-request-base-query@8b051fa.tgz -D

@reduxjs/toolkit

npm i https://pkg.pr.new/@reduxjs/toolkit@8b051fa -D
yarn add https://pkg.pr.new/@reduxjs/toolkit@8b051fa.tgz -D
pnpm add https://pkg.pr.new/@reduxjs/toolkit@8b051fa.tgz -D
bun add https://pkg.pr.new/@reduxjs/toolkit@8b051fa.tgz -D

commit: 8b051fa

@aryaemami59 aryaemami59 added Documentation Improvements or additions to documentation RTKQ-Codegen Issues related to the @rtk-query/codegen-openapi package. labels Aug 12, 2026
@aryaemami59 aryaemami59 self-assigned this Aug 12, 2026
@aryaemami59 aryaemami59 added this to the 3.0 milestone Aug 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Improvements or additions to documentation RTKQ-Codegen Issues related to the @rtk-query/codegen-openapi package.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(codegen): document the remaining config options

1 participant