uifolio 0.5.1 → 0.5.4

package/src/lib/uploader.ts

@@ -1,9 +1,9 @@
 export interface UploaderOptions {
-  /** Endpoint de signature. Défaut : /api/upload/sign */
+  /** Signing endpoint. Default: /api/upload/sign */
   signEndpoint?: string
-  /** Nombre de tentatives supplémentaires en cas d'échec. Défaut : 2 */
+  /** Number of extra attempts on failure. Default: 2 */
   retries?: number
-  /** Délai de base entre les tentatives (ms). Défaut : 800 */
+  /** Base delay between attempts (ms). Default: 800 */
   retryDelayMs?: number
 }
 
@@ -42,7 +42,7 @@ function putWithProgress(
         onProgress(1)
         resolvePromise()
       } else {
-        reject(new UploadError(`Le serveur a répondu ${request.status}`, request.status))
+        reject(new UploadError(`The server returned ${request.status}`, request.status))
       }
     }
     request.onerror = () => reject(new UploadError('Connexion interrompue pendant l’envoi'))
@@ -52,12 +52,12 @@ function putWithProgress(
 }
 
 /**
- * Uploader « réel » branché sur /api/upload/sign :
- *  1. demande une URL signée au serveur,
- *  2. envoie le fichier en PUT avec progression (XHR),
- *  3. réessaie automatiquement en réutilisant la même URL signée (reprise).
+ * “Real” uploader wired to /api/upload/sign:
+ *  1. asks the server for a signed URL,
+ *  2. sends the file with a PUT and progress (XHR),
+ *  3. retries automatically, reusing the same signed URL (resume).
  *
- * Renvoie l'URL publique du fichier déposé.
+ * Returns the public URL of the uploaded file.
  */
 export function createUploader(options: UploaderOptions = {}) {
   const {
@@ -73,7 +73,7 @@ export function createUploader(options: UploaderOptions = {}) {
       body: JSON.stringify({ name: file.name, size: file.size, type: file.type }),
     })
     if (!signResponse.ok) {
-      throw new UploadError(`Signature refusée (${signResponse.status})`, signResponse.status)
+      throw new UploadError(`Signature refused (${signResponse.status})`, signResponse.status)
     }
     const signed = (await signResponse.json()) as SignedUpload
 
@@ -85,7 +85,7 @@ export function createUploader(options: UploaderOptions = {}) {
       } catch (error) {
         lastError = error
         const status = error instanceof UploadError ? error.status : undefined
-        // 4xx = refus définitif (taille, clé, auth) : inutile de réessayer
+        // 4xx = final refusal (size, key, auth): no point retrying
         if (status !== undefined && status >= 400 && status < 500) break
         if (attempt < retries) {
           await new Promise((resolvePromise) =>
@@ -96,11 +96,11 @@ export function createUploader(options: UploaderOptions = {}) {
     }
     throw lastError instanceof Error
       ? lastError
-      : new UploadError('Échec de l’envoi après plusieurs tentatives')
+      : new UploadError('Upload failed after several attempts')
   }
 }
 
-/** File d'attente par URL signée : permet la reprise d'un envoi interrompu. */
+/** Queue per signed URL: allows resuming an interrupted upload. */
 export function resumeUpload(
   signed: SignedUpload,
   file: File,

package/src/lib/use-controllable.ts

@@ -1,14 +1,14 @@
 import { useCallback, useEffect, useRef, useState } from 'react'
 
 /**
- * Retourne un état local piloté par une prop quand celle-ci est explicite.
+ * Returns local state driven by a prop when that prop is explicit.
  *
- * Quand le parent fournit explicitement la prop, l'état local se
- * synchronise dessus. Quand la prop est `undefined`, le composant garde
- * sa propre valeur locale.
+ * When the parent explicitly provides the prop, the local state stays
+ * in sync with it. When the prop is `undefined`, the component keeps
+ * its own local value.
  *
- * Cette version est compatible avec React Compiler : elle n'accède jamais
- * aux refs pendant le rendu.
+ * This version is compatible with React Compiler: it never reads
+ * refs during render.
  */
 export function useControllableValue<T>(
   prop: T | undefined,
@@ -21,14 +21,14 @@ export function useControllableValue<T>(
 
   const isControlled = prop !== undefined
 
-  // Synchronise l'état local quand le contrôle parent change.
+  // Keeps the local state in sync when the parent control changes.
   useEffect(() => {
     controlledRef.current = isControlled
     previousPropRef.current = prop
   })
 
-  // Premier rendu contrôlé : la prop doit remplacer l'état local.
-  // Passages ultérieurs : synchronise seulement si la prop a changé.
+  // First controlled render: the prop must replace the local state.
+  // Later renders: only sync when the prop changed.
   useEffect(() => {
     if (!isControlled) return
     const next = prop as T

package/src/lib/use-hotkeys.ts

@@ -25,7 +25,7 @@ function matches(pattern: string, event: KeyboardEvent): boolean {
   return event.key.toLowerCase() === key
 }
 
-/** Enregistre des raccourcis globaux : `mod+k`, `shift+?`, `escape`, `arrowup`… */
+/** Registers global shortcuts: `mod+k`, `shift+?`, `escape`, `arrowup`… */
 export function useHotkeys(map: HotkeyMap, options: { enabled?: boolean } = {}) {
   const handlers = useRef(map)
   const enabled = options.enabled ?? true

package/src/lib/use-theme.ts

@@ -21,8 +21,8 @@ function applyTheme(theme: Theme) {
 }
 
 /**
- * Thème clair/sombre persistant. `system` suit la préférence système
- * tant que l'utilisateur n'a pas fait de choix explicite.
+ * Persistent light/dark theme. `system` follows the system preference
+ * until the user makes an explicit choice.
  */
 export function useTheme() {
   const [theme, setThemeState] = useState<Theme>(readTheme)

package/src/lib/video.ts

@@ -1,6 +1,6 @@
 /**
- * Helpers vidéo partagés par les composants de la librairie.
- * Aucune dépendance : copier ce fichier avec le composant suffit.
+ * Video helpers shared by the library components.
+ * No dependency: copying this file along with the component is enough.
  */
 
 export type PlayerSource =
@@ -28,7 +28,7 @@ export function toSourceList(input: PlayerSource | PlayerSource[]): PlayerSource
   return Array.isArray(input) ? input : [input]
 }
 
-/** Signature stable, utilisée pour ne pas recréer les object URLs à chaque render. */
+/** Stable signature, so object URLs are not recreated on every render. */
 export function sourceSignature(input: PlayerSource | PlayerSource[]): string {
   return toSourceList(input)
     .map((source) => {
@@ -75,7 +75,7 @@ export function youtubeThumbnailFallback(id: string): string {
   loop?: boolean
   muted?: boolean
   controls?: boolean
-  /** Origine de la page hôte : l'API iframe YouTube lui associe les commandes postMessage. */
+  /** Host page origin: the YouTube iframe API matches postMessage commands to it. */
   origin?: string
   playsinline?: boolean
 }
@@ -123,7 +123,7 @@ export function buildEmbedUrl(
 
 
 /* -------------------------------------------------------------------------- */
-/* Pilotage des embeds (YouTube / Vimeo) par postMessage                      */
+/* Driving the embeds (YouTube / Vimeo) through postMessage                   */
 /* -------------------------------------------------------------------------- */
 
 export type EmbedKind = 'youtube' | 'vimeo'
@@ -132,12 +132,12 @@ export type EmbedCommand =
   | { type: 'play' }
   | { type: 'pause' }
   | { type: 'seek'; time: number }
-  /** Volume normalisé 0–1, converti dans l'unité de chaque plateforme. */
+  /** Normalized volume 0–1, converted into each platform's unit. */
   | { type: 'volume'; volume: number }
   | { type: 'mute'; muted: boolean }
   | { type: 'rate'; rate: number }
 
-/** Message à poster dans l'iframe : chaîne JSON pour YouTube, objet pour Vimeo. */
+/** Message to post into the iframe: a JSON string for YouTube, an object for Vimeo. */
 export function embedCommand(
   kind: EmbedKind,
   command: EmbedCommand,
@@ -190,10 +190,10 @@ const VIMEO_EVENTS = [
   'playbackratechange',
 ]
 
-/** Messages à envoyer à l'iframe pour recevoir son état et ses événements. */
+/** Messages to send to the iframe to receive its state and events. */
 export function embedHandshake(kind: EmbedKind): Array<Record<string, unknown> | string> {
   if (kind === 'youtube') {
-    // Démarre l'émission des messages `infoDelivery` (temps, durée, état).
+    // Starts the `infoDelivery` messages (time, duration, state).
     return [JSON.stringify({ event: 'listening', id: 1, channel: 'widget' })]
   }
   return [
@@ -249,7 +249,7 @@ function parseYoutubeStatus(raw: unknown): EmbedStatus | null {
   if (duration !== undefined && duration > 0) status.duration = duration
 
   const playerState = toNumber(info.playerState)
-  // -1 non démarré, 0 terminé, 1 lecture, 2 pause, 3 buffering, 5 prêt.
+  // -1 unstarted, 0 ended, 1 playing, 2 paused, 3 buffering, 5 cued.
   if (playerState !== undefined) status.playing = playerState === 1 || playerState === 3
 
   const muted = info.muted
@@ -312,7 +312,7 @@ function parseVimeoStatus(raw: unknown): EmbedStatus | null {
   return null
 }
 
-/** Décode un message postMessage émis par l'iframe et en extrait l'état de lecture. */
+/** Decodes a postMessage sent by the iframe and extracts the playback state. */
 export function parseEmbedMessage(kind: EmbedKind, raw: unknown): EmbedStatus | null {
   return kind === 'youtube' ? parseYoutubeStatus(raw) : parseVimeoStatus(raw)
 }
@@ -335,7 +335,7 @@ export function formatTime(value: number): string {
   return `${minutes}:${paddedSeconds}`
 }
 
-/** "16/9" | 16/9 | 1.77 | "auto" -> valeur CSS aspect-ratio. */
+/** "16/9" | 16/9 | 1.77 | "auto" -> CSS aspect-ratio value. */
 export function toAspectRatio(value: string | number | undefined): string | undefined {
   if (value == null) return undefined
   if (typeof value === 'number') return String(value)

package/src/lib/vtt.ts

@@ -57,7 +57,7 @@ function cleanCueText(lines: string[]): string {
     .trim()
 }
 
-/** Parse un fichier WebVTT en cues. Tolérant : ignore entêtes, notes, styles et blocs invalides. */
+/** Parses a WebVTT file into cues. Tolerant: skips headers, notes, styles and invalid blocks. */
 export function parseVtt(raw: string): VttCue[] {
   const lines = raw
     .replace(/^\uFEFF/, '')