complexqa_frontend_core 1.18.1 → 1.18.3

package/package.json

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

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

@@ -10,7 +10,6 @@ const FK_FIELDS = [
 	'device_context_id',
 	'locale_context_id',
 	'deployment_target_context_id',
-	'test_account_id',
 ];
 
 function build_execution_context_listing_columns(locale)
@@ -43,8 +42,6 @@ function build_execution_context_details_columns(locale)
 		'host',
 		'base_url',
 		'build_version',
-		'context_snapshot',
-		'custom_field_values',
 		'created_at',
 		'updated_at',
 	];

package/publish/types/core/0_familyGeneralElement.js

@@ -1,4 +1,5 @@
 import { clone_object, echo, in_array, is_array } from "../../utils/utils.js";
+import { is_type_class_token, resolve_type_class } from "./type_class_resolver.js";
 
 /**
  * Базовый абстрактный класс для всех типов
@@ -156,6 +157,72 @@ export class familyGeneralElement
 	}
 
 
+	/**
+	 * Токен целевого типа для FK/reference-атрибута (`typeBrowserContext`, …).
+	 *
+	 * @param {string} attribute
+	 * @returns {string|false}
+	 */
+	get_attribute_reference_type_token(attribute)
+	{
+		const scheme = this.get_attribute_structure_scheme(attribute);
+
+		if (!scheme)
+		{
+			return false;
+		}
+
+		for (const rule of scheme)
+		{
+			if (!is_type_class_token(rule))
+			{
+				continue;
+			}
+
+			const TypeClass = resolve_type_class(rule);
+			const probe     = new TypeClass();
+
+			if (typeof probe.get_reference_meta === 'function')
+			{
+				return rule;
+			}
+		}
+
+		return false;
+	}
+
+
+	/**
+	 * @param {string} attribute
+	 * @returns {boolean}
+	 */
+	is_reference_attribute(attribute)
+	{
+		return Boolean(this.get_attribute_reference_type_token(attribute));
+	}
+
+
+	/**
+	 * Метаданные reference из целевого типа (api, primary_key, search, scope_filters).
+	 *
+	 * @param {string} attribute
+	 * @returns {object|false}
+	 */
+	get_attribute_reference_meta(attribute)
+	{
+		const token = this.get_attribute_reference_type_token(attribute);
+
+		if (!token)
+		{
+			return false;
+		}
+
+		const TypeClass = resolve_type_class(token);
+
+		return new TypeClass().get_reference_meta();
+	}
+
+
 	/**
 	 *
 	 * @version			v.0.1 (26/05/2024)

package/publish/types/core/1_familyContext.js

@@ -31,6 +31,23 @@ export class familyContext extends familyGeneralElement
 	 */
 	context_axis = false;
 
+	/** @type {'reference'} */
+	static reference_api_namespace = 'reference';
+
+	static reference_label_key = 'context_name';
+
+	static reference_search = {
+		attribute: 'context_name',
+		operator : 'LIKE',
+	};
+
+	static reference_scope_filters = [ 'project_id' ];
+
+	reference_api_namespace = familyContext.reference_api_namespace;
+	reference_label_key     = familyContext.reference_label_key;
+	reference_search        = familyContext.reference_search;
+	reference_scope_filters = familyContext.reference_scope_filters;
+
 	available_enum_values = familyContext.get_base_available_enum_values();
 
 	enum_value_translate_matrix = familyContext.get_base_enum_value_translate_matrix();
@@ -78,6 +95,39 @@ export class familyContext extends familyGeneralElement
 	}
 
 
