complexqa_frontend_core 1.31.6 → 2.0.1

package/publish/app_configuration/menu_configuration_secondary.js

@@ -1,140 +0,0 @@
-import { abstractAppConfiguration } from "./abstract_app_configuration.js";
-import { UserService } from "../services/UserService.js";
-import { typeMenuElement } from "../types/family_service/typeMenuElement.js";
-
-/**
- * Дополнительное меню (нижнее)
- *
- * @version			v.0.1 (19/08/2025)
- */
-export class MenuConfigurationSecondary extends abstractAppConfiguration
-{
-	static config = {};
-
-	static state = {
-		loaded: false
-	}
-
-
-
-	/**
-	 *
-	 * @param init_options
-	 */
-	constructor(init_options = false)
-	{
-		super();
-		if (this.constructor._instance)
-		{
-			return this.constructor._instance;
-		}
-
-		this.init_options = init_options;
-
-		this.constructor._instance = this;
-
-		MenuConfigurationSecondary.bootstrap();
-	}
-
-
-
-
-	/**
-	 * Не понятно пока как лучше организовать
-	 * @version			v.0.1 (17/08/2025)
-	 */
-	static bootstrap()
-	{
-		if (this.state.loaded)
-		{
-			return;
-		}
-
-		this.bootstrap_menu();
-
-		this.state.loaded = true;
-	}
-
-	static bootstrap_menu()
-	{
-		this.config.menu_elements = this.bootstrap_menu_elements();
-	}
-
-
-	/**
-	 *
-	 * @returns {boolean|*}
-	 */
-	static get_config()
-	{
-		if (!this.state.loaded)
-		{
-			this.bootstrap();
-		}
-
-		return this.config;
-	}
-
-
-	/**
-	 *
-	 * @version			v.0.1 (19/08/2025)
-	 * @returns {[typeMenuElement]}
-	 */
-	static bootstrap_menu_elements()
-	{
-		let locale = UserService.get_current_language();
-
-		// @todo - use serviceTranslate
-
-		let response = [];
-
-		response.push(new typeMenuElement({
-			link      : `/web/${ locale }/user_profile`,
-			text      : 'User Settings',
-			icon      : '?',
-			sort_order: 1,
-		}));
-
-		let lang_sub_menu = [];
-
-		lang_sub_menu.push(new typeMenuElement({
-			link      : `/web/en`, // @todo - get current routing and replace $lang
-			text      : `EN`,
-			icon      : '?',
-			sort_order: 1,
-			reload: true,
-		}));
-
-		lang_sub_menu.push(new typeMenuElement({
-			link      : `/web/ru`, // @todo - get current routing and replace $lang
-			text      : `RU`,
-			icon      : '?',
-			sort_order: 2,
-			reload: true,
-		}));
-
-		response.push(new typeMenuElement({
-			link      : false,
-			text      : `Language ${ locale }`,
-			icon      : '?',
-			sort_order: 2,
-			sub_menu : lang_sub_menu
-		}));
-
-		response.push(new typeMenuElement({
-			link      : `/web/${ locale }/team_management/team/listing`,
-			text      : 'Teams',
-			icon      : '?',
-			sort_order: 3,
-		}));
-
-		/*
-			feedback
-			docs
-			admins
-		*/
-
-		return response;
-	}
-}

package/publish/app_configuration/table/helpers/column_factory.js

