pixelon 0.4.3 → 0.5.1

package/dist/components/molecules/chat/StructuredContent/components/LocationField/usePlaces.d.ts

@@ -11,6 +11,17 @@ export declare function usePlaceSuggestions(query: string, enabled: boolean): {
     } | null>;
     clear: () => void;
 };
+/** SPEC-131 T6 — la dirección formateada de Google repite tramos.
+ *
+ *  Medido: el `formattedAddress` de una calle de El Poblado vuelve como
+ *  «Cl 10 #43-20, El Poblado, Medellín, El Poblado, Medellín, Antioquia», porque el nombre del
+ *  lugar ya trae el barrio y la ciudad que luego añade la parte administrativa. Esa cadena se
+ *  guarda tal cual y aparece en el chat, en la ficha, en la tabla y en Conversaciones.
+ *
+ *  Se comparan los tramos sin tildes ni mayúsculas, que es donde estaba el otro caso visto
+ *  («Itagüí, Itagüi»), y se conserva el primero de cada uno: el orden de una dirección va de lo
+ *  particular a lo general, así que el que sobra siempre es el segundo. */
+export declare function limpiarDireccion(address: string): string;
 /**
  * Traduce una coordenada a una dirección legible.
  * Requiere Geocoding habilitado en la clave del navegador; si no lo está, devuelve null y el

package/dist/components/molecules/chat/StructuredContent/components/ReactiveCrud/ReactiveCrud.d.ts

@@ -14,6 +14,7 @@ export interface ReactiveCrudProps {
     onCreateClose?: () => void;
 }
 export declare function matchesVisibleWhen(a: RowActionDef, row: Record<string, unknown>): boolean;
+export declare function laQueTocaAhora(actions: RowActionDef[], row: Record<string, unknown>): RowActionDef | undefined;
 export declare function matchesDisabledWhen(a: RowActionDef, row: Record<string, unknown>): boolean;
 export declare function disabledReasonFor(a: RowActionDef, row: Record<string, unknown>): string | undefined;
 export declare function matchesDoneWhen(a: RowActionDef, row: Record<string, unknown>): boolean;

package/dist/components/molecules/chat/StructuredContent/components/ReactiveCrud/TranscriptSection.d.ts

@@ -0,0 +1,10 @@
+import type { ChatEventBus } from '../../../../../../core/eventBus/chatEventBus';
+import type { ReactiveCrudTranscript } from './types';
+export interface TranscriptSectionProps {
+    transcript: ReactiveCrudTranscript;
+    /** Valores del registro (fila + detalle): de ahí sale el id de la conversación. */
+    values: Record<string, unknown>;
+    eventBus?: ChatEventBus;
+}
+export declare function TranscriptSection({ transcript, values, eventBus }: TranscriptSectionProps): import("react/jsx-runtime").JSX.Element | null;
+export default TranscriptSection;

package/dist/components/molecules/chat/StructuredContent/components/ReactiveCrud/types.d.ts

@@ -114,8 +114,28 @@ export interface RowActionDef {
      * SPEC-113: es el respaldo — una condición con `reason` propio manda sobre este. */
     disabledReason?: string;
     /** SPEC-007: muestra un ✓ al final cuando `String(row[field])` está en `in` (ej. inspección ya
-     * registrada). Indicador de "hecho"; no bloquea reejecutar la acción. */
+     * registrada). Indicador de "hecho"; no bloquea reejecutar la acción.
+     *
+     * SPEC-129 T6: y es lo que decide qué queda escrito en una tarjeta ya gastada. Ahí solo se
+     * muestra lo que CUMPLE esta condición, porque es lo único que consta que se hizo: si el paso se
+     * cerró por otro camino —el barrido liberó la grúa, la operadora canceló— no hay nada que marcar
+     * y la tarjeta se queda con su frase, sin inventar un ✓. */
     doneWhen?: RowActionVisibleWhen;
+    /** SPEC-129 T6: cómo se llama esto una vez hecho. «Registrar inspección» → «Inspección
+     * registrada». En una tarjeta gastada el botón ya no es una oferta sino un acta, y un acta se
+     * escribe en pasado. Sin esto se cae a `label`, que sigue leyéndose bien con el ✓ al lado. */
+    doneLabel?: string;
+    /** SPEC-127 T4: cuándo esta acción es LA QUE TOCA AHORA. La que cumple va primera y destacada;
+     * el resto pasa a un segundo plano, disponible pero sin competir.
+     *
+     * No es lo mismo que `intent: 'primary'`, que describe la acción SIEMPRE («asignar es una acción
+     * importante»). Esto describe el MOMENTO: el mensaje que acompaña la tarjeta dice «Confírmalo
+     * para que la grúa salga», y entonces confirmar el pago es lo único que se le está pidiendo,
+     * aunque a su alrededor quepan siete cosas más.
+     *
+     * Si ninguna acción la cumple —o dos la cumplen— la tarjeta se comporta como antes: ninguna se
+     * destaca. Es preferible no señalar nada que señalar mal. */
+    ahoraToca?: RowActionVisibleWhen | RowActionVisibleWhen[];
     endpoint: EndpointRef;
     /** SPEC-002: varias llamadas en orden (ej. inspección = register-inspection foto + video). Si
      * se define, tiene prioridad sobre `endpoint`; todos comparten el mismo contexto del form. */
