@m4l/testing 1.0.1 → 1.0.2-beta-improvement-804-reports-mfs-enhancements.0

package/README.md

@@ -32,7 +32,8 @@ then TypeScript emits declarations under `types/`; published export maps contain
 condition. React, Vitest, Playwright and RTL remain consumer-owned peers, marked
 optional so a mocks-only consumer does not need to install unrelated runners.
 Consumers must install the peers required by their chosen subpath. The library declares compatible peer ranges from the tested versions; the
-workspace and versioned MF consumers keep exact install pins. The dist-manifest
+workspace and external MF repositories keep exact install pins, with common
+consumer versions owned by each repository's root manifest and lockfile. The dist-manifest
 helper opts into preserving these source peer contracts rather than replacing
 them with exact workspace versions, so unrelated consumers can resolve their
 own compatible types and runners.
@@ -56,9 +57,12 @@ existing release machinery. The target version `1.0.1` requires an explicit
 bootstrap/version review against current registry state and reachable tags;
 registration alone does not force Nx Release to choose that version. No package
 or dist-tag is published by the local POC. Verify the packed artifact outside the
-workspace before beta/stable release. Non-Golden MFs adopt a stable exact NPM
-version; if they need a testing API change, develop against source as Golden in
-one MR and return to versioned consumption in another MR after stable publication.
+workspace before beta/stable release. Platform consumers validate testing API
+changes against workspace source. External MF repositories adopt published
+stable versions through their common root manifest and lockfile; they do not
+need to move projects between repositories to change a helper. Candidate-package
+experiments stay local and do not introduce beta dependencies into integrated MF
+manifests or CI.
 
 ### One-time 1.0.1 bootstrap without Nx Release
 
@@ -155,6 +159,14 @@ guide and update it alongside the helper docs.
   Builds a typed preview-scenario `dynamicParams` payload for authenticated MF launches. It documents the shared `dummyPresetId` and `testCondition` keys while still allowing MF-specific extension keys when a scenario needs more than the common baseline.
 - `installHostAuthenticatedMfPreviewBootstrap(...)`
   Composes the authenticated host-shell bootstrap baseline with one deterministic MF sidebar entry. The high-level installer accepts the MF identity fields directly (`moduleId`, `title`, `debugPort`, optional `iconUrl`, and optional `dynamicParams`) instead of exposing the lower-level menu-fixture shape. The shared baseline now also stubs `GET /users/me/preferences`, so authenticated host-preview suites inherit the same preferences bootstrap seam that the host runtime now requires without re-registering that endpoint in every MF-owned E2E project.
+- `installHostAuthenticatedBootstrapRoutes({ page: browserContext, moduleId: 'platform' })`
+  Installs the existing auth, locale, branding, preferences and shell routes for every
+  page in a browser context. Use this before a real user action opens a host popup;
+  opener-only `page.route(...)` handlers do not intercept that popup's requests.
+  Route-only bootstrap options accept `Page | BrowserContext`; navigation helpers
+  still require `Page`. Keep feature endpoints context-scoped as well, and narrow
+  API patterns to `/api/v1/...` so they cannot fulfill `/reports/:uuid` HTML navigation
+  with JSON. The Export DataGrid and Tags visible-column E2E flows exercise this seam.
 - `installHostAuthenticatedMfModuleDictionaryRoute(...)`
   Installs the common authenticated MF module-dictionary route used after host-side launch so each MF pilot does not need its own one-line `isAuth: true` wrapper around the lower-level module-dictionary installer.
 - `openHostAuthenticatedMfPreviewModule(...)`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m4l/testing",
