complexqa_frontend_core 1.17.11 → 1.17.13

package/package.json

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

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

@@ -1,5 +1,9 @@
 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  : '1',
@@ -15,13 +19,42 @@ const COLUMN_DEFAULTS = {
 	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]
+ */
+
 
 /**
- * @param {familyGeneralElement} model
- * @param {string} locale
- * @param {string} field
- * @param {object} overrides
+ * Data-колонка с переводимым заголовком и сохранённым `header_field`.
+ *
+ * @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 = {})
 {
@@ -30,6 +63,7 @@ export function createColumn(model, locale, field, overrides = {})
 
 	return new typeTableColumn({
 		...COLUMN_DEFAULTS,
+		header_field,
 		header_name: overrides.header_name ?? header_model.get_attribute_name_translate(header_field, locale),
 		field,
 		...overrides,
@@ -38,9 +72,10 @@ export function createColumn(model, locale, field, overrides = {})
 
 
 /**
- * @param {familyGeneralElement} model
- * @param {string} locale
- * @param {object} overrides
+ * Колонка множественного выбора строк (`column_kind: row_select`).
+ * Без `header_field` — не локализуется. В web_app: pinned left, чекбоксы.
+ *
+ * @param {Partial<typeTableColumn>} [overrides={}]
  * @returns {typeTableColumn}
  */
 export function createRowSelectColumn(overrides = {})
@@ -60,9 +95,12 @@ export function createRowSelectColumn(overrides = {})
 
 
 /**
- * @param {familyGeneralElement} model
- * @param {string} locale
- * @param {object} overrides
+ * Колонка перехода к деталям (`column_kind: goto`).
+ * Заголовок в UI — через `translateGoToHeader` в web_app, не через ядро.
+ *
+ * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
+ * @param {string} locale Не используется; сохранён для единообразия API фабрик.
+ * @param {ColumnOverrides} [overrides={}]
  * @returns {typeTableColumn}
  */
 export function createGoToColumn(model, locale, overrides = {})
@@ -84,9 +122,11 @@ export function createGoToColumn(model, locale, overrides = {})
 
 
 /**
- * @param {familyGeneralElement} model
+ * Колонка primary key (часто скрытая в listing, видимая в todo).
+ *
+ * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
  * @param {string} locale
- * @param {object} overrides
+ * @param {ColumnOverrides} [overrides={}]
  * @returns {typeTableColumn}
  */
 export function createPrimaryKeyColumn(model, locale, overrides = {})
@@ -103,10 +143,12 @@ export function createPrimaryKeyColumn(model, locale, overrides = {})
 
 
 /**
- * @param {familyGeneralElement} model
+ * Колонка для таблиц details: без сортировки и фильтра ag-grid.
+ *
+ * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
  * @param {string} locale
  * @param {string} field
- * @param {object} overrides
+ * @param {ColumnOverrides} [overrides={}]
  * @returns {typeTableColumn}
  */
 export function createDetailsColumn(model, locale, field, overrides = {})

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

@@ -0,0 +1,76 @@
+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/section_registry.js

@@ -2,13 +2,27 @@ import { typeTableConfiguration } from '../../../types/family_service/typeTableC
 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]
