mdt-module-builder 1.0.4 → 2.1.0

package/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+Все заметные изменения пакета документируются в этом файле.
+
+Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/), версии — [Semantic Versioning](https://semver.org/lang/ru/).
+Правила major/minor/patch для этого пакета — см. README, раздел «Версионирование»: изменения
+контракта (имя глобала, `SHARED_EXACT`, мажор React, источник Tailwind-классов модуля) — всегда
+major, т.к. потребители фиксируют зависимость через `^1.x` и автоматически подхватят любой minor/patch.
+
+## [Unreleased]
+
+### Added
+
+- В `SHARED_GLOBALS` добавлены 8 спецификаторов (MP-16155): `@tanstack/react-virtual`,
+  `@tanstack/react-table`, `@dnd-kit/core`, `@dnd-kit/utilities`, `dnd-timeline`,
+  `tailwind-variants`, `react-hook-form`, `zod`. Модуль их больше не бандлит — читает инстанс
+  MDT из `globalThis.__mdtShared`.
+  Мотив: react-table, dnd-kit, react-hook-form и zod — зависимости самого `ics-ui-kit`, и своя
+  копия в модуле давала бы второй `DndContext`/`FormProvider` рядом с ui-kit (тот же класс
+  поломки, что две копии React); react-virtual нужен ≥ 2 модулям; `tailwind-variants` тянет
+  `tailwind-merge`, который должен быть общим с ui-kit; `dnd-timeline` обязан сидеть на том же
+  `@dnd-kit/core`.
+- **Minor, не major.** Обратно совместимо для любого модуля, который эти 8 библиотек не
+  импортирует, — для него поведение не меняется вообще. Единственный теоретический риск —
+  модуль, который уже импортирует одну из них и рассчитывает на бандлинг: после апгрейда билдера
+  тот же импорт станет externalize-иться и на MDT без этого патча (MP-16155) превратится в
+  `undefined` без ошибки сборки. Проверено: единственный сегодняшний потребитель билдера
+  (`promo-tool`) закреплён на `mdt-module-builder ^1.0.0` и не подхватит эту версию автоматически
+  в любом случае; среди модулей, которые реально импортируют что-то из списка выше, ни один не
+  собирается билдером на `^2.x`. Риска молчаливой поломки уже работающей сборки нет — поэтому,
+  в отличие от 2.0.0, это не major (см. README, §Версионирование, и SHARED-DEPENDENCIES.md,
+  «Расширение SHARED_GLOBALS»). Реально начать пользоваться выносом (импортировать что-то из
+  списка и рассчитывать на общий инстанс) можно только на MDT с этим патчем.
+
+### Removed
+
+- Билдер больше не собирает Tailwind CSS модуля (`generateModuleTailwindCss`, `loadIcsPreset` —
+  удалены из пакета). Модуль перестаёт вести собственную, независимую Tailwind-сборку — источник
+  Tailwind-классов теперь один: курируемый safelist core-сборки MDT (`ui/tailwind-safelist.mjs`).
+  Причина — MP-16147: две независимые Tailwind-сборки ломали гарантию порядка CSS-правил
+  (`base` перед `variant`), из-за чего голая утилита модуля могла перебить адаптивный вариант
+  ui-kit (`.h-10` модуля поверх `.lg:h-9` из `ics-ui-kit`).
+- Зависимость `tailwindcss` убрана из `package.json` — больше не используется пакетом.
+
+### Changed
+
+- **Ломающее изменение контракта.** Модуль, собранный этой версией, требует MDT с уже подключённым
+  курируемым Tailwind-safelist (`safelist` в core-сборке). Классы, которых нет в safelist,
+  физически не применятся в рантайме модуля — добавляются в MDT по мере реальной потребности
+  (см. `ui/build_tools/tailwind-inventory.md`).
+- Модуль-специфичная стилизация — только обычный CSS (`import "./x.css"`, без изменений в этой
+  части — `postcss-nested` + `autoprefixer` как и раньше), не Tailwind-утилиты.
+
+## Версии до 2.0.0
+
+Пакет публиковался (`npm run release`, без git-тега) без чейнджлога — история 1.0.0…1.0.4 не
+восстановлена задним числом (нет надёжного источника: релизы не коммитятся в git). Ведение
+чейнджлога начинается с этой версии.

package/README.md

@@ -4,6 +4,8 @@
 модуля, выдавая **тот же по контракту артефакт**: один `dist/index.js` (IIFE), который при загрузке
 через `<script>` самовыполняется и зовёт `window.MDT.registerModule`.
 
+История изменений — [CHANGELOG.md](./CHANGELOG.md).
+
 ## Использование
 
 В `package.json` модуля:
@@ -11,7 +13,7 @@
 ```json
 {
   "scripts": { "build": "mdt-module-build" },
-  "devDependencies": { "mdt-module-builder": "^1.0.0" },
+  "devDependencies": { "mdt-module-builder": "^2.0.0" },
   "dependencies": { "mdt-client": "^31", "ics-ui-kit": "...", "lucide-react": "..." },
   "peerDependencies": { "react": "^19", "react-dom": "^19" }
 }
@@ -27,9 +29,14 @@ devtool/builder вызывают `npm run build` в репе модуля — м
   Заменяются alias-шимами, читающими `globalThis.__mdtShared[spec]` (MDT ставит его при старте).
   → один инстанс React во всём рантайме, нет «Invalid hook call».
   → react/react-dom **не обязаны быть установлены** при сборке (имена их экспортов зашиты в пакет).
-- **`SHARED_GLOBALS`** (`@tanstack/react-query`, `zustand` + подпути, `echarts`, `echarts-for-react`)
+- **`SHARED_GLOBALS`** (`@tanstack/react-query`, `zustand` + подпути, `echarts`, `echarts-for-react`,
+  `@tanstack/react-virtual`, `@tanstack/react-table`, `@dnd-kit/core`, `@dnd-kit/utilities`,
+  `dnd-timeline`, `tailwind-variants`, `react-hook-form`, `zod`)
   — НЕ бандлятся: externalize + чтение `globalThis.__mdtShared[spec]`. В отличие от react-семьи,
-  имена экспортов перечислять не нужно. Как вынести новую такую зависимость — см. [SHARED-DEPENDENCIES.md](./SHARED-DEPENDENCIES.md).
+  имена экспортов перечислять не нужно. Полный список с версиями и обоснованием, а также порядок
+  выноса новой такой зависимости — см. [SHARED-DEPENDENCIES.md](./SHARED-DEPENDENCIES.md).
+  Перечислены только корневые спецификаторы (кроме `zustand`): сабпас — отдельный спецификатор,
+  добавляется по факту потребности модуля, не «про запас».
 - **ics-ui-kit** (сам пакет и любой сабпас — `ics-ui-kit/components/*`, `ics-ui-kit/lib/*`, …) —
   НЕ бандлится: externalize по префиксу (`SHARED_PREFIXES`) + чтение `globalThis.__mdtShared[spec]`.
   Сабпасы перечислять не нужно. MDT кладёт туда свой инстанс (vite-app `legacy/shared-ui-kit.ts`),
@@ -45,11 +52,15 @@ devtool/builder вызывают `npm run build` в репе модуля — м
   тянет только used-иконки (единицы, ~КБ). Пара дублей по модулям несравнимо дешевле, чем вся lucide в MDT.
 - **CSS** инлайнится в `index.js` (рантайм-инъекция `<style>`), как старый style-loader —
   оверлей копирует только `index.js`, отдельного `.css` нет.
-- **Tailwind (вариант A)** — билдер сам генерит утилиты Tailwind, найденные **только в `src`
-  модуля**, и подмешивает их в ту же инъекцию CSS. Модулю не нужен ни `tailwindcss`, ни конфиг:
-  пресет берётся из `ics-ui-kit` модуля, `preflight` выключен, базовый reset и токены
-  (`--primary` и пр.) даёт MDT глобально. ui-kit из `node_modules` повторно не сканируется —
-  его классы уже эмитит основная сборка MDT. Возможны дубли утилит между модулями — это принято.
+- **Tailwind модуль больше не собирает** (с версии 2.0.0, MP-16147). Раньше билдер сам генерил
+  утилиты Tailwind из `src` модуля второй, независимой сборкой — это ломало гарантию порядка
+  правил (`base` перед `variant`), на которой держится mobile-first: голая утилита модуля могла
+  перебить вариант ui-kit (`.h-10` модуля поверх `.lg:h-9` из `ics-ui-kit`). Теперь Tailwind-классы
+  модулю даёт единственная, core-сборка MDT — по курируемому `tailwind-safelist.mjs`
+  (собран из реально используемых модулями классов, см. `tailwind-inventory.mjs`). Класс, которого
+  нет в safelist, физически не применится в рантайме — не задача сборки, а несовпадение safelist;
+  добавляется в MDT по мере реальной потребности. Модуль-специфичная стилизация — обычный CSS
+  (`import "./x.css"`, см. ниже), не Tailwind.
 
 ## Совместимость исходников модуля (webpack → Vite)
 
@@ -61,7 +72,12 @@ devtool/builder вызывают `npm run build` в репе модуля — м
   маппинга; `prefix/*` → wildcard с захватом хвоста, точный ключ → строковый алиас.
 - **CSS-вложенность.** Компонентный CSS модуля (`import "./x.css"`) прогоняется через
   `postcss-nested` (Sass-подобный `&`) + `autoprefixer` — та же семантика, что у старого
-  `postcss-loader`. Native CSS nesting не задействуется. Утилиты Tailwind генерятся отдельно.
+  `postcss-loader`. Native CSS nesting не задействуется.
+- **CSS-модули работают** — `import styles from "./x.module.css"` даёт хешированные имена
+  (`.loadsTable` → `._loadsTable_1brdq_1`) и объект-маппинг, `postcss-nested` внутри тоже работает.
+  Это **предпочтительный** способ модуль-специфичной стилизации: имена не надо придумывать
+  уникальными, коллизия с core/ui-kit невозможна by construction (обычный `.css` инжектится
+  как есть, и generic-имя вроде `.card` вполне может столкнуться с чужим).
 - **`.svg` как строка.** SVG импортится встроенным Vite-суффиксом `?raw`
   (`import logo from "./logo.svg?raw"`) → строка с разметкой, инлайнится, без отдельного ассет-файла.
   Байт-в-байт как старый `svg-inline-loader`. Билдер SVG специально не обрабатывает: **bare**-импорт
@@ -115,19 +131,39 @@ MDT-сторона контракта — `ui/vite-app/src/legacy/config-global.
 
 SemVer пакета относительно платформы:
 
-- **major** — смена контракта: имя глобала, набор `SHARED_EXACT`, **мажор React** (обновляются
-  `SHARED_NAMES`). Модули осознанно поднимают `mdt-module-builder` и проверяют совместимость.
-- **minor/patch** — внутренние правки сборки; выходной артефакт остаётся совместимым.
+- **major** — изменение, которое молча ломает уже существующий, никак не менявшийся код модуля
+  при обычном (не ручном) апгрейде: имя глобала, переименование/удаление ключа в
+  `SHARED_EXACT`/`SHARED_GLOBALS`/`SHARED_PREFIXES`, мажор React (обновляются `SHARED_NAMES`),
+  изменение источника Tailwind-классов модуля. Модули осознанно поднимают `mdt-module-builder`
+  и проверяют совместимость.
+- **minor** — обратно совместимое добавление: новый ключ в `SHARED_GLOBALS`/`SHARED_PREFIXES`
+  (библиотека, которую раньше никто не шарил, начинает шариться), новая опция сборки и т.п.
+  Модуль, который эту библиотеку не импортирует, ничего не замечает. Единственный риск —
+  модуль, который её уже импортирует и рассчитывает на бандлинг: после апгрейда билдера тот же
+  импорт станет externalize-иться, и на MDT без соответствующего патча платформы превратится
+  в `undefined` без ошибки сборки. Поэтому перед каждым добавлением в `SHARED_GLOBALS` —
+  проверить всех известных потребителей билдера на совместимом диапазоне версий на предмет
+  прямого импорта именно этой библиотеки. Нашёлся такой — для НЕЁ это major, а не minor.
+- **patch** — внутренние правки сборки; выходной артефакт остаётся совместимым.
+
+Пример применения правила — см. SHARED-DEPENDENCIES.md, «Расширение SHARED_GLOBALS».
 
 | mdt-module-builder | React | Платформа MDT |
 |---|---|---|
-| 1.x | 19 | (заполнить при первом релизе) |
+| 1.x | 19 | неизвестно — публиковался до введения CHANGELOG.md, надёжного источника нет |
+| 2.x (опубликован 2026-07-27) | 19 | требует MDT с курируемым Tailwind-safelist (`ui/tailwind-safelist.mjs` в `safelist` core-сборки, MP-16147) — модуль больше не собирает свой Tailwind. **Модули должны сами поднять зависимость на `^2.0.0`** — на `^1.0.x` не подхватится автоматически (иначе сломались бы молча, см. CHANGELOG) |
+| 2.1.x (не опубликован) | 19 | всё из 2.x + 8 новых ключей `SHARED_GLOBALS` (MP-16155): react-virtual, react-table, dnd-kit core/utilities, dnd-timeline, tailwind-variants, react-hook-form, zod. **Minor** — обратно совместимо, модули на `^2.0.0` подхватят автоматически; библиотеку в `devDependencies` подтягивают только когда реально начинают её импортировать. Реально начать пользоваться выносом можно только на MDT с этим патчем |
 
 ## Публикация
 
 Публикуется **вручную** в публичный npm (как `mdt-client`), автопубликации в CI нет.
-Версию руками в `package.json` не правим — скрипт `release` сам поднимает patch (без git-тега)
-и публикует:
+
+Перед любым релизом — перенеси `## [Unreleased]` в [CHANGELOG.md](./CHANGELOG.md) в датированную
+секцию `## [x.y.z] - YYYY-MM-DD` (формат [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/)),
+оставив пустой `## [Unreleased]` сверху для следующих изменений.
+
+Версию руками в `package.json` не правим для patch — скрипт `release` сам поднимает patch (без
+git-тега) и публикует:
 
 ```
 cd ui/module-builder

package/SHARED-DEPENDENCIES.md

@@ -108,6 +108,26 @@ npm i -D <dep>@<версия>   # в репозитории модуля; тот
   Rollup; после выноса проверь в рантайме, что `X` — это сам компонент, а не неймспейс.
 - **react-семья — особый, исторический случай** (alias-шимы `SHARED_EXACT`/`SHARED_NAMES` с
   перечислением имён). **Новые** зависимости добавляй в `SHARED_GLOBALS` — там имена перечислять не надо.
+- **Вынос отключает tree-shaking в core-сборке.** `import * as _Dep` + запись в `__mdtShared`
+  тянет в бандл MDT **весь** пакет, а не используемую часть — модуль обращается к любому члену
+  глобала, и отсечь ничего нельзя. Это та же причина, по которой `lucide-react` осознанно НЕ
+  выносится (см. README). Замер MP-16155: 8 вынесенных библиотек дали **+356 КБ** минифицированного
+  кода в core (18.36 → 18.71 МБ суммарно по JS-ассетам `dist-vite`). Плата разовая и окупается,
+  только если библиотекой реально пользуются ≥ 2 модуля или нужен единый инстанс, — поэтому
+  Шаг 0 обязателен, а «про запас» не выносим.
+- **Расширение `SHARED_GLOBALS` — обычно minor, а не major.** Новая запись ничего не меняет для
+  модуля, который эту библиотеку не импортирует. Единственный реальный риск — модуль, который её
+  СЕГОДНЯ импортирует и рассчитывает на бандлинг: после апгрейда билдера тот же импорт станет
+  externalize-иться, и на MDT без соответствующего патча платформы превратится в `undefined`
+  без ошибки сборки. Поэтому перед каждым добавлением — **шаг 0.5**: проверить всех известных
+  потребителей билдера на совместимом диапазоне версий (`^N.x`) на предмет прямого импорта именно
+  этой библиотеки. Нашёлся такой — для этого релиза правило переключается на major (см. README,
+  §Версионирование).
+  Пример (MP-16155): `@tanstack/react-virtual`, `@tanstack/react-table`, `@dnd-kit/core`,
+  `@dnd-kit/utilities`, `dnd-timeline`, `tailwind-variants`, `react-hook-form`, `zod` вынесены как
+  **2.1.0 (minor)** — единственный на тот момент потребитель билдера (`promo-tool`) сидел на
+  `mdt-module-builder ^1.0.0` и не мог подхватить релиз автоматически в любом случае, а среди уже
+  собираемых модулей никто из этих библиотек не бандлил при активной зависимости от билдера `^2.x`.
 
 ---
 
@@ -115,5 +135,21 @@ npm i -D <dep>@<версия>   # в репозитории модуля; тот
 
 - **react-семья** (`SHARED_EXACT`, alias-шимы): `react`, `react-dom`, `react-dom/client`,
   `react/jsx-runtime`, `react/jsx-dev-runtime`.
-- **Externalize** (`SHARED_GLOBALS`): `@tanstack/react-query`, `zustand`, `zustand/middleware`,
-  `zustand/react/shallow`, `echarts`, `echarts-for-react`.
+- **Префикс** (`SHARED_PREFIXES`): `ics-ui-kit` и любой его сабпас.
+- **Externalize** (`SHARED_GLOBALS`), только корневые спецификаторы, кроме `zustand`:
+
+| спецификатор | версия в MDT | почему вынесена |
+|---|---|---|
+| `@tanstack/react-query` | ^5.101.4 | один `QueryClient`/контекст |
+| `zustand` + `zustand/middleware` + `zustand/react/shallow` | ^5.0.11 | общий стор |
+| `echarts`, `echarts-for-react` | ^5.5.0 / ^3.0.2 | вес (~1 МБ) |
+| `@tanstack/react-virtual` | ^3.14.8 | нужна ≥ 2 модулям |
+| `@tanstack/react-table` | ^8.21.3 | React-контекст, общий с ui-kit |
+| `@dnd-kit/core`, `@dnd-kit/utilities` | ^6.3.1 / ^3.2.2 | `DndContext`, общий с ui-kit |
+| `dnd-timeline` | ^3.1.1 | сидит на общем `@dnd-kit/core` |
+| `tailwind-variants` | ^3.3.0 | общий `tailwind-merge` с ui-kit |
+| `react-hook-form` | ^7.83.0 | `FormProvider`-контекст, общий с ui-kit |
+| `zod` | ^3.25.76 | identity схем для `@hookform/resolvers` |
+
+Всё, кроме `@tanstack/react-virtual` и `dnd-timeline`, уже стояло в MDT транзитивно как зависимость
+`ics-ui-kit` — вынос свёлся к подъёму в прямые `dependencies`, вес MDT от этого не вырос.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mdt-module-builder",
-	"version": "1.0.4",
+	"version": "2.1.0",
 	"description": "Сборщик внешних UI-модулей MDT (Vite).",
 	"type": "module",
 	"bin": {
@@ -17,6 +17,7 @@
 		"src",
 		"bin",
 		"README.md",
+		"CHANGELOG.md",
 		"SHARED-DEPENDENCIES.md"
 	],
 	"engines": {
@@ -26,7 +27,6 @@
 		"autoprefixer": "^10.4.0",
 		"postcss": "^8.4.0",
 		"postcss-nested": "^6.2.0",
-		"tailwindcss": "^3.4.0",
 		"vite": "^6.0.0"
 	},
 	"keywords": [

package/src/index.mjs

@@ -12,8 +12,6 @@
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-import { createRequire } from "node:module";
-import { pathToFileURL } from "node:url";
 // postcss-плагины для компонентного CSS модуля (см. css.postcss в moduleViteConfig). Оба —
 // прямые зависимости пакета, поэтому импортим статически (нужны только при реальной сборке).
 import autoprefixer from "autoprefixer";
@@ -29,13 +27,24 @@ export const SHARED_EXACT = ["react", "react-dom", "react-dom/client", "react/js
 // библиотек с большим/растущим API и подпутями. Каждый подпуть (zustand/middleware и т.п.) —
 // отдельный спецификатор: его и externalize, и экспонировать в __mdtShared нужно отдельно.
 // Добавление новой shared-зависимости: см. SHARED-DEPENDENCIES.md.
+// Перечислены только КОРНЕВЫЕ спецификаторы: сабпасы (zod/v4, tailwind-variants/utils,
+// zustand/middleware, …) модули сегодня не импортируют. Понадобится сабпас — добавляется
+// отдельной строкой сюда и отдельным ключом в __mdtShared, "про запас" не добавляем.
 export const SHARED_GLOBALS = [
 	"@tanstack/react-query",
 	"zustand",
 	"zustand/middleware",
 	"zustand/react/shallow",
 	"echarts",
-	"echarts-for-react"
+	"echarts-for-react",
+	"@tanstack/react-virtual",
+	"@tanstack/react-table",
+	"@dnd-kit/core",
+	"@dnd-kit/utilities",
+	"dnd-timeline",
+	"tailwind-variants",
+	"react-hook-form",
+	"zod"
 ];
 
 // Библиотеки, которые MDT хостит ЦЕЛИКОМ и отдаёт модулям единым инстансом через ПРЕФИКС: матчим и
@@ -57,10 +66,9 @@ export const SHARED_NAMES = {
 	react: "Activity,Children,Component,Fragment,Profiler,PureComponent,StrictMode,Suspense,act,cache,cacheSignal,captureOwnerStack,cloneElement,createContext,createElement,createRef,forwardRef,isValidElement,lazy,memo,startTransition,use,useActionState,useCallback,useContext,useDebugValue,useDeferredValue,useEffect,useEffectEvent,useId,useImperativeHandle,useInsertionEffect,useLayoutEffect,useMemo,useOptimistic,useReducer,useRef,useState,useSyncExternalStore,useTransition,version".split(
 		","
 	),
-	"react-dom":
-		"createPortal,flushSync,preconnect,prefetchDNS,preinit,preinitModule,preload,preloadModule,requestFormReset,unstable_batchedUpdates,useFormState,useFormStatus,version".split(
-			","
-		),
+	"react-dom": "createPortal,flushSync,preconnect,prefetchDNS,preinit,preinitModule,preload,preloadModule,requestFormReset,unstable_batchedUpdates,useFormState,useFormStatus,version".split(
+		","
+	),
 	"react-dom/client": ["createRoot", "hydrateRoot", "version"],
 	"react/jsx-runtime": ["Fragment", "jsx", "jsxs"],
 	"react/jsx-dev-runtime": ["Fragment", "jsxDEV"]
@@ -96,7 +104,9 @@ function sharedAliases(shimDir) {
 // Толерантный парсер tsconfig (JSONC): вырезаем // и /* */ комментарии (не трогая их внутри строк)
 // и висячие запятые, затем JSON.parse.
 function parseJsonc(text) {
-	const noComments = text.replace(/("(?:\\.|[^"\\])*")|\/\/[^\n\r]*|\/\*[\s\S]*?\*\//g, (_m, str) => (str ? str : ""));
+	const noComments = text.replace(/("(?:\\.|[^"\\])*")|\/\/[^\n\r]*|\/\*[\s\S]*?\*\//g, (_m, str) =>
+		str ? str : ""
+	);
 	return JSON.parse(noComments.replace(/,(\s*[}\]])/g, "$1"));
 }
 
