@flamingo-stack/openframe-frontend-core 0.0.178 → 0.0.179-snapshot.20260514181702

package/dist/components/features/video-player.d.ts

@@ -1,44 +0,0 @@
-import React from 'react';
-interface VideoPlayerProps {
-    url: string;
-    title?: string;
-    poster?: string;
-    className?: string;
-    showTitle?: boolean;
-    autoPlay?: boolean;
-    loop?: boolean;
-    muted?: boolean;
-    useNativeAspectRatio?: boolean;
-    /** SRT subtitle content string. Parsed and rendered as overlay synced via onProgress. */
-    srtContent?: string;
-    /** HTTPS URL to a VTT/SRT captions file. Required for iOS native fullscreen subtitles
-     *  (iOS Safari does not support blob: URLs for <track> elements). */
-    captionsUrl?: string;
-    /** Label for the subtitle track (default: 'English') */
-    subtitleLabel?: string;
-    /**
-     * Controls how aggressively the browser preloads the video before the user
-     * presses play. Mirrors the underlying `<video preload>` attribute.
-     *
-     *   - `'auto'`     — browser may download the entire file. Use for hero
-     *                    videos that you expect every visitor to play.
-     *   - `'metadata'` — (default) browser fetches the moov atom + a few KB
-     *                    so dimensions, duration, and the first frame are
-     *                    ready by the time the user clicks. Tiny bandwidth
-     *                    cost vs. dramatic click→first-frame improvement.
-     *   - `'none'`     — zero bytes fetched until click. Opt in for modal
-     *                    videos that are rarely played.
-     *
-     * Caveat for long videos with `moov` at the end (common for iPhone
-     * screen recordings): `'metadata'` may pull several MB before any frame
-     * decodes. Run a faststart remux on the source to eliminate this. For
-     * grid/list pages, gate mount with `useNearViewport` (lib hook) so only
-     * near-viewport bites mount + start their metadata fetch.
-     *
-     * @default 'metadata'
-     */
-    preloadStrategy?: 'auto' | 'metadata' | 'none';
-}
-export declare const VideoPlayer: React.FC<VideoPlayerProps>;
-export {};
-//# sourceMappingURL=video-player.d.ts.map

package/dist/components/features/video-player.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"video-player.d.ts","sourceRoot":"","sources":["../../../src/components/features/video-player.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAiHjF,UAAU,gBAAgB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;yEACqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;CAChD;AAeD,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAmtBlD,CAAC"}

package/dist/components/features/youtube-embed.d.ts

@@ -1,31 +0,0 @@
-import React from 'react';
-/**
- * YouTube facade (lite-youtube-embed pattern). Renders poster + play
- * button until clicked; on click, a real `<iframe>` is created via
- * `document.createElement` synchronously so the user-activation chain
- * holds and `autoplay=1` plays on Chrome / Safari / Firefox.
- *
- * Uses `youtube-nocookie.com` (GDPR-friendly) and `mqdefault` posters
- * (`maxresdefault` returns a gray 200 placeholder when missing, which
- * defeats `onError` fallback).
- */
-interface YouTubeEmbedProps {
-    videoId: string;
-    title?: string;
-    className?: string;
-    showTitle?: boolean;
-    showMeta?: boolean;
-    minimalControls?: boolean;
-    /** When true, the poster img gets `fetchpriority="high"` for LCP. Default false (below-the-fold). */
-    aboveTheFold?: boolean;
-}
-export declare const YouTubeEmbed: React.FC<YouTubeEmbedProps>;
-/**
- * Extract the YouTube video id from any common URL shape. Uses `URL`
- * parsing + a strict, anchored pathname regex — NOT the previous
- * `.*v=` pattern that CodeQL flagged for polynomial-time backtracking
- * on adversarial input like `youtube.com/watch?` repeated N times.
- */
-export declare const extractYouTubeId: (url: string) => string | null;
-export {};
-//# sourceMappingURL=youtube-embed.d.ts.map

package/dist/components/features/youtube-embed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"youtube-embed.d.ts","sourceRoot":"","sources":["../../../src/components/features/youtube-embed.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA2B,MAAM,OAAO,CAAC;AAEhD;;;;;;;;;GASG;AAEH,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qGAAqG;IACrG,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAmGpD,CAAC;AAWF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAcvD,CAAC"}

package/dist/utils/lite-youtube-embed-stub.d.ts

@@ -1,8 +0,0 @@
-export interface LiteYouTubeEmbedProps {
-    id: string;
-    title?: string;
-    poster?: string;
-    className?: string;
-}
-export declare function LiteYouTubeEmbed({ id, title, poster, className }: LiteYouTubeEmbedProps): import("react/jsx-runtime").JSX.Element;
-//# sourceMappingURL=lite-youtube-embed-stub.d.ts.map

