@json_1013/core-geografico-isa-mapa 0.1.0-poc

package/dist-lib/tipos/features/maps/components/ArbolCapas.d.ts

@@ -0,0 +1,20 @@
+import type { EstadosCapas, GrupoServicios, ItemLeyenda } from "../types";
+/** Props de `ArbolCapas`. */
+interface ArbolCapasProps {
+    grupos: readonly GrupoServicios[];
+    estados: EstadosCapas;
+    escala?: number;
+    onCambioServicio: (nombre: string, visible: boolean) => void;
+    onCambioOpacidad: (nombre: string, opacidad: number) => void;
+    onCambioOpacidadCapa?: (nombre: string, identificador: string, opacidad: number) => void;
+    onCambioCapa: (nombre: string, identificador: string, visible: boolean) => void;
+    /** Zoom a la extensión de una subcapa, acercando hasta su rango de escala. */
+    onZoomCapa?: (nombre: string, identificador: string, minScale?: number, maxScale?: number) => void;
+    /** Descarga en GeoJSON la subcapa en la extensión visible (solo dentro de escala). */
+    onDescargarCapa?: (nombre: string, identificador: string, etiqueta: string) => Promise<void>;
+    /** Leyenda de una subcapa activa; `etiqueta` es el texto de respaldo de cada ítem. */
+    onObtenerLeyenda?: (nombre: string, identificador: string, etiqueta: string) => Promise<ItemLeyenda[]>;
+}
+/** Árbol de grupos → servicios (check) → capas (ojitos) y opacidad. */
+export declare function ArbolCapas({ grupos, estados, escala, onCambioServicio, onCambioOpacidad, onCambioOpacidadCapa, onCambioCapa, onZoomCapa, onDescargarCapa, onObtenerLeyenda, }: ArbolCapasProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/BarraHerramientas.d.ts

@@ -0,0 +1,17 @@
+import type { HerramientaMapa } from "../types";
+/** Props de `BarraHerramientas`. */
+interface BarraHerramientasProps {
+    herramientas: readonly HerramientaMapa[];
+    codigoActivo?: string;
+    codigoPadreActivo?: string;
+    /** Códigos que deben verse seleccionados aunque no tengan estado activo propio. */
+    codigosResaltados?: readonly string[];
+    onAlternar: (codigo: string) => void;
+    onAlternarSubHerramienta: (subCodigo: string) => void;
+    soportada: (codigo: string) => boolean;
+    /** Selecciona la agrupación de herramientas a mostrar. Por defecto, `"escritorio"`. */
+    variante?: "escritorio" | "responsive";
+}
+/** Barra flotante de herramientas del mapa, con soporte de submenús por grupo. */
+export declare function BarraHerramientas({ herramientas, codigoActivo, codigoPadreActivo, codigosResaltados, onAlternar, onAlternarSubHerramienta, soportada, variante, }: BarraHerramientasProps): import("react").JSX.Element | null;
+export {};

package/dist-lib/tipos/features/maps/components/BotonTridimensional.d.ts

@@ -0,0 +1,10 @@
+import type { HerramientaMapa } from "../types";
+/** Props de `BotonTridimensional`. */
+interface BotonTridimensionalProps {
+    herramienta: HerramientaMapa;
+    activo: boolean;
+    onClick: () => void;
+}
+/** Botón que alterna entre la vista 2D y la vista 3D del mapa. */
+export declare function BotonTridimensional({ herramienta, activo, onClick, }: BotonTridimensionalProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/ComboBuscable.d.ts

@@ -0,0 +1,23 @@
+import type { OpcionSelector } from "./SelectorDesplegable";
+/** Props de `ComboBuscable`. */
+interface ComboBuscableProps {
+    valor: string;
+    opciones: readonly OpcionSelector[];
+    onCambiar: (valor: string) => void;
+    /** Nombre accesible del control (y del listado). */
+    etiqueta: string;
+    id?: string;
+    disabled?: boolean;
+    placeholder?: string;
+    /** Lista de opciones en vuelo: deshabilita el filtro y muestra un aviso. */
+    cargando?: boolean;
+    /** Acepta un texto que no calza ninguna opción (la lista puede venir truncada). */
+    permitirValorLibre?: boolean;
+    className?: string;
+}
+/**
+ * Combo buscable: como `SelectorDesplegable`, pero el disparador es un campo que
+ * filtra las opciones. Con `permitirValorLibre` acepta textos fuera de la lista.
+ */
+export declare function ComboBuscable({ valor, opciones, onCambiar, etiqueta, id, disabled, placeholder, cargando, permitirValorLibre, className, }: ComboBuscableProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/ControlesEscritorio.d.ts

@@ -0,0 +1,80 @@
+import type { Ref } from "react";
+import type Graphic from "@arcgis/core/Graphic";
+import type { CoordenadasPuntero } from "../hooks/useCoordenadasPuntero";
+import type { AplicacionInfo, CampoConsulta, CapaConsultable, EstadosCapas, FiltroConsulta, GrupoServicios, HerramientaMapa, ItemGaleriaMapas, ItemLeyenda, ResultadoConsultaCapa, ResultadosConsultaCapas, ValoresDistintosCampo, VistaMapa } from "../types";
+import { type ModalMedicionHandle } from "./ModalMedicion";
+/** Definiciones de medición requeridas por `ModalMedicion`. */
+interface DefinicionesMedicion {
+    distancia: HerramientaMapa;
+    area: HerramientaMapa;
+}
+/** Props de `ControlesEscritorio`. */
+interface ControlesEscritorioProps {
+    vista: VistaMapa;
+    /** Factor de escala de las modales de herramienta en pantallas grandes; `1` es el tamaño de diseño. */
+    escalaInterfaz: number;
+    herramientasBarra: readonly HerramientaMapa[];
+    codigoActivo?: string;
+    codigoPadreActivo?: string;
+    soportada: (codigo: string) => boolean;
+    onAlternar: (codigo: string) => void;
+    onAlternarSubHerramienta: (subCodigo: string) => void;
+    coordenadasPuntero: CoordenadasPuntero | null;
+    panelCapasAbierto: boolean;
+    onCerrarPanelCapas: () => void;
+    gruposResueltos: readonly GrupoServicios[];
+    estados: EstadosCapas;
+    escala?: number;
+    onCambioServicio: (nombre: string, visible: boolean) => void;
+    onCambioOpacidad: (nombre: string, opacidad: number) => void;
+    onCambioOpacidadCapa: (nombre: string, identificador: string, opacidad: number) => void;
+    onCambioCapa: (nombre: string, identificador: string, visible: boolean) => void;
+    onZoomCapa: (nombre: string, identificador: string, minScale?: number, maxScale?: number) => void;
+    onDescargarCapa: (nombre: string, identificador: string, etiqueta: string) => Promise<void>;
+    onObtenerLeyenda: (nombre: string, identificador: string, etiqueta: string) => Promise<ItemLeyenda[]>;
+    coordenadasSeleccion: CoordenadasPuntero | null;
+    onCerrarCoordenadas: () => void;
+    modalProyeccionAbierta: boolean;
+    onCerrarProyeccion: () => void;
+    modalConsultaAbierta: boolean;
+    onCerrarConsulta: () => void;
+    capasConsultables: readonly CapaConsultable[];
+    onCamposDeCapa: (nombreServicio: string, identificador: string) => Promise<CampoConsulta[]>;
+    onValoresDistintos: (nombreServicio: string, identificador: string, campo: string) => Promise<ValoresDistintosCampo>;
+    onEjecutarConsulta: (nombreServicio: string, identificador: string, filtro: FiltroConsulta) => Promise<ResultadoConsultaCapa>;
+    onResultadoConsulta: (resultado: ResultadoConsultaCapa, capa: CapaConsultable) => void;
+    /** Resultados por capa consultada (una pestaña por capa, ej. Línea y Torre). */
+    resultadosConsulta: ResultadosConsultaCapas;
+    /** Filas marcadas (checkbox) de la tabla de resultados. */
+    seleccionadosConsulta: ReadonlySet<Graphic>;
+    onAlternarFilaResultado: (grafico: Graphic) => void;
+    onAlternarTodosResultado: () => void;
+    /** Acerca la vista a una fila ya marcada, sin desmarcarla (lupa por fila). */
+    onZoomFilaResultado: (grafico: Graphic) => void;
+    /** Cierra una pestaña de resultados sin afectar las demás. */
+    onQuitarPestanaResultado: (clave: string) => void;
+    /** Cambia cuál pestaña de resultados se ve. */
+    onCambiarPestanaResultado: (clave: string) => void;
+    modalMedicionAbierta: boolean;
+    medicionDefs: DefinicionesMedicion | null;
+    tridimensional: boolean;
+    onCerrarMedicion: () => void;
+    /** Ref imperativa para que la acción "clear" limpie las mediciones de la modal. */
+    medicionRef?: Ref<ModalMedicionHandle>;
+    herramientaMetadata?: HerramientaMapa;
+    panelMetadataAbierto: boolean;
+    onAlternarMetadata: () => void;
+    onCerrarMetadata: () => void;
+    aplicacion: AplicacionInfo;
+    herramientaBaseMap?: HerramientaMapa;
+    galeria: readonly ItemGaleriaMapas[];
+    basemapActual: string;
+    onSeleccionarBasemap: (codigo: string) => void;
+    panelBaseMapAbierto: boolean;
+    onAlternarPanelBaseMap: () => void;
+    herramientaTridimensional?: HerramientaMapa;
+    onAlternarTridimensional: () => void;
+}
+/** Controles del visor en escritorio: barra inferior derecha, mapa base/metadatos/3D y modales. */
+export declare function ControlesEscritorio({ vista, escalaInterfaz, herramientasBarra, codigoActivo, codigoPadreActivo, soportada, onAlternar, onAlternarSubHerramienta, coordenadasPuntero, panelCapasAbierto, onCerrarPanelCapas, gruposResueltos, estados, escala, onCambioServicio, onCambioOpacidad, onCambioOpacidadCapa, onCambioCapa, onZoomCapa, onDescargarCapa, onObtenerLeyenda, coordenadasSeleccion, onCerrarCoordenadas, modalProyeccionAbierta, onCerrarProyeccion, modalConsultaAbierta, onCerrarConsulta, capasConsultables, onCamposDeCapa, onValoresDistintos, onEjecutarConsulta, onResultadoConsulta, resultadosConsulta, seleccionadosConsulta, onAlternarFilaResultado, onAlternarTodosResultado, onZoomFilaResultado, onQuitarPestanaResultado, onCambiarPestanaResultado, modalMedicionAbierta, medicionDefs, tridimensional, onCerrarMedicion, medicionRef, herramientaMetadata, panelMetadataAbierto, onAlternarMetadata, onCerrarMetadata, aplicacion, herramientaBaseMap, galeria, basemapActual, onSeleccionarBasemap, panelBaseMapAbierto, onAlternarPanelBaseMap, herramientaTridimensional, onAlternarTridimensional, }: ControlesEscritorioProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/ControlesResponsive.d.ts

@@ -0,0 +1,37 @@
+import type { EstadosCapas, GrupoServicios, HerramientaMapa, ItemGaleriaMapas, ItemLeyenda } from "../types";
+/** Props de `ControlesResponsive`. */
+interface ControlesResponsiveProps {
+    /** Alto (px) del contenedor del mapa: define los anclajes de la hoja inferior. */
+    alturaContenedor: number;
+    herramientasBarra: readonly HerramientaMapa[];
+    codigoActivo?: string;
+    soportada: (codigo: string) => boolean;
+    onAlternar: (codigo: string) => void;
+    herramientaBaseMap?: HerramientaMapa;
+    galeria: readonly ItemGaleriaMapas[];
+    basemapActual: string;
+    onSeleccionarBasemap: (codigo: string) => void;
+    panelBaseMapAbierto: boolean;
+    onAlternarPanelBaseMap: () => void;
+    panelCapasAbierto: boolean;
+    onCerrarPanelCapas: () => void;
+    gruposResueltos: readonly GrupoServicios[];
+    estados: EstadosCapas;
+    escala?: number;
+    onCambioServicio: (nombre: string, visible: boolean) => void;
+    onCambioOpacidad: (nombre: string, opacidad: number) => void;
+    onCambioOpacidadCapa: (nombre: string, identificador: string, opacidad: number) => void;
+    onCambioCapa: (nombre: string, identificador: string, visible: boolean) => void;
+    onZoomCapa: (nombre: string, identificador: string, minScale?: number, maxScale?: number) => void;
+    onDescargarCapa: (nombre: string, identificador: string, etiqueta: string) => Promise<void>;
+    onObtenerLeyenda: (nombre: string, identificador: string, etiqueta: string) => Promise<ItemLeyenda[]>;
+    herramientaTridimensional?: HerramientaMapa;
+    tridimensional: boolean;
+    onAlternarTridimensional: () => void;
+}
+/**
+ * Controles del visor en responsive, agrupados abajo al centro. "Mapa base" y
+ * "Capas" comparten una hoja inferior (ver `usePanelesInferiores`).
+ */
+export declare function ControlesResponsive({ alturaContenedor, herramientasBarra, codigoActivo, soportada, onAlternar, herramientaBaseMap, galeria, basemapActual, onSeleccionarBasemap, panelBaseMapAbierto, onAlternarPanelBaseMap, panelCapasAbierto, onCerrarPanelCapas, gruposResueltos, estados, escala, onCambioServicio, onCambioOpacidad, onCambioOpacidadCapa, onCambioCapa, onZoomCapa, onDescargarCapa, onObtenerLeyenda, herramientaTridimensional, tridimensional, onAlternarTridimensional, }: ControlesResponsiveProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/LecturaCoordenadas.d.ts

@@ -0,0 +1,9 @@
+import type { CoordenadasPuntero } from "../hooks/useCoordenadasPuntero";
+/** Props de `LecturaCoordenadas`. */
+interface LecturaCoordenadasProps {
+    coordenadas: CoordenadasPuntero | null;
+    className?: string;
+}
+/** Muestra las coordenadas bajo el puntero en grados/minutos/segundos. */
+export declare function LecturaCoordenadas({ coordenadas, className, }: LecturaCoordenadasProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/LeyendaCapa.d.ts

@@ -0,0 +1,5 @@
+import type { ItemLeyenda } from "../types";
+/** Leyenda de una capa: un ítem va inline; varios, en lista colapsable. Nada mientras carga. */
+export declare function LeyendaCapa({ cargar }: {
+    cargar: () => Promise<ItemLeyenda[]>;
+}): import("react").JSX.Element | null;

package/dist-lib/tipos/features/maps/components/ListaMapasBase.d.ts

@@ -0,0 +1,11 @@
+import type { ItemGaleriaMapas } from "../types";
+/** Props de `ListaMapasBase`. */
+interface ListaMapasBaseProps {
+    items: readonly ItemGaleriaMapas[];
+    valorActual: string;
+    onSeleccionar: (codigo: string) => void;
+    className?: string;
+}
+/** Lista de mapas base con miniatura, para el desplegable de escritorio y la hoja responsive. */
+export declare function ListaMapasBase({ items, valorActual, onSeleccionar, className, }: ListaMapasBaseProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/ListadoOpciones.d.ts

@@ -0,0 +1,25 @@
+import type { CajaPanel } from "../hooks/useListbox";
+import type { OpcionSelector } from "./SelectorDesplegable";
+/** Props de `ListadoOpciones`: el panel en portal que comparten los selectores. */
+interface ListadoOpcionesProps {
+    idListado: string;
+    /** Nombre accesible del listado. */
+    etiqueta: string;
+    caja: CajaPanel | null;
+    panelRef: React.RefObject<HTMLUListElement | null>;
+    /** Opciones a pintar (ya filtradas, si el selector filtra). */
+    opciones: readonly OpcionSelector[];
+    /** Valor elegido, para marcarlo con `aria-selected`. */
+    valor: string;
+    indiceActivo: number;
+    onElegir: (opcion: OpcionSelector) => void;
+    onMarcarActiva: (indice: number) => void;
+    /** Aviso (cargando o "sin coincidencias") que reemplaza a las opciones. */
+    aviso?: string;
+}
+/**
+ * Listado `role="listbox"` en un portal con posición fija. Es la parte visual que
+ * comparten `SelectorDesplegable` y `ComboBuscable`.
+ */
+export declare function ListadoOpciones({ idListado, etiqueta, caja, panelRef, opciones, valor, indiceActivo, onElegir, onMarcarActiva, aviso, }: ListadoOpcionesProps): import("react").ReactPortal | null;
+export {};

package/dist-lib/tipos/features/maps/components/MapaView.d.ts

@@ -0,0 +1,19 @@
+import type { AplicacionInfo, CodigoHerramienta, DefinicionMapa, GrupoServicios, ItemGaleriaMapas, ServicioGis, VistaMapa } from "../types";
+/** Props de `MapaView`. */
+interface MapaViewProps {
+    definicion: DefinicionMapa;
+    /** Datos de la aplicación (`configuracion.aplicacion`) para el panel de metadatos. */
+    aplicacion: AplicacionInfo;
+    galeria: readonly ItemGaleriaMapas[];
+    servicios: readonly ServicioGis[];
+    /** Servicios agrupados tal como los publica el backend (para el panel de capas). */
+    grupos: readonly GrupoServicios[];
+    /** Herramientas a ocultar. Ocultar una medición oculta también `"measurement-tools"`. */
+    herramientasDeshabilitadas?: readonly CodigoHerramienta[];
+    /** Se llama con la vista de ArcGIS cada vez que queda lista (también al alternar 2D/3D). */
+    onListo?: (vista: VistaMapa) => void;
+    className?: string;
+}
+/** Visor principal del mapa: monta la vista de ArcGIS y sus controles. */
+export declare function MapaView({ definicion, aplicacion, galeria, servicios, grupos, herramientasDeshabilitadas, onListo, className, }: MapaViewProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/MenuOpcionesServicio.d.ts

@@ -0,0 +1,13 @@
+/** Props de `MenuOpcionesServicio`. */
+interface MenuOpcionesServicioProps {
+    /** Nombre del servicio; se usa en las etiquetas accesibles. */
+    nombre: string;
+    /** Metadato del servicio; se traduce a texto plano en "Fuente de información". */
+    metadatos: Record<string, unknown>;
+}
+/**
+ * Botón de opciones de un servicio: despliega un menú flotante con sus acciones.
+ * Se cierra al elegir, con `Escape` o al clic fuera.
+ */
+export declare function MenuOpcionesServicio({ nombre, metadatos, }: MenuOpcionesServicioProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/MiniaturaBasemap.d.ts

@@ -0,0 +1,9 @@
+/** Props de `MiniaturaBasemap`. */
+interface MiniaturaBasemapProps {
+    codigo: string;
+    seleccionado: boolean;
+    className: string;
+}
+/** Miniatura de un mapa base; si no hay imagen para el código, un degradado. */
+export declare function MiniaturaBasemap({ codigo, seleccionado, className, }: MiniaturaBasemapProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/ModalAlerta.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from "react";
+/** Props de `ModalAlerta`. */
+interface ModalAlertaProps {
+    /** Título breve de la cabecera. */
+    titulo: string;
+    /** Cuerpo del aviso (acepta ReactNode para resaltar parte del texto). */
+    mensaje: ReactNode;
+    /** Texto del botón principal. Por defecto "Entendido", o "Sí" en modo confirmación. */
+    textoBoton?: string;
+    /** Solo en modo confirmación: texto del botón secundario. Por defecto "No". */
+    textoCancelar?: string;
+    /** Con manejador, el aviso es de confirmación (dos botones); sin él, informativo. */
+    alConfirmar?: () => void;
+    /** Se invoca al cerrar/declinar (botón secundario, aspa, Escape o clic en el fondo). */
+    alCerrar: () => void;
+}
+/**
+ * Aviso centrado en portal, informativo ("Entendido") o de confirmación ("No"/"Sí").
+ * Cerrar por cualquier vía cuenta como "No".
+ */
+export declare function ModalAlerta({ titulo, mensaje, textoBoton, textoCancelar, alConfirmar, alCerrar, }: ModalAlertaProps): import("react").ReactPortal;
+export {};

package/dist-lib/tipos/features/maps/components/ModalConsulta.d.ts

@@ -0,0 +1,34 @@
+import type Graphic from "@arcgis/core/Graphic";
+import type { CampoConsulta, CapaConsultable, FiltroConsulta, ResultadoConsultaCapa, ResultadosConsultaCapas, ValoresDistintosCampo } from "../types";
+/** Props de `ModalConsulta`. */
+interface ModalConsultaProps {
+    /** Factor de escala de esta modal en pantallas grandes; `1` es el tamaño de diseño. */
+    escalaInterfaz: number;
+    /** Capas activas (visibles) sobre las que se puede consultar. */
+    capasConsultables: readonly CapaConsultable[];
+    onCamposDeCapa: (nombreServicio: string, identificador: string) => Promise<CampoConsulta[]>;
+    onValoresDistintos: (nombreServicio: string, identificador: string, campo: string) => Promise<ValoresDistintosCampo>;
+    onEjecutarConsulta: (nombreServicio: string, identificador: string, filtro: FiltroConsulta) => Promise<ResultadoConsultaCapa>;
+    /** Cierra la modal (no limpia los resultados ya mostrados). */
+    onCerrar: () => void;
+    /** Se llama cuando una consulta termina con éxito. */
+    onResultado: (resultado: ResultadoConsultaCapa, capa: CapaConsultable) => void;
+    /** Resultados por capa consultada (una pestaña por capa, ej. Línea y Torre a la vez). */
+    resultadosConsulta: ResultadosConsultaCapas;
+    /** Filas marcadas (checkbox) de la tabla de resultados. */
+    seleccionadosResultado: ReadonlySet<Graphic>;
+    onAlternarFilaResultado: (grafico: Graphic) => void;
+    onAlternarTodosResultado: () => void;
+    /** Acerca la vista a una fila ya marcada, sin desmarcarla (lupa por fila). */
+    onZoomFilaResultado: (grafico: Graphic) => void;
+    /** Cierra una pestaña de resultados sin afectar las demás. */
+    onQuitarPestanaResultado: (clave: string) => void;
+    /** Cambia cuál pestaña de resultados se ve. */
+    onCambiarPestanaResultado: (clave: string) => void;
+}
+/**
+ * Modal arrastrable de "Consultar": arma un filtro por atributos sobre una capa
+ * activa y emite `onResultado`; no dibuja resultados.
+ */
+export declare function ModalConsulta({ escalaInterfaz, capasConsultables, onCamposDeCapa, onValoresDistintos, onEjecutarConsulta, onCerrar, onResultado, resultadosConsulta, seleccionadosResultado, onAlternarFilaResultado, onAlternarTodosResultado, onZoomFilaResultado, onQuitarPestanaResultado, onCambiarPestanaResultado, }: ModalConsultaProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/ModalCoordenadas.d.ts

@@ -0,0 +1,10 @@
+import type { CoordenadasPuntero } from "../hooks/useCoordenadasPuntero";
+/** Props de `ModalCoordenadas`. */
+interface ModalCoordenadasProps {
+    coordenadas: CoordenadasPuntero;
+    onCerrar: () => void;
+    className?: string;
+}
+/** Panel flotante con las coordenadas WGS84 del punto marcado; al cerrarlo desactiva la herramienta. */
+export declare function ModalCoordenadas({ coordenadas, onCerrar, className, }: ModalCoordenadasProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/ModalMedicion.d.ts

@@ -0,0 +1,25 @@
+import type { HerramientaMapa, VistaMapa } from "../types";
+/** Props de `ModalMedicion`. */
+interface ModalMedicionProps {
+    /** Vista 2D sobre la que se montan los widgets de medición. */
+    vista: VistaMapa;
+    /** Definición de la sub-herramienta de distancia (nombre e ícono). */
+    distancia: HerramientaMapa;
+    /** Definición de la sub-herramienta de área (nombre e ícono). */
+    area: HerramientaMapa;
+    /** Cierra la modal (único modo de cierre). */
+    onCerrar: () => void;
+    /** Factor de escala de esta modal en pantallas grandes; `1` es el tamaño de diseño. */
+    escalaInterfaz: number;
+}
+/** Métodos que `MapaView` invoca sobre la modal desde fuera (acción "clear"). */
+export interface ModalMedicionHandle {
+    /** Deselecciona la sub-herramienta activa y destruye ambos widgets. */
+    limpiar: () => void;
+}
+/**
+ * Modal arrastrable de medición, sin sub-herramienta activa al abrir. Unidad y
+ * resultado se alimentan del `viewModel` de ArcGIS. Solo se cierra con la «X».
+ */
+export declare const ModalMedicion: import("react").ForwardRefExoticComponent<ModalMedicionProps & import("react").RefAttributes<ModalMedicionHandle>>;
+export {};

package/dist-lib/tipos/features/maps/components/ModalProyeccion.d.ts

@@ -0,0 +1,16 @@
+import type { VistaMapa } from "../types";
+/** Props de `ModalProyeccion`. */
+interface ModalProyeccionProps {
+    /** Vista sobre la que se marca el punto de coordenadas escrito. */
+    vista: VistaMapa;
+    /** Cierra la modal (y con ella desactiva la herramienta). */
+    onCerrar: () => void;
+    /** Factor de escala de esta modal en pantallas grandes; `1` es el tamaño de diseño. */
+    escalaInterfaz: number;
+}
+/**
+ * Modal arrastrable para convertir coordenadas entre sistemas de referencia en
+ * el cliente (`projectOperator`). Solo se cierra con la «X».
+ */
+export declare function ModalProyeccion({ vista, onCerrar, escalaInterfaz }: ModalProyeccionProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/PanelCapas.d.ts

@@ -0,0 +1,18 @@
+import type { EstadosCapas, GrupoServicios, ItemLeyenda } from "../types";
+/** Props de `PanelCapas`. */
+interface PanelCapasProps {
+    grupos: readonly GrupoServicios[];
+    estados: EstadosCapas;
+    escala?: number;
+    onCambioServicio: (nombre: string, visible: boolean) => void;
+    onCambioOpacidad: (nombre: string, opacidad: number) => void;
+    onCambioOpacidadCapa?: (nombre: string, identificador: string, opacidad: number) => void;
+    onCambioCapa: (nombre: string, identificador: string, visible: boolean) => void;
+    onZoomCapa?: (nombre: string, identificador: string, minScale?: number, maxScale?: number) => void;
+    onDescargarCapa?: (nombre: string, identificador: string, etiqueta: string) => Promise<void>;
+    onObtenerLeyenda?: (nombre: string, identificador: string, etiqueta: string) => Promise<ItemLeyenda[]>;
+    onCerrar: () => void;
+}
+/** Panel de capas de escritorio (cabecera + `ArbolCapas`); solo se cierra con la «X». */
+export declare function PanelCapas({ onCerrar, ...propsArbol }: PanelCapasProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/PanelInferior.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from "react";
+/** Props de `PanelInferior`. */
+interface PanelInferiorProps {
+    titulo: string;
+    onCerrar: () => void;
+    /** Alto (px) del contenedor del mapa: define los puntos de anclaje de la hoja. */
+    alturaContenedor: number;
+    children: ReactNode;
+}
+/** Hoja inferior responsive con tres alturas; se arrastra desde el asa y se cierra con la «X». */
+export declare function PanelInferior({ titulo, onCerrar, alturaContenedor, children, }: PanelInferiorProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/PanelMetadata.d.ts

@@ -0,0 +1,10 @@
+import type { AplicacionInfo } from "../types";
+/** Props de `PanelMetadata`. */
+interface PanelMetadataProps {
+    /** Información de la aplicación tal como llega en `configuracion.aplicacion`. */
+    aplicacion: AplicacionInfo;
+    onCerrar: () => void;
+}
+/** Panel con los pares de `aplicacion.metadatos` del contrato (herramienta `metadata`). */
+export declare function PanelMetadata({ aplicacion, onCerrar }: PanelMetadataProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/SelectorBasemap.d.ts

@@ -0,0 +1,17 @@
+import type { ItemGaleriaMapas } from "../types";
+/** Props de `SelectorBasemap`. */
+interface SelectorBasemapProps {
+    items: readonly ItemGaleriaMapas[];
+    valor: string;
+    onSeleccionar: (codigo: string) => void;
+    /** Nombre de la herramienta: nombre accesible del botón y título del tooltip. */
+    titulo: string;
+    /** Descripción de la herramienta para el tooltip. */
+    descripcion?: string;
+    /** Controla el desplegable desde el padre; si se omite, maneja su propio estado. */
+    abierto?: boolean;
+    onToggle?: () => void;
+}
+/** Selector del mapa base a partir de la galería del contrato. */
+export declare function SelectorBasemap({ items, valor, onSeleccionar, titulo, descripcion, abierto: abiertoControlado, onToggle, }: SelectorBasemapProps): import("react").JSX.Element | null;
+export {};

package/dist-lib/tipos/features/maps/components/SelectorDesplegable.d.ts

@@ -0,0 +1,33 @@
+/** Una opción del selector. */
+export interface OpcionSelector {
+    /** Valor que se entrega en `onCambiar` (siempre string). */
+    readonly valor: string;
+    /** Texto visible de la opción. */
+    readonly etiqueta: string;
+}
+/** Props de `SelectorDesplegable`. */
+interface SelectorDesplegableProps {
+    /** Valor seleccionado (string; convierte números en el llamador). */
+    valor: string;
+    opciones: readonly OpcionSelector[];
+    onCambiar: (valor: string) => void;
+    /** Nombre accesible del control (y del listado). */
+    etiqueta: string;
+    /** `id` del disparador, para asociarlo a un `<label htmlFor>`. */
+    id?: string;
+    disabled?: boolean;
+    /** Texto cuando no hay ninguna opción seleccionada. */
+    placeholder?: string;
+    /** Añade el `placeholder` como opción `""` para volver a "sin elegir". */
+    permitirVacio?: boolean;
+    /** Clases extra para el botón disparador. */
+    className?: string;
+    /** No trunca la opción elegida, para que un contenedor sin ancho fijo la muestre completa. */
+    sinTruncar?: boolean;
+}
+/**
+ * Selector desplegable propio (reemplaza al `<select>` nativo), con listado en
+ * portal, teclado y cierre al clic fuera. Comparte mecánica con `ComboBuscable`.
+ */
+export declare function SelectorDesplegable({ valor, opciones, onCambiar, etiqueta, id, disabled, placeholder, permitirVacio, className, sinTruncar, }: SelectorDesplegableProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/TablaResultadosConsulta.d.ts

@@ -0,0 +1,29 @@
+import type Graphic from "@arcgis/core/Graphic";
+import type { ReactNode } from "react";
+import type { ResultadoConsultaCapa } from "../types";
+/** Props de `TablaResultadosConsulta`. */
+interface TablaResultadosConsultaProps {
+    resultado: ResultadoConsultaCapa;
+    /** Título de la capa consultada, para la cabecera. */
+    tituloCapa: string;
+    /** Filas marcadas (checkbox): se resaltan juntas en el mapa. */
+    seleccionados: ReadonlySet<Graphic>;
+    /** Marca/desmarca una fila. */
+    onAlternarFila: (grafico: Graphic) => void;
+    /** Marca todas las filas si no lo están todas, o las desmarca si ya lo están. */
+    onAlternarTodos: () => void;
+    /** Acerca la vista a una fila ya marcada, sin desmarcarla (lupa por fila; solo aparece en filas marcadas). */
+    onZoomFila: (grafico: Graphic) => void;
+    /** Vuelve al formulario de la consulta (la modal se queda abierta). */
+    onRegresar: () => void;
+    /** Cierra la modal por completo. */
+    onCerrar: () => void;
+    /** Fila de pestañas (una por capa consultada, ver `ModalConsulta`), debajo de la cabecera. */
+    pestanas?: ReactNode;
+}
+/**
+ * Resultados de "Consultar" dentro de la misma modal: tabla con columnas por campo,
+ * selección por checkbox (resalta en el mapa) y paginación.
+ */
+export declare function TablaResultadosConsulta({ resultado, tituloCapa, seleccionados, onAlternarFila, onAlternarTodos, onZoomFila, onRegresar, onCerrar, pestanas, }: TablaResultadosConsultaProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/Tooltip.d.ts

@@ -0,0 +1,32 @@
+import type { ReactElement } from "react";
+/** Lado del disparador donde se despliega el tooltip. */
+type Lado = "arriba" | "abajo";
+/** Alineación horizontal del tooltip respecto al disparador. */
+type Alineacion = "inicio" | "centro" | "fin";
+/** Props de `Tooltip`. */
+interface TooltipProps {
+    /** Primera línea, en negrita (normalmente el nombre de la herramienta). */
+    titulo: string;
+    /** Segunda línea, tenue y opcional (la descripción). */
+    descripcion?: string;
+    /** Lado donde aparece. Por defecto `"arriba"`. */
+    lado?: Lado;
+    /** Alineación horizontal. Usa `"fin"`/`"inicio"` cerca de un borde. Por defecto `"centro"`. */
+    alineacion?: Alineacion;
+    /** Milisegundos de espera antes de mostrarse al pasar el puntero. */
+    retardo?: number;
+    /** Si es `true` no muestra nada (p. ej. mientras el disparador abre un panel). */
+    deshabilitado?: boolean;
+    /** Único hijo: el elemento que dispara el tooltip (un botón, un enlace…). */
+    children: ReactElement<{
+        "aria-describedby"?: string;
+    }>;
+    /** Clases para el `span` envolvente. */
+    className?: string;
+}
+/**
+ * Tooltip accesible en `document.body` (no lo recorta ningún `overflow`). Aparece
+ * con hover o foco y se oculta al salir o con `Escape`.
+ */
+export declare function Tooltip({ titulo, descripcion, lado, alineacion, retardo, deshabilitado, children, className, }: TooltipProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/VisorMapa.d.ts

@@ -0,0 +1,18 @@
+import { type CodigoHerramienta, type ModoMapa, type VistaMapa } from "../types";
+/** Props de `VisorMapa`. */
+interface VisorMapaProps {
+    /** Definición del backend que se muestra (`mapas[].nombre`). */
+    modo: ModoMapa;
+    herramientasDeshabilitadas?: readonly CodigoHerramienta[];
+    onListo?: (vista: VistaMapa) => void;
+    /** Se llama si el visor no puede mostrarse (token, backend o contrato sin mapa). */
+    onError?: (error: Error) => void;
+    /** Tamaño y posición del visor (también de sus estados de carga y error). */
+    className?: string;
+}
+/**
+ * Visor completo a partir de `ProveedorConfiguracion`: muestra el esqueleto
+ * mientras carga, el error (con reintento) si falla, o el `MapaView` del modo.
+ */
+export declare function VisorMapa({ modo, herramientasDeshabilitadas, onListo, onError, className, }: VisorMapaProps): import("react").JSX.Element;
+export {};

package/dist-lib/tipos/features/maps/components/VisorMapaSkeleton.d.ts

@@ -0,0 +1,4 @@
+/** Esqueleto del visor (mapa, barra y botones); paneles y modales tienen el suyo. */
+export declare function VisorMapaSkeleton({ className }: {
+    className?: string;
+}): import("react").JSX.Element;