@@ -1,172 +0,0 @@
-import { typeTableColumn } from '../../../types/family_service/typeTableColumn.js';
-
-/**
- * Значения по умолчанию для data-колонок.
- * @type {Partial<import('../../../types/family_service/typeTableColumn.js').typeTableColumn>}
- */
-const COLUMN_DEFAULTS = {
-	width       : '120',
-	sort_order  : '2',
-	cell_classes: '',
-	default_sort: '',
-	is_sortable : true,
-	is_filter   : true,
-	is_hide     : false,
-	is_editable : false,
-	column_kind : 'data',
-	is_required : false,
-	is_title    : false,
-	header_element_type: false,
-};
-
-/**
- * @typedef {Object} ColumnOverrides
- * @property {string} [header_field] Атрибут для перевода заголовка (по умолчанию = `field`).
- * @property {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} [header_model]
- *   Модель перевода при bootstrap (по умолчанию = `model`). Итоговый заголовок — в `get_config(lang)`.
- * @property {string} [header_name] Явный заголовок; обычно не нужен — достаточно `header_field`.
- * @property {string|false} [header_element_type] Ключ модели перевода, если ≠ element_type секции.
- * @property {string|number} [width]
- * @property {string|number} [sort_order]
- * @property {boolean} [is_sortable]
- * @property {boolean} [is_filter]
- * @property {boolean} [is_hide]
- * @property {boolean} [is_editable]
- * @property {boolean} [is_required]
- * @property {boolean} [is_title]
- * @property {''|'asc'|'desc'} [default_sort]
- * @property {string} [cell_classes]
- */
-
-
-/**
- * Data-колонка с переводимым заголовком и сохранённым `header_field`.
- * Если `field` совпадает с `model.get_primary_key()`, `is_editable` всегда `false`.
- *
- * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
- *   Модель сущности секции.
- * @param {string} locale Локаль bootstrap (для первичного `header_name`; актуальная — в `get_config`).
- * @param {string} field Поле строки (`test_case_status`, `user_id.first_name`, …).
- * @param {ColumnOverrides} [overrides={}]
- * @returns {typeTableColumn}
- *
- * @example
- * createColumn(model, locale, 'test_case_id.test_case_title', {
- *   header_field: 'test_case_title',
- *   header_element_type: 'test_case',
- *   width: '480',
- * });
- */
-export function createColumn(model, locale, field, overrides = {})
-{
-	const header_field = overrides.header_field || field;
-	const header_model = overrides.header_model || model;
-	const primary_key = typeof model.get_primary_key === 'function'
-		? model.get_primary_key()
-		: null;
-
-	return new typeTableColumn({
-		...COLUMN_DEFAULTS,
-		header_field,
-		header_name: overrides.header_name ?? header_model.get_attribute_name_translate(header_field, locale),
-		field,
-		...overrides,
-		...(primary_key && field === primary_key ? { is_editable: false } : {}),
-	});
-}
-
-
-/**
- * Колонка множественного выбора строк (`column_kind: row_select`).
- * Без `header_field` — не локализуется.
- * `sort_order: 0` — всегда первая. В web_app: pinned left, чекбоксы.
- *
- * @param {Partial<typeTableColumn>} [overrides={}]
- * @returns {typeTableColumn}
- */
-export function createRowSelectColumn(overrides = {})
-{
-	return new typeTableColumn({
-		...COLUMN_DEFAULTS,
-		header_name : '',
-		field       : 'select',
-		width       : '60',
-		sort_order  : '0',
-		is_sortable : false,
-		is_filter   : false,
-		column_kind : 'row_select',
-		...overrides,
-	});
-}
-
-
-/**
- * Колонка перехода к деталям (`column_kind: goto`).
- * Заголовок в UI — через `translateGoToHeader` в web_app, не через ядро.
- * `sort_order: 1` — вторая после `row_select` (data-колонки по умолчанию `2`).
- * В web_app: pinned left, как чекбокс.
- *
- * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
- * @param {string} locale Не используется; сохранён для единообразия API фабрик.
- * @param {ColumnOverrides} [overrides={}]
- * @returns {typeTableColumn}
- */
-export function createGoToColumn(model, locale, overrides = {})
-{
-	const primary_key = model.get_primary_key();
-
-	return new typeTableColumn({
-		...COLUMN_DEFAULTS,
-		header_name : 'goto',
-		field       : primary_key,
-		width       : '40',
-		sort_order  : '1',
-		is_sortable : false,
-		is_filter   : false,
-		column_kind : 'goto',
-		...overrides,
-	});
-}
-
-
-/**
- * Колонка primary key (часто скрытая в listing, видимая в todo).
- * `is_editable` всегда `false`: идентификатор строки нельзя менять с фронта.
- *
- * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
- * @param {string} locale
- * @param {ColumnOverrides} [overrides={}]
- * @returns {typeTableColumn}
- */
-export function createPrimaryKeyColumn(model, locale, overrides = {})
-{
-	const primary_key = model.get_primary_key();
-
-	return createColumn(model, locale, primary_key, {
-		width       : '60',
-		default_sort: 'desc',
-		is_hide     : false,
-		...overrides,
-		is_editable : false,
-	});
-}
-
-
-/**
- * Колонка для таблиц details: без сортировки и фильтра ag-grid.
- *
- * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
- * @param {string} locale
- * @param {string} field
- * @param {ColumnOverrides} [overrides={}]
- * @returns {typeTableColumn}
- */
-export function createDetailsColumn(model, locale, field, overrides = {})
-{
-	return createColumn(model, locale, field, {
-		sort_order  : String(overrides.sort_order ?? 1),
-		is_sortable : false,
-		is_filter   : false,
-		...overrides,
-	});
-}

