@retailcrm/embed-ui-v1-endpoint 0.9.25 → 0.9.26

package/docs/define-page-runner.md

@@ -45,6 +45,22 @@ const pageRunner = definePageRunner({
 
 Если для `code` нет раннера, будет warning в консоль и noop-destroy.
 
+## Runtime-проверка страницы
+
+После первого минимального vertical slice проверяйте страницу внутри CRM host, а не только через build/lint.
+
+Минимальный чек:
+
+- manifest или publish payload содержит page descriptor object с `code`, `menu`, `menuItemTitle` и нужной
+  hierarchy metadata;
+- `code` в `pages[]` совпадает с ключом runner map в `definePageRunner`;
+- локальный dev server отдает `entrypoint` и `stylesheet` URL, которые указаны в extension config;
+- пункт меню появился в CRM и открывает route `/modules/<module-code>/<page-code>`;
+- frontend реально смонтировался в CRM host.
+
+Если ошибка видна только в minified bundle, соберите или отдайте dev bundle без минификации до изменения кода
+по догадке.
+
 ## `beforeMount`
 
 `beforeMount` вызывается после `app.use(pinia)` и до `app.mount(...)`.

package/docs/menu-placements.md

@@ -61,6 +61,10 @@
 `menu: "private_main_menu"` и `parentMenuItemCode: "settings"`. Для страниц в разделе продаж используйте
 `menu: "activity_main_menu"` и соответствующий parent menu item, например `orders`.
 
+CRM также использует hierarchy из `pages[]` для видимой навигации и breadcrumb-like поведения. Сначала
+моделируйте нужную иерархию через `menu`, `parentMenuItemCode` и `menuItemOrdering`; локальные ссылки внутри
+страницы добавляйте только для дополнительной in-page navigation.
+
 ## Payload публикации
 
 При обновлении уже установленного расширения синхронизируйте существующий integration module через
@@ -130,6 +134,11 @@ const pageRunner = definePageRunner({
 Если host откроет страницу с `code`, которого нет в runner map, `definePageRunner` запишет warning
 в консоль и не смонтирует страницу.
 
+После изменения меню или pages manifest проверьте локальную CRM установку: пункт меню должен появиться,
+route `/modules/<module-code>/<page-code>` должен открываться, а `entrypoint` и `stylesheet` из extension
+config должны отдаваться локальным dev server. При runtime-ошибках в minified bundle сначала включите dev
+bundle или sourcemaps.
+
 Читайте также:
 
 - [`page-routes`](./page-routes.md) — как описывать page `code` и CRM-маршрут.

package/docs/page-routes.md

@@ -12,6 +12,10 @@ page `code` нужно описывать объектом manifest `pages[]` с
 строковую форму `pages: ["orders-dashboard"]` для публикации через RetailCRM API: backend ожидает
 `ConfigurationPage` object, а страница без `menu` не откроется по route `/modules/<module-code>/<page-code>`.
 
+Build/lint успех не доказывает, что страница откроется в CRM. После добавления новой страницы проверьте
+runtime lifecycle в host: page descriptor, menu item, route `/modules/<module-code>/<page-code>`,
+доступность `entrypoint` и `stylesheet`, и фактический mount frontend-кода.
+
 ## Что такое `page code`
 
 `page code` — стабильный идентификатор встраиваемой страницы внутри расширения.
@@ -94,6 +98,10 @@ const openSettings = (host: HostApi) => {
 }
 ```
 
+Breadcrumb-like navigation для module pages строится CRM из hierarchy в `pages[]`: `menu`,
+`parentMenuItemCode`, `menuItemOrdering` и связанных metadata. Не собирайте breadcrumbs вручную внутри
+страницы, если продуктовая задача явно не просит локальную in-page navigation.
+
 Читайте также:
 
 - [`menu-placements`](./menu-placements.md) — как связать пункт меню, page `code` и маршрут.

package/package.json

@@ -5,7 +5,7 @@
     "embed-ui-v1-endpoint-mcp": "bin/embed-ui-v1-endpoint-mcp.mjs"
   },
   "type": "module",
-  "version": "0.9.25",
+  "version": "0.9.26",
   "description": "Endpoint API for integrations in RetailCRM",
   "license": "MIT",
   "author": "RetailDriverLLC <integration@retailcrm.ru>",
@@ -101,17 +101,17 @@
   "peerDependencies": {
     "@omnicajs/vue-remote": "^0.2.24",
     "@remote-ui/rpc": "^1.4",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.25",
-    "@retailcrm/embed-ui-v1-types": "^0.9.25",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.26",
+    "@retailcrm/embed-ui-v1-types": "^0.9.26",
     "pinia": "^2.2",
     "vue": "^3.5"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@remote-ui/rpc": "^1.4.7",
-    "@retailcrm/embed-ui-v1-components": "^0.9.25",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.25",
-    "@retailcrm/embed-ui-v1-types": "^0.9.25"
+    "@retailcrm/embed-ui-v1-components": "^0.9.26",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.26",
+    "@retailcrm/embed-ui-v1-types": "^0.9.26"
   },
   "devDependencies": {
     "@retailcrm/image-preview": "^1.0.2",

package/templates/skills/embed-ui-v1-endpoint-runtime/SKILL.md.txt

@@ -29,6 +29,8 @@ Use this skill before changing JS module endpoint wiring, page registration, wid
 3. For widgets, choose the exact target from endpoint docs or MCP resources before writing UI.
 4. Use documented public entrypoints such as `@retailcrm/embed-ui-v1-endpoint/remote`; do not import from `dist/*`, source files, or repository-only paths.
 5. Keep widget inline UI compact; use component package widget composition guidance for UI mounted into CRM targets.
+6. After the first page vertical slice, verify it in the CRM host: menu item, `/modules/<moduleCode>/<pageCode>` route, entrypoint URL, stylesheet URL, and actual frontend mount.
+7. If a runtime error appears only in a minified bundle, switch to a dev bundle or sourcemaps before guessing.
 
 ## Page and menu checks
 
@@ -37,6 +39,7 @@ Use this skill before changing JS module endpoint wiring, page registration, wid
 - Use `parentMenuItemCode` and `menuItemOrdering` to model the intended CRM page/menu hierarchy.
 - Breadcrumb-like navigation is derived by CRM from the page/menu hierarchy passed in the extension config; do not hand-roll breadcrumbs in the page unless the product task explicitly asks for local in-page navigation.
 - For updating an already installed module, use the existing integration module edit/update flow and put pages under `integrationModule.integrations.embedJs.pages`.
+- Build/lint success does not prove page rendering; check the installed module in the CRM host when page routing or menu placement changed.
 
 ## Host API checks