Merge branch 'master' into feature/advice

Author: Segate-ekb

.github/workflows/perfomance.yml

@@ -10,7 +10,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        oscript_version: ['dev', 'lts-dev', 'default']
+        oscript_version: ['dev', 'lts', 'default']
     uses: autumn-library/workflows/.github/workflows/test.yml@main
     with:
       oscript_version: ${{ matrix.oscript_version }}

.github/workflows/qa.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
   sonar:
-    uses: autumn-library/workflows/.github/workflows/sonar.yml@coverage
+    uses: autumn-library/workflows/.github/workflows/sonar.yml@main
     with:
       github_repository: autumn-library/autumn
       coveralls: true

.github/workflows/testing.yml

@@ -10,7 +10,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        oscript_version: ['dev', 'lts-dev', 'default']
+        oscript_version: ['dev', 'lts', 'default']
     uses: autumn-library/workflows/.github/workflows/test.yml@main
     with:
       oscript_version: ${{ matrix.oscript_version }}

docs/api/010-Аннотации/220-ПсевдонимДля.md

@@ -0,0 +1,4 @@
+> [!INFO]
+> Документация из библиотеки [annotations](../../annotations/index.md).
+
+<!--@include: @/api/002-annotations/Аннотации/ПсевдонимДля.md-->

docs/api/020-Желуди/010-Поделка.md