package/publish/app_configuration/table/helpers/column_locale.js

@@ -1,76 +0,0 @@
-import { typeTableColumn } from '../../../types/family_service/typeTableColumn.js';
-import { typeTableConfiguration } from '../../../types/family_service/typeTableConfiguration.js';
-import { TABLE_ELEMENT_MODELS } from './table_element_models.js';
-
-/**
- * Применяет локаль к заголовку одной data-колонки.
- *
- * Колонки без `header_field` (ручные, goto, row_select, copy) возвращаются без изменений.
- * Модель перевода: `TABLE_ELEMENT_MODELS[header_element_type || element_type]`.
- *
- * @param {typeTableColumn} column
- * @param {string} element_type Ключ сущности секции (`test_case`, `bug`, …).
- * @param {string} lang Код локали (`en`, `ru`, …).
- * @returns {typeTableColumn} Новый экземпляр с обновлённым `header_name` или исходная колонка.
- */
-export function localizeTableColumn(column, element_type, lang)
-{
-	if (column.column_kind !== 'data' || !column.header_field)
-	{
-		return column;
-	}
-
-	const model_key  = column.header_element_type || element_type;
-	const ModelClass = TABLE_ELEMENT_MODELS[ model_key ];
-
-	if (!ModelClass)
-	{
-		return column;
-	}
-
-	const model       = new ModelClass();
-	const header_name = model.get_attribute_name_translate(column.header_field, lang);
-
-	return new typeTableColumn({
-		header_name         : header_name,
-		field               : column.field,
-		width               : column.width,
-		sort_order          : column.sort_order,
-		cell_classes        : column.cell_classes,
-		default_sort        : column.default_sort,
-		is_sortable         : column.is_sortable,
-		is_filter           : column.is_filter,
-		is_hide             : column.is_hide,
-		is_editable         : column.is_editable,
-		column_kind         : column.column_kind,
-		is_required         : column.is_required,
-		is_title            : column.is_title,
-		header_element_type : column.header_element_type,
-		header_field        : column.header_field,
-	});
-}
-
-
-/**
- * Возвращает копию секции с локализованными заголовками всех data-колонок.
- *
- * Вызывается из `TableConfiguration.get_config` — не мутирует кеш bootstrap.
- *
- * @param {{ config: typeTableConfiguration }} section Зарегистрированная секция из `static.config`.
- * @param {string} element_type
- * @param {string} lang
- * @returns {{ config: typeTableConfiguration }}
- */
-export function localizeTableSection(section, element_type, lang)
-{
-	const config = section.config;
-
-	return {
-		config: new typeTableConfiguration({
-			columns                : config.columns.map((column) => localizeTableColumn(column, element_type, lang)),
-			for                    : config.for,
-			contained_element_type : config.contained_element_type,
-			documentation          : config.documentation,
-		}),
-	};
-}

