feat(x01-bust-active-player-highlight): enhance visual effects with configurable crack overlays

- Updated the `FEATURES.md` to describe new glass crack effects during BUST.
- Incremented version numbers to 2.4.3 across relevant files.
- Modified feature configuration to include `crackCount` for controlling the number of glass cracks displayed.
- Implemented rendering logic for glass cracks in the `x01-bust-active-player-highlight` feature.
- Added new styles for crack overlays and animations.
- Updated UI descriptors and copy to reflect new feature capabilities.
- Enhanced tests to cover new crack rendering functionality and ensure stability of existing features.

Author: thomasasen

CHANGELOG.md

@@ -12,6 +12,13 @@ zum nächsten Release-Commit vorübergehend auf `HEAD` zeigen.
 Dieses Repository führt keine `Unreleased`-Sektion. Jeder dokumentierte Eintrag gehört
 direkt zu einer versionierten Release-Sektion.
 
+## [2.4.3] - 2026-06-19
+
+### Added
+
+- Nutzerwirkung: `X01 Bust Active Player Highlight` kann beim Überwurf sofort bis zu drei zufällig platzierte Glasrisse auf der aktiven Spielerkarte anzeigen; die Anzahl ist in xConfig von `Aus` bis `3` wählbar.
+  Technik: Der Bust-Flankenwechsel erzeugt ein größenabhängiges SVG-Overlay mit den Geometrie-, Reflexions-, Fraktur-, Mainline- und Noise-Parametern der Glass-Crack-Canvas-Demo, begrenzt die Konfiguration auf `0–3` und räumt alle Effektknoten beim Bust-Ende oder Unmount auf.
+
 ## [2.4.2] - 2026-06-18
 
 ### Added
@@ -1724,7 +1731,8 @@ direkt zu einer versionierten Release-Sektion.
   und Regressionstests eingeführt und die generierten README-/FEATURES-Texte wurden
   entsprechend synchronisiert.
 
-[2.4.2]: https://github.com/thomasasen/autodarts-xconfig/compare/24f6686...HEAD
+[2.4.3]: https://github.com/thomasasen/autodarts-xconfig/compare/73900ce...HEAD
+[2.4.2]: https://github.com/thomasasen/autodarts-xconfig/compare/24f6686...73900ce
 [2.4.1]: https://github.com/thomasasen/autodarts-xconfig/compare/3803021...24f6686
 [2.4.0]: https://github.com/thomasasen/autodarts-xconfig/compare/55a936b...3803021
 [2.3.21]: https://github.com/thomasasen/autodarts-xconfig/compare/09ae6b2...55a936b

README.md

@@ -919,11 +919,16 @@ Die Aktion `Empfohlene Standards` wendet aktuell dieses Profil an:
 
 - Gilt für: `X01`
 - Was macht es sichtbar? Bei sichtbarem `BUST` übernimmt die aktive X01-Spielerkarte Hintergrund und Rahmen der roten Wurfkacheln.
-- Grafisch: Beim Eintritt in BUST wackelt die aktive Karte drei Sekunden im schnellen Earthquake-Stil. Danach bleibt die rote Wurfkachel-Färbung auf der aktiven Karte stehen, bis `BUST` verschwindet.
+- Grafisch: Beim Eintritt in BUST erscheinen die konfigurierten Glasrisse sofort an zufälligen Stellen und die aktive Karte wackelt drei Sekunden im schnellen Earthquake-Stil. Danach bleiben Glasrisse und rote Wurfkachel-Färbung stehen, bis `BUST` verschwindet.
 - Wann sinnvoll? Wenn ein Überwurf sofort am aktiven Spieler auffallen soll.
 
 **Einstellungen einfach erklärt**
 
