finish type declarations

Author: mk360

docs/documentation/fr/handbook-v2/Type Declarations.md

@@ -44,56 +44,56 @@ Par défaut, TypeScript contient également les types des éléments du navigate
 Ces fichiers suivent la convention de nommage `lib.[quelque chose].d.ts`.
 Si vous ouvrez un fichier suivant ce nommage, vous saurez que c'est un élément pré-existant de la plateforme, qui ne contient pas de code.
 
-### Option `target`
+### L'option `target`
 
 Les méthodes, propriétés, et fonctions disponibles varient, dans les faits, en fonction de la _version_ de JavaScript que votre code exécute.
 Par exemple, la méthode `startsWith` des chaînes de caractères est disponible à partir de la 6ème version de JavaScript (_EcmaScript 6_).
 
 Il est important de connaître quelle version de JavaScript est exécutée, car vous ne voulez pas utiliser d'APIs disponibles sur des versions plus récentes.
 C'est l'un des rôles de l'option de compilateur [`target`](/tsconfig#target).
 
-TypeScript helps with this problem by varying which `lib` files are included by default based on your [`target`](/tsconfig#target) setting.
-For example, if [`target`](/tsconfig#target) is `ES5`, you will see an error if trying to use the `startsWith` method, because that method is only available in `ES6` or later.
+TypeScript vous aide sur ce problème en faisant varier quels fichiers `lib` sont inclus par défaut, en se basant sur l'option [`target`](/tsconfig#target).
+Par exemple, si [`target`](/tsconfig#target) vaut `ES5`, vous aurez une erreur en essayant d'utiliser la méthode `startsWith`, parce qu'elle n'existe qu'à partir de la version `ES6`.
 
-### `lib` setting
+### L'option `lib`
 
-The [`lib`](/tsconfig#lib) setting allows more fine-grained control of which built-in declaration files are considered available in your program.
-See the documentation page on [`lib`](/tsconfig#lib) for more information.
+L'option [`lib`](/tsconfig#lib) permet un contrôle plus précis des fichiers standards de déclaration qui seront considérés présents dans votre programme.
+Vous pouvez lire plus de détails dans la documentation de [`lib`](/tsconfig#lib).
 
-## External Definitions
+## Définitions externes
 
-For non-built-in APIs, there are a variety of ways you can get declaration files.
-How you do this depends on exactly which library you're getting types for.
+Pour les APIs qui ne sont pas intégrées par défaut, il existe une variété de façons d'obtenir les informations de typage.
+Ces façons dépendent de la librairie pour laquelle vous cherchez à obtenir ces types.
 
-### Bundled Types
+### Types inclus dans la librairie
 
-If a library you're using is published as an npm package, it may include type declaration files as part of its distribution already.
-You can read the project's documentation to find out, or simply try importing the package and see if TypeScript is able to automatically resolve the types for you.
+Si une libraire que vous utilisez a été importée dans un package npm, il se pourrait qu'elle ait des déclarations de types intégrées.
+Vous pouvez lire sa documentation pour en savoir plus, ou vous pouvez simplement importer la librairie et voir si TypeScript peut résoudre les types pour vous.
 
-If you're a package author considering bundling type definitions with your package, you can read our guide on [bundling type definitions](/docs/handbook/declaration-files/publishing.html#including-declarations-in-your-npm-package).
+Si vous écrivez un package vous-même et que vous souhaitez inclure les définitions de types, vous pouvez lire notre guide sur [l'assemblage de définitions de types](/docs/handbook/declaration-files/publishing.html#including-declarations-in-your-npm-package).
 
 ### DefinitelyTyped / `@types`
 
-The [DefinitelyTyped repository](https://github.com/DefinitelyTyped/DefinitelyTyped/) is a centralized repo storing declaration files for thousands of libraries.
-The vast majority of commonly-used libraries have declaration files available on DefinitelyTyped.
+The [répertoire DefinitelyTyped](https://github.com/DefinitelyTyped/DefinitelyTyped/) est un répertoire centralisé qui contient des fichiers de déclarations pour des milliers de librairies.
+La vaste majorité de librairies communément utilisées ont des fichiers de déclarations disponibles sur DefinitelyTyped.
 
-Definitions on DefinitelyTyped are also automatically published to npm under the `@types` scope.
-The name of the types package is always the same as the name of the underlying package itself.
-For example, if you installed the `react` npm package, you can install its corresponding types by running
+Les définitions de DefinitelyTyped sont automatiquement déployées dans npm sous le préfixe `@types`.
+Le nom des packages de types sont toujours les mêmes que les packages qu'ils annotent.
+Par exemple, si vous installez le package npm `react`, vous pouvez installer les types correspondants en écrivant :
 
 ```sh
 npm install --save-dev @types/react
 ```
 
-TypeScript automatically finds type definitions under `node_modules/@types`, so there's no other step needed to get these types available in your program.
+TypeScript trouve les définitions de types automatiquement sous `node_modules/@types`, il n'y a donc aucune étape supplémentaire nécessaire pour accéder aux types.
 
-### Your Own Definitions
+### Vos propres types
 
-In the uncommon event that a library didn't bundle its own types and didn't have a definition on DefinitelyTyped, you can write a declaration file yourself.
-See the appendix [Writing Declaration Files](/docs/handbook/declaration-files/introduction.html) for a guide.
+Si, dans de rares situations, les définitions de types n'existent ni chez DefinitelyTyped, ni dans la librairie elle-même, vous pouvez écrire vos propres fichiers de déclaration.
+Consultez le guide [Écrire des fichiers de déclaration](/docs/handbook/declaration-files/introduction.html) pour plus d'informations.
 
-If you want to silence warnings about a particular module without writing a declaration file, you can also quick declare the module as type `any` by putting an empty declaration for it in a `.d.ts` file in your project.
-For example, if you wanted to use a module named `some-untyped-module` without having definitions for it, you would write:
+Si vous voulez taire les avertissements concernant un module sans avoir à écrire de déclarations de types, vous pouvez déclarer son type comme étant `any` en créant un fichier de déclaration `.d.ts` vide dans votre projet.
+Par exemple, si vous voulez utiliser `some-untyped-module` sans avoir de définitions pour, il suffit d'écrire :
 
 ```ts twoslash
 declare module "some-untyped-module";