complexqa_frontend_core 1.23.1 → 1.25.1

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

@@ -0,0 +1,309 @@
+import { typeTagRelation } from '../../../types/family_relation/typeTagRelation.js';
+import { typeTestCase } from '../../../types/family_elements/typeTestCase.js';
+import { typeBug } from '../../../types/family_elements/typeBug.js';
+import { typeTestRun } from '../../../types/family_elements/typeTestRun.js';
+import { typeTestSuite } from '../../../types/family_elements/typeTestSuite.js';
+import { typeTestAccount } from '../../../types/family_elements/typeTestAccount.js';
+import { typeTestRunResult } from '../../../types/family_elements/typeTestRunResult.js';
+import { typeTextDocument } from '../../../types/family_files/typeTextDocument.js';
+import { typeExecutionContext } from '../../../types/family_context/typeExecutionContext.js';
+import { UserService } from '../../../services/UserService.js';
+import { createColumn, createGoToColumn } from '../helpers/column_factory.js';
+import { get_execution_context_listing_field_specs } from '../helpers/execution_context_listing_fields.js';
+import { createListingFor, registerSection } from '../helpers/section_registry.js';
+
+/**
+ * Nested column helper: `element_id.<field>` with header from target element type.
+ *
+ * @param {typeTagRelation} relation_model
+ * @param {string} locale
+ * @param {string} header_element_type
+ * @param {string} field
+ * @param {object} [overrides]
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn}
+ */
+function elementColumn(relation_model, locale, header_element_type, field, overrides = {})
+{
+	return createColumn(relation_model, locale, `element_id.${ field }`, {
+		header_field       : overrides.header_field || field,
+		header_element_type: overrides.header_element_type || header_element_type,
+		is_editable        : false,
+		...overrides,
+	});
+}
+
+
+/**
+ * Linked test cases on tag/details — same fields as test_case × listing (read-only).
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_tag_relation_test_cases_columns(locale)
+{
+	const relation_model  = new typeTagRelation();
+	const test_case_model = new typeTestCase();
+	const col             = (field, overrides = {}) =>
+		elementColumn(relation_model, locale, 'test_case', field, overrides);
+
+	return [
+		col('test_case_id', { width: '60', default_sort: 'desc' }),
+		col('test_case_title', { width: '480', is_required: true, is_title: true }),
+		col('assigned_to', { width: '220' }),
+		col('test_case_time_to_execute', { width: '80', is_required: true }),
+		col('test_case_complexity', { width: '80', is_required: true }),
+		col('test_case_importance', { width: '80', is_required: true }),
+		col('test_case_status', { width: '150', is_required: true }),
+		createGoToColumn(test_case_model, locale, { field: 'element_id' }),
+	];
+}
+
+
+/**
+ * Linked bugs on tag/details — same fields as bug × listing (read-only, without tags).
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_tag_relation_bugs_columns(locale)
+{
+	const relation_model = new typeTagRelation();
+	const bug_model      = new typeBug();
+	const col            = (field, overrides = {}) =>
+		elementColumn(relation_model, locale, 'bug', field, overrides);
+
+	return [
+		col('bug_id', { width: '60', default_sort: 'desc' }),
+		col('bug_title', { width: '420', is_required: true, is_title: true }),
+		col('bug_status', { width: '150', is_required: true }),
+		col('bug_priority', { width: '130', is_required: true }),
+		col('bug_severity', { width: '130', is_required: true }),
+		col('bug_type', { width: '150', is_required: true }),
+		col('bug_resolution', { width: '150', is_required: true, is_hide: true }),
+		col('assigned_to', { width: '220', is_required: true }),
+		col('created_at', { width: '170', is_required: true }),
+		col('completed_at', { width: '170', is_required: true, is_hide: true }),
+		createGoToColumn(bug_model, locale, { field: 'element_id' }),
+	];
+}
+
+
+/**
+ * Linked test runs on tag/details — same fields as test_run × listing (read-only, without tags).
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_tag_relation_test_runs_columns(locale)
+{
+	const relation_model = new typeTagRelation();
+	const test_run_model = new typeTestRun();
+	const col            = (field, overrides = {}) =>
+		elementColumn(relation_model, locale, 'test_run', field, overrides);
+
+	return [
+		col('test_run_id', { width: '60', default_sort: 'desc' }),
+		col('test_run_name', { width: '480', is_required: true, is_title: true }),
+		col('test_run_description', { width: '480', is_required: true }),
+		col('assigned_to', { width: '220', is_required: true }),
+		col('test_run_status', { width: '150', is_required: true }),
+		col('created_at', { width: '170', is_required: true }),
+		col('completed_at', { width: '170', is_required: true }),
+		createGoToColumn(test_run_model, locale, { field: 'element_id' }),
+	];
+}
+
+
+/**
+ * Linked test suites on tag/details.
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_tag_relation_test_suites_columns(locale)
+{
+	const relation_model   = new typeTagRelation();
+	const test_suite_model = new typeTestSuite();
+	const col              = (field, overrides = {}) =>
+		elementColumn(relation_model, locale, 'test_suite', field, overrides);
+
+	return [
+		col('test_suite_id', { width: '60', default_sort: 'desc' }),
+		col('test_suite_name', { width: '480', is_required: true, is_title: true }),
+		createGoToColumn(test_suite_model, locale, { field: 'element_id' }),
+	];
+}
+
+
+/**
+ * Linked test accounts on tag/details — same fields as test_account × listing (read-only, without tags).
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_tag_relation_test_accounts_columns(locale)
+{
+	const relation_model     = new typeTagRelation();
+	const test_account_model = new typeTestAccount();
+	const col                = (field, overrides = {}) =>
+		elementColumn(relation_model, locale, 'test_account', field, overrides);
+
+	return [
+		col('test_account_id', { width: '60', default_sort: 'desc' }),
+		col('resource', { width: '480', is_required: true, is_title: true }),
+		col('login', { width: '480', is_required: true }),
+		col('password', { width: '480' }),
+		col('test_account_description', { width: '480' }),
+		col('created_at', { width: '170' }),
+		col('updated_at', { width: '170' }),
+		createGoToColumn(test_account_model, locale, { field: 'element_id' }),
+	];
+}
+
+
+/**
+ * Linked test run results on tag/details — same fields as bug_relation × test_run_results.
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_tag_relation_test_run_results_columns(locale)
+{
+	const relation_model = new typeTagRelation();
+	const result_model   = new typeTestRunResult();
+	const col            = (field, overrides = {}) =>
+		elementColumn(relation_model, locale, 'test_run_result', field, overrides);
+
+	return [
+		col('test_run_result_id', { width: '60', default_sort: 'desc' }),
+		col('assigned_to', { width: '220', is_required: true }),
+		col('created_at', { width: '170', is_required: true }),
+		col('updated_at', { width: '170', is_required: true }),
+		col('completed_at', { width: '170', is_required: true }),
+		col('test_result_status', { width: '150', is_required: true }),
+		createGoToColumn(result_model, locale, { field: 'element_id' }),
+	];
+}
+
+
+/**
+ * Linked text documents on tag/details — same fields as text_document × listing (read-only, without tags).
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_tag_relation_text_documents_columns(locale)
+{
+	const relation_model      = new typeTagRelation();
+	const text_document_model = new typeTextDocument();
+	const col                 = (field, overrides = {}) =>
+		elementColumn(relation_model, locale, 'text_document', field, overrides);
+
+	return [
+		col('text_document_id', { width: '60', default_sort: 'desc' }),
+		col('text_document_title', { width: '320', is_title: true }),
+		col('text_document_status', { width: '140' }),
+		col('text_document_folder_id', { width: '120' }),
+		col('created_at', { width: '170' }),
+		col('updated_at', { width: '170' }),
+		createGoToColumn(text_document_model, locale, { field: 'element_id' }),
+	];
+}
+
+
+/**
+ * Linked execution contexts on tag/details.
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_tag_relation_execution_contexts_columns(locale)
+{
+	const relation_model = new typeTagRelation();
+	const context_model  = new typeExecutionContext();
+	const col            = (field, overrides = {}) =>
+		elementColumn(relation_model, locale, 'execution_context', field, overrides);
+
+	return [
+		...get_execution_context_listing_field_specs().map(({ field, overrides }) => col(field, overrides)),
+		createGoToColumn(context_model, locale, { field: 'element_id' }),
+	];
+}
+
+
+/**
+ * Tags attached to an element (hydrate tag_id).
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_element_tags_columns(locale)
+{
+	const relation_model = new typeTagRelation();
+	const columns        = [];
+
+	const tagColumn = (field, overrides = {}) => createColumn(relation_model, locale, `tag_id.${ field }`, {
+		header_field       : field,
+		header_element_type: 'tag',
+		is_editable        : false,
+		...overrides,
+	});
+
+	columns.push(tagColumn('tag_id', { width: '60', default_sort: 'desc' }));
+	columns.push(tagColumn('name', {
+		width      : '280',
+		is_required: true,
+		is_title   : true,
+	}));
+	columns.push(tagColumn('tag_color_id', { width: '120' }));
+
+	return columns;
+}
+
+
+/**
+ * Секции `tag_relation` для tag/details tabs и attach на элементах.
+ *
+ * @param {Object} config
+ * @returns {void}
+ */
+export function bootstrap_tag_relation(config)
+{
+	const locale = UserService.get_current_language();
+
+	registerSection(config, 'tag_relation', 'test_cases', build_tag_relation_test_cases_columns(locale), {
+		for: createListingFor([ 'tag_id', 'element_type' ], { add: [ 'elements' ] }),
+	});
+
+	registerSection(config, 'tag_relation', 'bugs', build_tag_relation_bugs_columns(locale), {
+		for: createListingFor([ 'tag_id', 'element_type' ], { add: [ 'elements' ] }),
+	});
+
+	registerSection(config, 'tag_relation', 'test_runs', build_tag_relation_test_runs_columns(locale), {
+		for: createListingFor([ 'tag_id', 'element_type' ], { add: [ 'elements' ] }),
+	});
+
+	registerSection(config, 'tag_relation', 'test_suites', build_tag_relation_test_suites_columns(locale), {
+		for: createListingFor([ 'tag_id', 'element_type' ], { add: [ 'elements' ] }),
+	});
+
+	registerSection(config, 'tag_relation', 'test_accounts', build_tag_relation_test_accounts_columns(locale), {
+		for: createListingFor([ 'tag_id', 'element_type' ], { add: [ 'elements' ] }),
+	});
+
+	registerSection(config, 'tag_relation', 'test_run_results', build_tag_relation_test_run_results_columns(locale), {
+		for: createListingFor([ 'tag_id', 'element_type' ], { add: [ 'elements' ] }),
+	});
+
+	registerSection(config, 'tag_relation', 'text_documents', build_tag_relation_text_documents_columns(locale), {
+		for: createListingFor([ 'tag_id', 'element_type' ], { add: [ 'elements' ] }),
+	});
+
+	registerSection(config, 'tag_relation', 'execution_contexts', build_tag_relation_execution_contexts_columns(locale), {
+		for: createListingFor([ 'tag_id', 'element_type' ], { add: [ 'elements' ] }),
+	});
+
+	registerSection(config, 'tag_relation', 'element_tags', build_element_tags_columns(locale), {
+		for: createListingFor([ 'element_type', 'element_id' ], { add: [ 'tags' ] }),
+	});
+}

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

