@digilogiclabs/saas-factory-ui 2.3.0 → 2.4.0

package/dist/index.d.mts

@@ -4626,7 +4626,9 @@ declare function TiltCard({ accent, accentSecondary, topLabel, icon, title, subt
  *   - Three trigger modes: built-in button / click anywhere / external
  *     imperative handle via `rollRef.current()`
  *   - Optional roll history strip
- *   - Honors `prefers-reduced-motion` (skips physics animation)
+ *   - Deliberately tumbles even under `prefers-reduced-motion` — a dice
+ *     roll is a safe animation and skipping it leaves no feedback at all
+ *     (see the note inside `roll()`)
  *   - Zero Tailwind dependency — all styles inline
  *
  * Ported to TypeScript and generalized for saas-factory-ui from a
@@ -5728,6 +5730,14 @@ interface RoundRobinSchedulerProps {
     darkMode?: boolean;
     /** Minimum teams required to generate a schedule. Default 3. */
     minTeams?: number;
+    /** Maximum roster size. Adds/imports beyond this are ignored. Unlimited
+     *  by default — consumers persisting the roster against a capped schema
+     *  should set this to the schema cap. */
+    maxTeams?: number;
+    /** Max characters per team name. Longer typed/imported names are
+     *  truncated (matching native input maxLength paste behavior).
+     *  Unlimited by default. */
+    nameMaxLength?: number;
     /** Initial roster. Uncontrolled. */
     defaultTeams?: string[];
     /**
@@ -5753,7 +5763,7 @@ interface RoundRobinSchedulerProps {
      *  roster from a spreadsheet. Default `true`. */
     enableImport?: boolean;
 }
-declare function RoundRobinScheduler({ theme, darkMode, minTeams, 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, labels, ariaLabel, className, enableImport, }: RoundRobinSchedulerProps): react_jsx_runtime.JSX.Element;
 declare namespace RoundRobinScheduler {
     var displayName: string;
 }
@@ -5812,6 +5822,13 @@ interface ScoreboardProps {
     onRoundAdvance?: (snapshot: ScoreboardRoundSnapshot) => void;
     /** Called when the user presses "New Game". */
     onNewGame?: () => void;
+    /** Called when the user presses "Reset" (scores zeroed, round counter and
+     *  history cleared, names kept). Consumers persisting round/history via
+     *  `onRoundAdvance` MUST clear that state here or their saved copy
+     *  diverges from the screen. */
+    onReset?: () => void;
+    /** Max characters accepted in a team-name input. Unlimited by default. */
+    nameMaxLength?: number;
     /** Localized / customized labels. */
     labels?: ScoreboardLabels;
     /** Accessible label on the root region. */
@@ -5819,7 +5836,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, 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, nameMaxLength, labels, ariaLabel, className, }: ScoreboardProps): react_jsx_runtime.JSX.Element;
 declare namespace Scoreboard {
     var displayName: string;
 }

package/dist/index.d.ts

@@ -4626,7 +4626,9 @@ declare function TiltCard({ accent, accentSecondary, topLabel, icon, title, subt
  *   - Three trigger modes: built-in button / click anywhere / external
  *     imperative handle via `rollRef.current()`
  *   - Optional roll history strip
- *   - Honors `prefers-reduced-motion` (skips physics animation)
+ *   - Deliberately tumbles even under `prefers-reduced-motion` — a dice
+ *     roll is a safe animation and skipping it leaves no feedback at all
+ *     (see the note inside `roll()`)
  *   - Zero Tailwind dependency — all styles inline
  *
  * Ported to TypeScript and generalized for saas-factory-ui from a
@@ -5728,6 +5730,14 @@ interface RoundRobinSchedulerProps {
     darkMode?: boolean;
     /** Minimum teams required to generate a schedule. Default 3. */
     minTeams?: number;
+    /** Maximum roster size. Adds/imports beyond this are ignored. Unlimited
+     *  by default — consumers persisting the roster against a capped schema
+     *  should set this to the schema cap. */
+    maxTeams?: number;
+    /** Max characters per team name. Longer typed/imported names are
+     *  truncated (matching native input maxLength paste behavior).
+     *  Unlimited by default. */
+    nameMaxLength?: number;
     /** Initial roster. Uncontrolled. */
     defaultTeams?: string[];
     /**
@@ -5753,7 +5763,7 @@ interface RoundRobinSchedulerProps {
      *  roster from a spreadsheet. Default `true`. */
     enableImport?: boolean;
 }
-declare function RoundRobinScheduler({ theme, darkMode, minTeams, 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, labels, ariaLabel, className, enableImport, }: RoundRobinSchedulerProps): react_jsx_runtime.JSX.Element;
 declare namespace RoundRobinScheduler {
     var displayName: string;
 }
@@ -5812,6 +5822,13 @@ interface ScoreboardProps {
     onRoundAdvance?: (snapshot: ScoreboardRoundSnapshot) => void;
     /** Called when the user presses "New Game". */
     onNewGame?: () => void;
+    /** Called when the user presses "Reset" (scores zeroed, round counter and
+     *  history cleared, names kept). Consumers persisting round/history via
+     *  `onRoundAdvance` MUST clear that state here or their saved copy
+     *  diverges from the screen. */
+    onReset?: () => void;
+    /** Max characters accepted in a team-name input. Unlimited by default. */
+    nameMaxLength?: number;
     /** Localized / customized labels. */
     labels?: ScoreboardLabels;
     /** Accessible label on the root region. */
@@ -5819,7 +5836,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, 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, nameMaxLength, labels, ariaLabel, className, }: ScoreboardProps): react_jsx_runtime.JSX.Element;
 declare namespace Scoreboard {
     var displayName: string;
 }

package/dist/index.js

@@ -30719,7 +30719,6 @@ function DiceRoller({
 }) {
   const clampedCount = Math.max(1, Math.min(MAX_COUNT, count2));
   const dark = useDarkMode(darkMode);
-  const reducedMotion = usePrefersReducedMotion();
   const [rolling, setRolling] = (0, import_react68.useState)(false);
   const [results, setResults] = (0, import_react68.useState)(null);
   const [history, setHistory] = (0, import_react68.useState)([]);
@@ -30856,6 +30855,14 @@ function DiceRoller({
     []
   );
   (0, import_react68.useEffect)(() => {
+    if (timersRef.current.length > 0) {
+      timersRef.current.forEach((t) => clearTimeout(t));
+      timersRef.current = [];
+    }
+    if (rollingRef.current) {
+      rollingRef.current = false;
+      setRolling(false);
+    }
     const rawW = arenaRef.current?.offsetWidth ?? 0;
     const rawH = arenaRef.current?.offsetHeight ?? 0;
     const w = rawW > 20 ? rawW : arena.w > 20 ? arena.w : 400;
@@ -31012,7 +31019,6 @@ function DiceRoller({
     defaultPositions,
     effectiveSize,
     half,
-    reducedMotion,
     onRoll,
     writeCubeRotation,
     writeDiePosition,
@@ -33025,6 +33031,9 @@ function CoinFlipper({
   }, [flipping, onFlip, historyMax]);
   (0, import_react70.useEffect)(() => {
     if (flipRef) flipRef.current = flip;
+    return () => {
+      if (flipRef && flipRef.current === flip) flipRef.current = null;
+    };
   }, [flip, flipRef]);
   (0, import_react70.useEffect)(() => {
     if (autoFlip) {
@@ -33916,6 +33925,8 @@ function RandomPlayerPicker({
   const particleTimer = (0, import_react71.useRef)(null);
   const popTimer = (0, import_react71.useRef)(null);
   const tickInterval = (0, import_react71.useRef)(null);
+  const pendingPopIdxRef = (0, import_react71.useRef)(null);
+  const removeWinnersRef = (0, import_react71.useRef)(removeWinners);
   const tickAudioRef = (0, import_react71.useRef)(null);
   const winAudioRef = (0, import_react71.useRef)(null);
   const containerRef = (0, import_react71.useRef)(null);
@@ -33954,10 +33965,27 @@ function RandomPlayerPicker({
       winAudioRef.current = null;
     };
   }, [winSoundUrl, soundVolume]);
+  (0, import_react71.useEffect)(() => {
+    removeWinnersRef.current = removeWinners;
+  }, [removeWinners]);
   (0, import_react71.useEffect)(() => {
     const ids = participants.map((p) => p.id).join("|");
     const structuralChange = ids !== prevIdsRef.current;
     if (structuralChange) {
+      if (winnerTimer.current) {
+        clearTimeout(winnerTimer.current);
+        winnerTimer.current = null;
+      }
+      if (tickInterval.current) {
+        clearTimeout(tickInterval.current);
+        tickInterval.current = null;
+      }
+      if (popTimer.current) {
+        clearTimeout(popTimer.current);
+        popTimer.current = null;
+      }
+      pendingPopIdxRef.current = null;
+      setSpinning(false);
       setPool(participants);
       setHistory([]);
       setWinner(null);
@@ -34014,33 +34042,50 @@ function RandomPlayerPicker({
     [dark]
   );
   const spin = (0, import_react71.useCallback)(() => {
-    if (spinning || n < 2) return;
+    if (spinning) return;
+    let activePool = pool;
+    if (popTimer.current) {
+      clearTimeout(popTimer.current);
+      popTimer.current = null;
+      const pendingIdx = pendingPopIdxRef.current;
+      pendingPopIdxRef.current = null;
+      if (pendingIdx != null && pendingIdx >= 0 && pendingIdx < pool.length && removeWinnersRef.current) {
+        activePool = pool.filter((_, i) => i !== pendingIdx);
+        setPool(activePool);
+        setWinner(null);
+      }
+    }
+    const activeN = activePool.length;
+    if (activeN < 2) return;
+    const activeAnglePerWedge = 2 * Math.PI / activeN;
+    const activeRotation = rotation;
+    const activeReelY = reelY;
     onSpinStart?.();
-    const winnerIdx = weightedIndex(pool);
+    const winnerIdx = weightedIndex(activePool);
     const minRev = minRevolutions + intensityCfg.revsBoost;
     const maxRev = maxRevolutions + intensityCfg.revsBoost;
     const minFullRevs = Math.ceil(minRev);
     const maxFullRevs = Math.max(minFullRevs, Math.floor(maxRev));
     const revolutions = minFullRevs + Math.floor(Math.random() * (maxFullRevs - minFullRevs + 1));
-    const wedgeMidRad = winnerIdx * anglePerWedge + anglePerWedge / 2;
+    const wedgeMidRad = winnerIdx * activeAnglePerWedge + activeAnglePerWedge / 2;
     const wedgeMidDeg = wedgeMidRad * 180 / Math.PI;
-    const wheelWobble = (Math.random() - 0.5) * (anglePerWedge * 180 / Math.PI) * 0.6;
-    const currentMod = (rotation % 360 + 360) % 360;
+    const wheelWobble = (Math.random() - 0.5) * (activeAnglePerWedge * 180 / Math.PI) * 0.6;
+    const currentMod = (activeRotation % 360 + 360) % 360;
     const targetMod = ((-wedgeMidDeg + wheelWobble) % 360 + 360) % 360;
     let deltaMod = targetMod - currentMod;
     if (deltaMod < 0) deltaMod += 360;
-    const finalRotation = rotation + deltaMod + revolutions * 360;
+    const finalRotation = activeRotation + deltaMod + revolutions * 360;
     const centerOffsetRows = (reelVisibleRows - 1) / 2;
     const centerOffsetPx = centerOffsetRows * reelRowHeight;
     const currentCenterRow = Math.round(
-      (reelY + centerOffsetPx) / reelRowHeight
+      (activeReelY + centerOffsetPx) / reelRowHeight
     );
-    const currentCenterMod = mod(currentCenterRow, n);
-    const targetRowOffset = (winnerIdx - currentCenterMod + n) % n;
-    const reelRevRows = Math.round(revolutions * n);
-    const finalReelY = reelY + (reelRevRows + targetRowOffset) * reelRowHeight;
-    const settledWinnerIdx = mode === "reel" ? reelIndexAtCenter(finalReelY, centerOffsetPx, reelRowHeight, n) : wheelIndexAtPointer(finalRotation, n);
-    const finalWinnerIdx = settledWinnerIdx >= 0 && settledWinnerIdx < pool.length ? settledWinnerIdx : winnerIdx;
+    const currentCenterMod = mod(currentCenterRow, activeN);
+    const targetRowOffset = (winnerIdx - currentCenterMod + activeN) % activeN;
+    const reelRevRows = Math.round(revolutions * activeN);
+    const finalReelY = activeReelY + (reelRevRows + targetRowOffset) * reelRowHeight;
+    const settledWinnerIdx = mode === "reel" ? reelIndexAtCenter(finalReelY, centerOffsetPx, reelRowHeight, activeN) : wheelIndexAtPointer(finalRotation, activeN);
+    const finalWinnerIdx = settledWinnerIdx >= 0 && settledWinnerIdx < activePool.length ? settledWinnerIdx : winnerIdx;
     const effectiveDuration = reducedMotion ? 250 : Math.round(spinDuration * intensityCfg.durationMult);
     setSpinning(true);
     setWinner(null);
@@ -34053,7 +34098,7 @@ function RandomPlayerPicker({
     if ((onTick || tickAudioRef.current) && !reducedMotion) {
       const wedges = mode === "reel" ? Math.max(1, reelRevRows + targetRowOffset) : (() => {
         const totalDelta = deltaMod + revolutions * 360;
-        const wedgeDeg = anglePerWedge * 180 / Math.PI;
+        const wedgeDeg = activeAnglePerWedge * 180 / Math.PI;
         return Math.max(
           1,
           Math.round(totalDelta / Math.max(wedgeDeg, 1))
@@ -34085,7 +34130,7 @@ function RandomPlayerPicker({
       schedule();
     }
     winnerTimer.current = setTimeout(() => {
-      const picked = pool[finalWinnerIdx];
+      const picked = activePool[finalWinnerIdx];
       if (!picked) {
         setSpinning(false);
         return;
@@ -34131,7 +34176,11 @@ function RandomPlayerPicker({
         particleTimer.current = setTimeout(() => setParticles([]), 2400);
       }
       if (removeWinners) {
+        pendingPopIdxRef.current = finalWinnerIdx;
         popTimer.current = setTimeout(() => {
+          popTimer.current = null;
+          pendingPopIdxRef.current = null;
+          if (!removeWinnersRef.current) return;
           setPool((p) => p.filter((_, i) => i !== finalWinnerIdx));
           setWinner(null);
           setRotation(0);
@@ -34142,8 +34191,6 @@ function RandomPlayerPicker({
   }, [
     pool,
     spinning,
-    n,
-    anglePerWedge,
     rotation,
     reelY,
     mode,
@@ -34179,6 +34226,7 @@ function RandomPlayerPicker({
     []
   );
   (0, import_react71.useEffect)(() => {
+    if (trigger === "external") return;
     const el = containerRef.current;
     if (!el) return;
     const h = (e) => {
@@ -34189,8 +34237,22 @@ function RandomPlayerPicker({
     };
     el.addEventListener("keydown", h);
     return () => el.removeEventListener("keydown", h);
-  }, [spin]);
+  }, [spin, trigger]);
   const reset = (0, import_react71.useCallback)(() => {
+    if (winnerTimer.current) {
+      clearTimeout(winnerTimer.current);
+      winnerTimer.current = null;
+    }
+    if (tickInterval.current) {
+      clearTimeout(tickInterval.current);
+      tickInterval.current = null;
+    }
+    if (popTimer.current) {
+      clearTimeout(popTimer.current);
+      popTimer.current = null;
+    }
+    pendingPopIdxRef.current = null;
+    setSpinning(false);
     setPool(participants);
     setHistory([]);
     setWinner(null);
@@ -38643,27 +38705,28 @@ function GameTimer({
     const now = performance.now();
     const delta = now - lastTickRef.current;
     lastTickRef.current = now;
-    setElapsedMs((prev) => {
-      const next = prev + delta;
-      if (mode === "countdown" && next >= durationMs) {
-        setRunning(false);
-        setCompleted(true);
-        onComplete?.();
-        return durationMs;
+    const next = elapsedRef.current + delta;
+    if (mode === "countdown" && next >= durationMs) {
+      elapsedRef.current = durationMs;
+      setElapsedMs(durationMs);
+      setRunning(false);
+      setCompleted(true);
+      onComplete?.();
+      return;
+    }
+    if (mode === "countdown") {
+      const secLeft = Math.ceil((durationMs - next) / 1e3);
+      if (secLeft <= warningAt && !warningFiredRef.current) {
+        warningFiredRef.current = true;
+        onWarning?.();
       }
-      if (mode === "countdown") {
-        const secLeft = Math.ceil((durationMs - next) / 1e3);
-        if (secLeft <= warningAt && !warningFiredRef.current) {
-          warningFiredRef.current = true;
-          onWarning?.();
-        }
-        if (secLeft <= dangerAt && !dangerFiredRef.current) {
-          dangerFiredRef.current = true;
-          onDanger?.();
-        }
+      if (secLeft <= dangerAt && !dangerFiredRef.current) {
+        dangerFiredRef.current = true;
+        onDanger?.();
       }
-      return next;
-    });
+    }
+    elapsedRef.current = next;
+    setElapsedMs(next);
     rafRef.current = requestAnimationFrame(tick);
   }, [mode, durationMs, warningAt, dangerAt, onComplete, onWarning, onDanger]);
   (0, import_react74.useEffect)(() => {
@@ -38684,6 +38747,7 @@ function GameTimer({
   }, []);
   const reset = (0, import_react74.useCallback)(() => {
     setRunning(false);
+    elapsedRef.current = 0;
     setElapsedMs(0);
     setCompleted(false);
     setLaps([]);
@@ -40828,6 +40892,8 @@ function RoundRobinScheduler({
   theme: theme5 = "slate",
   darkMode,
   minTeams = 3,
+  maxTeams,
+  nameMaxLength,
   defaultTeams = [],
   resumeRounds,
   onTeamsChange,
@@ -40850,39 +40916,41 @@ function RoundRobinScheduler({
   (0, import_react77.useEffect)(() => {
     onTeamsChange?.(teams);
   }, [teams, onTeamsChange]);
-  const addTeams = (0, import_react77.useCallback)((raw) => {
-    const names = raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
-    if (names.length === 0) return;
-    setTeams((prev) => {
-      const existing = new Set(prev.map((t) => t.toLowerCase()));
-      const next = [...prev];
-      for (const name of names) {
-        if (!existing.has(name.toLowerCase())) {
-          existing.add(name.toLowerCase());
-          next.push(name);
-        }
-      }
-      return next;
-    });
-    setInput("");
-    setRounds([]);
-  }, []);
-  const importTeams = (0, import_react77.useCallback)((incoming) => {
-    if (incoming.length === 0) return;
-    setTeams((prev) => {
+  const mergeNames = (0, import_react77.useCallback)(
+    (prev, incoming) => {
       const existing = new Set(prev.map((t) => t.toLowerCase()));
       const next = [...prev];
-      for (const name of incoming) {
+      for (const rawName of incoming) {
+        if (maxTeams != null && next.length >= maxTeams) break;
+        const name = nameMaxLength != null ? rawName.slice(0, nameMaxLength) : rawName;
         const key = name.toLowerCase();
-        if (!existing.has(key)) {
+        if (name.length > 0 && !existing.has(key)) {
           existing.add(key);
           next.push(name);
         }
       }
       return next;
-    });
-    setRounds([]);
-  }, []);
+    },
+    [maxTeams, nameMaxLength]
+  );
+  const addTeams = (0, import_react77.useCallback)(
+    (raw) => {
+      const names = raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
+      if (names.length === 0) return;
+      setTeams((prev) => mergeNames(prev, names));
+      setInput("");
+      setRounds([]);
+    },
+    [mergeNames]
+  );
+  const importTeams = (0, import_react77.useCallback)(
+    (incoming) => {
+      if (incoming.length === 0) return;
+      setTeams((prev) => mergeNames(prev, incoming));
+      setRounds([]);
+    },
+    [mergeNames]
+  );
   const handleKeyDown = (0, import_react77.useCallback)(
     (e) => {
       if (e.key === "Enter") {
@@ -41371,6 +41439,8 @@ function Scoreboard({
   onTeamsChange,
   onRoundAdvance,
   onNewGame,
+  onReset,
+  nameMaxLength,
   labels,
   ariaLabel = "Scoreboard",
   className
@@ -41445,7 +41515,8 @@ function Scoreboard({
     setRound(1);
     setHistory([]);
     setHistoryOpen(false);
-  }, []);
+    onReset?.();
+  }, [onReset]);
   const newGame = (0, import_react78.useCallback)(() => {
     setTeams(createDefaultTeams(seedCount, L.teamNamePrefix));
     setRound(1);
@@ -41667,6 +41738,7 @@ function Scoreboard({
                     {
                       type: "text",
                       value: team.name,
+                      maxLength: nameMaxLength,
                       onChange: (e) => updateName(index, e.target.value),
                       style: nameInputStyle,
                       "aria-label": `Team ${index + 1} name`