package/dist/utils/lite-youtube-embed-stub.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lite-youtube-embed-stub.d.ts","sourceRoot":"","sources":["../../src/utils/lite-youtube-embed-stub.tsx"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,qBAAqB,2CAWvF"}

package/dist/utils/lite-youtube-embed.d.ts

@@ -1,9 +0,0 @@
-interface LiteYouTubeEmbedProps {
-    id: string;
-    title?: string;
-    thumbnail?: string;
-    className?: string;
-}
-export declare function LiteYouTubeEmbed({ id, title, thumbnail, className }: LiteYouTubeEmbedProps): import("react/jsx-runtime").JSX.Element;
-export {};
-//# sourceMappingURL=lite-youtube-embed.d.ts.map

package/dist/utils/lite-youtube-embed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lite-youtube-embed.d.ts","sourceRoot":"","sources":["../../src/utils/lite-youtube-embed.tsx"],"names":[],"mappings":"AAEA,UAAU,qBAAqB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,EAAE,KAAuB,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,qBAAqB,2CAoC5G"}

package/src/components/features/.video-player.md

@@ -1,44 +0,0 @@
-<!-- source-hash: ac2c9623eeb0459e6abe9a41a32951c3 -->
-A comprehensive React video player component built on ReactPlayer with custom poster overlay, loading states, and error handling for the OpenFrame platform.
-
-## Key Components
-
-- **VideoPlayer**: Main component with configurable playback options and responsive design
-- **Play**: SVG icon component for the play button overlay
-- **Loader**: Animated SVG spinner for loading states
-- **VideoPlayerProps**: TypeScript interface defining all configuration options including aspect ratio control, autoplay, and poster image settings
-
-## Usage Example
-
-```typescript
-import { VideoPlayer } from './video-player';
-
-// Basic video with poster and title
-<VideoPlayer
-  url="https://example.com/video.mp4"
-  title="Demo Video"
-  poster="https://example.com/thumbnail.jpg"
-  showTitle={true}
-  controls={true}
-/>
-
-// Auto-playing video with native aspect ratio
-<VideoPlayer
-  url="https://youtube.com/watch?v=VIDEO_ID"
-  autoPlay={true}
-  muted={true}
-  loop={true}
-  useNativeAspectRatio={true}
-  className="custom-player"
-/>
-
-// Video with custom poster click behavior
-<VideoPlayer
-  url="https://vimeo.com/123456789"
-  poster="custom-thumbnail.png"
-  showTitle={false}
-  controls={false}
-/>
-```
-
-The component handles client-side hydration, provides comprehensive error states, and integrates with OpenFrame's design system using ODS CSS classes. It supports both 16:9 aspect ratio (default) and native video dimensions through the `useNativeAspectRatio` prop.

package/src/components/features/.youtube-embed.md

@@ -1,40 +0,0 @@
-<!-- source-hash: fc74dea08c8b565aa3e51c72946544d6 -->
-A React component for embedding YouTube videos with responsive design, loading states, and fallback support for the Flamingo documentation system.
-
-## Key Components
-
-- **`YouTubeEmbed`** - Main YouTube video embed component with configurable options
-- **`Play`** - SVG play button icon component
-- **`Loader`** - Animated loading spinner icon component
-- **`extractYouTubeId`** - Utility function to extract video IDs from various YouTube URL formats
-- **`YouTubeLinkParser`** - Component that automatically converts YouTube links to embedded videos
-
-## Usage Example
-
-```typescript
-import { YouTubeEmbed, extractYouTubeId } from './youtube-embed';
-
-// Basic embed
-<YouTubeEmbed videoId="dQw4w9WgXcQ" />
-
-// With custom options
-<YouTubeEmbed 
-  videoId="dQw4w9WgXcQ"
-  title="Custom Video Title"
-  showTitle={true}
-  showMeta={false}
-  minimalControls={true}
-  className="my-custom-class"
-/>
-
-// Extract video ID from URL
-const videoId = extractYouTubeId("https://www.youtube.com/watch?v=dQw4w9WgXcQ");
-// Returns: "dQw4w9WgXcQ"
-
-// Auto-convert YouTube links in markdown
-<YouTubeLinkParser href="https://youtu.be/dQw4w9WgXcQ">
-  Video Title
-</YouTubeLinkParser>
-```
-
-The component uses iframe embedding by default for better CSP compatibility, includes responsive 16:9 aspect ratio containers, and provides error handling with fallback to YouTube's website. It supports various display options including minimal controls mode and customizable meta information display.