@gaddario98/react-core 2.0.2 → 2.0.4

package/dist/localization/index.d.ts

@@ -0,0 +1,155 @@
+import * as _gaddario98_react_state from '@gaddario98/react-state';
+
+type Locale = string;
+type TranslationResources = Record<string, any>;
+/**
+ * Opzioni di formattazione per i diversi tipi di valori
+ */
+interface FormatOptions {
+    number?: Intl.NumberFormatOptions;
+    date?: Intl.DateTimeFormatOptions;
+    currency?: Intl.NumberFormatOptions & {
+        currency?: string;
+    };
+}
+/**
+ * Opzioni per la traduzione con supporto parametri avanzati
+ */
+interface TranslationOptions {
+    [key: string]: any;
+    defaultValue?: string;
+    /**
+     * Opzioni di formattazione per i parametri specifici
+     *
+     * @example
+     * ```ts
+     * t('welcome', {
+     *   price: 1234.56,
+     *   formatOptions: {
+     *     price: {
+     *       currency: { currency: 'EUR', minimumFractionDigits: 2 }
+     *     }
+     *   }
+     * })
+     * ```
+     */
+    formatOptions?: Record<string, FormatOptions>;
+    ns?: string;
+}
+/**
+ * Funzione di traduzione con supporto parametri avanzati
+ *
+ * @example Interpolazione semplice
+ * ```ts
+ * t('welcome', { name: 'Mario' })
+ * // "Benvenuto {{name}}" -> "Benvenuto Mario"
+ * ```
+ *
+ * @example Formattazione numeri
+ * ```ts
+ * t('items_count', { count: 1000 })
+ * // "Hai {{count, number}} elementi" -> "Hai 1,000 elementi"
+ * ```
+ *
+ * @example Formattazione date
+ * ```ts
+ * t('last_login', { date: new Date() })
+ * // "Ultimo accesso: {{date, date}}" -> "Ultimo accesso: 15/12/2025"
+ * ```
+ *
+ * @example Formattazione valuta
+ * ```ts
+ * t('total', {
+ *   price: 99.99,
+ *   formatOptions: {
+ *     price: { currency: { currency: 'EUR' } }
+ *   }
+ * })
+ * // "Totale: {{price, currency}}" -> "Totale: €99.99"
+ * ```
+ *
+ * @example Pluralizzazione
+ * ```ts
+ * t('items', { count: 0 })
+ * // "{{count, plural, =0{Nessun elemento} one{Un elemento} other{# elementi}}}"
+ * // -> "Nessun elemento"
+ *
+ * t('items', { count: 1 })
+ * // -> "Un elemento"
+ *
+ * t('items', { count: 5 })
+ * // -> "5 elementi"
+ * ```
+ *
+ * @example Selezione
+ * ```ts
+ * t('greeting', { gender: 'male' })
+ * // "{{gender, select, male{Benvenuto} female{Benvenuta} other{Benvenuto/a}}}"
+ * // -> "Benvenuto"
+ * ```
+ */
+type TranslateFunction = (key: string, options?: TranslationOptions) => string;
+interface I18nConfig {
+    defaultLocale: Locale;
+    supportedLocales: Array<Locale>;
+}
+
+interface LocalizationConfigProps {
+    currentLocale: Locale;
+    locales: Record<Locale, TranslationResources>;
+}
+declare const localizationConfigAtom: _gaddario98_react_state.PrimitiveAtom<LocalizationConfigProps>;
+declare const useLocalizationConfigValue: () => LocalizationConfigProps;
+declare const useLocalizationConfigState: () => [LocalizationConfigProps, (value: LocalizationConfigProps) => void];
+declare const useLocalizationConfigReset: () => () => void;
+/**
+ * Hook per gestire le operazioni di localization
+ */
+declare const useLocalizationActions: () => {
+    /**
+     * Aggiunge o aggiorna una locale con le sue risorse
+     */
+    addLocale: (locale: Locale, resources: TranslationResources) => void;
+    /**
+     * Switch alla locale specificata
+     */
+    switchLocale: (locale: Locale) => void;
+    /**
+     * Inizializza con una locale di default
+     */
+    initializeLocale: (locale: Locale, resources: TranslationResources) => void;
+};
+
+/**
+ * Funzione core per risolvere una traduzione.
+ */
+declare const resolveTranslation: (key: string, resources: TranslationResources, options?: TranslationOptions, locale?: string) => string;
+
+declare const useTranslation: (_ns?: string) => {
+    t: TranslateFunction;
+    locale: Locale;
+};
+
+/**
+ * Crea un'istanza di traduzione per l'uso lato server (o fuori dai componenti React).
+ */
+declare const createServerTranslator: (resources: TranslationResources, locale?: Locale) => {
+    t: TranslateFunction;
+    locale: Locale;
+};
+
+type TranslationFunction = (key: string, options?: TranslationOptions) => string;
+/**
+ * Hook per tradurre testi che si adatta al sistema di traduzione interno.
+ * Wrapper di retro-compatibilità per useTranslation.
+ *
+ * @param ns - Namespace opzionale (ignorato nella nuova implementazione)
+ * @returns Un oggetto con la funzione traslateText (e alias t)
+ */
+declare const useTranslatedText: (ns?: string) => {
+    traslateText: (text: string, options?: TranslationOptions) => string;
+    t: (text: string, options?: TranslationOptions) => string;
+};
+
+export { createServerTranslator, localizationConfigAtom, resolveTranslation, useLocalizationActions, useLocalizationConfigReset, useLocalizationConfigState, useLocalizationConfigValue, useTranslatedText, useTranslation };
+export type { FormatOptions, I18nConfig, Locale, LocalizationConfigProps, TranslateFunction, TranslationFunction, TranslationOptions, TranslationResources };

package/dist/notifications/index.d.ts

@@ -0,0 +1,37 @@
+import * as _gaddario98_react_state from '@gaddario98/react-state';
+
+interface NotificationMessage {
+    id: string;
+    message: string;
+    type: 'success' | 'error' | 'info' | 'warning';
+    autoHideDuration?: number;
+    textTransOption?: Record<string, unknown>;
+    ns?: string;
+}
+type TypeNotification = 'like' | 'message' | 'comments' | 'follow';
+interface UserNotification {
+    uid: string;
+    type: TypeNotification;
+    postId?: string;
+    typePost?: string;
+    token: string;
+    message?: string;
+    data?: Date;
+    read: boolean;
+    notificationId: string;
+    nickname?: string;
+    titlePost?: string;
+}
+type NotificationConfig = Partial<Omit<NotificationMessage, 'id'>>;
+
+declare const useNotification: (ns?: string) => {
+    showNotification: (notification: Omit<NotificationMessage, "id">) => void;
+    clearNotification: () => void;
+};
+
+declare const notificationAtom: _gaddario98_react_state.PrimitiveAtom<NotificationMessage | null>;
+declare const useNotificationValue: () => NotificationMessage | null;
+declare const useNotificationState: () => [NotificationMessage | null, (value: NotificationMessage | null) => void];
+
+export { notificationAtom, useNotification, useNotificationState, useNotificationValue };
+export type { NotificationConfig, NotificationMessage, UserNotification };