@digilogiclabs/saas-factory-ui 2.3.0 → 2.5.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
@@ -5048,14 +5050,37 @@ interface RandomPlayerPickerProps {
     renderWinner?: (winner: RandomPlayerParticipant) => ReactNode;
     /** Imperative handle. `spinRef.current?.()` triggers a spin. */
     spinRef?: MutableRefObject<(() => void) | null>;
+    /**
+     * Imperative reset handle. `resetRef.current?.()` restores the pool to
+     * the full `participants` list and clears history/winner — the escape
+     * hatch for consumers that hide the built-in controls
+     * (`showControls={false}`) but still need a "reset draft" affordance
+     * once draft-mode pops drain the pool.
+     */
+    resetRef?: MutableRefObject<(() => void) | null>;
+    /**
+     * Fired whenever the internal pool changes (mount, structural sync,
+     * draft-mode pop, spin-again flush, reset). Draft-mode consumers use
+     * this to mirror the live pool — e.g. to disable an external spin
+     * trigger when the pool drains below 2 instead of presenting a dead
+     * button, and to offer a reset once the draft completes.
+     */
+    onPoolChange?: (pool: RandomPlayerParticipant[]) => void;
+    /**
+     * Caption shown in place of `placeholderCaption` when draft-mode pops
+     * drain the pool below 2 while the roster itself still has 2+ members.
+     * Default: "Draft complete — reset to spin again".
+     */
+    draftCompleteCaption?: string;
     /**
      * Visual intensity preset. Default "normal".
-     *   - "subtle" / "normal": current behavior — shorter spins, standard
-     *     ease-out curve.
-     *   - "dramatic": physics-like spin — 2.5× duration, inertia-style
-     *     curve so motion continues through the full duration with a slow
-     *     winding-down tail, +12 extra revolutions, plus more
-     *     particles/glow/shake on reveal.
+     *   - "subtle" / "normal": shorter spins, standard CSS ease-out curve.
+     *   - "dramatic": physics-driven spin — 2.5× duration, rAF-driven
+     *     exponential velocity decay (v ∝ e^(-4t)) that keeps the wheel
+     *     visibly winding down through the FULL duration and lands exactly
+     *     at the end, +12 extra revolutions, ticks fired on actual
+     *     wedge/row crossings, plus more particles/glow/shake on reveal.
+     *     Falls back to a 250ms CSS settle under prefers-reduced-motion.
      */
     intensity?: RandomPlayerIntensity;
     /**
@@ -5098,7 +5123,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, 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, 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";
@@ -5664,10 +5689,20 @@ interface TeamGeneratorProps {
     maxPlayers?: number;
     /** Initial roster. Uncontrolled — the component manages names internally. */
     defaultNames?: string[];
+    /** Initial generated teams (e.g. restored from a saved session).
+     *  Uncontrolled — the component takes over after mount. An empty array
+     *  is treated as "no teams". */
+    defaultTeams?: string[][];
     /** Called whenever the name pool changes. */
     onNamesChange?: (names: string[]) => void;
     /** Called whenever teams are (re)generated. */
     onGenerate?: (teams: string[][]) => void;
+    /** Called whenever the generated teams change for ANY reason — a
+     *  (re)generation, or invalidation to `null` when a player is removed,
+     *  the pool is cleared, or the team count changes. Unlike `onGenerate`,
+     *  this mirrors the full lifecycle of the on-screen split so hosts can
+     *  persist it and restore via `defaultTeams`. */
+    onTeamsChange?: (teams: string[][] | null) => void;
     /** Called whenever the team count selection changes. */
     onTeamCountChange?: (count: number) => void;
     /** Localized / customized labels. */
@@ -5680,7 +5715,7 @@ interface TeamGeneratorProps {
      *  CSV / TSV roster from a spreadsheet. Default `true`. */
     enableImport?: boolean;
 }
-declare function TeamGenerator({ theme, darkMode, teamCountOptions, defaultTeamCount, minPlayersPerTeam, maxPlayers, defaultNames, onNamesChange, onGenerate, onTeamCountChange, labels, ariaLabel, className, enableImport, }: TeamGeneratorProps): react_jsx_runtime.JSX.Element;
+declare function TeamGenerator({ theme, darkMode, teamCountOptions, defaultTeamCount, minPlayersPerTeam, maxPlayers, defaultNames, defaultTeams, onNamesChange, onGenerate, onTeamsChange, onTeamCountChange, labels, ariaLabel, className, enableImport, }: TeamGeneratorProps): react_jsx_runtime.JSX.Element;
 declare namespace TeamGenerator {
     var displayName: string;
 }
@@ -5728,6 +5763,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 +5796,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 +5855,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 +5869,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
@@ -5048,14 +5050,37 @@ interface RandomPlayerPickerProps {
     renderWinner?: (winner: RandomPlayerParticipant) => ReactNode;
     /** Imperative handle. `spinRef.current?.()` triggers a spin. */
     spinRef?: MutableRefObject<(() => void) | null>;
+    /**
+     * Imperative reset handle. `resetRef.current?.()` restores the pool to
+     * the full `participants` list and clears history/winner — the escape
+     * hatch for consumers that hide the built-in controls
+     * (`showControls={false}`) but still need a "reset draft" affordance
+     * once draft-mode pops drain the pool.
+     */
+    resetRef?: MutableRefObject<(() => void) | null>;
+    /**
+     * Fired whenever the internal pool changes (mount, structural sync,
+     * draft-mode pop, spin-again flush, reset). Draft-mode consumers use
+     * this to mirror the live pool — e.g. to disable an external spin
+     * trigger when the pool drains below 2 instead of presenting a dead
+     * button, and to offer a reset once the draft completes.
+     */
+    onPoolChange?: (pool: RandomPlayerParticipant[]) => void;
+    /**
+     * Caption shown in place of `placeholderCaption` when draft-mode pops
+     * drain the pool below 2 while the roster itself still has 2+ members.
+     * Default: "Draft complete — reset to spin again".
+     */
+    draftCompleteCaption?: string;
     /**
      * Visual intensity preset. Default "normal".
-     *   - "subtle" / "normal": current behavior — shorter spins, standard
-     *     ease-out curve.
-     *   - "dramatic": physics-like spin — 2.5× duration, inertia-style
-     *     curve so motion continues through the full duration with a slow
-     *     winding-down tail, +12 extra revolutions, plus more
-     *     particles/glow/shake on reveal.
+     *   - "subtle" / "normal": shorter spins, standard CSS ease-out curve.
+     *   - "dramatic": physics-driven spin — 2.5× duration, rAF-driven
+     *     exponential velocity decay (v ∝ e^(-4t)) that keeps the wheel
+     *     visibly winding down through the FULL duration and lands exactly
+     *     at the end, +12 extra revolutions, ticks fired on actual
+     *     wedge/row crossings, plus more particles/glow/shake on reveal.
+     *     Falls back to a 250ms CSS settle under prefers-reduced-motion.
      */
     intensity?: RandomPlayerIntensity;
     /**
@@ -5098,7 +5123,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, 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, 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";
@@ -5664,10 +5689,20 @@ interface TeamGeneratorProps {
     maxPlayers?: number;
     /** Initial roster. Uncontrolled — the component manages names internally. */
     defaultNames?: string[];
+    /** Initial generated teams (e.g. restored from a saved session).
+     *  Uncontrolled — the component takes over after mount. An empty array
+     *  is treated as "no teams". */
+    defaultTeams?: string[][];
     /** Called whenever the name pool changes. */
     onNamesChange?: (names: string[]) => void;
     /** Called whenever teams are (re)generated. */
     onGenerate?: (teams: string[][]) => void;
+    /** Called whenever the generated teams change for ANY reason — a
+     *  (re)generation, or invalidation to `null` when a player is removed,
+     *  the pool is cleared, or the team count changes. Unlike `onGenerate`,
+     *  this mirrors the full lifecycle of the on-screen split so hosts can
+     *  persist it and restore via `defaultTeams`. */
+    onTeamsChange?: (teams: string[][] | null) => void;
     /** Called whenever the team count selection changes. */
     onTeamCountChange?: (count: number) => void;
     /** Localized / customized labels. */
@@ -5680,7 +5715,7 @@ interface TeamGeneratorProps {
      *  CSV / TSV roster from a spreadsheet. Default `true`. */
     enableImport?: boolean;
 }
-declare function TeamGenerator({ theme, darkMode, teamCountOptions, defaultTeamCount, minPlayersPerTeam, maxPlayers, defaultNames, onNamesChange, onGenerate, onTeamCountChange, labels, ariaLabel, className, enableImport, }: TeamGeneratorProps): react_jsx_runtime.JSX.Element;
+declare function TeamGenerator({ theme, darkMode, teamCountOptions, defaultTeamCount, minPlayersPerTeam, maxPlayers, defaultNames, defaultTeams, onNamesChange, onGenerate, onTeamsChange, onTeamCountChange, labels, ariaLabel, className, enableImport, }: TeamGeneratorProps): react_jsx_runtime.JSX.Element;
 declare namespace TeamGenerator {
     var displayName: string;
 }
@@ -5728,6 +5763,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 +5796,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 +5855,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 +5869,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;
 }