Merge branch 'main' of https://huggingface.co/spaces/PiperMy/Academy

docs/advanced-development/creating-custom-node.mdx

@@ -0,0 +1,205 @@
+---
+sidebar_position: 1
+---
+
+# Создание кастомной ноды
+
+Создание кастомных нод позволяет обойти ограничения, которые связаны со стандартной библиотекой нод Piper, или же даже просто улучшить функционал текущих нод.
+
+Давайте создадим кастомную ноду **Merge text to JSON**, которая принимает несколько текстовых строк и объединяет их в один JSON массив.
+
+## **1. Загрузка ноды из библиотеки нод**
+
+Для создания кастомной ноды начните с загрузки существующей ноды, которая наиболее близка к вашим требованиям. Перейдите в библиотеку нод, используя значок **плюс (+)** в верхнем левом углу рабочего пространства пайплайны и выберите ноду **Input Text** для модификации, поскольку в ней минимум кода и она работает со строками.
+
+После добавления ноды откройте её настройки.
+
+![Панель настроек ноды](../img/create-node-1.png)
+
+Панель настроек включает несколько вкладок:
+
+- **Inputs** - Текущие параметры ноды, их настройка, загрузка изображений
+- **Design** - Создание входных и выходных параметров, определение их свойств
+- **Script** - Редактирование кода JavaScript, логика ноды
+- **Environment** - Настройка переменных окружения
+- **Catalog** - Просмотр метаданных ноды и её публикация
+- **YAML** - Доступ к YAML ноды
+
+## **2. Настройка ноды**
+
+Кастомизация начинается со вкладки **Design**, где определяется структура ноды.
+
+![Вкладка Design](../img/create-node-2.png)
+
+### Основные свойства
+- **ID** - Внутреннее имя, используемое в коде (строчные латинские буквы, без пробелов)
+- **Title** - Отображаемое имя, видимое пользователю
+
+Для нашей ноды прежние значения необходимо заменить на:
+- ID: `merge_text_to_json`
+- Title: `Merge text to JSON`
+
+### Добавление входных параметров
+
+Нашей ноде нужно 4 строковых входа. Чтобы добавить новый вход:
+
+1. Раскройте меню-гамбургер **Inputs**
+2. Введите имя нового входа: `string1`
+3. Нажмите **Add**
+
+![Добавление нового входного параметра](../img/create-node-3.png)
+
+Настройте параметры входа:
+- **Type**: string (то есть текст)
+- **Title**: String 1 (название, отображаемое на ноде)
+
+![Настройка свойств входа](../img/create-node-4.png)
+
+Повторите этот процесс для создания входов `string2`, `string3` и `string4`.
+
+Чтобы удалить прежний входной параметр `input_text`, снимите галочку с него в меню Inputs.
+
+![Удаление оригинального входа](../img/create-node-5.png)
+
+Если визуально изменения не произошли, нужно временно открыть другую вкладку и потом вернуться в Design.
+
+### Расширенные настройки входных параметров
+
+Доступ к детальным настройкам входных параметров открывается через меню-гамбургер. 
+
+![Выпадающее меню настроек входных параметров](../img/create-node-6.png)
+
+Доступные опции включают:
+
+- **Order** (число) - Задаёт порядок расположения входов в ноде
+- **Description** (текст) - Текст всплывающей подсказки для параметра
+- **Required** (boolean) - True делает параметр обязательным
+- **Group** (текст) - Группирует связанные настройки
+- **Enum** (текст) - Создает выпадающие списки с предопределенными значениями
+- **Multiline** (boolean) - Расширяет поля String для длинного текста
+- **Min, Max** (число) - Устанавливает ограничения для полей Integer
+- **Step** (число) - Преобразует поле Integer в ползунок с шагом, равным значению Step
+- **Default** - Устанавливает значения по умолчанию
+- **Placeholder** (текст) - Показывает подсказку в пустых полях String
+- **Schema** - Техническое поле для скриптов
+- **Extensions** (текст) - Добавляет специальную функциональность (например, draw-mask для задания маски на загруженном изображении)
+
+![Пример конфигурации расширений](../img/create-node-7.png)
+
+### Настройка выходных параметров
+
+Создайте выходной параметр. Для этого удалите прежний выход `output_text` и добавьте новый `json_output` со следующими параметрами:
+- **Type**: JSON
+- **Title**: JSON
+
+Итогое окно Design должно выглядеть примерно так:
+
+![Отредлактированная вкладка Design](../img/create-node-8.png)
+
+:::tip Совет
+Отслеживайте ваши изменения во вкладке **Inputs**, чтобы видеть, как модификации влияют на структуру ноды.
+:::
+
+Про следующий шаг - написание логики скрипта ноды, в разделе **Вкладка Node Script**.
+
+--- eng ---
+
+# Creating Custom Nodes
+
+Creating custom nodes allows you to bypass limitations associated with Piper's standard node library, or even simply improve the functionality of current nodes.
+
+Let's create a custom **Merge text to JSON** node that takes multiple text strings and combines them into a single JSON array.
+
+## **1. Loading a Node from the Node Library**
+
+To create a custom node, start by loading an existing node that's closest to your requirements. Navigate to the node library using the **plus (+)** icon in the top left corner of the pipeline workspace and select the **Input Text** node for modification, since it has minimal code and works with strings.
+
+After adding the node, open its settings.
+
+![Node Settings Panel](../img/create-node-1.png)
+
+The settings panel includes several tabs:
+
+- **Inputs** - Current node parameters, their configuration, image loading
+- **Design** - Creating input and output parameters, defining their properties
+- **Script** - Editing JavaScript code, node logic
+- **Environment** - Configure environment variables
+- **Catalog** - View node metadata and publish it
+- **YAML** - Access the node's YAML
+
+## **2. Node Configuration**
+
+Customization begins in the **Design** tab, where the node structure is defined.
+
+![Design Tab](../img/create-node-2.png)
+
+### Basic Properties
+- **ID** - Internal name used in code (lowercase Latin letters, no spaces)
+- **Title** - Display name visible to the user
+
+For our node, the previous values need to be replaced with:
+- ID: `merge_text_to_json`
+- Title: `Merge text to JSON`
+
+### Adding Input Parameters
+
+Our node needs 4 string inputs. To add a new input:
+
+1. Expand the **Inputs** hamburger menu
+2. Enter the new input name: `string1`
+3. Click **Add**
+
+![Adding New Input Parameter](../img/create-node-3.png)
+
+Configure the input parameters:
+- **Type**: string (i.e., text)
+- **Title**: String 1 (name displayed on the node)
+
+![Configuring Input Properties](../img/create-node-4.png)
+
+Repeat this process to create inputs `string2`, `string3`, and `string4`.
+
+To remove the previous input parameter `input_text`, uncheck it in the Inputs menu.
+
+![Removing Original Input](../img/create-node-5.png)
+
+If no visual changes occur, you need to temporarily open another tab and then return to Design.
+
+### Advanced Input Parameter Settings
+
+Access to detailed settings is opened through the hamburger menu.
+
+![Input Parameter Settings Dropdown Menu](../img/create-node-6.png)
+
+Available options include:
+
+- **Order** (number) - Sets the order of inputs in the node
+- **Description** (text) - Tooltip text for the parameter
+- **Required** (boolean) - True makes the parameter mandatory
+- **Group** (text) - Groups related settings
+- **Enum** (text) - Creates dropdown lists with predefined values
+- **Multiline** (boolean) - Expands String fields for long text
+- **Min, Max** (number) - Sets constraints for Integer fields
+- **Step** (number) - Converts Integer field to slider with step equal to Step value
+- **Default** - Sets default values
+- **Placeholder** (text) - Shows hints in empty String fields
+- **Schema** - Technical field for scripts
+- **Extensions** (text) - Adds special functionality (e.g., draw-mask for setting masks on uploaded images)
+
+![Example Extension Configuration](../img/create-node-7.png)
+
+### Configuring Output Parameters
+
+Create an output parameter. To do this, delete the previous output `output_text` and add a new `json_output` with the following parameters:
+- **Type**: JSON
+- **Title**: JSON
+
+The final Design window should look something like this:
+
+![Edited Design Tab](../img/create-node-8.png)
+
+:::tip Tip
+Monitor your changes in the **Inputs** tab to see how modifications affect the node structure.
+:::
+
+The next step - writing the node's script logic, is covered in the **Node Script Tab** section.

