@cerca.red/mapa 0.2.0

package/dist/modelo.js

@@ -0,0 +1,227 @@
+import { aPosicion, cajaDeCoordenadas, cajaDeGeometria, circuloComoPoligono, coleccion, entidad, unirCajas, } from "@cerca.red/geo";
+/** El modelo de un mapa recién creado. */
+export function modeloInicial(parciales = {}) {
+    const { negocios, resultados, ...resto } = parciales;
+    return {
+        resultados: resultados ?? { modo: "negocios", negocios: negocios ?? [] },
+        seleccionado: undefined,
+        ubicacion: undefined,
+        vehiculos: [],
+        rutas: [],
+        zonas: [],
+        isocronas: [],
+        tema: "claro",
+        idioma: "es",
+        margenes: { arriba: 0, derecha: 0, abajo: 0, izquierda: 0 },
+        radioDeImprecisionEnMetros: 150,
+        ...resto,
+    };
+}
+/** Los negocios del modo actual; vacío mientras se muestran grupos del servidor. */
+export function negociosDelModelo(modelo) {
+    return modelo.resultados.modo === "negocios"
+        ? modelo.resultados.negocios
+        : [];
+}
+/** Los grupos explícitos del modo actual; vacío mientras se muestran negocios. */
+export function gruposDelModelo(modelo) {
+    return modelo.resultados.modo === "grupos" ? modelo.resultados.grupos : [];
+}
+/**
+ * Los negocios, como colección GeoJSON.
+ *
+ * El `id` va **dos veces**: como identificador de la entidad y como
+ * propiedad. No es descuido. El identificador de entidad es lo que necesita
+ * el estado de entidad —el resalte al pasar por encima— y tiene que ser
+ * numérico o una cadena; la propiedad es lo que se lee al consultar lo
+ * dibujado bajo el dedo, porque MapLibre **pierde el identificador de la
+ * entidad al agrupar** y solo conserva las propiedades.
+ */
+export function coleccionDeNegocios(modelo) {
+    return coleccion(negociosExactos(modelo).map((negocio) => entidad({ type: "Point", coordinates: aPosicion(negocio.ubicacion) }, {
+        id: negocio.id,
+        enfasis: negocio.enfasis ?? "normal",
+        ...(negocio.rotulo === undefined ? {} : { rotulo: negocio.rotulo }),
+        ...(negocio.simbolo === undefined
+            ? {}
+            : { simbolo: negocio.simbolo }),
+    }, negocio.id)));
+}
+/** Los agregados del servidor, en una fuente sin clustering local. */
+export function coleccionDeGrupos(modelo) {
+    return coleccion(gruposDelModelo(modelo).map((grupo) => entidad({ type: "Point", coordinates: aPosicion(grupo.ubicacion) }, {
+        id: grupo.id,
+        cantidad: grupo.cantidad,
+        ...(grupo.rotulo === undefined ? {} : { rotulo: grupo.rotulo }),
+    }, grupo.id)));
+}
+/** Las sedes de todos los negocios, aplanadas en una sola colección. */
+export function coleccionDeSedes(modelo) {
+    const entidades = negociosDelModelo(modelo).flatMap((negocio) => (negocio.sedes ?? []).map((sede) => entidad({ type: "Point", coordinates: aPosicion(sede.ubicacion) }, {
+        id: sede.id,
+        negocio: negocio.id,
+        ...(sede.rotulo === undefined ? {} : { rotulo: sede.rotulo }),
+    }, sede.id)));
+    return coleccion(entidades);
+}
+/**
+ * El negocio seleccionado, solo. En su propia fuente porque tiene que
+ * dibujarse **encima** de sus vecinos, y la clave de ordenación de símbolos
+ * no lee el estado de entidad.
+ */
+export function coleccionDeSeleccion(modelo) {
+    const elegido = negociosDelModelo(modelo).find((negocio) => negocio.id === modelo.seleccionado);
+    if (elegido === undefined)
+        return coleccion([]);
+    // Un negocio aproximado se resalta como área, no como alfiler. Seleccionar
+    // no es motivo para desdecirse: si nadie verificó el punto, señalarlo con
+    // un alfiler grande y naranja afirma con más fuerza algo que Cerca sigue
+    // sin saber.
+    const geometria = elegido.precision === "aproximada"
+        ? circuloComoPoligono(elegido.ubicacion, modelo.radioDeImprecisionEnMetros)
+        : { type: "Point", coordinates: aPosicion(elegido.ubicacion) };
+    return coleccion([
+        entidad(geometria, {
+            id: elegido.id,
+            enfasis: elegido.enfasis ?? "normal",
+            ...(elegido.rotulo === undefined ? {} : { rotulo: elegido.rotulo }),
+        }, elegido.id),
+    ]);
+}
+/**
+ * Las áreas de las ubicaciones aproximadas.
+ *
+ * Esta es la función que hace visible una decisión que en una lista es una
+ * etiqueta: «no se da por exacta una ubicación que nadie verificó». En un
+ * mapa, un alfiler afirma un punto. Si nadie verificó ese punto, el alfiler
+ * está afirmando algo que Cerca no sabe, y el usuario que camina hasta ahí
+ * descubre el error caminando.
+ *
+ * Un negocio aproximado sale **como área y sin punto**: aparece en esta
+ * colección y se filtra de la de negocios. Dibujar las dos cosas sería
+ * desdecirse en el mismo mapa.
+ */
+export function coleccionDeImprecision(modelo) {
+    const areas = negociosDelModelo(modelo)
+        .filter((negocio) => negocio.precision === "aproximada")
+        .map((negocio) => entidad(circuloComoPoligono(negocio.ubicacion, modelo.radioDeImprecisionEnMetros), { id: negocio.id }, negocio.id));
+    return coleccion(areas);
+}
+/** Los negocios con ubicación exacta: los únicos que se dibujan como alfiler. */
+export function negociosExactos(modelo) {
+    return negociosDelModelo(modelo).filter((negocio) => (negocio.precision ?? "exacta") === "exacta");
+}
+/** La ubicación del usuario: el punto y, si se sabe, su área de incertidumbre. */
+export function coleccionDeUbicacion(modelo) {
+    const ubicacion = modelo.ubicacion;
+    if (ubicacion === undefined)
+        return coleccion([]);
+    const entidades = [
+        entidad({ type: "Point", coordinates: aPosicion(ubicacion.ubicacion) }, ubicacion.rumbo === undefined ? {} : { rumbo: ubicacion.rumbo }, "usuario"),
+    ];
+    if (ubicacion.precisionEnMetros !== undefined &&
+        ubicacion.precisionEnMetros > 0) {
+        entidades.unshift(entidad(circuloComoPoligono(ubicacion.ubicacion, ubicacion.precisionEnMetros), {}, "usuario-halo"));
+    }
+    return coleccion(entidades);
+}
+export function coleccionDeVehiculos(modelo) {
+    return coleccion(modelo.vehiculos.map((vehiculo) => entidad({ type: "Point", coordinates: aPosicion(vehiculo.ubicacion) }, {
+        id: vehiculo.id,
+        ...(vehiculo.rumbo === undefined ? {} : { rumbo: vehiculo.rumbo }),
+        ...(vehiculo.simbolo === undefined
+            ? {}
+            : { simbolo: vehiculo.simbolo }),
+        ...(vehiculo.rotulo === undefined ? {} : { rotulo: vehiculo.rotulo }),
+    }, vehiculo.id)));
+}
+/**
+ * Las rutas, con `principal` resuelto.
+ *
+ * La regla de desempate está aquí y no en el filtro del estilo porque una
+ * expresión de MapLibre no puede decidir «la primera si ninguna se marcó»:
+ * con dos principales dibujaría las dos encima, y con cero no dibujaría
+ * ninguna en la capa gruesa — la ruta elegida se vería como una alternativa.
+ */
+export function coleccionDeRutas(modelo) {
+    const indicePrincipal = indiceDeRutaPrincipal(modelo.rutas);
+    return coleccion(modelo.rutas.map((ruta, indice) => entidad(ruta.geometria, {
+        id: ruta.id,
+        principal: indice === indicePrincipal,
+        ...(ruta.rotulo === undefined ? {} : { rotulo: ruta.rotulo }),
+    }, ruta.id)));
+}
+/** Cuál de las rutas es la principal: la primera marcada, o la primera a secas. */
+export function indiceDeRutaPrincipal(rutas) {
+    if (rutas.length === 0)
+        return -1;
+    const marcada = rutas.findIndex((ruta) => ruta.principal === true);
+    return marcada === -1 ? 0 : marcada;
+}
+export function coleccionDeZonas(modelo) {
+    return coleccion(modelo.zonas.map((zona) => entidad(zona.geometria, {
+        id: zona.id,
+        enfasis: zona.enfasis ?? "normal",
+        ...(zona.rotulo === undefined ? {} : { rotulo: zona.rotulo }),
+    }, zona.id)));
+}
+/**
+ * Las isócronas, **de mayor a menor**.
+ *
+ * El orden importa y no es estético: las bandas se solapan —la de 15 minutos
+ * contiene entera a la de 5— y en una capa de relleno se dibujan en el orden
+ * de la colección. Con la pequeña primero, la grande la tapa y el mapa
+ * enseña un solo polígono plano.
+ */
+export function coleccionDeIsocronas(modelo) {
+    const ordenadas = [...modelo.isocronas].sort((a, b) => b.minutos - a.minutos);
+    return coleccion(ordenadas.map((banda) => entidad(banda.geometria, { minutos: banda.minutos }, banda.minutos)));
+}
+/**
+ * La caja de todo lo que hay dibujado, o de una parte.
+ *
+ * Recorre las sedes además de los negocios: una cadena con cinco locales
+ * encuadrada solo por su sede principal deja las otras cuatro fuera de
+ * pantalla, y el mapa parece correcto.
+ */
+export function cajaDelModelo(modelo, que = "todo") {
+    const cajas = [];
+    if (que === "todo" || que === "grupos") {
+        for (const grupo of gruposDelModelo(modelo))
+            cajas.push(grupo.caja);
+    }
+    if (que === "todo" || que === "negocios") {
+        const puntos = [];
+        for (const negocio of negociosDelModelo(modelo)) {
+            puntos.push(negocio.ubicacion);
+            for (const sede of negocio.sedes ?? [])
+                puntos.push(sede.ubicacion);
+        }
+        const caja = cajaDeCoordenadas(puntos);
+        if (caja !== undefined)
+            cajas.push(caja);
+    }
+    if (que === "todo" || que === "rutas") {
+        for (const ruta of modelo.rutas) {
+            const caja = cajaDeGeometria(ruta.geometria);
+            if (caja !== undefined)
+                cajas.push(caja);
+        }
+    }
+    if (que === "todo" || que === "zonas") {
+        for (const zona of modelo.zonas) {
+            const caja = cajaDeGeometria(zona.geometria);
+            if (caja !== undefined)
+                cajas.push(caja);
+        }
+    }
+    return cajas.reduce((acumulada, caja) => acumulada === undefined ? caja : unirCajas(acumulada, caja), undefined);
+}
+/** La caja de un negocio y sus sedes. Lo que se encuadra al seleccionarlo. */
+export function cajaDeNegocio(negocio) {
+    return cajaDeCoordenadas([
+        negocio.ubicacion,
+        ...(negocio.sedes ?? []).map((sede) => sede.ubicacion),
+    ]);
+}
+//# sourceMappingURL=modelo.js.map

