mdt-module-builder 1.0.3 → 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# 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]
+
+### 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` модуля:
@@ -37,13 +39,40 @@ devtool/builder вызывают `npm run build` в репе модуля — м
   компоненты модуля читали бы чужой `ThemeContext`. CSS-сабпасы (`styles.css`) не externalize-ятся.
 - **lucide-react, mdt-client** — бандлятся внутрь `index.js` (должны быть установлены).
   Их внутренний `import "react"` тоже перехватывается шимом.
+  Почему lucide бандлится, а ui-kit шарится (решение зафиксировано, не пересматривать без новых данных):
+  ui-kit **обязан** быть общим по корректности — у него React-контекст (тема, провайдеры), две копии =
+  сломанная тема. Иконки lucide — stateless SVG без контекста, дубли безвредны. При этом lucide импортят
+  именованно из корня (`import { X } from "lucide-react"`), так что шаринг = отдать весь namespace →
+  MDT забандлил бы **все ~1900 иконок без tree-shaking**. Per-module бандл, наоборот, tree-shaking-ом
+  тянет только 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)
+
+Ядро воспроизводит удобства старого (webpack) билдера, чтобы исходники модуля не переписывать:
+
+- **tsconfig `paths` → `resolve.alias`.** Билдер читает `compilerOptions.paths`/`baseUrl` из
+  `tsconfig.json` модуля и разворачивает в alias'ы Vite (аналог `tsconfig-paths-webpack-plugin`).
+  Импорты вида `import x from "_core/scripts/..."` резолвятся без правок. Берётся первый target
+  маппинга; `prefix/*` → wildcard с захватом хвоста, точный ключ → строковый алиас.
+- **CSS-вложенность.** Компонентный CSS модуля (`import "./x.css"`) прогоняется через
+  `postcss-nested` (Sass-подобный `&`) + `autoprefixer` — та же семантика, что у старого
+  `postcss-loader`. Native CSS nesting не задействуется.
+- **`.svg` как строка.** SVG импортится встроенным Vite-суффиксом `?raw`
+  (`import logo from "./logo.svg?raw"`) → строка с разметкой, инлайнится, без отдельного ассет-файла.
+  Байт-в-байт как старый `svg-inline-loader`. Билдер SVG специально не обрабатывает: **bare**-импорт
+  `.svg` без `?raw` уедет в отдельный файл, который контракт модуля (копируется только `index.js`)
+  потеряет — всегда с `?raw`.
 
 ## Доступ к функционалу MDT — `@mdt/*`
 
