@sincpro/mobile-ui 0.2.1 → 0.3.1

package/dist/theme/typography.js

@@ -1,18 +1,44 @@
-import { Montserrat_300Light, Montserrat_400Regular, Montserrat_500Medium, Montserrat_600SemiBold, Montserrat_800ExtraBold, useFonts, } from "@expo-google-fonts/montserrat";
-/* -------------------- Font Families & Weights -------------------- */
-export const fontFamilies = {
-    light: "Montserrat_300Light",
-    regular: "Montserrat_400Regular",
-    medium: "Montserrat_500Medium",
-    semiBold: "Montserrat_600SemiBold",
-    extraBold: "Montserrat_800ExtraBold",
+import { FiraCode_400Regular, FiraCode_500Medium } from "@expo-google-fonts/fira-code";
+import { Inter_300Light, Inter_400Regular, Inter_500Medium, Inter_600SemiBold, Inter_800ExtraBold, useFonts, } from "@expo-google-fonts/inter";
+const DEFAULT_FONT_FAMILIES = {
+    light: "Inter_300Light",
+    regular: "Inter_400Regular",
+    medium: "Inter_500Medium",
+    semiBold: "Inter_600SemiBold",
+    extraBold: "Inter_800ExtraBold",
+    mono: "FiraCode_400Regular",
+    monoMedium: "FiraCode_500Medium",
+    // Título: default Inter (seguro). Storybook/app lo apunta a Satoshi vía configureFonts.
+    titleRegular: "Inter_400Regular",
+    titleMedium: "Inter_500Medium",
+    title: "Inter_600SemiBold",
+    titleBlack: "Inter_800ExtraBold",
 };
+export const fontFamilies = { ...DEFAULT_FONT_FAMILIES };
+/**
+ * Configura las familias de fuente del DS (rol → nombre de familia ya cargada por la app).
+ * Mutación in-place del singleton, así los componentes la leen en vivo. Ejemplo:
+ * `configureFonts({ title: "Satoshi-Bold", titleBlack: "Satoshi-Black" })`.
+ */
+export function configureFonts(overrides) {
+    Object.assign(fontFamilies, overrides);
+}
+/** Restablece las familias a los defaults (Inter + Fira Code). Útil en tests/stories. */
+export function resetFonts() {
+    Object.assign(fontFamilies, DEFAULT_FONT_FAMILIES);
+}
 export const fontWeights = {
     light: "300",
     regular: "400",
     medium: "500",
     semiBold: "600",
     extraBold: "800",
+    mono: "400",
+    monoMedium: "500",
+    titleRegular: "400",
+    titleMedium: "500",
+    title: "700",
+    titleBlack: "900",
 };
 /* -------------------- Font Sizes -------------------- */
 export const fontSizes = {
@@ -49,33 +75,33 @@ export const letterSpacing = {
 };
 /* -------------------- Typography Variants -------------------- */
 export const typographyVariants = {
-    // Display
+    // Display (Satoshi Black — carácter de marca)
     display: {
         fontSize: fontSizes["7xl"],
-        fontFamily: fontFamilies.extraBold,
-        fontWeight: fontWeights.extraBold,
+        fontFamily: fontFamilies.titleBlack,
+        fontWeight: fontWeights.titleBlack,
         lineHeight: fontSizes["7xl"] * lineHeights.tight,
         letterSpacing: letterSpacing.tight,
     },
-    // Headings
+    // Headings (Satoshi Bold)
     h1: {
         fontSize: fontSizes["5xl"],
-        fontFamily: fontFamilies.extraBold,
-        fontWeight: fontWeights.extraBold,
+        fontFamily: fontFamilies.title,
+        fontWeight: fontWeights.title,
         lineHeight: fontSizes["5xl"] * lineHeights.tight,
         letterSpacing: letterSpacing.tight,
     },
     h2: {
         fontSize: fontSizes["4xl"],
-        fontFamily: fontFamilies.semiBold,
-        fontWeight: fontWeights.semiBold,
+        fontFamily: fontFamilies.title,
+        fontWeight: fontWeights.title,
         lineHeight: fontSizes["4xl"] * lineHeights.snug,
         letterSpacing: letterSpacing.normal,
     },
     h3: {
         fontSize: fontSizes["3xl"],
-        fontFamily: fontFamilies.semiBold,
-        fontWeight: fontWeights.semiBold,
+        fontFamily: fontFamilies.title,
+        fontWeight: fontWeights.title,
         lineHeight: fontSizes["3xl"] * lineHeights.snug,
         letterSpacing: letterSpacing.normal,
     },
@@ -137,18 +163,42 @@ export const typographyVariants = {
         lineHeight: fontSizes.sm * lineHeights.normal,
         letterSpacing: letterSpacing.wide,
     },
-    // Caption
+    // Data — cifras, montos, SKU, % (mono Fira Code, peso medio). DS spec rol "data".
+    data: {
+        fontSize: fontSizes.lg,
+        fontFamily: fontFamilies.monoMedium,
+        fontWeight: fontWeights.monoMedium,
+        lineHeight: fontSizes.lg * lineHeights.tight,
+        letterSpacing: letterSpacing.normal,
+    },
+    dataLarge: {
+        fontSize: fontSizes["4xl"],
+        fontFamily: fontFamilies.monoMedium,
+        fontWeight: fontWeights.monoMedium,
+        lineHeight: fontSizes["4xl"] * lineHeights.none,
+        letterSpacing: letterSpacing.tight,
+    },
+    // Overline — labels/metadata en mono MAYÚSCULAS con tracking. DS spec rol "caption".
+    overline: {
+        fontSize: 11,
+        fontFamily: fontFamilies.mono,
+        fontWeight: fontWeights.mono,
+        lineHeight: 11 * lineHeights.snug,
+        letterSpacing: 0.6,
+        textTransform: "uppercase",
+    },
+    // Caption — Fira Code mono (secundario, metadata, labels de datos)
     caption: {
         fontSize: fontSizes.sm,
-        fontFamily: fontFamilies.regular,
-        fontWeight: fontWeights.regular,
+        fontFamily: fontFamilies.mono,
+        fontWeight: fontWeights.mono,
         lineHeight: fontSizes.sm * lineHeights.normal,
         letterSpacing: letterSpacing.normal,
     },
     captionSmall: {
         fontSize: fontSizes.xs,
-        fontFamily: fontFamilies.regular,
-        fontWeight: fontWeights.regular,
+        fontFamily: fontFamilies.mono,
+        fontWeight: fontWeights.mono,
         lineHeight: fontSizes.xs * lineHeights.normal,
         letterSpacing: letterSpacing.normal,
     },
@@ -190,6 +240,34 @@ export const typographyVariants = {
         letterSpacing: letterSpacing.normal,
     },
 };
+/* -------------------- Variant → Font Role --------------------
+ * Cada variante apunta a un ROL de fuente (no a una familia fija), para que
+ * `configureFonts` la cambie en vivo. `Typography.Text` resuelve `fontFamilies[rol]`
+ * en render. La familia "baked" de cada variante arriba queda solo como fallback. */
+export const variantFontRole = {
+    display: "titleBlack",
+    h1: "titleBlack",
+    h2: "title",
+    h3: "title",
+    h4: "medium",
+    h5: "medium",
+    h6: "medium",
+    bodyLarge: "regular",
+    body: "regular",
+    bodySmall: "regular",
+    label: "medium",
+    labelSmall: "medium",
+    data: "monoMedium",
+    dataLarge: "monoMedium",
+    overline: "mono",
+    caption: "mono",
+    captionSmall: "mono",
+    button: "semiBold",
+    buttonSmall: "semiBold",
+    buttonLarge: "semiBold",
+    title: "semiBold",
+    subtitle: "medium",
+};
 /* -------------------- Utility Functions -------------------- */
 export const createTextStyle = (variant, overrides) => ({
     ...typographyVariants[variant],
@@ -208,14 +286,19 @@ export const createCustomTextStyle = (fontSize, fontFamily, options) => {
         ...(options?.color && { color: options.color }),
     };
 };
-/* -------------------- Font Loader -------------------- */
+/* -------------------- Font Loader (opcional, conveniencia) --------------------
+ * Carga las fuentes recomendadas (Inter + Fira Code), que la app instala como peer deps.
+ * El rol "title" (Satoshi u otra) lo carga y enchufa la app/Storybook por su cuenta vía
+ * `configureFonts` — la librería NO bundlea archivos de fuente. */
 export const useAppFonts = () => {
     const [loaded] = useFonts({
-        Montserrat_300Light,
-        Montserrat_400Regular,
-        Montserrat_500Medium,
-        Montserrat_600SemiBold,
-        Montserrat_800ExtraBold,
+        FiraCode_400Regular,
+        FiraCode_500Medium,
+        Inter_300Light,
+        Inter_400Regular,
+        Inter_500Medium,
+        Inter_600SemiBold,
+        Inter_800ExtraBold,
     });
     return loaded;
 };
@@ -227,8 +310,11 @@ export const Typography = {
     lineHeights,
     letterSpacing,
     variants: typographyVariants,
+    variantFontRole,
     createTextStyle,
     createCustomTextStyle,
+    configureFonts,
+    resetFonts,
     useAppFonts,
 };
 export default Typography;

package/dist/theme/useTheme.d.ts

@@ -1 +1,3 @@
-export declare const theme: import("./types").ThemeTokens;
+import type { ThemeTokens } from "../theme/types";
+export declare function useTheme(): ThemeTokens;
+export declare const theme: ThemeTokens;

package/dist/theme/useTheme.js

@@ -1,2 +1,7 @@
-import { getActiveTheme } from "../theme/active";
+import { getActiveTheme, getThemeVersion, subscribeTheme, } from "../theme/active";
+import { useSyncExternalStore } from "react";
+export function useTheme() {
+    useSyncExternalStore(subscribeTheme, getThemeVersion, getThemeVersion);
+    return getActiveTheme();
+}
 export const theme = getActiveTheme();

package/dist/tokens/index.d.ts

@@ -0,0 +1,2 @@
+export { motion } from "../tokens/motion";
+export { duration, type DurationToken, easing, type EasingToken, spring, type SpringToken, } from "../tokens/motion";

package/dist/tokens/index.js

@@ -0,0 +1,2 @@
+export { motion } from "../tokens/motion";
+export { duration, easing, spring, } from "../tokens/motion";

package/dist/tokens/motion.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Motion tokens — durations and curves for consistent animations (reanimated, LayoutAnimation).
+ * Single source of the DS "rhythm": enter/exit, press, theme transitions, sheets, skeletons.
+ */
+export declare const duration: {
+    readonly instant: 0;
+    readonly fast: 120;
+    readonly normal: 200;
+    readonly slow: 320;
+    readonly slower: 480;
+};
+export type DurationToken = keyof typeof duration;
+/** Bezier curves (x1,y1,x2,y2) for Easing.bezier / CSS-like. */
+export declare const easing: {
+    readonly standard: readonly [0.2, 0, 0, 1];
+    readonly decelerate: readonly [0, 0, 0, 1];
+    readonly accelerate: readonly [0.3, 0, 1, 1];
+    readonly emphasized: readonly [0.2, 0, 0, 1];
+};
+export type EasingToken = keyof typeof easing;
+/** Config for reanimated withSpring (spring presets). */
+export declare const spring: {
+    readonly default: {
+        readonly damping: 20;
+        readonly stiffness: 200;
+        readonly mass: 1;
+    };
+    readonly gentle: {
+        readonly damping: 24;
+        readonly stiffness: 120;
+        readonly mass: 1;
+    };
+    readonly snappy: {
+        readonly damping: 18;
+        readonly stiffness: 300;
+        readonly mass: 1;
+    };
+};
+export type SpringToken = keyof typeof spring;
+export declare const motion: {
+    readonly duration: {
+        readonly instant: 0;
+        readonly fast: 120;
+        readonly normal: 200;
+        readonly slow: 320;
+        readonly slower: 480;
+    };
+    readonly easing: {
+        readonly standard: readonly [0.2, 0, 0, 1];
+        readonly decelerate: readonly [0, 0, 0, 1];
+        readonly accelerate: readonly [0.3, 0, 1, 1];
+        readonly emphasized: readonly [0.2, 0, 0, 1];
+    };
+    readonly spring: {
+        readonly default: {
+            readonly damping: 20;
+            readonly stiffness: 200;
+            readonly mass: 1;
+        };
+        readonly gentle: {
+            readonly damping: 24;
+            readonly stiffness: 120;
+            readonly mass: 1;
+        };
+        readonly snappy: {
+            readonly damping: 18;
+            readonly stiffness: 300;
+            readonly mass: 1;
+        };
+    };
+};

package/dist/tokens/motion.js

@@ -0,0 +1,25 @@
+/**
+ * Motion tokens — durations and curves for consistent animations (reanimated, LayoutAnimation).
+ * Single source of the DS "rhythm": enter/exit, press, theme transitions, sheets, skeletons.
+ */
+export const duration = {
+    instant: 0,
+    fast: 120,
+    normal: 200,
+    slow: 320,
+    slower: 480,
+};
+/** Bezier curves (x1,y1,x2,y2) for Easing.bezier / CSS-like. */
+export const easing = {
+    standard: [0.2, 0, 0, 1],
+    decelerate: [0, 0, 0, 1],
+    accelerate: [0.3, 0, 1, 1],
+    emphasized: [0.2, 0, 0, 1],
+};
+/** Config for reanimated withSpring (spring presets). */
+export const spring = {
+    default: { damping: 20, stiffness: 200, mass: 1 },
+    gentle: { damping: 24, stiffness: 120, mass: 1 },
+    snappy: { damping: 18, stiffness: 300, mass: 1 },
+};
+export const motion = { duration, easing, spring };

package/dist/utils/date.d.ts

@@ -3,25 +3,25 @@ interface FormatDateOptions {
     showTime?: boolean;
 }
 /**
- * Formatea una fecha en la zona horaria indicada respetando la granularidad de la entrada.
+ * Formats a date in the given timezone, respecting the granularity of the input.
  *
- * Reglas de detección:
- * 1. Si `input` es un string 'YYYY-MM-DD' (solo fecha) => se interpreta como medianoche (00:00:00)
- *    en la zona horaria destino y se devuelve SOLO la parte de fecha (sin hora).
- * 2. Si `input` incluye componente de tiempo (ISO completo o Date) => se convierte a la zona destino
- *    y se muestra fecha + hora (HH:MM) salvo que se fuerce lo contrario mediante `options.showTime`.
- * 3. Cuando `options.showTime` es `true` o `false` se sobre‑escribe la auto‑detección.
- * 4. Si `timezone` es null/undefined o inválido se retorna la cadena "Error de formateo".
+ * Detection rules:
+ * 1. If `input` is a 'YYYY-MM-DD' string (date only) => interpreted as midnight (00:00:00)
+ *    in the target timezone and ONLY the date part is returned (no time).
+ * 2. If `input` includes a time component (full ISO or Date) => converted to the target timezone
+ *    and shown as date + time (HH:MM) unless overridden via `options.showTime`.
+ * 3. When `options.showTime` is `true` or `false` it overrides the auto-detection.
+ * 4. If `timezone` is null/undefined or invalid, the string "Error de formateo" is returned.
  *
- * Localización:
- * - Usa el primer locale del dispositivo (`expo-localization`) como predeterminado.
- * - Puedes forzar uno diferente con `options.locale` (ej: 'es-CR', 'en-US').
+ * Localization:
+ * - Uses the device's first locale (`expo-localization`) by default.
+ * - You can force a different one with `options.locale` (e.g. 'es-CR', 'en-US').
  *
- * Seguridad de zona horaria:
- * - El parse de una fecha sin hora NO se hace en la zona local del dispositivo para luego convertir,
- *   sino directamente en la zona destino para evitar corrimientos de día.
+ * Timezone safety:
+ * - A date without time is NOT parsed in the device's local zone and then converted,
+ *   but directly in the target zone to avoid day shifts.
  *
- * Ejemplos:
+ * Examples:
  * ```ts
  * formatDate('2025-09-02', 'America/Costa_Rica');
  * // => "2 de septiembre de 2025"
@@ -30,41 +30,41 @@ interface FormatDateOptions {
  * // => "2 de septiembre de 2025, 12:30 p. m." (dependiendo del locale real)
  *
  * formatDate(new Date('2025-09-02T23:15:00Z'), 'Europe/Madrid');
- * // => "3 de septiembre de 2025, 01:15" (cambio de día por zona +02)
+ * // => "3 de septiembre de 2025, 01:15" (day shifts due to +02 zone)
  *
  * formatDate('2025-09-02', 'America/Costa_Rica', { showTime: true });
  * // => "2 de septiembre de 2025, 12:00 a. m." (fuerza hora)
  * ```
  *
- * @param input      Fecha (string ISO, 'YYYY-MM-DD' o instancia Date)
- * @param timezone   Zona horaria IANA (ej: 'America/Costa_Rica', 'Asia/Tokyo'). Si es null/undefined usa Costa Rica
- * @param options    Opcional: locale forzado y/o bandera para mostrar hora
- * @returns          Cadena localizada o "Error de formateo" si no se puede procesar
+ * @param input      Date (ISO string, 'YYYY-MM-DD', or Date instance)
+ * @param timezone   IANA timezone (e.g. 'America/Costa_Rica', 'Asia/Tokyo'). Falls back to Costa Rica if null/undefined
+ * @param options    Optional: forced locale and/or flag to show the time
+ * @returns          Localized string, or "Error de formateo" if it can't be processed
  */
 export declare function formatDate(input: string | Date, timezone: string | null | undefined, options?: FormatDateOptions): string;
 /**
- * Formatea una fecha usando automáticamente el timezone por defecto (Costa Rica).
- * Útil para casos donde no se tiene acceso al timezone del usuario.
+ * Formats a date using the default timezone automatically (Costa Rica).
+ * Useful when the user's timezone isn't available.
  *
- * @param input      Fecha (string ISO, 'YYYY-MM-DD' o instancia Date)
- * @param options    Opcional: locale forzado y/o bandera para mostrar hora
- * @returns          Cadena localizada en timezone de Costa Rica
+ * @param input      Date (ISO string, 'YYYY-MM-DD', or Date instance)
+ * @param options    Optional: forced locale and/or flag to show the time
+ * @returns          Localized string in the Costa Rica timezone
  */
 export declare function formatDateWithDefaultTimezone(input: string | Date, options?: FormatDateOptions): string;
 /**
- * Obtiene la fecha actual en formato YYYY-MM-DD en el timezone especificado.
- * Útil para crear fechas de programación que respeten el timezone del usuario.
+ * Returns the current date as YYYY-MM-DD in the given timezone.
+ * Useful to build scheduling dates that respect the user's timezone.
  *
- * @param timezone Zona horaria IANA. Si es null/undefined usa Costa Rica
- * @returns Fecha actual en formato YYYY-MM-DD en el timezone especificado
+ * @param timezone IANA timezone. Falls back to Costa Rica if null/undefined
+ * @returns Current date as YYYY-MM-DD in the given timezone
  */
 export declare function getCurrentDateInTimezone(timezone?: string | null): string;
 /**
- * Obtiene la fecha y hora actual en formato ISO en el timezone especificado.
- * Útil para timestamps que necesiten reflejar el timezone del usuario.
+ * Returns the current date-time as an ISO string in the given timezone.
+ * Useful for timestamps that need to reflect the user's timezone.
  *
- * @param timezone Zona horaria IANA. Si es null/undefined usa Costa Rica
- * @returns Fecha actual en formato ISO en el timezone especificado
+ * @param timezone IANA timezone. Falls back to Costa Rica if null/undefined
+ * @returns Current date-time as an ISO string in the given timezone
  */
 export declare function getCurrentDateTimeInTimezone(timezone?: string | null): string;
 export {};

package/dist/utils/date.js

@@ -7,25 +7,25 @@ const DEFAULT_LOCALE = "es-CR";
 dayjs.extend(utc);
 dayjs.extend(timezone);
 /**
- * Formatea una fecha en la zona horaria indicada respetando la granularidad de la entrada.
+ * Formats a date in the given timezone, respecting the granularity of the input.
  *
- * Reglas de detección:
- * 1. Si `input` es un string 'YYYY-MM-DD' (solo fecha) => se interpreta como medianoche (00:00:00)
- *    en la zona horaria destino y se devuelve SOLO la parte de fecha (sin hora).
- * 2. Si `input` incluye componente de tiempo (ISO completo o Date) => se convierte a la zona destino
- *    y se muestra fecha + hora (HH:MM) salvo que se fuerce lo contrario mediante `options.showTime`.
- * 3. Cuando `options.showTime` es `true` o `false` se sobre‑escribe la auto‑detección.
- * 4. Si `timezone` es null/undefined o inválido se retorna la cadena "Error de formateo".
+ * Detection rules:
+ * 1. If `input` is a 'YYYY-MM-DD' string (date only) => interpreted as midnight (00:00:00)
+ *    in the target timezone and ONLY the date part is returned (no time).
+ * 2. If `input` includes a time component (full ISO or Date) => converted to the target timezone
+ *    and shown as date + time (HH:MM) unless overridden via `options.showTime`.
+ * 3. When `options.showTime` is `true` or `false` it overrides the auto-detection.
+ * 4. If `timezone` is null/undefined or invalid, the string "Error de formateo" is returned.
  *
- * Localización:
- * - Usa el primer locale del dispositivo (`expo-localization`) como predeterminado.
- * - Puedes forzar uno diferente con `options.locale` (ej: 'es-CR', 'en-US').
+ * Localization:
+ * - Uses the device's first locale (`expo-localization`) by default.
+ * - You can force a different one with `options.locale` (e.g. 'es-CR', 'en-US').
  *
- * Seguridad de zona horaria:
- * - El parse de una fecha sin hora NO se hace en la zona local del dispositivo para luego convertir,
- *   sino directamente en la zona destino para evitar corrimientos de día.
+ * Timezone safety:
+ * - A date without time is NOT parsed in the device's local zone and then converted,
+ *   but directly in the target zone to avoid day shifts.
  *
- * Ejemplos:
+ * Examples:
  * ```ts
  * formatDate('2025-09-02', 'America/Costa_Rica');
  * // => "2 de septiembre de 2025"
@@ -34,19 +34,19 @@ dayjs.extend(timezone);
  * // => "2 de septiembre de 2025, 12:30 p. m." (dependiendo del locale real)
  *
  * formatDate(new Date('2025-09-02T23:15:00Z'), 'Europe/Madrid');
- * // => "3 de septiembre de 2025, 01:15" (cambio de día por zona +02)
+ * // => "3 de septiembre de 2025, 01:15" (day shifts due to +02 zone)
  *
  * formatDate('2025-09-02', 'America/Costa_Rica', { showTime: true });
  * // => "2 de septiembre de 2025, 12:00 a. m." (fuerza hora)
  * ```
  *
- * @param input      Fecha (string ISO, 'YYYY-MM-DD' o instancia Date)
- * @param timezone   Zona horaria IANA (ej: 'America/Costa_Rica', 'Asia/Tokyo'). Si es null/undefined usa Costa Rica
- * @param options    Opcional: locale forzado y/o bandera para mostrar hora
- * @returns          Cadena localizada o "Error de formateo" si no se puede procesar
+ * @param input      Date (ISO string, 'YYYY-MM-DD', or Date instance)
+ * @param timezone   IANA timezone (e.g. 'America/Costa_Rica', 'Asia/Tokyo'). Falls back to Costa Rica if null/undefined
+ * @param options    Optional: forced locale and/or flag to show the time
+ * @returns          Localized string, or "Error de formateo" if it can't be processed
  */
 export function formatDate(input, timezone, options) {
-    // Usar timezone por defecto si no se proporciona
+    // Use the default timezone when none is provided
     const effectiveTimezone = timezone || DEFAULT_TIMEZONE;
     const fallbackLocale = DEFAULT_LOCALE.split("-")[0]; // "es" from "es-CR"
     const deviceLocale = getLocales()?.[0]?.languageTag ?? fallbackLocale;
@@ -54,10 +54,10 @@ export function formatDate(input, timezone, options) {
     try {
         const rawStr = typeof input === "string" ? input : input.toISOString();
         const isDateOnly = /^\d{4}-\d{2}-\d{2}$/.test(rawStr);
-        // Auto-detect showTime si no se pasa explicitamente
+        // Auto-detect showTime when not passed explicitly
         const effectiveShowTime = options?.showTime !== undefined
             ? options.showTime
-            : !isDateOnly && /T\d{2}:\d{2}/.test(rawStr); // tiene componente hora
+            : !isDateOnly && /T\d{2}:\d{2}/.test(rawStr); // has a time component
         const dateInstance = isDateOnly
             ? dayjs.tz(`${rawStr}T00:00:00`, effectiveTimezone)
             : dayjs.utc(rawStr).tz(effectiveTimezone);
@@ -75,27 +75,27 @@ export function formatDate(input, timezone, options) {
         return new Intl.DateTimeFormat(usedLocale, formatOptions).format(dateInZone);
     }
     catch (error) {
-        console.warn("Error formateando fecha:", error);
+        console.warn("Error formatting date:", error);
         return "Error de formateo";
     }
 }
 /**
- * Formatea una fecha usando automáticamente el timezone por defecto (Costa Rica).
- * Útil para casos donde no se tiene acceso al timezone del usuario.
+ * Formats a date using the default timezone automatically (Costa Rica).
+ * Useful when the user's timezone isn't available.
  *
- * @param input      Fecha (string ISO, 'YYYY-MM-DD' o instancia Date)
- * @param options    Opcional: locale forzado y/o bandera para mostrar hora
- * @returns          Cadena localizada en timezone de Costa Rica
+ * @param input      Date (ISO string, 'YYYY-MM-DD', or Date instance)
+ * @param options    Optional: forced locale and/or flag to show the time
+ * @returns          Localized string in the Costa Rica timezone
  */
 export function formatDateWithDefaultTimezone(input, options) {
     return formatDate(input, DEFAULT_TIMEZONE, options);
 }
 /**
- * Obtiene la fecha actual en formato YYYY-MM-DD en el timezone especificado.
- * Útil para crear fechas de programación que respeten el timezone del usuario.
+ * Returns the current date as YYYY-MM-DD in the given timezone.
+ * Useful to build scheduling dates that respect the user's timezone.
  *
- * @param timezone Zona horaria IANA. Si es null/undefined usa Costa Rica
- * @returns Fecha actual en formato YYYY-MM-DD en el timezone especificado
+ * @param timezone IANA timezone. Falls back to Costa Rica if null/undefined
+ * @returns Current date as YYYY-MM-DD in the given timezone
  */
 export function getCurrentDateInTimezone(timezone) {
     const effectiveTimezone = timezone || DEFAULT_TIMEZONE;
@@ -103,16 +103,16 @@ export function getCurrentDateInTimezone(timezone) {
         return dayjs().tz(effectiveTimezone).format("YYYY-MM-DD");
     }
     catch (error) {
-        console.warn("Error obteniendo fecha actual en timezone:", error);
+        console.warn("Error getting current date in timezone:", error);
         return dayjs().format("YYYY-MM-DD"); // Fallback to local
     }
 }
 /**
- * Obtiene la fecha y hora actual en formato ISO en el timezone especificado.
- * Útil para timestamps que necesiten reflejar el timezone del usuario.
+ * Returns the current date-time as an ISO string in the given timezone.
+ * Useful for timestamps that need to reflect the user's timezone.
  *
- * @param timezone Zona horaria IANA. Si es null/undefined usa Costa Rica
- * @returns Fecha actual en formato ISO en el timezone especificado
+ * @param timezone IANA timezone. Falls back to Costa Rica if null/undefined
+ * @returns Current date-time as an ISO string in the given timezone
  */
 export function getCurrentDateTimeInTimezone(timezone) {
     const effectiveTimezone = timezone || DEFAULT_TIMEZONE;
@@ -120,7 +120,7 @@ export function getCurrentDateTimeInTimezone(timezone) {
         return dayjs().tz(effectiveTimezone).toISOString();
     }
     catch (error) {
-        console.warn("Error obteniendo fecha/hora actual en timezone:", error);
+        console.warn("Error getting current date-time in timezone:", error);
         return dayjs().toISOString(); // Fallback to local
     }
 }

package/dist/utils/timezone.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @deprecated Region-coupled (LatAm locale data); relocated to the core alongside the
+ * TimeZone widgets. Import from `@sincpro/mobile/ui/components/molecules` instead. Kept
+ * here for backwards compatibility and removed in the next major.
+ */
 export interface TimezoneLocale {
     timezone: string;
     locale: string;

package/dist/views/AuthFormView.d.ts

@@ -7,5 +7,5 @@ interface AuthFormProps {
     onBack?: () => void;
     FormNode: ReactNode;
 }
-declare function AuthFormView({ title, description, logoSource, onBack, FormNode }: AuthFormProps): import("react/jsx-runtime").JSX.Element;
+declare function AuthFormView({ title, description, logoSource, onBack, FormNode }: AuthFormProps): import("react").JSX.Element;
 export default AuthFormView;

package/dist/views/FormViewV2.context.d.ts

@@ -27,6 +27,6 @@ export declare function FormViewProvider<T>({ name, description, item, isLoading
     onRetry?: () => void;
     onBack?: () => void;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function useFormView<T>(): FormViewContextValue<T>;
 export {};