complexqa_frontend_core 1.21.1 → 1.21.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complexqa_frontend_core",
-  "version": "1.21.1",
+  "version": "1.21.3",
   "description": "core of web ",
   "type": "module",
   "exports": {

package/publish/api/index.js

@@ -20,6 +20,8 @@ import { ExecutionContextApi } from "./context/context_execution_general_api.js"
 import { ContextLocaleApi } from "./context/context_locale_api.js";
 import { ContextOsApi } from "./context/context_os_api.js";
 import { ContextScreenResolutionApi } from "./context/context_screen_resolution_api.js";
+import { BrowserToolsUtilExecutionApi } from "./util/browser_tools_util_execution_api.js";
+import { BrowserToolsScreenshotMultiApi } from "./util/browser_tools_screenshot_multi_api.js";
 
 /**
  * Обертка над axios
@@ -141,22 +143,24 @@ export class Api
 
 		//echo({payload});
 
-		this.team_management   = new TeamManagementApi(payload);
-		this.team_member       = new TeamMemberApi(payload);
-		this.test_plan         = new TestPlanApi(payload);
-		this.project           = new ProjectApi(payload);
-		this.service           = new ServiceApi(payload);
-		this.test_case         = new TestCaseApi(payload);
-		this.test_case_step    = new TestCaseStepApi(payload);
-		this.test_suite        = new TestSuiteApi(payload);
-		this.test_run          = new TestRunApi(payload);
-		this.test_run_result   = new TestRunResultApi(payload);
-		this.user_profile      = new UserProfileApi(payload);
-		this.task              = new TaskApi(payload);
-		this.test_account      = new TestAccountApi(payload);
-		this.bug               = new BugApi(payload);
-		this.bug_relation      = new BugRelationApi(payload);
-		this.execution_context = new ExecutionContextApi(payload);
+		this.team_management              = new TeamManagementApi(payload);
+		this.team_member                  = new TeamMemberApi(payload);
+		this.test_plan                    = new TestPlanApi(payload);
+		this.project                      = new ProjectApi(payload);
+		this.service                      = new ServiceApi(payload);
+		this.test_case                    = new TestCaseApi(payload);
+		this.test_case_step               = new TestCaseStepApi(payload);
+		this.test_suite                   = new TestSuiteApi(payload);
+		this.test_run                     = new TestRunApi(payload);
+		this.test_run_result              = new TestRunResultApi(payload);
+		this.user_profile                 = new UserProfileApi(payload);
+		this.task                         = new TaskApi(payload);
+		this.test_account                 = new TestAccountApi(payload);
+		this.bug                          = new BugApi(payload);
+		this.bug_relation                 = new BugRelationApi(payload);
+		this.execution_context            = new ExecutionContextApi(payload);
+		this.browser_tools_util_execution  = new BrowserToolsUtilExecutionApi(payload);
+		this.browser_tools_screenshot_multi = new BrowserToolsScreenshotMultiApi(payload);
 
 		this.reference = this.bootstrap_reference(payload)
 	}

package/publish/api/util/browser_tools_screenshot_multi_api.js

@@ -0,0 +1,52 @@
+import { ApiAbstractElementClass } from "../api_abstract_element_class.js";
+import { typeUtilExecutionScreenshotMulti } from "../../types/family_utils/typeUtilExecutionScreenshotMulti.js";
+import { typeUtilExecution } from "../../types/family_utils/typeUtilExecution.js";
+
+
+/**
+ * Browser Tools — screenshot.multi util execution (create / details).
+ *
+ * Base path: /web_api/util/browser_tools/util_executions/screenshot.multi
+ *
+ * @version			v.2.0 (26/06/2026)
+ */
+export class BrowserToolsScreenshotMultiApi extends ApiAbstractElementClass
+{
+	module_prefix = 'util/browser_tools/util_executions/screenshot.multi';
+
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeUtilExecutionScreenshotMulti);
+	}
+
+
+	/**
+	 * GET details/{util_execution_id}?project_id=
+	 *
+	 * @param {object} payload
+	 *
+	 * @returns {Promise<{payload, response: ReturnType<typeof typeUtilExecution.composeDetails>|false}>}
+	 */
+	async details(payload)
+	{
+		let util_execution_id = payload?.util_execution_id;
+
+		if (!util_execution_id)
+		{
+			throw new Error('util_execution_id is required for details');
+		}
+
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/details/${ util_execution_id }`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response, false);
+
+		return {
+			response: typeUtilExecution.composeDetails(response),
+			payload : payload,
+		};
+	}
+}

package/publish/api/util/browser_tools_util_execution_api.js

@@ -0,0 +1,79 @@
+import { ApiAbstractElementClass } from "../api_abstract_element_class.js";
+import { is_array } from "../../utils/utils.js";
+import { typeUtilExecution } from "../../types/family_utils/typeUtilExecution.js";
+
+
+/**
+ * Browser Tools — util execution lifecycle (listing, status, delete).
+ *
+ * Base path: /web_api/util/browser_tools/util_executions
+ *
+ * @version			v.2.0 (26/06/2026)
+ */
+export class BrowserToolsUtilExecutionApi extends ApiAbstractElementClass
+{
+	module_prefix = 'util/browser_tools/util_executions';
+
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeUtilExecution);
+	}
+
+
+	/**
+	 * GET listing?project_id=
+	 *
+	 * @param {object} payload
+	 *
+	 * @returns {Promise<{payload, response: object}>}
+	 */
+	async listing(payload)
+	{
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/listing`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response, false);
+
+		if (response?.items && is_array(response.items))
+		{
+			response.items = response.items.map((row) => new typeUtilExecution(row));
+		}
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+
+
+	/**
+	 * GET status/{util_execution_id}?project_id=
+	 *
+	 * @param {object} payload
+	 *
+	 * @returns {Promise<{payload, response: typeUtilExecution}>}
+	 */
+	async status(payload)
+	{
+		let util_execution_id = payload?.util_execution_id;
+
+		if (!util_execution_id)
+		{
+			throw new Error('util_execution_id is required for status');
+		}
+
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/status/${ util_execution_id }`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response, false);
+
+		return {
+			response: new typeUtilExecution(response),
+			payload : payload,
+		};
+	}
+}

package/publish/app_configuration/table/sections/util_execution.js

@@ -0,0 +1,42 @@
+import { typeUtilExecution } from '../../../types/family_utils/typeUtilExecution.js';
+import { UserService } from '../../../services/UserService.js';
+import { createColumn, createGoToColumn, createPrimaryKeyColumn, createRowSelectColumn } from '../helpers/column_factory.js';
+import { createListingFor, registerSection } from '../helpers/section_registry.js';
+
+function build_util_execution_listing_columns(locale, { include_select = true } = {})
+{
+	const model = new typeUtilExecution();
+	const columns = [];
+
+	if (include_select)
+	{
+		columns.push(createRowSelectColumn());
+	}
+
+	columns.push(createPrimaryKeyColumn(model, locale, { is_editable: false }));
+	columns.push(createColumn(model, locale, 'execution_status', { width: '150', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'page_url', { width: '360', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'screenshot_count', { width: '120', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'user_id', { width: '180', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'created_at', { width: '170', is_editable: false, is_required: true }));
+	columns.push(createColumn(model, locale, 'completed_at', { width: '170', is_editable: false, is_required: true }));
+	columns.push(createGoToColumn(model, locale));
+
+	return columns;
+}
+
+
+/**
+ * Секции `util_execution`: `listing`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
+export function bootstrap_util_execution(config)
+{
+	const locale = UserService.get_current_language();
+
+	registerSection(config, 'util_execution', 'listing', build_util_execution_listing_columns(locale), {
+		for: createListingFor([ 'project_id' ]),
+	});
+}

package/publish/app_configuration/table/table_configuration.js

@@ -7,6 +7,7 @@ import { bootstrap_test_run } from './sections/test_run.js';
 import { bootstrap_test_run_result } from './sections/test_run_result.js';
 import { bootstrap_test_account } from './sections/test_account.js';
 import { bootstrap_execution_context } from './sections/execution_context.js';
+import { bootstrap_util_execution } from './sections/util_execution.js';
 import { bootstrap_team_member } from './sections/team_member.js';
 import { bootstrap_user } from './sections/user.js';
 import { bootstrap_team } from './sections/team.js';
@@ -114,6 +115,7 @@ export class TableConfiguration extends abstractAppConfiguration
 		bootstrap_test_run_result(this.config);
 		bootstrap_test_account(this.config);
 		bootstrap_execution_context(this.config);
+		bootstrap_util_execution(this.config);
 		bootstrap_team_member(this.config);
 		bootstrap_user(this.config);
 		bootstrap_team(this.config);

package/publish/index.js

@@ -28,6 +28,14 @@ export { typeLocaleContext } from './types/family_context/typeLocaleContext.js';
 export { typeDeploymentTargetContext } from './types/family_context/typeDeploymentTargetContext.js';
 export { typeExecutionContext } from './types/family_context/typeExecutionContext.js';
 
+export { familyUtil } from './types/family_utils/familyUtil.js';
+export { typeUtilExecution } from './types/family_utils/typeUtilExecution.js';
+export { typeUtilExecutionScreenshotMulti } from './types/family_utils/typeUtilExecutionScreenshotMulti.js';
+export { typeUtilExecutionScreenshotMultiCapture } from './types/family_utils/typeUtilExecutionScreenshotMultiCapture.js';
+export { typeUtilExecutionScreenshotMultiScreenshot } from './types/family_utils/typeUtilExecutionScreenshotMultiScreenshot.js';
+export { typeUtilExecutionScreenshotMultiCaptureError } from './types/family_utils/typeUtilExecutionScreenshotMultiCaptureError.js';
+export { typeUtilExecutionEvent } from './types/family_utils/typeUtilExecutionEvent.js';
+
 export { typeUser } from './types/family_elements/typeUser.js';
 export { typeTeam } from './types/family_elements/typeTeam.js';
 export { typeTeamMember } from './types/family_elements/typeTeamMember.js';

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

@@ -0,0 +1,68 @@
+/**
+ * Общие переводы для family_utils.
+ */
+export const familyUtil_i18n = {
+	execution_status: {
+		en: {
+			pending      : 'Pending',
+			submit_failed: 'Submit failed',
+			queued       : 'Queued',
+			completed    : 'Completed',
+			failed       : 'Failed',
+		},
+		ru: {
+			pending      : 'Ожидание',
+			submit_failed: 'Ошибка отправки',
+			queued       : 'В очереди',
+			completed    : 'Завершено',
+			failed       : 'Ошибка',
+		},
+	},
+
+	event_type: {
+		en: {
+			pending          : 'Pending',
+			submit_failed    : 'Submit failed',
+			queued           : 'Queued',
+			completed        : 'Completed',
+			failed           : 'Failed',
+			callback_received: 'Callback received',
+			deleted          : 'Deleted',
+		},
+		ru: {
+			pending          : 'Ожидание',
+			submit_failed    : 'Ошибка отправки',
+			queued           : 'В очереди',
+			completed        : 'Завершено',
+			failed           : 'Ошибка',
+			callback_received: 'Получен callback',
+			deleted          : 'Удалено',
+		},
+	},
+
+	capture_matrix_preset: {
+		en: {
+			default: 'Default matrix',
+			custom : 'Custom matrix',
+		},
+		ru: {
+			default: 'Матрица по умолчанию',
+			custom : 'Своя матрица',
+		},
+	},
+
+	wait_until: {
+		en: {
+			load            : 'Load',
+			domcontentloaded: 'DOM content loaded',
+			networkidle     : 'Network idle',
+			commit          : 'Commit',
+		},
+		ru: {
+			load            : 'Load',
+			domcontentloaded: 'DOM content loaded',
+			networkidle     : 'Network idle',
+			commit          : 'Commit',
+		},
+	},
+};

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

@@ -0,0 +1,53 @@
+import { familyUtil_i18n } from './_familyUtil.i18n.js';
+
+/**
+ * Переводы для typeUtilExecution.
+ *
+ * @see typeUtilExecution
+ */
+export const typeUtilExecution_i18n = {
+	attribute_name_translate_matrix: {
+		en: {
+			util_execution_id : 'ID',
+			util_action_id    : 'Action ID',
+			util_action_key   : 'Action',
+			team_id           : 'Team',
+			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',
+			page_url          : 'Page URL',
+			screenshot_count  : 'Screenshots',
+			captures_total    : 'Captures total',
+			captures_succeeded: 'Captures succeeded',
+			captures_failed   : 'Captures failed',
+		},
+		ru: {
+			util_execution_id : 'ID',
+			util_action_id    : 'ID действия',
+			util_action_key   : 'Действие',
+			team_id           : 'Команда',
+			project_id        : 'Проект',
+			user_id           : 'Пользователь',
+			execution_status  : 'Статус',
+			external_job_id   : 'Внешняя задача',
+			error_message     : 'Ошибка',
+			submitted_at      : 'Отправлено',
+			completed_at      : 'Завершено',
+			created_at        : 'Создано',
+			page_url          : 'URL страницы',
+			screenshot_count  : 'Скриншоты',
+			captures_total    : 'Всего захватов',
+			captures_succeeded: 'Успешных захватов',
+			captures_failed   : 'Ошибок захвата',
+		},
+	},
+
+	enum_value_translate_matrix: {
+		execution_status: familyUtil_i18n.execution_status,
+	},
+};

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

@@ -0,0 +1,43 @@
+import { familyUtil_i18n } from './_familyUtil.i18n.js';
+
+/**
+ * Переводы для typeUtilExecutionScreenshotMulti.
+ *
+ * @see typeUtilExecutionScreenshotMulti
+ */
+export const typeUtilExecutionScreenshotMulti_i18n = {
+	attribute_name_translate_matrix: {
+		en: {
+			util_execution_id              : 'Execution',
+			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              : 'Запуск',
+			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,
+	},
+};

package/publish/types/family_utils/familyUtil.js

@@ -0,0 +1,43 @@
+import { familyGeneralElement } from "../core/0_familyGeneralElement.js";
+
+
+/**
+ * Базовый класс для Util Service layer (typed executions).
+ *
+ * @see docs/Utils Layer/browser-tools-util-execution-docs.MD
+ *
+ * @version			v.1.0 (24/06/2026)
+ */
+export class familyUtil extends familyGeneralElement
+{
+	/**
+	 * @returns {string[]}
+	 */
+	static get_execution_status_values()
+	{
+		return [
+			'pending',
+			'submit_failed',
+			'queued',
+			'completed',
+			'failed',
+		];
+	}
+
+
+	/**
+	 * @returns {string[]}
+	 */
+	static get_event_type_values()
+	{
+		return [
+			'pending',
+			'submit_failed',
+			'queued',
+			'completed',
+			'failed',
+			'callback_received',
+			'deleted',
+		];
+	}
+}

package/publish/types/family_utils/typeUtilExecution.js

@@ -0,0 +1,148 @@
+import { familyUtil } from "./familyUtil.js";
+import { is_object } from "../../utils/utils.js";
+import { typeUtilExecution_i18n } from "../element_translate/typeUtilExecution.i18n.js";
+import { typeUtilExecutionScreenshotMulti } from "./typeUtilExecutionScreenshotMulti.js";
+import { typeUtilExecutionScreenshotMultiCapture } from "./typeUtilExecutionScreenshotMultiCapture.js";
+import { typeUtilExecutionScreenshotMultiScreenshot } from "./typeUtilExecutionScreenshotMultiScreenshot.js";
+import { typeUtilExecutionScreenshotMultiCaptureError } from "./typeUtilExecutionScreenshotMultiCaptureError.js";
+import { typeUtilExecutionEvent } from "./typeUtilExecutionEvent.js";
+
+
+/**
+ * Корневая сущность util execution (lifecycle, listing, status, delete).
+ *
+ * Create / action payload — через typeUtilExecutionScreenshotMulti.
+ *
+ * @see docs/Utils Layer/browser-tools-util-execution-docs.MD
+ *
+ * @version			v.2.0 (26/06/2026)
+ */
+export class typeUtilExecution extends familyUtil
+{
+	util_execution_id;
+	util_action_id;
+	util_action_key;
+	team_id;
+	project_id;
+	user_id;
+
+	execution_status;
+	external_job_id;
+	error_message;
+
+	submitted_at;
+	completed_at;
+	created_at;
+
+	/** Поля listing (денормализация screenshot.multi) */
+	page_url;
+	screenshot_count;
+
+	/** Поля status (счётчики из screenshot_multi) */
+	captures_total;
+	captures_succeeded;
+	captures_failed;
+
+	primary_key = 'util_execution_id';
+	api_key     = 'browser_tools_util_execution';
+
+	structure_scheme = {
+		util_execution_id : 'integer | require',
+		util_action_id    : 'integer | optional',
+		util_action_key   : 'string | max:120 | optional',
+		team_id           : 'integer | optional',
+		project_id        : 'integer | require',
+		user_id           : 'integer | optional',
+		execution_status  : 'string | enum | require',
+		external_job_id   : 'string | max:120 | optional',
+		error_message     : 'string | optional',
+		submitted_at      : 'timestamp | optional',
+		completed_at      : 'timestamp | optional',
+		created_at        : 'timestamp | optional',
+		page_url          : 'string | max:2048 | optional',
+		screenshot_count  : 'integer | optional',
+		captures_total    : 'integer | optional',
+		captures_succeeded: 'integer | optional',
+		captures_failed   : 'integer | optional',
+	};
+
+	available_enum_values = {
+		execution_status: familyUtil.get_execution_status_values(),
+	};
+
+	enum_value_translate_matrix = typeUtilExecution_i18n.enum_value_translate_matrix;
+
+	attribute_name_translate_matrix = typeUtilExecution_i18n.attribute_name_translate_matrix;
+
+	status_color = {
+		pending      : '#4D92FA',
+		submit_failed: '#E66565',
+		queued       : '#009688',
+		completed    : '#009688',
+		failed       : '#E66565',
+	};
+
+
+	/**
+	 * @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;
+	}
+
+
+	/**
+	 * Compose lifecycle root + screenshot.multi payload (GET details wire).
+	 *
+	 * @param {object|false|undefined} data
+	 *
+	 * @returns {{
+	 *   execution: typeUtilExecution,
+	 *   screenshot_multi: typeUtilExecutionScreenshotMulti|null,
+	 *   captures: typeUtilExecutionScreenshotMultiCapture[],
+	 *   screenshots: typeUtilExecutionScreenshotMultiScreenshot[],
+	 *   capture_errors: typeUtilExecutionScreenshotMultiCaptureError[],
+	 *   events: typeUtilExecutionEvent[],
+	 * }|false}
+	 */
+	static composeDetails(data)
+	{
+		if (!data || !is_object(data))
+		{
+			return false;
+		}
+
+		return {
+			execution       : new typeUtilExecution(data),
+			screenshot_multi: data.screenshot_multi && is_object(data.screenshot_multi)
+				? new typeUtilExecutionScreenshotMulti(data.screenshot_multi)
+				: null,
+			captures        : Array.isArray(data.captures)
+				? data.captures.map((row) => new typeUtilExecutionScreenshotMultiCapture(row))
+				: [],
+			screenshots     : Array.isArray(data.screenshots)
+				? data.screenshots.map((row) => new typeUtilExecutionScreenshotMultiScreenshot(row))
+				: [],
+			capture_errors  : Array.isArray(data.capture_errors)
+				? data.capture_errors.map((row) => new typeUtilExecutionScreenshotMultiCaptureError(row))
+				: [],
+			events          : Array.isArray(data.events)
+				? data.events.map((row) => new typeUtilExecutionEvent(row))
+				: [],
+		};
+	}
+}

package/publish/types/family_utils/typeUtilExecutionEvent.js

@@ -0,0 +1,56 @@
+import { familyUtil } from "./familyUtil.js";
+import { is_object } from "../../utils/utils.js";
+import { familyUtil_i18n } from "../element_translate/_familyUtil.i18n.js";
+
+
+/**
+ * Событие аудита util execution.
+ *
+ * @version			v.1.0 (24/06/2026)
+ */
+export class typeUtilExecutionEvent extends familyUtil
+{
+	util_execution_event_id;
+	util_execution_id;
+	event_type;
+	created_at;
+
+	primary_key = 'util_execution_event_id';
+
+	structure_scheme = {
+		util_execution_event_id: 'integer | optional',
+		util_execution_id      : 'integer | optional',
+		event_type             : 'string | enum | require',
+		created_at             : 'timestamp | optional',
+	};
+
+	available_enum_values = {
+		event_type: familyUtil.get_event_type_values(),
+	};
+
+	enum_value_translate_matrix = {
+		event_type: familyUtil_i18n.event_type,
+	};
+
+
+	/**
+	 * @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;
+	}
+}

package/publish/types/family_utils/typeUtilExecutionScreenshotMulti.js

@@ -0,0 +1,121 @@
+import { familyUtil } from "./familyUtil.js";
+import { is_object } from "../../utils/utils.js";
+import { typeUtilExecutionScreenshotMulti_i18n } from "../element_translate/typeUtilExecutionScreenshotMulti.i18n.js";
+import { typeUtilExecutionScreenshotMultiCapture } from "./typeUtilExecutionScreenshotMultiCapture.js";
+
+
+/**
+ * Action screenshot.multi — entry point для create и typed payload (1:1 к util_execution).
+ *
+ * @version			v.2.0 (26/06/2026)
+ */
+export class typeUtilExecutionScreenshotMulti extends familyUtil
+{
+	static UTIL_ACTION_ID  = 1;
+	static UTIL_ACTION_KEY = 'screenshot.multi';
+
+	util_execution_id;
+	page_url;
+	wait_until;
+	full_page;
+	navigation_timeout_milliseconds;
+	capture_matrix_preset;
+	last_callback_status;
+	captures_total;
+	captures_succeeded;
+	captures_failed;
+	duration_milliseconds;
+
+	/** Input matrix rows (create custom / details) */
+	captures;
+
+	primary_key = 'util_execution_id';
+	api_key     = 'browser_tools_screenshot_multi';
+
+	structure_scheme = {
+		util_execution_id              : 'integer | optional',
+		page_url                       : 'string | max:2048 | require',
+		wait_until                     : 'string | enum | optional',
+		full_page                      : 'integer | optional',
+		navigation_timeout_milliseconds: 'integer | optional',
+		capture_matrix_preset          : 'string | enum | require',
+		last_callback_status           : 'string | enum | optional',
+		captures_total                 : 'integer | optional',
+		captures_succeeded             : 'integer | optional',
+		captures_failed                : 'integer | optional',
+		duration_milliseconds          : 'integer | optional',
+	};
+
+	create_scheme = [
+		'util_action_id',
+		'project_id',
+		'page_url',
+		'capture_matrix_preset',
+		'captures',
+		'wait_until',
+		'full_page',
+		'navigation_timeout_milliseconds',
+	];
+
+	available_enum_values = {
+		capture_matrix_preset: [ 'default', 'custom' ],
+		wait_until           : [ 'load', 'domcontentloaded', 'networkidle', 'commit' ],
+		last_callback_status : [ 'completed', 'failed' ],
+	};
+
+	enum_value_translate_matrix = typeUtilExecutionScreenshotMulti_i18n.enum_value_translate_matrix;
+
+	attribute_name_translate_matrix = typeUtilExecutionScreenshotMulti_i18n.attribute_name_translate_matrix;
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (key === 'captures' && Array.isArray(value))
+				{
+					this.captures = value.map((row) => new typeUtilExecutionScreenshotMultiCapture(row));
+				}
+				else if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+
+	/**
+	 * @param {object} payload
+	 *
+	 * @returns {object}
+	 */
+	static withDefaultActionId(payload = {})
+	{
+		return {
+			util_action_id: typeUtilExecutionScreenshotMulti.UTIL_ACTION_ID,
+			...payload,
+		};
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @param {Function|false} [callback]
+	 *
+	 * @returns {Promise<*>}
+	 */
+	async create(payload, callback = false)
+	{
+		return super.create(typeUtilExecutionScreenshotMulti.withDefaultActionId(payload), callback);
+	}
+}

package/publish/types/family_utils/typeUtilExecutionScreenshotMultiCapture.js

@@ -0,0 +1,57 @@
+import { familyUtil } from "./familyUtil.js";
+import { is_object } from "../../utils/utils.js";
+import { register_type_class } from "../core/type_class_resolver.js";
+
+
+/**
+ * Строка пользовательской матрицы захвата (browser + resolution).
+ *
+ * @version			v.1.0 (24/06/2026)
+ */
+export class typeUtilExecutionScreenshotMultiCapture extends familyUtil
+{
+	util_execution_screenshot_multi_capture_id;
+	util_execution_id;
+	sort_order;
+	browser_context_id;
+	screen_resolution_context_id;
+
+	primary_key = 'util_execution_screenshot_multi_capture_id';
+
+	structure_scheme = {
+		util_execution_screenshot_multi_capture_id: 'integer | optional',
+		util_execution_id                       : 'integer | optional',
+		sort_order                              : 'integer | optional',
+		browser_context_id                      : 'integer | typeBrowserContext | require',
+		screen_resolution_context_id            : 'integer | typeScreenResolutionContext | require',
+	};
+
+	create_scheme = [
+		'browser_context_id',
+		'screen_resolution_context_id',
+	];
+
+
+	/**
+	 * @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;
+	}
+}
+
+register_type_class('typeUtilExecutionScreenshotMultiCapture', typeUtilExecutionScreenshotMultiCapture);

package/publish/types/family_utils/typeUtilExecutionScreenshotMultiCaptureError.js

@@ -0,0 +1,49 @@
+import { familyUtil } from "./familyUtil.js";
+import { is_object } from "../../utils/utils.js";
+
+
+/**
+ * Частичная ошибка захвата screenshot.multi.
+ *
+ * @version			v.1.0 (24/06/2026)
+ */
+export class typeUtilExecutionScreenshotMultiCaptureError extends familyUtil
+{
+	util_execution_screenshot_multi_capture_error_id;
+	util_execution_id;
+	capture_identifier;
+	error_message;
+	sort_order;
+
+	primary_key = 'util_execution_screenshot_multi_capture_error_id';
+
+	structure_scheme = {
+		util_execution_screenshot_multi_capture_error_id: 'integer | optional',
+		util_execution_id                             : 'integer | optional',
+		capture_identifier                            : 'string | max:255 | optional',
+		error_message                                 : 'string | require',
+		sort_order                                    : 'integer | optional',
+	};
+
+
+	/**
+	 * @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;
+	}
+}

package/publish/types/family_utils/typeUtilExecutionScreenshotMultiScreenshot.js

@@ -0,0 +1,57 @@
+import { familyUtil } from "./familyUtil.js";
+import { is_object } from "../../utils/utils.js";
+
+
+/**
+ * Результирующий скриншот screenshot.multi.
+ *
+ * @version			v.1.0 (24/06/2026)
+ */
+export class typeUtilExecutionScreenshotMultiScreenshot extends familyUtil
+{
+	util_execution_screenshot_multi_screenshot_id;
+	util_execution_id;
+	capture_identifier;
+	file_uuid;
+	image_url;
+	width;
+	height;
+	duration_milliseconds;
+	sort_order;
+
+	primary_key = 'util_execution_screenshot_multi_screenshot_id';
+
+	structure_scheme = {
+		util_execution_screenshot_multi_screenshot_id: 'integer | optional',
+		util_execution_id                          : 'integer | optional',
+		capture_identifier                         : 'string | max:255 | require',
+		file_uuid                                  : 'string | max:64 | optional',
+		image_url                                  : 'string | max:2048 | optional',
+		width                                      : 'integer | optional',
+		height                                     : 'integer | optional',
+		duration_milliseconds                      : 'integer | optional',
+		sort_order                                 : 'integer | optional',
+	};
+
+
+	/**
+	 * @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;
+	}
+}