docs/advanced-development/creating-nodes.mdx

@@ -1,134 +0,0 @@
----
-sidebar_position: 1
----
-
-# Create Node
-
-Creating nodes is the foundation of building pipelines in Piper. Each node provides access to a specific neural network or performs a programmed operation, and passes the results to the input of the next node in your workflow.
-
-## **1. Adding a New Node**
-
-To create a new node in your pipeline, locate the **plus (+)** icon in the upper left corner of the interface. This button opens the node library where you can browse and select from available nodes.
-
-![Empty pipeline workspace](../img/create-node-1.webp)
-
-## **2. Node Library**
-
-The node library displays all available nodes organized into logical categories to help you find the right functionality for your pipeline:
-
-![Node selection interface](../img/create-node-2.webp)
-
-### Common Node Categories:
-
-- **Generate images** - Nodes for generating and modifying images
-- **Work with images** - Image processing not related to generation
-- **Generate videos** - Nodes for video generation
-- **Process videos** - Video processing not related to generation
-- **Language agents** - Nodes for calling text LLM models
-- **Analyze images** - Group of nodes for image analysis, evaluation and detection
-- **Computer vision** - Image description nodes
-
-Browse through the categories and click on any node to add it to your pipeline workspace.
-
-## **3. Node Interaction**
-
-Once a node is added to your workspace, you can interact with it using the control icons that appear when you hover over the node:
-
-![Node with control icons](../img/create-node-3.webp)
-
-### Control Icons:
-
-- **Hand icon (🖐️)** - Click and drag to move the node around the workspace
-- **Notebook icon (📝)** - Opens the node configuration panel
-
-These icons provide quick access to essential node operations without cluttering the interface.
-
-## **4. Node Configuration**
-
-Clicking the notebook icon opens the node settings panel where you can customize the node's behavior:
-
-The configuration panel includes multiple tabs:
-
-- **Inputs** - Define input parameters and data sources
-- **Design** - Configure input and output parameters
-- **Script** - Edit the node's JavaScript code logic
-- **Environment** - Configure environment variables
-- **Catalog** - View node metadata and publish it
-- **YAML** - Access the node's YAML definition
-
-## **5. Deleting Nodes**
-
-To remove a node from your pipeline:
-
-1. Click the notebook icon to open the node settings
-2. Look for the red **Delete** button in the upper left corner of the settings panel
-3. Click Delete to permanently remove the node from your pipeline
-
-![Node settings panel](../img/create-node-4.webp)
-
-Be careful when deleting nodes, as this action cannot be undone and may break connections in your pipeline.
-
---- ru ---
-
-# Создание ноды
-
-Создание нод является основой построения пайплайнов в Piper. Каждая нода представляет определенную функцию или операцию, которая обрабатывает данные и передает их на следующий шаг в вашем рабочем процессе.
-
-## **1. Добавление новой ноды**
-
-Чтобы создать новую ноду в вашем пайплайне, найдите значок **плюс (+)** в верхнем левом углу интерфейса. Эта кнопка открывает библиотеку нод, где вы можете просматривать и выбирать из доступных нод.
-
-![Пустое рабочее пространство пайплайна](../img/create-node-1.webp)
-
-## **2. Библиотека нод**
-
-Библиотека нод отображает все доступные ноды, организованные в логические категории, чтобы помочь вам найти нужную функциональность для вашего пайплайна:
-
-![Интерфейс выбора нод](../img/create-node-2.webp)
-
-### Основные категории нод:
-
-- **Генерация изображений** - Ноды для генерации и изменения изображений
-- **Работа с изображениями** - Работа с изображениями, не связанная с генерацией
-- **Генерация видео** - Ноды для генерации видео
-- **Обработка видео** - Работа с видео, не связанная с генерацией
-- **Анализ изображений** - Группа нод по анализу, оценке и детектированию изображений
-- **Computer vision** - Описание изображений
-
-Просмотрите категории и нажмите на любую ноду, чтобы добавить её в рабочее пространство вашего пайплайна.
-
-## **3. Взаимодействие с нодой**
-
-После добавления ноды в рабочее пространство вы можете взаимодействовать с ней с помощью значков управления, которые появляются при наведении курсора на ноду:
-
-![Нода со значками управления](../img/create-node-3.webp)
-
-### Значки управления:
-
-- **Значок ладони (🖐️)** - Нажмите и перетащите для перемещения ноды по рабочему пространству
-- **Значок блокнота (📝)** - Открывает панель настроек ноды
-
-## **4. Настройка ноды**
-
-Нажатие на значок блокнота открывает панель настроек ноды, где вы можете настроить поведение ноды:
-
-Панель настроек включает несколько вкладок:
-
-- **Inputs** - Определение входных параметров и источников данных
-- **Design** - Настройка входных и выходных параметров
-- **Script** - Редактирование JavaScript кода логики ноды
-- **Environment** - Настройка переменных окружения
-- **Catalog** - Просмотр метаданных ноды и её публикация
-- **YAML** - Доступ к YAML ноды
-
-## **5. Удаление нод**
-
-Чтобы удалить ноду из вашего пайплайна:
-
-1. Нажмите на значок блокнота, чтобы открыть настройки ноды
-2. Найдите красную кнопку **Delete** в верхнем левом углу панели настроек
-3. Нажмите Delete, чтобы окончательно удалить ноду из вашего пайплайна
-
-![Node settings panel](../img/create-node-4.webp)
-
-Будьте осторожны при удалении нод, так как это действие нельзя отменить и оно может нарушить соединения в вашем пайплайн.