package/publish/app_configuration/table/helpers/execution_context_listing_fields.js

@@ -1,25 +0,0 @@
-/**
- * Спецификация data-колонок execution_context × listing (без goto).
- * Единый источник для listing и вложенных таблиц (bug_relation.execution_contexts).
- *
- * @returns {Array<{ field: string, overrides: import('./column_factory.js').ColumnOverrides }>}
- */
-export function get_execution_context_listing_field_specs()
-{
-	return [
-		{ field: 'execution_context_id', overrides: { width: '60', default_sort: 'desc' } },
-		{ field: 'context_title', overrides: { width: '420', is_required: false, is_title: true } },
-		{ field: 'browser_context_id', overrides: { width: '200' } },
-		{ field: 'os_context_id', overrides: { width: '200' } },
-		{ field: 'screen_resolution_context_id', overrides: { width: '200' } },
-		{ field: 'device_context_id', overrides: { width: '200' } },
-		{ field: 'locale_context_id', overrides: { width: '200' } },
-		{ field: 'deployment_target_context_id', overrides: { width: '200' } },
-		{ field: 'user_agent_context_id', overrides: { width: '220' } },
-		{ field: 'protocol', overrides: { width: '120' } },
-		{ field: 'host', overrides: { width: '200' } },
-		{ field: 'base_url', overrides: { width: '250' } },
-		{ field: 'build_version', overrides: { width: '160' } },
-		{ field: 'created_at', overrides: { width: '170' } },
-	];
-}

package/publish/app_configuration/table/helpers/section_registry.js

@@ -1,81 +0,0 @@
-import { typeTableConfiguration } from '../../../types/family_service/typeTableConfiguration.js';
-import { typeFOR } from '../../../types/family_service/typeFOR.js';
-import { typeFilter } from '../../../types/family_service/typeFilter.js';
-
-/**
- * @typedef {Object} RegisterSectionOptions
- * @property {typeFOR|false} [for=false] Шаблон поиска для листинга.
- * @property {string|false} [contained_element_type=false] Контекст вложенной сущности.
- * @property {{ description: (string|false), link: (string|false) }} [documentation]
- */
-
-/**
- * Регистрирует секцию таблицы в реестре `TableConfiguration.config`.
- *
- * @param {Object<string, Object<string, { config: typeTableConfiguration }>>} config Ссылка на `TableConfiguration.config`.
- * @param {string} element_type Ключ сущности.
- * @param {string} section Имя секции (`listing`, `todo`, `details`, …).
- * @param {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]} columns
- * @param {RegisterSectionOptions} [options={}]
- * @returns {void}
- *
- * @example
- * registerSection(config, 'bug', 'listing', build_bug_listing_columns(locale), {
- *   for: createListingFor(['project_id']),
- * });
- */
-export function registerSection(config, element_type, section, columns, options = {})
-{
-	const payload = {
-		config: new typeTableConfiguration({
-			columns                : columns,
-			for                    : options.for || false,
-			contained_element_type   : options.contained_element_type || false,
-			documentation          : options.documentation || { description: false, link: false },
-		}),
-	};
-
-	if (!config[ element_type ])
-	{
-		config[ element_type ] = {};
-	}
-
-	config[ element_type ][ section ] = payload;
-}
-
-
-/**
- * Фильтр-заготовка для runtime-подстановки значения в web_app.
- *
- * @param {string} attribute Имя атрибута (`project_id`, `test_case_id`, …).
- * @returns {typeFilter} `operator: EQUAL`, `value: false` до гидратации.
- */
-export function createRuntimeFilter(attribute)
-{
-	return new typeFilter({
-		object  : { attribute },
-		operator: 'EQUAL',
-		value   : false,
-	});
-}
-
-
-/**
- * Строит шаблон `typeFOR` для листинговых таблиц.
- *
- * @param {string[]} [filter_attributes=['project_id']] Атрибуты, которые web_app заполнит из `filterValues`.
- * @param {Object<string, *>|false} [for_options=false] Доп. опции API (`add: ['users']` и т.д.).
- * @returns {typeFOR}
- *
- * @example
- * createListingFor(['project_id', 'test_case_id'], { add: ['users'] });
- */
-export function createListingFor(filter_attributes = [ 'project_id' ], for_options = false)
-{
-	const filters = filter_attributes.map((attribute) => createRuntimeFilter(attribute));
-
-	return new typeFOR({
-		filters,
-		options: for_options || false,
-	});
-}