+- `Anzahl Glasrisse`: Erzeugt beim Eintritt in BUST die gewählte Anzahl Glasrisse an zufälligen Positionen innerhalb der aktiven Spielerkarte. `Aus` lässt Markierung und Wackeln aktiv.
+  - `Aus`: Deaktiviert nur die Glasriss-Overlays. Die rote BUST-Markierung und der Earthquake-Effekt der aktiven Spielerkarte bleiben unverändert aktiv.
+  - `1`: Erzeugt beim Eintritt in BUST ein einzelnes zufällig platziertes Einschlagzentrum mit Glasrissstruktur auf der aktiven Spielerkarte.
+  - `2`: Erzeugt beim Eintritt in BUST zwei voneinander unabhängige Einschlagzentren und verteilt sie zufällig auf der aktiven Spielerkarte.
+  - `3`: Erzeugt beim Eintritt in BUST drei zufällig verteilte Einschlagzentren. Diese Stufe füllt die aktive Spielerkarte am stärksten mit Glasrissstrukturen.
 - `Debug`: Aktiviert zusätzliche Debug-Ausgaben und Diagnosehinweise. Für den normalen Spielbetrieb ist die Option nicht gedacht und sollte in der Regel ausgeschaltet bleiben.
 
 ![X01 Bust Active Player Highlight](docs/screenshots/animation-x01-bust-active-player-highlight.gif)

dist/autodarts-xconfig.meta.js

@@ -1,7 +1,7 @@
 // ==UserScript==
 // @name         autodarts-xconfig
 // @namespace    https://github.com/thomasasen/autodarts-xconfig
-// @version      2.4.2
+// @version      2.4.3
 // @description  Modular, side-effect resistant Tampermonkey runtime for Autodarts enhancements.
 // @author       Thomas Asen
 // @license      MIT

dist/autodarts-xconfig.user.js

@@ -674,7 +674,12 @@ Die Aktion `Empfohlene Standards` wendet aktuell dieses Profil an:
 
 - Gilt für: `X01`
 - Kurz: Bei sichtbarem `BUST` übernimmt die aktive X01-Spielerkarte Hintergrund und Rahmen der roten Wurfkacheln.
-- Grafisch: Beim Eintritt in BUST wackelt die aktive Karte drei Sekunden im schnellen Earthquake-Stil. Danach bleibt die rote Wurfkachel-Färbung auf der aktiven Karte stehen, bis `BUST` verschwindet.
+- Grafisch: Beim Eintritt in BUST erscheinen die konfigurierten Glasrisse sofort an zufälligen Stellen und die aktive Karte wackelt drei Sekunden im schnellen Earthquake-Stil. Danach bleiben Glasrisse und rote Wurfkachel-Färbung stehen, bis `BUST` verschwindet.
+- `Anzahl Glasrisse`: Bestimmt die Anzahl zufällig platzierter Glasrisse.
+  - `Aus`: Keine Glasrisse; Rotmarkierung und Wackeln bleiben aktiv.
+  - `1`: Zeigt ein zufällig platziertes Einschlagzentrum.
+  - `2`: Zeigt zwei zufällig und unabhängig platzierte Einschlagzentren.
+  - `3`: Zeigt drei Einschlagzentren und damit die dichteste Darstellung.
 - `Debug`: Aktiviert zusätzliche Debug-Ausgaben für die Fehlersuche.
 
 ![X01 Bust Active Player Highlight](screenshots/animation-x01-bust-active-player-highlight.gif)

docs/FEATURES.md

@@ -1,7 +1,7 @@
 // ==UserScript==
 // @name         autodarts-xconfig
 // @namespace    https://github.com/thomasasen/autodarts-xconfig
-// @version      2.4.2
+// @version      2.4.3
 // @description  Modular, side-effect resistant Tampermonkey runtime for Autodarts enhancements.
 // @author       Thomas Asen
 // @license      MIT

loader/autodarts-xconfig.user.js

