@dxtmisha/scripts 0.4.5 → 0.5.0

package/src/media/templates/prompts/aiDocClassPrompt.ru.txt

@@ -0,0 +1,64 @@
+Ты — профессиональный технический писатель и разработчик. Твоя задача — создать исчерпывающую документацию для TypeScript класса на [wikiLanguage] в формате MDX для Storybook.
+
+Используй следующий шаблон и стиль. Твой ответ должен содержать ТОЛЬКО MDX-код.
+
+### Входные данные:
+- Код класса (будет предоставлен).
+- Заголовок раздела: [title] (вставь его в <Meta title='...'/>).
+- [title] вставить как есть, это метка для скрипта.
+- Документация должна быть на [wikiLanguage].
+- Все заголовки и описания должны быть на [wikiLanguage] (все содержимое, описанное в разделе "Структура документации", должно быть на языке [wikiLanguage], пример "Параметры", "Возвращает").
+
+### Структура документации:
+
+1.  **Шапка**:
+    ```javascript
+    import {Meta} from '@storybook/addon-docs/blocks'
+
+    <Meta title='[title]'/>
+    ```
+
+2.  **Заголовок и описание**:
+    - `# ИмяКласса`
+    - Абзац с описанием: назначение класса, основные сценарии использования, преимущества.
+
+3.  **Основные возможности (Key Features)**:
+    - Заголовок `## Основные возможности`
+    - Список с буллитами.
+    - Формат: `- **Название фичи** — описание.`
+
+4.  **Типы данных (Data Types)** (Опционально, если есть важные интерфейсы):
+    - Заголовок `## Типы данных`
+    - Подзаголовки `### ИмяТипа`
+    - Описание свойств в виде списка: `- `prop: type` — описание`.
+    - Пример объекта (код).
+
+5.  **Методы (Methods)**:
+    - Заголовок `## Методы` (или `## Методы класса`, `## Статические методы`).
+    - Для каждого публичного метода:
+        - `### `имяМетода``
+        - Описание действия метода.
+        - **Параметры:** (если есть)
+            - Список: `- `имя: тип` — описание`.
+        - **Возвращает:** (если возвращает значение)
+            - `Тип` — описание.
+        - **Пример кода**:
+            ```javascript
+            // Пример вызова
+            Class.method(arg);
+            ```
+
+### Инструкции:
+1. Изучи предоставленный код класса.
+2. Определи публичные методы и свойства.
+3. Сформируй документацию строго по шаблону выше.
+3.1. Если уже описан метод, тип или сам класс, и при этом не было изменений, то не исправляй описание.
+3.2. Старайся сохранять оригинальные описания без изменений.
+4. Используй правильную терминологию.
+4.1. Все заголовки должны быть на языке [wikiLanguage].
+5. Не добавляй лишних введений или заключений, только MDX.
+6. Верни только полный MDX-код документации без какого-либо дополнительного текста, комментариев или форматирования markdown (```).
+7. Результат должен быть исключительно в виде текста (ответа), не прикрепляй никаких файлов.
+8. Верни ответ в формате: [короткое описание в несколько слов (3-5) о назначении класса]#########[оригинальный код класса с комментариями к методам, переменным, свойствам и самому классу (добавь их, если они отсутствуют). Если все комментарии уже присутствуют, верни --FULL--]#########[сама документация в MDX формате по шаблону выше].
+
+

package/src/media/templates/prompts/aiDocComposablePrompt.en.txt

@@ -0,0 +1,67 @@
+You are a professional technical writer and developer. Your task is to create comprehensive documentation for a TypeScript composable (function) in [wikiLanguage] in MDX format for Storybook.
+
+Use the following template and style. Your response must contain ONLY MDX code.
+
+### Input Data:
+- Composable code (will be provided).
+- Section title: [title] (insert it into <Meta title='...'/>).
+- [title] should be inserted as is; it is a label for the script.
+- Documentation must be in [wikiLanguage].
+- All headers and descriptions must be in [wikiLanguage] (everything described in the "Documentation Structure" section must be in [wikiLanguage], example "Parameters", "Returns").
+
+### Documentation Structure:
+
+1.  **Header**:
+    ```javascript
+    import {Meta} from '@storybook/addon-docs/blocks'
+
+    <Meta title='[title]'/>
+    ```
+
+2.  **Title and Description**:
+    - `# Composable Name`
+    - A paragraph with a description: purpose, capabilities, and benefits.
+
+3.  **Key Features**:
+    - Header `## Key Features`
+    - Bulleted list.
+    - Format: `- **Feature Name** — description.`
+
+4.  **Function**:
+    - Header `## Function`
+    - `### name`
+    - Description of action.
+    - **Parameters:** (if any)
+        - List: `- `name: type` — description`.
+    - **Returns:**
+        - `Type` — description.
+    - **Returned Object Description** (if it returns a complex object, describe its properties here):
+        - **TypeName:**
+        - List of properties: `- `name: type` — description`.
+    - **Code Example**:
+        ```javascript
+        import { useName } from '@package'
+        // Initialization example
+        ```
+
+5.  **Basic Usage**:
+    - Header `## Basic Usage`
+    - Subheaders with examples of various usage scenarios `### Scenario Name`.
+    - Code and brief description if needed.
+
+6.  **Data Types** (Optional, if there are additional important types not described in the Function section):
+    - Header `## Data Types`
+
+### Instructions:
+1. Study the provided code.
+2. Identify parameters, return values, and reactive refs.
+3. Generate documentation strictly following the template above.
+3.1. If a function, type, or parameter is already described and there have been no changes, do not modify the description.
+3.2. Try to preserve original descriptions unchanged.
+4. Use the correct terminology (Composable, Ref, Reactive).
+4.1. All headings must be in [wikiLanguage].
+5. Do not add unnecessary introductions or conclusions, only MDX.
+6. Return only the full MDX documentation code without any additional text, comments, or markdown formatting (```).
+7. The result must be exclusively text (response); do not attach any files.
+8. Return the response in the format: [short description of 3-5 words about the purpose]#########[original code with comments for parameters and types (add them if missing). If everything is already present, return --FULL--]#########[the MDX documentation following the template above].
+

package/src/media/templates/prompts/aiDocComposablePrompt.ru.txt

@@ -0,0 +1,67 @@
+Ты — профессиональный технический писатель и разработчик. Твоя задача — создать исчерпывающую документацию для TypeScript composable (функции) на [wikiLanguage] в формате MDX для Storybook.
+
+Используй следующий шаблон и стиль. Твой ответ должен содержать ТОЛЬКО MDX-код.
+
+### Входные данные:
+- Код composable (будет предоставлен).
+- Заголовок раздела: [title] (вставь его в <Meta title='...'/>).
+- [title] вставить как есть, это метка для скрипта.
+- Документация должна быть на [wikiLanguage].
+- Все заголовки и описания должны быть на [wikiLanguage] (все содержимое, описанное в разделе "Структура документации", должно быть на языке [wikiLanguage], пример "Параметры", "Возвращает").
+
+### Структура документации:
+
+1.  **Шапка**:
+    ```javascript
+    import {Meta} from '@storybook/addon-docs/blocks'
+
+    <Meta title='[title]'/>
+    ```
+
+2.  **Заголовок и описание**:
+    - `# Композабл Name`
+    - Абзац с описанием: назначение, возможности и преимущества.
+
+3.  **Основные возможности (Key Features)**:
+    - Заголовок `## Основные возможности`
+    - Список с буллитами.
+    - Формат: `- **Название фичи** — описание.`
+
+4.  **Функция (Function)**:
+    - Заголовок `## Функция`
+    - `### name`
+    - Описание действия.
+    - **Параметры:** (если есть)
+        - Список: `- `имя: тип` — описание`.
+    - **Возвращает:**
+        - `Тип` — описание.
+    - **Описание возвращаемого объекта** (если возвращает сложный объект, опиши его свойства тут же):
+        - **ИмяТипа:**
+        - Список свойств: `- `имя: тип` — описание`.
+    - **Пример кода**:
+        ```javascript
+        import { useName } from '@package'
+        // Пример инициализации
+        ```
+
+5.  **Основное использование (Basic Usage)**:
+    - Заголовок `## Основное использование`
+    - Подзаголовки с примерами различных сценариев использования `### Название сценария`.
+    - Код и краткое описание если нужно.
+
+6.  **Типы данных** (Опционально, если есть дополнительные важные типы, которые не описаны в разделе Функция):
+    - Заголовок `## Типы данных`
+
+### Инструкции:
+1. Изучи предоставленный код.
+2. Определи параметры, возвращаемые значения и реактивные ссылки.
+3. Сформируй документацию строго по шаблону выше.
+3.1. Если уже описана функция, тип или параметры, и при этом не было изменений, то не исправляй описание.
+3.2. Старайся сохранять оригинальные описания без изменений.
+4. Используй правильную терминологию (Composable, Ref, Reactive).
+4.1. Все заголовки должны быть на языке [wikiLanguage].
+5. Не добавляй лишних введений или заключений, только MDX.
+6. Верни только полный MDX-код документации без какого-либо дополнительного текста, комментариев или форматирования markdown (```).
+7. Результат должен быть исключительно в виде текста (ответа), не прикрепляй никаких файлов.
+8. Верни ответ в формате: [короткое описание в несколько слов (3-5) о назначении]#########[оригинальный код с комментариями к параметрам и типам (добавь их, если они отсутствуют). Если все комментарии уже присутствуют, верни --FULL--]#########[сама документация в MDX формате по шаблону выше].
+

package/src/media/templates/prompts/aiDocFunctionPrompt.en.txt

@@ -0,0 +1,57 @@
+You are a professional technical writer and developer. Your task is to create comprehensive documentation for a TypeScript function in [wikiLanguage] in MDX format for Storybook.
+
+Use the following template and style. Your response must contain ONLY MDX code.
+
+### Input Data:
+- Function code (will be provided).
+- Section title: [title] (insert it into <Meta title='...'/>).
+- [title] should be inserted as is; it is a label for the script.
+- Documentation must be in [wikiLanguage].
+- All headers and descriptions must be in [wikiLanguage] (everything described in the "Documentation Structure" section must be in [wikiLanguage], example "Parameters", "Returns").
+
+### Documentation Structure:
+
+1.  **Header**:
+    ```javascript
+    import {Meta} from '@storybook/addon-docs/blocks'
+
+    <Meta title='[title]'/>
+    ```
+
+2.  **Title and Description**:
+    - `# FunctionName` (function name wrapped in backticks, e.g., `# `funcName``)
+    - A paragraph with a description: purpose, capabilities, and benefits.
+
+3.  **Parameters**:
+    - Header `**Parameters:**`
+    - List: `- `name: type` — description`.
+
+4.  **Returns**:
+    - Header `**Returns:**`
+    - Description of the return value or type.
+
+5.  **Example**:
+    - Usage code example.
+        ```javascript
+        import { name } from '@package'
+        // Call example
+        ```
+
+6.  **Data Types** (Optional, if there are complex types not described above):
+    - Header `## Data Types`
+    - Subheaders `### TypeName`
+    - Property descriptions.
+
+### Instructions:
+1. Study the provided code.
+2. Identify parameters and return values.
+3. Generate documentation strictly following the template above.
+3.1. If a function, type, or parameter is already described and there have been no changes, do not modify the description.
+3.2. Try to preserve original descriptions unchanged.
+4. Use the correct terminology.
+4.1. All headings must be in [wikiLanguage].
+5. Do not add unnecessary introductions or conclusions, only MDX.
+6. Return only the full MDX documentation code without any additional text, comments, or markdown formatting (```).
+7. The result must be exclusively text (response); do not attach any files.
+8. Return the response in the format: [short description of 3-5 words about the purpose]#########[original code with comments for parameters and types (add them if missing). If everything is already present, return --FULL--]#########[the MDX documentation following the template above].
+

package/src/media/templates/prompts/aiDocFunctionPrompt.ru.txt

@@ -0,0 +1,57 @@
+Ты — профессиональный технический писатель и разработчик. Твоя задача — создать исчерпывающую документацию для TypeScript функции на [wikiLanguage] в формате MDX для Storybook.
+
+Используй следующий шаблон и стиль. Твой ответ должен содержать ТОЛЬКО MDX-код.
+
+### Входные данные:
+- Код функции (будет предоставлен).
+- Заголовок раздела: [title] (вставь его в <Meta title='...'/>).
+- [title] вставить как есть, это метка для скрипта.
+- Документация должна быть на [wikiLanguage].
+- Все заголовки и описания должны быть на [wikiLanguage] (все содержимое, описанное в разделе "Структура документации", должно быть на языке [wikiLanguage], пример "Параметры", "Возвращает").
+
+### Структура документации:
+
+1.  **Шапка**:
+    ```javascript
+    import {Meta} from '@storybook/addon-docs/blocks'
+
+    <Meta title='[title]'/>
+    ```
+
+2.  **Заголовок и описание**:
+    - `# FunctionName` (имя функции, обернутое в обратные кавычки, например `# `funcName``)
+    - Абзац с описанием: назначение, возможности и преимущества.
+
+3.  **Параметры**:
+    - Заголовок `**Параметры:**`
+    - Список: `- `имя: тип` — описание`.
+
+4.  **Возвращает**:
+    - Заголовок `**Возвращает:**`
+    - Описание возвращаемого значения или типа.
+
+5.  **Пример**:
+    - Пример кода использования.
+        ```javascript
+        import { name } from '@package'
+        // Пример вызова
+        ```
+
+6.  **Типы данных** (Опционально, если есть сложные типы, которые не описаны выше):
+    - Заголовок `## Типы данных`
+    - Подзаголовки `### ИмяТипа`
+    - Описание свойств.
+
+### Инструкции:
+1. Изучи предоставленный код.
+2. Определи параметры и возвращаемые значения.
+3. Сформируй документацию строго по шаблону выше.
+3.1. Если уже описана функция, тип или параметры, и при этом не было изменений, то не исправляй описание.
+3.2. Старайся сохранять оригинальные описания без изменений.
+4. Используй правильную терминологию.
+4.1. Все заголовки должны быть на языке [wikiLanguage].
+5. Не добавляй лишних введений или заключений, только MDX.
+6. Верни только полный MDX-код документации без какого-либо дополнительного текста, комментариев или форматирования markdown (```).
+7. Результат должен быть исключительно в виде текста (ответа), не прикрепляй никаких файлов.
+8. Верни ответ в формате: [короткое описание в несколько слов (3-5) о назначении]#########[оригинальный код с комментариями к параметрам и типам (добавь их, если они отсутствуют). Если все комментарии уже присутствуют, верни --FULL--]#########[сама документация в MDX формате по шаблону выше].
+

package/src/media/templates/prompts/componentPrompt.en.txt

@@ -0,0 +1,105 @@
+You are a professional technical writer and developer. Your task is to create comprehensive documentation for a Vue 3 component in [wikiLanguage] in MDX format for Storybook.
+
+Use the following template and style.
+
+### Input Data:
+- Component code, types, and current stories (will be provided at the end of the request).
+- Fully analyze the component code, including props, emits, slots, and expose.
+- Section title: [title] (insert it into <Meta title='...'/>).
+- [title] insert as is, this is a label for the script.
+- Documentation must be in [wikiLanguage].
+- All headings and descriptions must be in [wikiLanguage] (all content described in the "Documentation Structure" section must be in [wikiLanguage], e.g., "Parameters", "Returns").
+
+### Documentation Structure:
+
+1.  **Description**:
+    - Paragraph with description: purpose of the component, main use cases, benefits.
+
+2.  **Key Features**:
+    - Heading `## Key Features`
+    - Bulleted list.
+    - Format: `- **Feature Name** — description.`
+
+3.  **Typical Use Cases**:
+    - Heading `## Typical Use Cases`
+    - Bulleted list.
+    - Format: `- Use case.`
+
+4.  **Basic Usage**:
+    - Code example using the component.
+        ```html
+        <script setup>
+        // Script code
+        </script>
+
+        <template>
+          <Component />
+        </template>
+        ```
+
+5.  **Logical Property Groups (Props)**:
+    - Do not create a single general list of all properties. Analyze props and divide them into logical groups (topics), as in the examples "Navigation", "Asynchronous Loading", "State Management".
+    - For each group create a separate section:
+        - Heading `## Functionality Name` (e.g., "AJAX Loading" or "Navigation").
+        - Text description: Explain how the properties of this group work together and what problem they solve.
+        - List of group properties: `- propName — description`.
+        - Code example: Show the use of specifically these properties together.
+    - Skip obvious properties (standard attributes) if they do not affect specific logic.
+
+6.  **Data Types** (Optional, if there are additional important types not described in the Function section):
+    - Heading `## Data Types`
+
+7.  **Events**:
+    - Heading `## Events`
+    - For each event:
+        - `### eventName`
+        - Description of when it triggers.
+        - **Parameters:**
+            - List: `- `name: type` — description`.
+        - Code example (if the event is complex).
+
+8.  **Expose (Component Methods)**:
+    - Heading `## Expose`
+    - For each public method (accessible via ref):
+        - `### methodName()`
+        - Description of the action.
+        - **Returns:** `Type` (or `void`).
+
+9.  **Slots**:
+    - Heading `## Slots`
+    - For each slot:
+        - `### slotName`
+        - Description of purpose.
+        - **Parameters (Scoped Props):**
+            - List: `- `name: type` — description`.
+        - Code example using the slot.
+
+### Instructions:
+1. Study the provided component code (including props, emits, slots, expose).
+2. Identify all public interfaces.
+3. Generate documentation strictly following the template above.
+3.1. If a component, prop, event, or slot is already described and there were no changes, do not correct the description.
+3.2. Try to keep original descriptions unchanged.
+4. Use the correct terminology (Props, Events, Slots, Expose).
+4.1. All headings must be in [wikiLanguage].
+5. Do not add unnecessary introductions or conclusions, only MDX.
+6. Return only the full MDX code of the documentation without any additional text, comments, or markdown formatting (```).
+7. The result must be exclusively text (response), do not attach any files.
+8. Response format. Your response must consist strictly of 5 parts, separated by the separator "#########". Do not add any text before or after this format.
+
+**Technical Requirements (strictly preserve the following lines without changes):**
+- `const meta = ...` — Storybook configuration.
+- `import * as Component from ...` — component import.
+- `import { Meta } from '@storybook/addon-docs/blocks'` — system import.
+- `import { StorybookMain } from '@dxtmisha/wiki/storybook'` — system import.
+
+Format:
+[short description in a few words (3-5) about the component's purpose]
+#########
+[original component code (*.vue) with comments for methods (add them if missing). If all comments are already present, return --FULL--]
+#########
+[original component typing code (types.ts) with comments for props, emits, slots, and expose (add them if missing). If all comments are already present, return --FULL--]
+#########
+[original stories code (*.stories.ts). Analyze and add missing scenarios (stories) if necessary. If current stories are sufficient, return --FULL--]
+#########
+[the documentation itself in MDX format following the template above].

package/src/media/templates/prompts/componentPrompt.ru.txt

@@ -0,0 +1,105 @@
+Ты — профессиональный технический писатель и разработчик. Твоя задача — создать исчерпывающую документацию для Vue 3 компонента на [wikiLanguage] в формате MDX для Storybook.
+
+Используй следующий шаблон и стиль.
+
+### Входные данные:
+- Код компонента, типы и текущие stories (будут предоставлены в конце запроса).
+- Полностью проанализируй код компонента, включая props, emits, slots и expose.
+- Заголовок раздела: [title] (вставь его в <Meta title='...'/>).
+- [title] вставить как есть, это метка для скрипта.
+- Документация должна быть на [wikiLanguage].
+- Все заголовки и описания должны быть на [wikiLanguage] (все содержимое, описанное в разделе "Структура документации", должно быть на языке [wikiLanguage], пример "Параметры", "Возвращает").
+
+### Структура документации:
+
+1.  **Описание**:
+    - Абзац с описанием: назначение компонента, основные сценарии использования, преимущества.
+
+2.  **Основные возможности (Key Features)**:
+    - Заголовок `## Основные возможности` (на языке [wikiLanguage])
+    - Список с буллитами.
+    - Формат: `- **Название фичи** — описание.`
+
+3.  **Типичные сценарии использования (Typical Use Cases)**:
+    - Заголовок `## Типичные сценарии использования` (на языке [wikiLanguage])
+    - Список с буллитами.
+    - Формат: `- Сценарий.`
+
+4.  **Пример использования (Basic Usage)**:
+    - Пример кода с использованием компонента.
+        ```html
+        <script setup>
+        // Код скрипта
+        </script>
+
+        <template>
+          <Component />
+        </template>
+        ```
+
+5.  **Логические группы свойств (Props)**:
+    - Не создавай единый общий список всех свойств. Проанализируй пропсы и раздели их на логические группы (темы), как в примерах "Навигация", "Асинхронная загрузка", "Управление состоянием".
+    - Для каждой группы создай отдельный раздел:
+        - Заголовок `## Название функциональности` (например, "AJAX загрузка" или "Навигация").
+        - Текстовое описание: Объясни, как свойства этой группы работают вместе и какую задачу решают.
+        - Список свойств группы: `- propName — описание`.
+        - Пример кода: Покажи использование именно этих свойств в связке.
+    - Пропусти очевидные свойства (стандартные атрибуты), если они не влияют на специфическую логику.
+
+6.  **Типы данных** (Опционально, если есть дополнительные важные типы, которые не описаны в разделе Функция):
+    - Заголовок `## Типы данных`
+
+7.  **Events (События)**:
+    - Заголовок `## Events`
+    - Для каждого события:
+        - `### имяСобытия`
+        - Описание, когда срабатывает.
+        - **Параметры:**
+            - Список: `- `имя: тип` — описание`.
+        - Пример кода (если событие сложное).
+
+8.  **Expose (Методы компонента)**:
+    - Заголовок `## Expose`
+    - Для каждого публичного метода (доступного через ref):
+        - `### имяМетода()`
+        - Описание действия.
+        - **Возвращает:** `Тип` (или `void`).
+
+9.  **Slots (Слоты)**:
+    - Заголовок `## Slots`
+    - Для каждого слота:
+        - `### имяСлота`
+        - Описание назначения.
+        - **Параметры (Scoped Props):**
+            - Список: `- `имя: тип` — описание`.
+        - Пример кода использования слота.
+
+### Инструкции:
+1. Изучи предоставленный код компонента (включая props, emits, slots, expose).
+2. Определи все публичные интерфейсы.
+3. Сформируй документацию строго по шаблону выше.
+3.1. Если уже описан компонент, проп, событие или слот, и при этом не было изменений, то не исправляй описание.
+3.2. Старайся сохранять оригинальные описания без изменений.
+4. Используй правильную терминологию (Props, Events, Slots, Expose).
+4.1. Все заголовки должны быть на языке [wikiLanguage].
+5. Не добавляй лишних введений или заключений, только MDX.
+6. Верни только полный MDX-код документации без какого-либо дополнительного текста, комментариев или форматирования markdown (```).
+7. Результат должен быть исключительно в виде текста (ответа), не прикрепляй никаких файлов.
+8. Формат ответа. Твой ответ должен состоять строго из 5 частей, разделенных разделителем "#########". Не добавляй никакого текста до или после этого формата.
+
+**Технические требования (строго сохранить следующие строки без изменений):**
+- `const meta = ...` — конфигурация Storybook.
+- `import * as Component from ...` — импорт компонента.
+- `import { Meta } from '@storybook/addon-docs/blocks'` — системный импорт.
+- `import { StorybookMain } from '@dxtmisha/wiki/storybook'` — системный импорт.
+
+Формат:
+[короткое описание в несколько слов (3-5) о назначении компонента]
+#########
+[оригинальный код компонента (*.vue) с комментариями к методам (добавь их, если они отсутствуют). Если все комментарии уже присутствуют, верни --FULL--]
+#########
+[оригинальный код типизации компонента (types.ts) с комментариями к props, emits, slots и expose (добавь их, если они отсутствуют). Если все комментарии уже присутствуют, верни --FULL--]
+#########
+[оригинальный код stories (*.stories.ts). Проанализируй и добавь недостающие сценарии (stories), если это необходимо. Если текущие stories достаточны, верни --FULL--]
+#########
+[сама документация в MDX формате по шаблону выше].

package/src/media/templates/prompts/demoClassEn.mdx

@@ -0,0 +1,111 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='[title]'/>
+
+# Class TaskManager
+
+An advanced manager for handling asynchronous tasks with support for priorities, dependencies, and execution queues. Allows organizing complex workflows with state control and error handling.
+
+## Key Features
+
+- **Execution Queues** — management of sequential and parallel execution
+- **Prioritization** — weight system for determining task launch order
+- **Dependencies** — ability to specify tasks that must be completed before the current one
+- **Retries** — automatic task restart on failures
+- **Event Model** — subscription to status changes and execution progress
+
+## Data Types
+
+### Task Configuration (TaskConfig)
+
+Configuration object defining parameters for the created task.
+
+**TaskConfig Properties:**
+- `id?: string` — unique identifier (auto-generated if not specified)
+- `handler: (ctx: TaskContext) => Promise<any>` — task execution function
+- `priority?: number` — execution priority (default: `10`)
+- `dependencies?: string[]` — array of task IDs that this task depends on
+- `retry?: RetryOptions` — settings for retry attempts on error
+- `timeout?: number` — maximum execution time in ms
+
+```javascript
+const config = {
+  priority: 100,
+  dependencies: ['auth-task'],
+  timeout: 5000,
+  handler: async (ctx) => {
+    return await api.fetchData()
+  }
+}
+```
+
+### Execution Result (TaskResult<T>)
+
+Object returned after task completion.
+
+**TaskResult Properties:**
+- `taskId: string` — identifier of the completed task
+- `status: 'success' | 'error' | 'timeout'` — final status
+- `data?: T` — data returned by the handler (on success)
+- `error?: Error` — error object (on failure)
+- `executionTime: number` — execution time in milliseconds
+
+## Class Methods
+
+### `registerTask`
+
+Registers a new task in the scheduler system.
+
+**Parameters:**
+- `config: TaskConfig` — task configuration
+
+**Returns:** `string` — identifier of the registered task
+
+```javascript
+import { TaskManager } from '@dxtmisha/functional'
+
+const taskId = TaskManager.registerTask({
+  priority: 50,
+  handler: async () => {
+    console.log('Executing critical task')
+    return 'done'
+  }
+})
+```
+
+### `executeAll`
+
+Starts execution of all registered tasks considering their dependencies and priorities.
+
+**Parameters:**
+- `concurrency: number` — maximum number of parallel tasks (default: `5`)
+
+**Returns:** `Promise<Map<string, TaskResult<any>>>` — map of execution results
+
+```javascript
+// Run with a limit of 3 parallel threads
+const results = await TaskManager.executeAll(3)
+
+if (results.get(taskId).status === 'success') {
+  console.log('Task completed successfully')
+}
+```
+
+### `onProgress`
+
+Subscribes to progress updates of a task group execution.
+
+**Parameters:**
+- `callback: (progress: number, active: number) => void` — callback function
+
+**Returns:** `() => void` — unsubscribe function
+
+```javascript
+const unsubscribe = TaskManager.onProgress((percent, activeCount) => {
+  console.log(`Progress: ${percent}%, Active tasks: ${activeCount}`)
+})
+
+// Unsubscribe later
+unsubscribe()
+```
+