@@ -12,6 +12,12 @@ function build_test_account_listing_columns(locale)
 		createPrimaryKeyColumn(model, locale),
 		createColumn(model, locale, 'resource', { width: '480', is_editable: true, is_required: true }),
 		createColumn(model, locale, 'login', { width: '480', is_editable: true, is_required: true }),
+		createColumn(model, locale, 'tags', {
+			width      : '220',
+			is_editable: false,
+			is_sortable: false,
+			is_required: false,
+		}),
 		createColumn(model, locale, 'password', { width: '480', is_editable: true }),
 		createColumn(model, locale, 'test_account_description', { width: '480', is_editable: true }),
 		createColumn(model, locale, 'created_at', { width: '170' }),
@@ -67,7 +73,7 @@ export function bootstrap_test_account(config)
 	const locale = UserService.get_current_language();
 
 	registerSection(config, 'test_account', 'listing', build_test_account_listing_columns(locale), {
-		for: createListingFor([ 'project_id' ]),
+		for: createListingFor([ 'project_id' ], { add: [ 'tags' ] }),
 	});
 
 	registerSection(config, 'test_account', 'details', build_test_account_details_columns(locale));

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

@@ -21,6 +21,12 @@ function build_test_case_listing_columns(locale, { include_select = true, includ
 		is_title    : true,
 	}));
 	columns.push(createColumn(model, locale, 'assigned_to', { width: '220', is_editable: true }));
