Packages populaires

La conformité à la spécification ne garantit pas le bon fonctionnement des bibliothèques réelles. Les moteurs JS qui réussissent 99 % des tests test262 échouent encore régulièrement avec le code de production, car les bibliothèques dépendent d’une longue liste de cas limites de la spécification : ordre précis des pièges Proxy, forme de Function.prototype.toString, comportement des expressions régulières avec des entrées délicates et interactions exactes entre l’ordre de Object.keys et les noms de propriétés calculés.

Phasis vérifie l’égalité octet par octet de 204 bibliothèques largement utilisées par rapport à Node.js (V8). Elles se trouvent dans tests/Popular/ du dépôt, et la CI les exécute à chaque modification du code source du moteur ou de la suite.

Couverture par catégorie

Total : 204 bibliothèques reproduisent exactement la sortie de Node. Toutes sont épinglées sur la dernière version amont à la date de la dernière mise à jour.

Fonctionnement

Chaque scénario est un répertoire tests/Popular/<lib>/ contenant trois fichiers :

tests/Popular/lodash/
├── lodash.js     ← vendored upstream library (untouched, UMD bundle)
├── runner.js     ← Phasis-side script that exercises the library
└── oracle.txt    ← Node.js output of running runner.js (committed)

tests/Popular/PopularPackagesTest.php est un test de fournisseur de données PHPUnit qui :

1. Charge lodash.js + runner.js dans un new Phasis\Engine() vierge.
2. Capture la sortie console.log dans un tampon.
3. Vérifie que le tampon capturé est identique octet par octet à oracle.txt.

Régénérez un oracle avec :

node tests/Popular/gen-oracle.js tests/Popular/<lib>

(Utilisé lors de la mise à jour de la bibliothèque vendue avec le projet : relance le runner sous Node réel et remplace oracle.txt.)

Étape de validation CI

Workflow : .github/workflows/popular.yml.

Se lance lors des pushs et des pull requests vers main qui modifient src/, tests/Popular/, phpunit.xml.dist, les fichiers Composer ou le workflow lui-même, ainsi que lors d'un lancement manuel. Deux étapes :

1. Côté Phasis — exécute la suite de tests PHPUnit popular, qui lance chaque bibliothèque via Phasis et compare le résultat à l'oracle validé dans le dépôt. Échec à la moindre différence d'un octet.
2. Nouvelle vérification avec Node — exécute node tests/Popular/gen-oracle.js … sur chaque bibliothèque et vérifie que l'oracle fraîchement régénéré correspond à celui du dépôt. Détecte toute dérive lorsqu'une bibliothèque vendue avec le projet est mise à jour sans actualiser l'oracle.

Les deux étapes doivent réussir avant la fusion de la PR. Une réussite de test262 qui casse lodash n'est pas acceptable ; pas plus qu'une réussite de lodash qui casse test262.

Pourquoi ces bibliothèques