@@ -93,18 +122,25 @@ MDT-сторона контракта — `ui/vite-app/src/legacy/config-global.
 SemVer пакета относительно платформы:
 
 - **major** — смена контракта: имя глобала, набор `SHARED_EXACT`, **мажор React** (обновляются
-  `SHARED_NAMES`). Модули осознанно поднимают `mdt-module-builder` и проверяют совместимость.
+  `SHARED_NAMES`), или изменение источника Tailwind-классов модуля. Модули осознанно поднимают
+  `mdt-module-builder` и проверяют совместимость.
 - **minor/patch** — внутренние правки сборки; выходной артефакт остаётся совместимым.
 
 | mdt-module-builder | React | Платформа MDT |
 |---|---|---|
 | 1.x | 19 | (заполнить при первом релизе) |
+| 2.x | 19 | требует MDT с курируемым Tailwind-safelist (`ui/tailwind-safelist.mjs` в `safelist` core-сборки, MP-16147) — модуль больше не собирает свой Tailwind |
 
 ## Публикация
 
 Публикуется **вручную** в публичный 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

@@ -1,119 +1,119 @@
-# Общие зависимости модулей: вынос в MDT
-
-Когда внешнему модулю нужна библиотека, которую логично держать **одним инстансом на всё
-приложение** (или не таскать её копию в каждый модуль), она «выносится» в MDT: MDT ставит её,
-экспонирует через `globalThis.__mdtShared`, а сборка модуля её **не бандлит**, а читает оттуда.
-Ровно так уже сделано для react-семьи; этот документ — про добавление новой такой зависимости.
-
----
-
-## Шаг 0. Решить: выносить или бандлить
-
-Выносим, если выполняется хотя бы одно:
-
-- **Нужен единый инстанс/контекст.** Несколько копий ломаются: react (hooks), `@tanstack/react-query`
-  (общий `QueryClient`/контекст). → выносить **обязательно**.
-- **Тяжёлая.** `echarts` ~1 МБ — копия в каждом модуле недопустима. → выносим ради веса.
-- **Нужна ≥ 2 модулям.** Дедуп.
-
-Если ничего из этого — **не выносим**. Просто импортируй в модуле, она забандлится внутрь. Ничего
-делать не надо.
-
----
-
-## План выноса (по шагам)
-
-Каждый шаг — действие и явное «Готово, когда». Не переходи к следующему, пока текущее не закрыто.
-
-### Шаг 1. Поставить зависимость в MDT
-
-```
-cd ui && npm i <dep>@<версия>
-```
-
-Версия, которую ты зафиксировал в MDT, **становится контрактом** — модули будут пользоваться
-этим мажором.
-
-> **Готово, когда:** `<dep>` стоит в `ui/package.json → dependencies`.
-
-### Шаг 2. Экспонировать в `__mdtShared`
-
-В `ui/vite-app/src/legacy/config-global.ts`:
-
-```ts
-import * as _Dep from "<dep>";
-// ...
-(globalThis as any).__mdtShared = Object.assign((globalThis as any).__mdtShared ?? {}, {
-  // ...уже существующие...
-  "<dep>": _Dep
-});
-```
-
-Ключ — **точный спецификатор импорта**. Для каждого подпути, который импортируют модули
-(`<dep>/sub`, например `zustand/middleware`), — отдельный `import * as` и отдельный ключ.
-
-> **Готово, когда:** в рантайме `globalThis.__mdtShared["<dep>"]` возвращает библиотеку.
-
-### Шаг 3. Externalize в билдере
-
-В `ui/module-builder/src/index.mjs` добавь спецификатор (и каждый подпуть) в массив `SHARED_GLOBALS`.
-
-> **Готово, когда:** сборка модуля ссылается на `globalThis.__mdtShared["<dep>"]`, а кода библиотеки
-> в `dist/index.js` нет. Имена экспортов перечислять **не нужно** — Rollup обращается к членам глобала сам.
-
-### Шаг 4. Доставить билдер в CI модуля
-
-Dev-стенд MDT собирает модуль **локальным** исходником билдера → новый `SHARED_GLOBALS` работает
-сразу. Для `npm run build` в репозитории модуля нужен **опубликованный** `mdt-module-builder` с этим
-изменением:
-
-```
-cd ui/module-builder && npm publish   # вручную, как и весь mdt-module-builder
-```
-
-> **Готово, когда:** в репо модуля стоит версия `mdt-module-builder`, где зависимость уже в `SHARED_GLOBALS`.
-
-### Шаг 5. Подключить в модуле (только типы)
-
-```
-npm i -D <dep>@<версия>   # в репозитории модуля; тот же мажор, что в MDT
-```
-
-Импортируй и пользуйся как обычно — в бандл библиотека не попадёт, тип берётся из devDependency.
-
-> **Готово, когда:** типы резолвятся, импорт компилируется.
-
-### Шаг 6. Проверить
-
-Собери модуль и убедись:
-
-- вес `dist/index.js` **не вырос** на размер библиотеки;
-- в нём есть `globalThis.__mdtShared["<dep>"]` и **нет** кода библиотеки.
-
-> **Готово, когда:** оба пункта выполнены.
-
----
-
-## Подводные камни
-
-- **Версия — это контракт.** Мажор в MDT и в модуле должен совпадать (как с react). Рассинхрон
-  даёт трудноуловимые поломки (аналог «Invalid hook call»).
-- **Подпуть — отдельный спецификатор.** `zustand/middleware` ≠ `zustand`. Каждый используемый
-  подпуть нужно добавить и в `__mdtShared` (Шаг 2), и в `SHARED_GLOBALS` (Шаг 3).
-- **`@tanstack/react-query`: единого инстанса мало.** Модуль должен обернуть своё дерево в
-  `<QueryClientProvider client={...}>`. Контекст работает именно потому, что инстанс один; сам
-  провайдер — ответственность модуля (каждый React-root монтируется отдельно через
-  `wrapComponent`/`createPageControl`).
-- **Default-импорт** (`import X from "echarts-for-react"`) работает через стандартный interop
-  Rollup; после выноса проверь в рантайме, что `X` — это сам компонент, а не неймспейс.
-- **react-семья — особый, исторический случай** (alias-шимы `SHARED_EXACT`/`SHARED_NAMES` с
-  перечислением имён). **Новые** зависимости добавляй в `SHARED_GLOBALS` — там имена перечислять не надо.
-
----
-
-## Текущий список общих зависимостей
-
-- **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`.
+# Общие зависимости модулей: вынос в MDT
+
+Когда внешнему модулю нужна библиотека, которую логично держать **одним инстансом на всё
+приложение** (или не таскать её копию в каждый модуль), она «выносится» в MDT: MDT ставит её,
+экспонирует через `globalThis.__mdtShared`, а сборка модуля её **не бандлит**, а читает оттуда.
+Ровно так уже сделано для react-семьи; этот документ — про добавление новой такой зависимости.
+
+---
+
+## Шаг 0. Решить: выносить или бандлить
+
+Выносим, если выполняется хотя бы одно:
+
+- **Нужен единый инстанс/контекст.** Несколько копий ломаются: react (hooks), `@tanstack/react-query`
+  (общий `QueryClient`/контекст). → выносить **обязательно**.
+- **Тяжёлая.** `echarts` ~1 МБ — копия в каждом модуле недопустима. → выносим ради веса.
+- **Нужна ≥ 2 модулям.** Дедуп.
+
+Если ничего из этого — **не выносим**. Просто импортируй в модуле, она забандлится внутрь. Ничего
+делать не надо.
+
+---
+
+## План выноса (по шагам)
+
+Каждый шаг — действие и явное «Готово, когда». Не переходи к следующему, пока текущее не закрыто.
+
+### Шаг 1. Поставить зависимость в MDT
+
+```
+cd ui && npm i <dep>@<версия>
+```
+
+Версия, которую ты зафиксировал в MDT, **становится контрактом** — модули будут пользоваться
+этим мажором.
+
+> **Готово, когда:** `<dep>` стоит в `ui/package.json → dependencies`.
+
+### Шаг 2. Экспонировать в `__mdtShared`
+
+В `ui/vite-app/src/legacy/config-global.ts`:
+
+```ts
+import * as _Dep from "<dep>";
+// ...
+(globalThis as any).__mdtShared = Object.assign((globalThis as any).__mdtShared ?? {}, {
+  // ...уже существующие...
+  "<dep>": _Dep
+});
+```
+
+Ключ — **точный спецификатор импорта**. Для каждого подпути, который импортируют модули
+(`<dep>/sub`, например `zustand/middleware`), — отдельный `import * as` и отдельный ключ.
+
+> **Готово, когда:** в рантайме `globalThis.__mdtShared["<dep>"]` возвращает библиотеку.
+
+### Шаг 3. Externalize в билдере
+
+В `ui/module-builder/src/index.mjs` добавь спецификатор (и каждый подпуть) в массив `SHARED_GLOBALS`.
+
+> **Готово, когда:** сборка модуля ссылается на `globalThis.__mdtShared["<dep>"]`, а кода библиотеки
+> в `dist/index.js` нет. Имена экспортов перечислять **не нужно** — Rollup обращается к членам глобала сам.
+
+### Шаг 4. Доставить билдер в CI модуля
+
+Dev-стенд MDT собирает модуль **локальным** исходником билдера → новый `SHARED_GLOBALS` работает
+сразу. Для `npm run build` в репозитории модуля нужен **опубликованный** `mdt-module-builder` с этим
+изменением:
+
+```
+cd ui/module-builder && npm publish   # вручную, как и весь mdt-module-builder
+```
+
+> **Готово, когда:** в репо модуля стоит версия `mdt-module-builder`, где зависимость уже в `SHARED_GLOBALS`.
+
+### Шаг 5. Подключить в модуле (только типы)
+
+```
+npm i -D <dep>@<версия>   # в репозитории модуля; тот же мажор, что в MDT
+```
+
+Импортируй и пользуйся как обычно — в бандл библиотека не попадёт, тип берётся из devDependency.
+
+> **Готово, когда:** типы резолвятся, импорт компилируется.
+
+### Шаг 6. Проверить
+
+Собери модуль и убедись:
+
+- вес `dist/index.js` **не вырос** на размер библиотеки;
+- в нём есть `globalThis.__mdtShared["<dep>"]` и **нет** кода библиотеки.
+
+> **Готово, когда:** оба пункта выполнены.
+
+---
+
+## Подводные камни
+
+- **Версия — это контракт.** Мажор в MDT и в модуле должен совпадать (как с react). Рассинхрон
+  даёт трудноуловимые поломки (аналог «Invalid hook call»).
+- **Подпуть — отдельный спецификатор.** `zustand/middleware` ≠ `zustand`. Каждый используемый
+  подпуть нужно добавить и в `__mdtShared` (Шаг 2), и в `SHARED_GLOBALS` (Шаг 3).
+- **`@tanstack/react-query`: единого инстанса мало.** Модуль должен обернуть своё дерево в
+  `<QueryClientProvider client={...}>`. Контекст работает именно потому, что инстанс один; сам
+  провайдер — ответственность модуля (каждый React-root монтируется отдельно через
+  `wrapComponent`/`createPageControl`).
+- **Default-импорт** (`import X from "echarts-for-react"`) работает через стандартный interop
+  Rollup; после выноса проверь в рантайме, что `X` — это сам компонент, а не неймспейс.
+- **react-семья — особый, исторический случай** (alias-шимы `SHARED_EXACT`/`SHARED_NAMES` с
+  перечислением имён). **Новые** зависимости добавляй в `SHARED_GLOBALS` — там имена перечислять не надо.
+
+---
+
+## Текущий список общих зависимостей
+
+- **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`.

package/package.json

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

package/src/index.mjs

@@ -12,8 +12,10 @@
 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";
+import postcssNested from "postcss-nested";
 
 // Спецификаторы, которые резолвятся на единственную копию MDT через window.__mdtShared.
 export const SHARED_EXACT = ["react", "react-dom", "react-dom/client", "react/jsx-runtime", "react/jsx-dev-runtime"];
@@ -53,10 +55,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"]
@@ -89,6 +90,50 @@ function sharedAliases(shimDir) {
 	}));
 }
 
+// Толерантный парсер tsconfig (JSONC): вырезаем // и /* */ комментарии (не трогая их внутри строк)
+// и висячие запятые, затем JSON.parse.
+function parseJsonc(text) {
+	const noComments = text.replace(/("(?:\\.|[^"\\])*")|\/\/[^\n\r]*|\/\*[\s\S]*?\*\//g, (_m, str) =>
+		str ? str : ""
+	);
+	return JSON.parse(noComments.replace(/,(\s*[}\]])/g, "$1"));
+}
+
+function escapeRegExp(s) {
+	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// Разворачивает tsconfig `compilerOptions.paths` модуля в resolve.alias — аналог
+// tsconfig-paths-webpack-plugin старого (webpack) билдера. Без этого Vite не резолвит алиасы вида
+// "_core/*", которыми пользуется код модуля. Берём первый target маппинга (как tsconfig-paths по
+// умолчанию); wildcard `prefix/*` → regex с захватом хвоста, точный ключ → строковый алиас.
+function tsconfigAliases(root) {
+	let json;
+	try {
+		json = parseJsonc(fs.readFileSync(path.join(root, "tsconfig.json"), "utf8"));
+	} catch {
+		return [];
+	}
+	const co = json?.compilerOptions ?? {};
+	const paths = co.paths ?? {};
+	const baseDir = path.resolve(root, co.baseUrl ?? ".");
+	const aliases = [];
+	for (const [pattern, targets] of Object.entries(paths)) {
+		const target = Array.isArray(targets) ? targets[0] : undefined;
+		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`
+			});
+		} else {
+			aliases.push({ find: pattern, replacement: path.resolve(baseDir, target) });
+		}
+	}
+	return aliases;
+}
+
 // Публичный SDK MDT: спецификаторы `@mdt/<имя>` отдаются модулю как externalize. Их экспорты
 // кладёт MDT в globalThis.__mdtSdk — по одному ключу на файл папки ui/mdt-sdk (см. _register.ts).
 // Добавить публичный API = создать файл в ui/mdt-sdk; перечислять имена/спецификаторы не нужно.
@@ -102,45 +147,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, Шаг 3): здесь только компонентный 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")) {
@@ -148,7 +164,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
@@ -171,8 +186,28 @@ export function moduleViteConfig({ root, entry, outDir, watch = false, name = "_
 		configFile: false,
 		root,
 		logLevel: "warn",
-		resolve: { alias: sharedAliases(shimDir) },
-		plugins: [cssInjectPlugin(root)],
+		// Библиотеки, которые бандлятся ВНУТРЬ модуля (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()],
+		// Компонентный CSS модуля (import "./x.css") гоняем через postcss-nested (Sass-подобная
+		// вложенность `&`, как старый webpack builder) + autoprefixer. Инлайн-инъекцию делает
+		// cssInjectPlugin. Tailwind-утилиты модуль больше не собирает (MP-16147, Шаг 3) — приходят
+		// из курируемого safelist core-сборки MDT.
+		css: { postcss: { plugins: [postcssNested(), autoprefixer()] } },
 		build: {
 			outDir,
 			emptyOutDir: true,
@@ -182,11 +217,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 модуля (__toESM) корректно отдаёт `.default` для default-импорта
-					// (иначе default-импорт, напр. echarts-for-react, превращается в объект-неймспейс → React
-					// «Element type is invalid … got: object»).
-					output: { globals: globalRef }
+				// 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,