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

package/dist-lib/tipos/features/maps/services/layers/gestor-capas.d.ts

@@ -0,0 +1,62 @@
+import type ArcGISMap from "@arcgis/core/Map";
+import type Extent from "@arcgis/core/geometry/Extent";
+import type SpatialReference from "@arcgis/core/geometry/SpatialReference";
+import type { CampoConsulta, CapaServicio, FiltroConsulta, ItemLeyenda, ParametrosConsulta, ParametrosDescarga, ResultadoConsultaCapa, ServicioGis, ValoresDistintosCampo } from "../../types";
+import type { ResultadoDescargaCapa } from "./descarga-capa";
+/** Fallo de carga asociado al servicio que lo produjo. */
+export interface FalloServicio {
+    servicio: ServicioGis;
+    error: unknown;
+}
+type ReportarFallos = (fallos: readonly FalloServicio[]) => void;
+/** Administra las capas del mapa (visibilidad y opacidad) sin depender de React. */
+export declare class GestorCapasMapa {
+    private readonly mapa;
+    private readonly reportarFallos?;
+    private registros;
+    private visibilidadServicios;
+    private opacidades;
+    private visibilidadCapas;
+    private opacidadesCapas;
+    private readonly consultas;
+    constructor(mapa: ArcGISMap, reportarFallos?: ReportarFallos);
+    /** Reemplaza todas las capas administradas según la lista de servicios. */
+    establecer(servicios: readonly ServicioGis[]): void;
+    /** Muestra u oculta un servicio completo. */
+    cambiaVisibilidadDelServicio(nombre: string, visible: boolean): void;
+    /** Ajusta la opacidad de todas las capas raíz de un servicio. */
+    cambiarOpacidadServicio(nombre: string, opacidad: number): void;
+    /** Ajusta la opacidad de una subcapa concreta. */
+    cambiarOpacidadCapa(nombreServicio: string, identificador: string, opacidad: number): void;
+    /** Muestra u oculta una subcapa concreta de un servicio. */
+    cambiarVisibilidadCapa(nombreServicio: string, identificador: string, visible: boolean): void;
+    /** Renueva las credenciales sin reconstruir las capas ni perder su estado. */
+    actualizarCredenciales(servicios: readonly ServicioGis[]): void;
+    /** Descubre y devuelve por servicio las subcapas que el contrato no declara. */
+    descubrirCapasNoDeclaradas(): Promise<Map<string, CapaServicio[]>>;
+    /** Retira del mapa todas las capas administradas por esta instancia. */
+    destruir(): void;
+    /** Extensión para "zoom a la capa" (ver `ConsultaCapaActiva.extentDeCapa`). */
+    extentDeCapa(nombreServicio: string, identificador: string, outSpatialReference?: SpatialReference): Promise<Extent | null>;
+    /** Descarga en GeoJSON una subcapa (ver `ConsultaCapaActiva.descargarCapa`). */
+    descargarCapa(nombreServicio: string, identificador: string, extent: Extent, parametros: ParametrosDescarga, 
+    /** Solo WFS: pregunta si continuar cuando el conteo previo indica una zona densa. */
+    onDescargaGrande?: (cantidad: number) => Promise<boolean>): Promise<ResultadoDescargaCapa>;
+    /** Leyenda de una capa activa (ver `ConsultaCapaActiva.leyendaDeCapa`). */
+    leyendaDeCapa(nombreServicio: string, identificador: string, etiquetaCapa: string): Promise<ItemLeyenda[]>;
+    /** Campos consultables de una capa activa (ver `ConsultaCapaActiva.camposDeCapa`). */
+    camposDeCapa(nombreServicio: string, identificador: string): Promise<CampoConsulta[]>;
+    /** Valores distintos de un campo (ver `ConsultaCapaActiva.valoresDistintosDeCampo`). */
+    valoresDistintosDeCampo(nombreServicio: string, identificador: string, campo: string, parametros: ParametrosConsulta): Promise<ValoresDistintosCampo>;
+    /** Consulta por atributos (ver `ConsultaCapaActiva.ejecutarConsulta`). */
+    ejecutarConsulta(nombreServicio: string, identificador: string, filtro: FiltroConsulta, parametros: ParametrosConsulta, outSpatialReference?: SpatialReference): Promise<ResultadoConsultaCapa>;
+    /** Siembra el estado de las subcapas de un servicio: todas arrancan desactivadas. */
+    private sembrarEstadoCapas;
+    /** Devuelve el registro de un servicio administrado o lanza si no existe. */
+    private buscar;
+    /** Aplica a las capas del servicio la combinación de su estado y el de cada subcapa. */
+    private aplicarVisibilidad;
+    /** Quita del mapa las capas administradas y resetea el estado interno. */
+    private limpiar;
+}
+export {};