package/dist/modelo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelo.js","sourceRoot":"","sources":["../src/modelo.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type Caja,\n  type ColeccionDeEntidades,\n  type Coordenada,\n  aPosicion,\n  cajaDeCoordenadas,\n  cajaDeGeometria,\n  circuloComoPoligono,\n  coleccion,\n  entidad,\n  unirCajas,\n} from \"@cerca.red/geo\";\n\nimport type { Tema } from \"./estilo.ts\";\nimport type {\n  BandaDeIsocrona,\n  GrupoEnMapa,\n  NegocioEnMapa,\n  ResultadosEnMapa,\n  RutaEnMapa,\n  UbicacionDeUsuarioEnMapa,\n  VehiculoEnMapa,\n  ZonaEnMapa,\n} from \"./proyecciones.ts\";\nimport type { Margenes } from \"./puerto.ts\";\n\n/**\n * El modelo: lo que el SDK sabe que hay que dibujar.\n *\n * ## La decisión que sostiene todo el paquete\n *\n * **El SDK tiene el modelo y el mapa es una proyección.** No al revés.\n *\n * La razón inmediata es que cambiar de tema o de idioma en MapLibre es\n * reemplazar el estilo entero, y el estilo nuevo llega **sin** las fuentes ni\n * las capas de Cerca. Si el estado viviera en el mapa, cambiar de tema\n * perdería los negocios, la ruta y la selección — y no de forma ruidosa: el\n * mapa se quedaría bonito y vacío.\n *\n * La razón de fondo es que hace fiel al doble de pruebas. Si el estado está\n * aquí, en objetos planos y funciones puras, entonces lo que se prueba en\n * Node es el comportamiento de verdad y no una imitación: la conversión de\n * `NegocioEnMapa` a GeoJSON, qué caja hay que encuadrar, qué pasa al\n * seleccionar algo que no existe. Lo que queda para WebGL es solo que el\n * motor pinte lo que se le dio.\n *\n * ## Inmutable\n *\n * Cada operación devuelve un modelo nuevo. No es dogma: el SDK compara el\n * modelo anterior con el nuevo para decidir qué fuentes tocar, y esa\n * comparación es imposible si el objeto se modificó por debajo.\n */\nexport interface ModeloDelMapa {\n  readonly resultados: ResultadosEnMapa;\n  readonly seleccionado: string | undefined;\n  readonly ubicacion: UbicacionDeUsuarioEnMapa | undefined;\n  readonly vehiculos: readonly VehiculoEnMapa[];\n  readonly rutas: readonly RutaEnMapa[];\n  readonly zonas: readonly ZonaEnMapa[];\n  readonly isocronas: readonly BandaDeIsocrona[];\n  readonly tema: Tema;\n  readonly idioma: string;\n  readonly margenes: Margenes;\n  /**\n   * Con cuánto radio se dibuja una ubicación marcada como aproximada.\n   *\n   * Vive aquí y **no** en `NegocioEnMapa` a propósito. Que una ubicación sea\n   * aproximada lo decide Cerca; con cuántos metros de área se representa esa\n   * imprecisión es una decisión de dibujo, y meterla en la proyección sería\n   * el primer campo de la acumulación que ADR-027 dice que mata la frontera.\n   */\n  readonly radioDeImprecisionEnMetros: number;\n}\n\n/** El modelo de un mapa recién creado. */\nexport function modeloInicial(\n  parciales:\n    | (Partial<Omit<ModeloDelMapa, \"resultados\">> & {\n        readonly resultados?: ResultadosEnMapa;\n        readonly negocios?: never;\n      })\n    | (Partial<Omit<ModeloDelMapa, \"resultados\">> & {\n        readonly resultados?: never;\n        readonly negocios?: readonly NegocioEnMapa[];\n      }) = {},\n): ModeloDelMapa {\n  const { negocios, resultados, ...resto } = parciales;\n  return {\n    resultados: resultados ?? { modo: \"negocios\", negocios: negocios ?? [] },\n    seleccionado: undefined,\n    ubicacion: undefined,\n    vehiculos: [],\n    rutas: [],\n    zonas: [],\n    isocronas: [],\n    tema: \"claro\",\n    idioma: \"es\",\n    margenes: { arriba: 0, derecha: 0, abajo: 0, izquierda: 0 },\n    radioDeImprecisionEnMetros: 150,\n    ...resto,\n  };\n}\n\n/** Los negocios del modo actual; vacío mientras se muestran grupos del servidor. */\nexport function negociosDelModelo(\n  modelo: ModeloDelMapa,\n): readonly NegocioEnMapa[] {\n  return modelo.resultados.modo === \"negocios\"\n    ? modelo.resultados.negocios\n    : [];\n}\n\n/** Los grupos explícitos del modo actual; vacío mientras se muestran negocios. */\nexport function gruposDelModelo(modelo: ModeloDelMapa): readonly GrupoEnMapa[] {\n  return modelo.resultados.modo === \"grupos\" ? modelo.resultados.grupos : [];\n}\n\n/** Las propiedades con las que viaja un negocio a la fuente GeoJSON. */\ninterface PropiedadesDeNegocio extends Record<string, unknown> {\n  readonly id: string;\n  readonly enfasis: string;\n  readonly rotulo?: string;\n  readonly simbolo?: string;\n}\n\n/**\n * Los negocios, como colección GeoJSON.\n *\n * El `id` va **dos veces**: como identificador de la entidad y como\n * propiedad. No es descuido. El identificador de entidad es lo que necesita\n * el estado de entidad —el resalte al pasar por encima— y tiene que ser\n * numérico o una cadena; la propiedad es lo que se lee al consultar lo\n * dibujado bajo el dedo, porque MapLibre **pierde el identificador de la\n * entidad al agrupar** y solo conserva las propiedades.\n */\nexport function coleccionDeNegocios(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<PropiedadesDeNegocio> {\n  return coleccion(\n    negociosExactos(modelo).map((negocio) =>\n      entidad(\n        { type: \"Point\", coordinates: aPosicion(negocio.ubicacion) },\n        {\n          id: negocio.id,\n          enfasis: negocio.enfasis ?? \"normal\",\n          ...(negocio.rotulo === undefined ? {} : { rotulo: negocio.rotulo }),\n          ...(negocio.simbolo === undefined\n            ? {}\n            : { simbolo: negocio.simbolo }),\n        },\n        negocio.id,\n      ),\n    ),\n  );\n}\n\ninterface PropiedadesDeGrupo extends Record<string, unknown> {\n  readonly id: string;\n  readonly cantidad: number;\n  readonly rotulo?: string;\n}\n\n/** Los agregados del servidor, en una fuente sin clustering local. */\nexport function coleccionDeGrupos(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<PropiedadesDeGrupo> {\n  return coleccion(\n    gruposDelModelo(modelo).map((grupo) =>\n      entidad(\n        { type: \"Point\", coordinates: aPosicion(grupo.ubicacion) },\n        {\n          id: grupo.id,\n          cantidad: grupo.cantidad,\n          ...(grupo.rotulo === undefined ? {} : { rotulo: grupo.rotulo }),\n        },\n        grupo.id,\n      ),\n    ),\n  );\n}\n\ninterface PropiedadesDeSede extends Record<string, unknown> {\n  readonly id: string;\n  readonly negocio: string;\n  readonly rotulo?: string;\n}\n\n/** Las sedes de todos los negocios, aplanadas en una sola colección. */\nexport function coleccionDeSedes(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<PropiedadesDeSede> {\n  const entidades = negociosDelModelo(modelo).flatMap((negocio) =>\n    (negocio.sedes ?? []).map((sede) =>\n      entidad(\n        { type: \"Point\", coordinates: aPosicion(sede.ubicacion) },\n        {\n          id: sede.id,\n          negocio: negocio.id,\n          ...(sede.rotulo === undefined ? {} : { rotulo: sede.rotulo }),\n        },\n        sede.id,\n      ),\n    ),\n  );\n  return coleccion(entidades);\n}\n\n/**\n * El negocio seleccionado, solo. En su propia fuente porque tiene que\n * dibujarse **encima** de sus vecinos, y la clave de ordenación de símbolos\n * no lee el estado de entidad.\n */\nexport function coleccionDeSeleccion(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<PropiedadesDeNegocio> {\n  const elegido = negociosDelModelo(modelo).find(\n    (negocio) => negocio.id === modelo.seleccionado,\n  );\n  if (elegido === undefined) return coleccion([]);\n\n  // Un negocio aproximado se resalta como área, no como alfiler. Seleccionar\n  // no es motivo para desdecirse: si nadie verificó el punto, señalarlo con\n  // un alfiler grande y naranja afirma con más fuerza algo que Cerca sigue\n  // sin saber.\n  const geometria =\n    elegido.precision === \"aproximada\"\n      ? circuloComoPoligono(\n          elegido.ubicacion,\n          modelo.radioDeImprecisionEnMetros,\n        )\n      : ({ type: \"Point\", coordinates: aPosicion(elegido.ubicacion) } as const);\n\n  return coleccion([\n    entidad(\n      geometria,\n      {\n        id: elegido.id,\n        enfasis: elegido.enfasis ?? \"normal\",\n        ...(elegido.rotulo === undefined ? {} : { rotulo: elegido.rotulo }),\n      },\n      elegido.id,\n    ),\n  ]);\n}\n\n/**\n * Las áreas de las ubicaciones aproximadas.\n *\n * Esta es la función que hace visible una decisión que en una lista es una\n * etiqueta: «no se da por exacta una ubicación que nadie verificó». En un\n * mapa, un alfiler afirma un punto. Si nadie verificó ese punto, el alfiler\n * está afirmando algo que Cerca no sabe, y el usuario que camina hasta ahí\n * descubre el error caminando.\n *\n * Un negocio aproximado sale **como área y sin punto**: aparece en esta\n * colección y se filtra de la de negocios. Dibujar las dos cosas sería\n * desdecirse en el mismo mapa.\n */\nexport function coleccionDeImprecision(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<{ id: string }> {\n  const areas = negociosDelModelo(modelo)\n    .filter((negocio) => negocio.precision === \"aproximada\")\n    .map((negocio) =>\n      entidad(\n        circuloComoPoligono(\n          negocio.ubicacion,\n          modelo.radioDeImprecisionEnMetros,\n        ),\n        { id: negocio.id },\n        negocio.id,\n      ),\n    );\n  return coleccion(areas);\n}\n\n/** Los negocios con ubicación exacta: los únicos que se dibujan como alfiler. */\nexport function negociosExactos(\n  modelo: ModeloDelMapa,\n): readonly NegocioEnMapa[] {\n  return negociosDelModelo(modelo).filter(\n    (negocio) => (negocio.precision ?? \"exacta\") === \"exacta\",\n  );\n}\n\n/** La ubicación del usuario: el punto y, si se sabe, su área de incertidumbre. */\nexport function coleccionDeUbicacion(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<Record<string, unknown>> {\n  const ubicacion = modelo.ubicacion;\n  if (ubicacion === undefined) return coleccion([]);\n\n  const entidades = [\n    entidad(\n      { type: \"Point\", coordinates: aPosicion(ubicacion.ubicacion) },\n      ubicacion.rumbo === undefined ? {} : { rumbo: ubicacion.rumbo },\n      \"usuario\",\n    ),\n  ];\n\n  if (\n    ubicacion.precisionEnMetros !== undefined &&\n    ubicacion.precisionEnMetros > 0\n  ) {\n    entidades.unshift(\n      entidad(\n        circuloComoPoligono(ubicacion.ubicacion, ubicacion.precisionEnMetros),\n        {},\n        \"usuario-halo\",\n      ),\n    );\n  }\n\n  return coleccion(entidades);\n}\n\nexport function coleccionDeVehiculos(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<Record<string, unknown>> {\n  return coleccion(\n    modelo.vehiculos.map((vehiculo) =>\n      entidad(\n        { type: \"Point\", coordinates: aPosicion(vehiculo.ubicacion) },\n        {\n          id: vehiculo.id,\n          ...(vehiculo.rumbo === undefined ? {} : { rumbo: vehiculo.rumbo }),\n          ...(vehiculo.simbolo === undefined\n            ? {}\n            : { simbolo: vehiculo.simbolo }),\n          ...(vehiculo.rotulo === undefined ? {} : { rotulo: vehiculo.rotulo }),\n        },\n        vehiculo.id,\n      ),\n    ),\n  );\n}\n\n/**\n * Las rutas, con `principal` resuelto.\n *\n * La regla de desempate está aquí y no en el filtro del estilo porque una\n * expresión de MapLibre no puede decidir «la primera si ninguna se marcó»:\n * con dos principales dibujaría las dos encima, y con cero no dibujaría\n * ninguna en la capa gruesa — la ruta elegida se vería como una alternativa.\n */\nexport function coleccionDeRutas(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<Record<string, unknown>> {\n  const indicePrincipal = indiceDeRutaPrincipal(modelo.rutas);\n  return coleccion(\n    modelo.rutas.map((ruta, indice) =>\n      entidad(\n        ruta.geometria,\n        {\n          id: ruta.id,\n          principal: indice === indicePrincipal,\n          ...(ruta.rotulo === undefined ? {} : { rotulo: ruta.rotulo }),\n        },\n        ruta.id,\n      ),\n    ),\n  );\n}\n\n/** Cuál de las rutas es la principal: la primera marcada, o la primera a secas. */\nexport function indiceDeRutaPrincipal(rutas: readonly RutaEnMapa[]): number {\n  if (rutas.length === 0) return -1;\n  const marcada = rutas.findIndex((ruta) => ruta.principal === true);\n  return marcada === -1 ? 0 : marcada;\n}\n\nexport function coleccionDeZonas(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<Record<string, unknown>> {\n  return coleccion(\n    modelo.zonas.map((zona) =>\n      entidad(\n        zona.geometria,\n        {\n          id: zona.id,\n          enfasis: zona.enfasis ?? \"normal\",\n          ...(zona.rotulo === undefined ? {} : { rotulo: zona.rotulo }),\n        },\n        zona.id,\n      ),\n    ),\n  );\n}\n\n/**\n * Las isócronas, **de mayor a menor**.\n *\n * El orden importa y no es estético: las bandas se solapan —la de 15 minutos\n * contiene entera a la de 5— y en una capa de relleno se dibujan en el orden\n * de la colección. Con la pequeña primero, la grande la tapa y el mapa\n * enseña un solo polígono plano.\n */\nexport function coleccionDeIsocronas(\n  modelo: ModeloDelMapa,\n): ColeccionDeEntidades<Record<string, unknown>> {\n  const ordenadas = [...modelo.isocronas].sort((a, b) => b.minutos - a.minutos);\n  return coleccion(\n    ordenadas.map((banda) =>\n      entidad(banda.geometria, { minutos: banda.minutos }, banda.minutos),\n    ),\n  );\n}\n\n/**\n * La caja de todo lo que hay dibujado, o de una parte.\n *\n * Recorre las sedes además de los negocios: una cadena con cinco locales\n * encuadrada solo por su sede principal deja las otras cuatro fuera de\n * pantalla, y el mapa parece correcto.\n */\nexport function cajaDelModelo(\n  modelo: ModeloDelMapa,\n  que: \"todo\" | \"grupos\" | \"negocios\" | \"rutas\" | \"zonas\" = \"todo\",\n): Caja | undefined {\n  const cajas: Caja[] = [];\n\n  if (que === \"todo\" || que === \"grupos\") {\n    for (const grupo of gruposDelModelo(modelo)) cajas.push(grupo.caja);\n  }\n\n  if (que === \"todo\" || que === \"negocios\") {\n    const puntos: Coordenada[] = [];\n    for (const negocio of negociosDelModelo(modelo)) {\n      puntos.push(negocio.ubicacion);\n      for (const sede of negocio.sedes ?? []) puntos.push(sede.ubicacion);\n    }\n    const caja = cajaDeCoordenadas(puntos);\n    if (caja !== undefined) cajas.push(caja);\n  }\n\n  if (que === \"todo\" || que === \"rutas\") {\n    for (const ruta of modelo.rutas) {\n      const caja = cajaDeGeometria(ruta.geometria);\n      if (caja !== undefined) cajas.push(caja);\n    }\n  }\n\n  if (que === \"todo\" || que === \"zonas\") {\n    for (const zona of modelo.zonas) {\n      const caja = cajaDeGeometria(zona.geometria);\n      if (caja !== undefined) cajas.push(caja);\n    }\n  }\n\n  return cajas.reduce<Caja | undefined>(\n    (acumulada, caja) =>\n      acumulada === undefined ? caja : unirCajas(acumulada, caja),\n    undefined,\n  );\n}\n\n/** La caja de un negocio y sus sedes. Lo que se encuadra al seleccionarlo. */\nexport function cajaDeNegocio(negocio: NegocioEnMapa): Caja | undefined {\n  return cajaDeCoordenadas([\n    negocio.ubicacion,\n    ...(negocio.sedes ?? []).map((sede) => sede.ubicacion),\n  ]);\n}\n"]}