docs/advanced-development/node-script.mdx

@@ -2,92 +2,215 @@
 sidebar_position: 2
 ---
 
-# Node-Script
+# Вкладка Script в настройках ноды
 
-The **Script tab** is designed for placing JavaScript code that handles the programmatic logic of your node. This is where you define what your node actually does - whether it's processing text, calling APIs, transforming data, or performing calculations.
+Вкладка **Script** предназначена для размещения кода JavaScript, отвечающего за программную логику ноды. Здесь вы определяете, что именно делает ваша нода - обрабатывает ли она текст, вызывает API, трансформирует данные или выполняет вычисления.
 
-![Script tab interface](../img/script_tab.jpg)
+![Интерфейс вкладки Script](../img/script_tab.jpg)
 
-## Code Structure
+## Структура кода
 
-All Piper nodes follow a specific JavaScript structure:
+Все ноды Piper, включая кастомные, следуют определенной структуре JavaScript:
 
 ```javascript
 export async function run({ inputs }) {
     const { FatalError, NextNode } = DEFINITIONS;
     
-    // Your custom code here
+    // Ваш код здесь
     
     return NextNode.from({ 
         outputs: { 
-            // Your results
+            // Ваши результаты
         } 
     });
 }
 ```
 
-This structure ensures your node can properly receive data from previous nodes and pass results to the next ones in your pipeline.
+Эта структура гарантирует, что ваша нода может правильно получать данные от предыдущих нод и передавать результаты следующим в вашем пайплайне.
 
-## Execution Types
+### Оригинальный код Input Text
+Базовая нода **Input Text** имеет эту простую структуру:
+
+```javascript
+export async function run({ inputs }) {
+    const { FatalError, NextNode } = DEFINITIONS;
 
-Choose the appropriate execution type based on how long your node needs to run:
+    const text = inputs.input_text;
 
+    return NextNode.from({
+        outputs: {
+            output_text: text
+        }
+    });
+}
+```
 
-|    Type    | Timeout     |     Description     |
-|------------|-------------|---------------------|
-| Rapid      | 0-20 sec    | Quick operations    |
-| Regular    | 21-60 sec   | Standard processing |
-| Deferred   | 60-120 sec  | Complex operations  |
-| Protracted | 120-300 sec | Heavy processing tasks |
+### Кастомный код Merge Text to JSON
+Нам нужно заменить это логикой, которая обрабатывает несколько строковых входов и создает JSON массив:
 
+```javascript
+export async function run({ inputs }) {
+    const { FatalError, NextNode } = DEFINITIONS;
 
-## Saving Changes
+    const jsonArray = [];
+
+    if (inputs.string1) {
+        jsonArray.push(inputs.string1);
+    }
+    if (inputs.string2) {
+        jsonArray.push(inputs.string2);
+    }
+    if (inputs.string3) {
+        jsonArray.push(inputs.string3);
+    }
+    if (inputs.string4) {
+        jsonArray.push(inputs.string4);
+    }
+
+    return NextNode.from({
+        outputs: {
+            json_output: jsonArray
+        }
+    });
+}
+```
+## Понимание кастомной логики
 
-Always save your script modifications by clicking the **Save** button at the bottom of the interface. Any changes you make to the code must be saved before they take effect.
+Кастомный скрипт реализует следующую логику:
 
-The Script tab is the core of your node's functionality - it's where you transform inputs into outputs using JavaScript code.
+1. **Инициализация пустого массива** - `const jsonArray = []` создает пустой массив для хранения наших текстовых строк
+2. **Проверка каждого входа** - Условия `if` проверяют, что каждый вход имеет значение перед добавлением
+3. **Построение массива** - Только непустые входы добавляются в `jsonArray` с помощью `push()`
+4. **Возврат JSON выхода** - Финальный массив возвращается как `json_output`, соответствуя нашей конфигурации во вкладке Design
 
---- ru ---
+Этот подход гарантирует, что:
+- Пустые или неопределенные входы игнорируются
+- Только валидные текстовые строки включаются в финальный JSON массив
+- Формат выхода соответствует JSON типу, который мы определили во вкладке Design
 
-# Node-Script
+## Типы выполнения
 
