@20syldev/api 5.0.0 → 5.2.0

package/recap.md

@@ -1,98 +0,0 @@
-# Récap des changements — v5.0.0
-
-## Nouveaux fichiers
-
-### `src/modules/v5/evaluate.ts`
-Parseur Pratt (sans `eval()`) pour évaluer des expressions mathématiques.
-- Tokenizer → récursif avec binding powers → évaluateur AST
-- Constantes : `pi`, `e`
-- 14 fonctions : `sin`, `cos`, `tan`, `asin`, `acos`, `atan`, `sqrt`, `abs`, `floor`, `ceil`, `round`, `log`, `log2`, `log10`
-- Opérateurs : `+` `-` `*` `/` `%` `^` (unaire `-`)
-- Division par zéro et identifiants inconnus → exception
-- Profondeur max : `MAX_EXPR_DEPTH = 100`
-- Longueur max : `MAX_EXPR_LENGTH = 500`
-
-### `src/modules/v5/matrix.ts`
-8 opérations matricielles (namespace export).
-- `add`, `subtract`, `multiply`, `scalar`, `transpose`, `determinant`, `inverse`, `identity`
-- Déterminant : élimination gaussienne avec pivot partiel
-- Inverse : Gauss-Jordan
-- Validation : tableau 2D, longueurs uniformes, nombres finis, max `MAX_MATRIX_SIZE = 20`
-
-### `src/modules/v5/chart.ts`
-Génération SVG de graphiques (bar, line, pie, donut).
-- **Dimensions** : `width`/`height` optionnels → si fournis, `viewBox` adapté + attrs sur `<svg>` ; sinon pas d'attrs (SVG responsive qui remplit son conteneur)
-- **`legend`** (bool, défaut `true`) : masque la légende si `false`
-- **`mode`** (`"svg"` défaut ou `"data"`) : retourne le SVG ou les données brutes JSON
-- `ChartOutput` : union type `image/svg+xml | application/json`
-- Axes dessinés avant les données (points par-dessus les axes)
-- Marges : `{ bottom: 40, left: 50, right: 40, top: 30 }`
-- Max : `MAX_CHART_LABELS = 20`, `MAX_CHART_DATASETS = 5`
-- Échappement XML des labels (`<`, `>`, `&`, `"`)
-
-### `src/modules/v5.ts`
-Barrel v5 — exports nommés depuis le barrel v4 + v5-specifics.
-```ts
-export { address, agent, ..., validate } from './v4.js'; // héritage sans ambiguïté
-export * as chart from './v5/chart.js';
-export { default as evaluate } from './v5/evaluate.js';
-export * as matrix from './v5/matrix.js';
-```
-Avantage : pour upgrader un endpoint v4 en v5, on retire son nom de la liste v4 et on ajoute un export v5.
-
-### `tests/unit/evaluate.test.ts`
-### `tests/unit/matrix.test.ts`
-### `tests/unit/chart.test.ts`
-Tests unitaires avec `node:test` + `node:assert`. 654 tests au total, 0 échec.
-
----
-
-## Fichiers modifiés
-
-### `package.json`
-- Version `4.9.0` → `5.0.0`
-- Ajout export `"./v5": "./dist/modules/v5.js"`
-- Ajout script `prepare`
-
-### `src/constants.ts`
-```ts
-MAX_CHART_DATASETS = 5
-MAX_CHART_LABELS   = 20
-MAX_EXPR_DEPTH     = 100
-MAX_EXPR_LENGTH    = 500
-MAX_MATRIX_SIZE    = 20
-```
-
-### `src/config/versions.ts`
-- Import `apiv5`
-- Config v5 : hérite des endpoints v4 + ajout `evaluate` (GET), `chart` (POST), `matrix` (POST)
-
-### `src/types/express.d.ts`
-- Ajout `typeof apiv5` dans le type union de `req.module`
-
-### `src/routes/get.ts`
-- Handler `GET /:version/evaluate` (v5 only, 404 en v4)
-- Handlers 405 pour `GET /chart` et `GET /matrix`
-- Tous les handlers triés alphabétiquement par endpoint (`:version` en tête, sous-routes après leur parent)
-- Toutes les URLs de doc dans les erreurs 404 pointent sur `req.latest` (plus sur la version demandée)
-
-### `src/routes/post.ts`
-- Handler `POST /:version/chart` : dispatch sur `mode` → SVG (`res.type().send()`) ou JSON (`res.jsonResponse()`) ; passe `legend` et `mode` à la fonction
-- Handler `POST /:version/matrix` : switch sur `operation`
-- Handlers triés alphabétiquement : chart → chat → chat/private → hash → hyperplanning → matrix → tic-tac-toe → token
-
-### `tests/integration/api.test.ts`
-- Blocs `describe` pour `GET /v5/evaluate`, `POST /v5/matrix`, `POST /v5/chart`
-- Tests `mode: "data"` (retour JSON), 404 sur v4, 405 GET sur endpoints POST-only
-
----
-
-## Fixes
-
-| Problème | Fix |
-|---|---|
-| URLs de doc 404 pointaient sur la version demandée | Remplacé `${version}/endpoint` par `${req.latest}/endpoint` partout |
-| Donut/pie : légende coupée en bas | `chartAreaH` soustrait correctement `MARGIN.top` + gap |
-| Line chart : point du premier label masqué par l'axe Y | Axes dessinés avant les données |
-| `width`/`height` SVG : fond blanc s'agrandissait sans changer le dessin | `renderW`/`renderH` = dimensions réelles de dessin (= `viewBox`) ; `displayW`/`displayH` = attrs SVG uniquement si fournis |
-| `export * from './v4.js'` dans v5.ts : ambiguïté si upgrade d'un endpoint | Remplacé par exports nommés explicites depuis `./v4.js` |