@overcrow/mcp 0.0.0 → 0.1.1

package/dist/content/docs/fr/view.md

@@ -0,0 +1,352 @@
+# La vue
+
+`view.ocml` décrit ce qu’affiche un widget PlayerVox OverCrow : un arbre
+d’éléments, lié à l’état du widget par des expressions `{…}`. Il ressemble à
+du HTML ou à du JSX, mais ce n’est ni l’un ni l’autre : le jeu d’éléments
+est fermé, il n’y a pas de DOM et la vue ne contient aucun script. OverCrow
+met en page et dessine l’arbre lui-même.
+
+<!-- source: templates/list/view.ocml -->
+```xml
+<box class="checklist">
+  <text class="title">{t("title")}</text>
+  <list class="items" item-height="32">
+    <for each={state.items} as="item" key={item.id}>
+      <box class="row">
+        <checkbox label={item.text} checked={item.done} on:change={setDone(item.id, event.value)}/>
+        <text class={item.done ? "text done" : "text"}>{item.text}</text>
+        <button class="remove" label={t("remove")} on:activate={remove(item.id)}>
+          <icon name="x"/>
+        </button>
+      </box>
+    </for>
+  </list>
+  <text class="summary">{t("remaining", { count: remaining(state.items) })}</text>
+</box>
+```
+
+C’est le template de liste de tâches : un titre, une `list` défilante qui
+répète une ligne par entrée, et un résumé. La logique exporte `setDone`,
+`remove` et `remaining` ; `t` lit les messages de `locales/`.
+
+La vue est compilée quand vous empaquetez le widget : `overcrow-widget check`
+signale chaque erreur avec sa ligne et sa colonne. Un élément, un attribut ou
+un événement inconnu est une erreur, jamais ignorée. Le fichier source
+lui-même n’est pas livré.
+
+## Balisage
+
+- Le fichier est en UTF-8, sans marque d’ordre des octets.
+- Le document est une liste de nœuds de premier niveau : des déclarations
+  `<component>` et les enfants de la racine du widget, qui est une `box`.
+- Les éléments s’écrivent en minuscules : `<name …>…</name>` ou
+  `<name …/>`.
+- La valeur d’un attribut est un texte entre guillemets (`"…"` ou `'…'`),
+  une expression (`{…}`), ou rien, ce qui vaut `true` : `<button submit>`.
+  Les attributs sont séparés par des blancs et ne se répètent jamais.
+- Les commentaires s’écrivent `<!-- … -->`, sans `--` à l’intérieur.
+- DOCTYPE, instructions de traitement, sections CDATA et espaces de noms
+  sont refusés.
+
+Les entités sont `&amp;` `&lt;` `&gt;` `&quot;` `&apos;` `&lbrace;`
+`&rbrace;` `&nbsp;`, ainsi que `&#…;` ou `&#x…;` pour tout caractère qui
+n’est pas un caractère de contrôle. Un `{` ou un `}` littéral dans une
+valeur entre guillemets, comme un `}` isolé dans du texte, est refusé :
+écrivez `&lbrace;` et `&rbrace;`.
+
+## Éléments
+
+Chaque élément a un contenu fixe, un jeu d’attributs et les événements qu’il
+peut envoyer. Les conteneurs (`box`, `scroll`, `list`, `form`, `popover`,
+`button`) contiennent d’autres éléments ; `text` contient du texte et des
+enfants en ligne ; les autres sont des feuilles qu’OverCrow dessine :
+`icon`, `image`, `toggle`, `slider`, `field`, `chart`, `gauge`…
+
+<!-- generated:element-list -->
+| Élément | Signification |
+| --- | --- |
+| [`box`](elements.md#box) | Conteneur générique ; la mise en page flex ou grid vient du style. La racine de la vue est un `box`. |
+| [`scroll`](elements.md#scroll) | Conteneur qui rogne son contenu et que l’hôte fait défiler à la molette, par glissement et au clavier. |
+| [`list`](elements.md#list) | Liste à défilement vertical dont les enfants ne sont mis en page et peints que lorsqu’ils sont visibles. |
+| [`text`](elements.md#text) | Bloc de texte avec retour à la ligne ; ses enfants en ligne suivent le texte (une ligne de chat avec des emotes). |
+| [`span`](elements.md#span) | Portion de texte stylée à l’intérieur d’un `text`. |
+| [`icon`](elements.md#icon) | Icône Lucide teintée par `color`, dimensionnée par `font-size` sauf si `width` et `height` sont définis. |
+| [`image`](elements.md#image) | Image matricielle du paquet, ou image remise par un service (identifiant `asset:`) ; `object-fit` s’applique. |
+| [`avatar`](elements.md#avatar) | Image ronde, avec un texte de remplacement tant que l’image manque ou n’a pas pu être chargée. |
+| [`badge`](elements.md#badge) | Courte pastille de texte. |
+| [`button`](elements.md#button) | Contrôle activable ; ses enfants (icône, texte) forment son contenu. |
+| [`toggle`](elements.md#toggle) | Bascule activé/désactivé. |
+| [`checkbox`](elements.md#checkbox) | Case à cocher (listes de tâches). |
+| [`slider`](elements.md#slider) | Curseur sur un intervalle numérique ; le glissement est géré par l’hôte. |
+| [`select`](elements.md#select) | Liste déroulante ; la liste ouverte est dessinée par l’hôte. |
+| [`option`](elements.md#option) | Choix d’un `select` ; son texte est le libellé affiché. |
+| [`field`](elements.md#field) | Champ de texte d’une ligne, édité par l’hôte, méthodes de saisie (IME) comprises. |
+| [`textarea`](elements.md#textarea) | Champ de texte de plusieurs lignes, édité par l’hôte, méthodes de saisie (IME) comprises. |
+| [`form`](elements.md#form) | Regroupe des contrôles nommés. Avec `intent`, la validation envoie leurs valeurs à un service d’écriture directement depuis l’hôte ; la logique du widget ne fournit jamais ce contenu. |
+| [`elapsed`](elements.md#elapsed) | Durée affichée que l’hôte fait avancer à partir d’un repère donné par un service : un chronomètre qui tourne ne demande aucun travail à la logique. Stylé comme `text` ; repeint seulement quand le texte affiché change, au plus à 60 Hz, et jamais quand le widget est masqué. |
+| [`progress`](elements.md#progress) | Barre de progression horizontale. |
+| [`gauge`](elements.md#gauge) | Jauge en anneau ou en arc. |
+| [`chart`](elements.md#chart) | Graphique en ligne, en aire, en barres ou sparkline, dessiné par l’hôte. |
+| [`series`](elements.md#series) | Une série de données d’un `chart`, colorée par `color`. |
+| [`separator`](elements.md#separator) | Filet de séparation entre deux groupes. |
+| [`canvas`](elements.md#canvas) | Surface que l’hôte peint à partir de la dernière liste de commandes passée à `draw`. |
+| [`popover`](elements.md#popover) | Panneau flottant ancré à un élément, dessiné au-dessus du contenu et rogné au cadre du widget (listes déroulantes, menus contextuels). |
+<!-- /generated:element-list -->
+
+[Éléments et attributs](elements.md) donne les attributs et les événements
+de chacun.
+
+## Texte
+
+Le texte n’est admis que dans `text`, `span`, `badge` et `option`. Un `text`
+contient soit du texte, soit des enfants en ligne (`span`, `icon`, `image`),
+jamais les deux : pour styler un seul mot, placez chaque segment dans un
+`span`.
+
+<!-- source: widgets/performance/view.ocml -->
+```xml
+      <text class={row.valueClass} label={row.name} tooltip={row.hint}><span>{row.value}</span><if test={row.unit != ""}><span class="unit">{row.unit}</span></if></text>
+```
+
+Les blancs suivent la règle de JSX :
+
+- les tabulations deviennent des espaces ;
+- un saut de ligne entre deux mots devient une espace ;
+- un saut de ligne accolé à une balise ou à une expression disparaît avec
+  son indentation ;
+- une suite de blancs accolée à une balise est supprimée ; entre deux
+  expressions sur la même ligne, elle est conservée.
+
+Un saut de ligne avant une expression supprime donc l’espace qui la
+précède : écrivez `you have {state.count} messages` sur une seule ligne pour
+garder les deux espaces, ou écrivez `&#32;` là où il vous faut une espace
+que la règle supprimerait.
+
+## Attributs
+
+Une valeur entre guillemets est convertie dans le type de l’attribut et
+vérifiée à la compilation de la vue :
+
+| Type | Valeur entre guillemets |
+| --- | --- |
+| booléen | `true` ou `false` ; l’attribut seul vaut `true` |
+| entier | un entier décimal, sans zéro initial |
+| nombre | un nombre décimal, sans exposant |
+| liste de nombres | des nombres séparés par des espaces : `values="12 18.5 30"` |
+| texte, identifiant | le texte lui-même |
+| image | un fichier du paquet : `src="assets/logo.png"` |
+
+`attr={expression}`, en revanche, lie l’attribut à une expression ; OverCrow
+vérifie chaque valeur qu’envoie le widget. Les valeurs qui n’existent qu’à
+l’exécution du widget, comme une image fournie par un service, doivent être
+liées.
+
+Cinq attributs existent sur tous les éléments :
+
+<!-- generated:common-attributes -->
+| Attribut | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `class` | liste de classes | non | Classes de style : des noms distincts, séparés par une espace. |
+| `ref` | nom de `ref` statique | non | Nom par lequel `draw` désigne ce `canvas` et par lequel un attribut tel que `anchor` d’un `popover` désigne cet élément. Statique, unique dans la vue, et interdit dans un `for` ou dans le corps d’un composant, où il nommerait plusieurs éléments. |
+| `label` | texte ≤ 256 octets | non | Nom accessible ; obligatoire sur les contrôles qui ne montrent qu’une icône. |
+| `tooltip` | texte ≤ 256 octets | non | Texte brut que l’hôte affiche au survol ou au focus. |
+| `on` | noms d’événements triés | non | Événements transmis à la logique ; s’écrit `on:<event>` dans la vue. |
+<!-- /generated:common-attributes -->
+
+`class` est le point d’accroche du [style](style.md). `label` est le nom
+accessible de l’élément : donnez-en un à chaque contrôle dont le contenu est
+une icône.
+
+### Nommer un élément : `ref`
+
+`ref="name"` donne un nom à un élément. Ce nom sert à deux choses :
+`draw(name, commands)` dessine dans le `canvas` de ce nom, et un `popover`
+se place contre l’élément que nomme son `anchor`.
+
+<!-- source: docs/content/examples/countdown/view.ocml -->
+```xml
+<box ref="panel" class="countdown" on:contextmenu={openMenu}>
+```
+
+<!-- source: docs/content/examples/countdown/view.ocml -->
+```xml
+<popover anchor="panel" placement="pointer" open={state.menu} on:dismiss={closeMenu}>
+  <button class="menu-row" on:activate={resetRounds}>
+    <text class="menu-text">{t("reset-rounds")}</text>
+  </button>
+</popover>
+```
+
+Un `ref` s’écrit toujours entre guillemets et il est unique dans la vue. Il
+est refusé dans un `for` ou dans un composant, où il nommerait plusieurs
+éléments.
+
+## Événements
+
+`on:event={handler}` demande à OverCrow d’envoyer à la logique un événement
+de l’élément. Sans cela, le widget ignore tout de l’événement : OverCrow ne
+lui signale ni les mouvements du pointeur ni les appuis de touches qu’il n’a
+pas demandés.
+
+Un gestionnaire s’écrit de deux façons :
+
+- **le nom d’une fonction** exportée par la logique, appelée avec le détail
+  de l’événement : `on:activate={increment}` ;
+- **un appel**, avec les arguments de votre choix ; `event` y désigne le
+  détail de l’événement : `on:change={setDone(item.id, event.value)}`.
+
+<!-- source: templates/list/view.ocml -->
+```xml
+        <checkbox label={item.text} checked={item.done} on:change={setDone(item.id, event.value)}/>
+        <text class={item.done ? "text done" : "text"}>{item.text}</text>
+        <button class="remove" label={t("remove")} on:activate={remove(item.id)}>
+          <icon name="x"/>
+        </button>
+```
+
+Les événements sont `activate`, `contextmenu`, `wheel`, `keydown`, `input`,
+`change`, `submit`, `focus`, `blur`, `reachend`, `stick` et `dismiss` ;
+[événements](elements.md#événements) décrit chacun d’eux et le détail qu’il
+transporte, et chaque [élément](elements.md#éléments) liste ceux qu’il
+envoie. Certains sont des actions de l’utilisateur, pendant lesquelles un
+widget peut appeler un service protégé ; voir
+[les appels qui demandent une action de l’utilisateur](services.md#les-appels-qui-demandent-une-action-de-lutilisateur).
+Les widgets ne reçoivent d’entrées qu’en mode interactif d’OverCrow : en
+mode passif, les clics les traversent et atteignent le jeu.
+
+## Conditions, boucles et composants
+
+<!-- generated:constructs -->
+| Syntaxe | Signification |
+| --- | --- |
+| `{expr}` | Insère la valeur d’une expression dans du texte ou dans la valeur d’un attribut. |
+| `<if test={expr}> … <else-if test={expr}> … <else>` | Sous-arbre conditionnel. |
+| `<for each={expr} as="item" key={expr}>` | Répète un sous-arbre ; `key` est obligatoire et doit être unique parmi les éléments répétés. |
+| `<component name="x" props="a b"> … <slot/> … </component>` | Composant local, avec ses propriétés déclarées et un emplacement (`slot`), utilisé sous la forme `<x a={…}>`. |
+| `on:<event>={handler}` | Abonne l’élément à l’un de ses événements et nomme le gestionnaire de la logique. |
+<!-- /generated:constructs -->
+
+### `if`, `else-if`, `else`
+
+<!-- source: widgets/stopwatch/view.ocml -->
+```xml
+        <if test={state.stopwatch.running}>
+          <icon name="pause"/>
+        </if>
+        <else>
+          <icon name="play"/>
+        </else>
+```
+
+`else-if` et `else` suivent directement un `if` : seuls des blancs et des
+commentaires peuvent les en séparer.
+
+### `for`
+
+`for` répète ses enfants pour chaque entrée d’une liste. `each`, `as` et
+`key` sont tous obligatoires, et la clé doit être unique parmi les entrées
+répétées : c’est grâce à elle qu’OverCrow sait quelle ligne a bougé, est
+apparue ou a disparu.
+
+<!-- source: widgets/warframe-market/view.ocml -->
+```xml
+      <for each={state.results} as="item" key={item.slug}>
+        <button class="result" label={item.name} on:activate={select(item.slug)}>
+          <text class="result-name">{item.name}</text>
+          <icon class="result-arrow" name="chevron-right"/>
+        </button>
+      </for>
+```
+
+Pour une longue liste, placez le `for` dans un élément `list` : OverCrow ne
+met en page et ne dessine que les lignes visibles.
+
+### Composants
+
+Un composant est un morceau de vue doté d’un nom et de propriétés déclarées,
+à écrire une fois et à utiliser plusieurs fois. Il est local à la vue.
+
+<!-- source: docs/content/examples/countdown/view.ocml -->
+```xml
+<component name="stat" props="name value">
+  <box class="stat">
+    <text class="stat-name">{name}</text>
+    <text class="stat-value">{value}</text>
+  </box>
+</component>
+```
+
+<!-- source: docs/content/examples/countdown/view.ocml -->
+```xml
+  <stat name={t("state")} value={stateText(state.running, state.remainingMs)}/>
+```
+
+- Les composants se déclarent au premier niveau, une seule fois chacun,
+  sous un nom qui n’est pas celui d’un élément.
+- Le corps ne voit que ses propres propriétés, pas les noms visibles là où
+  le composant est utilisé. Passez-lui ce dont il a besoin.
+- Une utilisation ne passe que des propriétés déclarées. Une propriété entre
+  guillemets est un texte ; liez-la (`value={5}`) pour tout autre type.
+- Un corps peut contenir un seul `<slot/>`, où vont les enfants de chaque
+  utilisation.
+- Un composant ne peut pas se contenir lui-même, et une utilisation
+  n’accepte pas de gestionnaires `on:` : placez-les sur des éléments du
+  corps.
+
+`if`, `for` et les composants sont transparents pour les règles de contenu :
+leurs enfants doivent convenir à l’élément qui les entoure.
+
+## Expressions
+
+Les expressions forment un sous-ensemble de JavaScript, réduit et strict :
+
+- les littéraux : nombres (`0`, `12`, `1.5`), chaînes, `true`, `false`,
+  `null`, littéraux de tableau et d’objet ;
+- les noms de la portée et leurs membres : `a.b`, `a?.b`, `a[i]`,
+  `a?.[i]` ;
+- les opérateurs : `!`, `-` et `+` unaires, `* / %`, `+ -`, `< <= > >=`,
+  `== != === !==`, `&&`, `||`, `??`, et `a ? b : c`. `??` ne se combine pas
+  avec `&&` ou `||` sans parenthèses ;
+- les appels de fonctions exportées par la logique, par leur nom seul :
+  `remaining(state.items)`. `t(key, params)` en fait partie.
+
+Les noms de la portée sont `state`, les noms `as` des `for` englobants, les
+propriétés du composant englobant, et `event` dans un gestionnaire. Un nom
+ne peut pas en masquer un autre.
+
+Il n’y a ni affectation, ni fonction fléchée ou littérale, ni `new`, ni
+`this`, ni littéral de gabarit, ni expression régulière, ni appel de
+méthode, ni globale : tout ce qui dépasse un calcul simple a sa place dans
+une fonction de la logique. C’est ce qui permet de vérifier la vue : à
+l’empaquetage du widget, chaque expression est compilée en une fonction de
+`logic.js`, et la vue elle-même ne contient aucun code.
+
+<!-- source: templates/list/view.ocml -->
+```xml
+        <text class={item.done ? "text done" : "text"}>{item.text}</text>
+```
+
+Les mots réservés de JavaScript, `constructor`, `prototype`, `eval`,
+`undefined`, `globalThis`, `overcrow` et tout nom qui commence par `__` sont
+refusés.
+
+## Quand la vue est incorrecte
+
+Chaque problème est un diagnostic de `overcrow-widget check`, doté d’un code
+stable :
+
+| Code | Problème |
+| --- | --- |
+| `view.syntax`, `view.encoding`, `view.size`, `view.invalid_entity` | Le fichier n’est pas un balisage bien formé. |
+| `view.unknown_element`, `view.invalid_parent` | Un élément qui n’existe pas, ou placé là où il ne peut pas être. |
+| `view.unknown_attribute`, `view.duplicate_attribute`, `view.invalid_attribute`, `view.missing_attribute` | Un attribut que l’élément n’a pas, écrit deux fois, de valeur incorrecte, ou obligatoire et absent. |
+| `view.unknown_event`, `view.invalid_handler` | Un événement que l’élément n’envoie pas (ou posé sur l’utilisation d’un composant), ou un gestionnaire qui n’est ni un nom ni un appel. |
+| `view.expression_syntax`, `view.expression_too_long`, `view.expression_too_deep`, `view.expression_too_many_entries` | Une expression hors du sous-ensemble ou de ses limites. |
+| `view.reserved_name`, `view.unknown_name` | Un nom refusé, ou absent de la portée. |
+| `view.invalid_text` | Du texte là où l’élément n’en accepte pas, ou mêlé à des enfants en ligne. |
+| `view.invalid_component`, `view.recursive_component`, `view.invalid_slot`, `view.invalid_construct` | Un composant, un slot, un `if` ou un `for` qui enfreint ses règles. |
+| `view.invalid_ref`, `view.unknown_ref` | Un `ref` qui n’est pas unique ou qui se trouve dans un `for`, ou un `anchor` qui n’en nomme aucun. |
+| `view.missing_asset` | Une image statique absente de `assets/`. |
+| `view.bound_value` | Un `value` sur un contrôle d’un formulaire lié à un intent d’écriture ; voir [les formulaires](forms.md#les-formulaires-qui-écrivent-des-données-de-lutilisateur). |
+| `view.too_many_elements`, `view.too_many_components`, `view.too_many_children`, `view.too_many_expressions`, `view.too_deep` | Une [limite](limits.md) de la vue est dépassée. |
+| `logic.missing_export` | La vue appelle une fonction que la logique n’exporte pas. |

package/dist/content/docs/fr/widget-listing.md

@@ -0,0 +1,69 @@
+# Fiche : bonnes pratiques
+
+La fiche est ce que les joueurs lisent dans le catalogue de PlayerVox
+OverCrow avant d’installer un widget : sa description, son aperçu, sa
+catégorie, ses jeux, sa licence et ses liens. Vous l’écrivez dans l’espace
+créateurs, dans l’onglet **Fiche** du widget.
+
+## Enregistrée au fil de la saisie
+
+La fiche est un brouillon, enregistré tout seul pendant que vous écrivez.
+
+- La première fiche d’un widget part en revue avec sa première version.
+- Les modifications suivantes partent seules en revue rapide :
+  **Soumettre la fiche**. Elles ne demandent pas de nouvelle version du
+  widget. **Annuler les modifications** ramène le brouillon à la fiche
+  publiée.
+- La catégorie fait exception : vous la changez quand vous voulez, sans
+  revue, et le changement arrive aux joueurs avec la prochaine publication
+  du catalogue.
+
+## Langues
+
+L’anglais vient en premier : c’est la langue par défaut, montrée quand la
+langue d’un joueur n’a pas de description. **Ajouter une langue** en ajoute
+une autre, 16 langues au plus. Le nom du widget vient de son manifeste
+(`name.en`, `name.fr`) : pour le changer, changez le manifeste et envoyez une
+version. Les langues de l’interface du widget viennent de ses fichiers
+`locales/`.
+
+## Description
+
+- 500 caractères au plus par langue. Les deux premières lignes apparaissent
+  sur la carte du catalogue : dites simplement ce que fait le widget.
+- Dites quand le widget contacte un serveur, et lequel.
+- Pas de publicité, et aucune promesse que le widget ne tient pas.
+
+## Image d’aperçu
+
+Une seule image, en anglais, pour toutes les langues : un PNG au format 4:3,
+de 480 × 360 à 1 024 × 768 (1 024 × 768 conseillé), 256 Kio au plus.
+Montrez le widget en situation, sans texte marketing.
+
+## Catégorie et jeux
+
+La catégorie place le widget dans le catalogue. Ajoutez jusqu’à cinq jeux
+pour lesquels il est fait : les joueurs filtrent le catalogue par jeu.
+
+## Licence et liens
+
+- **Licence** : « Propriétaire, tous droits réservés », ou une licence SPDX
+  comme `MIT` ou `Apache-2.0`.
+- **Assistance** : une adresse e-mail ou une page web où les joueurs
+  trouvent de l’aide. Obligatoire.
+- **Politique de confidentialité** : obligatoire dès que le widget utilise
+  le réseau.
+- **Code source public** : facultatif ; un dépôt public ajoute le badge
+  « Code source public ».
+
+Tapez une adresse comme vous la connaissez (`exemple.com/confidentialite`) :
+`https://` est ajouté pour vous, et un `/` après un domaine seul
+(`exemple.com` est enregistré `https://exemple.com/`). Une adresse en
+`http://` est refusée.
+
+## Depuis listing.json
+
+Les sources d’une version peuvent contenir un `listing.json`, tel que
+l’outil en ligne de commande le lit (voir [`admit`](cli.md#admit)). Dans
+l’onglet **Fiche**, **Importer listing.json** applique ses descriptions, sa
+licence et l’adresse de son code source au brouillon.

package/dist/content/docs/fr/widget-review.md

@@ -0,0 +1,59 @@
+# Revue : types, délais, recours
+
+Chaque version d’un widget PlayerVox OverCrow, et chaque modification de sa
+fiche, est lue par une personne de PlayerVox avant que les joueurs ne la
+reçoivent. Cette page couvre les deux types de revue, leurs délais, le fil
+de revue et le recours. Pour envoyer une version, voir
+[publier un widget](publish-a-widget.md).
+
+## Rapide ou complète
+
+| Revue | Quand | Délai maximal |
+| --- | --- | --- |
+| Complète | La première publication, ou une mise à jour qui ajoute une permission, une route réseau ou une capability | 5 jours ouvrés |
+| Rapide | Toute autre mise à jour, ou une modification de la fiche seule | 2 jours ouvrés |
+| Recours | Une fois par décision, sous six mois | 7 jours |
+| Publication | Après l’approbation | 24 heures ouvrées |
+
+Les jours ouvrés vont du lundi au vendredi, hors jours fériés en France. Le
+délai est suspendu tant que la revue attend votre réponse ou une version
+corrigée. Une revue rapide lit les lignes modifiées depuis la dernière
+version approuvée ; une revue complète lit l’ensemble du widget.
+
+## Le fil de revue
+
+Chaque version en revue a un fil dans l’espace créateurs :
+
+- Une **remarque** pointe un fichier et une ligne, cite le code que le
+  relecteur a lu et une règle numérotée des règles de publication.
+- Vous pouvez **répondre** au relecteur. Votre réponse renvoie la revue au
+  relecteur quand elle vous attendait.
+- Une **version corrigée** reprend le même fil : envoyez-la depuis
+  **Envoyer une version**, avec un numéro de version plus récent.
+- La **décision** est une approbation, des modifications demandées ou un
+  refus, toujours motivés.
+
+Les relecteurs apparaissent comme « Relecteur PlayerVox », jamais par leur
+nom. Chaque fois qu’un relecteur ouvre vos sources, l’espace créateurs
+montre quand, quelle version et pourquoi, dans **Accès à vos sources**.
+
+## Recours
+
+Vous pouvez contester un refus ou une suspension une fois par décision,
+sous six mois, avec **Contester la décision**. PlayerVox réexamine
+entièrement la décision et vous répond sous 7 jours, de façon motivée. Vous
+pouvez toujours envoyer une nouvelle version à la place.
+
+## Suspension
+
+Quand les joueurs sont en danger (code malveillant, clé divulguée, fuite de
+données), PlayerVox peut suspendre un widget ou une version aussitôt : les
+copies installées sont désactivées. L’espace créateurs donne le motif et la
+règle, et le recours reste ouvert.
+
+## Retrait
+
+Vous pouvez retirer une version ou le widget entier à tout moment : il sort
+du catalogue à la prochaine publication, et les copies installées
+continuent de fonctionner. Une version en revue, ou approuvée et pas encore
+publiée, est retirée tout de suite.

package/dist/content/docs/fr/widget-statistics.md

@@ -0,0 +1,141 @@
+# Statistiques : définitions
+
+L’onglet **Statistiques** d’un widget, dans l’espace créateurs, montre comment
+les joueurs l’utilisent : installations, joueurs actifs par jour, erreurs et
+note des joueurs. PlayerVox OverCrow envoie ces chiffres de façon anonyme. Ce
+sont des tendances, pas des comptes exacts : cette page dit ce que compte
+chaque chiffre et ce qu’il laisse de côté.
+
+## D’où viennent les chiffres
+
+Une fois par jour au plus, à un moment tiré au hasard, OverCrow envoie un
+signal anonyme pour chaque widget installé depuis le catalogue : le widget,
+sa version, le jour, le système (Windows ou Linux), la version d’OverCrow, si
+le widget a été affiché, installé ou désinstallé ce jour-là, et ses erreurs
+(type, endroit du code, nombre arrondi).
+
+- **Aucun identifiant** : rien ne désigne le joueur ni l’ordinateur, et rien
+  ne relie les widgets d’un même joueur, chaque widget étant envoyé à part.
+- **Aucun message d’erreur** : seulement le type d’une erreur et son endroit
+  dans votre code. Un message peut contenir des données personnelles.
+- **Activé par défaut** : les joueurs peuvent couper **Partager des
+  statistiques anonymes** dans OverCrow ; plus rien n’est envoyé ensuite, et
+  ils ne sont plus comptés.
+
+Les chiffres s’additionnent à l’arrivée des signaux. **Mis à jour** donne
+l’heure du dernier signal compté.
+
+## Les chiffres
+
+| Chiffre | Ce qu’il compte |
+| --- | --- |
+| Joueurs actifs par jour | Les joueurs qui ont affiché le widget au moins une fois dans la journée. La tuile donne la moyenne par jour sur la période. |
+| Installations actives | Les installations moins les désinstallations, additionnées depuis le premier signal, jamais sous zéro. |
+| Installations · désinstallations | Les installations et les désinstallations de la période, et leur solde. Une mise à jour n’est ni l’une ni l’autre. |
+| Erreurs | La somme des erreurs signalées sur la période. |
+
+Chaque tuile compare son chiffre à la période juste avant, de même durée :
+vert quand il évolue dans le bon sens (moins d’erreurs, plus de joueurs),
+ambre dans l’autre sens, gris quand il bouge de moins de 1 %. **Première
+période** signifie qu’il n’y a rien avant pour comparer.
+
+## Périodes et filtres
+
+- **Période** : 7 jours, 28 jours, 90 jours ou 12 mois. Sur 12 mois, le
+  graphique des installations et désinstallations additionne chaque semaine.
+- **Version** : une de vos versions publiées. Les installations actives
+  affichent « — » avec une version : une installation change de version à
+  chaque mise à jour, ce chiffre n’a donc de sens que pour toutes les
+  versions. **Adoption des versions** compare les versions et ne suit pas ce
+  filtre.
+- **Système** : Windows ou Linux. **Où tourne votre widget** compare les
+  systèmes et ne suit pas ce filtre.
+- La note ne suit aucun filtre.
+
+Chaque graphique a **Voir en tableau**, avec les mêmes chiffres jour par
+jour.
+
+## Adoption des versions et où tourne votre widget
+
+- **Adoption des versions** : la part des joueurs actifs du jour sur chaque
+  version. Les trois versions les plus récentes gardent leur couleur ; les
+  autres s’additionnent dans **Plus anciennes**.
+- **Où tourne votre widget** : la part des joueurs actifs sous Windows et
+  sous Linux, et sur chaque version d’OverCrow (les deux plus utilisées, puis
+  **Autres**).
+
+## Erreurs
+
+Les erreurs sont regroupées par type et par endroit du code : le même type à
+la même ligne de la même fonction forme un groupe, quelle que soit la
+version. Le tableau montre les 50 groupes les plus fréquents de la période,
+avec leurs versions, leur nombre et leur tendance ; **Exporter CSV** les
+enregistre.
+
+OverCrow signale où une erreur s’est produite dans le `logic.js` du paquet.
+L’espace créateurs retrouve cette position dans vos sources (fichier, ligne
+et fonction) grâce à une carte de votre code construite avec le paquet et
+jamais publiée.
+
+- **Retraduction en cours** : la position s’affiche en
+  `logic.js:ligne:colonne` jusqu’à ce qu’elle soit retrouvée.
+- **Non retrouvée** : la version n’a pas de carte, ou la position n’y figure
+  pas ; la position brute reste.
+- **Sans position dans le code** : le widget s’est arrêté tout entier
+  (budget dépassé, plus de réponse) ; voyez son type.
+- **SDK** : l’erreur s’est produite dans `@overcrow/sdk`, appelé depuis votre
+  code.
+
+| Type | Signification |
+| --- | --- |
+| `Error` | Erreur levée |
+| `TypeError` | Valeur d’un type inattendu |
+| `RangeError` | Valeur hors limites |
+| `ReferenceError` | Nom inconnu |
+| `SyntaxError` | Syntaxe invalide |
+| `URIError` | Encodage d’adresse invalide |
+| `EvalError` | Évaluation de code refusée |
+| `AggregateError` | Plusieurs erreurs à la fois |
+| `InternalError` | Limite du moteur atteinte |
+| Valeur levée | Une valeur qui n’est pas une erreur a été levée |
+| Budget mémoire ou de calcul dépassé | Le widget a été redémarré |
+| Ne répondait plus | Le widget a été redémarré |
+| Échec du chargement | Le code ou la vue n’a pas pu se charger |
+| Processus du widget arrêté | Sans erreur signalée |
+| Requête réseau refusée | Adresse non déclarée dans le manifeste |
+| Autre erreur | D’un type que l’espace créateurs ne connaît pas encore |
+
+Le type d’une erreur est le type intégré dont elle a été créée, jamais le
+`name` que votre code peut lui donner.
+
+## Note des joueurs
+
+Les joueurs notent un widget de 0 à 100 dans le Centre de contrôle
+d’OverCrow, avec leur compte PlayerVox : une note par compte et par widget,
+qu’ils peuvent modifier ou retirer.
+
+- **Score** : la moyenne des notes, arrondie, avec son rang : S+ dès 90, S
+  dès 80, A dès 70, B dès 60, C dès 40, D dès 20, puis F.
+- **À partir de 5 notes** : en dessous, l’espace créateurs indique **Pas
+  encore assez de notes** et donne le nombre de notes ; le catalogue
+  n’affiche rien.
+- **Répartition par rang** : le nombre de notes dans chaque rang, visible
+  seulement dans l’espace créateurs. Personne ne voit qui a noté.
+- **Depuis la dernière version** : les points gagnés ou perdus depuis la
+  publication de votre dernière version, si 5 notes existaient avant elle.
+- Les membres de votre éditeur ne peuvent pas noter ses widgets.
+
+Les joueurs voient le score, le rang et le nombre de notes dans le catalogue
+et sur le site.
+
+## Des tendances, pas des comptes exacts
+
+- Seuls les joueurs qui partagent leurs statistiques anonymes sont comptés.
+- OverCrow arrondit chaque nombre d’erreurs à un palier avant de l’envoyer,
+  et envoie au plus 10 endroits du code par widget et par jour : les chiffres
+  des erreurs donnent des ordres de grandeur.
+- Un jour est la date du joueur lui-même.
+- Un joueur qui efface les données d’OverCrow, puis réinstalle le widget,
+  compte pour deux installations.
+- Les signaux qui semblent cassés ou gonflés sont écartés avant d’être
+  comptés.