package/dist-lib/tipos/features/maps/services/layers/identity-manager.d.ts

@@ -0,0 +1,5 @@
+import type { ServicioGis } from "../../types";
+/** Registra el token ArcGIS del servicio antes de crear sus capas. */
+export declare function registrarTokenArcgis(servicio: ServicioGis): void;
+/** Indica si el token informado por el backend ya expiró (epoch ms). */
+export declare function tokenVencido(servicio: ServicioGis): boolean;

package/dist-lib/tipos/features/maps/services/layers/leyenda.d.ts

@@ -0,0 +1,25 @@
+import type FeatureLayer from "@arcgis/core/layers/FeatureLayer";
+import type { ItemLeyenda, ServicioGis } from "../../types";
+/** Un elemento de leyenda tal como lo entrega el recurso REST `/legend`. */
+interface ElementoLeyendaArcgis {
+    label?: string;
+    contentType: string;
+    imageData: string;
+}
+/** Respuesta del recurso REST `/legend?f=json` de un servicio de mapas ArcGIS. */
+export interface RespuestaLeyendaArcgis {
+    layers: {
+        layerId: number;
+        legend: ElementoLeyendaArcgis[];
+    }[];
+}
+/**
+ * Leyenda de un MapServer/TileServer ArcGIS vía REST `/legend`, emparejada por
+ * `layerId` y cacheada por URL. Sin `label`, usa `etiquetaCapa`.
+ */
+export declare function obtenerLeyendaMapaImagen(urlServicio: string, layerId: number, etiquetaCapa: string, token: string | undefined, cache: Map<string, Promise<RespuestaLeyendaArcgis | null>>): Promise<ItemLeyenda[]>;
+/** Leyenda de una `FeatureLayer` a partir de su `renderer`, sin llamada de red. */
+export declare function obtenerLeyendaFeature(capa: FeatureLayer): Promise<ItemLeyenda[]>;
+/** Leyenda WMS vía `GetLegendGraphic`: la URL va directo al `<img>`; la etiqueta es el nombre. */
+export declare function obtenerLeyendaWms(servicio: ServicioGis, identificador: string, etiquetaCapa: string): ItemLeyenda[];
+export {};

package/dist-lib/tipos/features/maps/services/layers/simbolos-consulta.d.ts

@@ -0,0 +1,19 @@
+import SimpleFillSymbol from "@arcgis/core/symbols/SimpleFillSymbol";
+import SimpleLineSymbol from "@arcgis/core/symbols/SimpleLineSymbol";
+import SimpleMarkerSymbol from "@arcgis/core/symbols/SimpleMarkerSymbol";
+/**
+ * Símbolos (ámbar) con los que `useResaltadoConsulta` dibuja los resultados de
+ * Consultar, distintos del marcador azul de "Proyectar".
+ */
+/** Geometrías a las que se les puede dibujar un símbolo de estos. */
+type SimboloConsulta = SimpleMarkerSymbol | SimpleLineSymbol | SimpleFillSymbol;
+export declare const SIMBOLO_CONSULTA_PUNTO: SimpleMarkerSymbol;
+export declare const SIMBOLO_CONSULTA_LINEA: SimpleLineSymbol;
+export declare const SIMBOLO_CONSULTA_POLIGONO: SimpleFillSymbol;
+/** Variantes "seleccionadas" (rojo, más gruesas), para la fila activa de la tabla. */
+export declare const SIMBOLO_CONSULTA_PUNTO_SELECCIONADO: SimpleMarkerSymbol;
+export declare const SIMBOLO_CONSULTA_LINEA_SELECCIONADA: SimpleLineSymbol;
+export declare const SIMBOLO_CONSULTA_POLIGONO_SELECCIONADO: SimpleFillSymbol;
+/** Símbolo por tipo de geometría (`multipoint` usa el de punto), o `null` si no se dibuja. */
+export declare function simboloConsultaPara(tipoGeometria: string | undefined, seleccionado: boolean): SimboloConsulta | null;
+export {};

package/dist-lib/tipos/features/maps/services/layers/types.d.ts

@@ -0,0 +1,19 @@
+import type Layer from "@arcgis/core/layers/Layer";
+/** Resultado de la fábrica de capas para un servicio GIS. */
+export interface CapasServicioConstruidas {
+    /** Capas raíz que se agregan al mapa (en el orden declarado). */
+    readonly capasRaiz: readonly Layer[];
+    /**
+     * Control de subcapas internas de un único servicio raíz
+     * (p. ej. MapImageLayer o WMSLayer).
+     */
+    readonly subcapas?: {
+        establecerVisible(identificador: string, visible: boolean): void;
+        establecerOpacidad(identificador: string, opacidad: number): void;
+    };
+    /**
+     * Capas independientes mapeadas por identificador
+     * (p. ej. una FeatureLayer por capa configurada).
+     */
+    readonly individuales?: ReadonlyMap<string, Layer>;
+}

