@overcrow/mcp 0.1.0 → 0.1.2

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.

package/dist/content/examples/countdown/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "apiVersion": 1,
-  "id": "com.example.countdown",
+  "id": "nova.countdown",
   "version": "1.0.0",
   "name": { "en": "Countdown", "fr": "Compte à rebours" },
   "sizing": {

package/dist/content/examples/fps/submission.json

@@ -0,0 +1,8 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:fps.read",
+      "text": "Reads the game's presented frame rate from OverCrow, to show it in the widget."
+    }
+  ]
+}

package/dist/content/examples/media/submission.json

@@ -0,0 +1,12 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:media.read",
+      "text": "Reads the track, artist and cover your music player is playing, to show them."
+    },
+    {
+      "permission": "capability:media.control",
+      "text": "Sends previous, play/pause and next to your music player when you click the widget's buttons in Interactive mode."
+    }
+  ]
+}

package/dist/content/examples/notes/submission.json

@@ -0,0 +1,12 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:notes.read",
+      "text": "Reads your notes and checklists, kept by OverCrow on this computer, to show them over the game."
+    },
+    {
+      "permission": "capability:notes.write",
+      "text": "Saves the notes and checklist entries you create, edit, tick off or delete in Interactive mode."
+    }
+  ]
+}

package/dist/content/examples/performance/submission.json

@@ -0,0 +1,12 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:telemetry.read",
+      "text": "Reads the game's CPU and memory use and the temperatures this computer exposes, to show them."
+    },
+    {
+      "permission": "capability:fps.read",
+      "text": "Reads the game's frame rate, shown with CPU and memory unless you turn it off in the widget's options."
+    }
+  ]
+}

package/dist/content/examples/playervox-journal/submission.json

@@ -0,0 +1,12 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:journal.read",
+      "text": "Reads the finished play sessions of your game, recorded on this computer and merged with your PlayerVox journal, to list them."
+    },
+    {
+      "permission": "capability:journal.delete",
+      "text": "Deletes a play session from your journal when you confirm it in the widget."
+    }
+  ]
+}

package/dist/content/examples/playervox-rating/submission.json

@@ -0,0 +1,12 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:playervox.rating.read",
+      "text": "Reads your PlayerVox rating of the Steam game you play (grade, score, criteria, review), to show it."
+    },
+    {
+      "permission": "capability:playervox.rating.write",
+      "text": "Publishes or updates your rating and optional review on PlayerVox when you confirm it in Interactive mode."
+    }
+  ]
+}

package/dist/content/examples/playervox-reviews/submission.json

@@ -0,0 +1,8 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:playervox.reviews.read",
+      "text": "Reads PlayerVox players' reviews of the game you play, three per page, or only those of the players you follow."
+    }
+  ]
+}

package/dist/content/examples/playervox-score/submission.json

@@ -0,0 +1,8 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:playervox.score.read",
+      "text": "Reads the PlayerVox community grade, score, rating count and criteria of the Steam game you play."
+    }
+  ]
+}

package/dist/content/examples/session/submission.json

@@ -0,0 +1,8 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:session.read",
+      "text": "Reads when the current game session started, to show how long it has lasted."
+    }
+  ]
+}

package/dist/content/examples/stopwatch/submission.json

@@ -0,0 +1,12 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:stopwatch.read",
+      "text": "Reads the stopwatch's time and state, also driven by the host's shortcuts, to show it to the hundredth of a second."
+    },
+    {
+      "permission": "capability:stopwatch.control",
+      "text": "Starts, pauses and resets the stopwatch when you click its buttons."
+    }
+  ]
+}

package/dist/content/examples/twitch-chat/submission.json

@@ -0,0 +1,12 @@
+{
+  "justifications": [
+    {
+      "permission": "capability:twitch.chat.read",
+      "text": "Reads the messages of the public Twitch chat you choose, with emotes and replies, to show them over the game."
+    },
+    {
+      "permission": "capability:twitch.chat.compose",
+      "text": "Sends the message you type to that Twitch chat, with your Twitch account, when you send it."
+    }
+  ]
+}

package/dist/content/examples/warframe-market/submission.json

@@ -0,0 +1,24 @@
+{
+  "justifications": [
+    {
+      "permission": "network:GET https://api.warframe.market/v2/versions",
+      "text": "Checks the version of Warframe Market's public item catalog, to download the catalog again only when it changed."
+    },
+    {
+      "permission": "network:GET https://api.warframe.market/v2/items",
+      "text": "Downloads Warframe Market's public catalog of PC items, to search items by name."
+    },
+    {
+      "permission": "network:GET https://api.warframe.market/v2/orders/item/{slug}",
+      "text": "Loads the online sellers and buyers of the item you open."
+    },
+    {
+      "permission": "storage",
+      "text": "Keeps the item catalog between games, so that a search does not download it again."
+    },
+    {
+      "permission": "clipboardWrite",
+      "text": "Copies the trade whisper of the order you click, to paste it in the game's chat."
+    }
+  ]
+}

