@mirta/rollup 0.3.4 → 0.4.0

package/dist/runtime.mjs

@@ -0,0 +1,296 @@
+import multi from '@rollup/plugin-multi-entry';
+import nodeResolve from '@rollup/plugin-node-resolve';
+import ts from 'rollup-plugin-typescript2';
+import replace from '@rollup/plugin-replace';
+import { getBabelOutputPlugin } from '@rollup/plugin-babel';
+import { loadEnvReplacements } from '@mirta/env-loader';
+import { resolveMonorepoContextAsync } from '@mirta/workspace';
+import { B as BuildError, d as del } from './errors.mjs';
+import path from 'path';
+import MagicString from 'magic-string';
+import nodePath from 'node:path';
+
+// Абсолютный путь к результирующему каталогу.
+const outputDir = path.join(process.cwd(), 'dist');
+const modulesDir = path.join(outputDir, 'wb-rules-modules');
+// Расположение обрабатываемого чанка.
+const getChunkDir = (fileName) => path.dirname(path.join(outputDir, fileName));
+// Шаблон для отлова конструкций require.
+const patternRequire = /require\(['"]([^'"]+)'\)/g;
+/**
+ * Плагин Rollup, перестраивающий пути импорта модулей
+ * относительно каталога wb-rules-modules.
+ * */
+function wbRulesImports() {
+    return {
+        name: 'wbRulesImports',
+        // Выполняется перед записью содержимого
+        // в результирующий файл.
+        renderChunk(code, chunk) {
+            // Виртуальный каталог не обрабатываем.
+            if (chunk.fileName.startsWith('_virtual'))
+                return;
+            const magicString = new MagicString(code);
+            let hasReplacements = false;
+            let start;
+            let end;
+            const chunkDir = getChunkDir(chunk.fileName);
+            // Преобразует путь подключения модуля в формат,
+            // поддерживаемый контроллером Wirenboard.
+            function rebaseRequire(match) {
+                // Начальная позиция оригинального вхождения
+                start = match.index;
+                // Конечная позиция оригинального вхождения
+                end = start + match[0].length;
+                // Преобразует путь подключаемого модуля в абсолютный,
+                // опираясь на каталог с текущим обрабатываемым файлом.
+                const requireAbsolutePath = path.resolve(chunkDir, match[1]);
+                // Если абсолютный путь начинается с каталога модулей...
+                if (requireAbsolutePath.startsWith(modulesDir)) {
+                    const parsed = path.parse(path.relative(modulesDir, requireAbsolutePath));
+                    const rebased = path
+                        .join(parsed.dir, parsed.name)
+                        .replaceAll(path.sep, path.posix.sep);
+                    // Удаляет расширение файла для полного соответствия
+                    // принципам импорта модулей wb-rules.
+                    const replacement = match[0]
+                        .replace(match[1], rebased);
+                    magicString.overwrite(start, end, replacement);
+                    // Признак произведённой замены.
+                    return true;
+                }
+            }
+            // Строит полный список конструкций require
+            // в обрабатываемом файле.
+            const matches = [...code.matchAll(patternRequire)];
+            for (const match of matches) {
+                if (rebaseRequire(match))
+                    hasReplacements = true;
+            }
+            // Если никаких замен не было, то файл пропускается.
+            if (!hasReplacements)
+                return null;
+            return {
+                code: magicString.toString(),
+            };
+        },
+    };
+}
+
+/**
+ * Находит пакет, которому принадлежит указанный чанк.
+ *
+ * Поиск выполняется по префиксу пути: первый пакет, чей `workspacePath`
+ * является началом `chunkName`, считается владельцем.
+ *
+ * @param context - Контекст монорепозитория.
+ * @param chunkName - Имя чанка, предоставляемое Rollup (`chunk.name`).
+ * @returns Объект {@link PackageDefinition} или `undefined`, если пакет не найден.
+ *
+ * @since 0.4.0
+ *
+ **/
+function findPackageByChunkName(context, chunkName) {
+    for (const pkg of context.packages) {
+        if (chunkName.startsWith(pkg.workspacePath + '/'))
+            return pkg;
+    }
+}
+
+/**
+ * Преобразует имя чанка в путь, имитирующий установленный пакет в `node_modules`.
+ *
+ * Позволяет обрабатывать импорты из других пакетов монорепозитория
+ * наравне с установленными зависимостями.
+ *
+ * @param chunkName - Путь к файлу от корня монорепозитория в формате POSIX (и без расширения).
+ * @param pkgDefinition - Пакет, которому принадлежит файл.
+ * @returns Виртуальный путь вида `node_modules/<имя-пакета>/<относительный-путь>`.
+ *
+ * @example
+ * ```ts
+ * toVirtualModulePath('packages/mirta-home/dist/heater', {
+ *   name: '@mirta/home',
+ *   workspacePath: 'packages/mirta-home'
+ * })
+ * // → 'node_modules/@mirta/home/dist/heater'
+ * ```
+ * @since 0.4.0
+ *
+ **/
+function toVirtualModulePath(chunkName, pkgDefinition) {
+    const relativePath = nodePath.posix.relative(pkgDefinition.workspacePath, chunkName);
+    // Проверяем, что путь не выходит за пределы пакета.
+    if (relativePath.startsWith('..'))
+        throw BuildError.get('chunkOutsidePackage', chunkName, pkgDefinition.name, pkgDefinition.workspacePath);
+    return `node_modules/${pkgDefinition.name}/${relativePath}`;
+}
+
+const packagesPattern = /(.*)node_modules[\\/]@?(.+)[\\/](.+)?/;
+const entryMatchers = {
+    'wb-rules': /(?:src[\\/])?wb-rules[\\/](.*)/,
+    'wb-rules-modules': /(?:src[\\/])?wb-rules-modules[\\/](.*)/,
+};
+/**
+ * Парсит путь к исходному файлу и возвращает имя модуля формата `wb-rules-modules/...`.
+ * Используется для обработки путей внутри node_modules.
+ *
+ * @param sourcePath - путь к исходному файлу
+ * @returns Строка с именем модуля или undefined
+ *
+ * @since 0.3.2
+ *
+ **/
+function tryGetPackageEntryPath(sourcePath) {
+    sourcePath = sourcePath.replaceAll(nodePath.sep, nodePath.posix.sep);
+    const pathParts = [];
+    do {
+        const match = packagesPattern.exec(sourcePath);
+        if (!match)
+            break;
+        if (match[3])
+            pathParts.unshift(match[3]);
+        pathParts.unshift('packages/' + match[2].replace(/\/dist$/, ''));
+        sourcePath = match[1];
+    } while (sourcePath);
+    if (pathParts.length)
+        return `wb-rules-modules/${pathParts.join('/')}.js`;
+}
+/**
+ * Определяет имя входного файла для типов `wb-rules` и `wb-rules-modules`.
+ *
+ * @param sourcePath - путь к исходному файлу
+ * @param type - тип модуля (wb-rules или wb-rules-modules)
+ * @returns Строка с именем файла или undefined
+ *
+ * @since 0.3.5
+ *
+ **/
+function tryGetEntryPath(sourcePath, type) {
+    const match = entryMatchers[type].exec(sourcePath);
+    if (!match)
+        return;
+    return `${type}/${match[1]}.js`;
+}
+/**
+ * Проверяет различные сценарии и возвращает корректный путь выходного файла.
+ *
+ * @param filePath - Исходный путь к файлу.
+ * @returns Строка с корректным путём.
+ *
+ * @since 0.3.0
+ *
+ **/
+function getEntryPath(filePath) {
+    if (filePath.startsWith('_virtual'))
+        return filePath;
+    return tryGetPackageEntryPath(filePath)
+        ?? tryGetEntryPath(filePath, 'wb-rules-modules')
+        ?? tryGetEntryPath(filePath, 'wb-rules')
+        // None of the above matched.
+        ?? filePath;
+}
+
+const mode = process.env.NODE_ENV ?? 'development';
+const isProduction = mode === 'production';
+const outDir = 'dist/es5';
+/**
+ * Собирает Rollup-конфигурацию для сборки runtime-кода проекта с учётом монорепозитория и подстановки переменных окружения.
+ *
+ * @param options - Параметры: `cwd` — рабочая директория проекта; `external` — список внешних зависимостей; `envLoader` — опции загрузчика окружения; `plugins` — дополнительные Rollup-плагины
+ * @returns Сконфигурированный объект RollupOptions, готовый для сборки в каталог `dist/es5`
+ * @since 0.3.0
+ */
+async function defineRuntimeConfig(options = {}) {
+    const { cwd = process.cwd(), external, envLoader: envLoaderOptions, plugins = [], } = options;
+    const monorepoContext = await resolveMonorepoContextAsync(cwd);
+    const defaultPlugins = [
+        // Очистка директории dist перед сборкой
+        del({
+            targets: outDir,
+        }),
+        // Поддержка множественных входных файлов
+        multi({
+            exclude: ['src/wb-rules/*.disabled.[jt]s'],
+            preserveModules: true,
+        }),
+        // Поиск зависимостей в node_modules
+        nodeResolve(),
+        // Транспиляция TypeScript
+        ts({ clean: true }),
+        // Обработка импортов для wb-rules
+        wbRulesImports(),
+        // Подстановка переменных окружения
+        replace({
+            preventAssignment: true,
+            values: {
+                // Загрузка переменных окружения
+                ...loadEnvReplacements({
+                    ...envLoaderOptions,
+                    mode,
+                    cwd,
+                    rootDir: monorepoContext.rootDir,
+                }),
+                // Признак сборки в режиме разработки
+                __DEV__: JSON.stringify(!isProduction),
+                // Автоматически меняется в процессе тестирования
+                __TEST__: 'false',
+            },
+        }),
+        // Транспиляция через Babel
+        getBabelOutputPlugin({
+            presets: ['@babel/preset-env'],
+            plugins: [
+                '@babel/plugin-transform-spread',
+                'array-includes',
+            ],
+        }),
+        // Очистка виртуальных файлов после сборки
+        del({
+            targets: `${outDir}/_virtual`,
+            hook: 'closeBundle',
+        }),
+    ];
+    return {
+        input: 'src/wb-rules/*.[jt]s',
+        external,
+        plugins: [
+            ...defaultPlugins,
+            ...plugins,
+        ],
+        output: {
+            format: 'cjs',
+            strict: false,
+            dir: outDir,
+            preserveModules: true,
+            entryFileNames(chunk) {
+                // Относительный путь от корня репозитория.
+                let chunkName = chunk.name;
+                // Адаптация путей при сборке в монорепозитории.
+                if (monorepoContext.packages.length !== 0) {
+                    const { rootDir } = monorepoContext;
+                    // Преобразуем chunkName (относительный путь от корня монорепозитория)
+                    // в абсолютный путь для корректного сравнения с cwd (абсолютным путём
+                    // к текущему пакету).
+                    //
+                    const absolutePath = nodePath.resolve(rootDir, chunkName);
+                    if (absolutePath.startsWith(cwd)) {
+                        // Путь в текущем проекте, не требует встраивания отдельным пакетом.
+                        chunkName = nodePath
+                            .relative(cwd, absolutePath)
+                            .replaceAll(nodePath.sep, nodePath.posix.sep);
+                    }
+                    else {
+                        // Ищем пакет монорепозитория, в котором находится указанный путь.
+                        const pkgDefinition = findPackageByChunkName(monorepoContext, chunkName);
+                        if (pkgDefinition)
+                            chunkName = toVirtualModulePath(chunkName, pkgDefinition);
+                    }
+                }
+                return getEntryPath(chunkName);
+            },
+        },
+    };
+}
+
+export { defineRuntimeConfig as d };

package/package.json

@@ -1,13 +1,24 @@
 {
   "name": "@mirta/rollup",
-  "description": "Predefined Rollup configuration for wb-rules project builds.",
-  "version": "0.3.4",
-  "license": "Unlicense",
+  "version": "0.4.0",
+  "sideEffects": false,
+  "description": "Predefined Rollup configuration for wb-rules project builds",
   "keywords": [
     "mirta",
     "wb-rules"
   ],
+  "license": "Unlicense",
+  "homepage": "https://github.com/wb-mirta/core/tree/latest/packages/mirta-rollup#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wb-mirta/core.git",
+    "directory": "packages/mirta-rollup"
+  },
+  "bugs": {
+    "url": "https://github.com/wb-mirta/core/issues"
+  },
   "type": "module",
+  "types": "./dist/index.d.mts",
   "files": [
     "dist",
     "LICENSE",
@@ -19,39 +30,56 @@
         "types": "./dist/index.d.mts",
         "default": "./dist/index.mjs"
       }
+    },
+    "./config": {
+      "types": "./dist/config.d.mts",
+      "default": "./dist/config.mjs"
+    },
+    "./config-package": {
+      "types": "./dist/config-package.d.mts",
+      "default": "./dist/config-package.mjs"
     }
   },