+	/**
+	 * Метаданные для live search / выбора записи справочника как FK.
+	 *
+	 * @returns {object|false}
+	 */
+	get_reference_meta()
+	{
+		if (!this.reference_api_key)
+		{
+			return false;
+		}
+
+		return {
+			type_token    : this.constructor.name,
+			api_namespace : this.reference_api_namespace,
+			api_key       : this.reference_api_key,
+			primary_key   : this.primary_key,
+			label_key     : this.reference_label_key,
+			search        : { ...this.reference_search },
+			scope_filters : [ ...this.reference_scope_filters ],
+		};
+	}
+
+
+	/**
+	 * @returns {string}
+	 */
+	get_element_name()
+	{
+		return this.context_name || String(this?.[ this.primary_key ] ?? '');
+	}
+
+
 	/**
 	 * Общие поля записи справочника (добавляются в structure_scheme наследников).
 	 *

package/publish/types/core/type_class_resolver.js

@@ -0,0 +1,38 @@
+/**
+ * Реестр токен → класс. Заполняется из файлов типов через register_type_class().
+ * Метаданные reference живут в классе; здесь только резолв имени.
+ *
+ * @type {Object<string, typeof import('./0_familyGeneralElement.js').familyGeneralElement>}
+ */
+export const TYPE_CLASS_MAP = {};
+
+
+/**
+ * @param {string} token
+ * @param {typeof import('./0_familyGeneralElement.js').familyGeneralElement} TypeClass
+ * @returns {void}
+ */
+export function register_type_class(token, TypeClass)
+{
+	TYPE_CLASS_MAP[ token ] = TypeClass;
+}
+
+
+/**
+ * @param {string} token
+ * @returns {typeof import('./0_familyGeneralElement.js').familyGeneralElement|false}
+ */
+export function resolve_type_class(token)
+{
+	return TYPE_CLASS_MAP?.[ token ] || false;
+}
+
+
+/**
+ * @param {string} rule
+ * @returns {boolean}
+ */
+export function is_type_class_token(rule)
+{
+	return typeof rule === 'string' && rule.startsWith('type') && Boolean(TYPE_CLASS_MAP?.[ rule ]);
+}

package/publish/types/family_context/typeBrowserContext.js

@@ -1,5 +1,6 @@
 import { familyContext } from "../core/1_familyContext.js";
 import { is_object } from "../../utils/utils.js";
+import { register_type_class } from "../core/type_class_resolver.js";
 
 
 /**
@@ -19,6 +20,7 @@ export class typeBrowserContext extends familyContext
 
 	primary_key = 'browser_context_id';
 	api_key     = 'browser_context';
+	reference_api_key = 'context_browser';
 
 	structure_scheme = {
 		browser_context_id: 'integer | require',
@@ -57,3 +59,5 @@ export class typeBrowserContext extends familyContext
 		return this;
 	}
 }
+
+register_type_class('typeBrowserContext', typeBrowserContext);

package/publish/types/family_context/typeDeploymentTargetContext.js

@@ -1,5 +1,6 @@
 import { familyContext } from "../core/1_familyContext.js";
 import { is_object } from "../../utils/utils.js";
+import { register_type_class } from "../core/type_class_resolver.js";
 
 
 /**
@@ -19,6 +20,7 @@ export class typeDeploymentTargetContext extends familyContext
 
 	primary_key = 'deployment_target_context_id';
 	api_key     = 'deployment_target_context';
+	reference_api_key = 'context_deployment_target';
 
 	structure_scheme = {
 		deployment_target_context_id: 'integer | require',
@@ -96,3 +98,5 @@ export class typeDeploymentTargetContext extends familyContext
 		return this;
 	}
 }
+
+register_type_class('typeDeploymentTargetContext', typeDeploymentTargetContext);

package/publish/types/family_context/typeDeviceContext.js

@@ -1,5 +1,6 @@
 import { familyContext } from "../core/1_familyContext.js";
 import { is_object } from "../../utils/utils.js";
+import { register_type_class } from "../core/type_class_resolver.js";
 
 
 /**
@@ -19,6 +20,7 @@ export class typeDeviceContext extends familyContext
 
 	primary_key = 'device_context_id';
 	api_key     = 'device_context';
+	reference_api_key = 'context_devices';
 
 	structure_scheme = {
 		device_context_id: 'integer | require',
@@ -84,3 +86,5 @@ export class typeDeviceContext extends familyContext
 		return this;
 	}
 }
+
+register_type_class('typeDeviceContext', typeDeviceContext);

package/publish/types/family_context/typeExecutionContext.js

@@ -5,8 +5,7 @@ import { is_object } from "../../utils/utils.js";
 /**
  * Снимок окружения на момент события (баг, результат прогона, автотест).
  *
- * Ссылается на справочники familyContext по FK; context_snapshot — замороженная
- * копия для истории (если справочник переименуют). host/base_url — проектный URL.
+ * Ссылается на справочники familyContext по FK. host/base_url — проектный URL.
  *
  * @version			v.0.1 (03/06/2026)
  */
@@ -31,10 +30,6 @@ export class typeExecutionContext extends familyGeneralElement
 	base_url;
 	build_version;
 
-	context_snapshot;
-	custom_field_values;
-	test_account_id;
-
 	created_at;
 	updated_at;
 
@@ -47,19 +42,16 @@ export class typeExecutionContext extends familyGeneralElement
 		team_id                     : 'integer | require',
 		context_title               : 'string | optional',
 		context_description         : 'string | StringHtml | optional',
