@sincpro/mobile-ui 0.1.2 → 0.1.4

package/lib/theme/typography.d.ts

@@ -0,0 +1,376 @@
+import type { TextStyle } from "react-native";
+export declare const fontFamilies: {
+    readonly light: "Montserrat_300Light";
+    readonly regular: "Montserrat_400Regular";
+    readonly medium: "Montserrat_500Medium";
+    readonly semiBold: "Montserrat_600SemiBold";
+    readonly extraBold: "Montserrat_800ExtraBold";
+};
+export declare const fontWeights: {
+    readonly light: "300";
+    readonly regular: "400";
+    readonly medium: "500";
+    readonly semiBold: "600";
+    readonly extraBold: "800";
+};
+export declare const fontSizes: {
+    readonly xs: 10;
+    readonly sm: 13;
+    readonly base: 14;
+    readonly lg: 16;
+    readonly xl: 18;
+    readonly "2xl": 20;
+    readonly "3xl": 24;
+    readonly "4xl": 28;
+    readonly "5xl": 32;
+    readonly "6xl": 36;
+    readonly "7xl": 48;
+    readonly "8xl": 64;
+};
+export declare const lineHeights: {
+    readonly none: 1;
+    readonly tight: 1.25;
+    readonly snug: 1.375;
+    readonly normal: 1.5;
+    readonly relaxed: 1.625;
+    readonly loose: 2;
+};
+export declare const letterSpacing: {
+    readonly tighter: -0.5;
+    readonly tight: -0.25;
+    readonly normal: 0;
+    readonly wide: 0.25;
+    readonly wider: 0.5;
+    readonly widest: 1;
+};
+export declare const typographyVariants: {
+    readonly display: {
+        readonly fontSize: 48;
+        readonly fontFamily: "Montserrat_800ExtraBold";
+        readonly fontWeight: "800";
+        readonly lineHeight: number;
+        readonly letterSpacing: -0.25;
+    };
+    readonly h1: {
+        readonly fontSize: 32;
+        readonly fontFamily: "Montserrat_800ExtraBold";
+        readonly fontWeight: "800";
+        readonly lineHeight: number;
+        readonly letterSpacing: -0.25;
+    };
+    readonly h2: {
+        readonly fontSize: 28;
+        readonly fontFamily: "Montserrat_600SemiBold";
+        readonly fontWeight: "600";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly h3: {
+        readonly fontSize: 24;
+        readonly fontFamily: "Montserrat_600SemiBold";
+        readonly fontWeight: "600";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly h4: {
+        readonly fontSize: 20;
+        readonly fontFamily: "Montserrat_500Medium";
+        readonly fontWeight: "500";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly h5: {
+        readonly fontSize: 18;
+        readonly fontFamily: "Montserrat_500Medium";
+        readonly fontWeight: "500";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly h6: {
+        readonly fontSize: 16;
+        readonly fontFamily: "Montserrat_500Medium";
+        readonly fontWeight: "500";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly bodyLarge: {
+        readonly fontSize: 16;
+        readonly fontFamily: "Montserrat_400Regular";
+        readonly fontWeight: "400";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly body: {
+        readonly fontSize: 14;
+        readonly fontFamily: "Montserrat_400Regular";
+        readonly fontWeight: "400";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly bodySmall: {
+        readonly fontSize: 13;
+        readonly fontFamily: "Montserrat_400Regular";
+        readonly fontWeight: "400";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly label: {
+        readonly fontSize: 14;
+        readonly fontFamily: "Montserrat_500Medium";
+        readonly fontWeight: "500";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0.25;
+    };
+    readonly labelSmall: {
+        readonly fontSize: 13;
+        readonly fontFamily: "Montserrat_500Medium";
+        readonly fontWeight: "500";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0.25;
+    };
+    readonly caption: {
+        readonly fontSize: 13;
+        readonly fontFamily: "Montserrat_400Regular";
+        readonly fontWeight: "400";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly captionSmall: {
+        readonly fontSize: 10;
+        readonly fontFamily: "Montserrat_400Regular";
+        readonly fontWeight: "400";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly button: {
+        readonly fontSize: 14;
+        readonly fontFamily: "Montserrat_600SemiBold";
+        readonly fontWeight: "600";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0.25;
+    };
+    readonly buttonSmall: {
+        readonly fontSize: 13;
+        readonly fontFamily: "Montserrat_600SemiBold";
+        readonly fontWeight: "600";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0.25;
+    };
+    readonly buttonLarge: {
+        readonly fontSize: 16;
+        readonly fontFamily: "Montserrat_600SemiBold";
+        readonly fontWeight: "600";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0.25;
+    };
+    readonly title: {
+        readonly fontSize: 18;
+        readonly fontFamily: "Montserrat_600SemiBold";
+        readonly fontWeight: "600";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+    readonly subtitle: {
+        readonly fontSize: 16;
+        readonly fontFamily: "Montserrat_500Medium";
+        readonly fontWeight: "500";
+        readonly lineHeight: number;
+        readonly letterSpacing: 0;
+    };
+};
+export declare const createTextStyle: (variant: keyof typeof typographyVariants, overrides?: Partial<TextStyle>) => TextStyle;
+export declare const createCustomTextStyle: (fontSize: keyof typeof fontSizes, fontFamily: keyof typeof fontFamilies, options?: {
+    lineHeight?: keyof typeof lineHeights;
+    letterSpacing?: keyof typeof letterSpacing;
+    color?: string;
+}) => TextStyle;
+export declare const useAppFonts: () => boolean;
+export declare const Typography: {
+    readonly fontFamilies: {
+        readonly light: "Montserrat_300Light";
+        readonly regular: "Montserrat_400Regular";
+        readonly medium: "Montserrat_500Medium";
+        readonly semiBold: "Montserrat_600SemiBold";
+        readonly extraBold: "Montserrat_800ExtraBold";
+    };
+    readonly fontWeights: {
+        readonly light: "300";
+        readonly regular: "400";
+        readonly medium: "500";
+        readonly semiBold: "600";
+        readonly extraBold: "800";
+    };
+    readonly fontSizes: {
+        readonly xs: 10;
+        readonly sm: 13;
+        readonly base: 14;
+        readonly lg: 16;
+        readonly xl: 18;
+        readonly "2xl": 20;
+        readonly "3xl": 24;
+        readonly "4xl": 28;
+        readonly "5xl": 32;
+        readonly "6xl": 36;
+        readonly "7xl": 48;
+        readonly "8xl": 64;
+    };
+    readonly lineHeights: {
+        readonly none: 1;
+        readonly tight: 1.25;
+        readonly snug: 1.375;
+        readonly normal: 1.5;
+        readonly relaxed: 1.625;
+        readonly loose: 2;
+    };
+    readonly letterSpacing: {
+        readonly tighter: -0.5;
+        readonly tight: -0.25;
+        readonly normal: 0;
+        readonly wide: 0.25;
+        readonly wider: 0.5;
+        readonly widest: 1;
+    };
+    readonly variants: {
+        readonly display: {
+            readonly fontSize: 48;
+            readonly fontFamily: "Montserrat_800ExtraBold";
+            readonly fontWeight: "800";
+            readonly lineHeight: number;
+            readonly letterSpacing: -0.25;
+        };
+        readonly h1: {
+            readonly fontSize: 32;
+            readonly fontFamily: "Montserrat_800ExtraBold";
+            readonly fontWeight: "800";
+            readonly lineHeight: number;
+            readonly letterSpacing: -0.25;
+        };
+        readonly h2: {
+            readonly fontSize: 28;
+            readonly fontFamily: "Montserrat_600SemiBold";
+            readonly fontWeight: "600";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly h3: {
+            readonly fontSize: 24;
+            readonly fontFamily: "Montserrat_600SemiBold";
+            readonly fontWeight: "600";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly h4: {
+            readonly fontSize: 20;
+            readonly fontFamily: "Montserrat_500Medium";
+            readonly fontWeight: "500";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly h5: {
+            readonly fontSize: 18;
+            readonly fontFamily: "Montserrat_500Medium";
+            readonly fontWeight: "500";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly h6: {
+            readonly fontSize: 16;
+            readonly fontFamily: "Montserrat_500Medium";
+            readonly fontWeight: "500";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly bodyLarge: {
+            readonly fontSize: 16;
+            readonly fontFamily: "Montserrat_400Regular";
+            readonly fontWeight: "400";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly body: {
+            readonly fontSize: 14;
+            readonly fontFamily: "Montserrat_400Regular";
+            readonly fontWeight: "400";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly bodySmall: {
+            readonly fontSize: 13;
+            readonly fontFamily: "Montserrat_400Regular";
+            readonly fontWeight: "400";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly label: {
+            readonly fontSize: 14;
+            readonly fontFamily: "Montserrat_500Medium";
+            readonly fontWeight: "500";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0.25;
+        };
+        readonly labelSmall: {
+            readonly fontSize: 13;
+            readonly fontFamily: "Montserrat_500Medium";
+            readonly fontWeight: "500";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0.25;
+        };
+        readonly caption: {
+            readonly fontSize: 13;
+            readonly fontFamily: "Montserrat_400Regular";
+            readonly fontWeight: "400";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly captionSmall: {
+            readonly fontSize: 10;
+            readonly fontFamily: "Montserrat_400Regular";
+            readonly fontWeight: "400";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly button: {
+            readonly fontSize: 14;
+            readonly fontFamily: "Montserrat_600SemiBold";
+            readonly fontWeight: "600";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0.25;
+        };
+        readonly buttonSmall: {
+            readonly fontSize: 13;
+            readonly fontFamily: "Montserrat_600SemiBold";
+            readonly fontWeight: "600";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0.25;
+        };
+        readonly buttonLarge: {
+            readonly fontSize: 16;
+            readonly fontFamily: "Montserrat_600SemiBold";
+            readonly fontWeight: "600";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0.25;
+        };
+        readonly title: {
+            readonly fontSize: 18;
+            readonly fontFamily: "Montserrat_600SemiBold";
+            readonly fontWeight: "600";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+        readonly subtitle: {
+            readonly fontSize: 16;
+            readonly fontFamily: "Montserrat_500Medium";
+            readonly fontWeight: "500";
+            readonly lineHeight: number;
+            readonly letterSpacing: 0;
+        };
+    };
+    readonly createTextStyle: (variant: keyof typeof typographyVariants, overrides?: Partial<TextStyle>) => TextStyle;
+    readonly createCustomTextStyle: (fontSize: keyof typeof fontSizes, fontFamily: keyof typeof fontFamilies, options?: {
+        lineHeight?: keyof typeof lineHeights;
+        letterSpacing?: keyof typeof letterSpacing;
+        color?: string;
+    }) => TextStyle;
+    readonly useAppFonts: () => boolean;
+};
+export default Typography;

package/lib/theme/typography.js

@@ -0,0 +1,234 @@
+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",
+};
+export const fontWeights = {
+    light: "300",
+    regular: "400",
+    medium: "500",
+    semiBold: "600",
+    extraBold: "800",
+};
+/* -------------------- Font Sizes -------------------- */
+export const fontSizes = {
+    xs: 10,
+    sm: 13,
+    base: 14,
+    lg: 16,
+    xl: 18,
+    "2xl": 20,
+    "3xl": 24,
+    "4xl": 28,
+    "5xl": 32,
+    "6xl": 36,
+    "7xl": 48,
+    "8xl": 64,
+};
+/* -------------------- Line Heights -------------------- */
+export const lineHeights = {
+    none: 1,
+    tight: 1.25,
+    snug: 1.375,
+    normal: 1.5,
+    relaxed: 1.625,
+    loose: 2,
+};
+/* -------------------- Letter Spacing -------------------- */
+export const letterSpacing = {
+    tighter: -0.5,
+    tight: -0.25,
+    normal: 0,
+    wide: 0.25,
+    wider: 0.5,
+    widest: 1,
+};
+/* -------------------- Typography Variants -------------------- */
+export const typographyVariants = {
+    // Display
+    display: {
+        fontSize: fontSizes["7xl"],
+        fontFamily: fontFamilies.extraBold,
+        fontWeight: fontWeights.extraBold,
+        lineHeight: fontSizes["7xl"] * lineHeights.tight,
+        letterSpacing: letterSpacing.tight,
+    },
+    // Headings
+    h1: {
+        fontSize: fontSizes["5xl"],
+        fontFamily: fontFamilies.extraBold,
+        fontWeight: fontWeights.extraBold,
+        lineHeight: fontSizes["5xl"] * lineHeights.tight,
+        letterSpacing: letterSpacing.tight,
+    },
+    h2: {
+        fontSize: fontSizes["4xl"],
+        fontFamily: fontFamilies.semiBold,
+        fontWeight: fontWeights.semiBold,
+        lineHeight: fontSizes["4xl"] * lineHeights.snug,
+        letterSpacing: letterSpacing.normal,
+    },
+    h3: {
+        fontSize: fontSizes["3xl"],
+        fontFamily: fontFamilies.semiBold,
+        fontWeight: fontWeights.semiBold,
+        lineHeight: fontSizes["3xl"] * lineHeights.snug,
+        letterSpacing: letterSpacing.normal,
+    },
+    h4: {
+        fontSize: fontSizes["2xl"],
+        fontFamily: fontFamilies.medium,
+        fontWeight: fontWeights.medium,
+        lineHeight: fontSizes["2xl"] * lineHeights.normal,
+        letterSpacing: letterSpacing.normal,
+    },
+    h5: {
+        fontSize: fontSizes.xl,
+        fontFamily: fontFamilies.medium,
+        fontWeight: fontWeights.medium,
+        lineHeight: fontSizes.xl * lineHeights.normal,
+        letterSpacing: letterSpacing.normal,
+    },
+    h6: {
+        fontSize: fontSizes.lg,
+        fontFamily: fontFamilies.medium,
+        fontWeight: fontWeights.medium,
+        lineHeight: fontSizes.lg * lineHeights.normal,
+        letterSpacing: letterSpacing.normal,
+    },
+    // Body
+    bodyLarge: {
+        fontSize: fontSizes.lg,
+        fontFamily: fontFamilies.regular,
+        fontWeight: fontWeights.regular,
+        lineHeight: fontSizes.lg * lineHeights.relaxed,
+        letterSpacing: letterSpacing.normal,
+    },
+    body: {
+        fontSize: fontSizes.base,
+        fontFamily: fontFamilies.regular,
+        fontWeight: fontWeights.regular,
+        lineHeight: fontSizes.base * lineHeights.relaxed,
+        letterSpacing: letterSpacing.normal,
+    },
+    bodySmall: {
+        fontSize: fontSizes.sm,
+        fontFamily: fontFamilies.regular,
+        fontWeight: fontWeights.regular,
+        lineHeight: fontSizes.sm * lineHeights.normal,
+        letterSpacing: letterSpacing.normal,
+    },
+    // Label
+    label: {
+        fontSize: fontSizes.base,
+        fontFamily: fontFamilies.medium,
+        fontWeight: fontWeights.medium,
+        lineHeight: fontSizes.base * lineHeights.normal,
+        letterSpacing: letterSpacing.wide,
+    },
+    labelSmall: {
+        fontSize: fontSizes.sm,
+        fontFamily: fontFamilies.medium,
+        fontWeight: fontWeights.medium,
+        lineHeight: fontSizes.sm * lineHeights.normal,
+        letterSpacing: letterSpacing.wide,
+    },
+    // Caption
+    caption: {
+        fontSize: fontSizes.sm,
+        fontFamily: fontFamilies.regular,
+        fontWeight: fontWeights.regular,
+        lineHeight: fontSizes.sm * lineHeights.normal,
+        letterSpacing: letterSpacing.normal,
+    },
+    captionSmall: {
+        fontSize: fontSizes.xs,
+        fontFamily: fontFamilies.regular,
+        fontWeight: fontWeights.regular,
+        lineHeight: fontSizes.xs * lineHeights.normal,
+        letterSpacing: letterSpacing.normal,
+    },
+    // Buttons
+    button: {
+        fontSize: fontSizes.base,
+        fontFamily: fontFamilies.semiBold,
+        fontWeight: fontWeights.semiBold,
+        lineHeight: fontSizes.base * lineHeights.none,
+        letterSpacing: letterSpacing.wide,
+    },
+    buttonSmall: {
+        fontSize: fontSizes.sm,
+        fontFamily: fontFamilies.semiBold,
+        fontWeight: fontWeights.semiBold,
+        lineHeight: fontSizes.sm * lineHeights.none,
+        letterSpacing: letterSpacing.wide,
+    },
+    buttonLarge: {
+        fontSize: fontSizes.lg,
+        fontFamily: fontFamilies.semiBold,
+        fontWeight: fontWeights.semiBold,
+        lineHeight: fontSizes.lg * lineHeights.none,
+        letterSpacing: letterSpacing.wide,
+    },
+    // Legacy
+    title: {
+        fontSize: fontSizes.xl,
+        fontFamily: fontFamilies.semiBold,
+        fontWeight: fontWeights.semiBold,
+        lineHeight: fontSizes.xl * lineHeights.snug,
+        letterSpacing: letterSpacing.normal,
+    },
+    subtitle: {
+        fontSize: fontSizes.lg,
+        fontFamily: fontFamilies.medium,
+        fontWeight: fontWeights.medium,
+        lineHeight: fontSizes.lg * lineHeights.normal,
+        letterSpacing: letterSpacing.normal,
+    },
+};
+/* -------------------- Utility Functions -------------------- */
+export const createTextStyle = (variant, overrides) => ({
+    ...typographyVariants[variant],
+    ...overrides,
+});
+export const createCustomTextStyle = (fontSize, fontFamily, options) => {
+    const size = fontSizes[fontSize];
+    const line = options?.lineHeight ? lineHeights[options.lineHeight] : lineHeights.normal;
+    const spacing = options?.letterSpacing ?? "normal";
+    return {
+        fontSize: size,
+        fontFamily: fontFamilies[fontFamily],
+        fontWeight: fontWeights[fontFamily],
+        lineHeight: size * line,
+        letterSpacing: letterSpacing[spacing],
+        ...(options?.color && { color: options.color }),
+    };
+};
+/* -------------------- Font Loader -------------------- */
+export const useAppFonts = () => {
+    const [loaded] = useFonts({
+        Montserrat_300Light,
+        Montserrat_400Regular,
+        Montserrat_500Medium,
+        Montserrat_600SemiBold,
+        Montserrat_800ExtraBold,
+    });
+    return loaded;
+};
+/* -------------------- Typography Object -------------------- */
+export const Typography = {
+    fontFamilies,
+    fontWeights,
+    fontSizes,
+    lineHeights,
+    letterSpacing,
+    variants: typographyVariants,
+    createTextStyle,
+    createCustomTextStyle,
+    useAppFonts,
+};
+export default Typography;

package/lib/theme/useTheme.d.ts

@@ -0,0 +1 @@
+export declare const theme: import("./types").ThemeTokens;

package/lib/theme/useTheme.js

@@ -0,0 +1,2 @@
+import { getActiveTheme } from "../theme/active";
+export const theme = getActiveTheme();

package/lib/utils/date.d.ts

@@ -0,0 +1,70 @@
+interface FormatDateOptions {
+    locale?: string | null;
+    showTime?: boolean;
+}
+/**
+ * Formatea una fecha en la zona horaria indicada respetando la granularidad de la entrada.
+ *
+ * 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".
+ *
+ * Localización:
+ * - Usa el primer locale del dispositivo (`expo-localization`) como predeterminado.
+ * - Puedes forzar uno diferente con `options.locale` (ej: '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.
+ *
+ * Ejemplos:
+ * ```ts
+ * formatDate('2025-09-02', 'America/Costa_Rica');
+ * // => "2 de septiembre de 2025"
+ *
+ * formatDate('2025-09-02T18:30:00Z', 'America/Costa_Rica');
+ * // => "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)
+ *
+ * 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
+ */
+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.
+ *
+ * @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
+ */
+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.
+ *
+ * @param timezone Zona horaria IANA. Si es null/undefined usa Costa Rica
+ * @returns Fecha actual en formato YYYY-MM-DD en el timezone especificado
+ */
+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.
+ *
+ * @param timezone Zona horaria IANA. Si es null/undefined usa Costa Rica
+ * @returns Fecha actual en formato ISO en el timezone especificado
+ */
+export declare function getCurrentDateTimeInTimezone(timezone?: string | null): string;
+export {};