@application-kit/module-manifest 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @application-kit/module-manifest
+
+## 0.1.1
+
+### Patch Changes
+
+- 8e10f98: Peer-зависимости принимают Nest 12, `@nestjs/graphql` и `@nestjs/mercurius` 14, `@nestjs/cqrs` 12 и `nestjs-pino` 5. `PinoLoggerConfig` задаёт `forRoutes` явно: с маршрутом nestjs-pino 5 по умолчанию запросы на Fastify не логировались.
+
+## 0.1.0
+
+### Minor Changes
+
+- 2db129d: Первый выпуск: контракты манифестов модуля (web, CLI, консьюмер, гранты с типом карты параметром), сборщики `collectWebModules`, `collectClientWebModules`, `collectProcessModules` с `DuplicateModuleNameError`; вход `/nest` — `createModuleRegistryProvider` с типом навигации параметром; вход `/vite-plugin` — `vitePluginModuleEntries` для клиентских entry модулей по раскладке.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 application-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

package/README.md

@@ -1,3 +1,90 @@
-# Temporary Holding Version
+# @application-kit/module-manifest
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Манифест модуля продукта: модуль сообщает сборке о себе файлами в своём корне, а приложение подключает его одной
+строкой в реестре процесса. Пакет даёт контракты этих файлов, сборщики модулей процесса с проверкой дублей имён,
+SSR-реестр клиентских модулей для NestJS и Vite-плагин, который находит клиентские entry по раскладке. Имён модулей,
+типа навигации и карты грантов продукта в пакете нет: реестры ведёт приложение, типы приходят параметрами.
+
+## Установка
+
+```sh
+yarn add @application-kit/module-manifest
+```
+
+Peer-зависимости: `@nestjs/common`; для входа `/nest` — `@libs-for-dev/vue-modular-application` и `vue-router`; для входа
+`/vite-plugin` — `vite` (только типы).
+
+## Входы
+
+| Вход | Для чего | Тянет |
+|------|----------|-------|
+| `@application-kit/module-manifest` | контракты манифестов, сборщики `collect*Modules`, `DuplicateModuleNameError` | ничего (типы `@nestjs/common`) |
+| `@application-kit/module-manifest/nest` | `createModuleRegistryProvider` — SSR-реестр клиентских модулей | `@libs-for-dev/vue-modular-application` |
+| `@application-kit/module-manifest/vite-plugin` | `vitePluginModuleEntries` — script-теги клиентских entry в `index.html` | `node:fs`, `node:path` (типы `vite`) |
+
+Импорт любого входа не имеет побочных эффектов и не требует окружения. Входы разделены по рантайм-графу: сборщики грузят
+CLI- и консьюмер-процессы, и корень с `ModuleRegistry` втянул бы в них Vue, а `vite.config` — Nest.
+
+## Файлы модуля
+
+| Файл в корне модуля | Контракт | Процесс |
+|---------------------|----------|---------|
+| `module.manifest.ts` | `ModuleManifestInterface` — `name`, `web`, `clientModuleToken?` | web |
+| `module.cli.ts` | `ProcessModuleManifestInterface` — `name`, `module` | CLI |
+| `module.consumers.ts` | `ConsumerModuleManifestInterface` — плюс `queues` | консьюмер |
+| `module.grants.ts` | `AbilityGrantsManifestInterface<TGrants>` — `name`, `grants` | web и браузер |
+
+Файл на процесс, а не поля одного манифеста: конфиги модулей валидируют окружение на импорте, и общий манифест тянул бы
+в процесс чужой граф с чужим окружением. `name` равен имени папки модуля — по нему модуль включают из окружения.
+
+## Сборка процесса
+
+```ts
+import { collectProcessModules, collectWebModules } from '@application-kit/module-manifest'
+
+@Module({ imports: [CommonWebModule, ...collectWebModules(MODULE_MANIFESTS)] })
+export class AppModule {}
+
+@Module({ imports: [ConsoleModule, ...collectProcessModules(CLI_MANIFESTS)] })
+export class CliModule {}
+```
+
+Сборщики сохраняют порядок регистрации и бросают `DuplicateModuleNameError`, если имя встречается дважды: включение
+по имени иначе стало бы неоднозначным. `collectClientWebModules` отдаёт web-модули только тех модулей, у которых есть
+`clientModuleToken`, — их импортирует оболочка, чтобы резолвить клиентские модули.
+
+## SSR-реестр клиентских модулей
+
+```ts
+import { collectClientWebModules } from '@application-kit/module-manifest'
+import { createModuleRegistryProvider } from '@application-kit/module-manifest/nest'
+
+@Module({
+  imports: collectClientWebModules(MODULE_MANIFESTS),
+  providers: [createModuleRegistryProvider(MODULE_MANIFESTS, () => new ClientVueModule())],
+})
+export class ClientModule {}
+```
+
+Провайдер `ModuleRegistry` собирает оболочку первой, затем клиентские модули по токенам манифестов в порядке
+регистрации — тот же порядок, что у script-тегов в браузере. Тип навигации реестра (`TNavigation`) выводится из
+клиентского модуля оболочки (`ClientModuleInterface<RouteRecordRaw[], TNavigation>` из `vue-modular-application`).
+
+## Клиентские entry
+
+```ts
+import { vitePluginModuleEntries } from '@application-kit/module-manifest/vite-plugin'
+
+export default defineConfig({
+  plugins: [vitePluginModuleEntries({ modulesDirectory: path.resolve(root, 'src/modules'), root })],
+})
+```
+
+Плагин заменяет в `index.html` плейсхолдер `<!-- module-entries -->` (`MODULE_ENTRIES_PLACEHOLDER`) script-тегами
+файлов `<modulesDirectory>/<name>/user-interface/client/app/entry.<name>.ts` в порядке имён модулей. Entry с чужим
+именем не принимается — опечатка не оставит модуль без клиента молча. Нет плейсхолдера — сборка падает с
+`MissingModuleEntriesPlaceholderError`. Список берётся из раскладки, а не из манифестов: манифест тянет Nest-модуль и в
+процесс Vite не импортируется.
+
+Без Vite — те же шаги функциями: `findModuleEntries(modulesDirectory)` отдаёт пути entry в порядке имён модулей,
+`injectModuleEntries(html, { modulesDirectory, root })` — разметку с тегами на месте плейсхолдера.

