complexqa_frontend_core 1.21.7 → 1.22.0

package/publish/types/element_translate/typeUtilExecutionScreenshotMulti.i18n.js

@@ -1,65 +1,281 @@
-import { familyUtil_i18n } from './_familyUtil.i18n.js';
-
-/**
- * Переводы для typeUtilExecutionScreenshotMulti.
- *
- * @see typeUtilExecutionScreenshotMulti
- */
-export const typeUtilExecutionScreenshotMulti_i18n = {
-	attribute_name_translate_matrix: {
-		en: {
-			util_execution_id              : 'Execution',
-			util_action_id                 : 'Action ID',
-			util_action_key                : 'Action',
-			project_id                     : 'Project',
-			user_id                        : 'User',
-			execution_status               : 'Status',
-			external_job_id                : 'External job',
-			error_message                  : 'Error',
-			submitted_at                   : 'Submitted at',
-			completed_at                   : 'Completed at',
-			created_at                     : 'Created at',
-			screenshot_count               : 'Screenshots',
-			page_url                       : 'Page URL',
-			wait_until                     : 'Wait until',
-			full_page                      : 'Full page',
-			navigation_timeout_milliseconds: 'Navigation timeout (ms)',
-			capture_matrix_preset          : 'Capture matrix',
-			last_callback_status           : 'Last callback status',
-			captures_total                 : 'Captures total',
-			captures_succeeded             : 'Captures succeeded',
-			captures_failed                : 'Captures failed',
-			duration_milliseconds          : 'Duration (ms)',
-		},
-		ru: {
-			util_execution_id              : 'Запуск',
-			util_action_id                 : 'ID действия',
-			util_action_key                : 'Действие',
-			project_id                     : 'Проект',
-			user_id                        : 'Пользователь',
-			execution_status               : 'Статус',
-			external_job_id                : 'Внешняя задача',
-			error_message                  : 'Ошибка',
-			submitted_at                   : 'Отправлено',
-			completed_at                   : 'Завершено',
-			created_at                     : 'Создано',
-			screenshot_count               : 'Скриншоты',
-			page_url                       : 'URL страницы',
-			wait_until                     : 'Ожидание загрузки',
-			full_page                      : 'Полная страница',
-			navigation_timeout_milliseconds: 'Таймаут навигации (мс)',
-			capture_matrix_preset          : 'Матрица захвата',
-			last_callback_status           : 'Статус callback',
-			captures_total                 : 'Всего захватов',
-			captures_succeeded             : 'Успешных захватов',
-			captures_failed                : 'Ошибок захвата',
-			duration_milliseconds          : 'Длительность (мс)',
-		},
-	},
-
-	enum_value_translate_matrix: {
-		capture_matrix_preset: familyUtil_i18n.capture_matrix_preset,
-		wait_until           : familyUtil_i18n.wait_until,
-		last_callback_status : familyUtil_i18n.execution_status,
-	},
-};
+import { familyUtil_i18n } from './_familyUtil.i18n.js';
+
+/**
+ * Переводы для typeUtilExecutionScreenshotMulti.
+ *
+ * @see typeUtilExecutionScreenshotMulti
+ */
+export const typeUtilExecutionScreenshotMulti_i18n = {
+	attribute_name_translate_matrix: {
+		en: {
+			util_execution_id              : 'Execution',
+			util_action_id                 : 'Action ID',
+			util_action_key                : 'Action',
+			project_id                     : 'Project',
+			user_id                        : 'User',
+			execution_status               : 'Status',
+			external_job_id                : 'External job',
+			error_message                  : 'Error',
+			submitted_at                   : 'Submitted at',
+			completed_at                   : 'Completed at',
+			created_at                     : 'Created at',
+			screenshot_count               : 'Screenshots',
+			page_url                       : 'Page URL',
+			wait_until                     : 'Wait until',
+			full_page                      : 'Full page',
+			navigation_timeout_milliseconds: 'Նավիգացիայի timeout (ms)',
+			capture_matrix_preset          : 'Capture matrix',
+			last_callback_status           : 'Last callback status',
+			captures_total                 : 'Captures total',
+			captures_succeeded             : 'Captures succeeded',
+			captures_failed                : 'Captures failed',
+			duration_milliseconds          : 'Duration (ms)',
+		},
+		ru: {
+			util_execution_id              : 'Запуск',
+			util_action_id                 : 'ID действия',
+			util_action_key                : 'Действие',
+			project_id                     : 'Проект',
+			user_id                        : 'Пользователь',
+			execution_status               : 'Статус',
+			external_job_id                : 'Внешняя задача',
+			error_message                  : 'Ошибка',
+			submitted_at                   : 'Отправлено',
+			completed_at                   : 'Завершено',
+			created_at                     : 'Создано',
+			screenshot_count               : 'Скриншоты',
+			page_url                       : 'URL страницы',
+			wait_until                     : 'Ожидание загрузки',
+			full_page                      : 'Полная страница',
+			navigation_timeout_milliseconds: 'Таймаут навигации (мс)',
+			capture_matrix_preset          : 'Матрица захвата',
+			last_callback_status           : 'Статус callback',
+			captures_total                 : 'Всего захватов',
+			captures_succeeded             : 'Успешных захватов',
+			captures_failed                : 'Ошибок захвата',
+			duration_milliseconds          : 'Длительность (мс)',
+		},
+		de: {
+			util_execution_id              : 'Ausführung',
+			util_action_id                 : 'Aktions-ID',
+			util_action_key                : 'Aktion',
+			project_id                     : 'Projekt',
+			user_id                        : 'Benutzer',
+			execution_status               : 'Status',
+			external_job_id                : 'Externer Job',
+			error_message                  : 'Fehler',
+			submitted_at                   : 'Gesendet am',
+			completed_at                   : 'Abgeschlossen am',
+			created_at                     : 'Erstellt am',
+			screenshot_count               : 'Screenshots',
+			page_url                       : 'Seiten-URL',
+			wait_until                     : 'Warten bis',
+			full_page                      : 'Ganze Seite',
+			navigation_timeout_milliseconds: 'Navigations-Timeout (ms)',
+			capture_matrix_preset          : 'Aufnahme-Matrix',
+			last_callback_status           : 'Letzter Callback-Status',
+			captures_total                 : 'Aufnahmen gesamt',
+			captures_succeeded             : 'Erfolgreiche Aufnahmen',
+			captures_failed                : 'Fehlgeschlagene Aufnahmen',
+			duration_milliseconds          : 'Dauer (ms)',
+		},
+		ar: {
+			util_execution_id              : 'التشغيل',
+			util_action_id                 : 'معرف الإجراء',
+			util_action_key                : 'الإجراء',
+			project_id                     : 'المشروع',
+			user_id                        : 'المستخدم',
+			execution_status               : 'الحالة',
+			external_job_id                : 'المهمة الخارجية',
+			error_message                  : 'خطأ',
+			submitted_at                   : 'تاريخ الإرسال',
+			completed_at                   : 'تاريخ الإكمال',
+			created_at                     : 'تاريخ الإنشاء',
+			screenshot_count               : 'لقطات الشاشة',
+			page_url                       : 'رابط الصفحة',
+			wait_until                     : 'انتظار حتى',
+			full_page                      : 'صفحة كاملة',
+			navigation_timeout_milliseconds: 'مهلة التنقل (مللي ثانية)',
+			capture_matrix_preset          : 'مصفوفة الالتقاط',
+			last_callback_status           : 'آخر حالة callback',
+			captures_total                 : 'إجمالي الالتقاطات',
+			captures_succeeded             : 'التقاطات ناجحة',
+			captures_failed                : 'التقاطات فاشلة',
+			duration_milliseconds          : 'المدة (مللي ثانية)',
+		},
+		es: {
+			util_execution_id              : 'Ejecución',
+			util_action_id                 : 'ID de acción',
+			util_action_key                : 'Acción',
+			project_id                     : 'Proyecto',
+			user_id                        : 'Usuario',
+			execution_status               : 'Estado',
+			external_job_id                : 'Trabajo externo',
+			error_message                  : 'Error',
+			submitted_at                   : 'Enviado el',
+			completed_at                   : 'Completado el',
+			created_at                     : 'Creado el',
+			screenshot_count               : 'Capturas',
+			page_url                       : 'URL de página',
+			wait_until                     : 'Esperar hasta',
+			full_page                      : 'Página completa',
+			navigation_timeout_milliseconds: 'Tiempo de espera de navegación (ms)',
+			capture_matrix_preset          : 'Matriz de captura',
+			last_callback_status           : 'Último estado callback',
+			captures_total                 : 'Capturas totales',
+			captures_succeeded             : 'Capturas exitosas',
+			captures_failed                : 'Capturas fallidas',
+			duration_milliseconds          : 'Duración (ms)',
+		},
+		fr: {
+			util_execution_id              : 'Exécution',
+			util_action_id                 : 'ID action',
+			util_action_key                : 'Action',
+			project_id                     : 'Projet',
+			user_id                        : 'Utilisateur',
+			execution_status               : 'Statut',
+			external_job_id                : 'Tâche externe',
+			error_message                  : 'Erreur',
+			submitted_at                   : 'Soumis le',
+			completed_at                   : 'Terminé le',
+			created_at                     : 'Créé le',
+			screenshot_count               : 'Captures',
+			page_url                       : 'URL de page',
+			wait_until                     : 'Attendre jusqu\'à',
+			full_page                      : 'Page entière',
+			navigation_timeout_milliseconds: 'Délai de navigation (ms)',
+			capture_matrix_preset          : 'Matrice de capture',
+			last_callback_status           : 'Dernier statut callback',
+			captures_total                 : 'Captures totales',
+			captures_succeeded             : 'Captures réussies',
+			captures_failed                : 'Captures échouées',
+			duration_milliseconds          : 'Durée (ms)',
+		},
+		hy: {
+			util_execution_id              : 'Գործարկում',
+			util_action_id                 : 'Գործողության ID',
+			util_action_key                : 'Գործողություն',
+			project_id                     : 'Նախագիծ',
+			user_id                        : 'Օգտատեր',
+			execution_status               : 'Կարգավիճակ',
+			external_job_id                : 'Արտաքին աշխատանք',
+			error_message                  : 'Սխալ',
+			submitted_at                   : 'Ուղարկված',
+			completed_at                   : 'Ավարտված',
+			created_at                     : 'Ստեղծված',
+			screenshot_count               : 'Screenshot-ներ',
+			page_url                       : 'Էջի URL',
+			wait_until                     : 'Սպասել մինչև',
+			full_page                      : 'Ամբողջ էջ',
+			navigation_timeout_milliseconds: 'Navigation timeout (ms)',
+			capture_matrix_preset          : 'Նկարահանման մատրիցա',
+			last_callback_status           : 'Վերջին callback կարգավիճակ',
+			captures_total                 : 'Ընդամենը նկարահանում',
+			captures_succeeded             : 'Հաջող նկարահանում',
+			captures_failed                : 'Ձախողված նկարահանում',
+			duration_milliseconds          : 'Տևողություն (ms)',
+		},
+		it: {
+			util_execution_id              : 'Esecuzione',
+			util_action_id                 : 'ID azione',
+			util_action_key                : 'Azione',
+			project_id                     : 'Progetto',
+			user_id                        : 'Utente',
+			execution_status               : 'Stato',
+			external_job_id                : 'Job esterno',
+			error_message                  : 'Errore',
+			submitted_at                   : 'Inviato il',
+			completed_at                   : 'Completato il',
+			created_at                     : 'Creato il',
+			screenshot_count               : 'Screenshot',
+			page_url                       : 'URL pagina',
+			wait_until                     : 'Attendi fino a',
+			full_page                      : 'Pagina intera',
+			navigation_timeout_milliseconds: 'Timeout navigazione (ms)',
+			capture_matrix_preset          : 'Matrice acquisizione',
+			last_callback_status           : 'Ultimo stato callback',
+			captures_total                 : 'Acquisizioni totali',
+			captures_succeeded             : 'Acquisizioni riuscite',
+			captures_failed                : 'Acquisizioni fallite',
+			duration_milliseconds          : 'Durata (ms)',
+		},
+		pl: {
+			util_execution_id              : 'Uruchomienie',
+			util_action_id                 : 'ID akcji',
+			util_action_key                : 'Akcja',
+			project_id                     : 'Projekt',
+			user_id                        : 'Użytkownik',
+			execution_status               : 'Status',
+			external_job_id                : 'Zadanie zewnętrzne',
+			error_message                  : 'Błąd',
+			submitted_at                   : 'Wysłano',
+			completed_at                   : 'Ukończono',
+			created_at                     : 'Utworzono',
+			screenshot_count               : 'Zrzuty ekranu',
+			page_url                       : 'URL strony',
+			wait_until                     : 'Czekaj do',
+			full_page                      : 'Pełna strona',
+			navigation_timeout_milliseconds: 'Limit nawigacji (ms)',
+			capture_matrix_preset          : 'Macierz przechwyceń',
+			last_callback_status           : 'Ostatni status callback',
+			captures_total                 : 'Łącznie przechwyceń',
+			captures_succeeded             : 'Udane przechwycenia',
+			captures_failed                : 'Nieudane przechwycenia',
+			duration_milliseconds          : 'Czas trwania (ms)',
+		},
+		pt: {
+			util_execution_id              : 'Execução',
+			util_action_id                 : 'ID da ação',
+			util_action_key                : 'Ação',
+			project_id                     : 'Projeto',
+			user_id                        : 'Utilizador',
+			execution_status               : 'Estado',
+			external_job_id                : 'Tarefa externa',
+			error_message                  : 'Erro',
+			submitted_at                   : 'Enviado em',
+			completed_at                   : 'Concluído em',
+			created_at                     : 'Criado em',
+			screenshot_count               : 'Capturas de ecrã',
+			page_url                       : 'URL da página',
+			wait_until                     : 'Aguardar até',
+			full_page                      : 'Página completa',
+			navigation_timeout_milliseconds: 'Tempo limite de navegação (ms)',
+			capture_matrix_preset          : 'Matriz de captura',
+			last_callback_status           : 'Último estado callback',
+			captures_total                 : 'Capturas totais',
+			captures_succeeded             : 'Capturas bem-sucedidas',
+			captures_failed                : 'Capturas falhadas',
+			duration_milliseconds          : 'Duração (ms)',
+		},
+		tt: {
+			util_execution_id              : 'Йөгертү',
+			util_action_id                 : 'Гамәл ID',
+			util_action_key                : 'Гамәл',
+			project_id                     : 'Проект',
+			user_id                        : 'Кулланучы',
+			execution_status               : 'Статус',
+			external_job_id                : 'Тыш эш',
+			error_message                  : 'Хата',
+			submitted_at                   : 'Җибәрелгән',
+			completed_at                   : 'Тәмамланган',
+			created_at                     : 'Ясалган',
+			screenshot_count               : 'Скриншотлар',
+			page_url                       : 'Бит URL',
+			wait_until                     : 'Көтәргә',
+			full_page                      : 'Тулы бит',
+			navigation_timeout_milliseconds: 'Навигация таймауты (ms)',
+			capture_matrix_preset          : 'Үз матрицасы',
+			last_callback_status           : 'Соңгы callback статусы',
+			captures_total                 : 'Барлыгы тоту',
+			captures_succeeded             : 'Уңышлы тоту',
+			captures_failed                : 'Хаталы тоту',
+			duration_milliseconds          : 'Озынлыгы (ms)',
+		},
+	},
+
+	enum_value_translate_matrix: {
+		capture_matrix_preset: familyUtil_i18n.capture_matrix_preset,
+		wait_until           : familyUtil_i18n.wait_until,
+		last_callback_status : familyUtil_i18n.execution_status,
+	},
+};