package/dist-lib/tipos/features/maps/services/layers/url-sin-query.d.ts

@@ -0,0 +1,2 @@
+/** Recorta una URL a origin + pathname para loguearla sin credenciales; si no es URL, la deja igual. */
+export declare function urlSinQuery(url: string): string;

package/dist-lib/tipos/features/maps/services/layers/wms.factory.d.ts

@@ -0,0 +1,4 @@
+import type { ServicioGis } from "../../types";
+import type { CapasServicioConstruidas } from "./types";
+/** OGC_WMS: un único WMSLayer por servicio; sus subcapas declaradas se controlan por nombre. */
+export declare function crearWms(servicio: ServicioGis): CapasServicioConstruidas;

package/dist-lib/tipos/features/maps/services/layers/xml-utils.d.ts

@@ -0,0 +1,4 @@
+/** Elementos descendientes por nombre local, tolere o no el parser el namespace. */
+export declare function descendientes(contexto: Document | Element, etiqueta: string): Element[];
+/** Nombre local sin el prefijo de workspace (`movi:torre` → `torre`). */
+export declare function sinPrefijo(valor: string): string;

package/dist-lib/tipos/features/maps/services/parametros-generales.d.ts

@@ -0,0 +1,12 @@
+import type { ParametrosConsulta, ParametrosDescarga, ParametrosIdentificar, ParametrosProyeccion } from "../types";
+/** No se pudieron obtener los parámetros generales: el endpoint falló o el JSON es inválido. */
+export declare class ParametrosGeneralesError extends Error {
+}
+/** Parámetros de la herramienta Descargar (grupo `descarga`). */
+export declare function obtenerParametrosDescarga(): Promise<ParametrosDescarga>;
+/** Parámetros de la consulta por atributos (grupo `consulta`). */
+export declare function obtenerParametrosConsulta(): Promise<ParametrosConsulta>;
+/** Parámetros de la herramienta Identificar (grupo `identificar`). */
+export declare function obtenerParametrosIdentificar(): Promise<ParametrosIdentificar>;
+/** Parámetros de la herramienta Proyectar (grupo `proyeccion`). */
+export declare function obtenerParametrosProyeccion(): Promise<ParametrosProyeccion>;

package/dist-lib/tipos/features/maps/services/proveedor-token.d.ts

@@ -0,0 +1,20 @@
+import type { ProveedorTokenAcceso } from "./configuracion-aplicacion";
+/** Por qué no se pudo obtener o usar el token de acceso. */
+export type MotivoErrorToken = "sin-configurar" | "controlador" | "vacio" | "rechazado";
+/** Error de token: el visor no carga sin un JWT válido (no hay respaldo). */
+export declare class ErrorToken extends Error {
+    readonly motivo: MotivoErrorToken;
+    constructor(motivo: MotivoErrorToken, mensaje: string, opciones?: ErrorOptions);
+}
+/** De dónde sale el token: la URL del controlador del anfitrión o una función propia. */
+export interface OrigenToken {
+    /** Controlador que emite el JWT: recibe `POST { clientId }` y responde `{ token }`. */
+    urlToken?: string;
+    /** Alternativa a `urlToken` para controlar la llamada (headers, cookies, etc.). */
+    getAccessToken?: ProveedorTokenAcceso;
+}
+/**
+ * Arma el proveedor de tokens del visor. Sin `urlToken` ni `getAccessToken`
+ * el proveedor falla siempre: el mapa no carga sin token.
+ */
+export declare function crearProveedorToken({ urlToken, getAccessToken }: OrigenToken): ProveedorTokenAcceso;

package/dist-lib/tipos/features/maps/services/proyeccion.d.ts