package/dist/cjs/ability-grants-manifest.interface.d.ts

@@ -0,0 +1,4 @@
+export interface AbilityGrantsManifestInterface<TGrants> {
+    readonly grants: TGrants;
+    readonly name: string;
+}

package/dist/cjs/ability-grants-manifest.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/collect-modules.d.ts

@@ -0,0 +1,6 @@
+import type { Type } from '@nestjs/common';
+import type { ModuleManifestInterface } from './module-manifest.interface.js';
+import type { ProcessModuleManifestInterface } from './process-module-manifest.interface.js';
+export declare const collectProcessModules: (manifests: readonly ProcessModuleManifestInterface[]) => Type[];
+export declare const collectWebModules: (manifests: readonly ModuleManifestInterface[]) => Type[];
+export declare const collectClientWebModules: (manifests: readonly ModuleManifestInterface[]) => Type[];

package/dist/cjs/collect-modules.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectClientWebModules = exports.collectWebModules = exports.collectProcessModules = void 0;
+const duplicate_module_name_error_js_1 = require("./errors/duplicate-module-name.error.js");
+const assertUniqueModuleNames = (manifests) => {
+    const seen = new Set();
+    for (const { name } of manifests) {
+        if (seen.has(name)) {
+            throw new duplicate_module_name_error_js_1.DuplicateModuleNameError(name);
+        }
+        seen.add(name);
+    }
+};
+const collectProcessModules = (manifests) => {
+    assertUniqueModuleNames(manifests);
+    return manifests.map((manifest) => manifest.module);
+};
+exports.collectProcessModules = collectProcessModules;
+const collectWebModules = (manifests) => {
+    assertUniqueModuleNames(manifests);
+    return manifests.map((manifest) => manifest.web);
+};
+exports.collectWebModules = collectWebModules;
+const collectClientWebModules = (manifests) => (0, exports.collectWebModules)(manifests.filter((manifest) => manifest.clientModuleToken !== undefined));
+exports.collectClientWebModules = collectClientWebModules;

