[M3] Rédiger docs/rich-blocks.md — schémas JSON et guide d'intégration des blocs fx-* #308

Closed
opened 2026-04-06 09:02:15 +00:00 by charles · 0 comments
Owner

Contexte

Les specs (section 9.2) prévoient un fichier docs/rich-blocks.md documentant les schémas JSON de chaque type de bloc enrichi. Ce fichier est la référence pour tout agent ou développeur qui veut envoyer des messages enrichis depuis un client externe (ex : OpenClaw).

Critères d'acceptation

  • Fichier docs/rich-blocks.md créé dans le repo
  • Chaque type de bloc (fx-chart, fx-quiz, fx-poll-rich, fx-code-run, fx-card, fx-carousel, fx-timeline, fx-table-sort, fx-accordion, fx-progress, fx-math, fx-mermaid, fx-canvas) est documenté avec :
    • Description du rendu attendu
    • Schéma JSON complet des attributs data-fx-config
    • Exemple HTML minimal avec fallback textuel
  • Le protocole postMessage pour fx-canvas est documenté (CanvasToHost / HostToCanvas)
  • Un exemple de message Matrix complet (champ formatted_body) est inclus pour au moins 3 types de blocs

Notes techniques

  • Les structs Rust de référence sont dans crates/fractal-rich/src/ (block.rs, chart.rs, interactive.rs, widgets.rs, wasm_widgets.rs)
  • S'appuyer sur ST-M3-05 (schémas JSON validés dans le code) pour extraire la documentation
## Contexte Les specs (section 9.2) prévoient un fichier `docs/rich-blocks.md` documentant les schémas JSON de chaque type de bloc enrichi. Ce fichier est la référence pour tout agent ou développeur qui veut envoyer des messages enrichis depuis un client externe (ex : OpenClaw). ## Critères d'acceptation - [ ] Fichier `docs/rich-blocks.md` créé dans le repo - [ ] Chaque type de bloc (`fx-chart`, `fx-quiz`, `fx-poll-rich`, `fx-code-run`, `fx-card`, `fx-carousel`, `fx-timeline`, `fx-table-sort`, `fx-accordion`, `fx-progress`, `fx-math`, `fx-mermaid`, `fx-canvas`) est documenté avec : - Description du rendu attendu - Schéma JSON complet des attributs `data-fx-config` - Exemple HTML minimal avec fallback textuel - [ ] Le protocole `postMessage` pour `fx-canvas` est documenté (CanvasToHost / HostToCanvas) - [ ] Un exemple de message Matrix complet (champ `formatted_body`) est inclus pour au moins 3 types de blocs ## Notes techniques - Les structs Rust de référence sont dans `crates/fractal-rich/src/` (block.rs, chart.rs, interactive.rs, widgets.rs, wasm_widgets.rs) - S'appuyer sur ST-M3-05 (schémas JSON validés dans le code) pour extraire la documentation
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/my-fractal#308
No description provided.