@trii/components 2.0.103 → 2.0.104

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

@@ -0,0 +1,55 @@
+import { Component, ErrorInfo, ReactNode } from 'react';
+export interface PanelErrorBoundaryProps {
+    children: ReactNode;
+    /**
+     * Fallback custom ante un crash de render. Puede ser un nodo o una función
+     * que recibe el error y `resetErrorBoundary` (para reintentar).
+     */
+    fallback?: ReactNode | ((args: {
+        error: Error | null;
+        resetErrorBoundary: () => void;
+    }) => ReactNode);
+    /** Telemetría/logging del error (p.ej. enviar a un servicio externo). */
+    onError?: (error: Error, info: ErrorInfo) => void;
+    /**
+     * Claves que al cambiar resetean el boundary automáticamente
+     * (p.ej. el id de la ruta actual, para reintentar al navegar).
+     */
+    resetKeys?: ReadonlyArray<unknown>;
+    /** Overrides de textos del fallback por defecto. */
+    title?: string;
+    description?: string;
+    /** Idioma de los textos por defecto ('es' | 'en'). Opcional: ver useComponentsTranslation. */
+    language?: string;
+}
+interface PanelErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * Aísla fallos de RENDER por panel: si el contenido explota, el resto de la
+ * UI (hermanos, otros paneles, la navegación) sigue funcionando y el panel
+ * muestra un fallback con reintento.
+ *
+ * ```tsx
+ * <PanelErrorBoundary resetKeys={[conversationId]}>
+ *   <ContactInfoPanel />
+ * </PanelErrorBoundary>
+ * <PanelErrorBoundary>
+ *   <MessagesPanel />
+ * </PanelErrorBoundary>
+ * ```
+ *
+ * NOTA: los boundaries NO capturan errores de fetching (para eso está
+ * `<AsyncContent>`), ni de event handlers, ni de código asíncrono.
+ * Guía completa: docs/ASYNC_STATE.md
+ */
+declare class PanelErrorBoundary extends Component<PanelErrorBoundaryProps, PanelErrorBoundaryState> {
+    state: PanelErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): PanelErrorBoundaryState;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    componentDidUpdate(prevProps: PanelErrorBoundaryProps): void;
+    reset: () => void;
+    render(): ReactNode;
+}
+export default PanelErrorBoundary;

package/dist/types/components/PanelErrorBoundary/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './PanelErrorBoundary';
+export type { PanelErrorBoundaryProps } from './PanelErrorBoundary';

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

@@ -4,5 +4,13 @@ export type { EditContactModalProps, EditContactMode } from './EditContactModal'
 export { default as EventsDialog } from './EventsDialog';
 export type { EventsDialogProps, EventData, TaskData } from './EventsDialog';
 export type { ModalMode, ItemType, Calendar, Contact, Notification } from './EventsDialog/types';
+export { default as AsyncContent } from './AsyncContent';
+export type { AsyncContentProps } from './AsyncContent';
+export { default as EmptyState } from './EmptyState';
+export type { EmptyStateProps } from './EmptyState';
+export { default as ErrorState } from './ErrorState';
+export type { ErrorStateProps } from './ErrorState';
+export { default as PanelErrorBoundary } from './PanelErrorBoundary';
+export type { PanelErrorBoundaryProps } from './PanelErrorBoundary';
 export { default as ContactSidebar } from './ContactSidebar';
 export type { ContactSidebarProps, SidebarChatIntegration, StartConversationTarget, } from './ContactSidebar';

package/dist/types/i18n/config.d.ts

@@ -1,2 +1,8 @@
 declare const i18nInstance: import("i18next").i18n;
+/**
+ * Normaliza lo que venga del anfitrión ('ES', 'En', 'es-AR', ...) a un idioma
+ * soportado por el paquete. El default es 'en' porque es el `fallbackLng` de
+ * esta instancia.
+ */
+export declare function normalizeLanguage(language?: string): 'en' | 'es';
 export default i18nInstance;

package/dist/types/i18n/useComponentsTranslation.d.ts

@@ -0,0 +1,17 @@
+import type { TFunction } from 'i18next';
+/**
+ * `t` atado a la instancia del paquete, SIN montar un `I18nextProvider`.
+ *
+ * Es la diferencia con el patrón de EditContactModal/ContactSidebar: esos
+ * componentes son un árbol cerrado y pueden pisar el context. Las primitivas
+ * de estado asíncrono (`AsyncContent`, `PanelErrorBoundary`) renderizan
+ * children DEL ANFITRIÓN; si montaran un provider, esos children resolverían
+ * sus claves contra la instancia del paquete y quedarían sin traducir.
+ * Pasando `{ i18n }` a `useTranslation`, solo los textos propios se atan.
+ *
+ * `language` es opcional: si el anfitrión ya sincroniza el idioma con
+ * `i18n.changeLanguage(...)` (exportado desde el índice del paquete), no hace
+ * falta pasarlo.
+ */
+export declare const useComponentsTranslation: (language?: string) => TFunction;
+export default useComponentsTranslation;

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
 export * from './components';
+export * from './asyncState';
 export { i18n } from './i18n';
 export * from './components/EventsDialog/theme';

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@trii/components",
-  "version": "2.0.103",
+  "version": "2.0.104",
   "description": "Trii components package",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "async-state"
   ],
   "scripts": {
     "dev": "npm-run-all --parallel dev:types dev:js",
@@ -15,7 +16,8 @@
     "build": "npm-run-all --serial build:types build:js",
     "build:types": "tsc --project tsconfig.build.json --emitDeclarationOnly",
     "build:js": "rollup -c",
-    "test": "jest --watchAll --verbose",
+    "test": "jest",
+    "test:watch": "jest --watchAll --verbose",
     "storybook": "storybook dev -p 6006",
     "build-storybook": "storybook build"
   },