package/dist/navegador/index.d.ts

@@ -0,0 +1,70 @@
+import type { Coordenada } from "@cerca.red/geo";
+import { type Manifiesto } from "../manifiesto.ts";
+import { type MapaDeCerca, type OpcionesDeCrearMapa } from "../sdk.ts";
+/**
+ * `@cerca.red/mapa/navegador` — el mapa de verdad.
+ *
+ * Esta es la única subruta del paquete que alcanza `maplibre-gl` y `pmtiles`,
+ * y es explícita a propósito: importarla **se ve en el diff**, y quien la
+ * escribe sabe que acaba de meter WebGL y 250 KB de motor en ese archivo. El
+ * punto de entrada por defecto (`@cerca.red/mapa`) no llega hasta aquí ni
+ * indirectamente, y hay dos pruebas que lo comprueban —una ejecutando dentro
+ * de workerd, otra leyendo el grafo de imports—.
+ *
+ * En una pantalla de resultados el mapa se carga **bajo intención**: el estado
+ * por defecto es la lista, y el presupuesto de la primera pintura no paga el
+ * peso del motor. `packages/mapa-react` hace esa carga diferida por dentro,
+ * para que ninguna superficie tenga que acordarse.
+ */
+export interface OpcionesDeCrearMapaEnNavegador extends OpcionesDeCrearMapa {
+    /** El elemento donde va el canvas. Tiene que tener alto. */
+    readonly contenedor: HTMLElement;
+    readonly centro?: Coordenada;
+    readonly zoom?: number;
+    readonly zoomMinimo?: number;
+    readonly zoomMaximo?: number;
+    /**
+     * De dónde bajar `maplibre-gl-worker.mjs`.
+     *
+     * Hace falta bajo Next.js y bajo cualquier bundler que reescriba
+     * `import.meta.url`: sin ella, MapLibre deduce la URL del worker a partir
+     * de la de la página y pide un archivo que no existe. Bajo Vite no hace
+     * falta y no se pasa.
+     *
+     * El archivo que hay que servir es `maplibre-gl-worker.mjs` de la **misma
+     * versión** de `maplibre-gl` que resuelve el proyecto:
+     * `RUTA_DEL_WORKER_DE_MAPLIBRE` y `VERSION_DE_MAPLIBRE`, exportadas desde
+     * `@cerca.red/mapa`, son lo que se necesita para copiarlo y comprobarlo en
+     * la compilación de la superficie.
+     *
+     * Se aplica antes de construir el mapa. Quien prefiera fijarla una sola vez
+     * al arrancar usa `fijarUrlDelWorker`.
+     */
+    readonly urlDelWorker?: string;
+    /** Adónde lleva el enlace de licencias. Sin esta opción no se añade. */
+    readonly urlDeLicencias?: string;
+}
+/**
+ * Construye el mapa.
+ *
+ * Lanza `SinWebGL2` si el navegador no puede dibujarlo. No es un fallo
+ * inesperado: MapLibre 6 exige WebGL2 sin alternativa, y lo que corresponde
+ * entonces es enseñar la lista (SDD §13). Se puede preguntar antes con
+ * `hayWebGL2()`, o dejar que `<Mapa>` de `@cerca.red/mapa-react` lo resuelva
+ * con su `respaldo`.
+ */
+export declare function crearMapa(opciones: OpcionesDeCrearMapaEnNavegador): MapaDeCerca;
+/**
+ * Lo mismo, pero sacando la URL del manifiesto.
+ *
+ * Es la forma que deberían usar las superficies, y existe para que **nadie
+ * componga una URL de `.pmtiles`**: se le da el manifiesto ya leído y el
+ * centro inicial, y elige el archivo con más detalle que cubra ese punto.
+ * Promover un puntero a una versión anterior revierte de verdad solo si esto
+ * es lo único que construye URLs (ADR-024, ADR-027).
+ */
+export declare function crearMapaDesdeManifiesto(manifiesto: Manifiesto, opciones: Omit<OpcionesDeCrearMapaEnNavegador, "urlDeTeselas">): MapaDeCerca;
+export { adaptarMapLibre, type OpcionesDelAdaptador } from "./maplibre.ts";
+export { registrarProtocoloPmtiles, cuantosUsanElProtocolo, } from "./protocolo.ts";
+export { hayWebGL2, SinWebGL2 } from "./webgl.ts";
+export { fijarUrlDelWorker } from "./worker.ts";