package/dist/cjs/consumer-module-manifest.interface.d.ts

@@ -0,0 +1,4 @@
+import type { ProcessModuleManifestInterface } from './process-module-manifest.interface.js';
+export interface ConsumerModuleManifestInterface extends ProcessModuleManifestInterface {
+    readonly queues: readonly string[];
+}

package/dist/cjs/consumer-module-manifest.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/errors/duplicate-module-name.error.d.ts

@@ -0,0 +1,3 @@
+export declare class DuplicateModuleNameError extends Error {
+    constructor(name: string, options?: ErrorOptions);
+}

package/dist/cjs/errors/duplicate-module-name.error.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DuplicateModuleNameError = void 0;
+class DuplicateModuleNameError extends Error {
+    constructor(name, options) {
+        super(`Module manifest "${name}" is registered twice`, options);
+        this.name = 'DuplicateModuleNameError';
+    }
+}
+exports.DuplicateModuleNameError = DuplicateModuleNameError;

package/dist/cjs/errors/index.d.ts

@@ -0,0 +1 @@
+export * from './duplicate-module-name.error.js';

package/dist/cjs/errors/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./duplicate-module-name.error.js"), exports);

package/dist/cjs/index.d.ts

@@ -0,0 +1,6 @@
+export * from './errors/index.js';
+export * from './ability-grants-manifest.interface.js';
+export * from './collect-modules.js';
+export * from './consumer-module-manifest.interface.js';
+export * from './module-manifest.interface.js';
+export * from './process-module-manifest.interface.js';

package/dist/cjs/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./errors/index.js"), exports);
+__exportStar(require("./ability-grants-manifest.interface.js"), exports);
+__exportStar(require("./collect-modules.js"), exports);
+__exportStar(require("./consumer-module-manifest.interface.js"), exports);
+__exportStar(require("./module-manifest.interface.js"), exports);
+__exportStar(require("./process-module-manifest.interface.js"), exports);

package/dist/cjs/module-manifest.interface.d.ts

@@ -0,0 +1,6 @@
+import type { InjectionToken, Type } from '@nestjs/common';
+export interface ModuleManifestInterface {
+    readonly clientModuleToken?: InjectionToken;
+    readonly name: string;
+    readonly web: Type;
+}

package/dist/cjs/module-manifest.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/nest/create-module-registry-provider.d.ts

@@ -0,0 +1,5 @@
+import type { ClientModuleInterface } from '@libs-for-dev/vue-modular-application';
+import type { Provider } from '@nestjs/common';
+import type { RouteRecordRaw } from 'vue-router';
+import type { ModuleManifestInterface } from '../module-manifest.interface.js';
+export declare const createModuleRegistryProvider: <TNavigation>(manifests: readonly ModuleManifestInterface[], createHostModule: () => ClientModuleInterface<RouteRecordRaw[], TNavigation>) => Provider;

package/dist/cjs/nest/create-module-registry-provider.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createModuleRegistryProvider = void 0;
+const vue_modular_application_1 = require("@libs-for-dev/vue-modular-application");
+const collectClientModuleTokens = (manifests) => manifests
+    .flatMap((manifest) => (manifest.clientModuleToken === undefined ? [] : [manifest.clientModuleToken]));
+const createModuleRegistryProvider = (manifests, createHostModule) => ({
+    inject: collectClientModuleTokens(manifests),
+    provide: vue_modular_application_1.ModuleRegistry,
+    useFactory: (...clientModules) => new vue_modular_application_1.ModuleRegistry([createHostModule(), ...clientModules]),
+});
+exports.createModuleRegistryProvider = createModuleRegistryProvider;

package/dist/cjs/nest/index.d.ts

@@ -0,0 +1 @@
+export * from './create-module-registry-provider.js';

package/dist/cjs/nest/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./create-module-registry-provider.js"), exports);

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/process-module-manifest.interface.d.ts

@@ -0,0 +1,5 @@
+import type { Type } from '@nestjs/common';
+export interface ProcessModuleManifestInterface {
+    readonly module: Type;
+    readonly name: string;
+}

package/dist/cjs/process-module-manifest.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/vite-plugin/errors/index.d.ts