+	columns.push(createColumn(model, locale, 'tags', {
+		width      : '220',
+		is_editable: false,
+		is_sortable: false,
+		is_required: false,
+	}));
 	columns.push(createColumn(model, locale, 'test_case_time_to_execute', { width: '80', is_editable: true, is_required: true }));
 	columns.push(createColumn(model, locale, 'test_case_complexity', { width: '80', is_editable: true, is_required: true }));
 	columns.push(createColumn(model, locale, 'test_case_importance', { width: '80', is_editable: true, is_required: true }));
@@ -59,7 +65,7 @@ export function bootstrap_test_case(config)
 	const locale = UserService.get_current_language();
 
 	registerSection(config, 'test_case', 'listing', build_test_case_listing_columns(locale), {
-		for: createListingFor([ 'project_id', 'test_suite_id' ]),
+		for: createListingFor([ 'project_id', 'test_suite_id' ], { add: [ 'tags' ] }),
 	});
 
 	registerSection(config, 'test_case', 'todo', build_test_case_todo_columns(locale), {

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

@@ -25,6 +25,12 @@ function build_test_run_listing_columns(locale, { include_select = true } = {})
 		is_required : true,
 	}));
 	columns.push(createColumn(model, locale, 'assigned_to', { width: '220', is_editable: true, is_required: true }));
