@retailcrm/embed-ui 0.9.11 → 0.9.13

package/AGENTS.md

@@ -105,4 +105,6 @@ yarn workspace @retailcrm/embed-ui-v1-components run storybook:build
 
 ## Notes
 - Do not assume legacy rules from other repositories (especially `omnica`) apply here.
+- Keep imports grouped by type-only, external, internal alias, and relative blocks, separated from each other and alphabetized within each block: this improves scanability and reduces merge conflicts when multiple PRs add imports to the same file.
+- When resolving lint issues, prefer running `eslint` with `--fix` first to avoid manual import reshuffling and unnecessary reading of repository-specific lint rules.
 - If repository policy is unclear, ask a short clarifying question before making irreversible actions.

package/CHANGELOG.md

@@ -1,6 +1,28 @@
 # Changelog
 
 
+## [0.9.13](https://github.com/retailcrm/embed-ui/compare/v0.9.12...v0.9.13) (2026-03-16)
+
+### Features
+
+* Host query contract was added ([b2bfc48](https://github.com/retailcrm/embed-ui/commit/b2bfc486f667bb97efd8d47662e32dfd39d93119))
+* **v1-components:** UiTable stories and tooling were added ([18c89ba](https://github.com/retailcrm/embed-ui/commit/18c89bac8c6481c889e0e0071cd140a6b74520c9))
+
+### Bug Fixes
+
+* **v1-components:** UiTag attrs forwarding was corrected ([e3f653b](https://github.com/retailcrm/embed-ui/commit/e3f653bac555121d06d03f1bc2832296973c8aa9))
+## [0.9.12](https://github.com/retailcrm/embed-ui/compare/v0.9.11...v0.9.12) (2026-03-11)
+
+### Features
+
+* Recursive updater scan and add mode were added ([72725e9](https://github.com/retailcrm/embed-ui/commit/72725e989fbfd8f5192ff226401ee7ad5501ad3e))
+* **v1-components:** Remote component method delegates were typed ([4bfcd4c](https://github.com/retailcrm/embed-ui/commit/4bfcd4c7964f342f581701390a370e504ef213e4))
+* **v1-components:** Vue remote tooling was applied to UiSelect ([2be366c](https://github.com/retailcrm/embed-ui/commit/2be366cec6a9dba32ff0ddb24b0716d6498880a0))
+
+### Bug Fixes
+
+* **v1-components:** Test lint violations were corrected ([8c0968c](https://github.com/retailcrm/embed-ui/commit/8c0968ccfaaacd37538bb76e2382f253ba20287e))
+* **v1-components:** UiSelect remote tests were aligned with remote tooling ([5c76150](https://github.com/retailcrm/embed-ui/commit/5c7615085c01e6c198527725c54f6f52d4764379))
 ## [0.9.11](https://github.com/retailcrm/embed-ui/compare/v0.9.11-alpha.7...v0.9.11) (2026-03-11)
 ## [0.9.11-alpha.7](https://github.com/retailcrm/embed-ui/compare/v0.9.11-alpha.6...v0.9.11-alpha.7) (2026-03-06)
 

package/Makefile

@@ -30,6 +30,33 @@ build: .require-compose ## [Build][docker][heavy] Builds all workspaces
 	$(YARN) workspaces foreach -A --topological-dev run build
 	$(TARGET_OK)
 
+.PHONY: storybook.build
+storybook.build: .require-compose ## [Build][docker][heavy] Builds Storybook for v1-components
+	$(TARGET_HEADER)
+	$(YARN) workspace @retailcrm/embed-ui-v1-components run storybook:build
+	$(TARGET_OK)
+
+.PHONY: storybook.serve
+storybook.serve: .require-compose ## [Build][docker] Runs Storybook for v1-components
+	$(TARGET_HEADER)
+	$(COMPOSE) up v1-components
+
+.PHONY: storybook.shot
+storybook.shot: .require-compose ## [Research][docker] Captures a Storybook screenshot for v1-components docs/story page
+	$(TARGET_HEADER)
+	@$(COMPOSE) up -d v1-components
+	@UID=$$(id -u) GID=$$(id -g) $(COMPOSE) run --rm playwright \
+		yarn workspace @retailcrm/embed-ui-v1-components run storybook:shot \
+			--base-url http://v1-components:6006 \
+			--path "$(if $(story_path),$(story_path),/iframe.html?viewMode=docs&id=components-uitable--docs)" \
+			--output "$(if $(output),$(output),artifacts/storybook/UiTable.docs.png)" \
+			--wait-for-selector "$(if $(wait_for),$(wait_for),#storybook-docs)" \
+			--settle-ms "$(if $(settle_ms),$(settle_ms),2500)" \
+			--timeout-ms "$(if $(timeout_ms),$(timeout_ms),60000)" \
+			--viewport-width "$(if $(viewport_width),$(viewport_width),1600)" \
+			--viewport-height "$(if $(viewport_height),$(viewport_height),1600)"
+	$(TARGET_OK)
+
 .PHONY: prepare
 prepare: .require-compose ## [Build][docker][heavy] Runs prepare in all workspaces
 	$(TARGET_HEADER)

package/README.md

@@ -8,7 +8,8 @@ API и компоненты для создания расширений инт
 
 ## Обновление версий в целевом проекте
 
-Можно запустить бинарник через `npx`, чтобы обновить пакеты `@retailcrm/embed-ui*` в `package.json` целевого проекта
+Можно запустить бинарник через `npx`, чтобы обновить пакеты `@retailcrm/embed-ui*` во всех `package.json`
+текущего рабочего дерева или выбранного поддерева
 (`dependencies`, `devDependencies`, `peerDependencies`, `optionalDependencies`).
 
 ```bash
@@ -19,6 +20,16 @@ npx @retailcrm/embed-ui --target ./my-project --dry-run
 ```
 
 По умолчанию используется последняя версия из npm. Флаг `--exact` переключает формат обновления на точную версию.
+CLI сохраняет исходные отступы и переводы строк в каждом изменяемом `package.json`.
+
+Для точечного добавления пакетов только в один `package.json` есть флаг `--add`.
+Если не передать `--packages`, CLI откроет интерактивный режим с выбором пакетов и кратким описанием.
+
+```bash
+npx @retailcrm/embed-ui --add
+npx @retailcrm/embed-ui --add --packages components,contexts
+npx @retailcrm/embed-ui --add --target ./my-project --version 0.9.11
+```
 
 ## Цели встраивания
 

package/bin/embed-ui-update.mjs

@@ -1,26 +1,82 @@
 #!/usr/bin/env node
 
+import { createInterface } from 'node:readline/promises'
 import { execFileSync } from 'node:child_process'
 import fs from 'node:fs'
 import path from 'node:path'
+import { pathToFileURL } from 'node:url'
 import process from 'node:process'
 
-const ROOT_PACKAGE = '@retailcrm/embed-ui'
-const TARGET_SECTIONS = [
+export const ROOT_PACKAGE = '@retailcrm/embed-ui'
+export const TARGET_SECTIONS = [
   'dependencies',
   'devDependencies',
   'peerDependencies',
   'optionalDependencies',
 ]
 
+export const INSTALLABLE_PACKAGES = [
+  {
+    id: 'embed-ui',
+    name: ROOT_PACKAGE,
+    section: 'dependencies',
+    description: 'Базовый пакет с общим API и согласованными v1-зависимостями.',
+  },
+  {
+    id: 'components',
+    name: '@retailcrm/embed-ui-v1-components',
+    section: 'dependencies',
+    description: 'UI-компоненты для host/remote приложений.',
+  },
+  {
+    id: 'contexts',
+    name: '@retailcrm/embed-ui-v1-contexts',
+    section: 'dependencies',
+    description: 'Реактивные контексты RetailCRM JS API.',
+  },
+  {
+    id: 'types',
+    name: '@retailcrm/embed-ui-v1-types',
+    section: 'dependencies',
+    description: 'Базовые type declarations для RetailCRM JS API.',
+  },
+  {
+    id: 'testing',
+    name: '@retailcrm/embed-ui-v1-testing',
+    section: 'devDependencies',
+    description: 'Вспомогательные утилиты и типы для тестов интеграций.',
+  },
+  {
+    id: 'endpoint',
+    name: '@retailcrm/embed-ui-v1-endpoint',
+    section: 'dependencies',
+    description: 'Endpoint API для интеграций в RetailCRM.',
+  },
+]
+
+const DEFAULT_INDENT = '  '
+const DEFAULT_NEWLINE = '\n'
+const SKIP_DIRECTORIES = new Set([
+  '.git',
+  '.hg',
+  '.svn',
+  '.yarn',
+  'node_modules',
+  'dist',
+  'build',
+  'coverage',
+])
+
 const HELP_TEXT = `Usage:
   npx @retailcrm/embed-ui [target] [version] [options]
 
 Options:
-  -t, --target <path>     Target project path (default: current directory)
+  -t, --target <path>     Target path (default: current directory)
   -v, --version <ver>     Target version. If omitted, latest npm version is used
       --exact             Use exact version instead of range
       --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
   -h, --help              Show this help
 
 Examples:
@@ -28,17 +84,27 @@ Examples:
   npx @retailcrm/embed-ui --version 0.9.11
   npx @retailcrm/embed-ui ./my-project 0.9.11
   npx @retailcrm/embed-ui --target ./my-project --dry-run
+  npx @retailcrm/embed-ui --add
+  npx @retailcrm/embed-ui --add --packages components,contexts
 `
 
 const isSemverLike = (value) => /^v?\d+\.\d+\.\d+/.test(value)
 const stripLeadingV = (value) => value.replace(/^v/, '')
 
-const parseArgs = (argv) => {
+const parsePackageList = (value) =>
+  value
+    .split(',')
+    .map((entry) => entry.trim())
+    .filter(Boolean)
+
+export const parseArgs = (argv) => {
   const options = {
     target: process.cwd(),
     version: null,
     dryRun: false,
     exact: false,
+    add: false,
+    packages: null,
   }
 
   const positionals = []
@@ -73,6 +139,17 @@ const parseArgs = (argv) => {
       continue
     }
 
+    if (argument === '--packages') {
+      const value = argv[index + 1]
+      if (!value) {
+        throw new Error('Option --packages requires a value')
+      }
+
+      options.packages = parsePackageList(value)
+      index++
+      continue
+    }
+
     if (argument === '--dry-run') {
       options.dryRun = true
       continue
@@ -83,6 +160,11 @@ const parseArgs = (argv) => {
       continue
     }
 
+    if (argument === '--add') {
+      options.add = true
+      continue
+    }
+
     if (argument.startsWith('-')) {
       throw new Error(`Unknown option: ${argument}`)
     }
@@ -111,10 +193,14 @@ const parseArgs = (argv) => {
     options.version = stripLeadingV(positionals[1])
   }
 
+  if (options.packages && !options.add) {
+    throw new Error('Option --packages can only be used together with --add')
+  }
+
   return options
 }
 
-const resolveLatestVersion = () => {
+export const resolveLatestVersion = () => {
   const output = execFileSync(
     'npm',
     ['view', ROOT_PACKAGE, 'version'],
@@ -131,10 +217,12 @@ const resolveLatestVersion = () => {
   return output
 }
 
-const isTargetPackage = (name) =>
+export const isTargetPackage = (name) =>
   name === ROOT_PACKAGE || name.startsWith(`${ROOT_PACKAGE}-`)
 
-const formatRange = (currentRange, nextVersion, exact) => {
+const createRange = (version, exact) => exact ? version : `^${version}`
+
+export const formatRange = (currentRange, nextVersion, exact) => {
   if (exact) {
     return nextVersion
   }
@@ -154,18 +242,107 @@ const formatRange = (currentRange, nextVersion, exact) => {
   return `^${nextVersion}`
 }
 
-const main = () => {
-  const options = parseArgs(process.argv.slice(2))
-  const version = options.version ?? resolveLatestVersion()
+export const detectFormatting = (source) => {
+  const newline = source.includes('\r\n') ? '\r\n' : DEFAULT_NEWLINE
+  const indentMatch = source.match(/\n([ \t]+)"/)
+
+  return {
+    indent: indentMatch?.[1] ?? DEFAULT_INDENT,
+    newline,
+    trailingNewline: source.endsWith('\n') || source.endsWith('\r\n'),
+  }
+}
+
+export const serializePackageJson = (packageJson, formatting) => {
+  const serialized = JSON.stringify(packageJson, null, formatting.indent)
+    .replace(/\n/g, formatting.newline)
+
+  return formatting.trailingNewline
+    ? `${serialized}${formatting.newline}`
+    : serialized
+}
+
+const ensureDirectoryExists = (targetPath) => {
+  if (!fs.existsSync(targetPath)) {
+    throw new Error(`Path not found: ${targetPath}`)
+  }
+
+  const stat = fs.statSync(targetPath)
+  if (!stat.isDirectory()) {
+    throw new Error(`Target is not a directory: ${targetPath}`)
+  }
+}
+
+export const resolvePackageJsonPath = (targetPath) => {
+  if (path.basename(targetPath) === 'package.json') {
+    if (!fs.existsSync(targetPath)) {
+      throw new Error(`package.json not found: ${targetPath}`)
+    }
+
+    return targetPath
+  }
+
+  const packageJsonPath = path.resolve(targetPath, 'package.json')
 
-  const packageJsonPath = path.resolve(options.target, 'package.json')
   if (!fs.existsSync(packageJsonPath)) {
     throw new Error(`package.json not found: ${packageJsonPath}`)
   }
 
-  const source = fs.readFileSync(packageJsonPath, 'utf8')
-  const packageJson = JSON.parse(source)
+  return packageJsonPath
+}
+
+export const collectPackageJsonPaths = (targetPath) => {
+  const resolvedTarget = path.resolve(targetPath)
+
+  if (!fs.existsSync(resolvedTarget)) {
+    throw new Error(`Path not found: ${resolvedTarget}`)
+  }
+
+  if (path.basename(resolvedTarget) === 'package.json') {
+    return [resolvedTarget]
+  }
 
+  ensureDirectoryExists(resolvedTarget)
+
+  const packageJsonPaths = []
+
+  const visit = (directoryPath) => {
+    const packageJsonPath = path.join(directoryPath, 'package.json')
+    if (fs.existsSync(packageJsonPath) && fs.statSync(packageJsonPath).isFile()) {
+      packageJsonPaths.push(packageJsonPath)
+    }
+
+    for (const entry of fs.readdirSync(directoryPath, { withFileTypes: true })) {
+      if (!entry.isDirectory() || entry.isSymbolicLink()) {
+        continue
+      }
+
+      if (SKIP_DIRECTORIES.has(entry.name)) {
+        continue
+      }
+
+      visit(path.join(directoryPath, entry.name))
+    }
+  }
+
+  visit(resolvedTarget)
+
+  return packageJsonPaths.sort()
+}
+
+const findDependencySection = (packageJson, packageName) => {
+  for (const section of TARGET_SECTIONS) {
+    const dependencyMap = packageJson[section]
+
+    if (dependencyMap && typeof dependencyMap === 'object' && packageName in dependencyMap) {
+      return section
+    }
+  }
+
+  return null
+}
+
+export const updatePackageJson = (packageJson, version, exact) => {
   const updates = []
 
   for (const section of TARGET_SECTIONS) {
@@ -176,21 +353,18 @@ const main = () => {
     }
 
     for (const [name, currentRange] of Object.entries(dependencyMap)) {
-      if (!isTargetPackage(name)) {
-        continue
-      }
-
-      if (typeof currentRange !== 'string') {
+      if (!isTargetPackage(name) || typeof currentRange !== 'string') {
         continue
       }
 
-      const nextRange = formatRange(currentRange, version, options.exact)
+      const nextRange = formatRange(currentRange, version, exact)
       if (nextRange === currentRange) {
         continue
       }
 
       dependencyMap[name] = nextRange
       updates.push({
+        type: 'update',
         section,
         name,
         currentRange,
@@ -199,31 +373,245 @@ const main = () => {
     }
   }
 
-  if (updates.length === 0) {
-    console.log(`No ${ROOT_PACKAGE}* dependencies found or changed in ${packageJsonPath}`)
+  return updates
+}
+
+export const resolveInstallPackages = (tokens) => {
+  const selectedPackages = []
+  const seen = new Set()
+
+  for (const token of tokens) {
+    const normalized = token.trim()
+    if (!normalized) {
+      continue
+    }
+
+    const numericIndex = Number(normalized)
+    const selectedPackage =
+      Number.isInteger(numericIndex) && numericIndex >= 1 && numericIndex <= INSTALLABLE_PACKAGES.length
+        ? INSTALLABLE_PACKAGES[numericIndex - 1]
+        : INSTALLABLE_PACKAGES.find((entry) => entry.id === normalized || entry.name === normalized)
+
+    if (!selectedPackage) {
+      const supported = INSTALLABLE_PACKAGES
+        .map((entry, index) => `${index + 1}/${entry.id}/${entry.name}`)
+        .join(', ')
+
+      throw new Error(`Unknown add target "${normalized}". Supported values: ${supported}`)
+    }
+
+    if (seen.has(selectedPackage.name)) {
+      continue
+    }
+
+    seen.add(selectedPackage.name)
+    selectedPackages.push(selectedPackage)
+  }
+
+  return selectedPackages
+}
+
+export const installPackages = (packageJson, packages, version, exact) => {
+  const updates = []
+
+  for (const selectedPackage of packages) {
+    const section = findDependencySection(packageJson, selectedPackage.name) ?? selectedPackage.section
+    const dependencyMap = packageJson[section] ?? {}
+
+    if (!(section in packageJson)) {
+      packageJson[section] = dependencyMap
+    }
+
+    const currentRange = dependencyMap[selectedPackage.name]
+    const nextRange = typeof currentRange === 'string'
+      ? formatRange(currentRange, version, exact)
+      : createRange(version, exact)
+
+    if (currentRange === nextRange) {
+      continue
+    }
+
+    dependencyMap[selectedPackage.name] = nextRange
+    updates.push({
+      type: typeof currentRange === 'string' ? 'update' : 'install',
+      section,
+      name: selectedPackage.name,
+      currentRange: typeof currentRange === 'string' ? currentRange : null,
+      nextRange,
+    })
+  }
+
+  return updates
+}
+
+export const promptForInstallSelection = async (packageJson) => {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error('Interactive add mode requires a TTY. Use --packages to select packages explicitly.')
+  }
+
+  console.log('Выберите пакеты для установки в текущий package.json:')
+  for (const [index, selectedPackage] of INSTALLABLE_PACKAGES.entries()) {
+    const currentSection = findDependencySection(packageJson, selectedPackage.name)
+    const installedHint = currentSection ? ` Уже есть в ${currentSection}.` : ''
+
+    console.log(`  ${index + 1}. ${selectedPackage.name} (${selectedPackage.id})`)
+    console.log(`     ${selectedPackage.description} Раздел по умолчанию: ${selectedPackage.section}.${installedHint}`)
+  }
+
+  const readline = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  })
+
+  try {
+    while (true) {
+      const answer = await readline.question(
+        'Введите номера, ids или имена пакетов через запятую (например: 1,3 или components,types): '
+      )
+
+      const tokens = parsePackageList(answer)
+      if (tokens.length === 0) {
+        return []
+      }
+
+      try {
+        return resolveInstallPackages(tokens)
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error)
+        console.error(message)
+      }
+    }
+  } finally {
+    readline.close()
+  }
+}
+
+const readPackageJson = (packageJsonPath) => {
+  const source = fs.readFileSync(packageJsonPath, 'utf8')
+
+  return {
+    formatting: detectFormatting(source),
+    packageJson: JSON.parse(source),
+  }
+}
+
+const writePackageJson = (packageJsonPath, packageJson, formatting) => {
+  fs.writeFileSync(packageJsonPath, serializePackageJson(packageJson, formatting), 'utf8')
+}
+
+const printChanges = (changes) => {
+  for (const change of changes) {
+    const prefix = change.type === 'install'
+      ? `${change.section}: ${change.name} -> ${change.nextRange}`
+      : `${change.section}: ${change.name} ${change.currentRange} -> ${change.nextRange}`
+
+    console.log(`  ${prefix}`)
+  }
+}
+
+export const runUpdate = (options) => {
+  const version = options.version ?? resolveLatestVersion()
+  const packageJsonPaths = collectPackageJsonPaths(options.target)
+  const reports = []
+
+  for (const packageJsonPath of packageJsonPaths) {
+    const { formatting, packageJson } = readPackageJson(packageJsonPath)
+    const updates = updatePackageJson(packageJson, version, options.exact)
+
+    if (updates.length === 0) {
+      continue
+    }
+
+    if (!options.dryRun) {
+      writePackageJson(packageJsonPath, packageJson, formatting)
+    }
+
+    reports.push({ packageJsonPath, updates })
+  }
+
+  if (reports.length === 0) {
+    console.log(`No ${ROOT_PACKAGE}* dependencies found or changed under ${path.resolve(options.target)}`)
     return
   }
 
+  const totalUpdates = reports.reduce((sum, report) => sum + report.updates.length, 0)
+
   console.log(`Resolved version: ${version}`)
-  for (const update of updates) {
-    console.log(
-      `${update.section}: ${update.name} ${update.currentRange} -> ${update.nextRange}`
-    )
+  for (const report of reports) {
+    console.log(report.packageJsonPath)
+    printChanges(report.updates)
   }
 
+  if (options.dryRun) {
+    console.log('Dry run enabled, package.json files were not modified')
+    return
+  }
+
+  console.log(
+    `Updated ${totalUpdates} dependency entries in ${reports.length} package.json file(s) under ${path.resolve(options.target)}`
+  )
+}
+
+export const runAdd = async (options) => {
+  const version = options.version ?? resolveLatestVersion()
+  const packageJsonPath = resolvePackageJsonPath(path.resolve(options.target))
+  const { formatting, packageJson } = readPackageJson(packageJsonPath)
+  const selectedPackages = options.packages
+    ? resolveInstallPackages(options.packages)
+    : await promptForInstallSelection(packageJson)
+
+  if (selectedPackages.length === 0) {
+    console.log('Nothing selected, package.json was not modified')
+    return
+  }
+
+  const updates = installPackages(packageJson, selectedPackages, version, options.exact)
+
+  if (updates.length === 0) {
+    console.log(`Selected packages are already installed with matching ranges in ${packageJsonPath}`)
+    return
+  }
+
+  console.log(`Resolved version: ${version}`)
+  console.log(packageJsonPath)
+  printChanges(updates)
+
   if (options.dryRun) {
     console.log('Dry run enabled, package.json was not modified')
     return
   }
 
-  fs.writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, 'utf8')
-  console.log(`Updated ${updates.length} dependency entries in ${packageJsonPath}`)
+  writePackageJson(packageJsonPath, packageJson, formatting)
+  console.log(`Installed ${updates.length} package entries in ${packageJsonPath}`)
+}
+
+export const main = async (argv = process.argv.slice(2)) => {
+  const options = parseArgs(argv)
+
+  if (options.add) {
+    await runAdd(options)
+    return
+  }
+
+  runUpdate(options)
+}
+
+const isExecutedDirectly = () => {
+  const entryPath = process.argv[1]
+
+  if (!entryPath) {
+    return false
+  }
+
+  return pathToFileURL(path.resolve(entryPath)).href === import.meta.url
 }
 
-try {
-  main()
-} catch (error) {
-  const message = error instanceof Error ? error.message : String(error)
-  console.error(message)
-  process.exit(1)
+if (isExecutedDirectly()) {
+  try {
+    await main()
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    console.error(message)
+    process.exit(1)
+  }
 }