TypeScript: automatic typing generation (#1726)

* Add TS config to inline TOC in config. intro

* Rewrite TypeScript configuration docs to include config/typescript.ts

* Mention auto-types generation in TypeScript development docs

* Remove TypeScript mentions from the table

* Reword description for `autogenerate`

* Rework the whole and TOC to clarify autocomplete/autogenerate

* Removed beta badge

* Remove autcomplete from title

* Simplify TS config. page introduction

* Simplify config/typescript.ts intro.

* Fix autogenerate behavior description

* Remove unnecessary link

* Rename "TypeScript configuration" for TOC

* Fix header link

* Shorten heading link

* Revert "Removed beta badge"

This reverts commit b51cc99.

* Don't mention autogenerate is beta in TypeScript docs

Easier to manage for when we'll remove the beta badge in a few days.

Author: pwizla

docusaurus/docs/dev-docs/configurations.md

@@ -73,3 +73,4 @@ Strapi also offers the following optional configuration options for specific fea
 - [public assets](/dev-docs/configurations/public-assets)
 - [Single Sign-On](/dev-docs/configurations/sso) <EnterpriseBadge />
 - [Role-Based Access Control](/dev-docs/configurations/rbac)
+- [TypeScript](/dev-docs/configurations/typescript)

docusaurus/docs/dev-docs/configurations/typescript.md

@@ -5,9 +5,15 @@ description: How to configure Strapi for TypeScript development.
 
 ---
 
-# TypeScript project configuration
+# TypeScript configuration
 
-[TypeScript](/dev-docs/typescript)-enabled Strapi applications have a specific [project structure](/dev-docs/project-structure) with the following dedicated folders and configuration files:
+[TypeScript](/dev-docs/typescript)-enabled Strapi projects have a specific project structure and handle TypeScript project configuration through [`tsconfig.json` files](#project-structure-and-typescript-specific-configuration-files).
+
+Strapi also has dedicated TypeScript features that are configured [in the `config/typescript.js|ts` file](#strapi-specific-configuration-for-typescript).
+ 
+## Project structure and TypeScript-specific configuration files
+
+TypeScript-enabled Strapi applications have a specific [project structure](/dev-docs/project-structure) with the following dedicated folders and configuration files:
 
 | TypeScript-specific directories and files | Location         | Purpose                                                                                                                                           |
 |-------------------------------------------|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
@@ -16,3 +22,40 @@ description: How to configure Strapi for TypeScript development.
 | `tsconfig.json` file                      | application root | Manages TypeScript compilation for the server.                                                                                                    |
 | `tsconfig.json` file                      | `./src/admin/`   | Manages TypeScript compilation for the admin panel.                                                                                               |
 
+## Strapi-specific configuration for TypeScript <BetaBadge />
+
+Types generated by Strapi are based on the user project structure. Once the type definitions are emitted into their dedicated files, Strapi reads the type definitions to adapt the autocompletion results accordingly.
+
+To avoid having to [manually generate types](/dev-docs/typescript#generate-typings-for-project-schemas) every time the server restarts, an optional `config/typescript.js|ts` configuration file can be added, which currently accepts only one parameter:
+
+| Parameter      | Description                                                    | Type      | Default |
+| -------------- | -------------------------------------------------------------- | --------- | ------- |
+| `autogenerate` | Enable or disable automatic types generation on server restart | `Boolean` | `false` |
+
+**Example:**
+
+<Tabs groupId="js-ts">
+
+<TabItem value="javascript" label="JavaScript">
+
+```js title="./config/typescript.js"
+
+module.exports = ({ env }) => ({
+  autogenerate: true,
+});
+```
+
+</TabItem>
+
+<TabItem value="typescript" label="TypeScript">
+
+```ts title="./config/typescript.ts"
+
+export default ({ env }) => ({
+  autogenerate: true,
+});
+```
+
+</TabItem>
+
+</Tabs>

docusaurus/docs/dev-docs/typescript.md

@@ -87,6 +87,10 @@ yarn strapi ts:generate-types --verbose #optional flag
 </TabItem>
 </Tabs>
 
+:::tip Tip: Automatically generate types
+Types can be automatically generated on server restart by adding `autogenerate: true` to [the `config/typescript.js|ts` configuration file](/dev-docs/configurations/typescript#strapi-specific-configuration-for-typescript).
+:::
+
 ## Develop a plugin using TypeScript
 
 New plugins can be generated following the [plugins development documentation](/dev-docs/plugins-development). There are 2 important distinctions for TypeScript applications: