@steveencues/starter-react-ui 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './libs';

package/dist/libs/aplicacion/contexts/index.d.ts

@@ -0,0 +1,2 @@
+export * from './translate.context';
+export * from './theme.context';

package/dist/libs/aplicacion/contexts/theme.context.d.ts

@@ -0,0 +1,7 @@
+import { IThemeContextValue } from '../../domain';
+/**
+ * @description Contexto interno del sistema de temas.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare const ThemeContext: import('react').Context<IThemeContextValue | null>;

package/dist/libs/aplicacion/contexts/translate.context.d.ts

@@ -0,0 +1,7 @@
+import { ILanguageContextValue } from '../../domain';
+/**
+ * @description Contexto interno de traducciones de la libreria.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare const TranslateContext: import('react').Context<ILanguageContextValue | null>;

package/dist/libs/aplicacion/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export * from './use-language';
+export * from './use-theme';
+export * from './use-theme-preference.hook';

package/dist/libs/aplicacion/hooks/use-language.d.ts

@@ -0,0 +1,8 @@
+import { ILanguageContextValue } from '../../domain';
+/**
+ * @description Obtiene el idioma actual y la funcion de traduccion.
+ * Requiere que el componente este dentro de TranslateProvider.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function useLanguage(): ILanguageContextValue;

package/dist/libs/aplicacion/hooks/use-theme-preference.hook.d.ts

@@ -0,0 +1,7 @@
+import { ThemePreferenceConfiguration, ThemePreferenceResult } from '../../domain';
+/**
+ * @description Manages the selected theme and its encrypted persistence lifecycle.
+ * @author Steveen Cues
+ * @version 3.0.0
+ */
+export declare function useThemePreference(inputConfiguration: ThemePreferenceConfiguration): ThemePreferenceResult;

package/dist/libs/aplicacion/hooks/use-theme.d.ts

@@ -0,0 +1,8 @@
+import { IThemeContextValue } from '../../domain';
+/**
+ * @description Obtiene el tema activo, los temas disponibles y
+ * la funcion para cambiar de tema.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function useTheme(): IThemeContextValue;

package/dist/libs/aplicacion/index.d.ts

@@ -0,0 +1,5 @@
+export * from './contexts';
+export * from './hooks';
+export * from './providers';
+export * from './utils';
+export * from './services';

package/dist/libs/aplicacion/providers/index.d.ts

@@ -0,0 +1,2 @@
+export * from './translate.provider';
+export * from './theme-provider';

package/dist/libs/aplicacion/providers/theme-provider.d.ts

@@ -0,0 +1,9 @@
+import { IThemeProviderProps } from '../../domain';
+import { JSX } from 'react';
+/**
+ * @description Provides the active theme and allows theme changes.
+ * Restores and persists the encrypted theme preference.
+ * @author Steveen Cues
+ * @version 4.0.0
+ */
+export declare function ThemeProvider({ themes, initialTheme, themeEncryptionKey, children, }: IThemeProviderProps): JSX.Element;

package/dist/libs/aplicacion/providers/translate.provider.d.ts

@@ -0,0 +1,8 @@
+import { JSX } from 'react';
+import { ITranslateProviderProps } from '../../domain';
+/**
+ * @description Provides the active language and translation functions.
+ * @author Steveen Cues
+ * @version 4.0.0
+ */
+export declare function TranslateProvider({ translations, initialLanguage, fallbackLanguage, languageEncryptionKey, children, }: ITranslateProviderProps): JSX.Element;

package/dist/libs/aplicacion/services/encryption.service.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @description Encrypts text using AES-GCM.
+ * @param value Text to encrypt.
+ * @param secret Encryption secret.
+ * @returns Encoded encrypted value or undefined when unavailable.
+ * @author Steveen Cues
+ * @version 2.0.0
+ */
+export declare function encryptText(value: string, secret: string): Promise<string | undefined>;
+/**
+ * @description Decrypts an AES-GCM encrypted value.
+ * @param value Encoded initialization vector and ciphertext.
+ * @param secret Encryption secret.
+ * @returns Original text or undefined if decryption fails.
+ * @author Steveen Cues
+ * @version 2.0.0
+ */
+export declare function decryptText(value: string, secret: string): Promise<string | undefined>;