-Вкладка **Script** предназначена для размещения кода JavaScript, отвечающего за программную логику ноды. Здесь вы определяете, что именно делает ваша нода - обрабатывает ли она текст, вызывает API, трансформирует данные или выполняет вычисления.
+Выберите подходящий тип выполнения в зависимости от того, сколько времени требуется вашей ноде для работы:
 
-![Интерфейс вкладки Script](../img/script_tab.jpg)
+|    Тип     |   Время     |     Описание          |
+|------------|-------------|-----------------------|
+| Rapid      | 0-20 sec    | Быстрые операции      |
+| Regular    | 21-60 sec   | Стандартная обработка |
+| Deferred   | 60-120 sec  | Сложные операции      |
+| Protracted | 120-300 sec | Тяжелые задачи обработки |
 
-## Структура кода
+Для нашей ноды **Merge text to JSON** подходит выполнение **Rapid**, поскольку мы только манипулируем текстовыми строками и нет обращений к стороннему сервису по API.
+
+## Сохранение изменений
+
+Всегда сохраняйте изменения в скрипте, нажимая кнопку **Save** внизу интерфейса. Любые изменения в коде следует сохранять по нажатию клавиши Save внизу интерфейса.
+
+Вкладка Script - это ядро функциональности вашей ноды, где вы преобразуете входные данные в выходные с помощью кода JavaScript.
+
+--- eng ---
+
+# Script Tab in Node Settings
+
+The **Script** tab is designed for placing JavaScript code that handles the node's programmatic logic. Here you define what exactly your node does - whether it processes text, calls APIs, transforms data, or performs calculations.
 
-Все ноды Piper следуют определенной структуре JavaScript:
+![Script tab interface](../img/script_tab.jpg)
+
+## Code Structure
+
+All Piper nodes, including custom ones, follow a specific JavaScript structure:
 
 ```javascript
 export async function run({ inputs }) {
     const { FatalError, NextNode } = DEFINITIONS;
     
-    // Ваш код здесь
+    // Your code here
     
     return NextNode.from({ 
         outputs: { 
-            // Ваши результаты
+            // Your results
         } 
     });
 }
 ```
 
-Эта структура гарантирует, что ваша нода может правильно получать данные от предыдущих нод и передавать результаты следующим в вашем пайплайне.
+This structure ensures that your node can properly receive data from previous nodes and pass results to the next ones in your pipeline.
 
-## Типы выполнения
+### Original Input Text Code
+The basic **Input Text** node has this simple structure:
 
-Выберите подходящий тип выполнения в зависимости от того, сколько времени требуется вашей ноде для работы:
+```javascript
+export async function run({ inputs }) {
+    const { FatalError, NextNode } = DEFINITIONS;
 
-|    Тип     |   Время     |     Описание          |
+    const text = inputs.input_text;
+
+    return NextNode.from({
+        outputs: {
+            output_text: text
+        }
+    });
+}
+```
+
+### Custom Merge Text to JSON Code
+We need to replace this with logic that processes multiple string inputs and creates a JSON array:
+
+```javascript
+export async function run({ inputs }) {
+    const { FatalError, NextNode } = DEFINITIONS;
+
+    const jsonArray = [];
+
+    if (inputs.string1) {
+        jsonArray.push(inputs.string1);
+    }
+    if (inputs.string2) {
+        jsonArray.push(inputs.string2);
+    }
+    if (inputs.string3) {
+        jsonArray.push(inputs.string3);
+    }
+    if (inputs.string4) {
+        jsonArray.push(inputs.string4);
+    }
+
+    return NextNode.from({
+        outputs: {
+            json_output: jsonArray
+        }
+    });
+}
+```
+
+## Understanding Custom Logic
+
+The custom script implements the following logic:
+
+1. **Initialize empty array** - `const jsonArray = []` creates an empty array to store our text strings
+2. **Check each input** - `if` conditions check that each input has a value before adding
+3. **Build array** - Only non-empty inputs are added to `jsonArray` using `push()`
+4. **Return JSON output** - The final array is returned as `json_output`, matching our configuration in the Design tab
+
+This approach ensures that:
+- Empty or undefined inputs are ignored
+- Only valid text strings are included in the final JSON array
+- The output format matches the JSON type we defined in the Design tab
+
+## Execution Types
+
+Choose the appropriate execution type based on how much time your node requires to work:
+
+|    Type    |   Time      |     Description       |
 |------------|-------------|-----------------------|
-| Rapid      | 0-20 sec    | Быстрые операции      |
-| Regular    | 21-60 sec   | Стандартная обработка |
-| Deferred   | 60-120 sec  | Сложные операции      |
-| Protracted | 120-300 sec | Тяжелые задачи обработки |
+| Rapid      | 0-20 sec    | Fast operations       |
+| Regular    | 21-60 sec   | Standard processing   |
+| Deferred   | 60-120 sec  | Complex operations    |
+| Protracted | 120-300 sec | Heavy processing tasks |
 
-## Сохранение изменений
+For our **Merge text to JSON** node, **Rapid** execution is suitable since we're only manipulating text strings and there are no API calls to external services.
 
-Всегда сохраняйте изменения в скрипте, нажимая кнопку **Save** внизу интерфейса. Любые изменения в коде следует сохранять по нажатию клавиши Save внизу интерфейса.
+## Saving Changes
+
+Always save changes to the script by clicking the **Save** button at the bottom of the interface. Any changes to the code should be saved by pressing the Save button at the bottom of the interface.
 
-Вкладка Script - это ядро функциональности вашей ноды, где вы преобразуете входные данные в выходные с помощью кода JavaScript.
+The Script tab is the core of your node's functionality, where you transform input data into output using JavaScript code.

docs/advanced-development/node-yaml.mdx

@@ -2,81 +2,125 @@
 sidebar_position: 3
 ---
 
-# Node-YAML
+# Вкладка YAML в настройках ноды
 
-The **YAML tab** consolidates all the data from other tabs (Design, Script, Environment, Catalog) into a single, unified representation that defines everything about your node - from its technical metadata to its position in the pipeline workspace.
+Вкладка **YAML** объединяет все данные из других вкладок (Design, Script, Environment, Catalog) в единое представление, которое определяет всё о вашей ноде - от технических метаданных до её позиции в рабочем пространстве пайплайна.
 
