@wakastellar/ui 0.1.0

package/dist/context/index.d.ts

@@ -0,0 +1,8 @@
+export { ThemeProvider, useTheme } from './theme-provider';
+export type { ThemeContextValue, ThemeProviderProps, ThemeConfig, ThemeS3Config } from './theme-provider';
+export { ThemeProvider as LegacyThemeProvider, useTheme as useLegacyTheme } from './theme-context';
+export type { ThemeContextValue as LegacyThemeContextValue, ThemeProviderProps as LegacyThemeProviderProps } from './theme-context';
+export { LanguageProvider, useLanguage } from './language-context';
+export type { LanguageConfig, S3Config, LanguageProviderProps, LanguageContextValue } from './language-context';
+export { WakaProvider, useWaka } from './waka-provider';
+export type { WakaProviderConfig, WakaProviderProps } from './waka-provider';

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

@@ -0,0 +1,57 @@
+import * as React from "react";
+export interface S3Config {
+    /** URL de base du bucket S3 */
+    baseUrl: string;
+    /** Préfixe des fichiers (ex: "translations/") */
+    prefix?: string;
+    /** Extension des fichiers (défaut: "json") */
+    extension?: string;
+    /** Headers personnalisés pour les requêtes */
+    headers?: Record<string, string>;
+}
+export interface LanguageConfig {
+    code: string;
+    label: string;
+    flagEmoji?: string;
+    flag?: string;
+}
+export interface LanguageContextValue {
+    /** Langue courante */
+    currentLanguage: string;
+    /** Liste des langues disponibles */
+    languages: LanguageConfig[];
+    /** Changer de langue */
+    changeLanguage: (code: string) => Promise<void>;
+    /** État de chargement */
+    isLoading: boolean;
+    /** Traductions chargées */
+    loadedLanguages: Set<string>;
+}
+export interface LanguageProviderProps {
+    children: React.ReactNode;
+    /** Langues disponibles */
+    languages: LanguageConfig[];
+    /** Langue par défaut */
+    defaultLanguage?: string;
+    /** Configuration S3 (optionnel - si non fourni, utilise les traductions locales) */
+    s3Config?: S3Config;
+    /** Callback après changement de langue */
+    onLanguageChange?: (code: string) => void;
+}
+/**
+ * LanguageProvider
+ *
+ * Provider pour gérer les langues et charger les traductions depuis S3.
+ *
+ * Features:
+ * - Chargement dynamique des traductions depuis S3
+ * - Cache des traductions déjà chargées
+ * - Intégration avec i18next
+ * - Persistance dans localStorage
+ * - Support des traductions locales si pas de S3
+ */
+export declare function LanguageProvider({ children, languages, defaultLanguage, s3Config, onLanguageChange, }: LanguageProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook pour utiliser le contexte de langue
+ */
+export declare function useLanguage(): LanguageContextValue;

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

@@ -0,0 +1,39 @@
+import { WakaThemeConfig, ThemeConfigItem } from '../types/provider';
+import * as React from "react";
+export interface ThemeContextValue {
+    theme: string;
+    setTheme: (theme: string) => void;
+    themes: ThemeConfigItem[];
+    systemTheme?: string;
+    isLoadingThemes?: boolean;
+    themesSource?: "config" | "s3" | "fallback";
+}
+export interface ThemeProviderProps {
+    children: React.ReactNode;
+    config?: WakaThemeConfig;
+}
+/**
+ * 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
+ * Charge automatiquement les thèmes depuis S3 si non fournis dans la config
+ *
+ * @example
+ * ```tsx
+ * <ThemeProvider config={{ defaultTheme: "light", themes: ["light", "dark"] }}>
+ *   <App />
+ * </ThemeProvider>
+ * ```
+ */
+export declare function ThemeProvider({ children, config }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook pour accéder au contexte du thème
+ *
+ * @throws {Error} Si utilisé en dehors d'un ThemeProvider
+ *
+ * @example
+ * ```tsx
+ * const { theme, setTheme, themes } = useTheme()
+ * ```
+ */
+export declare function useTheme(): ThemeContextValue;

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

@@ -0,0 +1,74 @@
+import * as React from "react";
+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;
+}
+export interface ThemeConfig {
+    /** Identifiant du thème (utilisé dans data-theme) */
+    id: string;
+    /** Nom d'affichage */
+    label: string;
+    /** Description optionnelle */
+    description?: string;
+    /** Couleur représentative du thème (pour preview) */
+    previewColor?: string;
+}
+export interface ThemeContextValue {
+    /** Thème courant */
+    currentTheme: string;
+    /** Liste des thèmes disponibles */
+    themes: ThemeConfig[];
+    /** Changer de thème */
+    changeTheme: (id: string) => Promise<void>;
+    /** État de chargement */
+    isLoading: boolean;
+    /** Thèmes chargés */
+    loadedThemes: Set<string>;
+    /** Mode dark actif */
+    isDarkMode: boolean;
+    /** Basculer le mode dark/light */
+    toggleDarkMode: () => void;
+    /** Précharger un thème */
+    preloadTheme: (id: string) => Promise<void>;
+    /** Vérifier si un thème est chargé */
+    isThemeLoaded: (id: string) => boolean;
+}
+export interface ThemeProviderProps {
+    children: React.ReactNode;
+    /** Thèmes disponibles */
+    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;
+    /** Activer le mode sombre (optionnel) */
+    enableDarkMode?: boolean;
+}
+/**
+ * ThemeProvider
+ *
+ * Provider pour gérer les thèmes et charger les CSS depuis S3 avec support TweakCN.
+ *
+ * Features:
+ * - Chargement dynamique des thèmes depuis S3
+ * - Cache des thèmes déjà chargés
+ * - Support TweakCN avec data-theme
+ * - Persistance dans localStorage
+ * - Préchargement de thèmes
+ * - Support des thèmes locaux si pas de S3
+ */
+export declare function ThemeProvider({ children, themes, defaultTheme, s3Config, onThemeChange, enableDarkMode, }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook pour utiliser le ThemeProvider
+ */
+export declare function useTheme(): ThemeContextValue;

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

@@ -0,0 +1,50 @@
+import { WakaProviderConfig, WakaProviderProps } from '../types/provider';
+/**
+ * WakaProvider - Provider principal pour WakaStart UI
+ *
+ * Centralise la configuration du thème, de la langue et des traductions S3
+ *
+ * @example
+ * ```tsx
+ * <WakaProvider config={{
+ *   theme: {
+ *     defaultTheme: "light",
+ *     themes: ["light", "dark", "forest"],
+ *     enableSystem: true
+ *   },
+ *   language: {
+ *     defaultLanguage: "fr",
+ *     supportedLanguages: ["fr", "en"],
+ *     s3Config: {
+ *       bucketUrl: "https://my-bucket.s3.amazonaws.com",
+ *       translationsPath: "translations"
+ *     }
+ *   }
+ * }}>
+ *   <App />
+ * </WakaProvider>
+ * ```
+ */
+export declare function WakaProvider({ children, config }: WakaProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook pour accéder à la configuration du WakaProvider
+ *
+ * @example
+ * ```tsx
+ * const { changeLanguage, changeTheme, t } = useWaka()
+ * ```
+ */
+export declare function useWaka(): {
+    currentLanguage: string;
+    changeLanguage: (lang: string) => Promise<void>;
+    languages: import('./language-context').LanguageConfig[];
+    isLanguageLoading: boolean;
+    currentTheme: string;
+    changeTheme: (id: string) => Promise<void>;
+    themes: import('./theme-provider').ThemeConfig[];
+    isThemeLoading: boolean;
+    preloadTheme: (id: string) => Promise<void>;
+    isThemeLoaded: (id: string) => boolean;
+    t: import('i18next').TFunction<"translation", undefined>;
+};
+export type { WakaProviderConfig, WakaProviderProps };

package/dist/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useToast, toast } from './use-toast';

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

@@ -0,0 +1,44 @@
+import { ToastActionElement, ToastProps } from '../components/toast';
+import * as React from "react";
+type ToasterToast = ToastProps & {
+    id: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    action?: ToastActionElement;
+};
+declare const actionTypes: {
+    readonly ADD_TOAST: "ADD_TOAST";
+    readonly UPDATE_TOAST: "UPDATE_TOAST";
+    readonly DISMISS_TOAST: "DISMISS_TOAST";
+    readonly REMOVE_TOAST: "REMOVE_TOAST";
+};
+type ActionType = typeof actionTypes;
+type Action = {
+    type: ActionType["ADD_TOAST"];
+    toast: ToasterToast;
+} | {
+    type: ActionType["UPDATE_TOAST"];
+    toast: Partial<ToasterToast>;
+} | {
+    type: ActionType["DISMISS_TOAST"];
+    toastId?: ToasterToast["id"];
+} | {
+    type: ActionType["REMOVE_TOAST"];
+    toastId?: ToasterToast["id"];
+};
+interface State {
+    toasts: ToasterToast[];
+}
+export declare const reducer: (state: State, action: Action) => State;
+type Toast = Omit<ToasterToast, "id">;
+declare function toast({ ...props }: Toast): {
+    id: string;
+    dismiss: () => void;
+    update: (props: ToasterToast) => void;
+};
+declare function useToast(): {
+    toast: typeof toast;
+    dismiss: (toastId?: string) => void;
+    toasts: ToasterToast[];
+};
+export { useToast, toast };

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

@@ -0,0 +1,15 @@
+/**
+ * Hook pour utiliser les traductions dans les composants
+ *
+ * Wrapper autour de useTranslation de react-i18next qui s'assure
+ * que i18next est correctement initialisé avant de retourner les fonctions.
+ *
+ * Si i18next n'est pas encore prêt, retourne la clé de traduction telle quelle.
+ *
+ * @example
+ * ```tsx
+ * const { t } = useTranslation()
+ * return <div>{t('hello')}</div>
+ * ```
+ */
+export declare function useTranslation(): any;

package/dist/hooks/useToast.d.ts

@@ -0,0 +1,44 @@
+import { ToastActionElement, ToastProps } from '../components/toast';
+import * as React from "react";
+type ToasterToast = ToastProps & {
+    id: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    action?: ToastActionElement;
+};
+declare const actionTypes: {
+    readonly ADD_TOAST: "ADD_TOAST";
+    readonly UPDATE_TOAST: "UPDATE_TOAST";
+    readonly DISMISS_TOAST: "DISMISS_TOAST";
+    readonly REMOVE_TOAST: "REMOVE_TOAST";
+};
+type ActionType = typeof actionTypes;
+type Action = {
+    type: ActionType["ADD_TOAST"];
+    toast: ToasterToast;
+} | {
+    type: ActionType["UPDATE_TOAST"];
+    toast: Partial<ToasterToast>;
+} | {
+    type: ActionType["DISMISS_TOAST"];
+    toastId?: ToasterToast["id"];
+} | {
+    type: ActionType["REMOVE_TOAST"];
+    toastId?: ToasterToast["id"];
+};
+interface State {
+    toasts: ToasterToast[];
+}
+export declare const reducer: (state: State, action: Action) => State;
+type Toast = Omit<ToasterToast, "id">;
+declare function toast({ ...props }: Toast): {
+    id: string;
+    dismiss: () => void;
+    update: (props: ToasterToast) => void;
+};
+declare function useToast(): {
+    toast: typeof toast;
+    dismiss: (toastId?: string) => void;
+    toasts: ToasterToast[];
+};
+export { useToast, toast };