mdt-module-builder 1.0.2 → 1.0.3

package/README.md

@@ -30,7 +30,12 @@ devtool/builder вызывают `npm run build` в репе модуля — м
 - **`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` (должны быть установлены).
+- **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`),
+  по ключу на каждый сабпас. → один инстанс ui-kit → общий React-контекст (тема, провайдеры): иначе
+  компоненты модуля читали бы чужой `ThemeContext`. CSS-сабпасы (`styles.css`) не externalize-ятся.
+- **lucide-react, mdt-client** — бандлятся внутрь `index.js` (должны быть установлены).
   Их внутренний `import "react"` тоже перехватывается шимом.
 - **CSS** инлайнится в `index.js` (рантайм-инъекция `<style>`), как старый style-loader —
   оверлей копирует только `index.js`, отдельного `.css` нет.
@@ -66,9 +71,14 @@ registerModule(() => MDT.Navigation.addNode({ code: "x", title: "X" }));
 Модуль и MDT договариваются о:
 
 - имени глобала **`window.__mdtShared`**;
-- наборе ключей **`SHARED_EXACT`** (react-семья);
+- наборе ключей **`SHARED_EXACT`** (react-семья), **`SHARED_GLOBALS`** и префиксах
+  **`SHARED_PREFIXES`** (`ics-ui-kit`) — все они должны присутствовать в `__mdtShared` хоста;
 - **мажоре React** (от него зависит список именованных экспортов `SHARED_NAMES`).
 
+Вынос `ics-ui-kit` в `__mdtShared` — **ломающее** изменение контракта: модуль, собранный новым
+билдером, больше не бандлит ui-kit и требует MDT, который его экспонирует (`legacy/shared-ui-kit.ts`).
+Версию билдера поднимать соответственно (см. §Версионирование).
+
 MDT-сторона контракта — `ui/vite-app/src/legacy/config-global.ts` (ставит `__mdtShared`).
 
 ## Vite / Node

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mdt-module-builder",
-	"version": "1.0.2",
+	"version": "1.0.3",
 	"description": "Сборщик внешних UI-модулей MDT (Vite).",
 	"type": "module",
 	"bin": {

package/src/index.mjs

@@ -1,9 +1,10 @@
 // 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.
+// Дедуп (MP-16057, вариант B): react-семья и ics-ui-kit НЕ бандлятся — react-семья через
+// alias-шимы, ics-ui-kit (и любой его сабпас) через externalize; оба читаются из
+// globalThis.__mdtShared[spec] (его ставит MDT при старте) → один инстанс на рантайм.
+// lucide-react пока бандлится внутрь; её внутренний import "react" ловит alias → общий React.
 //
 // react/* НЕ обязаны быть установлены в модуле (не попадают в бандл): имена их экспортов
 // зашиты статически (SHARED_NAMES) и версионируются мажором React вместе с пакетом.
@@ -33,6 +34,19 @@ export const SHARED_GLOBALS = [
 	"echarts-for-react"
 ];
 
+// Библиотеки, которые MDT хостит ЦЕЛИКОМ и отдаёт модулям единым инстансом через ПРЕФИКС: матчим и
+// сам пакет, и любой его сабпас (ics-ui-kit/components/button, ics-ui-kit/lib/utils, …). В отличие
+// от SHARED_GLOBALS (точные спецификаторы) сабпасы перечислять не нужно — их у ui-kit десятки и они
+// растут. Экспорты каждого сабпаса кладёт MDT в globalThis.__mdtShared (vite-app legacy/shared-ui-kit.ts).
+// Общий инстанс ui-kit нужен ради общего React-контекста (тема, провайдеры): две копии ui-kit = два
+// разных ThemeContext даже при общем React. CSS-сабпасы (styles.css и т.п.) не externalize-им.
+export const SHARED_PREFIXES = ["ics-ui-kit"];
+
+function isSharedPrefix(id) {
+	if (id.endsWith(".css")) return false;
+	return SHARED_PREFIXES.some((p) => id === p || id.startsWith(p + "/"));
+}
+
 // Именованные экспорты react-семьи (React 19). Зашиты статически — react не ставится при сборке.
 // При смене мажора React обновляются вместе с major-версией пакета (см. README §версионирование).
 export const SHARED_NAMES = {
@@ -165,9 +179,9 @@ export function moduleViteConfig({ root, entry, outDir, watch = false, name = "_
 			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),
+				// 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