feat: аннотации как значения параметров аннотаций (внедрение)

Реализован общий механизм резолва значений параметров аннотаций:
если значение параметра само является аннотацией, оно трактуется как
описание частицы, прилепляется штатным механизмом, и результат её
прилепления используется как значение.

- ПрилепляторЧастиц.РазрешитьЗначение — единая точка резолва; применяется
  к имени частицы, значениям Блестяшка, ЗначениеПоУмолчанию и Типу.
  Рекурсия автоматическая: НайтиПрилепляемуюЧастицу сам прогоняет свои
  значения через РазрешитьЗначение, поэтому вложенность любой глубины
  разрешается сама собой. Даёт кейс &Пластилин(&Деталька("Ключ")).
- ПрилепляемаяЧастица: имя частицы может нести вложенную аннотацию до
  резолва; добавлено имя свойства как имя по умолчанию для вложенной
  аннотации без явного значения.
- Зависимость annotations поднята до 1.7.0, версия до 5.1.0.

Тест + изолированные фикстуры покрывают внедрение желудя, имя которого
берётся из настройки через вложенную &Деталька.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Knr8gmzxGCTqmbLhYXUEue

Author: claude

packagedef

@@ -5,7 +5,7 @@
 
 
 Описание.Имя("autumn")
-        .Версия("5.0.0")
+        .Версия("5.1.0")
         .Автор("Nikita Fedkin")
         .АдресАвтора("nixel2007@gmail.com")
         .Описание("Dependency injection framework для OneScript")
@@ -14,7 +14,7 @@
         .ВключитьФайл("tests")
         .ВключитьФайл("LICENSE.md")
         .ВключитьФайл("README.md")
-        .ЗависитОт("annotations", "1.6.0")
+        .ЗависитОт("annotations", "1.7.0")
         .ЗависитОт("asserts", "1.6.2")
         .ЗависитОт("configor", "0.12.0")
         .ЗависитОт("logos", "1.7.1")

src/internal/Классы/ПрилепляторЧастиц.os

@@ -42,15 +42,15 @@
 		);
 	КонецЕсли;
 
-	ПрилепляемаяЧастица = Новый ПрилепляемаяЧастица(ТипЧастицы, ИмяЧастицы, Аннотация);
+	ПрилепляемаяЧастица = Новый ПрилепляемаяЧастица(ТипЧастицы, ИмяЧастицы, Аннотация, Неопределено, ИмяСвойства);
 
 	АннотацияТабакерка = РаботаСАннотациями.ПолучитьАннотацию(Свойство, "Табакерка");
 	Если АннотацияТабакерка <> Неопределено Тогда
 		ТипЧастицы = ТипыПрилепляемыхЧастиц.Табакерка();
 		Аннотация = АннотацияТабакерка;
 		БазоваяПрилепляемаяЧастица = ПрилепляемаяЧастица;
 
-		ПрилепляемаяЧастица = Новый ПрилепляемаяЧастица(ТипЧастицы, ИмяЧастицы, Аннотация, БазоваяПрилепляемаяЧастица);
+		ПрилепляемаяЧастица = Новый ПрилепляемаяЧастица(ТипЧастицы, ИмяЧастицы, Аннотация, БазоваяПрилепляемаяЧастица, ИмяСвойства);
 	КонецЕсли;
 
 	Возврат ПрилепляемаяЧастица;
@@ -66,21 +66,25 @@
 	Аннотация = ДанныеОПрилепляемойЧастице.Аннотация();
 	БазоваяПрилепляемаяЧастица = ДанныеОПрилепляемойЧастице.БазоваяПрилепляемаяЧастица();
 
+	// Имя частицы может быть задано вложенной аннотацией (например &Пластилин(&Деталька("Ключ"))).
+	// Резолвим её в конкретное значение; для литералов возвращается само значение.
+	ИмяЧастицы = РазрешитьЗначение(ИмяЧастицы, ДанныеОПрилепляемойЧастице.ИмяСвойства());
+
 	Если ТипЧастицы = ТипыПрилепляемыхЧастиц.Табакерка() Тогда
 		ПрилепляемаяЧастица = Новый Табакерка(ЭтотОбъект, БазоваяПрилепляемаяЧастица);
 	ИначеЕсли ТипЧастицы = ТипыПрилепляемыхЧастиц.Желудь() Тогда
 