@@ -0,0 +1 @@
+export * from './missing-module-entries-placeholder.error.js';

package/dist/cjs/vite-plugin/errors/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./missing-module-entries-placeholder.error.js"), exports);

package/dist/cjs/vite-plugin/errors/missing-module-entries-placeholder.error.d.ts

@@ -0,0 +1,3 @@
+export declare class MissingModuleEntriesPlaceholderError extends Error {
+    constructor(placeholder: string, options?: ErrorOptions);
+}

package/dist/cjs/vite-plugin/errors/missing-module-entries-placeholder.error.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingModuleEntriesPlaceholderError = void 0;
+class MissingModuleEntriesPlaceholderError extends Error {
+    constructor(placeholder, options) {
+        super(`index.html has no "${placeholder}" placeholder for module client entries`, options);
+        this.name = 'MissingModuleEntriesPlaceholderError';
+    }
+}
+exports.MissingModuleEntriesPlaceholderError = MissingModuleEntriesPlaceholderError;

package/dist/cjs/vite-plugin/index.d.ts

@@ -0,0 +1,2 @@
+export * from './errors/index.js';
+export * from './vite-plugin-module-entries.js';

package/dist/cjs/vite-plugin/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./errors/index.js"), exports);
+__exportStar(require("./vite-plugin-module-entries.js"), exports);

package/dist/cjs/vite-plugin/vite-plugin-module-entries.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from 'vite';
+export declare const MODULE_ENTRIES_PLACEHOLDER = "<!-- module-entries -->";
+export interface ModuleEntriesOptionsInterface {
+    modulesDirectory: string;
+    root: string;
+}
+export declare const findModuleEntries: (modulesDirectory: string) => Promise<string[]>;
+export declare const injectModuleEntries: (source: string, { modulesDirectory, root }: ModuleEntriesOptionsInterface) => Promise<string>;
+export declare const vitePluginModuleEntries: (options: ModuleEntriesOptionsInterface) => Plugin;

package/dist/cjs/vite-plugin/vite-plugin-module-entries.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vitePluginModuleEntries = exports.injectModuleEntries = exports.findModuleEntries = exports.MODULE_ENTRIES_PLACEHOLDER = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const missing_module_entries_placeholder_error_js_1 = require("./errors/missing-module-entries-placeholder.error.js");
+exports.MODULE_ENTRIES_PLACEHOLDER = '<!-- module-entries -->';
+const CLIENT_ENTRY_DIRECTORY = node_path_1.default.join('user-interface', 'client', 'app');
+const moduleEntryOf = (modulesDirectory, file) => {
+    const [name = ''] = node_path_1.default.relative(modulesDirectory, file.parentPath).split(node_path_1.default.sep);
+    const entry = node_path_1.default.join(modulesDirectory, name, CLIENT_ENTRY_DIRECTORY, `entry.${name}.ts`);
+    return file.isFile() && node_path_1.default.join(file.parentPath, file.name) === entry ? entry : null;
+};
+const findModuleEntries = async (modulesDirectory) => {
+    const files = await (0, promises_1.readdir)(modulesDirectory, { recursive: true, withFileTypes: true });
+    const entries = files.flatMap((file) => {
+        const entry = moduleEntryOf(modulesDirectory, file);
+        return entry === null ? [] : [entry];
+    });
+    return entries.toSorted((left, right) => left.localeCompare(right));
+};
+exports.findModuleEntries = findModuleEntries;
+const injectModuleEntries = async (source, { modulesDirectory, root }) => {
+    if (!source.includes(exports.MODULE_ENTRIES_PLACEHOLDER)) {
+        throw new missing_module_entries_placeholder_error_js_1.MissingModuleEntriesPlaceholderError(exports.MODULE_ENTRIES_PLACEHOLDER);
+    }
+    const entries = await (0, exports.findModuleEntries)(modulesDirectory);
+    const tags = entries.map((entry) => `<script type="module" src="/${node_path_1.default.relative(root, entry)}"></script>`);
+    return source.replace(exports.MODULE_ENTRIES_PLACEHOLDER, () => tags.join('\n  '));
+};
+exports.injectModuleEntries = injectModuleEntries;
+const vitePluginModuleEntries = (options) => ({
+    name: 'module-entries',
+    transformIndexHtml: {
+        handler: async (source) => (0, exports.injectModuleEntries)(source, options),
+        order: 'pre',
+    },
+});
+exports.vitePluginModuleEntries = vitePluginModuleEntries;

