Merge origin/master into misc-charts-examples

fix(examples): fix broken histogram_v2 and deck_geojson thumbnails
Life Expectancy Histogram had the same bug as the earlier Bubble chart fix: its adhoc filter pointed at 2014, which has zero SP_DYN_LE00_IN data in the world_health dataset, so the thumbnail showed an empty chart. Moved it to 2011, which has real data. Deck.gl GeoJson rendered as a single solid-colored blob: the global fill_color_picker (alpha=1) always overrides any per-feature fill color, and line_width defaulted to ~1 meter, invisible at city zoom, so none of the 25 zip-code boundaries were visible. Baked a population-ranked choropleth fill-color into each zip code's GeoJSON Feature, set fill_color_picker's alpha to 0 so the per-feature colors show through, switched the stroke to a visible white pixel-width line, and turned off the extruded flag since there's no per-feature elevation data backing it.
2026-08-16 21:11:19 +00:00 · 2026-08-14 18:01:35 -07:00 · 2026-08-14 17:51:56 -07:00 · 2026-08-14 16:33:41 -07:00 · 2026-08-14 15:57:05 -07:00 · 2026-08-14 15:10:59 -07:00
626 changed files with 3923 additions and 1644 deletions
@@ -42,7 +42,7 @@ dependencies = [
    # ``google-auth`` 2.53+ dropped it, so Superset must declare it
    # explicitly to keep fresh ``pip install apache-superset`` working
    # without the ``base.txt`` lock file (#40962).
-    "cachetools>=7.1.7, <8",
+    "cachetools>=7.1.6, <8",
    "celery>=5.6.3, <6.0.0",
    "click>=8.4.2",
    "click-option-group",
@@ -75,7 +75,7 @@ dependencies = [
    "humanize",
    "isodate",
    "jsonpath-ng>=1.8.0, <2",
-    "Mako>=1.4.1",
+    "Mako>=1.2.2",
    "markdown>=3.10.3",
    # marshmallow 4 compatibility: see superset/marshmallow_compatibility.py for a
    # Flask-AppBuilder workaround. Tracking issue:
@@ -221,7 +221,7 @@ ocient = [
    # unpinned sqlalchemy>=1.4 declared, but SQLAlchemy 2.0 support is
    # unverified. Lower confidence than the other bumps in this PR.
    "sqlalchemy-ocient>=3.0.0, <4",
-    "pyocient>=3.9.0, <4",
+    "pyocient>=1.0.15, <4",
    "shapely",
    "geojson",
 ]
@@ -28,7 +28,7 @@ numexpr>=2.9.0
 # Security: CVE-2026-34073 (MEDIUM) - Improper Certificate Validation
 cryptography>=50.0.0,<51.0.0
 # Security: Snyk - XSS vulnerability in Mako templates
-mako>=1.4.1,<2.0.0
+mako>=1.3.11,<2.0.0
 # Security: CVE-2024-52338 (CRITICAL) - Deserialization of untrusted data in IPC/Parquet readers
 pyarrow>=24.0.0,<26.0.0
 # Security: CVE-2026-27459 - pyopenssl certificate validation
@@ -44,7 +44,7 @@ cachelib==0.13.0
    # via
    #   flask-caching
    #   flask-session
-cachetools==7.1.7
+cachetools==7.1.6
    # via apache-superset (pyproject.toml)
 cattrs==25.1.1
    # via requests-cache
@@ -207,7 +207,7 @@ kombu==5.6.2
    # via celery
 limits==5.1.0
    # via flask-limiter
-mako==1.4.1
+mako==1.3.12
    # via
    #   -r requirements/base.in
    #   apache-superset (pyproject.toml)
@@ -99,7 +99,7 @@ cachelib==0.13.0
    #   -c requirements/base-constraint.txt
    #   flask-caching
    #   flask-session
-cachetools==7.1.7
+cachetools==7.1.6
    # via
    #   -c requirements/base-constraint.txt
    #   apache-superset
@@ -510,7 +510,7 @@ limits==5.1.0
    #   flask-limiter
 lz4==4.4.5
    # via trino
-mako==1.4.1
+mako==1.3.12
    # via
    #   -c requirements/base-constraint.txt
    #   alembic
@@ -19,7 +19,6 @@
        "@babel/preset-typescript": "7.29.7",
        "@types/node": "^25.4.0",
        "babel-loader": "^9.1.3",
-        "jsdom": "^26.1.0",
        "tscw-config": "^1.1.2",
        "typescript": "^5.9.3",
        "vitest": "^4.0.18",
@@ -27,27 +26,6 @@
        "webpack-cli": "^5.1.4"
      }
    },
-    "node_modules/@asamuzakjp/css-color": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/@asamuzakjp/css-color/-/css-color-3.2.0.tgz",
-      "integrity": "sha512-K1A6z8tS3XsmCMM86xoWdn7Fkdn9m6RSVtocUrJYIwZnFVkng/PvkEoWtOWmP+Scc6saYWHWZYbndEEXxl24jw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@csstools/css-calc": "^2.1.3",
-        "@csstools/css-color-parser": "^3.0.9",
-        "@csstools/css-parser-algorithms": "^3.0.4",
-        "@csstools/css-tokenizer": "^3.0.3",
-        "lru-cache": "^10.4.3"
-      }
-    },
-    "node_modules/@asamuzakjp/css-color/node_modules/lru-cache": {
-      "version": "10.4.3",
-      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
-      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
-      "dev": true,
-      "license": "ISC"
-    },
    "node_modules/@babel/cli": {
      "version": "7.29.7",
      "resolved": "https://registry.npmjs.org/@babel/cli/-/cli-7.29.7.tgz",
@@ -1678,121 +1656,6 @@
        "node": ">=6.9.0"
      }
    },
-    "node_modules/@csstools/color-helpers": {
-      "version": "5.1.0",
-      "resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-5.1.0.tgz",
-      "integrity": "sha512-S11EXWJyy0Mz5SYvRmY8nJYTFFd1LCNV+7cXyAgQtOOuzb4EsgfqDufL+9esx72/eLhsRdGZwaldu/h+E4t4BA==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/csstools"
-        },
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/csstools"
-        }
-      ],
-      "license": "MIT-0",
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/@csstools/css-calc": {
-      "version": "2.1.4",
-      "resolved": "https://registry.npmjs.org/@csstools/css-calc/-/css-calc-2.1.4.tgz",
-      "integrity": "sha512-3N8oaj+0juUw/1H3YwmDDJXCgTB1gKU6Hc/bB502u9zR0q2vd786XJH9QfrKIEgFlZmhZiq6epXl4rHqhzsIgQ==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/csstools"
-        },
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/csstools"
-        }
-      ],
-      "license": "MIT",
-      "engines": {
-        "node": ">=18"
-      },
-      "peerDependencies": {
-        "@csstools/css-parser-algorithms": "^3.0.5",
-        "@csstools/css-tokenizer": "^3.0.4"
-      }
-    },
-    "node_modules/@csstools/css-color-parser": {
-      "version": "3.1.0",
-      "resolved": "https://registry.npmjs.org/@csstools/css-color-parser/-/css-color-parser-3.1.0.tgz",
-      "integrity": "sha512-nbtKwh3a6xNVIp/VRuXV64yTKnb1IjTAEEh3irzS+HkKjAOYLTGNb9pmVNntZ8iVBHcWDA2Dof0QtPgFI1BaTA==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/csstools"
-        },
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/csstools"
-        }
-      ],
-      "license": "MIT",
-      "dependencies": {
-        "@csstools/color-helpers": "^5.1.0",
-        "@csstools/css-calc": "^2.1.4"
-      },
-      "engines": {
-        "node": ">=18"
-      },
-      "peerDependencies": {
-        "@csstools/css-parser-algorithms": "^3.0.5",
-        "@csstools/css-tokenizer": "^3.0.4"
-      }
-    },
-    "node_modules/@csstools/css-parser-algorithms": {
-      "version": "3.0.5",
-      "resolved": "https://registry.npmjs.org/@csstools/css-parser-algorithms/-/css-parser-algorithms-3.0.5.tgz",
-      "integrity": "sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/csstools"
-        },
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/csstools"
-        }
-      ],
-      "license": "MIT",
-      "engines": {
-        "node": ">=18"
-      },
-      "peerDependencies": {
-        "@csstools/css-tokenizer": "^3.0.4"
-      }
-    },
-    "node_modules/@csstools/css-tokenizer": {
-      "version": "3.0.4",
-      "resolved": "https://registry.npmjs.org/@csstools/css-tokenizer/-/css-tokenizer-3.0.4.tgz",
-      "integrity": "sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==",
-      "dev": true,
-      "funding": [
-        {
-          "type": "github",
-          "url": "https://github.com/sponsors/csstools"
-        },
-        {
-          "type": "opencollective",
-          "url": "https://opencollective.com/csstools"
-        }
-      ],
-      "license": "MIT",
-      "engines": {
-        "node": ">=18"
-      }
-    },
    "node_modules/@discoveryjs/json-ext": {
      "version": "0.5.6",
      "resolved": "https://registry.npmjs.org/@discoveryjs/json-ext/-/json-ext-0.5.6.tgz",
@@ -2638,16 +2501,6 @@
        "acorn": "^8.14.0"
      }
    },
