epic(core): intégration DSFR Chart 2.1.x — API cartes unifiée + décommission dsfr-data-world-map (Option A)

[bmatge]

Suite au rapport d'analyse (2026-07-16) : docs/RAPPORT-dsfr-chart-2.1-cartes.md sur branche claude/dsfr-charts-updates-wlju9n.
Runtime déjà en 2.1.1 (cdn-versions.ts), mais code encore aligné sur 2.0.4 → bug DataBox actif en prod.

🎯 Objectifs

1. Corriger le bug DataBox title/name en prod (P0).
2. Adopter la nouvelle API cartes unifiée <map-chart level="…"> : corrige la limitation map-reg connue, ajoute map-aca / map-monde.
3. Aligner toute la doc statique CDN sur 2.1.1 (SRI regen).
4. Décommissioner dsfr-data-world-map (Option A validée) : utiliser <map-chart level=\"monde\"> upstream, retirer d3-geo / topojson / world-atlas (~31 Ko bundle + 140 Ko asset). Perte assumée : zoom continent interactif + support iso-a3 / iso-num.

🔴 P0 — DataBox `title` → `name` (bug actif prod)

Renommé en DSFR Chart 2.1.0 (conflit avec l'attribut HTML `title`). Titres invisibles depuis le bump 2.1.1.

• `packages/core/src/components/dsfr-data-chart.ts:1121` — poser `name` (option robuste : `name` et `title` pour hôtes 2.0.x)
• `apps/builder/src/ui/code-generator.ts:119` — générer `name="…"`
• `apps/builder-ia/src/ui/{code-generator,chart-renderer}.ts` — vérifier la génération DataBox
• Aucun changement d'API publique (`databox-title` reste notre attribut)
• Changeset : patch

🟠 P1 — `map-reg` → `<map-chart level="reg">`

Résout la limitation documentée dans `specs/charts/map-chart.html:48`.

• `dsfr-data-chart.ts` — dans `_getTypeSpecificAttributes()`, router `map`/`map-reg` vers `` avec `level="dep"`/`"reg"` (au lieu de `` sans `region`)
• Répercuter dans `apps/builder-ia/src/ui/{code-generator,chart-renderer}.ts`
• Retirer la mention "limitation connue" dans specs/guide
• Changeset : patch (correction de comportement)

🟢 P2 — Nouveaux types `map-aca` et `map-monde`

Étendre `DSFRChartType` + `CHART_TAG_MAP` (tous → `` avec le bon `level`).

• `packages/core/src/components/dsfr-data-chart.ts` — types, `CHART_TAG_MAP`, `_processMapData()`, `_getAriaLabel()` ("carte académies", "carte monde")
• `map-aca` : clés = nom d'académie majuscule ("PARIS", "LYON", "STRASBOURG")
• `map-monde` : clés = ISO 3166-1 alpha-2. Convertir depuis a3/num via `continent-lookup.ts` (à préserver après P4)
• `apps/builder-ia/src/skills.ts` — ajouter les types (test `skills.test.ts` garde-fou)
• `apps/builder-ia/src/ui/{chart-renderer,code-generator}.ts`
• `apps/grist-widgets/src/chart.ts` — dropdown types
• `specs/charts/map-chart.html` — documenter les 4 `level`
• Changeset : minor

🔵 P3 — Bump doc statique CDN 2.0.4 → 2.1.1 (96 occurrences)

• `README.md`, `guide/.html` (15), `guide/examples/` (6), `specs/charts/` (8), `specs/components/` (5), `specs/*.html` (2), `apps/{playground,favorites,dashboard,builder,builder-ia,grist-widgets}` (index.html/src), `e2e/industrie-du-futur.html`
• Retirer les SRI figés sur 2.0.4 ou recalculer (`npm run generate-sri`)
• `tests/apps/dashboard/dashboards.test.ts:21-23` — URLs 2.0.4 → 2.1.1
• Idéal : faire pointer les pages/tests sur `CDN_URLS` (`cdn-versions.ts`) pour supprimer la version en dur (cf [J3] Shared app-side : code mort, contrats non typés, versions CDN désynchronisées #322)
• Pas de changeset (hors `packages/core/src`)

🎯 P4 — Décommission `dsfr-data-world-map` (Option A)

Utiliser `<map-chart level="monde">` upstream + retirer d3-geo + topojson + world-atlas.

Perte assumée : zoom continent interactif + support iso-a3 / iso-num (les lookups `continent-lookup.ts` restent pour convertir a3/num→a2 dans `_processMapData()`).

Cycle de dépréciation :

• Release N (avec P2) : `type="map-monde"` disponible sur `dsfr-data-chart`. `dsfr-data-world-map` `console.warn("deprecated, use dsfr-data-chart type=\"map-monde\"")`.
• Release N+1 (major) : retirer.

Fichiers (v N+1) :

• Lib : `packages/core/package.json` export `./world-map`, devDeps `d3-geo`/`topojson-client`/`world-atlas`/`@types/*`
• `packages/core/src/index.ts:24`, `index-world-map.ts`, `scripts/build-lib.ts:88-100` (bundle world-map)
• Composant `dsfr-data-world-map.ts` + `data/country-names.ts` + `world-countries-110m.json`
• ⚠️ Conserver `data/continent-lookup.ts` (converter a3/num→a2 pour `map-monde`)
• ⚠️ Conserver `CHOROPLETH_SCALES` (partagé avec `dsfr-data-map-layer`)
• Apps : `skills.ts` (skill world-map), `playground/{index.html,examples}`, `pipeline-helper/html-parser.ts`, `app-ui/app-layout-demo.ts`
• Doc : `guide/guide-exemples-world-map.html`, `guide/guide-demo-complete.html`, `guide/guide-menu.js`, `specs/components/dsfr-data-world-map.html`, `specs/index.html`, `index.html`
• e2e : `guide-examples.spec.ts`, `playground-examples.spec.ts`, `specs-live.spec.ts`
• tests : `dsfr-data-world-map.test.ts`, `world-map-a11y.test.ts`, `display-states-harmonized.test.ts`, `palettes-unified.test.ts`
• `docs/THIRD-PARTY-LICENSES.md`, `docs/ARCHITECTURE.md:428` (table bundles), `packages/core/src/README.md`
• Nettoyer aussi `packages/core/package 2.json` (doublon parasite)
• Changeset : major (retrait export public `./world-map`)

✅ Validation (obligatoire, ARCHITECTURE.md:714)

• `npm run build` puis preview réelle des 4 cartes (`dep`/`reg`/`aca`/`monde`) + une DataBox → titre visible + cartes correctes
• `npm run test:run` — dont `skills.test.ts`, `cdn-versions-alignment.test.ts`
• E2E Playwright — smoke playground

📎 Références

• Rapport complet : `docs/RAPPORT-dsfr-chart-2.1-cartes.md` (branche `claude/dsfr-charts-updates-wlju9n`)
• Upstream : https://github.com/GouvernementFR/dsfr-chart (tag v2.1.1)
• CHANGELOG upstream : https://github.com/GouvernementFR/dsfr-chart/blob/main/CHANGELOG.md
• Couplage skills.ts : ARCHITECTURE.md:706
• Piège deferred attributes cartes : ARCHITECTURE.md:634

[bmatge]

Point d'avancement — vérification sur feat/402-dsfr-chart-2.1 (PR #404, mergée)

Vérification item par item du code local (commits 23fc12e + c59a264, PR #404, + travail non commité en cours sur le playground). Bilan : P0, P1, P2, P3 et P4-release-N sont faits. Reste le P4 release N+1 (retrait effectif, major) — l'issue reste donc ouverte.

🔴 P0 — DataBox title → name

Item	État	Preuve
dsfr-data-chart.ts pose name (+ title compat 2.0.x)	✅	packages/core/src/components/dsfr-data-chart.ts:1169-1170
Builder : embed génère name="…"	✅	apps/builder/src/ui/code-generator.ts:120
builder-ia : génération DataBox vérifiée	✅	Non concerné — passe par notre attribut databox-title (cf. PR #404)
Pas de changement d'API publique (databox-title conservé)	✅	dsfr-data-chart.ts (prop databoxTitle)
Changeset patch	✅	.changeset/databox-name-map-level.md

🟠 P1 — map/map-reg → <map-chart level>

Item	État	Preuve
Routage map/map-reg → `<map-chart level="dep	reg">`	✅
Répercuté dans builder-ia (code-generator + chart-renderer)	✅	apps/builder-ia/src/ui/code-generator.ts:499-500, chart-renderer.ts:367-368 (MAP_LEVEL_MAP)
Mention « limitation connue » retirée	✅	specs/charts/map-chart.html — plus aucune occurrence ; <map-chart-reg region> re-documenté (zoom sur UNE région, l.103)
Changeset patch	✅	.changeset/databox-name-map-level.md

🟢 P2 — Nouveaux types map-aca / map-monde

Item	État	Preuve
Types + CHART_TAG_MAP + _processMapData() + _getAriaLabel()	✅	packages/shared/src/charts/chart-types.ts:19-20,30-31,45-46 ; dsfr-data-chart.ts:489 (conversion a2), :773-774 (aria)
map-aca clés académies majuscules / map-monde ISO a2 (a3/num convertis via continent-lookup.ts)	✅	packages/core/src/data/continent-lookup.ts (toIsoA2, +29 l.)
apps/builder-ia/src/skills.ts (+ garde-fou skills.test.ts)	✅	skills.ts:97-98,1115-1116,1160-1161,1207,1212 — 3594 tests verts
builder-ia chart-renderer / code-generator	✅	idem P1
apps/grist-widgets/src/chart.ts dropdown	✅	chart.ts:34-35
specs/charts/map-chart.html — 4 level documentés	✅	l.26 (dep), 45 (reg), 64 (aca), 83 (monde)
Changeset minor	✅	.changeset/map-aca-monde.md

🔵 P3 — Doc statique CDN 2.0.4 → 2.1.1

Item	État	Preuve
README, guide (15+6), specs (15), apps, e2e	✅	44 fichiers HTML dans la PR ; grep 2.0.4 ne matche plus que les artefacts dist/ (générés)
SRI recalculés	✅	ex. specs/index.html:14,21 — hashes 2.1.1
tests/apps/dashboard/dashboards.test.ts	✅	l.20-23 : mock sur CDN_URLS 2.1.1
Idéal : pointer pages/tests sur CDN_URLS (cf #322)	➖	Fait pour les tests ; pages statiques toujours en dur (2.1.1) — nice-to-have, reste rattaché à #322

🎯 P4 — Décommission dsfr-data-world-map

Item	État	Preuve
Release N : type="map-monde" dispo + dépréciation console.warn	✅	dsfr-data-world-map.ts:95 (@deprecated), :156-157 (warn) ; notices dans specs/components/dsfr-data-world-map.html et guide/guide-exemples-world-map.html
Release N+1 (major) : retrait effectif	⏳	Volontairement non fait (cycle en 2 releases) — export ./world-map, devDeps d3-geo/topojson/world-atlas, composant, bundles, doc, tests et package 2.json toujours présents

✅ Validation

Item	État	Preuve
npm run build	✅	Build OK (12 bundles, dont world-map encore présent — attendu en release N)
npm run test:run (dont skills.test.ts, cdn-versions-alignment.test.ts)	✅	148 fichiers / 3594 tests verts (vérifié le 2026-07-17)
Preview réelle 4 cartes + DataBox / E2E smoke playground	⏳	Exemples playground direct-map-reg/aca/monde + spec e2e en cours d'ajout (travail local non commité) — smoke Playwright à passer

📋 Reste à faire (bloque la fermeture)

1. P4 release N+1 (changeset major) — retirer : export ./world-map + devDeps (d3-geo, topojson-client, world-atlas, @types/*), index-world-map.ts, scripts/build-lib.ts (bundle), dsfr-data-world-map.ts + data/country-names.ts + world-countries-110m.json, références apps/guide/specs/e2e/tests, docs/THIRD-PARTY-LICENSES.md, docs/ARCHITECTURE.md (table bundles), et nettoyer packages/core/package 2.json — en conservant continent-lookup.ts et CHOROPLETH_SCALES.
2. Commiter le travail playground en cours (exemples map-reg/aca/monde + e2e) et passer le smoke E2E playground.
3. (Optionnel, cf [J3] Shared app-side : code mort, contrats non typés, versions CDN désynchronisées #322) migrer les pages statiques vers CDN_URLS.

[bmatge]

Mise à jour du point « reste à faire » n°2 du commentaire précédent : le travail playground/e2e est désormais poussé — PR #405 (exemples direct-map-reg / direct-map-aca / direct-map-monde / unpivot-series-line, dépréciation world-map dans le menu, fix du tour guidé qui bloquait les e2e — smoke 5/5 ✅). Il ne reste donc que le P4 release N+1 (retrait effectif de dsfr-data-world-map au prochain major) et l'optionnel #322.