-![YAML tab interface](../img/Node-YAML.jpg)
+![Интерфейс вкладки YAML](../img/node-yaml.png)
 
-## What is YAML View?
+## Что такое YAML представление?
 
-The YAML tab serves as the "source code" of your node. It combines:
+Вкладка YAML служит "исходным кодом" вашей ноды. Она объединяет:
 
-- Input/output definitions from the Design tab  
-- JavaScript code from the Script tab
-- Technical metadata from the Catalog tab
-- Environment variables from the Environment tab
-- Node positioning and connections within the pipeline
+- Определения входных и выходных данных из вкладки Design
+- JavaScript код из вкладки Script  
+- Технические метаданные из вкладки Catalog
+- Переменные окружения из вкладки Environment
+- Позиционирование ноды и связи внутри пайплайна
 
-This complete representation makes it possible to duplicate nodes exactly by copying their YAML configuration to other pipelines.
+Это полное представление позволяет точно дублировать ноды, копируя их YAML конфигурацию в другие пайплайны.
 
-## YAML Structure
+## Структура YAML
 
-The YAML configuration is organized into logical sections:
+YAML конфигурация организована в логические секции:
 
-### Technical Information
+### Техническая информация
 ```yaml
-_id: translate_text_artworks
+_id: merge_text_to_json
 version: 1
 category:
-  _id: process_text
-  title: en=Process text;ru=Обработка текста
-package: artworks
-title: en=Translate text;ru=Перевести текст
-source: catalog
+  _id: processing
+  title: en=Processing;ru=Обработка
+package: custom
+title: en=Merge text to JSON;ru=Объединение текста в JSON
+source: node
+execution: regular
 ```
 
-These fields define the node's identity, version, category classification, and package association.
+Эти поля определяют идентификатор ноды, версию, классификацию по категориям и привязку к пакету.
 
-### Execution Configuration
+### Скрипт выполнения
 ```yaml
-execution: regular
-script: |
-  export async function run({ inputs, state }) {
-    // Your JavaScript code here
+script: |-
+  export async function run({ inputs }) {
+      const { NextNode } = DEFINITIONS;
+
+      const jsonArray = [];
+
+      if (inputs.string1) {
+          jsonArray.push(inputs.string1);
+      }
+      if (inputs.string2) {
+          jsonArray.push(inputs.string2);
+      }
+      if (inputs.string3) {
+          jsonArray.push(inputs.string3);
+      }
+      if (inputs.string4) {
+          jsonArray.push(inputs.string4);
+      }
+
+      return NextNode.from({
+          outputs: {
+              json_output: jsonArray
+          }
+      });
   }
 ```
 
-Contains complete JavaScript code from the Script tab.
+Содержит полный кастомный JavaScript код, который мы написали во вкладке Script.
 
-### Node Positioning
+### Позиционирование ноды
 ```yaml
 arrange:
-  x: 610
-  y: 50
+  x: 170
+  y: 290
 ```
 
-Defines the exact position of the node in the pipeline workspace.
+Определяет точное положение ноды в рабочем пространстве пайплайна.
 
-### Input/Output Definitions
+### Определения входных/выходных данных
 ```yaml
 inputs:
-  source:
-    order: 1
-    title: en=Source language;ru=Исходный язык
+  string1:
+    title: en=String 1;ru=Строка 1
+    type: string
+    required: false
+  string2:
+    title: en=String 2;ru=Строка 2
+    type: string
+    required: false
+  string3:
+    title: en=String 3;ru=Строка 3
     type: string
-    required: true
-    default: auto
+    required: false
+  string4:
+    title: en=String 4;ru=Строка 4
+    type: string
+    required: false
 
 outputs:
-  text:
-    title: en=Text;ru=Перевод
-    type: string
+  json_output:
+    title: en=JSON;ru=JSON
+    type: json
 ```
 
-Complete specifications for all input and output parameters, including their types, titles, defaults, and validation rules.
+Полные спецификации для всех 4 входных параметров и 1 выходного параметра, которые мы настроили во вкладке Design.
 
-### Environment Variables
+### Информация каталога (опционально)
+```yaml
+catalog:
+  _id: merge_text_to_json
+  version: 1
+  category:
+    _id: service_nodes
+    title: Service Nodes
+  package: service_nodes
+```
+
+Метаданные для публикации и организации вашей кастомной ноды в каталоге.
+
+### Переменные окружения (опционально)
 ```yaml
 environment:
   OPEN_PAAS_USER:
@@ -85,100 +129,144 @@ environment:
     scope: global
 ```
 
-All environment variables and API keys needed for the node to connect with external providers.
+Все переменные окружения и API ключи, необходимые для подключения ноды к внешним провайдерам.
 
-## Copying and Reusing Nodes
+## Копирование и повторное использование нод
 
-The YAML tab's most powerful feature is the ability to create exact duplicates of nodes:
+Самая мощная функция вкладки YAML - возможность создания точных дубликатов ноды:
 
-1. **Copy the YAML** - Select all content in the YAML tab and copy it
-2. **Create new node** - Add a new node in any pipeline
-3. **Paste configuration** - Replace the new node's YAML with your copied content
-4. **Save changes** - The node will be recreated with identical functionality
+1. **Скопируйте YAML** - Выделите весь код во вкладке YAML и скопируйте его
+2. **Создайте новую ноду** - Добавьте новую ноду в любой пайплайн
+3. **Вставьте конфигурацию** - Замените YAML новой ноды на скопированный код
+4. **Сохраните изменения** - Нода будет воссоздана с идентичной функциональностью
 
-This process preserves all settings, code, and configuration, making it easy to reuse complex nodes across different pipelines.
+Этот процесс сохраняет все настройки, код и конфигурацию, делая простым повторное использование любых нод в разных пайплайнах.
 
-## Read-Only Nature
+## Только для чтения
 
