@cccsaurora/howler-ui 2.12.0-dev.38 → 2.12.0-dev.39

package/components/routes/help/markdown/fr/client.md

@@ -0,0 +1,209 @@
+# Documentation du client Howler
+
+Cette documentation explique comment interagir avec l'API howler en utilisant le client howler dans les environnements de développement Java et Python. Nous décrirons le processus de base de la création d'un nouveau hit dans chaque environnement ainsi que la recherche dans howler des hits correspondant à votre requête.
+
+## Mise en route
+
+### Installation
+
+Afin d'utiliser le client howler, vous devez le lister comme une dépendance dans votre projet.
+
+#### **Python**
+
+Il suffit de l'installer à l'aide de pip:
+
+```bash
+pip install howler-client
+```
+
+Vous pouvez également l'ajouter à votre requirements.txt, ou à tout autre système de gestion des dépendances que vous utilisez.
+
+### Authentification
+
+Comme indiqué dans la [Documentation sur l'authentification](/help/auth), les utilisateurs peuvent s'authentifier de différentes manières. Pour interfacer avec le client howler, cependant, le flux suggéré est d'utiliser une clé API. Avant de commencer, générons une clé.
+
+1. Ouvrez l'interface utilisateur Howler avec laquelle vous souhaitez vous interfacer.
+2. Connectez-vous, puis cliquez sur votre profil en haut à droite.
+3. Dans le menu utilisateur, cliquez sur Paramètres.
+4. Sous Sécurité de l'utilisateur, appuyez sur l'icône (+) sur la ligne Clés API.
+5. Nommez votre clé et donnez-lui les autorisations nécessaires.
+6. Appuyez sur Create (Créer) et copiez la chaîne fournie dans un endroit sûr. \*\*Vous ne reverrez plus cette chaîne.
+
+Cette clé API sera fournie à votre code par la suite.
+
+## Client Python
+
+Pour se connecter à howler en utilisant le client python, il y a un processus assez simple à suivre:
+
+```python
+from howler_client import get_client
+
+USERNAME = 'user' # Obtenez-le à partir de la page des paramètres de l'utilisateur de l'interface utilisateur de Howler.
+APIKEY = 'apikey_name:apikey_data'
+
+apikey = (USERNAME, APIKEY)
+
+howler = get_client("$CURRENT_URL", apikey=apikey)
+```
+
+Voilà, c'est fait ! Vous pouvez maintenant utiliser l'objet `howler` pour interagir avec le serveur. A quoi cela ressemble-t-il en réalité?
+
+### Créer des hits en Python
+
+Pour le client python, vous pouvez créer des hits en utilisant les fonctions `howler.hit.create` ou `howler.hit.create_from_map`.
+
+#### `create`
+
+Cette fonction prend un seul argument - soit un hit unique, soit une liste de hits, conforme au [Howler Schema] (/help/hit?tab=schema). Voici un exemple simple :
+
+```python
+# Quelques données bidons au format Howler Schema
+exemple_hit = {
+  "howler" : {
+    "analytic" : "exemple",
+    "score" : 10.0
+  },
+  "event" : {
+    "reason" : "Exemple hit"
+  }
+}
+
+howler.hit.create(example_hit)
+```
+
+Vous pouvez également ingérer des données dans un format plat :
+
+```python
+example_hit = {
+  "howler.analytic": "example",
+  "howler.score": 10.0,
+  "event.reason": "Example hit"
+}
+
+howler.hit.create(example_hit)
+```
+
+#### `create_from_map`
+
+This function takes in three arguments:
+
+- `tool name`: Le nom de l'outil d'analyse qui crée le hit
+- `map`: Une correspondance entre les données brutes que vous avez et le schéma howler
+  - Le format est un dictionnaire où les clés sont le chemin aplati des données brutes, et les valeurs sont une liste de chemins aplatis pour les champs de Howler dans lesquels les données seront copiées.
+- `documents`: Les données brutes que vous voulez ajouter à Howler.
+
+Voici un exemple simple:
+
+```python
+# La correspondance entre nos données et le schéma de Howler
+hwl_map = {
+  "file.sha256": ["file.hash.sha256", "howler.hash"],
+  "file.name": ["file.name"],
+  "src_ip": ["source.ip", "related.ip"],
+  "dest_ip": ["destination.ip", "related.ip"],
+  "time.created": ["event.start"],
+}
+
+# Quelques fausses données dans un format personnalisé que nous voulons ajouter à howler
+example_hit = {
+  "src_ip": "0.0.0.0",
+  "dest_ip": "8.8.8.8",
+  "file": {
+    "name": "hello.exe",
+    "sha256": sha256(str("hello.exe").encode()).hexdigest()
+  },
+  "time": {
+    "created": datetime.now().isoformat()
+  },
+}
+
+# Notez que le troisième argument est de type liste!
+howler.hit.create_from_map("example_ingestor", hwl_map, [example_hit])
+```
+
+### Interroger les hits en Python
+
+L'interrogation des hits avec le client python howler se fait en utilisant la fonction `howler.search.hit`. Elle possède un certain nombre d'arguments obligatoires et optionnels:
+
+- Obligatoire:
+  - `query`: requête lucene (chaîne)
+- Facultatif: `filters`: requête lucene (chaîne):
+  - `filters`: Requêtes lucene additionnelles utilisées pour filtrer les données (liste de chaînes)
+  - `fl`: Liste des champs à retourner (chaîne de champs séparés par des virgules)
+  - `offset`: Offset auquel les éléments de la requête doivent commencer (entier)
+  - `rows`: Nombre d'enregistrements à retourner (entier)
+  - `sort`: Champ utilisé pour le tri avec direction (chaîne: ex. 'id desc')
+  - `timeout`: Nombre maximum de millisecondes d'exécution de la requête (entier)
+  - `use_archive`: Interroge également l'archive
+  - `track_total_hits`: Nombre de hits à suivre (par défaut: 10k)
+
+Voici quelques exemples de requêtes:
+
+```python
+# Rechercher tous les hits créés par assemblyline, afficher les 50 premiers et ne renvoyer que leurs identifiants.
+howler.search.hit("howler.analytic:assemblyline", fl="howler.id", rows=50)
+
+# Recherche de toutes les occurrences résolues créées au cours des cinq derniers jours, avec indication de leur identifiant et de l'analyste qui les a créées. N'en afficher que dix, décalés de 40
+howler.search.hit("howler.status:resolved", filters=['event.created:[now-5d TO now]'] fl="howler.id,howler.analytic", rows=10, offset=40)
+
+# Recherche de tous les résultats, délai d'attente si la requête prend plus de 100 ms
+howler.search.hit("howler.id:*", track_total_hits=100000000, timeout=100, use_archive=True)
+```
+
+### Mise à jour des résultats
+
+Afin de mettre à jour les hits, il existe un certain nombre de fonctions supportées :
+
+- `howler.hit.update(...)`
+- `howler.hit.update_by_query(...)`
+- `howler.hit.overwrite(...)`
+
+#### `update()`
+
+Si vous souhaitez mettre à jour un hit de manière transactionnelle, vous pouvez utiliser le code suivant:
+
+```python
+hit_to_update = client.search.hit("howler.id:*", rows=1, sort="event.created desc")["items"][0]
+
+result = client.hit.update(hit_to_update["howler"]["id"], [(UPDATE_SET, "howler.score", hit_to_update["howler"]["score"] + 100)])
+```
+
+Les opérations suivantes peuvent être exécutées pour mettre à jour un résultat.
+
+**Opérations de liste:**
+
+- `UPDATE_APPEND` : Utilisé pour ajouter une valeur à une liste donnée
+- `UPDATE_APPEND_IF_MISSING` : Utilisé pour ajouter une valeur à une liste donnée si la valeur n'est pas déjà dans la liste.
+- `UPDATE_REMOVE` : Supprime une valeur donnée d'une liste
+
+**Opérations numériques:**
+
+- `UPDATE_DEC` : Diminue une valeur numérique de la quantité spécifiée.
+- `UPDATE_INC` : Incrémente une valeur numérique de la quantité spécifiée.
+- `UPDATE_MAX` : Fixe une valeur numérique au maximum de la valeur existante et de la valeur spécifiée.
+- `UPDATE_MIN` : Fixe une valeur numérique au minimum de la valeur existante et de la valeur spécifiée.
+
+**Opérations polyvalentes:**
+
+- `UPDATE_SET` : Fixe la valeur d'un champ à la valeur donnée.
+- `UPDATE_DELETE` : Supprime la valeur d'un champ donné
+
+#### `update_by_query()`
+
+Cette fonction vous permet de mettre à jour un grand nombre d'occurrences à l'aide d'une requête :
+
+```python
+client.hit.update_by_query(f'howler.analytic : "Exemple d\'analytic"', [(UPDATE_INC, "howler.score", 100)])
+```
+
+Les mêmes opérations que dans `update()` peuvent être utilisées.
+
+### `overwrite()`
+
+Cette fonction vous permet d'écraser directement un hit avec un objet hit partiel. C'est la plus facile à utiliser, mais elle perd une partie de la validation et du traitement supplémentaire des fonctions de mise à jour.
+
+```python
+hit_to_update = client.search.hit("howler.id:*", rows=1, sort="event.created desc")["items"][0]
+
+result = client.hit.overwrite(hit_to_update["howler"]["id"], {"source.ip" : "127.0.0.1", “destination.ip” : "8.8.8.8"})
+```

package/components/routes/help/markdown/fr/links.md

@@ -0,0 +1,37 @@
+# Liens du hit
+
+Afin de faciliter l'ajout d'outils supplémentaires que l'on peut utiliser pour suivre un hit, Howler permet aux utilisateurs de spécifier un ensemble de liens, ainsi qu'un titre et une icône à afficher. Cette documentation vous expliquera comment utiliser ces liens.
+
+## Specification
+
+Afin d'ajouter des liens, vous pouvez utiliser le champ `howler.links`. Ce champ contient une liste d'objets avec trois clés :
+
+```python
+hit = {
+  "howler.links": [
+    {
+      "title": "Titre du lien avec image interne",
+      "href": "https://example.com",
+      # Notez qu'il s'agit d'une autre application, et non d'un lien vers une image.
+      "icon": "superset",
+    },
+    {
+      "title": "Titre du lien avec image externe",
+      "href": "https://www.britannica.com/animal/goose-bird",
+      # Notez qu'il s'agit d'un lien vers une image. Nous ne fournissons pas d'hébergement, vous devrez donc l'héberger ailleurs !
+      "icon": "https://cdn.britannica.com/76/76076-050-39DDCBA1/goose-Canada-North-America.jpg",
+    },
+  ]
+}
+```
+
+Notez que l'icône peut être soit :
+
+1. Un nom identifiant une application liée (à partir du sélecteur d'applications), afin d'utiliser son icône.
+2. Une URL externe
+
+Si vous souhaitez utiliser une application liée, les valeurs suivantes sont actuellement prises en charge :
+
+$APP_LIST
+
+L'utilisation de l'une de ces valeurs entraîne automatiquement l'utilisation de l'icône correspondante. Inutile d'héberger la vôtre !

package/components/routes/help/markdown/fr/notebook.md

@@ -0,0 +1,157 @@
+# Intégration de carnets
+
+Howler offre la possibilité d'ajouter des carnets aux analyses afin de faciliter le triage des hits et des alertes. Il permet aux utilisateurs de créer rapidement un carnet dans un environnement Jupyter avec des informations analytiques et/ou des informations sur les hits.
+
+Howler cherchera des variables à remplacer dans la première cellule de code d'un notebook, ce qui permettra de fournir un contexte dans les premières cellules à l'aide de markdown.
+
+Voici un exemple de la façon dont Howler remplacera les variables dans votre carnet :
+
+```notebook tab="Modèle"
+{
+  "cells": [
+    {
+      "cell_type": "code",
+      "id": "fe6f810f-2459-4ad7-92ac-1e925ce892d4",
+      "outputs": [],
+      "source": [
+        "HowlerHitId = \"{{hit.howler.id}}\"\n",
+        "HowlerAnalyticId = \"{{analytic.analytic_id}}\""
+      ]
+    },
+    {
+      "cell_type": "code",
+      "id": "586470ef-c8e6-45b1-bd17-17ccd083eef1",
+      "outputs": [],
+      "source": [
+        "from howler_client import get_client\n\n",
+        "howler = get_client(\"$CURRENT_URL\")\n",
+        "hit = howler.hit(howlerHitId)"
+      ]
+    }
+  ],
+  "nbformat": 4,
+  "nbformat_minor": 5
+}
+```
+
+```notebook tab="Traité"
+{
+  "cells": [
+    {
+      "cell_type": "code",
+      "id": "fe6f810f-2459-4ad7-92ac-1e925ce892d4",
+      "outputs": [],
+      "source": [
+        "HowlerHitId = \"7dxHCat0Y2Sj48qyU7ZkVV\"\n",
+        "HowlerAnalyticId = \"2SXKl6Cq4rOxWLps2SFHyB\""
+      ]
+    },
+    {
+      "cell_type": "code",
+      "id": "586470ef-c8e6-45b1-bd17-17ccd083eef1",
+      "outputs": [],
+      "source": [
+        "from howler_client import get_client\n\n",
+        "howler = get_client(\"$CURRENT_URL\")\n",
+        "hit = howler.hit(howlerHitId)"
+      ]
+    }
+  ],
+  "nbformat": 4,
+  "nbformat_minor": 5
+}
+```
+
+ou avec du markdown dans la première cellule :
+
+```notebook tab="Modèle"
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "e17cbaa8-9849-462f-9bd2-bf30943f76b3",
+      "source": [
+        "### Exemple de carnet"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "id": "fe6f810f-2459-4ad7-92ac-1e925ce892d4",
+      "outputs": [],
+      "source": [
+        "HowlerHitId = \"{{hit.howler.id}}\"\n",
+        "HowlerAnalyticId = \"{{analytic.analytic_id}}\""
+      ]
+    },
+    {
+      "cell_type": "code",
+      "id": "586470ef-c8e6-45b1-bd17-17ccd083eef1",
+      "outputs": [],
+      "source": [
+        "from howler_client import get_client\n\n",
+        "howler = get_client(\"$CURRENT_URL\")\n",
+        "hit = howler.hit(howlerHitId)"
+      ]
+    }
+  ],
+  "nbformat": 4,
+  "nbformat_minor": 5
+}
+```
+
+```notebook tab="Traité"
+{
+  "cells": [
+    {
+      "cell_type": "markdown",
+      "id": "e17cbaa8-9849-462f-9bd2-bf30943f76b3",
+      "source": [
+        "### Exemple de carnet"
+      ]
+    },
+    {
+      "cell_type": "code",
+      "id": "fe6f810f-2459-4ad7-92ac-1e925ce892d4",
+      "outputs": [],
+      "source": [
+        "HowlerHitId = \"7dxHCat0Y2Sj48qyU7ZkVV\"\n",
+        "HowlerAnalyticId = \"2SXKl6Cq4rOxWLps2SFHyB\""
+      ]
+    },
+    {
+      "cell_type": "code",
+      "id": "586470ef-c8e6-45b1-bd17-17ccd083eef1",
+      "outputs": [],
+      "source": [
+        "from howler_client import get_client\n\n",
+        "howler = get_client(\"$CURRENT_URL\")\n",
+        "hit = howler.hit(howlerHitId)"
+      ]
+    }
+  ],
+  "nbformat": 4,
+  "nbformat_minor": 5
+}
+```
+
+Présentement, Howler n'essaiera de remplacer que les objets de hit et d'analytic.
+
+# Conditions requises pour que l'intégration de carnets fonctionne
+
+- Une configuration NBGallery fonctionnelle est nécessaire.
+  - Si l'utilisateur peut envoyer un carnet depuis NBGallery vers son environnement Jupyter, il fonctionnera aussi en utilisant le bouton open in jupyhub sur Howler.
+- Comme pour NBGallery, l'utilisateur doit s'assurer que son environnement Jupyter est en cours d'exécution, sinon Howler ne parviendra pas à envoyer le carnet.
+
+Howler ajoutera l'identifiant du Hit/Alert lorsqu'il enverra un carnet à Jupyter, ce qui facilitera son suivi pour l'analyse. Il est possible d'ouvrir un carnet à partir d'une page analytique. Dans ce cas, aucun identifiant de résultat ne sera ajouté au nom de fichier du carnet et Howler ne sera pas en mesure de remplacer les informations de hit dans le carnet modèle puisqu'aucun hit n'a été fourni.
+
+# Ajout d'un carnet à une analyse
+
+Pour ajouter un carnet à une analyse, il suffit de fournir le lien NBGallery du carnet. Le lien ressemblera à l'exemple ci-dessous. Le carnet ne doit pas être privé, sinon seul l'utilisateur qui l'a ajouté pourra l'utiliser sur Howler.
+
+```
+$NBGALLERY_URL/notebooks/5-example
+```
+
+```alert
+Il est conseillé d'effacer toutes les sorties d'un carnet avant de l'ajouter sur NBGallery afin d'éviter la fuite de données sensibles.
+```

package/components/routes/help/markdown/fr/retention.md

@@ -0,0 +1,15 @@
+# Rétention dans Howler
+
+Afin de se conformer au règlement, Howler est configuré pour purger les alertes périmées après une période de temps spécifique. Dans cette instance, cette durée est `duration`.
+
+Howler calcule s'il est temps de supprimer une alerte en fonction de la date `event.created` - une fois que celle-ci dépasse la date limite configurée, un travail automatisé nocturne supprimera l'alerte.
+
+Afin de communiquer cela à l'utilisateur, voir l'exemple d'alerte ci-dessous :
+
+`alert`
+
+En haut à droite, le survol de l'horodatage indique le temps dont dispose l'utilisateur avant que l'alerte ne soit supprimée. Afin de se conformer au règlement, assurez-vous que `event.created` correspond à la date à laquelle les données sous-jacentes ont été collectées, ce qui permet à howler de s'assurer que les données sont purgées à temps.
+
+```alert
+Cela va bientôt changer - il y aura un champ dédié à définir qui remplacera cette approche.
+```

package/components/routes/help/markdown/fr/schema.md

@@ -0,0 +1,21 @@
+# Schéma du hit
+
+Un hit howler peut contenir un grand nombre de champs uniques, chacun avec une définition particulière, afin de rendre les hits mutuellement intelligibles d'une analyse à l'autre. Vous trouverez ci-dessous un tableau contenant tous les champs de résultats donnés, ainsi que leur type et une brève description de leur utilisation. Alors que la grande majorité des champs sont basés sur le schéma commun Elastic (voir [ici](https://www.elastic.co/guide/en/ecs/8.5/index.html) pour la documentation), il existe également des champs personnalisés pour Howler, et aussi des champs supplémentaires configurés par divers plugins Howler.
+
+## Champs Howler - Bonnes pratiques
+
+Afin d'assurer une certaine cohérence entre les différents analytiques, il existe un certain nombre de champs dont le style est recommandé (mais pas obligatoire). Il s'agit notamment des champs suivants:
+
+- `howler.analytic` : Indique l'analyse globale qui a généré le résultat. Par exemple, si le nom de votre analyse est Bad Guy Finder, vous pouvez définir ce champ à Bad Guy Finder. Exemples d'utilisation :
+
+  - Bad Guy Finder (correct)
+  - BadGuyFinder (acceptable, mais les espaces sont préférables)
+  - bad.guy.finder (incorrect, ne pas utiliser de points)
+  - bad_guy_finder (incorrect, n'utilisez pas de caractères de soulignement)
+  - en général, vous pouvez utiliser [cette regex](https://regexr.com/7ikco) pour valider le nom analytique que vous proposez
+
+- `howler.detection` : Indique l'algorithme spécifique ou la partie de l'analyse qui a généré le hit. Par exemple, si votre analyse a trois façons de détecter les hits qui devraient être examinés (Voyage impossible, Informations de connexion incorrectes, Détection d'attaque XSS), alors la façon dont le hit que vous créez a été détecté devrait être définie. Exemples d'utilisation :
+  - Impossible Travel (correct)
+  - ImpossibleTravel (acceptable, mais les espaces sont préférables)
+  - impossible.travel (incorrect, ne pas utiliser de points)
+  - impossible_travel (incorrect, ne pas utiliser de caractères de soulignement)

package/components/routes/help/markdown/fr/templates.md

@@ -0,0 +1,23 @@
+# Modèles de Howler
+
+Howler est, fondamentalement, une application qui permet aux analystes de trier les hits et les alertes. Afin de s'assurer que les analystes puissent le faire aussi efficacement que possible, nous voulons avoir la possibilité de présenter les données pertinentes pour une alerte donnée aux analystes d'une manière facile et compréhensible.
+
+À cette fin, Howler permet aux analystes et aux ingénieurs de détection de créer des **modèles**, qui permettent à diverses analyses et à leurs détections de présenter des champs et des données pertinents pour le triage des alertes générées par cette analyse/détection. Par exemple, considérons deux alertes différentes, générées par deux détections différentes :
+
+```json
+$ALERT_1
+```
+
+```json
+$ALERT_2
+```
+
+Notez que si les deux cartes partagent des champs similaires, elles diffèrent également. Nous voulons que chacune de ces cartes d'alerte présente des données différentes - pour cela, nous pouvons utiliser des modèles. Cela nous permet d'afficher les deux occurrences dans la même liste, mais avec des champs différents :
+
+===SPLIT===
+
+Comme nous pouvons le voir, en spécifiant un modèle pour chacune des détections, des données différentes seront présentées à l'analyste.Pour ce faire, vous pouvez utiliser le créateur de modèles [ici]($CURRENT_URL/templates/view?type=personal).
+
+```alert
+Notez que vous devez avoir ingéré des hits pour la paire analyse/détection donnée pour qu'elle apparaisse en tant qu'option dans l'interface utilisateur de création de modèle !
+```

package/components/routes/help/markdown/fr/views.md

@@ -0,0 +1,11 @@
+# Vues
+
+Les vues sont une fonctionnalité de Howler qui permet aux utilisateurs de créer des requêtes personnalisées par défaut à travers lesquelles ils peuvent organiser et trier les hits. Dans ce document, nous décrirons comment créer et interagir avec des vues.
+
+## Utilisation d'une vue
+
+Vous pouvez utiliser les vues en accédant au gestionnaire de vues sous [Manage > Views](/views). En cliquant sur une vue, vous l'ouvrirez dans la page de recherche. Vous pouvez également utiliser l'icône `recherche` pour ouvrir la vue dans la page de recherche. Vous pouvez également modifier les vues qui vous appartiennent et les marquer comme favorites. Cela les affichera dans le menu déroulant `t(route.views.saved)` dans la barre latérale. En haut à droite, vous pouvez également choisir votre `t(route.views.manager.default)`, qui sera sélectionné par défaut lors de l'ouverture de la page d'alertes.
+
+## Créer des vues
+
+Pour créer une vue, vous pouvez utiliser la page de création de vue, située [ici](/views/create). Cette page vous permet de modifier votre vue, de spécifier un `t(hit.search.sort.fields)` et un `t(hit.search.span)`, et de sauvegarder la vue avec un nom particulier. Vous pouvez marquer une vue comme globale ou personnelle, en fonction des personnes que vous souhaitez voir et utiliser.

package/package.json

@@ -96,13 +96,13 @@
     "internal-slot": "1.0.7"
   },
   "type": "module",
-  "version": "2.12.0-dev.38",
+  "version": "2.12.0-dev.39",
   "exports": {
     "./i18n": "./i18n.js",
     "./index.css": "./index.css",
     "./plugins/*": "./plugins/*.js",
     "./components/*": "./components/*.js",
-    "./locales/*": "./locales/*.js",
+    "./locales/*": "./locales/*.json",
     "./api/*": "./api/*.js",
     "./api": "./api/index.js",
     "./rest/*": "./rest/*.js",
@@ -110,7 +110,10 @@
     "./models/*": "./models/*.js",
     "./commons/*": "./commons/*.js",
     "./branding/*": "./branding/*.js",
-    "./utils/*": "./utils/*.js",
+    "./utils/*": [
+      "./utils/*.js",
+      "./utils/*.json"
+    ],
     "./components/logins/*": "./components/logins/*.js",
     "./components/app/*": "./components/app/*.js",
     "./components/routes/*": "./components/routes/*.js",
@@ -135,9 +138,9 @@
     "./components/routes/admin/*": "./components/routes/admin/*.js",
     "./components/routes/dossiers/*": "./components/routes/dossiers/*.js",
     "./components/routes/help/components/*": "./components/routes/help/components/*.js",
-    "./components/routes/help/markdown/*": "./components/routes/help/markdown/*.js",
-    "./components/routes/help/markdown/en/*": "./components/routes/help/markdown/en/*.js",
-    "./components/routes/help/markdown/fr/*": "./components/routes/help/markdown/fr/*.js",
+    "./components/routes/help/markdown/*": "./components/routes/help/markdown/*.md",
+    "./components/routes/help/markdown/en/*": "./components/routes/help/markdown/en/*.md",
+    "./components/routes/help/markdown/fr/*": "./components/routes/help/markdown/fr/*.md",
     "./components/routes/action/view/*": "./components/routes/action/view/*.js",
     "./components/routes/action/shared/*": "./components/routes/action/shared/*.js",
     "./components/routes/action/edit/*": "./components/routes/action/edit/*.js",
@@ -154,7 +157,7 @@
     "./components/elements/display/modals/*": "./components/elements/display/modals/*.js",
     "./components/elements/display/features/*": "./components/elements/display/features/*.js",
     "./components/elements/display/handlebars/*": "./components/elements/display/handlebars/*.js",
-    "./components/elements/display/markdownPlugins/*": "./components/elements/display/markdownPlugins/*.js",
+    "./components/elements/display/markdownPlugins/*": "./components/elements/display/markdownPlugins/*.md",
     "./components/elements/display/icons/*": "./components/elements/display/icons/*.js",
     "./components/elements/display/json/*": "./components/elements/display/json/*.js",
     "./components/elements/display/icons/svg/*": "./components/elements/display/icons/svg/*.js",
@@ -178,10 +181,10 @@
     "./components/elements/hit/outlines/*": "./components/elements/hit/outlines/*.js",
     "./components/elements/hit/actions/*": "./components/elements/hit/actions/*.js",
     "./components/elements/hit/outlines/al/*": "./components/elements/hit/outlines/al/*.js",
-    "./locales/en/*": "./locales/en/*.js",
-    "./locales/fr/*": "./locales/fr/*.js",
-    "./locales/en/help/*": "./locales/en/help/*.js",
-    "./locales/fr/help/*": "./locales/fr/help/*.js",
+    "./locales/en/*": "./locales/en/*.json",
+    "./locales/fr/*": "./locales/fr/*.json",
+    "./locales/en/help/*": "./locales/en/help/*.json",
+    "./locales/fr/help/*": "./locales/fr/help/*.json",
     "./api/analytic/*": "./api/analytic/*.js",
     "./api/analytic": "./api/analytic/index.js",
     "./api/auth/*": "./api/auth/*.js",