@wakastellar/ui 0.6.0 → 1.0.2

package/dist/context/language-context.d.ts

@@ -1,211 +1,57 @@
-import { WakaError } from '../utils/error-handling';
-/**
- * @fileoverview Contexte de gestion des langues pour WakaStart UI
- *
- * Ce module fournit un système complet de gestion de l'internationalisation:
- * - Chargement dynamique des traductions depuis URL ou inline JSON
- * - Cache des traductions déjà chargées
- * - Intégration transparente avec i18next
- * - Persistance de la langue dans localStorage
- * - Chargement à la volée de traductions JSON
- *
- * @module context/language-context
- */
 import * as React from "react";
-/**
- * Format standard i18n pour les traductions
- * Compatible avec i18next resource bundles
- *
- * @example
- * ```json
- * {
- *   "common": {
- *     "save": "Enregistrer",
- *     "cancel": "Annuler",
- *     "confirm": "Confirmer"
- *   },
- *   "errors": {
- *     "required": "Ce champ est requis",
- *     "invalid_email": "Email invalide"
- *   }
- * }
- * ```
- */
-export type I18nTranslations = Record<string, string | Record<string, unknown>>;
-/**
- * Configuration d'une langue disponible
- */
-export interface LanguageConfig {
-    /** Code ISO de la langue (ex: "fr", "en", "es") */
-    code: string;
-    /** Libellé d'affichage */
-    label: string;
-    /** Emoji du drapeau (optionnel) */
-    flagEmoji?: string;
-    /** URL de l'image du drapeau (optionnel) */
-    flag?: string;
-    /**
-     * Traductions inline au format i18n JSON
-     * Si fourni, les traductions sont utilisées directement
-     */
-    translations?: I18nTranslations;
-    /**
-     * URL pour charger le JSON des traductions (optionnel)
-     * Le JSON doit être au format I18nTranslations
-     */
-    jsonUrl?: string;
-}
-/**
- * Configuration pour le chargement distant (legacy, utiliser jsonUrl dans LanguageConfig)
- * @deprecated Utiliser `jsonUrl` dans LanguageConfig à la place
- */
 export interface S3Config {
-    /** URL de base */
+    /** URL de base du bucket S3 */
     baseUrl: string;
-    /** Préfixe des fichiers */
+    /** Préfixe des fichiers (ex: "translations/") */
     prefix?: string;
     /** Extension des fichiers (défaut: "json") */
     extension?: string;
-    /** Headers HTTP personnalisés */
+    /** Headers personnalisés pour les requêtes */
     headers?: Record<string, string>;
 }
-/**
- * Type pour les traductions JSON (alias pour compatibilité)
- */
-export type TranslationsJSON = I18nTranslations;
-/**
- * Valeur exposée par le contexte de langue
- */
+export interface LanguageConfig {
+    code: string;
+    label: string;
+    flagEmoji?: string;
+    flag?: string;
+}
 export interface LanguageContextValue {
-    /** Code de la langue actuellement active */
+    /** Langue courante */
     currentLanguage: string;
-    /** Liste des langues disponibles configurées */
+    /** Liste des langues disponibles */
     languages: LanguageConfig[];
-    /** Change la langue active et charge les traductions si nécessaire */
+    /** Changer de langue */
     changeLanguage: (code: string) => Promise<void>;
-    /** Indique si un chargement de traductions est en cours */
+    /** État de chargement */
     isLoading: boolean;
-    /** Set des codes de langues dont les traductions sont chargées */
+    /** Traductions chargées */
     loadedLanguages: Set<string>;
-    /**
-     * Charge des traductions depuis un objet JSON à la volée
-     * @param langCode - Code de la langue
-     * @param translations - Traductions au format i18n JSON
-     * @param apply - Si true, change aussi la langue courante (défaut: true)
-     */
-    loadLanguageFromJSON: (langCode: string, translations: I18nTranslations, apply?: boolean) => Promise<void>;
-    /**
-     * Ajoute/met à jour une langue dans la liste
-     * @param config - Configuration de la langue
-     */
-    addLanguage: (config: LanguageConfig) => void;
-    /**
-     * Recharge les traductions d'une langue depuis son URL
-     * @param langCode - Code de la langue à recharger
-     */
-    reloadLanguage: (langCode: string) => Promise<void>;
 }