@@ -0,0 +1,37 @@
+import Point from "@arcgis/core/geometry/Point";
+import type { GeometryUnion, GeometryWithoutMeshUnion } from "@arcgis/core/geometry/types";
+/** Rango válido de X/Y (o longitud/latitud) de un sistema de referencia. */
+export interface RangoCoordenadas {
+    readonly xMin: number;
+    readonly xMax: number;
+    readonly yMin: number;
+    readonly yMax: number;
+}
+/** Sistema de referencia con nombre legible, para los selectores de la herramienta. */
+export interface SistemaReferencia {
+    /** Well-Known ID (código EPSG). */
+    readonly wkid: number;
+    /** Nombre para mostrar en español. */
+    readonly nombre: string;
+    /** `"geografica"`: lat/lon en grados. `"proyectada"`: este/norte en metros. */
+    readonly tipo: "geografica" | "proyectada";
+    /** Área de uso del EPSG (epsg.io) para validar coordenadas. Sin ella, no se valida rango. */
+    readonly rango?: RangoCoordenadas;
+}
+/**
+ * Sistemas de referencia de Colombia, en el orden de los selectores de `ModalProyeccion`.
+ * `rango` sale de epsg.io; en 3115/3116/3117 y 21897 cubre todo el país, así que
+ * detecta menos errores que en 9377.
+ */
+export declare const SRIDS_COLOMBIA: readonly SistemaReferencia[];
+/** Eje (`"x"`/`"y"`) fuera del rango de `sistema`, o `null`. Sin `rango`, se asume válido. */
+export declare function ejeFueraDeRango(x: number, y: number, sistema: SistemaReferencia): "x" | "y" | null;
+/** Crea un punto de ArcGIS en el sistema de referencia indicado. */
+export declare function crearPunto(x: number, y: number, wkid: number): Point;
+/** Proyecta una geometría a `wkidDestino` en el cliente (sin Geometry Service). */
+export declare function proyectar(geometria: GeometryUnion, wkidDestino: number): Promise<GeometryWithoutMeshUnion>;
+/** Proyecta un par de coordenadas de `wkidOrigen` a `wkidDestino` (modal «Proyectar»). */
+export declare function proyectarCoordenadas(x: number, y: number, wkidOrigen: number, wkidDestino: number): Promise<{
+    x: number;
+    y: number;
+}>;

package/dist-lib/tipos/features/maps/services/tools/acciones.registry.d.ts

@@ -0,0 +1,25 @@
+import type { ConfiguracionHerramienta, VistaMapa } from "../../types";
+/** Recursos que el visor entrega a una acción instantánea del mapa. */
+export interface ContextoAccion {
+    readonly vista: VistaMapa;
+    /** Regresa el mapa a la vista inicial configurada. */
+    readonly irAInicio: () => void;
+    /** Cancela la herramienta activa y limpia dibujos/mediciones/selecciones. */
+    readonly limpiar: () => void;
+    /** Alterna la visibilidad del panel de capas. */
+    readonly togglePanelCapas: () => void;
+    /** Alterna la visibilidad de la modal de herramientas de medición. */
+    readonly toggleModalMedicion: () => void;
+    /** Alterna la visibilidad de la modal de proyección de coordenadas. */
+    readonly toggleModalProyeccion: () => void;
+    /** Alterna la visibilidad de la modal de consulta por atributos. */
+    readonly toggleModalConsulta: () => void;
+    /** Alterna la visibilidad del panel de metadatos del mapa. */
+    readonly togglePanelMetadata: () => void;
+    /** Alterna entre la vista 2D (`MapView`) y la vista 3D (`SceneView`). */
+    readonly alternarTridimensional: () => void;
+}
+/** Indica si un código de herramienta es una acción instantánea soportada. */
+export declare function esAccion(codigo: string): boolean;
+/** Ejecuta la acción asociada al código; no hace nada si no está registrada. */
+export declare function ejecutarAccion(codigo: string, contexto: ContextoAccion, configuracion: ConfiguracionHerramienta): void;

package/dist-lib/tipos/features/maps/services/tools/agrupar-herramientas.d.ts

@@ -0,0 +1,3 @@
+import type { HerramientaMapa } from "../../types";
+/** Anida las mediciones como `hijos` de `measurement-tools` para mostrarlas en un desplegable. */
+export declare function agruparHerramientasMedicion(herramientas: readonly HerramientaMapa[]): HerramientaMapa[];

package/dist-lib/tipos/features/maps/services/tools/grupos-barra.d.ts

@@ -0,0 +1,13 @@
+import type { CodigoHerramienta } from "../../types";
+/** Grupo de herramientas contiguas dentro de la barra. */
+export interface GrupoBarra {
+    codigos: readonly CodigoHerramienta[];
+    /** Se dibuja dentro de su propia píldora tenue, separada del resto. */
+    encapsulado?: boolean;
+}
+/** Orden y agrupación visual de las herramientas en la barra de escritorio. */
+export declare const GRUPOS_BARRA_ESCRITORIO: readonly GrupoBarra[];
+/** Barra reducida (responsive): capas, home y zoom. "Mapa base" y "3D" van aparte. */
+export declare const GRUPOS_BARRA_RESPONSIVE: readonly GrupoBarra[];
+/** Códigos de la barra reducida, derivados de `GRUPOS_BARRA_RESPONSIVE`. */
+export declare const CODIGOS_BARRA_RESPONSIVE: ReadonlySet<CodigoHerramienta>;

package/dist-lib/tipos/features/maps/services/tools/herramientas.registry.d.ts

@@ -0,0 +1,8 @@
+import type { HerramientaMapa } from "../../types";
+import type { ControladorHerramienta } from "./types";
+/** Indica si un código de herramienta tiene implementación registrada. */
+export declare function estaSoportada(codigo: string): boolean;
+/** Si un código es soportado, directo o como sub-herramienta de un padre registrado. */
+export declare function estaSoportadaConHijos(codigo: string, herramientas: readonly HerramientaMapa[]): boolean;
+/** Crea el controlador de la herramienta; undefined (con aviso) si no tiene implementación. */
+export declare function crearControlador(herramienta: HerramientaMapa): ControladorHerramienta | undefined;

