@retailcrm/embed-ui-v1-endpoint 0.9.21 → 0.9.22-alpha.1

package/docs/create-endpoint.md

@@ -1,7 +1,7 @@
 # `createEndpoint`
 
-`createEndpoint` связывает runner и transport (messenger), после чего
-экспортирует endpoint API (`run`, `release`, `reset`) через `@remote-ui/rpc`.
+`createEndpoint` связывает runner и transport (`messenger`) и экспортирует
+endpoint API (`run`, `release`, `reset`) через `@remote-ui/rpc`.
 
 ## Сигнатура
 
@@ -15,15 +15,15 @@ createEndpoint(
 ): Endpoint<RemoteApi>
 ```
 
-## Что делает под капотом
+## Поведение
 
 При `run(...)`:
 
-1. сбрасывает предыдущий mount для того же `id` (widget) или `code` (page),
-2. поднимает remote root (`mountEndpointRoot`),
+1. сбрасывает предыдущее монтирование для того же `id` (widget) или `code` (page),
+2. поднимает endpoint root (`mountEndpointRoot`),
 3. создаёт `pinia` и инжектит endpoint/context accessors,
 4. вызывает нужный runner (`page.run` или `widget.run`),
-5. сохраняет destroy-функцию в registry.
+5. сохраняет destroy-функцию в реестре.
 
 При `release(...)`:
 
@@ -33,7 +33,7 @@ createEndpoint(
 
 - вызывает destroy для всех активных page/widget инстансов.
 
-## Пример (низкоуровневый)
+## Пример
 
 ```ts
 import { defineRunner, createEndpoint } from '@retailcrm/embed-ui-v1-endpoint/remote'
@@ -43,12 +43,10 @@ const runner = defineRunner({
   widgets: [MyWidgetRoot],
 })
 