-    "node_modules/agent-base": {
-      "version": "7.1.4",
-      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
-      "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">= 14"
-      }
-    },
    "node_modules/ajv": {
      "version": "8.20.0",
      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.20.0.tgz",
@@ -3015,34 +2868,6 @@
        "node": ">= 8"
      }
    },
-    "node_modules/cssstyle": {
-      "version": "4.6.0",
-      "resolved": "https://registry.npmjs.org/cssstyle/-/cssstyle-4.6.0.tgz",
-      "integrity": "sha512-2z+rWdzbbSZv6/rhtvzvqeZQHrBaqgogqt85sqFNbabZOuFbCVFb8kPeEtZjiKkbrm395irpNKiYeFeLiQnFPg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@asamuzakjp/css-color": "^3.2.0",
-        "rrweb-cssom": "^0.8.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/data-urls": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/data-urls/-/data-urls-5.0.0.tgz",
-      "integrity": "sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "whatwg-mimetype": "^4.0.0",
-        "whatwg-url": "^14.0.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
    "node_modules/debug": {
      "version": "4.4.3",
      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
@@ -3061,13 +2886,6 @@
        }
      }
    },
-    "node_modules/decimal.js": {
-      "version": "10.6.0",
-      "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.6.0.tgz",
-      "integrity": "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==",
-      "dev": true,
-      "license": "MIT"
-    },
    "node_modules/detect-libc": {
      "version": "2.1.2",
      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
@@ -3097,19 +2915,6 @@
        "node": ">=10.13.0"
      }
    },
-    "node_modules/entities": {
-      "version": "6.0.1",
-      "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz",
-      "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==",
-      "dev": true,
-      "license": "BSD-2-Clause",
-      "engines": {
-        "node": ">=0.12"
-      },
-      "funding": {
-        "url": "https://github.com/fb55/entities?sponsor=1"
-      }
-    },
    "node_modules/envinfo": {
      "version": "7.13.0",
      "resolved": "https://registry.npmjs.org/envinfo/-/envinfo-7.13.0.tgz",
@@ -3511,60 +3316,6 @@
        "node": ">= 0.4"
      }
    },
-    "node_modules/html-encoding-sniffer": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-4.0.0.tgz",
-      "integrity": "sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "whatwg-encoding": "^3.1.1"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/http-proxy-agent": {
-      "version": "7.0.2",
-      "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz",
-      "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "agent-base": "^7.1.0",
-        "debug": "^4.3.4"
-      },
-      "engines": {
-        "node": ">= 14"
-      }
-    },
-    "node_modules/https-proxy-agent": {
-      "version": "7.0.6",
-      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",
-      "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "agent-base": "^7.1.2",
-        "debug": "4"
-      },
-      "engines": {
-        "node": ">= 14"
-      }
-    },
-    "node_modules/iconv-lite": {
-      "version": "0.6.3",
-      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
-      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "safer-buffer": ">= 2.1.2 < 3.0.0"
-      },
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
    "node_modules/import-local": {
      "version": "3.1.0",
      "resolved": "https://registry.npmjs.org/import-local/-/import-local-3.1.0.tgz",
@@ -3687,13 +3438,6 @@
        "node": ">=0.10.0"
      }
    },
-    "node_modules/is-potential-custom-element-name": {
-      "version": "1.0.1",
-      "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz",
-      "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==",
-      "dev": true,
-      "license": "MIT"
-    },
    "node_modules/isexe": {
      "version": "2.0.0",
      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
@@ -3754,46 +3498,6 @@
      "dev": true,
      "license": "MIT"
    },
-    "node_modules/jsdom": {
-      "version": "26.1.0",
-      "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-26.1.0.tgz",
-      "integrity": "sha512-Cvc9WUhxSMEo4McES3P7oK3QaXldCfNWp7pl2NNeiIFlCoLr3kfq9kb1fxftiwk1FLV7CvpvDfonxtzUDeSOPg==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "cssstyle": "^4.2.1",
-        "data-urls": "^5.0.0",
-        "decimal.js": "^10.5.0",
-        "html-encoding-sniffer": "^4.0.0",
-        "http-proxy-agent": "^7.0.2",
-        "https-proxy-agent": "^7.0.6",
-        "is-potential-custom-element-name": "^1.0.1",
-        "nwsapi": "^2.2.16",
-        "parse5": "^7.2.1",
-        "rrweb-cssom": "^0.8.0",
-        "saxes": "^6.0.0",
-        "symbol-tree": "^3.2.4",
-        "tough-cookie": "^5.1.1",
-        "w3c-xmlserializer": "^5.0.0",
-        "webidl-conversions": "^7.0.0",
-        "whatwg-encoding": "^3.1.1",
-        "whatwg-mimetype": "^4.0.0",
-        "whatwg-url": "^14.1.1",
-        "ws": "^8.18.0",
-        "xml-name-validator": "^5.0.0"
-      },
-      "engines": {
-        "node": ">=18"
-      },
-      "peerDependencies": {
-        "canvas": "^3.0.0"
-      },
-      "peerDependenciesMeta": {
-        "canvas": {
-          "optional": true
-        }
-      }
-    },
    "node_modules/jsesc": {
      "version": "3.1.0",
      "resolved": "https://registry.npmjs.org/jsesc/-/jsesc-3.1.0.tgz",
@@ -4273,13 +3977,6 @@
        "node": ">=0.10.0"
      }
    },
-    "node_modules/nwsapi": {
-      "version": "2.2.24",
-      "resolved": "https://registry.npmjs.org/nwsapi/-/nwsapi-2.2.24.tgz",
-      "integrity": "sha512-7YRhZ3jS45LwmSCT4b2sVFHt/WuovaktDU07QrtOBY2PXskss5a9jfmR9jptyumwXST+rFjrmppMY1KT/yn35A==",
-      "dev": true,
-      "license": "MIT"
-    },
    "node_modules/obug": {
      "version": "2.1.1",
      "resolved": "https://registry.npmjs.org/obug/-/obug-2.1.1.tgz",
@@ -4336,19 +4033,6 @@
        "node": ">=6"
      }
    },
-    "node_modules/parse5": {
-      "version": "7.3.0",
-      "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz",
-      "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "entities": "^6.0.0"
-      },
-      "funding": {
-        "url": "https://github.com/inikulin/parse5?sponsor=1"
-      }
-    },
    "node_modules/path-exists": {
      "version": "4.0.0",
      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
@@ -4458,16 +4142,6 @@
        "node": "^10 || ^12 || >=14"
      }
    },
-    "node_modules/punycode": {
-      "version": "2.3.1",
-      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
-      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
    "node_modules/readdirp": {
      "version": "3.6.0",
      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
@@ -4640,33 +4314,6 @@
        "@rolldown/binding-win32-x64-msvc": "1.1.3"
      }
    },
-    "node_modules/rrweb-cssom": {
-      "version": "0.8.0",
-      "resolved": "https://registry.npmjs.org/rrweb-cssom/-/rrweb-cssom-0.8.0.tgz",
-      "integrity": "sha512-guoltQEx+9aMf2gDZ0s62EcV8lsXR+0w8915TC3ITdn2YueuNjdAYh/levpU9nFaoChh9RUS5ZdQMrKfVEN9tw==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/safer-buffer": {
-      "version": "2.1.2",
-      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
-      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/saxes": {
-      "version": "6.0.0",
-      "resolved": "https://registry.npmjs.org/saxes/-/saxes-6.0.0.tgz",
-      "integrity": "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==",
-      "dev": true,
-      "license": "ISC",
-      "dependencies": {
-        "xmlchars": "^2.2.0"
-      },
-      "engines": {
-        "node": ">=v12.22.7"
-      }
-    },
    "node_modules/schema-utils": {
      "version": "4.3.3",
      "resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.3.3.tgz",
@@ -4800,13 +4447,6 @@
        "url": "https://github.com/sponsors/ljharb"
      }
    },
-    "node_modules/symbol-tree": {
-      "version": "3.2.4",
-      "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz",
-      "integrity": "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==",
-      "dev": true,
-      "license": "MIT"
-    },
    "node_modules/tapable": {
      "version": "2.3.0",
      "resolved": "https://registry.npmjs.org/tapable/-/tapable-2.3.0.tgz",
@@ -4952,26 +4592,6 @@
        "node": ">=14.0.0"
      }
    },