-/**
- * Props du provider de langue
- */
 export interface LanguageProviderProps {
-    /** Composants enfants */
     children: React.ReactNode;
-    /** Liste des langues disponibles dans l'application */
+    /** Langues disponibles */
     languages: LanguageConfig[];
-    /** Code de la langue par défaut (défaut: "fr") */
+    /** Langue par défaut */
     defaultLanguage?: string;
-    /**
-     * Configuration S3 (legacy)
-     * @deprecated Utiliser `jsonUrl` dans chaque LanguageConfig à la place
-     */
+    /** Configuration S3 (optionnel - si non fourni, utilise les traductions locales) */
     s3Config?: S3Config;
-    /** Callback appelé après chaque changement de langue réussi */
+    /** Callback après changement de langue */
     onLanguageChange?: (code: string) => void;
-    /** Callback en cas d'erreur */
-    onError?: (error: WakaError) => void;
-    /** Headers personnalisés pour les requêtes fetch */
-    fetchHeaders?: Record<string, string>;
-    /** Timeout en millisecondes pour les requêtes fetch (défaut: 10000) */
-    fetchTimeout?: number;
 }
 /**
  * LanguageProvider
  *
- * Provider pour la gestion de l'internationalisation avec support
- * du chargement dynamique de traductions JSON.
+ * Provider pour gérer les langues et charger les traductions depuis S3.
  *
  * Features:
- * - Traductions inline ou chargées depuis URL
- * - Chargement à la volée via loadLanguageFromJSON()
+ * - Chargement dynamique des traductions depuis S3
  * - Cache des traductions déjà chargées
  * - Intégration avec i18next
  * - Persistance dans localStorage
- *
- * @example
- * ```tsx
- * // Configuration avec traductions inline
- * <LanguageProvider
- *   languages={[
- *     {
- *       code: "fr",
- *       label: "Français",
- *       flagEmoji: "🇫🇷",
- *       translations: {
- *         common: { save: "Enregistrer", cancel: "Annuler" }
- *       }
- *     },
- *     {
- *       code: "en",
- *       label: "English",
- *       flagEmoji: "🇬🇧",
- *       jsonUrl: "https://example.com/i18n/en.json"
- *     }
- *   ]}
- *   defaultLanguage="fr"
- * >
- *   <App />
- * </LanguageProvider>
- * ```
+ * - Support des traductions locales si pas de S3
  */
