Merge branch 'series/4.0'

Author: japgolly

.github/workflows/ci.yml

@@ -3,7 +3,10 @@ name: CI
 on:
   pull_request:
   push:
+    branches:
+      - '**'
     paths:
+      - '.github/workflows/ci.yml'
       - 'bin/**'
       - 'downstream-tests/**'
       - 'library/**'

.gitignore

@@ -17,4 +17,5 @@
 metals.sbt
 node_modules/
 target
-.direnv/
+.direnv/
+.DS_Store

README.md

@@ -22,7 +22,6 @@ Includes a router, testing utils, performance utils, more.
   - [Hooks](doc/HOOKS.md)
   - [Hooks via builder](doc/HOOKS_BUILDER.md)
   - [Refs](doc/REFS.md)
-  - [IDE support](doc/IDE.md)
   - [The `Callback` class](doc/CALLBACK.md)
   - [React Context](doc/CONTEXT.md)
 - Delving deeper
@@ -72,9 +71,9 @@ Includes a router, testing utils, performance utils, more.
   * [scastie](https://github.com/scalacenter/scastie) - An interactive playground for Scala [https://scastie.scala-lang.org](https://scastie.scala-lang.org)
 
 ##### Requirements:
-* React ≥ 18
+* React ≥ 19
 * Scala ≥ 2.13
-* Scala.JS ≥ 1.10
+* Scala.JS ≥ 1.20
 
 ##### Support:
 If you like what I do

bin/ci

@@ -60,8 +60,6 @@ cmd=(
     -J-Xmx3G
     -J-XX:+UseG1GC
     ++$SCALA_VER
-    'set ThisBuild / parallelExecution := false'
-    'set Global / concurrentRestrictions += Tags.limit(ScalaJSTags.Link, 1)'
     clean
     test                                                # Test development-mode
     'set ThisBuild / scalaJSStage := FullOptStage' test # Test production-mode

bin/update_react_version

@@ -4,11 +4,18 @@ cd "$(dirname "$0")/.." || exit 1
 [ $# -ne 1 ] && echo "Usage: $0 <version>" && exit 1
 ver="$1"
 
-perl -pi -e 's/(?<![a-zA-Z0-9_-])[1-3]\d\.\d+\.\d+(?![a-zA-Z0-9_-])/'"$ver"'/g' \
-      *.md \
-      doc/*.md \
-      library/build.sbt \
-      library/ghpages/html/*.html \
-      library/project/*.* \
-  && git diff -U0
+perl -pi -e 's/\b19\.\d+\.\d+\b/'"$ver"'/' \
+    js-sandbox/index.html \
+    library/ghpages/html/*.html
 
+perl -pi -e 's/("react.*)\b19\.\d+\.\d+\b/${1}'"$ver"'/' \
+    react-umd/package.json
+
+cd react-umd
+echo "Rebuilding React UMD..."
+rm -rf dist package-lock.json
+npm install
+npm run build
+cd ..
+
+git diff -U0

doc/CONFIG.md

@@ -9,7 +9,6 @@
 * Runtime Settings *(development-mode only)*
   * [Usage](#runtime-settings-usage)
   * [`Reusability.disableGloballyInDev()`](#reusabilitydisablegloballyindev)
-  * ~~[`ReusabilityOverlay.overrideGloballyInDev()`](#reusabilityoverlayoverridegloballyindev)~~
   * [Custom `ReusabilityOverride`](#custom-reusabilityoverride)
 
 
@@ -208,17 +207,6 @@ object Main {
 
 This globally disables `Reusability.shouldComponentUpdate` so that it doesn't nothing.
 
-
-# `ReusabilityOverlay.overrideGloballyInDev()`
-
-**[ReusabilityOverlay has been deprecated in v3 with no replacement — use React's Profiler instead]**
-
-*Note: Runtime settings only affect development-mode (`fastOptJS`) and must be applied before any components are created.*
-
-This makes calls to `Reusability.shouldComponentUpdate` also display a little UI overlay for you to inspect/debug
-component updates. You can see a [live example of this in use here](https://japgolly.github.io/scalajs-react/#examples/reusability).
-
-
 # Custom `ReusabilityOverride`
 
 *Note: Runtime settings only affect development-mode (`fastOptJS`) and must be applied before any components are created.*

doc/IDE.md

@@ -84,6 +84,20 @@ def render =
   <.input(^.untypedRef(refOrNull = _))
 ```
 
+Or you can pass in a `Dom => (() => Unit)` which returns a cleanup function.
+
+```scala
+var refOrNull: html.Input = null
+
+def render =
+  <.input(^.untypedRef.withCleanup { n =>
+    refOrNull = n
+    () => {
+      println("Reference is being cleaned up...")
+    }
+  })
+```
+
 The second is to create a `Ref` object and wire it up like a normal vdom attribute:
 
 ```scala