jamespot-react-components 1.3.90 → 1.3.91

package/dist/src/components/Editors/components/EditorInput.d.ts

@@ -1,11 +1,15 @@
+import { RegisterOptions } from 'react-hook-form';
 import { FormControls } from '../../Form/Input/Common/useFormControls';
-export declare const EditorInput: ({ label, placeholder, initialValue, width, rules, description, isMultiline, onChange, }: {
+export declare const EditorInput: ({ label, placeholder, initialValue, width, rules, rulesValidate, description, isMultiline, onChange, }: {
     label: string;
     placeholder?: string;
     initialValue: string | undefined;
     autoFocus?: boolean;
     width?: string;
     rules?: FormControls;
+    rulesValidate?: RegisterOptions<{
+        text: string;
+    }>["validate"];
     description?: string;
     isMultiline?: boolean;
     onChange: (text: string) => void;

package/dist/src/components/JRCIframeVideo/JRCIframeVideo.d.ts

@@ -0,0 +1,62 @@
+import { DataCy } from '../../types/dataAttributes';
+/**
+ * Provider detection / URL transformation contract.
+ *
+ * The component is agnostic of which providers exist — the consumer wires the
+ * helpers it needs. This keeps `JRCIframeVideo` in `jamespot-react-components`
+ * free of any backend convention (e.g. Studio's widgetType vocabulary).
+ */
+export interface JRCIframeVideoHelpers {
+    parse: (url: string) => {
+        provider: string;
+        videoId: string;
+    } | null;
+    toEmbedUrl: (parsed: {
+        provider: string;
+        videoId: string;
+    }) => string;
+    getThumbnailUrl: (parsed: {
+        provider: string;
+        videoId: string;
+    }, publicUrl: string, options?: {
+        signal?: AbortSignal;
+    }) => Promise<string | null>;
+}
+export interface JRCIframeVideoProps extends DataCy {
+    /** Public video URL provided by the user. */
+    url: string;
+    /**
+     * - 'view'    : thumbnail + click-to-load iframe inline (detail view)
+     * - 'compact' : thumbnail + click opens the source URL in a new tab
+     */
+    mode: 'view' | 'compact';
+    /** Aria label / iframe title — should describe the video content. */
+    title?: string;
+    /** Provider helpers injected by the consumer. */
+    helpers: JRCIframeVideoHelpers;
+    /** Corner radius in px. Defaults: 8 in view mode, 6 in compact. Pass 0 for square corners. */
+    borderRadius?: number;
+    /**
+     * View mode only — load the iframe immediately instead of waiting for a user click
+     * on the thumbnail. Disables the RGPD-friendly two-step gate. No effect in compact mode.
+     */
+    autoload?: boolean;
+    /**
+     * Background color of the view container, visible while the iframe is loading. Defaults to the
+     * theme's `grey1`. Pass `'transparent'` to let the parent's background show through (useful
+     * when the parent already paints a black backdrop, matching the provider's player chrome).
+     */
+    loadingBackground?: string;
+}
+/**
+ * Renders an embedded video with a click-to-load thumbnail (RGPD-friendly: the
+ * iframe is mounted only when the user clicks, never automatically).
+ *
+ * - `mode='view'`    : the iframe replaces the thumbnail in place
+ * - `mode='compact'` : the click opens the source URL in a new tab
+ *
+ * If the URL is unsafe (`javascript:` etc.) the component renders an error
+ * banner. If the URL is safe but no provider matches, it renders a degraded
+ * `<a target="_blank">` fallback.
+ */
+export declare const JRCIframeVideo: import('react').NamedExoticComponent<JRCIframeVideoProps>;

package/dist/src/components/JRCIframeVideo/JRCIframeVideo.stories.d.ts

@@ -0,0 +1,10 @@
+import { Meta, StoryObj } from '@storybook/react-vite';
+import { JRCIframeVideo } from './JRCIframeVideo';
+declare const meta: Meta<typeof JRCIframeVideo>;
+export default meta;
+type Story = StoryObj<typeof JRCIframeVideo>;
+export declare const View: Story;
+export declare const Compact: Story;
+export declare const UnsupportedProvider: Story;
+export declare const EmptyUrl: Story;
+export declare const UnsafeUrl: Story;

package/dist/src/components/Widgets/JRCWidgetYoutube/JRCWidgetYoutubeEditor.d.ts

@@ -0,0 +1,12 @@
+import { WidgetYoutubeContent } from 'jamespot-user-api';
+export interface JRCWidgetYoutubeEditorProps {
+    uniqid: string;
+    content: WidgetYoutubeContent;
+    onChangeContent: (uniqid: string, content: WidgetYoutubeContent) => void;
+    /**
+     * Optional URL validator. Returning false marks the field as invalid (empty values are not validated).
+     * Injected by the consumer so this component stays agnostic of provider detection logic.
+     */
+    validateUrl?: (url: string) => boolean;
+}
+export declare const JRCWidgetYoutubeEditor: ({ uniqid, content, onChangeContent, validateUrl, }: JRCWidgetYoutubeEditorProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/index.d.ts

@@ -98,6 +98,7 @@ export { JRCGrid } from './JRCGrid/JRCGrid';
 export { JRCHtml } from './JRCHtml/JRCHtml';
 export { JRCIcon } from './JRCIcon/JRCIcon';
 export { JRCIconButton } from './JRCIconButton/JRCIconButton';
+export { JRCIframeVideo } from './JRCIframeVideo/JRCIframeVideo';
 export { JRCImg } from './JRCImg/JRCImg';
 export { JRCList } from './JRCList/JRCList';
 export { JRCLoader } from './JRCLoader/JRCLoader';
@@ -198,4 +199,5 @@ export { JRCWidgetUserProfile } from './Widgets/JRCWidgetUserProfile/JRCWidgetUs
 export { JRCWidgetUserProfileEditor } from './Widgets/JRCWidgetUserProfile/JRCWidgetUserProfileEditor';
 export { JRCWidgetWelcome } from './Widgets/JRCWidgetWelcome/JRCWidgetWelcome';
 export { JRCWidgetWelcomeEditor } from './Widgets/JRCWidgetWelcome/JRCWidgetWelcomeEditor';
+export { JRCWidgetYoutubeEditor } from './Widgets/JRCWidgetYoutube/JRCWidgetYoutubeEditor';
 export { WidgetCalendarEditor } from './Widgets/WidgetCalendar/WidgetCalendarEditor';

package/dist/src/translation/lang.json.d.ts

@@ -213,6 +213,9 @@ declare const _default: {
         "GLOBAL_Form_SendAlert": "Send the alert email to those who have requested it",
         "GLOBAL_Go_To_Content": "Go to content",
         "GLOBAL_Groups": "Groups",
+        "GLOBAL_IframeVideo_InvalidUrl": "Invalid or unsafe URL",
+        "GLOBAL_IframeVideo_OpenInNewTab": "Open video in a new tab",
+        "GLOBAL_IframeVideo_Play": "Play video",
         "GLOBAL_Image": "Image",
         "GLOBAL_Import": "Import",
         "GLOBAL_Insert": "Insert",
@@ -460,7 +463,11 @@ declare const _default: {
         "WIDGET_User_Profil": "Profil utilisateur",
         "WIDGET_Welcome_Default_Message": "Bienvenue",
         "WIDGET_Welcome_Linebreak_Label": "Saut de ligne (après le message)",
-        "WIDGET_Welcome": "Message d'accueil"
+        "WIDGET_Welcome": "Message d'accueil",
+        "WIDGET_Youtube_Url": "Video URL",
+        "WIDGET_Youtube": "Video",
+        "WIDGET_Youtube_Text": "Embed a YouTube video",
+        "WIDGET_Youtube_InvalidUrl_FieldError": "Enter a valid YouTube URL"
     }
 }
 ;

package/dist/src/utils/index.d.ts

@@ -4,6 +4,7 @@ import * as document from './utils.document';
 import * as file from './utils.files';
 import * as form from './utils.form';
 import * as icons from './utils.icons';
+import * as iframeVideo from './utils.iframeVideo';
 import * as image from './utils.image';
 import * as misc from './utils.misc';
 import * as object from './utils.object';
@@ -17,6 +18,7 @@ export declare const Utils: {
     file: typeof file;
     form: typeof form;
     icons: typeof icons;
+    iframeVideo: typeof iframeVideo;
     image: typeof image;
     misc: typeof misc;
     object: typeof object;

package/dist/src/utils/utils.iframeVideo.d.ts

@@ -0,0 +1,48 @@
+/**
+ * iframeVideo — provider detection and URL transformation utilities.
+ *
+ * Centralises the regex / embed URL / thumbnail logic for the supported video
+ * providers. Pure functions, no React, no side effects beyond the thumbnail
+ * fetch (which calls public oEmbed endpoints from the providers themselves —
+ * no Jamespot backend involvement).
+ *
+ * Currently consumed: YouTube only (widget-youtube). The Vimeo / Dailymotion /
+ * Loom branches are intentional infra for upcoming widgets — do not remove
+ * without checking the corresponding ticket in the tracker.
+ */
+export type Provider = 'youtube' | 'vimeo' | 'dailymotion' | 'loom';
+export interface ParsedProvider {
+    provider: Provider;
+    videoId: string;
+}
+/**
+ * Type guard used by consumers to narrow a string-typed provider (e.g. coming
+ * from `JRCIframeVideoHelpers.toEmbedUrl` whose param is intentionally wide)
+ * back to the narrow `Provider` union before calling `toEmbedUrl` / `getThumbnailUrl`.
+ */
+export declare function isKnownProvider(value: string): value is Provider;
+/**
+ * Validate that the given string is an http/https URL with no dangerous scheme.
+ * Used as a defense-in-depth check before rendering anything iframe-related.
+ */
+export declare function isSafeUrl(input: unknown): boolean;
+/**
+ * Detect the video provider for an URL and extract the video id.
+ * Returns null if no supported provider matches.
+ */
+export declare function parseProvider(url: string): ParsedProvider | null;
+/**
+ * Build the embed iframe URL for a given provider + videoId.
+ * Always returns an https URL.
+ */
+export declare function toEmbedUrl(parsed: ParsedProvider): string;
+/**
+ * Resolve a thumbnail URL for a given provider + videoId.
+ *
+ * - YouTube: predictable static URL (no fetch needed).
+ * - Vimeo / Dailymotion: public oEmbed endpoint (no auth, cacheable by browser).
+ * - Loom: no public thumbnail API known — returns null, caller falls back.
+ */
+export declare function getThumbnailUrl(parsed: ParsedProvider, publicUrl: string, options?: {
+    signal?: AbortSignal;
+}): Promise<string | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamespot-react-components",
-  "version": "1.3.90",
+  "version": "1.3.91",
   "description": "",
   "main": "dist/jamespot-react-components.cjs",
   "module": "dist/jamespot-react-components.js",
@@ -59,8 +59,8 @@
     "eslint-plugin-storybook": "10.3.6",
     "globals": "^16.5.0",
     "html2canvas": "^1.4.1",
-    "jamespot-front-business": "^1.3.90",
-    "jamespot-user-api": "^1.3.90",
+    "jamespot-front-business": "^1.3.91",
+    "jamespot-user-api": "^1.3.91",
     "jsdom": "^26.1.0",
     "knip": "^5.88.1",
     "lint-staged": "^16.4.0",