feat(selectivity): update docs (modes, reportPath, merge-dumps)

Author: KuznetsovRoman

docs/guides/selectivity.mdx

@@ -40,6 +40,8 @@ Let’s enable selectivity in a project with `chrome` and `firefox` browsers. Fo
 
 ```ts
 // testplane.config.ts
+import { SelectivityMode } from "testplane";
+
 const DEV_SERVER_PORT = 3050;
 
 export default {
@@ -53,7 +55,7 @@ export default {
         },
     },
     selectivity: {
-        enabled: true,
+        enabled: SelectivityMode.Enabled,
     },
 } satisfies import("testplane").ConfigInput;
 ```

docs/reference/cli.mdx

@@ -714,6 +714,28 @@ It also works for nested properties. Example of overriding `browsers.firefox.ses
 testplane path/to/mytest.js --browsers-firefox-sessions-per-browser 7
 ```
 
+## `selectivity-merge-dumps` command {#selectivity-merge-dumps}
+
+This command is useful when its needed to merge selectivity dumps from multiple chunks into a single one.
+
+### Usage {#usage}
+
+```bash
+npx testplane selectivity-merge-dumps ./selectivity-chunk-1 ./selectivity-chunk-2 ./selectivity-chunk-3 ./selectivity-chunk-4 -d ./selectivity-full
+npx testplane selectivity-merge-dumps -d ./selectivity-full ./selectivity-chunk-1 ./selectivity-chunk-2 ./selectivity-chunk-3 ./selectivity-chunk-4
+npx testplane selectivity-merge-dumps ./selectivity-chunk-1 ./selectivity-chunk-2 ./selectivity-chunk-3 ./selectivity-chunk-4
+```
+
+### Command options {#options}
+
+You can specify destination directory with "-d" ("--destination") argument.
+
+It can be omitted. In this case "testDependenciesPath" from "selectivity" config section will be used.
+
+### Command arguments {#arguments}
+
+List of paths to selectivity report chunks
+
 ### Overriding with environment variable {#overriding-env-settings}
 
 To override a setting with an environment variable, convert its full path to `snake_case` and add the `testplane_` prefix.

docs/reference/config/browsers.mdx

@@ -1038,9 +1038,13 @@ The section has the following parameters:
     <tbody>
         <tr>
             <td>`enabled`</td>
-            <td>`boolean`</td>
-            <td>`false`</td>
-            <td>Enables selective test execution.</td>
+            <td>`SelectivityMode`</td>
+            <td>`SelectivityMode.Disabled`</td>
+            <td>
+                Available modes: `SelectivityMode.Disabled`, `SelectivityMode.Enabled`, `SelectivityMode.ReadOnly`, `SelectivityMode.WriteOnly`.
+                In `ReadOnly` mode unchanged tests are skipped, but selectivity dump is not updated after successful run.
+                In `WriteOnly` mode all tests are run, but selectivity dump is updated after successful run.
+            </td>
         </tr>
         <tr>
             <td>`sourceRoot`</td>
@@ -1078,6 +1082,12 @@ The section has the following parameters:
                 or filters it completely if `falsy` value is returned
             </td>
         </tr>
+        <tr>
+            <td>`reportPath`</td>
+            <td>`string`</td>
+            <td>`""`</td>
+            <td>If set, selectivity JSON-report will be saved to specified file path.</td>
+        </tr>
     </tbody>
 </table>
 

i18n/ru/docusaurus-plugin-content-docs/current/guides/selectivity.mdx

@@ -40,6 +40,8 @@ export default {
 
 ```ts
 // testplane.config.ts
+import { SelectivityMode } from "testplane";
+
 const DEV_SERVER_PORT = 3050;
 
 export default {
@@ -53,7 +55,7 @@ export default {
         },
     },
     selectivity: {
-        enabled: true,
+        enabled: SelectivityMode.Enabled,
     },
 } satisfies import("testplane").ConfigInput;
 ```

i18n/ru/docusaurus-plugin-content-docs/current/reference/cli.mdx

@@ -716,6 +716,27 @@ testplane path/to/mytest.js --base-url http://example.com
 testplane path/to/mytest.js --browsers-firefox-sessions-per-browser 7
 ```
 
+## Команда `selectivity-merge-dumps` {#selectivity-merge-dumps}
+
+Эта команда полезна, когда необходимо объединить дампы селективности из нескольких частей (чанков) в один.
+
+### Использование {#usage}
+
+````bash
+npx testplane selectivity-merge-dumps ./selectivity-chunk-1 ./selectivity-chunk-2 ./selectivity-chunk-3 ./selectivity-chunk-4 -d ./selectivity-full
+npx testplane selectivity-merge-dumps -d ./selectivity-full ./selectivity-chunk-1 ./selectivity-chunk-2 ./selectivity-chunk-3 ./selectivity-chunk-4
+npx testplane selectivity-merge-dumps ./selectivity-chunk-1 ./selectivity-chunk-2 ./selectivity-chunk-3 ./selectivity-chunk-4
+
+### Опции команды {#options}
+
+Вы можете указать директорию, в которую будет записан результат, с помощью аргумента "-d" ("--destination").
+
+Его можно не указывать. В этом случае будет использован "testDependenciesPath" из секции конфигурации "selectivity".
+
+### Аргументы команды {#arguments}
+
+Список путей к частям (чанкам) отчета селективности
+
 ### Переопределение с помощью переменной окружения {#overriding-env-settings}
 
 Чтобы переопределить настройку с помощью переменной окружения, преобразуйте её полный путь в `snake_case` и добавьте префикс `testplane_`.

i18n/ru/docusaurus-plugin-content-docs/current/reference/config/browsers.mdx

@@ -1042,9 +1042,13 @@ export = {
     <tbody>
         <tr>
             <td>`enabled`</td>
-            <td>`boolean`</td>
-            <td>`false`</td>
-            <td>Включает селективность запуска тестов.</td>
+            <td>`SelectivityMode`</td>
+            <td>`SelectivityMode.Disabled`</td>
+            <td>
+                Доступные режимы: `SelectivityMode.Disabled`, `SelectivityMode.Enabled`, `SelectivityMode.ReadOnly`, `SelectivityMode.WriteOnly`.
+                В режиме `ReadOnly`, нетронутые тесты не запускаются, но дамп селективности не обновляется после успешного запуска.
+                В режиме `WriteOnly` запускаются все тесты, но дамп селективности обновляетя после успешного запуска.
+            </td>
         </tr>
         <tr>
             <td>`sourceRoot`</td>
@@ -1081,6 +1085,12 @@ export = {
                 или полностью игнорирует зависимость, если возвращено `falsy` значение
             </td>
         </tr>
+        <tr>
+            <td>`reportPath`</td>
+            <td>`string`</td>
+            <td>`""`</td>
+            <td>Если указано, JSON-отчет о селективности будет сохранен в соответствующий файл.</td>
+        </tr>
     </tbody>
 </table>