package/dist-lib/tipos/features/maps/services/tools/identify.tool.d.ts

@@ -0,0 +1,27 @@
+import type { ContextoHerramienta, ControladorHerramienta } from "./types";
+/** Sanea el HTML de `GetFeatureInfo` (scripts, iframes, `on*`, URLs ejecutables…). */
+export declare function sanitizarHtml(html: string): string;
+/**
+ * Identificar: consulta las capas visibles en el punto clicado y muestra el
+ * resultado en el popup (`identify` REST, GetFeatureInfo o `hitTest`).
+ */
+export declare class HerramientaIdentificar implements ControladorHerramienta {
+    private vista;
+    private manejadores;
+    activar(contexto: ContextoHerramienta): void;
+    desactivar(): void;
+    /**
+     * Lanza una consulta por capa y abre el popup con las promesas pendientes. La
+     * tolerancia y el tope de entidades se piden a BD en cada clic (sin caché).
+     */
+    private identificar;
+    /** FeatureLayer: entidades ya dibujadas bajo el puntero (hitTest en cliente). */
+    private consultarFeatureLayers;
+    /** MapImageLayer: identify REST sobre las subcapas encendidas en el cliente. */
+    private consultarMapImage;
+    /**
+     * WMSLayer (GeoServer): GetFeatureInfo en HTML. Se muestra como lista de campos
+     * y, si la tabla no calza, como HTML saneado.
+     */
+    private consultarWms;
+}

package/dist-lib/tipos/features/maps/services/tools/medicion.tool.d.ts

@@ -0,0 +1,69 @@
+import type { ControladorHerramienta, ContextoHerramienta } from "./types";
+/** Medición cruda que publica el `viewModel` (valores en la unidad activa). */
+export type MedicionCruda = {
+    readonly length: number;
+} | {
+    readonly area: number;
+    readonly perimeter: number;
+} | null;
+/** Lectura normalizada para la UI. */
+export interface LecturaMedicion {
+    readonly distancia?: number;
+    readonly area?: number;
+    readonly perimetro?: number;
+}
+/**
+ * Medición de distancia y área (solo 2D). Al alternar oculta/muestra los widgets
+ * sin destruirlos, así se conserva la medición previa.
+ */
+export declare class MeasurementTools implements ControladorHerramienta {
+    private vista;
+    private contenedorUI;
+    private distancia;
+    private area;
+    private containerDistancia;
+    private containerArea;
+    private activo;
+    /** Crea el `div` contenedor de un widget. */
+    private static crearContainer;
+    /** Devuelve el widget de distancia, creándolo la primera vez. */
+    private obtenerDistancia;
+    /** Devuelve el widget de área, creándolo la primera vez. */
+    private obtenerArea;
+    /** Muestra la sub-herramienta indicada (distancia por defecto). */
+    activar(contexto: ContextoHerramienta, subCodigo?: string): void;
+    /** Cambia entre distancia y área sin destruir los widgets. */
+    alternarSubHerramienta(subCodigo: string): void;
+    /** Reinicia la medición del sub-widget activo (botón «Restablecer medida»). */
+    restablecerMedida(): void;
+    /** Widget de la sub-herramienta activa (o `null` si no hay ninguna). */
+    private widgetActivo;
+    /** Unidades disponibles para la sub-herramienta activa (códigos ArcGIS). */
+    unidades(): readonly string[];
+    /** Unidad seleccionada en la sub-herramienta activa. */
+    unidadActual(): string | null;
+    /** Cambia la unidad de la sub-herramienta activa. */
+    establecerUnidad(codigo: string): void;
+    /** Valores de la medición en curso, normalizados; `null` si aún no hay. */
+    lectura(): LecturaMedicion | null;
+    /**
+     * Observa cambios de medición y de unidad de la sub-herramienta activa.
+     * Devuelve una función para cancelar la observación.
+     */
+    observar(callback: () => void): () => void;
+    /** Muestra el widget de distancia e inicia una medición si hace falta. */
+    private mostrarDistancia;
+    /** Oculta el contenedor del widget de distancia. */
+    private ocultarDistancia;
+    /** Muestra el widget de área e inicia una medición si hace falta. */
+    private mostrarArea;
+    /**
+     * Inicia una medición solo si el widget no tiene una en curso ni terminada,
+     * para conservar lo ya dibujado al volver a esta sub-herramienta.
+     */
+    private static iniciarSiHaceFalta;
+    /** Oculta el contenedor del widget de área. */
+    private ocultarArea;
+    /** Destruye ambos widgets y limpia referencias. */
+    desactivar(): void;
+}

