Add node-test-example; run examples via a CI matrix

.github/workflows/test.yml

@@ -37,9 +37,12 @@ jobs:
 
   example:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        example: [reagent-karma-example, node-test-example]
     defaults:
       run:
-        working-directory: examples/reagent-karma-example
+        working-directory: examples/${{ matrix.example }}
     steps:
       - uses: actions/checkout@v4
 
@@ -52,10 +55,7 @@ jobs:
         with:
           node-version: 22
           cache: npm
-          cache-dependency-path: examples/reagent-karma-example/package-lock.json
+          cache-dependency-path: examples/${{ matrix.example }}/package-lock.json
 
       - run: npm ci
-      - run: npm run fmt:check
-      - run: npm run lint
-      - run: npx shadow-cljs compile app
-      - run: npm test
+      - run: npm run ci

examples/node-test-example/.clj-kondo/config.edn

@@ -0,0 +1,4 @@
+;; `await` is the native ClojureScript async operator (cljs >= 1.12.145).
+;; The clj-kondo release on npm does not recognize it yet, so silence the
+;; unresolved-symbol warning for it here.
+{:linters {:unresolved-symbol {:exclude [await]}}}

examples/node-test-example/.gitignore

@@ -0,0 +1,7 @@
+node_modules
+/out
+/target
+/.shadow-cljs
+/.cpcache
+/.clj-kondo/.cache
+/.clj-kondo/imports

examples/node-test-example/.prettierignore

@@ -0,0 +1,5 @@
+node_modules
+out
+target
+.shadow-cljs
+.cpcache

examples/node-test-example/.prettierrc.json

@@ -0,0 +1,3 @@
+{
+  "plugins": ["prettier-plugin-cljfmt"]
+}

examples/node-test-example/README.md

@@ -0,0 +1,31 @@
+# node-test-example
+
+A minimal example of testing ClojureScript components with
+[`react-testing-library-cljs`](https://github.com/olecve/react-testing-library-cljs)
+using shadow-cljs's `:node-test` target and [jsdom](https://github.com/jsdom/jsdom) —
+no browser required. This is the simplest setup and runs end to end in CI.
+
+## What it demonstrates
+
+- **`app.reagent-test`** — testing Reagent components: `render!`, `fire-event`
+  (wrapped in `act`), `screen` queries, scoped queries with `within`, and mock
+  handlers via `mocks/create`.
+- **`app.plain-react-test`** — testing plain React (no Reagent) with raw
+  `react/createElement`, `user-event`, and async `find-by-*` queries written as
+  native `^:async` / `await` tests.
+
+## Setup essentials
+
+- `shadow-cljs.edn` declares `reagent` and the library as `:dependencies` and a
+  `:node-test` build with an `app.test-setup` preload.
+- `src/app/test_setup.cljs` registers jsdom (`global-jsdom/register`) and sets
+  `IS_REACT_ACT_ENVIRONMENT`, giving the tests a DOM and reliable React updates.
+
+## Running
+
+```bash
+npm install
+npm test        # compile the :test build and run it on Node
+npm run lint    # clj-kondo
+npm run fmt     # prettier + cljfmt
+```