+	columns.push(createColumn(model, locale, 'tags', {
+		width      : '220',
+		is_editable: false,
+		is_sortable: false,
+		is_required: false,
+	}));
 	columns.push(createColumn(model, locale, 'test_run_status', { width: '150', is_editable: true, is_required: true }));
 	columns.push(createColumn(model, locale, 'created_at', { width: '170', is_required: true }));
 	columns.push(createColumn(model, locale, 'completed_at', { width: '170', is_required: true }));
@@ -70,7 +76,7 @@ export function bootstrap_test_run(config)
 	const locale = UserService.get_current_language();
 
 	registerSection(config, 'test_run', 'listing', build_test_run_listing_columns(locale), {
-		for: createListingFor([ 'project_id' ]),
+		for: createListingFor([ 'project_id' ], { add: [ 'tags' ] }),
 	});
 
 	registerSection(config, 'test_run', 'todo', build_test_run_todo_columns(locale), {

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

@@ -22,6 +22,12 @@ function build_test_run_result_listing_columns(locale, { include_select = true }
 		is_required         : true,
 	}));
 	columns.push(createColumn(model, locale, 'assigned_to', { width: '220', is_editable: true, is_required: true }));
+	columns.push(createColumn(model, locale, 'tags', {
+		width      : '220',
+		is_editable: false,
+		is_sortable: false,
+		is_required: false,
+	}));
 	columns.push(createColumn(model, locale, 'created_at', { width: '170', is_required: true }));
 	columns.push(createColumn(model, locale, 'updated_at', { width: '170', is_required: true }));
 	columns.push(createColumn(model, locale, 'completed_at', { width: '170', is_required: true }));
