feat: graph statistics panel with density, components, reciprocity, degree histogram

INSTRUCTIONS.md

@@ -139,3 +139,20 @@ HTTPS connection.
 ```bash
 ./build/ratel -tls_crt example.crt -tls_key example.key
 ```
+
+## Serving under a URL prefix
+
+When hosting Ratel behind a reverse proxy under a subpath (e.g. `https://example.com/ratel/`), set
+the `-url-prefix` flag (or the `RATEL_URL_PREFIX` environment variable) so the UI and its static
+assets are served under that prefix:
+
+```bash
+./build/ratel -url-prefix /ratel
+# or
+RATEL_URL_PREFIX=/ratel ./build/ratel
+```
+
+With a prefix set, all routes move under the prefix (`/ratel/`, `/ratel/static/...`), requests to
+the bare prefix (`/ratel`) redirect to `/ratel/`, asset URLs in the served `index.html` are
+rewritten to include the prefix, and any path outside the prefix returns a 404 pointing at the
+prefix. The flag value is normalized to have a leading slash and no trailing slash.

client/config/jest/babelTransform.js

@@ -0,0 +1,28 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Custom babel-jest transformer with an explicit config.
+//
+// The babel config in package.json ("babel" key) is file-relative, so it is
+// never applied to files inside node_modules. ESM-only packages allowed
+// through transformIgnorePatterns (e.g. react-leaflet) therefore reached the
+// test runtime untransformed. This transformer applies the presets to every
+// file Jest transforms, regardless of location.
+const babelJest = require('babel-jest')
+
+module.exports = babelJest.createTransformer({
+  presets: [
+    [require.resolve('@babel/preset-env'), { targets: { node: 'current' } }],
+    require.resolve('@babel/preset-react'),
+  ],
+  plugins: [
+    [
+      require.resolve('@babel/plugin-proposal-class-properties'),
+      { loose: true },
+    ],
+  ],
+  babelrc: false,
+  configFile: false,
+})

client/config/jest/fileTransform.js

@@ -4,7 +4,14 @@
  */
 
 const path = require('path')
-const camelcase = require('camelcase')
+
+// camelcase >= 7 is ESM-only and can no longer be require()d here.
+const pascalCase = (str) =>
+  str
+    .split(/[^a-zA-Z0-9]+/)
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join('')
 
 // This is a custom Jest transformer turning file imports into filenames.
 // http://facebook.github.io/jest/docs/en/webpack.html
@@ -16,9 +23,7 @@ module.exports = {
     if (filename.match(/\.svg$/)) {
       // Based on how SVGR generates a component name:
       // https://github.com/smooth-code/svgr/blob/01b194cf967347d43d4cbe6b434404731b87cf27/packages/core/src/state.js#L6
-      const pascalCaseFilename = camelcase(path.parse(filename).name, {
-        pascalCase: true,
-      })
+      const pascalCaseFilename = pascalCase(path.parse(filename).name)
       const componentName = `Svg${pascalCaseFilename}`
       return `const React = require('react');
       module.exports = {

client/config/jest/nodeShims/assert.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('assert')

client/config/jest/nodeShims/async_hooks.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('async_hooks')

client/config/jest/nodeShims/buffer.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('buffer')

client/config/jest/nodeShims/console.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('console')

client/config/jest/nodeShims/crypto.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('crypto')

client/config/jest/nodeShims/diagnostics_channel.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('diagnostics_channel')

client/config/jest/nodeShims/dns.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('dns')

client/config/jest/nodeShims/events.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('events')

client/config/jest/nodeShims/fs.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('fs')

client/config/jest/nodeShims/fs/promises.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('fs/promises')

client/config/jest/nodeShims/http.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('http')

client/config/jest/nodeShims/http2.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('http2')

client/config/jest/nodeShims/https.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('https')

client/config/jest/nodeShims/net.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('net')

client/config/jest/nodeShims/os.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('os')

client/config/jest/nodeShims/path.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('path')

client/config/jest/nodeShims/perf_hooks.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('perf_hooks')

client/config/jest/nodeShims/process.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('process')

client/config/jest/nodeShims/querystring.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('querystring')

client/config/jest/nodeShims/stream.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('stream')

client/config/jest/nodeShims/stream/web.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('stream/web')

client/config/jest/nodeShims/string_decoder.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('string_decoder')

client/config/jest/nodeShims/timers.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('timers')

client/config/jest/nodeShims/timers/promises.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('timers/promises')

client/config/jest/nodeShims/tls.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('tls')

client/config/jest/nodeShims/tty.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('tty')

client/config/jest/nodeShims/url.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('url')

client/config/jest/nodeShims/util.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('util')

client/config/jest/nodeShims/util/types.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('util/types')

client/config/jest/nodeShims/worker_threads.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('worker_threads')

client/config/jest/nodeShims/zlib.js

@@ -0,0 +1,8 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Jest 26 can't resolve `node:`-prefixed core modules (used by newer
+// dependencies such as cheerio); moduleNameMapper points them here.
+module.exports = require('zlib')

client/config/jest/sigmaMock.js

@@ -0,0 +1,38 @@
+/*
+ * SPDX-FileCopyrightText: © 2017-2026 Istari Digital, Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+// Stand-in for `sigma`, `sigma/rendering` and `@sigma/edge-curve` under
+// Jest: sigma's CJS bundle references WebGL2RenderingContext at module
+// load, which doesn't exist in jsdom.
+class MockSigma {
+  on() {
+    return this
+  }
+  refresh() {}
+  kill() {}
+  getNodeAttribute() {}
+  getEdgeAttribute() {}
+  getCustomBBox() {
+    return null
+  }
+  setCustomBBox() {}
+  getBBox() {
+    return { x: [0, 1], y: [0, 1] }
+  }
+  viewportToGraph() {
+    return { x: 0, y: 0 }
+  }
+}
+
+class MockProgram {}
+
+module.exports = {
+  __esModule: true,
+  default: MockSigma,
+  Sigma: MockSigma,
+  EdgeArrowProgram: MockProgram,
+  EdgeCurveProgram: MockProgram,
+  EdgeCurvedArrowProgram: MockProgram,
+}