@djangocfg/ui-tools 2.1.417 → 2.1.418

package/dist/audio-player/index.d.cts

@@ -42,17 +42,9 @@ type PlayerProps = {
     onTimeUpdate?: (currentTime: number, duration: number) => void;
     ariaLabel?: string;
     enableKeyboardShortcuts?: boolean;
-    /**
-     * Move keyboard focus into the player container on mount. Activates
-     * the hotkey scope (Space=play/pause, ←→=seek, ↑↓=volume, M=mute)
-     * without the user having to click the player first.
-     *
-     * Useful when the player mounts as the result of an explicit user
-     * action — e.g. a file picker selecting an audio file — so keyboard
-     * control is immediately live.
-     *
-     * @default false
-     */
+    /** Focus the player container on mount so its keyboard scope is active
+     *  immediately. Pair with `key={src}` upstream when the parent wants a
+     *  fresh focus on every source change (file-browser inspector pattern). */
     autoFocus?: boolean;
     seekStartsPlayback?: boolean;
 };

package/dist/audio-player/index.d.ts

@@ -42,17 +42,9 @@ type PlayerProps = {
     onTimeUpdate?: (currentTime: number, duration: number) => void;
     ariaLabel?: string;
     enableKeyboardShortcuts?: boolean;
-    /**
-     * Move keyboard focus into the player container on mount. Activates
-     * the hotkey scope (Space=play/pause, ←→=seek, ↑↓=volume, M=mute)
-     * without the user having to click the player first.
-     *
-     * Useful when the player mounts as the result of an explicit user
-     * action — e.g. a file picker selecting an audio file — so keyboard
-     * control is immediately live.
-     *
-     * @default false
-     */
+    /** Focus the player container on mount so its keyboard scope is active
+     *  immediately. Pair with `key={src}` upstream when the parent wants a
+     *  fresh focus on every source change (file-browser inspector pattern). */
     autoFocus?: boolean;
     seekStartsPlayback?: boolean;
 };

package/dist/audio-player/index.mjs

@@ -1952,8 +1952,7 @@ function PlayerShell({
   }, [container]);
   useEffect(() => {
     if (!autoFocus || !container) return;
-    const id = setTimeout(() => container.focus(), 0);
-    return () => clearTimeout(id);
+    container.focus({ preventScroll: true });
   }, [autoFocus, container]);
   return /* @__PURE__ */ jsx(
     "div",