-  "homepage": "https://github.com/wb-mirta/core/tree/latest/packages/mirta-rollup#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/wb-mirta/core.git",
-    "directory": "packages/mirta-rollup"
-  },
-  "bugs": {
-    "url": "https://github.com/wb-mirta/core/issues"
+  "imports": {
+    "#src/*": "./src/*.js",
+    "#ast": "./src/ast-transformers/index.js",
+    "#utils/*": "./src/utils/*.js",
+    "#utils/monorepo": "./src/utils/monorepo/index.js",
+    "#plugins/*": "./src/plugins/*.js",
+    "#configs/*": "./src/configs/*.js"
   },
   "dependencies": {
-    "@babel/core": "^7.28.4",
-    "@babel/preset-env": "^7.28.3",
-    "@dotenv-run/rollup": "^1.3.7",
-    "@rollup/plugin-commonjs": "^28.0.6",
-    "@rollup/plugin-babel": "^6.0.4",
-    "@rollup/plugin-multi-entry": "^6.0.1",
-    "@rollup/plugin-node-resolve": "^16.0.2",
-    "@rollup/plugin-typescript": "^12.1.4",
+    "@babel/core": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@babel/plugin-transform-spread": "^7.27.1",
+    "@dotenvx/dotenvx": "^1.51.1",
+    "@rollup/plugin-babel": "^6.1.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-multi-entry": "^7.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
     "babel-plugin-array-includes": "^2.0.3",
     "del": "^8.0.1",
-    "magic-string": "^0.30.19",
-    "rollup-plugin-dts": "^6.2.3",
+    "magic-string": "^0.30.21",
+    "rollup-plugin-copy": "^3.5.0",
+    "rollup-plugin-dts": "^6.3.0",
     "rollup-plugin-typescript2": "^0.36.0",
-    "typescript": "^5.8.3",
-    "@mirta/polyfills": "0.3.4"
+    "find-up": "^8.0.0",
+    "@mirta/basics": "0.4.0",
+    "@mirta/env-loader": "0.4.0",
+    "@mirta/package": "0.4.0",
+    "@mirta/workspace": "0.4.0"
   },
   "devDependencies": {
-    "rollup": "^4.52.4"
+    "rollup": "^4.55.1",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "rollup": ">= 4.52.5 < 5",
+    "typescript": ">= 5.8.3 < 6"
   },
   "scripts": {
-    "clean": "rimraf dist",
-    "build:mono": "pnpm clean && rollup -c ../../rollup.config.mjs"
+    "build:mono": "rollup -c --configPlugin typescript={tsconfig:\\\"./tsconfig.build.json\\\"}"
   }
 }