package/dist/libs/aplicacion/services/index.d.ts

@@ -0,0 +1 @@
+export * from './encryption.service';

package/dist/libs/aplicacion/utils/base64.util.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @description Encodes bytes into Base64.
+ * @param bytes Bytes to encode.
+ * @returns Base64 string.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function encodeBase64(bytes: Uint8Array): string;
+/**
+ * @description Decodes Base64 into bytes.
+ * @param value Base64 string.
+ * @returns Decoded bytes.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function decodeBase64(value: string): Uint8Array<ArrayBuffer>;

package/dist/libs/aplicacion/utils/crypto-api.util.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description Obtains the cryptographic API when available.
+ * @returns Cryptographic API or undefined if unavailable.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function getCryptoApi(): Crypto | undefined;

package/dist/libs/aplicacion/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './translation.utils';
+export * from './theme.utils';
+export * from './crypto-api.util';
+export * from './storage-api.util';
+export * from './text-encoding.util';
+export * from './base64.util';

package/dist/libs/aplicacion/utils/storage-api.util.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description Obtains localStorage when available.
+ * @returns Browser storage or undefined if unavailable.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function getLocalStorage(): Storage | undefined;

package/dist/libs/aplicacion/utils/text-encoding.util.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @description Encodes text into UTF-8 bytes.
+ * @param value Text to encode.
+ * @returns Encoded bytes.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function encodeText(value: string): Uint8Array<ArrayBuffer>;
+/**
+ * @description Decodes UTF-8 bytes into text.
+ * @param value Encoded bytes.
+ * @returns Decoded text.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function decodeText(value: ArrayBuffer): string;

package/dist/libs/aplicacion/utils/theme.utils.d.ts

@@ -0,0 +1,26 @@
+import { AppTheme, ThemeCssVariables, ThemeName } from '../../domain';
+/**
+ * @description Resuelve el tema inicial solicitado o utiliza el primero registrado.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function resolveInitialTheme(themes: readonly AppTheme[], initialTheme: ThemeName): AppTheme;
+/**
+ * @description Resuelve el tema activo o recupera uno disponible.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function resolveActiveTheme(themes: readonly AppTheme[], selectedTheme: ThemeName, initialTheme: ThemeName): AppTheme;
+/**
+ * @description Valida que el tema solicitado este registrado.
+ * @throws {Error} Cuando el tema no esta registrado.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function assertThemeExists(themes: readonly AppTheme[], themeName: ThemeName): void;
+/**
+ * @description Genera todas las variables CSS a partir de los tokens del tema.
+ * @author Steveen Cues
+ * @version 1.3.0
+ */
+export declare function createThemeVariables(theme: AppTheme): ThemeCssVariables;

package/dist/libs/aplicacion/utils/translation.utils.d.ts