package/publish/app_configuration/table/helpers/table_element_models.js

@@ -1,74 +0,0 @@
-import { typeTestCase } from '../../../types/family_elements/typeTestCase.js';
-import { typeProject } from '../../../types/family_elements/typeProject.js';
-import { typeTestRun } from '../../../types/family_elements/typeTestRun.js';
-import { typeBug } from '../../../types/family_elements/typeBug.js';
-import { typeBugRelation } from '../../../types/family_relation/typeBugRelation.js';
-import { typeTag } from '../../../types/family_elements/typeTag.js';
-import { typeCustomProperty } from '../../../types/family_elements/typeCustomProperty.js';
-import { typeAttachment } from '../../../types/family_elements/typeAttachment.js';
-import { typeTagRelation } from '../../../types/family_relation/typeTagRelation.js';
-import { typeCustomPropertyValue } from '../../../types/family_relation/typeCustomPropertyValue.js';
-import { typeTestRunResult } from '../../../types/family_elements/typeTestRunResult.js';
-import { typeTestAccount } from '../../../types/family_elements/typeTestAccount.js';
-import { typeExecutionContext } from '../../../types/family_context/typeExecutionContext.js';
-import { typeTeamMember } from '../../../types/family_elements/typeTeamMember.js';
-import { typeTeamDomain } from '../../../types/family_elements/typeTeamDomain.js';
-import { typeTestCaseStep } from '../../../types/family_elements/typeTestCaseStep.js';
-import { typeUser } from '../../../types/family_elements/typeUser.js';
-import { typeTeam } from '../../../types/family_elements/typeTeam.js';
-import { typeUtilExecutionScreenshotMulti } from '../../../types/family_utils/typeUtilExecutionScreenshotMulti.js';
-import { typeUtilExecutionUrlInspect } from '../../../types/family_utils/typeUtilExecutionUrlInspect.js';
-import { typeTextDocument } from '../../../types/family_files/typeTextDocument.js';
-import { typeEvent } from '../../../types/family_events/typeEvent.js';
-import { typeAutotestCase } from '../../../types/family_elements/typeAutotestCase.js';
-import { typeAutotestSuite } from '../../../types/family_elements/typeAutotestSuite.js';
-import { typeAutotestStep } from '../../../types/family_elements/typeAutotestStep.js';
-import { typeAutotestRun } from '../../../types/family_elements/typeAutotestRun.js';
-import { typeAutotestResult } from '../../../types/family_elements/typeAutotestResult.js';
-import { typeObjectRepositoryFolder } from '../../../types/family_elements/typeObjectRepositoryFolder.js';
-import { typeObjectRepositoryPage } from '../../../types/family_elements/typeObjectRepositoryPage.js';
-import { typeObjectRepositoryElement } from '../../../types/family_elements/typeObjectRepositoryElement.js';
-
-/**
- * Реестр классов моделей по ключу `element_type`.
- *
- * Используется для:
- * - `TableBaseConfig.getRowNodeId` — primary key строки;
- * - `localizeTableColumn` — `get_attribute_name_translate(header_field, lang)`.
- *
- * При добавлении новой таблицы сущности — зарегистрировать класс здесь.
- *
- * @type {Object<string, typeof import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement>}
- */
-export const TABLE_ELEMENT_MODELS = {
-	test_case      : typeTestCase,
-	project        : typeProject,
-	test_run       : typeTestRun,
-	bug            : typeBug,
-	bug_relation   : typeBugRelation,
-	attachment     : typeAttachment,
-	tag            : typeTag,
-	tag_relation   : typeTagRelation,
-	custom_property: typeCustomProperty,
-	custom_property_value: typeCustomPropertyValue,
-	test_run_result: typeTestRunResult,
-	test_account      : typeTestAccount,
-	execution_context : typeExecutionContext,
-	team_member       : typeTeamMember,
-	team_domain       : typeTeamDomain,
-	test_case_step : typeTestCaseStep,
-	user           : typeUser,
-	team           : typeTeam,
-	text_document  : typeTextDocument,
-	util_execution : typeUtilExecutionScreenshotMulti,
-	util_execution_url_inspect: typeUtilExecutionUrlInspect,
-	event          : typeEvent,
-	autotest_case  : typeAutotestCase,
-	autotest_suite : typeAutotestSuite,
-	autotest_step  : typeAutotestStep,
-	autotest_run   : typeAutotestRun,
-	autotest_result : typeAutotestResult,
-	object_repository_folder : typeObjectRepositoryFolder,
-	object_repository_page   : typeObjectRepositoryPage,
-	object_repository_element: typeObjectRepositoryElement,
-};

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