-		ТипЖелудя = РаботаСАннотациями.ПолучитьЗначениеПараметраАннотации(
+		ТипЖелудя = РазрешитьЗначение(РаботаСАннотациями.ПолучитьЗначениеПараметраАннотации(
 			Аннотация,
 			"Тип",
 			"Желудь"
-		);
+		));
 
 		Если ПрилепляемыеЧастицы = Неопределено Тогда
 			ПараметрыАннотации = РаботаСАннотациями.ПолучитьПараметрыАннотации(Аннотация, "Блестяшка");
 			ПрилепляемыеЧастицы = Новый Массив;
 			Для Каждого ПараметрБлестяшка Из ПараметрыАннотации Цикл
-				ПрилепляемыеЧастицы.Добавить(ПараметрБлестяшка.Значение);
+				ПрилепляемыеЧастицы.Добавить(РазрешитьЗначение(ПараметрБлестяшка.Значение));
 			КонецЦикла;
 		КонецЕсли;
 
@@ -94,12 +98,12 @@
 
 	ИначеЕсли ТипЧастицы = ТипыПрилепляемыхЧастиц.Деталька() Тогда
 
-		ЗначениеПоУмолчанию = РаботаСАннотациями.ПолучитьЗначениеПараметраАннотации(
-			Аннотация, 
-			"ЗначениеПоУмолчанию", 
+		ЗначениеПоУмолчанию = РазрешитьЗначение(РаботаСАннотациями.ПолучитьЗначениеПараметраАннотации(
+			Аннотация,
+			"ЗначениеПоУмолчанию",
 			Неопределено,
 			Истина
-		);
+		));
 
 		ПрилепляемаяЧастица = Поделка.НайтиДетальку(ИмяЧастицы, ЗначениеПоУмолчанию);
 	Иначе
@@ -110,6 +114,57 @@
 
 КонецФункции
 
+// Разрешить значение параметра аннотации.
+//
+// Если значение является вложенной аннотацией (например &Деталька("Ключ") или &Пластилин("ИмяЖелудя")),
+// оно трактуется как описание частицы: аннотация прилепляется штатным механизмом, а результат её
+// прилепления возвращается как значение. Литералы возвращаются без изменений.
+//
+// Механизм общий и рекурсивный: НайтиПрилепляемуюЧастицу сам прогоняет имя, блестяшки и значение
+// по умолчанию через РазрешитьЗначение, поэтому вложенность произвольной глубины разрешается сама собой.
+//
+// Параметры:
+//   Значение        - Произвольный - Значение параметра аннотации (литерал или вложенная аннотация).
+//   ИмяПоУмолчанию  - Строка       - Имя частицы по умолчанию для вложенной аннотации без явного значения.
+//
+//  Возвращаемое значение:
+//   Произвольный - Разрешённое значение.
+//
+Функция РазрешитьЗначение(Знач Значение, Знач ИмяПоУмолчанию = "")
+
+	Если НЕ РаботаСАннотациями.ЭтоАннотация(Значение) Тогда
+		Возврат Значение;
+	КонецЕсли;
+
+	ПсевдоСвойство = Новый Структура("Имя, Аннотации", ИмяПоУмолчанию, ТаблицаИзОднойАннотации(Значение));
+	ДанныеОЧастице = ДанныеОПрилепляемойЧастице(ПсевдоСвойство);
+
+	Возврат НайтиПрилепляемуюЧастицу(ДанныеОЧастице);
+
+КонецФункции
+
+// Построить таблицу аннотаций из одной вложенной аннотации-значения.
+//
+// Параметры:
+//   Аннотация - СтрокаТаблицыЗначений - Вложенная аннотация с колонками Имя и Параметры.
+//
+//  Возвращаемое значение:
+//   ТаблицаЗначений - Таблица аннотаций с единственной строкой.
+//
+Функция ТаблицаИзОднойАннотации(Аннотация)
+
+	Таблица = Новый ТаблицаЗначений;
+	Таблица.Колонки.Добавить("Имя");
+	Таблица.Колонки.Добавить("Параметры");
+
+	Строка = Таблица.Добавить();
+	Строка.Имя = Аннотация.Имя;
+	Строка.Параметры = Аннотация.Параметры;
+
+	Возврат Таблица;
+
+КонецФункции
+
 Процедура ПриСозданииОбъекта(пПоделка, пУправляющийПрилепляемымиКоллекциями)
 	Поделка = пПоделка;
 	УправляющийПрилепляемымиКоллекциями = пУправляющийПрилепляемымиКоллекциями;

src/Классы/ПрилепляемаяЧастица.os

@@ -4,6 +4,7 @@
 Перем _ИмяЧастицы;
 Перем _Аннотация;
 Перем _БазоваяПрилепляемаяЧастица;