-export declare function LanguageProvider({ children, languages: initialLanguages, defaultLanguage, s3Config, onLanguageChange, onError, fetchHeaders, fetchTimeout, }: LanguageProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function LanguageProvider({ children, languages, defaultLanguage, s3Config, onLanguageChange, }: LanguageProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
- * Hook pour accéder au contexte de langue
- *
- * @throws {Error} Si utilisé en dehors d'un LanguageProvider
- *
- * @example
- * ```tsx
- * function LanguageSwitcher() {
- *   const { currentLanguage, languages, changeLanguage, isLoading } = useLanguage()
- *
- *   return (
- *     <select
- *       value={currentLanguage}
- *       onChange={(e) => changeLanguage(e.target.value)}
- *       disabled={isLoading}
- *     >
- *       {languages.map((lang) => (
- *         <option key={lang.code} value={lang.code}>
- *           {lang.flagEmoji} {lang.label}
- *         </option>
- *       ))}
- *     </select>
- *   )
- * }
- *
- * // Charger des traductions à la volée
- * function LoadCustomTranslations() {
- *   const { loadLanguageFromJSON } = useLanguage()
- *
- *   const handleLoad = async () => {
- *     await loadLanguageFromJSON("custom", {
- *       common: { hello: "Bonjour" }
- *     })
- *   }
- *
- *   return <button onClick={handleLoad}>Load Custom</button>
- * }
- * ```
+ * Hook pour utiliser le contexte de langue
  */
 export declare function useLanguage(): LanguageContextValue;

package/dist/context/theme-context.d.ts

@@ -6,18 +6,17 @@ export interface ThemeContextValue {
     themes: ThemeConfigItem[];
     systemTheme?: string;
     isLoadingThemes?: boolean;
-    themesSource?: "config" | "fallback";
+    themesSource?: "config" | "s3" | "fallback";
 }
 export interface ThemeProviderProps {
     children: React.ReactNode;
     config?: WakaThemeConfig;
 }
 /**
- * Provider de thème legacy pour WakaStart UI
+ * Provider de thème pour WakaStart UI
  *
  * Gère le thème actif, le stockage dans localStorage et la détection du thème système
- *
- * @deprecated Utiliser ThemeProvider de theme-provider.tsx avec support shadcn registry-item
+ * Charge automatiquement les thèmes depuis S3 si non fournis dans la config
  *
  * @example
  * ```tsx

package/dist/context/theme-provider.d.ts

@@ -1,34 +1,16 @@
-import { WakaError } from '../utils/error-handling';
 import * as React from "react";
-/**
- * Format shadcn/ui registry-item pour les thèmes
- * Compatible avec https://ui.shadcn.com/schema/registry-item.json
- */
-export interface ShadcnRegistryItem {
-    /** Schema URL (optionnel) */
-    $schema?: string;
-    /** Nom du thème */
-    name: string;
-    /** Type de registry item */
-    type?: "registry:style" | "registry:theme" | string;
-    /** CSS personnalisé avec support @layer */
-    css?: {
-        "@layer base"?: Record<string, Record<string, string>>;
-        [selector: string]: Record<string, string> | Record<string, Record<string, string>> | undefined;
-    };
-    /** Variables CSS par mode */
-    cssVars?: {
-        /** Variables communes au thème (fonts, radius, etc.) */
-        theme?: Record<string, string>;
-        /** Variables mode clair */
-        light?: Record<string, string>;
-        /** Variables mode sombre */
-        dark?: Record<string, string>;
-    };
+export interface ThemeS3Config {
+    /** URL de base du bucket S3 */
+    baseUrl: string;
+    /** Préfixe des fichiers (ex: "themes/") */
+    prefix?: string;
+    /** Extension des fichiers (défaut: "css") */
+    extension?: string;
+    /** Headers personnalisés pour les requêtes */
+    headers?: Record<string, string>;
+    /** Timeout en millisecondes */
+    timeout?: number;
 }
-/**
- * Configuration d'un thème
- */
 export interface ThemeConfig {
     /** Identifiant du thème (utilisé dans data-theme) */
     id: string;
@@ -38,16 +20,6 @@ export interface ThemeConfig {
     description?: string;
     /** Couleur représentative du thème (pour preview) */
     previewColor?: string;
-    /**
-     * Données du thème au format shadcn registry-item
-     * C'est le format recommandé pour définir les thèmes
-     */
-    registryItem?: ShadcnRegistryItem;
-    /**
-     * URL pour charger le JSON du thème (optionnel)
-     * Le JSON doit être au format ShadcnRegistryItem
-     */
-    jsonUrl?: string;
 }
 export interface ThemeContextValue {
     /** Thème courant */
@@ -68,12 +40,6 @@ export interface ThemeContextValue {
     preloadTheme: (id: string) => Promise<void>;
     /** Vérifier si un thème est chargé */
     isThemeLoaded: (id: string) => boolean;
-    /**
-     * Charger un thème depuis un objet JSON
-     * @param themeId - ID du thème à créer/mettre à jour
-     * @param registryItem - Données au format shadcn registry-item
-     */
-    loadThemeFromJSON: (themeId: string, registryItem: ShadcnRegistryItem) => Promise<void>;
 }
 export interface ThemeProviderProps {
     children: React.ReactNode;
@@ -81,31 +47,27 @@ export interface ThemeProviderProps {
     themes: ThemeConfig[];
     /** Thème par défaut */
     defaultTheme?: string;
+    /** Configuration S3 (optionnel - si non fourni, utilise les thèmes locaux) */
+    s3Config?: ThemeS3Config;
     /** Callback après changement de thème */
     onThemeChange?: (id: string) => void;
-    /** Callback en cas d'erreur */
-    onError?: (error: WakaError) => void;
     /** Activer le mode sombre (optionnel) */
     enableDarkMode?: boolean;
-    /** Headers personnalisés pour les requêtes fetch (optionnel) */
-    fetchHeaders?: Record<string, string>;
-    /** Timeout en millisecondes pour les requêtes fetch (défaut: 10000) */
-    fetchTimeout?: number;
 }
 /**
  * ThemeProvider
  *
- * Provider pour gérer les thèmes avec support du format shadcn/ui registry-item.
+ * Provider pour gérer les thèmes et charger les CSS depuis S3 avec support TweakCN.
  *
  * Features:
- * - Support complet du format shadcn registry-item JSON
- * - Chargement dynamique depuis URL ou inline
+ * - Chargement dynamique des thèmes depuis S3
  * - Cache des thèmes déjà chargés
- * - Support @layer base pour styles personnalisés
+ * - Support TweakCN avec data-theme
  * - Persistance dans localStorage
- * - Support dark mode
+ * - Préchargement de thèmes
+ * - Support des thèmes locaux si pas de S3
  */
-export declare function ThemeProvider({ children, themes, defaultTheme, onThemeChange, onError, enableDarkMode, fetchHeaders, fetchTimeout, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ThemeProvider({ children, themes, defaultTheme, s3Config, onThemeChange, enableDarkMode, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Hook pour utiliser le ThemeProvider
  */

package/dist/context/waka-provider.d.ts

@@ -2,66 +2,23 @@ import { WakaProviderConfig, WakaProviderProps } from '../types/provider';
 /**
  * WakaProvider - Provider principal pour WakaStart UI
  *
- * Centralise la configuration du thème et de la langue.
- * Fonctionne avec des thèmes/traductions inline (sans dépendance S3)
- * ou avec S3 pour un chargement distant.
+ * Centralise la configuration du thème, de la langue et des traductions S3
  *
  * @example
  * ```tsx
- * // Configuration avec thèmes et traductions inline (sans S3)
  * <WakaProvider config={{
  *   theme: {
  *     defaultTheme: "light",
- *     themes: [
- *       {
- *         id: "light",
- *         label: "Clair",
- *         cssVars: {
- *           "--background": "0 0% 100%",
- *           "--foreground": "222.2 84% 4.9%"
- *         }
- *       },
- *       {
- *         id: "dark",
- *         label: "Sombre",
- *         cssVars: {
- *           "--background": "222.2 84% 4.9%",
- *           "--foreground": "210 40% 98%"
- *         }
- *       }
- *     ]
+ *     themes: ["light", "dark", "forest"],
+ *     enableSystem: true
  *   },
  *   language: {
  *     defaultLanguage: "fr",
  *     supportedLanguages: ["fr", "en"],
- *     languages: [
- *       {
- *         code: "fr",
- *         label: "Français",
- *         translations: { common: { save: "Enregistrer" } }
- *       },
- *       {
- *         code: "en",
- *         label: "English",
- *         translations: { common: { save: "Save" } }
- *       }
- *     ]
- *   }
- * }}>
- *   <App />
- * </WakaProvider>
- *
- * // Configuration avec S3 (chargement distant)
- * <WakaProvider config={{
- *   theme: {
- *     defaultTheme: "light",
- *     themes: [{ id: "light", label: "Clair" }],
- *     s3Config: { baseUrl: "https://cdn.example.com/themes" }
- *   },
- *   language: {
- *     defaultLanguage: "fr",
- *     supportedLanguages: ["fr", "en"],
- *     s3Config: { bucketUrl: "https://cdn.example.com", translationsPath: "i18n" }
+ *     s3Config: {
+ *       bucketUrl: "https://my-bucket.s3.amazonaws.com",
+ *       translationsPath: "translations"
+ *     }
  *   }
  * }}>
  *   <App />

package/dist/hooks/use-toast.d.ts

@@ -1,34 +1,11 @@
 import { ToastActionElement, ToastProps } from '../components/toast';
-/**
- * @fileoverview Hook de gestion des notifications toast
- *
- * Ce module fournit un système de notifications toast avec:
- * - Gestion d'état globale via un reducer
- * - Limite configurable du nombre de toasts
- * - Suppression automatique après un délai
- * - API simple pour créer, mettre à jour et fermer les toasts
- *
- * @module hooks/use-toast
- */
 import * as React from "react";
-/**
- * Type représentant un toast dans le système
- * Étend ToastProps avec des propriétés additionnelles pour la gestion
- */
 type ToasterToast = ToastProps & {
-    /** Identifiant unique du toast */
     id: string;
-    /** Titre du toast */
     title?: React.ReactNode;
-    /** Description/contenu du toast */
     description?: React.ReactNode;
-    /** Élément d'action optionnel (bouton, lien, etc.) */
     action?: ToastActionElement;
 };
-/**
- * Types d'actions disponibles pour le reducer de toasts
- * @internal
- */
 declare const actionTypes: {
     readonly ADD_TOAST: "ADD_TOAST";
     readonly UPDATE_TOAST: "UPDATE_TOAST";
@@ -36,10 +13,6 @@ declare const actionTypes: {
     readonly REMOVE_TOAST: "REMOVE_TOAST";
 };
 type ActionType = typeof actionTypes;
-/**
- * Union type des actions possibles pour le reducer de toasts
- * @internal
- */
 type Action = {
     type: ActionType["ADD_TOAST"];
     toast: ToasterToast;
@@ -53,108 +26,19 @@ type Action = {
     type: ActionType["REMOVE_TOAST"];
     toastId?: ToasterToast["id"];
 };
-/**
- * État du gestionnaire de toasts
- */
 interface State {
-    /** Liste des toasts actuellement affichés */
     toasts: ToasterToast[];
 }
-/**
- * Reducer pour gérer l'état des toasts
- *
- * @param state - État actuel
- * @param action - Action à exécuter
- * @returns Nouvel état
- *
- * @example
- * ```ts
- * // Ajouter un toast
- * reducer(state, { type: "ADD_TOAST", toast: { id: "1", title: "Hello" } })
- *
- * // Fermer un toast
- * reducer(state, { type: "DISMISS_TOAST", toastId: "1" })
- * ```
- */
 export declare const reducer: (state: State, action: Action) => State;
-/**
- * Type pour les props d'un nouveau toast (sans l'ID qui est généré automatiquement)
- */
 type Toast = Omit<ToasterToast, "id">;
-/**
- * Crée et affiche un nouveau toast
- *
- * @param props - Propriétés du toast (title, description, variant, action, etc.)
- * @returns Objet avec l'ID du toast et les méthodes dismiss/update
- *
- * @example
- * ```tsx
- * // Toast simple
- * toast({ title: "Succès", description: "Opération réussie" })
- *
- * // Toast avec action
- * toast({
- *   title: "Nouveau message",
- *   description: "Vous avez reçu un message",
- *   action: <ToastAction altText="Voir">Voir</ToastAction>
- * })
- *
- * // Toast destructif
- * toast({
- *   variant: "destructive",
- *   title: "Erreur",
- *   description: "Une erreur est survenue"
- * })
- *
- * // Contrôler le toast
- * const { id, dismiss, update } = toast({ title: "Chargement..." })
- * // Plus tard...
- * update({ title: "Terminé!" })
- * // Ou...
- * dismiss()
- * ```
- */
 declare function toast({ ...props }: Toast): {
-    /** Identifiant unique du toast créé */
     id: string;
-    /** Ferme le toast */
     dismiss: () => void;
-    /** Met à jour le toast avec de nouvelles propriétés */
     update: (props: ToasterToast) => void;
 };
-/**
- * Hook pour accéder au système de toasts
- *
- * Fournit l'état actuel des toasts et les méthodes pour les gérer.
- *
- * @returns Objet contenant les toasts, la fonction toast() et dismiss()
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   const { toast, toasts, dismiss } = useToast()
- *
- *   const handleClick = () => {
- *     toast({
- *       title: "Hello!",
- *       description: "Ceci est une notification"
- *     })
- *   }
- *
- *   return (
- *     <button onClick={handleClick}>
- *       Afficher toast
- *     </button>
- *   )
- * }
- * ```
- */
 declare function useToast(): {
-    /** Fonction pour créer un nouveau toast */
     toast: typeof toast;
-    /** Fonction pour fermer un toast spécifique ou tous les toasts */
     dismiss: (toastId?: string) => void;
-    /** Liste des toasts actuellement affichés */
     toasts: ToasterToast[];
 };
 export { useToast, toast };

package/dist/hooks/use-translation.d.ts

@@ -1,22 +1,3 @@
-import { default as i18n } from '../lib/i18n';
-/**
- * Type pour les options de traduction
- */
-type TranslationOptions = Record<string, string | number | boolean> & {
-    defaultValue?: string;
-};
-/**
- * Type pour la fonction de traduction
- */
-type TranslationFunction = (key: string, options?: TranslationOptions) => string;
-/**
- * Type de retour du hook useTranslation
- */
-interface TranslationResult {
-    t: TranslationFunction;
-    i18n: typeof i18n;
-    ready: boolean;
-}
 /**
  * Hook pour utiliser les traductions dans les composants
  *
@@ -25,14 +6,10 @@ interface TranslationResult {
  *
  * Si i18next n'est pas encore prêt, retourne la clé de traduction telle quelle.
  *
- * @param namespace - Namespace i18n optionnel
- * @returns Objet contenant la fonction t, l'instance i18n et l'état ready
- *
  * @example
  * ```tsx
  * const { t } = useTranslation()
  * return <div>{t('hello')}</div>
  * ```
  */
-export declare function useTranslation(namespace?: string): TranslationResult;
-export {};
+export declare function useTranslation(): any;