package/dist/navegador/index.js

@@ -0,0 +1,132 @@
+import { archivoQueCubre, urlDeProtocolo, } from "../manifiesto.js";
+import { crearMapaConMotor, } from "../sdk.js";
+import { adaptarMapLibre } from "./maplibre.js";
+import { registrarProtocoloPmtiles } from "./protocolo.js";
+import { hayWebGL2, SinWebGL2 } from "./webgl.js";
+/**
+ * Construye el mapa.
+ *
+ * Lanza `SinWebGL2` si el navegador no puede dibujarlo. No es un fallo
+ * inesperado: MapLibre 6 exige WebGL2 sin alternativa, y lo que corresponde
+ * entonces es enseñar la lista (SDD §13). Se puede preguntar antes con
+ * `hayWebGL2()`, o dejar que `<Mapa>` de `@cerca.red/mapa-react` lo resuelva
+ * con su `respaldo`.
+ */
+export function crearMapa(opciones) {
+    if (!hayWebGL2())
+        throw new SinWebGL2();
+    // Antes de construir el mapa: el estilo va a referirse a `pmtiles://…` y
+    // MapLibre pide las teselas en cuanto lo carga.
+    const soltarProtocolo = registrarProtocoloPmtiles();
+    try {
+        const motor = adaptarMapLibre({
+            contenedor: opciones.contenedor,
+            // El estilo se calcula aquí y el mapa nace con él. El SDK se entera por
+            // `estiloYaAplicado` y no lo vuelve a poner: ponerlo dos veces descarga
+            // los glifos dos veces.
+            estilo: opciones.estilo({
+                urlDeTeselas: opciones.urlDeTeselas,
+                tema: opciones.tema ?? "claro",
+                idioma: opciones.idioma ?? "es",
+            }),
+            ...(opciones.centro === undefined ? {} : { centro: opciones.centro }),
+            ...(opciones.zoom === undefined ? {} : { zoom: opciones.zoom }),
+            ...(opciones.zoomMinimo === undefined
+                ? {}
+                : { zoomMinimo: opciones.zoomMinimo }),
+            ...(opciones.zoomMaximo === undefined
+                ? {}
+                : { zoomMaximo: opciones.zoomMaximo }),
+            ...(opciones.urlDelWorker === undefined
+                ? {}
+                : { urlDelWorker: opciones.urlDelWorker }),
+            ...(opciones.urlDeLicencias === undefined
+                ? {}
+                : { urlDeLicencias: opciones.urlDeLicencias }),
+        });
+        const mapa = crearMapaConMotor(motor, {
+            ...opciones,
+            estiloYaAplicado: true,
+        });
+        // `destruir` tiene que soltar además el protocolo, y hacerlo **aquí** y no
+        // dentro del SDK es lo que mantiene al núcleo sin saber que pmtiles
+        // existe.
+        return {
+            ...mapa,
+            // Los métodos se reenvían atados al objeto original: repartir un objeto
+            // con `...` sobre una clase pierde el `this` de sus métodos.
+            ponerResultados: mapa.ponerResultados.bind(mapa),
+            ponerNegocios: mapa.ponerNegocios.bind(mapa),
+            seleccionarNegocio: mapa.seleccionarNegocio.bind(mapa),
+            ponerUbicacionDeUsuario: mapa.ponerUbicacionDeUsuario.bind(mapa),
+            ponerVehiculos: mapa.ponerVehiculos.bind(mapa),
+            moverVehiculo: mapa.moverVehiculo.bind(mapa),
+            mostrarRuta: mapa.mostrarRuta.bind(mapa),
+            mostrarZonaDeCobertura: mapa.mostrarZonaDeCobertura.bind(mapa),
+            mostrarIsocrona: mapa.mostrarIsocrona.bind(mapa),
+            encuadrar: mapa.encuadrar.bind(mapa),
+            volarA: mapa.volarA.bind(mapa),
+            vista: mapa.vista.bind(mapa),
+            proyectar: mapa.proyectar.bind(mapa),
+            desproyectar: mapa.desproyectar.bind(mapa),
+            queHayEn: mapa.queHayEn.bind(mapa),
+            ponerTema: mapa.ponerTema.bind(mapa),
+            ponerIdioma: mapa.ponerIdioma.bind(mapa),
+            registrarSimbolos: mapa.registrarSimbolos.bind(mapa),
+            ponerMargenes: mapa.ponerMargenes.bind(mapa),
+            agregarCapaExtra: mapa.agregarCapaExtra.bind(mapa),
+            cuando: mapa.cuando.bind(mapa),
+            unaVez: mapa.unaVez.bind(mapa),
+            estaDestruido: mapa.estaDestruido.bind(mapa),
+            destruir: () => {
+                mapa.destruir();
+                soltarProtocolo();
+            },
+        };
+    }
+    catch (fallo) {
+        // Si la construcción se cae a medias, el protocolo queda registrado y el
+        // contador nunca vuelve a cero: el siguiente mapa lo hereda y el
+        // `removeProtocol` del último se lleva por delante a alguien.
+        soltarProtocolo();
+        throw fallo;
+    }
+}
+/**
+ * Lo mismo, pero sacando la URL del manifiesto.
+ *
+ * Es la forma que deberían usar las superficies, y existe para que **nadie
+ * componga una URL de `.pmtiles`**: se le da el manifiesto ya leído y el
+ * centro inicial, y elige el archivo con más detalle que cubra ese punto.
+ * Promover un puntero a una versión anterior revierte de verdad solo si esto
+ * es lo único que construye URLs (ADR-024, ADR-027).
+ */
+export function crearMapaDesdeManifiesto(manifiesto, opciones) {
+    const centro = opciones.centro;
+    const archivo = centro === undefined
+        ? manifiesto.archivos[0]
+        : (archivoQueCubre(manifiesto, centro) ?? manifiesto.archivos[0]);
+    if (archivo === undefined) {
+        throw new Error("crearMapaDesdeManifiesto: el manifiesto no trae ningún archivo de " +
+            "teselas. `leerManifiesto` ya rechaza ese caso, así que llegar aquí " +
+            "significa que alguien construyó el objeto a mano.");
+    }
+    return crearMapa({
+        ...opciones,
+        urlDeTeselas: urlDeProtocolo(archivo),
+        // La atribución **no se pasa al estilo**: viaja dentro del `.pmtiles` y el
+        // protocolo la publica solo. `manifiesto.atribucion` sigue disponible para
+        // quien tenga que mostrarla fuera del mapa —una lista sin canvas, un aviso
+        // legal—, pero no se le da al estilo, porque duplicar un texto legal es
+        // como una copia acaba quedándose atrás.
+        // Sin esto se puede navegar hasta el otro lado del mundo y ver un mapa
+        // vacío, que parece un fallo de carga.
+        cajaMaxima: opciones.cajaMaxima ?? archivo.caja,
+        zoomMaximo: opciones.zoomMaximo ?? archivo.zoomMaximo + 2,
+    });
+}
+export { adaptarMapLibre } from "./maplibre.js";
+export { registrarProtocoloPmtiles, cuantosUsanElProtocolo, } from "./protocolo.js";
+export { hayWebGL2, SinWebGL2 } from "./webgl.js";
+export { fijarUrlDelWorker } from "./worker.js";
+//# sourceMappingURL=index.js.map

