@cccsaurora/howler-ui 2.14.0-dev.193 → 2.14.0-dev.199

package/components/elements/display/handlebars/helpers.d.ts

@@ -2,7 +2,10 @@ import Handlebars from 'handlebars';
 import { type ReactElement } from 'react';
 export interface HowlerHelper {
     keyword: string;
-    documentation?: string;
+    documentation?: {
+        en: string;
+        fr: string;
+    };
     callback?: Handlebars.HelperDelegate;
     componentCallback?: (...args: any[]) => ReactElement | Promise<ReactElement>;
 }

package/components/elements/display/handlebars/helpers.js

@@ -18,43 +18,74 @@ export const useHelpers = () => {
     const allHelpers = useMemo(() => [
         {
             keyword: 'equals',
-            documentation: 'Checks the equality of the string representation of the two arguments.',
+            documentation: {
+                en: 'Checks the equality of the string representation of the two arguments.',
+                fr: "Vérifie l'égalité de la représentation en chaîne de caractères des deux arguments."
+            },
             callback: (arg1, arg2) => arg1?.toString() === arg2.toString()
         },
         {
             keyword: 'and',
-            documentation: 'Runs the comparison `arg1 && arg2`, and returns the result.',
+            documentation: {
+                en: 'Runs the comparison `arg1 && arg2`, and returns the result.',
+                fr: 'Exécute la comparaison `arg1 && arg2`, et retourne le résultat.'
+            },
             callback: (arg1, arg2) => arg1 && arg2
         },
         {
             keyword: 'or',
-            documentation: 'Runs the comparison `arg1 || arg2`, and returns the result.',
+            documentation: {
+                en: 'Runs the comparison `arg1 || arg2`, and returns the result.',
+                fr: 'Exécute la comparaison `arg1 || arg2`, et retourne le résultat.'
+            },
             callback: (arg1, arg2) => arg1 || arg2
         },
-        { keyword: 'not', documentation: 'Runs the comparison `!arg`, and returns the result.', callback: arg => !arg },
+        {
+            keyword: 'not',
+            documentation: {
+                en: 'Runs the comparison `!arg`, and returns the result.',
+                fr: 'Exécute la comparaison `!arg`, et retourne le résultat.'
+            },
+            callback: arg => !arg
+        },
         {
             keyword: 'curly',
-            documentation: 'Wraps the given argument in curly braces.',
+            documentation: {
+                en: 'Wraps the given argument in curly braces.',
+                fr: "Entoure l'argument donné d'accolades."
+            },
             callback: arg1 => new Handlebars.SafeString(`{{${arg1}}}`)
         },
         {
             keyword: 'join',
-            documentation: 'Joins two string arguments with a given string `sep`, or the empty string as a default.',
+            documentation: {
+                en: 'Joins two string arguments with a given string `sep`, or the empty string as a default.',
+                fr: 'Joint deux arguments de chaîne avec une chaîne donnée `sep`, ou la chaîne vide par défaut.'
+            },
             callback: (arg1, arg2, context) => [arg1?.toString() ?? '', arg2?.toString() ?? ''].join(context.hash?.sep ?? '')
         },
         {
             keyword: 'upper',
-            documentation: 'Returns the uppercase representation of a string argment.',
+            documentation: {
+                en: 'Returns the uppercase representation of a string argument.',
+                fr: "Retourne la représentation en majuscules d'un argument de chaîne."
+            },
             callback: (val) => val.toLocaleUpperCase()
         },
         {
             keyword: 'lower',
-            documentation: 'Returns the lowercase representation of a string argment.',
+            documentation: {
+                en: 'Returns the lowercase representation of a string argument.',
+                fr: "Retourne la représentation en minuscules d'un argument de chaîne."
+            },
             callback: (val) => val.toLocaleLowerCase()
         },
         {
             keyword: 'fetch',
-            documentation: 'Fetches the url provided and returns the given (flattened) key from the returned JSON object. Note that the result must be JSON!',
+            documentation: {
+                en: 'Fetches the url provided and returns the given (flattened) key from the returned JSON object. Note that the result must be JSON!',
+                fr: "Récupère l'URL fournie et retourne la clé donnée (aplatie) de l'objet JSON retourné. Notez que le résultat doit être du JSON !"
+            },
             callback: async (url, key) => {
                 try {
                     if (!FETCH_RESULTS[url]) {
@@ -70,7 +101,10 @@ export const useHelpers = () => {
         },
         {
             keyword: 'howler',
-            documentation: 'Given a howler hit ID, this helper renders a hit card for that ID.',
+            documentation: {
+                en: 'Given a howler hit ID, this helper renders a hit card for that ID.',
+                fr: 'Étant donné un ID de résultat howler, cet assistant affiche une carte de résultat pour cet ID.'
+            },
             componentCallback: id => {
                 if (!id) {
                     return _jsx(AppListEmpty, {});
@@ -80,7 +114,10 @@ export const useHelpers = () => {
         },
         {
             keyword: 'entries',
-            documentation: 'Given a dict, return an array of {key, value} objects.',
+            documentation: {
+                en: 'Given a dict, return an array of {key, value} objects.',
+                fr: "Étant donné un dictionnaire, retourne un tableau d'objets {key, value}."
+            },
             callback: obj => {
                 if (!isObject(obj)) {
                     return new Handlebars.SafeString('Invalid Object.');
@@ -90,7 +127,10 @@ export const useHelpers = () => {
         },
         {
             keyword: 'render_json',
-            documentation: 'Given a howler hit ID, this helper renders a hit card for that ID.',
+            documentation: {
+                en: 'Given JSON data, this helper renders a JSON viewer component.',
+                fr: 'Étant donné des données JSON, cet assistant affiche un composant de visualisation JSON.'
+            },
             componentCallback: data => {
                 if (!data) {
                     return _jsx(AppListEmpty, {});
@@ -100,21 +140,30 @@ export const useHelpers = () => {
         },
         {
             keyword: 'to_json',
-            documentation: 'Convert any object into a JSON string.',
+            documentation: {
+                en: 'Convert any object into a JSON string.',
+                fr: "Convertit n'importe quel objet en chaîne JSON."
+            },
             callback: obj => {
                 return new Handlebars.SafeString(JSON.stringify(obj));
             }
         },
         {
             keyword: 'parse_json',
-            documentation: 'Convert JSON string into and object.',
+            documentation: {
+                en: 'Convert a JSON string into an object.',
+                fr: 'Convertit une chaîne JSON en objet.'
+            },
             callback: str => {
                 return JSON.parse(str);
             }
         },
         {
             keyword: 'get',
-            documentation: 'Returns the given (flattened) key from the provided object.',
+            documentation: {
+                en: 'Returns the given (flattened) key from the provided object.',
+                fr: "Retourne la clé donnée (aplatie) de l'objet fourni."
+            },
             callback: async (data, key) => {
                 try {
                     return get(data, key);
@@ -126,14 +175,20 @@ export const useHelpers = () => {
         },
         {
             keyword: 'includes',
-            documentation: 'Checks if field is in string',
+            documentation: {
+                en: 'Checks if field is in string',
+                fr: 'Vérifie si le champ est dans la chaîne'
+            },
             callback: (arg1, arg2) => {
                 return !!arg2 && !!arg1?.includes(arg2);
             }
         },
         {
             keyword: 'table',
-            documentation: 'Render a table in markdown given an array of cells',
+            documentation: {
+                en: 'Render a table in markdown given an array of cells',
+                fr: "Affiche un tableau en markdown à partir d'un tableau de cellules"
+            },
             componentCallback: (cells) => {
                 const columns = Object.keys(groupBy(cells, 'column'));
                 const rows = groupBy(cells, 'row');
@@ -150,7 +205,10 @@ export const useHelpers = () => {
         },
         {
             keyword: 'action',
-            documentation: 'Execute a howler action given a specific action ID (from the URL when viewing the action, i.e. yaIKVqiKhWpyCsWdqsE4D)',
+            documentation: {
+                en: 'Execute a howler action given a specific action ID (from the URL when viewing the action, i.e. yaIKVqiKhWpyCsWdqsE4D)',
+                fr: "Exécute une action howler à partir d'un ID d'action spécifique (de l'URL lors de la visualisation de l'action, par ex. yaIKVqiKhWpyCsWdqsE4D)"
+            },
             componentCallback: (actionId, hitId, context) => {
                 if (!actionId || !hitId) {
                     console.warn('Missing parameters for the action button.');

package/components/routes/overviews/startingTemplate.js

@@ -1,183 +1,27 @@
 import { useHelpers } from '@cccsaurora/howler-ui/components/elements/display/handlebars/helpers';
 import { useMemo } from 'react';
+import { useTranslation } from 'react-i18next';
+import TEMPLATE_EN from './template/en.md';
+import TEMPLATE_FR from './template/fr.md';
+const TEMPLATES = {
+    en: TEMPLATE_EN,
+    fr: TEMPLATE_FR
+};
 export const useStartingTemplate = () => {
     const helpers = useHelpers();
+    const { i18n } = useTranslation();
     const helperText = useMemo(() => helpers
         .map(helper => `
 ### \`${helper.keyword}\`
 
-${helper.documentation}
+${helper.documentation[i18n.language]}
 
 ---
 `.trim())
-        .join('\n'), [helpers]);
+        .join('\n'), [helpers, i18n.language]);
     return useMemo(() => `
-# Creating an Overview
-
-Overviews can be used to modify the way data is presented on alerts that match the overview's settings. Overviews are, by design, easy to create and quite flexible.
-
-## Getting Started
-
-The basic building blocks of overviews are:
-
-1. Markdown
-2. Handlebars
-
-We will quickly explain these.
-
-### Markdown
-
-Quoting from the excellent [markdownguide.org](https://www.markdownguide.org/getting-started/):
-
-> Markdown is a lightweight markup language that you can use to add formatting elements to plaintext text documents. Created by [John Gruber](https://daringfireball.net/projects/markdown/) in 2004, Markdown is now one of the world's most popular markup languages.
->
-> Using Markdown is different than using a [WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG) editor. In an application like Microsoft Word, you click buttons to format words and phrases, and the changes are visible immediately. Markdown isn't like that. When you create a Markdown-formatted file, you add Markdown syntax to the text to indicate which words and phrases should look different.
->
-> For example, to denote a heading, you add a number sign before it (e.g., \`# Heading One\`). Or to make a phrase bold, you add two asterisks before and after it (e.g., \`**this text is bold**\`). It may take a while to get used to seeing Markdown syntax in your text, especially if you're accustomed to WYSIWYG applications.
-
----
-
-### Handlebars
-
-Quoting from [handlebarsjs.com](https://handlebarsjs.com/guide/):
-
-> Handlebars is a simple templating language.
->
-> It uses a template and an input object to generate HTML or other text formats. Handlebars templates look like regular text with embedded Handlebars expressions.
->
->\`\`\`html
-> <p>{{curly "firstname"}} {{curly "lastname"}}</p>
->\`\`\`
->
-> A handlebars expression is a double curly bracket, some contents, followed by a set of closing double curly brackets. When the template is executed, these expressions are replaced with values from an input object.
-
----
-
-For our cases, we use handlebars to replace specific parts of markdown with the values included in a given howler hit. For example:
-
-\`\`\`markdown
-This analytic is **{{curly "howler.analytic"}}**
-\`\`\`
-
-becomes:
-
-> This analytic is **{{howler.analytic}}**.
-
-For more information on handlebars, check out:
-
-- [What is Handlebars?](https://handlebarsjs.com/guide/#what-is-handlebars)
-- [Handlebars Expressions](https://handlebarsjs.com/guide/expressions.html)
-
-## Combining Markdown the Handlebars
-
-You can use handlebars for template replacement throughout your markdown. Below is an example table using handlebars and markdown:
-
-\`\`\`markdown
-| Source IP | Destination IP |
-| --- | --- |
-| {{curly "source.ip"}} |{{curly "destination.ip"}} |
-\`\`\`
-
-renders as:
-
-| Source IP | Destination IP |
-| --- | --- |
-| {{source.ip}} |{{destination.ip}} |
-
-## Advanced Handlebars
-
-Howler integrates a number of helper functions for you to work with.
-
-### Control Expressions
-
-For use as subexpressions, we expose a number of conditional checks:
-
-**Equality:**
-
-Given \`howler.status\` is {{howler.status}}:
-
-\`\`\`markdown
-{{curly '#if (equals howler.status "open")'}}
-Hit is open!
-{{curly "/if"}}
-{{curly '#if (equals howler.status "resolved")'}}
-Hit is resolved!
-{{curly "/if"}}
-\`\`\`
-
-{{#if (equals howler.status "open")}}
-Hit is open!
-{{/if}}
-{{#if (equals howler.status "resolved")}}
-Hit is resolved!
-{{/if}}
-
-**AND/OR/NOT:**
-
-Given \`howler.status\` is {{howler.status}}, and \`howler.escalation\` is {{howler.escalation}}:
-
-\`\`\`markdown
-{{curly '#if (and (equals howler.status "open") (equals howler.escalation "alert"))'}}
-This is correct!
-{{curly "/if"}}
-{{curly '#if (and (equals howler.status "resolved") (equals howler.escalation "hit"))'}}
-This is wrong!
-{{curly "/if"}}
-\`\`\`
-
-{{#if (and (equals howler.status "open") (equals howler.escalation "alert"))}}
-This is correct!
-{{/if}}
-{{#if (and (equals howler.status "resolved") (equals howler.escalation "hit"))}}
-This is wrong!
-{{/if}}
-
-\`\`\`markdown
-{{curly '#if (or howler.is_bundle (not howler.is_bundle))'}}
-Always shows!
-{{curly "/if"}}
-\`\`\`
-
-{{#if (or howler.is_bundle (not howler.is_bundle))}}
-Always shows!
-{{/if}}
-
----
-
-### String Operations
-
-**String Concatenation:**
-\`\`\`markdown
-{{curly 'join "string one " "string two"'}}
-\`\`\`
-
-{{join "string one " "string two"}}
-
-**Uppercase/Lowercase:**
-
-\`\`\`markdown
-{{curly 'upper "make this uppercase"'}}
-{{curly 'lower "MAKE THIS LOWERCASE"'}}
-\`\`\`
-
-{{upper "make this uppercase"}}
-
-{{lower "MAKE THIS LOWERCASE"}}
-
----
-
-### Fetching Data
-
-You can also make basic fetch requests for, and parse, JSON data from external sources:
-
-\`\`\`markdown
-{{curly 'fetch "/api/v1/configs" "api_response.c12nDef.UNRESTRICTED"'}}
-\`\`\`
-
-{{fetch "/api/v1/configs" "api_response.c12nDef.UNRESTRICTED"}}
-
-## Full Helper List
+${TEMPLATES[i18n.language] ?? TEMPLATES.en}
 
 ${helperText}
-`, [helperText]);
+`, [helperText, i18n.language]);
 };

package/components/routes/overviews/template/en.md.js

@@ -0,0 +1 @@
+export default "# Creating an Overview\n\nOverviews can be used to modify the way data is presented on alerts that match the overview's settings. Overviews are, by design, easy to create and quite flexible.\n\n## Getting Started\n\nThe basic building blocks of overviews are:\n\n1. Markdown\n2. Handlebars\n\nWe will quickly explain these.\n\n### Markdown\n\nQuoting from the excellent [markdownguide.org](https://www.markdownguide.org/getting-started/):\n\n> Markdown is a lightweight markup language that you can use to add formatting elements to plaintext text documents. Created by [John Gruber](https://daringfireball.net/projects/markdown/) in 2004, Markdown is now one of the world's most popular markup languages.\n>\n> Using Markdown is different than using a [WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG) editor. In an application like Microsoft Word, you click buttons to format words and phrases, and the changes are visible immediately. Markdown isn't like that. When you create a Markdown-formatted file, you add Markdown syntax to the text to indicate which words and phrases should look different.\n>\n> For example, to denote a heading, you add a number sign before it (e.g., `# Heading One`). Or to make a phrase bold, you add two asterisks before and after it (e.g., `**this text is bold**`). It may take a while to get used to seeing Markdown syntax in your text, especially if you're accustomed to WYSIWYG applications.\n\n---\n\n### Handlebars\n\nQuoting from [handlebarsjs.com](https://handlebarsjs.com/guide/):\n\n> Handlebars is a simple templating language.\n>\n> It uses a template and an input object to generate HTML or other text formats. Handlebars templates look like regular text with embedded Handlebars expressions.\n>\n>```html\n> <p>{{curly \"firstname\"}} {{curly \"lastname\"}}</p>\n>```\n>\n> A handlebars expression is a double curly bracket, some contents, followed by a set of closing double curly brackets. When the template is executed, these expressions are replaced with values from an input object.\n\n---\n\nFor our cases, we use handlebars to replace specific parts of markdown with the values included in a given howler hit. For example:\n\n```markdown\nThis analytic is **{{curly \"howler.analytic\"}}**\n```\n\nbecomes:\n\n> This analytic is **{{howler.analytic}}**.\n\nFor more information on handlebars, check out:\n\n- [What is Handlebars?](https://handlebarsjs.com/guide/#what-is-handlebars)\n- [Handlebars Expressions](https://handlebarsjs.com/guide/expressions.html)\n\n## Combining Markdown and Handlebars\n\nYou can use handlebars for template replacement throughout your markdown. Below is an example table using handlebars and markdown:\n\n```markdown\n\n| Source IP | Destination IP |\n| --- | --- |\n| {{curly \"source.ip\"}} |{{curly \"destination.ip\"}} |\n```\n\nrenders as:\n\n| Source IP | Destination IP |\n| --- | --- |\n| {{source.ip}} |{{destination.ip}} |\n\n## Advanced Handlebars\n\nHowler integrates a number of helper functions for you to work with.\n\n### Control Expressions\n\nFor use as subexpressions, we expose a number of conditional checks:\n\n**Equality:**\n\nGiven `howler.status` is {{howler.status}}:\n\n```markdown\n{{curly '#if (equals howler.status \"open\")'}}\nHit is open!\n{{curly \"/if\"}}\n{{curly '#if (equals howler.status \"resolved\")'}}\nHit is resolved!\n{{curly \"/if\"}}\n```\n\n{{#if (equals howler.status \"open\")}}\nHit is open!\n{{/if}}\n{{#if (equals howler.status \"resolved\")}}\nHit is resolved!\n{{/if}}\n\n**AND/OR/NOT:**\n\nGiven `howler.status` is {{howler.status}}, and `howler.escalation` is {{howler.escalation}}:\n\n```markdown\n{{curly '#if (and (equals howler.status \"open\") (equals howler.escalation \"alert\"))'}}\nThis is correct!\n{{curly \"/if\"}}\n{{curly '#if (and (equals howler.status \"resolved\") (equals howler.escalation \"hit\"))'}}\nThis is wrong!\n{{curly \"/if\"}}\n```\n\n{{#if (and (equals howler.status \"open\") (equals howler.escalation \"alert\"))}}\nThis is correct!\n{{/if}}\n{{#if (and (equals howler.status \"resolved\") (equals howler.escalation \"hit\"))}}\nThis is wrong!\n{{/if}}\n\n```markdown\n{{curly '#if (or howler.is_bundle (not howler.is_bundle))'}}\nAlways shows!\n{{curly \"/if\"}}\n```\n\n{{#if (or howler.is_bundle (not howler.is_bundle))}}\nAlways shows!\n{{/if}}\n\n---\n\n### String Operations\n\n**String Concatenation:**\n\n```markdown\n{{curly 'join \"string one \" \"string two\"'}}\n```\n\n{{join \"string one \" \"string two\"}}\n\n**Uppercase/Lowercase:**\n\n```markdown\n{{curly 'upper \"make this uppercase\"'}}\n{{curly 'lower \"MAKE THIS LOWERCASE\"'}}\n```\n\n{{upper \"make this uppercase\"}}\n\n{{lower \"MAKE THIS LOWERCASE\"}}\n\n---\n\n### Fetching Data\n\nYou can also make basic fetch requests for, and parse, JSON data from external sources:\n\n```markdown\n{{curly 'fetch \"/api/v1/configs\" \"api_response.c12nDef.UNRESTRICTED\"'}}\n```\n\n{{fetch \"/api/v1/configs\" \"api_response.c12nDef.UNRESTRICTED\"}}\n\n## Full Helper List\n"

package/components/routes/overviews/template/fr.md.js

@@ -0,0 +1 @@
+export default "# Cr\u00e9er un aper\u00e7u\n\nLes aper\u00e7us peuvent \u00eatre utilis\u00e9s pour modifier la fa\u00e7on dont les donn\u00e9es sont pr\u00e9sent\u00e9es sur les alertes qui correspondent aux param\u00e8tres de l'aper\u00e7u. Les aper\u00e7us sont, par conception, faciles \u00e0 cr\u00e9er et assez flexibles.\n\n## Premiers pas\n\nLes \u00e9l\u00e9ments de base des aper\u00e7us sont :\n\n1. Markdown\n2. Handlebars\n\nNous allons rapidement expliquer ces \u00e9l\u00e9ments.\n\n### Markdown\n\nCitation de l'excellent [markdownguide.org](https://www.markdownguide.org/getting-started/) :\n\n> Markdown est un langage de balisage l\u00e9ger que vous pouvez utiliser pour ajouter des \u00e9l\u00e9ments de formatage aux documents texte en texte brut. Cr\u00e9\u00e9 par [John Gruber](https://daringfireball.net/projects/markdown/) en 2004, Markdown est maintenant l'un des langages de balisage les plus populaires au monde.\n>\n> L'utilisation de Markdown est diff\u00e9rente de l'utilisation d'un \u00e9diteur [WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG). Dans une application comme Microsoft Word, vous cliquez sur des boutons pour formater les mots et les phrases, et les changements sont visibles imm\u00e9diatement. Markdown n'est pas comme cela. Lorsque vous cr\u00e9ez un fichier format\u00e9 en Markdown, vous ajoutez une syntaxe Markdown au texte pour indiquer quels mots et phrases doivent appara\u00eetre diff\u00e9remment.\n>\n> Par exemple, pour d\u00e9signer un titre, vous ajoutez un signe di\u00e8se avant celui-ci (par ex., `# Titre Un`). Ou pour mettre une phrase en gras, vous ajoutez deux ast\u00e9risques avant et apr\u00e8s (par ex., `**ce texte est en gras**`). Il peut falloir un certain temps pour s'habituer \u00e0 voir la syntaxe Markdown dans votre texte, surtout si vous \u00eates habitu\u00e9 aux applications WYSIWYG.\n\n---\n\n### Handlebars\n\nCitation de [handlebarsjs.com](https://handlebarsjs.com/guide/) :\n\n> Handlebars est un langage de template simple.\n>\n> Il utilise un template et un objet d'entr\u00e9e pour g\u00e9n\u00e9rer du HTML ou d'autres formats de texte. Les templates Handlebars ressemblent \u00e0 du texte normal avec des expressions Handlebars int\u00e9gr\u00e9es.\n>\n>```html\n> <p>{{curly \"firstname\"}} {{curly \"lastname\"}}</p>\n>```\n>\n> Une expression handlebars est une double accolade, du contenu, suivi d'un ensemble d'accolades fermantes doubles. Lorsque le template est ex\u00e9cut\u00e9, ces expressions sont remplac\u00e9es par des valeurs d'un objet d'entr\u00e9e.\n\n---\n\nDans nos cas, nous utilisons handlebars pour remplacer des parties sp\u00e9cifiques du markdown par les valeurs incluses dans un r\u00e9sultat howler donn\u00e9. Par exemple :\n\n```markdown\nCette analytique est **{{curly \"howler.analytic\"}}**\n```\n\ndevient :\n\n> Cette analytique est **{{howler.analytic}}**.\n\nPour plus d'informations sur handlebars, consultez :\n\n- [Qu'est-ce que Handlebars ?](https://handlebarsjs.com/guide/#what-is-handlebars)\n- [Expressions Handlebars](https://handlebarsjs.com/guide/expressions.html)\n\n## Combiner Markdown et Handlebars\n\nVous pouvez utiliser handlebars pour le remplacement de template dans tout votre markdown. Voici un exemple de tableau utilisant handlebars et markdown :\n\n```markdown\n\n| IP Source | IP Destination |\n| --- | --- |\n| {{curly \"source.ip\"}} |{{curly \"destination.ip\"}} |\n```\n\ns'affiche comme :\n\n| IP Source | IP Destination |\n| --- | --- |\n| {{source.ip}} |{{destination.ip}} |\n\n## Handlebars avanc\u00e9s\n\nHowler int\u00e8gre un certain nombre de fonctions d'aide avec lesquelles vous pouvez travailler.\n\n### Expressions de contr\u00f4le\n\nPour utilisation comme sous-expressions, nous exposons un certain nombre de v\u00e9rifications conditionnelles :\n\n**\u00c9galit\u00e9 :**\n\n\u00c9tant donn\u00e9 que `howler.status` est {{howler.status}} :\n\n```markdown\n{{curly '#if (equals howler.status \"open\")'}}\nLe r\u00e9sultat est ouvert !\n{{curly \"/if\"}}\n{{curly '#if (equals howler.status \"resolved\")'}}\nLe r\u00e9sultat est r\u00e9solu !\n{{curly \"/if\"}}\n```\n\n{{#if (equals howler.status \"open\")}}\nLe r\u00e9sultat est ouvert !\n{{/if}}\n{{#if (equals howler.status \"resolved\")}}\nLe r\u00e9sultat est r\u00e9solu !\n{{/if}}\n\n**ET/OU/NON :**\n\n\u00c9tant donn\u00e9 que `howler.status` est {{howler.status}}, et `howler.escalation` est {{howler.escalation}} :\n\n```markdown\n{{curly '#if (and (equals howler.status \"open\") (equals howler.escalation \"alert\"))'}}\nC'est correct !\n{{curly \"/if\"}}\n{{curly '#if (and (equals howler.status \"resolved\") (equals howler.escalation \"hit\"))'}}\nC'est incorrect !\n{{curly \"/if\"}}\n```\n\n{{#if (and (equals howler.status \"open\") (equals howler.escalation \"alert\"))}}\nC'est correct !\n{{/if}}\n{{#if (and (equals howler.status \"resolved\") (equals howler.escalation \"hit\"))}}\nC'est incorrect !\n{{/if}}\n\n```markdown\n{{curly '#if (or howler.is_bundle (not howler.is_bundle))'}}\nS'affiche toujours !\n{{curly \"/if\"}}\n```\n\n{{#if (or howler.is_bundle (not howler.is_bundle))}}\nS'affiche toujours !\n{{/if}}\n\n---\n\n### Op\u00e9rations sur les cha\u00eenes\n\n**Concat\u00e9nation de cha\u00eenes :**\n\n```markdown\n{{curly 'join \"cha\u00eene une \" \"cha\u00eene deux\"'}}\n```\n\n{{join \"cha\u00eene une \" \"cha\u00eene deux\"}}\n\n**Majuscules/Minuscules :**\n\n```markdown\n{{curly 'upper \"mettre ceci en majuscules\"'}}\n{{curly 'lower \"METTRE CECI EN MINUSCULES\"'}}\n```\n\n{{upper \"mettre ceci en majuscules\"}}\n\n{{lower \"METTRE CECI EN MINUSCULES\"}}\n\n---\n\n### R\u00e9cup\u00e9ration de donn\u00e9es\n\nVous pouvez \u00e9galement faire des requ\u00eates fetch de base pour r\u00e9cup\u00e9rer et analyser des donn\u00e9es JSON de sources externes :\n\n```markdown\n{{curly 'fetch \"/api/v1/configs\" \"api_response.c12nDef.UNRESTRICTED\"'}}\n```\n\n{{fetch \"/api/v1/configs\" \"api_response.c12nDef.UNRESTRICTED\"}}\n\n## Liste compl\u00e8te des assistants\n"

package/package.json

@@ -96,7 +96,7 @@
     "internal-slot": "1.0.7"
   },
   "type": "module",
-  "version": "2.14.0-dev.193",
+  "version": "2.14.0-dev.199",
   "exports": {
     "./i18n": "./i18n.js",
     "./index.css": "./index.css",
@@ -244,6 +244,7 @@
     "./components/routes/hits/view/*": "./components/routes/hits/view/*.js",
     "./components/routes/hits/search/shared/*": "./components/routes/hits/search/shared/*.js",
     "./components/routes/hits/search/grid/*": "./components/routes/hits/search/grid/*.js",
+    "./components/routes/overviews/template/*": "./components/routes/overviews/template/*.js",
     "./components/routes/analytics/widgets/*": "./components/routes/analytics/widgets/*.js",
     "./components/routes/help/markdown/*.md": "./components/routes/help/markdown/*.md.js",
     "./components/routes/help/components/*": "./components/routes/help/components/*.js",

package/plugins/borealis/helpers.d.ts

@@ -1,6 +1,3 @@
-declare const HELPERS: {
-    keyword: string;
-    documentation: string;
-    componentCallback: (...args: any[]) => import("react/jsx-runtime").JSX.Element;
-}[];
+import type { HowlerHelper } from '@cccsaurora/howler-ui/components/elements/display/handlebars/helpers';
+declare const HELPERS: HowlerHelper[];
 export default HELPERS;

package/plugins/borealis/helpers.js

@@ -45,7 +45,10 @@ const BorealisCheckbox = ({ value }) => {
 const HELPERS = [
     {
         keyword: 'borealis',
-        documentation: 'Given a selector, this helper enriches the selector through borealis.',
+        documentation: {
+            en: 'Given a selector, this helper enriches the selector through borealis.',
+            fr: 'Étant donné un sélecteur, cet assistant enrichit le sélecteur via borealis.'
+        },
         componentCallback: (type, value) => {
             if (typeof type !== 'string' || typeof value !== 'string') {
                 return (_jsxs(Stack, { spacing: 1, children: [_jsx("strong", { style: { color: 'red' }, children: i18nInstance.t('markdown.error') }), _jsx("code", { style: { fontSize: '0.8rem' }, children: "You must provide at least two arguments: type and value." })] }));
@@ -55,7 +58,10 @@ const HELPERS = [
     },
     {
         keyword: 'fetcher',
-        documentation: 'Given a selector, this helper fetches data for the selector through borealis.',
+        documentation: {
+            en: 'Given a selector, this helper fetches data for the selector through borealis.',
+            fr: 'Étant donné un sélecteur, cet assistant récupère les données pour le sélecteur via borealis.'
+        },
         componentCallback: (...args) => {
             const options = args.pop();
             const props = options?.hash ?? {};
@@ -69,7 +75,10 @@ const HELPERS = [
     },
     {
         keyword: 'borealis_group',
-        documentation: 'Initializes a borealis group',
+        documentation: {
+            en: 'Initializes a borealis group',
+            fr: 'Initialise un groupe borealis'
+        },
         componentCallback: (values, ...args) => {
             const options = args.pop();
             const props = options?.hash ?? {};
@@ -88,7 +97,8 @@ const HELPERS = [
     },
     {
         keyword: 'borealis_table',
-        documentation: `Render a table with optional Borealis enrichments and actions.
+        documentation: {
+            en: `Render a table with optional Borealis enrichments and actions.
 
 Borealis enrichments are performed for cells with a borealis_type.
 
@@ -109,6 +119,28 @@ where borealis_table_cells is an array with properties:
   action_value (optional): string;
 \`\`\`
     `,
+            fr: `Affiche un tableau avec des enrichissements et actions Borealis optionnels.
+
+Les enrichissements Borealis sont effectués pour les cellules avec un borealis_type.
+
+Les actions Borealis sont activées en spécifiant un type d'action borealis en utilisant le paramètre optionnel borealis_action_type. Si activé, les cellules avec borealis_entity==true seront sélectionnables pour utilisation avec les enrichissements et actions Borealis, avec une valeur de action_value si présente, sinon la valeur.
+
+Exemple :
+\`\`\`markdown
+{{curly 'borealis_table borealis_table_cells borealis_action_type="ip"'}}
+\`\`\`
+où borealis_table_cells est un tableau avec les propriétés :
+
+\`\`\`
+  column: string;
+  row: string;
+  value: string;
+  borealis_type (optionnel): string;
+  borealis_entity (optionnel): boolean;
+  action_value (optionnel): string;
+\`\`\`
+    `
+        },
         componentCallback: (cells, ...args) => {
             const options = args.pop();
             const props = options?.hash ?? {};