Merge branch 'master' into fix-hcl

Author: gampleman

.nvmrc

@@ -1 +1 @@
-v19.5.0
+v22.20.0

.tool-versions

@@ -1 +1 @@
-nodejs 19.5.0
+nodejs 22.20.0

docs/Docs.elm

@@ -34,7 +34,9 @@ type alias Example =
 byCategory : List Example -> Dict String (List Example)
 byCategory =
     List.foldl (\item -> Dict.update item.tags.category (Maybe.map ((::) item) >> Maybe.withDefault [ item ] >> Just)) Dict.empty
-        >> Dict.map (\_ l -> List.reverse l)
+        -- Sort within each category by name, so the order is deterministic
+        -- regardless of how the build tool enumerates example files.
+        >> Dict.map (\_ l -> List.sortBy .basename l)
 
 
 categories : List ( String, String )

netlify.toml

@@ -0,0 +1,23 @@
+# Netlify build configuration for the examples site.
+#
+# elm-example-publisher 2.x does incremental builds: it keeps a dependency-graph
+# cache (build/.borek-cache.json) and the previously built outputs, and only
+# redoes the work affected by what changed. To get that speedup on Netlify —
+# where each build otherwise starts from a clean checkout — we persist the build
+# directory between builds with netlify-plugin-cache.
+
+[build]
+  command = "npm run build-docs"
+  publish = "build"
+
+[build.environment]
+  # The publisher requires Node 22+ (it also reads .nvmrc).
+  NODE_VERSION = "22.20.0"
+
+# Restore build/ before the build and save it afterwards, so the incremental
+# cache and prior outputs survive across deploys.
+[[plugins]]
+  package = "netlify-plugin-cache"
+
+  [plugins.inputs]
+    paths = ["build"]