-// messenger зависит от среды исполнения
 createEndpoint(runner, self as unknown as MessageEndpoint)
 ```
 
 ## Когда нужен именно `createEndpoint`
 
 - Нужна кастомная интеграция transport-слоя.
-- Вы сами контролируете, где и как создаётся `MessageEndpoint`.
-- Нужно использовать endpoint не через стандартный worker-entry сценарий.
+- Нужно использовать endpoint не через стандартную точку входа веб-воркера.

package/docs/define-page-runner.md

@@ -1,6 +1,6 @@
 # `definePageRunner`
 
-`definePageRunner` создаёт runner для remote-страниц.
+`definePageRunner` создаёт runner для встраиваемых страниц.
 При запуске в компонент пробрасывается проп `code`.
 
 ## Перегрузки
@@ -58,5 +58,5 @@ const pageRunner = definePageRunner(PageRoot, async (app, pinia) => {
 
 Читайте также:
 
-- [`page-routes`](./page-routes.md) — как связать page `code`, CRM route и компонент страницы.
-- [`menu-placements`](./menu-placements.md) — как описывать пункты меню, которые открывают remote-страницы.
+- [`page-routes`](./page-routes.md) — как связать page `code`, CRM-маршрут и компонент страницы.
+- [`menu-placements`](./menu-placements.md) — как описывать пункты меню, которые открывают встраиваемые страницы.

package/docs/define-widget-runner.md

@@ -1,6 +1,6 @@
 # `defineWidgetRunner`
 
-`defineWidgetRunner` создаёт runner для remote-виджетов.
+`defineWidgetRunner` создаёт runner для встраиваемых виджетов.
 При запуске в компонент пробрасывается проп `target`.
 
 ## Перегрузки
@@ -47,7 +47,7 @@ const widgetRunner = defineWidgetRunner({
 
 ## `beforeMount`
 
-`beforeMount` работает аналогично page-раннеру: выполняется перед mount и после подключения `pinia`.
+`beforeMount` работает аналогично page-раннеру: выполняется перед монтированием и после подключения `pinia`.
 
 ```ts
 const widgetRunner = defineWidgetRunner(WidgetRoot, async (app, pinia) => {

package/docs/layout.md

@@ -1,14 +1,9 @@
-# Гайд по layout для страниц и связанных экранов
+# Компоновка страниц и связанных экранов
 
-Этот документ собирает в одном месте практические правила по тому, как проектировать
-страницы для `@retailcrm/embed-ui-v1-endpoint`: списки, карточки, страницы с несколькими
-колонками, страницы с collapse-блоками, а также случаи, когда вместо полноценной страницы
-следует использовать `modal sidebar` или `modal window`.
+Практические правила для встраиваемых страниц `@retailcrm/embed-ui-v1-endpoint`: списков,
+карточек, многоколоночных страниц, collapse-страниц, `modal sidebar` и `modal window`.
 
-Это не API-справка по `v1-endpoint`, а UX/layout guide для людей, которые собирают remote-page
-через `definePageRunner(...)` и хотят держаться общего визуального языка CRM.
-
-## Базовая ментальная модель
+## Структура страницы
 
 Обычная страница в CRM чаще всего состоит из таких зон:
 
@@ -18,19 +13,14 @@
 4. Основной контент на белых подложках.
 5. Опционально: нижняя панель сохранения.
 
-Если экран перестаёт быть удобной полноценной страницей, его не следует усложнять бесконечно;
-в этом случае его следует переводить в другой паттерн: `modal sidebar` или `modal window`.
+Если сценарий перестаёт быть удобной полноценной страницей, используйте другой паттерн:
+`modal sidebar` или `modal window`.
 
 ## Термины
 
-В этом документе используются следующие термины:
-
 - `modal sidebar` — боковая выезжающая панель. В разговорной речи может называться “шторкой”.
 - `modal window` — всплывающее модальное окно. В разговорной речи может называться “модалкой”.
-- `страница` — основной route-level экран, который занимает центральную рабочую область CRM.
-
-Далее по тексту предпочтительно используются термины `modal sidebar` и `modal window`, потому что
-они напрямую соотносятся с компонентами `UiModalSidebar`, `UiModalWindow` и `UiModalWindowSurface`.
+- `страница` — основной экран уровня маршрута, который занимает центральную рабочую область CRM.
 
 ## Общие правила
 
@@ -246,10 +236,6 @@
 - Дополнительная информация, которую не хочется разворачивать в отдельную страницу.
 - Сценарии вроде задач, уведомлений, нового обращения, редактирования шага.
 
-### Размеры
-
-- Часто используется одна из двух ширин: `720px` или `416px`.
-
 ### Основные части
 
 1. Закреплённый `header`.
@@ -275,7 +261,8 @@
 - Контент в двух колонках на разных подложках.
 - Громоздкие, большие и сложные интерфейсы.
 
-Если экран фактически превращается в полноценную страницу или большую предметную область, `modal sidebar` уже не является подходящим выбором.
+Если экран превращается в полноценную страницу или большую предметную область, `modal sidebar`
+уже не подходит.
 
 ## 5. Когда вместо страницы нужен `modal window`
 
@@ -283,12 +270,7 @@
 
 - Для отображения большой вспомогательной таблицы “по месту”.
 - Для дополнительных настроек, когда `modal sidebar` уже не хватает.
-- Для сценариев просмотра или выбора, не заслуживающих отдельного route-level экрана.
-
-### Размеры
-
-- Обычный `modal window` шириной около `960px`.
-- Или полноэкранный режим с внешними отступами по краям.
+- Для сценариев просмотра или выбора, не заслуживающих отдельного экрана уровня маршрута.
 
 ### Основные части
 
@@ -328,9 +310,9 @@
 - требуется быстро завершить отдельный шаг без перехода на полноценную страницу;
 - `modal sidebar` уже тесен, но полноценная страница всё ещё избыточна.
 
-## Сопоставление с `embed-ui`
+## Компонентная карта
 
-Ниже не жёсткий contract, а практичное соответствие layout-паттернов библиотечным примитивам:
+Соответствие паттернов компоновки публичным компонентам:
 
 - заголовок страницы: `UiPageHeader`;
 - верхние actions: `UiButton`, `UiToolbarButton`, `UiToolbarLink`;
@@ -341,9 +323,7 @@
 - `modal sidebar`: `UiModalSidebar`;
 - `modal window`: `UiModalWindow` и `UiModalWindowSurface`.
 
-## Чеклист перед реализацией страницы
-
-Перед тем как собирать новый page runner, полезно ответить на несколько вопросов:
+## Чеклист перед реализацией
 
 1. Это действительно страница, а не `modal sidebar` и не `modal window`?
 2. Это список, карточка, карточка с колонками или collapse-настройки?
@@ -352,12 +332,9 @@
 5. Не перегружен ли экран количеством primary-действий?
 6. Держатся ли отступы и расстояния сетки `4px`?
 
-Если на эти вопросы нет уверенного ответа, сначала следует выбрать подходящий layout-паттерн,
-а уже потом собирать компоненты и wiring через `v1-endpoint`.
-
 ---
 
-Примечание: все упоминаемые в этом документе компоненты вида `Ui*` относятся к пакету
+Все упоминаемые компоненты вида `Ui*` относятся к пакету
 `@retailcrm/embed-ui-v1-components`. Термины `modal sidebar`, `modal window`, tabs, collapse-группы,
 таблицы, поля и другие layout-примитивы в этом гайде привязаны именно к публичным компонентам
 из `v1-components`, а не к произвольной внутренней терминологии проекта.

package/docs/menu-placements.md

@@ -1,9 +1,8 @@
 # Меню и точки входа страниц
 
-Этот справочник описывает, как документировать меню и пункты навигации, из которых запускаются
-remote-страницы расширения.
+Справочник для описания меню и пунктов навигации, из которых запускаются встраиваемые страницы расширения.
 
-Важно: `v1-endpoint` не экспортирует типизированный registry CRM-меню. Пакет отвечает за запуск
+`v1-endpoint` не экспортирует типизированный реестр CRM-меню. Пакет отвечает за запуск
 страницы по `code`, а список меню, подпунктов и их видимость задаются на стороне host/manifest
 конкретного расширения.
 
@@ -11,13 +10,13 @@ remote-страницы расширения.
 
 - `menu placement` — зона CRM, куда host добавляет пункт навигации.
 - `menu item` — конкретный пункт меню, который видит пользователь.
-- `page code` — стабильный код remote-страницы, который host передаёт в `definePageRunner`.
-- `route` — маршрут CRM или route name, через который host открывает страницу.
+- `page code` — стабильный код встраиваемой страницы, который host передаёт в `definePageRunner`.
+- `route` — маршрут CRM или имя маршрута, через который host открывает страницу.
 
-`menu item` не равен `target`. Меню открывает полноценную remote-страницу по `code`, а `target`
+`menu item` не равен `target`. Меню открывает полноценную встраиваемую страницу по `code`, а `target`
 используется для виджетов, которые встраиваются внутрь уже существующей CRM-страницы.
 
-## Что нужно фиксировать в справочнике проекта
+## Что фиксировать в справочнике проекта
 
 Для каждого пункта меню указывайте:
 
@@ -26,14 +25,13 @@ remote-страницы расширения.
 | `placement` | Зона CRM, где находится пункт меню. |
 | `item code` | Стабильный код пункта меню в host/manifest. |
 | `label` | Пользовательское название пункта меню. |
-| `page code` | Код remote-страницы, который получит `definePageRunner`. |
-| `route` | Имя или путь CRM-маршрута, если пункт открывается через host routing. |
+| `page code` | Код встраиваемой страницы, который получит `definePageRunner`. |
+| `route` | Имя или путь CRM-маршрута, если пункт открывается через маршрутизацию host-части. |
 | `visibility` | Условия показа: права, настройки, тариф, доступность фичи. |
 
 ## Пример справочника меню
 
-Это пример формата. Конкретные `placement`, `item code` и `route` нужно брать из host/manifest
-расширения.
+Конкретные `placement`, `item code` и `route` нужно брать из host/manifest расширения.
 
 | Placement | Item code | Label | Page code | Route | Когда использовать |
 | --- | --- | --- | --- | --- | --- |
@@ -64,8 +62,8 @@ const pageRunner = definePageRunner({
 
 Читайте также:
 
-- [`page-routes`](./page-routes.md) — как описывать page `code` и CRM route.
-- [`definePageRunner`](./define-page-runner.md) — как remote-страница получает `code`.
+- [`page-routes`](./page-routes.md) — как описывать page `code` и CRM-маршрут.
+- [`definePageRunner`](./define-page-runner.md) — как встраиваемая страница получает `code`.
 - [`targets`](./targets.md) — точки встраивания виджетов, не пунктов меню.
 - [`layout`](./layout.md) — когда делать полноценную страницу, а когда `modal sidebar` или `modal window`.
 - [`UiMenuItem`](../../v1-components/docs/profiles/UiMenuItem.yml) — компонент строки меню внутри UI расширения.

package/docs/page-routes.md

@@ -1,16 +1,15 @@
-# Роуты страниц
+# Маршруты страниц
 
-Remote-страницы в `v1-endpoint` запускаются по `code`. Этот `code` приходит от host и пробрасывается
-в компонент через `definePageRunner`.
+Встраиваемые страницы в `v1-endpoint` запускаются по `code`. Host передаёт `code`, а
+`definePageRunner` пробрасывает его в компонент.
 
-`v1-endpoint` не задаёт фиксированный список page routes. Список страниц и CRM-маршрутов принадлежит
+`v1-endpoint` не задаёт фиксированный список маршрутов страниц. Список страниц и CRM-маршрутов принадлежит
 host/manifest конкретного расширения, поэтому его нужно хранить в справочнике проекта рядом с кодом
 расширения.
 
 ## Что такое `page code`
 
-`page code` — стабильный идентификатор remote-страницы внутри расширения. Он отвечает на вопрос:
-«какую страницу расширения нужно смонтировать?».
+`page code` — стабильный идентификатор встраиваемой страницы внутри расширения.
 
 Пример:
 
@@ -37,11 +36,10 @@ defineProps<{
 
 ## Что такое `route`
 
-`route` — CRM-маршрут или route name, через который host открывает страницу. В remote-коде route
-может использоваться для переходов через `HostApi.goTo(route, params)`.
+`route` — CRM-маршрут или имя маршрута, через который host открывает страницу. В коде расширения
+route может использоваться для переходов через `HostApi.goTo(route, params)`.
 
-Данные Symfony JS router доступны в контексте `settings` в поле `system.routing`. Это полезно,
-когда нужно проверить доступные route names или собрать ссылку тем же routing data, что отдаёт host.
+Данные Symfony JS router доступны в контексте `settings` в поле `system.routing`.
 
 ```ts
 import { useContext as useSettingsContext } from '@retailcrm/embed-ui-v1-contexts/remote/settings'
@@ -51,9 +49,9 @@ const settings = useSettingsContext()
 console.log(settings['system.routing'].routes)
 ```
 
-## Пример справочника роутов страниц
+## Пример справочника маршрутов страниц
 
-Это пример формата. Конкретные `code`, `route` и параметры нужно брать из host/manifest расширения.
+Конкретные `code`, `route` и параметры нужно брать из host/manifest расширения.
 
 | Page code | Route | Params | Открывается из | Компонент |
 | --- | --- | --- | --- | --- |
@@ -61,7 +59,7 @@ console.log(settings['system.routing'].routes)
 | `integration-settings` | `embed.page.integration_settings` | `{}` | `settings / integration-settings` | `IntegrationSettingsPage.vue` |
 | `customer-tools` | `embed.page.customer_tools` | `{ customerId }` | `customer/card:actions / customer-tools` | `CustomerToolsPage.vue` |
 
-## Переход на CRM route
+## Переход на CRM-маршрут
 
 Если странице нужен переход на другой CRM-маршрут, используйте host API, а не прямую сборку URL.
 Способ получения `HostApi` зависит от host-интеграции проекта, но сам публичный контракт выглядит так:
@@ -76,7 +74,7 @@ const openSettings = (host: HostApi) => {
 
 Читайте также:
 
-- [`menu-placements`](./menu-placements.md) — как связать пункт меню, page `code` и route.
+- [`menu-placements`](./menu-placements.md) — как связать пункт меню, page `code` и маршрут.
 - [`definePageRunner`](./define-page-runner.md) — как page `code` попадает в компонент.
 - [`settings context`](../../v1-contexts/docs/ru/CONCEPT.md) — общий принцип работы контекстов.
 - [`HostApi`](../../v1-types/host.d.ts) — публичный тип host API с `goTo`.

package/docs/run-endpoint.md

@@ -1,6 +1,6 @@
 # `runEndpoint`
 
-`runEndpoint` — shortcut для worker entry:
+`runEndpoint` — краткая форма для точки входа веб-воркера:
 он вызывает `createEndpoint(runner, self as Worker)`.
 
 ## Сигнатура
@@ -28,10 +28,10 @@ runEndpoint(runner)
 
 ## Когда использовать
 
-- Почти всегда, если endpoint запускается как web worker.
+- Почти всегда, если endpoint запускается как веб-воркер.
 - Когда не нужен ручной контроль над messenger/transport.
 
 ## Когда лучше `createEndpoint`
 
-- Когда transport создаётся не от `self` worker.
-- Когда у вас кастомный runtime/bridge между host и remote.
+- Когда transport создаётся не от `self` веб-воркера.
+- Когда у вас кастомная среда выполнения или bridge между host и remote.

package/docs/targets/customer-card-communications-after.yml

@@ -0,0 +1,48 @@
+target: "customer/card:communications.after"
+summary: >
+  Widget for enhancing the communication section in the left column of the customer page. It is placed in the customer card: Right below the short summary, in the communication section.
+language: en-GB
+audience: ai
+
+public_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/common"
+  named:
+    - targets
+    - TargetName
+
+runner_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/remote/widgets"
+  named:
+    - defineWidgetRunner
+    - defineMultiRunner
+
+page:
+  id: "customer/card"
+  label: "customer card"
+  area: "communications.after"
+
+description: "Widget for enhancing the communication section in the left column of the customer page."
+location: "Right below the short summary, in the communication section"
+
+target_config:
+  contexts:
+    - "customer/card"
+    - "user/current"
+    - "settings"
+  custom_contexts:
+    - "customer"
+  action_scopes: []
+
+use_when:
+  - "Place a widget exactly at customer/card:communications.after."
+  - "The widget belongs to the customer card and should appear at this location: Right below the short summary, in the communication section."
+  - "The widget can work with the contexts listed in target_config.contexts."
+
+avoid_when:
+  - "The widget belongs to a different page, section, or field-level insertion point."
+  - "The widget requires contexts, custom contexts, or action scopes that are not listed in target_config."
+
+ai_notes:
+  - "Use the target id as the runner registration key."
+  - "Use targets[target].contexts as the source of truth for context availability."
+  - "Do not duplicate target context lists in generated widget code."

package/docs/targets/customer-card-inwork-after.yml

@@ -0,0 +1,48 @@
+target: "customer/card:inWork.after"
+summary: >
+  Widget for the contact request item. It is placed in the customer card: At the end of the "In progress" block in the client card.
+language: en-GB
+audience: ai
+
+public_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/common"
+  named:
+    - targets
+    - TargetName
+
+runner_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/remote/widgets"
+  named:
+    - defineWidgetRunner
+    - defineMultiRunner
+
+page:
+  id: "customer/card"
+  label: "customer card"
+  area: "inWork.after"
+
+description: "Widget for the contact request item"
+location: "At the end of the \"In progress\" block in the client card"
+
+target_config:
+  contexts:
+    - "customer/card"
+    - "user/current"
+    - "settings"
+  custom_contexts:
+    - "customer"
+  action_scopes: []
+
+use_when:
+  - "Place a widget exactly at customer/card:inWork.after."
+  - "The widget belongs to the customer card and should appear at this location: At the end of the \"In progress\" block in the client card."
+  - "The widget can work with the contexts listed in target_config.contexts."
+
+avoid_when:
+  - "The widget belongs to a different page, section, or field-level insertion point."
+  - "The widget requires contexts, custom contexts, or action scopes that are not listed in target_config."
+
+ai_notes:
+  - "Use the target id as the runner registration key."
+  - "Use targets[target].contexts as the source of truth for context availability."
+  - "Do not duplicate target context lists in generated widget code."

package/docs/targets/customer-card-inwork-before.yml

@@ -0,0 +1,48 @@
+target: "customer/card:inWork.before"
+summary: >
+  Widget for the contact request item. It is placed in the customer card: At the beginning of the "In Progress" block in the client card.
+language: en-GB
+audience: ai
+
+public_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/common"
+  named:
+    - targets
+    - TargetName
+
+runner_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/remote/widgets"
+  named:
+    - defineWidgetRunner
+    - defineMultiRunner
+
+page:
+  id: "customer/card"
+  label: "customer card"
+  area: "inWork.before"
+
+description: "Widget for the contact request item"
+location: "At the beginning of the \"In Progress\" block in the client card"
+
+target_config:
+  contexts:
+    - "customer/card"
+    - "user/current"
+    - "settings"
+  custom_contexts:
+    - "customer"
+  action_scopes: []
+
+use_when:
+  - "Place a widget exactly at customer/card:inWork.before."
+  - "The widget belongs to the customer card and should appear at this location: At the beginning of the \"In Progress\" block in the client card."
+  - "The widget can work with the contexts listed in target_config.contexts."
+
+avoid_when:
+  - "The widget belongs to a different page, section, or field-level insertion point."
+  - "The widget requires contexts, custom contexts, or action scopes that are not listed in target_config."
+
+ai_notes:
+  - "Use the target id as the runner registration key."
+  - "Use targets[target].contexts as the source of truth for context availability."
+  - "Do not duplicate target context lists in generated widget code."

package/docs/targets/customer-card-phone.yml

@@ -0,0 +1,49 @@
+target: "customer/card:phone"
+summary: >
+  Widget for customer phone list item. It is placed in the customer card: Right after the phone number in the list.
+language: en-GB
+audience: ai
+
+public_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/common"
+  named:
+    - targets
+    - TargetName
+
+runner_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/remote/widgets"
+  named:
+    - defineWidgetRunner
+    - defineMultiRunner
+
+page:
+  id: "customer/card"
+  label: "customer card"
+  area: "phone"
+
+description: "Widget for customer phone list item"
+location: "Right after the phone number in the list"
+
+target_config:
+  contexts:
+    - "customer/card"
+    - "customer/card:phone"
+    - "user/current"
+    - "settings"
+  custom_contexts:
+    - "customer"
+  action_scopes: []
+
+use_when:
+  - "Place a widget exactly at customer/card:phone."
+  - "The widget belongs to the customer card and should appear at this location: Right after the phone number in the list."
+  - "The widget can work with the contexts listed in target_config.contexts."
+
+avoid_when:
+  - "The widget belongs to a different page, section, or field-level insertion point."
+  - "The widget requires contexts, custom contexts, or action scopes that are not listed in target_config."
+
+ai_notes:
+  - "Use the target id as the runner registration key."
+  - "Use targets[target].contexts as the source of truth for context availability."
+  - "Do not duplicate target context lists in generated widget code."

package/docs/targets/order-card-comment-manager-before.yml

@@ -0,0 +1,51 @@
+target: "order/card:comment.manager.before"
+summary: >
+  Widget for the block "Manager comment". It is placed in the full order form: Section start, right above the input field.
+language: en-GB
+audience: ai
+
+public_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/common"
+  named:
+    - targets
+    - TargetName
+
+runner_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/remote/widgets"
+  named:
+    - defineWidgetRunner
+    - defineMultiRunner
+
+page:
+  id: "order/card"
+  label: "full order form"
+  area: "comment.manager.before"
+
+description: "Widget for the block \"Manager comment\""
+location: "Section start, right above the input field"
+
+target_config:
+  contexts:
+    - "order/card"
+    - "order/card:settings"
+    - "user/current"
+    - "settings"
+  custom_contexts:
+    - "order"
+  action_scopes:
+    - "order/card"
+
+use_when:
+  - "Place a widget exactly at order/card:comment.manager.before."
+  - "The widget belongs to the full order form and should appear at this location: Section start, right above the input field."
+  - "The widget can work with the contexts listed in target_config.contexts."
+
+avoid_when:
+  - "The widget belongs to a different page, section, or field-level insertion point."
+  - "The widget requires contexts, custom contexts, or action scopes that are not listed in target_config."
+
+ai_notes:
+  - "Use the target id as the runner registration key."
+  - "Use targets[target].contexts as the source of truth for context availability."
+  - "Do not duplicate target context lists in generated widget code."
+  - "Order card and chat order form targets share the same order form data contract."

package/docs/targets/order-card-common-after.yml

@@ -0,0 +1,51 @@
+target: "order/card:common.after"
+summary: >
+  Widget for the section with common data. It is placed in the full order form: Section end, right under the input fields.
+language: en-GB
+audience: ai
+
+public_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/common"
+  named:
+    - targets
+    - TargetName
+
+runner_import:
+  from: "@retailcrm/embed-ui-v1-endpoint/remote/widgets"
+  named:
+    - defineWidgetRunner
+    - defineMultiRunner
+
+page:
+  id: "order/card"
+  label: "full order form"
+  area: "common.after"
+
+description: "Widget for the section with common data"
+location: "Section end, right under the input fields"
+
+target_config:
+  contexts:
+    - "order/card"
+    - "order/card:settings"
+    - "user/current"
+    - "settings"
+  custom_contexts:
+    - "order"
+  action_scopes:
+    - "order/card"
+
+use_when:
+  - "Place a widget exactly at order/card:common.after."
+  - "The widget belongs to the full order form and should appear at this location: Section end, right under the input fields."
+  - "The widget can work with the contexts listed in target_config.contexts."
+
+avoid_when:
+  - "The widget belongs to a different page, section, or field-level insertion point."
+  - "The widget requires contexts, custom contexts, or action scopes that are not listed in target_config."
+
+ai_notes:
+  - "Use the target id as the runner registration key."
+  - "Use targets[target].contexts as the source of truth for context availability."
+  - "Do not duplicate target context lists in generated widget code."
+  - "Order card and chat order form targets share the same order form data contract."