mdt-module-builder 1.0.1 → 1.0.2

package/README.md

@@ -1,71 +1,105 @@
-# mdt-module-builder
-
-Сборщик внешнего UI-модуля MDT билдером MDT (Vite). Заменяет webpack/ics-builder в `npm run build`
-модуля, выдавая **тот же по контракту артефакт**: один `dist/index.js` (IIFE), который при загрузке
-через `<script>` самовыполняется и зовёт `window.MDT.registerModule`.
-
-## Использование
-
-В `package.json` модуля:
-
-```json
-{
-  "scripts": { "build": "mdt-module-build" },
-  "devDependencies": { "mdt-module-builder": "^1.0.0" },
-  "dependencies": { "mdt-client": "^31", "ics-ui-kit": "...", "lucide-react": "..." },
-  "peerDependencies": { "react": "^19", "react-dom": "^19" }
-}
-```
-
-Entry — `src/index.ts` (переопределяется `"mdt": { "entry": "..." }`). Сборка: `npm run build` → `dist/index.js`.
-
-devtool/builder вызывают `npm run build` в репе модуля — менять их не нужно, контракт `dist/` соблюдён.
-
-## Дедуп (вариант B)
-
-- **react, react-dom, react-dom/client, react/jsx-runtime, react/jsx-dev-runtime** — НЕ бандлятся.
-  Заменяются alias-шимами, читающими `globalThis.__mdtShared[spec]` (MDT ставит его при старте).
-  → один инстанс React во всём рантайме, нет «Invalid hook call».
-  → react/react-dom **не обязаны быть установлены** при сборке (имена их экспортов зашиты в пакет).
-- **ics-ui-kit, lucide-react, mdt-client** — бандлятся внутрь `index.js` (должны быть установлены).
-  Их внутренний `import "react"` тоже перехватывается шимом.
-- **CSS** инлайнится в `index.js` (рантайм-инъекция `<style>`), как старый style-loader —
-  оверлей копирует только `index.js`, отдельного `.css` нет.
-
-## Контракт с платформой
-
-Модуль и MDT договариваются о:
-
-- имени глобала **`window.__mdtShared`**;
-- наборе ключей **`SHARED_EXACT`** (react-семья);
-- **мажоре React** (от него зависит список именованных экспортов `SHARED_NAMES`).
-
-MDT-сторона контракта — `ui/vite-app/src/legacy/config-global.ts` (ставит `__mdtShared`).
-
-## Vite / Node
-
-Пакет зависит от **Vite 6 (Rollup)**, а не Vite 8 (Rolldown), как сам MDT-app. Причина — раннер CI
-`publish-module` на **Node 18**, а Vite 8 требует Node ≥20.19. Это осознанный техдолг высшего
-приоритета (`ui/vite-app/TECH_DEBT.md`, P0): вернуть на Vite 8, когда раннеры переедут на Node 20+.
-На выход (IIFE + дедуп-шимы) мажор Vite не влияет — артефакт совместим.
-
-## Версионирование
-
-SemVer пакета относительно платформы:
-
-- **major** — смена контракта: имя глобала, набор `SHARED_EXACT`, **мажор React** (обновляются
-  `SHARED_NAMES`). Модули осознанно поднимают `mdt-module-builder` и проверяют совместимость.
-- **minor/patch** — внутренние правки сборки; выходной артефакт остаётся совместимым.
-
-| mdt-module-builder | React | Платформа MDT |
-|---|---|---|
-| 1.x | 19 | (заполнить при первом релизе) |
-
-## Публикация
-
-Публикуется **вручную** в публичный npm (как `mdt-client`), автопубликации в CI нет.
-
-```
-cd ui/module-builder
-npm publish
-```
+# mdt-module-builder
+
+Сборщик внешнего UI-модуля MDT билдером MDT (Vite). Заменяет webpack/ics-builder в `npm run build`
+модуля, выдавая **тот же по контракту артефакт**: один `dist/index.js` (IIFE), который при загрузке
+через `<script>` самовыполняется и зовёт `window.MDT.registerModule`.
+
+## Использование
+
+В `package.json` модуля:
+
+```json
+{
+  "scripts": { "build": "mdt-module-build" },
+  "devDependencies": { "mdt-module-builder": "^1.0.0" },
+  "dependencies": { "mdt-client": "^31", "ics-ui-kit": "...", "lucide-react": "..." },
+  "peerDependencies": { "react": "^19", "react-dom": "^19" }
+}
+```
+
+Entry — `src/index.ts` (переопределяется `"mdt": { "entry": "..." }`). Сборка: `npm run build` → `dist/index.js`.
+
+devtool/builder вызывают `npm run build` в репе модуля — менять их не нужно, контракт `dist/` соблюдён.
+
+## Дедуп (вариант B)
+
+- **react, react-dom, react-dom/client, react/jsx-runtime, react/jsx-dev-runtime** — НЕ бандлятся.
+  Заменяются alias-шимами, читающими `globalThis.__mdtShared[spec]` (MDT ставит его при старте).
+  → один инстанс React во всём рантайме, нет «Invalid hook call».
+  → react/react-dom **не обязаны быть установлены** при сборке (имена их экспортов зашиты в пакет).
+- **`SHARED_GLOBALS`** (`@tanstack/react-query`, `zustand` + подпути, `echarts`, `echarts-for-react`)
+  — НЕ бандлятся: externalize + чтение `globalThis.__mdtShared[spec]`. В отличие от react-семьи,
+  имена экспортов перечислять не нужно. Как вынести новую такую зависимость — см. [SHARED-DEPENDENCIES.md](./SHARED-DEPENDENCIES.md).
+- **ics-ui-kit, lucide-react, mdt-client** — бандлятся внутрь `index.js` (должны быть установлены).
+  Их внутренний `import "react"` тоже перехватывается шимом.
+- **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. Возможны дубли утилит между модулями — это принято.
+
+## Доступ к функционалу MDT — `@mdt/*`
+
+Любой `@mdt/<имя>` билдер externalize-ит и резолвит в `globalThis.__mdtSdk["<имя>"]`. Наполняет этот
+глобал MDT: в папке **`ui/mdt-sdk/`** каждый файл = модуль `@mdt/<имя файла>`, и `_register.ts`
+(через `import.meta.glob`) кладёт экспорты каждого файла в `__mdtSdk` при старте. Добавить публичный
+API = создать файл в `ui/mdt-sdk/`; перечислять имена/спецификаторы нигде не нужно.
+
+```ts
+import MDT, { registerModule } from "@mdt/facade";     // живой window.MDT (ленивый Proxy) + обёртка
+import { createPageControl } from "@mdt/react-utils";        // ui/mdt-sdk/react-utils.ts
+import { useThemeToken } from "@mdt/theme";                  // токены темы MDT в JS, реактивно
+import { useChartColors, useChartFont } from "@mdt/charts";  // дефолтная тема чартов MDT
+
+registerModule(() => MDT.Navigation.addNode({ code: "x", title: "X" }));
+```
+
+Чтобы дать модулям новую возможность — либо добавь её в фасад MDT (видно как `MDT.x` через
+`@mdt/facade`), либо положи файл в `ui/mdt-sdk/`. Ни релиза, ни списка экспортов. Хэндлы пока
+нетипизированы (`any`); типы навешиваются позже без изменения рантайма. `mdt-client` остаётся для
+обратной совместимости и сосуществует с `@mdt/*`.
+
+## Контракт с платформой
+
+Модуль и MDT договариваются о:
+
+- имени глобала **`window.__mdtShared`**;
+- наборе ключей **`SHARED_EXACT`** (react-семья);
+- **мажоре React** (от него зависит список именованных экспортов `SHARED_NAMES`).
+
+MDT-сторона контракта — `ui/vite-app/src/legacy/config-global.ts` (ставит `__mdtShared`).
+
+## Vite / Node
+
+Пакет зависит от **Vite 6 (Rollup)**, а не Vite 8 (Rolldown), как сам MDT-app. Причина — раннер CI
+`publish-module` на **Node 18**, а Vite 8 требует Node ≥20.19. Это осознанный техдолг высшего
+приоритета (`ui/vite-app/TECH_DEBT.md`, P0): вернуть на Vite 8, когда раннеры переедут на Node 20+.
+На выход (IIFE + дедуп-шимы) мажор Vite не влияет — артефакт совместим.
+
+## Версионирование
+
+SemVer пакета относительно платформы:
+
+- **major** — смена контракта: имя глобала, набор `SHARED_EXACT`, **мажор React** (обновляются
+  `SHARED_NAMES`). Модули осознанно поднимают `mdt-module-builder` и проверяют совместимость.
+- **minor/patch** — внутренние правки сборки; выходной артефакт остаётся совместимым.
+
+| mdt-module-builder | React | Платформа MDT |
+|---|---|---|
+| 1.x | 19 | (заполнить при первом релизе) |
+
+## Публикация
+
+Публикуется **вручную** в публичный npm (как `mdt-client`), автопубликации в CI нет.
+Версию руками в `package.json` не правим — скрипт `release` сам поднимает patch (без git-тега)
+и публикует:
+
+```
+cd ui/module-builder
+npm run release   # = npm version patch --no-git-tag-version && npm publish
+```
+
+Для minor/major (смена контракта — см. §Версионирование) сначала подними версию явно
+(`npm version minor|major --no-git-tag-version`), затем `npm publish`.