• acorn — l'analyse est la partie la plus fragile de tout moteur JS. Elle met à l'épreuve chaque cas syntaxique particulier ajouté par le JS moderne. Si Phasis peut analyser du code moderne quelconque avec acorn, le runtime est fiable.
• mustache.js — le templating fait partie des usages d'intégration explicitement visés par Phasis (le premier exemple concret de README est « les moteurs de templating »). Mustache met à l'épreuve l'itération, la résolution de portée et les transformations de chaînes dans le même ordre que les vrais modèles.
• lodash — la bibliothèque utilitaire JS la plus utilisée au monde. Ses plus de 300 fonctions font appel indirectement à chaque méthode de la bibliothèque standard. Si lodash fonctionne, la transformation générique de données JS fonctionne.
• marked — rendu Markdown. Mise à l'épreuve concrète des expressions régulières (en grand nombre) et de la manipulation de chaînes avec état interligne. Révèle les écarts entre le moteur d'expressions régulières PCRE2 (solution de repli de Phasis) et Irregexp de V8.
• dayjs — les calculs de date et d'heure sont une source classique d'erreurs de décalage d'un jour qu'aucun cas test262 ne détecte. dayjs teste les variantes du constructeur, les calculs autour de limites mensuelles équivalentes au passage à l'heure d'été et le développement des jetons de format, dans les mêmes parties du code que celles utilisées par chaque bibliothèque de dates JS.
• bignumber.js — l'arithmétique de précision arbitraire sans TypedArrays met à l'épreuve l'analyse des nombres sous forme de chaînes, les boucles de multiplication et division de grands entiers et le choix du mode d'arrondi — le tout en JS pur, l'environnement devant donc prendre en charge tous les coûts. Révèle toute anomalie subtile de conversion entre Number et String.
• json5 — l'analyse souple de JSON repose fortement sur les expressions régulières à classes de caractères et la tokenisation avec état. Un bon indicateur de la justesse des expressions régulières et des limites de l'itération sur les chaînes.
• fuse.js — un module UMD transpilé par Babel qui met à l'épreuve _classCallCheck (le modèle this instanceof Ctor utilisé par toutes les classes transpilées avant ES6) et l'algorithme complet de recherche floue bitap. Une structure commune aux bibliothèques transpilées par Babel : tout ce qui casse Fuse casse la moitié de l'écosystème npm.
• handlebars — templating complet avec compilation puis rendu. Met à l'épreuve le chemin d'exécution sans eval via une seule énorme entrée compile(), le parcours de l'AST, la répartition des helpers via une table de recherche dynamique et la vérification de marqueurs SafeString qui utilise instanceof entre différents realms. Un point de comparaison avec le parcours de modèles plus simple de mustache.js.
• zod — validation de schémas à l'exécution. Hiérarchies de classes complexes (ZodString, ZodObject, ZodArray, ZodUnion, …) avec chaînage de méthodes renvoyant des sous-classes affinées, mise en forme structurée des erreurs où la structure du tableau .issues côté JS doit correspondre octet par octet à celle de Node, et modèles de discriminateurs et de balises littérales. Met à l'épreuve le code de validation riche en objets utilisé dans la moitié des applications TypeScript modernes.
• typescript — le véritable compilateur TypeScript exécuté sur le moteur intégré. Un compilateur minifié de 9 MB qui réanalyse du code TS arbitraire, parcourt l'AST et produit JS — le contenu JS pur le plus lourd qui soit. Si Phasis peut transcompiler les génériques, async/await, les enums et les hiérarchies de classes avec une sortie identique octet par octet à tsc, la sémantique du langage est fiable.
• prettier — formateur JS au style affirmé. Formater JS avec JS fait passer chaque particularité de la spécification du moteur par le même flux de contrôle que celui qui formate le code : une charge de travail particulièrement exigeante.
• svelte/compiler — compilateur autonome de Svelte. Analyse du code source .svelte, parcours de l'AST et production de JS pour les cibles client et SSR.
• terser / @babel/parser / postcss — minificateur JS, analyseur JS, post-processeur CSS. Des dizaines de milliers de lignes de code minifié qui réanalysent des entrées arbitraires — un terrain propice à l'apparition de structures AST rares.
• ajv — validateur de schémas JSON qui compile à la volée chaque schéma en une fonction de validation personnalisée via new Function(...). Met à l'épreuve le chemin du constructeur Function utilisé par la plupart des bibliothèques de schémas et de templating.
• mobx — état réactif fondé sur Proxy. Chaque lecture d'une valeur observable passe par un piège Proxy get qui enregistre une dépendance ; chaque écriture déclenche des réactions. Mise à l'épreuve de l'infrastructure Proxy, des Maps, tableaux et objets imbriqués observables, ainsi que de l'ordonnanceur autorun.
• cheerio / htmlparser2 — jQuery côté serveur reposant sur un analyseur HTML rapide. Analyse par moteur de sélecteurs, parcours de type DOM, manipulation d'attributs et sérialisation HTML dans un seul paquet.
• graphql-js / jsonata — implémentation de référence GraphQL et langage de requête JSON. Les deux s'appuient fortement sur les schémas, la validation et les évaluateurs récursifs — typiques du code de « couche de données dans le navigateur ».
• JSZip — générateur asynchrone d'archives ZIP. Planifie le travail via un ordonnancement fondé sur setImmediate et produit une véritable sortie binaire, mettant à l'épreuve la surface des temporisateurs et les chemins riches en Uint8Array.
• moment / luxon — calculs de date et d'heure. moment est un UMD mutable, optimisé manuellement ; luxon en est la réécriture moderne immuable. Ensemble, ils couvrent toute la surface du formatage, de l'analyse et des calculs de mois et d'années équivalents entre fuseaux horaires.
• mqtt-packet — codec MQTT 3.1.1 / 5.0 entièrement en JS. Empaquetage et décodage octet par octet, ainsi que les classes de caractères d'expressions régulières pour les caractères hors alphabet Base64, qui mettent à l'épreuve les limites de la grammaire Annex B.
• xstate / valtio / nanostores / jotai / redux-saga — panorama de la gestion d'état moderne. Machines à états, état Proxy, stockage par atomes, atomes dérivés et exécuteurs d'effets fondés sur des générateurs : chaque bibliothèque met à l'épreuve une forme différente de réactivité.
• escodegen / acorn-walk / estraverse / magic-string — outils AST. Génération de code, parcours et modification non destructive du code source : les briques de base de tout transformateur JS sur JS (outils de build, codemods, linters).
• papaparse / lunr / yaml / sax / css-tree — analyseurs et tokeniseurs purs. CSV, index de recherche en texte intégral, YAML 1.2, XML en flux de type SAX et AST CSS. Des grammaires différentes, toutes de bons indicateurs de la lecture au niveau des caractères et du comportement des expressions régulières.

En ajouter d'autres

Ajoutez un nouveau répertoire sous tests/Popular/<name>/ avec la structure en trois fichiers, puis :

node tests/Popular/gen-oracle.js tests/Popular/<name>   # one-time, generates oracle.txt
git add tests/Popular/<name>

La suite PHPUnit le détecte automatiquement au prochain lancement, et la CI le prend en compte puisque la modification touche tests/Popular/.

Bons candidats à ajouter : chevrotain (combinateur d'analyseurs, met à l'épreuve les fermetures et les expressions régulières), nanoid (limites de la cryptographie et de l'aléatoire), date-fns (gestion des fuseaux horaires au-delà de dayjs).