@@ -0,0 +1,64 @@
+import { TranslationCatalog, TranslationDictionary, TranslationParams } from '../../domain';
+/**
+ * @description Obtiene el idioma inicial disponible, priorizando el
+ * idioma solicitado, el idioma de respaldo y el primer idioma registrado.
+ * @param translations Catalogo de traducciones.
+ * @param initialLanguage Idioma solicitado inicialmente.
+ * @param fallbackLanguage Idioma de respaldo.
+ * @returns Codigo del idioma inicial disponible.
+ * @throws Error cuando el catalogo esta vacio.
+ * @author Steveen Cues
+ * @version 2.0.0
+ */
+export declare function resolveInitialLanguage(translations: TranslationCatalog, initialLanguage: string, fallbackLanguage: string): string;
+/**
+ * @description Resuelve el idioma seleccionado y utiliza el idioma
+ * inicial, el respaldo o el primer idioma disponible si es necesario.
+ * @param translations Catalogo de traducciones.
+ * @param selectedLanguage Idioma seleccionado actualmente.
+ * @param initialLanguage Idioma inicial configurado.
+ * @param fallbackLanguage Idioma de respaldo.
+ * @returns Codigo del idioma activo.
+ * @author Steveen Cues
+ * @version 2.0.0
+ */
+export declare function resolveActiveLanguage(translations: TranslationCatalog, selectedLanguage: string, initialLanguage: string, fallbackLanguage: string): string;
+/**
+ * @description Valida que un idioma este registrado en el catalogo.
+ * @param translations Catalogo de traducciones.
+ * @param language Codigo del idioma que se desea validar.
+ * @returns No devuelve ningun valor.
+ * @throws Error cuando el idioma no esta disponible.
+ * @author Steveen Cues
+ * @version 2.0.0
+ */
+export declare function assertLanguageExists(translations: TranslationCatalog, language: string): void;
+/**
+ * @description Busca una traduccion dentro de un diccionario.
+ * @param dictionary Diccionario del idioma.
+ * @param key Clave con notacion de puntos.
+ * @returns Traduccion encontrada o undefined.
+ * @author Steveen Cues
+ * @version 2.0.0
+ */
+export declare function findTranslation(dictionary: TranslationDictionary | undefined, key: string): string | undefined;
+/**
+ * @description Sustituye los marcadores {{name}} usando los parametros.
+ * @param message Mensaje que se desea interpolar.
+ * @param params Valores disponibles para la interpolacion.
+ * @returns Mensaje con los parametros sustituidos.
+ * @author Steveen Cues
+ * @version 2.0.0
+ */
+export declare function interpolateTranslation(message: string, params?: TranslationParams): string;
+/**
+ * @description Traduce un mensaje aplicando respaldo e interpolacion.
+ * @param currentDictionary Diccionario del idioma activo.
+ * @param fallbackDictionary Diccionario del idioma de respaldo.
+ * @param key Clave de traduccion.
+ * @param params Parametros de interpolacion.
+ * @returns Mensaje final traducido e interpolado.
+ * @author Steveen Cues
+ * @version 2.0.0
+ */
+export declare function translateMessage(currentDictionary: TranslationDictionary | undefined, fallbackDictionary: TranslationDictionary | undefined, key: string, params?: TranslationParams): string;

package/dist/libs/components/Button/Button.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/components/Button/button.types.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/components/Button/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/components/Card/Card.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/components/Card/card.types.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/components/Card/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/components/Input/Input.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/components/Input/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/components/Input/input.types.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

package/dist/libs/components/styles/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/libs/domain/constants/encrypted-preference.constanst.d.ts

@@ -0,0 +1,7 @@
+export declare const AES_GCM_ALGORITHM = "AES-GCM";
+export declare const AES_GCM_IV_LENGTH = 12;
+export declare const SHA_256_ALGORITHM = "SHA-256";
+export declare const RAW_KEY_FORMAT = "raw";
+export declare const STORAGE_VALUE_SEPARATOR = ".";
+export declare const KEY_USAGES: KeyUsage[];
+export declare const ENCRYPTED_VALUE_PART_COUNT = 2;

package/dist/libs/domain/constants/index.d.ts

@@ -0,0 +1,3 @@
+export * from './translation.constants';
+export * from './encrypted-preference.constanst';
+export * from './theme-css-variable.const';