-    "node_modules/tldts": {
-      "version": "6.1.86",
-      "resolved": "https://registry.npmjs.org/tldts/-/tldts-6.1.86.tgz",
-      "integrity": "sha512-WMi/OQ2axVTf/ykqCQgXiIct+mSQDFdH2fkwhPwgEwvJ1kSzZRiinb0zF2Xb8u4+OqPChmyI6MEu4EezNJz+FQ==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "tldts-core": "^6.1.86"
-      },
-      "bin": {
-        "tldts": "bin/cli.js"
-      }
-    },
-    "node_modules/tldts-core": {
-      "version": "6.1.86",
-      "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-6.1.86.tgz",
-      "integrity": "sha512-Je6p7pkk+KMzMv2XXKmAE3McmolOQFdxkKw0R8EYNr7sELW46JqnNeTX8ybPiQgvg1ymCoF8LXs5fzFaZvJPTA==",
-      "dev": true,
-      "license": "MIT"
-    },
    "node_modules/to-regex-range": {
      "version": "5.0.1",
      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
@@ -4985,32 +4605,6 @@
        "node": ">=8.0"
      }
    },
-    "node_modules/tough-cookie": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-5.1.2.tgz",
-      "integrity": "sha512-FVDYdxtnj0G6Qm/DhNPSb8Ju59ULcup3tuJxkFb5K8Bv2pUXILbf0xZWU8PX8Ov19OXljbUyveOFwRMwkXzO+A==",
-      "dev": true,
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "tldts": "^6.1.32"
-      },
-      "engines": {
-        "node": ">=16"
-      }
-    },
-    "node_modules/tr46": {
-      "version": "5.1.1",
-      "resolved": "https://registry.npmjs.org/tr46/-/tr46-5.1.1.tgz",
-      "integrity": "sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "punycode": "^2.3.1"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
    "node_modules/tscw-config": {
      "version": "1.1.2",
      "resolved": "https://registry.npmjs.org/tscw-config/-/tscw-config-1.1.2.tgz",
@@ -5337,19 +4931,6 @@
        "url": "https://github.com/sponsors/jonschlinkert"
      }
    },
-    "node_modules/w3c-xmlserializer": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz",
-      "integrity": "sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "xml-name-validator": "^5.0.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
    "node_modules/watchpack": {
      "version": "2.5.1",
      "resolved": "https://registry.npmjs.org/watchpack/-/watchpack-2.5.1.tgz",
@@ -5363,16 +4944,6 @@
        "node": ">=10.13.0"
      }
    },
-    "node_modules/webidl-conversions": {
-      "version": "7.0.0",
-      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-7.0.0.tgz",
-      "integrity": "sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==",
-      "dev": true,
-      "license": "BSD-2-Clause",
-      "engines": {
-        "node": ">=12"
-      }
-    },
    "node_modules/webpack": {
      "version": "5.105.0",
      "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.105.0.tgz",
@@ -5499,44 +5070,6 @@
        "node": ">=10.13.0"
      }
    },
-    "node_modules/whatwg-encoding": {
-      "version": "3.1.1",
-      "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-3.1.1.tgz",
-      "integrity": "sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==",
-      "deprecated": "Use @exodus/bytes instead for a more spec-conformant and faster implementation",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "iconv-lite": "0.6.3"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/whatwg-mimetype": {
-      "version": "4.0.0",
-      "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-4.0.0.tgz",
-      "integrity": "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/whatwg-url": {
-      "version": "14.2.0",
-      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-14.2.0.tgz",
-      "integrity": "sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "tr46": "^5.1.0",
-        "webidl-conversions": "^7.0.0"
-      },
-      "engines": {
-        "node": ">=18"
-      }
-    },
    "node_modules/which": {
      "version": "2.0.2",
      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
@@ -5581,45 +5114,6 @@
      "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=",
      "dev": true
    },
