@mfeflow/testing 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sanjeev Sharma
+
+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,41 @@
-# Temporary Holding Version
+# @mfeflow/testing
 
-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.
+Test helpers for mfeflow micro-frontends. `renderWithPlatform` renders a component inside the same providers the shell uses; `resetPlatform` clears storage, the i18n instance, the theme on `<html>` and remote error reports between tests.
+
+## Install
+
+```sh
+pnpm add -D @mfeflow/testing @testing-library/react @testing-library/dom react react-dom
+```
+
+`@testing-library/react` (^16), `react` and `react-dom` (^19) are peer dependencies; Testing Library also needs `@testing-library/dom`. `renderWithPlatform` imports only `@mfeflow/runtime/providers`, so Module Federation is not loaded in your tests. Run tests in a DOM environment such as jsdom.
+
+## Usage
+
+```tsx
+import { afterEach, expect, test } from 'vitest';
+import { withProps } from '@mfeflow/runtime';
+import { ThemeProvider } from '@mfeflow/theme/react';
+import { renderWithPlatform, resetPlatform } from '@mfeflow/testing';
+import { themes } from './themes';
+
+afterEach(resetPlatform);
+
+test('renders with the shell providers', () => {
+  const { getByText } = renderWithPlatform(<Cart />, {
+    providers: [withProps(ThemeProvider, { themes, defaultTheme: 'light' })],
+  });
+  expect(getByText('Cart')).toBeTruthy();
+});
+```
+
+## Module Federation sharing
+
+Bucket: **config**. Used at build, lint or test time only, never shipped to the browser, so it is not shared through Module Federation.
+
+## Links
+
+- [mfeflow repository](https://github.com/mfeflow/mfeflow) and its README
+- [Documentation](https://mfeflow.github.io/mfeflow/)
+
+MIT licensed.

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { type RenderOptions, type RenderResult } from '@testing-library/react';
+import type { ReactElement } from 'react';
+import { type ProviderComponent } from '@mfeflow/runtime/providers';
+export interface PlatformRenderOptions extends Omit<RenderOptions, 'wrapper'> {
+    /** The same list the shell passes to `composeProviders`, e.g. `[withProps(ThemeProvider, {...})]`. */
+    providers?: readonly ProviderComponent[];
+}
+/** `render` from Testing Library, wrapped in the shell's providers. */
+export declare function renderWithPlatform(ui: ReactElement, options?: PlatformRenderOptions): RenderResult;
+/**
+ * Clears page-wide platform state between tests: web storage, the i18n
+ * instance, the theme on `<html>`, and remote error reports.
+ */
+export declare function resetPlatform(): void;

package/dist/index.js

@@ -0,0 +1,23 @@
+import { render } from "@testing-library/react";
+import { composeProviders } from "@mfeflow/runtime/providers";
+function renderWithPlatform(ui, options = {}) {
+    const { providers = [], ...rest } = options;
+    return render(ui, {
+        ...rest,
+        wrapper: composeProviders(providers)
+    });
+}
+function resetPlatform() {
+    if ("u" > typeof localStorage) localStorage.clear();
+    if ("u" > typeof sessionStorage) sessionStorage.clear();
+    Reflect.deleteProperty(globalThis, 'mfeflowI18n');
+    Reflect.deleteProperty(globalThis, 'mfeflowReports');
+    if ("u" > typeof document) {
+        const root = document.documentElement;
+        root.removeAttribute('style');
+        root.removeAttribute('data-theme');
+        root.removeAttribute('lang');
+        root.removeAttribute('dir');
+    }
+}
+export { renderWithPlatform, resetPlatform };

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@mfeflow/testing",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Test helpers for mfeflow micro-frontends: renderWithPlatform wraps components in the same providers the shell uses; resetPlatform clears storage, i18n, theme and reports between tests.",
+  "keywords": [
+    "micro-frontend",
+    "mfe",
+    "testing",
+    "testing-library",
+    "react",
+    "vitest",
+    "module-federation",
+    "rsbuild"
+  ],
+  "homepage": "https://mfeflow.github.io/mfeflow/",
+  "bugs": "https://github.com/mfeflow/mfeflow/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mfeflow/mfeflow.git",
+    "directory": "packages/testing"
+  },
+  "license": "MIT",
+  "author": "Sanjeev Sharma <speedsharma.ai@gmail.com>",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.12"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@mfeflow/runtime": "0.1.0"
+  },
+  "peerDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@module-federation/enhanced": "2.9.2",
+    "@rsbuild/plugin-react": "2.1.1",
+    "@rslib/core": "1.0.5",
+    "@testing-library/dom": "10.4.2",
+    "@testing-library/react": "16.3.3",
+    "@types/node": "26.6.6",
+    "@types/react": "19.3.0",
+    "@types/react-dom": "19.3.0",
+    "jsdom": "30.1.3",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "typescript": "7.0.2"
+  },
+  "mfeflow": {
+    "bucket": "config"
+  },
+  "scripts": {
+    "build": "rslib build",
+    "typecheck": "tsc --noEmit"
+  }
 }