package/dist/navegador/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navegador/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Coordenada } from \"@cerca.red/geo\";\n\nimport {\n  archivoQueCubre,\n  type Manifiesto,\n  urlDeProtocolo,\n} from \"../manifiesto.ts\";\nimport {\n  crearMapaConMotor,\n  type MapaDeCerca,\n  type OpcionesDeCrearMapa,\n} from \"../sdk.ts\";\nimport { adaptarMapLibre } from \"./maplibre.ts\";\nimport { registrarProtocoloPmtiles } from \"./protocolo.ts\";\nimport { hayWebGL2, SinWebGL2 } from \"./webgl.ts\";\n\n/**\n * `@cerca.red/mapa/navegador` — el mapa de verdad.\n *\n * Esta es la única subruta del paquete que alcanza `maplibre-gl` y `pmtiles`,\n * y es explícita a propósito: importarla **se ve en el diff**, y quien la\n * escribe sabe que acaba de meter WebGL y 250 KB de motor en ese archivo. El\n * punto de entrada por defecto (`@cerca.red/mapa`) no llega hasta aquí ni\n * indirectamente, y hay dos pruebas que lo comprueban —una ejecutando dentro\n * de workerd, otra leyendo el grafo de imports—.\n *\n * En una pantalla de resultados el mapa se carga **bajo intención**: el estado\n * por defecto es la lista, y el presupuesto de la primera pintura no paga el\n * peso del motor. `packages/mapa-react` hace esa carga diferida por dentro,\n * para que ninguna superficie tenga que acordarse.\n */\n\nexport interface OpcionesDeCrearMapaEnNavegador extends OpcionesDeCrearMapa {\n  /** El elemento donde va el canvas. Tiene que tener alto. */\n  readonly contenedor: HTMLElement;\n  readonly centro?: Coordenada;\n  readonly zoom?: number;\n  readonly zoomMinimo?: number;\n  readonly zoomMaximo?: number;\n  /**\n   * De dónde bajar `maplibre-gl-worker.mjs`.\n   *\n   * Hace falta bajo Next.js y bajo cualquier bundler que reescriba\n   * `import.meta.url`: sin ella, MapLibre deduce la URL del worker a partir\n   * de la de la página y pide un archivo que no existe. Bajo Vite no hace\n   * falta y no se pasa.\n   *\n   * El archivo que hay que servir es `maplibre-gl-worker.mjs` de la **misma\n   * versión** de `maplibre-gl` que resuelve el proyecto:\n   * `RUTA_DEL_WORKER_DE_MAPLIBRE` y `VERSION_DE_MAPLIBRE`, exportadas desde\n   * `@cerca.red/mapa`, son lo que se necesita para copiarlo y comprobarlo en\n   * la compilación de la superficie.\n   *\n   * Se aplica antes de construir el mapa. Quien prefiera fijarla una sola vez\n   * al arrancar usa `fijarUrlDelWorker`.\n   */\n  readonly urlDelWorker?: string;\n  /** Adónde lleva el enlace de licencias. Sin esta opción no se añade. */\n  readonly urlDeLicencias?: string;\n}\n\n/**\n * Construye el mapa.\n *\n * Lanza `SinWebGL2` si el navegador no puede dibujarlo. No es un fallo\n * inesperado: MapLibre 6 exige WebGL2 sin alternativa, y lo que corresponde\n * entonces es enseñar la lista (SDD §13). Se puede preguntar antes con\n * `hayWebGL2()`, o dejar que `<Mapa>` de `@cerca.red/mapa-react` lo resuelva\n * con su `respaldo`.\n */\nexport function crearMapa(\n  opciones: OpcionesDeCrearMapaEnNavegador,\n): MapaDeCerca {\n  if (!hayWebGL2()) throw new SinWebGL2();\n\n  // Antes de construir el mapa: el estilo va a referirse a `pmtiles://…` y\n  // MapLibre pide las teselas en cuanto lo carga.\n  const soltarProtocolo = registrarProtocoloPmtiles();\n\n  try {\n    const motor = adaptarMapLibre({\n      contenedor: opciones.contenedor,\n      // El estilo se calcula aquí y el mapa nace con él. El SDK se entera por\n      // `estiloYaAplicado` y no lo vuelve a poner: ponerlo dos veces descarga\n      // los glifos dos veces.\n      estilo: opciones.estilo({\n        urlDeTeselas: opciones.urlDeTeselas,\n        tema: opciones.tema ?? \"claro\",\n        idioma: opciones.idioma ?? \"es\",\n      }),\n      ...(opciones.centro === undefined ? {} : { centro: opciones.centro }),\n      ...(opciones.zoom === undefined ? {} : { zoom: opciones.zoom }),\n      ...(opciones.zoomMinimo === undefined\n        ? {}\n        : { zoomMinimo: opciones.zoomMinimo }),\n      ...(opciones.zoomMaximo === undefined\n        ? {}\n        : { zoomMaximo: opciones.zoomMaximo }),\n      ...(opciones.urlDelWorker === undefined\n        ? {}\n        : { urlDelWorker: opciones.urlDelWorker }),\n      ...(opciones.urlDeLicencias === undefined\n        ? {}\n        : { urlDeLicencias: opciones.urlDeLicencias }),\n    });\n\n    const mapa = crearMapaConMotor(motor, {\n      ...opciones,\n      estiloYaAplicado: true,\n    });\n\n    // `destruir` tiene que soltar además el protocolo, y hacerlo **aquí** y no\n    // dentro del SDK es lo que mantiene al núcleo sin saber que pmtiles\n    // existe.\n    return {\n      ...mapa,\n      // Los métodos se reenvían atados al objeto original: repartir un objeto\n      // con `...` sobre una clase pierde el `this` de sus métodos.\n      ponerResultados: mapa.ponerResultados.bind(mapa),\n      ponerNegocios: mapa.ponerNegocios.bind(mapa),\n      seleccionarNegocio: mapa.seleccionarNegocio.bind(mapa),\n      ponerUbicacionDeUsuario: mapa.ponerUbicacionDeUsuario.bind(mapa),\n      ponerVehiculos: mapa.ponerVehiculos.bind(mapa),\n      moverVehiculo: mapa.moverVehiculo.bind(mapa),\n      mostrarRuta: mapa.mostrarRuta.bind(mapa),\n      mostrarZonaDeCobertura: mapa.mostrarZonaDeCobertura.bind(mapa),\n      mostrarIsocrona: mapa.mostrarIsocrona.bind(mapa),\n      encuadrar: mapa.encuadrar.bind(mapa),\n      volarA: mapa.volarA.bind(mapa),\n      vista: mapa.vista.bind(mapa),\n      proyectar: mapa.proyectar.bind(mapa),\n      desproyectar: mapa.desproyectar.bind(mapa),\n      queHayEn: mapa.queHayEn.bind(mapa),\n      ponerTema: mapa.ponerTema.bind(mapa),\n      ponerIdioma: mapa.ponerIdioma.bind(mapa),\n      registrarSimbolos: mapa.registrarSimbolos.bind(mapa),\n      ponerMargenes: mapa.ponerMargenes.bind(mapa),\n      agregarCapaExtra: mapa.agregarCapaExtra.bind(mapa),\n      cuando: mapa.cuando.bind(mapa),\n      unaVez: mapa.unaVez.bind(mapa),\n      estaDestruido: mapa.estaDestruido.bind(mapa),\n      destruir: () => {\n        mapa.destruir();\n        soltarProtocolo();\n      },\n    };\n  } catch (fallo: unknown) {\n    // Si la construcción se cae a medias, el protocolo queda registrado y el\n    // contador nunca vuelve a cero: el siguiente mapa lo hereda y el\n    // `removeProtocol` del último se lleva por delante a alguien.\n    soltarProtocolo();\n    throw fallo;\n  }\n}\n\n/**\n * Lo mismo, pero sacando la URL del manifiesto.\n *\n * Es la forma que deberían usar las superficies, y existe para que **nadie\n * componga una URL de `.pmtiles`**: se le da el manifiesto ya leído y el\n * centro inicial, y elige el archivo con más detalle que cubra ese punto.\n * Promover un puntero a una versión anterior revierte de verdad solo si esto\n * es lo único que construye URLs (ADR-024, ADR-027).\n */\nexport function crearMapaDesdeManifiesto(\n  manifiesto: Manifiesto,\n  opciones: Omit<OpcionesDeCrearMapaEnNavegador, \"urlDeTeselas\">,\n): MapaDeCerca {\n  const centro = opciones.centro;\n  const archivo =\n    centro === undefined\n      ? manifiesto.archivos[0]\n      : (archivoQueCubre(manifiesto, centro) ?? manifiesto.archivos[0]);\n\n  if (archivo === undefined) {\n    throw new Error(\n      \"crearMapaDesdeManifiesto: el manifiesto no trae ningún archivo de \" +\n        \"teselas. `leerManifiesto` ya rechaza ese caso, así que llegar aquí \" +\n        \"significa que alguien construyó el objeto a mano.\",\n    );\n  }\n\n  return crearMapa({\n    ...opciones,\n    urlDeTeselas: urlDeProtocolo(archivo),\n    // La atribución **no se pasa al estilo**: viaja dentro del `.pmtiles` y el\n    // protocolo la publica solo. `manifiesto.atribucion` sigue disponible para\n    // quien tenga que mostrarla fuera del mapa —una lista sin canvas, un aviso\n    // legal—, pero no se le da al estilo, porque duplicar un texto legal es\n    // como una copia acaba quedándose atrás.\n    // Sin esto se puede navegar hasta el otro lado del mundo y ver un mapa\n    // vacío, que parece un fallo de carga.\n    cajaMaxima: opciones.cajaMaxima ?? archivo.caja,\n    zoomMaximo: opciones.zoomMaximo ?? archivo.zoomMaximo + 2,\n  });\n}\n\nexport { adaptarMapLibre, type OpcionesDelAdaptador } from \"./maplibre.ts\";\nexport {\n  registrarProtocoloPmtiles,\n  cuantosUsanElProtocolo,\n} from \"./protocolo.ts\";\nexport { hayWebGL2, SinWebGL2 } from \"./webgl.ts\";\nexport { fijarUrlDelWorker } from \"./worker.ts\";\n"]}