+Перем _ИмяСвойства;
 
 // Тип прилепляемой частицы (желудь, деталька, блестяшка или табакерка).
 //
@@ -46,6 +47,17 @@
 	Возврат _БазоваяПрилепляемаяЧастица;
 КонецФункции
 
+// Имя свойства/параметра, к которому относится частица.
+// Используется как имя по умолчанию при резолве вложенной аннотации-значения,
+// у которой не задано собственное значение.
+//
+//  Возвращаемое значение:
+//   Строка
+//
+Функция ИмяСвойства() Экспорт
+	Возврат _ИмяСвойства;
+КонецФункции
+
 // Описывает зависимость (частицу), которую нужно прилепить к желудю.
 //
 // Параметры:
@@ -58,10 +70,14 @@
 //       ** Значение - Строка - значение параметра аннотации
 //   БазоваяПрилепляемаяЧастица - ПрилепляемаяЧастица - Базовая частица для коллекций и табакерок. По умолчанию Неопределено.
 //
-Процедура ПриСозданииОбъекта(ТипЧастицы, ИмяЧастицы, Аннотация, БазоваяПрилепляемаяЧастица = Неопределено)
-	
+Процедура ПриСозданииОбъекта(ТипЧастицы, ИмяЧастицы, Аннотация, БазоваяПрилепляемаяЧастица = Неопределено, ИмяСвойства = "")
+
 	Утверждения.ПроверитьТип(ТипЧастицы, "Строка");
-	Утверждения.ПроверитьТип(ИмяЧастицы, "Строка");
+	// Имя частицы обычно строка, но может быть вложенной аннотацией (СтрокаТаблицыЗначений),
+	// которая резолвится в конкретное значение при создании желудя.
+	Если ТипЗнч(ИмяЧастицы) <> Тип("СтрокаТаблицыЗначений") Тогда
+		Утверждения.ПроверитьТип(ИмяЧастицы, "Строка");
+	КонецЕсли;
 	Утверждения.ПроверитьТип(Аннотация, "СтрокаТаблицыЗначений");
 	Если БазоваяПрилепляемаяЧастица <> Неопределено Тогда
 		Утверждения.ПроверитьТип(БазоваяПрилепляемаяЧастица, "ПрилепляемаяЧастица");
@@ -71,5 +87,6 @@
 	_ИмяЧастицы = ИмяЧастицы;
 	_Аннотация = Аннотация;
 	_БазоваяПрилепляемаяЧастица = БазоваяПрилепляемаяЧастица;
+	_ИмяСвойства = ИмяСвойства;
 
 КонецПроцедуры

tests/ВложенныеЗначения/ЖелудьСВложеннойДеталькой.os

@@ -0,0 +1,10 @@
+// BSLLS:MissingVariablesDescription-off
+// BSLLS:ExportVariables-off
+
+// Имя внедряемого желудя берётся из настройки, на которую ссылается вложенная &Деталька.
+&Пластилин(&Деталька("ИмяАппендера"))
+Перем Зависимость Экспорт;
+
+&Желудь
+Процедура ПриСозданииОбъекта()
+КонецПроцедуры

tests/ВложенныеЗначения/ЦелевойЖелудь.os

@@ -0,0 +1,3 @@
+&Желудь("ЦелевойЖелудь")
+Процедура ПриСозданииОбъекта()
+КонецПроцедуры

tests/Поделка.os

@@ -322,6 +322,28 @@
 
 КонецПроцедуры
 
+&Тест
+&Изолированный(
+	Уровень = "Процесс",
+	Импорты = "./ВложенныеЗначения",
+	Совет = "() -> {
+		|	Возврат Новый СоветДругогоМастера()
+		|		.ЗначенияДеталек(Новый Соответствие(
+		|			Соответствия.ИзЭлементов(""ИмяАппендера"", ""ЦелевойЖелудь"")
+		|		));
+		|}"
+)
+Процедура ИмяВнедряемогоЖелудяБерётсяИзВложеннойДетальки() Экспорт
+
+	// Дано-Когда
+	// &Пластилин(&Деталька("ИмяАппендера")) — имя внедряемого желудя резолвится из настройки.
+	Желудь = Поделка.НайтиЖелудь("ЖелудьСВложеннойДеталькой");
+
+	// Тогда
+	Ожидаем.Что(Желудь.Зависимость, "Вложенная деталька не разрешилась в имя желудя").ИмеетТип("ЦелевойЖелудь");
+
+КонецПроцедуры
+
 &Тест
 Процедура НапильникПолучаетЖелудьЧерезКонструктор() Экспорт