-The YAML tab is primarily for viewing and copying. While you can see the complete node configuration here, modifications should be made through the appropriate tabs (Script for code changes, Design for input/output modifications, etc.) to ensure proper validation and formatting.
+Вкладка YAML в основном предназначена для просмотра и копирования. Хотя вы можете видеть полную конфигурацию ноды здесь, изменения следует вносить через соответствующие вкладки (Script для изменений кода, Design для модификации входных/выходных данных и т.д.), чтобы обеспечить правильную валидацию и форматирование.
 
---- ru ---
+--- eng ---
 
-# Node-YAML
+# YAML Tab in Node Settings
 
-Вкладка **YAML** объединяет все данные из других вкладок (Design, Script, Environment, Catalog) в единое представление, которое определяет всё о вашей ноде - от технических метаданных до её позиции в рабочем пространстве пайплайна.
+The **YAML** tab combines all data from other tabs (Design, Script, Environment, Catalog) into a unified view that defines everything about your node - from technical metadata to its position in the pipeline workspace.
 
-![Интерфейс вкладки YAML](../img/Node-YAML.jpg)
+![YAML Tab Interface](../img/node-yaml.png)
 
-## Что такое YAML представление?
+## What is the YAML View?
 
-Вкладка YAML служит "исходным кодом" вашей ноды. Она объединяет:
+The YAML tab serves as the "source code" of your node. It combines:
 
-- Определения входных и выходных данных из вкладки Design
-- JavaScript код из вкладки Script  
-- Технические метаданные из вкладки Catalog
-- Переменные окружения из вкладки Environment
-- Позиционирование ноды и связи внутри пайплайна
+- Input and output definitions from the Design tab
+- JavaScript code from the Script tab  
+- Technical metadata from the Catalog tab
+- Environment variables from the Environment tab
+- Node positioning and connections within the pipeline
 
-Это полное представление позволяет точно дублировать ноды, копируя их YAML конфигурацию в другие пайплайны.
+This complete representation allows you to precisely duplicate nodes by copying their YAML configuration to other pipelines.
 
-## Структура YAML
+## YAML Structure
 
-YAML конфигурация организована в логические секции:
+The YAML configuration is organized into logical sections:
 
-### Техническая информация
+### Technical Information
 ```yaml
-_id: translate_text_artworks
+_id: merge_text_to_json
 version: 1
 category:
-  _id: process_text
-  title: en=Process text;ru=Обработка текста
-package: artworks
-title: en=Translate text;ru=Перевести текст
-source: catalog
+  _id: processing
+  title: en=Processing;ru=Обработка
+package: custom
+title: en=Merge text to JSON;ru=Объединение текста в JSON
+source: node
+execution: regular
 ```
 
-Эти поля определяют идентификатор ноды, версию, классификацию по категориям и привязку к пакету.
+These fields define the node's identifier, version, category classification, and package binding.
 
-### Конфигурация выполнения
+### Execution Script
 ```yaml
-execution: regular
-script: |
-  export async function run({ inputs, state }) {
-    // Ваш JavaScript код здесь
+script: |-
+  export async function run({ inputs }) {
+      const { NextNode } = DEFINITIONS;
+
+      const jsonArray = [];
+
+      if (inputs.string1) {
+          jsonArray.push(inputs.string1);
+      }
+      if (inputs.string2) {
+          jsonArray.push(inputs.string2);
+      }
+      if (inputs.string3) {
+          jsonArray.push(inputs.string3);
+      }
+      if (inputs.string4) {
+          jsonArray.push(inputs.string4);
+      }
+
+      return NextNode.from({
+          outputs: {
+              json_output: jsonArray
+          }
+      });
   }
 ```
 
-Содержит полный JavaScript код из вкладки Script.
+Contains the complete custom JavaScript code that we wrote in the Script tab.
 
-### Позиционирование ноды
+### Node Positioning
 ```yaml
 arrange:
-  x: 610
-  y: 50
+  x: 170
+  y: 290
 ```
 
-Определяет точное положение ноды в рабочем пространстве пайплайна.
+Defines the exact position of the node in the pipeline workspace.
 
-### Определения входных/выходных данных
+### Input/Output Definitions
 ```yaml
 inputs:
-  source:
-    order: 1
-    title: en=Source language;ru=Исходный язык
+  string1:
+    title: en=String 1;ru=Строка 1
+    type: string
+    required: false
+  string2:
+    title: en=String 2;ru=Строка 2
+    type: string
+    required: false
+  string3:
+    title: en=String 3;ru=Строка 3
     type: string
-    required: true
-    default: auto
+    required: false
+  string4:
+    title: en=String 4;ru=Строка 4
+    type: string
+    required: false
 
 outputs:
-  text:
-    title: en=Text;ru=Перевод
-    type: string
+  json_output:
+    title: en=JSON;ru=JSON
+    type: json
 ```
 
-Полные спецификации для всех входных и выходных параметров, включая их типы, названия, значения по умолчанию и правила валидации.
+Complete specifications for all 4 input parameters and 1 output parameter that we configured in the Design tab.
 
-### Переменные окружения
+### Catalog Information (Optional)
+```yaml
+catalog:
+  _id: merge_text_to_json
+  version: 1
+  category:
+    _id: service_nodes
+    title: Service Nodes
+  package: service_nodes
+```
+
+Metadata for publishing and organizing your custom node in the catalog.
+
+### Environment Variables (Optional)
 ```yaml
 environment:
   OPEN_PAAS_USER:
@@ -187,19 +275,19 @@ environment:
     scope: global
 ```
 
-Все переменные окружения и API ключи, необходимые для подключения ноды к внешним провайдерам.
+All environment variables and API keys required to connect the node to external providers.
 
-## Копирование и повторное использование нод
+## Copying and Reusing Nodes
 
-Самая мощная функция вкладки YAML - возможность создания точных дубликатов нод:
+The most powerful feature of the YAML tab is the ability to create exact duplicates of nodes:
 
-1. **Скопируйте YAML** - Выделите весь контент во вкладке YAML и скопируйте его
-2. **Создайте новую ноду** - Добавьте новую ноду в любой пайплайн
-3. **Вставьте конфигурацию** - Замените YAML новой ноды на скопированный контент
-4. **Сохраните изменения** - Нода будет воссоздана с идентичной функциональностью
+1. **Copy YAML** - Select all code in the YAML tab and copy it
+2. **Create New Node** - Add a new node to any pipeline
+3. **Paste Configuration** - Replace the new node's YAML with the copied code
+4. **Save Changes** - The node will be recreated with identical functionality
 
