mdt-module-builder 1.0.0

package/README.md

@@ -0,0 +1,64 @@
+# 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`).
+
+## Версионирование
+
+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
+```

package/bin/cli.mjs

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

package/package.json

@@ -0,0 +1,35 @@
+{
+	"name": "mdt-module-builder",
+	"version": "1.0.0",
+	"description": "Сборщик внешних UI-модулей MDT (Vite).",
+	"type": "module",
+	"bin": {
+		"mdt-module-build": "bin/cli.mjs"
+	},
+	"main": "src/index.mjs",
+	"exports": {
+		".": "./src/index.mjs"
+	},
+	"scripts": {
+		"build": "node --check bin/cli.mjs && node -e \"import('./src/index.mjs').then(() => console.log('mdt-module-builder: ok'))\"",
+		"release": "npm run build && npm version patch --no-git-tag-version && npm publish"
+	},
+	"files": [
+		"src",
+		"bin",
+		"README.md"
+	],
+	"engines": {
+		"node": ">=20"
+	},
+	"dependencies": {
+		"vite": "^8.0.16"
+	},
+	"keywords": [
+		"mdt",
+		"module",
+		"builder",
+		"vite"
+	],
+	"license": "UNLICENSED"
+}

package/src/index.mjs

@@ -0,0 +1,117 @@
+// 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"
+			}
+		}
+	};
+}