package/dist-lib/tipos/features/maps/services/tools/types.d.ts

@@ -0,0 +1,24 @@
+import type { ConfiguracionHerramienta, VistaMapa } from "../../types";
+/** Recursos que el visor entrega a cada herramienta al activarse. */
+export interface ContextoHerramienta {
+    readonly vista: VistaMapa;
+    /** Contenedor flotante donde la herramienta puede montar su propia UI. */
+    readonly contenedorUI: HTMLDivElement;
+}
+/** Ciclo de vida de una herramienta activable sobre el mapa. */
+export interface ControladorHerramienta {
+    /** `subCodigo` identifica la sub-herramienta activa cuando el padre agrupa varias (ej: `measurement-tools`). */
+    activar(contexto: ContextoHerramienta, subCodigo?: string): void;
+    desactivar(): void;
+    /**
+     * Cambia la sub-herramienta activa sin recrear el controlador. Solo la
+     * implementan los controladores que agrupan varias (ej: `measurement-tools`).
+     */
+    alternarSubHerramienta?(subCodigo: string): void;
+}
+/** Construye un controlador recibiendo los parámetros del backend. */
+export type FabricaHerramienta = (configuracion: ConfiguracionHerramienta) => ControladorHerramienta;
+/** Manejador mínimo de eventos ArcGIS para liberarlos al desactivar. */
+export type ManejadorEvento = {
+    remove(): void;
+};

package/dist-lib/tipos/features/maps/styles/alertas.estilos.d.ts

@@ -0,0 +1,15 @@
+/** Estilos de `ModalAlerta`, réplica de `DialogoConfirmacion`; los colores van en hex. */
+/** Fondo oscurecido a pantalla completa, por encima de todo (modales del visor: z-40). */
+export declare const CLASES_FONDO_ALERTA = "fixed inset-0 z-50 flex items-center justify-center bg-[#1f2733]/40 p-4";
+/** Tarjeta blanca centrada (~308×137, ref. diseño de formularios). */
+export declare const CLASES_TARJETA_ALERTA: string;
+/** Botón de cerrar (aspa) de la esquina superior derecha. */
+export declare const CLASES_CERRAR_ALERTA: string;
+/** Título centrado de la cabecera. */
+export declare const CLASES_TITULO_ALERTA = "px-4 text-center text-sm font-bold text-[#1f2733]";
+/** Texto del cuerpo del aviso. */
+export declare const CLASES_MENSAJE_ALERTA = "text-xs leading-snug text-[#6b7280]";
+/** Botón principal ("Entendido" o "Sí" en modo confirmación), con el degradado de acento. */
+export declare const CLASES_BOTON_ALERTA: string;
+/** Botón secundario ("No"), solo en modo confirmación: mismo azul, en contorno. */
+export declare const CLASES_BOTON_ALERTA_SECUNDARIO: string;

package/dist-lib/tipos/features/maps/styles/controles.estilos.d.ts

@@ -0,0 +1,20 @@
+/** Realce de los botones del visor: se elevan en hover y vuelven al pulsar. */
+export declare const CLASES_REALCE_BOTON = "transition duration-200 ease-out hover:-translate-y-0.5 active:translate-y-0";
+/** Botón flotante de control (mapa base y 3D); sin borde, el fondo lo aporta el estado. */
+export declare const CLASES_BOTON_CONTROL = "grid size-10 place-items-center rounded-xl text-[#9EA0A2] transition duration-200 ease-out hover:-translate-y-0.5 active:translate-y-0";
+/** Botón de control en reposo: sombra difusa que se nota y, al pasar el puntero, azul como el activo. */
+export declare const CLASES_BOTON_CONTROL_REPOSO = "bg-white shadow-[0px_4px_20px_0px_rgba(0,0,0,0.35)] hover:bg-[#8DCEFF] hover:text-slate-600";
+/** Botón de la barra en estado seleccionado (chip 30×30, radio 8, azul claro). */
+export declare const CLASES_BOTON_BARRA_SELECCIONADO = "rounded-lg bg-[#8DCEFF] shadow-inner hover:bg-[#8DCEFF]";
+/** Botón de control en estado seleccionado. */
+export declare const CLASES_BOTON_CONTROL_SELECCIONADO = "rounded-lg bg-[#8DCEFF] shadow-inner hover:bg-[#8DCEFF]";
+/** Botón redondo de cierre («X») de paneles y modales. */
+export declare const CLASES_BOTON_CERRAR = "grid size-6 shrink-0 place-items-center rounded-full text-slate-400 transition duration-200 ease-out hover:-translate-y-0.5 active:translate-y-0 hover:bg-slate-100 hover:text-slate-600";
+/** Ancho mínimo (px) del contenedor para el layout de escritorio (ver `useModoResponsive`). */
+export declare const ANCHO_MINIMO_ESCRITORIO_PX = 640;
+/** Puntos de anclaje (fracción del alto del mapa) de la hoja inferior responsive. */
+export declare const PUNTOS_ANCLAJE_HOJA_INFERIOR: readonly [0.18, 0.5, 0.9];
+/** Asa de arrastre superior de la hoja inferior. */
+export declare const CLASES_ASA_HOJA_INFERIOR = "flex w-full shrink-0 cursor-grab touch-none items-center justify-center py-2 active:cursor-grabbing";
+/** Contenedor de la hoja inferior fija (mapa base / capas en responsive). */
+export declare const CLASES_HOJA_INFERIOR: string;