@@ -7,119 +7,238 @@ title: Поделка
 ## ПриСозданииОбъекта
 
 ```bsl
-
+// Создаёт контекст приложения (поделку): инициализирует фабрику желудей, контейнер аннотаций,
+// менеджер параметров и сканирует известные типы.
+//
+// Параметры:
+//   СоветДругогоМастера - СоветДругогоМастера - Настройки создания поделки. По умолчанию Неопределено — используются настройки по умолчанию.
+//
 Процедура ПриСозданииОбъекта(Знач СоветДругогоМастера = Неопределено)
 ```
 
 ## ПолучитьОпределенияЖелудей
 
 ```bsl
-
+// Возвращает определения желудей. Если имя не указано — возвращаются все известные определения.
+//
+// Параметры:
+//   Имя - Строка - Имя желудя, определения которого нужно получить. По умолчанию Неопределено — вернутся все определения.
+//
+//  Возвращаемое значение:
+//   ФиксированноеСоответствие:
+//    * Ключ     - Строка - имя желудя
+//    * Значение - ОпределениеЖелудя - определение желудя
+//
 Функция ПолучитьОпределенияЖелудей(Имя = Неопределено) Экспорт
 ```
 
 ## ПолучитьОпределенияАннотаций
 
 ```bsl
-
+// Возвращает определения всех зарегистрированных аннотаций.
+//
+//  Возвращаемое значение:
+//   ФиксированноеСоответствие:
+//    * Ключ     - Строка - имя аннотации
+//    * Значение - ОпределениеАннотации - определение аннотации
+//
 Функция ПолучитьОпределенияАннотаций() Экспорт
 ```
 
 ## ПолучитьОпределениеЖелудя
 
 ```bsl
-
+// Возвращает определение желудя по его имени.
+//
+// Параметры:
+//   Имя - Строка - Имя желудя.
+//
+//  Возвращаемое значение:
+//   ОпределениеЖелудя, Неопределено - определение желудя либо Неопределено, если желудь не найден.
+//
 Функция ПолучитьОпределениеЖелудя(Имя) Экспорт
 ```
 
 ## ПолучитьОпределениеАннотации
 
 ```bsl
-
+// Возвращает определение аннотации по её имени.
+//
+// Параметры:
+//   Имя - Строка - Имя аннотации.
+//
+//  Возвращаемое значение:
+//   ОпределениеАннотации, Неопределено - определение аннотации либо Неопределено, если аннотация не найдена.
+//
 Функция ПолучитьОпределениеАннотации(Имя) Экспорт
 ```
 
 ## НайтиЖелудь
 
 ```bsl
-
+// Находит и возвращает экземпляр желудя по его имени.
+//
+// Параметры:
+//   Имя - Строка - Имя желудя. Имя "Поделка" возвращает сам контекст.
+//   ПрилепляемыеЧастицы - Массив из ПрилепляемаяЧастица - Зависимости, передаваемые желудю при создании. По умолчанию Неопределено.
+//
+//  Возвращаемое значение:
+//   Произвольный - экземпляр желудя.
+//
 Функция НайтиЖелудь(Имя, ПрилепляемыеЧастицы = Неопределено) Экспорт
 ```
 
 ## НайтиЖелуди
 
 ```bsl
-
+// Находит и возвращает все экземпляры желудей с указанным именем в виде коллекции заданного типа.
+//
+// Параметры:
+//   Имя - Строка - Имя желудей. Имя "Поделка" возвращает сам контекст (только для типа "Массив").
+//   ПрилепляемыеЧастицы - Массив из ПрилепляемаяЧастица - Зависимости, передаваемые желудям при создании. По умолчанию Неопределено.
+//   ТипЖелудя - Строка - Тип возвращаемой коллекции ("Массив", "Соответствие" и т.п.). По умолчанию "Массив".
+//
+//  Возвращаемое значение:
+//   Произвольный - коллекция найденных экземпляров желудей указанного типа.
+//
 Функция НайтиЖелуди(Имя, ПрилепляемыеЧастицы = Неопределено, ТипЖелудя = "Массив") Экспорт
 ```
 
 ## НайтиДетальку
 
 ```bsl
-
+// Возвращает значение детальки (параметра приложения) по её имени.
+//
+// Параметры:
+//   ИмяДетальки - Строка - Имя детальки.
+//   ЗначениеПоУмолчанию - Произвольный - Значение, возвращаемое, если деталька не найдена. По умолчанию Неопределено.
+//
+//  Возвращаемое значение:
+//   Произвольный - значение детальки либо значение по умолчанию.
+//
 Функция НайтиДетальку(ИмяДетальки, ЗначениеПоУмолчанию = Неопределено) Экспорт
 ```
 
 ## ДобавитьЖелудь
 
 ```bsl
-
+// Устарела. Ничего не делает, типы желудей сканируются автоматически.
+//
+// Параметры:
+//   Тип - Тип - Тип добавляемого желудя.
+//   Имя - Строка - Имя желудя. По умолчанию "".
+//
+//  Возвращаемое значение:
+//   Поделка - ЭтотОбъект для построения цепочки вызовов.
+//
 Функция ДобавитьЖелудь(Тип, Имя = "") Экспорт
 ```
 
 ## ДобавитьДуб
 
 ```bsl
-
+// Устарела. Ничего не делает, типы желудей сканируются автоматически.
+//
+// Параметры:
+//   Тип - Тип - Тип добавляемого дуба.
+//
+//  Возвращаемое значение:
+//   Поделка - ЭтотОбъект для построения цепочки вызовов.
+//
 Функция ДобавитьДуб(Тип) Экспорт
 ```
 
 ## ДобавитьНапильник
 
 ```bsl
-
+// Устарела. Ничего не делает, типы желудей сканируются автоматически.
+//
+// Параметры:
+//   Тип - Тип - Тип добавляемого напильника.
+//
+//  Возвращаемое значение:
+//   Поделка - ЭтотОбъект для построения цепочки вызовов.
+//
 Функция ДобавитьНапильник(Тип) Экспорт
 ```
 
 ## ДобавитьЗаготовку
 
 ```bsl
-
+// Устарела. Ничего не делает, типы желудей сканируются автоматически.
+//
+// Параметры:
+//   Тип - Тип - Тип добавляемой заготовки.
+//
+//  Возвращаемое значение:
+//   Поделка - ЭтотОбъект для построения цепочки вызовов.
+//
 Функция ДобавитьЗаготовку(Тип) Экспорт
 ```
 
 ## ДобавитьРогатку
 
 ```bsl
-
+// Устарела. Ничего не делает, типы желудей сканируются автоматически.
+//
+// Параметры:
+//   Тип - Тип - Тип добавляемой рогатки.
+//
+//  Возвращаемое значение:
+//   Поделка - ЭтотОбъект для построения цепочки вызовов.
+//
 Функция ДобавитьРогатку(Тип) Экспорт
 ```
 
 ## ДобавитьАннотацию
 
 ```bsl
-
+// Устарела. Ничего не делает, типы желудей сканируются автоматически.
+//
+// Параметры:
+//   Тип - Тип - Тип добавляемой аннотации.
+//
+//  Возвращаемое значение:
+//   Поделка - ЭтотОбъект для построения цепочки вызовов.
+//
 Функция ДобавитьАннотацию(Тип) Экспорт
 ```
 
 ## ПросканироватьКаталог
 
 ```bsl
-
+// Устарела. Ничего не делает, каталоги сканируются автоматически.
+//
+// Параметры:
+//   Каталог - Строка - Путь к сканируемому каталогу.
+//
+//  Возвращаемое значение:
+//   Поделка - ЭтотОбъект для построения цепочки вызовов.
+//
 Функция ПросканироватьКаталог(Каталог) Экспорт
 ```
 
 ## ДобавитьЗавязь
 
 ```bsl
-
+// Регистрирует завязь (метод-фабрику желудя) на основе переданной лямбды.
+//
+// Параметры:
+//   Лямбда - Строка, Действие - Лямбда или делегат, создающий желудь.
+//   Контекст - Произвольный - Контекст выполнения лямбды. По умолчанию Неопределено.
+//
+//  Возвращаемое значение:
+//   Завязь - созданная завязь.
+//
 Функция ДобавитьЗавязь(Лямбда, Контекст = Неопределено) Экспорт
 ```
 
 ## ЗапуститьПриложение
 
 ```bsl
-
+// Переводит поделку из состояния инициализации в состояние выполнения
+// и запускает желудь "ЗапускательПриложения".
+//
 Процедура ЗапуститьПриложение() Экспорт
 ```