package/dist/esm/ability-grants-manifest.interface.d.ts

@@ -0,0 +1,4 @@
+export interface AbilityGrantsManifestInterface<TGrants> {
+    readonly grants: TGrants;
+    readonly name: string;
+}

package/dist/esm/ability-grants-manifest.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/collect-modules.d.ts

@@ -0,0 +1,6 @@
+import type { Type } from '@nestjs/common';
+import type { ModuleManifestInterface } from './module-manifest.interface.js';
+import type { ProcessModuleManifestInterface } from './process-module-manifest.interface.js';
+export declare const collectProcessModules: (manifests: readonly ProcessModuleManifestInterface[]) => Type[];
+export declare const collectWebModules: (manifests: readonly ModuleManifestInterface[]) => Type[];
+export declare const collectClientWebModules: (manifests: readonly ModuleManifestInterface[]) => Type[];

package/dist/esm/collect-modules.js

@@ -0,0 +1,19 @@
+import { DuplicateModuleNameError } from './errors/duplicate-module-name.error.js';
+const assertUniqueModuleNames = (manifests) => {
+    const seen = new Set();
+    for (const { name } of manifests) {
+        if (seen.has(name)) {
+            throw new DuplicateModuleNameError(name);
+        }
+        seen.add(name);
+    }
+};
+export const collectProcessModules = (manifests) => {
+    assertUniqueModuleNames(manifests);
+    return manifests.map((manifest) => manifest.module);
+};
+export const collectWebModules = (manifests) => {
+    assertUniqueModuleNames(manifests);
+    return manifests.map((manifest) => manifest.web);
+};
+export const collectClientWebModules = (manifests) => collectWebModules(manifests.filter((manifest) => manifest.clientModuleToken !== undefined));

package/dist/esm/consumer-module-manifest.interface.d.ts

@@ -0,0 +1,4 @@
+import type { ProcessModuleManifestInterface } from './process-module-manifest.interface.js';
+export interface ConsumerModuleManifestInterface extends ProcessModuleManifestInterface {
+    readonly queues: readonly string[];
+}

package/dist/esm/consumer-module-manifest.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/errors/duplicate-module-name.error.d.ts

@@ -0,0 +1,3 @@
+export declare class DuplicateModuleNameError extends Error {
+    constructor(name: string, options?: ErrorOptions);
+}

package/dist/esm/errors/duplicate-module-name.error.js

@@ -0,0 +1,6 @@
+export class DuplicateModuleNameError extends Error {
+    constructor(name, options) {
+        super(`Module manifest "${name}" is registered twice`, options);
+        this.name = 'DuplicateModuleNameError';
+    }
+}

package/dist/esm/errors/index.d.ts

@@ -0,0 +1 @@
+export * from './duplicate-module-name.error.js';

package/dist/esm/errors/index.js

@@ -0,0 +1 @@
+export * from './duplicate-module-name.error.js';

package/dist/esm/index.d.ts

@@ -0,0 +1,6 @@
+export * from './errors/index.js';
+export * from './ability-grants-manifest.interface.js';
+export * from './collect-modules.js';
+export * from './consumer-module-manifest.interface.js';
+export * from './module-manifest.interface.js';
+export * from './process-module-manifest.interface.js';

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+export * from './errors/index.js';
+export * from './ability-grants-manifest.interface.js';
+export * from './collect-modules.js';
+export * from './consumer-module-manifest.interface.js';
+export * from './module-manifest.interface.js';
+export * from './process-module-manifest.interface.js';

package/dist/esm/module-manifest.interface.d.ts

@@ -0,0 +1,6 @@
+import type { InjectionToken, Type } from '@nestjs/common';
+export interface ModuleManifestInterface {
+    readonly clientModuleToken?: InjectionToken;
+    readonly name: string;
+    readonly web: Type;
+}

package/dist/esm/module-manifest.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/nest/create-module-registry-provider.d.ts

