@digilogiclabs/saas-factory-ui 2.7.0 → 2.7.1

package/dist/web/index.d.mts

@@ -5242,6 +5242,17 @@ interface DiceRollerProps {
     showHistory?: boolean;
     /** Max entries in the history strip. Default 8. */
     historyMax?: number;
+    /**
+     * Seed the history strip from a persisted session — newest first, the
+     * same entries consumers capture from `onRoll`. One-shot: read on
+     * mount, ignored afterwards; clamped to `historyMax`. Only the strip is
+     * seeded — the dice arena and result chips stay in their pre-roll state
+     * (a settled pose can't be faithfully reproduced).
+     */
+    initialHistory?: Array<{
+        vals: number[];
+        total: number;
+    }>;
     /**
      * Imperative handle — assign a ref and call `rollRef.current?.()`
      * to trigger a roll from outside the component. Works with any
@@ -5285,7 +5296,7 @@ declare function d6LandingRotation(value: number): {
     x: number;
     y: number;
 };
-declare function DiceRoller({ count, sides, theme, darkMode, size, minSize, responsive, autoRoll, onRoll, trigger, label, iconEmoji, showHistory, historyMax, rollRef, arenaHeight: arenaHeightProp, hideResults, className, style, ariaLabel, }: DiceRollerProps): ReactNode;
+declare function DiceRoller({ count, sides, theme, darkMode, size, minSize, responsive, autoRoll, onRoll, trigger, label, iconEmoji, showHistory, historyMax, initialHistory, rollRef, arenaHeight: arenaHeightProp, hideResults, className, style, ariaLabel, }: DiceRollerProps): ReactNode;
 declare namespace DiceRoller {
     var displayName: string;
 }
@@ -5463,6 +5474,25 @@ interface CoinFlipperProps {
     showHistory?: boolean;
     /** Max entries in history. Default 20. */
     historyMax?: number;
+    /**
+     * Seed the history strip from a persisted session — newest first, the
+     * results consumers capture from `onFlip`. One-shot: read on mount,
+     * ignored afterwards; clamped to `historyMax`. The coin face stays in
+     * its pre-flip pose.
+     */
+    initialHistory?: CoinResult[];
+    /**
+     * Seed the H/T counters from a persisted session. Kept separate from
+     * `initialHistory` because stats count ALL flips while the history
+     * strip is capped at `historyMax`. One-shot: read on mount. When
+     * omitted alongside `initialHistory`, the counters are derived from the
+     * seeded strip instead (a lower bound if the strip was capped) — the
+     * history panel only renders while the counters are non-zero.
+     */
+    initialStats?: {
+        heads: number;
+        tails: number;
+    };
     /** Imperative handle — call `flipRef.current?.()` to flip externally. */
     flipRef?: MutableRefObject<(() => void) | null>;
     /** Accessible label. */
@@ -5470,7 +5500,7 @@ interface CoinFlipperProps {
     /** CSS class on root element. */
     className?: string;
 }
-declare function CoinFlipper({ theme, darkMode, size, autoFlip, onFlip, trigger, label, headsLabel, tailsLabel, showHistory, historyMax, flipRef, ariaLabel, className, }: CoinFlipperProps): react_jsx_runtime.JSX.Element;
+declare function CoinFlipper({ theme, darkMode, size, autoFlip, onFlip, trigger, label, headsLabel, tailsLabel, showHistory, historyMax, initialHistory, initialStats, flipRef, ariaLabel, className, }: CoinFlipperProps): react_jsx_runtime.JSX.Element;
 
 interface RandomPlayerParticipant {
     /** Stable identifier — required for keying and winner equality. */
@@ -5576,6 +5606,17 @@ interface RandomPlayerPickerProps {
     label?: string;
     /** Pop each winner from the pool after reveal. Default false. */
     removeWinners?: boolean;
+    /**
+     * Resume a draft from a persisted session: participant ids already
+     * drawn, newest first (the history consumers capture from `onPick`).
+     * One-shot: read on mount, ignored afterwards. Only applied when
+     * `removeWinners` is true — the drawn participants are removed from the
+     * starting pool, seeded into the pick history, and the newest one is
+     * shown on the winner card. Fail-closed: if any id doesn't resolve
+     * against `participants` (or ids repeat), the whole seed is ignored
+     * rather than half-restoring a stale draft.
+     */
+    initialDrawnIds?: string[];
     /** Spin animation duration in ms. Default 5000. */
     spinDuration?: number;
     /** Lower bound on full revolutions. Default 4. */
@@ -5665,7 +5706,7 @@ interface RandomPlayerPickerProps {
     /** Accessible label for the wheel root. */
     ariaLabel?: string;
 }
-declare function RandomPlayerPicker({ participants, mode, reelVisibleRows, reelRowHeight, theme, darkMode, size, onPick, onSpinStart, onTick, trigger, label, removeWinners, spinDuration, minRevolutions, maxRevolutions, showHistory, showControls, showStats, renderWinner, spinRef, resetRef, onPoolChange, draftCompleteCaption, intensity, enableHaptics, tickSoundUrl, winSoundUrl, soundVolume, placeholderMode, placeholderCaption, className, style, ariaLabel, }: RandomPlayerPickerProps): react_jsx_runtime.JSX.Element;
+declare function RandomPlayerPicker({ participants, mode, reelVisibleRows, reelRowHeight, theme, darkMode, size, onPick, onSpinStart, onTick, trigger, label, removeWinners, initialDrawnIds, spinDuration, minRevolutions, maxRevolutions, showHistory, showControls, showStats, renderWinner, spinRef, resetRef, onPoolChange, draftCompleteCaption, intensity, enableHaptics, tickSoundUrl, winSoundUrl, soundVolume, placeholderMode, placeholderCaption, className, style, ariaLabel, }: RandomPlayerPickerProps): react_jsx_runtime.JSX.Element;
 
 type HeroBannerTransition = "fade" | "slide" | "zoom" | "blur" | "reveal" | "push";
 type HeroBannerImageFilter = "none" | "cinematic" | "dramatic" | "cool" | "warm" | "desaturated" | "noir" | "vibrant";
@@ -6328,6 +6369,15 @@ interface RoundRobinSchedulerProps {
     onTeamsChange?: (teams: string[]) => void;
     /** Called when a new schedule is generated. */
     onGenerate?: (rounds: RoundRobinRound[]) => void;
+    /**
+     * Gate for roster edits (add / import / remove / shuffle / clear) that
+     * would discard a generated schedule. Called synchronously BEFORE the
+     * edit, and only while a schedule is on screen; return `false` to abort
+     * the edit and keep the schedule (e.g. after a declined
+     * `window.confirm`). Absent = edits discard the schedule silently, as
+     * before. Explicit "Generate Schedule" regenerations are never gated.
+     */
+    onBeforeScheduleDiscard?: (action: "add" | "import" | "remove" | "shuffle" | "clear") => boolean;
     /** Localized / customized labels. */
     labels?: RoundRobinLabels;
     /** Accessible label on the root region. */
@@ -6338,7 +6388,7 @@ interface RoundRobinSchedulerProps {
      *  roster from a spreadsheet. Default `true`. */
     enableImport?: boolean;
 }
-declare function RoundRobinScheduler({ theme, darkMode, minTeams, maxTeams, nameMaxLength, defaultTeams, resumeRounds, onTeamsChange, onGenerate, labels, ariaLabel, className, enableImport, }: RoundRobinSchedulerProps): react_jsx_runtime.JSX.Element;
+declare function RoundRobinScheduler({ theme, darkMode, minTeams, maxTeams, nameMaxLength, defaultTeams, resumeRounds, onTeamsChange, onGenerate, onBeforeScheduleDiscard, labels, ariaLabel, className, enableImport, }: RoundRobinSchedulerProps): react_jsx_runtime.JSX.Element;
 declare namespace RoundRobinScheduler {
     var displayName: string;
 }
@@ -6402,6 +6452,14 @@ interface ScoreboardProps {
      *  `onRoundAdvance` MUST clear that state here or their saved copy
      *  diverges from the screen. */
     onReset?: () => void;
+    /** Gate for the built-in Reset button. Called synchronously BEFORE any
+     *  state is cleared; return `false` to abort (e.g. after a declined
+     *  `window.confirm` when recorded rounds would be discarded). Absent =
+     *  Reset applies immediately, as before. */
+    onBeforeReset?: () => boolean;
+    /** Gate for the built-in New Game button — same contract as
+     *  `onBeforeReset`. */
+    onBeforeNewGame?: () => boolean;
     /** Max characters accepted in a team-name input. Unlimited by default. */
     nameMaxLength?: number;
     /** Localized / customized labels. */
@@ -6411,7 +6469,7 @@ interface ScoreboardProps {
     /** CSS class on root element. */
     className?: string;
 }
-declare function Scoreboard({ theme, darkMode, initialTeamCount, minTeams, maxTeams, scoreButtons, defaultTeams, initialRound, initialHistory, onTeamsChange, onRoundAdvance, onNewGame, onReset, nameMaxLength, labels, ariaLabel, className, }: ScoreboardProps): react_jsx_runtime.JSX.Element;
+declare function Scoreboard({ theme, darkMode, initialTeamCount, minTeams, maxTeams, scoreButtons, defaultTeams, initialRound, initialHistory, onTeamsChange, onRoundAdvance, onNewGame, onReset, onBeforeReset, onBeforeNewGame, nameMaxLength, labels, ariaLabel, className, }: ScoreboardProps): react_jsx_runtime.JSX.Element;
 declare namespace Scoreboard {
     var displayName: string;
 }

package/dist/web/index.d.ts

@@ -5242,6 +5242,17 @@ interface DiceRollerProps {
     showHistory?: boolean;
     /** Max entries in the history strip. Default 8. */
     historyMax?: number;
+    /**
+     * Seed the history strip from a persisted session — newest first, the
+     * same entries consumers capture from `onRoll`. One-shot: read on
+     * mount, ignored afterwards; clamped to `historyMax`. Only the strip is
+     * seeded — the dice arena and result chips stay in their pre-roll state
+     * (a settled pose can't be faithfully reproduced).
+     */
+    initialHistory?: Array<{
+        vals: number[];
+        total: number;
+    }>;
     /**
      * Imperative handle — assign a ref and call `rollRef.current?.()`
      * to trigger a roll from outside the component. Works with any
@@ -5285,7 +5296,7 @@ declare function d6LandingRotation(value: number): {
     x: number;
     y: number;
 };
-declare function DiceRoller({ count, sides, theme, darkMode, size, minSize, responsive, autoRoll, onRoll, trigger, label, iconEmoji, showHistory, historyMax, rollRef, arenaHeight: arenaHeightProp, hideResults, className, style, ariaLabel, }: DiceRollerProps): ReactNode;
+declare function DiceRoller({ count, sides, theme, darkMode, size, minSize, responsive, autoRoll, onRoll, trigger, label, iconEmoji, showHistory, historyMax, initialHistory, rollRef, arenaHeight: arenaHeightProp, hideResults, className, style, ariaLabel, }: DiceRollerProps): ReactNode;
 declare namespace DiceRoller {
     var displayName: string;
 }
@@ -5463,6 +5474,25 @@ interface CoinFlipperProps {
     showHistory?: boolean;
     /** Max entries in history. Default 20. */
     historyMax?: number;
+    /**
+     * Seed the history strip from a persisted session — newest first, the
+     * results consumers capture from `onFlip`. One-shot: read on mount,
+     * ignored afterwards; clamped to `historyMax`. The coin face stays in
+     * its pre-flip pose.
+     */
+    initialHistory?: CoinResult[];
+    /**
+     * Seed the H/T counters from a persisted session. Kept separate from
+     * `initialHistory` because stats count ALL flips while the history
+     * strip is capped at `historyMax`. One-shot: read on mount. When
+     * omitted alongside `initialHistory`, the counters are derived from the
+     * seeded strip instead (a lower bound if the strip was capped) — the
+     * history panel only renders while the counters are non-zero.
+     */
+    initialStats?: {
+        heads: number;
+        tails: number;
+    };
     /** Imperative handle — call `flipRef.current?.()` to flip externally. */
     flipRef?: MutableRefObject<(() => void) | null>;
     /** Accessible label. */
@@ -5470,7 +5500,7 @@ interface CoinFlipperProps {
     /** CSS class on root element. */
     className?: string;
 }
-declare function CoinFlipper({ theme, darkMode, size, autoFlip, onFlip, trigger, label, headsLabel, tailsLabel, showHistory, historyMax, flipRef, ariaLabel, className, }: CoinFlipperProps): react_jsx_runtime.JSX.Element;
+declare function CoinFlipper({ theme, darkMode, size, autoFlip, onFlip, trigger, label, headsLabel, tailsLabel, showHistory, historyMax, initialHistory, initialStats, flipRef, ariaLabel, className, }: CoinFlipperProps): react_jsx_runtime.JSX.Element;
 
 interface RandomPlayerParticipant {
     /** Stable identifier — required for keying and winner equality. */
@@ -5576,6 +5606,17 @@ interface RandomPlayerPickerProps {
     label?: string;
     /** Pop each winner from the pool after reveal. Default false. */
     removeWinners?: boolean;
+    /**
+     * Resume a draft from a persisted session: participant ids already
+     * drawn, newest first (the history consumers capture from `onPick`).
+     * One-shot: read on mount, ignored afterwards. Only applied when
+     * `removeWinners` is true — the drawn participants are removed from the
+     * starting pool, seeded into the pick history, and the newest one is
+     * shown on the winner card. Fail-closed: if any id doesn't resolve
+     * against `participants` (or ids repeat), the whole seed is ignored
+     * rather than half-restoring a stale draft.
+     */
+    initialDrawnIds?: string[];
     /** Spin animation duration in ms. Default 5000. */
     spinDuration?: number;
     /** Lower bound on full revolutions. Default 4. */
@@ -5665,7 +5706,7 @@ interface RandomPlayerPickerProps {
     /** Accessible label for the wheel root. */
     ariaLabel?: string;
 }
-declare function RandomPlayerPicker({ participants, mode, reelVisibleRows, reelRowHeight, theme, darkMode, size, onPick, onSpinStart, onTick, trigger, label, removeWinners, spinDuration, minRevolutions, maxRevolutions, showHistory, showControls, showStats, renderWinner, spinRef, resetRef, onPoolChange, draftCompleteCaption, intensity, enableHaptics, tickSoundUrl, winSoundUrl, soundVolume, placeholderMode, placeholderCaption, className, style, ariaLabel, }: RandomPlayerPickerProps): react_jsx_runtime.JSX.Element;
+declare function RandomPlayerPicker({ participants, mode, reelVisibleRows, reelRowHeight, theme, darkMode, size, onPick, onSpinStart, onTick, trigger, label, removeWinners, initialDrawnIds, spinDuration, minRevolutions, maxRevolutions, showHistory, showControls, showStats, renderWinner, spinRef, resetRef, onPoolChange, draftCompleteCaption, intensity, enableHaptics, tickSoundUrl, winSoundUrl, soundVolume, placeholderMode, placeholderCaption, className, style, ariaLabel, }: RandomPlayerPickerProps): react_jsx_runtime.JSX.Element;
 
 type HeroBannerTransition = "fade" | "slide" | "zoom" | "blur" | "reveal" | "push";
 type HeroBannerImageFilter = "none" | "cinematic" | "dramatic" | "cool" | "warm" | "desaturated" | "noir" | "vibrant";
@@ -6328,6 +6369,15 @@ interface RoundRobinSchedulerProps {
     onTeamsChange?: (teams: string[]) => void;
     /** Called when a new schedule is generated. */
     onGenerate?: (rounds: RoundRobinRound[]) => void;
+    /**
+     * Gate for roster edits (add / import / remove / shuffle / clear) that
+     * would discard a generated schedule. Called synchronously BEFORE the
+     * edit, and only while a schedule is on screen; return `false` to abort
+     * the edit and keep the schedule (e.g. after a declined
+     * `window.confirm`). Absent = edits discard the schedule silently, as
+     * before. Explicit "Generate Schedule" regenerations are never gated.
+     */
+    onBeforeScheduleDiscard?: (action: "add" | "import" | "remove" | "shuffle" | "clear") => boolean;
     /** Localized / customized labels. */
     labels?: RoundRobinLabels;
     /** Accessible label on the root region. */
@@ -6338,7 +6388,7 @@ interface RoundRobinSchedulerProps {
      *  roster from a spreadsheet. Default `true`. */
     enableImport?: boolean;
 }
-declare function RoundRobinScheduler({ theme, darkMode, minTeams, maxTeams, nameMaxLength, defaultTeams, resumeRounds, onTeamsChange, onGenerate, labels, ariaLabel, className, enableImport, }: RoundRobinSchedulerProps): react_jsx_runtime.JSX.Element;
+declare function RoundRobinScheduler({ theme, darkMode, minTeams, maxTeams, nameMaxLength, defaultTeams, resumeRounds, onTeamsChange, onGenerate, onBeforeScheduleDiscard, labels, ariaLabel, className, enableImport, }: RoundRobinSchedulerProps): react_jsx_runtime.JSX.Element;
 declare namespace RoundRobinScheduler {
     var displayName: string;
 }
@@ -6402,6 +6452,14 @@ interface ScoreboardProps {
      *  `onRoundAdvance` MUST clear that state here or their saved copy
      *  diverges from the screen. */
     onReset?: () => void;
+    /** Gate for the built-in Reset button. Called synchronously BEFORE any
+     *  state is cleared; return `false` to abort (e.g. after a declined
+     *  `window.confirm` when recorded rounds would be discarded). Absent =
+     *  Reset applies immediately, as before. */
+    onBeforeReset?: () => boolean;
+    /** Gate for the built-in New Game button — same contract as
+     *  `onBeforeReset`. */
+    onBeforeNewGame?: () => boolean;
     /** Max characters accepted in a team-name input. Unlimited by default. */
     nameMaxLength?: number;
     /** Localized / customized labels. */
@@ -6411,7 +6469,7 @@ interface ScoreboardProps {
     /** CSS class on root element. */
     className?: string;
 }
-declare function Scoreboard({ theme, darkMode, initialTeamCount, minTeams, maxTeams, scoreButtons, defaultTeams, initialRound, initialHistory, onTeamsChange, onRoundAdvance, onNewGame, onReset, nameMaxLength, labels, ariaLabel, className, }: ScoreboardProps): react_jsx_runtime.JSX.Element;
+declare function Scoreboard({ theme, darkMode, initialTeamCount, minTeams, maxTeams, scoreButtons, defaultTeams, initialRound, initialHistory, onTeamsChange, onRoundAdvance, onNewGame, onReset, onBeforeReset, onBeforeNewGame, nameMaxLength, labels, ariaLabel, className, }: ScoreboardProps): react_jsx_runtime.JSX.Element;
 declare namespace Scoreboard {
     var displayName: string;
 }

package/dist/web/index.js

@@ -30539,6 +30539,7 @@ function DiceRoller({
   iconEmoji = "\u{1F3B2}",
   showHistory = false,
   historyMax = 8,
+  initialHistory,
   rollRef,
   arenaHeight: arenaHeightProp,
   hideResults = false,
@@ -30550,7 +30551,9 @@ function DiceRoller({
   const dark = useDarkMode(darkMode);
   const [rolling, setRolling] = (0, import_react69.useState)(false);
   const [results, setResults] = (0, import_react69.useState)(null);
-  const [history, setHistory] = (0, import_react69.useState)([]);
+  const [history, setHistory] = (0, import_react69.useState)(
+    () => initialHistory && initialHistory.length > 0 ? initialHistory.slice(0, historyMax) : []
+  );
   const dieWrapperRefs = (0, import_react69.useRef)([]);
   const cubeRefs = (0, import_react69.useRef)([]);
   const shadowRefs = (0, import_react69.useRef)([]);
@@ -30724,7 +30727,10 @@ function DiceRoller({
     defaultPositions,
     half
   ]);
+  const prevSidesRef = (0, import_react69.useRef)(sides);
   (0, import_react69.useEffect)(() => {
+    if (prevSidesRef.current === sides) return;
+    prevSidesRef.current = sides;
     setHistory([]);
   }, [sides]);
   const roll = (0, import_react69.useCallback)(() => {
@@ -32793,6 +32799,8 @@ function CoinFlipper({
   tailsLabel = "Tails",
   showHistory = false,
   historyMax = 20,
+  initialHistory,
+  initialStats,
   flipRef,
   ariaLabel,
   className = ""
@@ -32801,8 +32809,23 @@ function CoinFlipper({
   const tc = typeof theme5 === "string" ? PRESETS3[theme5] || PRESETS3.gold : theme5;
   const [result, setResult] = (0, import_react71.useState)(null);
   const [flipping, setFlipping] = (0, import_react71.useState)(false);
-  const [history, setHistory] = (0, import_react71.useState)([]);
-  const [stats, setStats] = (0, import_react71.useState)({ heads: 0, tails: 0 });
+  const [history, setHistory] = (0, import_react71.useState)(
+    () => initialHistory && initialHistory.length > 0 ? initialHistory.slice(0, historyMax).map((result2, i) => ({ result: result2, id: -(i + 1) })) : []
+  );
+  const [stats, setStats] = (0, import_react71.useState)(() => {
+    if (initialStats) {
+      return {
+        heads: Math.max(0, Math.floor(initialStats.heads)),
+        tails: Math.max(0, Math.floor(initialStats.tails))
+      };
+    }
+    if (initialHistory && initialHistory.length > 0) {
+      const seeded = initialHistory.slice(0, historyMax);
+      const heads = seeded.filter((r) => r === "heads").length;
+      return { heads, tails: seeded.length - heads };
+    }
+    return { heads: 0, tails: 0 };
+  });
   const flipIdRef = (0, import_react71.useRef)(0);
   const coinRef = (0, import_react71.useRef)(null);
   const shadowRef = (0, import_react71.useRef)(null);
@@ -33731,6 +33754,23 @@ function ReelStage({
     }
   );
 }
+function computeDraftSeed(participants, drawnIds, removeWinners) {
+  if (!removeWinners || !drawnIds || drawnIds.length === 0) return null;
+  if (new Set(drawnIds).size !== drawnIds.length) return null;
+  const byId = new Map(participants.map((p) => [p.id, p]));
+  const drawn = [];
+  for (const id of drawnIds) {
+    const p = byId.get(id);
+    if (!p) return null;
+    drawn.push(p);
+  }
+  const drawnSet = new Set(drawnIds);
+  return {
+    pool: participants.filter((p) => !drawnSet.has(p.id)),
+    // Same cap as the live history (see the pop/promote paths).
+    history: drawn.slice(0, 20)
+  };
+}
 function RandomPlayerPicker({
   participants,
   mode = "wheel",
@@ -33745,6 +33785,7 @@ function RandomPlayerPicker({
   trigger = "button",
   label = "Spin",
   removeWinners = false,
+  initialDrawnIds,
   spinDuration = 5e3,
   minRevolutions = 4,
   maxRevolutions = 7,
@@ -33771,12 +33812,21 @@ function RandomPlayerPicker({
   const reducedMotion = usePrefersReducedMotion();
   const intensityCfg = INTENSITY_CONFIG[intensity];
   const physicsDriven = intensity === "dramatic" && !reducedMotion;
-  const [pool, setPool] = (0, import_react73.useState)(participants);
+  const [draftSeed] = (0, import_react73.useState)(
+    () => computeDraftSeed(participants, initialDrawnIds, removeWinners)
+  );
+  const [pool, setPool] = (0, import_react73.useState)(
+    draftSeed ? draftSeed.pool : participants
+  );
   const [rotation, setRotation] = (0, import_react73.useState)(0);
   const [reelY, setReelY] = (0, import_react73.useState)(0);
   const [spinning, setSpinning] = (0, import_react73.useState)(false);
-  const [winner, setWinner] = (0, import_react73.useState)(null);
-  const [history, setHistory] = (0, import_react73.useState)([]);
+  const [winner, setWinner] = (0, import_react73.useState)(
+    draftSeed ? draftSeed.history[0] ?? null : null
+  );
+  const [history, setHistory] = (0, import_react73.useState)(
+    draftSeed ? draftSeed.history : []
+  );
   const [revealKey, setRevealKey] = (0, import_react73.useState)(0);
   const [particles, setParticles] = (0, import_react73.useState)([]);
   const winnerTimer = (0, import_react73.useRef)(null);
@@ -33788,7 +33838,9 @@ function RandomPlayerPicker({
   const tickAudioRef = (0, import_react73.useRef)(null);
   const winAudioRef = (0, import_react73.useRef)(null);
   const containerRef = (0, import_react73.useRef)(null);
-  const prevIdsRef = (0, import_react73.useRef)("");
+  const prevIdsRef = (0, import_react73.useRef)(
+    draftSeed ? participants.map((p) => p.id).join("|") : ""
+  );
   const wheelSvgRef = (0, import_react73.useRef)(null);
   const reelTapeRef = (0, import_react73.useRef)(null);
   const rafRef = (0, import_react73.useRef)(null);
@@ -40706,6 +40758,7 @@ function RoundRobinScheduler({
   resumeRounds,
   onTeamsChange,
   onGenerate,
+  onBeforeScheduleDiscard,
   labels,
   ariaLabel = "Round robin scheduler",
   className,
@@ -40741,23 +40794,29 @@ function RoundRobinScheduler({
     },
     [maxTeams, nameMaxLength]
   );
+  const gateDiscard = (0, import_react79.useCallback)(
+    (action) => rounds.length === 0 || !onBeforeScheduleDiscard || onBeforeScheduleDiscard(action),
+    [rounds.length, onBeforeScheduleDiscard]
+  );
   const addTeams = (0, import_react79.useCallback)(
     (raw) => {
       const names = raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
       if (names.length === 0) return;
+      if (!gateDiscard("add")) return;
       setTeams((prev) => mergeNames(prev, names));
       setInput("");
       setRounds([]);
     },
-    [mergeNames]
+    [mergeNames, gateDiscard]
   );
   const importTeams = (0, import_react79.useCallback)(
     (incoming) => {
       if (incoming.length === 0) return;
+      if (!gateDiscard("import")) return;
       setTeams((prev) => mergeNames(prev, incoming));
       setRounds([]);
     },
-    [mergeNames]
+    [mergeNames, gateDiscard]
   );
   const handleKeyDown = (0, import_react79.useCallback)(
     (e) => {
@@ -40768,10 +40827,14 @@ function RoundRobinScheduler({
     },
     [addTeams, input]
   );
-  const removeTeam = (0, import_react79.useCallback)((idx) => {
-    setTeams((prev) => prev.filter((_, i) => i !== idx));
-    setRounds([]);
-  }, []);
+  const removeTeam = (0, import_react79.useCallback)(
+    (idx) => {
+      if (!gateDiscard("remove")) return;
+      setTeams((prev) => prev.filter((_, i) => i !== idx));
+      setRounds([]);
+    },
+    [gateDiscard]
+  );
   const handleGenerate = (0, import_react79.useCallback)(() => {
     if (teams.length < minTeams) return;
     const result = generateSchedule(teams, L.roundLabel);
@@ -40779,15 +40842,17 @@ function RoundRobinScheduler({
     onGenerate?.(result);
   }, [teams, minTeams, L.roundLabel, onGenerate]);
   const handleShuffle = (0, import_react79.useCallback)(() => {
+    if (!gateDiscard("shuffle")) return;
     setTeams((prev) => shuffle(prev));
     setRounds([]);
-  }, []);
+  }, [gateDiscard]);
   const handleClear = (0, import_react79.useCallback)(() => {
+    if (!gateDiscard("clear")) return;
     setTeams([]);
     setRounds([]);
     setInput("");
     inputRef.current?.focus();
-  }, []);
+  }, [gateDiscard]);
   const canGenerate = teams.length >= minTeams;
   const rootStyle = {
     borderRadius: 16,
@@ -41248,6 +41313,8 @@ function Scoreboard({
   onRoundAdvance,
   onNewGame,
   onReset,
+  onBeforeReset,
+  onBeforeNewGame,
   nameMaxLength,
   labels,
   ariaLabel = "Scoreboard",
@@ -41319,19 +41386,21 @@ function Scoreboard({
     [minTeams]
   );
   const resetScores = (0, import_react80.useCallback)(() => {
+    if (onBeforeReset && !onBeforeReset()) return;
     setTeams((prev) => prev.map((t) => ({ ...t, score: 0 })));
     setRound(1);
     setHistory([]);
     setHistoryOpen(false);
     onReset?.();
-  }, [onReset]);
+  }, [onReset, onBeforeReset]);
   const newGame = (0, import_react80.useCallback)(() => {
+    if (onBeforeNewGame && !onBeforeNewGame()) return;
     setTeams(createDefaultTeams(seedCount, L.teamNamePrefix));
     setRound(1);
     setHistory([]);
     setHistoryOpen(false);
     onNewGame?.();
-  }, [seedCount, L.teamNamePrefix, onNewGame]);
+  }, [seedCount, L.teamNamePrefix, onNewGame, onBeforeNewGame]);
   const nextRound = (0, import_react80.useCallback)(() => {
     const snapshot = {
       round,