TypeScript type defintions docs for website

Author: slowcheetah

docs/web/docs/features/web-standards/base64-utility-methods.md

@@ -11,6 +11,11 @@ function atob(data: string): string;
 function btoa(data: string): string;
 ```
 
+## [TypeScript type definitions]({docs-version}/docs/typescript-type-definitions)
+```ts
+@core-js/types/web/atob-btoa
+```
+
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```ts
 core-js(-pure)/stable|actual|full/atob

docs/web/docs/features/web-standards/iterable-dom-collections.md

@@ -49,6 +49,11 @@ class [DOMTokenList, NodeList] {
 }
 ```
 
+## [TypeScript type definitions]({docs-version}/docs/typescript-type-definitions)
+```ts
+@core-js/types/web/iterable-dom-collections
+```
+
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```
 core-js(-pure)/stable|actual|full/dom-collections/iterator

docs/web/docs/features/web-standards/queuemicrotask.md

@@ -9,6 +9,11 @@
 function queueMicrotask(fn: Function): void;
 ```
 
+## [TypeScript type definitions]({docs-version}/docs/typescript-type-definitions)
+```ts
+@core-js/types/web/queue-microtask
+```
+
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```ts
 core-js(-pure)/stable|actual|full/queue-microtask

docs/web/docs/features/web-standards/setimmediate.md

@@ -9,6 +9,11 @@ function setImmediate(callback: any, ...args: Array<mixed>): number;
 function clearImmediate(id: number): void;
 ```
 
+## [TypeScript type definitions]({docs-version}/docs/typescript-type-definitions)
+```ts
+@core-js/types/web/efficient-script-yielding
+```
+
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```ts
 core-js(-pure)/stable|actual|full/set-immediate

docs/web/docs/features/web-standards/structured-clone.md

@@ -9,6 +9,11 @@
 function structuredClone(value: Serializable, { transfer?: Sequence<Transferable> }): any;
 ```
 
+## [TypeScript type definitions]({docs-version}/docs/typescript-type-definitions)
+```ts
+@core-js/types/web/structured-clone
+```
+
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```ts
 core-js(-pure)/stable|actual|full/structured-clone

docs/web/docs/features/web-standards/url-and-urlsearchparams.md

@@ -45,6 +45,11 @@ class URLSearchParams {
 }
 ```
 
+## [TypeScript type definitions]({docs-version}/docs/typescript-type-definitions)
+```ts
+@core-js/types/web/url-to-json
+```
+
 ## [Entry points]({docs-version}/docs/usage#h-entry-points)
 ```ts
 core-js/proposals/url

docs/web/docs/menu.json

@@ -7,6 +7,10 @@
     "title": "Supported engines and compatibility data",
     "url": "{docs-version}/docs/engines"
   },
+  {
+    "title": "TypeScript type definitions",
+    "url": "{docs-version}/docs/typescript-type-definitions"
+  },
   {
     "title": "Features",
     "children": [

docs/web/docs/typescript-type-definitions.md

@@ -0,0 +1,114 @@
+# TypeScript Type Definitions
+
+This package contains types for the global and pure versions of `core-js`.
+Although `core-js` is a JavaScript standard library polyfill, the built-in TypeScript types are often not sufficient.
+Additional types are needed for:
+- features that are already in JavaScript but not yet in TypeScript’s standard types;
+- proposals, including those already implemented in JavaScript engines;
+- explicit imports of features from the pure version.
+
+It is shipped as a separate package because we cannot guarantee stable behavior with future TypeScript releases, including minor ones.
+
+## Installation
+```bash
+npm install --save @core-js/[email protected]
+```
+
+## Usage
+Add to your `tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    "types": [
+      "@core-js/types"
+    ]
+  }
+}
+```
+or import it directly in your files:
+```ts
+import '@core-js/types';
+```
+`@core-js/types` includes all types and entry points for the global version, but it is recommended to select only the subset you actually use.
+
+### Usage of subsets
+There are four main subsets:
+- `@core-js/types/actual` - types for all actual features, including stable ECMAScript, web standards and Stage 3 ECMAScript proposals;
+- `@core-js/types/es` - types for stable ECMAScript features only;
+- `@core-js/types/stable` - types for stable ECMAScript and web standards features;
+- `@core-js/types/full` - types for all features, including proposals.
+
+You can import them the same way as the main package. For example, to use only the stable subset, add this to your `tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    "types": [
+      "@core-js/types/stable"
+    ]
+  }
+}
+```
+or import it directly in your files:
+```ts
+import '@core-js/types/stable';
+```
+
+### Usage of specific features
+If you need types only for specific features, you can import them like this:
+```json
+{
+  "compilerOptions": {
+    "types": [
+      "@core-js/types/proposals/array-unique",
+      "@core-js/types/web/atob-btoa"
+    ]
+  }
+}
+```
+or import them directly in your files:
+```ts
+import '@core-js/types/proposals/array-unique';
+import '@core-js/types/web/atob-btoa';
+```
+For a full list of available features, see the [documentation](https://core-js.io/v4/docs/).
+
+## Types for the pure version
+### Base usage
+Add this to your `tsconfig.json`:
+```json
+{
+  "compilerOptions": {
+    "types": [
+      "@core-js/types/pure"
+    ]
+  }
+}
+```
+Then, when you import from the pure entry points, the corresponding types are picked up automatically:
+```ts
+import $findLast from '@core-js/pure/full/array/find-last';
+
+$findLast([1, 3, 4, 2], v => v > 2); // => 4
+```
+
+### Namespace usage in the pure version
+If you need to use multiple methods from the same namespace, you can add `@core-js/types/pure` to `tsconfig.json` and import the entire namespace:
+```ts
+import $array from '@core-js/pure/full/array';
+
+$array.findLast([1, 3, 4, 2], v => v > 2);
+$array.flatMap([1, 2, 3], x => [x, x * 2]);
+```
+
+## DOM types
+Some of the global types for web standards work correctly only with the DOM lib.
+You need to add DOM types to the `lib` section of your `tsconfig.json` in addition to `@core-js/types`. For example:
+```json
+{
+  "compilerOptions": {
+    "types": ["@core-js/types"],
+    "lib": ["esnext", "dom"]
+  }
+}
+```
+In the pure version, you can use these types without adding the DOM lib.