@@ -0,0 +1,5 @@
+import type { ClientModuleInterface } from '@libs-for-dev/vue-modular-application';
+import type { Provider } from '@nestjs/common';
+import type { RouteRecordRaw } from 'vue-router';
+import type { ModuleManifestInterface } from '../module-manifest.interface.js';
+export declare const createModuleRegistryProvider: <TNavigation>(manifests: readonly ModuleManifestInterface[], createHostModule: () => ClientModuleInterface<RouteRecordRaw[], TNavigation>) => Provider;

package/dist/esm/nest/create-module-registry-provider.js

@@ -0,0 +1,8 @@
+import { ModuleRegistry } from '@libs-for-dev/vue-modular-application';
+const collectClientModuleTokens = (manifests) => manifests
+    .flatMap((manifest) => (manifest.clientModuleToken === undefined ? [] : [manifest.clientModuleToken]));
+export const createModuleRegistryProvider = (manifests, createHostModule) => ({
+    inject: collectClientModuleTokens(manifests),
+    provide: ModuleRegistry,
+    useFactory: (...clientModules) => new ModuleRegistry([createHostModule(), ...clientModules]),
+});

package/dist/esm/nest/index.d.ts

@@ -0,0 +1 @@
+export * from './create-module-registry-provider.js';

package/dist/esm/nest/index.js

@@ -0,0 +1 @@
+export * from './create-module-registry-provider.js';

package/dist/esm/process-module-manifest.interface.d.ts

@@ -0,0 +1,5 @@
+import type { Type } from '@nestjs/common';
+export interface ProcessModuleManifestInterface {
+    readonly module: Type;
+    readonly name: string;
+}

package/dist/esm/process-module-manifest.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/vite-plugin/errors/index.d.ts

@@ -0,0 +1 @@
+export * from './missing-module-entries-placeholder.error.js';

package/dist/esm/vite-plugin/errors/index.js

@@ -0,0 +1 @@
+export * from './missing-module-entries-placeholder.error.js';

package/dist/esm/vite-plugin/errors/missing-module-entries-placeholder.error.d.ts

@@ -0,0 +1,3 @@
+export declare class MissingModuleEntriesPlaceholderError extends Error {
+    constructor(placeholder: string, options?: ErrorOptions);
+}

package/dist/esm/vite-plugin/errors/missing-module-entries-placeholder.error.js

@@ -0,0 +1,6 @@
+export class MissingModuleEntriesPlaceholderError extends Error {
+    constructor(placeholder, options) {
+        super(`index.html has no "${placeholder}" placeholder for module client entries`, options);
+        this.name = 'MissingModuleEntriesPlaceholderError';
+    }
+}

package/dist/esm/vite-plugin/index.d.ts

@@ -0,0 +1,2 @@
+export * from './errors/index.js';
+export * from './vite-plugin-module-entries.js';

package/dist/esm/vite-plugin/index.js

@@ -0,0 +1,2 @@
+export * from './errors/index.js';
+export * from './vite-plugin-module-entries.js';

package/dist/esm/vite-plugin/vite-plugin-module-entries.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from 'vite';
+export declare const MODULE_ENTRIES_PLACEHOLDER = "<!-- module-entries -->";
+export interface ModuleEntriesOptionsInterface {
+    modulesDirectory: string;
+    root: string;
+}
+export declare const findModuleEntries: (modulesDirectory: string) => Promise<string[]>;
+export declare const injectModuleEntries: (source: string, { modulesDirectory, root }: ModuleEntriesOptionsInterface) => Promise<string>;
+export declare const vitePluginModuleEntries: (options: ModuleEntriesOptionsInterface) => Plugin;

package/dist/esm/vite-plugin/vite-plugin-module-entries.js