package/dist/content/examples/weather/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "apiVersion": 1,
-  "id": "com.example.weather",
+  "id": "nova.weather",
   "version": "1.0.0",
   "name": { "en": "Weather", "fr": "Météo" },
   "sizing": {

package/dist/content/examples/weather/submission.json

@@ -0,0 +1,17 @@
+{
+  "releaseNotes": {
+    "en": "First version: the forecast of your city, in metric or imperial units.",
+    "fr": "Première version : les prévisions de votre ville, en unités métriques ou impériales."
+  },
+  "justifications": [
+    {
+      "permission": "network:GET https://api.example.com/v1/forecast/{city}",
+      "text": "Reads the forecast of the city the player chose, every 30 minutes at most."
+    },
+    {
+      "permission": "storage",
+      "text": "Keeps the chosen city and units between two games."
+    }
+  ],
+  "reviewMessage": "The forecast API needs no account and receives only the city."
+}

package/dist/content/index.json

@@ -304,6 +304,97 @@
      "en": "Publishing and review",
      "fr": "Publication et revue"
     }
+   },
+   {
+    "slug": "creator-space",
+    "file": "creator-space.md",
+    "group": "publish",
+    "label": {
+     "en": "Getting started",
+     "fr": "Démarrer"
+    },
+    "titles": {
+     "en": "Getting started in the creator space",
+     "fr": "Démarrer dans l’espace créateurs"
+    }
+   },
+   {
+    "slug": "publish-keys",
+    "file": "publish-keys.md",
+    "group": "publish",
+    "label": {
+     "en": "Publish keys and CI",
+     "fr": "Clés de publication et CI"
+    },
+    "titles": {
+     "en": "Publish keys and CI",
+     "fr": "Clés de publication et CI"
+    }
+   },
+   {
+    "slug": "verified-domain",
+    "file": "verified-domain.md",
+    "group": "publish",
+    "label": {
+     "en": "Verified domain",
+     "fr": "Domaine vérifié"
+    },
+    "titles": {
+     "en": "Verified domain",
+     "fr": "Domaine vérifié"
+    }
+   },
+   {
+    "slug": "publish-a-widget",
+    "file": "publish-a-widget.md",
+    "group": "publish",
+    "label": {
+     "en": "Publish a widget",
+     "fr": "Publier un widget"
+    },
+    "titles": {
+     "en": "Publish a widget",
+     "fr": "Publier un widget"
+    }
+   },
+   {
+    "slug": "widget-review",
+    "file": "widget-review.md",
+    "group": "publish",
+    "label": {
+     "en": "Review: types, delays, appeals",
+     "fr": "Revue : types, délais, recours"
+    },
+    "titles": {
+     "en": "Review: types, delays, appeals",
+     "fr": "Revue : types, délais, recours"
+    }
+   },
+   {
+    "slug": "widget-listing",
+    "file": "widget-listing.md",
+    "group": "publish",
+    "label": {
+     "en": "The listing: best practices",
+     "fr": "Fiche : bonnes pratiques"
+    },
+    "titles": {
+     "en": "The listing: best practices",
+     "fr": "Fiche : bonnes pratiques"
+    }
+   },
+   {
+    "slug": "widget-statistics",
+    "file": "widget-statistics.md",
+    "group": "publish",
+    "label": {
+     "en": "Statistics: definitions",
+     "fr": "Statistiques : définitions"
+    },
+    "titles": {
+     "en": "Statistics: definitions",
+     "fr": "Statistiques : définitions"
+    }
    }
   ]
  },
@@ -508,6 +599,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/label.scenario.json",
     "tests/load-logic.mjs",
     "tests/logic.test.mjs",
@@ -614,6 +706,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/covers.scenario.json",
     "tests/gesture.scenario.json",
     "tests/load-logic.mjs",
@@ -832,6 +925,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/checks.scenario.json",
     "tests/create.scenario.json",
     "tests/delete.scenario.json",
@@ -1223,6 +1317,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/fahrenheit.scenario.json",
     "tests/horizontal.scenario.json",
     "tests/load-logic.mjs",
@@ -1433,6 +1528,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/changes.scenario.json",
     "tests/delete.scenario.json",
     "tests/frame.scenario.json",
@@ -1692,6 +1788,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/account.scenario.json",
     "tests/bounds.scenario.json",
     "tests/draft.scenario.json",
@@ -1943,6 +2040,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/account.scenario.json",
     "tests/bounds.scenario.json",
     "tests/changes.scenario.json",
@@ -2266,6 +2364,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/grades.scenario.json",
     "tests/load-logic.mjs",
     "tests/logic.test.mjs",
@@ -2510,6 +2609,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/hidden.scenario.json",
     "tests/load-logic.mjs",
     "tests/logic.test.mjs",
@@ -2593,6 +2693,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/errors.scenario.json",
     "tests/gesture.scenario.json",
     "tests/hidden.scenario.json",
@@ -2713,6 +2814,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/account.scenario.json",
     "tests/burst.scenario.json",
     "tests/channel-refused.scenario.json",
@@ -3396,6 +3498,7 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tests/bounds.scenario.json",
     "tests/cached.scenario.json",
     "tests/detail.scenario.json",
@@ -3572,7 +3675,7 @@
     "view.ocml"
    ],
    "images": [],
-   "id": "com.example.countdown",
+   "id": "nova.countdown",
    "title": "Countdown",
    "source": "docs"
   },
@@ -3588,11 +3691,12 @@
     "manifest.json",
     "package.json",
     "style.ocss",
+    "submission.json",
     "tsconfig.json",
     "view.ocml"
    ],
    "images": [],
-   "id": "com.example.weather",
+   "id": "nova.weather",
    "title": "Weather",
    "source": "docs"
   }