-  "version": "1.0.1",
+  "version": "1.0.2-beta-improvement-804-reports-mfs-enhancements.0",
   "description": "Shared M4L testing contracts for React, Vitest and Playwright",
   "license": "UNLICENSED",
   "engines": {

package/types/packages/testing/mocks/src/constants.d.ts

@@ -1,5 +1,5 @@
 /**
- * Stable module id used by shared testing fixtures that need a deterministic
+ * Stable module id used by shared testing fixtures that need a deterministic.
  * module identity without coupling the fixture back to one package.
  */
 export declare const testModuleId = "testing";

package/types/packages/testing/playwright/src/installers/installHostUiConfigAssetRoutes.d.ts

@@ -4,6 +4,6 @@ import type { HostUIConfigFixture } from '../types';
  * no-auth shell can render deterministically without hitting remote storage.
  */
 export declare function installHostUiConfigAssetRoutes(options: {
-    page: import('@playwright/test').Page;
+    page: import('@playwright/test').Page | import('@playwright/test').BrowserContext;
     uiConfig?: Partial<HostUIConfigFixture>;
 }): Promise<void>;

package/types/packages/testing/playwright/src/types.d.ts

@@ -1,4 +1,4 @@
-import type { Page } from '@playwright/test';
+import type { BrowserContext, Page } from '@playwright/test';
 /**
  * Shared UI-config payload shape used by host-style Playwright mocks.
  * Keep this contract local to the testing library so app E2E projects can
@@ -206,7 +206,7 @@ export type HostMutationFixture = HostMutationSuccessFixture | HostMutationError
  * Installs the shared UI-config bootstrap route.
  */
 export interface InstallHostUIConfigRouteOptions {
-    page: Page;
+    page: Page | BrowserContext;
     uiConfig?: Partial<HostUIConfigFixture>;
     status?: number;
     delayMs?: number;
@@ -230,7 +230,7 @@ export interface InstallHostGuestSessionRouteOptions {
  * Installs the shared authenticated session bootstrap route.
  */
 export interface InstallHostAuthenticatedSessionRouteOptions {
-    page: Page;
+    page: Page | BrowserContext;
     session?: Partial<HostAuthenticatedSessionUserFixture>;
     status?: number;
     delayMs?: number;
@@ -239,14 +239,14 @@ export interface InstallHostAuthenticatedSessionRouteOptions {
  * Installs the shared locale bootstrap route.
  */
 export interface InstallHostLocaleRouteOptions {
-    page: Page;
+    page: Page | BrowserContext;
     locale?: Partial<HostLocaleFixture>;
 }
 /**
  * Installs the shared authenticated user-preferences bootstrap route.
  */
 export interface InstallHostUserPreferencesRouteOptions {
-    page: Page;
+    page: Page | BrowserContext;
     userPreferences?: Partial<HostUserPreferencesFixture>;
     status?: number;
     delayMs?: number;
@@ -255,7 +255,7 @@ export interface InstallHostUserPreferencesRouteOptions {
  * Installs the shared no-auth dictionary bootstrap route.
  */
 export interface InstallHostModuleDictionaryRouteOptions {
-    page: Page;
+    page: Page | BrowserContext;
     moduleId: string;
     moduleDictionary?: HostModuleDictionaryFixture;
     isAuth?: boolean;
@@ -272,21 +272,21 @@ export interface InstallHostAuthenticatedMfModuleDictionaryRouteOptions extends
  * Installs the shared authenticated areas route.
  */
 export interface InstallHostAreasRouteOptions {
-    page: Page;
+    page: Page | BrowserContext;
     areas?: HostAreaFixture[];
 }
 /**
  * Installs the shared cookies route used by the platform shell.
  */
 export interface InstallHostCookiesRouteOptions {
-    page: Page;
+    page: Page | BrowserContext;
     cookies?: HostCookieFixture[];
 }
 /**
  * Installs the shared menus route used by the platform shell.
  */
 export interface InstallHostMenusRouteOptions {
-    page: Page;
+    page: Page | BrowserContext;
     menuData?: HostMenuItemFixture[];
     /**
      * Rows served to the **account popover** (`menus?position=1`), the door the host
@@ -321,7 +321,7 @@ export interface InstallHostGuestBootstrapRoutesOptions {
  * Installs a complete authenticated bootstrap baseline for host-style apps.
  */
 export interface InstallHostAuthenticatedBootstrapRoutesOptions {
-    page: Page;
+    page: Page | BrowserContext;
     moduleId: string;
     uiConfig?: Partial<HostUIConfigFixture>;
     uiConfigRouteOptions?: HostUiConfigRouteControlOptions;