package/dist/libs/domain/constants/theme-css-variable.const.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @description Define los nombres de las variables CSS de la libreria.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare const ThemeCssVariable: {
+    readonly SURFACE_BACKGROUND: "--rui-surface-background";
+    readonly SURFACE_SURFACE: "--rui-surface-surface";
+    readonly SURFACE_SURFACE_ELEVATED: "--rui-surface-surface-elevated";
+    readonly SURFACE_SURFACE_HOVER: "--rui-surface-surface-hover";
+    readonly SURFACE_SURFACE_ACTIVE: "--rui-surface-surface-active";
+    readonly SURFACE_SURFACE_DISABLED: "--rui-surface-surface-disabled";
+    readonly TEXT_PRIMARY: "--rui-text-primary";
+    readonly TEXT_SECONDARY: "--rui-text-secondary";
+    readonly TEXT_MUTED: "--rui-text-muted";
+    readonly TEXT_DISABLED: "--rui-text-disabled";
+    readonly TEXT_INVERSE: "--rui-text-inverse";
+    readonly TEXT_LINK: "--rui-text-link";
+    readonly TEXT_LINK_HOVER: "--rui-text-link-hover";
+    readonly BRAND_PRIMARY: "--rui-brand-primary";
+    readonly BRAND_PRIMARY_HOVER: "--rui-brand-primary-hover";
+    readonly BRAND_PRIMARY_ACTIVE: "--rui-brand-primary-active";
+    readonly BRAND_PRIMARY_CONTRAST: "--rui-brand-primary-contrast";
+    readonly BRAND_SECONDARY: "--rui-brand-secondary";
+    readonly BRAND_SECONDARY_HOVER: "--rui-brand-secondary-hover";
+    readonly BRAND_SECONDARY_ACTIVE: "--rui-brand-secondary-active";
+    readonly BRAND_SECONDARY_CONTRAST: "--rui-brand-secondary-contrast";
+    readonly BRAND_ACCENT: "--rui-brand-accent";
+    readonly BRAND_ACCENT_HOVER: "--rui-brand-accent-hover";
+    readonly BRAND_ACCENT_CONTRAST: "--rui-brand-accent-contrast";
+    readonly STATE_SUCCESS: "--rui-state-success";
+    readonly STATE_SUCCESS_BACKGROUND: "--rui-state-success-background";
+    readonly STATE_WARNING: "--rui-state-warning";
+    readonly STATE_WARNING_BACKGROUND: "--rui-state-warning-background";
+    readonly STATE_ERROR: "--rui-state-error";
+    readonly STATE_ERROR_BACKGROUND: "--rui-state-error-background";
+    readonly STATE_INFO: "--rui-state-info";
+    readonly STATE_INFO_BACKGROUND: "--rui-state-info-background";
+    readonly BORDER_DEFAULT: "--rui-border-default";
+    readonly BORDER_SUBTLE: "--rui-border-subtle";
+    readonly BORDER_STRONG: "--rui-border-strong";
+    readonly BORDER_FOCUS: "--rui-border-focus";
+    readonly BORDER_HOVER: "--rui-border-hover";
+    readonly BORDER_ACTIVE: "--rui-border-active";
+    readonly BORDER_DISABLED: "--rui-border-disabled";
+    readonly SHADOW_COLOR: "--rui-shadow-color";
+    readonly SHADOW_SUBTLE: "--rui-shadow-subtle";
+    readonly SHADOW_SMALL: "--rui-shadow-small";
+    readonly SHADOW_MEDIUM: "--rui-shadow-medium";
+    readonly SHADOW_LARGE: "--rui-shadow-large";
+    readonly SHADOW_GLOW: "--rui-shadow-glow";
+    readonly EFFECTS_OVERLAY: "--rui-effects-overlay";
+    readonly EFFECTS_BACKDROP: "--rui-effects-backdrop";
+    readonly EFFECTS_BLUR: "--rui-effects-blur";
+    readonly EFFECTS_BLUR_STRONG: "--rui-effects-blur-strong";
+    readonly EFFECTS_GLASS_BACKGROUND: "--rui-effects-glass-background";
+    readonly EFFECTS_GLASS_BORDER: "--rui-effects-glass-border";
+    readonly TYPOGRAPHY_HEADING_PRIMARY: "--rui-typography-heading-primary";
+    readonly TYPOGRAPHY_HEADING_SECONDARY: "--rui-typography-heading-secondary";
+    readonly TYPOGRAPHY_HEADING_MUTED: "--rui-typography-heading-muted";
+    readonly TYPOGRAPHY_BODY_PRIMARY: "--rui-typography-body-primary";
+    readonly TYPOGRAPHY_BODY_SECONDARY: "--rui-typography-body-secondary";
+    readonly TYPOGRAPHY_BODY_MUTED: "--rui-typography-body-muted";
+    readonly TYPOGRAPHY_LABEL_PRIMARY: "--rui-typography-label-primary";
+    readonly TYPOGRAPHY_LABEL_SECONDARY: "--rui-typography-label-secondary";
+    readonly TYPOGRAPHY_LABEL_MUTED: "--rui-typography-label-muted";
+    readonly TYPOGRAPHY_BUTTON_PRIMARY: "--rui-typography-button-primary";
+    readonly TYPOGRAPHY_BUTTON_SECONDARY: "--rui-typography-button-secondary";
+};

