* Utilisation de la version stable de TypeScript 3.7
* Début de migration du State Redux. Plutôt que de redéfinir les types
en doublon par rapport aux actions et reducers, on utilise les valeurs
retournées par ces fonctions comme source pour les types globaux.
* Modification de tsconfig pour meilleur typage dans VS Code
* Meilleur typage de l'environnement : suppression de @types/node qui
était trop large (contient tout l'environnement serveur), et
remplacement par @types/webpack-env. Par ailleurs typage des variables
d'environnement utilisées.
* Début de migration de l'économie collaborative
* Migration de nombreux composants UI
* Mise à jour de dépendances pour récupérer un meilleur typage
* Ajout d'un hook pour configurer les simulateurs
* Suppression du higher-order component "withSitePaths", on utilise
systématiquement le hook useContext.
L'essentiel de l'application est maintenant migré, reste le moteur !
Nous générons deux bundles à partir de notre code JavaScript, un pour
les navigateurs modernes et un pour les anciens navigateurs. Vu que
notre site est statique nous utilisons la technique de l'attribut
module/nomodule dans la balise script pour que le navigateur télécharge
la bonne version du bundle.
Safari 10.1 ne supportant pas l'attribut nomodule, nous utilisions une
prothèse pour ajouter ce support. Il semble que ce code ne fonctionnait
pas bien car c'est toujours la version "legacy" du bundle qui était
utilisée sur les versions modernes de Safari (11, 12, 13).
Il y a actuellement un problème de Tracking sur la version Legacy suite
à la migration vers Typescript. J'ai du mal à comprendre d'où vient le
problème, mais en attendant un premier remède consiste à servir la
version normale du bundle aux navigateurs Safari récents.
Note: il semble que Safari téléchargeait les deux bundles ! Ce commit
devrait donc baisser significativement le volume de fichiers à
télécharger.
Notre config prettier utilise les tabulations plutôt que les espaces
pour l'indentation. Prettier essaie de formater le code avec des lignes
de 80 caractères maximum, et compte 2 caractères pour les tabulations.
MAJ de la configuration VS Code pour être aligné avec la configuration
prettier.
Naturellement le développeur reste libre d'afficher les tabulations
comme il veut.
Les valeurs configurées suivantes correspondait aux valeurs par défaut,
et il n'est donc pas nécessaire de les spécifier. Les retirer ne change
rien :
- printWidth: 80
- arrowParens: avoid
- proseWrap: preserve
- tabWidth: 2
Par ailleurs j'ai supprimé :
- trailingComma "none", les traillingComma permettent d'avoir de
meilleurs diff git ligne par ligne
- jsxBracketSameLine "false", de même afin d'avoir de meilleurs diff
ligne par ligne
Ces deux changements ne devrait concerner qu'un nombre de lignes
modeste, et vu la transition en cours vers Typescript, autant faire les
deux en même temps pour limiter les commits qui perturbent l'historique
git.
Outils
======
Ce commit retire le tooling de Flow, et ajoute le support de TypeScript
pour les fichiers .ts et .tsx. Il n'est pas nécessaire de tout migrer
d'un coup ce qui facilite la transition. On garde en effet le
compilateur Babel avec un preset TypeScript (ce qui permet donc de
retirer à la fois les types Flow et TypeScript) plutôt que d'utiliser le
compilateur standard pour la conversion du code. Cela permet aussi de
mieux s'intégrer avec d'autres outils, notamment les test-runners.
Ajout d'une nouvelle commande `yarn run type-check`, intégrée dans
CircleCI.
Par ailleurs ajout du support de l'opérateur ?? pour donner des valeurs
par défaut (nullish-coalescing-operator).
Typage des libraires tierces
============================
Les principales libraires que nous utilisons ont un typage TypeScript de
bon niveau, ce qui facilite l'intégration. J'ai mis à jour react-i18next
et i18next afin de corriger un problème de typage.
Typage du code
==============
Le typage est loin d'être complet dans ce commit, en particulier il
manque les types relatifs au state Redux, ainsi qu'au moteur (règle,
explication). Néanmoins le typage des contextes fonctionne, en
particulier sitePaths (avec un type récursif non trivial !) qui a déjà
permis de détecter un lien mort.
Le typage des "paths" (Components/, Règles/, etc.) fonctionne bien, y
compris avec l'auto-complétion automatique des import par Typescript.
TypeScript se révèle déjà bien agréable dans VSCode (auto-complétion,
refacto, etc.) ! Reste à migrer progressivement le reste du code !
Deplacement de la détection de la règle "words" (ie une suite de mots)
du lexer/tokenizer vers le parser. Le lexer se contente de donner les
mots un à un, et une liste de "words" est détectée via une règle Nearley.
Cela permet de corriger l'ambiguité entre unités et noms de variables qui
est dépendante du contexte et ne peut donc pas être levée au niveau du lexer.
Vu qu'on utilise un serviceworker, lorsque la requête ne passe pas jusqu'au serveur, la redirection n'est pas effective
On parse les règles de redirection netlify coté front et on les ajoute à l'app
Maël
Marc Pasteur
Maxime Quandalle
Johan Girod
Johan Girod