@@ -124,7 +134,10 @@ function tsconfigAliases(root) {
 		if (!target) continue;
 		if (pattern.endsWith("/*") && target.endsWith("/*")) {
 			const replBase = path.resolve(baseDir, target.slice(0, -2)).replace(/\\/g, "/");
-			aliases.push({ find: new RegExp(`^${escapeRegExp(pattern.slice(0, -2))}/(.*)$`), replacement: `${replBase}/$1` });
+			aliases.push({
+				find: new RegExp(`^${escapeRegExp(pattern.slice(0, -2))}/(.*)$`),
+				replacement: `${replBase}/$1`
+			});
 		} else {
 			aliases.push({ find: pattern, replacement: path.resolve(baseDir, target) });
 		}
@@ -145,45 +158,16 @@ function globalRef(id) {
 		: `globalThis.__mdtShared[${JSON.stringify(id)}]`;
 }
 
-// Tailwind для модуля (вариант A): билдер сам генерит утилиты ТОЛЬКО из исходников модуля.
-// preflight и токены даёт MDT глобально, поэтому здесь preflight выключен и эмитятся лишь
-// `@tailwind utilities`. Пресет берём из ics-ui-kit самого модуля (фолбэк — ics-ui-kit билдера,
-// чтобы dev-стенд работал даже до npm install в модуле) → те же утилиты/токены, что в MDT.
-async function loadIcsPreset(root) {
-	for (const base of [path.join(root, "package.json"), import.meta.url]) {
-		try {
-			const resolved = createRequire(base).resolve("ics-ui-kit/tailwind.preset");
-			const mod = await import(pathToFileURL(resolved).href);
-			return mod.default ?? mod;
-		} catch {
-			// пробуем следующий источник
-		}
-	}
-	return undefined;
-}
-
-// Генерит CSS утилит Tailwind, найденных в исходниках модуля. Зависимости подключаем лениво:
-// они есть у MDT (dev) и у mdt-module-builder (CI модуля), но не нужны для `--list`/импорта ядра.
-async function generateModuleTailwindCss(root) {
-	const [{ default: postcss }, { default: tailwindcss }, { default: autoprefixer }] = await Promise.all([
-		import("postcss"),
-		import("tailwindcss"),
-		import("autoprefixer")
-	]);
-	const content = path.join(root, "src").replace(/\\/g, "/") + "/**/*.{ts,tsx,js,jsx,html}";
-	const preset = await loadIcsPreset(root);
-	const config = { presets: preset ? [preset] : [], content: [content], corePlugins: { preflight: false } };
-	const { css } = await postcss([tailwindcss(config), autoprefixer()]).process("@tailwind utilities;\n", { from: undefined });
-	return css;
-}
-
 // Инлайнит собранный CSS в JS-чанк (рантайм-инъекция <style>) — как старый webpack/style-loader:
-// оверлей копирует только index.js, отдельного css-файла нет. Сюда же подмешиваем утилиты Tailwind.
-function cssInjectPlugin(root) {
+// оверлей копирует только index.js, отдельного css-файла нет. Модуль больше не собирает свой
+// Tailwind (MP-16147): здесь только компонентный CSS модуля (import "./x.css",
+// postcss-nested + autoprefixer, см. css.postcss в moduleViteConfig). Tailwind-утилиты модулю
+// больше не нужны — они приходят из курируемого safelist core-сборки MDT (ui/tailwind-safelist.mjs).
+function cssInjectPlugin() {
 	return {
 		name: "mdt-css-inject",
 		enforce: "post",
-		async generateBundle(_opts, bundle) {
+		generateBundle(_opts, bundle) {
 			let css = "";
 			for (const [file, chunk] of Object.entries(bundle)) {
 				if (chunk.type === "asset" && file.endsWith(".css")) {
@@ -191,7 +175,6 @@ function cssInjectPlugin(root) {
 					delete bundle[file];
 				}
 			}
-			css += await generateModuleTailwindCss(root);
 			if (!css) return;
 			const inject = `(function(){try{var s=document.createElement("style");s.textContent=${JSON.stringify(
 				css
@@ -214,12 +197,27 @@ export function moduleViteConfig({ root, entry, outDir, watch = false, name = "_
 		configFile: false,
 		root,
 		logLevel: "warn",
+		// Библиотеки, которые бандлятся ВНУТРЬ модуля (react-virtual и др.), метят dev-ветки через
+		// `process.env.NODE_ENV` — де-факто стандарт npm (так же устроен entry самого React). Это
+		// маркер для сборщика, а не рантайм-чтение: он должен подставить литерал и стрипнуть ветку.
+		// В lib-режиме Vite такую подстановку сознательно пропускает (`isBuildLib`,
+		// src/node/plugins/define.ts) — рассчитывает, что артефакт дособерёт бандлер потребителя.
+		// У нас его нет: MDT грузит index.js как <script>, а `process` в браузере не существует →
+		// ReferenceError в момент первого исполнения dev-ветки (сам модуль при этом грузится
+		// нормально — проверки лежат внутри функций). Делаем подстановку явно: NODE_ENV="production" (стрипает
+		// dev-ветки), плюс `process.env` → {} как фолбэк для прочих `process.env.X`.
+		// Ключи Vite матчит по длине (NODE_ENV раньше env).
+		define: {
+			"process.env.NODE_ENV": JSON.stringify("production"),
+			"process.env": "{}"
+		},
 		// react/*-шимы + tsconfig `paths` модуля (напр. "_core/*") — иначе Vite их не резолвит.
 		resolve: { alias: [...sharedAliases(shimDir), ...tsconfigAliases(root)] },
-		plugins: [cssInjectPlugin(root)],
+		plugins: [cssInjectPlugin()],
 		// Компонентный CSS модуля (import "./x.css") гоняем через postcss-nested (Sass-подобная
 		// вложенность `&`, как старый webpack builder) + autoprefixer. Инлайн-инъекцию делает
-		// cssInjectPlugin; `@tailwind utilities` генерятся отдельно (generateModuleTailwindCss).
+		// cssInjectPlugin. Tailwind-утилиты модуль больше не собирает (MP-16147) — приходят
+		// из курируемого safelist core-сборки MDT.
 		css: { postcss: { plugins: [postcssNested(), autoprefixer()] } },
 		build: {
 			outDir,
@@ -230,12 +228,12 @@ export function moduleViteConfig({ root, entry, outDir, watch = false, name = "_
 				// externalize (инстанс даёт MDT через globalThis.__mdtShared, в модуль НЕ бандлятся): SHARED_GLOBALS
 				// (точные спецификаторы) + ics-ui-kit с сабпасами (SHARED_PREFIXES). react/* — alias-шимы; lucide бандлится.
 				external: (id) => SHARED_GLOBALS.includes(id) || isSharedPrefix(id) || id.startsWith(MDT_SDK_PREFIX),
-					// host кладёт значения в __mdtShared/__mdtSdk с флагом __esModule, поэтому
-					// interop берёт `.default` для default-импорта. rolldown (dev) делает это сам (__toESM),
-					// а Rollup (Vite 6, CI модуля) — только с output.interop:"auto"; без него default-импорт
-					// биндится ко всему объекту-неймспейсу вместо .default (MDT.Navigation === undefined,
-					// echarts-for-react → «Element type is invalid … got: object»).
-					output: { globals: globalRef, interop: "auto" }
+				// host кладёт значения в __mdtShared/__mdtSdk с флагом __esModule, поэтому
+				// interop берёт `.default` для default-импорта. rolldown (dev) делает это сам (__toESM),
+				// а Rollup (Vite 6, CI модуля) — только с output.interop:"auto"; без него default-импорт
+				// биндится ко всему объекту-неймспейсу вместо .default (MDT.Navigation === undefined,
+				// echarts-for-react → «Element type is invalid … got: object»).
+				output: { globals: globalRef, interop: "auto" }
 			},
 			lib: {
 				entry,