@trii/components 3.1.3 → 3.1.5

package/dist/types/components/ContactSidebar/ContactSidebar.stories.d.ts

@@ -0,0 +1,58 @@
+import type { StoryObj } from '@storybook/react';
+/**
+ * El componente es SOLO el panel de contacto (sin el header de vistas
+ * Contacto/Interacción/Asistente, que vive en el host) y su root es un
+ * Fragment: el decorator provee el contenedor flex `position: relative`
+ * contra el que se posicionan el overlay y el skeleton.
+ *
+ * El panel resuelve todo contra la API con `baseUrl` + `spaceId`, así que en
+ * Storybook hay que apuntarlo a un espacio real (y estar logueado, porque el
+ * token lo inyecta el interceptor del anfitrión).
+ *
+ * Ver README.md para el detalle de cada prop.
+ */
+declare const meta: {
+    component: (props: import("./ChatDetailsSidebar").ChatDetailsSidebarProps) => import("react/jsx-runtime").JSX.Element;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+    decorators: ((Story: import("@storybook/csf").PartialStoryFn<import("@storybook/react").ReactRenderer, {
+        baseUrl: string;
+        spaceId: string;
+        onEntityUpdated?: ((entity: import("@trii/types/dist/Contacts").IContact | import("@trii/types/dist/Contacts").IBusiness) => void) | undefined;
+        chat?: import("./ChatDetailsSidebar").SidebarChatIntegration | undefined;
+        googleMapsApiKey?: string | undefined;
+        navigate?: ((path: string) => void) | undefined;
+        language?: string | undefined;
+        active?: boolean | undefined;
+        contactId: string | null;
+        entityType: "contact" | "business";
+        initialEntity?: (import("@trii/types/dist/Contacts").IContact | import("@trii/types/dist/Contacts").IBusiness | null) | undefined;
+        entity?: never | undefined;
+    } | {
+        baseUrl: string;
+        spaceId: string;
+        onEntityUpdated?: ((entity: import("@trii/types/dist/Contacts").IContact | import("@trii/types/dist/Contacts").IBusiness) => void) | undefined;
+        chat?: import("./ChatDetailsSidebar").SidebarChatIntegration | undefined;
+        googleMapsApiKey?: string | undefined;
+        navigate?: ((path: string) => void) | undefined;
+        language?: string | undefined;
+        active?: boolean | undefined;
+        entity: import("@trii/types/dist/Contacts").IContact | import("@trii/types/dist/Contacts").IBusiness;
+        contactId?: never | undefined;
+        entityType?: never | undefined;
+        initialEntity?: never | undefined;
+    }>) => import("react/jsx-runtime").JSX.Element)[];
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+/**
+ * Forma A (recomendada): se le pasa la ficha completa y de ahí deduce el id y
+ * el tipo. Sin `chat`, o sea en modo ficha.
+ */
+export declare const ConEntidad: Story;
+/** Forma B: solo el id, declarando el tipo a mano. */
+export declare const ConId: Story;
+/** Empresa: el tipo sale del `isBusiness` de la entidad. */
+export declare const Empresa: Story;

package/dist/types/components/EditContactModal/EditContactModal.stories.d.ts

@@ -0,0 +1,9 @@
+declare const meta: {
+    title: string;
+    component: (props: import("./EditContactModal").EditContactModalProps) => import("react/jsx-runtime").JSX.Element;
+    tags: string[];
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;

package/dist/types/components/EventsDialog/components/LinkContactsSelect/styles.d.ts

@@ -0,0 +1,6 @@
+export declare const SelectPrimaryContainer: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/system").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/system").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/system").Theme>, {}, {}>;
+export declare const SelectSecondaryContainer: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/system").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/system").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/system").Theme>, {}, {}>;

package/dist/types/components/EventsDialog/components/LocationTextField/MapLocationPicker.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface MapLocationPickerProps {
+    onLocationSelect: (address: string, lat: number, lng: number) => void;
+    initialAddress?: string;
+    onClose?: () => void;
+}
+declare const MapLocationPicker: React.FC<MapLocationPickerProps>;
+export default MapLocationPicker;

package/dist/types/components/EventsDialog/components/LocationTextField/SendLocation/components/GoogleMap/index.d.ts

@@ -0,0 +1 @@
+export { default } from './GoogleMapStandalone';

package/dist/types/components/EventsDialog/components/LocationTextField/SendLocation/components/index.d.ts

@@ -0,0 +1 @@
+export { default as GoogleMapStandalone } from './GoogleMap/GoogleMapStandalone';

package/dist/types/components/EventsDialog/components/LocationTextField/SendLocation/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from './LocationSelectorModal';
+export { default as LocationSelectorModal } from './LocationSelectorModal';
+export type { LocationData } from './types';

package/dist/types/components/EventsDialog/hooks/index.d.ts

