@flamingo-stack/openframe-frontend-core 0.0.396 → 0.0.397-snapshot.20260710042522

package/src/components/features/video.tsx

@@ -32,8 +32,7 @@
 
 import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import MuxPlayer from '@mux/mux-player-react';
-import { PlayIcon } from '../icons-v2-generated/media-playback/play-icon';
-import { VolumeXmarkIcon } from '../icons-v2-generated/audio-and-visual/volume-xmark-icon';
+import { VideoPlayBadge, VideoUnmuteGlyph } from './video-center-badge';
 import { fetchPriorityProp } from '../../utils/fetch-priority';
 
 // =============================================================================
@@ -253,6 +252,12 @@ interface VideoFileProps extends VideoCommonProps {
   /** Hide the bottom control bar, keep only the CENTER play/pause control
    *  (bite-strip cards per Figma). */
   centerControlsOnly?: boolean;
+  /** Render ONLY a lightweight first-frame preview — a metadata-only element
+   *  seeked to `#t=0.1` (media-fragment trick; paints on iOS Safari where a
+   *  fragmentless metadata load stays blank). No chrome, no playback, no
+   *  MuxPlayer cost — the resting facade layer under strip cards when no
+   *  poster asset exists. All player props are ignored. */
+  firstFrameOnly?: boolean;
 }
 
 interface VideoYouTubeProps extends VideoCommonProps {
@@ -273,6 +278,7 @@ interface VideoAutoProps extends VideoCommonProps {
   playOnHover?: boolean;
   playWhenHovered?: boolean;
   centerControlsOnly?: boolean;
+  firstFrameOnly?: boolean;
 }
 
 export type VideoProps = VideoFileProps | VideoYouTubeProps | VideoAutoProps;
@@ -297,6 +303,8 @@ export function Video(props: VideoProps): React.ReactElement | null {
         className={props.className}
         minimalControls={props.minimalControls}
       />
+    ) : 'firstFrameOnly' in props && props.firstFrameOnly ? (
+      <FirstFramePreview url={url} className={props.className} />
     ) : (
       <FilePlayer
         url={url}
@@ -373,6 +381,35 @@ function wrapWithLayout(
   }
 }
 
+// -----------------------------------------------------------------------------
+// First-frame preview — the `firstFrameOnly` facade branch
+// -----------------------------------------------------------------------------
+
+/** First-frame paint through the SAME FilePlayer/MuxPlayer pipeline as
+ *  playback (one rendering path for every file source — HLS included, which a
+ *  plain `<video>` couldn't decode in Chromium): a chromeless, muted,
+ *  metadata-only instance whose `#t=0.1` media fragment seeks-and-paints the
+ *  first frame (also fixes iOS Safari, which stays blank on a fragmentless
+ *  metadata load). The transparent media background keeps the box showing the
+ *  card surface (never black) until the frame decodes. */
+function FirstFramePreview({ url, className }: { url: string; className?: string }): React.ReactElement {
+  return (
+    <div
+      aria-hidden
+      className="h-full w-full"
+      style={{ '--media-background-color': 'transparent' } as React.CSSProperties}
+    >
+      <FilePlayer
+        url={`${url}#t=0.1`}
+        preload="metadata"
+        muted
+        chromeless
+        className={className}
+      />
+    </div>
+  );
+}
+
 // -----------------------------------------------------------------------------
 // File branch — MuxPlayer (handles both .m3u8 HLS and plain .mp4)
 // -----------------------------------------------------------------------------
@@ -389,6 +426,8 @@ interface FilePlayerProps {
   playOnHover?: boolean;
   playWhenHovered?: boolean;
   centerControlsOnly?: boolean;
+  /** Media preload hint — the firstFrameOnly facade passes 'metadata'. */
+  preload?: 'none' | 'metadata' | 'auto';
   className?: string;
 }
 
@@ -404,6 +443,7 @@ function FilePlayer({
   playOnHover,
   playWhenHovered,
   centerControlsOnly,
+  preload,
   className,
 }: FilePlayerProps): React.ReactElement {
   // centerControlsOnly: the center play button shows at REST only — while
@@ -551,6 +591,7 @@ function FilePlayer({
       src={url}
       poster={poster || undefined}
       streamType="on-demand"
+      preload={preload}
       playsInline
       muted={muted}
       preferCmcd="header"
@@ -616,9 +657,11 @@ function FilePlayer({
       aria-label="Unmute"
       title="Unmute"
       onClick={unmuteNow}
-      className="absolute inset-0 z-10 m-auto flex h-14 w-14 items-center justify-center text-ods-text-primary transition-opacity hover:opacity-75"
+      // White at rest, ACCENT while the icon itself is hovered — the same
+      // hover language as every mux control icon (see app-globals.css).
+      className="absolute inset-0 z-10 m-auto flex h-14 w-14 items-center justify-center text-ods-text-primary transition-colors hover:text-ods-accent"
     >
-      <VolumeXmarkIcon size={56} />
+      <VideoUnmuteGlyph />
     </button>
   ) : null;
 
@@ -882,9 +925,10 @@ function YouTubeFacadeInner({
           />
         </picture>
         <div className="absolute inset-0 flex items-center justify-center bg-ods-bg-inverse bg-opacity-20 transition-opacity duration-200 group-hover:bg-opacity-30">
-          <span className="flex items-center justify-center w-16 h-16 rounded-full bg-ods-accent text-ods-text-on-accent shadow-lg transition-transform duration-200 group-hover:scale-110">
-            <PlayIcon size={24} color="currentColor" className="ml-1" />
-          </span>
+          {/* THE shared center play badge (video-center-badge.tsx) — same disc
+              as strip cards / carousel thumbs / unmute chip; hero size + the
+              facade's hover-scale affordance. */}
+          <VideoPlayBadge size="lg" className="transition-transform duration-200 group-hover:scale-110 group-hover:text-ods-accent" />
         </div>
       </button>
     </div>

package/src/components/media-carousel.tsx

@@ -4,7 +4,7 @@ import { useState, useRef, useEffect, memo, useCallback } from 'react';
 import { cn } from "../utils/cn";
 import { MediaItem } from '../utils/media-carousel-utils-stub';
 import { Video, extractYouTubeId } from './features/video';
-import { PlayIcon } from './icons-v2-generated/media-playback/play-icon';
+import { VideoPlayBadge } from './features/video-center-badge';
 
 // Navigation icons
 const ChevronLeftIcon = () => (
@@ -215,9 +215,7 @@ export const MediaCarousel = memo(function MediaCarousel({
         {/* Play icon overlay for videos */}
         {(item.type === 'video' || item.type === 'youtube') && (
           <div className="absolute inset-0 flex items-center justify-center bg-black/30">
-            <div className="bg-black/70 rounded-full p-1">
-              <PlayIcon size={12} color="white" />
-            </div>
+            <VideoPlayBadge size="sm" />
           </div>
         )}
         

package/src/components/ui/crossfade-panels.tsx

@@ -0,0 +1,88 @@
+'use client'
+
+/**
+ * <CrossfadePanels> — THE keep-mounted tab-panel stack: every panel stays in
+ * the DOM, stacked in the SAME grid cell, and switching is an opacity
+ * crossfade. Use it under any tab control (TabNavigation, TabSelector, …)
+ * whenever panels are content surfaces where height stability and a soft
+ * switch matter (strips, media rails, dashboards-in-view).
+ *
+ * Invariants encoded HERE exactly once (so no consumer re-derives them):
+ * - HEIGHT LOCK: grid items in one cell size the row to max(panel heights) —
+ *   switching never shifts the page (no CLS), and surrounding layout treats
+ *   the stack as one constant-height block.
+ * - FADE-THEN-HIDE: `visibility` transitions alongside `opacity`; per the CSS
+ *   transitions spec's special visibility interpolation the outgoing panel
+ *   stays paintable until the fade completes, THEN becomes `hidden` — no
+ *   pop-out, and the settled hidden panel is fully removed from paint.
+ * - DEAD WHILE HIDDEN: `inert` + `aria-hidden` + `pointer-events-none` on
+ *   inactive panels — no tab-stops, no screen-reader content, no hover/click
+ *   leaks from the invisible layer (WCAG aria-hidden-focus).
+ * - MOTION RESPECT: `prefers-reduced-motion` collapses the fade to an
+ *   instant swap.
+ * - The ACTIVE panel takes `z-[1]` so the incoming layer composites on top
+ *   during the crossfade regardless of DOM order.
+ *
+ * This deliberately complements (not replaces) <TabContent>, which MOUNTS one
+ * panel at a time — right for heavy admin surfaces that should unmount when
+ * hidden. CrossfadePanels is for surfaces whose panels are cheap enough to
+ * keep alive and whose switch must be seamless.
+ *
+ * NOTE for marquee/animated panel content: hidden panels stay mounted and
+ * their animations keep running unless the content self-pauses. CardsStrip
+ * panels are fine (its rAF gates on near-viewport + visibility), but a
+ * consumer embedding heavier always-on content should pause it via its own
+ * visibility signal.
+ */
+
+import React from 'react'
+import { cn } from '../../utils/cn'
+
+export interface CrossfadePanel {
+  id: string
+  content: React.ReactNode
+}
+
+export interface CrossfadePanelsProps {
+  /** Which panel is shown. Unknown id → all panels hidden (renders the
+   *  stack's reserved height, nothing visible). */
+  activeId: string | undefined
+  panels: ReadonlyArray<CrossfadePanel>
+  /** Crossfade duration in ms. Default 300. */
+  durationMs?: number
+  className?: string
+  /** Extra classes for every panel wrapper (e.g. `min-w-0` is built in). */
+  panelClassName?: string
+}
+
+export function CrossfadePanels({
+  activeId,
+  panels,
+  durationMs = 300,
+  className,
+  panelClassName,
+}: CrossfadePanelsProps) {
+  if (panels.length === 0) return null
+  return (
+    <div className={cn('grid w-full', className)}>
+      {panels.map(p => {
+        const active = p.id === activeId
+        return (
+          <div
+            key={p.id}
+            className={cn(
+              'col-start-1 row-start-1 min-w-0 transition-[opacity,visibility] ease-out motion-reduce:transition-none',
+              active ? 'visible opacity-100 z-[1]' : 'invisible opacity-0 pointer-events-none',
+              panelClassName,
+            )}
+            style={{ transitionDuration: `${durationMs}ms` }}
+            aria-hidden={!active || undefined}
+            inert={!active || undefined}
+          >
+            {p.content}
+          </div>
+        )
+      })}
+    </div>
+  )
+}

package/src/components/ui/index.ts

@@ -47,6 +47,7 @@ export * from './breadcrumb'
 export * from './dropdown-menu'
 export * from './menubar'
 export * from './navigation-menu'
+export * from './crossfade-panels'
 export * from './tab-content'
 export * from './tab-navigation'
 // Feedback components

package/src/components/ui/tab-navigation.tsx

@@ -7,7 +7,8 @@ import { cn } from '../../utils/cn'
 export interface TabItem {
   id: string
   label: string
-  icon: React.ComponentType<React.SVGProps<SVGSVGElement>>
+  /** Optional — text-only tabs (e.g. the homepage content-strip switcher) omit it. */
+  icon?: React.ComponentType<React.SVGProps<SVGSVGElement>>
   component?: React.ComponentType<any>
   indicator?: 'success' | 'warning' | 'error'
 }
@@ -29,6 +30,9 @@ interface TabNavigationProps {
   showRightGradient?: boolean
   /** Force the left-edge gradient to always render, independent of scroll state. */
   showLeftGradient?: boolean
+  /** Tabs grow to share the bar's full width equally (Figma segmented-underline
+   *  look, e.g. the 480px homepage strip switcher). Default: natural width. */
+  stretchTabs?: boolean
 
   // URL sync mode
   urlSync?: boolean | TabNavigationUrlSyncOptions
@@ -46,6 +50,7 @@ export function TabNavigation({
   shadowClassName,
   showRightGradient = false,
   showLeftGradient = false,
+  stretchTabs = false,
   urlSync = false,
   defaultTab,
   children
@@ -222,24 +227,36 @@ export function TabNavigation({
                 className={cn(
                   "flex gap-[var(--spacing-system-xxs)] items-center justify-center p-[var(--spacing-system-m)] relative shrink-0 cursor-pointer",
                   "transition-all duration-200 bg-transparent border-none outline-none",
+                  stretchTabs && 'flex-1',
                   isActive
                     ? 'bg-gradient-to-b from-[rgba(255,255,255,0)] to-[rgba(255,255,255,0.1)]'
                     : 'hover:bg-gradient-to-b hover:from-[rgba(255,255,255,0)] hover:to-[rgba(255,255,255,0.1)]'
                 )}
               >
-                <div className="relative flex items-center justify-center">
-                  <tab.icon
-                    className={cn("h-4 w-4 md:h-6 md:w-6 transition-colors", isActive ? 'text-ods-accent' : 'text-ods-text-secondary')}
-                  />
-                  {tab.indicator && (
-                    <div className={cn(
-                      "absolute right-0 top-[-3px] w-3 h-3 rounded-full border-2 border-ods-bg",
-                      tab.indicator === 'error' && 'bg-ods-error',
-                      tab.indicator === 'warning' && 'bg-ods-accent',
-                      tab.indicator === 'success' && 'bg-green-500'
-                    )} />
-                  )}
-                </div>
+                {tab.icon ? (
+                  <div className="relative flex items-center justify-center">
+                    <tab.icon
+                      className={cn("h-4 w-4 md:h-6 md:w-6 transition-colors", isActive ? 'text-ods-accent' : 'text-ods-text-secondary')}
+                    />
+                    {tab.indicator && (
+                      <div className={cn(
+                        "absolute right-0 top-[-3px] w-3 h-3 rounded-full border-2 border-ods-bg",
+                        tab.indicator === 'error' && 'bg-ods-error',
+                        tab.indicator === 'warning' && 'bg-ods-accent',
+                        tab.indicator === 'success' && 'bg-green-500'
+                      )} />
+                    )}
+                  </div>
+                ) : tab.indicator ? (
+                  // Text-only tabs keep their status badge — inline dot before
+                  // the label (there's no icon corner to anchor to).
+                  <div className={cn(
+                    "w-3 h-3 shrink-0 rounded-full border-2 border-ods-bg",
+                    tab.indicator === 'error' && 'bg-ods-error',
+                    tab.indicator === 'warning' && 'bg-ods-accent',
+                    tab.indicator === 'success' && 'bg-green-500'
+                  )} />
+                ) : null}
 
                 <span className={cn(
                   "text-h4 whitespace-nowrap transition-colors",

package/src/styles/app-globals.css

@@ -182,3 +182,26 @@ body {
     --ring: 180 100% 69%;
     --radius: 0.5rem;
   }
+
+/* ============================================================================
+   Video center-control identity — ONE look across every video surface:
+   a bare solid-white glyph, NO background disc (see
+   components/features/video-center-badge.tsx for the React consumers).
+   This strips media-chrome's default dark circle off MuxPlayer's big
+   center pre-play button so full players match the strip/facade glyphs.
+   ========================================================================== */
+/* REAL players (any mounted MuxPlayer): icons are white at rest and turn
+   the platform ACCENT color while the icon's control is hovered — every
+   media-chrome control carries the `button` part token, so this covers
+   center play, bar play/mute/fullscreen/etc. uniformly. */
+mux-player::part(button):hover {
+  --media-icon-color: var(--ods-accent, var(--color-accent-primary));
+}
+mux-player::part(center play button) {
+  background: transparent;
+  filter: drop-shadow(0 1px 4px rgba(0, 0, 0, 0.5));
+}
+mux-player::part(center play button):hover {
+  background: transparent;
+  opacity: 0.85;
+}