@@ -1,76 +0,0 @@
-import { typeAutotestCase } from '../../../types/family_elements/typeAutotestCase.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_autotest_case_listing_columns(locale, { include_select = true, include_goto = true, include_kind = false, kind_editable = false } = {})
-{
-	const model = new typeAutotestCase();
-	const columns = [];
-
-	if (include_select)
-	{
-		columns.push(createRowSelectColumn());
-	}
-
-	columns.push(createPrimaryKeyColumn(model, locale));
-	columns.push(createColumn(model, locale, 'autotest_case_title', {
-		width      : '480',
-		is_editable: true,
-		is_required: true,
-		is_title   : true,
-	}));
-	columns.push(createColumn(model, locale, 'autotest_case_status', {
-		width      : '150',
-		is_editable: true,
-		is_required: true,
-	}));
-	if (include_kind)
-	{
-		columns.push(createColumn(model, locale, 'autotest_case_kind', {
-			width      : '140',
-			is_editable: kind_editable,
-			is_required: true,
-		}));
-	}
-	columns.push(createColumn(model, locale, 'tags', {
-		width      : '220',
-		is_editable: false,
-		is_sortable: true,
-		is_required: false,
-	}));
-	columns.push(createColumn(model, locale, 'created_at', { width: '170', is_required: true }));
-	if (include_goto)
-	{
-		columns.push(createGoToColumn(model, locale));
-	}
-
-	return columns;
-}
-
-
-/**
- * Секции `autotest_case`: `listing`.
- *
- * @param {Object} config
- * @returns {void}
- */
-export function bootstrap_autotest_case(config)
-{
-	const locale = UserService.get_current_language();
-
-	registerSection(config, 'autotest_case', 'listing', build_autotest_case_listing_columns(locale, {
-		include_kind : true,
-		kind_editable: true,
-	}), {
-		for: createListingFor([ 'project_id', 'autotest_suite_id' ], { add: [ 'tags', 'pre_autotest_case_ids' ] }),
-	});
-
-	registerSection(config, 'autotest_case', 'picker', build_autotest_case_listing_columns(locale, {
-		include_goto: false,
-		include_kind: true,
-	}), {
-		for: createListingFor([ 'project_id' ]),
-	});
-}