@@ -0,0 +1,9 @@
+export { default as useField, useFieldInitialState, type UseFieldType } from './useField';
+export { default as useSelect, type UseSelect } from './useSelect';
+export { default as useDialog, useDialogInitialState, type UseDialog } from './useDialog';
+export { default as useEvent, useEventInitialState, type UseEvent, type UseDateState, type UseLinkContact, } from './useEvent';
+export { type UseNotificationsType } from './useNotifications';
+export { default as useTask, useTaskInitialState, type UseTask } from './useTask';
+export { default as useCalendar, useCalendarInitialState, type UseCalendarType, } from './useCalendar';
+export { default as useCalendarEvents, useCalendarEventsInitialState, type UseCalendarEventsType, type CalendarEvent, } from './useCalendarEvents';
+export { default as useCalendarTasks, useCalendarTasksInitialState, type UseCalendarTasksType, type CalendarTask, } from './useCalendarTasks';

package/dist/types/components/EventsDialog/hooks/useSelect.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+import { SelectChangeEvent } from '@mui/material';
+export interface UseSelect {
+    actions: {
+        resetValue: () => void;
+        changeValue: (newValue: string | number) => void;
+    };
+    attributes: {
+        value: string | number;
+        onChange: (event: SelectChangeEvent<string>, child: ReactNode) => void;
+    };
+}
+declare const useSelect: (initialValue: string | number) => UseSelect;
+export default useSelect;

package/dist/types/components/EventsDialog/utils/eventValidation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Utilidades para validación de eventos del calendario
+ */
+export interface CalendarItem {
+    id?: string;
+    start: Date | string;
+    end: Date | string;
+    title?: string;
+    kind?: 'event' | 'task';
+}
+/**
+ * Verifica si dos eventos se solapan en el tiempo
+ */
+export declare const eventsOverlap: (event1: CalendarItem, event2: CalendarItem) => boolean;
+/**
+ * Encuentra todos los eventos que se solapan con un evento dado
+ */
+export declare const findOverlappingEvents: (targetEvent: CalendarItem, allEvents: CalendarItem[]) => CalendarItem[];
+/**
+ * Valida que un evento tenga fechas válidas
+ */
+export declare const validateEventDates: (event: CalendarItem) => {
+    isValid: boolean;
+    error?: string;
+};
+/**
+ * Genera un mensaje descriptivo sobre eventos solapados
+ */
+export declare const getOverlapWarningMessage: (overlappingEvents: CalendarItem[]) => string;
+/**
+ * Calcula la duración de un evento en minutos
+ */
+export declare const getEventDuration: (event: CalendarItem) => number;
+/**
+ * Verifica si un evento es de todo el día
+ */
+export declare const isAllDayEvent: (event: CalendarItem) => boolean;

package/dist/types/components/EventsDialog/utils/googleMapsUtils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-exportaciones de googleMapsLoader para mantener compatibilidad
+ * Este archivo actúa como alias para las funciones de Google Maps
+ */
+export { GOOGLE_MAPS_CONFIG, GOOGLE_MAPS_SCRIPT_CONFIG, useGoogleMapsLoader, loadGoogleMapsAsync, getStaticMapUrl, geocodeAddress, } from './googleMapsLoader';

package/dist/types/components/EventsDialog/utils/keyboardNavigation.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Utilidades para navegación por teclado en el calendario
+ */
+type View = 'month' | 'week' | 'day' | 'work_week' | 'agenda';
+export interface KeyboardNavigationConfig {
+    onNavigate: (action: 'PREV' | 'NEXT' | 'TODAY' | 'DATE', date?: Date) => void;
+    onViewChange: (view: View) => void;
+    onCreateEvent?: () => void;
+    currentDate: Date;
+    currentView: View;
+}
+/**
+ * Maneja los eventos de teclado para el calendario
+ */
+export declare const handleCalendarKeyDown: (event: KeyboardEvent, config: KeyboardNavigationConfig) => void;
+/**
+ * Genera el mensaje de ayuda para atajos de teclado
+ */
+export declare const getKeyboardShortcutsHelp: () => string;
+/**
+ * Genera los atributos ARIA para el calendario
+ */
+export declare const getCalendarAriaAttributes: (currentView: View, currentDate: Date) => Record<string, string>;
+export {};

package/dist/types/components/PanelErrorBoundary/__tests__/PanelErrorBoundary.test.d.ts

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

package/dist/types/theme/MuiComponentsConfig.test.d.ts

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

package/dist/types/theme/darkThemeComponents.d.ts

@@ -0,0 +1,3 @@
+import { Theme } from '@mui/material/styles';
+/** Aplica los ajustes de contraste compartidos exclusivamente en modo oscuro. */
+export declare const applyDarkThemeComponents: (sharedTheme: Theme) => Theme;

package/dist/types/theme/index.d.ts