package/dist-lib/tipos/features/maps/styles/modales.estilos.d.ts

@@ -0,0 +1,11 @@
+/** Estilos compartidos de las modales de herramienta arrastrables. */
+/** Ancho fijo del diseño (px). La altura la decide cada modal. */
+export declare const ANCHO_MODAL_HERRAMIENTA = 337.7;
+/** Ancho de la vista de resultados de "Consultar", más ancha para la tabla. */
+export declare const ANCHO_MODAL_RESULTADOS_CONSULTA = 632;
+/** Alto máximo de la vista de resultados de "Consultar" (px): la tabla hace scroll propio dentro. */
+export declare const ALTO_MODAL_RESULTADOS_CONSULTA = 443;
+/** Reserva inferior (px) para que la modal no tape la barra de herramientas. */
+export declare const MARGEN_BARRA_HERRAMIENTAS = 110;
+/** Contenedor flotante de la modal. */
+export declare const CLASES_MODAL_HERRAMIENTA: string;

package/dist-lib/tipos/features/maps/styles/raiz.estilos.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Clase raíz del visor: acota el reset y el tema de la librería (`estilos.css`)
+ * para no tocar el resto de la página anfitriona. La llevan la raíz del visor
+ * y cada portal a `document.body` (que queda fuera de esa raíz).
+ */
+export declare const CLASE_RAIZ_MAPA = "core-isa-mapa";

package/dist-lib/tipos/features/maps/types/aplicacion.types.d.ts

@@ -0,0 +1,7 @@
+/** Información general de la aplicación anfitriona del visor. */
+export interface AplicacionInfo {
+    nombre: string;
+    descripcion: string;
+    /** Pares clave/valor libres que el backend adjunta a la aplicación. */
+    metadatos?: Record<string, unknown>;
+}

package/dist-lib/tipos/features/maps/types/capas.types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Estado de visibilidad/opacidad de servicios y subcapas en memoria. Es de
+ * presentación; lo comparten `useEstadosCapas` y `PanelCapas`.
+ */
+export interface EstadosCapas {
+    /** Visibilidad por nombre de servicio. */
+    servicios: Record<string, boolean>;
+    /** Opacidad (0–1) por nombre de servicio. */
+    opacidades: Record<string, number>;
+    /** Opacidad por subcapa: `servicio -> identificadorCapa -> opacidad`. */
+    opacidadesCapas?: Record<string, Record<string, number>>;
+    /** Visibilidad de subcapas: `servicio -> identificadorCapa -> visible`. */
+    capas: Record<string, Record<string, boolean>>;
+}

package/dist-lib/tipos/features/maps/types/configuracion-aplicacion.types.d.ts

@@ -0,0 +1,14 @@
+import type { AplicacionInfo } from "./aplicacion.types";
+import type { ItemGaleriaMapas } from "./galeria.types";
+import type { DefinicionMapa } from "./mapa.types";
+import type { GrupoServicios } from "./servicio.types";
+/**
+ * Contrato completo entregado por el backend para configurar el visor.
+ * Corresponde 1:1 con el JSON acordado con el backend `.NET`.
+ */
+export interface ConfiguracionAplicacion {
+    aplicacion: AplicacionInfo;
+    mapas: DefinicionMapa[];
+    galeriaMapas: ItemGaleriaMapas[];
+    gruposServicios: GrupoServicios[];
+}

package/dist-lib/tipos/features/maps/types/consulta.types.d.ts

