@retailcrm/embed-ui 0.9.28 → 0.9.30-alpha.1

package/CHANGELOG.md

@@ -1,6 +1,17 @@
 # Changelog
 
+## 0.9.30-alpha.1
 
+### Features
+
+* **v1-components:** Added v1-sandbox ([7530f77](https://github.com/retailcrm/embed-ui/commit/7530f77f5cec41c154c2f8992cb39ab02d3c2cc4))
+* **v1-sandbox:** Created v1-sandbox for embed-ui ([f337c9d](https://github.com/retailcrm/embed-ui/commit/f337c9dd257ae87cec23ea4edefc41a8ba099c45))
+
+## [0.9.29](https://github.com/retailcrm/embed-ui/compare/v0.9.28...v0.9.29) (2026-06-10)
+
+### Bug Fixes
+
+* **v1-components:** UiButton link hover styles preserved ([3463e58](https://github.com/retailcrm/embed-ui/commit/3463e58fa78201da48262f937ac78556a989f155))
 ## [0.9.28](https://github.com/retailcrm/embed-ui/compare/v0.9.27...v0.9.28) (2026-06-05)
 
 ### Features
@@ -967,3 +978,4 @@ order.templates.number.crm из контекста settings
 ### Features
 
 * Added basic types ([6bb2706](https://github.com/retailcrm/embed-ui/commit/6bb27060b3a9eca281865029e1688e44117f03f7))
+

package/README.md

@@ -11,6 +11,8 @@ API и компоненты для создания расширений инт
 - `v1-components` — UI-компоненты и сопутствующая документация, [README.md пакета](./packages/v1-components/README.md).
 - `v1-contexts` — реактивные контексты и доступ к данным RetailCRM JS API, [README.md пакета](./packages/v1-contexts/README.md).
 - `v1-endpoint` — endpoint API для встраиваемых страниц и виджетов, [README.md пакета](./packages/v1-endpoint/README.md).
+- `v1-sandbox` — песочница для запуска и тестирования JS-расширений вне CRM,
+  [README.md пакета](./packages/v1-sandbox/README.md).
 - `v1-testing` — тестовые утилиты и вспомогательные типы для интеграций, [README.md пакета](./packages/v1-testing/README.md).
 - `v1-types` — базовые type declarations для публичного API, [README.md пакета](./packages/v1-types/README.md).
 
@@ -83,16 +85,28 @@ npx @retailcrm/embed-ui init ./web --cwd ./my-project --package-manager npm
 - `--version 0.9.21` — использовать указанную версию пакетов вместо версии запущенного CLI.
 - `--exact` — записывать точные версии вместо диапазонов.
 - `--packages embed-ui,components,contexts,types,endpoint` — явно выбрать пакеты для установки и настройки.
+- `--with components,endpoint` — добавить опубликованные пакеты к стандартному набору `init`.
+- `--package-manager yarn|npm|pnpm|bun` — явно выбрать package manager для установки.
+- `--src-dir ./frontend` — задать frontend source root относительно корня проекта.
+- `--dirs endpoint,pages,widgets,shared,i18n` — задать набор стартовых каталогов; дополнительно поддерживаются `src` и `tests`.
+- `--no-dirs` — не создавать стартовые каталоги.
+- `--template order-card` — выбрать стартовый шаблон; сейчас поддерживается `order-card`.
+- `--page-code settings` — задать код стартовой embedded-страницы.
+- `--widget-target order/card:common.after` — задать стартовый target виджета.
+- `--force` — включить общий force-режим для управляемых файлов, hook-команд и install.
 - `--force-deps` — заменить несовместимые версии зависимостей.
 - `--fix-sections` — перенести зависимости в ожидаемые секции `dependencies`/`devDependencies`.
 - `--force-files` — перезаписать генерируемые стартовые файлы.
 - `--no-configs` — не создавать `tsconfig.json`, `vite.config.ts`, `eslint.config.js` и `env.d.ts`.
 - `--no-template` — не создавать стартовые Vue-файлы и `extensionrc.json`.
 - `--no-agents` — не создавать и не дополнять `AGENTS.md`.
+- `--force-agents` — обновить управляемую секцию `AGENTS.md` и прокинуть `--force` в package-level agent hooks.
+- `--agents-only` — установить только agent-инструкции, без изменения зависимостей, шаблонов, skills и MCP.
 - `--no-skills` — не создавать и не обновлять project-level skills в `.agents/skills/*`.
 - `--force-skills` — обновить уже существующие управляемые project-level skills.
 - `--skills-only` — установить только project-level skills, без изменения зависимостей, шаблонов и `AGENTS.md`.
 - `--no-mcp` — не добавлять MCP-настройки пакетов.
+- `--force-mcp` — прокинуть `--force` в package-level MCP config hooks.
 - `--mcp-client-configs codex,cursor,junie,vscode` — дополнительно создать project-level конфиги поддерживаемых AI-клиентов.
 - `--git` — выполнить `git init` в корне проекта, если каталог еще не является Git-репозиторием.
 

package/bin/embed-ui.mjs

@@ -25,18 +25,32 @@ Options:
       --dry-run           Show changes without writing package.json
       --add               Add selected embed-ui packages into one package.json
       --packages <list>   Comma-separated package ids or names for --add/init
+      --with <list>       Additional published package ids or names for init
       --cwd <path>        Project working directory for init
       --package-manager   Package manager for init installs
+      --dirs <list>       Comma-separated starter directory presets for init
+      --src-dir <path>    Frontend source root relative to cwd
+      --template <name>   Starter template name
+      --page-code <code>  Starter embedded page code
+      --widget-target <target> Starter widget target
       --interactive       Ask init questions with TTY selection prompts
       --verbose           Print detailed init change lists
       --no-install        Do not run package manager install in init mode
       --no-configs        Do not create root TypeScript, Vite, ESLint and env config files
+      --no-dirs           Do not create starter directories in init mode
+      --no-template       Do not create starter template files in init mode
+      --force             Force managed init writes, hooks, and install
       --force-deps        Replace incompatible existing init dependencies
       --fix-sections      Move init dependencies to expected package.json sections
+      --force-files       Overwrite generated starter files in init mode
       --no-agents         Do not create or update AGENTS.md in init mode
+      --force-agents      Force AGENTS.md section and package agent hook updates
+      --agents-only       Install only project-level agent instructions
       --no-skills         Do not create or update .agents/skills in init mode
+      --force-skills      Force project-level skill hook updates
       --skills-only       Install only project-level skills
       --no-mcp            Do not add package MCP instructions in init mode
+      --force-mcp         Force package MCP config hook updates
       --mcp-client-configs Comma-separated project-level MCP client configs to create (codex,cursor,junie,vscode)
       --git               Initialize Git repository in init mode when cwd is not a Git work tree
   -h, --help              Show this help
@@ -251,7 +265,7 @@ const TARGET_SECTIONS = [
   "optionalDependencies"
 ];
 const ROOT_PACKAGE = "@retailcrm/embed-ui";
-const DEFAULT_INIT_PACKAGE_IDS = ["embed-ui", "components", "contexts", "types", "endpoint"];
+const DEFAULT_INIT_PACKAGE_IDS = ["embed-ui", "components", "contexts", "types", "endpoint", "sandbox"];
 const INSTALLABLE_PACKAGES = [
   {
     id: "embed-ui",
@@ -346,6 +360,26 @@ const INSTALLABLE_PACKAGES = [
         requiresMcp: true
       }
     ]
+  },
+  {
+    id: "sandbox",
+    name: "@retailcrm/embed-ui-v1-sandbox",
+    section: "dependencies",
+    description: "Песочница и тестовый стек для проверки расширений без CRM.",
+    hooks: [
+      {
+        type: "agents",
+        binName: "embed-ui-v1-sandbox",
+        command: "init-agents",
+        failureMode: "advisory"
+      },
+      {
+        type: "config",
+        binName: "embed-ui-v1-sandbox",
+        command: "init-env",
+        failureMode: "advisory"
+      }
+    ]
   }
 ];
 const resolveLatestVersion = () => {
@@ -529,18 +563,26 @@ const INIT_DEV_DEPENDENCIES = [
   { name: "@intlify/eslint-plugin-vue-i18n", range: "^4.4" },
   { name: "@intlify/unplugin-vue-i18n", range: "^11.2" },
   { name: "@omnicajs/eslint-plugin-dependencies", range: "^0.0.2" },
+  { name: "@playwright/test", range: "^1.58" },
+  { name: "@testing-library/dom", range: "^10.4" },
   { name: "@types/node", range: "^22.19" },
   { name: "@vitejs/plugin-vue", range: "^6.0" },
+  { name: "@vitest/browser", range: "^4.1" },
+  { name: "@vitest/browser-playwright", range: "^4.1" },
   { name: "@vue/language-server", range: "^3.2" },
+  { name: "dotenv", range: "^17.4" },
   { name: "eslint", range: "^9.39" },
   { name: "eslint-plugin-vue", range: "^10.9" },
   { name: "globals", range: "^16.5" },
+  { name: "jsdom", range: "^27.3" },
   { name: "jsonc-eslint-parser", range: "^3.1" },
   { name: "less", range: "^4.6" },
+  { name: "playwright", range: "^1.58" },
   { name: "typescript", range: "^5.9" },
   { name: "typescript-eslint", range: "^8.59" },
   { name: "vite", range: "^7.3" },
   { name: "vite-svg-loader", range: "^5.1" },
+  { name: "vitest", range: "^4.1" },
   { name: "vue-eslint-parser", range: "^10.4" },
   { name: "yaml-eslint-parser", range: "^2.0" }
 ];
@@ -982,7 +1024,7 @@ const applyInitPackageConfigHooks = async (cwd, selectedPackages, packageManager
         continue;
       }
       const args = [hook.command, cwd];
-      if (hook.requiresMcp && (options.force || options.forceMcp)) {
+      if (options.force || hook.requiresMcp && options.forceMcp) {
         args.push("--force");
       }
       if (hook.requiresMcp && options.mcpClientConfigs?.length) {
@@ -1012,11 +1054,27 @@ const CONFIG_FILES = [
   "vite.config.ts",
   "vite.config.js",
   "vite.config.mts",
+  "vitest.config.ts",
+  "vitest.config.browser.ts",
+  "vitest.config.playwright.ts",
   "eslint.config.js",
   "eslint.config.mjs",
   "env.d.ts"
 ];
-const SCRIPT_NAMES = ["build", "dev", "eslint", "eslint:fix", "lint", "test"];
+const SCRIPT_NAMES = [
+  "build",
+  "dev",
+  "eslint",
+  "eslint:fix",
+  "lint",
+  "sandbox:serve",
+  "serve:extension",
+  "test",
+  "test:browser",
+  "test:browsers:install",
+  "test:e2e",
+  "test:unit"
+];
 const VITE_CONFIG_FILES = [
   "vite.config.ts",
   "vite.config.js",
@@ -1046,6 +1104,18 @@ const TEMPLATE_FILE_IMPACTS = [
   {
     relativePath: "i18n/locales/en-GB.json",
     impact: "starter English locale messages will not be generated"
+  },
+  {
+    relativePath: "sandbox/tests/unit/extensionrc.test.ts",
+    impact: "starter unit test will not be generated"
+  },
+  {
+    relativePath: "sandbox/tests/browser/starter.browser.test.ts",
+    impact: "starter browser test will not be generated"
+  },
+  {
+    relativePath: "sandbox/tests/e2e/starter.e2e.ts",
+    impact: "starter e2e test will not be generated"
   }
 ];
 const hasEnabledMcpConfigHook = (selectedPackages, options) => !options.noMcp && selectedPackages.some(
@@ -1246,7 +1316,7 @@ const analyzeTemplateFileSkips = (cwd, sourceRoot, options, changes) => {
       changes.warnings.push(`${path.join(getSourceRootRelative(cwd, sourceRoot), relativePath)} already exists; ${impact}`);
     }
   }
-  for (const relativePath of ["extensionrc.json", "scripts/publish-extension.mjs", "README.md"]) {
+  for (const relativePath of ["extensionrc.json", "scripts/publish-extension.mjs", "scripts/serve-extension.mjs", "README.md"]) {
     if (fs.existsSync(path.join(cwd, relativePath))) {
       changes.warnings.push(`${relativePath} already exists; generated project-level starter file will be skipped`);
     }
@@ -1715,6 +1785,7 @@ const saveWindow = () => {
 }
 </style>
 `;
+const playwrightConfigTemplate = "import fs from 'node:fs'\nimport path from 'node:path'\n\nimport dotenv from 'dotenv'\n\nimport { defineConfig, devices } from '@playwright/test'\n\ndotenv.config({ path: path.resolve(process.cwd(), '.env.sandbox') })\n\nconst sandboxBaseURL = process.env.SANDBOX_BASE_URL || 'http://127.0.0.1:4173'\nconst extensionBaseURL = process.env.SANDBOX_EXTENSION_URL || 'http://127.0.0.1:4175/extension/'\nconst extensionrc = JSON.parse(\n  fs.readFileSync(path.resolve(process.cwd(), 'extensionrc.json'), 'utf8')\n) as { uuid: string }\nconst extensionURL = new URL(extensionrc.uuid, extensionBaseURL).href\n\nexport default defineConfig({\n  testDir: './__SOURCE_ROOT__/sandbox/tests/e2e',\n  testMatch: '**/*.e2e.ts',\n  fullyParallel: true,\n  forbidOnly: !!process.env.CI,\n  retries: process.env.CI ? 2 : 0,\n  workers: process.env.CI ? 1 : undefined,\n  reporter: 'html',\n  outputDir: 'artifacts/playwright/results',\n  use: {\n    baseURL: sandboxBaseURL,\n    screenshot: 'only-on-failure',\n    trace: 'on-first-retry',\n  },\n  projects: [\n    {\n      name: 'chromium',\n      use: { ...devices['Desktop Chrome'] },\n    },\n  ],\n  webServer: [\n    {\n      command: '__PACKAGE_MANAGER_RUN__ sandbox:serve',\n      url: sandboxBaseURL,\n      reuseExistingServer: !process.env.CI,\n    },\n    {\n      command: '__PACKAGE_MANAGER_RUN__ build && __PACKAGE_MANAGER_RUN__ serve:extension',\n      url: extensionURL,\n      reuseExistingServer: !process.env.CI,\n    },\n  ],\n})\n";
 const publishScriptTemplate = `#!/usr/bin/env node
 
 import { fileURLToPath } from 'node:url'
@@ -2083,9 +2154,448 @@ try {
   process.exit(1)
 }
 `;
-const readmeEnGBTemplate = "# RetailCRM extension frontend\n\nThis project was generated by `embed-ui init`.\n\n## What Was Added\n\n- `package.json` with scripts for Vite build, ESLint, and extension publishing.\n- `extensionrc.json` with the generated extension manifest source.\n- `__SOURCE_ROOT__/endpoint/endpoint.worker.ts` with `defineRunner`, one page runner, and one widget runner.\n- `__SOURCE_ROOT__/pages/SettingsPage.vue` as a starter settings page.\n- `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue` as a starter order widget.\n- `__SOURCE_ROOT__/i18n/` with shared JSON message files.\n- `scripts/publish-extension.mjs` for creating `dist/extension.zip` and publishing the integration module through RetailCRM API.\n- `AGENTS.md` when agent instructions were enabled during init.\n\n## Replace Generic Values\n\nReview these generated placeholders before using the project in a real integration:\n\n- Extension code in `extensionrc.json`: `retailcrm-extension-frontend`.\n- Extension name in `extensionrc.json`: `RetailCRM Extension Frontend`.\n- Page code: `__PAGE_CODE__`.\n- Page descriptor in `extensionrc.json`: keep `pages[]` as an object with `code`, `menu`, and `menuItemTitle`; string page form is not valid for RetailCRM API publishing.\n- Widget target: `__WIDGET_TARGET__`.\n- Sample controls and fake data in `__SOURCE_ROOT__/pages/SettingsPage.vue`.\n- Sample toolbar actions and fake order data in `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue`.\n- Shared messages in `__SOURCE_ROOT__/i18n/locales/*.json`.\n\nThe generated page and widget are intentionally generic. Keep the structure you need, but replace the sample labels, fields, and fake data with real product behavior.\n\n## Vue File Names\n\n`SettingsPage.vue` and `OrderCommonAfterWidget.vue` are generic starter names. In product code, rename Vue files after the role they play in the extension, and update imports in `__SOURCE_ROOT__/endpoint/endpoint.worker.ts`.\n\nExamples from RetailCRM extension examples:\n\n- `ReturnsPage.vue` is a full returns-management page.\n- `TasksPage.vue` is a task list/workspace page.\n- `SummaryPage.vue` is a summary dashboard page.\n- `RecordToCalendlyWidget.vue` is a focused widget for one scenario.\n\nUse the same idea for your code: `LoyaltySettingsPage.vue`, `OrderNotesWidget.vue`, `PaymentStatusSidebar.vue`, or another name that describes the real scenario.\n\n## Commands\n\n```bash\n__PACKAGE_MANAGER__ install\n__PACKAGE_MANAGER_RUN__ eslint\n__PACKAGE_MANAGER_RUN__ build\n__PACKAGE_MANAGER_RUN__ publish-extension -- --archive-only\n```\n\n## Publishing\n\nCreate `.env` in the project root when you want `publish-extension` to update RetailCRM:\n\n```dotenv\nCRM_API_HOST=https://example.retailcrm.pro\nCRM_API_KEY=your-api-key\nMODULE_URL=https://example.com\n```\n\nRun `__PACKAGE_MANAGER_RUN__ build` before publishing. The archive-only mode creates `dist/extension.zip` without sending API requests.\n\nFor local CRM checks, `MODULE_URL` must point to a dev/static server that serves\n`/extension/<uuid>/script` and `/extension/<uuid>/stylesheet`. `publish-extension` registers these URLs in CRM,\nbut it does not start that server.\n";
-const readmeEsESTemplate = "# Frontend de extension RetailCRM\n\nEste proyecto fue generado por `embed-ui init`.\n\n## Que Se Agrego\n\n- `package.json` con scripts para Vite build, ESLint y publicacion de la extension.\n- `extensionrc.json` con la fuente del manifiesto de la extension.\n- `__SOURCE_ROOT__/endpoint/endpoint.worker.ts` con `defineRunner`, un runner de pagina y un runner de widget.\n- `__SOURCE_ROOT__/pages/SettingsPage.vue` como pagina inicial de configuracion.\n- `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue` como widget inicial del pedido.\n- `__SOURCE_ROOT__/i18n/` con archivos JSON de mensajes compartidos.\n- `scripts/publish-extension.mjs` para crear `dist/extension.zip` y publicar el modulo de integracion por RetailCRM API.\n- `AGENTS.md` si las instrucciones para agentes estaban activadas durante init.\n\n## Sustituya Los Valores Genericos\n\nRevise estos valores generados antes de usar el proyecto en una integracion real:\n\n- Codigo de extension en `extensionrc.json`: `retailcrm-extension-frontend`.\n- Nombre de extension en `extensionrc.json`: `RetailCRM Extension Frontend`.\n- Codigo de pagina: `__PAGE_CODE__`.\n- Descriptor de pagina en `extensionrc.json`: mantenga `pages[]` como objeto con `code`, `menu` y `menuItemTitle`; la forma de cadena no sirve para publicar por la API RetailCRM.\n- Target del widget: `__WIDGET_TARGET__`.\n- Controles de ejemplo y datos ficticios en `__SOURCE_ROOT__/pages/SettingsPage.vue`.\n- Acciones toolbar de ejemplo y datos ficticios del pedido en `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue`.\n- Mensajes compartidos en `__SOURCE_ROOT__/i18n/locales/*.json`.\n\nLa pagina y el widget generados son intencionalmente genericos. Mantenga la estructura que necesite, pero sustituya etiquetas, campos y datos ficticios por comportamiento real del producto.\n\n## Nombres De Archivos Vue\n\n`SettingsPage.vue` y `OrderCommonAfterWidget.vue` son nombres iniciales genericos. En codigo de producto, renombre los archivos Vue segun la funcion que cumplen en la extension y actualice los imports en `__SOURCE_ROOT__/endpoint/endpoint.worker.ts`.\n\nEjemplos del repositorio de extensiones RetailCRM:\n\n- `ReturnsPage.vue` es una pagina completa de gestion de devoluciones.\n- `TasksPage.vue` es una pagina de lista o espacio de trabajo de tareas.\n- `SummaryPage.vue` es una pagina de resumen o dashboard.\n- `RecordToCalendlyWidget.vue` es un widget enfocado en un escenario.\n\nUse la misma idea para su codigo: `LoyaltySettingsPage.vue`, `OrderNotesWidget.vue`, `PaymentStatusSidebar.vue` u otro nombre que describa el escenario real.\n\n## Comandos\n\n```bash\n__PACKAGE_MANAGER__ install\n__PACKAGE_MANAGER_RUN__ eslint\n__PACKAGE_MANAGER_RUN__ build\n__PACKAGE_MANAGER_RUN__ publish-extension -- --archive-only\n```\n\n## Publicacion\n\nCree `.env` en la raiz del proyecto cuando quiera que `publish-extension` actualice RetailCRM:\n\n```dotenv\nCRM_API_HOST=https://example.retailcrm.pro\nCRM_API_KEY=your-api-key\nMODULE_URL=https://example.com\n```\n\nEjecute `__PACKAGE_MANAGER_RUN__ build` antes de publicar. El modo archive-only crea `dist/extension.zip` sin enviar peticiones API.\n\nPara comprobar localmente en CRM, `MODULE_URL` debe apuntar a un dev/static server que sirva\n`/extension/<uuid>/script` y `/extension/<uuid>/stylesheet`. `publish-extension` registra estas URL en CRM,\npero no arranca ese servidor.\n";
-const readmeRuRUTemplate = "# Фронтенд расширения RetailCRM\n\nПроект создан командой `embed-ui init`.\n\n## Что Добавлено\n\n- `package.json` со скриптами для сборки Vite, ESLint и публикации расширения.\n- `extensionrc.json` с исходным описанием манифеста расширения.\n- `__SOURCE_ROOT__/endpoint/endpoint.worker.ts` с `defineRunner`, одним runner страницы и одним runner виджета.\n- `__SOURCE_ROOT__/pages/SettingsPage.vue` как стартовая страница настроек.\n- `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue` как стартовый виджет заказа.\n- `__SOURCE_ROOT__/i18n/` с общими JSON-файлами переводов.\n- `scripts/publish-extension.mjs` для создания `dist/extension.zip` и публикации интеграционного модуля через RetailCRM API.\n- `AGENTS.md`, если при инициализации были включены инструкции для агентов.\n\n## Замените Generic Значения\n\nПеред использованием проекта в реальной интеграции проверьте сгенерированные общие значения:\n\n- Код расширения в `extensionrc.json`: `retailcrm-extension-frontend`.\n- Название расширения в `extensionrc.json`: `RetailCRM Extension Frontend`.\n- Код страницы: `__PAGE_CODE__`.\n- Описание страницы в `extensionrc.json`: `pages[]` должен оставаться объектом с `code`, `menu` и `menuItemTitle`; строковая форма не подходит для публикации через RetailCRM API.\n- Цель виджета: `__WIDGET_TARGET__`.\n- Демонстрационные контролы и ненастоящие данные в `__SOURCE_ROOT__/pages/SettingsPage.vue`.\n- Демонстрационные toolbar-действия и ненастоящие данные заказа в `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue`.\n- Общие сообщения в `__SOURCE_ROOT__/i18n/locales/*.json`.\n\nСгенерированные страница и виджет намеренно сделаны универсальными. Оставьте нужную структуру, но замените примерные подписи, поля и ненастоящие данные на реальное поведение продукта.\n\n## Имена Vue-Файлов\n\n`SettingsPage.vue` и `OrderCommonAfterWidget.vue` — универсальные стартовые имена. В продуктовом коде переименуйте Vue-файлы по роли, которую они выполняют в расширении, и обновите импорты в `__SOURCE_ROOT__/endpoint/endpoint.worker.ts`.\n\nПримеры из репозитория расширений RetailCRM:\n\n- `ReturnsPage.vue` — полноценная страница управления возвратами.\n- `TasksPage.vue` — страница списка задач или рабочей области задач.\n- `SummaryPage.vue` — страница сводки или дашборда.\n- `RecordToCalendlyWidget.vue` — сфокусированный виджет под один сценарий.\n\nИспользуйте тот же принцип: `LoyaltySettingsPage.vue`, `OrderNotesWidget.vue`, `PaymentStatusSidebar.vue` или другое имя, которое описывает реальный сценарий.\n\n## Команды\n\n```bash\n__PACKAGE_MANAGER__ install\n__PACKAGE_MANAGER_RUN__ eslint\n__PACKAGE_MANAGER_RUN__ build\n__PACKAGE_MANAGER_RUN__ publish-extension -- --archive-only\n```\n\n## Публикация\n\nСоздайте `.env` в корне проекта, когда потребуется обновлять RetailCRM через `publish-extension`:\n\n```dotenv\nCRM_API_HOST=https://example.retailcrm.pro\nCRM_API_KEY=your-api-key\nMODULE_URL=https://example.com\n```\n\nПеред публикацией выполните `__PACKAGE_MANAGER_RUN__ build`. Режим archive-only создает `dist/extension.zip` без API-запросов.\n\nДля локальной проверки в CRM `MODULE_URL` должен указывать на dev/static server, который отдаёт\n`/extension/<uuid>/script` и `/extension/<uuid>/stylesheet`. `publish-extension` регистрирует эти URL в CRM,\nно сам dev-server не запускает.\n";
+const readmeEnGBTemplate = "# RetailCRM extension frontend\n\nThis project was generated by `embed-ui init`.\n\n## What Was Added\n\n- `package.json` with scripts for Vite build, ESLint, and extension publishing.\n- `extensionrc.json` with the generated extension manifest source.\n- `__SOURCE_ROOT__/endpoint/endpoint.worker.ts` with `defineRunner`, one page runner, and one widget runner.\n- `__SOURCE_ROOT__/pages/SettingsPage.vue` as a starter settings page.\n- `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue` as a starter order widget.\n- `__SOURCE_ROOT__/i18n/` with shared JSON message files.\n- `__SOURCE_ROOT__/sandbox/tests/` with starter unit, browser, and e2e tests.\n- `vitest.config.ts`, `vitest.config.browser.ts`, and `vitest.config.playwright.ts` for test runs.\n- `scripts/publish-extension.mjs` for creating `dist/extension.zip` and publishing the integration module through RetailCRM API.\n- `scripts/serve-extension.mjs` for serving built extension manifests, scripts, and styles during e2e tests.\n- `AGENTS.md` when agent instructions were enabled during init.\n\n## Replace Generic Values\n\nReview these generated placeholders before using the project in a real integration:\n\n- Extension code in `extensionrc.json`: `retailcrm-extension-frontend`.\n- Extension name in `extensionrc.json`: `RetailCRM Extension Frontend`.\n- Page code: `__PAGE_CODE__`.\n- Page descriptor in `extensionrc.json`: keep `pages[]` as an object with `code`, `menu`, and `menuItemTitle`; string page form is not valid for RetailCRM API publishing.\n- Widget target: `__WIDGET_TARGET__`.\n- Sample controls and fake data in `__SOURCE_ROOT__/pages/SettingsPage.vue`.\n- Sample toolbar actions and fake order data in `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue`.\n- Shared messages in `__SOURCE_ROOT__/i18n/locales/*.json`.\n\nThe generated page and widget are intentionally generic. Keep the structure you need, but replace the sample labels, fields, and fake data with real product behavior.\n\n## Vue File Names\n\n`SettingsPage.vue` and `OrderCommonAfterWidget.vue` are generic starter names. In product code, rename Vue files after the role they play in the extension, and update imports in `__SOURCE_ROOT__/endpoint/endpoint.worker.ts`.\n\nExamples from RetailCRM extension examples:\n\n- `ReturnsPage.vue` is a full returns-management page.\n- `TasksPage.vue` is a task list/workspace page.\n- `SummaryPage.vue` is a summary dashboard page.\n- `RecordToCalendlyWidget.vue` is a focused widget for one scenario.\n\nUse the same idea for your code: `LoyaltySettingsPage.vue`, `OrderNotesWidget.vue`, `PaymentStatusSidebar.vue`, or another name that describes the real scenario.\n\n## Commands\n\n```bash\n__PACKAGE_MANAGER__ install\n__PACKAGE_MANAGER_RUN__ eslint\n__PACKAGE_MANAGER_RUN__ build\n__PACKAGE_MANAGER_RUN__ test:unit\n__PACKAGE_MANAGER_RUN__ test:browser\n__PACKAGE_MANAGER_RUN__ test:e2e\n__PACKAGE_MANAGER_RUN__ serve:extension\n__PACKAGE_MANAGER_RUN__ publish-extension -- --archive-only\n```\n\n## Testing\n\n- `__PACKAGE_MANAGER_RUN__ test:unit` runs fast unit tests without a browser.\n- `__PACKAGE_MANAGER_RUN__ test:browser` runs the starter page and widget in Chromium through Vitest Browser.\n- `__PACKAGE_MANAGER_RUN__ test:e2e` builds the extension, starts the sandbox app and local extension server, then checks the extension through Playwright.\n- `__PACKAGE_MANAGER_RUN__ serve:extension` starts `http://127.0.0.1:4175` after a build. Tests build the concrete manifest URL as `http://127.0.0.1:4175/extension/<uuid>`.\n\nBefore the first browser/e2e run, install Chromium if needed:\n\n```bash\n__PACKAGE_MANAGER_RUN__ test:browsers:install\n```\n\n## Publishing\n\nCreate `.env` in the project root when you want `publish-extension` to update RetailCRM:\n\n```dotenv\nCRM_API_HOST=https://example.retailcrm.pro\nCRM_API_KEY=your-api-key\nMODULE_URL=https://example.com\n```\n\nRun `__PACKAGE_MANAGER_RUN__ build` before publishing. The archive-only mode creates `dist/extension.zip` without sending API requests.\n\nFor local CRM checks, `MODULE_URL` must point to a dev/static server. `__PACKAGE_MANAGER_RUN__ serve:extension`\nstarts that local server for the current `dist` build and resolves `/extension/<uuid>`,\n`/extension/<uuid>/script`, and `/extension/<uuid>/stylesheet` from `extensionrc.json`.\n`publish-extension` registers these URLs in CRM, but it does not start that server.\n";
+const readmeEsESTemplate = "# Frontend de extension RetailCRM\n\nEste proyecto fue generado por `embed-ui init`.\n\n## Que Se Agrego\n\n- `package.json` con scripts para Vite build, ESLint y publicacion de la extension.\n- `extensionrc.json` con la fuente del manifiesto de la extension.\n- `__SOURCE_ROOT__/endpoint/endpoint.worker.ts` con `defineRunner`, un runner de pagina y un runner de widget.\n- `__SOURCE_ROOT__/pages/SettingsPage.vue` como pagina inicial de configuracion.\n- `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue` como widget inicial del pedido.\n- `__SOURCE_ROOT__/i18n/` con archivos JSON de mensajes compartidos.\n- `__SOURCE_ROOT__/sandbox/tests/` con pruebas iniciales unit, browser y e2e.\n- `vitest.config.ts`, `vitest.config.browser.ts` y `vitest.config.playwright.ts` para ejecutar pruebas.\n- `scripts/publish-extension.mjs` para crear `dist/extension.zip` y publicar el modulo de integracion por RetailCRM API.\n- `scripts/serve-extension.mjs` para servir manifest, script y stylesheet compilados durante las pruebas e2e.\n- `AGENTS.md` si las instrucciones para agentes estaban activadas durante init.\n\n## Sustituya Los Valores Genericos\n\nRevise estos valores generados antes de usar el proyecto en una integracion real:\n\n- Codigo de extension en `extensionrc.json`: `retailcrm-extension-frontend`.\n- Nombre de extension en `extensionrc.json`: `RetailCRM Extension Frontend`.\n- Codigo de pagina: `__PAGE_CODE__`.\n- Descriptor de pagina en `extensionrc.json`: mantenga `pages[]` como objeto con `code`, `menu` y `menuItemTitle`; la forma de cadena no sirve para publicar por la API RetailCRM.\n- Target del widget: `__WIDGET_TARGET__`.\n- Controles de ejemplo y datos ficticios en `__SOURCE_ROOT__/pages/SettingsPage.vue`.\n- Acciones toolbar de ejemplo y datos ficticios del pedido en `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue`.\n- Mensajes compartidos en `__SOURCE_ROOT__/i18n/locales/*.json`.\n\nLa pagina y el widget generados son intencionalmente genericos. Mantenga la estructura que necesite, pero sustituya etiquetas, campos y datos ficticios por comportamiento real del producto.\n\n## Nombres De Archivos Vue\n\n`SettingsPage.vue` y `OrderCommonAfterWidget.vue` son nombres iniciales genericos. En codigo de producto, renombre los archivos Vue segun la funcion que cumplen en la extension y actualice los imports en `__SOURCE_ROOT__/endpoint/endpoint.worker.ts`.\n\nEjemplos del repositorio de extensiones RetailCRM:\n\n- `ReturnsPage.vue` es una pagina completa de gestion de devoluciones.\n- `TasksPage.vue` es una pagina de lista o espacio de trabajo de tareas.\n- `SummaryPage.vue` es una pagina de resumen o dashboard.\n- `RecordToCalendlyWidget.vue` es un widget enfocado en un escenario.\n\nUse la misma idea para su codigo: `LoyaltySettingsPage.vue`, `OrderNotesWidget.vue`, `PaymentStatusSidebar.vue` u otro nombre que describa el escenario real.\n\n## Comandos\n\n```bash\n__PACKAGE_MANAGER__ install\n__PACKAGE_MANAGER_RUN__ eslint\n__PACKAGE_MANAGER_RUN__ build\n__PACKAGE_MANAGER_RUN__ test:unit\n__PACKAGE_MANAGER_RUN__ test:browser\n__PACKAGE_MANAGER_RUN__ test:e2e\n__PACKAGE_MANAGER_RUN__ serve:extension\n__PACKAGE_MANAGER_RUN__ publish-extension -- --archive-only\n```\n\n## Pruebas\n\n- `__PACKAGE_MANAGER_RUN__ test:unit` ejecuta pruebas unitarias rapidas sin navegador.\n- `__PACKAGE_MANAGER_RUN__ test:browser` ejecuta la pagina y el widget iniciales en Chromium mediante Vitest Browser.\n- `__PACKAGE_MANAGER_RUN__ test:e2e` compila la extension, inicia la sandbox app y el servidor local de extension, luego comprueba la extension con Playwright.\n- `__PACKAGE_MANAGER_RUN__ serve:extension` inicia `http://127.0.0.1:4175` despues de compilar. Las pruebas construyen el manifest URL concreto como `http://127.0.0.1:4175/extension/<uuid>`.\n\nAntes del primer lanzamiento browser/e2e, instale Chromium si hace falta:\n\n```bash\n__PACKAGE_MANAGER_RUN__ test:browsers:install\n```\n\n## Publicacion\n\nCree `.env` en la raiz del proyecto cuando quiera que `publish-extension` actualice RetailCRM:\n\n```dotenv\nCRM_API_HOST=https://example.retailcrm.pro\nCRM_API_KEY=your-api-key\nMODULE_URL=https://example.com\n```\n\nEjecute `__PACKAGE_MANAGER_RUN__ build` antes de publicar. El modo archive-only crea `dist/extension.zip` sin enviar peticiones API.\n\nPara comprobar localmente en CRM, `MODULE_URL` debe apuntar a un dev/static server. `__PACKAGE_MANAGER_RUN__ serve:extension`\ninicia ese servidor local para el build actual de `dist` y resuelve `/extension/<uuid>`,\n`/extension/<uuid>/script` y `/extension/<uuid>/stylesheet` desde `extensionrc.json`.\n`publish-extension` registra estas URL en CRM, pero no arranca ese servidor.\n";
+const readmeRuRUTemplate = "# Фронтенд расширения RetailCRM\n\nПроект создан командой `embed-ui init`.\n\n## Что Добавлено\n\n- `package.json` со скриптами для сборки Vite, ESLint и публикации расширения.\n- `extensionrc.json` с исходным описанием манифеста расширения.\n- `__SOURCE_ROOT__/endpoint/endpoint.worker.ts` с `defineRunner`, одним runner страницы и одним runner виджета.\n- `__SOURCE_ROOT__/pages/SettingsPage.vue` как стартовая страница настроек.\n- `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue` как стартовый виджет заказа.\n- `__SOURCE_ROOT__/i18n/` с общими JSON-файлами переводов.\n- `__SOURCE_ROOT__/sandbox/tests/` со стартовыми unit, browser и e2e тестами.\n- `vitest.config.ts`, `vitest.config.browser.ts` и `vitest.config.playwright.ts` для запуска тестов.\n- `scripts/publish-extension.mjs` для создания `dist/extension.zip` и публикации интеграционного модуля через RetailCRM API.\n- `scripts/serve-extension.mjs` для отдачи собранных manifest, script и stylesheet расширения во время e2e-тестов.\n- `AGENTS.md`, если при инициализации были включены инструкции для агентов.\n\n## Замените Generic Значения\n\nПеред использованием проекта в реальной интеграции проверьте сгенерированные общие значения:\n\n- Код расширения в `extensionrc.json`: `retailcrm-extension-frontend`.\n- Название расширения в `extensionrc.json`: `RetailCRM Extension Frontend`.\n- Код страницы: `__PAGE_CODE__`.\n- Описание страницы в `extensionrc.json`: `pages[]` должен оставаться объектом с `code`, `menu` и `menuItemTitle`; строковая форма не подходит для публикации через RetailCRM API.\n- Цель виджета: `__WIDGET_TARGET__`.\n- Демонстрационные контролы и ненастоящие данные в `__SOURCE_ROOT__/pages/SettingsPage.vue`.\n- Демонстрационные toolbar-действия и ненастоящие данные заказа в `__SOURCE_ROOT__/widgets/OrderCommonAfterWidget.vue`.\n- Общие сообщения в `__SOURCE_ROOT__/i18n/locales/*.json`.\n\nСгенерированные страница и виджет намеренно сделаны универсальными. Оставьте нужную структуру, но замените примерные подписи, поля и ненастоящие данные на реальное поведение продукта.\n\n## Имена Vue-Файлов\n\n`SettingsPage.vue` и `OrderCommonAfterWidget.vue` — универсальные стартовые имена. В продуктовом коде переименуйте Vue-файлы по роли, которую они выполняют в расширении, и обновите импорты в `__SOURCE_ROOT__/endpoint/endpoint.worker.ts`.\n\nПримеры из репозитория расширений RetailCRM:\n\n- `ReturnsPage.vue` — полноценная страница управления возвратами.\n- `TasksPage.vue` — страница списка задач или рабочей области задач.\n- `SummaryPage.vue` — страница сводки или дашборда.\n- `RecordToCalendlyWidget.vue` — сфокусированный виджет под один сценарий.\n\nИспользуйте тот же принцип: `LoyaltySettingsPage.vue`, `OrderNotesWidget.vue`, `PaymentStatusSidebar.vue` или другое имя, которое описывает реальный сценарий.\n\n## Команды\n\n```bash\n__PACKAGE_MANAGER__ install\n__PACKAGE_MANAGER_RUN__ eslint\n__PACKAGE_MANAGER_RUN__ build\n__PACKAGE_MANAGER_RUN__ test:unit\n__PACKAGE_MANAGER_RUN__ test:browser\n__PACKAGE_MANAGER_RUN__ test:e2e\n__PACKAGE_MANAGER_RUN__ serve:extension\n__PACKAGE_MANAGER_RUN__ publish-extension -- --archive-only\n```\n\n## Тестирование\n\n- `__PACKAGE_MANAGER_RUN__ test:unit` проверяет быстрые unit-тесты без браузера.\n- `__PACKAGE_MANAGER_RUN__ test:browser` запускает стартовую страницу и виджет в Chromium через Vitest Browser.\n- `__PACKAGE_MANAGER_RUN__ test:e2e` собирает расширение, поднимает sandbox-приложение и локальный extension server, затем проверяет расширение через Playwright.\n- `__PACKAGE_MANAGER_RUN__ serve:extension` после сборки запускает `http://127.0.0.1:4175`. Тесты собирают конкретный manifest URL как `http://127.0.0.1:4175/extension/<uuid>`.\n\nПеред первым browser/e2e запуском может потребоваться установить Chromium:\n\n```bash\n__PACKAGE_MANAGER_RUN__ test:browsers:install\n```\n\n## Публикация\n\nСоздайте `.env` в корне проекта, когда потребуется обновлять RetailCRM через `publish-extension`:\n\n```dotenv\nCRM_API_HOST=https://example.retailcrm.pro\nCRM_API_KEY=your-api-key\nMODULE_URL=https://example.com\n```\n\nПеред публикацией выполните `__PACKAGE_MANAGER_RUN__ build`. Режим archive-only создает `dist/extension.zip` без API-запросов.\n\nДля локальной проверки в CRM `MODULE_URL` должен указывать на dev/static server. `__PACKAGE_MANAGER_RUN__ serve:extension`\nзапускает такой локальный сервер для текущей сборки `dist` и резолвит `/extension/<uuid>`,\n`/extension/<uuid>/script` и `/extension/<uuid>/stylesheet` из `extensionrc.json`.\n`publish-extension` регистрирует эти URL в CRM, но сам dev-server не запускает.\n";
+const sandboxBrowserTestTemplate = "import type { SandboxWorkerRuntime } from '@retailcrm/embed-ui-v1-sandbox/automation/browser'\n\nimport { afterEach, expect, test } from 'vitest'\nimport { fireEvent, screen } from '@testing-library/dom'\n\nimport { createExtensionSourceWorker } from '@retailcrm/embed-ui-v1-sandbox/automation/browser'\nimport { createSandboxWorkerRuntime } from '@retailcrm/embed-ui-v1-sandbox/automation/browser'\n\nlet runtime: SandboxWorkerRuntime | null = null\n\nafterEach(async () => {\n  await runtime?.teardown()\n  runtime = null\n  document.body.innerHTML = ''\n  window.history.replaceState(null, '', '/')\n})\n\ntest('opens generated settings page', async () => {\n  runtime = await createRuntime()\n\n  await runtime.runPage('__PAGE_CODE__')\n\n  expect(await screen.findByRole('heading', { name: 'Настройки расширения' })).toBeInstanceOf(HTMLElement)\n  expect(screen.getByRole('button', { name: 'Сохранить' })).toBeInstanceOf(HTMLButtonElement)\n})\n\ntest('opens generated order widget sidebar', async () => {\n  runtime = await createRuntime()\n\n  await runtime.runWidget('__WIDGET_TARGET__')\n\n  const openSidebar = await screen.findByRole('button', { name: 'Подготовить связь' })\n\n  fireEvent.click(openSidebar)\n\n  expect(await screen.findByRole('dialog')).toBeInstanceOf(HTMLElement)\n  expect(screen.getByText('Связь по заказу')).toBeInstanceOf(HTMLElement)\n})\n\nconst createRuntime = async (): Promise<SandboxWorkerRuntime> => {\n  const sourceWorker = createExtensionSourceWorker(\n    new URL('/__SOURCE_ROOT__/endpoint/endpoint.worker.ts', window.location.href)\n  )\n\n  return createSandboxWorkerRuntime({\n    fixture: 'order-basic',\n    ready: sourceWorker.ready,\n    worker: sourceWorker.worker,\n  })\n}\n";
+const sandboxE2eTestTemplate = `import fs from 'node:fs'
+import path from 'node:path'
+
+import { expect, test } from '@playwright/test'
+
+import {
+  createSandboxPagePath,
+  readSandboxSnapshot,
+} from '@retailcrm/embed-ui-v1-sandbox/automation/playwright'
+
+type ExtensionConfig = {
+  pages: Array<{ code: string }>
+  targets: string[]
+  uuid: string
+}
+
+const extensionBaseURL = process.env.SANDBOX_EXTENSION_URL || 'http://127.0.0.1:4175/extension/'
+const extensionrc = JSON.parse(
+  fs.readFileSync(path.resolve(process.cwd(), 'extensionrc.json'), 'utf8')
+) as ExtensionConfig
+const extensionUrl = new URL(extensionrc.uuid, extensionBaseURL).href
+const [pageDescriptor] = extensionrc.pages
+const [target] = extensionrc.targets
+
+test('loads generated settings page extension and saves settings', async ({ page }) => {
+  await page.goto(createSandboxPagePath({
+    extensionUrl,
+    manifestUrl: extensionUrl,
+    pageCode: pageDescriptor.code,
+    targets: [target],
+  }))
+
+  await expect(page).toHaveURL(/mode=page/u)
+  await expect(page).toHaveURL(new RegExp(\`pageCode=\${pageDescriptor.code}\`, 'u'))
+  await expect(page.getByRole('heading', { name: 'Настройки расширения' })).toBeVisible()
+  await expect(page.locator('svg[class*="settings-page-addon__icon"]')).toHaveCSS('width', '24px')
+  await expect(page.locator('svg[class*="settings-page-addon__icon"]')).toHaveCSS('height', '24px')
+  await expect(page.getByRole('button', { name: 'Сохранить' })).toBeVisible()
+  await expect(page.getByLabel('Название помощника')).toHaveValue('Order follow-up')
+
+  await page.getByLabel('Название помощника').fill('E2E assistant')
+  await page.getByRole('button', { name: 'Сохранить' }).click()
+
+  await expect(page.locator('body')).toContainText('Настройки сохранены')
+
+  const snapshot = await readSandboxSnapshot(page)
+
+  expect(snapshot.host.http.every(record => record.response.status === 200)).toBe(true)
+})
+`;
+const sandboxUnitTestTemplate = "import { describe, expect, test } from 'vitest'\n\nimport extensionrc from '../../../../extensionrc.json'\n\ndescribe('extension manifest', () => {\n  test('contains generated page and widget target', () => {\n    expect(extensionrc.pages).toEqual(\n      expect.arrayContaining([\n        expect.objectContaining({ code: '__PAGE_CODE__' }),\n      ])\n    )\n\n    expect(extensionrc.targets).toContain('__WIDGET_TARGET__')\n    expect(extensionrc.runner).toBe('worker')\n    expect(extensionrc.entrypointType).toBe('script')\n  })\n})\n";
+const serveScriptTemplate = `#!/usr/bin/env node
+
+import { fileURLToPath } from 'node:url'
+
+import fs from 'node:fs'
+
+import http from 'node:http'
+
+import path from 'node:path'
+
+const scriptDir = path.dirname(fileURLToPath(import.meta.url))
+const projectRoot = path.resolve(scriptDir, '..')
+const DEFAULT_HOST = '127.0.0.1'
+const DEFAULT_PORT = 4175
+
+const parseArgs = () => {
+  const result = {
+    host: DEFAULT_HOST,
+    port: DEFAULT_PORT,
+  }
+  const args = process.argv.slice(2)
+
+  for (let index = 0; index < args.length; index++) {
+    const arg = args[index]
+
+    if (arg === '--host') {
+      result.host = args[++index] || DEFAULT_HOST
+      continue
+    }
+
+    if (arg === '--port') {
+      const port = Number(args[++index])
+
+      if (!Number.isInteger(port) || port <= 0) {
+        throw new Error('Invalid --port value')
+      }
+
+      result.port = port
+    }
+  }
+
+  return result
+}
+
+const readJsonFile = (filePath) => JSON.parse(fs.readFileSync(filePath, 'utf8'))
+
+const listFiles = (directoryPath, basePath = directoryPath) => {
+  const result = []
+
+  for (const entry of fs.readdirSync(directoryPath, { withFileTypes: true })) {
+    const entryPath = path.join(directoryPath, entry.name)
+    const relativePath = path.relative(basePath, entryPath).split(path.sep).join('/')
+
+    if (entry.isDirectory()) {
+      result.push(...listFiles(entryPath, basePath))
+      continue
+    }
+
+    if (entry.isFile()) {
+      result.push(relativePath)
+    }
+  }
+
+  return result
+}
+
+const normalizeManifestPath = (value) => typeof value === 'string' && value.startsWith('./')
+  ? value.slice(2)
+  : value
+
+const pickBuildArtifacts = (distDir) => {
+  const files = listFiles(distDir)
+    .filter(file => file !== 'manifest.json')
+    .filter(file => file !== 'extension.zip')
+    .filter(file => !file.endsWith('.map'))
+
+  const viteManifestPath = path.join(distDir, '.vite/manifest.json')
+
+  if (fs.existsSync(viteManifestPath)) {
+    const viteManifest = readJsonFile(viteManifestPath)
+    const entries = Object.values(viteManifest)
+    const entry = entries.find(item => item && item.isEntry) ?? entries[0]
+
+    if (entry?.file) {
+      return {
+        scriptFile: normalizeManifestPath(entry.file),
+        styleFile: Array.isArray(entry.css) ? normalizeManifestPath(entry.css[0]) : null,
+      }
+    }
+  }
+
+  return {
+    scriptFile: files.find(file => file.endsWith('.js')) ?? null,
+    styleFile: files.find(file => file.endsWith('.css')) ?? null,
+  }
+}
+
+const assertFileInside = (root, relativePath) => {
+  const filePath = path.resolve(root, relativePath)
+
+  if (!filePath.startsWith(root + path.sep) && filePath !== root) {
+    throw new Error('Resolved file path is outside dist: ' + relativePath)
+  }
+
+  return filePath
+}
+
+const resolveFileInside = (root, relativePath) => {
+  const filePath = path.resolve(root, relativePath)
+
+  if (!filePath.startsWith(root + path.sep) && filePath !== root) {
+    return null
+  }
+
+  return filePath
+}
+
+const getContentType = (filePath) => {
+  if (filePath.endsWith('.js')) return 'application/javascript; charset=utf-8'
+  if (filePath.endsWith('.css')) return 'text/css; charset=utf-8'
+  if (filePath.endsWith('.html')) return 'text/html; charset=utf-8'
+  if (filePath.endsWith('.json')) return 'application/json; charset=utf-8'
+  if (filePath.endsWith('.svg')) return 'image/svg+xml'
+  if (filePath.endsWith('.png')) return 'image/png'
+  if (filePath.endsWith('.jpg') || filePath.endsWith('.jpeg')) return 'image/jpeg'
+  if (filePath.endsWith('.woff2')) return 'font/woff2'
+
+  return 'application/octet-stream'
+}
+
+const send = (request, response, status, body, headers = {}) => {
+  const origin = request.headers.origin || '*'
+  const responseBody = Buffer.isBuffer(body) ? body : Buffer.from(String(body))
+
+  response.writeHead(status, {
+    'access-control-allow-credentials': 'true',
+    'access-control-allow-origin': origin,
+    'content-length': responseBody.byteLength,
+    'vary': 'Origin',
+    ...headers,
+  })
+
+  if (request.method !== 'HEAD') {
+    response.end(responseBody)
+    return
+  }
+
+  response.end()
+}
+
+const sendFile = (request, response, filePath) => {
+  if (!fs.existsSync(filePath) || !fs.statSync(filePath).isFile()) {
+    send(request, response, 404, 'Not found', { 'content-type': 'text/plain; charset=utf-8' })
+    return
+  }
+
+  const body = fs.readFileSync(filePath)
+
+  send(request, response, 200, body, {
+    'content-length': body.byteLength,
+    'content-type': getContentType(filePath),
+  })
+}
+
+const createHtmlManifest = (scriptUrl, stylesheetUrl) => [
+  '<!doctype html>',
+  '<html>',
+  '<head>',
+  '<meta charset="utf-8">',
+  stylesheetUrl ? '<link rel="stylesheet" href="' + stylesheetUrl + '">' : '',
+  '<script type="module" src="' + scriptUrl + '"><\/script>',
+  '</head>',
+  '<body></body>',
+  '</html>',
+  '',
+].filter(Boolean).join('\\n')
+
+const normalizeExtensionUuid = (value, source) => {
+  if (typeof value !== 'string' || value.trim() === '') {
+    throw new Error('Field "uuid" must be a non-empty string in ' + source)
+  }
+
+  return value
+}
+
+const createRootRegistryEntry = () => {
+  const configPath = path.join(projectRoot, 'extensionrc.json')
+  const distDir = path.join(projectRoot, 'dist')
+
+  if (!fs.existsSync(configPath)) {
+    return null
+  }
+
+  if (!fs.existsSync(distDir)) {
+    throw new Error('Build directory not found: ' + distDir + '. Run build before serve:extension.')
+  }
+
+  const config = readJsonFile(configPath)
+  const uuid = normalizeExtensionUuid(config.uuid, configPath)
+  const { scriptFile, styleFile } = pickBuildArtifacts(distDir)
+
+  if (!scriptFile) {
+    throw new Error('Missing JS build artifact. Run build before serve:extension.')
+  }
+
+  const distRoot = path.resolve(distDir)
+
+  return {
+    config,
+    distRoot,
+    scriptPath: assertFileInside(distRoot, scriptFile),
+    stylePath: styleFile ? assertFileInside(distRoot, styleFile) : null,
+    uuid,
+  }
+}
+
+const createCasesRegistryEntries = () => {
+  const casesPath = path.join(projectRoot, 'cases.json')
+
+  if (!fs.existsSync(casesPath)) {
+    return []
+  }
+
+  const cases = readJsonFile(casesPath)
+
+  if (!Array.isArray(cases.items)) {
+    throw new Error('Field "items" must be an array in ' + casesPath)
+  }
+
+  return cases.items.map((record, index) => {
+    const source = casesPath + '#items[' + index + ']'
+    const uuid = normalizeExtensionUuid(record.uuid, source)
+    const name = typeof record.name === 'string' && record.name.trim()
+      ? record.name
+      : null
+
+    if (!name) {
+      throw new Error('Field "name" must be a non-empty string in ' + source)
+    }
+
+    const distRoot = path.resolve(projectRoot, 'dist', name)
+    const manifestPath = path.join(distRoot, 'manifest.json')
+
+    if (!fs.existsSync(manifestPath)) {
+      throw new Error('Build manifest not found: ' + manifestPath)
+    }
+
+    const manifest = readJsonFile(manifestPath)
+    const scriptFile = normalizeManifestPath(manifest[record.script])
+    const styleFile = record.stylesheet ? normalizeManifestPath(manifest[record.stylesheet]) : null
+
+    if (!scriptFile) {
+      throw new Error('Missing JS build artifact for ' + uuid)
+    }
+
+    return {
+      config: record,
+      distRoot,
+      scriptPath: assertFileInside(distRoot, scriptFile),
+      stylePath: styleFile ? assertFileInside(distRoot, styleFile) : null,
+      uuid,
+    }
+  })
+}
+
+const createExtensionRegistry = () => {
+  const registry = new Map()
+  const entries = [
+    createRootRegistryEntry(),
+    ...createCasesRegistryEntries(),
+  ].filter(Boolean)
+
+  if (entries.length === 0) {
+    throw new Error('No extensions found. Add extensionrc.json or cases.json.')
+  }
+
+  for (const entry of entries) {
+    if (registry.has(entry.uuid)) {
+      throw new Error('Duplicate extension uuid: ' + entry.uuid)
+    }
+
+    registry.set(entry.uuid, entry)
+  }
+
+  return registry
+}
+
+const parseExtensionRequest = (pathname) => {
+  const match = pathname.match(/^\\/extension\\/([^/]+)(?:\\/(.*))?$/u)
+
+  if (!match) {
+    return null
+  }
+
+  return {
+    resource: (match[2] ?? '').replace(/\\/$/u, ''),
+    uuid: decodeURIComponent(match[1]),
+  }
+}
+
+const start = () => {
+  const { host, port } = parseArgs()
+  const registry = createExtensionRegistry()
+  const server = http.createServer((request, response) => {
+    const url = new URL(request.url || '/', 'http://extension.local')
+
+    if (request.method === 'OPTIONS') {
+      send(request, response, 204, '', {
+        'access-control-allow-headers': 'content-type',
+        'access-control-allow-methods': 'GET,HEAD,OPTIONS,POST',
+      })
+      return
+    }
+
+    if (request.method !== 'GET' && request.method !== 'HEAD') {
+      send(request, response, 405, 'Method not allowed', { 'content-type': 'text/plain; charset=utf-8' })
+      return
+    }
+
+    const extensionRequest = parseExtensionRequest(url.pathname)
+
+    if (!extensionRequest) {
+      send(request, response, 404, 'Not found', { 'content-type': 'text/plain; charset=utf-8' })
+      return
+    }
+
+    const entry = registry.get(extensionRequest.uuid)
+
+    if (!entry) {
+      send(request, response, 404, 'Not found', { 'content-type': 'text/plain; charset=utf-8' })
+      return
+    }
+
+    const extensionPrefix = '/extension/' + entry.uuid
+
+    if (!extensionRequest.resource) {
+      send(request, response, 200, createHtmlManifest(
+        extensionPrefix + '/script',
+        entry.stylePath && entry.config.stylesheet !== false ? extensionPrefix + '/stylesheet' : null
+      ), {
+        'content-type': 'text/html; charset=utf-8',
+      })
+      return
+    }
+
+    if (extensionRequest.resource === 'script') {
+      sendFile(request, response, entry.scriptPath)
+      return
+    }
+
+    if (extensionRequest.resource === 'stylesheet') {
+      if (!entry.stylePath || entry.config.stylesheet === false) {
+        send(request, response, 404, 'Not found', { 'content-type': 'text/plain; charset=utf-8' })
+        return
+      }
+
+      sendFile(request, response, entry.stylePath)
+      return
+    }
+
+    if (extensionRequest.resource) {
+      const filePath = resolveFileInside(entry.distRoot, decodeURIComponent(extensionRequest.resource))
+
+      if (!filePath) {
+        send(request, response, 404, 'Not found', { 'content-type': 'text/plain; charset=utf-8' })
+        return
+      }
+
+      sendFile(request, response, filePath)
+      return
+    }
+
+    send(request, response, 404, 'Not found', { 'content-type': 'text/plain; charset=utf-8' })
+  })
+
+  server.listen(port, host, () => {
+    console.log('Extension server: http://' + host + ':' + port)
+  })
+}
+
+try {
+  start()
+} catch (error) {
+  console.error(error instanceof Error ? error.message : error)
+  process.exit(1)
+}
+`;
 const settingsPageTemplate = `<template>
     <main :class="$style['settings-page']">
         <UiPageHeader :value="t('title')">
@@ -2392,6 +2902,8 @@ const saveSettings = () => {
 `;
 const tsConfigTemplate = '{\n  "compilerOptions": {\n    "target": "ES2022",\n    "useDefineForClassFields": true,\n    "module": "ESNext",\n    "moduleResolution": "Bundler",\n    "strict": true,\n    "jsx": "preserve",\n    "resolveJsonModule": true,\n    "isolatedModules": true,\n    "skipLibCheck": true,\n    "allowSyntheticDefaultImports": true,\n    "esModuleInterop": true,\n    "baseUrl": ".",\n    "paths": {\n      "@/*": [\n        "__SOURCE_ROOT_RELATIVE__/*"\n      ]\n    }\n  },\n  "include": [\n    "__SOURCE_ROOT_RELATIVE__/**/*",\n    "env.d.ts"\n  ],\n  "vueCompilerOptions": {\n    "plugins": [\n      "@omnicajs/vue-remote/tooling"\n    ]\n  }\n}\n';
 const viteConfigTemplate = "import { fileURLToPath } from 'node:url'\n\nimport path from 'node:path'\n\nimport { defineConfig } from 'vite'\n\nimport vue from '@vitejs/plugin-vue'\nimport vueRemoteVitePlugin from '@omnicajs/vue-remote/vite-plugin'\n\nimport vueI18n from '@intlify/unplugin-vue-i18n/vite'\n\nimport svgLoader from 'vite-svg-loader'\n\nconst root = path.dirname(fileURLToPath(import.meta.url))\n\nexport default defineConfig({\n  plugins: [\n    svgLoader({\n      defaultImport: 'component',\n    }),\n    vueRemoteVitePlugin(),\n    vue(),\n    vueI18n({\n      defaultSFCLang: 'json',\n      include: path.resolve(root, '__LOCALE_INCLUDE_PATTERN__/**/*.{json,json5,yaml,yml}'),\n    }),\n  ],\n  resolve: {\n    alias: {\n      '@': path.resolve(root, __SOURCE_ROOT_PATH__),\n    },\n  },\n  build: {\n    rollupOptions: {\n      input: path.resolve(root, __ENTRY_PATH__),\n    },\n  },\n})\n";
+const vitestBrowserConfigTemplate = "import { defineConfig, mergeConfig } from 'vitest/config'\nimport { playwright } from '@vitest/browser-playwright'\n\nimport viteConfig from './vite.config'\n\nexport default mergeConfig(viteConfig, defineConfig({\n  optimizeDeps: {\n    include: [\n      '@omnicajs/vue-remote/host',\n      '@omnicajs/vue-remote/remote',\n      '@remote-ui/rpc',\n      '@retailcrm/embed-ui',\n      '@retailcrm/embed-ui-v1-components/host',\n      '@retailcrm/embed-ui-v1-components/remote',\n      '@retailcrm/embed-ui-v1-contexts/remote/settings',\n      '@retailcrm/embed-ui-v1-endpoint/remote',\n      'vue',\n      'vue-i18n',\n    ],\n  },\n  server: {\n    allowedHosts: true,\n  },\n  test: {\n    include: ['__SOURCE_ROOT__/sandbox/tests/browser/**/*.browser.test.ts'],\n    browser: {\n      enabled: true,\n      provider: playwright({\n        launchOptions: {\n          channel: 'chromium',\n        },\n      }),\n      headless: true,\n      screenshotFailures: true,\n      screenshotDirectory: 'artifacts/browser/screenshots',\n      instances: [{ browser: 'chromium' }],\n    },\n  },\n}))\n";
+const vitestConfigTemplate = "import { defineConfig, mergeConfig } from 'vitest/config'\n\nimport viteConfig from './vite.config'\n\nexport default mergeConfig(viteConfig, defineConfig({\n  test: {\n    environment: 'jsdom',\n    include: ['__SOURCE_ROOT__/sandbox/tests/unit/**/*.test.ts'],\n  },\n}))\n";
 const toPosixRelative = (from, to) => {
   const relativePath = path.relative(from, to) || ".";
   return relativePath.split(path.sep).join("/");
@@ -2440,7 +2952,7 @@ const detectReadmeLocale = () => {
   }
   return "en-GB";
 };
-const createPackageManagerRunCommand = (packageManager) => {
+const createPackageManagerRunCommand$1 = (packageManager) => {
   if (packageManager === "npm") {
     return "npm run";
   }
@@ -2464,6 +2976,25 @@ const createViteConfig = (cwd, sourceRoot) => replaceTemplateVars(
     SOURCE_ROOT_PATH: quoteJsString(toPosixRelative(cwd, sourceRoot))
   }
 );
+const createVitestConfig = (cwd, sourceRoot) => replaceTemplateVars(
+  vitestConfigTemplate,
+  {
+    SOURCE_ROOT: toPosixRelative(cwd, sourceRoot)
+  }
+);
+const createVitestBrowserConfig = (cwd, sourceRoot) => replaceTemplateVars(
+  vitestBrowserConfigTemplate,
+  {
+    SOURCE_ROOT: toPosixRelative(cwd, sourceRoot)
+  }
+);
+const createPlaywrightConfig = (cwd, sourceRoot, packageManager) => replaceTemplateVars(
+  playwrightConfigTemplate,
+  {
+    PACKAGE_MANAGER_RUN: createPackageManagerRunCommand$1(packageManager),
+    SOURCE_ROOT: toPosixRelative(cwd, sourceRoot)
+  }
+);
 const createEslintConfig = (cwd, sourceRoot) => replaceTemplateVars(
   eslintConfigTemplate,
   {
@@ -2480,6 +3011,27 @@ const createEndpointWorker = (options) => replaceTemplateVars(
 const createI18nIndex = () => i18nIndexTemplate;
 const createSettingsPage = () => settingsPageTemplate;
 const createOrderWidget = () => orderWidgetTemplate;
+const createSandboxUnitTest = (options) => replaceTemplateVars(
+  sandboxUnitTestTemplate,
+  {
+    PAGE_CODE: options.pageCode,
+    WIDGET_TARGET: options.widgetTarget
+  }
+);
+const createSandboxBrowserTest = (cwd, sourceRoot, options) => replaceTemplateVars(
+  sandboxBrowserTestTemplate,
+  {
+    PAGE_CODE: options.pageCode,
+    SOURCE_ROOT: toPosixRelative(cwd, sourceRoot),
+    WIDGET_TARGET: options.widgetTarget
+  }
+);
+const createSandboxE2eTest = (cwd, sourceRoot) => replaceTemplateVars(
+  sandboxE2eTestTemplate,
+  {
+    SOURCE_ROOT: toPosixRelative(cwd, sourceRoot)
+  }
+);
 const createMessages = () => `${JSON.stringify({}, null, 2)}${DEFAULT_NEWLINE}`;
 const createExtensionConfig = (options) => `${JSON.stringify({
   code: "retailcrm-extension-frontend",
@@ -2505,11 +3057,12 @@ const createExtensionConfig = (options) => `${JSON.stringify({
 }, null, 2)}${DEFAULT_NEWLINE}`;
 const createExtensionIcon = () => extensionIconTemplate;
 const createPublishScript = () => publishScriptTemplate;
+const createServeScript = () => serveScriptTemplate;
 const createReadme = (cwd, sourceRoot, options, packageManager) => replaceTemplateVars(
   readmeTemplates[detectReadmeLocale()],
   {
     PACKAGE_MANAGER: packageManager,
-    PACKAGE_MANAGER_RUN: createPackageManagerRunCommand(packageManager),
+    PACKAGE_MANAGER_RUN: createPackageManagerRunCommand$1(packageManager),
     PAGE_CODE: options.pageCode,
     SOURCE_ROOT: toPosixRelative(cwd, sourceRoot),
     WIDGET_TARGET: options.widgetTarget
@@ -2526,6 +3079,7 @@ const createInitChanges = () => ({
   git: [],
   hooks: [],
   install: null,
+  browserInstall: null,
   skipped: [],
   warnings: []
 });
@@ -2618,6 +3172,11 @@ const printInitReport = (cwd, sourceRoot, version, packageManager, changes, opti
     console.log("install");
     console.log(`  ${changes.install}`);
   }
+  if (changes.browserInstall) {
+    console.log("");
+    console.log("browser install");
+    console.log(`  ${changes.browserInstall}`);
+  }
   if (changes.skipped.length > 0) {
     console.log("");
     console.log("skipped");
@@ -2651,7 +3210,8 @@ const printInitSummary = (cwd, sourceRoot, version, packageManager, changes) =>
     changes.mcp.length ? "MCP config updated" : null,
     changes.git.length ? `git: ${changes.git.join(", ")}` : null,
     changes.hooks.length ? `package hooks ran: ${changes.hooks.length}` : null,
-    changes.install ? `install: ${changes.install}` : null
+    changes.install ? `install: ${changes.install}` : null,
+    changes.browserInstall ? `browser install: ${changes.browserInstall}` : null
   ].filter((item) => typeof item === "string");
   if (summary.length > 0) {
     console.log("");
@@ -4984,6 +5544,15 @@ const resolvePackageManager = async (cwd, explicitPackageManager) => {
   }
   return "npm";
 };
+const createPackageManagerRunCommand = (packageManager) => {
+  if (packageManager === "npm") {
+    return "npm run";
+  }
+  if (packageManager === "bun") {
+    return "bun run";
+  }
+  return packageManager;
+};
 const resolveInitPackages = (tokens, extraTokens) => {
   const packageIds = tokens ?? [...DEFAULT_INIT_PACKAGE_IDS, ...extraTokens ?? []];
   const packages = resolveInstallPackages(packageIds);
@@ -5116,6 +5685,13 @@ const applyInitPackageJson = (cwd, selectedPackages, version, packageManager, op
   setMissingScript(packageJson, "eslint", "eslint .", changes);
   setMissingScript(packageJson, "eslint:fix", "eslint --fix .", changes);
   setMissingScript(packageJson, "publish-extension", "node scripts/publish-extension.mjs", changes);
+  setMissingScript(packageJson, "test", `${createPackageManagerRunCommand(packageManager)} test:unit && ${createPackageManagerRunCommand(packageManager)} test:browser && ${createPackageManagerRunCommand(packageManager)} test:e2e`, changes);
+  setMissingScript(packageJson, "test:unit", "vitest --run --config vitest.config.ts", changes);
+  setMissingScript(packageJson, "test:browser", "vitest --run --config vitest.config.browser.ts", changes);
+  setMissingScript(packageJson, "test:e2e", "playwright test -c vitest.config.playwright.ts", changes);
+  setMissingScript(packageJson, "test:browsers:install", "playwright install chromium", changes);
+  setMissingScript(packageJson, "serve:extension", "node scripts/serve-extension.mjs --host 127.0.0.1 --port 4175", changes);
+  setMissingScript(packageJson, "sandbox:serve", "embed-ui-v1-sandbox serve --host 127.0.0.1 --port 4173", changes);
   for (const selectedPackage of selectedPackages) {
     setDependency(
       packageJson,
@@ -5175,12 +5751,15 @@ const applyInitDirectories = (sourceRoot, options, changes) => {
     ensureDirectory(path.join(sourceRoot, "i18n/locales"), options, changes);
   }
 };
-const applyInitConfigs = (cwd, sourceRoot, options, changes) => {
+const applyInitConfigs = (cwd, sourceRoot, packageManager, options, changes) => {
   if (options.noConfigs || isGuidanceOnlyInit(options)) {
     return;
   }
   writeFileIfAllowed(path.join(cwd, "tsconfig.json"), createTsConfig(cwd, sourceRoot), options, changes);
   writeFileIfAllowed(path.join(cwd, "vite.config.ts"), createViteConfig(cwd, sourceRoot), options, changes);
+  writeFileIfAllowed(path.join(cwd, "vitest.config.ts"), createVitestConfig(cwd, sourceRoot), options, changes);
+  writeFileIfAllowed(path.join(cwd, "vitest.config.browser.ts"), createVitestBrowserConfig(cwd, sourceRoot), options, changes);
+  writeFileIfAllowed(path.join(cwd, "vitest.config.playwright.ts"), createPlaywrightConfig(cwd, sourceRoot, packageManager), options, changes);
   writeFileIfAllowed(path.join(cwd, "env.d.ts"), createEnvDts(), options, changes);
   writeFileIfAllowed(path.join(cwd, "eslint.config.js"), createEslintConfig(cwd, sourceRoot), options, changes);
 };
@@ -5204,8 +5783,12 @@ const applyInitTemplate = (cwd, sourceRoot, packageManager, options, changes) =>
   writeFileIfAllowed(path.join(sourceRoot, "i18n/locales/ru-RU.json"), createMessages(), options, changes);
   writeFileIfAllowed(path.join(sourceRoot, "pages/SettingsPage.vue"), createSettingsPage(), options, changes);
   writeFileIfAllowed(path.join(sourceRoot, "widgets/OrderCommonAfterWidget.vue"), createOrderWidget(), options, changes);
+  writeFileIfAllowed(path.join(sourceRoot, "sandbox/tests/unit/extensionrc.test.ts"), createSandboxUnitTest(options), options, changes);
+  writeFileIfAllowed(path.join(sourceRoot, "sandbox/tests/browser/starter.browser.test.ts"), createSandboxBrowserTest(cwd, sourceRoot, options), options, changes);
+  writeFileIfAllowed(path.join(sourceRoot, "sandbox/tests/e2e/starter.e2e.ts"), createSandboxE2eTest(cwd, sourceRoot), options, changes);
   writeFileIfAllowed(path.join(cwd, "extensionrc.json"), createExtensionConfig(options), options, changes);
   writeFileIfAllowed(path.join(cwd, "scripts/publish-extension.mjs"), createPublishScript(), options, changes);
+  writeFileIfAllowed(path.join(cwd, "scripts/serve-extension.mjs"), createServeScript(), options, changes);
   writeFileIfAllowed(path.join(cwd, "README.md"), createReadme(cwd, sourceRoot, options, packageManager), options, changes);
 };
 const runInstall = async (cwd, packageManager, options, changes, packageJsonChanged) => {
@@ -5233,6 +5816,39 @@ const runInstall = async (cwd, packageManager, options, changes, packageJsonChan
     throw error;
   }
 };
+const resolveRunScriptArgs = (packageManager, scriptName) => {
+  if (packageManager === "npm" || packageManager === "bun") {
+    return ["run", scriptName];
+  }
+  return [scriptName];
+};
+const createRunScriptCommand = (packageManager, scriptName) => `${createPackageManagerRunCommand(packageManager)} ${scriptName}`;
+const runBrowserInstall = async (cwd, packageManager, options, changes, packageJsonChanged) => {
+  if (options.noInstall || isGuidanceOnlyInit(options)) {
+    return;
+  }
+  if (!packageJsonChanged && !options.force) {
+    changes.skipped.push("browser install skipped because package.json was not changed");
+    return;
+  }
+  const scriptName = "test:browsers:install";
+  const args = resolveRunScriptArgs(packageManager, scriptName);
+  changes.browserInstall = createRunScriptCommand(packageManager, scriptName);
+  if (options.dryRun) {
+    return;
+  }
+  try {
+    await runCommandWithTerminalStatus(
+      packageManager,
+      args,
+      { cwd },
+      "Installing Playwright Chromium"
+    );
+  } catch (error) {
+    printExecErrorOutput(error);
+    throw error;
+  }
+};
 const applyInitGit = async (cwd, options, changes) => {
   if (!options.initGit) {
     return;
@@ -5301,10 +5917,12 @@ const runInit = async (options) => {
     packageJsonPath = applyInitPackageJson(cwd, selectedPackages, version, packageManager, resolvedOptions, changes);
     updateGitignore(cwd, resolvedOptions, changes);
     applyInitDirectories(sourceRoot, resolvedOptions, changes);
-    applyInitConfigs(cwd, sourceRoot, resolvedOptions, changes);
+    applyInitConfigs(cwd, sourceRoot, packageManager, resolvedOptions, changes);
     applyInitTemplate(cwd, sourceRoot, packageManager, resolvedOptions, changes);
   }
-  await runInstall(cwd, packageManager, resolvedOptions, changes, Boolean(packageJsonPath && changes.packageJson.length > 0));
+  const packageJsonChanged = Boolean(packageJsonPath && changes.packageJson.length > 0);
+  await runInstall(cwd, packageManager, resolvedOptions, changes, packageJsonChanged);
+  await runBrowserInstall(cwd, packageManager, resolvedOptions, changes, packageJsonChanged);
   await applyInitPackageConfigHooks(cwd, selectedPackages, packageManager, resolvedOptions, changes);
   await applyInitSkills(cwd, selectedPackages, packageManager, resolvedOptions, changes);
   await applyInitAgents(cwd, selectedPackages, packageManager, resolvedOptions, changes);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@retailcrm/embed-ui",
   "type": "module",
-  "version": "0.9.28",
+  "version": "0.9.30-alpha.1",
   "description": "API and components for creating RetailCRM UI extensions",
   "repository": {
     "type": "git",
@@ -43,9 +43,19 @@
     "build:bin": "vite build -c vite.config.bin.ts",
     "build:meta": "npx tsx scripts/build.meta.ts",
     "eslint": "eslint .",
+    "release": "conventional-release --tags",
+    "release:alpha": "conventional-release --prerelease alpha --tags",
+    "release:beta": "conventional-release --prerelease beta --tags",
+    "release:dry": "conventional-release --dry --verbose --tags",
+    "release:rc": "conventional-release --prerelease rc --tags",
     "test": "vitest --run",
+    "test:browser": "yarn workspace @retailcrm/embed-ui-v1-sandbox run test:browser",
     "test:coverage": "vitest --run --coverage"
   },
+  "release": {
+    "mode": "sync",
+    "tagPrefix": "v"
+  },
   "peerDependencies": {
     "pinia": "^2.2",
     "vue": "^3.5"
@@ -55,22 +65,22 @@
     "@floating-ui/dom": "^1.6.13",
     "@inquirer/prompts": "^8.4.3",
     "@omnicajs/symfony-router": "^1.0.0",
-    "@omnicajs/vue-remote": "^0.2.24",
+    "@omnicajs/vue-remote": "^0.2.26",
     "@remote-ui/rpc": "^1.4.5",
-    "@retailcrm/embed-ui-v1-components": "^0.9.28",
-    "@retailcrm/embed-ui-v1-contexts": "^0.9.28",
-    "@retailcrm/embed-ui-v1-endpoint": "^0.9.28",
-    "@retailcrm/embed-ui-v1-types": "^0.9.28",
+    "@retailcrm/embed-ui-v1-components": "^0.9.30-alpha.1",
+    "@retailcrm/embed-ui-v1-contexts": "^0.9.30-alpha.1",
+    "@retailcrm/embed-ui-v1-endpoint": "^0.9.30-alpha.1",
+    "@retailcrm/embed-ui-v1-types": "^0.9.30-alpha.1",
     "yargs": "^17.7.2"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.3",
     "@eslint/js": "^9.39.1",
-    "@modulify/git-toolkit": "^0.0.2",
+    "@modulify/conventional-git": "^0.1.3",
+    "@modulify/conventional-release": "^0.1.3",
     "@modulify/pkg": "^1.0.1",
     "@omnicajs/eslint-plugin-dependencies": "^0.0.2",
-    "@retailcrm/embed-ui-v1-testing": "^0.9.28",
-    "@types/git-semver-tags": "^7.0.0",
+    "@retailcrm/embed-ui-v1-testing": "^0.9.30-alpha.1",
     "@types/node": "^22.19.2",
     "@types/semver": "^7.7.1",
     "@types/yargs": "^17.0.35",
@@ -79,16 +89,12 @@
     "@vue/language-server": "^3.1.8",
     "@vue/test-utils": "^2.4.6",
     "chalk": "^5.3.0",
-    "conventional-changelog": "^6.0.0",
-    "conventional-changelog-conventionalcommits": "^8.0.0",
-    "conventional-recommended-bump": "11.2.0",
     "eslint": "^9.39.1",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-n": "^17.23.1",
     "eslint-plugin-promise": "^7.2.1",
     "eslint-plugin-vue": "^10.8.0",
     "figures": "^6.1.0",
-    "git-semver-tags": "8.0.1",
     "glob": "^13.0.0",
     "globals": "^16.5.0",
     "jsdom": "^27.3.0",