-Этот процесс сохраняет все настройки, код и конфигурацию, делая простым повторное использование сложных нод в разных пайплайнах.
+This process preserves all settings, code, and configuration, making it simple to reuse any nodes across different pipelines.
 
-## Только для чтения
+## Read-Only
 
-Вкладка YAML в основном предназначена для просмотра и копирования. Хотя вы можете видеть полную конфигурацию ноды здесь, изменения следует вносить через соответствующие вкладки (Script для изменений кода, Design для модификации входных/выходных данных и т.д.), чтобы обеспечить правильную валидацию и форматирование.
+The YAML tab is primarily intended for viewing and copying. While you can see the complete node configuration here, changes should be made through the appropriate tabs (Script for code changes, Design for input/output modifications, etc.) to ensure proper validation and formatting.

docs/advanced-development/pipeline-yaml.mdx

@@ -2,68 +2,65 @@
 sidebar_position: 4
 ---
 
-# Pipeline YAML
+# YAML для пайплайны
 
-The **Pipeline YAML** provides a comprehensive view of your entire pipeline configuration in YAML format. This includes all nodes with their positioning, executable code, interconnections, and various technical information that defines how your pipeline operates.
+**YAML пайплайна** предоставляет комплексный обзор всей конфигурации вашего пайплайна в формате YAML. Это включает все ноды с их расположением, исполняемым кодом, взаимосвязями и различной технической информацией, которая определяет, как работает пайплайн.
 
-## Accessing Pipeline YAML
+## Доступ к YAML пайплайна
 
-To access the pipeline YAML configuration:
+Чтобы получить доступ к конфигурации YAML пайплайна:
 
-1. Click the **More** button in the pipeline interface
-2. Select **YAML** from the dropdown menu
+1. Нажмите кнопку **More** в интерфейсе пайплайна
+2. Выберите **YAML** из выпадающего меню
 
-![Pipeline YAML access](../img/pipeline-yaml-1.jpg)
+![Доступ к YAML пайплайна](../img/pipeline-yaml-1.jpg)
 
-This opens the YAML editor where you can view and modify it.
+Это откроет редактор YAML, где вы можете его просматривать и изменять.
 
-## YAML Structure
+## Структура YAML
 
-The pipeline YAML follows a specific hierarchical structure:
+YAML пайплайна следует определенной иерархической структуре:
 
-### 1. Pipeline Metadata
+### 1. Метаданные пайплайна
 ```yaml
-name: en=Pipeline Name;ru=Название пайплайна
+name: Pipeline Name
 version: 1
-description: en=Pipeline description;ru=Описание пайплайна
+description: Pipeline description
 readme: {}
 category:
   _id: category_id
-  title: en=Category;ru=Категория
-  icon: category_icon
+  title: Category
 ```
 
-This section contains the pipeline's basic information including name, description, and categorization.
+Этот раздел содержит базовую информацию о пайплайне, включая название, описание и категоризацию.
 
-### 2. Start Configuration
+### 2. Конфигурация запуска
 ```yaml
 start:
   nodes:
     - first_node_id
 ```
 
-Defines which node serves as the starting point for pipeline execution.
+Определяет, какая нода служит стартовой точкой для выполнения пайплайна.
 
-### 3. Inputs and Outputs
+### 3. Входы и выходы
 ```yaml
 inputs:
-  input_name:
-    order: 1
-    title: en=Input Title;ru=Название входа
+  string1:
+    title: String 1
     type: string
-    required: true
-    # Additional input parameters
+    # Параметры входных данных
 
 outputs:
-  output_name:
-    title: en=Output Title;ru=Название выхода
-    type: string
-    # Output configuration
+  json_output:
+    title: JSON
+    type: json
+    # Параметры выходных данных
 ```
 
-All pipeline inputs and outputs for all nodes are defined here.
+Здесь определены все входы и выходы для всех нод, размещённые на рабочем пространстве пайплайны.
 
-### 4. Flows (Node Connections)
+### 4. Потоки (соединения нод)
 ```yaml
 flows:
   connection_name:
@@ -73,9 +70,9 @@ flows:
     input: input_parameter
 ```
 
-This section describes how data is transferred between nodes, connecting outputs from one node to inputs of another.
+Этот раздел описывает, как данные передаются между нодами, связывая выходы одной ноды с входами другой.
 
-### 5. Nodes Configuration
+### 5. Конфигурация нод
 ```yaml
 nodes:
   node_id:
@@ -84,101 +81,98 @@ nodes:
     source: node|catalog
     execution: rapid|regular|deferred|protracted
     script: |
-      // JavaScript code
+      // JavaScript код
     inputs:
-      # Node input definitions
+      # Определения входов ноды
     outputs:
-      # Node output definitions
-    environment:
-      # Environment variables
+      # Определения выходов ноды
+    arrange:
+      # Расположение ноды
 ```
 
-Each node in the pipeline is fully described with its configuration, code, and parameters.
+Каждая нода в пайплайне полностью описана со всеми параметрами и кодом.
 
-## Editing and Saving
+## Редактирование и сохранение
 
-When making changes to the pipeline YAML:
+При внесении изменений в YAML пайплайна:
 
-1. **Make your modifications** in the YAML editor
-2. **Click Save** at the bottom of the interface
-3. **Check the status indicator** - a green "Saved" indicator appears on the right side if there are no errors
+1. **Внесите свои изменения** в редакторе YAML
+2. **Нажмите Save** внизу интерфейса
+3. **Проверьте индикатор состояния** - зеленый индикатор "Saved" появится справа, если нет ошибок
 
-![YAML editor interface](../img/pipeline-yaml-2.jpg)
+![Интерфейс редактора YAML](../img/pipeline-yaml-2.jpg)
 