@@ -0,0 +1,57 @@
+import type Extent from "@arcgis/core/geometry/Extent";
+import type Graphic from "@arcgis/core/Graphic";
+import type { CapaServicio, ServicioGis } from "./servicio.types";
+/** Capa activa (visible) que puede consultarse por atributos. */
+export interface CapaConsultable {
+    servicio: ServicioGis;
+    capa: CapaServicio;
+}
+/** Tipo general de un campo consultable: decide cómo se arma su filtro. */
+export type TipoCampoConsulta = "texto" | "numero" | "fecha" | "otro";
+/** Campo consultable de una capa, descubierto desde el servicio en vivo. */
+export interface CampoConsulta {
+    /** Nombre real del campo, tal como lo espera el `where`/`CQL_FILTER`. */
+    nombre: string;
+    /** Texto a mostrar en el combo de campos. */
+    alias: string;
+    tipo: TipoCampoConsulta;
+}
+/** Operadores del filtro por atributos (campo + operador + valor). */
+export type OperadorBasico = "=" | "<>" | ">" | "<" | ">=" | "<=" | "LIKE";
+/** Filtro armado por el usuario en el formulario de consulta. */
+export type FiltroConsulta = {
+    modo: "basica";
+    campo: string;
+    operador: OperadorBasico;
+    valor: string;
+};
+/** Resultado de ejecutar una consulta por atributos sobre una capa. */
+export interface ResultadoConsultaCapa {
+    campos: CampoConsulta[];
+    /** Un `Graphic` por entidad encontrada, venga de ArcGIS REST o de WFS. */
+    graficos: Graphic[];
+    extent: Extent | null;
+    /** Entidades traídas (no el total del servidor); con `incompleto`, se avisa del recorte. */
+    filasDevueltas: number;
+    /** El servidor recortó el resultado por el tope de filas de la consulta. */
+    incompleto: boolean;
+}
+/** Valores distintos de un campo, para el combo buscable de "Valores". */
+export interface ValoresDistintosCampo {
+    valores: string[];
+    /** No se trajeron todos los valores reales (tope alcanzado). */
+    truncado: boolean;
+}
+/** Clave estable de una capa consultable ("servicio::identificador"). */
+export type ClaveCapaConsultable = string;
+/** Un resultado ya obtenido, ligado a la capa que lo produjo. */
+export interface ResultadoConsultaCapaEntrada {
+    clave: ClaveCapaConsultable;
+    capa: CapaConsultable;
+    resultado: ResultadoConsultaCapa;
+}
+/** Resultados por capa (una pestaña por entrada, ej. Línea y Torre a la vez) y cuál está activa. */
+export interface ResultadosConsultaCapas {
+    entradas: ResultadoConsultaCapaEntrada[];
+    activa: ClaveCapaConsultable | null;
+}

package/dist-lib/tipos/features/maps/types/galeria.types.d.ts

@@ -0,0 +1,7 @@
+/** Mapa base disponible para el selector de la galería. */
+export interface ItemGaleriaMapas {
+    /** Código ArcGIS (p. ej. `streets-vector`, `osm`). */
+    codigo: string;
+    nombre: string;
+    descripcion: string;
+}

package/dist-lib/tipos/features/maps/types/herramienta.types.d.ts

@@ -0,0 +1,20 @@
+/** Códigos de herramienta soportados; los demás se ocultan hasta tener implementación. */
+export type CodigoHerramienta = "home" | "zoom-in" | "zoom-out" | "identify" | "get-coordinates" | "project" | "query" | "measure-distance" | "measure-area" | "clear" | "layer" | "three-dimensional" | "measurement-tools" | "base-map" | "metadata";
+/** `"ACCION"`: se ejecuta al clic. `"HERRAMIENTA"`: activa un modo interactivo. */
+export type TipoInteraccion = "ACCION" | "HERRAMIENTA";
+/** Parámetros de una herramienta en `configuracion` (hoy solo `delta` de zoom). */
+export interface ConfiguracionHerramienta {
+    /** Salto de niveles de zoom para `zoom-in` / `zoom-out`. */
+    delta?: number;
+}
+/** Definición de herramienta entregada por el backend en `mapas[].herramientas`. */
+export interface HerramientaMapa {
+    codigo: string;
+    nombre: string;
+    descripcion: string;
+    rutaIcono: string;
+    tipoInteraccion: TipoInteraccion;
+    configuracion: ConfiguracionHerramienta;
+    /** Sub-herramientas agrupadas (ej: measurement-tools → measure-distance, measure-area). */
+    hijos?: readonly HerramientaMapa[];
+}

package/dist-lib/tipos/features/maps/types/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./aplicacion.types";
+export * from "./capas.types";
+export * from "./configuracion-aplicacion.types";
+export * from "./consulta.types";
+export * from "./galeria.types";
+export * from "./herramienta.types";
+export * from "./leyenda.types";
+export * from "./mapa.types";
+export * from "./parametros-generales.types";
+export * from "./responsive.types";
+export * from "./servicio.types";

package/dist-lib/tipos/features/maps/types/leyenda.types.d.ts

@@ -0,0 +1,10 @@
+/** Ítem de leyenda: `imagen` (REST `/legend` o `GetLegendGraphic`) o `simbolo` (renderer). */
+export type ItemLeyenda = {
+    tipo: "imagen";
+    etiqueta: string;
+    src: string;
+} | {
+    tipo: "simbolo";
+    etiqueta: string;
+    elemento: HTMLElement;
+};