package/dist/libs/domain/constants/translation.constants.d.ts

@@ -0,0 +1 @@
+export declare const GLOBAL_REGEX_FLAG = "g";

package/dist/libs/domain/enums/index.d.ts

@@ -0,0 +1 @@
+export * from './translation-regex.enum';

package/dist/libs/domain/enums/translation-regex.enum.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @description Expresiones regulares reutilizables para traducciones.
+ * @author Steveen Cues
+ * @version 2.0.0
+ */
+export declare const TranslationRegex: Readonly<{
+    INTERPOLATION_PLACEHOLDER: string;
+}>;

package/dist/libs/domain/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './interface';
+export * from './enums';
+export * from './constants';

package/dist/libs/domain/interface/index.d.ts

@@ -0,0 +1,2 @@
+export * from './translation.interface';
+export * from './theme.interface';

package/dist/libs/domain/interface/theme.interface.d.ts

@@ -0,0 +1,204 @@
+import { ThemeName } from '..';
+import { ReactNode } from 'react';
+/**
+ * @description Contrato publico del contexto de temas.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface IThemeContextValue {
+    readonly theme: AppTheme;
+    readonly themeName: ThemeName;
+    readonly themes: readonly AppTheme[];
+    readonly setTheme: (theme: ThemeName) => void;
+}
+/**
+ * @description Propiedades del proveedor de temas.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface IThemeProviderProps {
+    readonly themes: readonly AppTheme[];
+    readonly initialTheme: ThemeName;
+    readonly themeEncryptionKey: string;
+    readonly children: ReactNode;
+}
+/**
+ * @description Colores del contenido textual.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemeTextColors {
+    readonly primary: string;
+    readonly secondary: string;
+    readonly muted: string;
+    readonly disabled: string;
+    readonly inverse: string;
+    readonly link: string;
+    readonly linkHover: string;
+}
+/**
+ * @description Colores utilizados por las superficies.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemeSurfaceColors {
+    readonly background: string;
+    readonly surface: string;
+    readonly surfaceElevated: string;
+    readonly surfaceHover: string;
+    readonly surfaceActive: string;
+    readonly surfaceDisabled: string;
+}
+/**
+ * @description Colores de los estados semanticos.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemeStateColors {
+    readonly success: string;
+    readonly successBackground: string;
+    readonly warning: string;
+    readonly warningBackground: string;
+    readonly error: string;
+    readonly errorBackground: string;
+    readonly info: string;
+    readonly infoBackground: string;
+}
+/**
+ * @description Colores de identidad visual de la aplicacion.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemeBrandColors {
+    readonly primary: string;
+    readonly primaryHover: string;
+    readonly primaryActive: string;
+    readonly primaryContrast: string;
+    readonly secondary: string;
+    readonly secondaryHover: string;
+    readonly secondaryActive: string;
+    readonly secondaryContrast: string;
+    readonly accent: string;
+    readonly accentHover: string;
+    readonly accentContrast: string;
+}
+/**
+ * @description Colores para bordes e indicadores de interaccion.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemeBorderColors {
+    readonly default: string;
+    readonly subtle: string;
+    readonly strong: string;
+    readonly focus: string;
+    readonly hover: string;
+    readonly active: string;
+    readonly disabled: string;
+}
+/**
+ * @description Configuracion de las sombras.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemeShadowColors {
+    readonly color: string;
+    readonly subtle: string;
+    readonly small: string;
+    readonly medium: string;
+    readonly large: string;
+    readonly glow: string;
+}
+/**
+ * @description Configuracion de efectos visuales.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemeEffects {
+    readonly overlay: string;
+    readonly backdrop: string;
+    readonly blur: string;
+    readonly blurStrong: string;
+    readonly glassBackground: string;
+    readonly glassBorder: string;
+}
+/**
+ * @description Configuracion tipografica del tema.
+ * Sus valores pueden representar colores o tokens CSS.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemeTypography {
+    readonly heading: {
+        readonly primary: string;
+        readonly secondary: string;
+        readonly muted: string;
+    };
+    readonly body: {
+        readonly primary: string;
+        readonly secondary: string;
+        readonly muted: string;
+    };
+    readonly label: {
+        readonly primary: string;
+        readonly secondary: string;
+        readonly muted: string;
+    };
+    readonly button: {
+        readonly primary: string;
+        readonly secondary: string;
+    };
+}
+/**
+ * @description Paleta completa de tokens visuales del tema.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemeColors {
+    readonly surface: ThemeSurfaceColors;
+    readonly text: ThemeTextColors;
+    readonly brand: ThemeBrandColors;
+    readonly state: ThemeStateColors;
+    readonly border: ThemeBorderColors;
+    readonly shadow: ThemeShadowColors;
+    readonly effects: ThemeEffects;
+    readonly typography: ThemeTypography;
+}
+/**
+ * @description Configuracion visual completa de un tema.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface AppTheme {
+    readonly name: ThemeName;
+    readonly colors: ThemeColors;
+}
+/**
+ * @description Defines the configuration required to manage theme preferences.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemePreferenceConfiguration {
+    readonly themes: IThemeProviderProps["themes"];
+    readonly initialTheme: IThemeProviderProps["initialTheme"];
+    readonly themeEncryptionKey: IThemeProviderProps["themeEncryptionKey"];
+}
+/**
+ * @description Represents the current theme preference state and its configuration.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemePreferenceState extends ThemePreferenceConfiguration {
+    readonly themeName: ThemeName;
+    readonly isLoaded: boolean;
+}
+/**
+ * @description Defines the result returned by the theme preference hook.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ThemePreferenceResult {
+    readonly themeName: ThemeName;
+    readonly isPreferenceLoaded: boolean;
+    readonly setThemeName: (nextTheme: ThemeName) => void;
+}

package/dist/libs/domain/interface/translation.interface.d.ts

@@ -0,0 +1,56 @@
+import { TranslationCatalog, TranslationParams } from '../..';
+import { ReactNode } from 'react';
+/**
+ * @description Estado publico del contexto de traducciones.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ILanguageContextValue {
+    readonly language: string;
+    readonly languages: readonly string[];
+    readonly setLanguage: (language: string) => void;
+    readonly t: (key: string, params?: TranslationParams) => string;
+}
+/**
+ * @description Propiedades del proveedor de traducciones.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface ITranslateProviderProps {
+    readonly translations: TranslationCatalog;
+    readonly initialLanguage: string;
+    readonly fallbackLanguage?: string;
+    readonly children: ReactNode;
+    readonly languageEncryptionKey: string;
+}
+/**
+ * @description Defines the configuration required to manage language preferences.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface LanguagePreferenceConfiguration {
+    readonly translations: ITranslateProviderProps["translations"];
+    readonly initialLanguage: ITranslateProviderProps["initialLanguage"];
+    readonly fallbackLanguage: string;
+    readonly languageEncryptionKey: ITranslateProviderProps["languageEncryptionKey"];
+    readonly languages: readonly string[];
+}
+/**
+ * @description Represents the current language preference state and configuration.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface LanguagePreferenceState extends LanguagePreferenceConfiguration {
+    readonly selectedLanguage: string;
+    readonly isLoaded: boolean;
+}
+/**
+ * @description Defines the result returned by the language preference hook.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface LanguagePreferenceResult {
+    readonly language: string;
+    readonly isLoaded: boolean;
+    readonly setLanguage: (language: string) => void;
+}

package/dist/libs/domain/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './translation.types';
+export * from './theme.types';
+export * from './theme-name.types';

package/dist/libs/domain/types/theme-name.types.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @description Identificadores de los temas disponibles.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type ThemeName = "light" | "dark" | "magenta" | "semi-dark";

package/dist/libs/domain/types/theme.types.d.ts

@@ -0,0 +1,64 @@
+import { ThemePreferenceState } from '..';
+import { CSSProperties, Dispatch, SetStateAction } from 'react';
+/**
+ * @description Defines custom CSS variables supported by the library.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type ThemeCssVariables = CSSProperties & {
+    [property: `--rui-${string}`]: string;
+};
+/**
+ * @description Defines CSS variables for surface colors.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type SurfaceVariables = Pick<ThemeCssVariables, "--rui-surface-background" | "--rui-surface-surface" | "--rui-surface-surface-elevated" | "--rui-surface-surface-hover" | "--rui-surface-surface-active" | "--rui-surface-surface-disabled">;
+/**
+ * @description Defines CSS variables for text colors.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type TextVariables = Pick<ThemeCssVariables, "--rui-text-primary" | "--rui-text-secondary" | "--rui-text-muted" | "--rui-text-disabled" | "--rui-text-inverse" | "--rui-text-link" | "--rui-text-link-hover">;
+/**
+ * @description Defines CSS variables for brand colors.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type BrandVariables = Pick<ThemeCssVariables, "--rui-brand-primary" | "--rui-brand-primary-hover" | "--rui-brand-primary-active" | "--rui-brand-primary-contrast" | "--rui-brand-secondary" | "--rui-brand-secondary-hover" | "--rui-brand-secondary-active" | "--rui-brand-secondary-contrast" | "--rui-brand-accent" | "--rui-brand-accent-hover" | "--rui-brand-accent-contrast">;
+/**
+ * @description Defines CSS variables for status colors.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type StateVariables = Pick<ThemeCssVariables, "--rui-state-success" | "--rui-state-success-background" | "--rui-state-warning" | "--rui-state-warning-background" | "--rui-state-error" | "--rui-state-error-background" | "--rui-state-info" | "--rui-state-info-background">;
+/**
+ * @description Defines CSS variables for border styles and colors.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type BorderVariables = Pick<ThemeCssVariables, "--rui-border-default" | "--rui-border-subtle" | "--rui-border-strong" | "--rui-border-focus" | "--rui-border-hover" | "--rui-border-active" | "--rui-border-disabled">;
+/**
+ * @description Defines CSS variables for shadows.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type ShadowVariables = Pick<ThemeCssVariables, "--rui-shadow-color" | "--rui-shadow-subtle" | "--rui-shadow-small" | "--rui-shadow-medium" | "--rui-shadow-large" | "--rui-shadow-glow">;
+/**
+ * @description Defines CSS variables for visual effects.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type EffectVariables = Pick<ThemeCssVariables, "--rui-effects-overlay" | "--rui-effects-backdrop" | "--rui-effects-blur" | "--rui-effects-blur-strong" | "--rui-effects-glass-background" | "--rui-effects-glass-border">;
+/**
+ * @description Defines CSS variables for typography colors.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type TypographyVariables = Pick<ThemeCssVariables, "--rui-typography-heading-primary" | "--rui-typography-heading-secondary" | "--rui-typography-heading-muted" | "--rui-typography-body-primary" | "--rui-typography-body-secondary" | "--rui-typography-body-muted" | "--rui-typography-label-primary" | "--rui-typography-label-secondary" | "--rui-typography-label-muted" | "--rui-typography-button-primary" | "--rui-typography-button-secondary">;
+/**
+ * @description Defines the React state dispatcher for theme preference updates.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type SetThemePreferenceState = Dispatch<SetStateAction<ThemePreferenceState>>;

package/dist/libs/domain/types/translation.types.d.ts

@@ -0,0 +1,33 @@
+import { LanguagePreferenceState } from '..';
+/**
+ * @description Valores admitidos en un catalogo de traducciones.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type TranslationValue = string | TranslationDictionary;
+/**
+ * @description Diccionario de traducciones que admite claves anidadas.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export interface TranslationDictionary {
+    readonly [key: string]: TranslationValue;
+}
+/**
+ * @description Catalogo de traducciones identificado por idioma.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type TranslationCatalog = Readonly<Record<string, TranslationDictionary>>;
+/**
+ * @description Parametros para interpolar variables en una traduccion.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type TranslationParams = Readonly<Record<string, string | number>>;
+/**
+ * @description Defines the React state dispatcher for language preference updates.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export type SetLanguagePreferenceState = React.Dispatch<React.SetStateAction<LanguagePreferenceState>>;

package/dist/libs/index.d.ts

@@ -0,0 +1,4 @@
+export * from './aplicacion';
+export * from './components';
+export * from './domain';
+export * from './infraestructura';

package/dist/libs/infraestructura/index.d.ts

@@ -0,0 +1 @@
+export * from './storage';

package/dist/libs/infraestructura/storage/encrypted-preference.storage.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @description Encrypts and saves a preference in localStorage.
+ * @param storageKey Storage key.
+ * @param value Value to store.
+ * @param encryptionKey Encryption secret.
+ * @returns Promise resolved after the save attempt.
+ * @author Steveen Cues
+ * @version 3.0.0
+ */
+export declare function saveEncryptedPreference(storageKey: string, value: string, encryptionKey: string): Promise<void>;
+/**
+ * @description Loads and decrypts a preference from localStorage.
+ * @param storageKey Storage key.
+ * @param encryptionKey Encryption secret.
+ * @returns Decrypted preference or undefined when unavailable.
+ * @author Steveen Cues
+ * @version 3.0.0
+ */
+export declare function loadEncryptedPreference(storageKey: string, encryptionKey: string): Promise<string | undefined>;

