mdt-module-builder 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/CHANGELOG.md +58 -35
  2. package/README.md +32 -9
  3. package/SHARED-DEPENDENCIES.md +38 -2
  4. package/package.json +1 -1
  5. package/src/index.mjs +14 -3
package/CHANGELOG.md CHANGED
@@ -1,35 +1,58 @@
1
- # Changelog
2
-
3
- Все заметные изменения пакета документируются в этом файле.
4
-
5
- Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/), версии — [Semantic Versioning](https://semver.org/lang/ru/).
6
- Правила major/minor/patch для этого пакета — см. README, раздел «Версионирование»: изменения
7
- контракта (имя глобала, `SHARED_EXACT`, мажор React, источник Tailwind-классов модуля) — всегда
8
- major, т.к. потребители фиксируют зависимость через `^1.x` и автоматически подхватят любой minor/patch.
9
-
10
- ## [Unreleased]
11
-
12
- ### Removed
13
-
14
- - Билдер больше не собирает Tailwind CSS модуля (`generateModuleTailwindCss`, `loadIcsPreset` —
15
- удалены из пакета). Модуль перестаёт вести собственную, независимую Tailwind-сборку — источник
16
- Tailwind-классов теперь один: курируемый safelist core-сборки MDT (`ui/tailwind-safelist.mjs`).
17
- Причина — MP-16147: две независимые Tailwind-сборки ломали гарантию порядка CSS-правил
18
- (`base` перед `variant`), из-за чего голая утилита модуля могла перебить адаптивный вариант
19
- ui-kit (`.h-10` модуля поверх `.lg:h-9` из `ics-ui-kit`).
20
- - Зависимость `tailwindcss` убрана из `package.json` — больше не используется пакетом.
21
-
22
- ### Changed
23
-
24
- - **Ломающее изменение контракта.** Модуль, собранный этой версией, требует MDT с уже подключённым
25
- курируемым Tailwind-safelist (`safelist` в core-сборке). Классы, которых нет в safelist,
26
- физически не применятся в рантайме модуля — добавляются в MDT по мере реальной потребности
27
- (см. `ui/build_tools/tailwind-inventory.md`).
28
- - Модуль-специфичная стилизация — только обычный CSS (`import "./x.css"`, без изменений в этой
29
- части — `postcss-nested` + `autoprefixer` как и раньше), не Tailwind-утилиты.
30
-
31
- ## Версии до 2.0.0
32
-
33
- Пакет публиковался (`npm run release`, без git-тега) без чейнджлога — история 1.0.0…1.0.4 не
34
- восстановлена задним числом (нет надёжного источника: релизы не коммитятся в git). Ведение
35
- чейнджлога начинается с этой версии.
1
+ # Changelog
2
+
3
+ Все заметные изменения пакета документируются в этом файле.
4
+
5
+ Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/), версии — [Semantic Versioning](https://semver.org/lang/ru/).
6
+ Правила major/minor/patch для этого пакета — см. README, раздел «Версионирование»: изменения
7
+ контракта (имя глобала, `SHARED_EXACT`, мажор React, источник Tailwind-классов модуля) — всегда
8
+ major, т.к. потребители фиксируют зависимость через `^1.x` и автоматически подхватят любой minor/patch.
9
+
10
+ ## [Unreleased]
11
+
12
+ ### Added
13
+
14
+ - В `SHARED_GLOBALS` добавлены 8 спецификаторов (MP-16155): `@tanstack/react-virtual`,
15
+ `@tanstack/react-table`, `@dnd-kit/core`, `@dnd-kit/utilities`, `dnd-timeline`,
16
+ `tailwind-variants`, `react-hook-form`, `zod`. Модуль их больше не бандлит — читает инстанс
17
+ MDT из `globalThis.__mdtShared`.
18
+ Мотив: react-table, dnd-kit, react-hook-form и zod — зависимости самого `ics-ui-kit`, и своя
19
+ копия в модуле давала бы второй `DndContext`/`FormProvider` рядом с ui-kit (тот же класс
20
+ поломки, что две копии React); react-virtual нужен ≥ 2 модулям; `tailwind-variants` тянет
21
+ `tailwind-merge`, который должен быть общим с ui-kit; `dnd-timeline` обязан сидеть на том же
22
+ `@dnd-kit/core`.
23
+ - **Minor, не major.** Обратно совместимо для любого модуля, который эти 8 библиотек не
24
+ импортирует, — для него поведение не меняется вообще. Единственный теоретический риск —
25
+ модуль, который уже импортирует одну из них и рассчитывает на бандлинг: после апгрейда билдера
26
+ тот же импорт станет externalize-иться и на MDT без этого патча (MP-16155) превратится в
27
+ `undefined` без ошибки сборки. Проверено: единственный сегодняшний потребитель билдера
28
+ (`promo-tool`) закреплён на `mdt-module-builder ^1.0.0` и не подхватит эту версию автоматически
29
+ в любом случае; среди модулей, которые реально импортируют что-то из списка выше, ни один не
30
+ собирается билдером на `^2.x`. Риска молчаливой поломки уже работающей сборки нет — поэтому,
31
+ в отличие от 2.0.0, это не major (см. README, §Версионирование, и SHARED-DEPENDENCIES.md,
32
+ «Расширение SHARED_GLOBALS»). Реально начать пользоваться выносом (импортировать что-то из
33
+ списка и рассчитывать на общий инстанс) можно только на MDT с этим патчем.
34
+
35
+ ### Removed
36
+
37
+ - Билдер больше не собирает Tailwind CSS модуля (`generateModuleTailwindCss`, `loadIcsPreset` —
38
+ удалены из пакета). Модуль перестаёт вести собственную, независимую Tailwind-сборку — источник
39
+ Tailwind-классов теперь один: курируемый safelist core-сборки MDT (`ui/tailwind-safelist.mjs`).
40
+ Причина — MP-16147: две независимые Tailwind-сборки ломали гарантию порядка CSS-правил
41
+ (`base` перед `variant`), из-за чего голая утилита модуля могла перебить адаптивный вариант
42
+ ui-kit (`.h-10` модуля поверх `.lg:h-9` из `ics-ui-kit`).
43
+ - Зависимость `tailwindcss` убрана из `package.json` — больше не используется пакетом.
44
+
45
+ ### Changed
46
+
47
+ - **Ломающее изменение контракта.** Модуль, собранный этой версией, требует MDT с уже подключённым
48
+ курируемым Tailwind-safelist (`safelist` в core-сборке). Классы, которых нет в safelist,
49
+ физически не применятся в рантайме модуля — добавляются в MDT по мере реальной потребности
50
+ (см. `ui/build_tools/tailwind-inventory.md`).
51
+ - Модуль-специфичная стилизация — только обычный CSS (`import "./x.css"`, без изменений в этой
52
+ части — `postcss-nested` + `autoprefixer` как и раньше), не Tailwind-утилиты.
53
+
54
+ ## Версии до 2.0.0
55
+
56
+ Пакет публиковался (`npm run release`, без git-тега) без чейнджлога — история 1.0.0…1.0.4 не
57
+ восстановлена задним числом (нет надёжного источника: релизы не коммитятся в git). Ведение
58
+ чейнджлога начинается с этой версии.
package/README.md CHANGED
@@ -13,7 +13,7 @@
13
13
  ```json
14
14
  {
15
15
  "scripts": { "build": "mdt-module-build" },
16
- "devDependencies": { "mdt-module-builder": "^1.0.0" },
16
+ "devDependencies": { "mdt-module-builder": "^2.0.0" },
17
17
  "dependencies": { "mdt-client": "^31", "ics-ui-kit": "...", "lucide-react": "..." },
18
18
  "peerDependencies": { "react": "^19", "react-dom": "^19" }
19
19
  }
@@ -29,9 +29,14 @@ devtool/builder вызывают `npm run build` в репе модуля — м
29
29
  Заменяются alias-шимами, читающими `globalThis.__mdtShared[spec]` (MDT ставит его при старте).
30
30
  → один инстанс React во всём рантайме, нет «Invalid hook call».
31
31
  → react/react-dom **не обязаны быть установлены** при сборке (имена их экспортов зашиты в пакет).
32
- - **`SHARED_GLOBALS`** (`@tanstack/react-query`, `zustand` + подпути, `echarts`, `echarts-for-react`)
32
+ - **`SHARED_GLOBALS`** (`@tanstack/react-query`, `zustand` + подпути, `echarts`, `echarts-for-react`,
33
+ `@tanstack/react-virtual`, `@tanstack/react-table`, `@dnd-kit/core`, `@dnd-kit/utilities`,
34
+ `dnd-timeline`, `tailwind-variants`, `react-hook-form`, `zod`)
33
35
  — НЕ бандлятся: externalize + чтение `globalThis.__mdtShared[spec]`. В отличие от react-семьи,
34
- имена экспортов перечислять не нужно. Как вынести новую такую зависимость — см. [SHARED-DEPENDENCIES.md](./SHARED-DEPENDENCIES.md).
36
+ имена экспортов перечислять не нужно. Полный список с версиями и обоснованием, а также порядок
37
+ выноса новой такой зависимости — см. [SHARED-DEPENDENCIES.md](./SHARED-DEPENDENCIES.md).
38
+ Перечислены только корневые спецификаторы (кроме `zustand`): сабпас — отдельный спецификатор,
39
+ добавляется по факту потребности модуля, не «про запас».
35
40
  - **ics-ui-kit** (сам пакет и любой сабпас — `ics-ui-kit/components/*`, `ics-ui-kit/lib/*`, …) —
36
41
  НЕ бандлится: externalize по префиксу (`SHARED_PREFIXES`) + чтение `globalThis.__mdtShared[spec]`.
37
42
  Сабпасы перечислять не нужно. MDT кладёт туда свой инстанс (vite-app `legacy/shared-ui-kit.ts`),
@@ -68,6 +73,11 @@ devtool/builder вызывают `npm run build` в репе модуля — м
68
73
  - **CSS-вложенность.** Компонентный CSS модуля (`import "./x.css"`) прогоняется через
69
74
  `postcss-nested` (Sass-подобный `&`) + `autoprefixer` — та же семантика, что у старого
70
75
  `postcss-loader`. Native CSS nesting не задействуется.
76
+ - **CSS-модули работают** — `import styles from "./x.module.css"` даёт хешированные имена
77
+ (`.loadsTable` → `._loadsTable_1brdq_1`) и объект-маппинг, `postcss-nested` внутри тоже работает.
78
+ Это **предпочтительный** способ модуль-специфичной стилизации: имена не надо придумывать
79
+ уникальными, коллизия с core/ui-kit невозможна by construction (обычный `.css` инжектится
80
+ как есть, и generic-имя вроде `.card` вполне может столкнуться с чужим).
71
81
  - **`.svg` как строка.** SVG импортится встроенным Vite-суффиксом `?raw`
72
82
  (`import logo from "./logo.svg?raw"`) → строка с разметкой, инлайнится, без отдельного ассет-файла.
73
83
  Байт-в-байт как старый `svg-inline-loader`. Билдер SVG специально не обрабатывает: **bare**-импорт
@@ -121,15 +131,28 @@ MDT-сторона контракта — `ui/vite-app/src/legacy/config-global.
121
131
 
122
132
  SemVer пакета относительно платформы:
123
133
 
124
- - **major** — смена контракта: имя глобала, набор `SHARED_EXACT`, **мажор React** (обновляются
125
- `SHARED_NAMES`), или изменение источника Tailwind-классов модуля. Модули осознанно поднимают
126
- `mdt-module-builder` и проверяют совместимость.
127
- - **minor/patch** — внутренние правки сборки; выходной артефакт остаётся совместимым.
134
+ - **major** — изменение, которое молча ломает уже существующий, никак не менявшийся код модуля
135
+ при обычном (не ручном) апгрейде: имя глобала, переименование/удаление ключа в
136
+ `SHARED_EXACT`/`SHARED_GLOBALS`/`SHARED_PREFIXES`, мажор React (обновляются `SHARED_NAMES`),
137
+ изменение источника Tailwind-классов модуля. Модули осознанно поднимают `mdt-module-builder`
138
+ и проверяют совместимость.
139
+ - **minor** — обратно совместимое добавление: новый ключ в `SHARED_GLOBALS`/`SHARED_PREFIXES`
140
+ (библиотека, которую раньше никто не шарил, начинает шариться), новая опция сборки и т.п.
141
+ Модуль, который эту библиотеку не импортирует, ничего не замечает. Единственный риск —
142
+ модуль, который её уже импортирует и рассчитывает на бандлинг: после апгрейда билдера тот же
143
+ импорт станет externalize-иться, и на MDT без соответствующего патча платформы превратится
144
+ в `undefined` без ошибки сборки. Поэтому перед каждым добавлением в `SHARED_GLOBALS` —
145
+ проверить всех известных потребителей билдера на совместимом диапазоне версий на предмет
146
+ прямого импорта именно этой библиотеки. Нашёлся такой — для НЕЁ это major, а не minor.
147
+ - **patch** — внутренние правки сборки; выходной артефакт остаётся совместимым.
148
+
149
+ Пример применения правила — см. SHARED-DEPENDENCIES.md, «Расширение SHARED_GLOBALS».
128
150
 
129
151
  | mdt-module-builder | React | Платформа MDT |
130
152
  |---|---|---|
131
- | 1.x | 19 | (заполнить при первом релизе) |
132
- | 2.x | 19 | требует MDT с курируемым Tailwind-safelist (`ui/tailwind-safelist.mjs` в `safelist` core-сборки, MP-16147) — модуль больше не собирает свой Tailwind |
153
+ | 1.x | 19 | неизвестно — публиковался до введения CHANGELOG.md, надёжного источника нет |
154
+ | 2.x (опубликован 2026-07-27) | 19 | требует MDT с курируемым Tailwind-safelist (`ui/tailwind-safelist.mjs` в `safelist` core-сборки, MP-16147) — модуль больше не собирает свой Tailwind. **Модули должны сами поднять зависимость на `^2.0.0`** — на `^1.0.x` не подхватится автоматически (иначе сломались бы молча, см. CHANGELOG) |
155
+ | 2.1.x (не опубликован) | 19 | всё из 2.x + 8 новых ключей `SHARED_GLOBALS` (MP-16155): react-virtual, react-table, dnd-kit core/utilities, dnd-timeline, tailwind-variants, react-hook-form, zod. **Minor** — обратно совместимо, модули на `^2.0.0` подхватят автоматически; библиотеку в `devDependencies` подтягивают только когда реально начинают её импортировать. Реально начать пользоваться выносом можно только на MDT с этим патчем |
133
156
 
134
157
  ## Публикация
135
158
 
package/SHARED-DEPENDENCIES.md CHANGED
@@ -108,6 +108,26 @@ npm i -D <dep>@<версия> # в репозитории модуля; тот
108
108
  Rollup; после выноса проверь в рантайме, что `X` — это сам компонент, а не неймспейс.
109
109
  - **react-семья — особый, исторический случай** (alias-шимы `SHARED_EXACT`/`SHARED_NAMES` с
110
110
  перечислением имён). **Новые** зависимости добавляй в `SHARED_GLOBALS` — там имена перечислять не надо.
111
+ - **Вынос отключает tree-shaking в core-сборке.** `import * as _Dep` + запись в `__mdtShared`
112
+ тянет в бандл MDT **весь** пакет, а не используемую часть — модуль обращается к любому члену
113
+ глобала, и отсечь ничего нельзя. Это та же причина, по которой `lucide-react` осознанно НЕ
114
+ выносится (см. README). Замер MP-16155: 8 вынесенных библиотек дали **+356 КБ** минифицированного
115
+ кода в core (18.36 → 18.71 МБ суммарно по JS-ассетам `dist-vite`). Плата разовая и окупается,
116
+ только если библиотекой реально пользуются ≥ 2 модуля или нужен единый инстанс, — поэтому
117
+ Шаг 0 обязателен, а «про запас» не выносим.
118
+ - **Расширение `SHARED_GLOBALS` — обычно minor, а не major.** Новая запись ничего не меняет для
119
+ модуля, который эту библиотеку не импортирует. Единственный реальный риск — модуль, который её
120
+ СЕГОДНЯ импортирует и рассчитывает на бандлинг: после апгрейда билдера тот же импорт станет
121
+ externalize-иться, и на MDT без соответствующего патча платформы превратится в `undefined`
122
+ без ошибки сборки. Поэтому перед каждым добавлением — **шаг 0.5**: проверить всех известных
123
+ потребителей билдера на совместимом диапазоне версий (`^N.x`) на предмет прямого импорта именно
124
+ этой библиотеки. Нашёлся такой — для этого релиза правило переключается на major (см. README,
125
+ §Версионирование).
126
+ Пример (MP-16155): `@tanstack/react-virtual`, `@tanstack/react-table`, `@dnd-kit/core`,
127
+ `@dnd-kit/utilities`, `dnd-timeline`, `tailwind-variants`, `react-hook-form`, `zod` вынесены как
128
+ **2.1.0 (minor)** — единственный на тот момент потребитель билдера (`promo-tool`) сидел на
129
+ `mdt-module-builder ^1.0.0` и не мог подхватить релиз автоматически в любом случае, а среди уже
130
+ собираемых модулей никто из этих библиотек не бандлил при активной зависимости от билдера `^2.x`.
111
131
 
112
132
  ---
113
133
 
@@ -115,5 +135,21 @@ npm i -D <dep>@<версия> # в репозитории модуля; тот
115
135
 
116
136
  - **react-семья** (`SHARED_EXACT`, alias-шимы): `react`, `react-dom`, `react-dom/client`,
117
137
  `react/jsx-runtime`, `react/jsx-dev-runtime`.
118
- - **Externalize** (`SHARED_GLOBALS`): `@tanstack/react-query`, `zustand`, `zustand/middleware`,
119
- `zustand/react/shallow`, `echarts`, `echarts-for-react`.
138
+ - **Префикс** (`SHARED_PREFIXES`): `ics-ui-kit` и любой его сабпас.
139
+ - **Externalize** (`SHARED_GLOBALS`), только корневые спецификаторы, кроме `zustand`:
140
+
141
+ | спецификатор | версия в MDT | почему вынесена |
142
+ |---|---|---|
143
+ | `@tanstack/react-query` | ^5.101.4 | один `QueryClient`/контекст |
144
+ | `zustand` + `zustand/middleware` + `zustand/react/shallow` | ^5.0.11 | общий стор |
145
+ | `echarts`, `echarts-for-react` | ^5.5.0 / ^3.0.2 | вес (~1 МБ) |
146
+ | `@tanstack/react-virtual` | ^3.14.8 | нужна ≥ 2 модулям |
147
+ | `@tanstack/react-table` | ^8.21.3 | React-контекст, общий с ui-kit |
148
+ | `@dnd-kit/core`, `@dnd-kit/utilities` | ^6.3.1 / ^3.2.2 | `DndContext`, общий с ui-kit |
149
+ | `dnd-timeline` | ^3.1.1 | сидит на общем `@dnd-kit/core` |
150
+ | `tailwind-variants` | ^3.3.0 | общий `tailwind-merge` с ui-kit |
151
+ | `react-hook-form` | ^7.83.0 | `FormProvider`-контекст, общий с ui-kit |
152
+ | `zod` | ^3.25.76 | identity схем для `@hookform/resolvers` |
153
+
154
+ Всё, кроме `@tanstack/react-virtual` и `dnd-timeline`, уже стояло в MDT транзитивно как зависимость
155
+ `ics-ui-kit` — вынос свёлся к подъёму в прямые `dependencies`, вес MDT от этого не вырос.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mdt-module-builder",
3
- "version": "2.0.0",
3
+ "version": "2.1.0",
4
4
  "description": "Сборщик внешних UI-модулей MDT (Vite).",
5
5
  "type": "module",
6
6
  "bin": {
package/src/index.mjs CHANGED
@@ -27,13 +27,24 @@ export const SHARED_EXACT = ["react", "react-dom", "react-dom/client", "react/js
27
27
  // библиотек с большим/растущим API и подпутями. Каждый подпуть (zustand/middleware и т.п.) —
28
28
  // отдельный спецификатор: его и externalize, и экспонировать в __mdtShared нужно отдельно.
29
29
  // Добавление новой shared-зависимости: см. SHARED-DEPENDENCIES.md.
30
+ // Перечислены только КОРНЕВЫЕ спецификаторы: сабпасы (zod/v4, tailwind-variants/utils,
31
+ // zustand/middleware, …) модули сегодня не импортируют. Понадобится сабпас — добавляется
32
+ // отдельной строкой сюда и отдельным ключом в __mdtShared, "про запас" не добавляем.
30
33
  export const SHARED_GLOBALS = [
31
34
  "@tanstack/react-query",
32
35
  "zustand",
33
36
  "zustand/middleware",
34
37
  "zustand/react/shallow",
35
38
  "echarts",
36
- "echarts-for-react"
39
+ "echarts-for-react",
40
+ "@tanstack/react-virtual",
41
+ "@tanstack/react-table",
42
+ "@dnd-kit/core",
43
+ "@dnd-kit/utilities",
44
+ "dnd-timeline",
45
+ "tailwind-variants",
46
+ "react-hook-form",
47
+ "zod"
37
48
  ];
38
49
 
39
50
  // Библиотеки, которые MDT хостит ЦЕЛИКОМ и отдаёт модулям единым инстансом через ПРЕФИКС: матчим и
@@ -149,7 +160,7 @@ function globalRef(id) {
149
160
 
150
161
  // Инлайнит собранный CSS в JS-чанк (рантайм-инъекция <style>) — как старый webpack/style-loader:
151
162
  // оверлей копирует только index.js, отдельного css-файла нет. Модуль больше не собирает свой
152
- // Tailwind (MP-16147, Шаг 3): здесь только компонентный CSS модуля (import "./x.css",
163
+ // Tailwind (MP-16147): здесь только компонентный CSS модуля (import "./x.css",
153
164
  // postcss-nested + autoprefixer, см. css.postcss в moduleViteConfig). Tailwind-утилиты модулю
154
165
  // больше не нужны — они приходят из курируемого safelist core-сборки MDT (ui/tailwind-safelist.mjs).
155
166
  function cssInjectPlugin() {
@@ -205,7 +216,7 @@ export function moduleViteConfig({ root, entry, outDir, watch = false, name = "_
205
216
  plugins: [cssInjectPlugin()],
206
217
  // Компонентный CSS модуля (import "./x.css") гоняем через postcss-nested (Sass-подобная
207
218
  // вложенность `&`, как старый webpack builder) + autoprefixer. Инлайн-инъекцию делает
208
- // cssInjectPlugin. Tailwind-утилиты модуль больше не собирает (MP-16147, Шаг 3) — приходят
219
+ // cssInjectPlugin. Tailwind-утилиты модуль больше не собирает (MP-16147) — приходят
209
220
  // из курируемого safelist core-сборки MDT.
210
221
  css: { postcss: { plugins: [postcssNested(), autoprefixer()] } },
211
222
  build: {