-    "node_modules/ws": {
-      "version": "8.21.1",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.1.tgz",
-      "integrity": "sha512-+0NTnW77fFN/DjQi6k/Sq/Yvk4Sgajw7urW8V+asjXnRgDs9gyGkdb7EzgfhA4goXsRIZKE28fzIXBHEzhuiWw==",
-      "dev": true,
-      "license": "MIT",
-      "engines": {
-        "node": ">=10.0.0"
-      },
-      "peerDependencies": {
-        "bufferutil": "^4.0.1",
-        "utf-8-validate": ">=5.0.2"
-      },
-      "peerDependenciesMeta": {
-        "bufferutil": {
-          "optional": true
-        },
-        "utf-8-validate": {
-          "optional": true
-        }
-      }
-    },
-    "node_modules/xml-name-validator": {
-      "version": "5.0.0",
-      "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-5.0.0.tgz",
-      "integrity": "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==",
-      "dev": true,
-      "license": "Apache-2.0",
-      "engines": {
-        "node": ">=18"
-      }
-    },
-    "node_modules/xmlchars": {
-      "version": "2.2.0",
-      "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz",
-      "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==",
-      "dev": true,
-      "license": "MIT"
-    },
    "node_modules/yallist": {
      "version": "3.1.1",
      "resolved": "https://registry.npmjs.org/yallist/-/yallist-3.1.1.tgz",
@@ -43,7 +43,6 @@
    "@babel/preset-typescript": "7.29.7",
    "@types/node": "^25.4.0",
    "babel-loader": "^9.1.3",
-    "jsdom": "^26.1.0",
    "tscw-config": "^1.1.2",
    "typescript": "^5.9.3",
    "vitest": "^4.0.18",
@@ -1,213 +0,0 @@
-/**
- * Licensed to the Apache Software Foundation (ASF) under one
- * or more contributor license agreements.  See the NOTICE file
- * distributed with this work for additional information
- * regarding copyright ownership.  The ASF licenses this file
- * to you under the Apache License, Version 2.0 (the
- * "License"); you may not use this file except in compliance
- * with the License.  You may obtain a copy of the License at
- *
- *   http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing,
- * software distributed under the License is distributed on an
- * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- * KIND, either express or implied.  See the License for the
- * specific language governing permissions and limitations
- * under the License.
- */
-
-// @vitest-environment jsdom
-
-import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
-import { Switchboard } from "@superset-ui/switchboard";
-import { embedDashboard } from "./index";
-
-vi.mock("@superset-ui/switchboard");
-
-function makeFakeJWT(claims: any) {
-  // not a valid jwt, but close enough for this code
-  const tokenifiedClaims = Buffer.from(JSON.stringify(claims)).toString(
-    "base64",
-  );
-  return `abc.${tokenifiedClaims}.xyz`;
-}
-
-describe("embedDashboard", () => {
-  let mountPoint: HTMLElement;
-  let mockSwitchboard: Switchboard;
-
-  beforeEach(() => {
-    mountPoint = document.createElement("div");
-    document.body.appendChild(mountPoint);
-
-    mockSwitchboard = {
-      emit: vi.fn(),
-      get: vi.fn(),
-      start: vi.fn(),
-      defineMethod: vi.fn(),
-    } as any;
-
-    // Constructor mocks must use `function`, since arrow functions cannot be
-    // invoked with `new`.
-    vi.mocked(Switchboard).mockImplementation(function () {
-      return mockSwitchboard;
-    } as any);
-
-    // Mock MessageChannel API
-    globalThis.MessageChannel = vi.fn(function (this: any) {
-      this.port1 = {};
-      this.port2 = {};
-    }) as any;
-
-    // Mock iframe load event and sandbox
-    const originalCreateElement = document.createElement.bind(document);
-    vi.spyOn(document, "createElement").mockImplementation(tagName => {
-      const element = originalCreateElement(tagName);
-      if (tagName === "iframe") {
-        // Mock sandbox DOMTokenList
-        (element as any).sandbox = {
-          add: vi.fn(),
-        };
-        // Mock contentWindow for postMessage
-        Object.defineProperty(element, "contentWindow", {
-          writable: true,
-          value: {
-            postMessage: vi.fn(),
-          },
-        });
-        setTimeout(() => {
-          element.dispatchEvent(new Event("load"));
-        }, 0);
-      }
-      return element;
-    });
-  });
-
-  afterEach(() => {
-    document.body.removeChild(mountPoint);
-    vi.restoreAllMocks();
-  });
-
-  test("setDataMask sends dataMask to iframe", async () => {
-    const fakeToken = makeFakeJWT({ exp: Date.now() / 1000 + 300 });
-    const mockFetchGuestToken = vi.fn().mockResolvedValue(fakeToken);
-    const testDataMask = {
-      "NATIVE_FILTER-1": {
-        filterState: {
-          value: ["value1", "value2"],
-        },
-      },
-    };
-
-    const dashboard = await embedDashboard({
-      id: "test-id",
-      supersetDomain: "https://superset.example.com",
-      mountPoint,
-      fetchGuestToken: mockFetchGuestToken,
-    });
-
-    dashboard.setDataMask(testDataMask);
-
-    expect(mockSwitchboard.get).toHaveBeenCalledWith("setDataMask", {
-      dataMask: testDataMask,
-    });
-  });
-
-  test("setDataMask sends empty dataMask", async () => {
-    const fakeToken = makeFakeJWT({ exp: Date.now() / 1000 + 300 });
-    const mockFetchGuestToken = vi.fn().mockResolvedValue(fakeToken);
-    const emptyDataMask = {};
-
-    const dashboard = await embedDashboard({
-      id: "test-id",
-      supersetDomain: "https://superset.example.com",
-      mountPoint,
-      fetchGuestToken: mockFetchGuestToken,
-    });
-
-    dashboard.setDataMask(emptyDataMask);
-
-    expect(mockSwitchboard.get).toHaveBeenCalledWith("setDataMask", {
-      dataMask: emptyDataMask,
-    });
-  });
-
-  test("setDataMask drops the change-trigger flags observeDataMask adds", async () => {
-    const fakeToken = makeFakeJWT({ exp: Date.now() / 1000 + 300 });
-    const mockFetchGuestToken = vi.fn().mockResolvedValue(fakeToken);
-    const observedMask = {
-      "NATIVE_FILTER-1": {
-        filterState: {
-          value: ["CA"],
-        },
-      },
-      crossFiltersChanged: false,
-      nativeFiltersChanged: true,
-    };
-
-    const dashboard = await embedDashboard({
-      id: "test-id",
-      supersetDomain: "https://superset.example.com",
-      mountPoint,
-      fetchGuestToken: mockFetchGuestToken,
-    });
-
-    dashboard.setDataMask(observedMask);
-
-    expect(mockSwitchboard.get).toHaveBeenCalledWith("setDataMask", {
-      dataMask: {
-        "NATIVE_FILTER-1": observedMask["NATIVE_FILTER-1"],
-      },
-    });
-  });
-
-  test("setDataMask sends complex dataMask with multiple filters", async () => {
-    const fakeToken = makeFakeJWT({ exp: Date.now() / 1000 + 300 });
-    const mockFetchGuestToken = vi.fn().mockResolvedValue(fakeToken);
-    const complexDataMask = {
-      "NATIVE_FILTER-1": {
-        filterState: {
-          value: ["CA", "NY"],
-        },
-      },
-      "NATIVE_FILTER-2": {
-        filterState: {
-          value: [2023, 2024],
-        },
-      },
-    };
-
-    const dashboard = await embedDashboard({
-      id: "test-id",
-      supersetDomain: "https://superset.example.com",
-      mountPoint,
-      fetchGuestToken: mockFetchGuestToken,
-    });
-
-    dashboard.setDataMask(complexDataMask);
-
-    expect(mockSwitchboard.get).toHaveBeenCalledWith("setDataMask", {
-      dataMask: complexDataMask,
-    });
-  });
-
-  test("setDataMask rejects when the embedded page does not support it", async () => {
-    const fakeToken = makeFakeJWT({ exp: Date.now() / 1000 + 300 });
-    const mockFetchGuestToken = vi.fn().mockResolvedValue(fakeToken);
-    vi.mocked(mockSwitchboard.get).mockRejectedValue(
-      new Error('Method "setDataMask" is not defined'),
-    );
-
-    const dashboard = await embedDashboard({
-      id: "test-id",
-      supersetDomain: "https://superset.example.com",
-      mountPoint,
-      fetchGuestToken: mockFetchGuestToken,
-    });
-
-    await expect(dashboard.setDataMask({})).rejects.toThrow(
-      'Method "setDataMask" is not defined',
-    );
-  });
-});
@@ -115,12 +115,6 @@ export type EmbeddedDashboard = {
  getActiveTabs: () => Promise<string[]>;
  observeDataMask: (callbackFn: ObserveDataMaskCallbackFn) => void;
  getDataMask: () => Promise<Record<string, any>>;
-  /**
-   * Applies a data mask to the dashboard.
-   * Rejects if the embedded Superset page does not support `setDataMask`,
-   * so a version mismatch surfaces instead of silently doing nothing.
-   */
-  setDataMask: (dataMask: Record<string, any>) => Promise<void>;
  getChartStates: () => Promise<Record<string, any>>;
  getChartDataPayloads: (params?: {
    chartId?: number;
@@ -361,21 +355,6 @@ export async function embedDashboard({
    ourPort.get<string>("getDashboardPermalink", { anchor });
  const getActiveTabs = () => ourPort.get<string[]>("getActiveTabs");
  const getDataMask = () => ourPort.get<Record<string, any>>("getDataMask");
-  // `observeDataMask` hands the host a mask with the change-trigger booleans
-  // mixed in, so feeding that payload straight back into `setDataMask` is a
-  // natural thing for a host to do. Keep only the entries that look like a
-  // filter's mask, so those flags never reach the dashboard as filter ids.
-  // Sent with `get` rather than `emit` so the iframe acknowledges the call:
-  // an embedded page that predates `setDataMask` replies with an error instead
-  // of dropping the message silently.
-  const setDataMask = (dataMask: Record<string, any>) =>
-    ourPort.get<void>("setDataMask", {
-      dataMask: Object.fromEntries(
-        Object.entries(dataMask).filter(
-          ([, mask]) => typeof mask === "object" && mask !== null,
-        ),
-      ),
-    });
  const getChartStates = () =>
    ourPort.get<Record<string, any>>("getChartStates");
  const getChartDataPayloads = (params?: { chartId?: number }) =>
@@ -417,7 +396,6 @@ export async function embedDashboard({
    getActiveTabs,
    observeDataMask,
    getDataMask,
-    setDataMask,
    getChartStates,
    getChartDataPayloads,
    setThemeConfig,
@@ -33,7 +33,7 @@
        "@fontsource/fira-code": "^5.3.0",
        "@fontsource/ibm-plex-mono": "^5.3.0",
        "@fontsource/inter": "^5.3.0",
-        "@googleapis/sheets": "^14.0.0",
+        "@googleapis/sheets": "^13.0.2",
        "@great-expectations/jsonforms-antd-renderers": "^2.2.10",
        "@jsonforms/core": "^3.7.0",
        "@jsonforms/react": "^3.7.0",
@@ -4142,9 +4142,9 @@
      }
    },
    "node_modules/@googleapis/sheets": {
-      "version": "14.0.0",
-      "resolved": "https://registry.npmjs.org/@googleapis/sheets/-/sheets-14.0.0.tgz",
-      "integrity": "sha512-fANEl4RQohsPYUWhcLSYyUyE8A8bRfvw/bp8h0t8VDQqTgdQ3itZBkty4nddtdqCAvNDpA+KM66OejVKDd6aFg==",
+      "version": "13.0.2",
+      "resolved": "https://registry.npmjs.org/@googleapis/sheets/-/sheets-13.0.2.tgz",
+      "integrity": "sha512-b1tBlMcfvNEziM4DZCikLOc9iqSlgCK1e5bMKtNQIADRXr1CQmbkHV3ZBVvTsFsjLErgihqO58Itn/kzCnSZ0A==",
      "license": "Apache-2.0",
      "dependencies": {
        "googleapis-common": "^8.0.0"
@@ -78,6 +78,7 @@
    "playwright:debug": "playwright test --debug",
    "playwright:report": "playwright show-report",
    "docs:screenshots": "playwright test --config=playwright/generators/playwright.config.ts docs/",
+    "playwright:thumbnails": "CAPTURE_THUMBNAILS=1 playwright test tests/tools/capture-viz-thumbnails.spec.ts --project chromium",
    "prod": "npm run build",
    "prune": "rm -rf ./{packages,plugins}/*/{node_modules,lib,esm,tsconfig.tsbuildinfo,package-lock.json} ./.temp_cache",
    "storybook": "cross-env NODE_ENV=development BABEL_ENV=development storybook dev -p 6006",
@@ -110,7 +111,7 @@
    "@fontsource/fira-code": "^5.3.0",
    "@fontsource/ibm-plex-mono": "^5.3.0",
    "@fontsource/inter": "^5.3.0",
-    "@googleapis/sheets": "^14.0.0",
+    "@googleapis/sheets": "^13.0.2",
    "@great-expectations/jsonforms-antd-renderers": "^2.2.10",
    "@jsonforms/core": "^3.7.0",
    "@jsonforms/react": "^3.7.0",
@@ -47,10 +47,6 @@ export default defineConfig({
  // Retry logic - 2 retries in CI, 0 locally
  retries: process.env.CI ? 2 : 0,

-  // Disable capturing Git commit info as the project's history is increasingly dense
-  // and breach Playwright's default 3-seconds `git` command timeout limit
-  captureGitInfo: { commit: false, diff: false },
-
  // Reporter configuration - multiple reporters for better visibility
  reporter: process.env.CI
    ? [
@@ -0,0 +1,630 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License.  You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+/**
+ * Crawls every dashboard on the target instance and refreshes viz-picker
+ * thumbnails and example galleries from live example charts.
+ *
+ * This is a maintenance tool, not a test: charts are DISCOVERED via the
+ * API (dashboards -> charts), so it keeps working as example dashboards
+ * evolve. Every distinct chart found for a viz type gets captured — the
+ * preferred (or alphabetically-first) chart becomes the 512x512
+ * `thumbnail.png`, and each additional distinct chart fills the next
+ * `exampleGallery` slot declared for that viz type, so the gallery shows
+ * real variety instead of the same chart resized. The two static pieces
+ * are the viz type -> image path maps below (VIZ_TYPE_THUMBNAILS,
+ * VIZ_TYPE_GALLERY), which change when a plugin's images or gallery
+ * shape change — never when examples change. Viz types found on
+ * dashboards but missing from both maps, and gallery slots left unfilled
+ * for lack of enough distinct example charts, are reported at the end
+ * without failing the run.
+ *
+ * It only runs when CAPTURE_THUMBNAILS=1 is set, so the regular
+ * Playwright suites never execute it.
+ *
+ * Usage (requires a running Superset with examples loaded):
+ *   npm run playwright:thumbnails
+ *   VIZ_TYPES=bullet,rose npm run playwright:thumbnails   # subset
+ *
+ * Notes:
+ * - Dark variants (`thumbnail-dark.png`, `example-dark.jpg`) are captured
+ *   via prefers-color-scheme emulation whenever the sibling file exists;
+ *   if the app ignores the emulation (dark theming disabled) the dark
+ *   file is left untouched.
+ * - A brand-new gallery image (rather than an existing file being
+ *   refreshed) still needs to be registered in the plugin's metadata
+ *   before it renders in the gallery; the capture logs a reminder.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { test, expect, Page } from '@playwright/test';
+
+const THUMBNAIL_SIZE = 512;
+const RENDERED_CHART_SELECTOR =
+  '[data-test="chart-container"]:has(svg, canvas, table):not(:has([data-test="loading-indicator"]))';
+/**
+ * Charts that render plain markup — no svg/canvas/table for the rendered
+ * selector to key on — get a looser signal plus a longer settle.
+ */
+const TEXT_ONLY_VIZ_TYPES = new Set([
+  'ag-grid-table',
+  'big_number_total',
+  'handlebars',
+  'pop_kpi',
+]);
+
+/**
+ * Hover this element just before the screenshot, so charts whose identity
+ * benefits from an interaction (a visible tooltip) capture mid-hover.
+ */
+const HOVER_BEFORE_CAPTURE: Record<string, string> = {
+  cal_heatmap: '[data-test="chart-container"] svg rect[class*=" r"]',
+};
+const TEXT_RENDERED_CHART_SELECTOR =
+  '[data-test="chart-container"]:not(:has([data-test="loading-indicator"]))';
+
+/** superset-frontend root, resolved from this spec's location. */
+const FRONTEND_ROOT = path.resolve(__dirname, '..', '..', '..');
+
+const ECHARTS = 'plugins/plugin-chart-echarts/src';
+const DECKGL = 'plugins/preset-chart-deckgl/src/layers';
+
+/**
+ * Where each viz type's gallery thumbnail lives, relative to
+ * superset-frontend. One entry per registered viz type with a thumbnail;
+ * add a line when a new plugin ships.
+ */
+const VIZ_TYPE_THUMBNAILS: Record<string, string> = {
+  'ag-grid-table':
+    'plugins/plugin-chart-ag-grid-table/src/images/thumbnail.png',
+  big_number: `${ECHARTS}/BigNumber/BigNumberWithTrendline/images/thumbnail.png`,
+  big_number_total: `${ECHARTS}/BigNumber/BigNumberTotal/images/thumbnail.png`,
+  box_plot: `${ECHARTS}/BoxPlot/images/thumbnail.png`,
+  bubble_v2: `${ECHARTS}/Bubble/images/thumbnail.png`,
+  bullet: `${ECHARTS}/Bullet/images/thumbnail.png`,
+  cal_heatmap: 'plugins/plugin-chart-calendar/src/images/thumbnail.png',
+  cartodiagram: 'plugins/plugin-chart-cartodiagram/src/images/thumbnail.png',
+  chord: 'plugins/plugin-chart-chord/src/images/thumbnail.png',
+  country_map: 'plugins/plugin-chart-country-map/src/images/thumbnail.png',
+  deck_arc: `${DECKGL}/Arc/images/thumbnail.png`,
+  deck_contour: `${DECKGL}/Contour/images/thumbnail.png`,
+  deck_geojson: `${DECKGL}/Geojson/images/thumbnail.png`,
+  deck_grid: `${DECKGL}/Grid/images/thumbnail.png`,
+  deck_heatmap: `${DECKGL}/Heatmap/images/thumbnail.png`,
+  deck_hex: `${DECKGL}/Hex/images/thumbnail.png`,
+  deck_multi: 'plugins/preset-chart-deckgl/src/Multi/images/thumbnail.png',
+  deck_path: `${DECKGL}/Path/images/thumbnail.png`,
+  deck_polygon: `${DECKGL}/Polygon/images/thumbnail.png`,
+  deck_scatter: `${DECKGL}/Scatter/images/thumbnail.png`,
+  deck_screengrid: `${DECKGL}/Screengrid/images/thumbnail.png`,
+  echarts_area: `${ECHARTS}/Timeseries/Area/images/thumbnail.png`,
+  echarts_timeseries: `${ECHARTS}/Timeseries/images/thumbnail.png`,
+  echarts_timeseries_bar: `${ECHARTS}/Timeseries/Regular/Bar/images/thumbnail.png`,
+  echarts_timeseries_line: `${ECHARTS}/Timeseries/Regular/Line/images/thumbnail.png`,
+  echarts_timeseries_scatter: `${ECHARTS}/Timeseries/Regular/Scatter/images/thumbnail.png`,
+  echarts_timeseries_smooth: `${ECHARTS}/Timeseries/Regular/SmoothLine/images/thumbnail.png`,
+  echarts_timeseries_step: `${ECHARTS}/Timeseries/Step/images/thumbnail.png`,
+  funnel: `${ECHARTS}/Funnel/images/thumbnail.png`,
+  gantt_chart: `${ECHARTS}/Gantt/images/thumbnail.png`,
+  gauge_chart: `${ECHARTS}/Gauge/images/thumbnail.png`,
+  graph_chart: `${ECHARTS}/Graph/images/thumbnail.png`,
+  // handlebars intentionally unmapped: its generic logo represents the
+  // template-anything nature of the chart better than any one example.
+  heatmap_v2: `${ECHARTS}/Heatmap/images/thumbnail.png`,
+  histogram_v2: `${ECHARTS}/Histogram/images/thumbnail.png`,
+  horizon: 'plugins/plugin-chart-horizon/src/images/thumbnail.png',
+  mixed_timeseries: `${ECHARTS}/MixedTimeseries/images/thumbnail.png`,
+  paired_ttest: 'plugins/plugin-chart-paired-t-test/src/images/thumbnail.png',
+  para: 'plugins/plugin-chart-parallel-coordinates/src/images/thumbnail.png',
+  partition: 'plugins/plugin-chart-partition/src/images/thumbnail.png',
+  pie: `${ECHARTS}/Pie/images/thumbnail.png`,
+  pivot_table_v2: 'plugins/plugin-chart-pivot-table/src/images/thumbnail.png',
+  point_cluster_map:
+    'plugins/plugin-chart-point-cluster-map/src/images/thumbnail.png',
+  pop_kpi: `${ECHARTS}/BigNumber/BigNumberPeriodOverPeriod/images/thumbnail.png`,
+  radar: `${ECHARTS}/Radar/images/thumbnail.png`,
+  rose: `${ECHARTS}/Rose/images/thumbnail.png`,
+  sankey_v2: `${ECHARTS}/Sankey/images/thumbnail.png`,
+  sunburst_v2: `${ECHARTS}/Sunburst/images/thumbnail.png`,
+  table: 'plugins/plugin-chart-table/src/images/thumbnail.png',
+  time_pivot: `${ECHARTS}/TimePivot/images/thumbnail.png`,
+  time_table: 'src/visualizations/TimeTable/images/thumbnail.png',
+  tree_chart: `${ECHARTS}/Tree/images/thumbnail.png`,
+  treemap_v2: `${ECHARTS}/Treemap/images/thumbnail.png`,
+  waterfall: `${ECHARTS}/Waterfall/images/thumbnail.png`,
+  word_cloud: 'plugins/plugin-chart-word-cloud/src/images/thumbnail.png',
+  world_map: 'plugins/plugin-chart-world-map/src/images/thumbnail.png',
+};
+
+/**
+ * When several example charts share a viz type, prefer these slices over
+ * the default alphabetically-first pick. Missing slices fall back to the
+ * default, so stale entries degrade gracefully.
+ */
+const PREFERRED_SLICES: Record<string, string> = {
+  big_number: 'Sales Year over Year',
+  bubble_v2: 'Life Expectancy VS Rural %',
+  bullet: 'Total Sales Bullet',
+  cal_heatmap: 'Sales Calendar Heatmap',
+  chord: 'Product Line Chord',
+  echarts_area: 'Sales Stacked Area',
+  echarts_timeseries_bar: 'Sales Stacked Bars',
+  echarts_timeseries_line: 'Monthly Sales Line',
+  echarts_timeseries_smooth: 'Monthly Sales Smooth',
+  echarts_timeseries_step: 'Quarterly Sales Steps',
+  funnel: 'Population Funnel',
+  gauge_chart: 'Rural Population Gauge',
+  heatmap_v2: 'Sales Grid Heatmap',
+  histogram_v2: 'Life Expectancy Histogram',
+  horizon: 'Population Growth Horizon',
+  mixed_timeseries: 'Sales Mixed Chart',
+  paired_ttest: 'Population Paired t-Test',
+  partition: 'Population Partition',
+  pie: 'Product Line Donut',
+  pivot_table_v2: 'Sales Pivot Highlights',
+  radar: 'Game Sales Radar',
+  rose: 'Population Nightingale Rose',
+  sunburst_v2: 'Population Sunburst',
+  table: 'Sales Summary Table',
+  time_pivot: 'Sales Period Pivot',
+  time_table: 'Product Line Time Table',
+  tree_chart: 'Sales Territory Tree',
+  treemap_v2: 'Population Treemap',
+  waterfall: 'Quarterly Sales Waterfall',
+};
+
+/** Gallery example images use a wide aspect, matching the existing art. */
+const EXAMPLE_WIDTH = 800;
+const EXAMPLE_HEIGHT = 460;
+
+/**
+ * Every plugin's `exampleGallery` image slots (never including
+ * `thumbnail.png`/`thumbnail-dark.png`, which stays governed by
+ * VIZ_TYPE_THUMBNAILS), in the order they appear in that plugin's
+ * `index.ts`. One entry per viz type that declares a gallery — including
+ * `handlebars`, whose gallery is filled even though its picker thumbnail
+ * intentionally stays the generic logo (unmapped in VIZ_TYPE_THUMBNAILS).
+ *
+ * For a viz type with N slots here, the crawler assigns its (N+1)
+ * distinct dashboard charts (the thumbnail's pick, then this many more)
+ * to thumbnail, slot 1, slot 2, ... in that order, so gallery images show
+ * different charts than the thumbnail and each other rather than the same
+ * chart resized. Fewer distinct charts than slots just leaves the
+ * trailing slots untouched (reported, not failed) — add more example
+ * charts to fill them.
+ *
+ * Update this when a plugin's exampleGallery array changes shape.
+ */
+const VIZ_TYPE_GALLERY: Record<string, string[]> = {
+  'ag-grid-table': [
+    'plugins/plugin-chart-ag-grid-table/src/images/Table.jpg',
+    'plugins/plugin-chart-ag-grid-table/src/images/Table2.jpg',
+    'plugins/plugin-chart-ag-grid-table/src/images/Table3.jpg',
+  ],
+  big_number: [
+    `${ECHARTS}/BigNumber/BigNumberWithTrendline/images/Big_Number_Trendline.jpg`,
+  ],
+  big_number_total: [
+    `${ECHARTS}/BigNumber/BigNumberTotal/images/BigNumber.jpg`,
+    `${ECHARTS}/BigNumber/BigNumberTotal/images/BigNumber2.jpg`,
+  ],
+  box_plot: [`${ECHARTS}/BoxPlot/images/BoxPlot.jpg`],
+  bubble_v2: [
+    `${ECHARTS}/Bubble/images/example1.png`,
+    `${ECHARTS}/Bubble/images/example2.png`,
+  ],
+  bullet: [`${ECHARTS}/Bullet/images/example.jpg`],
+  cal_heatmap: ['plugins/plugin-chart-calendar/src/images/example.jpg'],
+  cartodiagram: [
+    'plugins/plugin-chart-cartodiagram/src/images/example1.png',
+    'plugins/plugin-chart-cartodiagram/src/images/example2.png',
+  ],
+  chord: ['plugins/plugin-chart-chord/src/images/chord.jpg'],
+  country_map: [
+    'plugins/plugin-chart-country-map/src/images/exampleUsa.jpg',
+    'plugins/plugin-chart-country-map/src/images/exampleGermany.jpg',
+  ],
+  echarts_area: [`${ECHARTS}/Timeseries/Area/images/Area1.png`],
+  echarts_timeseries: [`${ECHARTS}/Timeseries/images/Time-series_Chart.jpg`],
+  echarts_timeseries_bar: [
+    `${ECHARTS}/Timeseries/Regular/Bar/images/Bar1.png`,
+    `${ECHARTS}/Timeseries/Regular/Bar/images/Bar2.png`,
+    `${ECHARTS}/Timeseries/Regular/Bar/images/Bar3.png`,
+  ],
+  echarts_timeseries_line: [
+    `${ECHARTS}/Timeseries/Regular/Line/images/Line1.png`,
+    `${ECHARTS}/Timeseries/Regular/Line/images/Line2.png`,
+    `${ECHARTS}/Timeseries/Regular/Line/images/Line3.png`,
+  ],
+  echarts_timeseries_scatter: [
+    `${ECHARTS}/Timeseries/Regular/Scatter/images/Scatter1.png`,
+  ],
+  echarts_timeseries_smooth: [
+    `${ECHARTS}/Timeseries/Regular/SmoothLine/images/SmoothLine1.png`,
+  ],
+  echarts_timeseries_step: [
+    `${ECHARTS}/Timeseries/Step/images/Step1.png`,
+    `${ECHARTS}/Timeseries/Step/images/Step2.png`,
+  ],
+  funnel: [`${ECHARTS}/Funnel/images/example.jpg`],
+  gantt_chart: [
+    `${ECHARTS}/Gantt/images/example1.png`,
+    `${ECHARTS}/Gantt/images/example2.png`,
+  ],
+  gauge_chart: [
+    `${ECHARTS}/Gauge/images/example1.jpg`,
+    `${ECHARTS}/Gauge/images/example2.jpg`,
+  ],
+  graph_chart: [`${ECHARTS}/Graph/images/example.jpg`],
+  handlebars: [
+    'plugins/plugin-chart-handlebars/src/images/example1.jpg',
+    'plugins/plugin-chart-handlebars/src/images/example2.jpg',
+  ],
+  heatmap_v2: [
+    `${ECHARTS}/Heatmap/images/example1.png`,
+    `${ECHARTS}/Heatmap/images/example2.png`,
+    `${ECHARTS}/Heatmap/images/example3.png`,
+  ],
+  histogram_v2: [
+    `${ECHARTS}/Histogram/images/example1.png`,
+    `${ECHARTS}/Histogram/images/example2.png`,
+  ],
+  horizon: ['plugins/plugin-chart-horizon/src/images/Horizon_Chart.jpg'],
+  mixed_timeseries: [`${ECHARTS}/MixedTimeseries/images/example.jpg`],
+  paired_ttest: ['plugins/plugin-chart-paired-t-test/src/images/example.jpg'],
+  para: [
+    'plugins/plugin-chart-parallel-coordinates/src/images/example1.jpg',
+    'plugins/plugin-chart-parallel-coordinates/src/images/example2.jpg',
+  ],
+  partition: ['plugins/plugin-chart-partition/src/images/example.jpg'],
+  pie: [
+    `${ECHARTS}/Pie/images/Pie1.jpg`,
+    `${ECHARTS}/Pie/images/Pie2.jpg`,
+    `${ECHARTS}/Pie/images/Pie3.jpg`,
+    `${ECHARTS}/Pie/images/Pie4.jpg`,
+  ],
+  pivot_table_v2: ['plugins/plugin-chart-pivot-table/src/images/example.jpg'],
+  point_cluster_map: [
+    'plugins/plugin-chart-point-cluster-map/src/images/MapBox.jpg',
+    'plugins/plugin-chart-point-cluster-map/src/images/MapBox2.jpg',
+  ],
+  radar: [
+    `${ECHARTS}/Radar/images/example1.jpg`,
+    `${ECHARTS}/Radar/images/example2.jpg`,
+  ],
+  rose: [
+    `${ECHARTS}/Rose/images/example1.jpg`,
+    `${ECHARTS}/Rose/images/example2.jpg`,
+  ],
+  sankey_v2: [
+    `${ECHARTS}/Sankey/images/example1.png`,
+    `${ECHARTS}/Sankey/images/example2.png`,
+  ],
+  sunburst_v2: [
+    `${ECHARTS}/Sunburst/images/Sunburst1.png`,
+    `${ECHARTS}/Sunburst/images/Sunburst2.png`,
+  ],
+  table: [
+    'plugins/plugin-chart-table/src/images/Table.jpg',
+    'plugins/plugin-chart-table/src/images/Table2.jpg',
+    'plugins/plugin-chart-table/src/images/Table3.jpg',
+  ],
+  time_pivot: [`${ECHARTS}/TimePivot/images/example.jpg`],
+  time_table: ['src/visualizations/TimeTable/images/example.jpg'],
+  tree_chart: [`${ECHARTS}/Tree/images/tree.png`],
+  treemap_v2: [
+    `${ECHARTS}/Treemap/images/treemap_v2_1.png`,
+    `${ECHARTS}/Treemap/images/treemap_v2_2.jpg`,
+  ],
+  waterfall: [
+    `${ECHARTS}/Waterfall/images/example1.png`,
+    `${ECHARTS}/Waterfall/images/example2.png`,
+    `${ECHARTS}/Waterfall/images/example3.png`,
+  ],
+  word_cloud: [
+    'plugins/plugin-chart-word-cloud/src/images/Word_Cloud.jpg',
+    'plugins/plugin-chart-word-cloud/src/images/Word_Cloud_2.jpg',
+  ],
+  world_map: [
+    'plugins/plugin-chart-world-map/src/images/WorldMap1.jpg',
+    'plugins/plugin-chart-world-map/src/images/WorldMap2.jpg',
+  ],
+  deck_arc: [`${DECKGL}/Arc/images/example.png`],
+  deck_contour: [`${DECKGL}/Contour/images/example.png`],
+  deck_geojson: [`${DECKGL}/Geojson/images/example.png`],
+  deck_grid: [`${DECKGL}/Grid/images/example.png`],
+  deck_heatmap: [`${DECKGL}/Heatmap/images/example.png`],
+  deck_hex: [`${DECKGL}/Hex/images/example.png`],
+  deck_multi: ['plugins/preset-chart-deckgl/src/Multi/images/example.png'],
+  deck_path: [`${DECKGL}/Path/images/example.png`],
+  deck_polygon: [`${DECKGL}/Polygon/images/example.png`],
+  deck_scatter: [`${DECKGL}/Scatter/images/example.png`],
+  deck_screengrid: [`${DECKGL}/Screengrid/images/example.png`],
+};
+
+interface ExampleChart {
+  id: number;
+  sliceName: string;
+  vizType: string;
+}
+
+interface DashboardRow {
+  id: number;
+}
+
+interface DashboardChartRow {
+  id?: number;
+  slice_name?: string;
+  form_data?: { viz_type?: string };
+}
+
+/** Pages through a list endpoint, returning every result row. */
+async function fetchAllPages<T>(page: Page, endpoint: string): Promise<T[]> {
+  const rows: T[] = [];
+  const pageSize = 100;
+  for (let pageNum = 0; ; pageNum += 1) {
+    const q = encodeURIComponent(
+      `(page_size:${pageSize},page:${pageNum},order_direction:asc)`,
+    );
+    const response = await page.request.get(`${endpoint}?q=${q}`);
+    expect(response.ok(), `GET ${endpoint} page ${pageNum}`).toBeTruthy();
+    const { result }: { result: T[] } = await response.json();
+    rows.push(...result);
+    if (result.length < pageSize) return rows;
+  }
+}
+
+/** Discovers every chart placed on any dashboard. */
+async function discoverDashboardCharts(page: Page): Promise<ExampleChart[]> {
+  const dashboards = await fetchAllPages<DashboardRow>(
+    page,
+    '/api/v1/dashboard/',
+  );
+  const chartsById = new Map<number, ExampleChart>();
+  for (const dashboard of dashboards) {
+    const response = await page.request.get(
+      `/api/v1/dashboard/${dashboard.id}/charts`,
+    );
+    if (!response.ok()) continue;
+    const { result }: { result: DashboardChartRow[] } = await response.json();
+    for (const chart of result) {
+      const vizType = chart.form_data?.viz_type;
+      if (chart.id && chart.slice_name && vizType) {
+        chartsById.set(chart.id, {
+          id: chart.id,
+          sliceName: chart.slice_name,
+          vizType,
+        });
+      }
+    }
+  }
+  return [...chartsById.values()];
+}
+
+/** thumbnail.png -> thumbnail-dark.png, example.jpg -> example-dark.jpg */
+function darkSibling(output: string): string {
+  return output.replace(/\.(png|jpg)$/, '-dark.$1');
+}
+
+async function renderAndShoot(
+  page: Page,
+  chart: ExampleChart,
+  colorScheme: 'light' | 'dark',
+): Promise<Buffer> {
+  // An explicit navigation timeout keeps one hung load from stalling the
+  // whole crawl until the test timeout.
+  await page.goto(`/explore/?slice_id=${chart.id}&standalone=1`, {
+    timeout: 60_000,
+  });
+  // Dashboards render charts on colorBgContainer cards, but the standalone
+  // explore page paints the gray colorBgLayout (via the antd Layout
+  // wrapper); match the dashboard context so thumbnails look like charts
+  // do where users see them.
+  await page
+    .addStyleTag({
+      content: `body, .ant-layout { background: ${
+        colorScheme === 'dark' ? '#141414' : '#ffffff'
+      } !important; }`,
+    })
+    .catch(() => {});
+  const textOnly = TEXT_ONLY_VIZ_TYPES.has(chart.vizType);
+  await page
+    .locator(textOnly ? TEXT_RENDERED_CHART_SELECTOR : RENDERED_CHART_SELECTOR)
+    .first()
+    .waitFor({ state: 'visible', timeout: 60_000 });
+  // Give animations/map tiles (or text-only chart data) time to settle
+  await page.waitForTimeout(textOnly ? 4_000 : 2_000);
+  // Some thumbnails read better mid-interaction (e.g. the calendar heatmap
+  // showing its tooltip); hover the configured element before the still.
+  const hoverSelector = HOVER_BEFORE_CAPTURE[chart.vizType];
+  if (hoverSelector) {
+    // Hover a mid-chart element rather than the first (often an empty
+    // corner cell), falling back to the first when there are few.
+    const cells = page.locator(hoverSelector);
+    const count = await cells.count().catch(() => 0);
+    await cells
+      .nth(Math.floor(count / 2))
+      .hover({ timeout: 5_000 })
+      .catch(() => {});
+    await page.waitForTimeout(500);
+  }
+  return page.screenshot();
+}
+
+/**
+ * Captures a chart light and (when a dark variant is wanted) dark. Dark
+ * rendering relies on the app following prefers-color-scheme (theme mode
+ * SYSTEM); if the dark render is byte-identical to the light one the app
+ * ignored the emulation, and the dark file is left untouched rather than
+ * overwritten with light-theme art.
+ */
+async function captureChart(
+  page: Page,
+  chart: ExampleChart,
+  output: string,
+  size: { width: number; height: number },
+): Promise<void> {
+  const outputPath = path.join(FRONTEND_ROOT, output);
+  const darkPath = path.join(FRONTEND_ROOT, darkSibling(output));
+  const isNewImage = !fs.existsSync(outputPath);
+  const wantDark = fs.existsSync(darkPath) || isNewImage;
+
+  await page.setViewportSize(size);
+  await page.emulateMedia({ colorScheme: 'light' });
+  const lightShot = await renderAndShoot(page, chart, 'light');
+  fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+  fs.writeFileSync(outputPath, lightShot);
+  // eslint-disable-next-line no-console
+  console.log(`captured ${chart.sliceName} (${chart.vizType}) -> ${output}`);
+
+  if (wantDark) {
+    await page.emulateMedia({ colorScheme: 'dark' });
+    const darkShot = await renderAndShoot(page, chart, 'dark');
+    if (darkShot.equals(lightShot)) {
+      // eslint-disable-next-line no-console
+      console.log(
+        `SKIPPED dark variant for ${chart.sliceName}: the app ignored the dark color-scheme emulation (is dark theming enabled?)`,
+      );
+    } else {
+      fs.writeFileSync(darkPath, darkShot);
+      // eslint-disable-next-line no-console
+      console.log(
+        `captured ${chart.sliceName} (dark) -> ${darkSibling(output)}`,
+      );
+    }
+  }
+
+  if (isNewImage) {
+    // eslint-disable-next-line no-console
+    console.log(
+      `NOTE: ${output} is a new gallery image — register it in the plugin metadata (exampleGallery) to surface it.`,
+    );
+  }
+}
+
+test.describe('capture viz thumbnails', () => {
+  test.skip(
+    !process.env.CAPTURE_THUMBNAILS,
+    'Thumbnail capture only runs with CAPTURE_THUMBNAILS=1',
+  );
+
+  test('crawls example dashboards and refreshes gallery thumbnails', async ({
+    page,
+  }) => {
+    test.setTimeout(90 * 60_000);
+
+    const vizTypeFilter = process.env.VIZ_TYPES
+      ? new Set(process.env.VIZ_TYPES.split(',').map(v => v.trim()))
+      : null;
+
+    const charts = await discoverDashboardCharts(page);
+    expect(
+      charts.length,
+      'no dashboard charts found — are examples loaded?',
+    ).toBeGreaterThan(0);
+
+    // Every distinct chart per viz type gets captured: the preferred (or
+    // alphabetically-first) chart becomes the picker thumbnail, and each
+    // subsequent distinct chart fills the next declared gallery slot, so
+    // gallery images show real variety instead of the same chart resized.
+    const byVizType = new Map<string, ExampleChart[]>();
+    for (const chart of charts) {
+      const group = byVizType.get(chart.vizType) ?? [];
+      group.push(chart);
+      byVizType.set(chart.vizType, group);
+    }
+
+    const thumbnailSize = { width: THUMBNAIL_SIZE, height: THUMBNAIL_SIZE };
+    const exampleSize = { width: EXAMPLE_WIDTH, height: EXAMPLE_HEIGHT };
+    const unmapped: string[] = [];
+    const underfilledGalleries: string[] = [];
+    const failures: string[] = [];
+    for (const [vizType, group] of [...byVizType.entries()].sort()) {
+      if (vizTypeFilter && !vizTypeFilter.has(vizType)) continue;
+
+      const thumbOutput = VIZ_TYPE_THUMBNAILS[vizType];
+      const galleryOutputs = VIZ_TYPE_GALLERY[vizType] ?? [];
+      if (!thumbOutput && !galleryOutputs.length) {
+        unmapped.push(vizType);
+        continue;
+      }
+
+      // Preferred slice (if present) leads; the rest follow alphabetically.
+      group.sort((a, b) => a.sliceName.localeCompare(b.sliceName));
+      const preferredIndex = group.findIndex(
+        c => c.sliceName === PREFERRED_SLICES[vizType],
+      );
+      const ordered =
+        preferredIndex > 0
+          ? [
+              group[preferredIndex],
+              ...group.slice(0, preferredIndex),
+              ...group.slice(preferredIndex + 1),
+            ]
+          : group;
+
+      // Only advance past the thumbnail's chart when a thumbnail is
+      // actually captured (e.g. handlebars has no VIZ_TYPE_THUMBNAILS
+      // entry by design, so its gallery gets the full ordered list).
+      let nextIndex = 0;
+      if (thumbOutput) {
+        const chart = ordered[0];
+        nextIndex = 1;
+        try {
+          await captureChart(page, chart, thumbOutput, thumbnailSize);
+        } catch (error) {
+          failures.push(`${vizType} (${chart.sliceName}): ${error}`);
+        }
+      }
+
+      const missingSlots: string[] = [];
+      for (const output of galleryOutputs) {
+        const chart = ordered[nextIndex];
+        nextIndex += 1;
+        if (!chart) {
+          missingSlots.push(output);
+          continue;
+        }
+        try {
+          await captureChart(page, chart, output, exampleSize);
+        } catch (error) {
+          failures.push(`${vizType} gallery (${chart.sliceName}): ${error}`);
+        }
+      }
+      if (missingSlots.length) {
+        underfilledGalleries.push(
+          `${vizType}: not enough distinct dashboard charts for ${missingSlots.join(', ')}`,
+        );
+      }
+    }
+
+    if (unmapped.length) {
+      // eslint-disable-next-line no-console
+      console.log(
+        `viz types on dashboards with no thumbnail or gallery mapping (add to VIZ_TYPE_THUMBNAILS/VIZ_TYPE_GALLERY if wanted): ${unmapped.join(', ')}`,
+      );
+    }
+    if (underfilledGalleries.length) {
+      // eslint-disable-next-line no-console
+      console.log(
+        `gallery slots left untouched for lack of distinct example charts:\n${underfilledGalleries.join('\n')}`,
+      );
+    }
+    expect(failures, failures.join('\n')).toEqual([]);
+  });
+});
@@ -19,14 +19,14 @@
 import { t } from '@apache-superset/core/translation';
 import { Behavior, ChartMetadata, ChartPlugin } from '@superset-ui/core';
 import transformProps from './transformProps';
-import thumbnail from './images/thumbnail.png';
-import thumbnailDark from './images/thumbnail-dark.png';
-import example1 from './images/Table.jpg';
-import example1Dark from './images/Table-dark.jpg';
-import example2 from './images/Table2.jpg';
-import example2Dark from './images/Table2-dark.jpg';
-import example3 from './images/Table3.jpg';
-import example3Dark from './images/Table3-dark.jpg';
+import thumbnail from './images/custom_thumb_thumbnail.png';
+import thumbnailDark from './images/custom_thumb_thumbnail-dark.png';
+import example1 from './images/custom_thumb_Table.jpg';
+import example1Dark from './images/custom_thumb_Table-dark.jpg';
+import example2 from './images/custom_thumb_Table2.jpg';
+import example2Dark from './images/custom_thumb_Table2-dark.jpg';
+import example3 from './images/custom_thumb_Table3.jpg';
+import example3Dark from './images/custom_thumb_Table3-dark.jpg';
 import controlPanel from './controlPanel';
 import buildQuery from './buildQuery';
 import { TableChartFormData, TableChartProps } from './types';
@@ -19,8 +19,8 @@
 import { ChartMetadata, ChartPlugin } from '@superset-ui/core';
 import { t } from '@apache-superset/core/translation';
 import transformProps from './transformProps';
-import example from './images/example.jpg';
-import exampleDark from './images/example-dark.jpg';
+import example from './images/custom_thumb_example.jpg';
+import exampleDark from './images/custom_thumb_example-dark.jpg';
 import controlPanel from './controlPanel';
 import thumbnail from './images/thumbnail.png';
 import thumbnailDark from './images/thumbnail-dark.png';
@@ -21,12 +21,12 @@ import { ChartMetadata, ChartPlugin } from '@superset-ui/core';
 import buildQuery from './buildQuery';
 import controlPanel from './controlPanel';
 import transformProps from './transformProps';
-import thumbnail from '../images/thumbnail.png';
-import thumbnailDark from '../images/thumbnail-dark.png';
-import example1 from '../images/example1.png';
-import example1Dark from '../images/example1-dark.png';
-import example2 from '../images/example2.png';
-import example2Dark from '../images/example2-dark.png';
+import thumbnail from '../images/custom_thumb_thumbnail.png';
+import thumbnailDark from '../images/custom_thumb_thumbnail-dark.png';
+import example1 from '../images/custom_thumb_example1.png';
+import example1Dark from '../images/custom_thumb_example1-dark.png';
+import example2 from '../images/custom_thumb_example2.png';
+import example2Dark from '../images/custom_thumb_example2-dark.png';
 import { CartodiagramPluginConstructorOpts } from '../types';
 import { getLayerConfig } from '../util/controlPanelUtil';

@@ -19,10 +19,10 @@
 import { t } from '@apache-superset/core/translation';
 import { ChartMetadata, ChartPlugin, Behavior } from '@superset-ui/core';
 import transformProps from './transformProps';
-import exampleUsa from './images/exampleUsa.jpg';
-import exampleUsaDark from './images/exampleUsa-dark.jpg';
-import exampleGermany from './images/exampleGermany.jpg';
-import exampleGermanyDark from './images/exampleGermany-dark.jpg';
+import exampleUsa from './images/custom_thumb_exampleUsa.jpg';
+import exampleUsaDark from './images/custom_thumb_exampleUsa-dark.jpg';
+import exampleGermany from './images/custom_thumb_exampleGermany.jpg';
+import exampleGermanyDark from './images/custom_thumb_exampleGermany-dark.jpg';
 import thumbnail from './images/thumbnail.png';
 import thumbnailDark from './images/thumbnail-dark.png';
 import controlPanel from './controlPanel';
@@ -21,8 +21,8 @@ import { ChartMetadata, ChartPlugin } from '@superset-ui/core';
 import buildQuery from './buildQuery';
 import controlPanel from './controlPanel';
 import transformProps from './transformProps';
-import thumbnail from './images/thumbnail.png';
-import thumbnailDark from './images/thumbnail-dark.png';
+import thumbnail from './images/custom_thumb_thumbnail.png';
+import thumbnailDark from './images/custom_thumb_thumbnail-dark.png';

 export default class PopKPIPlugin extends ChartPlugin {
  constructor() {
@@ -25,8 +25,8 @@ import buildQuery from './buildQuery';
 import controlPanel from './controlPanel';
 import example1 from './images/example1.png';
 import example1Dark from './images/example1-dark.png';
-import example2 from './images/example2.png';
-import example2Dark from './images/example2-dark.png';
+import example2 from './images/custom_thumb_example2.png';
+import example2Dark from './images/custom_thumb_example2-dark.png';
 import { EchartsBubbleChartProps, EchartsBubbleFormData } from './types';

 // TODO: Implement cross filtering
--- a/Show More
+++ b/Show More