package/dist/libs/infraestructura/storage/index.d.ts

@@ -0,0 +1,3 @@
+export * from './encrypted-preference.storage';
+export * from './language-preference.storage';
+export * from './theme-preference.storage';

package/dist/libs/infraestructura/storage/language-preference.storage.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @description Guarda el idioma activo de forma cifrada.
+ * @param language Codigo del idioma activo.
+ * @param encryptionKey Clave de cifrado proporcionada por el consumidor.
+ * @returns Promesa completada al finalizar el intento de guardado.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function saveLanguagePreference(language: string, encryptionKey: string): Promise<void>;
+/**
+ * @description Recupera el idioma guardado y verifica que siga disponible.
+ * @param availableLanguages Idiomas admitidos por el proyecto.
+ * @param encryptionKey Clave de cifrado proporcionada por el consumidor.
+ * @returns Idioma recuperado o undefined si no existe o no es valido.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function loadLanguagePreference(availableLanguages: readonly string[], encryptionKey: string): Promise<string | undefined>;

package/dist/libs/infraestructura/storage/theme-preference.storage.d.ts

@@ -0,0 +1,19 @@
+import { AppTheme, ThemeName } from '../../domain';
+/**
+ * @description Guarda el nombre del tema activo de forma cifrada.
+ * @param themeName Nombre del tema.
+ * @param encryptionKey Clave de cifrado proporcionada por el consumidor.
+ * @returns Promesa completada al finalizar el intento de guardado.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function saveThemePreference(themeName: ThemeName, encryptionKey: string): Promise<void>;
+/**
+ * @description Recupera el tema guardado si existe entre los temas admitidos.
+ * @param themes Temas definidos por el proyecto consumidor.
+ * @param encryptionKey Clave de cifrado proporcionada por el consumidor.
+ * @returns Nombre del tema recuperado o undefined.
+ * @author Steveen Cues
+ * @version 1.0.0
+ */
+export declare function loadThemePreference(themes: readonly AppTheme[], encryptionKey: string): Promise<ThemeName | undefined>;

package/package.json

@@ -1,10 +1,21 @@
 {
   "name": "@steveencues/starter-react-ui",
+  "version": "1.0.1",
   "private": false,
-  "version": "1.0.0",
   "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "lint": "eslint .",
@@ -42,6 +53,7 @@
     "vite": "^8.3.0"
   },
   "peerDependencies": {
-    "react": "^18.2.0 || ^19.0.0"
+    "react": "^18.2.0 || ^19.0.0",
+    "react-dom": "^18.2.0 || ^19.0.0"
   }
-}
+}