@@ -0,0 +1,33 @@
+import { readdir } from 'node:fs/promises';
+import path from 'node:path';
+import { MissingModuleEntriesPlaceholderError } from './errors/missing-module-entries-placeholder.error.js';
+export const MODULE_ENTRIES_PLACEHOLDER = '<!-- module-entries -->';
+const CLIENT_ENTRY_DIRECTORY = path.join('user-interface', 'client', 'app');
+const moduleEntryOf = (modulesDirectory, file) => {
+    const [name = ''] = path.relative(modulesDirectory, file.parentPath).split(path.sep);
+    const entry = path.join(modulesDirectory, name, CLIENT_ENTRY_DIRECTORY, `entry.${name}.ts`);
+    return file.isFile() && path.join(file.parentPath, file.name) === entry ? entry : null;
+};
+export const findModuleEntries = async (modulesDirectory) => {
+    const files = await readdir(modulesDirectory, { recursive: true, withFileTypes: true });
+    const entries = files.flatMap((file) => {
+        const entry = moduleEntryOf(modulesDirectory, file);
+        return entry === null ? [] : [entry];
+    });
+    return entries.toSorted((left, right) => left.localeCompare(right));
+};
+export const injectModuleEntries = async (source, { modulesDirectory, root }) => {
+    if (!source.includes(MODULE_ENTRIES_PLACEHOLDER)) {
+        throw new MissingModuleEntriesPlaceholderError(MODULE_ENTRIES_PLACEHOLDER);
+    }
+    const entries = await findModuleEntries(modulesDirectory);
+    const tags = entries.map((entry) => `<script type="module" src="/${path.relative(root, entry)}"></script>`);
+    return source.replace(MODULE_ENTRIES_PLACEHOLDER, () => tags.join('\n  '));
+};
+export const vitePluginModuleEntries = (options) => ({
+    name: 'module-entries',
+    transformIndexHtml: {
+        handler: async (source) => injectModuleEntries(source, options),
+        order: 'pre',
+    },
+});

package/package.json

@@ -1,6 +1,108 @@
 {
   "name": "@application-kit/module-manifest",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Манифест модуля продукта: контракты web-, CLI-, консьюмер- и грант-манифестов, сборщики модулей процесса с проверкой дублей, SSR-реестр клиентских модулей для NestJS и Vite-плагин клиентских entry по раскладке",
+  "keywords": [
+    "manifest",
+    "modules",
+    "nestjs",
+    "vite-plugin"
+  ],
+  "homepage": "https://gitlab.com/application-kit/application-kit/-/tree/main/packages/module-manifest",
+  "bugs": "https://gitlab.com/application-kit/application-kit/-/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/application-kit/application-kit.git",
+    "directory": "packages/module-manifest"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "application-kit"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./nest": {
+      "import": {
+        "types": "./dist/esm/nest/index.d.ts",
+        "default": "./dist/esm/nest/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/nest/index.d.ts",
+        "default": "./dist/cjs/nest/index.js"
+      }
+    },
+    "./package.json": "./package.json",
+    "./vite-plugin": {
+      "import": {
+        "types": "./dist/esm/vite-plugin/index.d.ts",
+        "default": "./dist/esm/vite-plugin/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/vite-plugin/index.d.ts",
+        "default": "./dist/cjs/vite-plugin/index.js"
+      }
+    }
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf ./dist && node ../../scripts/barrels.mjs create ./src --entry-only=nest,vite-plugin && tsc --project tsconfig.build.json && tsc --project tsconfig.build.cjs.json && node ../../scripts/barrels.mjs clean ./src && node ../../scripts/mark-cjs.mjs ./dist/cjs",
+    "lint:tsc": "tsc --noEmit --pretty --project .",
+    "test:mutation": "stryker run",
+    "test:unit": "vitest run"
+  },
+  "devDependencies": {
+    "@libs-for-dev/vue-modular-application": "1.0.0",
+    "@nestjs/common": "^12.0.0",
+    "@nestjs/core": "^12.0.0",
+    "@nestjs/testing": "^12.0.0",
+    "@stryker-mutator/core": "^10.0.0",
+    "@stryker-mutator/vitest-runner": "^10.0.0",
+    "@types/node": "^26.2.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "typescript": "^6.0.3",
+    "vite": "^8.2.1",
+    "vitest": "^5.0.0",
+    "vue": "^3.5.41",
+    "vue-router": "^5.2.0"
+  },
+  "peerDependencies": {
+    "@libs-for-dev/vue-modular-application": "^1.0.0",
+    "@nestjs/common": "^11.0.0 || ^12.0.0",
+    "vite": "^8.0.0",
+    "vue-router": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@libs-for-dev/vue-modular-application": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    },
+    "vue-router": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }