complexqa_frontend_core 1.26.1 → 1.27.1

package/package.json

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

package/publish/api/custom_property/custom_property_template_api.js

@@ -0,0 +1,16 @@
+import { ApiAbstractReferenceClass } from '../api_abstract_reference_class.js';
+
+/**
+ * System custom property templates (read-only for tenants).
+ *
+ * @version			v.0.1 (15/08/2026)
+ */
+export class CustomPropertyTemplateApi extends ApiAbstractReferenceClass
+{
+	module_prefix = 'custom_property_template';
+
+	constructor(options)
+	{
+		super(options);
+	}
+}

package/publish/api/custom_property_api.js

@@ -0,0 +1,54 @@
+import { ApiAbstractElementClass } from './api_abstract_element_class.js';
+import { typeCustomProperty } from '../types/family_elements/typeCustomProperty.js';
+
+/**
+ * CRUD / Search / clone_from_templates for custom_property catalog.
+ * Create / update / delete / clone require ADMINISTRATOR on the server.
+ *
+ * @version			v.0.1 (15/08/2026)
+ */
+export class CustomPropertyApi extends ApiAbstractElementClass
+{
+	module_prefix = 'custom_property';
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeCustomProperty);
+	}
+
+
+	/**
+	 * Clone system templates into the team catalog for one element_type.
+	 * Server: ADMINISTRATOR only.
+	 *
+	 * @param {{ element_type: string, custom_property_template_ids: number[] }} payload
+	 * @returns {Promise<{response: *, payload: *}>}
+	 */
+	async clone_from_templates(payload)
+	{
+		if (!this.module_prefix)
+		{
+			throw new Error('Error #custom-property-clone-1152 in CustomPropertyApi');
+		}
+
+		if (this.stage === 'development')
+		{
+			return {
+				response: payload,
+				payload : payload,
+			};
+		}
+
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/clone_from_templates`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+}

package/publish/api/custom_property_option_api.js

@@ -0,0 +1,17 @@
+import { ApiAbstractElementClass } from './api_abstract_element_class.js';
+
+/**
+ * Options for DROPDOWN / MULTISELECT catalog slots.
+ * Mutations require ADMINISTRATOR on the server.
+ *
+ * @version			v.0.1 (15/08/2026)
+ */
+export class CustomPropertyOptionApi extends ApiAbstractElementClass
+{
+	module_prefix = 'custom_property_option';
+
+	constructor(options)
+	{
+		super(options);
+	}
+}

package/publish/api/custom_property_value_api.js

@@ -0,0 +1,82 @@
+import { ApiAbstractElementClass } from './api_abstract_element_class.js';
+import { typeCustomPropertyValue } from '../types/family_relation/typeCustomPropertyValue.js';
+
+/**
+ * Explicit value writers: set / add / delete. Not a union create().
+ * READONLY → api_code = -501. MEMBER and ADMINISTRATOR may write.
+ *
+ * @version			v.0.1 (15/08/2026)
+ */
+export class CustomPropertyValueApi extends ApiAbstractElementClass
+{
+	module_prefix = 'custom_property_value';
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeCustomPropertyValue);
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @returns {Promise<{response: *, payload: *}>}
+	 */
+	async set(payload)
+	{
+		return this.#process('set', payload);
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @returns {Promise<{response: *, payload: *}>}
+	 */
+	async add(payload)
+	{
+		return this.#process('add', payload);
+	}
+
+
+	/**
+	 * @param {object} payload
+	 * @returns {Promise<{response: *, payload: *}>}
+	 */
+	async delete(payload)
+	{
+		return this.#process('delete', payload);
+	}
+
+
+	/**
+	 * @param {string} action
+	 * @param {object} payload
+	 * @returns {Promise<{response: *, payload: *}>}
+	 */
+	async #process(action, payload)
+	{
+		if (!this.module_prefix)
+		{
+			throw new Error('Error #custom-property-value-1152 in CustomPropertyValueApi');
+		}
+
+		if (this.stage === 'development')
+		{
+			return {
+				response: payload,
+				payload : payload,
+			};
+		}
+
+		let url = `/${ this.api_prefix }/${ this.module_prefix }/${ action }`;
+
+		payload      = this.handle_request_payload(payload);
+		let response = this.api_request(url, payload);
+		response     = this.handle_response(response);
+
+		return {
+			response: response,
+			payload : payload,
+		};
+	}
+}

package/publish/api/index.js

@@ -16,8 +16,12 @@ import { BugRelationApi } from "./bug_relation_api.js";
 import { AttachmentApi } from "./attachment_api.js";
 import { TagApi } from "./tag_api.js";
 import { TagRelationApi } from "./tag_relation_api.js";
+import { CustomPropertyApi } from "./custom_property_api.js";
+import { CustomPropertyValueApi } from "./custom_property_value_api.js";
+import { CustomPropertyOptionApi } from "./custom_property_option_api.js";
 import { TagColorApi } from "./tag/tag_color_api.js";
 import { TagTemplateApi } from "./tag/tag_template_api.js";
+import { CustomPropertyTemplateApi } from "./custom_property/custom_property_template_api.js";
 import { ContextBrowserApi } from "./context/context_browser_api.js";
 import { ContextDeploymentTargetApi } from "./context/context_deployment_target_api.js";
 import { ContextDevicesApi } from "./context/context_devices_api.js";
@@ -176,6 +180,9 @@ export class Api
 		this.attachment                     = new AttachmentApi(payload);
 		this.tag                            = new TagApi(payload);
 		this.tag_relation                   = new TagRelationApi(payload);
+		this.custom_property                = new CustomPropertyApi(payload);
+		this.custom_property_value          = new CustomPropertyValueApi(payload);
+		this.custom_property_option         = new CustomPropertyOptionApi(payload);
 		this.event                          = new EventApi(payload);
 		this.execution_context              = new ExecutionContextApi(payload);
 		this.browser_tools_util_execution   = new BrowserToolsUtilExecutionApi(payload);
@@ -208,6 +215,7 @@ export class Api
 		response.context_screen_resolution = new ContextScreenResolutionApi(payload);
 		response.tag_color                 = new TagColorApi(payload);
 		response.tag_template              = new TagTemplateApi(payload);
+		response.custom_property_template  = new CustomPropertyTemplateApi(payload);
 
 		return response;
 	}

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

@@ -4,8 +4,10 @@ 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';
@@ -39,6 +41,8 @@ export const TABLE_ELEMENT_MODELS = {
 	attachment     : typeAttachment,
 	tag            : typeTag,
 	tag_relation   : typeTagRelation,
+	custom_property: typeCustomProperty,
+	custom_property_value: typeCustomPropertyValue,
 	test_run_result: typeTestRunResult,
 	test_account      : typeTestAccount,
 	execution_context : typeExecutionContext,

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

@@ -0,0 +1,96 @@
+import { typeCustomProperty } from '../../../types/family_elements/typeCustomProperty.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';
+import { typeTableColumn } from '../../../types/family_service/typeTableColumn.js';
+
+function build_custom_property_listing_columns(locale)
+{
+	const model = new typeCustomProperty();
+
+	return [
+		createRowSelectColumn(),
+		createPrimaryKeyColumn(model, locale),
+		createColumn(model, locale, 'name', {
+			width      : '240',
+			is_editable: true,
+			is_required: true,
+			is_title   : true,
+		}),
+		createColumn(model, locale, 'property_key', { width: '180' }),
+		createColumn(model, locale, 'element_type', { width: '140' }),
+		createColumn(model, locale, 'value_type', { width: '150' }),
+		createColumn(model, locale, 'cardinality', { width: '140', is_editable: true }),
+		createColumn(model, locale, 'is_enabled', { width: '110', is_editable: true }),
+		createColumn(model, locale, 'is_required', { width: '110', is_editable: true }),
+		createColumn(model, locale, 'is_searchable', { width: '120', is_editable: true }),
+		createColumn(model, locale, 'created_at', { width: '170' }),
+		createColumn(model, locale, 'updated_at', { width: '170' }),
+		createGoToColumn(model, locale),
+	];
+}
+
+
+function build_custom_property_details_columns(locale)
+{
+	const model  = new typeCustomProperty();
+	const fields = [
+		'custom_property_id',
+		'team_id',
+		'element_type',
+		'property_key',
+		'value_type',
+		'cardinality',
+		'name',
+		'is_required',
+		'is_enabled',
+		'is_searchable',
+		'sort_order',
+		'created_at',
+		'updated_at',
+	];
+
+	return [
+		...fields.map((field, index) => createColumn(model, locale, field, {
+			sort_order : String(index + 1),
+			is_editable: [ 'name', 'cardinality', 'is_required', 'is_enabled', 'is_searchable', 'sort_order' ].includes(field),
+			is_sortable: false,
+			is_filter  : false,
+		})),
+		new typeTableColumn({
+			header_name: 'copy',
+			field      : 'copy',
+			width      : '80',
+			sort_order : '99',
+			is_sortable: false,
+			is_filter  : false,
+			is_editable: false,
+			column_kind: 'copy',
+		}),
+	];
+}
+
+
+/**
+ * Секции `custom_property`: `listing`, `details`.
+ *
+ * @param {Object} config
+ * @returns {void}
+ */
+export function bootstrap_custom_property(config)
+{
+	const locale = UserService.get_current_language();
+
+	registerSection(config, 'custom_property', 'listing', build_custom_property_listing_columns(locale), {
+		for: createListingFor([], { add: [ 'options' ] }),
+	});
+
+	registerSection(config, 'custom_property', 'details', build_custom_property_details_columns(locale), {
+		for: createListingFor([ 'custom_property_id' ], { add: [ 'options' ] }),
+	});
+}

package/publish/app_configuration/table/table_configuration.js

@@ -3,6 +3,7 @@ import { bootstrap_bug } from './sections/bug.js';
 import { bootstrap_bug_relation } from './sections/bug_relation.js';
 import { bootstrap_tag } from './sections/tag.js';
 import { bootstrap_tag_relation } from './sections/tag_relation.js';
+import { bootstrap_custom_property } from './sections/custom_property.js';
 import { bootstrap_test_case } from './sections/test_case.js';
 import { bootstrap_test_case_step } from './sections/test_case_step.js';
 import { bootstrap_test_run } from './sections/test_run.js';
@@ -117,6 +118,7 @@ export class TableConfiguration extends abstractAppConfiguration
 		bootstrap_bug_relation(this.config);
 		bootstrap_tag(this.config);
 		bootstrap_tag_relation(this.config);
+		bootstrap_custom_property(this.config);
 		bootstrap_test_case(this.config);
 		bootstrap_test_case_step(this.config);
 		bootstrap_test_run(this.config);

package/publish/index.js

@@ -17,11 +17,13 @@ export { typeTestRunResult } from './types/family_elements/typeTestRunResult.js'
 export { typeTestAccount } from './types/family_elements/typeTestAccount.js'
 export {typeBug} from './types/family_elements/typeBug.js';
 export { typeTag } from './types/family_elements/typeTag.js';
+export { typeCustomProperty } from './types/family_elements/typeCustomProperty.js';
 export { typeAttachment } from './types/family_elements/typeAttachment.js';
 
 export { familyRelation } from './types/core/1_familyRelation.js';
 export { typeBugRelation } from './types/family_relation/typeBugRelation.js';
 export { typeTagRelation } from './types/family_relation/typeTagRelation.js';
+export { typeCustomPropertyValue } from './types/family_relation/typeCustomPropertyValue.js';
 
 export { familyContext } from './types/core/1_familyContext.js';
 export { typeBrowserContext } from './types/family_context/typeBrowserContext.js';

package/publish/services/UserService.js

@@ -44,6 +44,15 @@ export class UserService extends abstractService
 	static current_team_slug = false;
 
 
+	/**
+	 * member_role of the current user in current_team_id: ADMINISTRATOR | MEMBER | READONLY.
+	 * SPA bootstrap: auth/common_page.blade.php from team_members join in get_user_teams().
+	 *
+	 * @type {false|string}
+	 */
+	static current_member_role = false;
+
+
 	/**
 	 *
 	 * @type {false|array<typeTeam>}

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

@@ -16,6 +16,14 @@ export class familyTestDocumentation extends familyGeneralElement
 	 */
 	tags;
 
+	/**
+	 * Hydrated on element search via options.add: ['custom_properties'].
+	 * Catalog entities leave this unset.
+	 *
+	 * @type {Array<object>|undefined}
+	 */
+	custom_properties;
+
 
 	/**
 	 *

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

@@ -0,0 +1,85 @@
+/**
+ * Переводы для typeCustomProperty.
+ *
+ * @see typeCustomProperty
+ */
+export const typeCustomProperty_i18n = {
+	attribute_name_translate_matrix: {
+		en: {
+			custom_property_id: 'ID',
+			team_id           : 'Team',
+			element_type      : 'Element type',
+			property_key      : 'Key',
+			value_type        : 'Value type',
+			cardinality       : 'Cardinality',
+			name              : 'Name',
+			description       : 'Description',
+			is_required       : 'Required',
+			is_enabled        : 'Enabled',
+			is_searchable     : 'Searchable',
+			sort_order        : 'Sort order',
+			created_at        : 'Created',
+			updated_at        : 'Updated',
+		},
+		ru: {
+			custom_property_id: 'ID',
+			team_id           : 'Команда',
+			element_type      : 'Тип элемента',
+			property_key      : 'Ключ',
+			value_type        : 'Тип значения',
+			cardinality       : 'Кардинальность',
+			name              : 'Название',
+			description       : 'Описание',
+			is_required       : 'Обязательное',
+			is_enabled        : 'Включено',
+			is_searchable     : 'Искать',
+			sort_order        : 'Порядок',
+			created_at        : 'Создано',
+			updated_at        : 'Обновлено',
+		},
+	},
+	enum_value_translate_matrix: {
+		en: {
+			element_type: {
+				test_case: 'Test case',
+				bug      : 'Bug',
+			},
+			value_type: {
+				STRING     : 'String',
+				TEXT       : 'Text',
+				INTEGER    : 'Integer',
+				DATE       : 'Date',
+				URL        : 'URL',
+				USER       : 'User',
+				DROPDOWN   : 'Dropdown',
+				CHECKBOX   : 'Checkbox',
+				MULTISELECT: 'Multi-select',
+			},
+			cardinality: {
+				SINGLE  : 'Single',
+				MULTIPLE: 'Multiple',
+			},
+		},
+		ru: {
+			element_type: {
+				test_case: 'Тест-кейс',
+				bug      : 'Ошибка',
+			},
+			value_type: {
+				STRING     : 'Строка',
+				TEXT       : 'Текст',
+				INTEGER    : 'Целое',
+				DATE       : 'Дата',
+				URL        : 'URL',
+				USER       : 'Пользователь',
+				DROPDOWN   : 'Список',
+				CHECKBOX   : 'Флажок',
+				MULTISELECT: 'Множественный выбор',
+			},
+			cardinality: {
+				SINGLE  : 'Одно значение',
+				MULTIPLE: 'Несколько значений',
+			},
+		},
+	},
+};

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

@@ -0,0 +1,65 @@
+/**
+ * Переводы для typeCustomPropertyValue.
+ *
+ * @see typeCustomPropertyValue
+ */
+export const typeCustomPropertyValue_i18n = {
+	attribute_name_translate_matrix: {
+		en: {
+			custom_property_value_id: 'ID',
+			custom_property_id      : 'Custom property',
+			team_id                 : 'Team',
+			project_id              : 'Project',
+			element_type            : 'Element type',
+			element_id              : 'Element',
+			sort_order              : 'Sort order',
+			user_id                 : 'User',
+			created_at              : 'Created',
+			updated_at              : 'Updated',
+			string_value            : 'String',
+			text_value              : 'Text',
+			integer_value           : 'Integer',
+			date_value              : 'Date',
+			url                     : 'URL',
+			url_caption             : 'Caption',
+			user_id_value           : 'User',
+			checkbox_value          : 'Checked',
+			option_id               : 'Option',
+		},
+		ru: {
+			custom_property_value_id: 'ID',
+			custom_property_id      : 'Свойство',
+			team_id                 : 'Команда',
+			project_id              : 'Проект',
+			element_type            : 'Тип элемента',
+			element_id              : 'Элемент',
+			sort_order              : 'Порядок',
+			user_id                 : 'Пользователь',
+			created_at              : 'Создано',
+			updated_at              : 'Обновлено',
+			string_value            : 'Строка',
+			text_value              : 'Текст',
+			integer_value           : 'Целое',
+			date_value              : 'Дата',
+			url                     : 'URL',
+			url_caption             : 'Подпись',
+			user_id_value           : 'Пользователь',
+			checkbox_value          : 'Флажок',
+			option_id               : 'Опция',
+		},
+	},
+	enum_value_translate_matrix: {
+		en: {
+			element_type: {
+				test_case: 'Test case',
+				bug      : 'Bug',
+			},
+		},
+		ru: {
+			element_type: {
+				test_case: 'Тест-кейс',
+				bug      : 'Ошибка',
+			},
+		},
+	},
+};

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

@@ -16,6 +16,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Bugs',
 			bug_relation       : 'Bug relations',
 			tag                : 'Tags',
+			custom_property    : 'Custom properties',
 			execution_context  : 'Execution contexts',
 			task               : 'Tasks',
 			team_member        : 'Team members',
@@ -37,6 +38,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Баги',
 			bug_relation       : 'Связи багов',
 			tag                : 'Теги',
+			custom_property    : 'Пользовательские свойства',
 			execution_context  : 'Контексты выполнения',
 			task               : 'Задачи',
 			team_member        : 'Участники команды',
@@ -58,6 +60,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Fehler',
 			bug_relation       : 'Fehlerverknüpfung',
 			tag                : 'Tag',
+			custom_property    : 'Benutzerdefinierte Eigenschaften',
 			execution_context  : 'Ausführungskontext',
 			task               : 'Aufgabe',
 			team_member        : 'Teammitglied',
@@ -79,6 +82,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'خطأ',
 			bug_relation       : 'علاقة الخطأ',
 			tag                : 'وسم',
+			custom_property    : 'خصائص مخصصة',
 			execution_context  : 'سياق التنفيذ',
 			task               : 'مهمة',
 			team_member        : 'عضو الفريق',
@@ -100,6 +104,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Error',
 			bug_relation       : 'Relación de error',
 			tag                : 'Etiqueta',
+			custom_property    : 'Propiedades personalizadas',
 			execution_context  : 'Contexto de ejecución',
 			task               : 'Tarea',
 			team_member        : 'Miembro del equipo',
@@ -121,6 +126,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Bug',
 			bug_relation       : 'Relation de bug',
 			tag                : 'Tag',
+			custom_property    : 'Propriétés personnalisées',
 			execution_context  : 'Contexte d\'exécution',
 			task               : 'Tâche',
 			team_member        : 'Membre de l\'équipe',
@@ -142,6 +148,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Սխալ',
 			bug_relation       : 'Սխալի կապ',
 			tag                : 'Պիտակ',
+			custom_property    : 'Հատուկ հատկություններ',
 			execution_context  : 'Կատարման համատեքստ',
 			task               : 'Առաջադրանք',
 			team_member        : 'Թիմի անդամ',
@@ -163,6 +170,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Bug',
 			bug_relation       : 'Relazione bug',
 			tag                : 'Tag',
+			custom_property    : 'Proprietà personalizzate',
 			execution_context  : 'Contesto di esecuzione',
 			task               : 'Attività',
 			team_member        : 'Membro del team',
@@ -184,6 +192,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Błąd',
 			bug_relation       : 'Powiązanie błędu',
 			tag                : 'Tag',
+			custom_property    : 'Właściwości niestandardowe',
 			execution_context  : 'Kontekst wykonania',
 			task               : 'Zadanie',
 			team_member        : 'Członek zespołu',
@@ -205,6 +214,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Bug',
 			bug_relation       : 'Relação de bug',
 			tag                : 'Tag',
+			custom_property    : 'Propriedades personalizadas',
 			execution_context  : 'Contexto de execução',
 			task               : 'Tarefa',
 			team_member        : 'Membro da equipa',
@@ -226,6 +236,7 @@ export const typeTeamTotalStatistic_i18n = {
 			bug                : 'Хата',
 			bug_relation       : 'Хата бәйләнеше',
 			tag                : 'Тег',
+			custom_property    : 'Кулланучы үзлекләре',
 			execution_context  : 'Башкару контексты',
 			task               : 'Бурыч',
 			team_member        : 'Команд әгъзасы',

package/publish/types/family_elements/typeCustomProperty.js

@@ -0,0 +1,138 @@
+import { familyTestDocumentation } from "../core/1_familyTestDocumentation.js";
+import { is_object } from "../../utils/utils.js";
+import _ from 'underscore';
+import { typeCustomProperty_i18n } from "../element_translate/typeCustomProperty.i18n.js";
+
+/**
+ * Team-scoped custom property catalog slot for one element_type (test_case | bug).
+ * Server CUD requires member_role = ADMINISTRATOR. Do not set clone_element = false (listing CM).
+ *
+ * @see docs/CustomProperties/custom-property-docs.MD
+ *
+ * @version			v.0.1 (15/08/2026)
+ */
+export class typeCustomProperty extends familyTestDocumentation
+{
+	custom_property_id;
+	team_id;
+	element_type;
+	property_key;
+	value_type;
+	cardinality;
+	name;
+	description;
+	is_required;
+	is_enabled;
+	is_searchable;
+	sort_order;
+	created_at;
+	updated_at;
+
+	/** Hydrated via search options.add: ['options'] */
+	options;
+
+	primary_key = 'custom_property_id';
+	api_key     = 'custom_property';
+
+	structure_scheme = {
+		custom_property_id: 'integer | require',
+		team_id           : 'integer | require',
+		element_type      : 'string | enum | require',
+		property_key      : 'string | require',
+		value_type        : 'string | enum | require',
+		cardinality       : 'string | enum | require',
+		name              : 'string | require',
+		description       : 'string | optional',
+		is_required       : 'integer | optional',
+		is_enabled        : 'integer | optional',
+		is_searchable     : 'integer | optional',
+		sort_order        : 'integer | optional',
+		created_at        : 'timestamp | optional',
+		updated_at        : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'element_type',
+		'property_key',
+		'value_type',
+		'name',
+		'cardinality',
+		'description',
+		'is_required',
+		'is_enabled',
+		'is_searchable',
+		'sort_order',
+	];
+
+	available_enum_values = {
+		element_type: typeCustomProperty.get_element_type_values(),
+		value_type  : typeCustomProperty.get_value_type_values(),
+		cardinality : typeCustomProperty.get_cardinality_values(),
+	};
+
+	enum_value_translate_matrix = typeCustomProperty_i18n.enum_value_translate_matrix;
+
+	attribute_name_translate_matrix = typeCustomProperty_i18n.attribute_name_translate_matrix;
+
+
+	static get_element_type_values()
+	{
+		return [ 'test_case', 'bug' ];
+	}
+
+
+	static get_value_type_values()
+	{
+		return [
+			'STRING',
+			'TEXT',
+			'INTEGER',
+			'DATE',
+			'URL',
+			'USER',
+			'DROPDOWN',
+			'CHECKBOX',
+			'MULTISELECT',
+		];
+	}
+
+
+	static get_cardinality_values()
+	{
+		return [ 'SINGLE', 'MULTIPLE' ];
+	}
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 * @returns {typeCustomProperty}
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this[ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+
+	get_element_name()
+	{
+		if (this.name)
+		{
+			return String(this.name);
+		}
+
+		return String(this.property_key ?? this.custom_property_id ?? '');
+	}
+}

package/publish/types/family_events/familyEvent.js

@@ -40,6 +40,7 @@ export class familyEvent extends familyGeneralElement
 
 	/**
 	 * Каталог subject_type (= api_key), совпадает с seed event-service.
+	 * `custom_property` — CUD слота каталога; значения на хосте публикуются как test_case/bug UPDATE.
 	 *
 	 * @returns {string[]}
 	 */
@@ -61,6 +62,7 @@ export class familyEvent extends familyGeneralElement
 			'attachment',
 			'tag',
 			'tag_relation',
+			'custom_property',
 			'test_account',
 			'user_profile',
 			'text_document',

package/publish/types/family_relation/typeCustomPropertyValue.js

@@ -0,0 +1,117 @@
+import { is_object } from '../../utils/utils.js';
+import _ from 'underscore';
+import { familyRelation } from '../core/1_familyRelation.js';
+import { typeCustomPropertyValue_i18n } from '../element_translate/typeCustomPropertyValue.i18n.js';
+
+/**
+ * One typed value row on a host element (test_case | bug).
+ * Mutations go through CustomPropertyValueApi.set / add / delete, not union create().
+ * Server rejects member_role = READONLY (api_code = -501). MEMBER may write.
+ *
+ * @see docs/CustomProperties/custom-property-docs.MD
+ *
+ * @version			v.0.1 (15/08/2026)
+ */
+export class typeCustomPropertyValue extends familyRelation
+{
+	custom_property_value_id;
+	custom_property_id;
+	team_id;
+	project_id;
+	element_type;
+	element_id;
+	sort_order;
+	user_id;
+	created_at;
+	updated_at;
+
+	string_value;
+	text_value;
+	integer_value;
+	date_value;
+	url;
+	url_caption;
+	user_id_value;
+	checkbox_value;
+	option_id;
+
+	source_key        = 'custom_property_id';
+	target_key        = 'element_id';
+	relation_type_key = 'element_type';
+
+	primary_key = 'custom_property_value_id';
+	api_key     = 'custom_property_value';
+
+	static relation_target_map = {
+		test_case: { type_token: 'typeTestCase', primary_key: 'test_case_id', api_key: 'test_case' },
+		bug      : { type_token: 'typeBug', primary_key: 'bug_id', api_key: 'bug' },
+	};
+
+	structure_scheme = {
+		custom_property_value_id: 'integer | require',
+		custom_property_id      : 'integer | typeCustomProperty | require',
+		team_id                 : 'integer | require',
+		project_id              : 'integer | require',
+		element_type            : 'string | enum | require',
+		element_id              : 'integer | require',
+		sort_order              : 'integer | optional',
+		user_id                 : 'integer | optional',
+		created_at              : 'timestamp | optional',
+		updated_at              : 'timestamp | optional',
+	};
+
+	create_scheme = [
+		'custom_property_id',
+		'element_type',
+		'element_id',
+	];
+
+	available_enum_values = {
+		element_type: typeCustomPropertyValue.get_relation_type_values(),
+	};
+
+	enum_value_translate_matrix = typeCustomPropertyValue_i18n.enum_value_translate_matrix;
+
+	attribute_name_translate_matrix = typeCustomPropertyValue_i18n.attribute_name_translate_matrix;
+
+
+	static get_relation_type_values()
+	{
+		return Object.keys(typeCustomPropertyValue.relation_target_map);
+	}
+
+
+	static get_relation_target_map()
+	{
+		return typeCustomPropertyValue.relation_target_map;
+	}
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 * @returns {typeCustomPropertyValue}
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this[ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+
+	get_relation_target_meta()
+	{
+		return typeCustomPropertyValue.resolve_relation_target(this.element_type);
+	}
+}