-		browser_context_id          : 'integer | optional',
-		os_context_id               : 'integer | optional',
-		screen_resolution_context_id: 'integer | optional',
-		device_context_id           : 'integer | optional',
-		locale_context_id           : 'integer | optional',
-		deployment_target_context_id: 'integer | optional',
+		browser_context_id          : 'integer | typeBrowserContext | optional',
+		os_context_id               : 'integer | typeOsContext | optional',
+		screen_resolution_context_id: 'integer | typeScreenResolutionContext | optional',
+		device_context_id           : 'integer | typeDeviceContext | optional',
+		locale_context_id           : 'integer | typeLocaleContext | optional',
+		deployment_target_context_id: 'integer | typeDeploymentTargetContext | optional',
 		protocol                    : 'string | enum | optional',
 		host                        : 'string | max:255 | optional',
 		base_url                    : 'string | max:2048 | optional',
 		build_version               : 'string | max:128 | optional',
-		context_snapshot            : 'object | optional',
-		custom_field_values         : 'object | optional',
-		test_account_id             : 'integer | optional',
 		created_at                  : 'timestamp | require',
 		updated_at                  : 'timestamp | optional',
 	};
@@ -103,9 +95,6 @@ export class typeExecutionContext extends familyGeneralElement
 			host                        : 'Host',
 			base_url                    : 'Base URL',
 			build_version               : 'Build version',
-			context_snapshot            : 'Context snapshot',
-			custom_field_values         : 'Custom fields',
-			test_account_id             : 'Test account',
 			created_at                  : 'Created at',
 			updated_at                  : 'Updated at',
 		},
@@ -125,9 +114,6 @@ export class typeExecutionContext extends familyGeneralElement
 			host                        : 'Хост',
 			base_url                    : 'Базовый URL',
 			build_version               : 'Версия сборки',
-			context_snapshot            : 'Снимок контекста',
-			custom_field_values         : 'Доп. поля',
-			test_account_id             : 'Тестовый аккаунт',
 			created_at                  : 'Создано',
 			updated_at                  : 'Обновлено',
 		},

package/publish/types/family_context/typeLocaleContext.js

@@ -1,5 +1,6 @@
 import { familyContext } from "../core/1_familyContext.js";
 import { is_object } from "../../utils/utils.js";
+import { register_type_class } from "../core/type_class_resolver.js";
 
 
 /**
@@ -21,6 +22,7 @@ export class typeLocaleContext extends familyContext
 
 	primary_key = 'locale_context_id';
 	api_key     = 'locale_context';
+	reference_api_key = 'context_locale';
 
 	structure_scheme = {
 		locale_context_id: 'integer | require',
@@ -73,3 +75,5 @@ export class typeLocaleContext extends familyContext
 		return this;
 	}
 }
+
+register_type_class('typeLocaleContext', typeLocaleContext);

package/publish/types/family_context/typeOsContext.js

@@ -1,5 +1,6 @@
 import { familyContext } from "../core/1_familyContext.js";
 import { is_object } from "../../utils/utils.js";
+import { register_type_class } from "../core/type_class_resolver.js";
 
 
 /**
@@ -19,6 +20,7 @@ export class typeOsContext extends familyContext
 
 	primary_key = 'os_context_id';
 	api_key     = 'os_context';
+	reference_api_key = 'context_os';
 
 	structure_scheme = {
 		os_context_id: 'integer | require',
@@ -84,3 +86,5 @@ export class typeOsContext extends familyContext
 		return this;
 	}
 }
+
+register_type_class('typeOsContext', typeOsContext);

package/publish/types/family_context/typeScreenResolutionContext.js

@@ -1,5 +1,6 @@
 import { familyContext } from "../core/1_familyContext.js";
 import { is_object } from "../../utils/utils.js";
+import { register_type_class } from "../core/type_class_resolver.js";
 
 
 /**
@@ -23,6 +24,7 @@ export class typeScreenResolutionContext extends familyContext
 
 	primary_key = 'screen_resolution_context_id';
 	api_key     = 'screen_resolution_context';
+	reference_api_key = 'context_screen_resolution';
 
 	structure_scheme = {
 		screen_resolution_context_id: 'integer | require',
@@ -97,3 +99,5 @@ export class typeScreenResolutionContext extends familyContext
 		return this;
 	}
 }
+
+register_type_class('typeScreenResolutionContext', typeScreenResolutionContext);