+ */
 
 /**
- * @param {object} config
- * @param {string} element_type
- * @param {string} section
- * @param {typeTableColumn[]} columns
- * @param {object} options
+ * Регистрирует секцию таблицы в реестре `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 = {})
 {
@@ -31,8 +45,10 @@ export function registerSection(config, element_type, section, columns, options
 
 
 /**
- * @param {string} attribute
- * @returns {typeFilter}
+ * Фильтр-заготовка для runtime-подстановки значения в web_app.
+ *
+ * @param {string} attribute Имя атрибута (`project_id`, `test_case_id`, …).
+ * @returns {typeFilter} `operator: EQUAL`, `value: false` до гидратации.
  */
 export function createRuntimeFilter(attribute)
 {
@@ -45,9 +61,14 @@ export function createRuntimeFilter(attribute)
 
 
 /**
- * @param {string[]} filter_attributes
- * @param {object|false} for_options
+ * Строит шаблон `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)
 {

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

@@ -0,0 +1,34 @@
+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 { typeTestRunResult } from '../../../types/family_elements/typeTestRunResult.js';
+import { typeTestAccount } from '../../../types/family_elements/typeTestAccount.js';
+import { typeTeamMember } from '../../../types/family_elements/typeTeamMember.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';
+
+/**
+ * Реестр классов моделей по ключу `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,
+	test_run_result: typeTestRunResult,
+	test_account   : typeTestAccount,
+	team_member    : typeTeamMember,
+	test_case_step : typeTestCaseStep,
+	user           : typeUser,
+	team           : typeTeam,
+};

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

@@ -85,6 +85,12 @@ function build_bug_details_columns(locale)
 }
 
 
+/**
+ * Секции `bug`: `listing`, `todo`, `details`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_bug(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -50,6 +50,12 @@ function build_project_todo_column(locale)
 }
 
 
+/**
+ * Секции `project`: `domains` (ручные колонки без перевода), `todo_column`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_project(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -33,6 +33,12 @@ function build_team_total_statistic_columns(locale)
 }
 
 
+/**
+ * Секции `team`: `profile`; `team_total_statistic`: `details`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_team(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -1,5 +1,4 @@
 import { typeTeamMember } from '../../../types/family_elements/typeTeamMember.js';
-import { typeUser } from '../../../types/family_elements/typeUser.js';
 import { UserService } from '../../../services/UserService.js';
 import { createColumn } from '../helpers/column_factory.js';
 import { createListingFor, registerSection } from '../helpers/section_registry.js';
@@ -7,29 +6,26 @@ import { createListingFor, registerSection } from '../helpers/section_registry.j
 function build_team_member_listing_columns(locale)
 {
 	const model = new typeTeamMember();
-	const user_model = new typeUser();
 
 	return [
 		createColumn(model, locale, 'user_id.first_name', {
-			header_name : user_model.get_attribute_name_translate('first_name', locale),
+			header_field: 'first_name',
 			width       : '200',
 			is_filter   : false,
 			is_editable : false,
-			header_element_type: 'user',
 		}),
 		createColumn(model, locale, 'user_id.last_name', {
-			header_name : user_model.get_attribute_name_translate('last_name', locale),
+			header_field: 'last_name',
 			width       : '200',
 			is_filter   : false,
 			is_editable : false,
-			header_element_type: 'user',
 		}),
 		createColumn(model, locale, 'user_id.email', {
-			header_name : user_model.get_attribute_name_translate('email', locale),
-			width       : '200',
-			is_filter   : false,
-			is_editable : false,
-			header_element_type: 'user',
+			header_field        : 'email',
+			header_element_type : 'user',
+			width               : '200',
+			is_filter           : false,
+			is_editable         : false,
 		}),
 		createColumn(model, locale, 'team_member_status', { width: '160', is_filter: false, is_editable: true }),
 		createColumn(model, locale, 'member_role', { width: '200', is_filter: false, is_editable: true }),
@@ -37,6 +33,12 @@ function build_team_member_listing_columns(locale)
 }
 
 
+/**
+ * Секция `team_member`: `listing`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_team_member(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -56,6 +56,12 @@ function build_test_account_details_columns(locale)
 }
 
 
+/**
+ * Секции `test_account`: `listing`, `details` (в details — колонка `copy`).
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_account(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -48,6 +48,12 @@ function build_test_case_todo_columns(locale)
 }
 
 
+/**
+ * Секции `test_case`: `listing`, `todo`, `picker`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_case(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -45,6 +45,12 @@ function build_test_case_presteps_columns(locale)
 	return build_test_case_step_shared_columns(locale);
 }
 
+/**
+ * Секции `test_case_step`: `steps`, `presteps` (шаги и престепы тест-кейса).
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_case_step(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -59,6 +59,12 @@ function build_test_run_todo_columns(locale)
 }
 
 
+/**
+ * Секции `test_run`: `listing`, `todo`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_run(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -1,5 +1,4 @@
 import { typeTestRunResult } from '../../../types/family_elements/typeTestRunResult.js';
-import { typeTestCase } from '../../../types/family_elements/typeTestCase.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';
@@ -7,7 +6,6 @@ import { createListingFor, registerSection } from '../helpers/section_registry.j
 function build_test_run_result_listing_columns(locale, { include_select = true } = {})
 {
 	const model = new typeTestRunResult();
-	const test_case_model = new typeTestCase();
 	const columns = [];
 
 	if (include_select)
@@ -16,10 +14,11 @@ function build_test_run_result_listing_columns(locale, { include_select = true }
 	}
 
 	columns.push(createColumn(model, locale, 'test_case_id.test_case_title', {
-		header_name : test_case_model.get_attribute_name_translate('test_case_title', locale),
-		width       : '480',
-		is_editable : false,
-		is_required : true,
+		header_field        : 'test_case_title',
+		header_element_type : 'test_case',
+		width               : '480',
+		is_editable         : false,
+		is_required         : true,
 	}));
 	columns.push(createColumn(model, locale, 'assigned_to', { width: '220', is_editable: true, is_required: true }));
 	columns.push(createColumn(model, locale, 'created_at', { width: '170', is_required: true }));
@@ -35,16 +34,15 @@ function build_test_run_result_listing_columns(locale, { include_select = true }
 function build_test_run_result_todo_columns(locale)
 {
 	const model = new typeTestRunResult();
-	const test_case_model = new typeTestCase();
-
 	return [
 		createPrimaryKeyColumn(model, locale),
 		createColumn(model, locale, 'test_case_id.test_case_title', {
-			header_name : test_case_model.get_attribute_name_translate('test_case_title', locale),
-			width       : '480',
-			is_editable : false,
-			is_required : true,
-			is_title    : true,
+			header_field        : 'test_case_title',
+			header_element_type : 'test_case',
+			width               : '480',
+			is_editable         : false,
+			is_required         : true,
+			is_title            : true,
 		}),
 		createColumn(model, locale, 'assigned_to', { width: '220', is_editable: true, is_required: true }),
 		createColumn(model, locale, 'test_result_status', { width: '150', is_editable: true, is_required: true }),
@@ -76,6 +74,12 @@ function build_test_run_result_details_columns(locale)
 }
 
 
+/**
+ * Секции `test_run_result`: `listing`, `todo`, `details`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_run_result(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -17,6 +17,12 @@ function build_user_profile_columns(locale)
 }
 
 
+/**
+ * Секция `user`: `profile`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_user(config)
 {
 	const locale = UserService.get_current_language();

package/publish/app_configuration/table/table_base_config.js

@@ -1,40 +1,29 @@
 import { LOCALE_AG_GRID_RU } from '../locale_table_ru.js';
 import { LOCALE_AG_GRID_EG } from '../table_locale_ar.js';
-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 { typeTestRunResult } from '../../types/family_elements/typeTestRunResult.js';
-import { typeTestAccount } from '../../types/family_elements/typeTestAccount.js';
-import { typeTeamMember } from '../../types/family_elements/typeTeamMember.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';
-
-const ROW_NODE_MODELS = {
-	test_case      : typeTestCase,
-	project        : typeProject,
-	test_run       : typeTestRun,
-	bug            : typeBug,
-	test_run_result: typeTestRunResult,
-	test_account   : typeTestAccount,
-	team_member    : typeTeamMember,
-	test_case_step : typeTestCaseStep,
-	user           : typeUser,
-	team           : typeTeam,
-};
+import { TABLE_ELEMENT_MODELS } from './helpers/table_element_models.js';
 
 /**
- * Базовые опции ag-grid, общие для всех таблиц.
+ * Базовые опции ag-grid Community, общие для всех таблиц приложения.
+ *
+ * Не содержит columnDefs — они строятся в web_app из `TableConfiguration`.
+ * Дополняет грид: `defaultColDef`, `rowSelection`, `localeText`, `getRowNodeId`.
  *
- * @version			v.0.2 (12/06/2026)
+ * @see docs/App Configuration/table.MD
+ * @version v.0.3 (12/06/2026)
  */
 export class TableBaseConfig
 {
 	/**
-	 * @param {string} element_type
-	 * @param {string} section
-	 * @param {string} lang
+	 * Возвращает копию общих gridOptions для ag-grid.
+	 *
+	 * @param {string} element_type Ключ сущности — для `getRowNodeId` (primary key модели).
+	 * @param {string} section Имя секции (зарезервировано; сейчас не влияет на ответ).
+	 * @param {string} [lang='en'] Локаль UI ag-grid. Для `ru` и `ar` добавляется `localeText`.
+	 * @returns {Object} GridOptions-совместимый объект (без привязки к Vue).
+	 *
+	 * @example
+	 * const { getRowNodeId, localeText, defaultColDef, ...gridOptions } =
+	 *   TableBaseConfig.get_config('bug', 'listing', 'ru');
 	 */
 	static get_config(element_type, section, lang)
 	{
@@ -55,8 +44,11 @@ export class TableBaseConfig
 
 
 	/**
-	 * @param lang
-	 * @returns {{}}
+	 * Словарь ag-grid localeText для меню колонок и системных строк.
+	 *
+	 * @private
+	 * @param {string} lang
+	 * @returns {Object<string, string>}
 	 */
 	static #localeText(lang)
 	{
@@ -76,15 +68,18 @@ export class TableBaseConfig
 
 
 	/**
-	 * @param element_type
-	 * @returns {function(*): number}
+	 * Фабрика `getRowNodeId`: возвращает id строки по primary key сущности.
+	 *
+	 * @private
+	 * @param {string} element_type
+	 * @returns {function(Object): number}
 	 */
 	static #getRowNodeId(element_type)
 	{
 		return function (data)
 		{
 			let id           = 0;
-			const ModelClass = ROW_NODE_MODELS[ element_type ];
+			const ModelClass = TABLE_ELEMENT_MODELS[ element_type ];
 
 			if (ModelClass)
 			{
@@ -102,6 +97,10 @@ export class TableBaseConfig
 	}
 
 
+	/**
+	 * Статические опции ag-grid по умолчанию.
+	 * @type {Object}
+	 */
 	static config = {
 		defaultColDef            : {
 			filter    : true,

package/publish/app_configuration/table/table_configuration.js

@@ -9,23 +9,40 @@ import { bootstrap_team_member } from './sections/team_member.js';
 import { bootstrap_user } from './sections/user.js';
 import { bootstrap_team } from './sections/team.js';
 import { bootstrap_project } from './sections/project.js';
+import { localizeTableSection } from './helpers/column_locale.js';
 
 /**
- * Реестр конфигураций таблиц (ag-grid).
+ * Реестр конфигураций таблиц ag-grid.
  *
- * @version			v.0.2 (12/06/2026)
+ * Хранит колонки (`typeTableColumn`), шаблон поиска (`for`) и метаданные по парам
+ * `element_type` × `section` (например `test_case` × `listing`).
+ *
+ * Заголовки data-колонок локализуются при каждом вызове `get_config`, а не при bootstrap.
+ * Представление ячеек (renderer/editor) — в web_app (`ColumnFactory`).
+ *
+ * @see docs/App Configuration/table.MD
+ * @version v.0.3 (12/06/2026)
  */
 export class TableConfiguration extends abstractAppConfiguration
 {
+	/**
+	 * Внутренний реестр: `config[element_type][section] → { config: typeTableConfiguration }`.
+	 * @type {Object<string, Object<string, { config: import('../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>}
+	 */
 	static config = {};
 
+	/**
+	 * @type {{ loaded: boolean }}
+	 */
 	static state = {
 		loaded: false
 	}
 
 
 	/**
-	 * @param init_options
+	 * Синглтон: при первом создании вызывает `bootstrap()`.
+	 *
+	 * @param {boolean|object} [init_options=false]
 	 */
 	constructor(init_options = false)
 	{
@@ -43,28 +60,43 @@ export class TableConfiguration extends abstractAppConfiguration
 
 
 	/**
-	 * @param {string} element_type
-	 * @param {string} section
-	 * @param {string} lang
+	 * Возвращает конфигурацию секции таблицы с заголовками колонок для запрошенной локали.
+	 *
+	 * @param {string} element_type Ключ сущности (`bug`, `test_case`, `test_run`, …).
+	 * @param {string} section Имя секции (`listing`, `todo`, `details`, `steps`, `presteps`, …).
+	 * @param {string} [lang='en'] Код локали (`en`, `ru`, `ar`). Передаётся из web_app (`getLocale()`).
+	 * @returns {{ config: import('../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }|false}
+	 *   Объект с полем `config` или `false`, если секция не зарегистрирована.
 	 *
-	 * @todo - header_name модифицируем под локаль
+	 * @example
+	 * const section = TableConfiguration.get_config('test_case', 'listing', 'ru');
+	 * const columns = section.config.columns;
+	 * const forTemplate = section.config.for;
 	 */
-	static get_config(element_type, section, lang)
+	static get_config(element_type, section, lang = 'en')
 	{
 		if (!this.state.loaded)
 		{
 			this.bootstrap();
 		}
 
-		if (this.config?.[ element_type ]?.[ section ])
+		const section_config = this.config?.[ element_type ]?.[ section ];
+
+		if (!section_config)
 		{
-			return this.config?.[ element_type ]?.[ section ];
+			return false;
 		}
 
-		return false;
+		return localizeTableSection(section_config, element_type, lang || 'en');
 	}
 
 
+	/**
+	 * Однократная загрузка всех секций из `sections/*` в `static.config`.
+	 * Повторный вызов — no-op.
+	 *
+	 * @returns {void}
+	 */
 	static bootstrap()
 	{
 		if (this.state.loaded)

package/publish/types/family_service/typeTableColumn.js

@@ -1,58 +1,116 @@
-import { familyService } from "./familyService";
-
-/**
- *
- * @version			v.0.1 (26/04/2025)
- */
-export class typeTableColumn extends familyService
-{
-	header_name;
-	field;
-	width;
-	sort_order;
-	cell_classes;
-	default_sort;
-	is_sortable;
-	is_filter;
-	is_hide;
-	is_editable;
-
-	/**
-	 * Семантический тип колонки для фабрики ColDef (этап 3).
-	 * @type {'data'|'row_select'|'goto'|'sort_action'|'copy'}
-	 */
-	column_kind = 'data';
-
-	/**
-	 * Обязательное поле при создании/редактировании строки.
-	 */
-	is_required = false;
-
-	/**
-	 * Поле-заголовок сущности (например test_case_title).
-	 */
-	is_title = false;
-
-	/**
-	 * Тип сущности для перевода header_name, если отличается от основной.
-	 */
-	header_element_type = false;
-
-
-	constructor(data = false)
-	{
-		super();
-		if (data && typeof data === 'object')
-		{
-			_.mapObject(data, (value, key) =>
-			{
-				if (this.hasOwnProperty(key))
-				{
-					this [ key ] = value;
-				}
-			});
-		}
-
-		return this;
-	}
-}
+import { familyService } from "./familyService";
+
+/**
+ * Описание одной колонки таблицы ag-grid.
+ *
+ * Ядро хранит структуру и флаги; web_app (`ColumnFactory`) маппит в `ColDef`
+ * и подбирает cellRenderer / cellEditor по `field` и `column_kind`.
+ *
+ * @see docs/App Configuration/table.MD
+ * @version v.0.2 (12/06/2026)
+ */
+export class typeTableColumn extends familyService
+{
+	/**
+	 * Отображаемый заголовок колонки.
+	 * Для `column_kind: 'data'` пересчитывается в `TableConfiguration.get_config` по `header_field` и `lang`.
+	 * @type {string|undefined}
+	 */
+	header_name;
+
+	/**
+	 * Имя поля в данных строки (ColDef.field).
+	 * @type {string|undefined}
+	 */
+	field;
+
+	/**
+	 * Ширина колонки в пикселях (строка для совместимости с конфигами).
+	 * @type {string|number|undefined}
+	 */
+	width;
+
+	/**
+	 * Порядок колонки (меньше — левее). Сортируется в ColumnFactory перед сборкой ColDef.
+	 * @type {string|number|undefined}
+	 */
+	sort_order;
+
+	/**
+	 * CSS-классы ячейки.
+	 * @type {string|undefined}
+	 */
+	cell_classes;
+
+	/**
+	 * Начальная сортировка: `''`, `'asc'` или `'desc'`.
+	 * @type {''|'asc'|'desc'|string|undefined}
+	 */
+	default_sort;
+
+	/** @type {boolean|undefined} */
+	is_sortable;
+
+	/** @type {boolean|undefined} */
+	is_filter;
+
+	/** @type {boolean|undefined} */
+	is_hide;
+
+	/** @type {boolean|undefined} */
+	is_editable;
+
+	/**
+	 * Семантический тип колонки для фабрики ColDef в web_app.
+	 * @type {'data'|'row_select'|'goto'|'sort_action'|'copy'}
+	 */
+	column_kind = 'data';
+
+	/**
+	 * Обязательное поле при создании/редактировании строки (метаданные для UI).
+	 * @type {boolean}
+	 */
+	is_required = false;
+
+	/**
+	 * Поле-заголовок сущности в строке (например `test_case_title` в todo).
+	 * Влияет на multiline / flex в ColumnFactory.
+	 * @type {boolean}
+	 */
+	is_title = false;
+
+	/**
+	 * Ключ модели для перевода заголовка, если отличается от `element_type` секции.
+	 * Пример: `test_case` для колонки `test_case_id.test_case_title` в `test_run_result`.
+	 * @type {string|false}
+	 */
+	header_element_type = false;
+
+	/**
+	 * Имя атрибута в `attribute_name_translate_matrix` для заголовка.
+	 * Задаётся в `createColumn`; если `false` — заголовок не локализуется при `get_config`.
+	 * @type {string|false}
+	 */
+	header_field = false;
+
+
+	/**
+	 * @param {Partial<typeTableColumn>|false} [data=false]
+	 */
+	constructor(data = false)
+	{
+		super();
+		if (data && typeof data === 'object')
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}

package/publish/types/family_service/typeTableConfiguration.js

@@ -1,33 +1,40 @@
 import { typeAppConfiguration } from "./typeAppConfiguration";
 
 /**
- * Настройки таблиц (aggrid)
+ * Конфигурация одной секции таблицы (набор колонок + поиск).
  *
- * @version			v.0.1 (26/04/2025)
+ * Регистрируется через `registerSection` в `sections/*`.
+ * Потребляется web_app: `useTableConfig` → `ColumnFactory` + `buildSearchPayload`.
+ *
+ * @see docs/App Configuration/table.MD
+ * @version v.0.2 (12/06/2026)
  */
 export class typeTableConfiguration extends typeAppConfiguration
 {
 	/**
-	 * @type {array<typeTableColumn>}
+	 * Список колонок секции.
+	 * @type {import('./typeTableColumn.js').typeTableColumn[]|undefined}
 	 */
 	columns;
 
 	/**
-	 * @type {array<typeFOR>}
+	 * Шаблон объекта поиска (`typeFOR`) для листингов.
+	 * Фильтры с `value: false` гидратируются в web_app через `buildSearchPayload`.
+	 * @type {import('./typeFOR.js').typeFOR|false|undefined}
 	 */
 	for;
 
 
 	/**
-	 * Элемент, в составе
-	 * надо ли
+	 * Тип вложенной сущности для контекстных таблиц (например todo внутри project).
+	 * @type {string|false|undefined}
 	 */
 	contained_element_type;
 
 
 
 	/**
-	 * под развитие
+	 * Ссылки на внешнюю документацию секции (зарезервировано).
 	 * @type {{link: false|string, description: false|string}}
 	 */
 	documentation = {
@@ -37,6 +44,9 @@ export class typeTableConfiguration extends typeAppConfiguration
 
 
 
+	/**
+	 * @param {Partial<typeTableConfiguration>|false} [data=false]
+	 */
 	constructor(data = false)
 	{
 		super();
@@ -53,4 +63,4 @@ export class typeTableConfiguration extends typeAppConfiguration
 
 		return this;
 	}
-}
+}