package/publish/types/family_elements/typeProject.js

@@ -99,13 +99,12 @@ export class typeProject extends familyGeneralElement
 
 	/**
 	 *
-	 * All test cases + suites
-	 * @version        v.1.0 (23/08/2025)
-	 * @param project_id
-	 * @param callback
+	 * @param {string} methodName
+	 * @param {number|false} project_id
+	 * @param {object} callback
 	 * @returns {Promise<any>}
 	 */
-	async get_test_structure(project_id = false, callback = {})
+	async _get_project_structure(methodName, project_id = false, callback = {})
 	{
 		if (!project_id)
 		{
@@ -114,11 +113,9 @@ export class typeProject extends familyGeneralElement
 
 		let payload = {
 			project_id: project_id
-		}
-		/**
-		 * {Api} ApiService
-		 */
-		return ApiService[ this.api_key ].get_test_structure(payload).then((response) =>
+		};
+
+		return ApiService[ this.api_key ][ methodName ](payload).then((response) =>
 		{
 			if (typeof callback?.success === 'function')
 			{
@@ -141,6 +138,34 @@ export class typeProject extends familyGeneralElement
 	}
 
 
+	/**
+	 *
+	 * All test cases + suites
+	 * @version        v.1.0 (23/08/2025)
+	 * @param project_id
+	 * @param callback
+	 * @returns {Promise<any>}
+	 */
+	async get_test_structure(project_id = false, callback = {})
+	{
+		return this._get_project_structure('get_test_structure', project_id, callback);
+	}
+
+
+	/**
+	 *
+	 * All text documents + folders
+	 * @version        v.1.0 (04/07/2026)
+	 * @param project_id
+	 * @param callback
+	 * @returns {Promise<any>}
+	 */
+	async get_text_document_structure(project_id = false, callback = {})
+	{
+		return this._get_project_structure('get_text_document_structure', project_id, callback);
+	}
+
+
 	/**
 	 *
 	 * @version			v.0.1 (05/06/2025)

package/publish/types/family_files/typeFile.js

@@ -6,6 +6,8 @@ import { typeFile_i18n } from "../element_translate/typeFile.i18n.js";
 /**
  * Базовый тип файла File App (wire + URL helpers).
  *
+ * @see docs/File App Layer/typeFile-docs.MD
+ *
  * @version			v.1.0 (28/06/2026)
  */
 export class typeFile extends familyFile

package/publish/types/family_files/typeTextDocument.js

@@ -0,0 +1,88 @@
+import { is_object } from "../../utils/utils.js";
+import { familyGeneralElement } from "../core/0_familyGeneralElement.js";
+import { typeTextDocument_i18n } from "../element_translate/typeTextDocument.i18n.js";
+
+/**
+ * Text document — standalone WYSIWYG entity (Contour B).
+ *
+ * @see docs/Text Document/README.md
+ *
+ * @version v.1.0 (04/07/2026)
+ */
+export class typeTextDocument extends familyGeneralElement
+{
+	text_document_id;
+	project_id;
+	team_id;
+	text_document_folder_id;
+	text_document_title;
+	text_document_status;
+	file_uuid;
+	created_by_user_id;
+	created_at;
+	updated_at;
+
+	primary_key = 'text_document_id';
+	api_key     = 'text_document';
+
+	structure_scheme = {
+		text_document_id       : 'integer | require',
+		project_id             : 'integer | require',
+		team_id                : 'integer | require',
+		text_document_folder_id: 'integer | optional',
+		text_document_title    : 'string | require',
+		text_document_status   : 'string | enum | require',
+		file_uuid              : 'string | optional',
+		created_by_user_id     : 'integer | optional',
+		created_at             : 'timestamp | require',
+		updated_at             : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'text_document_folder_id',
+	];
+
+	available_enum_values = {
+		text_document_status: [ 'DRAFT', 'PUBLISHED', 'ARCHIVED' ],
+	};
+
+	attribute_name_translate_matrix = typeTextDocument_i18n.attribute_name_translate_matrix;
+
+	enum_value_translate_matrix = typeTextDocument_i18n.enum_value_translate_matrix;
+
+	status_color = {
+		PUBLISHED: '#009688',
+		ARCHIVED : '#E0E0E0',
+		DRAFT    : '#C4B040',
+	};
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+	/**
+	 * @returns {string}
+	 */
+	get_element_name()
+	{
+		return this.text_document_title || '';
+	}
+}

package/publish/types/family_files/typeTextDocumentFolder.js

@@ -0,0 +1,68 @@
+import { is_object } from "../../utils/utils.js";
+import { familyGeneralElement } from "../core/0_familyGeneralElement.js";
+import { typeTextDocumentFolder_i18n } from "../element_translate/typeTextDocumentFolder.i18n.js";
+
+/**
+ * Folder tree node for text documents within a project.
+ *
+ * @version v.1.0 (04/07/2026)
+ */
+export class typeTextDocumentFolder extends familyGeneralElement
+{
+	text_document_folder_id;
+	project_id;
+	team_id;
+	parent_text_document_folder_id;
+	text_document_folder_name;
+	created_at;
+	updated_at;
+
+	primary_key = 'text_document_folder_id';
+	api_key     = 'text_document_folder';
+
+	structure_scheme = {
+		text_document_folder_id       : 'integer | require',
+		project_id                    : 'integer | require',
+		team_id                       : 'integer | require',
+		parent_text_document_folder_id: 'integer | optional',
+		text_document_folder_name     : 'string | optional',
+		created_at                    : 'timestamp | require',
+		updated_at                    : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'project_id',
+		'parent_text_document_folder_id',
+	];
+
+	attribute_name_translate_matrix = typeTextDocumentFolder_i18n.attribute_name_translate_matrix;
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+	/**
+	 * @returns {string}
+	 */
+	get_element_name()
+	{
+		return this.text_document_folder_name || '';
+	}
+}

package/publish/types/family_utils/typeUtilExecution.js

@@ -5,7 +5,6 @@ import { typeUtilExecutionScreenshotMulti } from "./typeUtilExecutionScreenshotM
 import { typeUtilExecutionScreenshotMultiCapture } from "./typeUtilExecutionScreenshotMultiCapture.js";
 import { typeUtilExecutionScreenshotMultiScreenshot } from "./typeUtilExecutionScreenshotMultiScreenshot.js";
 import { typeUtilExecutionScreenshotMultiCaptureError } from "./typeUtilExecutionScreenshotMultiCaptureError.js";
-import { typeUtilExecutionEvent } from "./typeUtilExecutionEvent.js";
 import { typeFile } from "../family_files/typeFile.js";
 import { create_type_file_from_wire } from "../family_files/typeFileFactory.js";
 
@@ -121,7 +120,12 @@ export class typeUtilExecution extends familyUtil
 	 *     file: import('../family_files/typeFile.js').typeFile|false,
 	 *   }>,
 	 *   capture_errors: typeUtilExecutionScreenshotMultiCaptureError[],
-	 *   events: typeUtilExecutionEvent[],
+	 *   events: Array<{
+	 *     util_execution_event_id?: number,
+	 *     util_execution_id?: number,
+	 *     event_type?: string,
+	 *     created_at?: string,
+	 *   }>,
 	 * }|false}
 	 */
 	static composeDetails(data)
@@ -149,7 +153,14 @@ export class typeUtilExecution extends familyUtil
 				? data.capture_errors.map((row) => new typeUtilExecutionScreenshotMultiCaptureError(row))
 				: [],
 			events          : Array.isArray(data.events)
-				? data.events.map((row) => new typeUtilExecutionEvent(row))
+				? data.events
+					.filter((row) => is_object(row))
+					.map((row) => ({
+						util_execution_event_id: row.util_execution_event_id,
+						util_execution_id      : row.util_execution_id,
+						event_type             : row.event_type,
+						created_at             : row.created_at,
+					}))
 				: [],
 		};
 	}