@@ -142,6 +162,23 @@ export interface ReactiveCrudDetail {
     /** Campo de la fila para el título del drawer (ej. 'service_number'). */
     titleField?: string;
 }
+export interface ReactiveCrudTranscript {
+    /** Campo de la fila con el id de la conversación (ej. 'origin_chat_id'). */
+    chatIdField: string;
+    /** Endpoint que devuelve `{ lines, total, from_user }`; recibe `{ [param]: <chatIdField> }`. */
+    get: EndpointRef;
+    /** Clave del cuerpo donde viaja el id (default 'chat_id'). */
+    param?: string;
+    /** Título de la sección. Ej: 'Conversación con el cliente'. */
+    title?: string;
+    /** Qué decir cuando la otra parte no ha escrito nada. Es una respuesta, no un hueco. */
+    silentText?: string;
+    /** Con qué nombre se pinta cada lado. */
+    labels?: {
+        user?: string;
+        assistant?: string;
+    };
+}
 export interface ReactiveCrudConfig {
     title?: string;
     /** Campo id de la fila (getRowKey de LumiCrud es obligatorio). */
@@ -154,6 +191,8 @@ export interface ReactiveCrudConfig {
     };
     /** Vista "Ver" con campos + galería de archivos. */
     detail?: ReactiveCrudDetail;
+    /** SPEC-128 T5 — conversación en solo lectura dentro de «Ver». Ver `ReactiveCrudTranscript`. */
+    transcript?: ReactiveCrudTranscript;
     rowActions?: RowActionDef[];
     filters?: FilterFieldConfig[];
     /** SPEC-014 — con qué filtros NACE la tabla. `filters` (arriba) dice qué se PUEDE filtrar; esto,

package/dist/components/molecules/chat/StructuredContent/components/ServicesMap/types.d.ts

@@ -15,6 +15,12 @@ export interface ServicesMapConfig {
     data: {
         list: EndpointRef;
     };
+    /** SPEC-131 T6 — qué pide el mapa cuando nadie acota nada.
+     *
+     *  Un mapa de seguimiento sin filtro devuelve el historial entero, y eso es lo que recibía quien
+     *  preguntaba «¿ya viene mi grúa?». El `filter` de la instancia PISA esto: cuando quien emite el
+     *  componente sí sabe qué acotar, manda él. */
+    defaultFilter?: Record<string, unknown>;
     mapping: ServicesMapMapping;
     /** Icono para todos los puntos cuando la fila no trae uno. */
     defaultIcon?: string;
@@ -48,6 +54,9 @@ export interface ServicesMapConfig {
         emptyText?: string;
         /** Aviso de las filas que no se pudieron ubicar. `{n}` se reemplaza por el número. */
         missingText?: string;
+        /** SPEC-127 — el mismo aviso cuando falta UNA sola. Sin esto se lee «1 servicios sin
+         *  ubicación registrada». Opcional: sin él se usa `missingText` para cualquier número. */
+        missingTextOne?: string;
         outsideText?: string;
         loadingText?: string;
     };

package/dist/components/molecules/chat/StructuredContent/components/index.d.ts

@@ -22,7 +22,6 @@ export { ServicesMap } from './ServicesMap/ServicesMap';
 export { ServicesMapChat } from './ServicesMap/ServicesMapChat';
 export type { ServicesMapConfig } from './ServicesMap/types';
 export { ServiceShortcuts } from './ServiceShortcuts/ServiceShortcuts';
-export { ServiceShortcutsChat } from './ServiceShortcuts/ServiceShortcutsChat';
 export { ChatNavigator } from './ChatNavigator/ChatNavigator';
 export { ChatNavigatorChat } from './ChatNavigator/ChatNavigatorChat';
 export type { ChatNavigatorConfig, ChatNavigatorItem, ChatNavigatorEndpoint } from './ChatNavigator/types';

package/dist/components/organisms/chat/Chat/hooks/useAutoScroll.d.ts

@@ -14,9 +14,16 @@ export interface UseAutoScrollOptions {
  * desconectarlo), dos envíos seguidos dejaban dos observadores compitiendo por mover el scroll,
  * y ninguno se limpiaba al desmontar.
  */
+/** SPEC-131 T3 — cuánto espacio hay que reservar al final para que el objetivo pueda subir arriba.
+ *
+ *  Lo que falte y nada más: si desde el objetivo hasta el final ya hay una pantalla de contenido,
+ *  no hace falta reservar nada. Reservar `clientHeight` a ciegas mete una pantalla de blanco al
+ *  final, y con el scroll topado eso deja la conversación entera por encima del borde superior. */
+export declare function reservaNecesaria(clientHeight: number, scrollHeight: number, targetTop: number): number;
 export declare const useAutoScroll: ({ messagesEndRef, messagesContainerRef, }: UseAutoScrollOptions) => {
     scrollToLastUserMessage: () => void;
     pinLastUserMessage: () => void;
     scrollToProactive: () => void;
-    scrollToBottom: () => void;
+    scrollToBottom: (suave?: boolean) => void;
+    aterrizarAlFinal: () => void;
 };

package/dist/components/templates/lumi/Crud/helpers/confirmSummary.d.ts

@@ -0,0 +1,13 @@
+export interface LineaResumen {
+    label: string;
+    valor: string;
+}
+interface CampoResumible {
+    name: string;
+    label?: string;
+    moleculeType?: string;
+    uiProps?: Record<string, unknown>;
+}
+/** Lo que se va a enviar, en el orden del formulario y sin los campos vacíos. */
+export declare function resumenParaConfirmar(campos: ReadonlyArray<CampoResumible>, datos: Record<string, unknown> | null | undefined): LineaResumen[];
+export {};

package/dist/components/templates/lumi/Crud/types.d.ts

@@ -51,6 +51,12 @@ export interface RenderFieldConfig {
     formatValue?: (value: unknown, row: unknown) => React.ReactNode;
     /** Función para parsear el valor antes de submit */
     parseValue?: (value: unknown) => unknown;
+    /** SPEC-131 T7 — cuántas columnas ocupa el campo en el formulario.
+     *
+     *  En un grid las celdas de una fila comparten altura, así que un campo que se despliega —el de
+     *  ubicación, que abre un mapa de verificación al elegir la dirección— deja a su hermana con
+     *  cientos de píxeles de blanco al lado. Los campos que crecen ocupan la fila entera. */
+    gridSpan?: number;
 }
 /**
  * Estado de paginación

package/dist/core/chat/ChatConfigContext.d.ts

@@ -19,6 +19,17 @@ export interface ChatConfig {
      * sola es preferible a un panel que se apaga por una conexión mala; el backend sigue rechazando
      * lo que no toca. */
     chatIsForeign?: boolean;
+    /** SPEC-128 — DE QUIÉN es esta conversación (el agente que la atiende).
+     *
+     * `chatIsForeign` dice «esto es de otro»; esto dice **de quién**. No es lo mismo, y hasta ahora
+     * solo existía lo primero: la operadora abría la conversación del solicitante y sus componentes
+     * se pintaban con el rol de ELLA, así que veía «Gestionar servicios» donde al cliente se le
+     * ofreció «Solicitar una grúa». Un mensaje del pasado no es una pregunta sobre quién mira: es el
+     * registro de lo que se dijo, y para pintarlo bien hay que saber a quién se le dijo.
+     *
+     * El host lo pone porque es quien sabe qué conversación está abriendo. Opcional: sin él, los
+     * componentes se comportan como antes (deciden por quien mira). */
+    chatAgentName?: string;
     /** IANA timezone identifier (e.g. "America/Bogota") */
     timezone: string;
     /** BCP 47 locale string (e.g. "es-CO") */
@@ -59,6 +70,20 @@ export interface ChatConfig {
      * Se tipa como bag genérico para no acoplar `core` a los tipos del componente.
      */
     resolveModuleConfig?: (module: string) => Record<string, unknown> | undefined;
+    /**
+     * SPEC-128: qué acciones toca mostrar en un MOMENTO del flujo. Lo provee el host, que es quien
+     * sabe qué significa «comprobante_subido» en su producto — aquí solo se sabe que hay momentos.
+     *
+     * Existe porque la tarjeta tenía que ADIVINAR en qué punto estaba, mirando campos de la fila y
+     * decidiendo con cuatro capas de condiciones cuáles de las quince acciones mostrar. Salían ocho
+     * botones para una decisión, y pasos futuros apagados ocupando tres cuartas partes. Y cuando dos
+     * momentos comparten los mismos datos, adivinar es imposible.
+     *
+     * Devolver `undefined` significa «no sé de ese momento»: entonces se decide por el estado, como
+     * siempre. Una lista VACÍA es distinto — es «en este momento no hay nada que hacer», y la tarjeta
+     * enseña solo «Ver».
+     */
+    resolveMomento?: (momento: string) => string[] | undefined;
     /**
      * SPEC-022: clave de Google Maps JavaScript API para el componente `map_view`. La provee el
      * HOST desde su entorno; no viaja en el payload del LLM (es configuración de despliegue, y el

package/dist/core/i18n/separadores.d.ts

@@ -0,0 +1,12 @@
+export interface Separadores {
+    /** El que agrupa los miles: `.` en es-CO, `,` en en-US. */
+    miles: string;
+    /** El que abre los decimales: `,` en es-CO, `.` en en-US. */
+    decimal: string;
+}
+/** Cómo se escriben los números en ese locale, según el propio navegador.
+ *
+ *  Se deriva en vez de tabularse: una tabla de locales se queda corta en cuanto alguien vende en
+ *  otro país, y `Intl` ya lo sabe. Si el locale no se entiende, se responde el formato de la casa
+ *  en vez de reventar — un número mal separado es feo; un formulario que no pinta, inservible. */
+export declare function separadoresDelLocale(locale?: string): Separadores;