mdt-module-builder 1.0.4 → 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` модуля:
@@ -45,11 +47,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 +67,7 @@ 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 не задействуется.
 - **`.svg` как строка.** SVG импортится встроенным Vite-суффиксом `?raw`
   (`import logo from "./logo.svg?raw"`) → строка с разметкой, инлайнится, без отдельного ассет-файла.
   Байт-в-байт как старый `svg-inline-loader`. Билдер SVG специально не обрабатывает: **bare**-импорт
@@ -116,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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mdt-module-builder",
-	"version": "1.0.4",
+	"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": {
@@ -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";
@@ -57,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"]
@@ -96,7 +93,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 +123,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 +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")) {
@@ -191,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
@@ -214,12 +186,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, Шаг 3) — приходят
+		// из курируемого safelist core-сборки MDT.
 		css: { postcss: { plugins: [postcssNested(), autoprefixer()] } },
 		build: {
 			outDir,
@@ -230,12 +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 берёт `.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,