@blotch/angular-lynx-testing-library 22.2.2 → 22.2.3

package/README.md

@@ -20,6 +20,7 @@ The setup:
 - Installs `LynxTestingEnv` on the jsdom window
 - Switches to the Lynx main thread (where PAPI functions live)
 - Polyfills PAPI functions the testing environment doesn't implement (`__GetParent`, `__QuerySelector`, etc.)
+- Makes `lynx.reportError` return for a warning, as Lynx does, instead of throwing it, so an `@boundary` shows its fallback with the default error handler
 - Installs `@testing-library/jest-dom` matchers
 
 `ng test` compiles the tests ahead of time, like the app, and checks templates strictly, as the Angular Language Service does: a component that uses Lynx elements imports `LYNX_ELEMENTS` from `@blotch/angular-lynx`. The examples below do.
@@ -201,7 +202,7 @@ it('uses the injected value', async () => {
 Define the signal outside the component so both the component and the test can access it:
 
 ```ts
-import { Component, signal, ChangeDetectionStrategy } from '@angular/core';
+import { Component, signal } from '@angular/core';
 import { LYNX_ELEMENTS } from '@blotch/angular-lynx';
 import { render, waitForUpdate } from '@blotch/angular-lynx-testing-library';
 
@@ -211,7 +212,6 @@ const count = signal(0);
   selector: 'test-counter',
   imports: [LYNX_ELEMENTS],
   template: `<text>{{ count() }}</text>`,
-  changeDetection: ChangeDetectionStrategy.OnPush,
 })
 class CounterComponent {
   count = count;
@@ -233,7 +233,7 @@ it('updates when the signal changes', async () => {
 AngularLynx event bindings use Lynx prefixes: `(bindtap)`, `(catchtap)`, `(bindinput)`, etc.
 
 ```ts
-import { Component, signal, ChangeDetectionStrategy } from '@angular/core';
+import { Component, signal } from '@angular/core';
 import { LYNX_ELEMENTS } from '@blotch/angular-lynx';
 import {
   render,
@@ -249,7 +249,6 @@ import {
       <text>{{ count() }}</text>
     </view>
   `,
-  changeDetection: ChangeDetectionStrategy.OnPush,
 })
 class ButtonComponent {
   count = signal(0);
@@ -280,7 +279,6 @@ it('shows content conditionally', async () => {
     template: `@if (visible()) {
       <text>Hello</text>
     }`,
-    changeDetection: ChangeDetectionStrategy.OnPush,
   })
   class IfComponent {
     visible = visible;
@@ -307,7 +305,6 @@ it('renders a dynamic list', async () => {
     template: `@for (item of items(); track item) {
       <text>{{ item }}</text>
     }`,
-    changeDetection: ChangeDetectionStrategy.OnPush,
   })
   class ListComponent {
     items = items;

package/dist/setup.js

@@ -40,6 +40,36 @@ globalThis.fetch = (url, ...args) => {
 if (typeof Element.prototype.animate !== 'function') {
     Element.prototype.animate = () => ({ cancel: () => { }, finished: Promise.resolve() });
 }
+// ─── lynx.reportError warnings ───────────────────────────────────────────────
+/**
+ * Makes `lynx.reportError` return for a warning, as Lynx does, instead of
+ * throwing it.
+ *
+ * The testing environment's `lynx.reportError` throws whatever it's given, so
+ * a reported error fails the test the way it would stop the app on a device.
+ * On a device, though, a `warning`-level report doesn't interrupt anything,
+ * and that's the level `LynxErrorHandler.onViewError()` reports an error that
+ * an `@boundary` caught at. Angular calls onViewError() before it swaps in the
+ * `@error` block, so the throw stopped the swap, and a test using the default
+ * error handler saw neither the content nor its fallback. Other reports still
+ * throw.
+ *
+ * The environment gives each thread a new `lynx` whenever it injects its
+ * globals: once when it's created, and again on every reset(), which runs
+ * after each test (see index.ts). So this runs from its inject hooks, which
+ * must be set before the environment is created below.
+ */
+const returnOnWarnings = (threadGlobals) => {
+    const { lynx } = threadGlobals;
+    const reportError = lynx.reportError;
+    lynx.reportError = (error, options) => {
+        if (options?.level === 'warning')
+            return;
+        reportError(error, options);
+    };
+};
+globalThis.onInjectMainThreadGlobals = returnOnWarnings;
+globalThis.onInjectBackgroundThreadGlobals = returnOnWarnings;
 // ─── Install LynxTestingEnv ──────────────────────────────────────────────────
 /**
  * Turns the globals the testing environment is about to write into plain data

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blotch/angular-lynx-testing-library",
-  "version": "22.2.2",
+  "version": "22.2.3",
   "description": "Testing utilities for AngularLynx apps",
   "homepage": "https://github.com/Blotch-Smart-Frames/AngularLynx#readme",
   "bugs": {