complexqa_frontend_core 1.18.2 → 1.18.3

package/package.json

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

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

@@ -42,12 +42,12 @@ 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',

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);