@@ -128,7 +134,7 @@ export function bootstrap_test_run_result(config)
 	const locale = UserService.get_current_language();
 
 	registerSection(config, 'test_run_result', 'listing', build_test_run_result_listing_columns(locale), {
-		for: createListingFor([ 'project_id', 'test_case_id', 'test_run_id' ]),
+		for: createListingFor([ 'project_id', 'test_case_id', 'test_run_id' ], { add: [ 'tags' ] }),
 	});
 
 	registerSection(config, 'test_run_result', 'picker', build_test_run_result_picker_columns(locale), {

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

@@ -10,6 +10,12 @@ function build_text_document_listing_columns(locale)
 	return [
 		createPrimaryKeyColumn(model, locale),
 		createColumn(model, locale, 'text_document_title', { width: '320', is_editable: true, is_title: true }),
+		createColumn(model, locale, 'tags', {
+			width      : '220',
+			is_editable: false,
+			is_sortable: false,
+			is_required: false,
+		}),
 		createColumn(model, locale, 'text_document_status', { width: '140', is_editable: true }),
 		createColumn(model, locale, 'text_document_folder_id', { width: '120' }),
 		createColumn(model, locale, 'created_at', { width: '170' }),
@@ -26,6 +32,6 @@ export function bootstrap_text_document(config)
 	const locale = UserService.get_current_language();
 
 	registerSection(config, 'text_document', 'listing', build_text_document_listing_columns(locale), {
-		for: createListingFor([ 'project_id', 'text_document_folder_id' ]),
+		for: createListingFor([ 'project_id', 'text_document_folder_id' ], { add: [ 'tags' ] }),
 	});
 }

package/publish/app_configuration/table/table_configuration.js

@@ -1,6 +1,8 @@
 import { abstractAppConfiguration } from '../abstract_app_configuration.js';
 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_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';
@@ -111,6 +113,8 @@ export class TableConfiguration extends abstractAppConfiguration
 
 		bootstrap_bug(this.config);
 		bootstrap_bug_relation(this.config);
+		bootstrap_tag(this.config);
+		bootstrap_tag_relation(this.config);
 		bootstrap_test_case(this.config);
 		bootstrap_test_case_step(this.config);
 		bootstrap_test_run(this.config);

package/publish/index.js

@@ -16,9 +16,12 @@ export { typeTestRun } from './types/family_elements/typeTestRun.js'
 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 { 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 { familyContext } from './types/core/1_familyContext.js';
 export { typeBrowserContext } from './types/family_context/typeBrowserContext.js';

package/publish/services/FileAppService.js

@@ -75,13 +75,53 @@ export class FileAppService extends abstractService
 	}
 
 
+	/**
+	 * Whether entity_type is present for File App binding.
+	 * Empty / null / 0 → omit from token and upload init.
+	 *
+	 * @param {*} value
+	 * @returns {boolean}
+	 */
+	static #has_entity_type(value)
+	{
+		if (value === null || value === undefined)
+		{
+			return false;
+		}
+
+		const s = String(value).trim();
+
+		return s !== '' && s !== '0';
+	}
+
+
+	/**
+	 * Whether entity_id is present for File App binding.
+	 * Empty / null / 0 / NaN → omit from token and upload init.
+	 *
+	 * @param {*} value
+	 * @returns {boolean}
+	 */
+	static #has_entity_id(value)
+	{
+		if (value === null || value === undefined || value === '')
+		{
+			return false;
+		}
+
+		const n = Number(value);
+
+		return !Number.isNaN(n) && n !== 0;
+	}
+
+
 	/**
 	 * Upload browser File/Blob to File App (token via Main App bridge).
 	 *
 	 * @param {object} payload
 	 * @param {File|Blob} payload.file
-	 * @param {string} payload.entity_type
-	 * @param {number} payload.entity_id
+	 * @param {string} [payload.entity_type] — omit / null / 0 for unbound upload (attachments)
+	 * @param {number} [payload.entity_id] — omit / null / 0 for unbound upload (attachments)
 	 * @param {string} payload.category
 	 * @param {string} [payload.original_name]
 	 * @param {string} [payload.file_uuid] — re-upload / new version for existing file
@@ -97,20 +137,24 @@ export class FileAppService extends abstractService
 			throw new Error('FileAppService.upload_file: file is required');
 		}
 
-		const entity_type   = String(payload.entity_type || '');
-		const entity_id     = Number(payload.entity_id);
-		const category      = String(payload.category || '');
-		const mime_type     = file.type || 'application/octet-stream';
-		const size_bytes    = Number(file.size || 0);
-		const original_name = String(payload.original_name || file.name || 'upload');
-		const api           = FileAppService.#get_api_service();
-
-		const token_wrap = await api.file_app.issue_access_token({
-			scopes     : [ 'file:upload', 'file:read' ],
-			entity_type,
-			entity_id,
+		const has_entity_type = FileAppService.#has_entity_type(payload.entity_type);
+		const has_entity_id   = FileAppService.#has_entity_id(payload.entity_id);
+		const entity_type     = has_entity_type ? String(payload.entity_type) : undefined;
+		const entity_id       = has_entity_id ? Number(payload.entity_id) : undefined;
+		const category        = String(payload.category || '');
+		const mime_type       = file.type || 'application/octet-stream';
+		const size_bytes      = Number(file.size || 0);
+		const original_name   = String(payload.original_name || file.name || 'upload');
+		const api             = FileAppService.#get_api_service();
+
+		const token_payload = {
+			scopes: [ 'file:upload', 'file:read' ],
 			size_bytes,
-		});
+			...(has_entity_type ? { entity_type } : {}),
+			...(has_entity_id ? { entity_id } : {}),
+		};
+
+		const token_wrap = await api.file_app.issue_access_token(token_payload);
 
 		const token_data = await token_wrap?.response;
 
@@ -130,15 +174,17 @@ export class FileAppService extends abstractService
 			throw new ApiException({ message: 'File App access token was not issued' });
 		}
 
-		const init_response = await axios.post(`${ file_app_url }/api/v1/uploads`, {
+		const init_payload = {
 			category,
 			mime_type,
 			size_bytes,
 			original_name,
-			entity_type,
-			entity_id,
+			...(has_entity_type ? { entity_type } : {}),
+			...(has_entity_id ? { entity_id } : {}),
 			...(payload.file_uuid ? { file_uuid: String(payload.file_uuid) } : {}),
-		}, {
+		};
+
+		const init_response = await axios.post(`${ file_app_url }/api/v1/uploads`, init_payload, {
 			headers: {
 				Authorization: `Bearer ${ access_token }`,
 				Accept       : 'application/json',
@@ -183,8 +229,8 @@ export class FileAppService extends abstractService
 		const wire = {
 			...confirmed,
 			category   : confirmed.category || category,
-			entity_type: confirmed.entity_type || entity_type,
-			entity_id  : confirmed.entity_id ?? entity_id,
+			entity_type: confirmed.entity_type ?? entity_type ?? null,
+			entity_id  : confirmed.entity_id ?? entity_id ?? null,
 			mime_type  : confirmed.mime_type || mime_type,
 		};
 

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

@@ -8,6 +8,14 @@ import { familyGeneralElement } from "./0_familyGeneralElement.js";
  */
 export class familyTestDocumentation extends familyGeneralElement
 {
+	/**
+	 * Hydrated on element search via options.add: ['tags'].
+	 * Catalog entities (e.g. typeTag) leave this unset.
+	 *
+	 * @type {Array<object>|undefined}
+	 */
+	tags;
+
 
 	/**
 	 *
@@ -18,4 +26,4 @@ export class familyTestDocumentation extends familyGeneralElement
 		super();
 	}
 
-}
+}