package/SHARED-DEPENDENCIES.md

@@ -0,0 +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`.

package/bin/cli.mjs

@@ -1,33 +1,33 @@
-#!/usr/bin/env node
-// mdt-module-build — собирает внешний UI-модуль MDT из текущей папки (cwd).
-// Вызывается как `npm run build` модуля (devtool/builder делают это в репе модуля).
-// Контракт артефакта: dist/index.js (IIFE), как у старого билдера.
-//
-// Entry: package.json → "mdt": { "entry": "src/index.ts" } (по умолчанию src/index.ts).
-
-import { build } from "vite";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { moduleViteConfig } from "../src/index.mjs";
-
-const root = process.cwd();
-
-let pkg = {};
-try {
-	pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
-} catch {
-	console.error("[mdt-module-build] не найден package.json в текущей папке");
-	process.exit(1);
-}
-
-const entry = path.resolve(root, pkg?.mdt?.entry || "src/index.ts");
-if (!fs.existsSync(entry)) {
-	console.error(`[mdt-module-build] entry не найден: ${path.relative(root, entry)} (задаётся в package.json "mdt".entry)`);
-	process.exit(1);
-}
-
-const outDir = path.resolve(root, "dist");
-const name = "__mdtMod_" + String(pkg.name || "module").replace(/[^a-zA-Z0-9_]/g, "_");
-
-await build(moduleViteConfig({ root, entry, outDir, name }));
-console.log(`[mdt-module-build] ${pkg.name || "module"} → dist/index.js`);
+#!/usr/bin/env node
+// mdt-module-build — собирает внешний UI-модуль MDT из текущей папки (cwd).
+// Вызывается как `npm run build` модуля (devtool/builder делают это в репе модуля).
+// Контракт артефакта: dist/index.js (IIFE), как у старого билдера.
+//
+// Entry: package.json → "mdt": { "entry": "src/index.ts" } (по умолчанию src/index.ts).
+
+import { build } from "vite";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { moduleViteConfig } from "../src/index.mjs";
+
+const root = process.cwd();
+
+let pkg = {};
+try {
+	pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+} catch {
+	console.error("[mdt-module-build] не найден package.json в текущей папке");
+	process.exit(1);
+}
+
+const entry = path.resolve(root, pkg?.mdt?.entry || "src/index.ts");
+if (!fs.existsSync(entry)) {
+	console.error(`[mdt-module-build] entry не найден: ${path.relative(root, entry)} (задаётся в package.json "mdt".entry)`);
+	process.exit(1);
+}
+
+const outDir = path.resolve(root, "dist");
+const name = "__mdtMod_" + String(pkg.name || "module").replace(/[^a-zA-Z0-9_]/g, "_");
+
+await build(moduleViteConfig({ root, entry, outDir, name }));
+console.log(`[mdt-module-build] ${pkg.name || "module"} → dist/index.js`);

package/package.json

@@ -1,34 +1,38 @@
-{
-	"name": "mdt-module-builder",
-	"version": "1.0.1",
-	"description": "Сборщик внешних UI-модулей MDT (Vite).",
-	"type": "module",
-	"bin": {
-		"mdt-module-build": "bin/cli.mjs"
-	},
-	"main": "src/index.mjs",
-	"exports": {
-		".": "./src/index.mjs"
-	},
-	"scripts": {
-		"release": "npm version patch --no-git-tag-version && npm publish"
-	},
-	"files": [
-		"src",
-		"bin",
-		"README.md"
-	],
-	"engines": {
-		"node": ">=18.18.0"
-	},
-	"dependencies": {
-		"vite": "^6.0.0"
-	},
-	"keywords": [
-		"mdt",
-		"module",
-		"builder",
-		"vite"
-	],
-	"license": "UNLICENSED"
-}
+{
+	"name": "mdt-module-builder",
+	"version": "1.0.2",
+	"description": "Сборщик внешних UI-модулей MDT (Vite).",
+	"type": "module",
+	"bin": {
+		"mdt-module-build": "bin/cli.mjs"
+	},
+	"main": "src/index.mjs",
+	"exports": {
+		".": "./src/index.mjs"
+	},
+	"scripts": {
+		"release": "npm version patch --no-git-tag-version && npm publish"
+	},
+	"files": [
+		"src",
+		"bin",
+		"README.md",
+		"SHARED-DEPENDENCIES.md"
+	],
+	"engines": {
+		"node": ">=18.18.0"
+	},
+	"dependencies": {
+		"autoprefixer": "^10.4.0",
+		"postcss": "^8.4.0",
+		"tailwindcss": "^3.4.0",
+		"vite": "^6.0.0"
+	},
+	"keywords": [
+		"mdt",
+		"module",
+		"builder",
+		"vite"
+	],
+	"license": "UNLICENSED"
+}

package/src/index.mjs

@@ -1,117 +1,186 @@
-// mdt-module-builder — сборка внешнего UI-модуля MDT билдером MDT (Vite), артефакт «по старому»:
-// один самовыполняющийся dist/index.js (IIFE), который зовёт window.MDT.registerModule.
-//
-// Дедуп (MP-16057, вариант B): react-семья НЕ бандлится — заменяется alias-шимами,
-// читающими globalThis.__mdtShared[spec] (его ставит MDT при старте). ics-ui-kit/lucide-react
-// бандлятся внутрь; их внутренний import "react" тоже ловит alias → один инстанс React.
-//
-// react/* НЕ обязаны быть установлены в модуле (не попадают в бандл): имена их экспортов
-// зашиты статически (SHARED_NAMES) и версионируются мажором React вместе с пакетом.
-
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-
-// Спецификаторы, которые резолвятся на единственную копию MDT через window.__mdtShared.
-export const SHARED_EXACT = ["react", "react-dom", "react-dom/client", "react/jsx-runtime", "react/jsx-dev-runtime"];
-
-// Именованные экспорты react-семьи (React 19). Зашиты статически — react не ставится при сборке.
-// При смене мажора React обновляются вместе с major-версией пакета (см. README §версионирование).
-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/client": ["createRoot", "hydrateRoot", "version"],
-	"react/jsx-runtime": ["Fragment", "jsx", "jsxs"],
-	"react/jsx-dev-runtime": ["Fragment", "jsxDEV"]
-};
-
-// Генерирует ESM shim-файлы (по одному на SHARED_EXACT) в свежей temp-папке.
-// Шим читает MDT-инстанс из globalThis.__mdtShared[spec]; именованные экспорты — из SHARED_NAMES.
-export function ensureShims() {
-	const shimDir = fs.mkdtempSync(path.join(os.tmpdir(), "mdt-module-shims-"));
-	const j = JSON.stringify;
-	for (const spec of SHARED_EXACT) {
-		const acc = `(globalThis.__mdtShared && globalThis.__mdtShared[${j(spec)}])`;
-		const names = SHARED_NAMES[spec] || [];
-		const content = [
-			`const __ns = ${acc};`,
-			`export default __ns;`,
-			...names.map((n) => `export const ${n} = __ns && __ns[${j(n)}];`)
-		].join("\n");
-		fs.writeFileSync(path.join(shimDir, spec.replace(/[^a-zA-Z0-9]/g, "_") + ".js"), content);
-	}
-	return shimDir;
-}
-
-// resolve.alias для Vite: перехватывают react/* до Rolldown-резолюции npm-пакетов
-// (resolveId-плагины Rolldown для npm-пакетов не зовёт — только alias работает).
-function sharedAliases(shimDir) {
-	return SHARED_EXACT.map((spec) => ({
-		find: new RegExp(`^${spec.replace(/[/$]/g, (c) => `\\${c}`)}$`),
-		replacement: path.join(shimDir, spec.replace(/[^a-zA-Z0-9]/g, "_") + ".js")
-	}));
-}
-
-// Инлайнит собранный CSS в JS-чанк (рантайм-инъекция <style>) — как старый webpack/style-loader:
-// оверлей копирует только index.js, отдельного css-файла нет.
-function cssInjectPlugin() {
-	return {
-		name: "mdt-css-inject",
-		enforce: "post",
-		generateBundle(_opts, bundle) {
-			let css = "";
-			for (const [file, chunk] of Object.entries(bundle)) {
-				if (chunk.type === "asset" && file.endsWith(".css")) {
-					css += typeof chunk.source === "string" ? chunk.source : Buffer.from(chunk.source).toString("utf8");
-					delete bundle[file];
-				}
-			}
-			if (!css) return;
-			const inject = `(function(){try{var s=document.createElement("style");s.textContent=${JSON.stringify(
-				css
-			)};document.head.appendChild(s);}catch(e){}})();\n`;
-			for (const chunk of Object.values(bundle)) {
-				if (chunk.type === "chunk" && chunk.isEntry) {
-					chunk.code = inject + chunk.code;
-					break;
-				}
-			}
-		}
-	};
-}
-
-// Единая Vite-конфигурация сборки одного модуля. Используется и CLI (bin/cli.mjs),
-// и dev-watch внутри MDT (через build_tools/external-modules.mjs).
-export function moduleViteConfig({ root, entry, outDir, watch = false, name = "__mdtModule" }) {
-	const shimDir = ensureShims();
-	return {
-		configFile: false,
-		root,
-		logLevel: "warn",
-		resolve: { alias: sharedAliases(shimDir) },
-		plugins: [cssInjectPlugin()],
-		build: {
-			outDir,
-			emptyOutDir: true,
-			minify: false,
-			...(watch ? { watch: {} } : {}),
-			rollupOptions: {
-				// Отключаем авто-externalize peerDeps (lib-режим Vite это делает по умолчанию):
-				// react/* уже перехвачены alias-шимами, ics-ui-kit/lucide должны забандлиться.
-				external: () => false
-			},
-			lib: {
-				entry,
-				// IIFE: грузится как <script> (config.modules → loadScript), самовыполняется.
-				formats: ["iife"],
-				name,
-				fileName: () => "index.js"
-			}
-		}
-	};
-}
+// mdt-module-builder — сборка внешнего UI-модуля MDT билдером MDT (Vite), артефакт «по старому»:
+// один самовыполняющийся dist/index.js (IIFE), который зовёт window.MDT.registerModule.
+//
+// Дедуп (MP-16057, вариант B): react-семья НЕ бандлится — заменяется alias-шимами,
+// читающими globalThis.__mdtShared[spec] (его ставит MDT при старте). ics-ui-kit/lucide-react
+// бандлятся внутрь; их внутренний import "react" тоже ловит alias → один инстанс React.
+//
+// react/* НЕ обязаны быть установлены в модуле (не попадают в бандл): имена их экспортов
+// зашиты статически (SHARED_NAMES) и версионируются мажором React вместе с пакетом.
+
+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";
+
+// Спецификаторы, которые резолвятся на единственную копию MDT через window.__mdtShared.
+export const SHARED_EXACT = ["react", "react-dom", "react-dom/client", "react/jsx-runtime", "react/jsx-dev-runtime"];
+
+// Тяжёлые/контекстные зависимости, которые MDT хостит и отдаёт модулям единым инстансом (как react):
+// react-query (один QueryClient/контекст), zustand, echarts (вес ~1 МБ). В модуль НЕ бандлятся —
+// externalize + чтение `globalThis.__mdtShared[<спецификатор>]`. В отличие от react-семьи, имена
+// экспортов перечислять НЕ нужно: Rollup сам обращается к членам глобала, поэтому подходит для
+// библиотек с большим/растущим API и подпутями. Каждый подпуть (zustand/middleware и т.п.) —
+// отдельный спецификатор: его и externalize, и экспонировать в __mdtShared нужно отдельно.
+// Добавление новой shared-зависимости: см. SHARED-DEPENDENCIES.md.
+export const SHARED_GLOBALS = [
+	"@tanstack/react-query",
+	"zustand",
+	"zustand/middleware",
+	"zustand/react/shallow",
+	"echarts",
+	"echarts-for-react"
+];
+
+// Именованные экспорты react-семьи (React 19). Зашиты статически — react не ставится при сборке.
+// При смене мажора React обновляются вместе с major-версией пакета (см. README §версионирование).
+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/client": ["createRoot", "hydrateRoot", "version"],
+	"react/jsx-runtime": ["Fragment", "jsx", "jsxs"],
+	"react/jsx-dev-runtime": ["Fragment", "jsxDEV"]
+};
+
+// Генерирует ESM shim-файлы (по одному на SHARED_EXACT) в свежей temp-папке.
+// Шим читает MDT-инстанс из globalThis.__mdtShared[spec]; именованные экспорты — из SHARED_NAMES.
+export function ensureShims() {
+	const shimDir = fs.mkdtempSync(path.join(os.tmpdir(), "mdt-module-shims-"));
+	const j = JSON.stringify;
+	for (const spec of SHARED_EXACT) {
+		const acc = `(globalThis.__mdtShared && globalThis.__mdtShared[${j(spec)}])`;
+		const names = SHARED_NAMES[spec] || [];
+		const content = [
+			`const __ns = ${acc};`,
+			`export default __ns;`,
+			...names.map((n) => `export const ${n} = __ns && __ns[${j(n)}];`)
+		].join("\n");
+		fs.writeFileSync(path.join(shimDir, spec.replace(/[^a-zA-Z0-9]/g, "_") + ".js"), content);
+	}
+	return shimDir;
+}
+
+// resolve.alias для Vite: перехватывают react/* до Rolldown-резолюции npm-пакетов
+// (resolveId-плагины Rolldown для npm-пакетов не зовёт — только alias работает).
+function sharedAliases(shimDir) {
+	return SHARED_EXACT.map((spec) => ({
+		find: new RegExp(`^${spec.replace(/[/$]/g, (c) => `\\${c}`)}$`),
+		replacement: path.join(shimDir, spec.replace(/[^a-zA-Z0-9]/g, "_") + ".js")
+	}));
+}
+
+// Публичный SDK MDT: спецификаторы `@mdt/<имя>` отдаются модулю как externalize. Их экспорты
+// кладёт MDT в globalThis.__mdtSdk — по одному ключу на файл папки ui/mdt-sdk (см. _register.ts).
+// Добавить публичный API = создать файл в ui/mdt-sdk; перечислять имена/спецификаторы не нужно.
+export const MDT_SDK_PREFIX = "@mdt/";
+
+// Куда внешний модуль адресует externalize-import: `@mdt/foo` → globalThis.__mdtSdk["foo"],
+// shared-dep → globalThis.__mdtShared["spec"]. Используется как output.globals.
+function globalRef(id) {
+	return id.startsWith(MDT_SDK_PREFIX)
+		? `globalThis.__mdtSdk[${JSON.stringify(id.slice(MDT_SDK_PREFIX.length))}]`
+		: `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) {
+	return {
+		name: "mdt-css-inject",
+		enforce: "post",
+		async generateBundle(_opts, bundle) {
+			let css = "";
+			for (const [file, chunk] of Object.entries(bundle)) {
+				if (chunk.type === "asset" && file.endsWith(".css")) {
+					css += typeof chunk.source === "string" ? chunk.source : Buffer.from(chunk.source).toString("utf8");
+					delete bundle[file];
+				}
+			}
+			css += await generateModuleTailwindCss(root);
+			if (!css) return;
+			const inject = `(function(){try{var s=document.createElement("style");s.textContent=${JSON.stringify(
+				css
+			)};document.head.appendChild(s);}catch(e){}})();\n`;
+			for (const chunk of Object.values(bundle)) {
+				if (chunk.type === "chunk" && chunk.isEntry) {
+					chunk.code = inject + chunk.code;
+					break;
+				}
+			}
+		}
+	};
+}
+
+// Единая Vite-конфигурация сборки одного модуля. Используется и CLI (bin/cli.mjs),
+// и dev-watch внутри MDT (через build_tools/external-modules.mjs).
+export function moduleViteConfig({ root, entry, outDir, watch = false, name = "__mdtModule" }) {
+	const shimDir = ensureShims();
+	return {
+		configFile: false,
+		root,
+		logLevel: "warn",
+		resolve: { alias: sharedAliases(shimDir) },
+		plugins: [cssInjectPlugin(root)],
+		build: {
+			outDir,
+			emptyOutDir: true,
+			minify: false,
+			...(watch ? { watch: {} } : {}),
+			rollupOptions: {
+				// SHARED_GLOBALS externalize: их инстанс даёт MDT через globalThis.__mdtShared, в модуль не бандлятся.
+				// react/* перехвачены alias-шимами; ics-ui-kit/lucide бандлятся целиком.
+				external: (id) => SHARED_GLOBALS.includes(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 }
+			},
+			lib: {
+				entry,
+				// IIFE: грузится как <script> (config.modules → loadScript), самовыполняется.
+				formats: ["iife"],
+				name,
+				fileName: () => "index.js"
+			}
+		}
+	};
+}