package/dist/navegador/maplibre.d.ts

@@ -0,0 +1,41 @@
+import type { Coordenada } from "@cerca.red/geo";
+import type { EspecificacionDeEstilo } from "../estilo.ts";
+import type { MapaNativo } from "../puerto.ts";
+export interface OpcionesDelAdaptador {
+    readonly contenedor: HTMLElement;
+    /** Si no se da, el mapa nace vacío y el estilo lo pone el SDK. */
+    readonly estilo?: EspecificacionDeEstilo;
+    readonly centro?: Coordenada;
+    readonly zoom?: number;
+    readonly zoomMinimo?: number;
+    readonly zoomMaximo?: number;
+    /**
+     * De dónde bajar `maplibre-gl-worker.mjs`, para los bundlers que reescriben
+     * `import.meta.url` y dejan a MapLibre deduciendo mal esa URL.
+     *
+     * Se aplica **antes** de construir el mapa, y tiene que ser así: el pool de
+     * workers se crea dentro del constructor y no vuelve a leer la URL mientras
+     * quede un mapa vivo. El porqué entero está en `worker.ts`.
+     *
+     * Sin esta opción no se toca nada, que es lo correcto bajo Vite: ahí la
+     * deducción por defecto funciona.
+     */
+    readonly urlDelWorker?: string;
+    /**
+     * Adónde lleva el enlace de licencias de la esquina inferior derecha.
+     *
+     * El control de atribución de MapLibre ya muestra el `© OpenStreetMap` que
+     * viene en los metadatos del `.pmtiles` — eso es obligación legal y no se
+     * toca. Este es un control aparte, más pequeño, para el documento que junta
+     * esa atribución con el resto de la cadena de licencias (el perfil de
+     * teselas, los proveedores). Sin esta opción no se añade nada.
+     */
+    readonly urlDeLicencias?: string;
+}
+/**
+ * Envuelve un mapa de MapLibre en el puerto.
+ *
+ * No comprueba WebGL2 —eso lo hace `crearMapa` antes de llegar aquí— porque
+ * esta función también se usa desde el laboratorio con un mapa ya construido.
+ */
+export declare function adaptarMapLibre(opciones: OpcionesDelAdaptador): MapaNativo;