@vc-shell/mf-module 2.0.0-alpha.11

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# [2.0.0-alpha.11](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.10...v2.0.0-alpha.11) (2026-03-13)
+
+**Note:** Version bump only for package @vc-shell/mf-module
+
+# [2.0.0-alpha.10](https://github.com/VirtoCommerce/vc-shell/compare/v2.0.0-alpha.9...v2.0.0-alpha.10) (2026-03-13)
+
+
+### Bug Fixes
+
+* **mf-module:** add exports field for proper ESM resolution ([a951353](https://github.com/VirtoCommerce/vc-shell/commit/a951353743aa0d583c7cb206b6a84be3781b8477))
+
+
+### Features
+
+* **mf-module:** create package for remote module build config ([5cde74b](https://github.com/VirtoCommerce/vc-shell/commit/5cde74b8c7e6369da79d98c5d43edbc451681744))

package/dist/dynamic-module-config.d.ts

@@ -0,0 +1,7 @@
+import type { UserConfig } from "vite";
+import type { DynamicModuleOptions } from "./types.js";
+export default function dynamicModuleConfiguration(pkg: {
+    name: string;
+    version: string;
+}, options: DynamicModuleOptions): UserConfig;
+//# sourceMappingURL=dynamic-module-config.d.ts.map

package/dist/dynamic-module-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-module-config.d.ts","sourceRoot":"","sources":["../src/dynamic-module-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAGvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACtC,OAAO,EAAE,oBAAoB,GAC5B,UAAU,CAsBZ"}

package/dist/dynamic-module-config.js

@@ -0,0 +1,27 @@
+import vue from "@vitejs/plugin-vue";
+import { federation } from "@module-federation/vite";
+import { REMOTE_SHARED } from "@vc-shell/mf-config";
+import { stripExternalStyles } from "./strip-external-styles.js";
+export default function dynamicModuleConfiguration(pkg, options) {
+    const entry = options.entry ?? "./src/modules/index.ts";
+    return {
+        plugins: [
+            stripExternalStyles(),
+            vue(),
+            federation({
+                name: pkg.name,
+                filename: "remoteEntry.js",
+                exposes: options.exposes ?? {
+                    "./module": entry,
+                },
+                shared: { ...REMOTE_SHARED },
+                dts: false,
+            }),
+        ],
+        build: {
+            target: "esnext",
+            outDir: "dist",
+        },
+    };
+}
+//# sourceMappingURL=dynamic-module-config.js.map

package/dist/dynamic-module-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-module-config.js","sourceRoot":"","sources":["../src/dynamic-module-config.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,oBAAoB,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAChD,GAAsC,EACtC,OAA6B;IAE7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAAC;IAExD,OAAO;QACL,OAAO,EAAE;YACP,mBAAmB,EAAE;YACrB,GAAG,EAAE;YACL,UAAU,CAAC;gBACT,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,QAAQ,EAAE,gBAAgB;gBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI;oBAC1B,UAAU,EAAE,KAAK;iBAClB;gBACD,MAAM,EAAE,EAAE,GAAG,aAAa,EAAE;gBAC5B,GAAG,EAAE,KAAK;aACX,CAAC;SACH;QACD,KAAK,EAAE;YACL,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,MAAM;SACf;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { type UserConfig } from "vite";
+import type { DynamicModuleOptions } from "./types.js";
+export type { DynamicModuleOptions, CompatibilityOptions } from "./types.js";
+export { stripExternalStyles } from "./strip-external-styles.js";
+/**
+ * Generate a Vite configuration for a dynamic MF module.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { getDynamicModuleConfiguration } from "@vc-shell/mf-module";
+ *
+ * export default getDynamicModuleConfiguration({
+ *   compatibility: { framework: "^2.0.0" },
+ * });
+ * ```
+ */
+export declare function getDynamicModuleConfiguration(options: DynamicModuleOptions): UserConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAKpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAY9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAMvF"}

package/dist/index.js

@@ -0,0 +1,36 @@
+import { mergeConfig } from "vite";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { cwd } from "node:process";
+import dynamicModuleConfiguration from "./dynamic-module-config.js";
+export { stripExternalStyles } from "./strip-external-styles.js";
+const getPackageJson = () => {
+    try {
+        const packageJsonPath = join(cwd(), "package.json");
+        return JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    }
+    catch (error) {
+        console.error("Error reading package.json:", error);
+        return { name: "unknown-module", version: "0.0.0", dependencies: {} };
+    }
+};
+/**
+ * Generate a Vite configuration for a dynamic MF module.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import { getDynamicModuleConfiguration } from "@vc-shell/mf-module";
+ *
+ * export default getDynamicModuleConfiguration({
+ *   compatibility: { framework: "^2.0.0" },
+ * });
+ * ```
+ */
+export function getDynamicModuleConfiguration(options) {
+    const pkg = getPackageJson();
+    console.log(`Building dynamic module: ${pkg.name}@${pkg.version}`);
+    const baseConfig = dynamicModuleConfiguration(pkg, options);
+    return mergeConfig(baseConfig, options);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAmB,MAAM,MAAM,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,0BAA0B,MAAM,yBAAyB,CAAC;AAIjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,cAAc,GAAG,GAAG,EAAE;IAC1B,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACpD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IACxE,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAA6B;IACzE,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,4BAA4B,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAEnE,MAAM,UAAU,GAAG,0BAA0B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/strip-external-styles.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from "vite";
+/**
+ * Strips CSS/style from shared dependencies and files outside the module root.
+ * Remote MF modules should not emit CSS from shared deps (framework, vue, etc.)
+ * because the host app already provides all base styles, component CSS, and fonts.
+ *
+ * Uses SHARED_DEP_NAMES as the single source of truth — the same list that
+ * controls JS sharing also controls CSS exclusion.
+ */
+export declare function stripExternalStyles(): Plugin;
+//# sourceMappingURL=strip-external-styles.d.ts.map

package/dist/strip-external-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-external-styles.d.ts","sourceRoot":"","sources":["../src/strip-external-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CA4C5C"}

package/dist/strip-external-styles.js

@@ -0,0 +1,56 @@
+import { SHARED_DEP_NAMES } from "@vc-shell/mf-config";
+import { cwd } from "node:process";
+import { resolve } from "node:path";
+import { realpathSync } from "node:fs";
+/**
+ * Strips CSS/style from shared dependencies and files outside the module root.
+ * Remote MF modules should not emit CSS from shared deps (framework, vue, etc.)
+ * because the host app already provides all base styles, component CSS, and fonts.
+ *
+ * Uses SHARED_DEP_NAMES as the single source of truth — the same list that
+ * controls JS sharing also controls CSS exclusion.
+ */
+export function stripExternalStyles() {
+    let normalizedRoot;
+    const sharedDepPatterns = SHARED_DEP_NAMES.map(name => `/node_modules/${name}/`);
+    return {
+        name: "strip-external-styles",
+        enforce: "pre",
+        buildStart() {
+            // Resolve symlinks once at build start, not at import time.
+            // This handles yarn link, portal:, and other symlink scenarios.
+            try {
+                normalizedRoot = realpathSync(resolve(cwd()));
+            }
+            catch {
+                normalizedRoot = resolve(cwd());
+            }
+        },
+        transform(code, id) {
+            const isStyleFile = /\.(css|scss|sass|less|styl)$/.test(id) || /type=style/.test(id);
+            if (!isStyleFile)
+                return null;
+            // Normalize the incoming id to handle symlinked deps
+            let normalizedId;
+            try {
+                // Strip query params (e.g. ?type=style) before resolving
+                const idPath = id.split("?")[0];
+                normalizedId = realpathSync(idPath);
+            }
+            catch {
+                normalizedId = id.split("?")[0];
+            }
+            // Rule 1: Strip styles from shared dependencies
+            if (sharedDepPatterns.some(p => normalizedId.includes(p))) {
+                return { code: "", map: null };
+            }
+            // Rule 2: Strip styles from files outside the module root (symlink/portal scenario)
+            if (!normalizedId.startsWith(normalizedRoot)) {
+                return { code: "", map: null };
+            }
+            // Rule 3: Keep everything else (module's own styles)
+            return null;
+        },
+    };
+}
+//# sourceMappingURL=strip-external-styles.js.map

package/dist/strip-external-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-external-styles.js","sourceRoot":"","sources":["../src/strip-external-styles.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,cAAsB,CAAC;IAC3B,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,iBAAiB,IAAI,GAAG,CAAC,CAAC;IAEjF,OAAO;QACL,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,KAAK;QACd,UAAU;YACR,4DAA4D;YAC5D,gEAAgE;YAChE,IAAI,CAAC;gBACH,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,SAAS,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,WAAW,GAAG,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrF,IAAI,CAAC,WAAW;gBAAE,OAAO,IAAI,CAAC;YAE9B,qDAAqD;YACrD,IAAI,YAAoB,CAAC;YACzB,IAAI,CAAC;gBACH,yDAAyD;gBACzD,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChC,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,CAAC;YAED,gDAAgD;YAChD,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1D,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;YACjC,CAAC;YAED,oFAAoF;YACpF,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC7C,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;YACjC,CAAC;YAED,qDAAqD;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+import type { UserConfig } from "vite";
+/**
+ * Compatibility options for dynamic modules
+ */
+export interface CompatibilityOptions {
+    /**
+     * Compatible framework version range
+     * @example "^1.1.0"
+     */
+    framework: string;
+    /**
+     * Compatible modules version ranges
+     * @example { "@vc-shell/module-catalog": "^1.0.0" }
+     */
+    modules?: Record<string, string>;
+}
+/**
+ * Dynamic module configuration options (Module Federation)
+ */
+export interface DynamicModuleOptions extends UserConfig {
+    /**
+     * Entry point for the module
+     * @default "./src/modules/index.ts"
+     */
+    entry?: string;
+    /**
+     * Custom MF exposes map. Overrides default `{ "./module": entry }`.
+     */
+    exposes?: Record<string, string>;
+    /**
+     * Compatibility constraints (metadata only — not used during build).
+     * Used by the runtime registry API for version filtering.
+     */
+    compatibility?: CompatibilityOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;OAGG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@vc-shell/mf-module",
+  "description": "Module Federation build config for VC Shell remote modules",
+  "version": "2.0.0-alpha.11",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b --clean && tsc && tsc-alias",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@module-federation/vite": "^1.12.2",
+    "@vc-shell/mf-config": "2.0.0-alpha.11"
+  },
+  "devDependencies": {
+    "@vc-shell/ts-config": "2.0.0-alpha.11",
+    "@vitejs/plugin-vue": "^5.2.3",
+    "tsc-alias": "^1.8.8",
+    "typescript": "^5.8.3",
+    "vite": "^6.0.0",
+    "vitest": "^3.2.4",
+    "vue": "^3.5.30"
+  },
+  "peerDependencies": {
+    "@vitejs/plugin-vue": "^5.0.0",
+    "vite": "^5.0.0 || ^6.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}