Add patron blocking rules help modal with live template variables (PP-3866)

Adds a "?" help button next to "Add Rule" in the patron blocking rules
editor that opens a modal presenting: (1) a live table of available
template variable names and sample values, fetched automatically on
mount via the validation endpoint using a trivial rule; (2) rendered
HTML documentation of the available functions, sourced from
circulation/docs/FUNCTIONS.md and pre-processed at build time by a new
sync script (npm run sync-patron-blocking-docs); and (3) a link to the
simpleeval syntax reference.
Also adds the onServerValidationStateChange prop to
PatronBlockingRulesEditorProps (already consumed by
PatronAuthServiceEditForm), and updates tests, styles, webpack config,
Jest config, and the README accordingly.

Author: dbernstein

README.md

@@ -138,6 +138,48 @@ There are end-to-end tests that run on Nightwatch. This selenium-based test runn
 
 To set up credentials and run the tests, check out the [README](/tests/README.md) in `/tests/.
 
+## Patron Blocking Rules — Keeping Documentation in Sync
+
+The help modal displayed alongside the patron blocking rules editor renders
+documentation sourced from
+[`circulation/docs/FUNCTIONS.md`](../circulation/docs/FUNCTIONS.md).
+Because `circulation-admin` is a separate package, this content is
+pre-processed and committed as a generated TypeScript file:
+
+```
+src/content/patronBlockingFunctionsHtml.ts   ← auto-generated, do not edit by hand
+```
+
+### When to run the sync script
+
+Run the sync script any time `circulation/docs/FUNCTIONS.md` is updated:
+
+```bash
+npm run sync-patron-blocking-docs
+```
+
+The script (`scripts/syncPatronBlockingDocs.js`) reads the markdown from the
+sibling `circulation` repository, converts it to HTML, and overwrites
+`src/content/patronBlockingFunctionsHtml.ts`. Commit the regenerated file
+alongside any other changes.
+
+### Expected repository layout
+
+The script assumes both repositories are checked out as siblings:
+
+```
+/path/to/
+├── circulation/          ← Palace Project Circulation Manager
+│   └── docs/
+│       └── FUNCTIONS.md  ← source of truth for allowed functions
+└── circulation-admin/    ← this repository
+    └── src/content/
+        └── patronBlockingFunctionsHtml.ts  ← generated output
+```
+
+If your layout differs, update the source path at the top of
+`scripts/syncPatronBlockingDocs.js`.
+
 ## Debugging
 
 The [Redux DevTools browser extension](https://github.com/reduxjs/redux-devtools/tree/main/extension) may be used to easily inspect app states and state transitions.

jest.config.js

@@ -4,6 +4,7 @@ module.exports = {
     "\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$":
       "<rootDir>/tests/__mocks__/fileMock.js",
     "\\.(css|less)$": "<rootDir>/tests/__mocks__/styleMock.js",
+    "\\.md$": "<rootDir>/tests/__mocks__/fileMock.js",
   },
   preset: "ts-jest",
   testEnvironment: "jest-fixed-jsdom",

package-lock.json

@@ -32,7 +32,8 @@
     "dev-server": "dotenv -c -- webpack serve --progress --hot --config webpack.dev-server.config",
     "dev-test-axe": "TEST_AXE=true npm run dev",
     "prod": "webpack --progress --config webpack.prod.config",
-    "build-docs": "typedoc --tsconfig tsconfig.json src"
+    "build-docs": "typedoc --tsconfig tsconfig.json src",
+    "sync-patron-blocking-docs": "node scripts/syncPatronBlockingDocs.js"
   },
   "dependencies": {
     "@nypl/dgx-svg-icons": "0.3.4",