@@ -3,3 +3,5 @@ export type { MuiComponentsConfigOptions } from './MuiComponentsConfig';
 export { default as themeReducer } from './themeSlice';
 export * from './themeProvider';
 export * from './themeSlice';
+export { THEME_PREFERENCES, normalizeThemePreference, resolveThemePreference, observeThemePreference } from './themePreference';
+export type { ThemePreference, ResolvedTheme, LegacyThemeName } from './themePreference';

package/dist/types/theme/themePreference.d.ts

@@ -0,0 +1,14 @@
+export type ThemePreference = 'light' | 'dark' | 'system';
+export type ResolvedTheme = 'light' | 'dark';
+export declare const THEME_PREFERENCES: readonly ThemePreference[];
+export declare const LEGACY_THEME_NAMES: readonly ["lightBlueIndigo", "lightBlue", "lightRed", "lightGreen", "lightPink", "lightPurple", "lightTeal", "lightLime", "lightYellow", "lightAmber", "lightOrange", "lightBrown", "lightGray", "darkBlue", "darkBlack"];
+export type LegacyThemeName = typeof LEGACY_THEME_NAMES[number];
+export type ThemeName = ThemePreference | LegacyThemeName;
+export declare const isValidThemeName: (name: string) => name is ThemeName;
+/** Missing/unknown preferences follow the OS. Existing choices keep their mode. */
+export declare const normalizeThemePreference: (name?: string | null) => ThemePreference;
+export declare const resolveThemePreference: (preference: ThemePreference, systemDark?: boolean) => ResolvedTheme;
+/** Emits immediately; caller must unsubscribe on unmount/preference change.
+ * Does not persist or call an API when the OS appearance changes.
+ */
+export declare const observeThemePreference: (preference: ThemePreference, listener: (mode: ResolvedTheme) => void) => (() => void);

package/dist/types/theme/themePreference.test.d.ts

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

package/dist/types/theme/themeProvider.d.ts

@@ -57,18 +57,35 @@ declare module '@mui/material/styles' {
         name?: string;
     }
 }
+export declare const lightTheme: Theme;
+export declare const darkTheme: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightBlueIndigo: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightBlue: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightRed: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightGreen: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightPink: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightPurple: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightTeal: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightLime: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightYellow: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightAmber: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightOrange: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightBrown: Theme;
+/** @deprecated Use lightTheme. */
 export declare const lightGray: Theme;
+/** @deprecated Use darkTheme. */
 export declare const darkBlue: Theme;
+/** @deprecated Use darkTheme. */
 export declare const darkBlack: Theme;

package/dist/types/theme/themeProvider.test.d.ts

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

package/dist/types/theme/themeSlice.d.ts

@@ -1,4 +1,7 @@
 import { Theme } from '@mui/material';
+import { ThemeName, ThemePreference, ResolvedTheme } from './themePreference';
+export { isValidThemeName } from './themePreference';
+export type { ThemeName } from './themePreference';
 /**
  * Forma mínima del store que necesita este slice: la app que lo use tiene que
  * tener `Theme` y `User.user.uid`.
@@ -13,11 +16,10 @@ export interface ThemeRootState {
     };
     Theme: ThemeState;
 }
-/** Nombres de tema disponibles. */
-export type ThemeName = 'lightBlueIndigo' | 'darkBlack' | 'darkBlue' | 'lightAmber' | 'lightBlue' | 'lightBrown' | 'lightGray' | 'lightGreen' | 'lightLime' | 'lightOrange' | 'lightPink' | 'lightPurple' | 'lightRed' | 'lightTeal' | 'lightYellow';
 /** Estado del slice. */
 export interface ThemeState {
     themeSelected: Theme;
+    preference: ThemePreference;
     darkMode: boolean;
     toggleStatus: 'idle' | 'toggled';
 }
@@ -34,9 +36,8 @@ export declare const updateTheme: import("@reduxjs/toolkit").AsyncThunk<{
     fulfilledMeta?: unknown;
     rejectedMeta?: unknown;
 }>;
-/** Valida que el string sea un `ThemeName`. */
-export declare const isValidThemeName: (theme: string) => theme is ThemeName;
-export declare const toggleTheme: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<ThemeName, "Theme/toggleTheme">, toggleModeTheme: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"Theme/toggleModeTheme">;
+export declare const selectThemePreference: (state: ThemeRootState) => ThemePreference;
+export declare const toggleTheme: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<ThemeName, "Theme/toggleTheme">, toggleModeTheme: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"Theme/toggleModeTheme">, systemThemeChanged: import("@reduxjs/toolkit").ActionCreatorWithOptionalPayload<ResolvedTheme, "Theme/systemThemeChanged">;
 export declare const selectThemeToggleStatus: (state: ThemeRootState) => "idle" | "toggled";
 export declare const selectTheme: (state: ThemeRootState) => Theme;
 export declare const selectDarkTheme: (state: ThemeRootState) => boolean;