@@ -1,6 +1,6 @@
 {
   "name": "autodarts-xconfig",
-  "version": "2.4.2",
+  "version": "2.4.3",
   "description": "Clean successor architecture for autodarts xConfig userscript modules",
   "type": "module",
   "imports": {

package-lock.json

@@ -366,7 +366,7 @@ const DEFAULT_FEATURE_CONFIGS = Object.freeze({
   checkoutTargetHighlights: { enabled: false, visualPreset: "soft-pulse", segmentStyle: "surface-outline", singleRing: "both", targetSelectionMode: "next", colorTheme: "amber", debug: false },
   tvBoardZoom: { enabled: false, zoomLevel: 2.75, zoomSpeed: "mittel", checkoutZoomEnabled: true, checkoutZoomTarget: "finish-only", t20SetupZoomEnabled: true, debug: false },
   checkoutSuggestionStyles: { enabled: false, style: "ribbon", labelText: "CHECKOUT", colorTheme: "amber", debug: false },
-  x01BustActivePlayerHighlight: { enabled: true, debug: false },
+  x01BustActivePlayerHighlight: { enabled: true, crackCount: 3, debug: false },
   avgTrendArrow: { enabled: false, durationMs: 320, size: "standard", debug: false },
   activePlayerSweep: { enabled: false, durationMs: 420, sweepStyle: "standard", debug: false },
   specialHitHighlights: { enabled: false, colorTheme: "kind-signal", animationStyle: "pop-hit", debug: false },
@@ -420,7 +420,7 @@ const RECOMMENDED_FEATURE_CONFIGS = Object.freeze({
   checkoutTargetHighlights: { visualPreset: "fast-blink", segmentStyle: "surface-only", singleRing: "both", targetSelectionMode: "next", colorTheme: "cyan" },
   tvBoardZoom: { zoomLevel: 2.75, zoomSpeed: "mittel", checkoutZoomEnabled: true, checkoutZoomTarget: "finish-only", t20SetupZoomEnabled: true },
   checkoutSuggestionStyles: { style: "stripe", labelText: "CHECKOUT", colorTheme: "amber" },
-  x01BustActivePlayerHighlight: {},
+  x01BustActivePlayerHighlight: { crackCount: 3 },
   avgTrendArrow: { durationMs: 320, size: "standard" },
   activePlayerSweep: { durationMs: 420, sweepStyle: "standard" },
   specialHitHighlights: { colorTheme: "kind-signal", animationStyle: "electric-jolt" },
@@ -706,7 +706,7 @@ const FEATURE_NORMALIZERS = Object.freeze({
     return { enabled: normalizeBoolean(rawConfig.enabled, false), style: normalizeStringChoice(rawConfig.style, "ribbon", SUGGESTION_STYLES), labelText: normalizeMappedStringChoice(rawConfig.labelText, "CHECKOUT", { "": "", checkout: "CHECKOUT", finish: "FINISH" }), colorTheme: normalizeStringChoice(rawConfig.colorTheme, "amber", SUGGESTION_COLOR_THEMES), debug: normalizeBoolean(rawConfig.debug, false) };
   },
   x01BustActivePlayerHighlight(rawConfig = {}) {
-    return { enabled: normalizeBoolean(rawConfig.enabled, true), debug: normalizeBoolean(rawConfig.debug, false) };
+    return { enabled: normalizeBoolean(rawConfig.enabled, true), crackCount: normalizeNumberChoice(rawConfig.crackCount, 3, new Set([0, 1, 2, 3])), debug: normalizeBoolean(rawConfig.debug, false) };
   },
   avgTrendArrow(rawConfig = {}) {
     return { enabled: normalizeBoolean(rawConfig.enabled, false), durationMs: normalizeNumberChoice(rawConfig.durationMs, 320, AVG_TREND_DURATIONS), size: normalizeMappedStringChoice(rawConfig.size, "standard", { klein: "klein", small: "klein", standard: "standard", gross: "gross", ["gro" + "\u00df"]: "gross", big: "gross", large: "gross" }), debug: normalizeBoolean(rawConfig.debug, false) };

package.json

@@ -13,7 +13,7 @@ import { createListenerRegistry } from "./listener-registry.js";
 import { createObserverRegistry } from "./observer-registry.js";
 
 const GLOBAL_NAMESPACE_KEY = "__adXConfig";
-const API_VERSION = "2.4.2";
+const API_VERSION = "2.4.3";
 const STARTUP_DEFER_INTERVAL_MS = 16;
 
 function getWindowTimerApi(windowRef) {