-Any syntax errors or configuration issues will be highlighted, preventing the save operation until resolved.
+Любые синтаксические ошибки или проблемы конфигурации будут выделены, предотвращая операцию сохранения до их устранения.
 
-## Returning to Pipeline Workspace
+## Возврат в рабочее пространство пайплайна
 
-To return to the visual pipeline workspace:
+Чтобы вернуться в визуальное рабочее пространство пайплайна:
 
-- Click the blue **Pipeline** button on the left side of the interface
+- Нажмите синюю кнопку **Pipeline** слева в интерфейсе
 
-This switches you back to the graphical pipeline editor.
+Это переключит вас обратно в графический редактор пайплайна.
 
---- ru ---
+--- eng ---
 
-# YAML пайплайна
+# Pipeline YAML
 
-**YAML пайплайна** предоставляет комплексный обзор всей конфигурации вашего пайплайна в формате YAML. Это включает все ноды с их расположением, исполняемым кодом, взаимосвязями и различной технической информацией, которая определяет, как работает ваш пайплайн.
+**Pipeline YAML** provides a comprehensive overview of your entire pipeline configuration in YAML format. This includes all nodes with their positioning, executable code, relationships, and various technical information that defines how the pipeline operates.
 
-## Доступ к YAML пайплайна
+## Accessing Pipeline YAML
 
-Чтобы получить доступ к конфигурации YAML пайплайна:
+To access the pipeline YAML configuration:
 
-1. Нажмите кнопку **More** в интерфейсе пайплайна
-2. Выберите **YAML** из выпадающего меню
+1. Click the **More** button in the pipeline interface
+2. Select **YAML** from the dropdown menu
 
-![Доступ к YAML пайплайна](../img/pipeline-yaml-1.jpg)
+![Pipeline YAML Access](../img/pipeline-yaml-1.jpg)
 
-Это откроет редактор YAML, где вы можете его просматривать и изменять.
+This opens the YAML editor where you can view and modify it.
 
-## Структура YAML
+## YAML Structure
 
-YAML пайплайна следует определенной иерархической структуре:
+The pipeline YAML follows a specific hierarchical structure:
 
-### 1. Метаданные пайплайна
+### 1. Pipeline Metadata
 ```yaml
-name: en=Pipeline Name;ru=Название пайплайна
+name: Pipeline Name
 version: 1
-description: en=Pipeline description;ru=Описание пайплайна
+description: Pipeline description
 readme: {}
 category:
   _id: category_id
-  title: en=Category;ru=Категория
-  icon: category_icon
+  title: Category
 ```
 
-Этот раздел содержит базовую информацию о пайплайне, включая название, описание и категоризацию.
+This section contains basic information about the pipeline, including name, description, and categorization.
 
-### 2. Конфигурация запуска
+### 2. Start Configuration
 ```yaml
 start:
   nodes:
     - first_node_id
 ```
 
-Определяет, какая нода служит стартовой точкой для выполнения пайплайна.
+Defines which node serves as the starting point for pipeline execution.
 
-### 3. Входы и выходы
+### 3. Inputs and Outputs
 ```yaml
 inputs:
-  input_name:
-    order: 1
-    title: en=Input Title;ru=Название входа
+  string1:
+    title: String 1
     type: string
-    required: true
-    # Дополнительные параметры входа
+    # Input parameters
 
 outputs:
-  output_name:
-    title: en=Output Title;ru=Название выхода
-    type: string
-    # Конфигурация выхода
+  json_output:
+    title: JSON
+    type: json
+    # Output parameters
 ```
 
-Здесь определены все входы и выходы пайплайна для всех нод.
+Here all inputs and outputs for all nodes placed in the pipeline workspace are defined.
 
-### 4. Потоки (соединения нод)
+### 4. Flows (Node Connections)
 ```yaml
 flows:
   connection_name:
@@ -188,9 +182,9 @@ flows:
     input: input_parameter
 ```
 
-Этот раздел описывает, как данные передаются между нодами, связывая выходы одной ноды с входами другой.
+This section describes how data flows between nodes, connecting outputs of one node to inputs of another.
 
-### 5. Конфигурация нод
+### 5. Node Configuration
 ```yaml
 nodes:
   node_id:
@@ -199,33 +193,33 @@ nodes:
     source: node|catalog
     execution: rapid|regular|deferred|protracted
     script: |
-      // JavaScript код
+      // JavaScript code
     inputs:
-      # Определения входов ноды
+      # Node input definitions
     outputs:
-      # Определения выходов ноды
-    environment:
-      # Переменные окружения
+      # Node output definitions
+    arrange:
+      # Node positioning
 ```
 
-Каждая нода в пайплайне полностью описана со своей конфигурацией, кодом и параметрами.
+Each node in the pipeline is fully described with all its parameters and code.
 
-## Редактирование и сохранение
+## Editing and Saving
 
-При внесении изменений в YAML пайплайна:
+When making changes to the pipeline YAML:
 
-1. **Внесите свои изменения** в редакторе YAML
-2. **Нажмите Save** внизу интерфейса
-3. **Проверьте индикатор состояния** - зеленый индикатор "Saved" появится справа, если нет ошибок
+1. **Make your changes** in the YAML editor
+2. **Click Save** at the bottom of the interface
+3. **Check the status indicator** - a green "Saved" indicator will appear on the right if there are no errors
 
-![Интерфейс редактора YAML](../img/pipeline-yaml-2.jpg)
+![YAML Editor Interface](../img/pipeline-yaml-2.jpg)
 
-Любые синтаксические ошибки или проблемы конфигурации будут выделены, предотвращая операцию сохранения до их устранения.
+Any syntax errors or configuration issues will be highlighted, preventing the save operation until they are resolved.
 
-## Возврат в рабочее пространство пайплайна
+## Returning to Pipeline Workspace
 
-Чтобы вернуться в визуальное рабочее пространство пайплайна:
+To return to the visual pipeline workspace:
 
-- Нажмите синюю кнопку **Pipeline** слева в интерфейсе
+- Click the blue **Pipeline** button on the left in the interface
 
-Это переключит вас обратно в графический редактор пайплайна.
+This will switch you back to the graphical pipeline editor.