@mirta/workspace 0.0.1 → 0.4.0

package/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

package/README.md

@@ -1,45 +1,109 @@
-# @mirta/workspace
+# `@mirta/workspace`
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+[![en](https://img.shields.io/badge/lang-en-olivedrab.svg?style=flat-square)](https://github.com/wb-mirta/core/blob/latest/packages/mirta-workspace/README.md)
+[![ru](https://img.shields.io/badge/lang-ru-dimgray.svg?style=flat-square)](https://github.com/wb-mirta/core/blob/latest/packages/mirta-workspace/README.ru.md)
+[![NPM Version](https://img.shields.io/npm/v/@mirta/workspace?style=flat-square)](https://npmjs.com/package/@mirta/workspace)
+[![NPM Downloads](https://img.shields.io/npm/dm/@mirta/workspace?style=flat-square&logo=npm)](https://npmjs.com/package/@mirta/workspace)
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+> Utility set for analyzing repository structure in projects based on Mirta framework.
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+`@mirta/workspace` helps tools determine:
+- Where is the project root?
+- Which package manager is used?
+- Which packages are declared in `workspaces`?
 
-## Purpose
+Designed for reuse in other packages without heavy dependencies (e.g., from Rollup).<br/>
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@mirta/workspace`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+**Not intended for execution in the Duktape environment on Wiren Board controllers.**
 
-## What is OIDC Trusted Publishing?
+## 📦 Installation
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+```bash
+# Not required directly — used internally by Mirta
+pnpm add -D @mirta/workspace
+```
+⚠️ This package is part of Mirta's internal infrastructure. It is typically not used directly.
 
-## Setup Instructions
+## 🚀 Quick Start
 
-To properly configure OIDC trusted publishing for this package:
+```ts
+import { resolveMonorepoContextAsync } from '@mirta/workspace'
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+const context = await resolveMonorepoContextAsync(process.cwd())
 
-## DO NOT USE THIS PACKAGE
+console.log(context.rootDir) // /home/user/my-mirta-repo
+console.log(context.manager) // 'pnpm'
+console.log(context.packages) // [{ name: '@mirta/core', workspacePath: 'packages/core' }, ...]
+```
+## 🧰 API
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+`resolveWorkspaceContextAsync(cwd: string): Promise<WorkspaceContext>`<br/>
+Asynchronously resolves the workspace context (lightweight variant).
 
-## More Information
+Finds the workspace root by the presence of a lockfile (`pnpm-lock.yaml`, `yarn.lock`, etc.) and reads `package.json`.
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+Use this function when you only need to identify the workspace root and the package manager in use, without resolving all packages.
+
+Returns:
+
+```ts
+interface WorkspaceContext {
+  rootDir: string         // Root directory (where lockfile is located)
+  manager: PackageManager // 'pnpm' | 'bun' | 'yarn' | 'npm'
+  workspaces?: string[]   // Array of glob patterns from the `workspaces` field
+}
+```
+Throws: `WorkspaceError` if:
+
+Lockfile not found (`noLockfile`)
+`workspaces` has invalid format (`badWorkspacesFormat`)
+
+---
+
+`resolveMonorepoContextAsync(cwd: string): Promise<MonorepoContext>`<br/>
+Asynchronously resolves the full monorepo context.
+
+Based on `WorkspaceContext`, finds all packages declared in workspaces and reads their `package.json` using `@mirta/package`.
+
+Returns:
+
+```ts
+interface MonorepoContext {
+  rootDir: string
+  manager: PackageManager
+  packages: readonly PackageDefinition[]
+}
+```
+Packages are returned sorted by path length (longer paths first) to ensure correct matching in the future.
+
+Results are cached by `rootDir` for performance.
 
 ---
 
-**Maintained for OIDC setup purposes only**
+`toPosix(path: string): string`<br/>
+Converts a path to POSIX format (with `/`), even on Windows.
+
+Used to normalize paths before comparison and processing.
+
+## 🧩 Supported Package Managers
+
+Detected by lockfiles:
+- `pnpm` → `pnpm-lock.yaml`
+- `yarn` → `yarn.lock`
+- `npm` → `package-lock.json`
+- `bun` → `bun.lock`
+
+## ✅ Testing
+
+The package is fully covered with unit tests:
+- Finding root by lockfile
+- Handling `workspaces`
+- Collecting packages, sorting, caching
+- Cross-platform compatibility (Windows/POSIX)
+
+Uses Vitest and mocked dependencies (`find-up`, `glob`, `@mirta/package`).
+
+## ⚠️ Limitations
+
+**Works only in Node.js** (not in Duktape).<br/>
+`workspaces` must be an array of strings.

package/README.ru.md

@@ -0,0 +1,109 @@
+# `@mirta/workspace`
+
+[![en](https://img.shields.io/badge/lang-en-dimgray.svg?style=flat-square)](https://github.com/wb-mirta/core/blob/latest/packages/mirta-workspace/README.md)
+[![ru](https://img.shields.io/badge/lang-ru-olivedrab.svg?style=flat-square)](https://github.com/wb-mirta/core/blob/latest/packages/mirta-workspace/README.ru.md)
+[![NPM Version](https://img.shields.io/npm/v/@mirta/workspace?style=flat-square)](https://npmjs.com/package/@mirta/workspace)
+[![NPM Downloads](https://img.shields.io/npm/dm/@mirta/workspace?style=flat-square&logo=npm)](https://npmjs.com/package/@mirta/workspace)
+
+> Утилиты для анализа структуры репозитория в проектах на базе фреймворка Mirta.
+
+`@mirta/workspace` помогает инструментам определить:
+- Где находится корень проекта?
+- Какой пакетный менеджер используется?
+- Какие пакеты объявлены в `workspaces`?
+
+Предназначен для переиспользования в других пакетах без тяжёлых зависимостей (например, от Rollup).<br/>
+
+**Не предназначен для выполнения в среде Duktape на контроллерах Wiren Board.**
+
+---
+
+## 📦 Установка
+
+```bash
+# Не требуется напрямую — используется внутри Mirta
+pnpm add -D @mirta/workspace
+```
+⚠️ Этот пакет — часть внутренней инфраструктуры фреймворка Mirta. Обычно он не используется напрямую.
+
+## 🚀 Быстрый старт
+
+```ts
+import { resolveMonorepoContextAsync } from '@mirta/workspace'
+
+const context = await resolveMonorepoContextAsync(process.cwd())
+
+console.log(context.rootDir) // /home/user/my-mirta-repo
+console.log(context.manager) // 'pnpm'
+console.log(context.packages) // [{ name: '@mirta/core', workspacePath: 'packages/core' }, ...]
+```
+## 🧰 API
+
+`resolveWorkspaceContextAsync(cwd: string): Promise<WorkspaceContext>`<br/>
+Асинхронно определяет контекст рабочей области.
+
+Находит корень проекта по наличию lock-файла (`pnpm-lock.yaml`, `yarn.lock` и др.) и читает `package.json`.
+
+Возвращает:
+
+```ts
+interface WorkspaceContext {
+  rootDir: string         // Корневая директория (где находится lock-файл)
+  manager: PackageManager // 'pnpm' | 'yarn' | 'bun' | 'npm'
+  workspaces?: string[]   // Массив glob-паттернов из поля `workspaces`
+}
+```
+Выбрасывает: `WorkspaceError`, если:
+
+Не найден lock-файл (`noLockfile`)<br/>
+`workspaces` имеет недопустимый формат (`badWorkspacesFormat`)
+
+---
+
+`resolveMonorepoContextAsync(cwd: string): Promise<MonorepoContext>`<br/>
+Асинхронно определяет полный контекст монорепозитория.
+
+На основе `WorkspaceContext` находит все пакеты, объявленные в `workspaces`, и читает их `package.json` с помощью `@mirta/package`.
+
+Возвращает:
+
+```ts
+interface MonorepoContext {
+  rootDir: string
+  manager: PackageManager
+  packages: readonly PackageDefinition[]
+}
+```
+Пакеты возвращаются отсортированными по длине пути (сначала — более вложенные), чтобы обеспечить корректность сопоставления в будущем.
+
+Результат кэшируется по `rootDir` для производительности.
+
+---
+
+`toPosix(path: string): string`
+Приводит путь к POSIX-формату (с `/`), даже на Windows.
+
+Используется для нормализации путей перед сравнением и обработкой.
+
+## 🧩 Поддерживаемые пакетные менеджеры
+
+Определяются по lock-файлам:
+- `pnpm` → `pnpm-lock.yaml`
+- `yarn` → `yarn.lock`
+- `npm` → `package-lock.json`
+- `bun` → `bun.lock`
+
+## ✅ Тестирование
+
+Пакет полностью покрыт юнит-тестами:
+- Поиск корня по lock-файлу
+- Обработка `workspaces`
+- Сбор пакетов, сортировка, кэширование
+- Кроссплатформенность (Windows/POSIX)
+
+Используется Vitest, моки зависимостей (`find-up`, `glob`, `@mirta/package`).
+
+## ⚠️ Ограничения
+
+**Работает только в Node.js** (не в Duktape).<br/>
+workspaces должно быть массивом строк.

package/dist/index.d.mts

@@ -0,0 +1,132 @@
+/**
+ * Тип пакетного менеджера.
+ *
+ * @since 0.4.0
+ *
+ **/
+type PackageManager = 'pnpm' | 'yarn' | 'bun' | 'npm';
+/**
+ * Описывает контекст рабочей области (workspace).
+ *
+ * Содержит информацию о корневой директории, используемом пакетном менеджере
+ * и объявленных рабочих пространствах (workspaces).
+ *
+ * @since 0.4.0
+ *
+ **/
+interface WorkspaceContext {
+    /**
+     * Абсолютный путь к корневой директории репозитория в формате POSIX.
+     *
+     **/
+    readonly rootDir: string;
+    /**
+     * Определённый пакетный менеджер, используемый в проекте.
+     **/
+    readonly manager: PackageManager;
+    /**
+     * Необязательный массив glob-паттернов, определяющих пути к пакетам в монорепозитории.
+     *
+     * Соответствует полю `workspaces` в `package.json`.
+     * Должен быть массивом строк, например: `["packages/*"]`.
+     *
+     **/
+    readonly workspaces?: readonly string[];
+}
+/**
+ * Асинхронно определяет контекст рабочей области (workspace), начиная с заданной директории.
+ *
+ * Находит корень проекта по наличию lock-файла (pnpm/yarn/npm/bun), читает `package.json`
+ * и извлекает информацию о пакетном менеджере и рабочих пространствах.
+ *
+ * @param cwd - Рабочая директория, с которой начинается поиск.
+ * @returns Объект {@link WorkspaceContext} с корнем, менеджером и полем `workspaces` (если есть).
+ * @throws {WorkspaceError} Если lock-файл не найден или `workspaces` имеет недопустимый формат.
+ * @throws {PackageError} Если `package.json` отсутствует, недоступен или содержит невалидный JSON.
+ *
+ * @remarks
+ * - Поле `workspaces` может отсутствовать — это не ошибка.
+ * - Все пути возвращаются в POSIX-формате.
+ *
+ * @since 0.4.0
+ *
+ **/
+declare function resolveWorkspaceContextAsync(cwd: string): Promise<WorkspaceContext>;
+
+/**
+ * Контекст монорепозитория, содержащий корневую директорию и список пакетов.
+ *
+ * Является результатом анализа структуры монорепы.
+ *
+ * @since 0.4.0
+ *
+ **/
+interface MonorepoContext {
+    /**
+     * Абсолютный путь к корневой директории монорепозитория в формате POSIX.
+     *
+     **/
+    readonly rootDir: string;
+    /**
+     * Определённый пакетный менеджер, используемый в проекте.
+     *
+     **/
+    readonly manager: PackageManager;
+    /**
+     * Список всех пакетов, объявленных в рабочих пространствах.
+     * Отсортирован по длине пути (от самых вложенных).
+     *
+     **/
+    readonly packages: readonly PackageDefinition[];
+}
+/**
+ * Описывает структуру пакета в монорепозитории.
+ *
+ * Содержит имя пакета и его путь относительно корня монорепы.
+ *
+ * @since 0.4.0
+ *
+ **/
+interface PackageDefinition {
+    /**
+     * Имя пакета, указанное в `package.json`.
+     *
+     **/
+    readonly name: string;
+    readonly version?: string;
+    /**
+     * Признак того, что пакет не предназначен для публикации.
+     *
+     * Если значение `true`, пакет нельзя опубликовать в реестре (например, npm).
+     * Используется для защиты от случайной публикации внутренних или служебных пакетов.
+     *
+     **/
+    readonly isPrivate: boolean;
+    /**
+     * Путь к пакету относительно корня монорепозитория.
+     * Используется для сопоставления чанков с пакетами.
+     *
+     **/
+    readonly workspacePath: string;
+}
+/**
+ * Асинхронно разрешает контекст монорепозитория.
+ *
+ * Находит корень проекта, пакетный менеджер и все пакеты, объявленные в `workspaces`.
+ *
+ * @param cwd - Рабочая директория, с которой начинается поиск.
+ * @returns Объект {@link MonorepoContext} с информацией о монорепе.
+ * @throws {WorkspaceError} Если корень не найден или какой-либо из пакетов не имеет имени.
+ * @throws {PackageError} Если `package.json` недоступен или содержит невалидный JSON.
+ *
+ * @remarks
+ * - Требуется наличие lock-файла и поля `workspaces` в корневом `package.json`.
+ * - Все пути возвращаются в POSIX-формате.
+ *
+ * @since 0.4.0
+ *
+ **/
+declare function resolveMonorepoContextAsync(cwd: string): Promise<MonorepoContext>;
+
+export { resolveMonorepoContextAsync, resolveWorkspaceContextAsync };
+export type { MonorepoContext, PackageDefinition, PackageManager, WorkspaceContext };

package/dist/index.mjs

@@ -0,0 +1,217 @@
+import nodePath from 'node:path';
+import { findUp } from 'find-up';
+import { toPosix, readPackageAsync } from '@mirta/package';
+import { glob } from 'node:fs/promises';
+
+/**
+ * Класс ошибки для обработки проблем с монорепозиторием,
+ * расширяющий стандартный Error.
+ *
+ * @since 0.4.0
+ *
+ **/
+class WorkspaceError extends Error {
+    /** Код ошибки для программной идентификации. */
+    code;
+    /**
+     * Приватный конструктор для создания экземпляра ошибки.
+     *
+     * @param message - Сообщение об ошибке
+     * @param code - Код ошибки
+     * @param scope - Область, к которой относится ошибка (по умолчанию '@mirta/workspace').
+     *
+     **/
+    constructor(message, code, scope = '@mirta/workspace') {
+        super(`[${scope}] ${message}`);
+        this.name = 'WorkspaceError';
+        this.code = code;
+        if ('captureStackTrace' in Error)
+            // eslint-disable-next-line @typescript-eslint/unbound-method
+            Error.captureStackTrace(this, WorkspaceError.get);
+    }
+    /** Карта кодов ошибок с соответствующими сообщениями. */
+    static codeMappings = {
+        /**
+         * Ошибка, возникающая, когда не найден ни один из lock-файлов пакетных менеджеров
+         * (pnpm-lock.yaml, yarn.lock, package-lock.json, bun.lockb) в текущей или родительских директориях.
+         *
+         **/
+        noLockfile: () => 'No lockfile (pnpm/yarn/bun/npm) found. Required to detect workspace root',
+        noPackageName: (packagePath) => `Package with path "${packagePath}" missing required 'name' field in package.json`,
+        noWorkspaces: () => 'No workspaces configured in root package.json',
+        invalidWorkspaces: (pkgPath) => `Invalid workspaces in "${pkgPath}": must be array of strings`,
+    };
+    /**
+     * Статический метод для получения экземпляра ошибки по коду.
+     *
+     * @template T - Тип ключа из codeMappings
+     * @param code - Код ошибки
+     * @param args - Аргументы для формирования сообщения
+     * @returns Экземпляр {@link WorkspaceError}
+     *
+     **/
+    static get(code, ...args) {
+        const messageFn = this.codeMappings[code];
+        const message = messageFn(...args);
+        return new WorkspaceError(message, code);
+    }
+}
+
+/**
+ * Сопоставление lock-файлов с пакетными менеджерами.
+ *
+ * @since 0.4.0
+ *
+ **/
+const lockFileMappings = {
+    'pnpm-lock.yaml': 'pnpm',
+    'yarn.lock': 'yarn',
+    'bun.lock': 'bun',
+    'package-lock.json': 'npm',
+};
+/**
+ * Проверяет, что поле `workspaces` в `package.json` имеет корректный формат.
+ * Должно быть массивом строк или отсутствовать. Использование объекта (например, `{ packages: [...] }`) недопустимо.
+ *
+ * @param workspaces - Значение поля `workspaces` для проверки.
+ * @param pkgPath - Путь к package.json (используется в сообщении об ошибке).
+ *
+ * @throws {WorkspaceError} Если формат неверен.
+ *
+ * @since 0.4.0
+ *
+ **/
+function assertWorkspacesFieldFormat(workspaces, pkgPath) {
+    if (workspaces === null || workspaces === undefined)
+        return;
+    if (Array.isArray(workspaces) && workspaces.every(item => typeof item === 'string'))
+        return;
+    throw WorkspaceError.get('invalidWorkspaces', pkgPath.replaceAll(nodePath.win32.sep, nodePath.posix.sep));
+}
+/**
+ * Асинхронно определяет контекст рабочей области (workspace), начиная с заданной директории.
+ *
+ * Находит корень проекта по наличию lock-файла (pnpm/yarn/npm/bun), читает `package.json`
+ * и извлекает информацию о пакетном менеджере и рабочих пространствах.
+ *
+ * @param cwd - Рабочая директория, с которой начинается поиск.
+ * @returns Объект {@link WorkspaceContext} с корнем, менеджером и полем `workspaces` (если есть).
+ * @throws {WorkspaceError} Если lock-файл не найден или `workspaces` имеет недопустимый формат.
+ * @throws {PackageError} Если `package.json` отсутствует, недоступен или содержит невалидный JSON.
+ *
+ * @remarks
+ * - Поле `workspaces` может отсутствовать — это не ошибка.
+ * - Все пути возвращаются в POSIX-формате.
+ *
+ * @since 0.4.0
+ *
+ **/
+async function resolveWorkspaceContextAsync(cwd) {
+    const lockFiles = Object.keys(lockFileMappings);
+    const lockFilePath = toPosix(await findUp(lockFiles, { cwd }));
+    if (!lockFilePath)
+        throw WorkspaceError.get('noLockfile');
+    const rootDir = nodePath.dirname(lockFilePath);
+    const pkgPath = `${rootDir}/package.json`;
+    const pkg = await readPackageAsync(pkgPath);
+    assertWorkspacesFieldFormat(pkg.workspaces, pkgPath);
+    const fileName = nodePath.basename(lockFilePath);
+    return {
+        rootDir,
+        manager: lockFileMappings[fileName],
+        workspaces: pkg.workspaces,
+    };
+}
+
+/**
+ * Кэш пакетов монорепозитория по корневой директории.
+ * Позволяет избежать повторного сканирования файловой системы.
+ *
+ * @since 0.4.0
+ *
+ **/
+const packagesCache = new Map();
+/**
+ * Асинхронно разрешает контекст монорепозитория.
+ *
+ * Находит корень проекта, пакетный менеджер и все пакеты, объявленные в `workspaces`.
+ *
+ * @param cwd - Рабочая директория, с которой начинается поиск.
+ * @returns Объект {@link MonorepoContext} с информацией о монорепе.
+ * @throws {WorkspaceError} Если корень не найден или какой-либо из пакетов не имеет имени.
+ * @throws {PackageError} Если `package.json` недоступен или содержит невалидный JSON.
+ *
+ * @remarks
+ * - Требуется наличие lock-файла и поля `workspaces` в корневом `package.json`.
+ * - Все пути возвращаются в POSIX-формате.
+ *
+ * @since 0.4.0
+ *
+ **/
+async function resolveMonorepoContextAsync(cwd) {
+    const context = await resolveWorkspaceContextAsync(cwd);
+    const packages = await resolveMonorepoPackagesAsync(context);
+    return {
+        rootDir: context.rootDir,
+        manager: context.manager,
+        packages,
+    };
+}
+/**
+ * Асинхронно разрешает список пакетов монорепы.
+ *
+ * Находит все `package.json` в директориях, указанных в `workspaces`.
+ *
+ * @param context - Контекст workspace.
+ * @returns Массив пакетов, отсортированный по длине пути (от самых вложенных).
+ * @throws {WorkspaceError} Если пакет не имеет имени.
+ *
+ * @remarks
+ * - Результат кэшируется по `rootDir` для производительности.
+ * - Сортировка нужна, чтобы при сопоставлении по пути сначала проверялись более специфичные пакеты.
+ *
+ * @since 0.4.0
+ *
+ **/
+async function resolveMonorepoPackagesAsync(context) {
+    const { rootDir, workspaces = [] } = context;
+    const cachedPackages = packagesCache.get(rootDir);
+    // 1. Проверяем кэш
+    if (cachedPackages !== undefined)
+        return cachedPackages;
+    // 2. Пробуем найти пакеты, фиксируясь на обязательном наличии `package.json`
+    const pkgPatterns = workspaces.map(w => `${w}/package.json`);
+    const packages = [];
+    for await (const rawPkgPath of glob(pkgPatterns, {
+        cwd: rootDir,
+        exclude: ['node_modules/**'],
+    })) {
+        const pkgPath = toPosix(rawPkgPath);
+        const pkg = await readPackageAsync(`${rootDir}/${pkgPath}`);
+        if (!pkg.name)
+            throw WorkspaceError.get('noPackageName', pkgPath);
+        packages.push({
+            name: pkg.name,
+            version: pkg.version,
+            isPrivate: pkg.private === true,
+            workspacePath: nodePath.dirname(pkgPath),
+        });
+    }
+    // Сортируем по убыванию длины пути, чтобы сначала шли более вложенные пакеты
+    // (например, packages/heat/thermostat перед packages/heat).
+    //
+    // При равной длине — по лексикографическому порядку, чтобы порядок был детерминирован.
+    // Это необходимо для корректной идентификации пакета по chunkName.
+    //
+    packages.sort((a, b) => {
+        const lengthDiff = b.workspacePath.length - a.workspacePath.length;
+        if (lengthDiff !== 0)
+            return lengthDiff;
+        return a.workspacePath.localeCompare(b.workspacePath); // Лексикографически
+    });
+    const frozenPackages = Object.freeze(packages);
+    packagesCache.set(rootDir, frozenPackages);
+    return frozenPackages;
+}
+
+export { resolveMonorepoContextAsync, resolveWorkspaceContextAsync };

package/package.json

@@ -1,10 +1,54 @@
 {
   "name": "@mirta/workspace",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @mirta/workspace",
+  "version": "0.4.0",
+  "sideEffects": false,
+  "description": "Internal resolver for workspace and monorepo context, used by Mirta Framework",
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "mirta",
+    "workspace",
+    "monorepo",
+    "context",
+    "utility",
+    "nodejs",
+    "resolver"
+  ],
+  "license": "Unlicense",
+  "homepage": "https://github.com/wb-mirta/core#readme",
+  "bugs": {
+    "url": "https://github.com/wb-mirta/core/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wb-mirta/core.git",
+    "directory": "packages/mirta-workspace"
+  },
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    }
+  },
+  "imports": {
+    "#context/*": "./src/context/*.js",
+    "#errors": "./src/errors/index.js"
+  },
+  "dependencies": {
+    "find-up": "^8.0.0",
+    "@mirta/package": "0.4.0"
+  },
+  "engines": {
+    "node": ">=24.12.0"
+  },
+  "scripts": {
+    "build:mono": "rollup -c node:@mirta/rollup/config-package"
+  }
+}