docs: update READMEs for v5, add Russian changelog/migration

veged · claude · veged · commit 4acaec57521e · 2026-02-27T13:12:49.000+03:00
- Replace Travis CI / david-dm badges with GitHub Actions badge
- Update development instructions (Vite, Playwright, node:test)
- Remove vow from block list, update browser support
- Add 5.0.0 sections to CHANGELOG.ru.md and MIGRATION.ru.md

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/CHANGELOG.ru.md b/CHANGELOG.ru.md
@@ -1,5 +1,43 @@
 # История изменений
 
+## 5.0.0
+
+### Несовместимые изменения
+
+- **Только ESM**: Вся кодовая база мигрирована с модульной системы `ym` (`modules.define`/`modules.require`) на нативные ES-модули (`import`/`export`). Зависимость `ym` удалена.
+- **Сборка через Vite**: ENB и все 17+ связанных пакетов заменены на [Vite](https://vite.dev/). Кастомный плагин `vite-plugin-bem-levels` обеспечивает сканирование BEM-уровней, разрешение виртуальных модулей `bem:*` и генерацию barrel-файлов для цепочек переопределений.
+- **jQuery 4.0**: Peer-зависимость `jquery` обновлена с `^3.x` до `^4.0.0`. Основное изменение API: `$.unique()` удалён — используйте `$.uniqueSort()`.
+- **Node.js 20+**: Минимальная поддерживаемая версия Node.js — 20 (было 8).
+- **Нативные промисы**: `vow` удалён. Весь код использует нативный `Promise`.
+- **Нативный тест-раннер**: Серверные тесты используют `node:test` и `node:assert` вместо `mocha`/`chai`.
+- **Playwright**: Браузерные тесты используют [Playwright](https://playwright.dev/) вместо `mocha-phantomjs` (PhantomJS мёртв).
+- **ESLint 10**: Линтинг мигрирован с `jshint`/`jscs` на ESLint 10 с flat-конфигурацией (`eslint.config.js`).
+- **GitHub Actions CI**: Travis CI заменён на GitHub Actions.
+- **Husky + lint-staged**: `git-hooks` заменён на `husky` и `lint-staged`.
+
+### Крупные изменения
+
+- Все `.vanilla.js` и `.js` файлы конвертированы в ES-модули с синтаксисом `import`/`export`.
+- Цепочки переопределений модулей (напр., `jquery` с расширениями pointer-событий) обрабатываются автоматически сгенерированными barrel-файлами через `vite-plugin-bem-levels`.
+- Блок `i18n` сохраняет свой API, но использует нативные ES-модули внутри.
+- Браузерные спек-тесты (28 файлов, 500+ тестов) запускаются через Vite dev server + Playwright.
+- Vite генерирует платформенно-специфичные сборки (`desktop`, `touch`) с jQuery как внешней зависимостью.
+
+### Удалённые пакеты
+
+- **Сборка**: `enb`, `enb-bem-techs`, `enb-magic-factory`, `enb-magic-platform`, `enb-bemxjst`, `enb-bemxjst-6x`, `enb-bemxjst-7x`, `enb-bemxjst-i18n`, `enb-bh`, `enb-bh-i18n`, `enb-borschik`, `enb-css`, `enb-js`, `enb-bem-docs`, `enb-bem-examples`, `enb-bem-specs`, `enb-bem-tmpl-specs`, `enb-bem-i18n`, `borschik`
+- **Линтинг**: `jscs`, `jscs-bem`, `jshint`, `jshint-groups`
+- **Тестирование**: `mocha-phantomjs`, `istanbul`, `chai-as-promised`
+- **Прочие**: `ym`, `vow`, `bower`, `git-hooks`, `gitbook-api`, `bem-naming`, `bem-walk`
+
+### Удалённые конфигурационные файлы
+
+- `.enb/` (конфигурация сборки ENB)
+- `.jshintrc`, `.jscs.json`, `.jshint-groups.js` (конфигурация линтинга)
+- `.bowerrc`, `bower.json` (конфигурация Bower)
+- `.travis.yml` (конфигурация Travis CI)
+- `.githooks/` (конфигурация git-hooks)
+
 ## 4.3.1
 
 ### В релиз вошли следующие исправления ошибок
diff --git a/MIGRATION.ru.md b/MIGRATION.ru.md
@@ -1,5 +1,121 @@
 # Миграция
 
+## 5.0.0
+
+### ym → ES-модули
+
+Модульная система `ym` (`modules.define`/`modules.require`) заменена на нативные ES-модули.
+
+Было:
+
+```js
+modules.define('my-block', ['i-bem-dom', 'events'], function(provide, bemDom, events) {
+
+provide(bemDom.declBlock(this.name, { /* ... */ }));
+
+});
+```
+
+Стало:
+
+```js
+import bemDom from 'bem:i-bem-dom';
+import events from 'bem:events';
+
+export default bemDom.declBlock('my-block', { /* ... */ });
+```
+
+Все `bem:*` импорты разрешаются на этапе сборки плагином `vite-plugin-bem-levels` в реальные пути файлов с учётом приоритетов уровней для конкретной платформы.
+
+### Переопределения модулей
+
+Переопределения модулей, которые ранее использовали `modules.define` с колбэком, получающим предыдущее значение модуля, теперь обрабатываются через barrel-файлы, генерируемые Vite-плагином.
+
+Было (переопределение ym):
+
+```js
+modules.define('jquery', function(provide, $) {
+    $.event.special.pointerclick = { /* ... */ };
+    provide($);
+});
+```
+
+Стало (side-effect импорт в barrel-файле):
+
+```js
+// Barrel-файл автоматически сгенерирован vite-plugin-bem-levels:
+import $ from '../../common.blocks/jquery/jquery.js';
+import '../../common.blocks/jquery/__event/_type/jquery__event_type_pointerclick.js';
+export default $;
+```
+
+### jQuery 3 → 4
+
+Peer-зависимость `jquery` теперь `^4.0.0`.
+
+Основные несовместимые изменения в jQuery 4:
+- `$.unique()` удалён. Используйте `$.uniqueSort()`.
+- Ряд устаревших методов удалён. См. [руководство по обновлению jQuery 4.0](https://jquery.com/upgrade-guide/4.0/).
+
+### vow → нативный Promise
+
+Зависимость `vow` удалена. Весь асинхронный код теперь использует нативный `Promise`.
+
+Было:
+
+```js
+var vow = require('vow');
+var promise = vow.resolve(value);
+```
+
+Стало:
+
+```js
+const promise = Promise.resolve(value);
+```
+
+### Система сборки: ENB → Vite
+
+Весь инструментарий ENB заменён на Vite.
+
+Было:
+
+```bash
+./node_modules/.bin/enb make
+```
+
+Стало:
+
+```bash
+npm run build           # обе платформы
+npm run build:desktop   # только desktop
+npm run build:touch     # только touch
+```
+
+Конфигурация Vite находится в `build/vite.config.js`. Кастомный плагин `vite-plugin-bem-levels` в `build/plugins/` обеспечивает сканирование BEM-уровней и разрешение модулей.
+
+### Node.js 20+
+
+Минимальная поддерживаемая версия Node.js — 20 (было 8). Обновите `.nvmrc` или конфигурацию CI.
+
+### Линтинг: jshint/jscs → ESLint 10
+
+Замените кастомные `.jshintrc` или `.jscs.json` правила на flat-конфигурацию ESLint (`eslint.config.js`).
+
+### Тестирование
+
+- **Серверные тесты**: `mocha`/`chai` заменены на `node:test`/`node:assert`.
+- **Браузерные тесты**: `mocha-phantomjs` заменён на Playwright. Запуск: `npm run test:browser`.
+- **Все тесты**: `npm run test:all` запускает серверные и браузерные тесты.
+
+### CI/CD: Travis → GitHub Actions
+
+Замените `.travis.yml` на `.github/workflows/ci.yml`. Новый CI запускает задачи lint, test, test:browser и build.
+
+### Git-хуки: git-hooks → husky
+
+Замените `.githooks/` на конфигурацию husky. Скрипт `prepare` в `package.json` автоматически настраивает husky при `npm install`.
+
 ## 4.0.0
 
 ### Изменения в блоке `i-bem`
diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
-# bem-core library [![Build Status](https://travis-ci.org/bem/bem-core.svg?branch=v2)](https://travis-ci.org/bem/bem-core) [![GitHub Release](https://img.shields.io/github/release/bem/bem-core.svg)](https://github.com/bem/bem-core/releases) [![devDependency Status](https://david-dm.org/bem/bem-core/dev-status.svg)](https://david-dm.org/bem/bem-core#info=devDependencies)
+# bem-core library [![CI](https://github.com/bem/bem-core/actions/workflows/ci.yml/badge.svg?branch=v5)](https://github.com/bem/bem-core/actions/workflows/ci.yml) [![GitHub Release](https://img.shields.io/github/release/bem/bem-core.svg)](https://github.com/bem/bem-core/releases)
 
-Documentation on `bem-core` in a much more informative way is also available at [bem.info](https://en.bem.info/libs/bem-core/). It is also available [in Russian](https://ru.bem.info/libs/bem-core/).
+Documentation on `bem-core` is also available at [bem.info](https://en.bem.info/libs/bem-core/). It is also available [in Russian](https://ru.bem.info/libs/bem-core/).
 
 ## What is this?
 
@@ -9,11 +9,17 @@ It provides the minimal stack for coding client-side JavaScript and templating.
 
 ## Use
 
-The easiest way to run a project with `bem-core` is to use
-the [project-stub](https://github.com/bem/project-stub).
+Install as an npm dependency:
 
-You can use any other way you are familiar with to include the library into
-the project.
+```shell
+npm install bem-core@5
+```
+
+jQuery 4 is a peer dependency — install it alongside:
+
+```shell
+npm install jquery@^4.0.0
+```
 
 ## Inside
 
@@ -30,7 +36,7 @@ the project.
   - `objects` — helpers for JS-objects
   - `functions` — helpers for JS-functions
   - `events` — JS-events
-  - `querystring` — helpers for work with querystring
+  - `uri` — helpers for work with URIs and querystrings
   - `tick` — global timer
   - `idle` — IDLE event
   - `next-tick` — polyfill for `nextTick`/`setTimeout(0, ...)`
@@ -39,7 +45,6 @@ the project.
   - `clearfix` — CSS clearfix trick
   - `identify` — identify JS-objects
   - `cookie` — helpers for work with browser cookies
-  - `vow` — Promises/A+ implementation
   - `dom` — helpers for work with DOM
   - `loader` — loader for JS files
   - `ua` — browser features detection
@@ -58,125 +63,54 @@ The autogenerated JSDoc API can be found on bem.info. E.g. JSDoc for `i-bem` is
 
 ## Changelog
 
-You can check the changelog at the [Changelog](https://bem.info/libs/bem-core/changelog/) page.
+See [CHANGELOG.md](CHANGELOG.md).
 
 ## Migration
 
-If you used BEM before, check the [migration instructions](https://bem.info/libs/bem-core/migration/).
+If you are upgrading from v4, see [MIGRATION.md](MIGRATION.md).
 
 ## Development
 
 ### Working copy
 
-1. Get the needed version code (e.g., `v4`):
+1. Get the source code:
    ```shell
-   $ git clone -b v4 git://github.com/bem/bem-core.git
-   $ cd bem-core
+   git clone -b v5 git://github.com/bem/bem-core.git
+   cd bem-core
    ```
 
-2. Install the dependencies:
+2. Install the dependencies (requires Node.js 20+):
    ```shell
-   $ npm install
+   npm install
    ```
 
-   You need `export PATH=./node_modules/.bin:$PATH`
-   or an alternative way to run locally-installed `npm` dependencies.
-
-3. Install all necessary libraries:
+3. Run linting:
    ```shell
-   $ npm run deps
+   npm run lint
    ```
 
-4. Build and run tests (specs):
+4. Run tests:
    ```shell
-   $ npm test
+   npm test              # server-side tests (node:test)
+   npm run test:browser  # browser tests (Playwright)
+   npm run test:all      # both
    ```
 
-5. Run development server:
+5. Build:
    ```shell
-   $ npm start
+   npm run build         # desktop + touch platforms
    ```
 
 ### How to contribute
 
 Please refer to [How to contribute](/CONTRIBUTING.md) guide.
 
-### Modular testing
-
-A default test bundle for `functions__debounce`:
-```shell
-$ magic make desktop.specs/functions__debounce
-```
-
-You can see the results of the tests in the terminal after the building process finishes.
-
-You can also watch them in a browser loading `desktop.specs/functions__debounce/spec-js+browser-js+bemhtml/spec-js+browser-js+bemhtml.html`.
-
-Run tests for other BEM entities in the same way. This will work for those which are equipped with `.spec.js` file.
-
-### Code coverage
-
-To build code coverage report add `ISTANBUL_COVERAGE=yes` environment variable to the tests run command:
-```shell
-$ ISTANBUL_COVERAGE=yes magic make desktop.specs && istanbul report html
-```
-
-You can run modular testing with coverage as well by using more concrete build target as was described above.
-```
-$ ISTANBUL_COVERAGE=yes magic make desktop.specs/functions__debounce && istanbul report html
-```
-
-After tests finish, you can view coverage HTML report by opening `coverage/index.html` in your favorite
-browser.
-
-The whole code coverage statistics can be found on the [bem-core profile page](https://coveralls.io/r/bem/bem-core) on
-[Coveralls](https://coveralls.io).
-
-Tests are built with a [enb-bem-specs](https://github.com/enb-bem/enb-bem-specs/) library.
-Check the [details](https://ru.bem.info/tools/bem/enb-bem-specs/) (available in Russian only).
-
 ## Supported browsers
 
-Our browser support policy is based on statistics we get from [Yandex](https://company.yandex.com) services.
-
-Browsers with more than 2% users get full compliant support, more than 0.5% — partially compliant
-(which means that data is accessible but not necessary 100% functional). New features testing
-is not provided by us for  browsers with less than 0.5% users.
-
-### Desktop
-
-#### Fully compliant
-
-  - Google Chrome 29+
-  - Firefox 24+
-  - Yandex 1.7+
-  - Opera 12.16
-  - MSIE 10.0
-  - MSIE 9.0
-  - MSIE 8.0
-  - Opera 12.15
-
-#### Partially compliant
-
-  - Opera 17.0
-  - Opera 16.0
-  - Opera 12.14
-  - Opera 12.2
-  - Firefox 23
-
-### Touch
-
-#### Fully compliant
-
-  - iOS 6+
-  - Android 2.3+
-  - Opera Mobile 12+
-  - Windows Phone 7+
-
-#### Partially compliant
-
-  - iOS 5
-  - Android 2.2
+  - Google Chrome (latest)
+  - Firefox (latest)
+  - Safari (latest)
+  - Edge (latest)
 
 ## License
 Code and documentation copyright 2012 YANDEX LLC. Code released under the [Mozilla Public License 2.0](LICENSE.txt).
diff --git a/README.ru.md b/README.ru.md
