@f8team/reel-core 1.0.5 → 1.1.0

package/dist/index.d.cts

@@ -798,6 +798,33 @@ interface FocusTrap {
  */
 declare function createFocusTrap(container: HTMLElement): FocusTrap;
 
+/**
+ * Focus helpers for the auto-hiding controls chrome.
+ *
+ * The themes keep the controls bar visible while the player matches
+ * `:focus-within`, so keyboard users never lose the control they are on.
+ * A pointer click focuses that control too, which used to latch the chrome
+ * open forever - most visibly after tapping the fullscreen button, the only
+ * way into fullscreen. `shouldKeepControlsVisible` tells the auto-hide timer
+ * which of the two it is looking at, and `blurFocusInside` releases the
+ * pointer-induced focus so `:focus-within` stops matching.
+ */
+/**
+ * Clears focus from any focused descendant of `container`.
+ *
+ * Used on pointer leave of the `[data-reel]` wrapper and when the auto-hide
+ * timer fires, so `:focus-within` does not keep the controls bar visible
+ * after a mouse click or tap on a control.
+ */
+declare function blurFocusInside(container: Element): void;
+/**
+ * `true` when the controls must stay on screen even though the idle timer
+ * expired: an open menu, or a control the user reached with the keyboard.
+ *
+ * Pointer focus deliberately returns `false` - a tap must not pin the chrome.
+ */
+declare function shouldKeepControlsVisible(container: Element): boolean;
+
 /**
  * Time helpers shared by the seek bar, transcript markers (G8), and the
  * keyboard / commands layer.
@@ -870,4 +897,4 @@ declare function looksLikeProgressive(input: string | undefined | null): boolean
  */
 declare function detectSourceType(source: SourceDescriptor): SourceType;
 
-export { type AutoplayMode, type BufferedRange, type CommandRegistry, DEFAULT_TOKENS, type Disposer, type KeyboardScope, type MutableStore, type Player, type PlayerError, type PlayerErrorCode, type PlayerEvents, type PlayerHooks, type PlayerOptions, type PlayerState, type PlayerStatus, type PluginHost, type PluginInstance, type PluginMediaAttachment, type QualityLevel, type ReadableStore, type SourceDescriptor, type SourceLoader, type SourceProvider, type SourceTransform, type SourceType, type SubtitleTrack, THEME_PRESETS, TOKEN_TO_CSS_VAR, type ThemeName, type ThemeTokens, type ThumbnailsDescriptor, type UnauthorizedEvent, announce, applyTheme, areSourceDescriptorsEquivalent, createFocusTrap, createPlayer, definePlugin, detectSourceType, formatTime, isSafeMediaUrl, looksLikeHls, looksLikeProgressive, looksLikeYouTube, parseTime, resolveTokens, toSeconds };
+export { type AutoplayMode, type BufferedRange, type CommandRegistry, DEFAULT_TOKENS, type Disposer, type KeyboardScope, type MutableStore, type Player, type PlayerError, type PlayerErrorCode, type PlayerEvents, type PlayerHooks, type PlayerOptions, type PlayerState, type PlayerStatus, type PluginHost, type PluginInstance, type PluginMediaAttachment, type QualityLevel, type ReadableStore, type SourceDescriptor, type SourceLoader, type SourceProvider, type SourceTransform, type SourceType, type SubtitleTrack, THEME_PRESETS, TOKEN_TO_CSS_VAR, type ThemeName, type ThemeTokens, type ThumbnailsDescriptor, type UnauthorizedEvent, announce, applyTheme, areSourceDescriptorsEquivalent, blurFocusInside, createFocusTrap, createPlayer, definePlugin, detectSourceType, formatTime, isSafeMediaUrl, looksLikeHls, looksLikeProgressive, looksLikeYouTube, parseTime, resolveTokens, shouldKeepControlsVisible, toSeconds };

package/dist/index.d.ts

@@ -798,6 +798,33 @@ interface FocusTrap {
  */
 declare function createFocusTrap(container: HTMLElement): FocusTrap;
 
+/**
+ * Focus helpers for the auto-hiding controls chrome.
+ *
+ * The themes keep the controls bar visible while the player matches
+ * `:focus-within`, so keyboard users never lose the control they are on.
+ * A pointer click focuses that control too, which used to latch the chrome
+ * open forever - most visibly after tapping the fullscreen button, the only
+ * way into fullscreen. `shouldKeepControlsVisible` tells the auto-hide timer
+ * which of the two it is looking at, and `blurFocusInside` releases the
+ * pointer-induced focus so `:focus-within` stops matching.
+ */
+/**
+ * Clears focus from any focused descendant of `container`.
+ *
+ * Used on pointer leave of the `[data-reel]` wrapper and when the auto-hide
+ * timer fires, so `:focus-within` does not keep the controls bar visible
+ * after a mouse click or tap on a control.
+ */
+declare function blurFocusInside(container: Element): void;
+/**
+ * `true` when the controls must stay on screen even though the idle timer
+ * expired: an open menu, or a control the user reached with the keyboard.
+ *
+ * Pointer focus deliberately returns `false` - a tap must not pin the chrome.
+ */
+declare function shouldKeepControlsVisible(container: Element): boolean;
+
 /**
  * Time helpers shared by the seek bar, transcript markers (G8), and the
  * keyboard / commands layer.
@@ -870,4 +897,4 @@ declare function looksLikeProgressive(input: string | undefined | null): boolean
  */
 declare function detectSourceType(source: SourceDescriptor): SourceType;
 
-export { type AutoplayMode, type BufferedRange, type CommandRegistry, DEFAULT_TOKENS, type Disposer, type KeyboardScope, type MutableStore, type Player, type PlayerError, type PlayerErrorCode, type PlayerEvents, type PlayerHooks, type PlayerOptions, type PlayerState, type PlayerStatus, type PluginHost, type PluginInstance, type PluginMediaAttachment, type QualityLevel, type ReadableStore, type SourceDescriptor, type SourceLoader, type SourceProvider, type SourceTransform, type SourceType, type SubtitleTrack, THEME_PRESETS, TOKEN_TO_CSS_VAR, type ThemeName, type ThemeTokens, type ThumbnailsDescriptor, type UnauthorizedEvent, announce, applyTheme, areSourceDescriptorsEquivalent, createFocusTrap, createPlayer, definePlugin, detectSourceType, formatTime, isSafeMediaUrl, looksLikeHls, looksLikeProgressive, looksLikeYouTube, parseTime, resolveTokens, toSeconds };
+export { type AutoplayMode, type BufferedRange, type CommandRegistry, DEFAULT_TOKENS, type Disposer, type KeyboardScope, type MutableStore, type Player, type PlayerError, type PlayerErrorCode, type PlayerEvents, type PlayerHooks, type PlayerOptions, type PlayerState, type PlayerStatus, type PluginHost, type PluginInstance, type PluginMediaAttachment, type QualityLevel, type ReadableStore, type SourceDescriptor, type SourceLoader, type SourceProvider, type SourceTransform, type SourceType, type SubtitleTrack, THEME_PRESETS, TOKEN_TO_CSS_VAR, type ThemeName, type ThemeTokens, type ThumbnailsDescriptor, type UnauthorizedEvent, announce, applyTheme, areSourceDescriptorsEquivalent, blurFocusInside, createFocusTrap, createPlayer, definePlugin, detectSourceType, formatTime, isSafeMediaUrl, looksLikeHls, looksLikeProgressive, looksLikeYouTube, parseTime, resolveTokens, shouldKeepControlsVisible, toSeconds };

package/dist/index.js

@@ -2392,6 +2392,27 @@ function createFocusTrap(container) {
   return { activate, deactivate };
 }
 
+// src/a11y/controlsFocus.ts
+var OPEN_MENU_SELECTOR = "[data-reel-menu-open]";
+function activeElementInside(container) {
+  const active = (container.ownerDocument ?? document).activeElement;
+  if (!(active instanceof HTMLElement)) return null;
+  return container.contains(active) ? active : null;
+}
+function blurFocusInside(container) {
+  activeElementInside(container)?.blur();
+}
+function shouldKeepControlsVisible(container) {
+  if (container.querySelector(OPEN_MENU_SELECTOR) !== null) return true;
+  const active = activeElementInside(container);
+  if (!active) return false;
+  try {
+    return active.matches(":focus-visible");
+  } catch {
+    return false;
+  }
+}
+
 // src/util/time.ts
 var TIME_RE = /^(?:(\d+):)?(\d{1,2}):(\d{1,2})(?:\.(\d+))?$/;
 function parseTime(input) {
@@ -2425,6 +2446,6 @@ function toSeconds(input) {
   return parseTime(input);
 }
 
-export { DEFAULT_TOKENS, THEME_PRESETS, TOKEN_TO_CSS_VAR, announce, applyTheme, areSourceDescriptorsEquivalent, createFocusTrap, createPlayer, definePlugin, detectSourceType, formatTime, isSafeMediaUrl, looksLikeHls, looksLikeProgressive, looksLikeYouTube, parseTime, resolveTokens, toSeconds };
+export { DEFAULT_TOKENS, THEME_PRESETS, TOKEN_TO_CSS_VAR, announce, applyTheme, areSourceDescriptorsEquivalent, blurFocusInside, createFocusTrap, createPlayer, definePlugin, detectSourceType, formatTime, isSafeMediaUrl, looksLikeHls, looksLikeProgressive, looksLikeYouTube, parseTime, resolveTokens, shouldKeepControlsVisible, toSeconds };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map